diff --git a/clients/client-accessanalyzer/commands/CreateAnalyzerCommand.ts b/clients/client-accessanalyzer/commands/CreateAnalyzerCommand.ts index 1837c25adbc36..d14392e98d1bb 100644 --- a/clients/client-accessanalyzer/commands/CreateAnalyzerCommand.ts +++ b/clients/client-accessanalyzer/commands/CreateAnalyzerCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAnalyzerCommandInput = CreateAnalyzerRequest; export type CreateAnalyzerCommandOutput = CreateAnalyzerResponse & __MetadataBearer; +/** + *

Creates an analyzer for your account.

+ */ export class CreateAnalyzerCommand extends $Command< CreateAnalyzerCommandInput, CreateAnalyzerCommandOutput, @@ -34,6 +37,9 @@ export class CreateAnalyzerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/CreateArchiveRuleCommand.ts b/clients/client-accessanalyzer/commands/CreateArchiveRuleCommand.ts index d9cb218ddff73..bdcc0d0c52f9a 100644 --- a/clients/client-accessanalyzer/commands/CreateArchiveRuleCommand.ts +++ b/clients/client-accessanalyzer/commands/CreateArchiveRuleCommand.ts @@ -20,6 +20,10 @@ import { export type CreateArchiveRuleCommandInput = CreateArchiveRuleRequest; export type CreateArchiveRuleCommandOutput = __MetadataBearer; +/** + *

Creates an archive rule for the specified analyzer. Archive rules automatically archive + * findings that meet the criteria you define when you create the rule.

+ */ export class CreateArchiveRuleCommand extends $Command< CreateArchiveRuleCommandInput, CreateArchiveRuleCommandOutput, @@ -34,6 +38,9 @@ export class CreateArchiveRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/DeleteAnalyzerCommand.ts b/clients/client-accessanalyzer/commands/DeleteAnalyzerCommand.ts index 13b67ce85241b..450422b566ba2 100644 --- a/clients/client-accessanalyzer/commands/DeleteAnalyzerCommand.ts +++ b/clients/client-accessanalyzer/commands/DeleteAnalyzerCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteAnalyzerCommandInput = DeleteAnalyzerRequest; export type DeleteAnalyzerCommandOutput = __MetadataBearer; +/** + *

Deletes the specified analyzer. When you delete an analyzer, Access Analyzer is disabled + * for the account in the current or specific Region. All findings that were generated by the + * analyzer are deleted. You cannot undo this action.

+ */ export class DeleteAnalyzerCommand extends $Command< DeleteAnalyzerCommandInput, DeleteAnalyzerCommandOutput, @@ -34,6 +39,9 @@ export class DeleteAnalyzerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/DeleteArchiveRuleCommand.ts b/clients/client-accessanalyzer/commands/DeleteArchiveRuleCommand.ts index 0761bcc351a43..45667e4c48c8f 100644 --- a/clients/client-accessanalyzer/commands/DeleteArchiveRuleCommand.ts +++ b/clients/client-accessanalyzer/commands/DeleteArchiveRuleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteArchiveRuleCommandInput = DeleteArchiveRuleRequest; export type DeleteArchiveRuleCommandOutput = __MetadataBearer; +/** + *

Deletes the specified archive rule.

+ */ export class DeleteArchiveRuleCommand extends $Command< DeleteArchiveRuleCommandInput, DeleteArchiveRuleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteArchiveRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/GetAnalyzedResourceCommand.ts b/clients/client-accessanalyzer/commands/GetAnalyzedResourceCommand.ts index 8d2a7c0f00743..6a9e4c4b01c2e 100644 --- a/clients/client-accessanalyzer/commands/GetAnalyzedResourceCommand.ts +++ b/clients/client-accessanalyzer/commands/GetAnalyzedResourceCommand.ts @@ -20,6 +20,9 @@ import { export type GetAnalyzedResourceCommandInput = GetAnalyzedResourceRequest; export type GetAnalyzedResourceCommandOutput = GetAnalyzedResourceResponse & __MetadataBearer; +/** + *

Retrieves information about a resource that was analyzed.

+ */ export class GetAnalyzedResourceCommand extends $Command< GetAnalyzedResourceCommandInput, GetAnalyzedResourceCommandOutput, @@ -34,6 +37,9 @@ export class GetAnalyzedResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/GetAnalyzerCommand.ts b/clients/client-accessanalyzer/commands/GetAnalyzerCommand.ts index 98a2794df1657..02d17c33fb316 100644 --- a/clients/client-accessanalyzer/commands/GetAnalyzerCommand.ts +++ b/clients/client-accessanalyzer/commands/GetAnalyzerCommand.ts @@ -20,6 +20,9 @@ import { export type GetAnalyzerCommandInput = GetAnalyzerRequest; export type GetAnalyzerCommandOutput = GetAnalyzerResponse & __MetadataBearer; +/** + *

Retrieves information about the specified analyzer.

+ */ export class GetAnalyzerCommand extends $Command< GetAnalyzerCommandInput, GetAnalyzerCommandOutput, @@ -34,6 +37,9 @@ export class GetAnalyzerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/GetArchiveRuleCommand.ts b/clients/client-accessanalyzer/commands/GetArchiveRuleCommand.ts index 7f4aa761ef0a4..f46d83b35b454 100644 --- a/clients/client-accessanalyzer/commands/GetArchiveRuleCommand.ts +++ b/clients/client-accessanalyzer/commands/GetArchiveRuleCommand.ts @@ -20,6 +20,9 @@ import { export type GetArchiveRuleCommandInput = GetArchiveRuleRequest; export type GetArchiveRuleCommandOutput = GetArchiveRuleResponse & __MetadataBearer; +/** + *

Retrieves information about an archive rule.

+ */ export class GetArchiveRuleCommand extends $Command< GetArchiveRuleCommandInput, GetArchiveRuleCommandOutput, @@ -34,6 +37,9 @@ export class GetArchiveRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/GetFindingCommand.ts b/clients/client-accessanalyzer/commands/GetFindingCommand.ts index 1845cc4f941e5..bd5c087c1eed3 100644 --- a/clients/client-accessanalyzer/commands/GetFindingCommand.ts +++ b/clients/client-accessanalyzer/commands/GetFindingCommand.ts @@ -20,6 +20,9 @@ import { export type GetFindingCommandInput = GetFindingRequest; export type GetFindingCommandOutput = GetFindingResponse & __MetadataBearer; +/** + *

Retrieves information about the specified finding.

+ */ export class GetFindingCommand extends $Command< GetFindingCommandInput, GetFindingCommandOutput, @@ -34,6 +37,9 @@ export class GetFindingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/ListAnalyzedResourcesCommand.ts b/clients/client-accessanalyzer/commands/ListAnalyzedResourcesCommand.ts index 298b7a3a1c9df..75fe0325f26b7 100644 --- a/clients/client-accessanalyzer/commands/ListAnalyzedResourcesCommand.ts +++ b/clients/client-accessanalyzer/commands/ListAnalyzedResourcesCommand.ts @@ -20,6 +20,10 @@ import { export type ListAnalyzedResourcesCommandInput = ListAnalyzedResourcesRequest; export type ListAnalyzedResourcesCommandOutput = ListAnalyzedResourcesResponse & __MetadataBearer; +/** + *

Retrieves a list of resources of the specified type that have been analyzed by the + * specified analyzer..

+ */ export class ListAnalyzedResourcesCommand extends $Command< ListAnalyzedResourcesCommandInput, ListAnalyzedResourcesCommandOutput, @@ -34,6 +38,9 @@ export class ListAnalyzedResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/ListAnalyzersCommand.ts b/clients/client-accessanalyzer/commands/ListAnalyzersCommand.ts index fb5aa8e65f37d..be69b0fb74a5e 100644 --- a/clients/client-accessanalyzer/commands/ListAnalyzersCommand.ts +++ b/clients/client-accessanalyzer/commands/ListAnalyzersCommand.ts @@ -20,6 +20,9 @@ import { export type ListAnalyzersCommandInput = ListAnalyzersRequest; export type ListAnalyzersCommandOutput = ListAnalyzersResponse & __MetadataBearer; +/** + *

Retrieves a list of analyzers.

+ */ export class ListAnalyzersCommand extends $Command< ListAnalyzersCommandInput, ListAnalyzersCommandOutput, @@ -34,6 +37,9 @@ export class ListAnalyzersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/ListArchiveRulesCommand.ts b/clients/client-accessanalyzer/commands/ListArchiveRulesCommand.ts index bc9d0866e0d31..d030e83a772cb 100644 --- a/clients/client-accessanalyzer/commands/ListArchiveRulesCommand.ts +++ b/clients/client-accessanalyzer/commands/ListArchiveRulesCommand.ts @@ -20,6 +20,9 @@ import { export type ListArchiveRulesCommandInput = ListArchiveRulesRequest; export type ListArchiveRulesCommandOutput = ListArchiveRulesResponse & __MetadataBearer; +/** + *

Retrieves a list of archive rules created for the specified analyzer.

+ */ export class ListArchiveRulesCommand extends $Command< ListArchiveRulesCommandInput, ListArchiveRulesCommandOutput, @@ -34,6 +37,9 @@ export class ListArchiveRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/ListFindingsCommand.ts b/clients/client-accessanalyzer/commands/ListFindingsCommand.ts index 20fb642eb2b41..c4bfdb9725185 100644 --- a/clients/client-accessanalyzer/commands/ListFindingsCommand.ts +++ b/clients/client-accessanalyzer/commands/ListFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFindingsCommandInput = ListFindingsRequest; export type ListFindingsCommandOutput = ListFindingsResponse & __MetadataBearer; +/** + *

Retrieves a list of findings generated by the specified analyzer.

+ */ export class ListFindingsCommand extends $Command< ListFindingsCommandInput, ListFindingsCommandOutput, @@ -34,6 +37,9 @@ export class ListFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/ListTagsForResourceCommand.ts b/clients/client-accessanalyzer/commands/ListTagsForResourceCommand.ts index 8b0f49527f49a..375bbeeae8cdb 100644 --- a/clients/client-accessanalyzer/commands/ListTagsForResourceCommand.ts +++ b/clients/client-accessanalyzer/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves a list of tags applied to the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/StartResourceScanCommand.ts b/clients/client-accessanalyzer/commands/StartResourceScanCommand.ts index 0bfc6a2a1bf57..b318bedc36c86 100644 --- a/clients/client-accessanalyzer/commands/StartResourceScanCommand.ts +++ b/clients/client-accessanalyzer/commands/StartResourceScanCommand.ts @@ -20,6 +20,9 @@ import { export type StartResourceScanCommandInput = StartResourceScanRequest; export type StartResourceScanCommandOutput = __MetadataBearer; +/** + *

Immediately starts a scan of the policies applied to the specified resource.

+ */ export class StartResourceScanCommand extends $Command< StartResourceScanCommandInput, StartResourceScanCommandOutput, @@ -34,6 +37,9 @@ export class StartResourceScanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/TagResourceCommand.ts b/clients/client-accessanalyzer/commands/TagResourceCommand.ts index fab58e041c371..3ef62342b21ef 100644 --- a/clients/client-accessanalyzer/commands/TagResourceCommand.ts +++ b/clients/client-accessanalyzer/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds a tag to the specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/UntagResourceCommand.ts b/clients/client-accessanalyzer/commands/UntagResourceCommand.ts index 126144b45a6b7..37b2e612dfbd3 100644 --- a/clients/client-accessanalyzer/commands/UntagResourceCommand.ts +++ b/clients/client-accessanalyzer/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag from the specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/UpdateArchiveRuleCommand.ts b/clients/client-accessanalyzer/commands/UpdateArchiveRuleCommand.ts index c06b672d66b8d..45589ad99dad0 100644 --- a/clients/client-accessanalyzer/commands/UpdateArchiveRuleCommand.ts +++ b/clients/client-accessanalyzer/commands/UpdateArchiveRuleCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateArchiveRuleCommandInput = UpdateArchiveRuleRequest; export type UpdateArchiveRuleCommandOutput = __MetadataBearer; +/** + *

Updates the criteria and values for the specified archive rule.

+ */ export class UpdateArchiveRuleCommand extends $Command< UpdateArchiveRuleCommandInput, UpdateArchiveRuleCommandOutput, @@ -34,6 +37,9 @@ export class UpdateArchiveRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/commands/UpdateFindingsCommand.ts b/clients/client-accessanalyzer/commands/UpdateFindingsCommand.ts index c4ec05fb1b255..161b448610e70 100644 --- a/clients/client-accessanalyzer/commands/UpdateFindingsCommand.ts +++ b/clients/client-accessanalyzer/commands/UpdateFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFindingsCommandInput = UpdateFindingsRequest; export type UpdateFindingsCommandOutput = __MetadataBearer; +/** + *

Updates the status for the specified findings.

+ */ export class UpdateFindingsCommand extends $Command< UpdateFindingsCommandInput, UpdateFindingsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AccessAnalyzerClientResolvedConfig, diff --git a/clients/client-accessanalyzer/package.json b/clients/client-accessanalyzer/package.json index b6dd428b1c73a..c280c00b9a29b 100644 --- a/clients/client-accessanalyzer/package.json +++ b/clients/client-accessanalyzer/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Accessanalyzer Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-accessanalyzer/pagination/ListAnalyzedResourcesPaginator.ts b/clients/client-accessanalyzer/pagination/ListAnalyzedResourcesPaginator.ts index bc7832c999586..16b85826652e0 100644 --- a/clients/client-accessanalyzer/pagination/ListAnalyzedResourcesPaginator.ts +++ b/clients/client-accessanalyzer/pagination/ListAnalyzedResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { AccessAnalyzerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AccessAnalyzerClient, input: ListAnalyzedResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAnalyzedResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AccessAnalyzer, input: ListAnalyzedResourcesCommandInput, diff --git a/clients/client-accessanalyzer/pagination/ListAnalyzersPaginator.ts b/clients/client-accessanalyzer/pagination/ListAnalyzersPaginator.ts index 083dfec7649b3..0371e28537d96 100644 --- a/clients/client-accessanalyzer/pagination/ListAnalyzersPaginator.ts +++ b/clients/client-accessanalyzer/pagination/ListAnalyzersPaginator.ts @@ -8,6 +8,9 @@ import { import { AccessAnalyzerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AccessAnalyzerClient, input: ListAnalyzersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAnalyzersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AccessAnalyzer, input: ListAnalyzersCommandInput, diff --git a/clients/client-accessanalyzer/pagination/ListArchiveRulesPaginator.ts b/clients/client-accessanalyzer/pagination/ListArchiveRulesPaginator.ts index 9a9d7e1cc538f..73e1296bfca97 100644 --- a/clients/client-accessanalyzer/pagination/ListArchiveRulesPaginator.ts +++ b/clients/client-accessanalyzer/pagination/ListArchiveRulesPaginator.ts @@ -8,6 +8,9 @@ import { import { AccessAnalyzerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AccessAnalyzerClient, input: ListArchiveRulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListArchiveRulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AccessAnalyzer, input: ListArchiveRulesCommandInput, diff --git a/clients/client-accessanalyzer/pagination/ListFindingsPaginator.ts b/clients/client-accessanalyzer/pagination/ListFindingsPaginator.ts index 8f31df429e903..79bac868cd25c 100644 --- a/clients/client-accessanalyzer/pagination/ListFindingsPaginator.ts +++ b/clients/client-accessanalyzer/pagination/ListFindingsPaginator.ts @@ -8,6 +8,9 @@ import { import { AccessAnalyzerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AccessAnalyzerClient, input: ListFindingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFindingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AccessAnalyzer, input: ListFindingsCommandInput, diff --git a/clients/client-accessanalyzer/runtimeConfig.browser.ts b/clients/client-accessanalyzer/runtimeConfig.browser.ts index 5604b63484f7a..8b1b50a2a43c9 100644 --- a/clients/client-accessanalyzer/runtimeConfig.browser.ts +++ b/clients/client-accessanalyzer/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AccessAnalyzerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-accessanalyzer/runtimeConfig.native.ts b/clients/client-accessanalyzer/runtimeConfig.native.ts index e898f5b62b570..977139ea8ccf0 100644 --- a/clients/client-accessanalyzer/runtimeConfig.native.ts +++ b/clients/client-accessanalyzer/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AccessAnalyzerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-accessanalyzer/runtimeConfig.shared.ts b/clients/client-accessanalyzer/runtimeConfig.shared.ts index 7e2032993e445..515eb3bdea7c4 100644 --- a/clients/client-accessanalyzer/runtimeConfig.shared.ts +++ b/clients/client-accessanalyzer/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-11-01", disableHostPrefix: false, diff --git a/clients/client-accessanalyzer/runtimeConfig.ts b/clients/client-accessanalyzer/runtimeConfig.ts index 22b4677125998..fe6bac89cd3a2 100644 --- a/clients/client-accessanalyzer/runtimeConfig.ts +++ b/clients/client-accessanalyzer/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AccessAnalyzerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-accessanalyzer/tsconfig.json b/clients/client-accessanalyzer/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-accessanalyzer/tsconfig.json +++ b/clients/client-accessanalyzer/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-acm-pca/commands/CreateCertificateAuthorityAuditReportCommand.ts b/clients/client-acm-pca/commands/CreateCertificateAuthorityAuditReportCommand.ts index 53df139a9907a..abb3721ff0beb 100644 --- a/clients/client-acm-pca/commands/CreateCertificateAuthorityAuditReportCommand.ts +++ b/clients/client-acm-pca/commands/CreateCertificateAuthorityAuditReportCommand.ts @@ -24,6 +24,24 @@ export type CreateCertificateAuthorityAuditReportCommandInput = CreateCertificat export type CreateCertificateAuthorityAuditReportCommandOutput = CreateCertificateAuthorityAuditReportResponse & __MetadataBearer; +/** + *

Creates an audit report that lists every time that your CA private key is used. The + * report is saved in the Amazon S3 bucket that you specify on input. + * + * The IssueCertificate and RevokeCertificate actions use + * the private key.

+ * + *

Both PCA and the IAM principal must have permission to write to + * the S3 bucket that you specify. If the IAM principal making the call + * does not have permission to write to the bucket, then an exception is + * thrown. For more information, see Configure + * Access to ACM Private CA.

+ *
+ * + *

ACM Private CAA assets that are stored in Amazon S3 can be protected with encryption. + * For more information, see Encrypting Your Audit + * Reports.

+ */ export class CreateCertificateAuthorityAuditReportCommand extends $Command< CreateCertificateAuthorityAuditReportCommandInput, CreateCertificateAuthorityAuditReportCommandOutput, @@ -38,6 +56,9 @@ export class CreateCertificateAuthorityAuditReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/CreateCertificateAuthorityCommand.ts b/clients/client-acm-pca/commands/CreateCertificateAuthorityCommand.ts index 36a938fdfff41..7cb688addfc9d 100644 --- a/clients/client-acm-pca/commands/CreateCertificateAuthorityCommand.ts +++ b/clients/client-acm-pca/commands/CreateCertificateAuthorityCommand.ts @@ -20,6 +20,27 @@ import { export type CreateCertificateAuthorityCommandInput = CreateCertificateAuthorityRequest; export type CreateCertificateAuthorityCommandOutput = CreateCertificateAuthorityResponse & __MetadataBearer; +/** + *

Creates a root or subordinate private certificate authority (CA). You must specify the + * CA configuration, the certificate revocation list (CRL) configuration, the CA type, and + * an optional idempotency token to avoid accidental creation of multiple CAs. The CA + * configuration specifies the name of the algorithm and key size to be used to create the + * CA private key, the type of signing algorithm that the CA uses, and X.500 subject + * information. The CRL configuration specifies the CRL expiration period in days (the + * validity period of the CRL), the Amazon S3 bucket that will contain the CRL, and a CNAME + * alias for the S3 bucket that is included in certificates issued by the CA. If + * successful, this action returns the Amazon Resource Name (ARN) of the CA.

+ *

ACM Private CAA assets that are stored in Amazon S3 can be protected with encryption. + * For more information, see Encrypting Your + * CRLs.

+ * + *

Both PCA and the IAM principal must have permission to write to + * the S3 bucket that you specify. If the IAM principal making the call + * does not have permission to write to the bucket, then an exception is + * thrown. For more information, see Configure + * Access to ACM Private CA.

+ *
+ */ export class CreateCertificateAuthorityCommand extends $Command< CreateCertificateAuthorityCommandInput, CreateCertificateAuthorityCommandOutput, @@ -34,6 +55,9 @@ export class CreateCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/CreatePermissionCommand.ts b/clients/client-acm-pca/commands/CreatePermissionCommand.ts index 9bc7e4d4451bb..da98f2716a457 100644 --- a/clients/client-acm-pca/commands/CreatePermissionCommand.ts +++ b/clients/client-acm-pca/commands/CreatePermissionCommand.ts @@ -20,6 +20,35 @@ import { export type CreatePermissionCommandInput = CreatePermissionRequest; export type CreatePermissionCommandOutput = __MetadataBearer; +/** + *

Grants one or more permissions on a private CA to the AWS Certificate Manager (ACM) service + * principal (acm.amazonaws.com). These permissions allow ACM to issue and + * renew ACM certificates that reside in the same AWS account as the CA.

+ *

You can list current permissions with the ListPermissions action and + * revoke them with the DeletePermission action.

+ *

+ * About Permissions + *

+ *
    + *
  • + *

    If the private CA and the certificates it issues reside in the same + * account, you can use CreatePermission to grant permissions for ACM to + * carry out automatic certificate renewals.

    + *
  • + *
  • + *

    For automatic certificate renewal to succeed, the ACM service principal + * needs permissions to create, retrieve, and list certificates.

    + *
  • + *
  • + *

    If the private CA and the ACM certificates reside in different accounts, + * then permissions cannot be used to enable automatic renewals. Instead, + * the ACM certificate owner must set up a resource-based policy to enable + * cross-account issuance and renewals. For more information, see + * Using a Resource + * Based Policy with ACM Private CA.

    + *
  • + *
+ */ export class CreatePermissionCommand extends $Command< CreatePermissionCommandInput, CreatePermissionCommandOutput, @@ -34,6 +63,9 @@ export class CreatePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/DeleteCertificateAuthorityCommand.ts b/clients/client-acm-pca/commands/DeleteCertificateAuthorityCommand.ts index 58363026268a8..311ef7180558a 100644 --- a/clients/client-acm-pca/commands/DeleteCertificateAuthorityCommand.ts +++ b/clients/client-acm-pca/commands/DeleteCertificateAuthorityCommand.ts @@ -20,6 +20,28 @@ import { export type DeleteCertificateAuthorityCommandInput = DeleteCertificateAuthorityRequest; export type DeleteCertificateAuthorityCommandOutput = __MetadataBearer; +/** + *

Deletes a private certificate authority (CA). You must provide the Amazon Resource + * Name (ARN) of the private CA that you want to delete. You can find the ARN by calling + * the ListCertificateAuthorities action.

+ * + *

Deleting a CA will invalidate other CAs and certificates below it in your CA + * hierarchy.

+ *
+ *

Before you can delete a CA that you have created and activated, you must disable it. + * To do this, call the UpdateCertificateAuthority action and set the CertificateAuthorityStatus parameter to DISABLED.

+ *

Additionally, you can delete a CA if you are waiting for it to be created (that is, + * the status of the CA is CREATING). You can also delete it if the CA has + * been created but you haven't yet imported the signed certificate into ACM Private CA (that is, + * the status of the CA is PENDING_CERTIFICATE).

+ *

When you successfully call DeleteCertificateAuthority, the CA's status changes to + * DELETED. However, the CA won't be permanently deleted until the restoration + * period has passed. By default, if you do not set the + * PermanentDeletionTimeInDays parameter, the CA remains restorable for 30 + * days. You can set the parameter from 7 to 30 days. The DescribeCertificateAuthority action returns the time remaining in the + * restoration window of a private CA in the DELETED state. To restore an + * eligible CA, call the RestoreCertificateAuthority action.

+ */ export class DeleteCertificateAuthorityCommand extends $Command< DeleteCertificateAuthorityCommandInput, DeleteCertificateAuthorityCommandOutput, @@ -34,6 +56,9 @@ export class DeleteCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/DeletePermissionCommand.ts b/clients/client-acm-pca/commands/DeletePermissionCommand.ts index b1d3c2fef7f21..0080feb9cd01d 100644 --- a/clients/client-acm-pca/commands/DeletePermissionCommand.ts +++ b/clients/client-acm-pca/commands/DeletePermissionCommand.ts @@ -20,6 +20,37 @@ import { export type DeletePermissionCommandInput = DeletePermissionRequest; export type DeletePermissionCommandOutput = __MetadataBearer; +/** + *

Revokes permissions on a private CA granted to the AWS Certificate Manager (ACM) service principal + * (acm.amazonaws.com).

+ *

These permissions allow ACM to issue and renew ACM certificates that reside in the + * same AWS account as the CA. If you revoke these permissions, ACM will no longer + * renew the affected certificates automatically.

+ *

Permissions can be granted with the CreatePermission action and + * listed with the ListPermissions action.

+ *

+ * About Permissions + *

+ *
    + *
  • + *

    If the private CA and the certificates it issues reside in the same + * account, you can use CreatePermission to grant permissions for ACM to + * carry out automatic certificate renewals.

    + *
  • + *
  • + *

    For automatic certificate renewal to succeed, the ACM service principal + * needs permissions to create, retrieve, and list certificates.

    + *
  • + *
  • + *

    If the private CA and the ACM certificates reside in different accounts, + * then permissions cannot be used to enable automatic renewals. Instead, + * the ACM certificate owner must set up a resource-based policy to enable + * cross-account issuance and renewals. For more information, see + * Using a Resource + * Based Policy with ACM Private CA.

    + *
  • + *
+ */ export class DeletePermissionCommand extends $Command< DeletePermissionCommandInput, DeletePermissionCommandOutput, @@ -34,6 +65,9 @@ export class DeletePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/DeletePolicyCommand.ts b/clients/client-acm-pca/commands/DeletePolicyCommand.ts index db487037b7c8c..e9e45058264ca 100644 --- a/clients/client-acm-pca/commands/DeletePolicyCommand.ts +++ b/clients/client-acm-pca/commands/DeletePolicyCommand.ts @@ -20,6 +20,43 @@ import { export type DeletePolicyCommandInput = DeletePolicyRequest; export type DeletePolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the resource-based policy attached to a private CA. Deletion will remove any + * access that the policy has granted. If there is no policy attached to the private CA, + * this action will return successful.

+ *

If you delete a policy that was applied through AWS Resource Access Manager (RAM), + * the CA will be removed from all shares in which it was included.

+ *

The AWS Certificate Manager Service Linked Role that the policy supports is not affected when you delete + * the policy.

+ *

The current policy can be shown with GetPolicy and updated with PutPolicy.

+ *

+ * About Policies + *

+ *
    + *
  • + *

    A policy grants access on a private CA to an AWS customer account, to AWS Organizations, or to + * an AWS Organizations unit. Policies are under the control of a CA administrator. For more information, + * see Using a Resource Based Policy with ACM Private CA.

    + *
  • + *
  • + *

    A policy permits a user of AWS Certificate Manager (ACM) to issue ACM certificates + * signed by a CA in another account.

    + *
  • + *
  • + *

    For ACM to manage automatic renewal of these certificates, + * the ACM user must configure a Service Linked Role (SLR). The SLR allows + * the ACM service to assume the identity of the user, subject to confirmation against the + * ACM Private CA policy. For more information, see + * Using a + * Service Linked Role with ACM.

    + *
  • + *
  • + *

    Updates made in AWS Resource Manager (RAM) are reflected in policies. For more information, + * see Using AWS Resource Access Manager + * (RAM) with ACM Private CA.

    + *
  • + *
+ */ export class DeletePolicyCommand extends $Command< DeletePolicyCommandInput, DeletePolicyCommandOutput, @@ -34,6 +71,9 @@ export class DeletePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/DescribeCertificateAuthorityAuditReportCommand.ts b/clients/client-acm-pca/commands/DescribeCertificateAuthorityAuditReportCommand.ts index be538f4a78f15..eec1847242123 100644 --- a/clients/client-acm-pca/commands/DescribeCertificateAuthorityAuditReportCommand.ts +++ b/clients/client-acm-pca/commands/DescribeCertificateAuthorityAuditReportCommand.ts @@ -24,6 +24,12 @@ export type DescribeCertificateAuthorityAuditReportCommandInput = DescribeCertif export type DescribeCertificateAuthorityAuditReportCommandOutput = DescribeCertificateAuthorityAuditReportResponse & __MetadataBearer; +/** + *

Lists information about a specific audit report created by calling the CreateCertificateAuthorityAuditReport action. Audit information is created + * every time the certificate authority (CA) private key is used. The private key is used + * when you call the IssueCertificate action or the + * RevokeCertificate action.

+ */ export class DescribeCertificateAuthorityAuditReportCommand extends $Command< DescribeCertificateAuthorityAuditReportCommandInput, DescribeCertificateAuthorityAuditReportCommandOutput, @@ -38,6 +44,9 @@ export class DescribeCertificateAuthorityAuditReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/DescribeCertificateAuthorityCommand.ts b/clients/client-acm-pca/commands/DescribeCertificateAuthorityCommand.ts index 55966c0239db8..2045121afc3f2 100644 --- a/clients/client-acm-pca/commands/DescribeCertificateAuthorityCommand.ts +++ b/clients/client-acm-pca/commands/DescribeCertificateAuthorityCommand.ts @@ -20,6 +20,49 @@ import { export type DescribeCertificateAuthorityCommandInput = DescribeCertificateAuthorityRequest; export type DescribeCertificateAuthorityCommandOutput = DescribeCertificateAuthorityResponse & __MetadataBearer; +/** + *

Lists information about your private certificate authority (CA) or one that has been + * shared with you. You specify the private CA on input by its ARN (Amazon Resource Name). + * The output contains the status of your CA. This can be any of the following:

+ *
    + *
  • + *

    + * CREATING - ACM Private CA is creating your private certificate + * authority.

    + *
  • + *
  • + *

    + * PENDING_CERTIFICATE - The certificate is pending. You must use + * your ACM Private CA-hosted or on-premises root or subordinate CA to sign your private CA + * CSR and then import it into PCA.

    + *
  • + *
  • + *

    + * ACTIVE - Your private CA is active.

    + *
  • + *
  • + *

    + * DISABLED - Your private CA has been disabled.

    + *
  • + *
  • + *

    + * EXPIRED - Your private CA certificate has expired.

    + *
  • + *
  • + *

    + * FAILED - Your private CA has failed. Your CA can fail because of + * problems such a network outage or backend AWS failure or other errors. A + * failed CA can never return to the pending state. You must create a new CA. + *

    + *
  • + *
  • + *

    + * DELETED - Your private CA is within the restoration period, after + * which it is permanently deleted. The length of time remaining in the CA's + * restoration period is also included in this action's output.

    + *
  • + *
+ */ export class DescribeCertificateAuthorityCommand extends $Command< DescribeCertificateAuthorityCommandInput, DescribeCertificateAuthorityCommandOutput, @@ -34,6 +77,9 @@ export class DescribeCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/GetCertificateAuthorityCertificateCommand.ts b/clients/client-acm-pca/commands/GetCertificateAuthorityCertificateCommand.ts index 1234728b30220..014d5f3838ca5 100644 --- a/clients/client-acm-pca/commands/GetCertificateAuthorityCertificateCommand.ts +++ b/clients/client-acm-pca/commands/GetCertificateAuthorityCertificateCommand.ts @@ -24,6 +24,12 @@ export type GetCertificateAuthorityCertificateCommandInput = GetCertificateAutho export type GetCertificateAuthorityCertificateCommandOutput = GetCertificateAuthorityCertificateResponse & __MetadataBearer; +/** + *

Retrieves the certificate and certificate chain for your private certificate authority + * (CA) or one that has been shared with you. Both the certificate and the chain are base64 + * PEM-encoded. The chain does not include the CA certificate. Each certificate in the + * chain signs the one before it.

+ */ export class GetCertificateAuthorityCertificateCommand extends $Command< GetCertificateAuthorityCertificateCommandInput, GetCertificateAuthorityCertificateCommandOutput, @@ -38,6 +44,9 @@ export class GetCertificateAuthorityCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/GetCertificateAuthorityCsrCommand.ts b/clients/client-acm-pca/commands/GetCertificateAuthorityCsrCommand.ts index 6900c9ccc32f1..a167851cf5771 100644 --- a/clients/client-acm-pca/commands/GetCertificateAuthorityCsrCommand.ts +++ b/clients/client-acm-pca/commands/GetCertificateAuthorityCsrCommand.ts @@ -20,6 +20,13 @@ import { export type GetCertificateAuthorityCsrCommandInput = GetCertificateAuthorityCsrRequest; export type GetCertificateAuthorityCsrCommandOutput = GetCertificateAuthorityCsrResponse & __MetadataBearer; +/** + *

Retrieves the certificate signing request (CSR) for your private certificate authority + * (CA). The CSR is created when you call the CreateCertificateAuthority action. Sign the CSR with your ACM Private CA-hosted or + * on-premises root or subordinate CA. Then import the signed certificate back into ACM Private CA + * by calling the ImportCertificateAuthorityCertificate action. The CSR is returned as a + * base64 PEM-encoded string.

+ */ export class GetCertificateAuthorityCsrCommand extends $Command< GetCertificateAuthorityCsrCommandInput, GetCertificateAuthorityCsrCommandOutput, @@ -34,6 +41,9 @@ export class GetCertificateAuthorityCsrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/GetCertificateCommand.ts b/clients/client-acm-pca/commands/GetCertificateCommand.ts index 7d386fb05aa12..17e539b2c671e 100644 --- a/clients/client-acm-pca/commands/GetCertificateCommand.ts +++ b/clients/client-acm-pca/commands/GetCertificateCommand.ts @@ -20,6 +20,16 @@ import { export type GetCertificateCommandInput = GetCertificateRequest; export type GetCertificateCommandOutput = GetCertificateResponse & __MetadataBearer; +/** + *

Retrieves a certificate from your private CA or one that has been shared with you. The + * ARN of the certificate is returned when you call the IssueCertificate action. You + * must specify both the ARN of your private CA and the ARN of the issued certificate when + * calling the GetCertificate action. You can retrieve the + * certificate if it is in the ISSUED state. You can call + * the CreateCertificateAuthorityAuditReport action to create a report that + * contains information about all of the certificates issued and revoked by your private + * CA.

+ */ export class GetCertificateCommand extends $Command< GetCertificateCommandInput, GetCertificateCommandOutput, @@ -34,6 +44,9 @@ export class GetCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/GetPolicyCommand.ts b/clients/client-acm-pca/commands/GetPolicyCommand.ts index 4ec3c601b1897..8d8d743922adf 100644 --- a/clients/client-acm-pca/commands/GetPolicyCommand.ts +++ b/clients/client-acm-pca/commands/GetPolicyCommand.ts @@ -17,6 +17,39 @@ import { export type GetPolicyCommandInput = GetPolicyRequest; export type GetPolicyCommandOutput = GetPolicyResponse & __MetadataBearer; +/** + *

Retrieves the resource-based policy attached to a private CA. If either the private CA + * resource or the policy cannot be found, this action returns a + * ResourceNotFoundException.

+ *

The policy can be attached or updated with PutPolicy and removed with DeletePolicy.

+ *

+ * About Policies + *

+ *
    + *
  • + *

    A policy grants access on a private CA to an AWS customer account, to AWS Organizations, or to + * an AWS Organizations unit. Policies are under the control of a CA administrator. For more information, + * see Using a Resource Based Policy with ACM Private CA.

    + *
  • + *
  • + *

    A policy permits a user of AWS Certificate Manager (ACM) to issue ACM certificates + * signed by a CA in another account.

    + *
  • + *
  • + *

    For ACM to manage automatic renewal of these certificates, + * the ACM user must configure a Service Linked Role (SLR). The SLR allows + * the ACM service to assume the identity of the user, subject to confirmation against the + * ACM Private CA policy. For more information, see + * Using a + * Service Linked Role with ACM.

    + *
  • + *
  • + *

    Updates made in AWS Resource Manager (RAM) are reflected in policies. For more information, + * see Using AWS Resource Access Manager + * (RAM) with ACM Private CA.

    + *
  • + *
+ */ export class GetPolicyCommand extends $Command< GetPolicyCommandInput, GetPolicyCommandOutput, @@ -31,6 +64,9 @@ export class GetPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/ImportCertificateAuthorityCertificateCommand.ts b/clients/client-acm-pca/commands/ImportCertificateAuthorityCertificateCommand.ts index 53480e071fba6..4069d232f934e 100644 --- a/clients/client-acm-pca/commands/ImportCertificateAuthorityCertificateCommand.ts +++ b/clients/client-acm-pca/commands/ImportCertificateAuthorityCertificateCommand.ts @@ -20,6 +20,123 @@ import { export type ImportCertificateAuthorityCertificateCommandInput = ImportCertificateAuthorityCertificateRequest; export type ImportCertificateAuthorityCertificateCommandOutput = __MetadataBearer; +/** + *

Imports a signed private CA certificate into ACM Private CA. This action is used when you are + * using a chain of trust whose root is located outside ACM Private CA. Before you can call this + * action, the following preparations must in place:

+ *
    + *
  1. + *

    In ACM Private CA, call the CreateCertificateAuthority action to create the private CA that + * that you plan to back with the imported certificate.

    + *
  2. + *
  3. + *

    Call the GetCertificateAuthorityCsr action to generate a certificate signing + * request (CSR).

    + *
  4. + *
  5. + *

    Sign the CSR using a root or intermediate CA hosted by either an on-premises + * PKI hierarchy or by a commercial CA.

    + *
  6. + *
  7. + *

    Create a certificate chain and copy the signed certificate and the certificate + * chain to your working directory.

    + *
  8. + *
+ *

The following requirements apply when you import a CA certificate.

+ *
    + *
  • + *

    You cannot import a non-self-signed certificate for use as a root CA.

    + *
  • + *
  • + *

    You cannot import a self-signed certificate for use as a subordinate + * CA.

    + *
  • + *
  • + *

    Your certificate chain must not include the private CA certificate that you + * are importing.

    + *
  • + *
  • + *

    Your ACM Private CA-hosted or on-premises CA certificate must be the last certificate + * in your chain. The subordinate certificate, if any, that your root CA signed + * must be next to last. The subordinate certificate signed by the preceding + * subordinate CA must come next, and so on until your chain is built.

    + *
  • + *
  • + *

    The chain must be PEM-encoded.

    + *
  • + *
  • + *

    The maximum allowed size of a certificate is 32 KB.

    + *
  • + *
  • + *

    The maximum allowed size of a certificate chain is 2 MB.

    + *
  • + *
+ *

+ * Enforcement of Critical Constraints + *

+ *

ACM Private CA allows the following extensions to be marked critical in the imported CA + * certificate or chain.

+ *
    + *
  • + *

    Basic constraints (must be marked critical)

    + *
  • + *
  • + *

    Subject alternative names

    + *
  • + *
  • + *

    Key usage

    + *
  • + *
  • + *

    Extended key usage

    + *
  • + *
  • + *

    Authority key identifier

    + *
  • + *
  • + *

    Subject key identifier

    + *
  • + *
  • + *

    Issuer alternative name

    + *
  • + *
  • + *

    Subject directory attributes

    + *
  • + *
  • + *

    Subject information access

    + *
  • + *
  • + *

    Certificate policies

    + *
  • + *
  • + *

    Policy mappings

    + *
  • + *
  • + *

    Inhibit anyPolicy

    + *
  • + *
+ *

ACM Private CA rejects the following extensions when they are marked critical in an imported CA + * certificate or chain.

+ *
    + *
  • + *

    Name constraints

    + *
  • + *
  • + *

    Policy constraints

    + *
  • + *
  • + *

    CRL distribution points

    + *
  • + *
  • + *

    Authority information access

    + *
  • + *
  • + *

    Freshest CRL

    + *
  • + *
  • + *

    Any other extension

    + *
  • + *
+ */ export class ImportCertificateAuthorityCertificateCommand extends $Command< ImportCertificateAuthorityCertificateCommandInput, ImportCertificateAuthorityCertificateCommandOutput, @@ -34,6 +151,9 @@ export class ImportCertificateAuthorityCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/IssueCertificateCommand.ts b/clients/client-acm-pca/commands/IssueCertificateCommand.ts index 62db08f8e2bdb..4471fffdd2606 100644 --- a/clients/client-acm-pca/commands/IssueCertificateCommand.ts +++ b/clients/client-acm-pca/commands/IssueCertificateCommand.ts @@ -20,6 +20,17 @@ import { export type IssueCertificateCommandInput = IssueCertificateRequest; export type IssueCertificateCommandOutput = IssueCertificateResponse & __MetadataBearer; +/** + *

Uses your private certificate authority + * (CA), or one that + * has been shared with you, to issue a client certificate. This action returns the Amazon + * Resource Name (ARN) of the certificate. You can retrieve the certificate by calling the + * GetCertificate action and specifying the ARN.

+ * + *

You cannot use the ACM ListCertificateAuthorities action to retrieve the ARNs of the + * certificates that you issue by using ACM Private CA.

+ *
+ */ export class IssueCertificateCommand extends $Command< IssueCertificateCommandInput, IssueCertificateCommandOutput, @@ -34,6 +45,9 @@ export class IssueCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/ListCertificateAuthoritiesCommand.ts b/clients/client-acm-pca/commands/ListCertificateAuthoritiesCommand.ts index 9a17699c911f6..41f4bbdd010ab 100644 --- a/clients/client-acm-pca/commands/ListCertificateAuthoritiesCommand.ts +++ b/clients/client-acm-pca/commands/ListCertificateAuthoritiesCommand.ts @@ -20,6 +20,9 @@ import { export type ListCertificateAuthoritiesCommandInput = ListCertificateAuthoritiesRequest; export type ListCertificateAuthoritiesCommandOutput = ListCertificateAuthoritiesResponse & __MetadataBearer; +/** + *

Lists the private certificate authorities that you created by using the CreateCertificateAuthority action.

+ */ export class ListCertificateAuthoritiesCommand extends $Command< ListCertificateAuthoritiesCommandInput, ListCertificateAuthoritiesCommandOutput, @@ -34,6 +37,9 @@ export class ListCertificateAuthoritiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/ListPermissionsCommand.ts b/clients/client-acm-pca/commands/ListPermissionsCommand.ts index cbc7e1c0b4bba..7290571a8d31c 100644 --- a/clients/client-acm-pca/commands/ListPermissionsCommand.ts +++ b/clients/client-acm-pca/commands/ListPermissionsCommand.ts @@ -20,6 +20,36 @@ import { export type ListPermissionsCommandInput = ListPermissionsRequest; export type ListPermissionsCommandOutput = ListPermissionsResponse & __MetadataBearer; +/** + *

List all permissions on a private CA, if any, granted to the AWS Certificate Manager (ACM) service + * principal (acm.amazonaws.com).

+ *

These permissions allow ACM to issue and renew ACM certificates that reside in the + * same AWS account as the CA.

+ *

Permissions can be granted with the CreatePermission action and + * revoked with the DeletePermission action.

+ *

+ * About Permissions + *

+ *
    + *
  • + *

    If the private CA and the certificates it issues reside in the same + * account, you can use CreatePermission to grant permissions for ACM to + * carry out automatic certificate renewals.

    + *
  • + *
  • + *

    For automatic certificate renewal to succeed, the ACM service principal + * needs permissions to create, retrieve, and list certificates.

    + *
  • + *
  • + *

    If the private CA and the ACM certificates reside in different accounts, + * then permissions cannot be used to enable automatic renewals. Instead, + * the ACM certificate owner must set up a resource-based policy to enable + * cross-account issuance and renewals. For more information, see + * Using a Resource + * Based Policy with ACM Private CA.

    + *
  • + *
+ */ export class ListPermissionsCommand extends $Command< ListPermissionsCommandInput, ListPermissionsCommandOutput, @@ -34,6 +64,9 @@ export class ListPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/ListTagsCommand.ts b/clients/client-acm-pca/commands/ListTagsCommand.ts index 08cc2116c9044..7fca3588d36fb 100644 --- a/clients/client-acm-pca/commands/ListTagsCommand.ts +++ b/clients/client-acm-pca/commands/ListTagsCommand.ts @@ -17,6 +17,12 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResponse & __MetadataBearer; +/** + *

Lists the tags, if any, that are associated with your private CA or one that has been + * shared with you. Tags are labels that you can use to identify and organize your CAs. + * Each tag consists of a key and an optional value. Call the TagCertificateAuthority + * action to add one or more tags to your CA. Call the UntagCertificateAuthority action to remove tags.

+ */ export class ListTagsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +33,9 @@ export class ListTagsCommand extends $Command, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/PutPolicyCommand.ts b/clients/client-acm-pca/commands/PutPolicyCommand.ts index 3e722314b9ce4..0dc6dd53220e0 100644 --- a/clients/client-acm-pca/commands/PutPolicyCommand.ts +++ b/clients/client-acm-pca/commands/PutPolicyCommand.ts @@ -17,6 +17,40 @@ import { export type PutPolicyCommandInput = PutPolicyRequest; export type PutPolicyCommandOutput = __MetadataBearer; +/** + *

Attaches a resource-based policy to a private CA.

+ *

A policy can also be applied by sharing a private CA through AWS Resource Access Manager + * (RAM).

+ *

The policy can be displayed with GetPolicy and removed with DeletePolicy.

+ * + *

+ * About Policies + *

+ *
    + *
  • + *

    A policy grants access on a private CA to an AWS customer account, to AWS Organizations, or to + * an AWS Organizations unit. Policies are under the control of a CA administrator. For more information, + * see Using a Resource Based Policy with ACM Private CA.

    + *
  • + *
  • + *

    A policy permits a user of AWS Certificate Manager (ACM) to issue ACM certificates + * signed by a CA in another account.

    + *
  • + *
  • + *

    For ACM to manage automatic renewal of these certificates, + * the ACM user must configure a Service Linked Role (SLR). The SLR allows + * the ACM service to assume the identity of the user, subject to confirmation against the + * ACM Private CA policy. For more information, see + * Using a + * Service Linked Role with ACM.

    + *
  • + *
  • + *

    Updates made in AWS Resource Manager (RAM) are reflected in policies. For more information, + * see Using AWS Resource Access Manager + * (RAM) with ACM Private CA.

    + *
  • + *
+ */ export class PutPolicyCommand extends $Command< PutPolicyCommandInput, PutPolicyCommandOutput, @@ -31,6 +65,9 @@ export class PutPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/RestoreCertificateAuthorityCommand.ts b/clients/client-acm-pca/commands/RestoreCertificateAuthorityCommand.ts index 94d55d4ffde0f..3340dc83df556 100644 --- a/clients/client-acm-pca/commands/RestoreCertificateAuthorityCommand.ts +++ b/clients/client-acm-pca/commands/RestoreCertificateAuthorityCommand.ts @@ -20,6 +20,19 @@ import { export type RestoreCertificateAuthorityCommandInput = RestoreCertificateAuthorityRequest; export type RestoreCertificateAuthorityCommandOutput = __MetadataBearer; +/** + *

Restores a certificate authority (CA) that is in the DELETED state. You + * can restore a CA during the period that you defined in the PermanentDeletionTimeInDays parameter of the DeleteCertificateAuthority action. Currently, you can specify 7 to 30 days. + * If you did not specify a PermanentDeletionTimeInDays + * value, by default you can restore the CA at any time in a 30 day period. You can check + * the time remaining in the restoration period of a private CA in the DELETED + * state by calling the DescribeCertificateAuthority or ListCertificateAuthorities actions. The status of a restored CA is set to + * its pre-deletion status when the RestoreCertificateAuthority action returns. To change its status to + * ACTIVE, call the UpdateCertificateAuthority action. If the private CA was in the + * PENDING_CERTIFICATE state at deletion, you must use the ImportCertificateAuthorityCertificate action to import a certificate + * authority into the private CA before it can be activated. You cannot restore a CA after + * the restoration period has ended.

+ */ export class RestoreCertificateAuthorityCommand extends $Command< RestoreCertificateAuthorityCommandInput, RestoreCertificateAuthorityCommandOutput, @@ -34,6 +47,9 @@ export class RestoreCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/RevokeCertificateCommand.ts b/clients/client-acm-pca/commands/RevokeCertificateCommand.ts index 3dd478ff52baa..34bb2a00c4bd3 100644 --- a/clients/client-acm-pca/commands/RevokeCertificateCommand.ts +++ b/clients/client-acm-pca/commands/RevokeCertificateCommand.ts @@ -20,6 +20,28 @@ import { export type RevokeCertificateCommandInput = RevokeCertificateRequest; export type RevokeCertificateCommandOutput = __MetadataBearer; +/** + *

Revokes a certificate that was issued inside ACM Private CA. If you enable a certificate + * revocation list (CRL) when you create or update your private CA, information about the + * revoked certificates will be included in the CRL. ACM Private CA writes the CRL to an S3 bucket + * that you specify. A CRL is typically updated approximately 30 minutes after a + * certificate is revoked. If for any reason the CRL update fails, ACM Private CA attempts makes + * further attempts every 15 minutes. With Amazon CloudWatch, you can create alarms for the + * metrics CRLGenerated and MisconfiguredCRLBucket. For more + * information, see Supported CloudWatch Metrics.

+ * + *

Both PCA and the IAM principal must have permission to write to + * the S3 bucket that you specify. If the IAM principal making the call + * does not have permission to write to the bucket, then an exception is + * thrown. For more information, see Configure + * Access to ACM Private CA.

+ *
+ *

ACM Private CA also writes revocation information to the audit report. For more information, + * see CreateCertificateAuthorityAuditReport.

+ * + *

You cannot revoke a root CA self-signed certificate.

+ *
+ */ export class RevokeCertificateCommand extends $Command< RevokeCertificateCommandInput, RevokeCertificateCommandOutput, @@ -34,6 +56,9 @@ export class RevokeCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/TagCertificateAuthorityCommand.ts b/clients/client-acm-pca/commands/TagCertificateAuthorityCommand.ts index 96faae3372a29..6595fbf20f98d 100644 --- a/clients/client-acm-pca/commands/TagCertificateAuthorityCommand.ts +++ b/clients/client-acm-pca/commands/TagCertificateAuthorityCommand.ts @@ -20,6 +20,16 @@ import { export type TagCertificateAuthorityCommandInput = TagCertificateAuthorityRequest; export type TagCertificateAuthorityCommandOutput = __MetadataBearer; +/** + *

Adds one or more tags to your private CA. Tags are labels that you can use to identify + * and organize your AWS resources. Each tag consists of a key and an optional value. You + * specify the private CA on input by its Amazon Resource Name (ARN). You specify the tag + * by using a key-value pair. You can apply a tag to just one private CA if you want to + * identify a specific characteristic of that CA, or you can apply the same tag to multiple + * private CAs if you want to filter for a common relationship among those CAs. To remove + * one or more tags, use the UntagCertificateAuthority action. Call the ListTags action to see what tags are + * associated with your CA.

+ */ export class TagCertificateAuthorityCommand extends $Command< TagCertificateAuthorityCommandInput, TagCertificateAuthorityCommandOutput, @@ -34,6 +44,9 @@ export class TagCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/UntagCertificateAuthorityCommand.ts b/clients/client-acm-pca/commands/UntagCertificateAuthorityCommand.ts index e0883cf1af0d9..8f66eeef16432 100644 --- a/clients/client-acm-pca/commands/UntagCertificateAuthorityCommand.ts +++ b/clients/client-acm-pca/commands/UntagCertificateAuthorityCommand.ts @@ -20,6 +20,13 @@ import { export type UntagCertificateAuthorityCommandInput = UntagCertificateAuthorityRequest; export type UntagCertificateAuthorityCommandOutput = __MetadataBearer; +/** + *

Remove one or more tags from your private CA. A tag consists of a key-value pair. If + * you do not specify the value portion of the tag when calling this action, the tag will + * be removed regardless of value. If you specify a value, the tag is removed only if it is + * associated with the specified value. To add tags to a private CA, use the TagCertificateAuthority. Call the ListTags action to see what tags are + * associated with your CA.

+ */ export class UntagCertificateAuthorityCommand extends $Command< UntagCertificateAuthorityCommandInput, UntagCertificateAuthorityCommandOutput, @@ -34,6 +41,9 @@ export class UntagCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/commands/UpdateCertificateAuthorityCommand.ts b/clients/client-acm-pca/commands/UpdateCertificateAuthorityCommand.ts index aa8382c7c45b6..e45a64bafd5e1 100644 --- a/clients/client-acm-pca/commands/UpdateCertificateAuthorityCommand.ts +++ b/clients/client-acm-pca/commands/UpdateCertificateAuthorityCommand.ts @@ -20,6 +20,19 @@ import { export type UpdateCertificateAuthorityCommandInput = UpdateCertificateAuthorityRequest; export type UpdateCertificateAuthorityCommandOutput = __MetadataBearer; +/** + *

Updates the status or configuration of a private certificate authority (CA). Your + * private CA must be in the ACTIVE or DISABLED state before you + * can update it. You can disable a private CA that is in the ACTIVE state or + * make a CA that is in the DISABLED state active again.

+ * + *

Both PCA and the IAM principal must have permission to write to + * the S3 bucket that you specify. If the IAM principal making the call + * does not have permission to write to the bucket, then an exception is + * thrown. For more information, see Configure + * Access to ACM Private CA.

+ *
+ */ export class UpdateCertificateAuthorityCommand extends $Command< UpdateCertificateAuthorityCommandInput, UpdateCertificateAuthorityCommandOutput, @@ -34,6 +47,9 @@ export class UpdateCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMPCAClientResolvedConfig, diff --git a/clients/client-acm-pca/package.json b/clients/client-acm-pca/package.json index 189c66be943da..c1d88d2dd4b16 100644 --- a/clients/client-acm-pca/package.json +++ b/clients/client-acm-pca/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Acm Pca Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-acm-pca/pagination/ListCertificateAuthoritiesPaginator.ts b/clients/client-acm-pca/pagination/ListCertificateAuthoritiesPaginator.ts index 570b26606d0f3..ddf4b93eaa080 100644 --- a/clients/client-acm-pca/pagination/ListCertificateAuthoritiesPaginator.ts +++ b/clients/client-acm-pca/pagination/ListCertificateAuthoritiesPaginator.ts @@ -8,6 +8,9 @@ import { import { ACMPCAPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ACMPCAClient, input: ListCertificateAuthoritiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCertificateAuthoritiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ACMPCA, input: ListCertificateAuthoritiesCommandInput, diff --git a/clients/client-acm-pca/pagination/ListPermissionsPaginator.ts b/clients/client-acm-pca/pagination/ListPermissionsPaginator.ts index 3d85f4bb07c01..2580d0a7d3c64 100644 --- a/clients/client-acm-pca/pagination/ListPermissionsPaginator.ts +++ b/clients/client-acm-pca/pagination/ListPermissionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ACMPCAPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ACMPCAClient, input: ListPermissionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPermissionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ACMPCA, input: ListPermissionsCommandInput, diff --git a/clients/client-acm-pca/pagination/ListTagsPaginator.ts b/clients/client-acm-pca/pagination/ListTagsPaginator.ts index a3540094ebce4..9bb8401c24793 100644 --- a/clients/client-acm-pca/pagination/ListTagsPaginator.ts +++ b/clients/client-acm-pca/pagination/ListTagsPaginator.ts @@ -4,6 +4,9 @@ import { ListTagsCommand, ListTagsCommandInput, ListTagsCommandOutput } from ".. import { ACMPCAPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ACMPCAClient, input: ListTagsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ACMPCA, input: ListTagsCommandInput, diff --git a/clients/client-acm-pca/runtimeConfig.browser.ts b/clients/client-acm-pca/runtimeConfig.browser.ts index f831bec34ac27..90ffd3b77df6e 100644 --- a/clients/client-acm-pca/runtimeConfig.browser.ts +++ b/clients/client-acm-pca/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ACMPCAClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-acm-pca/runtimeConfig.native.ts b/clients/client-acm-pca/runtimeConfig.native.ts index f9f4817858145..d103502caad3b 100644 --- a/clients/client-acm-pca/runtimeConfig.native.ts +++ b/clients/client-acm-pca/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ACMPCAClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-acm-pca/runtimeConfig.shared.ts b/clients/client-acm-pca/runtimeConfig.shared.ts index ba390775262a1..9108e958895c1 100644 --- a/clients/client-acm-pca/runtimeConfig.shared.ts +++ b/clients/client-acm-pca/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-08-22", disableHostPrefix: false, diff --git a/clients/client-acm-pca/runtimeConfig.ts b/clients/client-acm-pca/runtimeConfig.ts index 499187269c5d5..f7c71161f59e6 100644 --- a/clients/client-acm-pca/runtimeConfig.ts +++ b/clients/client-acm-pca/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ACMPCAClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-acm-pca/tsconfig.json b/clients/client-acm-pca/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-acm-pca/tsconfig.json +++ b/clients/client-acm-pca/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-acm/commands/AddTagsToCertificateCommand.ts b/clients/client-acm/commands/AddTagsToCertificateCommand.ts index fdab3ebc39cd1..36d9fae83ecb7 100644 --- a/clients/client-acm/commands/AddTagsToCertificateCommand.ts +++ b/clients/client-acm/commands/AddTagsToCertificateCommand.ts @@ -20,6 +20,24 @@ import { export type AddTagsToCertificateCommandInput = AddTagsToCertificateRequest; export type AddTagsToCertificateCommandOutput = __MetadataBearer; +/** + *

Adds one or more tags to an ACM certificate. Tags are labels that you can use to + * identify and organize your AWS resources. Each tag consists of a key and an + * optional value. You specify the certificate on input by its Amazon Resource Name + * (ARN). You specify the tag by using a key-value pair.

+ * + *

You can apply a tag to just one certificate if you want to identify a specific + * characteristic of that certificate, or you can apply the same tag to multiple certificates if + * you want to filter for a common relationship among those certificates. Similarly, you can + * apply the same tag to multiple resources if you want to specify a relationship among those + * resources. For example, you can add the same tag to an ACM certificate and an Elastic Load + * Balancing load balancer to indicate that they are both used by the same website. For more + * information, see Tagging ACM + * certificates.

+ * + *

To remove one or more tags, use the RemoveTagsFromCertificate action. To + * view all of the tags that have been applied to the certificate, use the ListTagsForCertificate action.

+ */ export class AddTagsToCertificateCommand extends $Command< AddTagsToCertificateCommandInput, AddTagsToCertificateCommandOutput, @@ -34,6 +52,9 @@ export class AddTagsToCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/DeleteCertificateCommand.ts b/clients/client-acm/commands/DeleteCertificateCommand.ts index 7b0d2263a2d43..48da50fe3efd9 100644 --- a/clients/client-acm/commands/DeleteCertificateCommand.ts +++ b/clients/client-acm/commands/DeleteCertificateCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteCertificateCommandInput = DeleteCertificateRequest; export type DeleteCertificateCommandOutput = __MetadataBearer; +/** + *

Deletes a certificate and its associated private key. If this action succeeds, the + * certificate no longer appears in the list that can be displayed by calling the ListCertificates action or be retrieved by calling the GetCertificate action. The certificate will not be available for use by AWS + * services integrated with ACM.

+ * + *

You cannot delete an ACM certificate that is being used by another AWS service. To + * delete a certificate that is in use, the certificate association must first be + * removed.

+ *
+ */ export class DeleteCertificateCommand extends $Command< DeleteCertificateCommandInput, DeleteCertificateCommandOutput, @@ -34,6 +44,9 @@ export class DeleteCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/DescribeCertificateCommand.ts b/clients/client-acm/commands/DescribeCertificateCommand.ts index 4256b98fc8cbe..81595502b4eff 100644 --- a/clients/client-acm/commands/DescribeCertificateCommand.ts +++ b/clients/client-acm/commands/DescribeCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCertificateCommandInput = DescribeCertificateRequest; export type DescribeCertificateCommandOutput = DescribeCertificateResponse & __MetadataBearer; +/** + *

Returns detailed metadata about the specified ACM certificate.

+ */ export class DescribeCertificateCommand extends $Command< DescribeCertificateCommandInput, DescribeCertificateCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/ExportCertificateCommand.ts b/clients/client-acm/commands/ExportCertificateCommand.ts index 33bd7588cda97..d21ba8baf24c4 100644 --- a/clients/client-acm/commands/ExportCertificateCommand.ts +++ b/clients/client-acm/commands/ExportCertificateCommand.ts @@ -20,6 +20,15 @@ import { export type ExportCertificateCommandInput = ExportCertificateRequest; export type ExportCertificateCommandOutput = ExportCertificateResponse & __MetadataBearer; +/** + *

Exports a private certificate issued by a private certificate authority (CA) for use + * anywhere. The exported file contains the certificate, the certificate chain, and the encrypted + * private 2048-bit RSA key associated with the public key that is embedded in the certificate. + * For security, you must assign a passphrase for the private key when exporting it.

+ *

For information about exporting and formatting a certificate using the ACM console or + * CLI, see Export a + * Private Certificate.

+ */ export class ExportCertificateCommand extends $Command< ExportCertificateCommandInput, ExportCertificateCommandOutput, @@ -34,6 +43,9 @@ export class ExportCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/GetCertificateCommand.ts b/clients/client-acm/commands/GetCertificateCommand.ts index 59b850106d30b..fb310ec95bb63 100644 --- a/clients/client-acm/commands/GetCertificateCommand.ts +++ b/clients/client-acm/commands/GetCertificateCommand.ts @@ -20,6 +20,12 @@ import { export type GetCertificateCommandInput = GetCertificateRequest; export type GetCertificateCommandOutput = GetCertificateResponse & __MetadataBearer; +/** + *

Retrieves an Amazon-issued certificate and its certificate chain. The chain consists of + * the certificate of the issuing CA and the intermediate certificates of any other subordinate + * CAs. All of the certificates are base64 encoded. You can use OpenSSL to decode + * the certificates and inspect individual fields.

+ */ export class GetCertificateCommand extends $Command< GetCertificateCommandInput, GetCertificateCommandOutput, @@ -34,6 +40,9 @@ export class GetCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/ImportCertificateCommand.ts b/clients/client-acm/commands/ImportCertificateCommand.ts index 21064b6197c86..5a295118c7539 100644 --- a/clients/client-acm/commands/ImportCertificateCommand.ts +++ b/clients/client-acm/commands/ImportCertificateCommand.ts @@ -20,6 +20,77 @@ import { export type ImportCertificateCommandInput = ImportCertificateRequest; export type ImportCertificateCommandOutput = ImportCertificateResponse & __MetadataBearer; +/** + *

Imports a certificate into AWS Certificate Manager (ACM) to use with services that are integrated with + * ACM. Note that integrated + * services allow only certificate types and keys they support to be associated with + * their resources. Further, their support differs depending on whether the certificate is + * imported into IAM or into ACM. For more information, see the documentation for each + * service. For more information about importing certificates into ACM, see Importing + * Certificates in the AWS Certificate Manager User Guide.

+ * + * + *

ACM does not provide managed renewal for certificates that you import.

+ *
+ * + *

Note the following guidelines when importing third party certificates:

+ * + * + *
    + *
  • + *

    You must enter the private key that matches the certificate you are importing.

    + *
  • + *
  • + *

    The private key must be unencrypted. You cannot import a private key that is protected + * by a password or a passphrase.

    + *
  • + *
  • + *

    If the certificate you are importing is not self-signed, you must enter its + * certificate chain.

    + *
  • + *
  • + *

    If a certificate chain is included, the issuer must be the subject of one of the + * certificates in the chain.

    + *
  • + *
  • + *

    The certificate, private key, and certificate chain must be PEM-encoded.

    + *
  • + *
  • + *

    The current time must be between the Not Before and Not + * After certificate fields.

    + *
  • + *
  • + *

    The Issuer field must not be empty.

    + *
  • + *
  • + *

    The OCSP authority URL, if present, must not exceed 1000 characters.

    + *
  • + *
  • + *

    To import a new certificate, omit the CertificateArn argument. Include + * this argument only when you want to replace a previously imported certifica

    + *
  • + *
  • + *

    When you import a certificate by using the CLI, you must specify the certificate, the + * certificate chain, and the private key by their file names preceded by + * file://. For example, you can specify a certificate saved in the + * C:\temp folder as file://C:\temp\certificate_to_import.pem. If + * you are making an HTTP or HTTPS Query request, include these arguments as BLOBs.

    + *
  • + *
  • + *

    When you import a certificate by using an SDK, you must specify the certificate, the + * certificate chain, and the private key files in the manner required by the programming + * language you're using.

    + *
  • + *
  • + *

    The cryptographic algorithm of an imported certificate must match the algorithm of the + * signing CA. For example, if the signing CA key type is RSA, then the certificate key type + * must also be RSA.

    + *
  • + *
+ * + *

This operation returns the Amazon + * Resource Name (ARN) of the imported certificate.

+ */ export class ImportCertificateCommand extends $Command< ImportCertificateCommandInput, ImportCertificateCommandOutput, @@ -34,6 +105,9 @@ export class ImportCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/ListCertificatesCommand.ts b/clients/client-acm/commands/ListCertificatesCommand.ts index 76e4394929bf4..b046bcce43cf8 100644 --- a/clients/client-acm/commands/ListCertificatesCommand.ts +++ b/clients/client-acm/commands/ListCertificatesCommand.ts @@ -20,6 +20,12 @@ import { export type ListCertificatesCommandInput = ListCertificatesRequest; export type ListCertificatesCommandOutput = ListCertificatesResponse & __MetadataBearer; +/** + *

Retrieves a list of certificate ARNs and domain names. You can request that only + * certificates that match a specific status be listed. You can also filter by specific + * attributes of the certificate. Default filtering returns only RSA_2048 + * certificates. For more information, see Filters.

+ */ export class ListCertificatesCommand extends $Command< ListCertificatesCommandInput, ListCertificatesCommandOutput, @@ -34,6 +40,9 @@ export class ListCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/ListTagsForCertificateCommand.ts b/clients/client-acm/commands/ListTagsForCertificateCommand.ts index 66db089c5b7d0..115fcd66d6642 100644 --- a/clients/client-acm/commands/ListTagsForCertificateCommand.ts +++ b/clients/client-acm/commands/ListTagsForCertificateCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForCertificateCommandInput = ListTagsForCertificateRequest; export type ListTagsForCertificateCommandOutput = ListTagsForCertificateResponse & __MetadataBearer; +/** + *

Lists the tags that have been applied to the ACM certificate. Use the certificate's + * Amazon Resource Name (ARN) to specify the certificate. To add a tag to an ACM certificate, + * use the AddTagsToCertificate action. To delete a tag, use the RemoveTagsFromCertificate action.

+ */ export class ListTagsForCertificateCommand extends $Command< ListTagsForCertificateCommandInput, ListTagsForCertificateCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/RemoveTagsFromCertificateCommand.ts b/clients/client-acm/commands/RemoveTagsFromCertificateCommand.ts index f6168602caf37..6d0e4f7c4ad02 100644 --- a/clients/client-acm/commands/RemoveTagsFromCertificateCommand.ts +++ b/clients/client-acm/commands/RemoveTagsFromCertificateCommand.ts @@ -20,6 +20,15 @@ import { export type RemoveTagsFromCertificateCommandInput = RemoveTagsFromCertificateRequest; export type RemoveTagsFromCertificateCommandOutput = __MetadataBearer; +/** + *

Remove one or more tags from an ACM certificate. A tag consists of a key-value pair. If + * you do not specify the value portion of the tag when calling this function, the tag will be + * removed regardless of value. If you specify a value, the tag is removed only if it is + * associated with the specified value.

+ * + *

To add tags to a certificate, use the AddTagsToCertificate action. To + * view all of the tags that have been applied to a specific ACM certificate, use the ListTagsForCertificate action.

+ */ export class RemoveTagsFromCertificateCommand extends $Command< RemoveTagsFromCertificateCommandInput, RemoveTagsFromCertificateCommandOutput, @@ -34,6 +43,9 @@ export class RemoveTagsFromCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/RenewCertificateCommand.ts b/clients/client-acm/commands/RenewCertificateCommand.ts index 5736486ff1684..7b20d780e8363 100644 --- a/clients/client-acm/commands/RenewCertificateCommand.ts +++ b/clients/client-acm/commands/RenewCertificateCommand.ts @@ -20,6 +20,13 @@ import { export type RenewCertificateCommandInput = RenewCertificateRequest; export type RenewCertificateCommandOutput = __MetadataBearer; +/** + *

Renews an eligable ACM certificate. At this time, only exported private certificates can + * be renewed with this operation. In order to renew your ACM PCA certificates with ACM, you must + * first grant the ACM + * service principal permission to do so. For more information, see Testing Managed Renewal + * in the ACM User Guide.

+ */ export class RenewCertificateCommand extends $Command< RenewCertificateCommandInput, RenewCertificateCommandOutput, @@ -34,6 +41,9 @@ export class RenewCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/RequestCertificateCommand.ts b/clients/client-acm/commands/RequestCertificateCommand.ts index d1721252b26be..fbbaf64113415 100644 --- a/clients/client-acm/commands/RequestCertificateCommand.ts +++ b/clients/client-acm/commands/RequestCertificateCommand.ts @@ -20,6 +20,18 @@ import { export type RequestCertificateCommandInput = RequestCertificateRequest; export type RequestCertificateCommandOutput = RequestCertificateResponse & __MetadataBearer; +/** + *

Requests an ACM certificate for use with other AWS services. To request an ACM + * certificate, you must specify a fully qualified domain name (FQDN) in the + * DomainName parameter. You can also specify additional FQDNs in the + * SubjectAlternativeNames parameter.

+ * + *

If you are requesting a private certificate, domain validation is not required. If you are + * requesting a public certificate, each domain name that you specify must be validated to verify + * that you own or control the domain. You can use DNS validation or email validation. + * We recommend that you use DNS validation. ACM issues public certificates after receiving + * approval from the domain owner.

+ */ export class RequestCertificateCommand extends $Command< RequestCertificateCommandInput, RequestCertificateCommandOutput, @@ -34,6 +46,9 @@ export class RequestCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/ResendValidationEmailCommand.ts b/clients/client-acm/commands/ResendValidationEmailCommand.ts index e20b1ccb27b1f..e2145582a14b7 100644 --- a/clients/client-acm/commands/ResendValidationEmailCommand.ts +++ b/clients/client-acm/commands/ResendValidationEmailCommand.ts @@ -20,6 +20,17 @@ import { export type ResendValidationEmailCommandInput = ResendValidationEmailRequest; export type ResendValidationEmailCommandOutput = __MetadataBearer; +/** + *

Resends the email that requests domain ownership validation. The domain owner or an + * authorized representative must approve the ACM certificate before it can be issued. The + * certificate can be approved by clicking a link in the mail to navigate to the Amazon + * certificate approval website and then clicking I Approve. + * However, the validation email can be blocked by spam filters. Therefore, if you do not receive + * the original mail, you can request that the mail be resent within 72 hours of requesting the + * ACM certificate. If more than 72 hours have elapsed since your original request or since + * your last attempt to resend validation mail, you must request a new certificate. For more + * information about setting up your contact email addresses, see Configure Email for your Domain.

+ */ export class ResendValidationEmailCommand extends $Command< ResendValidationEmailCommandInput, ResendValidationEmailCommandOutput, @@ -34,6 +45,9 @@ export class ResendValidationEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/commands/UpdateCertificateOptionsCommand.ts b/clients/client-acm/commands/UpdateCertificateOptionsCommand.ts index a59416ef9b773..569836dab51ec 100644 --- a/clients/client-acm/commands/UpdateCertificateOptionsCommand.ts +++ b/clients/client-acm/commands/UpdateCertificateOptionsCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateCertificateOptionsCommandInput = UpdateCertificateOptionsRequest; export type UpdateCertificateOptionsCommandOutput = __MetadataBearer; +/** + *

Updates a certificate. Currently, you can use this function to specify whether to opt in + * to or out of recording your certificate in a certificate transparency log. For more + * information, see Opting Out of + * Certificate Transparency Logging.

+ */ export class UpdateCertificateOptionsCommand extends $Command< UpdateCertificateOptionsCommandInput, UpdateCertificateOptionsCommandOutput, @@ -34,6 +40,9 @@ export class UpdateCertificateOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ACMClientResolvedConfig, diff --git a/clients/client-acm/package.json b/clients/client-acm/package.json index d4a53c46fc9fb..59729cc0a0fdd 100644 --- a/clients/client-acm/package.json +++ b/clients/client-acm/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Acm Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-acm/pagination/ListCertificatesPaginator.ts b/clients/client-acm/pagination/ListCertificatesPaginator.ts index 013f67fc4dbda..5fcdf8bcbaf57 100644 --- a/clients/client-acm/pagination/ListCertificatesPaginator.ts +++ b/clients/client-acm/pagination/ListCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { ACMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ACMClient, input: ListCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ACM, input: ListCertificatesCommandInput, diff --git a/clients/client-acm/runtimeConfig.browser.ts b/clients/client-acm/runtimeConfig.browser.ts index 733dc7143e815..de4dbeb0f4be4 100644 --- a/clients/client-acm/runtimeConfig.browser.ts +++ b/clients/client-acm/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ACMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-acm/runtimeConfig.native.ts b/clients/client-acm/runtimeConfig.native.ts index 02b31f2e4f855..df9a10ab63b65 100644 --- a/clients/client-acm/runtimeConfig.native.ts +++ b/clients/client-acm/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ACMClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-acm/runtimeConfig.shared.ts b/clients/client-acm/runtimeConfig.shared.ts index f231ae207d978..1aaee2b66dc65 100644 --- a/clients/client-acm/runtimeConfig.shared.ts +++ b/clients/client-acm/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-12-08", disableHostPrefix: false, diff --git a/clients/client-acm/runtimeConfig.ts b/clients/client-acm/runtimeConfig.ts index 278eba42a7d60..b40f62b46c221 100644 --- a/clients/client-acm/runtimeConfig.ts +++ b/clients/client-acm/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ACMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-acm/tsconfig.json b/clients/client-acm/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-acm/tsconfig.json +++ b/clients/client-acm/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-alexa-for-business/commands/ApproveSkillCommand.ts b/clients/client-alexa-for-business/commands/ApproveSkillCommand.ts index 468fbf99f5f13..0883660674d0c 100644 --- a/clients/client-alexa-for-business/commands/ApproveSkillCommand.ts +++ b/clients/client-alexa-for-business/commands/ApproveSkillCommand.ts @@ -20,6 +20,10 @@ import { export type ApproveSkillCommandInput = ApproveSkillRequest; export type ApproveSkillCommandOutput = ApproveSkillResponse & __MetadataBearer; +/** + *

Associates a skill with the organization under the customer's AWS account. If a skill + * is private, the user implicitly accepts access to this skill during enablement.

+ */ export class ApproveSkillCommand extends $Command< ApproveSkillCommandInput, ApproveSkillCommandOutput, @@ -34,6 +38,9 @@ export class ApproveSkillCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/AssociateContactWithAddressBookCommand.ts b/clients/client-alexa-for-business/commands/AssociateContactWithAddressBookCommand.ts index d7f88434d4553..bcf4ad85af384 100644 --- a/clients/client-alexa-for-business/commands/AssociateContactWithAddressBookCommand.ts +++ b/clients/client-alexa-for-business/commands/AssociateContactWithAddressBookCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateContactWithAddressBookCommandInput = AssociateContactWithAddressBookRequest; export type AssociateContactWithAddressBookCommandOutput = AssociateContactWithAddressBookResponse & __MetadataBearer; +/** + *

Associates a contact with a given address book.

+ */ export class AssociateContactWithAddressBookCommand extends $Command< AssociateContactWithAddressBookCommandInput, AssociateContactWithAddressBookCommandOutput, @@ -34,6 +37,9 @@ export class AssociateContactWithAddressBookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/AssociateDeviceWithNetworkProfileCommand.ts b/clients/client-alexa-for-business/commands/AssociateDeviceWithNetworkProfileCommand.ts index b60187e10ea30..bc93211d72b1c 100644 --- a/clients/client-alexa-for-business/commands/AssociateDeviceWithNetworkProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/AssociateDeviceWithNetworkProfileCommand.ts @@ -24,6 +24,9 @@ export type AssociateDeviceWithNetworkProfileCommandInput = AssociateDeviceWithN export type AssociateDeviceWithNetworkProfileCommandOutput = AssociateDeviceWithNetworkProfileResponse & __MetadataBearer; +/** + *

Associates a device with the specified network profile.

+ */ export class AssociateDeviceWithNetworkProfileCommand extends $Command< AssociateDeviceWithNetworkProfileCommandInput, AssociateDeviceWithNetworkProfileCommandOutput, @@ -38,6 +41,9 @@ export class AssociateDeviceWithNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/AssociateDeviceWithRoomCommand.ts b/clients/client-alexa-for-business/commands/AssociateDeviceWithRoomCommand.ts index 6eae62e66ddb0..bd201d5407b0a 100644 --- a/clients/client-alexa-for-business/commands/AssociateDeviceWithRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/AssociateDeviceWithRoomCommand.ts @@ -20,6 +20,11 @@ import { export type AssociateDeviceWithRoomCommandInput = AssociateDeviceWithRoomRequest; export type AssociateDeviceWithRoomCommandOutput = AssociateDeviceWithRoomResponse & __MetadataBearer; +/** + *

Associates a device with a given room. This applies all the settings from the room + * profile to the device, and all the skills in any skill groups added to that room. This + * operation requires the device to be online, or else a manual sync is required.

+ */ export class AssociateDeviceWithRoomCommand extends $Command< AssociateDeviceWithRoomCommandInput, AssociateDeviceWithRoomCommandOutput, @@ -34,6 +39,9 @@ export class AssociateDeviceWithRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/AssociateSkillGroupWithRoomCommand.ts b/clients/client-alexa-for-business/commands/AssociateSkillGroupWithRoomCommand.ts index 1e8144a23fb15..84cf094da8188 100644 --- a/clients/client-alexa-for-business/commands/AssociateSkillGroupWithRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/AssociateSkillGroupWithRoomCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateSkillGroupWithRoomCommandInput = AssociateSkillGroupWithRoomRequest; export type AssociateSkillGroupWithRoomCommandOutput = AssociateSkillGroupWithRoomResponse & __MetadataBearer; +/** + *

Associates a skill group with a given room. This enables all skills in the associated + * skill group on all devices in the room.

+ */ export class AssociateSkillGroupWithRoomCommand extends $Command< AssociateSkillGroupWithRoomCommandInput, AssociateSkillGroupWithRoomCommandOutput, @@ -34,6 +38,9 @@ export class AssociateSkillGroupWithRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/AssociateSkillWithSkillGroupCommand.ts b/clients/client-alexa-for-business/commands/AssociateSkillWithSkillGroupCommand.ts index 364a2aca3030b..4f6a911e17b55 100644 --- a/clients/client-alexa-for-business/commands/AssociateSkillWithSkillGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/AssociateSkillWithSkillGroupCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateSkillWithSkillGroupCommandInput = AssociateSkillWithSkillGroupRequest; export type AssociateSkillWithSkillGroupCommandOutput = AssociateSkillWithSkillGroupResponse & __MetadataBearer; +/** + *

Associates a skill with a skill group.

+ */ export class AssociateSkillWithSkillGroupCommand extends $Command< AssociateSkillWithSkillGroupCommandInput, AssociateSkillWithSkillGroupCommandOutput, @@ -34,6 +37,9 @@ export class AssociateSkillWithSkillGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/AssociateSkillWithUsersCommand.ts b/clients/client-alexa-for-business/commands/AssociateSkillWithUsersCommand.ts index 304c6e75699e2..1d2d766abe236 100644 --- a/clients/client-alexa-for-business/commands/AssociateSkillWithUsersCommand.ts +++ b/clients/client-alexa-for-business/commands/AssociateSkillWithUsersCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateSkillWithUsersCommandInput = AssociateSkillWithUsersRequest; export type AssociateSkillWithUsersCommandOutput = AssociateSkillWithUsersResponse & __MetadataBearer; +/** + *

Makes a private skill available for enrolled users to enable on their devices.

+ */ export class AssociateSkillWithUsersCommand extends $Command< AssociateSkillWithUsersCommandInput, AssociateSkillWithUsersCommandOutput, @@ -34,6 +37,9 @@ export class AssociateSkillWithUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateAddressBookCommand.ts b/clients/client-alexa-for-business/commands/CreateAddressBookCommand.ts index c8e511cf85e63..243bce70cbcd0 100644 --- a/clients/client-alexa-for-business/commands/CreateAddressBookCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateAddressBookCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAddressBookCommandInput = CreateAddressBookRequest; export type CreateAddressBookCommandOutput = CreateAddressBookResponse & __MetadataBearer; +/** + *

Creates an address book with the specified details.

+ */ export class CreateAddressBookCommand extends $Command< CreateAddressBookCommandInput, CreateAddressBookCommandOutput, @@ -34,6 +37,9 @@ export class CreateAddressBookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateBusinessReportScheduleCommand.ts b/clients/client-alexa-for-business/commands/CreateBusinessReportScheduleCommand.ts index 332a4c4d4ff03..33d7efff07413 100644 --- a/clients/client-alexa-for-business/commands/CreateBusinessReportScheduleCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateBusinessReportScheduleCommand.ts @@ -20,6 +20,10 @@ import { export type CreateBusinessReportScheduleCommandInput = CreateBusinessReportScheduleRequest; export type CreateBusinessReportScheduleCommandOutput = CreateBusinessReportScheduleResponse & __MetadataBearer; +/** + *

Creates a recurring schedule for usage reports to deliver to the specified S3 + * location with a specified daily or weekly interval.

+ */ export class CreateBusinessReportScheduleCommand extends $Command< CreateBusinessReportScheduleCommandInput, CreateBusinessReportScheduleCommandOutput, @@ -34,6 +38,9 @@ export class CreateBusinessReportScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateConferenceProviderCommand.ts b/clients/client-alexa-for-business/commands/CreateConferenceProviderCommand.ts index 050d090c821ed..6371345cb751b 100644 --- a/clients/client-alexa-for-business/commands/CreateConferenceProviderCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateConferenceProviderCommand.ts @@ -20,6 +20,9 @@ import { export type CreateConferenceProviderCommandInput = CreateConferenceProviderRequest; export type CreateConferenceProviderCommandOutput = CreateConferenceProviderResponse & __MetadataBearer; +/** + *

Adds a new conference provider under the user's AWS account.

+ */ export class CreateConferenceProviderCommand extends $Command< CreateConferenceProviderCommandInput, CreateConferenceProviderCommandOutput, @@ -34,6 +37,9 @@ export class CreateConferenceProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateContactCommand.ts b/clients/client-alexa-for-business/commands/CreateContactCommand.ts index c71abb0a9646f..65dcd27401ac3 100644 --- a/clients/client-alexa-for-business/commands/CreateContactCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateContactCommand.ts @@ -20,6 +20,9 @@ import { export type CreateContactCommandInput = CreateContactRequest; export type CreateContactCommandOutput = CreateContactResponse & __MetadataBearer; +/** + *

Creates a contact with the specified details.

+ */ export class CreateContactCommand extends $Command< CreateContactCommandInput, CreateContactCommandOutput, @@ -34,6 +37,9 @@ export class CreateContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateGatewayGroupCommand.ts b/clients/client-alexa-for-business/commands/CreateGatewayGroupCommand.ts index 2b55b43e4fc9d..aae7d3c3e351d 100644 --- a/clients/client-alexa-for-business/commands/CreateGatewayGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateGatewayGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGatewayGroupCommandInput = CreateGatewayGroupRequest; export type CreateGatewayGroupCommandOutput = CreateGatewayGroupResponse & __MetadataBearer; +/** + *

Creates a gateway group with the specified details.

+ */ export class CreateGatewayGroupCommand extends $Command< CreateGatewayGroupCommandInput, CreateGatewayGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateGatewayGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateNetworkProfileCommand.ts b/clients/client-alexa-for-business/commands/CreateNetworkProfileCommand.ts index 300cc3822d70f..15beea52121d5 100644 --- a/clients/client-alexa-for-business/commands/CreateNetworkProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateNetworkProfileCommand.ts @@ -20,6 +20,9 @@ import { export type CreateNetworkProfileCommandInput = CreateNetworkProfileRequest; export type CreateNetworkProfileCommandOutput = CreateNetworkProfileResponse & __MetadataBearer; +/** + *

Creates a network profile with the specified details.

+ */ export class CreateNetworkProfileCommand extends $Command< CreateNetworkProfileCommandInput, CreateNetworkProfileCommandOutput, @@ -34,6 +37,9 @@ export class CreateNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateProfileCommand.ts b/clients/client-alexa-for-business/commands/CreateProfileCommand.ts index d7849b9d02be0..f8c2c730994a6 100644 --- a/clients/client-alexa-for-business/commands/CreateProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateProfileCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProfileCommandInput = CreateProfileRequest; export type CreateProfileCommandOutput = CreateProfileResponse & __MetadataBearer; +/** + *

Creates a new room profile with the specified details.

+ */ export class CreateProfileCommand extends $Command< CreateProfileCommandInput, CreateProfileCommandOutput, @@ -34,6 +37,9 @@ export class CreateProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateRoomCommand.ts b/clients/client-alexa-for-business/commands/CreateRoomCommand.ts index 4f666e28ecc8d..df847fcf7df3c 100644 --- a/clients/client-alexa-for-business/commands/CreateRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateRoomCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRoomCommandInput = CreateRoomRequest; export type CreateRoomCommandOutput = CreateRoomResponse & __MetadataBearer; +/** + *

Creates a room with the specified details.

+ */ export class CreateRoomCommand extends $Command< CreateRoomCommandInput, CreateRoomCommandOutput, @@ -34,6 +37,9 @@ export class CreateRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateSkillGroupCommand.ts b/clients/client-alexa-for-business/commands/CreateSkillGroupCommand.ts index 948e91bde5d13..0d59b2553eccf 100644 --- a/clients/client-alexa-for-business/commands/CreateSkillGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateSkillGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSkillGroupCommandInput = CreateSkillGroupRequest; export type CreateSkillGroupCommandOutput = CreateSkillGroupResponse & __MetadataBearer; +/** + *

Creates a skill group with a specified name and description.

+ */ export class CreateSkillGroupCommand extends $Command< CreateSkillGroupCommandInput, CreateSkillGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateSkillGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/CreateUserCommand.ts b/clients/client-alexa-for-business/commands/CreateUserCommand.ts index f2a8ebab7bdb5..1886421eeb6ad 100644 --- a/clients/client-alexa-for-business/commands/CreateUserCommand.ts +++ b/clients/client-alexa-for-business/commands/CreateUserCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResponse & __MetadataBearer; +/** + *

Creates a user.

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -34,6 +37,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteAddressBookCommand.ts b/clients/client-alexa-for-business/commands/DeleteAddressBookCommand.ts index c76fbbd5270f5..e92d7f224285b 100644 --- a/clients/client-alexa-for-business/commands/DeleteAddressBookCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteAddressBookCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAddressBookCommandInput = DeleteAddressBookRequest; export type DeleteAddressBookCommandOutput = DeleteAddressBookResponse & __MetadataBearer; +/** + *

Deletes an address book by the address book ARN.

+ */ export class DeleteAddressBookCommand extends $Command< DeleteAddressBookCommandInput, DeleteAddressBookCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAddressBookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteBusinessReportScheduleCommand.ts b/clients/client-alexa-for-business/commands/DeleteBusinessReportScheduleCommand.ts index 9a38b823cdc38..87501c025c3e4 100644 --- a/clients/client-alexa-for-business/commands/DeleteBusinessReportScheduleCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteBusinessReportScheduleCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteBusinessReportScheduleCommandInput = DeleteBusinessReportScheduleRequest; export type DeleteBusinessReportScheduleCommandOutput = DeleteBusinessReportScheduleResponse & __MetadataBearer; +/** + *

Deletes the recurring report delivery schedule with the specified schedule + * ARN.

+ */ export class DeleteBusinessReportScheduleCommand extends $Command< DeleteBusinessReportScheduleCommandInput, DeleteBusinessReportScheduleCommandOutput, @@ -34,6 +38,9 @@ export class DeleteBusinessReportScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteConferenceProviderCommand.ts b/clients/client-alexa-for-business/commands/DeleteConferenceProviderCommand.ts index 66afaed750808..745deb027a4c1 100644 --- a/clients/client-alexa-for-business/commands/DeleteConferenceProviderCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteConferenceProviderCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteConferenceProviderCommandInput = DeleteConferenceProviderRequest; export type DeleteConferenceProviderCommandOutput = DeleteConferenceProviderResponse & __MetadataBearer; +/** + *

Deletes a conference provider.

+ */ export class DeleteConferenceProviderCommand extends $Command< DeleteConferenceProviderCommandInput, DeleteConferenceProviderCommandOutput, @@ -34,6 +37,9 @@ export class DeleteConferenceProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteContactCommand.ts b/clients/client-alexa-for-business/commands/DeleteContactCommand.ts index 8a837bf55725e..85a9ab3517361 100644 --- a/clients/client-alexa-for-business/commands/DeleteContactCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteContactCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteContactCommandInput = DeleteContactRequest; export type DeleteContactCommandOutput = DeleteContactResponse & __MetadataBearer; +/** + *

Deletes a contact by the contact ARN.

+ */ export class DeleteContactCommand extends $Command< DeleteContactCommandInput, DeleteContactCommandOutput, @@ -34,6 +37,9 @@ export class DeleteContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteDeviceCommand.ts b/clients/client-alexa-for-business/commands/DeleteDeviceCommand.ts index 13bc00517427f..e05c36b727bee 100644 --- a/clients/client-alexa-for-business/commands/DeleteDeviceCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteDeviceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDeviceCommandInput = DeleteDeviceRequest; export type DeleteDeviceCommandOutput = DeleteDeviceResponse & __MetadataBearer; +/** + *

Removes a device from Alexa For Business.

+ */ export class DeleteDeviceCommand extends $Command< DeleteDeviceCommandInput, DeleteDeviceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteDeviceUsageDataCommand.ts b/clients/client-alexa-for-business/commands/DeleteDeviceUsageDataCommand.ts index c2b1ce3b20bcd..15cf7eaf1e1ad 100644 --- a/clients/client-alexa-for-business/commands/DeleteDeviceUsageDataCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteDeviceUsageDataCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDeviceUsageDataCommandInput = DeleteDeviceUsageDataRequest; export type DeleteDeviceUsageDataCommandOutput = DeleteDeviceUsageDataResponse & __MetadataBearer; +/** + *

When this action is called for a specified shared device, it allows authorized users to + * delete the device's entire previous history of voice input data and associated response + * data. This action can be called once every 24 hours for a specific shared device.

+ */ export class DeleteDeviceUsageDataCommand extends $Command< DeleteDeviceUsageDataCommandInput, DeleteDeviceUsageDataCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDeviceUsageDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteGatewayGroupCommand.ts b/clients/client-alexa-for-business/commands/DeleteGatewayGroupCommand.ts index af3656cd889bc..3a07ab52d72f8 100644 --- a/clients/client-alexa-for-business/commands/DeleteGatewayGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteGatewayGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGatewayGroupCommandInput = DeleteGatewayGroupRequest; export type DeleteGatewayGroupCommandOutput = DeleteGatewayGroupResponse & __MetadataBearer; +/** + *

Deletes a gateway group.

+ */ export class DeleteGatewayGroupCommand extends $Command< DeleteGatewayGroupCommandInput, DeleteGatewayGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGatewayGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteNetworkProfileCommand.ts b/clients/client-alexa-for-business/commands/DeleteNetworkProfileCommand.ts index 047e9ed81ff5a..9b52b897ffc8b 100644 --- a/clients/client-alexa-for-business/commands/DeleteNetworkProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteNetworkProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNetworkProfileCommandInput = DeleteNetworkProfileRequest; export type DeleteNetworkProfileCommandOutput = DeleteNetworkProfileResponse & __MetadataBearer; +/** + *

Deletes a network profile by the network profile ARN.

+ */ export class DeleteNetworkProfileCommand extends $Command< DeleteNetworkProfileCommandInput, DeleteNetworkProfileCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteProfileCommand.ts b/clients/client-alexa-for-business/commands/DeleteProfileCommand.ts index 2755859cc9400..5b2c47184bf57 100644 --- a/clients/client-alexa-for-business/commands/DeleteProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProfileCommandInput = DeleteProfileRequest; export type DeleteProfileCommandOutput = DeleteProfileResponse & __MetadataBearer; +/** + *

Deletes a room profile by the profile ARN.

+ */ export class DeleteProfileCommand extends $Command< DeleteProfileCommandInput, DeleteProfileCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteRoomCommand.ts b/clients/client-alexa-for-business/commands/DeleteRoomCommand.ts index aa92ba02578f8..675876cd2700b 100644 --- a/clients/client-alexa-for-business/commands/DeleteRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteRoomCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRoomCommandInput = DeleteRoomRequest; export type DeleteRoomCommandOutput = DeleteRoomResponse & __MetadataBearer; +/** + *

Deletes a room by the room ARN.

+ */ export class DeleteRoomCommand extends $Command< DeleteRoomCommandInput, DeleteRoomCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteRoomSkillParameterCommand.ts b/clients/client-alexa-for-business/commands/DeleteRoomSkillParameterCommand.ts index 5a091d5b7d154..400756529e4ee 100644 --- a/clients/client-alexa-for-business/commands/DeleteRoomSkillParameterCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteRoomSkillParameterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRoomSkillParameterCommandInput = DeleteRoomSkillParameterRequest; export type DeleteRoomSkillParameterCommandOutput = DeleteRoomSkillParameterResponse & __MetadataBearer; +/** + *

Deletes room skill parameter details by room, skill, and parameter key ID.

+ */ export class DeleteRoomSkillParameterCommand extends $Command< DeleteRoomSkillParameterCommandInput, DeleteRoomSkillParameterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRoomSkillParameterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteSkillAuthorizationCommand.ts b/clients/client-alexa-for-business/commands/DeleteSkillAuthorizationCommand.ts index e770b3e85f68b..5ee930f1ca0ee 100644 --- a/clients/client-alexa-for-business/commands/DeleteSkillAuthorizationCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteSkillAuthorizationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSkillAuthorizationCommandInput = DeleteSkillAuthorizationRequest; export type DeleteSkillAuthorizationCommandOutput = DeleteSkillAuthorizationResponse & __MetadataBearer; +/** + *

Unlinks a third-party account from a skill.

+ */ export class DeleteSkillAuthorizationCommand extends $Command< DeleteSkillAuthorizationCommandInput, DeleteSkillAuthorizationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSkillAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteSkillGroupCommand.ts b/clients/client-alexa-for-business/commands/DeleteSkillGroupCommand.ts index add5170bb7cfe..f80b3fd05e11a 100644 --- a/clients/client-alexa-for-business/commands/DeleteSkillGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteSkillGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSkillGroupCommandInput = DeleteSkillGroupRequest; export type DeleteSkillGroupCommandOutput = DeleteSkillGroupResponse & __MetadataBearer; +/** + *

Deletes a skill group by skill group ARN.

+ */ export class DeleteSkillGroupCommand extends $Command< DeleteSkillGroupCommandInput, DeleteSkillGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSkillGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DeleteUserCommand.ts b/clients/client-alexa-for-business/commands/DeleteUserCommand.ts index 943d1056dd696..3b74ab50bac23 100644 --- a/clients/client-alexa-for-business/commands/DeleteUserCommand.ts +++ b/clients/client-alexa-for-business/commands/DeleteUserCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = DeleteUserResponse & __MetadataBearer; +/** + *

Deletes a specified user by user ARN and enrollment ARN.

+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DisassociateContactFromAddressBookCommand.ts b/clients/client-alexa-for-business/commands/DisassociateContactFromAddressBookCommand.ts index 89cea97559314..83f24b85d6bb6 100644 --- a/clients/client-alexa-for-business/commands/DisassociateContactFromAddressBookCommand.ts +++ b/clients/client-alexa-for-business/commands/DisassociateContactFromAddressBookCommand.ts @@ -24,6 +24,9 @@ export type DisassociateContactFromAddressBookCommandInput = DisassociateContact export type DisassociateContactFromAddressBookCommandOutput = DisassociateContactFromAddressBookResponse & __MetadataBearer; +/** + *

Disassociates a contact from a given address book.

+ */ export class DisassociateContactFromAddressBookCommand extends $Command< DisassociateContactFromAddressBookCommandInput, DisassociateContactFromAddressBookCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateContactFromAddressBookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DisassociateDeviceFromRoomCommand.ts b/clients/client-alexa-for-business/commands/DisassociateDeviceFromRoomCommand.ts index bd1b78e32bde0..ed70756089a6b 100644 --- a/clients/client-alexa-for-business/commands/DisassociateDeviceFromRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/DisassociateDeviceFromRoomCommand.ts @@ -20,6 +20,11 @@ import { export type DisassociateDeviceFromRoomCommandInput = DisassociateDeviceFromRoomRequest; export type DisassociateDeviceFromRoomCommandOutput = DisassociateDeviceFromRoomResponse & __MetadataBearer; +/** + *

Disassociates a device from its current room. The device continues to be connected to + * the Wi-Fi network and is still registered to the account. The device settings and skills + * are removed from the room.

+ */ export class DisassociateDeviceFromRoomCommand extends $Command< DisassociateDeviceFromRoomCommandInput, DisassociateDeviceFromRoomCommandOutput, @@ -34,6 +39,9 @@ export class DisassociateDeviceFromRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DisassociateSkillFromSkillGroupCommand.ts b/clients/client-alexa-for-business/commands/DisassociateSkillFromSkillGroupCommand.ts index 8e4ec08687ef8..6b7ee05585451 100644 --- a/clients/client-alexa-for-business/commands/DisassociateSkillFromSkillGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/DisassociateSkillFromSkillGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateSkillFromSkillGroupCommandInput = DisassociateSkillFromSkillGroupRequest; export type DisassociateSkillFromSkillGroupCommandOutput = DisassociateSkillFromSkillGroupResponse & __MetadataBearer; +/** + *

Disassociates a skill from a skill group.

+ */ export class DisassociateSkillFromSkillGroupCommand extends $Command< DisassociateSkillFromSkillGroupCommandInput, DisassociateSkillFromSkillGroupCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateSkillFromSkillGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DisassociateSkillFromUsersCommand.ts b/clients/client-alexa-for-business/commands/DisassociateSkillFromUsersCommand.ts index 09c5e1b9b4cd7..998552190eee7 100644 --- a/clients/client-alexa-for-business/commands/DisassociateSkillFromUsersCommand.ts +++ b/clients/client-alexa-for-business/commands/DisassociateSkillFromUsersCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateSkillFromUsersCommandInput = DisassociateSkillFromUsersRequest; export type DisassociateSkillFromUsersCommandOutput = DisassociateSkillFromUsersResponse & __MetadataBearer; +/** + *

Makes a private skill unavailable for enrolled users and prevents them from enabling it + * on their devices.

+ */ export class DisassociateSkillFromUsersCommand extends $Command< DisassociateSkillFromUsersCommandInput, DisassociateSkillFromUsersCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateSkillFromUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/DisassociateSkillGroupFromRoomCommand.ts b/clients/client-alexa-for-business/commands/DisassociateSkillGroupFromRoomCommand.ts index 05c9d4dc0c600..9273ce2cdbe36 100644 --- a/clients/client-alexa-for-business/commands/DisassociateSkillGroupFromRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/DisassociateSkillGroupFromRoomCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateSkillGroupFromRoomCommandInput = DisassociateSkillGroupFromRoomRequest; export type DisassociateSkillGroupFromRoomCommandOutput = DisassociateSkillGroupFromRoomResponse & __MetadataBearer; +/** + *

Disassociates a skill group from a specified room. This disables all skills in the + * skill group on all devices in the room.

+ */ export class DisassociateSkillGroupFromRoomCommand extends $Command< DisassociateSkillGroupFromRoomCommandInput, DisassociateSkillGroupFromRoomCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateSkillGroupFromRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ForgetSmartHomeAppliancesCommand.ts b/clients/client-alexa-for-business/commands/ForgetSmartHomeAppliancesCommand.ts index b21eb6b0fe332..0423399323fa3 100644 --- a/clients/client-alexa-for-business/commands/ForgetSmartHomeAppliancesCommand.ts +++ b/clients/client-alexa-for-business/commands/ForgetSmartHomeAppliancesCommand.ts @@ -20,6 +20,9 @@ import { export type ForgetSmartHomeAppliancesCommandInput = ForgetSmartHomeAppliancesRequest; export type ForgetSmartHomeAppliancesCommandOutput = ForgetSmartHomeAppliancesResponse & __MetadataBearer; +/** + *

Forgets smart home appliances associated to a room.

+ */ export class ForgetSmartHomeAppliancesCommand extends $Command< ForgetSmartHomeAppliancesCommandInput, ForgetSmartHomeAppliancesCommandOutput, @@ -34,6 +37,9 @@ export class ForgetSmartHomeAppliancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetAddressBookCommand.ts b/clients/client-alexa-for-business/commands/GetAddressBookCommand.ts index e333cdab44052..cafcccdd47a01 100644 --- a/clients/client-alexa-for-business/commands/GetAddressBookCommand.ts +++ b/clients/client-alexa-for-business/commands/GetAddressBookCommand.ts @@ -20,6 +20,9 @@ import { export type GetAddressBookCommandInput = GetAddressBookRequest; export type GetAddressBookCommandOutput = GetAddressBookResponse & __MetadataBearer; +/** + *

Gets address the book details by the address book ARN.

+ */ export class GetAddressBookCommand extends $Command< GetAddressBookCommandInput, GetAddressBookCommandOutput, @@ -34,6 +37,9 @@ export class GetAddressBookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetConferencePreferenceCommand.ts b/clients/client-alexa-for-business/commands/GetConferencePreferenceCommand.ts index a3a4e041bc732..a47f71096c5f6 100644 --- a/clients/client-alexa-for-business/commands/GetConferencePreferenceCommand.ts +++ b/clients/client-alexa-for-business/commands/GetConferencePreferenceCommand.ts @@ -20,6 +20,9 @@ import { export type GetConferencePreferenceCommandInput = GetConferencePreferenceRequest; export type GetConferencePreferenceCommandOutput = GetConferencePreferenceResponse & __MetadataBearer; +/** + *

Retrieves the existing conference preferences.

+ */ export class GetConferencePreferenceCommand extends $Command< GetConferencePreferenceCommandInput, GetConferencePreferenceCommandOutput, @@ -34,6 +37,9 @@ export class GetConferencePreferenceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetConferenceProviderCommand.ts b/clients/client-alexa-for-business/commands/GetConferenceProviderCommand.ts index 4481daa728257..a0961b1e04a97 100644 --- a/clients/client-alexa-for-business/commands/GetConferenceProviderCommand.ts +++ b/clients/client-alexa-for-business/commands/GetConferenceProviderCommand.ts @@ -20,6 +20,9 @@ import { export type GetConferenceProviderCommandInput = GetConferenceProviderRequest; export type GetConferenceProviderCommandOutput = GetConferenceProviderResponse & __MetadataBearer; +/** + *

Gets details about a specific conference provider.

+ */ export class GetConferenceProviderCommand extends $Command< GetConferenceProviderCommandInput, GetConferenceProviderCommandOutput, @@ -34,6 +37,9 @@ export class GetConferenceProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetContactCommand.ts b/clients/client-alexa-for-business/commands/GetContactCommand.ts index 72f386811676d..47373ecfab170 100644 --- a/clients/client-alexa-for-business/commands/GetContactCommand.ts +++ b/clients/client-alexa-for-business/commands/GetContactCommand.ts @@ -20,6 +20,9 @@ import { export type GetContactCommandInput = GetContactRequest; export type GetContactCommandOutput = GetContactResponse & __MetadataBearer; +/** + *

Gets the contact details by the contact ARN.

+ */ export class GetContactCommand extends $Command< GetContactCommandInput, GetContactCommandOutput, @@ -34,6 +37,9 @@ export class GetContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetDeviceCommand.ts b/clients/client-alexa-for-business/commands/GetDeviceCommand.ts index 5a442ab8ae3dc..8cc14350bb584 100644 --- a/clients/client-alexa-for-business/commands/GetDeviceCommand.ts +++ b/clients/client-alexa-for-business/commands/GetDeviceCommand.ts @@ -17,6 +17,9 @@ import { export type GetDeviceCommandInput = GetDeviceRequest; export type GetDeviceCommandOutput = GetDeviceResponse & __MetadataBearer; +/** + *

Gets the details of a device by device ARN.

+ */ export class GetDeviceCommand extends $Command< GetDeviceCommandInput, GetDeviceCommandOutput, @@ -31,6 +34,9 @@ export class GetDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetGatewayCommand.ts b/clients/client-alexa-for-business/commands/GetGatewayCommand.ts index 5088dad878bf7..698712577f3ed 100644 --- a/clients/client-alexa-for-business/commands/GetGatewayCommand.ts +++ b/clients/client-alexa-for-business/commands/GetGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type GetGatewayCommandInput = GetGatewayRequest; export type GetGatewayCommandOutput = GetGatewayResponse & __MetadataBearer; +/** + *

Retrieves the details of a gateway.

+ */ export class GetGatewayCommand extends $Command< GetGatewayCommandInput, GetGatewayCommandOutput, @@ -34,6 +37,9 @@ export class GetGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetGatewayGroupCommand.ts b/clients/client-alexa-for-business/commands/GetGatewayGroupCommand.ts index 6973f36751c18..80f980f5125f9 100644 --- a/clients/client-alexa-for-business/commands/GetGatewayGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/GetGatewayGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetGatewayGroupCommandInput = GetGatewayGroupRequest; export type GetGatewayGroupCommandOutput = GetGatewayGroupResponse & __MetadataBearer; +/** + *

Retrieves the details of a gateway group.

+ */ export class GetGatewayGroupCommand extends $Command< GetGatewayGroupCommandInput, GetGatewayGroupCommandOutput, @@ -34,6 +37,9 @@ export class GetGatewayGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetInvitationConfigurationCommand.ts b/clients/client-alexa-for-business/commands/GetInvitationConfigurationCommand.ts index b1f31c1111457..d7b68e8b2de8a 100644 --- a/clients/client-alexa-for-business/commands/GetInvitationConfigurationCommand.ts +++ b/clients/client-alexa-for-business/commands/GetInvitationConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type GetInvitationConfigurationCommandInput = GetInvitationConfigurationRequest; export type GetInvitationConfigurationCommandOutput = GetInvitationConfigurationResponse & __MetadataBearer; +/** + *

Retrieves the configured values for the user enrollment invitation email + * template.

+ */ export class GetInvitationConfigurationCommand extends $Command< GetInvitationConfigurationCommandInput, GetInvitationConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class GetInvitationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetNetworkProfileCommand.ts b/clients/client-alexa-for-business/commands/GetNetworkProfileCommand.ts index 38ec6d8862b27..37cf276c6cd04 100644 --- a/clients/client-alexa-for-business/commands/GetNetworkProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/GetNetworkProfileCommand.ts @@ -20,6 +20,9 @@ import { export type GetNetworkProfileCommandInput = GetNetworkProfileRequest; export type GetNetworkProfileCommandOutput = GetNetworkProfileResponse & __MetadataBearer; +/** + *

Gets the network profile details by the network profile ARN.

+ */ export class GetNetworkProfileCommand extends $Command< GetNetworkProfileCommandInput, GetNetworkProfileCommandOutput, @@ -34,6 +37,9 @@ export class GetNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetProfileCommand.ts b/clients/client-alexa-for-business/commands/GetProfileCommand.ts index c95a052f690bd..aee8cee39b895 100644 --- a/clients/client-alexa-for-business/commands/GetProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/GetProfileCommand.ts @@ -20,6 +20,9 @@ import { export type GetProfileCommandInput = GetProfileRequest; export type GetProfileCommandOutput = GetProfileResponse & __MetadataBearer; +/** + *

Gets the details of a room profile by profile ARN.

+ */ export class GetProfileCommand extends $Command< GetProfileCommandInput, GetProfileCommandOutput, @@ -34,6 +37,9 @@ export class GetProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetRoomCommand.ts b/clients/client-alexa-for-business/commands/GetRoomCommand.ts index 2410ea0e0859c..062870f4ec4c6 100644 --- a/clients/client-alexa-for-business/commands/GetRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/GetRoomCommand.ts @@ -17,6 +17,9 @@ import { export type GetRoomCommandInput = GetRoomRequest; export type GetRoomCommandOutput = GetRoomResponse & __MetadataBearer; +/** + *

Gets room details by room ARN.

+ */ export class GetRoomCommand extends $Command< GetRoomCommandInput, GetRoomCommandOutput, @@ -31,6 +34,9 @@ export class GetRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetRoomSkillParameterCommand.ts b/clients/client-alexa-for-business/commands/GetRoomSkillParameterCommand.ts index 6c4a17451ac30..f1fad80c501eb 100644 --- a/clients/client-alexa-for-business/commands/GetRoomSkillParameterCommand.ts +++ b/clients/client-alexa-for-business/commands/GetRoomSkillParameterCommand.ts @@ -20,6 +20,9 @@ import { export type GetRoomSkillParameterCommandInput = GetRoomSkillParameterRequest; export type GetRoomSkillParameterCommandOutput = GetRoomSkillParameterResponse & __MetadataBearer; +/** + *

Gets room skill parameter details by room, skill, and parameter key ARN.

+ */ export class GetRoomSkillParameterCommand extends $Command< GetRoomSkillParameterCommandInput, GetRoomSkillParameterCommandOutput, @@ -34,6 +37,9 @@ export class GetRoomSkillParameterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/GetSkillGroupCommand.ts b/clients/client-alexa-for-business/commands/GetSkillGroupCommand.ts index 1f06d947f79c5..79f043495a091 100644 --- a/clients/client-alexa-for-business/commands/GetSkillGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/GetSkillGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetSkillGroupCommandInput = GetSkillGroupRequest; export type GetSkillGroupCommandOutput = GetSkillGroupResponse & __MetadataBearer; +/** + *

Gets skill group details by skill group ARN.

+ */ export class GetSkillGroupCommand extends $Command< GetSkillGroupCommandInput, GetSkillGroupCommandOutput, @@ -34,6 +37,9 @@ export class GetSkillGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListBusinessReportSchedulesCommand.ts b/clients/client-alexa-for-business/commands/ListBusinessReportSchedulesCommand.ts index bd1800641f955..6690c8f47c461 100644 --- a/clients/client-alexa-for-business/commands/ListBusinessReportSchedulesCommand.ts +++ b/clients/client-alexa-for-business/commands/ListBusinessReportSchedulesCommand.ts @@ -20,6 +20,9 @@ import { export type ListBusinessReportSchedulesCommandInput = ListBusinessReportSchedulesRequest; export type ListBusinessReportSchedulesCommandOutput = ListBusinessReportSchedulesResponse & __MetadataBearer; +/** + *

Lists the details of the schedules that a user configured. A download URL of the report associated with each schedule is returned every time this action is called. A new download URL is returned each time, and is valid for 24 hours.

+ */ export class ListBusinessReportSchedulesCommand extends $Command< ListBusinessReportSchedulesCommandInput, ListBusinessReportSchedulesCommandOutput, @@ -34,6 +37,9 @@ export class ListBusinessReportSchedulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListConferenceProvidersCommand.ts b/clients/client-alexa-for-business/commands/ListConferenceProvidersCommand.ts index 8b7d7f721ae45..9c0c6055c1066 100644 --- a/clients/client-alexa-for-business/commands/ListConferenceProvidersCommand.ts +++ b/clients/client-alexa-for-business/commands/ListConferenceProvidersCommand.ts @@ -20,6 +20,9 @@ import { export type ListConferenceProvidersCommandInput = ListConferenceProvidersRequest; export type ListConferenceProvidersCommandOutput = ListConferenceProvidersResponse & __MetadataBearer; +/** + *

Lists conference providers under a specific AWS account.

+ */ export class ListConferenceProvidersCommand extends $Command< ListConferenceProvidersCommandInput, ListConferenceProvidersCommandOutput, @@ -34,6 +37,9 @@ export class ListConferenceProvidersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListDeviceEventsCommand.ts b/clients/client-alexa-for-business/commands/ListDeviceEventsCommand.ts index 0108797bb0ddf..d9d91aa7f75e2 100644 --- a/clients/client-alexa-for-business/commands/ListDeviceEventsCommand.ts +++ b/clients/client-alexa-for-business/commands/ListDeviceEventsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDeviceEventsCommandInput = ListDeviceEventsRequest; export type ListDeviceEventsCommandOutput = ListDeviceEventsResponse & __MetadataBearer; +/** + *

Lists the device event history, including device connection status, for up to 30 + * days.

+ */ export class ListDeviceEventsCommand extends $Command< ListDeviceEventsCommandInput, ListDeviceEventsCommandOutput, @@ -34,6 +38,9 @@ export class ListDeviceEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListGatewayGroupsCommand.ts b/clients/client-alexa-for-business/commands/ListGatewayGroupsCommand.ts index 013b5c570a3a6..394c1cdd5778d 100644 --- a/clients/client-alexa-for-business/commands/ListGatewayGroupsCommand.ts +++ b/clients/client-alexa-for-business/commands/ListGatewayGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type ListGatewayGroupsCommandInput = ListGatewayGroupsRequest; export type ListGatewayGroupsCommandOutput = ListGatewayGroupsResponse & __MetadataBearer; +/** + *

Retrieves a list of gateway group summaries. Use GetGatewayGroup to retrieve details of + * a specific gateway group.

+ */ export class ListGatewayGroupsCommand extends $Command< ListGatewayGroupsCommandInput, ListGatewayGroupsCommandOutput, @@ -34,6 +38,9 @@ export class ListGatewayGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListGatewaysCommand.ts b/clients/client-alexa-for-business/commands/ListGatewaysCommand.ts index 66eecd8a6cae5..5da51dd6ca102 100644 --- a/clients/client-alexa-for-business/commands/ListGatewaysCommand.ts +++ b/clients/client-alexa-for-business/commands/ListGatewaysCommand.ts @@ -20,6 +20,11 @@ import { export type ListGatewaysCommandInput = ListGatewaysRequest; export type ListGatewaysCommandOutput = ListGatewaysResponse & __MetadataBearer; +/** + *

Retrieves a list of gateway summaries. Use GetGateway to retrieve details of a specific + * gateway. An optional gateway group ARN can be provided to only retrieve gateway summaries + * of gateways that are associated with that gateway group ARN.

+ */ export class ListGatewaysCommand extends $Command< ListGatewaysCommandInput, ListGatewaysCommandOutput, @@ -34,6 +39,9 @@ export class ListGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListSkillsCommand.ts b/clients/client-alexa-for-business/commands/ListSkillsCommand.ts index 88af7bff7ad5a..9f288d5de72dd 100644 --- a/clients/client-alexa-for-business/commands/ListSkillsCommand.ts +++ b/clients/client-alexa-for-business/commands/ListSkillsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSkillsCommandInput = ListSkillsRequest; export type ListSkillsCommandOutput = ListSkillsResponse & __MetadataBearer; +/** + *

Lists all enabled skills in a specific skill group.

+ */ export class ListSkillsCommand extends $Command< ListSkillsCommandInput, ListSkillsCommandOutput, @@ -34,6 +37,9 @@ export class ListSkillsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListSkillsStoreCategoriesCommand.ts b/clients/client-alexa-for-business/commands/ListSkillsStoreCategoriesCommand.ts index 1cd96411d1e83..82b1f7395e1aa 100644 --- a/clients/client-alexa-for-business/commands/ListSkillsStoreCategoriesCommand.ts +++ b/clients/client-alexa-for-business/commands/ListSkillsStoreCategoriesCommand.ts @@ -20,6 +20,9 @@ import { export type ListSkillsStoreCategoriesCommandInput = ListSkillsStoreCategoriesRequest; export type ListSkillsStoreCategoriesCommandOutput = ListSkillsStoreCategoriesResponse & __MetadataBearer; +/** + *

Lists all categories in the Alexa skill store.

+ */ export class ListSkillsStoreCategoriesCommand extends $Command< ListSkillsStoreCategoriesCommandInput, ListSkillsStoreCategoriesCommandOutput, @@ -34,6 +37,9 @@ export class ListSkillsStoreCategoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListSkillsStoreSkillsByCategoryCommand.ts b/clients/client-alexa-for-business/commands/ListSkillsStoreSkillsByCategoryCommand.ts index 1614878ebc0a7..8d464f59493e4 100644 --- a/clients/client-alexa-for-business/commands/ListSkillsStoreSkillsByCategoryCommand.ts +++ b/clients/client-alexa-for-business/commands/ListSkillsStoreSkillsByCategoryCommand.ts @@ -20,6 +20,9 @@ import { export type ListSkillsStoreSkillsByCategoryCommandInput = ListSkillsStoreSkillsByCategoryRequest; export type ListSkillsStoreSkillsByCategoryCommandOutput = ListSkillsStoreSkillsByCategoryResponse & __MetadataBearer; +/** + *

Lists all skills in the Alexa skill store by category.

+ */ export class ListSkillsStoreSkillsByCategoryCommand extends $Command< ListSkillsStoreSkillsByCategoryCommandInput, ListSkillsStoreSkillsByCategoryCommandOutput, @@ -34,6 +37,9 @@ export class ListSkillsStoreSkillsByCategoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListSmartHomeAppliancesCommand.ts b/clients/client-alexa-for-business/commands/ListSmartHomeAppliancesCommand.ts index fae038bf3005b..72f5e1279fe71 100644 --- a/clients/client-alexa-for-business/commands/ListSmartHomeAppliancesCommand.ts +++ b/clients/client-alexa-for-business/commands/ListSmartHomeAppliancesCommand.ts @@ -20,6 +20,9 @@ import { export type ListSmartHomeAppliancesCommandInput = ListSmartHomeAppliancesRequest; export type ListSmartHomeAppliancesCommandOutput = ListSmartHomeAppliancesResponse & __MetadataBearer; +/** + *

Lists all of the smart home appliances associated with a room.

+ */ export class ListSmartHomeAppliancesCommand extends $Command< ListSmartHomeAppliancesCommandInput, ListSmartHomeAppliancesCommandOutput, @@ -34,6 +37,9 @@ export class ListSmartHomeAppliancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ListTagsCommand.ts b/clients/client-alexa-for-business/commands/ListTagsCommand.ts index 1c40dad3e1e10..fbdedec916fef 100644 --- a/clients/client-alexa-for-business/commands/ListTagsCommand.ts +++ b/clients/client-alexa-for-business/commands/ListTagsCommand.ts @@ -17,6 +17,9 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResponse & __MetadataBearer; +/** + *

Lists all tags for the specified resource.

+ */ export class ListTagsCommand extends $Command< ListTagsCommandInput, ListTagsCommandOutput, @@ -31,6 +34,9 @@ export class ListTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/PutConferencePreferenceCommand.ts b/clients/client-alexa-for-business/commands/PutConferencePreferenceCommand.ts index 9eb7c76712493..0ec6e1ba431b9 100644 --- a/clients/client-alexa-for-business/commands/PutConferencePreferenceCommand.ts +++ b/clients/client-alexa-for-business/commands/PutConferencePreferenceCommand.ts @@ -20,6 +20,10 @@ import { export type PutConferencePreferenceCommandInput = PutConferencePreferenceRequest; export type PutConferencePreferenceCommandOutput = PutConferencePreferenceResponse & __MetadataBearer; +/** + *

Sets the conference preferences on a specific conference provider at the account + * level.

+ */ export class PutConferencePreferenceCommand extends $Command< PutConferencePreferenceCommandInput, PutConferencePreferenceCommandOutput, @@ -34,6 +38,9 @@ export class PutConferencePreferenceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/PutInvitationConfigurationCommand.ts b/clients/client-alexa-for-business/commands/PutInvitationConfigurationCommand.ts index 518583b0023d1..b766de45b4ef3 100644 --- a/clients/client-alexa-for-business/commands/PutInvitationConfigurationCommand.ts +++ b/clients/client-alexa-for-business/commands/PutInvitationConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type PutInvitationConfigurationCommandInput = PutInvitationConfigurationRequest; export type PutInvitationConfigurationCommandOutput = PutInvitationConfigurationResponse & __MetadataBearer; +/** + *

Configures the email template for the user enrollment invitation with the specified + * attributes.

+ */ export class PutInvitationConfigurationCommand extends $Command< PutInvitationConfigurationCommandInput, PutInvitationConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class PutInvitationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/PutRoomSkillParameterCommand.ts b/clients/client-alexa-for-business/commands/PutRoomSkillParameterCommand.ts index 9e0e0ad08bbb2..57486cfe3b791 100644 --- a/clients/client-alexa-for-business/commands/PutRoomSkillParameterCommand.ts +++ b/clients/client-alexa-for-business/commands/PutRoomSkillParameterCommand.ts @@ -20,6 +20,10 @@ import { export type PutRoomSkillParameterCommandInput = PutRoomSkillParameterRequest; export type PutRoomSkillParameterCommandOutput = PutRoomSkillParameterResponse & __MetadataBearer; +/** + *

Updates room skill parameter details by room, skill, and parameter key ID. Not all + * skills have a room skill parameter.

+ */ export class PutRoomSkillParameterCommand extends $Command< PutRoomSkillParameterCommandInput, PutRoomSkillParameterCommandOutput, @@ -34,6 +38,9 @@ export class PutRoomSkillParameterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/PutSkillAuthorizationCommand.ts b/clients/client-alexa-for-business/commands/PutSkillAuthorizationCommand.ts index a0ee97d7d7efd..52bd5a672564a 100644 --- a/clients/client-alexa-for-business/commands/PutSkillAuthorizationCommand.ts +++ b/clients/client-alexa-for-business/commands/PutSkillAuthorizationCommand.ts @@ -20,6 +20,11 @@ import { export type PutSkillAuthorizationCommandInput = PutSkillAuthorizationRequest; export type PutSkillAuthorizationCommandOutput = PutSkillAuthorizationResponse & __MetadataBearer; +/** + *

Links a user's account to a third-party skill provider. If this API operation is + * called by an assumed IAM role, the skill being linked must be a private skill. Also, the + * skill must be owned by the AWS account that assumed the IAM role.

+ */ export class PutSkillAuthorizationCommand extends $Command< PutSkillAuthorizationCommandInput, PutSkillAuthorizationCommandOutput, @@ -34,6 +39,9 @@ export class PutSkillAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/RegisterAVSDeviceCommand.ts b/clients/client-alexa-for-business/commands/RegisterAVSDeviceCommand.ts index 32f80cd8c79bd..9489dfb232804 100644 --- a/clients/client-alexa-for-business/commands/RegisterAVSDeviceCommand.ts +++ b/clients/client-alexa-for-business/commands/RegisterAVSDeviceCommand.ts @@ -20,6 +20,10 @@ import { export type RegisterAVSDeviceCommandInput = RegisterAVSDeviceRequest; export type RegisterAVSDeviceCommandOutput = RegisterAVSDeviceResponse & __MetadataBearer; +/** + *

Registers an Alexa-enabled device built by an Original Equipment Manufacturer (OEM) + * using Alexa Voice Service (AVS).

+ */ export class RegisterAVSDeviceCommand extends $Command< RegisterAVSDeviceCommandInput, RegisterAVSDeviceCommandOutput, @@ -34,6 +38,9 @@ export class RegisterAVSDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/RejectSkillCommand.ts b/clients/client-alexa-for-business/commands/RejectSkillCommand.ts index 5b6686a24f2f1..1540c989045a2 100644 --- a/clients/client-alexa-for-business/commands/RejectSkillCommand.ts +++ b/clients/client-alexa-for-business/commands/RejectSkillCommand.ts @@ -20,6 +20,11 @@ import { export type RejectSkillCommandInput = RejectSkillRequest; export type RejectSkillCommandOutput = RejectSkillResponse & __MetadataBearer; +/** + *

Disassociates a skill from the organization under a user's AWS account. If the skill + * is a private skill, it moves to an AcceptStatus of PENDING. Any private or public skill + * that is rejected can be added later by calling the ApproveSkill API.

+ */ export class RejectSkillCommand extends $Command< RejectSkillCommandInput, RejectSkillCommandOutput, @@ -34,6 +39,9 @@ export class RejectSkillCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/ResolveRoomCommand.ts b/clients/client-alexa-for-business/commands/ResolveRoomCommand.ts index 7cf107301b5ed..873a191eb29be 100644 --- a/clients/client-alexa-for-business/commands/ResolveRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/ResolveRoomCommand.ts @@ -20,6 +20,10 @@ import { export type ResolveRoomCommandInput = ResolveRoomRequest; export type ResolveRoomCommandOutput = ResolveRoomResponse & __MetadataBearer; +/** + *

Determines the details for the room from which a skill request was invoked. This + * operation is used by skill developers.

+ */ export class ResolveRoomCommand extends $Command< ResolveRoomCommandInput, ResolveRoomCommandOutput, @@ -34,6 +38,9 @@ export class ResolveRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/RevokeInvitationCommand.ts b/clients/client-alexa-for-business/commands/RevokeInvitationCommand.ts index ed045cbf9b821..602b26aa21e24 100644 --- a/clients/client-alexa-for-business/commands/RevokeInvitationCommand.ts +++ b/clients/client-alexa-for-business/commands/RevokeInvitationCommand.ts @@ -20,6 +20,9 @@ import { export type RevokeInvitationCommandInput = RevokeInvitationRequest; export type RevokeInvitationCommandOutput = RevokeInvitationResponse & __MetadataBearer; +/** + *

Revokes an invitation and invalidates the enrollment URL.

+ */ export class RevokeInvitationCommand extends $Command< RevokeInvitationCommandInput, RevokeInvitationCommandOutput, @@ -34,6 +37,9 @@ export class RevokeInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SearchAddressBooksCommand.ts b/clients/client-alexa-for-business/commands/SearchAddressBooksCommand.ts index e45b61903458f..c4be560295ca7 100644 --- a/clients/client-alexa-for-business/commands/SearchAddressBooksCommand.ts +++ b/clients/client-alexa-for-business/commands/SearchAddressBooksCommand.ts @@ -20,6 +20,10 @@ import { export type SearchAddressBooksCommandInput = SearchAddressBooksRequest; export type SearchAddressBooksCommandOutput = SearchAddressBooksResponse & __MetadataBearer; +/** + *

Searches address books and lists the ones that meet a set of filter and sort + * criteria.

+ */ export class SearchAddressBooksCommand extends $Command< SearchAddressBooksCommandInput, SearchAddressBooksCommandOutput, @@ -34,6 +38,9 @@ export class SearchAddressBooksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SearchContactsCommand.ts b/clients/client-alexa-for-business/commands/SearchContactsCommand.ts index c4c2492ec9782..f280de552611e 100644 --- a/clients/client-alexa-for-business/commands/SearchContactsCommand.ts +++ b/clients/client-alexa-for-business/commands/SearchContactsCommand.ts @@ -20,6 +20,10 @@ import { export type SearchContactsCommandInput = SearchContactsRequest; export type SearchContactsCommandOutput = SearchContactsResponse & __MetadataBearer; +/** + *

Searches contacts and lists the ones that meet a set of filter and sort + * criteria.

+ */ export class SearchContactsCommand extends $Command< SearchContactsCommandInput, SearchContactsCommandOutput, @@ -34,6 +38,9 @@ export class SearchContactsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SearchDevicesCommand.ts b/clients/client-alexa-for-business/commands/SearchDevicesCommand.ts index 5d128407de2f1..d5e98578b1b83 100644 --- a/clients/client-alexa-for-business/commands/SearchDevicesCommand.ts +++ b/clients/client-alexa-for-business/commands/SearchDevicesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchDevicesCommandInput = SearchDevicesRequest; export type SearchDevicesCommandOutput = SearchDevicesResponse & __MetadataBearer; +/** + *

Searches devices and lists the ones that meet a set of filter criteria.

+ */ export class SearchDevicesCommand extends $Command< SearchDevicesCommandInput, SearchDevicesCommandOutput, @@ -34,6 +37,9 @@ export class SearchDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SearchNetworkProfilesCommand.ts b/clients/client-alexa-for-business/commands/SearchNetworkProfilesCommand.ts index d87b8dfe487b4..8288a11871ec7 100644 --- a/clients/client-alexa-for-business/commands/SearchNetworkProfilesCommand.ts +++ b/clients/client-alexa-for-business/commands/SearchNetworkProfilesCommand.ts @@ -20,6 +20,10 @@ import { export type SearchNetworkProfilesCommandInput = SearchNetworkProfilesRequest; export type SearchNetworkProfilesCommandOutput = SearchNetworkProfilesResponse & __MetadataBearer; +/** + *

Searches network profiles and lists the ones that meet a set of filter and sort + * criteria.

+ */ export class SearchNetworkProfilesCommand extends $Command< SearchNetworkProfilesCommandInput, SearchNetworkProfilesCommandOutput, @@ -34,6 +38,9 @@ export class SearchNetworkProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SearchProfilesCommand.ts b/clients/client-alexa-for-business/commands/SearchProfilesCommand.ts index ad86432cf82e4..0ee5878308baa 100644 --- a/clients/client-alexa-for-business/commands/SearchProfilesCommand.ts +++ b/clients/client-alexa-for-business/commands/SearchProfilesCommand.ts @@ -20,6 +20,10 @@ import { export type SearchProfilesCommandInput = SearchProfilesRequest; export type SearchProfilesCommandOutput = SearchProfilesResponse & __MetadataBearer; +/** + *

Searches room profiles and lists the ones that meet a set of filter + * criteria.

+ */ export class SearchProfilesCommand extends $Command< SearchProfilesCommandInput, SearchProfilesCommandOutput, @@ -34,6 +38,9 @@ export class SearchProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SearchRoomsCommand.ts b/clients/client-alexa-for-business/commands/SearchRoomsCommand.ts index 94ba322ddd711..7514a2983ed4e 100644 --- a/clients/client-alexa-for-business/commands/SearchRoomsCommand.ts +++ b/clients/client-alexa-for-business/commands/SearchRoomsCommand.ts @@ -20,6 +20,10 @@ import { export type SearchRoomsCommandInput = SearchRoomsRequest; export type SearchRoomsCommandOutput = SearchRoomsResponse & __MetadataBearer; +/** + *

Searches rooms and lists the ones that meet a set of filter and sort + * criteria.

+ */ export class SearchRoomsCommand extends $Command< SearchRoomsCommandInput, SearchRoomsCommandOutput, @@ -34,6 +38,9 @@ export class SearchRoomsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SearchSkillGroupsCommand.ts b/clients/client-alexa-for-business/commands/SearchSkillGroupsCommand.ts index 42eab41987ee5..f0b022eeed407 100644 --- a/clients/client-alexa-for-business/commands/SearchSkillGroupsCommand.ts +++ b/clients/client-alexa-for-business/commands/SearchSkillGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type SearchSkillGroupsCommandInput = SearchSkillGroupsRequest; export type SearchSkillGroupsCommandOutput = SearchSkillGroupsResponse & __MetadataBearer; +/** + *

Searches skill groups and lists the ones that meet a set of filter and sort + * criteria.

+ */ export class SearchSkillGroupsCommand extends $Command< SearchSkillGroupsCommandInput, SearchSkillGroupsCommandOutput, @@ -34,6 +38,9 @@ export class SearchSkillGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SearchUsersCommand.ts b/clients/client-alexa-for-business/commands/SearchUsersCommand.ts index a43b9885035fd..c26e5c9abc4ac 100644 --- a/clients/client-alexa-for-business/commands/SearchUsersCommand.ts +++ b/clients/client-alexa-for-business/commands/SearchUsersCommand.ts @@ -20,6 +20,10 @@ import { export type SearchUsersCommandInput = SearchUsersRequest; export type SearchUsersCommandOutput = SearchUsersResponse & __MetadataBearer; +/** + *

Searches users and lists the ones that meet a set of filter and sort + * criteria.

+ */ export class SearchUsersCommand extends $Command< SearchUsersCommandInput, SearchUsersCommandOutput, @@ -34,6 +38,9 @@ export class SearchUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SendAnnouncementCommand.ts b/clients/client-alexa-for-business/commands/SendAnnouncementCommand.ts index 81901106fe485..d3d248e7661fe 100644 --- a/clients/client-alexa-for-business/commands/SendAnnouncementCommand.ts +++ b/clients/client-alexa-for-business/commands/SendAnnouncementCommand.ts @@ -20,6 +20,10 @@ import { export type SendAnnouncementCommandInput = SendAnnouncementRequest; export type SendAnnouncementCommandOutput = SendAnnouncementResponse & __MetadataBearer; +/** + *

Triggers an asynchronous flow to send text, SSML, or audio announcements to rooms that + * are identified by a search or filter.

+ */ export class SendAnnouncementCommand extends $Command< SendAnnouncementCommandInput, SendAnnouncementCommandOutput, @@ -34,6 +38,9 @@ export class SendAnnouncementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/SendInvitationCommand.ts b/clients/client-alexa-for-business/commands/SendInvitationCommand.ts index df035ee420f43..3c98afe0a3253 100644 --- a/clients/client-alexa-for-business/commands/SendInvitationCommand.ts +++ b/clients/client-alexa-for-business/commands/SendInvitationCommand.ts @@ -20,6 +20,10 @@ import { export type SendInvitationCommandInput = SendInvitationRequest; export type SendInvitationCommandOutput = SendInvitationResponse & __MetadataBearer; +/** + *

Sends an enrollment invitation email with a URL to a user. The URL is valid for 30 + * days or until you call this operation again, whichever comes first.

+ */ export class SendInvitationCommand extends $Command< SendInvitationCommandInput, SendInvitationCommandOutput, @@ -34,6 +38,9 @@ export class SendInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/StartDeviceSyncCommand.ts b/clients/client-alexa-for-business/commands/StartDeviceSyncCommand.ts index 70577e0f9b4e4..535e11c1bd1e8 100644 --- a/clients/client-alexa-for-business/commands/StartDeviceSyncCommand.ts +++ b/clients/client-alexa-for-business/commands/StartDeviceSyncCommand.ts @@ -20,6 +20,30 @@ import { export type StartDeviceSyncCommandInput = StartDeviceSyncRequest; export type StartDeviceSyncCommandOutput = StartDeviceSyncResponse & __MetadataBearer; +/** + *

Resets a device and its account to the known default settings. This clears all + * information and settings set by previous users in the following ways:

+ *
    + *
  • + *

    Bluetooth - This unpairs all bluetooth devices paired with your echo + * device.

    + *
  • + *
  • + *

    Volume - This resets the echo device's volume to the default value.

    + *
  • + *
  • + *

    Notifications - This clears all notifications from your echo device.

    + *
  • + *
  • + *

    Lists - This clears all to-do items from your echo device.

    + *
  • + *
  • + *

    Settings - This internally syncs the room's profile (if the device is assigned to + * a room), contacts, address books, delegation access for account linking, and + * communications (if enabled on the room profile).

    + *
  • + *
+ */ export class StartDeviceSyncCommand extends $Command< StartDeviceSyncCommandInput, StartDeviceSyncCommandOutput, @@ -34,6 +58,9 @@ export class StartDeviceSyncCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/StartSmartHomeApplianceDiscoveryCommand.ts b/clients/client-alexa-for-business/commands/StartSmartHomeApplianceDiscoveryCommand.ts index c4269666789d6..658bc593f456d 100644 --- a/clients/client-alexa-for-business/commands/StartSmartHomeApplianceDiscoveryCommand.ts +++ b/clients/client-alexa-for-business/commands/StartSmartHomeApplianceDiscoveryCommand.ts @@ -20,6 +20,10 @@ import { export type StartSmartHomeApplianceDiscoveryCommandInput = StartSmartHomeApplianceDiscoveryRequest; export type StartSmartHomeApplianceDiscoveryCommandOutput = StartSmartHomeApplianceDiscoveryResponse & __MetadataBearer; +/** + *

Initiates the discovery of any smart home appliances associated with the + * room.

+ */ export class StartSmartHomeApplianceDiscoveryCommand extends $Command< StartSmartHomeApplianceDiscoveryCommandInput, StartSmartHomeApplianceDiscoveryCommandOutput, @@ -34,6 +38,9 @@ export class StartSmartHomeApplianceDiscoveryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/TagResourceCommand.ts b/clients/client-alexa-for-business/commands/TagResourceCommand.ts index d86a6dfab7cbd..b4001cca3e5b0 100644 --- a/clients/client-alexa-for-business/commands/TagResourceCommand.ts +++ b/clients/client-alexa-for-business/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds metadata tags to a specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UntagResourceCommand.ts b/clients/client-alexa-for-business/commands/UntagResourceCommand.ts index 70d8b9ad36cee..13e907431f822 100644 --- a/clients/client-alexa-for-business/commands/UntagResourceCommand.ts +++ b/clients/client-alexa-for-business/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes metadata tags from a specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateAddressBookCommand.ts b/clients/client-alexa-for-business/commands/UpdateAddressBookCommand.ts index 32fb1b83fd378..cf37b6fc6f3a6 100644 --- a/clients/client-alexa-for-business/commands/UpdateAddressBookCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateAddressBookCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAddressBookCommandInput = UpdateAddressBookRequest; export type UpdateAddressBookCommandOutput = UpdateAddressBookResponse & __MetadataBearer; +/** + *

Updates address book details by the address book ARN.

+ */ export class UpdateAddressBookCommand extends $Command< UpdateAddressBookCommandInput, UpdateAddressBookCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAddressBookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateBusinessReportScheduleCommand.ts b/clients/client-alexa-for-business/commands/UpdateBusinessReportScheduleCommand.ts index b85f27b833261..964a25ec6b6db 100644 --- a/clients/client-alexa-for-business/commands/UpdateBusinessReportScheduleCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateBusinessReportScheduleCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateBusinessReportScheduleCommandInput = UpdateBusinessReportScheduleRequest; export type UpdateBusinessReportScheduleCommandOutput = UpdateBusinessReportScheduleResponse & __MetadataBearer; +/** + *

Updates the configuration of the report delivery schedule with the specified schedule + * ARN.

+ */ export class UpdateBusinessReportScheduleCommand extends $Command< UpdateBusinessReportScheduleCommandInput, UpdateBusinessReportScheduleCommandOutput, @@ -34,6 +38,9 @@ export class UpdateBusinessReportScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateConferenceProviderCommand.ts b/clients/client-alexa-for-business/commands/UpdateConferenceProviderCommand.ts index 109a92162a098..29e46773f3138 100644 --- a/clients/client-alexa-for-business/commands/UpdateConferenceProviderCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateConferenceProviderCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConferenceProviderCommandInput = UpdateConferenceProviderRequest; export type UpdateConferenceProviderCommandOutput = UpdateConferenceProviderResponse & __MetadataBearer; +/** + *

Updates an existing conference provider's settings.

+ */ export class UpdateConferenceProviderCommand extends $Command< UpdateConferenceProviderCommandInput, UpdateConferenceProviderCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConferenceProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateContactCommand.ts b/clients/client-alexa-for-business/commands/UpdateContactCommand.ts index cadce838c9274..2a5b8b9a6fd50 100644 --- a/clients/client-alexa-for-business/commands/UpdateContactCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateContactCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateContactCommandInput = UpdateContactRequest; export type UpdateContactCommandOutput = UpdateContactResponse & __MetadataBearer; +/** + *

Updates the contact details by the contact ARN.

+ */ export class UpdateContactCommand extends $Command< UpdateContactCommandInput, UpdateContactCommandOutput, @@ -34,6 +37,9 @@ export class UpdateContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateDeviceCommand.ts b/clients/client-alexa-for-business/commands/UpdateDeviceCommand.ts index 35e96e776f846..b7a1b0763c078 100644 --- a/clients/client-alexa-for-business/commands/UpdateDeviceCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateDeviceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDeviceCommandInput = UpdateDeviceRequest; export type UpdateDeviceCommandOutput = UpdateDeviceResponse & __MetadataBearer; +/** + *

Updates the device name by device ARN.

+ */ export class UpdateDeviceCommand extends $Command< UpdateDeviceCommandInput, UpdateDeviceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateGatewayCommand.ts b/clients/client-alexa-for-business/commands/UpdateGatewayCommand.ts index b4dd89c5156d3..e40ecdc4496b3 100644 --- a/clients/client-alexa-for-business/commands/UpdateGatewayCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateGatewayCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateGatewayCommandInput = UpdateGatewayRequest; export type UpdateGatewayCommandOutput = UpdateGatewayResponse & __MetadataBearer; +/** + *

Updates the details of a gateway. If any optional field is not provided, the existing + * corresponding value is left unmodified.

+ */ export class UpdateGatewayCommand extends $Command< UpdateGatewayCommandInput, UpdateGatewayCommandOutput, @@ -34,6 +38,9 @@ export class UpdateGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateGatewayGroupCommand.ts b/clients/client-alexa-for-business/commands/UpdateGatewayGroupCommand.ts index 785a836161a5f..8cc0b4d73eb8f 100644 --- a/clients/client-alexa-for-business/commands/UpdateGatewayGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateGatewayGroupCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateGatewayGroupCommandInput = UpdateGatewayGroupRequest; export type UpdateGatewayGroupCommandOutput = UpdateGatewayGroupResponse & __MetadataBearer; +/** + *

Updates the details of a gateway group. If any optional field is not provided, the + * existing corresponding value is left unmodified.

+ */ export class UpdateGatewayGroupCommand extends $Command< UpdateGatewayGroupCommandInput, UpdateGatewayGroupCommandOutput, @@ -34,6 +38,9 @@ export class UpdateGatewayGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateNetworkProfileCommand.ts b/clients/client-alexa-for-business/commands/UpdateNetworkProfileCommand.ts index da307cbc001ab..0e96882c3bb0b 100644 --- a/clients/client-alexa-for-business/commands/UpdateNetworkProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateNetworkProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateNetworkProfileCommandInput = UpdateNetworkProfileRequest; export type UpdateNetworkProfileCommandOutput = UpdateNetworkProfileResponse & __MetadataBearer; +/** + *

Updates a network profile by the network profile ARN.

+ */ export class UpdateNetworkProfileCommand extends $Command< UpdateNetworkProfileCommandInput, UpdateNetworkProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateProfileCommand.ts b/clients/client-alexa-for-business/commands/UpdateProfileCommand.ts index 28e5ab0201805..9e76f2e6aeeeb 100644 --- a/clients/client-alexa-for-business/commands/UpdateProfileCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProfileCommandInput = UpdateProfileRequest; export type UpdateProfileCommandOutput = UpdateProfileResponse & __MetadataBearer; +/** + *

Updates an existing room profile by room profile ARN.

+ */ export class UpdateProfileCommand extends $Command< UpdateProfileCommandInput, UpdateProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateRoomCommand.ts b/clients/client-alexa-for-business/commands/UpdateRoomCommand.ts index 36f604f5c23a8..d8387e80f3824 100644 --- a/clients/client-alexa-for-business/commands/UpdateRoomCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateRoomCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRoomCommandInput = UpdateRoomRequest; export type UpdateRoomCommandOutput = UpdateRoomResponse & __MetadataBearer; +/** + *

Updates room details by room ARN.

+ */ export class UpdateRoomCommand extends $Command< UpdateRoomCommandInput, UpdateRoomCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/commands/UpdateSkillGroupCommand.ts b/clients/client-alexa-for-business/commands/UpdateSkillGroupCommand.ts index 3112014de6744..268a1010d5b8e 100644 --- a/clients/client-alexa-for-business/commands/UpdateSkillGroupCommand.ts +++ b/clients/client-alexa-for-business/commands/UpdateSkillGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSkillGroupCommandInput = UpdateSkillGroupRequest; export type UpdateSkillGroupCommandOutput = UpdateSkillGroupResponse & __MetadataBearer; +/** + *

Updates skill group details by skill group ARN.

+ */ export class UpdateSkillGroupCommand extends $Command< UpdateSkillGroupCommandInput, UpdateSkillGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSkillGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AlexaForBusinessClientResolvedConfig, diff --git a/clients/client-alexa-for-business/package.json b/clients/client-alexa-for-business/package.json index 8fac7898fc760..bfd633173c453 100644 --- a/clients/client-alexa-for-business/package.json +++ b/clients/client-alexa-for-business/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Alexa For Business Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-alexa-for-business/pagination/ListBusinessReportSchedulesPaginator.ts b/clients/client-alexa-for-business/pagination/ListBusinessReportSchedulesPaginator.ts index 216da46cde56c..d0a955bf6a0e5 100644 --- a/clients/client-alexa-for-business/pagination/ListBusinessReportSchedulesPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListBusinessReportSchedulesPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListBusinessReportSchedulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBusinessReportSchedulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListBusinessReportSchedulesCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListConferenceProvidersPaginator.ts b/clients/client-alexa-for-business/pagination/ListConferenceProvidersPaginator.ts index fdfad86936d88..1593cf366e5d0 100644 --- a/clients/client-alexa-for-business/pagination/ListConferenceProvidersPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListConferenceProvidersPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListConferenceProvidersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConferenceProvidersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListConferenceProvidersCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListDeviceEventsPaginator.ts b/clients/client-alexa-for-business/pagination/ListDeviceEventsPaginator.ts index 152a3a20e0813..e92b160f8a554 100644 --- a/clients/client-alexa-for-business/pagination/ListDeviceEventsPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListDeviceEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListDeviceEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeviceEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListDeviceEventsCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListGatewayGroupsPaginator.ts b/clients/client-alexa-for-business/pagination/ListGatewayGroupsPaginator.ts index a8358f64b8a4d..d5e58dd0d5269 100644 --- a/clients/client-alexa-for-business/pagination/ListGatewayGroupsPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListGatewayGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListGatewayGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGatewayGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListGatewayGroupsCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListGatewaysPaginator.ts b/clients/client-alexa-for-business/pagination/ListGatewaysPaginator.ts index 1838bcde90078..efa9becc73295 100644 --- a/clients/client-alexa-for-business/pagination/ListGatewaysPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListGatewaysCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListSkillsPaginator.ts b/clients/client-alexa-for-business/pagination/ListSkillsPaginator.ts index 85e4d2b5ef5a6..281e7164337fe 100644 --- a/clients/client-alexa-for-business/pagination/ListSkillsPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListSkillsPaginator.ts @@ -4,6 +4,9 @@ import { ListSkillsCommand, ListSkillsCommandInput, ListSkillsCommandOutput } fr import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListSkillsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSkillsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListSkillsCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListSkillsStoreCategoriesPaginator.ts b/clients/client-alexa-for-business/pagination/ListSkillsStoreCategoriesPaginator.ts index 3a854e88361a4..c3e860f7dce2e 100644 --- a/clients/client-alexa-for-business/pagination/ListSkillsStoreCategoriesPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListSkillsStoreCategoriesPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListSkillsStoreCategoriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSkillsStoreCategoriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListSkillsStoreCategoriesCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListSkillsStoreSkillsByCategoryPaginator.ts b/clients/client-alexa-for-business/pagination/ListSkillsStoreSkillsByCategoryPaginator.ts index 6d962f7680b5f..33a16751000de 100644 --- a/clients/client-alexa-for-business/pagination/ListSkillsStoreSkillsByCategoryPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListSkillsStoreSkillsByCategoryPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListSkillsStoreSkillsByCategoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSkillsStoreSkillsByCategoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListSkillsStoreSkillsByCategoryCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListSmartHomeAppliancesPaginator.ts b/clients/client-alexa-for-business/pagination/ListSmartHomeAppliancesPaginator.ts index 8ecf1b4852f93..58710ae0b91c4 100644 --- a/clients/client-alexa-for-business/pagination/ListSmartHomeAppliancesPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListSmartHomeAppliancesPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListSmartHomeAppliancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSmartHomeAppliancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListSmartHomeAppliancesCommandInput, diff --git a/clients/client-alexa-for-business/pagination/ListTagsPaginator.ts b/clients/client-alexa-for-business/pagination/ListTagsPaginator.ts index 68346a1e422d7..82c8d6ea22b96 100644 --- a/clients/client-alexa-for-business/pagination/ListTagsPaginator.ts +++ b/clients/client-alexa-for-business/pagination/ListTagsPaginator.ts @@ -4,6 +4,9 @@ import { ListTagsCommand, ListTagsCommandInput, ListTagsCommandOutput } from ".. import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: ListTagsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: ListTagsCommandInput, diff --git a/clients/client-alexa-for-business/pagination/SearchAddressBooksPaginator.ts b/clients/client-alexa-for-business/pagination/SearchAddressBooksPaginator.ts index bc5b0ef83628d..c282380885c08 100644 --- a/clients/client-alexa-for-business/pagination/SearchAddressBooksPaginator.ts +++ b/clients/client-alexa-for-business/pagination/SearchAddressBooksPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: SearchAddressBooksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchAddressBooksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: SearchAddressBooksCommandInput, diff --git a/clients/client-alexa-for-business/pagination/SearchContactsPaginator.ts b/clients/client-alexa-for-business/pagination/SearchContactsPaginator.ts index d518030ea6422..cbfb5c4ebfcae 100644 --- a/clients/client-alexa-for-business/pagination/SearchContactsPaginator.ts +++ b/clients/client-alexa-for-business/pagination/SearchContactsPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: SearchContactsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchContactsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: SearchContactsCommandInput, diff --git a/clients/client-alexa-for-business/pagination/SearchDevicesPaginator.ts b/clients/client-alexa-for-business/pagination/SearchDevicesPaginator.ts index 52ed3cd7a8c9d..08bc10a7a0c7e 100644 --- a/clients/client-alexa-for-business/pagination/SearchDevicesPaginator.ts +++ b/clients/client-alexa-for-business/pagination/SearchDevicesPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: SearchDevicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchDevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: SearchDevicesCommandInput, diff --git a/clients/client-alexa-for-business/pagination/SearchNetworkProfilesPaginator.ts b/clients/client-alexa-for-business/pagination/SearchNetworkProfilesPaginator.ts index ae25527e6bcae..6e5759d8f068f 100644 --- a/clients/client-alexa-for-business/pagination/SearchNetworkProfilesPaginator.ts +++ b/clients/client-alexa-for-business/pagination/SearchNetworkProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: SearchNetworkProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchNetworkProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: SearchNetworkProfilesCommandInput, diff --git a/clients/client-alexa-for-business/pagination/SearchProfilesPaginator.ts b/clients/client-alexa-for-business/pagination/SearchProfilesPaginator.ts index aa28ea9e7f5e8..9849184b78449 100644 --- a/clients/client-alexa-for-business/pagination/SearchProfilesPaginator.ts +++ b/clients/client-alexa-for-business/pagination/SearchProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: SearchProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: SearchProfilesCommandInput, diff --git a/clients/client-alexa-for-business/pagination/SearchRoomsPaginator.ts b/clients/client-alexa-for-business/pagination/SearchRoomsPaginator.ts index 0cee511b54d79..af64ab1da5d56 100644 --- a/clients/client-alexa-for-business/pagination/SearchRoomsPaginator.ts +++ b/clients/client-alexa-for-business/pagination/SearchRoomsPaginator.ts @@ -4,6 +4,9 @@ import { SearchRoomsCommand, SearchRoomsCommandInput, SearchRoomsCommandOutput } import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: SearchRoomsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchRoomsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: SearchRoomsCommandInput, diff --git a/clients/client-alexa-for-business/pagination/SearchSkillGroupsPaginator.ts b/clients/client-alexa-for-business/pagination/SearchSkillGroupsPaginator.ts index b7dfe9ee0e0d6..3dcf97f38b405 100644 --- a/clients/client-alexa-for-business/pagination/SearchSkillGroupsPaginator.ts +++ b/clients/client-alexa-for-business/pagination/SearchSkillGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: SearchSkillGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchSkillGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: SearchSkillGroupsCommandInput, diff --git a/clients/client-alexa-for-business/pagination/SearchUsersPaginator.ts b/clients/client-alexa-for-business/pagination/SearchUsersPaginator.ts index ee2e8f7c579a3..0a013e1836d0d 100644 --- a/clients/client-alexa-for-business/pagination/SearchUsersPaginator.ts +++ b/clients/client-alexa-for-business/pagination/SearchUsersPaginator.ts @@ -4,6 +4,9 @@ import { SearchUsersCommand, SearchUsersCommandInput, SearchUsersCommandOutput } import { AlexaForBusinessPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AlexaForBusinessClient, input: SearchUsersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AlexaForBusiness, input: SearchUsersCommandInput, diff --git a/clients/client-alexa-for-business/runtimeConfig.browser.ts b/clients/client-alexa-for-business/runtimeConfig.browser.ts index a321853770f23..0dfea46d68b72 100644 --- a/clients/client-alexa-for-business/runtimeConfig.browser.ts +++ b/clients/client-alexa-for-business/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AlexaForBusinessClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-alexa-for-business/runtimeConfig.native.ts b/clients/client-alexa-for-business/runtimeConfig.native.ts index c1c1516e768c3..0a2c52c955f39 100644 --- a/clients/client-alexa-for-business/runtimeConfig.native.ts +++ b/clients/client-alexa-for-business/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AlexaForBusinessClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-alexa-for-business/runtimeConfig.shared.ts b/clients/client-alexa-for-business/runtimeConfig.shared.ts index c28e7b6703a5c..b8b52feb36573 100644 --- a/clients/client-alexa-for-business/runtimeConfig.shared.ts +++ b/clients/client-alexa-for-business/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-11-09", disableHostPrefix: false, diff --git a/clients/client-alexa-for-business/runtimeConfig.ts b/clients/client-alexa-for-business/runtimeConfig.ts index 4420bf5a41385..a7671434b4188 100644 --- a/clients/client-alexa-for-business/runtimeConfig.ts +++ b/clients/client-alexa-for-business/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AlexaForBusinessClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-alexa-for-business/tsconfig.json b/clients/client-alexa-for-business/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-alexa-for-business/tsconfig.json +++ b/clients/client-alexa-for-business/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-amplify/commands/CreateAppCommand.ts b/clients/client-amplify/commands/CreateAppCommand.ts index cc16ad97cce8a..e166f6373cfd2 100644 --- a/clients/client-amplify/commands/CreateAppCommand.ts +++ b/clients/client-amplify/commands/CreateAppCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAppCommandInput = CreateAppRequest; export type CreateAppCommandOutput = CreateAppResult & __MetadataBearer; +/** + *

Creates a new Amplify app.

+ */ export class CreateAppCommand extends $Command< CreateAppCommandInput, CreateAppCommandOutput, @@ -34,6 +37,9 @@ export class CreateAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/CreateBackendEnvironmentCommand.ts b/clients/client-amplify/commands/CreateBackendEnvironmentCommand.ts index 328062aba4d7b..9f92084e27506 100644 --- a/clients/client-amplify/commands/CreateBackendEnvironmentCommand.ts +++ b/clients/client-amplify/commands/CreateBackendEnvironmentCommand.ts @@ -20,6 +20,9 @@ import { export type CreateBackendEnvironmentCommandInput = CreateBackendEnvironmentRequest; export type CreateBackendEnvironmentCommandOutput = CreateBackendEnvironmentResult & __MetadataBearer; +/** + *

Creates a new backend environment for an Amplify app.

+ */ export class CreateBackendEnvironmentCommand extends $Command< CreateBackendEnvironmentCommandInput, CreateBackendEnvironmentCommandOutput, @@ -34,6 +37,9 @@ export class CreateBackendEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/CreateBranchCommand.ts b/clients/client-amplify/commands/CreateBranchCommand.ts index d267b3ef98803..0a241ef633f47 100644 --- a/clients/client-amplify/commands/CreateBranchCommand.ts +++ b/clients/client-amplify/commands/CreateBranchCommand.ts @@ -20,6 +20,9 @@ import { export type CreateBranchCommandInput = CreateBranchRequest; export type CreateBranchCommandOutput = CreateBranchResult & __MetadataBearer; +/** + *

Creates a new branch for an Amplify app.

+ */ export class CreateBranchCommand extends $Command< CreateBranchCommandInput, CreateBranchCommandOutput, @@ -34,6 +37,9 @@ export class CreateBranchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/CreateDeploymentCommand.ts b/clients/client-amplify/commands/CreateDeploymentCommand.ts index 20bdaa75f5a93..6418b31127897 100644 --- a/clients/client-amplify/commands/CreateDeploymentCommand.ts +++ b/clients/client-amplify/commands/CreateDeploymentCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDeploymentCommandInput = CreateDeploymentRequest; export type CreateDeploymentCommandOutput = CreateDeploymentResult & __MetadataBearer; +/** + *

Creates a deployment for a manually deployed Amplify app. Manually deployed apps are + * not connected to a repository.

+ */ export class CreateDeploymentCommand extends $Command< CreateDeploymentCommandInput, CreateDeploymentCommandOutput, @@ -34,6 +38,9 @@ export class CreateDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/CreateDomainAssociationCommand.ts b/clients/client-amplify/commands/CreateDomainAssociationCommand.ts index 0b901780aaf6b..0d1f7b18e31a2 100644 --- a/clients/client-amplify/commands/CreateDomainAssociationCommand.ts +++ b/clients/client-amplify/commands/CreateDomainAssociationCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDomainAssociationCommandInput = CreateDomainAssociationRequest; export type CreateDomainAssociationCommandOutput = CreateDomainAssociationResult & __MetadataBearer; +/** + *

Creates a new domain association for an Amplify app. This action associates a custom + * domain with the Amplify app

+ */ export class CreateDomainAssociationCommand extends $Command< CreateDomainAssociationCommandInput, CreateDomainAssociationCommandOutput, @@ -34,6 +38,9 @@ export class CreateDomainAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/CreateWebhookCommand.ts b/clients/client-amplify/commands/CreateWebhookCommand.ts index 125b263a8a79d..0ce88bb17ef5c 100644 --- a/clients/client-amplify/commands/CreateWebhookCommand.ts +++ b/clients/client-amplify/commands/CreateWebhookCommand.ts @@ -20,6 +20,9 @@ import { export type CreateWebhookCommandInput = CreateWebhookRequest; export type CreateWebhookCommandOutput = CreateWebhookResult & __MetadataBearer; +/** + *

Creates a new webhook on an Amplify app.

+ */ export class CreateWebhookCommand extends $Command< CreateWebhookCommandInput, CreateWebhookCommandOutput, @@ -34,6 +37,9 @@ export class CreateWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/DeleteAppCommand.ts b/clients/client-amplify/commands/DeleteAppCommand.ts index 0fcf201357799..8f02840c7d7b4 100644 --- a/clients/client-amplify/commands/DeleteAppCommand.ts +++ b/clients/client-amplify/commands/DeleteAppCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAppCommandInput = DeleteAppRequest; export type DeleteAppCommandOutput = DeleteAppResult & __MetadataBearer; +/** + *

Deletes an existing Amplify app specified by an app ID.

+ */ export class DeleteAppCommand extends $Command< DeleteAppCommandInput, DeleteAppCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/DeleteBackendEnvironmentCommand.ts b/clients/client-amplify/commands/DeleteBackendEnvironmentCommand.ts index deae6786db97c..66255b5aa5261 100644 --- a/clients/client-amplify/commands/DeleteBackendEnvironmentCommand.ts +++ b/clients/client-amplify/commands/DeleteBackendEnvironmentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBackendEnvironmentCommandInput = DeleteBackendEnvironmentRequest; export type DeleteBackendEnvironmentCommandOutput = DeleteBackendEnvironmentResult & __MetadataBearer; +/** + *

Deletes a backend environment for an Amplify app.

+ */ export class DeleteBackendEnvironmentCommand extends $Command< DeleteBackendEnvironmentCommandInput, DeleteBackendEnvironmentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBackendEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/DeleteBranchCommand.ts b/clients/client-amplify/commands/DeleteBranchCommand.ts index bf8160b73e9e2..581d8f399b516 100644 --- a/clients/client-amplify/commands/DeleteBranchCommand.ts +++ b/clients/client-amplify/commands/DeleteBranchCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBranchCommandInput = DeleteBranchRequest; export type DeleteBranchCommandOutput = DeleteBranchResult & __MetadataBearer; +/** + *

Deletes a branch for an Amplify app.

+ */ export class DeleteBranchCommand extends $Command< DeleteBranchCommandInput, DeleteBranchCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBranchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/DeleteDomainAssociationCommand.ts b/clients/client-amplify/commands/DeleteDomainAssociationCommand.ts index a3c2e8f1ae5ab..a00bf0faa047a 100644 --- a/clients/client-amplify/commands/DeleteDomainAssociationCommand.ts +++ b/clients/client-amplify/commands/DeleteDomainAssociationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDomainAssociationCommandInput = DeleteDomainAssociationRequest; export type DeleteDomainAssociationCommandOutput = DeleteDomainAssociationResult & __MetadataBearer; +/** + *

Deletes a domain association for an Amplify app.

+ */ export class DeleteDomainAssociationCommand extends $Command< DeleteDomainAssociationCommandInput, DeleteDomainAssociationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDomainAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/DeleteJobCommand.ts b/clients/client-amplify/commands/DeleteJobCommand.ts index ce77c0e3c1b87..6ef23d3bc3fb7 100644 --- a/clients/client-amplify/commands/DeleteJobCommand.ts +++ b/clients/client-amplify/commands/DeleteJobCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteJobCommandInput = DeleteJobRequest; export type DeleteJobCommandOutput = DeleteJobResult & __MetadataBearer; +/** + *

Deletes a job for a branch of an Amplify app.

+ */ export class DeleteJobCommand extends $Command< DeleteJobCommandInput, DeleteJobCommandOutput, @@ -34,6 +37,9 @@ export class DeleteJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/DeleteWebhookCommand.ts b/clients/client-amplify/commands/DeleteWebhookCommand.ts index b3b9783d10536..d82058ee52d08 100644 --- a/clients/client-amplify/commands/DeleteWebhookCommand.ts +++ b/clients/client-amplify/commands/DeleteWebhookCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteWebhookCommandInput = DeleteWebhookRequest; export type DeleteWebhookCommandOutput = DeleteWebhookResult & __MetadataBearer; +/** + *

Deletes a webhook.

+ */ export class DeleteWebhookCommand extends $Command< DeleteWebhookCommandInput, DeleteWebhookCommandOutput, @@ -34,6 +37,9 @@ export class DeleteWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/GenerateAccessLogsCommand.ts b/clients/client-amplify/commands/GenerateAccessLogsCommand.ts index 28a6ec707f3f6..7aa9248da693e 100644 --- a/clients/client-amplify/commands/GenerateAccessLogsCommand.ts +++ b/clients/client-amplify/commands/GenerateAccessLogsCommand.ts @@ -20,6 +20,10 @@ import { export type GenerateAccessLogsCommandInput = GenerateAccessLogsRequest; export type GenerateAccessLogsCommandOutput = GenerateAccessLogsResult & __MetadataBearer; +/** + *

Returns the website access logs for a specific time range using a presigned URL. + *

+ */ export class GenerateAccessLogsCommand extends $Command< GenerateAccessLogsCommandInput, GenerateAccessLogsCommandOutput, @@ -34,6 +38,9 @@ export class GenerateAccessLogsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/GetAppCommand.ts b/clients/client-amplify/commands/GetAppCommand.ts index 220c1a8c19a02..6b44944ccea28 100644 --- a/clients/client-amplify/commands/GetAppCommand.ts +++ b/clients/client-amplify/commands/GetAppCommand.ts @@ -17,6 +17,9 @@ import { export type GetAppCommandInput = GetAppRequest; export type GetAppCommandOutput = GetAppResult & __MetadataBearer; +/** + *

Returns an existing Amplify app by appID.

+ */ export class GetAppCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetAppCommand extends $Command, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/GetArtifactUrlCommand.ts b/clients/client-amplify/commands/GetArtifactUrlCommand.ts index 61428389e5f2a..5d7995c8b5c14 100644 --- a/clients/client-amplify/commands/GetArtifactUrlCommand.ts +++ b/clients/client-amplify/commands/GetArtifactUrlCommand.ts @@ -20,6 +20,9 @@ import { export type GetArtifactUrlCommandInput = GetArtifactUrlRequest; export type GetArtifactUrlCommandOutput = GetArtifactUrlResult & __MetadataBearer; +/** + *

Returns the artifact info that corresponds to an artifact id.

+ */ export class GetArtifactUrlCommand extends $Command< GetArtifactUrlCommandInput, GetArtifactUrlCommandOutput, @@ -34,6 +37,9 @@ export class GetArtifactUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/GetBackendEnvironmentCommand.ts b/clients/client-amplify/commands/GetBackendEnvironmentCommand.ts index 60c009bfa8bae..f0665cdfc8955 100644 --- a/clients/client-amplify/commands/GetBackendEnvironmentCommand.ts +++ b/clients/client-amplify/commands/GetBackendEnvironmentCommand.ts @@ -20,6 +20,9 @@ import { export type GetBackendEnvironmentCommandInput = GetBackendEnvironmentRequest; export type GetBackendEnvironmentCommandOutput = GetBackendEnvironmentResult & __MetadataBearer; +/** + *

Returns a backend environment for an Amplify app.

+ */ export class GetBackendEnvironmentCommand extends $Command< GetBackendEnvironmentCommandInput, GetBackendEnvironmentCommandOutput, @@ -34,6 +37,9 @@ export class GetBackendEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/GetBranchCommand.ts b/clients/client-amplify/commands/GetBranchCommand.ts index 1cd217a2fe735..7052f10c429db 100644 --- a/clients/client-amplify/commands/GetBranchCommand.ts +++ b/clients/client-amplify/commands/GetBranchCommand.ts @@ -20,6 +20,9 @@ import { export type GetBranchCommandInput = GetBranchRequest; export type GetBranchCommandOutput = GetBranchResult & __MetadataBearer; +/** + *

Returns a branch for an Amplify app.

+ */ export class GetBranchCommand extends $Command< GetBranchCommandInput, GetBranchCommandOutput, @@ -34,6 +37,9 @@ export class GetBranchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/GetDomainAssociationCommand.ts b/clients/client-amplify/commands/GetDomainAssociationCommand.ts index c82ebb5443f56..ec3bf73c87945 100644 --- a/clients/client-amplify/commands/GetDomainAssociationCommand.ts +++ b/clients/client-amplify/commands/GetDomainAssociationCommand.ts @@ -20,6 +20,9 @@ import { export type GetDomainAssociationCommandInput = GetDomainAssociationRequest; export type GetDomainAssociationCommandOutput = GetDomainAssociationResult & __MetadataBearer; +/** + *

Returns the domain information for an Amplify app.

+ */ export class GetDomainAssociationCommand extends $Command< GetDomainAssociationCommandInput, GetDomainAssociationCommandOutput, @@ -34,6 +37,9 @@ export class GetDomainAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/GetJobCommand.ts b/clients/client-amplify/commands/GetJobCommand.ts index 464e83ab294d9..e2f3657f9d932 100644 --- a/clients/client-amplify/commands/GetJobCommand.ts +++ b/clients/client-amplify/commands/GetJobCommand.ts @@ -17,6 +17,9 @@ import { export type GetJobCommandInput = GetJobRequest; export type GetJobCommandOutput = GetJobResult & __MetadataBearer; +/** + *

Returns a job for a branch of an Amplify app.

+ */ export class GetJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetJobCommand extends $Command, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/GetWebhookCommand.ts b/clients/client-amplify/commands/GetWebhookCommand.ts index 2283080edb2b6..b5ce40fcaf137 100644 --- a/clients/client-amplify/commands/GetWebhookCommand.ts +++ b/clients/client-amplify/commands/GetWebhookCommand.ts @@ -20,6 +20,9 @@ import { export type GetWebhookCommandInput = GetWebhookRequest; export type GetWebhookCommandOutput = GetWebhookResult & __MetadataBearer; +/** + *

Returns the webhook information that corresponds to a specified webhook ID.

+ */ export class GetWebhookCommand extends $Command< GetWebhookCommandInput, GetWebhookCommandOutput, @@ -34,6 +37,9 @@ export class GetWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/ListAppsCommand.ts b/clients/client-amplify/commands/ListAppsCommand.ts index 68627b004a951..bdcc343ea89e0 100644 --- a/clients/client-amplify/commands/ListAppsCommand.ts +++ b/clients/client-amplify/commands/ListAppsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAppsCommandInput = ListAppsRequest; export type ListAppsCommandOutput = ListAppsResult & __MetadataBearer; +/** + *

Returns a list of the existing Amplify apps.

+ */ export class ListAppsCommand extends $Command< ListAppsCommandInput, ListAppsCommandOutput, @@ -34,6 +37,9 @@ export class ListAppsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/ListArtifactsCommand.ts b/clients/client-amplify/commands/ListArtifactsCommand.ts index a627b956b3380..8e0800d069a63 100644 --- a/clients/client-amplify/commands/ListArtifactsCommand.ts +++ b/clients/client-amplify/commands/ListArtifactsCommand.ts @@ -20,6 +20,9 @@ import { export type ListArtifactsCommandInput = ListArtifactsRequest; export type ListArtifactsCommandOutput = ListArtifactsResult & __MetadataBearer; +/** + *

Returns a list of artifacts for a specified app, branch, and job.

+ */ export class ListArtifactsCommand extends $Command< ListArtifactsCommandInput, ListArtifactsCommandOutput, @@ -34,6 +37,9 @@ export class ListArtifactsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/ListBackendEnvironmentsCommand.ts b/clients/client-amplify/commands/ListBackendEnvironmentsCommand.ts index beb12851907aa..f3e3d559f1be2 100644 --- a/clients/client-amplify/commands/ListBackendEnvironmentsCommand.ts +++ b/clients/client-amplify/commands/ListBackendEnvironmentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListBackendEnvironmentsCommandInput = ListBackendEnvironmentsRequest; export type ListBackendEnvironmentsCommandOutput = ListBackendEnvironmentsResult & __MetadataBearer; +/** + *

Lists the backend environments for an Amplify app.

+ */ export class ListBackendEnvironmentsCommand extends $Command< ListBackendEnvironmentsCommandInput, ListBackendEnvironmentsCommandOutput, @@ -34,6 +37,9 @@ export class ListBackendEnvironmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/ListBranchesCommand.ts b/clients/client-amplify/commands/ListBranchesCommand.ts index 4c317085b6711..993ee4b230dec 100644 --- a/clients/client-amplify/commands/ListBranchesCommand.ts +++ b/clients/client-amplify/commands/ListBranchesCommand.ts @@ -20,6 +20,9 @@ import { export type ListBranchesCommandInput = ListBranchesRequest; export type ListBranchesCommandOutput = ListBranchesResult & __MetadataBearer; +/** + *

Lists the branches of an Amplify app.

+ */ export class ListBranchesCommand extends $Command< ListBranchesCommandInput, ListBranchesCommandOutput, @@ -34,6 +37,9 @@ export class ListBranchesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/ListDomainAssociationsCommand.ts b/clients/client-amplify/commands/ListDomainAssociationsCommand.ts index 34f693b6ffe61..ce17ccd080d23 100644 --- a/clients/client-amplify/commands/ListDomainAssociationsCommand.ts +++ b/clients/client-amplify/commands/ListDomainAssociationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDomainAssociationsCommandInput = ListDomainAssociationsRequest; export type ListDomainAssociationsCommandOutput = ListDomainAssociationsResult & __MetadataBearer; +/** + *

Returns the domain associations for an Amplify app.

+ */ export class ListDomainAssociationsCommand extends $Command< ListDomainAssociationsCommandInput, ListDomainAssociationsCommandOutput, @@ -34,6 +37,9 @@ export class ListDomainAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/ListJobsCommand.ts b/clients/client-amplify/commands/ListJobsCommand.ts index 86315ca38d187..eade18a49cf93 100644 --- a/clients/client-amplify/commands/ListJobsCommand.ts +++ b/clients/client-amplify/commands/ListJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResult & __MetadataBearer; +/** + *

Lists the jobs for a branch of an Amplify app.

+ */ export class ListJobsCommand extends $Command< ListJobsCommandInput, ListJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/ListTagsForResourceCommand.ts b/clients/client-amplify/commands/ListTagsForResourceCommand.ts index 1bbde544b0dfd..39a6ddad921ef 100644 --- a/clients/client-amplify/commands/ListTagsForResourceCommand.ts +++ b/clients/client-amplify/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns a list of tags for a specified Amazon Resource Name (ARN).

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/ListWebhooksCommand.ts b/clients/client-amplify/commands/ListWebhooksCommand.ts index e4983c381fa00..cdb9499bbd005 100644 --- a/clients/client-amplify/commands/ListWebhooksCommand.ts +++ b/clients/client-amplify/commands/ListWebhooksCommand.ts @@ -20,6 +20,9 @@ import { export type ListWebhooksCommandInput = ListWebhooksRequest; export type ListWebhooksCommandOutput = ListWebhooksResult & __MetadataBearer; +/** + *

Returns a list of webhooks for an Amplify app.

+ */ export class ListWebhooksCommand extends $Command< ListWebhooksCommandInput, ListWebhooksCommandOutput, @@ -34,6 +37,9 @@ export class ListWebhooksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/StartDeploymentCommand.ts b/clients/client-amplify/commands/StartDeploymentCommand.ts index 2e4e9d012a3d4..58328c320eb1e 100644 --- a/clients/client-amplify/commands/StartDeploymentCommand.ts +++ b/clients/client-amplify/commands/StartDeploymentCommand.ts @@ -20,6 +20,10 @@ import { export type StartDeploymentCommandInput = StartDeploymentRequest; export type StartDeploymentCommandOutput = StartDeploymentResult & __MetadataBearer; +/** + *

Starts a deployment for a manually deployed app. Manually deployed apps are not + * connected to a repository.

+ */ export class StartDeploymentCommand extends $Command< StartDeploymentCommandInput, StartDeploymentCommandOutput, @@ -34,6 +38,9 @@ export class StartDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/StartJobCommand.ts b/clients/client-amplify/commands/StartJobCommand.ts index 3a8df5d742802..0402f70bd88b0 100644 --- a/clients/client-amplify/commands/StartJobCommand.ts +++ b/clients/client-amplify/commands/StartJobCommand.ts @@ -20,6 +20,9 @@ import { export type StartJobCommandInput = StartJobRequest; export type StartJobCommandOutput = StartJobResult & __MetadataBearer; +/** + *

Starts a new job for a branch of an Amplify app.

+ */ export class StartJobCommand extends $Command< StartJobCommandInput, StartJobCommandOutput, @@ -34,6 +37,9 @@ export class StartJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/StopJobCommand.ts b/clients/client-amplify/commands/StopJobCommand.ts index e6a67109b1084..9fafa428cbdd8 100644 --- a/clients/client-amplify/commands/StopJobCommand.ts +++ b/clients/client-amplify/commands/StopJobCommand.ts @@ -20,6 +20,9 @@ import { export type StopJobCommandInput = StopJobRequest; export type StopJobCommandOutput = StopJobResult & __MetadataBearer; +/** + *

Stops a job that is in progress for a branch of an Amplify app.

+ */ export class StopJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class StopJobCommand extends $Command, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/TagResourceCommand.ts b/clients/client-amplify/commands/TagResourceCommand.ts index 5d18166443289..15f9b78c83279 100644 --- a/clients/client-amplify/commands/TagResourceCommand.ts +++ b/clients/client-amplify/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Tags the resource with a tag key and value.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/UntagResourceCommand.ts b/clients/client-amplify/commands/UntagResourceCommand.ts index 2f99e59e6ac5b..0bf1270cc3154 100644 --- a/clients/client-amplify/commands/UntagResourceCommand.ts +++ b/clients/client-amplify/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Untags a resource with a specified Amazon Resource Name (ARN).

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/UpdateAppCommand.ts b/clients/client-amplify/commands/UpdateAppCommand.ts index 1098f42cc5b83..6d96c6a552f14 100644 --- a/clients/client-amplify/commands/UpdateAppCommand.ts +++ b/clients/client-amplify/commands/UpdateAppCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAppCommandInput = UpdateAppRequest; export type UpdateAppCommandOutput = UpdateAppResult & __MetadataBearer; +/** + *

Updates an existing Amplify app.

+ */ export class UpdateAppCommand extends $Command< UpdateAppCommandInput, UpdateAppCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/UpdateBranchCommand.ts b/clients/client-amplify/commands/UpdateBranchCommand.ts index 60d618706924a..d17aef810b005 100644 --- a/clients/client-amplify/commands/UpdateBranchCommand.ts +++ b/clients/client-amplify/commands/UpdateBranchCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateBranchCommandInput = UpdateBranchRequest; export type UpdateBranchCommandOutput = UpdateBranchResult & __MetadataBearer; +/** + *

Updates a branch for an Amplify app.

+ */ export class UpdateBranchCommand extends $Command< UpdateBranchCommandInput, UpdateBranchCommandOutput, @@ -34,6 +37,9 @@ export class UpdateBranchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/UpdateDomainAssociationCommand.ts b/clients/client-amplify/commands/UpdateDomainAssociationCommand.ts index 08e5888c15c06..217b1180d76e0 100644 --- a/clients/client-amplify/commands/UpdateDomainAssociationCommand.ts +++ b/clients/client-amplify/commands/UpdateDomainAssociationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDomainAssociationCommandInput = UpdateDomainAssociationRequest; export type UpdateDomainAssociationCommandOutput = UpdateDomainAssociationResult & __MetadataBearer; +/** + *

Creates a new domain association for an Amplify app.

+ */ export class UpdateDomainAssociationCommand extends $Command< UpdateDomainAssociationCommandInput, UpdateDomainAssociationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDomainAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/commands/UpdateWebhookCommand.ts b/clients/client-amplify/commands/UpdateWebhookCommand.ts index c9b0eaec9dc13..93fd54df3401a 100644 --- a/clients/client-amplify/commands/UpdateWebhookCommand.ts +++ b/clients/client-amplify/commands/UpdateWebhookCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateWebhookCommandInput = UpdateWebhookRequest; export type UpdateWebhookCommandOutput = UpdateWebhookResult & __MetadataBearer; +/** + *

Updates a webhook.

+ */ export class UpdateWebhookCommand extends $Command< UpdateWebhookCommandInput, UpdateWebhookCommandOutput, @@ -34,6 +37,9 @@ export class UpdateWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AmplifyClientResolvedConfig, diff --git a/clients/client-amplify/package.json b/clients/client-amplify/package.json index d9a2ea96fe4f0..5151926f1ee55 100644 --- a/clients/client-amplify/package.json +++ b/clients/client-amplify/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Amplify Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-amplify/runtimeConfig.browser.ts b/clients/client-amplify/runtimeConfig.browser.ts index 16cd600b5d6aa..83571a02912c0 100644 --- a/clients/client-amplify/runtimeConfig.browser.ts +++ b/clients/client-amplify/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AmplifyClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-amplify/runtimeConfig.native.ts b/clients/client-amplify/runtimeConfig.native.ts index e8bcac31500ca..67186c904256e 100644 --- a/clients/client-amplify/runtimeConfig.native.ts +++ b/clients/client-amplify/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AmplifyClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-amplify/runtimeConfig.shared.ts b/clients/client-amplify/runtimeConfig.shared.ts index e7d36219cebea..fa4781c1d0ddb 100644 --- a/clients/client-amplify/runtimeConfig.shared.ts +++ b/clients/client-amplify/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-25", disableHostPrefix: false, diff --git a/clients/client-amplify/runtimeConfig.ts b/clients/client-amplify/runtimeConfig.ts index b8547f1838a50..98bbb08b8ee35 100644 --- a/clients/client-amplify/runtimeConfig.ts +++ b/clients/client-amplify/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AmplifyClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-amplify/tsconfig.json b/clients/client-amplify/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-amplify/tsconfig.json +++ b/clients/client-amplify/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-api-gateway/commands/CreateApiKeyCommand.ts b/clients/client-api-gateway/commands/CreateApiKeyCommand.ts index 919367ba542a9..fe9f375b0d219 100644 --- a/clients/client-api-gateway/commands/CreateApiKeyCommand.ts +++ b/clients/client-api-gateway/commands/CreateApiKeyCommand.ts @@ -20,6 +20,10 @@ import { export type CreateApiKeyCommandInput = CreateApiKeyRequest; export type CreateApiKeyCommandOutput = ApiKey & __MetadataBearer; +/** + *

Create an ApiKey resource.

+ * + */ export class CreateApiKeyCommand extends $Command< CreateApiKeyCommandInput, CreateApiKeyCommandOutput, @@ -34,6 +38,9 @@ export class CreateApiKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateAuthorizerCommand.ts b/clients/client-api-gateway/commands/CreateAuthorizerCommand.ts index 9895be299d774..5a52f6d2a7d30 100644 --- a/clients/client-api-gateway/commands/CreateAuthorizerCommand.ts +++ b/clients/client-api-gateway/commands/CreateAuthorizerCommand.ts @@ -20,6 +20,10 @@ import { export type CreateAuthorizerCommandInput = CreateAuthorizerRequest; export type CreateAuthorizerCommandOutput = Authorizer & __MetadataBearer; +/** + *

Adds a new Authorizer resource to an existing RestApi resource.

+ * + */ export class CreateAuthorizerCommand extends $Command< CreateAuthorizerCommandInput, CreateAuthorizerCommandOutput, @@ -34,6 +38,9 @@ export class CreateAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateBasePathMappingCommand.ts b/clients/client-api-gateway/commands/CreateBasePathMappingCommand.ts index ad9b285334c13..af4256d928de8 100644 --- a/clients/client-api-gateway/commands/CreateBasePathMappingCommand.ts +++ b/clients/client-api-gateway/commands/CreateBasePathMappingCommand.ts @@ -20,6 +20,9 @@ import { export type CreateBasePathMappingCommandInput = CreateBasePathMappingRequest; export type CreateBasePathMappingCommandOutput = BasePathMapping & __MetadataBearer; +/** + *

Creates a new BasePathMapping resource.

+ */ export class CreateBasePathMappingCommand extends $Command< CreateBasePathMappingCommandInput, CreateBasePathMappingCommandOutput, @@ -34,6 +37,9 @@ export class CreateBasePathMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateDeploymentCommand.ts b/clients/client-api-gateway/commands/CreateDeploymentCommand.ts index 9c057a7634fb0..2465767fb3567 100644 --- a/clients/client-api-gateway/commands/CreateDeploymentCommand.ts +++ b/clients/client-api-gateway/commands/CreateDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDeploymentCommandInput = CreateDeploymentRequest; export type CreateDeploymentCommandOutput = Deployment & __MetadataBearer; +/** + *

Creates a Deployment resource, which makes a specified RestApi callable over the internet.

+ */ export class CreateDeploymentCommand extends $Command< CreateDeploymentCommandInput, CreateDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class CreateDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateDocumentationPartCommand.ts b/clients/client-api-gateway/commands/CreateDocumentationPartCommand.ts index ae6333058e8c8..8bf0636640c48 100644 --- a/clients/client-api-gateway/commands/CreateDocumentationPartCommand.ts +++ b/clients/client-api-gateway/commands/CreateDocumentationPartCommand.ts @@ -34,6 +34,9 @@ export class CreateDocumentationPartCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateDocumentationVersionCommand.ts b/clients/client-api-gateway/commands/CreateDocumentationVersionCommand.ts index 94fecd22551ed..009fb434f6e2e 100644 --- a/clients/client-api-gateway/commands/CreateDocumentationVersionCommand.ts +++ b/clients/client-api-gateway/commands/CreateDocumentationVersionCommand.ts @@ -34,6 +34,9 @@ export class CreateDocumentationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateDomainNameCommand.ts b/clients/client-api-gateway/commands/CreateDomainNameCommand.ts index e14b06689c12d..c115db0029bac 100644 --- a/clients/client-api-gateway/commands/CreateDomainNameCommand.ts +++ b/clients/client-api-gateway/commands/CreateDomainNameCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDomainNameCommandInput = CreateDomainNameRequest; export type CreateDomainNameCommandOutput = DomainName & __MetadataBearer; +/** + *

Creates a new domain name.

+ */ export class CreateDomainNameCommand extends $Command< CreateDomainNameCommandInput, CreateDomainNameCommandOutput, @@ -34,6 +37,9 @@ export class CreateDomainNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateModelCommand.ts b/clients/client-api-gateway/commands/CreateModelCommand.ts index 7d3fd6ff37131..da88cae3e6ef5 100644 --- a/clients/client-api-gateway/commands/CreateModelCommand.ts +++ b/clients/client-api-gateway/commands/CreateModelCommand.ts @@ -20,6 +20,9 @@ import { export type CreateModelCommandInput = CreateModelRequest; export type CreateModelCommandOutput = Model & __MetadataBearer; +/** + *

Adds a new Model resource to an existing RestApi resource.

+ */ export class CreateModelCommand extends $Command< CreateModelCommandInput, CreateModelCommandOutput, @@ -34,6 +37,9 @@ export class CreateModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateRequestValidatorCommand.ts b/clients/client-api-gateway/commands/CreateRequestValidatorCommand.ts index f9f8eff551fc9..9a6223aaa1682 100644 --- a/clients/client-api-gateway/commands/CreateRequestValidatorCommand.ts +++ b/clients/client-api-gateway/commands/CreateRequestValidatorCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRequestValidatorCommandInput = CreateRequestValidatorRequest; export type CreateRequestValidatorCommandOutput = RequestValidator & __MetadataBearer; +/** + *

Creates a ReqeustValidator of a given RestApi.

+ */ export class CreateRequestValidatorCommand extends $Command< CreateRequestValidatorCommandInput, CreateRequestValidatorCommandOutput, @@ -34,6 +37,9 @@ export class CreateRequestValidatorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateResourceCommand.ts b/clients/client-api-gateway/commands/CreateResourceCommand.ts index 72481c34d3876..d531c89bfb6d9 100644 --- a/clients/client-api-gateway/commands/CreateResourceCommand.ts +++ b/clients/client-api-gateway/commands/CreateResourceCommand.ts @@ -20,6 +20,9 @@ import { export type CreateResourceCommandInput = CreateResourceRequest; export type CreateResourceCommandOutput = Resource & __MetadataBearer; +/** + *

Creates a Resource resource.

+ */ export class CreateResourceCommand extends $Command< CreateResourceCommandInput, CreateResourceCommandOutput, @@ -34,6 +37,9 @@ export class CreateResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateRestApiCommand.ts b/clients/client-api-gateway/commands/CreateRestApiCommand.ts index 4d900be90af6d..d1f0edb779f2c 100644 --- a/clients/client-api-gateway/commands/CreateRestApiCommand.ts +++ b/clients/client-api-gateway/commands/CreateRestApiCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRestApiCommandInput = CreateRestApiRequest; export type CreateRestApiCommandOutput = RestApi & __MetadataBearer; +/** + *

Creates a new RestApi resource.

+ */ export class CreateRestApiCommand extends $Command< CreateRestApiCommandInput, CreateRestApiCommandOutput, @@ -34,6 +37,9 @@ export class CreateRestApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateStageCommand.ts b/clients/client-api-gateway/commands/CreateStageCommand.ts index 15434e51928f8..e499552a2ef08 100644 --- a/clients/client-api-gateway/commands/CreateStageCommand.ts +++ b/clients/client-api-gateway/commands/CreateStageCommand.ts @@ -20,6 +20,10 @@ import { export type CreateStageCommandInput = CreateStageRequest; export type CreateStageCommandOutput = Stage & __MetadataBearer; +/** + *

Creates a new Stage resource that references a pre-existing Deployment for the API.

+ * + */ export class CreateStageCommand extends $Command< CreateStageCommandInput, CreateStageCommandOutput, @@ -34,6 +38,9 @@ export class CreateStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateUsagePlanCommand.ts b/clients/client-api-gateway/commands/CreateUsagePlanCommand.ts index 819a0b4cff9da..4d171ca962a84 100644 --- a/clients/client-api-gateway/commands/CreateUsagePlanCommand.ts +++ b/clients/client-api-gateway/commands/CreateUsagePlanCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUsagePlanCommandInput = CreateUsagePlanRequest; export type CreateUsagePlanCommandOutput = UsagePlan & __MetadataBearer; +/** + *

Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload.

+ */ export class CreateUsagePlanCommand extends $Command< CreateUsagePlanCommandInput, CreateUsagePlanCommandOutput, @@ -34,6 +37,9 @@ export class CreateUsagePlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateUsagePlanKeyCommand.ts b/clients/client-api-gateway/commands/CreateUsagePlanKeyCommand.ts index 2a2c1c945776c..b7b6f3126a569 100644 --- a/clients/client-api-gateway/commands/CreateUsagePlanKeyCommand.ts +++ b/clients/client-api-gateway/commands/CreateUsagePlanKeyCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUsagePlanKeyCommandInput = CreateUsagePlanKeyRequest; export type CreateUsagePlanKeyCommandOutput = UsagePlanKey & __MetadataBearer; +/** + *

Creates a usage plan key for adding an existing API key to a usage plan.

+ */ export class CreateUsagePlanKeyCommand extends $Command< CreateUsagePlanKeyCommandInput, CreateUsagePlanKeyCommandOutput, @@ -34,6 +37,9 @@ export class CreateUsagePlanKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/CreateVpcLinkCommand.ts b/clients/client-api-gateway/commands/CreateVpcLinkCommand.ts index 1f22111017e2d..5e3c63363b33b 100644 --- a/clients/client-api-gateway/commands/CreateVpcLinkCommand.ts +++ b/clients/client-api-gateway/commands/CreateVpcLinkCommand.ts @@ -20,6 +20,9 @@ import { export type CreateVpcLinkCommandInput = CreateVpcLinkRequest; export type CreateVpcLinkCommandOutput = VpcLink & __MetadataBearer; +/** + *

Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational. The caller must have permissions to create and update VPC Endpoint services.

+ */ export class CreateVpcLinkCommand extends $Command< CreateVpcLinkCommandInput, CreateVpcLinkCommandOutput, @@ -34,6 +37,9 @@ export class CreateVpcLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteApiKeyCommand.ts b/clients/client-api-gateway/commands/DeleteApiKeyCommand.ts index 45a875f05567a..f0f8f20a40f51 100644 --- a/clients/client-api-gateway/commands/DeleteApiKeyCommand.ts +++ b/clients/client-api-gateway/commands/DeleteApiKeyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApiKeyCommandInput = DeleteApiKeyRequest; export type DeleteApiKeyCommandOutput = __MetadataBearer; +/** + *

Deletes the ApiKey resource.

+ */ export class DeleteApiKeyCommand extends $Command< DeleteApiKeyCommandInput, DeleteApiKeyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApiKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteAuthorizerCommand.ts b/clients/client-api-gateway/commands/DeleteAuthorizerCommand.ts index 9b408dbff453a..64f4e3c9eeb98 100644 --- a/clients/client-api-gateway/commands/DeleteAuthorizerCommand.ts +++ b/clients/client-api-gateway/commands/DeleteAuthorizerCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAuthorizerCommandInput = DeleteAuthorizerRequest; export type DeleteAuthorizerCommandOutput = __MetadataBearer; +/** + *

Deletes an existing Authorizer resource.

+ * + */ export class DeleteAuthorizerCommand extends $Command< DeleteAuthorizerCommandInput, DeleteAuthorizerCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteBasePathMappingCommand.ts b/clients/client-api-gateway/commands/DeleteBasePathMappingCommand.ts index 0d7090ede78e9..fc4d7bf646784 100644 --- a/clients/client-api-gateway/commands/DeleteBasePathMappingCommand.ts +++ b/clients/client-api-gateway/commands/DeleteBasePathMappingCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBasePathMappingCommandInput = DeleteBasePathMappingRequest; export type DeleteBasePathMappingCommandOutput = __MetadataBearer; +/** + *

Deletes the BasePathMapping resource.

+ */ export class DeleteBasePathMappingCommand extends $Command< DeleteBasePathMappingCommandInput, DeleteBasePathMappingCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBasePathMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteClientCertificateCommand.ts b/clients/client-api-gateway/commands/DeleteClientCertificateCommand.ts index 8138b7cf436b9..5cf89cb3bf0b4 100644 --- a/clients/client-api-gateway/commands/DeleteClientCertificateCommand.ts +++ b/clients/client-api-gateway/commands/DeleteClientCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteClientCertificateCommandInput = DeleteClientCertificateRequest; export type DeleteClientCertificateCommandOutput = __MetadataBearer; +/** + *

Deletes the ClientCertificate resource.

+ */ export class DeleteClientCertificateCommand extends $Command< DeleteClientCertificateCommandInput, DeleteClientCertificateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteClientCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteDeploymentCommand.ts b/clients/client-api-gateway/commands/DeleteDeploymentCommand.ts index 70bd3c1678e5d..dcf2929aeb99f 100644 --- a/clients/client-api-gateway/commands/DeleteDeploymentCommand.ts +++ b/clients/client-api-gateway/commands/DeleteDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDeploymentCommandInput = DeleteDeploymentRequest; export type DeleteDeploymentCommandOutput = __MetadataBearer; +/** + *

Deletes a Deployment resource. Deleting a deployment will only succeed if there are no Stage resources associated with it.

+ */ export class DeleteDeploymentCommand extends $Command< DeleteDeploymentCommandInput, DeleteDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteDocumentationPartCommand.ts b/clients/client-api-gateway/commands/DeleteDocumentationPartCommand.ts index 0ca229590ee26..83d3fa88fa21f 100644 --- a/clients/client-api-gateway/commands/DeleteDocumentationPartCommand.ts +++ b/clients/client-api-gateway/commands/DeleteDocumentationPartCommand.ts @@ -34,6 +34,9 @@ export class DeleteDocumentationPartCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteDocumentationVersionCommand.ts b/clients/client-api-gateway/commands/DeleteDocumentationVersionCommand.ts index 71265d801adc4..f23567ed6e6b4 100644 --- a/clients/client-api-gateway/commands/DeleteDocumentationVersionCommand.ts +++ b/clients/client-api-gateway/commands/DeleteDocumentationVersionCommand.ts @@ -34,6 +34,9 @@ export class DeleteDocumentationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteDomainNameCommand.ts b/clients/client-api-gateway/commands/DeleteDomainNameCommand.ts index 18e8f51a4b60c..12598a8710612 100644 --- a/clients/client-api-gateway/commands/DeleteDomainNameCommand.ts +++ b/clients/client-api-gateway/commands/DeleteDomainNameCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDomainNameCommandInput = DeleteDomainNameRequest; export type DeleteDomainNameCommandOutput = __MetadataBearer; +/** + *

Deletes the DomainName resource.

+ */ export class DeleteDomainNameCommand extends $Command< DeleteDomainNameCommandInput, DeleteDomainNameCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDomainNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteGatewayResponseCommand.ts b/clients/client-api-gateway/commands/DeleteGatewayResponseCommand.ts index fdcc8096a6ed0..c1d455c265336 100644 --- a/clients/client-api-gateway/commands/DeleteGatewayResponseCommand.ts +++ b/clients/client-api-gateway/commands/DeleteGatewayResponseCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGatewayResponseCommandInput = DeleteGatewayResponseRequest; export type DeleteGatewayResponseCommandOutput = __MetadataBearer; +/** + *

Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings.

+ */ export class DeleteGatewayResponseCommand extends $Command< DeleteGatewayResponseCommandInput, DeleteGatewayResponseCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGatewayResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteIntegrationCommand.ts b/clients/client-api-gateway/commands/DeleteIntegrationCommand.ts index f3610bf971e19..996923beb7d2a 100644 --- a/clients/client-api-gateway/commands/DeleteIntegrationCommand.ts +++ b/clients/client-api-gateway/commands/DeleteIntegrationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteIntegrationCommandInput = DeleteIntegrationRequest; export type DeleteIntegrationCommandOutput = __MetadataBearer; +/** + *

Represents a delete integration.

+ */ export class DeleteIntegrationCommand extends $Command< DeleteIntegrationCommandInput, DeleteIntegrationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteIntegrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteIntegrationResponseCommand.ts b/clients/client-api-gateway/commands/DeleteIntegrationResponseCommand.ts index a0fb2743f604c..b0415ddcc6ac3 100644 --- a/clients/client-api-gateway/commands/DeleteIntegrationResponseCommand.ts +++ b/clients/client-api-gateway/commands/DeleteIntegrationResponseCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteIntegrationResponseCommandInput = DeleteIntegrationResponseRequest; export type DeleteIntegrationResponseCommandOutput = __MetadataBearer; +/** + *

Represents a delete integration response.

+ */ export class DeleteIntegrationResponseCommand extends $Command< DeleteIntegrationResponseCommandInput, DeleteIntegrationResponseCommandOutput, @@ -34,6 +37,9 @@ export class DeleteIntegrationResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteMethodCommand.ts b/clients/client-api-gateway/commands/DeleteMethodCommand.ts index 984ab7d28f6f7..1323a9ba6edef 100644 --- a/clients/client-api-gateway/commands/DeleteMethodCommand.ts +++ b/clients/client-api-gateway/commands/DeleteMethodCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMethodCommandInput = DeleteMethodRequest; export type DeleteMethodCommandOutput = __MetadataBearer; +/** + *

Deletes an existing Method resource.

+ */ export class DeleteMethodCommand extends $Command< DeleteMethodCommandInput, DeleteMethodCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMethodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteMethodResponseCommand.ts b/clients/client-api-gateway/commands/DeleteMethodResponseCommand.ts index 9bfb04d433d90..3f6320ea7ae0c 100644 --- a/clients/client-api-gateway/commands/DeleteMethodResponseCommand.ts +++ b/clients/client-api-gateway/commands/DeleteMethodResponseCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMethodResponseCommandInput = DeleteMethodResponseRequest; export type DeleteMethodResponseCommandOutput = __MetadataBearer; +/** + *

Deletes an existing MethodResponse resource.

+ */ export class DeleteMethodResponseCommand extends $Command< DeleteMethodResponseCommandInput, DeleteMethodResponseCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMethodResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteModelCommand.ts b/clients/client-api-gateway/commands/DeleteModelCommand.ts index b9ea8e64d56fa..ad575f494f781 100644 --- a/clients/client-api-gateway/commands/DeleteModelCommand.ts +++ b/clients/client-api-gateway/commands/DeleteModelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteModelCommandInput = DeleteModelRequest; export type DeleteModelCommandOutput = __MetadataBearer; +/** + *

Deletes a model.

+ */ export class DeleteModelCommand extends $Command< DeleteModelCommandInput, DeleteModelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteRequestValidatorCommand.ts b/clients/client-api-gateway/commands/DeleteRequestValidatorCommand.ts index 904d8936294db..39af0569434f4 100644 --- a/clients/client-api-gateway/commands/DeleteRequestValidatorCommand.ts +++ b/clients/client-api-gateway/commands/DeleteRequestValidatorCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRequestValidatorCommandInput = DeleteRequestValidatorRequest; export type DeleteRequestValidatorCommandOutput = __MetadataBearer; +/** + *

Deletes a RequestValidator of a given RestApi.

+ */ export class DeleteRequestValidatorCommand extends $Command< DeleteRequestValidatorCommandInput, DeleteRequestValidatorCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRequestValidatorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteResourceCommand.ts b/clients/client-api-gateway/commands/DeleteResourceCommand.ts index 781c0552bfcd0..1d9b0d64aaca5 100644 --- a/clients/client-api-gateway/commands/DeleteResourceCommand.ts +++ b/clients/client-api-gateway/commands/DeleteResourceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourceCommandInput = DeleteResourceRequest; export type DeleteResourceCommandOutput = __MetadataBearer; +/** + *

Deletes a Resource resource.

+ */ export class DeleteResourceCommand extends $Command< DeleteResourceCommandInput, DeleteResourceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteRestApiCommand.ts b/clients/client-api-gateway/commands/DeleteRestApiCommand.ts index d1c74145752dc..19e9905bfe190 100644 --- a/clients/client-api-gateway/commands/DeleteRestApiCommand.ts +++ b/clients/client-api-gateway/commands/DeleteRestApiCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRestApiCommandInput = DeleteRestApiRequest; export type DeleteRestApiCommandOutput = __MetadataBearer; +/** + *

Deletes the specified API.

+ */ export class DeleteRestApiCommand extends $Command< DeleteRestApiCommandInput, DeleteRestApiCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRestApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteStageCommand.ts b/clients/client-api-gateway/commands/DeleteStageCommand.ts index cf27bde0cb8e6..8d8d0eab9b36a 100644 --- a/clients/client-api-gateway/commands/DeleteStageCommand.ts +++ b/clients/client-api-gateway/commands/DeleteStageCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteStageCommandInput = DeleteStageRequest; export type DeleteStageCommandOutput = __MetadataBearer; +/** + *

Deletes a Stage resource.

+ */ export class DeleteStageCommand extends $Command< DeleteStageCommandInput, DeleteStageCommandOutput, @@ -34,6 +37,9 @@ export class DeleteStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteUsagePlanCommand.ts b/clients/client-api-gateway/commands/DeleteUsagePlanCommand.ts index 8fb32e80f0c28..c927b7daccf12 100644 --- a/clients/client-api-gateway/commands/DeleteUsagePlanCommand.ts +++ b/clients/client-api-gateway/commands/DeleteUsagePlanCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUsagePlanCommandInput = DeleteUsagePlanRequest; export type DeleteUsagePlanCommandOutput = __MetadataBearer; +/** + *

Deletes a usage plan of a given plan Id.

+ */ export class DeleteUsagePlanCommand extends $Command< DeleteUsagePlanCommandInput, DeleteUsagePlanCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUsagePlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteUsagePlanKeyCommand.ts b/clients/client-api-gateway/commands/DeleteUsagePlanKeyCommand.ts index 8545a613e283b..1b1562910e813 100644 --- a/clients/client-api-gateway/commands/DeleteUsagePlanKeyCommand.ts +++ b/clients/client-api-gateway/commands/DeleteUsagePlanKeyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUsagePlanKeyCommandInput = DeleteUsagePlanKeyRequest; export type DeleteUsagePlanKeyCommandOutput = __MetadataBearer; +/** + *

Deletes a usage plan key and remove the underlying API key from the associated usage plan.

+ */ export class DeleteUsagePlanKeyCommand extends $Command< DeleteUsagePlanKeyCommandInput, DeleteUsagePlanKeyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUsagePlanKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/DeleteVpcLinkCommand.ts b/clients/client-api-gateway/commands/DeleteVpcLinkCommand.ts index 4f2f7c04a5a95..6ceadbd2dec98 100644 --- a/clients/client-api-gateway/commands/DeleteVpcLinkCommand.ts +++ b/clients/client-api-gateway/commands/DeleteVpcLinkCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVpcLinkCommandInput = DeleteVpcLinkRequest; export type DeleteVpcLinkCommandOutput = __MetadataBearer; +/** + *

Deletes an existing VpcLink of a specified identifier.

+ */ export class DeleteVpcLinkCommand extends $Command< DeleteVpcLinkCommandInput, DeleteVpcLinkCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVpcLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/FlushStageAuthorizersCacheCommand.ts b/clients/client-api-gateway/commands/FlushStageAuthorizersCacheCommand.ts index bc1a63a200bf1..4b2517406652e 100644 --- a/clients/client-api-gateway/commands/FlushStageAuthorizersCacheCommand.ts +++ b/clients/client-api-gateway/commands/FlushStageAuthorizersCacheCommand.ts @@ -20,6 +20,9 @@ import { export type FlushStageAuthorizersCacheCommandInput = FlushStageAuthorizersCacheRequest; export type FlushStageAuthorizersCacheCommandOutput = __MetadataBearer; +/** + *

Flushes all authorizer cache entries on a stage.

+ */ export class FlushStageAuthorizersCacheCommand extends $Command< FlushStageAuthorizersCacheCommandInput, FlushStageAuthorizersCacheCommandOutput, @@ -34,6 +37,9 @@ export class FlushStageAuthorizersCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/FlushStageCacheCommand.ts b/clients/client-api-gateway/commands/FlushStageCacheCommand.ts index 0d3b71b437db1..1b9cb6bbe2e10 100644 --- a/clients/client-api-gateway/commands/FlushStageCacheCommand.ts +++ b/clients/client-api-gateway/commands/FlushStageCacheCommand.ts @@ -20,6 +20,9 @@ import { export type FlushStageCacheCommandInput = FlushStageCacheRequest; export type FlushStageCacheCommandOutput = __MetadataBearer; +/** + *

Flushes a stage's cache.

+ */ export class FlushStageCacheCommand extends $Command< FlushStageCacheCommandInput, FlushStageCacheCommandOutput, @@ -34,6 +37,9 @@ export class FlushStageCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GenerateClientCertificateCommand.ts b/clients/client-api-gateway/commands/GenerateClientCertificateCommand.ts index 89d71ec903977..07b47014e771e 100644 --- a/clients/client-api-gateway/commands/GenerateClientCertificateCommand.ts +++ b/clients/client-api-gateway/commands/GenerateClientCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type GenerateClientCertificateCommandInput = GenerateClientCertificateRequest; export type GenerateClientCertificateCommandOutput = ClientCertificate & __MetadataBearer; +/** + *

Generates a ClientCertificate resource.

+ */ export class GenerateClientCertificateCommand extends $Command< GenerateClientCertificateCommandInput, GenerateClientCertificateCommandOutput, @@ -34,6 +37,9 @@ export class GenerateClientCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetAccountCommand.ts b/clients/client-api-gateway/commands/GetAccountCommand.ts index 8245dc6169ea5..3d1771c7a4928 100644 --- a/clients/client-api-gateway/commands/GetAccountCommand.ts +++ b/clients/client-api-gateway/commands/GetAccountCommand.ts @@ -20,6 +20,9 @@ import { export type GetAccountCommandInput = GetAccountRequest; export type GetAccountCommandOutput = Account & __MetadataBearer; +/** + *

Gets information about the current Account resource.

+ */ export class GetAccountCommand extends $Command< GetAccountCommandInput, GetAccountCommandOutput, @@ -34,6 +37,9 @@ export class GetAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetApiKeyCommand.ts b/clients/client-api-gateway/commands/GetApiKeyCommand.ts index 99fc65d6cdae4..8e8f4c35040a2 100644 --- a/clients/client-api-gateway/commands/GetApiKeyCommand.ts +++ b/clients/client-api-gateway/commands/GetApiKeyCommand.ts @@ -20,6 +20,9 @@ import { export type GetApiKeyCommandInput = GetApiKeyRequest; export type GetApiKeyCommandOutput = ApiKey & __MetadataBearer; +/** + *

Gets information about the current ApiKey resource.

+ */ export class GetApiKeyCommand extends $Command< GetApiKeyCommandInput, GetApiKeyCommandOutput, @@ -34,6 +37,9 @@ export class GetApiKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetApiKeysCommand.ts b/clients/client-api-gateway/commands/GetApiKeysCommand.ts index 0c911f3e4d3d9..3b042663b1a69 100644 --- a/clients/client-api-gateway/commands/GetApiKeysCommand.ts +++ b/clients/client-api-gateway/commands/GetApiKeysCommand.ts @@ -20,6 +20,9 @@ import { export type GetApiKeysCommandInput = GetApiKeysRequest; export type GetApiKeysCommandOutput = ApiKeys & __MetadataBearer; +/** + *

Gets information about the current ApiKeys resource.

+ */ export class GetApiKeysCommand extends $Command< GetApiKeysCommandInput, GetApiKeysCommandOutput, @@ -34,6 +37,9 @@ export class GetApiKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetAuthorizerCommand.ts b/clients/client-api-gateway/commands/GetAuthorizerCommand.ts index 1a13c789e44e6..afad33abf77c5 100644 --- a/clients/client-api-gateway/commands/GetAuthorizerCommand.ts +++ b/clients/client-api-gateway/commands/GetAuthorizerCommand.ts @@ -20,6 +20,10 @@ import { export type GetAuthorizerCommandInput = GetAuthorizerRequest; export type GetAuthorizerCommandOutput = Authorizer & __MetadataBearer; +/** + *

Describe an existing Authorizer resource.

+ * + */ export class GetAuthorizerCommand extends $Command< GetAuthorizerCommandInput, GetAuthorizerCommandOutput, @@ -34,6 +38,9 @@ export class GetAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetAuthorizersCommand.ts b/clients/client-api-gateway/commands/GetAuthorizersCommand.ts index 2c35eebee0d5e..129578398a67a 100644 --- a/clients/client-api-gateway/commands/GetAuthorizersCommand.ts +++ b/clients/client-api-gateway/commands/GetAuthorizersCommand.ts @@ -20,6 +20,10 @@ import { export type GetAuthorizersCommandInput = GetAuthorizersRequest; export type GetAuthorizersCommandOutput = Authorizers & __MetadataBearer; +/** + *

Describe an existing Authorizers resource.

+ * + */ export class GetAuthorizersCommand extends $Command< GetAuthorizersCommandInput, GetAuthorizersCommandOutput, @@ -34,6 +38,9 @@ export class GetAuthorizersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetBasePathMappingCommand.ts b/clients/client-api-gateway/commands/GetBasePathMappingCommand.ts index a6b9faed2af1a..ba5b10da0030b 100644 --- a/clients/client-api-gateway/commands/GetBasePathMappingCommand.ts +++ b/clients/client-api-gateway/commands/GetBasePathMappingCommand.ts @@ -20,6 +20,9 @@ import { export type GetBasePathMappingCommandInput = GetBasePathMappingRequest; export type GetBasePathMappingCommandOutput = BasePathMapping & __MetadataBearer; +/** + *

Describe a BasePathMapping resource.

+ */ export class GetBasePathMappingCommand extends $Command< GetBasePathMappingCommandInput, GetBasePathMappingCommandOutput, @@ -34,6 +37,9 @@ export class GetBasePathMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetBasePathMappingsCommand.ts b/clients/client-api-gateway/commands/GetBasePathMappingsCommand.ts index 4d5529498295c..e06fd11bbf560 100644 --- a/clients/client-api-gateway/commands/GetBasePathMappingsCommand.ts +++ b/clients/client-api-gateway/commands/GetBasePathMappingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetBasePathMappingsCommandInput = GetBasePathMappingsRequest; export type GetBasePathMappingsCommandOutput = BasePathMappings & __MetadataBearer; +/** + *

Represents a collection of BasePathMapping resources.

+ */ export class GetBasePathMappingsCommand extends $Command< GetBasePathMappingsCommandInput, GetBasePathMappingsCommandOutput, @@ -34,6 +37,9 @@ export class GetBasePathMappingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetClientCertificateCommand.ts b/clients/client-api-gateway/commands/GetClientCertificateCommand.ts index e339e6a8dca96..a4d2e805a45fe 100644 --- a/clients/client-api-gateway/commands/GetClientCertificateCommand.ts +++ b/clients/client-api-gateway/commands/GetClientCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type GetClientCertificateCommandInput = GetClientCertificateRequest; export type GetClientCertificateCommandOutput = ClientCertificate & __MetadataBearer; +/** + *

Gets information about the current ClientCertificate resource.

+ */ export class GetClientCertificateCommand extends $Command< GetClientCertificateCommandInput, GetClientCertificateCommandOutput, @@ -34,6 +37,9 @@ export class GetClientCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetClientCertificatesCommand.ts b/clients/client-api-gateway/commands/GetClientCertificatesCommand.ts index c6c66137168db..63b92b24506be 100644 --- a/clients/client-api-gateway/commands/GetClientCertificatesCommand.ts +++ b/clients/client-api-gateway/commands/GetClientCertificatesCommand.ts @@ -20,6 +20,9 @@ import { export type GetClientCertificatesCommandInput = GetClientCertificatesRequest; export type GetClientCertificatesCommandOutput = ClientCertificates & __MetadataBearer; +/** + *

Gets a collection of ClientCertificate resources.

+ */ export class GetClientCertificatesCommand extends $Command< GetClientCertificatesCommandInput, GetClientCertificatesCommandOutput, @@ -34,6 +37,9 @@ export class GetClientCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetDeploymentCommand.ts b/clients/client-api-gateway/commands/GetDeploymentCommand.ts index 87a252c97ba68..a782c3c4ae6e0 100644 --- a/clients/client-api-gateway/commands/GetDeploymentCommand.ts +++ b/clients/client-api-gateway/commands/GetDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentCommandInput = GetDeploymentRequest; export type GetDeploymentCommandOutput = Deployment & __MetadataBearer; +/** + *

Gets information about a Deployment resource.

+ */ export class GetDeploymentCommand extends $Command< GetDeploymentCommandInput, GetDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetDeploymentsCommand.ts b/clients/client-api-gateway/commands/GetDeploymentsCommand.ts index 42ca29b41621d..20e490662a508 100644 --- a/clients/client-api-gateway/commands/GetDeploymentsCommand.ts +++ b/clients/client-api-gateway/commands/GetDeploymentsCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentsCommandInput = GetDeploymentsRequest; export type GetDeploymentsCommandOutput = Deployments & __MetadataBearer; +/** + *

Gets information about a Deployments collection.

+ */ export class GetDeploymentsCommand extends $Command< GetDeploymentsCommandInput, GetDeploymentsCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetDocumentationPartCommand.ts b/clients/client-api-gateway/commands/GetDocumentationPartCommand.ts index fe0ccbd32f7b3..7bd37d55ab526 100644 --- a/clients/client-api-gateway/commands/GetDocumentationPartCommand.ts +++ b/clients/client-api-gateway/commands/GetDocumentationPartCommand.ts @@ -34,6 +34,9 @@ export class GetDocumentationPartCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetDocumentationPartsCommand.ts b/clients/client-api-gateway/commands/GetDocumentationPartsCommand.ts index 3f11a07ca733d..0c111d96b4b47 100644 --- a/clients/client-api-gateway/commands/GetDocumentationPartsCommand.ts +++ b/clients/client-api-gateway/commands/GetDocumentationPartsCommand.ts @@ -34,6 +34,9 @@ export class GetDocumentationPartsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetDocumentationVersionCommand.ts b/clients/client-api-gateway/commands/GetDocumentationVersionCommand.ts index cb2fe341dd044..81ee991f28904 100644 --- a/clients/client-api-gateway/commands/GetDocumentationVersionCommand.ts +++ b/clients/client-api-gateway/commands/GetDocumentationVersionCommand.ts @@ -34,6 +34,9 @@ export class GetDocumentationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetDocumentationVersionsCommand.ts b/clients/client-api-gateway/commands/GetDocumentationVersionsCommand.ts index 20f368bc4a0eb..621be7f2757d9 100644 --- a/clients/client-api-gateway/commands/GetDocumentationVersionsCommand.ts +++ b/clients/client-api-gateway/commands/GetDocumentationVersionsCommand.ts @@ -34,6 +34,9 @@ export class GetDocumentationVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetDomainNameCommand.ts b/clients/client-api-gateway/commands/GetDomainNameCommand.ts index 277094f62bc9c..1ef597daaa583 100644 --- a/clients/client-api-gateway/commands/GetDomainNameCommand.ts +++ b/clients/client-api-gateway/commands/GetDomainNameCommand.ts @@ -20,6 +20,9 @@ import { export type GetDomainNameCommandInput = GetDomainNameRequest; export type GetDomainNameCommandOutput = DomainName & __MetadataBearer; +/** + *

Represents a domain name that is contained in a simpler, more intuitive URL that can be called.

+ */ export class GetDomainNameCommand extends $Command< GetDomainNameCommandInput, GetDomainNameCommandOutput, @@ -34,6 +37,9 @@ export class GetDomainNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetDomainNamesCommand.ts b/clients/client-api-gateway/commands/GetDomainNamesCommand.ts index 1dad1f87174e3..5c250a98b52fe 100644 --- a/clients/client-api-gateway/commands/GetDomainNamesCommand.ts +++ b/clients/client-api-gateway/commands/GetDomainNamesCommand.ts @@ -20,6 +20,9 @@ import { export type GetDomainNamesCommandInput = GetDomainNamesRequest; export type GetDomainNamesCommandOutput = DomainNames & __MetadataBearer; +/** + *

Represents a collection of DomainName resources.

+ */ export class GetDomainNamesCommand extends $Command< GetDomainNamesCommandInput, GetDomainNamesCommandOutput, @@ -34,6 +37,9 @@ export class GetDomainNamesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetExportCommand.ts b/clients/client-api-gateway/commands/GetExportCommand.ts index f3bc8b0b0e484..aa728f464ae9f 100644 --- a/clients/client-api-gateway/commands/GetExportCommand.ts +++ b/clients/client-api-gateway/commands/GetExportCommand.ts @@ -20,6 +20,9 @@ import { export type GetExportCommandInput = GetExportRequest; export type GetExportCommandOutput = ExportResponse & __MetadataBearer; +/** + *

Exports a deployed version of a RestApi in a specified format.

+ */ export class GetExportCommand extends $Command< GetExportCommandInput, GetExportCommandOutput, @@ -34,6 +37,9 @@ export class GetExportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetGatewayResponseCommand.ts b/clients/client-api-gateway/commands/GetGatewayResponseCommand.ts index 5331423789ec2..6a43a9b2229a0 100644 --- a/clients/client-api-gateway/commands/GetGatewayResponseCommand.ts +++ b/clients/client-api-gateway/commands/GetGatewayResponseCommand.ts @@ -20,6 +20,9 @@ import { export type GetGatewayResponseCommandInput = GetGatewayResponseRequest; export type GetGatewayResponseCommandOutput = GatewayResponse & __MetadataBearer; +/** + *

Gets a GatewayResponse of a specified response type on the given RestApi.

+ */ export class GetGatewayResponseCommand extends $Command< GetGatewayResponseCommandInput, GetGatewayResponseCommandOutput, @@ -34,6 +37,9 @@ export class GetGatewayResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetGatewayResponsesCommand.ts b/clients/client-api-gateway/commands/GetGatewayResponsesCommand.ts index 04ed522421614..e0218e8c1e394 100644 --- a/clients/client-api-gateway/commands/GetGatewayResponsesCommand.ts +++ b/clients/client-api-gateway/commands/GetGatewayResponsesCommand.ts @@ -20,6 +20,9 @@ import { export type GetGatewayResponsesCommandInput = GetGatewayResponsesRequest; export type GetGatewayResponsesCommandOutput = GatewayResponses & __MetadataBearer; +/** + *

Gets the GatewayResponses collection on the given RestApi. If an API developer has not added any definitions for gateway responses, the result will be the API Gateway-generated default GatewayResponses collection for the supported response types.

+ */ export class GetGatewayResponsesCommand extends $Command< GetGatewayResponsesCommandInput, GetGatewayResponsesCommandOutput, @@ -34,6 +37,9 @@ export class GetGatewayResponsesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetIntegrationCommand.ts b/clients/client-api-gateway/commands/GetIntegrationCommand.ts index 4548c4dc3efd3..437a574344150 100644 --- a/clients/client-api-gateway/commands/GetIntegrationCommand.ts +++ b/clients/client-api-gateway/commands/GetIntegrationCommand.ts @@ -20,6 +20,9 @@ import { export type GetIntegrationCommandInput = GetIntegrationRequest; export type GetIntegrationCommandOutput = Integration & __MetadataBearer; +/** + *

Get the integration settings.

+ */ export class GetIntegrationCommand extends $Command< GetIntegrationCommandInput, GetIntegrationCommandOutput, @@ -34,6 +37,9 @@ export class GetIntegrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetIntegrationResponseCommand.ts b/clients/client-api-gateway/commands/GetIntegrationResponseCommand.ts index 460076748fa16..bc3114b665620 100644 --- a/clients/client-api-gateway/commands/GetIntegrationResponseCommand.ts +++ b/clients/client-api-gateway/commands/GetIntegrationResponseCommand.ts @@ -20,6 +20,9 @@ import { export type GetIntegrationResponseCommandInput = GetIntegrationResponseRequest; export type GetIntegrationResponseCommandOutput = IntegrationResponse & __MetadataBearer; +/** + *

Represents a get integration response.

+ */ export class GetIntegrationResponseCommand extends $Command< GetIntegrationResponseCommandInput, GetIntegrationResponseCommandOutput, @@ -34,6 +37,9 @@ export class GetIntegrationResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetMethodCommand.ts b/clients/client-api-gateway/commands/GetMethodCommand.ts index 8d43c32dc301a..52c8097b81b88 100644 --- a/clients/client-api-gateway/commands/GetMethodCommand.ts +++ b/clients/client-api-gateway/commands/GetMethodCommand.ts @@ -20,6 +20,9 @@ import { export type GetMethodCommandInput = GetMethodRequest; export type GetMethodCommandOutput = Method & __MetadataBearer; +/** + *

Describe an existing Method resource.

+ */ export class GetMethodCommand extends $Command< GetMethodCommandInput, GetMethodCommandOutput, @@ -34,6 +37,9 @@ export class GetMethodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetMethodResponseCommand.ts b/clients/client-api-gateway/commands/GetMethodResponseCommand.ts index 54a4bb2221aed..2c9841146579d 100644 --- a/clients/client-api-gateway/commands/GetMethodResponseCommand.ts +++ b/clients/client-api-gateway/commands/GetMethodResponseCommand.ts @@ -20,6 +20,9 @@ import { export type GetMethodResponseCommandInput = GetMethodResponseRequest; export type GetMethodResponseCommandOutput = MethodResponse & __MetadataBearer; +/** + *

Describes a MethodResponse resource.

+ */ export class GetMethodResponseCommand extends $Command< GetMethodResponseCommandInput, GetMethodResponseCommandOutput, @@ -34,6 +37,9 @@ export class GetMethodResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetModelCommand.ts b/clients/client-api-gateway/commands/GetModelCommand.ts index 020948da6860f..0ea0aca5fdf3e 100644 --- a/clients/client-api-gateway/commands/GetModelCommand.ts +++ b/clients/client-api-gateway/commands/GetModelCommand.ts @@ -20,6 +20,9 @@ import { export type GetModelCommandInput = GetModelRequest; export type GetModelCommandOutput = Model & __MetadataBearer; +/** + *

Describes an existing model defined for a RestApi resource.

+ */ export class GetModelCommand extends $Command< GetModelCommandInput, GetModelCommandOutput, @@ -34,6 +37,9 @@ export class GetModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetModelTemplateCommand.ts b/clients/client-api-gateway/commands/GetModelTemplateCommand.ts index 74bdbbd4f34f5..f7a96f23a5af8 100644 --- a/clients/client-api-gateway/commands/GetModelTemplateCommand.ts +++ b/clients/client-api-gateway/commands/GetModelTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetModelTemplateCommandInput = GetModelTemplateRequest; export type GetModelTemplateCommandOutput = Template & __MetadataBearer; +/** + *

Generates a sample mapping template that can be used to transform a payload into the structure of a model.

+ */ export class GetModelTemplateCommand extends $Command< GetModelTemplateCommandInput, GetModelTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetModelTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetModelsCommand.ts b/clients/client-api-gateway/commands/GetModelsCommand.ts index ca731454e3f4b..48c6ff280e4d9 100644 --- a/clients/client-api-gateway/commands/GetModelsCommand.ts +++ b/clients/client-api-gateway/commands/GetModelsCommand.ts @@ -20,6 +20,9 @@ import { export type GetModelsCommandInput = GetModelsRequest; export type GetModelsCommandOutput = Models & __MetadataBearer; +/** + *

Describes existing Models defined for a RestApi resource.

+ */ export class GetModelsCommand extends $Command< GetModelsCommandInput, GetModelsCommandOutput, @@ -34,6 +37,9 @@ export class GetModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetRequestValidatorCommand.ts b/clients/client-api-gateway/commands/GetRequestValidatorCommand.ts index 344a0cbb8c645..cbbb9ea3f0ea7 100644 --- a/clients/client-api-gateway/commands/GetRequestValidatorCommand.ts +++ b/clients/client-api-gateway/commands/GetRequestValidatorCommand.ts @@ -20,6 +20,9 @@ import { export type GetRequestValidatorCommandInput = GetRequestValidatorRequest; export type GetRequestValidatorCommandOutput = RequestValidator & __MetadataBearer; +/** + *

Gets a RequestValidator of a given RestApi.

+ */ export class GetRequestValidatorCommand extends $Command< GetRequestValidatorCommandInput, GetRequestValidatorCommandOutput, @@ -34,6 +37,9 @@ export class GetRequestValidatorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetRequestValidatorsCommand.ts b/clients/client-api-gateway/commands/GetRequestValidatorsCommand.ts index feed0d9f0ea1c..4fa5afa76cca7 100644 --- a/clients/client-api-gateway/commands/GetRequestValidatorsCommand.ts +++ b/clients/client-api-gateway/commands/GetRequestValidatorsCommand.ts @@ -20,6 +20,9 @@ import { export type GetRequestValidatorsCommandInput = GetRequestValidatorsRequest; export type GetRequestValidatorsCommandOutput = RequestValidators & __MetadataBearer; +/** + *

Gets the RequestValidators collection of a given RestApi.

+ */ export class GetRequestValidatorsCommand extends $Command< GetRequestValidatorsCommandInput, GetRequestValidatorsCommandOutput, @@ -34,6 +37,9 @@ export class GetRequestValidatorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetResourceCommand.ts b/clients/client-api-gateway/commands/GetResourceCommand.ts index cae74d906da7c..fe23a3011d429 100644 --- a/clients/client-api-gateway/commands/GetResourceCommand.ts +++ b/clients/client-api-gateway/commands/GetResourceCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourceCommandInput = GetResourceRequest; export type GetResourceCommandOutput = Resource & __MetadataBearer; +/** + *

Lists information about a resource.

+ */ export class GetResourceCommand extends $Command< GetResourceCommandInput, GetResourceCommandOutput, @@ -34,6 +37,9 @@ export class GetResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetResourcesCommand.ts b/clients/client-api-gateway/commands/GetResourcesCommand.ts index 27ba4f312dfa5..afb81eed04ade 100644 --- a/clients/client-api-gateway/commands/GetResourcesCommand.ts +++ b/clients/client-api-gateway/commands/GetResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourcesCommandInput = GetResourcesRequest; export type GetResourcesCommandOutput = Resources & __MetadataBearer; +/** + *

Lists information about a collection of Resource resources.

+ */ export class GetResourcesCommand extends $Command< GetResourcesCommandInput, GetResourcesCommandOutput, @@ -34,6 +37,9 @@ export class GetResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetRestApiCommand.ts b/clients/client-api-gateway/commands/GetRestApiCommand.ts index f2ace5553947f..071ab80b187e7 100644 --- a/clients/client-api-gateway/commands/GetRestApiCommand.ts +++ b/clients/client-api-gateway/commands/GetRestApiCommand.ts @@ -20,6 +20,9 @@ import { export type GetRestApiCommandInput = GetRestApiRequest; export type GetRestApiCommandOutput = RestApi & __MetadataBearer; +/** + *

Lists the RestApi resource in the collection.

+ */ export class GetRestApiCommand extends $Command< GetRestApiCommandInput, GetRestApiCommandOutput, @@ -34,6 +37,9 @@ export class GetRestApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetRestApisCommand.ts b/clients/client-api-gateway/commands/GetRestApisCommand.ts index e743430ac6dbc..8e4d5f6e4680b 100644 --- a/clients/client-api-gateway/commands/GetRestApisCommand.ts +++ b/clients/client-api-gateway/commands/GetRestApisCommand.ts @@ -20,6 +20,9 @@ import { export type GetRestApisCommandInput = GetRestApisRequest; export type GetRestApisCommandOutput = RestApis & __MetadataBearer; +/** + *

Lists the RestApis resources for your collection.

+ */ export class GetRestApisCommand extends $Command< GetRestApisCommandInput, GetRestApisCommandOutput, @@ -34,6 +37,9 @@ export class GetRestApisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetSdkCommand.ts b/clients/client-api-gateway/commands/GetSdkCommand.ts index a131274490a5b..ec04a9a79e2aa 100644 --- a/clients/client-api-gateway/commands/GetSdkCommand.ts +++ b/clients/client-api-gateway/commands/GetSdkCommand.ts @@ -17,6 +17,9 @@ import { export type GetSdkCommandInput = GetSdkRequest; export type GetSdkCommandOutput = SdkResponse & __MetadataBearer; +/** + *

Generates a client SDK for a RestApi and Stage.

+ */ export class GetSdkCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetSdkCommand extends $Command, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetSdkTypeCommand.ts b/clients/client-api-gateway/commands/GetSdkTypeCommand.ts index 07842013dcdf1..1dbe3870fd4d1 100644 --- a/clients/client-api-gateway/commands/GetSdkTypeCommand.ts +++ b/clients/client-api-gateway/commands/GetSdkTypeCommand.ts @@ -34,6 +34,9 @@ export class GetSdkTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetSdkTypesCommand.ts b/clients/client-api-gateway/commands/GetSdkTypesCommand.ts index 47d0de711b16f..8f130b2f6dc31 100644 --- a/clients/client-api-gateway/commands/GetSdkTypesCommand.ts +++ b/clients/client-api-gateway/commands/GetSdkTypesCommand.ts @@ -34,6 +34,9 @@ export class GetSdkTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetStageCommand.ts b/clients/client-api-gateway/commands/GetStageCommand.ts index 6970b946715df..87289d4afc59c 100644 --- a/clients/client-api-gateway/commands/GetStageCommand.ts +++ b/clients/client-api-gateway/commands/GetStageCommand.ts @@ -20,6 +20,9 @@ import { export type GetStageCommandInput = GetStageRequest; export type GetStageCommandOutput = Stage & __MetadataBearer; +/** + *

Gets information about a Stage resource.

+ */ export class GetStageCommand extends $Command< GetStageCommandInput, GetStageCommandOutput, @@ -34,6 +37,9 @@ export class GetStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetStagesCommand.ts b/clients/client-api-gateway/commands/GetStagesCommand.ts index 7c988acd35efc..ceaba7519732d 100644 --- a/clients/client-api-gateway/commands/GetStagesCommand.ts +++ b/clients/client-api-gateway/commands/GetStagesCommand.ts @@ -20,6 +20,9 @@ import { export type GetStagesCommandInput = GetStagesRequest; export type GetStagesCommandOutput = Stages & __MetadataBearer; +/** + *

Gets information about one or more Stage resources.

+ */ export class GetStagesCommand extends $Command< GetStagesCommandInput, GetStagesCommandOutput, @@ -34,6 +37,9 @@ export class GetStagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetTagsCommand.ts b/clients/client-api-gateway/commands/GetTagsCommand.ts index 40dcbae93efdd..abb8723d91ebe 100644 --- a/clients/client-api-gateway/commands/GetTagsCommand.ts +++ b/clients/client-api-gateway/commands/GetTagsCommand.ts @@ -20,6 +20,9 @@ import { export type GetTagsCommandInput = GetTagsRequest; export type GetTagsCommandOutput = Tags & __MetadataBearer; +/** + *

Gets the Tags collection for a given resource.

+ */ export class GetTagsCommand extends $Command< GetTagsCommandInput, GetTagsCommandOutput, @@ -34,6 +37,9 @@ export class GetTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetUsageCommand.ts b/clients/client-api-gateway/commands/GetUsageCommand.ts index b33c194e7c7fd..96635674775a1 100644 --- a/clients/client-api-gateway/commands/GetUsageCommand.ts +++ b/clients/client-api-gateway/commands/GetUsageCommand.ts @@ -20,6 +20,9 @@ import { export type GetUsageCommandInput = GetUsageRequest; export type GetUsageCommandOutput = Usage & __MetadataBearer; +/** + *

Gets the usage data of a usage plan in a specified time interval.

+ */ export class GetUsageCommand extends $Command< GetUsageCommandInput, GetUsageCommandOutput, @@ -34,6 +37,9 @@ export class GetUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetUsagePlanCommand.ts b/clients/client-api-gateway/commands/GetUsagePlanCommand.ts index a01d44818617d..d5a586a43e38e 100644 --- a/clients/client-api-gateway/commands/GetUsagePlanCommand.ts +++ b/clients/client-api-gateway/commands/GetUsagePlanCommand.ts @@ -20,6 +20,9 @@ import { export type GetUsagePlanCommandInput = GetUsagePlanRequest; export type GetUsagePlanCommandOutput = UsagePlan & __MetadataBearer; +/** + *

Gets a usage plan of a given plan identifier.

+ */ export class GetUsagePlanCommand extends $Command< GetUsagePlanCommandInput, GetUsagePlanCommandOutput, @@ -34,6 +37,9 @@ export class GetUsagePlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetUsagePlanKeyCommand.ts b/clients/client-api-gateway/commands/GetUsagePlanKeyCommand.ts index 8b99c39821e3f..0c088d8966a93 100644 --- a/clients/client-api-gateway/commands/GetUsagePlanKeyCommand.ts +++ b/clients/client-api-gateway/commands/GetUsagePlanKeyCommand.ts @@ -20,6 +20,9 @@ import { export type GetUsagePlanKeyCommandInput = GetUsagePlanKeyRequest; export type GetUsagePlanKeyCommandOutput = UsagePlanKey & __MetadataBearer; +/** + *

Gets a usage plan key of a given key identifier.

+ */ export class GetUsagePlanKeyCommand extends $Command< GetUsagePlanKeyCommandInput, GetUsagePlanKeyCommandOutput, @@ -34,6 +37,9 @@ export class GetUsagePlanKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetUsagePlanKeysCommand.ts b/clients/client-api-gateway/commands/GetUsagePlanKeysCommand.ts index 85fd82b3d81fa..6cfd64af454af 100644 --- a/clients/client-api-gateway/commands/GetUsagePlanKeysCommand.ts +++ b/clients/client-api-gateway/commands/GetUsagePlanKeysCommand.ts @@ -20,6 +20,9 @@ import { export type GetUsagePlanKeysCommandInput = GetUsagePlanKeysRequest; export type GetUsagePlanKeysCommandOutput = UsagePlanKeys & __MetadataBearer; +/** + *

Gets all the usage plan keys representing the API keys added to a specified usage plan.

+ */ export class GetUsagePlanKeysCommand extends $Command< GetUsagePlanKeysCommandInput, GetUsagePlanKeysCommandOutput, @@ -34,6 +37,9 @@ export class GetUsagePlanKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetUsagePlansCommand.ts b/clients/client-api-gateway/commands/GetUsagePlansCommand.ts index 9a8fbd4b139d4..b524860580af7 100644 --- a/clients/client-api-gateway/commands/GetUsagePlansCommand.ts +++ b/clients/client-api-gateway/commands/GetUsagePlansCommand.ts @@ -20,6 +20,9 @@ import { export type GetUsagePlansCommandInput = GetUsagePlansRequest; export type GetUsagePlansCommandOutput = UsagePlans & __MetadataBearer; +/** + *

Gets all the usage plans of the caller's account.

+ */ export class GetUsagePlansCommand extends $Command< GetUsagePlansCommandInput, GetUsagePlansCommandOutput, @@ -34,6 +37,9 @@ export class GetUsagePlansCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetVpcLinkCommand.ts b/clients/client-api-gateway/commands/GetVpcLinkCommand.ts index 7ca840e7fb589..829a3bbfc170e 100644 --- a/clients/client-api-gateway/commands/GetVpcLinkCommand.ts +++ b/clients/client-api-gateway/commands/GetVpcLinkCommand.ts @@ -20,6 +20,9 @@ import { export type GetVpcLinkCommandInput = GetVpcLinkRequest; export type GetVpcLinkCommandOutput = VpcLink & __MetadataBearer; +/** + *

Gets a specified VPC link under the caller's account in a region.

+ */ export class GetVpcLinkCommand extends $Command< GetVpcLinkCommandInput, GetVpcLinkCommandOutput, @@ -34,6 +37,9 @@ export class GetVpcLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/GetVpcLinksCommand.ts b/clients/client-api-gateway/commands/GetVpcLinksCommand.ts index ef536dac07edd..dfdd189a21a59 100644 --- a/clients/client-api-gateway/commands/GetVpcLinksCommand.ts +++ b/clients/client-api-gateway/commands/GetVpcLinksCommand.ts @@ -20,6 +20,9 @@ import { export type GetVpcLinksCommandInput = GetVpcLinksRequest; export type GetVpcLinksCommandOutput = VpcLinks & __MetadataBearer; +/** + *

Gets the VpcLinks collection under the caller's account in a selected region.

+ */ export class GetVpcLinksCommand extends $Command< GetVpcLinksCommandInput, GetVpcLinksCommandOutput, @@ -34,6 +37,9 @@ export class GetVpcLinksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/ImportApiKeysCommand.ts b/clients/client-api-gateway/commands/ImportApiKeysCommand.ts index 1b2b856fe056c..308f1c6ff68b7 100644 --- a/clients/client-api-gateway/commands/ImportApiKeysCommand.ts +++ b/clients/client-api-gateway/commands/ImportApiKeysCommand.ts @@ -20,6 +20,9 @@ import { export type ImportApiKeysCommandInput = ImportApiKeysRequest; export type ImportApiKeysCommandOutput = ApiKeyIds & __MetadataBearer; +/** + *

Import API keys from an external source, such as a CSV-formatted file.

+ */ export class ImportApiKeysCommand extends $Command< ImportApiKeysCommandInput, ImportApiKeysCommandOutput, @@ -34,6 +37,9 @@ export class ImportApiKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/ImportDocumentationPartsCommand.ts b/clients/client-api-gateway/commands/ImportDocumentationPartsCommand.ts index 2d29d1005dd52..17b1c8ba96278 100644 --- a/clients/client-api-gateway/commands/ImportDocumentationPartsCommand.ts +++ b/clients/client-api-gateway/commands/ImportDocumentationPartsCommand.ts @@ -34,6 +34,9 @@ export class ImportDocumentationPartsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/ImportRestApiCommand.ts b/clients/client-api-gateway/commands/ImportRestApiCommand.ts index a84482d782a50..adc271733d4e7 100644 --- a/clients/client-api-gateway/commands/ImportRestApiCommand.ts +++ b/clients/client-api-gateway/commands/ImportRestApiCommand.ts @@ -20,6 +20,9 @@ import { export type ImportRestApiCommandInput = ImportRestApiRequest; export type ImportRestApiCommandOutput = RestApi & __MetadataBearer; +/** + *

A feature of the API Gateway control service for creating a new API from an external API definition file.

+ */ export class ImportRestApiCommand extends $Command< ImportRestApiCommandInput, ImportRestApiCommandOutput, @@ -34,6 +37,9 @@ export class ImportRestApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/PutGatewayResponseCommand.ts b/clients/client-api-gateway/commands/PutGatewayResponseCommand.ts index b52a791f6648c..2eaf7f01bc4e0 100644 --- a/clients/client-api-gateway/commands/PutGatewayResponseCommand.ts +++ b/clients/client-api-gateway/commands/PutGatewayResponseCommand.ts @@ -20,6 +20,9 @@ import { export type PutGatewayResponseCommandInput = PutGatewayResponseRequest; export type PutGatewayResponseCommandOutput = GatewayResponse & __MetadataBearer; +/** + *

Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi.

+ */ export class PutGatewayResponseCommand extends $Command< PutGatewayResponseCommandInput, PutGatewayResponseCommandOutput, @@ -34,6 +37,9 @@ export class PutGatewayResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/PutIntegrationCommand.ts b/clients/client-api-gateway/commands/PutIntegrationCommand.ts index d9252a5f1b4a7..f9dd03dd5e294 100644 --- a/clients/client-api-gateway/commands/PutIntegrationCommand.ts +++ b/clients/client-api-gateway/commands/PutIntegrationCommand.ts @@ -20,6 +20,9 @@ import { export type PutIntegrationCommandInput = PutIntegrationRequest; export type PutIntegrationCommandOutput = Integration & __MetadataBearer; +/** + *

Sets up a method's integration.

+ */ export class PutIntegrationCommand extends $Command< PutIntegrationCommandInput, PutIntegrationCommandOutput, @@ -34,6 +37,9 @@ export class PutIntegrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/PutIntegrationResponseCommand.ts b/clients/client-api-gateway/commands/PutIntegrationResponseCommand.ts index 5e8a7dc30b4a5..9cb659eae48b1 100644 --- a/clients/client-api-gateway/commands/PutIntegrationResponseCommand.ts +++ b/clients/client-api-gateway/commands/PutIntegrationResponseCommand.ts @@ -20,6 +20,9 @@ import { export type PutIntegrationResponseCommandInput = PutIntegrationResponseRequest; export type PutIntegrationResponseCommandOutput = IntegrationResponse & __MetadataBearer; +/** + *

Represents a put integration.

+ */ export class PutIntegrationResponseCommand extends $Command< PutIntegrationResponseCommandInput, PutIntegrationResponseCommandOutput, @@ -34,6 +37,9 @@ export class PutIntegrationResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/PutMethodCommand.ts b/clients/client-api-gateway/commands/PutMethodCommand.ts index 66994bc555247..f0bb3038d285b 100644 --- a/clients/client-api-gateway/commands/PutMethodCommand.ts +++ b/clients/client-api-gateway/commands/PutMethodCommand.ts @@ -20,6 +20,9 @@ import { export type PutMethodCommandInput = PutMethodRequest; export type PutMethodCommandOutput = Method & __MetadataBearer; +/** + *

Add a method to an existing Resource resource.

+ */ export class PutMethodCommand extends $Command< PutMethodCommandInput, PutMethodCommandOutput, @@ -34,6 +37,9 @@ export class PutMethodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/PutMethodResponseCommand.ts b/clients/client-api-gateway/commands/PutMethodResponseCommand.ts index 810e352227ac1..16fafb0d8a9dc 100644 --- a/clients/client-api-gateway/commands/PutMethodResponseCommand.ts +++ b/clients/client-api-gateway/commands/PutMethodResponseCommand.ts @@ -20,6 +20,9 @@ import { export type PutMethodResponseCommandInput = PutMethodResponseRequest; export type PutMethodResponseCommandOutput = MethodResponse & __MetadataBearer; +/** + *

Adds a MethodResponse to an existing Method resource.

+ */ export class PutMethodResponseCommand extends $Command< PutMethodResponseCommandInput, PutMethodResponseCommandOutput, @@ -34,6 +37,9 @@ export class PutMethodResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/PutRestApiCommand.ts b/clients/client-api-gateway/commands/PutRestApiCommand.ts index 147e34a0638d8..0a5cd957ee1cc 100644 --- a/clients/client-api-gateway/commands/PutRestApiCommand.ts +++ b/clients/client-api-gateway/commands/PutRestApiCommand.ts @@ -20,6 +20,10 @@ import { export type PutRestApiCommandInput = PutRestApiRequest; export type PutRestApiCommandOutput = RestApi & __MetadataBearer; +/** + *

A feature of the API Gateway control service for updating an existing API with an input of external API definitions. + * The update can take the form of merging the supplied definition into the existing API or overwriting the existing API.

+ */ export class PutRestApiCommand extends $Command< PutRestApiCommandInput, PutRestApiCommandOutput, @@ -34,6 +38,9 @@ export class PutRestApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/TagResourceCommand.ts b/clients/client-api-gateway/commands/TagResourceCommand.ts index 1d349fa68ea1e..14d85c0b426b3 100644 --- a/clients/client-api-gateway/commands/TagResourceCommand.ts +++ b/clients/client-api-gateway/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds or updates a tag on a given resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/TestInvokeAuthorizerCommand.ts b/clients/client-api-gateway/commands/TestInvokeAuthorizerCommand.ts index 0e5fd593b4679..5e2158d6793ef 100644 --- a/clients/client-api-gateway/commands/TestInvokeAuthorizerCommand.ts +++ b/clients/client-api-gateway/commands/TestInvokeAuthorizerCommand.ts @@ -20,6 +20,13 @@ import { export type TestInvokeAuthorizerCommandInput = TestInvokeAuthorizerRequest; export type TestInvokeAuthorizerCommandOutput = TestInvokeAuthorizerResponse & __MetadataBearer; +/** + *

Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body.

+ * + */ export class TestInvokeAuthorizerCommand extends $Command< TestInvokeAuthorizerCommandInput, TestInvokeAuthorizerCommandOutput, @@ -34,6 +41,9 @@ export class TestInvokeAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/TestInvokeMethodCommand.ts b/clients/client-api-gateway/commands/TestInvokeMethodCommand.ts index 0d3619071cb05..5887c489a3edc 100644 --- a/clients/client-api-gateway/commands/TestInvokeMethodCommand.ts +++ b/clients/client-api-gateway/commands/TestInvokeMethodCommand.ts @@ -20,6 +20,9 @@ import { export type TestInvokeMethodCommandInput = TestInvokeMethodRequest; export type TestInvokeMethodCommandOutput = TestInvokeMethodResponse & __MetadataBearer; +/** + *

Simulate the execution of a Method in your RestApi with headers, parameters, and an incoming request body.

+ */ export class TestInvokeMethodCommand extends $Command< TestInvokeMethodCommandInput, TestInvokeMethodCommandOutput, @@ -34,6 +37,9 @@ export class TestInvokeMethodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UntagResourceCommand.ts b/clients/client-api-gateway/commands/UntagResourceCommand.ts index e284f88239430..0e04925403134 100644 --- a/clients/client-api-gateway/commands/UntagResourceCommand.ts +++ b/clients/client-api-gateway/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes a tag from a given resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateAccountCommand.ts b/clients/client-api-gateway/commands/UpdateAccountCommand.ts index 4df2bf4fb4dfb..8a985a6c36541 100644 --- a/clients/client-api-gateway/commands/UpdateAccountCommand.ts +++ b/clients/client-api-gateway/commands/UpdateAccountCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAccountCommandInput = UpdateAccountRequest; export type UpdateAccountCommandOutput = Account & __MetadataBearer; +/** + *

Changes information about the current Account resource.

+ */ export class UpdateAccountCommand extends $Command< UpdateAccountCommandInput, UpdateAccountCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateApiKeyCommand.ts b/clients/client-api-gateway/commands/UpdateApiKeyCommand.ts index 9a10116771c3d..de21ae43b3d35 100644 --- a/clients/client-api-gateway/commands/UpdateApiKeyCommand.ts +++ b/clients/client-api-gateway/commands/UpdateApiKeyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApiKeyCommandInput = UpdateApiKeyRequest; export type UpdateApiKeyCommandOutput = ApiKey & __MetadataBearer; +/** + *

Changes information about an ApiKey resource.

+ */ export class UpdateApiKeyCommand extends $Command< UpdateApiKeyCommandInput, UpdateApiKeyCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApiKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateAuthorizerCommand.ts b/clients/client-api-gateway/commands/UpdateAuthorizerCommand.ts index 80d4ee70cd3de..db683cc7ee089 100644 --- a/clients/client-api-gateway/commands/UpdateAuthorizerCommand.ts +++ b/clients/client-api-gateway/commands/UpdateAuthorizerCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateAuthorizerCommandInput = UpdateAuthorizerRequest; export type UpdateAuthorizerCommandOutput = Authorizer & __MetadataBearer; +/** + *

Updates an existing Authorizer resource.

+ * + */ export class UpdateAuthorizerCommand extends $Command< UpdateAuthorizerCommandInput, UpdateAuthorizerCommandOutput, @@ -34,6 +38,9 @@ export class UpdateAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateBasePathMappingCommand.ts b/clients/client-api-gateway/commands/UpdateBasePathMappingCommand.ts index 02a14f8e5d89b..b070dde901d71 100644 --- a/clients/client-api-gateway/commands/UpdateBasePathMappingCommand.ts +++ b/clients/client-api-gateway/commands/UpdateBasePathMappingCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateBasePathMappingCommandInput = UpdateBasePathMappingRequest; export type UpdateBasePathMappingCommandOutput = BasePathMapping & __MetadataBearer; +/** + *

Changes information about the BasePathMapping resource.

+ */ export class UpdateBasePathMappingCommand extends $Command< UpdateBasePathMappingCommandInput, UpdateBasePathMappingCommandOutput, @@ -34,6 +37,9 @@ export class UpdateBasePathMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateClientCertificateCommand.ts b/clients/client-api-gateway/commands/UpdateClientCertificateCommand.ts index 13346e3de792e..abf3f513e01a8 100644 --- a/clients/client-api-gateway/commands/UpdateClientCertificateCommand.ts +++ b/clients/client-api-gateway/commands/UpdateClientCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateClientCertificateCommandInput = UpdateClientCertificateRequest; export type UpdateClientCertificateCommandOutput = ClientCertificate & __MetadataBearer; +/** + *

Changes information about an ClientCertificate resource.

+ */ export class UpdateClientCertificateCommand extends $Command< UpdateClientCertificateCommandInput, UpdateClientCertificateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateClientCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateDeploymentCommand.ts b/clients/client-api-gateway/commands/UpdateDeploymentCommand.ts index 140078596a197..9500abc9c84df 100644 --- a/clients/client-api-gateway/commands/UpdateDeploymentCommand.ts +++ b/clients/client-api-gateway/commands/UpdateDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDeploymentCommandInput = UpdateDeploymentRequest; export type UpdateDeploymentCommandOutput = Deployment & __MetadataBearer; +/** + *

Changes information about a Deployment resource.

+ */ export class UpdateDeploymentCommand extends $Command< UpdateDeploymentCommandInput, UpdateDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateDocumentationPartCommand.ts b/clients/client-api-gateway/commands/UpdateDocumentationPartCommand.ts index 9fad53133e100..dab547c4eed7d 100644 --- a/clients/client-api-gateway/commands/UpdateDocumentationPartCommand.ts +++ b/clients/client-api-gateway/commands/UpdateDocumentationPartCommand.ts @@ -34,6 +34,9 @@ export class UpdateDocumentationPartCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateDocumentationVersionCommand.ts b/clients/client-api-gateway/commands/UpdateDocumentationVersionCommand.ts index 84c87ee037df5..11be9205c0d14 100644 --- a/clients/client-api-gateway/commands/UpdateDocumentationVersionCommand.ts +++ b/clients/client-api-gateway/commands/UpdateDocumentationVersionCommand.ts @@ -34,6 +34,9 @@ export class UpdateDocumentationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateDomainNameCommand.ts b/clients/client-api-gateway/commands/UpdateDomainNameCommand.ts index 12d662d44d09e..c759c75144e2b 100644 --- a/clients/client-api-gateway/commands/UpdateDomainNameCommand.ts +++ b/clients/client-api-gateway/commands/UpdateDomainNameCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDomainNameCommandInput = UpdateDomainNameRequest; export type UpdateDomainNameCommandOutput = DomainName & __MetadataBearer; +/** + *

Changes information about the DomainName resource.

+ */ export class UpdateDomainNameCommand extends $Command< UpdateDomainNameCommandInput, UpdateDomainNameCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDomainNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateGatewayResponseCommand.ts b/clients/client-api-gateway/commands/UpdateGatewayResponseCommand.ts index 631c700d48c67..fa01f3a086db8 100644 --- a/clients/client-api-gateway/commands/UpdateGatewayResponseCommand.ts +++ b/clients/client-api-gateway/commands/UpdateGatewayResponseCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGatewayResponseCommandInput = UpdateGatewayResponseRequest; export type UpdateGatewayResponseCommandOutput = GatewayResponse & __MetadataBearer; +/** + *

Updates a GatewayResponse of a specified response type on the given RestApi.

+ */ export class UpdateGatewayResponseCommand extends $Command< UpdateGatewayResponseCommandInput, UpdateGatewayResponseCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGatewayResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateIntegrationCommand.ts b/clients/client-api-gateway/commands/UpdateIntegrationCommand.ts index a9458f9a04ec9..1389af759baa8 100644 --- a/clients/client-api-gateway/commands/UpdateIntegrationCommand.ts +++ b/clients/client-api-gateway/commands/UpdateIntegrationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateIntegrationCommandInput = UpdateIntegrationRequest; export type UpdateIntegrationCommandOutput = Integration & __MetadataBearer; +/** + *

Represents an update integration.

+ */ export class UpdateIntegrationCommand extends $Command< UpdateIntegrationCommandInput, UpdateIntegrationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateIntegrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateIntegrationResponseCommand.ts b/clients/client-api-gateway/commands/UpdateIntegrationResponseCommand.ts index 2d37c4b2f76b6..fd09e80199991 100644 --- a/clients/client-api-gateway/commands/UpdateIntegrationResponseCommand.ts +++ b/clients/client-api-gateway/commands/UpdateIntegrationResponseCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateIntegrationResponseCommandInput = UpdateIntegrationResponseRequest; export type UpdateIntegrationResponseCommandOutput = IntegrationResponse & __MetadataBearer; +/** + *

Represents an update integration response.

+ */ export class UpdateIntegrationResponseCommand extends $Command< UpdateIntegrationResponseCommandInput, UpdateIntegrationResponseCommandOutput, @@ -34,6 +37,9 @@ export class UpdateIntegrationResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateMethodCommand.ts b/clients/client-api-gateway/commands/UpdateMethodCommand.ts index 8577104d8f240..105a05d79b83e 100644 --- a/clients/client-api-gateway/commands/UpdateMethodCommand.ts +++ b/clients/client-api-gateway/commands/UpdateMethodCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMethodCommandInput = UpdateMethodRequest; export type UpdateMethodCommandOutput = Method & __MetadataBearer; +/** + *

Updates an existing Method resource.

+ */ export class UpdateMethodCommand extends $Command< UpdateMethodCommandInput, UpdateMethodCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMethodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateMethodResponseCommand.ts b/clients/client-api-gateway/commands/UpdateMethodResponseCommand.ts index 418088c284632..4287f629e0f7d 100644 --- a/clients/client-api-gateway/commands/UpdateMethodResponseCommand.ts +++ b/clients/client-api-gateway/commands/UpdateMethodResponseCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMethodResponseCommandInput = UpdateMethodResponseRequest; export type UpdateMethodResponseCommandOutput = MethodResponse & __MetadataBearer; +/** + *

Updates an existing MethodResponse resource.

+ */ export class UpdateMethodResponseCommand extends $Command< UpdateMethodResponseCommandInput, UpdateMethodResponseCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMethodResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateModelCommand.ts b/clients/client-api-gateway/commands/UpdateModelCommand.ts index 61eda2f0c5c79..56cdc8ce38eaa 100644 --- a/clients/client-api-gateway/commands/UpdateModelCommand.ts +++ b/clients/client-api-gateway/commands/UpdateModelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateModelCommandInput = UpdateModelRequest; export type UpdateModelCommandOutput = Model & __MetadataBearer; +/** + *

Changes information about a model.

+ */ export class UpdateModelCommand extends $Command< UpdateModelCommandInput, UpdateModelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateRequestValidatorCommand.ts b/clients/client-api-gateway/commands/UpdateRequestValidatorCommand.ts index 419672c1493fa..cac2ad927ee75 100644 --- a/clients/client-api-gateway/commands/UpdateRequestValidatorCommand.ts +++ b/clients/client-api-gateway/commands/UpdateRequestValidatorCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRequestValidatorCommandInput = UpdateRequestValidatorRequest; export type UpdateRequestValidatorCommandOutput = RequestValidator & __MetadataBearer; +/** + *

Updates a RequestValidator of a given RestApi.

+ */ export class UpdateRequestValidatorCommand extends $Command< UpdateRequestValidatorCommandInput, UpdateRequestValidatorCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRequestValidatorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateResourceCommand.ts b/clients/client-api-gateway/commands/UpdateResourceCommand.ts index 47f5b27bd5711..3606caf6ce1bc 100644 --- a/clients/client-api-gateway/commands/UpdateResourceCommand.ts +++ b/clients/client-api-gateway/commands/UpdateResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateResourceCommandInput = UpdateResourceRequest; export type UpdateResourceCommandOutput = Resource & __MetadataBearer; +/** + *

Changes information about a Resource resource.

+ */ export class UpdateResourceCommand extends $Command< UpdateResourceCommandInput, UpdateResourceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateRestApiCommand.ts b/clients/client-api-gateway/commands/UpdateRestApiCommand.ts index 5585820acee48..030e8fc262248 100644 --- a/clients/client-api-gateway/commands/UpdateRestApiCommand.ts +++ b/clients/client-api-gateway/commands/UpdateRestApiCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRestApiCommandInput = UpdateRestApiRequest; export type UpdateRestApiCommandOutput = RestApi & __MetadataBearer; +/** + *

Changes information about the specified API.

+ */ export class UpdateRestApiCommand extends $Command< UpdateRestApiCommandInput, UpdateRestApiCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRestApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateStageCommand.ts b/clients/client-api-gateway/commands/UpdateStageCommand.ts index 1625e8bbaec79..508abf8020ca7 100644 --- a/clients/client-api-gateway/commands/UpdateStageCommand.ts +++ b/clients/client-api-gateway/commands/UpdateStageCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateStageCommandInput = UpdateStageRequest; export type UpdateStageCommandOutput = Stage & __MetadataBearer; +/** + *

Changes information about a Stage resource.

+ */ export class UpdateStageCommand extends $Command< UpdateStageCommandInput, UpdateStageCommandOutput, @@ -34,6 +37,9 @@ export class UpdateStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateUsageCommand.ts b/clients/client-api-gateway/commands/UpdateUsageCommand.ts index 10f75ed5879bc..c9f78b89e7fe9 100644 --- a/clients/client-api-gateway/commands/UpdateUsageCommand.ts +++ b/clients/client-api-gateway/commands/UpdateUsageCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUsageCommandInput = UpdateUsageRequest; export type UpdateUsageCommandOutput = Usage & __MetadataBearer; +/** + *

Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key.

+ */ export class UpdateUsageCommand extends $Command< UpdateUsageCommandInput, UpdateUsageCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateUsagePlanCommand.ts b/clients/client-api-gateway/commands/UpdateUsagePlanCommand.ts index 5523fe80fb16d..5731a272f652f 100644 --- a/clients/client-api-gateway/commands/UpdateUsagePlanCommand.ts +++ b/clients/client-api-gateway/commands/UpdateUsagePlanCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUsagePlanCommandInput = UpdateUsagePlanRequest; export type UpdateUsagePlanCommandOutput = UsagePlan & __MetadataBearer; +/** + *

Updates a usage plan of a given plan Id.

+ */ export class UpdateUsagePlanCommand extends $Command< UpdateUsagePlanCommandInput, UpdateUsagePlanCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUsagePlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/commands/UpdateVpcLinkCommand.ts b/clients/client-api-gateway/commands/UpdateVpcLinkCommand.ts index 9c60631de55bd..86f8c77020896 100644 --- a/clients/client-api-gateway/commands/UpdateVpcLinkCommand.ts +++ b/clients/client-api-gateway/commands/UpdateVpcLinkCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVpcLinkCommandInput = UpdateVpcLinkRequest; export type UpdateVpcLinkCommandOutput = VpcLink & __MetadataBearer; +/** + *

Updates an existing VpcLink of a specified identifier.

+ */ export class UpdateVpcLinkCommand extends $Command< UpdateVpcLinkCommandInput, UpdateVpcLinkCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVpcLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: APIGatewayClientResolvedConfig, diff --git a/clients/client-api-gateway/package.json b/clients/client-api-gateway/package.json index df22cd94223e6..f27db1a902238 100644 --- a/clients/client-api-gateway/package.json +++ b/clients/client-api-gateway/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Api Gateway Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-api-gateway/pagination/GetApiKeysPaginator.ts b/clients/client-api-gateway/pagination/GetApiKeysPaginator.ts index 34b183771d85e..c3bd424130001 100644 --- a/clients/client-api-gateway/pagination/GetApiKeysPaginator.ts +++ b/clients/client-api-gateway/pagination/GetApiKeysPaginator.ts @@ -4,6 +4,9 @@ import { GetApiKeysCommand, GetApiKeysCommandInput, GetApiKeysCommandOutput } fr import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetApiKeysCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetApiKeysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetApiKeysCommandInput, diff --git a/clients/client-api-gateway/pagination/GetBasePathMappingsPaginator.ts b/clients/client-api-gateway/pagination/GetBasePathMappingsPaginator.ts index 9089e25b2e9a8..db1792f1ac578 100644 --- a/clients/client-api-gateway/pagination/GetBasePathMappingsPaginator.ts +++ b/clients/client-api-gateway/pagination/GetBasePathMappingsPaginator.ts @@ -8,6 +8,9 @@ import { import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetBasePathMappingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetBasePathMappingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetBasePathMappingsCommandInput, diff --git a/clients/client-api-gateway/pagination/GetClientCertificatesPaginator.ts b/clients/client-api-gateway/pagination/GetClientCertificatesPaginator.ts index e9ee93a886054..1f639b72b8930 100644 --- a/clients/client-api-gateway/pagination/GetClientCertificatesPaginator.ts +++ b/clients/client-api-gateway/pagination/GetClientCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetClientCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetClientCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetClientCertificatesCommandInput, diff --git a/clients/client-api-gateway/pagination/GetDeploymentsPaginator.ts b/clients/client-api-gateway/pagination/GetDeploymentsPaginator.ts index 523401582fb2a..bca10c66b84fe 100644 --- a/clients/client-api-gateway/pagination/GetDeploymentsPaginator.ts +++ b/clients/client-api-gateway/pagination/GetDeploymentsPaginator.ts @@ -8,6 +8,9 @@ import { import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetDeploymentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDeploymentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetDeploymentsCommandInput, diff --git a/clients/client-api-gateway/pagination/GetDomainNamesPaginator.ts b/clients/client-api-gateway/pagination/GetDomainNamesPaginator.ts index d266d16b9a22c..17def51d4b229 100644 --- a/clients/client-api-gateway/pagination/GetDomainNamesPaginator.ts +++ b/clients/client-api-gateway/pagination/GetDomainNamesPaginator.ts @@ -8,6 +8,9 @@ import { import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetDomainNamesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDomainNamesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetDomainNamesCommandInput, diff --git a/clients/client-api-gateway/pagination/GetModelsPaginator.ts b/clients/client-api-gateway/pagination/GetModelsPaginator.ts index 8a2ad920bde67..43a075ef57dab 100644 --- a/clients/client-api-gateway/pagination/GetModelsPaginator.ts +++ b/clients/client-api-gateway/pagination/GetModelsPaginator.ts @@ -4,6 +4,9 @@ import { GetModelsCommand, GetModelsCommandInput, GetModelsCommandOutput } from import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetModelsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetModelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetModelsCommandInput, diff --git a/clients/client-api-gateway/pagination/GetResourcesPaginator.ts b/clients/client-api-gateway/pagination/GetResourcesPaginator.ts index c4fed67a028d4..c3c038b5ce041 100644 --- a/clients/client-api-gateway/pagination/GetResourcesPaginator.ts +++ b/clients/client-api-gateway/pagination/GetResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetResourcesCommandInput, diff --git a/clients/client-api-gateway/pagination/GetRestApisPaginator.ts b/clients/client-api-gateway/pagination/GetRestApisPaginator.ts index 0e57452d857a9..2a70e58ef0ee8 100644 --- a/clients/client-api-gateway/pagination/GetRestApisPaginator.ts +++ b/clients/client-api-gateway/pagination/GetRestApisPaginator.ts @@ -4,6 +4,9 @@ import { GetRestApisCommand, GetRestApisCommandInput, GetRestApisCommandOutput } import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetRestApisCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetRestApisCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetRestApisCommandInput, diff --git a/clients/client-api-gateway/pagination/GetUsagePaginator.ts b/clients/client-api-gateway/pagination/GetUsagePaginator.ts index 4779d85072976..6a396e6e35f21 100644 --- a/clients/client-api-gateway/pagination/GetUsagePaginator.ts +++ b/clients/client-api-gateway/pagination/GetUsagePaginator.ts @@ -4,6 +4,9 @@ import { GetUsageCommand, GetUsageCommandInput, GetUsageCommandOutput } from ".. import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetUsageCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetUsageCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetUsageCommandInput, diff --git a/clients/client-api-gateway/pagination/GetUsagePlanKeysPaginator.ts b/clients/client-api-gateway/pagination/GetUsagePlanKeysPaginator.ts index f01180ed593b1..abf5333bb9d83 100644 --- a/clients/client-api-gateway/pagination/GetUsagePlanKeysPaginator.ts +++ b/clients/client-api-gateway/pagination/GetUsagePlanKeysPaginator.ts @@ -8,6 +8,9 @@ import { import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetUsagePlanKeysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetUsagePlanKeysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetUsagePlanKeysCommandInput, diff --git a/clients/client-api-gateway/pagination/GetUsagePlansPaginator.ts b/clients/client-api-gateway/pagination/GetUsagePlansPaginator.ts index 809613a290fad..46e44f7771b1b 100644 --- a/clients/client-api-gateway/pagination/GetUsagePlansPaginator.ts +++ b/clients/client-api-gateway/pagination/GetUsagePlansPaginator.ts @@ -8,6 +8,9 @@ import { import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetUsagePlansCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetUsagePlansCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetUsagePlansCommandInput, diff --git a/clients/client-api-gateway/pagination/GetVpcLinksPaginator.ts b/clients/client-api-gateway/pagination/GetVpcLinksPaginator.ts index 93a7bc6887f76..06205729f0bbd 100644 --- a/clients/client-api-gateway/pagination/GetVpcLinksPaginator.ts +++ b/clients/client-api-gateway/pagination/GetVpcLinksPaginator.ts @@ -4,6 +4,9 @@ import { GetVpcLinksCommand, GetVpcLinksCommandInput, GetVpcLinksCommandOutput } import { APIGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: APIGatewayClient, input: GetVpcLinksCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetVpcLinksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: APIGateway, input: GetVpcLinksCommandInput, diff --git a/clients/client-api-gateway/runtimeConfig.browser.ts b/clients/client-api-gateway/runtimeConfig.browser.ts index 67cae97709128..c2ab16b9ce7dc 100644 --- a/clients/client-api-gateway/runtimeConfig.browser.ts +++ b/clients/client-api-gateway/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./APIGatewayClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-api-gateway/runtimeConfig.native.ts b/clients/client-api-gateway/runtimeConfig.native.ts index 30c57fce9f645..09bcef62e9075 100644 --- a/clients/client-api-gateway/runtimeConfig.native.ts +++ b/clients/client-api-gateway/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./APIGatewayClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-api-gateway/runtimeConfig.shared.ts b/clients/client-api-gateway/runtimeConfig.shared.ts index f16dc07866512..9ae6361ca7540 100644 --- a/clients/client-api-gateway/runtimeConfig.shared.ts +++ b/clients/client-api-gateway/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-07-09", disableHostPrefix: false, diff --git a/clients/client-api-gateway/runtimeConfig.ts b/clients/client-api-gateway/runtimeConfig.ts index 72ea186180b01..ab7c57f926a2a 100644 --- a/clients/client-api-gateway/runtimeConfig.ts +++ b/clients/client-api-gateway/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./APIGatewayClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-api-gateway/tsconfig.json b/clients/client-api-gateway/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-api-gateway/tsconfig.json +++ b/clients/client-api-gateway/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-apigatewaymanagementapi/commands/DeleteConnectionCommand.ts b/clients/client-apigatewaymanagementapi/commands/DeleteConnectionCommand.ts index 267ca23c05f6f..14657c9c67d32 100644 --- a/clients/client-apigatewaymanagementapi/commands/DeleteConnectionCommand.ts +++ b/clients/client-apigatewaymanagementapi/commands/DeleteConnectionCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteConnectionCommandInput = DeleteConnectionRequest; export type DeleteConnectionCommandOutput = __MetadataBearer; +/** + *

Delete the connection with the provided id.

+ */ export class DeleteConnectionCommand extends $Command< DeleteConnectionCommandInput, DeleteConnectionCommandOutput, @@ -38,6 +41,9 @@ export class DeleteConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayManagementApiClientResolvedConfig, diff --git a/clients/client-apigatewaymanagementapi/commands/GetConnectionCommand.ts b/clients/client-apigatewaymanagementapi/commands/GetConnectionCommand.ts index 274f31dbe8f86..312640bb4f9c5 100644 --- a/clients/client-apigatewaymanagementapi/commands/GetConnectionCommand.ts +++ b/clients/client-apigatewaymanagementapi/commands/GetConnectionCommand.ts @@ -24,6 +24,9 @@ import { export type GetConnectionCommandInput = GetConnectionRequest; export type GetConnectionCommandOutput = GetConnectionResponse & __MetadataBearer; +/** + *

Get information about the connection with the provided id.

+ */ export class GetConnectionCommand extends $Command< GetConnectionCommandInput, GetConnectionCommandOutput, @@ -38,6 +41,9 @@ export class GetConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayManagementApiClientResolvedConfig, diff --git a/clients/client-apigatewaymanagementapi/commands/PostToConnectionCommand.ts b/clients/client-apigatewaymanagementapi/commands/PostToConnectionCommand.ts index 432f42e360711..e4cd2b23ee79b 100644 --- a/clients/client-apigatewaymanagementapi/commands/PostToConnectionCommand.ts +++ b/clients/client-apigatewaymanagementapi/commands/PostToConnectionCommand.ts @@ -24,6 +24,9 @@ import { export type PostToConnectionCommandInput = PostToConnectionRequest; export type PostToConnectionCommandOutput = __MetadataBearer; +/** + *

Sends the provided data to the specified connection.

+ */ export class PostToConnectionCommand extends $Command< PostToConnectionCommandInput, PostToConnectionCommandOutput, @@ -38,6 +41,9 @@ export class PostToConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayManagementApiClientResolvedConfig, diff --git a/clients/client-apigatewaymanagementapi/package.json b/clients/client-apigatewaymanagementapi/package.json index a7e2a84c3bd5e..b65824c3ac3c3 100644 --- a/clients/client-apigatewaymanagementapi/package.json +++ b/clients/client-apigatewaymanagementapi/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Apigatewaymanagementapi Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-apigatewaymanagementapi/runtimeConfig.browser.ts b/clients/client-apigatewaymanagementapi/runtimeConfig.browser.ts index a6d6bd30b40cd..c126ce3c0f8b8 100644 --- a/clients/client-apigatewaymanagementapi/runtimeConfig.browser.ts +++ b/clients/client-apigatewaymanagementapi/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ApiGatewayManagementApiClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-apigatewaymanagementapi/runtimeConfig.native.ts b/clients/client-apigatewaymanagementapi/runtimeConfig.native.ts index 055228f8b8de0..7230ad03c35ba 100644 --- a/clients/client-apigatewaymanagementapi/runtimeConfig.native.ts +++ b/clients/client-apigatewaymanagementapi/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ApiGatewayManagementApiClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-apigatewaymanagementapi/runtimeConfig.shared.ts b/clients/client-apigatewaymanagementapi/runtimeConfig.shared.ts index 9ebee5b1f3042..ff3b108101b8d 100644 --- a/clients/client-apigatewaymanagementapi/runtimeConfig.shared.ts +++ b/clients/client-apigatewaymanagementapi/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-29", disableHostPrefix: false, diff --git a/clients/client-apigatewaymanagementapi/runtimeConfig.ts b/clients/client-apigatewaymanagementapi/runtimeConfig.ts index ec7eb691b7d24..feb00fe0763d1 100644 --- a/clients/client-apigatewaymanagementapi/runtimeConfig.ts +++ b/clients/client-apigatewaymanagementapi/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ApiGatewayManagementApiClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-apigatewaymanagementapi/tsconfig.json b/clients/client-apigatewaymanagementapi/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-apigatewaymanagementapi/tsconfig.json +++ b/clients/client-apigatewaymanagementapi/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-apigatewayv2/commands/CreateApiCommand.ts b/clients/client-apigatewayv2/commands/CreateApiCommand.ts index 3185beb947812..bcdd63fa84f2a 100644 --- a/clients/client-apigatewayv2/commands/CreateApiCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateApiCommand.ts @@ -20,6 +20,9 @@ import { export type CreateApiCommandInput = CreateApiRequest; export type CreateApiCommandOutput = CreateApiResponse & __MetadataBearer; +/** + *

Creates an Api resource.

+ */ export class CreateApiCommand extends $Command< CreateApiCommandInput, CreateApiCommandOutput, @@ -34,6 +37,9 @@ export class CreateApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateApiMappingCommand.ts b/clients/client-apigatewayv2/commands/CreateApiMappingCommand.ts index db40c67325723..25d79df0cdd06 100644 --- a/clients/client-apigatewayv2/commands/CreateApiMappingCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateApiMappingCommand.ts @@ -20,6 +20,9 @@ import { export type CreateApiMappingCommandInput = CreateApiMappingRequest; export type CreateApiMappingCommandOutput = CreateApiMappingResponse & __MetadataBearer; +/** + *

Creates an API mapping.

+ */ export class CreateApiMappingCommand extends $Command< CreateApiMappingCommandInput, CreateApiMappingCommandOutput, @@ -34,6 +37,9 @@ export class CreateApiMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateAuthorizerCommand.ts b/clients/client-apigatewayv2/commands/CreateAuthorizerCommand.ts index 8632fc4a4e974..681fbd89afb7b 100644 --- a/clients/client-apigatewayv2/commands/CreateAuthorizerCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAuthorizerCommandInput = CreateAuthorizerRequest; export type CreateAuthorizerCommandOutput = CreateAuthorizerResponse & __MetadataBearer; +/** + *

Creates an Authorizer for an API.

+ */ export class CreateAuthorizerCommand extends $Command< CreateAuthorizerCommandInput, CreateAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class CreateAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateDeploymentCommand.ts b/clients/client-apigatewayv2/commands/CreateDeploymentCommand.ts index a3b837d2cce6f..b857f9e0eb5ba 100644 --- a/clients/client-apigatewayv2/commands/CreateDeploymentCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDeploymentCommandInput = CreateDeploymentRequest; export type CreateDeploymentCommandOutput = CreateDeploymentResponse & __MetadataBearer; +/** + *

Creates a Deployment for an API.

+ */ export class CreateDeploymentCommand extends $Command< CreateDeploymentCommandInput, CreateDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class CreateDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateDomainNameCommand.ts b/clients/client-apigatewayv2/commands/CreateDomainNameCommand.ts index 1c4eb8899b403..a298a81b1f71b 100644 --- a/clients/client-apigatewayv2/commands/CreateDomainNameCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateDomainNameCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDomainNameCommandInput = CreateDomainNameRequest; export type CreateDomainNameCommandOutput = CreateDomainNameResponse & __MetadataBearer; +/** + *

Creates a domain name.

+ */ export class CreateDomainNameCommand extends $Command< CreateDomainNameCommandInput, CreateDomainNameCommandOutput, @@ -34,6 +37,9 @@ export class CreateDomainNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateIntegrationCommand.ts b/clients/client-apigatewayv2/commands/CreateIntegrationCommand.ts index 3789d5f35a71f..0c77f233621ce 100644 --- a/clients/client-apigatewayv2/commands/CreateIntegrationCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateIntegrationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateIntegrationCommandInput = CreateIntegrationRequest; export type CreateIntegrationCommandOutput = CreateIntegrationResult & __MetadataBearer; +/** + *

Creates an Integration.

+ */ export class CreateIntegrationCommand extends $Command< CreateIntegrationCommandInput, CreateIntegrationCommandOutput, @@ -34,6 +37,9 @@ export class CreateIntegrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateIntegrationResponseCommand.ts b/clients/client-apigatewayv2/commands/CreateIntegrationResponseCommand.ts index 77492c0283cb6..d195599cbd6f2 100644 --- a/clients/client-apigatewayv2/commands/CreateIntegrationResponseCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateIntegrationResponseCommand.ts @@ -20,6 +20,9 @@ import { export type CreateIntegrationResponseCommandInput = CreateIntegrationResponseRequest; export type CreateIntegrationResponseCommandOutput = CreateIntegrationResponseResponse & __MetadataBearer; +/** + *

Creates an IntegrationResponses.

+ */ export class CreateIntegrationResponseCommand extends $Command< CreateIntegrationResponseCommandInput, CreateIntegrationResponseCommandOutput, @@ -34,6 +37,9 @@ export class CreateIntegrationResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateModelCommand.ts b/clients/client-apigatewayv2/commands/CreateModelCommand.ts index 505fefa399f8e..15867e3bd6b8a 100644 --- a/clients/client-apigatewayv2/commands/CreateModelCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateModelCommand.ts @@ -20,6 +20,9 @@ import { export type CreateModelCommandInput = CreateModelRequest; export type CreateModelCommandOutput = CreateModelResponse & __MetadataBearer; +/** + *

Creates a Model for an API.

+ */ export class CreateModelCommand extends $Command< CreateModelCommandInput, CreateModelCommandOutput, @@ -34,6 +37,9 @@ export class CreateModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateRouteCommand.ts b/clients/client-apigatewayv2/commands/CreateRouteCommand.ts index edcd74065de50..c04af5ccc77c7 100644 --- a/clients/client-apigatewayv2/commands/CreateRouteCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateRouteCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRouteCommandInput = CreateRouteRequest; export type CreateRouteCommandOutput = CreateRouteResult & __MetadataBearer; +/** + *

Creates a Route for an API.

+ */ export class CreateRouteCommand extends $Command< CreateRouteCommandInput, CreateRouteCommandOutput, @@ -34,6 +37,9 @@ export class CreateRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateRouteResponseCommand.ts b/clients/client-apigatewayv2/commands/CreateRouteResponseCommand.ts index daeb5e1bbb481..a99fc63fa0736 100644 --- a/clients/client-apigatewayv2/commands/CreateRouteResponseCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateRouteResponseCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRouteResponseCommandInput = CreateRouteResponseRequest; export type CreateRouteResponseCommandOutput = CreateRouteResponseResponse & __MetadataBearer; +/** + *

Creates a RouteResponse for a Route.

+ */ export class CreateRouteResponseCommand extends $Command< CreateRouteResponseCommandInput, CreateRouteResponseCommandOutput, @@ -34,6 +37,9 @@ export class CreateRouteResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateStageCommand.ts b/clients/client-apigatewayv2/commands/CreateStageCommand.ts index 45b10f184a49f..4eea18c05e9dd 100644 --- a/clients/client-apigatewayv2/commands/CreateStageCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateStageCommand.ts @@ -20,6 +20,9 @@ import { export type CreateStageCommandInput = CreateStageRequest; export type CreateStageCommandOutput = CreateStageResponse & __MetadataBearer; +/** + *

Creates a Stage for an API.

+ */ export class CreateStageCommand extends $Command< CreateStageCommandInput, CreateStageCommandOutput, @@ -34,6 +37,9 @@ export class CreateStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/CreateVpcLinkCommand.ts b/clients/client-apigatewayv2/commands/CreateVpcLinkCommand.ts index 4aae9609077af..56a448dd18aaf 100644 --- a/clients/client-apigatewayv2/commands/CreateVpcLinkCommand.ts +++ b/clients/client-apigatewayv2/commands/CreateVpcLinkCommand.ts @@ -20,6 +20,9 @@ import { export type CreateVpcLinkCommandInput = CreateVpcLinkRequest; export type CreateVpcLinkCommandOutput = CreateVpcLinkResponse & __MetadataBearer; +/** + *

Creates a VPC link.

+ */ export class CreateVpcLinkCommand extends $Command< CreateVpcLinkCommandInput, CreateVpcLinkCommandOutput, @@ -34,6 +37,9 @@ export class CreateVpcLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteAccessLogSettingsCommand.ts b/clients/client-apigatewayv2/commands/DeleteAccessLogSettingsCommand.ts index ff83b86ec43a3..f77112690d509 100644 --- a/clients/client-apigatewayv2/commands/DeleteAccessLogSettingsCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteAccessLogSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAccessLogSettingsCommandInput = DeleteAccessLogSettingsRequest; export type DeleteAccessLogSettingsCommandOutput = __MetadataBearer; +/** + *

Deletes the AccessLogSettings for a Stage. To disable access logging for a Stage, delete its AccessLogSettings.

+ */ export class DeleteAccessLogSettingsCommand extends $Command< DeleteAccessLogSettingsCommandInput, DeleteAccessLogSettingsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAccessLogSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteApiCommand.ts b/clients/client-apigatewayv2/commands/DeleteApiCommand.ts index 1bb4838dcecd1..4ece0fcd36c53 100644 --- a/clients/client-apigatewayv2/commands/DeleteApiCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteApiCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApiCommandInput = DeleteApiRequest; export type DeleteApiCommandOutput = __MetadataBearer; +/** + *

Deletes an Api resource.

+ */ export class DeleteApiCommand extends $Command< DeleteApiCommandInput, DeleteApiCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteApiMappingCommand.ts b/clients/client-apigatewayv2/commands/DeleteApiMappingCommand.ts index c14e36b04b72b..36f5d9262f71b 100644 --- a/clients/client-apigatewayv2/commands/DeleteApiMappingCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteApiMappingCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApiMappingCommandInput = DeleteApiMappingRequest; export type DeleteApiMappingCommandOutput = __MetadataBearer; +/** + *

Deletes an API mapping.

+ */ export class DeleteApiMappingCommand extends $Command< DeleteApiMappingCommandInput, DeleteApiMappingCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApiMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteAuthorizerCommand.ts b/clients/client-apigatewayv2/commands/DeleteAuthorizerCommand.ts index 6ba1b1290b0e4..4f851b196f977 100644 --- a/clients/client-apigatewayv2/commands/DeleteAuthorizerCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAuthorizerCommandInput = DeleteAuthorizerRequest; export type DeleteAuthorizerCommandOutput = __MetadataBearer; +/** + *

Deletes an Authorizer.

+ */ export class DeleteAuthorizerCommand extends $Command< DeleteAuthorizerCommandInput, DeleteAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteCorsConfigurationCommand.ts b/clients/client-apigatewayv2/commands/DeleteCorsConfigurationCommand.ts index addbbeb4db86e..46177ef1a85ea 100644 --- a/clients/client-apigatewayv2/commands/DeleteCorsConfigurationCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteCorsConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCorsConfigurationCommandInput = DeleteCorsConfigurationRequest; export type DeleteCorsConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes a CORS configuration.

+ */ export class DeleteCorsConfigurationCommand extends $Command< DeleteCorsConfigurationCommandInput, DeleteCorsConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCorsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteDeploymentCommand.ts b/clients/client-apigatewayv2/commands/DeleteDeploymentCommand.ts index 37695ee6b7d12..07fc17761ff1d 100644 --- a/clients/client-apigatewayv2/commands/DeleteDeploymentCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDeploymentCommandInput = DeleteDeploymentRequest; export type DeleteDeploymentCommandOutput = __MetadataBearer; +/** + *

Deletes a Deployment.

+ */ export class DeleteDeploymentCommand extends $Command< DeleteDeploymentCommandInput, DeleteDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteDomainNameCommand.ts b/clients/client-apigatewayv2/commands/DeleteDomainNameCommand.ts index e24ae731c3f51..1540045e596c7 100644 --- a/clients/client-apigatewayv2/commands/DeleteDomainNameCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteDomainNameCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDomainNameCommandInput = DeleteDomainNameRequest; export type DeleteDomainNameCommandOutput = __MetadataBearer; +/** + *

Deletes a domain name.

+ */ export class DeleteDomainNameCommand extends $Command< DeleteDomainNameCommandInput, DeleteDomainNameCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDomainNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteIntegrationCommand.ts b/clients/client-apigatewayv2/commands/DeleteIntegrationCommand.ts index a0a4c8c27a8ba..ec78eba54e8fa 100644 --- a/clients/client-apigatewayv2/commands/DeleteIntegrationCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteIntegrationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteIntegrationCommandInput = DeleteIntegrationRequest; export type DeleteIntegrationCommandOutput = __MetadataBearer; +/** + *

Deletes an Integration.

+ */ export class DeleteIntegrationCommand extends $Command< DeleteIntegrationCommandInput, DeleteIntegrationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteIntegrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteIntegrationResponseCommand.ts b/clients/client-apigatewayv2/commands/DeleteIntegrationResponseCommand.ts index d4d8cc8d8e4d3..62403b75816f8 100644 --- a/clients/client-apigatewayv2/commands/DeleteIntegrationResponseCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteIntegrationResponseCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteIntegrationResponseCommandInput = DeleteIntegrationResponseRequest; export type DeleteIntegrationResponseCommandOutput = __MetadataBearer; +/** + *

Deletes an IntegrationResponses.

+ */ export class DeleteIntegrationResponseCommand extends $Command< DeleteIntegrationResponseCommandInput, DeleteIntegrationResponseCommandOutput, @@ -34,6 +37,9 @@ export class DeleteIntegrationResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteModelCommand.ts b/clients/client-apigatewayv2/commands/DeleteModelCommand.ts index c08ce9927b3fb..9b2bcb8783f08 100644 --- a/clients/client-apigatewayv2/commands/DeleteModelCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteModelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteModelCommandInput = DeleteModelRequest; export type DeleteModelCommandOutput = __MetadataBearer; +/** + *

Deletes a Model.

+ */ export class DeleteModelCommand extends $Command< DeleteModelCommandInput, DeleteModelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteRouteCommand.ts b/clients/client-apigatewayv2/commands/DeleteRouteCommand.ts index 3183e6de0b720..24ed930611ff4 100644 --- a/clients/client-apigatewayv2/commands/DeleteRouteCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteRouteCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRouteCommandInput = DeleteRouteRequest; export type DeleteRouteCommandOutput = __MetadataBearer; +/** + *

Deletes a Route.

+ */ export class DeleteRouteCommand extends $Command< DeleteRouteCommandInput, DeleteRouteCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteRouteRequestParameterCommand.ts b/clients/client-apigatewayv2/commands/DeleteRouteRequestParameterCommand.ts index 654753741a05a..1f97264dde5cd 100644 --- a/clients/client-apigatewayv2/commands/DeleteRouteRequestParameterCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteRouteRequestParameterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRouteRequestParameterCommandInput = DeleteRouteRequestParameterRequest; export type DeleteRouteRequestParameterCommandOutput = __MetadataBearer; +/** + *

Deletes a route request parameter.

+ */ export class DeleteRouteRequestParameterCommand extends $Command< DeleteRouteRequestParameterCommandInput, DeleteRouteRequestParameterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRouteRequestParameterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteRouteResponseCommand.ts b/clients/client-apigatewayv2/commands/DeleteRouteResponseCommand.ts index bfcf9b149eba1..302f3db3ef799 100644 --- a/clients/client-apigatewayv2/commands/DeleteRouteResponseCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteRouteResponseCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRouteResponseCommandInput = DeleteRouteResponseRequest; export type DeleteRouteResponseCommandOutput = __MetadataBearer; +/** + *

Deletes a RouteResponse.

+ */ export class DeleteRouteResponseCommand extends $Command< DeleteRouteResponseCommandInput, DeleteRouteResponseCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRouteResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteRouteSettingsCommand.ts b/clients/client-apigatewayv2/commands/DeleteRouteSettingsCommand.ts index d00ee352c67ea..b5feac9875c45 100644 --- a/clients/client-apigatewayv2/commands/DeleteRouteSettingsCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteRouteSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRouteSettingsCommandInput = DeleteRouteSettingsRequest; export type DeleteRouteSettingsCommandOutput = __MetadataBearer; +/** + *

Deletes the RouteSettings for a stage.

+ */ export class DeleteRouteSettingsCommand extends $Command< DeleteRouteSettingsCommandInput, DeleteRouteSettingsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRouteSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteStageCommand.ts b/clients/client-apigatewayv2/commands/DeleteStageCommand.ts index d63b4dd152106..f2513d9f482b7 100644 --- a/clients/client-apigatewayv2/commands/DeleteStageCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteStageCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteStageCommandInput = DeleteStageRequest; export type DeleteStageCommandOutput = __MetadataBearer; +/** + *

Deletes a Stage.

+ */ export class DeleteStageCommand extends $Command< DeleteStageCommandInput, DeleteStageCommandOutput, @@ -34,6 +37,9 @@ export class DeleteStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/DeleteVpcLinkCommand.ts b/clients/client-apigatewayv2/commands/DeleteVpcLinkCommand.ts index ffc1c3bf4fa9c..3f6490f66115b 100644 --- a/clients/client-apigatewayv2/commands/DeleteVpcLinkCommand.ts +++ b/clients/client-apigatewayv2/commands/DeleteVpcLinkCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVpcLinkCommandInput = DeleteVpcLinkRequest; export type DeleteVpcLinkCommandOutput = DeleteVpcLinkResponse & __MetadataBearer; +/** + *

Deletes a VPC link.

+ */ export class DeleteVpcLinkCommand extends $Command< DeleteVpcLinkCommandInput, DeleteVpcLinkCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVpcLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/ExportApiCommand.ts b/clients/client-apigatewayv2/commands/ExportApiCommand.ts index 3b0e3ac98057e..8efe8d1bc7b1e 100644 --- a/clients/client-apigatewayv2/commands/ExportApiCommand.ts +++ b/clients/client-apigatewayv2/commands/ExportApiCommand.ts @@ -34,6 +34,9 @@ export class ExportApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetApiCommand.ts b/clients/client-apigatewayv2/commands/GetApiCommand.ts index 3511f59499938..05cb9c19e6f7a 100644 --- a/clients/client-apigatewayv2/commands/GetApiCommand.ts +++ b/clients/client-apigatewayv2/commands/GetApiCommand.ts @@ -17,6 +17,9 @@ import { export type GetApiCommandInput = GetApiRequest; export type GetApiCommandOutput = GetApiResponse & __MetadataBearer; +/** + *

Gets an Api resource.

+ */ export class GetApiCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetApiCommand extends $Command, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetApiMappingCommand.ts b/clients/client-apigatewayv2/commands/GetApiMappingCommand.ts index 97bacf846f325..8c9d608085f2e 100644 --- a/clients/client-apigatewayv2/commands/GetApiMappingCommand.ts +++ b/clients/client-apigatewayv2/commands/GetApiMappingCommand.ts @@ -20,6 +20,9 @@ import { export type GetApiMappingCommandInput = GetApiMappingRequest; export type GetApiMappingCommandOutput = GetApiMappingResponse & __MetadataBearer; +/** + *

Gets an API mapping.

+ */ export class GetApiMappingCommand extends $Command< GetApiMappingCommandInput, GetApiMappingCommandOutput, @@ -34,6 +37,9 @@ export class GetApiMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetApiMappingsCommand.ts b/clients/client-apigatewayv2/commands/GetApiMappingsCommand.ts index d6674c270935c..a5fe89467cb38 100644 --- a/clients/client-apigatewayv2/commands/GetApiMappingsCommand.ts +++ b/clients/client-apigatewayv2/commands/GetApiMappingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetApiMappingsCommandInput = GetApiMappingsRequest; export type GetApiMappingsCommandOutput = GetApiMappingsResponse & __MetadataBearer; +/** + *

Gets API mappings.

+ */ export class GetApiMappingsCommand extends $Command< GetApiMappingsCommandInput, GetApiMappingsCommandOutput, @@ -34,6 +37,9 @@ export class GetApiMappingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetApisCommand.ts b/clients/client-apigatewayv2/commands/GetApisCommand.ts index 929b0444267e7..5967c75e3eb9c 100644 --- a/clients/client-apigatewayv2/commands/GetApisCommand.ts +++ b/clients/client-apigatewayv2/commands/GetApisCommand.ts @@ -20,6 +20,9 @@ import { export type GetApisCommandInput = GetApisRequest; export type GetApisCommandOutput = GetApisResponse & __MetadataBearer; +/** + *

Gets a collection of Api resources.

+ */ export class GetApisCommand extends $Command< GetApisCommandInput, GetApisCommandOutput, @@ -34,6 +37,9 @@ export class GetApisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetAuthorizerCommand.ts b/clients/client-apigatewayv2/commands/GetAuthorizerCommand.ts index fa5f2500b7a9b..84c338fdb6566 100644 --- a/clients/client-apigatewayv2/commands/GetAuthorizerCommand.ts +++ b/clients/client-apigatewayv2/commands/GetAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type GetAuthorizerCommandInput = GetAuthorizerRequest; export type GetAuthorizerCommandOutput = GetAuthorizerResponse & __MetadataBearer; +/** + *

Gets an Authorizer.

+ */ export class GetAuthorizerCommand extends $Command< GetAuthorizerCommandInput, GetAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class GetAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetAuthorizersCommand.ts b/clients/client-apigatewayv2/commands/GetAuthorizersCommand.ts index b11638e68e26a..71163ae2a04ac 100644 --- a/clients/client-apigatewayv2/commands/GetAuthorizersCommand.ts +++ b/clients/client-apigatewayv2/commands/GetAuthorizersCommand.ts @@ -20,6 +20,9 @@ import { export type GetAuthorizersCommandInput = GetAuthorizersRequest; export type GetAuthorizersCommandOutput = GetAuthorizersResponse & __MetadataBearer; +/** + *

Gets the Authorizers for an API.

+ */ export class GetAuthorizersCommand extends $Command< GetAuthorizersCommandInput, GetAuthorizersCommandOutput, @@ -34,6 +37,9 @@ export class GetAuthorizersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetDeploymentCommand.ts b/clients/client-apigatewayv2/commands/GetDeploymentCommand.ts index 37ac1f1cbbe97..7fe5d73c5745c 100644 --- a/clients/client-apigatewayv2/commands/GetDeploymentCommand.ts +++ b/clients/client-apigatewayv2/commands/GetDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentCommandInput = GetDeploymentRequest; export type GetDeploymentCommandOutput = GetDeploymentResponse & __MetadataBearer; +/** + *

Gets a Deployment.

+ */ export class GetDeploymentCommand extends $Command< GetDeploymentCommandInput, GetDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetDeploymentsCommand.ts b/clients/client-apigatewayv2/commands/GetDeploymentsCommand.ts index b6b0a718adc8f..c18b3dc84eee1 100644 --- a/clients/client-apigatewayv2/commands/GetDeploymentsCommand.ts +++ b/clients/client-apigatewayv2/commands/GetDeploymentsCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentsCommandInput = GetDeploymentsRequest; export type GetDeploymentsCommandOutput = GetDeploymentsResponse & __MetadataBearer; +/** + *

Gets the Deployments for an API.

+ */ export class GetDeploymentsCommand extends $Command< GetDeploymentsCommandInput, GetDeploymentsCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetDomainNameCommand.ts b/clients/client-apigatewayv2/commands/GetDomainNameCommand.ts index 5ae53ae1c269a..3a48665ddc932 100644 --- a/clients/client-apigatewayv2/commands/GetDomainNameCommand.ts +++ b/clients/client-apigatewayv2/commands/GetDomainNameCommand.ts @@ -20,6 +20,9 @@ import { export type GetDomainNameCommandInput = GetDomainNameRequest; export type GetDomainNameCommandOutput = GetDomainNameResponse & __MetadataBearer; +/** + *

Gets a domain name.

+ */ export class GetDomainNameCommand extends $Command< GetDomainNameCommandInput, GetDomainNameCommandOutput, @@ -34,6 +37,9 @@ export class GetDomainNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetDomainNamesCommand.ts b/clients/client-apigatewayv2/commands/GetDomainNamesCommand.ts index be1104e2f413c..577405e9e84bd 100644 --- a/clients/client-apigatewayv2/commands/GetDomainNamesCommand.ts +++ b/clients/client-apigatewayv2/commands/GetDomainNamesCommand.ts @@ -20,6 +20,9 @@ import { export type GetDomainNamesCommandInput = GetDomainNamesRequest; export type GetDomainNamesCommandOutput = GetDomainNamesResponse & __MetadataBearer; +/** + *

Gets the domain names for an AWS account.

+ */ export class GetDomainNamesCommand extends $Command< GetDomainNamesCommandInput, GetDomainNamesCommandOutput, @@ -34,6 +37,9 @@ export class GetDomainNamesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetIntegrationCommand.ts b/clients/client-apigatewayv2/commands/GetIntegrationCommand.ts index 8215df91398d7..7d2b5ccb43f69 100644 --- a/clients/client-apigatewayv2/commands/GetIntegrationCommand.ts +++ b/clients/client-apigatewayv2/commands/GetIntegrationCommand.ts @@ -20,6 +20,9 @@ import { export type GetIntegrationCommandInput = GetIntegrationRequest; export type GetIntegrationCommandOutput = GetIntegrationResult & __MetadataBearer; +/** + *

Gets an Integration.

+ */ export class GetIntegrationCommand extends $Command< GetIntegrationCommandInput, GetIntegrationCommandOutput, @@ -34,6 +37,9 @@ export class GetIntegrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetIntegrationResponseCommand.ts b/clients/client-apigatewayv2/commands/GetIntegrationResponseCommand.ts index c25c9bf172db4..5648a24ae179c 100644 --- a/clients/client-apigatewayv2/commands/GetIntegrationResponseCommand.ts +++ b/clients/client-apigatewayv2/commands/GetIntegrationResponseCommand.ts @@ -20,6 +20,9 @@ import { export type GetIntegrationResponseCommandInput = GetIntegrationResponseRequest; export type GetIntegrationResponseCommandOutput = GetIntegrationResponseResponse & __MetadataBearer; +/** + *

Gets an IntegrationResponses.

+ */ export class GetIntegrationResponseCommand extends $Command< GetIntegrationResponseCommandInput, GetIntegrationResponseCommandOutput, @@ -34,6 +37,9 @@ export class GetIntegrationResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetIntegrationResponsesCommand.ts b/clients/client-apigatewayv2/commands/GetIntegrationResponsesCommand.ts index 8dedf5c108dd3..3d3c436b90202 100644 --- a/clients/client-apigatewayv2/commands/GetIntegrationResponsesCommand.ts +++ b/clients/client-apigatewayv2/commands/GetIntegrationResponsesCommand.ts @@ -20,6 +20,9 @@ import { export type GetIntegrationResponsesCommandInput = GetIntegrationResponsesRequest; export type GetIntegrationResponsesCommandOutput = GetIntegrationResponsesResponse & __MetadataBearer; +/** + *

Gets the IntegrationResponses for an Integration.

+ */ export class GetIntegrationResponsesCommand extends $Command< GetIntegrationResponsesCommandInput, GetIntegrationResponsesCommandOutput, @@ -34,6 +37,9 @@ export class GetIntegrationResponsesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetIntegrationsCommand.ts b/clients/client-apigatewayv2/commands/GetIntegrationsCommand.ts index c5464701f8a3d..4c698996c68ca 100644 --- a/clients/client-apigatewayv2/commands/GetIntegrationsCommand.ts +++ b/clients/client-apigatewayv2/commands/GetIntegrationsCommand.ts @@ -20,6 +20,9 @@ import { export type GetIntegrationsCommandInput = GetIntegrationsRequest; export type GetIntegrationsCommandOutput = GetIntegrationsResponse & __MetadataBearer; +/** + *

Gets the Integrations for an API.

+ */ export class GetIntegrationsCommand extends $Command< GetIntegrationsCommandInput, GetIntegrationsCommandOutput, @@ -34,6 +37,9 @@ export class GetIntegrationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetModelCommand.ts b/clients/client-apigatewayv2/commands/GetModelCommand.ts index 9779b4aad4f05..2a925b7d60299 100644 --- a/clients/client-apigatewayv2/commands/GetModelCommand.ts +++ b/clients/client-apigatewayv2/commands/GetModelCommand.ts @@ -20,6 +20,9 @@ import { export type GetModelCommandInput = GetModelRequest; export type GetModelCommandOutput = GetModelResponse & __MetadataBearer; +/** + *

Gets a Model.

+ */ export class GetModelCommand extends $Command< GetModelCommandInput, GetModelCommandOutput, @@ -34,6 +37,9 @@ export class GetModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetModelTemplateCommand.ts b/clients/client-apigatewayv2/commands/GetModelTemplateCommand.ts index 42835095b859f..18f4b214253d9 100644 --- a/clients/client-apigatewayv2/commands/GetModelTemplateCommand.ts +++ b/clients/client-apigatewayv2/commands/GetModelTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetModelTemplateCommandInput = GetModelTemplateRequest; export type GetModelTemplateCommandOutput = GetModelTemplateResponse & __MetadataBearer; +/** + *

Gets a model template.

+ */ export class GetModelTemplateCommand extends $Command< GetModelTemplateCommandInput, GetModelTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetModelTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetModelsCommand.ts b/clients/client-apigatewayv2/commands/GetModelsCommand.ts index db1e63c2e62c1..3bcb01121d935 100644 --- a/clients/client-apigatewayv2/commands/GetModelsCommand.ts +++ b/clients/client-apigatewayv2/commands/GetModelsCommand.ts @@ -20,6 +20,9 @@ import { export type GetModelsCommandInput = GetModelsRequest; export type GetModelsCommandOutput = GetModelsResponse & __MetadataBearer; +/** + *

Gets the Models for an API.

+ */ export class GetModelsCommand extends $Command< GetModelsCommandInput, GetModelsCommandOutput, @@ -34,6 +37,9 @@ export class GetModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetRouteCommand.ts b/clients/client-apigatewayv2/commands/GetRouteCommand.ts index 9b0d7b7a1cf1e..5c4da777a56d0 100644 --- a/clients/client-apigatewayv2/commands/GetRouteCommand.ts +++ b/clients/client-apigatewayv2/commands/GetRouteCommand.ts @@ -20,6 +20,9 @@ import { export type GetRouteCommandInput = GetRouteRequest; export type GetRouteCommandOutput = GetRouteResult & __MetadataBearer; +/** + *

Gets a Route.

+ */ export class GetRouteCommand extends $Command< GetRouteCommandInput, GetRouteCommandOutput, @@ -34,6 +37,9 @@ export class GetRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetRouteResponseCommand.ts b/clients/client-apigatewayv2/commands/GetRouteResponseCommand.ts index ec4699def63bd..742fbf99bce41 100644 --- a/clients/client-apigatewayv2/commands/GetRouteResponseCommand.ts +++ b/clients/client-apigatewayv2/commands/GetRouteResponseCommand.ts @@ -20,6 +20,9 @@ import { export type GetRouteResponseCommandInput = GetRouteResponseRequest; export type GetRouteResponseCommandOutput = GetRouteResponseResponse & __MetadataBearer; +/** + *

Gets a RouteResponse.

+ */ export class GetRouteResponseCommand extends $Command< GetRouteResponseCommandInput, GetRouteResponseCommandOutput, @@ -34,6 +37,9 @@ export class GetRouteResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetRouteResponsesCommand.ts b/clients/client-apigatewayv2/commands/GetRouteResponsesCommand.ts index b617545fdb267..a19bb482d2286 100644 --- a/clients/client-apigatewayv2/commands/GetRouteResponsesCommand.ts +++ b/clients/client-apigatewayv2/commands/GetRouteResponsesCommand.ts @@ -20,6 +20,9 @@ import { export type GetRouteResponsesCommandInput = GetRouteResponsesRequest; export type GetRouteResponsesCommandOutput = GetRouteResponsesResponse & __MetadataBearer; +/** + *

Gets the RouteResponses for a Route.

+ */ export class GetRouteResponsesCommand extends $Command< GetRouteResponsesCommandInput, GetRouteResponsesCommandOutput, @@ -34,6 +37,9 @@ export class GetRouteResponsesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetRoutesCommand.ts b/clients/client-apigatewayv2/commands/GetRoutesCommand.ts index 434fe697f7773..1a1af31001096 100644 --- a/clients/client-apigatewayv2/commands/GetRoutesCommand.ts +++ b/clients/client-apigatewayv2/commands/GetRoutesCommand.ts @@ -20,6 +20,9 @@ import { export type GetRoutesCommandInput = GetRoutesRequest; export type GetRoutesCommandOutput = GetRoutesResponse & __MetadataBearer; +/** + *

Gets the Routes for an API.

+ */ export class GetRoutesCommand extends $Command< GetRoutesCommandInput, GetRoutesCommandOutput, @@ -34,6 +37,9 @@ export class GetRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetStageCommand.ts b/clients/client-apigatewayv2/commands/GetStageCommand.ts index f7d4501128871..ba55a75e045a4 100644 --- a/clients/client-apigatewayv2/commands/GetStageCommand.ts +++ b/clients/client-apigatewayv2/commands/GetStageCommand.ts @@ -20,6 +20,9 @@ import { export type GetStageCommandInput = GetStageRequest; export type GetStageCommandOutput = GetStageResponse & __MetadataBearer; +/** + *

Gets a Stage.

+ */ export class GetStageCommand extends $Command< GetStageCommandInput, GetStageCommandOutput, @@ -34,6 +37,9 @@ export class GetStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetStagesCommand.ts b/clients/client-apigatewayv2/commands/GetStagesCommand.ts index 5429776b56401..37cb44772c026 100644 --- a/clients/client-apigatewayv2/commands/GetStagesCommand.ts +++ b/clients/client-apigatewayv2/commands/GetStagesCommand.ts @@ -20,6 +20,9 @@ import { export type GetStagesCommandInput = GetStagesRequest; export type GetStagesCommandOutput = GetStagesResponse & __MetadataBearer; +/** + *

Gets the Stages for an API.

+ */ export class GetStagesCommand extends $Command< GetStagesCommandInput, GetStagesCommandOutput, @@ -34,6 +37,9 @@ export class GetStagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetTagsCommand.ts b/clients/client-apigatewayv2/commands/GetTagsCommand.ts index 46fb38590eca0..82940c3579231 100644 --- a/clients/client-apigatewayv2/commands/GetTagsCommand.ts +++ b/clients/client-apigatewayv2/commands/GetTagsCommand.ts @@ -20,6 +20,9 @@ import { export type GetTagsCommandInput = GetTagsRequest; export type GetTagsCommandOutput = GetTagsResponse & __MetadataBearer; +/** + *

Gets a collection of Tag resources.

+ */ export class GetTagsCommand extends $Command< GetTagsCommandInput, GetTagsCommandOutput, @@ -34,6 +37,9 @@ export class GetTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetVpcLinkCommand.ts b/clients/client-apigatewayv2/commands/GetVpcLinkCommand.ts index 30154b7110e2c..97e9f3e55c5c2 100644 --- a/clients/client-apigatewayv2/commands/GetVpcLinkCommand.ts +++ b/clients/client-apigatewayv2/commands/GetVpcLinkCommand.ts @@ -20,6 +20,9 @@ import { export type GetVpcLinkCommandInput = GetVpcLinkRequest; export type GetVpcLinkCommandOutput = GetVpcLinkResponse & __MetadataBearer; +/** + *

Gets a VPC link.

+ */ export class GetVpcLinkCommand extends $Command< GetVpcLinkCommandInput, GetVpcLinkCommandOutput, @@ -34,6 +37,9 @@ export class GetVpcLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/GetVpcLinksCommand.ts b/clients/client-apigatewayv2/commands/GetVpcLinksCommand.ts index 4fec2743f1139..2dff22cf89a59 100644 --- a/clients/client-apigatewayv2/commands/GetVpcLinksCommand.ts +++ b/clients/client-apigatewayv2/commands/GetVpcLinksCommand.ts @@ -20,6 +20,9 @@ import { export type GetVpcLinksCommandInput = GetVpcLinksRequest; export type GetVpcLinksCommandOutput = GetVpcLinksResponse & __MetadataBearer; +/** + *

Gets a collection of VPC links.

+ */ export class GetVpcLinksCommand extends $Command< GetVpcLinksCommandInput, GetVpcLinksCommandOutput, @@ -34,6 +37,9 @@ export class GetVpcLinksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/ImportApiCommand.ts b/clients/client-apigatewayv2/commands/ImportApiCommand.ts index 56496c52220ed..62c6e9615b063 100644 --- a/clients/client-apigatewayv2/commands/ImportApiCommand.ts +++ b/clients/client-apigatewayv2/commands/ImportApiCommand.ts @@ -20,6 +20,9 @@ import { export type ImportApiCommandInput = ImportApiRequest; export type ImportApiCommandOutput = ImportApiResponse & __MetadataBearer; +/** + *

Imports an API.

+ */ export class ImportApiCommand extends $Command< ImportApiCommandInput, ImportApiCommandOutput, @@ -34,6 +37,9 @@ export class ImportApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/ReimportApiCommand.ts b/clients/client-apigatewayv2/commands/ReimportApiCommand.ts index 003ea4261dc3a..ea5894d48e7b8 100644 --- a/clients/client-apigatewayv2/commands/ReimportApiCommand.ts +++ b/clients/client-apigatewayv2/commands/ReimportApiCommand.ts @@ -20,6 +20,9 @@ import { export type ReimportApiCommandInput = ReimportApiRequest; export type ReimportApiCommandOutput = ReimportApiResponse & __MetadataBearer; +/** + *

Puts an Api resource.

+ */ export class ReimportApiCommand extends $Command< ReimportApiCommandInput, ReimportApiCommandOutput, @@ -34,6 +37,9 @@ export class ReimportApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/ResetAuthorizersCacheCommand.ts b/clients/client-apigatewayv2/commands/ResetAuthorizersCacheCommand.ts index c2d1e58884382..33d9398de8fc1 100644 --- a/clients/client-apigatewayv2/commands/ResetAuthorizersCacheCommand.ts +++ b/clients/client-apigatewayv2/commands/ResetAuthorizersCacheCommand.ts @@ -20,6 +20,9 @@ import { export type ResetAuthorizersCacheCommandInput = ResetAuthorizersCacheRequest; export type ResetAuthorizersCacheCommandOutput = __MetadataBearer; +/** + *

Resets all authorizer cache entries on a stage. Supported only for HTTP APIs.

+ */ export class ResetAuthorizersCacheCommand extends $Command< ResetAuthorizersCacheCommandInput, ResetAuthorizersCacheCommandOutput, @@ -34,6 +37,9 @@ export class ResetAuthorizersCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/TagResourceCommand.ts b/clients/client-apigatewayv2/commands/TagResourceCommand.ts index 6d272d58d52ec..d6c02469f0c1f 100644 --- a/clients/client-apigatewayv2/commands/TagResourceCommand.ts +++ b/clients/client-apigatewayv2/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Creates a new Tag resource to represent a tag.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UntagResourceCommand.ts b/clients/client-apigatewayv2/commands/UntagResourceCommand.ts index 812b7ea01eb0c..c2c98bb5a73e9 100644 --- a/clients/client-apigatewayv2/commands/UntagResourceCommand.ts +++ b/clients/client-apigatewayv2/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Deletes a Tag.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateApiCommand.ts b/clients/client-apigatewayv2/commands/UpdateApiCommand.ts index d01c3ea86724e..17831009e0a98 100644 --- a/clients/client-apigatewayv2/commands/UpdateApiCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateApiCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApiCommandInput = UpdateApiRequest; export type UpdateApiCommandOutput = UpdateApiResponse & __MetadataBearer; +/** + *

Updates an Api resource.

+ */ export class UpdateApiCommand extends $Command< UpdateApiCommandInput, UpdateApiCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateApiMappingCommand.ts b/clients/client-apigatewayv2/commands/UpdateApiMappingCommand.ts index 080c3ae25538a..e34519de19b53 100644 --- a/clients/client-apigatewayv2/commands/UpdateApiMappingCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateApiMappingCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApiMappingCommandInput = UpdateApiMappingRequest; export type UpdateApiMappingCommandOutput = UpdateApiMappingResponse & __MetadataBearer; +/** + *

The API mapping.

+ */ export class UpdateApiMappingCommand extends $Command< UpdateApiMappingCommandInput, UpdateApiMappingCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApiMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateAuthorizerCommand.ts b/clients/client-apigatewayv2/commands/UpdateAuthorizerCommand.ts index 64b28d0af11ca..8081e851eef94 100644 --- a/clients/client-apigatewayv2/commands/UpdateAuthorizerCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAuthorizerCommandInput = UpdateAuthorizerRequest; export type UpdateAuthorizerCommandOutput = UpdateAuthorizerResponse & __MetadataBearer; +/** + *

Updates an Authorizer.

+ */ export class UpdateAuthorizerCommand extends $Command< UpdateAuthorizerCommandInput, UpdateAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateDeploymentCommand.ts b/clients/client-apigatewayv2/commands/UpdateDeploymentCommand.ts index b80d31e3dd51e..9dd2cd62ff8d1 100644 --- a/clients/client-apigatewayv2/commands/UpdateDeploymentCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDeploymentCommandInput = UpdateDeploymentRequest; export type UpdateDeploymentCommandOutput = UpdateDeploymentResponse & __MetadataBearer; +/** + *

Updates a Deployment.

+ */ export class UpdateDeploymentCommand extends $Command< UpdateDeploymentCommandInput, UpdateDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateDomainNameCommand.ts b/clients/client-apigatewayv2/commands/UpdateDomainNameCommand.ts index d45b7aee2c64c..999940c3c531f 100644 --- a/clients/client-apigatewayv2/commands/UpdateDomainNameCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateDomainNameCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDomainNameCommandInput = UpdateDomainNameRequest; export type UpdateDomainNameCommandOutput = UpdateDomainNameResponse & __MetadataBearer; +/** + *

Updates a domain name.

+ */ export class UpdateDomainNameCommand extends $Command< UpdateDomainNameCommandInput, UpdateDomainNameCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDomainNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateIntegrationCommand.ts b/clients/client-apigatewayv2/commands/UpdateIntegrationCommand.ts index c176767e81d12..9e31e6fdc9fb1 100644 --- a/clients/client-apigatewayv2/commands/UpdateIntegrationCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateIntegrationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateIntegrationCommandInput = UpdateIntegrationRequest; export type UpdateIntegrationCommandOutput = UpdateIntegrationResult & __MetadataBearer; +/** + *

Updates an Integration.

+ */ export class UpdateIntegrationCommand extends $Command< UpdateIntegrationCommandInput, UpdateIntegrationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateIntegrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateIntegrationResponseCommand.ts b/clients/client-apigatewayv2/commands/UpdateIntegrationResponseCommand.ts index 39fb0ce67a681..bb382348ab206 100644 --- a/clients/client-apigatewayv2/commands/UpdateIntegrationResponseCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateIntegrationResponseCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateIntegrationResponseCommandInput = UpdateIntegrationResponseRequest; export type UpdateIntegrationResponseCommandOutput = UpdateIntegrationResponseResponse & __MetadataBearer; +/** + *

Updates an IntegrationResponses.

+ */ export class UpdateIntegrationResponseCommand extends $Command< UpdateIntegrationResponseCommandInput, UpdateIntegrationResponseCommandOutput, @@ -34,6 +37,9 @@ export class UpdateIntegrationResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateModelCommand.ts b/clients/client-apigatewayv2/commands/UpdateModelCommand.ts index 72d78481a43fd..ce60e697c78ee 100644 --- a/clients/client-apigatewayv2/commands/UpdateModelCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateModelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateModelCommandInput = UpdateModelRequest; export type UpdateModelCommandOutput = UpdateModelResponse & __MetadataBearer; +/** + *

Updates a Model.

+ */ export class UpdateModelCommand extends $Command< UpdateModelCommandInput, UpdateModelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateRouteCommand.ts b/clients/client-apigatewayv2/commands/UpdateRouteCommand.ts index 88713e33649e6..d8adafaeccb49 100644 --- a/clients/client-apigatewayv2/commands/UpdateRouteCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateRouteCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRouteCommandInput = UpdateRouteRequest; export type UpdateRouteCommandOutput = UpdateRouteResult & __MetadataBearer; +/** + *

Updates a Route.

+ */ export class UpdateRouteCommand extends $Command< UpdateRouteCommandInput, UpdateRouteCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateRouteResponseCommand.ts b/clients/client-apigatewayv2/commands/UpdateRouteResponseCommand.ts index aa67b9eda0db7..3bf562d5bbac0 100644 --- a/clients/client-apigatewayv2/commands/UpdateRouteResponseCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateRouteResponseCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRouteResponseCommandInput = UpdateRouteResponseRequest; export type UpdateRouteResponseCommandOutput = UpdateRouteResponseResponse & __MetadataBearer; +/** + *

Updates a RouteResponse.

+ */ export class UpdateRouteResponseCommand extends $Command< UpdateRouteResponseCommandInput, UpdateRouteResponseCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRouteResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateStageCommand.ts b/clients/client-apigatewayv2/commands/UpdateStageCommand.ts index 5088ad6d62f5a..b135627d17265 100644 --- a/clients/client-apigatewayv2/commands/UpdateStageCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateStageCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateStageCommandInput = UpdateStageRequest; export type UpdateStageCommandOutput = UpdateStageResponse & __MetadataBearer; +/** + *

Updates a Stage.

+ */ export class UpdateStageCommand extends $Command< UpdateStageCommandInput, UpdateStageCommandOutput, @@ -34,6 +37,9 @@ export class UpdateStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/commands/UpdateVpcLinkCommand.ts b/clients/client-apigatewayv2/commands/UpdateVpcLinkCommand.ts index e346b0158672f..09db6095ec614 100644 --- a/clients/client-apigatewayv2/commands/UpdateVpcLinkCommand.ts +++ b/clients/client-apigatewayv2/commands/UpdateVpcLinkCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVpcLinkCommandInput = UpdateVpcLinkRequest; export type UpdateVpcLinkCommandOutput = UpdateVpcLinkResponse & __MetadataBearer; +/** + *

Updates a VPC link.

+ */ export class UpdateVpcLinkCommand extends $Command< UpdateVpcLinkCommandInput, UpdateVpcLinkCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVpcLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApiGatewayV2ClientResolvedConfig, diff --git a/clients/client-apigatewayv2/package.json b/clients/client-apigatewayv2/package.json index e453e6b4f3d92..ed8d1b8579329 100644 --- a/clients/client-apigatewayv2/package.json +++ b/clients/client-apigatewayv2/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Apigatewayv2 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-apigatewayv2/runtimeConfig.browser.ts b/clients/client-apigatewayv2/runtimeConfig.browser.ts index 55a62fd5afa5a..d7fc28aab3c9b 100644 --- a/clients/client-apigatewayv2/runtimeConfig.browser.ts +++ b/clients/client-apigatewayv2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ApiGatewayV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-apigatewayv2/runtimeConfig.native.ts b/clients/client-apigatewayv2/runtimeConfig.native.ts index b2f9826e686aa..01cb1a3346bea 100644 --- a/clients/client-apigatewayv2/runtimeConfig.native.ts +++ b/clients/client-apigatewayv2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ApiGatewayV2Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-apigatewayv2/runtimeConfig.shared.ts b/clients/client-apigatewayv2/runtimeConfig.shared.ts index 9ebee5b1f3042..ff3b108101b8d 100644 --- a/clients/client-apigatewayv2/runtimeConfig.shared.ts +++ b/clients/client-apigatewayv2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-29", disableHostPrefix: false, diff --git a/clients/client-apigatewayv2/runtimeConfig.ts b/clients/client-apigatewayv2/runtimeConfig.ts index 6878f850b90d1..d9a914fe7a49f 100644 --- a/clients/client-apigatewayv2/runtimeConfig.ts +++ b/clients/client-apigatewayv2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ApiGatewayV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-apigatewayv2/tsconfig.json b/clients/client-apigatewayv2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-apigatewayv2/tsconfig.json +++ b/clients/client-apigatewayv2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-app-mesh/commands/CreateGatewayRouteCommand.ts b/clients/client-app-mesh/commands/CreateGatewayRouteCommand.ts index cbcb20c642018..633e098a61a01 100644 --- a/clients/client-app-mesh/commands/CreateGatewayRouteCommand.ts +++ b/clients/client-app-mesh/commands/CreateGatewayRouteCommand.ts @@ -20,6 +20,12 @@ import { export type CreateGatewayRouteCommandInput = CreateGatewayRouteInput; export type CreateGatewayRouteCommandOutput = CreateGatewayRouteOutput & __MetadataBearer; +/** + *

Creates a gateway route.

+ *

A gateway route is attached to a virtual gateway and routes traffic to an existing + * virtual service. If a route matches a request, it can distribute traffic to a target virtual service.

+ *

For more information about gateway routes, see Gateway routes.

+ */ export class CreateGatewayRouteCommand extends $Command< CreateGatewayRouteCommandInput, CreateGatewayRouteCommandOutput, @@ -34,6 +40,9 @@ export class CreateGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/CreateMeshCommand.ts b/clients/client-app-mesh/commands/CreateMeshCommand.ts index 3df5e7b8a3b9a..578946d66c537 100644 --- a/clients/client-app-mesh/commands/CreateMeshCommand.ts +++ b/clients/client-app-mesh/commands/CreateMeshCommand.ts @@ -20,6 +20,14 @@ import { export type CreateMeshCommandInput = CreateMeshInput; export type CreateMeshCommandOutput = CreateMeshOutput & __MetadataBearer; +/** + *

Creates a service mesh.

+ *

A service mesh is a logical boundary for network traffic between services that are + * represented by resources within the mesh. After you create your service mesh, you can + * create virtual services, virtual nodes, virtual routers, and routes to distribute traffic + * between the applications in your mesh.

+ *

For more information about service meshes, see Service meshes.

+ */ export class CreateMeshCommand extends $Command< CreateMeshCommandInput, CreateMeshCommandOutput, @@ -34,6 +42,9 @@ export class CreateMeshCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/CreateRouteCommand.ts b/clients/client-app-mesh/commands/CreateRouteCommand.ts index 24d95074bbde6..27010692e9e32 100644 --- a/clients/client-app-mesh/commands/CreateRouteCommand.ts +++ b/clients/client-app-mesh/commands/CreateRouteCommand.ts @@ -20,6 +20,12 @@ import { export type CreateRouteCommandInput = CreateRouteInput; export type CreateRouteCommandOutput = CreateRouteOutput & __MetadataBearer; +/** + *

Creates a route that is associated with a virtual router.

+ *

You can route several different protocols and define a retry policy for a route. + * Traffic can be routed to one or more virtual nodes.

+ *

For more information about routes, see Routes.

+ */ export class CreateRouteCommand extends $Command< CreateRouteCommandInput, CreateRouteCommandOutput, @@ -34,6 +40,9 @@ export class CreateRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/CreateVirtualGatewayCommand.ts b/clients/client-app-mesh/commands/CreateVirtualGatewayCommand.ts index fee06850004dc..c81571d4ebe95 100644 --- a/clients/client-app-mesh/commands/CreateVirtualGatewayCommand.ts +++ b/clients/client-app-mesh/commands/CreateVirtualGatewayCommand.ts @@ -20,6 +20,14 @@ import { export type CreateVirtualGatewayCommandInput = CreateVirtualGatewayInput; export type CreateVirtualGatewayCommandOutput = CreateVirtualGatewayOutput & __MetadataBearer; +/** + *

Creates a virtual gateway.

+ *

A virtual gateway allows resources outside your mesh to communicate to resources that + * are inside your mesh. The virtual gateway represents an Envoy proxy running in an Amazon ECS + * task, in a Kubernetes service, or on an Amazon EC2 instance. Unlike a virtual node, which + * represents an Envoy running with an application, a virtual gateway represents Envoy deployed by itself.

+ *

For more information about virtual gateways, see Virtual gateways.

+ */ export class CreateVirtualGatewayCommand extends $Command< CreateVirtualGatewayCommandInput, CreateVirtualGatewayCommandOutput, @@ -34,6 +42,9 @@ export class CreateVirtualGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/CreateVirtualNodeCommand.ts b/clients/client-app-mesh/commands/CreateVirtualNodeCommand.ts index ef049b8c75397..905d82fd800df 100644 --- a/clients/client-app-mesh/commands/CreateVirtualNodeCommand.ts +++ b/clients/client-app-mesh/commands/CreateVirtualNodeCommand.ts @@ -20,6 +20,29 @@ import { export type CreateVirtualNodeCommandInput = CreateVirtualNodeInput; export type CreateVirtualNodeCommandOutput = CreateVirtualNodeOutput & __MetadataBearer; +/** + *

Creates a virtual node within a service mesh.

+ *

A virtual node acts as a logical pointer to a particular task group, such as an Amazon ECS + * service or a Kubernetes deployment. When you create a virtual node, you can specify the + * service discovery information for your task group, and whether the proxy running in a task + * group will communicate with other proxies using Transport Layer Security (TLS).

+ *

You define a listener for any inbound traffic that your virtual node + * expects. Any virtual service that your virtual node expects to communicate to is specified + * as a backend.

+ *

The response metadata for your new virtual node contains the arn that is + * associated with the virtual node. Set this value (either the full ARN or the truncated + * resource name: for example, mesh/default/virtualNode/simpleapp) as the + * APPMESH_VIRTUAL_NODE_NAME environment variable for your task group's Envoy + * proxy container in your task definition or pod spec. This is then mapped to the + * node.id and node.cluster Envoy parameters.

+ * + *

If you require your Envoy stats or tracing to use a different name, you can override + * the node.cluster value that is set by + * APPMESH_VIRTUAL_NODE_NAME with the + * APPMESH_VIRTUAL_NODE_CLUSTER environment variable.

+ *
+ *

For more information about virtual nodes, see Virtual nodes.

+ */ export class CreateVirtualNodeCommand extends $Command< CreateVirtualNodeCommandInput, CreateVirtualNodeCommandOutput, @@ -34,6 +57,9 @@ export class CreateVirtualNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/CreateVirtualRouterCommand.ts b/clients/client-app-mesh/commands/CreateVirtualRouterCommand.ts index 3d223e23ef80c..f95b8dda230ab 100644 --- a/clients/client-app-mesh/commands/CreateVirtualRouterCommand.ts +++ b/clients/client-app-mesh/commands/CreateVirtualRouterCommand.ts @@ -20,6 +20,15 @@ import { export type CreateVirtualRouterCommandInput = CreateVirtualRouterInput; export type CreateVirtualRouterCommandOutput = CreateVirtualRouterOutput & __MetadataBearer; +/** + *

Creates a virtual router within a service mesh.

+ *

Specify a listener for any inbound traffic that your virtual router + * receives. Create a virtual router for each protocol and port that you need to route. + * Virtual routers handle traffic for one or more virtual services within your mesh. After you + * create your virtual router, create and associate routes for your virtual router that direct + * incoming requests to different virtual nodes.

+ *

For more information about virtual routers, see Virtual routers.

+ */ export class CreateVirtualRouterCommand extends $Command< CreateVirtualRouterCommandInput, CreateVirtualRouterCommandOutput, @@ -34,6 +43,9 @@ export class CreateVirtualRouterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/CreateVirtualServiceCommand.ts b/clients/client-app-mesh/commands/CreateVirtualServiceCommand.ts index 29fe72ea4d554..deff785ac279f 100644 --- a/clients/client-app-mesh/commands/CreateVirtualServiceCommand.ts +++ b/clients/client-app-mesh/commands/CreateVirtualServiceCommand.ts @@ -20,6 +20,15 @@ import { export type CreateVirtualServiceCommandInput = CreateVirtualServiceInput; export type CreateVirtualServiceCommandOutput = CreateVirtualServiceOutput & __MetadataBearer; +/** + *

Creates a virtual service within a service mesh.

+ *

A virtual service is an abstraction of a real service that is provided by a virtual node + * directly or indirectly by means of a virtual router. Dependent services call your virtual + * service by its virtualServiceName, and those requests are routed to the + * virtual node or virtual router that is specified as the provider for the virtual + * service.

+ *

For more information about virtual services, see Virtual services.

+ */ export class CreateVirtualServiceCommand extends $Command< CreateVirtualServiceCommandInput, CreateVirtualServiceCommandOutput, @@ -34,6 +43,9 @@ export class CreateVirtualServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DeleteGatewayRouteCommand.ts b/clients/client-app-mesh/commands/DeleteGatewayRouteCommand.ts index b64299acc9856..3c63c0854d47f 100644 --- a/clients/client-app-mesh/commands/DeleteGatewayRouteCommand.ts +++ b/clients/client-app-mesh/commands/DeleteGatewayRouteCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGatewayRouteCommandInput = DeleteGatewayRouteInput; export type DeleteGatewayRouteCommandOutput = DeleteGatewayRouteOutput & __MetadataBearer; +/** + *

Deletes an existing gateway route.

+ */ export class DeleteGatewayRouteCommand extends $Command< DeleteGatewayRouteCommandInput, DeleteGatewayRouteCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DeleteMeshCommand.ts b/clients/client-app-mesh/commands/DeleteMeshCommand.ts index e2e41584cb45f..0a5922622d5a0 100644 --- a/clients/client-app-mesh/commands/DeleteMeshCommand.ts +++ b/clients/client-app-mesh/commands/DeleteMeshCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteMeshCommandInput = DeleteMeshInput; export type DeleteMeshCommandOutput = DeleteMeshOutput & __MetadataBearer; +/** + *

Deletes an existing service mesh.

+ *

You must delete all resources (virtual services, routes, virtual routers, and virtual + * nodes) in the service mesh before you can delete the mesh itself.

+ */ export class DeleteMeshCommand extends $Command< DeleteMeshCommandInput, DeleteMeshCommandOutput, @@ -34,6 +39,9 @@ export class DeleteMeshCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DeleteRouteCommand.ts b/clients/client-app-mesh/commands/DeleteRouteCommand.ts index 6489895b1b3cc..8eaaa6867d09c 100644 --- a/clients/client-app-mesh/commands/DeleteRouteCommand.ts +++ b/clients/client-app-mesh/commands/DeleteRouteCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRouteCommandInput = DeleteRouteInput; export type DeleteRouteCommandOutput = DeleteRouteOutput & __MetadataBearer; +/** + *

Deletes an existing route.

+ */ export class DeleteRouteCommand extends $Command< DeleteRouteCommandInput, DeleteRouteCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DeleteVirtualGatewayCommand.ts b/clients/client-app-mesh/commands/DeleteVirtualGatewayCommand.ts index 0c5b064b24c72..e06256fed61ca 100644 --- a/clients/client-app-mesh/commands/DeleteVirtualGatewayCommand.ts +++ b/clients/client-app-mesh/commands/DeleteVirtualGatewayCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteVirtualGatewayCommandInput = DeleteVirtualGatewayInput; export type DeleteVirtualGatewayCommandOutput = DeleteVirtualGatewayOutput & __MetadataBearer; +/** + *

Deletes an existing virtual gateway. You cannot delete a virtual gateway if any gateway + * routes are associated to it.

+ */ export class DeleteVirtualGatewayCommand extends $Command< DeleteVirtualGatewayCommandInput, DeleteVirtualGatewayCommandOutput, @@ -34,6 +38,9 @@ export class DeleteVirtualGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DeleteVirtualNodeCommand.ts b/clients/client-app-mesh/commands/DeleteVirtualNodeCommand.ts index ac523dcc47eb3..adcfdd8619dc9 100644 --- a/clients/client-app-mesh/commands/DeleteVirtualNodeCommand.ts +++ b/clients/client-app-mesh/commands/DeleteVirtualNodeCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteVirtualNodeCommandInput = DeleteVirtualNodeInput; export type DeleteVirtualNodeCommandOutput = DeleteVirtualNodeOutput & __MetadataBearer; +/** + *

Deletes an existing virtual node.

+ *

You must delete any virtual services that list a virtual node as a service provider + * before you can delete the virtual node itself.

+ */ export class DeleteVirtualNodeCommand extends $Command< DeleteVirtualNodeCommandInput, DeleteVirtualNodeCommandOutput, @@ -34,6 +39,9 @@ export class DeleteVirtualNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DeleteVirtualRouterCommand.ts b/clients/client-app-mesh/commands/DeleteVirtualRouterCommand.ts index c65337289b708..656a025313f85 100644 --- a/clients/client-app-mesh/commands/DeleteVirtualRouterCommand.ts +++ b/clients/client-app-mesh/commands/DeleteVirtualRouterCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteVirtualRouterCommandInput = DeleteVirtualRouterInput; export type DeleteVirtualRouterCommandOutput = DeleteVirtualRouterOutput & __MetadataBearer; +/** + *

Deletes an existing virtual router.

+ *

You must delete any routes associated with the virtual router before you can delete the + * router itself.

+ */ export class DeleteVirtualRouterCommand extends $Command< DeleteVirtualRouterCommandInput, DeleteVirtualRouterCommandOutput, @@ -34,6 +39,9 @@ export class DeleteVirtualRouterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DeleteVirtualServiceCommand.ts b/clients/client-app-mesh/commands/DeleteVirtualServiceCommand.ts index 6ae3be955a4db..f7d680df47846 100644 --- a/clients/client-app-mesh/commands/DeleteVirtualServiceCommand.ts +++ b/clients/client-app-mesh/commands/DeleteVirtualServiceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVirtualServiceCommandInput = DeleteVirtualServiceInput; export type DeleteVirtualServiceCommandOutput = DeleteVirtualServiceOutput & __MetadataBearer; +/** + *

Deletes an existing virtual service.

+ */ export class DeleteVirtualServiceCommand extends $Command< DeleteVirtualServiceCommandInput, DeleteVirtualServiceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVirtualServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DescribeGatewayRouteCommand.ts b/clients/client-app-mesh/commands/DescribeGatewayRouteCommand.ts index 9cf1e38044d47..3f55123d19db0 100644 --- a/clients/client-app-mesh/commands/DescribeGatewayRouteCommand.ts +++ b/clients/client-app-mesh/commands/DescribeGatewayRouteCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeGatewayRouteCommandInput = DescribeGatewayRouteInput; export type DescribeGatewayRouteCommandOutput = DescribeGatewayRouteOutput & __MetadataBearer; +/** + *

Describes an existing gateway route.

+ */ export class DescribeGatewayRouteCommand extends $Command< DescribeGatewayRouteCommandInput, DescribeGatewayRouteCommandOutput, @@ -34,6 +37,9 @@ export class DescribeGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DescribeMeshCommand.ts b/clients/client-app-mesh/commands/DescribeMeshCommand.ts index 32fc0f45c3986..28574ac340820 100644 --- a/clients/client-app-mesh/commands/DescribeMeshCommand.ts +++ b/clients/client-app-mesh/commands/DescribeMeshCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMeshCommandInput = DescribeMeshInput; export type DescribeMeshCommandOutput = DescribeMeshOutput & __MetadataBearer; +/** + *

Describes an existing service mesh.

+ */ export class DescribeMeshCommand extends $Command< DescribeMeshCommandInput, DescribeMeshCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMeshCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DescribeRouteCommand.ts b/clients/client-app-mesh/commands/DescribeRouteCommand.ts index c5cae437fff26..688c9e80e2295 100644 --- a/clients/client-app-mesh/commands/DescribeRouteCommand.ts +++ b/clients/client-app-mesh/commands/DescribeRouteCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRouteCommandInput = DescribeRouteInput; export type DescribeRouteCommandOutput = DescribeRouteOutput & __MetadataBearer; +/** + *

Describes an existing route.

+ */ export class DescribeRouteCommand extends $Command< DescribeRouteCommandInput, DescribeRouteCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DescribeVirtualGatewayCommand.ts b/clients/client-app-mesh/commands/DescribeVirtualGatewayCommand.ts index 335848ac4fb45..466511eb8c799 100644 --- a/clients/client-app-mesh/commands/DescribeVirtualGatewayCommand.ts +++ b/clients/client-app-mesh/commands/DescribeVirtualGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeVirtualGatewayCommandInput = DescribeVirtualGatewayInput; export type DescribeVirtualGatewayCommandOutput = DescribeVirtualGatewayOutput & __MetadataBearer; +/** + *

Describes an existing virtual gateway.

+ */ export class DescribeVirtualGatewayCommand extends $Command< DescribeVirtualGatewayCommandInput, DescribeVirtualGatewayCommandOutput, @@ -34,6 +37,9 @@ export class DescribeVirtualGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DescribeVirtualNodeCommand.ts b/clients/client-app-mesh/commands/DescribeVirtualNodeCommand.ts index b6f71082c8d70..0c15e29737ffa 100644 --- a/clients/client-app-mesh/commands/DescribeVirtualNodeCommand.ts +++ b/clients/client-app-mesh/commands/DescribeVirtualNodeCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeVirtualNodeCommandInput = DescribeVirtualNodeInput; export type DescribeVirtualNodeCommandOutput = DescribeVirtualNodeOutput & __MetadataBearer; +/** + *

Describes an existing virtual node.

+ */ export class DescribeVirtualNodeCommand extends $Command< DescribeVirtualNodeCommandInput, DescribeVirtualNodeCommandOutput, @@ -34,6 +37,9 @@ export class DescribeVirtualNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DescribeVirtualRouterCommand.ts b/clients/client-app-mesh/commands/DescribeVirtualRouterCommand.ts index 76fbe78305fd6..ec19bd71d1400 100644 --- a/clients/client-app-mesh/commands/DescribeVirtualRouterCommand.ts +++ b/clients/client-app-mesh/commands/DescribeVirtualRouterCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeVirtualRouterCommandInput = DescribeVirtualRouterInput; export type DescribeVirtualRouterCommandOutput = DescribeVirtualRouterOutput & __MetadataBearer; +/** + *

Describes an existing virtual router.

+ */ export class DescribeVirtualRouterCommand extends $Command< DescribeVirtualRouterCommandInput, DescribeVirtualRouterCommandOutput, @@ -34,6 +37,9 @@ export class DescribeVirtualRouterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/DescribeVirtualServiceCommand.ts b/clients/client-app-mesh/commands/DescribeVirtualServiceCommand.ts index 47ac5896a044d..fd388969714a8 100644 --- a/clients/client-app-mesh/commands/DescribeVirtualServiceCommand.ts +++ b/clients/client-app-mesh/commands/DescribeVirtualServiceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeVirtualServiceCommandInput = DescribeVirtualServiceInput; export type DescribeVirtualServiceCommandOutput = DescribeVirtualServiceOutput & __MetadataBearer; +/** + *

Describes an existing virtual service.

+ */ export class DescribeVirtualServiceCommand extends $Command< DescribeVirtualServiceCommandInput, DescribeVirtualServiceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeVirtualServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/ListGatewayRoutesCommand.ts b/clients/client-app-mesh/commands/ListGatewayRoutesCommand.ts index 85ab3a6b4e667..ca7e7480cd748 100644 --- a/clients/client-app-mesh/commands/ListGatewayRoutesCommand.ts +++ b/clients/client-app-mesh/commands/ListGatewayRoutesCommand.ts @@ -20,6 +20,10 @@ import { export type ListGatewayRoutesCommandInput = ListGatewayRoutesInput; export type ListGatewayRoutesCommandOutput = ListGatewayRoutesOutput & __MetadataBearer; +/** + *

Returns a list of existing gateway routes that are associated to a virtual + * gateway.

+ */ export class ListGatewayRoutesCommand extends $Command< ListGatewayRoutesCommandInput, ListGatewayRoutesCommandOutput, @@ -34,6 +38,9 @@ export class ListGatewayRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/ListMeshesCommand.ts b/clients/client-app-mesh/commands/ListMeshesCommand.ts index 669d6afeafcdf..48211482ac3a6 100644 --- a/clients/client-app-mesh/commands/ListMeshesCommand.ts +++ b/clients/client-app-mesh/commands/ListMeshesCommand.ts @@ -20,6 +20,9 @@ import { export type ListMeshesCommandInput = ListMeshesInput; export type ListMeshesCommandOutput = ListMeshesOutput & __MetadataBearer; +/** + *

Returns a list of existing service meshes.

+ */ export class ListMeshesCommand extends $Command< ListMeshesCommandInput, ListMeshesCommandOutput, @@ -34,6 +37,9 @@ export class ListMeshesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/ListRoutesCommand.ts b/clients/client-app-mesh/commands/ListRoutesCommand.ts index f38a98655fa46..e0510c4c69bd2 100644 --- a/clients/client-app-mesh/commands/ListRoutesCommand.ts +++ b/clients/client-app-mesh/commands/ListRoutesCommand.ts @@ -20,6 +20,9 @@ import { export type ListRoutesCommandInput = ListRoutesInput; export type ListRoutesCommandOutput = ListRoutesOutput & __MetadataBearer; +/** + *

Returns a list of existing routes in a service mesh.

+ */ export class ListRoutesCommand extends $Command< ListRoutesCommandInput, ListRoutesCommandOutput, @@ -34,6 +37,9 @@ export class ListRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/ListTagsForResourceCommand.ts b/clients/client-app-mesh/commands/ListTagsForResourceCommand.ts index 15044058fef44..7f1697cac0b18 100644 --- a/clients/client-app-mesh/commands/ListTagsForResourceCommand.ts +++ b/clients/client-app-mesh/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

List the tags for an App Mesh resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/ListVirtualGatewaysCommand.ts b/clients/client-app-mesh/commands/ListVirtualGatewaysCommand.ts index 36795d082b75d..b0ae62ca5d764 100644 --- a/clients/client-app-mesh/commands/ListVirtualGatewaysCommand.ts +++ b/clients/client-app-mesh/commands/ListVirtualGatewaysCommand.ts @@ -20,6 +20,9 @@ import { export type ListVirtualGatewaysCommandInput = ListVirtualGatewaysInput; export type ListVirtualGatewaysCommandOutput = ListVirtualGatewaysOutput & __MetadataBearer; +/** + *

Returns a list of existing virtual gateways in a service mesh.

+ */ export class ListVirtualGatewaysCommand extends $Command< ListVirtualGatewaysCommandInput, ListVirtualGatewaysCommandOutput, @@ -34,6 +37,9 @@ export class ListVirtualGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/ListVirtualNodesCommand.ts b/clients/client-app-mesh/commands/ListVirtualNodesCommand.ts index 8c3df79c89efe..ef9139766739c 100644 --- a/clients/client-app-mesh/commands/ListVirtualNodesCommand.ts +++ b/clients/client-app-mesh/commands/ListVirtualNodesCommand.ts @@ -20,6 +20,9 @@ import { export type ListVirtualNodesCommandInput = ListVirtualNodesInput; export type ListVirtualNodesCommandOutput = ListVirtualNodesOutput & __MetadataBearer; +/** + *

Returns a list of existing virtual nodes.

+ */ export class ListVirtualNodesCommand extends $Command< ListVirtualNodesCommandInput, ListVirtualNodesCommandOutput, @@ -34,6 +37,9 @@ export class ListVirtualNodesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/ListVirtualRoutersCommand.ts b/clients/client-app-mesh/commands/ListVirtualRoutersCommand.ts index 00a5780daa063..f2f1c09fa9ec5 100644 --- a/clients/client-app-mesh/commands/ListVirtualRoutersCommand.ts +++ b/clients/client-app-mesh/commands/ListVirtualRoutersCommand.ts @@ -20,6 +20,9 @@ import { export type ListVirtualRoutersCommandInput = ListVirtualRoutersInput; export type ListVirtualRoutersCommandOutput = ListVirtualRoutersOutput & __MetadataBearer; +/** + *

Returns a list of existing virtual routers in a service mesh.

+ */ export class ListVirtualRoutersCommand extends $Command< ListVirtualRoutersCommandInput, ListVirtualRoutersCommandOutput, @@ -34,6 +37,9 @@ export class ListVirtualRoutersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/ListVirtualServicesCommand.ts b/clients/client-app-mesh/commands/ListVirtualServicesCommand.ts index 5c453b7ccf86d..79298c5fc87b8 100644 --- a/clients/client-app-mesh/commands/ListVirtualServicesCommand.ts +++ b/clients/client-app-mesh/commands/ListVirtualServicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListVirtualServicesCommandInput = ListVirtualServicesInput; export type ListVirtualServicesCommandOutput = ListVirtualServicesOutput & __MetadataBearer; +/** + *

Returns a list of existing virtual services in a service mesh.

+ */ export class ListVirtualServicesCommand extends $Command< ListVirtualServicesCommandInput, ListVirtualServicesCommandOutput, @@ -34,6 +37,9 @@ export class ListVirtualServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/TagResourceCommand.ts b/clients/client-app-mesh/commands/TagResourceCommand.ts index 7182710be614e..7daf98601effa 100644 --- a/clients/client-app-mesh/commands/TagResourceCommand.ts +++ b/clients/client-app-mesh/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

Associates the specified tags to a resource with the specified resourceArn. + * If existing tags on a resource aren't specified in the request parameters, they aren't + * changed. When a resource is deleted, the tags associated with that resource are also + * deleted.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/UntagResourceCommand.ts b/clients/client-app-mesh/commands/UntagResourceCommand.ts index be698237cf09a..9ed4cb6b0384f 100644 --- a/clients/client-app-mesh/commands/UntagResourceCommand.ts +++ b/clients/client-app-mesh/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Deletes specified tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/UpdateGatewayRouteCommand.ts b/clients/client-app-mesh/commands/UpdateGatewayRouteCommand.ts index cf7e761830c1e..d17d294d0f2b9 100644 --- a/clients/client-app-mesh/commands/UpdateGatewayRouteCommand.ts +++ b/clients/client-app-mesh/commands/UpdateGatewayRouteCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateGatewayRouteCommandInput = UpdateGatewayRouteInput; export type UpdateGatewayRouteCommandOutput = UpdateGatewayRouteOutput & __MetadataBearer; +/** + *

Updates an existing gateway route that is associated to a specified virtual gateway in a + * service mesh.

+ */ export class UpdateGatewayRouteCommand extends $Command< UpdateGatewayRouteCommandInput, UpdateGatewayRouteCommandOutput, @@ -34,6 +38,9 @@ export class UpdateGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/UpdateMeshCommand.ts b/clients/client-app-mesh/commands/UpdateMeshCommand.ts index e4cd9254fe690..15aab307a536f 100644 --- a/clients/client-app-mesh/commands/UpdateMeshCommand.ts +++ b/clients/client-app-mesh/commands/UpdateMeshCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMeshCommandInput = UpdateMeshInput; export type UpdateMeshCommandOutput = UpdateMeshOutput & __MetadataBearer; +/** + *

Updates an existing service mesh.

+ */ export class UpdateMeshCommand extends $Command< UpdateMeshCommandInput, UpdateMeshCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMeshCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/UpdateRouteCommand.ts b/clients/client-app-mesh/commands/UpdateRouteCommand.ts index 3787246033bc7..ec77536058469 100644 --- a/clients/client-app-mesh/commands/UpdateRouteCommand.ts +++ b/clients/client-app-mesh/commands/UpdateRouteCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRouteCommandInput = UpdateRouteInput; export type UpdateRouteCommandOutput = UpdateRouteOutput & __MetadataBearer; +/** + *

Updates an existing route for a specified service mesh and virtual router.

+ */ export class UpdateRouteCommand extends $Command< UpdateRouteCommandInput, UpdateRouteCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/UpdateVirtualGatewayCommand.ts b/clients/client-app-mesh/commands/UpdateVirtualGatewayCommand.ts index 7feb9a5bf1b4f..1a83ae2dc64f5 100644 --- a/clients/client-app-mesh/commands/UpdateVirtualGatewayCommand.ts +++ b/clients/client-app-mesh/commands/UpdateVirtualGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVirtualGatewayCommandInput = UpdateVirtualGatewayInput; export type UpdateVirtualGatewayCommandOutput = UpdateVirtualGatewayOutput & __MetadataBearer; +/** + *

Updates an existing virtual gateway in a specified service mesh.

+ */ export class UpdateVirtualGatewayCommand extends $Command< UpdateVirtualGatewayCommandInput, UpdateVirtualGatewayCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVirtualGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/UpdateVirtualNodeCommand.ts b/clients/client-app-mesh/commands/UpdateVirtualNodeCommand.ts index 12aa1db82c48e..40bd1e564e651 100644 --- a/clients/client-app-mesh/commands/UpdateVirtualNodeCommand.ts +++ b/clients/client-app-mesh/commands/UpdateVirtualNodeCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVirtualNodeCommandInput = UpdateVirtualNodeInput; export type UpdateVirtualNodeCommandOutput = UpdateVirtualNodeOutput & __MetadataBearer; +/** + *

Updates an existing virtual node in a specified service mesh.

+ */ export class UpdateVirtualNodeCommand extends $Command< UpdateVirtualNodeCommandInput, UpdateVirtualNodeCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVirtualNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/UpdateVirtualRouterCommand.ts b/clients/client-app-mesh/commands/UpdateVirtualRouterCommand.ts index 0b90564aeed6d..19c4302d0f98c 100644 --- a/clients/client-app-mesh/commands/UpdateVirtualRouterCommand.ts +++ b/clients/client-app-mesh/commands/UpdateVirtualRouterCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVirtualRouterCommandInput = UpdateVirtualRouterInput; export type UpdateVirtualRouterCommandOutput = UpdateVirtualRouterOutput & __MetadataBearer; +/** + *

Updates an existing virtual router in a specified service mesh.

+ */ export class UpdateVirtualRouterCommand extends $Command< UpdateVirtualRouterCommandInput, UpdateVirtualRouterCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVirtualRouterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/commands/UpdateVirtualServiceCommand.ts b/clients/client-app-mesh/commands/UpdateVirtualServiceCommand.ts index 5583784d84bcf..ad57bbd1fe8ce 100644 --- a/clients/client-app-mesh/commands/UpdateVirtualServiceCommand.ts +++ b/clients/client-app-mesh/commands/UpdateVirtualServiceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVirtualServiceCommandInput = UpdateVirtualServiceInput; export type UpdateVirtualServiceCommandOutput = UpdateVirtualServiceOutput & __MetadataBearer; +/** + *

Updates an existing virtual service in a specified service mesh.

+ */ export class UpdateVirtualServiceCommand extends $Command< UpdateVirtualServiceCommandInput, UpdateVirtualServiceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVirtualServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppMeshClientResolvedConfig, diff --git a/clients/client-app-mesh/package.json b/clients/client-app-mesh/package.json index 8d1417fd934b2..1867ca4f8be82 100644 --- a/clients/client-app-mesh/package.json +++ b/clients/client-app-mesh/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript App Mesh Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-app-mesh/pagination/ListGatewayRoutesPaginator.ts b/clients/client-app-mesh/pagination/ListGatewayRoutesPaginator.ts index 23506bc2f252d..af90841d11cbe 100644 --- a/clients/client-app-mesh/pagination/ListGatewayRoutesPaginator.ts +++ b/clients/client-app-mesh/pagination/ListGatewayRoutesPaginator.ts @@ -8,6 +8,9 @@ import { import { AppMeshPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppMeshClient, input: ListGatewayRoutesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGatewayRoutesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppMesh, input: ListGatewayRoutesCommandInput, diff --git a/clients/client-app-mesh/pagination/ListMeshesPaginator.ts b/clients/client-app-mesh/pagination/ListMeshesPaginator.ts index e1fcbc92ac391..91c8b5f9fb612 100644 --- a/clients/client-app-mesh/pagination/ListMeshesPaginator.ts +++ b/clients/client-app-mesh/pagination/ListMeshesPaginator.ts @@ -4,6 +4,9 @@ import { ListMeshesCommand, ListMeshesCommandInput, ListMeshesCommandOutput } fr import { AppMeshPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppMeshClient, input: ListMeshesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMeshesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppMesh, input: ListMeshesCommandInput, diff --git a/clients/client-app-mesh/pagination/ListRoutesPaginator.ts b/clients/client-app-mesh/pagination/ListRoutesPaginator.ts index 7073cafc02a07..f638cdf459842 100644 --- a/clients/client-app-mesh/pagination/ListRoutesPaginator.ts +++ b/clients/client-app-mesh/pagination/ListRoutesPaginator.ts @@ -4,6 +4,9 @@ import { ListRoutesCommand, ListRoutesCommandInput, ListRoutesCommandOutput } fr import { AppMeshPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppMeshClient, input: ListRoutesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRoutesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppMesh, input: ListRoutesCommandInput, diff --git a/clients/client-app-mesh/pagination/ListTagsForResourcePaginator.ts b/clients/client-app-mesh/pagination/ListTagsForResourcePaginator.ts index 8f5baf40880da..e6349c5460298 100644 --- a/clients/client-app-mesh/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-app-mesh/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { AppMeshPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppMeshClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppMesh, input: ListTagsForResourceCommandInput, diff --git a/clients/client-app-mesh/pagination/ListVirtualGatewaysPaginator.ts b/clients/client-app-mesh/pagination/ListVirtualGatewaysPaginator.ts index e708e39b2afc6..6c29ab2af4fcc 100644 --- a/clients/client-app-mesh/pagination/ListVirtualGatewaysPaginator.ts +++ b/clients/client-app-mesh/pagination/ListVirtualGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { AppMeshPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppMeshClient, input: ListVirtualGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVirtualGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppMesh, input: ListVirtualGatewaysCommandInput, diff --git a/clients/client-app-mesh/pagination/ListVirtualNodesPaginator.ts b/clients/client-app-mesh/pagination/ListVirtualNodesPaginator.ts index 18a8b9f54e761..d24f68492f6d2 100644 --- a/clients/client-app-mesh/pagination/ListVirtualNodesPaginator.ts +++ b/clients/client-app-mesh/pagination/ListVirtualNodesPaginator.ts @@ -8,6 +8,9 @@ import { import { AppMeshPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppMeshClient, input: ListVirtualNodesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVirtualNodesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppMesh, input: ListVirtualNodesCommandInput, diff --git a/clients/client-app-mesh/pagination/ListVirtualRoutersPaginator.ts b/clients/client-app-mesh/pagination/ListVirtualRoutersPaginator.ts index ee6d8da393cf5..6ca575a32901b 100644 --- a/clients/client-app-mesh/pagination/ListVirtualRoutersPaginator.ts +++ b/clients/client-app-mesh/pagination/ListVirtualRoutersPaginator.ts @@ -8,6 +8,9 @@ import { import { AppMeshPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppMeshClient, input: ListVirtualRoutersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVirtualRoutersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppMesh, input: ListVirtualRoutersCommandInput, diff --git a/clients/client-app-mesh/pagination/ListVirtualServicesPaginator.ts b/clients/client-app-mesh/pagination/ListVirtualServicesPaginator.ts index 54cd1a9c91dad..32ab41d83ba2b 100644 --- a/clients/client-app-mesh/pagination/ListVirtualServicesPaginator.ts +++ b/clients/client-app-mesh/pagination/ListVirtualServicesPaginator.ts @@ -8,6 +8,9 @@ import { import { AppMeshPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppMeshClient, input: ListVirtualServicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVirtualServicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppMesh, input: ListVirtualServicesCommandInput, diff --git a/clients/client-app-mesh/runtimeConfig.browser.ts b/clients/client-app-mesh/runtimeConfig.browser.ts index 65a52e05a3523..67720f4812eac 100644 --- a/clients/client-app-mesh/runtimeConfig.browser.ts +++ b/clients/client-app-mesh/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AppMeshClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-app-mesh/runtimeConfig.native.ts b/clients/client-app-mesh/runtimeConfig.native.ts index 0d13e0396113e..268b7f6eee3f6 100644 --- a/clients/client-app-mesh/runtimeConfig.native.ts +++ b/clients/client-app-mesh/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AppMeshClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-app-mesh/runtimeConfig.shared.ts b/clients/client-app-mesh/runtimeConfig.shared.ts index 3ac2634361a28..4d6eddb0c6d83 100644 --- a/clients/client-app-mesh/runtimeConfig.shared.ts +++ b/clients/client-app-mesh/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-01-25", disableHostPrefix: false, diff --git a/clients/client-app-mesh/runtimeConfig.ts b/clients/client-app-mesh/runtimeConfig.ts index 0b6e0ba4039aa..85c57aa16db8e 100644 --- a/clients/client-app-mesh/runtimeConfig.ts +++ b/clients/client-app-mesh/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AppMeshClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-app-mesh/tsconfig.json b/clients/client-app-mesh/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-app-mesh/tsconfig.json +++ b/clients/client-app-mesh/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-appconfig/commands/CreateApplicationCommand.ts b/clients/client-appconfig/commands/CreateApplicationCommand.ts index 756adbe2f3e3c..227c02f6202b1 100644 --- a/clients/client-appconfig/commands/CreateApplicationCommand.ts +++ b/clients/client-appconfig/commands/CreateApplicationCommand.ts @@ -20,6 +20,12 @@ import { export type CreateApplicationCommandInput = CreateApplicationRequest; export type CreateApplicationCommandOutput = Application & __MetadataBearer; +/** + *

An application in AppConfig is a logical unit of code that provides capabilities for your + * customers. For example, an application can be a microservice that runs on Amazon EC2 instances, + * a mobile application installed by your users, a serverless application using Amazon API + * Gateway and AWS Lambda, or any system you run on behalf of others.

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -34,6 +40,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/CreateConfigurationProfileCommand.ts b/clients/client-appconfig/commands/CreateConfigurationProfileCommand.ts index acca41aab0556..d4c4b323f5f6e 100644 --- a/clients/client-appconfig/commands/CreateConfigurationProfileCommand.ts +++ b/clients/client-appconfig/commands/CreateConfigurationProfileCommand.ts @@ -20,6 +20,26 @@ import { export type CreateConfigurationProfileCommandInput = CreateConfigurationProfileRequest; export type CreateConfigurationProfileCommandOutput = ConfigurationProfile & __MetadataBearer; +/** + *

Information that enables AppConfig to access the configuration source. Valid + * configuration sources include Systems Manager (SSM) documents, SSM Parameter Store parameters, and + * Amazon S3 objects. A configuration profile includes the following information.

+ *
    + *
  • + *

    The Uri location of the configuration data.

    + *
  • + *
  • + *

    The AWS Identity and Access Management (IAM) role that provides access to the configuration data.

    + *
  • + *
  • + *

    A validator for the configuration data. Available validators include either a JSON + * Schema or an AWS Lambda function.

    + *
  • + *
+ *

For more information, see Create a + * Configuration and a Configuration Profile in the + * AWS AppConfig User Guide.

+ */ export class CreateConfigurationProfileCommand extends $Command< CreateConfigurationProfileCommandInput, CreateConfigurationProfileCommandOutput, @@ -34,6 +54,9 @@ export class CreateConfigurationProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/CreateDeploymentStrategyCommand.ts b/clients/client-appconfig/commands/CreateDeploymentStrategyCommand.ts index 0347d47ccc5f2..e6c20071c33a0 100644 --- a/clients/client-appconfig/commands/CreateDeploymentStrategyCommand.ts +++ b/clients/client-appconfig/commands/CreateDeploymentStrategyCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDeploymentStrategyCommandInput = CreateDeploymentStrategyRequest; export type CreateDeploymentStrategyCommandOutput = DeploymentStrategy & __MetadataBearer; +/** + *

A deployment strategy defines important criteria for rolling out your configuration to + * the designated targets. A deployment strategy includes: the overall duration required, a + * percentage of targets to receive the deployment during each interval, an algorithm that + * defines how percentage grows, and bake time.

+ */ export class CreateDeploymentStrategyCommand extends $Command< CreateDeploymentStrategyCommandInput, CreateDeploymentStrategyCommandOutput, @@ -34,6 +40,9 @@ export class CreateDeploymentStrategyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/CreateEnvironmentCommand.ts b/clients/client-appconfig/commands/CreateEnvironmentCommand.ts index ef2a5b8863199..2e557a9662037 100644 --- a/clients/client-appconfig/commands/CreateEnvironmentCommand.ts +++ b/clients/client-appconfig/commands/CreateEnvironmentCommand.ts @@ -20,6 +20,15 @@ import { export type CreateEnvironmentCommandInput = CreateEnvironmentRequest; export type CreateEnvironmentCommandOutput = Environment & __MetadataBearer; +/** + *

For each application, you define one or more environments. An environment is a logical + * deployment group of AppConfig targets, such as applications in a Beta or + * Production environment. You can also define environments for application + * subcomponents such as the Web, Mobile and Back-end + * components for your application. You can configure Amazon CloudWatch alarms for each environment. + * The system monitors alarms during a configuration deployment. If an alarm is triggered, the + * system rolls back the configuration.

+ */ export class CreateEnvironmentCommand extends $Command< CreateEnvironmentCommandInput, CreateEnvironmentCommandOutput, @@ -34,6 +43,9 @@ export class CreateEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/CreateHostedConfigurationVersionCommand.ts b/clients/client-appconfig/commands/CreateHostedConfigurationVersionCommand.ts index 0f5cb788d465b..5fa516700d90c 100644 --- a/clients/client-appconfig/commands/CreateHostedConfigurationVersionCommand.ts +++ b/clients/client-appconfig/commands/CreateHostedConfigurationVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateHostedConfigurationVersionCommandInput = CreateHostedConfigurationVersionRequest; export type CreateHostedConfigurationVersionCommandOutput = HostedConfigurationVersion & __MetadataBearer; +/** + *

Create a new configuration in the AppConfig configuration store.

+ */ export class CreateHostedConfigurationVersionCommand extends $Command< CreateHostedConfigurationVersionCommandInput, CreateHostedConfigurationVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateHostedConfigurationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/DeleteApplicationCommand.ts b/clients/client-appconfig/commands/DeleteApplicationCommand.ts index 2431fc924f359..312133c85e5ce 100644 --- a/clients/client-appconfig/commands/DeleteApplicationCommand.ts +++ b/clients/client-appconfig/commands/DeleteApplicationCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteApplicationCommandInput = DeleteApplicationRequest; export type DeleteApplicationCommandOutput = __MetadataBearer; +/** + *

Delete an application. Deleting an application does not delete a configuration from a + * host.

+ */ export class DeleteApplicationCommand extends $Command< DeleteApplicationCommandInput, DeleteApplicationCommandOutput, @@ -34,6 +38,9 @@ export class DeleteApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/DeleteConfigurationProfileCommand.ts b/clients/client-appconfig/commands/DeleteConfigurationProfileCommand.ts index d943e494e04c2..ef2d0567d49bb 100644 --- a/clients/client-appconfig/commands/DeleteConfigurationProfileCommand.ts +++ b/clients/client-appconfig/commands/DeleteConfigurationProfileCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteConfigurationProfileCommandInput = DeleteConfigurationProfileRequest; export type DeleteConfigurationProfileCommandOutput = __MetadataBearer; +/** + *

Delete a configuration profile. Deleting a configuration profile does not delete a + * configuration from a host.

+ */ export class DeleteConfigurationProfileCommand extends $Command< DeleteConfigurationProfileCommandInput, DeleteConfigurationProfileCommandOutput, @@ -34,6 +38,9 @@ export class DeleteConfigurationProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/DeleteDeploymentStrategyCommand.ts b/clients/client-appconfig/commands/DeleteDeploymentStrategyCommand.ts index b3cf6237d0984..b2c528a213df4 100644 --- a/clients/client-appconfig/commands/DeleteDeploymentStrategyCommand.ts +++ b/clients/client-appconfig/commands/DeleteDeploymentStrategyCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDeploymentStrategyCommandInput = DeleteDeploymentStrategyRequest; export type DeleteDeploymentStrategyCommandOutput = __MetadataBearer; +/** + *

Delete a deployment strategy. Deleting a deployment strategy does not delete a + * configuration from a host.

+ */ export class DeleteDeploymentStrategyCommand extends $Command< DeleteDeploymentStrategyCommandInput, DeleteDeploymentStrategyCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDeploymentStrategyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/DeleteEnvironmentCommand.ts b/clients/client-appconfig/commands/DeleteEnvironmentCommand.ts index 5202aa94deaca..99e68eb4cbf88 100644 --- a/clients/client-appconfig/commands/DeleteEnvironmentCommand.ts +++ b/clients/client-appconfig/commands/DeleteEnvironmentCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteEnvironmentCommandInput = DeleteEnvironmentRequest; export type DeleteEnvironmentCommandOutput = __MetadataBearer; +/** + *

Delete an environment. Deleting an environment does not delete a configuration from a + * host.

+ */ export class DeleteEnvironmentCommand extends $Command< DeleteEnvironmentCommandInput, DeleteEnvironmentCommandOutput, @@ -34,6 +38,9 @@ export class DeleteEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/DeleteHostedConfigurationVersionCommand.ts b/clients/client-appconfig/commands/DeleteHostedConfigurationVersionCommand.ts index ae0e9931c2b6a..4f99bd3353eb6 100644 --- a/clients/client-appconfig/commands/DeleteHostedConfigurationVersionCommand.ts +++ b/clients/client-appconfig/commands/DeleteHostedConfigurationVersionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteHostedConfigurationVersionCommandInput = DeleteHostedConfigurationVersionRequest; export type DeleteHostedConfigurationVersionCommandOutput = __MetadataBearer; +/** + *

Delete a version of a configuration from the AppConfig configuration store.

+ */ export class DeleteHostedConfigurationVersionCommand extends $Command< DeleteHostedConfigurationVersionCommandInput, DeleteHostedConfigurationVersionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteHostedConfigurationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/GetApplicationCommand.ts b/clients/client-appconfig/commands/GetApplicationCommand.ts index a73f71ea07e76..51a25fbc114cd 100644 --- a/clients/client-appconfig/commands/GetApplicationCommand.ts +++ b/clients/client-appconfig/commands/GetApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type GetApplicationCommandInput = GetApplicationRequest; export type GetApplicationCommandOutput = Application & __MetadataBearer; +/** + *

Retrieve information about an application.

+ */ export class GetApplicationCommand extends $Command< GetApplicationCommandInput, GetApplicationCommandOutput, @@ -34,6 +37,9 @@ export class GetApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/GetConfigurationCommand.ts b/clients/client-appconfig/commands/GetConfigurationCommand.ts index 4d55d5fb6a504..66fb823d86756 100644 --- a/clients/client-appconfig/commands/GetConfigurationCommand.ts +++ b/clients/client-appconfig/commands/GetConfigurationCommand.ts @@ -20,6 +20,21 @@ import { export type GetConfigurationCommandInput = GetConfigurationRequest; export type GetConfigurationCommandOutput = Configuration & __MetadataBearer; +/** + *

Receive information about a configuration.

+ * + *

AWS AppConfig uses the value of the ClientConfigurationVersion parameter + * to identify the configuration version on your clients. If you don’t send + * ClientConfigurationVersion with each call to + * GetConfiguration, your clients receive the current configuration. You + * are charged each time your clients receive a configuration.

+ *

To avoid excess charges, we recommend that you include the + * ClientConfigurationVersion value with every call to + * GetConfiguration. This value must be saved on your client. Subsequent + * calls to GetConfiguration must pass this value by using the + * ClientConfigurationVersion parameter.

+ *
+ */ export class GetConfigurationCommand extends $Command< GetConfigurationCommandInput, GetConfigurationCommandOutput, @@ -34,6 +49,9 @@ export class GetConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/GetConfigurationProfileCommand.ts b/clients/client-appconfig/commands/GetConfigurationProfileCommand.ts index f4df016bfe934..6b2e88ebfbfe6 100644 --- a/clients/client-appconfig/commands/GetConfigurationProfileCommand.ts +++ b/clients/client-appconfig/commands/GetConfigurationProfileCommand.ts @@ -20,6 +20,9 @@ import { export type GetConfigurationProfileCommandInput = GetConfigurationProfileRequest; export type GetConfigurationProfileCommandOutput = ConfigurationProfile & __MetadataBearer; +/** + *

Retrieve information about a configuration profile.

+ */ export class GetConfigurationProfileCommand extends $Command< GetConfigurationProfileCommandInput, GetConfigurationProfileCommandOutput, @@ -34,6 +37,9 @@ export class GetConfigurationProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/GetDeploymentCommand.ts b/clients/client-appconfig/commands/GetDeploymentCommand.ts index b8c0a0f34a325..95f2ae433b142 100644 --- a/clients/client-appconfig/commands/GetDeploymentCommand.ts +++ b/clients/client-appconfig/commands/GetDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentCommandInput = GetDeploymentRequest; export type GetDeploymentCommandOutput = Deployment & __MetadataBearer; +/** + *

Retrieve information about a configuration deployment.

+ */ export class GetDeploymentCommand extends $Command< GetDeploymentCommandInput, GetDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/GetDeploymentStrategyCommand.ts b/clients/client-appconfig/commands/GetDeploymentStrategyCommand.ts index 6770562029d41..5a4c72221ddf1 100644 --- a/clients/client-appconfig/commands/GetDeploymentStrategyCommand.ts +++ b/clients/client-appconfig/commands/GetDeploymentStrategyCommand.ts @@ -20,6 +20,13 @@ import { export type GetDeploymentStrategyCommandInput = GetDeploymentStrategyRequest; export type GetDeploymentStrategyCommandOutput = DeploymentStrategy & __MetadataBearer; +/** + *

Retrieve information about a deployment strategy. A deployment strategy defines + * important criteria for rolling out your configuration to the designated targets. A + * deployment strategy includes: the overall duration required, a percentage of targets to + * receive the deployment during each interval, an algorithm that defines how percentage + * grows, and bake time.

+ */ export class GetDeploymentStrategyCommand extends $Command< GetDeploymentStrategyCommandInput, GetDeploymentStrategyCommandOutput, @@ -34,6 +41,9 @@ export class GetDeploymentStrategyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/GetEnvironmentCommand.ts b/clients/client-appconfig/commands/GetEnvironmentCommand.ts index c0ca23b21a556..3b4db1825f25f 100644 --- a/clients/client-appconfig/commands/GetEnvironmentCommand.ts +++ b/clients/client-appconfig/commands/GetEnvironmentCommand.ts @@ -20,6 +20,13 @@ import { export type GetEnvironmentCommandInput = GetEnvironmentRequest; export type GetEnvironmentCommandOutput = Environment & __MetadataBearer; +/** + *

Retrieve information about an environment. An environment is a logical deployment group + * of AppConfig applications, such as applications in a Production environment or + * in an EU_Region environment. Each configuration deployment targets an + * environment. You can enable one or more Amazon CloudWatch alarms for an environment. If an alarm is + * triggered during a deployment, AppConfig roles back the configuration.

+ */ export class GetEnvironmentCommand extends $Command< GetEnvironmentCommandInput, GetEnvironmentCommandOutput, @@ -34,6 +41,9 @@ export class GetEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/GetHostedConfigurationVersionCommand.ts b/clients/client-appconfig/commands/GetHostedConfigurationVersionCommand.ts index 1c650e4f6c5b5..ea1d7d0889c57 100644 --- a/clients/client-appconfig/commands/GetHostedConfigurationVersionCommand.ts +++ b/clients/client-appconfig/commands/GetHostedConfigurationVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetHostedConfigurationVersionCommandInput = GetHostedConfigurationVersionRequest; export type GetHostedConfigurationVersionCommandOutput = HostedConfigurationVersion & __MetadataBearer; +/** + *

Get information about a specific configuration version.

+ */ export class GetHostedConfigurationVersionCommand extends $Command< GetHostedConfigurationVersionCommandInput, GetHostedConfigurationVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetHostedConfigurationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/ListApplicationsCommand.ts b/clients/client-appconfig/commands/ListApplicationsCommand.ts index 682d1ad866451..0b280a7db4a8c 100644 --- a/clients/client-appconfig/commands/ListApplicationsCommand.ts +++ b/clients/client-appconfig/commands/ListApplicationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListApplicationsCommandInput = ListApplicationsRequest; export type ListApplicationsCommandOutput = Applications & __MetadataBearer; +/** + *

List all applications in your AWS account.

+ */ export class ListApplicationsCommand extends $Command< ListApplicationsCommandInput, ListApplicationsCommandOutput, @@ -34,6 +37,9 @@ export class ListApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/ListConfigurationProfilesCommand.ts b/clients/client-appconfig/commands/ListConfigurationProfilesCommand.ts index 91abfe1fdf551..ccd3762b7ffbc 100644 --- a/clients/client-appconfig/commands/ListConfigurationProfilesCommand.ts +++ b/clients/client-appconfig/commands/ListConfigurationProfilesCommand.ts @@ -20,6 +20,9 @@ import { export type ListConfigurationProfilesCommandInput = ListConfigurationProfilesRequest; export type ListConfigurationProfilesCommandOutput = ConfigurationProfiles & __MetadataBearer; +/** + *

Lists the configuration profiles for an application.

+ */ export class ListConfigurationProfilesCommand extends $Command< ListConfigurationProfilesCommandInput, ListConfigurationProfilesCommandOutput, @@ -34,6 +37,9 @@ export class ListConfigurationProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/ListDeploymentStrategiesCommand.ts b/clients/client-appconfig/commands/ListDeploymentStrategiesCommand.ts index 5652a936ae30b..c095b806be444 100644 --- a/clients/client-appconfig/commands/ListDeploymentStrategiesCommand.ts +++ b/clients/client-appconfig/commands/ListDeploymentStrategiesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDeploymentStrategiesCommandInput = ListDeploymentStrategiesRequest; export type ListDeploymentStrategiesCommandOutput = DeploymentStrategies & __MetadataBearer; +/** + *

List deployment strategies.

+ */ export class ListDeploymentStrategiesCommand extends $Command< ListDeploymentStrategiesCommandInput, ListDeploymentStrategiesCommandOutput, @@ -34,6 +37,9 @@ export class ListDeploymentStrategiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/ListDeploymentsCommand.ts b/clients/client-appconfig/commands/ListDeploymentsCommand.ts index 2963a8394613f..086e53753fc56 100644 --- a/clients/client-appconfig/commands/ListDeploymentsCommand.ts +++ b/clients/client-appconfig/commands/ListDeploymentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDeploymentsCommandInput = ListDeploymentsRequest; export type ListDeploymentsCommandOutput = Deployments & __MetadataBearer; +/** + *

Lists the deployments for an environment.

+ */ export class ListDeploymentsCommand extends $Command< ListDeploymentsCommandInput, ListDeploymentsCommandOutput, @@ -34,6 +37,9 @@ export class ListDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/ListEnvironmentsCommand.ts b/clients/client-appconfig/commands/ListEnvironmentsCommand.ts index 2d57648d781a4..24787671b1db7 100644 --- a/clients/client-appconfig/commands/ListEnvironmentsCommand.ts +++ b/clients/client-appconfig/commands/ListEnvironmentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListEnvironmentsCommandInput = ListEnvironmentsRequest; export type ListEnvironmentsCommandOutput = Environments & __MetadataBearer; +/** + *

List the environments for an application.

+ */ export class ListEnvironmentsCommand extends $Command< ListEnvironmentsCommandInput, ListEnvironmentsCommandOutput, @@ -34,6 +37,9 @@ export class ListEnvironmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/ListHostedConfigurationVersionsCommand.ts b/clients/client-appconfig/commands/ListHostedConfigurationVersionsCommand.ts index 8f3faf52cfedf..bdf488159f76e 100644 --- a/clients/client-appconfig/commands/ListHostedConfigurationVersionsCommand.ts +++ b/clients/client-appconfig/commands/ListHostedConfigurationVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListHostedConfigurationVersionsCommandInput = ListHostedConfigurationVersionsRequest; export type ListHostedConfigurationVersionsCommandOutput = HostedConfigurationVersions & __MetadataBearer; +/** + *

View a list of configurations stored in the AppConfig configuration store by + * version.

+ */ export class ListHostedConfigurationVersionsCommand extends $Command< ListHostedConfigurationVersionsCommandInput, ListHostedConfigurationVersionsCommandOutput, @@ -34,6 +38,9 @@ export class ListHostedConfigurationVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/ListTagsForResourceCommand.ts b/clients/client-appconfig/commands/ListTagsForResourceCommand.ts index e89e73a5ea084..6132607bf5656 100644 --- a/clients/client-appconfig/commands/ListTagsForResourceCommand.ts +++ b/clients/client-appconfig/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ResourceTags & __MetadataBearer; +/** + *

Retrieves the list of key-value tags assigned to the resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/StartDeploymentCommand.ts b/clients/client-appconfig/commands/StartDeploymentCommand.ts index 15724f1d3c583..3bc95071a5a6b 100644 --- a/clients/client-appconfig/commands/StartDeploymentCommand.ts +++ b/clients/client-appconfig/commands/StartDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type StartDeploymentCommandInput = StartDeploymentRequest; export type StartDeploymentCommandOutput = Deployment & __MetadataBearer; +/** + *

Starts a deployment.

+ */ export class StartDeploymentCommand extends $Command< StartDeploymentCommandInput, StartDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class StartDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/StopDeploymentCommand.ts b/clients/client-appconfig/commands/StopDeploymentCommand.ts index 80214323335bb..afcad30d322e3 100644 --- a/clients/client-appconfig/commands/StopDeploymentCommand.ts +++ b/clients/client-appconfig/commands/StopDeploymentCommand.ts @@ -20,6 +20,11 @@ import { export type StopDeploymentCommandInput = StopDeploymentRequest; export type StopDeploymentCommandOutput = Deployment & __MetadataBearer; +/** + *

Stops a deployment. This API action works only on deployments that have a status of + * DEPLOYING. This action moves the deployment to a status of + * ROLLED_BACK.

+ */ export class StopDeploymentCommand extends $Command< StopDeploymentCommandInput, StopDeploymentCommandOutput, @@ -34,6 +39,9 @@ export class StopDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/TagResourceCommand.ts b/clients/client-appconfig/commands/TagResourceCommand.ts index ca6645df10530..92e6372fac14a 100644 --- a/clients/client-appconfig/commands/TagResourceCommand.ts +++ b/clients/client-appconfig/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Metadata to assign to an AppConfig resource. Tags help organize and categorize your + * AppConfig resources. Each tag consists of a key and an optional value, both of which you + * define. You can specify a maximum of 50 tags for a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/UntagResourceCommand.ts b/clients/client-appconfig/commands/UntagResourceCommand.ts index 93c817c14f485..9da83ca0fbcd4 100644 --- a/clients/client-appconfig/commands/UntagResourceCommand.ts +++ b/clients/client-appconfig/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Deletes a tag key and value from an AppConfig resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/UpdateApplicationCommand.ts b/clients/client-appconfig/commands/UpdateApplicationCommand.ts index dd390647721b5..358a6b2f285a7 100644 --- a/clients/client-appconfig/commands/UpdateApplicationCommand.ts +++ b/clients/client-appconfig/commands/UpdateApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationRequest; export type UpdateApplicationCommandOutput = Application & __MetadataBearer; +/** + *

Updates an application.

+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/UpdateConfigurationProfileCommand.ts b/clients/client-appconfig/commands/UpdateConfigurationProfileCommand.ts index a3b4d032214f0..e241bac80567a 100644 --- a/clients/client-appconfig/commands/UpdateConfigurationProfileCommand.ts +++ b/clients/client-appconfig/commands/UpdateConfigurationProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConfigurationProfileCommandInput = UpdateConfigurationProfileRequest; export type UpdateConfigurationProfileCommandOutput = ConfigurationProfile & __MetadataBearer; +/** + *

Updates a configuration profile.

+ */ export class UpdateConfigurationProfileCommand extends $Command< UpdateConfigurationProfileCommandInput, UpdateConfigurationProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConfigurationProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/UpdateDeploymentStrategyCommand.ts b/clients/client-appconfig/commands/UpdateDeploymentStrategyCommand.ts index e019f5198f915..e73134f4bf677 100644 --- a/clients/client-appconfig/commands/UpdateDeploymentStrategyCommand.ts +++ b/clients/client-appconfig/commands/UpdateDeploymentStrategyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDeploymentStrategyCommandInput = UpdateDeploymentStrategyRequest; export type UpdateDeploymentStrategyCommandOutput = DeploymentStrategy & __MetadataBearer; +/** + *

Updates a deployment strategy.

+ */ export class UpdateDeploymentStrategyCommand extends $Command< UpdateDeploymentStrategyCommandInput, UpdateDeploymentStrategyCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDeploymentStrategyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/UpdateEnvironmentCommand.ts b/clients/client-appconfig/commands/UpdateEnvironmentCommand.ts index 89d54c6d164e0..c8110eec559c9 100644 --- a/clients/client-appconfig/commands/UpdateEnvironmentCommand.ts +++ b/clients/client-appconfig/commands/UpdateEnvironmentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEnvironmentCommandInput = UpdateEnvironmentRequest; export type UpdateEnvironmentCommandOutput = Environment & __MetadataBearer; +/** + *

Updates an environment.

+ */ export class UpdateEnvironmentCommand extends $Command< UpdateEnvironmentCommandInput, UpdateEnvironmentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/commands/ValidateConfigurationCommand.ts b/clients/client-appconfig/commands/ValidateConfigurationCommand.ts index ec62327250818..83a9edc522e1a 100644 --- a/clients/client-appconfig/commands/ValidateConfigurationCommand.ts +++ b/clients/client-appconfig/commands/ValidateConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type ValidateConfigurationCommandInput = ValidateConfigurationRequest; export type ValidateConfigurationCommandOutput = __MetadataBearer; +/** + *

Uses the validators in a configuration profile to validate a configuration.

+ */ export class ValidateConfigurationCommand extends $Command< ValidateConfigurationCommandInput, ValidateConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class ValidateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppConfigClientResolvedConfig, diff --git a/clients/client-appconfig/package.json b/clients/client-appconfig/package.json index 6bc5734288057..a0cef1098f7ae 100644 --- a/clients/client-appconfig/package.json +++ b/clients/client-appconfig/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Appconfig Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-appconfig/pagination/ListApplicationsPaginator.ts b/clients/client-appconfig/pagination/ListApplicationsPaginator.ts index bf0bb80972b99..1210a8edfd04a 100644 --- a/clients/client-appconfig/pagination/ListApplicationsPaginator.ts +++ b/clients/client-appconfig/pagination/ListApplicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { AppConfigPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppConfigClient, input: ListApplicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppConfig, input: ListApplicationsCommandInput, diff --git a/clients/client-appconfig/pagination/ListConfigurationProfilesPaginator.ts b/clients/client-appconfig/pagination/ListConfigurationProfilesPaginator.ts index e13a6b6d27770..63f92ad43b2ab 100644 --- a/clients/client-appconfig/pagination/ListConfigurationProfilesPaginator.ts +++ b/clients/client-appconfig/pagination/ListConfigurationProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { AppConfigPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppConfigClient, input: ListConfigurationProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConfigurationProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppConfig, input: ListConfigurationProfilesCommandInput, diff --git a/clients/client-appconfig/pagination/ListDeploymentStrategiesPaginator.ts b/clients/client-appconfig/pagination/ListDeploymentStrategiesPaginator.ts index 0679549f164e6..1d82303473503 100644 --- a/clients/client-appconfig/pagination/ListDeploymentStrategiesPaginator.ts +++ b/clients/client-appconfig/pagination/ListDeploymentStrategiesPaginator.ts @@ -8,6 +8,9 @@ import { import { AppConfigPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppConfigClient, input: ListDeploymentStrategiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeploymentStrategiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppConfig, input: ListDeploymentStrategiesCommandInput, diff --git a/clients/client-appconfig/pagination/ListDeploymentsPaginator.ts b/clients/client-appconfig/pagination/ListDeploymentsPaginator.ts index e52581a6e9cd3..6915818607341 100644 --- a/clients/client-appconfig/pagination/ListDeploymentsPaginator.ts +++ b/clients/client-appconfig/pagination/ListDeploymentsPaginator.ts @@ -8,6 +8,9 @@ import { import { AppConfigPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppConfigClient, input: ListDeploymentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeploymentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppConfig, input: ListDeploymentsCommandInput, diff --git a/clients/client-appconfig/pagination/ListEnvironmentsPaginator.ts b/clients/client-appconfig/pagination/ListEnvironmentsPaginator.ts index cb57fdfc8b817..f25549206f7f1 100644 --- a/clients/client-appconfig/pagination/ListEnvironmentsPaginator.ts +++ b/clients/client-appconfig/pagination/ListEnvironmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { AppConfigPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppConfigClient, input: ListEnvironmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEnvironmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppConfig, input: ListEnvironmentsCommandInput, diff --git a/clients/client-appconfig/pagination/ListHostedConfigurationVersionsPaginator.ts b/clients/client-appconfig/pagination/ListHostedConfigurationVersionsPaginator.ts index 384d9cb1f5a6c..512382ed977e8 100644 --- a/clients/client-appconfig/pagination/ListHostedConfigurationVersionsPaginator.ts +++ b/clients/client-appconfig/pagination/ListHostedConfigurationVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { AppConfigPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppConfigClient, input: ListHostedConfigurationVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHostedConfigurationVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppConfig, input: ListHostedConfigurationVersionsCommandInput, diff --git a/clients/client-appconfig/runtimeConfig.browser.ts b/clients/client-appconfig/runtimeConfig.browser.ts index dfba8eeedae2e..f650c4ff3e5fe 100644 --- a/clients/client-appconfig/runtimeConfig.browser.ts +++ b/clients/client-appconfig/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AppConfigClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-appconfig/runtimeConfig.native.ts b/clients/client-appconfig/runtimeConfig.native.ts index 4ef3ca3df96bb..af56e0576fd67 100644 --- a/clients/client-appconfig/runtimeConfig.native.ts +++ b/clients/client-appconfig/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AppConfigClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-appconfig/runtimeConfig.shared.ts b/clients/client-appconfig/runtimeConfig.shared.ts index 330f7a24ed99d..2144e1fe441b7 100644 --- a/clients/client-appconfig/runtimeConfig.shared.ts +++ b/clients/client-appconfig/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-10-09", disableHostPrefix: false, diff --git a/clients/client-appconfig/runtimeConfig.ts b/clients/client-appconfig/runtimeConfig.ts index 038398c04ea28..489ae088f3867 100644 --- a/clients/client-appconfig/runtimeConfig.ts +++ b/clients/client-appconfig/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AppConfigClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-appconfig/tsconfig.json b/clients/client-appconfig/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-appconfig/tsconfig.json +++ b/clients/client-appconfig/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-appflow/commands/CreateConnectorProfileCommand.ts b/clients/client-appflow/commands/CreateConnectorProfileCommand.ts index 30ef72b90454b..a75ea94b5d32d 100644 --- a/clients/client-appflow/commands/CreateConnectorProfileCommand.ts +++ b/clients/client-appflow/commands/CreateConnectorProfileCommand.ts @@ -20,6 +20,11 @@ import { export type CreateConnectorProfileCommandInput = CreateConnectorProfileRequest; export type CreateConnectorProfileCommandOutput = CreateConnectorProfileResponse & __MetadataBearer; +/** + *

+ * Creates a new connector profile associated with your AWS account. There is a soft quota of 100 connector profiles per AWS account. If you need more connector profiles than this quota allows, you can submit a request to the Amazon AppFlow team through the Amazon AppFlow support channel. + *

+ */ export class CreateConnectorProfileCommand extends $Command< CreateConnectorProfileCommandInput, CreateConnectorProfileCommandOutput, @@ -34,6 +39,9 @@ export class CreateConnectorProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/CreateFlowCommand.ts b/clients/client-appflow/commands/CreateFlowCommand.ts index 226ed10e71f3a..5fb10f2c31502 100644 --- a/clients/client-appflow/commands/CreateFlowCommand.ts +++ b/clients/client-appflow/commands/CreateFlowCommand.ts @@ -20,6 +20,12 @@ import { export type CreateFlowCommandInput = CreateFlowRequest; export type CreateFlowCommandOutput = CreateFlowResponse & __MetadataBearer; +/** + *

+ * Enables your application to create a new flow using Amazon AppFlow. You must create a connector profile before calling this API. Please note that the Request Syntax below shows syntax for multiple destinations, however, you can only transfer data to one item in this list at a time. Amazon AppFlow does not currently support flows to multiple destinations at once. + * + *

+ */ export class CreateFlowCommand extends $Command< CreateFlowCommandInput, CreateFlowCommandOutput, @@ -34,6 +40,9 @@ export class CreateFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/DeleteConnectorProfileCommand.ts b/clients/client-appflow/commands/DeleteConnectorProfileCommand.ts index cdd3d7e801e17..d5091cdcb4cef 100644 --- a/clients/client-appflow/commands/DeleteConnectorProfileCommand.ts +++ b/clients/client-appflow/commands/DeleteConnectorProfileCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteConnectorProfileCommandInput = DeleteConnectorProfileRequest; export type DeleteConnectorProfileCommandOutput = DeleteConnectorProfileResponse & __MetadataBearer; +/** + *

+ * Enables you to delete an existing connector profile. + *

+ */ export class DeleteConnectorProfileCommand extends $Command< DeleteConnectorProfileCommandInput, DeleteConnectorProfileCommandOutput, @@ -34,6 +39,9 @@ export class DeleteConnectorProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/DeleteFlowCommand.ts b/clients/client-appflow/commands/DeleteFlowCommand.ts index f7eb6b8277c98..ff3cad0327ba7 100644 --- a/clients/client-appflow/commands/DeleteFlowCommand.ts +++ b/clients/client-appflow/commands/DeleteFlowCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteFlowCommandInput = DeleteFlowRequest; export type DeleteFlowCommandOutput = DeleteFlowResponse & __MetadataBearer; +/** + *

+ * Enables your application to delete an existing flow. Before deleting the flow, Amazon AppFlow validates the request by checking the flow configuration and status. You can delete flows one at a time. + * + *

+ */ export class DeleteFlowCommand extends $Command< DeleteFlowCommandInput, DeleteFlowCommandOutput, @@ -34,6 +40,9 @@ export class DeleteFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/DescribeConnectorEntityCommand.ts b/clients/client-appflow/commands/DescribeConnectorEntityCommand.ts index 008a07238124a..d8fc9e71e3683 100644 --- a/clients/client-appflow/commands/DescribeConnectorEntityCommand.ts +++ b/clients/client-appflow/commands/DescribeConnectorEntityCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeConnectorEntityCommandInput = DescribeConnectorEntityRequest; export type DescribeConnectorEntityCommandOutput = DescribeConnectorEntityResponse & __MetadataBearer; +/** + *

+ * Provides details regarding the entity used with the connector, with a description of the data model for each entity. + *

+ */ export class DescribeConnectorEntityCommand extends $Command< DescribeConnectorEntityCommandInput, DescribeConnectorEntityCommandOutput, @@ -34,6 +39,9 @@ export class DescribeConnectorEntityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/DescribeConnectorProfilesCommand.ts b/clients/client-appflow/commands/DescribeConnectorProfilesCommand.ts index 37173d308ba9a..863b3ccc21d3a 100644 --- a/clients/client-appflow/commands/DescribeConnectorProfilesCommand.ts +++ b/clients/client-appflow/commands/DescribeConnectorProfilesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeConnectorProfilesCommandInput = DescribeConnectorProfilesRequest; export type DescribeConnectorProfilesCommandOutput = DescribeConnectorProfilesResponse & __MetadataBearer; +/** + *

+ * Returns a list of connector-profile details matching the provided connector-profile names and connector-types. Both input lists are optional, and you can use them to filter the result.

+ *

If no names or connector-types are provided, returns all connector profiles in a paginated form. If there is no match, this operation returns an empty list.

+ */ export class DescribeConnectorProfilesCommand extends $Command< DescribeConnectorProfilesCommandInput, DescribeConnectorProfilesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeConnectorProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/DescribeConnectorsCommand.ts b/clients/client-appflow/commands/DescribeConnectorsCommand.ts index 695e90125f01b..532a36107631c 100644 --- a/clients/client-appflow/commands/DescribeConnectorsCommand.ts +++ b/clients/client-appflow/commands/DescribeConnectorsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeConnectorsCommandInput = DescribeConnectorsRequest; export type DescribeConnectorsCommandOutput = DescribeConnectorsResponse & __MetadataBearer; +/** + *

+ * Describes the connectors vended by Amazon AppFlow for specified connector types. If you don't specify a connector type, this operation describes all connectors vended by Amazon AppFlow. + * If there are more connectors than can be returned in one page, the response contains a nextToken object, which can be be passed in to the next call to the DescribeConnectors API operation to retrieve the next page. + *

+ */ export class DescribeConnectorsCommand extends $Command< DescribeConnectorsCommandInput, DescribeConnectorsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeConnectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/DescribeFlowCommand.ts b/clients/client-appflow/commands/DescribeFlowCommand.ts index bc80a61afb8ed..ad25e885ce2a8 100644 --- a/clients/client-appflow/commands/DescribeFlowCommand.ts +++ b/clients/client-appflow/commands/DescribeFlowCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeFlowCommandInput = DescribeFlowRequest; export type DescribeFlowCommandOutput = DescribeFlowResponse & __MetadataBearer; +/** + *

+ * Provides a description of the specified flow. + * + *

+ */ export class DescribeFlowCommand extends $Command< DescribeFlowCommandInput, DescribeFlowCommandOutput, @@ -34,6 +40,9 @@ export class DescribeFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/DescribeFlowExecutionRecordsCommand.ts b/clients/client-appflow/commands/DescribeFlowExecutionRecordsCommand.ts index d7d98c4e9e949..915a6e2f1d2ac 100644 --- a/clients/client-appflow/commands/DescribeFlowExecutionRecordsCommand.ts +++ b/clients/client-appflow/commands/DescribeFlowExecutionRecordsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeFlowExecutionRecordsCommandInput = DescribeFlowExecutionRecordsRequest; export type DescribeFlowExecutionRecordsCommandOutput = DescribeFlowExecutionRecordsResponse & __MetadataBearer; +/** + *

+ * Fetches the execution history of the flow. + *

+ */ export class DescribeFlowExecutionRecordsCommand extends $Command< DescribeFlowExecutionRecordsCommandInput, DescribeFlowExecutionRecordsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeFlowExecutionRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/ListConnectorEntitiesCommand.ts b/clients/client-appflow/commands/ListConnectorEntitiesCommand.ts index 3dd5eea35d873..e2bc74e7b1eb5 100644 --- a/clients/client-appflow/commands/ListConnectorEntitiesCommand.ts +++ b/clients/client-appflow/commands/ListConnectorEntitiesCommand.ts @@ -20,6 +20,11 @@ import { export type ListConnectorEntitiesCommandInput = ListConnectorEntitiesRequest; export type ListConnectorEntitiesCommandOutput = ListConnectorEntitiesResponse & __MetadataBearer; +/** + *

+ * Returns the list of available connector entities supported by Amazon AppFlow. For example, you can query Salesforce for Account and Opportunity entities, or query ServiceNow for the Incident entity. + *

+ */ export class ListConnectorEntitiesCommand extends $Command< ListConnectorEntitiesCommandInput, ListConnectorEntitiesCommandOutput, @@ -34,6 +39,9 @@ export class ListConnectorEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/ListFlowsCommand.ts b/clients/client-appflow/commands/ListFlowsCommand.ts index 84ea3df49f0e7..81d54a00b07eb 100644 --- a/clients/client-appflow/commands/ListFlowsCommand.ts +++ b/clients/client-appflow/commands/ListFlowsCommand.ts @@ -20,6 +20,11 @@ import { export type ListFlowsCommandInput = ListFlowsRequest; export type ListFlowsCommandOutput = ListFlowsResponse & __MetadataBearer; +/** + *

+ * Lists all of the flows associated with your account. + *

+ */ export class ListFlowsCommand extends $Command< ListFlowsCommandInput, ListFlowsCommandOutput, @@ -34,6 +39,9 @@ export class ListFlowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/ListTagsForResourceCommand.ts b/clients/client-appflow/commands/ListTagsForResourceCommand.ts index 5270ce5e0349d..b7dac3662e5bb 100644 --- a/clients/client-appflow/commands/ListTagsForResourceCommand.ts +++ b/clients/client-appflow/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

+ * Retrieves the tags that are associated with a specified flow. + *

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/StartFlowCommand.ts b/clients/client-appflow/commands/StartFlowCommand.ts index 470b2f4b0a535..15fc927a34fd7 100644 --- a/clients/client-appflow/commands/StartFlowCommand.ts +++ b/clients/client-appflow/commands/StartFlowCommand.ts @@ -20,6 +20,12 @@ import { export type StartFlowCommandInput = StartFlowRequest; export type StartFlowCommandOutput = StartFlowResponse & __MetadataBearer; +/** + *

+ * Activates an existing flow. For on-demand flows, this operation runs the flow immediately. For schedule and event-triggered flows, this operation activates the flow. + * + *

+ */ export class StartFlowCommand extends $Command< StartFlowCommandInput, StartFlowCommandOutput, @@ -34,6 +40,9 @@ export class StartFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/StopFlowCommand.ts b/clients/client-appflow/commands/StopFlowCommand.ts index 4b1eb78621d91..608bb373ba8ca 100644 --- a/clients/client-appflow/commands/StopFlowCommand.ts +++ b/clients/client-appflow/commands/StopFlowCommand.ts @@ -20,6 +20,11 @@ import { export type StopFlowCommandInput = StopFlowRequest; export type StopFlowCommandOutput = StopFlowResponse & __MetadataBearer; +/** + *

+ * Deactivates the existing flow. For on-demand flows, this operation returns an unsupportedOperationException error message. For schedule and event-triggered flows, this operation deactivates the flow. + *

+ */ export class StopFlowCommand extends $Command< StopFlowCommandInput, StopFlowCommandOutput, @@ -34,6 +39,9 @@ export class StopFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/TagResourceCommand.ts b/clients/client-appflow/commands/TagResourceCommand.ts index 6db254419d4d6..86dbf7aea4570 100644 --- a/clients/client-appflow/commands/TagResourceCommand.ts +++ b/clients/client-appflow/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

+ * Applies a tag to the specified flow. + *

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/UntagResourceCommand.ts b/clients/client-appflow/commands/UntagResourceCommand.ts index f7923d8cfbdd6..94077120eff3f 100644 --- a/clients/client-appflow/commands/UntagResourceCommand.ts +++ b/clients/client-appflow/commands/UntagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

+ * Removes a tag from the specified flow. + *

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/UpdateConnectorProfileCommand.ts b/clients/client-appflow/commands/UpdateConnectorProfileCommand.ts index 7617ee12e0a0a..cd626b1153994 100644 --- a/clients/client-appflow/commands/UpdateConnectorProfileCommand.ts +++ b/clients/client-appflow/commands/UpdateConnectorProfileCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateConnectorProfileCommandInput = UpdateConnectorProfileRequest; export type UpdateConnectorProfileCommandOutput = UpdateConnectorProfileResponse & __MetadataBearer; +/** + *

+ * Updates a given connector profile associated with your account. + *

+ */ export class UpdateConnectorProfileCommand extends $Command< UpdateConnectorProfileCommandInput, UpdateConnectorProfileCommandOutput, @@ -34,6 +39,9 @@ export class UpdateConnectorProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/commands/UpdateFlowCommand.ts b/clients/client-appflow/commands/UpdateFlowCommand.ts index 19abdecd9e417..04f828f68ce2b 100644 --- a/clients/client-appflow/commands/UpdateFlowCommand.ts +++ b/clients/client-appflow/commands/UpdateFlowCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateFlowCommandInput = UpdateFlowRequest; export type UpdateFlowCommandOutput = UpdateFlowResponse & __MetadataBearer; +/** + *

+ * Updates an existing flow. + *

+ */ export class UpdateFlowCommand extends $Command< UpdateFlowCommandInput, UpdateFlowCommandOutput, @@ -34,6 +39,9 @@ export class UpdateFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppflowClientResolvedConfig, diff --git a/clients/client-appflow/package.json b/clients/client-appflow/package.json index 0c1486032b390..8ebfb31034c89 100644 --- a/clients/client-appflow/package.json +++ b/clients/client-appflow/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Appflow Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-appflow/pagination/DescribeConnectorProfilesPaginator.ts b/clients/client-appflow/pagination/DescribeConnectorProfilesPaginator.ts index dc3a0acbbf764..7516f8707633c 100644 --- a/clients/client-appflow/pagination/DescribeConnectorProfilesPaginator.ts +++ b/clients/client-appflow/pagination/DescribeConnectorProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { AppflowPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppflowClient, input: DescribeConnectorProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeConnectorProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Appflow, input: DescribeConnectorProfilesCommandInput, diff --git a/clients/client-appflow/pagination/DescribeConnectorsPaginator.ts b/clients/client-appflow/pagination/DescribeConnectorsPaginator.ts index f115aed96e5d1..00605fc1ad9c6 100644 --- a/clients/client-appflow/pagination/DescribeConnectorsPaginator.ts +++ b/clients/client-appflow/pagination/DescribeConnectorsPaginator.ts @@ -8,6 +8,9 @@ import { import { AppflowPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppflowClient, input: DescribeConnectorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeConnectorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Appflow, input: DescribeConnectorsCommandInput, diff --git a/clients/client-appflow/pagination/DescribeFlowExecutionRecordsPaginator.ts b/clients/client-appflow/pagination/DescribeFlowExecutionRecordsPaginator.ts index 03146a244d775..b8824a365de17 100644 --- a/clients/client-appflow/pagination/DescribeFlowExecutionRecordsPaginator.ts +++ b/clients/client-appflow/pagination/DescribeFlowExecutionRecordsPaginator.ts @@ -8,6 +8,9 @@ import { import { AppflowPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppflowClient, input: DescribeFlowExecutionRecordsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFlowExecutionRecordsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Appflow, input: DescribeFlowExecutionRecordsCommandInput, diff --git a/clients/client-appflow/pagination/ListFlowsPaginator.ts b/clients/client-appflow/pagination/ListFlowsPaginator.ts index 634a87565a9e4..744c8b8340c91 100644 --- a/clients/client-appflow/pagination/ListFlowsPaginator.ts +++ b/clients/client-appflow/pagination/ListFlowsPaginator.ts @@ -4,6 +4,9 @@ import { ListFlowsCommand, ListFlowsCommandInput, ListFlowsCommandOutput } from import { AppflowPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppflowClient, input: ListFlowsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFlowsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Appflow, input: ListFlowsCommandInput, diff --git a/clients/client-appflow/runtimeConfig.browser.ts b/clients/client-appflow/runtimeConfig.browser.ts index ceb8367d13df1..29ab56d33b279 100644 --- a/clients/client-appflow/runtimeConfig.browser.ts +++ b/clients/client-appflow/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AppflowClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-appflow/runtimeConfig.native.ts b/clients/client-appflow/runtimeConfig.native.ts index c5912bf0b62a2..42e5f2fe5fbe1 100644 --- a/clients/client-appflow/runtimeConfig.native.ts +++ b/clients/client-appflow/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AppflowClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-appflow/runtimeConfig.shared.ts b/clients/client-appflow/runtimeConfig.shared.ts index 90072249d7b58..924a89fecdd49 100644 --- a/clients/client-appflow/runtimeConfig.shared.ts +++ b/clients/client-appflow/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-08-23", disableHostPrefix: false, diff --git a/clients/client-appflow/runtimeConfig.ts b/clients/client-appflow/runtimeConfig.ts index 62279cf9b1471..1a315f3cf68cb 100644 --- a/clients/client-appflow/runtimeConfig.ts +++ b/clients/client-appflow/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AppflowClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-appflow/tsconfig.json b/clients/client-appflow/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-appflow/tsconfig.json +++ b/clients/client-appflow/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-application-auto-scaling/commands/DeleteScalingPolicyCommand.ts b/clients/client-application-auto-scaling/commands/DeleteScalingPolicyCommand.ts index 48aac2b2690f6..a7dce62e82125 100644 --- a/clients/client-application-auto-scaling/commands/DeleteScalingPolicyCommand.ts +++ b/clients/client-application-auto-scaling/commands/DeleteScalingPolicyCommand.ts @@ -24,6 +24,14 @@ import { export type DeleteScalingPolicyCommandInput = DeleteScalingPolicyRequest; export type DeleteScalingPolicyCommandOutput = DeleteScalingPolicyResponse & __MetadataBearer; +/** + *

Deletes the specified scaling policy for an Application Auto Scaling scalable target.

+ *

Deleting a step scaling policy deletes the underlying alarm action, but does not delete + * the CloudWatch alarm associated with the scaling policy, even if it no longer has an associated + * action.

+ *

For more information, see Delete a Step Scaling Policy and Delete a Target Tracking Scaling Policy in the + * Application Auto Scaling User Guide.

+ */ export class DeleteScalingPolicyCommand extends $Command< DeleteScalingPolicyCommandInput, DeleteScalingPolicyCommandOutput, @@ -38,6 +46,9 @@ export class DeleteScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/DeleteScheduledActionCommand.ts b/clients/client-application-auto-scaling/commands/DeleteScheduledActionCommand.ts index 456104f1454c0..c0064d64d0cd5 100644 --- a/clients/client-application-auto-scaling/commands/DeleteScheduledActionCommand.ts +++ b/clients/client-application-auto-scaling/commands/DeleteScheduledActionCommand.ts @@ -24,6 +24,10 @@ import { export type DeleteScheduledActionCommandInput = DeleteScheduledActionRequest; export type DeleteScheduledActionCommandOutput = DeleteScheduledActionResponse & __MetadataBearer; +/** + *

Deletes the specified scheduled action for an Application Auto Scaling scalable target.

+ *

For more information, see Delete a Scheduled Action in the Application Auto Scaling User Guide.

+ */ export class DeleteScheduledActionCommand extends $Command< DeleteScheduledActionCommandInput, DeleteScheduledActionCommandOutput, @@ -38,6 +42,9 @@ export class DeleteScheduledActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/DeregisterScalableTargetCommand.ts b/clients/client-application-auto-scaling/commands/DeregisterScalableTargetCommand.ts index e9e0ab924bda8..771eec3a64780 100644 --- a/clients/client-application-auto-scaling/commands/DeregisterScalableTargetCommand.ts +++ b/clients/client-application-auto-scaling/commands/DeregisterScalableTargetCommand.ts @@ -24,6 +24,14 @@ import { export type DeregisterScalableTargetCommandInput = DeregisterScalableTargetRequest; export type DeregisterScalableTargetCommandOutput = DeregisterScalableTargetResponse & __MetadataBearer; +/** + *

Deregisters an Application Auto Scaling scalable target when you have finished using it. To see which + * resources have been registered, use DescribeScalableTargets.

+ * + *

Deregistering a scalable target deletes the scaling policies and the scheduled + * actions that are associated with it.

+ *
+ */ export class DeregisterScalableTargetCommand extends $Command< DeregisterScalableTargetCommandInput, DeregisterScalableTargetCommandOutput, @@ -38,6 +46,9 @@ export class DeregisterScalableTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/DescribeScalableTargetsCommand.ts b/clients/client-application-auto-scaling/commands/DescribeScalableTargetsCommand.ts index 9279404b2f2a2..97828d59dfc2b 100644 --- a/clients/client-application-auto-scaling/commands/DescribeScalableTargetsCommand.ts +++ b/clients/client-application-auto-scaling/commands/DescribeScalableTargetsCommand.ts @@ -24,6 +24,11 @@ import { export type DescribeScalableTargetsCommandInput = DescribeScalableTargetsRequest; export type DescribeScalableTargetsCommandOutput = DescribeScalableTargetsResponse & __MetadataBearer; +/** + *

Gets information about the scalable targets in the specified namespace.

+ *

You can filter the results using ResourceIds and + * ScalableDimension.

+ */ export class DescribeScalableTargetsCommand extends $Command< DescribeScalableTargetsCommandInput, DescribeScalableTargetsCommandOutput, @@ -38,6 +43,9 @@ export class DescribeScalableTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/DescribeScalingActivitiesCommand.ts b/clients/client-application-auto-scaling/commands/DescribeScalingActivitiesCommand.ts index 5f3758e4a12bc..02cb4beda782d 100644 --- a/clients/client-application-auto-scaling/commands/DescribeScalingActivitiesCommand.ts +++ b/clients/client-application-auto-scaling/commands/DescribeScalingActivitiesCommand.ts @@ -24,6 +24,12 @@ import { export type DescribeScalingActivitiesCommandInput = DescribeScalingActivitiesRequest; export type DescribeScalingActivitiesCommandOutput = DescribeScalingActivitiesResponse & __MetadataBearer; +/** + *

Provides descriptive information about the scaling activities in the specified namespace + * from the previous six weeks.

+ *

You can filter the results using ResourceId and + * ScalableDimension.

+ */ export class DescribeScalingActivitiesCommand extends $Command< DescribeScalingActivitiesCommandInput, DescribeScalingActivitiesCommandOutput, @@ -38,6 +44,9 @@ export class DescribeScalingActivitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/DescribeScalingPoliciesCommand.ts b/clients/client-application-auto-scaling/commands/DescribeScalingPoliciesCommand.ts index 81abd4a34255d..37033ede4d29f 100644 --- a/clients/client-application-auto-scaling/commands/DescribeScalingPoliciesCommand.ts +++ b/clients/client-application-auto-scaling/commands/DescribeScalingPoliciesCommand.ts @@ -24,6 +24,12 @@ import { export type DescribeScalingPoliciesCommandInput = DescribeScalingPoliciesRequest; export type DescribeScalingPoliciesCommandOutput = DescribeScalingPoliciesResponse & __MetadataBearer; +/** + *

Describes the Application Auto Scaling scaling policies for the specified service namespace.

+ *

You can filter the results using ResourceId, + * ScalableDimension, and PolicyNames.

+ *

For more information, see Target Tracking Scaling Policies and Step Scaling Policies in the Application Auto Scaling User Guide.

+ */ export class DescribeScalingPoliciesCommand extends $Command< DescribeScalingPoliciesCommandInput, DescribeScalingPoliciesCommandOutput, @@ -38,6 +44,9 @@ export class DescribeScalingPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/DescribeScheduledActionsCommand.ts b/clients/client-application-auto-scaling/commands/DescribeScheduledActionsCommand.ts index dee9901d3e1b8..cacb1f07053cf 100644 --- a/clients/client-application-auto-scaling/commands/DescribeScheduledActionsCommand.ts +++ b/clients/client-application-auto-scaling/commands/DescribeScheduledActionsCommand.ts @@ -24,6 +24,12 @@ import { export type DescribeScheduledActionsCommandInput = DescribeScheduledActionsRequest; export type DescribeScheduledActionsCommandOutput = DescribeScheduledActionsResponse & __MetadataBearer; +/** + *

Describes the Application Auto Scaling scheduled actions for the specified service namespace.

+ *

You can filter the results using the ResourceId, + * ScalableDimension, and ScheduledActionNames parameters.

+ *

For more information, see Scheduled Scaling in the Application Auto Scaling User Guide.

+ */ export class DescribeScheduledActionsCommand extends $Command< DescribeScheduledActionsCommandInput, DescribeScheduledActionsCommandOutput, @@ -38,6 +44,9 @@ export class DescribeScheduledActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/PutScalingPolicyCommand.ts b/clients/client-application-auto-scaling/commands/PutScalingPolicyCommand.ts index 88774b273ce73..ba0ef647d568b 100644 --- a/clients/client-application-auto-scaling/commands/PutScalingPolicyCommand.ts +++ b/clients/client-application-auto-scaling/commands/PutScalingPolicyCommand.ts @@ -24,6 +24,33 @@ import { export type PutScalingPolicyCommandInput = PutScalingPolicyRequest; export type PutScalingPolicyCommandOutput = PutScalingPolicyResponse & __MetadataBearer; +/** + *

Creates or updates a scaling policy for an Application Auto Scaling scalable target.

+ *

Each scalable target is identified by a service namespace, resource ID, and scalable + * dimension. A scaling policy applies to the scalable target identified by those three + * attributes. You cannot create a scaling policy until you have registered the resource as a + * scalable target.

+ *

Multiple scaling policies can be in force at the same time for the same scalable target. + * You can have one or more target tracking scaling policies, one or more step scaling + * policies, or both. However, there is a chance that multiple policies could conflict, + * instructing the scalable target to scale out or in at the same time. Application Auto Scaling gives + * precedence to the policy that provides the largest capacity for both scale out and scale + * in. For example, if one policy increases capacity by 3, another policy increases capacity + * by 200 percent, and the current capacity is 10, Application Auto Scaling uses the policy with the highest + * calculated capacity (200% of 10 = 20) and scales out to 30.

+ *

We recommend caution, however, when using target tracking scaling policies with step + * scaling policies because conflicts between these policies can cause undesirable behavior. + * For example, if the step scaling policy initiates a scale-in activity before the target + * tracking policy is ready to scale in, the scale-in activity will not be blocked. After the + * scale-in activity completes, the target tracking policy could instruct the scalable target + * to scale out again.

+ *

For more information, see Target Tracking Scaling Policies and Step Scaling Policies in the Application Auto Scaling User Guide.

+ * + *

If a scalable target is deregistered, the scalable target is no longer available to + * execute scaling policies. Any scaling policies that were specified for the scalable + * target are deleted.

+ *
+ */ export class PutScalingPolicyCommand extends $Command< PutScalingPolicyCommandInput, PutScalingPolicyCommandOutput, @@ -38,6 +65,9 @@ export class PutScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/PutScheduledActionCommand.ts b/clients/client-application-auto-scaling/commands/PutScheduledActionCommand.ts index 70011309329d4..1673bb2534ed6 100644 --- a/clients/client-application-auto-scaling/commands/PutScheduledActionCommand.ts +++ b/clients/client-application-auto-scaling/commands/PutScheduledActionCommand.ts @@ -24,6 +24,23 @@ import { export type PutScheduledActionCommandInput = PutScheduledActionRequest; export type PutScheduledActionCommandOutput = PutScheduledActionResponse & __MetadataBearer; +/** + *

Creates or updates a scheduled action for an Application Auto Scaling scalable target.

+ *

Each scalable target is identified by a service namespace, resource ID, and scalable + * dimension. A scheduled action applies to the scalable target identified by those three + * attributes. You cannot create a scheduled action until you have registered the resource as + * a scalable target.

+ *

When start and end times are specified with a recurring schedule using a cron expression + * or rates, they form the boundaries of when the recurring action starts and stops.

+ *

To update a scheduled action, specify the parameters that you want to change. If you + * don't specify start and end times, the old values are deleted.

+ *

For more information, see Scheduled Scaling in the Application Auto Scaling User Guide.

+ * + *

If a scalable target is deregistered, the scalable target is no longer available to + * run scheduled actions. Any scheduled actions that were specified for the scalable target + * are deleted.

+ *
+ */ export class PutScheduledActionCommand extends $Command< PutScheduledActionCommandInput, PutScheduledActionCommandOutput, @@ -38,6 +55,9 @@ export class PutScheduledActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/commands/RegisterScalableTargetCommand.ts b/clients/client-application-auto-scaling/commands/RegisterScalableTargetCommand.ts index f300861eed2e5..2af4287b03519 100644 --- a/clients/client-application-auto-scaling/commands/RegisterScalableTargetCommand.ts +++ b/clients/client-application-auto-scaling/commands/RegisterScalableTargetCommand.ts @@ -24,6 +24,23 @@ import { export type RegisterScalableTargetCommandInput = RegisterScalableTargetRequest; export type RegisterScalableTargetCommandOutput = RegisterScalableTargetResponse & __MetadataBearer; +/** + *

Registers or updates a scalable target.

+ *

A scalable target is a resource that Application Auto Scaling can scale out and scale in. Scalable + * targets are uniquely identified by the combination of resource ID, scalable dimension, and + * namespace.

+ *

When you register a new scalable target, you must specify values for minimum and maximum + * capacity. Current capacity will be adjusted within the specified range when scaling starts. + * Application Auto Scaling scaling policies will not scale capacity to values that are outside of this + * range.

+ *

After you register a scalable target, you do not need to register it again to use other + * Application Auto Scaling operations. To see which resources have been registered, use DescribeScalableTargets. You can also view the scaling policies for a service + * namespace by using DescribeScalableTargets. If you no longer need a scalable target, you can + * deregister it by using DeregisterScalableTarget.

+ *

To update a scalable target, specify the parameters that you want to change. Include the + * parameters that identify the scalable target: resource ID, scalable dimension, and + * namespace. Any parameters that you don't specify are not changed by this update request.

+ */ export class RegisterScalableTargetCommand extends $Command< RegisterScalableTargetCommandInput, RegisterScalableTargetCommandOutput, @@ -38,6 +55,9 @@ export class RegisterScalableTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationAutoScalingClientResolvedConfig, diff --git a/clients/client-application-auto-scaling/package.json b/clients/client-application-auto-scaling/package.json index 22b237267e57b..db495fa22da53 100644 --- a/clients/client-application-auto-scaling/package.json +++ b/clients/client-application-auto-scaling/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Application Auto Scaling Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-application-auto-scaling/pagination/DescribeScalableTargetsPaginator.ts b/clients/client-application-auto-scaling/pagination/DescribeScalableTargetsPaginator.ts index c34f713efd60d..e1ddbaf0f6370 100644 --- a/clients/client-application-auto-scaling/pagination/DescribeScalableTargetsPaginator.ts +++ b/clients/client-application-auto-scaling/pagination/DescribeScalableTargetsPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationAutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationAutoScalingClient, input: DescribeScalableTargetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScalableTargetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationAutoScaling, input: DescribeScalableTargetsCommandInput, diff --git a/clients/client-application-auto-scaling/pagination/DescribeScalingActivitiesPaginator.ts b/clients/client-application-auto-scaling/pagination/DescribeScalingActivitiesPaginator.ts index b32c7ef818f15..b9159e2c5bfce 100644 --- a/clients/client-application-auto-scaling/pagination/DescribeScalingActivitiesPaginator.ts +++ b/clients/client-application-auto-scaling/pagination/DescribeScalingActivitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationAutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationAutoScalingClient, input: DescribeScalingActivitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScalingActivitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationAutoScaling, input: DescribeScalingActivitiesCommandInput, diff --git a/clients/client-application-auto-scaling/pagination/DescribeScalingPoliciesPaginator.ts b/clients/client-application-auto-scaling/pagination/DescribeScalingPoliciesPaginator.ts index e9e3adda560d1..19214ebfcf0d4 100644 --- a/clients/client-application-auto-scaling/pagination/DescribeScalingPoliciesPaginator.ts +++ b/clients/client-application-auto-scaling/pagination/DescribeScalingPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationAutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationAutoScalingClient, input: DescribeScalingPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScalingPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationAutoScaling, input: DescribeScalingPoliciesCommandInput, diff --git a/clients/client-application-auto-scaling/pagination/DescribeScheduledActionsPaginator.ts b/clients/client-application-auto-scaling/pagination/DescribeScheduledActionsPaginator.ts index bf6d2df8d2b73..463c5759e0244 100644 --- a/clients/client-application-auto-scaling/pagination/DescribeScheduledActionsPaginator.ts +++ b/clients/client-application-auto-scaling/pagination/DescribeScheduledActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationAutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationAutoScalingClient, input: DescribeScheduledActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScheduledActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationAutoScaling, input: DescribeScheduledActionsCommandInput, diff --git a/clients/client-application-auto-scaling/runtimeConfig.browser.ts b/clients/client-application-auto-scaling/runtimeConfig.browser.ts index c9ad8c11ce469..ea94bbe254b3c 100644 --- a/clients/client-application-auto-scaling/runtimeConfig.browser.ts +++ b/clients/client-application-auto-scaling/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ApplicationAutoScalingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-application-auto-scaling/runtimeConfig.native.ts b/clients/client-application-auto-scaling/runtimeConfig.native.ts index 6d52bfdfea55a..13d98e31c487f 100644 --- a/clients/client-application-auto-scaling/runtimeConfig.native.ts +++ b/clients/client-application-auto-scaling/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ApplicationAutoScalingClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-application-auto-scaling/runtimeConfig.shared.ts b/clients/client-application-auto-scaling/runtimeConfig.shared.ts index d891ffcc3e576..58e4eabf60ffe 100644 --- a/clients/client-application-auto-scaling/runtimeConfig.shared.ts +++ b/clients/client-application-auto-scaling/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-02-06", disableHostPrefix: false, diff --git a/clients/client-application-auto-scaling/runtimeConfig.ts b/clients/client-application-auto-scaling/runtimeConfig.ts index 88f9e92fabc86..6dfa2648669f2 100644 --- a/clients/client-application-auto-scaling/runtimeConfig.ts +++ b/clients/client-application-auto-scaling/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ApplicationAutoScalingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-application-auto-scaling/tsconfig.json b/clients/client-application-auto-scaling/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-application-auto-scaling/tsconfig.json +++ b/clients/client-application-auto-scaling/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-application-discovery-service/commands/AssociateConfigurationItemsToApplicationCommand.ts b/clients/client-application-discovery-service/commands/AssociateConfigurationItemsToApplicationCommand.ts index d21e100a23030..de9e03ca8a26b 100644 --- a/clients/client-application-discovery-service/commands/AssociateConfigurationItemsToApplicationCommand.ts +++ b/clients/client-application-discovery-service/commands/AssociateConfigurationItemsToApplicationCommand.ts @@ -28,6 +28,9 @@ export type AssociateConfigurationItemsToApplicationCommandInput = AssociateConf export type AssociateConfigurationItemsToApplicationCommandOutput = AssociateConfigurationItemsToApplicationResponse & __MetadataBearer; +/** + *

Associates one or more configuration items with an application.

+ */ export class AssociateConfigurationItemsToApplicationCommand extends $Command< AssociateConfigurationItemsToApplicationCommandInput, AssociateConfigurationItemsToApplicationCommandOutput, @@ -42,6 +45,9 @@ export class AssociateConfigurationItemsToApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/BatchDeleteImportDataCommand.ts b/clients/client-application-discovery-service/commands/BatchDeleteImportDataCommand.ts index d71605baa3aa6..47df016e33772 100644 --- a/clients/client-application-discovery-service/commands/BatchDeleteImportDataCommand.ts +++ b/clients/client-application-discovery-service/commands/BatchDeleteImportDataCommand.ts @@ -24,6 +24,16 @@ import { export type BatchDeleteImportDataCommandInput = BatchDeleteImportDataRequest; export type BatchDeleteImportDataCommandOutput = BatchDeleteImportDataResponse & __MetadataBearer; +/** + *

Deletes one or more import tasks, each identified by their import ID. Each import task has + * a number of records that can identify servers or applications.

+ * + *

AWS Application Discovery Service has built-in matching logic that will identify when + * discovered servers match existing entries that you've previously discovered, the information + * for the already-existing discovered server is updated. When you delete an import task that + * contains records that were used to match, the information in those matched records that comes + * from the deleted records will also be deleted.

+ */ export class BatchDeleteImportDataCommand extends $Command< BatchDeleteImportDataCommandInput, BatchDeleteImportDataCommandOutput, @@ -38,6 +48,9 @@ export class BatchDeleteImportDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/CreateApplicationCommand.ts b/clients/client-application-discovery-service/commands/CreateApplicationCommand.ts index 3aa53cfcebd96..a8c9f7863c826 100644 --- a/clients/client-application-discovery-service/commands/CreateApplicationCommand.ts +++ b/clients/client-application-discovery-service/commands/CreateApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type CreateApplicationCommandInput = CreateApplicationRequest; export type CreateApplicationCommandOutput = CreateApplicationResponse & __MetadataBearer; +/** + *

Creates an application with the given name and description.

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -38,6 +41,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/CreateTagsCommand.ts b/clients/client-application-discovery-service/commands/CreateTagsCommand.ts index aa8fc173ed468..941adfbae30e5 100644 --- a/clients/client-application-discovery-service/commands/CreateTagsCommand.ts +++ b/clients/client-application-discovery-service/commands/CreateTagsCommand.ts @@ -24,6 +24,10 @@ import { export type CreateTagsCommandInput = CreateTagsRequest; export type CreateTagsCommandOutput = CreateTagsResponse & __MetadataBearer; +/** + *

Creates one or more tags for configuration items. Tags are metadata that help you + * categorize IT assets. This API accepts a list of multiple configuration items.

+ */ export class CreateTagsCommand extends $Command< CreateTagsCommandInput, CreateTagsCommandOutput, @@ -38,6 +42,9 @@ export class CreateTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DeleteApplicationsCommand.ts b/clients/client-application-discovery-service/commands/DeleteApplicationsCommand.ts index 66b236a8e5f5d..7a31afa7ed9a7 100644 --- a/clients/client-application-discovery-service/commands/DeleteApplicationsCommand.ts +++ b/clients/client-application-discovery-service/commands/DeleteApplicationsCommand.ts @@ -24,6 +24,10 @@ import { export type DeleteApplicationsCommandInput = DeleteApplicationsRequest; export type DeleteApplicationsCommandOutput = DeleteApplicationsResponse & __MetadataBearer; +/** + *

Deletes a list of applications and their associations with configuration + * items.

+ */ export class DeleteApplicationsCommand extends $Command< DeleteApplicationsCommandInput, DeleteApplicationsCommandOutput, @@ -38,6 +42,9 @@ export class DeleteApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DeleteTagsCommand.ts b/clients/client-application-discovery-service/commands/DeleteTagsCommand.ts index fbf0b5acf095e..9846083457c9f 100644 --- a/clients/client-application-discovery-service/commands/DeleteTagsCommand.ts +++ b/clients/client-application-discovery-service/commands/DeleteTagsCommand.ts @@ -24,6 +24,10 @@ import { export type DeleteTagsCommandInput = DeleteTagsRequest; export type DeleteTagsCommandOutput = DeleteTagsResponse & __MetadataBearer; +/** + *

Deletes the association between configuration items and one or more tags. This API + * accepts a list of multiple configuration items.

+ */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -38,6 +42,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DescribeAgentsCommand.ts b/clients/client-application-discovery-service/commands/DescribeAgentsCommand.ts index 97475949f7b62..b81cba4e80253 100644 --- a/clients/client-application-discovery-service/commands/DescribeAgentsCommand.ts +++ b/clients/client-application-discovery-service/commands/DescribeAgentsCommand.ts @@ -24,6 +24,11 @@ import { export type DescribeAgentsCommandInput = DescribeAgentsRequest; export type DescribeAgentsCommandOutput = DescribeAgentsResponse & __MetadataBearer; +/** + *

Lists agents or connectors as specified by ID or other filters. All agents/connectors + * associated with your user account can be listed if you call DescribeAgents as is + * without passing any parameters.

+ */ export class DescribeAgentsCommand extends $Command< DescribeAgentsCommandInput, DescribeAgentsCommandOutput, @@ -38,6 +43,9 @@ export class DescribeAgentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DescribeConfigurationsCommand.ts b/clients/client-application-discovery-service/commands/DescribeConfigurationsCommand.ts index 47af7c91df9d4..af3abbaa62416 100644 --- a/clients/client-application-discovery-service/commands/DescribeConfigurationsCommand.ts +++ b/clients/client-application-discovery-service/commands/DescribeConfigurationsCommand.ts @@ -24,6 +24,34 @@ import { export type DescribeConfigurationsCommandInput = DescribeConfigurationsRequest; export type DescribeConfigurationsCommandOutput = DescribeConfigurationsResponse & __MetadataBearer; +/** + *

Retrieves attributes for a list of configuration item IDs.

+ * + * + *

All of the supplied IDs must be for the same asset type from one of the + * following:

+ *
    + *
  • + *

    server

    + *
  • + *
  • + *

    application

    + *
  • + *
  • + *

    process

    + *
  • + *
  • + *

    connection

    + *
  • + *
+ * + *

Output fields are specific to the asset type specified. For example, the output for a + * server configuration item includes a list of attributes about the + * server, such as host name, operating system, number of network cards, etc.

+ *

For a complete list of outputs for each asset type, see Using the DescribeConfigurations Action in the AWS Application + * Discovery Service User Guide.

+ *
+ */ export class DescribeConfigurationsCommand extends $Command< DescribeConfigurationsCommandInput, DescribeConfigurationsCommandOutput, @@ -38,6 +66,9 @@ export class DescribeConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DescribeContinuousExportsCommand.ts b/clients/client-application-discovery-service/commands/DescribeContinuousExportsCommand.ts index 1ec87b447c9bb..eebc7d57bf124 100644 --- a/clients/client-application-discovery-service/commands/DescribeContinuousExportsCommand.ts +++ b/clients/client-application-discovery-service/commands/DescribeContinuousExportsCommand.ts @@ -24,6 +24,11 @@ import { export type DescribeContinuousExportsCommandInput = DescribeContinuousExportsRequest; export type DescribeContinuousExportsCommandOutput = DescribeContinuousExportsResponse & __MetadataBearer; +/** + *

Lists exports as specified by ID. All continuous exports associated with your user + * account can be listed if you call DescribeContinuousExports as is without passing + * any parameters.

+ */ export class DescribeContinuousExportsCommand extends $Command< DescribeContinuousExportsCommandInput, DescribeContinuousExportsCommandOutput, @@ -38,6 +43,9 @@ export class DescribeContinuousExportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DescribeExportConfigurationsCommand.ts b/clients/client-application-discovery-service/commands/DescribeExportConfigurationsCommand.ts index cc8eeff5e2099..a229b0dab8596 100644 --- a/clients/client-application-discovery-service/commands/DescribeExportConfigurationsCommand.ts +++ b/clients/client-application-discovery-service/commands/DescribeExportConfigurationsCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeExportConfigurationsCommandInput = DescribeExportConfigurationsRequest; export type DescribeExportConfigurationsCommandOutput = DescribeExportConfigurationsResponse & __MetadataBearer; +/** + *

+ * DescribeExportConfigurations is deprecated. Use DescribeImportTasks, instead.

+ */ export class DescribeExportConfigurationsCommand extends $Command< DescribeExportConfigurationsCommandInput, DescribeExportConfigurationsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeExportConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DescribeExportTasksCommand.ts b/clients/client-application-discovery-service/commands/DescribeExportTasksCommand.ts index 82247bd46d88c..7279895026519 100644 --- a/clients/client-application-discovery-service/commands/DescribeExportTasksCommand.ts +++ b/clients/client-application-discovery-service/commands/DescribeExportTasksCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeExportTasksCommandInput = DescribeExportTasksRequest; export type DescribeExportTasksCommandOutput = DescribeExportTasksResponse & __MetadataBearer; +/** + *

Retrieve status of one or more export tasks. You can retrieve the status of up to 100 + * export tasks.

+ */ export class DescribeExportTasksCommand extends $Command< DescribeExportTasksCommandInput, DescribeExportTasksCommandOutput, @@ -38,6 +42,9 @@ export class DescribeExportTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DescribeImportTasksCommand.ts b/clients/client-application-discovery-service/commands/DescribeImportTasksCommand.ts index 7d954441b16d2..95495c863d62d 100644 --- a/clients/client-application-discovery-service/commands/DescribeImportTasksCommand.ts +++ b/clients/client-application-discovery-service/commands/DescribeImportTasksCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeImportTasksCommandInput = DescribeImportTasksRequest; export type DescribeImportTasksCommandOutput = DescribeImportTasksResponse & __MetadataBearer; +/** + *

Returns an array of import tasks for your account, including status information, times, + * IDs, the Amazon S3 Object URL for the import file, and more.

+ */ export class DescribeImportTasksCommand extends $Command< DescribeImportTasksCommandInput, DescribeImportTasksCommandOutput, @@ -38,6 +42,9 @@ export class DescribeImportTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DescribeTagsCommand.ts b/clients/client-application-discovery-service/commands/DescribeTagsCommand.ts index d1837d56de135..f07a799511ba1 100644 --- a/clients/client-application-discovery-service/commands/DescribeTagsCommand.ts +++ b/clients/client-application-discovery-service/commands/DescribeTagsCommand.ts @@ -24,6 +24,24 @@ import { export type DescribeTagsCommandInput = DescribeTagsRequest; export type DescribeTagsCommandOutput = DescribeTagsResponse & __MetadataBearer; +/** + *

Retrieves a list of configuration items that have tags as specified by the key-value + * pairs, name and value, passed to the optional parameter filters.

+ *

There are three valid tag filter names:

+ *
    + *
  • + *

    tagKey

    + *
  • + *
  • + *

    tagValue

    + *
  • + *
  • + *

    configurationId

    + *
  • + *
+ *

Also, all configuration items associated with your user account that have tags can be + * listed if you call DescribeTags as is without passing any parameters.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -38,6 +56,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/DisassociateConfigurationItemsFromApplicationCommand.ts b/clients/client-application-discovery-service/commands/DisassociateConfigurationItemsFromApplicationCommand.ts index f1aa3f9d1358e..2e5ab348ca305 100644 --- a/clients/client-application-discovery-service/commands/DisassociateConfigurationItemsFromApplicationCommand.ts +++ b/clients/client-application-discovery-service/commands/DisassociateConfigurationItemsFromApplicationCommand.ts @@ -28,6 +28,9 @@ export type DisassociateConfigurationItemsFromApplicationCommandInput = Disassoc export type DisassociateConfigurationItemsFromApplicationCommandOutput = DisassociateConfigurationItemsFromApplicationResponse & __MetadataBearer; +/** + *

Disassociates one or more configuration items from an application.

+ */ export class DisassociateConfigurationItemsFromApplicationCommand extends $Command< DisassociateConfigurationItemsFromApplicationCommandInput, DisassociateConfigurationItemsFromApplicationCommandOutput, @@ -42,6 +45,9 @@ export class DisassociateConfigurationItemsFromApplicationCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/ExportConfigurationsCommand.ts b/clients/client-application-discovery-service/commands/ExportConfigurationsCommand.ts index 721da17690a96..e4b2070a45e2d 100644 --- a/clients/client-application-discovery-service/commands/ExportConfigurationsCommand.ts +++ b/clients/client-application-discovery-service/commands/ExportConfigurationsCommand.ts @@ -24,6 +24,14 @@ import { export type ExportConfigurationsCommandInput = {}; export type ExportConfigurationsCommandOutput = ExportConfigurationsResponse & __MetadataBearer; +/** + *

Deprecated. Use StartExportTask instead.

+ *

Exports all discovered configuration data to an Amazon S3 bucket or an application that + * enables you to view and evaluate the data. Data includes tags and tag associations, processes, + * connections, servers, and system performance. This API returns an export ID that you can query + * using the DescribeExportConfigurations API. The system imposes a limit of + * two configuration exports in six hours.

+ */ export class ExportConfigurationsCommand extends $Command< ExportConfigurationsCommandInput, ExportConfigurationsCommandOutput, @@ -38,6 +46,9 @@ export class ExportConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/GetDiscoverySummaryCommand.ts b/clients/client-application-discovery-service/commands/GetDiscoverySummaryCommand.ts index e4344052da28b..8fbc8b692f2e2 100644 --- a/clients/client-application-discovery-service/commands/GetDiscoverySummaryCommand.ts +++ b/clients/client-application-discovery-service/commands/GetDiscoverySummaryCommand.ts @@ -24,6 +24,11 @@ import { export type GetDiscoverySummaryCommandInput = GetDiscoverySummaryRequest; export type GetDiscoverySummaryCommandOutput = GetDiscoverySummaryResponse & __MetadataBearer; +/** + *

Retrieves a short summary of discovered assets.

+ *

This API operation takes no request parameters and is called as is at the command + * prompt as shown in the example.

+ */ export class GetDiscoverySummaryCommand extends $Command< GetDiscoverySummaryCommandInput, GetDiscoverySummaryCommandOutput, @@ -38,6 +43,9 @@ export class GetDiscoverySummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/ListConfigurationsCommand.ts b/clients/client-application-discovery-service/commands/ListConfigurationsCommand.ts index d9b52fa0b95ea..2ccbb59eee89b 100644 --- a/clients/client-application-discovery-service/commands/ListConfigurationsCommand.ts +++ b/clients/client-application-discovery-service/commands/ListConfigurationsCommand.ts @@ -24,6 +24,11 @@ import { export type ListConfigurationsCommandInput = ListConfigurationsRequest; export type ListConfigurationsCommandOutput = ListConfigurationsResponse & __MetadataBearer; +/** + *

Retrieves a list of configuration items as specified by the value passed to the + * required parameter configurationType. Optional filtering may be applied to refine + * search results.

+ */ export class ListConfigurationsCommand extends $Command< ListConfigurationsCommandInput, ListConfigurationsCommandOutput, @@ -38,6 +43,9 @@ export class ListConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/ListServerNeighborsCommand.ts b/clients/client-application-discovery-service/commands/ListServerNeighborsCommand.ts index ad51cc48ce275..e85a30d880c2d 100644 --- a/clients/client-application-discovery-service/commands/ListServerNeighborsCommand.ts +++ b/clients/client-application-discovery-service/commands/ListServerNeighborsCommand.ts @@ -24,6 +24,10 @@ import { export type ListServerNeighborsCommandInput = ListServerNeighborsRequest; export type ListServerNeighborsCommandOutput = ListServerNeighborsResponse & __MetadataBearer; +/** + *

Retrieves a list of servers that are one network hop away from a specified + * server.

+ */ export class ListServerNeighborsCommand extends $Command< ListServerNeighborsCommandInput, ListServerNeighborsCommandOutput, @@ -38,6 +42,9 @@ export class ListServerNeighborsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/StartContinuousExportCommand.ts b/clients/client-application-discovery-service/commands/StartContinuousExportCommand.ts index f51c728a508f4..d1629905f8341 100644 --- a/clients/client-application-discovery-service/commands/StartContinuousExportCommand.ts +++ b/clients/client-application-discovery-service/commands/StartContinuousExportCommand.ts @@ -24,6 +24,9 @@ import { export type StartContinuousExportCommandInput = StartContinuousExportRequest; export type StartContinuousExportCommandOutput = StartContinuousExportResponse & __MetadataBearer; +/** + *

Start the continuous flow of agent's discovered data into Amazon Athena.

+ */ export class StartContinuousExportCommand extends $Command< StartContinuousExportCommandInput, StartContinuousExportCommandOutput, @@ -38,6 +41,9 @@ export class StartContinuousExportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/StartDataCollectionByAgentIdsCommand.ts b/clients/client-application-discovery-service/commands/StartDataCollectionByAgentIdsCommand.ts index 628c89aaef3ca..9bb8b46753341 100644 --- a/clients/client-application-discovery-service/commands/StartDataCollectionByAgentIdsCommand.ts +++ b/clients/client-application-discovery-service/commands/StartDataCollectionByAgentIdsCommand.ts @@ -24,6 +24,9 @@ import { export type StartDataCollectionByAgentIdsCommandInput = StartDataCollectionByAgentIdsRequest; export type StartDataCollectionByAgentIdsCommandOutput = StartDataCollectionByAgentIdsResponse & __MetadataBearer; +/** + *

Instructs the specified agents or connectors to start collecting data.

+ */ export class StartDataCollectionByAgentIdsCommand extends $Command< StartDataCollectionByAgentIdsCommandInput, StartDataCollectionByAgentIdsCommandOutput, @@ -38,6 +41,9 @@ export class StartDataCollectionByAgentIdsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/StartExportTaskCommand.ts b/clients/client-application-discovery-service/commands/StartExportTaskCommand.ts index b8a8f0728537c..752a2fed88833 100644 --- a/clients/client-application-discovery-service/commands/StartExportTaskCommand.ts +++ b/clients/client-application-discovery-service/commands/StartExportTaskCommand.ts @@ -24,6 +24,17 @@ import { export type StartExportTaskCommandInput = StartExportTaskRequest; export type StartExportTaskCommandOutput = StartExportTaskResponse & __MetadataBearer; +/** + *

Begins the export of discovered data to an S3 bucket.

+ *

If you specify agentIds in a filter, the task exports up to 72 hours of + * detailed data collected by the identified Application Discovery Agent, including network, + * process, and performance details. A time range for exported agent data may be set by using + * startTime and endTime. Export of detailed agent data is limited to + * five concurrently running exports.

+ *

If you do not include an agentIds filter, summary data is exported that + * includes both AWS Agentless Discovery Connector data and summary data from AWS Discovery + * Agents. Export of summary data is limited to two exports per day.

+ */ export class StartExportTaskCommand extends $Command< StartExportTaskCommandInput, StartExportTaskCommandOutput, @@ -38,6 +49,9 @@ export class StartExportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/StartImportTaskCommand.ts b/clients/client-application-discovery-service/commands/StartImportTaskCommand.ts index 4325ef625d66e..5d8cd999e5a1c 100644 --- a/clients/client-application-discovery-service/commands/StartImportTaskCommand.ts +++ b/clients/client-application-discovery-service/commands/StartImportTaskCommand.ts @@ -24,6 +24,44 @@ import { export type StartImportTaskCommandInput = StartImportTaskRequest; export type StartImportTaskCommandOutput = StartImportTaskResponse & __MetadataBearer; +/** + *

Starts an import task, which allows you to import details of your on-premises environment + * directly into AWS Migration Hub without having to use the Application Discovery Service (ADS) + * tools such as the Discovery Connector or Discovery Agent. This gives you the option to perform + * migration assessment and planning directly from your imported data, including the ability to + * group your devices as applications and track their migration status.

+ * + *

To start an import request, do this:

+ * + *
    + *
  1. + *

    Download the specially formatted comma separated value (CSV) import template, which + * you can find here: https://s3-us-west-2.amazonaws.com/templates-7cffcf56-bd96-4b1c-b45b-a5b42f282e46/import_template.csv.

    + *
  2. + *
  3. + *

    Fill out the template with your server and application data.

    + *
  4. + *
  5. + *

    Upload your import file to an Amazon S3 bucket, and make a note of it's Object URL. + * Your import file must be in the CSV format.

    + *
  6. + *
  7. + *

    Use the console or the StartImportTask command with the AWS CLI or one of + * the AWS SDKs to import the records from your file.

    + *
  8. + *
+ * + *

For more information, including step-by-step procedures, see Migration Hub + * Import in the AWS Application Discovery Service User + * Guide.

+ * + * + *

There are limits to the number of import tasks you can create (and delete) in an AWS + * account. For more information, see AWS Application + * Discovery Service Limits in the AWS Application Discovery Service User + * Guide.

+ *
+ */ export class StartImportTaskCommand extends $Command< StartImportTaskCommandInput, StartImportTaskCommandOutput, @@ -38,6 +76,9 @@ export class StartImportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/StopContinuousExportCommand.ts b/clients/client-application-discovery-service/commands/StopContinuousExportCommand.ts index 9ecc3c3b6aebe..a6f6f9eee8872 100644 --- a/clients/client-application-discovery-service/commands/StopContinuousExportCommand.ts +++ b/clients/client-application-discovery-service/commands/StopContinuousExportCommand.ts @@ -24,6 +24,9 @@ import { export type StopContinuousExportCommandInput = StopContinuousExportRequest; export type StopContinuousExportCommandOutput = StopContinuousExportResponse & __MetadataBearer; +/** + *

Stop the continuous flow of agent's discovered data into Amazon Athena.

+ */ export class StopContinuousExportCommand extends $Command< StopContinuousExportCommandInput, StopContinuousExportCommandOutput, @@ -38,6 +41,9 @@ export class StopContinuousExportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/StopDataCollectionByAgentIdsCommand.ts b/clients/client-application-discovery-service/commands/StopDataCollectionByAgentIdsCommand.ts index f92421bc0af58..2c2e58c53a4fd 100644 --- a/clients/client-application-discovery-service/commands/StopDataCollectionByAgentIdsCommand.ts +++ b/clients/client-application-discovery-service/commands/StopDataCollectionByAgentIdsCommand.ts @@ -24,6 +24,9 @@ import { export type StopDataCollectionByAgentIdsCommandInput = StopDataCollectionByAgentIdsRequest; export type StopDataCollectionByAgentIdsCommandOutput = StopDataCollectionByAgentIdsResponse & __MetadataBearer; +/** + *

Instructs the specified agents or connectors to stop collecting data.

+ */ export class StopDataCollectionByAgentIdsCommand extends $Command< StopDataCollectionByAgentIdsCommandInput, StopDataCollectionByAgentIdsCommandOutput, @@ -38,6 +41,9 @@ export class StopDataCollectionByAgentIdsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/commands/UpdateApplicationCommand.ts b/clients/client-application-discovery-service/commands/UpdateApplicationCommand.ts index 0587bec29be3b..a7d28fee9997e 100644 --- a/clients/client-application-discovery-service/commands/UpdateApplicationCommand.ts +++ b/clients/client-application-discovery-service/commands/UpdateApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationRequest; export type UpdateApplicationCommandOutput = UpdateApplicationResponse & __MetadataBearer; +/** + *

Updates metadata about an application.

+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -38,6 +41,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationDiscoveryServiceClientResolvedConfig, diff --git a/clients/client-application-discovery-service/package.json b/clients/client-application-discovery-service/package.json index c5b64950f0d47..3d55d2079e5ab 100644 --- a/clients/client-application-discovery-service/package.json +++ b/clients/client-application-discovery-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Application Discovery Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-application-discovery-service/pagination/DescribeContinuousExportsPaginator.ts b/clients/client-application-discovery-service/pagination/DescribeContinuousExportsPaginator.ts index 6a717e4c25097..ba7871c72f77c 100644 --- a/clients/client-application-discovery-service/pagination/DescribeContinuousExportsPaginator.ts +++ b/clients/client-application-discovery-service/pagination/DescribeContinuousExportsPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationDiscoveryServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationDiscoveryServiceClient, input: DescribeContinuousExportsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeContinuousExportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationDiscoveryService, input: DescribeContinuousExportsCommandInput, diff --git a/clients/client-application-discovery-service/pagination/DescribeImportTasksPaginator.ts b/clients/client-application-discovery-service/pagination/DescribeImportTasksPaginator.ts index 51325452e4449..ca6ab14c06721 100644 --- a/clients/client-application-discovery-service/pagination/DescribeImportTasksPaginator.ts +++ b/clients/client-application-discovery-service/pagination/DescribeImportTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationDiscoveryServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationDiscoveryServiceClient, input: DescribeImportTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeImportTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationDiscoveryService, input: DescribeImportTasksCommandInput, diff --git a/clients/client-application-discovery-service/runtimeConfig.browser.ts b/clients/client-application-discovery-service/runtimeConfig.browser.ts index 18369edca9f90..2b60555451c4f 100644 --- a/clients/client-application-discovery-service/runtimeConfig.browser.ts +++ b/clients/client-application-discovery-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ApplicationDiscoveryServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-application-discovery-service/runtimeConfig.native.ts b/clients/client-application-discovery-service/runtimeConfig.native.ts index 3a49ae474ae3f..476ab3fc9198f 100644 --- a/clients/client-application-discovery-service/runtimeConfig.native.ts +++ b/clients/client-application-discovery-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ApplicationDiscoveryServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-application-discovery-service/runtimeConfig.shared.ts b/clients/client-application-discovery-service/runtimeConfig.shared.ts index a736ccd1597b7..f1081d2952fdb 100644 --- a/clients/client-application-discovery-service/runtimeConfig.shared.ts +++ b/clients/client-application-discovery-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-11-01", disableHostPrefix: false, diff --git a/clients/client-application-discovery-service/runtimeConfig.ts b/clients/client-application-discovery-service/runtimeConfig.ts index e87bb7ab2d6b0..80c7f1f04d63a 100644 --- a/clients/client-application-discovery-service/runtimeConfig.ts +++ b/clients/client-application-discovery-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ApplicationDiscoveryServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-application-discovery-service/tsconfig.json b/clients/client-application-discovery-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-application-discovery-service/tsconfig.json +++ b/clients/client-application-discovery-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-application-insights/commands/CreateApplicationCommand.ts b/clients/client-application-insights/commands/CreateApplicationCommand.ts index 24f5d9afbe2bb..a618d5c035df4 100644 --- a/clients/client-application-insights/commands/CreateApplicationCommand.ts +++ b/clients/client-application-insights/commands/CreateApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type CreateApplicationCommandInput = CreateApplicationRequest; export type CreateApplicationCommandOutput = CreateApplicationResponse & __MetadataBearer; +/** + *

Adds an application that is created from a resource group.

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -38,6 +41,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/CreateComponentCommand.ts b/clients/client-application-insights/commands/CreateComponentCommand.ts index ccae748c59826..81ff2b950ccf4 100644 --- a/clients/client-application-insights/commands/CreateComponentCommand.ts +++ b/clients/client-application-insights/commands/CreateComponentCommand.ts @@ -24,6 +24,9 @@ import { export type CreateComponentCommandInput = CreateComponentRequest; export type CreateComponentCommandOutput = CreateComponentResponse & __MetadataBearer; +/** + *

Creates a custom component by grouping similar standalone instances to monitor.

+ */ export class CreateComponentCommand extends $Command< CreateComponentCommandInput, CreateComponentCommandOutput, @@ -38,6 +41,9 @@ export class CreateComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/CreateLogPatternCommand.ts b/clients/client-application-insights/commands/CreateLogPatternCommand.ts index 40c2170337d18..9569a7a8eb860 100644 --- a/clients/client-application-insights/commands/CreateLogPatternCommand.ts +++ b/clients/client-application-insights/commands/CreateLogPatternCommand.ts @@ -24,6 +24,9 @@ import { export type CreateLogPatternCommandInput = CreateLogPatternRequest; export type CreateLogPatternCommandOutput = CreateLogPatternResponse & __MetadataBearer; +/** + *

Adds an log pattern to a LogPatternSet.

+ */ export class CreateLogPatternCommand extends $Command< CreateLogPatternCommandInput, CreateLogPatternCommandOutput, @@ -38,6 +41,9 @@ export class CreateLogPatternCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DeleteApplicationCommand.ts b/clients/client-application-insights/commands/DeleteApplicationCommand.ts index 27e7a69937938..ca6de58ae55a8 100644 --- a/clients/client-application-insights/commands/DeleteApplicationCommand.ts +++ b/clients/client-application-insights/commands/DeleteApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteApplicationCommandInput = DeleteApplicationRequest; export type DeleteApplicationCommandOutput = DeleteApplicationResponse & __MetadataBearer; +/** + *

Removes the specified application from monitoring. Does not delete the application.

+ */ export class DeleteApplicationCommand extends $Command< DeleteApplicationCommandInput, DeleteApplicationCommandOutput, @@ -38,6 +41,9 @@ export class DeleteApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DeleteComponentCommand.ts b/clients/client-application-insights/commands/DeleteComponentCommand.ts index 1cfde8cbcd841..c4ef969aaa7f5 100644 --- a/clients/client-application-insights/commands/DeleteComponentCommand.ts +++ b/clients/client-application-insights/commands/DeleteComponentCommand.ts @@ -24,6 +24,10 @@ import { export type DeleteComponentCommandInput = DeleteComponentRequest; export type DeleteComponentCommandOutput = DeleteComponentResponse & __MetadataBearer; +/** + *

Ungroups a custom component. When you ungroup custom components, all applicable + * monitors that are set up for the component are removed and the instances revert to their standalone status.

+ */ export class DeleteComponentCommand extends $Command< DeleteComponentCommandInput, DeleteComponentCommandOutput, @@ -38,6 +42,9 @@ export class DeleteComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DeleteLogPatternCommand.ts b/clients/client-application-insights/commands/DeleteLogPatternCommand.ts index af1199ff1d24c..b19aad16aaf86 100644 --- a/clients/client-application-insights/commands/DeleteLogPatternCommand.ts +++ b/clients/client-application-insights/commands/DeleteLogPatternCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteLogPatternCommandInput = DeleteLogPatternRequest; export type DeleteLogPatternCommandOutput = DeleteLogPatternResponse & __MetadataBearer; +/** + *

Removes the specified log pattern from a LogPatternSet.

+ */ export class DeleteLogPatternCommand extends $Command< DeleteLogPatternCommandInput, DeleteLogPatternCommandOutput, @@ -38,6 +41,9 @@ export class DeleteLogPatternCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DescribeApplicationCommand.ts b/clients/client-application-insights/commands/DescribeApplicationCommand.ts index 428ad8caedf56..c508fc224cc72 100644 --- a/clients/client-application-insights/commands/DescribeApplicationCommand.ts +++ b/clients/client-application-insights/commands/DescribeApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeApplicationCommandInput = DescribeApplicationRequest; export type DescribeApplicationCommandOutput = DescribeApplicationResponse & __MetadataBearer; +/** + *

Describes the application.

+ */ export class DescribeApplicationCommand extends $Command< DescribeApplicationCommandInput, DescribeApplicationCommandOutput, @@ -38,6 +41,9 @@ export class DescribeApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DescribeComponentCommand.ts b/clients/client-application-insights/commands/DescribeComponentCommand.ts index 801ec090ecaad..c30c348f30e26 100644 --- a/clients/client-application-insights/commands/DescribeComponentCommand.ts +++ b/clients/client-application-insights/commands/DescribeComponentCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeComponentCommandInput = DescribeComponentRequest; export type DescribeComponentCommandOutput = DescribeComponentResponse & __MetadataBearer; +/** + *

Describes a component and lists the resources that are grouped together in a component.

+ */ export class DescribeComponentCommand extends $Command< DescribeComponentCommandInput, DescribeComponentCommandOutput, @@ -38,6 +41,9 @@ export class DescribeComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DescribeComponentConfigurationCommand.ts b/clients/client-application-insights/commands/DescribeComponentConfigurationCommand.ts index de022f4e3a009..51abf4455fb4c 100644 --- a/clients/client-application-insights/commands/DescribeComponentConfigurationCommand.ts +++ b/clients/client-application-insights/commands/DescribeComponentConfigurationCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeComponentConfigurationCommandInput = DescribeComponentConfigurationRequest; export type DescribeComponentConfigurationCommandOutput = DescribeComponentConfigurationResponse & __MetadataBearer; +/** + *

Describes the monitoring configuration of the component.

+ */ export class DescribeComponentConfigurationCommand extends $Command< DescribeComponentConfigurationCommandInput, DescribeComponentConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class DescribeComponentConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DescribeComponentConfigurationRecommendationCommand.ts b/clients/client-application-insights/commands/DescribeComponentConfigurationRecommendationCommand.ts index 9bbb3b332d839..8b80833f0149d 100644 --- a/clients/client-application-insights/commands/DescribeComponentConfigurationRecommendationCommand.ts +++ b/clients/client-application-insights/commands/DescribeComponentConfigurationRecommendationCommand.ts @@ -28,6 +28,9 @@ export type DescribeComponentConfigurationRecommendationCommandInput = DescribeC export type DescribeComponentConfigurationRecommendationCommandOutput = DescribeComponentConfigurationRecommendationResponse & __MetadataBearer; +/** + *

Describes the recommended monitoring configuration of the component.

+ */ export class DescribeComponentConfigurationRecommendationCommand extends $Command< DescribeComponentConfigurationRecommendationCommandInput, DescribeComponentConfigurationRecommendationCommandOutput, @@ -42,6 +45,9 @@ export class DescribeComponentConfigurationRecommendationCommand extends $Comman // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DescribeLogPatternCommand.ts b/clients/client-application-insights/commands/DescribeLogPatternCommand.ts index ee3a67e041323..ddc6228e7b73d 100644 --- a/clients/client-application-insights/commands/DescribeLogPatternCommand.ts +++ b/clients/client-application-insights/commands/DescribeLogPatternCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeLogPatternCommandInput = DescribeLogPatternRequest; export type DescribeLogPatternCommandOutput = DescribeLogPatternResponse & __MetadataBearer; +/** + *

Describe a specific log pattern from a LogPatternSet.

+ */ export class DescribeLogPatternCommand extends $Command< DescribeLogPatternCommandInput, DescribeLogPatternCommandOutput, @@ -38,6 +41,9 @@ export class DescribeLogPatternCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DescribeObservationCommand.ts b/clients/client-application-insights/commands/DescribeObservationCommand.ts index 28a66e7723db2..ff7b6be393db7 100644 --- a/clients/client-application-insights/commands/DescribeObservationCommand.ts +++ b/clients/client-application-insights/commands/DescribeObservationCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeObservationCommandInput = DescribeObservationRequest; export type DescribeObservationCommandOutput = DescribeObservationResponse & __MetadataBearer; +/** + *

Describes an anomaly or error with the application.

+ */ export class DescribeObservationCommand extends $Command< DescribeObservationCommandInput, DescribeObservationCommandOutput, @@ -38,6 +41,9 @@ export class DescribeObservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DescribeProblemCommand.ts b/clients/client-application-insights/commands/DescribeProblemCommand.ts index 7a632d3c9d412..a427d9aa2f6fa 100644 --- a/clients/client-application-insights/commands/DescribeProblemCommand.ts +++ b/clients/client-application-insights/commands/DescribeProblemCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeProblemCommandInput = DescribeProblemRequest; export type DescribeProblemCommandOutput = DescribeProblemResponse & __MetadataBearer; +/** + *

Describes an application problem.

+ */ export class DescribeProblemCommand extends $Command< DescribeProblemCommandInput, DescribeProblemCommandOutput, @@ -38,6 +41,9 @@ export class DescribeProblemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/DescribeProblemObservationsCommand.ts b/clients/client-application-insights/commands/DescribeProblemObservationsCommand.ts index 9beb7d3e6f2b7..dc18ed78cacd2 100644 --- a/clients/client-application-insights/commands/DescribeProblemObservationsCommand.ts +++ b/clients/client-application-insights/commands/DescribeProblemObservationsCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeProblemObservationsCommandInput = DescribeProblemObservationsRequest; export type DescribeProblemObservationsCommandOutput = DescribeProblemObservationsResponse & __MetadataBearer; +/** + *

Describes the anomalies or errors associated with the problem.

+ */ export class DescribeProblemObservationsCommand extends $Command< DescribeProblemObservationsCommandInput, DescribeProblemObservationsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeProblemObservationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/ListApplicationsCommand.ts b/clients/client-application-insights/commands/ListApplicationsCommand.ts index 1e789b3f12dc9..d7cdd706f6c13 100644 --- a/clients/client-application-insights/commands/ListApplicationsCommand.ts +++ b/clients/client-application-insights/commands/ListApplicationsCommand.ts @@ -24,6 +24,9 @@ import { export type ListApplicationsCommandInput = ListApplicationsRequest; export type ListApplicationsCommandOutput = ListApplicationsResponse & __MetadataBearer; +/** + *

Lists the IDs of the applications that you are monitoring.

+ */ export class ListApplicationsCommand extends $Command< ListApplicationsCommandInput, ListApplicationsCommandOutput, @@ -38,6 +41,9 @@ export class ListApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/ListComponentsCommand.ts b/clients/client-application-insights/commands/ListComponentsCommand.ts index ad21f19ace8cc..24170f70f7786 100644 --- a/clients/client-application-insights/commands/ListComponentsCommand.ts +++ b/clients/client-application-insights/commands/ListComponentsCommand.ts @@ -24,6 +24,9 @@ import { export type ListComponentsCommandInput = ListComponentsRequest; export type ListComponentsCommandOutput = ListComponentsResponse & __MetadataBearer; +/** + *

Lists the auto-grouped, standalone, and custom components of the application.

+ */ export class ListComponentsCommand extends $Command< ListComponentsCommandInput, ListComponentsCommandOutput, @@ -38,6 +41,9 @@ export class ListComponentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/ListConfigurationHistoryCommand.ts b/clients/client-application-insights/commands/ListConfigurationHistoryCommand.ts index f6d0302b17e75..9fa6582da97f7 100644 --- a/clients/client-application-insights/commands/ListConfigurationHistoryCommand.ts +++ b/clients/client-application-insights/commands/ListConfigurationHistoryCommand.ts @@ -24,6 +24,22 @@ import { export type ListConfigurationHistoryCommandInput = ListConfigurationHistoryRequest; export type ListConfigurationHistoryCommandOutput = ListConfigurationHistoryResponse & __MetadataBearer; +/** + *

+ * Lists the INFO, WARN, and ERROR events for periodic configuration updates performed by Application Insights. Examples of events represented are: + *

+ *
    + *
  • + *

    INFO: creating a new alarm or updating an alarm threshold.

    + *
  • + *
  • + *

    WARN: alarm not created due to insufficient data points used to predict thresholds.

    + *
  • + *
  • + *

    ERROR: alarm not created due to permission errors or exceeding quotas.

    + *
  • + *
+ */ export class ListConfigurationHistoryCommand extends $Command< ListConfigurationHistoryCommandInput, ListConfigurationHistoryCommandOutput, @@ -38,6 +54,9 @@ export class ListConfigurationHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/ListLogPatternSetsCommand.ts b/clients/client-application-insights/commands/ListLogPatternSetsCommand.ts index 9e256d4bfdd01..dbc5e341042d9 100644 --- a/clients/client-application-insights/commands/ListLogPatternSetsCommand.ts +++ b/clients/client-application-insights/commands/ListLogPatternSetsCommand.ts @@ -24,6 +24,9 @@ import { export type ListLogPatternSetsCommandInput = ListLogPatternSetsRequest; export type ListLogPatternSetsCommandOutput = ListLogPatternSetsResponse & __MetadataBearer; +/** + *

Lists the log pattern sets in the specific application.

+ */ export class ListLogPatternSetsCommand extends $Command< ListLogPatternSetsCommandInput, ListLogPatternSetsCommandOutput, @@ -38,6 +41,9 @@ export class ListLogPatternSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/ListLogPatternsCommand.ts b/clients/client-application-insights/commands/ListLogPatternsCommand.ts index de1f90fe01fba..7048bbbe3c8b0 100644 --- a/clients/client-application-insights/commands/ListLogPatternsCommand.ts +++ b/clients/client-application-insights/commands/ListLogPatternsCommand.ts @@ -24,6 +24,9 @@ import { export type ListLogPatternsCommandInput = ListLogPatternsRequest; export type ListLogPatternsCommandOutput = ListLogPatternsResponse & __MetadataBearer; +/** + *

Lists the log patterns in the specific log LogPatternSet.

+ */ export class ListLogPatternsCommand extends $Command< ListLogPatternsCommandInput, ListLogPatternsCommandOutput, @@ -38,6 +41,9 @@ export class ListLogPatternsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/ListProblemsCommand.ts b/clients/client-application-insights/commands/ListProblemsCommand.ts index cf4c37a1316d0..4875aa5861d8c 100644 --- a/clients/client-application-insights/commands/ListProblemsCommand.ts +++ b/clients/client-application-insights/commands/ListProblemsCommand.ts @@ -24,6 +24,9 @@ import { export type ListProblemsCommandInput = ListProblemsRequest; export type ListProblemsCommandOutput = ListProblemsResponse & __MetadataBearer; +/** + *

Lists the problems with your application.

+ */ export class ListProblemsCommand extends $Command< ListProblemsCommandInput, ListProblemsCommandOutput, @@ -38,6 +41,9 @@ export class ListProblemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/ListTagsForResourceCommand.ts b/clients/client-application-insights/commands/ListTagsForResourceCommand.ts index 090018eca1e86..8b49f30166e53 100644 --- a/clients/client-application-insights/commands/ListTagsForResourceCommand.ts +++ b/clients/client-application-insights/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,14 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieve a list of the tags (keys and values) that are associated with a specified + * application. A tag is a label that you optionally define and associate + * with an application. Each tag consists of a required tag key and an + * optional associated tag value. A tag key is a general label that + * acts as a category for more specific tag values. A tag value acts as a descriptor within + * a tag key.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +46,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/TagResourceCommand.ts b/clients/client-application-insights/commands/TagResourceCommand.ts index bb3ea6fa54712..ce7c63e7696a1 100644 --- a/clients/client-application-insights/commands/TagResourceCommand.ts +++ b/clients/client-application-insights/commands/TagResourceCommand.ts @@ -24,6 +24,16 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Add one or more tags (keys and values) to a specified application. A + * tag is a label that you optionally define and associate with an + * application. Tags can help you categorize and manage application in different ways, such as + * by purpose, owner, environment, or other criteria.

+ *

Each tag consists of a required tag key and an + * associated tag value, both of which you define. A tag key is a + * general label that acts as a category for more specific tag values. A tag value acts as + * a descriptor within a tag key.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +48,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/UntagResourceCommand.ts b/clients/client-application-insights/commands/UntagResourceCommand.ts index 645f041c00768..b33f7398a108a 100644 --- a/clients/client-application-insights/commands/UntagResourceCommand.ts +++ b/clients/client-application-insights/commands/UntagResourceCommand.ts @@ -24,6 +24,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Remove one or more tags (keys and values) from a specified application.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +41,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/UpdateApplicationCommand.ts b/clients/client-application-insights/commands/UpdateApplicationCommand.ts index 37834f7380e0e..3fda3b22c7cf4 100644 --- a/clients/client-application-insights/commands/UpdateApplicationCommand.ts +++ b/clients/client-application-insights/commands/UpdateApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationRequest; export type UpdateApplicationCommandOutput = UpdateApplicationResponse & __MetadataBearer; +/** + *

Updates the application.

+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -38,6 +41,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/UpdateComponentCommand.ts b/clients/client-application-insights/commands/UpdateComponentCommand.ts index d2d78655252eb..ed5b575fc1f5e 100644 --- a/clients/client-application-insights/commands/UpdateComponentCommand.ts +++ b/clients/client-application-insights/commands/UpdateComponentCommand.ts @@ -24,6 +24,10 @@ import { export type UpdateComponentCommandInput = UpdateComponentRequest; export type UpdateComponentCommandOutput = UpdateComponentResponse & __MetadataBearer; +/** + *

Updates the custom component name and/or the list of resources that make up the + * component.

+ */ export class UpdateComponentCommand extends $Command< UpdateComponentCommandInput, UpdateComponentCommandOutput, @@ -38,6 +42,9 @@ export class UpdateComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/UpdateComponentConfigurationCommand.ts b/clients/client-application-insights/commands/UpdateComponentConfigurationCommand.ts index 6843bff5de2a6..4f9ffa32f614d 100644 --- a/clients/client-application-insights/commands/UpdateComponentConfigurationCommand.ts +++ b/clients/client-application-insights/commands/UpdateComponentConfigurationCommand.ts @@ -24,6 +24,11 @@ import { export type UpdateComponentConfigurationCommandInput = UpdateComponentConfigurationRequest; export type UpdateComponentConfigurationCommandOutput = UpdateComponentConfigurationResponse & __MetadataBearer; +/** + *

Updates the monitoring configurations for the component. The configuration input parameter + * is an escaped JSON of the configuration and should match the schema of what is returned + * by DescribeComponentConfigurationRecommendation.

+ */ export class UpdateComponentConfigurationCommand extends $Command< UpdateComponentConfigurationCommandInput, UpdateComponentConfigurationCommandOutput, @@ -38,6 +43,9 @@ export class UpdateComponentConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/commands/UpdateLogPatternCommand.ts b/clients/client-application-insights/commands/UpdateLogPatternCommand.ts index c50e7f81ed36b..fa3c3c3470864 100644 --- a/clients/client-application-insights/commands/UpdateLogPatternCommand.ts +++ b/clients/client-application-insights/commands/UpdateLogPatternCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateLogPatternCommandInput = UpdateLogPatternRequest; export type UpdateLogPatternCommandOutput = UpdateLogPatternResponse & __MetadataBearer; +/** + *

Adds a log pattern to a LogPatternSet.

+ */ export class UpdateLogPatternCommand extends $Command< UpdateLogPatternCommandInput, UpdateLogPatternCommandOutput, @@ -38,6 +41,9 @@ export class UpdateLogPatternCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ApplicationInsightsClientResolvedConfig, diff --git a/clients/client-application-insights/package.json b/clients/client-application-insights/package.json index 63419f0782a4b..507d133f0d252 100644 --- a/clients/client-application-insights/package.json +++ b/clients/client-application-insights/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Application Insights Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-application-insights/pagination/ListApplicationsPaginator.ts b/clients/client-application-insights/pagination/ListApplicationsPaginator.ts index 43562ac7fb35d..1df93b193fb52 100644 --- a/clients/client-application-insights/pagination/ListApplicationsPaginator.ts +++ b/clients/client-application-insights/pagination/ListApplicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationInsightsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationInsightsClient, input: ListApplicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationInsights, input: ListApplicationsCommandInput, diff --git a/clients/client-application-insights/pagination/ListComponentsPaginator.ts b/clients/client-application-insights/pagination/ListComponentsPaginator.ts index 6471fdd8196e0..1ee66c6536ad0 100644 --- a/clients/client-application-insights/pagination/ListComponentsPaginator.ts +++ b/clients/client-application-insights/pagination/ListComponentsPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationInsightsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationInsightsClient, input: ListComponentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListComponentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationInsights, input: ListComponentsCommandInput, diff --git a/clients/client-application-insights/pagination/ListConfigurationHistoryPaginator.ts b/clients/client-application-insights/pagination/ListConfigurationHistoryPaginator.ts index b86b2005c246d..359505ea22e03 100644 --- a/clients/client-application-insights/pagination/ListConfigurationHistoryPaginator.ts +++ b/clients/client-application-insights/pagination/ListConfigurationHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationInsightsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationInsightsClient, input: ListConfigurationHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConfigurationHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationInsights, input: ListConfigurationHistoryCommandInput, diff --git a/clients/client-application-insights/pagination/ListLogPatternSetsPaginator.ts b/clients/client-application-insights/pagination/ListLogPatternSetsPaginator.ts index 19e4de88e61fa..3b72c4be10a02 100644 --- a/clients/client-application-insights/pagination/ListLogPatternSetsPaginator.ts +++ b/clients/client-application-insights/pagination/ListLogPatternSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationInsightsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationInsightsClient, input: ListLogPatternSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLogPatternSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationInsights, input: ListLogPatternSetsCommandInput, diff --git a/clients/client-application-insights/pagination/ListLogPatternsPaginator.ts b/clients/client-application-insights/pagination/ListLogPatternsPaginator.ts index 4672fbf8a30bf..9e969a272189b 100644 --- a/clients/client-application-insights/pagination/ListLogPatternsPaginator.ts +++ b/clients/client-application-insights/pagination/ListLogPatternsPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationInsightsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationInsightsClient, input: ListLogPatternsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLogPatternsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationInsights, input: ListLogPatternsCommandInput, diff --git a/clients/client-application-insights/pagination/ListProblemsPaginator.ts b/clients/client-application-insights/pagination/ListProblemsPaginator.ts index d240dd0dd0ddc..ff55eace439d9 100644 --- a/clients/client-application-insights/pagination/ListProblemsPaginator.ts +++ b/clients/client-application-insights/pagination/ListProblemsPaginator.ts @@ -8,6 +8,9 @@ import { import { ApplicationInsightsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ApplicationInsightsClient, input: ListProblemsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProblemsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ApplicationInsights, input: ListProblemsCommandInput, diff --git a/clients/client-application-insights/runtimeConfig.browser.ts b/clients/client-application-insights/runtimeConfig.browser.ts index bd9f188dc11a8..8681b5d42fdf1 100644 --- a/clients/client-application-insights/runtimeConfig.browser.ts +++ b/clients/client-application-insights/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ApplicationInsightsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-application-insights/runtimeConfig.native.ts b/clients/client-application-insights/runtimeConfig.native.ts index ec93382fb7b9b..6b4315ecaf555 100644 --- a/clients/client-application-insights/runtimeConfig.native.ts +++ b/clients/client-application-insights/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ApplicationInsightsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-application-insights/runtimeConfig.shared.ts b/clients/client-application-insights/runtimeConfig.shared.ts index 42123d5949c99..7c640f5ac53a6 100644 --- a/clients/client-application-insights/runtimeConfig.shared.ts +++ b/clients/client-application-insights/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-25", disableHostPrefix: false, diff --git a/clients/client-application-insights/runtimeConfig.ts b/clients/client-application-insights/runtimeConfig.ts index 4190f31460d97..3e10b86e9ddfb 100644 --- a/clients/client-application-insights/runtimeConfig.ts +++ b/clients/client-application-insights/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ApplicationInsightsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-application-insights/tsconfig.json b/clients/client-application-insights/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-application-insights/tsconfig.json +++ b/clients/client-application-insights/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-appstream/commands/AssociateFleetCommand.ts b/clients/client-appstream/commands/AssociateFleetCommand.ts index 31b02f21cdbdd..baaf50397b583 100644 --- a/clients/client-appstream/commands/AssociateFleetCommand.ts +++ b/clients/client-appstream/commands/AssociateFleetCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateFleetCommandInput = AssociateFleetRequest; export type AssociateFleetCommandOutput = AssociateFleetResult & __MetadataBearer; +/** + *

Associates the specified fleet with the specified stack.

+ */ export class AssociateFleetCommand extends $Command< AssociateFleetCommandInput, AssociateFleetCommandOutput, @@ -34,6 +37,9 @@ export class AssociateFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/BatchAssociateUserStackCommand.ts b/clients/client-appstream/commands/BatchAssociateUserStackCommand.ts index 8d7262123142b..624d35e0833e9 100644 --- a/clients/client-appstream/commands/BatchAssociateUserStackCommand.ts +++ b/clients/client-appstream/commands/BatchAssociateUserStackCommand.ts @@ -20,6 +20,9 @@ import { export type BatchAssociateUserStackCommandInput = BatchAssociateUserStackRequest; export type BatchAssociateUserStackCommandOutput = BatchAssociateUserStackResult & __MetadataBearer; +/** + *

Associates the specified users with the specified stacks. Users in a user pool cannot be assigned to stacks with fleets that are joined to an Active Directory domain.

+ */ export class BatchAssociateUserStackCommand extends $Command< BatchAssociateUserStackCommandInput, BatchAssociateUserStackCommandOutput, @@ -34,6 +37,9 @@ export class BatchAssociateUserStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/BatchDisassociateUserStackCommand.ts b/clients/client-appstream/commands/BatchDisassociateUserStackCommand.ts index 2f581cdb29071..f3e9290fec82b 100644 --- a/clients/client-appstream/commands/BatchDisassociateUserStackCommand.ts +++ b/clients/client-appstream/commands/BatchDisassociateUserStackCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDisassociateUserStackCommandInput = BatchDisassociateUserStackRequest; export type BatchDisassociateUserStackCommandOutput = BatchDisassociateUserStackResult & __MetadataBearer; +/** + *

Disassociates the specified users from the specified stacks.

+ */ export class BatchDisassociateUserStackCommand extends $Command< BatchDisassociateUserStackCommandInput, BatchDisassociateUserStackCommandOutput, @@ -34,6 +37,9 @@ export class BatchDisassociateUserStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CopyImageCommand.ts b/clients/client-appstream/commands/CopyImageCommand.ts index 714c95a7d4b11..b06311ca65a32 100644 --- a/clients/client-appstream/commands/CopyImageCommand.ts +++ b/clients/client-appstream/commands/CopyImageCommand.ts @@ -17,6 +17,9 @@ import { export type CopyImageCommandInput = CopyImageRequest; export type CopyImageCommandOutput = CopyImageResponse & __MetadataBearer; +/** + *

Copies the image within the same region or to a new region within the same AWS account. Note that any tags you added to the image will not be copied.

+ */ export class CopyImageCommand extends $Command< CopyImageCommandInput, CopyImageCommandOutput, @@ -31,6 +34,9 @@ export class CopyImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CreateDirectoryConfigCommand.ts b/clients/client-appstream/commands/CreateDirectoryConfigCommand.ts index 4a1295173fde9..318cce4b5c1b7 100644 --- a/clients/client-appstream/commands/CreateDirectoryConfigCommand.ts +++ b/clients/client-appstream/commands/CreateDirectoryConfigCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDirectoryConfigCommandInput = CreateDirectoryConfigRequest; export type CreateDirectoryConfigCommandOutput = CreateDirectoryConfigResult & __MetadataBearer; +/** + *

Creates a Directory Config object in AppStream 2.0. This object includes the configuration information required to join fleets and image builders to Microsoft Active Directory domains.

+ */ export class CreateDirectoryConfigCommand extends $Command< CreateDirectoryConfigCommandInput, CreateDirectoryConfigCommandOutput, @@ -34,6 +37,9 @@ export class CreateDirectoryConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CreateFleetCommand.ts b/clients/client-appstream/commands/CreateFleetCommand.ts index c5f55a4757592..6345e06e7589c 100644 --- a/clients/client-appstream/commands/CreateFleetCommand.ts +++ b/clients/client-appstream/commands/CreateFleetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFleetCommandInput = CreateFleetRequest; export type CreateFleetCommandOutput = CreateFleetResult & __MetadataBearer; +/** + *

Creates a fleet. A fleet consists of streaming instances that run a specified image.

+ */ export class CreateFleetCommand extends $Command< CreateFleetCommandInput, CreateFleetCommandOutput, @@ -34,6 +37,9 @@ export class CreateFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CreateImageBuilderCommand.ts b/clients/client-appstream/commands/CreateImageBuilderCommand.ts index 5f54a28126f7a..271c6efcc932a 100644 --- a/clients/client-appstream/commands/CreateImageBuilderCommand.ts +++ b/clients/client-appstream/commands/CreateImageBuilderCommand.ts @@ -20,6 +20,10 @@ import { export type CreateImageBuilderCommandInput = CreateImageBuilderRequest; export type CreateImageBuilderCommandOutput = CreateImageBuilderResult & __MetadataBearer; +/** + *

Creates an image builder. An image builder is a virtual machine that is used to create an image.

+ *

The initial state of the builder is PENDING. When it is ready, the state is RUNNING.

+ */ export class CreateImageBuilderCommand extends $Command< CreateImageBuilderCommandInput, CreateImageBuilderCommandOutput, @@ -34,6 +38,9 @@ export class CreateImageBuilderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CreateImageBuilderStreamingURLCommand.ts b/clients/client-appstream/commands/CreateImageBuilderStreamingURLCommand.ts index b90a097eb59d4..2a18100fdc7ac 100644 --- a/clients/client-appstream/commands/CreateImageBuilderStreamingURLCommand.ts +++ b/clients/client-appstream/commands/CreateImageBuilderStreamingURLCommand.ts @@ -20,6 +20,9 @@ import { export type CreateImageBuilderStreamingURLCommandInput = CreateImageBuilderStreamingURLRequest; export type CreateImageBuilderStreamingURLCommandOutput = CreateImageBuilderStreamingURLResult & __MetadataBearer; +/** + *

Creates a URL to start an image builder streaming session.

+ */ export class CreateImageBuilderStreamingURLCommand extends $Command< CreateImageBuilderStreamingURLCommandInput, CreateImageBuilderStreamingURLCommandOutput, @@ -34,6 +37,9 @@ export class CreateImageBuilderStreamingURLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CreateStackCommand.ts b/clients/client-appstream/commands/CreateStackCommand.ts index 13bca960ac43a..6a209d9470919 100644 --- a/clients/client-appstream/commands/CreateStackCommand.ts +++ b/clients/client-appstream/commands/CreateStackCommand.ts @@ -20,6 +20,9 @@ import { export type CreateStackCommandInput = CreateStackRequest; export type CreateStackCommandOutput = CreateStackResult & __MetadataBearer; +/** + *

Creates a stack to start streaming applications to users. A stack consists of an associated fleet, user access policies, and storage configurations.

+ */ export class CreateStackCommand extends $Command< CreateStackCommandInput, CreateStackCommandOutput, @@ -34,6 +37,9 @@ export class CreateStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CreateStreamingURLCommand.ts b/clients/client-appstream/commands/CreateStreamingURLCommand.ts index 89aee533fff2b..9e7825d488dfe 100644 --- a/clients/client-appstream/commands/CreateStreamingURLCommand.ts +++ b/clients/client-appstream/commands/CreateStreamingURLCommand.ts @@ -20,6 +20,9 @@ import { export type CreateStreamingURLCommandInput = CreateStreamingURLRequest; export type CreateStreamingURLCommandOutput = CreateStreamingURLResult & __MetadataBearer; +/** + *

Creates a temporary URL to start an AppStream 2.0 streaming session for the specified user. A streaming URL enables application streaming to be tested without user setup.

+ */ export class CreateStreamingURLCommand extends $Command< CreateStreamingURLCommandInput, CreateStreamingURLCommandOutput, @@ -34,6 +37,9 @@ export class CreateStreamingURLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CreateUsageReportSubscriptionCommand.ts b/clients/client-appstream/commands/CreateUsageReportSubscriptionCommand.ts index 2bcd2a2436b77..04574f309f4b1 100644 --- a/clients/client-appstream/commands/CreateUsageReportSubscriptionCommand.ts +++ b/clients/client-appstream/commands/CreateUsageReportSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUsageReportSubscriptionCommandInput = CreateUsageReportSubscriptionRequest; export type CreateUsageReportSubscriptionCommandOutput = CreateUsageReportSubscriptionResult & __MetadataBearer; +/** + *

Creates a usage report subscription. Usage reports are generated daily.

+ */ export class CreateUsageReportSubscriptionCommand extends $Command< CreateUsageReportSubscriptionCommandInput, CreateUsageReportSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class CreateUsageReportSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/CreateUserCommand.ts b/clients/client-appstream/commands/CreateUserCommand.ts index d781be5f9511b..4fbb38147495a 100644 --- a/clients/client-appstream/commands/CreateUserCommand.ts +++ b/clients/client-appstream/commands/CreateUserCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResult & __MetadataBearer; +/** + *

Creates a new user in the user pool.

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -34,6 +37,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DeleteDirectoryConfigCommand.ts b/clients/client-appstream/commands/DeleteDirectoryConfigCommand.ts index 05b7df662dcd2..0fcc0488cdfe7 100644 --- a/clients/client-appstream/commands/DeleteDirectoryConfigCommand.ts +++ b/clients/client-appstream/commands/DeleteDirectoryConfigCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDirectoryConfigCommandInput = DeleteDirectoryConfigRequest; export type DeleteDirectoryConfigCommandOutput = DeleteDirectoryConfigResult & __MetadataBearer; +/** + *

Deletes the specified Directory Config object from AppStream 2.0. This object includes the information required to join streaming instances to an Active Directory domain.

+ */ export class DeleteDirectoryConfigCommand extends $Command< DeleteDirectoryConfigCommandInput, DeleteDirectoryConfigCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDirectoryConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DeleteFleetCommand.ts b/clients/client-appstream/commands/DeleteFleetCommand.ts index 2d707aad182ca..5a8af0dcfc23f 100644 --- a/clients/client-appstream/commands/DeleteFleetCommand.ts +++ b/clients/client-appstream/commands/DeleteFleetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFleetCommandInput = DeleteFleetRequest; export type DeleteFleetCommandOutput = DeleteFleetResult & __MetadataBearer; +/** + *

Deletes the specified fleet.

+ */ export class DeleteFleetCommand extends $Command< DeleteFleetCommandInput, DeleteFleetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DeleteImageBuilderCommand.ts b/clients/client-appstream/commands/DeleteImageBuilderCommand.ts index cd63edd5a26e1..e901343bebf8b 100644 --- a/clients/client-appstream/commands/DeleteImageBuilderCommand.ts +++ b/clients/client-appstream/commands/DeleteImageBuilderCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteImageBuilderCommandInput = DeleteImageBuilderRequest; export type DeleteImageBuilderCommandOutput = DeleteImageBuilderResult & __MetadataBearer; +/** + *

Deletes the specified image builder and releases the capacity.

+ */ export class DeleteImageBuilderCommand extends $Command< DeleteImageBuilderCommandInput, DeleteImageBuilderCommandOutput, @@ -34,6 +37,9 @@ export class DeleteImageBuilderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DeleteImageCommand.ts b/clients/client-appstream/commands/DeleteImageCommand.ts index bdc2478a99bba..ab09f2d86cba6 100644 --- a/clients/client-appstream/commands/DeleteImageCommand.ts +++ b/clients/client-appstream/commands/DeleteImageCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteImageCommandInput = DeleteImageRequest; export type DeleteImageCommandOutput = DeleteImageResult & __MetadataBearer; +/** + *

Deletes the specified image. You cannot delete an image when it is in use. + * After you delete an image, you cannot provision new capacity using the image.

+ */ export class DeleteImageCommand extends $Command< DeleteImageCommandInput, DeleteImageCommandOutput, @@ -34,6 +38,9 @@ export class DeleteImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DeleteImagePermissionsCommand.ts b/clients/client-appstream/commands/DeleteImagePermissionsCommand.ts index e7bfcdb8ed2c1..f6c014bc3bc26 100644 --- a/clients/client-appstream/commands/DeleteImagePermissionsCommand.ts +++ b/clients/client-appstream/commands/DeleteImagePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteImagePermissionsCommandInput = DeleteImagePermissionsRequest; export type DeleteImagePermissionsCommandOutput = DeleteImagePermissionsResult & __MetadataBearer; +/** + *

Deletes permissions for the specified private image. After you delete permissions for an image, AWS accounts to which you previously granted these permissions can no longer use the image.

+ */ export class DeleteImagePermissionsCommand extends $Command< DeleteImagePermissionsCommandInput, DeleteImagePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteImagePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DeleteStackCommand.ts b/clients/client-appstream/commands/DeleteStackCommand.ts index 3a1863841c28c..1ffb972ef5c0e 100644 --- a/clients/client-appstream/commands/DeleteStackCommand.ts +++ b/clients/client-appstream/commands/DeleteStackCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteStackCommandInput = DeleteStackRequest; export type DeleteStackCommandOutput = DeleteStackResult & __MetadataBearer; +/** + *

Deletes the specified stack. After the stack is deleted, the application streaming environment provided by the stack is no longer available to users. Also, any reservations made for application streaming sessions for the stack are released.

+ */ export class DeleteStackCommand extends $Command< DeleteStackCommandInput, DeleteStackCommandOutput, @@ -34,6 +37,9 @@ export class DeleteStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DeleteUsageReportSubscriptionCommand.ts b/clients/client-appstream/commands/DeleteUsageReportSubscriptionCommand.ts index fec349f75fd94..ed93cc4755528 100644 --- a/clients/client-appstream/commands/DeleteUsageReportSubscriptionCommand.ts +++ b/clients/client-appstream/commands/DeleteUsageReportSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUsageReportSubscriptionCommandInput = DeleteUsageReportSubscriptionRequest; export type DeleteUsageReportSubscriptionCommandOutput = DeleteUsageReportSubscriptionResult & __MetadataBearer; +/** + *

Disables usage report generation.

+ */ export class DeleteUsageReportSubscriptionCommand extends $Command< DeleteUsageReportSubscriptionCommandInput, DeleteUsageReportSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUsageReportSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DeleteUserCommand.ts b/clients/client-appstream/commands/DeleteUserCommand.ts index f7dd2c654cc90..682aeab4f42ac 100644 --- a/clients/client-appstream/commands/DeleteUserCommand.ts +++ b/clients/client-appstream/commands/DeleteUserCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = DeleteUserResult & __MetadataBearer; +/** + *

Deletes a user from the user pool.

+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeDirectoryConfigsCommand.ts b/clients/client-appstream/commands/DescribeDirectoryConfigsCommand.ts index 75a4d2972a90c..916814ecb0cf0 100644 --- a/clients/client-appstream/commands/DescribeDirectoryConfigsCommand.ts +++ b/clients/client-appstream/commands/DescribeDirectoryConfigsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDirectoryConfigsCommandInput = DescribeDirectoryConfigsRequest; export type DescribeDirectoryConfigsCommandOutput = DescribeDirectoryConfigsResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more specified Directory Config objects for AppStream 2.0, if the names for these objects are provided. Otherwise, all Directory Config objects in the account are described. These objects include the configuration information required to join fleets and image builders to Microsoft Active Directory domains. + *

+ *

Although the response syntax in this topic includes the account password, this password is not returned in the actual response.

+ */ export class DescribeDirectoryConfigsCommand extends $Command< DescribeDirectoryConfigsCommandInput, DescribeDirectoryConfigsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDirectoryConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeFleetsCommand.ts b/clients/client-appstream/commands/DescribeFleetsCommand.ts index f13739a781b97..08ab299b9822a 100644 --- a/clients/client-appstream/commands/DescribeFleetsCommand.ts +++ b/clients/client-appstream/commands/DescribeFleetsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFleetsCommandInput = DescribeFleetsRequest; export type DescribeFleetsCommandOutput = DescribeFleetsResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more specified fleets, if the fleet names are provided. Otherwise, all fleets in the account are described.

+ */ export class DescribeFleetsCommand extends $Command< DescribeFleetsCommandInput, DescribeFleetsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFleetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeImageBuildersCommand.ts b/clients/client-appstream/commands/DescribeImageBuildersCommand.ts index 7a4c0079f9aba..ca0b7f456f61c 100644 --- a/clients/client-appstream/commands/DescribeImageBuildersCommand.ts +++ b/clients/client-appstream/commands/DescribeImageBuildersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImageBuildersCommandInput = DescribeImageBuildersRequest; export type DescribeImageBuildersCommandOutput = DescribeImageBuildersResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more specified image builders, if the image builder names are provided. Otherwise, all image builders in the account are described.

+ */ export class DescribeImageBuildersCommand extends $Command< DescribeImageBuildersCommandInput, DescribeImageBuildersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImageBuildersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeImagePermissionsCommand.ts b/clients/client-appstream/commands/DescribeImagePermissionsCommand.ts index 4433c63ccf6cf..ffa84b2b9b11a 100644 --- a/clients/client-appstream/commands/DescribeImagePermissionsCommand.ts +++ b/clients/client-appstream/commands/DescribeImagePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImagePermissionsCommandInput = DescribeImagePermissionsRequest; export type DescribeImagePermissionsCommandOutput = DescribeImagePermissionsResult & __MetadataBearer; +/** + *

Retrieves a list that describes the permissions for shared AWS account IDs on a private image that you own.

+ */ export class DescribeImagePermissionsCommand extends $Command< DescribeImagePermissionsCommandInput, DescribeImagePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImagePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeImagesCommand.ts b/clients/client-appstream/commands/DescribeImagesCommand.ts index 90939f1586773..4c5e3cefebe35 100644 --- a/clients/client-appstream/commands/DescribeImagesCommand.ts +++ b/clients/client-appstream/commands/DescribeImagesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImagesCommandInput = DescribeImagesRequest; export type DescribeImagesCommandOutput = DescribeImagesResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more specified images, if the image names or image ARNs are provided. Otherwise, all images in the account are described.

+ */ export class DescribeImagesCommand extends $Command< DescribeImagesCommandInput, DescribeImagesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeSessionsCommand.ts b/clients/client-appstream/commands/DescribeSessionsCommand.ts index 07df67a0977c3..619246e5f32a1 100644 --- a/clients/client-appstream/commands/DescribeSessionsCommand.ts +++ b/clients/client-appstream/commands/DescribeSessionsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeSessionsCommandInput = DescribeSessionsRequest; export type DescribeSessionsCommandOutput = DescribeSessionsResult & __MetadataBearer; +/** + *

Retrieves a list that describes the streaming sessions for a specified stack and fleet. If a UserId is provided for the stack and fleet, + * only streaming sessions for that user are described. If an authentication type is not provided, + * the default is to authenticate users using a streaming URL.

+ */ export class DescribeSessionsCommand extends $Command< DescribeSessionsCommandInput, DescribeSessionsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeStacksCommand.ts b/clients/client-appstream/commands/DescribeStacksCommand.ts index c08e2b5385224..a905b192bb900 100644 --- a/clients/client-appstream/commands/DescribeStacksCommand.ts +++ b/clients/client-appstream/commands/DescribeStacksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeStacksCommandInput = DescribeStacksRequest; export type DescribeStacksCommandOutput = DescribeStacksResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more specified stacks, if the stack names are provided. Otherwise, all stacks in the account are described.

+ */ export class DescribeStacksCommand extends $Command< DescribeStacksCommandInput, DescribeStacksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeStacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeUsageReportSubscriptionsCommand.ts b/clients/client-appstream/commands/DescribeUsageReportSubscriptionsCommand.ts index 7fb99064bbf13..fead5ba93b7c5 100644 --- a/clients/client-appstream/commands/DescribeUsageReportSubscriptionsCommand.ts +++ b/clients/client-appstream/commands/DescribeUsageReportSubscriptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUsageReportSubscriptionsCommandInput = DescribeUsageReportSubscriptionsRequest; export type DescribeUsageReportSubscriptionsCommandOutput = DescribeUsageReportSubscriptionsResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more usage report subscriptions.

+ */ export class DescribeUsageReportSubscriptionsCommand extends $Command< DescribeUsageReportSubscriptionsCommandInput, DescribeUsageReportSubscriptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUsageReportSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeUserStackAssociationsCommand.ts b/clients/client-appstream/commands/DescribeUserStackAssociationsCommand.ts index 876c4ac854c04..53741bb1ba174 100644 --- a/clients/client-appstream/commands/DescribeUserStackAssociationsCommand.ts +++ b/clients/client-appstream/commands/DescribeUserStackAssociationsCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeUserStackAssociationsCommandInput = DescribeUserStackAssociationsRequest; export type DescribeUserStackAssociationsCommandOutput = DescribeUserStackAssociationsResult & __MetadataBearer; +/** + *

Retrieves a list that describes the UserStackAssociation objects. You must specify either or both of the following:

+ *
    + *
  • + *

    The stack name

    + *
  • + *
  • + *

    The user name (email address of the user associated with the stack) and the authentication type for the user

    + *
  • + *
+ */ export class DescribeUserStackAssociationsCommand extends $Command< DescribeUserStackAssociationsCommandInput, DescribeUserStackAssociationsCommandOutput, @@ -34,6 +45,9 @@ export class DescribeUserStackAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DescribeUsersCommand.ts b/clients/client-appstream/commands/DescribeUsersCommand.ts index d2479d1eff9db..75180224521ce 100644 --- a/clients/client-appstream/commands/DescribeUsersCommand.ts +++ b/clients/client-appstream/commands/DescribeUsersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUsersCommandInput = DescribeUsersRequest; export type DescribeUsersCommandOutput = DescribeUsersResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more specified users in the user pool.

+ */ export class DescribeUsersCommand extends $Command< DescribeUsersCommandInput, DescribeUsersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DisableUserCommand.ts b/clients/client-appstream/commands/DisableUserCommand.ts index 6e79fdd634714..ad96ee2d05f56 100644 --- a/clients/client-appstream/commands/DisableUserCommand.ts +++ b/clients/client-appstream/commands/DisableUserCommand.ts @@ -20,6 +20,9 @@ import { export type DisableUserCommandInput = DisableUserRequest; export type DisableUserCommandOutput = DisableUserResult & __MetadataBearer; +/** + *

Disables the specified user in the user pool. Users can't sign in to AppStream 2.0 until they are re-enabled. This action does not delete the user.

+ */ export class DisableUserCommand extends $Command< DisableUserCommandInput, DisableUserCommandOutput, @@ -34,6 +37,9 @@ export class DisableUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/DisassociateFleetCommand.ts b/clients/client-appstream/commands/DisassociateFleetCommand.ts index 51c317aede21d..11acef323a734 100644 --- a/clients/client-appstream/commands/DisassociateFleetCommand.ts +++ b/clients/client-appstream/commands/DisassociateFleetCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateFleetCommandInput = DisassociateFleetRequest; export type DisassociateFleetCommandOutput = DisassociateFleetResult & __MetadataBearer; +/** + *

Disassociates the specified fleet from the specified stack.

+ */ export class DisassociateFleetCommand extends $Command< DisassociateFleetCommandInput, DisassociateFleetCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/EnableUserCommand.ts b/clients/client-appstream/commands/EnableUserCommand.ts index 78fd44f5e7436..d7e2d865abae7 100644 --- a/clients/client-appstream/commands/EnableUserCommand.ts +++ b/clients/client-appstream/commands/EnableUserCommand.ts @@ -20,6 +20,9 @@ import { export type EnableUserCommandInput = EnableUserRequest; export type EnableUserCommandOutput = EnableUserResult & __MetadataBearer; +/** + *

Enables a user in the user pool. After being enabled, users can sign in to AppStream 2.0 and open applications from the stacks to which they are assigned.

+ */ export class EnableUserCommand extends $Command< EnableUserCommandInput, EnableUserCommandOutput, @@ -34,6 +37,9 @@ export class EnableUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/ExpireSessionCommand.ts b/clients/client-appstream/commands/ExpireSessionCommand.ts index a861f3f8a2fb5..db41d48222e3f 100644 --- a/clients/client-appstream/commands/ExpireSessionCommand.ts +++ b/clients/client-appstream/commands/ExpireSessionCommand.ts @@ -20,6 +20,9 @@ import { export type ExpireSessionCommandInput = ExpireSessionRequest; export type ExpireSessionCommandOutput = ExpireSessionResult & __MetadataBearer; +/** + *

Immediately stops the specified streaming session.

+ */ export class ExpireSessionCommand extends $Command< ExpireSessionCommandInput, ExpireSessionCommandOutput, @@ -34,6 +37,9 @@ export class ExpireSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/ListAssociatedFleetsCommand.ts b/clients/client-appstream/commands/ListAssociatedFleetsCommand.ts index 55d1166076b3f..8f1835c546544 100644 --- a/clients/client-appstream/commands/ListAssociatedFleetsCommand.ts +++ b/clients/client-appstream/commands/ListAssociatedFleetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAssociatedFleetsCommandInput = ListAssociatedFleetsRequest; export type ListAssociatedFleetsCommandOutput = ListAssociatedFleetsResult & __MetadataBearer; +/** + *

Retrieves the name of the fleet that is associated with the specified stack.

+ */ export class ListAssociatedFleetsCommand extends $Command< ListAssociatedFleetsCommandInput, ListAssociatedFleetsCommandOutput, @@ -34,6 +37,9 @@ export class ListAssociatedFleetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/ListAssociatedStacksCommand.ts b/clients/client-appstream/commands/ListAssociatedStacksCommand.ts index 5856483421194..faa344666a646 100644 --- a/clients/client-appstream/commands/ListAssociatedStacksCommand.ts +++ b/clients/client-appstream/commands/ListAssociatedStacksCommand.ts @@ -20,6 +20,9 @@ import { export type ListAssociatedStacksCommandInput = ListAssociatedStacksRequest; export type ListAssociatedStacksCommandOutput = ListAssociatedStacksResult & __MetadataBearer; +/** + *

Retrieves the name of the stack with which the specified fleet is associated.

+ */ export class ListAssociatedStacksCommand extends $Command< ListAssociatedStacksCommandInput, ListAssociatedStacksCommandOutput, @@ -34,6 +37,9 @@ export class ListAssociatedStacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/ListTagsForResourceCommand.ts b/clients/client-appstream/commands/ListTagsForResourceCommand.ts index 6e5478140adcd..9857f2875f7dd 100644 --- a/clients/client-appstream/commands/ListTagsForResourceCommand.ts +++ b/clients/client-appstream/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves a list of all tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks.

+ *

For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Administration Guide.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/StartFleetCommand.ts b/clients/client-appstream/commands/StartFleetCommand.ts index df157ec066d56..bfb2a71c2dede 100644 --- a/clients/client-appstream/commands/StartFleetCommand.ts +++ b/clients/client-appstream/commands/StartFleetCommand.ts @@ -20,6 +20,9 @@ import { export type StartFleetCommandInput = StartFleetRequest; export type StartFleetCommandOutput = StartFleetResult & __MetadataBearer; +/** + *

Starts the specified fleet.

+ */ export class StartFleetCommand extends $Command< StartFleetCommandInput, StartFleetCommandOutput, @@ -34,6 +37,9 @@ export class StartFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/StartImageBuilderCommand.ts b/clients/client-appstream/commands/StartImageBuilderCommand.ts index 097dffca8d062..d37cdbcb92025 100644 --- a/clients/client-appstream/commands/StartImageBuilderCommand.ts +++ b/clients/client-appstream/commands/StartImageBuilderCommand.ts @@ -20,6 +20,9 @@ import { export type StartImageBuilderCommandInput = StartImageBuilderRequest; export type StartImageBuilderCommandOutput = StartImageBuilderResult & __MetadataBearer; +/** + *

Starts the specified image builder.

+ */ export class StartImageBuilderCommand extends $Command< StartImageBuilderCommandInput, StartImageBuilderCommandOutput, @@ -34,6 +37,9 @@ export class StartImageBuilderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/StopFleetCommand.ts b/clients/client-appstream/commands/StopFleetCommand.ts index 194dd129fe481..70a11738778a2 100644 --- a/clients/client-appstream/commands/StopFleetCommand.ts +++ b/clients/client-appstream/commands/StopFleetCommand.ts @@ -17,6 +17,9 @@ import { export type StopFleetCommandInput = StopFleetRequest; export type StopFleetCommandOutput = StopFleetResult & __MetadataBearer; +/** + *

Stops the specified fleet.

+ */ export class StopFleetCommand extends $Command< StopFleetCommandInput, StopFleetCommandOutput, @@ -31,6 +34,9 @@ export class StopFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/StopImageBuilderCommand.ts b/clients/client-appstream/commands/StopImageBuilderCommand.ts index 3f60d23f55348..9f361ee8cf8e3 100644 --- a/clients/client-appstream/commands/StopImageBuilderCommand.ts +++ b/clients/client-appstream/commands/StopImageBuilderCommand.ts @@ -20,6 +20,9 @@ import { export type StopImageBuilderCommandInput = StopImageBuilderRequest; export type StopImageBuilderCommandOutput = StopImageBuilderResult & __MetadataBearer; +/** + *

Stops the specified image builder.

+ */ export class StopImageBuilderCommand extends $Command< StopImageBuilderCommandInput, StopImageBuilderCommandOutput, @@ -34,6 +37,9 @@ export class StopImageBuilderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/TagResourceCommand.ts b/clients/client-appstream/commands/TagResourceCommand.ts index 6d74832a2ae05..cb8cefcb15099 100644 --- a/clients/client-appstream/commands/TagResourceCommand.ts +++ b/clients/client-appstream/commands/TagResourceCommand.ts @@ -20,6 +20,15 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds or overwrites one or more tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks.

+ *

Each tag consists of a key and an optional value. If a resource already has a tag with the same key, + * this operation updates its value.

+ * + *

To list the current tags for your resources, use ListTagsForResource. + * To disassociate tags from your resources, use UntagResource.

+ *

For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Administration Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +43,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/UntagResourceCommand.ts b/clients/client-appstream/commands/UntagResourceCommand.ts index 466d1016fa047..6eddd2f1b69ca 100644 --- a/clients/client-appstream/commands/UntagResourceCommand.ts +++ b/clients/client-appstream/commands/UntagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Disassociates one or more specified tags from the specified AppStream 2.0 resource.

+ *

To list the current tags for your resources, use ListTagsForResource.

+ *

For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Administration Guide.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/UpdateDirectoryConfigCommand.ts b/clients/client-appstream/commands/UpdateDirectoryConfigCommand.ts index ec7fd93cd4868..00eb1f8656f6a 100644 --- a/clients/client-appstream/commands/UpdateDirectoryConfigCommand.ts +++ b/clients/client-appstream/commands/UpdateDirectoryConfigCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDirectoryConfigCommandInput = UpdateDirectoryConfigRequest; export type UpdateDirectoryConfigCommandOutput = UpdateDirectoryConfigResult & __MetadataBearer; +/** + *

Updates the specified Directory Config object in AppStream 2.0. This object includes the configuration information required to join fleets and image builders to Microsoft Active Directory domains.

+ */ export class UpdateDirectoryConfigCommand extends $Command< UpdateDirectoryConfigCommandInput, UpdateDirectoryConfigCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDirectoryConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/UpdateFleetCommand.ts b/clients/client-appstream/commands/UpdateFleetCommand.ts index c18358decdadd..e6c869e772328 100644 --- a/clients/client-appstream/commands/UpdateFleetCommand.ts +++ b/clients/client-appstream/commands/UpdateFleetCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateFleetCommandInput = UpdateFleetRequest; export type UpdateFleetCommandOutput = UpdateFleetResult & __MetadataBearer; +/** + *

Updates the specified fleet.

+ *

If the fleet is in the STOPPED state, you can update any attribute except the fleet name. + * If the fleet is in the RUNNING state, you can update the DisplayName, ComputeCapacity, ImageARN, ImageName, IdleDisconnectTimeoutInSeconds, and DisconnectTimeoutInSeconds attributes. + * If the fleet is in the STARTING or STOPPING state, you can't update it.

+ */ export class UpdateFleetCommand extends $Command< UpdateFleetCommandInput, UpdateFleetCommandOutput, @@ -34,6 +40,9 @@ export class UpdateFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/UpdateImagePermissionsCommand.ts b/clients/client-appstream/commands/UpdateImagePermissionsCommand.ts index 1cfdd80545b75..8b8fdbe84edb8 100644 --- a/clients/client-appstream/commands/UpdateImagePermissionsCommand.ts +++ b/clients/client-appstream/commands/UpdateImagePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateImagePermissionsCommandInput = UpdateImagePermissionsRequest; export type UpdateImagePermissionsCommandOutput = UpdateImagePermissionsResult & __MetadataBearer; +/** + *

Adds or updates permissions for the specified private image.

+ */ export class UpdateImagePermissionsCommand extends $Command< UpdateImagePermissionsCommandInput, UpdateImagePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateImagePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/commands/UpdateStackCommand.ts b/clients/client-appstream/commands/UpdateStackCommand.ts index a8efb09a73ee0..e7298cf65d529 100644 --- a/clients/client-appstream/commands/UpdateStackCommand.ts +++ b/clients/client-appstream/commands/UpdateStackCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateStackCommandInput = UpdateStackRequest; export type UpdateStackCommandOutput = UpdateStackResult & __MetadataBearer; +/** + *

Updates the specified fields for the specified stack.

+ */ export class UpdateStackCommand extends $Command< UpdateStackCommandInput, UpdateStackCommandOutput, @@ -34,6 +37,9 @@ export class UpdateStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppStreamClientResolvedConfig, diff --git a/clients/client-appstream/package.json b/clients/client-appstream/package.json index 8639c64a6de9a..2a5dad7afcc82 100644 --- a/clients/client-appstream/package.json +++ b/clients/client-appstream/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Appstream Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-appstream/pagination/DescribeImagePermissionsPaginator.ts b/clients/client-appstream/pagination/DescribeImagePermissionsPaginator.ts index a7aaa3a5f02b2..4800800eca15c 100644 --- a/clients/client-appstream/pagination/DescribeImagePermissionsPaginator.ts +++ b/clients/client-appstream/pagination/DescribeImagePermissionsPaginator.ts @@ -8,6 +8,9 @@ import { import { AppStreamPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppStreamClient, input: DescribeImagePermissionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeImagePermissionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppStream, input: DescribeImagePermissionsCommandInput, diff --git a/clients/client-appstream/pagination/DescribeImagesPaginator.ts b/clients/client-appstream/pagination/DescribeImagesPaginator.ts index 873059fa9822c..7de3247c3291b 100644 --- a/clients/client-appstream/pagination/DescribeImagesPaginator.ts +++ b/clients/client-appstream/pagination/DescribeImagesPaginator.ts @@ -8,6 +8,9 @@ import { import { AppStreamPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AppStreamClient, input: DescribeImagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeImagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AppStream, input: DescribeImagesCommandInput, diff --git a/clients/client-appstream/runtimeConfig.browser.ts b/clients/client-appstream/runtimeConfig.browser.ts index e5943ea18519a..915df1b1d9d70 100644 --- a/clients/client-appstream/runtimeConfig.browser.ts +++ b/clients/client-appstream/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AppStreamClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-appstream/runtimeConfig.native.ts b/clients/client-appstream/runtimeConfig.native.ts index 9703fa101ad36..c2b730acd6ce1 100644 --- a/clients/client-appstream/runtimeConfig.native.ts +++ b/clients/client-appstream/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AppStreamClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-appstream/runtimeConfig.shared.ts b/clients/client-appstream/runtimeConfig.shared.ts index 4483500916479..cd1610b3a45eb 100644 --- a/clients/client-appstream/runtimeConfig.shared.ts +++ b/clients/client-appstream/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-12-01", disableHostPrefix: false, diff --git a/clients/client-appstream/runtimeConfig.ts b/clients/client-appstream/runtimeConfig.ts index b758488fb5919..b3ab095188b32 100644 --- a/clients/client-appstream/runtimeConfig.ts +++ b/clients/client-appstream/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AppStreamClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-appstream/tsconfig.json b/clients/client-appstream/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-appstream/tsconfig.json +++ b/clients/client-appstream/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-appsync/commands/CreateApiCacheCommand.ts b/clients/client-appsync/commands/CreateApiCacheCommand.ts index be148ce2c0bef..a3f95dc0f0b14 100644 --- a/clients/client-appsync/commands/CreateApiCacheCommand.ts +++ b/clients/client-appsync/commands/CreateApiCacheCommand.ts @@ -20,6 +20,9 @@ import { export type CreateApiCacheCommandInput = CreateApiCacheRequest; export type CreateApiCacheCommandOutput = CreateApiCacheResponse & __MetadataBearer; +/** + *

Creates a cache for the GraphQL API.

+ */ export class CreateApiCacheCommand extends $Command< CreateApiCacheCommandInput, CreateApiCacheCommandOutput, @@ -34,6 +37,9 @@ export class CreateApiCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/CreateApiKeyCommand.ts b/clients/client-appsync/commands/CreateApiKeyCommand.ts index a399578d261fe..1df8864a67943 100644 --- a/clients/client-appsync/commands/CreateApiKeyCommand.ts +++ b/clients/client-appsync/commands/CreateApiKeyCommand.ts @@ -20,6 +20,10 @@ import { export type CreateApiKeyCommandInput = CreateApiKeyRequest; export type CreateApiKeyCommandOutput = CreateApiKeyResponse & __MetadataBearer; +/** + *

Creates a unique key that you can distribute to clients who are executing your + * API.

+ */ export class CreateApiKeyCommand extends $Command< CreateApiKeyCommandInput, CreateApiKeyCommandOutput, @@ -34,6 +38,9 @@ export class CreateApiKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/CreateDataSourceCommand.ts b/clients/client-appsync/commands/CreateDataSourceCommand.ts index 2be4fbe3fea9f..68f2944202444 100644 --- a/clients/client-appsync/commands/CreateDataSourceCommand.ts +++ b/clients/client-appsync/commands/CreateDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDataSourceCommandInput = CreateDataSourceRequest; export type CreateDataSourceCommandOutput = CreateDataSourceResponse & __MetadataBearer; +/** + *

Creates a DataSource object.

+ */ export class CreateDataSourceCommand extends $Command< CreateDataSourceCommandInput, CreateDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class CreateDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/CreateFunctionCommand.ts b/clients/client-appsync/commands/CreateFunctionCommand.ts index 72a5fcc6bf537..1f975a9af7602 100644 --- a/clients/client-appsync/commands/CreateFunctionCommand.ts +++ b/clients/client-appsync/commands/CreateFunctionCommand.ts @@ -20,6 +20,11 @@ import { export type CreateFunctionCommandInput = CreateFunctionRequest; export type CreateFunctionCommandOutput = CreateFunctionResponse & __MetadataBearer; +/** + *

Creates a Function object.

+ *

A function is a reusable entity. Multiple functions can be used to compose the resolver + * logic.

+ */ export class CreateFunctionCommand extends $Command< CreateFunctionCommandInput, CreateFunctionCommandOutput, @@ -34,6 +39,9 @@ export class CreateFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/CreateGraphqlApiCommand.ts b/clients/client-appsync/commands/CreateGraphqlApiCommand.ts index ad37fc77ee1e8..3d4a71a732bcc 100644 --- a/clients/client-appsync/commands/CreateGraphqlApiCommand.ts +++ b/clients/client-appsync/commands/CreateGraphqlApiCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGraphqlApiCommandInput = CreateGraphqlApiRequest; export type CreateGraphqlApiCommandOutput = CreateGraphqlApiResponse & __MetadataBearer; +/** + *

Creates a GraphqlApi object.

+ */ export class CreateGraphqlApiCommand extends $Command< CreateGraphqlApiCommandInput, CreateGraphqlApiCommandOutput, @@ -34,6 +37,9 @@ export class CreateGraphqlApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/CreateResolverCommand.ts b/clients/client-appsync/commands/CreateResolverCommand.ts index b2346ea748278..3d71cb0914065 100644 --- a/clients/client-appsync/commands/CreateResolverCommand.ts +++ b/clients/client-appsync/commands/CreateResolverCommand.ts @@ -20,6 +20,11 @@ import { export type CreateResolverCommandInput = CreateResolverRequest; export type CreateResolverCommandOutput = CreateResolverResponse & __MetadataBearer; +/** + *

Creates a Resolver object.

+ *

A resolver converts incoming requests into a format that a data source can understand + * and converts the data source's responses into GraphQL.

+ */ export class CreateResolverCommand extends $Command< CreateResolverCommandInput, CreateResolverCommandOutput, @@ -34,6 +39,9 @@ export class CreateResolverCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/CreateTypeCommand.ts b/clients/client-appsync/commands/CreateTypeCommand.ts index 02dce5e17289e..6fdc51bd86dd2 100644 --- a/clients/client-appsync/commands/CreateTypeCommand.ts +++ b/clients/client-appsync/commands/CreateTypeCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTypeCommandInput = CreateTypeRequest; export type CreateTypeCommandOutput = CreateTypeResponse & __MetadataBearer; +/** + *

Creates a Type object.

+ */ export class CreateTypeCommand extends $Command< CreateTypeCommandInput, CreateTypeCommandOutput, @@ -34,6 +37,9 @@ export class CreateTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/DeleteApiCacheCommand.ts b/clients/client-appsync/commands/DeleteApiCacheCommand.ts index 9b3a207606226..4990e595f2218 100644 --- a/clients/client-appsync/commands/DeleteApiCacheCommand.ts +++ b/clients/client-appsync/commands/DeleteApiCacheCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApiCacheCommandInput = DeleteApiCacheRequest; export type DeleteApiCacheCommandOutput = DeleteApiCacheResponse & __MetadataBearer; +/** + *

Deletes an ApiCache object.

+ */ export class DeleteApiCacheCommand extends $Command< DeleteApiCacheCommandInput, DeleteApiCacheCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApiCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/DeleteApiKeyCommand.ts b/clients/client-appsync/commands/DeleteApiKeyCommand.ts index 786b75382acdb..c81840db78c31 100644 --- a/clients/client-appsync/commands/DeleteApiKeyCommand.ts +++ b/clients/client-appsync/commands/DeleteApiKeyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApiKeyCommandInput = DeleteApiKeyRequest; export type DeleteApiKeyCommandOutput = DeleteApiKeyResponse & __MetadataBearer; +/** + *

Deletes an API key.

+ */ export class DeleteApiKeyCommand extends $Command< DeleteApiKeyCommandInput, DeleteApiKeyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApiKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/DeleteDataSourceCommand.ts b/clients/client-appsync/commands/DeleteDataSourceCommand.ts index ae386c0478083..cb0783198c7ea 100644 --- a/clients/client-appsync/commands/DeleteDataSourceCommand.ts +++ b/clients/client-appsync/commands/DeleteDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDataSourceCommandInput = DeleteDataSourceRequest; export type DeleteDataSourceCommandOutput = DeleteDataSourceResponse & __MetadataBearer; +/** + *

Deletes a DataSource object.

+ */ export class DeleteDataSourceCommand extends $Command< DeleteDataSourceCommandInput, DeleteDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/DeleteFunctionCommand.ts b/clients/client-appsync/commands/DeleteFunctionCommand.ts index d203941c8fa52..9c441c5db4c1a 100644 --- a/clients/client-appsync/commands/DeleteFunctionCommand.ts +++ b/clients/client-appsync/commands/DeleteFunctionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFunctionCommandInput = DeleteFunctionRequest; export type DeleteFunctionCommandOutput = DeleteFunctionResponse & __MetadataBearer; +/** + *

Deletes a Function.

+ */ export class DeleteFunctionCommand extends $Command< DeleteFunctionCommandInput, DeleteFunctionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/DeleteGraphqlApiCommand.ts b/clients/client-appsync/commands/DeleteGraphqlApiCommand.ts index ddf31fe38a323..bc3430686ef47 100644 --- a/clients/client-appsync/commands/DeleteGraphqlApiCommand.ts +++ b/clients/client-appsync/commands/DeleteGraphqlApiCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGraphqlApiCommandInput = DeleteGraphqlApiRequest; export type DeleteGraphqlApiCommandOutput = DeleteGraphqlApiResponse & __MetadataBearer; +/** + *

Deletes a GraphqlApi object.

+ */ export class DeleteGraphqlApiCommand extends $Command< DeleteGraphqlApiCommandInput, DeleteGraphqlApiCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGraphqlApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/DeleteResolverCommand.ts b/clients/client-appsync/commands/DeleteResolverCommand.ts index 9ba1ad1d80b7d..9c394d667fc9d 100644 --- a/clients/client-appsync/commands/DeleteResolverCommand.ts +++ b/clients/client-appsync/commands/DeleteResolverCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResolverCommandInput = DeleteResolverRequest; export type DeleteResolverCommandOutput = DeleteResolverResponse & __MetadataBearer; +/** + *

Deletes a Resolver object.

+ */ export class DeleteResolverCommand extends $Command< DeleteResolverCommandInput, DeleteResolverCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResolverCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/DeleteTypeCommand.ts b/clients/client-appsync/commands/DeleteTypeCommand.ts index 6909ad45f7ad6..16e04595bbbd7 100644 --- a/clients/client-appsync/commands/DeleteTypeCommand.ts +++ b/clients/client-appsync/commands/DeleteTypeCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTypeCommandInput = DeleteTypeRequest; export type DeleteTypeCommandOutput = DeleteTypeResponse & __MetadataBearer; +/** + *

Deletes a Type object.

+ */ export class DeleteTypeCommand extends $Command< DeleteTypeCommandInput, DeleteTypeCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/FlushApiCacheCommand.ts b/clients/client-appsync/commands/FlushApiCacheCommand.ts index 049ee5ed575a9..63b3d3188136f 100644 --- a/clients/client-appsync/commands/FlushApiCacheCommand.ts +++ b/clients/client-appsync/commands/FlushApiCacheCommand.ts @@ -20,6 +20,9 @@ import { export type FlushApiCacheCommandInput = FlushApiCacheRequest; export type FlushApiCacheCommandOutput = FlushApiCacheResponse & __MetadataBearer; +/** + *

Flushes an ApiCache object.

+ */ export class FlushApiCacheCommand extends $Command< FlushApiCacheCommandInput, FlushApiCacheCommandOutput, @@ -34,6 +37,9 @@ export class FlushApiCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/GetApiCacheCommand.ts b/clients/client-appsync/commands/GetApiCacheCommand.ts index 0ed867d4d801d..f61e9384adbdd 100644 --- a/clients/client-appsync/commands/GetApiCacheCommand.ts +++ b/clients/client-appsync/commands/GetApiCacheCommand.ts @@ -20,6 +20,9 @@ import { export type GetApiCacheCommandInput = GetApiCacheRequest; export type GetApiCacheCommandOutput = GetApiCacheResponse & __MetadataBearer; +/** + *

Retrieves an ApiCache object.

+ */ export class GetApiCacheCommand extends $Command< GetApiCacheCommandInput, GetApiCacheCommandOutput, @@ -34,6 +37,9 @@ export class GetApiCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/GetDataSourceCommand.ts b/clients/client-appsync/commands/GetDataSourceCommand.ts index 0253dd3473829..92cfa9eb9ef78 100644 --- a/clients/client-appsync/commands/GetDataSourceCommand.ts +++ b/clients/client-appsync/commands/GetDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type GetDataSourceCommandInput = GetDataSourceRequest; export type GetDataSourceCommandOutput = GetDataSourceResponse & __MetadataBearer; +/** + *

Retrieves a DataSource object.

+ */ export class GetDataSourceCommand extends $Command< GetDataSourceCommandInput, GetDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class GetDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/GetFunctionCommand.ts b/clients/client-appsync/commands/GetFunctionCommand.ts index 8acd2e32e7624..ef42d940fc9fe 100644 --- a/clients/client-appsync/commands/GetFunctionCommand.ts +++ b/clients/client-appsync/commands/GetFunctionCommand.ts @@ -20,6 +20,9 @@ import { export type GetFunctionCommandInput = GetFunctionRequest; export type GetFunctionCommandOutput = GetFunctionResponse & __MetadataBearer; +/** + *

Get a Function.

+ */ export class GetFunctionCommand extends $Command< GetFunctionCommandInput, GetFunctionCommandOutput, @@ -34,6 +37,9 @@ export class GetFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/GetGraphqlApiCommand.ts b/clients/client-appsync/commands/GetGraphqlApiCommand.ts index 97c8f3acb6e84..fef82aaab1764 100644 --- a/clients/client-appsync/commands/GetGraphqlApiCommand.ts +++ b/clients/client-appsync/commands/GetGraphqlApiCommand.ts @@ -20,6 +20,9 @@ import { export type GetGraphqlApiCommandInput = GetGraphqlApiRequest; export type GetGraphqlApiCommandOutput = GetGraphqlApiResponse & __MetadataBearer; +/** + *

Retrieves a GraphqlApi object.

+ */ export class GetGraphqlApiCommand extends $Command< GetGraphqlApiCommandInput, GetGraphqlApiCommandOutput, @@ -34,6 +37,9 @@ export class GetGraphqlApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/GetIntrospectionSchemaCommand.ts b/clients/client-appsync/commands/GetIntrospectionSchemaCommand.ts index 6faaa202f008f..ef17a2e9ea6ec 100644 --- a/clients/client-appsync/commands/GetIntrospectionSchemaCommand.ts +++ b/clients/client-appsync/commands/GetIntrospectionSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type GetIntrospectionSchemaCommandInput = GetIntrospectionSchemaRequest; export type GetIntrospectionSchemaCommandOutput = GetIntrospectionSchemaResponse & __MetadataBearer; +/** + *

Retrieves the introspection schema for a GraphQL API.

+ */ export class GetIntrospectionSchemaCommand extends $Command< GetIntrospectionSchemaCommandInput, GetIntrospectionSchemaCommandOutput, @@ -34,6 +37,9 @@ export class GetIntrospectionSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/GetResolverCommand.ts b/clients/client-appsync/commands/GetResolverCommand.ts index 41e7d599150af..87ccffe334300 100644 --- a/clients/client-appsync/commands/GetResolverCommand.ts +++ b/clients/client-appsync/commands/GetResolverCommand.ts @@ -20,6 +20,9 @@ import { export type GetResolverCommandInput = GetResolverRequest; export type GetResolverCommandOutput = GetResolverResponse & __MetadataBearer; +/** + *

Retrieves a Resolver object.

+ */ export class GetResolverCommand extends $Command< GetResolverCommandInput, GetResolverCommandOutput, @@ -34,6 +37,9 @@ export class GetResolverCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/GetSchemaCreationStatusCommand.ts b/clients/client-appsync/commands/GetSchemaCreationStatusCommand.ts index 8da85cf831d89..62ca7bbc42143 100644 --- a/clients/client-appsync/commands/GetSchemaCreationStatusCommand.ts +++ b/clients/client-appsync/commands/GetSchemaCreationStatusCommand.ts @@ -20,6 +20,9 @@ import { export type GetSchemaCreationStatusCommandInput = GetSchemaCreationStatusRequest; export type GetSchemaCreationStatusCommandOutput = GetSchemaCreationStatusResponse & __MetadataBearer; +/** + *

Retrieves the current status of a schema creation operation.

+ */ export class GetSchemaCreationStatusCommand extends $Command< GetSchemaCreationStatusCommandInput, GetSchemaCreationStatusCommandOutput, @@ -34,6 +37,9 @@ export class GetSchemaCreationStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/GetTypeCommand.ts b/clients/client-appsync/commands/GetTypeCommand.ts index 870d1e51ec119..e8793e9213901 100644 --- a/clients/client-appsync/commands/GetTypeCommand.ts +++ b/clients/client-appsync/commands/GetTypeCommand.ts @@ -20,6 +20,9 @@ import { export type GetTypeCommandInput = GetTypeRequest; export type GetTypeCommandOutput = GetTypeResponse & __MetadataBearer; +/** + *

Retrieves a Type object.

+ */ export class GetTypeCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class GetTypeCommand extends $Command, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/ListApiKeysCommand.ts b/clients/client-appsync/commands/ListApiKeysCommand.ts index 95f089fa3c89a..037d2fe245cc0 100644 --- a/clients/client-appsync/commands/ListApiKeysCommand.ts +++ b/clients/client-appsync/commands/ListApiKeysCommand.ts @@ -20,6 +20,15 @@ import { export type ListApiKeysCommandInput = ListApiKeysRequest; export type ListApiKeysCommandOutput = ListApiKeysResponse & __MetadataBearer; +/** + *

Lists the API keys for a given API.

+ * + *

API keys are deleted automatically 60 days after they expire. However, they may + * still be included in the response until they have actually been deleted. You can safely + * call DeleteApiKey to manually delete a key before it's automatically + * deleted.

+ *
+ */ export class ListApiKeysCommand extends $Command< ListApiKeysCommandInput, ListApiKeysCommandOutput, @@ -34,6 +43,9 @@ export class ListApiKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/ListDataSourcesCommand.ts b/clients/client-appsync/commands/ListDataSourcesCommand.ts index f178218161220..eefb389f99e56 100644 --- a/clients/client-appsync/commands/ListDataSourcesCommand.ts +++ b/clients/client-appsync/commands/ListDataSourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDataSourcesCommandInput = ListDataSourcesRequest; export type ListDataSourcesCommandOutput = ListDataSourcesResponse & __MetadataBearer; +/** + *

Lists the data sources for a given API.

+ */ export class ListDataSourcesCommand extends $Command< ListDataSourcesCommandInput, ListDataSourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListDataSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/ListFunctionsCommand.ts b/clients/client-appsync/commands/ListFunctionsCommand.ts index f65e3c9c276e9..5d2ffd2d6d3bb 100644 --- a/clients/client-appsync/commands/ListFunctionsCommand.ts +++ b/clients/client-appsync/commands/ListFunctionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFunctionsCommandInput = ListFunctionsRequest; export type ListFunctionsCommandOutput = ListFunctionsResponse & __MetadataBearer; +/** + *

List multiple functions.

+ */ export class ListFunctionsCommand extends $Command< ListFunctionsCommandInput, ListFunctionsCommandOutput, @@ -34,6 +37,9 @@ export class ListFunctionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/ListGraphqlApisCommand.ts b/clients/client-appsync/commands/ListGraphqlApisCommand.ts index d6bf46e227e28..819c32907b074 100644 --- a/clients/client-appsync/commands/ListGraphqlApisCommand.ts +++ b/clients/client-appsync/commands/ListGraphqlApisCommand.ts @@ -20,6 +20,9 @@ import { export type ListGraphqlApisCommandInput = ListGraphqlApisRequest; export type ListGraphqlApisCommandOutput = ListGraphqlApisResponse & __MetadataBearer; +/** + *

Lists your GraphQL APIs.

+ */ export class ListGraphqlApisCommand extends $Command< ListGraphqlApisCommandInput, ListGraphqlApisCommandOutput, @@ -34,6 +37,9 @@ export class ListGraphqlApisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/ListResolversByFunctionCommand.ts b/clients/client-appsync/commands/ListResolversByFunctionCommand.ts index 8ea053c4c8dde..63b372a3c2974 100644 --- a/clients/client-appsync/commands/ListResolversByFunctionCommand.ts +++ b/clients/client-appsync/commands/ListResolversByFunctionCommand.ts @@ -20,6 +20,9 @@ import { export type ListResolversByFunctionCommandInput = ListResolversByFunctionRequest; export type ListResolversByFunctionCommandOutput = ListResolversByFunctionResponse & __MetadataBearer; +/** + *

List the resolvers that are associated with a specific function.

+ */ export class ListResolversByFunctionCommand extends $Command< ListResolversByFunctionCommandInput, ListResolversByFunctionCommandOutput, @@ -34,6 +37,9 @@ export class ListResolversByFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/ListResolversCommand.ts b/clients/client-appsync/commands/ListResolversCommand.ts index 9fb961411daab..6e689efb4bd85 100644 --- a/clients/client-appsync/commands/ListResolversCommand.ts +++ b/clients/client-appsync/commands/ListResolversCommand.ts @@ -20,6 +20,9 @@ import { export type ListResolversCommandInput = ListResolversRequest; export type ListResolversCommandOutput = ListResolversResponse & __MetadataBearer; +/** + *

Lists the resolvers for a given API and type.

+ */ export class ListResolversCommand extends $Command< ListResolversCommandInput, ListResolversCommandOutput, @@ -34,6 +37,9 @@ export class ListResolversCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/ListTagsForResourceCommand.ts b/clients/client-appsync/commands/ListTagsForResourceCommand.ts index 379f809a7d070..a64fccfdf2a8f 100644 --- a/clients/client-appsync/commands/ListTagsForResourceCommand.ts +++ b/clients/client-appsync/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags for a resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/ListTypesCommand.ts b/clients/client-appsync/commands/ListTypesCommand.ts index ca8a4b6805bdc..cdc239efd64d1 100644 --- a/clients/client-appsync/commands/ListTypesCommand.ts +++ b/clients/client-appsync/commands/ListTypesCommand.ts @@ -20,6 +20,9 @@ import { export type ListTypesCommandInput = ListTypesRequest; export type ListTypesCommandOutput = ListTypesResponse & __MetadataBearer; +/** + *

Lists the types for a given API.

+ */ export class ListTypesCommand extends $Command< ListTypesCommandInput, ListTypesCommandOutput, @@ -34,6 +37,9 @@ export class ListTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/StartSchemaCreationCommand.ts b/clients/client-appsync/commands/StartSchemaCreationCommand.ts index ddacc3e8ae8c0..22200a279092b 100644 --- a/clients/client-appsync/commands/StartSchemaCreationCommand.ts +++ b/clients/client-appsync/commands/StartSchemaCreationCommand.ts @@ -20,6 +20,11 @@ import { export type StartSchemaCreationCommandInput = StartSchemaCreationRequest; export type StartSchemaCreationCommandOutput = StartSchemaCreationResponse & __MetadataBearer; +/** + *

Adds a new schema to your GraphQL API.

+ *

This operation is asynchronous. Use to + * determine when it has completed.

+ */ export class StartSchemaCreationCommand extends $Command< StartSchemaCreationCommandInput, StartSchemaCreationCommandOutput, @@ -34,6 +39,9 @@ export class StartSchemaCreationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/TagResourceCommand.ts b/clients/client-appsync/commands/TagResourceCommand.ts index 8ff4fa7c805f8..c4ae673bd8e57 100644 --- a/clients/client-appsync/commands/TagResourceCommand.ts +++ b/clients/client-appsync/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Tags a resource with user-supplied tags.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/UntagResourceCommand.ts b/clients/client-appsync/commands/UntagResourceCommand.ts index a4a2c27e5855c..8df2f0a2f5371 100644 --- a/clients/client-appsync/commands/UntagResourceCommand.ts +++ b/clients/client-appsync/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Untags a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/UpdateApiCacheCommand.ts b/clients/client-appsync/commands/UpdateApiCacheCommand.ts index 3fb3f5bfbd8ca..20f6190322521 100644 --- a/clients/client-appsync/commands/UpdateApiCacheCommand.ts +++ b/clients/client-appsync/commands/UpdateApiCacheCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApiCacheCommandInput = UpdateApiCacheRequest; export type UpdateApiCacheCommandOutput = UpdateApiCacheResponse & __MetadataBearer; +/** + *

Updates the cache for the GraphQL API.

+ */ export class UpdateApiCacheCommand extends $Command< UpdateApiCacheCommandInput, UpdateApiCacheCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApiCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/UpdateApiKeyCommand.ts b/clients/client-appsync/commands/UpdateApiKeyCommand.ts index 3d812e3698596..2612bdb95ffde 100644 --- a/clients/client-appsync/commands/UpdateApiKeyCommand.ts +++ b/clients/client-appsync/commands/UpdateApiKeyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApiKeyCommandInput = UpdateApiKeyRequest; export type UpdateApiKeyCommandOutput = UpdateApiKeyResponse & __MetadataBearer; +/** + *

Updates an API key. The key can be updated while it is not deleted.

+ */ export class UpdateApiKeyCommand extends $Command< UpdateApiKeyCommandInput, UpdateApiKeyCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApiKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/UpdateDataSourceCommand.ts b/clients/client-appsync/commands/UpdateDataSourceCommand.ts index d20f2ac6a7513..512a6e1ab9a67 100644 --- a/clients/client-appsync/commands/UpdateDataSourceCommand.ts +++ b/clients/client-appsync/commands/UpdateDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDataSourceCommandInput = UpdateDataSourceRequest; export type UpdateDataSourceCommandOutput = UpdateDataSourceResponse & __MetadataBearer; +/** + *

Updates a DataSource object.

+ */ export class UpdateDataSourceCommand extends $Command< UpdateDataSourceCommandInput, UpdateDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/UpdateFunctionCommand.ts b/clients/client-appsync/commands/UpdateFunctionCommand.ts index 79cdc04d26d20..559c516f78735 100644 --- a/clients/client-appsync/commands/UpdateFunctionCommand.ts +++ b/clients/client-appsync/commands/UpdateFunctionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFunctionCommandInput = UpdateFunctionRequest; export type UpdateFunctionCommandOutput = UpdateFunctionResponse & __MetadataBearer; +/** + *

Updates a Function object.

+ */ export class UpdateFunctionCommand extends $Command< UpdateFunctionCommandInput, UpdateFunctionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/UpdateGraphqlApiCommand.ts b/clients/client-appsync/commands/UpdateGraphqlApiCommand.ts index b728b2793bbf5..ffc2550b779a7 100644 --- a/clients/client-appsync/commands/UpdateGraphqlApiCommand.ts +++ b/clients/client-appsync/commands/UpdateGraphqlApiCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGraphqlApiCommandInput = UpdateGraphqlApiRequest; export type UpdateGraphqlApiCommandOutput = UpdateGraphqlApiResponse & __MetadataBearer; +/** + *

Updates a GraphqlApi object.

+ */ export class UpdateGraphqlApiCommand extends $Command< UpdateGraphqlApiCommandInput, UpdateGraphqlApiCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGraphqlApiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/UpdateResolverCommand.ts b/clients/client-appsync/commands/UpdateResolverCommand.ts index 0496bda16dd49..95086c9eface4 100644 --- a/clients/client-appsync/commands/UpdateResolverCommand.ts +++ b/clients/client-appsync/commands/UpdateResolverCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateResolverCommandInput = UpdateResolverRequest; export type UpdateResolverCommandOutput = UpdateResolverResponse & __MetadataBearer; +/** + *

Updates a Resolver object.

+ */ export class UpdateResolverCommand extends $Command< UpdateResolverCommandInput, UpdateResolverCommandOutput, @@ -34,6 +37,9 @@ export class UpdateResolverCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/commands/UpdateTypeCommand.ts b/clients/client-appsync/commands/UpdateTypeCommand.ts index 450400fc692f8..08e7f2188cae7 100644 --- a/clients/client-appsync/commands/UpdateTypeCommand.ts +++ b/clients/client-appsync/commands/UpdateTypeCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTypeCommandInput = UpdateTypeRequest; export type UpdateTypeCommandOutput = UpdateTypeResponse & __MetadataBearer; +/** + *

Updates a Type object.

+ */ export class UpdateTypeCommand extends $Command< UpdateTypeCommandInput, UpdateTypeCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AppSyncClientResolvedConfig, diff --git a/clients/client-appsync/package.json b/clients/client-appsync/package.json index 69087ff307b71..a927d64757c46 100644 --- a/clients/client-appsync/package.json +++ b/clients/client-appsync/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Appsync Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-appsync/runtimeConfig.browser.ts b/clients/client-appsync/runtimeConfig.browser.ts index be1e39c06bed6..8a7310381c7cd 100644 --- a/clients/client-appsync/runtimeConfig.browser.ts +++ b/clients/client-appsync/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AppSyncClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-appsync/runtimeConfig.native.ts b/clients/client-appsync/runtimeConfig.native.ts index ff8386e64edbb..8281561ead585 100644 --- a/clients/client-appsync/runtimeConfig.native.ts +++ b/clients/client-appsync/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AppSyncClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-appsync/runtimeConfig.shared.ts b/clients/client-appsync/runtimeConfig.shared.ts index fc2b38d74d6f2..f9250a2a4121f 100644 --- a/clients/client-appsync/runtimeConfig.shared.ts +++ b/clients/client-appsync/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-25", disableHostPrefix: false, diff --git a/clients/client-appsync/runtimeConfig.ts b/clients/client-appsync/runtimeConfig.ts index 8d0df6be3fd8d..f8163806f57de 100644 --- a/clients/client-appsync/runtimeConfig.ts +++ b/clients/client-appsync/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AppSyncClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-appsync/tsconfig.json b/clients/client-appsync/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-appsync/tsconfig.json +++ b/clients/client-appsync/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-athena/commands/BatchGetNamedQueryCommand.ts b/clients/client-athena/commands/BatchGetNamedQueryCommand.ts index 44d029111036b..613e12048ba97 100644 --- a/clients/client-athena/commands/BatchGetNamedQueryCommand.ts +++ b/clients/client-athena/commands/BatchGetNamedQueryCommand.ts @@ -20,6 +20,17 @@ import { export type BatchGetNamedQueryCommandInput = BatchGetNamedQueryInput; export type BatchGetNamedQueryCommandOutput = BatchGetNamedQueryOutput & __MetadataBearer; +/** + *

Returns the details of a single named query or a list of up to 50 queries, which you + * provide as an array of query ID strings. Requires you to have access to the workgroup in + * which the queries were saved. Use ListNamedQueriesInput to get the + * list of named query IDs in the specified workgroup. If information could not be + * retrieved for a submitted query ID, information about the query ID submitted is listed + * under UnprocessedNamedQueryId. Named queries differ from executed + * queries. Use BatchGetQueryExecutionInput to get details about each + * unique query execution, and ListQueryExecutionsInput to get a list of + * query execution IDs.

+ */ export class BatchGetNamedQueryCommand extends $Command< BatchGetNamedQueryCommandInput, BatchGetNamedQueryCommandOutput, @@ -34,6 +45,9 @@ export class BatchGetNamedQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/BatchGetQueryExecutionCommand.ts b/clients/client-athena/commands/BatchGetQueryExecutionCommand.ts index 4a74ca8b77bb9..e72780a0d45aa 100644 --- a/clients/client-athena/commands/BatchGetQueryExecutionCommand.ts +++ b/clients/client-athena/commands/BatchGetQueryExecutionCommand.ts @@ -20,6 +20,14 @@ import { export type BatchGetQueryExecutionCommandInput = BatchGetQueryExecutionInput; export type BatchGetQueryExecutionCommandOutput = BatchGetQueryExecutionOutput & __MetadataBearer; +/** + *

Returns the details of a single query execution or a list of up to 50 query + * executions, which you provide as an array of query execution ID strings. Requires you to + * have access to the workgroup in which the queries ran. To get a list of query execution + * IDs, use ListQueryExecutionsInput$WorkGroup. Query executions differ + * from named (saved) queries. Use BatchGetNamedQueryInput to get details + * about named queries.

+ */ export class BatchGetQueryExecutionCommand extends $Command< BatchGetQueryExecutionCommandInput, BatchGetQueryExecutionCommandOutput, @@ -34,6 +42,9 @@ export class BatchGetQueryExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/CreateDataCatalogCommand.ts b/clients/client-athena/commands/CreateDataCatalogCommand.ts index 39f9831eefdd9..8e2d9bafe515d 100644 --- a/clients/client-athena/commands/CreateDataCatalogCommand.ts +++ b/clients/client-athena/commands/CreateDataCatalogCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDataCatalogCommandInput = CreateDataCatalogInput; export type CreateDataCatalogCommandOutput = CreateDataCatalogOutput & __MetadataBearer; +/** + *

Creates (registers) a data catalog with the specified name and properties. Catalogs + * created are visible to all users of the same AWS account.

+ */ export class CreateDataCatalogCommand extends $Command< CreateDataCatalogCommandInput, CreateDataCatalogCommandOutput, @@ -34,6 +38,9 @@ export class CreateDataCatalogCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/CreateNamedQueryCommand.ts b/clients/client-athena/commands/CreateNamedQueryCommand.ts index 43a7f92faf648..4950f28cd510c 100644 --- a/clients/client-athena/commands/CreateNamedQueryCommand.ts +++ b/clients/client-athena/commands/CreateNamedQueryCommand.ts @@ -20,6 +20,12 @@ import { export type CreateNamedQueryCommandInput = CreateNamedQueryInput; export type CreateNamedQueryCommandOutput = CreateNamedQueryOutput & __MetadataBearer; +/** + *

Creates a named query in the specified workgroup. Requires that you have access to the + * workgroup.

+ *

For code samples using the AWS SDK for Java, see Examples and + * Code Samples in the Amazon Athena User Guide.

+ */ export class CreateNamedQueryCommand extends $Command< CreateNamedQueryCommandInput, CreateNamedQueryCommandOutput, @@ -34,6 +40,9 @@ export class CreateNamedQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/CreateWorkGroupCommand.ts b/clients/client-athena/commands/CreateWorkGroupCommand.ts index 6b6b5284388f2..3a3f979ea4ca1 100644 --- a/clients/client-athena/commands/CreateWorkGroupCommand.ts +++ b/clients/client-athena/commands/CreateWorkGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateWorkGroupCommandInput = CreateWorkGroupInput; export type CreateWorkGroupCommandOutput = CreateWorkGroupOutput & __MetadataBearer; +/** + *

Creates a workgroup with the specified name.

+ */ export class CreateWorkGroupCommand extends $Command< CreateWorkGroupCommandInput, CreateWorkGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateWorkGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/DeleteDataCatalogCommand.ts b/clients/client-athena/commands/DeleteDataCatalogCommand.ts index 33861447f6799..923b3c20b84c5 100644 --- a/clients/client-athena/commands/DeleteDataCatalogCommand.ts +++ b/clients/client-athena/commands/DeleteDataCatalogCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDataCatalogCommandInput = DeleteDataCatalogInput; export type DeleteDataCatalogCommandOutput = DeleteDataCatalogOutput & __MetadataBearer; +/** + *

Deletes a data catalog.

+ */ export class DeleteDataCatalogCommand extends $Command< DeleteDataCatalogCommandInput, DeleteDataCatalogCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDataCatalogCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/DeleteNamedQueryCommand.ts b/clients/client-athena/commands/DeleteNamedQueryCommand.ts index de5286219ebdd..26c9b6530f201 100644 --- a/clients/client-athena/commands/DeleteNamedQueryCommand.ts +++ b/clients/client-athena/commands/DeleteNamedQueryCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteNamedQueryCommandInput = DeleteNamedQueryInput; export type DeleteNamedQueryCommandOutput = DeleteNamedQueryOutput & __MetadataBearer; +/** + *

Deletes the named query if you have access to the workgroup in which the query was + * saved.

+ *

For code samples using the AWS SDK for Java, see Examples and + * Code Samples in the Amazon Athena User Guide.

+ */ export class DeleteNamedQueryCommand extends $Command< DeleteNamedQueryCommandInput, DeleteNamedQueryCommandOutput, @@ -34,6 +40,9 @@ export class DeleteNamedQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/DeleteWorkGroupCommand.ts b/clients/client-athena/commands/DeleteWorkGroupCommand.ts index 31cb695312405..cfdbd5175c2d9 100644 --- a/clients/client-athena/commands/DeleteWorkGroupCommand.ts +++ b/clients/client-athena/commands/DeleteWorkGroupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteWorkGroupCommandInput = DeleteWorkGroupInput; export type DeleteWorkGroupCommandOutput = DeleteWorkGroupOutput & __MetadataBearer; +/** + *

Deletes the workgroup with the specified name. The primary workgroup cannot be + * deleted.

+ */ export class DeleteWorkGroupCommand extends $Command< DeleteWorkGroupCommandInput, DeleteWorkGroupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteWorkGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/GetDataCatalogCommand.ts b/clients/client-athena/commands/GetDataCatalogCommand.ts index a3c60b8e5287f..34b372cb28953 100644 --- a/clients/client-athena/commands/GetDataCatalogCommand.ts +++ b/clients/client-athena/commands/GetDataCatalogCommand.ts @@ -20,6 +20,9 @@ import { export type GetDataCatalogCommandInput = GetDataCatalogInput; export type GetDataCatalogCommandOutput = GetDataCatalogOutput & __MetadataBearer; +/** + *

Returns the specified data catalog.

+ */ export class GetDataCatalogCommand extends $Command< GetDataCatalogCommandInput, GetDataCatalogCommandOutput, @@ -34,6 +37,9 @@ export class GetDataCatalogCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/GetDatabaseCommand.ts b/clients/client-athena/commands/GetDatabaseCommand.ts index 6dcb782226473..03f5778796879 100644 --- a/clients/client-athena/commands/GetDatabaseCommand.ts +++ b/clients/client-athena/commands/GetDatabaseCommand.ts @@ -20,6 +20,9 @@ import { export type GetDatabaseCommandInput = GetDatabaseInput; export type GetDatabaseCommandOutput = GetDatabaseOutput & __MetadataBearer; +/** + *

Returns a database object for the specfied database and data catalog.

+ */ export class GetDatabaseCommand extends $Command< GetDatabaseCommandInput, GetDatabaseCommandOutput, @@ -34,6 +37,9 @@ export class GetDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/GetNamedQueryCommand.ts b/clients/client-athena/commands/GetNamedQueryCommand.ts index 3cef9e97a590b..4fe83ab53207c 100644 --- a/clients/client-athena/commands/GetNamedQueryCommand.ts +++ b/clients/client-athena/commands/GetNamedQueryCommand.ts @@ -20,6 +20,10 @@ import { export type GetNamedQueryCommandInput = GetNamedQueryInput; export type GetNamedQueryCommandOutput = GetNamedQueryOutput & __MetadataBearer; +/** + *

Returns information about a single query. Requires that you have access to the + * workgroup in which the query was saved.

+ */ export class GetNamedQueryCommand extends $Command< GetNamedQueryCommandInput, GetNamedQueryCommandOutput, @@ -34,6 +38,9 @@ export class GetNamedQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/GetQueryExecutionCommand.ts b/clients/client-athena/commands/GetQueryExecutionCommand.ts index 9bb7b6143ea67..fab3bbad74d07 100644 --- a/clients/client-athena/commands/GetQueryExecutionCommand.ts +++ b/clients/client-athena/commands/GetQueryExecutionCommand.ts @@ -20,6 +20,11 @@ import { export type GetQueryExecutionCommandInput = GetQueryExecutionInput; export type GetQueryExecutionCommandOutput = GetQueryExecutionOutput & __MetadataBearer; +/** + *

Returns information about a single execution of a query if you have access to the + * workgroup in which the query ran. Each time a query executes, information about the + * query execution is saved with a unique ID.

+ */ export class GetQueryExecutionCommand extends $Command< GetQueryExecutionCommandInput, GetQueryExecutionCommandOutput, @@ -34,6 +39,9 @@ export class GetQueryExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/GetQueryResultsCommand.ts b/clients/client-athena/commands/GetQueryResultsCommand.ts index 5abbdb091865a..616036a68dd1a 100644 --- a/clients/client-athena/commands/GetQueryResultsCommand.ts +++ b/clients/client-athena/commands/GetQueryResultsCommand.ts @@ -20,6 +20,23 @@ import { export type GetQueryResultsCommandInput = GetQueryResultsInput; export type GetQueryResultsCommandOutput = GetQueryResultsOutput & __MetadataBearer; +/** + *

Streams the results of a single query execution specified by + * QueryExecutionId from the Athena query results location in Amazon S3. + * For more information, see Query Results in the Amazon + * Athena User Guide. This request does not execute the query but returns + * results. Use StartQueryExecution to run a query.

+ *

To stream query results successfully, the IAM principal with permission to call + * GetQueryResults also must have permissions to the Amazon S3 + * GetObject action for the Athena query results location.

+ * + *

IAM principals with permission to the Amazon S3 GetObject action for + * the query results location are able to retrieve query results from Amazon S3 even if + * permission to the GetQueryResults action is denied. To restrict user or + * role access, ensure that Amazon S3 permissions to the Athena query location are + * denied.

+ *
+ */ export class GetQueryResultsCommand extends $Command< GetQueryResultsCommandInput, GetQueryResultsCommandOutput, @@ -34,6 +51,9 @@ export class GetQueryResultsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/GetTableMetadataCommand.ts b/clients/client-athena/commands/GetTableMetadataCommand.ts index 027d557a6ad36..a3d77b1bad202 100644 --- a/clients/client-athena/commands/GetTableMetadataCommand.ts +++ b/clients/client-athena/commands/GetTableMetadataCommand.ts @@ -20,6 +20,9 @@ import { export type GetTableMetadataCommandInput = GetTableMetadataInput; export type GetTableMetadataCommandOutput = GetTableMetadataOutput & __MetadataBearer; +/** + *

Returns table metadata for the specified catalog, database, and table.

+ */ export class GetTableMetadataCommand extends $Command< GetTableMetadataCommandInput, GetTableMetadataCommandOutput, @@ -34,6 +37,9 @@ export class GetTableMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/GetWorkGroupCommand.ts b/clients/client-athena/commands/GetWorkGroupCommand.ts index 6b4cc4a0969ec..b420386ba1ab9 100644 --- a/clients/client-athena/commands/GetWorkGroupCommand.ts +++ b/clients/client-athena/commands/GetWorkGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetWorkGroupCommandInput = GetWorkGroupInput; export type GetWorkGroupCommandOutput = GetWorkGroupOutput & __MetadataBearer; +/** + *

Returns information about the workgroup with the specified name.

+ */ export class GetWorkGroupCommand extends $Command< GetWorkGroupCommandInput, GetWorkGroupCommandOutput, @@ -34,6 +37,9 @@ export class GetWorkGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/ListDataCatalogsCommand.ts b/clients/client-athena/commands/ListDataCatalogsCommand.ts index d41ef1fb44d84..eb422deaa0d5a 100644 --- a/clients/client-athena/commands/ListDataCatalogsCommand.ts +++ b/clients/client-athena/commands/ListDataCatalogsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDataCatalogsCommandInput = ListDataCatalogsInput; export type ListDataCatalogsCommandOutput = ListDataCatalogsOutput & __MetadataBearer; +/** + *

Lists the data catalogs in the current AWS account.

+ */ export class ListDataCatalogsCommand extends $Command< ListDataCatalogsCommandInput, ListDataCatalogsCommandOutput, @@ -34,6 +37,9 @@ export class ListDataCatalogsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/ListDatabasesCommand.ts b/clients/client-athena/commands/ListDatabasesCommand.ts index aeb34244b8687..01048436ceab3 100644 --- a/clients/client-athena/commands/ListDatabasesCommand.ts +++ b/clients/client-athena/commands/ListDatabasesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDatabasesCommandInput = ListDatabasesInput; export type ListDatabasesCommandOutput = ListDatabasesOutput & __MetadataBearer; +/** + *

Lists the databases in the specified data catalog.

+ */ export class ListDatabasesCommand extends $Command< ListDatabasesCommandInput, ListDatabasesCommandOutput, @@ -34,6 +37,9 @@ export class ListDatabasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/ListNamedQueriesCommand.ts b/clients/client-athena/commands/ListNamedQueriesCommand.ts index 11a78ca80b3dd..ac3568eda9bc5 100644 --- a/clients/client-athena/commands/ListNamedQueriesCommand.ts +++ b/clients/client-athena/commands/ListNamedQueriesCommand.ts @@ -20,6 +20,13 @@ import { export type ListNamedQueriesCommandInput = ListNamedQueriesInput; export type ListNamedQueriesCommandOutput = ListNamedQueriesOutput & __MetadataBearer; +/** + *

Provides a list of available query IDs only for queries saved in the specified + * workgroup. Requires that you have access to the specified workgroup. If a workgroup is + * not specified, lists the saved queries for the primary workgroup.

+ *

For code samples using the AWS SDK for Java, see Examples and + * Code Samples in the Amazon Athena User Guide.

+ */ export class ListNamedQueriesCommand extends $Command< ListNamedQueriesCommandInput, ListNamedQueriesCommandOutput, @@ -34,6 +41,9 @@ export class ListNamedQueriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/ListQueryExecutionsCommand.ts b/clients/client-athena/commands/ListQueryExecutionsCommand.ts index d875552f625bc..b4ae3ee42add6 100644 --- a/clients/client-athena/commands/ListQueryExecutionsCommand.ts +++ b/clients/client-athena/commands/ListQueryExecutionsCommand.ts @@ -20,6 +20,14 @@ import { export type ListQueryExecutionsCommandInput = ListQueryExecutionsInput; export type ListQueryExecutionsCommandOutput = ListQueryExecutionsOutput & __MetadataBearer; +/** + *

Provides a list of available query execution IDs for the queries in the specified + * workgroup. If a workgroup is not specified, returns a list of query execution IDs for + * the primary workgroup. Requires you to have access to the workgroup in which the queries + * ran.

+ *

For code samples using the AWS SDK for Java, see Examples and + * Code Samples in the Amazon Athena User Guide.

+ */ export class ListQueryExecutionsCommand extends $Command< ListQueryExecutionsCommandInput, ListQueryExecutionsCommandOutput, @@ -34,6 +42,9 @@ export class ListQueryExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/ListTableMetadataCommand.ts b/clients/client-athena/commands/ListTableMetadataCommand.ts index 9ddf06f986157..9f8f3bbacb476 100644 --- a/clients/client-athena/commands/ListTableMetadataCommand.ts +++ b/clients/client-athena/commands/ListTableMetadataCommand.ts @@ -20,6 +20,9 @@ import { export type ListTableMetadataCommandInput = ListTableMetadataInput; export type ListTableMetadataCommandOutput = ListTableMetadataOutput & __MetadataBearer; +/** + *

Lists the metadata for the tables in the specified data catalog database.

+ */ export class ListTableMetadataCommand extends $Command< ListTableMetadataCommandInput, ListTableMetadataCommandOutput, @@ -34,6 +37,9 @@ export class ListTableMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/ListTagsForResourceCommand.ts b/clients/client-athena/commands/ListTagsForResourceCommand.ts index f989e405513fb..eadddaca86d27 100644 --- a/clients/client-athena/commands/ListTagsForResourceCommand.ts +++ b/clients/client-athena/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Lists the tags associated with an Athena workgroup or data catalog resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/ListWorkGroupsCommand.ts b/clients/client-athena/commands/ListWorkGroupsCommand.ts index 8965477702251..935230fdbbed5 100644 --- a/clients/client-athena/commands/ListWorkGroupsCommand.ts +++ b/clients/client-athena/commands/ListWorkGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListWorkGroupsCommandInput = ListWorkGroupsInput; export type ListWorkGroupsCommandOutput = ListWorkGroupsOutput & __MetadataBearer; +/** + *

Lists available workgroups for the account.

+ */ export class ListWorkGroupsCommand extends $Command< ListWorkGroupsCommandInput, ListWorkGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListWorkGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/StartQueryExecutionCommand.ts b/clients/client-athena/commands/StartQueryExecutionCommand.ts index bc8639817d0ea..bc126c4c9107e 100644 --- a/clients/client-athena/commands/StartQueryExecutionCommand.ts +++ b/clients/client-athena/commands/StartQueryExecutionCommand.ts @@ -20,6 +20,13 @@ import { export type StartQueryExecutionCommandInput = StartQueryExecutionInput; export type StartQueryExecutionCommandOutput = StartQueryExecutionOutput & __MetadataBearer; +/** + *

Runs the SQL query statements contained in the Query. Requires you to + * have access to the workgroup in which the query ran. Running queries against an external + * catalog requires GetDataCatalog permission to the catalog. For code + * samples using the AWS SDK for Java, see Examples and + * Code Samples in the Amazon Athena User Guide.

+ */ export class StartQueryExecutionCommand extends $Command< StartQueryExecutionCommandInput, StartQueryExecutionCommandOutput, @@ -34,6 +41,9 @@ export class StartQueryExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/StopQueryExecutionCommand.ts b/clients/client-athena/commands/StopQueryExecutionCommand.ts index 51eb41678b7a8..822afae0815c2 100644 --- a/clients/client-athena/commands/StopQueryExecutionCommand.ts +++ b/clients/client-athena/commands/StopQueryExecutionCommand.ts @@ -20,6 +20,12 @@ import { export type StopQueryExecutionCommandInput = StopQueryExecutionInput; export type StopQueryExecutionCommandOutput = StopQueryExecutionOutput & __MetadataBearer; +/** + *

Stops a query execution. Requires you to have access to the workgroup in which the + * query ran.

+ *

For code samples using the AWS SDK for Java, see Examples and + * Code Samples in the Amazon Athena User Guide.

+ */ export class StopQueryExecutionCommand extends $Command< StopQueryExecutionCommandInput, StopQueryExecutionCommandOutput, @@ -34,6 +40,9 @@ export class StopQueryExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/TagResourceCommand.ts b/clients/client-athena/commands/TagResourceCommand.ts index 24d8d2f7f2902..6b828941ab9d2 100644 --- a/clients/client-athena/commands/TagResourceCommand.ts +++ b/clients/client-athena/commands/TagResourceCommand.ts @@ -20,6 +20,18 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

Adds one or more tags to an Athena resource. A tag is a label that you assign to a + * resource. In Athena, a resource can be a workgroup or data catalog. Each tag consists of + * a key and an optional value, both of which you define. For example, you can use tags to + * categorize Athena workgroups or data catalogs by purpose, owner, or environment. Use a + * consistent set of tag keys to make it easier to search and filter workgroups or data + * catalogs in your account. For best practices, see Tagging Best Practices. Tag keys can be from 1 to 128 UTF-8 Unicode + * characters, and tag values can be from 0 to 256 UTF-8 Unicode characters. Tags can use + * letters and numbers representable in UTF-8, and the following characters: + - = . _ : / + * @. Tag keys and values are case-sensitive. Tag keys must be unique per resource. If you + * specify more than one tag, separate them by commas.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +46,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/UntagResourceCommand.ts b/clients/client-athena/commands/UntagResourceCommand.ts index 944e81dd93802..28b01da07a697 100644 --- a/clients/client-athena/commands/UntagResourceCommand.ts +++ b/clients/client-athena/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Removes one or more tags from a data catalog or workgroup resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/UpdateDataCatalogCommand.ts b/clients/client-athena/commands/UpdateDataCatalogCommand.ts index 744bf57bd7947..c5a9e41f60413 100644 --- a/clients/client-athena/commands/UpdateDataCatalogCommand.ts +++ b/clients/client-athena/commands/UpdateDataCatalogCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDataCatalogCommandInput = UpdateDataCatalogInput; export type UpdateDataCatalogCommandOutput = UpdateDataCatalogOutput & __MetadataBearer; +/** + *

Updates the data catalog that has the specified name.

+ */ export class UpdateDataCatalogCommand extends $Command< UpdateDataCatalogCommandInput, UpdateDataCatalogCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDataCatalogCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/commands/UpdateWorkGroupCommand.ts b/clients/client-athena/commands/UpdateWorkGroupCommand.ts index 061d1bfe5602e..d7ac776308339 100644 --- a/clients/client-athena/commands/UpdateWorkGroupCommand.ts +++ b/clients/client-athena/commands/UpdateWorkGroupCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateWorkGroupCommandInput = UpdateWorkGroupInput; export type UpdateWorkGroupCommandOutput = UpdateWorkGroupOutput & __MetadataBearer; +/** + *

Updates the workgroup with the specified name. The workgroup's name cannot be + * changed.

+ */ export class UpdateWorkGroupCommand extends $Command< UpdateWorkGroupCommandInput, UpdateWorkGroupCommandOutput, @@ -34,6 +38,9 @@ export class UpdateWorkGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AthenaClientResolvedConfig, diff --git a/clients/client-athena/package.json b/clients/client-athena/package.json index 3190b0fc7eeae..27f66ac20ff98 100644 --- a/clients/client-athena/package.json +++ b/clients/client-athena/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Athena Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-athena/pagination/GetQueryResultsPaginator.ts b/clients/client-athena/pagination/GetQueryResultsPaginator.ts index f541fc71717e0..1cfedd1600170 100644 --- a/clients/client-athena/pagination/GetQueryResultsPaginator.ts +++ b/clients/client-athena/pagination/GetQueryResultsPaginator.ts @@ -8,6 +8,9 @@ import { import { AthenaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AthenaClient, input: GetQueryResultsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetQueryResultsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Athena, input: GetQueryResultsCommandInput, diff --git a/clients/client-athena/pagination/ListDataCatalogsPaginator.ts b/clients/client-athena/pagination/ListDataCatalogsPaginator.ts index cb59c38e32eb0..817ca3238ad55 100644 --- a/clients/client-athena/pagination/ListDataCatalogsPaginator.ts +++ b/clients/client-athena/pagination/ListDataCatalogsPaginator.ts @@ -8,6 +8,9 @@ import { import { AthenaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AthenaClient, input: ListDataCatalogsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDataCatalogsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Athena, input: ListDataCatalogsCommandInput, diff --git a/clients/client-athena/pagination/ListDatabasesPaginator.ts b/clients/client-athena/pagination/ListDatabasesPaginator.ts index 5da42e4076b23..afd08829957ac 100644 --- a/clients/client-athena/pagination/ListDatabasesPaginator.ts +++ b/clients/client-athena/pagination/ListDatabasesPaginator.ts @@ -8,6 +8,9 @@ import { import { AthenaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AthenaClient, input: ListDatabasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatabasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Athena, input: ListDatabasesCommandInput, diff --git a/clients/client-athena/pagination/ListNamedQueriesPaginator.ts b/clients/client-athena/pagination/ListNamedQueriesPaginator.ts index bd6a08440348d..bfbae630d3cf9 100644 --- a/clients/client-athena/pagination/ListNamedQueriesPaginator.ts +++ b/clients/client-athena/pagination/ListNamedQueriesPaginator.ts @@ -8,6 +8,9 @@ import { import { AthenaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AthenaClient, input: ListNamedQueriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNamedQueriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Athena, input: ListNamedQueriesCommandInput, diff --git a/clients/client-athena/pagination/ListQueryExecutionsPaginator.ts b/clients/client-athena/pagination/ListQueryExecutionsPaginator.ts index 3f9d066238b1e..8667f62b5c529 100644 --- a/clients/client-athena/pagination/ListQueryExecutionsPaginator.ts +++ b/clients/client-athena/pagination/ListQueryExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { AthenaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AthenaClient, input: ListQueryExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListQueryExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Athena, input: ListQueryExecutionsCommandInput, diff --git a/clients/client-athena/pagination/ListTableMetadataPaginator.ts b/clients/client-athena/pagination/ListTableMetadataPaginator.ts index 9f428f4fe1893..4777ec2a56763 100644 --- a/clients/client-athena/pagination/ListTableMetadataPaginator.ts +++ b/clients/client-athena/pagination/ListTableMetadataPaginator.ts @@ -8,6 +8,9 @@ import { import { AthenaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AthenaClient, input: ListTableMetadataCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTableMetadataCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Athena, input: ListTableMetadataCommandInput, diff --git a/clients/client-athena/pagination/ListTagsForResourcePaginator.ts b/clients/client-athena/pagination/ListTagsForResourcePaginator.ts index e8f3266290b3b..458abd9d1ee8b 100644 --- a/clients/client-athena/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-athena/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { AthenaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AthenaClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Athena, input: ListTagsForResourceCommandInput, diff --git a/clients/client-athena/pagination/ListWorkGroupsPaginator.ts b/clients/client-athena/pagination/ListWorkGroupsPaginator.ts index 48fe424421356..33239fa37450d 100644 --- a/clients/client-athena/pagination/ListWorkGroupsPaginator.ts +++ b/clients/client-athena/pagination/ListWorkGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { AthenaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AthenaClient, input: ListWorkGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorkGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Athena, input: ListWorkGroupsCommandInput, diff --git a/clients/client-athena/runtimeConfig.browser.ts b/clients/client-athena/runtimeConfig.browser.ts index 2d324bc5bb6be..d9d5632257f85 100644 --- a/clients/client-athena/runtimeConfig.browser.ts +++ b/clients/client-athena/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AthenaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-athena/runtimeConfig.native.ts b/clients/client-athena/runtimeConfig.native.ts index 0be48c8e4a1e8..57a7464b2c07f 100644 --- a/clients/client-athena/runtimeConfig.native.ts +++ b/clients/client-athena/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AthenaClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-athena/runtimeConfig.shared.ts b/clients/client-athena/runtimeConfig.shared.ts index 67038cbaf7585..a7725c1354202 100644 --- a/clients/client-athena/runtimeConfig.shared.ts +++ b/clients/client-athena/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-05-18", disableHostPrefix: false, diff --git a/clients/client-athena/runtimeConfig.ts b/clients/client-athena/runtimeConfig.ts index 11bce7f4001e6..2970ab64cd811 100644 --- a/clients/client-athena/runtimeConfig.ts +++ b/clients/client-athena/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AthenaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-athena/tsconfig.json b/clients/client-athena/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-athena/tsconfig.json +++ b/clients/client-athena/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-auto-scaling-plans/commands/CreateScalingPlanCommand.ts b/clients/client-auto-scaling-plans/commands/CreateScalingPlanCommand.ts index 72192f48ce548..a3573e738fcff 100644 --- a/clients/client-auto-scaling-plans/commands/CreateScalingPlanCommand.ts +++ b/clients/client-auto-scaling-plans/commands/CreateScalingPlanCommand.ts @@ -20,6 +20,9 @@ import { export type CreateScalingPlanCommandInput = CreateScalingPlanRequest; export type CreateScalingPlanCommandOutput = CreateScalingPlanResponse & __MetadataBearer; +/** + *

Creates a scaling plan.

+ */ export class CreateScalingPlanCommand extends $Command< CreateScalingPlanCommandInput, CreateScalingPlanCommandOutput, @@ -34,6 +37,9 @@ export class CreateScalingPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingPlansClientResolvedConfig, diff --git a/clients/client-auto-scaling-plans/commands/DeleteScalingPlanCommand.ts b/clients/client-auto-scaling-plans/commands/DeleteScalingPlanCommand.ts index e3cc181d4095c..5e9620ad615c4 100644 --- a/clients/client-auto-scaling-plans/commands/DeleteScalingPlanCommand.ts +++ b/clients/client-auto-scaling-plans/commands/DeleteScalingPlanCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteScalingPlanCommandInput = DeleteScalingPlanRequest; export type DeleteScalingPlanCommandOutput = DeleteScalingPlanResponse & __MetadataBearer; +/** + *

Deletes the specified scaling plan.

+ *

Deleting a scaling plan deletes the underlying ScalingInstruction for + * all of the scalable resources that are covered by the plan.

+ *

If the plan has launched resources or has scaling activities in progress, you must + * delete those resources separately.

+ */ export class DeleteScalingPlanCommand extends $Command< DeleteScalingPlanCommandInput, DeleteScalingPlanCommandOutput, @@ -34,6 +41,9 @@ export class DeleteScalingPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingPlansClientResolvedConfig, diff --git a/clients/client-auto-scaling-plans/commands/DescribeScalingPlanResourcesCommand.ts b/clients/client-auto-scaling-plans/commands/DescribeScalingPlanResourcesCommand.ts index 58a217ca9dec2..dd6f7ac8cd5ce 100644 --- a/clients/client-auto-scaling-plans/commands/DescribeScalingPlanResourcesCommand.ts +++ b/clients/client-auto-scaling-plans/commands/DescribeScalingPlanResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeScalingPlanResourcesCommandInput = DescribeScalingPlanResourcesRequest; export type DescribeScalingPlanResourcesCommandOutput = DescribeScalingPlanResourcesResponse & __MetadataBearer; +/** + *

Describes the scalable resources in the specified scaling plan.

+ */ export class DescribeScalingPlanResourcesCommand extends $Command< DescribeScalingPlanResourcesCommandInput, DescribeScalingPlanResourcesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeScalingPlanResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingPlansClientResolvedConfig, diff --git a/clients/client-auto-scaling-plans/commands/DescribeScalingPlansCommand.ts b/clients/client-auto-scaling-plans/commands/DescribeScalingPlansCommand.ts index 2b7046b53bee1..1d89d7cca06c6 100644 --- a/clients/client-auto-scaling-plans/commands/DescribeScalingPlansCommand.ts +++ b/clients/client-auto-scaling-plans/commands/DescribeScalingPlansCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeScalingPlansCommandInput = DescribeScalingPlansRequest; export type DescribeScalingPlansCommandOutput = DescribeScalingPlansResponse & __MetadataBearer; +/** + *

Describes one or more of your scaling plans.

+ */ export class DescribeScalingPlansCommand extends $Command< DescribeScalingPlansCommandInput, DescribeScalingPlansCommandOutput, @@ -34,6 +37,9 @@ export class DescribeScalingPlansCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingPlansClientResolvedConfig, diff --git a/clients/client-auto-scaling-plans/commands/GetScalingPlanResourceForecastDataCommand.ts b/clients/client-auto-scaling-plans/commands/GetScalingPlanResourceForecastDataCommand.ts index 7f9523edb79d3..9ddcb3efe9f33 100644 --- a/clients/client-auto-scaling-plans/commands/GetScalingPlanResourceForecastDataCommand.ts +++ b/clients/client-auto-scaling-plans/commands/GetScalingPlanResourceForecastDataCommand.ts @@ -24,6 +24,14 @@ export type GetScalingPlanResourceForecastDataCommandInput = GetScalingPlanResou export type GetScalingPlanResourceForecastDataCommandOutput = GetScalingPlanResourceForecastDataResponse & __MetadataBearer; +/** + *

Retrieves the forecast data for a scalable resource.

+ *

Capacity forecasts are represented as predicted values, or data points, that are + * calculated using historical data points from a specified CloudWatch load metric. Data points are + * available for up to 56 days. + * + *

+ */ export class GetScalingPlanResourceForecastDataCommand extends $Command< GetScalingPlanResourceForecastDataCommandInput, GetScalingPlanResourceForecastDataCommandOutput, @@ -38,6 +46,9 @@ export class GetScalingPlanResourceForecastDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingPlansClientResolvedConfig, diff --git a/clients/client-auto-scaling-plans/commands/UpdateScalingPlanCommand.ts b/clients/client-auto-scaling-plans/commands/UpdateScalingPlanCommand.ts index 33ab5f00748d2..d3324c3943291 100644 --- a/clients/client-auto-scaling-plans/commands/UpdateScalingPlanCommand.ts +++ b/clients/client-auto-scaling-plans/commands/UpdateScalingPlanCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateScalingPlanCommandInput = UpdateScalingPlanRequest; export type UpdateScalingPlanCommandOutput = UpdateScalingPlanResponse & __MetadataBearer; +/** + *

Updates the specified scaling plan.

+ *

You cannot update a scaling plan if it is in the process of being created, updated, or + * deleted.

+ */ export class UpdateScalingPlanCommand extends $Command< UpdateScalingPlanCommandInput, UpdateScalingPlanCommandOutput, @@ -34,6 +39,9 @@ export class UpdateScalingPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingPlansClientResolvedConfig, diff --git a/clients/client-auto-scaling-plans/package.json b/clients/client-auto-scaling-plans/package.json index 8fec033c2db0e..cecefa4bdc062 100644 --- a/clients/client-auto-scaling-plans/package.json +++ b/clients/client-auto-scaling-plans/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Auto Scaling Plans Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-auto-scaling-plans/runtimeConfig.browser.ts b/clients/client-auto-scaling-plans/runtimeConfig.browser.ts index f84a951ba0c13..bfcbf2cbe6276 100644 --- a/clients/client-auto-scaling-plans/runtimeConfig.browser.ts +++ b/clients/client-auto-scaling-plans/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AutoScalingPlansClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-auto-scaling-plans/runtimeConfig.native.ts b/clients/client-auto-scaling-plans/runtimeConfig.native.ts index 31b98abe3e9fb..ec8c0f0136d32 100644 --- a/clients/client-auto-scaling-plans/runtimeConfig.native.ts +++ b/clients/client-auto-scaling-plans/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AutoScalingPlansClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-auto-scaling-plans/runtimeConfig.shared.ts b/clients/client-auto-scaling-plans/runtimeConfig.shared.ts index 6fe0c0c14da12..4d4ddc6098f62 100644 --- a/clients/client-auto-scaling-plans/runtimeConfig.shared.ts +++ b/clients/client-auto-scaling-plans/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-01-06", disableHostPrefix: false, diff --git a/clients/client-auto-scaling-plans/runtimeConfig.ts b/clients/client-auto-scaling-plans/runtimeConfig.ts index 79f5d4f0e2b5f..7d1e7564adeb6 100644 --- a/clients/client-auto-scaling-plans/runtimeConfig.ts +++ b/clients/client-auto-scaling-plans/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AutoScalingPlansClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-auto-scaling-plans/tsconfig.json b/clients/client-auto-scaling-plans/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-auto-scaling-plans/tsconfig.json +++ b/clients/client-auto-scaling-plans/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-auto-scaling/commands/AttachInstancesCommand.ts b/clients/client-auto-scaling/commands/AttachInstancesCommand.ts index 2048552b8cf8d..612e12d372704 100644 --- a/clients/client-auto-scaling/commands/AttachInstancesCommand.ts +++ b/clients/client-auto-scaling/commands/AttachInstancesCommand.ts @@ -20,6 +20,18 @@ import { export type AttachInstancesCommandInput = AttachInstancesQuery; export type AttachInstancesCommandOutput = __MetadataBearer; +/** + *

Attaches one or more EC2 instances to the specified Auto Scaling group.

+ *

When you attach instances, Amazon EC2 Auto Scaling increases the desired capacity of the group by the + * number of instances being attached. If the number of instances being attached plus the + * desired capacity of the group exceeds the maximum size of the group, the operation + * fails.

+ *

If there is a Classic Load Balancer attached to your Auto Scaling group, the instances are + * also registered with the load balancer. If there are target groups attached to your Auto Scaling + * group, the instances are also registered with the target groups.

+ *

For more information, see Attach EC2 instances to + * your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.

+ */ export class AttachInstancesCommand extends $Command< AttachInstancesCommandInput, AttachInstancesCommandOutput, @@ -34,6 +46,9 @@ export class AttachInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/AttachLoadBalancerTargetGroupsCommand.ts b/clients/client-auto-scaling/commands/AttachLoadBalancerTargetGroupsCommand.ts index 27ba14db1ac93..51ad86ec12dae 100644 --- a/clients/client-auto-scaling/commands/AttachLoadBalancerTargetGroupsCommand.ts +++ b/clients/client-auto-scaling/commands/AttachLoadBalancerTargetGroupsCommand.ts @@ -20,6 +20,16 @@ import { export type AttachLoadBalancerTargetGroupsCommandInput = AttachLoadBalancerTargetGroupsType; export type AttachLoadBalancerTargetGroupsCommandOutput = AttachLoadBalancerTargetGroupsResultType & __MetadataBearer; +/** + *

Attaches one or more target groups to the specified Auto Scaling group.

+ *

To describe the target groups for an Auto Scaling group, call the DescribeLoadBalancerTargetGroups API. To detach the target group from + * the Auto Scaling group, call the DetachLoadBalancerTargetGroups API.

+ *

With Application Load Balancers and Network Load Balancers, instances are registered + * as targets with a target group. With Classic Load Balancers, instances are registered + * with the load balancer. For more information, see Attaching a load + * balancer to your Auto Scaling group in the + * Amazon EC2 Auto Scaling User Guide.

+ */ export class AttachLoadBalancerTargetGroupsCommand extends $Command< AttachLoadBalancerTargetGroupsCommandInput, AttachLoadBalancerTargetGroupsCommandOutput, @@ -34,6 +44,9 @@ export class AttachLoadBalancerTargetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/AttachLoadBalancersCommand.ts b/clients/client-auto-scaling/commands/AttachLoadBalancersCommand.ts index bbc93f2699a06..99fe89fa1fda0 100644 --- a/clients/client-auto-scaling/commands/AttachLoadBalancersCommand.ts +++ b/clients/client-auto-scaling/commands/AttachLoadBalancersCommand.ts @@ -20,6 +20,18 @@ import { export type AttachLoadBalancersCommandInput = AttachLoadBalancersType; export type AttachLoadBalancersCommandOutput = AttachLoadBalancersResultType & __MetadataBearer; +/** + * + *

To attach an Application Load Balancer or a Network Load Balancer, use the AttachLoadBalancerTargetGroups API operation instead.

+ *
+ *

Attaches one or more Classic Load Balancers to the specified Auto Scaling group. Amazon EC2 Auto Scaling + * registers the running instances with these Classic Load Balancers.

+ *

To describe the load balancers for an Auto Scaling group, call the DescribeLoadBalancers API. To detach the load balancer from the Auto Scaling + * group, call the DetachLoadBalancers API.

+ *

For more information, see Attaching a load + * balancer to your Auto Scaling group in the + * Amazon EC2 Auto Scaling User Guide.

+ */ export class AttachLoadBalancersCommand extends $Command< AttachLoadBalancersCommandInput, AttachLoadBalancersCommandOutput, @@ -34,6 +46,9 @@ export class AttachLoadBalancersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/BatchDeleteScheduledActionCommand.ts b/clients/client-auto-scaling/commands/BatchDeleteScheduledActionCommand.ts index 3d4b4a4214eb4..d7efb643158c2 100644 --- a/clients/client-auto-scaling/commands/BatchDeleteScheduledActionCommand.ts +++ b/clients/client-auto-scaling/commands/BatchDeleteScheduledActionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeleteScheduledActionCommandInput = BatchDeleteScheduledActionType; export type BatchDeleteScheduledActionCommandOutput = BatchDeleteScheduledActionAnswer & __MetadataBearer; +/** + *

Deletes one or more scheduled actions for the specified Auto Scaling group.

+ */ export class BatchDeleteScheduledActionCommand extends $Command< BatchDeleteScheduledActionCommandInput, BatchDeleteScheduledActionCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeleteScheduledActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/BatchPutScheduledUpdateGroupActionCommand.ts b/clients/client-auto-scaling/commands/BatchPutScheduledUpdateGroupActionCommand.ts index 96a1d07b8655d..d85582ee8d911 100644 --- a/clients/client-auto-scaling/commands/BatchPutScheduledUpdateGroupActionCommand.ts +++ b/clients/client-auto-scaling/commands/BatchPutScheduledUpdateGroupActionCommand.ts @@ -21,6 +21,11 @@ export type BatchPutScheduledUpdateGroupActionCommandInput = BatchPutScheduledUp export type BatchPutScheduledUpdateGroupActionCommandOutput = BatchPutScheduledUpdateGroupActionAnswer & __MetadataBearer; +/** + *

Creates or updates one or more scheduled scaling actions for an Auto Scaling group. If you + * leave a parameter unspecified when updating a scheduled scaling action, the + * corresponding value remains unchanged.

+ */ export class BatchPutScheduledUpdateGroupActionCommand extends $Command< BatchPutScheduledUpdateGroupActionCommandInput, BatchPutScheduledUpdateGroupActionCommandOutput, @@ -35,6 +40,9 @@ export class BatchPutScheduledUpdateGroupActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/CancelInstanceRefreshCommand.ts b/clients/client-auto-scaling/commands/CancelInstanceRefreshCommand.ts index b5b893b65bc0a..b708eb5e7e042 100644 --- a/clients/client-auto-scaling/commands/CancelInstanceRefreshCommand.ts +++ b/clients/client-auto-scaling/commands/CancelInstanceRefreshCommand.ts @@ -20,6 +20,13 @@ import { export type CancelInstanceRefreshCommandInput = CancelInstanceRefreshType; export type CancelInstanceRefreshCommandOutput = CancelInstanceRefreshAnswer & __MetadataBearer; +/** + *

Cancels an instance refresh operation in progress. Cancellation does not roll back any + * replacements that have already been completed, but it prevents new replacements from + * being started.

+ *

For more information, see Replacing Auto Scaling Instances + * Based on an Instance Refresh.

+ */ export class CancelInstanceRefreshCommand extends $Command< CancelInstanceRefreshCommandInput, CancelInstanceRefreshCommandOutput, @@ -34,6 +41,9 @@ export class CancelInstanceRefreshCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/CompleteLifecycleActionCommand.ts b/clients/client-auto-scaling/commands/CompleteLifecycleActionCommand.ts index 76f2ddbf54dc5..33e84bd3a78d3 100644 --- a/clients/client-auto-scaling/commands/CompleteLifecycleActionCommand.ts +++ b/clients/client-auto-scaling/commands/CompleteLifecycleActionCommand.ts @@ -20,6 +20,40 @@ import { export type CompleteLifecycleActionCommandInput = CompleteLifecycleActionType; export type CompleteLifecycleActionCommandOutput = CompleteLifecycleActionAnswer & __MetadataBearer; +/** + *

Completes the lifecycle action for the specified token or instance with the specified + * result.

+ *

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling + * group:

+ *
    + *
  1. + *

    (Optional) Create a Lambda function and a rule that allows CloudWatch Events to + * invoke your Lambda function when Amazon EC2 Auto Scaling launches or terminates + * instances.

    + *
  2. + *
  3. + *

    (Optional) Create a notification target and an IAM role. The target can be + * either an Amazon SQS queue or an Amazon SNS topic. The role allows Amazon EC2 Auto Scaling to + * publish lifecycle notifications to the target.

    + *
  4. + *
  5. + *

    Create the lifecycle hook. Specify whether the hook is used when the instances + * launch or terminate.

    + *
  6. + *
  7. + *

    If you need more time, record the lifecycle action heartbeat to keep the + * instance in a pending state.

    + *
  8. + *
  9. + *

    + * If you finish before the timeout period ends, complete + * the lifecycle action. + *

    + *
  10. + *
+ *

For more information, see Amazon EC2 Auto Scaling lifecycle + * hooks in the Amazon EC2 Auto Scaling User Guide.

+ */ export class CompleteLifecycleActionCommand extends $Command< CompleteLifecycleActionCommandInput, CompleteLifecycleActionCommandOutput, @@ -34,6 +68,9 @@ export class CompleteLifecycleActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/CreateAutoScalingGroupCommand.ts b/clients/client-auto-scaling/commands/CreateAutoScalingGroupCommand.ts index a18cfa68d984a..bfc57e890b353 100644 --- a/clients/client-auto-scaling/commands/CreateAutoScalingGroupCommand.ts +++ b/clients/client-auto-scaling/commands/CreateAutoScalingGroupCommand.ts @@ -20,6 +20,23 @@ import { export type CreateAutoScalingGroupCommandInput = CreateAutoScalingGroupType; export type CreateAutoScalingGroupCommandOutput = __MetadataBearer; +/** + *

Creates an Auto Scaling group with the specified name and attributes.

+ *

If you exceed your maximum limit of Auto Scaling groups, the call fails. To query this limit, + * call the DescribeAccountLimits API. For information about updating + * this limit, see Amazon EC2 Auto Scaling service + * quotas in the Amazon EC2 Auto Scaling User Guide.

+ *

For introductory exercises for creating an Auto Scaling group, see Getting started with + * Amazon EC2 Auto Scaling and Tutorial: Set up a + * scaled and load-balanced application in the + * Amazon EC2 Auto Scaling User Guide. For more information, see Auto Scaling + * groups in the Amazon EC2 Auto Scaling User Guide.

+ *

Every Auto Scaling group has three size parameters (DesiredCapacity, + * MaxSize, and MinSize). Usually, you set these sizes based + * on a specific number of instances. However, if you configure a mixed instances policy + * that defines weights for the instance types, you must specify these sizes with the same + * units that you use for weighting instances.

+ */ export class CreateAutoScalingGroupCommand extends $Command< CreateAutoScalingGroupCommandInput, CreateAutoScalingGroupCommandOutput, @@ -34,6 +51,9 @@ export class CreateAutoScalingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/CreateLaunchConfigurationCommand.ts b/clients/client-auto-scaling/commands/CreateLaunchConfigurationCommand.ts index da4f38887b663..b8c97aabddc94 100644 --- a/clients/client-auto-scaling/commands/CreateLaunchConfigurationCommand.ts +++ b/clients/client-auto-scaling/commands/CreateLaunchConfigurationCommand.ts @@ -20,6 +20,15 @@ import { export type CreateLaunchConfigurationCommandInput = CreateLaunchConfigurationType; export type CreateLaunchConfigurationCommandOutput = __MetadataBearer; +/** + *

Creates a launch configuration.

+ *

If you exceed your maximum limit of launch configurations, the call fails. To query + * this limit, call the DescribeAccountLimits API. For information about + * updating this limit, see Amazon EC2 Auto Scaling service + * quotas in the Amazon EC2 Auto Scaling User Guide.

+ *

For more information, see Launch + * configurations in the Amazon EC2 Auto Scaling User Guide.

+ */ export class CreateLaunchConfigurationCommand extends $Command< CreateLaunchConfigurationCommandInput, CreateLaunchConfigurationCommandOutput, @@ -34,6 +43,9 @@ export class CreateLaunchConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/CreateOrUpdateTagsCommand.ts b/clients/client-auto-scaling/commands/CreateOrUpdateTagsCommand.ts index c813d46449a97..57de48c721f4e 100644 --- a/clients/client-auto-scaling/commands/CreateOrUpdateTagsCommand.ts +++ b/clients/client-auto-scaling/commands/CreateOrUpdateTagsCommand.ts @@ -20,6 +20,13 @@ import { export type CreateOrUpdateTagsCommandInput = CreateOrUpdateTagsType; export type CreateOrUpdateTagsCommandOutput = __MetadataBearer; +/** + *

Creates or updates tags for the specified Auto Scaling group.

+ *

When you specify a tag with a key that already exists, the operation overwrites the + * previous tag definition, and you do not get an error message.

+ *

For more information, see Tagging Auto Scaling groups and + * instances in the Amazon EC2 Auto Scaling User Guide.

+ */ export class CreateOrUpdateTagsCommand extends $Command< CreateOrUpdateTagsCommandInput, CreateOrUpdateTagsCommandOutput, @@ -34,6 +41,9 @@ export class CreateOrUpdateTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DeleteAutoScalingGroupCommand.ts b/clients/client-auto-scaling/commands/DeleteAutoScalingGroupCommand.ts index 26705e7bbc99e..59e520afc8d7e 100644 --- a/clients/client-auto-scaling/commands/DeleteAutoScalingGroupCommand.ts +++ b/clients/client-auto-scaling/commands/DeleteAutoScalingGroupCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteAutoScalingGroupCommandInput = DeleteAutoScalingGroupType; export type DeleteAutoScalingGroupCommandOutput = __MetadataBearer; +/** + *

Deletes the specified Auto Scaling group.

+ *

If the group has instances or scaling activities in progress, you must specify the + * option to force the deletion in order for it to succeed.

+ *

If the group has policies, deleting the group deletes the policies, the underlying + * alarm actions, and any alarm that no longer has an associated action.

+ *

To remove instances from the Auto Scaling group before deleting it, call the DetachInstances API with the list of instances and the option to + * decrement the desired capacity. This ensures that Amazon EC2 Auto Scaling does not launch replacement + * instances.

+ *

To terminate all instances before deleting the Auto Scaling group, call the UpdateAutoScalingGroup API and set the minimum size and desired capacity + * of the Auto Scaling group to zero.

+ */ export class DeleteAutoScalingGroupCommand extends $Command< DeleteAutoScalingGroupCommandInput, DeleteAutoScalingGroupCommandOutput, @@ -34,6 +46,9 @@ export class DeleteAutoScalingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DeleteLaunchConfigurationCommand.ts b/clients/client-auto-scaling/commands/DeleteLaunchConfigurationCommand.ts index 7b1fee12ab15e..4958ebeea3b78 100644 --- a/clients/client-auto-scaling/commands/DeleteLaunchConfigurationCommand.ts +++ b/clients/client-auto-scaling/commands/DeleteLaunchConfigurationCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteLaunchConfigurationCommandInput = LaunchConfigurationNameType; export type DeleteLaunchConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the specified launch configuration.

+ *

The launch configuration must not be attached to an Auto Scaling group. When this call + * completes, the launch configuration is no longer available for use.

+ */ export class DeleteLaunchConfigurationCommand extends $Command< DeleteLaunchConfigurationCommandInput, DeleteLaunchConfigurationCommandOutput, @@ -34,6 +39,9 @@ export class DeleteLaunchConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DeleteLifecycleHookCommand.ts b/clients/client-auto-scaling/commands/DeleteLifecycleHookCommand.ts index b0270c6a40ab8..1fa79bf38ec40 100644 --- a/clients/client-auto-scaling/commands/DeleteLifecycleHookCommand.ts +++ b/clients/client-auto-scaling/commands/DeleteLifecycleHookCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteLifecycleHookCommandInput = DeleteLifecycleHookType; export type DeleteLifecycleHookCommandOutput = DeleteLifecycleHookAnswer & __MetadataBearer; +/** + *

Deletes the specified lifecycle hook.

+ *

If there are any outstanding lifecycle actions, they are completed first + * (ABANDON for launching instances, CONTINUE for terminating + * instances).

+ */ export class DeleteLifecycleHookCommand extends $Command< DeleteLifecycleHookCommandInput, DeleteLifecycleHookCommandOutput, @@ -34,6 +40,9 @@ export class DeleteLifecycleHookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DeleteNotificationConfigurationCommand.ts b/clients/client-auto-scaling/commands/DeleteNotificationConfigurationCommand.ts index 5f547b1c25528..4019ce0dd06d7 100644 --- a/clients/client-auto-scaling/commands/DeleteNotificationConfigurationCommand.ts +++ b/clients/client-auto-scaling/commands/DeleteNotificationConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNotificationConfigurationCommandInput = DeleteNotificationConfigurationType; export type DeleteNotificationConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the specified notification.

+ */ export class DeleteNotificationConfigurationCommand extends $Command< DeleteNotificationConfigurationCommandInput, DeleteNotificationConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNotificationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DeletePolicyCommand.ts b/clients/client-auto-scaling/commands/DeletePolicyCommand.ts index 62498c0de1d70..f7be312a592b7 100644 --- a/clients/client-auto-scaling/commands/DeletePolicyCommand.ts +++ b/clients/client-auto-scaling/commands/DeletePolicyCommand.ts @@ -17,6 +17,14 @@ import { export type DeletePolicyCommandInput = DeletePolicyType; export type DeletePolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified scaling policy.

+ *

Deleting either a step scaling policy or a simple scaling policy deletes the + * underlying alarm action, but does not delete the alarm, even if it no longer has an + * associated action.

+ *

For more information, see Deleting a scaling + * policy in the Amazon EC2 Auto Scaling User Guide.

+ */ export class DeletePolicyCommand extends $Command< DeletePolicyCommandInput, DeletePolicyCommandOutput, @@ -31,6 +39,9 @@ export class DeletePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DeleteScheduledActionCommand.ts b/clients/client-auto-scaling/commands/DeleteScheduledActionCommand.ts index 1ea83b4e806b7..f617ee6f9530e 100644 --- a/clients/client-auto-scaling/commands/DeleteScheduledActionCommand.ts +++ b/clients/client-auto-scaling/commands/DeleteScheduledActionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteScheduledActionCommandInput = DeleteScheduledActionType; export type DeleteScheduledActionCommandOutput = __MetadataBearer; +/** + *

Deletes the specified scheduled action.

+ */ export class DeleteScheduledActionCommand extends $Command< DeleteScheduledActionCommandInput, DeleteScheduledActionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteScheduledActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DeleteTagsCommand.ts b/clients/client-auto-scaling/commands/DeleteTagsCommand.ts index 0555fa0c2dc39..b671ae261511f 100644 --- a/clients/client-auto-scaling/commands/DeleteTagsCommand.ts +++ b/clients/client-auto-scaling/commands/DeleteTagsCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteTagsCommandInput = DeleteTagsType; export type DeleteTagsCommandOutput = __MetadataBearer; +/** + *

Deletes the specified tags.

+ */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -31,6 +34,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeAccountLimitsCommand.ts b/clients/client-auto-scaling/commands/DescribeAccountLimitsCommand.ts index 7fd1eb7bd6bca..410c49e9b2362 100644 --- a/clients/client-auto-scaling/commands/DescribeAccountLimitsCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeAccountLimitsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAccountLimitsCommandInput = {}; export type DescribeAccountLimitsCommandOutput = DescribeAccountLimitsAnswer & __MetadataBearer; +/** + *

Describes the current Amazon EC2 Auto Scaling resource quotas for your AWS account.

+ *

For information about requesting an increase, see Amazon EC2 Auto Scaling service + * quotas in the Amazon EC2 Auto Scaling User Guide.

+ */ export class DescribeAccountLimitsCommand extends $Command< DescribeAccountLimitsCommandInput, DescribeAccountLimitsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAccountLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeAdjustmentTypesCommand.ts b/clients/client-auto-scaling/commands/DescribeAdjustmentTypesCommand.ts index 58745a037937e..8784ab8568c95 100644 --- a/clients/client-auto-scaling/commands/DescribeAdjustmentTypesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeAdjustmentTypesCommand.ts @@ -20,6 +20,23 @@ import { export type DescribeAdjustmentTypesCommandInput = {}; export type DescribeAdjustmentTypesCommandOutput = DescribeAdjustmentTypesAnswer & __MetadataBearer; +/** + *

Describes the available adjustment types for Amazon EC2 Auto Scaling scaling policies. These settings + * apply to step scaling policies and simple scaling policies; they do not apply to target + * tracking scaling policies.

+ *

The following adjustment types are supported:

+ *
    + *
  • + *

    ChangeInCapacity

    + *
  • + *
  • + *

    ExactCapacity

    + *
  • + *
  • + *

    PercentChangeInCapacity

    + *
  • + *
+ */ export class DescribeAdjustmentTypesCommand extends $Command< DescribeAdjustmentTypesCommandInput, DescribeAdjustmentTypesCommandOutput, @@ -34,6 +51,9 @@ export class DescribeAdjustmentTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeAutoScalingGroupsCommand.ts b/clients/client-auto-scaling/commands/DescribeAutoScalingGroupsCommand.ts index e04481376b78c..0ec27ecdf0208 100644 --- a/clients/client-auto-scaling/commands/DescribeAutoScalingGroupsCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeAutoScalingGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAutoScalingGroupsCommandInput = AutoScalingGroupNamesType; export type DescribeAutoScalingGroupsCommandOutput = AutoScalingGroupsType & __MetadataBearer; +/** + *

Describes one or more Auto Scaling groups.

+ */ export class DescribeAutoScalingGroupsCommand extends $Command< DescribeAutoScalingGroupsCommandInput, DescribeAutoScalingGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAutoScalingGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeAutoScalingInstancesCommand.ts b/clients/client-auto-scaling/commands/DescribeAutoScalingInstancesCommand.ts index e8f4ce1e07f30..ad75160fe59d0 100644 --- a/clients/client-auto-scaling/commands/DescribeAutoScalingInstancesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeAutoScalingInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAutoScalingInstancesCommandInput = DescribeAutoScalingInstancesType; export type DescribeAutoScalingInstancesCommandOutput = AutoScalingInstancesType & __MetadataBearer; +/** + *

Describes one or more Auto Scaling instances.

+ */ export class DescribeAutoScalingInstancesCommand extends $Command< DescribeAutoScalingInstancesCommandInput, DescribeAutoScalingInstancesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAutoScalingInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeAutoScalingNotificationTypesCommand.ts b/clients/client-auto-scaling/commands/DescribeAutoScalingNotificationTypesCommand.ts index 2390de1cbe156..a65b18638f221 100644 --- a/clients/client-auto-scaling/commands/DescribeAutoScalingNotificationTypesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeAutoScalingNotificationTypesCommand.ts @@ -21,6 +21,9 @@ export type DescribeAutoScalingNotificationTypesCommandInput = {}; export type DescribeAutoScalingNotificationTypesCommandOutput = DescribeAutoScalingNotificationTypesAnswer & __MetadataBearer; +/** + *

Describes the notification types that are supported by Amazon EC2 Auto Scaling.

+ */ export class DescribeAutoScalingNotificationTypesCommand extends $Command< DescribeAutoScalingNotificationTypesCommandInput, DescribeAutoScalingNotificationTypesCommandOutput, @@ -35,6 +38,9 @@ export class DescribeAutoScalingNotificationTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeInstanceRefreshesCommand.ts b/clients/client-auto-scaling/commands/DescribeInstanceRefreshesCommand.ts index f905a12591032..6dce90cb66658 100644 --- a/clients/client-auto-scaling/commands/DescribeInstanceRefreshesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeInstanceRefreshesCommand.ts @@ -20,6 +20,43 @@ import { export type DescribeInstanceRefreshesCommandInput = DescribeInstanceRefreshesType; export type DescribeInstanceRefreshesCommandOutput = DescribeInstanceRefreshesAnswer & __MetadataBearer; +/** + *

Describes one or more instance refreshes.

+ *

You can determine the status of a request by looking at the Status + * parameter. The following are the possible statuses:

+ *
    + *
  • + *

    + * Pending - The request was created, but the operation has not + * started.

    + *
  • + *
  • + *

    + * InProgress - The operation is in progress.

    + *
  • + *
  • + *

    + * Successful - The operation completed successfully.

    + *
  • + *
  • + *

    + * Failed - The operation failed to complete. You can troubleshoot + * using the status reason and the scaling activities.

    + *
  • + *
  • + *

    + * Cancelling - An ongoing operation is being cancelled. + * Cancellation does not roll back any replacements that have already been + * completed, but it prevents new replacements from being started.

    + *
  • + *
  • + *

    + * Cancelled - The operation is cancelled.

    + *
  • + *
+ *

For more information, see Replacing Auto Scaling Instances + * Based on an Instance Refresh.

+ */ export class DescribeInstanceRefreshesCommand extends $Command< DescribeInstanceRefreshesCommandInput, DescribeInstanceRefreshesCommandOutput, @@ -34,6 +71,9 @@ export class DescribeInstanceRefreshesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeLaunchConfigurationsCommand.ts b/clients/client-auto-scaling/commands/DescribeLaunchConfigurationsCommand.ts index 51b6aaef5cdfb..90da24cb17139 100644 --- a/clients/client-auto-scaling/commands/DescribeLaunchConfigurationsCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeLaunchConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLaunchConfigurationsCommandInput = LaunchConfigurationNamesType; export type DescribeLaunchConfigurationsCommandOutput = LaunchConfigurationsType & __MetadataBearer; +/** + *

Describes one or more launch configurations.

+ */ export class DescribeLaunchConfigurationsCommand extends $Command< DescribeLaunchConfigurationsCommandInput, DescribeLaunchConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLaunchConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeLifecycleHookTypesCommand.ts b/clients/client-auto-scaling/commands/DescribeLifecycleHookTypesCommand.ts index 59a7fc09e56e6..4bba58026631d 100644 --- a/clients/client-auto-scaling/commands/DescribeLifecycleHookTypesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeLifecycleHookTypesCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeLifecycleHookTypesCommandInput = {}; export type DescribeLifecycleHookTypesCommandOutput = DescribeLifecycleHookTypesAnswer & __MetadataBearer; +/** + *

Describes the available types of lifecycle hooks.

+ *

The following hook types are supported:

+ *
    + *
  • + *

    autoscaling:EC2_INSTANCE_LAUNCHING

    + *
  • + *
  • + *

    autoscaling:EC2_INSTANCE_TERMINATING

    + *
  • + *
+ */ export class DescribeLifecycleHookTypesCommand extends $Command< DescribeLifecycleHookTypesCommandInput, DescribeLifecycleHookTypesCommandOutput, @@ -34,6 +46,9 @@ export class DescribeLifecycleHookTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeLifecycleHooksCommand.ts b/clients/client-auto-scaling/commands/DescribeLifecycleHooksCommand.ts index 1b03602112c39..28134e0411f7c 100644 --- a/clients/client-auto-scaling/commands/DescribeLifecycleHooksCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeLifecycleHooksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLifecycleHooksCommandInput = DescribeLifecycleHooksType; export type DescribeLifecycleHooksCommandOutput = DescribeLifecycleHooksAnswer & __MetadataBearer; +/** + *

Describes the lifecycle hooks for the specified Auto Scaling group.

+ */ export class DescribeLifecycleHooksCommand extends $Command< DescribeLifecycleHooksCommandInput, DescribeLifecycleHooksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLifecycleHooksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeLoadBalancerTargetGroupsCommand.ts b/clients/client-auto-scaling/commands/DescribeLoadBalancerTargetGroupsCommand.ts index 4021441a6574b..8f30ec5583f59 100644 --- a/clients/client-auto-scaling/commands/DescribeLoadBalancerTargetGroupsCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeLoadBalancerTargetGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLoadBalancerTargetGroupsCommandInput = DescribeLoadBalancerTargetGroupsRequest; export type DescribeLoadBalancerTargetGroupsCommandOutput = DescribeLoadBalancerTargetGroupsResponse & __MetadataBearer; +/** + *

Describes the target groups for the specified Auto Scaling group.

+ */ export class DescribeLoadBalancerTargetGroupsCommand extends $Command< DescribeLoadBalancerTargetGroupsCommandInput, DescribeLoadBalancerTargetGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLoadBalancerTargetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeLoadBalancersCommand.ts b/clients/client-auto-scaling/commands/DescribeLoadBalancersCommand.ts index 89bef8d3a81b8..6f68b723c7981 100644 --- a/clients/client-auto-scaling/commands/DescribeLoadBalancersCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeLoadBalancersCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeLoadBalancersCommandInput = DescribeLoadBalancersRequest; export type DescribeLoadBalancersCommandOutput = DescribeLoadBalancersResponse & __MetadataBearer; +/** + *

Describes the load balancers for the specified Auto Scaling group.

+ *

This operation describes only Classic Load Balancers. If you have Application Load + * Balancers or Network Load Balancers, use the DescribeLoadBalancerTargetGroups API instead.

+ */ export class DescribeLoadBalancersCommand extends $Command< DescribeLoadBalancersCommandInput, DescribeLoadBalancersCommandOutput, @@ -34,6 +39,9 @@ export class DescribeLoadBalancersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeMetricCollectionTypesCommand.ts b/clients/client-auto-scaling/commands/DescribeMetricCollectionTypesCommand.ts index 64a60da02436f..ee52b82c636cc 100644 --- a/clients/client-auto-scaling/commands/DescribeMetricCollectionTypesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeMetricCollectionTypesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeMetricCollectionTypesCommandInput = {}; export type DescribeMetricCollectionTypesCommandOutput = DescribeMetricCollectionTypesAnswer & __MetadataBearer; +/** + *

Describes the available CloudWatch metrics for Amazon EC2 Auto Scaling.

+ *

The GroupStandbyInstances metric is not returned by default. You must + * explicitly request this metric when calling the EnableMetricsCollection API.

+ */ export class DescribeMetricCollectionTypesCommand extends $Command< DescribeMetricCollectionTypesCommandInput, DescribeMetricCollectionTypesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeMetricCollectionTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeNotificationConfigurationsCommand.ts b/clients/client-auto-scaling/commands/DescribeNotificationConfigurationsCommand.ts index 8308f041272e8..909266b9a3b03 100644 --- a/clients/client-auto-scaling/commands/DescribeNotificationConfigurationsCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeNotificationConfigurationsCommand.ts @@ -21,6 +21,9 @@ export type DescribeNotificationConfigurationsCommandInput = DescribeNotificatio export type DescribeNotificationConfigurationsCommandOutput = DescribeNotificationConfigurationsAnswer & __MetadataBearer; +/** + *

Describes the notification actions associated with the specified Auto Scaling group.

+ */ export class DescribeNotificationConfigurationsCommand extends $Command< DescribeNotificationConfigurationsCommandInput, DescribeNotificationConfigurationsCommandOutput, @@ -35,6 +38,9 @@ export class DescribeNotificationConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribePoliciesCommand.ts b/clients/client-auto-scaling/commands/DescribePoliciesCommand.ts index b3c7b25879584..89145ac0f9bc1 100644 --- a/clients/client-auto-scaling/commands/DescribePoliciesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribePoliciesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePoliciesCommandInput = DescribePoliciesType; export type DescribePoliciesCommandOutput = PoliciesType & __MetadataBearer; +/** + *

Describes the policies for the specified Auto Scaling group.

+ */ export class DescribePoliciesCommand extends $Command< DescribePoliciesCommandInput, DescribePoliciesCommandOutput, @@ -34,6 +37,9 @@ export class DescribePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeScalingActivitiesCommand.ts b/clients/client-auto-scaling/commands/DescribeScalingActivitiesCommand.ts index e7bb97282645d..40363c412bbcb 100644 --- a/clients/client-auto-scaling/commands/DescribeScalingActivitiesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeScalingActivitiesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeScalingActivitiesCommandInput = DescribeScalingActivitiesType; export type DescribeScalingActivitiesCommandOutput = ActivitiesType & __MetadataBearer; +/** + *

Describes one or more scaling activities for the specified Auto Scaling group.

+ */ export class DescribeScalingActivitiesCommand extends $Command< DescribeScalingActivitiesCommandInput, DescribeScalingActivitiesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeScalingActivitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeScalingProcessTypesCommand.ts b/clients/client-auto-scaling/commands/DescribeScalingProcessTypesCommand.ts index f3de9bc15449c..7ad5199b3f6c8 100644 --- a/clients/client-auto-scaling/commands/DescribeScalingProcessTypesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeScalingProcessTypesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeScalingProcessTypesCommandInput = {}; export type DescribeScalingProcessTypesCommandOutput = ProcessesType & __MetadataBearer; +/** + *

Describes the scaling process types for use with the ResumeProcesses + * and SuspendProcesses APIs.

+ */ export class DescribeScalingProcessTypesCommand extends $Command< DescribeScalingProcessTypesCommandInput, DescribeScalingProcessTypesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeScalingProcessTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeScheduledActionsCommand.ts b/clients/client-auto-scaling/commands/DescribeScheduledActionsCommand.ts index df30906e1d43d..84d51cd7005aa 100644 --- a/clients/client-auto-scaling/commands/DescribeScheduledActionsCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeScheduledActionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeScheduledActionsCommandInput = DescribeScheduledActionsType; export type DescribeScheduledActionsCommandOutput = ScheduledActionsType & __MetadataBearer; +/** + *

Describes the actions scheduled for your Auto Scaling group that haven't run or that have not + * reached their end time. To describe the actions that have already run, call the DescribeScalingActivities API.

+ */ export class DescribeScheduledActionsCommand extends $Command< DescribeScheduledActionsCommandInput, DescribeScheduledActionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeScheduledActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeTagsCommand.ts b/clients/client-auto-scaling/commands/DescribeTagsCommand.ts index c686bde1fd2c5..44a25eacbba13 100644 --- a/clients/client-auto-scaling/commands/DescribeTagsCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeTagsCommand.ts @@ -17,6 +17,17 @@ import { export type DescribeTagsCommandInput = DescribeTagsType; export type DescribeTagsCommandOutput = TagsType & __MetadataBearer; +/** + *

Describes the specified tags.

+ *

You can use filters to limit the results. For example, you can query for the tags for + * a specific Auto Scaling group. You can specify multiple values for a filter. A tag must match at + * least one of the specified values for it to be included in the results.

+ *

You can also specify multiple filters. The result includes information for a + * particular tag only if it matches all the filters. If there's no match, no special + * message is returned.

+ *

For more information, see Tagging Auto Scaling groups and + * instances in the Amazon EC2 Auto Scaling User Guide.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -31,6 +42,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DescribeTerminationPolicyTypesCommand.ts b/clients/client-auto-scaling/commands/DescribeTerminationPolicyTypesCommand.ts index 6bcbcd9591ef2..27dae615ac2d9 100644 --- a/clients/client-auto-scaling/commands/DescribeTerminationPolicyTypesCommand.ts +++ b/clients/client-auto-scaling/commands/DescribeTerminationPolicyTypesCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeTerminationPolicyTypesCommandInput = {}; export type DescribeTerminationPolicyTypesCommandOutput = DescribeTerminationPolicyTypesAnswer & __MetadataBearer; +/** + *

Describes the termination policies supported by Amazon EC2 Auto Scaling.

+ *

For more information, see Controlling which Auto Scaling + * instances terminate during scale in in the + * Amazon EC2 Auto Scaling User Guide.

+ */ export class DescribeTerminationPolicyTypesCommand extends $Command< DescribeTerminationPolicyTypesCommandInput, DescribeTerminationPolicyTypesCommandOutput, @@ -34,6 +40,9 @@ export class DescribeTerminationPolicyTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DetachInstancesCommand.ts b/clients/client-auto-scaling/commands/DetachInstancesCommand.ts index 89c45856e5169..ab1f31c609dd9 100644 --- a/clients/client-auto-scaling/commands/DetachInstancesCommand.ts +++ b/clients/client-auto-scaling/commands/DetachInstancesCommand.ts @@ -20,6 +20,18 @@ import { export type DetachInstancesCommandInput = DetachInstancesQuery; export type DetachInstancesCommandOutput = DetachInstancesAnswer & __MetadataBearer; +/** + *

Removes one or more instances from the specified Auto Scaling group.

+ *

After the instances are detached, you can manage them independent of the Auto Scaling + * group.

+ *

If you do not specify the option to decrement the desired capacity, Amazon EC2 Auto Scaling launches + * instances to replace the ones that are detached.

+ *

If there is a Classic Load Balancer attached to the Auto Scaling group, the instances are + * deregistered from the load balancer. If there are target groups attached to the Auto Scaling + * group, the instances are deregistered from the target groups.

+ *

For more information, see Detach EC2 instances from + * your Auto Scaling group in the Amazon EC2 Auto Scaling User Guide.

+ */ export class DetachInstancesCommand extends $Command< DetachInstancesCommandInput, DetachInstancesCommandOutput, @@ -34,6 +46,9 @@ export class DetachInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DetachLoadBalancerTargetGroupsCommand.ts b/clients/client-auto-scaling/commands/DetachLoadBalancerTargetGroupsCommand.ts index 8357727487124..ddaeb1be587f6 100644 --- a/clients/client-auto-scaling/commands/DetachLoadBalancerTargetGroupsCommand.ts +++ b/clients/client-auto-scaling/commands/DetachLoadBalancerTargetGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DetachLoadBalancerTargetGroupsCommandInput = DetachLoadBalancerTargetGroupsType; export type DetachLoadBalancerTargetGroupsCommandOutput = DetachLoadBalancerTargetGroupsResultType & __MetadataBearer; +/** + *

Detaches one or more target groups from the specified Auto Scaling group.

+ */ export class DetachLoadBalancerTargetGroupsCommand extends $Command< DetachLoadBalancerTargetGroupsCommandInput, DetachLoadBalancerTargetGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DetachLoadBalancerTargetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DetachLoadBalancersCommand.ts b/clients/client-auto-scaling/commands/DetachLoadBalancersCommand.ts index cf00e229ee9f3..cac0a93e3a01d 100644 --- a/clients/client-auto-scaling/commands/DetachLoadBalancersCommand.ts +++ b/clients/client-auto-scaling/commands/DetachLoadBalancersCommand.ts @@ -20,6 +20,14 @@ import { export type DetachLoadBalancersCommandInput = DetachLoadBalancersType; export type DetachLoadBalancersCommandOutput = DetachLoadBalancersResultType & __MetadataBearer; +/** + *

Detaches one or more Classic Load Balancers from the specified Auto Scaling group.

+ *

This operation detaches only Classic Load Balancers. If you have Application Load + * Balancers or Network Load Balancers, use the DetachLoadBalancerTargetGroups API instead.

+ *

When you detach a load balancer, it enters the Removing state while + * deregistering the instances in the group. When all instances are deregistered, then you + * can no longer describe the load balancer using the DescribeLoadBalancers API call. The instances remain running.

+ */ export class DetachLoadBalancersCommand extends $Command< DetachLoadBalancersCommandInput, DetachLoadBalancersCommandOutput, @@ -34,6 +42,9 @@ export class DetachLoadBalancersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/DisableMetricsCollectionCommand.ts b/clients/client-auto-scaling/commands/DisableMetricsCollectionCommand.ts index e5c2f8c1d903e..078a7006f72b4 100644 --- a/clients/client-auto-scaling/commands/DisableMetricsCollectionCommand.ts +++ b/clients/client-auto-scaling/commands/DisableMetricsCollectionCommand.ts @@ -20,6 +20,9 @@ import { export type DisableMetricsCollectionCommandInput = DisableMetricsCollectionQuery; export type DisableMetricsCollectionCommandOutput = __MetadataBearer; +/** + *

Disables group metrics for the specified Auto Scaling group.

+ */ export class DisableMetricsCollectionCommand extends $Command< DisableMetricsCollectionCommandInput, DisableMetricsCollectionCommandOutput, @@ -34,6 +37,9 @@ export class DisableMetricsCollectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/EnableMetricsCollectionCommand.ts b/clients/client-auto-scaling/commands/EnableMetricsCollectionCommand.ts index fce1d5de9c550..8010cd4526a81 100644 --- a/clients/client-auto-scaling/commands/EnableMetricsCollectionCommand.ts +++ b/clients/client-auto-scaling/commands/EnableMetricsCollectionCommand.ts @@ -20,6 +20,10 @@ import { export type EnableMetricsCollectionCommandInput = EnableMetricsCollectionQuery; export type EnableMetricsCollectionCommandOutput = __MetadataBearer; +/** + *

Enables group metrics for the specified Auto Scaling group. For more information, see Monitoring CloudWatch metrics for your Auto Scaling groups and instances in the + * Amazon EC2 Auto Scaling User Guide.

+ */ export class EnableMetricsCollectionCommand extends $Command< EnableMetricsCollectionCommandInput, EnableMetricsCollectionCommandOutput, @@ -34,6 +38,9 @@ export class EnableMetricsCollectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/EnterStandbyCommand.ts b/clients/client-auto-scaling/commands/EnterStandbyCommand.ts index 290119c215606..c042f0a4a9564 100644 --- a/clients/client-auto-scaling/commands/EnterStandbyCommand.ts +++ b/clients/client-auto-scaling/commands/EnterStandbyCommand.ts @@ -17,6 +17,18 @@ import { export type EnterStandbyCommandInput = EnterStandbyQuery; export type EnterStandbyCommandOutput = EnterStandbyAnswer & __MetadataBearer; +/** + *

Moves the specified instances into the standby state.

+ *

If you choose to decrement the desired capacity of the Auto Scaling group, the instances can + * enter standby as long as the desired capacity of the Auto Scaling group after the instances are + * placed into standby is equal to or greater than the minimum capacity of the + * group.

+ *

If you choose not to decrement the desired capacity of the Auto Scaling group, the Auto Scaling group + * launches new instances to replace the instances on standby.

+ *

For more information, see Temporarily removing + * instances from your Auto Scaling group in the + * Amazon EC2 Auto Scaling User Guide.

+ */ export class EnterStandbyCommand extends $Command< EnterStandbyCommandInput, EnterStandbyCommandOutput, @@ -31,6 +43,9 @@ export class EnterStandbyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/ExecutePolicyCommand.ts b/clients/client-auto-scaling/commands/ExecutePolicyCommand.ts index 2e43571037976..95c217a7ac7f0 100644 --- a/clients/client-auto-scaling/commands/ExecutePolicyCommand.ts +++ b/clients/client-auto-scaling/commands/ExecutePolicyCommand.ts @@ -20,6 +20,10 @@ import { export type ExecutePolicyCommandInput = ExecutePolicyType; export type ExecutePolicyCommandOutput = __MetadataBearer; +/** + *

Executes the specified policy. This can be useful for testing the design of your + * scaling policy.

+ */ export class ExecutePolicyCommand extends $Command< ExecutePolicyCommandInput, ExecutePolicyCommandOutput, @@ -34,6 +38,9 @@ export class ExecutePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/ExitStandbyCommand.ts b/clients/client-auto-scaling/commands/ExitStandbyCommand.ts index 74f414c859c2a..ecac28fe76897 100644 --- a/clients/client-auto-scaling/commands/ExitStandbyCommand.ts +++ b/clients/client-auto-scaling/commands/ExitStandbyCommand.ts @@ -17,6 +17,14 @@ import { export type ExitStandbyCommandInput = ExitStandbyQuery; export type ExitStandbyCommandOutput = ExitStandbyAnswer & __MetadataBearer; +/** + *

Moves the specified instances out of the standby state.

+ *

After you put the instances back in service, the desired capacity is + * incremented.

+ *

For more information, see Temporarily removing + * instances from your Auto Scaling group in the + * Amazon EC2 Auto Scaling User Guide.

+ */ export class ExitStandbyCommand extends $Command< ExitStandbyCommandInput, ExitStandbyCommandOutput, @@ -31,6 +39,9 @@ export class ExitStandbyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/PutLifecycleHookCommand.ts b/clients/client-auto-scaling/commands/PutLifecycleHookCommand.ts index 9ea6a53c1e1ab..b8dc037e218b1 100644 --- a/clients/client-auto-scaling/commands/PutLifecycleHookCommand.ts +++ b/clients/client-auto-scaling/commands/PutLifecycleHookCommand.ts @@ -20,6 +20,46 @@ import { export type PutLifecycleHookCommandInput = PutLifecycleHookType; export type PutLifecycleHookCommandOutput = PutLifecycleHookAnswer & __MetadataBearer; +/** + *

Creates or updates a lifecycle hook for the specified Auto Scaling group.

+ *

A lifecycle hook tells Amazon EC2 Auto Scaling to perform an action on an instance when the instance + * launches (before it is put into service) or as the instance terminates (before it is + * fully terminated).

+ *

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling + * group:

+ *
    + *
  1. + *

    (Optional) Create a Lambda function and a rule that allows CloudWatch Events to + * invoke your Lambda function when Amazon EC2 Auto Scaling launches or terminates + * instances.

    + *
  2. + *
  3. + *

    (Optional) Create a notification target and an IAM role. The target can be + * either an Amazon SQS queue or an Amazon SNS topic. The role allows Amazon EC2 Auto Scaling to + * publish lifecycle notifications to the target.

    + *
  4. + *
  5. + *

    + * Create the lifecycle hook. Specify whether the hook is + * used when the instances launch or terminate. + *

    + *
  6. + *
  7. + *

    If you need more time, record the lifecycle action heartbeat to keep the + * instance in a pending state using the RecordLifecycleActionHeartbeat API call.

    + *
  8. + *
  9. + *

    If you finish before the timeout period ends, complete the lifecycle action + * using the CompleteLifecycleAction API call.

    + *
  10. + *
+ *

For more information, see Amazon EC2 Auto Scaling lifecycle + * hooks in the Amazon EC2 Auto Scaling User Guide.

+ *

If you exceed your maximum limit of lifecycle hooks, which by default is 50 per Auto Scaling + * group, the call fails.

+ *

You can view the lifecycle hooks for an Auto Scaling group using the DescribeLifecycleHooks API call. If you are no longer using a lifecycle + * hook, you can delete it by calling the DeleteLifecycleHook API.

+ */ export class PutLifecycleHookCommand extends $Command< PutLifecycleHookCommandInput, PutLifecycleHookCommandOutput, @@ -34,6 +74,9 @@ export class PutLifecycleHookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/PutNotificationConfigurationCommand.ts b/clients/client-auto-scaling/commands/PutNotificationConfigurationCommand.ts index b95bce05f8c20..6f2c18a9b4b56 100644 --- a/clients/client-auto-scaling/commands/PutNotificationConfigurationCommand.ts +++ b/clients/client-auto-scaling/commands/PutNotificationConfigurationCommand.ts @@ -20,6 +20,17 @@ import { export type PutNotificationConfigurationCommandInput = PutNotificationConfigurationType; export type PutNotificationConfigurationCommandOutput = __MetadataBearer; +/** + *

Configures an Auto Scaling group to send notifications when specified events take place. + * Subscribers to the specified topic can have messages delivered to an endpoint such as a + * web server or an email address.

+ *

This configuration overwrites any existing configuration.

+ *

For more information, see Getting Amazon SNS + * notifications when your Auto Scaling group scales in the + * Amazon EC2 Auto Scaling User Guide.

+ *

If you exceed your maximum limit of SNS topics, which is 10 per Auto Scaling group, the call + * fails.

+ */ export class PutNotificationConfigurationCommand extends $Command< PutNotificationConfigurationCommandInput, PutNotificationConfigurationCommandOutput, @@ -34,6 +45,9 @@ export class PutNotificationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/PutScalingPolicyCommand.ts b/clients/client-auto-scaling/commands/PutScalingPolicyCommand.ts index b22af6111a5d5..cf74037513e9c 100644 --- a/clients/client-auto-scaling/commands/PutScalingPolicyCommand.ts +++ b/clients/client-auto-scaling/commands/PutScalingPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutScalingPolicyCommandInput = PutScalingPolicyType; export type PutScalingPolicyCommandOutput = PolicyARNType & __MetadataBearer; +/** + *

Creates or updates a scaling policy for an Auto Scaling group.

+ *

For more information about using scaling policies to scale your Auto Scaling group, see Target tracking scaling policies and Step and simple scaling + * policies in the Amazon EC2 Auto Scaling User Guide.

+ */ export class PutScalingPolicyCommand extends $Command< PutScalingPolicyCommandInput, PutScalingPolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/PutScheduledUpdateGroupActionCommand.ts b/clients/client-auto-scaling/commands/PutScheduledUpdateGroupActionCommand.ts index f5d500d20276e..c37c3c753e675 100644 --- a/clients/client-auto-scaling/commands/PutScheduledUpdateGroupActionCommand.ts +++ b/clients/client-auto-scaling/commands/PutScheduledUpdateGroupActionCommand.ts @@ -20,6 +20,13 @@ import { export type PutScheduledUpdateGroupActionCommandInput = PutScheduledUpdateGroupActionType; export type PutScheduledUpdateGroupActionCommandOutput = __MetadataBearer; +/** + *

Creates or updates a scheduled scaling action for an Auto Scaling group. If you leave a + * parameter unspecified when updating a scheduled scaling action, the corresponding value + * remains unchanged.

+ *

For more information, see Scheduled scaling in the + * Amazon EC2 Auto Scaling User Guide.

+ */ export class PutScheduledUpdateGroupActionCommand extends $Command< PutScheduledUpdateGroupActionCommandInput, PutScheduledUpdateGroupActionCommandOutput, @@ -34,6 +41,9 @@ export class PutScheduledUpdateGroupActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/RecordLifecycleActionHeartbeatCommand.ts b/clients/client-auto-scaling/commands/RecordLifecycleActionHeartbeatCommand.ts index ed505dd34db31..bdc153903f7ac 100644 --- a/clients/client-auto-scaling/commands/RecordLifecycleActionHeartbeatCommand.ts +++ b/clients/client-auto-scaling/commands/RecordLifecycleActionHeartbeatCommand.ts @@ -20,6 +20,41 @@ import { export type RecordLifecycleActionHeartbeatCommandInput = RecordLifecycleActionHeartbeatType; export type RecordLifecycleActionHeartbeatCommandOutput = RecordLifecycleActionHeartbeatAnswer & __MetadataBearer; +/** + *

Records a heartbeat for the lifecycle action associated with the specified token or + * instance. This extends the timeout by the length of time defined using the PutLifecycleHook API call.

+ * + *

This step is a part of the procedure for adding a lifecycle hook to an Auto Scaling + * group:

+ *
    + *
  1. + *

    (Optional) Create a Lambda function and a rule that allows CloudWatch Events to + * invoke your Lambda function when Amazon EC2 Auto Scaling launches or terminates + * instances.

    + *
  2. + *
  3. + *

    (Optional) Create a notification target and an IAM role. The target can be + * either an Amazon SQS queue or an Amazon SNS topic. The role allows Amazon EC2 Auto Scaling to + * publish lifecycle notifications to the target.

    + *
  4. + *
  5. + *

    Create the lifecycle hook. Specify whether the hook is used when the instances + * launch or terminate.

    + *
  6. + *
  7. + *

    + * If you need more time, record the lifecycle action + * heartbeat to keep the instance in a pending state. + *

    + *
  8. + *
  9. + *

    If you finish before the timeout period ends, complete the lifecycle + * action.

    + *
  10. + *
+ *

For more information, see Auto Scaling + * lifecycle in the Amazon EC2 Auto Scaling User Guide.

+ */ export class RecordLifecycleActionHeartbeatCommand extends $Command< RecordLifecycleActionHeartbeatCommandInput, RecordLifecycleActionHeartbeatCommandOutput, @@ -34,6 +69,9 @@ export class RecordLifecycleActionHeartbeatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/ResumeProcessesCommand.ts b/clients/client-auto-scaling/commands/ResumeProcessesCommand.ts index 66a94b54c3c17..74abf458051a8 100644 --- a/clients/client-auto-scaling/commands/ResumeProcessesCommand.ts +++ b/clients/client-auto-scaling/commands/ResumeProcessesCommand.ts @@ -20,6 +20,12 @@ import { export type ResumeProcessesCommandInput = ScalingProcessQuery; export type ResumeProcessesCommandOutput = __MetadataBearer; +/** + *

Resumes the specified suspended auto scaling processes, or all suspended process, for + * the specified Auto Scaling group.

+ *

For more information, see Suspending and + * resuming scaling processes in the Amazon EC2 Auto Scaling User Guide.

+ */ export class ResumeProcessesCommand extends $Command< ResumeProcessesCommandInput, ResumeProcessesCommandOutput, @@ -34,6 +40,9 @@ export class ResumeProcessesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/SetDesiredCapacityCommand.ts b/clients/client-auto-scaling/commands/SetDesiredCapacityCommand.ts index de38a3257ff68..44cf97ac88508 100644 --- a/clients/client-auto-scaling/commands/SetDesiredCapacityCommand.ts +++ b/clients/client-auto-scaling/commands/SetDesiredCapacityCommand.ts @@ -20,6 +20,14 @@ import { export type SetDesiredCapacityCommandInput = SetDesiredCapacityType; export type SetDesiredCapacityCommandOutput = __MetadataBearer; +/** + *

Sets the size of the specified Auto Scaling group.

+ *

If a scale-in activity occurs as a result of a new DesiredCapacity value + * that is lower than the current size of the group, the Auto Scaling group uses its termination + * policy to determine which instances to terminate.

+ *

For more information, see Manual scaling in the + * Amazon EC2 Auto Scaling User Guide.

+ */ export class SetDesiredCapacityCommand extends $Command< SetDesiredCapacityCommandInput, SetDesiredCapacityCommandOutput, @@ -34,6 +42,9 @@ export class SetDesiredCapacityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/SetInstanceHealthCommand.ts b/clients/client-auto-scaling/commands/SetInstanceHealthCommand.ts index 522d31e8dd1f8..aa08f887ae079 100644 --- a/clients/client-auto-scaling/commands/SetInstanceHealthCommand.ts +++ b/clients/client-auto-scaling/commands/SetInstanceHealthCommand.ts @@ -20,6 +20,11 @@ import { export type SetInstanceHealthCommandInput = SetInstanceHealthQuery; export type SetInstanceHealthCommandOutput = __MetadataBearer; +/** + *

Sets the health status of the specified instance.

+ *

For more information, see Health checks for Auto Scaling + * instances in the Amazon EC2 Auto Scaling User Guide.

+ */ export class SetInstanceHealthCommand extends $Command< SetInstanceHealthCommandInput, SetInstanceHealthCommandOutput, @@ -34,6 +39,9 @@ export class SetInstanceHealthCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/SetInstanceProtectionCommand.ts b/clients/client-auto-scaling/commands/SetInstanceProtectionCommand.ts index ef245bec8a0cd..92d13137bda1b 100644 --- a/clients/client-auto-scaling/commands/SetInstanceProtectionCommand.ts +++ b/clients/client-auto-scaling/commands/SetInstanceProtectionCommand.ts @@ -20,6 +20,14 @@ import { export type SetInstanceProtectionCommandInput = SetInstanceProtectionQuery; export type SetInstanceProtectionCommandOutput = SetInstanceProtectionAnswer & __MetadataBearer; +/** + *

Updates the instance protection settings of the specified instances.

+ *

For more information about preventing instances that are part of an Auto Scaling group from + * terminating on scale in, see Instance scale-in protection in the + * Amazon EC2 Auto Scaling User Guide.

+ *

If you exceed your maximum limit of instance IDs, which is 50 per Auto Scaling group, the call + * fails.

+ */ export class SetInstanceProtectionCommand extends $Command< SetInstanceProtectionCommandInput, SetInstanceProtectionCommandOutput, @@ -34,6 +42,9 @@ export class SetInstanceProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/StartInstanceRefreshCommand.ts b/clients/client-auto-scaling/commands/StartInstanceRefreshCommand.ts index 4060e67858aee..d7b100e42aa41 100644 --- a/clients/client-auto-scaling/commands/StartInstanceRefreshCommand.ts +++ b/clients/client-auto-scaling/commands/StartInstanceRefreshCommand.ts @@ -20,6 +20,17 @@ import { export type StartInstanceRefreshCommandInput = StartInstanceRefreshType; export type StartInstanceRefreshCommandOutput = StartInstanceRefreshAnswer & __MetadataBearer; +/** + *

Starts a new instance refresh operation, which triggers a rolling replacement of all + * previously launched instances in the Auto Scaling group with a new group of instances.

+ *

If successful, this call creates a new instance refresh request with a unique ID that + * you can use to track its progress. To query its status, call the DescribeInstanceRefreshes API. To describe the instance refreshes that + * have already run, call the DescribeInstanceRefreshes API. To cancel an + * instance refresh operation in progress, use the CancelInstanceRefresh + * API.

+ *

For more information, see Replacing Auto Scaling Instances + * Based on an Instance Refresh.

+ */ export class StartInstanceRefreshCommand extends $Command< StartInstanceRefreshCommandInput, StartInstanceRefreshCommandOutput, @@ -34,6 +45,9 @@ export class StartInstanceRefreshCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/SuspendProcessesCommand.ts b/clients/client-auto-scaling/commands/SuspendProcessesCommand.ts index 2380ae67329e9..66453398314a9 100644 --- a/clients/client-auto-scaling/commands/SuspendProcessesCommand.ts +++ b/clients/client-auto-scaling/commands/SuspendProcessesCommand.ts @@ -20,6 +20,15 @@ import { export type SuspendProcessesCommandInput = ScalingProcessQuery; export type SuspendProcessesCommandOutput = __MetadataBearer; +/** + *

Suspends the specified auto scaling processes, or all processes, for the specified + * Auto Scaling group.

+ *

If you suspend either the Launch or Terminate process types, + * it can prevent other process types from functioning properly. For more information, see + * Suspending and + * resuming scaling processes in the Amazon EC2 Auto Scaling User Guide.

+ *

To resume processes that have been suspended, call the ResumeProcesses API.

+ */ export class SuspendProcessesCommand extends $Command< SuspendProcessesCommandInput, SuspendProcessesCommandOutput, @@ -34,6 +43,9 @@ export class SuspendProcessesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/TerminateInstanceInAutoScalingGroupCommand.ts b/clients/client-auto-scaling/commands/TerminateInstanceInAutoScalingGroupCommand.ts index 7256bba6468de..8361706085282 100644 --- a/clients/client-auto-scaling/commands/TerminateInstanceInAutoScalingGroupCommand.ts +++ b/clients/client-auto-scaling/commands/TerminateInstanceInAutoScalingGroupCommand.ts @@ -20,6 +20,19 @@ import { export type TerminateInstanceInAutoScalingGroupCommandInput = TerminateInstanceInAutoScalingGroupType; export type TerminateInstanceInAutoScalingGroupCommandOutput = ActivityType & __MetadataBearer; +/** + *

Terminates the specified instance and optionally adjusts the desired group size.

+ *

This call simply makes a termination request. The instance is not terminated + * immediately. When an instance is terminated, the instance status changes to + * terminated. You can't connect to or start an instance after you've + * terminated it.

+ *

If you do not specify the option to decrement the desired capacity, Amazon EC2 Auto Scaling launches + * instances to replace the ones that are terminated.

+ *

By default, Amazon EC2 Auto Scaling balances instances across all Availability Zones. If you + * decrement the desired capacity, your Auto Scaling group can become unbalanced between + * Availability Zones. Amazon EC2 Auto Scaling tries to rebalance the group, and rebalancing might + * terminate instances in other zones. For more information, see Rebalancing activities in the Amazon EC2 Auto Scaling User Guide.

+ */ export class TerminateInstanceInAutoScalingGroupCommand extends $Command< TerminateInstanceInAutoScalingGroupCommandInput, TerminateInstanceInAutoScalingGroupCommandOutput, @@ -34,6 +47,9 @@ export class TerminateInstanceInAutoScalingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/commands/UpdateAutoScalingGroupCommand.ts b/clients/client-auto-scaling/commands/UpdateAutoScalingGroupCommand.ts index 682d3ec3d2ef3..e9ba0e204eebb 100644 --- a/clients/client-auto-scaling/commands/UpdateAutoScalingGroupCommand.ts +++ b/clients/client-auto-scaling/commands/UpdateAutoScalingGroupCommand.ts @@ -20,6 +20,49 @@ import { export type UpdateAutoScalingGroupCommandInput = UpdateAutoScalingGroupType; export type UpdateAutoScalingGroupCommandOutput = __MetadataBearer; +/** + *

Updates the configuration for the specified Auto Scaling group.

+ *

To update an Auto Scaling group, specify the name of the group and the parameter that you want + * to change. Any parameters that you don't specify are not changed by this update request. + * The new settings take effect on any scaling activities after this call returns. + *

+ *

If you associate a new launch configuration or template with an Auto Scaling group, all new + * instances will get the updated configuration. Existing instances continue to run with + * the configuration that they were originally launched with. When you update a group to + * specify a mixed instances policy instead of a launch configuration or template, existing + * instances may be replaced to match the new purchasing options that you specified in the + * policy. For example, if the group currently has 100% On-Demand capacity and the policy + * specifies 50% Spot capacity, this means that half of your instances will be gradually + * terminated and relaunched as Spot Instances. When replacing instances, Amazon EC2 Auto Scaling launches + * new instances before terminating the old ones, so that updating your group does not + * compromise the performance or availability of your application.

+ *

Note the following about changing DesiredCapacity, MaxSize, + * or MinSize:

+ *
    + *
  • + *

    If a scale-in activity occurs as a result of a new + * DesiredCapacity value that is lower than the current size of + * the group, the Auto Scaling group uses its termination policy to determine which + * instances to terminate.

    + *
  • + *
  • + *

    If you specify a new value for MinSize without specifying a value + * for DesiredCapacity, and the new MinSize is larger + * than the current size of the group, this sets the group's + * DesiredCapacity to the new MinSize value.

    + *
  • + *
  • + *

    If you specify a new value for MaxSize without specifying a value + * for DesiredCapacity, and the new MaxSize is smaller + * than the current size of the group, this sets the group's + * DesiredCapacity to the new MaxSize value.

    + *
  • + *
+ *

To see which parameters have been set, call the DescribeAutoScalingGroups API. To view the scaling policies for an Auto Scaling + * group, call the DescribePolicies API. If the group has scaling + * policies, you can update them by calling the PutScalingPolicy + * API.

+ */ export class UpdateAutoScalingGroupCommand extends $Command< UpdateAutoScalingGroupCommandInput, UpdateAutoScalingGroupCommandOutput, @@ -34,6 +77,9 @@ export class UpdateAutoScalingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: AutoScalingClientResolvedConfig, diff --git a/clients/client-auto-scaling/package.json b/clients/client-auto-scaling/package.json index 12dc5f84117fd..11a728a1ed457 100644 --- a/clients/client-auto-scaling/package.json +++ b/clients/client-auto-scaling/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Auto Scaling Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-auto-scaling/pagination/DescribeAutoScalingGroupsPaginator.ts b/clients/client-auto-scaling/pagination/DescribeAutoScalingGroupsPaginator.ts index 33bf270672004..1feea7c042129 100644 --- a/clients/client-auto-scaling/pagination/DescribeAutoScalingGroupsPaginator.ts +++ b/clients/client-auto-scaling/pagination/DescribeAutoScalingGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { AutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AutoScalingClient, input: DescribeAutoScalingGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAutoScalingGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AutoScaling, input: DescribeAutoScalingGroupsCommandInput, diff --git a/clients/client-auto-scaling/pagination/DescribeAutoScalingInstancesPaginator.ts b/clients/client-auto-scaling/pagination/DescribeAutoScalingInstancesPaginator.ts index c17c2a7d54b76..1d799b77b2b31 100644 --- a/clients/client-auto-scaling/pagination/DescribeAutoScalingInstancesPaginator.ts +++ b/clients/client-auto-scaling/pagination/DescribeAutoScalingInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { AutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AutoScalingClient, input: DescribeAutoScalingInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAutoScalingInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AutoScaling, input: DescribeAutoScalingInstancesCommandInput, diff --git a/clients/client-auto-scaling/pagination/DescribeLaunchConfigurationsPaginator.ts b/clients/client-auto-scaling/pagination/DescribeLaunchConfigurationsPaginator.ts index f7b02714e57a9..efad72ac1d52a 100644 --- a/clients/client-auto-scaling/pagination/DescribeLaunchConfigurationsPaginator.ts +++ b/clients/client-auto-scaling/pagination/DescribeLaunchConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { AutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AutoScalingClient, input: DescribeLaunchConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLaunchConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AutoScaling, input: DescribeLaunchConfigurationsCommandInput, diff --git a/clients/client-auto-scaling/pagination/DescribeNotificationConfigurationsPaginator.ts b/clients/client-auto-scaling/pagination/DescribeNotificationConfigurationsPaginator.ts index f53c96046b7c1..494a734eb56e3 100644 --- a/clients/client-auto-scaling/pagination/DescribeNotificationConfigurationsPaginator.ts +++ b/clients/client-auto-scaling/pagination/DescribeNotificationConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { AutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AutoScalingClient, input: DescribeNotificationConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeNotificationConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AutoScaling, input: DescribeNotificationConfigurationsCommandInput, diff --git a/clients/client-auto-scaling/pagination/DescribePoliciesPaginator.ts b/clients/client-auto-scaling/pagination/DescribePoliciesPaginator.ts index e96e70972c110..5d45d508c4788 100644 --- a/clients/client-auto-scaling/pagination/DescribePoliciesPaginator.ts +++ b/clients/client-auto-scaling/pagination/DescribePoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { AutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AutoScalingClient, input: DescribePoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AutoScaling, input: DescribePoliciesCommandInput, diff --git a/clients/client-auto-scaling/pagination/DescribeScalingActivitiesPaginator.ts b/clients/client-auto-scaling/pagination/DescribeScalingActivitiesPaginator.ts index b5491885016e6..a234b7497e9dc 100644 --- a/clients/client-auto-scaling/pagination/DescribeScalingActivitiesPaginator.ts +++ b/clients/client-auto-scaling/pagination/DescribeScalingActivitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { AutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AutoScalingClient, input: DescribeScalingActivitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScalingActivitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AutoScaling, input: DescribeScalingActivitiesCommandInput, diff --git a/clients/client-auto-scaling/pagination/DescribeScheduledActionsPaginator.ts b/clients/client-auto-scaling/pagination/DescribeScheduledActionsPaginator.ts index 3de7f6d959438..dbd35518008ff 100644 --- a/clients/client-auto-scaling/pagination/DescribeScheduledActionsPaginator.ts +++ b/clients/client-auto-scaling/pagination/DescribeScheduledActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { AutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AutoScalingClient, input: DescribeScheduledActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScheduledActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AutoScaling, input: DescribeScheduledActionsCommandInput, diff --git a/clients/client-auto-scaling/pagination/DescribeTagsPaginator.ts b/clients/client-auto-scaling/pagination/DescribeTagsPaginator.ts index 8c28f12cdf975..d2f7e71738b87 100644 --- a/clients/client-auto-scaling/pagination/DescribeTagsPaginator.ts +++ b/clients/client-auto-scaling/pagination/DescribeTagsPaginator.ts @@ -8,6 +8,9 @@ import { import { AutoScalingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: AutoScalingClient, input: DescribeTagsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: AutoScaling, input: DescribeTagsCommandInput, diff --git a/clients/client-auto-scaling/runtimeConfig.browser.ts b/clients/client-auto-scaling/runtimeConfig.browser.ts index d72dffacf2b79..b87f784c4d096 100644 --- a/clients/client-auto-scaling/runtimeConfig.browser.ts +++ b/clients/client-auto-scaling/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./AutoScalingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-auto-scaling/runtimeConfig.native.ts b/clients/client-auto-scaling/runtimeConfig.native.ts index b3b3993bddce4..0b3e0d6849ef4 100644 --- a/clients/client-auto-scaling/runtimeConfig.native.ts +++ b/clients/client-auto-scaling/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./AutoScalingClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-auto-scaling/runtimeConfig.shared.ts b/clients/client-auto-scaling/runtimeConfig.shared.ts index adbf6c9508dc9..156f42719ef6f 100644 --- a/clients/client-auto-scaling/runtimeConfig.shared.ts +++ b/clients/client-auto-scaling/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2011-01-01", disableHostPrefix: false, diff --git a/clients/client-auto-scaling/runtimeConfig.ts b/clients/client-auto-scaling/runtimeConfig.ts index d73144c62759a..0ead5f163d7d4 100644 --- a/clients/client-auto-scaling/runtimeConfig.ts +++ b/clients/client-auto-scaling/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./AutoScalingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-auto-scaling/tsconfig.json b/clients/client-auto-scaling/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-auto-scaling/tsconfig.json +++ b/clients/client-auto-scaling/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-backup/commands/CreateBackupPlanCommand.ts b/clients/client-backup/commands/CreateBackupPlanCommand.ts index 09f29e788f683..6342698e9dca9 100644 --- a/clients/client-backup/commands/CreateBackupPlanCommand.ts +++ b/clients/client-backup/commands/CreateBackupPlanCommand.ts @@ -20,6 +20,12 @@ import { export type CreateBackupPlanCommandInput = CreateBackupPlanInput; export type CreateBackupPlanCommandOutput = CreateBackupPlanOutput & __MetadataBearer; +/** + *

Creates a backup plan using a backup plan name and backup rules. A backup plan is a + * document that contains information that AWS Backup uses to schedule tasks that create + * recovery points for resources.

+ *

If you call CreateBackupPlan with a plan that already exists, an AlreadyExistsException is returned.

+ */ export class CreateBackupPlanCommand extends $Command< CreateBackupPlanCommandInput, CreateBackupPlanCommandOutput, @@ -34,6 +40,9 @@ export class CreateBackupPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/CreateBackupSelectionCommand.ts b/clients/client-backup/commands/CreateBackupSelectionCommand.ts index 009db461c555b..5655b5dde0bd9 100644 --- a/clients/client-backup/commands/CreateBackupSelectionCommand.ts +++ b/clients/client-backup/commands/CreateBackupSelectionCommand.ts @@ -20,6 +20,48 @@ import { export type CreateBackupSelectionCommandInput = CreateBackupSelectionInput; export type CreateBackupSelectionCommandOutput = CreateBackupSelectionOutput & __MetadataBearer; +/** + *

Creates a JSON document that specifies a set of resources to assign to a backup plan. + * Resources can be included by specifying patterns for a ListOfTags and selected + * Resources.

+ *

For example, consider the following patterns:

+ *
    + *
  • + *

    + * Resources: "arn:aws:ec2:region:account-id:volume/volume-id" + *

    + *
  • + *
  • + *

    + * ConditionKey:"department" + *

    + *

    + * ConditionValue:"finance" + *

    + *

    + * ConditionType:"StringEquals" + *

    + *
  • + *
  • + *

    + * ConditionKey:"importance" + *

    + *

    + * ConditionValue:"critical" + *

    + *

    + * ConditionType:"StringEquals" + *

    + *
  • + *
+ *

Using these patterns would back up all Amazon Elastic Block Store (Amazon EBS) volumes + * that are tagged as "department=finance", "importance=critical", + * in addition to an EBS volume with the specified volume ID.

+ *

Resources and conditions are additive in that all resources that match the pattern are + * selected. This shouldn't be confused with a logical AND, where all conditions must match. + * The matching patterns are logically put together using the OR operator. + * In other words, all patterns that match are selected for backup.

+ */ export class CreateBackupSelectionCommand extends $Command< CreateBackupSelectionCommandInput, CreateBackupSelectionCommandOutput, @@ -34,6 +76,9 @@ export class CreateBackupSelectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/CreateBackupVaultCommand.ts b/clients/client-backup/commands/CreateBackupVaultCommand.ts index c05f551953b04..c6d2b380ec529 100644 --- a/clients/client-backup/commands/CreateBackupVaultCommand.ts +++ b/clients/client-backup/commands/CreateBackupVaultCommand.ts @@ -20,6 +20,15 @@ import { export type CreateBackupVaultCommandInput = CreateBackupVaultInput; export type CreateBackupVaultCommandOutput = CreateBackupVaultOutput & __MetadataBearer; +/** + *

Creates a logical container where backups are stored. A CreateBackupVault + * request includes a name, optionally one or more resource tags, an encryption key, and a + * request ID.

+ * + *

Sensitive data, such as passport numbers, should not be included the name of a backup + * vault.

+ *
+ */ export class CreateBackupVaultCommand extends $Command< CreateBackupVaultCommandInput, CreateBackupVaultCommandOutput, @@ -34,6 +43,9 @@ export class CreateBackupVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DeleteBackupPlanCommand.ts b/clients/client-backup/commands/DeleteBackupPlanCommand.ts index a7b5b3ec0c029..cb91db71e93b7 100644 --- a/clients/client-backup/commands/DeleteBackupPlanCommand.ts +++ b/clients/client-backup/commands/DeleteBackupPlanCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteBackupPlanCommandInput = DeleteBackupPlanInput; export type DeleteBackupPlanCommandOutput = DeleteBackupPlanOutput & __MetadataBearer; +/** + *

Deletes a backup plan. A backup plan can only be deleted after all associated selections + * of resources have been deleted. Deleting a backup plan deletes the current version of a + * backup plan. Previous versions, if any, will still exist.

+ */ export class DeleteBackupPlanCommand extends $Command< DeleteBackupPlanCommandInput, DeleteBackupPlanCommandOutput, @@ -34,6 +39,9 @@ export class DeleteBackupPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DeleteBackupSelectionCommand.ts b/clients/client-backup/commands/DeleteBackupSelectionCommand.ts index d9e2ed4aeb77b..1db0c0f28ec51 100644 --- a/clients/client-backup/commands/DeleteBackupSelectionCommand.ts +++ b/clients/client-backup/commands/DeleteBackupSelectionCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteBackupSelectionCommandInput = DeleteBackupSelectionInput; export type DeleteBackupSelectionCommandOutput = __MetadataBearer; +/** + *

Deletes the resource selection associated with a backup plan that is specified by the + * SelectionId.

+ */ export class DeleteBackupSelectionCommand extends $Command< DeleteBackupSelectionCommandInput, DeleteBackupSelectionCommandOutput, @@ -34,6 +38,9 @@ export class DeleteBackupSelectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DeleteBackupVaultAccessPolicyCommand.ts b/clients/client-backup/commands/DeleteBackupVaultAccessPolicyCommand.ts index d18ffacef5c48..b6ae0acad3eb0 100644 --- a/clients/client-backup/commands/DeleteBackupVaultAccessPolicyCommand.ts +++ b/clients/client-backup/commands/DeleteBackupVaultAccessPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBackupVaultAccessPolicyCommandInput = DeleteBackupVaultAccessPolicyInput; export type DeleteBackupVaultAccessPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the policy document that manages permissions on a backup vault.

+ */ export class DeleteBackupVaultAccessPolicyCommand extends $Command< DeleteBackupVaultAccessPolicyCommandInput, DeleteBackupVaultAccessPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBackupVaultAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DeleteBackupVaultCommand.ts b/clients/client-backup/commands/DeleteBackupVaultCommand.ts index 4e161057b50fb..7e45ec2d7ad09 100644 --- a/clients/client-backup/commands/DeleteBackupVaultCommand.ts +++ b/clients/client-backup/commands/DeleteBackupVaultCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteBackupVaultCommandInput = DeleteBackupVaultInput; export type DeleteBackupVaultCommandOutput = __MetadataBearer; +/** + *

Deletes the backup vault identified by its name. A vault can be deleted only if it is + * empty.

+ */ export class DeleteBackupVaultCommand extends $Command< DeleteBackupVaultCommandInput, DeleteBackupVaultCommandOutput, @@ -34,6 +38,9 @@ export class DeleteBackupVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DeleteBackupVaultNotificationsCommand.ts b/clients/client-backup/commands/DeleteBackupVaultNotificationsCommand.ts index afdc94bf5ed93..b1f2bca5278b7 100644 --- a/clients/client-backup/commands/DeleteBackupVaultNotificationsCommand.ts +++ b/clients/client-backup/commands/DeleteBackupVaultNotificationsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBackupVaultNotificationsCommandInput = DeleteBackupVaultNotificationsInput; export type DeleteBackupVaultNotificationsCommandOutput = __MetadataBearer; +/** + *

Deletes event notifications for the specified backup vault.

+ */ export class DeleteBackupVaultNotificationsCommand extends $Command< DeleteBackupVaultNotificationsCommandInput, DeleteBackupVaultNotificationsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBackupVaultNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DeleteRecoveryPointCommand.ts b/clients/client-backup/commands/DeleteRecoveryPointCommand.ts index afd36e49f97a4..55a6d94aa862f 100644 --- a/clients/client-backup/commands/DeleteRecoveryPointCommand.ts +++ b/clients/client-backup/commands/DeleteRecoveryPointCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRecoveryPointCommandInput = DeleteRecoveryPointInput; export type DeleteRecoveryPointCommandOutput = __MetadataBearer; +/** + *

Deletes the recovery point specified by a recovery point ID.

+ */ export class DeleteRecoveryPointCommand extends $Command< DeleteRecoveryPointCommandInput, DeleteRecoveryPointCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRecoveryPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DescribeBackupJobCommand.ts b/clients/client-backup/commands/DescribeBackupJobCommand.ts index 4bff2f9275c70..230ce6dcd7887 100644 --- a/clients/client-backup/commands/DescribeBackupJobCommand.ts +++ b/clients/client-backup/commands/DescribeBackupJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBackupJobCommandInput = DescribeBackupJobInput; export type DescribeBackupJobCommandOutput = DescribeBackupJobOutput & __MetadataBearer; +/** + *

Returns backup job details for the specified BackupJobId.

+ */ export class DescribeBackupJobCommand extends $Command< DescribeBackupJobCommandInput, DescribeBackupJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBackupJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DescribeBackupVaultCommand.ts b/clients/client-backup/commands/DescribeBackupVaultCommand.ts index e5d40c768ae3e..a95ce8bc6ff3c 100644 --- a/clients/client-backup/commands/DescribeBackupVaultCommand.ts +++ b/clients/client-backup/commands/DescribeBackupVaultCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBackupVaultCommandInput = DescribeBackupVaultInput; export type DescribeBackupVaultCommandOutput = DescribeBackupVaultOutput & __MetadataBearer; +/** + *

Returns metadata about a backup vault specified by its name.

+ */ export class DescribeBackupVaultCommand extends $Command< DescribeBackupVaultCommandInput, DescribeBackupVaultCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBackupVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DescribeCopyJobCommand.ts b/clients/client-backup/commands/DescribeCopyJobCommand.ts index e80467068ffc6..afaefca2b89ef 100644 --- a/clients/client-backup/commands/DescribeCopyJobCommand.ts +++ b/clients/client-backup/commands/DescribeCopyJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCopyJobCommandInput = DescribeCopyJobInput; export type DescribeCopyJobCommandOutput = DescribeCopyJobOutput & __MetadataBearer; +/** + *

Returns metadata associated with creating a copy of a resource.

+ */ export class DescribeCopyJobCommand extends $Command< DescribeCopyJobCommandInput, DescribeCopyJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCopyJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DescribeGlobalSettingsCommand.ts b/clients/client-backup/commands/DescribeGlobalSettingsCommand.ts index e8d628ebdd289..8e21caabc6915 100644 --- a/clients/client-backup/commands/DescribeGlobalSettingsCommand.ts +++ b/clients/client-backup/commands/DescribeGlobalSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeGlobalSettingsCommandInput = DescribeGlobalSettingsInput; export type DescribeGlobalSettingsCommandOutput = DescribeGlobalSettingsOutput & __MetadataBearer; +/** + *

The current feature settings for the AWS Account.

+ */ export class DescribeGlobalSettingsCommand extends $Command< DescribeGlobalSettingsCommandInput, DescribeGlobalSettingsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeGlobalSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DescribeProtectedResourceCommand.ts b/clients/client-backup/commands/DescribeProtectedResourceCommand.ts index 69ed209448a06..656ce0f40b54a 100644 --- a/clients/client-backup/commands/DescribeProtectedResourceCommand.ts +++ b/clients/client-backup/commands/DescribeProtectedResourceCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeProtectedResourceCommandInput = DescribeProtectedResourceInput; export type DescribeProtectedResourceCommandOutput = DescribeProtectedResourceOutput & __MetadataBearer; +/** + *

Returns information about a saved resource, including the last time it was backed up, + * its Amazon Resource Name (ARN), and the AWS service type of the saved resource.

+ */ export class DescribeProtectedResourceCommand extends $Command< DescribeProtectedResourceCommandInput, DescribeProtectedResourceCommandOutput, @@ -34,6 +38,9 @@ export class DescribeProtectedResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DescribeRecoveryPointCommand.ts b/clients/client-backup/commands/DescribeRecoveryPointCommand.ts index 5591f38e34507..24c505ad418ac 100644 --- a/clients/client-backup/commands/DescribeRecoveryPointCommand.ts +++ b/clients/client-backup/commands/DescribeRecoveryPointCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeRecoveryPointCommandInput = DescribeRecoveryPointInput; export type DescribeRecoveryPointCommandOutput = DescribeRecoveryPointOutput & __MetadataBearer; +/** + *

Returns metadata associated with a recovery point, including ID, status, encryption, and + * lifecycle.

+ */ export class DescribeRecoveryPointCommand extends $Command< DescribeRecoveryPointCommandInput, DescribeRecoveryPointCommandOutput, @@ -34,6 +38,9 @@ export class DescribeRecoveryPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DescribeRegionSettingsCommand.ts b/clients/client-backup/commands/DescribeRegionSettingsCommand.ts index 2b1e03444642c..9326ab565d2e2 100644 --- a/clients/client-backup/commands/DescribeRegionSettingsCommand.ts +++ b/clients/client-backup/commands/DescribeRegionSettingsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeRegionSettingsCommandInput = DescribeRegionSettingsInput; export type DescribeRegionSettingsCommandOutput = DescribeRegionSettingsOutput & __MetadataBearer; +/** + *

Returns the current service opt-in settings for the Region. If service-opt-in is enabled for a service, + * AWS Backup tries to protect that service's resources in this Region, when the resource is included in an on-demand backup or scheduled backup plan. + * Otherwise, AWS Backup does not try to protect that service's resources in this Region, AWS Backup does not try to protect that service's + * resources in this Region.

+ */ export class DescribeRegionSettingsCommand extends $Command< DescribeRegionSettingsCommandInput, DescribeRegionSettingsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeRegionSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/DescribeRestoreJobCommand.ts b/clients/client-backup/commands/DescribeRestoreJobCommand.ts index 63405e18b1299..0a8155d826bff 100644 --- a/clients/client-backup/commands/DescribeRestoreJobCommand.ts +++ b/clients/client-backup/commands/DescribeRestoreJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRestoreJobCommandInput = DescribeRestoreJobInput; export type DescribeRestoreJobCommandOutput = DescribeRestoreJobOutput & __MetadataBearer; +/** + *

Returns metadata associated with a restore job that is specified by a job ID.

+ */ export class DescribeRestoreJobCommand extends $Command< DescribeRestoreJobCommandInput, DescribeRestoreJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRestoreJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ExportBackupPlanTemplateCommand.ts b/clients/client-backup/commands/ExportBackupPlanTemplateCommand.ts index a34b1af1e3c00..dc65c1a78d701 100644 --- a/clients/client-backup/commands/ExportBackupPlanTemplateCommand.ts +++ b/clients/client-backup/commands/ExportBackupPlanTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type ExportBackupPlanTemplateCommandInput = ExportBackupPlanTemplateInput; export type ExportBackupPlanTemplateCommandOutput = ExportBackupPlanTemplateOutput & __MetadataBearer; +/** + *

Returns the backup plan that is specified by the plan ID as a backup template.

+ */ export class ExportBackupPlanTemplateCommand extends $Command< ExportBackupPlanTemplateCommandInput, ExportBackupPlanTemplateCommandOutput, @@ -34,6 +37,9 @@ export class ExportBackupPlanTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/GetBackupPlanCommand.ts b/clients/client-backup/commands/GetBackupPlanCommand.ts index e43d03a29e6ea..b365d10e917b6 100644 --- a/clients/client-backup/commands/GetBackupPlanCommand.ts +++ b/clients/client-backup/commands/GetBackupPlanCommand.ts @@ -20,6 +20,11 @@ import { export type GetBackupPlanCommandInput = GetBackupPlanInput; export type GetBackupPlanCommandOutput = GetBackupPlanOutput & __MetadataBearer; +/** + *

Returns BackupPlan details for the specified BackupPlanId. + * Returns the body of a + * backup plan in JSON format, in addition to plan metadata.

+ */ export class GetBackupPlanCommand extends $Command< GetBackupPlanCommandInput, GetBackupPlanCommandOutput, @@ -34,6 +39,9 @@ export class GetBackupPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/GetBackupPlanFromJSONCommand.ts b/clients/client-backup/commands/GetBackupPlanFromJSONCommand.ts index 910411a6a763d..c20cadd88dd9b 100644 --- a/clients/client-backup/commands/GetBackupPlanFromJSONCommand.ts +++ b/clients/client-backup/commands/GetBackupPlanFromJSONCommand.ts @@ -20,6 +20,9 @@ import { export type GetBackupPlanFromJSONCommandInput = GetBackupPlanFromJSONInput; export type GetBackupPlanFromJSONCommandOutput = GetBackupPlanFromJSONOutput & __MetadataBearer; +/** + *

Returns a valid JSON document specifying a backup plan or an error.

+ */ export class GetBackupPlanFromJSONCommand extends $Command< GetBackupPlanFromJSONCommandInput, GetBackupPlanFromJSONCommandOutput, @@ -34,6 +37,9 @@ export class GetBackupPlanFromJSONCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/GetBackupPlanFromTemplateCommand.ts b/clients/client-backup/commands/GetBackupPlanFromTemplateCommand.ts index 7575f41f1cc75..c46516645008a 100644 --- a/clients/client-backup/commands/GetBackupPlanFromTemplateCommand.ts +++ b/clients/client-backup/commands/GetBackupPlanFromTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetBackupPlanFromTemplateCommandInput = GetBackupPlanFromTemplateInput; export type GetBackupPlanFromTemplateCommandOutput = GetBackupPlanFromTemplateOutput & __MetadataBearer; +/** + *

Returns the template specified by its templateId as a backup plan.

+ */ export class GetBackupPlanFromTemplateCommand extends $Command< GetBackupPlanFromTemplateCommandInput, GetBackupPlanFromTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetBackupPlanFromTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/GetBackupSelectionCommand.ts b/clients/client-backup/commands/GetBackupSelectionCommand.ts index cf297315574eb..fe8eaed2f2287 100644 --- a/clients/client-backup/commands/GetBackupSelectionCommand.ts +++ b/clients/client-backup/commands/GetBackupSelectionCommand.ts @@ -20,6 +20,10 @@ import { export type GetBackupSelectionCommandInput = GetBackupSelectionInput; export type GetBackupSelectionCommandOutput = GetBackupSelectionOutput & __MetadataBearer; +/** + *

Returns selection metadata and a document in JSON format that specifies a list of + * resources that are associated with a backup plan.

+ */ export class GetBackupSelectionCommand extends $Command< GetBackupSelectionCommandInput, GetBackupSelectionCommandOutput, @@ -34,6 +38,9 @@ export class GetBackupSelectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/GetBackupVaultAccessPolicyCommand.ts b/clients/client-backup/commands/GetBackupVaultAccessPolicyCommand.ts index cd3f76b770004..1be883c7bb697 100644 --- a/clients/client-backup/commands/GetBackupVaultAccessPolicyCommand.ts +++ b/clients/client-backup/commands/GetBackupVaultAccessPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type GetBackupVaultAccessPolicyCommandInput = GetBackupVaultAccessPolicyInput; export type GetBackupVaultAccessPolicyCommandOutput = GetBackupVaultAccessPolicyOutput & __MetadataBearer; +/** + *

Returns the access policy document that is associated with the named backup + * vault.

+ */ export class GetBackupVaultAccessPolicyCommand extends $Command< GetBackupVaultAccessPolicyCommandInput, GetBackupVaultAccessPolicyCommandOutput, @@ -34,6 +38,9 @@ export class GetBackupVaultAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/GetBackupVaultNotificationsCommand.ts b/clients/client-backup/commands/GetBackupVaultNotificationsCommand.ts index 96fe44acdd11d..a9fbdcd1d8979 100644 --- a/clients/client-backup/commands/GetBackupVaultNotificationsCommand.ts +++ b/clients/client-backup/commands/GetBackupVaultNotificationsCommand.ts @@ -20,6 +20,9 @@ import { export type GetBackupVaultNotificationsCommandInput = GetBackupVaultNotificationsInput; export type GetBackupVaultNotificationsCommandOutput = GetBackupVaultNotificationsOutput & __MetadataBearer; +/** + *

Returns event notifications for the specified backup vault.

+ */ export class GetBackupVaultNotificationsCommand extends $Command< GetBackupVaultNotificationsCommandInput, GetBackupVaultNotificationsCommandOutput, @@ -34,6 +37,9 @@ export class GetBackupVaultNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/GetRecoveryPointRestoreMetadataCommand.ts b/clients/client-backup/commands/GetRecoveryPointRestoreMetadataCommand.ts index 3adb7fad2d414..08f08b3a2a84f 100644 --- a/clients/client-backup/commands/GetRecoveryPointRestoreMetadataCommand.ts +++ b/clients/client-backup/commands/GetRecoveryPointRestoreMetadataCommand.ts @@ -20,6 +20,9 @@ import { export type GetRecoveryPointRestoreMetadataCommandInput = GetRecoveryPointRestoreMetadataInput; export type GetRecoveryPointRestoreMetadataCommandOutput = GetRecoveryPointRestoreMetadataOutput & __MetadataBearer; +/** + *

Returns a set of metadata key-value pairs that were used to create the backup.

+ */ export class GetRecoveryPointRestoreMetadataCommand extends $Command< GetRecoveryPointRestoreMetadataCommandInput, GetRecoveryPointRestoreMetadataCommandOutput, @@ -34,6 +37,9 @@ export class GetRecoveryPointRestoreMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/GetSupportedResourceTypesCommand.ts b/clients/client-backup/commands/GetSupportedResourceTypesCommand.ts index 7fd2878bba93a..2244b9b36e67b 100644 --- a/clients/client-backup/commands/GetSupportedResourceTypesCommand.ts +++ b/clients/client-backup/commands/GetSupportedResourceTypesCommand.ts @@ -20,6 +20,9 @@ import { export type GetSupportedResourceTypesCommandInput = {}; export type GetSupportedResourceTypesCommandOutput = GetSupportedResourceTypesOutput & __MetadataBearer; +/** + *

Returns the AWS resource types supported by AWS Backup.

+ */ export class GetSupportedResourceTypesCommand extends $Command< GetSupportedResourceTypesCommandInput, GetSupportedResourceTypesCommandOutput, @@ -34,6 +37,9 @@ export class GetSupportedResourceTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListBackupJobsCommand.ts b/clients/client-backup/commands/ListBackupJobsCommand.ts index 9b56c62e51dd2..4b8dcf03f50fb 100644 --- a/clients/client-backup/commands/ListBackupJobsCommand.ts +++ b/clients/client-backup/commands/ListBackupJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListBackupJobsCommandInput = ListBackupJobsInput; export type ListBackupJobsCommandOutput = ListBackupJobsOutput & __MetadataBearer; +/** + *

Returns a list of existing backup jobs for an authenticated account.

+ */ export class ListBackupJobsCommand extends $Command< ListBackupJobsCommandInput, ListBackupJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListBackupJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListBackupPlanTemplatesCommand.ts b/clients/client-backup/commands/ListBackupPlanTemplatesCommand.ts index a9c716d907fd2..110dc77e49f03 100644 --- a/clients/client-backup/commands/ListBackupPlanTemplatesCommand.ts +++ b/clients/client-backup/commands/ListBackupPlanTemplatesCommand.ts @@ -20,6 +20,10 @@ import { export type ListBackupPlanTemplatesCommandInput = ListBackupPlanTemplatesInput; export type ListBackupPlanTemplatesCommandOutput = ListBackupPlanTemplatesOutput & __MetadataBearer; +/** + *

Returns metadata of your saved backup plan templates, including the template ID, name, + * and the creation and deletion dates.

+ */ export class ListBackupPlanTemplatesCommand extends $Command< ListBackupPlanTemplatesCommandInput, ListBackupPlanTemplatesCommandOutput, @@ -34,6 +38,9 @@ export class ListBackupPlanTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListBackupPlanVersionsCommand.ts b/clients/client-backup/commands/ListBackupPlanVersionsCommand.ts index 7f4eeff9b6f35..008233b011882 100644 --- a/clients/client-backup/commands/ListBackupPlanVersionsCommand.ts +++ b/clients/client-backup/commands/ListBackupPlanVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListBackupPlanVersionsCommandInput = ListBackupPlanVersionsInput; export type ListBackupPlanVersionsCommandOutput = ListBackupPlanVersionsOutput & __MetadataBearer; +/** + *

Returns version metadata of your backup plans, including Amazon Resource Names (ARNs), + * backup plan IDs, creation and deletion dates, plan names, and version IDs.

+ */ export class ListBackupPlanVersionsCommand extends $Command< ListBackupPlanVersionsCommandInput, ListBackupPlanVersionsCommandOutput, @@ -34,6 +38,9 @@ export class ListBackupPlanVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListBackupPlansCommand.ts b/clients/client-backup/commands/ListBackupPlansCommand.ts index fc0d327f3b3a6..1f2c1e846174c 100644 --- a/clients/client-backup/commands/ListBackupPlansCommand.ts +++ b/clients/client-backup/commands/ListBackupPlansCommand.ts @@ -20,6 +20,12 @@ import { export type ListBackupPlansCommandInput = ListBackupPlansInput; export type ListBackupPlansCommandOutput = ListBackupPlansOutput & __MetadataBearer; +/** + *

Returns a list of existing backup plans for an authenticated account. The list is + * populated only if the advanced option is set for the backup plan. The list contains + * information such as Amazon Resource Names (ARNs), plan IDs, creation and deletion dates, + * version IDs, plan names, and creator request IDs.

+ */ export class ListBackupPlansCommand extends $Command< ListBackupPlansCommandInput, ListBackupPlansCommandOutput, @@ -34,6 +40,9 @@ export class ListBackupPlansCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListBackupSelectionsCommand.ts b/clients/client-backup/commands/ListBackupSelectionsCommand.ts index 2d3ad894ac7bc..87f73ba405329 100644 --- a/clients/client-backup/commands/ListBackupSelectionsCommand.ts +++ b/clients/client-backup/commands/ListBackupSelectionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListBackupSelectionsCommandInput = ListBackupSelectionsInput; export type ListBackupSelectionsCommandOutput = ListBackupSelectionsOutput & __MetadataBearer; +/** + *

Returns an array containing metadata of the resources associated with the target backup + * plan.

+ */ export class ListBackupSelectionsCommand extends $Command< ListBackupSelectionsCommandInput, ListBackupSelectionsCommandOutput, @@ -34,6 +38,9 @@ export class ListBackupSelectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListBackupVaultsCommand.ts b/clients/client-backup/commands/ListBackupVaultsCommand.ts index 35bd5680a8d41..8a6a96a5999ae 100644 --- a/clients/client-backup/commands/ListBackupVaultsCommand.ts +++ b/clients/client-backup/commands/ListBackupVaultsCommand.ts @@ -20,6 +20,10 @@ import { export type ListBackupVaultsCommandInput = ListBackupVaultsInput; export type ListBackupVaultsCommandOutput = ListBackupVaultsOutput & __MetadataBearer; +/** + *

Returns a list of recovery point storage containers along with information about + * them.

+ */ export class ListBackupVaultsCommand extends $Command< ListBackupVaultsCommandInput, ListBackupVaultsCommandOutput, @@ -34,6 +38,9 @@ export class ListBackupVaultsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListCopyJobsCommand.ts b/clients/client-backup/commands/ListCopyJobsCommand.ts index ffc87ed481086..bc1cae1a110ef 100644 --- a/clients/client-backup/commands/ListCopyJobsCommand.ts +++ b/clients/client-backup/commands/ListCopyJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListCopyJobsCommandInput = ListCopyJobsInput; export type ListCopyJobsCommandOutput = ListCopyJobsOutput & __MetadataBearer; +/** + *

Returns metadata about your copy jobs.

+ */ export class ListCopyJobsCommand extends $Command< ListCopyJobsCommandInput, ListCopyJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListCopyJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListProtectedResourcesCommand.ts b/clients/client-backup/commands/ListProtectedResourcesCommand.ts index 6ac0a2b69d617..2eac3110eefad 100644 --- a/clients/client-backup/commands/ListProtectedResourcesCommand.ts +++ b/clients/client-backup/commands/ListProtectedResourcesCommand.ts @@ -20,6 +20,11 @@ import { export type ListProtectedResourcesCommandInput = ListProtectedResourcesInput; export type ListProtectedResourcesCommandOutput = ListProtectedResourcesOutput & __MetadataBearer; +/** + *

Returns an array of resources successfully backed up by AWS Backup, including the time + * the resource was saved, an Amazon Resource Name (ARN) of the resource, and a resource + * type.

+ */ export class ListProtectedResourcesCommand extends $Command< ListProtectedResourcesCommandInput, ListProtectedResourcesCommandOutput, @@ -34,6 +39,9 @@ export class ListProtectedResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListRecoveryPointsByBackupVaultCommand.ts b/clients/client-backup/commands/ListRecoveryPointsByBackupVaultCommand.ts index 25c9f1cd20706..12c2b04df491a 100644 --- a/clients/client-backup/commands/ListRecoveryPointsByBackupVaultCommand.ts +++ b/clients/client-backup/commands/ListRecoveryPointsByBackupVaultCommand.ts @@ -20,6 +20,9 @@ import { export type ListRecoveryPointsByBackupVaultCommandInput = ListRecoveryPointsByBackupVaultInput; export type ListRecoveryPointsByBackupVaultCommandOutput = ListRecoveryPointsByBackupVaultOutput & __MetadataBearer; +/** + *

Returns detailed information about the recovery points stored in a backup vault.

+ */ export class ListRecoveryPointsByBackupVaultCommand extends $Command< ListRecoveryPointsByBackupVaultCommandInput, ListRecoveryPointsByBackupVaultCommandOutput, @@ -34,6 +37,9 @@ export class ListRecoveryPointsByBackupVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListRecoveryPointsByResourceCommand.ts b/clients/client-backup/commands/ListRecoveryPointsByResourceCommand.ts index 7a59c27af44a5..72a7784cfe71f 100644 --- a/clients/client-backup/commands/ListRecoveryPointsByResourceCommand.ts +++ b/clients/client-backup/commands/ListRecoveryPointsByResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListRecoveryPointsByResourceCommandInput = ListRecoveryPointsByResourceInput; export type ListRecoveryPointsByResourceCommandOutput = ListRecoveryPointsByResourceOutput & __MetadataBearer; +/** + *

Returns detailed information about recovery points of the type specified by a resource + * Amazon Resource Name (ARN).

+ */ export class ListRecoveryPointsByResourceCommand extends $Command< ListRecoveryPointsByResourceCommandInput, ListRecoveryPointsByResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListRecoveryPointsByResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListRestoreJobsCommand.ts b/clients/client-backup/commands/ListRestoreJobsCommand.ts index ee6d3326c8fe3..b075ffc221006 100644 --- a/clients/client-backup/commands/ListRestoreJobsCommand.ts +++ b/clients/client-backup/commands/ListRestoreJobsCommand.ts @@ -20,6 +20,10 @@ import { export type ListRestoreJobsCommandInput = ListRestoreJobsInput; export type ListRestoreJobsCommandOutput = ListRestoreJobsOutput & __MetadataBearer; +/** + *

Returns a list of jobs that AWS Backup initiated to restore a saved resource, including + * metadata about the recovery process.

+ */ export class ListRestoreJobsCommand extends $Command< ListRestoreJobsCommandInput, ListRestoreJobsCommandOutput, @@ -34,6 +38,9 @@ export class ListRestoreJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/ListTagsCommand.ts b/clients/client-backup/commands/ListTagsCommand.ts index 28b2a867eebdd..8959c97fe0e44 100644 --- a/clients/client-backup/commands/ListTagsCommand.ts +++ b/clients/client-backup/commands/ListTagsCommand.ts @@ -20,6 +20,14 @@ import { export type ListTagsCommandInput = ListTagsInput; export type ListTagsCommandOutput = ListTagsOutput & __MetadataBearer; +/** + *

Returns a list of key-value pairs assigned to a target recovery point, backup plan, or + * backup vault.

+ * + *

+ * ListTags are currently only supported with Amazon EFS backups.

+ *
+ */ export class ListTagsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +38,9 @@ export class ListTagsCommand extends $Command, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/PutBackupVaultAccessPolicyCommand.ts b/clients/client-backup/commands/PutBackupVaultAccessPolicyCommand.ts index 30c4c2777ff61..3f91a9ca216e8 100644 --- a/clients/client-backup/commands/PutBackupVaultAccessPolicyCommand.ts +++ b/clients/client-backup/commands/PutBackupVaultAccessPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutBackupVaultAccessPolicyCommandInput = PutBackupVaultAccessPolicyInput; export type PutBackupVaultAccessPolicyCommandOutput = __MetadataBearer; +/** + *

Sets a resource-based policy that is used to manage access permissions on the target + * backup vault. Requires a backup vault name and an access policy document in JSON + * format.

+ */ export class PutBackupVaultAccessPolicyCommand extends $Command< PutBackupVaultAccessPolicyCommandInput, PutBackupVaultAccessPolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutBackupVaultAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/PutBackupVaultNotificationsCommand.ts b/clients/client-backup/commands/PutBackupVaultNotificationsCommand.ts index ad8e253c74962..e1c4bdea94fe2 100644 --- a/clients/client-backup/commands/PutBackupVaultNotificationsCommand.ts +++ b/clients/client-backup/commands/PutBackupVaultNotificationsCommand.ts @@ -20,6 +20,9 @@ import { export type PutBackupVaultNotificationsCommandInput = PutBackupVaultNotificationsInput; export type PutBackupVaultNotificationsCommandOutput = __MetadataBearer; +/** + *

Turns on notifications on a backup vault for the specified topic and events.

+ */ export class PutBackupVaultNotificationsCommand extends $Command< PutBackupVaultNotificationsCommandInput, PutBackupVaultNotificationsCommandOutput, @@ -34,6 +37,9 @@ export class PutBackupVaultNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/StartBackupJobCommand.ts b/clients/client-backup/commands/StartBackupJobCommand.ts index b264bf8110a3c..451fad29f59d8 100644 --- a/clients/client-backup/commands/StartBackupJobCommand.ts +++ b/clients/client-backup/commands/StartBackupJobCommand.ts @@ -20,6 +20,9 @@ import { export type StartBackupJobCommandInput = StartBackupJobInput; export type StartBackupJobCommandOutput = StartBackupJobOutput & __MetadataBearer; +/** + *

Starts an on-demand backup job for the specified resource.

+ */ export class StartBackupJobCommand extends $Command< StartBackupJobCommandInput, StartBackupJobCommandOutput, @@ -34,6 +37,9 @@ export class StartBackupJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/StartCopyJobCommand.ts b/clients/client-backup/commands/StartCopyJobCommand.ts index 1a58d4c33b554..a31fa85ad4dbe 100644 --- a/clients/client-backup/commands/StartCopyJobCommand.ts +++ b/clients/client-backup/commands/StartCopyJobCommand.ts @@ -20,6 +20,9 @@ import { export type StartCopyJobCommandInput = StartCopyJobInput; export type StartCopyJobCommandOutput = StartCopyJobOutput & __MetadataBearer; +/** + *

Starts a job to create a one-time copy of the specified resource.

+ */ export class StartCopyJobCommand extends $Command< StartCopyJobCommandInput, StartCopyJobCommandOutput, @@ -34,6 +37,9 @@ export class StartCopyJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/StartRestoreJobCommand.ts b/clients/client-backup/commands/StartRestoreJobCommand.ts index a520201614a45..316e57847f8bc 100644 --- a/clients/client-backup/commands/StartRestoreJobCommand.ts +++ b/clients/client-backup/commands/StartRestoreJobCommand.ts @@ -20,6 +20,9 @@ import { export type StartRestoreJobCommandInput = StartRestoreJobInput; export type StartRestoreJobCommandOutput = StartRestoreJobOutput & __MetadataBearer; +/** + *

Recovers the saved resource identified by an Amazon Resource Name (ARN).

+ */ export class StartRestoreJobCommand extends $Command< StartRestoreJobCommandInput, StartRestoreJobCommandOutput, @@ -34,6 +37,9 @@ export class StartRestoreJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/StopBackupJobCommand.ts b/clients/client-backup/commands/StopBackupJobCommand.ts index f5e3fc7ca6421..d63527c6a5a7b 100644 --- a/clients/client-backup/commands/StopBackupJobCommand.ts +++ b/clients/client-backup/commands/StopBackupJobCommand.ts @@ -20,6 +20,9 @@ import { export type StopBackupJobCommandInput = StopBackupJobInput; export type StopBackupJobCommandOutput = __MetadataBearer; +/** + *

Attempts to cancel a job to create a one-time backup of a resource.

+ */ export class StopBackupJobCommand extends $Command< StopBackupJobCommandInput, StopBackupJobCommandOutput, @@ -34,6 +37,9 @@ export class StopBackupJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/TagResourceCommand.ts b/clients/client-backup/commands/TagResourceCommand.ts index a5c1425f6c5e5..5d40c9fb2b0ab 100644 --- a/clients/client-backup/commands/TagResourceCommand.ts +++ b/clients/client-backup/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Assigns a set of key-value pairs to a recovery point, backup plan, or backup vault + * identified by an Amazon Resource Name (ARN).

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/UntagResourceCommand.ts b/clients/client-backup/commands/UntagResourceCommand.ts index 75271eed99536..5f9359c18f5a0 100644 --- a/clients/client-backup/commands/UntagResourceCommand.ts +++ b/clients/client-backup/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes a set of key-value pairs from a recovery point, backup plan, or backup vault + * identified by an Amazon Resource Name (ARN)

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/UpdateBackupPlanCommand.ts b/clients/client-backup/commands/UpdateBackupPlanCommand.ts index f89b1e78f88e4..9f6d587282b68 100644 --- a/clients/client-backup/commands/UpdateBackupPlanCommand.ts +++ b/clients/client-backup/commands/UpdateBackupPlanCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateBackupPlanCommandInput = UpdateBackupPlanInput; export type UpdateBackupPlanCommandOutput = UpdateBackupPlanOutput & __MetadataBearer; +/** + *

Updates an existing backup plan identified by its backupPlanId + * with the input document in JSON format. The new version is uniquely identified by a + * VersionId.

+ */ export class UpdateBackupPlanCommand extends $Command< UpdateBackupPlanCommandInput, UpdateBackupPlanCommandOutput, @@ -34,6 +39,9 @@ export class UpdateBackupPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/UpdateGlobalSettingsCommand.ts b/clients/client-backup/commands/UpdateGlobalSettingsCommand.ts index bd6eadfd2784a..6a42ce5b37be5 100644 --- a/clients/client-backup/commands/UpdateGlobalSettingsCommand.ts +++ b/clients/client-backup/commands/UpdateGlobalSettingsCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateGlobalSettingsCommandInput = UpdateGlobalSettingsInput; export type UpdateGlobalSettingsCommandOutput = __MetadataBearer; +/** + *

Updates the current global settings for the AWS Account. Use the + * DescribeGlobalSettings API to determine the current settings.

+ */ export class UpdateGlobalSettingsCommand extends $Command< UpdateGlobalSettingsCommandInput, UpdateGlobalSettingsCommandOutput, @@ -34,6 +38,9 @@ export class UpdateGlobalSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/UpdateRecoveryPointLifecycleCommand.ts b/clients/client-backup/commands/UpdateRecoveryPointLifecycleCommand.ts index a1cf06eb9223b..75059931c75f5 100644 --- a/clients/client-backup/commands/UpdateRecoveryPointLifecycleCommand.ts +++ b/clients/client-backup/commands/UpdateRecoveryPointLifecycleCommand.ts @@ -20,6 +20,16 @@ import { export type UpdateRecoveryPointLifecycleCommandInput = UpdateRecoveryPointLifecycleInput; export type UpdateRecoveryPointLifecycleCommandOutput = UpdateRecoveryPointLifecycleOutput & __MetadataBearer; +/** + *

Sets the transition lifecycle of a recovery point.

+ *

The lifecycle defines when a protected resource is transitioned to cold storage and when + * it expires. AWS Backup transitions and expires backups automatically according to the + * lifecycle that you define.

+ *

Backups transitioned to cold storage must be stored in cold storage for a minimum of 90 + * days. Therefore, the “expire after days” setting must be 90 days greater than the + * “transition to cold after days” setting. The “transition to cold after days” setting cannot + * be changed after a backup has been transitioned to cold.

+ */ export class UpdateRecoveryPointLifecycleCommand extends $Command< UpdateRecoveryPointLifecycleCommandInput, UpdateRecoveryPointLifecycleCommandOutput, @@ -34,6 +44,9 @@ export class UpdateRecoveryPointLifecycleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/commands/UpdateRegionSettingsCommand.ts b/clients/client-backup/commands/UpdateRegionSettingsCommand.ts index 38ae942ca4f1e..a58f3d5bea7be 100644 --- a/clients/client-backup/commands/UpdateRegionSettingsCommand.ts +++ b/clients/client-backup/commands/UpdateRegionSettingsCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateRegionSettingsCommandInput = UpdateRegionSettingsInput; export type UpdateRegionSettingsCommandOutput = __MetadataBearer; +/** + *

Updates the current service opt-in settings for the Region. If service-opt-in is enabled for a service, + * AWS Backup tries to protect that service's resources in this Region, when the resource is included in an on-demand backup or scheduled backup plan. + * Otherwise, AWS Backup does not try to protect that service's resources in this Region. Use the DescribeRegionSettings API to determine the + * resource types that are supported.

+ */ export class UpdateRegionSettingsCommand extends $Command< UpdateRegionSettingsCommandInput, UpdateRegionSettingsCommandOutput, @@ -34,6 +40,9 @@ export class UpdateRegionSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BackupClientResolvedConfig, diff --git a/clients/client-backup/package.json b/clients/client-backup/package.json index 11239baf26e27..cc151e00ecf03 100644 --- a/clients/client-backup/package.json +++ b/clients/client-backup/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Backup Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-backup/pagination/ListBackupJobsPaginator.ts b/clients/client-backup/pagination/ListBackupJobsPaginator.ts index 6f8882416f673..617c14e1d2771 100644 --- a/clients/client-backup/pagination/ListBackupJobsPaginator.ts +++ b/clients/client-backup/pagination/ListBackupJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListBackupJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBackupJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListBackupJobsCommandInput, diff --git a/clients/client-backup/pagination/ListBackupPlanTemplatesPaginator.ts b/clients/client-backup/pagination/ListBackupPlanTemplatesPaginator.ts index fd151e9bb6845..0164b88f0b6f0 100644 --- a/clients/client-backup/pagination/ListBackupPlanTemplatesPaginator.ts +++ b/clients/client-backup/pagination/ListBackupPlanTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListBackupPlanTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBackupPlanTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListBackupPlanTemplatesCommandInput, diff --git a/clients/client-backup/pagination/ListBackupPlanVersionsPaginator.ts b/clients/client-backup/pagination/ListBackupPlanVersionsPaginator.ts index b440975d5bd18..f51f9d2ff0dca 100644 --- a/clients/client-backup/pagination/ListBackupPlanVersionsPaginator.ts +++ b/clients/client-backup/pagination/ListBackupPlanVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListBackupPlanVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBackupPlanVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListBackupPlanVersionsCommandInput, diff --git a/clients/client-backup/pagination/ListBackupPlansPaginator.ts b/clients/client-backup/pagination/ListBackupPlansPaginator.ts index 0b0cae90ab9ab..f6b0634e4d621 100644 --- a/clients/client-backup/pagination/ListBackupPlansPaginator.ts +++ b/clients/client-backup/pagination/ListBackupPlansPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListBackupPlansCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBackupPlansCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListBackupPlansCommandInput, diff --git a/clients/client-backup/pagination/ListBackupSelectionsPaginator.ts b/clients/client-backup/pagination/ListBackupSelectionsPaginator.ts index 6f4f6d9c146c9..b63f6e907e6eb 100644 --- a/clients/client-backup/pagination/ListBackupSelectionsPaginator.ts +++ b/clients/client-backup/pagination/ListBackupSelectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListBackupSelectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBackupSelectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListBackupSelectionsCommandInput, diff --git a/clients/client-backup/pagination/ListBackupVaultsPaginator.ts b/clients/client-backup/pagination/ListBackupVaultsPaginator.ts index 9e26268385173..f534455b8b5c2 100644 --- a/clients/client-backup/pagination/ListBackupVaultsPaginator.ts +++ b/clients/client-backup/pagination/ListBackupVaultsPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListBackupVaultsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBackupVaultsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListBackupVaultsCommandInput, diff --git a/clients/client-backup/pagination/ListCopyJobsPaginator.ts b/clients/client-backup/pagination/ListCopyJobsPaginator.ts index 901f9169dfddb..9fac7b57c4bcd 100644 --- a/clients/client-backup/pagination/ListCopyJobsPaginator.ts +++ b/clients/client-backup/pagination/ListCopyJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListCopyJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCopyJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListCopyJobsCommandInput, diff --git a/clients/client-backup/pagination/ListProtectedResourcesPaginator.ts b/clients/client-backup/pagination/ListProtectedResourcesPaginator.ts index 609dd4c5c64c3..59b4d8f3b2898 100644 --- a/clients/client-backup/pagination/ListProtectedResourcesPaginator.ts +++ b/clients/client-backup/pagination/ListProtectedResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListProtectedResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProtectedResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListProtectedResourcesCommandInput, diff --git a/clients/client-backup/pagination/ListRecoveryPointsByBackupVaultPaginator.ts b/clients/client-backup/pagination/ListRecoveryPointsByBackupVaultPaginator.ts index 310a55f4ec358..f76758dd13325 100644 --- a/clients/client-backup/pagination/ListRecoveryPointsByBackupVaultPaginator.ts +++ b/clients/client-backup/pagination/ListRecoveryPointsByBackupVaultPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListRecoveryPointsByBackupVaultCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRecoveryPointsByBackupVaultCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListRecoveryPointsByBackupVaultCommandInput, diff --git a/clients/client-backup/pagination/ListRecoveryPointsByResourcePaginator.ts b/clients/client-backup/pagination/ListRecoveryPointsByResourcePaginator.ts index 08f78f749d9b5..e2d68d2b82ba3 100644 --- a/clients/client-backup/pagination/ListRecoveryPointsByResourcePaginator.ts +++ b/clients/client-backup/pagination/ListRecoveryPointsByResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListRecoveryPointsByResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRecoveryPointsByResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListRecoveryPointsByResourceCommandInput, diff --git a/clients/client-backup/pagination/ListRestoreJobsPaginator.ts b/clients/client-backup/pagination/ListRestoreJobsPaginator.ts index 9c8004b81133c..f734b60755e17 100644 --- a/clients/client-backup/pagination/ListRestoreJobsPaginator.ts +++ b/clients/client-backup/pagination/ListRestoreJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListRestoreJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRestoreJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListRestoreJobsCommandInput, diff --git a/clients/client-backup/pagination/ListTagsPaginator.ts b/clients/client-backup/pagination/ListTagsPaginator.ts index 10400b66f3f2f..c38b94fb0f124 100644 --- a/clients/client-backup/pagination/ListTagsPaginator.ts +++ b/clients/client-backup/pagination/ListTagsPaginator.ts @@ -4,6 +4,9 @@ import { ListTagsCommand, ListTagsCommandInput, ListTagsCommandOutput } from ".. import { BackupPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BackupClient, input: ListTagsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Backup, input: ListTagsCommandInput, diff --git a/clients/client-backup/runtimeConfig.browser.ts b/clients/client-backup/runtimeConfig.browser.ts index 672321f3fdf7a..277e57de5ac33 100644 --- a/clients/client-backup/runtimeConfig.browser.ts +++ b/clients/client-backup/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./BackupClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-backup/runtimeConfig.native.ts b/clients/client-backup/runtimeConfig.native.ts index 71b99b8c30dda..bfd353d687195 100644 --- a/clients/client-backup/runtimeConfig.native.ts +++ b/clients/client-backup/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./BackupClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-backup/runtimeConfig.shared.ts b/clients/client-backup/runtimeConfig.shared.ts index 3a18526b7127a..7001fe53cdcfb 100644 --- a/clients/client-backup/runtimeConfig.shared.ts +++ b/clients/client-backup/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-15", disableHostPrefix: false, diff --git a/clients/client-backup/runtimeConfig.ts b/clients/client-backup/runtimeConfig.ts index 1b5e222a9e4c1..6fcb94473f6df 100644 --- a/clients/client-backup/runtimeConfig.ts +++ b/clients/client-backup/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./BackupClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-backup/tsconfig.json b/clients/client-backup/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-backup/tsconfig.json +++ b/clients/client-backup/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-batch/commands/CancelJobCommand.ts b/clients/client-batch/commands/CancelJobCommand.ts index c8d12d4f32dc2..96400bf1945c0 100644 --- a/clients/client-batch/commands/CancelJobCommand.ts +++ b/clients/client-batch/commands/CancelJobCommand.ts @@ -20,6 +20,12 @@ import { export type CancelJobCommandInput = CancelJobRequest; export type CancelJobCommandOutput = CancelJobResponse & __MetadataBearer; +/** + *

Cancels a job in an AWS Batch job queue. Jobs that are in the SUBMITTED, PENDING, or + * RUNNABLE state are cancelled. Jobs that have progressed to STARTING or + * RUNNING are not cancelled (but the API operation still succeeds, even if no job is cancelled); + * these jobs must be terminated with the TerminateJob operation.

+ */ export class CancelJobCommand extends $Command< CancelJobCommandInput, CancelJobCommandOutput, @@ -34,6 +40,9 @@ export class CancelJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/CreateComputeEnvironmentCommand.ts b/clients/client-batch/commands/CreateComputeEnvironmentCommand.ts index d6d557cc5fe3d..97d97572ea7c0 100644 --- a/clients/client-batch/commands/CreateComputeEnvironmentCommand.ts +++ b/clients/client-batch/commands/CreateComputeEnvironmentCommand.ts @@ -20,6 +20,45 @@ import { export type CreateComputeEnvironmentCommandInput = CreateComputeEnvironmentRequest; export type CreateComputeEnvironmentCommandOutput = CreateComputeEnvironmentResponse & __MetadataBearer; +/** + *

Creates an AWS Batch compute environment. You can create MANAGED or UNMANAGED compute + * environments.

+ *

In a managed compute environment, AWS Batch manages the capacity and instance types of the compute resources + * within the environment. This is based on the compute resource specification that you define or the launch template that you + * specify when you create the compute environment. You can choose to use Amazon EC2 On-Demand Instances or Spot Instances + * in your managed compute environment. You can optionally set a maximum price so that Spot Instances only launch + * when the Spot Instance price is below a specified percentage of the On-Demand price.

+ * + *

Multi-node parallel jobs are not supported on Spot Instances.

+ *
+ *

In an unmanaged compute environment, you can manage your own compute resources. This provides more compute + * resource configuration options, such as using a custom AMI, but you must ensure that your AMI meets the Amazon ECS + * container instance AMI specification. For more information, see Container Instance AMIs in the + * Amazon Elastic Container Service Developer Guide. After you have created your unmanaged compute environment, you can use the + * DescribeComputeEnvironments operation to find the Amazon ECS cluster that is associated with it. + * Then, manually launch your container instances into that Amazon ECS cluster. For more information, see Launching an Amazon + * ECS Container Instance in the Amazon Elastic Container Service Developer Guide.

+ * + *

AWS Batch does not upgrade the AMIs in a compute environment after it is created (for example, when a newer + * version of the Amazon ECS-optimized AMI is available). You are responsible for the management of the guest operating + * system (including updates and security patches) and any additional application software or utilities that you + * install on the compute resources. To use a new AMI for your AWS Batch jobs:

+ *
    + *
  1. + *

    Create a new compute environment with the new AMI.

    + *
  2. + *
  3. + *

    Add the compute environment to an existing job queue.

    + *
  4. + *
  5. + *

    Remove the old compute environment from your job queue.

    + *
  6. + *
  7. + *

    Delete the old compute environment.

    + *
  8. + *
+ *
+ */ export class CreateComputeEnvironmentCommand extends $Command< CreateComputeEnvironmentCommandInput, CreateComputeEnvironmentCommandOutput, @@ -34,6 +73,9 @@ export class CreateComputeEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/CreateJobQueueCommand.ts b/clients/client-batch/commands/CreateJobQueueCommand.ts index 7d8c4a8afe775..fc323cb50dc66 100644 --- a/clients/client-batch/commands/CreateJobQueueCommand.ts +++ b/clients/client-batch/commands/CreateJobQueueCommand.ts @@ -20,6 +20,14 @@ import { export type CreateJobQueueCommandInput = CreateJobQueueRequest; export type CreateJobQueueCommandOutput = CreateJobQueueResponse & __MetadataBearer; +/** + *

Creates an AWS Batch job queue. When you create a job queue, you associate one or more compute environments to + * the queue and assign an order of preference for the compute environments.

+ *

You also set a priority to the job queue that determines the order in which the AWS Batch scheduler places jobs + * onto its associated compute environments. For example, if a compute environment is associated with more than one + * job queue, the job queue with a higher priority is given preference for scheduling jobs to that compute + * environment.

+ */ export class CreateJobQueueCommand extends $Command< CreateJobQueueCommandInput, CreateJobQueueCommandOutput, @@ -34,6 +42,9 @@ export class CreateJobQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/DeleteComputeEnvironmentCommand.ts b/clients/client-batch/commands/DeleteComputeEnvironmentCommand.ts index f43b13b8e3fdb..10634fae3fa72 100644 --- a/clients/client-batch/commands/DeleteComputeEnvironmentCommand.ts +++ b/clients/client-batch/commands/DeleteComputeEnvironmentCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteComputeEnvironmentCommandInput = DeleteComputeEnvironmentRequest; export type DeleteComputeEnvironmentCommandOutput = DeleteComputeEnvironmentResponse & __MetadataBearer; +/** + *

Deletes an AWS Batch compute environment.

+ *

Before you can delete a compute environment, you must set its state to DISABLED with the UpdateComputeEnvironment API operation and disassociate it from any job queues with the UpdateJobQueue API operation.

+ */ export class DeleteComputeEnvironmentCommand extends $Command< DeleteComputeEnvironmentCommandInput, DeleteComputeEnvironmentCommandOutput, @@ -34,6 +38,9 @@ export class DeleteComputeEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/DeleteJobQueueCommand.ts b/clients/client-batch/commands/DeleteJobQueueCommand.ts index cadd6051d5dfd..735c9d5e9084f 100644 --- a/clients/client-batch/commands/DeleteJobQueueCommand.ts +++ b/clients/client-batch/commands/DeleteJobQueueCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteJobQueueCommandInput = DeleteJobQueueRequest; export type DeleteJobQueueCommandOutput = DeleteJobQueueResponse & __MetadataBearer; +/** + *

Deletes the specified job queue. You must first disable submissions for a queue with the UpdateJobQueue operation. All jobs in the queue are terminated when you delete a job queue.

+ *

It is not necessary to disassociate compute environments from a queue before submitting a + * DeleteJobQueue request.

+ */ export class DeleteJobQueueCommand extends $Command< DeleteJobQueueCommandInput, DeleteJobQueueCommandOutput, @@ -34,6 +39,9 @@ export class DeleteJobQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/DeregisterJobDefinitionCommand.ts b/clients/client-batch/commands/DeregisterJobDefinitionCommand.ts index cbb55097a80d7..b5af6594e6ca2 100644 --- a/clients/client-batch/commands/DeregisterJobDefinitionCommand.ts +++ b/clients/client-batch/commands/DeregisterJobDefinitionCommand.ts @@ -20,6 +20,10 @@ import { export type DeregisterJobDefinitionCommandInput = DeregisterJobDefinitionRequest; export type DeregisterJobDefinitionCommandOutput = DeregisterJobDefinitionResponse & __MetadataBearer; +/** + *

Deregisters an AWS Batch job definition. + * Job definitions will be permanently deleted after 180 days.

+ */ export class DeregisterJobDefinitionCommand extends $Command< DeregisterJobDefinitionCommandInput, DeregisterJobDefinitionCommandOutput, @@ -34,6 +38,9 @@ export class DeregisterJobDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/DescribeComputeEnvironmentsCommand.ts b/clients/client-batch/commands/DescribeComputeEnvironmentsCommand.ts index 27500d675d9d6..f8e76fe3fd553 100644 --- a/clients/client-batch/commands/DescribeComputeEnvironmentsCommand.ts +++ b/clients/client-batch/commands/DescribeComputeEnvironmentsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeComputeEnvironmentsCommandInput = DescribeComputeEnvironmentsRequest; export type DescribeComputeEnvironmentsCommandOutput = DescribeComputeEnvironmentsResponse & __MetadataBearer; +/** + *

Describes one or more of your compute environments.

+ *

If you are using an unmanaged compute environment, you can use the DescribeComputeEnvironment + * operation to determine the ecsClusterArn that you should launch your Amazon ECS container instances + * into.

+ */ export class DescribeComputeEnvironmentsCommand extends $Command< DescribeComputeEnvironmentsCommandInput, DescribeComputeEnvironmentsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeComputeEnvironmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/DescribeJobDefinitionsCommand.ts b/clients/client-batch/commands/DescribeJobDefinitionsCommand.ts index e746998b53a5d..37375ddeac75e 100644 --- a/clients/client-batch/commands/DescribeJobDefinitionsCommand.ts +++ b/clients/client-batch/commands/DescribeJobDefinitionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeJobDefinitionsCommandInput = DescribeJobDefinitionsRequest; export type DescribeJobDefinitionsCommandOutput = DescribeJobDefinitionsResponse & __MetadataBearer; +/** + *

Describes a list of job definitions. You can specify a status (such as ACTIVE) to + * only return job definitions that match that status.

+ */ export class DescribeJobDefinitionsCommand extends $Command< DescribeJobDefinitionsCommandInput, DescribeJobDefinitionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeJobDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/DescribeJobQueuesCommand.ts b/clients/client-batch/commands/DescribeJobQueuesCommand.ts index 8641a7aba241f..841efbc8c5e51 100644 --- a/clients/client-batch/commands/DescribeJobQueuesCommand.ts +++ b/clients/client-batch/commands/DescribeJobQueuesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeJobQueuesCommandInput = DescribeJobQueuesRequest; export type DescribeJobQueuesCommandOutput = DescribeJobQueuesResponse & __MetadataBearer; +/** + *

Describes one or more of your job queues.

+ */ export class DescribeJobQueuesCommand extends $Command< DescribeJobQueuesCommandInput, DescribeJobQueuesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeJobQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/DescribeJobsCommand.ts b/clients/client-batch/commands/DescribeJobsCommand.ts index b35ba614d8b14..2ef6d98ddd9db 100644 --- a/clients/client-batch/commands/DescribeJobsCommand.ts +++ b/clients/client-batch/commands/DescribeJobsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeJobsCommandInput = DescribeJobsRequest; export type DescribeJobsCommandOutput = DescribeJobsResponse & __MetadataBearer; +/** + *

Describes a list of AWS Batch jobs.

+ */ export class DescribeJobsCommand extends $Command< DescribeJobsCommandInput, DescribeJobsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/ListJobsCommand.ts b/clients/client-batch/commands/ListJobsCommand.ts index 851479c20d1e0..b8445a74f4f7d 100644 --- a/clients/client-batch/commands/ListJobsCommand.ts +++ b/clients/client-batch/commands/ListJobsCommand.ts @@ -20,6 +20,23 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResponse & __MetadataBearer; +/** + *

Returns a list of AWS Batch jobs.

+ *

You must specify only one of the following:

+ *
    + *
  • + *

    a job queue ID to return a list of jobs in that job queue

    + *
  • + *
  • + *

    a multi-node parallel job ID to return a list of that job's nodes

    + *
  • + *
  • + *

    an array job ID to return a list of that job's children

    + *
  • + *
+ *

You can filter the results by job status with the jobStatus parameter. If you do not specify a + * status, only RUNNING jobs are returned.

+ */ export class ListJobsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +47,9 @@ export class ListJobsCommand extends $Command, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/ListTagsForResourceCommand.ts b/clients/client-batch/commands/ListTagsForResourceCommand.ts index b5b1e63c5479a..44c4cb8d34e99 100644 --- a/clients/client-batch/commands/ListTagsForResourceCommand.ts +++ b/clients/client-batch/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

List the tags for an AWS Batch resource. AWS Batch resources that support tags are compute environments, jobs, job definitions, and job + * queues. ARNs for child jobs of array and multi-node parallel (MNP) jobs are not supported.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/RegisterJobDefinitionCommand.ts b/clients/client-batch/commands/RegisterJobDefinitionCommand.ts index 227f98091369d..f1f6aaca01dd8 100644 --- a/clients/client-batch/commands/RegisterJobDefinitionCommand.ts +++ b/clients/client-batch/commands/RegisterJobDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type RegisterJobDefinitionCommandInput = RegisterJobDefinitionRequest; export type RegisterJobDefinitionCommandOutput = RegisterJobDefinitionResponse & __MetadataBearer; +/** + *

Registers an AWS Batch job definition.

+ */ export class RegisterJobDefinitionCommand extends $Command< RegisterJobDefinitionCommandInput, RegisterJobDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class RegisterJobDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/SubmitJobCommand.ts b/clients/client-batch/commands/SubmitJobCommand.ts index 8b7cb6ef9f914..50e175ffe4640 100644 --- a/clients/client-batch/commands/SubmitJobCommand.ts +++ b/clients/client-batch/commands/SubmitJobCommand.ts @@ -20,6 +20,10 @@ import { export type SubmitJobCommandInput = SubmitJobRequest; export type SubmitJobCommandOutput = SubmitJobResponse & __MetadataBearer; +/** + *

Submits an AWS Batch job from a job definition. Parameters specified during SubmitJob override + * parameters defined in the job definition.

+ */ export class SubmitJobCommand extends $Command< SubmitJobCommandInput, SubmitJobCommandOutput, @@ -34,6 +38,9 @@ export class SubmitJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/TagResourceCommand.ts b/clients/client-batch/commands/TagResourceCommand.ts index be1eeddbe0bad..9c0b3a121ed38 100644 --- a/clients/client-batch/commands/TagResourceCommand.ts +++ b/clients/client-batch/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Associates the specified tags to a resource with the specified resourceArn. If existing tags on a + * resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags + * associated with that resource are deleted as well. AWS Batch resources that support tags are compute environments, jobs, job definitions, and job + * queues. ARNs for child jobs of array and multi-node parallel (MNP) jobs are not supported.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/TerminateJobCommand.ts b/clients/client-batch/commands/TerminateJobCommand.ts index 4288b295f88ff..208f411ddcba4 100644 --- a/clients/client-batch/commands/TerminateJobCommand.ts +++ b/clients/client-batch/commands/TerminateJobCommand.ts @@ -20,6 +20,11 @@ import { export type TerminateJobCommandInput = TerminateJobRequest; export type TerminateJobCommandOutput = TerminateJobResponse & __MetadataBearer; +/** + *

Terminates a job in a job queue. Jobs that are in the STARTING or RUNNING state are + * terminated, which causes them to transition to FAILED. Jobs that have not progressed to the + * STARTING state are cancelled.

+ */ export class TerminateJobCommand extends $Command< TerminateJobCommandInput, TerminateJobCommandOutput, @@ -34,6 +39,9 @@ export class TerminateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/UntagResourceCommand.ts b/clients/client-batch/commands/UntagResourceCommand.ts index 03d489715ddbb..e1a0234a72c73 100644 --- a/clients/client-batch/commands/UntagResourceCommand.ts +++ b/clients/client-batch/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Deletes specified tags from an AWS Batch resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/UpdateComputeEnvironmentCommand.ts b/clients/client-batch/commands/UpdateComputeEnvironmentCommand.ts index e48b628e2fa3f..5b02152780c1d 100644 --- a/clients/client-batch/commands/UpdateComputeEnvironmentCommand.ts +++ b/clients/client-batch/commands/UpdateComputeEnvironmentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateComputeEnvironmentCommandInput = UpdateComputeEnvironmentRequest; export type UpdateComputeEnvironmentCommandOutput = UpdateComputeEnvironmentResponse & __MetadataBearer; +/** + *

Updates an AWS Batch compute environment.

+ */ export class UpdateComputeEnvironmentCommand extends $Command< UpdateComputeEnvironmentCommandInput, UpdateComputeEnvironmentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateComputeEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/commands/UpdateJobQueueCommand.ts b/clients/client-batch/commands/UpdateJobQueueCommand.ts index ce182b292decb..0dc191f53cdad 100644 --- a/clients/client-batch/commands/UpdateJobQueueCommand.ts +++ b/clients/client-batch/commands/UpdateJobQueueCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateJobQueueCommandInput = UpdateJobQueueRequest; export type UpdateJobQueueCommandOutput = UpdateJobQueueResponse & __MetadataBearer; +/** + *

Updates a job queue.

+ */ export class UpdateJobQueueCommand extends $Command< UpdateJobQueueCommandInput, UpdateJobQueueCommandOutput, @@ -34,6 +37,9 @@ export class UpdateJobQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BatchClientResolvedConfig, diff --git a/clients/client-batch/package.json b/clients/client-batch/package.json index c154defe84049..dad1af180d48c 100644 --- a/clients/client-batch/package.json +++ b/clients/client-batch/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Batch Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-batch/pagination/DescribeComputeEnvironmentsPaginator.ts b/clients/client-batch/pagination/DescribeComputeEnvironmentsPaginator.ts index e480e9193c0b6..ce647ae0f8dc7 100644 --- a/clients/client-batch/pagination/DescribeComputeEnvironmentsPaginator.ts +++ b/clients/client-batch/pagination/DescribeComputeEnvironmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { BatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BatchClient, input: DescribeComputeEnvironmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeComputeEnvironmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Batch, input: DescribeComputeEnvironmentsCommandInput, diff --git a/clients/client-batch/pagination/DescribeJobDefinitionsPaginator.ts b/clients/client-batch/pagination/DescribeJobDefinitionsPaginator.ts index d0a63ecd64fa9..357c08ee631b1 100644 --- a/clients/client-batch/pagination/DescribeJobDefinitionsPaginator.ts +++ b/clients/client-batch/pagination/DescribeJobDefinitionsPaginator.ts @@ -8,6 +8,9 @@ import { import { BatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BatchClient, input: DescribeJobDefinitionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeJobDefinitionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Batch, input: DescribeJobDefinitionsCommandInput, diff --git a/clients/client-batch/pagination/DescribeJobQueuesPaginator.ts b/clients/client-batch/pagination/DescribeJobQueuesPaginator.ts index 6f015c79cc59b..3df8bb3dcca83 100644 --- a/clients/client-batch/pagination/DescribeJobQueuesPaginator.ts +++ b/clients/client-batch/pagination/DescribeJobQueuesPaginator.ts @@ -8,6 +8,9 @@ import { import { BatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BatchClient, input: DescribeJobQueuesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeJobQueuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Batch, input: DescribeJobQueuesCommandInput, diff --git a/clients/client-batch/pagination/ListJobsPaginator.ts b/clients/client-batch/pagination/ListJobsPaginator.ts index 3cc564ad4d86d..6126334ed2a42 100644 --- a/clients/client-batch/pagination/ListJobsPaginator.ts +++ b/clients/client-batch/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { BatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BatchClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Batch, input: ListJobsCommandInput, diff --git a/clients/client-batch/runtimeConfig.browser.ts b/clients/client-batch/runtimeConfig.browser.ts index 82cca63837423..a10942f07f0ee 100644 --- a/clients/client-batch/runtimeConfig.browser.ts +++ b/clients/client-batch/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./BatchClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-batch/runtimeConfig.native.ts b/clients/client-batch/runtimeConfig.native.ts index 0e52ed7e52144..2c6f27b10bf30 100644 --- a/clients/client-batch/runtimeConfig.native.ts +++ b/clients/client-batch/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./BatchClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-batch/runtimeConfig.shared.ts b/clients/client-batch/runtimeConfig.shared.ts index 67607dcffc0ee..11bc9ae6308a0 100644 --- a/clients/client-batch/runtimeConfig.shared.ts +++ b/clients/client-batch/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-08-10", disableHostPrefix: false, diff --git a/clients/client-batch/runtimeConfig.ts b/clients/client-batch/runtimeConfig.ts index 9e41ac9f43385..fd3d7c489a8af 100644 --- a/clients/client-batch/runtimeConfig.ts +++ b/clients/client-batch/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./BatchClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-batch/tsconfig.json b/clients/client-batch/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-batch/tsconfig.json +++ b/clients/client-batch/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-braket/commands/CancelQuantumTaskCommand.ts b/clients/client-braket/commands/CancelQuantumTaskCommand.ts index 1c7efc781fcbe..5a3b96cbaaec9 100644 --- a/clients/client-braket/commands/CancelQuantumTaskCommand.ts +++ b/clients/client-braket/commands/CancelQuantumTaskCommand.ts @@ -20,6 +20,9 @@ import { export type CancelQuantumTaskCommandInput = CancelQuantumTaskRequest; export type CancelQuantumTaskCommandOutput = CancelQuantumTaskResponse & __MetadataBearer; +/** + *

Cancels the specified task.

+ */ export class CancelQuantumTaskCommand extends $Command< CancelQuantumTaskCommandInput, CancelQuantumTaskCommandOutput, @@ -34,6 +37,9 @@ export class CancelQuantumTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BraketClientResolvedConfig, diff --git a/clients/client-braket/commands/CreateQuantumTaskCommand.ts b/clients/client-braket/commands/CreateQuantumTaskCommand.ts index 0e3ae51445dd8..5027e3887b5fc 100644 --- a/clients/client-braket/commands/CreateQuantumTaskCommand.ts +++ b/clients/client-braket/commands/CreateQuantumTaskCommand.ts @@ -20,6 +20,9 @@ import { export type CreateQuantumTaskCommandInput = CreateQuantumTaskRequest; export type CreateQuantumTaskCommandOutput = CreateQuantumTaskResponse & __MetadataBearer; +/** + *

Creates a quantum task.

+ */ export class CreateQuantumTaskCommand extends $Command< CreateQuantumTaskCommandInput, CreateQuantumTaskCommandOutput, @@ -34,6 +37,9 @@ export class CreateQuantumTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BraketClientResolvedConfig, diff --git a/clients/client-braket/commands/GetDeviceCommand.ts b/clients/client-braket/commands/GetDeviceCommand.ts index b7acb05c54471..c0a5dc9c9634b 100644 --- a/clients/client-braket/commands/GetDeviceCommand.ts +++ b/clients/client-braket/commands/GetDeviceCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeviceCommandInput = GetDeviceRequest; export type GetDeviceCommandOutput = GetDeviceResponse & __MetadataBearer; +/** + *

Retrieves the devices available in Amazon Braket.

+ */ export class GetDeviceCommand extends $Command< GetDeviceCommandInput, GetDeviceCommandOutput, @@ -34,6 +37,9 @@ export class GetDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BraketClientResolvedConfig, diff --git a/clients/client-braket/commands/GetQuantumTaskCommand.ts b/clients/client-braket/commands/GetQuantumTaskCommand.ts index 7415c802cd69f..38426dca60633 100644 --- a/clients/client-braket/commands/GetQuantumTaskCommand.ts +++ b/clients/client-braket/commands/GetQuantumTaskCommand.ts @@ -20,6 +20,9 @@ import { export type GetQuantumTaskCommandInput = GetQuantumTaskRequest; export type GetQuantumTaskCommandOutput = GetQuantumTaskResponse & __MetadataBearer; +/** + *

Retrieves the specified quantum task.

+ */ export class GetQuantumTaskCommand extends $Command< GetQuantumTaskCommandInput, GetQuantumTaskCommandOutput, @@ -34,6 +37,9 @@ export class GetQuantumTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BraketClientResolvedConfig, diff --git a/clients/client-braket/commands/SearchDevicesCommand.ts b/clients/client-braket/commands/SearchDevicesCommand.ts index 0bb5b6a87ab7b..5a202531ba1b7 100644 --- a/clients/client-braket/commands/SearchDevicesCommand.ts +++ b/clients/client-braket/commands/SearchDevicesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchDevicesCommandInput = SearchDevicesRequest; export type SearchDevicesCommandOutput = SearchDevicesResponse & __MetadataBearer; +/** + *

Searches for devices using the specified filters.

+ */ export class SearchDevicesCommand extends $Command< SearchDevicesCommandInput, SearchDevicesCommandOutput, @@ -34,6 +37,9 @@ export class SearchDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BraketClientResolvedConfig, diff --git a/clients/client-braket/commands/SearchQuantumTasksCommand.ts b/clients/client-braket/commands/SearchQuantumTasksCommand.ts index 23fbce5b0b667..959f6e9885384 100644 --- a/clients/client-braket/commands/SearchQuantumTasksCommand.ts +++ b/clients/client-braket/commands/SearchQuantumTasksCommand.ts @@ -20,6 +20,9 @@ import { export type SearchQuantumTasksCommandInput = SearchQuantumTasksRequest; export type SearchQuantumTasksCommandOutput = SearchQuantumTasksResponse & __MetadataBearer; +/** + *

Searches for tasks that match the specified filter values.

+ */ export class SearchQuantumTasksCommand extends $Command< SearchQuantumTasksCommandInput, SearchQuantumTasksCommandOutput, @@ -34,6 +37,9 @@ export class SearchQuantumTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BraketClientResolvedConfig, diff --git a/clients/client-braket/package.json b/clients/client-braket/package.json index 09d4621b75f35..b77cae5bb6256 100644 --- a/clients/client-braket/package.json +++ b/clients/client-braket/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Braket Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-braket/pagination/SearchDevicesPaginator.ts b/clients/client-braket/pagination/SearchDevicesPaginator.ts index 52135df57d9e7..0c66e481b405a 100644 --- a/clients/client-braket/pagination/SearchDevicesPaginator.ts +++ b/clients/client-braket/pagination/SearchDevicesPaginator.ts @@ -8,6 +8,9 @@ import { import { BraketPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BraketClient, input: SearchDevicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchDevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Braket, input: SearchDevicesCommandInput, diff --git a/clients/client-braket/pagination/SearchQuantumTasksPaginator.ts b/clients/client-braket/pagination/SearchQuantumTasksPaginator.ts index 8bf2d040c4231..1eb869d85b6ec 100644 --- a/clients/client-braket/pagination/SearchQuantumTasksPaginator.ts +++ b/clients/client-braket/pagination/SearchQuantumTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { BraketPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BraketClient, input: SearchQuantumTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchQuantumTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Braket, input: SearchQuantumTasksCommandInput, diff --git a/clients/client-braket/runtimeConfig.browser.ts b/clients/client-braket/runtimeConfig.browser.ts index 69a7df965522d..3c37013f39e14 100644 --- a/clients/client-braket/runtimeConfig.browser.ts +++ b/clients/client-braket/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./BraketClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-braket/runtimeConfig.native.ts b/clients/client-braket/runtimeConfig.native.ts index 252e1a3357d7c..f10724dc05f05 100644 --- a/clients/client-braket/runtimeConfig.native.ts +++ b/clients/client-braket/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./BraketClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-braket/runtimeConfig.shared.ts b/clients/client-braket/runtimeConfig.shared.ts index 93775f88a48e3..e7e38b1993927 100644 --- a/clients/client-braket/runtimeConfig.shared.ts +++ b/clients/client-braket/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-09-01", disableHostPrefix: false, diff --git a/clients/client-braket/runtimeConfig.ts b/clients/client-braket/runtimeConfig.ts index 015f4251a23dc..d97bd40c278dd 100644 --- a/clients/client-braket/runtimeConfig.ts +++ b/clients/client-braket/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./BraketClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-braket/tsconfig.json b/clients/client-braket/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-braket/tsconfig.json +++ b/clients/client-braket/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-budgets/commands/CreateBudgetActionCommand.ts b/clients/client-budgets/commands/CreateBudgetActionCommand.ts index db1d88dc1a35d..01489e539de2f 100644 --- a/clients/client-budgets/commands/CreateBudgetActionCommand.ts +++ b/clients/client-budgets/commands/CreateBudgetActionCommand.ts @@ -20,6 +20,11 @@ import { export type CreateBudgetActionCommandInput = CreateBudgetActionRequest; export type CreateBudgetActionCommandOutput = CreateBudgetActionResponse & __MetadataBearer; +/** + *

+ * Creates a budget action. + *

+ */ export class CreateBudgetActionCommand extends $Command< CreateBudgetActionCommandInput, CreateBudgetActionCommandOutput, @@ -34,6 +39,9 @@ export class CreateBudgetActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/CreateBudgetCommand.ts b/clients/client-budgets/commands/CreateBudgetCommand.ts index 908f6fffd8c79..a4d373eeede1e 100644 --- a/clients/client-budgets/commands/CreateBudgetCommand.ts +++ b/clients/client-budgets/commands/CreateBudgetCommand.ts @@ -20,6 +20,12 @@ import { export type CreateBudgetCommandInput = CreateBudgetRequest; export type CreateBudgetCommandOutput = CreateBudgetResponse & __MetadataBearer; +/** + *

Creates a budget and, if included, notifications and subscribers.

+ * + *

Only one of BudgetLimit or PlannedBudgetLimits can be present in the syntax at one time. Use the syntax that matches your case. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

+ *
+ */ export class CreateBudgetCommand extends $Command< CreateBudgetCommandInput, CreateBudgetCommandOutput, @@ -34,6 +40,9 @@ export class CreateBudgetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/CreateNotificationCommand.ts b/clients/client-budgets/commands/CreateNotificationCommand.ts index 362ce85573921..5df3b92c3cacc 100644 --- a/clients/client-budgets/commands/CreateNotificationCommand.ts +++ b/clients/client-budgets/commands/CreateNotificationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateNotificationCommandInput = CreateNotificationRequest; export type CreateNotificationCommandOutput = CreateNotificationResponse & __MetadataBearer; +/** + *

Creates a notification. You must create the budget before you create the associated notification.

+ */ export class CreateNotificationCommand extends $Command< CreateNotificationCommandInput, CreateNotificationCommandOutput, @@ -34,6 +37,9 @@ export class CreateNotificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/CreateSubscriberCommand.ts b/clients/client-budgets/commands/CreateSubscriberCommand.ts index 81280cef5741b..6e3fd046497a8 100644 --- a/clients/client-budgets/commands/CreateSubscriberCommand.ts +++ b/clients/client-budgets/commands/CreateSubscriberCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSubscriberCommandInput = CreateSubscriberRequest; export type CreateSubscriberCommandOutput = CreateSubscriberResponse & __MetadataBearer; +/** + *

Creates a subscriber. You must create the associated budget and notification before you create the subscriber.

+ */ export class CreateSubscriberCommand extends $Command< CreateSubscriberCommandInput, CreateSubscriberCommandOutput, @@ -34,6 +37,9 @@ export class CreateSubscriberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DeleteBudgetActionCommand.ts b/clients/client-budgets/commands/DeleteBudgetActionCommand.ts index 58c949124dbd4..afba23333861f 100644 --- a/clients/client-budgets/commands/DeleteBudgetActionCommand.ts +++ b/clients/client-budgets/commands/DeleteBudgetActionCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteBudgetActionCommandInput = DeleteBudgetActionRequest; export type DeleteBudgetActionCommandOutput = DeleteBudgetActionResponse & __MetadataBearer; +/** + *

+ * Deletes a budget action. + *

+ */ export class DeleteBudgetActionCommand extends $Command< DeleteBudgetActionCommandInput, DeleteBudgetActionCommandOutput, @@ -34,6 +39,9 @@ export class DeleteBudgetActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DeleteBudgetCommand.ts b/clients/client-budgets/commands/DeleteBudgetCommand.ts index 393d9bc0b5418..96876f5d17f8d 100644 --- a/clients/client-budgets/commands/DeleteBudgetCommand.ts +++ b/clients/client-budgets/commands/DeleteBudgetCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteBudgetCommandInput = DeleteBudgetRequest; export type DeleteBudgetCommandOutput = DeleteBudgetResponse & __MetadataBearer; +/** + *

Deletes a budget. You can delete your budget at any time.

+ * + *

Deleting a budget also deletes the notifications and subscribers that are associated with that budget.

+ *
+ */ export class DeleteBudgetCommand extends $Command< DeleteBudgetCommandInput, DeleteBudgetCommandOutput, @@ -34,6 +40,9 @@ export class DeleteBudgetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DeleteNotificationCommand.ts b/clients/client-budgets/commands/DeleteNotificationCommand.ts index ff7c47feeec3b..333e5a39718a6 100644 --- a/clients/client-budgets/commands/DeleteNotificationCommand.ts +++ b/clients/client-budgets/commands/DeleteNotificationCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteNotificationCommandInput = DeleteNotificationRequest; export type DeleteNotificationCommandOutput = DeleteNotificationResponse & __MetadataBearer; +/** + *

Deletes a notification.

+ * + *

Deleting a notification also deletes the subscribers that are associated with the notification.

+ *
+ */ export class DeleteNotificationCommand extends $Command< DeleteNotificationCommandInput, DeleteNotificationCommandOutput, @@ -34,6 +40,9 @@ export class DeleteNotificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DeleteSubscriberCommand.ts b/clients/client-budgets/commands/DeleteSubscriberCommand.ts index 9acf59d54def6..0842b575db4c1 100644 --- a/clients/client-budgets/commands/DeleteSubscriberCommand.ts +++ b/clients/client-budgets/commands/DeleteSubscriberCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteSubscriberCommandInput = DeleteSubscriberRequest; export type DeleteSubscriberCommandOutput = DeleteSubscriberResponse & __MetadataBearer; +/** + *

Deletes a subscriber.

+ * + *

Deleting the last subscriber to a notification also deletes the notification.

+ *
+ */ export class DeleteSubscriberCommand extends $Command< DeleteSubscriberCommandInput, DeleteSubscriberCommandOutput, @@ -34,6 +40,9 @@ export class DeleteSubscriberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeBudgetActionCommand.ts b/clients/client-budgets/commands/DescribeBudgetActionCommand.ts index fca9f00cdf66b..7f87dba64d88b 100644 --- a/clients/client-budgets/commands/DescribeBudgetActionCommand.ts +++ b/clients/client-budgets/commands/DescribeBudgetActionCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeBudgetActionCommandInput = DescribeBudgetActionRequest; export type DescribeBudgetActionCommandOutput = DescribeBudgetActionResponse & __MetadataBearer; +/** + *

+ * Describes a budget action detail. + *

+ */ export class DescribeBudgetActionCommand extends $Command< DescribeBudgetActionCommandInput, DescribeBudgetActionCommandOutput, @@ -34,6 +39,9 @@ export class DescribeBudgetActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeBudgetActionHistoriesCommand.ts b/clients/client-budgets/commands/DescribeBudgetActionHistoriesCommand.ts index be167720f5605..aae552e17ed96 100644 --- a/clients/client-budgets/commands/DescribeBudgetActionHistoriesCommand.ts +++ b/clients/client-budgets/commands/DescribeBudgetActionHistoriesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeBudgetActionHistoriesCommandInput = DescribeBudgetActionHistoriesRequest; export type DescribeBudgetActionHistoriesCommandOutput = DescribeBudgetActionHistoriesResponse & __MetadataBearer; +/** + *

+ * Describes a budget action history detail. + *

+ */ export class DescribeBudgetActionHistoriesCommand extends $Command< DescribeBudgetActionHistoriesCommandInput, DescribeBudgetActionHistoriesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeBudgetActionHistoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeBudgetActionsForAccountCommand.ts b/clients/client-budgets/commands/DescribeBudgetActionsForAccountCommand.ts index 20f6e13ee6677..7e2be6edc08f5 100644 --- a/clients/client-budgets/commands/DescribeBudgetActionsForAccountCommand.ts +++ b/clients/client-budgets/commands/DescribeBudgetActionsForAccountCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeBudgetActionsForAccountCommandInput = DescribeBudgetActionsForAccountRequest; export type DescribeBudgetActionsForAccountCommandOutput = DescribeBudgetActionsForAccountResponse & __MetadataBearer; +/** + *

+ * Describes all of the budget actions for an account. + *

+ */ export class DescribeBudgetActionsForAccountCommand extends $Command< DescribeBudgetActionsForAccountCommandInput, DescribeBudgetActionsForAccountCommandOutput, @@ -34,6 +39,9 @@ export class DescribeBudgetActionsForAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeBudgetActionsForBudgetCommand.ts b/clients/client-budgets/commands/DescribeBudgetActionsForBudgetCommand.ts index a5159660ef818..33770496ebf63 100644 --- a/clients/client-budgets/commands/DescribeBudgetActionsForBudgetCommand.ts +++ b/clients/client-budgets/commands/DescribeBudgetActionsForBudgetCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeBudgetActionsForBudgetCommandInput = DescribeBudgetActionsForBudgetRequest; export type DescribeBudgetActionsForBudgetCommandOutput = DescribeBudgetActionsForBudgetResponse & __MetadataBearer; +/** + *

+ * Describes all of the budget actions for a budget. + *

+ */ export class DescribeBudgetActionsForBudgetCommand extends $Command< DescribeBudgetActionsForBudgetCommandInput, DescribeBudgetActionsForBudgetCommandOutput, @@ -34,6 +39,9 @@ export class DescribeBudgetActionsForBudgetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeBudgetCommand.ts b/clients/client-budgets/commands/DescribeBudgetCommand.ts index 44424d6585759..4eb9bde9514be 100644 --- a/clients/client-budgets/commands/DescribeBudgetCommand.ts +++ b/clients/client-budgets/commands/DescribeBudgetCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeBudgetCommandInput = DescribeBudgetRequest; export type DescribeBudgetCommandOutput = DescribeBudgetResponse & __MetadataBearer; +/** + *

Describes a budget.

+ * + *

The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

+ *
+ */ export class DescribeBudgetCommand extends $Command< DescribeBudgetCommandInput, DescribeBudgetCommandOutput, @@ -34,6 +40,9 @@ export class DescribeBudgetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeBudgetPerformanceHistoryCommand.ts b/clients/client-budgets/commands/DescribeBudgetPerformanceHistoryCommand.ts index c28c3e7e453ca..c46ab8bc5a933 100644 --- a/clients/client-budgets/commands/DescribeBudgetPerformanceHistoryCommand.ts +++ b/clients/client-budgets/commands/DescribeBudgetPerformanceHistoryCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBudgetPerformanceHistoryCommandInput = DescribeBudgetPerformanceHistoryRequest; export type DescribeBudgetPerformanceHistoryCommandOutput = DescribeBudgetPerformanceHistoryResponse & __MetadataBearer; +/** + *

Describes the history for DAILY, MONTHLY, and QUARTERLY budgets. Budget history isn't available for ANNUAL budgets.

+ */ export class DescribeBudgetPerformanceHistoryCommand extends $Command< DescribeBudgetPerformanceHistoryCommandInput, DescribeBudgetPerformanceHistoryCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBudgetPerformanceHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeBudgetsCommand.ts b/clients/client-budgets/commands/DescribeBudgetsCommand.ts index a28a6a821ca79..f4847d993366d 100644 --- a/clients/client-budgets/commands/DescribeBudgetsCommand.ts +++ b/clients/client-budgets/commands/DescribeBudgetsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeBudgetsCommandInput = DescribeBudgetsRequest; export type DescribeBudgetsCommandOutput = DescribeBudgetsResponse & __MetadataBearer; +/** + *

Lists the budgets that are associated with an account.

+ * + *

The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

+ *
+ */ export class DescribeBudgetsCommand extends $Command< DescribeBudgetsCommandInput, DescribeBudgetsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeBudgetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeNotificationsForBudgetCommand.ts b/clients/client-budgets/commands/DescribeNotificationsForBudgetCommand.ts index ebc15a3e7c305..2a6f54ddcbb8e 100644 --- a/clients/client-budgets/commands/DescribeNotificationsForBudgetCommand.ts +++ b/clients/client-budgets/commands/DescribeNotificationsForBudgetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNotificationsForBudgetCommandInput = DescribeNotificationsForBudgetRequest; export type DescribeNotificationsForBudgetCommandOutput = DescribeNotificationsForBudgetResponse & __MetadataBearer; +/** + *

Lists the notifications that are associated with a budget.

+ */ export class DescribeNotificationsForBudgetCommand extends $Command< DescribeNotificationsForBudgetCommandInput, DescribeNotificationsForBudgetCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNotificationsForBudgetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/DescribeSubscribersForNotificationCommand.ts b/clients/client-budgets/commands/DescribeSubscribersForNotificationCommand.ts index 143127dedbcbd..bbc52f79feca1 100644 --- a/clients/client-budgets/commands/DescribeSubscribersForNotificationCommand.ts +++ b/clients/client-budgets/commands/DescribeSubscribersForNotificationCommand.ts @@ -24,6 +24,9 @@ export type DescribeSubscribersForNotificationCommandInput = DescribeSubscribers export type DescribeSubscribersForNotificationCommandOutput = DescribeSubscribersForNotificationResponse & __MetadataBearer; +/** + *

Lists the subscribers that are associated with a notification.

+ */ export class DescribeSubscribersForNotificationCommand extends $Command< DescribeSubscribersForNotificationCommandInput, DescribeSubscribersForNotificationCommandOutput, @@ -38,6 +41,9 @@ export class DescribeSubscribersForNotificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/ExecuteBudgetActionCommand.ts b/clients/client-budgets/commands/ExecuteBudgetActionCommand.ts index 0bdb57a8c6dba..c75c829dde84d 100644 --- a/clients/client-budgets/commands/ExecuteBudgetActionCommand.ts +++ b/clients/client-budgets/commands/ExecuteBudgetActionCommand.ts @@ -20,6 +20,11 @@ import { export type ExecuteBudgetActionCommandInput = ExecuteBudgetActionRequest; export type ExecuteBudgetActionCommandOutput = ExecuteBudgetActionResponse & __MetadataBearer; +/** + *

+ * Executes a budget action. + *

+ */ export class ExecuteBudgetActionCommand extends $Command< ExecuteBudgetActionCommandInput, ExecuteBudgetActionCommandOutput, @@ -34,6 +39,9 @@ export class ExecuteBudgetActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/UpdateBudgetActionCommand.ts b/clients/client-budgets/commands/UpdateBudgetActionCommand.ts index 86d28a801e4a3..0d795d8570e16 100644 --- a/clients/client-budgets/commands/UpdateBudgetActionCommand.ts +++ b/clients/client-budgets/commands/UpdateBudgetActionCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateBudgetActionCommandInput = UpdateBudgetActionRequest; export type UpdateBudgetActionCommandOutput = UpdateBudgetActionResponse & __MetadataBearer; +/** + *

+ * Updates a budget action. + *

+ */ export class UpdateBudgetActionCommand extends $Command< UpdateBudgetActionCommandInput, UpdateBudgetActionCommandOutput, @@ -34,6 +39,9 @@ export class UpdateBudgetActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/UpdateBudgetCommand.ts b/clients/client-budgets/commands/UpdateBudgetCommand.ts index dbb359e62b399..2f1f07b717c74 100644 --- a/clients/client-budgets/commands/UpdateBudgetCommand.ts +++ b/clients/client-budgets/commands/UpdateBudgetCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateBudgetCommandInput = UpdateBudgetRequest; export type UpdateBudgetCommandOutput = UpdateBudgetResponse & __MetadataBearer; +/** + *

Updates a budget. You can change every part of a budget except for the budgetName and the calculatedSpend. When you modify a budget, the calculatedSpend drops to zero until AWS has new usage data to use for forecasting.

+ * + *

Only one of BudgetLimit or PlannedBudgetLimits can be present in the syntax at one time. Use the syntax that matches your case. The Request Syntax section shows the BudgetLimit syntax. For PlannedBudgetLimits, see the Examples section.

+ *
+ */ export class UpdateBudgetCommand extends $Command< UpdateBudgetCommandInput, UpdateBudgetCommandOutput, @@ -34,6 +40,9 @@ export class UpdateBudgetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/UpdateNotificationCommand.ts b/clients/client-budgets/commands/UpdateNotificationCommand.ts index 908196e40ded6..8fc2e68d107c6 100644 --- a/clients/client-budgets/commands/UpdateNotificationCommand.ts +++ b/clients/client-budgets/commands/UpdateNotificationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateNotificationCommandInput = UpdateNotificationRequest; export type UpdateNotificationCommandOutput = UpdateNotificationResponse & __MetadataBearer; +/** + *

Updates a notification.

+ */ export class UpdateNotificationCommand extends $Command< UpdateNotificationCommandInput, UpdateNotificationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateNotificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/commands/UpdateSubscriberCommand.ts b/clients/client-budgets/commands/UpdateSubscriberCommand.ts index 2adbdf4331e29..2d63fb154dfe6 100644 --- a/clients/client-budgets/commands/UpdateSubscriberCommand.ts +++ b/clients/client-budgets/commands/UpdateSubscriberCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSubscriberCommandInput = UpdateSubscriberRequest; export type UpdateSubscriberCommandOutput = UpdateSubscriberResponse & __MetadataBearer; +/** + *

Updates a subscriber.

+ */ export class UpdateSubscriberCommand extends $Command< UpdateSubscriberCommandInput, UpdateSubscriberCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSubscriberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: BudgetsClientResolvedConfig, diff --git a/clients/client-budgets/package.json b/clients/client-budgets/package.json index d9ec404dcf8dc..a6ece464dbcb9 100644 --- a/clients/client-budgets/package.json +++ b/clients/client-budgets/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Budgets Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-budgets/pagination/DescribeBudgetActionHistoriesPaginator.ts b/clients/client-budgets/pagination/DescribeBudgetActionHistoriesPaginator.ts index 36feb6801a714..35599c602a487 100644 --- a/clients/client-budgets/pagination/DescribeBudgetActionHistoriesPaginator.ts +++ b/clients/client-budgets/pagination/DescribeBudgetActionHistoriesPaginator.ts @@ -8,6 +8,9 @@ import { import { BudgetsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BudgetsClient, input: DescribeBudgetActionHistoriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBudgetActionHistoriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Budgets, input: DescribeBudgetActionHistoriesCommandInput, diff --git a/clients/client-budgets/pagination/DescribeBudgetActionsForAccountPaginator.ts b/clients/client-budgets/pagination/DescribeBudgetActionsForAccountPaginator.ts index 573ff9af1c155..7526807842e92 100644 --- a/clients/client-budgets/pagination/DescribeBudgetActionsForAccountPaginator.ts +++ b/clients/client-budgets/pagination/DescribeBudgetActionsForAccountPaginator.ts @@ -8,6 +8,9 @@ import { import { BudgetsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BudgetsClient, input: DescribeBudgetActionsForAccountCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBudgetActionsForAccountCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Budgets, input: DescribeBudgetActionsForAccountCommandInput, diff --git a/clients/client-budgets/pagination/DescribeBudgetActionsForBudgetPaginator.ts b/clients/client-budgets/pagination/DescribeBudgetActionsForBudgetPaginator.ts index 00d3a140f9a54..7339224576aec 100644 --- a/clients/client-budgets/pagination/DescribeBudgetActionsForBudgetPaginator.ts +++ b/clients/client-budgets/pagination/DescribeBudgetActionsForBudgetPaginator.ts @@ -8,6 +8,9 @@ import { import { BudgetsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BudgetsClient, input: DescribeBudgetActionsForBudgetCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBudgetActionsForBudgetCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Budgets, input: DescribeBudgetActionsForBudgetCommandInput, diff --git a/clients/client-budgets/pagination/DescribeBudgetsPaginator.ts b/clients/client-budgets/pagination/DescribeBudgetsPaginator.ts index a93ba591e2b62..b06e40fad3f55 100644 --- a/clients/client-budgets/pagination/DescribeBudgetsPaginator.ts +++ b/clients/client-budgets/pagination/DescribeBudgetsPaginator.ts @@ -8,6 +8,9 @@ import { import { BudgetsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BudgetsClient, input: DescribeBudgetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBudgetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Budgets, input: DescribeBudgetsCommandInput, diff --git a/clients/client-budgets/pagination/DescribeNotificationsForBudgetPaginator.ts b/clients/client-budgets/pagination/DescribeNotificationsForBudgetPaginator.ts index 13968f2441e0b..6f2a89aa7d6d3 100644 --- a/clients/client-budgets/pagination/DescribeNotificationsForBudgetPaginator.ts +++ b/clients/client-budgets/pagination/DescribeNotificationsForBudgetPaginator.ts @@ -8,6 +8,9 @@ import { import { BudgetsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BudgetsClient, input: DescribeNotificationsForBudgetCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeNotificationsForBudgetCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Budgets, input: DescribeNotificationsForBudgetCommandInput, diff --git a/clients/client-budgets/pagination/DescribeSubscribersForNotificationPaginator.ts b/clients/client-budgets/pagination/DescribeSubscribersForNotificationPaginator.ts index 67a3c83a1b4a8..2f075254be9f9 100644 --- a/clients/client-budgets/pagination/DescribeSubscribersForNotificationPaginator.ts +++ b/clients/client-budgets/pagination/DescribeSubscribersForNotificationPaginator.ts @@ -8,6 +8,9 @@ import { import { BudgetsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: BudgetsClient, input: DescribeSubscribersForNotificationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSubscribersForNotificationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Budgets, input: DescribeSubscribersForNotificationCommandInput, diff --git a/clients/client-budgets/runtimeConfig.browser.ts b/clients/client-budgets/runtimeConfig.browser.ts index ec0851dad76ee..725de9caa3ed5 100644 --- a/clients/client-budgets/runtimeConfig.browser.ts +++ b/clients/client-budgets/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./BudgetsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-budgets/runtimeConfig.native.ts b/clients/client-budgets/runtimeConfig.native.ts index 5cc8c50014e9c..8f5eeae7675c8 100644 --- a/clients/client-budgets/runtimeConfig.native.ts +++ b/clients/client-budgets/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./BudgetsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-budgets/runtimeConfig.shared.ts b/clients/client-budgets/runtimeConfig.shared.ts index 45168860c3410..e28fa156dcc2a 100644 --- a/clients/client-budgets/runtimeConfig.shared.ts +++ b/clients/client-budgets/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-10-20", disableHostPrefix: false, diff --git a/clients/client-budgets/runtimeConfig.ts b/clients/client-budgets/runtimeConfig.ts index e59fde47208b2..14782fb1ba9a3 100644 --- a/clients/client-budgets/runtimeConfig.ts +++ b/clients/client-budgets/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./BudgetsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-budgets/tsconfig.json b/clients/client-budgets/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-budgets/tsconfig.json +++ b/clients/client-budgets/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-chime/commands/AssociatePhoneNumberWithUserCommand.ts b/clients/client-chime/commands/AssociatePhoneNumberWithUserCommand.ts index 00cfa76825e2c..7d1ce1f85b487 100644 --- a/clients/client-chime/commands/AssociatePhoneNumberWithUserCommand.ts +++ b/clients/client-chime/commands/AssociatePhoneNumberWithUserCommand.ts @@ -20,6 +20,9 @@ import { export type AssociatePhoneNumberWithUserCommandInput = AssociatePhoneNumberWithUserRequest; export type AssociatePhoneNumberWithUserCommandOutput = AssociatePhoneNumberWithUserResponse & __MetadataBearer; +/** + *

Associates a phone number with the specified Amazon Chime user.

+ */ export class AssociatePhoneNumberWithUserCommand extends $Command< AssociatePhoneNumberWithUserCommandInput, AssociatePhoneNumberWithUserCommandOutput, @@ -34,6 +37,9 @@ export class AssociatePhoneNumberWithUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/AssociatePhoneNumbersWithVoiceConnectorCommand.ts b/clients/client-chime/commands/AssociatePhoneNumbersWithVoiceConnectorCommand.ts index c253c2ec1f947..e18fbe7813471 100644 --- a/clients/client-chime/commands/AssociatePhoneNumbersWithVoiceConnectorCommand.ts +++ b/clients/client-chime/commands/AssociatePhoneNumbersWithVoiceConnectorCommand.ts @@ -24,6 +24,9 @@ export type AssociatePhoneNumbersWithVoiceConnectorCommandInput = AssociatePhone export type AssociatePhoneNumbersWithVoiceConnectorCommandOutput = AssociatePhoneNumbersWithVoiceConnectorResponse & __MetadataBearer; +/** + *

Associates phone numbers with the specified Amazon Chime Voice Connector.

+ */ export class AssociatePhoneNumbersWithVoiceConnectorCommand extends $Command< AssociatePhoneNumbersWithVoiceConnectorCommandInput, AssociatePhoneNumbersWithVoiceConnectorCommandOutput, @@ -38,6 +41,9 @@ export class AssociatePhoneNumbersWithVoiceConnectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/AssociatePhoneNumbersWithVoiceConnectorGroupCommand.ts b/clients/client-chime/commands/AssociatePhoneNumbersWithVoiceConnectorGroupCommand.ts index 409fce91a2a24..0c39b352cbc82 100644 --- a/clients/client-chime/commands/AssociatePhoneNumbersWithVoiceConnectorGroupCommand.ts +++ b/clients/client-chime/commands/AssociatePhoneNumbersWithVoiceConnectorGroupCommand.ts @@ -24,6 +24,9 @@ export type AssociatePhoneNumbersWithVoiceConnectorGroupCommandInput = Associate export type AssociatePhoneNumbersWithVoiceConnectorGroupCommandOutput = AssociatePhoneNumbersWithVoiceConnectorGroupResponse & __MetadataBearer; +/** + *

Associates phone numbers with the specified Amazon Chime Voice Connector group.

+ */ export class AssociatePhoneNumbersWithVoiceConnectorGroupCommand extends $Command< AssociatePhoneNumbersWithVoiceConnectorGroupCommandInput, AssociatePhoneNumbersWithVoiceConnectorGroupCommandOutput, @@ -38,6 +41,9 @@ export class AssociatePhoneNumbersWithVoiceConnectorGroupCommand extends $Comman // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/AssociateSigninDelegateGroupsWithAccountCommand.ts b/clients/client-chime/commands/AssociateSigninDelegateGroupsWithAccountCommand.ts index 93da05700ea9c..63907587ea973 100644 --- a/clients/client-chime/commands/AssociateSigninDelegateGroupsWithAccountCommand.ts +++ b/clients/client-chime/commands/AssociateSigninDelegateGroupsWithAccountCommand.ts @@ -24,6 +24,9 @@ export type AssociateSigninDelegateGroupsWithAccountCommandInput = AssociateSign export type AssociateSigninDelegateGroupsWithAccountCommandOutput = AssociateSigninDelegateGroupsWithAccountResponse & __MetadataBearer; +/** + *

Associates the specified sign-in delegate groups with the specified Amazon Chime account.

+ */ export class AssociateSigninDelegateGroupsWithAccountCommand extends $Command< AssociateSigninDelegateGroupsWithAccountCommandInput, AssociateSigninDelegateGroupsWithAccountCommandOutput, @@ -38,6 +41,9 @@ export class AssociateSigninDelegateGroupsWithAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/BatchCreateAttendeeCommand.ts b/clients/client-chime/commands/BatchCreateAttendeeCommand.ts index 0fa57bf69d723..152c20afc967c 100644 --- a/clients/client-chime/commands/BatchCreateAttendeeCommand.ts +++ b/clients/client-chime/commands/BatchCreateAttendeeCommand.ts @@ -20,6 +20,9 @@ import { export type BatchCreateAttendeeCommandInput = BatchCreateAttendeeRequest; export type BatchCreateAttendeeCommandOutput = BatchCreateAttendeeResponse & __MetadataBearer; +/** + *

Creates up to 100 new attendees for an active Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class BatchCreateAttendeeCommand extends $Command< BatchCreateAttendeeCommandInput, BatchCreateAttendeeCommandOutput, @@ -34,6 +37,9 @@ export class BatchCreateAttendeeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/BatchCreateRoomMembershipCommand.ts b/clients/client-chime/commands/BatchCreateRoomMembershipCommand.ts index ea3988b7f49b9..449eb787fdff8 100644 --- a/clients/client-chime/commands/BatchCreateRoomMembershipCommand.ts +++ b/clients/client-chime/commands/BatchCreateRoomMembershipCommand.ts @@ -20,6 +20,9 @@ import { export type BatchCreateRoomMembershipCommandInput = BatchCreateRoomMembershipRequest; export type BatchCreateRoomMembershipCommandOutput = BatchCreateRoomMembershipResponse & __MetadataBearer; +/** + *

Adds up to 50 members to a chat room in an Amazon Chime Enterprise account. Members can be either users or bots. The member role designates whether the member is a chat room administrator or a general chat room member.

+ */ export class BatchCreateRoomMembershipCommand extends $Command< BatchCreateRoomMembershipCommandInput, BatchCreateRoomMembershipCommandOutput, @@ -34,6 +37,9 @@ export class BatchCreateRoomMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/BatchDeletePhoneNumberCommand.ts b/clients/client-chime/commands/BatchDeletePhoneNumberCommand.ts index 3c6916fae72c4..f78b3cfcddf67 100644 --- a/clients/client-chime/commands/BatchDeletePhoneNumberCommand.ts +++ b/clients/client-chime/commands/BatchDeletePhoneNumberCommand.ts @@ -20,6 +20,13 @@ import { export type BatchDeletePhoneNumberCommandInput = BatchDeletePhoneNumberRequest; export type BatchDeletePhoneNumberCommandOutput = BatchDeletePhoneNumberResponse & __MetadataBearer; +/** + *

Moves phone numbers into the Deletion queue. Phone + * numbers must be disassociated from any users or Amazon Chime Voice + * Connectors before they can be deleted.

+ *

Phone numbers remain in the Deletion queue for 7 days + * before they are deleted permanently.

+ */ export class BatchDeletePhoneNumberCommand extends $Command< BatchDeletePhoneNumberCommandInput, BatchDeletePhoneNumberCommandOutput, @@ -34,6 +41,9 @@ export class BatchDeletePhoneNumberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/BatchSuspendUserCommand.ts b/clients/client-chime/commands/BatchSuspendUserCommand.ts index ac6e646020372..be3c6cbef83d5 100644 --- a/clients/client-chime/commands/BatchSuspendUserCommand.ts +++ b/clients/client-chime/commands/BatchSuspendUserCommand.ts @@ -20,6 +20,23 @@ import { export type BatchSuspendUserCommandInput = BatchSuspendUserRequest; export type BatchSuspendUserCommandOutput = BatchSuspendUserResponse & __MetadataBearer; +/** + *

Suspends up to 50 users from a Team or EnterpriseLWA Amazon + * Chime account. For more information + * about different account types, see Managing Your Amazon Chime Accounts in the + * Amazon + * Chime Administration Guide.

+ *

Users suspended from a Team account are disassociated from the account, + * but they can continue to use Amazon Chime as free users. To remove the suspension from + * suspended Team account users, invite them to the Team account again. + * You can use the InviteUsers action to do so.

+ *

Users suspended from an EnterpriseLWA account are immediately signed out + * of Amazon Chime and can no longer sign in. To remove the suspension from suspended + * EnterpriseLWA account users, use the BatchUnsuspendUser + * action.

+ *

To sign out users without suspending them, use the LogoutUser + * action.

+ */ export class BatchSuspendUserCommand extends $Command< BatchSuspendUserCommandInput, BatchSuspendUserCommandOutput, @@ -34,6 +51,9 @@ export class BatchSuspendUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/BatchUnsuspendUserCommand.ts b/clients/client-chime/commands/BatchUnsuspendUserCommand.ts index 689c5950d489c..ae2958191a9f1 100644 --- a/clients/client-chime/commands/BatchUnsuspendUserCommand.ts +++ b/clients/client-chime/commands/BatchUnsuspendUserCommand.ts @@ -20,6 +20,15 @@ import { export type BatchUnsuspendUserCommandInput = BatchUnsuspendUserRequest; export type BatchUnsuspendUserCommandOutput = BatchUnsuspendUserResponse & __MetadataBearer; +/** + *

Removes the suspension from up to 50 previously suspended users for the specified + * Amazon Chime EnterpriseLWA account. Only users on EnterpriseLWA + * accounts can be unsuspended using this action. For more information about different account + * types, see Managing Your Amazon Chime Accounts in the Amazon Chime Administration + * Guide.

+ *

Previously suspended users who are unsuspended using this action are returned to + * Registered status. Users who are not previously suspended are ignored.

+ */ export class BatchUnsuspendUserCommand extends $Command< BatchUnsuspendUserCommandInput, BatchUnsuspendUserCommandOutput, @@ -34,6 +43,9 @@ export class BatchUnsuspendUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/BatchUpdatePhoneNumberCommand.ts b/clients/client-chime/commands/BatchUpdatePhoneNumberCommand.ts index b5154170af431..57cef4b4eb2e1 100644 --- a/clients/client-chime/commands/BatchUpdatePhoneNumberCommand.ts +++ b/clients/client-chime/commands/BatchUpdatePhoneNumberCommand.ts @@ -20,6 +20,13 @@ import { export type BatchUpdatePhoneNumberCommandInput = BatchUpdatePhoneNumberRequest; export type BatchUpdatePhoneNumberCommandOutput = BatchUpdatePhoneNumberResponse & __MetadataBearer; +/** + *

Updates phone number product types or calling names. You can update one attribute at a time for each UpdatePhoneNumberRequestItem. For example, you can update either the product type or the calling name.

+ *

For product types, choose from Amazon Chime Business Calling and Amazon Chime Voice + * Connector. For toll-free numbers, you must use the Amazon Chime Voice Connector product + * type.

+ *

Updates to outbound calling names can take up to 72 hours to complete. Pending updates to outbound calling names must be complete before you can request another update.

+ */ export class BatchUpdatePhoneNumberCommand extends $Command< BatchUpdatePhoneNumberCommandInput, BatchUpdatePhoneNumberCommandOutput, @@ -34,6 +41,9 @@ export class BatchUpdatePhoneNumberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/BatchUpdateUserCommand.ts b/clients/client-chime/commands/BatchUpdateUserCommand.ts index 345bfd2e4b3d0..7876938ca1a52 100644 --- a/clients/client-chime/commands/BatchUpdateUserCommand.ts +++ b/clients/client-chime/commands/BatchUpdateUserCommand.ts @@ -20,6 +20,10 @@ import { export type BatchUpdateUserCommandInput = BatchUpdateUserRequest; export type BatchUpdateUserCommandOutput = BatchUpdateUserResponse & __MetadataBearer; +/** + *

Updates user details within the UpdateUserRequestItem object for up to 20 users for the specified Amazon Chime account. + * Currently, only LicenseType updates are supported for this action.

+ */ export class BatchUpdateUserCommand extends $Command< BatchUpdateUserCommandInput, BatchUpdateUserCommandOutput, @@ -34,6 +38,9 @@ export class BatchUpdateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateAccountCommand.ts b/clients/client-chime/commands/CreateAccountCommand.ts index 4057df17b55f0..03a8546b55f79 100644 --- a/clients/client-chime/commands/CreateAccountCommand.ts +++ b/clients/client-chime/commands/CreateAccountCommand.ts @@ -20,6 +20,13 @@ import { export type CreateAccountCommandInput = CreateAccountRequest; export type CreateAccountCommandOutput = CreateAccountResponse & __MetadataBearer; +/** + *

Creates an Amazon Chime account under the administrator's AWS account. Only + * Team account types are currently supported for this action. For more information + * about different account types, see Managing Your Amazon Chime Accounts in the + * Amazon + * Chime Administration Guide.

+ */ export class CreateAccountCommand extends $Command< CreateAccountCommandInput, CreateAccountCommandOutput, @@ -34,6 +41,9 @@ export class CreateAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateAttendeeCommand.ts b/clients/client-chime/commands/CreateAttendeeCommand.ts index f027e31b5fde8..f6bd8663482e9 100644 --- a/clients/client-chime/commands/CreateAttendeeCommand.ts +++ b/clients/client-chime/commands/CreateAttendeeCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAttendeeCommandInput = CreateAttendeeRequest; export type CreateAttendeeCommandOutput = CreateAttendeeResponse & __MetadataBearer; +/** + *

Creates a new attendee for an active Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class CreateAttendeeCommand extends $Command< CreateAttendeeCommandInput, CreateAttendeeCommandOutput, @@ -34,6 +37,9 @@ export class CreateAttendeeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateBotCommand.ts b/clients/client-chime/commands/CreateBotCommand.ts index 9f012a6b065e9..51e2c8055e656 100644 --- a/clients/client-chime/commands/CreateBotCommand.ts +++ b/clients/client-chime/commands/CreateBotCommand.ts @@ -20,6 +20,9 @@ import { export type CreateBotCommandInput = CreateBotRequest; export type CreateBotCommandOutput = CreateBotResponse & __MetadataBearer; +/** + *

Creates a bot for an Amazon Chime Enterprise account.

+ */ export class CreateBotCommand extends $Command< CreateBotCommandInput, CreateBotCommandOutput, @@ -34,6 +37,9 @@ export class CreateBotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateMeetingCommand.ts b/clients/client-chime/commands/CreateMeetingCommand.ts index ce0c9bb5e1379..7539bca00873a 100644 --- a/clients/client-chime/commands/CreateMeetingCommand.ts +++ b/clients/client-chime/commands/CreateMeetingCommand.ts @@ -20,6 +20,9 @@ import { export type CreateMeetingCommandInput = CreateMeetingRequest; export type CreateMeetingCommandOutput = CreateMeetingResponse & __MetadataBearer; +/** + *

Creates a new Amazon Chime SDK meeting in the specified media Region with no initial attendees. For more information about specifying media Regions, see Amazon Chime SDK Media Regions in the Amazon Chime Developer Guide. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class CreateMeetingCommand extends $Command< CreateMeetingCommandInput, CreateMeetingCommandOutput, @@ -34,6 +37,9 @@ export class CreateMeetingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateMeetingDialOutCommand.ts b/clients/client-chime/commands/CreateMeetingDialOutCommand.ts index 211ddbf60350a..acb2cf419cb2a 100644 --- a/clients/client-chime/commands/CreateMeetingDialOutCommand.ts +++ b/clients/client-chime/commands/CreateMeetingDialOutCommand.ts @@ -20,6 +20,14 @@ import { export type CreateMeetingDialOutCommandInput = CreateMeetingDialOutRequest; export type CreateMeetingDialOutCommandOutput = CreateMeetingDialOutResponse & __MetadataBearer; +/** + *

Uses the join token and call metadata in a meeting request (From number, To number, and so forth) to initiate an outbound call to a + * public switched telephone network (PSTN) and joins them into Chime meeting. Also ensures that the From number belongs to the + * customer.

+ * + *

To play welcome audio or implement an interactive voice response (IVR), use the CreateSipMediaApplicationCall API with + * the corresponding SIP media application ID.

+ */ export class CreateMeetingDialOutCommand extends $Command< CreateMeetingDialOutCommandInput, CreateMeetingDialOutCommandOutput, @@ -34,6 +42,9 @@ export class CreateMeetingDialOutCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateMeetingWithAttendeesCommand.ts b/clients/client-chime/commands/CreateMeetingWithAttendeesCommand.ts index 4fd678df9482f..05faec9a507e7 100644 --- a/clients/client-chime/commands/CreateMeetingWithAttendeesCommand.ts +++ b/clients/client-chime/commands/CreateMeetingWithAttendeesCommand.ts @@ -20,6 +20,13 @@ import { export type CreateMeetingWithAttendeesCommandInput = CreateMeetingWithAttendeesRequest; export type CreateMeetingWithAttendeesCommandOutput = CreateMeetingWithAttendeesResponse & __MetadataBearer; +/** + *

Creates a new Amazon Chime SDK meeting in the specified media Region, with attendees. For more information about specifying media Regions, + * see Amazon Chime SDK Media Regions in the + * Amazon Chime Developer Guide. For more information about the Amazon Chime SDK, see + * Using the Amazon Chime SDK in the + * Amazon Chime Developer Guide.

+ */ export class CreateMeetingWithAttendeesCommand extends $Command< CreateMeetingWithAttendeesCommandInput, CreateMeetingWithAttendeesCommandOutput, @@ -34,6 +41,9 @@ export class CreateMeetingWithAttendeesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreatePhoneNumberOrderCommand.ts b/clients/client-chime/commands/CreatePhoneNumberOrderCommand.ts index 234833170a3b5..d0968894e2565 100644 --- a/clients/client-chime/commands/CreatePhoneNumberOrderCommand.ts +++ b/clients/client-chime/commands/CreatePhoneNumberOrderCommand.ts @@ -20,6 +20,11 @@ import { export type CreatePhoneNumberOrderCommandInput = CreatePhoneNumberOrderRequest; export type CreatePhoneNumberOrderCommandOutput = CreatePhoneNumberOrderResponse & __MetadataBearer; +/** + *

Creates an order for phone numbers to be provisioned. Choose from Amazon Chime Business + * Calling and Amazon Chime Voice Connector product types. For toll-free numbers, you must use + * the Amazon Chime Voice Connector product type.

+ */ export class CreatePhoneNumberOrderCommand extends $Command< CreatePhoneNumberOrderCommandInput, CreatePhoneNumberOrderCommandOutput, @@ -34,6 +39,9 @@ export class CreatePhoneNumberOrderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateProxySessionCommand.ts b/clients/client-chime/commands/CreateProxySessionCommand.ts index b0dddeb07d661..d582445d1aef3 100644 --- a/clients/client-chime/commands/CreateProxySessionCommand.ts +++ b/clients/client-chime/commands/CreateProxySessionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProxySessionCommandInput = CreateProxySessionRequest; export type CreateProxySessionCommandOutput = CreateProxySessionResponse & __MetadataBearer; +/** + *

Creates a proxy session on the specified Amazon Chime Voice Connector for the specified participant phone numbers.

+ */ export class CreateProxySessionCommand extends $Command< CreateProxySessionCommandInput, CreateProxySessionCommandOutput, @@ -34,6 +37,9 @@ export class CreateProxySessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateRoomCommand.ts b/clients/client-chime/commands/CreateRoomCommand.ts index f8301689803cc..1faca1ee4d5eb 100644 --- a/clients/client-chime/commands/CreateRoomCommand.ts +++ b/clients/client-chime/commands/CreateRoomCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRoomCommandInput = CreateRoomRequest; export type CreateRoomCommandOutput = CreateRoomResponse & __MetadataBearer; +/** + *

Creates a chat room for the specified Amazon Chime Enterprise account.

+ */ export class CreateRoomCommand extends $Command< CreateRoomCommandInput, CreateRoomCommandOutput, @@ -34,6 +37,9 @@ export class CreateRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateRoomMembershipCommand.ts b/clients/client-chime/commands/CreateRoomMembershipCommand.ts index df5102bddb7d7..ddc87e62a5ba6 100644 --- a/clients/client-chime/commands/CreateRoomMembershipCommand.ts +++ b/clients/client-chime/commands/CreateRoomMembershipCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRoomMembershipCommandInput = CreateRoomMembershipRequest; export type CreateRoomMembershipCommandOutput = CreateRoomMembershipResponse & __MetadataBearer; +/** + *

Adds a member to a chat room in an Amazon Chime Enterprise account. A member can be either a user or a bot. The member role designates whether the member is a chat room administrator or a general chat room member.

+ */ export class CreateRoomMembershipCommand extends $Command< CreateRoomMembershipCommandInput, CreateRoomMembershipCommandOutput, @@ -34,6 +37,9 @@ export class CreateRoomMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateSipMediaApplicationCallCommand.ts b/clients/client-chime/commands/CreateSipMediaApplicationCallCommand.ts index 35e287ab1181d..7892a26702be3 100644 --- a/clients/client-chime/commands/CreateSipMediaApplicationCallCommand.ts +++ b/clients/client-chime/commands/CreateSipMediaApplicationCallCommand.ts @@ -20,6 +20,10 @@ import { export type CreateSipMediaApplicationCallCommandInput = CreateSipMediaApplicationCallRequest; export type CreateSipMediaApplicationCallCommandOutput = CreateSipMediaApplicationCallResponse & __MetadataBearer; +/** + *

Creates an outbound call to a phone number from the phone number specified in the request, and it invokes the endpoint of the + * specified sipMediaApplicationId.

+ */ export class CreateSipMediaApplicationCallCommand extends $Command< CreateSipMediaApplicationCallCommandInput, CreateSipMediaApplicationCallCommandOutput, @@ -34,6 +38,9 @@ export class CreateSipMediaApplicationCallCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateSipMediaApplicationCommand.ts b/clients/client-chime/commands/CreateSipMediaApplicationCommand.ts index a84743b880788..ec0a50b929f9a 100644 --- a/clients/client-chime/commands/CreateSipMediaApplicationCommand.ts +++ b/clients/client-chime/commands/CreateSipMediaApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSipMediaApplicationCommandInput = CreateSipMediaApplicationRequest; export type CreateSipMediaApplicationCommandOutput = CreateSipMediaApplicationResponse & __MetadataBearer; +/** + *

Creates a SIP media application.

+ */ export class CreateSipMediaApplicationCommand extends $Command< CreateSipMediaApplicationCommandInput, CreateSipMediaApplicationCommandOutput, @@ -34,6 +37,9 @@ export class CreateSipMediaApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateSipRuleCommand.ts b/clients/client-chime/commands/CreateSipRuleCommand.ts index dfb32c42d5a29..bd3b8ff4ddccb 100644 --- a/clients/client-chime/commands/CreateSipRuleCommand.ts +++ b/clients/client-chime/commands/CreateSipRuleCommand.ts @@ -20,6 +20,10 @@ import { export type CreateSipRuleCommandInput = CreateSipRuleRequest; export type CreateSipRuleCommandOutput = CreateSipRuleResponse & __MetadataBearer; +/** + *

Creates a SIP rule which can be used to run a SIP media application as a target for a + * specific trigger type.

+ */ export class CreateSipRuleCommand extends $Command< CreateSipRuleCommandInput, CreateSipRuleCommandOutput, @@ -34,6 +38,9 @@ export class CreateSipRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateUserCommand.ts b/clients/client-chime/commands/CreateUserCommand.ts index e68cec139d18a..4fc9b2fd25d2c 100644 --- a/clients/client-chime/commands/CreateUserCommand.ts +++ b/clients/client-chime/commands/CreateUserCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResponse & __MetadataBearer; +/** + *

Creates a user under the specified Amazon Chime account.

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -34,6 +37,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateVoiceConnectorCommand.ts b/clients/client-chime/commands/CreateVoiceConnectorCommand.ts index d7e207067fd0b..bddf0c11339c7 100644 --- a/clients/client-chime/commands/CreateVoiceConnectorCommand.ts +++ b/clients/client-chime/commands/CreateVoiceConnectorCommand.ts @@ -20,6 +20,11 @@ import { export type CreateVoiceConnectorCommandInput = CreateVoiceConnectorRequest; export type CreateVoiceConnectorCommandOutput = CreateVoiceConnectorResponse & __MetadataBearer; +/** + *

Creates an Amazon Chime Voice Connector under the administrator's AWS account. You can choose to create an Amazon Chime Voice Connector in a specific AWS Region.

+ *

Enabling CreateVoiceConnectorRequest$RequireEncryption configures your Amazon Chime Voice Connector to use TLS transport for SIP signaling and Secure RTP (SRTP) for media. + * Inbound calls use TLS transport, and unencrypted outbound calls are blocked.

+ */ export class CreateVoiceConnectorCommand extends $Command< CreateVoiceConnectorCommandInput, CreateVoiceConnectorCommandOutput, @@ -34,6 +39,9 @@ export class CreateVoiceConnectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/CreateVoiceConnectorGroupCommand.ts b/clients/client-chime/commands/CreateVoiceConnectorGroupCommand.ts index c3710bffd56c9..42e5faa32cb7b 100644 --- a/clients/client-chime/commands/CreateVoiceConnectorGroupCommand.ts +++ b/clients/client-chime/commands/CreateVoiceConnectorGroupCommand.ts @@ -20,6 +20,13 @@ import { export type CreateVoiceConnectorGroupCommandInput = CreateVoiceConnectorGroupRequest; export type CreateVoiceConnectorGroupCommandOutput = CreateVoiceConnectorGroupResponse & __MetadataBearer; +/** + *

Creates an Amazon Chime Voice Connector group under the administrator's AWS account. + * You can associate Amazon Chime Voice Connectors with the Amazon Chime + * Voice Connector group by including VoiceConnectorItems in the request.

+ *

You can include Amazon Chime Voice Connectors from different AWS Regions in your group. + * This creates a fault tolerant mechanism for fallback in case of availability events.

+ */ export class CreateVoiceConnectorGroupCommand extends $Command< CreateVoiceConnectorGroupCommandInput, CreateVoiceConnectorGroupCommandOutput, @@ -34,6 +41,9 @@ export class CreateVoiceConnectorGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteAccountCommand.ts b/clients/client-chime/commands/DeleteAccountCommand.ts index fc02a21e2c695..b5ce1f16810a0 100644 --- a/clients/client-chime/commands/DeleteAccountCommand.ts +++ b/clients/client-chime/commands/DeleteAccountCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteAccountCommandInput = DeleteAccountRequest; export type DeleteAccountCommandOutput = DeleteAccountResponse & __MetadataBearer; +/** + *

Deletes the specified Amazon Chime account. You must suspend all users before deleting + * a Team account. You can use the BatchSuspendUser action to do + * so.

+ *

For EnterpriseLWA and EnterpriseAD accounts, you must + * release the claimed domains for your Amazon Chime account before deletion. As soon as you + * release the domain, all users under that account are suspended.

+ *

Deleted accounts appear in your Disabled accounts list for 90 days. To restore a + * deleted account from your Disabled accounts list, you must contact AWS Support.

+ *

After 90 days, deleted accounts are permanently removed from your + * Disabled accounts list.

+ */ export class DeleteAccountCommand extends $Command< DeleteAccountCommandInput, DeleteAccountCommandOutput, @@ -34,6 +46,9 @@ export class DeleteAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteAttendeeCommand.ts b/clients/client-chime/commands/DeleteAttendeeCommand.ts index e3aafabdc92ae..7c98e64cadf76 100644 --- a/clients/client-chime/commands/DeleteAttendeeCommand.ts +++ b/clients/client-chime/commands/DeleteAttendeeCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAttendeeCommandInput = DeleteAttendeeRequest; export type DeleteAttendeeCommandOutput = __MetadataBearer; +/** + *

Deletes an attendee from the specified Amazon Chime SDK meeting and deletes their JoinToken. Attendees are automatically deleted when a Amazon Chime SDK meeting is deleted. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class DeleteAttendeeCommand extends $Command< DeleteAttendeeCommandInput, DeleteAttendeeCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAttendeeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteEventsConfigurationCommand.ts b/clients/client-chime/commands/DeleteEventsConfigurationCommand.ts index 886b06d9e76c7..867902f0fb301 100644 --- a/clients/client-chime/commands/DeleteEventsConfigurationCommand.ts +++ b/clients/client-chime/commands/DeleteEventsConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEventsConfigurationCommandInput = DeleteEventsConfigurationRequest; export type DeleteEventsConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the events configuration that allows a bot to receive outgoing events.

+ */ export class DeleteEventsConfigurationCommand extends $Command< DeleteEventsConfigurationCommandInput, DeleteEventsConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEventsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteMeetingCommand.ts b/clients/client-chime/commands/DeleteMeetingCommand.ts index f072055a26bea..1b044ee9b25b6 100644 --- a/clients/client-chime/commands/DeleteMeetingCommand.ts +++ b/clients/client-chime/commands/DeleteMeetingCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMeetingCommandInput = DeleteMeetingRequest; export type DeleteMeetingCommandOutput = __MetadataBearer; +/** + *

Deletes the specified Amazon Chime SDK meeting. When a meeting is deleted, its attendees are also deleted and clients can no longer join it. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class DeleteMeetingCommand extends $Command< DeleteMeetingCommandInput, DeleteMeetingCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMeetingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeletePhoneNumberCommand.ts b/clients/client-chime/commands/DeletePhoneNumberCommand.ts index 3ce4269b5168c..811c39b92357f 100644 --- a/clients/client-chime/commands/DeletePhoneNumberCommand.ts +++ b/clients/client-chime/commands/DeletePhoneNumberCommand.ts @@ -20,6 +20,13 @@ import { export type DeletePhoneNumberCommandInput = DeletePhoneNumberRequest; export type DeletePhoneNumberCommandOutput = __MetadataBearer; +/** + *

Moves the specified phone number into the Deletion + * queue. A phone number must be disassociated from any users or Amazon Chime Voice + * Connectors before it can be deleted.

+ *

Deleted phone numbers remain in the Deletion queue + * for 7 days before they are deleted permanently.

+ */ export class DeletePhoneNumberCommand extends $Command< DeletePhoneNumberCommandInput, DeletePhoneNumberCommandOutput, @@ -34,6 +41,9 @@ export class DeletePhoneNumberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteProxySessionCommand.ts b/clients/client-chime/commands/DeleteProxySessionCommand.ts index ec29db6d5bd9c..e19762a3da224 100644 --- a/clients/client-chime/commands/DeleteProxySessionCommand.ts +++ b/clients/client-chime/commands/DeleteProxySessionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProxySessionCommandInput = DeleteProxySessionRequest; export type DeleteProxySessionCommandOutput = __MetadataBearer; +/** + *

Deletes the specified proxy session from the specified Amazon Chime Voice Connector.

+ */ export class DeleteProxySessionCommand extends $Command< DeleteProxySessionCommandInput, DeleteProxySessionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProxySessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteRoomCommand.ts b/clients/client-chime/commands/DeleteRoomCommand.ts index 64e042d617e07..78e00ccbee687 100644 --- a/clients/client-chime/commands/DeleteRoomCommand.ts +++ b/clients/client-chime/commands/DeleteRoomCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRoomCommandInput = DeleteRoomRequest; export type DeleteRoomCommandOutput = __MetadataBearer; +/** + *

Deletes a chat room in an Amazon Chime Enterprise account.

+ */ export class DeleteRoomCommand extends $Command< DeleteRoomCommandInput, DeleteRoomCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteRoomMembershipCommand.ts b/clients/client-chime/commands/DeleteRoomMembershipCommand.ts index e1e98b1945888..d54488f7c25f7 100644 --- a/clients/client-chime/commands/DeleteRoomMembershipCommand.ts +++ b/clients/client-chime/commands/DeleteRoomMembershipCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRoomMembershipCommandInput = DeleteRoomMembershipRequest; export type DeleteRoomMembershipCommandOutput = __MetadataBearer; +/** + *

Removes a member from a chat room in an Amazon Chime Enterprise account.

+ */ export class DeleteRoomMembershipCommand extends $Command< DeleteRoomMembershipCommandInput, DeleteRoomMembershipCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRoomMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteSipMediaApplicationCommand.ts b/clients/client-chime/commands/DeleteSipMediaApplicationCommand.ts index 8b563ca37b505..c695c0eb6aaa5 100644 --- a/clients/client-chime/commands/DeleteSipMediaApplicationCommand.ts +++ b/clients/client-chime/commands/DeleteSipMediaApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSipMediaApplicationCommandInput = DeleteSipMediaApplicationRequest; export type DeleteSipMediaApplicationCommandOutput = __MetadataBearer; +/** + *

Deletes a SIP media application.

+ */ export class DeleteSipMediaApplicationCommand extends $Command< DeleteSipMediaApplicationCommandInput, DeleteSipMediaApplicationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSipMediaApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteSipRuleCommand.ts b/clients/client-chime/commands/DeleteSipRuleCommand.ts index 30e060e72260a..1977d5e55b4cc 100644 --- a/clients/client-chime/commands/DeleteSipRuleCommand.ts +++ b/clients/client-chime/commands/DeleteSipRuleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSipRuleCommandInput = DeleteSipRuleRequest; export type DeleteSipRuleCommandOutput = __MetadataBearer; +/** + *

Deletes a SIP rule. You must disable a SIP rule before you can delete it.

+ */ export class DeleteSipRuleCommand extends $Command< DeleteSipRuleCommandInput, DeleteSipRuleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSipRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteVoiceConnectorCommand.ts b/clients/client-chime/commands/DeleteVoiceConnectorCommand.ts index a28a3d88eb9ed..b9e25596d69ca 100644 --- a/clients/client-chime/commands/DeleteVoiceConnectorCommand.ts +++ b/clients/client-chime/commands/DeleteVoiceConnectorCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteVoiceConnectorCommandInput = DeleteVoiceConnectorRequest; export type DeleteVoiceConnectorCommandOutput = __MetadataBearer; +/** + *

Deletes the specified Amazon Chime Voice Connector. Any phone numbers associated with the + * Amazon Chime Voice Connector must be disassociated from it before it can be deleted.

+ */ export class DeleteVoiceConnectorCommand extends $Command< DeleteVoiceConnectorCommandInput, DeleteVoiceConnectorCommandOutput, @@ -34,6 +38,9 @@ export class DeleteVoiceConnectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteVoiceConnectorEmergencyCallingConfigurationCommand.ts b/clients/client-chime/commands/DeleteVoiceConnectorEmergencyCallingConfigurationCommand.ts index 9665fbf5a8956..85fcb0e724c32 100644 --- a/clients/client-chime/commands/DeleteVoiceConnectorEmergencyCallingConfigurationCommand.ts +++ b/clients/client-chime/commands/DeleteVoiceConnectorEmergencyCallingConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVoiceConnectorEmergencyCallingConfigurationCommandInput = DeleteVoiceConnectorEmergencyCallingConfigurationRequest; export type DeleteVoiceConnectorEmergencyCallingConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the emergency calling configuration details from the specified Amazon Chime Voice Connector.

+ */ export class DeleteVoiceConnectorEmergencyCallingConfigurationCommand extends $Command< DeleteVoiceConnectorEmergencyCallingConfigurationCommandInput, DeleteVoiceConnectorEmergencyCallingConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVoiceConnectorEmergencyCallingConfigurationCommand extends $C // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteVoiceConnectorGroupCommand.ts b/clients/client-chime/commands/DeleteVoiceConnectorGroupCommand.ts index 3d5f6326c9ed0..aac2b0cf2f373 100644 --- a/clients/client-chime/commands/DeleteVoiceConnectorGroupCommand.ts +++ b/clients/client-chime/commands/DeleteVoiceConnectorGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVoiceConnectorGroupCommandInput = DeleteVoiceConnectorGroupRequest; export type DeleteVoiceConnectorGroupCommandOutput = __MetadataBearer; +/** + *

Deletes the specified Amazon Chime Voice Connector group. Any VoiceConnectorItems and phone numbers associated with the group must be removed before it can be deleted.

+ */ export class DeleteVoiceConnectorGroupCommand extends $Command< DeleteVoiceConnectorGroupCommandInput, DeleteVoiceConnectorGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVoiceConnectorGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteVoiceConnectorOriginationCommand.ts b/clients/client-chime/commands/DeleteVoiceConnectorOriginationCommand.ts index c72d7c60d1d72..bbed2d90b2c71 100644 --- a/clients/client-chime/commands/DeleteVoiceConnectorOriginationCommand.ts +++ b/clients/client-chime/commands/DeleteVoiceConnectorOriginationCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteVoiceConnectorOriginationCommandInput = DeleteVoiceConnectorOriginationRequest; export type DeleteVoiceConnectorOriginationCommandOutput = __MetadataBearer; +/** + *

Deletes the origination settings for the specified Amazon Chime Voice Connector.

+ * + *

If emergency calling is configured for the Amazon Chime Voice Connector, it must be deleted prior to deleting the origination settings.

+ *
+ */ export class DeleteVoiceConnectorOriginationCommand extends $Command< DeleteVoiceConnectorOriginationCommandInput, DeleteVoiceConnectorOriginationCommandOutput, @@ -34,6 +40,9 @@ export class DeleteVoiceConnectorOriginationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteVoiceConnectorProxyCommand.ts b/clients/client-chime/commands/DeleteVoiceConnectorProxyCommand.ts index 80903f217260b..aa5e0dc1f8eef 100644 --- a/clients/client-chime/commands/DeleteVoiceConnectorProxyCommand.ts +++ b/clients/client-chime/commands/DeleteVoiceConnectorProxyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVoiceConnectorProxyCommandInput = DeleteVoiceConnectorProxyRequest; export type DeleteVoiceConnectorProxyCommandOutput = __MetadataBearer; +/** + *

Deletes the proxy configuration from the specified Amazon Chime Voice Connector.

+ */ export class DeleteVoiceConnectorProxyCommand extends $Command< DeleteVoiceConnectorProxyCommandInput, DeleteVoiceConnectorProxyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVoiceConnectorProxyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteVoiceConnectorStreamingConfigurationCommand.ts b/clients/client-chime/commands/DeleteVoiceConnectorStreamingConfigurationCommand.ts index 44cbb1c7701c9..5e63d036b3b84 100644 --- a/clients/client-chime/commands/DeleteVoiceConnectorStreamingConfigurationCommand.ts +++ b/clients/client-chime/commands/DeleteVoiceConnectorStreamingConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVoiceConnectorStreamingConfigurationCommandInput = DeleteVoiceConnectorStreamingConfigurationRequest; export type DeleteVoiceConnectorStreamingConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the streaming configuration for the specified Amazon Chime Voice Connector.

+ */ export class DeleteVoiceConnectorStreamingConfigurationCommand extends $Command< DeleteVoiceConnectorStreamingConfigurationCommandInput, DeleteVoiceConnectorStreamingConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVoiceConnectorStreamingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteVoiceConnectorTerminationCommand.ts b/clients/client-chime/commands/DeleteVoiceConnectorTerminationCommand.ts index b0a1d0fa4b77c..879f9d44635e8 100644 --- a/clients/client-chime/commands/DeleteVoiceConnectorTerminationCommand.ts +++ b/clients/client-chime/commands/DeleteVoiceConnectorTerminationCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteVoiceConnectorTerminationCommandInput = DeleteVoiceConnectorTerminationRequest; export type DeleteVoiceConnectorTerminationCommandOutput = __MetadataBearer; +/** + *

Deletes the termination settings for the specified Amazon Chime Voice Connector.

+ * + *

If emergency calling is configured for the Amazon Chime Voice Connector, it must be deleted prior to deleting the termination settings.

+ *
+ */ export class DeleteVoiceConnectorTerminationCommand extends $Command< DeleteVoiceConnectorTerminationCommandInput, DeleteVoiceConnectorTerminationCommandOutput, @@ -34,6 +40,9 @@ export class DeleteVoiceConnectorTerminationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DeleteVoiceConnectorTerminationCredentialsCommand.ts b/clients/client-chime/commands/DeleteVoiceConnectorTerminationCredentialsCommand.ts index 2072ddc7684a8..6c79f596beb37 100644 --- a/clients/client-chime/commands/DeleteVoiceConnectorTerminationCredentialsCommand.ts +++ b/clients/client-chime/commands/DeleteVoiceConnectorTerminationCredentialsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVoiceConnectorTerminationCredentialsCommandInput = DeleteVoiceConnectorTerminationCredentialsRequest; export type DeleteVoiceConnectorTerminationCredentialsCommandOutput = __MetadataBearer; +/** + *

Deletes the specified SIP credentials used by your equipment to authenticate during call termination.

+ */ export class DeleteVoiceConnectorTerminationCredentialsCommand extends $Command< DeleteVoiceConnectorTerminationCredentialsCommandInput, DeleteVoiceConnectorTerminationCredentialsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVoiceConnectorTerminationCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DisassociatePhoneNumberFromUserCommand.ts b/clients/client-chime/commands/DisassociatePhoneNumberFromUserCommand.ts index 9e0873aabb775..87424c0af2c84 100644 --- a/clients/client-chime/commands/DisassociatePhoneNumberFromUserCommand.ts +++ b/clients/client-chime/commands/DisassociatePhoneNumberFromUserCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociatePhoneNumberFromUserCommandInput = DisassociatePhoneNumberFromUserRequest; export type DisassociatePhoneNumberFromUserCommandOutput = DisassociatePhoneNumberFromUserResponse & __MetadataBearer; +/** + *

Disassociates the primary provisioned phone number from the specified Amazon Chime + * user.

+ */ export class DisassociatePhoneNumberFromUserCommand extends $Command< DisassociatePhoneNumberFromUserCommandInput, DisassociatePhoneNumberFromUserCommandOutput, @@ -34,6 +38,9 @@ export class DisassociatePhoneNumberFromUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DisassociatePhoneNumbersFromVoiceConnectorCommand.ts b/clients/client-chime/commands/DisassociatePhoneNumbersFromVoiceConnectorCommand.ts index 192b14e053a1a..2fdfb03341706 100644 --- a/clients/client-chime/commands/DisassociatePhoneNumbersFromVoiceConnectorCommand.ts +++ b/clients/client-chime/commands/DisassociatePhoneNumbersFromVoiceConnectorCommand.ts @@ -24,6 +24,9 @@ export type DisassociatePhoneNumbersFromVoiceConnectorCommandInput = Disassociat export type DisassociatePhoneNumbersFromVoiceConnectorCommandOutput = DisassociatePhoneNumbersFromVoiceConnectorResponse & __MetadataBearer; +/** + *

Disassociates the specified phone numbers from the specified Amazon Chime Voice Connector.

+ */ export class DisassociatePhoneNumbersFromVoiceConnectorCommand extends $Command< DisassociatePhoneNumbersFromVoiceConnectorCommandInput, DisassociatePhoneNumbersFromVoiceConnectorCommandOutput, @@ -38,6 +41,9 @@ export class DisassociatePhoneNumbersFromVoiceConnectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DisassociatePhoneNumbersFromVoiceConnectorGroupCommand.ts b/clients/client-chime/commands/DisassociatePhoneNumbersFromVoiceConnectorGroupCommand.ts index e3f9e159791f2..94b9a3e0e39c0 100644 --- a/clients/client-chime/commands/DisassociatePhoneNumbersFromVoiceConnectorGroupCommand.ts +++ b/clients/client-chime/commands/DisassociatePhoneNumbersFromVoiceConnectorGroupCommand.ts @@ -24,6 +24,9 @@ export type DisassociatePhoneNumbersFromVoiceConnectorGroupCommandInput = Disass export type DisassociatePhoneNumbersFromVoiceConnectorGroupCommandOutput = DisassociatePhoneNumbersFromVoiceConnectorGroupResponse & __MetadataBearer; +/** + *

Disassociates the specified phone numbers from the specified Amazon Chime Voice Connector group.

+ */ export class DisassociatePhoneNumbersFromVoiceConnectorGroupCommand extends $Command< DisassociatePhoneNumbersFromVoiceConnectorGroupCommandInput, DisassociatePhoneNumbersFromVoiceConnectorGroupCommandOutput, @@ -38,6 +41,9 @@ export class DisassociatePhoneNumbersFromVoiceConnectorGroupCommand extends $Com // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/DisassociateSigninDelegateGroupsFromAccountCommand.ts b/clients/client-chime/commands/DisassociateSigninDelegateGroupsFromAccountCommand.ts index 72ec680834e88..30565845a8ddd 100644 --- a/clients/client-chime/commands/DisassociateSigninDelegateGroupsFromAccountCommand.ts +++ b/clients/client-chime/commands/DisassociateSigninDelegateGroupsFromAccountCommand.ts @@ -24,6 +24,9 @@ export type DisassociateSigninDelegateGroupsFromAccountCommandInput = Disassocia export type DisassociateSigninDelegateGroupsFromAccountCommandOutput = DisassociateSigninDelegateGroupsFromAccountResponse & __MetadataBearer; +/** + *

Disassociates the specified sign-in delegate groups from the specified Amazon Chime account.

+ */ export class DisassociateSigninDelegateGroupsFromAccountCommand extends $Command< DisassociateSigninDelegateGroupsFromAccountCommandInput, DisassociateSigninDelegateGroupsFromAccountCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateSigninDelegateGroupsFromAccountCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetAccountCommand.ts b/clients/client-chime/commands/GetAccountCommand.ts index aa63d309541d2..fc5b0b3ed7842 100644 --- a/clients/client-chime/commands/GetAccountCommand.ts +++ b/clients/client-chime/commands/GetAccountCommand.ts @@ -20,6 +20,10 @@ import { export type GetAccountCommandInput = GetAccountRequest; export type GetAccountCommandOutput = GetAccountResponse & __MetadataBearer; +/** + *

Retrieves details for the specified Amazon Chime account, such as account type and + * supported licenses.

+ */ export class GetAccountCommand extends $Command< GetAccountCommandInput, GetAccountCommandOutput, @@ -34,6 +38,9 @@ export class GetAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetAccountSettingsCommand.ts b/clients/client-chime/commands/GetAccountSettingsCommand.ts index 266cd7d65f303..4b615d8573ded 100644 --- a/clients/client-chime/commands/GetAccountSettingsCommand.ts +++ b/clients/client-chime/commands/GetAccountSettingsCommand.ts @@ -20,6 +20,12 @@ import { export type GetAccountSettingsCommandInput = GetAccountSettingsRequest; export type GetAccountSettingsCommandOutput = GetAccountSettingsResponse & __MetadataBearer; +/** + *

Retrieves account settings for the specified Amazon Chime account ID, such as remote control and dial + * out settings. For more information about these settings, see Use the Policies Page in the + * Amazon + * Chime Administration Guide.

+ */ export class GetAccountSettingsCommand extends $Command< GetAccountSettingsCommandInput, GetAccountSettingsCommandOutput, @@ -34,6 +40,9 @@ export class GetAccountSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetAttendeeCommand.ts b/clients/client-chime/commands/GetAttendeeCommand.ts index a773591e7f98d..1fe9a12b086d4 100644 --- a/clients/client-chime/commands/GetAttendeeCommand.ts +++ b/clients/client-chime/commands/GetAttendeeCommand.ts @@ -20,6 +20,9 @@ import { export type GetAttendeeCommandInput = GetAttendeeRequest; export type GetAttendeeCommandOutput = GetAttendeeResponse & __MetadataBearer; +/** + *

Gets the Amazon Chime SDK attendee details for a specified meeting ID and attendee ID. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class GetAttendeeCommand extends $Command< GetAttendeeCommandInput, GetAttendeeCommandOutput, @@ -34,6 +37,9 @@ export class GetAttendeeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetBotCommand.ts b/clients/client-chime/commands/GetBotCommand.ts index 1e2dcc3f88b8b..eb47c3381e2e1 100644 --- a/clients/client-chime/commands/GetBotCommand.ts +++ b/clients/client-chime/commands/GetBotCommand.ts @@ -17,6 +17,9 @@ import { export type GetBotCommandInput = GetBotRequest; export type GetBotCommandOutput = GetBotResponse & __MetadataBearer; +/** + *

Retrieves details for the specified bot, such as bot email address, bot type, status, and display name.

+ */ export class GetBotCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetBotCommand extends $Command, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetEventsConfigurationCommand.ts b/clients/client-chime/commands/GetEventsConfigurationCommand.ts index c1a4c1455b90f..2ca065cd6a47b 100644 --- a/clients/client-chime/commands/GetEventsConfigurationCommand.ts +++ b/clients/client-chime/commands/GetEventsConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetEventsConfigurationCommandInput = GetEventsConfigurationRequest; export type GetEventsConfigurationCommandOutput = GetEventsConfigurationResponse & __MetadataBearer; +/** + *

Gets details for an events configuration that allows a bot to receive outgoing events, such as an HTTPS endpoint or Lambda function ARN.

+ */ export class GetEventsConfigurationCommand extends $Command< GetEventsConfigurationCommandInput, GetEventsConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetEventsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetGlobalSettingsCommand.ts b/clients/client-chime/commands/GetGlobalSettingsCommand.ts index 9dd5d1f55e931..0a53c915a0ad6 100644 --- a/clients/client-chime/commands/GetGlobalSettingsCommand.ts +++ b/clients/client-chime/commands/GetGlobalSettingsCommand.ts @@ -20,6 +20,10 @@ import { export type GetGlobalSettingsCommandInput = {}; export type GetGlobalSettingsCommandOutput = GetGlobalSettingsResponse & __MetadataBearer; +/** + *

Retrieves global settings for the administrator's AWS account, such as Amazon + * Chime Business Calling and Amazon Chime Voice Connector settings.

+ */ export class GetGlobalSettingsCommand extends $Command< GetGlobalSettingsCommandInput, GetGlobalSettingsCommandOutput, @@ -34,6 +38,9 @@ export class GetGlobalSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetMeetingCommand.ts b/clients/client-chime/commands/GetMeetingCommand.ts index c4f9c3c3b552a..0a3c189443d91 100644 --- a/clients/client-chime/commands/GetMeetingCommand.ts +++ b/clients/client-chime/commands/GetMeetingCommand.ts @@ -20,6 +20,9 @@ import { export type GetMeetingCommandInput = GetMeetingRequest; export type GetMeetingCommandOutput = GetMeetingResponse & __MetadataBearer; +/** + *

Gets the Amazon Chime SDK meeting details for the specified meeting ID. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class GetMeetingCommand extends $Command< GetMeetingCommandInput, GetMeetingCommandOutput, @@ -34,6 +37,9 @@ export class GetMeetingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetPhoneNumberCommand.ts b/clients/client-chime/commands/GetPhoneNumberCommand.ts index 15cb4113d3e61..b162c3daa52ec 100644 --- a/clients/client-chime/commands/GetPhoneNumberCommand.ts +++ b/clients/client-chime/commands/GetPhoneNumberCommand.ts @@ -20,6 +20,10 @@ import { export type GetPhoneNumberCommandInput = GetPhoneNumberRequest; export type GetPhoneNumberCommandOutput = GetPhoneNumberResponse & __MetadataBearer; +/** + *

Retrieves details for the specified phone number ID, such as associations, + * capabilities, and product type.

+ */ export class GetPhoneNumberCommand extends $Command< GetPhoneNumberCommandInput, GetPhoneNumberCommandOutput, @@ -34,6 +38,9 @@ export class GetPhoneNumberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetPhoneNumberOrderCommand.ts b/clients/client-chime/commands/GetPhoneNumberOrderCommand.ts index ba0167bf9abdf..4c1f4037f2f70 100644 --- a/clients/client-chime/commands/GetPhoneNumberOrderCommand.ts +++ b/clients/client-chime/commands/GetPhoneNumberOrderCommand.ts @@ -20,6 +20,10 @@ import { export type GetPhoneNumberOrderCommandInput = GetPhoneNumberOrderRequest; export type GetPhoneNumberOrderCommandOutput = GetPhoneNumberOrderResponse & __MetadataBearer; +/** + *

Retrieves details for the specified phone number order, such as order creation + * timestamp, phone numbers in E.164 format, product type, and order status.

+ */ export class GetPhoneNumberOrderCommand extends $Command< GetPhoneNumberOrderCommandInput, GetPhoneNumberOrderCommandOutput, @@ -34,6 +38,9 @@ export class GetPhoneNumberOrderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetPhoneNumberSettingsCommand.ts b/clients/client-chime/commands/GetPhoneNumberSettingsCommand.ts index 0d9cc14eca0bd..cc5ad1a9f88d2 100644 --- a/clients/client-chime/commands/GetPhoneNumberSettingsCommand.ts +++ b/clients/client-chime/commands/GetPhoneNumberSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetPhoneNumberSettingsCommandInput = {}; export type GetPhoneNumberSettingsCommandOutput = GetPhoneNumberSettingsResponse & __MetadataBearer; +/** + *

Retrieves the phone number settings for the administrator's AWS account, such as the default outbound calling name.

+ */ export class GetPhoneNumberSettingsCommand extends $Command< GetPhoneNumberSettingsCommandInput, GetPhoneNumberSettingsCommandOutput, @@ -34,6 +37,9 @@ export class GetPhoneNumberSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetProxySessionCommand.ts b/clients/client-chime/commands/GetProxySessionCommand.ts index 92fd4cfaea8e7..b10d74e1c090e 100644 --- a/clients/client-chime/commands/GetProxySessionCommand.ts +++ b/clients/client-chime/commands/GetProxySessionCommand.ts @@ -20,6 +20,9 @@ import { export type GetProxySessionCommandInput = GetProxySessionRequest; export type GetProxySessionCommandOutput = GetProxySessionResponse & __MetadataBearer; +/** + *

Gets the specified proxy session details for the specified Amazon Chime Voice Connector.

+ */ export class GetProxySessionCommand extends $Command< GetProxySessionCommandInput, GetProxySessionCommandOutput, @@ -34,6 +37,9 @@ export class GetProxySessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetRetentionSettingsCommand.ts b/clients/client-chime/commands/GetRetentionSettingsCommand.ts index 47dae641752ee..a252d098b908a 100644 --- a/clients/client-chime/commands/GetRetentionSettingsCommand.ts +++ b/clients/client-chime/commands/GetRetentionSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetRetentionSettingsCommandInput = GetRetentionSettingsRequest; export type GetRetentionSettingsCommandOutput = GetRetentionSettingsResponse & __MetadataBearer; +/** + *

Gets the retention settings for the specified Amazon Chime Enterprise account. For more information about retention settings, see Managing Chat Retention Policies in the Amazon Chime Administration Guide.

+ */ export class GetRetentionSettingsCommand extends $Command< GetRetentionSettingsCommandInput, GetRetentionSettingsCommandOutput, @@ -34,6 +37,9 @@ export class GetRetentionSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetRoomCommand.ts b/clients/client-chime/commands/GetRoomCommand.ts index 426a9ac9a9573..b7f328a2b31f4 100644 --- a/clients/client-chime/commands/GetRoomCommand.ts +++ b/clients/client-chime/commands/GetRoomCommand.ts @@ -20,6 +20,9 @@ import { export type GetRoomCommandInput = GetRoomRequest; export type GetRoomCommandOutput = GetRoomResponse & __MetadataBearer; +/** + *

Retrieves room details, such as the room name, for a room in an Amazon Chime Enterprise account.

+ */ export class GetRoomCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class GetRoomCommand extends $Command, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetSipMediaApplicationCommand.ts b/clients/client-chime/commands/GetSipMediaApplicationCommand.ts index 9b65b2ddec8ae..ca210d827300e 100644 --- a/clients/client-chime/commands/GetSipMediaApplicationCommand.ts +++ b/clients/client-chime/commands/GetSipMediaApplicationCommand.ts @@ -20,6 +20,10 @@ import { export type GetSipMediaApplicationCommandInput = GetSipMediaApplicationRequest; export type GetSipMediaApplicationCommandOutput = GetSipMediaApplicationResponse & __MetadataBearer; +/** + *

Retrieves the information for a SIP media application, including name, AWS Region, and + * endpoints.

+ */ export class GetSipMediaApplicationCommand extends $Command< GetSipMediaApplicationCommandInput, GetSipMediaApplicationCommandOutput, @@ -34,6 +38,9 @@ export class GetSipMediaApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetSipMediaApplicationLoggingConfigurationCommand.ts b/clients/client-chime/commands/GetSipMediaApplicationLoggingConfigurationCommand.ts index 3d7fb28a89eaa..9a35fbd4f93a8 100644 --- a/clients/client-chime/commands/GetSipMediaApplicationLoggingConfigurationCommand.ts +++ b/clients/client-chime/commands/GetSipMediaApplicationLoggingConfigurationCommand.ts @@ -24,6 +24,9 @@ export type GetSipMediaApplicationLoggingConfigurationCommandInput = GetSipMedia export type GetSipMediaApplicationLoggingConfigurationCommandOutput = GetSipMediaApplicationLoggingConfigurationResponse & __MetadataBearer; +/** + *

Returns the logging configuration for the specified SIP media application.

+ */ export class GetSipMediaApplicationLoggingConfigurationCommand extends $Command< GetSipMediaApplicationLoggingConfigurationCommandInput, GetSipMediaApplicationLoggingConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class GetSipMediaApplicationLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetSipRuleCommand.ts b/clients/client-chime/commands/GetSipRuleCommand.ts index db33cd7870c1f..d2618ba72d512 100644 --- a/clients/client-chime/commands/GetSipRuleCommand.ts +++ b/clients/client-chime/commands/GetSipRuleCommand.ts @@ -20,6 +20,10 @@ import { export type GetSipRuleCommandInput = GetSipRuleRequest; export type GetSipRuleCommandOutput = GetSipRuleResponse & __MetadataBearer; +/** + *

Retrieves the details of a SIP rule, such as the rule ID, name, triggers, and target + * endpoints.

+ */ export class GetSipRuleCommand extends $Command< GetSipRuleCommandInput, GetSipRuleCommandOutput, @@ -34,6 +38,9 @@ export class GetSipRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetUserCommand.ts b/clients/client-chime/commands/GetUserCommand.ts index ea287e019a99e..5f1ee88e44536 100644 --- a/clients/client-chime/commands/GetUserCommand.ts +++ b/clients/client-chime/commands/GetUserCommand.ts @@ -20,6 +20,11 @@ import { export type GetUserCommandInput = GetUserRequest; export type GetUserCommandOutput = GetUserResponse & __MetadataBearer; +/** + *

Retrieves details for the specified user ID, such as primary email address, license type, + * and personal meeting PIN.

+ *

To retrieve user details with an email address instead of a user ID, use the ListUsers action, and then filter by email address.

+ */ export class GetUserCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +35,9 @@ export class GetUserCommand extends $Command, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetUserSettingsCommand.ts b/clients/client-chime/commands/GetUserSettingsCommand.ts index 0d7c0ee032dee..91a1c4c1a6957 100644 --- a/clients/client-chime/commands/GetUserSettingsCommand.ts +++ b/clients/client-chime/commands/GetUserSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetUserSettingsCommandInput = GetUserSettingsRequest; export type GetUserSettingsCommandOutput = GetUserSettingsResponse & __MetadataBearer; +/** + *

Retrieves settings for the specified user ID, such as any associated phone number settings.

+ */ export class GetUserSettingsCommand extends $Command< GetUserSettingsCommandInput, GetUserSettingsCommandOutput, @@ -34,6 +37,9 @@ export class GetUserSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorCommand.ts b/clients/client-chime/commands/GetVoiceConnectorCommand.ts index 0a1e13626bc2a..e0aa65a8b8048 100644 --- a/clients/client-chime/commands/GetVoiceConnectorCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorCommand.ts @@ -20,6 +20,10 @@ import { export type GetVoiceConnectorCommandInput = GetVoiceConnectorRequest; export type GetVoiceConnectorCommandOutput = GetVoiceConnectorResponse & __MetadataBearer; +/** + *

Retrieves details for the specified Amazon Chime Voice Connector, such as timestamps, + * name, outbound host, and encryption requirements.

+ */ export class GetVoiceConnectorCommand extends $Command< GetVoiceConnectorCommandInput, GetVoiceConnectorCommandOutput, @@ -34,6 +38,9 @@ export class GetVoiceConnectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorEmergencyCallingConfigurationCommand.ts b/clients/client-chime/commands/GetVoiceConnectorEmergencyCallingConfigurationCommand.ts index 0a066ea4d6c43..28159dddf9729 100644 --- a/clients/client-chime/commands/GetVoiceConnectorEmergencyCallingConfigurationCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorEmergencyCallingConfigurationCommand.ts @@ -24,6 +24,9 @@ export type GetVoiceConnectorEmergencyCallingConfigurationCommandInput = GetVoic export type GetVoiceConnectorEmergencyCallingConfigurationCommandOutput = GetVoiceConnectorEmergencyCallingConfigurationResponse & __MetadataBearer; +/** + *

Gets the emergency calling configuration details for the specified Amazon Chime Voice Connector.

+ */ export class GetVoiceConnectorEmergencyCallingConfigurationCommand extends $Command< GetVoiceConnectorEmergencyCallingConfigurationCommandInput, GetVoiceConnectorEmergencyCallingConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class GetVoiceConnectorEmergencyCallingConfigurationCommand extends $Comm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorGroupCommand.ts b/clients/client-chime/commands/GetVoiceConnectorGroupCommand.ts index 54d07188774d8..aead7332dd63d 100644 --- a/clients/client-chime/commands/GetVoiceConnectorGroupCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorGroupCommand.ts @@ -20,6 +20,10 @@ import { export type GetVoiceConnectorGroupCommandInput = GetVoiceConnectorGroupRequest; export type GetVoiceConnectorGroupCommandOutput = GetVoiceConnectorGroupResponse & __MetadataBearer; +/** + *

Retrieves details for the specified Amazon Chime Voice Connector group, such as timestamps, + * name, and associated VoiceConnectorItems.

+ */ export class GetVoiceConnectorGroupCommand extends $Command< GetVoiceConnectorGroupCommandInput, GetVoiceConnectorGroupCommandOutput, @@ -34,6 +38,9 @@ export class GetVoiceConnectorGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorLoggingConfigurationCommand.ts b/clients/client-chime/commands/GetVoiceConnectorLoggingConfigurationCommand.ts index 400f4983c1268..e2217ca41579f 100644 --- a/clients/client-chime/commands/GetVoiceConnectorLoggingConfigurationCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorLoggingConfigurationCommand.ts @@ -24,6 +24,11 @@ export type GetVoiceConnectorLoggingConfigurationCommandInput = GetVoiceConnecto export type GetVoiceConnectorLoggingConfigurationCommandOutput = GetVoiceConnectorLoggingConfigurationResponse & __MetadataBearer; +/** + *

Retrieves the logging configuration details for the specified Amazon Chime Voice + * Connector. Shows whether SIP message logs are enabled for sending to Amazon CloudWatch + * Logs.

+ */ export class GetVoiceConnectorLoggingConfigurationCommand extends $Command< GetVoiceConnectorLoggingConfigurationCommandInput, GetVoiceConnectorLoggingConfigurationCommandOutput, @@ -38,6 +43,9 @@ export class GetVoiceConnectorLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorOriginationCommand.ts b/clients/client-chime/commands/GetVoiceConnectorOriginationCommand.ts index 2507842ab7eff..e4f750dae1a46 100644 --- a/clients/client-chime/commands/GetVoiceConnectorOriginationCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorOriginationCommand.ts @@ -20,6 +20,9 @@ import { export type GetVoiceConnectorOriginationCommandInput = GetVoiceConnectorOriginationRequest; export type GetVoiceConnectorOriginationCommandOutput = GetVoiceConnectorOriginationResponse & __MetadataBearer; +/** + *

Retrieves origination setting details for the specified Amazon Chime Voice Connector.

+ */ export class GetVoiceConnectorOriginationCommand extends $Command< GetVoiceConnectorOriginationCommandInput, GetVoiceConnectorOriginationCommandOutput, @@ -34,6 +37,9 @@ export class GetVoiceConnectorOriginationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorProxyCommand.ts b/clients/client-chime/commands/GetVoiceConnectorProxyCommand.ts index 36aa9cb5ca042..736543b02f7f1 100644 --- a/clients/client-chime/commands/GetVoiceConnectorProxyCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorProxyCommand.ts @@ -20,6 +20,9 @@ import { export type GetVoiceConnectorProxyCommandInput = GetVoiceConnectorProxyRequest; export type GetVoiceConnectorProxyCommandOutput = GetVoiceConnectorProxyResponse & __MetadataBearer; +/** + *

Gets the proxy configuration details for the specified Amazon Chime Voice Connector.

+ */ export class GetVoiceConnectorProxyCommand extends $Command< GetVoiceConnectorProxyCommandInput, GetVoiceConnectorProxyCommandOutput, @@ -34,6 +37,9 @@ export class GetVoiceConnectorProxyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorStreamingConfigurationCommand.ts b/clients/client-chime/commands/GetVoiceConnectorStreamingConfigurationCommand.ts index d1d9112a453f0..e5bf5ff973ea6 100644 --- a/clients/client-chime/commands/GetVoiceConnectorStreamingConfigurationCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorStreamingConfigurationCommand.ts @@ -24,6 +24,11 @@ export type GetVoiceConnectorStreamingConfigurationCommandInput = GetVoiceConnec export type GetVoiceConnectorStreamingConfigurationCommandOutput = GetVoiceConnectorStreamingConfigurationResponse & __MetadataBearer; +/** + *

Retrieves the streaming configuration details for the specified Amazon Chime Voice + * Connector. Shows whether media streaming is enabled for sending to Amazon Kinesis. It also + * shows the retention period, in hours, for the Amazon Kinesis data.

+ */ export class GetVoiceConnectorStreamingConfigurationCommand extends $Command< GetVoiceConnectorStreamingConfigurationCommandInput, GetVoiceConnectorStreamingConfigurationCommandOutput, @@ -38,6 +43,9 @@ export class GetVoiceConnectorStreamingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorTerminationCommand.ts b/clients/client-chime/commands/GetVoiceConnectorTerminationCommand.ts index be827743c0869..8c2e735a7dbdd 100644 --- a/clients/client-chime/commands/GetVoiceConnectorTerminationCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorTerminationCommand.ts @@ -20,6 +20,9 @@ import { export type GetVoiceConnectorTerminationCommandInput = GetVoiceConnectorTerminationRequest; export type GetVoiceConnectorTerminationCommandOutput = GetVoiceConnectorTerminationResponse & __MetadataBearer; +/** + *

Retrieves termination setting details for the specified Amazon Chime Voice Connector.

+ */ export class GetVoiceConnectorTerminationCommand extends $Command< GetVoiceConnectorTerminationCommandInput, GetVoiceConnectorTerminationCommandOutput, @@ -34,6 +37,9 @@ export class GetVoiceConnectorTerminationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/GetVoiceConnectorTerminationHealthCommand.ts b/clients/client-chime/commands/GetVoiceConnectorTerminationHealthCommand.ts index bd8124af905f0..dbb9a84e323a7 100644 --- a/clients/client-chime/commands/GetVoiceConnectorTerminationHealthCommand.ts +++ b/clients/client-chime/commands/GetVoiceConnectorTerminationHealthCommand.ts @@ -24,6 +24,10 @@ export type GetVoiceConnectorTerminationHealthCommandInput = GetVoiceConnectorTe export type GetVoiceConnectorTerminationHealthCommandOutput = GetVoiceConnectorTerminationHealthResponse & __MetadataBearer; +/** + *

Retrieves information about the last time a SIP OPTIONS ping was received + * from your SIP infrastructure for the specified Amazon Chime Voice Connector.

+ */ export class GetVoiceConnectorTerminationHealthCommand extends $Command< GetVoiceConnectorTerminationHealthCommandInput, GetVoiceConnectorTerminationHealthCommandOutput, @@ -38,6 +42,9 @@ export class GetVoiceConnectorTerminationHealthCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/InviteUsersCommand.ts b/clients/client-chime/commands/InviteUsersCommand.ts index 794e1080672d4..f9534dbc52bf4 100644 --- a/clients/client-chime/commands/InviteUsersCommand.ts +++ b/clients/client-chime/commands/InviteUsersCommand.ts @@ -20,6 +20,11 @@ import { export type InviteUsersCommandInput = InviteUsersRequest; export type InviteUsersCommandOutput = InviteUsersResponse & __MetadataBearer; +/** + *

Sends email to a maximum of 50 users, inviting them to the specified Amazon Chime + * Team account. Only Team account types are currently supported for + * this action.

+ */ export class InviteUsersCommand extends $Command< InviteUsersCommandInput, InviteUsersCommandOutput, @@ -34,6 +39,9 @@ export class InviteUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListAccountsCommand.ts b/clients/client-chime/commands/ListAccountsCommand.ts index c7fb94feed40e..ecb8936eba6b1 100644 --- a/clients/client-chime/commands/ListAccountsCommand.ts +++ b/clients/client-chime/commands/ListAccountsCommand.ts @@ -20,6 +20,11 @@ import { export type ListAccountsCommandInput = ListAccountsRequest; export type ListAccountsCommandOutput = ListAccountsResponse & __MetadataBearer; +/** + *

Lists the Amazon Chime accounts under the administrator's AWS account. You can filter + * accounts by account name prefix. To find out which Amazon Chime account a user belongs to, you + * can filter by the user's email address, which returns one account result.

+ */ export class ListAccountsCommand extends $Command< ListAccountsCommandInput, ListAccountsCommandOutput, @@ -34,6 +39,9 @@ export class ListAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListAttendeeTagsCommand.ts b/clients/client-chime/commands/ListAttendeeTagsCommand.ts index 5c1458efaad4d..67b6a81a24979 100644 --- a/clients/client-chime/commands/ListAttendeeTagsCommand.ts +++ b/clients/client-chime/commands/ListAttendeeTagsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAttendeeTagsCommandInput = ListAttendeeTagsRequest; export type ListAttendeeTagsCommandOutput = ListAttendeeTagsResponse & __MetadataBearer; +/** + *

Lists the tags applied to an Amazon Chime SDK attendee resource.

+ */ export class ListAttendeeTagsCommand extends $Command< ListAttendeeTagsCommandInput, ListAttendeeTagsCommandOutput, @@ -34,6 +37,9 @@ export class ListAttendeeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListAttendeesCommand.ts b/clients/client-chime/commands/ListAttendeesCommand.ts index 9a95c646f2ac2..0b79408406761 100644 --- a/clients/client-chime/commands/ListAttendeesCommand.ts +++ b/clients/client-chime/commands/ListAttendeesCommand.ts @@ -20,6 +20,9 @@ import { export type ListAttendeesCommandInput = ListAttendeesRequest; export type ListAttendeesCommandOutput = ListAttendeesResponse & __MetadataBearer; +/** + *

Lists the attendees for the specified Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class ListAttendeesCommand extends $Command< ListAttendeesCommandInput, ListAttendeesCommandOutput, @@ -34,6 +37,9 @@ export class ListAttendeesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListBotsCommand.ts b/clients/client-chime/commands/ListBotsCommand.ts index 6b30be22f4f27..dd3074a0e66ef 100644 --- a/clients/client-chime/commands/ListBotsCommand.ts +++ b/clients/client-chime/commands/ListBotsCommand.ts @@ -20,6 +20,9 @@ import { export type ListBotsCommandInput = ListBotsRequest; export type ListBotsCommandOutput = ListBotsResponse & __MetadataBearer; +/** + *

Lists the bots associated with the administrator's Amazon Chime Enterprise account ID.

+ */ export class ListBotsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class ListBotsCommand extends $Command, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListMeetingTagsCommand.ts b/clients/client-chime/commands/ListMeetingTagsCommand.ts index 40e3e8464a8e4..765170faecbb1 100644 --- a/clients/client-chime/commands/ListMeetingTagsCommand.ts +++ b/clients/client-chime/commands/ListMeetingTagsCommand.ts @@ -20,6 +20,9 @@ import { export type ListMeetingTagsCommandInput = ListMeetingTagsRequest; export type ListMeetingTagsCommandOutput = ListMeetingTagsResponse & __MetadataBearer; +/** + *

Lists the tags applied to an Amazon Chime SDK meeting resource.

+ */ export class ListMeetingTagsCommand extends $Command< ListMeetingTagsCommandInput, ListMeetingTagsCommandOutput, @@ -34,6 +37,9 @@ export class ListMeetingTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListMeetingsCommand.ts b/clients/client-chime/commands/ListMeetingsCommand.ts index 2d6e55d0761e4..a3978e4e85b02 100644 --- a/clients/client-chime/commands/ListMeetingsCommand.ts +++ b/clients/client-chime/commands/ListMeetingsCommand.ts @@ -20,6 +20,9 @@ import { export type ListMeetingsCommandInput = ListMeetingsRequest; export type ListMeetingsCommandOutput = ListMeetingsResponse & __MetadataBearer; +/** + *

Lists up to 100 active Amazon Chime SDK meetings. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.

+ */ export class ListMeetingsCommand extends $Command< ListMeetingsCommandInput, ListMeetingsCommandOutput, @@ -34,6 +37,9 @@ export class ListMeetingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListPhoneNumberOrdersCommand.ts b/clients/client-chime/commands/ListPhoneNumberOrdersCommand.ts index d29fdf9e3284b..ca965cc331557 100644 --- a/clients/client-chime/commands/ListPhoneNumberOrdersCommand.ts +++ b/clients/client-chime/commands/ListPhoneNumberOrdersCommand.ts @@ -20,6 +20,9 @@ import { export type ListPhoneNumberOrdersCommandInput = ListPhoneNumberOrdersRequest; export type ListPhoneNumberOrdersCommandOutput = ListPhoneNumberOrdersResponse & __MetadataBearer; +/** + *

Lists the phone number orders for the administrator's Amazon Chime account.

+ */ export class ListPhoneNumberOrdersCommand extends $Command< ListPhoneNumberOrdersCommandInput, ListPhoneNumberOrdersCommandOutput, @@ -34,6 +37,9 @@ export class ListPhoneNumberOrdersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListPhoneNumbersCommand.ts b/clients/client-chime/commands/ListPhoneNumbersCommand.ts index 602c3523aba58..9278e8c26d0dd 100644 --- a/clients/client-chime/commands/ListPhoneNumbersCommand.ts +++ b/clients/client-chime/commands/ListPhoneNumbersCommand.ts @@ -20,6 +20,9 @@ import { export type ListPhoneNumbersCommandInput = ListPhoneNumbersRequest; export type ListPhoneNumbersCommandOutput = ListPhoneNumbersResponse & __MetadataBearer; +/** + *

Lists the phone numbers for the specified Amazon Chime account, Amazon Chime user, Amazon Chime Voice Connector, or Amazon Chime Voice Connector group.

+ */ export class ListPhoneNumbersCommand extends $Command< ListPhoneNumbersCommandInput, ListPhoneNumbersCommandOutput, @@ -34,6 +37,9 @@ export class ListPhoneNumbersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListProxySessionsCommand.ts b/clients/client-chime/commands/ListProxySessionsCommand.ts index f42643e2f9588..68f4aa06cbc8f 100644 --- a/clients/client-chime/commands/ListProxySessionsCommand.ts +++ b/clients/client-chime/commands/ListProxySessionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProxySessionsCommandInput = ListProxySessionsRequest; export type ListProxySessionsCommandOutput = ListProxySessionsResponse & __MetadataBearer; +/** + *

Lists the proxy sessions for the specified Amazon Chime Voice Connector.

+ */ export class ListProxySessionsCommand extends $Command< ListProxySessionsCommandInput, ListProxySessionsCommandOutput, @@ -34,6 +37,9 @@ export class ListProxySessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListRoomMembershipsCommand.ts b/clients/client-chime/commands/ListRoomMembershipsCommand.ts index 35aa5978c08fb..4bd813eaf2575 100644 --- a/clients/client-chime/commands/ListRoomMembershipsCommand.ts +++ b/clients/client-chime/commands/ListRoomMembershipsCommand.ts @@ -20,6 +20,10 @@ import { export type ListRoomMembershipsCommandInput = ListRoomMembershipsRequest; export type ListRoomMembershipsCommandOutput = ListRoomMembershipsResponse & __MetadataBearer; +/** + *

Lists the membership details for the specified room in an Amazon Chime Enterprise account, such as the members' IDs, email + * addresses, and names.

+ */ export class ListRoomMembershipsCommand extends $Command< ListRoomMembershipsCommandInput, ListRoomMembershipsCommandOutput, @@ -34,6 +38,9 @@ export class ListRoomMembershipsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListRoomsCommand.ts b/clients/client-chime/commands/ListRoomsCommand.ts index 7dc21cf957102..e926d4f2666ba 100644 --- a/clients/client-chime/commands/ListRoomsCommand.ts +++ b/clients/client-chime/commands/ListRoomsCommand.ts @@ -20,6 +20,9 @@ import { export type ListRoomsCommandInput = ListRoomsRequest; export type ListRoomsCommandOutput = ListRoomsResponse & __MetadataBearer; +/** + *

Lists the room details for the specified Amazon Chime Enterprise account. Optionally, filter the results by a member ID (user ID or bot ID) to see a list of rooms that the member belongs to.

+ */ export class ListRoomsCommand extends $Command< ListRoomsCommandInput, ListRoomsCommandOutput, @@ -34,6 +37,9 @@ export class ListRoomsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListSipMediaApplicationsCommand.ts b/clients/client-chime/commands/ListSipMediaApplicationsCommand.ts index bfcb7f394aa33..b4fcfea627aaa 100644 --- a/clients/client-chime/commands/ListSipMediaApplicationsCommand.ts +++ b/clients/client-chime/commands/ListSipMediaApplicationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSipMediaApplicationsCommandInput = ListSipMediaApplicationsRequest; export type ListSipMediaApplicationsCommandOutput = ListSipMediaApplicationsResponse & __MetadataBearer; +/** + *

Lists the SIP media applications under the administrator's AWS account.

+ */ export class ListSipMediaApplicationsCommand extends $Command< ListSipMediaApplicationsCommandInput, ListSipMediaApplicationsCommandOutput, @@ -34,6 +37,9 @@ export class ListSipMediaApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListSipRulesCommand.ts b/clients/client-chime/commands/ListSipRulesCommand.ts index 973b09410b9b8..3bae51571f7e8 100644 --- a/clients/client-chime/commands/ListSipRulesCommand.ts +++ b/clients/client-chime/commands/ListSipRulesCommand.ts @@ -20,6 +20,9 @@ import { export type ListSipRulesCommandInput = ListSipRulesRequest; export type ListSipRulesCommandOutput = ListSipRulesResponse & __MetadataBearer; +/** + *

Lists the SIP rules under the administrator's AWS account.

+ */ export class ListSipRulesCommand extends $Command< ListSipRulesCommandInput, ListSipRulesCommandOutput, @@ -34,6 +37,9 @@ export class ListSipRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListTagsForResourceCommand.ts b/clients/client-chime/commands/ListTagsForResourceCommand.ts index fc5f6aefcf545..126a770ee2db5 100644 --- a/clients/client-chime/commands/ListTagsForResourceCommand.ts +++ b/clients/client-chime/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags applied to an Amazon Chime SDK meeting resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListUsersCommand.ts b/clients/client-chime/commands/ListUsersCommand.ts index f2e70dab5d2a0..e2129f70f0670 100644 --- a/clients/client-chime/commands/ListUsersCommand.ts +++ b/clients/client-chime/commands/ListUsersCommand.ts @@ -20,6 +20,10 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + *

Lists the users that belong to the specified Amazon Chime account. You can specify an + * email address to list only the user that the email address belongs to.

+ */ export class ListUsersCommand extends $Command< ListUsersCommandInput, ListUsersCommandOutput, @@ -34,6 +38,9 @@ export class ListUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListVoiceConnectorGroupsCommand.ts b/clients/client-chime/commands/ListVoiceConnectorGroupsCommand.ts index 0e9e523169161..0238108524cfc 100644 --- a/clients/client-chime/commands/ListVoiceConnectorGroupsCommand.ts +++ b/clients/client-chime/commands/ListVoiceConnectorGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListVoiceConnectorGroupsCommandInput = ListVoiceConnectorGroupsRequest; export type ListVoiceConnectorGroupsCommandOutput = ListVoiceConnectorGroupsResponse & __MetadataBearer; +/** + *

Lists the Amazon Chime Voice Connector groups for the administrator's AWS account.

+ */ export class ListVoiceConnectorGroupsCommand extends $Command< ListVoiceConnectorGroupsCommandInput, ListVoiceConnectorGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListVoiceConnectorGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListVoiceConnectorTerminationCredentialsCommand.ts b/clients/client-chime/commands/ListVoiceConnectorTerminationCredentialsCommand.ts index 0221b8dc59896..2d299841245ad 100644 --- a/clients/client-chime/commands/ListVoiceConnectorTerminationCredentialsCommand.ts +++ b/clients/client-chime/commands/ListVoiceConnectorTerminationCredentialsCommand.ts @@ -24,6 +24,9 @@ export type ListVoiceConnectorTerminationCredentialsCommandInput = ListVoiceConn export type ListVoiceConnectorTerminationCredentialsCommandOutput = ListVoiceConnectorTerminationCredentialsResponse & __MetadataBearer; +/** + *

Lists the SIP credentials for the specified Amazon Chime Voice Connector.

+ */ export class ListVoiceConnectorTerminationCredentialsCommand extends $Command< ListVoiceConnectorTerminationCredentialsCommandInput, ListVoiceConnectorTerminationCredentialsCommandOutput, @@ -38,6 +41,9 @@ export class ListVoiceConnectorTerminationCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ListVoiceConnectorsCommand.ts b/clients/client-chime/commands/ListVoiceConnectorsCommand.ts index a2f707d38a70c..8d22b4ce302e1 100644 --- a/clients/client-chime/commands/ListVoiceConnectorsCommand.ts +++ b/clients/client-chime/commands/ListVoiceConnectorsCommand.ts @@ -20,6 +20,9 @@ import { export type ListVoiceConnectorsCommandInput = ListVoiceConnectorsRequest; export type ListVoiceConnectorsCommandOutput = ListVoiceConnectorsResponse & __MetadataBearer; +/** + *

Lists the Amazon Chime Voice Connectors for the administrator's AWS account.

+ */ export class ListVoiceConnectorsCommand extends $Command< ListVoiceConnectorsCommandInput, ListVoiceConnectorsCommandOutput, @@ -34,6 +37,9 @@ export class ListVoiceConnectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/LogoutUserCommand.ts b/clients/client-chime/commands/LogoutUserCommand.ts index ec9f5b6772e33..64f9cda0a054b 100644 --- a/clients/client-chime/commands/LogoutUserCommand.ts +++ b/clients/client-chime/commands/LogoutUserCommand.ts @@ -20,6 +20,9 @@ import { export type LogoutUserCommandInput = LogoutUserRequest; export type LogoutUserCommandOutput = LogoutUserResponse & __MetadataBearer; +/** + *

Logs out the specified user from all of the devices they are currently logged into.

+ */ export class LogoutUserCommand extends $Command< LogoutUserCommandInput, LogoutUserCommandOutput, @@ -34,6 +37,9 @@ export class LogoutUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutEventsConfigurationCommand.ts b/clients/client-chime/commands/PutEventsConfigurationCommand.ts index 0c72bfc1d3dd4..5381eed112929 100644 --- a/clients/client-chime/commands/PutEventsConfigurationCommand.ts +++ b/clients/client-chime/commands/PutEventsConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type PutEventsConfigurationCommandInput = PutEventsConfigurationRequest; export type PutEventsConfigurationCommandOutput = PutEventsConfigurationResponse & __MetadataBearer; +/** + *

Creates an events configuration that allows a bot to receive outgoing events sent by Amazon Chime. + * Choose either an HTTPS endpoint or a Lambda function ARN. For more information, see Bot.

+ */ export class PutEventsConfigurationCommand extends $Command< PutEventsConfigurationCommandInput, PutEventsConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class PutEventsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutRetentionSettingsCommand.ts b/clients/client-chime/commands/PutRetentionSettingsCommand.ts index c50b13fbf04d7..f3a6b16a34824 100644 --- a/clients/client-chime/commands/PutRetentionSettingsCommand.ts +++ b/clients/client-chime/commands/PutRetentionSettingsCommand.ts @@ -20,6 +20,10 @@ import { export type PutRetentionSettingsCommandInput = PutRetentionSettingsRequest; export type PutRetentionSettingsCommandOutput = PutRetentionSettingsResponse & __MetadataBearer; +/** + *

Puts retention settings for the specified Amazon Chime Enterprise account. We recommend using AWS CloudTrail to monitor usage of this API for your account. For more information, see Logging Amazon Chime API Calls with AWS CloudTrail in the Amazon Chime Administration Guide.

+ *

To turn off existing retention settings, remove the number of days from the corresponding RetentionDays field in the RetentionSettings object. For more information about retention settings, see Managing Chat Retention Policies in the Amazon Chime Administration Guide.

+ */ export class PutRetentionSettingsCommand extends $Command< PutRetentionSettingsCommandInput, PutRetentionSettingsCommandOutput, @@ -34,6 +38,9 @@ export class PutRetentionSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutSipMediaApplicationLoggingConfigurationCommand.ts b/clients/client-chime/commands/PutSipMediaApplicationLoggingConfigurationCommand.ts index ebf931c0ac960..83dcfae015b05 100644 --- a/clients/client-chime/commands/PutSipMediaApplicationLoggingConfigurationCommand.ts +++ b/clients/client-chime/commands/PutSipMediaApplicationLoggingConfigurationCommand.ts @@ -24,6 +24,9 @@ export type PutSipMediaApplicationLoggingConfigurationCommandInput = PutSipMedia export type PutSipMediaApplicationLoggingConfigurationCommandOutput = PutSipMediaApplicationLoggingConfigurationResponse & __MetadataBearer; +/** + *

Updates the logging configuration for the specified SIP media application.

+ */ export class PutSipMediaApplicationLoggingConfigurationCommand extends $Command< PutSipMediaApplicationLoggingConfigurationCommandInput, PutSipMediaApplicationLoggingConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class PutSipMediaApplicationLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutVoiceConnectorEmergencyCallingConfigurationCommand.ts b/clients/client-chime/commands/PutVoiceConnectorEmergencyCallingConfigurationCommand.ts index a61fa3319c115..bdb785f30080b 100644 --- a/clients/client-chime/commands/PutVoiceConnectorEmergencyCallingConfigurationCommand.ts +++ b/clients/client-chime/commands/PutVoiceConnectorEmergencyCallingConfigurationCommand.ts @@ -24,6 +24,9 @@ export type PutVoiceConnectorEmergencyCallingConfigurationCommandInput = PutVoic export type PutVoiceConnectorEmergencyCallingConfigurationCommandOutput = PutVoiceConnectorEmergencyCallingConfigurationResponse & __MetadataBearer; +/** + *

Puts emergency calling configuration details to the specified Amazon Chime Voice Connector, such as emergency phone numbers and calling countries. Origination and termination settings must be enabled for the Amazon Chime Voice Connector before emergency calling can be configured.

+ */ export class PutVoiceConnectorEmergencyCallingConfigurationCommand extends $Command< PutVoiceConnectorEmergencyCallingConfigurationCommandInput, PutVoiceConnectorEmergencyCallingConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class PutVoiceConnectorEmergencyCallingConfigurationCommand extends $Comm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutVoiceConnectorLoggingConfigurationCommand.ts b/clients/client-chime/commands/PutVoiceConnectorLoggingConfigurationCommand.ts index 0cc942673e1a6..a136f68eb4571 100644 --- a/clients/client-chime/commands/PutVoiceConnectorLoggingConfigurationCommand.ts +++ b/clients/client-chime/commands/PutVoiceConnectorLoggingConfigurationCommand.ts @@ -24,6 +24,9 @@ export type PutVoiceConnectorLoggingConfigurationCommandInput = PutVoiceConnecto export type PutVoiceConnectorLoggingConfigurationCommandOutput = PutVoiceConnectorLoggingConfigurationResponse & __MetadataBearer; +/** + *

Adds a logging configuration for the specified Amazon Chime Voice Connector. The logging configuration specifies whether SIP message logs are enabled for sending to Amazon CloudWatch Logs.

+ */ export class PutVoiceConnectorLoggingConfigurationCommand extends $Command< PutVoiceConnectorLoggingConfigurationCommandInput, PutVoiceConnectorLoggingConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class PutVoiceConnectorLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutVoiceConnectorOriginationCommand.ts b/clients/client-chime/commands/PutVoiceConnectorOriginationCommand.ts index 1f3f6a4bf0f89..b71302bba30a5 100644 --- a/clients/client-chime/commands/PutVoiceConnectorOriginationCommand.ts +++ b/clients/client-chime/commands/PutVoiceConnectorOriginationCommand.ts @@ -20,6 +20,12 @@ import { export type PutVoiceConnectorOriginationCommandInput = PutVoiceConnectorOriginationRequest; export type PutVoiceConnectorOriginationCommandOutput = PutVoiceConnectorOriginationResponse & __MetadataBearer; +/** + *

Adds origination settings for the specified Amazon Chime Voice Connector.

+ * + *

If emergency calling is configured for the Amazon Chime Voice Connector, it must be deleted prior to turning off origination settings.

+ *
+ */ export class PutVoiceConnectorOriginationCommand extends $Command< PutVoiceConnectorOriginationCommandInput, PutVoiceConnectorOriginationCommandOutput, @@ -34,6 +40,9 @@ export class PutVoiceConnectorOriginationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutVoiceConnectorProxyCommand.ts b/clients/client-chime/commands/PutVoiceConnectorProxyCommand.ts index f2f88c20592bb..4f72b1b5a8e0d 100644 --- a/clients/client-chime/commands/PutVoiceConnectorProxyCommand.ts +++ b/clients/client-chime/commands/PutVoiceConnectorProxyCommand.ts @@ -20,6 +20,9 @@ import { export type PutVoiceConnectorProxyCommandInput = PutVoiceConnectorProxyRequest; export type PutVoiceConnectorProxyCommandOutput = PutVoiceConnectorProxyResponse & __MetadataBearer; +/** + *

Puts the specified proxy configuration to the specified Amazon Chime Voice Connector.

+ */ export class PutVoiceConnectorProxyCommand extends $Command< PutVoiceConnectorProxyCommandInput, PutVoiceConnectorProxyCommandOutput, @@ -34,6 +37,9 @@ export class PutVoiceConnectorProxyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutVoiceConnectorStreamingConfigurationCommand.ts b/clients/client-chime/commands/PutVoiceConnectorStreamingConfigurationCommand.ts index 217db7844aa3d..9d8daa8f83974 100644 --- a/clients/client-chime/commands/PutVoiceConnectorStreamingConfigurationCommand.ts +++ b/clients/client-chime/commands/PutVoiceConnectorStreamingConfigurationCommand.ts @@ -24,6 +24,11 @@ export type PutVoiceConnectorStreamingConfigurationCommandInput = PutVoiceConnec export type PutVoiceConnectorStreamingConfigurationCommandOutput = PutVoiceConnectorStreamingConfigurationResponse & __MetadataBearer; +/** + *

Adds a streaming configuration for the specified Amazon Chime Voice Connector. The + * streaming configuration specifies whether media streaming is enabled for sending to Amazon + * Kinesis. It also sets the retention period, in hours, for the Amazon Kinesis data.

+ */ export class PutVoiceConnectorStreamingConfigurationCommand extends $Command< PutVoiceConnectorStreamingConfigurationCommandInput, PutVoiceConnectorStreamingConfigurationCommandOutput, @@ -38,6 +43,9 @@ export class PutVoiceConnectorStreamingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutVoiceConnectorTerminationCommand.ts b/clients/client-chime/commands/PutVoiceConnectorTerminationCommand.ts index 3948a369fd1e8..35d4b1bd123fc 100644 --- a/clients/client-chime/commands/PutVoiceConnectorTerminationCommand.ts +++ b/clients/client-chime/commands/PutVoiceConnectorTerminationCommand.ts @@ -20,6 +20,12 @@ import { export type PutVoiceConnectorTerminationCommandInput = PutVoiceConnectorTerminationRequest; export type PutVoiceConnectorTerminationCommandOutput = PutVoiceConnectorTerminationResponse & __MetadataBearer; +/** + *

Adds termination settings for the specified Amazon Chime Voice Connector.

+ * + *

If emergency calling is configured for the Amazon Chime Voice Connector, it must be deleted prior to turning off termination settings.

+ *
+ */ export class PutVoiceConnectorTerminationCommand extends $Command< PutVoiceConnectorTerminationCommandInput, PutVoiceConnectorTerminationCommandOutput, @@ -34,6 +40,9 @@ export class PutVoiceConnectorTerminationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/PutVoiceConnectorTerminationCredentialsCommand.ts b/clients/client-chime/commands/PutVoiceConnectorTerminationCredentialsCommand.ts index 89a9d884cead9..5fab107f97c70 100644 --- a/clients/client-chime/commands/PutVoiceConnectorTerminationCredentialsCommand.ts +++ b/clients/client-chime/commands/PutVoiceConnectorTerminationCredentialsCommand.ts @@ -20,6 +20,9 @@ import { export type PutVoiceConnectorTerminationCredentialsCommandInput = PutVoiceConnectorTerminationCredentialsRequest; export type PutVoiceConnectorTerminationCredentialsCommandOutput = __MetadataBearer; +/** + *

Adds termination SIP credentials for the specified Amazon Chime Voice Connector.

+ */ export class PutVoiceConnectorTerminationCredentialsCommand extends $Command< PutVoiceConnectorTerminationCredentialsCommandInput, PutVoiceConnectorTerminationCredentialsCommandOutput, @@ -34,6 +37,9 @@ export class PutVoiceConnectorTerminationCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/RedactConversationMessageCommand.ts b/clients/client-chime/commands/RedactConversationMessageCommand.ts index 42514f9afbbca..479e9f05a9585 100644 --- a/clients/client-chime/commands/RedactConversationMessageCommand.ts +++ b/clients/client-chime/commands/RedactConversationMessageCommand.ts @@ -20,6 +20,9 @@ import { export type RedactConversationMessageCommandInput = RedactConversationMessageRequest; export type RedactConversationMessageCommandOutput = RedactConversationMessageResponse & __MetadataBearer; +/** + *

Redacts the specified message from the specified Amazon Chime conversation.

+ */ export class RedactConversationMessageCommand extends $Command< RedactConversationMessageCommandInput, RedactConversationMessageCommandOutput, @@ -34,6 +37,9 @@ export class RedactConversationMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/RedactRoomMessageCommand.ts b/clients/client-chime/commands/RedactRoomMessageCommand.ts index f139d0d7dac11..507904900cb90 100644 --- a/clients/client-chime/commands/RedactRoomMessageCommand.ts +++ b/clients/client-chime/commands/RedactRoomMessageCommand.ts @@ -20,6 +20,9 @@ import { export type RedactRoomMessageCommandInput = RedactRoomMessageRequest; export type RedactRoomMessageCommandOutput = RedactRoomMessageResponse & __MetadataBearer; +/** + *

Redacts the specified message from the specified Amazon Chime chat room.

+ */ export class RedactRoomMessageCommand extends $Command< RedactRoomMessageCommandInput, RedactRoomMessageCommandOutput, @@ -34,6 +37,9 @@ export class RedactRoomMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/RegenerateSecurityTokenCommand.ts b/clients/client-chime/commands/RegenerateSecurityTokenCommand.ts index 380f1b3739e5f..9eb6cee66d693 100644 --- a/clients/client-chime/commands/RegenerateSecurityTokenCommand.ts +++ b/clients/client-chime/commands/RegenerateSecurityTokenCommand.ts @@ -20,6 +20,9 @@ import { export type RegenerateSecurityTokenCommandInput = RegenerateSecurityTokenRequest; export type RegenerateSecurityTokenCommandOutput = RegenerateSecurityTokenResponse & __MetadataBearer; +/** + *

Regenerates the security token for a bot.

+ */ export class RegenerateSecurityTokenCommand extends $Command< RegenerateSecurityTokenCommandInput, RegenerateSecurityTokenCommandOutput, @@ -34,6 +37,9 @@ export class RegenerateSecurityTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/ResetPersonalPINCommand.ts b/clients/client-chime/commands/ResetPersonalPINCommand.ts index d637dcb0f184b..cee01b39e41d5 100644 --- a/clients/client-chime/commands/ResetPersonalPINCommand.ts +++ b/clients/client-chime/commands/ResetPersonalPINCommand.ts @@ -20,6 +20,10 @@ import { export type ResetPersonalPINCommandInput = ResetPersonalPINRequest; export type ResetPersonalPINCommandOutput = ResetPersonalPINResponse & __MetadataBearer; +/** + *

Resets the personal meeting PIN for the specified user on an Amazon Chime account. + * Returns the User object with the updated personal meeting PIN.

+ */ export class ResetPersonalPINCommand extends $Command< ResetPersonalPINCommandInput, ResetPersonalPINCommandOutput, @@ -34,6 +38,9 @@ export class ResetPersonalPINCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/RestorePhoneNumberCommand.ts b/clients/client-chime/commands/RestorePhoneNumberCommand.ts index ce2879090bdd1..ed92e78053f32 100644 --- a/clients/client-chime/commands/RestorePhoneNumberCommand.ts +++ b/clients/client-chime/commands/RestorePhoneNumberCommand.ts @@ -20,6 +20,10 @@ import { export type RestorePhoneNumberCommandInput = RestorePhoneNumberRequest; export type RestorePhoneNumberCommandOutput = RestorePhoneNumberResponse & __MetadataBearer; +/** + *

Moves a phone number from the Deletion queue back into + * the phone number Inventory.

+ */ export class RestorePhoneNumberCommand extends $Command< RestorePhoneNumberCommandInput, RestorePhoneNumberCommandOutput, @@ -34,6 +38,9 @@ export class RestorePhoneNumberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/SearchAvailablePhoneNumbersCommand.ts b/clients/client-chime/commands/SearchAvailablePhoneNumbersCommand.ts index 7911c2e56260c..c0cdf7e27bf75 100644 --- a/clients/client-chime/commands/SearchAvailablePhoneNumbersCommand.ts +++ b/clients/client-chime/commands/SearchAvailablePhoneNumbersCommand.ts @@ -20,6 +20,9 @@ import { export type SearchAvailablePhoneNumbersCommandInput = SearchAvailablePhoneNumbersRequest; export type SearchAvailablePhoneNumbersCommandOutput = SearchAvailablePhoneNumbersResponse & __MetadataBearer; +/** + *

Searches phone numbers that can be ordered.

+ */ export class SearchAvailablePhoneNumbersCommand extends $Command< SearchAvailablePhoneNumbersCommandInput, SearchAvailablePhoneNumbersCommandOutput, @@ -34,6 +37,9 @@ export class SearchAvailablePhoneNumbersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/TagAttendeeCommand.ts b/clients/client-chime/commands/TagAttendeeCommand.ts index 0f11e2df89daa..cd25abed80004 100644 --- a/clients/client-chime/commands/TagAttendeeCommand.ts +++ b/clients/client-chime/commands/TagAttendeeCommand.ts @@ -20,6 +20,9 @@ import { export type TagAttendeeCommandInput = TagAttendeeRequest; export type TagAttendeeCommandOutput = __MetadataBearer; +/** + *

Applies the specified tags to the specified Amazon Chime SDK attendee.

+ */ export class TagAttendeeCommand extends $Command< TagAttendeeCommandInput, TagAttendeeCommandOutput, @@ -34,6 +37,9 @@ export class TagAttendeeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/TagMeetingCommand.ts b/clients/client-chime/commands/TagMeetingCommand.ts index d1978c3eebdc9..24899b0bd111a 100644 --- a/clients/client-chime/commands/TagMeetingCommand.ts +++ b/clients/client-chime/commands/TagMeetingCommand.ts @@ -20,6 +20,9 @@ import { export type TagMeetingCommandInput = TagMeetingRequest; export type TagMeetingCommandOutput = __MetadataBearer; +/** + *

Applies the specified tags to the specified Amazon Chime SDK meeting.

+ */ export class TagMeetingCommand extends $Command< TagMeetingCommandInput, TagMeetingCommandOutput, @@ -34,6 +37,9 @@ export class TagMeetingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/TagResourceCommand.ts b/clients/client-chime/commands/TagResourceCommand.ts index 895e868bbe084..7ed0424bd9a29 100644 --- a/clients/client-chime/commands/TagResourceCommand.ts +++ b/clients/client-chime/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Applies the specified tags to the specified Amazon Chime SDK meeting resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UntagAttendeeCommand.ts b/clients/client-chime/commands/UntagAttendeeCommand.ts index 504b1686323b5..e5cb71759bf34 100644 --- a/clients/client-chime/commands/UntagAttendeeCommand.ts +++ b/clients/client-chime/commands/UntagAttendeeCommand.ts @@ -20,6 +20,9 @@ import { export type UntagAttendeeCommandInput = UntagAttendeeRequest; export type UntagAttendeeCommandOutput = __MetadataBearer; +/** + *

Untags the specified tags from the specified Amazon Chime SDK attendee.

+ */ export class UntagAttendeeCommand extends $Command< UntagAttendeeCommandInput, UntagAttendeeCommandOutput, @@ -34,6 +37,9 @@ export class UntagAttendeeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UntagMeetingCommand.ts b/clients/client-chime/commands/UntagMeetingCommand.ts index 9b4e5de85b36c..47be62ed4b7b5 100644 --- a/clients/client-chime/commands/UntagMeetingCommand.ts +++ b/clients/client-chime/commands/UntagMeetingCommand.ts @@ -20,6 +20,9 @@ import { export type UntagMeetingCommandInput = UntagMeetingRequest; export type UntagMeetingCommandOutput = __MetadataBearer; +/** + *

Untags the specified tags from the specified Amazon Chime SDK meeting.

+ */ export class UntagMeetingCommand extends $Command< UntagMeetingCommandInput, UntagMeetingCommandOutput, @@ -34,6 +37,9 @@ export class UntagMeetingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UntagResourceCommand.ts b/clients/client-chime/commands/UntagResourceCommand.ts index d1762ccad1ffd..ccc871f3a5869 100644 --- a/clients/client-chime/commands/UntagResourceCommand.ts +++ b/clients/client-chime/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Untags the specified tags from the specified Amazon Chime SDK meeting resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateAccountCommand.ts b/clients/client-chime/commands/UpdateAccountCommand.ts index be628b311b897..fb15b2493e722 100644 --- a/clients/client-chime/commands/UpdateAccountCommand.ts +++ b/clients/client-chime/commands/UpdateAccountCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateAccountCommandInput = UpdateAccountRequest; export type UpdateAccountCommandOutput = UpdateAccountResponse & __MetadataBearer; +/** + *

Updates account details for the specified Amazon Chime account. Currently, only + * account name updates are supported for this action.

+ */ export class UpdateAccountCommand extends $Command< UpdateAccountCommandInput, UpdateAccountCommandOutput, @@ -34,6 +38,9 @@ export class UpdateAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateAccountSettingsCommand.ts b/clients/client-chime/commands/UpdateAccountSettingsCommand.ts index 2c612adeebf73..4efcbfeb46783 100644 --- a/clients/client-chime/commands/UpdateAccountSettingsCommand.ts +++ b/clients/client-chime/commands/UpdateAccountSettingsCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateAccountSettingsCommandInput = UpdateAccountSettingsRequest; export type UpdateAccountSettingsCommandOutput = UpdateAccountSettingsResponse & __MetadataBearer; +/** + *

Updates the settings for the specified Amazon Chime account. You can update settings + * for remote control of shared screens, or for the dial-out option. For more information about + * these settings, see Use the + * Policies Page in the Amazon Chime Administration + * Guide.

+ */ export class UpdateAccountSettingsCommand extends $Command< UpdateAccountSettingsCommandInput, UpdateAccountSettingsCommandOutput, @@ -34,6 +41,9 @@ export class UpdateAccountSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateBotCommand.ts b/clients/client-chime/commands/UpdateBotCommand.ts index 0469e4df6f9fc..c156500783b01 100644 --- a/clients/client-chime/commands/UpdateBotCommand.ts +++ b/clients/client-chime/commands/UpdateBotCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateBotCommandInput = UpdateBotRequest; export type UpdateBotCommandOutput = UpdateBotResponse & __MetadataBearer; +/** + *

Updates the status of the specified bot, such as starting or stopping the bot from running in your Amazon Chime Enterprise account.

+ */ export class UpdateBotCommand extends $Command< UpdateBotCommandInput, UpdateBotCommandOutput, @@ -34,6 +37,9 @@ export class UpdateBotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateGlobalSettingsCommand.ts b/clients/client-chime/commands/UpdateGlobalSettingsCommand.ts index ee5e763dc44ca..6f34ae1d05c74 100644 --- a/clients/client-chime/commands/UpdateGlobalSettingsCommand.ts +++ b/clients/client-chime/commands/UpdateGlobalSettingsCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateGlobalSettingsCommandInput = UpdateGlobalSettingsRequest; export type UpdateGlobalSettingsCommandOutput = __MetadataBearer; +/** + *

Updates global settings for the administrator's AWS account, such as Amazon Chime Business + * Calling and Amazon Chime Voice Connector settings.

+ */ export class UpdateGlobalSettingsCommand extends $Command< UpdateGlobalSettingsCommandInput, UpdateGlobalSettingsCommandOutput, @@ -34,6 +38,9 @@ export class UpdateGlobalSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdatePhoneNumberCommand.ts b/clients/client-chime/commands/UpdatePhoneNumberCommand.ts index ad7867104b82a..3886a99685dc3 100644 --- a/clients/client-chime/commands/UpdatePhoneNumberCommand.ts +++ b/clients/client-chime/commands/UpdatePhoneNumberCommand.ts @@ -20,6 +20,12 @@ import { export type UpdatePhoneNumberCommandInput = UpdatePhoneNumberRequest; export type UpdatePhoneNumberCommandOutput = UpdatePhoneNumberResponse & __MetadataBearer; +/** + *

Updates phone number details, such as product type or calling name, for the specified phone number ID. You can update one phone number detail at a time. For example, you can update either the product type or the calling name in one action.

+ *

For toll-free numbers, you must use the Amazon Chime Voice Connector product + * type.

+ *

Updates to outbound calling names can take up to 72 hours to complete. Pending updates to outbound calling names must be complete before you can request another update.

+ */ export class UpdatePhoneNumberCommand extends $Command< UpdatePhoneNumberCommandInput, UpdatePhoneNumberCommandOutput, @@ -34,6 +40,9 @@ export class UpdatePhoneNumberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdatePhoneNumberSettingsCommand.ts b/clients/client-chime/commands/UpdatePhoneNumberSettingsCommand.ts index a6853c15a2739..d7c4a132cdd64 100644 --- a/clients/client-chime/commands/UpdatePhoneNumberSettingsCommand.ts +++ b/clients/client-chime/commands/UpdatePhoneNumberSettingsCommand.ts @@ -20,6 +20,11 @@ import { export type UpdatePhoneNumberSettingsCommandInput = UpdatePhoneNumberSettingsRequest; export type UpdatePhoneNumberSettingsCommandOutput = __MetadataBearer; +/** + *

Updates the phone number settings for the administrator's AWS account, such as the + * default outbound calling name. You can update the default outbound calling name once every + * seven days. Outbound calling names can take up to 72 hours to update.

+ */ export class UpdatePhoneNumberSettingsCommand extends $Command< UpdatePhoneNumberSettingsCommandInput, UpdatePhoneNumberSettingsCommandOutput, @@ -34,6 +39,9 @@ export class UpdatePhoneNumberSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateProxySessionCommand.ts b/clients/client-chime/commands/UpdateProxySessionCommand.ts index acedc6f87e8fb..e5b9e4129a2ac 100644 --- a/clients/client-chime/commands/UpdateProxySessionCommand.ts +++ b/clients/client-chime/commands/UpdateProxySessionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProxySessionCommandInput = UpdateProxySessionRequest; export type UpdateProxySessionCommandOutput = UpdateProxySessionResponse & __MetadataBearer; +/** + *

Updates the specified proxy session details, such as voice or SMS capabilities.

+ */ export class UpdateProxySessionCommand extends $Command< UpdateProxySessionCommandInput, UpdateProxySessionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProxySessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateRoomCommand.ts b/clients/client-chime/commands/UpdateRoomCommand.ts index ecd69c45616b0..b721d7501969e 100644 --- a/clients/client-chime/commands/UpdateRoomCommand.ts +++ b/clients/client-chime/commands/UpdateRoomCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRoomCommandInput = UpdateRoomRequest; export type UpdateRoomCommandOutput = UpdateRoomResponse & __MetadataBearer; +/** + *

Updates room details, such as the room name, for a room in an Amazon Chime Enterprise account.

+ */ export class UpdateRoomCommand extends $Command< UpdateRoomCommandInput, UpdateRoomCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRoomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateRoomMembershipCommand.ts b/clients/client-chime/commands/UpdateRoomMembershipCommand.ts index d357f71df924c..4979a9afa3507 100644 --- a/clients/client-chime/commands/UpdateRoomMembershipCommand.ts +++ b/clients/client-chime/commands/UpdateRoomMembershipCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateRoomMembershipCommandInput = UpdateRoomMembershipRequest; export type UpdateRoomMembershipCommandOutput = UpdateRoomMembershipResponse & __MetadataBearer; +/** + *

Updates room membership details, such as the member role, for a room in an Amazon Chime Enterprise account. The member role designates + * whether the member is a chat room administrator or a general chat room member. The member role + * can be updated only for user IDs.

+ */ export class UpdateRoomMembershipCommand extends $Command< UpdateRoomMembershipCommandInput, UpdateRoomMembershipCommandOutput, @@ -34,6 +39,9 @@ export class UpdateRoomMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateSipMediaApplicationCommand.ts b/clients/client-chime/commands/UpdateSipMediaApplicationCommand.ts index 4eabfc60e85b9..1cec3163e81dd 100644 --- a/clients/client-chime/commands/UpdateSipMediaApplicationCommand.ts +++ b/clients/client-chime/commands/UpdateSipMediaApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSipMediaApplicationCommandInput = UpdateSipMediaApplicationRequest; export type UpdateSipMediaApplicationCommandOutput = UpdateSipMediaApplicationResponse & __MetadataBearer; +/** + *

Updates the details for the specified SIP media application.

+ */ export class UpdateSipMediaApplicationCommand extends $Command< UpdateSipMediaApplicationCommandInput, UpdateSipMediaApplicationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSipMediaApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateSipRuleCommand.ts b/clients/client-chime/commands/UpdateSipRuleCommand.ts index f6d16ce786abf..6abcaa86134de 100644 --- a/clients/client-chime/commands/UpdateSipRuleCommand.ts +++ b/clients/client-chime/commands/UpdateSipRuleCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSipRuleCommandInput = UpdateSipRuleRequest; export type UpdateSipRuleCommandOutput = UpdateSipRuleResponse & __MetadataBearer; +/** + *

Updates the details for the specified SIP rule.

+ */ export class UpdateSipRuleCommand extends $Command< UpdateSipRuleCommandInput, UpdateSipRuleCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSipRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateUserCommand.ts b/clients/client-chime/commands/UpdateUserCommand.ts index 6ba75b6c00107..2a0eb0d2dbf5d 100644 --- a/clients/client-chime/commands/UpdateUserCommand.ts +++ b/clients/client-chime/commands/UpdateUserCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserCommandInput = UpdateUserRequest; export type UpdateUserCommandOutput = UpdateUserResponse & __MetadataBearer; +/** + *

Updates user details for a specified user ID. Currently, only LicenseType updates are supported for this action.

+ */ export class UpdateUserCommand extends $Command< UpdateUserCommandInput, UpdateUserCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateUserSettingsCommand.ts b/clients/client-chime/commands/UpdateUserSettingsCommand.ts index e1857685ef6bb..8a826480edfe9 100644 --- a/clients/client-chime/commands/UpdateUserSettingsCommand.ts +++ b/clients/client-chime/commands/UpdateUserSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserSettingsCommandInput = UpdateUserSettingsRequest; export type UpdateUserSettingsCommandOutput = __MetadataBearer; +/** + *

Updates the settings for the specified user, such as phone number settings.

+ */ export class UpdateUserSettingsCommand extends $Command< UpdateUserSettingsCommandInput, UpdateUserSettingsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateVoiceConnectorCommand.ts b/clients/client-chime/commands/UpdateVoiceConnectorCommand.ts index b06d12b5b2b4a..339a8e9700410 100644 --- a/clients/client-chime/commands/UpdateVoiceConnectorCommand.ts +++ b/clients/client-chime/commands/UpdateVoiceConnectorCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVoiceConnectorCommandInput = UpdateVoiceConnectorRequest; export type UpdateVoiceConnectorCommandOutput = UpdateVoiceConnectorResponse & __MetadataBearer; +/** + *

Updates details for the specified Amazon Chime Voice Connector.

+ */ export class UpdateVoiceConnectorCommand extends $Command< UpdateVoiceConnectorCommandInput, UpdateVoiceConnectorCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVoiceConnectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/commands/UpdateVoiceConnectorGroupCommand.ts b/clients/client-chime/commands/UpdateVoiceConnectorGroupCommand.ts index fd3da891e328f..52768c6a93d29 100644 --- a/clients/client-chime/commands/UpdateVoiceConnectorGroupCommand.ts +++ b/clients/client-chime/commands/UpdateVoiceConnectorGroupCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateVoiceConnectorGroupCommandInput = UpdateVoiceConnectorGroupRequest; export type UpdateVoiceConnectorGroupCommandOutput = UpdateVoiceConnectorGroupResponse & __MetadataBearer; +/** + *

Updates details for the specified Amazon Chime Voice Connector group, such as the name + * and Amazon Chime Voice Connector priority ranking.

+ */ export class UpdateVoiceConnectorGroupCommand extends $Command< UpdateVoiceConnectorGroupCommandInput, UpdateVoiceConnectorGroupCommandOutput, @@ -34,6 +38,9 @@ export class UpdateVoiceConnectorGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ChimeClientResolvedConfig, diff --git a/clients/client-chime/package.json b/clients/client-chime/package.json index ffd05ee132d4f..156dea933a132 100644 --- a/clients/client-chime/package.json +++ b/clients/client-chime/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Chime Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-chime/pagination/ListAccountsPaginator.ts b/clients/client-chime/pagination/ListAccountsPaginator.ts index 46f1288142453..0ffd7b90800f8 100644 --- a/clients/client-chime/pagination/ListAccountsPaginator.ts +++ b/clients/client-chime/pagination/ListAccountsPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListAccountsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListAccountsCommandInput, diff --git a/clients/client-chime/pagination/ListAttendeesPaginator.ts b/clients/client-chime/pagination/ListAttendeesPaginator.ts index c998e9227bba3..df4cc97feb01b 100644 --- a/clients/client-chime/pagination/ListAttendeesPaginator.ts +++ b/clients/client-chime/pagination/ListAttendeesPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListAttendeesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttendeesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListAttendeesCommandInput, diff --git a/clients/client-chime/pagination/ListBotsPaginator.ts b/clients/client-chime/pagination/ListBotsPaginator.ts index 3a97bc1df80bd..ec051c3730f62 100644 --- a/clients/client-chime/pagination/ListBotsPaginator.ts +++ b/clients/client-chime/pagination/ListBotsPaginator.ts @@ -4,6 +4,9 @@ import { ListBotsCommand, ListBotsCommandInput, ListBotsCommandOutput } from ".. import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListBotsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListBotsCommandInput, diff --git a/clients/client-chime/pagination/ListMeetingsPaginator.ts b/clients/client-chime/pagination/ListMeetingsPaginator.ts index da9c7f3a2a03d..6ccfe4dd46af8 100644 --- a/clients/client-chime/pagination/ListMeetingsPaginator.ts +++ b/clients/client-chime/pagination/ListMeetingsPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListMeetingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMeetingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListMeetingsCommandInput, diff --git a/clients/client-chime/pagination/ListPhoneNumberOrdersPaginator.ts b/clients/client-chime/pagination/ListPhoneNumberOrdersPaginator.ts index 1f1d4437fd096..7589b7454983e 100644 --- a/clients/client-chime/pagination/ListPhoneNumberOrdersPaginator.ts +++ b/clients/client-chime/pagination/ListPhoneNumberOrdersPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListPhoneNumberOrdersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPhoneNumberOrdersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListPhoneNumberOrdersCommandInput, diff --git a/clients/client-chime/pagination/ListPhoneNumbersPaginator.ts b/clients/client-chime/pagination/ListPhoneNumbersPaginator.ts index 9d68a77abad9b..b13af21630ff3 100644 --- a/clients/client-chime/pagination/ListPhoneNumbersPaginator.ts +++ b/clients/client-chime/pagination/ListPhoneNumbersPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListPhoneNumbersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPhoneNumbersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListPhoneNumbersCommandInput, diff --git a/clients/client-chime/pagination/ListProxySessionsPaginator.ts b/clients/client-chime/pagination/ListProxySessionsPaginator.ts index c88671748066a..c0b264259b70c 100644 --- a/clients/client-chime/pagination/ListProxySessionsPaginator.ts +++ b/clients/client-chime/pagination/ListProxySessionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListProxySessionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProxySessionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListProxySessionsCommandInput, diff --git a/clients/client-chime/pagination/ListRoomMembershipsPaginator.ts b/clients/client-chime/pagination/ListRoomMembershipsPaginator.ts index 79af0326bab29..ff38a83c77bf4 100644 --- a/clients/client-chime/pagination/ListRoomMembershipsPaginator.ts +++ b/clients/client-chime/pagination/ListRoomMembershipsPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListRoomMembershipsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRoomMembershipsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListRoomMembershipsCommandInput, diff --git a/clients/client-chime/pagination/ListRoomsPaginator.ts b/clients/client-chime/pagination/ListRoomsPaginator.ts index c791641a9496a..5ed992eb80082 100644 --- a/clients/client-chime/pagination/ListRoomsPaginator.ts +++ b/clients/client-chime/pagination/ListRoomsPaginator.ts @@ -4,6 +4,9 @@ import { ListRoomsCommand, ListRoomsCommandInput, ListRoomsCommandOutput } from import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListRoomsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRoomsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListRoomsCommandInput, diff --git a/clients/client-chime/pagination/ListUsersPaginator.ts b/clients/client-chime/pagination/ListUsersPaginator.ts index 1a45dc035145d..0772d854847c0 100644 --- a/clients/client-chime/pagination/ListUsersPaginator.ts +++ b/clients/client-chime/pagination/ListUsersPaginator.ts @@ -4,6 +4,9 @@ import { ListUsersCommand, ListUsersCommandInput, ListUsersCommandOutput } from import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListUsersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListUsersCommandInput, diff --git a/clients/client-chime/pagination/ListVoiceConnectorGroupsPaginator.ts b/clients/client-chime/pagination/ListVoiceConnectorGroupsPaginator.ts index ea6e7c03cb1a7..c99bbd254e349 100644 --- a/clients/client-chime/pagination/ListVoiceConnectorGroupsPaginator.ts +++ b/clients/client-chime/pagination/ListVoiceConnectorGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListVoiceConnectorGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVoiceConnectorGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListVoiceConnectorGroupsCommandInput, diff --git a/clients/client-chime/pagination/ListVoiceConnectorsPaginator.ts b/clients/client-chime/pagination/ListVoiceConnectorsPaginator.ts index 56f76befb3081..7a2cdbba12ad0 100644 --- a/clients/client-chime/pagination/ListVoiceConnectorsPaginator.ts +++ b/clients/client-chime/pagination/ListVoiceConnectorsPaginator.ts @@ -8,6 +8,9 @@ import { import { ChimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ChimeClient, input: ListVoiceConnectorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVoiceConnectorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Chime, input: ListVoiceConnectorsCommandInput, diff --git a/clients/client-chime/runtimeConfig.browser.ts b/clients/client-chime/runtimeConfig.browser.ts index f20b2993bf51e..c0471764a163d 100644 --- a/clients/client-chime/runtimeConfig.browser.ts +++ b/clients/client-chime/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ChimeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-chime/runtimeConfig.native.ts b/clients/client-chime/runtimeConfig.native.ts index 48f8555d5726b..f4841fdb69c7b 100644 --- a/clients/client-chime/runtimeConfig.native.ts +++ b/clients/client-chime/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ChimeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-chime/runtimeConfig.shared.ts b/clients/client-chime/runtimeConfig.shared.ts index 4a85bcfd7554c..08290a2246a44 100644 --- a/clients/client-chime/runtimeConfig.shared.ts +++ b/clients/client-chime/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-05-01", disableHostPrefix: false, diff --git a/clients/client-chime/runtimeConfig.ts b/clients/client-chime/runtimeConfig.ts index 2ab616642b0f7..fadd77f299b39 100644 --- a/clients/client-chime/runtimeConfig.ts +++ b/clients/client-chime/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ChimeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-chime/tsconfig.json b/clients/client-chime/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-chime/tsconfig.json +++ b/clients/client-chime/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloud9/commands/CreateEnvironmentEC2Command.ts b/clients/client-cloud9/commands/CreateEnvironmentEC2Command.ts index 22bcbab606a13..8f456a9f5dbef 100644 --- a/clients/client-cloud9/commands/CreateEnvironmentEC2Command.ts +++ b/clients/client-cloud9/commands/CreateEnvironmentEC2Command.ts @@ -20,6 +20,9 @@ import { export type CreateEnvironmentEC2CommandInput = CreateEnvironmentEC2Request; export type CreateEnvironmentEC2CommandOutput = CreateEnvironmentEC2Result & __MetadataBearer; +/** + *

Creates an AWS Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance, and then connects from the instance to the environment.

+ */ export class CreateEnvironmentEC2Command extends $Command< CreateEnvironmentEC2CommandInput, CreateEnvironmentEC2CommandOutput, @@ -34,6 +37,9 @@ export class CreateEnvironmentEC2Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/CreateEnvironmentMembershipCommand.ts b/clients/client-cloud9/commands/CreateEnvironmentMembershipCommand.ts index 4fffb315d69c3..9abcd796bff6b 100644 --- a/clients/client-cloud9/commands/CreateEnvironmentMembershipCommand.ts +++ b/clients/client-cloud9/commands/CreateEnvironmentMembershipCommand.ts @@ -20,6 +20,9 @@ import { export type CreateEnvironmentMembershipCommandInput = CreateEnvironmentMembershipRequest; export type CreateEnvironmentMembershipCommandOutput = CreateEnvironmentMembershipResult & __MetadataBearer; +/** + *

Adds an environment member to an AWS Cloud9 development environment.

+ */ export class CreateEnvironmentMembershipCommand extends $Command< CreateEnvironmentMembershipCommandInput, CreateEnvironmentMembershipCommandOutput, @@ -34,6 +37,9 @@ export class CreateEnvironmentMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/DeleteEnvironmentCommand.ts b/clients/client-cloud9/commands/DeleteEnvironmentCommand.ts index 4b7d862f20be9..217da40ec2fe0 100644 --- a/clients/client-cloud9/commands/DeleteEnvironmentCommand.ts +++ b/clients/client-cloud9/commands/DeleteEnvironmentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEnvironmentCommandInput = DeleteEnvironmentRequest; export type DeleteEnvironmentCommandOutput = DeleteEnvironmentResult & __MetadataBearer; +/** + *

Deletes an AWS Cloud9 development environment. If an Amazon EC2 instance is connected to the environment, also terminates the instance.

+ */ export class DeleteEnvironmentCommand extends $Command< DeleteEnvironmentCommandInput, DeleteEnvironmentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/DeleteEnvironmentMembershipCommand.ts b/clients/client-cloud9/commands/DeleteEnvironmentMembershipCommand.ts index cb3068557065c..a3ed51b542ec9 100644 --- a/clients/client-cloud9/commands/DeleteEnvironmentMembershipCommand.ts +++ b/clients/client-cloud9/commands/DeleteEnvironmentMembershipCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEnvironmentMembershipCommandInput = DeleteEnvironmentMembershipRequest; export type DeleteEnvironmentMembershipCommandOutput = DeleteEnvironmentMembershipResult & __MetadataBearer; +/** + *

Deletes an environment member from an AWS Cloud9 development environment.

+ */ export class DeleteEnvironmentMembershipCommand extends $Command< DeleteEnvironmentMembershipCommandInput, DeleteEnvironmentMembershipCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEnvironmentMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/DescribeEnvironmentMembershipsCommand.ts b/clients/client-cloud9/commands/DescribeEnvironmentMembershipsCommand.ts index 6af54e2edb104..c7aa18daf9bbc 100644 --- a/clients/client-cloud9/commands/DescribeEnvironmentMembershipsCommand.ts +++ b/clients/client-cloud9/commands/DescribeEnvironmentMembershipsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEnvironmentMembershipsCommandInput = DescribeEnvironmentMembershipsRequest; export type DescribeEnvironmentMembershipsCommandOutput = DescribeEnvironmentMembershipsResult & __MetadataBearer; +/** + *

Gets information about environment members for an AWS Cloud9 development environment.

+ */ export class DescribeEnvironmentMembershipsCommand extends $Command< DescribeEnvironmentMembershipsCommandInput, DescribeEnvironmentMembershipsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEnvironmentMembershipsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/DescribeEnvironmentStatusCommand.ts b/clients/client-cloud9/commands/DescribeEnvironmentStatusCommand.ts index af359fe7afb7c..ba9166b212fd8 100644 --- a/clients/client-cloud9/commands/DescribeEnvironmentStatusCommand.ts +++ b/clients/client-cloud9/commands/DescribeEnvironmentStatusCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEnvironmentStatusCommandInput = DescribeEnvironmentStatusRequest; export type DescribeEnvironmentStatusCommandOutput = DescribeEnvironmentStatusResult & __MetadataBearer; +/** + *

Gets status information for an AWS Cloud9 development environment.

+ */ export class DescribeEnvironmentStatusCommand extends $Command< DescribeEnvironmentStatusCommandInput, DescribeEnvironmentStatusCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEnvironmentStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/DescribeEnvironmentsCommand.ts b/clients/client-cloud9/commands/DescribeEnvironmentsCommand.ts index 1daac6cb774a3..efb5aef8073cf 100644 --- a/clients/client-cloud9/commands/DescribeEnvironmentsCommand.ts +++ b/clients/client-cloud9/commands/DescribeEnvironmentsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEnvironmentsCommandInput = DescribeEnvironmentsRequest; export type DescribeEnvironmentsCommandOutput = DescribeEnvironmentsResult & __MetadataBearer; +/** + *

Gets information about AWS Cloud9 development environments.

+ */ export class DescribeEnvironmentsCommand extends $Command< DescribeEnvironmentsCommandInput, DescribeEnvironmentsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEnvironmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/ListEnvironmentsCommand.ts b/clients/client-cloud9/commands/ListEnvironmentsCommand.ts index 7c2a931feb5fb..fd80eecbaf897 100644 --- a/clients/client-cloud9/commands/ListEnvironmentsCommand.ts +++ b/clients/client-cloud9/commands/ListEnvironmentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListEnvironmentsCommandInput = ListEnvironmentsRequest; export type ListEnvironmentsCommandOutput = ListEnvironmentsResult & __MetadataBearer; +/** + *

Gets a list of AWS Cloud9 development environment identifiers.

+ */ export class ListEnvironmentsCommand extends $Command< ListEnvironmentsCommandInput, ListEnvironmentsCommandOutput, @@ -34,6 +37,9 @@ export class ListEnvironmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/ListTagsForResourceCommand.ts b/clients/client-cloud9/commands/ListTagsForResourceCommand.ts index 8a6c6bd5827cc..8c5f8efca0284 100644 --- a/clients/client-cloud9/commands/ListTagsForResourceCommand.ts +++ b/clients/client-cloud9/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Gets a list of the tags associated with an AWS Cloud9 development environment.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/TagResourceCommand.ts b/clients/client-cloud9/commands/TagResourceCommand.ts index f0e5451f4875e..0f35d9d0f5601 100644 --- a/clients/client-cloud9/commands/TagResourceCommand.ts +++ b/clients/client-cloud9/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds tags to an AWS Cloud9 development environment.

+ * + *

Tags that you add to an AWS Cloud9 environment by using this method will NOT be automatically propagated to underlying resources.

+ *
+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/UntagResourceCommand.ts b/clients/client-cloud9/commands/UntagResourceCommand.ts index 7af5d879c9a4b..bf71bff80b7b8 100644 --- a/clients/client-cloud9/commands/UntagResourceCommand.ts +++ b/clients/client-cloud9/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes tags from an AWS Cloud9 development environment.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/UpdateEnvironmentCommand.ts b/clients/client-cloud9/commands/UpdateEnvironmentCommand.ts index 1388b5a098efc..62dbd2b0c2d4f 100644 --- a/clients/client-cloud9/commands/UpdateEnvironmentCommand.ts +++ b/clients/client-cloud9/commands/UpdateEnvironmentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEnvironmentCommandInput = UpdateEnvironmentRequest; export type UpdateEnvironmentCommandOutput = UpdateEnvironmentResult & __MetadataBearer; +/** + *

Changes the settings of an existing AWS Cloud9 development environment.

+ */ export class UpdateEnvironmentCommand extends $Command< UpdateEnvironmentCommandInput, UpdateEnvironmentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/commands/UpdateEnvironmentMembershipCommand.ts b/clients/client-cloud9/commands/UpdateEnvironmentMembershipCommand.ts index 74ffacad0a623..0acb31258723f 100644 --- a/clients/client-cloud9/commands/UpdateEnvironmentMembershipCommand.ts +++ b/clients/client-cloud9/commands/UpdateEnvironmentMembershipCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEnvironmentMembershipCommandInput = UpdateEnvironmentMembershipRequest; export type UpdateEnvironmentMembershipCommandOutput = UpdateEnvironmentMembershipResult & __MetadataBearer; +/** + *

Changes the settings of an existing environment member for an AWS Cloud9 development environment.

+ */ export class UpdateEnvironmentMembershipCommand extends $Command< UpdateEnvironmentMembershipCommandInput, UpdateEnvironmentMembershipCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEnvironmentMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Cloud9ClientResolvedConfig, diff --git a/clients/client-cloud9/package.json b/clients/client-cloud9/package.json index 0d323488d547d..3f3e99f66c13a 100644 --- a/clients/client-cloud9/package.json +++ b/clients/client-cloud9/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloud9 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloud9/pagination/DescribeEnvironmentMembershipsPaginator.ts b/clients/client-cloud9/pagination/DescribeEnvironmentMembershipsPaginator.ts index fdaf43e52aacc..8377dfc8d8f5d 100644 --- a/clients/client-cloud9/pagination/DescribeEnvironmentMembershipsPaginator.ts +++ b/clients/client-cloud9/pagination/DescribeEnvironmentMembershipsPaginator.ts @@ -8,6 +8,9 @@ import { import { Cloud9PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Cloud9Client, input: DescribeEnvironmentMembershipsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEnvironmentMembershipsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Cloud9, input: DescribeEnvironmentMembershipsCommandInput, diff --git a/clients/client-cloud9/pagination/ListEnvironmentsPaginator.ts b/clients/client-cloud9/pagination/ListEnvironmentsPaginator.ts index d9240f376f4ab..6504272ca904f 100644 --- a/clients/client-cloud9/pagination/ListEnvironmentsPaginator.ts +++ b/clients/client-cloud9/pagination/ListEnvironmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { Cloud9PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Cloud9Client, input: ListEnvironmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEnvironmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Cloud9, input: ListEnvironmentsCommandInput, diff --git a/clients/client-cloud9/runtimeConfig.browser.ts b/clients/client-cloud9/runtimeConfig.browser.ts index 5bcca09426d17..eac45da3e3427 100644 --- a/clients/client-cloud9/runtimeConfig.browser.ts +++ b/clients/client-cloud9/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./Cloud9Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloud9/runtimeConfig.native.ts b/clients/client-cloud9/runtimeConfig.native.ts index b2b1bea22eb5c..0991da279ce75 100644 --- a/clients/client-cloud9/runtimeConfig.native.ts +++ b/clients/client-cloud9/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./Cloud9Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloud9/runtimeConfig.shared.ts b/clients/client-cloud9/runtimeConfig.shared.ts index 7b00fda26fe7d..3b8fd12a82b81 100644 --- a/clients/client-cloud9/runtimeConfig.shared.ts +++ b/clients/client-cloud9/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-09-23", disableHostPrefix: false, diff --git a/clients/client-cloud9/runtimeConfig.ts b/clients/client-cloud9/runtimeConfig.ts index 0e3cb6b5244d0..2287cb2d4e26e 100644 --- a/clients/client-cloud9/runtimeConfig.ts +++ b/clients/client-cloud9/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./Cloud9Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloud9/tsconfig.json b/clients/client-cloud9/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloud9/tsconfig.json +++ b/clients/client-cloud9/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-clouddirectory/commands/AddFacetToObjectCommand.ts b/clients/client-clouddirectory/commands/AddFacetToObjectCommand.ts index 465767d885a51..caa451ba54dff 100644 --- a/clients/client-clouddirectory/commands/AddFacetToObjectCommand.ts +++ b/clients/client-clouddirectory/commands/AddFacetToObjectCommand.ts @@ -20,6 +20,9 @@ import { export type AddFacetToObjectCommandInput = AddFacetToObjectRequest; export type AddFacetToObjectCommandOutput = AddFacetToObjectResponse & __MetadataBearer; +/** + *

Adds a new Facet to an object. An object can have more than one facet applied on it.

+ */ export class AddFacetToObjectCommand extends $Command< AddFacetToObjectCommandInput, AddFacetToObjectCommandOutput, @@ -34,6 +37,9 @@ export class AddFacetToObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ApplySchemaCommand.ts b/clients/client-clouddirectory/commands/ApplySchemaCommand.ts index 3652c58d3ea52..f6484f0ebd18a 100644 --- a/clients/client-clouddirectory/commands/ApplySchemaCommand.ts +++ b/clients/client-clouddirectory/commands/ApplySchemaCommand.ts @@ -20,6 +20,10 @@ import { export type ApplySchemaCommandInput = ApplySchemaRequest; export type ApplySchemaCommandOutput = ApplySchemaResponse & __MetadataBearer; +/** + *

Copies the input published schema, at the specified version, into the Directory with the same + * name and version as that of the published schema.

+ */ export class ApplySchemaCommand extends $Command< ApplySchemaCommandInput, ApplySchemaCommandOutput, @@ -34,6 +38,9 @@ export class ApplySchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/AttachObjectCommand.ts b/clients/client-clouddirectory/commands/AttachObjectCommand.ts index c4aed70bf6b6a..73f41f06c06ea 100644 --- a/clients/client-clouddirectory/commands/AttachObjectCommand.ts +++ b/clients/client-clouddirectory/commands/AttachObjectCommand.ts @@ -20,6 +20,19 @@ import { export type AttachObjectCommandInput = AttachObjectRequest; export type AttachObjectCommandOutput = AttachObjectResponse & __MetadataBearer; +/** + *

Attaches an existing object to another object. An object can be accessed in two + * ways:

+ *
    + *
  1. + *

    Using the path

    + *
  2. + *
  3. + *

    Using ObjectIdentifier + *

    + *
  4. + *
+ */ export class AttachObjectCommand extends $Command< AttachObjectCommandInput, AttachObjectCommandOutput, @@ -34,6 +47,9 @@ export class AttachObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/AttachPolicyCommand.ts b/clients/client-clouddirectory/commands/AttachPolicyCommand.ts index 4d94a1cd44208..6969f7edbddc3 100644 --- a/clients/client-clouddirectory/commands/AttachPolicyCommand.ts +++ b/clients/client-clouddirectory/commands/AttachPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type AttachPolicyCommandInput = AttachPolicyRequest; export type AttachPolicyCommandOutput = AttachPolicyResponse & __MetadataBearer; +/** + *

Attaches a policy object to a regular object. An object can have a limited number of attached + * policies.

+ */ export class AttachPolicyCommand extends $Command< AttachPolicyCommandInput, AttachPolicyCommandOutput, @@ -34,6 +38,9 @@ export class AttachPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/AttachToIndexCommand.ts b/clients/client-clouddirectory/commands/AttachToIndexCommand.ts index 8ac5d471b8c8b..30bc5f2c8e296 100644 --- a/clients/client-clouddirectory/commands/AttachToIndexCommand.ts +++ b/clients/client-clouddirectory/commands/AttachToIndexCommand.ts @@ -20,6 +20,9 @@ import { export type AttachToIndexCommandInput = AttachToIndexRequest; export type AttachToIndexCommandOutput = AttachToIndexResponse & __MetadataBearer; +/** + *

Attaches the specified object to the specified index.

+ */ export class AttachToIndexCommand extends $Command< AttachToIndexCommandInput, AttachToIndexCommandOutput, @@ -34,6 +37,9 @@ export class AttachToIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/AttachTypedLinkCommand.ts b/clients/client-clouddirectory/commands/AttachTypedLinkCommand.ts index 6fcc455009263..dfb24b59febf3 100644 --- a/clients/client-clouddirectory/commands/AttachTypedLinkCommand.ts +++ b/clients/client-clouddirectory/commands/AttachTypedLinkCommand.ts @@ -20,6 +20,9 @@ import { export type AttachTypedLinkCommandInput = AttachTypedLinkRequest; export type AttachTypedLinkCommandOutput = AttachTypedLinkResponse & __MetadataBearer; +/** + *

Attaches a typed link to a specified source and target object. For more information, see Typed Links.

+ */ export class AttachTypedLinkCommand extends $Command< AttachTypedLinkCommandInput, AttachTypedLinkCommandOutput, @@ -34,6 +37,9 @@ export class AttachTypedLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/BatchReadCommand.ts b/clients/client-clouddirectory/commands/BatchReadCommand.ts index d4761a731b2f2..74b87c15f4cb3 100644 --- a/clients/client-clouddirectory/commands/BatchReadCommand.ts +++ b/clients/client-clouddirectory/commands/BatchReadCommand.ts @@ -20,6 +20,9 @@ import { export type BatchReadCommandInput = BatchReadRequest; export type BatchReadCommandOutput = BatchReadResponse & __MetadataBearer; +/** + *

Performs all the read operations in a batch.

+ */ export class BatchReadCommand extends $Command< BatchReadCommandInput, BatchReadCommandOutput, @@ -34,6 +37,9 @@ export class BatchReadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/BatchWriteCommand.ts b/clients/client-clouddirectory/commands/BatchWriteCommand.ts index 18e7bd69c673a..fe7792cb787b6 100644 --- a/clients/client-clouddirectory/commands/BatchWriteCommand.ts +++ b/clients/client-clouddirectory/commands/BatchWriteCommand.ts @@ -20,6 +20,10 @@ import { export type BatchWriteCommandInput = BatchWriteRequest; export type BatchWriteCommandOutput = BatchWriteResponse & __MetadataBearer; +/** + *

Performs all the write operations in a batch. Either all the operations succeed or + * none.

+ */ export class BatchWriteCommand extends $Command< BatchWriteCommandInput, BatchWriteCommandOutput, @@ -34,6 +38,9 @@ export class BatchWriteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/CreateDirectoryCommand.ts b/clients/client-clouddirectory/commands/CreateDirectoryCommand.ts index 1c191d267a7c1..1cd037b349f97 100644 --- a/clients/client-clouddirectory/commands/CreateDirectoryCommand.ts +++ b/clients/client-clouddirectory/commands/CreateDirectoryCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDirectoryCommandInput = CreateDirectoryRequest; export type CreateDirectoryCommandOutput = CreateDirectoryResponse & __MetadataBearer; +/** + *

Creates a Directory by copying the published schema into the + * directory. A directory cannot be created without a schema.

+ *

You can also quickly create a directory using a managed schema, called the + * QuickStartSchema. For more information, see Managed Schema in the Amazon Cloud Directory Developer Guide.

+ */ export class CreateDirectoryCommand extends $Command< CreateDirectoryCommandInput, CreateDirectoryCommandOutput, @@ -34,6 +40,9 @@ export class CreateDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/CreateFacetCommand.ts b/clients/client-clouddirectory/commands/CreateFacetCommand.ts index 27a2d7f8be2e5..757c00229c807 100644 --- a/clients/client-clouddirectory/commands/CreateFacetCommand.ts +++ b/clients/client-clouddirectory/commands/CreateFacetCommand.ts @@ -20,6 +20,10 @@ import { export type CreateFacetCommandInput = CreateFacetRequest; export type CreateFacetCommandOutput = CreateFacetResponse & __MetadataBearer; +/** + *

Creates a new Facet in a schema. Facet creation is allowed only + * in development or applied schemas.

+ */ export class CreateFacetCommand extends $Command< CreateFacetCommandInput, CreateFacetCommandOutput, @@ -34,6 +38,9 @@ export class CreateFacetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/CreateIndexCommand.ts b/clients/client-clouddirectory/commands/CreateIndexCommand.ts index 3fe37134b899d..0afe7fbc5abef 100644 --- a/clients/client-clouddirectory/commands/CreateIndexCommand.ts +++ b/clients/client-clouddirectory/commands/CreateIndexCommand.ts @@ -20,6 +20,9 @@ import { export type CreateIndexCommandInput = CreateIndexRequest; export type CreateIndexCommandOutput = CreateIndexResponse & __MetadataBearer; +/** + *

Creates an index object. See Indexing and search for more information.

+ */ export class CreateIndexCommand extends $Command< CreateIndexCommandInput, CreateIndexCommandOutput, @@ -34,6 +37,9 @@ export class CreateIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/CreateObjectCommand.ts b/clients/client-clouddirectory/commands/CreateObjectCommand.ts index f57cc29aa30b1..a5dac95d168bf 100644 --- a/clients/client-clouddirectory/commands/CreateObjectCommand.ts +++ b/clients/client-clouddirectory/commands/CreateObjectCommand.ts @@ -20,6 +20,12 @@ import { export type CreateObjectCommandInput = CreateObjectRequest; export type CreateObjectCommandOutput = CreateObjectResponse & __MetadataBearer; +/** + *

Creates an object in a Directory. Additionally attaches the object to + * a parent, if a parent reference and LinkName is specified. An object is simply a + * collection of Facet attributes. You can also use this API call to create a + * policy object, if the facet from which you create the object is a policy facet.

+ */ export class CreateObjectCommand extends $Command< CreateObjectCommandInput, CreateObjectCommandOutput, @@ -34,6 +40,9 @@ export class CreateObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/CreateSchemaCommand.ts b/clients/client-clouddirectory/commands/CreateSchemaCommand.ts index 15694441e776c..108e7f030b85b 100644 --- a/clients/client-clouddirectory/commands/CreateSchemaCommand.ts +++ b/clients/client-clouddirectory/commands/CreateSchemaCommand.ts @@ -20,6 +20,29 @@ import { export type CreateSchemaCommandInput = CreateSchemaRequest; export type CreateSchemaCommandOutput = CreateSchemaResponse & __MetadataBearer; +/** + *

Creates a new schema in a development state. A schema can exist in three + * phases:

+ *
    + *
  • + *

    + * Development: This is a mutable phase of the schema. All new + * schemas are in the development phase. Once the schema is finalized, it can be + * published.

    + *
  • + *
  • + *

    + * Published: Published schemas are immutable and have a version + * associated with them.

    + *
  • + *
  • + *

    + * Applied: Applied schemas are mutable in a way that allows you + * to add new schema facets. You can also add new, nonrequired attributes to existing schema + * facets. You can apply only published schemas to directories.

    + *
  • + *
+ */ export class CreateSchemaCommand extends $Command< CreateSchemaCommandInput, CreateSchemaCommandOutput, @@ -34,6 +57,9 @@ export class CreateSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/CreateTypedLinkFacetCommand.ts b/clients/client-clouddirectory/commands/CreateTypedLinkFacetCommand.ts index 6e3b9e387ea32..122f294d9d1f5 100644 --- a/clients/client-clouddirectory/commands/CreateTypedLinkFacetCommand.ts +++ b/clients/client-clouddirectory/commands/CreateTypedLinkFacetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTypedLinkFacetCommandInput = CreateTypedLinkFacetRequest; export type CreateTypedLinkFacetCommandOutput = CreateTypedLinkFacetResponse & __MetadataBearer; +/** + *

Creates a TypedLinkFacet. For more information, see Typed Links.

+ */ export class CreateTypedLinkFacetCommand extends $Command< CreateTypedLinkFacetCommandInput, CreateTypedLinkFacetCommandOutput, @@ -34,6 +37,9 @@ export class CreateTypedLinkFacetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DeleteDirectoryCommand.ts b/clients/client-clouddirectory/commands/DeleteDirectoryCommand.ts index 9b47eaf28916e..25955ad9cded9 100644 --- a/clients/client-clouddirectory/commands/DeleteDirectoryCommand.ts +++ b/clients/client-clouddirectory/commands/DeleteDirectoryCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDirectoryCommandInput = DeleteDirectoryRequest; export type DeleteDirectoryCommandOutput = DeleteDirectoryResponse & __MetadataBearer; +/** + *

Deletes a directory. Only disabled directories can be deleted. A deleted directory cannot be undone. Exercise extreme + * caution + * when deleting directories.

+ */ export class DeleteDirectoryCommand extends $Command< DeleteDirectoryCommandInput, DeleteDirectoryCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DeleteFacetCommand.ts b/clients/client-clouddirectory/commands/DeleteFacetCommand.ts index 0526bb17e5501..fe3a1b0dd59f6 100644 --- a/clients/client-clouddirectory/commands/DeleteFacetCommand.ts +++ b/clients/client-clouddirectory/commands/DeleteFacetCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteFacetCommandInput = DeleteFacetRequest; export type DeleteFacetCommandOutput = DeleteFacetResponse & __MetadataBearer; +/** + *

Deletes a given Facet. All attributes and Rules + * that are associated with the facet will be deleted. Only development schema facets are allowed + * deletion.

+ */ export class DeleteFacetCommand extends $Command< DeleteFacetCommandInput, DeleteFacetCommandOutput, @@ -34,6 +39,9 @@ export class DeleteFacetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DeleteObjectCommand.ts b/clients/client-clouddirectory/commands/DeleteObjectCommand.ts index 7dd051dec1245..5f62e1f1bca45 100644 --- a/clients/client-clouddirectory/commands/DeleteObjectCommand.ts +++ b/clients/client-clouddirectory/commands/DeleteObjectCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteObjectCommandInput = DeleteObjectRequest; export type DeleteObjectCommandOutput = DeleteObjectResponse & __MetadataBearer; +/** + *

Deletes an object and its associated attributes. Only objects with no children and no + * parents can be deleted. The maximum number of attributes that can be deleted during an object deletion is 30. For more information, see Amazon Cloud Directory Limits.

+ */ export class DeleteObjectCommand extends $Command< DeleteObjectCommandInput, DeleteObjectCommandOutput, @@ -34,6 +38,9 @@ export class DeleteObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DeleteSchemaCommand.ts b/clients/client-clouddirectory/commands/DeleteSchemaCommand.ts index 0ad0643eafa3a..4cd40cea5ebb7 100644 --- a/clients/client-clouddirectory/commands/DeleteSchemaCommand.ts +++ b/clients/client-clouddirectory/commands/DeleteSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSchemaCommandInput = DeleteSchemaRequest; export type DeleteSchemaCommandOutput = DeleteSchemaResponse & __MetadataBearer; +/** + *

Deletes a given schema. Schemas in a development and published state can only be deleted.

+ */ export class DeleteSchemaCommand extends $Command< DeleteSchemaCommandInput, DeleteSchemaCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DeleteTypedLinkFacetCommand.ts b/clients/client-clouddirectory/commands/DeleteTypedLinkFacetCommand.ts index a74463b31a565..62ef8a58cd5db 100644 --- a/clients/client-clouddirectory/commands/DeleteTypedLinkFacetCommand.ts +++ b/clients/client-clouddirectory/commands/DeleteTypedLinkFacetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTypedLinkFacetCommandInput = DeleteTypedLinkFacetRequest; export type DeleteTypedLinkFacetCommandOutput = DeleteTypedLinkFacetResponse & __MetadataBearer; +/** + *

Deletes a TypedLinkFacet. For more information, see Typed Links.

+ */ export class DeleteTypedLinkFacetCommand extends $Command< DeleteTypedLinkFacetCommandInput, DeleteTypedLinkFacetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTypedLinkFacetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DetachFromIndexCommand.ts b/clients/client-clouddirectory/commands/DetachFromIndexCommand.ts index 9013c3a84d617..19d3937e50e7a 100644 --- a/clients/client-clouddirectory/commands/DetachFromIndexCommand.ts +++ b/clients/client-clouddirectory/commands/DetachFromIndexCommand.ts @@ -20,6 +20,9 @@ import { export type DetachFromIndexCommandInput = DetachFromIndexRequest; export type DetachFromIndexCommandOutput = DetachFromIndexResponse & __MetadataBearer; +/** + *

Detaches the specified object from the specified index.

+ */ export class DetachFromIndexCommand extends $Command< DetachFromIndexCommandInput, DetachFromIndexCommandOutput, @@ -34,6 +37,9 @@ export class DetachFromIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DetachObjectCommand.ts b/clients/client-clouddirectory/commands/DetachObjectCommand.ts index 27e6c3b70fa62..9428769f50937 100644 --- a/clients/client-clouddirectory/commands/DetachObjectCommand.ts +++ b/clients/client-clouddirectory/commands/DetachObjectCommand.ts @@ -20,6 +20,10 @@ import { export type DetachObjectCommandInput = DetachObjectRequest; export type DetachObjectCommandOutput = DetachObjectResponse & __MetadataBearer; +/** + *

Detaches a given object from the parent object. The object that is to be detached from the + * parent is specified by the link name.

+ */ export class DetachObjectCommand extends $Command< DetachObjectCommandInput, DetachObjectCommandOutput, @@ -34,6 +38,9 @@ export class DetachObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DetachPolicyCommand.ts b/clients/client-clouddirectory/commands/DetachPolicyCommand.ts index d9314a93a2219..802d5e3b02dcc 100644 --- a/clients/client-clouddirectory/commands/DetachPolicyCommand.ts +++ b/clients/client-clouddirectory/commands/DetachPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DetachPolicyCommandInput = DetachPolicyRequest; export type DetachPolicyCommandOutput = DetachPolicyResponse & __MetadataBearer; +/** + *

Detaches a policy from an object.

+ */ export class DetachPolicyCommand extends $Command< DetachPolicyCommandInput, DetachPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DetachPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DetachTypedLinkCommand.ts b/clients/client-clouddirectory/commands/DetachTypedLinkCommand.ts index c9001a6ea75ac..8bd90b61bb868 100644 --- a/clients/client-clouddirectory/commands/DetachTypedLinkCommand.ts +++ b/clients/client-clouddirectory/commands/DetachTypedLinkCommand.ts @@ -20,6 +20,9 @@ import { export type DetachTypedLinkCommandInput = DetachTypedLinkRequest; export type DetachTypedLinkCommandOutput = __MetadataBearer; +/** + *

Detaches a typed link from a specified source and target object. For more information, see Typed Links.

+ */ export class DetachTypedLinkCommand extends $Command< DetachTypedLinkCommandInput, DetachTypedLinkCommandOutput, @@ -34,6 +37,9 @@ export class DetachTypedLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/DisableDirectoryCommand.ts b/clients/client-clouddirectory/commands/DisableDirectoryCommand.ts index 2b65c6fff6a37..4dde41c0832c0 100644 --- a/clients/client-clouddirectory/commands/DisableDirectoryCommand.ts +++ b/clients/client-clouddirectory/commands/DisableDirectoryCommand.ts @@ -20,6 +20,10 @@ import { export type DisableDirectoryCommandInput = DisableDirectoryRequest; export type DisableDirectoryCommandOutput = DisableDirectoryResponse & __MetadataBearer; +/** + *

Disables the specified directory. Disabled directories cannot be read or written to. + * Only enabled directories can be disabled. Disabled directories may be reenabled.

+ */ export class DisableDirectoryCommand extends $Command< DisableDirectoryCommandInput, DisableDirectoryCommandOutput, @@ -34,6 +38,9 @@ export class DisableDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/EnableDirectoryCommand.ts b/clients/client-clouddirectory/commands/EnableDirectoryCommand.ts index 60799d11216cf..93835ba1d05f4 100644 --- a/clients/client-clouddirectory/commands/EnableDirectoryCommand.ts +++ b/clients/client-clouddirectory/commands/EnableDirectoryCommand.ts @@ -20,6 +20,10 @@ import { export type EnableDirectoryCommandInput = EnableDirectoryRequest; export type EnableDirectoryCommandOutput = EnableDirectoryResponse & __MetadataBearer; +/** + *

Enables the specified directory. Only disabled directories can be enabled. Once + * enabled, the directory can then be read and written to.

+ */ export class EnableDirectoryCommand extends $Command< EnableDirectoryCommandInput, EnableDirectoryCommandOutput, @@ -34,6 +38,9 @@ export class EnableDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/GetAppliedSchemaVersionCommand.ts b/clients/client-clouddirectory/commands/GetAppliedSchemaVersionCommand.ts index 02f966f571753..fb4cefa59aac9 100644 --- a/clients/client-clouddirectory/commands/GetAppliedSchemaVersionCommand.ts +++ b/clients/client-clouddirectory/commands/GetAppliedSchemaVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetAppliedSchemaVersionCommandInput = GetAppliedSchemaVersionRequest; export type GetAppliedSchemaVersionCommandOutput = GetAppliedSchemaVersionResponse & __MetadataBearer; +/** + *

Returns current applied schema version ARN, including the minor version in use.

+ */ export class GetAppliedSchemaVersionCommand extends $Command< GetAppliedSchemaVersionCommandInput, GetAppliedSchemaVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetAppliedSchemaVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/GetDirectoryCommand.ts b/clients/client-clouddirectory/commands/GetDirectoryCommand.ts index f68d82470ad37..897af0f89359e 100644 --- a/clients/client-clouddirectory/commands/GetDirectoryCommand.ts +++ b/clients/client-clouddirectory/commands/GetDirectoryCommand.ts @@ -20,6 +20,9 @@ import { export type GetDirectoryCommandInput = GetDirectoryRequest; export type GetDirectoryCommandOutput = GetDirectoryResponse & __MetadataBearer; +/** + *

Retrieves metadata about a directory.

+ */ export class GetDirectoryCommand extends $Command< GetDirectoryCommandInput, GetDirectoryCommandOutput, @@ -34,6 +37,9 @@ export class GetDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/GetFacetCommand.ts b/clients/client-clouddirectory/commands/GetFacetCommand.ts index 9d264da76e252..b5473f4cc4e9b 100644 --- a/clients/client-clouddirectory/commands/GetFacetCommand.ts +++ b/clients/client-clouddirectory/commands/GetFacetCommand.ts @@ -20,6 +20,10 @@ import { export type GetFacetCommandInput = GetFacetRequest; export type GetFacetCommandOutput = GetFacetResponse & __MetadataBearer; +/** + *

Gets details of the Facet, such as facet name, attributes, Rules, or ObjectType. You can call this on all kinds of schema + * facets -- published, development, or applied.

+ */ export class GetFacetCommand extends $Command< GetFacetCommandInput, GetFacetCommandOutput, @@ -34,6 +38,9 @@ export class GetFacetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/GetLinkAttributesCommand.ts b/clients/client-clouddirectory/commands/GetLinkAttributesCommand.ts index 55559c9d0b746..1298f33ed5b83 100644 --- a/clients/client-clouddirectory/commands/GetLinkAttributesCommand.ts +++ b/clients/client-clouddirectory/commands/GetLinkAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type GetLinkAttributesCommandInput = GetLinkAttributesRequest; export type GetLinkAttributesCommandOutput = GetLinkAttributesResponse & __MetadataBearer; +/** + *

Retrieves attributes that are associated with a typed link.

+ */ export class GetLinkAttributesCommand extends $Command< GetLinkAttributesCommandInput, GetLinkAttributesCommandOutput, @@ -34,6 +37,9 @@ export class GetLinkAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/GetObjectAttributesCommand.ts b/clients/client-clouddirectory/commands/GetObjectAttributesCommand.ts index 7bb694db6cc05..73a428e950677 100644 --- a/clients/client-clouddirectory/commands/GetObjectAttributesCommand.ts +++ b/clients/client-clouddirectory/commands/GetObjectAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type GetObjectAttributesCommandInput = GetObjectAttributesRequest; export type GetObjectAttributesCommandOutput = GetObjectAttributesResponse & __MetadataBearer; +/** + *

Retrieves attributes within a facet that are associated with an object.

+ */ export class GetObjectAttributesCommand extends $Command< GetObjectAttributesCommandInput, GetObjectAttributesCommandOutput, @@ -34,6 +37,9 @@ export class GetObjectAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/GetObjectInformationCommand.ts b/clients/client-clouddirectory/commands/GetObjectInformationCommand.ts index ea4d5f3bffc0a..eecec21d7373e 100644 --- a/clients/client-clouddirectory/commands/GetObjectInformationCommand.ts +++ b/clients/client-clouddirectory/commands/GetObjectInformationCommand.ts @@ -20,6 +20,9 @@ import { export type GetObjectInformationCommandInput = GetObjectInformationRequest; export type GetObjectInformationCommandOutput = GetObjectInformationResponse & __MetadataBearer; +/** + *

Retrieves metadata about an object.

+ */ export class GetObjectInformationCommand extends $Command< GetObjectInformationCommandInput, GetObjectInformationCommandOutput, @@ -34,6 +37,9 @@ export class GetObjectInformationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/GetSchemaAsJsonCommand.ts b/clients/client-clouddirectory/commands/GetSchemaAsJsonCommand.ts index 14fe75dd562c8..10a0b3a69837a 100644 --- a/clients/client-clouddirectory/commands/GetSchemaAsJsonCommand.ts +++ b/clients/client-clouddirectory/commands/GetSchemaAsJsonCommand.ts @@ -20,6 +20,9 @@ import { export type GetSchemaAsJsonCommandInput = GetSchemaAsJsonRequest; export type GetSchemaAsJsonCommandOutput = GetSchemaAsJsonResponse & __MetadataBearer; +/** + *

Retrieves a JSON representation of the schema. See JSON Schema Format for more information.

+ */ export class GetSchemaAsJsonCommand extends $Command< GetSchemaAsJsonCommandInput, GetSchemaAsJsonCommandOutput, @@ -34,6 +37,9 @@ export class GetSchemaAsJsonCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/GetTypedLinkFacetInformationCommand.ts b/clients/client-clouddirectory/commands/GetTypedLinkFacetInformationCommand.ts index 87c52ff041bbd..86811d6d68b54 100644 --- a/clients/client-clouddirectory/commands/GetTypedLinkFacetInformationCommand.ts +++ b/clients/client-clouddirectory/commands/GetTypedLinkFacetInformationCommand.ts @@ -20,6 +20,9 @@ import { export type GetTypedLinkFacetInformationCommandInput = GetTypedLinkFacetInformationRequest; export type GetTypedLinkFacetInformationCommandOutput = GetTypedLinkFacetInformationResponse & __MetadataBearer; +/** + *

Returns the identity attribute order for a specific TypedLinkFacet. For more information, see Typed Links.

+ */ export class GetTypedLinkFacetInformationCommand extends $Command< GetTypedLinkFacetInformationCommandInput, GetTypedLinkFacetInformationCommandOutput, @@ -34,6 +37,9 @@ export class GetTypedLinkFacetInformationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListAppliedSchemaArnsCommand.ts b/clients/client-clouddirectory/commands/ListAppliedSchemaArnsCommand.ts index aa051c49a7132..f18b142edd687 100644 --- a/clients/client-clouddirectory/commands/ListAppliedSchemaArnsCommand.ts +++ b/clients/client-clouddirectory/commands/ListAppliedSchemaArnsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAppliedSchemaArnsCommandInput = ListAppliedSchemaArnsRequest; export type ListAppliedSchemaArnsCommandOutput = ListAppliedSchemaArnsResponse & __MetadataBearer; +/** + *

Lists schema major versions applied to a directory. If SchemaArn is provided, lists the minor version.

+ */ export class ListAppliedSchemaArnsCommand extends $Command< ListAppliedSchemaArnsCommandInput, ListAppliedSchemaArnsCommandOutput, @@ -34,6 +37,9 @@ export class ListAppliedSchemaArnsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListAttachedIndicesCommand.ts b/clients/client-clouddirectory/commands/ListAttachedIndicesCommand.ts index 1af1cba58a6fe..a474fba3b70b2 100644 --- a/clients/client-clouddirectory/commands/ListAttachedIndicesCommand.ts +++ b/clients/client-clouddirectory/commands/ListAttachedIndicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListAttachedIndicesCommandInput = ListAttachedIndicesRequest; export type ListAttachedIndicesCommandOutput = ListAttachedIndicesResponse & __MetadataBearer; +/** + *

Lists indices attached to the specified object.

+ */ export class ListAttachedIndicesCommand extends $Command< ListAttachedIndicesCommandInput, ListAttachedIndicesCommandOutput, @@ -34,6 +37,9 @@ export class ListAttachedIndicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListDevelopmentSchemaArnsCommand.ts b/clients/client-clouddirectory/commands/ListDevelopmentSchemaArnsCommand.ts index 1a46dd1c9ebc0..764d124c11655 100644 --- a/clients/client-clouddirectory/commands/ListDevelopmentSchemaArnsCommand.ts +++ b/clients/client-clouddirectory/commands/ListDevelopmentSchemaArnsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDevelopmentSchemaArnsCommandInput = ListDevelopmentSchemaArnsRequest; export type ListDevelopmentSchemaArnsCommandOutput = ListDevelopmentSchemaArnsResponse & __MetadataBearer; +/** + *

Retrieves each Amazon Resource Name (ARN) of schemas in the development + * state.

+ */ export class ListDevelopmentSchemaArnsCommand extends $Command< ListDevelopmentSchemaArnsCommandInput, ListDevelopmentSchemaArnsCommandOutput, @@ -34,6 +38,9 @@ export class ListDevelopmentSchemaArnsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListDirectoriesCommand.ts b/clients/client-clouddirectory/commands/ListDirectoriesCommand.ts index f716fcd19fd57..cdd9b79acde06 100644 --- a/clients/client-clouddirectory/commands/ListDirectoriesCommand.ts +++ b/clients/client-clouddirectory/commands/ListDirectoriesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDirectoriesCommandInput = ListDirectoriesRequest; export type ListDirectoriesCommandOutput = ListDirectoriesResponse & __MetadataBearer; +/** + *

Lists directories created within an account.

+ */ export class ListDirectoriesCommand extends $Command< ListDirectoriesCommandInput, ListDirectoriesCommandOutput, @@ -34,6 +37,9 @@ export class ListDirectoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListFacetAttributesCommand.ts b/clients/client-clouddirectory/commands/ListFacetAttributesCommand.ts index 566dda1fade91..d3b406971681c 100644 --- a/clients/client-clouddirectory/commands/ListFacetAttributesCommand.ts +++ b/clients/client-clouddirectory/commands/ListFacetAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type ListFacetAttributesCommandInput = ListFacetAttributesRequest; export type ListFacetAttributesCommandOutput = ListFacetAttributesResponse & __MetadataBearer; +/** + *

Retrieves attributes attached to the facet.

+ */ export class ListFacetAttributesCommand extends $Command< ListFacetAttributesCommandInput, ListFacetAttributesCommandOutput, @@ -34,6 +37,9 @@ export class ListFacetAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListFacetNamesCommand.ts b/clients/client-clouddirectory/commands/ListFacetNamesCommand.ts index a6e8ba940506a..871e0253ebc76 100644 --- a/clients/client-clouddirectory/commands/ListFacetNamesCommand.ts +++ b/clients/client-clouddirectory/commands/ListFacetNamesCommand.ts @@ -20,6 +20,9 @@ import { export type ListFacetNamesCommandInput = ListFacetNamesRequest; export type ListFacetNamesCommandOutput = ListFacetNamesResponse & __MetadataBearer; +/** + *

Retrieves the names of facets that exist in a schema.

+ */ export class ListFacetNamesCommand extends $Command< ListFacetNamesCommandInput, ListFacetNamesCommandOutput, @@ -34,6 +37,9 @@ export class ListFacetNamesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListIncomingTypedLinksCommand.ts b/clients/client-clouddirectory/commands/ListIncomingTypedLinksCommand.ts index 6c0ab2ba6c286..b347648d78919 100644 --- a/clients/client-clouddirectory/commands/ListIncomingTypedLinksCommand.ts +++ b/clients/client-clouddirectory/commands/ListIncomingTypedLinksCommand.ts @@ -20,6 +20,11 @@ import { export type ListIncomingTypedLinksCommandInput = ListIncomingTypedLinksRequest; export type ListIncomingTypedLinksCommandOutput = ListIncomingTypedLinksResponse & __MetadataBearer; +/** + *

Returns a paginated list of all the incoming TypedLinkSpecifier + * information for an object. It also supports filtering by typed link facet and identity + * attributes. For more information, see Typed Links.

+ */ export class ListIncomingTypedLinksCommand extends $Command< ListIncomingTypedLinksCommandInput, ListIncomingTypedLinksCommandOutput, @@ -34,6 +39,9 @@ export class ListIncomingTypedLinksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListIndexCommand.ts b/clients/client-clouddirectory/commands/ListIndexCommand.ts index f4d472f0c5c61..88d64dfe75e11 100644 --- a/clients/client-clouddirectory/commands/ListIndexCommand.ts +++ b/clients/client-clouddirectory/commands/ListIndexCommand.ts @@ -20,6 +20,9 @@ import { export type ListIndexCommandInput = ListIndexRequest; export type ListIndexCommandOutput = ListIndexResponse & __MetadataBearer; +/** + *

Lists objects attached to the specified index.

+ */ export class ListIndexCommand extends $Command< ListIndexCommandInput, ListIndexCommandOutput, @@ -34,6 +37,9 @@ export class ListIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListManagedSchemaArnsCommand.ts b/clients/client-clouddirectory/commands/ListManagedSchemaArnsCommand.ts index d2c9e11e494df..7b845951af3fe 100644 --- a/clients/client-clouddirectory/commands/ListManagedSchemaArnsCommand.ts +++ b/clients/client-clouddirectory/commands/ListManagedSchemaArnsCommand.ts @@ -20,6 +20,9 @@ import { export type ListManagedSchemaArnsCommandInput = ListManagedSchemaArnsRequest; export type ListManagedSchemaArnsCommandOutput = ListManagedSchemaArnsResponse & __MetadataBearer; +/** + *

Lists the major version families of each managed schema. If a major version ARN is provided as SchemaArn, the minor version revisions in that family are listed instead.

+ */ export class ListManagedSchemaArnsCommand extends $Command< ListManagedSchemaArnsCommandInput, ListManagedSchemaArnsCommandOutput, @@ -34,6 +37,9 @@ export class ListManagedSchemaArnsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListObjectAttributesCommand.ts b/clients/client-clouddirectory/commands/ListObjectAttributesCommand.ts index 52a4f53ca9b47..4281bc34a683d 100644 --- a/clients/client-clouddirectory/commands/ListObjectAttributesCommand.ts +++ b/clients/client-clouddirectory/commands/ListObjectAttributesCommand.ts @@ -20,6 +20,10 @@ import { export type ListObjectAttributesCommandInput = ListObjectAttributesRequest; export type ListObjectAttributesCommandOutput = ListObjectAttributesResponse & __MetadataBearer; +/** + *

Lists all attributes that are associated with an object. + *

+ */ export class ListObjectAttributesCommand extends $Command< ListObjectAttributesCommandInput, ListObjectAttributesCommandOutput, @@ -34,6 +38,9 @@ export class ListObjectAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListObjectChildrenCommand.ts b/clients/client-clouddirectory/commands/ListObjectChildrenCommand.ts index 58c323f95e289..40a48da990dbe 100644 --- a/clients/client-clouddirectory/commands/ListObjectChildrenCommand.ts +++ b/clients/client-clouddirectory/commands/ListObjectChildrenCommand.ts @@ -20,6 +20,10 @@ import { export type ListObjectChildrenCommandInput = ListObjectChildrenRequest; export type ListObjectChildrenCommandOutput = ListObjectChildrenResponse & __MetadataBearer; +/** + *

Returns a paginated list of child objects that are associated with a given + * object.

+ */ export class ListObjectChildrenCommand extends $Command< ListObjectChildrenCommandInput, ListObjectChildrenCommandOutput, @@ -34,6 +38,9 @@ export class ListObjectChildrenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListObjectParentPathsCommand.ts b/clients/client-clouddirectory/commands/ListObjectParentPathsCommand.ts index c48c8d22c3bc0..73a8bcdbdada5 100644 --- a/clients/client-clouddirectory/commands/ListObjectParentPathsCommand.ts +++ b/clients/client-clouddirectory/commands/ListObjectParentPathsCommand.ts @@ -20,6 +20,16 @@ import { export type ListObjectParentPathsCommandInput = ListObjectParentPathsRequest; export type ListObjectParentPathsCommandOutput = ListObjectParentPathsResponse & __MetadataBearer; +/** + *

Retrieves all available parent paths for any object type such as node, leaf node, + * policy node, and index node objects. For more information about objects, see Directory Structure.

+ *

Use this API to evaluate all parents for an object. The call returns all objects from + * the root of the directory up to the requested object. The API returns the number of paths + * based on user-defined MaxResults, in case there are multiple paths to the parent. + * The order of the paths and nodes returned is consistent among multiple API calls unless the + * objects are deleted or moved. Paths not leading to the directory root are ignored from the + * target object.

+ */ export class ListObjectParentPathsCommand extends $Command< ListObjectParentPathsCommandInput, ListObjectParentPathsCommandOutput, @@ -34,6 +44,9 @@ export class ListObjectParentPathsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListObjectParentsCommand.ts b/clients/client-clouddirectory/commands/ListObjectParentsCommand.ts index 588cc5b9519f2..302d1991abeb9 100644 --- a/clients/client-clouddirectory/commands/ListObjectParentsCommand.ts +++ b/clients/client-clouddirectory/commands/ListObjectParentsCommand.ts @@ -20,6 +20,10 @@ import { export type ListObjectParentsCommandInput = ListObjectParentsRequest; export type ListObjectParentsCommandOutput = ListObjectParentsResponse & __MetadataBearer; +/** + *

Lists parent objects that are associated with a given object in pagination + * fashion.

+ */ export class ListObjectParentsCommand extends $Command< ListObjectParentsCommandInput, ListObjectParentsCommandOutput, @@ -34,6 +38,9 @@ export class ListObjectParentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListObjectPoliciesCommand.ts b/clients/client-clouddirectory/commands/ListObjectPoliciesCommand.ts index 2927615ed4451..e08dfb7e502dd 100644 --- a/clients/client-clouddirectory/commands/ListObjectPoliciesCommand.ts +++ b/clients/client-clouddirectory/commands/ListObjectPoliciesCommand.ts @@ -20,6 +20,9 @@ import { export type ListObjectPoliciesCommandInput = ListObjectPoliciesRequest; export type ListObjectPoliciesCommandOutput = ListObjectPoliciesResponse & __MetadataBearer; +/** + *

Returns policies attached to an object in pagination fashion.

+ */ export class ListObjectPoliciesCommand extends $Command< ListObjectPoliciesCommandInput, ListObjectPoliciesCommandOutput, @@ -34,6 +37,9 @@ export class ListObjectPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListOutgoingTypedLinksCommand.ts b/clients/client-clouddirectory/commands/ListOutgoingTypedLinksCommand.ts index cd0d301b7d011..475f0e2ecc1bc 100644 --- a/clients/client-clouddirectory/commands/ListOutgoingTypedLinksCommand.ts +++ b/clients/client-clouddirectory/commands/ListOutgoingTypedLinksCommand.ts @@ -20,6 +20,11 @@ import { export type ListOutgoingTypedLinksCommandInput = ListOutgoingTypedLinksRequest; export type ListOutgoingTypedLinksCommandOutput = ListOutgoingTypedLinksResponse & __MetadataBearer; +/** + *

Returns a paginated list of all the outgoing TypedLinkSpecifier + * information for an object. It also supports filtering by typed link facet and identity + * attributes. For more information, see Typed Links.

+ */ export class ListOutgoingTypedLinksCommand extends $Command< ListOutgoingTypedLinksCommandInput, ListOutgoingTypedLinksCommandOutput, @@ -34,6 +39,9 @@ export class ListOutgoingTypedLinksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListPolicyAttachmentsCommand.ts b/clients/client-clouddirectory/commands/ListPolicyAttachmentsCommand.ts index a43a3626ea768..a266fc58bb8cb 100644 --- a/clients/client-clouddirectory/commands/ListPolicyAttachmentsCommand.ts +++ b/clients/client-clouddirectory/commands/ListPolicyAttachmentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPolicyAttachmentsCommandInput = ListPolicyAttachmentsRequest; export type ListPolicyAttachmentsCommandOutput = ListPolicyAttachmentsResponse & __MetadataBearer; +/** + *

Returns all of the ObjectIdentifiers to which a given policy is attached.

+ */ export class ListPolicyAttachmentsCommand extends $Command< ListPolicyAttachmentsCommandInput, ListPolicyAttachmentsCommandOutput, @@ -34,6 +37,9 @@ export class ListPolicyAttachmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListPublishedSchemaArnsCommand.ts b/clients/client-clouddirectory/commands/ListPublishedSchemaArnsCommand.ts index 9b11900a93879..857a06226fdeb 100644 --- a/clients/client-clouddirectory/commands/ListPublishedSchemaArnsCommand.ts +++ b/clients/client-clouddirectory/commands/ListPublishedSchemaArnsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPublishedSchemaArnsCommandInput = ListPublishedSchemaArnsRequest; export type ListPublishedSchemaArnsCommandOutput = ListPublishedSchemaArnsResponse & __MetadataBearer; +/** + *

Lists the major version families of each published schema. If a major version ARN is provided as SchemaArn, the minor version revisions in that family are listed instead.

+ */ export class ListPublishedSchemaArnsCommand extends $Command< ListPublishedSchemaArnsCommandInput, ListPublishedSchemaArnsCommandOutput, @@ -34,6 +37,9 @@ export class ListPublishedSchemaArnsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListTagsForResourceCommand.ts b/clients/client-clouddirectory/commands/ListTagsForResourceCommand.ts index 9f8d20fa40af5..d583824ffee26 100644 --- a/clients/client-clouddirectory/commands/ListTagsForResourceCommand.ts +++ b/clients/client-clouddirectory/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns tags for a resource. Tagging is currently supported only for directories with a + * limit of 50 tags per directory. All 50 tags are returned for a given directory with this API + * call.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListTypedLinkFacetAttributesCommand.ts b/clients/client-clouddirectory/commands/ListTypedLinkFacetAttributesCommand.ts index 6cc8f8179035c..d3a0ac540c148 100644 --- a/clients/client-clouddirectory/commands/ListTypedLinkFacetAttributesCommand.ts +++ b/clients/client-clouddirectory/commands/ListTypedLinkFacetAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type ListTypedLinkFacetAttributesCommandInput = ListTypedLinkFacetAttributesRequest; export type ListTypedLinkFacetAttributesCommandOutput = ListTypedLinkFacetAttributesResponse & __MetadataBearer; +/** + *

Returns a paginated list of all attribute definitions for a particular TypedLinkFacet. For more information, see Typed Links.

+ */ export class ListTypedLinkFacetAttributesCommand extends $Command< ListTypedLinkFacetAttributesCommandInput, ListTypedLinkFacetAttributesCommandOutput, @@ -34,6 +37,9 @@ export class ListTypedLinkFacetAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/ListTypedLinkFacetNamesCommand.ts b/clients/client-clouddirectory/commands/ListTypedLinkFacetNamesCommand.ts index f6ee70ca4f368..810e9b24213c0 100644 --- a/clients/client-clouddirectory/commands/ListTypedLinkFacetNamesCommand.ts +++ b/clients/client-clouddirectory/commands/ListTypedLinkFacetNamesCommand.ts @@ -20,6 +20,10 @@ import { export type ListTypedLinkFacetNamesCommandInput = ListTypedLinkFacetNamesRequest; export type ListTypedLinkFacetNamesCommandOutput = ListTypedLinkFacetNamesResponse & __MetadataBearer; +/** + *

Returns a paginated list of TypedLink facet names for a particular schema. + * For more information, see Typed Links.

+ */ export class ListTypedLinkFacetNamesCommand extends $Command< ListTypedLinkFacetNamesCommandInput, ListTypedLinkFacetNamesCommandOutput, @@ -34,6 +38,9 @@ export class ListTypedLinkFacetNamesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/LookupPolicyCommand.ts b/clients/client-clouddirectory/commands/LookupPolicyCommand.ts index 675ef4eee01f1..efa6d51a64498 100644 --- a/clients/client-clouddirectory/commands/LookupPolicyCommand.ts +++ b/clients/client-clouddirectory/commands/LookupPolicyCommand.ts @@ -20,6 +20,14 @@ import { export type LookupPolicyCommandInput = LookupPolicyRequest; export type LookupPolicyCommandOutput = LookupPolicyResponse & __MetadataBearer; +/** + *

Lists all policies from the root of the Directory to the object + * specified. If there are no policies present, an empty list is returned. If policies are + * present, and if some objects don't have the policies attached, it returns the ObjectIdentifier + * for such objects. If policies are present, it returns ObjectIdentifier, policyId, and + * policyType. Paths that don't lead to the root from the target object are ignored. For more + * information, see Policies.

+ */ export class LookupPolicyCommand extends $Command< LookupPolicyCommandInput, LookupPolicyCommandOutput, @@ -34,6 +42,9 @@ export class LookupPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/PublishSchemaCommand.ts b/clients/client-clouddirectory/commands/PublishSchemaCommand.ts index 453a5d4a97b62..5f78ac062c8ec 100644 --- a/clients/client-clouddirectory/commands/PublishSchemaCommand.ts +++ b/clients/client-clouddirectory/commands/PublishSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type PublishSchemaCommandInput = PublishSchemaRequest; export type PublishSchemaCommandOutput = PublishSchemaResponse & __MetadataBearer; +/** + *

Publishes a development schema with a major version and a recommended minor version.

+ */ export class PublishSchemaCommand extends $Command< PublishSchemaCommandInput, PublishSchemaCommandOutput, @@ -34,6 +37,9 @@ export class PublishSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/PutSchemaFromJsonCommand.ts b/clients/client-clouddirectory/commands/PutSchemaFromJsonCommand.ts index fa693bda59d5a..e8194b2fe4994 100644 --- a/clients/client-clouddirectory/commands/PutSchemaFromJsonCommand.ts +++ b/clients/client-clouddirectory/commands/PutSchemaFromJsonCommand.ts @@ -20,6 +20,9 @@ import { export type PutSchemaFromJsonCommandInput = PutSchemaFromJsonRequest; export type PutSchemaFromJsonCommandOutput = PutSchemaFromJsonResponse & __MetadataBearer; +/** + *

Allows a schema to be updated using JSON upload. Only available for development schemas. See JSON Schema Format for more information.

+ */ export class PutSchemaFromJsonCommand extends $Command< PutSchemaFromJsonCommandInput, PutSchemaFromJsonCommandOutput, @@ -34,6 +37,9 @@ export class PutSchemaFromJsonCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/RemoveFacetFromObjectCommand.ts b/clients/client-clouddirectory/commands/RemoveFacetFromObjectCommand.ts index 2e16bef93ba12..0527c813279f2 100644 --- a/clients/client-clouddirectory/commands/RemoveFacetFromObjectCommand.ts +++ b/clients/client-clouddirectory/commands/RemoveFacetFromObjectCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveFacetFromObjectCommandInput = RemoveFacetFromObjectRequest; export type RemoveFacetFromObjectCommandOutput = RemoveFacetFromObjectResponse & __MetadataBearer; +/** + *

Removes the specified facet from the specified object.

+ */ export class RemoveFacetFromObjectCommand extends $Command< RemoveFacetFromObjectCommandInput, RemoveFacetFromObjectCommandOutput, @@ -34,6 +37,9 @@ export class RemoveFacetFromObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/TagResourceCommand.ts b/clients/client-clouddirectory/commands/TagResourceCommand.ts index 268aeac900cad..d1014afb7ca6e 100644 --- a/clients/client-clouddirectory/commands/TagResourceCommand.ts +++ b/clients/client-clouddirectory/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

An API operation for adding tags to a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/UntagResourceCommand.ts b/clients/client-clouddirectory/commands/UntagResourceCommand.ts index 7a3c361055818..c89a599bfdddf 100644 --- a/clients/client-clouddirectory/commands/UntagResourceCommand.ts +++ b/clients/client-clouddirectory/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

An API operation for removing tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/UpdateFacetCommand.ts b/clients/client-clouddirectory/commands/UpdateFacetCommand.ts index 3b32732e91007..948b10675fb68 100644 --- a/clients/client-clouddirectory/commands/UpdateFacetCommand.ts +++ b/clients/client-clouddirectory/commands/UpdateFacetCommand.ts @@ -20,6 +20,20 @@ import { export type UpdateFacetCommandInput = UpdateFacetRequest; export type UpdateFacetCommandOutput = UpdateFacetResponse & __MetadataBearer; +/** + *

Does the following:

+ *
    + *
  1. + *

    Adds new Attributes, Rules, or ObjectTypes.

    + *
  2. + *
  3. + *

    Updates existing Attributes, Rules, or ObjectTypes.

    + *
  4. + *
  5. + *

    Deletes existing Attributes, Rules, or ObjectTypes.

    + *
  6. + *
+ */ export class UpdateFacetCommand extends $Command< UpdateFacetCommandInput, UpdateFacetCommandOutput, @@ -34,6 +48,9 @@ export class UpdateFacetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/UpdateLinkAttributesCommand.ts b/clients/client-clouddirectory/commands/UpdateLinkAttributesCommand.ts index a81f508d05503..b13b1f9ffc4ff 100644 --- a/clients/client-clouddirectory/commands/UpdateLinkAttributesCommand.ts +++ b/clients/client-clouddirectory/commands/UpdateLinkAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateLinkAttributesCommandInput = UpdateLinkAttributesRequest; export type UpdateLinkAttributesCommandOutput = UpdateLinkAttributesResponse & __MetadataBearer; +/** + *

Updates a given typed link’s attributes. Attributes to be updated must not contribute to the typed link’s identity, as defined by its IdentityAttributeOrder.

+ */ export class UpdateLinkAttributesCommand extends $Command< UpdateLinkAttributesCommandInput, UpdateLinkAttributesCommandOutput, @@ -34,6 +37,9 @@ export class UpdateLinkAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/UpdateObjectAttributesCommand.ts b/clients/client-clouddirectory/commands/UpdateObjectAttributesCommand.ts index fb7974a4ac3da..3c7e2b5666009 100644 --- a/clients/client-clouddirectory/commands/UpdateObjectAttributesCommand.ts +++ b/clients/client-clouddirectory/commands/UpdateObjectAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateObjectAttributesCommandInput = UpdateObjectAttributesRequest; export type UpdateObjectAttributesCommandOutput = UpdateObjectAttributesResponse & __MetadataBearer; +/** + *

Updates a given object's attributes.

+ */ export class UpdateObjectAttributesCommand extends $Command< UpdateObjectAttributesCommandInput, UpdateObjectAttributesCommandOutput, @@ -34,6 +37,9 @@ export class UpdateObjectAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/UpdateSchemaCommand.ts b/clients/client-clouddirectory/commands/UpdateSchemaCommand.ts index 922963b24a760..8e0fe2d9dd586 100644 --- a/clients/client-clouddirectory/commands/UpdateSchemaCommand.ts +++ b/clients/client-clouddirectory/commands/UpdateSchemaCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateSchemaCommandInput = UpdateSchemaRequest; export type UpdateSchemaCommandOutput = UpdateSchemaResponse & __MetadataBearer; +/** + *

Updates the schema name with a new name. Only development schema names can be + * updated.

+ */ export class UpdateSchemaCommand extends $Command< UpdateSchemaCommandInput, UpdateSchemaCommandOutput, @@ -34,6 +38,9 @@ export class UpdateSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/UpdateTypedLinkFacetCommand.ts b/clients/client-clouddirectory/commands/UpdateTypedLinkFacetCommand.ts index d7a76a46e602c..ffa042ce0e79d 100644 --- a/clients/client-clouddirectory/commands/UpdateTypedLinkFacetCommand.ts +++ b/clients/client-clouddirectory/commands/UpdateTypedLinkFacetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTypedLinkFacetCommandInput = UpdateTypedLinkFacetRequest; export type UpdateTypedLinkFacetCommandOutput = UpdateTypedLinkFacetResponse & __MetadataBearer; +/** + *

Updates a TypedLinkFacet. For more information, see Typed Links.

+ */ export class UpdateTypedLinkFacetCommand extends $Command< UpdateTypedLinkFacetCommandInput, UpdateTypedLinkFacetCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTypedLinkFacetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/UpgradeAppliedSchemaCommand.ts b/clients/client-clouddirectory/commands/UpgradeAppliedSchemaCommand.ts index 0c8993dd63862..c679cd64a9aa9 100644 --- a/clients/client-clouddirectory/commands/UpgradeAppliedSchemaCommand.ts +++ b/clients/client-clouddirectory/commands/UpgradeAppliedSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type UpgradeAppliedSchemaCommandInput = UpgradeAppliedSchemaRequest; export type UpgradeAppliedSchemaCommandOutput = UpgradeAppliedSchemaResponse & __MetadataBearer; +/** + *

Upgrades a single directory in-place using the PublishedSchemaArn with schema updates found in MinorVersion. Backwards-compatible minor version upgrades are instantaneously available for readers on all objects in the directory. Note: This is a synchronous API call and upgrades only one schema on a given directory per call. To upgrade multiple directories from one schema, you would need to call this API on each directory.

+ */ export class UpgradeAppliedSchemaCommand extends $Command< UpgradeAppliedSchemaCommandInput, UpgradeAppliedSchemaCommandOutput, @@ -34,6 +37,9 @@ export class UpgradeAppliedSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/commands/UpgradePublishedSchemaCommand.ts b/clients/client-clouddirectory/commands/UpgradePublishedSchemaCommand.ts index 1f9f5d712c39d..a38ce9f91ecae 100644 --- a/clients/client-clouddirectory/commands/UpgradePublishedSchemaCommand.ts +++ b/clients/client-clouddirectory/commands/UpgradePublishedSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type UpgradePublishedSchemaCommandInput = UpgradePublishedSchemaRequest; export type UpgradePublishedSchemaCommandOutput = UpgradePublishedSchemaResponse & __MetadataBearer; +/** + *

Upgrades a published schema under a new minor version revision using the current contents of DevelopmentSchemaArn.

+ */ export class UpgradePublishedSchemaCommand extends $Command< UpgradePublishedSchemaCommandInput, UpgradePublishedSchemaCommandOutput, @@ -34,6 +37,9 @@ export class UpgradePublishedSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudDirectoryClientResolvedConfig, diff --git a/clients/client-clouddirectory/package.json b/clients/client-clouddirectory/package.json index f65b51c0ab354..d70fb2a43e5e2 100644 --- a/clients/client-clouddirectory/package.json +++ b/clients/client-clouddirectory/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Clouddirectory Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-clouddirectory/pagination/ListAppliedSchemaArnsPaginator.ts b/clients/client-clouddirectory/pagination/ListAppliedSchemaArnsPaginator.ts index f1c0cb549f3fa..86984c2b64ca6 100644 --- a/clients/client-clouddirectory/pagination/ListAppliedSchemaArnsPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListAppliedSchemaArnsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListAppliedSchemaArnsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAppliedSchemaArnsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListAppliedSchemaArnsCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListAttachedIndicesPaginator.ts b/clients/client-clouddirectory/pagination/ListAttachedIndicesPaginator.ts index 2473c16e663c9..0f828710078fc 100644 --- a/clients/client-clouddirectory/pagination/ListAttachedIndicesPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListAttachedIndicesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListAttachedIndicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttachedIndicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListAttachedIndicesCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListDevelopmentSchemaArnsPaginator.ts b/clients/client-clouddirectory/pagination/ListDevelopmentSchemaArnsPaginator.ts index c4bc939c530ab..b38b1fac3259c 100644 --- a/clients/client-clouddirectory/pagination/ListDevelopmentSchemaArnsPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListDevelopmentSchemaArnsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListDevelopmentSchemaArnsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDevelopmentSchemaArnsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListDevelopmentSchemaArnsCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListDirectoriesPaginator.ts b/clients/client-clouddirectory/pagination/ListDirectoriesPaginator.ts index bc1f6fba2d839..da12534819d26 100644 --- a/clients/client-clouddirectory/pagination/ListDirectoriesPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListDirectoriesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListDirectoriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDirectoriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListDirectoriesCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListFacetAttributesPaginator.ts b/clients/client-clouddirectory/pagination/ListFacetAttributesPaginator.ts index 79b7cd1d2888c..dea19f392e79a 100644 --- a/clients/client-clouddirectory/pagination/ListFacetAttributesPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListFacetAttributesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListFacetAttributesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFacetAttributesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListFacetAttributesCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListFacetNamesPaginator.ts b/clients/client-clouddirectory/pagination/ListFacetNamesPaginator.ts index 51d33b1c5bf6d..2f7390168c2a6 100644 --- a/clients/client-clouddirectory/pagination/ListFacetNamesPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListFacetNamesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListFacetNamesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFacetNamesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListFacetNamesCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListIndexPaginator.ts b/clients/client-clouddirectory/pagination/ListIndexPaginator.ts index 4815844bd80d5..3ba7bbf8d969f 100644 --- a/clients/client-clouddirectory/pagination/ListIndexPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListIndexPaginator.ts @@ -4,6 +4,9 @@ import { ListIndexCommand, ListIndexCommandInput, ListIndexCommandOutput } from import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListIndexCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListIndexCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListIndexCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListManagedSchemaArnsPaginator.ts b/clients/client-clouddirectory/pagination/ListManagedSchemaArnsPaginator.ts index 2749da009de90..e769346aea80b 100644 --- a/clients/client-clouddirectory/pagination/ListManagedSchemaArnsPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListManagedSchemaArnsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListManagedSchemaArnsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListManagedSchemaArnsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListManagedSchemaArnsCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListObjectAttributesPaginator.ts b/clients/client-clouddirectory/pagination/ListObjectAttributesPaginator.ts index ffa97a9ae2098..1e3f8b6172092 100644 --- a/clients/client-clouddirectory/pagination/ListObjectAttributesPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListObjectAttributesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListObjectAttributesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListObjectAttributesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListObjectAttributesCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListObjectChildrenPaginator.ts b/clients/client-clouddirectory/pagination/ListObjectChildrenPaginator.ts index 1a0d51473e7eb..5c176e03b385f 100644 --- a/clients/client-clouddirectory/pagination/ListObjectChildrenPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListObjectChildrenPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListObjectChildrenCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListObjectChildrenCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListObjectChildrenCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListObjectParentPathsPaginator.ts b/clients/client-clouddirectory/pagination/ListObjectParentPathsPaginator.ts index 80bad2d3e482f..82cdfdd2d8883 100644 --- a/clients/client-clouddirectory/pagination/ListObjectParentPathsPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListObjectParentPathsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListObjectParentPathsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListObjectParentPathsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListObjectParentPathsCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListObjectParentsPaginator.ts b/clients/client-clouddirectory/pagination/ListObjectParentsPaginator.ts index 36331ded152da..a762c5778452a 100644 --- a/clients/client-clouddirectory/pagination/ListObjectParentsPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListObjectParentsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListObjectParentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListObjectParentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListObjectParentsCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListObjectPoliciesPaginator.ts b/clients/client-clouddirectory/pagination/ListObjectPoliciesPaginator.ts index 1170f205ba389..3e3b487fe5204 100644 --- a/clients/client-clouddirectory/pagination/ListObjectPoliciesPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListObjectPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListObjectPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListObjectPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListObjectPoliciesCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListPolicyAttachmentsPaginator.ts b/clients/client-clouddirectory/pagination/ListPolicyAttachmentsPaginator.ts index 890a4d3cbfbe7..fbcccc19d1e92 100644 --- a/clients/client-clouddirectory/pagination/ListPolicyAttachmentsPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListPolicyAttachmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListPolicyAttachmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPolicyAttachmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListPolicyAttachmentsCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListPublishedSchemaArnsPaginator.ts b/clients/client-clouddirectory/pagination/ListPublishedSchemaArnsPaginator.ts index 8d9aac919c88b..c09006934e102 100644 --- a/clients/client-clouddirectory/pagination/ListPublishedSchemaArnsPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListPublishedSchemaArnsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListPublishedSchemaArnsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPublishedSchemaArnsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListPublishedSchemaArnsCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListTagsForResourcePaginator.ts b/clients/client-clouddirectory/pagination/ListTagsForResourcePaginator.ts index 45f82f2b3905a..15126ccffed9a 100644 --- a/clients/client-clouddirectory/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-clouddirectory/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListTagsForResourceCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListTypedLinkFacetAttributesPaginator.ts b/clients/client-clouddirectory/pagination/ListTypedLinkFacetAttributesPaginator.ts index 57e99ab8f5398..851018cc4a0ee 100644 --- a/clients/client-clouddirectory/pagination/ListTypedLinkFacetAttributesPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListTypedLinkFacetAttributesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListTypedLinkFacetAttributesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTypedLinkFacetAttributesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListTypedLinkFacetAttributesCommandInput, diff --git a/clients/client-clouddirectory/pagination/ListTypedLinkFacetNamesPaginator.ts b/clients/client-clouddirectory/pagination/ListTypedLinkFacetNamesPaginator.ts index b637b5cccce12..4580b7a936454 100644 --- a/clients/client-clouddirectory/pagination/ListTypedLinkFacetNamesPaginator.ts +++ b/clients/client-clouddirectory/pagination/ListTypedLinkFacetNamesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: ListTypedLinkFacetNamesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTypedLinkFacetNamesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: ListTypedLinkFacetNamesCommandInput, diff --git a/clients/client-clouddirectory/pagination/LookupPolicyPaginator.ts b/clients/client-clouddirectory/pagination/LookupPolicyPaginator.ts index 9d678b79b10a8..230bd0017159a 100644 --- a/clients/client-clouddirectory/pagination/LookupPolicyPaginator.ts +++ b/clients/client-clouddirectory/pagination/LookupPolicyPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudDirectoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudDirectoryClient, input: LookupPolicyCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new LookupPolicyCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudDirectory, input: LookupPolicyCommandInput, diff --git a/clients/client-clouddirectory/runtimeConfig.browser.ts b/clients/client-clouddirectory/runtimeConfig.browser.ts index 4d1ec20271b12..b242a7ee14138 100644 --- a/clients/client-clouddirectory/runtimeConfig.browser.ts +++ b/clients/client-clouddirectory/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudDirectoryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-clouddirectory/runtimeConfig.native.ts b/clients/client-clouddirectory/runtimeConfig.native.ts index 8507be24128f9..d581d4dbda97a 100644 --- a/clients/client-clouddirectory/runtimeConfig.native.ts +++ b/clients/client-clouddirectory/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudDirectoryClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-clouddirectory/runtimeConfig.shared.ts b/clients/client-clouddirectory/runtimeConfig.shared.ts index 78f2ba7bd26b4..b9c81701b6874 100644 --- a/clients/client-clouddirectory/runtimeConfig.shared.ts +++ b/clients/client-clouddirectory/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-01-11", disableHostPrefix: false, diff --git a/clients/client-clouddirectory/runtimeConfig.ts b/clients/client-clouddirectory/runtimeConfig.ts index 417db808bf384..165c823c950f1 100644 --- a/clients/client-clouddirectory/runtimeConfig.ts +++ b/clients/client-clouddirectory/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudDirectoryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-clouddirectory/tsconfig.json b/clients/client-clouddirectory/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-clouddirectory/tsconfig.json +++ b/clients/client-clouddirectory/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudformation/commands/CancelUpdateStackCommand.ts b/clients/client-cloudformation/commands/CancelUpdateStackCommand.ts index 5b27ac9a0af87..d38587125691d 100644 --- a/clients/client-cloudformation/commands/CancelUpdateStackCommand.ts +++ b/clients/client-cloudformation/commands/CancelUpdateStackCommand.ts @@ -20,6 +20,13 @@ import { export type CancelUpdateStackCommandInput = CancelUpdateStackInput; export type CancelUpdateStackCommandOutput = __MetadataBearer; +/** + *

Cancels an update on the specified stack. If the call completes successfully, the + * stack rolls back the update and reverts to the previous stack configuration.

+ * + *

You can cancel only stacks that are in the UPDATE_IN_PROGRESS state.

+ *
+ */ export class CancelUpdateStackCommand extends $Command< CancelUpdateStackCommandInput, CancelUpdateStackCommandOutput, @@ -34,6 +41,9 @@ export class CancelUpdateStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ContinueUpdateRollbackCommand.ts b/clients/client-cloudformation/commands/ContinueUpdateRollbackCommand.ts index f8e74a17208a2..b1cf025b1bd22 100644 --- a/clients/client-cloudformation/commands/ContinueUpdateRollbackCommand.ts +++ b/clients/client-cloudformation/commands/ContinueUpdateRollbackCommand.ts @@ -20,6 +20,19 @@ import { export type ContinueUpdateRollbackCommandInput = ContinueUpdateRollbackInput; export type ContinueUpdateRollbackCommandOutput = ContinueUpdateRollbackOutput & __MetadataBearer; +/** + *

For a specified stack that is in the UPDATE_ROLLBACK_FAILED state, + * continues rolling it back to the UPDATE_ROLLBACK_COMPLETE state. Depending on + * the cause of the failure, you can manually fix the error and continue the rollback. By continuing the rollback, you can + * return your stack to a working state (the UPDATE_ROLLBACK_COMPLETE state), and + * then try to update the stack again.

+ *

A stack goes into the UPDATE_ROLLBACK_FAILED state when AWS + * CloudFormation cannot roll back all changes after a failed stack update. For example, you + * might have a stack that is rolling back to an old database instance that was deleted + * outside of AWS CloudFormation. Because AWS CloudFormation doesn't know the database was + * deleted, it assumes that the database instance still exists and attempts to roll back to + * it, causing the update rollback to fail.

+ */ export class ContinueUpdateRollbackCommand extends $Command< ContinueUpdateRollbackCommandInput, ContinueUpdateRollbackCommandOutput, @@ -34,6 +47,9 @@ export class ContinueUpdateRollbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/CreateChangeSetCommand.ts b/clients/client-cloudformation/commands/CreateChangeSetCommand.ts index af7a813ec661f..bc876b9a04eee 100644 --- a/clients/client-cloudformation/commands/CreateChangeSetCommand.ts +++ b/clients/client-cloudformation/commands/CreateChangeSetCommand.ts @@ -20,6 +20,29 @@ import { export type CreateChangeSetCommandInput = CreateChangeSetInput; export type CreateChangeSetCommandOutput = CreateChangeSetOutput & __MetadataBearer; +/** + *

Creates a list of changes that will be applied to a stack so that you can review the + * changes before executing them. You can create a change set for a stack that doesn't exist + * or an existing stack. If you create a change set for a stack that doesn't exist, the change + * set shows all of the resources that AWS CloudFormation will create. If you create a change + * set for an existing stack, AWS CloudFormation compares the stack's information with the + * information that you submit in the change set and lists the differences. Use change sets to + * understand which resources AWS CloudFormation will create or change, and how it will change + * resources in an existing stack, before you create or update a stack.

+ *

To create a change set for a stack that doesn't exist, for the + * ChangeSetType parameter, specify CREATE. To create a change + * set for an existing stack, specify UPDATE for the ChangeSetType + * parameter. To create a change set for an import operation, specify IMPORT for + * the ChangeSetType parameter. After the CreateChangeSet call + * successfully completes, AWS CloudFormation starts creating the change set. To check the + * status of the change set or to review it, use the DescribeChangeSet + * action.

+ *

When you are satisfied with the changes the change set will make, execute the change + * set by using the ExecuteChangeSet action. AWS CloudFormation doesn't make + * changes until you execute the change set.

+ *

To create a change set for the entire stack hierachy, set + * IncludeNestedStacks to True.

+ */ export class CreateChangeSetCommand extends $Command< CreateChangeSetCommandInput, CreateChangeSetCommandOutput, @@ -34,6 +57,9 @@ export class CreateChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/CreateStackCommand.ts b/clients/client-cloudformation/commands/CreateStackCommand.ts index 5cfa2b297525f..41d1860ca709b 100644 --- a/clients/client-cloudformation/commands/CreateStackCommand.ts +++ b/clients/client-cloudformation/commands/CreateStackCommand.ts @@ -17,6 +17,10 @@ import { export type CreateStackCommandInput = CreateStackInput; export type CreateStackCommandOutput = CreateStackOutput & __MetadataBearer; +/** + *

Creates a stack as specified in the template. After the call completes successfully, + * the stack creation starts. You can check the status of the stack via the DescribeStacks API.

+ */ export class CreateStackCommand extends $Command< CreateStackCommandInput, CreateStackCommandOutput, @@ -31,6 +35,9 @@ export class CreateStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/CreateStackInstancesCommand.ts b/clients/client-cloudformation/commands/CreateStackInstancesCommand.ts index ecc6c9e230bf4..c2688b306e902 100644 --- a/clients/client-cloudformation/commands/CreateStackInstancesCommand.ts +++ b/clients/client-cloudformation/commands/CreateStackInstancesCommand.ts @@ -20,6 +20,10 @@ import { export type CreateStackInstancesCommandInput = CreateStackInstancesInput; export type CreateStackInstancesCommandOutput = CreateStackInstancesOutput & __MetadataBearer; +/** + *

Creates stack instances for the specified accounts, within the specified Regions. A + * stack instance refers to a stack in a specific account and Region. You must specify at least one value for either Accounts or DeploymentTargets, and you must specify at least one value for Regions.

+ */ export class CreateStackInstancesCommand extends $Command< CreateStackInstancesCommandInput, CreateStackInstancesCommandOutput, @@ -34,6 +38,9 @@ export class CreateStackInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/CreateStackSetCommand.ts b/clients/client-cloudformation/commands/CreateStackSetCommand.ts index 38d959611d350..776d53931e393 100644 --- a/clients/client-cloudformation/commands/CreateStackSetCommand.ts +++ b/clients/client-cloudformation/commands/CreateStackSetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateStackSetCommandInput = CreateStackSetInput; export type CreateStackSetCommandOutput = CreateStackSetOutput & __MetadataBearer; +/** + *

Creates a stack set.

+ */ export class CreateStackSetCommand extends $Command< CreateStackSetCommandInput, CreateStackSetCommandOutput, @@ -34,6 +37,9 @@ export class CreateStackSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DeleteChangeSetCommand.ts b/clients/client-cloudformation/commands/DeleteChangeSetCommand.ts index c4b6fbdec2020..a1a18558f77db 100644 --- a/clients/client-cloudformation/commands/DeleteChangeSetCommand.ts +++ b/clients/client-cloudformation/commands/DeleteChangeSetCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteChangeSetCommandInput = DeleteChangeSetInput; export type DeleteChangeSetCommandOutput = DeleteChangeSetOutput & __MetadataBearer; +/** + *

Deletes the specified change set. Deleting change sets ensures that no one executes + * the wrong change set.

+ *

If the call successfully completes, AWS CloudFormation successfully deleted the + * change set.

+ *

If IncludeNestedStacks specifies True during the creation of + * the nested change set, then DeleteChangeSet will delete all change sets that belong to the stacks hierarchy and + * will also delete all change sets for nested stacks with the status of REVIEW_IN_PROGRESS.

+ */ export class DeleteChangeSetCommand extends $Command< DeleteChangeSetCommandInput, DeleteChangeSetCommandOutput, @@ -34,6 +43,9 @@ export class DeleteChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DeleteStackCommand.ts b/clients/client-cloudformation/commands/DeleteStackCommand.ts index 3d6454696d649..17c3451fa0cf3 100644 --- a/clients/client-cloudformation/commands/DeleteStackCommand.ts +++ b/clients/client-cloudformation/commands/DeleteStackCommand.ts @@ -17,6 +17,11 @@ import { export type DeleteStackCommandInput = DeleteStackInput; export type DeleteStackCommandOutput = __MetadataBearer; +/** + *

Deletes a specified stack. Once the call completes successfully, stack deletion + * starts. Deleted stacks do not show up in the DescribeStacks API if the + * deletion has been completed successfully.

+ */ export class DeleteStackCommand extends $Command< DeleteStackCommandInput, DeleteStackCommandOutput, @@ -31,6 +36,9 @@ export class DeleteStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DeleteStackInstancesCommand.ts b/clients/client-cloudformation/commands/DeleteStackInstancesCommand.ts index a7560a042fc20..e0c707d6338b3 100644 --- a/clients/client-cloudformation/commands/DeleteStackInstancesCommand.ts +++ b/clients/client-cloudformation/commands/DeleteStackInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteStackInstancesCommandInput = DeleteStackInstancesInput; export type DeleteStackInstancesCommandOutput = DeleteStackInstancesOutput & __MetadataBearer; +/** + *

Deletes stack instances for the specified accounts, in the specified Regions.

+ */ export class DeleteStackInstancesCommand extends $Command< DeleteStackInstancesCommandInput, DeleteStackInstancesCommandOutput, @@ -34,6 +37,9 @@ export class DeleteStackInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DeleteStackSetCommand.ts b/clients/client-cloudformation/commands/DeleteStackSetCommand.ts index 40586a82a774f..dcb024512a51b 100644 --- a/clients/client-cloudformation/commands/DeleteStackSetCommand.ts +++ b/clients/client-cloudformation/commands/DeleteStackSetCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteStackSetCommandInput = DeleteStackSetInput; export type DeleteStackSetCommandOutput = DeleteStackSetOutput & __MetadataBearer; +/** + *

Deletes a stack set. Before you can delete a stack set, all of its member stack + * instances must be deleted. For more information about how to do this, see DeleteStackInstances.

+ */ export class DeleteStackSetCommand extends $Command< DeleteStackSetCommandInput, DeleteStackSetCommandOutput, @@ -34,6 +38,9 @@ export class DeleteStackSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DeregisterTypeCommand.ts b/clients/client-cloudformation/commands/DeregisterTypeCommand.ts index e615c7fadd841..7d6a82d53f2cd 100644 --- a/clients/client-cloudformation/commands/DeregisterTypeCommand.ts +++ b/clients/client-cloudformation/commands/DeregisterTypeCommand.ts @@ -20,6 +20,11 @@ import { export type DeregisterTypeCommandInput = DeregisterTypeInput; export type DeregisterTypeCommandOutput = DeregisterTypeOutput & __MetadataBearer; +/** + *

Removes a type or type version from active use in the CloudFormation registry. If a type or type version is deregistered, it cannot be used in CloudFormation operations.

+ *

To deregister a type, you must individually deregister all registered versions of that type. If a type has only a single registered version, deregistering that version results in the type itself being deregistered.

+ *

You cannot deregister the default version of a type, unless it is the only registered version of that type, in which case the type itself is deregistered as well.

+ */ export class DeregisterTypeCommand extends $Command< DeregisterTypeCommandInput, DeregisterTypeCommandOutput, @@ -34,6 +39,9 @@ export class DeregisterTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeAccountLimitsCommand.ts b/clients/client-cloudformation/commands/DescribeAccountLimitsCommand.ts index 893cf2b853775..9b05ec40da0d3 100644 --- a/clients/client-cloudformation/commands/DescribeAccountLimitsCommand.ts +++ b/clients/client-cloudformation/commands/DescribeAccountLimitsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeAccountLimitsCommandInput = DescribeAccountLimitsInput; export type DescribeAccountLimitsCommandOutput = DescribeAccountLimitsOutput & __MetadataBearer; +/** + *

Retrieves your account's AWS CloudFormation limits, such as the maximum number of + * stacks that you can create in your account. For more information about account limits, see + * AWS CloudFormation + * Limits in the AWS CloudFormation User Guide.

+ */ export class DescribeAccountLimitsCommand extends $Command< DescribeAccountLimitsCommandInput, DescribeAccountLimitsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeAccountLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeChangeSetCommand.ts b/clients/client-cloudformation/commands/DescribeChangeSetCommand.ts index a7587c8fcab4d..5996a9394026d 100644 --- a/clients/client-cloudformation/commands/DescribeChangeSetCommand.ts +++ b/clients/client-cloudformation/commands/DescribeChangeSetCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeChangeSetCommandInput = DescribeChangeSetInput; export type DescribeChangeSetCommandOutput = DescribeChangeSetOutput & __MetadataBearer; +/** + *

Returns the inputs for the change set and a list of changes that AWS CloudFormation + * will make if you execute the change set. For more information, see Updating Stacks Using Change Sets in the AWS CloudFormation User + * Guide.

+ */ export class DescribeChangeSetCommand extends $Command< DescribeChangeSetCommandInput, DescribeChangeSetCommandOutput, @@ -34,6 +39,9 @@ export class DescribeChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStackDriftDetectionStatusCommand.ts b/clients/client-cloudformation/commands/DescribeStackDriftDetectionStatusCommand.ts index ff82b6b36c4e8..505d070367335 100644 --- a/clients/client-cloudformation/commands/DescribeStackDriftDetectionStatusCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStackDriftDetectionStatusCommand.ts @@ -20,6 +20,21 @@ import { export type DescribeStackDriftDetectionStatusCommandInput = DescribeStackDriftDetectionStatusInput; export type DescribeStackDriftDetectionStatusCommandOutput = DescribeStackDriftDetectionStatusOutput & __MetadataBearer; +/** + *

Returns information about a stack drift detection operation. A stack drift detection + * operation detects whether a stack's actual configuration differs, or has + * drifted, from it's expected configuration, as defined in the stack + * template and any values specified as template parameters. A stack is considered to have + * drifted if one or more of its resources have drifted. For more information on stack and + * resource drift, see Detecting + * Unregulated Configuration Changes to Stacks and Resources.

+ *

Use DetectStackDrift to initiate a stack drift detection operation. + * DetectStackDrift returns a StackDriftDetectionId you can use + * to monitor the progress of the operation using + * DescribeStackDriftDetectionStatus. Once the drift detection operation has + * completed, use DescribeStackResourceDrifts to return drift information + * about the stack and its resources.

+ */ export class DescribeStackDriftDetectionStatusCommand extends $Command< DescribeStackDriftDetectionStatusCommandInput, DescribeStackDriftDetectionStatusCommandOutput, @@ -34,6 +49,9 @@ export class DescribeStackDriftDetectionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStackEventsCommand.ts b/clients/client-cloudformation/commands/DescribeStackEventsCommand.ts index b47ab9f070557..9622bd74e6765 100644 --- a/clients/client-cloudformation/commands/DescribeStackEventsCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStackEventsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeStackEventsCommandInput = DescribeStackEventsInput; export type DescribeStackEventsCommandOutput = DescribeStackEventsOutput & __MetadataBearer; +/** + *

Returns all stack related events for a specified stack in reverse chronological + * order. For more information about a stack's event history, go to Stacks in the AWS CloudFormation User Guide.

+ * + *

You can list events for stacks that have failed to create or have been deleted by + * specifying the unique stack identifier (stack ID).

+ *
+ */ export class DescribeStackEventsCommand extends $Command< DescribeStackEventsCommandInput, DescribeStackEventsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeStackEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStackInstanceCommand.ts b/clients/client-cloudformation/commands/DescribeStackInstanceCommand.ts index 25656b960c36e..fc375242da856 100644 --- a/clients/client-cloudformation/commands/DescribeStackInstanceCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStackInstanceCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeStackInstanceCommandInput = DescribeStackInstanceInput; export type DescribeStackInstanceCommandOutput = DescribeStackInstanceOutput & __MetadataBearer; +/** + *

Returns the stack instance that's associated with the specified stack set, AWS + * account, and Region.

+ *

For a list of stack instances that are associated with a specific stack set, use + * ListStackInstances.

+ */ export class DescribeStackInstanceCommand extends $Command< DescribeStackInstanceCommandInput, DescribeStackInstanceCommandOutput, @@ -34,6 +40,9 @@ export class DescribeStackInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStackResourceCommand.ts b/clients/client-cloudformation/commands/DescribeStackResourceCommand.ts index 0a77043248f0d..e5a5cc3df34a6 100644 --- a/clients/client-cloudformation/commands/DescribeStackResourceCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStackResourceCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeStackResourceCommandInput = DescribeStackResourceInput; export type DescribeStackResourceCommandOutput = DescribeStackResourceOutput & __MetadataBearer; +/** + *

Returns a description of the specified resource in the specified stack.

+ *

For deleted stacks, DescribeStackResource returns resource information for up to 90 + * days after the stack has been deleted.

+ */ export class DescribeStackResourceCommand extends $Command< DescribeStackResourceCommandInput, DescribeStackResourceCommandOutput, @@ -34,6 +39,9 @@ export class DescribeStackResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStackResourceDriftsCommand.ts b/clients/client-cloudformation/commands/DescribeStackResourceDriftsCommand.ts index fa68e5dd90f03..b583f31df55d0 100644 --- a/clients/client-cloudformation/commands/DescribeStackResourceDriftsCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStackResourceDriftsCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeStackResourceDriftsCommandInput = DescribeStackResourceDriftsInput; export type DescribeStackResourceDriftsCommandOutput = DescribeStackResourceDriftsOutput & __MetadataBearer; +/** + *

Returns drift information for the resources that have been checked for drift in the + * specified stack. This includes actual and expected configuration values for resources where + * AWS CloudFormation detects configuration drift.

+ *

For a given stack, there will be one StackResourceDrift for each stack + * resource that has been checked for drift. Resources that have not yet been checked for + * drift are not included. Resources that do not currently support drift detection are not + * checked, and so not included. For a list of resources that support drift detection, see + * Resources that Support Drift Detection.

+ *

Use DetectStackResourceDrift to detect drift on individual + * resources, or DetectStackDrift to detect drift on all supported resources + * for a given stack.

+ */ export class DescribeStackResourceDriftsCommand extends $Command< DescribeStackResourceDriftsCommandInput, DescribeStackResourceDriftsCommandOutput, @@ -34,6 +47,9 @@ export class DescribeStackResourceDriftsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStackResourcesCommand.ts b/clients/client-cloudformation/commands/DescribeStackResourcesCommand.ts index 7081c4eb83bc9..4abee2c43627c 100644 --- a/clients/client-cloudformation/commands/DescribeStackResourcesCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStackResourcesCommand.ts @@ -20,6 +20,28 @@ import { export type DescribeStackResourcesCommandInput = DescribeStackResourcesInput; export type DescribeStackResourcesCommandOutput = DescribeStackResourcesOutput & __MetadataBearer; +/** + *

Returns AWS resource descriptions for running and deleted stacks. If + * StackName is specified, all the associated resources that are part of the + * stack are returned. If PhysicalResourceId is specified, the associated + * resources of the stack that the resource belongs to are returned.

+ * + *

Only the first 100 resources will be returned. If your stack has more resources + * than this, you should use ListStackResources instead.

+ *
+ *

For deleted stacks, DescribeStackResources returns resource information + * for up to 90 days after the stack has been deleted.

+ *

You must specify either StackName or PhysicalResourceId, + * but not both. In addition, you can specify LogicalResourceId to filter the + * returned result. For more information about resources, the LogicalResourceId + * and PhysicalResourceId, go to the AWS CloudFormation User + * Guide.

+ * + *

A ValidationError is returned if you specify both + * StackName and PhysicalResourceId in the same + * request.

+ *
+ */ export class DescribeStackResourcesCommand extends $Command< DescribeStackResourcesCommandInput, DescribeStackResourcesCommandOutput, @@ -34,6 +56,9 @@ export class DescribeStackResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStackSetCommand.ts b/clients/client-cloudformation/commands/DescribeStackSetCommand.ts index f239a9051f6a1..b6e2826af80be 100644 --- a/clients/client-cloudformation/commands/DescribeStackSetCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStackSetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeStackSetCommandInput = DescribeStackSetInput; export type DescribeStackSetCommandOutput = DescribeStackSetOutput & __MetadataBearer; +/** + *

Returns the description of the specified stack set.

+ */ export class DescribeStackSetCommand extends $Command< DescribeStackSetCommandInput, DescribeStackSetCommandOutput, @@ -34,6 +37,9 @@ export class DescribeStackSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStackSetOperationCommand.ts b/clients/client-cloudformation/commands/DescribeStackSetOperationCommand.ts index 2348b1464f801..b87d9badc4ad5 100644 --- a/clients/client-cloudformation/commands/DescribeStackSetOperationCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStackSetOperationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeStackSetOperationCommandInput = DescribeStackSetOperationInput; export type DescribeStackSetOperationCommandOutput = DescribeStackSetOperationOutput & __MetadataBearer; +/** + *

Returns the description of the specified stack set operation.

+ */ export class DescribeStackSetOperationCommand extends $Command< DescribeStackSetOperationCommandInput, DescribeStackSetOperationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeStackSetOperationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeStacksCommand.ts b/clients/client-cloudformation/commands/DescribeStacksCommand.ts index 7cb7c0a86964c..f33c7234c6a54 100644 --- a/clients/client-cloudformation/commands/DescribeStacksCommand.ts +++ b/clients/client-cloudformation/commands/DescribeStacksCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeStacksCommandInput = DescribeStacksInput; export type DescribeStacksCommandOutput = DescribeStacksOutput & __MetadataBearer; +/** + *

Returns the description for the specified stack; if no stack name was specified, then + * it returns the description for all the stacks created.

+ * + *

If the stack does not exist, an AmazonCloudFormationException is + * returned.

+ *
+ */ export class DescribeStacksCommand extends $Command< DescribeStacksCommandInput, DescribeStacksCommandOutput, @@ -34,6 +42,9 @@ export class DescribeStacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeTypeCommand.ts b/clients/client-cloudformation/commands/DescribeTypeCommand.ts index 385657cdc2051..6535f971a4318 100644 --- a/clients/client-cloudformation/commands/DescribeTypeCommand.ts +++ b/clients/client-cloudformation/commands/DescribeTypeCommand.ts @@ -17,6 +17,10 @@ import { export type DescribeTypeCommandInput = DescribeTypeInput; export type DescribeTypeCommandOutput = DescribeTypeOutput & __MetadataBearer; +/** + *

Returns detailed information about a type that has been registered.

+ *

If you specify a VersionId, DescribeType returns information about that specific type version. Otherwise, it returns information about the default type version.

+ */ export class DescribeTypeCommand extends $Command< DescribeTypeCommandInput, DescribeTypeCommandOutput, @@ -31,6 +35,9 @@ export class DescribeTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DescribeTypeRegistrationCommand.ts b/clients/client-cloudformation/commands/DescribeTypeRegistrationCommand.ts index 3a4a378760072..f3c4ef41c046f 100644 --- a/clients/client-cloudformation/commands/DescribeTypeRegistrationCommand.ts +++ b/clients/client-cloudformation/commands/DescribeTypeRegistrationCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeTypeRegistrationCommandInput = DescribeTypeRegistrationInput; export type DescribeTypeRegistrationCommandOutput = DescribeTypeRegistrationOutput & __MetadataBearer; +/** + *

Returns information about a type's registration, including its current status and type and version identifiers.

+ *

When you initiate a registration request using + * RegisterType + * , you can then use + * DescribeTypeRegistration + * to monitor the progress of that registration request.

+ *

Once the registration request has completed, use + * DescribeType + * to return detailed informaiton about a type.

+ */ export class DescribeTypeRegistrationCommand extends $Command< DescribeTypeRegistrationCommandInput, DescribeTypeRegistrationCommandOutput, @@ -34,6 +45,9 @@ export class DescribeTypeRegistrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DetectStackDriftCommand.ts b/clients/client-cloudformation/commands/DetectStackDriftCommand.ts index 49097751c793f..3950556b36aa4 100644 --- a/clients/client-cloudformation/commands/DetectStackDriftCommand.ts +++ b/clients/client-cloudformation/commands/DetectStackDriftCommand.ts @@ -20,6 +20,29 @@ import { export type DetectStackDriftCommandInput = DetectStackDriftInput; export type DetectStackDriftCommandOutput = DetectStackDriftOutput & __MetadataBearer; +/** + *

Detects whether a stack's actual configuration differs, or has + * drifted, from it's expected configuration, as defined in the stack + * template and any values specified as template parameters. For each resource in the stack + * that supports drift detection, AWS CloudFormation compares the actual configuration of the resource with + * its expected template configuration. Only resource properties explicitly defined in the + * stack template are checked for drift. A stack is considered to have drifted if one or more + * of its resources differ from their expected template configurations. For more information, + * see Detecting + * Unregulated Configuration Changes to Stacks and Resources.

+ *

Use DetectStackDrift to detect drift on all supported resources for a + * given stack, or DetectStackResourceDrift to detect drift on individual + * resources.

+ *

For a list of stack resources that currently support drift detection, see Resources that Support Drift Detection.

+ *

+ * DetectStackDrift can take up to several minutes, depending on the number + * of resources contained within the stack. Use DescribeStackDriftDetectionStatus to monitor the progress of a detect stack + * drift operation. Once the drift detection operation has completed, use DescribeStackResourceDrifts to return drift information about the stack and + * its resources.

+ *

When detecting drift on a stack, AWS CloudFormation does not detect drift on any nested stacks + * belonging to that stack. Perform DetectStackDrift directly on the nested stack + * itself.

+ */ export class DetectStackDriftCommand extends $Command< DetectStackDriftCommandInput, DetectStackDriftCommandOutput, @@ -34,6 +57,9 @@ export class DetectStackDriftCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DetectStackResourceDriftCommand.ts b/clients/client-cloudformation/commands/DetectStackResourceDriftCommand.ts index 8c9641d0ad41a..1810273a67f28 100644 --- a/clients/client-cloudformation/commands/DetectStackResourceDriftCommand.ts +++ b/clients/client-cloudformation/commands/DetectStackResourceDriftCommand.ts @@ -20,6 +20,20 @@ import { export type DetectStackResourceDriftCommandInput = DetectStackResourceDriftInput; export type DetectStackResourceDriftCommandOutput = DetectStackResourceDriftOutput & __MetadataBearer; +/** + *

Returns information about whether a resource's actual configuration differs, or has + * drifted, from it's expected configuration, as defined in the stack + * template and any values specified as template parameters. This information includes actual + * and expected property values for resources in which AWS CloudFormation detects drift. Only resource + * properties explicitly defined in the stack template are checked for drift. For more + * information about stack and resource drift, see Detecting + * Unregulated Configuration Changes to Stacks and Resources.

+ *

Use DetectStackResourceDrift to detect drift on individual resources, or + * DetectStackDrift to detect drift on all resources in a given stack + * that support drift detection.

+ *

Resources that do not currently support drift detection cannot be checked. For a list + * of resources that support drift detection, see Resources that Support Drift Detection.

+ */ export class DetectStackResourceDriftCommand extends $Command< DetectStackResourceDriftCommandInput, DetectStackResourceDriftCommandOutput, @@ -34,6 +48,9 @@ export class DetectStackResourceDriftCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/DetectStackSetDriftCommand.ts b/clients/client-cloudformation/commands/DetectStackSetDriftCommand.ts index 510d6cfe09cb4..862fd13613be5 100644 --- a/clients/client-cloudformation/commands/DetectStackSetDriftCommand.ts +++ b/clients/client-cloudformation/commands/DetectStackSetDriftCommand.ts @@ -20,6 +20,53 @@ import { export type DetectStackSetDriftCommandInput = DetectStackSetDriftInput; export type DetectStackSetDriftCommandOutput = DetectStackSetDriftOutput & __MetadataBearer; +/** + *

Detect drift on a stack set. When CloudFormation performs drift detection on a stack + * set, it performs drift detection on the stack associated with each stack instance in the + * stack set. For more information, see How CloudFormation + * Performs Drift Detection on a Stack Set.

+ *

+ * DetectStackSetDrift returns the OperationId of the stack set + * drift detection operation. Use this operation id with + * DescribeStackSetOperation + * to monitor the progress of the drift + * detection operation. The drift detection operation may take some time, depending on the + * number of stack instances included in the stack set, as well as the number of resources + * included in each stack.

+ *

Once the operation has completed, use the following actions to return drift + * information:

+ *
    + *
  • + *

    Use + * DescribeStackSet + * to return detailed informaiton + * about the stack set, including detailed information about the last + * completed drift operation performed on the stack set. + * (Information about drift operations that are in progress is not included.)

    + *
  • + *
  • + *

    Use + * ListStackInstances + * to return a list of stack + * instances belonging to the stack set, including the drift status and last drift time + * checked of each instance.

    + *
  • + *
  • + *

    Use + * DescribeStackInstance + * to return detailed + * information about a specific stack instance, including its drift status and last + * drift time checked.

    + *
  • + *
+ *

For more information on performing a drift detection operation on a stack set, see + * Detecting Unmanaged + * Changes in Stack Sets.

+ *

You can only run a single drift detection operation on a given stack set at one time.

+ *

To stop a drift detection stack set operation, use + * StopStackSetOperation + * .

+ */ export class DetectStackSetDriftCommand extends $Command< DetectStackSetDriftCommandInput, DetectStackSetDriftCommandOutput, @@ -34,6 +81,9 @@ export class DetectStackSetDriftCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/EstimateTemplateCostCommand.ts b/clients/client-cloudformation/commands/EstimateTemplateCostCommand.ts index dbeeaf4aae5c3..a3c155d6fbd16 100644 --- a/clients/client-cloudformation/commands/EstimateTemplateCostCommand.ts +++ b/clients/client-cloudformation/commands/EstimateTemplateCostCommand.ts @@ -20,6 +20,11 @@ import { export type EstimateTemplateCostCommandInput = EstimateTemplateCostInput; export type EstimateTemplateCostCommandOutput = EstimateTemplateCostOutput & __MetadataBearer; +/** + *

Returns the estimated monthly cost of a template. The return value is an AWS Simple + * Monthly Calculator URL with a query string that describes the resources required to run the + * template.

+ */ export class EstimateTemplateCostCommand extends $Command< EstimateTemplateCostCommandInput, EstimateTemplateCostCommandOutput, @@ -34,6 +39,9 @@ export class EstimateTemplateCostCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ExecuteChangeSetCommand.ts b/clients/client-cloudformation/commands/ExecuteChangeSetCommand.ts index b46932d35e5b0..76f1aa05eb8ea 100644 --- a/clients/client-cloudformation/commands/ExecuteChangeSetCommand.ts +++ b/clients/client-cloudformation/commands/ExecuteChangeSetCommand.ts @@ -20,6 +20,19 @@ import { export type ExecuteChangeSetCommandInput = ExecuteChangeSetInput; export type ExecuteChangeSetCommandOutput = ExecuteChangeSetOutput & __MetadataBearer; +/** + *

Updates a stack using the input information that was provided when the specified + * change set was created. After the call successfully completes, AWS CloudFormation starts + * updating the stack. Use the DescribeStacks action to view the status of + * the update.

+ *

When you execute a change set, AWS CloudFormation deletes all other change sets + * associated with the stack because they aren't valid for the updated stack.

+ *

If a stack policy is associated with the stack, AWS CloudFormation enforces the + * policy during the update. You can't specify a temporary stack policy that overrides the + * current policy.

+ *

To create a change set for the entire stack hierachy, IncludeNestedStacks + * must have been set to True.

+ */ export class ExecuteChangeSetCommand extends $Command< ExecuteChangeSetCommandInput, ExecuteChangeSetCommandOutput, @@ -34,6 +47,9 @@ export class ExecuteChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/GetStackPolicyCommand.ts b/clients/client-cloudformation/commands/GetStackPolicyCommand.ts index 34bc9ccf4cdbf..8ec4c0f91346d 100644 --- a/clients/client-cloudformation/commands/GetStackPolicyCommand.ts +++ b/clients/client-cloudformation/commands/GetStackPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type GetStackPolicyCommandInput = GetStackPolicyInput; export type GetStackPolicyCommandOutput = GetStackPolicyOutput & __MetadataBearer; +/** + *

Returns the stack policy for a specified stack. If a stack doesn't have a policy, a + * null value is returned.

+ */ export class GetStackPolicyCommand extends $Command< GetStackPolicyCommandInput, GetStackPolicyCommandOutput, @@ -34,6 +38,9 @@ export class GetStackPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/GetTemplateCommand.ts b/clients/client-cloudformation/commands/GetTemplateCommand.ts index 340bf2a3e5d6f..5a6469d742444 100644 --- a/clients/client-cloudformation/commands/GetTemplateCommand.ts +++ b/clients/client-cloudformation/commands/GetTemplateCommand.ts @@ -17,6 +17,16 @@ import { export type GetTemplateCommandInput = GetTemplateInput; export type GetTemplateCommandOutput = GetTemplateOutput & __MetadataBearer; +/** + *

Returns the template body for a specified stack. You can get the template for running + * or deleted stacks.

+ *

For deleted stacks, GetTemplate returns the template for up to 90 days after the + * stack has been deleted.

+ * + *

If the template does not exist, a ValidationError is returned. + *

+ *
+ */ export class GetTemplateCommand extends $Command< GetTemplateCommandInput, GetTemplateCommandOutput, @@ -31,6 +41,9 @@ export class GetTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/GetTemplateSummaryCommand.ts b/clients/client-cloudformation/commands/GetTemplateSummaryCommand.ts index fea27d0894717..53a0122eacabf 100644 --- a/clients/client-cloudformation/commands/GetTemplateSummaryCommand.ts +++ b/clients/client-cloudformation/commands/GetTemplateSummaryCommand.ts @@ -20,6 +20,17 @@ import { export type GetTemplateSummaryCommandInput = GetTemplateSummaryInput; export type GetTemplateSummaryCommandOutput = GetTemplateSummaryOutput & __MetadataBearer; +/** + *

Returns information about a new or existing template. The + * GetTemplateSummary action is useful for viewing parameter information, such + * as default parameter values and parameter types, before you create or update a stack or + * stack set.

+ *

You can use the GetTemplateSummary action when you submit a template, or + * you can get template information for a stack set, or a running or deleted stack.

+ *

For deleted stacks, GetTemplateSummary returns the template information + * for up to 90 days after the stack has been deleted. If the template does not exist, a + * ValidationError is returned.

+ */ export class GetTemplateSummaryCommand extends $Command< GetTemplateSummaryCommandInput, GetTemplateSummaryCommandOutput, @@ -34,6 +45,9 @@ export class GetTemplateSummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListChangeSetsCommand.ts b/clients/client-cloudformation/commands/ListChangeSetsCommand.ts index 01b9cb65bd528..78b24552ba900 100644 --- a/clients/client-cloudformation/commands/ListChangeSetsCommand.ts +++ b/clients/client-cloudformation/commands/ListChangeSetsCommand.ts @@ -20,6 +20,11 @@ import { export type ListChangeSetsCommandInput = ListChangeSetsInput; export type ListChangeSetsCommandOutput = ListChangeSetsOutput & __MetadataBearer; +/** + *

Returns the ID and status of each active change set for a stack. For example, AWS + * CloudFormation lists change sets that are in the CREATE_IN_PROGRESS or + * CREATE_PENDING state.

+ */ export class ListChangeSetsCommand extends $Command< ListChangeSetsCommandInput, ListChangeSetsCommandOutput, @@ -34,6 +39,9 @@ export class ListChangeSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListExportsCommand.ts b/clients/client-cloudformation/commands/ListExportsCommand.ts index 08010d3060571..e896d519b6e72 100644 --- a/clients/client-cloudformation/commands/ListExportsCommand.ts +++ b/clients/client-cloudformation/commands/ListExportsCommand.ts @@ -17,6 +17,15 @@ import { export type ListExportsCommandInput = ListExportsInput; export type ListExportsCommandOutput = ListExportsOutput & __MetadataBearer; +/** + *

Lists all exported output values in the account and Region in which you call this + * action. Use this action to see the exported output values that you can import into other + * stacks. To import values, use the + * Fn::ImportValue + * function.

+ *

For more information, see AWS + * CloudFormation Export Stack Output Values.

+ */ export class ListExportsCommand extends $Command< ListExportsCommandInput, ListExportsCommandOutput, @@ -31,6 +40,9 @@ export class ListExportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListImportsCommand.ts b/clients/client-cloudformation/commands/ListImportsCommand.ts index d7785ee291398..3b2cbe4b98b66 100644 --- a/clients/client-cloudformation/commands/ListImportsCommand.ts +++ b/clients/client-cloudformation/commands/ListImportsCommand.ts @@ -17,6 +17,14 @@ import { export type ListImportsCommandInput = ListImportsInput; export type ListImportsCommandOutput = ListImportsOutput & __MetadataBearer; +/** + *

Lists all stacks that are importing an exported output value. To modify or remove an + * exported output value, first use this action to see which stacks are using it. To see the + * exported output values in your account, see ListExports.

+ *

For more information about importing an exported output value, see the + * Fn::ImportValue + * function.

+ */ export class ListImportsCommand extends $Command< ListImportsCommandInput, ListImportsCommandOutput, @@ -31,6 +39,9 @@ export class ListImportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListStackInstancesCommand.ts b/clients/client-cloudformation/commands/ListStackInstancesCommand.ts index 97d2e0384e26e..88cf9f9a676d9 100644 --- a/clients/client-cloudformation/commands/ListStackInstancesCommand.ts +++ b/clients/client-cloudformation/commands/ListStackInstancesCommand.ts @@ -20,6 +20,11 @@ import { export type ListStackInstancesCommandInput = ListStackInstancesInput; export type ListStackInstancesCommandOutput = ListStackInstancesOutput & __MetadataBearer; +/** + *

Returns summary information about stack instances that are associated with the + * specified stack set. You can filter for stack instances that are associated with a specific + * AWS account name or Region, or that have a specific status.

+ */ export class ListStackInstancesCommand extends $Command< ListStackInstancesCommandInput, ListStackInstancesCommandOutput, @@ -34,6 +39,9 @@ export class ListStackInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListStackResourcesCommand.ts b/clients/client-cloudformation/commands/ListStackResourcesCommand.ts index dfe69e84207a7..45cf610385be4 100644 --- a/clients/client-cloudformation/commands/ListStackResourcesCommand.ts +++ b/clients/client-cloudformation/commands/ListStackResourcesCommand.ts @@ -20,6 +20,11 @@ import { export type ListStackResourcesCommandInput = ListStackResourcesInput; export type ListStackResourcesCommandOutput = ListStackResourcesOutput & __MetadataBearer; +/** + *

Returns descriptions of all resources of the specified stack.

+ *

For deleted stacks, ListStackResources returns resource information for up to 90 days + * after the stack has been deleted.

+ */ export class ListStackResourcesCommand extends $Command< ListStackResourcesCommandInput, ListStackResourcesCommandOutput, @@ -34,6 +39,9 @@ export class ListStackResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListStackSetOperationResultsCommand.ts b/clients/client-cloudformation/commands/ListStackSetOperationResultsCommand.ts index 1e63026c304f2..456faf38db096 100644 --- a/clients/client-cloudformation/commands/ListStackSetOperationResultsCommand.ts +++ b/clients/client-cloudformation/commands/ListStackSetOperationResultsCommand.ts @@ -20,6 +20,9 @@ import { export type ListStackSetOperationResultsCommandInput = ListStackSetOperationResultsInput; export type ListStackSetOperationResultsCommandOutput = ListStackSetOperationResultsOutput & __MetadataBearer; +/** + *

Returns summary information about the results of a stack set operation.

+ */ export class ListStackSetOperationResultsCommand extends $Command< ListStackSetOperationResultsCommandInput, ListStackSetOperationResultsCommandOutput, @@ -34,6 +37,9 @@ export class ListStackSetOperationResultsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListStackSetOperationsCommand.ts b/clients/client-cloudformation/commands/ListStackSetOperationsCommand.ts index 19b67d263324d..f2f71808d2a00 100644 --- a/clients/client-cloudformation/commands/ListStackSetOperationsCommand.ts +++ b/clients/client-cloudformation/commands/ListStackSetOperationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListStackSetOperationsCommandInput = ListStackSetOperationsInput; export type ListStackSetOperationsCommandOutput = ListStackSetOperationsOutput & __MetadataBearer; +/** + *

Returns summary information about operations performed on a stack set.

+ */ export class ListStackSetOperationsCommand extends $Command< ListStackSetOperationsCommandInput, ListStackSetOperationsCommandOutput, @@ -34,6 +37,9 @@ export class ListStackSetOperationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListStackSetsCommand.ts b/clients/client-cloudformation/commands/ListStackSetsCommand.ts index d129e2f771746..9c0c42ddcf492 100644 --- a/clients/client-cloudformation/commands/ListStackSetsCommand.ts +++ b/clients/client-cloudformation/commands/ListStackSetsCommand.ts @@ -20,6 +20,10 @@ import { export type ListStackSetsCommandInput = ListStackSetsInput; export type ListStackSetsCommandOutput = ListStackSetsOutput & __MetadataBearer; +/** + *

Returns summary information about stack sets that are associated with the + * user.

+ */ export class ListStackSetsCommand extends $Command< ListStackSetsCommandInput, ListStackSetsCommandOutput, @@ -34,6 +38,9 @@ export class ListStackSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListStacksCommand.ts b/clients/client-cloudformation/commands/ListStacksCommand.ts index 983806c1fc278..d18aed5578c2f 100644 --- a/clients/client-cloudformation/commands/ListStacksCommand.ts +++ b/clients/client-cloudformation/commands/ListStacksCommand.ts @@ -17,6 +17,13 @@ import { export type ListStacksCommandInput = ListStacksInput; export type ListStacksCommandOutput = ListStacksOutput & __MetadataBearer; +/** + *

Returns the summary information for stacks whose status matches the specified + * StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 + * days after the stack is deleted. If no StackStatusFilter is specified, summary information + * for all stacks is returned (including existing stacks and stacks that have been + * deleted).

+ */ export class ListStacksCommand extends $Command< ListStacksCommandInput, ListStacksCommandOutput, @@ -31,6 +38,9 @@ export class ListStacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListTypeRegistrationsCommand.ts b/clients/client-cloudformation/commands/ListTypeRegistrationsCommand.ts index 6f57c58f35f1e..cbab06683767f 100644 --- a/clients/client-cloudformation/commands/ListTypeRegistrationsCommand.ts +++ b/clients/client-cloudformation/commands/ListTypeRegistrationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTypeRegistrationsCommandInput = ListTypeRegistrationsInput; export type ListTypeRegistrationsCommandOutput = ListTypeRegistrationsOutput & __MetadataBearer; +/** + *

Returns a list of registration tokens for the specified type(s).

+ */ export class ListTypeRegistrationsCommand extends $Command< ListTypeRegistrationsCommandInput, ListTypeRegistrationsCommandOutput, @@ -34,6 +37,9 @@ export class ListTypeRegistrationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListTypeVersionsCommand.ts b/clients/client-cloudformation/commands/ListTypeVersionsCommand.ts index 961798b16c956..8fae21fe1561a 100644 --- a/clients/client-cloudformation/commands/ListTypeVersionsCommand.ts +++ b/clients/client-cloudformation/commands/ListTypeVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTypeVersionsCommandInput = ListTypeVersionsInput; export type ListTypeVersionsCommandOutput = ListTypeVersionsOutput & __MetadataBearer; +/** + *

Returns summary information about the versions of a type.

+ */ export class ListTypeVersionsCommand extends $Command< ListTypeVersionsCommandInput, ListTypeVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListTypeVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ListTypesCommand.ts b/clients/client-cloudformation/commands/ListTypesCommand.ts index 9f31b93c59933..24930d359865e 100644 --- a/clients/client-cloudformation/commands/ListTypesCommand.ts +++ b/clients/client-cloudformation/commands/ListTypesCommand.ts @@ -17,6 +17,9 @@ import { export type ListTypesCommandInput = ListTypesInput; export type ListTypesCommandOutput = ListTypesOutput & __MetadataBearer; +/** + *

Returns summary information about types that have been registered with CloudFormation.

+ */ export class ListTypesCommand extends $Command< ListTypesCommandInput, ListTypesCommandOutput, @@ -31,6 +34,9 @@ export class ListTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/RecordHandlerProgressCommand.ts b/clients/client-cloudformation/commands/RecordHandlerProgressCommand.ts index 0c7c1025e92e6..c31e54f62d7dd 100644 --- a/clients/client-cloudformation/commands/RecordHandlerProgressCommand.ts +++ b/clients/client-cloudformation/commands/RecordHandlerProgressCommand.ts @@ -20,6 +20,10 @@ import { export type RecordHandlerProgressCommandInput = RecordHandlerProgressInput; export type RecordHandlerProgressCommandOutput = RecordHandlerProgressOutput & __MetadataBearer; +/** + *

Reports progress of a resource handler to CloudFormation.

+ *

Reserved for use by the CloudFormation CLI. Do not use this API in your code.

+ */ export class RecordHandlerProgressCommand extends $Command< RecordHandlerProgressCommandInput, RecordHandlerProgressCommandOutput, @@ -34,6 +38,9 @@ export class RecordHandlerProgressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/RegisterTypeCommand.ts b/clients/client-cloudformation/commands/RegisterTypeCommand.ts index 3cc883cd72964..a67d37efa7fd9 100644 --- a/clients/client-cloudformation/commands/RegisterTypeCommand.ts +++ b/clients/client-cloudformation/commands/RegisterTypeCommand.ts @@ -17,6 +17,27 @@ import { export type RegisterTypeCommandInput = RegisterTypeInput; export type RegisterTypeCommandOutput = RegisterTypeOutput & __MetadataBearer; +/** + *

Registers a type with the CloudFormation service. Registering a type makes it available for use in CloudFormation templates in your AWS account, and includes:

+ *
    + *
  • + *

    Validating the resource schema

    + *
  • + *
  • + *

    Determining which handlers have been specified for the resource

    + *
  • + *
  • + *

    Making the resource type available for use in your account

    + *
  • + *
+ *

For more information on how to develop types and ready them for registeration, see Creating Resource Providers in the CloudFormation CLI User Guide.

+ *

You can have a maximum of 50 resource type versions registered at a time. This maximum is per account and per region. Use DeregisterType to deregister specific resource type versions if necessary.

+ *

Once you have initiated a registration request using + * RegisterType + * , you can use + * DescribeTypeRegistration + * to monitor the progress of the registration request.

+ */ export class RegisterTypeCommand extends $Command< RegisterTypeCommandInput, RegisterTypeCommandOutput, @@ -31,6 +52,9 @@ export class RegisterTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/SetStackPolicyCommand.ts b/clients/client-cloudformation/commands/SetStackPolicyCommand.ts index b57c8c8f5e098..e383686df5ff0 100644 --- a/clients/client-cloudformation/commands/SetStackPolicyCommand.ts +++ b/clients/client-cloudformation/commands/SetStackPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type SetStackPolicyCommandInput = SetStackPolicyInput; export type SetStackPolicyCommandOutput = __MetadataBearer; +/** + *

Sets a stack policy for a specified stack.

+ */ export class SetStackPolicyCommand extends $Command< SetStackPolicyCommandInput, SetStackPolicyCommandOutput, @@ -34,6 +37,9 @@ export class SetStackPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/SetTypeDefaultVersionCommand.ts b/clients/client-cloudformation/commands/SetTypeDefaultVersionCommand.ts index 93e0f73e5ce2a..311953286302e 100644 --- a/clients/client-cloudformation/commands/SetTypeDefaultVersionCommand.ts +++ b/clients/client-cloudformation/commands/SetTypeDefaultVersionCommand.ts @@ -20,6 +20,9 @@ import { export type SetTypeDefaultVersionCommandInput = SetTypeDefaultVersionInput; export type SetTypeDefaultVersionCommandOutput = SetTypeDefaultVersionOutput & __MetadataBearer; +/** + *

Specify the default version of a type. The default version of a type will be used in CloudFormation operations.

+ */ export class SetTypeDefaultVersionCommand extends $Command< SetTypeDefaultVersionCommandInput, SetTypeDefaultVersionCommandOutput, @@ -34,6 +37,9 @@ export class SetTypeDefaultVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/SignalResourceCommand.ts b/clients/client-cloudformation/commands/SignalResourceCommand.ts index 6bc2158f40894..01e335670fff1 100644 --- a/clients/client-cloudformation/commands/SignalResourceCommand.ts +++ b/clients/client-cloudformation/commands/SignalResourceCommand.ts @@ -20,6 +20,14 @@ import { export type SignalResourceCommandInput = SignalResourceInput; export type SignalResourceCommandOutput = __MetadataBearer; +/** + *

Sends a signal to the specified resource with a success or failure status. You can + * use the SignalResource API in conjunction with a creation policy or update policy. AWS + * CloudFormation doesn't proceed with a stack creation or update until resources receive the + * required number of signals or the timeout period is exceeded. The SignalResource API is + * useful in cases where you want to send signals from anywhere other than an Amazon EC2 + * instance.

+ */ export class SignalResourceCommand extends $Command< SignalResourceCommandInput, SignalResourceCommandOutput, @@ -34,6 +42,9 @@ export class SignalResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/StopStackSetOperationCommand.ts b/clients/client-cloudformation/commands/StopStackSetOperationCommand.ts index 34335fceea0f6..e2eb63982b49d 100644 --- a/clients/client-cloudformation/commands/StopStackSetOperationCommand.ts +++ b/clients/client-cloudformation/commands/StopStackSetOperationCommand.ts @@ -20,6 +20,9 @@ import { export type StopStackSetOperationCommandInput = StopStackSetOperationInput; export type StopStackSetOperationCommandOutput = StopStackSetOperationOutput & __MetadataBearer; +/** + *

Stops an in-progress operation on a stack set and its associated stack instances.

+ */ export class StopStackSetOperationCommand extends $Command< StopStackSetOperationCommandInput, StopStackSetOperationCommandOutput, @@ -34,6 +37,9 @@ export class StopStackSetOperationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/UpdateStackCommand.ts b/clients/client-cloudformation/commands/UpdateStackCommand.ts index fab73fd5f2aff..2e38e9ec68dc6 100644 --- a/clients/client-cloudformation/commands/UpdateStackCommand.ts +++ b/clients/client-cloudformation/commands/UpdateStackCommand.ts @@ -17,6 +17,14 @@ import { export type UpdateStackCommandInput = UpdateStackInput; export type UpdateStackCommandOutput = UpdateStackOutput & __MetadataBearer; +/** + *

Updates a stack as specified in the template. After the call completes successfully, + * the stack update starts. You can check the status of the stack via the DescribeStacks action.

+ *

To get a copy of the template for an existing stack, you can use the GetTemplate action.

+ *

For more information about creating an update template, updating a stack, and + * monitoring the progress of the update, see Updating a + * Stack.

+ */ export class UpdateStackCommand extends $Command< UpdateStackCommandInput, UpdateStackCommandOutput, @@ -31,6 +39,9 @@ export class UpdateStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/UpdateStackInstancesCommand.ts b/clients/client-cloudformation/commands/UpdateStackInstancesCommand.ts index e2f7ec3ca55f6..6533c635d57e4 100644 --- a/clients/client-cloudformation/commands/UpdateStackInstancesCommand.ts +++ b/clients/client-cloudformation/commands/UpdateStackInstancesCommand.ts @@ -20,6 +20,21 @@ import { export type UpdateStackInstancesCommandInput = UpdateStackInstancesInput; export type UpdateStackInstancesCommandOutput = UpdateStackInstancesOutput & __MetadataBearer; +/** + *

Updates the parameter values for stack instances for the specified accounts, within + * the specified Regions. A stack instance refers to a stack in a specific account and Region.

+ *

You can only update stack instances in Regions and accounts where they already exist; + * to create additional stack instances, use CreateStackInstances.

+ *

During stack set updates, any parameters overridden for a stack instance are not + * updated, but retain their overridden value.

+ *

You can only update the parameter values that are specified in + * the stack set; to add or delete a parameter itself, use UpdateStackSet to update the stack set template. If you add a parameter to a + * template, before you can override the parameter value specified in the stack set you must + * first use UpdateStackSet to update all stack instances with the updated template and + * parameter value specified in the stack set. Once a stack instance has been updated with the + * new parameter, you can then override the parameter value using + * UpdateStackInstances.

+ */ export class UpdateStackInstancesCommand extends $Command< UpdateStackInstancesCommandInput, UpdateStackInstancesCommandOutput, @@ -34,6 +49,9 @@ export class UpdateStackInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/UpdateStackSetCommand.ts b/clients/client-cloudformation/commands/UpdateStackSetCommand.ts index d66d455384778..9fc8505a61ab6 100644 --- a/clients/client-cloudformation/commands/UpdateStackSetCommand.ts +++ b/clients/client-cloudformation/commands/UpdateStackSetCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateStackSetCommandInput = UpdateStackSetInput; export type UpdateStackSetCommandOutput = UpdateStackSetOutput & __MetadataBearer; +/** + *

Updates the stack set, and associated stack instances in the specified accounts and + * Regions.

+ *

Even if the stack set operation created by updating the stack set fails (completely + * or partially, below or above a specified failure tolerance), the stack set is updated with + * your changes. Subsequent CreateStackInstances calls on the specified + * stack set use the updated stack set.

+ */ export class UpdateStackSetCommand extends $Command< UpdateStackSetCommandInput, UpdateStackSetCommandOutput, @@ -34,6 +42,9 @@ export class UpdateStackSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/UpdateTerminationProtectionCommand.ts b/clients/client-cloudformation/commands/UpdateTerminationProtectionCommand.ts index 5ea3454777e38..6b2f4efdd794c 100644 --- a/clients/client-cloudformation/commands/UpdateTerminationProtectionCommand.ts +++ b/clients/client-cloudformation/commands/UpdateTerminationProtectionCommand.ts @@ -20,6 +20,15 @@ import { export type UpdateTerminationProtectionCommandInput = UpdateTerminationProtectionInput; export type UpdateTerminationProtectionCommandOutput = UpdateTerminationProtectionOutput & __MetadataBearer; +/** + *

Updates termination protection for the specified stack. If a user attempts to delete + * a stack with termination protection enabled, the operation fails and the stack remains + * unchanged. For more information, see Protecting a + * Stack From Being Deleted in the AWS CloudFormation User Guide.

+ *

For nested + * stacks, termination protection is set on the root stack and cannot be changed + * directly on the nested stack.

+ */ export class UpdateTerminationProtectionCommand extends $Command< UpdateTerminationProtectionCommandInput, UpdateTerminationProtectionCommandOutput, @@ -34,6 +43,9 @@ export class UpdateTerminationProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/commands/ValidateTemplateCommand.ts b/clients/client-cloudformation/commands/ValidateTemplateCommand.ts index da2c8a1103381..31f4574fe7454 100644 --- a/clients/client-cloudformation/commands/ValidateTemplateCommand.ts +++ b/clients/client-cloudformation/commands/ValidateTemplateCommand.ts @@ -20,6 +20,11 @@ import { export type ValidateTemplateCommandInput = ValidateTemplateInput; export type ValidateTemplateCommandOutput = ValidateTemplateOutput & __MetadataBearer; +/** + *

Validates a specified template. AWS CloudFormation first checks if the template is + * valid JSON. If it isn't, AWS CloudFormation checks if the template is valid YAML. If both + * these checks fail, AWS CloudFormation returns a template validation error.

+ */ export class ValidateTemplateCommand extends $Command< ValidateTemplateCommandInput, ValidateTemplateCommandOutput, @@ -34,6 +39,9 @@ export class ValidateTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFormationClientResolvedConfig, diff --git a/clients/client-cloudformation/package.json b/clients/client-cloudformation/package.json index 2ffb7e6ee188f..281d82952c616 100644 --- a/clients/client-cloudformation/package.json +++ b/clients/client-cloudformation/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudformation Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudformation/pagination/DescribeAccountLimitsPaginator.ts b/clients/client-cloudformation/pagination/DescribeAccountLimitsPaginator.ts index 1142586be0ad0..c150cfca430fd 100644 --- a/clients/client-cloudformation/pagination/DescribeAccountLimitsPaginator.ts +++ b/clients/client-cloudformation/pagination/DescribeAccountLimitsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: DescribeAccountLimitsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAccountLimitsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: DescribeAccountLimitsCommandInput, diff --git a/clients/client-cloudformation/pagination/DescribeStackEventsPaginator.ts b/clients/client-cloudformation/pagination/DescribeStackEventsPaginator.ts index 40b20ef3b2cc7..1bde1b0d48784 100644 --- a/clients/client-cloudformation/pagination/DescribeStackEventsPaginator.ts +++ b/clients/client-cloudformation/pagination/DescribeStackEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: DescribeStackEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeStackEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: DescribeStackEventsCommandInput, diff --git a/clients/client-cloudformation/pagination/DescribeStackResourceDriftsPaginator.ts b/clients/client-cloudformation/pagination/DescribeStackResourceDriftsPaginator.ts index eb812c1d1843a..7e12dd28db1fb 100644 --- a/clients/client-cloudformation/pagination/DescribeStackResourceDriftsPaginator.ts +++ b/clients/client-cloudformation/pagination/DescribeStackResourceDriftsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: DescribeStackResourceDriftsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeStackResourceDriftsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: DescribeStackResourceDriftsCommandInput, diff --git a/clients/client-cloudformation/pagination/DescribeStacksPaginator.ts b/clients/client-cloudformation/pagination/DescribeStacksPaginator.ts index 1bbd7c7cbbbbf..9f20809d4afb1 100644 --- a/clients/client-cloudformation/pagination/DescribeStacksPaginator.ts +++ b/clients/client-cloudformation/pagination/DescribeStacksPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: DescribeStacksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeStacksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: DescribeStacksCommandInput, diff --git a/clients/client-cloudformation/pagination/ListChangeSetsPaginator.ts b/clients/client-cloudformation/pagination/ListChangeSetsPaginator.ts index e81d4fdb9ede7..8db9f9c40de07 100644 --- a/clients/client-cloudformation/pagination/ListChangeSetsPaginator.ts +++ b/clients/client-cloudformation/pagination/ListChangeSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListChangeSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListChangeSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListChangeSetsCommandInput, diff --git a/clients/client-cloudformation/pagination/ListExportsPaginator.ts b/clients/client-cloudformation/pagination/ListExportsPaginator.ts index fd32704b9de0f..1a3e08e1ba85b 100644 --- a/clients/client-cloudformation/pagination/ListExportsPaginator.ts +++ b/clients/client-cloudformation/pagination/ListExportsPaginator.ts @@ -4,6 +4,9 @@ import { ListExportsCommand, ListExportsCommandInput, ListExportsCommandOutput } import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListExportsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListExportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListExportsCommandInput, diff --git a/clients/client-cloudformation/pagination/ListImportsPaginator.ts b/clients/client-cloudformation/pagination/ListImportsPaginator.ts index 8be2bb7a53b9d..001d55175f2f6 100644 --- a/clients/client-cloudformation/pagination/ListImportsPaginator.ts +++ b/clients/client-cloudformation/pagination/ListImportsPaginator.ts @@ -4,6 +4,9 @@ import { ListImportsCommand, ListImportsCommandInput, ListImportsCommandOutput } import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListImportsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListImportsCommandInput, diff --git a/clients/client-cloudformation/pagination/ListStackInstancesPaginator.ts b/clients/client-cloudformation/pagination/ListStackInstancesPaginator.ts index c7187a533c7be..aeb8863d91e83 100644 --- a/clients/client-cloudformation/pagination/ListStackInstancesPaginator.ts +++ b/clients/client-cloudformation/pagination/ListStackInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListStackInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStackInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListStackInstancesCommandInput, diff --git a/clients/client-cloudformation/pagination/ListStackResourcesPaginator.ts b/clients/client-cloudformation/pagination/ListStackResourcesPaginator.ts index e3516e3b0ec93..c9c352de8cf33 100644 --- a/clients/client-cloudformation/pagination/ListStackResourcesPaginator.ts +++ b/clients/client-cloudformation/pagination/ListStackResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListStackResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStackResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListStackResourcesCommandInput, diff --git a/clients/client-cloudformation/pagination/ListStackSetOperationResultsPaginator.ts b/clients/client-cloudformation/pagination/ListStackSetOperationResultsPaginator.ts index 3c557307ef76a..bf7025f3931fd 100644 --- a/clients/client-cloudformation/pagination/ListStackSetOperationResultsPaginator.ts +++ b/clients/client-cloudformation/pagination/ListStackSetOperationResultsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListStackSetOperationResultsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStackSetOperationResultsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListStackSetOperationResultsCommandInput, diff --git a/clients/client-cloudformation/pagination/ListStackSetOperationsPaginator.ts b/clients/client-cloudformation/pagination/ListStackSetOperationsPaginator.ts index 281735581a5d8..2c9cb2c3837a7 100644 --- a/clients/client-cloudformation/pagination/ListStackSetOperationsPaginator.ts +++ b/clients/client-cloudformation/pagination/ListStackSetOperationsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListStackSetOperationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStackSetOperationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListStackSetOperationsCommandInput, diff --git a/clients/client-cloudformation/pagination/ListStackSetsPaginator.ts b/clients/client-cloudformation/pagination/ListStackSetsPaginator.ts index a81cba32806a3..849748242a8e4 100644 --- a/clients/client-cloudformation/pagination/ListStackSetsPaginator.ts +++ b/clients/client-cloudformation/pagination/ListStackSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListStackSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStackSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListStackSetsCommandInput, diff --git a/clients/client-cloudformation/pagination/ListStacksPaginator.ts b/clients/client-cloudformation/pagination/ListStacksPaginator.ts index 09cea0cabe78d..e7297e11be7f5 100644 --- a/clients/client-cloudformation/pagination/ListStacksPaginator.ts +++ b/clients/client-cloudformation/pagination/ListStacksPaginator.ts @@ -4,6 +4,9 @@ import { ListStacksCommand, ListStacksCommandInput, ListStacksCommandOutput } fr import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListStacksCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStacksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListStacksCommandInput, diff --git a/clients/client-cloudformation/pagination/ListTypeRegistrationsPaginator.ts b/clients/client-cloudformation/pagination/ListTypeRegistrationsPaginator.ts index 5254b00d33059..3b42808ebe676 100644 --- a/clients/client-cloudformation/pagination/ListTypeRegistrationsPaginator.ts +++ b/clients/client-cloudformation/pagination/ListTypeRegistrationsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListTypeRegistrationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTypeRegistrationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListTypeRegistrationsCommandInput, diff --git a/clients/client-cloudformation/pagination/ListTypeVersionsPaginator.ts b/clients/client-cloudformation/pagination/ListTypeVersionsPaginator.ts index 993b5ea92086f..8c8e78f3879fd 100644 --- a/clients/client-cloudformation/pagination/ListTypeVersionsPaginator.ts +++ b/clients/client-cloudformation/pagination/ListTypeVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListTypeVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTypeVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListTypeVersionsCommandInput, diff --git a/clients/client-cloudformation/pagination/ListTypesPaginator.ts b/clients/client-cloudformation/pagination/ListTypesPaginator.ts index 3df04d69d4395..35dfb2766de65 100644 --- a/clients/client-cloudformation/pagination/ListTypesPaginator.ts +++ b/clients/client-cloudformation/pagination/ListTypesPaginator.ts @@ -4,6 +4,9 @@ import { ListTypesCommand, ListTypesCommandInput, ListTypesCommandOutput } from import { CloudFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudFormationClient, input: ListTypesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudFormation, input: ListTypesCommandInput, diff --git a/clients/client-cloudformation/runtimeConfig.browser.ts b/clients/client-cloudformation/runtimeConfig.browser.ts index c8e5fa5156df3..ff205622d8d64 100644 --- a/clients/client-cloudformation/runtimeConfig.browser.ts +++ b/clients/client-cloudformation/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudFormationClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudformation/runtimeConfig.native.ts b/clients/client-cloudformation/runtimeConfig.native.ts index 77ae1b2c9ca6c..061a5f34e3469 100644 --- a/clients/client-cloudformation/runtimeConfig.native.ts +++ b/clients/client-cloudformation/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudFormationClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudformation/runtimeConfig.shared.ts b/clients/client-cloudformation/runtimeConfig.shared.ts index adfde3c2d19dd..49f739c8ab457 100644 --- a/clients/client-cloudformation/runtimeConfig.shared.ts +++ b/clients/client-cloudformation/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2010-05-15", disableHostPrefix: false, diff --git a/clients/client-cloudformation/runtimeConfig.ts b/clients/client-cloudformation/runtimeConfig.ts index 7b249388509c5..6a76dc14bd67a 100644 --- a/clients/client-cloudformation/runtimeConfig.ts +++ b/clients/client-cloudformation/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudFormationClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudformation/tsconfig.json b/clients/client-cloudformation/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudformation/tsconfig.json +++ b/clients/client-cloudformation/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudfront/commands/CreateCachePolicyCommand.ts b/clients/client-cloudfront/commands/CreateCachePolicyCommand.ts index 2153dcda2504c..95b7b472939e8 100644 --- a/clients/client-cloudfront/commands/CreateCachePolicyCommand.ts +++ b/clients/client-cloudfront/commands/CreateCachePolicyCommand.ts @@ -20,6 +20,29 @@ import { export type CreateCachePolicyCommandInput = CreateCachePolicyRequest; export type CreateCachePolicyCommandOutput = CreateCachePolicyResult & __MetadataBearer; +/** + *

Creates a cache policy.

+ *

After you create a cache policy, you can attach it to one or more cache behaviors. When it’s + * attached to a cache behavior, the cache policy determines the following:

+ *
    + *
  • + *

    The values that CloudFront includes in the cache key. These values can + * include HTTP headers, cookies, and URL query strings. CloudFront uses the cache key to + * find an object in its cache that it can return to the viewer.

    + *
  • + *
  • + *

    The default, minimum, and maximum time to live (TTL) values that you want objects to stay + * in the CloudFront cache.

    + *
  • + *
+ *

The headers, cookies, and query strings that are included in the cache key are automatically + * included in requests that CloudFront sends to the origin. CloudFront sends a request when it can’t + * find an object in its cache that matches the request’s cache key. If you want to send + * values to the origin but not include them in the cache key, use + * OriginRequestPolicy.

+ *

For more information about cache policies, see Controlling the cache key in the + * Amazon CloudFront Developer Guide.

+ */ export class CreateCachePolicyCommand extends $Command< CreateCachePolicyCommandInput, CreateCachePolicyCommandOutput, @@ -34,6 +57,9 @@ export class CreateCachePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateCloudFrontOriginAccessIdentityCommand.ts b/clients/client-cloudfront/commands/CreateCloudFrontOriginAccessIdentityCommand.ts index 55b951a47643c..3e2a69f160b90 100644 --- a/clients/client-cloudfront/commands/CreateCloudFrontOriginAccessIdentityCommand.ts +++ b/clients/client-cloudfront/commands/CreateCloudFrontOriginAccessIdentityCommand.ts @@ -24,6 +24,12 @@ export type CreateCloudFrontOriginAccessIdentityCommandInput = CreateCloudFrontO export type CreateCloudFrontOriginAccessIdentityCommandOutput = CreateCloudFrontOriginAccessIdentityResult & __MetadataBearer; +/** + *

Creates a new origin access identity. If you're using Amazon S3 for your origin, you can + * use an origin access identity to require users to access your content using a CloudFront URL instead + * of the Amazon S3 URL. For more information about how to use origin access identities, see Serving Private Content through CloudFront in the + * Amazon CloudFront Developer Guide.

+ */ export class CreateCloudFrontOriginAccessIdentityCommand extends $Command< CreateCloudFrontOriginAccessIdentityCommandInput, CreateCloudFrontOriginAccessIdentityCommandOutput, @@ -38,6 +44,9 @@ export class CreateCloudFrontOriginAccessIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateDistributionCommand.ts b/clients/client-cloudfront/commands/CreateDistributionCommand.ts index c23305711ffe4..d43f929b7e1b9 100644 --- a/clients/client-cloudfront/commands/CreateDistributionCommand.ts +++ b/clients/client-cloudfront/commands/CreateDistributionCommand.ts @@ -20,6 +20,21 @@ import { export type CreateDistributionCommandInput = CreateDistributionRequest; export type CreateDistributionCommandOutput = CreateDistributionResult & __MetadataBearer; +/** + *

Creates a new web distribution. You create a CloudFront distribution to tell CloudFront where you + * want content to be delivered from, and the details about how to track and manage content delivery. Send a POST request to the + * /CloudFront API version/distribution/distribution ID resource.

+ * + *

When you update a distribution, there are more required fields than when you create a distribution. + * When you update your distribution by using + * UpdateDistribution, + * follow the steps included + * in the documentation to get the current configuration + * and then make your updates. This helps to make sure that you include all of the required fields. To view a summary, + * see Required + * Fields for Create Distribution and Update Distribution in the Amazon CloudFront Developer Guide.

+ *
+ */ export class CreateDistributionCommand extends $Command< CreateDistributionCommandInput, CreateDistributionCommandOutput, @@ -34,6 +49,9 @@ export class CreateDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateDistributionWithTagsCommand.ts b/clients/client-cloudfront/commands/CreateDistributionWithTagsCommand.ts index 28eb05af94608..b6c4c8189e986 100644 --- a/clients/client-cloudfront/commands/CreateDistributionWithTagsCommand.ts +++ b/clients/client-cloudfront/commands/CreateDistributionWithTagsCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDistributionWithTagsCommandInput = CreateDistributionWithTagsRequest; export type CreateDistributionWithTagsCommandOutput = CreateDistributionWithTagsResult & __MetadataBearer; +/** + *

Create a new distribution with tags.

+ */ export class CreateDistributionWithTagsCommand extends $Command< CreateDistributionWithTagsCommandInput, CreateDistributionWithTagsCommandOutput, @@ -34,6 +37,9 @@ export class CreateDistributionWithTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateFieldLevelEncryptionConfigCommand.ts b/clients/client-cloudfront/commands/CreateFieldLevelEncryptionConfigCommand.ts index 19a94643ed2e7..685c6005921b0 100644 --- a/clients/client-cloudfront/commands/CreateFieldLevelEncryptionConfigCommand.ts +++ b/clients/client-cloudfront/commands/CreateFieldLevelEncryptionConfigCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFieldLevelEncryptionConfigCommandInput = CreateFieldLevelEncryptionConfigRequest; export type CreateFieldLevelEncryptionConfigCommandOutput = CreateFieldLevelEncryptionConfigResult & __MetadataBearer; +/** + *

Create a new field-level encryption configuration.

+ */ export class CreateFieldLevelEncryptionConfigCommand extends $Command< CreateFieldLevelEncryptionConfigCommandInput, CreateFieldLevelEncryptionConfigCommandOutput, @@ -34,6 +37,9 @@ export class CreateFieldLevelEncryptionConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateFieldLevelEncryptionProfileCommand.ts b/clients/client-cloudfront/commands/CreateFieldLevelEncryptionProfileCommand.ts index dea56c2e785d7..823af7e8d48f6 100644 --- a/clients/client-cloudfront/commands/CreateFieldLevelEncryptionProfileCommand.ts +++ b/clients/client-cloudfront/commands/CreateFieldLevelEncryptionProfileCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFieldLevelEncryptionProfileCommandInput = CreateFieldLevelEncryptionProfileRequest; export type CreateFieldLevelEncryptionProfileCommandOutput = CreateFieldLevelEncryptionProfileResult & __MetadataBearer; +/** + *

Create a field-level encryption profile.

+ */ export class CreateFieldLevelEncryptionProfileCommand extends $Command< CreateFieldLevelEncryptionProfileCommandInput, CreateFieldLevelEncryptionProfileCommandOutput, @@ -34,6 +37,9 @@ export class CreateFieldLevelEncryptionProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateInvalidationCommand.ts b/clients/client-cloudfront/commands/CreateInvalidationCommand.ts index 1add098e7dd0d..0255203f18368 100644 --- a/clients/client-cloudfront/commands/CreateInvalidationCommand.ts +++ b/clients/client-cloudfront/commands/CreateInvalidationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateInvalidationCommandInput = CreateInvalidationRequest; export type CreateInvalidationCommandOutput = CreateInvalidationResult & __MetadataBearer; +/** + *

Create a new invalidation.

+ */ export class CreateInvalidationCommand extends $Command< CreateInvalidationCommandInput, CreateInvalidationCommandOutput, @@ -34,6 +37,9 @@ export class CreateInvalidationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateKeyGroupCommand.ts b/clients/client-cloudfront/commands/CreateKeyGroupCommand.ts index 8825d00f19ac9..2e43fd617e1ef 100644 --- a/clients/client-cloudfront/commands/CreateKeyGroupCommand.ts +++ b/clients/client-cloudfront/commands/CreateKeyGroupCommand.ts @@ -20,6 +20,16 @@ import { export type CreateKeyGroupCommandInput = CreateKeyGroupRequest; export type CreateKeyGroupCommandOutput = CreateKeyGroupResult & __MetadataBearer; +/** + *

Creates a key group that you can use with CloudFront signed URLs and signed cookies.

+ *

To create a key group, you must specify at least one public key for the key group. After you + * create a key group, you can reference it from one or more cache behaviors. When you + * reference a key group in a cache behavior, CloudFront requires signed URLs or signed cookies + * for all requests that match the cache behavior. The URLs or cookies must be signed with + * a private key whose corresponding public key is in the key group. The signed URL or + * cookie contains information about which public key CloudFront should use to verify the + * signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.

+ */ export class CreateKeyGroupCommand extends $Command< CreateKeyGroupCommandInput, CreateKeyGroupCommandOutput, @@ -34,6 +44,9 @@ export class CreateKeyGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateMonitoringSubscriptionCommand.ts b/clients/client-cloudfront/commands/CreateMonitoringSubscriptionCommand.ts index fcbd8a4764426..a1fa85a09c452 100644 --- a/clients/client-cloudfront/commands/CreateMonitoringSubscriptionCommand.ts +++ b/clients/client-cloudfront/commands/CreateMonitoringSubscriptionCommand.ts @@ -20,6 +20,12 @@ import { export type CreateMonitoringSubscriptionCommandInput = CreateMonitoringSubscriptionRequest; export type CreateMonitoringSubscriptionCommandOutput = CreateMonitoringSubscriptionResult & __MetadataBearer; +/** + *

Enables additional CloudWatch metrics for the specified CloudFront distribution. The + * additional metrics incur an additional cost.

+ *

For more information, see Viewing additional CloudFront distribution metrics in the + * Amazon CloudFront Developer Guide.

+ */ export class CreateMonitoringSubscriptionCommand extends $Command< CreateMonitoringSubscriptionCommandInput, CreateMonitoringSubscriptionCommandOutput, @@ -34,6 +40,9 @@ export class CreateMonitoringSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateOriginRequestPolicyCommand.ts b/clients/client-cloudfront/commands/CreateOriginRequestPolicyCommand.ts index 3c8083bd4468f..fe40a251da8e5 100644 --- a/clients/client-cloudfront/commands/CreateOriginRequestPolicyCommand.ts +++ b/clients/client-cloudfront/commands/CreateOriginRequestPolicyCommand.ts @@ -20,6 +20,33 @@ import { export type CreateOriginRequestPolicyCommandInput = CreateOriginRequestPolicyRequest; export type CreateOriginRequestPolicyCommandOutput = CreateOriginRequestPolicyResult & __MetadataBearer; +/** + *

Creates an origin request policy.

+ *

After you create an origin request policy, you can attach it to one or more cache behaviors. + * When it’s attached to a cache behavior, the origin request policy determines the values + * that CloudFront includes in requests that it sends to the origin. Each request that CloudFront sends + * to the origin includes the following:

+ *
    + *
  • + *

    The request body and the URL path (without the domain name) from the viewer + * request.

    + *
  • + *
  • + *

    The headers that CloudFront automatically includes in every origin request, including + * Host, User-Agent, and X-Amz-Cf-Id.

    + *
  • + *
  • + *

    All HTTP headers, cookies, and URL query strings that are specified in the cache policy or + * the origin request policy. These can include items from the viewer request and, + * in the case of headers, additional ones that are added by CloudFront.

    + *
  • + *
+ *

CloudFront sends a request when it can’t find a valid object in its cache that matches the + * request. If you want to send values to the origin and also include them in the cache + * key, use CachePolicy.

+ *

For more information about origin request policies, see Controlling origin requests in the + * Amazon CloudFront Developer Guide.

+ */ export class CreateOriginRequestPolicyCommand extends $Command< CreateOriginRequestPolicyCommandInput, CreateOriginRequestPolicyCommandOutput, @@ -34,6 +61,9 @@ export class CreateOriginRequestPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreatePublicKeyCommand.ts b/clients/client-cloudfront/commands/CreatePublicKeyCommand.ts index 8a3cba6341977..edcd0ef634e83 100644 --- a/clients/client-cloudfront/commands/CreatePublicKeyCommand.ts +++ b/clients/client-cloudfront/commands/CreatePublicKeyCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePublicKeyCommandInput = CreatePublicKeyRequest; export type CreatePublicKeyCommandOutput = CreatePublicKeyResult & __MetadataBearer; +/** + *

Uploads a public key to CloudFront that you can use with signed URLs and signed cookies, or with field-level encryption.

+ */ export class CreatePublicKeyCommand extends $Command< CreatePublicKeyCommandInput, CreatePublicKeyCommandOutput, @@ -34,6 +37,9 @@ export class CreatePublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateRealtimeLogConfigCommand.ts b/clients/client-cloudfront/commands/CreateRealtimeLogConfigCommand.ts index 8701934543a5a..874c1177449f7 100644 --- a/clients/client-cloudfront/commands/CreateRealtimeLogConfigCommand.ts +++ b/clients/client-cloudfront/commands/CreateRealtimeLogConfigCommand.ts @@ -20,6 +20,12 @@ import { export type CreateRealtimeLogConfigCommandInput = CreateRealtimeLogConfigRequest; export type CreateRealtimeLogConfigCommandOutput = CreateRealtimeLogConfigResult & __MetadataBearer; +/** + *

Creates a real-time log configuration.

+ *

After you create a real-time log configuration, you can attach it to one or more cache + * behaviors to send real-time log data to the specified Amazon Kinesis data stream.

+ *

For more information about real-time log configurations, see Real-time logs in the Amazon CloudFront Developer Guide.

+ */ export class CreateRealtimeLogConfigCommand extends $Command< CreateRealtimeLogConfigCommandInput, CreateRealtimeLogConfigCommandOutput, @@ -34,6 +40,9 @@ export class CreateRealtimeLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateStreamingDistributionCommand.ts b/clients/client-cloudfront/commands/CreateStreamingDistributionCommand.ts index 06627cdbd0d0b..50d225eb12447 100644 --- a/clients/client-cloudfront/commands/CreateStreamingDistributionCommand.ts +++ b/clients/client-cloudfront/commands/CreateStreamingDistributionCommand.ts @@ -20,6 +20,33 @@ import { export type CreateStreamingDistributionCommandInput = CreateStreamingDistributionRequest; export type CreateStreamingDistributionCommandOutput = CreateStreamingDistributionResult & __MetadataBearer; +/** + *

Creates a new RTMP distribution. An RTMP distribution is similar to a web distribution, + * but an RTMP distribution streams media files using the Adobe Real-Time Messaging Protocol + * (RTMP) instead of serving files using HTTP.

+ *

To create a new distribution, submit a POST request to the + * CloudFront API version/distribution resource. The request body must include a + * document with a StreamingDistributionConfig element. The response echoes + * the StreamingDistributionConfig element and returns other information about the + * RTMP distribution.

+ *

To get the status of your request, use the GET + * StreamingDistribution API action. When the value of Enabled is + * true and the value of Status is Deployed, your + * distribution is ready. A distribution usually deploys in less than 15 minutes.

+ *

For more information about web distributions, see Working with RTMP Distributions in the + * Amazon CloudFront Developer Guide.

+ * + *

Beginning with the 2012-05-05 version of the CloudFront API, we made substantial changes to + * the format of the XML document that you include in the request body when you create or + * update a web distribution or an RTMP distribution, and when you invalidate objects. With + * previous versions of the API, we discovered that it was too easy to accidentally delete one + * or more values for an element that accepts multiple values, for example, CNAMEs and trusted + * signers. Our changes for the 2012-05-05 release are intended to prevent these accidental + * deletions and to notify you when there's a mismatch between the number of values you say + * you're specifying in the Quantity element and the number of values + * specified.

+ *
+ */ export class CreateStreamingDistributionCommand extends $Command< CreateStreamingDistributionCommandInput, CreateStreamingDistributionCommandOutput, @@ -34,6 +61,9 @@ export class CreateStreamingDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/CreateStreamingDistributionWithTagsCommand.ts b/clients/client-cloudfront/commands/CreateStreamingDistributionWithTagsCommand.ts index a8abee6b2185b..4b621aa3f5eea 100644 --- a/clients/client-cloudfront/commands/CreateStreamingDistributionWithTagsCommand.ts +++ b/clients/client-cloudfront/commands/CreateStreamingDistributionWithTagsCommand.ts @@ -24,6 +24,9 @@ export type CreateStreamingDistributionWithTagsCommandInput = CreateStreamingDis export type CreateStreamingDistributionWithTagsCommandOutput = CreateStreamingDistributionWithTagsResult & __MetadataBearer; +/** + *

Create a new streaming distribution with tags.

+ */ export class CreateStreamingDistributionWithTagsCommand extends $Command< CreateStreamingDistributionWithTagsCommandInput, CreateStreamingDistributionWithTagsCommandOutput, @@ -38,6 +41,9 @@ export class CreateStreamingDistributionWithTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteCachePolicyCommand.ts b/clients/client-cloudfront/commands/DeleteCachePolicyCommand.ts index 78d80d1f5d3ce..3740d619c2b8f 100644 --- a/clients/client-cloudfront/commands/DeleteCachePolicyCommand.ts +++ b/clients/client-cloudfront/commands/DeleteCachePolicyCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteCachePolicyCommandInput = DeleteCachePolicyRequest; export type DeleteCachePolicyCommandOutput = __MetadataBearer; +/** + *

Deletes a cache policy.

+ *

You cannot delete a cache policy if it’s attached to a cache behavior. First update your + * distributions to remove the cache policy from all cache behaviors, then delete the cache + * policy.

+ *

To delete a cache policy, you must provide the policy’s identifier and version. To get these + * values, you can use ListCachePolicies or + * GetCachePolicy.

+ */ export class DeleteCachePolicyCommand extends $Command< DeleteCachePolicyCommandInput, DeleteCachePolicyCommandOutput, @@ -34,6 +43,9 @@ export class DeleteCachePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteCloudFrontOriginAccessIdentityCommand.ts b/clients/client-cloudfront/commands/DeleteCloudFrontOriginAccessIdentityCommand.ts index 9776d14d7ee32..2d61de542240a 100644 --- a/clients/client-cloudfront/commands/DeleteCloudFrontOriginAccessIdentityCommand.ts +++ b/clients/client-cloudfront/commands/DeleteCloudFrontOriginAccessIdentityCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCloudFrontOriginAccessIdentityCommandInput = DeleteCloudFrontOriginAccessIdentityRequest; export type DeleteCloudFrontOriginAccessIdentityCommandOutput = __MetadataBearer; +/** + *

Delete an origin access identity.

+ */ export class DeleteCloudFrontOriginAccessIdentityCommand extends $Command< DeleteCloudFrontOriginAccessIdentityCommandInput, DeleteCloudFrontOriginAccessIdentityCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCloudFrontOriginAccessIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteDistributionCommand.ts b/clients/client-cloudfront/commands/DeleteDistributionCommand.ts index 9f495a3e820b0..5c76aaf7cd2a6 100644 --- a/clients/client-cloudfront/commands/DeleteDistributionCommand.ts +++ b/clients/client-cloudfront/commands/DeleteDistributionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDistributionCommandInput = DeleteDistributionRequest; export type DeleteDistributionCommandOutput = __MetadataBearer; +/** + *

Delete a distribution.

+ */ export class DeleteDistributionCommand extends $Command< DeleteDistributionCommandInput, DeleteDistributionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteFieldLevelEncryptionConfigCommand.ts b/clients/client-cloudfront/commands/DeleteFieldLevelEncryptionConfigCommand.ts index 5f287350f40ae..3bb7eebdc5d65 100644 --- a/clients/client-cloudfront/commands/DeleteFieldLevelEncryptionConfigCommand.ts +++ b/clients/client-cloudfront/commands/DeleteFieldLevelEncryptionConfigCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFieldLevelEncryptionConfigCommandInput = DeleteFieldLevelEncryptionConfigRequest; export type DeleteFieldLevelEncryptionConfigCommandOutput = __MetadataBearer; +/** + *

Remove a field-level encryption configuration.

+ */ export class DeleteFieldLevelEncryptionConfigCommand extends $Command< DeleteFieldLevelEncryptionConfigCommandInput, DeleteFieldLevelEncryptionConfigCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFieldLevelEncryptionConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteFieldLevelEncryptionProfileCommand.ts b/clients/client-cloudfront/commands/DeleteFieldLevelEncryptionProfileCommand.ts index ca3c531906605..296b1e11991f2 100644 --- a/clients/client-cloudfront/commands/DeleteFieldLevelEncryptionProfileCommand.ts +++ b/clients/client-cloudfront/commands/DeleteFieldLevelEncryptionProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFieldLevelEncryptionProfileCommandInput = DeleteFieldLevelEncryptionProfileRequest; export type DeleteFieldLevelEncryptionProfileCommandOutput = __MetadataBearer; +/** + *

Remove a field-level encryption profile.

+ */ export class DeleteFieldLevelEncryptionProfileCommand extends $Command< DeleteFieldLevelEncryptionProfileCommandInput, DeleteFieldLevelEncryptionProfileCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFieldLevelEncryptionProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteKeyGroupCommand.ts b/clients/client-cloudfront/commands/DeleteKeyGroupCommand.ts index 30609875fae3d..c954247ceac72 100644 --- a/clients/client-cloudfront/commands/DeleteKeyGroupCommand.ts +++ b/clients/client-cloudfront/commands/DeleteKeyGroupCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteKeyGroupCommandInput = DeleteKeyGroupRequest; export type DeleteKeyGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a key group.

+ *

You cannot delete a key group that is referenced in a cache behavior. First update + * your distributions to remove the key group from all cache behaviors, then delete the key + * group.

+ *

To delete a key group, you must provide the key group’s identifier and version. To get + * these values, use ListKeyGroups followed by GetKeyGroup or + * GetKeyGroupConfig.

+ */ export class DeleteKeyGroupCommand extends $Command< DeleteKeyGroupCommandInput, DeleteKeyGroupCommandOutput, @@ -34,6 +43,9 @@ export class DeleteKeyGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteMonitoringSubscriptionCommand.ts b/clients/client-cloudfront/commands/DeleteMonitoringSubscriptionCommand.ts index aaf6fc6902fcf..c99846f2cad39 100644 --- a/clients/client-cloudfront/commands/DeleteMonitoringSubscriptionCommand.ts +++ b/clients/client-cloudfront/commands/DeleteMonitoringSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMonitoringSubscriptionCommandInput = DeleteMonitoringSubscriptionRequest; export type DeleteMonitoringSubscriptionCommandOutput = DeleteMonitoringSubscriptionResult & __MetadataBearer; +/** + *

Disables additional CloudWatch metrics for the specified CloudFront distribution.

+ */ export class DeleteMonitoringSubscriptionCommand extends $Command< DeleteMonitoringSubscriptionCommandInput, DeleteMonitoringSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMonitoringSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteOriginRequestPolicyCommand.ts b/clients/client-cloudfront/commands/DeleteOriginRequestPolicyCommand.ts index d34c671f59755..00db412647e5d 100644 --- a/clients/client-cloudfront/commands/DeleteOriginRequestPolicyCommand.ts +++ b/clients/client-cloudfront/commands/DeleteOriginRequestPolicyCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteOriginRequestPolicyCommandInput = DeleteOriginRequestPolicyRequest; export type DeleteOriginRequestPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes an origin request policy.

+ *

You cannot delete an origin request policy if it’s attached to any cache behaviors. First + * update your distributions to remove the origin request policy from all cache behaviors, + * then delete the origin request policy.

+ *

To delete an origin request policy, you must provide the policy’s identifier and version. To + * get the identifier, you can use ListOriginRequestPolicies or + * GetOriginRequestPolicy.

+ */ export class DeleteOriginRequestPolicyCommand extends $Command< DeleteOriginRequestPolicyCommandInput, DeleteOriginRequestPolicyCommandOutput, @@ -34,6 +43,9 @@ export class DeleteOriginRequestPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeletePublicKeyCommand.ts b/clients/client-cloudfront/commands/DeletePublicKeyCommand.ts index 86510d03b4397..585d36995840b 100644 --- a/clients/client-cloudfront/commands/DeletePublicKeyCommand.ts +++ b/clients/client-cloudfront/commands/DeletePublicKeyCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePublicKeyCommandInput = DeletePublicKeyRequest; export type DeletePublicKeyCommandOutput = __MetadataBearer; +/** + *

Remove a public key you previously added to CloudFront.

+ */ export class DeletePublicKeyCommand extends $Command< DeletePublicKeyCommandInput, DeletePublicKeyCommandOutput, @@ -34,6 +37,9 @@ export class DeletePublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteRealtimeLogConfigCommand.ts b/clients/client-cloudfront/commands/DeleteRealtimeLogConfigCommand.ts index 572a580033e3d..fc38362d33eb7 100644 --- a/clients/client-cloudfront/commands/DeleteRealtimeLogConfigCommand.ts +++ b/clients/client-cloudfront/commands/DeleteRealtimeLogConfigCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteRealtimeLogConfigCommandInput = DeleteRealtimeLogConfigRequest; export type DeleteRealtimeLogConfigCommandOutput = __MetadataBearer; +/** + *

Deletes a real-time log configuration.

+ *

You cannot delete a real-time log configuration if it’s attached to a cache behavior. + * First update your distributions to remove the real-time log configuration from all cache + * behaviors, then delete the real-time log configuration.

+ *

To delete a real-time log configuration, you can provide the configuration’s name or its + * Amazon Resource Name (ARN). You must provide at least one. If you provide both, CloudFront + * uses the name to identify the real-time log configuration to delete.

+ */ export class DeleteRealtimeLogConfigCommand extends $Command< DeleteRealtimeLogConfigCommandInput, DeleteRealtimeLogConfigCommandOutput, @@ -34,6 +43,9 @@ export class DeleteRealtimeLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/DeleteStreamingDistributionCommand.ts b/clients/client-cloudfront/commands/DeleteStreamingDistributionCommand.ts index c71a1c0f320c1..de5a3dfda727f 100644 --- a/clients/client-cloudfront/commands/DeleteStreamingDistributionCommand.ts +++ b/clients/client-cloudfront/commands/DeleteStreamingDistributionCommand.ts @@ -20,6 +20,56 @@ import { export type DeleteStreamingDistributionCommandInput = DeleteStreamingDistributionRequest; export type DeleteStreamingDistributionCommandOutput = __MetadataBearer; +/** + *

Delete a streaming distribution. To delete an RTMP distribution using the CloudFront API, + * perform the following steps.

+ * + *

+ * To delete an RTMP distribution using the CloudFront + * API:

+ *
    + *
  1. + *

    Disable the RTMP distribution.

    + *
  2. + *
  3. + *

    Submit a GET Streaming Distribution Config request to get the current + * configuration and the Etag header for the distribution.

    + *
  4. + *
  5. + *

    Update the XML document that was returned in the response to your GET + * Streaming Distribution Config request to change the value of Enabled + * to false.

    + *
  6. + *
  7. + *

    Submit a PUT Streaming Distribution Config request to update the + * configuration for your distribution. In the request body, include the XML document that + * you updated in Step 3. Then set the value of the HTTP If-Match header to the + * value of the ETag header that CloudFront returned when you submitted the GET + * Streaming Distribution Config request in Step 2.

    + *
  8. + *
  9. + *

    Review the response to the PUT Streaming Distribution Config request + * to confirm that the distribution was successfully disabled.

    + *
  10. + *
  11. + *

    Submit a GET Streaming Distribution Config request to confirm that + * your changes have propagated. When propagation is complete, the value of + * Status is Deployed.

    + *
  12. + *
  13. + *

    Submit a DELETE Streaming Distribution request. Set the value of the + * HTTP If-Match header to the value of the ETag header that CloudFront + * returned when you submitted the GET Streaming Distribution Config request in + * Step 2.

    + *
  14. + *
  15. + *

    Review the response to your DELETE Streaming Distribution request to + * confirm that the distribution was successfully deleted.

    + *
  16. + *
+ *

For information about deleting a distribution using the CloudFront console, see Deleting a Distribution in the + * Amazon CloudFront Developer Guide.

+ */ export class DeleteStreamingDistributionCommand extends $Command< DeleteStreamingDistributionCommandInput, DeleteStreamingDistributionCommandOutput, @@ -34,6 +84,9 @@ export class DeleteStreamingDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetCachePolicyCommand.ts b/clients/client-cloudfront/commands/GetCachePolicyCommand.ts index 9ae680b3e3745..2de7e0401b6dc 100644 --- a/clients/client-cloudfront/commands/GetCachePolicyCommand.ts +++ b/clients/client-cloudfront/commands/GetCachePolicyCommand.ts @@ -20,6 +20,22 @@ import { export type GetCachePolicyCommandInput = GetCachePolicyRequest; export type GetCachePolicyCommandOutput = GetCachePolicyResult & __MetadataBearer; +/** + *

Gets a cache policy, including the following metadata:

+ *
    + *
  • + *

    The policy’s identifier.

    + *
  • + *
  • + *

    The date and time when the policy was last modified.

    + *
  • + *
+ *

To get a cache policy, you must provide the policy’s identifier. If the cache policy is + * attached to a distribution’s cache behavior, you can get the policy’s identifier using + * ListDistributions or GetDistribution. If the cache policy is + * not attached to a cache behavior, you can get the identifier using + * ListCachePolicies.

+ */ export class GetCachePolicyCommand extends $Command< GetCachePolicyCommandInput, GetCachePolicyCommandOutput, @@ -34,6 +50,9 @@ export class GetCachePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetCachePolicyConfigCommand.ts b/clients/client-cloudfront/commands/GetCachePolicyConfigCommand.ts index 3c9deebbdcbf6..9081fc9b8935d 100644 --- a/clients/client-cloudfront/commands/GetCachePolicyConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetCachePolicyConfigCommand.ts @@ -20,6 +20,14 @@ import { export type GetCachePolicyConfigCommandInput = GetCachePolicyConfigRequest; export type GetCachePolicyConfigCommandOutput = GetCachePolicyConfigResult & __MetadataBearer; +/** + *

Gets a cache policy configuration.

+ *

To get a cache policy configuration, you must provide the policy’s identifier. If the cache + * policy is attached to a distribution’s cache behavior, you can get the policy’s + * identifier using ListDistributions or GetDistribution. If the + * cache policy is not attached to a cache behavior, you can get the identifier using + * ListCachePolicies.

+ */ export class GetCachePolicyConfigCommand extends $Command< GetCachePolicyConfigCommandInput, GetCachePolicyConfigCommandOutput, @@ -34,6 +42,9 @@ export class GetCachePolicyConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetCloudFrontOriginAccessIdentityCommand.ts b/clients/client-cloudfront/commands/GetCloudFrontOriginAccessIdentityCommand.ts index 9f965e12960ec..4c41ed08b7ad6 100644 --- a/clients/client-cloudfront/commands/GetCloudFrontOriginAccessIdentityCommand.ts +++ b/clients/client-cloudfront/commands/GetCloudFrontOriginAccessIdentityCommand.ts @@ -20,6 +20,9 @@ import { export type GetCloudFrontOriginAccessIdentityCommandInput = GetCloudFrontOriginAccessIdentityRequest; export type GetCloudFrontOriginAccessIdentityCommandOutput = GetCloudFrontOriginAccessIdentityResult & __MetadataBearer; +/** + *

Get the information about an origin access identity.

+ */ export class GetCloudFrontOriginAccessIdentityCommand extends $Command< GetCloudFrontOriginAccessIdentityCommandInput, GetCloudFrontOriginAccessIdentityCommandOutput, @@ -34,6 +37,9 @@ export class GetCloudFrontOriginAccessIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetCloudFrontOriginAccessIdentityConfigCommand.ts b/clients/client-cloudfront/commands/GetCloudFrontOriginAccessIdentityConfigCommand.ts index a7617c2158a18..311c10126dd7b 100644 --- a/clients/client-cloudfront/commands/GetCloudFrontOriginAccessIdentityConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetCloudFrontOriginAccessIdentityConfigCommand.ts @@ -24,6 +24,9 @@ export type GetCloudFrontOriginAccessIdentityConfigCommandInput = GetCloudFrontO export type GetCloudFrontOriginAccessIdentityConfigCommandOutput = GetCloudFrontOriginAccessIdentityConfigResult & __MetadataBearer; +/** + *

Get the configuration information about an origin access identity.

+ */ export class GetCloudFrontOriginAccessIdentityConfigCommand extends $Command< GetCloudFrontOriginAccessIdentityConfigCommandInput, GetCloudFrontOriginAccessIdentityConfigCommandOutput, @@ -38,6 +41,9 @@ export class GetCloudFrontOriginAccessIdentityConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetDistributionCommand.ts b/clients/client-cloudfront/commands/GetDistributionCommand.ts index 574b692d10f1f..e7f272a3cd271 100644 --- a/clients/client-cloudfront/commands/GetDistributionCommand.ts +++ b/clients/client-cloudfront/commands/GetDistributionCommand.ts @@ -20,6 +20,9 @@ import { export type GetDistributionCommandInput = GetDistributionRequest; export type GetDistributionCommandOutput = GetDistributionResult & __MetadataBearer; +/** + *

Get the information about a distribution.

+ */ export class GetDistributionCommand extends $Command< GetDistributionCommandInput, GetDistributionCommandOutput, @@ -34,6 +37,9 @@ export class GetDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetDistributionConfigCommand.ts b/clients/client-cloudfront/commands/GetDistributionConfigCommand.ts index 42c7a31d67ad6..cd327bfff0025 100644 --- a/clients/client-cloudfront/commands/GetDistributionConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetDistributionConfigCommand.ts @@ -20,6 +20,9 @@ import { export type GetDistributionConfigCommandInput = GetDistributionConfigRequest; export type GetDistributionConfigCommandOutput = GetDistributionConfigResult & __MetadataBearer; +/** + *

Get the configuration information about a distribution.

+ */ export class GetDistributionConfigCommand extends $Command< GetDistributionConfigCommandInput, GetDistributionConfigCommandOutput, @@ -34,6 +37,9 @@ export class GetDistributionConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetFieldLevelEncryptionCommand.ts b/clients/client-cloudfront/commands/GetFieldLevelEncryptionCommand.ts index 80ff006482af0..6451424fe8243 100644 --- a/clients/client-cloudfront/commands/GetFieldLevelEncryptionCommand.ts +++ b/clients/client-cloudfront/commands/GetFieldLevelEncryptionCommand.ts @@ -20,6 +20,9 @@ import { export type GetFieldLevelEncryptionCommandInput = GetFieldLevelEncryptionRequest; export type GetFieldLevelEncryptionCommandOutput = GetFieldLevelEncryptionResult & __MetadataBearer; +/** + *

Get the field-level encryption configuration information.

+ */ export class GetFieldLevelEncryptionCommand extends $Command< GetFieldLevelEncryptionCommandInput, GetFieldLevelEncryptionCommandOutput, @@ -34,6 +37,9 @@ export class GetFieldLevelEncryptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetFieldLevelEncryptionConfigCommand.ts b/clients/client-cloudfront/commands/GetFieldLevelEncryptionConfigCommand.ts index f1c0cdc668b9c..b394df1ddcb4a 100644 --- a/clients/client-cloudfront/commands/GetFieldLevelEncryptionConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetFieldLevelEncryptionConfigCommand.ts @@ -20,6 +20,9 @@ import { export type GetFieldLevelEncryptionConfigCommandInput = GetFieldLevelEncryptionConfigRequest; export type GetFieldLevelEncryptionConfigCommandOutput = GetFieldLevelEncryptionConfigResult & __MetadataBearer; +/** + *

Get the field-level encryption configuration information.

+ */ export class GetFieldLevelEncryptionConfigCommand extends $Command< GetFieldLevelEncryptionConfigCommandInput, GetFieldLevelEncryptionConfigCommandOutput, @@ -34,6 +37,9 @@ export class GetFieldLevelEncryptionConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetFieldLevelEncryptionProfileCommand.ts b/clients/client-cloudfront/commands/GetFieldLevelEncryptionProfileCommand.ts index 4c485fd222758..6fec28ac0af69 100644 --- a/clients/client-cloudfront/commands/GetFieldLevelEncryptionProfileCommand.ts +++ b/clients/client-cloudfront/commands/GetFieldLevelEncryptionProfileCommand.ts @@ -20,6 +20,9 @@ import { export type GetFieldLevelEncryptionProfileCommandInput = GetFieldLevelEncryptionProfileRequest; export type GetFieldLevelEncryptionProfileCommandOutput = GetFieldLevelEncryptionProfileResult & __MetadataBearer; +/** + *

Get the field-level encryption profile information.

+ */ export class GetFieldLevelEncryptionProfileCommand extends $Command< GetFieldLevelEncryptionProfileCommandInput, GetFieldLevelEncryptionProfileCommandOutput, @@ -34,6 +37,9 @@ export class GetFieldLevelEncryptionProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetFieldLevelEncryptionProfileConfigCommand.ts b/clients/client-cloudfront/commands/GetFieldLevelEncryptionProfileConfigCommand.ts index 0dcfb6bc22f9a..3b891f6e3b87d 100644 --- a/clients/client-cloudfront/commands/GetFieldLevelEncryptionProfileConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetFieldLevelEncryptionProfileConfigCommand.ts @@ -24,6 +24,9 @@ export type GetFieldLevelEncryptionProfileConfigCommandInput = GetFieldLevelEncr export type GetFieldLevelEncryptionProfileConfigCommandOutput = GetFieldLevelEncryptionProfileConfigResult & __MetadataBearer; +/** + *

Get the field-level encryption profile configuration information.

+ */ export class GetFieldLevelEncryptionProfileConfigCommand extends $Command< GetFieldLevelEncryptionProfileConfigCommandInput, GetFieldLevelEncryptionProfileConfigCommandOutput, @@ -38,6 +41,9 @@ export class GetFieldLevelEncryptionProfileConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetInvalidationCommand.ts b/clients/client-cloudfront/commands/GetInvalidationCommand.ts index 94f6c87964670..9a20d9346944d 100644 --- a/clients/client-cloudfront/commands/GetInvalidationCommand.ts +++ b/clients/client-cloudfront/commands/GetInvalidationCommand.ts @@ -20,6 +20,9 @@ import { export type GetInvalidationCommandInput = GetInvalidationRequest; export type GetInvalidationCommandOutput = GetInvalidationResult & __MetadataBearer; +/** + *

Get the information about an invalidation.

+ */ export class GetInvalidationCommand extends $Command< GetInvalidationCommandInput, GetInvalidationCommandOutput, @@ -34,6 +37,9 @@ export class GetInvalidationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetKeyGroupCommand.ts b/clients/client-cloudfront/commands/GetKeyGroupCommand.ts index ccc5435c70936..f7bb58ef8d197 100644 --- a/clients/client-cloudfront/commands/GetKeyGroupCommand.ts +++ b/clients/client-cloudfront/commands/GetKeyGroupCommand.ts @@ -20,6 +20,14 @@ import { export type GetKeyGroupCommandInput = GetKeyGroupRequest; export type GetKeyGroupCommandOutput = GetKeyGroupResult & __MetadataBearer; +/** + *

Gets a key group, including the date and time when the key group was last modified.

+ *

To get a key group, you must provide the key group’s identifier. If the key group is + * referenced in a distribution’s cache behavior, you can get the key group’s identifier + * using ListDistributions or GetDistribution. If the key group + * is not referenced in a cache behavior, you can get the identifier using + * ListKeyGroups.

+ */ export class GetKeyGroupCommand extends $Command< GetKeyGroupCommandInput, GetKeyGroupCommandOutput, @@ -34,6 +42,9 @@ export class GetKeyGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetKeyGroupConfigCommand.ts b/clients/client-cloudfront/commands/GetKeyGroupConfigCommand.ts index 632a0b4e460fa..cc0d3da2bc370 100644 --- a/clients/client-cloudfront/commands/GetKeyGroupConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetKeyGroupConfigCommand.ts @@ -20,6 +20,14 @@ import { export type GetKeyGroupConfigCommandInput = GetKeyGroupConfigRequest; export type GetKeyGroupConfigCommandOutput = GetKeyGroupConfigResult & __MetadataBearer; +/** + *

Gets a key group configuration.

+ *

To get a key group configuration, you must provide the key group’s identifier. If the + * key group is referenced in a distribution’s cache behavior, you can get the key group’s + * identifier using ListDistributions or GetDistribution. If the + * key group is not referenced in a cache behavior, you can get the identifier using + * ListKeyGroups.

+ */ export class GetKeyGroupConfigCommand extends $Command< GetKeyGroupConfigCommandInput, GetKeyGroupConfigCommandOutput, @@ -34,6 +42,9 @@ export class GetKeyGroupConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetMonitoringSubscriptionCommand.ts b/clients/client-cloudfront/commands/GetMonitoringSubscriptionCommand.ts index 45b9da8bd1571..27d4a4d010b13 100644 --- a/clients/client-cloudfront/commands/GetMonitoringSubscriptionCommand.ts +++ b/clients/client-cloudfront/commands/GetMonitoringSubscriptionCommand.ts @@ -20,6 +20,10 @@ import { export type GetMonitoringSubscriptionCommandInput = GetMonitoringSubscriptionRequest; export type GetMonitoringSubscriptionCommandOutput = GetMonitoringSubscriptionResult & __MetadataBearer; +/** + *

Gets information about whether additional CloudWatch metrics are enabled for the specified + * CloudFront distribution.

+ */ export class GetMonitoringSubscriptionCommand extends $Command< GetMonitoringSubscriptionCommandInput, GetMonitoringSubscriptionCommandOutput, @@ -34,6 +38,9 @@ export class GetMonitoringSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetOriginRequestPolicyCommand.ts b/clients/client-cloudfront/commands/GetOriginRequestPolicyCommand.ts index a92effa7c41d3..1daba08f29579 100644 --- a/clients/client-cloudfront/commands/GetOriginRequestPolicyCommand.ts +++ b/clients/client-cloudfront/commands/GetOriginRequestPolicyCommand.ts @@ -20,6 +20,22 @@ import { export type GetOriginRequestPolicyCommandInput = GetOriginRequestPolicyRequest; export type GetOriginRequestPolicyCommandOutput = GetOriginRequestPolicyResult & __MetadataBearer; +/** + *

Gets an origin request policy, including the following metadata:

+ *
    + *
  • + *

    The policy’s identifier.

    + *
  • + *
  • + *

    The date and time when the policy was last modified.

    + *
  • + *
+ *

To get an origin request policy, you must provide the policy’s identifier. If the origin + * request policy is attached to a distribution’s cache behavior, you can get the policy’s + * identifier using ListDistributions or GetDistribution. If the + * origin request policy is not attached to a cache behavior, you can get the identifier + * using ListOriginRequestPolicies.

+ */ export class GetOriginRequestPolicyCommand extends $Command< GetOriginRequestPolicyCommandInput, GetOriginRequestPolicyCommandOutput, @@ -34,6 +50,9 @@ export class GetOriginRequestPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetOriginRequestPolicyConfigCommand.ts b/clients/client-cloudfront/commands/GetOriginRequestPolicyConfigCommand.ts index 8a8677883052d..41ee166582188 100644 --- a/clients/client-cloudfront/commands/GetOriginRequestPolicyConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetOriginRequestPolicyConfigCommand.ts @@ -20,6 +20,15 @@ import { export type GetOriginRequestPolicyConfigCommandInput = GetOriginRequestPolicyConfigRequest; export type GetOriginRequestPolicyConfigCommandOutput = GetOriginRequestPolicyConfigResult & __MetadataBearer; +/** + *

Gets an origin request policy configuration.

+ *

To get an origin request policy configuration, you must provide the policy’s identifier. If + * the origin request policy is attached to a distribution’s cache behavior, you can get + * the policy’s identifier using ListDistributions or + * GetDistribution. If the origin request policy is not attached to a cache + * behavior, you can get the identifier using + * ListOriginRequestPolicies.

+ */ export class GetOriginRequestPolicyConfigCommand extends $Command< GetOriginRequestPolicyConfigCommandInput, GetOriginRequestPolicyConfigCommandOutput, @@ -34,6 +43,9 @@ export class GetOriginRequestPolicyConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetPublicKeyCommand.ts b/clients/client-cloudfront/commands/GetPublicKeyCommand.ts index 4dbf810aeaae6..fcb74ddc9b199 100644 --- a/clients/client-cloudfront/commands/GetPublicKeyCommand.ts +++ b/clients/client-cloudfront/commands/GetPublicKeyCommand.ts @@ -20,6 +20,9 @@ import { export type GetPublicKeyCommandInput = GetPublicKeyRequest; export type GetPublicKeyCommandOutput = GetPublicKeyResult & __MetadataBearer; +/** + *

Gets a public key.

+ */ export class GetPublicKeyCommand extends $Command< GetPublicKeyCommandInput, GetPublicKeyCommandOutput, @@ -34,6 +37,9 @@ export class GetPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetPublicKeyConfigCommand.ts b/clients/client-cloudfront/commands/GetPublicKeyConfigCommand.ts index 3fee5dca58ffb..3ff0277d7d27f 100644 --- a/clients/client-cloudfront/commands/GetPublicKeyConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetPublicKeyConfigCommand.ts @@ -20,6 +20,9 @@ import { export type GetPublicKeyConfigCommandInput = GetPublicKeyConfigRequest; export type GetPublicKeyConfigCommandOutput = GetPublicKeyConfigResult & __MetadataBearer; +/** + *

Gets a public key configuration.

+ */ export class GetPublicKeyConfigCommand extends $Command< GetPublicKeyConfigCommandInput, GetPublicKeyConfigCommandOutput, @@ -34,6 +37,9 @@ export class GetPublicKeyConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetRealtimeLogConfigCommand.ts b/clients/client-cloudfront/commands/GetRealtimeLogConfigCommand.ts index 7dffac16344db..f15436b0641cc 100644 --- a/clients/client-cloudfront/commands/GetRealtimeLogConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetRealtimeLogConfigCommand.ts @@ -21,6 +21,12 @@ import { export type GetRealtimeLogConfigCommandInput = GetRealtimeLogConfigRequest; export type GetRealtimeLogConfigCommandOutput = GetRealtimeLogConfigResult & __MetadataBearer; +/** + *

Gets a real-time log configuration.

+ *

To get a real-time log configuration, you can provide the configuration’s name or its Amazon + * Resource Name (ARN). You must provide at least one. If you provide both, CloudFront uses the + * name to identify the real-time log configuration to get.

+ */ export class GetRealtimeLogConfigCommand extends $Command< GetRealtimeLogConfigCommandInput, GetRealtimeLogConfigCommandOutput, @@ -35,6 +41,9 @@ export class GetRealtimeLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetStreamingDistributionCommand.ts b/clients/client-cloudfront/commands/GetStreamingDistributionCommand.ts index d26eb322047d0..7df78891e0755 100644 --- a/clients/client-cloudfront/commands/GetStreamingDistributionCommand.ts +++ b/clients/client-cloudfront/commands/GetStreamingDistributionCommand.ts @@ -20,6 +20,9 @@ import { export type GetStreamingDistributionCommandInput = GetStreamingDistributionRequest; export type GetStreamingDistributionCommandOutput = GetStreamingDistributionResult & __MetadataBearer; +/** + *

Gets information about a specified RTMP distribution, including the distribution configuration.

+ */ export class GetStreamingDistributionCommand extends $Command< GetStreamingDistributionCommandInput, GetStreamingDistributionCommandOutput, @@ -34,6 +37,9 @@ export class GetStreamingDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/GetStreamingDistributionConfigCommand.ts b/clients/client-cloudfront/commands/GetStreamingDistributionConfigCommand.ts index 9d412e7fac94c..6aa4156cdc353 100644 --- a/clients/client-cloudfront/commands/GetStreamingDistributionConfigCommand.ts +++ b/clients/client-cloudfront/commands/GetStreamingDistributionConfigCommand.ts @@ -20,6 +20,9 @@ import { export type GetStreamingDistributionConfigCommandInput = GetStreamingDistributionConfigRequest; export type GetStreamingDistributionConfigCommandOutput = GetStreamingDistributionConfigResult & __MetadataBearer; +/** + *

Get the configuration information about a streaming distribution.

+ */ export class GetStreamingDistributionConfigCommand extends $Command< GetStreamingDistributionConfigCommandInput, GetStreamingDistributionConfigCommandOutput, @@ -34,6 +37,9 @@ export class GetStreamingDistributionConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListCachePoliciesCommand.ts b/clients/client-cloudfront/commands/ListCachePoliciesCommand.ts index 004199d0587f4..0929ee4c7853f 100644 --- a/clients/client-cloudfront/commands/ListCachePoliciesCommand.ts +++ b/clients/client-cloudfront/commands/ListCachePoliciesCommand.ts @@ -20,6 +20,16 @@ import { export type ListCachePoliciesCommandInput = ListCachePoliciesRequest; export type ListCachePoliciesCommandOutput = ListCachePoliciesResult & __MetadataBearer; +/** + *

Gets a list of cache policies.

+ *

You can optionally apply a filter to return only the managed policies created by AWS, or + * only the custom policies created in your AWS account.

+ *

You can optionally specify the maximum number of items to receive in the response. If + * the total number of items in the list exceeds the maximum that you specify, or the + * default maximum, the response is paginated. To get the next page of items, send a + * subsequent request that specifies the NextMarker value from the current + * response as the Marker value in the subsequent request.

+ */ export class ListCachePoliciesCommand extends $Command< ListCachePoliciesCommandInput, ListCachePoliciesCommandOutput, @@ -34,6 +44,9 @@ export class ListCachePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListCloudFrontOriginAccessIdentitiesCommand.ts b/clients/client-cloudfront/commands/ListCloudFrontOriginAccessIdentitiesCommand.ts index 15a3f11195d58..3fa2c171e6997 100644 --- a/clients/client-cloudfront/commands/ListCloudFrontOriginAccessIdentitiesCommand.ts +++ b/clients/client-cloudfront/commands/ListCloudFrontOriginAccessIdentitiesCommand.ts @@ -24,6 +24,9 @@ export type ListCloudFrontOriginAccessIdentitiesCommandInput = ListCloudFrontOri export type ListCloudFrontOriginAccessIdentitiesCommandOutput = ListCloudFrontOriginAccessIdentitiesResult & __MetadataBearer; +/** + *

Lists origin access identities.

+ */ export class ListCloudFrontOriginAccessIdentitiesCommand extends $Command< ListCloudFrontOriginAccessIdentitiesCommandInput, ListCloudFrontOriginAccessIdentitiesCommandOutput, @@ -38,6 +41,9 @@ export class ListCloudFrontOriginAccessIdentitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListDistributionsByCachePolicyIdCommand.ts b/clients/client-cloudfront/commands/ListDistributionsByCachePolicyIdCommand.ts index b92bab470d207..b2ea4136492de 100644 --- a/clients/client-cloudfront/commands/ListDistributionsByCachePolicyIdCommand.ts +++ b/clients/client-cloudfront/commands/ListDistributionsByCachePolicyIdCommand.ts @@ -20,6 +20,15 @@ import { export type ListDistributionsByCachePolicyIdCommandInput = ListDistributionsByCachePolicyIdRequest; export type ListDistributionsByCachePolicyIdCommandOutput = ListDistributionsByCachePolicyIdResult & __MetadataBearer; +/** + *

Gets a list of distribution IDs for distributions that have a cache behavior that’s + * associated with the specified cache policy.

+ *

You can optionally specify the maximum number of items to receive in the response. If + * the total number of items in the list exceeds the maximum that you specify, or the + * default maximum, the response is paginated. To get the next page of items, send a + * subsequent request that specifies the NextMarker value from the current + * response as the Marker value in the subsequent request.

+ */ export class ListDistributionsByCachePolicyIdCommand extends $Command< ListDistributionsByCachePolicyIdCommandInput, ListDistributionsByCachePolicyIdCommandOutput, @@ -34,6 +43,9 @@ export class ListDistributionsByCachePolicyIdCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListDistributionsByKeyGroupCommand.ts b/clients/client-cloudfront/commands/ListDistributionsByKeyGroupCommand.ts index e64f4ee824f28..b565961ee4224 100644 --- a/clients/client-cloudfront/commands/ListDistributionsByKeyGroupCommand.ts +++ b/clients/client-cloudfront/commands/ListDistributionsByKeyGroupCommand.ts @@ -20,6 +20,15 @@ import { export type ListDistributionsByKeyGroupCommandInput = ListDistributionsByKeyGroupRequest; export type ListDistributionsByKeyGroupCommandOutput = ListDistributionsByKeyGroupResult & __MetadataBearer; +/** + *

Gets a list of distribution IDs for distributions that have a cache behavior that references + * the specified key group.

+ *

You can optionally specify the maximum number of items to receive in the response. If + * the total number of items in the list exceeds the maximum that you specify, or the + * default maximum, the response is paginated. To get the next page of items, send a + * subsequent request that specifies the NextMarker value from the current + * response as the Marker value in the subsequent request.

+ */ export class ListDistributionsByKeyGroupCommand extends $Command< ListDistributionsByKeyGroupCommandInput, ListDistributionsByKeyGroupCommandOutput, @@ -34,6 +43,9 @@ export class ListDistributionsByKeyGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListDistributionsByOriginRequestPolicyIdCommand.ts b/clients/client-cloudfront/commands/ListDistributionsByOriginRequestPolicyIdCommand.ts index 5b1243a8e3d4c..f57f7054c9cf9 100644 --- a/clients/client-cloudfront/commands/ListDistributionsByOriginRequestPolicyIdCommand.ts +++ b/clients/client-cloudfront/commands/ListDistributionsByOriginRequestPolicyIdCommand.ts @@ -24,6 +24,15 @@ export type ListDistributionsByOriginRequestPolicyIdCommandInput = ListDistribut export type ListDistributionsByOriginRequestPolicyIdCommandOutput = ListDistributionsByOriginRequestPolicyIdResult & __MetadataBearer; +/** + *

Gets a list of distribution IDs for distributions that have a cache behavior that’s + * associated with the specified origin request policy.

+ *

You can optionally specify the maximum number of items to receive in the response. If + * the total number of items in the list exceeds the maximum that you specify, or the + * default maximum, the response is paginated. To get the next page of items, send a + * subsequent request that specifies the NextMarker value from the current + * response as the Marker value in the subsequent request.

+ */ export class ListDistributionsByOriginRequestPolicyIdCommand extends $Command< ListDistributionsByOriginRequestPolicyIdCommandInput, ListDistributionsByOriginRequestPolicyIdCommandOutput, @@ -38,6 +47,9 @@ export class ListDistributionsByOriginRequestPolicyIdCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListDistributionsByRealtimeLogConfigCommand.ts b/clients/client-cloudfront/commands/ListDistributionsByRealtimeLogConfigCommand.ts index 795aad43f061d..1906c531ca888 100644 --- a/clients/client-cloudfront/commands/ListDistributionsByRealtimeLogConfigCommand.ts +++ b/clients/client-cloudfront/commands/ListDistributionsByRealtimeLogConfigCommand.ts @@ -24,6 +24,18 @@ export type ListDistributionsByRealtimeLogConfigCommandInput = ListDistributions export type ListDistributionsByRealtimeLogConfigCommandOutput = ListDistributionsByRealtimeLogConfigResult & __MetadataBearer; +/** + *

Gets a list of distributions that have a cache behavior that’s associated with the specified + * real-time log configuration.

+ *

You can specify the real-time log configuration by its name or its Amazon Resource Name + * (ARN). You must provide at least one. If you provide both, CloudFront uses the name to + * identify the real-time log configuration to list distributions for.

+ *

You can optionally specify the maximum number of items to receive in the response. If + * the total number of items in the list exceeds the maximum that you specify, or the + * default maximum, the response is paginated. To get the next page of items, send a + * subsequent request that specifies the NextMarker value from the current + * response as the Marker value in the subsequent request.

+ */ export class ListDistributionsByRealtimeLogConfigCommand extends $Command< ListDistributionsByRealtimeLogConfigCommandInput, ListDistributionsByRealtimeLogConfigCommandOutput, @@ -38,6 +50,9 @@ export class ListDistributionsByRealtimeLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListDistributionsByWebACLIdCommand.ts b/clients/client-cloudfront/commands/ListDistributionsByWebACLIdCommand.ts index b9a511890f2e4..3dd80a06d0a8a 100644 --- a/clients/client-cloudfront/commands/ListDistributionsByWebACLIdCommand.ts +++ b/clients/client-cloudfront/commands/ListDistributionsByWebACLIdCommand.ts @@ -20,6 +20,9 @@ import { export type ListDistributionsByWebACLIdCommandInput = ListDistributionsByWebACLIdRequest; export type ListDistributionsByWebACLIdCommandOutput = ListDistributionsByWebACLIdResult & __MetadataBearer; +/** + *

List the distributions that are associated with a specified AWS WAF web ACL.

+ */ export class ListDistributionsByWebACLIdCommand extends $Command< ListDistributionsByWebACLIdCommandInput, ListDistributionsByWebACLIdCommandOutput, @@ -34,6 +37,9 @@ export class ListDistributionsByWebACLIdCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListDistributionsCommand.ts b/clients/client-cloudfront/commands/ListDistributionsCommand.ts index aafb76a3fa05c..50b57b32517e3 100644 --- a/clients/client-cloudfront/commands/ListDistributionsCommand.ts +++ b/clients/client-cloudfront/commands/ListDistributionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDistributionsCommandInput = ListDistributionsRequest; export type ListDistributionsCommandOutput = ListDistributionsResult & __MetadataBearer; +/** + *

List CloudFront distributions.

+ */ export class ListDistributionsCommand extends $Command< ListDistributionsCommandInput, ListDistributionsCommandOutput, @@ -34,6 +37,9 @@ export class ListDistributionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListFieldLevelEncryptionConfigsCommand.ts b/clients/client-cloudfront/commands/ListFieldLevelEncryptionConfigsCommand.ts index 8c440dd71392d..9c38d3da2fca0 100644 --- a/clients/client-cloudfront/commands/ListFieldLevelEncryptionConfigsCommand.ts +++ b/clients/client-cloudfront/commands/ListFieldLevelEncryptionConfigsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFieldLevelEncryptionConfigsCommandInput = ListFieldLevelEncryptionConfigsRequest; export type ListFieldLevelEncryptionConfigsCommandOutput = ListFieldLevelEncryptionConfigsResult & __MetadataBearer; +/** + *

List all field-level encryption configurations that have been created in CloudFront for this account.

+ */ export class ListFieldLevelEncryptionConfigsCommand extends $Command< ListFieldLevelEncryptionConfigsCommandInput, ListFieldLevelEncryptionConfigsCommandOutput, @@ -34,6 +37,9 @@ export class ListFieldLevelEncryptionConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListFieldLevelEncryptionProfilesCommand.ts b/clients/client-cloudfront/commands/ListFieldLevelEncryptionProfilesCommand.ts index 73f8a8eb6b6c6..28c37be2f8052 100644 --- a/clients/client-cloudfront/commands/ListFieldLevelEncryptionProfilesCommand.ts +++ b/clients/client-cloudfront/commands/ListFieldLevelEncryptionProfilesCommand.ts @@ -20,6 +20,9 @@ import { export type ListFieldLevelEncryptionProfilesCommandInput = ListFieldLevelEncryptionProfilesRequest; export type ListFieldLevelEncryptionProfilesCommandOutput = ListFieldLevelEncryptionProfilesResult & __MetadataBearer; +/** + *

Request a list of field-level encryption profiles that have been created in CloudFront for this account.

+ */ export class ListFieldLevelEncryptionProfilesCommand extends $Command< ListFieldLevelEncryptionProfilesCommandInput, ListFieldLevelEncryptionProfilesCommandOutput, @@ -34,6 +37,9 @@ export class ListFieldLevelEncryptionProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListInvalidationsCommand.ts b/clients/client-cloudfront/commands/ListInvalidationsCommand.ts index df066ca5638d1..dd5b2e908d063 100644 --- a/clients/client-cloudfront/commands/ListInvalidationsCommand.ts +++ b/clients/client-cloudfront/commands/ListInvalidationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListInvalidationsCommandInput = ListInvalidationsRequest; export type ListInvalidationsCommandOutput = ListInvalidationsResult & __MetadataBearer; +/** + *

Lists invalidation batches.

+ */ export class ListInvalidationsCommand extends $Command< ListInvalidationsCommandInput, ListInvalidationsCommandOutput, @@ -34,6 +37,9 @@ export class ListInvalidationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListKeyGroupsCommand.ts b/clients/client-cloudfront/commands/ListKeyGroupsCommand.ts index e72c92a2d8e39..e08de36ffd762 100644 --- a/clients/client-cloudfront/commands/ListKeyGroupsCommand.ts +++ b/clients/client-cloudfront/commands/ListKeyGroupsCommand.ts @@ -20,6 +20,14 @@ import { export type ListKeyGroupsCommandInput = ListKeyGroupsRequest; export type ListKeyGroupsCommandOutput = ListKeyGroupsResult & __MetadataBearer; +/** + *

Gets a list of key groups.

+ *

You can optionally specify the maximum number of items to receive in the response. If + * the total number of items in the list exceeds the maximum that you specify, or the + * default maximum, the response is paginated. To get the next page of items, send a + * subsequent request that specifies the NextMarker value from the current + * response as the Marker value in the subsequent request.

+ */ export class ListKeyGroupsCommand extends $Command< ListKeyGroupsCommandInput, ListKeyGroupsCommandOutput, @@ -34,6 +42,9 @@ export class ListKeyGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListOriginRequestPoliciesCommand.ts b/clients/client-cloudfront/commands/ListOriginRequestPoliciesCommand.ts index 6c7c6586226f8..9b7c15f9635b0 100644 --- a/clients/client-cloudfront/commands/ListOriginRequestPoliciesCommand.ts +++ b/clients/client-cloudfront/commands/ListOriginRequestPoliciesCommand.ts @@ -20,6 +20,16 @@ import { export type ListOriginRequestPoliciesCommandInput = ListOriginRequestPoliciesRequest; export type ListOriginRequestPoliciesCommandOutput = ListOriginRequestPoliciesResult & __MetadataBearer; +/** + *

Gets a list of origin request policies.

+ *

You can optionally apply a filter to return only the managed policies created by AWS, or + * only the custom policies created in your AWS account.

+ *

You can optionally specify the maximum number of items to receive in the response. If + * the total number of items in the list exceeds the maximum that you specify, or the + * default maximum, the response is paginated. To get the next page of items, send a + * subsequent request that specifies the NextMarker value from the current + * response as the Marker value in the subsequent request.

+ */ export class ListOriginRequestPoliciesCommand extends $Command< ListOriginRequestPoliciesCommandInput, ListOriginRequestPoliciesCommandOutput, @@ -34,6 +44,9 @@ export class ListOriginRequestPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListPublicKeysCommand.ts b/clients/client-cloudfront/commands/ListPublicKeysCommand.ts index 2824ffb03441d..2e12a2cc37fd0 100644 --- a/clients/client-cloudfront/commands/ListPublicKeysCommand.ts +++ b/clients/client-cloudfront/commands/ListPublicKeysCommand.ts @@ -20,6 +20,9 @@ import { export type ListPublicKeysCommandInput = ListPublicKeysRequest; export type ListPublicKeysCommandOutput = ListPublicKeysResult & __MetadataBearer; +/** + *

List all public keys that have been added to CloudFront for this account.

+ */ export class ListPublicKeysCommand extends $Command< ListPublicKeysCommandInput, ListPublicKeysCommandOutput, @@ -34,6 +37,9 @@ export class ListPublicKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListRealtimeLogConfigsCommand.ts b/clients/client-cloudfront/commands/ListRealtimeLogConfigsCommand.ts index 2d752cfbe3d46..90a6dcdcf8e34 100644 --- a/clients/client-cloudfront/commands/ListRealtimeLogConfigsCommand.ts +++ b/clients/client-cloudfront/commands/ListRealtimeLogConfigsCommand.ts @@ -20,6 +20,14 @@ import { export type ListRealtimeLogConfigsCommandInput = ListRealtimeLogConfigsRequest; export type ListRealtimeLogConfigsCommandOutput = ListRealtimeLogConfigsResult & __MetadataBearer; +/** + *

Gets a list of real-time log configurations.

+ *

You can optionally specify the maximum number of items to receive in the response. If + * the total number of items in the list exceeds the maximum that you specify, or the + * default maximum, the response is paginated. To get the next page of items, send a + * subsequent request that specifies the NextMarker value from the current + * response as the Marker value in the subsequent request.

+ */ export class ListRealtimeLogConfigsCommand extends $Command< ListRealtimeLogConfigsCommandInput, ListRealtimeLogConfigsCommandOutput, @@ -34,6 +42,9 @@ export class ListRealtimeLogConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListStreamingDistributionsCommand.ts b/clients/client-cloudfront/commands/ListStreamingDistributionsCommand.ts index e28fe39dcf759..677f1635c3877 100644 --- a/clients/client-cloudfront/commands/ListStreamingDistributionsCommand.ts +++ b/clients/client-cloudfront/commands/ListStreamingDistributionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListStreamingDistributionsCommandInput = ListStreamingDistributionsRequest; export type ListStreamingDistributionsCommandOutput = ListStreamingDistributionsResult & __MetadataBearer; +/** + *

List streaming distributions.

+ */ export class ListStreamingDistributionsCommand extends $Command< ListStreamingDistributionsCommandInput, ListStreamingDistributionsCommandOutput, @@ -34,6 +37,9 @@ export class ListStreamingDistributionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/ListTagsForResourceCommand.ts b/clients/client-cloudfront/commands/ListTagsForResourceCommand.ts index d96d1036076b6..9ee061432e085 100644 --- a/clients/client-cloudfront/commands/ListTagsForResourceCommand.ts +++ b/clients/client-cloudfront/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResult & __MetadataBearer; +/** + *

List tags for a CloudFront resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/TagResourceCommand.ts b/clients/client-cloudfront/commands/TagResourceCommand.ts index 160ab11cac622..710fa012e2109 100644 --- a/clients/client-cloudfront/commands/TagResourceCommand.ts +++ b/clients/client-cloudfront/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Add tags to a CloudFront resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UntagResourceCommand.ts b/clients/client-cloudfront/commands/UntagResourceCommand.ts index 75b812c7b2ca4..2947a6f7af2d7 100644 --- a/clients/client-cloudfront/commands/UntagResourceCommand.ts +++ b/clients/client-cloudfront/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Remove tags from a CloudFront resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateCachePolicyCommand.ts b/clients/client-cloudfront/commands/UpdateCachePolicyCommand.ts index acbe33c84c19e..a42e7baf74432 100644 --- a/clients/client-cloudfront/commands/UpdateCachePolicyCommand.ts +++ b/clients/client-cloudfront/commands/UpdateCachePolicyCommand.ts @@ -20,6 +20,26 @@ import { export type UpdateCachePolicyCommandInput = UpdateCachePolicyRequest; export type UpdateCachePolicyCommandOutput = UpdateCachePolicyResult & __MetadataBearer; +/** + *

Updates a cache policy configuration.

+ *

When you update a cache policy configuration, all the fields are updated with the + * values provided in the request. You cannot update some fields independent of others. To + * update a cache policy configuration:

+ *
    + *
  1. + *

    Use GetCachePolicyConfig to get the current configuration.

    + *
  2. + *
  3. + *

    Locally modify the fields in the cache policy configuration that you want to + * update.

    + *
  4. + *
  5. + *

    Call UpdateCachePolicy by providing the entire cache policy + * configuration, including the fields that you modified and those that you + * didn’t.

    + *
  6. + *
+ */ export class UpdateCachePolicyCommand extends $Command< UpdateCachePolicyCommandInput, UpdateCachePolicyCommandOutput, @@ -34,6 +54,9 @@ export class UpdateCachePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateCloudFrontOriginAccessIdentityCommand.ts b/clients/client-cloudfront/commands/UpdateCloudFrontOriginAccessIdentityCommand.ts index 23aecd9e01c8a..142fa5ae44cbc 100644 --- a/clients/client-cloudfront/commands/UpdateCloudFrontOriginAccessIdentityCommand.ts +++ b/clients/client-cloudfront/commands/UpdateCloudFrontOriginAccessIdentityCommand.ts @@ -24,6 +24,9 @@ export type UpdateCloudFrontOriginAccessIdentityCommandInput = UpdateCloudFrontO export type UpdateCloudFrontOriginAccessIdentityCommandOutput = UpdateCloudFrontOriginAccessIdentityResult & __MetadataBearer; +/** + *

Update an origin access identity.

+ */ export class UpdateCloudFrontOriginAccessIdentityCommand extends $Command< UpdateCloudFrontOriginAccessIdentityCommandInput, UpdateCloudFrontOriginAccessIdentityCommandOutput, @@ -38,6 +41,9 @@ export class UpdateCloudFrontOriginAccessIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateDistributionCommand.ts b/clients/client-cloudfront/commands/UpdateDistributionCommand.ts index 19c515ed2cb61..1660865366ee6 100644 --- a/clients/client-cloudfront/commands/UpdateDistributionCommand.ts +++ b/clients/client-cloudfront/commands/UpdateDistributionCommand.ts @@ -20,6 +20,87 @@ import { export type UpdateDistributionCommandInput = UpdateDistributionRequest; export type UpdateDistributionCommandOutput = UpdateDistributionResult & __MetadataBearer; +/** + *

Updates the configuration for a web distribution.

+ * + *

When you update a distribution, there are more required fields than when you create a distribution. + * When you update your distribution by using this API action, follow the steps here to get the current configuration + * and then make your updates, to make sure that you include all of the required fields. To view a summary, + * see Required + * Fields for Create Distribution and Update Distribution in the Amazon CloudFront Developer Guide.

+ *
+ *

The update process includes getting the current distribution configuration, updating the XML document that is + * returned to make your changes, and then submitting an UpdateDistribution request to make the updates.

+ *

For information about updating a distribution using the CloudFront console instead, see + * Creating a + * Distribution in the Amazon CloudFront Developer Guide.

+ * + *

+ * To update a web distribution using the CloudFront API + *

+ *
    + *
  1. + *

    Submit a + * GetDistributionConfig + * request to get the current configuration and an Etag header + * for the distribution.

    + * + *

    If you update the distribution again, you must get a new Etag header.

    + *
    + *
  2. + *
  3. + *

    Update the XML document that was returned in the response to your GetDistributionConfig request to include + * your changes.

    + * + *

    When you edit the XML file, be aware of the following:

    + *
      + *
    • + *

      You must strip out the ETag parameter that is returned.

      + *
    • + *
    • + *

      Additional fields are required when you update a distribution. There may be fields included in the + * XML file for features that you haven't configured for your distribution. This is expected and required to + * successfully update the distribution.

      + *
    • + *
    • + *

      You can't change the value of CallerReference. If you try to change this value, CloudFront returns an + * IllegalUpdate error.

      + *
    • + *
    • + *

      The new configuration replaces the existing configuration; the values that you specify in an + * UpdateDistribution request are not merged into your existing configuration. When you add, delete, or + * replace values in an element that allows multiple values (for example, CNAME), you must specify all of the + * values that you want to appear in the updated distribution. In addition, + * you must update the corresponding Quantity element.

      + *
    • + *
    + *
    + *
  4. + *
  5. + *

    Submit an UpdateDistribution request to update the configuration for your distribution:

    + *
      + *
    • + *

      In the request body, include the XML document that you updated in Step 2. The request body must include an + * XML document with a DistributionConfig element.

      + *
    • + *
    • + *

      Set the value of the HTTP If-Match header to the value of the ETag header that CloudFront returned + * when you submitted the GetDistributionConfig request in Step 1.

      + *
    • + *
    + *
  6. + *
  7. + *

    Review the response to the UpdateDistribution request to confirm that the configuration was + * successfully updated.

    + *
  8. + *
  9. + *

    Optional: Submit a + * GetDistribution + * request to confirm that your changes have propagated. + * When propagation is complete, the value of Status is Deployed.

    + *
  10. + *
+ */ export class UpdateDistributionCommand extends $Command< UpdateDistributionCommandInput, UpdateDistributionCommandOutput, @@ -34,6 +115,9 @@ export class UpdateDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateFieldLevelEncryptionConfigCommand.ts b/clients/client-cloudfront/commands/UpdateFieldLevelEncryptionConfigCommand.ts index 6af55079b3d0b..a93ce6b998d36 100644 --- a/clients/client-cloudfront/commands/UpdateFieldLevelEncryptionConfigCommand.ts +++ b/clients/client-cloudfront/commands/UpdateFieldLevelEncryptionConfigCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFieldLevelEncryptionConfigCommandInput = UpdateFieldLevelEncryptionConfigRequest; export type UpdateFieldLevelEncryptionConfigCommandOutput = UpdateFieldLevelEncryptionConfigResult & __MetadataBearer; +/** + *

Update a field-level encryption configuration.

+ */ export class UpdateFieldLevelEncryptionConfigCommand extends $Command< UpdateFieldLevelEncryptionConfigCommandInput, UpdateFieldLevelEncryptionConfigCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFieldLevelEncryptionConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateFieldLevelEncryptionProfileCommand.ts b/clients/client-cloudfront/commands/UpdateFieldLevelEncryptionProfileCommand.ts index e7a723edc6483..44a519d777757 100644 --- a/clients/client-cloudfront/commands/UpdateFieldLevelEncryptionProfileCommand.ts +++ b/clients/client-cloudfront/commands/UpdateFieldLevelEncryptionProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFieldLevelEncryptionProfileCommandInput = UpdateFieldLevelEncryptionProfileRequest; export type UpdateFieldLevelEncryptionProfileCommandOutput = UpdateFieldLevelEncryptionProfileResult & __MetadataBearer; +/** + *

Update a field-level encryption profile.

+ */ export class UpdateFieldLevelEncryptionProfileCommand extends $Command< UpdateFieldLevelEncryptionProfileCommandInput, UpdateFieldLevelEncryptionProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFieldLevelEncryptionProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateKeyGroupCommand.ts b/clients/client-cloudfront/commands/UpdateKeyGroupCommand.ts index bb6276b2f31b6..024efcb5c940c 100644 --- a/clients/client-cloudfront/commands/UpdateKeyGroupCommand.ts +++ b/clients/client-cloudfront/commands/UpdateKeyGroupCommand.ts @@ -20,6 +20,26 @@ import { export type UpdateKeyGroupCommandInput = UpdateKeyGroupRequest; export type UpdateKeyGroupCommandOutput = UpdateKeyGroupResult & __MetadataBearer; +/** + *

Updates a key group.

+ *

When you update a key group, all the fields are updated with the values provided in + * the request. You cannot update some fields independent of others. To update a key + * group:

+ *
    + *
  1. + *

    Get the current key group with GetKeyGroup or + * GetKeyGroupConfig.

    + *
  2. + *
  3. + *

    Locally modify the fields in the key group that you want to update. For + * example, add or remove public key IDs.

    + *
  4. + *
  5. + *

    Call UpdateKeyGroup with the entire key group object, including + * the fields that you modified and those that you didn’t.

    + *
  6. + *
+ */ export class UpdateKeyGroupCommand extends $Command< UpdateKeyGroupCommandInput, UpdateKeyGroupCommandOutput, @@ -34,6 +54,9 @@ export class UpdateKeyGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateOriginRequestPolicyCommand.ts b/clients/client-cloudfront/commands/UpdateOriginRequestPolicyCommand.ts index 1612820df8886..c0fccddbe52c0 100644 --- a/clients/client-cloudfront/commands/UpdateOriginRequestPolicyCommand.ts +++ b/clients/client-cloudfront/commands/UpdateOriginRequestPolicyCommand.ts @@ -20,6 +20,26 @@ import { export type UpdateOriginRequestPolicyCommandInput = UpdateOriginRequestPolicyRequest; export type UpdateOriginRequestPolicyCommandOutput = UpdateOriginRequestPolicyResult & __MetadataBearer; +/** + *

Updates an origin request policy configuration.

+ *

When you update an origin request policy configuration, all the fields are updated + * with the values provided in the request. You cannot update some fields independent of + * others. To update an origin request policy configuration:

+ *
    + *
  1. + *

    Use GetOriginRequestPolicyConfig to get the current configuration.

    + *
  2. + *
  3. + *

    Locally modify the fields in the origin request policy configuration that you + * want to update.

    + *
  4. + *
  5. + *

    Call UpdateOriginRequestPolicy by providing the entire origin + * request policy configuration, including the fields that you modified and those + * that you didn’t.

    + *
  6. + *
+ */ export class UpdateOriginRequestPolicyCommand extends $Command< UpdateOriginRequestPolicyCommandInput, UpdateOriginRequestPolicyCommandOutput, @@ -34,6 +54,9 @@ export class UpdateOriginRequestPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdatePublicKeyCommand.ts b/clients/client-cloudfront/commands/UpdatePublicKeyCommand.ts index 33290e175d964..9df900d7efd7a 100644 --- a/clients/client-cloudfront/commands/UpdatePublicKeyCommand.ts +++ b/clients/client-cloudfront/commands/UpdatePublicKeyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePublicKeyCommandInput = UpdatePublicKeyRequest; export type UpdatePublicKeyCommandOutput = UpdatePublicKeyResult & __MetadataBearer; +/** + *

Update public key information. Note that the only value you can change is the comment.

+ */ export class UpdatePublicKeyCommand extends $Command< UpdatePublicKeyCommandInput, UpdatePublicKeyCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateRealtimeLogConfigCommand.ts b/clients/client-cloudfront/commands/UpdateRealtimeLogConfigCommand.ts index 23a03271d9afd..201dc996da901 100644 --- a/clients/client-cloudfront/commands/UpdateRealtimeLogConfigCommand.ts +++ b/clients/client-cloudfront/commands/UpdateRealtimeLogConfigCommand.ts @@ -20,6 +20,29 @@ import { export type UpdateRealtimeLogConfigCommandInput = UpdateRealtimeLogConfigRequest; export type UpdateRealtimeLogConfigCommandOutput = UpdateRealtimeLogConfigResult & __MetadataBearer; +/** + *

Updates a real-time log configuration.

+ *

When you update a real-time log configuration, all the parameters are updated with the + * values provided in the request. You cannot update some parameters independent of others. + * To update a real-time log configuration:

+ *
    + *
  1. + *

    Call GetRealtimeLogConfig to get the current real-time log + * configuration.

    + *
  2. + *
  3. + *

    Locally modify the parameters in the real-time log configuration that you want + * to update.

    + *
  4. + *
  5. + *

    Call this API (UpdateRealtimeLogConfig) by providing the entire + * real-time log configuration, including the parameters that you modified and + * those that you didn’t.

    + *
  6. + *
+ *

You cannot update a real-time log configuration’s Name or + * ARN.

+ */ export class UpdateRealtimeLogConfigCommand extends $Command< UpdateRealtimeLogConfigCommandInput, UpdateRealtimeLogConfigCommandOutput, @@ -34,6 +57,9 @@ export class UpdateRealtimeLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/commands/UpdateStreamingDistributionCommand.ts b/clients/client-cloudfront/commands/UpdateStreamingDistributionCommand.ts index 5ad199c6e4b68..180d40a90d401 100644 --- a/clients/client-cloudfront/commands/UpdateStreamingDistributionCommand.ts +++ b/clients/client-cloudfront/commands/UpdateStreamingDistributionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateStreamingDistributionCommandInput = UpdateStreamingDistributionRequest; export type UpdateStreamingDistributionCommandOutput = UpdateStreamingDistributionResult & __MetadataBearer; +/** + *

Update a streaming distribution.

+ */ export class UpdateStreamingDistributionCommand extends $Command< UpdateStreamingDistributionCommandInput, UpdateStreamingDistributionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateStreamingDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudFrontClientResolvedConfig, diff --git a/clients/client-cloudfront/package.json b/clients/client-cloudfront/package.json index 868800c476837..a4d699cf79556 100644 --- a/clients/client-cloudfront/package.json +++ b/clients/client-cloudfront/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudfront Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudfront/runtimeConfig.browser.ts b/clients/client-cloudfront/runtimeConfig.browser.ts index cac45634bab42..79f058717dd94 100644 --- a/clients/client-cloudfront/runtimeConfig.browser.ts +++ b/clients/client-cloudfront/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudFrontClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudfront/runtimeConfig.native.ts b/clients/client-cloudfront/runtimeConfig.native.ts index 2a152c429b9a1..9bc6666c384a5 100644 --- a/clients/client-cloudfront/runtimeConfig.native.ts +++ b/clients/client-cloudfront/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudFrontClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudfront/runtimeConfig.shared.ts b/clients/client-cloudfront/runtimeConfig.shared.ts index 33d3b2dee45d3..b4be48845831c 100644 --- a/clients/client-cloudfront/runtimeConfig.shared.ts +++ b/clients/client-cloudfront/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-05-31", disableHostPrefix: false, diff --git a/clients/client-cloudfront/runtimeConfig.ts b/clients/client-cloudfront/runtimeConfig.ts index 44e9b7d63f7f1..576ce1f413bac 100644 --- a/clients/client-cloudfront/runtimeConfig.ts +++ b/clients/client-cloudfront/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudFrontClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudfront/tsconfig.json b/clients/client-cloudfront/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudfront/tsconfig.json +++ b/clients/client-cloudfront/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudhsm-v2/commands/CopyBackupToRegionCommand.ts b/clients/client-cloudhsm-v2/commands/CopyBackupToRegionCommand.ts index 47563c2fd0d20..0381e4852992b 100644 --- a/clients/client-cloudhsm-v2/commands/CopyBackupToRegionCommand.ts +++ b/clients/client-cloudhsm-v2/commands/CopyBackupToRegionCommand.ts @@ -20,6 +20,9 @@ import { export type CopyBackupToRegionCommandInput = CopyBackupToRegionRequest; export type CopyBackupToRegionCommandOutput = CopyBackupToRegionResponse & __MetadataBearer; +/** + *

Copy an AWS CloudHSM cluster backup to a different region.

+ */ export class CopyBackupToRegionCommand extends $Command< CopyBackupToRegionCommandInput, CopyBackupToRegionCommandOutput, @@ -34,6 +37,9 @@ export class CopyBackupToRegionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/CreateClusterCommand.ts b/clients/client-cloudhsm-v2/commands/CreateClusterCommand.ts index ce685b80d9298..7a219fad21cde 100644 --- a/clients/client-cloudhsm-v2/commands/CreateClusterCommand.ts +++ b/clients/client-cloudhsm-v2/commands/CreateClusterCommand.ts @@ -20,6 +20,9 @@ import { export type CreateClusterCommandInput = CreateClusterRequest; export type CreateClusterCommandOutput = CreateClusterResponse & __MetadataBearer; +/** + *

Creates a new AWS CloudHSM cluster.

+ */ export class CreateClusterCommand extends $Command< CreateClusterCommandInput, CreateClusterCommandOutput, @@ -34,6 +37,9 @@ export class CreateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/CreateHsmCommand.ts b/clients/client-cloudhsm-v2/commands/CreateHsmCommand.ts index 223ee501acaa0..343f42c6579f8 100644 --- a/clients/client-cloudhsm-v2/commands/CreateHsmCommand.ts +++ b/clients/client-cloudhsm-v2/commands/CreateHsmCommand.ts @@ -17,6 +17,10 @@ import { export type CreateHsmCommandInput = CreateHsmRequest; export type CreateHsmCommandOutput = CreateHsmResponse & __MetadataBearer; +/** + *

Creates a new hardware security module (HSM) in the specified AWS CloudHSM + * cluster.

+ */ export class CreateHsmCommand extends $Command< CreateHsmCommandInput, CreateHsmCommandOutput, @@ -31,6 +35,9 @@ export class CreateHsmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/DeleteBackupCommand.ts b/clients/client-cloudhsm-v2/commands/DeleteBackupCommand.ts index ff42fbc256d52..27a270491fa99 100644 --- a/clients/client-cloudhsm-v2/commands/DeleteBackupCommand.ts +++ b/clients/client-cloudhsm-v2/commands/DeleteBackupCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteBackupCommandInput = DeleteBackupRequest; export type DeleteBackupCommandOutput = DeleteBackupResponse & __MetadataBearer; +/** + *

Deletes a specified AWS CloudHSM backup. A backup can be restored up to 7 days + * after the DeleteBackup request is made. For more information on restoring a backup, see + * RestoreBackup.

+ */ export class DeleteBackupCommand extends $Command< DeleteBackupCommandInput, DeleteBackupCommandOutput, @@ -34,6 +39,9 @@ export class DeleteBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/DeleteClusterCommand.ts b/clients/client-cloudhsm-v2/commands/DeleteClusterCommand.ts index cd543fb9dd356..a242705e18ae9 100644 --- a/clients/client-cloudhsm-v2/commands/DeleteClusterCommand.ts +++ b/clients/client-cloudhsm-v2/commands/DeleteClusterCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteClusterCommandInput = DeleteClusterRequest; export type DeleteClusterCommandOutput = DeleteClusterResponse & __MetadataBearer; +/** + *

Deletes the specified AWS CloudHSM cluster. Before you can delete a cluster, you must + * delete all HSMs in the cluster. To see if the cluster contains any HSMs, use DescribeClusters. To delete an HSM, use DeleteHsm.

+ */ export class DeleteClusterCommand extends $Command< DeleteClusterCommandInput, DeleteClusterCommandOutput, @@ -34,6 +38,9 @@ export class DeleteClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/DeleteHsmCommand.ts b/clients/client-cloudhsm-v2/commands/DeleteHsmCommand.ts index 968390fa2be8f..dc2e9095e67e5 100644 --- a/clients/client-cloudhsm-v2/commands/DeleteHsmCommand.ts +++ b/clients/client-cloudhsm-v2/commands/DeleteHsmCommand.ts @@ -17,6 +17,11 @@ import { export type DeleteHsmCommandInput = DeleteHsmRequest; export type DeleteHsmCommandOutput = DeleteHsmResponse & __MetadataBearer; +/** + *

Deletes the specified HSM. To specify an HSM, you can use its identifier (ID), the IP + * address of the HSM's elastic network interface (ENI), or the ID of the HSM's ENI. You need to + * specify only one of these values. To find these values, use DescribeClusters.

+ */ export class DeleteHsmCommand extends $Command< DeleteHsmCommandInput, DeleteHsmCommandOutput, @@ -31,6 +36,9 @@ export class DeleteHsmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/DescribeBackupsCommand.ts b/clients/client-cloudhsm-v2/commands/DescribeBackupsCommand.ts index 541827bcb58e4..7be737ed59d49 100644 --- a/clients/client-cloudhsm-v2/commands/DescribeBackupsCommand.ts +++ b/clients/client-cloudhsm-v2/commands/DescribeBackupsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeBackupsCommandInput = DescribeBackupsRequest; export type DescribeBackupsCommandOutput = DescribeBackupsResponse & __MetadataBearer; +/** + *

Gets information about backups of AWS CloudHSM clusters.

+ *

This is a paginated operation, which means that each response might contain only a + * subset of all the backups. When the response contains only a subset of backups, it includes a + * NextToken value. Use this value in a subsequent DescribeBackups + * request to get more backups. When you receive a response with no NextToken (or an + * empty or null value), that means there are no more backups to get.

+ */ export class DescribeBackupsCommand extends $Command< DescribeBackupsCommandInput, DescribeBackupsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeBackupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/DescribeClustersCommand.ts b/clients/client-cloudhsm-v2/commands/DescribeClustersCommand.ts index cfb3cec0b2b1e..80cac596455cf 100644 --- a/clients/client-cloudhsm-v2/commands/DescribeClustersCommand.ts +++ b/clients/client-cloudhsm-v2/commands/DescribeClustersCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeClustersCommandInput = DescribeClustersRequest; export type DescribeClustersCommandOutput = DescribeClustersResponse & __MetadataBearer; +/** + *

Gets information about AWS CloudHSM clusters.

+ *

This is a paginated operation, which means that each response might contain only a + * subset of all the clusters. When the response contains only a subset of clusters, it includes + * a NextToken value. Use this value in a subsequent DescribeClusters + * request to get more clusters. When you receive a response with no NextToken (or + * an empty or null value), that means there are no more clusters to get.

+ */ export class DescribeClustersCommand extends $Command< DescribeClustersCommandInput, DescribeClustersCommandOutput, @@ -34,6 +42,9 @@ export class DescribeClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/InitializeClusterCommand.ts b/clients/client-cloudhsm-v2/commands/InitializeClusterCommand.ts index c1083bca81aaf..a069f865d0c0c 100644 --- a/clients/client-cloudhsm-v2/commands/InitializeClusterCommand.ts +++ b/clients/client-cloudhsm-v2/commands/InitializeClusterCommand.ts @@ -20,6 +20,12 @@ import { export type InitializeClusterCommandInput = InitializeClusterRequest; export type InitializeClusterCommandOutput = InitializeClusterResponse & __MetadataBearer; +/** + *

Claims an AWS CloudHSM cluster by submitting the cluster certificate issued by your + * issuing certificate authority (CA) and the CA's root certificate. Before you can claim a + * cluster, you must sign the cluster's certificate signing request (CSR) with your issuing CA. + * To get the cluster's CSR, use DescribeClusters.

+ */ export class InitializeClusterCommand extends $Command< InitializeClusterCommandInput, InitializeClusterCommandOutput, @@ -34,6 +40,9 @@ export class InitializeClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/ListTagsCommand.ts b/clients/client-cloudhsm-v2/commands/ListTagsCommand.ts index bc642412ac616..46e40e5aa8d64 100644 --- a/clients/client-cloudhsm-v2/commands/ListTagsCommand.ts +++ b/clients/client-cloudhsm-v2/commands/ListTagsCommand.ts @@ -17,6 +17,14 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResponse & __MetadataBearer; +/** + *

Gets a list of tags for the specified AWS CloudHSM cluster.

+ *

This is a paginated operation, which means that each response might contain only a + * subset of all the tags. When the response contains only a subset of tags, it includes a + * NextToken value. Use this value in a subsequent ListTags request to + * get more tags. When you receive a response with no NextToken (or an empty or null + * value), that means there are no more tags to get.

+ */ export class ListTagsCommand extends $Command< ListTagsCommandInput, ListTagsCommandOutput, @@ -31,6 +39,9 @@ export class ListTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/RestoreBackupCommand.ts b/clients/client-cloudhsm-v2/commands/RestoreBackupCommand.ts index 4dac7c2766546..6ed1d0479a66b 100644 --- a/clients/client-cloudhsm-v2/commands/RestoreBackupCommand.ts +++ b/clients/client-cloudhsm-v2/commands/RestoreBackupCommand.ts @@ -20,6 +20,11 @@ import { export type RestoreBackupCommandInput = RestoreBackupRequest; export type RestoreBackupCommandOutput = RestoreBackupResponse & __MetadataBearer; +/** + *

Restores a specified AWS CloudHSM backup that is in the + * PENDING_DELETION state. For mor information on deleting a backup, see + * DeleteBackup.

+ */ export class RestoreBackupCommand extends $Command< RestoreBackupCommandInput, RestoreBackupCommandOutput, @@ -34,6 +39,9 @@ export class RestoreBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/TagResourceCommand.ts b/clients/client-cloudhsm-v2/commands/TagResourceCommand.ts index 8a2b1a0aa78c0..c9b5f90b55f9c 100644 --- a/clients/client-cloudhsm-v2/commands/TagResourceCommand.ts +++ b/clients/client-cloudhsm-v2/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds or overwrites one or more tags for the specified AWS CloudHSM cluster.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/commands/UntagResourceCommand.ts b/clients/client-cloudhsm-v2/commands/UntagResourceCommand.ts index ed3aade48e9e3..e692198f1e5c6 100644 --- a/clients/client-cloudhsm-v2/commands/UntagResourceCommand.ts +++ b/clients/client-cloudhsm-v2/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the specified tag or tags from the specified AWS CloudHSM cluster.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMV2ClientResolvedConfig, diff --git a/clients/client-cloudhsm-v2/package.json b/clients/client-cloudhsm-v2/package.json index 30e633c0afca9..00dd6d471a51a 100644 --- a/clients/client-cloudhsm-v2/package.json +++ b/clients/client-cloudhsm-v2/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudhsm V2 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudhsm-v2/pagination/DescribeBackupsPaginator.ts b/clients/client-cloudhsm-v2/pagination/DescribeBackupsPaginator.ts index 79fa1cb429263..99d0664c7787d 100644 --- a/clients/client-cloudhsm-v2/pagination/DescribeBackupsPaginator.ts +++ b/clients/client-cloudhsm-v2/pagination/DescribeBackupsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudHSMV2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudHSMV2Client, input: DescribeBackupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBackupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudHSMV2, input: DescribeBackupsCommandInput, diff --git a/clients/client-cloudhsm-v2/pagination/DescribeClustersPaginator.ts b/clients/client-cloudhsm-v2/pagination/DescribeClustersPaginator.ts index 5495a2a923ebe..49a41d366656c 100644 --- a/clients/client-cloudhsm-v2/pagination/DescribeClustersPaginator.ts +++ b/clients/client-cloudhsm-v2/pagination/DescribeClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudHSMV2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudHSMV2Client, input: DescribeClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudHSMV2, input: DescribeClustersCommandInput, diff --git a/clients/client-cloudhsm-v2/pagination/ListTagsPaginator.ts b/clients/client-cloudhsm-v2/pagination/ListTagsPaginator.ts index 7baf2c1740868..ea389fc40b43f 100644 --- a/clients/client-cloudhsm-v2/pagination/ListTagsPaginator.ts +++ b/clients/client-cloudhsm-v2/pagination/ListTagsPaginator.ts @@ -4,6 +4,9 @@ import { ListTagsCommand, ListTagsCommandInput, ListTagsCommandOutput } from ".. import { CloudHSMV2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudHSMV2Client, input: ListTagsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudHSMV2, input: ListTagsCommandInput, diff --git a/clients/client-cloudhsm-v2/runtimeConfig.browser.ts b/clients/client-cloudhsm-v2/runtimeConfig.browser.ts index c351066a9e81c..de1cdd196e235 100644 --- a/clients/client-cloudhsm-v2/runtimeConfig.browser.ts +++ b/clients/client-cloudhsm-v2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudHSMV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudhsm-v2/runtimeConfig.native.ts b/clients/client-cloudhsm-v2/runtimeConfig.native.ts index cabfac1ba4404..de306dbe83369 100644 --- a/clients/client-cloudhsm-v2/runtimeConfig.native.ts +++ b/clients/client-cloudhsm-v2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudHSMV2Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudhsm-v2/runtimeConfig.shared.ts b/clients/client-cloudhsm-v2/runtimeConfig.shared.ts index e1c13d6657936..67abeb062e062 100644 --- a/clients/client-cloudhsm-v2/runtimeConfig.shared.ts +++ b/clients/client-cloudhsm-v2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-04-28", disableHostPrefix: false, diff --git a/clients/client-cloudhsm-v2/runtimeConfig.ts b/clients/client-cloudhsm-v2/runtimeConfig.ts index 2d2fc1dd3cce6..58ad9e65a94e5 100644 --- a/clients/client-cloudhsm-v2/runtimeConfig.ts +++ b/clients/client-cloudhsm-v2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudHSMV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudhsm-v2/tsconfig.json b/clients/client-cloudhsm-v2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudhsm-v2/tsconfig.json +++ b/clients/client-cloudhsm-v2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudhsm/commands/AddTagsToResourceCommand.ts b/clients/client-cloudhsm/commands/AddTagsToResourceCommand.ts index 70f3c937c7180..5ea1598af3722 100644 --- a/clients/client-cloudhsm/commands/AddTagsToResourceCommand.ts +++ b/clients/client-cloudhsm/commands/AddTagsToResourceCommand.ts @@ -20,6 +20,21 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceRequest; export type AddTagsToResourceCommandOutput = AddTagsToResourceResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Adds or overwrites one or more tags for the specified AWS CloudHSM resource.

+ *

Each tag consists of a key and a value. Tag keys must be unique to each + * resource.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -34,6 +49,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/CreateHapgCommand.ts b/clients/client-cloudhsm/commands/CreateHapgCommand.ts index b224f8d31a128..685383a3f7352 100644 --- a/clients/client-cloudhsm/commands/CreateHapgCommand.ts +++ b/clients/client-cloudhsm/commands/CreateHapgCommand.ts @@ -20,6 +20,20 @@ import { export type CreateHapgCommandInput = CreateHapgRequest; export type CreateHapgCommandOutput = CreateHapgResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Creates a high-availability partition group. A high-availability partition group is a + * group of partitions that spans multiple physical HSMs.

+ */ export class CreateHapgCommand extends $Command< CreateHapgCommandInput, CreateHapgCommandOutput, @@ -34,6 +48,9 @@ export class CreateHapgCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/CreateHsmCommand.ts b/clients/client-cloudhsm/commands/CreateHsmCommand.ts index ca6b11808ae2f..4a58b1ca4406b 100644 --- a/clients/client-cloudhsm/commands/CreateHsmCommand.ts +++ b/clients/client-cloudhsm/commands/CreateHsmCommand.ts @@ -17,6 +17,28 @@ import { export type CreateHsmCommandInput = CreateHsmRequest; export type CreateHsmCommandOutput = CreateHsmResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Creates an uninitialized HSM instance.

+ *

There is an upfront fee charged for each HSM instance that you create with the + * CreateHsm operation. If you accidentally provision an HSM and want to request a + * refund, delete the instance using the DeleteHsm operation, go to the AWS Support Center, create a new case, and select + * Account and Billing Support.

+ * + *

It can take up to 20 minutes to create and provision an HSM. You can monitor the + * status of the HSM with the DescribeHsm operation. The HSM is ready to be + * initialized when the status changes to RUNNING.

+ *
+ */ export class CreateHsmCommand extends $Command< CreateHsmCommandInput, CreateHsmCommandOutput, @@ -31,6 +53,9 @@ export class CreateHsmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/CreateLunaClientCommand.ts b/clients/client-cloudhsm/commands/CreateLunaClientCommand.ts index a56b56fb5bacd..70845e9a0afaf 100644 --- a/clients/client-cloudhsm/commands/CreateLunaClientCommand.ts +++ b/clients/client-cloudhsm/commands/CreateLunaClientCommand.ts @@ -20,6 +20,19 @@ import { export type CreateLunaClientCommandInput = CreateLunaClientRequest; export type CreateLunaClientCommandOutput = CreateLunaClientResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Creates an HSM client.

+ */ export class CreateLunaClientCommand extends $Command< CreateLunaClientCommandInput, CreateLunaClientCommandOutput, @@ -34,6 +47,9 @@ export class CreateLunaClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/DeleteHapgCommand.ts b/clients/client-cloudhsm/commands/DeleteHapgCommand.ts index 995b1ec0e262c..b20ebb2a380bf 100644 --- a/clients/client-cloudhsm/commands/DeleteHapgCommand.ts +++ b/clients/client-cloudhsm/commands/DeleteHapgCommand.ts @@ -20,6 +20,19 @@ import { export type DeleteHapgCommandInput = DeleteHapgRequest; export type DeleteHapgCommandOutput = DeleteHapgResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Deletes a high-availability partition group.

+ */ export class DeleteHapgCommand extends $Command< DeleteHapgCommandInput, DeleteHapgCommandOutput, @@ -34,6 +47,9 @@ export class DeleteHapgCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/DeleteHsmCommand.ts b/clients/client-cloudhsm/commands/DeleteHsmCommand.ts index d11b4e769b27b..db1df610dc8e3 100644 --- a/clients/client-cloudhsm/commands/DeleteHsmCommand.ts +++ b/clients/client-cloudhsm/commands/DeleteHsmCommand.ts @@ -17,6 +17,20 @@ import { export type DeleteHsmCommandInput = DeleteHsmRequest; export type DeleteHsmCommandOutput = DeleteHsmResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Deletes an HSM. After completion, this operation cannot be undone and your key material + * cannot be recovered.

+ */ export class DeleteHsmCommand extends $Command< DeleteHsmCommandInput, DeleteHsmCommandOutput, @@ -31,6 +45,9 @@ export class DeleteHsmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/DeleteLunaClientCommand.ts b/clients/client-cloudhsm/commands/DeleteLunaClientCommand.ts index ea0a1b2a49623..350f9c75d47b2 100644 --- a/clients/client-cloudhsm/commands/DeleteLunaClientCommand.ts +++ b/clients/client-cloudhsm/commands/DeleteLunaClientCommand.ts @@ -20,6 +20,19 @@ import { export type DeleteLunaClientCommandInput = DeleteLunaClientRequest; export type DeleteLunaClientCommandOutput = DeleteLunaClientResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Deletes a client.

+ */ export class DeleteLunaClientCommand extends $Command< DeleteLunaClientCommandInput, DeleteLunaClientCommandOutput, @@ -34,6 +47,9 @@ export class DeleteLunaClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/DescribeHapgCommand.ts b/clients/client-cloudhsm/commands/DescribeHapgCommand.ts index 8c1f396bf170a..0829ddb176be5 100644 --- a/clients/client-cloudhsm/commands/DescribeHapgCommand.ts +++ b/clients/client-cloudhsm/commands/DescribeHapgCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeHapgCommandInput = DescribeHapgRequest; export type DescribeHapgCommandOutput = DescribeHapgResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Retrieves information about a high-availability partition group.

+ */ export class DescribeHapgCommand extends $Command< DescribeHapgCommandInput, DescribeHapgCommandOutput, @@ -34,6 +47,9 @@ export class DescribeHapgCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/DescribeHsmCommand.ts b/clients/client-cloudhsm/commands/DescribeHsmCommand.ts index 4f451c1324265..84ccc7c049fd3 100644 --- a/clients/client-cloudhsm/commands/DescribeHsmCommand.ts +++ b/clients/client-cloudhsm/commands/DescribeHsmCommand.ts @@ -20,6 +20,20 @@ import { export type DescribeHsmCommandInput = DescribeHsmRequest; export type DescribeHsmCommandOutput = DescribeHsmResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Retrieves information about an HSM. You can identify the HSM by its ARN or its serial + * number.

+ */ export class DescribeHsmCommand extends $Command< DescribeHsmCommandInput, DescribeHsmCommandOutput, @@ -34,6 +48,9 @@ export class DescribeHsmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/DescribeLunaClientCommand.ts b/clients/client-cloudhsm/commands/DescribeLunaClientCommand.ts index 08be14ee29a87..2857da702bfe7 100644 --- a/clients/client-cloudhsm/commands/DescribeLunaClientCommand.ts +++ b/clients/client-cloudhsm/commands/DescribeLunaClientCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeLunaClientCommandInput = DescribeLunaClientRequest; export type DescribeLunaClientCommandOutput = DescribeLunaClientResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Retrieves information about an HSM client.

+ */ export class DescribeLunaClientCommand extends $Command< DescribeLunaClientCommandInput, DescribeLunaClientCommandOutput, @@ -34,6 +47,9 @@ export class DescribeLunaClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/GetConfigCommand.ts b/clients/client-cloudhsm/commands/GetConfigCommand.ts index 50c931a06c7de..27dd4bd510971 100644 --- a/clients/client-cloudhsm/commands/GetConfigCommand.ts +++ b/clients/client-cloudhsm/commands/GetConfigCommand.ts @@ -17,6 +17,20 @@ import { export type GetConfigCommandInput = GetConfigRequest; export type GetConfigCommandOutput = GetConfigResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Gets the configuration files necessary to connect to all high availability partition + * groups the client is associated with.

+ */ export class GetConfigCommand extends $Command< GetConfigCommandInput, GetConfigCommandOutput, @@ -31,6 +45,9 @@ export class GetConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/ListAvailableZonesCommand.ts b/clients/client-cloudhsm/commands/ListAvailableZonesCommand.ts index bfc477d1373ae..724e0173be08e 100644 --- a/clients/client-cloudhsm/commands/ListAvailableZonesCommand.ts +++ b/clients/client-cloudhsm/commands/ListAvailableZonesCommand.ts @@ -20,6 +20,19 @@ import { export type ListAvailableZonesCommandInput = ListAvailableZonesRequest; export type ListAvailableZonesCommandOutput = ListAvailableZonesResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Lists the Availability Zones that have available AWS CloudHSM capacity.

+ */ export class ListAvailableZonesCommand extends $Command< ListAvailableZonesCommandInput, ListAvailableZonesCommandOutput, @@ -34,6 +47,9 @@ export class ListAvailableZonesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/ListHapgsCommand.ts b/clients/client-cloudhsm/commands/ListHapgsCommand.ts index 2885041077f50..cde535b05fbeb 100644 --- a/clients/client-cloudhsm/commands/ListHapgsCommand.ts +++ b/clients/client-cloudhsm/commands/ListHapgsCommand.ts @@ -17,6 +17,23 @@ import { export type ListHapgsCommandInput = ListHapgsRequest; export type ListHapgsCommandOutput = ListHapgsResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Lists the high-availability partition groups for the account.

+ *

This operation supports pagination with the use of the NextToken member. + * If more results are available, the NextToken member of the response contains a + * token that you pass in the next call to ListHapgs to retrieve the next set of + * items.

+ */ export class ListHapgsCommand extends $Command< ListHapgsCommandInput, ListHapgsCommandOutput, @@ -31,6 +48,9 @@ export class ListHapgsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/ListHsmsCommand.ts b/clients/client-cloudhsm/commands/ListHsmsCommand.ts index dde367d78b70d..616314875c243 100644 --- a/clients/client-cloudhsm/commands/ListHsmsCommand.ts +++ b/clients/client-cloudhsm/commands/ListHsmsCommand.ts @@ -17,6 +17,24 @@ import { export type ListHsmsCommandInput = ListHsmsRequest; export type ListHsmsCommandOutput = ListHsmsResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Retrieves the identifiers of all of the HSMs provisioned for the current + * customer.

+ *

This operation supports pagination with the use of the NextToken member. + * If more results are available, the NextToken member of the response contains a + * token that you pass in the next call to ListHsms to retrieve the next set of + * items.

+ */ export class ListHsmsCommand extends $Command< ListHsmsCommandInput, ListHsmsCommandOutput, @@ -31,6 +49,9 @@ export class ListHsmsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/ListLunaClientsCommand.ts b/clients/client-cloudhsm/commands/ListLunaClientsCommand.ts index 4db15ed452f48..389ed2c7a65f4 100644 --- a/clients/client-cloudhsm/commands/ListLunaClientsCommand.ts +++ b/clients/client-cloudhsm/commands/ListLunaClientsCommand.ts @@ -20,6 +20,23 @@ import { export type ListLunaClientsCommandInput = ListLunaClientsRequest; export type ListLunaClientsCommandOutput = ListLunaClientsResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Lists all of the clients.

+ *

This operation supports pagination with the use of the NextToken member. + * If more results are available, the NextToken member of the response contains a + * token that you pass in the next call to ListLunaClients to retrieve the next set + * of items.

+ */ export class ListLunaClientsCommand extends $Command< ListLunaClientsCommandInput, ListLunaClientsCommandOutput, @@ -34,6 +51,9 @@ export class ListLunaClientsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/ListTagsForResourceCommand.ts b/clients/client-cloudhsm/commands/ListTagsForResourceCommand.ts index 75f331c553e1e..e7893cae99649 100644 --- a/clients/client-cloudhsm/commands/ListTagsForResourceCommand.ts +++ b/clients/client-cloudhsm/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,19 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Returns a list of all tags for the specified AWS CloudHSM resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +47,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/ModifyHapgCommand.ts b/clients/client-cloudhsm/commands/ModifyHapgCommand.ts index 6010e7ad51724..1f31d68f79cf3 100644 --- a/clients/client-cloudhsm/commands/ModifyHapgCommand.ts +++ b/clients/client-cloudhsm/commands/ModifyHapgCommand.ts @@ -20,6 +20,19 @@ import { export type ModifyHapgCommandInput = ModifyHapgRequest; export type ModifyHapgCommandOutput = ModifyHapgResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Modifies an existing high-availability partition group.

+ */ export class ModifyHapgCommand extends $Command< ModifyHapgCommandInput, ModifyHapgCommandOutput, @@ -34,6 +47,9 @@ export class ModifyHapgCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/ModifyHsmCommand.ts b/clients/client-cloudhsm/commands/ModifyHsmCommand.ts index 1f15367b83290..ddd54c42ddddc 100644 --- a/clients/client-cloudhsm/commands/ModifyHsmCommand.ts +++ b/clients/client-cloudhsm/commands/ModifyHsmCommand.ts @@ -17,6 +17,25 @@ import { export type ModifyHsmCommandInput = ModifyHsmRequest; export type ModifyHsmCommandOutput = ModifyHsmResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Modifies an HSM.

+ * + *

This operation can result in the HSM being offline for up to 15 minutes while the AWS + * CloudHSM service is reconfigured. If you are modifying a production HSM, you should ensure + * that your AWS CloudHSM service is configured for high availability, and consider executing this + * operation during a maintenance window.

+ *
+ */ export class ModifyHsmCommand extends $Command< ModifyHsmCommandInput, ModifyHsmCommandOutput, @@ -31,6 +50,9 @@ export class ModifyHsmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/ModifyLunaClientCommand.ts b/clients/client-cloudhsm/commands/ModifyLunaClientCommand.ts index 351023a78fc4b..16b93d4df701f 100644 --- a/clients/client-cloudhsm/commands/ModifyLunaClientCommand.ts +++ b/clients/client-cloudhsm/commands/ModifyLunaClientCommand.ts @@ -20,6 +20,21 @@ import { export type ModifyLunaClientCommandInput = ModifyLunaClientRequest; export type ModifyLunaClientCommandOutput = ModifyLunaClientResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Modifies the certificate used by the client.

+ *

This action can potentially start a workflow to install the new certificate on the + * client's HSMs.

+ */ export class ModifyLunaClientCommand extends $Command< ModifyLunaClientCommandInput, ModifyLunaClientCommandOutput, @@ -34,6 +49,9 @@ export class ModifyLunaClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/commands/RemoveTagsFromResourceCommand.ts b/clients/client-cloudhsm/commands/RemoveTagsFromResourceCommand.ts index a921153d4d8f7..cb67d87f995d5 100644 --- a/clients/client-cloudhsm/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-cloudhsm/commands/RemoveTagsFromResourceCommand.ts @@ -20,6 +20,21 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceRequest; export type RemoveTagsFromResourceCommandOutput = RemoveTagsFromResourceResponse & __MetadataBearer; +/** + *

This is documentation for AWS CloudHSM Classic. For + * more information, see AWS CloudHSM + * Classic FAQs, the AWS + * CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

+ *

+ * For information about the current version of AWS + * CloudHSM, see AWS CloudHSM, the + * AWS CloudHSM User Guide, + * and the AWS CloudHSM API + * Reference.

+ *

Removes one or more tags from the specified AWS CloudHSM resource.

+ *

To remove a tag, specify only the tag key to remove (not the value). To overwrite the + * value for an existing tag, use AddTagsToResource.

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -34,6 +49,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudHSMClientResolvedConfig, diff --git a/clients/client-cloudhsm/package.json b/clients/client-cloudhsm/package.json index ab51a147d4e07..6cf8a56cc861f 100644 --- a/clients/client-cloudhsm/package.json +++ b/clients/client-cloudhsm/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudhsm Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudhsm/runtimeConfig.browser.ts b/clients/client-cloudhsm/runtimeConfig.browser.ts index 08c41a6409eb9..6fe72bf5fa240 100644 --- a/clients/client-cloudhsm/runtimeConfig.browser.ts +++ b/clients/client-cloudhsm/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudHSMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudhsm/runtimeConfig.native.ts b/clients/client-cloudhsm/runtimeConfig.native.ts index b74471b69d615..6f9ef25a258f0 100644 --- a/clients/client-cloudhsm/runtimeConfig.native.ts +++ b/clients/client-cloudhsm/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudHSMClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudhsm/runtimeConfig.shared.ts b/clients/client-cloudhsm/runtimeConfig.shared.ts index 277cb45ea938e..2ba3709edca4f 100644 --- a/clients/client-cloudhsm/runtimeConfig.shared.ts +++ b/clients/client-cloudhsm/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-05-30", disableHostPrefix: false, diff --git a/clients/client-cloudhsm/runtimeConfig.ts b/clients/client-cloudhsm/runtimeConfig.ts index 9e01a70923396..2d4541c9b76ac 100644 --- a/clients/client-cloudhsm/runtimeConfig.ts +++ b/clients/client-cloudhsm/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudHSMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudhsm/tsconfig.json b/clients/client-cloudhsm/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudhsm/tsconfig.json +++ b/clients/client-cloudhsm/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudsearch-domain/commands/SearchCommand.ts b/clients/client-cloudsearch-domain/commands/SearchCommand.ts index 59c16fc49a027..0810e57540d60 100644 --- a/clients/client-cloudsearch-domain/commands/SearchCommand.ts +++ b/clients/client-cloudsearch-domain/commands/SearchCommand.ts @@ -21,6 +21,17 @@ import { export type SearchCommandInput = SearchRequest; export type SearchCommandOutput = SearchResponse & __MetadataBearer; +/** + *

Retrieves a list of documents that match the specified search criteria. How you specify the search criteria depends on which query parser you use. Amazon CloudSearch supports four query parsers:

+ *
    + *
  • simple: search all text and text-array fields for the specified string. Search for phrases, individual terms, and prefixes.
  • + *
  • structured: search specific fields, construct compound queries using Boolean operators, and use advanced features such as term boosting and proximity searching.
  • + *
  • lucene: specify search criteria using the Apache Lucene query parser syntax.
  • + *
  • dismax: specify search criteria using the simplified subset of the Apache Lucene query parser syntax defined by the DisMax query parser.
  • + *
+ *

For more information, see Searching Your Data in the Amazon CloudSearch Developer Guide.

+ *

The endpoint for submitting Search requests is domain-specific and requires the --endpoint-url option. You submit search requests to a domain's search endpoint. To get the search endpoint for your domain, use the Amazon CloudSearch configuration service DescribeDomains action. The endpoints are also available on the domain dashboard in the Amazon CloudSearch console.

+ */ export class SearchCommand extends $Command< SearchCommandInput, SearchCommandOutput, @@ -35,6 +46,9 @@ export class SearchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchDomainClientResolvedConfig, diff --git a/clients/client-cloudsearch-domain/commands/SuggestCommand.ts b/clients/client-cloudsearch-domain/commands/SuggestCommand.ts index d3650d34916ff..d8c859b2472b7 100644 --- a/clients/client-cloudsearch-domain/commands/SuggestCommand.ts +++ b/clients/client-cloudsearch-domain/commands/SuggestCommand.ts @@ -24,6 +24,12 @@ import { export type SuggestCommandInput = SuggestRequest; export type SuggestCommandOutput = SuggestResponse & __MetadataBearer; +/** + *

Retrieves autocomplete suggestions for a partial query string. You can use suggestions enable you to display likely matches before users finish typing. In Amazon CloudSearch, suggestions are based on the contents of a particular text field. When you request suggestions, Amazon CloudSearch finds all of the documents whose values in the suggester field start with the specified query string. The beginning of the field must match the query string to be considered a match.

+ *

For more information about configuring suggesters and retrieving suggestions, see Getting Suggestions in the Amazon CloudSearch Developer Guide.

+ * + *

The endpoint for submitting Suggest requests is domain-specific and requires the --endpoint-url option. You submit suggest requests to a domain's search endpoint. To get the search endpoint for your domain, use the Amazon CloudSearch configuration service DescribeDomains action. The endpoints are also available on the domain dashboard in the Amazon CloudSearch console.

+ */ export class SuggestCommand extends $Command< SuggestCommandInput, SuggestCommandOutput, @@ -38,6 +44,9 @@ export class SuggestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchDomainClientResolvedConfig, diff --git a/clients/client-cloudsearch-domain/commands/UploadDocumentsCommand.ts b/clients/client-cloudsearch-domain/commands/UploadDocumentsCommand.ts index 8b0fd2fb2e71d..2e2698450fe76 100644 --- a/clients/client-cloudsearch-domain/commands/UploadDocumentsCommand.ts +++ b/clients/client-cloudsearch-domain/commands/UploadDocumentsCommand.ts @@ -26,6 +26,12 @@ export type UploadDocumentsCommandInput = OmitPosts a batch of documents to a search domain for indexing. A document batch is a collection of add and delete operations that represent the documents you want to add, update, or delete from your domain. Batches can be described in either JSON or XML. Each item that you want Amazon CloudSearch to return as a search result (such as a product) is represented as a document. Every document has a unique ID and one or more fields that contain the data that you want to search and return in results. Individual documents cannot contain more than 1 MB of data. The entire batch cannot exceed 5 MB. To get the best possible upload performance, group add and delete operations in batches that are close the 5 MB limit. Submitting a large volume of single-document batches can overload a domain's document service.

+ *

The endpoint for submitting UploadDocuments requests is domain-specific and requires the --endpoint-url option. To get the document endpoint for your domain, use the Amazon CloudSearch configuration service DescribeDomains action. The endpoints are also available on the domain dashboard in the Amazon CloudSearch console.

+ *

For more information about formatting your data for Amazon CloudSearch, see Preparing Your Data in the Amazon CloudSearch Developer Guide. + * For more information about uploading data for indexing, see Uploading Data in the Amazon CloudSearch Developer Guide.

+ */ export class UploadDocumentsCommand extends $Command< UploadDocumentsCommandInput, UploadDocumentsCommandOutput, @@ -40,6 +46,9 @@ export class UploadDocumentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchDomainClientResolvedConfig, diff --git a/clients/client-cloudsearch-domain/package.json b/clients/client-cloudsearch-domain/package.json index 02e200d29426b..8ce15fda14d74 100644 --- a/clients/client-cloudsearch-domain/package.json +++ b/clients/client-cloudsearch-domain/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudsearch Domain Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudsearch-domain/runtimeConfig.browser.ts b/clients/client-cloudsearch-domain/runtimeConfig.browser.ts index c118f2a045cac..6d988844e21b8 100644 --- a/clients/client-cloudsearch-domain/runtimeConfig.browser.ts +++ b/clients/client-cloudsearch-domain/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudSearchDomainClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudsearch-domain/runtimeConfig.native.ts b/clients/client-cloudsearch-domain/runtimeConfig.native.ts index 7e34e7e63a865..8494fa28e0352 100644 --- a/clients/client-cloudsearch-domain/runtimeConfig.native.ts +++ b/clients/client-cloudsearch-domain/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudSearchDomainClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudsearch-domain/runtimeConfig.shared.ts b/clients/client-cloudsearch-domain/runtimeConfig.shared.ts index d16ad68497e89..c0ffff279202e 100644 --- a/clients/client-cloudsearch-domain/runtimeConfig.shared.ts +++ b/clients/client-cloudsearch-domain/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2013-01-01", disableHostPrefix: false, diff --git a/clients/client-cloudsearch-domain/runtimeConfig.ts b/clients/client-cloudsearch-domain/runtimeConfig.ts index f94beb2d47db3..7ccb0e83414d9 100644 --- a/clients/client-cloudsearch-domain/runtimeConfig.ts +++ b/clients/client-cloudsearch-domain/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudSearchDomainClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudsearch-domain/tsconfig.json b/clients/client-cloudsearch-domain/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudsearch-domain/tsconfig.json +++ b/clients/client-cloudsearch-domain/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudsearch/commands/BuildSuggestersCommand.ts b/clients/client-cloudsearch/commands/BuildSuggestersCommand.ts index d1c2be8c20740..388fb64f74027 100644 --- a/clients/client-cloudsearch/commands/BuildSuggestersCommand.ts +++ b/clients/client-cloudsearch/commands/BuildSuggestersCommand.ts @@ -20,6 +20,9 @@ import { export type BuildSuggestersCommandInput = BuildSuggestersRequest; export type BuildSuggestersCommandOutput = BuildSuggestersResponse & __MetadataBearer; +/** + *

Indexes the search suggestions. For more information, see Configuring Suggesters in the Amazon CloudSearch Developer Guide.

+ */ export class BuildSuggestersCommand extends $Command< BuildSuggestersCommandInput, BuildSuggestersCommandOutput, @@ -34,6 +37,9 @@ export class BuildSuggestersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/CreateDomainCommand.ts b/clients/client-cloudsearch/commands/CreateDomainCommand.ts index 4477b6e0f6bcf..147c196fb793c 100644 --- a/clients/client-cloudsearch/commands/CreateDomainCommand.ts +++ b/clients/client-cloudsearch/commands/CreateDomainCommand.ts @@ -17,6 +17,10 @@ import { export type CreateDomainCommandInput = CreateDomainRequest; export type CreateDomainCommandOutput = CreateDomainResponse & __MetadataBearer; +/** + *

Creates a new search domain. For more information, + * see Creating a Search Domain in the Amazon CloudSearch Developer Guide.

+ */ export class CreateDomainCommand extends $Command< CreateDomainCommandInput, CreateDomainCommandOutput, @@ -31,6 +35,9 @@ export class CreateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DefineAnalysisSchemeCommand.ts b/clients/client-cloudsearch/commands/DefineAnalysisSchemeCommand.ts index c58e4fb83a810..1949129716509 100644 --- a/clients/client-cloudsearch/commands/DefineAnalysisSchemeCommand.ts +++ b/clients/client-cloudsearch/commands/DefineAnalysisSchemeCommand.ts @@ -20,6 +20,9 @@ import { export type DefineAnalysisSchemeCommandInput = DefineAnalysisSchemeRequest; export type DefineAnalysisSchemeCommandOutput = DefineAnalysisSchemeResponse & __MetadataBearer; +/** + *

Configures an analysis scheme that can be applied to a text or text-array field to define language-specific text processing options. For more information, see Configuring Analysis Schemes in the Amazon CloudSearch Developer Guide.

+ */ export class DefineAnalysisSchemeCommand extends $Command< DefineAnalysisSchemeCommandInput, DefineAnalysisSchemeCommandOutput, @@ -34,6 +37,9 @@ export class DefineAnalysisSchemeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DefineExpressionCommand.ts b/clients/client-cloudsearch/commands/DefineExpressionCommand.ts index 6464c0ceaf14b..8940a9f4a68c8 100644 --- a/clients/client-cloudsearch/commands/DefineExpressionCommand.ts +++ b/clients/client-cloudsearch/commands/DefineExpressionCommand.ts @@ -20,6 +20,9 @@ import { export type DefineExpressionCommandInput = DefineExpressionRequest; export type DefineExpressionCommandOutput = DefineExpressionResponse & __MetadataBearer; +/** + *

Configures an Expression for the search domain. Used to create new expressions and modify existing ones. If the expression exists, the new configuration replaces the old one. For more information, see Configuring Expressions in the Amazon CloudSearch Developer Guide.

+ */ export class DefineExpressionCommand extends $Command< DefineExpressionCommandInput, DefineExpressionCommandOutput, @@ -34,6 +37,9 @@ export class DefineExpressionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DefineIndexFieldCommand.ts b/clients/client-cloudsearch/commands/DefineIndexFieldCommand.ts index 06140b6cdcfd3..aaa83c038f4f7 100644 --- a/clients/client-cloudsearch/commands/DefineIndexFieldCommand.ts +++ b/clients/client-cloudsearch/commands/DefineIndexFieldCommand.ts @@ -20,6 +20,9 @@ import { export type DefineIndexFieldCommandInput = DefineIndexFieldRequest; export type DefineIndexFieldCommandOutput = DefineIndexFieldResponse & __MetadataBearer; +/** + *

Configures an IndexField for the search domain. Used to create new fields and modify existing ones. You must specify the name of the domain you are configuring and an index field configuration. The index field configuration specifies a unique name, the index field type, and the options you want to configure for the field. The options you can specify depend on the IndexFieldType. If the field exists, the new configuration replaces the old one. For more information, see Configuring Index Fields in the Amazon CloudSearch Developer Guide.

+ */ export class DefineIndexFieldCommand extends $Command< DefineIndexFieldCommandInput, DefineIndexFieldCommandOutput, @@ -34,6 +37,9 @@ export class DefineIndexFieldCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DefineSuggesterCommand.ts b/clients/client-cloudsearch/commands/DefineSuggesterCommand.ts index 277d2162a0873..e61f298601c23 100644 --- a/clients/client-cloudsearch/commands/DefineSuggesterCommand.ts +++ b/clients/client-cloudsearch/commands/DefineSuggesterCommand.ts @@ -20,6 +20,9 @@ import { export type DefineSuggesterCommandInput = DefineSuggesterRequest; export type DefineSuggesterCommandOutput = DefineSuggesterResponse & __MetadataBearer; +/** + *

Configures a suggester for a domain. A suggester enables you to display possible matches before users finish typing their queries. When you configure a suggester, you must specify the name of the text field you want to search for possible matches and a unique name for the suggester. For more information, see Getting Search Suggestions in the Amazon CloudSearch Developer Guide.

+ */ export class DefineSuggesterCommand extends $Command< DefineSuggesterCommandInput, DefineSuggesterCommandOutput, @@ -34,6 +37,9 @@ export class DefineSuggesterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DeleteAnalysisSchemeCommand.ts b/clients/client-cloudsearch/commands/DeleteAnalysisSchemeCommand.ts index 71fa2d04a08ea..c10f0818f031c 100644 --- a/clients/client-cloudsearch/commands/DeleteAnalysisSchemeCommand.ts +++ b/clients/client-cloudsearch/commands/DeleteAnalysisSchemeCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAnalysisSchemeCommandInput = DeleteAnalysisSchemeRequest; export type DeleteAnalysisSchemeCommandOutput = DeleteAnalysisSchemeResponse & __MetadataBearer; +/** + *

Deletes an analysis scheme. For more information, see Configuring Analysis Schemes in the Amazon CloudSearch Developer Guide.

+ */ export class DeleteAnalysisSchemeCommand extends $Command< DeleteAnalysisSchemeCommandInput, DeleteAnalysisSchemeCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAnalysisSchemeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DeleteDomainCommand.ts b/clients/client-cloudsearch/commands/DeleteDomainCommand.ts index 526552d2bfcdb..37a3aea8e4950 100644 --- a/clients/client-cloudsearch/commands/DeleteDomainCommand.ts +++ b/clients/client-cloudsearch/commands/DeleteDomainCommand.ts @@ -17,6 +17,10 @@ import { export type DeleteDomainCommandInput = DeleteDomainRequest; export type DeleteDomainCommandOutput = DeleteDomainResponse & __MetadataBearer; +/** + *

Permanently deletes a search domain and all of its data. Once a domain has been deleted, it cannot be recovered. For more information, + * see Deleting a Search Domain in the Amazon CloudSearch Developer Guide.

+ */ export class DeleteDomainCommand extends $Command< DeleteDomainCommandInput, DeleteDomainCommandOutput, @@ -31,6 +35,9 @@ export class DeleteDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DeleteExpressionCommand.ts b/clients/client-cloudsearch/commands/DeleteExpressionCommand.ts index e0adde794ddaf..62b96d05f1e74 100644 --- a/clients/client-cloudsearch/commands/DeleteExpressionCommand.ts +++ b/clients/client-cloudsearch/commands/DeleteExpressionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteExpressionCommandInput = DeleteExpressionRequest; export type DeleteExpressionCommandOutput = DeleteExpressionResponse & __MetadataBearer; +/** + *

Removes an Expression from the search domain. For more information, see Configuring Expressions in the Amazon CloudSearch Developer Guide.

+ */ export class DeleteExpressionCommand extends $Command< DeleteExpressionCommandInput, DeleteExpressionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteExpressionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DeleteIndexFieldCommand.ts b/clients/client-cloudsearch/commands/DeleteIndexFieldCommand.ts index ce6a99a4ed635..e598ad21a5ce0 100644 --- a/clients/client-cloudsearch/commands/DeleteIndexFieldCommand.ts +++ b/clients/client-cloudsearch/commands/DeleteIndexFieldCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteIndexFieldCommandInput = DeleteIndexFieldRequest; export type DeleteIndexFieldCommandOutput = DeleteIndexFieldResponse & __MetadataBearer; +/** + *

Removes an IndexField from the search domain. For more information, see Configuring Index Fields in the Amazon CloudSearch Developer Guide.

+ */ export class DeleteIndexFieldCommand extends $Command< DeleteIndexFieldCommandInput, DeleteIndexFieldCommandOutput, @@ -34,6 +37,9 @@ export class DeleteIndexFieldCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DeleteSuggesterCommand.ts b/clients/client-cloudsearch/commands/DeleteSuggesterCommand.ts index 8225d36f22e04..295a3adc82bb5 100644 --- a/clients/client-cloudsearch/commands/DeleteSuggesterCommand.ts +++ b/clients/client-cloudsearch/commands/DeleteSuggesterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSuggesterCommandInput = DeleteSuggesterRequest; export type DeleteSuggesterCommandOutput = DeleteSuggesterResponse & __MetadataBearer; +/** + *

Deletes a suggester. For more information, see Getting Search Suggestions in the Amazon CloudSearch Developer Guide.

+ */ export class DeleteSuggesterCommand extends $Command< DeleteSuggesterCommandInput, DeleteSuggesterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSuggesterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeAnalysisSchemesCommand.ts b/clients/client-cloudsearch/commands/DescribeAnalysisSchemesCommand.ts index 46a0d90c3108b..a3ca882eb8a4a 100644 --- a/clients/client-cloudsearch/commands/DescribeAnalysisSchemesCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeAnalysisSchemesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAnalysisSchemesCommandInput = DescribeAnalysisSchemesRequest; export type DescribeAnalysisSchemesCommandOutput = DescribeAnalysisSchemesResponse & __MetadataBearer; +/** + *

Gets the analysis schemes configured for a domain. An analysis scheme defines language-specific text processing options for a text field. Can be limited to specific analysis schemes by name. By default, shows all analysis schemes and includes any pending changes to the configuration. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Configuring Analysis Schemes in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeAnalysisSchemesCommand extends $Command< DescribeAnalysisSchemesCommandInput, DescribeAnalysisSchemesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAnalysisSchemesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeAvailabilityOptionsCommand.ts b/clients/client-cloudsearch/commands/DescribeAvailabilityOptionsCommand.ts index c765ec3dfbf30..f94efc90f1004 100644 --- a/clients/client-cloudsearch/commands/DescribeAvailabilityOptionsCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeAvailabilityOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAvailabilityOptionsCommandInput = DescribeAvailabilityOptionsRequest; export type DescribeAvailabilityOptionsCommandOutput = DescribeAvailabilityOptionsResponse & __MetadataBearer; +/** + *

Gets the availability options configured for a domain. By default, shows the configuration with any pending changes. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Configuring Availability Options in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeAvailabilityOptionsCommand extends $Command< DescribeAvailabilityOptionsCommandInput, DescribeAvailabilityOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAvailabilityOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeDomainEndpointOptionsCommand.ts b/clients/client-cloudsearch/commands/DescribeDomainEndpointOptionsCommand.ts index 03ba16d886172..2bb8aa9a66e1d 100644 --- a/clients/client-cloudsearch/commands/DescribeDomainEndpointOptionsCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeDomainEndpointOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDomainEndpointOptionsCommandInput = DescribeDomainEndpointOptionsRequest; export type DescribeDomainEndpointOptionsCommandOutput = DescribeDomainEndpointOptionsResponse & __MetadataBearer; +/** + *

Returns the domain's endpoint options, specifically whether all requests to the domain must arrive over HTTPS. For more information, see Configuring Domain Endpoint Options in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeDomainEndpointOptionsCommand extends $Command< DescribeDomainEndpointOptionsCommandInput, DescribeDomainEndpointOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDomainEndpointOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeDomainsCommand.ts b/clients/client-cloudsearch/commands/DescribeDomainsCommand.ts index a723daa74b78e..ca5995b33990c 100644 --- a/clients/client-cloudsearch/commands/DescribeDomainsCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeDomainsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDomainsCommandInput = DescribeDomainsRequest; export type DescribeDomainsCommandOutput = DescribeDomainsResponse & __MetadataBearer; +/** + *

Gets information about the search domains owned by this account. Can be limited to specific domains. Shows + * all domains by default. To get the number of searchable documents in a domain, use the console or submit a matchall request to your domain's search endpoint: q=matchall&q.parser=structured&size=0. For more information, + * see Getting Information about a Search Domain in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeDomainsCommand extends $Command< DescribeDomainsCommandInput, DescribeDomainsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeExpressionsCommand.ts b/clients/client-cloudsearch/commands/DescribeExpressionsCommand.ts index bbc3d338cb55f..f009406fa5040 100644 --- a/clients/client-cloudsearch/commands/DescribeExpressionsCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeExpressionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeExpressionsCommandInput = DescribeExpressionsRequest; export type DescribeExpressionsCommandOutput = DescribeExpressionsResponse & __MetadataBearer; +/** + *

Gets the expressions configured for the search domain. Can be limited to specific expressions by name. By default, shows all expressions and includes any pending changes to the configuration. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Configuring Expressions in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeExpressionsCommand extends $Command< DescribeExpressionsCommandInput, DescribeExpressionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeExpressionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeIndexFieldsCommand.ts b/clients/client-cloudsearch/commands/DescribeIndexFieldsCommand.ts index 3ce3ac163cb89..f5949f6b5b8a3 100644 --- a/clients/client-cloudsearch/commands/DescribeIndexFieldsCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeIndexFieldsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeIndexFieldsCommandInput = DescribeIndexFieldsRequest; export type DescribeIndexFieldsCommandOutput = DescribeIndexFieldsResponse & __MetadataBearer; +/** + *

Gets information about the index fields configured for the search domain. + * Can be limited to specific fields by name. By default, shows all fields and includes any pending changes to the configuration. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, + * see Getting Domain Information in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeIndexFieldsCommand extends $Command< DescribeIndexFieldsCommandInput, DescribeIndexFieldsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeIndexFieldsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeScalingParametersCommand.ts b/clients/client-cloudsearch/commands/DescribeScalingParametersCommand.ts index 9a2fd3bb03d46..1a911a51bd9bb 100644 --- a/clients/client-cloudsearch/commands/DescribeScalingParametersCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeScalingParametersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeScalingParametersCommandInput = DescribeScalingParametersRequest; export type DescribeScalingParametersCommandOutput = DescribeScalingParametersResponse & __MetadataBearer; +/** + *

Gets the scaling parameters configured for a domain. A domain's scaling parameters specify the desired search instance type and replication count. For more information, see Configuring Scaling Options in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeScalingParametersCommand extends $Command< DescribeScalingParametersCommandInput, DescribeScalingParametersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeScalingParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeServiceAccessPoliciesCommand.ts b/clients/client-cloudsearch/commands/DescribeServiceAccessPoliciesCommand.ts index 615af4198bae6..81247d04bfa81 100644 --- a/clients/client-cloudsearch/commands/DescribeServiceAccessPoliciesCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeServiceAccessPoliciesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeServiceAccessPoliciesCommandInput = DescribeServiceAccessPoliciesRequest; export type DescribeServiceAccessPoliciesCommandOutput = DescribeServiceAccessPoliciesResponse & __MetadataBearer; +/** + *

Gets information about the access policies that control access to the domain's document and search endpoints. By default, shows the configuration with any pending changes. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, + * see Configuring Access for a Search Domain in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeServiceAccessPoliciesCommand extends $Command< DescribeServiceAccessPoliciesCommandInput, DescribeServiceAccessPoliciesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeServiceAccessPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/DescribeSuggestersCommand.ts b/clients/client-cloudsearch/commands/DescribeSuggestersCommand.ts index 745ec45591651..08608ddd99ccd 100644 --- a/clients/client-cloudsearch/commands/DescribeSuggestersCommand.ts +++ b/clients/client-cloudsearch/commands/DescribeSuggestersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSuggestersCommandInput = DescribeSuggestersRequest; export type DescribeSuggestersCommandOutput = DescribeSuggestersResponse & __MetadataBearer; +/** + *

Gets the suggesters configured for a domain. A suggester enables you to display possible matches before users finish typing their queries. Can be limited to specific suggesters by name. By default, shows all suggesters and includes any pending changes to the configuration. Set the Deployed option to true to show the active configuration and exclude pending changes. For more information, see Getting Search Suggestions in the Amazon CloudSearch Developer Guide.

+ */ export class DescribeSuggestersCommand extends $Command< DescribeSuggestersCommandInput, DescribeSuggestersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSuggestersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/IndexDocumentsCommand.ts b/clients/client-cloudsearch/commands/IndexDocumentsCommand.ts index 2d162fdfdf65a..2243badb9e94d 100644 --- a/clients/client-cloudsearch/commands/IndexDocumentsCommand.ts +++ b/clients/client-cloudsearch/commands/IndexDocumentsCommand.ts @@ -20,6 +20,9 @@ import { export type IndexDocumentsCommandInput = IndexDocumentsRequest; export type IndexDocumentsCommandOutput = IndexDocumentsResponse & __MetadataBearer; +/** + *

Tells the search domain to start indexing its documents using the latest indexing options. This operation must be invoked to activate options whose OptionStatus is RequiresIndexDocuments.

+ */ export class IndexDocumentsCommand extends $Command< IndexDocumentsCommandInput, IndexDocumentsCommandOutput, @@ -34,6 +37,9 @@ export class IndexDocumentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/ListDomainNamesCommand.ts b/clients/client-cloudsearch/commands/ListDomainNamesCommand.ts index 1d38b9b7495ce..21e70d7248062 100644 --- a/clients/client-cloudsearch/commands/ListDomainNamesCommand.ts +++ b/clients/client-cloudsearch/commands/ListDomainNamesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDomainNamesCommandInput = {}; export type ListDomainNamesCommandOutput = ListDomainNamesResponse & __MetadataBearer; +/** + *

Lists all search domains owned by an account.

+ */ export class ListDomainNamesCommand extends $Command< ListDomainNamesCommandInput, ListDomainNamesCommandOutput, @@ -34,6 +37,9 @@ export class ListDomainNamesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/UpdateAvailabilityOptionsCommand.ts b/clients/client-cloudsearch/commands/UpdateAvailabilityOptionsCommand.ts index 445e4710df93b..be931a20ded5f 100644 --- a/clients/client-cloudsearch/commands/UpdateAvailabilityOptionsCommand.ts +++ b/clients/client-cloudsearch/commands/UpdateAvailabilityOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAvailabilityOptionsCommandInput = UpdateAvailabilityOptionsRequest; export type UpdateAvailabilityOptionsCommandOutput = UpdateAvailabilityOptionsResponse & __MetadataBearer; +/** + *

Configures the availability options for a domain. Enabling the Multi-AZ option expands an Amazon CloudSearch domain to an additional Availability Zone in the same Region to increase fault tolerance in the event of a service disruption. Changes to the Multi-AZ option can take about half an hour to become active. For more information, see Configuring Availability Options in the Amazon CloudSearch Developer Guide.

+ */ export class UpdateAvailabilityOptionsCommand extends $Command< UpdateAvailabilityOptionsCommandInput, UpdateAvailabilityOptionsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAvailabilityOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/UpdateDomainEndpointOptionsCommand.ts b/clients/client-cloudsearch/commands/UpdateDomainEndpointOptionsCommand.ts index 136414cc37e71..966485dfb7290 100644 --- a/clients/client-cloudsearch/commands/UpdateDomainEndpointOptionsCommand.ts +++ b/clients/client-cloudsearch/commands/UpdateDomainEndpointOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDomainEndpointOptionsCommandInput = UpdateDomainEndpointOptionsRequest; export type UpdateDomainEndpointOptionsCommandOutput = UpdateDomainEndpointOptionsResponse & __MetadataBearer; +/** + *

Updates the domain's endpoint options, specifically whether all requests to the domain must arrive over HTTPS. For more information, see Configuring Domain Endpoint Options in the Amazon CloudSearch Developer Guide.

+ */ export class UpdateDomainEndpointOptionsCommand extends $Command< UpdateDomainEndpointOptionsCommandInput, UpdateDomainEndpointOptionsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDomainEndpointOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/UpdateScalingParametersCommand.ts b/clients/client-cloudsearch/commands/UpdateScalingParametersCommand.ts index 5dc807de3c1f7..384e2052c0dda 100644 --- a/clients/client-cloudsearch/commands/UpdateScalingParametersCommand.ts +++ b/clients/client-cloudsearch/commands/UpdateScalingParametersCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateScalingParametersCommandInput = UpdateScalingParametersRequest; export type UpdateScalingParametersCommandOutput = UpdateScalingParametersResponse & __MetadataBearer; +/** + *

Configures scaling parameters for a domain. A domain's scaling parameters specify the desired search instance type and replication count. Amazon CloudSearch will still automatically scale your domain based on the volume of data and traffic, but not below the desired instance type and replication count. If the Multi-AZ option is enabled, these values control the resources used per Availability Zone. For more information, see Configuring Scaling Options in the Amazon CloudSearch Developer Guide.

+ */ export class UpdateScalingParametersCommand extends $Command< UpdateScalingParametersCommandInput, UpdateScalingParametersCommandOutput, @@ -34,6 +37,9 @@ export class UpdateScalingParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/commands/UpdateServiceAccessPoliciesCommand.ts b/clients/client-cloudsearch/commands/UpdateServiceAccessPoliciesCommand.ts index dfcc6fde411e9..7858be3edccfe 100644 --- a/clients/client-cloudsearch/commands/UpdateServiceAccessPoliciesCommand.ts +++ b/clients/client-cloudsearch/commands/UpdateServiceAccessPoliciesCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateServiceAccessPoliciesCommandInput = UpdateServiceAccessPoliciesRequest; export type UpdateServiceAccessPoliciesCommandOutput = UpdateServiceAccessPoliciesResponse & __MetadataBearer; +/** + *

Configures the access rules that control access to the domain's document and search endpoints. + * For more information, see + * Configuring Access for an Amazon CloudSearch Domain.

+ */ export class UpdateServiceAccessPoliciesCommand extends $Command< UpdateServiceAccessPoliciesCommandInput, UpdateServiceAccessPoliciesCommandOutput, @@ -34,6 +39,9 @@ export class UpdateServiceAccessPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudSearchClientResolvedConfig, diff --git a/clients/client-cloudsearch/package.json b/clients/client-cloudsearch/package.json index a18abd0d37209..8707927f5e316 100644 --- a/clients/client-cloudsearch/package.json +++ b/clients/client-cloudsearch/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudsearch Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudsearch/runtimeConfig.browser.ts b/clients/client-cloudsearch/runtimeConfig.browser.ts index 426a2262d971a..8b42c108def9e 100644 --- a/clients/client-cloudsearch/runtimeConfig.browser.ts +++ b/clients/client-cloudsearch/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudSearchClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudsearch/runtimeConfig.native.ts b/clients/client-cloudsearch/runtimeConfig.native.ts index 92feacf781e25..0e1972d5cffd2 100644 --- a/clients/client-cloudsearch/runtimeConfig.native.ts +++ b/clients/client-cloudsearch/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudSearchClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudsearch/runtimeConfig.shared.ts b/clients/client-cloudsearch/runtimeConfig.shared.ts index d16ad68497e89..c0ffff279202e 100644 --- a/clients/client-cloudsearch/runtimeConfig.shared.ts +++ b/clients/client-cloudsearch/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2013-01-01", disableHostPrefix: false, diff --git a/clients/client-cloudsearch/runtimeConfig.ts b/clients/client-cloudsearch/runtimeConfig.ts index 926a0087a8a02..5a461c56038a2 100644 --- a/clients/client-cloudsearch/runtimeConfig.ts +++ b/clients/client-cloudsearch/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudSearchClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudsearch/tsconfig.json b/clients/client-cloudsearch/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudsearch/tsconfig.json +++ b/clients/client-cloudsearch/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudtrail/commands/AddTagsCommand.ts b/clients/client-cloudtrail/commands/AddTagsCommand.ts index ef335292c0b29..5062c3291f61d 100644 --- a/clients/client-cloudtrail/commands/AddTagsCommand.ts +++ b/clients/client-cloudtrail/commands/AddTagsCommand.ts @@ -17,6 +17,12 @@ import { export type AddTagsCommandInput = AddTagsRequest; export type AddTagsCommandOutput = AddTagsResponse & __MetadataBearer; +/** + *

Adds one or more tags to a trail, up to a limit of 50. Overwrites an existing tag's value when a new value is specified for an existing tag key. + * Tag key names must be unique for a trail; you cannot have two keys with the same name but different values. + * If you specify a key without a value, the tag will be created with the specified key and a value of null. + * You can tag a trail that applies to all AWS Regions only from the Region in which the trail was created (also known as its home region).

+ */ export class AddTagsCommand extends $Command< AddTagsCommandInput, AddTagsCommandOutput, @@ -31,6 +37,9 @@ export class AddTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/CreateTrailCommand.ts b/clients/client-cloudtrail/commands/CreateTrailCommand.ts index b3f8b1929aa68..361066c20d670 100644 --- a/clients/client-cloudtrail/commands/CreateTrailCommand.ts +++ b/clients/client-cloudtrail/commands/CreateTrailCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTrailCommandInput = CreateTrailRequest; export type CreateTrailCommandOutput = CreateTrailResponse & __MetadataBearer; +/** + *

Creates a trail that specifies the settings for delivery of log data to an Amazon S3 bucket.

+ */ export class CreateTrailCommand extends $Command< CreateTrailCommandInput, CreateTrailCommandOutput, @@ -34,6 +37,9 @@ export class CreateTrailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/DeleteTrailCommand.ts b/clients/client-cloudtrail/commands/DeleteTrailCommand.ts index 6d012e4da893d..95f29743ec065 100644 --- a/clients/client-cloudtrail/commands/DeleteTrailCommand.ts +++ b/clients/client-cloudtrail/commands/DeleteTrailCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteTrailCommandInput = DeleteTrailRequest; export type DeleteTrailCommandOutput = DeleteTrailResponse & __MetadataBearer; +/** + *

Deletes a trail. This operation must be called from the region in which the trail was + * created. DeleteTrail cannot be called on the shadow trails (replicated trails + * in other regions) of a trail that is enabled in all regions.

+ */ export class DeleteTrailCommand extends $Command< DeleteTrailCommandInput, DeleteTrailCommandOutput, @@ -34,6 +39,9 @@ export class DeleteTrailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/DescribeTrailsCommand.ts b/clients/client-cloudtrail/commands/DescribeTrailsCommand.ts index dddde3d2925e6..1102029a2207f 100644 --- a/clients/client-cloudtrail/commands/DescribeTrailsCommand.ts +++ b/clients/client-cloudtrail/commands/DescribeTrailsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTrailsCommandInput = DescribeTrailsRequest; export type DescribeTrailsCommandOutput = DescribeTrailsResponse & __MetadataBearer; +/** + *

Retrieves settings for one or more trails associated with the current region for your account.

+ */ export class DescribeTrailsCommand extends $Command< DescribeTrailsCommandInput, DescribeTrailsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTrailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/GetEventSelectorsCommand.ts b/clients/client-cloudtrail/commands/GetEventSelectorsCommand.ts index f784b71aea38c..f3993382210a6 100644 --- a/clients/client-cloudtrail/commands/GetEventSelectorsCommand.ts +++ b/clients/client-cloudtrail/commands/GetEventSelectorsCommand.ts @@ -20,6 +20,25 @@ import { export type GetEventSelectorsCommandInput = GetEventSelectorsRequest; export type GetEventSelectorsCommandOutput = GetEventSelectorsResponse & __MetadataBearer; +/** + *

Describes the settings for the event selectors that you configured for your trail. + * The information returned for your event selectors includes the following:

+ *
    + *
  • + *

    If your event selector includes read-only events, write-only events, or + * all events. This applies to both management events and data events.

    + *
  • + *
  • + *

    If your event selector includes management events.

    + *
  • + *
  • + *

    If your event selector includes data events, the Amazon S3 objects or AWS Lambda functions + * that you are logging for data events.

    + *
  • + *
+ *

For more information, see Logging Data and Management Events for Trails + * in the AWS CloudTrail User Guide.

+ */ export class GetEventSelectorsCommand extends $Command< GetEventSelectorsCommandInput, GetEventSelectorsCommandOutput, @@ -34,6 +53,9 @@ export class GetEventSelectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/GetInsightSelectorsCommand.ts b/clients/client-cloudtrail/commands/GetInsightSelectorsCommand.ts index aaf6e4f35db1f..9554eef37701a 100644 --- a/clients/client-cloudtrail/commands/GetInsightSelectorsCommand.ts +++ b/clients/client-cloudtrail/commands/GetInsightSelectorsCommand.ts @@ -20,6 +20,15 @@ import { export type GetInsightSelectorsCommandInput = GetInsightSelectorsRequest; export type GetInsightSelectorsCommandOutput = GetInsightSelectorsResponse & __MetadataBearer; +/** + *

Describes the settings for the Insights event selectors that you configured for your trail. GetInsightSelectors shows + * if CloudTrail Insights event logging is enabled on the trail, and if it is, which insight types are enabled. + * If you run GetInsightSelectors on a trail that does not have Insights events enabled, the operation throws the exception + * InsightNotEnabledException + *

+ *

For more information, see Logging CloudTrail Insights Events for Trails + * in the AWS CloudTrail User Guide.

+ */ export class GetInsightSelectorsCommand extends $Command< GetInsightSelectorsCommandInput, GetInsightSelectorsCommandOutput, @@ -34,6 +43,9 @@ export class GetInsightSelectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/GetTrailCommand.ts b/clients/client-cloudtrail/commands/GetTrailCommand.ts index f8d0308d0159f..a962a81c67be1 100644 --- a/clients/client-cloudtrail/commands/GetTrailCommand.ts +++ b/clients/client-cloudtrail/commands/GetTrailCommand.ts @@ -17,6 +17,9 @@ import { export type GetTrailCommandInput = GetTrailRequest; export type GetTrailCommandOutput = GetTrailResponse & __MetadataBearer; +/** + *

Returns settings information for a specified trail.

+ */ export class GetTrailCommand extends $Command< GetTrailCommandInput, GetTrailCommandOutput, @@ -31,6 +34,9 @@ export class GetTrailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/GetTrailStatusCommand.ts b/clients/client-cloudtrail/commands/GetTrailStatusCommand.ts index a2fad783bec56..077491bfc3c10 100644 --- a/clients/client-cloudtrail/commands/GetTrailStatusCommand.ts +++ b/clients/client-cloudtrail/commands/GetTrailStatusCommand.ts @@ -20,6 +20,9 @@ import { export type GetTrailStatusCommandInput = GetTrailStatusRequest; export type GetTrailStatusCommandOutput = GetTrailStatusResponse & __MetadataBearer; +/** + *

Returns a JSON-formatted list of information about the specified trail. Fields include information on delivery errors, Amazon SNS and Amazon S3 errors, and start and stop logging times for each trail. This operation returns trail status from a single region. To return trail status from all regions, you must call the operation on each region.

+ */ export class GetTrailStatusCommand extends $Command< GetTrailStatusCommandInput, GetTrailStatusCommandOutput, @@ -34,6 +37,9 @@ export class GetTrailStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/ListPublicKeysCommand.ts b/clients/client-cloudtrail/commands/ListPublicKeysCommand.ts index dc0c2e4c649ac..8c7c0915fd619 100644 --- a/clients/client-cloudtrail/commands/ListPublicKeysCommand.ts +++ b/clients/client-cloudtrail/commands/ListPublicKeysCommand.ts @@ -20,6 +20,12 @@ import { export type ListPublicKeysCommandInput = ListPublicKeysRequest; export type ListPublicKeysCommandOutput = ListPublicKeysResponse & __MetadataBearer; +/** + *

Returns all public keys whose private keys were used to sign the digest files within the specified time range. The public key is needed to validate digest files that were signed with its corresponding private key.

+ * + *

CloudTrail uses different private/public key pairs per region. Each digest file is signed with a private key unique to its region. Therefore, when you validate a digest file from a particular region, you must look in the same region for its corresponding public key.

+ *
+ */ export class ListPublicKeysCommand extends $Command< ListPublicKeysCommandInput, ListPublicKeysCommandOutput, @@ -34,6 +40,9 @@ export class ListPublicKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/ListTagsCommand.ts b/clients/client-cloudtrail/commands/ListTagsCommand.ts index ac33465f818a4..68cf61b516303 100644 --- a/clients/client-cloudtrail/commands/ListTagsCommand.ts +++ b/clients/client-cloudtrail/commands/ListTagsCommand.ts @@ -17,6 +17,9 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResponse & __MetadataBearer; +/** + *

Lists the tags for the trail in the current region.

+ */ export class ListTagsCommand extends $Command< ListTagsCommandInput, ListTagsCommandOutput, @@ -31,6 +34,9 @@ export class ListTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/ListTrailsCommand.ts b/clients/client-cloudtrail/commands/ListTrailsCommand.ts index 09f70fe88e446..ea86873f1fcbb 100644 --- a/clients/client-cloudtrail/commands/ListTrailsCommand.ts +++ b/clients/client-cloudtrail/commands/ListTrailsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTrailsCommandInput = ListTrailsRequest; export type ListTrailsCommandOutput = ListTrailsResponse & __MetadataBearer; +/** + *

Lists trails that are in the current account.

+ */ export class ListTrailsCommand extends $Command< ListTrailsCommandInput, ListTrailsCommandOutput, @@ -34,6 +37,9 @@ export class ListTrailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/LookupEventsCommand.ts b/clients/client-cloudtrail/commands/LookupEventsCommand.ts index be0fb7f30dafb..78fe92e289458 100644 --- a/clients/client-cloudtrail/commands/LookupEventsCommand.ts +++ b/clients/client-cloudtrail/commands/LookupEventsCommand.ts @@ -20,6 +20,56 @@ import { export type LookupEventsCommandInput = LookupEventsRequest; export type LookupEventsCommandOutput = LookupEventsResponse & __MetadataBearer; +/** + *

Looks up management events or + * CloudTrail Insights events that are captured by CloudTrail. + * You can look up events that occurred in a region within the last 90 days. Lookup supports the following attributes for management events:

+ *
    + *
  • + *

    AWS access key

    + *
  • + *
  • + *

    Event ID

    + *
  • + *
  • + *

    Event name

    + *
  • + *
  • + *

    Event source

    + *
  • + *
  • + *

    Read only

    + *
  • + *
  • + *

    Resource name

    + *
  • + *
  • + *

    Resource type

    + *
  • + *
  • + *

    User name

    + *
  • + *
+ *

Lookup supports the following attributes for Insights events:

+ *
    + *
  • + *

    Event ID

    + *
  • + *
  • + *

    Event name

    + *
  • + *
  • + *

    Event source

    + *
  • + *
+ *

All attributes are optional. The default number of results returned is 50, with a + * maximum of 50 possible. The response includes a token that you can use to get the next page + * of results.

+ * + *

The rate of lookup requests is limited to two per second per account. If this + * limit is exceeded, a throttling error occurs.

+ *
+ */ export class LookupEventsCommand extends $Command< LookupEventsCommandInput, LookupEventsCommandOutput, @@ -34,6 +84,9 @@ export class LookupEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/PutEventSelectorsCommand.ts b/clients/client-cloudtrail/commands/PutEventSelectorsCommand.ts index d8af9771d7ff6..4dfd8d11f0f04 100644 --- a/clients/client-cloudtrail/commands/PutEventSelectorsCommand.ts +++ b/clients/client-cloudtrail/commands/PutEventSelectorsCommand.ts @@ -20,6 +20,46 @@ import { export type PutEventSelectorsCommandInput = PutEventSelectorsRequest; export type PutEventSelectorsCommandOutput = PutEventSelectorsResponse & __MetadataBearer; +/** + *

Configures an event selector for your trail. + * Use event selectors to further specify the management and data event settings for your trail. By + * default, trails created without specific event selectors will be configured to log all read and + * write management events, and no data events.

+ *

When an event occurs in your account, CloudTrail + * evaluates the event selectors in all trails. For each trail, if the event matches any event + * selector, the trail processes and logs the event. If the event doesn't match any event + * selector, the trail doesn't log the event.

+ *

Example

+ *
    + *
  1. + *

    You create an event selector for a trail and specify that you want + * write-only events.

    + *
  2. + *
  3. + *

    The EC2 GetConsoleOutput and RunInstances API + * operations occur in your account.

    + *
  4. + *
  5. + *

    CloudTrail evaluates whether the events match your event + * selectors.

    + *
  6. + *
  7. + *

    The RunInstances is a write-only event and it matches your + * event selector. The trail logs the event.

    + *
  8. + *
  9. + *

    The GetConsoleOutput is a read-only event but it doesn't + * match your event selector. The trail doesn't log the event. + *

    + *
  10. + *
+ *

The PutEventSelectors operation must be called from the region in which + * the trail was created; otherwise, an InvalidHomeRegionException is + * thrown.

+ *

You can configure up to five event selectors for each trail. For more information, see Logging Data and Management Events for Trails + * and Limits in AWS CloudTrail + * in the AWS CloudTrail User Guide.

+ */ export class PutEventSelectorsCommand extends $Command< PutEventSelectorsCommandInput, PutEventSelectorsCommandOutput, @@ -34,6 +74,9 @@ export class PutEventSelectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/PutInsightSelectorsCommand.ts b/clients/client-cloudtrail/commands/PutInsightSelectorsCommand.ts index f11f9d58ca8d7..0327fe9f06127 100644 --- a/clients/client-cloudtrail/commands/PutInsightSelectorsCommand.ts +++ b/clients/client-cloudtrail/commands/PutInsightSelectorsCommand.ts @@ -20,6 +20,12 @@ import { export type PutInsightSelectorsCommandInput = PutInsightSelectorsRequest; export type PutInsightSelectorsCommandOutput = PutInsightSelectorsResponse & __MetadataBearer; +/** + *

Lets you enable Insights event logging by specifying the Insights + * selectors that you want to enable on an existing trail. You also use + * PutInsightSelectors to turn off Insights event logging, by passing an empty list of insight types. + * In this release, only ApiCallRateInsight is supported as an Insights selector.

+ */ export class PutInsightSelectorsCommand extends $Command< PutInsightSelectorsCommandInput, PutInsightSelectorsCommandOutput, @@ -34,6 +40,9 @@ export class PutInsightSelectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/RemoveTagsCommand.ts b/clients/client-cloudtrail/commands/RemoveTagsCommand.ts index bc4291c8070ad..3d1a728bdba1e 100644 --- a/clients/client-cloudtrail/commands/RemoveTagsCommand.ts +++ b/clients/client-cloudtrail/commands/RemoveTagsCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveTagsCommandInput = RemoveTagsRequest; export type RemoveTagsCommandOutput = RemoveTagsResponse & __MetadataBearer; +/** + *

Removes the specified tags from a trail.

+ */ export class RemoveTagsCommand extends $Command< RemoveTagsCommandInput, RemoveTagsCommandOutput, @@ -34,6 +37,9 @@ export class RemoveTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/StartLoggingCommand.ts b/clients/client-cloudtrail/commands/StartLoggingCommand.ts index a69b41cee8e79..23c28e1eb4740 100644 --- a/clients/client-cloudtrail/commands/StartLoggingCommand.ts +++ b/clients/client-cloudtrail/commands/StartLoggingCommand.ts @@ -20,6 +20,9 @@ import { export type StartLoggingCommandInput = StartLoggingRequest; export type StartLoggingCommandOutput = StartLoggingResponse & __MetadataBearer; +/** + *

Starts the recording of AWS API calls and log file delivery for a trail. For a trail that is enabled in all regions, this operation must be called from the region in which the trail was created. This operation cannot be called on the shadow trails (replicated trails in other regions) of a trail that is enabled in all regions.

+ */ export class StartLoggingCommand extends $Command< StartLoggingCommandInput, StartLoggingCommandOutput, @@ -34,6 +37,9 @@ export class StartLoggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/StopLoggingCommand.ts b/clients/client-cloudtrail/commands/StopLoggingCommand.ts index 9b98286cfbede..7cf008ba52b04 100644 --- a/clients/client-cloudtrail/commands/StopLoggingCommand.ts +++ b/clients/client-cloudtrail/commands/StopLoggingCommand.ts @@ -20,6 +20,15 @@ import { export type StopLoggingCommandInput = StopLoggingRequest; export type StopLoggingCommandOutput = StopLoggingResponse & __MetadataBearer; +/** + *

Suspends the recording of AWS API calls and log file delivery for the specified trail. + * Under most circumstances, there is no need to use this action. You can update a trail + * without stopping it first. This action is the only way to stop recording. For a trail + * enabled in all regions, this operation must be called from the region in which the trail + * was created, or an InvalidHomeRegionException will occur. This operation + * cannot be called on the shadow trails (replicated trails in other regions) of a trail + * enabled in all regions.

+ */ export class StopLoggingCommand extends $Command< StopLoggingCommandInput, StopLoggingCommandOutput, @@ -34,6 +43,9 @@ export class StopLoggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/commands/UpdateTrailCommand.ts b/clients/client-cloudtrail/commands/UpdateTrailCommand.ts index 47ab3a0eb0c65..48a2529f019ea 100644 --- a/clients/client-cloudtrail/commands/UpdateTrailCommand.ts +++ b/clients/client-cloudtrail/commands/UpdateTrailCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateTrailCommandInput = UpdateTrailRequest; export type UpdateTrailCommandOutput = UpdateTrailResponse & __MetadataBearer; +/** + *

Updates the settings that specify delivery of log files. Changes to a trail do not require + * stopping the CloudTrail service. Use this action to designate an existing bucket for log + * delivery. If the existing bucket has previously been a target for CloudTrail log files, + * an IAM policy exists for the bucket. UpdateTrail must be called from the + * region in which the trail was created; otherwise, an + * InvalidHomeRegionException is thrown.

+ */ export class UpdateTrailCommand extends $Command< UpdateTrailCommandInput, UpdateTrailCommandOutput, @@ -34,6 +42,9 @@ export class UpdateTrailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudTrailClientResolvedConfig, diff --git a/clients/client-cloudtrail/package.json b/clients/client-cloudtrail/package.json index 8449c28de2ed9..18484a954d4a8 100644 --- a/clients/client-cloudtrail/package.json +++ b/clients/client-cloudtrail/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudtrail Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudtrail/pagination/ListPublicKeysPaginator.ts b/clients/client-cloudtrail/pagination/ListPublicKeysPaginator.ts index a83366d2148ca..49a27d9bbcfec 100644 --- a/clients/client-cloudtrail/pagination/ListPublicKeysPaginator.ts +++ b/clients/client-cloudtrail/pagination/ListPublicKeysPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudTrailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudTrailClient, input: ListPublicKeysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPublicKeysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudTrail, input: ListPublicKeysCommandInput, diff --git a/clients/client-cloudtrail/pagination/ListTagsPaginator.ts b/clients/client-cloudtrail/pagination/ListTagsPaginator.ts index dce71f1aaa816..ff296008f5d92 100644 --- a/clients/client-cloudtrail/pagination/ListTagsPaginator.ts +++ b/clients/client-cloudtrail/pagination/ListTagsPaginator.ts @@ -4,6 +4,9 @@ import { ListTagsCommand, ListTagsCommandInput, ListTagsCommandOutput } from ".. import { CloudTrailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudTrailClient, input: ListTagsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudTrail, input: ListTagsCommandInput, diff --git a/clients/client-cloudtrail/pagination/ListTrailsPaginator.ts b/clients/client-cloudtrail/pagination/ListTrailsPaginator.ts index f73da555513b4..c9a0a9a4022da 100644 --- a/clients/client-cloudtrail/pagination/ListTrailsPaginator.ts +++ b/clients/client-cloudtrail/pagination/ListTrailsPaginator.ts @@ -4,6 +4,9 @@ import { ListTrailsCommand, ListTrailsCommandInput, ListTrailsCommandOutput } fr import { CloudTrailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudTrailClient, input: ListTrailsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTrailsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudTrail, input: ListTrailsCommandInput, diff --git a/clients/client-cloudtrail/pagination/LookupEventsPaginator.ts b/clients/client-cloudtrail/pagination/LookupEventsPaginator.ts index d5b1ff8658de6..f9b8f90ddf71a 100644 --- a/clients/client-cloudtrail/pagination/LookupEventsPaginator.ts +++ b/clients/client-cloudtrail/pagination/LookupEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudTrailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudTrailClient, input: LookupEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new LookupEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudTrail, input: LookupEventsCommandInput, diff --git a/clients/client-cloudtrail/runtimeConfig.browser.ts b/clients/client-cloudtrail/runtimeConfig.browser.ts index 1c825ff910917..df85bc44ed515 100644 --- a/clients/client-cloudtrail/runtimeConfig.browser.ts +++ b/clients/client-cloudtrail/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudTrailClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudtrail/runtimeConfig.native.ts b/clients/client-cloudtrail/runtimeConfig.native.ts index 90ee587f063d6..b16ddb69ae2a8 100644 --- a/clients/client-cloudtrail/runtimeConfig.native.ts +++ b/clients/client-cloudtrail/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudTrailClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudtrail/runtimeConfig.shared.ts b/clients/client-cloudtrail/runtimeConfig.shared.ts index a155e6cade25d..4ca3be9b26ef7 100644 --- a/clients/client-cloudtrail/runtimeConfig.shared.ts +++ b/clients/client-cloudtrail/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2013-11-01", disableHostPrefix: false, diff --git a/clients/client-cloudtrail/runtimeConfig.ts b/clients/client-cloudtrail/runtimeConfig.ts index 3c2c500924a85..8164591d03169 100644 --- a/clients/client-cloudtrail/runtimeConfig.ts +++ b/clients/client-cloudtrail/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudTrailClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudtrail/tsconfig.json b/clients/client-cloudtrail/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudtrail/tsconfig.json +++ b/clients/client-cloudtrail/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudwatch-events/commands/ActivateEventSourceCommand.ts b/clients/client-cloudwatch-events/commands/ActivateEventSourceCommand.ts index 725cfd63cc043..cb5312baf8637 100644 --- a/clients/client-cloudwatch-events/commands/ActivateEventSourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/ActivateEventSourceCommand.ts @@ -20,6 +20,10 @@ import { export type ActivateEventSourceCommandInput = ActivateEventSourceRequest; export type ActivateEventSourceCommandOutput = __MetadataBearer; +/** + *

Activates a partner event source that has been deactivated. Once activated, your + * matching event bus will start receiving events from the event source.

+ */ export class ActivateEventSourceCommand extends $Command< ActivateEventSourceCommandInput, ActivateEventSourceCommandOutput, @@ -34,6 +38,9 @@ export class ActivateEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/CancelReplayCommand.ts b/clients/client-cloudwatch-events/commands/CancelReplayCommand.ts index 472b61ab17c61..769b92eaafeec 100644 --- a/clients/client-cloudwatch-events/commands/CancelReplayCommand.ts +++ b/clients/client-cloudwatch-events/commands/CancelReplayCommand.ts @@ -20,6 +20,9 @@ import { export type CancelReplayCommandInput = CancelReplayRequest; export type CancelReplayCommandOutput = CancelReplayResponse & __MetadataBearer; +/** + *

Cancels the specified replay.

+ */ export class CancelReplayCommand extends $Command< CancelReplayCommandInput, CancelReplayCommandOutput, @@ -34,6 +37,9 @@ export class CancelReplayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/CreateArchiveCommand.ts b/clients/client-cloudwatch-events/commands/CreateArchiveCommand.ts index eadb41cabb8fe..1f152646041f6 100644 --- a/clients/client-cloudwatch-events/commands/CreateArchiveCommand.ts +++ b/clients/client-cloudwatch-events/commands/CreateArchiveCommand.ts @@ -20,6 +20,11 @@ import { export type CreateArchiveCommandInput = CreateArchiveRequest; export type CreateArchiveCommandOutput = CreateArchiveResponse & __MetadataBearer; +/** + *

Creates an archive of events with the specified settings. When you create an archive, + * incoming events might not immediately start being sent to the archive. Allow a short + * period of time for changes to take effect.

+ */ export class CreateArchiveCommand extends $Command< CreateArchiveCommandInput, CreateArchiveCommandOutput, @@ -34,6 +39,9 @@ export class CreateArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/CreateEventBusCommand.ts b/clients/client-cloudwatch-events/commands/CreateEventBusCommand.ts index e96178dcbd60f..1b10bb266910a 100644 --- a/clients/client-cloudwatch-events/commands/CreateEventBusCommand.ts +++ b/clients/client-cloudwatch-events/commands/CreateEventBusCommand.ts @@ -20,6 +20,11 @@ import { export type CreateEventBusCommandInput = CreateEventBusRequest; export type CreateEventBusCommandOutput = CreateEventBusResponse & __MetadataBearer; +/** + *

Creates a new event bus within your account. This can be a custom event bus which you + * can use to receive events from your custom applications and services, or it can be a + * partner event bus which can be matched to a partner event source.

+ */ export class CreateEventBusCommand extends $Command< CreateEventBusCommandInput, CreateEventBusCommandOutput, @@ -34,6 +39,9 @@ export class CreateEventBusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/CreatePartnerEventSourceCommand.ts b/clients/client-cloudwatch-events/commands/CreatePartnerEventSourceCommand.ts index a4357827aadad..756509b6ef501 100644 --- a/clients/client-cloudwatch-events/commands/CreatePartnerEventSourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/CreatePartnerEventSourceCommand.ts @@ -20,6 +20,32 @@ import { export type CreatePartnerEventSourceCommandInput = CreatePartnerEventSourceRequest; export type CreatePartnerEventSourceCommandOutput = CreatePartnerEventSourceResponse & __MetadataBearer; +/** + *

Called by an SaaS partner to create a partner event source. This operation is not used + * by AWS customers.

+ *

Each partner event source can be used by one AWS account to create a matching partner + * event bus in that AWS account. A SaaS partner must create one partner event source for + * each AWS account that wants to receive those event types.

+ *

A partner event source creates events based on resources within the SaaS partner's + * service or application.

+ *

An AWS account that creates a partner event bus that matches the partner event source + * can use that event bus to receive events from the partner, and then process them using + * AWS Events rules and targets.

+ *

Partner event source names follow this format:

+ *

+ * + * partner_name/event_namespace/event_name + * + *

+ *

+ * partner_name is determined during partner registration and + * identifies the partner to AWS customers. event_namespace is + * determined by the partner and is a way for the partner to categorize their events. + * event_name is determined by the partner, and should uniquely + * identify an event-generating resource within the partner system. The combination of + * event_namespace and event_name should help + * AWS customers decide whether to create an event bus to receive these events.

+ */ export class CreatePartnerEventSourceCommand extends $Command< CreatePartnerEventSourceCommandInput, CreatePartnerEventSourceCommandOutput, @@ -34,6 +60,9 @@ export class CreatePartnerEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DeactivateEventSourceCommand.ts b/clients/client-cloudwatch-events/commands/DeactivateEventSourceCommand.ts index c34a17069d03e..55eb1c8bfa585 100644 --- a/clients/client-cloudwatch-events/commands/DeactivateEventSourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/DeactivateEventSourceCommand.ts @@ -20,6 +20,13 @@ import { export type DeactivateEventSourceCommandInput = DeactivateEventSourceRequest; export type DeactivateEventSourceCommandOutput = __MetadataBearer; +/** + *

You can use this operation to temporarily stop receiving events from the specified + * partner event source. The matching event bus is not deleted.

+ *

When you deactivate a partner event source, the source goes into PENDING state. If it + * remains in PENDING state for more than two weeks, it is deleted.

+ *

To activate a deactivated partner event source, use ActivateEventSource.

+ */ export class DeactivateEventSourceCommand extends $Command< DeactivateEventSourceCommandInput, DeactivateEventSourceCommandOutput, @@ -34,6 +41,9 @@ export class DeactivateEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DeleteArchiveCommand.ts b/clients/client-cloudwatch-events/commands/DeleteArchiveCommand.ts index 8716acb6d3934..34cde7639dd42 100644 --- a/clients/client-cloudwatch-events/commands/DeleteArchiveCommand.ts +++ b/clients/client-cloudwatch-events/commands/DeleteArchiveCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteArchiveCommandInput = DeleteArchiveRequest; export type DeleteArchiveCommandOutput = DeleteArchiveResponse & __MetadataBearer; +/** + *

Deletes the specified archive.

+ */ export class DeleteArchiveCommand extends $Command< DeleteArchiveCommandInput, DeleteArchiveCommandOutput, @@ -34,6 +37,9 @@ export class DeleteArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DeleteEventBusCommand.ts b/clients/client-cloudwatch-events/commands/DeleteEventBusCommand.ts index 8fc78a6b9c4fd..8e7883a0d5353 100644 --- a/clients/client-cloudwatch-events/commands/DeleteEventBusCommand.ts +++ b/clients/client-cloudwatch-events/commands/DeleteEventBusCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteEventBusCommandInput = DeleteEventBusRequest; export type DeleteEventBusCommandOutput = __MetadataBearer; +/** + *

Deletes the specified custom event bus or partner event bus. All rules associated with + * this event bus need to be deleted. You can't delete your account's default event + * bus.

+ */ export class DeleteEventBusCommand extends $Command< DeleteEventBusCommandInput, DeleteEventBusCommandOutput, @@ -34,6 +39,9 @@ export class DeleteEventBusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DeletePartnerEventSourceCommand.ts b/clients/client-cloudwatch-events/commands/DeletePartnerEventSourceCommand.ts index 93db13059759b..9cd7515e85ad5 100644 --- a/clients/client-cloudwatch-events/commands/DeletePartnerEventSourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/DeletePartnerEventSourceCommand.ts @@ -20,6 +20,13 @@ import { export type DeletePartnerEventSourceCommandInput = DeletePartnerEventSourceRequest; export type DeletePartnerEventSourceCommandOutput = __MetadataBearer; +/** + *

This operation is used by SaaS partners to delete a partner event source. This + * operation is not used by AWS customers.

+ *

When you delete an event source, the status of the corresponding partner event bus in + * the AWS customer account becomes DELETED.

+ *

+ */ export class DeletePartnerEventSourceCommand extends $Command< DeletePartnerEventSourceCommandInput, DeletePartnerEventSourceCommandOutput, @@ -34,6 +41,9 @@ export class DeletePartnerEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DeleteRuleCommand.ts b/clients/client-cloudwatch-events/commands/DeleteRuleCommand.ts index 25549b25e760c..d7a0cdd3faf62 100644 --- a/clients/client-cloudwatch-events/commands/DeleteRuleCommand.ts +++ b/clients/client-cloudwatch-events/commands/DeleteRuleCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteRuleCommandInput = DeleteRuleRequest; export type DeleteRuleCommandOutput = __MetadataBearer; +/** + *

Deletes the specified rule.

+ *

Before you can delete the rule, you must remove all targets, using RemoveTargets.

+ * + *

When you delete a rule, incoming events might continue to match to the deleted + * rule. Allow a short period of time for changes to take effect.

+ * + *

Managed rules are rules created and managed by another AWS service on your behalf. + * These rules are created by those other AWS services to support functionality in those + * services. You can delete these rules using the Force option, but you should + * do so only if you are sure the other service is not still using that rule.

+ */ export class DeleteRuleCommand extends $Command< DeleteRuleCommandInput, DeleteRuleCommandOutput, @@ -34,6 +46,9 @@ export class DeleteRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DescribeArchiveCommand.ts b/clients/client-cloudwatch-events/commands/DescribeArchiveCommand.ts index 95ecc4d31ce38..9fddef2d6953f 100644 --- a/clients/client-cloudwatch-events/commands/DescribeArchiveCommand.ts +++ b/clients/client-cloudwatch-events/commands/DescribeArchiveCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeArchiveCommandInput = DescribeArchiveRequest; export type DescribeArchiveCommandOutput = DescribeArchiveResponse & __MetadataBearer; +/** + *

Retrieves details about an archive.

+ */ export class DescribeArchiveCommand extends $Command< DescribeArchiveCommandInput, DescribeArchiveCommandOutput, @@ -34,6 +37,9 @@ export class DescribeArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DescribeEventBusCommand.ts b/clients/client-cloudwatch-events/commands/DescribeEventBusCommand.ts index 517ddefcfa01a..6773e6a4eb35b 100644 --- a/clients/client-cloudwatch-events/commands/DescribeEventBusCommand.ts +++ b/clients/client-cloudwatch-events/commands/DescribeEventBusCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeEventBusCommandInput = DescribeEventBusRequest; export type DescribeEventBusCommandOutput = DescribeEventBusResponse & __MetadataBearer; +/** + *

Displays details about an event bus in your account. This can include the external + * AWS accounts that are permitted to write events to your default event bus, and the + * associated policy. For custom event buses and partner event buses, it displays the name, + * ARN, policy, state, and creation time.

+ *

To enable your account to receive events from other accounts on its default event + * bus, use PutPermission.

+ *

For more information about partner event buses, see CreateEventBus.

+ */ export class DescribeEventBusCommand extends $Command< DescribeEventBusCommandInput, DescribeEventBusCommandOutput, @@ -34,6 +43,9 @@ export class DescribeEventBusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DescribeEventSourceCommand.ts b/clients/client-cloudwatch-events/commands/DescribeEventSourceCommand.ts index 1b6e9bbc5514c..d00a6bffa838f 100644 --- a/clients/client-cloudwatch-events/commands/DescribeEventSourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/DescribeEventSourceCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEventSourceCommandInput = DescribeEventSourceRequest; export type DescribeEventSourceCommandOutput = DescribeEventSourceResponse & __MetadataBearer; +/** + *

This operation lists details about a partner event source that is shared with your + * account.

+ */ export class DescribeEventSourceCommand extends $Command< DescribeEventSourceCommandInput, DescribeEventSourceCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DescribePartnerEventSourceCommand.ts b/clients/client-cloudwatch-events/commands/DescribePartnerEventSourceCommand.ts index c55ed5d899a2a..c5c2abcb2f20a 100644 --- a/clients/client-cloudwatch-events/commands/DescribePartnerEventSourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/DescribePartnerEventSourceCommand.ts @@ -20,6 +20,12 @@ import { export type DescribePartnerEventSourceCommandInput = DescribePartnerEventSourceRequest; export type DescribePartnerEventSourceCommandOutput = DescribePartnerEventSourceResponse & __MetadataBearer; +/** + *

An SaaS partner can use this operation to list details about a partner event source + * that they have created. AWS customers do not use this operation. Instead, AWS customers + * can use DescribeEventSource to see details about a partner event + * source that is shared with them.

+ */ export class DescribePartnerEventSourceCommand extends $Command< DescribePartnerEventSourceCommandInput, DescribePartnerEventSourceCommandOutput, @@ -34,6 +40,9 @@ export class DescribePartnerEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DescribeReplayCommand.ts b/clients/client-cloudwatch-events/commands/DescribeReplayCommand.ts index 827836afadd7f..061ba719b428e 100644 --- a/clients/client-cloudwatch-events/commands/DescribeReplayCommand.ts +++ b/clients/client-cloudwatch-events/commands/DescribeReplayCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeReplayCommandInput = DescribeReplayRequest; export type DescribeReplayCommandOutput = DescribeReplayResponse & __MetadataBearer; +/** + *

Retrieves details about a replay. Use DescribeReplay to determine the + * progress of a running replay. A replay processes events to replay based on + * the time in the event, and replays them using 1 minute intervals. If you use StartReplay and specify an + * EventStartTime and an EventEndTime that covers a 20 minute + * time range, the events are replayed from the first minute of that 20 minute range first. + * Then the events from the second minute are replayed. You can use + * DescribeReplay to determine the progress of a replay. The value + * returned for EventLastReplayedTime indicates the time within the specified + * time range associated with the last event replayed.

+ */ export class DescribeReplayCommand extends $Command< DescribeReplayCommandInput, DescribeReplayCommandOutput, @@ -34,6 +45,9 @@ export class DescribeReplayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DescribeRuleCommand.ts b/clients/client-cloudwatch-events/commands/DescribeRuleCommand.ts index 7d4d4c946bd3f..4ced6b1d75ac0 100644 --- a/clients/client-cloudwatch-events/commands/DescribeRuleCommand.ts +++ b/clients/client-cloudwatch-events/commands/DescribeRuleCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeRuleCommandInput = DescribeRuleRequest; export type DescribeRuleCommandOutput = DescribeRuleResponse & __MetadataBearer; +/** + *

Describes the specified rule.

+ *

DescribeRule does not list the targets of a rule. To see the targets associated + * with a rule, use ListTargetsByRule.

+ */ export class DescribeRuleCommand extends $Command< DescribeRuleCommandInput, DescribeRuleCommandOutput, @@ -34,6 +39,9 @@ export class DescribeRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/DisableRuleCommand.ts b/clients/client-cloudwatch-events/commands/DisableRuleCommand.ts index dcbf2a0194146..421b283222667 100644 --- a/clients/client-cloudwatch-events/commands/DisableRuleCommand.ts +++ b/clients/client-cloudwatch-events/commands/DisableRuleCommand.ts @@ -20,6 +20,13 @@ import { export type DisableRuleCommandInput = DisableRuleRequest; export type DisableRuleCommandOutput = __MetadataBearer; +/** + *

Disables the specified rule. A disabled rule won't match any events, and won't + * self-trigger if it has a schedule expression.

+ * + *

When you disable a rule, incoming events might continue to match to the disabled + * rule. Allow a short period of time for changes to take effect.

+ */ export class DisableRuleCommand extends $Command< DisableRuleCommandInput, DisableRuleCommandOutput, @@ -34,6 +41,9 @@ export class DisableRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/EnableRuleCommand.ts b/clients/client-cloudwatch-events/commands/EnableRuleCommand.ts index e50cceb6ee708..4c7cb9c4ad75e 100644 --- a/clients/client-cloudwatch-events/commands/EnableRuleCommand.ts +++ b/clients/client-cloudwatch-events/commands/EnableRuleCommand.ts @@ -20,6 +20,13 @@ import { export type EnableRuleCommandInput = EnableRuleRequest; export type EnableRuleCommandOutput = __MetadataBearer; +/** + *

Enables the specified rule. If the rule does not exist, the operation + * fails.

+ * + *

When you enable a rule, incoming events might not immediately start matching to a + * newly enabled rule. Allow a short period of time for changes to take effect.

+ */ export class EnableRuleCommand extends $Command< EnableRuleCommandInput, EnableRuleCommandOutput, @@ -34,6 +41,9 @@ export class EnableRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListArchivesCommand.ts b/clients/client-cloudwatch-events/commands/ListArchivesCommand.ts index fe1e0686b6737..134f7a2921291 100644 --- a/clients/client-cloudwatch-events/commands/ListArchivesCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListArchivesCommand.ts @@ -20,6 +20,10 @@ import { export type ListArchivesCommandInput = ListArchivesRequest; export type ListArchivesCommandOutput = ListArchivesResponse & __MetadataBearer; +/** + *

Lists your archives. You can either list all the archives or you can provide a prefix + * to match to the archive names. Filter parameters are exclusive.

+ */ export class ListArchivesCommand extends $Command< ListArchivesCommandInput, ListArchivesCommandOutput, @@ -34,6 +38,9 @@ export class ListArchivesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListEventBusesCommand.ts b/clients/client-cloudwatch-events/commands/ListEventBusesCommand.ts index 32b574435a2ac..7a7c112645344 100644 --- a/clients/client-cloudwatch-events/commands/ListEventBusesCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListEventBusesCommand.ts @@ -20,6 +20,10 @@ import { export type ListEventBusesCommandInput = ListEventBusesRequest; export type ListEventBusesCommandOutput = ListEventBusesResponse & __MetadataBearer; +/** + *

Lists all the event buses in your account, including the default event bus, custom + * event buses, and partner event buses.

+ */ export class ListEventBusesCommand extends $Command< ListEventBusesCommandInput, ListEventBusesCommandOutput, @@ -34,6 +38,9 @@ export class ListEventBusesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListEventSourcesCommand.ts b/clients/client-cloudwatch-events/commands/ListEventSourcesCommand.ts index c61f2193b1e31..0812c5f1569e0 100644 --- a/clients/client-cloudwatch-events/commands/ListEventSourcesCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListEventSourcesCommand.ts @@ -20,6 +20,10 @@ import { export type ListEventSourcesCommandInput = ListEventSourcesRequest; export type ListEventSourcesCommandOutput = ListEventSourcesResponse & __MetadataBearer; +/** + *

You can use this to see all the partner event sources that have been shared with your + * AWS account. For more information about partner event sources, see CreateEventBus.

+ */ export class ListEventSourcesCommand extends $Command< ListEventSourcesCommandInput, ListEventSourcesCommandOutput, @@ -34,6 +38,9 @@ export class ListEventSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListPartnerEventSourceAccountsCommand.ts b/clients/client-cloudwatch-events/commands/ListPartnerEventSourceAccountsCommand.ts index 2ea4fb6561dfd..0feb1e1ff1689 100644 --- a/clients/client-cloudwatch-events/commands/ListPartnerEventSourceAccountsCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListPartnerEventSourceAccountsCommand.ts @@ -20,6 +20,11 @@ import { export type ListPartnerEventSourceAccountsCommandInput = ListPartnerEventSourceAccountsRequest; export type ListPartnerEventSourceAccountsCommandOutput = ListPartnerEventSourceAccountsResponse & __MetadataBearer; +/** + *

An SaaS partner can use this operation to display the AWS account ID that a particular + * partner event source name is associated with. This operation is not used by AWS + * customers.

+ */ export class ListPartnerEventSourceAccountsCommand extends $Command< ListPartnerEventSourceAccountsCommandInput, ListPartnerEventSourceAccountsCommandOutput, @@ -34,6 +39,9 @@ export class ListPartnerEventSourceAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListPartnerEventSourcesCommand.ts b/clients/client-cloudwatch-events/commands/ListPartnerEventSourcesCommand.ts index a26d73c24aca5..19e683a7a5d5f 100644 --- a/clients/client-cloudwatch-events/commands/ListPartnerEventSourcesCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListPartnerEventSourcesCommand.ts @@ -20,6 +20,10 @@ import { export type ListPartnerEventSourcesCommandInput = ListPartnerEventSourcesRequest; export type ListPartnerEventSourcesCommandOutput = ListPartnerEventSourcesResponse & __MetadataBearer; +/** + *

An SaaS partner can use this operation to list all the partner event source names that + * they have created. This operation is not used by AWS customers.

+ */ export class ListPartnerEventSourcesCommand extends $Command< ListPartnerEventSourcesCommandInput, ListPartnerEventSourcesCommandOutput, @@ -34,6 +38,9 @@ export class ListPartnerEventSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListReplaysCommand.ts b/clients/client-cloudwatch-events/commands/ListReplaysCommand.ts index 24452b55dbc1b..ec4e9e6532ba9 100644 --- a/clients/client-cloudwatch-events/commands/ListReplaysCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListReplaysCommand.ts @@ -20,6 +20,10 @@ import { export type ListReplaysCommandInput = ListReplaysRequest; export type ListReplaysCommandOutput = ListReplaysResponse & __MetadataBearer; +/** + *

Lists your replays. You can either list all the replays or you can provide a prefix to + * match to the replay names. Filter parameters are exclusive.

+ */ export class ListReplaysCommand extends $Command< ListReplaysCommandInput, ListReplaysCommandOutput, @@ -34,6 +38,9 @@ export class ListReplaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListRuleNamesByTargetCommand.ts b/clients/client-cloudwatch-events/commands/ListRuleNamesByTargetCommand.ts index a152953bb04b8..78d5c0ddfbdb9 100644 --- a/clients/client-cloudwatch-events/commands/ListRuleNamesByTargetCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListRuleNamesByTargetCommand.ts @@ -20,6 +20,10 @@ import { export type ListRuleNamesByTargetCommandInput = ListRuleNamesByTargetRequest; export type ListRuleNamesByTargetCommandOutput = ListRuleNamesByTargetResponse & __MetadataBearer; +/** + *

Lists the rules for the specified target. You can see which of the rules in Amazon + * EventBridge can invoke a specific target in your account.

+ */ export class ListRuleNamesByTargetCommand extends $Command< ListRuleNamesByTargetCommandInput, ListRuleNamesByTargetCommandOutput, @@ -34,6 +38,9 @@ export class ListRuleNamesByTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListRulesCommand.ts b/clients/client-cloudwatch-events/commands/ListRulesCommand.ts index 95831f3d09509..c21c05b752408 100644 --- a/clients/client-cloudwatch-events/commands/ListRulesCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListRulesCommand.ts @@ -17,6 +17,13 @@ import { export type ListRulesCommandInput = ListRulesRequest; export type ListRulesCommandOutput = ListRulesResponse & __MetadataBearer; +/** + *

Lists your Amazon EventBridge rules. You can either list all the rules or you can + * provide a prefix to match to the rule names.

+ * + *

ListRules does not list the targets of a rule. To see the targets associated with a + * rule, use ListTargetsByRule.

+ */ export class ListRulesCommand extends $Command< ListRulesCommandInput, ListRulesCommandOutput, @@ -31,6 +38,9 @@ export class ListRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListTagsForResourceCommand.ts b/clients/client-cloudwatch-events/commands/ListTagsForResourceCommand.ts index 735cb4d81ba54..d3a6f06fc10e9 100644 --- a/clients/client-cloudwatch-events/commands/ListTagsForResourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Displays the tags associated with an EventBridge resource. In EventBridge, rules and + * event buses can be tagged.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/ListTargetsByRuleCommand.ts b/clients/client-cloudwatch-events/commands/ListTargetsByRuleCommand.ts index 8e433b1cb1765..54c91b716fd59 100644 --- a/clients/client-cloudwatch-events/commands/ListTargetsByRuleCommand.ts +++ b/clients/client-cloudwatch-events/commands/ListTargetsByRuleCommand.ts @@ -20,6 +20,9 @@ import { export type ListTargetsByRuleCommandInput = ListTargetsByRuleRequest; export type ListTargetsByRuleCommandOutput = ListTargetsByRuleResponse & __MetadataBearer; +/** + *

Lists the targets assigned to the specified rule.

+ */ export class ListTargetsByRuleCommand extends $Command< ListTargetsByRuleCommandInput, ListTargetsByRuleCommandOutput, @@ -34,6 +37,9 @@ export class ListTargetsByRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/PutEventsCommand.ts b/clients/client-cloudwatch-events/commands/PutEventsCommand.ts index e0de46e187dff..b740b2f82a0b8 100644 --- a/clients/client-cloudwatch-events/commands/PutEventsCommand.ts +++ b/clients/client-cloudwatch-events/commands/PutEventsCommand.ts @@ -17,6 +17,10 @@ import { export type PutEventsCommandInput = PutEventsRequest; export type PutEventsCommandOutput = PutEventsResponse & __MetadataBearer; +/** + *

Sends custom events to Amazon EventBridge so that they can be matched to + * rules.

+ */ export class PutEventsCommand extends $Command< PutEventsCommandInput, PutEventsCommandOutput, @@ -31,6 +35,9 @@ export class PutEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/PutPartnerEventsCommand.ts b/clients/client-cloudwatch-events/commands/PutPartnerEventsCommand.ts index 564ac61e14633..a4a2ba88c298a 100644 --- a/clients/client-cloudwatch-events/commands/PutPartnerEventsCommand.ts +++ b/clients/client-cloudwatch-events/commands/PutPartnerEventsCommand.ts @@ -20,6 +20,10 @@ import { export type PutPartnerEventsCommandInput = PutPartnerEventsRequest; export type PutPartnerEventsCommandOutput = PutPartnerEventsResponse & __MetadataBearer; +/** + *

This is used by SaaS partners to write events to a customer's partner event bus. AWS + * customers do not use this operation.

+ */ export class PutPartnerEventsCommand extends $Command< PutPartnerEventsCommandInput, PutPartnerEventsCommandOutput, @@ -34,6 +38,9 @@ export class PutPartnerEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/PutPermissionCommand.ts b/clients/client-cloudwatch-events/commands/PutPermissionCommand.ts index 8b8869f5843f0..0466f4c845a43 100644 --- a/clients/client-cloudwatch-events/commands/PutPermissionCommand.ts +++ b/clients/client-cloudwatch-events/commands/PutPermissionCommand.ts @@ -20,6 +20,30 @@ import { export type PutPermissionCommandInput = PutPermissionRequest; export type PutPermissionCommandOutput = __MetadataBearer; +/** + *

Running PutPermission permits the specified AWS account or AWS + * organization to put events to the specified event bus. Amazon + * EventBridge (CloudWatch Events) rules in your account are triggered by these events + * arriving to an event bus in your account.

+ *

For another account to send events to your account, that external account must have + * an EventBridge rule with your account's event bus as a target.

+ * + *

To enable multiple AWS accounts to put events to your event bus, run + * PutPermission once for each of these accounts. Or, if all the accounts + * are members of the same AWS organization, you can run PutPermission once + * specifying Principal as "*" and specifying the AWS organization ID in + * Condition, to grant permissions to all accounts in that + * organization.

+ * + *

If you grant permissions using an organization, then accounts in that organization + * must specify a RoleArn with proper permissions when they use + * PutTarget to add your account's event bus as a target. For more + * information, see Sending and Receiving Events Between AWS Accounts in the Amazon + * EventBridge User Guide.

+ * + *

The permission policy on the default event bus cannot exceed 10 KB in + * size.

+ */ export class PutPermissionCommand extends $Command< PutPermissionCommandInput, PutPermissionCommandOutput, @@ -34,6 +58,9 @@ export class PutPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/PutRuleCommand.ts b/clients/client-cloudwatch-events/commands/PutRuleCommand.ts index e6b4644d3001b..32bccc1e0f8fc 100644 --- a/clients/client-cloudwatch-events/commands/PutRuleCommand.ts +++ b/clients/client-cloudwatch-events/commands/PutRuleCommand.ts @@ -17,6 +17,58 @@ import { export type PutRuleCommandInput = PutRuleRequest; export type PutRuleCommandOutput = PutRuleResponse & __MetadataBearer; +/** + *

Creates or updates the specified rule. Rules are enabled by default, or based on + * value of the state. You can disable a rule using DisableRule.

+ * + *

A single rule watches for events from a single event bus. Events generated by AWS + * services go to your account's default event bus. Events generated by SaaS partner + * services or applications go to the matching partner event bus. If you have custom + * applications or services, you can specify whether their events go to your default event + * bus or a custom event bus that you have created. For more information, see CreateEventBus.

+ * + *

If you are updating an existing rule, the rule is replaced with what you specify in + * this PutRule command. If you omit arguments in PutRule, the + * old values for those arguments are not kept. Instead, they are replaced with null + * values.

+ * + *

When you create or update a rule, incoming events might not immediately start + * matching to new or updated rules. Allow a short period of time for changes to take + * effect.

+ * + *

A rule must contain at least an EventPattern or ScheduleExpression. Rules with + * EventPatterns are triggered when a matching event is observed. Rules with + * ScheduleExpressions self-trigger based on the given schedule. A rule can have both an + * EventPattern and a ScheduleExpression, in which case the rule triggers on matching + * events as well as on a schedule.

+ * + *

When you initially create a rule, you can optionally assign one or more tags to the + * rule. Tags can help you organize and categorize your resources. You can also use them to + * scope user permissions, by granting a user permission to access or change only rules + * with certain tag values. To use the PutRule operation and assign tags, you + * must have both the events:PutRule and events:TagResource + * permissions.

+ *

If you are updating an existing rule, any tags you specify in the PutRule + * operation are ignored. To update the tags of an existing rule, use TagResource and UntagResource.

+ * + *

Most services in AWS treat : or / as the same character in Amazon Resource Names + * (ARNs). However, EventBridge uses an exact match in event patterns and rules. Be sure to + * use the correct ARN characters when creating event patterns so that they match the ARN + * syntax in the event you want to match.

+ * + *

In EventBridge, it is possible to create rules that lead to infinite loops, where a + * rule is fired repeatedly. For example, a rule might detect that ACLs have changed on an + * S3 bucket, and trigger software to change them to the desired state. If the rule is not + * written carefully, the subsequent change to the ACLs fires the rule again, creating an + * infinite loop.

+ *

To prevent this, write the rules so that the triggered actions do not re-fire the same + * rule. For example, your rule could fire only if ACLs are found to be in a bad state, + * instead of after any change.

+ *

An infinite loop can quickly cause higher than expected charges. We recommend that you + * use budgeting, which alerts you when charges exceed your specified limit. For more + * information, see Managing Your + * Costs with Budgets.

+ */ export class PutRuleCommand extends $Command< PutRuleCommandInput, PutRuleCommandOutput, @@ -31,6 +83,9 @@ export class PutRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/PutTargetsCommand.ts b/clients/client-cloudwatch-events/commands/PutTargetsCommand.ts index ad7d64f5e7c22..9dcae1c9dbd1e 100644 --- a/clients/client-cloudwatch-events/commands/PutTargetsCommand.ts +++ b/clients/client-cloudwatch-events/commands/PutTargetsCommand.ts @@ -20,6 +20,153 @@ import { export type PutTargetsCommandInput = PutTargetsRequest; export type PutTargetsCommandOutput = PutTargetsResponse & __MetadataBearer; +/** + *

Adds the specified targets to the specified rule, or updates the targets if they + * are already associated with the rule.

+ *

Targets are the resources that are invoked when a rule is triggered.

+ *

You can configure the following as targets for Events:

+ * + *
    + *
  • + *

    EC2 instances

    + *
  • + *
  • + *

    SSM Run Command

    + *
  • + *
  • + *

    SSM Automation

    + *
  • + *
  • + *

    AWS Lambda functions

    + *
  • + *
  • + *

    Data streams in Amazon Kinesis Data Streams

    + *
  • + *
  • + *

    Data delivery streams in Amazon Kinesis Data Firehose

    + *
  • + *
  • + *

    Amazon ECS tasks

    + *
  • + *
  • + *

    AWS Step Functions state machines

    + *
  • + *
  • + *

    AWS Batch jobs

    + *
  • + *
  • + *

    AWS CodeBuild projects

    + *
  • + *
  • + *

    Pipelines in AWS CodePipeline

    + *
  • + *
  • + *

    Amazon Inspector assessment templates

    + *
  • + *
  • + *

    Amazon SNS topics

    + *
  • + *
  • + *

    Amazon SQS queues, including FIFO queues

    + *
  • + *
  • + *

    The default event bus of another AWS account

    + *
  • + *
  • + *

    Amazon API Gateway REST APIs

    + *
  • + *
  • + *

    Redshift Clusters to invoke Data API ExecuteStatement on

    + *
  • + *
+ * + * + * + *

Creating rules with built-in targets is supported only in the AWS Management + * Console. The built-in targets are EC2 CreateSnapshot API call, EC2 + * RebootInstances API call, EC2 StopInstances API call, and + * EC2 TerminateInstances API call.

+ * + *

For some target types, PutTargets provides target-specific parameters. + * If the target is a Kinesis data stream, you can optionally specify which shard the event + * goes to by using the KinesisParameters argument. To invoke a command on + * multiple EC2 instances with one rule, you can use the RunCommandParameters + * field.

+ *

To be able to make API calls against the resources that you own, Amazon EventBridge + * (CloudWatch Events) needs the appropriate permissions. For AWS Lambda and Amazon SNS + * resources, EventBridge relies on resource-based policies. For EC2 instances, Kinesis + * data streams, AWS Step Functions state machines and API Gateway REST APIs, EventBridge + * relies on IAM roles that you specify in the RoleARN argument in + * PutTargets. For more information, see Authentication and Access Control in the Amazon EventBridge User + * Guide.

+ * + *

If another AWS account is in the same region and has granted you permission (using + * PutPermission), you can send events to that account. Set that account's + * event bus as a target of the rules in your account. To send the matched events to the + * other account, specify that account's event bus as the Arn value when you + * run PutTargets. If your account sends events to another account, your + * account is charged for each sent event. Each event sent to another account is charged as + * a custom event. The account receiving the event is not charged. For more information, + * see Amazon EventBridge + * (CloudWatch Events) Pricing.

+ * + * + *

+ * Input, InputPath, and InputTransformer are + * not available with PutTarget if the target is an event bus of a + * different AWS account.

+ *
+ * + *

If you are setting the event bus of another account as the target, and that account + * granted permission to your account through an organization instead of directly by the + * account ID, then you must specify a RoleArn with proper permissions in the + * Target structure. For more information, see Sending and Receiving Events Between AWS Accounts in the Amazon + * EventBridge User Guide.

+ * + *

For more information about enabling cross-account events, see PutPermission.

+ * + *

+ * Input, InputPath, and + * InputTransformer are mutually exclusive and + * optional parameters of a target. When a rule is triggered due to a matched + * event:

+ * + *
    + *
  • + *

    If none of the following arguments are specified for a target, then the + * entire event is passed to the target in JSON format (unless the target is Amazon + * EC2 Run Command or Amazon ECS task, in which case nothing from the event is + * passed to the target).

    + *
  • + *
  • + *

    If Input is specified in the form of valid + * JSON, then the matched event is overridden with this constant.

    + *
  • + *
  • + *

    If InputPath is specified in the form of + * JSONPath (for example, $.detail), then only the part of the event + * specified in the path is passed to the target (for example, only the detail part + * of the event is passed).

    + *
  • + *
  • + *

    If InputTransformer is specified, then one + * or more specified JSONPaths are extracted from the event and used as values in a + * template that you specify as the input to the target.

    + *
  • + *
+ * + *

When you specify InputPath or InputTransformer, you must + * use JSON dot notation, not bracket notation.

+ * + *

When you add targets to a rule and the associated rule triggers soon after, new or + * updated targets might not be immediately invoked. Allow a short period of time for + * changes to take effect.

+ * + *

This action can partially fail if too many requests are made at the same time. If + * that happens, FailedEntryCount is non-zero in the response and each entry + * in FailedEntries provides the ID of the failed target and the error + * code.

+ */ export class PutTargetsCommand extends $Command< PutTargetsCommandInput, PutTargetsCommandOutput, @@ -34,6 +181,9 @@ export class PutTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/RemovePermissionCommand.ts b/clients/client-cloudwatch-events/commands/RemovePermissionCommand.ts index f58f9632f80ff..6eb8661a2abb3 100644 --- a/clients/client-cloudwatch-events/commands/RemovePermissionCommand.ts +++ b/clients/client-cloudwatch-events/commands/RemovePermissionCommand.ts @@ -20,6 +20,12 @@ import { export type RemovePermissionCommandInput = RemovePermissionRequest; export type RemovePermissionCommandOutput = __MetadataBearer; +/** + *

Revokes the permission of another AWS account to be able to put events to the + * specified event bus. Specify the account to revoke by the StatementId value + * that you associated with the account when you granted it permission with + * PutPermission. You can find the StatementId by using DescribeEventBus.

+ */ export class RemovePermissionCommand extends $Command< RemovePermissionCommandInput, RemovePermissionCommandOutput, @@ -34,6 +40,9 @@ export class RemovePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/RemoveTargetsCommand.ts b/clients/client-cloudwatch-events/commands/RemoveTargetsCommand.ts index 0c5682c3099bc..cf630e58f0c5a 100644 --- a/clients/client-cloudwatch-events/commands/RemoveTargetsCommand.ts +++ b/clients/client-cloudwatch-events/commands/RemoveTargetsCommand.ts @@ -20,6 +20,19 @@ import { export type RemoveTargetsCommandInput = RemoveTargetsRequest; export type RemoveTargetsCommandOutput = RemoveTargetsResponse & __MetadataBearer; +/** + *

Removes the specified targets from the specified rule. When the rule is triggered, + * those targets are no longer be invoked.

+ * + *

When you remove a target, when the associated rule triggers, removed targets might + * continue to be invoked. Allow a short period of time for changes to take + * effect.

+ * + *

This action can partially fail if too many requests are made at the same time. If + * that happens, FailedEntryCount is non-zero in the response and each entry + * in FailedEntries provides the ID of the failed target and the error + * code.

+ */ export class RemoveTargetsCommand extends $Command< RemoveTargetsCommandInput, RemoveTargetsCommandOutput, @@ -34,6 +47,9 @@ export class RemoveTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/StartReplayCommand.ts b/clients/client-cloudwatch-events/commands/StartReplayCommand.ts index ec853a7f857c6..b4e95d6f9b60b 100644 --- a/clients/client-cloudwatch-events/commands/StartReplayCommand.ts +++ b/clients/client-cloudwatch-events/commands/StartReplayCommand.ts @@ -20,6 +20,17 @@ import { export type StartReplayCommandInput = StartReplayRequest; export type StartReplayCommandOutput = StartReplayResponse & __MetadataBearer; +/** + *

Starts the specified replay. Events are not necessarily replayed in the exact same + * order that they were added to the archive. A replay processes events to replay based on + * the time in the event, and replays them using 1 minute intervals. If you specify an + * EventStartTime and an EventEndTime that covers a 20 minute + * time range, the events are replayed from the first minute of that 20 minute range first. + * Then the events from the second minute are replayed. You can use + * DescribeReplay to determine the progress of a replay. The value + * returned for EventLastReplayedTime indicates the time within the specified + * time range associated with the last event replayed.

+ */ export class StartReplayCommand extends $Command< StartReplayCommandInput, StartReplayCommandOutput, @@ -34,6 +45,9 @@ export class StartReplayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/TagResourceCommand.ts b/clients/client-cloudwatch-events/commands/TagResourceCommand.ts index 94b16c710e057..38e57d839dd20 100644 --- a/clients/client-cloudwatch-events/commands/TagResourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/TagResourceCommand.ts @@ -20,6 +20,19 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Assigns one or more tags (key-value pairs) to the specified EventBridge resource. Tags + * can help you organize and categorize your resources. You can also use them to scope user + * permissions by granting a user permission to access or change only resources with + * certain tag values. In EventBridge, rules and event buses can be tagged.

+ *

Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of + * characters.

+ *

You can use the TagResource action with a resource that already has tags. + * If you specify a new tag key, this tag is appended to the list of tags associated with + * the resource. If you specify a tag key that is already associated with the resource, the + * new tag value that you specify replaces the previous value for that tag.

+ *

You can associate as many as 50 tags with a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +47,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/TestEventPatternCommand.ts b/clients/client-cloudwatch-events/commands/TestEventPatternCommand.ts index 3aef523f221ce..3ac2a67391230 100644 --- a/clients/client-cloudwatch-events/commands/TestEventPatternCommand.ts +++ b/clients/client-cloudwatch-events/commands/TestEventPatternCommand.ts @@ -20,6 +20,13 @@ import { export type TestEventPatternCommandInput = TestEventPatternRequest; export type TestEventPatternCommandOutput = TestEventPatternResponse & __MetadataBearer; +/** + *

Tests whether the specified event pattern matches the provided event.

+ *

Most services in AWS treat : or / as the same character in Amazon Resource Names + * (ARNs). However, EventBridge uses an exact match in event patterns and rules. Be sure to + * use the correct ARN characters when creating event patterns so that they match the ARN + * syntax in the event you want to match.

+ */ export class TestEventPatternCommand extends $Command< TestEventPatternCommandInput, TestEventPatternCommandOutput, @@ -34,6 +41,9 @@ export class TestEventPatternCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/UntagResourceCommand.ts b/clients/client-cloudwatch-events/commands/UntagResourceCommand.ts index bbdf4cfe41f86..ba5e1a94a80c0 100644 --- a/clients/client-cloudwatch-events/commands/UntagResourceCommand.ts +++ b/clients/client-cloudwatch-events/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from the specified EventBridge resource. In Amazon + * EventBridge (CloudWatch Events, rules and event buses can be tagged.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/commands/UpdateArchiveCommand.ts b/clients/client-cloudwatch-events/commands/UpdateArchiveCommand.ts index aebec41142c3b..9547cccbfd0e0 100644 --- a/clients/client-cloudwatch-events/commands/UpdateArchiveCommand.ts +++ b/clients/client-cloudwatch-events/commands/UpdateArchiveCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateArchiveCommandInput = UpdateArchiveRequest; export type UpdateArchiveCommandOutput = UpdateArchiveResponse & __MetadataBearer; +/** + *

Updates the specified archive.

+ */ export class UpdateArchiveCommand extends $Command< UpdateArchiveCommandInput, UpdateArchiveCommandOutput, @@ -34,6 +37,9 @@ export class UpdateArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchEventsClientResolvedConfig, diff --git a/clients/client-cloudwatch-events/package.json b/clients/client-cloudwatch-events/package.json index ad4f86abf395d..79031a18f0501 100644 --- a/clients/client-cloudwatch-events/package.json +++ b/clients/client-cloudwatch-events/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudwatch Events Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudwatch-events/runtimeConfig.browser.ts b/clients/client-cloudwatch-events/runtimeConfig.browser.ts index b3f70825e224f..9b081e2c908c9 100644 --- a/clients/client-cloudwatch-events/runtimeConfig.browser.ts +++ b/clients/client-cloudwatch-events/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudWatchEventsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudwatch-events/runtimeConfig.native.ts b/clients/client-cloudwatch-events/runtimeConfig.native.ts index 0824f7dd5f191..e042819f13241 100644 --- a/clients/client-cloudwatch-events/runtimeConfig.native.ts +++ b/clients/client-cloudwatch-events/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudWatchEventsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudwatch-events/runtimeConfig.shared.ts b/clients/client-cloudwatch-events/runtimeConfig.shared.ts index 2e920ae26073d..763c06b2e68a4 100644 --- a/clients/client-cloudwatch-events/runtimeConfig.shared.ts +++ b/clients/client-cloudwatch-events/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-10-07", disableHostPrefix: false, diff --git a/clients/client-cloudwatch-events/runtimeConfig.ts b/clients/client-cloudwatch-events/runtimeConfig.ts index d29ece8e051ea..13dbab5b5226f 100644 --- a/clients/client-cloudwatch-events/runtimeConfig.ts +++ b/clients/client-cloudwatch-events/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudWatchEventsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudwatch-events/tsconfig.json b/clients/client-cloudwatch-events/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudwatch-events/tsconfig.json +++ b/clients/client-cloudwatch-events/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudwatch-logs/commands/AssociateKmsKeyCommand.ts b/clients/client-cloudwatch-logs/commands/AssociateKmsKeyCommand.ts index 8f12ec17e2a3d..9122fddbb8876 100644 --- a/clients/client-cloudwatch-logs/commands/AssociateKmsKeyCommand.ts +++ b/clients/client-cloudwatch-logs/commands/AssociateKmsKeyCommand.ts @@ -20,6 +20,21 @@ import { export type AssociateKmsKeyCommandInput = AssociateKmsKeyRequest; export type AssociateKmsKeyCommandOutput = __MetadataBearer; +/** + *

Associates the specified AWS Key Management Service (AWS KMS) customer master key (CMK) with the specified log group.

+ *

Associating an AWS KMS CMK with a log group overrides any existing associations between the log group and a CMK. + * After a CMK is associated with a log group, all newly ingested data for the log group is encrypted using the CMK. + * This association is stored as long as the data encrypted with the CMK is still within Amazon CloudWatch Logs. + * This enables Amazon CloudWatch Logs to decrypt this data whenever it is requested.

+ * + *

CloudWatch Logs supports only symmetric CMKs. Do not use an associate an asymmetric CMK + * with your log group. For more information, see Using Symmetric and Asymmetric + * Keys.

+ *
+ *

It can take up to 5 minutes for this operation to take effect.

+ *

If you attempt to associate a CMK with a log group but the CMK does not exist or the + * CMK is disabled, you receive an InvalidParameterException error.

+ */ export class AssociateKmsKeyCommand extends $Command< AssociateKmsKeyCommandInput, AssociateKmsKeyCommandOutput, @@ -34,6 +49,9 @@ export class AssociateKmsKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/CancelExportTaskCommand.ts b/clients/client-cloudwatch-logs/commands/CancelExportTaskCommand.ts index 83479c4bd540d..778d7277459c1 100644 --- a/clients/client-cloudwatch-logs/commands/CancelExportTaskCommand.ts +++ b/clients/client-cloudwatch-logs/commands/CancelExportTaskCommand.ts @@ -20,6 +20,10 @@ import { export type CancelExportTaskCommandInput = CancelExportTaskRequest; export type CancelExportTaskCommandOutput = __MetadataBearer; +/** + *

Cancels the specified export task.

+ *

The task must be in the PENDING or RUNNING state.

+ */ export class CancelExportTaskCommand extends $Command< CancelExportTaskCommandInput, CancelExportTaskCommandOutput, @@ -34,6 +38,9 @@ export class CancelExportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/CreateExportTaskCommand.ts b/clients/client-cloudwatch-logs/commands/CreateExportTaskCommand.ts index 4fb5d1427258b..710c4eab3a063 100644 --- a/clients/client-cloudwatch-logs/commands/CreateExportTaskCommand.ts +++ b/clients/client-cloudwatch-logs/commands/CreateExportTaskCommand.ts @@ -20,6 +20,22 @@ import { export type CreateExportTaskCommandInput = CreateExportTaskRequest; export type CreateExportTaskCommandOutput = CreateExportTaskResponse & __MetadataBearer; +/** + *

Creates an export task, which allows you to efficiently export data from a + * log group to an Amazon S3 bucket. When you perform a CreateExportTask + * operation, you must use credentials that have permission to write to the S3 bucket + * that you specify as the destination.

+ *

This is an asynchronous call. If all the required information is provided, this + * operation initiates an export task and responds with the ID of the task. After the task has started, + * you can use DescribeExportTasks to get the status of the export task. Each account can + * only have one active (RUNNING or PENDING) export task at a time. + * To cancel an export task, use CancelExportTask.

+ *

You can export logs from multiple log groups or multiple time ranges to the same S3 + * bucket. To separate out log data for each export task, you can specify a prefix to be used as + * the Amazon S3 key prefix for all exported objects.

+ *

Exporting to S3 buckets that are encrypted with AES-256 is supported. Exporting to S3 buckets + * encrypted with SSE-KMS is not supported.

+ */ export class CreateExportTaskCommand extends $Command< CreateExportTaskCommandInput, CreateExportTaskCommandOutput, @@ -34,6 +50,9 @@ export class CreateExportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/CreateLogGroupCommand.ts b/clients/client-cloudwatch-logs/commands/CreateLogGroupCommand.ts index a160535160050..f7db275193492 100644 --- a/clients/client-cloudwatch-logs/commands/CreateLogGroupCommand.ts +++ b/clients/client-cloudwatch-logs/commands/CreateLogGroupCommand.ts @@ -20,6 +20,35 @@ import { export type CreateLogGroupCommandInput = CreateLogGroupRequest; export type CreateLogGroupCommandOutput = __MetadataBearer; +/** + *

Creates a log group with the specified name. You can create up to 20,000 log groups per account.

+ *

You must use the following guidelines when naming a log group:

+ *
    + *
  • + *

    Log group names must be unique within a region for an AWS account.

    + *
  • + *
  • + *

    Log group names can be between 1 and 512 characters long.

    + *
  • + *
  • + *

    Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), + * '/' (forward slash), '.' (period), and '#' (number sign)

    + *
  • + *
+ *

When you create a log group, by default the log events in the log group never expire. To set + * a retention policy so that events expire and are deleted after a specified time, use + * PutRetentionPolicy.

+ *

If you associate a AWS Key Management Service (AWS KMS) customer master key (CMK) with the log group, ingested data is encrypted using the CMK. + * This association is stored as long as the data encrypted with the CMK is still within Amazon CloudWatch Logs. + * This enables Amazon CloudWatch Logs to decrypt this data whenever it is requested.

+ *

If you attempt to associate a CMK with the log group but the CMK does not exist or the + * CMK is disabled, you receive an InvalidParameterException error.

+ * + *

CloudWatch Logs supports only symmetric CMKs. Do not associate an asymmetric CMK with + * your log group. For more information, see Using Symmetric and Asymmetric + * Keys.

+ *
+ */ export class CreateLogGroupCommand extends $Command< CreateLogGroupCommandInput, CreateLogGroupCommandOutput, @@ -34,6 +63,9 @@ export class CreateLogGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/CreateLogStreamCommand.ts b/clients/client-cloudwatch-logs/commands/CreateLogStreamCommand.ts index cab00903c9dc8..76b61a10a9d85 100644 --- a/clients/client-cloudwatch-logs/commands/CreateLogStreamCommand.ts +++ b/clients/client-cloudwatch-logs/commands/CreateLogStreamCommand.ts @@ -20,6 +20,25 @@ import { export type CreateLogStreamCommandInput = CreateLogStreamRequest; export type CreateLogStreamCommandOutput = __MetadataBearer; +/** + *

Creates a log stream for the specified log group. A log stream is a sequence of log events + * that originate from a single source, such as an application instance or a resource that is + * being monitored.

+ *

There is no limit on the number of log streams that you can create for a log group. There is a limit + * of 50 TPS on CreateLogStream operations, after which transactions are throttled.

+ *

You must use the following guidelines when naming a log stream:

+ *
    + *
  • + *

    Log stream names must be unique within the log group.

    + *
  • + *
  • + *

    Log stream names can be between 1 and 512 characters long.

    + *
  • + *
  • + *

    The ':' (colon) and '*' (asterisk) characters are not allowed.

    + *
  • + *
+ */ export class CreateLogStreamCommand extends $Command< CreateLogStreamCommandInput, CreateLogStreamCommandOutput, @@ -34,6 +53,9 @@ export class CreateLogStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DeleteDestinationCommand.ts b/clients/client-cloudwatch-logs/commands/DeleteDestinationCommand.ts index 93ec92c047e32..c11bd640cfa86 100644 --- a/clients/client-cloudwatch-logs/commands/DeleteDestinationCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DeleteDestinationCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDestinationCommandInput = DeleteDestinationRequest; export type DeleteDestinationCommandOutput = __MetadataBearer; +/** + *

Deletes the specified destination, and eventually disables all the + * subscription filters that publish to it. This operation does not delete the + * physical resource encapsulated by the destination.

+ */ export class DeleteDestinationCommand extends $Command< DeleteDestinationCommandInput, DeleteDestinationCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DeleteLogGroupCommand.ts b/clients/client-cloudwatch-logs/commands/DeleteLogGroupCommand.ts index 480195192a635..e4079abe13e99 100644 --- a/clients/client-cloudwatch-logs/commands/DeleteLogGroupCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DeleteLogGroupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteLogGroupCommandInput = DeleteLogGroupRequest; export type DeleteLogGroupCommandOutput = __MetadataBearer; +/** + *

Deletes the specified log group and permanently deletes all the archived + * log events associated with the log group.

+ */ export class DeleteLogGroupCommand extends $Command< DeleteLogGroupCommandInput, DeleteLogGroupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteLogGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DeleteLogStreamCommand.ts b/clients/client-cloudwatch-logs/commands/DeleteLogStreamCommand.ts index 0237dccd4ab27..4f8b0c279713f 100644 --- a/clients/client-cloudwatch-logs/commands/DeleteLogStreamCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DeleteLogStreamCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteLogStreamCommandInput = DeleteLogStreamRequest; export type DeleteLogStreamCommandOutput = __MetadataBearer; +/** + *

Deletes the specified log stream and permanently deletes all the archived log events associated + * with the log stream.

+ */ export class DeleteLogStreamCommand extends $Command< DeleteLogStreamCommandInput, DeleteLogStreamCommandOutput, @@ -34,6 +38,9 @@ export class DeleteLogStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DeleteMetricFilterCommand.ts b/clients/client-cloudwatch-logs/commands/DeleteMetricFilterCommand.ts index e164c2e86a925..f423f06520af3 100644 --- a/clients/client-cloudwatch-logs/commands/DeleteMetricFilterCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DeleteMetricFilterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMetricFilterCommandInput = DeleteMetricFilterRequest; export type DeleteMetricFilterCommandOutput = __MetadataBearer; +/** + *

Deletes the specified metric filter.

+ */ export class DeleteMetricFilterCommand extends $Command< DeleteMetricFilterCommandInput, DeleteMetricFilterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMetricFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DeleteQueryDefinitionCommand.ts b/clients/client-cloudwatch-logs/commands/DeleteQueryDefinitionCommand.ts index 539a8283551be..cb76dbcde9d19 100644 --- a/clients/client-cloudwatch-logs/commands/DeleteQueryDefinitionCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DeleteQueryDefinitionCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteQueryDefinitionCommandInput = DeleteQueryDefinitionRequest; export type DeleteQueryDefinitionCommandOutput = DeleteQueryDefinitionResponse & __MetadataBearer; +/** + *

Deletes a saved CloudWatch Logs Insights query definition. + * A query definition contains details about a saved CloudWatch Logs Insights query.

+ *

Each DeleteQueryDefinition operation can delete one query definition.

+ *

You must have the logs:DeleteQueryDefinition permission to be able to perform + * this operation.

+ */ export class DeleteQueryDefinitionCommand extends $Command< DeleteQueryDefinitionCommandInput, DeleteQueryDefinitionCommandOutput, @@ -34,6 +41,9 @@ export class DeleteQueryDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DeleteResourcePolicyCommand.ts b/clients/client-cloudwatch-logs/commands/DeleteResourcePolicyCommand.ts index f80419ade5d89..00ecce2c7894b 100644 --- a/clients/client-cloudwatch-logs/commands/DeleteResourcePolicyCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DeleteResourcePolicyCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteResourcePolicyCommandInput = DeleteResourcePolicyRequest; export type DeleteResourcePolicyCommandOutput = __MetadataBearer; +/** + *

Deletes a resource policy from this account. This revokes + * the access of the identities in that policy to put log events to this account.

+ */ export class DeleteResourcePolicyCommand extends $Command< DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput, @@ -34,6 +38,9 @@ export class DeleteResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DeleteRetentionPolicyCommand.ts b/clients/client-cloudwatch-logs/commands/DeleteRetentionPolicyCommand.ts index 8bd122c186a19..e4c94a3ea3e40 100644 --- a/clients/client-cloudwatch-logs/commands/DeleteRetentionPolicyCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DeleteRetentionPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteRetentionPolicyCommandInput = DeleteRetentionPolicyRequest; export type DeleteRetentionPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified retention policy.

+ *

Log events do not expire if they belong to log groups without a retention policy.

+ */ export class DeleteRetentionPolicyCommand extends $Command< DeleteRetentionPolicyCommandInput, DeleteRetentionPolicyCommandOutput, @@ -34,6 +38,9 @@ export class DeleteRetentionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DeleteSubscriptionFilterCommand.ts b/clients/client-cloudwatch-logs/commands/DeleteSubscriptionFilterCommand.ts index edcd00faa84f4..22df8c544a5e7 100644 --- a/clients/client-cloudwatch-logs/commands/DeleteSubscriptionFilterCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DeleteSubscriptionFilterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSubscriptionFilterCommandInput = DeleteSubscriptionFilterRequest; export type DeleteSubscriptionFilterCommandOutput = __MetadataBearer; +/** + *

Deletes the specified subscription filter.

+ */ export class DeleteSubscriptionFilterCommand extends $Command< DeleteSubscriptionFilterCommandInput, DeleteSubscriptionFilterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSubscriptionFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeDestinationsCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeDestinationsCommand.ts index 1853576633c19..6331efc26ae7f 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeDestinationsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeDestinationsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDestinationsCommandInput = DescribeDestinationsRequest; export type DescribeDestinationsCommandOutput = DescribeDestinationsResponse & __MetadataBearer; +/** + *

Lists all your destinations. The results are ASCII-sorted by destination name.

+ */ export class DescribeDestinationsCommand extends $Command< DescribeDestinationsCommandInput, DescribeDestinationsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDestinationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeExportTasksCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeExportTasksCommand.ts index 8c55f3e99ad4d..224e1e445d197 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeExportTasksCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeExportTasksCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeExportTasksCommandInput = DescribeExportTasksRequest; export type DescribeExportTasksCommandOutput = DescribeExportTasksResponse & __MetadataBearer; +/** + *

Lists the specified export tasks. You can list all your export tasks or filter + * the results based on task ID or task status.

+ */ export class DescribeExportTasksCommand extends $Command< DescribeExportTasksCommandInput, DescribeExportTasksCommandOutput, @@ -34,6 +38,9 @@ export class DescribeExportTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeLogGroupsCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeLogGroupsCommand.ts index 3c6cb11375558..243425899cb91 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeLogGroupsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeLogGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeLogGroupsCommandInput = DescribeLogGroupsRequest; export type DescribeLogGroupsCommandOutput = DescribeLogGroupsResponse & __MetadataBearer; +/** + *

Lists the specified log groups. You can list all your log groups or filter the results by prefix. + * The results are ASCII-sorted by log group name.

+ */ export class DescribeLogGroupsCommand extends $Command< DescribeLogGroupsCommandInput, DescribeLogGroupsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeLogGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeLogStreamsCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeLogStreamsCommand.ts index 7b15fca01964e..bea564a55f5b8 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeLogStreamsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeLogStreamsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeLogStreamsCommandInput = DescribeLogStreamsRequest; export type DescribeLogStreamsCommandOutput = DescribeLogStreamsResponse & __MetadataBearer; +/** + *

Lists the log streams for the specified log group. + * You can list all the log streams or filter the results by prefix. + * You can also control how the results are ordered.

+ *

This operation has a limit of five transactions per second, after which transactions are throttled.

+ */ export class DescribeLogStreamsCommand extends $Command< DescribeLogStreamsCommandInput, DescribeLogStreamsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeLogStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeMetricFiltersCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeMetricFiltersCommand.ts index 0ab8d39939923..ee7ad7c14c59a 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeMetricFiltersCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeMetricFiltersCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeMetricFiltersCommandInput = DescribeMetricFiltersRequest; export type DescribeMetricFiltersCommandOutput = DescribeMetricFiltersResponse & __MetadataBearer; +/** + *

Lists the specified metric filters. You can list all of the metric filters or filter + * the results by log name, prefix, metric name, or metric namespace. The results are + * ASCII-sorted by filter name.

+ */ export class DescribeMetricFiltersCommand extends $Command< DescribeMetricFiltersCommandInput, DescribeMetricFiltersCommandOutput, @@ -34,6 +39,9 @@ export class DescribeMetricFiltersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeQueriesCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeQueriesCommand.ts index 05862c817a565..3b19487bf043b 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeQueriesCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeQueriesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeQueriesCommandInput = DescribeQueriesRequest; export type DescribeQueriesCommandOutput = DescribeQueriesResponse & __MetadataBearer; +/** + *

Returns a list of CloudWatch Logs Insights queries that are scheduled, executing, or have + * been executed recently in this account. You can request all queries or limit it to queries of + * a specific log group or queries with a certain status.

+ */ export class DescribeQueriesCommand extends $Command< DescribeQueriesCommandInput, DescribeQueriesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeQueriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeQueryDefinitionsCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeQueryDefinitionsCommand.ts index 2673068686d77..825eafe368e74 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeQueryDefinitionsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeQueryDefinitionsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeQueryDefinitionsCommandInput = DescribeQueryDefinitionsRequest; export type DescribeQueryDefinitionsCommandOutput = DescribeQueryDefinitionsResponse & __MetadataBearer; +/** + *

This operation returns a paginated list of your saved CloudWatch Logs Insights query definitions.

+ *

You can use the queryDefinitionNamePrefix parameter to limit the results to only the + * query definitions that have names that start with a certain string.

+ */ export class DescribeQueryDefinitionsCommand extends $Command< DescribeQueryDefinitionsCommandInput, DescribeQueryDefinitionsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeQueryDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeResourcePoliciesCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeResourcePoliciesCommand.ts index 843e995d62b47..295c46f8c2ed1 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeResourcePoliciesCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeResourcePoliciesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeResourcePoliciesCommandInput = DescribeResourcePoliciesRequest; export type DescribeResourcePoliciesCommandOutput = DescribeResourcePoliciesResponse & __MetadataBearer; +/** + *

Lists the resource policies in this account.

+ */ export class DescribeResourcePoliciesCommand extends $Command< DescribeResourcePoliciesCommandInput, DescribeResourcePoliciesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeResourcePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DescribeSubscriptionFiltersCommand.ts b/clients/client-cloudwatch-logs/commands/DescribeSubscriptionFiltersCommand.ts index 172b44930a371..80e8b8a26f55a 100644 --- a/clients/client-cloudwatch-logs/commands/DescribeSubscriptionFiltersCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DescribeSubscriptionFiltersCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSubscriptionFiltersCommandInput = DescribeSubscriptionFiltersRequest; export type DescribeSubscriptionFiltersCommandOutput = DescribeSubscriptionFiltersResponse & __MetadataBearer; +/** + *

Lists the subscription filters for the specified log group. You can list all the subscription filters or filter the results by prefix. + * The results are ASCII-sorted by filter name.

+ */ export class DescribeSubscriptionFiltersCommand extends $Command< DescribeSubscriptionFiltersCommandInput, DescribeSubscriptionFiltersCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSubscriptionFiltersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/DisassociateKmsKeyCommand.ts b/clients/client-cloudwatch-logs/commands/DisassociateKmsKeyCommand.ts index f9d569bbad589..80a610466abb7 100644 --- a/clients/client-cloudwatch-logs/commands/DisassociateKmsKeyCommand.ts +++ b/clients/client-cloudwatch-logs/commands/DisassociateKmsKeyCommand.ts @@ -20,6 +20,12 @@ import { export type DisassociateKmsKeyCommandInput = DisassociateKmsKeyRequest; export type DisassociateKmsKeyCommandOutput = __MetadataBearer; +/** + *

Disassociates the associated AWS Key Management Service (AWS KMS) customer master key (CMK) from the specified log group.

+ *

After the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. + * All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.

+ *

Note that it can take up to 5 minutes for this operation to take effect.

+ */ export class DisassociateKmsKeyCommand extends $Command< DisassociateKmsKeyCommandInput, DisassociateKmsKeyCommandOutput, @@ -34,6 +40,9 @@ export class DisassociateKmsKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/FilterLogEventsCommand.ts b/clients/client-cloudwatch-logs/commands/FilterLogEventsCommand.ts index 9fcb0687dbf9d..9d667ec8e586e 100644 --- a/clients/client-cloudwatch-logs/commands/FilterLogEventsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/FilterLogEventsCommand.ts @@ -20,6 +20,17 @@ import { export type FilterLogEventsCommandInput = FilterLogEventsRequest; export type FilterLogEventsCommandOutput = FilterLogEventsResponse & __MetadataBearer; +/** + *

Lists log events from the specified log group. You can list all the log events or filter the results + * using a filter pattern, a time range, and the name of the log stream.

+ *

By default, this operation returns as many log events as can fit in 1 MB (up to 10,000 + * log events) or all the events found within the time range that you specify. If the results + * include a token, then there are more log events available, and you can get additional results + * by specifying the token in a subsequent call. This operation can return empty results + * while there are more log events available through the token.

+ *

The returned log events are sorted by event timestamp, the timestamp when the event was ingested + * by CloudWatch Logs, and the ID of the PutLogEvents request.

+ */ export class FilterLogEventsCommand extends $Command< FilterLogEventsCommandInput, FilterLogEventsCommandOutput, @@ -34,6 +45,9 @@ export class FilterLogEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/GetLogEventsCommand.ts b/clients/client-cloudwatch-logs/commands/GetLogEventsCommand.ts index 54040fda523f6..273c20a4349f1 100644 --- a/clients/client-cloudwatch-logs/commands/GetLogEventsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/GetLogEventsCommand.ts @@ -20,6 +20,14 @@ import { export type GetLogEventsCommandInput = GetLogEventsRequest; export type GetLogEventsCommandOutput = GetLogEventsResponse & __MetadataBearer; +/** + *

Lists log events from the specified log stream. You can list all of the log events or + * filter using a time range.

+ * + *

By default, this operation returns as many log events as can fit in a response size of 1MB (up to 10,000 log events). + * You can get additional log events by specifying one of the tokens in a subsequent call. + * This operation can return empty results while there are more log events available through the token.

+ */ export class GetLogEventsCommand extends $Command< GetLogEventsCommandInput, GetLogEventsCommandOutput, @@ -34,6 +42,9 @@ export class GetLogEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/GetLogGroupFieldsCommand.ts b/clients/client-cloudwatch-logs/commands/GetLogGroupFieldsCommand.ts index fe563fe2620a7..78f4cc313a23b 100644 --- a/clients/client-cloudwatch-logs/commands/GetLogGroupFieldsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/GetLogGroupFieldsCommand.ts @@ -20,6 +20,16 @@ import { export type GetLogGroupFieldsCommandInput = GetLogGroupFieldsRequest; export type GetLogGroupFieldsCommandOutput = GetLogGroupFieldsResponse & __MetadataBearer; +/** + *

Returns a list of the fields that are included in log events in the specified log group, along with the percentage of log events + * that contain each field. The search is limited to a time period that you specify.

+ *

In the results, fields that start with @ are fields generated by CloudWatch Logs. For + * example, @timestamp is the timestamp of each log event. For more information about the fields that are + * generated by CloudWatch logs, see + * Supported Logs and Discovered Fields.

+ *

The response results are sorted by the frequency percentage, starting + * with the highest percentage.

+ */ export class GetLogGroupFieldsCommand extends $Command< GetLogGroupFieldsCommandInput, GetLogGroupFieldsCommandOutput, @@ -34,6 +44,9 @@ export class GetLogGroupFieldsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/GetLogRecordCommand.ts b/clients/client-cloudwatch-logs/commands/GetLogRecordCommand.ts index d7692fb7dbc3a..6f6350618ebb2 100644 --- a/clients/client-cloudwatch-logs/commands/GetLogRecordCommand.ts +++ b/clients/client-cloudwatch-logs/commands/GetLogRecordCommand.ts @@ -20,6 +20,12 @@ import { export type GetLogRecordCommandInput = GetLogRecordRequest; export type GetLogRecordCommandOutput = GetLogRecordResponse & __MetadataBearer; +/** + *

Retrieves all of the fields and values of a single log event. All fields are retrieved, + * even if the original query that produced the logRecordPointer retrieved only a + * subset of fields. Fields are returned as field name/field value pairs.

+ *

The full unparsed log event is returned within @message.

+ */ export class GetLogRecordCommand extends $Command< GetLogRecordCommandInput, GetLogRecordCommandOutput, @@ -34,6 +40,9 @@ export class GetLogRecordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/GetQueryResultsCommand.ts b/clients/client-cloudwatch-logs/commands/GetQueryResultsCommand.ts index 4175efb1aaa4e..daa30c2f46301 100644 --- a/clients/client-cloudwatch-logs/commands/GetQueryResultsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/GetQueryResultsCommand.ts @@ -20,6 +20,19 @@ import { export type GetQueryResultsCommandInput = GetQueryResultsRequest; export type GetQueryResultsCommandOutput = GetQueryResultsResponse & __MetadataBearer; +/** + *

Returns the results from the specified query.

+ *

Only the fields requested in the query are returned, along with a @ptr + * field, which is the identifier for the log record. You can use the value of @ptr + * in a GetLogRecord + * operation to get the full log record.

+ *

+ * GetQueryResults + * does not start a query execution. To run a query, use StartQuery.

+ *

If the value of the Status field in the output is Running, this operation + * returns only partial results. If you see a value of Scheduled or Running for the status, + * you can retry the operation later to see the final results.

+ */ export class GetQueryResultsCommand extends $Command< GetQueryResultsCommandInput, GetQueryResultsCommandOutput, @@ -34,6 +47,9 @@ export class GetQueryResultsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/ListTagsLogGroupCommand.ts b/clients/client-cloudwatch-logs/commands/ListTagsLogGroupCommand.ts index db6615aaf3438..e1a65f774f094 100644 --- a/clients/client-cloudwatch-logs/commands/ListTagsLogGroupCommand.ts +++ b/clients/client-cloudwatch-logs/commands/ListTagsLogGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsLogGroupCommandInput = ListTagsLogGroupRequest; export type ListTagsLogGroupCommandOutput = ListTagsLogGroupResponse & __MetadataBearer; +/** + *

Lists the tags for the specified log group.

+ */ export class ListTagsLogGroupCommand extends $Command< ListTagsLogGroupCommandInput, ListTagsLogGroupCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsLogGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/PutDestinationCommand.ts b/clients/client-cloudwatch-logs/commands/PutDestinationCommand.ts index 208164a05329a..abb0d6cd29012 100644 --- a/clients/client-cloudwatch-logs/commands/PutDestinationCommand.ts +++ b/clients/client-cloudwatch-logs/commands/PutDestinationCommand.ts @@ -20,6 +20,18 @@ import { export type PutDestinationCommandInput = PutDestinationRequest; export type PutDestinationCommandOutput = PutDestinationResponse & __MetadataBearer; +/** + *

Creates or updates a destination. This operation is used only to create destinations for cross-account subscriptions.

+ *

A destination encapsulates a physical resource (such + * as an Amazon Kinesis stream) and enables you to subscribe to a real-time stream of log events + * for a different account, ingested using PutLogEvents.

+ *

Through an access policy, a destination controls what is written to it. + * By default, PutDestination does not set any access policy with the destination, + * which means a cross-account user cannot call PutSubscriptionFilter against + * this destination. To enable this, the destination owner must call PutDestinationPolicy after PutDestination.

+ *

To perform a PutDestination operation, you must also have the + * iam:PassRole permission.

+ */ export class PutDestinationCommand extends $Command< PutDestinationCommandInput, PutDestinationCommandOutput, @@ -34,6 +46,9 @@ export class PutDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/PutDestinationPolicyCommand.ts b/clients/client-cloudwatch-logs/commands/PutDestinationPolicyCommand.ts index d3d9d21a7c287..5a66ebd42c983 100644 --- a/clients/client-cloudwatch-logs/commands/PutDestinationPolicyCommand.ts +++ b/clients/client-cloudwatch-logs/commands/PutDestinationPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutDestinationPolicyCommandInput = PutDestinationPolicyRequest; export type PutDestinationPolicyCommandOutput = __MetadataBearer; +/** + *

Creates or updates an access policy associated with an existing + * destination. An access policy is an IAM policy document that is used + * to authorize claims to register a subscription filter against a given destination.

+ */ export class PutDestinationPolicyCommand extends $Command< PutDestinationPolicyCommandInput, PutDestinationPolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutDestinationPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/PutLogEventsCommand.ts b/clients/client-cloudwatch-logs/commands/PutLogEventsCommand.ts index 7fc257aa8c940..4509ab0287899 100644 --- a/clients/client-cloudwatch-logs/commands/PutLogEventsCommand.ts +++ b/clients/client-cloudwatch-logs/commands/PutLogEventsCommand.ts @@ -20,6 +20,46 @@ import { export type PutLogEventsCommandInput = PutLogEventsRequest; export type PutLogEventsCommandOutput = PutLogEventsResponse & __MetadataBearer; +/** + *

Uploads a batch of log events to the specified log stream.

+ *

You must include the sequence token obtained from the response of the previous call. An + * upload in a newly created log stream does not require a sequence token. You can also get the + * sequence token in the expectedSequenceToken field from + * InvalidSequenceTokenException. If you call PutLogEvents twice + * within a narrow time period using the same value for sequenceToken, both calls + * might be successful or one might be rejected.

+ *

The batch of events must satisfy the following constraints:

+ *
    + *
  • + *

    The maximum batch size is 1,048,576 bytes. This size is calculated as the sum of + * all event messages in UTF-8, plus 26 bytes for each log event.

    + *
  • + *
  • + *

    None of the log events in the batch can be more than 2 hours in the future.

    + *
  • + *
  • + *

    None of the log events in the batch can be older than 14 days or older than the retention + * period of the log group.

    + *
  • + *
  • + *

    The log events in the batch must be in chronological order by their timestamp. The + * timestamp is the time the event occurred, expressed as the number of milliseconds after + * Jan 1, 1970 00:00:00 UTC. (In AWS Tools for PowerShell and the AWS SDK for .NET, the + * timestamp is specified in .NET format: yyyy-mm-ddThh:mm:ss. For example, + * 2017-09-15T13:45:30.)

    + *
  • + *
  • + *

    A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.

    + *
  • + *
  • + *

    The maximum number of log events in a batch is 10,000.

    + *
  • + *
  • + *

    There is a quota of 5 requests per second per log stream. Additional requests are throttled. This quota can't be changed.

    + *
  • + *
+ *

If a call to PutLogEvents returns "UnrecognizedClientException" the most likely cause is an invalid AWS access key ID or secret key.

+ */ export class PutLogEventsCommand extends $Command< PutLogEventsCommandInput, PutLogEventsCommandOutput, @@ -34,6 +74,9 @@ export class PutLogEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/PutMetricFilterCommand.ts b/clients/client-cloudwatch-logs/commands/PutMetricFilterCommand.ts index d8e538db90d2b..5a06136b6bc63 100644 --- a/clients/client-cloudwatch-logs/commands/PutMetricFilterCommand.ts +++ b/clients/client-cloudwatch-logs/commands/PutMetricFilterCommand.ts @@ -20,6 +20,13 @@ import { export type PutMetricFilterCommandInput = PutMetricFilterRequest; export type PutMetricFilterCommandOutput = __MetadataBearer; +/** + *

Creates or updates a metric filter and associates it with the specified log group. + * Metric filters allow you to configure rules to extract metric data from log events ingested + * through PutLogEvents.

+ *

The maximum number of metric filters that can be associated with a log group is + * 100.

+ */ export class PutMetricFilterCommand extends $Command< PutMetricFilterCommandInput, PutMetricFilterCommandOutput, @@ -34,6 +41,9 @@ export class PutMetricFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/PutQueryDefinitionCommand.ts b/clients/client-cloudwatch-logs/commands/PutQueryDefinitionCommand.ts index 26c1c0af2a48b..e3c7626736d65 100644 --- a/clients/client-cloudwatch-logs/commands/PutQueryDefinitionCommand.ts +++ b/clients/client-cloudwatch-logs/commands/PutQueryDefinitionCommand.ts @@ -20,6 +20,20 @@ import { export type PutQueryDefinitionCommandInput = PutQueryDefinitionRequest; export type PutQueryDefinitionCommandOutput = PutQueryDefinitionResponse & __MetadataBearer; +/** + *

Creates or updates a query definition for CloudWatch Logs Insights. For + * more information, see Analyzing Log Data with CloudWatch Logs Insights.

+ * + *

To update a query definition, specify its + * queryDefinitionId in your request. The values of name, queryString, + * and logGroupNames are changed to the values that you specify in your update + * operation. No current values are retained from the current query definition. For example, if + * you update a current query definition that includes log groups, and you don't specify the + * logGroupNames parameter in your update operation, the query definition changes + * to contain no log groups.

+ *

You must have the logs:PutQueryDefinition permission to be able to perform + * this operation.

+ */ export class PutQueryDefinitionCommand extends $Command< PutQueryDefinitionCommandInput, PutQueryDefinitionCommandOutput, @@ -34,6 +48,9 @@ export class PutQueryDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/PutResourcePolicyCommand.ts b/clients/client-cloudwatch-logs/commands/PutResourcePolicyCommand.ts index f1f2dcaed5478..0f1f042e02dea 100644 --- a/clients/client-cloudwatch-logs/commands/PutResourcePolicyCommand.ts +++ b/clients/client-cloudwatch-logs/commands/PutResourcePolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutResourcePolicyCommandInput = PutResourcePolicyRequest; export type PutResourcePolicyCommandOutput = PutResourcePolicyResponse & __MetadataBearer; +/** + *

Creates or updates a resource policy allowing other AWS services to put log events to + * this account, such as Amazon Route 53. An account can have up to 10 resource policies per AWS + * Region.

+ */ export class PutResourcePolicyCommand extends $Command< PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/PutRetentionPolicyCommand.ts b/clients/client-cloudwatch-logs/commands/PutRetentionPolicyCommand.ts index 3a4712f11a74d..e1d914b22c4bd 100644 --- a/clients/client-cloudwatch-logs/commands/PutRetentionPolicyCommand.ts +++ b/clients/client-cloudwatch-logs/commands/PutRetentionPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutRetentionPolicyCommandInput = PutRetentionPolicyRequest; export type PutRetentionPolicyCommandOutput = __MetadataBearer; +/** + *

Sets the retention of the specified log group. A retention policy allows you to + * configure the number of days for which to retain log events in the specified log + * group.

+ */ export class PutRetentionPolicyCommand extends $Command< PutRetentionPolicyCommandInput, PutRetentionPolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutRetentionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/PutSubscriptionFilterCommand.ts b/clients/client-cloudwatch-logs/commands/PutSubscriptionFilterCommand.ts index 9ae51cebb0787..3d1d693803b3c 100644 --- a/clients/client-cloudwatch-logs/commands/PutSubscriptionFilterCommand.ts +++ b/clients/client-cloudwatch-logs/commands/PutSubscriptionFilterCommand.ts @@ -20,6 +20,38 @@ import { export type PutSubscriptionFilterCommandInput = PutSubscriptionFilterRequest; export type PutSubscriptionFilterCommandOutput = __MetadataBearer; +/** + *

Creates or updates a subscription filter and associates it with the specified log + * group. Subscription filters allow you to subscribe to a real-time stream of log events + * ingested through PutLogEvents and have them delivered to a specific + * destination. When log events are sent to the + * receiving service, they are Base64 encoded + * and compressed with the gzip format.

+ *

The following destinations are supported for subscription filters:

+ *
    + *
  • + *

    An Amazon Kinesis stream belonging to the same account as the subscription filter, + * for same-account delivery.

    + *
  • + *
  • + *

    A logical destination that belongs to a different account, for cross-account delivery.

    + *
  • + *
  • + *

    An Amazon Kinesis Firehose delivery stream that belongs to the same account as the + * subscription filter, for same-account delivery.

    + *
  • + *
  • + *

    An AWS Lambda function that belongs to the same account as the subscription filter, + * for same-account delivery.

    + *
  • + *
+ *

There can only be one subscription filter associated with a log group. If you are + * updating an existing filter, you must specify the correct name in filterName. + * Otherwise, the call fails because you cannot associate a second filter with a log + * group.

+ *

To perform a PutSubscriptionFilter operation, you must also have the + * iam:PassRole permission.

+ */ export class PutSubscriptionFilterCommand extends $Command< PutSubscriptionFilterCommandInput, PutSubscriptionFilterCommandOutput, @@ -34,6 +66,9 @@ export class PutSubscriptionFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/StartQueryCommand.ts b/clients/client-cloudwatch-logs/commands/StartQueryCommand.ts index 0f3a35af54f46..54e1617ff3bd5 100644 --- a/clients/client-cloudwatch-logs/commands/StartQueryCommand.ts +++ b/clients/client-cloudwatch-logs/commands/StartQueryCommand.ts @@ -20,6 +20,14 @@ import { export type StartQueryCommandInput = StartQueryRequest; export type StartQueryCommandOutput = StartQueryResponse & __MetadataBearer; +/** + *

Schedules a query of a log group using CloudWatch Logs Insights. You specify the log group + * and time range to query and the query string to use.

+ *

For more information, see CloudWatch Logs Insights Query Syntax.

+ * + *

Queries time out after 15 minutes of execution. If your queries are timing out, reduce the + * time range being searched or partition your query into a number of queries.

+ */ export class StartQueryCommand extends $Command< StartQueryCommandInput, StartQueryCommandOutput, @@ -34,6 +42,9 @@ export class StartQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/StopQueryCommand.ts b/clients/client-cloudwatch-logs/commands/StopQueryCommand.ts index 860ef2d981ae5..24112784d4358 100644 --- a/clients/client-cloudwatch-logs/commands/StopQueryCommand.ts +++ b/clients/client-cloudwatch-logs/commands/StopQueryCommand.ts @@ -17,6 +17,10 @@ import { export type StopQueryCommandInput = StopQueryRequest; export type StopQueryCommandOutput = StopQueryResponse & __MetadataBearer; +/** + *

Stops a CloudWatch Logs Insights query that is in progress. If the query has already ended, the operation + * returns an error indicating that the specified query is not running.

+ */ export class StopQueryCommand extends $Command< StopQueryCommandInput, StopQueryCommandOutput, @@ -31,6 +35,9 @@ export class StopQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/TagLogGroupCommand.ts b/clients/client-cloudwatch-logs/commands/TagLogGroupCommand.ts index 29b763573d2ab..469761c4f02ae 100644 --- a/clients/client-cloudwatch-logs/commands/TagLogGroupCommand.ts +++ b/clients/client-cloudwatch-logs/commands/TagLogGroupCommand.ts @@ -20,6 +20,13 @@ import { export type TagLogGroupCommandInput = TagLogGroupRequest; export type TagLogGroupCommandOutput = __MetadataBearer; +/** + *

Adds or updates the specified tags for the specified log group.

+ *

To list the tags for a log group, use ListTagsLogGroup. + * To remove tags, use UntagLogGroup.

+ *

For more information about tags, see Tag Log Groups in Amazon CloudWatch Logs + * in the Amazon CloudWatch Logs User Guide.

+ */ export class TagLogGroupCommand extends $Command< TagLogGroupCommandInput, TagLogGroupCommandOutput, @@ -34,6 +41,9 @@ export class TagLogGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/TestMetricFilterCommand.ts b/clients/client-cloudwatch-logs/commands/TestMetricFilterCommand.ts index 56fdeb35ebba7..e8a62dfb65baf 100644 --- a/clients/client-cloudwatch-logs/commands/TestMetricFilterCommand.ts +++ b/clients/client-cloudwatch-logs/commands/TestMetricFilterCommand.ts @@ -20,6 +20,10 @@ import { export type TestMetricFilterCommandInput = TestMetricFilterRequest; export type TestMetricFilterCommandOutput = TestMetricFilterResponse & __MetadataBearer; +/** + *

Tests the filter pattern of a metric filter against a sample of log event messages. You + * can use this operation to validate the correctness of a metric filter pattern.

+ */ export class TestMetricFilterCommand extends $Command< TestMetricFilterCommandInput, TestMetricFilterCommandOutput, @@ -34,6 +38,9 @@ export class TestMetricFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/commands/UntagLogGroupCommand.ts b/clients/client-cloudwatch-logs/commands/UntagLogGroupCommand.ts index f23657e750f00..a6673857c7bfe 100644 --- a/clients/client-cloudwatch-logs/commands/UntagLogGroupCommand.ts +++ b/clients/client-cloudwatch-logs/commands/UntagLogGroupCommand.ts @@ -20,6 +20,11 @@ import { export type UntagLogGroupCommandInput = UntagLogGroupRequest; export type UntagLogGroupCommandOutput = __MetadataBearer; +/** + *

Removes the specified tags from the specified log group.

+ *

To list the tags for a log group, use ListTagsLogGroup. + * To add tags, use TagLogGroup.

+ */ export class UntagLogGroupCommand extends $Command< UntagLogGroupCommandInput, UntagLogGroupCommandOutput, @@ -34,6 +39,9 @@ export class UntagLogGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchLogsClientResolvedConfig, diff --git a/clients/client-cloudwatch-logs/package.json b/clients/client-cloudwatch-logs/package.json index d03992143adfe..7fb3228998d52 100644 --- a/clients/client-cloudwatch-logs/package.json +++ b/clients/client-cloudwatch-logs/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudwatch Logs Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudwatch-logs/pagination/DescribeDestinationsPaginator.ts b/clients/client-cloudwatch-logs/pagination/DescribeDestinationsPaginator.ts index 0841675404c8d..882c68c79aea9 100644 --- a/clients/client-cloudwatch-logs/pagination/DescribeDestinationsPaginator.ts +++ b/clients/client-cloudwatch-logs/pagination/DescribeDestinationsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchLogsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchLogsClient, input: DescribeDestinationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDestinationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatchLogs, input: DescribeDestinationsCommandInput, diff --git a/clients/client-cloudwatch-logs/pagination/DescribeLogGroupsPaginator.ts b/clients/client-cloudwatch-logs/pagination/DescribeLogGroupsPaginator.ts index 65716444e2c7e..033e10237f401 100644 --- a/clients/client-cloudwatch-logs/pagination/DescribeLogGroupsPaginator.ts +++ b/clients/client-cloudwatch-logs/pagination/DescribeLogGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchLogsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchLogsClient, input: DescribeLogGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLogGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatchLogs, input: DescribeLogGroupsCommandInput, diff --git a/clients/client-cloudwatch-logs/pagination/DescribeLogStreamsPaginator.ts b/clients/client-cloudwatch-logs/pagination/DescribeLogStreamsPaginator.ts index 965d49cda8ea7..f457025f427d1 100644 --- a/clients/client-cloudwatch-logs/pagination/DescribeLogStreamsPaginator.ts +++ b/clients/client-cloudwatch-logs/pagination/DescribeLogStreamsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchLogsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchLogsClient, input: DescribeLogStreamsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLogStreamsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatchLogs, input: DescribeLogStreamsCommandInput, diff --git a/clients/client-cloudwatch-logs/pagination/DescribeMetricFiltersPaginator.ts b/clients/client-cloudwatch-logs/pagination/DescribeMetricFiltersPaginator.ts index 99b3f4b4f9e7f..cd120cb0220e8 100644 --- a/clients/client-cloudwatch-logs/pagination/DescribeMetricFiltersPaginator.ts +++ b/clients/client-cloudwatch-logs/pagination/DescribeMetricFiltersPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchLogsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchLogsClient, input: DescribeMetricFiltersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMetricFiltersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatchLogs, input: DescribeMetricFiltersCommandInput, diff --git a/clients/client-cloudwatch-logs/pagination/DescribeSubscriptionFiltersPaginator.ts b/clients/client-cloudwatch-logs/pagination/DescribeSubscriptionFiltersPaginator.ts index 81362bed70ccd..3912817641d21 100644 --- a/clients/client-cloudwatch-logs/pagination/DescribeSubscriptionFiltersPaginator.ts +++ b/clients/client-cloudwatch-logs/pagination/DescribeSubscriptionFiltersPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchLogsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchLogsClient, input: DescribeSubscriptionFiltersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSubscriptionFiltersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatchLogs, input: DescribeSubscriptionFiltersCommandInput, diff --git a/clients/client-cloudwatch-logs/pagination/FilterLogEventsPaginator.ts b/clients/client-cloudwatch-logs/pagination/FilterLogEventsPaginator.ts index 4b2faf4fb881d..19756fabc39ec 100644 --- a/clients/client-cloudwatch-logs/pagination/FilterLogEventsPaginator.ts +++ b/clients/client-cloudwatch-logs/pagination/FilterLogEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchLogsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchLogsClient, input: FilterLogEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new FilterLogEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatchLogs, input: FilterLogEventsCommandInput, diff --git a/clients/client-cloudwatch-logs/pagination/GetLogEventsPaginator.ts b/clients/client-cloudwatch-logs/pagination/GetLogEventsPaginator.ts index 64b5679b9676d..30a4880d8d2d6 100644 --- a/clients/client-cloudwatch-logs/pagination/GetLogEventsPaginator.ts +++ b/clients/client-cloudwatch-logs/pagination/GetLogEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchLogsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchLogsClient, input: GetLogEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetLogEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatchLogs, input: GetLogEventsCommandInput, diff --git a/clients/client-cloudwatch-logs/runtimeConfig.browser.ts b/clients/client-cloudwatch-logs/runtimeConfig.browser.ts index c37ff44569b2c..79c7ac30ebabf 100644 --- a/clients/client-cloudwatch-logs/runtimeConfig.browser.ts +++ b/clients/client-cloudwatch-logs/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudWatchLogsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudwatch-logs/runtimeConfig.native.ts b/clients/client-cloudwatch-logs/runtimeConfig.native.ts index 0f1a24da2a643..1bb795a06c169 100644 --- a/clients/client-cloudwatch-logs/runtimeConfig.native.ts +++ b/clients/client-cloudwatch-logs/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudWatchLogsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudwatch-logs/runtimeConfig.shared.ts b/clients/client-cloudwatch-logs/runtimeConfig.shared.ts index 9937a9a862c05..eaa29ec424c58 100644 --- a/clients/client-cloudwatch-logs/runtimeConfig.shared.ts +++ b/clients/client-cloudwatch-logs/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-03-28", disableHostPrefix: false, diff --git a/clients/client-cloudwatch-logs/runtimeConfig.ts b/clients/client-cloudwatch-logs/runtimeConfig.ts index 535aea2d544d4..6780fe5741d63 100644 --- a/clients/client-cloudwatch-logs/runtimeConfig.ts +++ b/clients/client-cloudwatch-logs/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudWatchLogsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudwatch-logs/tsconfig.json b/clients/client-cloudwatch-logs/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudwatch-logs/tsconfig.json +++ b/clients/client-cloudwatch-logs/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cloudwatch/commands/DeleteAlarmsCommand.ts b/clients/client-cloudwatch/commands/DeleteAlarmsCommand.ts index e7c6489c5ea06..6ebd660a17022 100644 --- a/clients/client-cloudwatch/commands/DeleteAlarmsCommand.ts +++ b/clients/client-cloudwatch/commands/DeleteAlarmsCommand.ts @@ -17,6 +17,24 @@ import { export type DeleteAlarmsCommandInput = DeleteAlarmsInput; export type DeleteAlarmsCommandOutput = __MetadataBearer; +/** + *

Deletes the specified alarms. You can delete up to 100 alarms in one operation. However, this total can include no more + * than one composite alarm. For example, you could delete 99 metric alarms and one composite alarms with one operation, but you can't + * delete two composite alarms with one operation.

+ *

+ * In the event of an error, no alarms are + * deleted.

+ * + *

It is possible to create a loop or cycle of composite alarms, where composite alarm A depends on composite alarm B, and + * composite alarm B also depends on composite alarm A. In this scenario, you can't delete any composite alarm that is part of the cycle + * because there is always still a composite alarm that depends on that alarm that you want to delete.

+ *

To get out of such a situation, you must + * break the cycle by changing the rule of one of the composite alarms in the cycle to remove a dependency that creates the cycle. The simplest + * change to make to break a cycle is to change the AlarmRule of one of the alarms to False.

+ *

Additionally, the evaluation of composite alarms stops if CloudWatch detects a cycle in the evaluation path. + *

+ *
+ */ export class DeleteAlarmsCommand extends $Command< DeleteAlarmsCommandInput, DeleteAlarmsCommandOutput, @@ -31,6 +49,9 @@ export class DeleteAlarmsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DeleteAnomalyDetectorCommand.ts b/clients/client-cloudwatch/commands/DeleteAnomalyDetectorCommand.ts index c5f6128388539..71546d1670019 100644 --- a/clients/client-cloudwatch/commands/DeleteAnomalyDetectorCommand.ts +++ b/clients/client-cloudwatch/commands/DeleteAnomalyDetectorCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAnomalyDetectorCommandInput = DeleteAnomalyDetectorInput; export type DeleteAnomalyDetectorCommandOutput = DeleteAnomalyDetectorOutput & __MetadataBearer; +/** + *

Deletes the specified anomaly detection model from your account.

+ */ export class DeleteAnomalyDetectorCommand extends $Command< DeleteAnomalyDetectorCommandInput, DeleteAnomalyDetectorCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAnomalyDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DeleteDashboardsCommand.ts b/clients/client-cloudwatch/commands/DeleteDashboardsCommand.ts index 98515c9d25d3b..e02e31df46a7d 100644 --- a/clients/client-cloudwatch/commands/DeleteDashboardsCommand.ts +++ b/clients/client-cloudwatch/commands/DeleteDashboardsCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDashboardsCommandInput = DeleteDashboardsInput; export type DeleteDashboardsCommandOutput = DeleteDashboardsOutput & __MetadataBearer; +/** + *

Deletes all dashboards that you specify. You + * can specify up to 100 dashboards to delete. If there is an error during this call, no dashboards are + * deleted.

+ */ export class DeleteDashboardsCommand extends $Command< DeleteDashboardsCommandInput, DeleteDashboardsCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDashboardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DeleteInsightRulesCommand.ts b/clients/client-cloudwatch/commands/DeleteInsightRulesCommand.ts index f207c54e1fdef..8067580b95d12 100644 --- a/clients/client-cloudwatch/commands/DeleteInsightRulesCommand.ts +++ b/clients/client-cloudwatch/commands/DeleteInsightRulesCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteInsightRulesCommandInput = DeleteInsightRulesInput; export type DeleteInsightRulesCommandOutput = DeleteInsightRulesOutput & __MetadataBearer; +/** + *

Permanently deletes the specified Contributor Insights rules.

+ *

If you create a rule, delete it, and then re-create it with the same name, historical data from the first time + * the rule was created might + * not be available.

+ */ export class DeleteInsightRulesCommand extends $Command< DeleteInsightRulesCommandInput, DeleteInsightRulesCommandOutput, @@ -34,6 +40,9 @@ export class DeleteInsightRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DescribeAlarmHistoryCommand.ts b/clients/client-cloudwatch/commands/DescribeAlarmHistoryCommand.ts index 5b3911e6a1d14..816eb7ba91a01 100644 --- a/clients/client-cloudwatch/commands/DescribeAlarmHistoryCommand.ts +++ b/clients/client-cloudwatch/commands/DescribeAlarmHistoryCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAlarmHistoryCommandInput = DescribeAlarmHistoryInput; export type DescribeAlarmHistoryCommandOutput = DescribeAlarmHistoryOutput & __MetadataBearer; +/** + *

Retrieves the history for the specified alarm. You can filter the results by date range or item type. + * If an alarm name is not specified, the histories for either all metric alarms or all composite alarms are returned.

+ *

CloudWatch retains the history of an alarm even if you delete the alarm.

+ */ export class DescribeAlarmHistoryCommand extends $Command< DescribeAlarmHistoryCommandInput, DescribeAlarmHistoryCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAlarmHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DescribeAlarmsCommand.ts b/clients/client-cloudwatch/commands/DescribeAlarmsCommand.ts index 8deacc6fba678..965a4ef552176 100644 --- a/clients/client-cloudwatch/commands/DescribeAlarmsCommand.ts +++ b/clients/client-cloudwatch/commands/DescribeAlarmsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAlarmsCommandInput = DescribeAlarmsInput; export type DescribeAlarmsCommandOutput = DescribeAlarmsOutput & __MetadataBearer; +/** + *

Retrieves the specified alarms. You can filter the results by specifying a a prefix for the alarm + * name, the alarm state, or a prefix for any action.

+ */ export class DescribeAlarmsCommand extends $Command< DescribeAlarmsCommandInput, DescribeAlarmsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAlarmsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DescribeAlarmsForMetricCommand.ts b/clients/client-cloudwatch/commands/DescribeAlarmsForMetricCommand.ts index 39c5fbdac334a..7feda8704f133 100644 --- a/clients/client-cloudwatch/commands/DescribeAlarmsForMetricCommand.ts +++ b/clients/client-cloudwatch/commands/DescribeAlarmsForMetricCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeAlarmsForMetricCommandInput = DescribeAlarmsForMetricInput; export type DescribeAlarmsForMetricCommandOutput = DescribeAlarmsForMetricOutput & __MetadataBearer; +/** + *

Retrieves the alarms for the specified metric. To + * filter the results, specify a statistic, period, or unit.

+ *

This operation retrieves only standard alarms that are based on + * the specified metric. It does not return alarms based on math expressions that + * use the specified metric, or composite alarms that use the specified metric.

+ */ export class DescribeAlarmsForMetricCommand extends $Command< DescribeAlarmsForMetricCommandInput, DescribeAlarmsForMetricCommandOutput, @@ -34,6 +41,9 @@ export class DescribeAlarmsForMetricCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DescribeAnomalyDetectorsCommand.ts b/clients/client-cloudwatch/commands/DescribeAnomalyDetectorsCommand.ts index 00f8797ef1b0c..88baa2fd3dda8 100644 --- a/clients/client-cloudwatch/commands/DescribeAnomalyDetectorsCommand.ts +++ b/clients/client-cloudwatch/commands/DescribeAnomalyDetectorsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAnomalyDetectorsCommandInput = DescribeAnomalyDetectorsInput; export type DescribeAnomalyDetectorsCommandOutput = DescribeAnomalyDetectorsOutput & __MetadataBearer; +/** + *

Lists the anomaly detection models that you have created in your account. You can list all + * models in your account or filter the results to only the models that are related to a + * certain namespace, metric name, or metric dimension.

+ */ export class DescribeAnomalyDetectorsCommand extends $Command< DescribeAnomalyDetectorsCommandInput, DescribeAnomalyDetectorsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAnomalyDetectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DescribeInsightRulesCommand.ts b/clients/client-cloudwatch/commands/DescribeInsightRulesCommand.ts index 9c24df527a1d4..be659d6015df4 100644 --- a/clients/client-cloudwatch/commands/DescribeInsightRulesCommand.ts +++ b/clients/client-cloudwatch/commands/DescribeInsightRulesCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeInsightRulesCommandInput = DescribeInsightRulesInput; export type DescribeInsightRulesCommandOutput = DescribeInsightRulesOutput & __MetadataBearer; +/** + *

Returns a list of all the Contributor Insights rules in your account.

+ * + *

For more information about Contributor Insights, see + * Using Contributor Insights to Analyze High-Cardinality Data.

+ */ export class DescribeInsightRulesCommand extends $Command< DescribeInsightRulesCommandInput, DescribeInsightRulesCommandOutput, @@ -34,6 +40,9 @@ export class DescribeInsightRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DisableAlarmActionsCommand.ts b/clients/client-cloudwatch/commands/DisableAlarmActionsCommand.ts index 69458c23a3591..5d1391080fc7f 100644 --- a/clients/client-cloudwatch/commands/DisableAlarmActionsCommand.ts +++ b/clients/client-cloudwatch/commands/DisableAlarmActionsCommand.ts @@ -20,6 +20,10 @@ import { export type DisableAlarmActionsCommandInput = DisableAlarmActionsInput; export type DisableAlarmActionsCommandOutput = __MetadataBearer; +/** + *

Disables the actions for the specified alarms. When an alarm's actions are disabled, the + * alarm actions do not execute when the alarm state changes.

+ */ export class DisableAlarmActionsCommand extends $Command< DisableAlarmActionsCommandInput, DisableAlarmActionsCommandOutput, @@ -34,6 +38,9 @@ export class DisableAlarmActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/DisableInsightRulesCommand.ts b/clients/client-cloudwatch/commands/DisableInsightRulesCommand.ts index c72c047d65375..fdbe1164ad930 100644 --- a/clients/client-cloudwatch/commands/DisableInsightRulesCommand.ts +++ b/clients/client-cloudwatch/commands/DisableInsightRulesCommand.ts @@ -20,6 +20,10 @@ import { export type DisableInsightRulesCommandInput = DisableInsightRulesInput; export type DisableInsightRulesCommandOutput = DisableInsightRulesOutput & __MetadataBearer; +/** + *

Disables the specified Contributor Insights rules. When rules are disabled, they do not analyze log groups and do + * not incur costs.

+ */ export class DisableInsightRulesCommand extends $Command< DisableInsightRulesCommandInput, DisableInsightRulesCommandOutput, @@ -34,6 +38,9 @@ export class DisableInsightRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/EnableAlarmActionsCommand.ts b/clients/client-cloudwatch/commands/EnableAlarmActionsCommand.ts index 93d5eecbf44db..e97119358d06f 100644 --- a/clients/client-cloudwatch/commands/EnableAlarmActionsCommand.ts +++ b/clients/client-cloudwatch/commands/EnableAlarmActionsCommand.ts @@ -20,6 +20,9 @@ import { export type EnableAlarmActionsCommandInput = EnableAlarmActionsInput; export type EnableAlarmActionsCommandOutput = __MetadataBearer; +/** + *

Enables the actions for the specified alarms.

+ */ export class EnableAlarmActionsCommand extends $Command< EnableAlarmActionsCommandInput, EnableAlarmActionsCommandOutput, @@ -34,6 +37,9 @@ export class EnableAlarmActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/EnableInsightRulesCommand.ts b/clients/client-cloudwatch/commands/EnableInsightRulesCommand.ts index 72b8ba876b9a4..0582733af47a1 100644 --- a/clients/client-cloudwatch/commands/EnableInsightRulesCommand.ts +++ b/clients/client-cloudwatch/commands/EnableInsightRulesCommand.ts @@ -20,6 +20,9 @@ import { export type EnableInsightRulesCommandInput = EnableInsightRulesInput; export type EnableInsightRulesCommandOutput = EnableInsightRulesOutput & __MetadataBearer; +/** + *

Enables the specified Contributor Insights rules. When rules are enabled, they immediately begin analyzing log data.

+ */ export class EnableInsightRulesCommand extends $Command< EnableInsightRulesCommandInput, EnableInsightRulesCommandOutput, @@ -34,6 +37,9 @@ export class EnableInsightRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/GetDashboardCommand.ts b/clients/client-cloudwatch/commands/GetDashboardCommand.ts index 354a3c634903a..c5b0d07899ecf 100644 --- a/clients/client-cloudwatch/commands/GetDashboardCommand.ts +++ b/clients/client-cloudwatch/commands/GetDashboardCommand.ts @@ -17,6 +17,12 @@ import { export type GetDashboardCommandInput = GetDashboardInput; export type GetDashboardCommandOutput = GetDashboardOutput & __MetadataBearer; +/** + *

Displays the details of the dashboard that you specify.

+ *

To copy an existing dashboard, use GetDashboard, and then use the data returned + * within DashboardBody as the template for the new dashboard when you call PutDashboard to create + * the copy.

+ */ export class GetDashboardCommand extends $Command< GetDashboardCommandInput, GetDashboardCommandOutput, @@ -31,6 +37,9 @@ export class GetDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/GetInsightRuleReportCommand.ts b/clients/client-cloudwatch/commands/GetInsightRuleReportCommand.ts index 41dde920990e3..7ea53547a99eb 100644 --- a/clients/client-cloudwatch/commands/GetInsightRuleReportCommand.ts +++ b/clients/client-cloudwatch/commands/GetInsightRuleReportCommand.ts @@ -20,6 +20,45 @@ import { export type GetInsightRuleReportCommandInput = GetInsightRuleReportInput; export type GetInsightRuleReportCommandOutput = GetInsightRuleReportOutput & __MetadataBearer; +/** + *

This operation returns the time series data collected by a Contributor Insights rule. The data includes the identity and number of + * contributors to the log group.

+ *

You can also optionally return one or more statistics about each data point in the time series. These statistics can include the following:

+ *
    + *
  • + *

    + * UniqueContributors -- the number of unique contributors for each data point.

    + *
  • + *
  • + *

    + * MaxContributorValue -- the value of the top contributor for each data point. The identity of the + * contributor might change for each data point in the graph.

    + *

    If this rule aggregates by COUNT, the top contributor for each data point is the contributor with the + * most occurrences in that period. If the rule aggregates by SUM, the top contributor is the contributor with the highest sum in the log field specified + * by the rule's Value, during that period.

    + *
  • + *
  • + *

    + * SampleCount -- the number of data points matched by the rule.

    + *
  • + *
  • + *

    + * Sum -- the sum of the values from all contributors during the time period represented by that data point.

    + *
  • + *
  • + *

    + * Minimum -- the minimum value from a single observation during the time period represented by that data point.

    + *
  • + *
  • + *

    + * Maximum -- the maximum value from a single observation during the time period represented by that data point.

    + *
  • + *
  • + *

    + * Average -- the average value from all contributors during the time period represented by that data point.

    + *
  • + *
+ */ export class GetInsightRuleReportCommand extends $Command< GetInsightRuleReportCommandInput, GetInsightRuleReportCommandOutput, @@ -34,6 +73,9 @@ export class GetInsightRuleReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/GetMetricDataCommand.ts b/clients/client-cloudwatch/commands/GetMetricDataCommand.ts index 8ba8d0c803ef8..224490a8dd97f 100644 --- a/clients/client-cloudwatch/commands/GetMetricDataCommand.ts +++ b/clients/client-cloudwatch/commands/GetMetricDataCommand.ts @@ -20,6 +20,44 @@ import { export type GetMetricDataCommandInput = GetMetricDataInput; export type GetMetricDataCommandOutput = GetMetricDataOutput & __MetadataBearer; +/** + *

You can use the GetMetricData API to retrieve as many as 500 different + * metrics in a single request, with a total of as many as 100,800 data points. You can also + * optionally perform math expressions on the values of the returned statistics, to create + * new time series that represent new insights into your data. For example, using Lambda + * metrics, you could divide the Errors metric by the Invocations metric to get an error + * rate time series. For more information about metric math expressions, see Metric Math Syntax and Functions in the Amazon CloudWatch User + * Guide.

+ * + *

Calls to the GetMetricData API have a different pricing structure than + * calls to GetMetricStatistics. For more information about pricing, see + * Amazon CloudWatch Pricing.

+ * + *

Amazon CloudWatch retains metric data as follows:

+ *
    + *
  • + *

    Data points with a period of less than 60 seconds are available for 3 hours. These data points are high-resolution + * metrics and are available only for custom metrics that have been defined with a StorageResolution of 1.

    + *
  • + *
  • + *

    Data points with a period of 60 seconds (1-minute) are available for 15 days.

    + *
  • + *
  • + *

    Data points with a period of 300 seconds (5-minute) are available for 63 days.

    + *
  • + *
  • + *

    Data points with a period of 3600 seconds (1 hour) are available for 455 days (15 months).

    + *
  • + *
+ *

Data points that are initially published with a shorter period are aggregated together for long-term storage. For example, if you collect + * data using a period of 1 minute, the data remains available for 15 days with 1-minute resolution. After 15 days, this data is still available, + * but is aggregated and retrievable only with a resolution of 5 minutes. After 63 days, the data is further aggregated and is available with + * a resolution of 1 hour.

+ * + *

If you omit Unit in your request, all data that was collected with any unit is returned, along with the corresponding units that were specified + * when the data was reported to CloudWatch. If you specify a unit, the operation returns only data that was collected with that unit specified. + * If you specify a unit that does not match the data collected, the results of the operation are null. CloudWatch does not perform unit conversions.

+ */ export class GetMetricDataCommand extends $Command< GetMetricDataCommandInput, GetMetricDataCommandOutput, @@ -34,6 +72,9 @@ export class GetMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/GetMetricStatisticsCommand.ts b/clients/client-cloudwatch/commands/GetMetricStatisticsCommand.ts index 51ca3465228b0..1fea9aaa9d8cf 100644 --- a/clients/client-cloudwatch/commands/GetMetricStatisticsCommand.ts +++ b/clients/client-cloudwatch/commands/GetMetricStatisticsCommand.ts @@ -20,6 +20,60 @@ import { export type GetMetricStatisticsCommandInput = GetMetricStatisticsInput; export type GetMetricStatisticsCommandOutput = GetMetricStatisticsOutput & __MetadataBearer; +/** + *

Gets statistics for the specified metric.

+ * + * + * + *

The maximum number of data points returned from a single call is 1,440. If + * you request more than 1,440 data points, CloudWatch returns an error. + * To reduce the number of data points, you can narrow the specified time range and make + * multiple requests across adjacent time ranges, or you can increase the specified period. + * Data points are not returned in chronological order.

+ * + *

CloudWatch aggregates data points based on the length of the period + * that you specify. For example, if you request statistics with a one-hour period, + * CloudWatch aggregates all data points with time stamps that fall within each + * one-hour period. Therefore, the number of values aggregated by CloudWatch is larger than + * the number of data points returned.

+ *

CloudWatch needs raw data points to calculate percentile statistics. If you publish + * data using a statistic set instead, you can only retrieve + * percentile statistics for this data if one of the following conditions is true:

+ *
    + *
  • + *

    The SampleCount value of the statistic set is 1.

    + *
  • + *
  • + *

    The Min and the Max values of the statistic set are equal.

    + *
  • + *
+ *

Percentile statistics are not available for metrics when any of the metric values are negative numbers.

+ *

Amazon CloudWatch retains metric data as follows:

+ *
    + *
  • + *

    Data points with a period of less than 60 seconds are available for 3 hours. These data points are high-resolution + * metrics and are available only for custom metrics that have been defined with a StorageResolution of 1.

    + *
  • + *
  • + *

    Data points with a period of 60 seconds (1-minute) are available for 15 days.

    + *
  • + *
  • + *

    Data points with a period of 300 seconds (5-minute) are available for 63 days.

    + *
  • + *
  • + *

    Data points with a period of 3600 seconds (1 hour) are available for 455 days (15 months).

    + *
  • + *
+ *

Data points that are initially published with a shorter period are aggregated together for long-term storage. For example, if you collect + * data using a period of 1 minute, the data remains available for 15 days with 1-minute resolution. After 15 days, this data is still available, + * but is aggregated and retrievable only with a resolution of 5 minutes. After 63 days, the data is further aggregated and is available with + * a resolution of 1 hour.

+ *

CloudWatch started retaining 5-minute and 1-hour metric data as of July 9, 2016.

+ * + *

For information about metrics and dimensions supported by AWS services, see the + * Amazon CloudWatch Metrics and Dimensions Reference in the + * Amazon CloudWatch User Guide.

+ */ export class GetMetricStatisticsCommand extends $Command< GetMetricStatisticsCommandInput, GetMetricStatisticsCommandOutput, @@ -34,6 +88,9 @@ export class GetMetricStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/GetMetricWidgetImageCommand.ts b/clients/client-cloudwatch/commands/GetMetricWidgetImageCommand.ts index 7686693853531..7ac2cbf832ee8 100644 --- a/clients/client-cloudwatch/commands/GetMetricWidgetImageCommand.ts +++ b/clients/client-cloudwatch/commands/GetMetricWidgetImageCommand.ts @@ -20,6 +20,26 @@ import { export type GetMetricWidgetImageCommandInput = GetMetricWidgetImageInput; export type GetMetricWidgetImageCommandOutput = GetMetricWidgetImageOutput & __MetadataBearer; +/** + *

You can use the GetMetricWidgetImage API to retrieve a snapshot graph of + * one or more Amazon CloudWatch metrics as a bitmap image. You can then embed this + * image into your services and products, such as wiki pages, reports, and documents. + * You could also retrieve images regularly, such as every minute, and create your own + * custom live dashboard.

+ * + *

The graph you retrieve can include all CloudWatch metric graph features, including metric math + * and horizontal and vertical annotations.

+ * + *

There is a limit of 20 transactions per second for this API. Each GetMetricWidgetImage action has the following limits:

+ *
    + *
  • + *

    As many as 100 metrics in the graph.

    + *
  • + *
  • + *

    Up to 100 KB uncompressed payload.

    + *
  • + *
+ */ export class GetMetricWidgetImageCommand extends $Command< GetMetricWidgetImageCommandInput, GetMetricWidgetImageCommandOutput, @@ -34,6 +54,9 @@ export class GetMetricWidgetImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/ListDashboardsCommand.ts b/clients/client-cloudwatch/commands/ListDashboardsCommand.ts index d2934565af021..aabf9b78ea50e 100644 --- a/clients/client-cloudwatch/commands/ListDashboardsCommand.ts +++ b/clients/client-cloudwatch/commands/ListDashboardsCommand.ts @@ -20,6 +20,17 @@ import { export type ListDashboardsCommandInput = ListDashboardsInput; export type ListDashboardsCommandOutput = ListDashboardsOutput & __MetadataBearer; +/** + *

Returns a list of the dashboards for your account. If you include DashboardNamePrefix, only + * those dashboards with names starting with the prefix are listed. Otherwise, all dashboards in your account are + * listed. + *

+ *

+ * ListDashboards returns up to 1000 results on one page. If there + * are more than 1000 dashboards, you can call ListDashboards again and + * include the value you received for NextToken in the first call, to receive + * the next 1000 results.

+ */ export class ListDashboardsCommand extends $Command< ListDashboardsCommandInput, ListDashboardsCommandOutput, @@ -34,6 +45,9 @@ export class ListDashboardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/ListMetricsCommand.ts b/clients/client-cloudwatch/commands/ListMetricsCommand.ts index 9d2f0237bb3ae..eedc0796b803b 100644 --- a/clients/client-cloudwatch/commands/ListMetricsCommand.ts +++ b/clients/client-cloudwatch/commands/ListMetricsCommand.ts @@ -17,6 +17,22 @@ import { export type ListMetricsCommandInput = ListMetricsInput; export type ListMetricsCommandOutput = ListMetricsOutput & __MetadataBearer; +/** + *

List the specified metrics. You can use the returned metrics with + * GetMetricData or + * GetMetricStatistics to obtain statistical data.

+ *

Up to 500 results are returned for any one call. To retrieve additional results, + * use the returned token with subsequent calls.

+ *

After you create a metric, allow up to 15 minutes before the metric appears. + * You can see statistics about the metric sooner by using GetMetricData or + * GetMetricStatistics.

+ * + *

+ * ListMetrics doesn't return information about metrics if those metrics haven't + * reported data in the past two weeks. To retrieve those metrics, use + * GetMetricData or + * GetMetricStatistics.

+ */ export class ListMetricsCommand extends $Command< ListMetricsCommandInput, ListMetricsCommandOutput, @@ -31,6 +47,9 @@ export class ListMetricsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/ListTagsForResourceCommand.ts b/clients/client-cloudwatch/commands/ListTagsForResourceCommand.ts index 972d7a69f15e6..44bb67285bc28 100644 --- a/clients/client-cloudwatch/commands/ListTagsForResourceCommand.ts +++ b/clients/client-cloudwatch/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Displays the tags associated with a CloudWatch resource. Currently, alarms + * and Contributor Insights rules support tagging.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/PutAnomalyDetectorCommand.ts b/clients/client-cloudwatch/commands/PutAnomalyDetectorCommand.ts index d448fb1fa880e..e5b70589d4b06 100644 --- a/clients/client-cloudwatch/commands/PutAnomalyDetectorCommand.ts +++ b/clients/client-cloudwatch/commands/PutAnomalyDetectorCommand.ts @@ -20,6 +20,11 @@ import { export type PutAnomalyDetectorCommandInput = PutAnomalyDetectorInput; export type PutAnomalyDetectorCommandOutput = PutAnomalyDetectorOutput & __MetadataBearer; +/** + *

Creates an anomaly detection model for a CloudWatch metric. You can use the model + * to display a band of expected normal values when the metric is graphed.

+ *

For more information, see CloudWatch Anomaly Detection.

+ */ export class PutAnomalyDetectorCommand extends $Command< PutAnomalyDetectorCommandInput, PutAnomalyDetectorCommandOutput, @@ -34,6 +39,9 @@ export class PutAnomalyDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/PutCompositeAlarmCommand.ts b/clients/client-cloudwatch/commands/PutCompositeAlarmCommand.ts index ebb252b2f4a19..66d176e0e9ee0 100644 --- a/clients/client-cloudwatch/commands/PutCompositeAlarmCommand.ts +++ b/clients/client-cloudwatch/commands/PutCompositeAlarmCommand.ts @@ -20,6 +20,41 @@ import { export type PutCompositeAlarmCommandInput = PutCompositeAlarmInput; export type PutCompositeAlarmCommandOutput = __MetadataBearer; +/** + *

Creates or updates a composite alarm. When you create a composite + * alarm, you specify a rule expression for the alarm that takes into account the alarm + * states of other alarms that you have created. The composite alarm goes into ALARM state + * only if all conditions of the rule are met.

+ *

The alarms specified in a composite alarm's rule expression can include metric alarms + * and other composite alarms.

+ *

Using composite alarms can reduce + * alarm noise. You can create multiple metric alarms, + * and also create a composite alarm and + * set up alerts only + * for the composite alarm. For example, you could create a composite + * alarm that goes into ALARM state only when more than one of the underlying metric alarms + * are in ALARM state.

+ *

Currently, the only alarm actions that can be taken by composite alarms are notifying + * SNS topics.

+ * + *

It is possible to create a loop or cycle of composite alarms, where composite alarm A depends on composite alarm B, and + * composite alarm B also depends on composite alarm A. In this scenario, you can't delete any composite alarm that is part of the cycle + * because there is always still a composite alarm that depends on that alarm that you want to delete.

+ *

To get out of such a situation, you must + * break the cycle by changing the rule of one of the composite alarms in the cycle to remove a dependency that creates the cycle. The simplest + * change to make to break a cycle is to change the AlarmRule of one of the alarms to False.

+ *

Additionally, the evaluation of composite alarms stops if CloudWatch detects a cycle in the evaluation path. + *

+ *
+ *

When this operation creates an alarm, the alarm state is immediately set to + * INSUFFICIENT_DATA. The alarm is then evaluated and its state is set + * appropriately. Any actions associated with the new state are then executed. For a + * composite alarm, this initial time after creation is the only time that + * the + * alarm can be in INSUFFICIENT_DATA state.

+ *

When you update an existing alarm, its state is left unchanged, but the update + * completely overwrites the previous configuration of the alarm.

+ */ export class PutCompositeAlarmCommand extends $Command< PutCompositeAlarmCommandInput, PutCompositeAlarmCommandOutput, @@ -34,6 +69,9 @@ export class PutCompositeAlarmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/PutDashboardCommand.ts b/clients/client-cloudwatch/commands/PutDashboardCommand.ts index daee2f54dc247..b77735d640afb 100644 --- a/clients/client-cloudwatch/commands/PutDashboardCommand.ts +++ b/clients/client-cloudwatch/commands/PutDashboardCommand.ts @@ -17,6 +17,22 @@ import { export type PutDashboardCommandInput = PutDashboardInput; export type PutDashboardCommandOutput = PutDashboardOutput & __MetadataBearer; +/** + *

Creates a dashboard if it does not already exist, or updates an existing dashboard. If you update a dashboard, + * the entire contents are replaced with what you specify here.

+ *

All dashboards in your account are global, not region-specific.

+ *

A simple way to create a dashboard using PutDashboard is to copy an + * existing dashboard. To copy an existing dashboard using the console, you can load the dashboard + * and then use the View/edit source command in the Actions menu to display the JSON block + * for that dashboard. Another way to copy a dashboard is to + * use GetDashboard, and then use the data returned + * within DashboardBody as the template for the new dashboard when you call PutDashboard.

+ *

When you create a dashboard with PutDashboard, a good practice is to + * add a text widget at the top of the dashboard with a message that the dashboard was created by script and should + * not be changed in the console. This message could also point console users to the location + * of the DashboardBody script or the CloudFormation template used to create the + * dashboard.

+ */ export class PutDashboardCommand extends $Command< PutDashboardCommandInput, PutDashboardCommandOutput, @@ -31,6 +47,9 @@ export class PutDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/PutInsightRuleCommand.ts b/clients/client-cloudwatch/commands/PutInsightRuleCommand.ts index 40627b69130cd..ad1ff56248f19 100644 --- a/clients/client-cloudwatch/commands/PutInsightRuleCommand.ts +++ b/clients/client-cloudwatch/commands/PutInsightRuleCommand.ts @@ -20,6 +20,13 @@ import { export type PutInsightRuleCommandInput = PutInsightRuleInput; export type PutInsightRuleCommandOutput = PutInsightRuleOutput & __MetadataBearer; +/** + *

Creates a Contributor Insights rule. Rules evaluate log events in a + * CloudWatch Logs log group, enabling you to find contributor data for the log events in that log group. For more information, + * see Using Contributor Insights to Analyze High-Cardinality Data.

+ *

If you create a rule, delete it, and then re-create it with the same name, historical data from the first time + * the rule was created might not be available.

+ */ export class PutInsightRuleCommand extends $Command< PutInsightRuleCommandInput, PutInsightRuleCommandOutput, @@ -34,6 +41,9 @@ export class PutInsightRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/PutMetricAlarmCommand.ts b/clients/client-cloudwatch/commands/PutMetricAlarmCommand.ts index 3ff6c742f1ceb..58b1d25fca836 100644 --- a/clients/client-cloudwatch/commands/PutMetricAlarmCommand.ts +++ b/clients/client-cloudwatch/commands/PutMetricAlarmCommand.ts @@ -20,6 +20,58 @@ import { export type PutMetricAlarmCommandInput = PutMetricAlarmInput; export type PutMetricAlarmCommandOutput = __MetadataBearer; +/** + *

Creates or updates an alarm and associates it with the specified metric, metric math expression, + * or anomaly detection model.

+ *

Alarms based on anomaly detection models cannot have Auto Scaling actions.

+ *

When this operation creates an alarm, the alarm state is immediately set to + * INSUFFICIENT_DATA. The alarm is then evaluated and its state is set + * appropriately. Any actions associated with the new state are then executed.

+ *

When you update an existing alarm, its state is left unchanged, but the + * update completely overwrites the previous configuration of the alarm.

+ * + *

If you are an IAM user, you must have + * Amazon EC2 permissions for some alarm operations:

+ *
    + *
  • + *

    + * iam:CreateServiceLinkedRole for all alarms with EC2 actions

    + *
  • + *
  • + *

    + * ec2:DescribeInstanceStatus and + * ec2:DescribeInstances for all alarms on EC2 instance + * status metrics

    + *
  • + *
  • + *

    + * ec2:StopInstances for alarms with stop actions

    + *
  • + *
  • + *

    + * ec2:TerminateInstances for alarms with terminate + * actions

    + *
  • + *
  • + *

    No specific permissions are needed for alarms with recover actions

    + *
  • + *
+ * + *

If you have read/write permissions for Amazon CloudWatch but not for Amazon + * EC2, you can still create an alarm, but the stop or terminate actions are not + * performed. However, if you are later granted the required permissions, the alarm + * actions that you created earlier are performed.

+ *

If you are using an IAM role (for example, an EC2 instance profile), you cannot + * stop or terminate the instance using alarm actions. However, you can still see the + * alarm state and perform any other actions such as Amazon SNS notifications or Auto Scaling + * policies.

+ *

If you are using temporary security credentials granted using AWS STS, you cannot stop or terminate an EC2 instance using + * alarm actions.

+ *

The first time you create an alarm in the + * AWS Management Console, the CLI, or by using the PutMetricAlarm API, CloudWatch + * creates the necessary service-linked role for you. The service-linked role is called AWSServiceRoleForCloudWatchEvents. + * For more information, see AWS service-linked role.

+ */ export class PutMetricAlarmCommand extends $Command< PutMetricAlarmCommandInput, PutMetricAlarmCommandOutput, @@ -34,6 +86,9 @@ export class PutMetricAlarmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/PutMetricDataCommand.ts b/clients/client-cloudwatch/commands/PutMetricDataCommand.ts index e24aeaff3eb8b..cc2cbe40845ab 100644 --- a/clients/client-cloudwatch/commands/PutMetricDataCommand.ts +++ b/clients/client-cloudwatch/commands/PutMetricDataCommand.ts @@ -20,6 +20,53 @@ import { export type PutMetricDataCommandInput = PutMetricDataInput; export type PutMetricDataCommandOutput = __MetadataBearer; +/** + *

Publishes metric data points to Amazon CloudWatch. CloudWatch associates + * the data points with the specified metric. If the specified metric does not exist, + * CloudWatch creates the metric. When CloudWatch creates a metric, it can + * take up to fifteen minutes for the metric to appear in calls to ListMetrics.

+ * + *

You can publish either individual data points in the Value field, or + * arrays of values and the number of times each value occurred during the period by using the + * Values and Counts fields in the MetricDatum structure. Using + * the Values and Counts method enables you to publish up to 150 values per metric + * with one PutMetricData request, and + * supports retrieving percentile statistics on this data.

+ *

Each PutMetricData request is limited to 40 KB in size for HTTP POST requests. You can + * send a payload compressed by gzip. Each request + * is also limited to no more than 20 different metrics.

+ *

Although the Value parameter accepts numbers of type + * Double, CloudWatch rejects values that are either too small + * or too large. Values must be in the range of -2^360 to 2^360. In addition, special values (for example, NaN, +Infinity, + * -Infinity) are not supported.

+ *

You can use up to 10 dimensions per metric to further clarify what data the metric collects. Each dimension + * consists of a Name and Value pair. For more information about specifying dimensions, see Publishing Metrics in the + * Amazon CloudWatch User Guide.

+ * + *

You specify the time stamp to be associated with each data point. You can specify + * time stamps that are as much as two weeks before the current date, and as much as 2 hours after + * the current day and time.

+ *

Data points with time stamps from 24 hours ago or longer can take at least 48 + * hours to become available for GetMetricData or + * GetMetricStatistics from the time they + * are submitted. Data points with time stamps between 3 and 24 hours ago can take as much as 2 hours to become available + * for for GetMetricData or + * GetMetricStatistics.

+ *

CloudWatch needs raw data points to calculate percentile statistics. If you publish + * data using a statistic set instead, you can only retrieve + * percentile statistics for this data if one of the following conditions is true:

+ *
    + *
  • + *

    The SampleCount value of the statistic set is 1 and Min, + * Max, and Sum are all equal.

    + *
  • + *
  • + *

    The Min and + * Max are equal, and Sum is equal to Min + * multiplied by SampleCount.

    + *
  • + *
+ */ export class PutMetricDataCommand extends $Command< PutMetricDataCommandInput, PutMetricDataCommandOutput, @@ -34,6 +81,9 @@ export class PutMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/SetAlarmStateCommand.ts b/clients/client-cloudwatch/commands/SetAlarmStateCommand.ts index 883b8d90ebbce..f7aaa737dae1c 100644 --- a/clients/client-cloudwatch/commands/SetAlarmStateCommand.ts +++ b/clients/client-cloudwatch/commands/SetAlarmStateCommand.ts @@ -20,6 +20,24 @@ import { export type SetAlarmStateCommandInput = SetAlarmStateInput; export type SetAlarmStateCommandOutput = __MetadataBearer; +/** + *

Temporarily sets the state of an alarm for testing purposes. When the updated + * state differs from the previous value, the action configured for + * the appropriate state is invoked. For example, if your alarm is configured to send an + * Amazon SNS message when an alarm is triggered, temporarily changing the alarm state to + * ALARM sends an SNS message.

+ *

Metric alarms + * returns to their actual state quickly, often within seconds. Because the metric alarm state change + * happens quickly, it is typically only visible in the alarm's History tab in the Amazon CloudWatch console or through + * DescribeAlarmHistory.

+ *

If you use SetAlarmState on a composite alarm, the composite alarm is not guaranteed to return + * to its actual state. It + * returns to its actual state only once any of its children alarms change state. It is also + * reevaluated if you update its + * configuration.

+ *

If an alarm triggers EC2 Auto Scaling policies or application Auto Scaling policies, you must include + * information in the StateReasonData parameter to enable the policy to take the correct action.

+ */ export class SetAlarmStateCommand extends $Command< SetAlarmStateCommandInput, SetAlarmStateCommandOutput, @@ -34,6 +52,9 @@ export class SetAlarmStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/TagResourceCommand.ts b/clients/client-cloudwatch/commands/TagResourceCommand.ts index dbe41213fc0ec..36870726e4f34 100644 --- a/clients/client-cloudwatch/commands/TagResourceCommand.ts +++ b/clients/client-cloudwatch/commands/TagResourceCommand.ts @@ -17,6 +17,19 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

Assigns one or more tags (key-value pairs) to the specified CloudWatch resource. Currently, the only CloudWatch resources that + * can be tagged are alarms and Contributor Insights rules.

+ *

Tags can help you organize and categorize your resources. You can also use them to scope user + * permissions by granting a user + * permission to access or change only resources with certain tag values.

+ *

Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of characters.

+ *

You can use the TagResource action with an alarm that already has tags. If you specify a new tag key for the alarm, + * this tag is appended to the list of tags associated + * with the alarm. If you specify a tag key that is already associated with the alarm, the new tag value that you specify replaces + * the previous value for that tag.

+ *

You can associate as many as 50 tags with a CloudWatch resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -31,6 +44,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/commands/UntagResourceCommand.ts b/clients/client-cloudwatch/commands/UntagResourceCommand.ts index 3869791b37861..02b67b6f93d7e 100644 --- a/clients/client-cloudwatch/commands/UntagResourceCommand.ts +++ b/clients/client-cloudwatch/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Removes one or more tags from the specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CloudWatchClientResolvedConfig, diff --git a/clients/client-cloudwatch/package.json b/clients/client-cloudwatch/package.json index 5936c008e13bd..ed898238f4eab 100644 --- a/clients/client-cloudwatch/package.json +++ b/clients/client-cloudwatch/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cloudwatch Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cloudwatch/pagination/DescribeAlarmHistoryPaginator.ts b/clients/client-cloudwatch/pagination/DescribeAlarmHistoryPaginator.ts index 51c8fe64da69c..e8cded44ded3b 100644 --- a/clients/client-cloudwatch/pagination/DescribeAlarmHistoryPaginator.ts +++ b/clients/client-cloudwatch/pagination/DescribeAlarmHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchClient, input: DescribeAlarmHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAlarmHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatch, input: DescribeAlarmHistoryCommandInput, diff --git a/clients/client-cloudwatch/pagination/DescribeAlarmsPaginator.ts b/clients/client-cloudwatch/pagination/DescribeAlarmsPaginator.ts index 5f460be02cef2..be0feea9ecce1 100644 --- a/clients/client-cloudwatch/pagination/DescribeAlarmsPaginator.ts +++ b/clients/client-cloudwatch/pagination/DescribeAlarmsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchClient, input: DescribeAlarmsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAlarmsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatch, input: DescribeAlarmsCommandInput, diff --git a/clients/client-cloudwatch/pagination/DescribeInsightRulesPaginator.ts b/clients/client-cloudwatch/pagination/DescribeInsightRulesPaginator.ts index 21a08cd26e0c2..cf0b5b57c27b0 100644 --- a/clients/client-cloudwatch/pagination/DescribeInsightRulesPaginator.ts +++ b/clients/client-cloudwatch/pagination/DescribeInsightRulesPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchClient, input: DescribeInsightRulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInsightRulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatch, input: DescribeInsightRulesCommandInput, diff --git a/clients/client-cloudwatch/pagination/GetMetricDataPaginator.ts b/clients/client-cloudwatch/pagination/GetMetricDataPaginator.ts index 3db2b605e7db0..e68b7c6da06d2 100644 --- a/clients/client-cloudwatch/pagination/GetMetricDataPaginator.ts +++ b/clients/client-cloudwatch/pagination/GetMetricDataPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchClient, input: GetMetricDataCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetMetricDataCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatch, input: GetMetricDataCommandInput, diff --git a/clients/client-cloudwatch/pagination/ListDashboardsPaginator.ts b/clients/client-cloudwatch/pagination/ListDashboardsPaginator.ts index 7592ad1295a1b..a1874950dfce9 100644 --- a/clients/client-cloudwatch/pagination/ListDashboardsPaginator.ts +++ b/clients/client-cloudwatch/pagination/ListDashboardsPaginator.ts @@ -8,6 +8,9 @@ import { import { CloudWatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchClient, input: ListDashboardsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDashboardsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatch, input: ListDashboardsCommandInput, diff --git a/clients/client-cloudwatch/pagination/ListMetricsPaginator.ts b/clients/client-cloudwatch/pagination/ListMetricsPaginator.ts index 8710962bd376c..bf59b28922456 100644 --- a/clients/client-cloudwatch/pagination/ListMetricsPaginator.ts +++ b/clients/client-cloudwatch/pagination/ListMetricsPaginator.ts @@ -4,6 +4,9 @@ import { ListMetricsCommand, ListMetricsCommandInput, ListMetricsCommandOutput } import { CloudWatchPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CloudWatchClient, input: ListMetricsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMetricsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CloudWatch, input: ListMetricsCommandInput, diff --git a/clients/client-cloudwatch/runtimeConfig.browser.ts b/clients/client-cloudwatch/runtimeConfig.browser.ts index f5f935ac7b145..c815c76c0c91c 100644 --- a/clients/client-cloudwatch/runtimeConfig.browser.ts +++ b/clients/client-cloudwatch/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CloudWatchClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cloudwatch/runtimeConfig.native.ts b/clients/client-cloudwatch/runtimeConfig.native.ts index 16aecef8d062b..3b3da3e46f946 100644 --- a/clients/client-cloudwatch/runtimeConfig.native.ts +++ b/clients/client-cloudwatch/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CloudWatchClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cloudwatch/runtimeConfig.shared.ts b/clients/client-cloudwatch/runtimeConfig.shared.ts index 28bd006b22a6d..47db23e14f31e 100644 --- a/clients/client-cloudwatch/runtimeConfig.shared.ts +++ b/clients/client-cloudwatch/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2010-08-01", disableHostPrefix: false, diff --git a/clients/client-cloudwatch/runtimeConfig.ts b/clients/client-cloudwatch/runtimeConfig.ts index 912369e10446c..9309e714846bc 100644 --- a/clients/client-cloudwatch/runtimeConfig.ts +++ b/clients/client-cloudwatch/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CloudWatchClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cloudwatch/tsconfig.json b/clients/client-cloudwatch/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cloudwatch/tsconfig.json +++ b/clients/client-cloudwatch/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codeartifact/commands/AssociateExternalConnectionCommand.ts b/clients/client-codeartifact/commands/AssociateExternalConnectionCommand.ts index 859569f813ca1..4c70794ab3cff 100644 --- a/clients/client-codeartifact/commands/AssociateExternalConnectionCommand.ts +++ b/clients/client-codeartifact/commands/AssociateExternalConnectionCommand.ts @@ -20,6 +20,13 @@ import { export type AssociateExternalConnectionCommandInput = AssociateExternalConnectionRequest; export type AssociateExternalConnectionCommandOutput = AssociateExternalConnectionResult & __MetadataBearer; +/** + *

Adds an existing external connection to a repository. One external connection is allowed + * per repository.

+ * + *

A repository can have one or more upstream repositories, or an external connection.

+ *
+ */ export class AssociateExternalConnectionCommand extends $Command< AssociateExternalConnectionCommandInput, AssociateExternalConnectionCommandOutput, @@ -34,6 +41,9 @@ export class AssociateExternalConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/CopyPackageVersionsCommand.ts b/clients/client-codeartifact/commands/CopyPackageVersionsCommand.ts index d7a4f9e03b681..7358f8c7ba29a 100644 --- a/clients/client-codeartifact/commands/CopyPackageVersionsCommand.ts +++ b/clients/client-codeartifact/commands/CopyPackageVersionsCommand.ts @@ -20,6 +20,16 @@ import { export type CopyPackageVersionsCommandInput = CopyPackageVersionsRequest; export type CopyPackageVersionsCommandOutput = CopyPackageVersionsResult & __MetadataBearer; +/** + *

+ * Copies package versions from one repository to another repository in the same domain. + *

+ * + *

+ * You must specify versions or versionRevisions. You cannot specify both. + *

+ *
+ */ export class CopyPackageVersionsCommand extends $Command< CopyPackageVersionsCommandInput, CopyPackageVersionsCommandOutput, @@ -34,6 +44,9 @@ export class CopyPackageVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/CreateDomainCommand.ts b/clients/client-codeartifact/commands/CreateDomainCommand.ts index 5e71ddf3e9b0b..6f356b060bad1 100644 --- a/clients/client-codeartifact/commands/CreateDomainCommand.ts +++ b/clients/client-codeartifact/commands/CreateDomainCommand.ts @@ -20,6 +20,19 @@ import { export type CreateDomainCommandInput = CreateDomainRequest; export type CreateDomainCommandOutput = CreateDomainResult & __MetadataBearer; +/** + *

+ * Creates a domain. CodeArtifact domains make it easier to manage multiple repositories across an + * organization. You can use a domain to apply permissions across many + * repositories owned by different AWS accounts. An asset is stored only once + * in a domain, even if it's in multiple repositories. + *

+ * + *

Although you can have multiple domains, we recommend a single production domain that contains all + * published artifacts so that your development teams can find and share packages. You can use a second + * pre-production domain to test changes to the production domain configuration. + *

+ */ export class CreateDomainCommand extends $Command< CreateDomainCommandInput, CreateDomainCommandOutput, @@ -34,6 +47,9 @@ export class CreateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/CreateRepositoryCommand.ts b/clients/client-codeartifact/commands/CreateRepositoryCommand.ts index 5d926ec5fa84c..b42d28759e37f 100644 --- a/clients/client-codeartifact/commands/CreateRepositoryCommand.ts +++ b/clients/client-codeartifact/commands/CreateRepositoryCommand.ts @@ -20,6 +20,11 @@ import { export type CreateRepositoryCommandInput = CreateRepositoryRequest; export type CreateRepositoryCommandOutput = CreateRepositoryResult & __MetadataBearer; +/** + *

+ * Creates a repository. + *

+ */ export class CreateRepositoryCommand extends $Command< CreateRepositoryCommandInput, CreateRepositoryCommandOutput, @@ -34,6 +39,9 @@ export class CreateRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DeleteDomainCommand.ts b/clients/client-codeartifact/commands/DeleteDomainCommand.ts index 5da6c0e8ee568..6042115e34171 100644 --- a/clients/client-codeartifact/commands/DeleteDomainCommand.ts +++ b/clients/client-codeartifact/commands/DeleteDomainCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDomainCommandInput = DeleteDomainRequest; export type DeleteDomainCommandOutput = DeleteDomainResult & __MetadataBearer; +/** + *

+ * Deletes a domain. You cannot delete a domain that contains repositories. If you want to delete a domain + * with repositories, first delete its repositories. + *

+ */ export class DeleteDomainCommand extends $Command< DeleteDomainCommandInput, DeleteDomainCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DeleteDomainPermissionsPolicyCommand.ts b/clients/client-codeartifact/commands/DeleteDomainPermissionsPolicyCommand.ts index 4c43d075501c5..422806635a1e5 100644 --- a/clients/client-codeartifact/commands/DeleteDomainPermissionsPolicyCommand.ts +++ b/clients/client-codeartifact/commands/DeleteDomainPermissionsPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDomainPermissionsPolicyCommandInput = DeleteDomainPermissionsPolicyRequest; export type DeleteDomainPermissionsPolicyCommandOutput = DeleteDomainPermissionsPolicyResult & __MetadataBearer; +/** + *

+ * Deletes the resource policy set on a domain. + *

+ */ export class DeleteDomainPermissionsPolicyCommand extends $Command< DeleteDomainPermissionsPolicyCommandInput, DeleteDomainPermissionsPolicyCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDomainPermissionsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DeletePackageVersionsCommand.ts b/clients/client-codeartifact/commands/DeletePackageVersionsCommand.ts index d9cd4a80566d2..95be4890e0f4c 100644 --- a/clients/client-codeartifact/commands/DeletePackageVersionsCommand.ts +++ b/clients/client-codeartifact/commands/DeletePackageVersionsCommand.ts @@ -20,6 +20,17 @@ import { export type DeletePackageVersionsCommandInput = DeletePackageVersionsRequest; export type DeletePackageVersionsCommandOutput = DeletePackageVersionsResult & __MetadataBearer; +/** + *

Deletes one or more versions of a package. A deleted package version cannot be restored + * in your repository. If you want to remove a package version from your repository and be able + * to restore it later, set its status to Archived. Archived packages cannot be + * downloaded from a repository and don't show up with list package APIs (for example, + * + * ListackageVersions + * ), but you can restore them using + * UpdatePackageVersionsStatus + * .

+ */ export class DeletePackageVersionsCommand extends $Command< DeletePackageVersionsCommandInput, DeletePackageVersionsCommandOutput, @@ -34,6 +45,9 @@ export class DeletePackageVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DeleteRepositoryCommand.ts b/clients/client-codeartifact/commands/DeleteRepositoryCommand.ts index 2c98551ad8728..17ebbadcbdb20 100644 --- a/clients/client-codeartifact/commands/DeleteRepositoryCommand.ts +++ b/clients/client-codeartifact/commands/DeleteRepositoryCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteRepositoryCommandInput = DeleteRepositoryRequest; export type DeleteRepositoryCommandOutput = DeleteRepositoryResult & __MetadataBearer; +/** + *

+ * Deletes a repository. + *

+ */ export class DeleteRepositoryCommand extends $Command< DeleteRepositoryCommandInput, DeleteRepositoryCommandOutput, @@ -34,6 +39,9 @@ export class DeleteRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DeleteRepositoryPermissionsPolicyCommand.ts b/clients/client-codeartifact/commands/DeleteRepositoryPermissionsPolicyCommand.ts index c4bcda99b77ae..3dbaf44cc7e63 100644 --- a/clients/client-codeartifact/commands/DeleteRepositoryPermissionsPolicyCommand.ts +++ b/clients/client-codeartifact/commands/DeleteRepositoryPermissionsPolicyCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteRepositoryPermissionsPolicyCommandInput = DeleteRepositoryPermissionsPolicyRequest; export type DeleteRepositoryPermissionsPolicyCommandOutput = DeleteRepositoryPermissionsPolicyResult & __MetadataBearer; +/** + *

+ * Deletes the resource policy that is set on a repository. After a resource policy is deleted, the + * permissions allowed and denied by the deleted policy are removed. The effect of deleting a resource policy might not be immediate. + *

+ * + *

+ * Use DeleteRepositoryPermissionsPolicy with caution. After a policy is deleted, AWS users, roles, and accounts lose permissions to perform + * the repository actions granted by the deleted policy. + *

+ *
+ */ export class DeleteRepositoryPermissionsPolicyCommand extends $Command< DeleteRepositoryPermissionsPolicyCommandInput, DeleteRepositoryPermissionsPolicyCommandOutput, @@ -34,6 +46,9 @@ export class DeleteRepositoryPermissionsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DescribeDomainCommand.ts b/clients/client-codeartifact/commands/DescribeDomainCommand.ts index 7e1eba1745687..dde34f44770a9 100644 --- a/clients/client-codeartifact/commands/DescribeDomainCommand.ts +++ b/clients/client-codeartifact/commands/DescribeDomainCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeDomainCommandInput = DescribeDomainRequest; export type DescribeDomainCommandOutput = DescribeDomainResult & __MetadataBearer; +/** + *

+ * Returns a + * + * DomainDescription + * + * object that contains information about the requested domain. + *

+ */ export class DescribeDomainCommand extends $Command< DescribeDomainCommandInput, DescribeDomainCommandOutput, @@ -34,6 +43,9 @@ export class DescribeDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DescribePackageVersionCommand.ts b/clients/client-codeartifact/commands/DescribePackageVersionCommand.ts index 38b6c54e1c238..d4572974e4286 100644 --- a/clients/client-codeartifact/commands/DescribePackageVersionCommand.ts +++ b/clients/client-codeartifact/commands/DescribePackageVersionCommand.ts @@ -20,6 +20,15 @@ import { export type DescribePackageVersionCommandInput = DescribePackageVersionRequest; export type DescribePackageVersionCommandOutput = DescribePackageVersionResult & __MetadataBearer; +/** + *

+ * Returns a + * + * PackageVersionDescription + * + * object that contains information about the requested package version. + *

+ */ export class DescribePackageVersionCommand extends $Command< DescribePackageVersionCommandInput, DescribePackageVersionCommandOutput, @@ -34,6 +43,9 @@ export class DescribePackageVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DescribeRepositoryCommand.ts b/clients/client-codeartifact/commands/DescribeRepositoryCommand.ts index 963c5055200a3..27e7dbdb2dbb6 100644 --- a/clients/client-codeartifact/commands/DescribeRepositoryCommand.ts +++ b/clients/client-codeartifact/commands/DescribeRepositoryCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeRepositoryCommandInput = DescribeRepositoryRequest; export type DescribeRepositoryCommandOutput = DescribeRepositoryResult & __MetadataBearer; +/** + *

+ * Returns a RepositoryDescription object that contains detailed information + * about the requested repository. + *

+ */ export class DescribeRepositoryCommand extends $Command< DescribeRepositoryCommandInput, DescribeRepositoryCommandOutput, @@ -34,6 +40,9 @@ export class DescribeRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DisassociateExternalConnectionCommand.ts b/clients/client-codeartifact/commands/DisassociateExternalConnectionCommand.ts index f28eac44f9f2f..8b4627162bc5d 100644 --- a/clients/client-codeartifact/commands/DisassociateExternalConnectionCommand.ts +++ b/clients/client-codeartifact/commands/DisassociateExternalConnectionCommand.ts @@ -20,6 +20,11 @@ import { export type DisassociateExternalConnectionCommandInput = DisassociateExternalConnectionRequest; export type DisassociateExternalConnectionCommandOutput = DisassociateExternalConnectionResult & __MetadataBearer; +/** + *

+ * Removes an existing external connection from a repository. + *

+ */ export class DisassociateExternalConnectionCommand extends $Command< DisassociateExternalConnectionCommandInput, DisassociateExternalConnectionCommandOutput, @@ -34,6 +39,9 @@ export class DisassociateExternalConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/DisposePackageVersionsCommand.ts b/clients/client-codeartifact/commands/DisposePackageVersionsCommand.ts index ba29be4c2a59c..d4a49fd670508 100644 --- a/clients/client-codeartifact/commands/DisposePackageVersionsCommand.ts +++ b/clients/client-codeartifact/commands/DisposePackageVersionsCommand.ts @@ -20,6 +20,28 @@ import { export type DisposePackageVersionsCommandInput = DisposePackageVersionsRequest; export type DisposePackageVersionsCommandOutput = DisposePackageVersionsResult & __MetadataBearer; +/** + *

+ * Deletes the assets in package versions and sets the package versions' status to Disposed. + * A disposed package version cannot be restored in your repository because its assets are deleted. + *

+ * + *

+ * To view all disposed package versions in a repository, use + * ListPackageVersions + * and set the + * + * status + * parameter + * to Disposed. + *

+ * + *

+ * To view information about a disposed package version, use + * DescribePackageVersion + * .. + *

+ */ export class DisposePackageVersionsCommand extends $Command< DisposePackageVersionsCommandInput, DisposePackageVersionsCommandOutput, @@ -34,6 +56,9 @@ export class DisposePackageVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/GetAuthorizationTokenCommand.ts b/clients/client-codeartifact/commands/GetAuthorizationTokenCommand.ts index ec6cfd335916b..958b2bbc69e43 100644 --- a/clients/client-codeartifact/commands/GetAuthorizationTokenCommand.ts +++ b/clients/client-codeartifact/commands/GetAuthorizationTokenCommand.ts @@ -20,6 +20,29 @@ import { export type GetAuthorizationTokenCommandInput = GetAuthorizationTokenRequest; export type GetAuthorizationTokenCommandOutput = GetAuthorizationTokenResult & __MetadataBearer; +/** + *

+ * Generates a temporary authorization token for accessing repositories in the domain. + * This API requires the codeartifact:GetAuthorizationToken and sts:GetServiceBearerToken permissions. + * For more information about authorization tokens, see + * AWS CodeArtifact authentication and tokens. + *

+ * + *

CodeArtifact authorization tokens are valid for a period of 12 hours when created with the login command. + * You can call login periodically to refresh the token. When + * you create an authorization token with the GetAuthorizationToken API, you can set a custom authorization period, + * up to a maximum of 12 hours, with the durationSeconds parameter.

+ *

The authorization period begins after login + * or GetAuthorizationToken is called. If login or GetAuthorizationToken is called while + * assuming a role, the token lifetime is independent of the maximum session duration + * of the role. For example, if you call sts assume-role and specify a session duration of 15 minutes, then + * generate a CodeArtifact authorization token, the token will be valid for the full authorization period + * even though this is longer than the 15-minute session duration.

+ *

See + * Using IAM Roles + * for more information on controlling session duration.

+ *
+ */ export class GetAuthorizationTokenCommand extends $Command< GetAuthorizationTokenCommandInput, GetAuthorizationTokenCommandOutput, @@ -34,6 +57,9 @@ export class GetAuthorizationTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/GetDomainPermissionsPolicyCommand.ts b/clients/client-codeartifact/commands/GetDomainPermissionsPolicyCommand.ts index 5f28ba300b7a1..ac39b24baa430 100644 --- a/clients/client-codeartifact/commands/GetDomainPermissionsPolicyCommand.ts +++ b/clients/client-codeartifact/commands/GetDomainPermissionsPolicyCommand.ts @@ -20,6 +20,18 @@ import { export type GetDomainPermissionsPolicyCommandInput = GetDomainPermissionsPolicyRequest; export type GetDomainPermissionsPolicyCommandOutput = GetDomainPermissionsPolicyResult & __MetadataBearer; +/** + *

+ * Returns the resource policy attached to the specified domain. + *

+ * + *

+ * The policy is a resource-based policy, not an identity-based policy. For more information, see + * Identity-based policies + * and resource-based policies in the AWS Identity and Access Management User Guide. + *

+ *
+ */ export class GetDomainPermissionsPolicyCommand extends $Command< GetDomainPermissionsPolicyCommandInput, GetDomainPermissionsPolicyCommandOutput, @@ -34,6 +46,9 @@ export class GetDomainPermissionsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/GetPackageVersionAssetCommand.ts b/clients/client-codeartifact/commands/GetPackageVersionAssetCommand.ts index 6f76a15783cf3..7018e34a01456 100644 --- a/clients/client-codeartifact/commands/GetPackageVersionAssetCommand.ts +++ b/clients/client-codeartifact/commands/GetPackageVersionAssetCommand.ts @@ -20,6 +20,13 @@ import { export type GetPackageVersionAssetCommandInput = GetPackageVersionAssetRequest; export type GetPackageVersionAssetCommandOutput = GetPackageVersionAssetResult & __MetadataBearer; +/** + *

+ * Returns an asset (or file) that is in a package. For example, for a Maven package version, use + * GetPackageVersionAsset to download a JAR file, a POM file, + * or any other assets in the package version. + *

+ */ export class GetPackageVersionAssetCommand extends $Command< GetPackageVersionAssetCommandInput, GetPackageVersionAssetCommandOutput, @@ -34,6 +41,9 @@ export class GetPackageVersionAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/GetPackageVersionReadmeCommand.ts b/clients/client-codeartifact/commands/GetPackageVersionReadmeCommand.ts index 8e4f4abc08879..c198d870814dd 100644 --- a/clients/client-codeartifact/commands/GetPackageVersionReadmeCommand.ts +++ b/clients/client-codeartifact/commands/GetPackageVersionReadmeCommand.ts @@ -20,6 +20,16 @@ import { export type GetPackageVersionReadmeCommandInput = GetPackageVersionReadmeRequest; export type GetPackageVersionReadmeCommandOutput = GetPackageVersionReadmeResult & __MetadataBearer; +/** + *

+ * Gets the readme file or descriptive text for a package version. For packages that do not contain a readme file, CodeArtifact + * extracts a description from a metadata file. For example, from the element in the + * pom.xml file of a Maven package. + *

+ *

+ * The returned text might contain formatting. For example, it might contain formatting for Markdown or reStructuredText. + *

+ */ export class GetPackageVersionReadmeCommand extends $Command< GetPackageVersionReadmeCommandInput, GetPackageVersionReadmeCommandOutput, @@ -34,6 +44,9 @@ export class GetPackageVersionReadmeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/GetRepositoryEndpointCommand.ts b/clients/client-codeartifact/commands/GetRepositoryEndpointCommand.ts index d901b1f7810e7..3bb9d1db9a5b0 100644 --- a/clients/client-codeartifact/commands/GetRepositoryEndpointCommand.ts +++ b/clients/client-codeartifact/commands/GetRepositoryEndpointCommand.ts @@ -20,6 +20,29 @@ import { export type GetRepositoryEndpointCommandInput = GetRepositoryEndpointRequest; export type GetRepositoryEndpointCommandOutput = GetRepositoryEndpointResult & __MetadataBearer; +/** + *

+ * Returns the endpoint of a repository for a specific package format. A repository has one endpoint for each + * package format: + *

+ *
    + *
  • + *

    + * npm + *

    + *
  • + *
  • + *

    + * pypi + *

    + *
  • + *
  • + *

    + * maven + *

    + *
  • + *
+ */ export class GetRepositoryEndpointCommand extends $Command< GetRepositoryEndpointCommandInput, GetRepositoryEndpointCommandOutput, @@ -34,6 +57,9 @@ export class GetRepositoryEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/GetRepositoryPermissionsPolicyCommand.ts b/clients/client-codeartifact/commands/GetRepositoryPermissionsPolicyCommand.ts index ad93226023ccc..123b4eba760ee 100644 --- a/clients/client-codeartifact/commands/GetRepositoryPermissionsPolicyCommand.ts +++ b/clients/client-codeartifact/commands/GetRepositoryPermissionsPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type GetRepositoryPermissionsPolicyCommandInput = GetRepositoryPermissionsPolicyRequest; export type GetRepositoryPermissionsPolicyCommandOutput = GetRepositoryPermissionsPolicyResult & __MetadataBearer; +/** + *

+ * Returns the resource policy that is set on a repository. + *

+ */ export class GetRepositoryPermissionsPolicyCommand extends $Command< GetRepositoryPermissionsPolicyCommandInput, GetRepositoryPermissionsPolicyCommandOutput, @@ -34,6 +39,9 @@ export class GetRepositoryPermissionsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/ListDomainsCommand.ts b/clients/client-codeartifact/commands/ListDomainsCommand.ts index 7c2031fe8b4c3..b0f4784e591c3 100644 --- a/clients/client-codeartifact/commands/ListDomainsCommand.ts +++ b/clients/client-codeartifact/commands/ListDomainsCommand.ts @@ -20,6 +20,13 @@ import { export type ListDomainsCommandInput = ListDomainsRequest; export type ListDomainsCommandOutput = ListDomainsResult & __MetadataBearer; +/** + *

Returns a list of + * DomainSummary + * objects for all domains owned by the AWS account that makes + * this call. Each returned DomainSummary object contains information about a + * domain.

+ */ export class ListDomainsCommand extends $Command< ListDomainsCommandInput, ListDomainsCommandOutput, @@ -34,6 +41,9 @@ export class ListDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/ListPackageVersionAssetsCommand.ts b/clients/client-codeartifact/commands/ListPackageVersionAssetsCommand.ts index f3fc4a9ccc876..a36b23b628cff 100644 --- a/clients/client-codeartifact/commands/ListPackageVersionAssetsCommand.ts +++ b/clients/client-codeartifact/commands/ListPackageVersionAssetsCommand.ts @@ -20,6 +20,15 @@ import { export type ListPackageVersionAssetsCommandInput = ListPackageVersionAssetsRequest; export type ListPackageVersionAssetsCommandOutput = ListPackageVersionAssetsResult & __MetadataBearer; +/** + *

+ * Returns a list of + * + * AssetSummary + * + * objects for assets in a package version. + *

+ */ export class ListPackageVersionAssetsCommand extends $Command< ListPackageVersionAssetsCommandInput, ListPackageVersionAssetsCommandOutput, @@ -34,6 +43,9 @@ export class ListPackageVersionAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/ListPackageVersionDependenciesCommand.ts b/clients/client-codeartifact/commands/ListPackageVersionDependenciesCommand.ts index e85b2c11edd64..5bddf1cd6ce3b 100644 --- a/clients/client-codeartifact/commands/ListPackageVersionDependenciesCommand.ts +++ b/clients/client-codeartifact/commands/ListPackageVersionDependenciesCommand.ts @@ -20,6 +20,17 @@ import { export type ListPackageVersionDependenciesCommandInput = ListPackageVersionDependenciesRequest; export type ListPackageVersionDependenciesCommandOutput = ListPackageVersionDependenciesResult & __MetadataBearer; +/** + *

+ * Returns the direct dependencies for a package version. The dependencies are returned as + * + * PackageDependency + * + * objects. CodeArtifact extracts the dependencies for a package version from the metadata file for the package + * format (for example, the package.json file for npm packages and the pom.xml file + * for Maven). Any package version dependencies that are not listed in the configuration file are not returned. + *

+ */ export class ListPackageVersionDependenciesCommand extends $Command< ListPackageVersionDependenciesCommandInput, ListPackageVersionDependenciesCommandOutput, @@ -34,6 +45,9 @@ export class ListPackageVersionDependenciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/ListPackageVersionsCommand.ts b/clients/client-codeartifact/commands/ListPackageVersionsCommand.ts index 711541d9955a1..8ab335dcca654 100644 --- a/clients/client-codeartifact/commands/ListPackageVersionsCommand.ts +++ b/clients/client-codeartifact/commands/ListPackageVersionsCommand.ts @@ -20,6 +20,15 @@ import { export type ListPackageVersionsCommandInput = ListPackageVersionsRequest; export type ListPackageVersionsCommandOutput = ListPackageVersionsResult & __MetadataBearer; +/** + *

+ * Returns a list of + * + * PackageVersionSummary + * + * objects for package versions in a repository that match the request parameters. + *

+ */ export class ListPackageVersionsCommand extends $Command< ListPackageVersionsCommandInput, ListPackageVersionsCommandOutput, @@ -34,6 +43,9 @@ export class ListPackageVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/ListPackagesCommand.ts b/clients/client-codeartifact/commands/ListPackagesCommand.ts index aba745f02badb..76fabacc1c6c1 100644 --- a/clients/client-codeartifact/commands/ListPackagesCommand.ts +++ b/clients/client-codeartifact/commands/ListPackagesCommand.ts @@ -20,6 +20,15 @@ import { export type ListPackagesCommandInput = ListPackagesRequest; export type ListPackagesCommandOutput = ListPackagesResult & __MetadataBearer; +/** + *

+ * Returns a list of + * + * PackageSummary + * + * objects for packages in a repository that match the request parameters. + *

+ */ export class ListPackagesCommand extends $Command< ListPackagesCommandInput, ListPackagesCommandOutput, @@ -34,6 +43,9 @@ export class ListPackagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/ListRepositoriesCommand.ts b/clients/client-codeartifact/commands/ListRepositoriesCommand.ts index edfabdbab0c95..9d5f9bcaa1de3 100644 --- a/clients/client-codeartifact/commands/ListRepositoriesCommand.ts +++ b/clients/client-codeartifact/commands/ListRepositoriesCommand.ts @@ -20,6 +20,16 @@ import { export type ListRepositoriesCommandInput = ListRepositoriesRequest; export type ListRepositoriesCommandOutput = ListRepositoriesResult & __MetadataBearer; +/** + *

+ * Returns a list of + * + * RepositorySummary + * + * objects. Each RepositorySummary contains information about a repository in the specified AWS account and that matches the input + * parameters. + *

+ */ export class ListRepositoriesCommand extends $Command< ListRepositoriesCommandInput, ListRepositoriesCommandOutput, @@ -34,6 +44,9 @@ export class ListRepositoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/ListRepositoriesInDomainCommand.ts b/clients/client-codeartifact/commands/ListRepositoriesInDomainCommand.ts index 5780d94800105..0ab9267e851d2 100644 --- a/clients/client-codeartifact/commands/ListRepositoriesInDomainCommand.ts +++ b/clients/client-codeartifact/commands/ListRepositoriesInDomainCommand.ts @@ -20,6 +20,16 @@ import { export type ListRepositoriesInDomainCommandInput = ListRepositoriesInDomainRequest; export type ListRepositoriesInDomainCommandOutput = ListRepositoriesInDomainResult & __MetadataBearer; +/** + *

+ * Returns a list of + * + * RepositorySummary + * + * objects. Each RepositorySummary contains information about a repository in the specified domain and that matches the input + * parameters. + *

+ */ export class ListRepositoriesInDomainCommand extends $Command< ListRepositoriesInDomainCommandInput, ListRepositoriesInDomainCommandOutput, @@ -34,6 +44,9 @@ export class ListRepositoriesInDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/ListTagsForResourceCommand.ts b/clients/client-codeartifact/commands/ListTagsForResourceCommand.ts index 1a0586da83d9f..87f231b739d20 100644 --- a/clients/client-codeartifact/commands/ListTagsForResourceCommand.ts +++ b/clients/client-codeartifact/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResult & __MetadataBearer; +/** + *

Gets information about AWS tags for a specified Amazon Resource Name (ARN) in AWS CodeArtifact.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/PutDomainPermissionsPolicyCommand.ts b/clients/client-codeartifact/commands/PutDomainPermissionsPolicyCommand.ts index c30f372f3778b..1af9cedf69b9a 100644 --- a/clients/client-codeartifact/commands/PutDomainPermissionsPolicyCommand.ts +++ b/clients/client-codeartifact/commands/PutDomainPermissionsPolicyCommand.ts @@ -20,6 +20,16 @@ import { export type PutDomainPermissionsPolicyCommandInput = PutDomainPermissionsPolicyRequest; export type PutDomainPermissionsPolicyCommandOutput = PutDomainPermissionsPolicyResult & __MetadataBearer; +/** + *

+ * Sets a resource policy on a domain that specifies permissions to access it. + *

+ *

+ * When you call PutDomainPermissionsPolicy, the resource policy on the domain is ignored when evaluting permissions. + * This ensures that the owner of a domain cannot lock themselves out of the domain, which would prevent them from being + * able to update the resource policy. + *

+ */ export class PutDomainPermissionsPolicyCommand extends $Command< PutDomainPermissionsPolicyCommandInput, PutDomainPermissionsPolicyCommandOutput, @@ -34,6 +44,9 @@ export class PutDomainPermissionsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/PutRepositoryPermissionsPolicyCommand.ts b/clients/client-codeartifact/commands/PutRepositoryPermissionsPolicyCommand.ts index b068338f5a7c0..ad949cd991a4b 100644 --- a/clients/client-codeartifact/commands/PutRepositoryPermissionsPolicyCommand.ts +++ b/clients/client-codeartifact/commands/PutRepositoryPermissionsPolicyCommand.ts @@ -20,6 +20,16 @@ import { export type PutRepositoryPermissionsPolicyCommandInput = PutRepositoryPermissionsPolicyRequest; export type PutRepositoryPermissionsPolicyCommandOutput = PutRepositoryPermissionsPolicyResult & __MetadataBearer; +/** + *

+ * Sets the resource policy on a repository that specifies permissions to access it. + *

+ *

+ * When you call PutRepositoryPermissionsPolicy, the resource policy on the repository is ignored when evaluting permissions. + * This ensures that the owner of a repository cannot lock themselves out of the repository, which would prevent them from being + * able to update the resource policy. + *

+ */ export class PutRepositoryPermissionsPolicyCommand extends $Command< PutRepositoryPermissionsPolicyCommandInput, PutRepositoryPermissionsPolicyCommandOutput, @@ -34,6 +44,9 @@ export class PutRepositoryPermissionsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/TagResourceCommand.ts b/clients/client-codeartifact/commands/TagResourceCommand.ts index cda05dbc2523f..9afecd2c7f09a 100644 --- a/clients/client-codeartifact/commands/TagResourceCommand.ts +++ b/clients/client-codeartifact/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResult & __MetadataBearer; +/** + *

Adds or updates tags for a resource in AWS CodeArtifact.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/UntagResourceCommand.ts b/clients/client-codeartifact/commands/UntagResourceCommand.ts index c6be5bb9cabef..cd90a9c020e43 100644 --- a/clients/client-codeartifact/commands/UntagResourceCommand.ts +++ b/clients/client-codeartifact/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResult & __MetadataBearer; +/** + *

Removes tags from a resource in AWS CodeArtifact.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/UpdatePackageVersionsStatusCommand.ts b/clients/client-codeartifact/commands/UpdatePackageVersionsStatusCommand.ts index 4c18205e055d7..0f2eb984dd94a 100644 --- a/clients/client-codeartifact/commands/UpdatePackageVersionsStatusCommand.ts +++ b/clients/client-codeartifact/commands/UpdatePackageVersionsStatusCommand.ts @@ -20,6 +20,11 @@ import { export type UpdatePackageVersionsStatusCommandInput = UpdatePackageVersionsStatusRequest; export type UpdatePackageVersionsStatusCommandOutput = UpdatePackageVersionsStatusResult & __MetadataBearer; +/** + *

+ * Updates the status of one or more versions of a package. + *

+ */ export class UpdatePackageVersionsStatusCommand extends $Command< UpdatePackageVersionsStatusCommandInput, UpdatePackageVersionsStatusCommandOutput, @@ -34,6 +39,9 @@ export class UpdatePackageVersionsStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/commands/UpdateRepositoryCommand.ts b/clients/client-codeartifact/commands/UpdateRepositoryCommand.ts index e5ca3c570b7e2..e95fd34407ee3 100644 --- a/clients/client-codeartifact/commands/UpdateRepositoryCommand.ts +++ b/clients/client-codeartifact/commands/UpdateRepositoryCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateRepositoryCommandInput = UpdateRepositoryRequest; export type UpdateRepositoryCommandOutput = UpdateRepositoryResult & __MetadataBearer; +/** + *

+ * Update the properties of a repository. + *

+ */ export class UpdateRepositoryCommand extends $Command< UpdateRepositoryCommandInput, UpdateRepositoryCommandOutput, @@ -34,6 +39,9 @@ export class UpdateRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeartifactClientResolvedConfig, diff --git a/clients/client-codeartifact/package.json b/clients/client-codeartifact/package.json index f3333ca580817..72418ca8e844b 100644 --- a/clients/client-codeartifact/package.json +++ b/clients/client-codeartifact/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codeartifact Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codeartifact/pagination/ListDomainsPaginator.ts b/clients/client-codeartifact/pagination/ListDomainsPaginator.ts index f8652120f1922..25622c27172aa 100644 --- a/clients/client-codeartifact/pagination/ListDomainsPaginator.ts +++ b/clients/client-codeartifact/pagination/ListDomainsPaginator.ts @@ -4,6 +4,9 @@ import { ListDomainsCommand, ListDomainsCommandInput, ListDomainsCommandOutput } import { CodeartifactPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeartifactClient, input: ListDomainsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Codeartifact, input: ListDomainsCommandInput, diff --git a/clients/client-codeartifact/pagination/ListPackageVersionAssetsPaginator.ts b/clients/client-codeartifact/pagination/ListPackageVersionAssetsPaginator.ts index 75043915307fe..2ebfb5ee8b23f 100644 --- a/clients/client-codeartifact/pagination/ListPackageVersionAssetsPaginator.ts +++ b/clients/client-codeartifact/pagination/ListPackageVersionAssetsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeartifactPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeartifactClient, input: ListPackageVersionAssetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPackageVersionAssetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Codeartifact, input: ListPackageVersionAssetsCommandInput, diff --git a/clients/client-codeartifact/pagination/ListPackageVersionsPaginator.ts b/clients/client-codeartifact/pagination/ListPackageVersionsPaginator.ts index a733840e1fec5..3babbffae4ced 100644 --- a/clients/client-codeartifact/pagination/ListPackageVersionsPaginator.ts +++ b/clients/client-codeartifact/pagination/ListPackageVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeartifactPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeartifactClient, input: ListPackageVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPackageVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Codeartifact, input: ListPackageVersionsCommandInput, diff --git a/clients/client-codeartifact/pagination/ListPackagesPaginator.ts b/clients/client-codeartifact/pagination/ListPackagesPaginator.ts index 107df9342e20d..391e6224a4c17 100644 --- a/clients/client-codeartifact/pagination/ListPackagesPaginator.ts +++ b/clients/client-codeartifact/pagination/ListPackagesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeartifactPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeartifactClient, input: ListPackagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPackagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Codeartifact, input: ListPackagesCommandInput, diff --git a/clients/client-codeartifact/pagination/ListRepositoriesInDomainPaginator.ts b/clients/client-codeartifact/pagination/ListRepositoriesInDomainPaginator.ts index c83eb7b85eefb..32d33205092f8 100644 --- a/clients/client-codeartifact/pagination/ListRepositoriesInDomainPaginator.ts +++ b/clients/client-codeartifact/pagination/ListRepositoriesInDomainPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeartifactPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeartifactClient, input: ListRepositoriesInDomainCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRepositoriesInDomainCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Codeartifact, input: ListRepositoriesInDomainCommandInput, diff --git a/clients/client-codeartifact/pagination/ListRepositoriesPaginator.ts b/clients/client-codeartifact/pagination/ListRepositoriesPaginator.ts index aeadd98ad32fe..9e0dd32da8906 100644 --- a/clients/client-codeartifact/pagination/ListRepositoriesPaginator.ts +++ b/clients/client-codeartifact/pagination/ListRepositoriesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeartifactPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeartifactClient, input: ListRepositoriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRepositoriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Codeartifact, input: ListRepositoriesCommandInput, diff --git a/clients/client-codeartifact/runtimeConfig.browser.ts b/clients/client-codeartifact/runtimeConfig.browser.ts index 53361ed33f8ca..a1f2408a9c1f3 100644 --- a/clients/client-codeartifact/runtimeConfig.browser.ts +++ b/clients/client-codeartifact/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodeartifactClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codeartifact/runtimeConfig.native.ts b/clients/client-codeartifact/runtimeConfig.native.ts index 431635ee9f59e..3898b2fe38000 100644 --- a/clients/client-codeartifact/runtimeConfig.native.ts +++ b/clients/client-codeartifact/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodeartifactClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codeartifact/runtimeConfig.shared.ts b/clients/client-codeartifact/runtimeConfig.shared.ts index 880df88cb9e65..9d31566564362 100644 --- a/clients/client-codeartifact/runtimeConfig.shared.ts +++ b/clients/client-codeartifact/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-09-22", disableHostPrefix: false, diff --git a/clients/client-codeartifact/runtimeConfig.ts b/clients/client-codeartifact/runtimeConfig.ts index a33a145923a98..a75635fb4066e 100644 --- a/clients/client-codeartifact/runtimeConfig.ts +++ b/clients/client-codeartifact/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodeartifactClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codeartifact/tsconfig.json b/clients/client-codeartifact/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codeartifact/tsconfig.json +++ b/clients/client-codeartifact/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codebuild/commands/BatchDeleteBuildsCommand.ts b/clients/client-codebuild/commands/BatchDeleteBuildsCommand.ts index 5e812694f8bde..007b347e7896f 100644 --- a/clients/client-codebuild/commands/BatchDeleteBuildsCommand.ts +++ b/clients/client-codebuild/commands/BatchDeleteBuildsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeleteBuildsCommandInput = BatchDeleteBuildsInput; export type BatchDeleteBuildsCommandOutput = BatchDeleteBuildsOutput & __MetadataBearer; +/** + *

Deletes one or more builds.

+ */ export class BatchDeleteBuildsCommand extends $Command< BatchDeleteBuildsCommandInput, BatchDeleteBuildsCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeleteBuildsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/BatchGetBuildBatchesCommand.ts b/clients/client-codebuild/commands/BatchGetBuildBatchesCommand.ts index 77783f24f1c93..7086e5090bd6b 100644 --- a/clients/client-codebuild/commands/BatchGetBuildBatchesCommand.ts +++ b/clients/client-codebuild/commands/BatchGetBuildBatchesCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetBuildBatchesCommandInput = BatchGetBuildBatchesInput; export type BatchGetBuildBatchesCommandOutput = BatchGetBuildBatchesOutput & __MetadataBearer; +/** + *

Retrieves information about one or more batch builds.

+ */ export class BatchGetBuildBatchesCommand extends $Command< BatchGetBuildBatchesCommandInput, BatchGetBuildBatchesCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetBuildBatchesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/BatchGetBuildsCommand.ts b/clients/client-codebuild/commands/BatchGetBuildsCommand.ts index e2c269e566b14..bf9218bc78ff4 100644 --- a/clients/client-codebuild/commands/BatchGetBuildsCommand.ts +++ b/clients/client-codebuild/commands/BatchGetBuildsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetBuildsCommandInput = BatchGetBuildsInput; export type BatchGetBuildsCommandOutput = BatchGetBuildsOutput & __MetadataBearer; +/** + *

Gets information about one or more builds.

+ */ export class BatchGetBuildsCommand extends $Command< BatchGetBuildsCommandInput, BatchGetBuildsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetBuildsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/BatchGetProjectsCommand.ts b/clients/client-codebuild/commands/BatchGetProjectsCommand.ts index 066f48ce8acd2..7e211757769ed 100644 --- a/clients/client-codebuild/commands/BatchGetProjectsCommand.ts +++ b/clients/client-codebuild/commands/BatchGetProjectsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetProjectsCommandInput = BatchGetProjectsInput; export type BatchGetProjectsCommandOutput = BatchGetProjectsOutput & __MetadataBearer; +/** + *

Gets information about one or more build projects.

+ */ export class BatchGetProjectsCommand extends $Command< BatchGetProjectsCommandInput, BatchGetProjectsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/BatchGetReportGroupsCommand.ts b/clients/client-codebuild/commands/BatchGetReportGroupsCommand.ts index 7a80146dc6b79..f76a7beef61ef 100644 --- a/clients/client-codebuild/commands/BatchGetReportGroupsCommand.ts +++ b/clients/client-codebuild/commands/BatchGetReportGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type BatchGetReportGroupsCommandInput = BatchGetReportGroupsInput; export type BatchGetReportGroupsCommandOutput = BatchGetReportGroupsOutput & __MetadataBearer; +/** + *

+ * Returns an array of report groups. + *

+ */ export class BatchGetReportGroupsCommand extends $Command< BatchGetReportGroupsCommandInput, BatchGetReportGroupsCommandOutput, @@ -34,6 +39,9 @@ export class BatchGetReportGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/BatchGetReportsCommand.ts b/clients/client-codebuild/commands/BatchGetReportsCommand.ts index d3dba6f9d5033..b72aebe2b39ae 100644 --- a/clients/client-codebuild/commands/BatchGetReportsCommand.ts +++ b/clients/client-codebuild/commands/BatchGetReportsCommand.ts @@ -20,6 +20,11 @@ import { export type BatchGetReportsCommandInput = BatchGetReportsInput; export type BatchGetReportsCommandOutput = BatchGetReportsOutput & __MetadataBearer; +/** + *

+ * Returns an array of reports. + *

+ */ export class BatchGetReportsCommand extends $Command< BatchGetReportsCommandInput, BatchGetReportsCommandOutput, @@ -34,6 +39,9 @@ export class BatchGetReportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/CreateProjectCommand.ts b/clients/client-codebuild/commands/CreateProjectCommand.ts index e4c816eb9d33f..748f45348894b 100644 --- a/clients/client-codebuild/commands/CreateProjectCommand.ts +++ b/clients/client-codebuild/commands/CreateProjectCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProjectCommandInput = CreateProjectInput; export type CreateProjectCommandOutput = CreateProjectOutput & __MetadataBearer; +/** + *

Creates a build project.

+ */ export class CreateProjectCommand extends $Command< CreateProjectCommandInput, CreateProjectCommandOutput, @@ -34,6 +37,9 @@ export class CreateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/CreateReportGroupCommand.ts b/clients/client-codebuild/commands/CreateReportGroupCommand.ts index 44ad2208f432b..7aed87215d167 100644 --- a/clients/client-codebuild/commands/CreateReportGroupCommand.ts +++ b/clients/client-codebuild/commands/CreateReportGroupCommand.ts @@ -20,6 +20,11 @@ import { export type CreateReportGroupCommandInput = CreateReportGroupInput; export type CreateReportGroupCommandOutput = CreateReportGroupOutput & __MetadataBearer; +/** + *

+ * Creates a report group. A report group contains a collection of reports. + *

+ */ export class CreateReportGroupCommand extends $Command< CreateReportGroupCommandInput, CreateReportGroupCommandOutput, @@ -34,6 +39,9 @@ export class CreateReportGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/CreateWebhookCommand.ts b/clients/client-codebuild/commands/CreateWebhookCommand.ts index 0fbb6f6a23c37..4ca96d0014811 100644 --- a/clients/client-codebuild/commands/CreateWebhookCommand.ts +++ b/clients/client-codebuild/commands/CreateWebhookCommand.ts @@ -20,6 +20,19 @@ import { export type CreateWebhookCommandInput = CreateWebhookInput; export type CreateWebhookCommandOutput = CreateWebhookOutput & __MetadataBearer; +/** + *

For an existing AWS CodeBuild build project that has its source code stored in a GitHub or + * Bitbucket repository, enables AWS CodeBuild to start rebuilding the source code every time a + * code change is pushed to the repository.

+ * + *

If you enable webhooks for an AWS CodeBuild project, and the project is used as a build + * step in AWS CodePipeline, then two identical builds are created for each commit. One build is + * triggered through webhooks, and one through AWS CodePipeline. Because billing is on a per-build + * basis, you are billed for both builds. Therefore, if you are using AWS CodePipeline, we + * recommend that you disable webhooks in AWS CodeBuild. In the AWS CodeBuild console, clear the + * Webhook box. For more information, see step 5 in Change a Build Project's Settings.

+ *
+ */ export class CreateWebhookCommand extends $Command< CreateWebhookCommandInput, CreateWebhookCommandOutput, @@ -34,6 +47,9 @@ export class CreateWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DeleteBuildBatchCommand.ts b/clients/client-codebuild/commands/DeleteBuildBatchCommand.ts index d25f5b06d37a1..0d3e3d8663949 100644 --- a/clients/client-codebuild/commands/DeleteBuildBatchCommand.ts +++ b/clients/client-codebuild/commands/DeleteBuildBatchCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBuildBatchCommandInput = DeleteBuildBatchInput; export type DeleteBuildBatchCommandOutput = DeleteBuildBatchOutput & __MetadataBearer; +/** + *

Deletes a batch build.

+ */ export class DeleteBuildBatchCommand extends $Command< DeleteBuildBatchCommandInput, DeleteBuildBatchCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBuildBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DeleteProjectCommand.ts b/clients/client-codebuild/commands/DeleteProjectCommand.ts index 4b60bdfead148..c7456a4ffd4d6 100644 --- a/clients/client-codebuild/commands/DeleteProjectCommand.ts +++ b/clients/client-codebuild/commands/DeleteProjectCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteProjectCommandInput = DeleteProjectInput; export type DeleteProjectCommandOutput = DeleteProjectOutput & __MetadataBearer; +/** + *

Deletes a build project. When you delete a project, its builds are not deleted. + *

+ */ export class DeleteProjectCommand extends $Command< DeleteProjectCommandInput, DeleteProjectCommandOutput, @@ -34,6 +38,9 @@ export class DeleteProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DeleteReportCommand.ts b/clients/client-codebuild/commands/DeleteReportCommand.ts index 428ca172aae65..5271576648dcd 100644 --- a/clients/client-codebuild/commands/DeleteReportCommand.ts +++ b/clients/client-codebuild/commands/DeleteReportCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteReportCommandInput = DeleteReportInput; export type DeleteReportCommandOutput = DeleteReportOutput & __MetadataBearer; +/** + *

+ * Deletes a report. + *

+ */ export class DeleteReportCommand extends $Command< DeleteReportCommandInput, DeleteReportCommandOutput, @@ -34,6 +39,9 @@ export class DeleteReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DeleteReportGroupCommand.ts b/clients/client-codebuild/commands/DeleteReportGroupCommand.ts index 926ccb999727b..ee6dbe21ade01 100644 --- a/clients/client-codebuild/commands/DeleteReportGroupCommand.ts +++ b/clients/client-codebuild/commands/DeleteReportGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteReportGroupCommandInput = DeleteReportGroupInput; export type DeleteReportGroupCommandOutput = DeleteReportGroupOutput & __MetadataBearer; +/** + *

Deletes a report group. Before you delete a report group, you must delete its reports.

+ */ export class DeleteReportGroupCommand extends $Command< DeleteReportGroupCommandInput, DeleteReportGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteReportGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DeleteResourcePolicyCommand.ts b/clients/client-codebuild/commands/DeleteResourcePolicyCommand.ts index 32273daa753a8..76804d738ee48 100644 --- a/clients/client-codebuild/commands/DeleteResourcePolicyCommand.ts +++ b/clients/client-codebuild/commands/DeleteResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourcePolicyCommandInput = DeleteResourcePolicyInput; export type DeleteResourcePolicyCommandOutput = DeleteResourcePolicyOutput & __MetadataBearer; +/** + *

Deletes a resource policy that is identified by its resource ARN.

+ */ export class DeleteResourcePolicyCommand extends $Command< DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DeleteSourceCredentialsCommand.ts b/clients/client-codebuild/commands/DeleteSourceCredentialsCommand.ts index ca415020e9313..084b51540bd71 100644 --- a/clients/client-codebuild/commands/DeleteSourceCredentialsCommand.ts +++ b/clients/client-codebuild/commands/DeleteSourceCredentialsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSourceCredentialsCommandInput = DeleteSourceCredentialsInput; export type DeleteSourceCredentialsCommandOutput = DeleteSourceCredentialsOutput & __MetadataBearer; +/** + *

Deletes a set of GitHub, GitHub Enterprise, or Bitbucket source credentials.

+ */ export class DeleteSourceCredentialsCommand extends $Command< DeleteSourceCredentialsCommandInput, DeleteSourceCredentialsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSourceCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DeleteWebhookCommand.ts b/clients/client-codebuild/commands/DeleteWebhookCommand.ts index a1045c75ddfdf..288a78e63a94a 100644 --- a/clients/client-codebuild/commands/DeleteWebhookCommand.ts +++ b/clients/client-codebuild/commands/DeleteWebhookCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteWebhookCommandInput = DeleteWebhookInput; export type DeleteWebhookCommandOutput = DeleteWebhookOutput & __MetadataBearer; +/** + *

For an existing AWS CodeBuild build project that has its source code stored in a GitHub or + * Bitbucket repository, stops AWS CodeBuild from rebuilding the source code every time a code + * change is pushed to the repository.

+ */ export class DeleteWebhookCommand extends $Command< DeleteWebhookCommandInput, DeleteWebhookCommandOutput, @@ -34,6 +39,9 @@ export class DeleteWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DescribeCodeCoveragesCommand.ts b/clients/client-codebuild/commands/DescribeCodeCoveragesCommand.ts index a1c5d8b4025d8..298aee5dafd21 100644 --- a/clients/client-codebuild/commands/DescribeCodeCoveragesCommand.ts +++ b/clients/client-codebuild/commands/DescribeCodeCoveragesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCodeCoveragesCommandInput = DescribeCodeCoveragesInput; export type DescribeCodeCoveragesCommandOutput = DescribeCodeCoveragesOutput & __MetadataBearer; +/** + *

Retrieves one or more code coverage reports.

+ */ export class DescribeCodeCoveragesCommand extends $Command< DescribeCodeCoveragesCommandInput, DescribeCodeCoveragesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCodeCoveragesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/DescribeTestCasesCommand.ts b/clients/client-codebuild/commands/DescribeTestCasesCommand.ts index 58a1a85c89059..0141c30c18b03 100644 --- a/clients/client-codebuild/commands/DescribeTestCasesCommand.ts +++ b/clients/client-codebuild/commands/DescribeTestCasesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeTestCasesCommandInput = DescribeTestCasesInput; export type DescribeTestCasesCommandOutput = DescribeTestCasesOutput & __MetadataBearer; +/** + *

+ * Returns a list of details about test cases for a report. + *

+ */ export class DescribeTestCasesCommand extends $Command< DescribeTestCasesCommandInput, DescribeTestCasesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeTestCasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/GetResourcePolicyCommand.ts b/clients/client-codebuild/commands/GetResourcePolicyCommand.ts index 3299c51da8e22..d4998e4955f77 100644 --- a/clients/client-codebuild/commands/GetResourcePolicyCommand.ts +++ b/clients/client-codebuild/commands/GetResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourcePolicyCommandInput = GetResourcePolicyInput; export type GetResourcePolicyCommandOutput = GetResourcePolicyOutput & __MetadataBearer; +/** + *

Gets a resource policy that is identified by its resource ARN.

+ */ export class GetResourcePolicyCommand extends $Command< GetResourcePolicyCommandInput, GetResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ImportSourceCredentialsCommand.ts b/clients/client-codebuild/commands/ImportSourceCredentialsCommand.ts index 90db8c9434f15..34c59a50e7630 100644 --- a/clients/client-codebuild/commands/ImportSourceCredentialsCommand.ts +++ b/clients/client-codebuild/commands/ImportSourceCredentialsCommand.ts @@ -20,6 +20,10 @@ import { export type ImportSourceCredentialsCommandInput = ImportSourceCredentialsInput; export type ImportSourceCredentialsCommandOutput = ImportSourceCredentialsOutput & __MetadataBearer; +/** + *

Imports the source repository credentials for an AWS CodeBuild project that has its + * source code stored in a GitHub, GitHub Enterprise, or Bitbucket repository.

+ */ export class ImportSourceCredentialsCommand extends $Command< ImportSourceCredentialsCommandInput, ImportSourceCredentialsCommandOutput, @@ -34,6 +38,9 @@ export class ImportSourceCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/InvalidateProjectCacheCommand.ts b/clients/client-codebuild/commands/InvalidateProjectCacheCommand.ts index 3e46ff39bf719..c1ab634d0b870 100644 --- a/clients/client-codebuild/commands/InvalidateProjectCacheCommand.ts +++ b/clients/client-codebuild/commands/InvalidateProjectCacheCommand.ts @@ -20,6 +20,9 @@ import { export type InvalidateProjectCacheCommandInput = InvalidateProjectCacheInput; export type InvalidateProjectCacheCommandOutput = InvalidateProjectCacheOutput & __MetadataBearer; +/** + *

Resets the cache for a project.

+ */ export class InvalidateProjectCacheCommand extends $Command< InvalidateProjectCacheCommandInput, InvalidateProjectCacheCommandOutput, @@ -34,6 +37,9 @@ export class InvalidateProjectCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListBuildBatchesCommand.ts b/clients/client-codebuild/commands/ListBuildBatchesCommand.ts index 1bd93cf9e5d3a..d10f2f4b2ac02 100644 --- a/clients/client-codebuild/commands/ListBuildBatchesCommand.ts +++ b/clients/client-codebuild/commands/ListBuildBatchesCommand.ts @@ -20,6 +20,9 @@ import { export type ListBuildBatchesCommandInput = ListBuildBatchesInput; export type ListBuildBatchesCommandOutput = ListBuildBatchesOutput & __MetadataBearer; +/** + *

Retrieves the identifiers of your build batches in the current region.

+ */ export class ListBuildBatchesCommand extends $Command< ListBuildBatchesCommandInput, ListBuildBatchesCommandOutput, @@ -34,6 +37,9 @@ export class ListBuildBatchesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListBuildBatchesForProjectCommand.ts b/clients/client-codebuild/commands/ListBuildBatchesForProjectCommand.ts index 62d216cf6af49..22fa5d21dba93 100644 --- a/clients/client-codebuild/commands/ListBuildBatchesForProjectCommand.ts +++ b/clients/client-codebuild/commands/ListBuildBatchesForProjectCommand.ts @@ -20,6 +20,9 @@ import { export type ListBuildBatchesForProjectCommandInput = ListBuildBatchesForProjectInput; export type ListBuildBatchesForProjectCommandOutput = ListBuildBatchesForProjectOutput & __MetadataBearer; +/** + *

Retrieves the identifiers of the build batches for a specific project.

+ */ export class ListBuildBatchesForProjectCommand extends $Command< ListBuildBatchesForProjectCommandInput, ListBuildBatchesForProjectCommandOutput, @@ -34,6 +37,9 @@ export class ListBuildBatchesForProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListBuildsCommand.ts b/clients/client-codebuild/commands/ListBuildsCommand.ts index f1c902be2888f..c399ac26ef42d 100644 --- a/clients/client-codebuild/commands/ListBuildsCommand.ts +++ b/clients/client-codebuild/commands/ListBuildsCommand.ts @@ -20,6 +20,9 @@ import { export type ListBuildsCommandInput = ListBuildsInput; export type ListBuildsCommandOutput = ListBuildsOutput & __MetadataBearer; +/** + *

Gets a list of build IDs, with each build ID representing a single build.

+ */ export class ListBuildsCommand extends $Command< ListBuildsCommandInput, ListBuildsCommandOutput, @@ -34,6 +37,9 @@ export class ListBuildsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListBuildsForProjectCommand.ts b/clients/client-codebuild/commands/ListBuildsForProjectCommand.ts index 2a97d9086a2c3..896fc98951703 100644 --- a/clients/client-codebuild/commands/ListBuildsForProjectCommand.ts +++ b/clients/client-codebuild/commands/ListBuildsForProjectCommand.ts @@ -20,6 +20,10 @@ import { export type ListBuildsForProjectCommandInput = ListBuildsForProjectInput; export type ListBuildsForProjectCommandOutput = ListBuildsForProjectOutput & __MetadataBearer; +/** + *

Gets a list of build IDs for the specified build project, with each build ID + * representing a single build.

+ */ export class ListBuildsForProjectCommand extends $Command< ListBuildsForProjectCommandInput, ListBuildsForProjectCommandOutput, @@ -34,6 +38,9 @@ export class ListBuildsForProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListCuratedEnvironmentImagesCommand.ts b/clients/client-codebuild/commands/ListCuratedEnvironmentImagesCommand.ts index 3cbdf2e9c05c2..30510773f5d07 100644 --- a/clients/client-codebuild/commands/ListCuratedEnvironmentImagesCommand.ts +++ b/clients/client-codebuild/commands/ListCuratedEnvironmentImagesCommand.ts @@ -20,6 +20,9 @@ import { export type ListCuratedEnvironmentImagesCommandInput = ListCuratedEnvironmentImagesInput; export type ListCuratedEnvironmentImagesCommandOutput = ListCuratedEnvironmentImagesOutput & __MetadataBearer; +/** + *

Gets information about Docker images that are managed by AWS CodeBuild.

+ */ export class ListCuratedEnvironmentImagesCommand extends $Command< ListCuratedEnvironmentImagesCommandInput, ListCuratedEnvironmentImagesCommandOutput, @@ -34,6 +37,9 @@ export class ListCuratedEnvironmentImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListProjectsCommand.ts b/clients/client-codebuild/commands/ListProjectsCommand.ts index 061aa56ae2bbe..5f00690affa2d 100644 --- a/clients/client-codebuild/commands/ListProjectsCommand.ts +++ b/clients/client-codebuild/commands/ListProjectsCommand.ts @@ -20,6 +20,10 @@ import { export type ListProjectsCommandInput = ListProjectsInput; export type ListProjectsCommandOutput = ListProjectsOutput & __MetadataBearer; +/** + *

Gets a list of build project names, with each build project name representing a single + * build project.

+ */ export class ListProjectsCommand extends $Command< ListProjectsCommandInput, ListProjectsCommandOutput, @@ -34,6 +38,9 @@ export class ListProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListReportGroupsCommand.ts b/clients/client-codebuild/commands/ListReportGroupsCommand.ts index 673eb29093180..bfc15920a9956 100644 --- a/clients/client-codebuild/commands/ListReportGroupsCommand.ts +++ b/clients/client-codebuild/commands/ListReportGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type ListReportGroupsCommandInput = ListReportGroupsInput; export type ListReportGroupsCommandOutput = ListReportGroupsOutput & __MetadataBearer; +/** + *

+ * Gets a list ARNs for the report groups in the current AWS account. + *

+ */ export class ListReportGroupsCommand extends $Command< ListReportGroupsCommandInput, ListReportGroupsCommandOutput, @@ -34,6 +39,9 @@ export class ListReportGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListReportsCommand.ts b/clients/client-codebuild/commands/ListReportsCommand.ts index 943d903beb6a8..a672568df5edb 100644 --- a/clients/client-codebuild/commands/ListReportsCommand.ts +++ b/clients/client-codebuild/commands/ListReportsCommand.ts @@ -20,6 +20,11 @@ import { export type ListReportsCommandInput = ListReportsInput; export type ListReportsCommandOutput = ListReportsOutput & __MetadataBearer; +/** + *

+ * Returns a list of ARNs for the reports in the current AWS account. + *

+ */ export class ListReportsCommand extends $Command< ListReportsCommandInput, ListReportsCommandOutput, @@ -34,6 +39,9 @@ export class ListReportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListReportsForReportGroupCommand.ts b/clients/client-codebuild/commands/ListReportsForReportGroupCommand.ts index 03fc1bdfc6d7b..857963edd49f8 100644 --- a/clients/client-codebuild/commands/ListReportsForReportGroupCommand.ts +++ b/clients/client-codebuild/commands/ListReportsForReportGroupCommand.ts @@ -20,6 +20,11 @@ import { export type ListReportsForReportGroupCommandInput = ListReportsForReportGroupInput; export type ListReportsForReportGroupCommandOutput = ListReportsForReportGroupOutput & __MetadataBearer; +/** + *

+ * Returns a list of ARNs for the reports that belong to a ReportGroup. + *

+ */ export class ListReportsForReportGroupCommand extends $Command< ListReportsForReportGroupCommandInput, ListReportsForReportGroupCommandOutput, @@ -34,6 +39,9 @@ export class ListReportsForReportGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListSharedProjectsCommand.ts b/clients/client-codebuild/commands/ListSharedProjectsCommand.ts index ea990a0a80b2b..15619ca40e2fc 100644 --- a/clients/client-codebuild/commands/ListSharedProjectsCommand.ts +++ b/clients/client-codebuild/commands/ListSharedProjectsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSharedProjectsCommandInput = ListSharedProjectsInput; export type ListSharedProjectsCommandOutput = ListSharedProjectsOutput & __MetadataBearer; +/** + *

Gets a list of projects that are shared with other AWS accounts or users.

+ */ export class ListSharedProjectsCommand extends $Command< ListSharedProjectsCommandInput, ListSharedProjectsCommandOutput, @@ -34,6 +37,9 @@ export class ListSharedProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListSharedReportGroupsCommand.ts b/clients/client-codebuild/commands/ListSharedReportGroupsCommand.ts index c808f5acc3df6..475330e9f7303 100644 --- a/clients/client-codebuild/commands/ListSharedReportGroupsCommand.ts +++ b/clients/client-codebuild/commands/ListSharedReportGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type ListSharedReportGroupsCommandInput = ListSharedReportGroupsInput; export type ListSharedReportGroupsCommandOutput = ListSharedReportGroupsOutput & __MetadataBearer; +/** + *

Gets a list of report groups that are shared with other AWS accounts or users. + *

+ */ export class ListSharedReportGroupsCommand extends $Command< ListSharedReportGroupsCommandInput, ListSharedReportGroupsCommandOutput, @@ -34,6 +38,9 @@ export class ListSharedReportGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/ListSourceCredentialsCommand.ts b/clients/client-codebuild/commands/ListSourceCredentialsCommand.ts index e64926a069813..193cdca0ef2d1 100644 --- a/clients/client-codebuild/commands/ListSourceCredentialsCommand.ts +++ b/clients/client-codebuild/commands/ListSourceCredentialsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSourceCredentialsCommandInput = ListSourceCredentialsInput; export type ListSourceCredentialsCommandOutput = ListSourceCredentialsOutput & __MetadataBearer; +/** + *

Returns a list of SourceCredentialsInfo objects.

+ */ export class ListSourceCredentialsCommand extends $Command< ListSourceCredentialsCommandInput, ListSourceCredentialsCommandOutput, @@ -34,6 +37,9 @@ export class ListSourceCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/PutResourcePolicyCommand.ts b/clients/client-codebuild/commands/PutResourcePolicyCommand.ts index 72f3bf8d086ce..8813de5be79e0 100644 --- a/clients/client-codebuild/commands/PutResourcePolicyCommand.ts +++ b/clients/client-codebuild/commands/PutResourcePolicyCommand.ts @@ -20,6 +20,10 @@ import { export type PutResourcePolicyCommandInput = PutResourcePolicyInput; export type PutResourcePolicyCommandOutput = PutResourcePolicyOutput & __MetadataBearer; +/** + *

Stores a resource policy for the ARN of a Project or + * ReportGroup object.

+ */ export class PutResourcePolicyCommand extends $Command< PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput, @@ -34,6 +38,9 @@ export class PutResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/RetryBuildBatchCommand.ts b/clients/client-codebuild/commands/RetryBuildBatchCommand.ts index 5e09b9c0919ed..22b80fa740fdf 100644 --- a/clients/client-codebuild/commands/RetryBuildBatchCommand.ts +++ b/clients/client-codebuild/commands/RetryBuildBatchCommand.ts @@ -20,6 +20,9 @@ import { export type RetryBuildBatchCommandInput = RetryBuildBatchInput; export type RetryBuildBatchCommandOutput = RetryBuildBatchOutput & __MetadataBearer; +/** + *

Restarts a failed batch build. Only batch builds that have failed can be retried.

+ */ export class RetryBuildBatchCommand extends $Command< RetryBuildBatchCommandInput, RetryBuildBatchCommandOutput, @@ -34,6 +37,9 @@ export class RetryBuildBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/RetryBuildCommand.ts b/clients/client-codebuild/commands/RetryBuildCommand.ts index 7029f8635bd72..35272fb5e14c8 100644 --- a/clients/client-codebuild/commands/RetryBuildCommand.ts +++ b/clients/client-codebuild/commands/RetryBuildCommand.ts @@ -20,6 +20,9 @@ import { export type RetryBuildCommandInput = RetryBuildInput; export type RetryBuildCommandOutput = RetryBuildOutput & __MetadataBearer; +/** + *

Restarts a build.

+ */ export class RetryBuildCommand extends $Command< RetryBuildCommandInput, RetryBuildCommandOutput, @@ -34,6 +37,9 @@ export class RetryBuildCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/StartBuildBatchCommand.ts b/clients/client-codebuild/commands/StartBuildBatchCommand.ts index c19e751fbdf43..610aae51e6225 100644 --- a/clients/client-codebuild/commands/StartBuildBatchCommand.ts +++ b/clients/client-codebuild/commands/StartBuildBatchCommand.ts @@ -20,6 +20,9 @@ import { export type StartBuildBatchCommandInput = StartBuildBatchInput; export type StartBuildBatchCommandOutput = StartBuildBatchOutput & __MetadataBearer; +/** + *

Starts a batch build for a project.

+ */ export class StartBuildBatchCommand extends $Command< StartBuildBatchCommandInput, StartBuildBatchCommandOutput, @@ -34,6 +37,9 @@ export class StartBuildBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/StartBuildCommand.ts b/clients/client-codebuild/commands/StartBuildCommand.ts index 0af06670b41e8..e3ad1df067ae9 100644 --- a/clients/client-codebuild/commands/StartBuildCommand.ts +++ b/clients/client-codebuild/commands/StartBuildCommand.ts @@ -20,6 +20,9 @@ import { export type StartBuildCommandInput = StartBuildInput; export type StartBuildCommandOutput = StartBuildOutput & __MetadataBearer; +/** + *

Starts running a build.

+ */ export class StartBuildCommand extends $Command< StartBuildCommandInput, StartBuildCommandOutput, @@ -34,6 +37,9 @@ export class StartBuildCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/StopBuildBatchCommand.ts b/clients/client-codebuild/commands/StopBuildBatchCommand.ts index caf0b9025265e..0857a9a97117a 100644 --- a/clients/client-codebuild/commands/StopBuildBatchCommand.ts +++ b/clients/client-codebuild/commands/StopBuildBatchCommand.ts @@ -20,6 +20,9 @@ import { export type StopBuildBatchCommandInput = StopBuildBatchInput; export type StopBuildBatchCommandOutput = StopBuildBatchOutput & __MetadataBearer; +/** + *

Stops a running batch build.

+ */ export class StopBuildBatchCommand extends $Command< StopBuildBatchCommandInput, StopBuildBatchCommandOutput, @@ -34,6 +37,9 @@ export class StopBuildBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/StopBuildCommand.ts b/clients/client-codebuild/commands/StopBuildCommand.ts index fa11eb8306f87..12198cde4efe7 100644 --- a/clients/client-codebuild/commands/StopBuildCommand.ts +++ b/clients/client-codebuild/commands/StopBuildCommand.ts @@ -17,6 +17,9 @@ import { export type StopBuildCommandInput = StopBuildInput; export type StopBuildCommandOutput = StopBuildOutput & __MetadataBearer; +/** + *

Attempts to stop running a build.

+ */ export class StopBuildCommand extends $Command< StopBuildCommandInput, StopBuildCommandOutput, @@ -31,6 +34,9 @@ export class StopBuildCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/UpdateProjectCommand.ts b/clients/client-codebuild/commands/UpdateProjectCommand.ts index 8f7f7ddd85e3c..0cff48fa0eb7a 100644 --- a/clients/client-codebuild/commands/UpdateProjectCommand.ts +++ b/clients/client-codebuild/commands/UpdateProjectCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProjectCommandInput = UpdateProjectInput; export type UpdateProjectCommandOutput = UpdateProjectOutput & __MetadataBearer; +/** + *

Changes the settings of a build project.

+ */ export class UpdateProjectCommand extends $Command< UpdateProjectCommandInput, UpdateProjectCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/UpdateReportGroupCommand.ts b/clients/client-codebuild/commands/UpdateReportGroupCommand.ts index ffbd4ddc2aadc..b4fa7b29542f5 100644 --- a/clients/client-codebuild/commands/UpdateReportGroupCommand.ts +++ b/clients/client-codebuild/commands/UpdateReportGroupCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateReportGroupCommandInput = UpdateReportGroupInput; export type UpdateReportGroupCommandOutput = UpdateReportGroupOutput & __MetadataBearer; +/** + *

+ * Updates a report group. + *

+ */ export class UpdateReportGroupCommand extends $Command< UpdateReportGroupCommandInput, UpdateReportGroupCommandOutput, @@ -34,6 +39,9 @@ export class UpdateReportGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/commands/UpdateWebhookCommand.ts b/clients/client-codebuild/commands/UpdateWebhookCommand.ts index ba422cb0d63af..653e9a4ff13d2 100644 --- a/clients/client-codebuild/commands/UpdateWebhookCommand.ts +++ b/clients/client-codebuild/commands/UpdateWebhookCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateWebhookCommandInput = UpdateWebhookInput; export type UpdateWebhookCommandOutput = UpdateWebhookOutput & __MetadataBearer; +/** + *

Updates the webhook associated with an AWS CodeBuild build project.

+ * + *

If you use Bitbucket for your repository, rotateSecret is ignored. + *

+ *
+ */ export class UpdateWebhookCommand extends $Command< UpdateWebhookCommandInput, UpdateWebhookCommandOutput, @@ -34,6 +41,9 @@ export class UpdateWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeBuildClientResolvedConfig, diff --git a/clients/client-codebuild/package.json b/clients/client-codebuild/package.json index 31b80057562bc..6553f6b4f7883 100644 --- a/clients/client-codebuild/package.json +++ b/clients/client-codebuild/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codebuild Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codebuild/pagination/DescribeCodeCoveragesPaginator.ts b/clients/client-codebuild/pagination/DescribeCodeCoveragesPaginator.ts index 5a5ac51b0146b..1299a4679c1bd 100644 --- a/clients/client-codebuild/pagination/DescribeCodeCoveragesPaginator.ts +++ b/clients/client-codebuild/pagination/DescribeCodeCoveragesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: DescribeCodeCoveragesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCodeCoveragesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: DescribeCodeCoveragesCommandInput, diff --git a/clients/client-codebuild/pagination/DescribeTestCasesPaginator.ts b/clients/client-codebuild/pagination/DescribeTestCasesPaginator.ts index e1c158aaae627..3cd8739c15a11 100644 --- a/clients/client-codebuild/pagination/DescribeTestCasesPaginator.ts +++ b/clients/client-codebuild/pagination/DescribeTestCasesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: DescribeTestCasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTestCasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: DescribeTestCasesCommandInput, diff --git a/clients/client-codebuild/pagination/ListBuildBatchesForProjectPaginator.ts b/clients/client-codebuild/pagination/ListBuildBatchesForProjectPaginator.ts index b384bf0ece8f1..f338c77ecd791 100644 --- a/clients/client-codebuild/pagination/ListBuildBatchesForProjectPaginator.ts +++ b/clients/client-codebuild/pagination/ListBuildBatchesForProjectPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListBuildBatchesForProjectCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBuildBatchesForProjectCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListBuildBatchesForProjectCommandInput, diff --git a/clients/client-codebuild/pagination/ListBuildBatchesPaginator.ts b/clients/client-codebuild/pagination/ListBuildBatchesPaginator.ts index 95e587662734d..7d50655db1db1 100644 --- a/clients/client-codebuild/pagination/ListBuildBatchesPaginator.ts +++ b/clients/client-codebuild/pagination/ListBuildBatchesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListBuildBatchesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBuildBatchesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListBuildBatchesCommandInput, diff --git a/clients/client-codebuild/pagination/ListBuildsForProjectPaginator.ts b/clients/client-codebuild/pagination/ListBuildsForProjectPaginator.ts index c136ca5988a50..64f89bd27b584 100644 --- a/clients/client-codebuild/pagination/ListBuildsForProjectPaginator.ts +++ b/clients/client-codebuild/pagination/ListBuildsForProjectPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListBuildsForProjectCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBuildsForProjectCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListBuildsForProjectCommandInput, diff --git a/clients/client-codebuild/pagination/ListBuildsPaginator.ts b/clients/client-codebuild/pagination/ListBuildsPaginator.ts index 7e0f566c7edce..16f7cce2c3d7b 100644 --- a/clients/client-codebuild/pagination/ListBuildsPaginator.ts +++ b/clients/client-codebuild/pagination/ListBuildsPaginator.ts @@ -4,6 +4,9 @@ import { ListBuildsCommand, ListBuildsCommandInput, ListBuildsCommandOutput } fr import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListBuildsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBuildsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListBuildsCommandInput, diff --git a/clients/client-codebuild/pagination/ListProjectsPaginator.ts b/clients/client-codebuild/pagination/ListProjectsPaginator.ts index 7da65db899c04..db0cc98a82fc1 100644 --- a/clients/client-codebuild/pagination/ListProjectsPaginator.ts +++ b/clients/client-codebuild/pagination/ListProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListProjectsCommandInput, diff --git a/clients/client-codebuild/pagination/ListReportGroupsPaginator.ts b/clients/client-codebuild/pagination/ListReportGroupsPaginator.ts index 68ed91760d827..cc6d860cec546 100644 --- a/clients/client-codebuild/pagination/ListReportGroupsPaginator.ts +++ b/clients/client-codebuild/pagination/ListReportGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListReportGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListReportGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListReportGroupsCommandInput, diff --git a/clients/client-codebuild/pagination/ListReportsForReportGroupPaginator.ts b/clients/client-codebuild/pagination/ListReportsForReportGroupPaginator.ts index 642a704cf223a..4be11034fea80 100644 --- a/clients/client-codebuild/pagination/ListReportsForReportGroupPaginator.ts +++ b/clients/client-codebuild/pagination/ListReportsForReportGroupPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListReportsForReportGroupCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListReportsForReportGroupCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListReportsForReportGroupCommandInput, diff --git a/clients/client-codebuild/pagination/ListReportsPaginator.ts b/clients/client-codebuild/pagination/ListReportsPaginator.ts index d8ae27a11d997..ca7e57722ac89 100644 --- a/clients/client-codebuild/pagination/ListReportsPaginator.ts +++ b/clients/client-codebuild/pagination/ListReportsPaginator.ts @@ -4,6 +4,9 @@ import { ListReportsCommand, ListReportsCommandInput, ListReportsCommandOutput } import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListReportsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListReportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListReportsCommandInput, diff --git a/clients/client-codebuild/pagination/ListSharedProjectsPaginator.ts b/clients/client-codebuild/pagination/ListSharedProjectsPaginator.ts index 3138d94e9d8c6..33adc75f048b1 100644 --- a/clients/client-codebuild/pagination/ListSharedProjectsPaginator.ts +++ b/clients/client-codebuild/pagination/ListSharedProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListSharedProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSharedProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListSharedProjectsCommandInput, diff --git a/clients/client-codebuild/pagination/ListSharedReportGroupsPaginator.ts b/clients/client-codebuild/pagination/ListSharedReportGroupsPaginator.ts index a27ff2d50156d..58baa82cabf5a 100644 --- a/clients/client-codebuild/pagination/ListSharedReportGroupsPaginator.ts +++ b/clients/client-codebuild/pagination/ListSharedReportGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeBuildPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeBuildClient, input: ListSharedReportGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSharedReportGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeBuild, input: ListSharedReportGroupsCommandInput, diff --git a/clients/client-codebuild/runtimeConfig.browser.ts b/clients/client-codebuild/runtimeConfig.browser.ts index de3d1ef3d0f28..fc405664254f9 100644 --- a/clients/client-codebuild/runtimeConfig.browser.ts +++ b/clients/client-codebuild/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodeBuildClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codebuild/runtimeConfig.native.ts b/clients/client-codebuild/runtimeConfig.native.ts index d749aea07ede1..ebf6dcb961b85 100644 --- a/clients/client-codebuild/runtimeConfig.native.ts +++ b/clients/client-codebuild/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodeBuildClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codebuild/runtimeConfig.shared.ts b/clients/client-codebuild/runtimeConfig.shared.ts index 23b1f2c23ecfe..e5bb366b40566 100644 --- a/clients/client-codebuild/runtimeConfig.shared.ts +++ b/clients/client-codebuild/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-10-06", disableHostPrefix: false, diff --git a/clients/client-codebuild/runtimeConfig.ts b/clients/client-codebuild/runtimeConfig.ts index cb4298333d53d..241b28f1a9a4a 100644 --- a/clients/client-codebuild/runtimeConfig.ts +++ b/clients/client-codebuild/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodeBuildClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codebuild/tsconfig.json b/clients/client-codebuild/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codebuild/tsconfig.json +++ b/clients/client-codebuild/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codecommit/commands/AssociateApprovalRuleTemplateWithRepositoryCommand.ts b/clients/client-codecommit/commands/AssociateApprovalRuleTemplateWithRepositoryCommand.ts index 51f51e645cf94..98546db47b10f 100644 --- a/clients/client-codecommit/commands/AssociateApprovalRuleTemplateWithRepositoryCommand.ts +++ b/clients/client-codecommit/commands/AssociateApprovalRuleTemplateWithRepositoryCommand.ts @@ -20,6 +20,15 @@ import { export type AssociateApprovalRuleTemplateWithRepositoryCommandInput = AssociateApprovalRuleTemplateWithRepositoryInput; export type AssociateApprovalRuleTemplateWithRepositoryCommandOutput = __MetadataBearer; +/** + *

Creates an association between an approval rule template and a specified repository. + * Then, the next time a pull request is created in the repository where the destination + * reference (if specified) matches the destination reference (branch) for the pull + * request, an approval rule that matches the template conditions is automatically created + * for that pull request. If no destination references are specified in the template, an + * approval rule that matches the template contents is created for all pull requests in + * that repository.

+ */ export class AssociateApprovalRuleTemplateWithRepositoryCommand extends $Command< AssociateApprovalRuleTemplateWithRepositoryCommandInput, AssociateApprovalRuleTemplateWithRepositoryCommandOutput, @@ -34,6 +43,9 @@ export class AssociateApprovalRuleTemplateWithRepositoryCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/BatchAssociateApprovalRuleTemplateWithRepositoriesCommand.ts b/clients/client-codecommit/commands/BatchAssociateApprovalRuleTemplateWithRepositoriesCommand.ts index bff50389b2edf..144b6070abdb6 100644 --- a/clients/client-codecommit/commands/BatchAssociateApprovalRuleTemplateWithRepositoriesCommand.ts +++ b/clients/client-codecommit/commands/BatchAssociateApprovalRuleTemplateWithRepositoriesCommand.ts @@ -24,6 +24,9 @@ export type BatchAssociateApprovalRuleTemplateWithRepositoriesCommandInput = Bat export type BatchAssociateApprovalRuleTemplateWithRepositoriesCommandOutput = BatchAssociateApprovalRuleTemplateWithRepositoriesOutput & __MetadataBearer; +/** + *

Creates an association between an approval rule template and one or more specified repositories.

+ */ export class BatchAssociateApprovalRuleTemplateWithRepositoriesCommand extends $Command< BatchAssociateApprovalRuleTemplateWithRepositoriesCommandInput, BatchAssociateApprovalRuleTemplateWithRepositoriesCommandOutput, @@ -38,6 +41,9 @@ export class BatchAssociateApprovalRuleTemplateWithRepositoriesCommand extends $ // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/BatchDescribeMergeConflictsCommand.ts b/clients/client-codecommit/commands/BatchDescribeMergeConflictsCommand.ts index 42006ebc55485..0524f7f11c277 100644 --- a/clients/client-codecommit/commands/BatchDescribeMergeConflictsCommand.ts +++ b/clients/client-codecommit/commands/BatchDescribeMergeConflictsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDescribeMergeConflictsCommandInput = BatchDescribeMergeConflictsInput; export type BatchDescribeMergeConflictsCommandOutput = BatchDescribeMergeConflictsOutput & __MetadataBearer; +/** + *

Returns information about one or more merge conflicts in the attempted merge of two commit specifiers using the squash or three-way merge strategy.

+ */ export class BatchDescribeMergeConflictsCommand extends $Command< BatchDescribeMergeConflictsCommandInput, BatchDescribeMergeConflictsCommandOutput, @@ -34,6 +37,9 @@ export class BatchDescribeMergeConflictsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/BatchDisassociateApprovalRuleTemplateFromRepositoriesCommand.ts b/clients/client-codecommit/commands/BatchDisassociateApprovalRuleTemplateFromRepositoriesCommand.ts index 9fd32103fb327..26f548283da7f 100644 --- a/clients/client-codecommit/commands/BatchDisassociateApprovalRuleTemplateFromRepositoriesCommand.ts +++ b/clients/client-codecommit/commands/BatchDisassociateApprovalRuleTemplateFromRepositoriesCommand.ts @@ -24,6 +24,9 @@ export type BatchDisassociateApprovalRuleTemplateFromRepositoriesCommandInput = export type BatchDisassociateApprovalRuleTemplateFromRepositoriesCommandOutput = BatchDisassociateApprovalRuleTemplateFromRepositoriesOutput & __MetadataBearer; +/** + *

Removes the association between an approval rule template and one or more specified repositories.

+ */ export class BatchDisassociateApprovalRuleTemplateFromRepositoriesCommand extends $Command< BatchDisassociateApprovalRuleTemplateFromRepositoriesCommandInput, BatchDisassociateApprovalRuleTemplateFromRepositoriesCommandOutput, @@ -38,6 +41,9 @@ export class BatchDisassociateApprovalRuleTemplateFromRepositoriesCommand extend // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/BatchGetCommitsCommand.ts b/clients/client-codecommit/commands/BatchGetCommitsCommand.ts index 0fb8ac07ad879..eea0921ee74c9 100644 --- a/clients/client-codecommit/commands/BatchGetCommitsCommand.ts +++ b/clients/client-codecommit/commands/BatchGetCommitsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetCommitsCommandInput = BatchGetCommitsInput; export type BatchGetCommitsCommandOutput = BatchGetCommitsOutput & __MetadataBearer; +/** + *

Returns information about the contents of one or more commits in a repository.

+ */ export class BatchGetCommitsCommand extends $Command< BatchGetCommitsCommandInput, BatchGetCommitsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetCommitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/BatchGetRepositoriesCommand.ts b/clients/client-codecommit/commands/BatchGetRepositoriesCommand.ts index a9b002c930a2c..d3a77655086b6 100644 --- a/clients/client-codecommit/commands/BatchGetRepositoriesCommand.ts +++ b/clients/client-codecommit/commands/BatchGetRepositoriesCommand.ts @@ -20,6 +20,16 @@ import { export type BatchGetRepositoriesCommandInput = BatchGetRepositoriesInput; export type BatchGetRepositoriesCommandOutput = BatchGetRepositoriesOutput & __MetadataBearer; +/** + *

Returns information about one or more repositories.

+ * + *

The description field for a repository accepts all HTML characters and all valid + * Unicode characters. Applications that do not HTML-encode the description and display + * it in a webpage can expose users to potentially malicious code. Make sure that you + * HTML-encode the description field in any application that uses this API to display + * the repository description on a webpage.

+ *
+ */ export class BatchGetRepositoriesCommand extends $Command< BatchGetRepositoriesCommandInput, BatchGetRepositoriesCommandOutput, @@ -34,6 +44,9 @@ export class BatchGetRepositoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/CreateApprovalRuleTemplateCommand.ts b/clients/client-codecommit/commands/CreateApprovalRuleTemplateCommand.ts index 5d324373148cc..cbc11d5898ea9 100644 --- a/clients/client-codecommit/commands/CreateApprovalRuleTemplateCommand.ts +++ b/clients/client-codecommit/commands/CreateApprovalRuleTemplateCommand.ts @@ -20,6 +20,13 @@ import { export type CreateApprovalRuleTemplateCommandInput = CreateApprovalRuleTemplateInput; export type CreateApprovalRuleTemplateCommandOutput = CreateApprovalRuleTemplateOutput & __MetadataBearer; +/** + *

Creates a template for approval rules that can then be associated with one or more + * repositories in your AWS account. When you associate a template with a repository, AWS + * CodeCommit creates an approval rule that matches the conditions of the template for all + * pull requests that meet the conditions of the template. For more information, see + * AssociateApprovalRuleTemplateWithRepository.

+ */ export class CreateApprovalRuleTemplateCommand extends $Command< CreateApprovalRuleTemplateCommandInput, CreateApprovalRuleTemplateCommandOutput, @@ -34,6 +41,9 @@ export class CreateApprovalRuleTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/CreateBranchCommand.ts b/clients/client-codecommit/commands/CreateBranchCommand.ts index 31d7eef57b206..a873c5f2b2d1c 100644 --- a/clients/client-codecommit/commands/CreateBranchCommand.ts +++ b/clients/client-codecommit/commands/CreateBranchCommand.ts @@ -20,6 +20,12 @@ import { export type CreateBranchCommandInput = CreateBranchInput; export type CreateBranchCommandOutput = __MetadataBearer; +/** + *

Creates a branch in a repository and points the branch to a commit.

+ * + *

Calling the create branch operation does not set a repository's default branch. To do this, call the update default branch operation.

+ *
+ */ export class CreateBranchCommand extends $Command< CreateBranchCommandInput, CreateBranchCommandOutput, @@ -34,6 +40,9 @@ export class CreateBranchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/CreateCommitCommand.ts b/clients/client-codecommit/commands/CreateCommitCommand.ts index acf02c0305899..0950a504b8d58 100644 --- a/clients/client-codecommit/commands/CreateCommitCommand.ts +++ b/clients/client-codecommit/commands/CreateCommitCommand.ts @@ -20,6 +20,9 @@ import { export type CreateCommitCommandInput = CreateCommitInput; export type CreateCommitCommandOutput = CreateCommitOutput & __MetadataBearer; +/** + *

Creates a commit for a repository on the tip of a specified branch.

+ */ export class CreateCommitCommand extends $Command< CreateCommitCommandInput, CreateCommitCommandOutput, @@ -34,6 +37,9 @@ export class CreateCommitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/CreatePullRequestApprovalRuleCommand.ts b/clients/client-codecommit/commands/CreatePullRequestApprovalRuleCommand.ts index a4a6f5485f523..eba1049fb9469 100644 --- a/clients/client-codecommit/commands/CreatePullRequestApprovalRuleCommand.ts +++ b/clients/client-codecommit/commands/CreatePullRequestApprovalRuleCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePullRequestApprovalRuleCommandInput = CreatePullRequestApprovalRuleInput; export type CreatePullRequestApprovalRuleCommandOutput = CreatePullRequestApprovalRuleOutput & __MetadataBearer; +/** + *

Creates an approval rule for a pull request.

+ */ export class CreatePullRequestApprovalRuleCommand extends $Command< CreatePullRequestApprovalRuleCommandInput, CreatePullRequestApprovalRuleCommandOutput, @@ -34,6 +37,9 @@ export class CreatePullRequestApprovalRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/CreatePullRequestCommand.ts b/clients/client-codecommit/commands/CreatePullRequestCommand.ts index 59480c9b48238..a533ff5a240af 100644 --- a/clients/client-codecommit/commands/CreatePullRequestCommand.ts +++ b/clients/client-codecommit/commands/CreatePullRequestCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePullRequestCommandInput = CreatePullRequestInput; export type CreatePullRequestCommandOutput = CreatePullRequestOutput & __MetadataBearer; +/** + *

Creates a pull request in the specified repository.

+ */ export class CreatePullRequestCommand extends $Command< CreatePullRequestCommandInput, CreatePullRequestCommandOutput, @@ -34,6 +37,9 @@ export class CreatePullRequestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/CreateRepositoryCommand.ts b/clients/client-codecommit/commands/CreateRepositoryCommand.ts index 8a485a27c0a7c..dab6245a1edb8 100644 --- a/clients/client-codecommit/commands/CreateRepositoryCommand.ts +++ b/clients/client-codecommit/commands/CreateRepositoryCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRepositoryCommandInput = CreateRepositoryInput; export type CreateRepositoryCommandOutput = CreateRepositoryOutput & __MetadataBearer; +/** + *

Creates a new, empty repository.

+ */ export class CreateRepositoryCommand extends $Command< CreateRepositoryCommandInput, CreateRepositoryCommandOutput, @@ -34,6 +37,9 @@ export class CreateRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/CreateUnreferencedMergeCommitCommand.ts b/clients/client-codecommit/commands/CreateUnreferencedMergeCommitCommand.ts index 75b97f4db1e6d..65a4d40617c74 100644 --- a/clients/client-codecommit/commands/CreateUnreferencedMergeCommitCommand.ts +++ b/clients/client-codecommit/commands/CreateUnreferencedMergeCommitCommand.ts @@ -20,6 +20,16 @@ import { export type CreateUnreferencedMergeCommitCommandInput = CreateUnreferencedMergeCommitInput; export type CreateUnreferencedMergeCommitCommandOutput = CreateUnreferencedMergeCommitOutput & __MetadataBearer; +/** + *

Creates an unreferenced commit that represents the result of merging two branches + * using a specified merge strategy. This can help you determine the outcome of a potential + * merge. This API cannot be used with the fast-forward merge strategy because that + * strategy does not create a merge commit.

+ * + *

This unreferenced merge commit + * can only be accessed using the GetCommit API or through git commands such as git fetch. To retrieve this commit, you must specify its commit ID or otherwise reference it.

+ *
+ */ export class CreateUnreferencedMergeCommitCommand extends $Command< CreateUnreferencedMergeCommitCommandInput, CreateUnreferencedMergeCommitCommandOutput, @@ -34,6 +44,9 @@ export class CreateUnreferencedMergeCommitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DeleteApprovalRuleTemplateCommand.ts b/clients/client-codecommit/commands/DeleteApprovalRuleTemplateCommand.ts index ace42e7619e8e..0f4764d170584 100644 --- a/clients/client-codecommit/commands/DeleteApprovalRuleTemplateCommand.ts +++ b/clients/client-codecommit/commands/DeleteApprovalRuleTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApprovalRuleTemplateCommandInput = DeleteApprovalRuleTemplateInput; export type DeleteApprovalRuleTemplateCommandOutput = DeleteApprovalRuleTemplateOutput & __MetadataBearer; +/** + *

Deletes a specified approval rule template. Deleting a template does not remove approval rules on pull requests already created with the template.

+ */ export class DeleteApprovalRuleTemplateCommand extends $Command< DeleteApprovalRuleTemplateCommandInput, DeleteApprovalRuleTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApprovalRuleTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DeleteBranchCommand.ts b/clients/client-codecommit/commands/DeleteBranchCommand.ts index 176de20fba327..70308b51b700b 100644 --- a/clients/client-codecommit/commands/DeleteBranchCommand.ts +++ b/clients/client-codecommit/commands/DeleteBranchCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBranchCommandInput = DeleteBranchInput; export type DeleteBranchCommandOutput = DeleteBranchOutput & __MetadataBearer; +/** + *

Deletes a branch from a repository, unless that branch is the default branch for the repository.

+ */ export class DeleteBranchCommand extends $Command< DeleteBranchCommandInput, DeleteBranchCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBranchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DeleteCommentContentCommand.ts b/clients/client-codecommit/commands/DeleteCommentContentCommand.ts index ff1506bd41f3c..9ef9931d96b8a 100644 --- a/clients/client-codecommit/commands/DeleteCommentContentCommand.ts +++ b/clients/client-codecommit/commands/DeleteCommentContentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCommentContentCommandInput = DeleteCommentContentInput; export type DeleteCommentContentCommandOutput = DeleteCommentContentOutput & __MetadataBearer; +/** + *

Deletes the content of a comment made on a change, file, or commit in a repository.

+ */ export class DeleteCommentContentCommand extends $Command< DeleteCommentContentCommandInput, DeleteCommentContentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCommentContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DeleteFileCommand.ts b/clients/client-codecommit/commands/DeleteFileCommand.ts index 8d420cc72716d..f168b340c5c83 100644 --- a/clients/client-codecommit/commands/DeleteFileCommand.ts +++ b/clients/client-codecommit/commands/DeleteFileCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteFileCommandInput = DeleteFileInput; export type DeleteFileCommandOutput = DeleteFileOutput & __MetadataBearer; +/** + *

Deletes a specified file from a specified branch. A commit is created on the branch + * that contains the revision. The file still exists in the commits earlier to the commit + * that contains the deletion.

+ */ export class DeleteFileCommand extends $Command< DeleteFileCommandInput, DeleteFileCommandOutput, @@ -34,6 +39,9 @@ export class DeleteFileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DeletePullRequestApprovalRuleCommand.ts b/clients/client-codecommit/commands/DeletePullRequestApprovalRuleCommand.ts index a2758ff7ea5dd..81f915e2e7739 100644 --- a/clients/client-codecommit/commands/DeletePullRequestApprovalRuleCommand.ts +++ b/clients/client-codecommit/commands/DeletePullRequestApprovalRuleCommand.ts @@ -20,6 +20,11 @@ import { export type DeletePullRequestApprovalRuleCommandInput = DeletePullRequestApprovalRuleInput; export type DeletePullRequestApprovalRuleCommandOutput = DeletePullRequestApprovalRuleOutput & __MetadataBearer; +/** + *

Deletes an approval rule from a specified pull request. Approval rules can be deleted from a pull request only if the pull request is open, and if the + * approval rule was created specifically for a pull request and not generated from an approval rule template associated with the repository where the + * pull request was created. You cannot delete an approval rule from a merged or closed pull request.

+ */ export class DeletePullRequestApprovalRuleCommand extends $Command< DeletePullRequestApprovalRuleCommandInput, DeletePullRequestApprovalRuleCommandOutput, @@ -34,6 +39,9 @@ export class DeletePullRequestApprovalRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DeleteRepositoryCommand.ts b/clients/client-codecommit/commands/DeleteRepositoryCommand.ts index c1ecdb762ff59..155c36c8e3455 100644 --- a/clients/client-codecommit/commands/DeleteRepositoryCommand.ts +++ b/clients/client-codecommit/commands/DeleteRepositoryCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteRepositoryCommandInput = DeleteRepositoryInput; export type DeleteRepositoryCommandOutput = DeleteRepositoryOutput & __MetadataBearer; +/** + *

Deletes a repository. If a specified repository was already deleted, a null repository + * ID is returned.

+ * + *

Deleting a repository also deletes all associated objects and metadata. After a repository is + * deleted, all future push calls to the deleted repository fail.

+ *
+ */ export class DeleteRepositoryCommand extends $Command< DeleteRepositoryCommandInput, DeleteRepositoryCommandOutput, @@ -34,6 +42,9 @@ export class DeleteRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DescribeMergeConflictsCommand.ts b/clients/client-codecommit/commands/DescribeMergeConflictsCommand.ts index 877274d320418..8bb6a8fe636e4 100644 --- a/clients/client-codecommit/commands/DescribeMergeConflictsCommand.ts +++ b/clients/client-codecommit/commands/DescribeMergeConflictsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeMergeConflictsCommandInput = DescribeMergeConflictsInput; export type DescribeMergeConflictsCommandOutput = DescribeMergeConflictsOutput & __MetadataBearer; +/** + *

Returns information about one or more merge conflicts in the attempted merge of two + * commit specifiers using the squash or three-way merge strategy. If the merge option for + * the attempted merge is specified as FAST_FORWARD_MERGE, an exception is thrown.

+ */ export class DescribeMergeConflictsCommand extends $Command< DescribeMergeConflictsCommandInput, DescribeMergeConflictsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeMergeConflictsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DescribePullRequestEventsCommand.ts b/clients/client-codecommit/commands/DescribePullRequestEventsCommand.ts index 2b7fecfdead30..3b81f841ebb56 100644 --- a/clients/client-codecommit/commands/DescribePullRequestEventsCommand.ts +++ b/clients/client-codecommit/commands/DescribePullRequestEventsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePullRequestEventsCommandInput = DescribePullRequestEventsInput; export type DescribePullRequestEventsCommandOutput = DescribePullRequestEventsOutput & __MetadataBearer; +/** + *

Returns information about one or more pull request events.

+ */ export class DescribePullRequestEventsCommand extends $Command< DescribePullRequestEventsCommandInput, DescribePullRequestEventsCommandOutput, @@ -34,6 +37,9 @@ export class DescribePullRequestEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/DisassociateApprovalRuleTemplateFromRepositoryCommand.ts b/clients/client-codecommit/commands/DisassociateApprovalRuleTemplateFromRepositoryCommand.ts index 0242e8a323fc9..a0458c72011ca 100644 --- a/clients/client-codecommit/commands/DisassociateApprovalRuleTemplateFromRepositoryCommand.ts +++ b/clients/client-codecommit/commands/DisassociateApprovalRuleTemplateFromRepositoryCommand.ts @@ -20,6 +20,12 @@ import { export type DisassociateApprovalRuleTemplateFromRepositoryCommandInput = DisassociateApprovalRuleTemplateFromRepositoryInput; export type DisassociateApprovalRuleTemplateFromRepositoryCommandOutput = __MetadataBearer; +/** + *

Removes the association between a template and a repository so that approval rules + * based on the template are not automatically created when pull requests are created in + * the specified repository. This does not delete any approval rules previously created for + * pull requests through the template association.

+ */ export class DisassociateApprovalRuleTemplateFromRepositoryCommand extends $Command< DisassociateApprovalRuleTemplateFromRepositoryCommandInput, DisassociateApprovalRuleTemplateFromRepositoryCommandOutput, @@ -34,6 +40,9 @@ export class DisassociateApprovalRuleTemplateFromRepositoryCommand extends $Comm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/EvaluatePullRequestApprovalRulesCommand.ts b/clients/client-codecommit/commands/EvaluatePullRequestApprovalRulesCommand.ts index a102022a35d06..d4105bf539213 100644 --- a/clients/client-codecommit/commands/EvaluatePullRequestApprovalRulesCommand.ts +++ b/clients/client-codecommit/commands/EvaluatePullRequestApprovalRulesCommand.ts @@ -20,6 +20,9 @@ import { export type EvaluatePullRequestApprovalRulesCommandInput = EvaluatePullRequestApprovalRulesInput; export type EvaluatePullRequestApprovalRulesCommandOutput = EvaluatePullRequestApprovalRulesOutput & __MetadataBearer; +/** + *

Evaluates whether a pull request has met all the conditions specified in its associated approval rules.

+ */ export class EvaluatePullRequestApprovalRulesCommand extends $Command< EvaluatePullRequestApprovalRulesCommandInput, EvaluatePullRequestApprovalRulesCommandOutput, @@ -34,6 +37,9 @@ export class EvaluatePullRequestApprovalRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetApprovalRuleTemplateCommand.ts b/clients/client-codecommit/commands/GetApprovalRuleTemplateCommand.ts index 2a5e9a7569843..698c2868b2417 100644 --- a/clients/client-codecommit/commands/GetApprovalRuleTemplateCommand.ts +++ b/clients/client-codecommit/commands/GetApprovalRuleTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetApprovalRuleTemplateCommandInput = GetApprovalRuleTemplateInput; export type GetApprovalRuleTemplateCommandOutput = GetApprovalRuleTemplateOutput & __MetadataBearer; +/** + *

Returns information about a specified approval rule template.

+ */ export class GetApprovalRuleTemplateCommand extends $Command< GetApprovalRuleTemplateCommandInput, GetApprovalRuleTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetApprovalRuleTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetBlobCommand.ts b/clients/client-codecommit/commands/GetBlobCommand.ts index 348bcf53aa1bc..6f14e2b951e93 100644 --- a/clients/client-codecommit/commands/GetBlobCommand.ts +++ b/clients/client-codecommit/commands/GetBlobCommand.ts @@ -17,6 +17,9 @@ import { export type GetBlobCommandInput = GetBlobInput; export type GetBlobCommandOutput = GetBlobOutput & __MetadataBearer; +/** + *

Returns the base-64 encoded content of an individual blob in a repository.

+ */ export class GetBlobCommand extends $Command< GetBlobCommandInput, GetBlobCommandOutput, @@ -31,6 +34,9 @@ export class GetBlobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetBranchCommand.ts b/clients/client-codecommit/commands/GetBranchCommand.ts index eb4272407b0c4..459d04ec281fe 100644 --- a/clients/client-codecommit/commands/GetBranchCommand.ts +++ b/clients/client-codecommit/commands/GetBranchCommand.ts @@ -17,6 +17,9 @@ import { export type GetBranchCommandInput = GetBranchInput; export type GetBranchCommandOutput = GetBranchOutput & __MetadataBearer; +/** + *

Returns information about a repository branch, including its name and the last commit ID.

+ */ export class GetBranchCommand extends $Command< GetBranchCommandInput, GetBranchCommandOutput, @@ -31,6 +34,9 @@ export class GetBranchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetCommentCommand.ts b/clients/client-codecommit/commands/GetCommentCommand.ts index b619c78e60532..7c8c3492d73d0 100644 --- a/clients/client-codecommit/commands/GetCommentCommand.ts +++ b/clients/client-codecommit/commands/GetCommentCommand.ts @@ -20,6 +20,13 @@ import { export type GetCommentCommandInput = GetCommentInput; export type GetCommentCommandOutput = GetCommentOutput & __MetadataBearer; +/** + *

Returns the content of a comment made on a change, file, or commit in a repository.

+ * + *

Reaction counts might include numbers from user identities who were deleted after the reaction was made. For a count of + * reactions from active identities, use GetCommentReactions.

+ *
+ */ export class GetCommentCommand extends $Command< GetCommentCommandInput, GetCommentCommandOutput, @@ -34,6 +41,9 @@ export class GetCommentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetCommentReactionsCommand.ts b/clients/client-codecommit/commands/GetCommentReactionsCommand.ts index 38331d0a1d18e..e6baaa4ddd55c 100644 --- a/clients/client-codecommit/commands/GetCommentReactionsCommand.ts +++ b/clients/client-codecommit/commands/GetCommentReactionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetCommentReactionsCommandInput = GetCommentReactionsInput; export type GetCommentReactionsCommandOutput = GetCommentReactionsOutput & __MetadataBearer; +/** + *

Returns information about reactions to a specified comment ID. Reactions from users who have been deleted will not be included in the count.

+ */ export class GetCommentReactionsCommand extends $Command< GetCommentReactionsCommandInput, GetCommentReactionsCommandOutput, @@ -34,6 +37,9 @@ export class GetCommentReactionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetCommentsForComparedCommitCommand.ts b/clients/client-codecommit/commands/GetCommentsForComparedCommitCommand.ts index 1756daebb3965..2dd502a349af3 100644 --- a/clients/client-codecommit/commands/GetCommentsForComparedCommitCommand.ts +++ b/clients/client-codecommit/commands/GetCommentsForComparedCommitCommand.ts @@ -20,6 +20,13 @@ import { export type GetCommentsForComparedCommitCommandInput = GetCommentsForComparedCommitInput; export type GetCommentsForComparedCommitCommandOutput = GetCommentsForComparedCommitOutput & __MetadataBearer; +/** + *

Returns information about comments made on the comparison between two commits.

+ * + *

Reaction counts might include numbers from user identities who were deleted after the reaction was made. For a count of + * reactions from active identities, use GetCommentReactions.

+ *
+ */ export class GetCommentsForComparedCommitCommand extends $Command< GetCommentsForComparedCommitCommandInput, GetCommentsForComparedCommitCommandOutput, @@ -34,6 +41,9 @@ export class GetCommentsForComparedCommitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetCommentsForPullRequestCommand.ts b/clients/client-codecommit/commands/GetCommentsForPullRequestCommand.ts index 6bdeadc6dd1a9..567bc098e5476 100644 --- a/clients/client-codecommit/commands/GetCommentsForPullRequestCommand.ts +++ b/clients/client-codecommit/commands/GetCommentsForPullRequestCommand.ts @@ -20,6 +20,13 @@ import { export type GetCommentsForPullRequestCommandInput = GetCommentsForPullRequestInput; export type GetCommentsForPullRequestCommandOutput = GetCommentsForPullRequestOutput & __MetadataBearer; +/** + *

Returns comments made on a pull request.

+ * + *

Reaction counts might include numbers from user identities who were deleted after the reaction was made. For a count of + * reactions from active identities, use GetCommentReactions.

+ *
+ */ export class GetCommentsForPullRequestCommand extends $Command< GetCommentsForPullRequestCommandInput, GetCommentsForPullRequestCommandOutput, @@ -34,6 +41,9 @@ export class GetCommentsForPullRequestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetCommitCommand.ts b/clients/client-codecommit/commands/GetCommitCommand.ts index b71209fe9209a..0fb5784a57eef 100644 --- a/clients/client-codecommit/commands/GetCommitCommand.ts +++ b/clients/client-codecommit/commands/GetCommitCommand.ts @@ -17,6 +17,9 @@ import { export type GetCommitCommandInput = GetCommitInput; export type GetCommitCommandOutput = GetCommitOutput & __MetadataBearer; +/** + *

Returns information about a commit, including commit message and committer information.

+ */ export class GetCommitCommand extends $Command< GetCommitCommandInput, GetCommitCommandOutput, @@ -31,6 +34,9 @@ export class GetCommitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetDifferencesCommand.ts b/clients/client-codecommit/commands/GetDifferencesCommand.ts index 6d9cd76f34cd4..32f030d2a584b 100644 --- a/clients/client-codecommit/commands/GetDifferencesCommand.ts +++ b/clients/client-codecommit/commands/GetDifferencesCommand.ts @@ -20,6 +20,11 @@ import { export type GetDifferencesCommandInput = GetDifferencesInput; export type GetDifferencesCommandOutput = GetDifferencesOutput & __MetadataBearer; +/** + *

Returns information about the differences in a valid commit specifier (such as a + * branch, tag, HEAD, commit ID, or other fully qualified reference). Results can be + * limited to a specified path.

+ */ export class GetDifferencesCommand extends $Command< GetDifferencesCommandInput, GetDifferencesCommandOutput, @@ -34,6 +39,9 @@ export class GetDifferencesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetFileCommand.ts b/clients/client-codecommit/commands/GetFileCommand.ts index d82e0887c46d1..f0092d616d7f4 100644 --- a/clients/client-codecommit/commands/GetFileCommand.ts +++ b/clients/client-codecommit/commands/GetFileCommand.ts @@ -17,6 +17,9 @@ import { export type GetFileCommandInput = GetFileInput; export type GetFileCommandOutput = GetFileOutput & __MetadataBearer; +/** + *

Returns the base-64 encoded contents of a specified file and its metadata.

+ */ export class GetFileCommand extends $Command< GetFileCommandInput, GetFileCommandOutput, @@ -31,6 +34,9 @@ export class GetFileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetFolderCommand.ts b/clients/client-codecommit/commands/GetFolderCommand.ts index 0f58b0bb01357..a05b93382bd3d 100644 --- a/clients/client-codecommit/commands/GetFolderCommand.ts +++ b/clients/client-codecommit/commands/GetFolderCommand.ts @@ -17,6 +17,9 @@ import { export type GetFolderCommandInput = GetFolderInput; export type GetFolderCommandOutput = GetFolderOutput & __MetadataBearer; +/** + *

Returns the contents of a specified folder in a repository.

+ */ export class GetFolderCommand extends $Command< GetFolderCommandInput, GetFolderCommandOutput, @@ -31,6 +34,9 @@ export class GetFolderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetMergeCommitCommand.ts b/clients/client-codecommit/commands/GetMergeCommitCommand.ts index 9a32ac0ae7f22..407ccb7fb3771 100644 --- a/clients/client-codecommit/commands/GetMergeCommitCommand.ts +++ b/clients/client-codecommit/commands/GetMergeCommitCommand.ts @@ -20,6 +20,9 @@ import { export type GetMergeCommitCommandInput = GetMergeCommitInput; export type GetMergeCommitCommandOutput = GetMergeCommitOutput & __MetadataBearer; +/** + *

Returns information about a specified merge commit.

+ */ export class GetMergeCommitCommand extends $Command< GetMergeCommitCommandInput, GetMergeCommitCommandOutput, @@ -34,6 +37,9 @@ export class GetMergeCommitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetMergeConflictsCommand.ts b/clients/client-codecommit/commands/GetMergeConflictsCommand.ts index a27dde5b6ae46..b521a9dd92d8f 100644 --- a/clients/client-codecommit/commands/GetMergeConflictsCommand.ts +++ b/clients/client-codecommit/commands/GetMergeConflictsCommand.ts @@ -20,6 +20,9 @@ import { export type GetMergeConflictsCommandInput = GetMergeConflictsInput; export type GetMergeConflictsCommandOutput = GetMergeConflictsOutput & __MetadataBearer; +/** + *

Returns information about merge conflicts between the before and after commit IDs for a pull request in a repository.

+ */ export class GetMergeConflictsCommand extends $Command< GetMergeConflictsCommandInput, GetMergeConflictsCommandOutput, @@ -34,6 +37,9 @@ export class GetMergeConflictsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetMergeOptionsCommand.ts b/clients/client-codecommit/commands/GetMergeOptionsCommand.ts index f59b0536ac51a..1ecffbc0f9014 100644 --- a/clients/client-codecommit/commands/GetMergeOptionsCommand.ts +++ b/clients/client-codecommit/commands/GetMergeOptionsCommand.ts @@ -20,6 +20,11 @@ import { export type GetMergeOptionsCommandInput = GetMergeOptionsInput; export type GetMergeOptionsCommandOutput = GetMergeOptionsOutput & __MetadataBearer; +/** + *

Returns information about the merge options available for merging two specified + * branches. For details about why a merge option is not available, use GetMergeConflicts + * or DescribeMergeConflicts.

+ */ export class GetMergeOptionsCommand extends $Command< GetMergeOptionsCommandInput, GetMergeOptionsCommandOutput, @@ -34,6 +39,9 @@ export class GetMergeOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetPullRequestApprovalStatesCommand.ts b/clients/client-codecommit/commands/GetPullRequestApprovalStatesCommand.ts index 8a879a639e52c..39aca0e4ca0e3 100644 --- a/clients/client-codecommit/commands/GetPullRequestApprovalStatesCommand.ts +++ b/clients/client-codecommit/commands/GetPullRequestApprovalStatesCommand.ts @@ -20,6 +20,10 @@ import { export type GetPullRequestApprovalStatesCommandInput = GetPullRequestApprovalStatesInput; export type GetPullRequestApprovalStatesCommandOutput = GetPullRequestApprovalStatesOutput & __MetadataBearer; +/** + *

Gets information about the approval states for a specified pull request. Approval states only apply to pull requests that have one or more + * approval rules applied to them.

+ */ export class GetPullRequestApprovalStatesCommand extends $Command< GetPullRequestApprovalStatesCommandInput, GetPullRequestApprovalStatesCommandOutput, @@ -34,6 +38,9 @@ export class GetPullRequestApprovalStatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetPullRequestCommand.ts b/clients/client-codecommit/commands/GetPullRequestCommand.ts index 6d87a18e7faaf..071e681558a67 100644 --- a/clients/client-codecommit/commands/GetPullRequestCommand.ts +++ b/clients/client-codecommit/commands/GetPullRequestCommand.ts @@ -20,6 +20,9 @@ import { export type GetPullRequestCommandInput = GetPullRequestInput; export type GetPullRequestCommandOutput = GetPullRequestOutput & __MetadataBearer; +/** + *

Gets information about a pull request in a specified repository.

+ */ export class GetPullRequestCommand extends $Command< GetPullRequestCommandInput, GetPullRequestCommandOutput, @@ -34,6 +37,9 @@ export class GetPullRequestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetPullRequestOverrideStateCommand.ts b/clients/client-codecommit/commands/GetPullRequestOverrideStateCommand.ts index 1dd77a58dc2ec..6eada6e5d3750 100644 --- a/clients/client-codecommit/commands/GetPullRequestOverrideStateCommand.ts +++ b/clients/client-codecommit/commands/GetPullRequestOverrideStateCommand.ts @@ -20,6 +20,10 @@ import { export type GetPullRequestOverrideStateCommandInput = GetPullRequestOverrideStateInput; export type GetPullRequestOverrideStateCommandOutput = GetPullRequestOverrideStateOutput & __MetadataBearer; +/** + *

Returns information about whether approval rules have been set aside (overridden) for a + * pull request, and if so, the Amazon Resource Name (ARN) of the user or identity that overrode the rules and their requirements for the pull request.

+ */ export class GetPullRequestOverrideStateCommand extends $Command< GetPullRequestOverrideStateCommandInput, GetPullRequestOverrideStateCommandOutput, @@ -34,6 +38,9 @@ export class GetPullRequestOverrideStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetRepositoryCommand.ts b/clients/client-codecommit/commands/GetRepositoryCommand.ts index 78252e8caa2ff..46ea7b562151b 100644 --- a/clients/client-codecommit/commands/GetRepositoryCommand.ts +++ b/clients/client-codecommit/commands/GetRepositoryCommand.ts @@ -20,6 +20,17 @@ import { export type GetRepositoryCommandInput = GetRepositoryInput; export type GetRepositoryCommandOutput = GetRepositoryOutput & __MetadataBearer; +/** + *

Returns information about a repository.

+ * + * + *

The description field for a repository accepts all HTML characters and all valid + * Unicode characters. Applications that do not HTML-encode the description and display + * it in a webpage can expose users to potentially malicious code. Make sure that you + * HTML-encode the description field in any application that uses this API to display + * the repository description on a webpage.

+ *
+ */ export class GetRepositoryCommand extends $Command< GetRepositoryCommandInput, GetRepositoryCommandOutput, @@ -34,6 +45,9 @@ export class GetRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/GetRepositoryTriggersCommand.ts b/clients/client-codecommit/commands/GetRepositoryTriggersCommand.ts index 2a92ffb7c3a50..e061ce5a7470d 100644 --- a/clients/client-codecommit/commands/GetRepositoryTriggersCommand.ts +++ b/clients/client-codecommit/commands/GetRepositoryTriggersCommand.ts @@ -20,6 +20,9 @@ import { export type GetRepositoryTriggersCommandInput = GetRepositoryTriggersInput; export type GetRepositoryTriggersCommandOutput = GetRepositoryTriggersOutput & __MetadataBearer; +/** + *

Gets information about triggers configured for a repository.

+ */ export class GetRepositoryTriggersCommand extends $Command< GetRepositoryTriggersCommandInput, GetRepositoryTriggersCommandOutput, @@ -34,6 +37,9 @@ export class GetRepositoryTriggersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/ListApprovalRuleTemplatesCommand.ts b/clients/client-codecommit/commands/ListApprovalRuleTemplatesCommand.ts index 1046efc112b90..df9cddeaf8ad2 100644 --- a/clients/client-codecommit/commands/ListApprovalRuleTemplatesCommand.ts +++ b/clients/client-codecommit/commands/ListApprovalRuleTemplatesCommand.ts @@ -20,6 +20,10 @@ import { export type ListApprovalRuleTemplatesCommandInput = ListApprovalRuleTemplatesInput; export type ListApprovalRuleTemplatesCommandOutput = ListApprovalRuleTemplatesOutput & __MetadataBearer; +/** + *

Lists all approval rule templates in the specified AWS Region in your AWS account. If + * an AWS Region is not specified, the AWS Region where you are signed in is used.

+ */ export class ListApprovalRuleTemplatesCommand extends $Command< ListApprovalRuleTemplatesCommandInput, ListApprovalRuleTemplatesCommandOutput, @@ -34,6 +38,9 @@ export class ListApprovalRuleTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/ListAssociatedApprovalRuleTemplatesForRepositoryCommand.ts b/clients/client-codecommit/commands/ListAssociatedApprovalRuleTemplatesForRepositoryCommand.ts index 0c70bad975a6a..64753ec5ff4bc 100644 --- a/clients/client-codecommit/commands/ListAssociatedApprovalRuleTemplatesForRepositoryCommand.ts +++ b/clients/client-codecommit/commands/ListAssociatedApprovalRuleTemplatesForRepositoryCommand.ts @@ -24,6 +24,9 @@ export type ListAssociatedApprovalRuleTemplatesForRepositoryCommandInput = ListA export type ListAssociatedApprovalRuleTemplatesForRepositoryCommandOutput = ListAssociatedApprovalRuleTemplatesForRepositoryOutput & __MetadataBearer; +/** + *

Lists all approval rule templates that are associated with a specified repository.

+ */ export class ListAssociatedApprovalRuleTemplatesForRepositoryCommand extends $Command< ListAssociatedApprovalRuleTemplatesForRepositoryCommandInput, ListAssociatedApprovalRuleTemplatesForRepositoryCommandOutput, @@ -38,6 +41,9 @@ export class ListAssociatedApprovalRuleTemplatesForRepositoryCommand extends $Co // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/ListBranchesCommand.ts b/clients/client-codecommit/commands/ListBranchesCommand.ts index db9d926b16bea..fc5191f879eb5 100644 --- a/clients/client-codecommit/commands/ListBranchesCommand.ts +++ b/clients/client-codecommit/commands/ListBranchesCommand.ts @@ -20,6 +20,9 @@ import { export type ListBranchesCommandInput = ListBranchesInput; export type ListBranchesCommandOutput = ListBranchesOutput & __MetadataBearer; +/** + *

Gets information about one or more branches in a repository.

+ */ export class ListBranchesCommand extends $Command< ListBranchesCommandInput, ListBranchesCommandOutput, @@ -34,6 +37,9 @@ export class ListBranchesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/ListPullRequestsCommand.ts b/clients/client-codecommit/commands/ListPullRequestsCommand.ts index 51638eb5fa9cc..a2fffb26bc499 100644 --- a/clients/client-codecommit/commands/ListPullRequestsCommand.ts +++ b/clients/client-codecommit/commands/ListPullRequestsCommand.ts @@ -20,6 +20,10 @@ import { export type ListPullRequestsCommandInput = ListPullRequestsInput; export type ListPullRequestsCommandOutput = ListPullRequestsOutput & __MetadataBearer; +/** + *

Returns a list of pull requests for a specified repository. The return list can be refined by pull request + * status or pull request author ARN.

+ */ export class ListPullRequestsCommand extends $Command< ListPullRequestsCommandInput, ListPullRequestsCommandOutput, @@ -34,6 +38,9 @@ export class ListPullRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/ListRepositoriesCommand.ts b/clients/client-codecommit/commands/ListRepositoriesCommand.ts index 2d5b9320f19cd..41fe15cd2d4c3 100644 --- a/clients/client-codecommit/commands/ListRepositoriesCommand.ts +++ b/clients/client-codecommit/commands/ListRepositoriesCommand.ts @@ -20,6 +20,9 @@ import { export type ListRepositoriesCommandInput = ListRepositoriesInput; export type ListRepositoriesCommandOutput = ListRepositoriesOutput & __MetadataBearer; +/** + *

Gets information about one or more repositories.

+ */ export class ListRepositoriesCommand extends $Command< ListRepositoriesCommandInput, ListRepositoriesCommandOutput, @@ -34,6 +37,9 @@ export class ListRepositoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/ListRepositoriesForApprovalRuleTemplateCommand.ts b/clients/client-codecommit/commands/ListRepositoriesForApprovalRuleTemplateCommand.ts index 312ef8361bfbd..de0345f18d107 100644 --- a/clients/client-codecommit/commands/ListRepositoriesForApprovalRuleTemplateCommand.ts +++ b/clients/client-codecommit/commands/ListRepositoriesForApprovalRuleTemplateCommand.ts @@ -24,6 +24,9 @@ export type ListRepositoriesForApprovalRuleTemplateCommandInput = ListRepositori export type ListRepositoriesForApprovalRuleTemplateCommandOutput = ListRepositoriesForApprovalRuleTemplateOutput & __MetadataBearer; +/** + *

Lists all repositories associated with the specified approval rule template.

+ */ export class ListRepositoriesForApprovalRuleTemplateCommand extends $Command< ListRepositoriesForApprovalRuleTemplateCommandInput, ListRepositoriesForApprovalRuleTemplateCommandOutput, @@ -38,6 +41,9 @@ export class ListRepositoriesForApprovalRuleTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/ListTagsForResourceCommand.ts b/clients/client-codecommit/commands/ListTagsForResourceCommand.ts index f9bb6c2799cf3..3f76828b82d89 100644 --- a/clients/client-codecommit/commands/ListTagsForResourceCommand.ts +++ b/clients/client-codecommit/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Gets information about AWS tags for a specified Amazon Resource Name (ARN) in AWS + * CodeCommit. For a list of valid resources in AWS CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User + * Guide.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/MergeBranchesByFastForwardCommand.ts b/clients/client-codecommit/commands/MergeBranchesByFastForwardCommand.ts index 52bf0a2d45dfe..72527e785495c 100644 --- a/clients/client-codecommit/commands/MergeBranchesByFastForwardCommand.ts +++ b/clients/client-codecommit/commands/MergeBranchesByFastForwardCommand.ts @@ -20,6 +20,9 @@ import { export type MergeBranchesByFastForwardCommandInput = MergeBranchesByFastForwardInput; export type MergeBranchesByFastForwardCommandOutput = MergeBranchesByFastForwardOutput & __MetadataBearer; +/** + *

Merges two branches using the fast-forward merge strategy.

+ */ export class MergeBranchesByFastForwardCommand extends $Command< MergeBranchesByFastForwardCommandInput, MergeBranchesByFastForwardCommandOutput, @@ -34,6 +37,9 @@ export class MergeBranchesByFastForwardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/MergeBranchesBySquashCommand.ts b/clients/client-codecommit/commands/MergeBranchesBySquashCommand.ts index 3f25bb91796ad..a0c12a36fecbe 100644 --- a/clients/client-codecommit/commands/MergeBranchesBySquashCommand.ts +++ b/clients/client-codecommit/commands/MergeBranchesBySquashCommand.ts @@ -20,6 +20,9 @@ import { export type MergeBranchesBySquashCommandInput = MergeBranchesBySquashInput; export type MergeBranchesBySquashCommandOutput = MergeBranchesBySquashOutput & __MetadataBearer; +/** + *

Merges two branches using the squash merge strategy.

+ */ export class MergeBranchesBySquashCommand extends $Command< MergeBranchesBySquashCommandInput, MergeBranchesBySquashCommandOutput, @@ -34,6 +37,9 @@ export class MergeBranchesBySquashCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/MergeBranchesByThreeWayCommand.ts b/clients/client-codecommit/commands/MergeBranchesByThreeWayCommand.ts index f9a9bc553bc34..30c96b717f07f 100644 --- a/clients/client-codecommit/commands/MergeBranchesByThreeWayCommand.ts +++ b/clients/client-codecommit/commands/MergeBranchesByThreeWayCommand.ts @@ -20,6 +20,9 @@ import { export type MergeBranchesByThreeWayCommandInput = MergeBranchesByThreeWayInput; export type MergeBranchesByThreeWayCommandOutput = MergeBranchesByThreeWayOutput & __MetadataBearer; +/** + *

Merges two specified branches using the three-way merge strategy.

+ */ export class MergeBranchesByThreeWayCommand extends $Command< MergeBranchesByThreeWayCommandInput, MergeBranchesByThreeWayCommandOutput, @@ -34,6 +37,9 @@ export class MergeBranchesByThreeWayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/MergePullRequestByFastForwardCommand.ts b/clients/client-codecommit/commands/MergePullRequestByFastForwardCommand.ts index 2e860327e46a7..728b773fec253 100644 --- a/clients/client-codecommit/commands/MergePullRequestByFastForwardCommand.ts +++ b/clients/client-codecommit/commands/MergePullRequestByFastForwardCommand.ts @@ -20,6 +20,10 @@ import { export type MergePullRequestByFastForwardCommandInput = MergePullRequestByFastForwardInput; export type MergePullRequestByFastForwardCommandOutput = MergePullRequestByFastForwardOutput & __MetadataBearer; +/** + *

Attempts to merge the source commit of a pull request into the specified destination + * branch for that pull request at the specified commit using the fast-forward merge strategy. If the merge is successful, it closes the pull request.

+ */ export class MergePullRequestByFastForwardCommand extends $Command< MergePullRequestByFastForwardCommandInput, MergePullRequestByFastForwardCommandOutput, @@ -34,6 +38,9 @@ export class MergePullRequestByFastForwardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/MergePullRequestBySquashCommand.ts b/clients/client-codecommit/commands/MergePullRequestBySquashCommand.ts index d80e99695f42a..b86673360ce80 100644 --- a/clients/client-codecommit/commands/MergePullRequestBySquashCommand.ts +++ b/clients/client-codecommit/commands/MergePullRequestBySquashCommand.ts @@ -20,6 +20,10 @@ import { export type MergePullRequestBySquashCommandInput = MergePullRequestBySquashInput; export type MergePullRequestBySquashCommandOutput = MergePullRequestBySquashOutput & __MetadataBearer; +/** + *

Attempts to merge the source commit of a pull request into the specified destination + * branch for that pull request at the specified commit using the squash merge strategy. If the merge is successful, it closes the pull request.

+ */ export class MergePullRequestBySquashCommand extends $Command< MergePullRequestBySquashCommandInput, MergePullRequestBySquashCommandOutput, @@ -34,6 +38,9 @@ export class MergePullRequestBySquashCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/MergePullRequestByThreeWayCommand.ts b/clients/client-codecommit/commands/MergePullRequestByThreeWayCommand.ts index 9a8f672de8e2f..bcd7ab0fb7d7c 100644 --- a/clients/client-codecommit/commands/MergePullRequestByThreeWayCommand.ts +++ b/clients/client-codecommit/commands/MergePullRequestByThreeWayCommand.ts @@ -20,6 +20,10 @@ import { export type MergePullRequestByThreeWayCommandInput = MergePullRequestByThreeWayInput; export type MergePullRequestByThreeWayCommandOutput = MergePullRequestByThreeWayOutput & __MetadataBearer; +/** + *

Attempts to merge the source commit of a pull request into the specified destination + * branch for that pull request at the specified commit using the three-way merge strategy. If the merge is successful, it closes the pull request.

+ */ export class MergePullRequestByThreeWayCommand extends $Command< MergePullRequestByThreeWayCommandInput, MergePullRequestByThreeWayCommandOutput, @@ -34,6 +38,9 @@ export class MergePullRequestByThreeWayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/OverridePullRequestApprovalRulesCommand.ts b/clients/client-codecommit/commands/OverridePullRequestApprovalRulesCommand.ts index e855cd07c5eac..e46f8965bd62f 100644 --- a/clients/client-codecommit/commands/OverridePullRequestApprovalRulesCommand.ts +++ b/clients/client-codecommit/commands/OverridePullRequestApprovalRulesCommand.ts @@ -20,6 +20,9 @@ import { export type OverridePullRequestApprovalRulesCommandInput = OverridePullRequestApprovalRulesInput; export type OverridePullRequestApprovalRulesCommandOutput = __MetadataBearer; +/** + *

Sets aside (overrides) all approval rule requirements for a specified pull request.

+ */ export class OverridePullRequestApprovalRulesCommand extends $Command< OverridePullRequestApprovalRulesCommandInput, OverridePullRequestApprovalRulesCommandOutput, @@ -34,6 +37,9 @@ export class OverridePullRequestApprovalRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/PostCommentForComparedCommitCommand.ts b/clients/client-codecommit/commands/PostCommentForComparedCommitCommand.ts index 301f2077362f1..7af4ae70cd059 100644 --- a/clients/client-codecommit/commands/PostCommentForComparedCommitCommand.ts +++ b/clients/client-codecommit/commands/PostCommentForComparedCommitCommand.ts @@ -20,6 +20,9 @@ import { export type PostCommentForComparedCommitCommandInput = PostCommentForComparedCommitInput; export type PostCommentForComparedCommitCommandOutput = PostCommentForComparedCommitOutput & __MetadataBearer; +/** + *

Posts a comment on the comparison between two commits.

+ */ export class PostCommentForComparedCommitCommand extends $Command< PostCommentForComparedCommitCommandInput, PostCommentForComparedCommitCommandOutput, @@ -34,6 +37,9 @@ export class PostCommentForComparedCommitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/PostCommentForPullRequestCommand.ts b/clients/client-codecommit/commands/PostCommentForPullRequestCommand.ts index fb17e5253f620..444dcff855dd8 100644 --- a/clients/client-codecommit/commands/PostCommentForPullRequestCommand.ts +++ b/clients/client-codecommit/commands/PostCommentForPullRequestCommand.ts @@ -20,6 +20,9 @@ import { export type PostCommentForPullRequestCommandInput = PostCommentForPullRequestInput; export type PostCommentForPullRequestCommandOutput = PostCommentForPullRequestOutput & __MetadataBearer; +/** + *

Posts a comment on a pull request.

+ */ export class PostCommentForPullRequestCommand extends $Command< PostCommentForPullRequestCommandInput, PostCommentForPullRequestCommandOutput, @@ -34,6 +37,9 @@ export class PostCommentForPullRequestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/PostCommentReplyCommand.ts b/clients/client-codecommit/commands/PostCommentReplyCommand.ts index 09901f9e4aa13..b15f2890b0972 100644 --- a/clients/client-codecommit/commands/PostCommentReplyCommand.ts +++ b/clients/client-codecommit/commands/PostCommentReplyCommand.ts @@ -20,6 +20,9 @@ import { export type PostCommentReplyCommandInput = PostCommentReplyInput; export type PostCommentReplyCommandOutput = PostCommentReplyOutput & __MetadataBearer; +/** + *

Posts a comment in reply to an existing comment on a comparison between commits or a pull request.

+ */ export class PostCommentReplyCommand extends $Command< PostCommentReplyCommandInput, PostCommentReplyCommandOutput, @@ -34,6 +37,9 @@ export class PostCommentReplyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/PutCommentReactionCommand.ts b/clients/client-codecommit/commands/PutCommentReactionCommand.ts index 4ab93e4909eff..5923e6ca0fe01 100644 --- a/clients/client-codecommit/commands/PutCommentReactionCommand.ts +++ b/clients/client-codecommit/commands/PutCommentReactionCommand.ts @@ -20,6 +20,10 @@ import { export type PutCommentReactionCommandInput = PutCommentReactionInput; export type PutCommentReactionCommandOutput = __MetadataBearer; +/** + *

Adds or updates a reaction to a specified comment for the user whose identity is used to make the request. You can only add or + * update a reaction for yourself. You cannot add, modify, or delete a reaction for another user.

+ */ export class PutCommentReactionCommand extends $Command< PutCommentReactionCommandInput, PutCommentReactionCommandOutput, @@ -34,6 +38,9 @@ export class PutCommentReactionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/PutFileCommand.ts b/clients/client-codecommit/commands/PutFileCommand.ts index c86c7a5377f9a..f1c9ecf573ca5 100644 --- a/clients/client-codecommit/commands/PutFileCommand.ts +++ b/clients/client-codecommit/commands/PutFileCommand.ts @@ -17,6 +17,9 @@ import { export type PutFileCommandInput = PutFileInput; export type PutFileCommandOutput = PutFileOutput & __MetadataBearer; +/** + *

Adds or updates a file in a branch in an AWS CodeCommit repository, and generates a commit for the addition in the specified branch.

+ */ export class PutFileCommand extends $Command< PutFileCommandInput, PutFileCommandOutput, @@ -31,6 +34,9 @@ export class PutFileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/PutRepositoryTriggersCommand.ts b/clients/client-codecommit/commands/PutRepositoryTriggersCommand.ts index ce272afe31e53..8a92c0d1556e5 100644 --- a/clients/client-codecommit/commands/PutRepositoryTriggersCommand.ts +++ b/clients/client-codecommit/commands/PutRepositoryTriggersCommand.ts @@ -20,6 +20,9 @@ import { export type PutRepositoryTriggersCommandInput = PutRepositoryTriggersInput; export type PutRepositoryTriggersCommandOutput = PutRepositoryTriggersOutput & __MetadataBearer; +/** + *

Replaces all triggers for a repository. Used to create or delete triggers.

+ */ export class PutRepositoryTriggersCommand extends $Command< PutRepositoryTriggersCommandInput, PutRepositoryTriggersCommandOutput, @@ -34,6 +37,9 @@ export class PutRepositoryTriggersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/TagResourceCommand.ts b/clients/client-codecommit/commands/TagResourceCommand.ts index e5104eb105785..f9d249b832ff0 100644 --- a/clients/client-codecommit/commands/TagResourceCommand.ts +++ b/clients/client-codecommit/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds or updates tags for a resource in AWS CodeCommit. For a list of valid resources + * in AWS CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User + * Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/TestRepositoryTriggersCommand.ts b/clients/client-codecommit/commands/TestRepositoryTriggersCommand.ts index 743d12db295ef..0db7309a999f9 100644 --- a/clients/client-codecommit/commands/TestRepositoryTriggersCommand.ts +++ b/clients/client-codecommit/commands/TestRepositoryTriggersCommand.ts @@ -20,6 +20,11 @@ import { export type TestRepositoryTriggersCommandInput = TestRepositoryTriggersInput; export type TestRepositoryTriggersCommandOutput = TestRepositoryTriggersOutput & __MetadataBearer; +/** + *

Tests the functionality of repository triggers by sending information to the trigger + * target. If real data is available in the repository, the test sends data from the last + * commit. If no data is available, sample data is generated.

+ */ export class TestRepositoryTriggersCommand extends $Command< TestRepositoryTriggersCommandInput, TestRepositoryTriggersCommandOutput, @@ -34,6 +39,9 @@ export class TestRepositoryTriggersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UntagResourceCommand.ts b/clients/client-codecommit/commands/UntagResourceCommand.ts index 315d35499b204..dfcd47d0843cb 100644 --- a/clients/client-codecommit/commands/UntagResourceCommand.ts +++ b/clients/client-codecommit/commands/UntagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes tags for a resource in AWS CodeCommit. For a list of valid resources in AWS + * CodeCommit, see CodeCommit Resources and Operations in the AWS CodeCommit User + * Guide.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdateApprovalRuleTemplateContentCommand.ts b/clients/client-codecommit/commands/UpdateApprovalRuleTemplateContentCommand.ts index e54fcd41a40d6..3b5b5dc939152 100644 --- a/clients/client-codecommit/commands/UpdateApprovalRuleTemplateContentCommand.ts +++ b/clients/client-codecommit/commands/UpdateApprovalRuleTemplateContentCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateApprovalRuleTemplateContentCommandInput = UpdateApprovalRuleTemplateContentInput; export type UpdateApprovalRuleTemplateContentCommandOutput = UpdateApprovalRuleTemplateContentOutput & __MetadataBearer; +/** + *

Updates the content of an approval rule template. You can change the number of + * required approvals, the membership of the approval rule, and whether an approval pool is + * defined.

+ */ export class UpdateApprovalRuleTemplateContentCommand extends $Command< UpdateApprovalRuleTemplateContentCommandInput, UpdateApprovalRuleTemplateContentCommandOutput, @@ -34,6 +39,9 @@ export class UpdateApprovalRuleTemplateContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdateApprovalRuleTemplateDescriptionCommand.ts b/clients/client-codecommit/commands/UpdateApprovalRuleTemplateDescriptionCommand.ts index 71628c4a1710b..1e5277f9fa52f 100644 --- a/clients/client-codecommit/commands/UpdateApprovalRuleTemplateDescriptionCommand.ts +++ b/clients/client-codecommit/commands/UpdateApprovalRuleTemplateDescriptionCommand.ts @@ -24,6 +24,9 @@ export type UpdateApprovalRuleTemplateDescriptionCommandInput = UpdateApprovalRu export type UpdateApprovalRuleTemplateDescriptionCommandOutput = UpdateApprovalRuleTemplateDescriptionOutput & __MetadataBearer; +/** + *

Updates the description for a specified approval rule template.

+ */ export class UpdateApprovalRuleTemplateDescriptionCommand extends $Command< UpdateApprovalRuleTemplateDescriptionCommandInput, UpdateApprovalRuleTemplateDescriptionCommandOutput, @@ -38,6 +41,9 @@ export class UpdateApprovalRuleTemplateDescriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdateApprovalRuleTemplateNameCommand.ts b/clients/client-codecommit/commands/UpdateApprovalRuleTemplateNameCommand.ts index b16b391dfa9e4..25991925b55cd 100644 --- a/clients/client-codecommit/commands/UpdateApprovalRuleTemplateNameCommand.ts +++ b/clients/client-codecommit/commands/UpdateApprovalRuleTemplateNameCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApprovalRuleTemplateNameCommandInput = UpdateApprovalRuleTemplateNameInput; export type UpdateApprovalRuleTemplateNameCommandOutput = UpdateApprovalRuleTemplateNameOutput & __MetadataBearer; +/** + *

Updates the name of a specified approval rule template.

+ */ export class UpdateApprovalRuleTemplateNameCommand extends $Command< UpdateApprovalRuleTemplateNameCommandInput, UpdateApprovalRuleTemplateNameCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApprovalRuleTemplateNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdateCommentCommand.ts b/clients/client-codecommit/commands/UpdateCommentCommand.ts index 9066511a0ed43..9c34e1fb4db05 100644 --- a/clients/client-codecommit/commands/UpdateCommentCommand.ts +++ b/clients/client-codecommit/commands/UpdateCommentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateCommentCommandInput = UpdateCommentInput; export type UpdateCommentCommandOutput = UpdateCommentOutput & __MetadataBearer; +/** + *

Replaces the contents of a comment.

+ */ export class UpdateCommentCommand extends $Command< UpdateCommentCommandInput, UpdateCommentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateCommentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdateDefaultBranchCommand.ts b/clients/client-codecommit/commands/UpdateDefaultBranchCommand.ts index fca1a1675cbf9..f5f57a7b3aeba 100644 --- a/clients/client-codecommit/commands/UpdateDefaultBranchCommand.ts +++ b/clients/client-codecommit/commands/UpdateDefaultBranchCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateDefaultBranchCommandInput = UpdateDefaultBranchInput; export type UpdateDefaultBranchCommandOutput = __MetadataBearer; +/** + *

Sets or changes the default branch name for the specified repository.

+ * + *

If you use this operation to change the default branch name to the current default branch name, a success message is returned even though the default branch did not change.

+ *
+ */ export class UpdateDefaultBranchCommand extends $Command< UpdateDefaultBranchCommandInput, UpdateDefaultBranchCommandOutput, @@ -34,6 +40,9 @@ export class UpdateDefaultBranchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdatePullRequestApprovalRuleContentCommand.ts b/clients/client-codecommit/commands/UpdatePullRequestApprovalRuleContentCommand.ts index eb27de253b85e..7352571890ea8 100644 --- a/clients/client-codecommit/commands/UpdatePullRequestApprovalRuleContentCommand.ts +++ b/clients/client-codecommit/commands/UpdatePullRequestApprovalRuleContentCommand.ts @@ -24,6 +24,10 @@ export type UpdatePullRequestApprovalRuleContentCommandInput = UpdatePullRequest export type UpdatePullRequestApprovalRuleContentCommandOutput = UpdatePullRequestApprovalRuleContentOutput & __MetadataBearer; +/** + *

Updates the structure of an approval rule created specifically for a pull request. For example, you can change the number of required approvers and + * the approval pool for approvers.

+ */ export class UpdatePullRequestApprovalRuleContentCommand extends $Command< UpdatePullRequestApprovalRuleContentCommandInput, UpdatePullRequestApprovalRuleContentCommandOutput, @@ -38,6 +42,9 @@ export class UpdatePullRequestApprovalRuleContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdatePullRequestApprovalStateCommand.ts b/clients/client-codecommit/commands/UpdatePullRequestApprovalStateCommand.ts index a6d13e9274221..5388a452090a0 100644 --- a/clients/client-codecommit/commands/UpdatePullRequestApprovalStateCommand.ts +++ b/clients/client-codecommit/commands/UpdatePullRequestApprovalStateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePullRequestApprovalStateCommandInput = UpdatePullRequestApprovalStateInput; export type UpdatePullRequestApprovalStateCommandOutput = __MetadataBearer; +/** + *

Updates the state of a user's approval on a pull request. The user is derived from the signed-in account when the request is made.

+ */ export class UpdatePullRequestApprovalStateCommand extends $Command< UpdatePullRequestApprovalStateCommandInput, UpdatePullRequestApprovalStateCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePullRequestApprovalStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdatePullRequestDescriptionCommand.ts b/clients/client-codecommit/commands/UpdatePullRequestDescriptionCommand.ts index e0a6d9ce5a70a..03953a33841b5 100644 --- a/clients/client-codecommit/commands/UpdatePullRequestDescriptionCommand.ts +++ b/clients/client-codecommit/commands/UpdatePullRequestDescriptionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePullRequestDescriptionCommandInput = UpdatePullRequestDescriptionInput; export type UpdatePullRequestDescriptionCommandOutput = UpdatePullRequestDescriptionOutput & __MetadataBearer; +/** + *

Replaces the contents of the description of a pull request.

+ */ export class UpdatePullRequestDescriptionCommand extends $Command< UpdatePullRequestDescriptionCommandInput, UpdatePullRequestDescriptionCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePullRequestDescriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdatePullRequestStatusCommand.ts b/clients/client-codecommit/commands/UpdatePullRequestStatusCommand.ts index aff3a2b5dbf15..68a26fe659a7d 100644 --- a/clients/client-codecommit/commands/UpdatePullRequestStatusCommand.ts +++ b/clients/client-codecommit/commands/UpdatePullRequestStatusCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePullRequestStatusCommandInput = UpdatePullRequestStatusInput; export type UpdatePullRequestStatusCommandOutput = UpdatePullRequestStatusOutput & __MetadataBearer; +/** + *

Updates the status of a pull request.

+ */ export class UpdatePullRequestStatusCommand extends $Command< UpdatePullRequestStatusCommandInput, UpdatePullRequestStatusCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePullRequestStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdatePullRequestTitleCommand.ts b/clients/client-codecommit/commands/UpdatePullRequestTitleCommand.ts index 98d5b59e03488..892c0896928a9 100644 --- a/clients/client-codecommit/commands/UpdatePullRequestTitleCommand.ts +++ b/clients/client-codecommit/commands/UpdatePullRequestTitleCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePullRequestTitleCommandInput = UpdatePullRequestTitleInput; export type UpdatePullRequestTitleCommandOutput = UpdatePullRequestTitleOutput & __MetadataBearer; +/** + *

Replaces the title of a pull request.

+ */ export class UpdatePullRequestTitleCommand extends $Command< UpdatePullRequestTitleCommandInput, UpdatePullRequestTitleCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePullRequestTitleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdateRepositoryDescriptionCommand.ts b/clients/client-codecommit/commands/UpdateRepositoryDescriptionCommand.ts index 176f77af72501..a45309cbd82c5 100644 --- a/clients/client-codecommit/commands/UpdateRepositoryDescriptionCommand.ts +++ b/clients/client-codecommit/commands/UpdateRepositoryDescriptionCommand.ts @@ -20,6 +20,16 @@ import { export type UpdateRepositoryDescriptionCommandInput = UpdateRepositoryDescriptionInput; export type UpdateRepositoryDescriptionCommandOutput = __MetadataBearer; +/** + *

Sets or changes the comment or description for a repository.

+ * + *

The description field for a repository accepts all HTML characters and all valid + * Unicode characters. Applications that do not HTML-encode the description and display + * it in a webpage can expose users to potentially malicious code. Make sure that you + * HTML-encode the description field in any application that uses this API to display + * the repository description on a webpage.

+ *
+ */ export class UpdateRepositoryDescriptionCommand extends $Command< UpdateRepositoryDescriptionCommandInput, UpdateRepositoryDescriptionCommandOutput, @@ -34,6 +44,9 @@ export class UpdateRepositoryDescriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/commands/UpdateRepositoryNameCommand.ts b/clients/client-codecommit/commands/UpdateRepositoryNameCommand.ts index 54cda0417ad2b..0f2b97a8b6b33 100644 --- a/clients/client-codecommit/commands/UpdateRepositoryNameCommand.ts +++ b/clients/client-codecommit/commands/UpdateRepositoryNameCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateRepositoryNameCommandInput = UpdateRepositoryNameInput; export type UpdateRepositoryNameCommandOutput = __MetadataBearer; +/** + *

Renames a repository. The repository name must be unique across the calling AWS + * account. Repository names are limited to 100 alphanumeric, dash, and underscore + * characters, and cannot include certain characters. The suffix .git is prohibited. For + * more information about the limits on repository names, see Limits in the AWS CodeCommit + * User Guide.

+ */ export class UpdateRepositoryNameCommand extends $Command< UpdateRepositoryNameCommandInput, UpdateRepositoryNameCommandOutput, @@ -34,6 +41,9 @@ export class UpdateRepositoryNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeCommitClientResolvedConfig, diff --git a/clients/client-codecommit/package.json b/clients/client-codecommit/package.json index b4874f3e5f6f0..06a3390794d92 100644 --- a/clients/client-codecommit/package.json +++ b/clients/client-codecommit/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codecommit Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codecommit/pagination/DescribeMergeConflictsPaginator.ts b/clients/client-codecommit/pagination/DescribeMergeConflictsPaginator.ts index 13448943e3501..7a3cf0ba54469 100644 --- a/clients/client-codecommit/pagination/DescribeMergeConflictsPaginator.ts +++ b/clients/client-codecommit/pagination/DescribeMergeConflictsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: DescribeMergeConflictsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMergeConflictsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: DescribeMergeConflictsCommandInput, diff --git a/clients/client-codecommit/pagination/DescribePullRequestEventsPaginator.ts b/clients/client-codecommit/pagination/DescribePullRequestEventsPaginator.ts index 2226044fe10d3..7d81d4e6c8470 100644 --- a/clients/client-codecommit/pagination/DescribePullRequestEventsPaginator.ts +++ b/clients/client-codecommit/pagination/DescribePullRequestEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: DescribePullRequestEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePullRequestEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: DescribePullRequestEventsCommandInput, diff --git a/clients/client-codecommit/pagination/GetCommentReactionsPaginator.ts b/clients/client-codecommit/pagination/GetCommentReactionsPaginator.ts index e5f70e5e61f69..2c8ce514c1130 100644 --- a/clients/client-codecommit/pagination/GetCommentReactionsPaginator.ts +++ b/clients/client-codecommit/pagination/GetCommentReactionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: GetCommentReactionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCommentReactionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: GetCommentReactionsCommandInput, diff --git a/clients/client-codecommit/pagination/GetCommentsForComparedCommitPaginator.ts b/clients/client-codecommit/pagination/GetCommentsForComparedCommitPaginator.ts index 29885cb339958..25b52e06d6690 100644 --- a/clients/client-codecommit/pagination/GetCommentsForComparedCommitPaginator.ts +++ b/clients/client-codecommit/pagination/GetCommentsForComparedCommitPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: GetCommentsForComparedCommitCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCommentsForComparedCommitCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: GetCommentsForComparedCommitCommandInput, diff --git a/clients/client-codecommit/pagination/GetCommentsForPullRequestPaginator.ts b/clients/client-codecommit/pagination/GetCommentsForPullRequestPaginator.ts index 6710feaf812b8..c4251dc2cdcbe 100644 --- a/clients/client-codecommit/pagination/GetCommentsForPullRequestPaginator.ts +++ b/clients/client-codecommit/pagination/GetCommentsForPullRequestPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: GetCommentsForPullRequestCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCommentsForPullRequestCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: GetCommentsForPullRequestCommandInput, diff --git a/clients/client-codecommit/pagination/GetDifferencesPaginator.ts b/clients/client-codecommit/pagination/GetDifferencesPaginator.ts index f04ffe509c964..0ff0d15e38009 100644 --- a/clients/client-codecommit/pagination/GetDifferencesPaginator.ts +++ b/clients/client-codecommit/pagination/GetDifferencesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: GetDifferencesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDifferencesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: GetDifferencesCommandInput, diff --git a/clients/client-codecommit/pagination/GetMergeConflictsPaginator.ts b/clients/client-codecommit/pagination/GetMergeConflictsPaginator.ts index 4aec222ff925d..b3e7db4c75f58 100644 --- a/clients/client-codecommit/pagination/GetMergeConflictsPaginator.ts +++ b/clients/client-codecommit/pagination/GetMergeConflictsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: GetMergeConflictsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetMergeConflictsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: GetMergeConflictsCommandInput, diff --git a/clients/client-codecommit/pagination/ListApprovalRuleTemplatesPaginator.ts b/clients/client-codecommit/pagination/ListApprovalRuleTemplatesPaginator.ts index 8a5fff705c828..d8b00e0d7f77b 100644 --- a/clients/client-codecommit/pagination/ListApprovalRuleTemplatesPaginator.ts +++ b/clients/client-codecommit/pagination/ListApprovalRuleTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: ListApprovalRuleTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApprovalRuleTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: ListApprovalRuleTemplatesCommandInput, diff --git a/clients/client-codecommit/pagination/ListAssociatedApprovalRuleTemplatesForRepositoryPaginator.ts b/clients/client-codecommit/pagination/ListAssociatedApprovalRuleTemplatesForRepositoryPaginator.ts index 3db727340c4e5..59f1e14f1901f 100644 --- a/clients/client-codecommit/pagination/ListAssociatedApprovalRuleTemplatesForRepositoryPaginator.ts +++ b/clients/client-codecommit/pagination/ListAssociatedApprovalRuleTemplatesForRepositoryPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: ListAssociatedApprovalRuleTemplatesForRepositoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssociatedApprovalRuleTemplatesForRepositoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: ListAssociatedApprovalRuleTemplatesForRepositoryCommandInput, diff --git a/clients/client-codecommit/pagination/ListBranchesPaginator.ts b/clients/client-codecommit/pagination/ListBranchesPaginator.ts index 3a38ab5972463..91ea3a8ff1136 100644 --- a/clients/client-codecommit/pagination/ListBranchesPaginator.ts +++ b/clients/client-codecommit/pagination/ListBranchesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: ListBranchesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBranchesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: ListBranchesCommandInput, diff --git a/clients/client-codecommit/pagination/ListPullRequestsPaginator.ts b/clients/client-codecommit/pagination/ListPullRequestsPaginator.ts index b3a4918f2c5e5..72d0c55152336 100644 --- a/clients/client-codecommit/pagination/ListPullRequestsPaginator.ts +++ b/clients/client-codecommit/pagination/ListPullRequestsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: ListPullRequestsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPullRequestsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: ListPullRequestsCommandInput, diff --git a/clients/client-codecommit/pagination/ListRepositoriesForApprovalRuleTemplatePaginator.ts b/clients/client-codecommit/pagination/ListRepositoriesForApprovalRuleTemplatePaginator.ts index 23889cda199e3..1877f84bbb6c0 100644 --- a/clients/client-codecommit/pagination/ListRepositoriesForApprovalRuleTemplatePaginator.ts +++ b/clients/client-codecommit/pagination/ListRepositoriesForApprovalRuleTemplatePaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: ListRepositoriesForApprovalRuleTemplateCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRepositoriesForApprovalRuleTemplateCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: ListRepositoriesForApprovalRuleTemplateCommandInput, diff --git a/clients/client-codecommit/pagination/ListRepositoriesPaginator.ts b/clients/client-codecommit/pagination/ListRepositoriesPaginator.ts index e5ee7f6addd77..f94b2f1a1f9ca 100644 --- a/clients/client-codecommit/pagination/ListRepositoriesPaginator.ts +++ b/clients/client-codecommit/pagination/ListRepositoriesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeCommitPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeCommitClient, input: ListRepositoriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRepositoriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeCommit, input: ListRepositoriesCommandInput, diff --git a/clients/client-codecommit/runtimeConfig.browser.ts b/clients/client-codecommit/runtimeConfig.browser.ts index 27dc9de6fc6ac..903fe4577f88c 100644 --- a/clients/client-codecommit/runtimeConfig.browser.ts +++ b/clients/client-codecommit/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodeCommitClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codecommit/runtimeConfig.native.ts b/clients/client-codecommit/runtimeConfig.native.ts index 0f30b615c7f5b..22af34073883e 100644 --- a/clients/client-codecommit/runtimeConfig.native.ts +++ b/clients/client-codecommit/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodeCommitClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codecommit/runtimeConfig.shared.ts b/clients/client-codecommit/runtimeConfig.shared.ts index 668b2d74776fe..2ba0fc8acb31d 100644 --- a/clients/client-codecommit/runtimeConfig.shared.ts +++ b/clients/client-codecommit/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-04-13", disableHostPrefix: false, diff --git a/clients/client-codecommit/runtimeConfig.ts b/clients/client-codecommit/runtimeConfig.ts index ebed9a0183873..67f897187efd8 100644 --- a/clients/client-codecommit/runtimeConfig.ts +++ b/clients/client-codecommit/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodeCommitClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codecommit/tsconfig.json b/clients/client-codecommit/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codecommit/tsconfig.json +++ b/clients/client-codecommit/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codedeploy/commands/AddTagsToOnPremisesInstancesCommand.ts b/clients/client-codedeploy/commands/AddTagsToOnPremisesInstancesCommand.ts index ae61bfba74ee2..debdfd56367e4 100644 --- a/clients/client-codedeploy/commands/AddTagsToOnPremisesInstancesCommand.ts +++ b/clients/client-codedeploy/commands/AddTagsToOnPremisesInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type AddTagsToOnPremisesInstancesCommandInput = AddTagsToOnPremisesInstancesInput; export type AddTagsToOnPremisesInstancesCommandOutput = __MetadataBearer; +/** + *

Adds tags to on-premises instances.

+ */ export class AddTagsToOnPremisesInstancesCommand extends $Command< AddTagsToOnPremisesInstancesCommandInput, AddTagsToOnPremisesInstancesCommandOutput, @@ -34,6 +37,9 @@ export class AddTagsToOnPremisesInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/BatchGetApplicationRevisionsCommand.ts b/clients/client-codedeploy/commands/BatchGetApplicationRevisionsCommand.ts index 16e0c5203346f..4d4d0468381b6 100644 --- a/clients/client-codedeploy/commands/BatchGetApplicationRevisionsCommand.ts +++ b/clients/client-codedeploy/commands/BatchGetApplicationRevisionsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetApplicationRevisionsCommandInput = BatchGetApplicationRevisionsInput; export type BatchGetApplicationRevisionsCommandOutput = BatchGetApplicationRevisionsOutput & __MetadataBearer; +/** + *

Gets information about one or more application revisions. The maximum number of application revisions that can be returned is 25.

+ */ export class BatchGetApplicationRevisionsCommand extends $Command< BatchGetApplicationRevisionsCommandInput, BatchGetApplicationRevisionsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetApplicationRevisionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/BatchGetApplicationsCommand.ts b/clients/client-codedeploy/commands/BatchGetApplicationsCommand.ts index 7f42aacde67f4..2e38a961c318d 100644 --- a/clients/client-codedeploy/commands/BatchGetApplicationsCommand.ts +++ b/clients/client-codedeploy/commands/BatchGetApplicationsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetApplicationsCommandInput = BatchGetApplicationsInput; export type BatchGetApplicationsCommandOutput = BatchGetApplicationsOutput & __MetadataBearer; +/** + *

Gets information about one or more applications. The maximum number of applications that can be returned is 100.

+ */ export class BatchGetApplicationsCommand extends $Command< BatchGetApplicationsCommandInput, BatchGetApplicationsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/BatchGetDeploymentGroupsCommand.ts b/clients/client-codedeploy/commands/BatchGetDeploymentGroupsCommand.ts index ee3350894a980..7b888d7fc1a0d 100644 --- a/clients/client-codedeploy/commands/BatchGetDeploymentGroupsCommand.ts +++ b/clients/client-codedeploy/commands/BatchGetDeploymentGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetDeploymentGroupsCommandInput = BatchGetDeploymentGroupsInput; export type BatchGetDeploymentGroupsCommandOutput = BatchGetDeploymentGroupsOutput & __MetadataBearer; +/** + *

Gets information about one or more deployment groups.

+ */ export class BatchGetDeploymentGroupsCommand extends $Command< BatchGetDeploymentGroupsCommandInput, BatchGetDeploymentGroupsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetDeploymentGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/BatchGetDeploymentInstancesCommand.ts b/clients/client-codedeploy/commands/BatchGetDeploymentInstancesCommand.ts index 9f5c72642929e..91cb4fadc71a3 100644 --- a/clients/client-codedeploy/commands/BatchGetDeploymentInstancesCommand.ts +++ b/clients/client-codedeploy/commands/BatchGetDeploymentInstancesCommand.ts @@ -20,6 +20,16 @@ import { export type BatchGetDeploymentInstancesCommandInput = BatchGetDeploymentInstancesInput; export type BatchGetDeploymentInstancesCommandOutput = BatchGetDeploymentInstancesOutput & __MetadataBearer; +/** + * + *

This method works, but is deprecated. Use BatchGetDeploymentTargets + * instead.

+ *
+ *

Returns an array of one or more instances associated with a deployment. This method works with + * EC2/On-premises and AWS Lambda compute platforms. The newer + * BatchGetDeploymentTargets works with all compute platforms. + * The maximum number of instances that can be returned is 25.

+ */ export class BatchGetDeploymentInstancesCommand extends $Command< BatchGetDeploymentInstancesCommandInput, BatchGetDeploymentInstancesCommandOutput, @@ -34,6 +44,9 @@ export class BatchGetDeploymentInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/BatchGetDeploymentTargetsCommand.ts b/clients/client-codedeploy/commands/BatchGetDeploymentTargetsCommand.ts index 9715bc6bee9ce..767b112f57a4d 100644 --- a/clients/client-codedeploy/commands/BatchGetDeploymentTargetsCommand.ts +++ b/clients/client-codedeploy/commands/BatchGetDeploymentTargetsCommand.ts @@ -20,6 +20,35 @@ import { export type BatchGetDeploymentTargetsCommandInput = BatchGetDeploymentTargetsInput; export type BatchGetDeploymentTargetsCommandOutput = BatchGetDeploymentTargetsOutput & __MetadataBearer; +/** + *

Returns an array of one or more targets associated with a deployment. This method works with all + * compute types and should be used instead of the deprecated + * BatchGetDeploymentInstances. + * The maximum number of targets that can be returned is 25.

+ *

The type of targets returned depends on the deployment's compute platform or deployment method:

+ *
    + *
  • + *

    + * EC2/On-premises: Information about EC2 instance + * targets.

    + *
  • + *
  • + *

    + * AWS Lambda: Information about Lambda functions + * targets.

    + *
  • + *
  • + *

    + * Amazon ECS: Information about Amazon ECS + * service targets.

    + *
  • + *
  • + *

    + * CloudFormation: Information about targets of + * blue/green deployments initiated by a CloudFormation stack update.

    + *
  • + *
+ */ export class BatchGetDeploymentTargetsCommand extends $Command< BatchGetDeploymentTargetsCommandInput, BatchGetDeploymentTargetsCommandOutput, @@ -34,6 +63,9 @@ export class BatchGetDeploymentTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/BatchGetDeploymentsCommand.ts b/clients/client-codedeploy/commands/BatchGetDeploymentsCommand.ts index 93f94d7f1e55e..81bd429d83fa5 100644 --- a/clients/client-codedeploy/commands/BatchGetDeploymentsCommand.ts +++ b/clients/client-codedeploy/commands/BatchGetDeploymentsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetDeploymentsCommandInput = BatchGetDeploymentsInput; export type BatchGetDeploymentsCommandOutput = BatchGetDeploymentsOutput & __MetadataBearer; +/** + *

Gets information about one or more deployments. The maximum number of deployments that can be returned is 25.

+ */ export class BatchGetDeploymentsCommand extends $Command< BatchGetDeploymentsCommandInput, BatchGetDeploymentsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/BatchGetOnPremisesInstancesCommand.ts b/clients/client-codedeploy/commands/BatchGetOnPremisesInstancesCommand.ts index 4ef538c058b37..f1d1497410a67 100644 --- a/clients/client-codedeploy/commands/BatchGetOnPremisesInstancesCommand.ts +++ b/clients/client-codedeploy/commands/BatchGetOnPremisesInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetOnPremisesInstancesCommandInput = BatchGetOnPremisesInstancesInput; export type BatchGetOnPremisesInstancesCommandOutput = BatchGetOnPremisesInstancesOutput & __MetadataBearer; +/** + *

Gets information about one or more on-premises instances. The maximum number of on-premises instances that can be returned is 25.

+ */ export class BatchGetOnPremisesInstancesCommand extends $Command< BatchGetOnPremisesInstancesCommandInput, BatchGetOnPremisesInstancesCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetOnPremisesInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ContinueDeploymentCommand.ts b/clients/client-codedeploy/commands/ContinueDeploymentCommand.ts index 95b7fcac38797..36281fd630eef 100644 --- a/clients/client-codedeploy/commands/ContinueDeploymentCommand.ts +++ b/clients/client-codedeploy/commands/ContinueDeploymentCommand.ts @@ -20,6 +20,13 @@ import { export type ContinueDeploymentCommandInput = ContinueDeploymentInput; export type ContinueDeploymentCommandOutput = __MetadataBearer; +/** + *

For a blue/green deployment, starts the process of rerouting traffic from instances in + * the original environment to instances in the replacement environment without waiting for + * a specified wait time to elapse. (Traffic rerouting, which is achieved by registering + * instances in the replacement environment with the load balancer, can start as soon as + * all instances have a status of Ready.)

+ */ export class ContinueDeploymentCommand extends $Command< ContinueDeploymentCommandInput, ContinueDeploymentCommandOutput, @@ -34,6 +41,9 @@ export class ContinueDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/CreateApplicationCommand.ts b/clients/client-codedeploy/commands/CreateApplicationCommand.ts index 13f235636e167..fc8f5fe869d84 100644 --- a/clients/client-codedeploy/commands/CreateApplicationCommand.ts +++ b/clients/client-codedeploy/commands/CreateApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateApplicationCommandInput = CreateApplicationInput; export type CreateApplicationCommandOutput = CreateApplicationOutput & __MetadataBearer; +/** + *

Creates an application.

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -34,6 +37,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/CreateDeploymentCommand.ts b/clients/client-codedeploy/commands/CreateDeploymentCommand.ts index 1275e0461d65b..2fffbb2af2d92 100644 --- a/clients/client-codedeploy/commands/CreateDeploymentCommand.ts +++ b/clients/client-codedeploy/commands/CreateDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDeploymentCommandInput = CreateDeploymentInput; export type CreateDeploymentCommandOutput = CreateDeploymentOutput & __MetadataBearer; +/** + *

Deploys an application revision through the specified deployment group.

+ */ export class CreateDeploymentCommand extends $Command< CreateDeploymentCommandInput, CreateDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class CreateDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/CreateDeploymentConfigCommand.ts b/clients/client-codedeploy/commands/CreateDeploymentConfigCommand.ts index ac45b6b9a2afe..cee2bc3347471 100644 --- a/clients/client-codedeploy/commands/CreateDeploymentConfigCommand.ts +++ b/clients/client-codedeploy/commands/CreateDeploymentConfigCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDeploymentConfigCommandInput = CreateDeploymentConfigInput; export type CreateDeploymentConfigCommandOutput = CreateDeploymentConfigOutput & __MetadataBearer; +/** + *

Creates a deployment configuration.

+ */ export class CreateDeploymentConfigCommand extends $Command< CreateDeploymentConfigCommandInput, CreateDeploymentConfigCommandOutput, @@ -34,6 +37,9 @@ export class CreateDeploymentConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/CreateDeploymentGroupCommand.ts b/clients/client-codedeploy/commands/CreateDeploymentGroupCommand.ts index fae3562bd5964..22013f7244370 100644 --- a/clients/client-codedeploy/commands/CreateDeploymentGroupCommand.ts +++ b/clients/client-codedeploy/commands/CreateDeploymentGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDeploymentGroupCommandInput = CreateDeploymentGroupInput; export type CreateDeploymentGroupCommandOutput = CreateDeploymentGroupOutput & __MetadataBearer; +/** + *

Creates a deployment group to which application revisions are deployed.

+ */ export class CreateDeploymentGroupCommand extends $Command< CreateDeploymentGroupCommandInput, CreateDeploymentGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateDeploymentGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/DeleteApplicationCommand.ts b/clients/client-codedeploy/commands/DeleteApplicationCommand.ts index 9785a29bade52..d8cb0e322ce62 100644 --- a/clients/client-codedeploy/commands/DeleteApplicationCommand.ts +++ b/clients/client-codedeploy/commands/DeleteApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApplicationCommandInput = DeleteApplicationInput; export type DeleteApplicationCommandOutput = __MetadataBearer; +/** + *

Deletes an application.

+ */ export class DeleteApplicationCommand extends $Command< DeleteApplicationCommandInput, DeleteApplicationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/DeleteDeploymentConfigCommand.ts b/clients/client-codedeploy/commands/DeleteDeploymentConfigCommand.ts index 49a45cedbe5b4..770cb285f3837 100644 --- a/clients/client-codedeploy/commands/DeleteDeploymentConfigCommand.ts +++ b/clients/client-codedeploy/commands/DeleteDeploymentConfigCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteDeploymentConfigCommandInput = DeleteDeploymentConfigInput; export type DeleteDeploymentConfigCommandOutput = __MetadataBearer; +/** + *

Deletes a deployment configuration.

+ * + *

A deployment configuration cannot be deleted if it is currently in use. Predefined + * configurations cannot be deleted.

+ *
+ */ export class DeleteDeploymentConfigCommand extends $Command< DeleteDeploymentConfigCommandInput, DeleteDeploymentConfigCommandOutput, @@ -34,6 +41,9 @@ export class DeleteDeploymentConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/DeleteDeploymentGroupCommand.ts b/clients/client-codedeploy/commands/DeleteDeploymentGroupCommand.ts index 6cf580e17612d..61c3a2c4f13eb 100644 --- a/clients/client-codedeploy/commands/DeleteDeploymentGroupCommand.ts +++ b/clients/client-codedeploy/commands/DeleteDeploymentGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDeploymentGroupCommandInput = DeleteDeploymentGroupInput; export type DeleteDeploymentGroupCommandOutput = DeleteDeploymentGroupOutput & __MetadataBearer; +/** + *

Deletes a deployment group.

+ */ export class DeleteDeploymentGroupCommand extends $Command< DeleteDeploymentGroupCommandInput, DeleteDeploymentGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDeploymentGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/DeleteGitHubAccountTokenCommand.ts b/clients/client-codedeploy/commands/DeleteGitHubAccountTokenCommand.ts index 16cb58b5ebed5..1e9b3efcf37fb 100644 --- a/clients/client-codedeploy/commands/DeleteGitHubAccountTokenCommand.ts +++ b/clients/client-codedeploy/commands/DeleteGitHubAccountTokenCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGitHubAccountTokenCommandInput = DeleteGitHubAccountTokenInput; export type DeleteGitHubAccountTokenCommandOutput = DeleteGitHubAccountTokenOutput & __MetadataBearer; +/** + *

Deletes a GitHub account connection.

+ */ export class DeleteGitHubAccountTokenCommand extends $Command< DeleteGitHubAccountTokenCommandInput, DeleteGitHubAccountTokenCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGitHubAccountTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/DeleteResourcesByExternalIdCommand.ts b/clients/client-codedeploy/commands/DeleteResourcesByExternalIdCommand.ts index 7d222acc68b36..f8e986908e754 100644 --- a/clients/client-codedeploy/commands/DeleteResourcesByExternalIdCommand.ts +++ b/clients/client-codedeploy/commands/DeleteResourcesByExternalIdCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourcesByExternalIdCommandInput = DeleteResourcesByExternalIdInput; export type DeleteResourcesByExternalIdCommandOutput = DeleteResourcesByExternalIdOutput & __MetadataBearer; +/** + *

Deletes resources linked to an external ID.

+ */ export class DeleteResourcesByExternalIdCommand extends $Command< DeleteResourcesByExternalIdCommandInput, DeleteResourcesByExternalIdCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourcesByExternalIdCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/DeregisterOnPremisesInstanceCommand.ts b/clients/client-codedeploy/commands/DeregisterOnPremisesInstanceCommand.ts index e7a97b28f7123..0753170bad96d 100644 --- a/clients/client-codedeploy/commands/DeregisterOnPremisesInstanceCommand.ts +++ b/clients/client-codedeploy/commands/DeregisterOnPremisesInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type DeregisterOnPremisesInstanceCommandInput = DeregisterOnPremisesInstanceInput; export type DeregisterOnPremisesInstanceCommandOutput = __MetadataBearer; +/** + *

Deregisters an on-premises instance.

+ */ export class DeregisterOnPremisesInstanceCommand extends $Command< DeregisterOnPremisesInstanceCommandInput, DeregisterOnPremisesInstanceCommandOutput, @@ -34,6 +37,9 @@ export class DeregisterOnPremisesInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/GetApplicationCommand.ts b/clients/client-codedeploy/commands/GetApplicationCommand.ts index 4c59c1024a3e2..480be181cf387 100644 --- a/clients/client-codedeploy/commands/GetApplicationCommand.ts +++ b/clients/client-codedeploy/commands/GetApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type GetApplicationCommandInput = GetApplicationInput; export type GetApplicationCommandOutput = GetApplicationOutput & __MetadataBearer; +/** + *

Gets information about an application.

+ */ export class GetApplicationCommand extends $Command< GetApplicationCommandInput, GetApplicationCommandOutput, @@ -34,6 +37,9 @@ export class GetApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/GetApplicationRevisionCommand.ts b/clients/client-codedeploy/commands/GetApplicationRevisionCommand.ts index 53b03608b4658..82b21e7f40ca1 100644 --- a/clients/client-codedeploy/commands/GetApplicationRevisionCommand.ts +++ b/clients/client-codedeploy/commands/GetApplicationRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type GetApplicationRevisionCommandInput = GetApplicationRevisionInput; export type GetApplicationRevisionCommandOutput = GetApplicationRevisionOutput & __MetadataBearer; +/** + *

Gets information about an application revision.

+ */ export class GetApplicationRevisionCommand extends $Command< GetApplicationRevisionCommandInput, GetApplicationRevisionCommandOutput, @@ -34,6 +37,9 @@ export class GetApplicationRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/GetDeploymentCommand.ts b/clients/client-codedeploy/commands/GetDeploymentCommand.ts index b5db87a42a4ce..def1c1a958742 100644 --- a/clients/client-codedeploy/commands/GetDeploymentCommand.ts +++ b/clients/client-codedeploy/commands/GetDeploymentCommand.ts @@ -20,6 +20,16 @@ import { export type GetDeploymentCommandInput = GetDeploymentInput; export type GetDeploymentCommandOutput = GetDeploymentOutput & __MetadataBearer; +/** + *

Gets information about a deployment.

+ * + *

+ * The content property of the appSpecContent object in the returned revision is always null. + * Use GetApplicationRevision and the sha256 property of the returned appSpecContent + * object to get the content of the deployment’s AppSpec file. + *

+ *
+ */ export class GetDeploymentCommand extends $Command< GetDeploymentCommandInput, GetDeploymentCommandOutput, @@ -34,6 +44,9 @@ export class GetDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/GetDeploymentConfigCommand.ts b/clients/client-codedeploy/commands/GetDeploymentConfigCommand.ts index 868f5de4a7fe5..51c101d17d05f 100644 --- a/clients/client-codedeploy/commands/GetDeploymentConfigCommand.ts +++ b/clients/client-codedeploy/commands/GetDeploymentConfigCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentConfigCommandInput = GetDeploymentConfigInput; export type GetDeploymentConfigCommandOutput = GetDeploymentConfigOutput & __MetadataBearer; +/** + *

Gets information about a deployment configuration.

+ */ export class GetDeploymentConfigCommand extends $Command< GetDeploymentConfigCommandInput, GetDeploymentConfigCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/GetDeploymentGroupCommand.ts b/clients/client-codedeploy/commands/GetDeploymentGroupCommand.ts index 948e8a597a957..26594182fc857 100644 --- a/clients/client-codedeploy/commands/GetDeploymentGroupCommand.ts +++ b/clients/client-codedeploy/commands/GetDeploymentGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentGroupCommandInput = GetDeploymentGroupInput; export type GetDeploymentGroupCommandOutput = GetDeploymentGroupOutput & __MetadataBearer; +/** + *

Gets information about a deployment group.

+ */ export class GetDeploymentGroupCommand extends $Command< GetDeploymentGroupCommandInput, GetDeploymentGroupCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/GetDeploymentInstanceCommand.ts b/clients/client-codedeploy/commands/GetDeploymentInstanceCommand.ts index 0139db0f203f2..cbe798fb6ca6e 100644 --- a/clients/client-codedeploy/commands/GetDeploymentInstanceCommand.ts +++ b/clients/client-codedeploy/commands/GetDeploymentInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentInstanceCommandInput = GetDeploymentInstanceInput; export type GetDeploymentInstanceCommandOutput = GetDeploymentInstanceOutput & __MetadataBearer; +/** + *

Gets information about an instance as part of a deployment.

+ */ export class GetDeploymentInstanceCommand extends $Command< GetDeploymentInstanceCommandInput, GetDeploymentInstanceCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/GetDeploymentTargetCommand.ts b/clients/client-codedeploy/commands/GetDeploymentTargetCommand.ts index 3815bb78dbd67..5f754c5653913 100644 --- a/clients/client-codedeploy/commands/GetDeploymentTargetCommand.ts +++ b/clients/client-codedeploy/commands/GetDeploymentTargetCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentTargetCommandInput = GetDeploymentTargetInput; export type GetDeploymentTargetCommandOutput = GetDeploymentTargetOutput & __MetadataBearer; +/** + *

Returns information about a deployment target.

+ */ export class GetDeploymentTargetCommand extends $Command< GetDeploymentTargetCommandInput, GetDeploymentTargetCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/GetOnPremisesInstanceCommand.ts b/clients/client-codedeploy/commands/GetOnPremisesInstanceCommand.ts index 8802ca1ebd42b..6d775dbcb13a8 100644 --- a/clients/client-codedeploy/commands/GetOnPremisesInstanceCommand.ts +++ b/clients/client-codedeploy/commands/GetOnPremisesInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type GetOnPremisesInstanceCommandInput = GetOnPremisesInstanceInput; export type GetOnPremisesInstanceCommandOutput = GetOnPremisesInstanceOutput & __MetadataBearer; +/** + *

Gets information about an on-premises instance.

+ */ export class GetOnPremisesInstanceCommand extends $Command< GetOnPremisesInstanceCommandInput, GetOnPremisesInstanceCommandOutput, @@ -34,6 +37,9 @@ export class GetOnPremisesInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListApplicationRevisionsCommand.ts b/clients/client-codedeploy/commands/ListApplicationRevisionsCommand.ts index b76a3ddfd9755..97bd8cfffbdd0 100644 --- a/clients/client-codedeploy/commands/ListApplicationRevisionsCommand.ts +++ b/clients/client-codedeploy/commands/ListApplicationRevisionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListApplicationRevisionsCommandInput = ListApplicationRevisionsInput; export type ListApplicationRevisionsCommandOutput = ListApplicationRevisionsOutput & __MetadataBearer; +/** + *

Lists information about revisions for an application.

+ */ export class ListApplicationRevisionsCommand extends $Command< ListApplicationRevisionsCommandInput, ListApplicationRevisionsCommandOutput, @@ -34,6 +37,9 @@ export class ListApplicationRevisionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListApplicationsCommand.ts b/clients/client-codedeploy/commands/ListApplicationsCommand.ts index 331cf72b8698c..dcea69c4a192b 100644 --- a/clients/client-codedeploy/commands/ListApplicationsCommand.ts +++ b/clients/client-codedeploy/commands/ListApplicationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListApplicationsCommandInput = ListApplicationsInput; export type ListApplicationsCommandOutput = ListApplicationsOutput & __MetadataBearer; +/** + *

Lists the applications registered with the IAM user or AWS account.

+ */ export class ListApplicationsCommand extends $Command< ListApplicationsCommandInput, ListApplicationsCommandOutput, @@ -34,6 +37,9 @@ export class ListApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListDeploymentConfigsCommand.ts b/clients/client-codedeploy/commands/ListDeploymentConfigsCommand.ts index 24431ed80b5bf..d80f7fb496d7d 100644 --- a/clients/client-codedeploy/commands/ListDeploymentConfigsCommand.ts +++ b/clients/client-codedeploy/commands/ListDeploymentConfigsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDeploymentConfigsCommandInput = ListDeploymentConfigsInput; export type ListDeploymentConfigsCommandOutput = ListDeploymentConfigsOutput & __MetadataBearer; +/** + *

Lists the deployment configurations with the IAM user or AWS account.

+ */ export class ListDeploymentConfigsCommand extends $Command< ListDeploymentConfigsCommandInput, ListDeploymentConfigsCommandOutput, @@ -34,6 +37,9 @@ export class ListDeploymentConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListDeploymentGroupsCommand.ts b/clients/client-codedeploy/commands/ListDeploymentGroupsCommand.ts index 07c1ebdb91a13..5b61dcb8f70df 100644 --- a/clients/client-codedeploy/commands/ListDeploymentGroupsCommand.ts +++ b/clients/client-codedeploy/commands/ListDeploymentGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDeploymentGroupsCommandInput = ListDeploymentGroupsInput; export type ListDeploymentGroupsCommandOutput = ListDeploymentGroupsOutput & __MetadataBearer; +/** + *

Lists the deployment groups for an application registered with the IAM user or AWS + * account.

+ */ export class ListDeploymentGroupsCommand extends $Command< ListDeploymentGroupsCommandInput, ListDeploymentGroupsCommandOutput, @@ -34,6 +38,9 @@ export class ListDeploymentGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListDeploymentInstancesCommand.ts b/clients/client-codedeploy/commands/ListDeploymentInstancesCommand.ts index c9a8f3d1ea0d2..9d937633bfd5b 100644 --- a/clients/client-codedeploy/commands/ListDeploymentInstancesCommand.ts +++ b/clients/client-codedeploy/commands/ListDeploymentInstancesCommand.ts @@ -20,6 +20,15 @@ import { export type ListDeploymentInstancesCommandInput = ListDeploymentInstancesInput; export type ListDeploymentInstancesCommandOutput = ListDeploymentInstancesOutput & __MetadataBearer; +/** + * + *

The newer BatchGetDeploymentTargets should be used instead because + * it works with all compute types. ListDeploymentInstances throws an + * exception if it is used with a compute platform other than EC2/On-premises or AWS + * Lambda.

+ *
+ *

Lists the instance for a deployment associated with the IAM user or AWS account.

+ */ export class ListDeploymentInstancesCommand extends $Command< ListDeploymentInstancesCommandInput, ListDeploymentInstancesCommandOutput, @@ -34,6 +43,9 @@ export class ListDeploymentInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListDeploymentTargetsCommand.ts b/clients/client-codedeploy/commands/ListDeploymentTargetsCommand.ts index d226241fc0e1b..95587c85130c8 100644 --- a/clients/client-codedeploy/commands/ListDeploymentTargetsCommand.ts +++ b/clients/client-codedeploy/commands/ListDeploymentTargetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDeploymentTargetsCommandInput = ListDeploymentTargetsInput; export type ListDeploymentTargetsCommandOutput = ListDeploymentTargetsOutput & __MetadataBearer; +/** + *

Returns an array of target IDs that are associated a deployment.

+ */ export class ListDeploymentTargetsCommand extends $Command< ListDeploymentTargetsCommandInput, ListDeploymentTargetsCommandOutput, @@ -34,6 +37,9 @@ export class ListDeploymentTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListDeploymentsCommand.ts b/clients/client-codedeploy/commands/ListDeploymentsCommand.ts index 88d8dc665eaa2..aac1f55c4ea40 100644 --- a/clients/client-codedeploy/commands/ListDeploymentsCommand.ts +++ b/clients/client-codedeploy/commands/ListDeploymentsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDeploymentsCommandInput = ListDeploymentsInput; export type ListDeploymentsCommandOutput = ListDeploymentsOutput & __MetadataBearer; +/** + *

Lists the deployments in a deployment group for an application registered with the IAM + * user or AWS account.

+ */ export class ListDeploymentsCommand extends $Command< ListDeploymentsCommandInput, ListDeploymentsCommandOutput, @@ -34,6 +38,9 @@ export class ListDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListGitHubAccountTokenNamesCommand.ts b/clients/client-codedeploy/commands/ListGitHubAccountTokenNamesCommand.ts index 4b3ca06d91ef2..56117950caf89 100644 --- a/clients/client-codedeploy/commands/ListGitHubAccountTokenNamesCommand.ts +++ b/clients/client-codedeploy/commands/ListGitHubAccountTokenNamesCommand.ts @@ -20,6 +20,9 @@ import { export type ListGitHubAccountTokenNamesCommandInput = ListGitHubAccountTokenNamesInput; export type ListGitHubAccountTokenNamesCommandOutput = ListGitHubAccountTokenNamesOutput & __MetadataBearer; +/** + *

Lists the names of stored connections to GitHub accounts.

+ */ export class ListGitHubAccountTokenNamesCommand extends $Command< ListGitHubAccountTokenNamesCommandInput, ListGitHubAccountTokenNamesCommandOutput, @@ -34,6 +37,9 @@ export class ListGitHubAccountTokenNamesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListOnPremisesInstancesCommand.ts b/clients/client-codedeploy/commands/ListOnPremisesInstancesCommand.ts index 4a4a634d74779..2f464bf149334 100644 --- a/clients/client-codedeploy/commands/ListOnPremisesInstancesCommand.ts +++ b/clients/client-codedeploy/commands/ListOnPremisesInstancesCommand.ts @@ -20,6 +20,12 @@ import { export type ListOnPremisesInstancesCommandInput = ListOnPremisesInstancesInput; export type ListOnPremisesInstancesCommandOutput = ListOnPremisesInstancesOutput & __MetadataBearer; +/** + *

Gets a list of names for one or more on-premises instances.

+ *

Unless otherwise specified, both registered and deregistered on-premises instance + * names are listed. To list only registered or deregistered on-premises instance names, + * use the registration status parameter.

+ */ export class ListOnPremisesInstancesCommand extends $Command< ListOnPremisesInstancesCommandInput, ListOnPremisesInstancesCommandOutput, @@ -34,6 +40,9 @@ export class ListOnPremisesInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/ListTagsForResourceCommand.ts b/clients/client-codedeploy/commands/ListTagsForResourceCommand.ts index e73931c067c33..c0272488a1a12 100644 --- a/clients/client-codedeploy/commands/ListTagsForResourceCommand.ts +++ b/clients/client-codedeploy/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Returns a list of tags for the resource identified by a specified Amazon Resource + * Name (ARN). Tags are used to organize and categorize your CodeDeploy resources.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/PutLifecycleEventHookExecutionStatusCommand.ts b/clients/client-codedeploy/commands/PutLifecycleEventHookExecutionStatusCommand.ts index 7facb8ab95953..8d8e43ab6f0cc 100644 --- a/clients/client-codedeploy/commands/PutLifecycleEventHookExecutionStatusCommand.ts +++ b/clients/client-codedeploy/commands/PutLifecycleEventHookExecutionStatusCommand.ts @@ -24,6 +24,18 @@ export type PutLifecycleEventHookExecutionStatusCommandInput = PutLifecycleEvent export type PutLifecycleEventHookExecutionStatusCommandOutput = PutLifecycleEventHookExecutionStatusOutput & __MetadataBearer; +/** + *

Sets the result of a Lambda validation function. The function validates + * lifecycle hooks during a deployment that uses the AWS Lambda or Amazon ECS compute platform. For AWS + * Lambda deployments, the available lifecycle hooks are BeforeAllowTraffic and AfterAllowTraffic. + * For Amazon ECS deployments, the available lifecycle hooks are BeforeInstall, AfterInstall, + * AfterAllowTestTraffic, BeforeAllowTraffic, and AfterAllowTraffic. Lambda + * validation functions return Succeeded or Failed. For more information, + * see AppSpec 'hooks' + * Section for an AWS Lambda Deployment + * and AppSpec + * 'hooks' Section for an Amazon ECS Deployment.

+ */ export class PutLifecycleEventHookExecutionStatusCommand extends $Command< PutLifecycleEventHookExecutionStatusCommandInput, PutLifecycleEventHookExecutionStatusCommandOutput, @@ -38,6 +50,9 @@ export class PutLifecycleEventHookExecutionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/RegisterApplicationRevisionCommand.ts b/clients/client-codedeploy/commands/RegisterApplicationRevisionCommand.ts index 008f5afa435ec..0bc0344c21b9c 100644 --- a/clients/client-codedeploy/commands/RegisterApplicationRevisionCommand.ts +++ b/clients/client-codedeploy/commands/RegisterApplicationRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type RegisterApplicationRevisionCommandInput = RegisterApplicationRevisionInput; export type RegisterApplicationRevisionCommandOutput = __MetadataBearer; +/** + *

Registers with AWS CodeDeploy a revision for the specified application.

+ */ export class RegisterApplicationRevisionCommand extends $Command< RegisterApplicationRevisionCommandInput, RegisterApplicationRevisionCommandOutput, @@ -34,6 +37,9 @@ export class RegisterApplicationRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/RegisterOnPremisesInstanceCommand.ts b/clients/client-codedeploy/commands/RegisterOnPremisesInstanceCommand.ts index 7d51f0874b46e..ed4d8437d3a86 100644 --- a/clients/client-codedeploy/commands/RegisterOnPremisesInstanceCommand.ts +++ b/clients/client-codedeploy/commands/RegisterOnPremisesInstanceCommand.ts @@ -20,6 +20,13 @@ import { export type RegisterOnPremisesInstanceCommandInput = RegisterOnPremisesInstanceInput; export type RegisterOnPremisesInstanceCommandOutput = __MetadataBearer; +/** + *

Registers an on-premises instance.

+ * + *

Only one IAM ARN (an IAM session ARN or IAM user ARN) is supported in the request. + * You cannot use both.

+ *
+ */ export class RegisterOnPremisesInstanceCommand extends $Command< RegisterOnPremisesInstanceCommandInput, RegisterOnPremisesInstanceCommandOutput, @@ -34,6 +41,9 @@ export class RegisterOnPremisesInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/RemoveTagsFromOnPremisesInstancesCommand.ts b/clients/client-codedeploy/commands/RemoveTagsFromOnPremisesInstancesCommand.ts index 230e2f3320963..f28257dd42a22 100644 --- a/clients/client-codedeploy/commands/RemoveTagsFromOnPremisesInstancesCommand.ts +++ b/clients/client-codedeploy/commands/RemoveTagsFromOnPremisesInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveTagsFromOnPremisesInstancesCommandInput = RemoveTagsFromOnPremisesInstancesInput; export type RemoveTagsFromOnPremisesInstancesCommandOutput = __MetadataBearer; +/** + *

Removes one or more tags from one or more on-premises instances.

+ */ export class RemoveTagsFromOnPremisesInstancesCommand extends $Command< RemoveTagsFromOnPremisesInstancesCommandInput, RemoveTagsFromOnPremisesInstancesCommandOutput, @@ -34,6 +37,9 @@ export class RemoveTagsFromOnPremisesInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/SkipWaitTimeForInstanceTerminationCommand.ts b/clients/client-codedeploy/commands/SkipWaitTimeForInstanceTerminationCommand.ts index 3e35fcd175674..86a4ba0fa035d 100644 --- a/clients/client-codedeploy/commands/SkipWaitTimeForInstanceTerminationCommand.ts +++ b/clients/client-codedeploy/commands/SkipWaitTimeForInstanceTerminationCommand.ts @@ -20,6 +20,10 @@ import { export type SkipWaitTimeForInstanceTerminationCommandInput = SkipWaitTimeForInstanceTerminationInput; export type SkipWaitTimeForInstanceTerminationCommandOutput = __MetadataBearer; +/** + *

In a blue/green deployment, overrides any specified wait time and starts terminating + * instances immediately after the traffic routing is complete.

+ */ export class SkipWaitTimeForInstanceTerminationCommand extends $Command< SkipWaitTimeForInstanceTerminationCommandInput, SkipWaitTimeForInstanceTerminationCommandOutput, @@ -34,6 +38,9 @@ export class SkipWaitTimeForInstanceTerminationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/StopDeploymentCommand.ts b/clients/client-codedeploy/commands/StopDeploymentCommand.ts index b2c8385c6cf7c..ce29752a1e962 100644 --- a/clients/client-codedeploy/commands/StopDeploymentCommand.ts +++ b/clients/client-codedeploy/commands/StopDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type StopDeploymentCommandInput = StopDeploymentInput; export type StopDeploymentCommandOutput = StopDeploymentOutput & __MetadataBearer; +/** + *

Attempts to stop an ongoing deployment.

+ */ export class StopDeploymentCommand extends $Command< StopDeploymentCommandInput, StopDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class StopDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/TagResourceCommand.ts b/clients/client-codedeploy/commands/TagResourceCommand.ts index 804d702890319..64d0ea3137ed8 100644 --- a/clients/client-codedeploy/commands/TagResourceCommand.ts +++ b/clients/client-codedeploy/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

+ * Associates the list of tags in the input Tags parameter with the resource identified by the ResourceArn input parameter. + *

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/UntagResourceCommand.ts b/clients/client-codedeploy/commands/UntagResourceCommand.ts index 1c94cf1afa218..b537d461f5849 100644 --- a/clients/client-codedeploy/commands/UntagResourceCommand.ts +++ b/clients/client-codedeploy/commands/UntagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Disassociates a resource from a list of tags. The resource is identified by the + * ResourceArn input parameter. The tags are identified by the list of + * keys in the TagKeys input parameter.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/UpdateApplicationCommand.ts b/clients/client-codedeploy/commands/UpdateApplicationCommand.ts index 8e846f3dd8f5e..f01769598614b 100644 --- a/clients/client-codedeploy/commands/UpdateApplicationCommand.ts +++ b/clients/client-codedeploy/commands/UpdateApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationInput; export type UpdateApplicationCommandOutput = __MetadataBearer; +/** + *

Changes the name of an application.

+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/commands/UpdateDeploymentGroupCommand.ts b/clients/client-codedeploy/commands/UpdateDeploymentGroupCommand.ts index 6ecb76fc5b733..694ccf979f3d7 100644 --- a/clients/client-codedeploy/commands/UpdateDeploymentGroupCommand.ts +++ b/clients/client-codedeploy/commands/UpdateDeploymentGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDeploymentGroupCommandInput = UpdateDeploymentGroupInput; export type UpdateDeploymentGroupCommandOutput = UpdateDeploymentGroupOutput & __MetadataBearer; +/** + *

Changes information about a deployment group.

+ */ export class UpdateDeploymentGroupCommand extends $Command< UpdateDeploymentGroupCommandInput, UpdateDeploymentGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDeploymentGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeDeployClientResolvedConfig, diff --git a/clients/client-codedeploy/package.json b/clients/client-codedeploy/package.json index 4067a223ff2d3..640a1971a775a 100644 --- a/clients/client-codedeploy/package.json +++ b/clients/client-codedeploy/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codedeploy Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codedeploy/pagination/ListApplicationRevisionsPaginator.ts b/clients/client-codedeploy/pagination/ListApplicationRevisionsPaginator.ts index 479523f2a1af1..b08d1d0c1b656 100644 --- a/clients/client-codedeploy/pagination/ListApplicationRevisionsPaginator.ts +++ b/clients/client-codedeploy/pagination/ListApplicationRevisionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeDeployPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeDeployClient, input: ListApplicationRevisionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationRevisionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeDeploy, input: ListApplicationRevisionsCommandInput, diff --git a/clients/client-codedeploy/pagination/ListApplicationsPaginator.ts b/clients/client-codedeploy/pagination/ListApplicationsPaginator.ts index b7ac6a5fd941d..161f27d2b6474 100644 --- a/clients/client-codedeploy/pagination/ListApplicationsPaginator.ts +++ b/clients/client-codedeploy/pagination/ListApplicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeDeployPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeDeployClient, input: ListApplicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeDeploy, input: ListApplicationsCommandInput, diff --git a/clients/client-codedeploy/pagination/ListDeploymentConfigsPaginator.ts b/clients/client-codedeploy/pagination/ListDeploymentConfigsPaginator.ts index e7f2e9cadc212..e796f8ca26d96 100644 --- a/clients/client-codedeploy/pagination/ListDeploymentConfigsPaginator.ts +++ b/clients/client-codedeploy/pagination/ListDeploymentConfigsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeDeployPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeDeployClient, input: ListDeploymentConfigsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeploymentConfigsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeDeploy, input: ListDeploymentConfigsCommandInput, diff --git a/clients/client-codedeploy/pagination/ListDeploymentGroupsPaginator.ts b/clients/client-codedeploy/pagination/ListDeploymentGroupsPaginator.ts index d7998b8e54e46..2d5166435bd0f 100644 --- a/clients/client-codedeploy/pagination/ListDeploymentGroupsPaginator.ts +++ b/clients/client-codedeploy/pagination/ListDeploymentGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeDeployPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeDeployClient, input: ListDeploymentGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeploymentGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeDeploy, input: ListDeploymentGroupsCommandInput, diff --git a/clients/client-codedeploy/pagination/ListDeploymentInstancesPaginator.ts b/clients/client-codedeploy/pagination/ListDeploymentInstancesPaginator.ts index aa36e337a50e6..fdda4f1912f4a 100644 --- a/clients/client-codedeploy/pagination/ListDeploymentInstancesPaginator.ts +++ b/clients/client-codedeploy/pagination/ListDeploymentInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeDeployPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeDeployClient, input: ListDeploymentInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeploymentInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeDeploy, input: ListDeploymentInstancesCommandInput, diff --git a/clients/client-codedeploy/pagination/ListDeploymentsPaginator.ts b/clients/client-codedeploy/pagination/ListDeploymentsPaginator.ts index 0e17c013735c3..ce7646cba51ab 100644 --- a/clients/client-codedeploy/pagination/ListDeploymentsPaginator.ts +++ b/clients/client-codedeploy/pagination/ListDeploymentsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeDeployPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeDeployClient, input: ListDeploymentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeploymentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeDeploy, input: ListDeploymentsCommandInput, diff --git a/clients/client-codedeploy/runtimeConfig.browser.ts b/clients/client-codedeploy/runtimeConfig.browser.ts index 47ce495565da9..5df53401f175d 100644 --- a/clients/client-codedeploy/runtimeConfig.browser.ts +++ b/clients/client-codedeploy/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodeDeployClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codedeploy/runtimeConfig.native.ts b/clients/client-codedeploy/runtimeConfig.native.ts index ebca258f94b17..dab024883e226 100644 --- a/clients/client-codedeploy/runtimeConfig.native.ts +++ b/clients/client-codedeploy/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodeDeployClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codedeploy/runtimeConfig.shared.ts b/clients/client-codedeploy/runtimeConfig.shared.ts index 6133aedcdbb65..bcbb8fb51b7b7 100644 --- a/clients/client-codedeploy/runtimeConfig.shared.ts +++ b/clients/client-codedeploy/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-10-06", disableHostPrefix: false, diff --git a/clients/client-codedeploy/runtimeConfig.ts b/clients/client-codedeploy/runtimeConfig.ts index f18a3d7b701ab..768be9eff8024 100644 --- a/clients/client-codedeploy/runtimeConfig.ts +++ b/clients/client-codedeploy/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodeDeployClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codedeploy/tsconfig.json b/clients/client-codedeploy/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codedeploy/tsconfig.json +++ b/clients/client-codedeploy/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codeguru-reviewer/commands/AssociateRepositoryCommand.ts b/clients/client-codeguru-reviewer/commands/AssociateRepositoryCommand.ts index ae29779f2a070..328730217f42e 100644 --- a/clients/client-codeguru-reviewer/commands/AssociateRepositoryCommand.ts +++ b/clients/client-codeguru-reviewer/commands/AssociateRepositoryCommand.ts @@ -20,6 +20,33 @@ import { export type AssociateRepositoryCommandInput = AssociateRepositoryRequest; export type AssociateRepositoryCommandOutput = AssociateRepositoryResponse & __MetadataBearer; +/** + *

+ * Use to associate an AWS CodeCommit repository or a repostory managed by + * AWS CodeStar Connections with Amazon CodeGuru Reviewer. When you associate a + * repository, CodeGuru Reviewer reviews source code changes in the repository's pull requests and provides + * automatic recommendations. You can view recommendations using the CodeGuru Reviewer console. For more information, see + * Recommendations in + * Amazon CodeGuru Reviewer in the Amazon CodeGuru Reviewer User Guide. + *

+ * + *

If you associate a CodeCommit repository, it must be in the same + * AWS Region and AWS account where its CodeGuru Reviewer code reviews are configured.

+ * + *

Bitbucket and GitHub Enterprise Server repositories are managed by AWS CodeStar + * Connections to connect to CodeGuru Reviewer. For more information, see Connect to a repository source provider in + * the Amazon CodeGuru Reviewer User Guide. + *

+ * + * + *

+ * You cannot use the CodeGuru Reviewer SDK or the AWS CLI to associate a GitHub repository with Amazon CodeGuru Reviewer. To associate + * a GitHub repository, use the console. For more information, see + * Getting + * started with CodeGuru Reviewer in the CodeGuru Reviewer User Guide. + *

+ *
+ */ export class AssociateRepositoryCommand extends $Command< AssociateRepositoryCommandInput, AssociateRepositoryCommandOutput, @@ -34,6 +61,9 @@ export class AssociateRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/CreateCodeReviewCommand.ts b/clients/client-codeguru-reviewer/commands/CreateCodeReviewCommand.ts index 216a828c61eba..c56b6da1b1b51 100644 --- a/clients/client-codeguru-reviewer/commands/CreateCodeReviewCommand.ts +++ b/clients/client-codeguru-reviewer/commands/CreateCodeReviewCommand.ts @@ -20,6 +20,11 @@ import { export type CreateCodeReviewCommandInput = CreateCodeReviewRequest; export type CreateCodeReviewCommandOutput = CreateCodeReviewResponse & __MetadataBearer; +/** + *

+ * Use to create a code review for a repository analysis. + *

+ */ export class CreateCodeReviewCommand extends $Command< CreateCodeReviewCommandInput, CreateCodeReviewCommandOutput, @@ -34,6 +39,9 @@ export class CreateCodeReviewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/DescribeCodeReviewCommand.ts b/clients/client-codeguru-reviewer/commands/DescribeCodeReviewCommand.ts index d6fd297f58fd0..5cfe981f8a7d7 100644 --- a/clients/client-codeguru-reviewer/commands/DescribeCodeReviewCommand.ts +++ b/clients/client-codeguru-reviewer/commands/DescribeCodeReviewCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCodeReviewCommandInput = DescribeCodeReviewRequest; export type DescribeCodeReviewCommandOutput = DescribeCodeReviewResponse & __MetadataBearer; +/** + *

Returns the metadata associated with the code review along with its status.

+ */ export class DescribeCodeReviewCommand extends $Command< DescribeCodeReviewCommandInput, DescribeCodeReviewCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCodeReviewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/DescribeRecommendationFeedbackCommand.ts b/clients/client-codeguru-reviewer/commands/DescribeRecommendationFeedbackCommand.ts index 468bee6e05654..7448be1ebcded 100644 --- a/clients/client-codeguru-reviewer/commands/DescribeRecommendationFeedbackCommand.ts +++ b/clients/client-codeguru-reviewer/commands/DescribeRecommendationFeedbackCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeRecommendationFeedbackCommandInput = DescribeRecommendationFeedbackRequest; export type DescribeRecommendationFeedbackCommandOutput = DescribeRecommendationFeedbackResponse & __MetadataBearer; +/** + *

+ * Describes the customer feedback for a CodeGuru Reviewer recommendation. + *

+ */ export class DescribeRecommendationFeedbackCommand extends $Command< DescribeRecommendationFeedbackCommandInput, DescribeRecommendationFeedbackCommandOutput, @@ -34,6 +39,9 @@ export class DescribeRecommendationFeedbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/DescribeRepositoryAssociationCommand.ts b/clients/client-codeguru-reviewer/commands/DescribeRepositoryAssociationCommand.ts index 6dcc6fa7a0d55..cdbc03a01aa99 100644 --- a/clients/client-codeguru-reviewer/commands/DescribeRepositoryAssociationCommand.ts +++ b/clients/client-codeguru-reviewer/commands/DescribeRepositoryAssociationCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeRepositoryAssociationCommandInput = DescribeRepositoryAssociationRequest; export type DescribeRepositoryAssociationCommandOutput = DescribeRepositoryAssociationResponse & __MetadataBearer; +/** + *

+ * Returns a + * RepositoryAssociation + * object + * that contains information about the requested repository association. + *

+ */ export class DescribeRepositoryAssociationCommand extends $Command< DescribeRepositoryAssociationCommandInput, DescribeRepositoryAssociationCommandOutput, @@ -34,6 +42,9 @@ export class DescribeRepositoryAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/DisassociateRepositoryCommand.ts b/clients/client-codeguru-reviewer/commands/DisassociateRepositoryCommand.ts index de1f4a82a21f3..67069611e073d 100644 --- a/clients/client-codeguru-reviewer/commands/DisassociateRepositoryCommand.ts +++ b/clients/client-codeguru-reviewer/commands/DisassociateRepositoryCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateRepositoryCommandInput = DisassociateRepositoryRequest; export type DisassociateRepositoryCommandOutput = DisassociateRepositoryResponse & __MetadataBearer; +/** + *

Removes the association between Amazon CodeGuru Reviewer and a repository.

+ */ export class DisassociateRepositoryCommand extends $Command< DisassociateRepositoryCommandInput, DisassociateRepositoryCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/ListCodeReviewsCommand.ts b/clients/client-codeguru-reviewer/commands/ListCodeReviewsCommand.ts index c460c30c2db71..f7252f9cb4036 100644 --- a/clients/client-codeguru-reviewer/commands/ListCodeReviewsCommand.ts +++ b/clients/client-codeguru-reviewer/commands/ListCodeReviewsCommand.ts @@ -20,6 +20,11 @@ import { export type ListCodeReviewsCommandInput = ListCodeReviewsRequest; export type ListCodeReviewsCommandOutput = ListCodeReviewsResponse & __MetadataBearer; +/** + *

+ * Lists all the code reviews that the customer has created in the past 90 days. + *

+ */ export class ListCodeReviewsCommand extends $Command< ListCodeReviewsCommandInput, ListCodeReviewsCommandOutput, @@ -34,6 +39,9 @@ export class ListCodeReviewsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/ListRecommendationFeedbackCommand.ts b/clients/client-codeguru-reviewer/commands/ListRecommendationFeedbackCommand.ts index adcc597ca16e2..8b247ff443a43 100644 --- a/clients/client-codeguru-reviewer/commands/ListRecommendationFeedbackCommand.ts +++ b/clients/client-codeguru-reviewer/commands/ListRecommendationFeedbackCommand.ts @@ -20,6 +20,15 @@ import { export type ListRecommendationFeedbackCommandInput = ListRecommendationFeedbackRequest; export type ListRecommendationFeedbackCommandOutput = ListRecommendationFeedbackResponse & __MetadataBearer; +/** + *

+ * Returns a list of + * + * RecommendationFeedbackSummary + * + * objects that contain customer recommendation feedback for all CodeGuru Reviewer users. + *

+ */ export class ListRecommendationFeedbackCommand extends $Command< ListRecommendationFeedbackCommandInput, ListRecommendationFeedbackCommandOutput, @@ -34,6 +43,9 @@ export class ListRecommendationFeedbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/ListRecommendationsCommand.ts b/clients/client-codeguru-reviewer/commands/ListRecommendationsCommand.ts index 15017254ce5b2..7c553660c4906 100644 --- a/clients/client-codeguru-reviewer/commands/ListRecommendationsCommand.ts +++ b/clients/client-codeguru-reviewer/commands/ListRecommendationsCommand.ts @@ -20,6 +20,11 @@ import { export type ListRecommendationsCommandInput = ListRecommendationsRequest; export type ListRecommendationsCommandOutput = ListRecommendationsResponse & __MetadataBearer; +/** + *

+ * Returns the list of all recommendations for a completed code review. + *

+ */ export class ListRecommendationsCommand extends $Command< ListRecommendationsCommandInput, ListRecommendationsCommandOutput, @@ -34,6 +39,9 @@ export class ListRecommendationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/ListRepositoryAssociationsCommand.ts b/clients/client-codeguru-reviewer/commands/ListRepositoryAssociationsCommand.ts index 2ac0858957ea3..7465817f89fa8 100644 --- a/clients/client-codeguru-reviewer/commands/ListRepositoryAssociationsCommand.ts +++ b/clients/client-codeguru-reviewer/commands/ListRepositoryAssociationsCommand.ts @@ -20,6 +20,26 @@ import { export type ListRepositoryAssociationsCommandInput = ListRepositoryAssociationsRequest; export type ListRepositoryAssociationsCommandOutput = ListRepositoryAssociationsResponse & __MetadataBearer; +/** + *

+ * Returns a list of + * RepositoryAssociationSummary + * objects that + * contain summary information about a repository association. You can filter the returned list by + * + * ProviderType + * , + * + * Name + * , + * + * State + * , and + * + * Owner + * . + *

+ */ export class ListRepositoryAssociationsCommand extends $Command< ListRepositoryAssociationsCommandInput, ListRepositoryAssociationsCommandOutput, @@ -34,6 +54,9 @@ export class ListRepositoryAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/commands/PutRecommendationFeedbackCommand.ts b/clients/client-codeguru-reviewer/commands/PutRecommendationFeedbackCommand.ts index 50968425fd10f..5c5b33dd1d1b7 100644 --- a/clients/client-codeguru-reviewer/commands/PutRecommendationFeedbackCommand.ts +++ b/clients/client-codeguru-reviewer/commands/PutRecommendationFeedbackCommand.ts @@ -20,6 +20,11 @@ import { export type PutRecommendationFeedbackCommandInput = PutRecommendationFeedbackRequest; export type PutRecommendationFeedbackCommandOutput = PutRecommendationFeedbackResponse & __MetadataBearer; +/** + *

+ * Stores customer feedback for a CodeGuru Reviewer recommendation. When this API is called again with different reactions the previous feedback is overwritten. + *

+ */ export class PutRecommendationFeedbackCommand extends $Command< PutRecommendationFeedbackCommandInput, PutRecommendationFeedbackCommandOutput, @@ -34,6 +39,9 @@ export class PutRecommendationFeedbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruReviewerClientResolvedConfig, diff --git a/clients/client-codeguru-reviewer/package.json b/clients/client-codeguru-reviewer/package.json index aa05a7bf159b3..ccfa9f689ee7b 100644 --- a/clients/client-codeguru-reviewer/package.json +++ b/clients/client-codeguru-reviewer/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codeguru Reviewer Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codeguru-reviewer/pagination/ListCodeReviewsPaginator.ts b/clients/client-codeguru-reviewer/pagination/ListCodeReviewsPaginator.ts index de1d746ddad26..1c7f8b10d35fd 100644 --- a/clients/client-codeguru-reviewer/pagination/ListCodeReviewsPaginator.ts +++ b/clients/client-codeguru-reviewer/pagination/ListCodeReviewsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeGuruReviewerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeGuruReviewerClient, input: ListCodeReviewsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCodeReviewsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeGuruReviewer, input: ListCodeReviewsCommandInput, diff --git a/clients/client-codeguru-reviewer/pagination/ListRecommendationFeedbackPaginator.ts b/clients/client-codeguru-reviewer/pagination/ListRecommendationFeedbackPaginator.ts index b3d3adbd37476..33a3a5b58529c 100644 --- a/clients/client-codeguru-reviewer/pagination/ListRecommendationFeedbackPaginator.ts +++ b/clients/client-codeguru-reviewer/pagination/ListRecommendationFeedbackPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeGuruReviewerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeGuruReviewerClient, input: ListRecommendationFeedbackCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRecommendationFeedbackCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeGuruReviewer, input: ListRecommendationFeedbackCommandInput, diff --git a/clients/client-codeguru-reviewer/pagination/ListRecommendationsPaginator.ts b/clients/client-codeguru-reviewer/pagination/ListRecommendationsPaginator.ts index f198f1e6520c4..43641f0ca581f 100644 --- a/clients/client-codeguru-reviewer/pagination/ListRecommendationsPaginator.ts +++ b/clients/client-codeguru-reviewer/pagination/ListRecommendationsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeGuruReviewerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeGuruReviewerClient, input: ListRecommendationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRecommendationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeGuruReviewer, input: ListRecommendationsCommandInput, diff --git a/clients/client-codeguru-reviewer/pagination/ListRepositoryAssociationsPaginator.ts b/clients/client-codeguru-reviewer/pagination/ListRepositoryAssociationsPaginator.ts index a64a82f790f8a..b6f1ec70997ba 100644 --- a/clients/client-codeguru-reviewer/pagination/ListRepositoryAssociationsPaginator.ts +++ b/clients/client-codeguru-reviewer/pagination/ListRepositoryAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeGuruReviewerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeGuruReviewerClient, input: ListRepositoryAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRepositoryAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeGuruReviewer, input: ListRepositoryAssociationsCommandInput, diff --git a/clients/client-codeguru-reviewer/runtimeConfig.browser.ts b/clients/client-codeguru-reviewer/runtimeConfig.browser.ts index fe04d14516366..f384396a2eb2a 100644 --- a/clients/client-codeguru-reviewer/runtimeConfig.browser.ts +++ b/clients/client-codeguru-reviewer/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodeGuruReviewerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codeguru-reviewer/runtimeConfig.native.ts b/clients/client-codeguru-reviewer/runtimeConfig.native.ts index 8406bbd49ac15..bf811af49660d 100644 --- a/clients/client-codeguru-reviewer/runtimeConfig.native.ts +++ b/clients/client-codeguru-reviewer/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodeGuruReviewerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codeguru-reviewer/runtimeConfig.shared.ts b/clients/client-codeguru-reviewer/runtimeConfig.shared.ts index 1740372860c4c..f9d76a2054e59 100644 --- a/clients/client-codeguru-reviewer/runtimeConfig.shared.ts +++ b/clients/client-codeguru-reviewer/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-09-19", disableHostPrefix: false, diff --git a/clients/client-codeguru-reviewer/runtimeConfig.ts b/clients/client-codeguru-reviewer/runtimeConfig.ts index 68ff8bd0f1341..8660ac01b7d1c 100644 --- a/clients/client-codeguru-reviewer/runtimeConfig.ts +++ b/clients/client-codeguru-reviewer/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodeGuruReviewerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codeguru-reviewer/tsconfig.json b/clients/client-codeguru-reviewer/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codeguru-reviewer/tsconfig.json +++ b/clients/client-codeguru-reviewer/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codeguruprofiler/commands/ConfigureAgentCommand.ts b/clients/client-codeguruprofiler/commands/ConfigureAgentCommand.ts index 38453c85d4956..957d4137c5381 100644 --- a/clients/client-codeguruprofiler/commands/ConfigureAgentCommand.ts +++ b/clients/client-codeguruprofiler/commands/ConfigureAgentCommand.ts @@ -20,6 +20,9 @@ import { export type ConfigureAgentCommandInput = ConfigureAgentRequest; export type ConfigureAgentCommandOutput = ConfigureAgentResponse & __MetadataBearer; +/** + *

+ */ export class ConfigureAgentCommand extends $Command< ConfigureAgentCommandInput, ConfigureAgentCommandOutput, @@ -34,6 +37,9 @@ export class ConfigureAgentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/CreateProfilingGroupCommand.ts b/clients/client-codeguruprofiler/commands/CreateProfilingGroupCommand.ts index ba7178b74364e..752100bc18956 100644 --- a/clients/client-codeguruprofiler/commands/CreateProfilingGroupCommand.ts +++ b/clients/client-codeguruprofiler/commands/CreateProfilingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProfilingGroupCommandInput = CreateProfilingGroupRequest; export type CreateProfilingGroupCommandOutput = CreateProfilingGroupResponse & __MetadataBearer; +/** + *

Creates a profiling group.

+ */ export class CreateProfilingGroupCommand extends $Command< CreateProfilingGroupCommandInput, CreateProfilingGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateProfilingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/DeleteProfilingGroupCommand.ts b/clients/client-codeguruprofiler/commands/DeleteProfilingGroupCommand.ts index bb06edfbc06ec..51a08bfc884b7 100644 --- a/clients/client-codeguruprofiler/commands/DeleteProfilingGroupCommand.ts +++ b/clients/client-codeguruprofiler/commands/DeleteProfilingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProfilingGroupCommandInput = DeleteProfilingGroupRequest; export type DeleteProfilingGroupCommandOutput = DeleteProfilingGroupResponse & __MetadataBearer; +/** + *

Deletes a profiling group.

+ */ export class DeleteProfilingGroupCommand extends $Command< DeleteProfilingGroupCommandInput, DeleteProfilingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProfilingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/DescribeProfilingGroupCommand.ts b/clients/client-codeguruprofiler/commands/DescribeProfilingGroupCommand.ts index fd76e2ae06d1a..929c3aa9f0474 100644 --- a/clients/client-codeguruprofiler/commands/DescribeProfilingGroupCommand.ts +++ b/clients/client-codeguruprofiler/commands/DescribeProfilingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProfilingGroupCommandInput = DescribeProfilingGroupRequest; export type DescribeProfilingGroupCommandOutput = DescribeProfilingGroupResponse & __MetadataBearer; +/** + *

Describes a profiling group.

+ */ export class DescribeProfilingGroupCommand extends $Command< DescribeProfilingGroupCommandInput, DescribeProfilingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProfilingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/GetPolicyCommand.ts b/clients/client-codeguruprofiler/commands/GetPolicyCommand.ts index 20ebc4fc8ec5a..7b27f428f01da 100644 --- a/clients/client-codeguruprofiler/commands/GetPolicyCommand.ts +++ b/clients/client-codeguruprofiler/commands/GetPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetPolicyCommandInput = GetPolicyRequest; export type GetPolicyCommandOutput = GetPolicyResponse & __MetadataBearer; +/** + *

Gets the profiling group policy.

+ */ export class GetPolicyCommand extends $Command< GetPolicyCommandInput, GetPolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/GetProfileCommand.ts b/clients/client-codeguruprofiler/commands/GetProfileCommand.ts index 5e9796276c81f..725a69328a508 100644 --- a/clients/client-codeguruprofiler/commands/GetProfileCommand.ts +++ b/clients/client-codeguruprofiler/commands/GetProfileCommand.ts @@ -20,6 +20,19 @@ import { export type GetProfileCommandInput = GetProfileRequest; export type GetProfileCommandOutput = GetProfileResponse & __MetadataBearer; +/** + *

Gets the aggregated profile of a profiling group for the specified time range. + * If the requested time range does not align with the available aggregated profiles, it is expanded to + * attain alignment. If aggregated profiles are available only for part of the period requested, the + * profile is returned from the earliest available to the latest within the requested time range. + *

+ *

For example, if the requested time range is from 00:00 to 00:20 and the available profiles are + * from 00:15 to 00:25, the returned profile will be from 00:15 to 00:20. + *

+ *

You must specify exactly two of the following parameters: + * startTime, period, and endTime. + *

+ */ export class GetProfileCommand extends $Command< GetProfileCommandInput, GetProfileCommandOutput, @@ -34,6 +47,9 @@ export class GetProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/ListProfileTimesCommand.ts b/clients/client-codeguruprofiler/commands/ListProfileTimesCommand.ts index 6b9a6ebaa1bea..94a8a41c2b56c 100644 --- a/clients/client-codeguruprofiler/commands/ListProfileTimesCommand.ts +++ b/clients/client-codeguruprofiler/commands/ListProfileTimesCommand.ts @@ -20,6 +20,10 @@ import { export type ListProfileTimesCommandInput = ListProfileTimesRequest; export type ListProfileTimesCommandOutput = ListProfileTimesResponse & __MetadataBearer; +/** + *

List the start times of the available aggregated profiles of a profiling group + * for an aggregation period within the specified time range.

+ */ export class ListProfileTimesCommand extends $Command< ListProfileTimesCommandInput, ListProfileTimesCommandOutput, @@ -34,6 +38,9 @@ export class ListProfileTimesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/ListProfilingGroupsCommand.ts b/clients/client-codeguruprofiler/commands/ListProfilingGroupsCommand.ts index 7952e02ac8aab..37b0b8b0f592b 100644 --- a/clients/client-codeguruprofiler/commands/ListProfilingGroupsCommand.ts +++ b/clients/client-codeguruprofiler/commands/ListProfilingGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProfilingGroupsCommandInput = ListProfilingGroupsRequest; export type ListProfilingGroupsCommandOutput = ListProfilingGroupsResponse & __MetadataBearer; +/** + *

Lists profiling groups.

+ */ export class ListProfilingGroupsCommand extends $Command< ListProfilingGroupsCommandInput, ListProfilingGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListProfilingGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/PostAgentProfileCommand.ts b/clients/client-codeguruprofiler/commands/PostAgentProfileCommand.ts index ee7bf65174969..b90a724ec5789 100644 --- a/clients/client-codeguruprofiler/commands/PostAgentProfileCommand.ts +++ b/clients/client-codeguruprofiler/commands/PostAgentProfileCommand.ts @@ -20,6 +20,9 @@ import { export type PostAgentProfileCommandInput = PostAgentProfileRequest; export type PostAgentProfileCommandOutput = PostAgentProfileResponse & __MetadataBearer; +/** + *

+ */ export class PostAgentProfileCommand extends $Command< PostAgentProfileCommandInput, PostAgentProfileCommandOutput, @@ -34,6 +37,9 @@ export class PostAgentProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/PutPermissionCommand.ts b/clients/client-codeguruprofiler/commands/PutPermissionCommand.ts index 25f7315e326f0..a3cc0b69de3fd 100644 --- a/clients/client-codeguruprofiler/commands/PutPermissionCommand.ts +++ b/clients/client-codeguruprofiler/commands/PutPermissionCommand.ts @@ -20,6 +20,10 @@ import { export type PutPermissionCommandInput = PutPermissionRequest; export type PutPermissionCommandOutput = PutPermissionResponse & __MetadataBearer; +/** + *

Provides permission to the principals. This overwrites the existing permissions, and + * is not additive.

+ */ export class PutPermissionCommand extends $Command< PutPermissionCommandInput, PutPermissionCommandOutput, @@ -34,6 +38,9 @@ export class PutPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/RemovePermissionCommand.ts b/clients/client-codeguruprofiler/commands/RemovePermissionCommand.ts index 264f58a70ae53..bbd986cc222d5 100644 --- a/clients/client-codeguruprofiler/commands/RemovePermissionCommand.ts +++ b/clients/client-codeguruprofiler/commands/RemovePermissionCommand.ts @@ -20,6 +20,9 @@ import { export type RemovePermissionCommandInput = RemovePermissionRequest; export type RemovePermissionCommandOutput = RemovePermissionResponse & __MetadataBearer; +/** + *

Removes statement for the provided action group from the policy.

+ */ export class RemovePermissionCommand extends $Command< RemovePermissionCommandInput, RemovePermissionCommandOutput, @@ -34,6 +37,9 @@ export class RemovePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/RetrieveTimeSeriesCommand.ts b/clients/client-codeguruprofiler/commands/RetrieveTimeSeriesCommand.ts index bf20ab42edda9..ecd23d9374d13 100644 --- a/clients/client-codeguruprofiler/commands/RetrieveTimeSeriesCommand.ts +++ b/clients/client-codeguruprofiler/commands/RetrieveTimeSeriesCommand.ts @@ -34,6 +34,9 @@ export class RetrieveTimeSeriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/commands/UpdateProfilingGroupCommand.ts b/clients/client-codeguruprofiler/commands/UpdateProfilingGroupCommand.ts index 96aa9c4280c2b..dad4ba5bad8f3 100644 --- a/clients/client-codeguruprofiler/commands/UpdateProfilingGroupCommand.ts +++ b/clients/client-codeguruprofiler/commands/UpdateProfilingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProfilingGroupCommandInput = UpdateProfilingGroupRequest; export type UpdateProfilingGroupCommandOutput = UpdateProfilingGroupResponse & __MetadataBearer; +/** + *

Updates a profiling group.

+ */ export class UpdateProfilingGroupCommand extends $Command< UpdateProfilingGroupCommandInput, UpdateProfilingGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProfilingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeGuruProfilerClientResolvedConfig, diff --git a/clients/client-codeguruprofiler/package.json b/clients/client-codeguruprofiler/package.json index 42b14251b29ae..f23ac06bd9762 100644 --- a/clients/client-codeguruprofiler/package.json +++ b/clients/client-codeguruprofiler/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codeguruprofiler Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codeguruprofiler/pagination/ListProfileTimesPaginator.ts b/clients/client-codeguruprofiler/pagination/ListProfileTimesPaginator.ts index b2789623a3308..afdc90bc912a9 100644 --- a/clients/client-codeguruprofiler/pagination/ListProfileTimesPaginator.ts +++ b/clients/client-codeguruprofiler/pagination/ListProfileTimesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeGuruProfilerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeGuruProfilerClient, input: ListProfileTimesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProfileTimesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeGuruProfiler, input: ListProfileTimesCommandInput, diff --git a/clients/client-codeguruprofiler/pagination/ListProfilingGroupsPaginator.ts b/clients/client-codeguruprofiler/pagination/ListProfilingGroupsPaginator.ts index a15ca42e1c1b4..de6b4bd690898 100644 --- a/clients/client-codeguruprofiler/pagination/ListProfilingGroupsPaginator.ts +++ b/clients/client-codeguruprofiler/pagination/ListProfilingGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeGuruProfilerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeGuruProfilerClient, input: ListProfilingGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProfilingGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeGuruProfiler, input: ListProfilingGroupsCommandInput, diff --git a/clients/client-codeguruprofiler/runtimeConfig.browser.ts b/clients/client-codeguruprofiler/runtimeConfig.browser.ts index 4712f7a986028..e4904045fc29c 100644 --- a/clients/client-codeguruprofiler/runtimeConfig.browser.ts +++ b/clients/client-codeguruprofiler/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodeGuruProfilerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codeguruprofiler/runtimeConfig.native.ts b/clients/client-codeguruprofiler/runtimeConfig.native.ts index 928b6355dc918..bb7df9fefa175 100644 --- a/clients/client-codeguruprofiler/runtimeConfig.native.ts +++ b/clients/client-codeguruprofiler/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodeGuruProfilerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codeguruprofiler/runtimeConfig.shared.ts b/clients/client-codeguruprofiler/runtimeConfig.shared.ts index 5a10be862596f..60b70977633c1 100644 --- a/clients/client-codeguruprofiler/runtimeConfig.shared.ts +++ b/clients/client-codeguruprofiler/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-07-18", disableHostPrefix: false, diff --git a/clients/client-codeguruprofiler/runtimeConfig.ts b/clients/client-codeguruprofiler/runtimeConfig.ts index b313c86e51331..71bb1c05f730a 100644 --- a/clients/client-codeguruprofiler/runtimeConfig.ts +++ b/clients/client-codeguruprofiler/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodeGuruProfilerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codeguruprofiler/tsconfig.json b/clients/client-codeguruprofiler/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codeguruprofiler/tsconfig.json +++ b/clients/client-codeguruprofiler/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codepipeline/commands/AcknowledgeJobCommand.ts b/clients/client-codepipeline/commands/AcknowledgeJobCommand.ts index adb05288be8b2..6d308f970706f 100644 --- a/clients/client-codepipeline/commands/AcknowledgeJobCommand.ts +++ b/clients/client-codepipeline/commands/AcknowledgeJobCommand.ts @@ -20,6 +20,10 @@ import { export type AcknowledgeJobCommandInput = AcknowledgeJobInput; export type AcknowledgeJobCommandOutput = AcknowledgeJobOutput & __MetadataBearer; +/** + *

Returns information about a specified job and whether that job has been received by + * the job worker. Used for custom actions only.

+ */ export class AcknowledgeJobCommand extends $Command< AcknowledgeJobCommandInput, AcknowledgeJobCommandOutput, @@ -34,6 +38,9 @@ export class AcknowledgeJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/AcknowledgeThirdPartyJobCommand.ts b/clients/client-codepipeline/commands/AcknowledgeThirdPartyJobCommand.ts index fe623f8f4b6a8..e4b62d1740e74 100644 --- a/clients/client-codepipeline/commands/AcknowledgeThirdPartyJobCommand.ts +++ b/clients/client-codepipeline/commands/AcknowledgeThirdPartyJobCommand.ts @@ -20,6 +20,10 @@ import { export type AcknowledgeThirdPartyJobCommandInput = AcknowledgeThirdPartyJobInput; export type AcknowledgeThirdPartyJobCommandOutput = AcknowledgeThirdPartyJobOutput & __MetadataBearer; +/** + *

Confirms a job worker has received the specified job. Used for partner actions + * only.

+ */ export class AcknowledgeThirdPartyJobCommand extends $Command< AcknowledgeThirdPartyJobCommandInput, AcknowledgeThirdPartyJobCommandOutput, @@ -34,6 +38,9 @@ export class AcknowledgeThirdPartyJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/CreateCustomActionTypeCommand.ts b/clients/client-codepipeline/commands/CreateCustomActionTypeCommand.ts index c72c21372b112..d5d1bef67543a 100644 --- a/clients/client-codepipeline/commands/CreateCustomActionTypeCommand.ts +++ b/clients/client-codepipeline/commands/CreateCustomActionTypeCommand.ts @@ -20,6 +20,10 @@ import { export type CreateCustomActionTypeCommandInput = CreateCustomActionTypeInput; export type CreateCustomActionTypeCommandOutput = CreateCustomActionTypeOutput & __MetadataBearer; +/** + *

Creates a new custom action that can be used in all pipelines associated with the + * AWS account. Only used for custom actions.

+ */ export class CreateCustomActionTypeCommand extends $Command< CreateCustomActionTypeCommandInput, CreateCustomActionTypeCommandOutput, @@ -34,6 +38,9 @@ export class CreateCustomActionTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/CreatePipelineCommand.ts b/clients/client-codepipeline/commands/CreatePipelineCommand.ts index 29e55868af5c1..0f061f6ae6bbb 100644 --- a/clients/client-codepipeline/commands/CreatePipelineCommand.ts +++ b/clients/client-codepipeline/commands/CreatePipelineCommand.ts @@ -20,6 +20,15 @@ import { export type CreatePipelineCommandInput = CreatePipelineInput; export type CreatePipelineCommandOutput = CreatePipelineOutput & __MetadataBearer; +/** + *

Creates a pipeline.

+ * + *

In the pipeline structure, you must include either artifactStore + * or artifactStores in your pipeline, but you cannot use both. If you + * create a cross-region action in your pipeline, you must use + * artifactStores.

+ *
+ */ export class CreatePipelineCommand extends $Command< CreatePipelineCommandInput, CreatePipelineCommandOutput, @@ -34,6 +43,9 @@ export class CreatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/DeleteCustomActionTypeCommand.ts b/clients/client-codepipeline/commands/DeleteCustomActionTypeCommand.ts index c21445d5a5983..5735900feb2cd 100644 --- a/clients/client-codepipeline/commands/DeleteCustomActionTypeCommand.ts +++ b/clients/client-codepipeline/commands/DeleteCustomActionTypeCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteCustomActionTypeCommandInput = DeleteCustomActionTypeInput; export type DeleteCustomActionTypeCommandOutput = __MetadataBearer; +/** + *

Marks a custom action as deleted. PollForJobs for the custom action + * fails after the action is marked for deletion. Used for custom actions only.

+ * + *

To re-create a custom action after it has been deleted you must use a string in + * the version field that has never been used before. This string can be an incremented + * version number, for example. To restore a deleted custom action, use a JSON file + * that is identical to the deleted action, including the original string in the + * version field.

+ *
+ */ export class DeleteCustomActionTypeCommand extends $Command< DeleteCustomActionTypeCommandInput, DeleteCustomActionTypeCommandOutput, @@ -34,6 +45,9 @@ export class DeleteCustomActionTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/DeletePipelineCommand.ts b/clients/client-codepipeline/commands/DeletePipelineCommand.ts index 9e785834355b2..ce8e06eff7b26 100644 --- a/clients/client-codepipeline/commands/DeletePipelineCommand.ts +++ b/clients/client-codepipeline/commands/DeletePipelineCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePipelineCommandInput = DeletePipelineInput; export type DeletePipelineCommandOutput = __MetadataBearer; +/** + *

Deletes the specified pipeline.

+ */ export class DeletePipelineCommand extends $Command< DeletePipelineCommandInput, DeletePipelineCommandOutput, @@ -34,6 +37,9 @@ export class DeletePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/DeleteWebhookCommand.ts b/clients/client-codepipeline/commands/DeleteWebhookCommand.ts index bba006b9d86c4..26cf92cfadb68 100644 --- a/clients/client-codepipeline/commands/DeleteWebhookCommand.ts +++ b/clients/client-codepipeline/commands/DeleteWebhookCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteWebhookCommandInput = DeleteWebhookInput; export type DeleteWebhookCommandOutput = DeleteWebhookOutput & __MetadataBearer; +/** + *

Deletes a previously created webhook by name. Deleting the webhook stops AWS + * CodePipeline from starting a pipeline every time an external event occurs. The API + * returns successfully when trying to delete a webhook that is already deleted. If a + * deleted webhook is re-created by calling PutWebhook with the same name, it will have a + * different URL.

+ */ export class DeleteWebhookCommand extends $Command< DeleteWebhookCommandInput, DeleteWebhookCommandOutput, @@ -34,6 +41,9 @@ export class DeleteWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/DeregisterWebhookWithThirdPartyCommand.ts b/clients/client-codepipeline/commands/DeregisterWebhookWithThirdPartyCommand.ts index 7ef75766228ec..53029651d9ffb 100644 --- a/clients/client-codepipeline/commands/DeregisterWebhookWithThirdPartyCommand.ts +++ b/clients/client-codepipeline/commands/DeregisterWebhookWithThirdPartyCommand.ts @@ -20,6 +20,11 @@ import { export type DeregisterWebhookWithThirdPartyCommandInput = DeregisterWebhookWithThirdPartyInput; export type DeregisterWebhookWithThirdPartyCommandOutput = DeregisterWebhookWithThirdPartyOutput & __MetadataBearer; +/** + *

Removes the connection between the webhook that was created by CodePipeline and the + * external tool with events to be detected. Currently supported only for webhooks that + * target an action type of GitHub.

+ */ export class DeregisterWebhookWithThirdPartyCommand extends $Command< DeregisterWebhookWithThirdPartyCommandInput, DeregisterWebhookWithThirdPartyCommandOutput, @@ -34,6 +39,9 @@ export class DeregisterWebhookWithThirdPartyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/DisableStageTransitionCommand.ts b/clients/client-codepipeline/commands/DisableStageTransitionCommand.ts index 975bcd5537dc4..659dfbeb8d31d 100644 --- a/clients/client-codepipeline/commands/DisableStageTransitionCommand.ts +++ b/clients/client-codepipeline/commands/DisableStageTransitionCommand.ts @@ -20,6 +20,10 @@ import { export type DisableStageTransitionCommandInput = DisableStageTransitionInput; export type DisableStageTransitionCommandOutput = __MetadataBearer; +/** + *

Prevents artifacts in a pipeline from transitioning to the next stage in the + * pipeline.

+ */ export class DisableStageTransitionCommand extends $Command< DisableStageTransitionCommandInput, DisableStageTransitionCommandOutput, @@ -34,6 +38,9 @@ export class DisableStageTransitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/EnableStageTransitionCommand.ts b/clients/client-codepipeline/commands/EnableStageTransitionCommand.ts index 42a5c1e2e1d2e..350601887b8af 100644 --- a/clients/client-codepipeline/commands/EnableStageTransitionCommand.ts +++ b/clients/client-codepipeline/commands/EnableStageTransitionCommand.ts @@ -20,6 +20,9 @@ import { export type EnableStageTransitionCommandInput = EnableStageTransitionInput; export type EnableStageTransitionCommandOutput = __MetadataBearer; +/** + *

Enables artifacts in a pipeline to transition to a stage in a pipeline.

+ */ export class EnableStageTransitionCommand extends $Command< EnableStageTransitionCommandInput, EnableStageTransitionCommandOutput, @@ -34,6 +37,9 @@ export class EnableStageTransitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/GetJobDetailsCommand.ts b/clients/client-codepipeline/commands/GetJobDetailsCommand.ts index cd4044bb4480e..871780bd934f8 100644 --- a/clients/client-codepipeline/commands/GetJobDetailsCommand.ts +++ b/clients/client-codepipeline/commands/GetJobDetailsCommand.ts @@ -20,6 +20,15 @@ import { export type GetJobDetailsCommandInput = GetJobDetailsInput; export type GetJobDetailsCommandOutput = GetJobDetailsOutput & __MetadataBearer; +/** + *

Returns information about a job. Used for custom actions only.

+ * + *

When this API is called, AWS CodePipeline returns temporary credentials for the + * S3 bucket used to store artifacts for the pipeline, if the action requires access to + * that S3 bucket for input or output artifacts. This API also returns any secret + * values defined for the action.

+ *
+ */ export class GetJobDetailsCommand extends $Command< GetJobDetailsCommandInput, GetJobDetailsCommandOutput, @@ -34,6 +43,9 @@ export class GetJobDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/GetPipelineCommand.ts b/clients/client-codepipeline/commands/GetPipelineCommand.ts index 8ce2f604d1358..59805aebd5167 100644 --- a/clients/client-codepipeline/commands/GetPipelineCommand.ts +++ b/clients/client-codepipeline/commands/GetPipelineCommand.ts @@ -20,6 +20,11 @@ import { export type GetPipelineCommandInput = GetPipelineInput; export type GetPipelineCommandOutput = GetPipelineOutput & __MetadataBearer; +/** + *

Returns the metadata, structure, stages, and actions of a pipeline. Can be used to + * return the entire structure of a pipeline in JSON format, which can then be modified and + * used to update the pipeline structure with UpdatePipeline.

+ */ export class GetPipelineCommand extends $Command< GetPipelineCommandInput, GetPipelineCommandOutput, @@ -34,6 +39,9 @@ export class GetPipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/GetPipelineExecutionCommand.ts b/clients/client-codepipeline/commands/GetPipelineExecutionCommand.ts index 323c61be67116..5e48a6cbafd57 100644 --- a/clients/client-codepipeline/commands/GetPipelineExecutionCommand.ts +++ b/clients/client-codepipeline/commands/GetPipelineExecutionCommand.ts @@ -20,6 +20,11 @@ import { export type GetPipelineExecutionCommandInput = GetPipelineExecutionInput; export type GetPipelineExecutionCommandOutput = GetPipelineExecutionOutput & __MetadataBearer; +/** + *

Returns information about an execution of a pipeline, including details about + * artifacts, the pipeline execution ID, and the name, version, and status of the + * pipeline.

+ */ export class GetPipelineExecutionCommand extends $Command< GetPipelineExecutionCommandInput, GetPipelineExecutionCommandOutput, @@ -34,6 +39,9 @@ export class GetPipelineExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/GetPipelineStateCommand.ts b/clients/client-codepipeline/commands/GetPipelineStateCommand.ts index 5b69b568bb750..fdfc8e64bd4c8 100644 --- a/clients/client-codepipeline/commands/GetPipelineStateCommand.ts +++ b/clients/client-codepipeline/commands/GetPipelineStateCommand.ts @@ -20,6 +20,15 @@ import { export type GetPipelineStateCommandInput = GetPipelineStateInput; export type GetPipelineStateCommandOutput = GetPipelineStateOutput & __MetadataBearer; +/** + *

Returns information about the state of a pipeline, including the stages and + * actions.

+ * + *

Values returned in the revisionId and revisionUrl + * fields indicate the source revision information, such as the commit ID, for the + * current state.

+ *
+ */ export class GetPipelineStateCommand extends $Command< GetPipelineStateCommandInput, GetPipelineStateCommandOutput, @@ -34,6 +43,9 @@ export class GetPipelineStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/GetThirdPartyJobDetailsCommand.ts b/clients/client-codepipeline/commands/GetThirdPartyJobDetailsCommand.ts index c44e9eb46dcce..39338e1bbe02d 100644 --- a/clients/client-codepipeline/commands/GetThirdPartyJobDetailsCommand.ts +++ b/clients/client-codepipeline/commands/GetThirdPartyJobDetailsCommand.ts @@ -20,6 +20,16 @@ import { export type GetThirdPartyJobDetailsCommandInput = GetThirdPartyJobDetailsInput; export type GetThirdPartyJobDetailsCommandOutput = GetThirdPartyJobDetailsOutput & __MetadataBearer; +/** + *

Requests the details of a job for a third party action. Used for partner actions + * only.

+ * + *

When this API is called, AWS CodePipeline returns temporary credentials for the + * S3 bucket used to store artifacts for the pipeline, if the action requires access to + * that S3 bucket for input or output artifacts. This API also returns any secret + * values defined for the action.

+ *
+ */ export class GetThirdPartyJobDetailsCommand extends $Command< GetThirdPartyJobDetailsCommandInput, GetThirdPartyJobDetailsCommandOutput, @@ -34,6 +44,9 @@ export class GetThirdPartyJobDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/ListActionExecutionsCommand.ts b/clients/client-codepipeline/commands/ListActionExecutionsCommand.ts index c48930d47f8b7..2908d382baf12 100644 --- a/clients/client-codepipeline/commands/ListActionExecutionsCommand.ts +++ b/clients/client-codepipeline/commands/ListActionExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListActionExecutionsCommandInput = ListActionExecutionsInput; export type ListActionExecutionsCommandOutput = ListActionExecutionsOutput & __MetadataBearer; +/** + *

Lists the action executions that have occurred in a pipeline.

+ */ export class ListActionExecutionsCommand extends $Command< ListActionExecutionsCommandInput, ListActionExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class ListActionExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/ListActionTypesCommand.ts b/clients/client-codepipeline/commands/ListActionTypesCommand.ts index 78e6fc3aa15af..0877e4e7970d8 100644 --- a/clients/client-codepipeline/commands/ListActionTypesCommand.ts +++ b/clients/client-codepipeline/commands/ListActionTypesCommand.ts @@ -20,6 +20,10 @@ import { export type ListActionTypesCommandInput = ListActionTypesInput; export type ListActionTypesCommandOutput = ListActionTypesOutput & __MetadataBearer; +/** + *

Gets a summary of all AWS CodePipeline action types associated with your + * account.

+ */ export class ListActionTypesCommand extends $Command< ListActionTypesCommandInput, ListActionTypesCommandOutput, @@ -34,6 +38,9 @@ export class ListActionTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/ListPipelineExecutionsCommand.ts b/clients/client-codepipeline/commands/ListPipelineExecutionsCommand.ts index 888c79dd76963..845ee8402f6dc 100644 --- a/clients/client-codepipeline/commands/ListPipelineExecutionsCommand.ts +++ b/clients/client-codepipeline/commands/ListPipelineExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPipelineExecutionsCommandInput = ListPipelineExecutionsInput; export type ListPipelineExecutionsCommandOutput = ListPipelineExecutionsOutput & __MetadataBearer; +/** + *

Gets a summary of the most recent executions for a pipeline.

+ */ export class ListPipelineExecutionsCommand extends $Command< ListPipelineExecutionsCommandInput, ListPipelineExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class ListPipelineExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/ListPipelinesCommand.ts b/clients/client-codepipeline/commands/ListPipelinesCommand.ts index 1083446e4ae9b..10d08e29eda54 100644 --- a/clients/client-codepipeline/commands/ListPipelinesCommand.ts +++ b/clients/client-codepipeline/commands/ListPipelinesCommand.ts @@ -20,6 +20,9 @@ import { export type ListPipelinesCommandInput = ListPipelinesInput; export type ListPipelinesCommandOutput = ListPipelinesOutput & __MetadataBearer; +/** + *

Gets a summary of all of the pipelines associated with your account.

+ */ export class ListPipelinesCommand extends $Command< ListPipelinesCommandInput, ListPipelinesCommandOutput, @@ -34,6 +37,9 @@ export class ListPipelinesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/ListTagsForResourceCommand.ts b/clients/client-codepipeline/commands/ListTagsForResourceCommand.ts index 1ae8d54c7b09e..017f464e4e563 100644 --- a/clients/client-codepipeline/commands/ListTagsForResourceCommand.ts +++ b/clients/client-codepipeline/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Gets the set of key-value pairs (metadata) that are used to manage the + * resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/ListWebhooksCommand.ts b/clients/client-codepipeline/commands/ListWebhooksCommand.ts index 8432dad880f1f..b6f83086fc377 100644 --- a/clients/client-codepipeline/commands/ListWebhooksCommand.ts +++ b/clients/client-codepipeline/commands/ListWebhooksCommand.ts @@ -20,6 +20,11 @@ import { export type ListWebhooksCommandInput = ListWebhooksInput; export type ListWebhooksCommandOutput = ListWebhooksOutput & __MetadataBearer; +/** + *

Gets a listing of all the webhooks in this AWS Region for this account. The output + * lists all webhooks and includes the webhook URL and ARN and the configuration for each + * webhook.

+ */ export class ListWebhooksCommand extends $Command< ListWebhooksCommandInput, ListWebhooksCommandOutput, @@ -34,6 +39,9 @@ export class ListWebhooksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PollForJobsCommand.ts b/clients/client-codepipeline/commands/PollForJobsCommand.ts index 540fd6b40924f..e0372f8d940d5 100644 --- a/clients/client-codepipeline/commands/PollForJobsCommand.ts +++ b/clients/client-codepipeline/commands/PollForJobsCommand.ts @@ -20,6 +20,18 @@ import { export type PollForJobsCommandInput = PollForJobsInput; export type PollForJobsCommandOutput = PollForJobsOutput & __MetadataBearer; +/** + *

Returns information about any jobs for AWS CodePipeline to act on. + * PollForJobs is valid only for action types with "Custom" in the owner + * field. If the action type contains "AWS" or "ThirdParty" in the owner field, the + * PollForJobs action returns an error.

+ * + *

When this API is called, AWS CodePipeline returns temporary credentials for the + * S3 bucket used to store artifacts for the pipeline, if the action requires access to + * that S3 bucket for input or output artifacts. This API also returns any secret + * values defined for the action.

+ *
+ */ export class PollForJobsCommand extends $Command< PollForJobsCommandInput, PollForJobsCommandOutput, @@ -34,6 +46,9 @@ export class PollForJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PollForThirdPartyJobsCommand.ts b/clients/client-codepipeline/commands/PollForThirdPartyJobsCommand.ts index 9e1e41c4d9693..6f8b579d6e111 100644 --- a/clients/client-codepipeline/commands/PollForThirdPartyJobsCommand.ts +++ b/clients/client-codepipeline/commands/PollForThirdPartyJobsCommand.ts @@ -20,6 +20,15 @@ import { export type PollForThirdPartyJobsCommandInput = PollForThirdPartyJobsInput; export type PollForThirdPartyJobsCommandOutput = PollForThirdPartyJobsOutput & __MetadataBearer; +/** + *

Determines whether there are any third party jobs for a job worker to act on. Used + * for partner actions only.

+ * + *

When this API is called, AWS CodePipeline returns temporary credentials for the + * S3 bucket used to store artifacts for the pipeline, if the action requires access to + * that S3 bucket for input or output artifacts.

+ *
+ */ export class PollForThirdPartyJobsCommand extends $Command< PollForThirdPartyJobsCommandInput, PollForThirdPartyJobsCommandOutput, @@ -34,6 +43,9 @@ export class PollForThirdPartyJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PutActionRevisionCommand.ts b/clients/client-codepipeline/commands/PutActionRevisionCommand.ts index 17796c6e2dcd1..7c7dcd34cc657 100644 --- a/clients/client-codepipeline/commands/PutActionRevisionCommand.ts +++ b/clients/client-codepipeline/commands/PutActionRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type PutActionRevisionCommandInput = PutActionRevisionInput; export type PutActionRevisionCommandOutput = PutActionRevisionOutput & __MetadataBearer; +/** + *

Provides information to AWS CodePipeline about new revisions to a source.

+ */ export class PutActionRevisionCommand extends $Command< PutActionRevisionCommandInput, PutActionRevisionCommandOutput, @@ -34,6 +37,9 @@ export class PutActionRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PutApprovalResultCommand.ts b/clients/client-codepipeline/commands/PutApprovalResultCommand.ts index 0b515acb79733..794fc4f9e5e79 100644 --- a/clients/client-codepipeline/commands/PutApprovalResultCommand.ts +++ b/clients/client-codepipeline/commands/PutApprovalResultCommand.ts @@ -20,6 +20,10 @@ import { export type PutApprovalResultCommandInput = PutApprovalResultInput; export type PutApprovalResultCommandOutput = PutApprovalResultOutput & __MetadataBearer; +/** + *

Provides the response to a manual approval request to AWS CodePipeline. Valid + * responses include Approved and Rejected.

+ */ export class PutApprovalResultCommand extends $Command< PutApprovalResultCommandInput, PutApprovalResultCommandOutput, @@ -34,6 +38,9 @@ export class PutApprovalResultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PutJobFailureResultCommand.ts b/clients/client-codepipeline/commands/PutJobFailureResultCommand.ts index 930953d36f5ed..999e7a21b3077 100644 --- a/clients/client-codepipeline/commands/PutJobFailureResultCommand.ts +++ b/clients/client-codepipeline/commands/PutJobFailureResultCommand.ts @@ -20,6 +20,10 @@ import { export type PutJobFailureResultCommandInput = PutJobFailureResultInput; export type PutJobFailureResultCommandOutput = __MetadataBearer; +/** + *

Represents the failure of a job as returned to the pipeline by a job worker. Used + * for custom actions only.

+ */ export class PutJobFailureResultCommand extends $Command< PutJobFailureResultCommandInput, PutJobFailureResultCommandOutput, @@ -34,6 +38,9 @@ export class PutJobFailureResultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PutJobSuccessResultCommand.ts b/clients/client-codepipeline/commands/PutJobSuccessResultCommand.ts index 6660ccb73531e..1de38d39a5e83 100644 --- a/clients/client-codepipeline/commands/PutJobSuccessResultCommand.ts +++ b/clients/client-codepipeline/commands/PutJobSuccessResultCommand.ts @@ -20,6 +20,10 @@ import { export type PutJobSuccessResultCommandInput = PutJobSuccessResultInput; export type PutJobSuccessResultCommandOutput = __MetadataBearer; +/** + *

Represents the success of a job as returned to the pipeline by a job worker. Used + * for custom actions only.

+ */ export class PutJobSuccessResultCommand extends $Command< PutJobSuccessResultCommandInput, PutJobSuccessResultCommandOutput, @@ -34,6 +38,9 @@ export class PutJobSuccessResultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PutThirdPartyJobFailureResultCommand.ts b/clients/client-codepipeline/commands/PutThirdPartyJobFailureResultCommand.ts index c2a7ad0d03140..4e449140bc4eb 100644 --- a/clients/client-codepipeline/commands/PutThirdPartyJobFailureResultCommand.ts +++ b/clients/client-codepipeline/commands/PutThirdPartyJobFailureResultCommand.ts @@ -20,6 +20,10 @@ import { export type PutThirdPartyJobFailureResultCommandInput = PutThirdPartyJobFailureResultInput; export type PutThirdPartyJobFailureResultCommandOutput = __MetadataBearer; +/** + *

Represents the failure of a third party job as returned to the pipeline by a job + * worker. Used for partner actions only.

+ */ export class PutThirdPartyJobFailureResultCommand extends $Command< PutThirdPartyJobFailureResultCommandInput, PutThirdPartyJobFailureResultCommandOutput, @@ -34,6 +38,9 @@ export class PutThirdPartyJobFailureResultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PutThirdPartyJobSuccessResultCommand.ts b/clients/client-codepipeline/commands/PutThirdPartyJobSuccessResultCommand.ts index 0c4f54cda2139..d7b22eecb2ac4 100644 --- a/clients/client-codepipeline/commands/PutThirdPartyJobSuccessResultCommand.ts +++ b/clients/client-codepipeline/commands/PutThirdPartyJobSuccessResultCommand.ts @@ -20,6 +20,10 @@ import { export type PutThirdPartyJobSuccessResultCommandInput = PutThirdPartyJobSuccessResultInput; export type PutThirdPartyJobSuccessResultCommandOutput = __MetadataBearer; +/** + *

Represents the success of a third party job as returned to the pipeline by a job + * worker. Used for partner actions only.

+ */ export class PutThirdPartyJobSuccessResultCommand extends $Command< PutThirdPartyJobSuccessResultCommandInput, PutThirdPartyJobSuccessResultCommandOutput, @@ -34,6 +38,9 @@ export class PutThirdPartyJobSuccessResultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/PutWebhookCommand.ts b/clients/client-codepipeline/commands/PutWebhookCommand.ts index 69056de62e9c6..29e83a695f196 100644 --- a/clients/client-codepipeline/commands/PutWebhookCommand.ts +++ b/clients/client-codepipeline/commands/PutWebhookCommand.ts @@ -20,6 +20,15 @@ import { export type PutWebhookCommandInput = PutWebhookInput; export type PutWebhookCommandOutput = PutWebhookOutput & __MetadataBearer; +/** + *

Defines a webhook and returns a unique webhook URL generated by CodePipeline. This + * URL can be supplied to third party source hosting providers to call every time there's a + * code change. When CodePipeline receives a POST request on this URL, the pipeline defined + * in the webhook is started as long as the POST request satisfied the authentication and + * filtering requirements supplied when defining the webhook. RegisterWebhookWithThirdParty + * and DeregisterWebhookWithThirdParty APIs can be used to automatically configure + * supported third parties to call the generated webhook URL.

+ */ export class PutWebhookCommand extends $Command< PutWebhookCommandInput, PutWebhookCommandOutput, @@ -34,6 +43,9 @@ export class PutWebhookCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/RegisterWebhookWithThirdPartyCommand.ts b/clients/client-codepipeline/commands/RegisterWebhookWithThirdPartyCommand.ts index 7e9781fde9abe..cca27eadabaf2 100644 --- a/clients/client-codepipeline/commands/RegisterWebhookWithThirdPartyCommand.ts +++ b/clients/client-codepipeline/commands/RegisterWebhookWithThirdPartyCommand.ts @@ -20,6 +20,10 @@ import { export type RegisterWebhookWithThirdPartyCommandInput = RegisterWebhookWithThirdPartyInput; export type RegisterWebhookWithThirdPartyCommandOutput = RegisterWebhookWithThirdPartyOutput & __MetadataBearer; +/** + *

Configures a connection between the webhook that was created and the external tool + * with events to be detected.

+ */ export class RegisterWebhookWithThirdPartyCommand extends $Command< RegisterWebhookWithThirdPartyCommandInput, RegisterWebhookWithThirdPartyCommandOutput, @@ -34,6 +38,9 @@ export class RegisterWebhookWithThirdPartyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/RetryStageExecutionCommand.ts b/clients/client-codepipeline/commands/RetryStageExecutionCommand.ts index 66cd9bf7740e1..28cda582decd3 100644 --- a/clients/client-codepipeline/commands/RetryStageExecutionCommand.ts +++ b/clients/client-codepipeline/commands/RetryStageExecutionCommand.ts @@ -20,6 +20,12 @@ import { export type RetryStageExecutionCommandInput = RetryStageExecutionInput; export type RetryStageExecutionCommandOutput = RetryStageExecutionOutput & __MetadataBearer; +/** + *

Resumes the pipeline execution by retrying the last failed actions in a stage. You + * can retry a stage immediately if any of the actions in the stage fail. When you retry, + * all actions that are still in progress continue working, and failed actions are + * triggered again.

+ */ export class RetryStageExecutionCommand extends $Command< RetryStageExecutionCommandInput, RetryStageExecutionCommandOutput, @@ -34,6 +40,9 @@ export class RetryStageExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/StartPipelineExecutionCommand.ts b/clients/client-codepipeline/commands/StartPipelineExecutionCommand.ts index 653cb9e539b29..bdb4c55c9d341 100644 --- a/clients/client-codepipeline/commands/StartPipelineExecutionCommand.ts +++ b/clients/client-codepipeline/commands/StartPipelineExecutionCommand.ts @@ -20,6 +20,10 @@ import { export type StartPipelineExecutionCommandInput = StartPipelineExecutionInput; export type StartPipelineExecutionCommandOutput = StartPipelineExecutionOutput & __MetadataBearer; +/** + *

Starts the specified pipeline. Specifically, it begins processing the latest commit + * to the source location specified as part of the pipeline.

+ */ export class StartPipelineExecutionCommand extends $Command< StartPipelineExecutionCommandInput, StartPipelineExecutionCommandOutput, @@ -34,6 +38,9 @@ export class StartPipelineExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/StopPipelineExecutionCommand.ts b/clients/client-codepipeline/commands/StopPipelineExecutionCommand.ts index c904bf4dde247..149fb127d6031 100644 --- a/clients/client-codepipeline/commands/StopPipelineExecutionCommand.ts +++ b/clients/client-codepipeline/commands/StopPipelineExecutionCommand.ts @@ -20,6 +20,14 @@ import { export type StopPipelineExecutionCommandInput = StopPipelineExecutionInput; export type StopPipelineExecutionCommandOutput = StopPipelineExecutionOutput & __MetadataBearer; +/** + *

Stops the specified pipeline execution. You choose to either stop the pipeline + * execution by completing in-progress actions without starting subsequent actions, or by + * abandoning in-progress actions. While completing or abandoning in-progress actions, the + * pipeline execution is in a Stopping state. After all in-progress actions + * are completed or abandoned, the pipeline execution is in a Stopped + * state.

+ */ export class StopPipelineExecutionCommand extends $Command< StopPipelineExecutionCommandInput, StopPipelineExecutionCommandOutput, @@ -34,6 +42,9 @@ export class StopPipelineExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/TagResourceCommand.ts b/clients/client-codepipeline/commands/TagResourceCommand.ts index db207e8b6cc07..3a17ae8e8a309 100644 --- a/clients/client-codepipeline/commands/TagResourceCommand.ts +++ b/clients/client-codepipeline/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

Adds to or modifies the tags of the given resource. Tags are metadata that can be used + * to manage a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/UntagResourceCommand.ts b/clients/client-codepipeline/commands/UntagResourceCommand.ts index b5fbe2c7120dc..8ab9de640d2af 100644 --- a/clients/client-codepipeline/commands/UntagResourceCommand.ts +++ b/clients/client-codepipeline/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Removes tags from an AWS resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/commands/UpdatePipelineCommand.ts b/clients/client-codepipeline/commands/UpdatePipelineCommand.ts index 4dcb571852536..7ca6ccd116eeb 100644 --- a/clients/client-codepipeline/commands/UpdatePipelineCommand.ts +++ b/clients/client-codepipeline/commands/UpdatePipelineCommand.ts @@ -20,6 +20,12 @@ import { export type UpdatePipelineCommandInput = UpdatePipelineInput; export type UpdatePipelineCommandOutput = UpdatePipelineOutput & __MetadataBearer; +/** + *

Updates a specified pipeline with edits or changes to its structure. Use a JSON + * file with the pipeline structure and UpdatePipeline to provide the full + * structure of the pipeline. Updating the pipeline increases the version number of the + * pipeline by 1.

+ */ export class UpdatePipelineCommand extends $Command< UpdatePipelineCommandInput, UpdatePipelineCommandOutput, @@ -34,6 +40,9 @@ export class UpdatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodePipelineClientResolvedConfig, diff --git a/clients/client-codepipeline/package.json b/clients/client-codepipeline/package.json index d81f78a345357..2b057038641b6 100644 --- a/clients/client-codepipeline/package.json +++ b/clients/client-codepipeline/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codepipeline Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codepipeline/pagination/ListActionExecutionsPaginator.ts b/clients/client-codepipeline/pagination/ListActionExecutionsPaginator.ts index 8d017ed87c1d7..2c68dec34a051 100644 --- a/clients/client-codepipeline/pagination/ListActionExecutionsPaginator.ts +++ b/clients/client-codepipeline/pagination/ListActionExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodePipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodePipelineClient, input: ListActionExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListActionExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodePipeline, input: ListActionExecutionsCommandInput, diff --git a/clients/client-codepipeline/pagination/ListActionTypesPaginator.ts b/clients/client-codepipeline/pagination/ListActionTypesPaginator.ts index e47f27667acfa..cf3d430a2ed68 100644 --- a/clients/client-codepipeline/pagination/ListActionTypesPaginator.ts +++ b/clients/client-codepipeline/pagination/ListActionTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodePipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodePipelineClient, input: ListActionTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListActionTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodePipeline, input: ListActionTypesCommandInput, diff --git a/clients/client-codepipeline/pagination/ListPipelineExecutionsPaginator.ts b/clients/client-codepipeline/pagination/ListPipelineExecutionsPaginator.ts index 56f6858ebceeb..684e685ed5eb4 100644 --- a/clients/client-codepipeline/pagination/ListPipelineExecutionsPaginator.ts +++ b/clients/client-codepipeline/pagination/ListPipelineExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodePipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodePipelineClient, input: ListPipelineExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPipelineExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodePipeline, input: ListPipelineExecutionsCommandInput, diff --git a/clients/client-codepipeline/pagination/ListPipelinesPaginator.ts b/clients/client-codepipeline/pagination/ListPipelinesPaginator.ts index 24f2e6474ea3b..b7c5f9d575078 100644 --- a/clients/client-codepipeline/pagination/ListPipelinesPaginator.ts +++ b/clients/client-codepipeline/pagination/ListPipelinesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodePipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodePipelineClient, input: ListPipelinesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPipelinesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodePipeline, input: ListPipelinesCommandInput, diff --git a/clients/client-codepipeline/pagination/ListTagsForResourcePaginator.ts b/clients/client-codepipeline/pagination/ListTagsForResourcePaginator.ts index cd1186409acbc..1d4f3ffc474c2 100644 --- a/clients/client-codepipeline/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-codepipeline/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { CodePipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodePipelineClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodePipeline, input: ListTagsForResourceCommandInput, diff --git a/clients/client-codepipeline/pagination/ListWebhooksPaginator.ts b/clients/client-codepipeline/pagination/ListWebhooksPaginator.ts index 36a16d16e0d4e..ef940d9515351 100644 --- a/clients/client-codepipeline/pagination/ListWebhooksPaginator.ts +++ b/clients/client-codepipeline/pagination/ListWebhooksPaginator.ts @@ -8,6 +8,9 @@ import { import { CodePipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodePipelineClient, input: ListWebhooksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWebhooksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodePipeline, input: ListWebhooksCommandInput, diff --git a/clients/client-codepipeline/runtimeConfig.browser.ts b/clients/client-codepipeline/runtimeConfig.browser.ts index 612bc6d548fa5..39013d8bae41d 100644 --- a/clients/client-codepipeline/runtimeConfig.browser.ts +++ b/clients/client-codepipeline/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodePipelineClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codepipeline/runtimeConfig.native.ts b/clients/client-codepipeline/runtimeConfig.native.ts index cfbb1c1b75581..e95574d1e7b8d 100644 --- a/clients/client-codepipeline/runtimeConfig.native.ts +++ b/clients/client-codepipeline/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodePipelineClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codepipeline/runtimeConfig.shared.ts b/clients/client-codepipeline/runtimeConfig.shared.ts index 6b63596b154c9..8dbb748965f11 100644 --- a/clients/client-codepipeline/runtimeConfig.shared.ts +++ b/clients/client-codepipeline/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-07-09", disableHostPrefix: false, diff --git a/clients/client-codepipeline/runtimeConfig.ts b/clients/client-codepipeline/runtimeConfig.ts index d381209217a5b..03013d23ed5b0 100644 --- a/clients/client-codepipeline/runtimeConfig.ts +++ b/clients/client-codepipeline/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodePipelineClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codepipeline/tsconfig.json b/clients/client-codepipeline/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codepipeline/tsconfig.json +++ b/clients/client-codepipeline/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codestar-connections/commands/CreateConnectionCommand.ts b/clients/client-codestar-connections/commands/CreateConnectionCommand.ts index cd96f47d8ac2c..223b10159b9de 100644 --- a/clients/client-codestar-connections/commands/CreateConnectionCommand.ts +++ b/clients/client-codestar-connections/commands/CreateConnectionCommand.ts @@ -24,6 +24,11 @@ import { export type CreateConnectionCommandInput = CreateConnectionInput; export type CreateConnectionCommandOutput = CreateConnectionOutput & __MetadataBearer; +/** + *

Creates a connection that can then be given to other AWS services like CodePipeline so + * that it can access third-party code repositories. The connection is in pending status until + * the third-party connection handshake is completed from the console.

+ */ export class CreateConnectionCommand extends $Command< CreateConnectionCommandInput, CreateConnectionCommandOutput, @@ -38,6 +43,9 @@ export class CreateConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/CreateHostCommand.ts b/clients/client-codestar-connections/commands/CreateHostCommand.ts index 51d9e3336ef61..ab46f0eb54cdd 100644 --- a/clients/client-codestar-connections/commands/CreateHostCommand.ts +++ b/clients/client-codestar-connections/commands/CreateHostCommand.ts @@ -24,6 +24,16 @@ import { export type CreateHostCommandInput = CreateHostInput; export type CreateHostCommandOutput = CreateHostOutput & __MetadataBearer; +/** + *

Creates a resource that represents the infrastructure where a third-party provider is + * installed. The host is used when you create connections to an installed third-party provider + * type, such as GitHub Enterprise Server. You create one host for all connections to that + * provider.

+ * + *

A host created through the CLI or the SDK is in `PENDING` status by + * default. You can make its status `AVAILABLE` by setting up the host in the console.

+ *
+ */ export class CreateHostCommand extends $Command< CreateHostCommandInput, CreateHostCommandOutput, @@ -38,6 +48,9 @@ export class CreateHostCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/DeleteConnectionCommand.ts b/clients/client-codestar-connections/commands/DeleteConnectionCommand.ts index 0345d89315788..8299052f209f2 100644 --- a/clients/client-codestar-connections/commands/DeleteConnectionCommand.ts +++ b/clients/client-codestar-connections/commands/DeleteConnectionCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteConnectionCommandInput = DeleteConnectionInput; export type DeleteConnectionCommandOutput = DeleteConnectionOutput & __MetadataBearer; +/** + *

The connection to be deleted.

+ */ export class DeleteConnectionCommand extends $Command< DeleteConnectionCommandInput, DeleteConnectionCommandOutput, @@ -38,6 +41,9 @@ export class DeleteConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/DeleteHostCommand.ts b/clients/client-codestar-connections/commands/DeleteHostCommand.ts index f23fcb6717b14..f5b9658926022 100644 --- a/clients/client-codestar-connections/commands/DeleteHostCommand.ts +++ b/clients/client-codestar-connections/commands/DeleteHostCommand.ts @@ -24,6 +24,12 @@ import { export type DeleteHostCommandInput = DeleteHostInput; export type DeleteHostCommandOutput = DeleteHostOutput & __MetadataBearer; +/** + *

The host to be deleted. Before you delete a host, all connections associated to the host must be deleted.

+ * + *

A host cannot be deleted if it is in the VPC_CONFIG_INITIALIZING or VPC_CONFIG_DELETING state.

+ *
+ */ export class DeleteHostCommand extends $Command< DeleteHostCommandInput, DeleteHostCommandOutput, @@ -38,6 +44,9 @@ export class DeleteHostCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/GetConnectionCommand.ts b/clients/client-codestar-connections/commands/GetConnectionCommand.ts index 43224440bd3f3..92c2347fa2107 100644 --- a/clients/client-codestar-connections/commands/GetConnectionCommand.ts +++ b/clients/client-codestar-connections/commands/GetConnectionCommand.ts @@ -24,6 +24,9 @@ import { export type GetConnectionCommandInput = GetConnectionInput; export type GetConnectionCommandOutput = GetConnectionOutput & __MetadataBearer; +/** + *

Returns the connection ARN and details such as status, owner, and provider type.

+ */ export class GetConnectionCommand extends $Command< GetConnectionCommandInput, GetConnectionCommandOutput, @@ -38,6 +41,9 @@ export class GetConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/GetHostCommand.ts b/clients/client-codestar-connections/commands/GetHostCommand.ts index b3cfbf78f6655..1119f992845e8 100644 --- a/clients/client-codestar-connections/commands/GetHostCommand.ts +++ b/clients/client-codestar-connections/commands/GetHostCommand.ts @@ -21,6 +21,10 @@ import { export type GetHostCommandInput = GetHostInput; export type GetHostCommandOutput = GetHostOutput & __MetadataBearer; +/** + *

Returns the host ARN and details such as status, provider type, endpoint, and, if + * applicable, the VPC configuration.

+ */ export class GetHostCommand extends $Command< GetHostCommandInput, GetHostCommandOutput, @@ -35,6 +39,9 @@ export class GetHostCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/ListConnectionsCommand.ts b/clients/client-codestar-connections/commands/ListConnectionsCommand.ts index d6e85b6e6d56c..d95fd41b20a07 100644 --- a/clients/client-codestar-connections/commands/ListConnectionsCommand.ts +++ b/clients/client-codestar-connections/commands/ListConnectionsCommand.ts @@ -24,6 +24,9 @@ import { export type ListConnectionsCommandInput = ListConnectionsInput; export type ListConnectionsCommandOutput = ListConnectionsOutput & __MetadataBearer; +/** + *

Lists the connections associated with your account.

+ */ export class ListConnectionsCommand extends $Command< ListConnectionsCommandInput, ListConnectionsCommandOutput, @@ -38,6 +41,9 @@ export class ListConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/ListHostsCommand.ts b/clients/client-codestar-connections/commands/ListHostsCommand.ts index 9a85fefefadc8..b426a49db1376 100644 --- a/clients/client-codestar-connections/commands/ListHostsCommand.ts +++ b/clients/client-codestar-connections/commands/ListHostsCommand.ts @@ -21,6 +21,9 @@ import { export type ListHostsCommandInput = ListHostsInput; export type ListHostsCommandOutput = ListHostsOutput & __MetadataBearer; +/** + *

Lists the hosts associated with your account.

+ */ export class ListHostsCommand extends $Command< ListHostsCommandInput, ListHostsCommandOutput, @@ -35,6 +38,9 @@ export class ListHostsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/ListTagsForResourceCommand.ts b/clients/client-codestar-connections/commands/ListTagsForResourceCommand.ts index ad41f9adf5b6d..f485a519ae938 100644 --- a/clients/client-codestar-connections/commands/ListTagsForResourceCommand.ts +++ b/clients/client-codestar-connections/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Gets the set of key-value pairs (metadata) that are used to manage the resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +41,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/TagResourceCommand.ts b/clients/client-codestar-connections/commands/TagResourceCommand.ts index eba5dce05965a..0bf512f3706d2 100644 --- a/clients/client-codestar-connections/commands/TagResourceCommand.ts +++ b/clients/client-codestar-connections/commands/TagResourceCommand.ts @@ -24,6 +24,10 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

Adds to or modifies the tags of the given resource. Tags are metadata that can be used + * to manage a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +42,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/commands/UntagResourceCommand.ts b/clients/client-codestar-connections/commands/UntagResourceCommand.ts index cd7f999811986..2cef306e44b5a 100644 --- a/clients/client-codestar-connections/commands/UntagResourceCommand.ts +++ b/clients/client-codestar-connections/commands/UntagResourceCommand.ts @@ -24,6 +24,9 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Removes tags from an AWS resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +41,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarConnectionsClientResolvedConfig, diff --git a/clients/client-codestar-connections/package.json b/clients/client-codestar-connections/package.json index 6f5396a8d0e5c..a02bd59932a74 100644 --- a/clients/client-codestar-connections/package.json +++ b/clients/client-codestar-connections/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codestar Connections Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codestar-connections/pagination/ListConnectionsPaginator.ts b/clients/client-codestar-connections/pagination/ListConnectionsPaginator.ts index 28582409ecf39..96cc48406af47 100644 --- a/clients/client-codestar-connections/pagination/ListConnectionsPaginator.ts +++ b/clients/client-codestar-connections/pagination/ListConnectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CodeStarConnectionsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeStarConnectionsClient, input: ListConnectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConnectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeStarConnections, input: ListConnectionsCommandInput, diff --git a/clients/client-codestar-connections/pagination/ListHostsPaginator.ts b/clients/client-codestar-connections/pagination/ListHostsPaginator.ts index 12a4138ea4b30..0105e4cd96f1d 100644 --- a/clients/client-codestar-connections/pagination/ListHostsPaginator.ts +++ b/clients/client-codestar-connections/pagination/ListHostsPaginator.ts @@ -4,6 +4,9 @@ import { ListHostsCommand, ListHostsCommandInput, ListHostsCommandOutput } from import { CodeStarConnectionsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodeStarConnectionsClient, input: ListHostsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHostsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodeStarConnections, input: ListHostsCommandInput, diff --git a/clients/client-codestar-connections/runtimeConfig.browser.ts b/clients/client-codestar-connections/runtimeConfig.browser.ts index 87c06f9dea187..32dcbc4aa8603 100644 --- a/clients/client-codestar-connections/runtimeConfig.browser.ts +++ b/clients/client-codestar-connections/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodeStarConnectionsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codestar-connections/runtimeConfig.native.ts b/clients/client-codestar-connections/runtimeConfig.native.ts index ae170d9604b85..d39d0e088c449 100644 --- a/clients/client-codestar-connections/runtimeConfig.native.ts +++ b/clients/client-codestar-connections/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodeStarConnectionsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codestar-connections/runtimeConfig.shared.ts b/clients/client-codestar-connections/runtimeConfig.shared.ts index 6ea1b8d49cec5..a18ff12855d8b 100644 --- a/clients/client-codestar-connections/runtimeConfig.shared.ts +++ b/clients/client-codestar-connections/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-01", disableHostPrefix: false, diff --git a/clients/client-codestar-connections/runtimeConfig.ts b/clients/client-codestar-connections/runtimeConfig.ts index 015e769efeda2..0c91e40220db0 100644 --- a/clients/client-codestar-connections/runtimeConfig.ts +++ b/clients/client-codestar-connections/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodeStarConnectionsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codestar-connections/tsconfig.json b/clients/client-codestar-connections/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codestar-connections/tsconfig.json +++ b/clients/client-codestar-connections/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codestar-notifications/commands/CreateNotificationRuleCommand.ts b/clients/client-codestar-notifications/commands/CreateNotificationRuleCommand.ts index c66a8c2182e6e..97dd0af34bdce 100644 --- a/clients/client-codestar-notifications/commands/CreateNotificationRuleCommand.ts +++ b/clients/client-codestar-notifications/commands/CreateNotificationRuleCommand.ts @@ -24,6 +24,11 @@ import { export type CreateNotificationRuleCommandInput = CreateNotificationRuleRequest; export type CreateNotificationRuleCommandOutput = CreateNotificationRuleResult & __MetadataBearer; +/** + *

Creates a notification rule for a resource. The rule specifies the events you want + * notifications about and the targets (such as SNS topics) where you want to receive + * them.

+ */ export class CreateNotificationRuleCommand extends $Command< CreateNotificationRuleCommandInput, CreateNotificationRuleCommandOutput, @@ -38,6 +43,9 @@ export class CreateNotificationRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/DeleteNotificationRuleCommand.ts b/clients/client-codestar-notifications/commands/DeleteNotificationRuleCommand.ts index 2021eef992519..5aa4b2404ef8c 100644 --- a/clients/client-codestar-notifications/commands/DeleteNotificationRuleCommand.ts +++ b/clients/client-codestar-notifications/commands/DeleteNotificationRuleCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteNotificationRuleCommandInput = DeleteNotificationRuleRequest; export type DeleteNotificationRuleCommandOutput = DeleteNotificationRuleResult & __MetadataBearer; +/** + *

Deletes a notification rule for a resource.

+ */ export class DeleteNotificationRuleCommand extends $Command< DeleteNotificationRuleCommandInput, DeleteNotificationRuleCommandOutput, @@ -38,6 +41,9 @@ export class DeleteNotificationRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/DeleteTargetCommand.ts b/clients/client-codestar-notifications/commands/DeleteTargetCommand.ts index 7567e055d8d16..521b73388bce7 100644 --- a/clients/client-codestar-notifications/commands/DeleteTargetCommand.ts +++ b/clients/client-codestar-notifications/commands/DeleteTargetCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteTargetCommandInput = DeleteTargetRequest; export type DeleteTargetCommandOutput = DeleteTargetResult & __MetadataBearer; +/** + *

Deletes a specified target for notifications.

+ */ export class DeleteTargetCommand extends $Command< DeleteTargetCommandInput, DeleteTargetCommandOutput, @@ -38,6 +41,9 @@ export class DeleteTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/DescribeNotificationRuleCommand.ts b/clients/client-codestar-notifications/commands/DescribeNotificationRuleCommand.ts index 465d965fc26b3..95898a2f17335 100644 --- a/clients/client-codestar-notifications/commands/DescribeNotificationRuleCommand.ts +++ b/clients/client-codestar-notifications/commands/DescribeNotificationRuleCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeNotificationRuleCommandInput = DescribeNotificationRuleRequest; export type DescribeNotificationRuleCommandOutput = DescribeNotificationRuleResult & __MetadataBearer; +/** + *

Returns information about a specified notification rule.

+ */ export class DescribeNotificationRuleCommand extends $Command< DescribeNotificationRuleCommandInput, DescribeNotificationRuleCommandOutput, @@ -38,6 +41,9 @@ export class DescribeNotificationRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/ListEventTypesCommand.ts b/clients/client-codestar-notifications/commands/ListEventTypesCommand.ts index f3eadd383477b..953cf6625ab4f 100644 --- a/clients/client-codestar-notifications/commands/ListEventTypesCommand.ts +++ b/clients/client-codestar-notifications/commands/ListEventTypesCommand.ts @@ -24,6 +24,9 @@ import { export type ListEventTypesCommandInput = ListEventTypesRequest; export type ListEventTypesCommandOutput = ListEventTypesResult & __MetadataBearer; +/** + *

Returns information about the event types available for configuring notifications.

+ */ export class ListEventTypesCommand extends $Command< ListEventTypesCommandInput, ListEventTypesCommandOutput, @@ -38,6 +41,9 @@ export class ListEventTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/ListNotificationRulesCommand.ts b/clients/client-codestar-notifications/commands/ListNotificationRulesCommand.ts index 5c00c0bd9040c..6a7272860e2d9 100644 --- a/clients/client-codestar-notifications/commands/ListNotificationRulesCommand.ts +++ b/clients/client-codestar-notifications/commands/ListNotificationRulesCommand.ts @@ -24,6 +24,9 @@ import { export type ListNotificationRulesCommandInput = ListNotificationRulesRequest; export type ListNotificationRulesCommandOutput = ListNotificationRulesResult & __MetadataBearer; +/** + *

Returns a list of the notification rules for an AWS account.

+ */ export class ListNotificationRulesCommand extends $Command< ListNotificationRulesCommandInput, ListNotificationRulesCommandOutput, @@ -38,6 +41,9 @@ export class ListNotificationRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/ListTagsForResourceCommand.ts b/clients/client-codestar-notifications/commands/ListTagsForResourceCommand.ts index 357aeccb5a5e7..837209ab90cf0 100644 --- a/clients/client-codestar-notifications/commands/ListTagsForResourceCommand.ts +++ b/clients/client-codestar-notifications/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResult & __MetadataBearer; +/** + *

Returns a list of the tags associated with a notification rule.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +41,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/ListTargetsCommand.ts b/clients/client-codestar-notifications/commands/ListTargetsCommand.ts index c8117fe23a354..1f70439d30a94 100644 --- a/clients/client-codestar-notifications/commands/ListTargetsCommand.ts +++ b/clients/client-codestar-notifications/commands/ListTargetsCommand.ts @@ -24,6 +24,9 @@ import { export type ListTargetsCommandInput = ListTargetsRequest; export type ListTargetsCommandOutput = ListTargetsResult & __MetadataBearer; +/** + *

Returns a list of the notification rule targets for an AWS account.

+ */ export class ListTargetsCommand extends $Command< ListTargetsCommandInput, ListTargetsCommandOutput, @@ -38,6 +41,9 @@ export class ListTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/SubscribeCommand.ts b/clients/client-codestar-notifications/commands/SubscribeCommand.ts index f5cac5955bce6..487aa5db6ba2e 100644 --- a/clients/client-codestar-notifications/commands/SubscribeCommand.ts +++ b/clients/client-codestar-notifications/commands/SubscribeCommand.ts @@ -24,6 +24,11 @@ import { export type SubscribeCommandInput = SubscribeRequest; export type SubscribeCommandOutput = SubscribeResult & __MetadataBearer; +/** + *

Creates an association between a notification rule and an SNS topic so that the + * associated target can receive notifications when the events described in the rule are + * triggered.

+ */ export class SubscribeCommand extends $Command< SubscribeCommandInput, SubscribeCommandOutput, @@ -38,6 +43,9 @@ export class SubscribeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/TagResourceCommand.ts b/clients/client-codestar-notifications/commands/TagResourceCommand.ts index 8c50424725e99..c4826d69238ee 100644 --- a/clients/client-codestar-notifications/commands/TagResourceCommand.ts +++ b/clients/client-codestar-notifications/commands/TagResourceCommand.ts @@ -24,6 +24,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResult & __MetadataBearer; +/** + *

Associates a set of provided tags with a notification rule.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +41,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/UnsubscribeCommand.ts b/clients/client-codestar-notifications/commands/UnsubscribeCommand.ts index 7f84887ef027f..a7620449700d4 100644 --- a/clients/client-codestar-notifications/commands/UnsubscribeCommand.ts +++ b/clients/client-codestar-notifications/commands/UnsubscribeCommand.ts @@ -24,6 +24,11 @@ import { export type UnsubscribeCommandInput = UnsubscribeRequest; export type UnsubscribeCommandOutput = UnsubscribeResult & __MetadataBearer; +/** + *

Removes an association between a notification rule and an Amazon SNS topic so that + * subscribers to that topic stop receiving notifications when the events described in the + * rule are triggered.

+ */ export class UnsubscribeCommand extends $Command< UnsubscribeCommandInput, UnsubscribeCommandOutput, @@ -38,6 +43,9 @@ export class UnsubscribeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/UntagResourceCommand.ts b/clients/client-codestar-notifications/commands/UntagResourceCommand.ts index eebde50077863..7153b2566b2c6 100644 --- a/clients/client-codestar-notifications/commands/UntagResourceCommand.ts +++ b/clients/client-codestar-notifications/commands/UntagResourceCommand.ts @@ -24,6 +24,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResult & __MetadataBearer; +/** + *

Removes the association between one or more provided tags and a notification + * rule.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +42,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/commands/UpdateNotificationRuleCommand.ts b/clients/client-codestar-notifications/commands/UpdateNotificationRuleCommand.ts index 0714738300106..3fd27694c3b00 100644 --- a/clients/client-codestar-notifications/commands/UpdateNotificationRuleCommand.ts +++ b/clients/client-codestar-notifications/commands/UpdateNotificationRuleCommand.ts @@ -24,6 +24,14 @@ import { export type UpdateNotificationRuleCommandInput = UpdateNotificationRuleRequest; export type UpdateNotificationRuleCommandOutput = UpdateNotificationRuleResult & __MetadataBearer; +/** + *

Updates a notification rule for a resource. You can change the events that trigger the + * notification rule, the status of the rule, and the targets that receive the + * notifications.

+ * + *

To add or remove tags for a notification rule, you must use TagResource and UntagResource.

+ *
+ */ export class UpdateNotificationRuleCommand extends $Command< UpdateNotificationRuleCommandInput, UpdateNotificationRuleCommandOutput, @@ -38,6 +46,9 @@ export class UpdateNotificationRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodestarNotificationsClientResolvedConfig, diff --git a/clients/client-codestar-notifications/package.json b/clients/client-codestar-notifications/package.json index 0adb9e40c2119..44762964c622e 100644 --- a/clients/client-codestar-notifications/package.json +++ b/clients/client-codestar-notifications/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codestar Notifications Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codestar-notifications/pagination/ListEventTypesPaginator.ts b/clients/client-codestar-notifications/pagination/ListEventTypesPaginator.ts index 7c07c750d622c..97b2b7015c55d 100644 --- a/clients/client-codestar-notifications/pagination/ListEventTypesPaginator.ts +++ b/clients/client-codestar-notifications/pagination/ListEventTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodestarNotificationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodestarNotificationsClient, input: ListEventTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEventTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodestarNotifications, input: ListEventTypesCommandInput, diff --git a/clients/client-codestar-notifications/pagination/ListNotificationRulesPaginator.ts b/clients/client-codestar-notifications/pagination/ListNotificationRulesPaginator.ts index 182e09d2a9c08..9b125cd7d8bc7 100644 --- a/clients/client-codestar-notifications/pagination/ListNotificationRulesPaginator.ts +++ b/clients/client-codestar-notifications/pagination/ListNotificationRulesPaginator.ts @@ -8,6 +8,9 @@ import { import { CodestarNotificationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodestarNotificationsClient, input: ListNotificationRulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNotificationRulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodestarNotifications, input: ListNotificationRulesCommandInput, diff --git a/clients/client-codestar-notifications/pagination/ListTargetsPaginator.ts b/clients/client-codestar-notifications/pagination/ListTargetsPaginator.ts index 9a7d50d92c17f..4db805cac2844 100644 --- a/clients/client-codestar-notifications/pagination/ListTargetsPaginator.ts +++ b/clients/client-codestar-notifications/pagination/ListTargetsPaginator.ts @@ -4,6 +4,9 @@ import { ListTargetsCommand, ListTargetsCommandInput, ListTargetsCommandOutput } import { CodestarNotificationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CodestarNotificationsClient, input: ListTargetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTargetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CodestarNotifications, input: ListTargetsCommandInput, diff --git a/clients/client-codestar-notifications/runtimeConfig.browser.ts b/clients/client-codestar-notifications/runtimeConfig.browser.ts index 3f99aaf9a38aa..7c0ad0859b63f 100644 --- a/clients/client-codestar-notifications/runtimeConfig.browser.ts +++ b/clients/client-codestar-notifications/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodestarNotificationsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codestar-notifications/runtimeConfig.native.ts b/clients/client-codestar-notifications/runtimeConfig.native.ts index a25583c814db6..688f359752ee8 100644 --- a/clients/client-codestar-notifications/runtimeConfig.native.ts +++ b/clients/client-codestar-notifications/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodestarNotificationsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codestar-notifications/runtimeConfig.shared.ts b/clients/client-codestar-notifications/runtimeConfig.shared.ts index e4c635119a98d..8893915b6a480 100644 --- a/clients/client-codestar-notifications/runtimeConfig.shared.ts +++ b/clients/client-codestar-notifications/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-10-15", disableHostPrefix: false, diff --git a/clients/client-codestar-notifications/runtimeConfig.ts b/clients/client-codestar-notifications/runtimeConfig.ts index 7ff9243a60df2..d8690cf416d99 100644 --- a/clients/client-codestar-notifications/runtimeConfig.ts +++ b/clients/client-codestar-notifications/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodestarNotificationsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codestar-notifications/tsconfig.json b/clients/client-codestar-notifications/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codestar-notifications/tsconfig.json +++ b/clients/client-codestar-notifications/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-codestar/commands/AssociateTeamMemberCommand.ts b/clients/client-codestar/commands/AssociateTeamMemberCommand.ts index c23fe41b08811..e5e83f9d35dd7 100644 --- a/clients/client-codestar/commands/AssociateTeamMemberCommand.ts +++ b/clients/client-codestar/commands/AssociateTeamMemberCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateTeamMemberCommandInput = AssociateTeamMemberRequest; export type AssociateTeamMemberCommandOutput = AssociateTeamMemberResult & __MetadataBearer; +/** + *

Adds an IAM user to the team for an AWS CodeStar project.

+ */ export class AssociateTeamMemberCommand extends $Command< AssociateTeamMemberCommandInput, AssociateTeamMemberCommandOutput, @@ -34,6 +37,9 @@ export class AssociateTeamMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/CreateProjectCommand.ts b/clients/client-codestar/commands/CreateProjectCommand.ts index 5826e50de771c..4118fe99a3de7 100644 --- a/clients/client-codestar/commands/CreateProjectCommand.ts +++ b/clients/client-codestar/commands/CreateProjectCommand.ts @@ -20,6 +20,11 @@ import { export type CreateProjectCommandInput = CreateProjectRequest; export type CreateProjectCommandOutput = CreateProjectResult & __MetadataBearer; +/** + *

Creates a project, including project resources. This action creates a project based on + * a submitted project request. A set of source code files and a toolchain template file + * can be included with the project request. If these are not provided, an empty project is created.

+ */ export class CreateProjectCommand extends $Command< CreateProjectCommandInput, CreateProjectCommandOutput, @@ -34,6 +39,9 @@ export class CreateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/CreateUserProfileCommand.ts b/clients/client-codestar/commands/CreateUserProfileCommand.ts index 447ed47cb7c56..e0bb2045962e5 100644 --- a/clients/client-codestar/commands/CreateUserProfileCommand.ts +++ b/clients/client-codestar/commands/CreateUserProfileCommand.ts @@ -20,6 +20,12 @@ import { export type CreateUserProfileCommandInput = CreateUserProfileRequest; export type CreateUserProfileCommandOutput = CreateUserProfileResult & __MetadataBearer; +/** + *

Creates a profile for a user that includes user preferences, such as the display name + * and email address assocciated with the user, in AWS CodeStar. The user profile is not + * project-specific. Information in the user profile is displayed wherever the user's information + * appears to other users in AWS CodeStar.

+ */ export class CreateUserProfileCommand extends $Command< CreateUserProfileCommandInput, CreateUserProfileCommandOutput, @@ -34,6 +40,9 @@ export class CreateUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/DeleteProjectCommand.ts b/clients/client-codestar/commands/DeleteProjectCommand.ts index 3ca04828453c7..60c8d817e6a7d 100644 --- a/clients/client-codestar/commands/DeleteProjectCommand.ts +++ b/clients/client-codestar/commands/DeleteProjectCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteProjectCommandInput = DeleteProjectRequest; export type DeleteProjectCommandOutput = DeleteProjectResult & __MetadataBearer; +/** + *

Deletes a project, including project resources. Does not delete users associated with + * the project, but does delete the IAM roles that allowed access to the project.

+ */ export class DeleteProjectCommand extends $Command< DeleteProjectCommandInput, DeleteProjectCommandOutput, @@ -34,6 +38,9 @@ export class DeleteProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/DeleteUserProfileCommand.ts b/clients/client-codestar/commands/DeleteUserProfileCommand.ts index 03197665a9ab1..d5dd7ffda986c 100644 --- a/clients/client-codestar/commands/DeleteUserProfileCommand.ts +++ b/clients/client-codestar/commands/DeleteUserProfileCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteUserProfileCommandInput = DeleteUserProfileRequest; export type DeleteUserProfileCommandOutput = DeleteUserProfileResult & __MetadataBearer; +/** + *

Deletes a user profile in AWS CodeStar, including all personal preference data associated with + * that profile, such as display name and email address. It does not delete the history of that + * user, for example the history of commits made by that user.

+ */ export class DeleteUserProfileCommand extends $Command< DeleteUserProfileCommandInput, DeleteUserProfileCommandOutput, @@ -34,6 +39,9 @@ export class DeleteUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/DescribeProjectCommand.ts b/clients/client-codestar/commands/DescribeProjectCommand.ts index 81ebceb1f4830..52eeb343f7d32 100644 --- a/clients/client-codestar/commands/DescribeProjectCommand.ts +++ b/clients/client-codestar/commands/DescribeProjectCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProjectCommandInput = DescribeProjectRequest; export type DescribeProjectCommandOutput = DescribeProjectResult & __MetadataBearer; +/** + *

Describes a project and its resources.

+ */ export class DescribeProjectCommand extends $Command< DescribeProjectCommandInput, DescribeProjectCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/DescribeUserProfileCommand.ts b/clients/client-codestar/commands/DescribeUserProfileCommand.ts index bbc6b34074176..d060a849db5f5 100644 --- a/clients/client-codestar/commands/DescribeUserProfileCommand.ts +++ b/clients/client-codestar/commands/DescribeUserProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserProfileCommandInput = DescribeUserProfileRequest; export type DescribeUserProfileCommandOutput = DescribeUserProfileResult & __MetadataBearer; +/** + *

Describes a user in AWS CodeStar and the user attributes across all projects.

+ */ export class DescribeUserProfileCommand extends $Command< DescribeUserProfileCommandInput, DescribeUserProfileCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/DisassociateTeamMemberCommand.ts b/clients/client-codestar/commands/DisassociateTeamMemberCommand.ts index 2e2b994ba8b3f..738be5e8573bb 100644 --- a/clients/client-codestar/commands/DisassociateTeamMemberCommand.ts +++ b/clients/client-codestar/commands/DisassociateTeamMemberCommand.ts @@ -20,6 +20,12 @@ import { export type DisassociateTeamMemberCommandInput = DisassociateTeamMemberRequest; export type DisassociateTeamMemberCommandOutput = DisassociateTeamMemberResult & __MetadataBearer; +/** + *

Removes a user from a project. Removing a user from a project also removes the IAM + * policies from that user that allowed access to the project and its resources. Disassociating a + * team member does not remove that user's profile from AWS CodeStar. It does not remove the user from + * IAM.

+ */ export class DisassociateTeamMemberCommand extends $Command< DisassociateTeamMemberCommandInput, DisassociateTeamMemberCommandOutput, @@ -34,6 +40,9 @@ export class DisassociateTeamMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/ListProjectsCommand.ts b/clients/client-codestar/commands/ListProjectsCommand.ts index a15e647d65b07..ee7db0a498b94 100644 --- a/clients/client-codestar/commands/ListProjectsCommand.ts +++ b/clients/client-codestar/commands/ListProjectsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProjectsCommandInput = ListProjectsRequest; export type ListProjectsCommandOutput = ListProjectsResult & __MetadataBearer; +/** + *

Lists all projects in AWS CodeStar associated with your AWS account.

+ */ export class ListProjectsCommand extends $Command< ListProjectsCommandInput, ListProjectsCommandOutput, @@ -34,6 +37,9 @@ export class ListProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/ListResourcesCommand.ts b/clients/client-codestar/commands/ListResourcesCommand.ts index 1cb9ad74081a0..79ae9437e5e43 100644 --- a/clients/client-codestar/commands/ListResourcesCommand.ts +++ b/clients/client-codestar/commands/ListResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourcesCommandInput = ListResourcesRequest; export type ListResourcesCommandOutput = ListResourcesResult & __MetadataBearer; +/** + *

Lists resources associated with a project in AWS CodeStar.

+ */ export class ListResourcesCommand extends $Command< ListResourcesCommandInput, ListResourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/ListTagsForProjectCommand.ts b/clients/client-codestar/commands/ListTagsForProjectCommand.ts index 28c9116215e83..c9d0f79aac2bb 100644 --- a/clients/client-codestar/commands/ListTagsForProjectCommand.ts +++ b/clients/client-codestar/commands/ListTagsForProjectCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForProjectCommandInput = ListTagsForProjectRequest; export type ListTagsForProjectCommandOutput = ListTagsForProjectResult & __MetadataBearer; +/** + *

Gets the tags for a project.

+ */ export class ListTagsForProjectCommand extends $Command< ListTagsForProjectCommandInput, ListTagsForProjectCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/ListTeamMembersCommand.ts b/clients/client-codestar/commands/ListTeamMembersCommand.ts index 2cb9df49f0989..773316cf25bb4 100644 --- a/clients/client-codestar/commands/ListTeamMembersCommand.ts +++ b/clients/client-codestar/commands/ListTeamMembersCommand.ts @@ -20,6 +20,9 @@ import { export type ListTeamMembersCommandInput = ListTeamMembersRequest; export type ListTeamMembersCommandOutput = ListTeamMembersResult & __MetadataBearer; +/** + *

Lists all team members associated with a project.

+ */ export class ListTeamMembersCommand extends $Command< ListTeamMembersCommandInput, ListTeamMembersCommandOutput, @@ -34,6 +37,9 @@ export class ListTeamMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/ListUserProfilesCommand.ts b/clients/client-codestar/commands/ListUserProfilesCommand.ts index df41caf290808..8bda868747cd7 100644 --- a/clients/client-codestar/commands/ListUserProfilesCommand.ts +++ b/clients/client-codestar/commands/ListUserProfilesCommand.ts @@ -20,6 +20,9 @@ import { export type ListUserProfilesCommandInput = ListUserProfilesRequest; export type ListUserProfilesCommandOutput = ListUserProfilesResult & __MetadataBearer; +/** + *

Lists all the user profiles configured for your AWS account in AWS CodeStar.

+ */ export class ListUserProfilesCommand extends $Command< ListUserProfilesCommandInput, ListUserProfilesCommandOutput, @@ -34,6 +37,9 @@ export class ListUserProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/TagProjectCommand.ts b/clients/client-codestar/commands/TagProjectCommand.ts index 8ab3c5411e096..a7cf423bff4fc 100644 --- a/clients/client-codestar/commands/TagProjectCommand.ts +++ b/clients/client-codestar/commands/TagProjectCommand.ts @@ -20,6 +20,9 @@ import { export type TagProjectCommandInput = TagProjectRequest; export type TagProjectCommandOutput = TagProjectResult & __MetadataBearer; +/** + *

Adds tags to a project.

+ */ export class TagProjectCommand extends $Command< TagProjectCommandInput, TagProjectCommandOutput, @@ -34,6 +37,9 @@ export class TagProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/UntagProjectCommand.ts b/clients/client-codestar/commands/UntagProjectCommand.ts index 27fd19cd6dfca..41706613b7905 100644 --- a/clients/client-codestar/commands/UntagProjectCommand.ts +++ b/clients/client-codestar/commands/UntagProjectCommand.ts @@ -20,6 +20,9 @@ import { export type UntagProjectCommandInput = UntagProjectRequest; export type UntagProjectCommandOutput = UntagProjectResult & __MetadataBearer; +/** + *

Removes tags from a project.

+ */ export class UntagProjectCommand extends $Command< UntagProjectCommandInput, UntagProjectCommandOutput, @@ -34,6 +37,9 @@ export class UntagProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/UpdateProjectCommand.ts b/clients/client-codestar/commands/UpdateProjectCommand.ts index 2ff7e52e4011d..6f14702443b2d 100644 --- a/clients/client-codestar/commands/UpdateProjectCommand.ts +++ b/clients/client-codestar/commands/UpdateProjectCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProjectCommandInput = UpdateProjectRequest; export type UpdateProjectCommandOutput = UpdateProjectResult & __MetadataBearer; +/** + *

Updates a project in AWS CodeStar.

+ */ export class UpdateProjectCommand extends $Command< UpdateProjectCommandInput, UpdateProjectCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/UpdateTeamMemberCommand.ts b/clients/client-codestar/commands/UpdateTeamMemberCommand.ts index a08eeb4ed2dd7..71ea4491d3e3d 100644 --- a/clients/client-codestar/commands/UpdateTeamMemberCommand.ts +++ b/clients/client-codestar/commands/UpdateTeamMemberCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateTeamMemberCommandInput = UpdateTeamMemberRequest; export type UpdateTeamMemberCommandOutput = UpdateTeamMemberResult & __MetadataBearer; +/** + *

Updates a team member's attributes in an AWS CodeStar project. For example, you can change a + * team member's role in the project, or change whether they have remote access to project + * resources.

+ */ export class UpdateTeamMemberCommand extends $Command< UpdateTeamMemberCommandInput, UpdateTeamMemberCommandOutput, @@ -34,6 +39,9 @@ export class UpdateTeamMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/commands/UpdateUserProfileCommand.ts b/clients/client-codestar/commands/UpdateUserProfileCommand.ts index 39309633f30ac..5a970479b7bfa 100644 --- a/clients/client-codestar/commands/UpdateUserProfileCommand.ts +++ b/clients/client-codestar/commands/UpdateUserProfileCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateUserProfileCommandInput = UpdateUserProfileRequest; export type UpdateUserProfileCommandOutput = UpdateUserProfileResult & __MetadataBearer; +/** + *

Updates a user's profile in AWS CodeStar. The user profile is not project-specific. + * Information in the user profile is displayed wherever the user's information appears to other + * users in AWS CodeStar.

+ */ export class UpdateUserProfileCommand extends $Command< UpdateUserProfileCommandInput, UpdateUserProfileCommandOutput, @@ -34,6 +39,9 @@ export class UpdateUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CodeStarClientResolvedConfig, diff --git a/clients/client-codestar/package.json b/clients/client-codestar/package.json index 7dfc756f55dd0..fee7e404fdc37 100644 --- a/clients/client-codestar/package.json +++ b/clients/client-codestar/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Codestar Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-codestar/runtimeConfig.browser.ts b/clients/client-codestar/runtimeConfig.browser.ts index 792587cfeab10..fa22ed9ca3d5a 100644 --- a/clients/client-codestar/runtimeConfig.browser.ts +++ b/clients/client-codestar/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CodeStarClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-codestar/runtimeConfig.native.ts b/clients/client-codestar/runtimeConfig.native.ts index eb14dc5492c6f..4d380d997771d 100644 --- a/clients/client-codestar/runtimeConfig.native.ts +++ b/clients/client-codestar/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CodeStarClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-codestar/runtimeConfig.shared.ts b/clients/client-codestar/runtimeConfig.shared.ts index 442838fbb1afe..ae5ec6b24f0ce 100644 --- a/clients/client-codestar/runtimeConfig.shared.ts +++ b/clients/client-codestar/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-04-19", disableHostPrefix: false, diff --git a/clients/client-codestar/runtimeConfig.ts b/clients/client-codestar/runtimeConfig.ts index 226774f4ad8f3..86d3b1a82bb50 100644 --- a/clients/client-codestar/runtimeConfig.ts +++ b/clients/client-codestar/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CodeStarClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-codestar/tsconfig.json b/clients/client-codestar/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-codestar/tsconfig.json +++ b/clients/client-codestar/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cognito-identity-provider/commands/AddCustomAttributesCommand.ts b/clients/client-cognito-identity-provider/commands/AddCustomAttributesCommand.ts index ada2dfad9ff21..34d7e4eaa22c2 100644 --- a/clients/client-cognito-identity-provider/commands/AddCustomAttributesCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AddCustomAttributesCommand.ts @@ -25,6 +25,9 @@ import { export type AddCustomAttributesCommandInput = AddCustomAttributesRequest; export type AddCustomAttributesCommandOutput = AddCustomAttributesResponse & __MetadataBearer; +/** + *

Adds additional user attributes to the user pool schema.

+ */ export class AddCustomAttributesCommand extends $Command< AddCustomAttributesCommandInput, AddCustomAttributesCommandOutput, @@ -39,6 +42,9 @@ export class AddCustomAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminAddUserToGroupCommand.ts b/clients/client-cognito-identity-provider/commands/AdminAddUserToGroupCommand.ts index 3b2b03e3e8d90..56e754b191f96 100644 --- a/clients/client-cognito-identity-provider/commands/AdminAddUserToGroupCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminAddUserToGroupCommand.ts @@ -25,6 +25,10 @@ import { export type AdminAddUserToGroupCommandInput = AdminAddUserToGroupRequest; export type AdminAddUserToGroupCommandOutput = __MetadataBearer; +/** + *

Adds the specified user to the specified group.

+ *

Calling this action requires developer credentials.

+ */ export class AdminAddUserToGroupCommand extends $Command< AdminAddUserToGroupCommandInput, AdminAddUserToGroupCommandOutput, @@ -39,6 +43,9 @@ export class AdminAddUserToGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminConfirmSignUpCommand.ts b/clients/client-cognito-identity-provider/commands/AdminConfirmSignUpCommand.ts index efca0cd9210bb..8ce4608c7e5a2 100644 --- a/clients/client-cognito-identity-provider/commands/AdminConfirmSignUpCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminConfirmSignUpCommand.ts @@ -25,6 +25,11 @@ import { export type AdminConfirmSignUpCommandInput = AdminConfirmSignUpRequest; export type AdminConfirmSignUpCommandOutput = AdminConfirmSignUpResponse & __MetadataBearer; +/** + *

Confirms user registration as an admin without using a confirmation code. Works on any + * user.

+ *

Calling this action requires developer credentials.

+ */ export class AdminConfirmSignUpCommand extends $Command< AdminConfirmSignUpCommandInput, AdminConfirmSignUpCommandOutput, @@ -39,6 +44,9 @@ export class AdminConfirmSignUpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminCreateUserCommand.ts b/clients/client-cognito-identity-provider/commands/AdminCreateUserCommand.ts index 8b3a6e68bbc4e..2e4e6251ac741 100644 --- a/clients/client-cognito-identity-provider/commands/AdminCreateUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminCreateUserCommand.ts @@ -25,6 +25,20 @@ import { export type AdminCreateUserCommandInput = AdminCreateUserRequest; export type AdminCreateUserCommandOutput = AdminCreateUserResponse & __MetadataBearer; +/** + *

Creates a new user in the specified user pool.

+ *

If MessageAction is not set, the default is to send a welcome message via + * email or phone (SMS).

+ *

This message is based on a template that you configured in your call to create or + * update a user pool. This template includes your custom sign-up instructions and placeholders + * for user name and temporary password.

+ *

Alternatively, you can call AdminCreateUser with “SUPPRESS” for the + * MessageAction parameter, and Amazon Cognito will not send any email.

+ *

In either case, the user will be in the FORCE_CHANGE_PASSWORD state until + * they sign in and change their password.

+ *

+ * AdminCreateUser requires developer credentials.

+ */ export class AdminCreateUserCommand extends $Command< AdminCreateUserCommandInput, AdminCreateUserCommandOutput, @@ -39,6 +53,9 @@ export class AdminCreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminDeleteUserAttributesCommand.ts b/clients/client-cognito-identity-provider/commands/AdminDeleteUserAttributesCommand.ts index 828c5d3fc9e74..8cca60151f938 100644 --- a/clients/client-cognito-identity-provider/commands/AdminDeleteUserAttributesCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminDeleteUserAttributesCommand.ts @@ -25,6 +25,11 @@ import { export type AdminDeleteUserAttributesCommandInput = AdminDeleteUserAttributesRequest; export type AdminDeleteUserAttributesCommandOutput = AdminDeleteUserAttributesResponse & __MetadataBearer; +/** + *

Deletes the user attributes in a user pool as an administrator. Works on any + * user.

+ *

Calling this action requires developer credentials.

+ */ export class AdminDeleteUserAttributesCommand extends $Command< AdminDeleteUserAttributesCommandInput, AdminDeleteUserAttributesCommandOutput, @@ -39,6 +44,9 @@ export class AdminDeleteUserAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminDeleteUserCommand.ts b/clients/client-cognito-identity-provider/commands/AdminDeleteUserCommand.ts index 1b38eb12702f5..7c4fa86d9c130 100644 --- a/clients/client-cognito-identity-provider/commands/AdminDeleteUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminDeleteUserCommand.ts @@ -25,6 +25,10 @@ import { export type AdminDeleteUserCommandInput = AdminDeleteUserRequest; export type AdminDeleteUserCommandOutput = __MetadataBearer; +/** + *

Deletes a user as an administrator. Works on any user.

+ *

Calling this action requires developer credentials.

+ */ export class AdminDeleteUserCommand extends $Command< AdminDeleteUserCommandInput, AdminDeleteUserCommandOutput, @@ -39,6 +43,9 @@ export class AdminDeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminDisableProviderForUserCommand.ts b/clients/client-cognito-identity-provider/commands/AdminDisableProviderForUserCommand.ts index f4aeceae00c81..8581d3225399f 100644 --- a/clients/client-cognito-identity-provider/commands/AdminDisableProviderForUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminDisableProviderForUserCommand.ts @@ -25,6 +25,36 @@ import { export type AdminDisableProviderForUserCommandInput = AdminDisableProviderForUserRequest; export type AdminDisableProviderForUserCommandOutput = AdminDisableProviderForUserResponse & __MetadataBearer; +/** + *

Disables the user from signing in with the specified external (SAML or social) + * identity provider. If the user to disable is a Cognito User Pools native username + + * password user, they are not permitted to use their password to sign-in. If the user to + * disable is a linked external IdP user, any link between that user and an existing user + * is removed. The next time the external user (no longer attached to the previously linked + * DestinationUser) signs in, they must create a new user account. See + * AdminLinkProviderForUser.

+ *

This action is enabled only for admin access and requires developer + * credentials.

+ *

The ProviderName must match the value specified when creating an IdP for + * the pool.

+ *

To disable a native username + password user, the ProviderName value must + * be Cognito and the ProviderAttributeName must be + * Cognito_Subject, with the ProviderAttributeValue being the + * name that is used in the user pool for the user.

+ *

The ProviderAttributeName must always be Cognito_Subject for + * social identity providers. The ProviderAttributeValue must always be the + * exact subject that was used when the user was originally linked as a source user.

+ *

For de-linking a SAML identity, there are two scenarios. If the linked identity has + * not yet been used to sign-in, the ProviderAttributeName and + * ProviderAttributeValue must be the same values that were used for the + * SourceUser when the identities were originally linked using + * AdminLinkProviderForUser call. (If the linking was done with + * ProviderAttributeName set to Cognito_Subject, the same + * applies here). However, if the user has already signed in, the + * ProviderAttributeName must be Cognito_Subject and + * ProviderAttributeValue must be the subject of the SAML + * assertion.

+ */ export class AdminDisableProviderForUserCommand extends $Command< AdminDisableProviderForUserCommandInput, AdminDisableProviderForUserCommandOutput, @@ -39,6 +69,9 @@ export class AdminDisableProviderForUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminDisableUserCommand.ts b/clients/client-cognito-identity-provider/commands/AdminDisableUserCommand.ts index 86458217a7bad..20439d1cc4d4e 100644 --- a/clients/client-cognito-identity-provider/commands/AdminDisableUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminDisableUserCommand.ts @@ -25,6 +25,10 @@ import { export type AdminDisableUserCommandInput = AdminDisableUserRequest; export type AdminDisableUserCommandOutput = AdminDisableUserResponse & __MetadataBearer; +/** + *

Disables the specified user.

+ *

Calling this action requires developer credentials.

+ */ export class AdminDisableUserCommand extends $Command< AdminDisableUserCommandInput, AdminDisableUserCommandOutput, @@ -39,6 +43,9 @@ export class AdminDisableUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminEnableUserCommand.ts b/clients/client-cognito-identity-provider/commands/AdminEnableUserCommand.ts index f67f783e05c77..c50ca7a4380c3 100644 --- a/clients/client-cognito-identity-provider/commands/AdminEnableUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminEnableUserCommand.ts @@ -25,6 +25,10 @@ import { export type AdminEnableUserCommandInput = AdminEnableUserRequest; export type AdminEnableUserCommandOutput = AdminEnableUserResponse & __MetadataBearer; +/** + *

Enables the specified user as an administrator. Works on any user.

+ *

Calling this action requires developer credentials.

+ */ export class AdminEnableUserCommand extends $Command< AdminEnableUserCommandInput, AdminEnableUserCommandOutput, @@ -39,6 +43,9 @@ export class AdminEnableUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminForgetDeviceCommand.ts b/clients/client-cognito-identity-provider/commands/AdminForgetDeviceCommand.ts index cda20dbe4b232..16246936f064d 100644 --- a/clients/client-cognito-identity-provider/commands/AdminForgetDeviceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminForgetDeviceCommand.ts @@ -25,6 +25,10 @@ import { export type AdminForgetDeviceCommandInput = AdminForgetDeviceRequest; export type AdminForgetDeviceCommandOutput = __MetadataBearer; +/** + *

Forgets the device, as an administrator.

+ *

Calling this action requires developer credentials.

+ */ export class AdminForgetDeviceCommand extends $Command< AdminForgetDeviceCommandInput, AdminForgetDeviceCommandOutput, @@ -39,6 +43,9 @@ export class AdminForgetDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminGetDeviceCommand.ts b/clients/client-cognito-identity-provider/commands/AdminGetDeviceCommand.ts index 6fba7c0867ecb..d58a09d1d0701 100644 --- a/clients/client-cognito-identity-provider/commands/AdminGetDeviceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminGetDeviceCommand.ts @@ -25,6 +25,10 @@ import { export type AdminGetDeviceCommandInput = AdminGetDeviceRequest; export type AdminGetDeviceCommandOutput = AdminGetDeviceResponse & __MetadataBearer; +/** + *

Gets the device, as an administrator.

+ *

Calling this action requires developer credentials.

+ */ export class AdminGetDeviceCommand extends $Command< AdminGetDeviceCommandInput, AdminGetDeviceCommandOutput, @@ -39,6 +43,9 @@ export class AdminGetDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminGetUserCommand.ts b/clients/client-cognito-identity-provider/commands/AdminGetUserCommand.ts index 63c02205296d8..1eaf52b4428c1 100644 --- a/clients/client-cognito-identity-provider/commands/AdminGetUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminGetUserCommand.ts @@ -25,6 +25,11 @@ import { export type AdminGetUserCommandInput = AdminGetUserRequest; export type AdminGetUserCommandOutput = AdminGetUserResponse & __MetadataBearer; +/** + *

Gets the specified user by user name in a user pool as an administrator. Works on any + * user.

+ *

Calling this action requires developer credentials.

+ */ export class AdminGetUserCommand extends $Command< AdminGetUserCommandInput, AdminGetUserCommandOutput, @@ -39,6 +44,9 @@ export class AdminGetUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminInitiateAuthCommand.ts b/clients/client-cognito-identity-provider/commands/AdminInitiateAuthCommand.ts index 4fafe8a464e86..ca39bbef15b21 100644 --- a/clients/client-cognito-identity-provider/commands/AdminInitiateAuthCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminInitiateAuthCommand.ts @@ -25,6 +25,10 @@ import { export type AdminInitiateAuthCommandInput = AdminInitiateAuthRequest; export type AdminInitiateAuthCommandOutput = AdminInitiateAuthResponse & __MetadataBearer; +/** + *

Initiates the authentication flow, as an administrator.

+ *

Calling this action requires developer credentials.

+ */ export class AdminInitiateAuthCommand extends $Command< AdminInitiateAuthCommandInput, AdminInitiateAuthCommandOutput, @@ -39,6 +43,9 @@ export class AdminInitiateAuthCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminLinkProviderForUserCommand.ts b/clients/client-cognito-identity-provider/commands/AdminLinkProviderForUserCommand.ts index 29f4b5b0d5959..88756b86fc86b 100644 --- a/clients/client-cognito-identity-provider/commands/AdminLinkProviderForUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminLinkProviderForUserCommand.ts @@ -25,6 +25,29 @@ import { export type AdminLinkProviderForUserCommandInput = AdminLinkProviderForUserRequest; export type AdminLinkProviderForUserCommandOutput = AdminLinkProviderForUserResponse & __MetadataBearer; +/** + *

Links an existing user account in a user pool (DestinationUser) to an + * identity from an external identity provider (SourceUser) based on a + * specified attribute name and value from the external identity provider. This allows you + * to create a link from the existing user account to an external federated user identity + * that has not yet been used to sign in, so that the federated user identity can be used + * to sign in as the existing user account.

+ *

For example, if there is an existing user with a username and password, this API + * links that user to a federated user identity, so that when the federated user identity + * is used, the user signs in as the existing user account.

+ * + *

The maximum number of federated identities linked to a user is 5.

+ *
+ * + *

Because this API allows a user with an external federated identity to sign in as + * an existing user in the user pool, it is critical that it only be used with external + * identity providers and provider attributes that have been trusted by the application + * owner.

+ *
+ * + *

This action is enabled only for admin access and requires developer + * credentials.

+ */ export class AdminLinkProviderForUserCommand extends $Command< AdminLinkProviderForUserCommandInput, AdminLinkProviderForUserCommandOutput, @@ -39,6 +62,9 @@ export class AdminLinkProviderForUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminListDevicesCommand.ts b/clients/client-cognito-identity-provider/commands/AdminListDevicesCommand.ts index 5e95edea2a9a8..318c3fc33ebb7 100644 --- a/clients/client-cognito-identity-provider/commands/AdminListDevicesCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminListDevicesCommand.ts @@ -25,6 +25,10 @@ import { export type AdminListDevicesCommandInput = AdminListDevicesRequest; export type AdminListDevicesCommandOutput = AdminListDevicesResponse & __MetadataBearer; +/** + *

Lists devices, as an administrator.

+ *

Calling this action requires developer credentials.

+ */ export class AdminListDevicesCommand extends $Command< AdminListDevicesCommandInput, AdminListDevicesCommandOutput, @@ -39,6 +43,9 @@ export class AdminListDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminListGroupsForUserCommand.ts b/clients/client-cognito-identity-provider/commands/AdminListGroupsForUserCommand.ts index 51b9fafc2cb92..072374cb85c73 100644 --- a/clients/client-cognito-identity-provider/commands/AdminListGroupsForUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminListGroupsForUserCommand.ts @@ -25,6 +25,10 @@ import { export type AdminListGroupsForUserCommandInput = AdminListGroupsForUserRequest; export type AdminListGroupsForUserCommandOutput = AdminListGroupsForUserResponse & __MetadataBearer; +/** + *

Lists the groups that the user belongs to.

+ *

Calling this action requires developer credentials.

+ */ export class AdminListGroupsForUserCommand extends $Command< AdminListGroupsForUserCommandInput, AdminListGroupsForUserCommandOutput, @@ -39,6 +43,9 @@ export class AdminListGroupsForUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminListUserAuthEventsCommand.ts b/clients/client-cognito-identity-provider/commands/AdminListUserAuthEventsCommand.ts index 828d8e8922b1e..80ef65fc96200 100644 --- a/clients/client-cognito-identity-provider/commands/AdminListUserAuthEventsCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminListUserAuthEventsCommand.ts @@ -25,6 +25,10 @@ import { export type AdminListUserAuthEventsCommandInput = AdminListUserAuthEventsRequest; export type AdminListUserAuthEventsCommandOutput = AdminListUserAuthEventsResponse & __MetadataBearer; +/** + *

Lists a history of user activity and any risks detected as part of Amazon Cognito + * advanced security.

+ */ export class AdminListUserAuthEventsCommand extends $Command< AdminListUserAuthEventsCommandInput, AdminListUserAuthEventsCommandOutput, @@ -39,6 +43,9 @@ export class AdminListUserAuthEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminRemoveUserFromGroupCommand.ts b/clients/client-cognito-identity-provider/commands/AdminRemoveUserFromGroupCommand.ts index 7ac02c490f298..b8e8687af2272 100644 --- a/clients/client-cognito-identity-provider/commands/AdminRemoveUserFromGroupCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminRemoveUserFromGroupCommand.ts @@ -25,6 +25,10 @@ import { export type AdminRemoveUserFromGroupCommandInput = AdminRemoveUserFromGroupRequest; export type AdminRemoveUserFromGroupCommandOutput = __MetadataBearer; +/** + *

Removes the specified user from the specified group.

+ *

Calling this action requires developer credentials.

+ */ export class AdminRemoveUserFromGroupCommand extends $Command< AdminRemoveUserFromGroupCommandInput, AdminRemoveUserFromGroupCommandOutput, @@ -39,6 +43,9 @@ export class AdminRemoveUserFromGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminResetUserPasswordCommand.ts b/clients/client-cognito-identity-provider/commands/AdminResetUserPasswordCommand.ts index 5ed8615507aea..00b154c576a92 100644 --- a/clients/client-cognito-identity-provider/commands/AdminResetUserPasswordCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminResetUserPasswordCommand.ts @@ -25,6 +25,19 @@ import { export type AdminResetUserPasswordCommandInput = AdminResetUserPasswordRequest; export type AdminResetUserPasswordCommandOutput = AdminResetUserPasswordResponse & __MetadataBearer; +/** + *

Resets the specified user's password in a user pool as an administrator. Works on any + * user.

+ *

When a developer calls this API, the current password is invalidated, so it must be + * changed. If a user tries to sign in after the API is called, the app will get a + * PasswordResetRequiredException exception back and should direct the user down the flow + * to reset the password, which is the same as the forgot password flow. In addition, if + * the user pool has phone verification selected and a verified phone number exists for the + * user, or if email verification is selected and a verified email exists for the user, + * calling this API will also result in sending a message to the end user with the code to + * change their password.

+ *

Calling this action requires developer credentials.

+ */ export class AdminResetUserPasswordCommand extends $Command< AdminResetUserPasswordCommandInput, AdminResetUserPasswordCommandOutput, @@ -39,6 +52,9 @@ export class AdminResetUserPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminRespondToAuthChallengeCommand.ts b/clients/client-cognito-identity-provider/commands/AdminRespondToAuthChallengeCommand.ts index cf5ca571b11cb..218c5a0883e43 100644 --- a/clients/client-cognito-identity-provider/commands/AdminRespondToAuthChallengeCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminRespondToAuthChallengeCommand.ts @@ -25,6 +25,10 @@ import { export type AdminRespondToAuthChallengeCommandInput = AdminRespondToAuthChallengeRequest; export type AdminRespondToAuthChallengeCommandOutput = AdminRespondToAuthChallengeResponse & __MetadataBearer; +/** + *

Responds to an authentication challenge, as an administrator.

+ *

Calling this action requires developer credentials.

+ */ export class AdminRespondToAuthChallengeCommand extends $Command< AdminRespondToAuthChallengeCommandInput, AdminRespondToAuthChallengeCommandOutput, @@ -39,6 +43,9 @@ export class AdminRespondToAuthChallengeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminSetUserMFAPreferenceCommand.ts b/clients/client-cognito-identity-provider/commands/AdminSetUserMFAPreferenceCommand.ts index 78571f1e248b3..875e8d39dc5fe 100644 --- a/clients/client-cognito-identity-provider/commands/AdminSetUserMFAPreferenceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminSetUserMFAPreferenceCommand.ts @@ -25,6 +25,13 @@ import { export type AdminSetUserMFAPreferenceCommandInput = AdminSetUserMFAPreferenceRequest; export type AdminSetUserMFAPreferenceCommandOutput = AdminSetUserMFAPreferenceResponse & __MetadataBearer; +/** + *

Sets the user's multi-factor authentication (MFA) preference, including which MFA + * options are enabled and if any are preferred. Only one factor can be set as preferred. + * The preferred MFA factor will be used to authenticate a user if multiple factors are + * enabled. If multiple options are enabled and no preference is set, a challenge to choose + * an MFA option will be returned during sign in.

+ */ export class AdminSetUserMFAPreferenceCommand extends $Command< AdminSetUserMFAPreferenceCommandInput, AdminSetUserMFAPreferenceCommandOutput, @@ -39,6 +46,9 @@ export class AdminSetUserMFAPreferenceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminSetUserPasswordCommand.ts b/clients/client-cognito-identity-provider/commands/AdminSetUserPasswordCommand.ts index 1f44b6a63285c..59151e0861a2d 100644 --- a/clients/client-cognito-identity-provider/commands/AdminSetUserPasswordCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminSetUserPasswordCommand.ts @@ -25,6 +25,18 @@ import { export type AdminSetUserPasswordCommandInput = AdminSetUserPasswordRequest; export type AdminSetUserPasswordCommandOutput = AdminSetUserPasswordResponse & __MetadataBearer; +/** + *

Sets the specified user's password in a user pool as an administrator. Works on any + * user.

+ *

The password can be temporary or permanent. If it is temporary, the user status will + * be placed into the FORCE_CHANGE_PASSWORD state. When the user next tries to + * sign in, the InitiateAuth/AdminInitiateAuth response will contain the + * NEW_PASSWORD_REQUIRED challenge. If the user does not sign in before it + * expires, the user will not be able to sign in and their password will need to be reset + * by an administrator.

+ *

Once the user has set a new password, or the password is permanent, the user status + * will be set to Confirmed.

+ */ export class AdminSetUserPasswordCommand extends $Command< AdminSetUserPasswordCommandInput, AdminSetUserPasswordCommandOutput, @@ -39,6 +51,9 @@ export class AdminSetUserPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminSetUserSettingsCommand.ts b/clients/client-cognito-identity-provider/commands/AdminSetUserSettingsCommand.ts index bf5a9c269b7c3..1ab43c4d2175a 100644 --- a/clients/client-cognito-identity-provider/commands/AdminSetUserSettingsCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminSetUserSettingsCommand.ts @@ -25,6 +25,12 @@ import { export type AdminSetUserSettingsCommandInput = AdminSetUserSettingsRequest; export type AdminSetUserSettingsCommandOutput = AdminSetUserSettingsResponse & __MetadataBearer; +/** + *

+ * This action is no longer supported. You can use it to configure + * only SMS MFA. You can't use it to configure TOTP software token MFA. To configure either + * type of MFA, use AdminSetUserMFAPreference instead.

+ */ export class AdminSetUserSettingsCommand extends $Command< AdminSetUserSettingsCommandInput, AdminSetUserSettingsCommandOutput, @@ -39,6 +45,9 @@ export class AdminSetUserSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminUpdateAuthEventFeedbackCommand.ts b/clients/client-cognito-identity-provider/commands/AdminUpdateAuthEventFeedbackCommand.ts index caceb2606a2fd..63230a2e7b644 100644 --- a/clients/client-cognito-identity-provider/commands/AdminUpdateAuthEventFeedbackCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminUpdateAuthEventFeedbackCommand.ts @@ -25,6 +25,11 @@ import { export type AdminUpdateAuthEventFeedbackCommandInput = AdminUpdateAuthEventFeedbackRequest; export type AdminUpdateAuthEventFeedbackCommandOutput = AdminUpdateAuthEventFeedbackResponse & __MetadataBearer; +/** + *

Provides feedback for an authentication event as to whether it was from a valid user. + * This feedback is used for improving the risk evaluation decision for the user pool as + * part of Amazon Cognito advanced security.

+ */ export class AdminUpdateAuthEventFeedbackCommand extends $Command< AdminUpdateAuthEventFeedbackCommandInput, AdminUpdateAuthEventFeedbackCommandOutput, @@ -39,6 +44,9 @@ export class AdminUpdateAuthEventFeedbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminUpdateDeviceStatusCommand.ts b/clients/client-cognito-identity-provider/commands/AdminUpdateDeviceStatusCommand.ts index f5bdcbc9c0b88..587e94c9d0120 100644 --- a/clients/client-cognito-identity-provider/commands/AdminUpdateDeviceStatusCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminUpdateDeviceStatusCommand.ts @@ -25,6 +25,10 @@ import { export type AdminUpdateDeviceStatusCommandInput = AdminUpdateDeviceStatusRequest; export type AdminUpdateDeviceStatusCommandOutput = AdminUpdateDeviceStatusResponse & __MetadataBearer; +/** + *

Updates the device status as an administrator.

+ *

Calling this action requires developer credentials.

+ */ export class AdminUpdateDeviceStatusCommand extends $Command< AdminUpdateDeviceStatusCommandInput, AdminUpdateDeviceStatusCommandOutput, @@ -39,6 +43,9 @@ export class AdminUpdateDeviceStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminUpdateUserAttributesCommand.ts b/clients/client-cognito-identity-provider/commands/AdminUpdateUserAttributesCommand.ts index 1b89071888786..17e6324df02ee 100644 --- a/clients/client-cognito-identity-provider/commands/AdminUpdateUserAttributesCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminUpdateUserAttributesCommand.ts @@ -25,6 +25,15 @@ import { export type AdminUpdateUserAttributesCommandInput = AdminUpdateUserAttributesRequest; export type AdminUpdateUserAttributesCommandOutput = AdminUpdateUserAttributesResponse & __MetadataBearer; +/** + *

Updates the specified user's attributes, including developer attributes, as an + * administrator. Works on any user.

+ *

For custom attributes, you must prepend the custom: prefix to the + * attribute name.

+ *

In addition to updating user attributes, this API can also be used to mark phone and + * email as verified.

+ *

Calling this action requires developer credentials.

+ */ export class AdminUpdateUserAttributesCommand extends $Command< AdminUpdateUserAttributesCommandInput, AdminUpdateUserAttributesCommandOutput, @@ -39,6 +48,9 @@ export class AdminUpdateUserAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AdminUserGlobalSignOutCommand.ts b/clients/client-cognito-identity-provider/commands/AdminUserGlobalSignOutCommand.ts index 73f6d4fe8d6be..e2af3828c8d71 100644 --- a/clients/client-cognito-identity-provider/commands/AdminUserGlobalSignOutCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AdminUserGlobalSignOutCommand.ts @@ -25,6 +25,12 @@ import { export type AdminUserGlobalSignOutCommandInput = AdminUserGlobalSignOutRequest; export type AdminUserGlobalSignOutCommandOutput = AdminUserGlobalSignOutResponse & __MetadataBearer; +/** + *

Signs out users from all devices, as an administrator. It also invalidates all refresh + * tokens issued to a user. The user's current access and Id tokens remain valid until + * their expiry. Access and Id tokens expire one hour after they are issued.

+ *

Calling this action requires developer credentials.

+ */ export class AdminUserGlobalSignOutCommand extends $Command< AdminUserGlobalSignOutCommandInput, AdminUserGlobalSignOutCommandOutput, @@ -39,6 +45,9 @@ export class AdminUserGlobalSignOutCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/AssociateSoftwareTokenCommand.ts b/clients/client-cognito-identity-provider/commands/AssociateSoftwareTokenCommand.ts index 487f0689a8b4e..e4878ab3b9f45 100644 --- a/clients/client-cognito-identity-provider/commands/AssociateSoftwareTokenCommand.ts +++ b/clients/client-cognito-identity-provider/commands/AssociateSoftwareTokenCommand.ts @@ -25,6 +25,10 @@ import { export type AssociateSoftwareTokenCommandInput = AssociateSoftwareTokenRequest; export type AssociateSoftwareTokenCommandOutput = AssociateSoftwareTokenResponse & __MetadataBearer; +/** + *

Returns a unique generated shared secret key code for the user account. The request + * takes an access token or a session string, but not both.

+ */ export class AssociateSoftwareTokenCommand extends $Command< AssociateSoftwareTokenCommandInput, AssociateSoftwareTokenCommandOutput, @@ -39,6 +43,9 @@ export class AssociateSoftwareTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ChangePasswordCommand.ts b/clients/client-cognito-identity-provider/commands/ChangePasswordCommand.ts index 22605318d3704..cb5752216a537 100644 --- a/clients/client-cognito-identity-provider/commands/ChangePasswordCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ChangePasswordCommand.ts @@ -24,6 +24,9 @@ import { export type ChangePasswordCommandInput = ChangePasswordRequest; export type ChangePasswordCommandOutput = ChangePasswordResponse & __MetadataBearer; +/** + *

Changes the password for a specified user in a user pool.

+ */ export class ChangePasswordCommand extends $Command< ChangePasswordCommandInput, ChangePasswordCommandOutput, @@ -38,6 +41,9 @@ export class ChangePasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ConfirmDeviceCommand.ts b/clients/client-cognito-identity-provider/commands/ConfirmDeviceCommand.ts index 0904ee4776a99..0aacae076a519 100644 --- a/clients/client-cognito-identity-provider/commands/ConfirmDeviceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ConfirmDeviceCommand.ts @@ -25,6 +25,10 @@ import { export type ConfirmDeviceCommandInput = ConfirmDeviceRequest; export type ConfirmDeviceCommandOutput = ConfirmDeviceResponse & __MetadataBearer; +/** + *

Confirms tracking of the device. This API call is the call that begins device + * tracking.

+ */ export class ConfirmDeviceCommand extends $Command< ConfirmDeviceCommandInput, ConfirmDeviceCommandOutput, @@ -39,6 +43,9 @@ export class ConfirmDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ConfirmForgotPasswordCommand.ts b/clients/client-cognito-identity-provider/commands/ConfirmForgotPasswordCommand.ts index 812dc08cd3e26..845c325aa614c 100644 --- a/clients/client-cognito-identity-provider/commands/ConfirmForgotPasswordCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ConfirmForgotPasswordCommand.ts @@ -24,6 +24,9 @@ import { export type ConfirmForgotPasswordCommandInput = ConfirmForgotPasswordRequest; export type ConfirmForgotPasswordCommandOutput = ConfirmForgotPasswordResponse & __MetadataBearer; +/** + *

Allows a user to enter a confirmation code to reset a forgotten password.

+ */ export class ConfirmForgotPasswordCommand extends $Command< ConfirmForgotPasswordCommandInput, ConfirmForgotPasswordCommandOutput, @@ -38,6 +41,9 @@ export class ConfirmForgotPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ConfirmSignUpCommand.ts b/clients/client-cognito-identity-provider/commands/ConfirmSignUpCommand.ts index 472faa7aec6d4..8e618b771818a 100644 --- a/clients/client-cognito-identity-provider/commands/ConfirmSignUpCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ConfirmSignUpCommand.ts @@ -24,6 +24,10 @@ import { export type ConfirmSignUpCommandInput = ConfirmSignUpRequest; export type ConfirmSignUpCommandOutput = ConfirmSignUpResponse & __MetadataBearer; +/** + *

Confirms registration of a user and handles the existing alias from a previous + * user.

+ */ export class ConfirmSignUpCommand extends $Command< ConfirmSignUpCommandInput, ConfirmSignUpCommandOutput, @@ -38,6 +42,9 @@ export class ConfirmSignUpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/CreateGroupCommand.ts b/clients/client-cognito-identity-provider/commands/CreateGroupCommand.ts index c7d8d3b64b566..c6d7beed2a5be 100644 --- a/clients/client-cognito-identity-provider/commands/CreateGroupCommand.ts +++ b/clients/client-cognito-identity-provider/commands/CreateGroupCommand.ts @@ -25,6 +25,10 @@ import { export type CreateGroupCommandInput = CreateGroupRequest; export type CreateGroupCommandOutput = CreateGroupResponse & __MetadataBearer; +/** + *

Creates a new group in the specified user pool.

+ *

Calling this action requires developer credentials.

+ */ export class CreateGroupCommand extends $Command< CreateGroupCommandInput, CreateGroupCommandOutput, @@ -39,6 +43,9 @@ export class CreateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/CreateIdentityProviderCommand.ts b/clients/client-cognito-identity-provider/commands/CreateIdentityProviderCommand.ts index 3028d28c0b99a..b5f584e3168f3 100644 --- a/clients/client-cognito-identity-provider/commands/CreateIdentityProviderCommand.ts +++ b/clients/client-cognito-identity-provider/commands/CreateIdentityProviderCommand.ts @@ -25,6 +25,9 @@ import { export type CreateIdentityProviderCommandInput = CreateIdentityProviderRequest; export type CreateIdentityProviderCommandOutput = CreateIdentityProviderResponse & __MetadataBearer; +/** + *

Creates an identity provider for a user pool.

+ */ export class CreateIdentityProviderCommand extends $Command< CreateIdentityProviderCommandInput, CreateIdentityProviderCommandOutput, @@ -39,6 +42,9 @@ export class CreateIdentityProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/CreateResourceServerCommand.ts b/clients/client-cognito-identity-provider/commands/CreateResourceServerCommand.ts index b159b439413a5..9533cb9a375dd 100644 --- a/clients/client-cognito-identity-provider/commands/CreateResourceServerCommand.ts +++ b/clients/client-cognito-identity-provider/commands/CreateResourceServerCommand.ts @@ -25,6 +25,9 @@ import { export type CreateResourceServerCommandInput = CreateResourceServerRequest; export type CreateResourceServerCommandOutput = CreateResourceServerResponse & __MetadataBearer; +/** + *

Creates a new OAuth2.0 resource server and defines custom scopes in it.

+ */ export class CreateResourceServerCommand extends $Command< CreateResourceServerCommandInput, CreateResourceServerCommandOutput, @@ -39,6 +42,9 @@ export class CreateResourceServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/CreateUserImportJobCommand.ts b/clients/client-cognito-identity-provider/commands/CreateUserImportJobCommand.ts index f2bdfff56a5f6..e42bceba7a5d7 100644 --- a/clients/client-cognito-identity-provider/commands/CreateUserImportJobCommand.ts +++ b/clients/client-cognito-identity-provider/commands/CreateUserImportJobCommand.ts @@ -25,6 +25,9 @@ import { export type CreateUserImportJobCommandInput = CreateUserImportJobRequest; export type CreateUserImportJobCommandOutput = CreateUserImportJobResponse & __MetadataBearer; +/** + *

Creates the user import job.

+ */ export class CreateUserImportJobCommand extends $Command< CreateUserImportJobCommandInput, CreateUserImportJobCommandOutput, @@ -39,6 +42,9 @@ export class CreateUserImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/CreateUserPoolClientCommand.ts b/clients/client-cognito-identity-provider/commands/CreateUserPoolClientCommand.ts index 01132421499c8..da3b3493e9f6b 100644 --- a/clients/client-cognito-identity-provider/commands/CreateUserPoolClientCommand.ts +++ b/clients/client-cognito-identity-provider/commands/CreateUserPoolClientCommand.ts @@ -25,6 +25,9 @@ import { export type CreateUserPoolClientCommandInput = CreateUserPoolClientRequest; export type CreateUserPoolClientCommandOutput = CreateUserPoolClientResponse & __MetadataBearer; +/** + *

Creates the user pool client.

+ */ export class CreateUserPoolClientCommand extends $Command< CreateUserPoolClientCommandInput, CreateUserPoolClientCommandOutput, @@ -39,6 +42,9 @@ export class CreateUserPoolClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/CreateUserPoolCommand.ts b/clients/client-cognito-identity-provider/commands/CreateUserPoolCommand.ts index 63881ddaf3b04..a92dc577c9d2e 100644 --- a/clients/client-cognito-identity-provider/commands/CreateUserPoolCommand.ts +++ b/clients/client-cognito-identity-provider/commands/CreateUserPoolCommand.ts @@ -25,6 +25,10 @@ import { export type CreateUserPoolCommandInput = CreateUserPoolRequest; export type CreateUserPoolCommandOutput = CreateUserPoolResponse & __MetadataBearer; +/** + *

Creates a new Amazon Cognito user pool and sets the password policy for the + * pool.

+ */ export class CreateUserPoolCommand extends $Command< CreateUserPoolCommandInput, CreateUserPoolCommandOutput, @@ -39,6 +43,9 @@ export class CreateUserPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/CreateUserPoolDomainCommand.ts b/clients/client-cognito-identity-provider/commands/CreateUserPoolDomainCommand.ts index 7c528f09b54cc..55eb5d1d2f581 100644 --- a/clients/client-cognito-identity-provider/commands/CreateUserPoolDomainCommand.ts +++ b/clients/client-cognito-identity-provider/commands/CreateUserPoolDomainCommand.ts @@ -25,6 +25,9 @@ import { export type CreateUserPoolDomainCommandInput = CreateUserPoolDomainRequest; export type CreateUserPoolDomainCommandOutput = CreateUserPoolDomainResponse & __MetadataBearer; +/** + *

Creates a new domain for a user pool.

+ */ export class CreateUserPoolDomainCommand extends $Command< CreateUserPoolDomainCommandInput, CreateUserPoolDomainCommandOutput, @@ -39,6 +42,9 @@ export class CreateUserPoolDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DeleteGroupCommand.ts b/clients/client-cognito-identity-provider/commands/DeleteGroupCommand.ts index 3420312c8aecf..359211b9e6682 100644 --- a/clients/client-cognito-identity-provider/commands/DeleteGroupCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DeleteGroupCommand.ts @@ -25,6 +25,10 @@ import { export type DeleteGroupCommandInput = DeleteGroupRequest; export type DeleteGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a group. Currently only groups with no members can be deleted.

+ *

Calling this action requires developer credentials.

+ */ export class DeleteGroupCommand extends $Command< DeleteGroupCommandInput, DeleteGroupCommandOutput, @@ -39,6 +43,9 @@ export class DeleteGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DeleteIdentityProviderCommand.ts b/clients/client-cognito-identity-provider/commands/DeleteIdentityProviderCommand.ts index fbb1601e524f2..1aa1c3fed24b7 100644 --- a/clients/client-cognito-identity-provider/commands/DeleteIdentityProviderCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DeleteIdentityProviderCommand.ts @@ -25,6 +25,9 @@ import { export type DeleteIdentityProviderCommandInput = DeleteIdentityProviderRequest; export type DeleteIdentityProviderCommandOutput = __MetadataBearer; +/** + *

Deletes an identity provider for a user pool.

+ */ export class DeleteIdentityProviderCommand extends $Command< DeleteIdentityProviderCommandInput, DeleteIdentityProviderCommandOutput, @@ -39,6 +42,9 @@ export class DeleteIdentityProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DeleteResourceServerCommand.ts b/clients/client-cognito-identity-provider/commands/DeleteResourceServerCommand.ts index 209a2ccd423ae..41a35ccca41c7 100644 --- a/clients/client-cognito-identity-provider/commands/DeleteResourceServerCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DeleteResourceServerCommand.ts @@ -25,6 +25,9 @@ import { export type DeleteResourceServerCommandInput = DeleteResourceServerRequest; export type DeleteResourceServerCommandOutput = __MetadataBearer; +/** + *

Deletes a resource server.

+ */ export class DeleteResourceServerCommand extends $Command< DeleteResourceServerCommandInput, DeleteResourceServerCommandOutput, @@ -39,6 +42,9 @@ export class DeleteResourceServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DeleteUserAttributesCommand.ts b/clients/client-cognito-identity-provider/commands/DeleteUserAttributesCommand.ts index f890998ccdc93..6a58b05182cba 100644 --- a/clients/client-cognito-identity-provider/commands/DeleteUserAttributesCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DeleteUserAttributesCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteUserAttributesCommandInput = DeleteUserAttributesRequest; export type DeleteUserAttributesCommandOutput = DeleteUserAttributesResponse & __MetadataBearer; +/** + *

Deletes the attributes for a user.

+ */ export class DeleteUserAttributesCommand extends $Command< DeleteUserAttributesCommandInput, DeleteUserAttributesCommandOutput, @@ -38,6 +41,9 @@ export class DeleteUserAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DeleteUserCommand.ts b/clients/client-cognito-identity-provider/commands/DeleteUserCommand.ts index 950e5614e32b3..125ade05c394d 100644 --- a/clients/client-cognito-identity-provider/commands/DeleteUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DeleteUserCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = __MetadataBearer; +/** + *

Allows a user to delete himself or herself.

+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -38,6 +41,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DeleteUserPoolClientCommand.ts b/clients/client-cognito-identity-provider/commands/DeleteUserPoolClientCommand.ts index 8ccd258e49c34..4de8b13b6a97b 100644 --- a/clients/client-cognito-identity-provider/commands/DeleteUserPoolClientCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DeleteUserPoolClientCommand.ts @@ -25,6 +25,9 @@ import { export type DeleteUserPoolClientCommandInput = DeleteUserPoolClientRequest; export type DeleteUserPoolClientCommandOutput = __MetadataBearer; +/** + *

Allows the developer to delete the user pool client.

+ */ export class DeleteUserPoolClientCommand extends $Command< DeleteUserPoolClientCommandInput, DeleteUserPoolClientCommandOutput, @@ -39,6 +42,9 @@ export class DeleteUserPoolClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DeleteUserPoolCommand.ts b/clients/client-cognito-identity-provider/commands/DeleteUserPoolCommand.ts index a6c8c8a426831..15b7a9ee5f9e6 100644 --- a/clients/client-cognito-identity-provider/commands/DeleteUserPoolCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DeleteUserPoolCommand.ts @@ -25,6 +25,9 @@ import { export type DeleteUserPoolCommandInput = DeleteUserPoolRequest; export type DeleteUserPoolCommandOutput = __MetadataBearer; +/** + *

Deletes the specified Amazon Cognito user pool.

+ */ export class DeleteUserPoolCommand extends $Command< DeleteUserPoolCommandInput, DeleteUserPoolCommandOutput, @@ -39,6 +42,9 @@ export class DeleteUserPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DeleteUserPoolDomainCommand.ts b/clients/client-cognito-identity-provider/commands/DeleteUserPoolDomainCommand.ts index b4c1cc7780574..7fb04273684cd 100644 --- a/clients/client-cognito-identity-provider/commands/DeleteUserPoolDomainCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DeleteUserPoolDomainCommand.ts @@ -25,6 +25,9 @@ import { export type DeleteUserPoolDomainCommandInput = DeleteUserPoolDomainRequest; export type DeleteUserPoolDomainCommandOutput = DeleteUserPoolDomainResponse & __MetadataBearer; +/** + *

Deletes a domain for a user pool.

+ */ export class DeleteUserPoolDomainCommand extends $Command< DeleteUserPoolDomainCommandInput, DeleteUserPoolDomainCommandOutput, @@ -39,6 +42,9 @@ export class DeleteUserPoolDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DescribeIdentityProviderCommand.ts b/clients/client-cognito-identity-provider/commands/DescribeIdentityProviderCommand.ts index 2e170ca155729..5ec653df54115 100644 --- a/clients/client-cognito-identity-provider/commands/DescribeIdentityProviderCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DescribeIdentityProviderCommand.ts @@ -25,6 +25,9 @@ import { export type DescribeIdentityProviderCommandInput = DescribeIdentityProviderRequest; export type DescribeIdentityProviderCommandOutput = DescribeIdentityProviderResponse & __MetadataBearer; +/** + *

Gets information about a specific identity provider.

+ */ export class DescribeIdentityProviderCommand extends $Command< DescribeIdentityProviderCommandInput, DescribeIdentityProviderCommandOutput, @@ -39,6 +42,9 @@ export class DescribeIdentityProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DescribeResourceServerCommand.ts b/clients/client-cognito-identity-provider/commands/DescribeResourceServerCommand.ts index cf47f25f2e5a7..d8e732c120fdd 100644 --- a/clients/client-cognito-identity-provider/commands/DescribeResourceServerCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DescribeResourceServerCommand.ts @@ -25,6 +25,9 @@ import { export type DescribeResourceServerCommandInput = DescribeResourceServerRequest; export type DescribeResourceServerCommandOutput = DescribeResourceServerResponse & __MetadataBearer; +/** + *

Describes a resource server.

+ */ export class DescribeResourceServerCommand extends $Command< DescribeResourceServerCommandInput, DescribeResourceServerCommandOutput, @@ -39,6 +42,9 @@ export class DescribeResourceServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DescribeRiskConfigurationCommand.ts b/clients/client-cognito-identity-provider/commands/DescribeRiskConfigurationCommand.ts index d96ff6b9277bc..cffd64e6576bd 100644 --- a/clients/client-cognito-identity-provider/commands/DescribeRiskConfigurationCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DescribeRiskConfigurationCommand.ts @@ -25,6 +25,9 @@ import { export type DescribeRiskConfigurationCommandInput = DescribeRiskConfigurationRequest; export type DescribeRiskConfigurationCommandOutput = DescribeRiskConfigurationResponse & __MetadataBearer; +/** + *

Describes the risk configuration.

+ */ export class DescribeRiskConfigurationCommand extends $Command< DescribeRiskConfigurationCommandInput, DescribeRiskConfigurationCommandOutput, @@ -39,6 +42,9 @@ export class DescribeRiskConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DescribeUserImportJobCommand.ts b/clients/client-cognito-identity-provider/commands/DescribeUserImportJobCommand.ts index fa4a805de5e43..ff1a1e4f1781a 100644 --- a/clients/client-cognito-identity-provider/commands/DescribeUserImportJobCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DescribeUserImportJobCommand.ts @@ -25,6 +25,9 @@ import { export type DescribeUserImportJobCommandInput = DescribeUserImportJobRequest; export type DescribeUserImportJobCommandOutput = DescribeUserImportJobResponse & __MetadataBearer; +/** + *

Describes the user import job.

+ */ export class DescribeUserImportJobCommand extends $Command< DescribeUserImportJobCommandInput, DescribeUserImportJobCommandOutput, @@ -39,6 +42,9 @@ export class DescribeUserImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DescribeUserPoolClientCommand.ts b/clients/client-cognito-identity-provider/commands/DescribeUserPoolClientCommand.ts index 617c6ce232f86..69d1a31614053 100644 --- a/clients/client-cognito-identity-provider/commands/DescribeUserPoolClientCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DescribeUserPoolClientCommand.ts @@ -25,6 +25,10 @@ import { export type DescribeUserPoolClientCommandInput = DescribeUserPoolClientRequest; export type DescribeUserPoolClientCommandOutput = DescribeUserPoolClientResponse & __MetadataBearer; +/** + *

Client method for returning the configuration information and metadata of the + * specified user pool app client.

+ */ export class DescribeUserPoolClientCommand extends $Command< DescribeUserPoolClientCommandInput, DescribeUserPoolClientCommandOutput, @@ -39,6 +43,9 @@ export class DescribeUserPoolClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DescribeUserPoolCommand.ts b/clients/client-cognito-identity-provider/commands/DescribeUserPoolCommand.ts index 16464d56b5b26..30b249099d456 100644 --- a/clients/client-cognito-identity-provider/commands/DescribeUserPoolCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DescribeUserPoolCommand.ts @@ -25,6 +25,9 @@ import { export type DescribeUserPoolCommandInput = DescribeUserPoolRequest; export type DescribeUserPoolCommandOutput = DescribeUserPoolResponse & __MetadataBearer; +/** + *

Returns the configuration information and metadata of the specified user pool.

+ */ export class DescribeUserPoolCommand extends $Command< DescribeUserPoolCommandInput, DescribeUserPoolCommandOutput, @@ -39,6 +42,9 @@ export class DescribeUserPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/DescribeUserPoolDomainCommand.ts b/clients/client-cognito-identity-provider/commands/DescribeUserPoolDomainCommand.ts index a778ddb347587..2651a51dfc241 100644 --- a/clients/client-cognito-identity-provider/commands/DescribeUserPoolDomainCommand.ts +++ b/clients/client-cognito-identity-provider/commands/DescribeUserPoolDomainCommand.ts @@ -25,6 +25,9 @@ import { export type DescribeUserPoolDomainCommandInput = DescribeUserPoolDomainRequest; export type DescribeUserPoolDomainCommandOutput = DescribeUserPoolDomainResponse & __MetadataBearer; +/** + *

Gets information about a domain.

+ */ export class DescribeUserPoolDomainCommand extends $Command< DescribeUserPoolDomainCommandInput, DescribeUserPoolDomainCommandOutput, @@ -39,6 +42,9 @@ export class DescribeUserPoolDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ForgetDeviceCommand.ts b/clients/client-cognito-identity-provider/commands/ForgetDeviceCommand.ts index 38a15282cb459..7ae990fdc7c51 100644 --- a/clients/client-cognito-identity-provider/commands/ForgetDeviceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ForgetDeviceCommand.ts @@ -25,6 +25,9 @@ import { export type ForgetDeviceCommandInput = ForgetDeviceRequest; export type ForgetDeviceCommandOutput = __MetadataBearer; +/** + *

Forgets the specified device.

+ */ export class ForgetDeviceCommand extends $Command< ForgetDeviceCommandInput, ForgetDeviceCommandOutput, @@ -39,6 +42,9 @@ export class ForgetDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ForgotPasswordCommand.ts b/clients/client-cognito-identity-provider/commands/ForgotPasswordCommand.ts index 5f8cc68c26788..f102587bf6437 100644 --- a/clients/client-cognito-identity-provider/commands/ForgotPasswordCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ForgotPasswordCommand.ts @@ -24,6 +24,15 @@ import { export type ForgotPasswordCommandInput = ForgotPasswordRequest; export type ForgotPasswordCommandOutput = ForgotPasswordResponse & __MetadataBearer; +/** + *

Calling this API causes a message to be sent to the end user with a confirmation code + * that is required to change the user's password. For the Username parameter, + * you can use the username or user alias. The method used to send the confirmation code is + * sent according to the specified AccountRecoverySetting. For more information, see Recovering User Accounts in the Amazon Cognito Developer Guide. + * If neither a verified phone number nor a verified email exists, an + * InvalidParameterException is thrown. To use the confirmation code for + * resetting the password, call ConfirmForgotPassword.

+ */ export class ForgotPasswordCommand extends $Command< ForgotPasswordCommandInput, ForgotPasswordCommandOutput, @@ -38,6 +47,9 @@ export class ForgotPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetCSVHeaderCommand.ts b/clients/client-cognito-identity-provider/commands/GetCSVHeaderCommand.ts index a924bf3d356ff..fb378beab0376 100644 --- a/clients/client-cognito-identity-provider/commands/GetCSVHeaderCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetCSVHeaderCommand.ts @@ -25,6 +25,10 @@ import { export type GetCSVHeaderCommandInput = GetCSVHeaderRequest; export type GetCSVHeaderCommandOutput = GetCSVHeaderResponse & __MetadataBearer; +/** + *

Gets the header information for the .csv file to be used as input for the user import + * job.

+ */ export class GetCSVHeaderCommand extends $Command< GetCSVHeaderCommandInput, GetCSVHeaderCommandOutput, @@ -39,6 +43,9 @@ export class GetCSVHeaderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetDeviceCommand.ts b/clients/client-cognito-identity-provider/commands/GetDeviceCommand.ts index 702129b4e01c7..5523ace2475a4 100644 --- a/clients/client-cognito-identity-provider/commands/GetDeviceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetDeviceCommand.ts @@ -22,6 +22,9 @@ import { export type GetDeviceCommandInput = GetDeviceRequest; export type GetDeviceCommandOutput = GetDeviceResponse & __MetadataBearer; +/** + *

Gets the device.

+ */ export class GetDeviceCommand extends $Command< GetDeviceCommandInput, GetDeviceCommandOutput, @@ -36,6 +39,9 @@ export class GetDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetGroupCommand.ts b/clients/client-cognito-identity-provider/commands/GetGroupCommand.ts index 2892902ceaab7..0192cc462ff4e 100644 --- a/clients/client-cognito-identity-provider/commands/GetGroupCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetGroupCommand.ts @@ -22,6 +22,10 @@ import { export type GetGroupCommandInput = GetGroupRequest; export type GetGroupCommandOutput = GetGroupResponse & __MetadataBearer; +/** + *

Gets a group.

+ *

Calling this action requires developer credentials.

+ */ export class GetGroupCommand extends $Command< GetGroupCommandInput, GetGroupCommandOutput, @@ -36,6 +40,9 @@ export class GetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetIdentityProviderByIdentifierCommand.ts b/clients/client-cognito-identity-provider/commands/GetIdentityProviderByIdentifierCommand.ts index 5dc53a3266dae..f89a088806f1b 100644 --- a/clients/client-cognito-identity-provider/commands/GetIdentityProviderByIdentifierCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetIdentityProviderByIdentifierCommand.ts @@ -25,6 +25,9 @@ import { export type GetIdentityProviderByIdentifierCommandInput = GetIdentityProviderByIdentifierRequest; export type GetIdentityProviderByIdentifierCommandOutput = GetIdentityProviderByIdentifierResponse & __MetadataBearer; +/** + *

Gets the specified identity provider.

+ */ export class GetIdentityProviderByIdentifierCommand extends $Command< GetIdentityProviderByIdentifierCommandInput, GetIdentityProviderByIdentifierCommandOutput, @@ -39,6 +42,9 @@ export class GetIdentityProviderByIdentifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetSigningCertificateCommand.ts b/clients/client-cognito-identity-provider/commands/GetSigningCertificateCommand.ts index 389c16bab9b4f..0610edda1b965 100644 --- a/clients/client-cognito-identity-provider/commands/GetSigningCertificateCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetSigningCertificateCommand.ts @@ -25,6 +25,9 @@ import { export type GetSigningCertificateCommandInput = GetSigningCertificateRequest; export type GetSigningCertificateCommandOutput = GetSigningCertificateResponse & __MetadataBearer; +/** + *

This method takes a user pool ID, and returns the signing certificate.

+ */ export class GetSigningCertificateCommand extends $Command< GetSigningCertificateCommandInput, GetSigningCertificateCommandOutput, @@ -39,6 +42,9 @@ export class GetSigningCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetUICustomizationCommand.ts b/clients/client-cognito-identity-provider/commands/GetUICustomizationCommand.ts index 3bbe4b88fc22f..d5ef893db67d4 100644 --- a/clients/client-cognito-identity-provider/commands/GetUICustomizationCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetUICustomizationCommand.ts @@ -25,6 +25,12 @@ import { export type GetUICustomizationCommandInput = GetUICustomizationRequest; export type GetUICustomizationCommandOutput = GetUICustomizationResponse & __MetadataBearer; +/** + *

Gets the UI Customization information for a particular app client's app UI, if there + * is something set. If nothing is set for the particular client, but there is an existing + * pool level customization (app clientId will be ALL), then that + * is returned. If nothing is present, then an empty shape is returned.

+ */ export class GetUICustomizationCommand extends $Command< GetUICustomizationCommandInput, GetUICustomizationCommandOutput, @@ -39,6 +45,9 @@ export class GetUICustomizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetUserAttributeVerificationCodeCommand.ts b/clients/client-cognito-identity-provider/commands/GetUserAttributeVerificationCodeCommand.ts index c05b618bfdf6f..aab4087f5fd4f 100644 --- a/clients/client-cognito-identity-provider/commands/GetUserAttributeVerificationCodeCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetUserAttributeVerificationCodeCommand.ts @@ -24,6 +24,9 @@ import { export type GetUserAttributeVerificationCodeCommandInput = GetUserAttributeVerificationCodeRequest; export type GetUserAttributeVerificationCodeCommandOutput = GetUserAttributeVerificationCodeResponse & __MetadataBearer; +/** + *

Gets the user attribute verification code for the specified attribute name.

+ */ export class GetUserAttributeVerificationCodeCommand extends $Command< GetUserAttributeVerificationCodeCommandInput, GetUserAttributeVerificationCodeCommandOutput, @@ -38,6 +41,9 @@ export class GetUserAttributeVerificationCodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetUserCommand.ts b/clients/client-cognito-identity-provider/commands/GetUserCommand.ts index aa86479cf7ec5..98d292d53a8e0 100644 --- a/clients/client-cognito-identity-provider/commands/GetUserCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetUserCommand.ts @@ -21,6 +21,9 @@ import { export type GetUserCommandInput = GetUserRequest; export type GetUserCommandOutput = GetUserResponse & __MetadataBearer; +/** + *

Gets the user attributes and metadata for a user.

+ */ export class GetUserCommand extends $Command< GetUserCommandInput, GetUserCommandOutput, @@ -35,6 +38,9 @@ export class GetUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GetUserPoolMfaConfigCommand.ts b/clients/client-cognito-identity-provider/commands/GetUserPoolMfaConfigCommand.ts index 8e807e9a55865..abe89c2670884 100644 --- a/clients/client-cognito-identity-provider/commands/GetUserPoolMfaConfigCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GetUserPoolMfaConfigCommand.ts @@ -25,6 +25,9 @@ import { export type GetUserPoolMfaConfigCommandInput = GetUserPoolMfaConfigRequest; export type GetUserPoolMfaConfigCommandOutput = GetUserPoolMfaConfigResponse & __MetadataBearer; +/** + *

Gets the user pool multi-factor authentication (MFA) configuration.

+ */ export class GetUserPoolMfaConfigCommand extends $Command< GetUserPoolMfaConfigCommandInput, GetUserPoolMfaConfigCommandOutput, @@ -39,6 +42,9 @@ export class GetUserPoolMfaConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/GlobalSignOutCommand.ts b/clients/client-cognito-identity-provider/commands/GlobalSignOutCommand.ts index 57bc39dc21a24..ba7b3b44fb6f3 100644 --- a/clients/client-cognito-identity-provider/commands/GlobalSignOutCommand.ts +++ b/clients/client-cognito-identity-provider/commands/GlobalSignOutCommand.ts @@ -25,6 +25,11 @@ import { export type GlobalSignOutCommandInput = GlobalSignOutRequest; export type GlobalSignOutCommandOutput = GlobalSignOutResponse & __MetadataBearer; +/** + *

Signs out users from all devices. It also invalidates all refresh tokens issued to a + * user. The user's current access and Id tokens remain valid until their expiry. Access + * and Id tokens expire one hour after they are issued.

+ */ export class GlobalSignOutCommand extends $Command< GlobalSignOutCommandInput, GlobalSignOutCommandOutput, @@ -39,6 +44,9 @@ export class GlobalSignOutCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/InitiateAuthCommand.ts b/clients/client-cognito-identity-provider/commands/InitiateAuthCommand.ts index b60075b35e641..191c8086b8531 100644 --- a/clients/client-cognito-identity-provider/commands/InitiateAuthCommand.ts +++ b/clients/client-cognito-identity-provider/commands/InitiateAuthCommand.ts @@ -24,6 +24,9 @@ import { export type InitiateAuthCommandInput = InitiateAuthRequest; export type InitiateAuthCommandOutput = InitiateAuthResponse & __MetadataBearer; +/** + *

Initiates the authentication flow.

+ */ export class InitiateAuthCommand extends $Command< InitiateAuthCommandInput, InitiateAuthCommandOutput, @@ -38,6 +41,9 @@ export class InitiateAuthCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListDevicesCommand.ts b/clients/client-cognito-identity-provider/commands/ListDevicesCommand.ts index b550c25a5b626..1af67ba665b37 100644 --- a/clients/client-cognito-identity-provider/commands/ListDevicesCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListDevicesCommand.ts @@ -25,6 +25,9 @@ import { export type ListDevicesCommandInput = ListDevicesRequest; export type ListDevicesCommandOutput = ListDevicesResponse & __MetadataBearer; +/** + *

Lists the devices.

+ */ export class ListDevicesCommand extends $Command< ListDevicesCommandInput, ListDevicesCommandOutput, @@ -39,6 +42,9 @@ export class ListDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListGroupsCommand.ts b/clients/client-cognito-identity-provider/commands/ListGroupsCommand.ts index da8704860fe58..ca60f1963b6cd 100644 --- a/clients/client-cognito-identity-provider/commands/ListGroupsCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListGroupsCommand.ts @@ -25,6 +25,10 @@ import { export type ListGroupsCommandInput = ListGroupsRequest; export type ListGroupsCommandOutput = ListGroupsResponse & __MetadataBearer; +/** + *

Lists the groups associated with a user pool.

+ *

Calling this action requires developer credentials.

+ */ export class ListGroupsCommand extends $Command< ListGroupsCommandInput, ListGroupsCommandOutput, @@ -39,6 +43,9 @@ export class ListGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListIdentityProvidersCommand.ts b/clients/client-cognito-identity-provider/commands/ListIdentityProvidersCommand.ts index 2a8b0181a9fbd..8b00c422c4d70 100644 --- a/clients/client-cognito-identity-provider/commands/ListIdentityProvidersCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListIdentityProvidersCommand.ts @@ -25,6 +25,9 @@ import { export type ListIdentityProvidersCommandInput = ListIdentityProvidersRequest; export type ListIdentityProvidersCommandOutput = ListIdentityProvidersResponse & __MetadataBearer; +/** + *

Lists information about all identity providers for a user pool.

+ */ export class ListIdentityProvidersCommand extends $Command< ListIdentityProvidersCommandInput, ListIdentityProvidersCommandOutput, @@ -39,6 +42,9 @@ export class ListIdentityProvidersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListResourceServersCommand.ts b/clients/client-cognito-identity-provider/commands/ListResourceServersCommand.ts index 8ffc40a5631cf..b7dc2ebddd3e8 100644 --- a/clients/client-cognito-identity-provider/commands/ListResourceServersCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListResourceServersCommand.ts @@ -25,6 +25,9 @@ import { export type ListResourceServersCommandInput = ListResourceServersRequest; export type ListResourceServersCommandOutput = ListResourceServersResponse & __MetadataBearer; +/** + *

Lists the resource servers for a user pool.

+ */ export class ListResourceServersCommand extends $Command< ListResourceServersCommandInput, ListResourceServersCommandOutput, @@ -39,6 +42,9 @@ export class ListResourceServersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListTagsForResourceCommand.ts b/clients/client-cognito-identity-provider/commands/ListTagsForResourceCommand.ts index 3ea43fbbe06bb..7530f1805c003 100644 --- a/clients/client-cognito-identity-provider/commands/ListTagsForResourceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListTagsForResourceCommand.ts @@ -25,6 +25,12 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags that are assigned to an Amazon Cognito user pool.

+ *

A tag is a label that you can apply to user pools to categorize and manage them in + * different ways, such as by purpose, owner, environment, or other criteria.

+ *

You can use this action up to 10 times per second, per account.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -39,6 +45,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListUserImportJobsCommand.ts b/clients/client-cognito-identity-provider/commands/ListUserImportJobsCommand.ts index 2a0eb88922203..9247e4bb6a554 100644 --- a/clients/client-cognito-identity-provider/commands/ListUserImportJobsCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListUserImportJobsCommand.ts @@ -25,6 +25,9 @@ import { export type ListUserImportJobsCommandInput = ListUserImportJobsRequest; export type ListUserImportJobsCommandOutput = ListUserImportJobsResponse & __MetadataBearer; +/** + *

Lists the user import jobs.

+ */ export class ListUserImportJobsCommand extends $Command< ListUserImportJobsCommandInput, ListUserImportJobsCommandOutput, @@ -39,6 +42,9 @@ export class ListUserImportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListUserPoolClientsCommand.ts b/clients/client-cognito-identity-provider/commands/ListUserPoolClientsCommand.ts index 845f73a7e7c2f..a58d3af31f535 100644 --- a/clients/client-cognito-identity-provider/commands/ListUserPoolClientsCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListUserPoolClientsCommand.ts @@ -25,6 +25,9 @@ import { export type ListUserPoolClientsCommandInput = ListUserPoolClientsRequest; export type ListUserPoolClientsCommandOutput = ListUserPoolClientsResponse & __MetadataBearer; +/** + *

Lists the clients that have been created for the specified user pool.

+ */ export class ListUserPoolClientsCommand extends $Command< ListUserPoolClientsCommandInput, ListUserPoolClientsCommandOutput, @@ -39,6 +42,9 @@ export class ListUserPoolClientsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListUserPoolsCommand.ts b/clients/client-cognito-identity-provider/commands/ListUserPoolsCommand.ts index 06b66800a8b1c..03a1a9246688b 100644 --- a/clients/client-cognito-identity-provider/commands/ListUserPoolsCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListUserPoolsCommand.ts @@ -25,6 +25,9 @@ import { export type ListUserPoolsCommandInput = ListUserPoolsRequest; export type ListUserPoolsCommandOutput = ListUserPoolsResponse & __MetadataBearer; +/** + *

Lists the user pools associated with an AWS account.

+ */ export class ListUserPoolsCommand extends $Command< ListUserPoolsCommandInput, ListUserPoolsCommandOutput, @@ -39,6 +42,9 @@ export class ListUserPoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListUsersCommand.ts b/clients/client-cognito-identity-provider/commands/ListUsersCommand.ts index 0c13aa1b862ea..fa34a5bd8b164 100644 --- a/clients/client-cognito-identity-provider/commands/ListUsersCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListUsersCommand.ts @@ -22,6 +22,9 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + *

Lists the users in the Amazon Cognito user pool.

+ */ export class ListUsersCommand extends $Command< ListUsersCommandInput, ListUsersCommandOutput, @@ -36,6 +39,9 @@ export class ListUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ListUsersInGroupCommand.ts b/clients/client-cognito-identity-provider/commands/ListUsersInGroupCommand.ts index 6fabfb097431a..be54baf3205db 100644 --- a/clients/client-cognito-identity-provider/commands/ListUsersInGroupCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ListUsersInGroupCommand.ts @@ -25,6 +25,10 @@ import { export type ListUsersInGroupCommandInput = ListUsersInGroupRequest; export type ListUsersInGroupCommandOutput = ListUsersInGroupResponse & __MetadataBearer; +/** + *

Lists the users in the specified group.

+ *

Calling this action requires developer credentials.

+ */ export class ListUsersInGroupCommand extends $Command< ListUsersInGroupCommandInput, ListUsersInGroupCommandOutput, @@ -39,6 +43,9 @@ export class ListUsersInGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/ResendConfirmationCodeCommand.ts b/clients/client-cognito-identity-provider/commands/ResendConfirmationCodeCommand.ts index 04ed3ce9822f9..4a960a7eda245 100644 --- a/clients/client-cognito-identity-provider/commands/ResendConfirmationCodeCommand.ts +++ b/clients/client-cognito-identity-provider/commands/ResendConfirmationCodeCommand.ts @@ -24,6 +24,10 @@ import { export type ResendConfirmationCodeCommandInput = ResendConfirmationCodeRequest; export type ResendConfirmationCodeCommandOutput = ResendConfirmationCodeResponse & __MetadataBearer; +/** + *

Resends the confirmation (for confirmation of registration) to a specific user in the + * user pool.

+ */ export class ResendConfirmationCodeCommand extends $Command< ResendConfirmationCodeCommandInput, ResendConfirmationCodeCommandOutput, @@ -38,6 +42,9 @@ export class ResendConfirmationCodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/RespondToAuthChallengeCommand.ts b/clients/client-cognito-identity-provider/commands/RespondToAuthChallengeCommand.ts index c48efe8fb4e2a..af494954de68e 100644 --- a/clients/client-cognito-identity-provider/commands/RespondToAuthChallengeCommand.ts +++ b/clients/client-cognito-identity-provider/commands/RespondToAuthChallengeCommand.ts @@ -24,6 +24,9 @@ import { export type RespondToAuthChallengeCommandInput = RespondToAuthChallengeRequest; export type RespondToAuthChallengeCommandOutput = RespondToAuthChallengeResponse & __MetadataBearer; +/** + *

Responds to the authentication challenge.

+ */ export class RespondToAuthChallengeCommand extends $Command< RespondToAuthChallengeCommandInput, RespondToAuthChallengeCommandOutput, @@ -38,6 +41,9 @@ export class RespondToAuthChallengeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/SetRiskConfigurationCommand.ts b/clients/client-cognito-identity-provider/commands/SetRiskConfigurationCommand.ts index 4d573b01d6deb..5129083047c73 100644 --- a/clients/client-cognito-identity-provider/commands/SetRiskConfigurationCommand.ts +++ b/clients/client-cognito-identity-provider/commands/SetRiskConfigurationCommand.ts @@ -25,6 +25,13 @@ import { export type SetRiskConfigurationCommandInput = SetRiskConfigurationRequest; export type SetRiskConfigurationCommandOutput = SetRiskConfigurationResponse & __MetadataBearer; +/** + *

Configures actions on detected risks. To delete the risk configuration for + * UserPoolId or ClientId, pass null values for all four + * configuration types.

+ *

To enable Amazon Cognito advanced security features, update the user pool to include + * the UserPoolAddOns keyAdvancedSecurityMode.

+ */ export class SetRiskConfigurationCommand extends $Command< SetRiskConfigurationCommandInput, SetRiskConfigurationCommandOutput, @@ -39,6 +46,9 @@ export class SetRiskConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/SetUICustomizationCommand.ts b/clients/client-cognito-identity-provider/commands/SetUICustomizationCommand.ts index f982a94e5cbde..24377346f4352 100644 --- a/clients/client-cognito-identity-provider/commands/SetUICustomizationCommand.ts +++ b/clients/client-cognito-identity-provider/commands/SetUICustomizationCommand.ts @@ -25,6 +25,20 @@ import { export type SetUICustomizationCommandInput = SetUICustomizationRequest; export type SetUICustomizationCommandOutput = SetUICustomizationResponse & __MetadataBearer; +/** + *

Sets the UI customization information for a user pool's built-in app UI.

+ *

You can specify app UI customization settings for a single client (with a specific + * clientId) or for all clients (by setting the clientId to + * ALL). If you specify ALL, the default configuration will + * be used for every client that has no UI customization set previously. If you specify UI + * customization settings for a particular client, it will no longer fall back to the + * ALL configuration.

+ * + *

To use this API, your user pool must have a domain associated with it. Otherwise, + * there is no place to host the app's pages, and the service will throw an + * error.

+ *
+ */ export class SetUICustomizationCommand extends $Command< SetUICustomizationCommandInput, SetUICustomizationCommandOutput, @@ -39,6 +53,9 @@ export class SetUICustomizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/SetUserMFAPreferenceCommand.ts b/clients/client-cognito-identity-provider/commands/SetUserMFAPreferenceCommand.ts index f5912c8a9026f..25786aeef4a88 100644 --- a/clients/client-cognito-identity-provider/commands/SetUserMFAPreferenceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/SetUserMFAPreferenceCommand.ts @@ -25,6 +25,13 @@ import { export type SetUserMFAPreferenceCommandInput = SetUserMFAPreferenceRequest; export type SetUserMFAPreferenceCommandOutput = SetUserMFAPreferenceResponse & __MetadataBearer; +/** + *

Set the user's multi-factor authentication (MFA) method preference, including which + * MFA factors are enabled and if any are preferred. Only one factor can be set as + * preferred. The preferred MFA factor will be used to authenticate a user if multiple + * factors are enabled. If multiple options are enabled and no preference is set, a + * challenge to choose an MFA option will be returned during sign in.

+ */ export class SetUserMFAPreferenceCommand extends $Command< SetUserMFAPreferenceCommandInput, SetUserMFAPreferenceCommandOutput, @@ -39,6 +46,9 @@ export class SetUserMFAPreferenceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/SetUserPoolMfaConfigCommand.ts b/clients/client-cognito-identity-provider/commands/SetUserPoolMfaConfigCommand.ts index d129f57ed7de4..03270908028ee 100644 --- a/clients/client-cognito-identity-provider/commands/SetUserPoolMfaConfigCommand.ts +++ b/clients/client-cognito-identity-provider/commands/SetUserPoolMfaConfigCommand.ts @@ -25,6 +25,9 @@ import { export type SetUserPoolMfaConfigCommandInput = SetUserPoolMfaConfigRequest; export type SetUserPoolMfaConfigCommandOutput = SetUserPoolMfaConfigResponse & __MetadataBearer; +/** + *

Set the user pool multi-factor authentication (MFA) configuration.

+ */ export class SetUserPoolMfaConfigCommand extends $Command< SetUserPoolMfaConfigCommandInput, SetUserPoolMfaConfigCommandOutput, @@ -39,6 +42,9 @@ export class SetUserPoolMfaConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/SetUserSettingsCommand.ts b/clients/client-cognito-identity-provider/commands/SetUserSettingsCommand.ts index f0ff68b08bdef..626e4b889dfbb 100644 --- a/clients/client-cognito-identity-provider/commands/SetUserSettingsCommand.ts +++ b/clients/client-cognito-identity-provider/commands/SetUserSettingsCommand.ts @@ -24,6 +24,12 @@ import { export type SetUserSettingsCommandInput = SetUserSettingsRequest; export type SetUserSettingsCommandOutput = SetUserSettingsResponse & __MetadataBearer; +/** + *

+ * This action is no longer supported. You can use it to configure + * only SMS MFA. You can't use it to configure TOTP software token MFA. To configure either + * type of MFA, use SetUserMFAPreference instead.

+ */ export class SetUserSettingsCommand extends $Command< SetUserSettingsCommandInput, SetUserSettingsCommandOutput, @@ -38,6 +44,9 @@ export class SetUserSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/SignUpCommand.ts b/clients/client-cognito-identity-provider/commands/SignUpCommand.ts index b1eee329a74ae..3884b10f2587f 100644 --- a/clients/client-cognito-identity-provider/commands/SignUpCommand.ts +++ b/clients/client-cognito-identity-provider/commands/SignUpCommand.ts @@ -21,6 +21,10 @@ import { export type SignUpCommandInput = SignUpRequest; export type SignUpCommandOutput = SignUpResponse & __MetadataBearer; +/** + *

Registers the user in the specified user pool and creates a user name, password, and + * user attributes.

+ */ export class SignUpCommand extends $Command< SignUpCommandInput, SignUpCommandOutput, @@ -35,6 +39,9 @@ export class SignUpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/StartUserImportJobCommand.ts b/clients/client-cognito-identity-provider/commands/StartUserImportJobCommand.ts index 650e7891403a6..e3ae9d53aca9c 100644 --- a/clients/client-cognito-identity-provider/commands/StartUserImportJobCommand.ts +++ b/clients/client-cognito-identity-provider/commands/StartUserImportJobCommand.ts @@ -25,6 +25,9 @@ import { export type StartUserImportJobCommandInput = StartUserImportJobRequest; export type StartUserImportJobCommandOutput = StartUserImportJobResponse & __MetadataBearer; +/** + *

Starts the user import.

+ */ export class StartUserImportJobCommand extends $Command< StartUserImportJobCommandInput, StartUserImportJobCommandOutput, @@ -39,6 +42,9 @@ export class StartUserImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/StopUserImportJobCommand.ts b/clients/client-cognito-identity-provider/commands/StopUserImportJobCommand.ts index ce4dde726e644..4e4ce4ac253f9 100644 --- a/clients/client-cognito-identity-provider/commands/StopUserImportJobCommand.ts +++ b/clients/client-cognito-identity-provider/commands/StopUserImportJobCommand.ts @@ -25,6 +25,9 @@ import { export type StopUserImportJobCommandInput = StopUserImportJobRequest; export type StopUserImportJobCommandOutput = StopUserImportJobResponse & __MetadataBearer; +/** + *

Stops the user import job.

+ */ export class StopUserImportJobCommand extends $Command< StopUserImportJobCommandInput, StopUserImportJobCommandOutput, @@ -39,6 +42,9 @@ export class StopUserImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/TagResourceCommand.ts b/clients/client-cognito-identity-provider/commands/TagResourceCommand.ts index b8e6daa3b332b..1608c00b0878b 100644 --- a/clients/client-cognito-identity-provider/commands/TagResourceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/TagResourceCommand.ts @@ -25,6 +25,22 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Assigns a set of tags to an Amazon Cognito user pool. A tag is a label that you can + * use to categorize and manage user pools in different ways, such as by purpose, owner, + * environment, or other criteria.

+ *

Each tag consists of a key and value, both of which you define. A key is a general + * category for more specific values. For example, if you have two versions of a user pool, + * one for testing and another for production, you might assign an Environment + * tag key to both user pools. The value of this key might be Test for one + * user pool and Production for the other.

+ *

Tags are useful for cost tracking and access control. You can activate your tags so + * that they appear on the Billing and Cost Management console, where you can track the + * costs associated with your user pools. In an IAM policy, you can constrain permissions + * for user pools based on specific tags or tag values.

+ *

You can use this action up to 5 times per second, per account. A user pool can have as + * many as 50 tags.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -39,6 +55,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UntagResourceCommand.ts b/clients/client-cognito-identity-provider/commands/UntagResourceCommand.ts index a643b82779b8a..444175e3ef6c8 100644 --- a/clients/client-cognito-identity-provider/commands/UntagResourceCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UntagResourceCommand.ts @@ -25,6 +25,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the specified tags from an Amazon Cognito user pool. You can use this action + * up to 5 times per second, per account

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -39,6 +43,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateAuthEventFeedbackCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateAuthEventFeedbackCommand.ts index d5e77ac06c784..ad948504b6361 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateAuthEventFeedbackCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateAuthEventFeedbackCommand.ts @@ -25,6 +25,11 @@ import { export type UpdateAuthEventFeedbackCommandInput = UpdateAuthEventFeedbackRequest; export type UpdateAuthEventFeedbackCommandOutput = UpdateAuthEventFeedbackResponse & __MetadataBearer; +/** + *

Provides the feedback for an authentication event whether it was from a valid user or + * not. This feedback is used for improving the risk evaluation decision for the user pool + * as part of Amazon Cognito advanced security.

+ */ export class UpdateAuthEventFeedbackCommand extends $Command< UpdateAuthEventFeedbackCommandInput, UpdateAuthEventFeedbackCommandOutput, @@ -39,6 +44,9 @@ export class UpdateAuthEventFeedbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateDeviceStatusCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateDeviceStatusCommand.ts index a5e1821c200d5..51af0fbebba44 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateDeviceStatusCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateDeviceStatusCommand.ts @@ -25,6 +25,9 @@ import { export type UpdateDeviceStatusCommandInput = UpdateDeviceStatusRequest; export type UpdateDeviceStatusCommandOutput = UpdateDeviceStatusResponse & __MetadataBearer; +/** + *

Updates the device status.

+ */ export class UpdateDeviceStatusCommand extends $Command< UpdateDeviceStatusCommandInput, UpdateDeviceStatusCommandOutput, @@ -39,6 +42,9 @@ export class UpdateDeviceStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateGroupCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateGroupCommand.ts index 536750526cd8c..a75aa71ee7d3f 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateGroupCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateGroupCommand.ts @@ -25,6 +25,14 @@ import { export type UpdateGroupCommandInput = UpdateGroupRequest; export type UpdateGroupCommandOutput = UpdateGroupResponse & __MetadataBearer; +/** + *

Updates the specified group with the specified attributes.

+ *

Calling this action requires developer credentials.

+ * + *

If you don't provide a value for an attribute, it will be set to the default + * value.

+ *
+ */ export class UpdateGroupCommand extends $Command< UpdateGroupCommandInput, UpdateGroupCommandOutput, @@ -39,6 +47,9 @@ export class UpdateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateIdentityProviderCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateIdentityProviderCommand.ts index c7a43a810bbc4..0989580d245d2 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateIdentityProviderCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateIdentityProviderCommand.ts @@ -25,6 +25,9 @@ import { export type UpdateIdentityProviderCommandInput = UpdateIdentityProviderRequest; export type UpdateIdentityProviderCommandOutput = UpdateIdentityProviderResponse & __MetadataBearer; +/** + *

Updates identity provider information for a user pool.

+ */ export class UpdateIdentityProviderCommand extends $Command< UpdateIdentityProviderCommandInput, UpdateIdentityProviderCommandOutput, @@ -39,6 +42,9 @@ export class UpdateIdentityProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateResourceServerCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateResourceServerCommand.ts index b82f365a9276b..a8c399ede922a 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateResourceServerCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateResourceServerCommand.ts @@ -25,6 +25,13 @@ import { export type UpdateResourceServerCommandInput = UpdateResourceServerRequest; export type UpdateResourceServerCommandOutput = UpdateResourceServerResponse & __MetadataBearer; +/** + *

Updates the name and scopes of resource server. All other fields are read-only.

+ * + *

If you don't provide a value for an attribute, it will be set to the default + * value.

+ *
+ */ export class UpdateResourceServerCommand extends $Command< UpdateResourceServerCommandInput, UpdateResourceServerCommandOutput, @@ -39,6 +46,9 @@ export class UpdateResourceServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateUserAttributesCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateUserAttributesCommand.ts index 7610f9e2dcb0b..8a389572b4f17 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateUserAttributesCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateUserAttributesCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateUserAttributesCommandInput = UpdateUserAttributesRequest; export type UpdateUserAttributesCommandOutput = UpdateUserAttributesResponse & __MetadataBearer; +/** + *

Allows a user to update a specific attribute (one at a time).

+ */ export class UpdateUserAttributesCommand extends $Command< UpdateUserAttributesCommandInput, UpdateUserAttributesCommandOutput, @@ -38,6 +41,9 @@ export class UpdateUserAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateUserPoolClientCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateUserPoolClientCommand.ts index c27695b2d95b6..f00989f72fd3a 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateUserPoolClientCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateUserPoolClientCommand.ts @@ -25,6 +25,14 @@ import { export type UpdateUserPoolClientCommandInput = UpdateUserPoolClientRequest; export type UpdateUserPoolClientCommandOutput = UpdateUserPoolClientResponse & __MetadataBearer; +/** + *

Updates the specified user pool app client with the specified attributes. You can get + * a list of the current user pool app client settings using DescribeUserPoolClient.

+ * + *

If you don't provide a value for an attribute, it will be set to the default + * value.

+ *
+ */ export class UpdateUserPoolClientCommand extends $Command< UpdateUserPoolClientCommandInput, UpdateUserPoolClientCommandOutput, @@ -39,6 +47,9 @@ export class UpdateUserPoolClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateUserPoolCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateUserPoolCommand.ts index 3f7d102f4c192..da4b147cc7d4c 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateUserPoolCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateUserPoolCommand.ts @@ -25,6 +25,14 @@ import { export type UpdateUserPoolCommandInput = UpdateUserPoolRequest; export type UpdateUserPoolCommandOutput = UpdateUserPoolResponse & __MetadataBearer; +/** + *

Updates the specified user pool with the specified attributes. You can get a list of + * the current user pool settings using DescribeUserPool.

+ * + *

If you don't provide a value for an attribute, it will be set to the default + * value.

+ *
+ */ export class UpdateUserPoolCommand extends $Command< UpdateUserPoolCommandInput, UpdateUserPoolCommandOutput, @@ -39,6 +47,9 @@ export class UpdateUserPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/UpdateUserPoolDomainCommand.ts b/clients/client-cognito-identity-provider/commands/UpdateUserPoolDomainCommand.ts index be39da0a5dfbd..62b519dc3b415 100644 --- a/clients/client-cognito-identity-provider/commands/UpdateUserPoolDomainCommand.ts +++ b/clients/client-cognito-identity-provider/commands/UpdateUserPoolDomainCommand.ts @@ -25,6 +25,29 @@ import { export type UpdateUserPoolDomainCommandInput = UpdateUserPoolDomainRequest; export type UpdateUserPoolDomainCommandOutput = UpdateUserPoolDomainResponse & __MetadataBearer; +/** + *

Updates the Secure Sockets Layer (SSL) certificate for the custom domain for your user + * pool.

+ *

You can use this operation to provide the Amazon Resource Name (ARN) of a new + * certificate to Amazon Cognito. You cannot use it to change the domain for a user + * pool.

+ *

A custom domain is used to host the Amazon Cognito hosted UI, which provides sign-up + * and sign-in pages for your application. When you set up a custom domain, you provide a + * certificate that you manage with AWS Certificate Manager (ACM). When necessary, you can + * use this operation to change the certificate that you applied to your custom + * domain.

+ *

Usually, this is unnecessary following routine certificate renewal with ACM. When you + * renew your existing certificate in ACM, the ARN for your certificate remains the same, + * and your custom domain uses the new certificate automatically.

+ *

However, if you replace your existing certificate with a new one, ACM gives the new + * certificate a new ARN. To apply the new certificate to your custom domain, you must + * provide this ARN to Amazon Cognito.

+ *

When you add your new certificate in ACM, you must choose US East (N. Virginia) as the + * AWS Region.

+ *

After you submit your request, Amazon Cognito requires up to 1 hour to distribute your + * new certificate to your custom domain.

+ *

For more information about adding a custom domain to your user pool, see Using Your Own Domain for the Hosted UI.

+ */ export class UpdateUserPoolDomainCommand extends $Command< UpdateUserPoolDomainCommandInput, UpdateUserPoolDomainCommandOutput, @@ -39,6 +62,9 @@ export class UpdateUserPoolDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/VerifySoftwareTokenCommand.ts b/clients/client-cognito-identity-provider/commands/VerifySoftwareTokenCommand.ts index 3782562ede37e..17391d4a66d52 100644 --- a/clients/client-cognito-identity-provider/commands/VerifySoftwareTokenCommand.ts +++ b/clients/client-cognito-identity-provider/commands/VerifySoftwareTokenCommand.ts @@ -25,6 +25,11 @@ import { export type VerifySoftwareTokenCommandInput = VerifySoftwareTokenRequest; export type VerifySoftwareTokenCommandOutput = VerifySoftwareTokenResponse & __MetadataBearer; +/** + *

Use this API to register a user's entered TOTP code and mark the user's software token + * MFA status as "verified" if successful. The request takes an access token or a session + * string, but not both.

+ */ export class VerifySoftwareTokenCommand extends $Command< VerifySoftwareTokenCommandInput, VerifySoftwareTokenCommandOutput, @@ -39,6 +44,9 @@ export class VerifySoftwareTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/commands/VerifyUserAttributeCommand.ts b/clients/client-cognito-identity-provider/commands/VerifyUserAttributeCommand.ts index bddcf009c54fd..80fe6a76c294e 100644 --- a/clients/client-cognito-identity-provider/commands/VerifyUserAttributeCommand.ts +++ b/clients/client-cognito-identity-provider/commands/VerifyUserAttributeCommand.ts @@ -24,6 +24,9 @@ import { export type VerifyUserAttributeCommandInput = VerifyUserAttributeRequest; export type VerifyUserAttributeCommandOutput = VerifyUserAttributeResponse & __MetadataBearer; +/** + *

Verifies the specified user attributes in the user pool.

+ */ export class VerifyUserAttributeCommand extends $Command< VerifyUserAttributeCommandInput, VerifyUserAttributeCommandOutput, @@ -38,6 +41,9 @@ export class VerifyUserAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityProviderClientResolvedConfig, diff --git a/clients/client-cognito-identity-provider/package.json b/clients/client-cognito-identity-provider/package.json index ac7dfb6c12958..720f60fb446fe 100644 --- a/clients/client-cognito-identity-provider/package.json +++ b/clients/client-cognito-identity-provider/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cognito Identity Provider Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cognito-identity-provider/pagination/AdminListGroupsForUserPaginator.ts b/clients/client-cognito-identity-provider/pagination/AdminListGroupsForUserPaginator.ts index c539a75df32b1..33703acc43b42 100644 --- a/clients/client-cognito-identity-provider/pagination/AdminListGroupsForUserPaginator.ts +++ b/clients/client-cognito-identity-provider/pagination/AdminListGroupsForUserPaginator.ts @@ -8,6 +8,9 @@ import { import { CognitoIdentityProviderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CognitoIdentityProviderClient, input: AdminListGroupsForUserCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new AdminListGroupsForUserCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CognitoIdentityProvider, input: AdminListGroupsForUserCommandInput, diff --git a/clients/client-cognito-identity-provider/pagination/AdminListUserAuthEventsPaginator.ts b/clients/client-cognito-identity-provider/pagination/AdminListUserAuthEventsPaginator.ts index 7df348a6e625e..283ea413755d8 100644 --- a/clients/client-cognito-identity-provider/pagination/AdminListUserAuthEventsPaginator.ts +++ b/clients/client-cognito-identity-provider/pagination/AdminListUserAuthEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { CognitoIdentityProviderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CognitoIdentityProviderClient, input: AdminListUserAuthEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new AdminListUserAuthEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CognitoIdentityProvider, input: AdminListUserAuthEventsCommandInput, diff --git a/clients/client-cognito-identity-provider/pagination/ListGroupsPaginator.ts b/clients/client-cognito-identity-provider/pagination/ListGroupsPaginator.ts index 7270be8b10e13..3fae56dd041cd 100644 --- a/clients/client-cognito-identity-provider/pagination/ListGroupsPaginator.ts +++ b/clients/client-cognito-identity-provider/pagination/ListGroupsPaginator.ts @@ -4,6 +4,9 @@ import { ListGroupsCommand, ListGroupsCommandInput, ListGroupsCommandOutput } fr import { CognitoIdentityProviderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CognitoIdentityProviderClient, input: ListGroupsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CognitoIdentityProvider, input: ListGroupsCommandInput, diff --git a/clients/client-cognito-identity-provider/pagination/ListIdentityProvidersPaginator.ts b/clients/client-cognito-identity-provider/pagination/ListIdentityProvidersPaginator.ts index e3d835d9b2bf3..2576f828cd0b0 100644 --- a/clients/client-cognito-identity-provider/pagination/ListIdentityProvidersPaginator.ts +++ b/clients/client-cognito-identity-provider/pagination/ListIdentityProvidersPaginator.ts @@ -8,6 +8,9 @@ import { import { CognitoIdentityProviderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CognitoIdentityProviderClient, input: ListIdentityProvidersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListIdentityProvidersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CognitoIdentityProvider, input: ListIdentityProvidersCommandInput, diff --git a/clients/client-cognito-identity-provider/pagination/ListResourceServersPaginator.ts b/clients/client-cognito-identity-provider/pagination/ListResourceServersPaginator.ts index 091cbdaa7317b..ce74467af289a 100644 --- a/clients/client-cognito-identity-provider/pagination/ListResourceServersPaginator.ts +++ b/clients/client-cognito-identity-provider/pagination/ListResourceServersPaginator.ts @@ -8,6 +8,9 @@ import { import { CognitoIdentityProviderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CognitoIdentityProviderClient, input: ListResourceServersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourceServersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CognitoIdentityProvider, input: ListResourceServersCommandInput, diff --git a/clients/client-cognito-identity-provider/pagination/ListUserPoolClientsPaginator.ts b/clients/client-cognito-identity-provider/pagination/ListUserPoolClientsPaginator.ts index 41b15872ba560..da852d0349116 100644 --- a/clients/client-cognito-identity-provider/pagination/ListUserPoolClientsPaginator.ts +++ b/clients/client-cognito-identity-provider/pagination/ListUserPoolClientsPaginator.ts @@ -8,6 +8,9 @@ import { import { CognitoIdentityProviderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CognitoIdentityProviderClient, input: ListUserPoolClientsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUserPoolClientsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CognitoIdentityProvider, input: ListUserPoolClientsCommandInput, diff --git a/clients/client-cognito-identity-provider/pagination/ListUsersInGroupPaginator.ts b/clients/client-cognito-identity-provider/pagination/ListUsersInGroupPaginator.ts index 981c9958f2508..212e5a8f71303 100644 --- a/clients/client-cognito-identity-provider/pagination/ListUsersInGroupPaginator.ts +++ b/clients/client-cognito-identity-provider/pagination/ListUsersInGroupPaginator.ts @@ -8,6 +8,9 @@ import { import { CognitoIdentityProviderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CognitoIdentityProviderClient, input: ListUsersInGroupCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUsersInGroupCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CognitoIdentityProvider, input: ListUsersInGroupCommandInput, diff --git a/clients/client-cognito-identity-provider/pagination/ListUsersPaginator.ts b/clients/client-cognito-identity-provider/pagination/ListUsersPaginator.ts index 66a06a4ae22b3..c58c6b7427c92 100644 --- a/clients/client-cognito-identity-provider/pagination/ListUsersPaginator.ts +++ b/clients/client-cognito-identity-provider/pagination/ListUsersPaginator.ts @@ -4,6 +4,9 @@ import { ListUsersCommand, ListUsersCommandInput, ListUsersCommandOutput } from import { CognitoIdentityProviderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CognitoIdentityProviderClient, input: ListUsersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CognitoIdentityProvider, input: ListUsersCommandInput, diff --git a/clients/client-cognito-identity-provider/runtimeConfig.browser.ts b/clients/client-cognito-identity-provider/runtimeConfig.browser.ts index 68d00d6082b6e..8a30acf24e9ea 100644 --- a/clients/client-cognito-identity-provider/runtimeConfig.browser.ts +++ b/clients/client-cognito-identity-provider/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CognitoIdentityProviderClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cognito-identity-provider/runtimeConfig.native.ts b/clients/client-cognito-identity-provider/runtimeConfig.native.ts index a493d02cad937..402aecead4539 100644 --- a/clients/client-cognito-identity-provider/runtimeConfig.native.ts +++ b/clients/client-cognito-identity-provider/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CognitoIdentityProviderClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cognito-identity-provider/runtimeConfig.shared.ts b/clients/client-cognito-identity-provider/runtimeConfig.shared.ts index 623cbac65f05d..b601d05dc4575 100644 --- a/clients/client-cognito-identity-provider/runtimeConfig.shared.ts +++ b/clients/client-cognito-identity-provider/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-04-18", disableHostPrefix: false, diff --git a/clients/client-cognito-identity-provider/runtimeConfig.ts b/clients/client-cognito-identity-provider/runtimeConfig.ts index 92f76e51c14d0..e001c79a04e91 100644 --- a/clients/client-cognito-identity-provider/runtimeConfig.ts +++ b/clients/client-cognito-identity-provider/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CognitoIdentityProviderClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cognito-identity-provider/tsconfig.json b/clients/client-cognito-identity-provider/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cognito-identity-provider/tsconfig.json +++ b/clients/client-cognito-identity-provider/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cognito-identity/commands/CreateIdentityPoolCommand.ts b/clients/client-cognito-identity/commands/CreateIdentityPoolCommand.ts index 3fb4da8115282..196507a78d778 100644 --- a/clients/client-cognito-identity/commands/CreateIdentityPoolCommand.ts +++ b/clients/client-cognito-identity/commands/CreateIdentityPoolCommand.ts @@ -21,6 +21,35 @@ import { export type CreateIdentityPoolCommandInput = CreateIdentityPoolInput; export type CreateIdentityPoolCommandOutput = IdentityPool & __MetadataBearer; +/** + *

Creates a new identity pool. The identity pool is a store of user identity + * information that is specific to your AWS account. The keys for SupportedLoginProviders are as follows:

+ * + *
    + *
  • + *

    Facebook: graph.facebook.com + *

    + *
  • + *
  • + *

    Google: accounts.google.com + *

    + *
  • + *
  • + *

    Amazon: www.amazon.com + *

    + *
  • + *
  • + *

    Twitter: api.twitter.com + *

    + *
  • + *
  • + *

    Digits: www.digits.com + *

    + *
  • + *
+ * + *

You must use AWS Developer credentials to call this API.

+ */ export class CreateIdentityPoolCommand extends $Command< CreateIdentityPoolCommandInput, CreateIdentityPoolCommandOutput, @@ -35,6 +64,9 @@ export class CreateIdentityPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/DeleteIdentitiesCommand.ts b/clients/client-cognito-identity/commands/DeleteIdentitiesCommand.ts index f4f9683ca93c6..ec374f6422ca3 100644 --- a/clients/client-cognito-identity/commands/DeleteIdentitiesCommand.ts +++ b/clients/client-cognito-identity/commands/DeleteIdentitiesCommand.ts @@ -21,6 +21,11 @@ import { export type DeleteIdentitiesCommandInput = DeleteIdentitiesInput; export type DeleteIdentitiesCommandOutput = DeleteIdentitiesResponse & __MetadataBearer; +/** + *

Deletes identities from an identity pool. You can specify a list of 1-60 identities + * that you want to delete.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class DeleteIdentitiesCommand extends $Command< DeleteIdentitiesCommandInput, DeleteIdentitiesCommandOutput, @@ -35,6 +40,9 @@ export class DeleteIdentitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/DeleteIdentityPoolCommand.ts b/clients/client-cognito-identity/commands/DeleteIdentityPoolCommand.ts index 1ead6be2f3179..ac0f988505b51 100644 --- a/clients/client-cognito-identity/commands/DeleteIdentityPoolCommand.ts +++ b/clients/client-cognito-identity/commands/DeleteIdentityPoolCommand.ts @@ -21,6 +21,11 @@ import { export type DeleteIdentityPoolCommandInput = DeleteIdentityPoolInput; export type DeleteIdentityPoolCommandOutput = __MetadataBearer; +/** + *

Deletes an identity pool. Once a pool is deleted, users will not be able to + * authenticate with the pool.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class DeleteIdentityPoolCommand extends $Command< DeleteIdentityPoolCommandInput, DeleteIdentityPoolCommandOutput, @@ -35,6 +40,9 @@ export class DeleteIdentityPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/DescribeIdentityCommand.ts b/clients/client-cognito-identity/commands/DescribeIdentityCommand.ts index cce811fa9fed4..af1c65dd8efd5 100644 --- a/clients/client-cognito-identity/commands/DescribeIdentityCommand.ts +++ b/clients/client-cognito-identity/commands/DescribeIdentityCommand.ts @@ -21,6 +21,11 @@ import { export type DescribeIdentityCommandInput = DescribeIdentityInput; export type DescribeIdentityCommandOutput = IdentityDescription & __MetadataBearer; +/** + *

Returns metadata related to the given identity, including when the identity was + * created and any associated linked logins.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class DescribeIdentityCommand extends $Command< DescribeIdentityCommandInput, DescribeIdentityCommandOutput, @@ -35,6 +40,9 @@ export class DescribeIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/DescribeIdentityPoolCommand.ts b/clients/client-cognito-identity/commands/DescribeIdentityPoolCommand.ts index e9ab4f232efa4..8470847d1654d 100644 --- a/clients/client-cognito-identity/commands/DescribeIdentityPoolCommand.ts +++ b/clients/client-cognito-identity/commands/DescribeIdentityPoolCommand.ts @@ -21,6 +21,11 @@ import { export type DescribeIdentityPoolCommandInput = DescribeIdentityPoolInput; export type DescribeIdentityPoolCommandOutput = IdentityPool & __MetadataBearer; +/** + *

Gets details about a particular identity pool, including the pool name, ID + * description, creation date, and current number of users.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class DescribeIdentityPoolCommand extends $Command< DescribeIdentityPoolCommandInput, DescribeIdentityPoolCommandOutput, @@ -35,6 +40,9 @@ export class DescribeIdentityPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/GetCredentialsForIdentityCommand.ts b/clients/client-cognito-identity/commands/GetCredentialsForIdentityCommand.ts index 18d9b403113d5..c7c99df1001af 100644 --- a/clients/client-cognito-identity/commands/GetCredentialsForIdentityCommand.ts +++ b/clients/client-cognito-identity/commands/GetCredentialsForIdentityCommand.ts @@ -20,6 +20,13 @@ import { export type GetCredentialsForIdentityCommandInput = GetCredentialsForIdentityInput; export type GetCredentialsForIdentityCommandOutput = GetCredentialsForIdentityResponse & __MetadataBearer; +/** + *

Returns credentials for the provided identity ID. Any provided logins will be + * validated against supported login providers. If the token is for + * cognito-identity.amazonaws.com, it will be passed through to AWS Security Token Service + * with the appropriate role for the token.

+ *

This is a public API. You do not need any credentials to call this API.

+ */ export class GetCredentialsForIdentityCommand extends $Command< GetCredentialsForIdentityCommandInput, GetCredentialsForIdentityCommandOutput, @@ -34,6 +41,9 @@ export class GetCredentialsForIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/GetIdCommand.ts b/clients/client-cognito-identity/commands/GetIdCommand.ts index d4f5ca578c73f..538bbd8cc6e7e 100644 --- a/clients/client-cognito-identity/commands/GetIdCommand.ts +++ b/clients/client-cognito-identity/commands/GetIdCommand.ts @@ -17,6 +17,11 @@ import { export type GetIdCommandInput = GetIdInput; export type GetIdCommandOutput = GetIdResponse & __MetadataBearer; +/** + *

Generates (or retrieves) a Cognito ID. Supplying multiple logins will create an + * implicit linked account.

+ *

This is a public API. You do not need any credentials to call this API.

+ */ export class GetIdCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +32,9 @@ export class GetIdCommand extends $Command, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/GetIdentityPoolRolesCommand.ts b/clients/client-cognito-identity/commands/GetIdentityPoolRolesCommand.ts index 62d3a9ed74f42..2903d012f61d3 100644 --- a/clients/client-cognito-identity/commands/GetIdentityPoolRolesCommand.ts +++ b/clients/client-cognito-identity/commands/GetIdentityPoolRolesCommand.ts @@ -21,6 +21,10 @@ import { export type GetIdentityPoolRolesCommandInput = GetIdentityPoolRolesInput; export type GetIdentityPoolRolesCommandOutput = GetIdentityPoolRolesResponse & __MetadataBearer; +/** + *

Gets the roles for an identity pool.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class GetIdentityPoolRolesCommand extends $Command< GetIdentityPoolRolesCommandInput, GetIdentityPoolRolesCommandOutput, @@ -35,6 +39,9 @@ export class GetIdentityPoolRolesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/GetOpenIdTokenCommand.ts b/clients/client-cognito-identity/commands/GetOpenIdTokenCommand.ts index d3cfb0470a5c3..2ef3b25232051 100644 --- a/clients/client-cognito-identity/commands/GetOpenIdTokenCommand.ts +++ b/clients/client-cognito-identity/commands/GetOpenIdTokenCommand.ts @@ -20,6 +20,13 @@ import { export type GetOpenIdTokenCommandInput = GetOpenIdTokenInput; export type GetOpenIdTokenCommandOutput = GetOpenIdTokenResponse & __MetadataBearer; +/** + *

Gets an OpenID token, using a known Cognito ID. This known Cognito ID is returned by + * GetId. You can optionally add additional logins for the identity. + * Supplying multiple logins creates an implicit link.

+ *

The OpenId token is valid for 10 minutes.

+ *

This is a public API. You do not need any credentials to call this API.

+ */ export class GetOpenIdTokenCommand extends $Command< GetOpenIdTokenCommandInput, GetOpenIdTokenCommandOutput, @@ -34,6 +41,9 @@ export class GetOpenIdTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/GetOpenIdTokenForDeveloperIdentityCommand.ts b/clients/client-cognito-identity/commands/GetOpenIdTokenForDeveloperIdentityCommand.ts index 3d95ef660f93e..3573776fccab0 100644 --- a/clients/client-cognito-identity/commands/GetOpenIdTokenForDeveloperIdentityCommand.ts +++ b/clients/client-cognito-identity/commands/GetOpenIdTokenForDeveloperIdentityCommand.ts @@ -25,6 +25,21 @@ export type GetOpenIdTokenForDeveloperIdentityCommandInput = GetOpenIdTokenForDe export type GetOpenIdTokenForDeveloperIdentityCommandOutput = GetOpenIdTokenForDeveloperIdentityResponse & __MetadataBearer; +/** + *

Registers (or retrieves) a Cognito IdentityId and an OpenID Connect + * token for a user authenticated by your backend authentication process. Supplying multiple + * logins will create an implicit linked account. You can only specify one developer provider + * as part of the Logins map, which is linked to the identity pool. The developer + * provider is the "domain" by which Cognito will refer to your users.

+ *

You can use GetOpenIdTokenForDeveloperIdentity to create a new identity + * and to link new logins (that is, user credentials issued by a public provider or developer + * provider) to an existing identity. When you want to create a new identity, the + * IdentityId should be null. When you want to associate a new login with an + * existing authenticated/unauthenticated identity, you can do so by providing the existing + * IdentityId. This API will create the identity in the specified + * IdentityPoolId.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class GetOpenIdTokenForDeveloperIdentityCommand extends $Command< GetOpenIdTokenForDeveloperIdentityCommandInput, GetOpenIdTokenForDeveloperIdentityCommandOutput, @@ -39,6 +54,9 @@ export class GetOpenIdTokenForDeveloperIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/ListIdentitiesCommand.ts b/clients/client-cognito-identity/commands/ListIdentitiesCommand.ts index 914cc8f59cdd2..29659214bab93 100644 --- a/clients/client-cognito-identity/commands/ListIdentitiesCommand.ts +++ b/clients/client-cognito-identity/commands/ListIdentitiesCommand.ts @@ -21,6 +21,10 @@ import { export type ListIdentitiesCommandInput = ListIdentitiesInput; export type ListIdentitiesCommandOutput = ListIdentitiesResponse & __MetadataBearer; +/** + *

Lists the identities in an identity pool.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class ListIdentitiesCommand extends $Command< ListIdentitiesCommandInput, ListIdentitiesCommandOutput, @@ -35,6 +39,9 @@ export class ListIdentitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/ListIdentityPoolsCommand.ts b/clients/client-cognito-identity/commands/ListIdentityPoolsCommand.ts index 20aada183a037..6ffe4982bd1b7 100644 --- a/clients/client-cognito-identity/commands/ListIdentityPoolsCommand.ts +++ b/clients/client-cognito-identity/commands/ListIdentityPoolsCommand.ts @@ -21,6 +21,10 @@ import { export type ListIdentityPoolsCommandInput = ListIdentityPoolsInput; export type ListIdentityPoolsCommandOutput = ListIdentityPoolsResponse & __MetadataBearer; +/** + *

Lists all of the Cognito identity pools registered for your account.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class ListIdentityPoolsCommand extends $Command< ListIdentityPoolsCommandInput, ListIdentityPoolsCommandOutput, @@ -35,6 +39,9 @@ export class ListIdentityPoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/ListTagsForResourceCommand.ts b/clients/client-cognito-identity/commands/ListTagsForResourceCommand.ts index c3d4dd3f55ee3..74bd0ecc0fda3 100644 --- a/clients/client-cognito-identity/commands/ListTagsForResourceCommand.ts +++ b/clients/client-cognito-identity/commands/ListTagsForResourceCommand.ts @@ -21,6 +21,12 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags that are assigned to an Amazon Cognito identity pool.

+ *

A tag is a label that you can apply to identity pools to categorize and manage them in + * different ways, such as by purpose, owner, environment, or other criteria.

+ *

You can use this action up to 10 times per second, per account.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -35,6 +41,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/LookupDeveloperIdentityCommand.ts b/clients/client-cognito-identity/commands/LookupDeveloperIdentityCommand.ts index 686945418616e..bed1458937b4f 100644 --- a/clients/client-cognito-identity/commands/LookupDeveloperIdentityCommand.ts +++ b/clients/client-cognito-identity/commands/LookupDeveloperIdentityCommand.ts @@ -21,6 +21,25 @@ import { export type LookupDeveloperIdentityCommandInput = LookupDeveloperIdentityInput; export type LookupDeveloperIdentityCommandOutput = LookupDeveloperIdentityResponse & __MetadataBearer; +/** + *

Retrieves the IdentityID associated with a + * DeveloperUserIdentifier or the list of DeveloperUserIdentifier + * values associated with an IdentityId for an existing identity. Either + * IdentityID or DeveloperUserIdentifier must not be null. If you + * supply only one of these values, the other value will be searched in the database and + * returned as a part of the response. If you supply both, + * DeveloperUserIdentifier will be matched against IdentityID. If + * the values are verified against the database, the response returns both values and is the + * same as the request. Otherwise a ResourceConflictException is + * thrown.

+ *

+ * LookupDeveloperIdentity is intended for low-throughput control plane + * operations: for example, to enable customer service to locate an identity ID by username. + * If you are using it for higher-volume operations such as user authentication, your requests + * are likely to be throttled. GetOpenIdTokenForDeveloperIdentity is a + * better option for higher-volume operations for user authentication.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class LookupDeveloperIdentityCommand extends $Command< LookupDeveloperIdentityCommandInput, LookupDeveloperIdentityCommandOutput, @@ -35,6 +54,9 @@ export class LookupDeveloperIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/MergeDeveloperIdentitiesCommand.ts b/clients/client-cognito-identity/commands/MergeDeveloperIdentitiesCommand.ts index 31c50c3763f00..dce653c9598b5 100644 --- a/clients/client-cognito-identity/commands/MergeDeveloperIdentitiesCommand.ts +++ b/clients/client-cognito-identity/commands/MergeDeveloperIdentitiesCommand.ts @@ -21,6 +21,21 @@ import { export type MergeDeveloperIdentitiesCommandInput = MergeDeveloperIdentitiesInput; export type MergeDeveloperIdentitiesCommandOutput = MergeDeveloperIdentitiesResponse & __MetadataBearer; +/** + *

Merges two users having different IdentityIds, existing in the same + * identity pool, and identified by the same developer provider. You can use this action to + * request that discrete users be merged and identified as a single user in the Cognito + * environment. Cognito associates the given source user (SourceUserIdentifier) + * with the IdentityId of the DestinationUserIdentifier. Only + * developer-authenticated users can be merged. If the users to be merged are associated with + * the same public provider, but as two different users, an exception will be + * thrown.

+ *

The number of linked logins is limited to 20. So, the number of linked logins for the + * source user, SourceUserIdentifier, and the destination user, + * DestinationUserIdentifier, together should not be larger than 20. + * Otherwise, an exception will be thrown.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class MergeDeveloperIdentitiesCommand extends $Command< MergeDeveloperIdentitiesCommandInput, MergeDeveloperIdentitiesCommandOutput, @@ -35,6 +50,9 @@ export class MergeDeveloperIdentitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/SetIdentityPoolRolesCommand.ts b/clients/client-cognito-identity/commands/SetIdentityPoolRolesCommand.ts index fb5a7df30d32d..9df449f812912 100644 --- a/clients/client-cognito-identity/commands/SetIdentityPoolRolesCommand.ts +++ b/clients/client-cognito-identity/commands/SetIdentityPoolRolesCommand.ts @@ -21,6 +21,10 @@ import { export type SetIdentityPoolRolesCommandInput = SetIdentityPoolRolesInput; export type SetIdentityPoolRolesCommandOutput = __MetadataBearer; +/** + *

Sets the roles for an identity pool. These roles are used when making calls to GetCredentialsForIdentity action.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class SetIdentityPoolRolesCommand extends $Command< SetIdentityPoolRolesCommandInput, SetIdentityPoolRolesCommandOutput, @@ -35,6 +39,9 @@ export class SetIdentityPoolRolesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/TagResourceCommand.ts b/clients/client-cognito-identity/commands/TagResourceCommand.ts index d52d6e3b00e2a..249d7f26a215c 100644 --- a/clients/client-cognito-identity/commands/TagResourceCommand.ts +++ b/clients/client-cognito-identity/commands/TagResourceCommand.ts @@ -21,6 +21,23 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Assigns a set of tags to an Amazon Cognito identity pool. A tag is a label that you can + * use to categorize and manage identity pools in different ways, such as by purpose, owner, + * environment, or other criteria.

+ *

Each tag consists of a key and value, both of which you define. A key is a general + * category for more specific values. For example, if you have two versions of an identity + * pool, one for testing and another for production, you might assign an + * Environment tag key to both identity pools. The value of this key might be + * Test for one identity pool and Production for the + * other.

+ *

Tags are useful for cost tracking and access control. You can activate your tags so that + * they appear on the Billing and Cost Management console, where you can track the costs + * associated with your identity pools. In an IAM policy, you can constrain permissions for + * identity pools based on specific tags or tag values.

+ *

You can use this action up to 5 times per second, per account. An identity pool can have + * as many as 50 tags.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -35,6 +52,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/UnlinkDeveloperIdentityCommand.ts b/clients/client-cognito-identity/commands/UnlinkDeveloperIdentityCommand.ts index 6278278d6b3f1..808273d105268 100644 --- a/clients/client-cognito-identity/commands/UnlinkDeveloperIdentityCommand.ts +++ b/clients/client-cognito-identity/commands/UnlinkDeveloperIdentityCommand.ts @@ -21,6 +21,13 @@ import { export type UnlinkDeveloperIdentityCommandInput = UnlinkDeveloperIdentityInput; export type UnlinkDeveloperIdentityCommandOutput = __MetadataBearer; +/** + *

Unlinks a DeveloperUserIdentifier from an existing identity. Unlinked + * developer users will be considered new identities next time they are seen. If, for a given + * Cognito identity, you remove all federated identities as well as the developer user + * identifier, the Cognito identity becomes inaccessible.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class UnlinkDeveloperIdentityCommand extends $Command< UnlinkDeveloperIdentityCommandInput, UnlinkDeveloperIdentityCommandOutput, @@ -35,6 +42,9 @@ export class UnlinkDeveloperIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/UnlinkIdentityCommand.ts b/clients/client-cognito-identity/commands/UnlinkIdentityCommand.ts index a0369a00aa2e4..7df7450b450ef 100644 --- a/clients/client-cognito-identity/commands/UnlinkIdentityCommand.ts +++ b/clients/client-cognito-identity/commands/UnlinkIdentityCommand.ts @@ -20,6 +20,12 @@ import { export type UnlinkIdentityCommandInput = UnlinkIdentityInput; export type UnlinkIdentityCommandOutput = __MetadataBearer; +/** + *

Unlinks a federated identity from an existing account. Unlinked logins will be + * considered new identities next time they are seen. Removing the last linked login will make + * this identity inaccessible.

+ *

This is a public API. You do not need any credentials to call this API.

+ */ export class UnlinkIdentityCommand extends $Command< UnlinkIdentityCommandInput, UnlinkIdentityCommandOutput, @@ -34,6 +40,9 @@ export class UnlinkIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/UntagResourceCommand.ts b/clients/client-cognito-identity/commands/UntagResourceCommand.ts index 1bd6c8fd7ffd6..976be022b7e0e 100644 --- a/clients/client-cognito-identity/commands/UntagResourceCommand.ts +++ b/clients/client-cognito-identity/commands/UntagResourceCommand.ts @@ -21,6 +21,10 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the specified tags from an Amazon Cognito identity pool. You can use this action + * up to 5 times per second, per account

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -35,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/commands/UpdateIdentityPoolCommand.ts b/clients/client-cognito-identity/commands/UpdateIdentityPoolCommand.ts index 5b0c8800f6c9a..af316e4f48d30 100644 --- a/clients/client-cognito-identity/commands/UpdateIdentityPoolCommand.ts +++ b/clients/client-cognito-identity/commands/UpdateIdentityPoolCommand.ts @@ -21,6 +21,10 @@ import { export type UpdateIdentityPoolCommandInput = IdentityPool; export type UpdateIdentityPoolCommandOutput = IdentityPool & __MetadataBearer; +/** + *

Updates an identity pool.

+ *

You must use AWS Developer credentials to call this API.

+ */ export class UpdateIdentityPoolCommand extends $Command< UpdateIdentityPoolCommandInput, UpdateIdentityPoolCommandOutput, @@ -35,6 +39,9 @@ export class UpdateIdentityPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoIdentityClientResolvedConfig, diff --git a/clients/client-cognito-identity/package.json b/clients/client-cognito-identity/package.json index c47871d640768..688616a9cd396 100644 --- a/clients/client-cognito-identity/package.json +++ b/clients/client-cognito-identity/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cognito Identity Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -68,7 +68,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cognito-identity/runtimeConfig.browser.ts b/clients/client-cognito-identity/runtimeConfig.browser.ts index 40e5d2141e45f..146e1a7c804ed 100644 --- a/clients/client-cognito-identity/runtimeConfig.browser.ts +++ b/clients/client-cognito-identity/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CognitoIdentityClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cognito-identity/runtimeConfig.native.ts b/clients/client-cognito-identity/runtimeConfig.native.ts index 61216dd52a273..870131af0bef5 100644 --- a/clients/client-cognito-identity/runtimeConfig.native.ts +++ b/clients/client-cognito-identity/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CognitoIdentityClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cognito-identity/runtimeConfig.shared.ts b/clients/client-cognito-identity/runtimeConfig.shared.ts index 4ed22f0597e14..4917347af1398 100644 --- a/clients/client-cognito-identity/runtimeConfig.shared.ts +++ b/clients/client-cognito-identity/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-06-30", disableHostPrefix: false, diff --git a/clients/client-cognito-identity/runtimeConfig.ts b/clients/client-cognito-identity/runtimeConfig.ts index 52acf8c51d3d4..c59f39f9f13f8 100644 --- a/clients/client-cognito-identity/runtimeConfig.ts +++ b/clients/client-cognito-identity/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CognitoIdentityClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cognito-identity/tsconfig.json b/clients/client-cognito-identity/tsconfig.json index d0a09bf323180..f994bbf7c065f 100644 --- a/clients/client-cognito-identity/tsconfig.json +++ b/clients/client-cognito-identity/tsconfig.json @@ -17,13 +17,16 @@ "types": ["mocha", "node"] }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cognito-sync/commands/BulkPublishCommand.ts b/clients/client-cognito-sync/commands/BulkPublishCommand.ts index a02c47532bd9c..65951c3052666 100644 --- a/clients/client-cognito-sync/commands/BulkPublishCommand.ts +++ b/clients/client-cognito-sync/commands/BulkPublishCommand.ts @@ -20,6 +20,10 @@ import { export type BulkPublishCommandInput = BulkPublishRequest; export type BulkPublishCommandOutput = BulkPublishResponse & __MetadataBearer; +/** + *

Initiates a bulk publish of all existing datasets for an Identity Pool to the configured stream. Customers are limited to one successful bulk publish per 24 hours. Bulk publish is an asynchronous request, customers can see the status of the request via the GetBulkPublishDetails operation.

+ *

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

+ */ export class BulkPublishCommand extends $Command< BulkPublishCommandInput, BulkPublishCommandOutput, @@ -34,6 +38,9 @@ export class BulkPublishCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/DeleteDatasetCommand.ts b/clients/client-cognito-sync/commands/DeleteDatasetCommand.ts index 0885a6c179c53..1fd4a5b70825d 100644 --- a/clients/client-cognito-sync/commands/DeleteDatasetCommand.ts +++ b/clients/client-cognito-sync/commands/DeleteDatasetCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDatasetCommandInput = DeleteDatasetRequest; export type DeleteDatasetCommandOutput = DeleteDatasetResponse & __MetadataBearer; +/** + *

Deletes the specific dataset. The dataset will be deleted permanently, and the action can't be undone. Datasets that this dataset was merged with will no longer report the merge. Any subsequent operation on this dataset will result in a ResourceNotFoundException.

+ *

This API can be called with temporary user credentials provided by Cognito Identity or with developer credentials.

+ */ export class DeleteDatasetCommand extends $Command< DeleteDatasetCommandInput, DeleteDatasetCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/DescribeDatasetCommand.ts b/clients/client-cognito-sync/commands/DescribeDatasetCommand.ts index 19788ce8c8a78..e8bdf3587fb37 100644 --- a/clients/client-cognito-sync/commands/DescribeDatasetCommand.ts +++ b/clients/client-cognito-sync/commands/DescribeDatasetCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDatasetCommandInput = DescribeDatasetRequest; export type DescribeDatasetCommandOutput = DescribeDatasetResponse & __MetadataBearer; +/** + *

Gets meta data about a dataset by identity and dataset name. With Amazon Cognito Sync, each identity has access only to its own data. Thus, the credentials used to make this API call need to have access to the identity data.

+ *

This API can be called with temporary user credentials provided by Cognito Identity or with developer credentials. You should use Cognito Identity credentials to make this API call.

+ */ export class DescribeDatasetCommand extends $Command< DescribeDatasetCommandInput, DescribeDatasetCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/DescribeIdentityPoolUsageCommand.ts b/clients/client-cognito-sync/commands/DescribeIdentityPoolUsageCommand.ts index 4d92a7c91fa0f..2482d6a02eb55 100644 --- a/clients/client-cognito-sync/commands/DescribeIdentityPoolUsageCommand.ts +++ b/clients/client-cognito-sync/commands/DescribeIdentityPoolUsageCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeIdentityPoolUsageCommandInput = DescribeIdentityPoolUsageRequest; export type DescribeIdentityPoolUsageCommandOutput = DescribeIdentityPoolUsageResponse & __MetadataBearer; +/** + *

Gets usage details (for example, data storage) about a particular identity pool.

+ *

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

+ */ export class DescribeIdentityPoolUsageCommand extends $Command< DescribeIdentityPoolUsageCommandInput, DescribeIdentityPoolUsageCommandOutput, @@ -34,6 +38,9 @@ export class DescribeIdentityPoolUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/DescribeIdentityUsageCommand.ts b/clients/client-cognito-sync/commands/DescribeIdentityUsageCommand.ts index 6406838dac8e5..0217c47933127 100644 --- a/clients/client-cognito-sync/commands/DescribeIdentityUsageCommand.ts +++ b/clients/client-cognito-sync/commands/DescribeIdentityUsageCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeIdentityUsageCommandInput = DescribeIdentityUsageRequest; export type DescribeIdentityUsageCommandOutput = DescribeIdentityUsageResponse & __MetadataBearer; +/** + *

Gets usage information for an identity, including number of datasets and data usage.

+ *

This API can be called with temporary user credentials provided by Cognito Identity or with developer credentials.

+ */ export class DescribeIdentityUsageCommand extends $Command< DescribeIdentityUsageCommandInput, DescribeIdentityUsageCommandOutput, @@ -34,6 +38,9 @@ export class DescribeIdentityUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/GetBulkPublishDetailsCommand.ts b/clients/client-cognito-sync/commands/GetBulkPublishDetailsCommand.ts index 191c5babbbaa0..415c1c926ca93 100644 --- a/clients/client-cognito-sync/commands/GetBulkPublishDetailsCommand.ts +++ b/clients/client-cognito-sync/commands/GetBulkPublishDetailsCommand.ts @@ -20,6 +20,10 @@ import { export type GetBulkPublishDetailsCommandInput = GetBulkPublishDetailsRequest; export type GetBulkPublishDetailsCommandOutput = GetBulkPublishDetailsResponse & __MetadataBearer; +/** + *

Get the status of the last BulkPublish operation for an identity pool.

+ *

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

+ */ export class GetBulkPublishDetailsCommand extends $Command< GetBulkPublishDetailsCommandInput, GetBulkPublishDetailsCommandOutput, @@ -34,6 +38,9 @@ export class GetBulkPublishDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/GetCognitoEventsCommand.ts b/clients/client-cognito-sync/commands/GetCognitoEventsCommand.ts index 11fde639bf88b..98ff8fe9466e4 100644 --- a/clients/client-cognito-sync/commands/GetCognitoEventsCommand.ts +++ b/clients/client-cognito-sync/commands/GetCognitoEventsCommand.ts @@ -20,6 +20,10 @@ import { export type GetCognitoEventsCommandInput = GetCognitoEventsRequest; export type GetCognitoEventsCommandOutput = GetCognitoEventsResponse & __MetadataBearer; +/** + *

Gets the events and the corresponding Lambda functions associated with an identity pool.

+ *

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

+ */ export class GetCognitoEventsCommand extends $Command< GetCognitoEventsCommandInput, GetCognitoEventsCommandOutput, @@ -34,6 +38,9 @@ export class GetCognitoEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/GetIdentityPoolConfigurationCommand.ts b/clients/client-cognito-sync/commands/GetIdentityPoolConfigurationCommand.ts index e44fb9f5aa247..591432dd18825 100644 --- a/clients/client-cognito-sync/commands/GetIdentityPoolConfigurationCommand.ts +++ b/clients/client-cognito-sync/commands/GetIdentityPoolConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type GetIdentityPoolConfigurationCommandInput = GetIdentityPoolConfigurationRequest; export type GetIdentityPoolConfigurationCommandOutput = GetIdentityPoolConfigurationResponse & __MetadataBearer; +/** + *

Gets the configuration settings of an identity pool.

+ *

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

+ */ export class GetIdentityPoolConfigurationCommand extends $Command< GetIdentityPoolConfigurationCommandInput, GetIdentityPoolConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class GetIdentityPoolConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/ListDatasetsCommand.ts b/clients/client-cognito-sync/commands/ListDatasetsCommand.ts index d800d97ef794f..bcbda8c064ebc 100644 --- a/clients/client-cognito-sync/commands/ListDatasetsCommand.ts +++ b/clients/client-cognito-sync/commands/ListDatasetsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDatasetsCommandInput = ListDatasetsRequest; export type ListDatasetsCommandOutput = ListDatasetsResponse & __MetadataBearer; +/** + *

Lists datasets for an identity. With Amazon Cognito Sync, each identity has access only to its own data. Thus, the credentials used to make this API call need to have access to the identity data.

+ *

ListDatasets can be called with temporary user credentials provided by Cognito Identity or with developer credentials. You should use the Cognito Identity credentials to make this API call.

+ */ export class ListDatasetsCommand extends $Command< ListDatasetsCommandInput, ListDatasetsCommandOutput, @@ -34,6 +38,9 @@ export class ListDatasetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/ListIdentityPoolUsageCommand.ts b/clients/client-cognito-sync/commands/ListIdentityPoolUsageCommand.ts index 050f18e01d2f7..e40948431038b 100644 --- a/clients/client-cognito-sync/commands/ListIdentityPoolUsageCommand.ts +++ b/clients/client-cognito-sync/commands/ListIdentityPoolUsageCommand.ts @@ -20,6 +20,10 @@ import { export type ListIdentityPoolUsageCommandInput = ListIdentityPoolUsageRequest; export type ListIdentityPoolUsageCommandOutput = ListIdentityPoolUsageResponse & __MetadataBearer; +/** + *

Gets a list of identity pools registered with Cognito.

+ *

ListIdentityPoolUsage can only be called with developer credentials. You cannot make this API call with the temporary user credentials provided by Cognito Identity.

+ */ export class ListIdentityPoolUsageCommand extends $Command< ListIdentityPoolUsageCommandInput, ListIdentityPoolUsageCommandOutput, @@ -34,6 +38,9 @@ export class ListIdentityPoolUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/ListRecordsCommand.ts b/clients/client-cognito-sync/commands/ListRecordsCommand.ts index 602d133b54baa..4854270783e78 100644 --- a/clients/client-cognito-sync/commands/ListRecordsCommand.ts +++ b/clients/client-cognito-sync/commands/ListRecordsCommand.ts @@ -20,6 +20,10 @@ import { export type ListRecordsCommandInput = ListRecordsRequest; export type ListRecordsCommandOutput = ListRecordsResponse & __MetadataBearer; +/** + *

Gets paginated records, optionally changed after a particular sync count for a dataset and identity. With Amazon Cognito Sync, each identity has access only to its own data. Thus, the credentials used to make this API call need to have access to the identity data.

+ *

ListRecords can be called with temporary user credentials provided by Cognito Identity or with developer credentials. You should use Cognito Identity credentials to make this API call.

+ */ export class ListRecordsCommand extends $Command< ListRecordsCommandInput, ListRecordsCommandOutput, @@ -34,6 +38,9 @@ export class ListRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/RegisterDeviceCommand.ts b/clients/client-cognito-sync/commands/RegisterDeviceCommand.ts index ce1a3db9a8c65..dfe57fa2c5f40 100644 --- a/clients/client-cognito-sync/commands/RegisterDeviceCommand.ts +++ b/clients/client-cognito-sync/commands/RegisterDeviceCommand.ts @@ -20,6 +20,10 @@ import { export type RegisterDeviceCommandInput = RegisterDeviceRequest; export type RegisterDeviceCommandOutput = RegisterDeviceResponse & __MetadataBearer; +/** + *

Registers a device to receive push sync notifications.

+ *

This API can only be called with temporary credentials provided by Cognito Identity. You cannot call this API with developer credentials.

+ */ export class RegisterDeviceCommand extends $Command< RegisterDeviceCommandInput, RegisterDeviceCommandOutput, @@ -34,6 +38,9 @@ export class RegisterDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/SetCognitoEventsCommand.ts b/clients/client-cognito-sync/commands/SetCognitoEventsCommand.ts index 0607aebbf4257..ff704b4cc5f21 100644 --- a/clients/client-cognito-sync/commands/SetCognitoEventsCommand.ts +++ b/clients/client-cognito-sync/commands/SetCognitoEventsCommand.ts @@ -20,6 +20,10 @@ import { export type SetCognitoEventsCommandInput = SetCognitoEventsRequest; export type SetCognitoEventsCommandOutput = __MetadataBearer; +/** + *

Sets the AWS Lambda function for a given event type for an identity pool. This request only updates the key/value pair specified. Other key/values pairs are not updated. To remove a key value pair, pass a empty value for the particular key.

+ *

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

+ */ export class SetCognitoEventsCommand extends $Command< SetCognitoEventsCommandInput, SetCognitoEventsCommandOutput, @@ -34,6 +38,9 @@ export class SetCognitoEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/SetIdentityPoolConfigurationCommand.ts b/clients/client-cognito-sync/commands/SetIdentityPoolConfigurationCommand.ts index eaa30d6ef7126..1e54662b6907f 100644 --- a/clients/client-cognito-sync/commands/SetIdentityPoolConfigurationCommand.ts +++ b/clients/client-cognito-sync/commands/SetIdentityPoolConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type SetIdentityPoolConfigurationCommandInput = SetIdentityPoolConfigurationRequest; export type SetIdentityPoolConfigurationCommandOutput = SetIdentityPoolConfigurationResponse & __MetadataBearer; +/** + *

Sets the necessary configuration for push sync.

+ *

This API can only be called with developer credentials. You cannot call this API with the temporary user credentials provided by Cognito Identity.

+ */ export class SetIdentityPoolConfigurationCommand extends $Command< SetIdentityPoolConfigurationCommandInput, SetIdentityPoolConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class SetIdentityPoolConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/SubscribeToDatasetCommand.ts b/clients/client-cognito-sync/commands/SubscribeToDatasetCommand.ts index fc786cf681f4b..f09537cb120b8 100644 --- a/clients/client-cognito-sync/commands/SubscribeToDatasetCommand.ts +++ b/clients/client-cognito-sync/commands/SubscribeToDatasetCommand.ts @@ -20,6 +20,10 @@ import { export type SubscribeToDatasetCommandInput = SubscribeToDatasetRequest; export type SubscribeToDatasetCommandOutput = SubscribeToDatasetResponse & __MetadataBearer; +/** + *

Subscribes to receive notifications when a dataset is modified by another device.

+ *

This API can only be called with temporary credentials provided by Cognito Identity. You cannot call this API with developer credentials.

+ */ export class SubscribeToDatasetCommand extends $Command< SubscribeToDatasetCommandInput, SubscribeToDatasetCommandOutput, @@ -34,6 +38,9 @@ export class SubscribeToDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/UnsubscribeFromDatasetCommand.ts b/clients/client-cognito-sync/commands/UnsubscribeFromDatasetCommand.ts index 9c392a3f68ed1..ec8f9687aa0da 100644 --- a/clients/client-cognito-sync/commands/UnsubscribeFromDatasetCommand.ts +++ b/clients/client-cognito-sync/commands/UnsubscribeFromDatasetCommand.ts @@ -20,6 +20,10 @@ import { export type UnsubscribeFromDatasetCommandInput = UnsubscribeFromDatasetRequest; export type UnsubscribeFromDatasetCommandOutput = UnsubscribeFromDatasetResponse & __MetadataBearer; +/** + *

Unsubscribes from receiving notifications when a dataset is modified by another device.

+ *

This API can only be called with temporary credentials provided by Cognito Identity. You cannot call this API with developer credentials.

+ */ export class UnsubscribeFromDatasetCommand extends $Command< UnsubscribeFromDatasetCommandInput, UnsubscribeFromDatasetCommandOutput, @@ -34,6 +38,9 @@ export class UnsubscribeFromDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/commands/UpdateRecordsCommand.ts b/clients/client-cognito-sync/commands/UpdateRecordsCommand.ts index 104655a2cd101..f97ddaabb5ac6 100644 --- a/clients/client-cognito-sync/commands/UpdateRecordsCommand.ts +++ b/clients/client-cognito-sync/commands/UpdateRecordsCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateRecordsCommandInput = UpdateRecordsRequest; export type UpdateRecordsCommandOutput = UpdateRecordsResponse & __MetadataBearer; +/** + *

Posts updates to records and adds and deletes records for a dataset and user.

+ *

The sync count in the record patch is your last known sync count for that record. The server will reject an UpdateRecords request with a ResourceConflictException if you try to patch a record with a new value but a stale sync count.

+ *

For example, if the sync count on the server is 5 for a key called highScore and you try and submit a new highScore with sync count of 4, the request will be rejected. To obtain the current sync count for a record, call ListRecords. On a successful update of the record, the response returns the new sync count for that record. You should present that sync count the next time you try to update that same record. When the record does not exist, specify the sync count as 0.

+ *

This API can be called with temporary user credentials provided by Cognito Identity or with developer credentials.

+ */ export class UpdateRecordsCommand extends $Command< UpdateRecordsCommandInput, UpdateRecordsCommandOutput, @@ -34,6 +40,9 @@ export class UpdateRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CognitoSyncClientResolvedConfig, diff --git a/clients/client-cognito-sync/package.json b/clients/client-cognito-sync/package.json index 8442ddd796b68..f67fe85b70502 100644 --- a/clients/client-cognito-sync/package.json +++ b/clients/client-cognito-sync/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cognito Sync Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cognito-sync/runtimeConfig.browser.ts b/clients/client-cognito-sync/runtimeConfig.browser.ts index 074b29bbe9df0..0c2ac580cdd50 100644 --- a/clients/client-cognito-sync/runtimeConfig.browser.ts +++ b/clients/client-cognito-sync/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CognitoSyncClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cognito-sync/runtimeConfig.native.ts b/clients/client-cognito-sync/runtimeConfig.native.ts index bd880f52e0215..f7a473853ce85 100644 --- a/clients/client-cognito-sync/runtimeConfig.native.ts +++ b/clients/client-cognito-sync/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CognitoSyncClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cognito-sync/runtimeConfig.shared.ts b/clients/client-cognito-sync/runtimeConfig.shared.ts index ccd21cd95974d..2a3dbf3c9ec7c 100644 --- a/clients/client-cognito-sync/runtimeConfig.shared.ts +++ b/clients/client-cognito-sync/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-06-30", disableHostPrefix: false, diff --git a/clients/client-cognito-sync/runtimeConfig.ts b/clients/client-cognito-sync/runtimeConfig.ts index 29ae7cc6bb8ad..b0c6f72106f30 100644 --- a/clients/client-cognito-sync/runtimeConfig.ts +++ b/clients/client-cognito-sync/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CognitoSyncClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cognito-sync/tsconfig.json b/clients/client-cognito-sync/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cognito-sync/tsconfig.json +++ b/clients/client-cognito-sync/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-comprehend/commands/BatchDetectDominantLanguageCommand.ts b/clients/client-comprehend/commands/BatchDetectDominantLanguageCommand.ts index 17cb2207d4ec7..e8afab471ae57 100644 --- a/clients/client-comprehend/commands/BatchDetectDominantLanguageCommand.ts +++ b/clients/client-comprehend/commands/BatchDetectDominantLanguageCommand.ts @@ -20,6 +20,11 @@ import { export type BatchDetectDominantLanguageCommandInput = BatchDetectDominantLanguageRequest; export type BatchDetectDominantLanguageCommandOutput = BatchDetectDominantLanguageResponse & __MetadataBearer; +/** + *

Determines the dominant language of the input text for a batch of documents. For a list + * of languages that Amazon Comprehend can detect, see Amazon Comprehend Supported Languages. + *

+ */ export class BatchDetectDominantLanguageCommand extends $Command< BatchDetectDominantLanguageCommandInput, BatchDetectDominantLanguageCommandOutput, @@ -34,6 +39,9 @@ export class BatchDetectDominantLanguageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/BatchDetectEntitiesCommand.ts b/clients/client-comprehend/commands/BatchDetectEntitiesCommand.ts index 6c19d76806ece..9099546ef9afd 100644 --- a/clients/client-comprehend/commands/BatchDetectEntitiesCommand.ts +++ b/clients/client-comprehend/commands/BatchDetectEntitiesCommand.ts @@ -20,6 +20,11 @@ import { export type BatchDetectEntitiesCommandInput = BatchDetectEntitiesRequest; export type BatchDetectEntitiesCommandOutput = BatchDetectEntitiesResponse & __MetadataBearer; +/** + *

Inspects the text of a batch of documents for named entities and returns information + * about them. For more information about named entities, see how-entities + *

+ */ export class BatchDetectEntitiesCommand extends $Command< BatchDetectEntitiesCommandInput, BatchDetectEntitiesCommandOutput, @@ -34,6 +39,9 @@ export class BatchDetectEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/BatchDetectKeyPhrasesCommand.ts b/clients/client-comprehend/commands/BatchDetectKeyPhrasesCommand.ts index 14d5bb875a529..59ec313b70bc3 100644 --- a/clients/client-comprehend/commands/BatchDetectKeyPhrasesCommand.ts +++ b/clients/client-comprehend/commands/BatchDetectKeyPhrasesCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDetectKeyPhrasesCommandInput = BatchDetectKeyPhrasesRequest; export type BatchDetectKeyPhrasesCommandOutput = BatchDetectKeyPhrasesResponse & __MetadataBearer; +/** + *

Detects the key noun phrases found in a batch of documents.

+ */ export class BatchDetectKeyPhrasesCommand extends $Command< BatchDetectKeyPhrasesCommandInput, BatchDetectKeyPhrasesCommandOutput, @@ -34,6 +37,9 @@ export class BatchDetectKeyPhrasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/BatchDetectSentimentCommand.ts b/clients/client-comprehend/commands/BatchDetectSentimentCommand.ts index a2aabbbef56c9..4ecc36c9bb484 100644 --- a/clients/client-comprehend/commands/BatchDetectSentimentCommand.ts +++ b/clients/client-comprehend/commands/BatchDetectSentimentCommand.ts @@ -20,6 +20,11 @@ import { export type BatchDetectSentimentCommandInput = BatchDetectSentimentRequest; export type BatchDetectSentimentCommandOutput = BatchDetectSentimentResponse & __MetadataBearer; +/** + *

Inspects a batch of documents and returns an inference of the prevailing sentiment, + * POSITIVE, NEUTRAL, MIXED, or NEGATIVE, + * in each one.

+ */ export class BatchDetectSentimentCommand extends $Command< BatchDetectSentimentCommandInput, BatchDetectSentimentCommandOutput, @@ -34,6 +39,9 @@ export class BatchDetectSentimentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/BatchDetectSyntaxCommand.ts b/clients/client-comprehend/commands/BatchDetectSyntaxCommand.ts index c2f931191a1f1..7f7ecc469749a 100644 --- a/clients/client-comprehend/commands/BatchDetectSyntaxCommand.ts +++ b/clients/client-comprehend/commands/BatchDetectSyntaxCommand.ts @@ -20,6 +20,10 @@ import { export type BatchDetectSyntaxCommandInput = BatchDetectSyntaxRequest; export type BatchDetectSyntaxCommandOutput = BatchDetectSyntaxResponse & __MetadataBearer; +/** + *

Inspects the text of a batch of documents for the syntax and part of speech of the words + * in the document and returns information about them. For more information, see how-syntax.

+ */ export class BatchDetectSyntaxCommand extends $Command< BatchDetectSyntaxCommandInput, BatchDetectSyntaxCommandOutput, @@ -34,6 +38,9 @@ export class BatchDetectSyntaxCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ClassifyDocumentCommand.ts b/clients/client-comprehend/commands/ClassifyDocumentCommand.ts index 61746c2aa803a..3b3f1caf187bf 100644 --- a/clients/client-comprehend/commands/ClassifyDocumentCommand.ts +++ b/clients/client-comprehend/commands/ClassifyDocumentCommand.ts @@ -20,6 +20,10 @@ import { export type ClassifyDocumentCommandInput = ClassifyDocumentRequest; export type ClassifyDocumentCommandOutput = ClassifyDocumentResponse & __MetadataBearer; +/** + *

Creates a new document classification request to analyze a single document in real-time, + * using a previously created and trained custom model and an endpoint.

+ */ export class ClassifyDocumentCommand extends $Command< ClassifyDocumentCommandInput, ClassifyDocumentCommandOutput, @@ -34,6 +38,9 @@ export class ClassifyDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/CreateDocumentClassifierCommand.ts b/clients/client-comprehend/commands/CreateDocumentClassifierCommand.ts index b611570c6a0fe..78f2482728fb2 100644 --- a/clients/client-comprehend/commands/CreateDocumentClassifierCommand.ts +++ b/clients/client-comprehend/commands/CreateDocumentClassifierCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDocumentClassifierCommandInput = CreateDocumentClassifierRequest; export type CreateDocumentClassifierCommandOutput = CreateDocumentClassifierResponse & __MetadataBearer; +/** + *

Creates a new document classifier that you can use to categorize documents. To create a + * classifier, you provide a set of training documents that labeled with the categories that you + * want to use. After the classifier is trained you can use it to categorize a set of labeled + * documents into the categories. For more information, see how-document-classification.

+ */ export class CreateDocumentClassifierCommand extends $Command< CreateDocumentClassifierCommandInput, CreateDocumentClassifierCommandOutput, @@ -34,6 +40,9 @@ export class CreateDocumentClassifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/CreateEndpointCommand.ts b/clients/client-comprehend/commands/CreateEndpointCommand.ts index 536781f116909..65be0ab17d539 100644 --- a/clients/client-comprehend/commands/CreateEndpointCommand.ts +++ b/clients/client-comprehend/commands/CreateEndpointCommand.ts @@ -20,6 +20,11 @@ import { export type CreateEndpointCommandInput = CreateEndpointRequest; export type CreateEndpointCommandOutput = CreateEndpointResponse & __MetadataBearer; +/** + *

Creates a model-specific endpoint for synchronous inference for a previously trained + * custom model + *

+ */ export class CreateEndpointCommand extends $Command< CreateEndpointCommandInput, CreateEndpointCommandOutput, @@ -34,6 +39,9 @@ export class CreateEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/CreateEntityRecognizerCommand.ts b/clients/client-comprehend/commands/CreateEntityRecognizerCommand.ts index 6dee4a006c9d4..2d1f6eb9eb8b9 100644 --- a/clients/client-comprehend/commands/CreateEntityRecognizerCommand.ts +++ b/clients/client-comprehend/commands/CreateEntityRecognizerCommand.ts @@ -20,6 +20,11 @@ import { export type CreateEntityRecognizerCommandInput = CreateEntityRecognizerRequest; export type CreateEntityRecognizerCommandOutput = CreateEntityRecognizerResponse & __MetadataBearer; +/** + *

Creates an entity recognizer using submitted files. After your + * CreateEntityRecognizer request is submitted, you can check job status using the + * API.

+ */ export class CreateEntityRecognizerCommand extends $Command< CreateEntityRecognizerCommandInput, CreateEntityRecognizerCommandOutput, @@ -34,6 +39,9 @@ export class CreateEntityRecognizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DeleteDocumentClassifierCommand.ts b/clients/client-comprehend/commands/DeleteDocumentClassifierCommand.ts index fbe9eb4a598c7..0910109ed03c5 100644 --- a/clients/client-comprehend/commands/DeleteDocumentClassifierCommand.ts +++ b/clients/client-comprehend/commands/DeleteDocumentClassifierCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteDocumentClassifierCommandInput = DeleteDocumentClassifierRequest; export type DeleteDocumentClassifierCommandOutput = DeleteDocumentClassifierResponse & __MetadataBearer; +/** + *

Deletes a previously created document classifier

+ *

Only those classifiers that are in terminated states (IN_ERROR, TRAINED) will be deleted. + * If an active inference job is using the model, a ResourceInUseException will be + * returned.

+ *

This is an asynchronous action that puts the classifier into a DELETING state, and it is + * then removed by a background job. Once removed, the classifier disappears from your account + * and is no longer available for use.

+ */ export class DeleteDocumentClassifierCommand extends $Command< DeleteDocumentClassifierCommandInput, DeleteDocumentClassifierCommandOutput, @@ -34,6 +43,9 @@ export class DeleteDocumentClassifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DeleteEndpointCommand.ts b/clients/client-comprehend/commands/DeleteEndpointCommand.ts index f2eaae9f63b54..33a2347f2aaa3 100644 --- a/clients/client-comprehend/commands/DeleteEndpointCommand.ts +++ b/clients/client-comprehend/commands/DeleteEndpointCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteEndpointCommandInput = DeleteEndpointRequest; export type DeleteEndpointCommandOutput = DeleteEndpointResponse & __MetadataBearer; +/** + *

Deletes a model-specific endpoint for a previously-trained custom model. All endpoints + * must be deleted in order for the model to be deleted.

+ */ export class DeleteEndpointCommand extends $Command< DeleteEndpointCommandInput, DeleteEndpointCommandOutput, @@ -34,6 +38,9 @@ export class DeleteEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DeleteEntityRecognizerCommand.ts b/clients/client-comprehend/commands/DeleteEntityRecognizerCommand.ts index 7ef8aee4077de..08790cb783551 100644 --- a/clients/client-comprehend/commands/DeleteEntityRecognizerCommand.ts +++ b/clients/client-comprehend/commands/DeleteEntityRecognizerCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteEntityRecognizerCommandInput = DeleteEntityRecognizerRequest; export type DeleteEntityRecognizerCommandOutput = DeleteEntityRecognizerResponse & __MetadataBearer; +/** + *

Deletes an entity recognizer.

+ *

Only those recognizers that are in terminated states (IN_ERROR, TRAINED) will be deleted. + * If an active inference job is using the model, a ResourceInUseException will be + * returned.

+ *

This is an asynchronous action that puts the recognizer into a DELETING state, and it is + * then removed by a background job. Once removed, the recognizer disappears from your account + * and is no longer available for use.

+ */ export class DeleteEntityRecognizerCommand extends $Command< DeleteEntityRecognizerCommandInput, DeleteEntityRecognizerCommandOutput, @@ -34,6 +43,9 @@ export class DeleteEntityRecognizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeDocumentClassificationJobCommand.ts b/clients/client-comprehend/commands/DescribeDocumentClassificationJobCommand.ts index 5e4d0561afa33..78b3c78c067d7 100644 --- a/clients/client-comprehend/commands/DescribeDocumentClassificationJobCommand.ts +++ b/clients/client-comprehend/commands/DescribeDocumentClassificationJobCommand.ts @@ -24,6 +24,10 @@ export type DescribeDocumentClassificationJobCommandInput = DescribeDocumentClas export type DescribeDocumentClassificationJobCommandOutput = DescribeDocumentClassificationJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with a document classification job. Use this operation to + * get the status of a classification job.

+ */ export class DescribeDocumentClassificationJobCommand extends $Command< DescribeDocumentClassificationJobCommandInput, DescribeDocumentClassificationJobCommandOutput, @@ -38,6 +42,9 @@ export class DescribeDocumentClassificationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeDocumentClassifierCommand.ts b/clients/client-comprehend/commands/DescribeDocumentClassifierCommand.ts index c14beb0d48747..c8ac87244aa03 100644 --- a/clients/client-comprehend/commands/DescribeDocumentClassifierCommand.ts +++ b/clients/client-comprehend/commands/DescribeDocumentClassifierCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDocumentClassifierCommandInput = DescribeDocumentClassifierRequest; export type DescribeDocumentClassifierCommandOutput = DescribeDocumentClassifierResponse & __MetadataBearer; +/** + *

Gets the properties associated with a document classifier.

+ */ export class DescribeDocumentClassifierCommand extends $Command< DescribeDocumentClassifierCommandInput, DescribeDocumentClassifierCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDocumentClassifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeDominantLanguageDetectionJobCommand.ts b/clients/client-comprehend/commands/DescribeDominantLanguageDetectionJobCommand.ts index 15f951e1661fb..af5fb4cc6e23d 100644 --- a/clients/client-comprehend/commands/DescribeDominantLanguageDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/DescribeDominantLanguageDetectionJobCommand.ts @@ -24,6 +24,10 @@ export type DescribeDominantLanguageDetectionJobCommandInput = DescribeDominantL export type DescribeDominantLanguageDetectionJobCommandOutput = DescribeDominantLanguageDetectionJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with a dominant language detection job. Use this operation + * to get the status of a detection job.

+ */ export class DescribeDominantLanguageDetectionJobCommand extends $Command< DescribeDominantLanguageDetectionJobCommandInput, DescribeDominantLanguageDetectionJobCommandOutput, @@ -38,6 +42,9 @@ export class DescribeDominantLanguageDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeEndpointCommand.ts b/clients/client-comprehend/commands/DescribeEndpointCommand.ts index 4531095b057f8..82e0f92c36f20 100644 --- a/clients/client-comprehend/commands/DescribeEndpointCommand.ts +++ b/clients/client-comprehend/commands/DescribeEndpointCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEndpointCommandInput = DescribeEndpointRequest; export type DescribeEndpointCommandOutput = DescribeEndpointResponse & __MetadataBearer; +/** + *

Gets the properties associated with a specific endpoint. Use this operation to get the + * status of an endpoint.

+ */ export class DescribeEndpointCommand extends $Command< DescribeEndpointCommandInput, DescribeEndpointCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeEntitiesDetectionJobCommand.ts b/clients/client-comprehend/commands/DescribeEntitiesDetectionJobCommand.ts index 5f2755bbc0af5..43a8a379cf3f7 100644 --- a/clients/client-comprehend/commands/DescribeEntitiesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/DescribeEntitiesDetectionJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEntitiesDetectionJobCommandInput = DescribeEntitiesDetectionJobRequest; export type DescribeEntitiesDetectionJobCommandOutput = DescribeEntitiesDetectionJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with an entities detection job. Use this operation to get + * the status of a detection job.

+ */ export class DescribeEntitiesDetectionJobCommand extends $Command< DescribeEntitiesDetectionJobCommandInput, DescribeEntitiesDetectionJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEntitiesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeEntityRecognizerCommand.ts b/clients/client-comprehend/commands/DescribeEntityRecognizerCommand.ts index 168dce50d9c09..ecbc220b781d4 100644 --- a/clients/client-comprehend/commands/DescribeEntityRecognizerCommand.ts +++ b/clients/client-comprehend/commands/DescribeEntityRecognizerCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEntityRecognizerCommandInput = DescribeEntityRecognizerRequest; export type DescribeEntityRecognizerCommandOutput = DescribeEntityRecognizerResponse & __MetadataBearer; +/** + *

Provides details about an entity recognizer including status, S3 buckets containing + * training data, recognizer metadata, metrics, and so on.

+ */ export class DescribeEntityRecognizerCommand extends $Command< DescribeEntityRecognizerCommandInput, DescribeEntityRecognizerCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEntityRecognizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeKeyPhrasesDetectionJobCommand.ts b/clients/client-comprehend/commands/DescribeKeyPhrasesDetectionJobCommand.ts index 41e0979a07bcb..e1d3f0cdf7313 100644 --- a/clients/client-comprehend/commands/DescribeKeyPhrasesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/DescribeKeyPhrasesDetectionJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeKeyPhrasesDetectionJobCommandInput = DescribeKeyPhrasesDetectionJobRequest; export type DescribeKeyPhrasesDetectionJobCommandOutput = DescribeKeyPhrasesDetectionJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with a key phrases detection job. Use this operation to get + * the status of a detection job.

+ */ export class DescribeKeyPhrasesDetectionJobCommand extends $Command< DescribeKeyPhrasesDetectionJobCommandInput, DescribeKeyPhrasesDetectionJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeKeyPhrasesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribePiiEntitiesDetectionJobCommand.ts b/clients/client-comprehend/commands/DescribePiiEntitiesDetectionJobCommand.ts index 8bf7ec7df96db..abd09d3bfb29e 100644 --- a/clients/client-comprehend/commands/DescribePiiEntitiesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/DescribePiiEntitiesDetectionJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribePiiEntitiesDetectionJobCommandInput = DescribePiiEntitiesDetectionJobRequest; export type DescribePiiEntitiesDetectionJobCommandOutput = DescribePiiEntitiesDetectionJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with a PII entities detection job. For example, you can use + * this operation to get the job status.

+ */ export class DescribePiiEntitiesDetectionJobCommand extends $Command< DescribePiiEntitiesDetectionJobCommandInput, DescribePiiEntitiesDetectionJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribePiiEntitiesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeSentimentDetectionJobCommand.ts b/clients/client-comprehend/commands/DescribeSentimentDetectionJobCommand.ts index dede7d3308c4f..abab0fbeb9527 100644 --- a/clients/client-comprehend/commands/DescribeSentimentDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/DescribeSentimentDetectionJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSentimentDetectionJobCommandInput = DescribeSentimentDetectionJobRequest; export type DescribeSentimentDetectionJobCommandOutput = DescribeSentimentDetectionJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with a sentiment detection job. Use this operation to get + * the status of a detection job.

+ */ export class DescribeSentimentDetectionJobCommand extends $Command< DescribeSentimentDetectionJobCommandInput, DescribeSentimentDetectionJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSentimentDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DescribeTopicsDetectionJobCommand.ts b/clients/client-comprehend/commands/DescribeTopicsDetectionJobCommand.ts index 905dbc06666bd..b2be0b148c3ca 100644 --- a/clients/client-comprehend/commands/DescribeTopicsDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/DescribeTopicsDetectionJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeTopicsDetectionJobCommandInput = DescribeTopicsDetectionJobRequest; export type DescribeTopicsDetectionJobCommandOutput = DescribeTopicsDetectionJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with a topic detection job. Use this operation to get + * the status of a detection job.

+ */ export class DescribeTopicsDetectionJobCommand extends $Command< DescribeTopicsDetectionJobCommandInput, DescribeTopicsDetectionJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeTopicsDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DetectDominantLanguageCommand.ts b/clients/client-comprehend/commands/DetectDominantLanguageCommand.ts index 0a2718011adc9..ea1923d83a18e 100644 --- a/clients/client-comprehend/commands/DetectDominantLanguageCommand.ts +++ b/clients/client-comprehend/commands/DetectDominantLanguageCommand.ts @@ -20,6 +20,10 @@ import { export type DetectDominantLanguageCommandInput = DetectDominantLanguageRequest; export type DetectDominantLanguageCommandOutput = DetectDominantLanguageResponse & __MetadataBearer; +/** + *

Determines the dominant language of the input text. For a list of languages that Amazon + * Comprehend can detect, see Amazon Comprehend Supported Languages.

+ */ export class DetectDominantLanguageCommand extends $Command< DetectDominantLanguageCommandInput, DetectDominantLanguageCommandOutput, @@ -34,6 +38,9 @@ export class DetectDominantLanguageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DetectEntitiesCommand.ts b/clients/client-comprehend/commands/DetectEntitiesCommand.ts index 9e7985d8620d6..ed68ebf8b23f4 100644 --- a/clients/client-comprehend/commands/DetectEntitiesCommand.ts +++ b/clients/client-comprehend/commands/DetectEntitiesCommand.ts @@ -20,6 +20,10 @@ import { export type DetectEntitiesCommandInput = DetectEntitiesRequest; export type DetectEntitiesCommandOutput = DetectEntitiesResponse & __MetadataBearer; +/** + *

Inspects text for named entities, and returns information about them. For more + * information, about named entities, see how-entities.

+ */ export class DetectEntitiesCommand extends $Command< DetectEntitiesCommandInput, DetectEntitiesCommandOutput, @@ -34,6 +38,9 @@ export class DetectEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DetectKeyPhrasesCommand.ts b/clients/client-comprehend/commands/DetectKeyPhrasesCommand.ts index cca5ed679d3ea..39a57af7e8d31 100644 --- a/clients/client-comprehend/commands/DetectKeyPhrasesCommand.ts +++ b/clients/client-comprehend/commands/DetectKeyPhrasesCommand.ts @@ -20,6 +20,9 @@ import { export type DetectKeyPhrasesCommandInput = DetectKeyPhrasesRequest; export type DetectKeyPhrasesCommandOutput = DetectKeyPhrasesResponse & __MetadataBearer; +/** + *

Detects the key noun phrases found in the text.

+ */ export class DetectKeyPhrasesCommand extends $Command< DetectKeyPhrasesCommandInput, DetectKeyPhrasesCommandOutput, @@ -34,6 +37,9 @@ export class DetectKeyPhrasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DetectPiiEntitiesCommand.ts b/clients/client-comprehend/commands/DetectPiiEntitiesCommand.ts index c2f95fc51ed41..8eca1f9cbbed9 100644 --- a/clients/client-comprehend/commands/DetectPiiEntitiesCommand.ts +++ b/clients/client-comprehend/commands/DetectPiiEntitiesCommand.ts @@ -20,6 +20,10 @@ import { export type DetectPiiEntitiesCommandInput = DetectPiiEntitiesRequest; export type DetectPiiEntitiesCommandOutput = DetectPiiEntitiesResponse & __MetadataBearer; +/** + *

Inspects the input text for entities that contain personally identifiable information + * (PII) and returns information about them.

+ */ export class DetectPiiEntitiesCommand extends $Command< DetectPiiEntitiesCommandInput, DetectPiiEntitiesCommandOutput, @@ -34,6 +38,9 @@ export class DetectPiiEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DetectSentimentCommand.ts b/clients/client-comprehend/commands/DetectSentimentCommand.ts index 0de155cba89aa..c9ab77d4e5a5c 100644 --- a/clients/client-comprehend/commands/DetectSentimentCommand.ts +++ b/clients/client-comprehend/commands/DetectSentimentCommand.ts @@ -20,6 +20,10 @@ import { export type DetectSentimentCommandInput = DetectSentimentRequest; export type DetectSentimentCommandOutput = DetectSentimentResponse & __MetadataBearer; +/** + *

Inspects text and returns an inference of the prevailing sentiment + * (POSITIVE, NEUTRAL, MIXED, or NEGATIVE).

+ */ export class DetectSentimentCommand extends $Command< DetectSentimentCommandInput, DetectSentimentCommandOutput, @@ -34,6 +38,9 @@ export class DetectSentimentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/DetectSyntaxCommand.ts b/clients/client-comprehend/commands/DetectSyntaxCommand.ts index 9b51e8a064fec..47163a26bc714 100644 --- a/clients/client-comprehend/commands/DetectSyntaxCommand.ts +++ b/clients/client-comprehend/commands/DetectSyntaxCommand.ts @@ -20,6 +20,10 @@ import { export type DetectSyntaxCommandInput = DetectSyntaxRequest; export type DetectSyntaxCommandOutput = DetectSyntaxResponse & __MetadataBearer; +/** + *

Inspects text for syntax and the part of speech of words in the document. For more + * information, how-syntax.

+ */ export class DetectSyntaxCommand extends $Command< DetectSyntaxCommandInput, DetectSyntaxCommandOutput, @@ -34,6 +38,9 @@ export class DetectSyntaxCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListDocumentClassificationJobsCommand.ts b/clients/client-comprehend/commands/ListDocumentClassificationJobsCommand.ts index 3ac246d66870c..46c96901b9a0d 100644 --- a/clients/client-comprehend/commands/ListDocumentClassificationJobsCommand.ts +++ b/clients/client-comprehend/commands/ListDocumentClassificationJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDocumentClassificationJobsCommandInput = ListDocumentClassificationJobsRequest; export type ListDocumentClassificationJobsCommandOutput = ListDocumentClassificationJobsResponse & __MetadataBearer; +/** + *

Gets a list of the documentation classification jobs that you have submitted.

+ */ export class ListDocumentClassificationJobsCommand extends $Command< ListDocumentClassificationJobsCommandInput, ListDocumentClassificationJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListDocumentClassificationJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListDocumentClassifiersCommand.ts b/clients/client-comprehend/commands/ListDocumentClassifiersCommand.ts index 35766741303f1..1ba224ca83606 100644 --- a/clients/client-comprehend/commands/ListDocumentClassifiersCommand.ts +++ b/clients/client-comprehend/commands/ListDocumentClassifiersCommand.ts @@ -20,6 +20,9 @@ import { export type ListDocumentClassifiersCommandInput = ListDocumentClassifiersRequest; export type ListDocumentClassifiersCommandOutput = ListDocumentClassifiersResponse & __MetadataBearer; +/** + *

Gets a list of the document classifiers that you have created.

+ */ export class ListDocumentClassifiersCommand extends $Command< ListDocumentClassifiersCommandInput, ListDocumentClassifiersCommandOutput, @@ -34,6 +37,9 @@ export class ListDocumentClassifiersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListDominantLanguageDetectionJobsCommand.ts b/clients/client-comprehend/commands/ListDominantLanguageDetectionJobsCommand.ts index 9330d2fc5387e..cc792c6805365 100644 --- a/clients/client-comprehend/commands/ListDominantLanguageDetectionJobsCommand.ts +++ b/clients/client-comprehend/commands/ListDominantLanguageDetectionJobsCommand.ts @@ -24,6 +24,9 @@ export type ListDominantLanguageDetectionJobsCommandInput = ListDominantLanguage export type ListDominantLanguageDetectionJobsCommandOutput = ListDominantLanguageDetectionJobsResponse & __MetadataBearer; +/** + *

Gets a list of the dominant language detection jobs that you have submitted.

+ */ export class ListDominantLanguageDetectionJobsCommand extends $Command< ListDominantLanguageDetectionJobsCommandInput, ListDominantLanguageDetectionJobsCommandOutput, @@ -38,6 +41,9 @@ export class ListDominantLanguageDetectionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListEndpointsCommand.ts b/clients/client-comprehend/commands/ListEndpointsCommand.ts index 55221e65bf931..ecac97e60904f 100644 --- a/clients/client-comprehend/commands/ListEndpointsCommand.ts +++ b/clients/client-comprehend/commands/ListEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type ListEndpointsCommandInput = ListEndpointsRequest; export type ListEndpointsCommandOutput = ListEndpointsResponse & __MetadataBearer; +/** + *

Gets a list of all existing endpoints that you've created.

+ */ export class ListEndpointsCommand extends $Command< ListEndpointsCommandInput, ListEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class ListEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListEntitiesDetectionJobsCommand.ts b/clients/client-comprehend/commands/ListEntitiesDetectionJobsCommand.ts index e0044a57b5591..1eaf3628c6c83 100644 --- a/clients/client-comprehend/commands/ListEntitiesDetectionJobsCommand.ts +++ b/clients/client-comprehend/commands/ListEntitiesDetectionJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListEntitiesDetectionJobsCommandInput = ListEntitiesDetectionJobsRequest; export type ListEntitiesDetectionJobsCommandOutput = ListEntitiesDetectionJobsResponse & __MetadataBearer; +/** + *

Gets a list of the entity detection jobs that you have submitted.

+ */ export class ListEntitiesDetectionJobsCommand extends $Command< ListEntitiesDetectionJobsCommandInput, ListEntitiesDetectionJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListEntitiesDetectionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListEntityRecognizersCommand.ts b/clients/client-comprehend/commands/ListEntityRecognizersCommand.ts index 8d3e2b216c286..f95a1fd37315a 100644 --- a/clients/client-comprehend/commands/ListEntityRecognizersCommand.ts +++ b/clients/client-comprehend/commands/ListEntityRecognizersCommand.ts @@ -20,6 +20,14 @@ import { export type ListEntityRecognizersCommandInput = ListEntityRecognizersRequest; export type ListEntityRecognizersCommandOutput = ListEntityRecognizersResponse & __MetadataBearer; +/** + *

Gets a list of the properties of all entity recognizers that you created, including + * recognizers currently in training. Allows you to filter the list of recognizers based on + * criteria such as status and submission time. This call returns up to 500 entity recognizers in + * the list, with a default number of 100 recognizers in the list.

+ *

The results of this list are not in any particular order. Please get the list and sort + * locally if needed.

+ */ export class ListEntityRecognizersCommand extends $Command< ListEntityRecognizersCommandInput, ListEntityRecognizersCommandOutput, @@ -34,6 +42,9 @@ export class ListEntityRecognizersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListKeyPhrasesDetectionJobsCommand.ts b/clients/client-comprehend/commands/ListKeyPhrasesDetectionJobsCommand.ts index 2ced96595beac..0fe3a128ad544 100644 --- a/clients/client-comprehend/commands/ListKeyPhrasesDetectionJobsCommand.ts +++ b/clients/client-comprehend/commands/ListKeyPhrasesDetectionJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListKeyPhrasesDetectionJobsCommandInput = ListKeyPhrasesDetectionJobsRequest; export type ListKeyPhrasesDetectionJobsCommandOutput = ListKeyPhrasesDetectionJobsResponse & __MetadataBearer; +/** + *

Get a list of key phrase detection jobs that you have submitted.

+ */ export class ListKeyPhrasesDetectionJobsCommand extends $Command< ListKeyPhrasesDetectionJobsCommandInput, ListKeyPhrasesDetectionJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListKeyPhrasesDetectionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListPiiEntitiesDetectionJobsCommand.ts b/clients/client-comprehend/commands/ListPiiEntitiesDetectionJobsCommand.ts index 0c2f7a4470c90..69d46d37f4898 100644 --- a/clients/client-comprehend/commands/ListPiiEntitiesDetectionJobsCommand.ts +++ b/clients/client-comprehend/commands/ListPiiEntitiesDetectionJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPiiEntitiesDetectionJobsCommandInput = ListPiiEntitiesDetectionJobsRequest; export type ListPiiEntitiesDetectionJobsCommandOutput = ListPiiEntitiesDetectionJobsResponse & __MetadataBearer; +/** + *

Gets a list of the PII entity detection jobs that you have submitted.

+ */ export class ListPiiEntitiesDetectionJobsCommand extends $Command< ListPiiEntitiesDetectionJobsCommandInput, ListPiiEntitiesDetectionJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListPiiEntitiesDetectionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListSentimentDetectionJobsCommand.ts b/clients/client-comprehend/commands/ListSentimentDetectionJobsCommand.ts index a9b12da19b09e..67dfeaea14d6d 100644 --- a/clients/client-comprehend/commands/ListSentimentDetectionJobsCommand.ts +++ b/clients/client-comprehend/commands/ListSentimentDetectionJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSentimentDetectionJobsCommandInput = ListSentimentDetectionJobsRequest; export type ListSentimentDetectionJobsCommandOutput = ListSentimentDetectionJobsResponse & __MetadataBearer; +/** + *

Gets a list of sentiment detection jobs that you have submitted.

+ */ export class ListSentimentDetectionJobsCommand extends $Command< ListSentimentDetectionJobsCommandInput, ListSentimentDetectionJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListSentimentDetectionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListTagsForResourceCommand.ts b/clients/client-comprehend/commands/ListTagsForResourceCommand.ts index cbcb81b852eed..c1f680751ed63 100644 --- a/clients/client-comprehend/commands/ListTagsForResourceCommand.ts +++ b/clients/client-comprehend/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists all tags associated with a given Amazon Comprehend resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/ListTopicsDetectionJobsCommand.ts b/clients/client-comprehend/commands/ListTopicsDetectionJobsCommand.ts index 5b8d9e14a8783..b5c5e559770d2 100644 --- a/clients/client-comprehend/commands/ListTopicsDetectionJobsCommand.ts +++ b/clients/client-comprehend/commands/ListTopicsDetectionJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTopicsDetectionJobsCommandInput = ListTopicsDetectionJobsRequest; export type ListTopicsDetectionJobsCommandOutput = ListTopicsDetectionJobsResponse & __MetadataBearer; +/** + *

Gets a list of the topic detection jobs that you have submitted.

+ */ export class ListTopicsDetectionJobsCommand extends $Command< ListTopicsDetectionJobsCommandInput, ListTopicsDetectionJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListTopicsDetectionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StartDocumentClassificationJobCommand.ts b/clients/client-comprehend/commands/StartDocumentClassificationJobCommand.ts index 7711179cf762c..47a78b69eece9 100644 --- a/clients/client-comprehend/commands/StartDocumentClassificationJobCommand.ts +++ b/clients/client-comprehend/commands/StartDocumentClassificationJobCommand.ts @@ -20,6 +20,10 @@ import { export type StartDocumentClassificationJobCommandInput = StartDocumentClassificationJobRequest; export type StartDocumentClassificationJobCommandOutput = StartDocumentClassificationJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous document classification job. Use the operation to track the progress of the + * job.

+ */ export class StartDocumentClassificationJobCommand extends $Command< StartDocumentClassificationJobCommandInput, StartDocumentClassificationJobCommandOutput, @@ -34,6 +38,9 @@ export class StartDocumentClassificationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StartDominantLanguageDetectionJobCommand.ts b/clients/client-comprehend/commands/StartDominantLanguageDetectionJobCommand.ts index a0ecd5b60c446..70c9c6f5ab211 100644 --- a/clients/client-comprehend/commands/StartDominantLanguageDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StartDominantLanguageDetectionJobCommand.ts @@ -24,6 +24,11 @@ export type StartDominantLanguageDetectionJobCommandInput = StartDominantLanguag export type StartDominantLanguageDetectionJobCommandOutput = StartDominantLanguageDetectionJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous dominant language detection job for a collection of documents. Use + * the operation to track the status + * of a job.

+ */ export class StartDominantLanguageDetectionJobCommand extends $Command< StartDominantLanguageDetectionJobCommandInput, StartDominantLanguageDetectionJobCommandOutput, @@ -38,6 +43,9 @@ export class StartDominantLanguageDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StartEntitiesDetectionJobCommand.ts b/clients/client-comprehend/commands/StartEntitiesDetectionJobCommand.ts index aaf14c09400f6..1b8f75cf6420c 100644 --- a/clients/client-comprehend/commands/StartEntitiesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StartEntitiesDetectionJobCommand.ts @@ -20,6 +20,13 @@ import { export type StartEntitiesDetectionJobCommandInput = StartEntitiesDetectionJobRequest; export type StartEntitiesDetectionJobCommandOutput = StartEntitiesDetectionJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous entity detection job for a collection of documents. Use the operation to track the status of a job.

+ *

This API can be used for either standard entity detection or custom entity recognition. In + * order to be used for custom entity recognition, the optional EntityRecognizerArn + * must be used in order to provide access to the recognizer being used to detect the custom + * entity.

+ */ export class StartEntitiesDetectionJobCommand extends $Command< StartEntitiesDetectionJobCommandInput, StartEntitiesDetectionJobCommandOutput, @@ -34,6 +41,9 @@ export class StartEntitiesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StartKeyPhrasesDetectionJobCommand.ts b/clients/client-comprehend/commands/StartKeyPhrasesDetectionJobCommand.ts index 9ba0cfb975d5f..f7717c34c8cd5 100644 --- a/clients/client-comprehend/commands/StartKeyPhrasesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StartKeyPhrasesDetectionJobCommand.ts @@ -20,6 +20,11 @@ import { export type StartKeyPhrasesDetectionJobCommandInput = StartKeyPhrasesDetectionJobRequest; export type StartKeyPhrasesDetectionJobCommandOutput = StartKeyPhrasesDetectionJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous key phrase detection job for a collection of documents. Use the + * operation to track the status of a + * job.

+ */ export class StartKeyPhrasesDetectionJobCommand extends $Command< StartKeyPhrasesDetectionJobCommandInput, StartKeyPhrasesDetectionJobCommandOutput, @@ -34,6 +39,9 @@ export class StartKeyPhrasesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StartPiiEntitiesDetectionJobCommand.ts b/clients/client-comprehend/commands/StartPiiEntitiesDetectionJobCommand.ts index fc8c32f435bd5..b47af5792c682 100644 --- a/clients/client-comprehend/commands/StartPiiEntitiesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StartPiiEntitiesDetectionJobCommand.ts @@ -20,6 +20,9 @@ import { export type StartPiiEntitiesDetectionJobCommandInput = StartPiiEntitiesDetectionJobRequest; export type StartPiiEntitiesDetectionJobCommandOutput = StartPiiEntitiesDetectionJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous PII entity detection job for a collection of documents.

+ */ export class StartPiiEntitiesDetectionJobCommand extends $Command< StartPiiEntitiesDetectionJobCommandInput, StartPiiEntitiesDetectionJobCommandOutput, @@ -34,6 +37,9 @@ export class StartPiiEntitiesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StartSentimentDetectionJobCommand.ts b/clients/client-comprehend/commands/StartSentimentDetectionJobCommand.ts index e92b9360aa6ab..ba9ff4d18f78c 100644 --- a/clients/client-comprehend/commands/StartSentimentDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StartSentimentDetectionJobCommand.ts @@ -20,6 +20,11 @@ import { export type StartSentimentDetectionJobCommandInput = StartSentimentDetectionJobRequest; export type StartSentimentDetectionJobCommandOutput = StartSentimentDetectionJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous sentiment detection job for a collection of documents. use the + * operation to track the status of a + * job.

+ */ export class StartSentimentDetectionJobCommand extends $Command< StartSentimentDetectionJobCommandInput, StartSentimentDetectionJobCommandOutput, @@ -34,6 +39,9 @@ export class StartSentimentDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StartTopicsDetectionJobCommand.ts b/clients/client-comprehend/commands/StartTopicsDetectionJobCommand.ts index da3a4d5ddc42e..33c19ddeb667d 100644 --- a/clients/client-comprehend/commands/StartTopicsDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StartTopicsDetectionJobCommand.ts @@ -20,6 +20,10 @@ import { export type StartTopicsDetectionJobCommandInput = StartTopicsDetectionJobRequest; export type StartTopicsDetectionJobCommandOutput = StartTopicsDetectionJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous topic detection job. Use the + * DescribeTopicDetectionJob operation to track the status of a job.

+ */ export class StartTopicsDetectionJobCommand extends $Command< StartTopicsDetectionJobCommandInput, StartTopicsDetectionJobCommandOutput, @@ -34,6 +38,9 @@ export class StartTopicsDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StopDominantLanguageDetectionJobCommand.ts b/clients/client-comprehend/commands/StopDominantLanguageDetectionJobCommand.ts index 687dcfad67e78..32db77749ba9c 100644 --- a/clients/client-comprehend/commands/StopDominantLanguageDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StopDominantLanguageDetectionJobCommand.ts @@ -20,6 +20,18 @@ import { export type StopDominantLanguageDetectionJobCommandInput = StopDominantLanguageDetectionJobRequest; export type StopDominantLanguageDetectionJobCommandOutput = StopDominantLanguageDetectionJobResponse & __MetadataBearer; +/** + *

Stops a dominant language detection job in progress.

+ *

If the job state is IN_PROGRESS the job is marked for termination and put + * into the STOP_REQUESTED state. If the job completes before it can be stopped, it + * is put into the COMPLETED state; otherwise the job is stopped and put into the + * STOPPED state.

+ *

If the job is in the COMPLETED or FAILED state when you call the + * StopDominantLanguageDetectionJob operation, the operation returns a 400 + * Internal Request Exception.

+ *

When a job is stopped, any documents already processed are written to the output + * location.

+ */ export class StopDominantLanguageDetectionJobCommand extends $Command< StopDominantLanguageDetectionJobCommandInput, StopDominantLanguageDetectionJobCommandOutput, @@ -34,6 +46,9 @@ export class StopDominantLanguageDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StopEntitiesDetectionJobCommand.ts b/clients/client-comprehend/commands/StopEntitiesDetectionJobCommand.ts index 9439c40a0454d..0bb05326e7da2 100644 --- a/clients/client-comprehend/commands/StopEntitiesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StopEntitiesDetectionJobCommand.ts @@ -20,6 +20,18 @@ import { export type StopEntitiesDetectionJobCommandInput = StopEntitiesDetectionJobRequest; export type StopEntitiesDetectionJobCommandOutput = StopEntitiesDetectionJobResponse & __MetadataBearer; +/** + *

Stops an entities detection job in progress.

+ *

If the job state is IN_PROGRESS the job is marked for termination and put + * into the STOP_REQUESTED state. If the job completes before it can be stopped, it + * is put into the COMPLETED state; otherwise the job is stopped and put into the + * STOPPED state.

+ *

If the job is in the COMPLETED or FAILED state when you call the + * StopDominantLanguageDetectionJob operation, the operation returns a 400 + * Internal Request Exception.

+ *

When a job is stopped, any documents already processed are written to the output + * location.

+ */ export class StopEntitiesDetectionJobCommand extends $Command< StopEntitiesDetectionJobCommandInput, StopEntitiesDetectionJobCommandOutput, @@ -34,6 +46,9 @@ export class StopEntitiesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StopKeyPhrasesDetectionJobCommand.ts b/clients/client-comprehend/commands/StopKeyPhrasesDetectionJobCommand.ts index 609313ae3138e..d6ecfc48f90e0 100644 --- a/clients/client-comprehend/commands/StopKeyPhrasesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StopKeyPhrasesDetectionJobCommand.ts @@ -20,6 +20,18 @@ import { export type StopKeyPhrasesDetectionJobCommandInput = StopKeyPhrasesDetectionJobRequest; export type StopKeyPhrasesDetectionJobCommandOutput = StopKeyPhrasesDetectionJobResponse & __MetadataBearer; +/** + *

Stops a key phrases detection job in progress.

+ *

If the job state is IN_PROGRESS the job is marked for termination and put + * into the STOP_REQUESTED state. If the job completes before it can be stopped, it + * is put into the COMPLETED state; otherwise the job is stopped and put into the + * STOPPED state.

+ *

If the job is in the COMPLETED or FAILED state when you call the + * StopDominantLanguageDetectionJob operation, the operation returns a 400 + * Internal Request Exception.

+ *

When a job is stopped, any documents already processed are written to the output + * location.

+ */ export class StopKeyPhrasesDetectionJobCommand extends $Command< StopKeyPhrasesDetectionJobCommandInput, StopKeyPhrasesDetectionJobCommandOutput, @@ -34,6 +46,9 @@ export class StopKeyPhrasesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StopPiiEntitiesDetectionJobCommand.ts b/clients/client-comprehend/commands/StopPiiEntitiesDetectionJobCommand.ts index abd58f97cdb63..669cb63b530ea 100644 --- a/clients/client-comprehend/commands/StopPiiEntitiesDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StopPiiEntitiesDetectionJobCommand.ts @@ -20,6 +20,9 @@ import { export type StopPiiEntitiesDetectionJobCommandInput = StopPiiEntitiesDetectionJobRequest; export type StopPiiEntitiesDetectionJobCommandOutput = StopPiiEntitiesDetectionJobResponse & __MetadataBearer; +/** + *

Stops a PII entities detection job in progress.

+ */ export class StopPiiEntitiesDetectionJobCommand extends $Command< StopPiiEntitiesDetectionJobCommandInput, StopPiiEntitiesDetectionJobCommandOutput, @@ -34,6 +37,9 @@ export class StopPiiEntitiesDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StopSentimentDetectionJobCommand.ts b/clients/client-comprehend/commands/StopSentimentDetectionJobCommand.ts index 1f07c53cc2d1d..b4759beea983d 100644 --- a/clients/client-comprehend/commands/StopSentimentDetectionJobCommand.ts +++ b/clients/client-comprehend/commands/StopSentimentDetectionJobCommand.ts @@ -20,6 +20,18 @@ import { export type StopSentimentDetectionJobCommandInput = StopSentimentDetectionJobRequest; export type StopSentimentDetectionJobCommandOutput = StopSentimentDetectionJobResponse & __MetadataBearer; +/** + *

Stops a sentiment detection job in progress.

+ *

If the job state is IN_PROGRESS the job is marked for termination and put + * into the STOP_REQUESTED state. If the job completes before it can be stopped, it + * is put into the COMPLETED state; otherwise the job is be stopped and put into the + * STOPPED state.

+ *

If the job is in the COMPLETED or FAILED state when you call the + * StopDominantLanguageDetectionJob operation, the operation returns a 400 + * Internal Request Exception.

+ *

When a job is stopped, any documents already processed are written to the output + * location.

+ */ export class StopSentimentDetectionJobCommand extends $Command< StopSentimentDetectionJobCommandInput, StopSentimentDetectionJobCommandOutput, @@ -34,6 +46,9 @@ export class StopSentimentDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StopTrainingDocumentClassifierCommand.ts b/clients/client-comprehend/commands/StopTrainingDocumentClassifierCommand.ts index a497f93068217..29690024d02a1 100644 --- a/clients/client-comprehend/commands/StopTrainingDocumentClassifierCommand.ts +++ b/clients/client-comprehend/commands/StopTrainingDocumentClassifierCommand.ts @@ -20,6 +20,14 @@ import { export type StopTrainingDocumentClassifierCommandInput = StopTrainingDocumentClassifierRequest; export type StopTrainingDocumentClassifierCommandOutput = StopTrainingDocumentClassifierResponse & __MetadataBearer; +/** + *

Stops a document classifier training job while in progress.

+ *

If the training job state is TRAINING, the job is marked for termination and + * put into the STOP_REQUESTED state. If the training job completes before it can be + * stopped, it is put into the TRAINED; otherwise the training job is stopped and + * put into the STOPPED state and the service sends back an HTTP 200 response with + * an empty HTTP body.

+ */ export class StopTrainingDocumentClassifierCommand extends $Command< StopTrainingDocumentClassifierCommandInput, StopTrainingDocumentClassifierCommandOutput, @@ -34,6 +42,9 @@ export class StopTrainingDocumentClassifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/StopTrainingEntityRecognizerCommand.ts b/clients/client-comprehend/commands/StopTrainingEntityRecognizerCommand.ts index f234cbf83da60..dc82802462255 100644 --- a/clients/client-comprehend/commands/StopTrainingEntityRecognizerCommand.ts +++ b/clients/client-comprehend/commands/StopTrainingEntityRecognizerCommand.ts @@ -20,6 +20,14 @@ import { export type StopTrainingEntityRecognizerCommandInput = StopTrainingEntityRecognizerRequest; export type StopTrainingEntityRecognizerCommandOutput = StopTrainingEntityRecognizerResponse & __MetadataBearer; +/** + *

Stops an entity recognizer training job while in progress.

+ *

If the training job state is TRAINING, the job is marked for termination and + * put into the STOP_REQUESTED state. If the training job completes before it can be + * stopped, it is put into the TRAINED; otherwise the training job is stopped and + * putted into the STOPPED state and the service sends back an HTTP 200 response + * with an empty HTTP body.

+ */ export class StopTrainingEntityRecognizerCommand extends $Command< StopTrainingEntityRecognizerCommandInput, StopTrainingEntityRecognizerCommandOutput, @@ -34,6 +42,9 @@ export class StopTrainingEntityRecognizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/TagResourceCommand.ts b/clients/client-comprehend/commands/TagResourceCommand.ts index edc7cf488c848..ac5f80d999ab8 100644 --- a/clients/client-comprehend/commands/TagResourceCommand.ts +++ b/clients/client-comprehend/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Associates a specific tag with an Amazon Comprehend resource. A tag is a key-value pair + * that adds as a metadata to a resource used by Amazon Comprehend. For example, a tag with + * "Sales" as the key might be added to a resource to indicate its use by the sales department. + *

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/UntagResourceCommand.ts b/clients/client-comprehend/commands/UntagResourceCommand.ts index c5fc090650791..5cf7a20aa13c4 100644 --- a/clients/client-comprehend/commands/UntagResourceCommand.ts +++ b/clients/client-comprehend/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a specific tag associated with an Amazon Comprehend resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/commands/UpdateEndpointCommand.ts b/clients/client-comprehend/commands/UpdateEndpointCommand.ts index 2af37bf84547d..304862d68ba75 100644 --- a/clients/client-comprehend/commands/UpdateEndpointCommand.ts +++ b/clients/client-comprehend/commands/UpdateEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEndpointCommandInput = UpdateEndpointRequest; export type UpdateEndpointCommandOutput = UpdateEndpointResponse & __MetadataBearer; +/** + *

Updates information about the specified endpoint.

+ */ export class UpdateEndpointCommand extends $Command< UpdateEndpointCommandInput, UpdateEndpointCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendClientResolvedConfig, diff --git a/clients/client-comprehend/package.json b/clients/client-comprehend/package.json index 158579edc1b02..102270d29d1e7 100644 --- a/clients/client-comprehend/package.json +++ b/clients/client-comprehend/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Comprehend Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-comprehend/pagination/ListDocumentClassificationJobsPaginator.ts b/clients/client-comprehend/pagination/ListDocumentClassificationJobsPaginator.ts index 93a52ee350063..dfd65cc4c779d 100644 --- a/clients/client-comprehend/pagination/ListDocumentClassificationJobsPaginator.ts +++ b/clients/client-comprehend/pagination/ListDocumentClassificationJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { ComprehendPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ComprehendClient, input: ListDocumentClassificationJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDocumentClassificationJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Comprehend, input: ListDocumentClassificationJobsCommandInput, diff --git a/clients/client-comprehend/pagination/ListDocumentClassifiersPaginator.ts b/clients/client-comprehend/pagination/ListDocumentClassifiersPaginator.ts index 5084f99e700b1..99cf2d1513e5b 100644 --- a/clients/client-comprehend/pagination/ListDocumentClassifiersPaginator.ts +++ b/clients/client-comprehend/pagination/ListDocumentClassifiersPaginator.ts @@ -8,6 +8,9 @@ import { import { ComprehendPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ComprehendClient, input: ListDocumentClassifiersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDocumentClassifiersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Comprehend, input: ListDocumentClassifiersCommandInput, diff --git a/clients/client-comprehend/pagination/ListDominantLanguageDetectionJobsPaginator.ts b/clients/client-comprehend/pagination/ListDominantLanguageDetectionJobsPaginator.ts index 35b9a6fa07c35..204472e775430 100644 --- a/clients/client-comprehend/pagination/ListDominantLanguageDetectionJobsPaginator.ts +++ b/clients/client-comprehend/pagination/ListDominantLanguageDetectionJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { ComprehendPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ComprehendClient, input: ListDominantLanguageDetectionJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDominantLanguageDetectionJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Comprehend, input: ListDominantLanguageDetectionJobsCommandInput, diff --git a/clients/client-comprehend/pagination/ListEntitiesDetectionJobsPaginator.ts b/clients/client-comprehend/pagination/ListEntitiesDetectionJobsPaginator.ts index 5e8fd703b347d..800387be3ecd0 100644 --- a/clients/client-comprehend/pagination/ListEntitiesDetectionJobsPaginator.ts +++ b/clients/client-comprehend/pagination/ListEntitiesDetectionJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { ComprehendPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ComprehendClient, input: ListEntitiesDetectionJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEntitiesDetectionJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Comprehend, input: ListEntitiesDetectionJobsCommandInput, diff --git a/clients/client-comprehend/pagination/ListEntityRecognizersPaginator.ts b/clients/client-comprehend/pagination/ListEntityRecognizersPaginator.ts index a189fe0eb209b..8daa77534e7bc 100644 --- a/clients/client-comprehend/pagination/ListEntityRecognizersPaginator.ts +++ b/clients/client-comprehend/pagination/ListEntityRecognizersPaginator.ts @@ -8,6 +8,9 @@ import { import { ComprehendPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ComprehendClient, input: ListEntityRecognizersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEntityRecognizersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Comprehend, input: ListEntityRecognizersCommandInput, diff --git a/clients/client-comprehend/pagination/ListKeyPhrasesDetectionJobsPaginator.ts b/clients/client-comprehend/pagination/ListKeyPhrasesDetectionJobsPaginator.ts index 668d26be55721..598e04bbe77a3 100644 --- a/clients/client-comprehend/pagination/ListKeyPhrasesDetectionJobsPaginator.ts +++ b/clients/client-comprehend/pagination/ListKeyPhrasesDetectionJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { ComprehendPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ComprehendClient, input: ListKeyPhrasesDetectionJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListKeyPhrasesDetectionJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Comprehend, input: ListKeyPhrasesDetectionJobsCommandInput, diff --git a/clients/client-comprehend/pagination/ListSentimentDetectionJobsPaginator.ts b/clients/client-comprehend/pagination/ListSentimentDetectionJobsPaginator.ts index 3c1c6b6c449c1..0b04e8a572788 100644 --- a/clients/client-comprehend/pagination/ListSentimentDetectionJobsPaginator.ts +++ b/clients/client-comprehend/pagination/ListSentimentDetectionJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { ComprehendPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ComprehendClient, input: ListSentimentDetectionJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSentimentDetectionJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Comprehend, input: ListSentimentDetectionJobsCommandInput, diff --git a/clients/client-comprehend/pagination/ListTopicsDetectionJobsPaginator.ts b/clients/client-comprehend/pagination/ListTopicsDetectionJobsPaginator.ts index 83fe69c71d083..b12fa57012516 100644 --- a/clients/client-comprehend/pagination/ListTopicsDetectionJobsPaginator.ts +++ b/clients/client-comprehend/pagination/ListTopicsDetectionJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { ComprehendPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ComprehendClient, input: ListTopicsDetectionJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTopicsDetectionJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Comprehend, input: ListTopicsDetectionJobsCommandInput, diff --git a/clients/client-comprehend/runtimeConfig.browser.ts b/clients/client-comprehend/runtimeConfig.browser.ts index 64ccfe2817d88..9e72ae0f35553 100644 --- a/clients/client-comprehend/runtimeConfig.browser.ts +++ b/clients/client-comprehend/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ComprehendClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-comprehend/runtimeConfig.native.ts b/clients/client-comprehend/runtimeConfig.native.ts index 0014bf1fd13eb..d7dc348aebc58 100644 --- a/clients/client-comprehend/runtimeConfig.native.ts +++ b/clients/client-comprehend/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ComprehendClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-comprehend/runtimeConfig.shared.ts b/clients/client-comprehend/runtimeConfig.shared.ts index 0a4d9804e5bf0..c7eceb49c48fc 100644 --- a/clients/client-comprehend/runtimeConfig.shared.ts +++ b/clients/client-comprehend/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-11-27", disableHostPrefix: false, diff --git a/clients/client-comprehend/runtimeConfig.ts b/clients/client-comprehend/runtimeConfig.ts index b0ee52e4b73a3..919aefc24d03e 100644 --- a/clients/client-comprehend/runtimeConfig.ts +++ b/clients/client-comprehend/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ComprehendClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-comprehend/tsconfig.json b/clients/client-comprehend/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-comprehend/tsconfig.json +++ b/clients/client-comprehend/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-comprehendmedical/commands/DescribeEntitiesDetectionV2JobCommand.ts b/clients/client-comprehendmedical/commands/DescribeEntitiesDetectionV2JobCommand.ts index afe9c4dfb9500..f8b3ede2e6624 100644 --- a/clients/client-comprehendmedical/commands/DescribeEntitiesDetectionV2JobCommand.ts +++ b/clients/client-comprehendmedical/commands/DescribeEntitiesDetectionV2JobCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeEntitiesDetectionV2JobCommandInput = DescribeEntitiesDetectionV2JobRequest; export type DescribeEntitiesDetectionV2JobCommandOutput = DescribeEntitiesDetectionV2JobResponse & __MetadataBearer; +/** + *

Gets the properties associated with a medical entities detection job. Use this operation + * to get the status of a detection job.

+ */ export class DescribeEntitiesDetectionV2JobCommand extends $Command< DescribeEntitiesDetectionV2JobCommandInput, DescribeEntitiesDetectionV2JobCommandOutput, @@ -38,6 +42,9 @@ export class DescribeEntitiesDetectionV2JobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/DescribeICD10CMInferenceJobCommand.ts b/clients/client-comprehendmedical/commands/DescribeICD10CMInferenceJobCommand.ts index 760fb91c2d1d4..7df5f37c0aaf4 100644 --- a/clients/client-comprehendmedical/commands/DescribeICD10CMInferenceJobCommand.ts +++ b/clients/client-comprehendmedical/commands/DescribeICD10CMInferenceJobCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeICD10CMInferenceJobCommandInput = DescribeICD10CMInferenceJobRequest; export type DescribeICD10CMInferenceJobCommandOutput = DescribeICD10CMInferenceJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with an InferICD10CM job. + * Use this operation to get the status of an inference job.

+ */ export class DescribeICD10CMInferenceJobCommand extends $Command< DescribeICD10CMInferenceJobCommandInput, DescribeICD10CMInferenceJobCommandOutput, @@ -38,6 +42,9 @@ export class DescribeICD10CMInferenceJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/DescribePHIDetectionJobCommand.ts b/clients/client-comprehendmedical/commands/DescribePHIDetectionJobCommand.ts index 1659d2b1b3ace..f12e8345b8e3f 100644 --- a/clients/client-comprehendmedical/commands/DescribePHIDetectionJobCommand.ts +++ b/clients/client-comprehendmedical/commands/DescribePHIDetectionJobCommand.ts @@ -24,6 +24,10 @@ import { export type DescribePHIDetectionJobCommandInput = DescribePHIDetectionJobRequest; export type DescribePHIDetectionJobCommandOutput = DescribePHIDetectionJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with a protected health information (PHI) detection job. + * Use this operation to get the status of a detection job.

+ */ export class DescribePHIDetectionJobCommand extends $Command< DescribePHIDetectionJobCommandInput, DescribePHIDetectionJobCommandOutput, @@ -38,6 +42,9 @@ export class DescribePHIDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/DescribeRxNormInferenceJobCommand.ts b/clients/client-comprehendmedical/commands/DescribeRxNormInferenceJobCommand.ts index 8f68048c35cf0..d4951bf5e01de 100644 --- a/clients/client-comprehendmedical/commands/DescribeRxNormInferenceJobCommand.ts +++ b/clients/client-comprehendmedical/commands/DescribeRxNormInferenceJobCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeRxNormInferenceJobCommandInput = DescribeRxNormInferenceJobRequest; export type DescribeRxNormInferenceJobCommandOutput = DescribeRxNormInferenceJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with an InferRxNorm job. + * Use this operation to get the status of an inference job.

+ */ export class DescribeRxNormInferenceJobCommand extends $Command< DescribeRxNormInferenceJobCommandInput, DescribeRxNormInferenceJobCommandOutput, @@ -38,6 +42,9 @@ export class DescribeRxNormInferenceJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/DetectEntitiesCommand.ts b/clients/client-comprehendmedical/commands/DetectEntitiesCommand.ts index 85e3e63b2fe1f..1ae957c434e84 100644 --- a/clients/client-comprehendmedical/commands/DetectEntitiesCommand.ts +++ b/clients/client-comprehendmedical/commands/DetectEntitiesCommand.ts @@ -24,6 +24,12 @@ import { export type DetectEntitiesCommandInput = DetectEntitiesRequest; export type DetectEntitiesCommandOutput = DetectEntitiesResponse & __MetadataBearer; +/** + *

The DetectEntities operation is deprecated. You should use the DetectEntitiesV2 operation instead.

+ *

Inspects the clinical text for a variety of medical entities and returns specific + * information about them such as entity category, location, and confidence score on that + * information .

+ */ export class DetectEntitiesCommand extends $Command< DetectEntitiesCommandInput, DetectEntitiesCommandOutput, @@ -38,6 +44,9 @@ export class DetectEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/DetectEntitiesV2Command.ts b/clients/client-comprehendmedical/commands/DetectEntitiesV2Command.ts index e241ca85d7acc..913a321c2f02d 100644 --- a/clients/client-comprehendmedical/commands/DetectEntitiesV2Command.ts +++ b/clients/client-comprehendmedical/commands/DetectEntitiesV2Command.ts @@ -24,6 +24,18 @@ import { export type DetectEntitiesV2CommandInput = DetectEntitiesV2Request; export type DetectEntitiesV2CommandOutput = DetectEntitiesV2Response & __MetadataBearer; +/** + *

Inspects the clinical text for a variety of medical entities and returns specific + * information about them such as entity category, location, and confidence score on that + * information. Amazon Comprehend Medical only detects medical entities in English language + * texts.

+ *

The DetectEntitiesV2 operation replaces the DetectEntities + * operation. This new action uses a different model for determining the entities in your medical + * text and changes the way that some entities are returned in the output. You should use the + * DetectEntitiesV2 operation in all new applications.

+ *

The DetectEntitiesV2 operation returns the Acuity and + * Direction entities as attributes instead of types.

+ */ export class DetectEntitiesV2Command extends $Command< DetectEntitiesV2CommandInput, DetectEntitiesV2CommandOutput, @@ -38,6 +50,9 @@ export class DetectEntitiesV2Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/DetectPHICommand.ts b/clients/client-comprehendmedical/commands/DetectPHICommand.ts index cce56365fe43d..85bc1ae05d402 100644 --- a/clients/client-comprehendmedical/commands/DetectPHICommand.ts +++ b/clients/client-comprehendmedical/commands/DetectPHICommand.ts @@ -21,6 +21,11 @@ import { export type DetectPHICommandInput = DetectPHIRequest; export type DetectPHICommandOutput = DetectPHIResponse & __MetadataBearer; +/** + *

Inspects the clinical text for protected health information (PHI) entities and returns + * the entity category, location, and confidence score for each entity. Amazon Comprehend Medical + * only detects entities in English language texts.

+ */ export class DetectPHICommand extends $Command< DetectPHICommandInput, DetectPHICommandOutput, @@ -35,6 +40,9 @@ export class DetectPHICommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/InferICD10CMCommand.ts b/clients/client-comprehendmedical/commands/InferICD10CMCommand.ts index 448b7435689dd..61ee9f1686e56 100644 --- a/clients/client-comprehendmedical/commands/InferICD10CMCommand.ts +++ b/clients/client-comprehendmedical/commands/InferICD10CMCommand.ts @@ -24,6 +24,12 @@ import { export type InferICD10CMCommandInput = InferICD10CMRequest; export type InferICD10CMCommandOutput = InferICD10CMResponse & __MetadataBearer; +/** + *

InferICD10CM detects medical conditions as entities listed in a patient record and links + * those entities to normalized concept identifiers in the ICD-10-CM knowledge base from the + * Centers for Disease Control. Amazon Comprehend Medical only detects medical entities in + * English language texts.

+ */ export class InferICD10CMCommand extends $Command< InferICD10CMCommandInput, InferICD10CMCommandOutput, @@ -38,6 +44,9 @@ export class InferICD10CMCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/InferRxNormCommand.ts b/clients/client-comprehendmedical/commands/InferRxNormCommand.ts index 00c630cf9adf2..996dcebe9c2e3 100644 --- a/clients/client-comprehendmedical/commands/InferRxNormCommand.ts +++ b/clients/client-comprehendmedical/commands/InferRxNormCommand.ts @@ -24,6 +24,11 @@ import { export type InferRxNormCommandInput = InferRxNormRequest; export type InferRxNormCommandOutput = InferRxNormResponse & __MetadataBearer; +/** + *

InferRxNorm detects medications as entities listed in a patient record and links to the + * normalized concept identifiers in the RxNorm database from the National Library of Medicine. + * Amazon Comprehend Medical only detects medical entities in English language texts.

+ */ export class InferRxNormCommand extends $Command< InferRxNormCommandInput, InferRxNormCommandOutput, @@ -38,6 +43,9 @@ export class InferRxNormCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/ListEntitiesDetectionV2JobsCommand.ts b/clients/client-comprehendmedical/commands/ListEntitiesDetectionV2JobsCommand.ts index b83d6d7b8e187..84de8ef9e6534 100644 --- a/clients/client-comprehendmedical/commands/ListEntitiesDetectionV2JobsCommand.ts +++ b/clients/client-comprehendmedical/commands/ListEntitiesDetectionV2JobsCommand.ts @@ -24,6 +24,9 @@ import { export type ListEntitiesDetectionV2JobsCommandInput = ListEntitiesDetectionV2JobsRequest; export type ListEntitiesDetectionV2JobsCommandOutput = ListEntitiesDetectionV2JobsResponse & __MetadataBearer; +/** + *

Gets a list of medical entity detection jobs that you have submitted.

+ */ export class ListEntitiesDetectionV2JobsCommand extends $Command< ListEntitiesDetectionV2JobsCommandInput, ListEntitiesDetectionV2JobsCommandOutput, @@ -38,6 +41,9 @@ export class ListEntitiesDetectionV2JobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/ListICD10CMInferenceJobsCommand.ts b/clients/client-comprehendmedical/commands/ListICD10CMInferenceJobsCommand.ts index 40d8ff97fed21..e2a9bde002ac7 100644 --- a/clients/client-comprehendmedical/commands/ListICD10CMInferenceJobsCommand.ts +++ b/clients/client-comprehendmedical/commands/ListICD10CMInferenceJobsCommand.ts @@ -24,6 +24,10 @@ import { export type ListICD10CMInferenceJobsCommandInput = ListICD10CMInferenceJobsRequest; export type ListICD10CMInferenceJobsCommandOutput = ListICD10CMInferenceJobsResponse & __MetadataBearer; +/** + *

Gets a list of InferICD10CM jobs that you have + * submitted.

+ */ export class ListICD10CMInferenceJobsCommand extends $Command< ListICD10CMInferenceJobsCommandInput, ListICD10CMInferenceJobsCommandOutput, @@ -38,6 +42,9 @@ export class ListICD10CMInferenceJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/ListPHIDetectionJobsCommand.ts b/clients/client-comprehendmedical/commands/ListPHIDetectionJobsCommand.ts index 2fb2fd955fc8c..2791198042c69 100644 --- a/clients/client-comprehendmedical/commands/ListPHIDetectionJobsCommand.ts +++ b/clients/client-comprehendmedical/commands/ListPHIDetectionJobsCommand.ts @@ -24,6 +24,10 @@ import { export type ListPHIDetectionJobsCommandInput = ListPHIDetectionJobsRequest; export type ListPHIDetectionJobsCommandOutput = ListPHIDetectionJobsResponse & __MetadataBearer; +/** + *

Gets a list of protected health information (PHI) detection jobs that you have + * submitted.

+ */ export class ListPHIDetectionJobsCommand extends $Command< ListPHIDetectionJobsCommandInput, ListPHIDetectionJobsCommandOutput, @@ -38,6 +42,9 @@ export class ListPHIDetectionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/ListRxNormInferenceJobsCommand.ts b/clients/client-comprehendmedical/commands/ListRxNormInferenceJobsCommand.ts index cc0a8103881e8..5dc865526c18e 100644 --- a/clients/client-comprehendmedical/commands/ListRxNormInferenceJobsCommand.ts +++ b/clients/client-comprehendmedical/commands/ListRxNormInferenceJobsCommand.ts @@ -24,6 +24,10 @@ import { export type ListRxNormInferenceJobsCommandInput = ListRxNormInferenceJobsRequest; export type ListRxNormInferenceJobsCommandOutput = ListRxNormInferenceJobsResponse & __MetadataBearer; +/** + *

Gets a list of InferRxNorm jobs that you have + * submitted.

+ */ export class ListRxNormInferenceJobsCommand extends $Command< ListRxNormInferenceJobsCommandInput, ListRxNormInferenceJobsCommandOutput, @@ -38,6 +42,9 @@ export class ListRxNormInferenceJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/StartEntitiesDetectionV2JobCommand.ts b/clients/client-comprehendmedical/commands/StartEntitiesDetectionV2JobCommand.ts index 4c0b0240a99b5..9f2c3055e4dfd 100644 --- a/clients/client-comprehendmedical/commands/StartEntitiesDetectionV2JobCommand.ts +++ b/clients/client-comprehendmedical/commands/StartEntitiesDetectionV2JobCommand.ts @@ -24,6 +24,10 @@ import { export type StartEntitiesDetectionV2JobCommandInput = StartEntitiesDetectionV2JobRequest; export type StartEntitiesDetectionV2JobCommandOutput = StartEntitiesDetectionV2JobResponse & __MetadataBearer; +/** + *

Starts an asynchronous medical entity detection job for a collection of documents. Use the + * DescribeEntitiesDetectionV2Job operation to track the status of a job.

+ */ export class StartEntitiesDetectionV2JobCommand extends $Command< StartEntitiesDetectionV2JobCommandInput, StartEntitiesDetectionV2JobCommandOutput, @@ -38,6 +42,9 @@ export class StartEntitiesDetectionV2JobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/StartICD10CMInferenceJobCommand.ts b/clients/client-comprehendmedical/commands/StartICD10CMInferenceJobCommand.ts index b219edc10dd8f..db4d3ebeead04 100644 --- a/clients/client-comprehendmedical/commands/StartICD10CMInferenceJobCommand.ts +++ b/clients/client-comprehendmedical/commands/StartICD10CMInferenceJobCommand.ts @@ -24,6 +24,10 @@ import { export type StartICD10CMInferenceJobCommandInput = StartICD10CMInferenceJobRequest; export type StartICD10CMInferenceJobCommandOutput = StartICD10CMInferenceJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous job to detect medical conditions and link them to the ICD-10-CM ontology. Use the + * DescribeICD10CMInferenceJob operation to track the status of a job.

+ */ export class StartICD10CMInferenceJobCommand extends $Command< StartICD10CMInferenceJobCommandInput, StartICD10CMInferenceJobCommandOutput, @@ -38,6 +42,9 @@ export class StartICD10CMInferenceJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/StartPHIDetectionJobCommand.ts b/clients/client-comprehendmedical/commands/StartPHIDetectionJobCommand.ts index f4233955ec4d5..049c972035313 100644 --- a/clients/client-comprehendmedical/commands/StartPHIDetectionJobCommand.ts +++ b/clients/client-comprehendmedical/commands/StartPHIDetectionJobCommand.ts @@ -24,6 +24,10 @@ import { export type StartPHIDetectionJobCommandInput = StartPHIDetectionJobRequest; export type StartPHIDetectionJobCommandOutput = StartPHIDetectionJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous job to detect protected health information (PHI). Use the + * DescribePHIDetectionJob operation to track the status of a job.

+ */ export class StartPHIDetectionJobCommand extends $Command< StartPHIDetectionJobCommandInput, StartPHIDetectionJobCommandOutput, @@ -38,6 +42,9 @@ export class StartPHIDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/StartRxNormInferenceJobCommand.ts b/clients/client-comprehendmedical/commands/StartRxNormInferenceJobCommand.ts index 30717d18bde30..7b8e42ed8845a 100644 --- a/clients/client-comprehendmedical/commands/StartRxNormInferenceJobCommand.ts +++ b/clients/client-comprehendmedical/commands/StartRxNormInferenceJobCommand.ts @@ -24,6 +24,10 @@ import { export type StartRxNormInferenceJobCommandInput = StartRxNormInferenceJobRequest; export type StartRxNormInferenceJobCommandOutput = StartRxNormInferenceJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous job to detect medication entities and link them to the RxNorm ontology. Use the + * DescribeRxNormInferenceJob operation to track the status of a job.

+ */ export class StartRxNormInferenceJobCommand extends $Command< StartRxNormInferenceJobCommandInput, StartRxNormInferenceJobCommandOutput, @@ -38,6 +42,9 @@ export class StartRxNormInferenceJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/StopEntitiesDetectionV2JobCommand.ts b/clients/client-comprehendmedical/commands/StopEntitiesDetectionV2JobCommand.ts index 8f9e882dd06f6..b901b81f591f7 100644 --- a/clients/client-comprehendmedical/commands/StopEntitiesDetectionV2JobCommand.ts +++ b/clients/client-comprehendmedical/commands/StopEntitiesDetectionV2JobCommand.ts @@ -24,6 +24,9 @@ import { export type StopEntitiesDetectionV2JobCommandInput = StopEntitiesDetectionV2JobRequest; export type StopEntitiesDetectionV2JobCommandOutput = StopEntitiesDetectionV2JobResponse & __MetadataBearer; +/** + *

Stops a medical entities detection job in progress.

+ */ export class StopEntitiesDetectionV2JobCommand extends $Command< StopEntitiesDetectionV2JobCommandInput, StopEntitiesDetectionV2JobCommandOutput, @@ -38,6 +41,9 @@ export class StopEntitiesDetectionV2JobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/StopICD10CMInferenceJobCommand.ts b/clients/client-comprehendmedical/commands/StopICD10CMInferenceJobCommand.ts index 65eb7b120065b..800d74badc564 100644 --- a/clients/client-comprehendmedical/commands/StopICD10CMInferenceJobCommand.ts +++ b/clients/client-comprehendmedical/commands/StopICD10CMInferenceJobCommand.ts @@ -24,6 +24,9 @@ import { export type StopICD10CMInferenceJobCommandInput = StopICD10CMInferenceJobRequest; export type StopICD10CMInferenceJobCommandOutput = StopICD10CMInferenceJobResponse & __MetadataBearer; +/** + *

Stops an InferICD10CM inference job in progress.

+ */ export class StopICD10CMInferenceJobCommand extends $Command< StopICD10CMInferenceJobCommandInput, StopICD10CMInferenceJobCommandOutput, @@ -38,6 +41,9 @@ export class StopICD10CMInferenceJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/StopPHIDetectionJobCommand.ts b/clients/client-comprehendmedical/commands/StopPHIDetectionJobCommand.ts index 11f9610074e9c..474f2b8a72a35 100644 --- a/clients/client-comprehendmedical/commands/StopPHIDetectionJobCommand.ts +++ b/clients/client-comprehendmedical/commands/StopPHIDetectionJobCommand.ts @@ -24,6 +24,9 @@ import { export type StopPHIDetectionJobCommandInput = StopPHIDetectionJobRequest; export type StopPHIDetectionJobCommandOutput = StopPHIDetectionJobResponse & __MetadataBearer; +/** + *

Stops a protected health information (PHI) detection job in progress.

+ */ export class StopPHIDetectionJobCommand extends $Command< StopPHIDetectionJobCommandInput, StopPHIDetectionJobCommandOutput, @@ -38,6 +41,9 @@ export class StopPHIDetectionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/commands/StopRxNormInferenceJobCommand.ts b/clients/client-comprehendmedical/commands/StopRxNormInferenceJobCommand.ts index eddb8ca03d154..0e5462b8dccc5 100644 --- a/clients/client-comprehendmedical/commands/StopRxNormInferenceJobCommand.ts +++ b/clients/client-comprehendmedical/commands/StopRxNormInferenceJobCommand.ts @@ -24,6 +24,9 @@ import { export type StopRxNormInferenceJobCommandInput = StopRxNormInferenceJobRequest; export type StopRxNormInferenceJobCommandOutput = StopRxNormInferenceJobResponse & __MetadataBearer; +/** + *

Stops an InferRxNorm inference job in progress.

+ */ export class StopRxNormInferenceJobCommand extends $Command< StopRxNormInferenceJobCommandInput, StopRxNormInferenceJobCommandOutput, @@ -38,6 +41,9 @@ export class StopRxNormInferenceJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComprehendMedicalClientResolvedConfig, diff --git a/clients/client-comprehendmedical/package.json b/clients/client-comprehendmedical/package.json index 4ad4d77bf738b..c20ea0012f4a1 100644 --- a/clients/client-comprehendmedical/package.json +++ b/clients/client-comprehendmedical/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Comprehendmedical Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-comprehendmedical/runtimeConfig.browser.ts b/clients/client-comprehendmedical/runtimeConfig.browser.ts index f3c22e7f195c1..ede3e7bdd6f19 100644 --- a/clients/client-comprehendmedical/runtimeConfig.browser.ts +++ b/clients/client-comprehendmedical/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ComprehendMedicalClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-comprehendmedical/runtimeConfig.native.ts b/clients/client-comprehendmedical/runtimeConfig.native.ts index c4aa3c404daa9..c2386c7cccdf0 100644 --- a/clients/client-comprehendmedical/runtimeConfig.native.ts +++ b/clients/client-comprehendmedical/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ComprehendMedicalClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-comprehendmedical/runtimeConfig.shared.ts b/clients/client-comprehendmedical/runtimeConfig.shared.ts index 00fb01cca728f..0e019fff83d0d 100644 --- a/clients/client-comprehendmedical/runtimeConfig.shared.ts +++ b/clients/client-comprehendmedical/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-10-30", disableHostPrefix: false, diff --git a/clients/client-comprehendmedical/runtimeConfig.ts b/clients/client-comprehendmedical/runtimeConfig.ts index 8cecac732a17c..1437a913e54ac 100644 --- a/clients/client-comprehendmedical/runtimeConfig.ts +++ b/clients/client-comprehendmedical/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ComprehendMedicalClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-comprehendmedical/tsconfig.json b/clients/client-comprehendmedical/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-comprehendmedical/tsconfig.json +++ b/clients/client-comprehendmedical/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-compute-optimizer/commands/DescribeRecommendationExportJobsCommand.ts b/clients/client-compute-optimizer/commands/DescribeRecommendationExportJobsCommand.ts index fe3abeb4347af..e0066ad9c725d 100644 --- a/clients/client-compute-optimizer/commands/DescribeRecommendationExportJobsCommand.ts +++ b/clients/client-compute-optimizer/commands/DescribeRecommendationExportJobsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeRecommendationExportJobsCommandInput = DescribeRecommendationExportJobsRequest; export type DescribeRecommendationExportJobsCommandOutput = DescribeRecommendationExportJobsResponse & __MetadataBearer; +/** + *

Describes recommendation export jobs created in the last seven days.

+ * + *

Use the ExportAutoScalingGroupRecommendations or + * ExportEC2InstanceRecommendations actions to request an export of your + * recommendations. Then use the DescribeRecommendationExportJobs action to + * view your export jobs.

+ */ export class DescribeRecommendationExportJobsCommand extends $Command< DescribeRecommendationExportJobsCommandInput, DescribeRecommendationExportJobsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeRecommendationExportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/commands/ExportAutoScalingGroupRecommendationsCommand.ts b/clients/client-compute-optimizer/commands/ExportAutoScalingGroupRecommendationsCommand.ts index 030f64a3d0ab6..93769e4debbac 100644 --- a/clients/client-compute-optimizer/commands/ExportAutoScalingGroupRecommendationsCommand.ts +++ b/clients/client-compute-optimizer/commands/ExportAutoScalingGroupRecommendationsCommand.ts @@ -24,6 +24,16 @@ export type ExportAutoScalingGroupRecommendationsCommandInput = ExportAutoScalin export type ExportAutoScalingGroupRecommendationsCommandOutput = ExportAutoScalingGroupRecommendationsResponse & __MetadataBearer; +/** + *

Exports optimization recommendations for Auto Scaling groups.

+ * + *

Recommendations are exported in a comma-separated values (.csv) file, and its metadata + * in a JavaScript Object Notation (.json) file, to an existing Amazon Simple Storage Service (Amazon S3) bucket that + * you specify. For more information, see Exporting + * Recommendations in the Compute Optimizer User Guide.

+ * + *

You can have only one Auto Scaling group export job in progress per AWS Region.

+ */ export class ExportAutoScalingGroupRecommendationsCommand extends $Command< ExportAutoScalingGroupRecommendationsCommandInput, ExportAutoScalingGroupRecommendationsCommandOutput, @@ -38,6 +48,9 @@ export class ExportAutoScalingGroupRecommendationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/commands/ExportEC2InstanceRecommendationsCommand.ts b/clients/client-compute-optimizer/commands/ExportEC2InstanceRecommendationsCommand.ts index 1092469f01a41..3d8e5deee6317 100644 --- a/clients/client-compute-optimizer/commands/ExportEC2InstanceRecommendationsCommand.ts +++ b/clients/client-compute-optimizer/commands/ExportEC2InstanceRecommendationsCommand.ts @@ -20,6 +20,16 @@ import { export type ExportEC2InstanceRecommendationsCommandInput = ExportEC2InstanceRecommendationsRequest; export type ExportEC2InstanceRecommendationsCommandOutput = ExportEC2InstanceRecommendationsResponse & __MetadataBearer; +/** + *

Exports optimization recommendations for Amazon EC2 instances.

+ * + *

Recommendations are exported in a comma-separated values (.csv) file, and its metadata + * in a JavaScript Object Notation (.json) file, to an existing Amazon Simple Storage Service (Amazon S3) bucket that + * you specify. For more information, see Exporting + * Recommendations in the Compute Optimizer User Guide.

+ * + *

You can have only one Amazon EC2 instance export job in progress per AWS Region.

+ */ export class ExportEC2InstanceRecommendationsCommand extends $Command< ExportEC2InstanceRecommendationsCommandInput, ExportEC2InstanceRecommendationsCommandOutput, @@ -34,6 +44,9 @@ export class ExportEC2InstanceRecommendationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/commands/GetAutoScalingGroupRecommendationsCommand.ts b/clients/client-compute-optimizer/commands/GetAutoScalingGroupRecommendationsCommand.ts index 9e541f1d33a94..77490797b38c6 100644 --- a/clients/client-compute-optimizer/commands/GetAutoScalingGroupRecommendationsCommand.ts +++ b/clients/client-compute-optimizer/commands/GetAutoScalingGroupRecommendationsCommand.ts @@ -24,6 +24,13 @@ export type GetAutoScalingGroupRecommendationsCommandInput = GetAutoScalingGroup export type GetAutoScalingGroupRecommendationsCommandOutput = GetAutoScalingGroupRecommendationsResponse & __MetadataBearer; +/** + *

Returns Auto Scaling group recommendations.

+ * + *

AWS Compute Optimizer generates recommendations for Amazon EC2 Auto Scaling groups that meet a specific set of + * requirements. For more information, see the Supported resources and + * requirements in the AWS Compute Optimizer User Guide.

+ */ export class GetAutoScalingGroupRecommendationsCommand extends $Command< GetAutoScalingGroupRecommendationsCommandInput, GetAutoScalingGroupRecommendationsCommandOutput, @@ -38,6 +45,9 @@ export class GetAutoScalingGroupRecommendationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/commands/GetEC2InstanceRecommendationsCommand.ts b/clients/client-compute-optimizer/commands/GetEC2InstanceRecommendationsCommand.ts index 992aeafcb585b..8a28ec055bdcc 100644 --- a/clients/client-compute-optimizer/commands/GetEC2InstanceRecommendationsCommand.ts +++ b/clients/client-compute-optimizer/commands/GetEC2InstanceRecommendationsCommand.ts @@ -20,6 +20,13 @@ import { export type GetEC2InstanceRecommendationsCommandInput = GetEC2InstanceRecommendationsRequest; export type GetEC2InstanceRecommendationsCommandOutput = GetEC2InstanceRecommendationsResponse & __MetadataBearer; +/** + *

Returns Amazon EC2 instance recommendations.

+ * + *

AWS Compute Optimizer generates recommendations for Amazon Elastic Compute Cloud (Amazon EC2) instances that meet a + * specific set of requirements. For more information, see the Supported resources and + * requirements in the AWS Compute Optimizer User Guide.

+ */ export class GetEC2InstanceRecommendationsCommand extends $Command< GetEC2InstanceRecommendationsCommandInput, GetEC2InstanceRecommendationsCommandOutput, @@ -34,6 +41,9 @@ export class GetEC2InstanceRecommendationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/commands/GetEC2RecommendationProjectedMetricsCommand.ts b/clients/client-compute-optimizer/commands/GetEC2RecommendationProjectedMetricsCommand.ts index d53259363161f..283f50d5851dd 100644 --- a/clients/client-compute-optimizer/commands/GetEC2RecommendationProjectedMetricsCommand.ts +++ b/clients/client-compute-optimizer/commands/GetEC2RecommendationProjectedMetricsCommand.ts @@ -24,6 +24,17 @@ export type GetEC2RecommendationProjectedMetricsCommandInput = GetEC2Recommendat export type GetEC2RecommendationProjectedMetricsCommandOutput = GetEC2RecommendationProjectedMetricsResponse & __MetadataBearer; +/** + *

Returns the projected utilization metrics of Amazon EC2 instance recommendations.

+ * + * + *

The Cpu and Memory metrics are the only projected + * utilization metrics returned when you run this action. Additionally, the + * Memory metric is returned only for resources that have the unified + * CloudWatch agent installed on them. For more information, see Enabling Memory + * Utilization with the CloudWatch Agent.

+ *
+ */ export class GetEC2RecommendationProjectedMetricsCommand extends $Command< GetEC2RecommendationProjectedMetricsCommandInput, GetEC2RecommendationProjectedMetricsCommandOutput, @@ -38,6 +49,9 @@ export class GetEC2RecommendationProjectedMetricsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/commands/GetEnrollmentStatusCommand.ts b/clients/client-compute-optimizer/commands/GetEnrollmentStatusCommand.ts index a86aa206f6ebf..e7795a2f36a70 100644 --- a/clients/client-compute-optimizer/commands/GetEnrollmentStatusCommand.ts +++ b/clients/client-compute-optimizer/commands/GetEnrollmentStatusCommand.ts @@ -20,6 +20,11 @@ import { export type GetEnrollmentStatusCommandInput = GetEnrollmentStatusRequest; export type GetEnrollmentStatusCommandOutput = GetEnrollmentStatusResponse & __MetadataBearer; +/** + *

Returns the enrollment (opt in) status of an account to the AWS Compute Optimizer service.

+ *

If the account is the master account of an organization, this action also confirms the + * enrollment status of member accounts within the organization.

+ */ export class GetEnrollmentStatusCommand extends $Command< GetEnrollmentStatusCommandInput, GetEnrollmentStatusCommandOutput, @@ -34,6 +39,9 @@ export class GetEnrollmentStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/commands/GetRecommendationSummariesCommand.ts b/clients/client-compute-optimizer/commands/GetRecommendationSummariesCommand.ts index a7524de5c555b..15523f470c31c 100644 --- a/clients/client-compute-optimizer/commands/GetRecommendationSummariesCommand.ts +++ b/clients/client-compute-optimizer/commands/GetRecommendationSummariesCommand.ts @@ -20,6 +20,12 @@ import { export type GetRecommendationSummariesCommandInput = GetRecommendationSummariesRequest; export type GetRecommendationSummariesCommandOutput = GetRecommendationSummariesResponse & __MetadataBearer; +/** + *

Returns the optimization findings for an account.

+ *

For example, it returns the number of Amazon EC2 instances in an account that are + * under-provisioned, over-provisioned, or optimized. It also returns the number of Auto Scaling + * groups in an account that are not optimized, or optimized.

+ */ export class GetRecommendationSummariesCommand extends $Command< GetRecommendationSummariesCommandInput, GetRecommendationSummariesCommandOutput, @@ -34,6 +40,9 @@ export class GetRecommendationSummariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/commands/UpdateEnrollmentStatusCommand.ts b/clients/client-compute-optimizer/commands/UpdateEnrollmentStatusCommand.ts index 3cee69312265c..232493337e0b8 100644 --- a/clients/client-compute-optimizer/commands/UpdateEnrollmentStatusCommand.ts +++ b/clients/client-compute-optimizer/commands/UpdateEnrollmentStatusCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateEnrollmentStatusCommandInput = UpdateEnrollmentStatusRequest; export type UpdateEnrollmentStatusCommandOutput = UpdateEnrollmentStatusResponse & __MetadataBearer; +/** + *

Updates the enrollment (opt in) status of an account to the AWS Compute Optimizer service.

+ *

If the account is a master account of an organization, this action can also be used to + * enroll member accounts within the organization.

+ */ export class UpdateEnrollmentStatusCommand extends $Command< UpdateEnrollmentStatusCommandInput, UpdateEnrollmentStatusCommandOutput, @@ -34,6 +39,9 @@ export class UpdateEnrollmentStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ComputeOptimizerClientResolvedConfig, diff --git a/clients/client-compute-optimizer/package.json b/clients/client-compute-optimizer/package.json index 9bd5c0f0bb668..063a4914b9427 100644 --- a/clients/client-compute-optimizer/package.json +++ b/clients/client-compute-optimizer/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Compute Optimizer Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-compute-optimizer/runtimeConfig.browser.ts b/clients/client-compute-optimizer/runtimeConfig.browser.ts index b7b983fdb59b5..867334922bde6 100644 --- a/clients/client-compute-optimizer/runtimeConfig.browser.ts +++ b/clients/client-compute-optimizer/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ComputeOptimizerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-compute-optimizer/runtimeConfig.native.ts b/clients/client-compute-optimizer/runtimeConfig.native.ts index 64d9708f1bb0b..e9fd73c91ecd3 100644 --- a/clients/client-compute-optimizer/runtimeConfig.native.ts +++ b/clients/client-compute-optimizer/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ComputeOptimizerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-compute-optimizer/runtimeConfig.shared.ts b/clients/client-compute-optimizer/runtimeConfig.shared.ts index f7d2bf6e7d1c1..86eff162f5466 100644 --- a/clients/client-compute-optimizer/runtimeConfig.shared.ts +++ b/clients/client-compute-optimizer/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-11-01", disableHostPrefix: false, diff --git a/clients/client-compute-optimizer/runtimeConfig.ts b/clients/client-compute-optimizer/runtimeConfig.ts index c4fec42f3024a..9cdedb63ec698 100644 --- a/clients/client-compute-optimizer/runtimeConfig.ts +++ b/clients/client-compute-optimizer/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ComputeOptimizerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-compute-optimizer/tsconfig.json b/clients/client-compute-optimizer/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-compute-optimizer/tsconfig.json +++ b/clients/client-compute-optimizer/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-config-service/commands/BatchGetAggregateResourceConfigCommand.ts b/clients/client-config-service/commands/BatchGetAggregateResourceConfigCommand.ts index 9635f03777e97..36031dd8a18d3 100644 --- a/clients/client-config-service/commands/BatchGetAggregateResourceConfigCommand.ts +++ b/clients/client-config-service/commands/BatchGetAggregateResourceConfigCommand.ts @@ -20,6 +20,21 @@ import { export type BatchGetAggregateResourceConfigCommandInput = BatchGetAggregateResourceConfigRequest; export type BatchGetAggregateResourceConfigCommandOutput = BatchGetAggregateResourceConfigResponse & __MetadataBearer; +/** + *

Returns the current configuration items for resources that are present in your AWS Config aggregator. The operation also returns a list of resources that are not processed in the current request. + * If there are no unprocessed resources, the operation returns an empty unprocessedResourceIdentifiers list.

+ * + * + *
    + *
  • + *

    The API does not return results for deleted resources.

    + *
  • + *
  • + *

    The API does not return tags and relationships.

    + *
  • + *
+ *
+ */ export class BatchGetAggregateResourceConfigCommand extends $Command< BatchGetAggregateResourceConfigCommandInput, BatchGetAggregateResourceConfigCommandOutput, @@ -34,6 +49,9 @@ export class BatchGetAggregateResourceConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/BatchGetResourceConfigCommand.ts b/clients/client-config-service/commands/BatchGetResourceConfigCommand.ts index c4f3d8b1e41ca..04009ad4a4873 100644 --- a/clients/client-config-service/commands/BatchGetResourceConfigCommand.ts +++ b/clients/client-config-service/commands/BatchGetResourceConfigCommand.ts @@ -20,6 +20,27 @@ import { export type BatchGetResourceConfigCommandInput = BatchGetResourceConfigRequest; export type BatchGetResourceConfigCommandOutput = BatchGetResourceConfigResponse & __MetadataBearer; +/** + *

Returns the current configuration for one or more requested + * resources. The operation also returns a list of resources that are + * not processed in the current request. If there are no unprocessed + * resources, the operation returns an empty unprocessedResourceKeys + * list.

+ * + *
    + *
  • + *

    The API does not return results for deleted + * resources.

    + *
  • + *
  • + *

    The API does not return any tags for the requested + * resources. This information is filtered out of the + * supplementaryConfiguration section of the API + * response.

    + *
  • + *
+ *
+ */ export class BatchGetResourceConfigCommand extends $Command< BatchGetResourceConfigCommandInput, BatchGetResourceConfigCommandOutput, @@ -34,6 +55,9 @@ export class BatchGetResourceConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteAggregationAuthorizationCommand.ts b/clients/client-config-service/commands/DeleteAggregationAuthorizationCommand.ts index 3f67b831c703e..1c2334c1edae9 100644 --- a/clients/client-config-service/commands/DeleteAggregationAuthorizationCommand.ts +++ b/clients/client-config-service/commands/DeleteAggregationAuthorizationCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAggregationAuthorizationCommandInput = DeleteAggregationAuthorizationRequest; export type DeleteAggregationAuthorizationCommandOutput = __MetadataBearer; +/** + *

Deletes the authorization granted to the specified + * configuration aggregator account in a specified region.

+ */ export class DeleteAggregationAuthorizationCommand extends $Command< DeleteAggregationAuthorizationCommandInput, DeleteAggregationAuthorizationCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAggregationAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteConfigRuleCommand.ts b/clients/client-config-service/commands/DeleteConfigRuleCommand.ts index 5e8be318c2f1f..330a14b75a4dc 100644 --- a/clients/client-config-service/commands/DeleteConfigRuleCommand.ts +++ b/clients/client-config-service/commands/DeleteConfigRuleCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteConfigRuleCommandInput = DeleteConfigRuleRequest; export type DeleteConfigRuleCommandOutput = __MetadataBearer; +/** + *

Deletes the specified AWS Config rule and all of its evaluation + * results.

+ *

AWS Config sets the state of a rule to DELETING + * until the deletion is complete. You cannot update a rule while it is + * in this state. If you make a PutConfigRule or + * DeleteConfigRule request for the rule, you will + * receive a ResourceInUseException.

+ *

You can check the state of a rule by using the + * DescribeConfigRules request.

+ */ export class DeleteConfigRuleCommand extends $Command< DeleteConfigRuleCommandInput, DeleteConfigRuleCommandOutput, @@ -34,6 +45,9 @@ export class DeleteConfigRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteConfigurationAggregatorCommand.ts b/clients/client-config-service/commands/DeleteConfigurationAggregatorCommand.ts index 0e55d9caf71bf..d19bdbdda4c86 100644 --- a/clients/client-config-service/commands/DeleteConfigurationAggregatorCommand.ts +++ b/clients/client-config-service/commands/DeleteConfigurationAggregatorCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteConfigurationAggregatorCommandInput = DeleteConfigurationAggregatorRequest; export type DeleteConfigurationAggregatorCommandOutput = __MetadataBearer; +/** + *

Deletes the specified configuration aggregator and the + * aggregated data associated with the aggregator.

+ */ export class DeleteConfigurationAggregatorCommand extends $Command< DeleteConfigurationAggregatorCommandInput, DeleteConfigurationAggregatorCommandOutput, @@ -34,6 +38,9 @@ export class DeleteConfigurationAggregatorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteConfigurationRecorderCommand.ts b/clients/client-config-service/commands/DeleteConfigurationRecorderCommand.ts index c36a62b7d566f..0559909070bd0 100644 --- a/clients/client-config-service/commands/DeleteConfigurationRecorderCommand.ts +++ b/clients/client-config-service/commands/DeleteConfigurationRecorderCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteConfigurationRecorderCommandInput = DeleteConfigurationRecorderRequest; export type DeleteConfigurationRecorderCommandOutput = __MetadataBearer; +/** + *

Deletes the configuration recorder.

+ *

After the configuration recorder is deleted, AWS Config will + * not record resource configuration changes until you create a new + * configuration recorder.

+ *

This action does not delete the configuration information that + * was previously recorded. You will be able to access the previously + * recorded information by using the + * GetResourceConfigHistory action, but you will not + * be able to access this information in the AWS Config console until + * you create a new configuration recorder.

+ */ export class DeleteConfigurationRecorderCommand extends $Command< DeleteConfigurationRecorderCommandInput, DeleteConfigurationRecorderCommandOutput, @@ -34,6 +46,9 @@ export class DeleteConfigurationRecorderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteConformancePackCommand.ts b/clients/client-config-service/commands/DeleteConformancePackCommand.ts index d2de4b47f214e..0f5e7ff16ac4e 100644 --- a/clients/client-config-service/commands/DeleteConformancePackCommand.ts +++ b/clients/client-config-service/commands/DeleteConformancePackCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteConformancePackCommandInput = DeleteConformancePackRequest; export type DeleteConformancePackCommandOutput = __MetadataBearer; +/** + *

Deletes the specified conformance pack and all the AWS Config rules, remediation actions, and all evaluation results within that + * conformance pack.

+ *

AWS Config sets the conformance pack to DELETE_IN_PROGRESS until the deletion is complete. + * You cannot update a conformance pack while it is in this state.

+ */ export class DeleteConformancePackCommand extends $Command< DeleteConformancePackCommandInput, DeleteConformancePackCommandOutput, @@ -34,6 +40,9 @@ export class DeleteConformancePackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteDeliveryChannelCommand.ts b/clients/client-config-service/commands/DeleteDeliveryChannelCommand.ts index f514e1b9ea9a3..15132ef88ca9c 100644 --- a/clients/client-config-service/commands/DeleteDeliveryChannelCommand.ts +++ b/clients/client-config-service/commands/DeleteDeliveryChannelCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDeliveryChannelCommandInput = DeleteDeliveryChannelRequest; export type DeleteDeliveryChannelCommandOutput = __MetadataBearer; +/** + *

Deletes the delivery channel.

+ *

Before you can delete the delivery channel, you must stop the + * configuration recorder by using the StopConfigurationRecorder action.

+ */ export class DeleteDeliveryChannelCommand extends $Command< DeleteDeliveryChannelCommandInput, DeleteDeliveryChannelCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDeliveryChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteEvaluationResultsCommand.ts b/clients/client-config-service/commands/DeleteEvaluationResultsCommand.ts index 2e04664d836aa..548bb0e2c84ff 100644 --- a/clients/client-config-service/commands/DeleteEvaluationResultsCommand.ts +++ b/clients/client-config-service/commands/DeleteEvaluationResultsCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteEvaluationResultsCommandInput = DeleteEvaluationResultsRequest; export type DeleteEvaluationResultsCommandOutput = DeleteEvaluationResultsResponse & __MetadataBearer; +/** + *

Deletes the evaluation results for the specified AWS Config + * rule. You can specify one AWS Config rule per request. After you + * delete the evaluation results, you can call the StartConfigRulesEvaluation API to start evaluating + * your AWS resources against the rule.

+ */ export class DeleteEvaluationResultsCommand extends $Command< DeleteEvaluationResultsCommandInput, DeleteEvaluationResultsCommandOutput, @@ -34,6 +40,9 @@ export class DeleteEvaluationResultsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteOrganizationConfigRuleCommand.ts b/clients/client-config-service/commands/DeleteOrganizationConfigRuleCommand.ts index e369f8fe7adef..00511b494ac19 100644 --- a/clients/client-config-service/commands/DeleteOrganizationConfigRuleCommand.ts +++ b/clients/client-config-service/commands/DeleteOrganizationConfigRuleCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteOrganizationConfigRuleCommandInput = DeleteOrganizationConfigRuleRequest; export type DeleteOrganizationConfigRuleCommandOutput = __MetadataBearer; +/** + *

Deletes the specified organization config rule and all of its evaluation results from all member accounts in that organization.

+ *

Only a master account and a delegated administrator account can delete an organization config rule. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ *

AWS Config sets the state of a rule to DELETE_IN_PROGRESS until the deletion is complete. + * You cannot update a rule while it is in this state.

+ */ export class DeleteOrganizationConfigRuleCommand extends $Command< DeleteOrganizationConfigRuleCommandInput, DeleteOrganizationConfigRuleCommandOutput, @@ -34,6 +42,9 @@ export class DeleteOrganizationConfigRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteOrganizationConformancePackCommand.ts b/clients/client-config-service/commands/DeleteOrganizationConformancePackCommand.ts index 233953e0db6ec..ac75da1ee783e 100644 --- a/clients/client-config-service/commands/DeleteOrganizationConformancePackCommand.ts +++ b/clients/client-config-service/commands/DeleteOrganizationConformancePackCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteOrganizationConformancePackCommandInput = DeleteOrganizationConformancePackRequest; export type DeleteOrganizationConformancePackCommandOutput = __MetadataBearer; +/** + *

Deletes the specified organization conformance pack and all of the config rules and remediation actions from + * all member accounts in that organization.

+ *

Only a master account or a delegated administrator account can delete an organization conformance pack. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ *

AWS Config sets the state of a conformance pack to DELETE_IN_PROGRESS until the deletion is complete. + * You cannot update a conformance pack while it is in this state.

+ */ export class DeleteOrganizationConformancePackCommand extends $Command< DeleteOrganizationConformancePackCommandInput, DeleteOrganizationConformancePackCommandOutput, @@ -34,6 +43,9 @@ export class DeleteOrganizationConformancePackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeletePendingAggregationRequestCommand.ts b/clients/client-config-service/commands/DeletePendingAggregationRequestCommand.ts index 7a908bd2e84cd..2246127a7850b 100644 --- a/clients/client-config-service/commands/DeletePendingAggregationRequestCommand.ts +++ b/clients/client-config-service/commands/DeletePendingAggregationRequestCommand.ts @@ -20,6 +20,10 @@ import { export type DeletePendingAggregationRequestCommandInput = DeletePendingAggregationRequestRequest; export type DeletePendingAggregationRequestCommandOutput = __MetadataBearer; +/** + *

Deletes pending authorization requests for a specified + * aggregator account in a specified region.

+ */ export class DeletePendingAggregationRequestCommand extends $Command< DeletePendingAggregationRequestCommandInput, DeletePendingAggregationRequestCommandOutput, @@ -34,6 +38,9 @@ export class DeletePendingAggregationRequestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteRemediationConfigurationCommand.ts b/clients/client-config-service/commands/DeleteRemediationConfigurationCommand.ts index dad8c5e3e1993..151d09389752b 100644 --- a/clients/client-config-service/commands/DeleteRemediationConfigurationCommand.ts +++ b/clients/client-config-service/commands/DeleteRemediationConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRemediationConfigurationCommandInput = DeleteRemediationConfigurationRequest; export type DeleteRemediationConfigurationCommandOutput = DeleteRemediationConfigurationResponse & __MetadataBearer; +/** + *

Deletes the remediation configuration.

+ */ export class DeleteRemediationConfigurationCommand extends $Command< DeleteRemediationConfigurationCommandInput, DeleteRemediationConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRemediationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteRemediationExceptionsCommand.ts b/clients/client-config-service/commands/DeleteRemediationExceptionsCommand.ts index 522a752ed896b..e9a27f0848c42 100644 --- a/clients/client-config-service/commands/DeleteRemediationExceptionsCommand.ts +++ b/clients/client-config-service/commands/DeleteRemediationExceptionsCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteRemediationExceptionsCommandInput = DeleteRemediationExceptionsRequest; export type DeleteRemediationExceptionsCommandOutput = DeleteRemediationExceptionsResponse & __MetadataBearer; +/** + *

Deletes one or more remediation exceptions mentioned in the resource keys.

+ * + *

AWS Config generates a remediation exception when a problem occurs executing a remediation action to a specific resource. + * Remediation exceptions blocks auto-remediation until the exception is cleared.

+ *
+ */ export class DeleteRemediationExceptionsCommand extends $Command< DeleteRemediationExceptionsCommandInput, DeleteRemediationExceptionsCommandOutput, @@ -34,6 +41,9 @@ export class DeleteRemediationExceptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteResourceConfigCommand.ts b/clients/client-config-service/commands/DeleteResourceConfigCommand.ts index 250711c8e8087..edf36f75fd6de 100644 --- a/clients/client-config-service/commands/DeleteResourceConfigCommand.ts +++ b/clients/client-config-service/commands/DeleteResourceConfigCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteResourceConfigCommandInput = DeleteResourceConfigRequest; export type DeleteResourceConfigCommandOutput = __MetadataBearer; +/** + *

Records the configuration state for a custom resource that has been deleted. This API records a new ConfigurationItem with a ResourceDeleted status. You can retrieve the ConfigurationItems recorded for this resource in your AWS Config History. + *

+ */ export class DeleteResourceConfigCommand extends $Command< DeleteResourceConfigCommandInput, DeleteResourceConfigCommandOutput, @@ -34,6 +38,9 @@ export class DeleteResourceConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeleteRetentionConfigurationCommand.ts b/clients/client-config-service/commands/DeleteRetentionConfigurationCommand.ts index 074d85078368d..98e1484698dba 100644 --- a/clients/client-config-service/commands/DeleteRetentionConfigurationCommand.ts +++ b/clients/client-config-service/commands/DeleteRetentionConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRetentionConfigurationCommandInput = DeleteRetentionConfigurationRequest; export type DeleteRetentionConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the retention configuration.

+ */ export class DeleteRetentionConfigurationCommand extends $Command< DeleteRetentionConfigurationCommandInput, DeleteRetentionConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRetentionConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DeliverConfigSnapshotCommand.ts b/clients/client-config-service/commands/DeliverConfigSnapshotCommand.ts index d6f4d0956249d..3d075b27d66c0 100644 --- a/clients/client-config-service/commands/DeliverConfigSnapshotCommand.ts +++ b/clients/client-config-service/commands/DeliverConfigSnapshotCommand.ts @@ -20,6 +20,25 @@ import { export type DeliverConfigSnapshotCommandInput = DeliverConfigSnapshotRequest; export type DeliverConfigSnapshotCommandOutput = DeliverConfigSnapshotResponse & __MetadataBearer; +/** + *

Schedules delivery of a configuration snapshot to the Amazon S3 + * bucket in the specified delivery channel. After the delivery has + * started, AWS Config sends the following notifications using an + * Amazon SNS topic that you have specified.

+ *
    + *
  • + *

    Notification of the start of the delivery.

    + *
  • + *
  • + *

    Notification of the completion of the delivery, if the + * delivery was successfully completed.

    + *
  • + *
  • + *

    Notification of delivery failure, if the delivery + * failed.

    + *
  • + *
+ */ export class DeliverConfigSnapshotCommand extends $Command< DeliverConfigSnapshotCommandInput, DeliverConfigSnapshotCommandOutput, @@ -34,6 +53,9 @@ export class DeliverConfigSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeAggregateComplianceByConfigRulesCommand.ts b/clients/client-config-service/commands/DescribeAggregateComplianceByConfigRulesCommand.ts index dc1e594cb70bf..c1ed916b34850 100644 --- a/clients/client-config-service/commands/DescribeAggregateComplianceByConfigRulesCommand.ts +++ b/clients/client-config-service/commands/DescribeAggregateComplianceByConfigRulesCommand.ts @@ -24,6 +24,16 @@ export type DescribeAggregateComplianceByConfigRulesCommandInput = DescribeAggre export type DescribeAggregateComplianceByConfigRulesCommandOutput = DescribeAggregateComplianceByConfigRulesResponse & __MetadataBearer; +/** + *

Returns a list of compliant and noncompliant rules with the + * number of resources for compliant and noncompliant rules. + *

+ * + *

The results can return an empty result page, but if you + * have a nextToken, the results are displayed on the next + * page.

+ *
+ */ export class DescribeAggregateComplianceByConfigRulesCommand extends $Command< DescribeAggregateComplianceByConfigRulesCommandInput, DescribeAggregateComplianceByConfigRulesCommandOutput, @@ -38,6 +48,9 @@ export class DescribeAggregateComplianceByConfigRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeAggregationAuthorizationsCommand.ts b/clients/client-config-service/commands/DescribeAggregationAuthorizationsCommand.ts index 6bcfbba94040f..6faa88af29e42 100644 --- a/clients/client-config-service/commands/DescribeAggregationAuthorizationsCommand.ts +++ b/clients/client-config-service/commands/DescribeAggregationAuthorizationsCommand.ts @@ -24,6 +24,10 @@ export type DescribeAggregationAuthorizationsCommandInput = DescribeAggregationA export type DescribeAggregationAuthorizationsCommandOutput = DescribeAggregationAuthorizationsResponse & __MetadataBearer; +/** + *

Returns a list of authorizations granted to various aggregator + * accounts and regions.

+ */ export class DescribeAggregationAuthorizationsCommand extends $Command< DescribeAggregationAuthorizationsCommandInput, DescribeAggregationAuthorizationsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeAggregationAuthorizationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeComplianceByConfigRuleCommand.ts b/clients/client-config-service/commands/DescribeComplianceByConfigRuleCommand.ts index 025060077e6f1..3281271639c86 100644 --- a/clients/client-config-service/commands/DescribeComplianceByConfigRuleCommand.ts +++ b/clients/client-config-service/commands/DescribeComplianceByConfigRuleCommand.ts @@ -20,6 +20,41 @@ import { export type DescribeComplianceByConfigRuleCommandInput = DescribeComplianceByConfigRuleRequest; export type DescribeComplianceByConfigRuleCommandOutput = DescribeComplianceByConfigRuleResponse & __MetadataBearer; +/** + *

Indicates whether the specified AWS Config rules are compliant. + * If a rule is noncompliant, this action returns the number of AWS + * resources that do not comply with the rule.

+ *

A rule is compliant if all of the evaluated resources comply + * with it. It is noncompliant if any of these resources do not + * comply.

+ *

If AWS Config has no current evaluation results for the rule, + * it returns INSUFFICIENT_DATA. This result might + * indicate one of the following conditions:

+ *
    + *
  • + *

    AWS Config has never invoked an evaluation for the + * rule. To check whether it has, use the + * DescribeConfigRuleEvaluationStatus action + * to get the LastSuccessfulInvocationTime and + * LastFailedInvocationTime.

    + *
  • + *
  • + *

    The rule's AWS Lambda function is failing to send + * evaluation results to AWS Config. Verify that the role you + * assigned to your configuration recorder includes the + * config:PutEvaluations permission. If the + * rule is a custom rule, verify that the AWS Lambda execution + * role includes the config:PutEvaluations + * permission.

    + *
  • + *
  • + *

    The rule's AWS Lambda function has returned + * NOT_APPLICABLE for all evaluation results. + * This can occur if the resources were deleted or removed from + * the rule's scope.

    + *
  • + *
+ */ export class DescribeComplianceByConfigRuleCommand extends $Command< DescribeComplianceByConfigRuleCommandInput, DescribeComplianceByConfigRuleCommandOutput, @@ -34,6 +69,9 @@ export class DescribeComplianceByConfigRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeComplianceByResourceCommand.ts b/clients/client-config-service/commands/DescribeComplianceByResourceCommand.ts index bb72043f4605e..ffa01f7e89114 100644 --- a/clients/client-config-service/commands/DescribeComplianceByResourceCommand.ts +++ b/clients/client-config-service/commands/DescribeComplianceByResourceCommand.ts @@ -20,6 +20,42 @@ import { export type DescribeComplianceByResourceCommandInput = DescribeComplianceByResourceRequest; export type DescribeComplianceByResourceCommandOutput = DescribeComplianceByResourceResponse & __MetadataBearer; +/** + *

Indicates whether the specified AWS resources are compliant. If + * a resource is noncompliant, this action returns the number of AWS + * Config rules that the resource does not comply with.

+ *

A resource is compliant if it complies with all the AWS Config + * rules that evaluate it. It is noncompliant if it does not comply + * with one or more of these rules.

+ *

If AWS Config has no current evaluation results for the + * resource, it returns INSUFFICIENT_DATA. This result + * might indicate one of the following conditions about the rules that + * evaluate the resource:

+ *
    + *
  • + *

    AWS Config has never invoked an evaluation for the + * rule. To check whether it has, use the + * DescribeConfigRuleEvaluationStatus action + * to get the LastSuccessfulInvocationTime and + * LastFailedInvocationTime.

    + *
  • + *
  • + *

    The rule's AWS Lambda function is failing to send + * evaluation results to AWS Config. Verify that the role that + * you assigned to your configuration recorder includes the + * config:PutEvaluations permission. If the + * rule is a custom rule, verify that the AWS Lambda execution + * role includes the config:PutEvaluations + * permission.

    + *
  • + *
  • + *

    The rule's AWS Lambda function has returned + * NOT_APPLICABLE for all evaluation results. + * This can occur if the resources were deleted or removed from + * the rule's scope.

    + *
  • + *
+ */ export class DescribeComplianceByResourceCommand extends $Command< DescribeComplianceByResourceCommandInput, DescribeComplianceByResourceCommandOutput, @@ -34,6 +70,9 @@ export class DescribeComplianceByResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConfigRuleEvaluationStatusCommand.ts b/clients/client-config-service/commands/DescribeConfigRuleEvaluationStatusCommand.ts index cb017efdb607f..00ca98a33e08c 100644 --- a/clients/client-config-service/commands/DescribeConfigRuleEvaluationStatusCommand.ts +++ b/clients/client-config-service/commands/DescribeConfigRuleEvaluationStatusCommand.ts @@ -24,6 +24,12 @@ export type DescribeConfigRuleEvaluationStatusCommandInput = DescribeConfigRuleE export type DescribeConfigRuleEvaluationStatusCommandOutput = DescribeConfigRuleEvaluationStatusResponse & __MetadataBearer; +/** + *

Returns status information for each of your AWS managed Config + * rules. The status includes information such as the last time AWS + * Config invoked the rule, the last time AWS Config failed to invoke + * the rule, and the related error for the last failure.

+ */ export class DescribeConfigRuleEvaluationStatusCommand extends $Command< DescribeConfigRuleEvaluationStatusCommandInput, DescribeConfigRuleEvaluationStatusCommandOutput, @@ -38,6 +44,9 @@ export class DescribeConfigRuleEvaluationStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConfigRulesCommand.ts b/clients/client-config-service/commands/DescribeConfigRulesCommand.ts index 178e12819eb83..3e855fe80649c 100644 --- a/clients/client-config-service/commands/DescribeConfigRulesCommand.ts +++ b/clients/client-config-service/commands/DescribeConfigRulesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeConfigRulesCommandInput = DescribeConfigRulesRequest; export type DescribeConfigRulesCommandOutput = DescribeConfigRulesResponse & __MetadataBearer; +/** + *

Returns details about your AWS Config rules.

+ */ export class DescribeConfigRulesCommand extends $Command< DescribeConfigRulesCommandInput, DescribeConfigRulesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeConfigRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConfigurationAggregatorSourcesStatusCommand.ts b/clients/client-config-service/commands/DescribeConfigurationAggregatorSourcesStatusCommand.ts index 45094f39ab58a..b71e67e04c1b1 100644 --- a/clients/client-config-service/commands/DescribeConfigurationAggregatorSourcesStatusCommand.ts +++ b/clients/client-config-service/commands/DescribeConfigurationAggregatorSourcesStatusCommand.ts @@ -24,6 +24,10 @@ export type DescribeConfigurationAggregatorSourcesStatusCommandInput = DescribeC export type DescribeConfigurationAggregatorSourcesStatusCommandOutput = DescribeConfigurationAggregatorSourcesStatusResponse & __MetadataBearer; +/** + *

Returns status information for sources within an aggregator. + * The status includes information about the last time AWS Config verified authorization between the source account and an aggregator account. In case of a failure, the status contains the related error code or message.

+ */ export class DescribeConfigurationAggregatorSourcesStatusCommand extends $Command< DescribeConfigurationAggregatorSourcesStatusCommandInput, DescribeConfigurationAggregatorSourcesStatusCommandOutput, @@ -38,6 +42,9 @@ export class DescribeConfigurationAggregatorSourcesStatusCommand extends $Comman // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConfigurationAggregatorsCommand.ts b/clients/client-config-service/commands/DescribeConfigurationAggregatorsCommand.ts index f358f56d304b7..e4714fac05096 100644 --- a/clients/client-config-service/commands/DescribeConfigurationAggregatorsCommand.ts +++ b/clients/client-config-service/commands/DescribeConfigurationAggregatorsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeConfigurationAggregatorsCommandInput = DescribeConfigurationAggregatorsRequest; export type DescribeConfigurationAggregatorsCommandOutput = DescribeConfigurationAggregatorsResponse & __MetadataBearer; +/** + *

Returns the details of one or more configuration aggregators. + * If the configuration aggregator is not specified, this action + * returns the details for all the configuration aggregators associated + * with the account.

+ */ export class DescribeConfigurationAggregatorsCommand extends $Command< DescribeConfigurationAggregatorsCommandInput, DescribeConfigurationAggregatorsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeConfigurationAggregatorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConfigurationRecorderStatusCommand.ts b/clients/client-config-service/commands/DescribeConfigurationRecorderStatusCommand.ts index 45b7540b75689..957776a945a18 100644 --- a/clients/client-config-service/commands/DescribeConfigurationRecorderStatusCommand.ts +++ b/clients/client-config-service/commands/DescribeConfigurationRecorderStatusCommand.ts @@ -24,6 +24,16 @@ export type DescribeConfigurationRecorderStatusCommandInput = DescribeConfigurat export type DescribeConfigurationRecorderStatusCommandOutput = DescribeConfigurationRecorderStatusResponse & __MetadataBearer; +/** + *

Returns the current status of the specified configuration + * recorder. If a configuration recorder is not specified, this action + * returns the status of all configuration recorders associated with + * the account.

+ * + *

Currently, you can specify only one configuration recorder + * per region in your account.

+ *
+ */ export class DescribeConfigurationRecorderStatusCommand extends $Command< DescribeConfigurationRecorderStatusCommandInput, DescribeConfigurationRecorderStatusCommandOutput, @@ -38,6 +48,9 @@ export class DescribeConfigurationRecorderStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConfigurationRecordersCommand.ts b/clients/client-config-service/commands/DescribeConfigurationRecordersCommand.ts index 08ca2176c2cf9..cb84ff671290b 100644 --- a/clients/client-config-service/commands/DescribeConfigurationRecordersCommand.ts +++ b/clients/client-config-service/commands/DescribeConfigurationRecordersCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeConfigurationRecordersCommandInput = DescribeConfigurationRecordersRequest; export type DescribeConfigurationRecordersCommandOutput = DescribeConfigurationRecordersResponse & __MetadataBearer; +/** + *

Returns the details for the specified configuration recorders. + * If the configuration recorder is not specified, this action returns + * the details for all configuration recorders associated with the + * account.

+ * + *

Currently, you can specify only one configuration recorder + * per region in your account.

+ *
+ */ export class DescribeConfigurationRecordersCommand extends $Command< DescribeConfigurationRecordersCommandInput, DescribeConfigurationRecordersCommandOutput, @@ -34,6 +44,9 @@ export class DescribeConfigurationRecordersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConformancePackComplianceCommand.ts b/clients/client-config-service/commands/DescribeConformancePackComplianceCommand.ts index 1fd5d31922c1b..58d2f26ee14b3 100644 --- a/clients/client-config-service/commands/DescribeConformancePackComplianceCommand.ts +++ b/clients/client-config-service/commands/DescribeConformancePackComplianceCommand.ts @@ -24,6 +24,12 @@ export type DescribeConformancePackComplianceCommandInput = DescribeConformanceP export type DescribeConformancePackComplianceCommandOutput = DescribeConformancePackComplianceResponse & __MetadataBearer; +/** + *

Returns compliance details for each rule in that conformance pack.

+ * + *

You must provide exact rule names.

+ *
+ */ export class DescribeConformancePackComplianceCommand extends $Command< DescribeConformancePackComplianceCommandInput, DescribeConformancePackComplianceCommandOutput, @@ -38,6 +44,9 @@ export class DescribeConformancePackComplianceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConformancePackStatusCommand.ts b/clients/client-config-service/commands/DescribeConformancePackStatusCommand.ts index bb06156502844..c8be91b89f907 100644 --- a/clients/client-config-service/commands/DescribeConformancePackStatusCommand.ts +++ b/clients/client-config-service/commands/DescribeConformancePackStatusCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeConformancePackStatusCommandInput = DescribeConformancePackStatusRequest; export type DescribeConformancePackStatusCommandOutput = DescribeConformancePackStatusResponse & __MetadataBearer; +/** + *

Provides one or more conformance packs deployment status.

+ * + *

If there are no conformance packs then you will see an empty result.

+ *
+ */ export class DescribeConformancePackStatusCommand extends $Command< DescribeConformancePackStatusCommandInput, DescribeConformancePackStatusCommandOutput, @@ -34,6 +40,9 @@ export class DescribeConformancePackStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeConformancePacksCommand.ts b/clients/client-config-service/commands/DescribeConformancePacksCommand.ts index 0f078308e1679..b7a3b1d280d7f 100644 --- a/clients/client-config-service/commands/DescribeConformancePacksCommand.ts +++ b/clients/client-config-service/commands/DescribeConformancePacksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeConformancePacksCommandInput = DescribeConformancePacksRequest; export type DescribeConformancePacksCommandOutput = DescribeConformancePacksResponse & __MetadataBearer; +/** + *

Returns a list of one or more conformance packs.

+ */ export class DescribeConformancePacksCommand extends $Command< DescribeConformancePacksCommandInput, DescribeConformancePacksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeConformancePacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeDeliveryChannelStatusCommand.ts b/clients/client-config-service/commands/DescribeDeliveryChannelStatusCommand.ts index 02a49ae3e38e5..419cfe46c70cc 100644 --- a/clients/client-config-service/commands/DescribeDeliveryChannelStatusCommand.ts +++ b/clients/client-config-service/commands/DescribeDeliveryChannelStatusCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeDeliveryChannelStatusCommandInput = DescribeDeliveryChannelStatusRequest; export type DescribeDeliveryChannelStatusCommandOutput = DescribeDeliveryChannelStatusResponse & __MetadataBearer; +/** + *

Returns the current status of the specified delivery channel. + * If a delivery channel is not specified, this action returns the + * current status of all delivery channels associated with the + * account.

+ * + *

Currently, you can specify only one delivery channel per + * region in your account.

+ *
+ */ export class DescribeDeliveryChannelStatusCommand extends $Command< DescribeDeliveryChannelStatusCommandInput, DescribeDeliveryChannelStatusCommandOutput, @@ -34,6 +44,9 @@ export class DescribeDeliveryChannelStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeDeliveryChannelsCommand.ts b/clients/client-config-service/commands/DescribeDeliveryChannelsCommand.ts index fecdde44b2265..21adffb069381 100644 --- a/clients/client-config-service/commands/DescribeDeliveryChannelsCommand.ts +++ b/clients/client-config-service/commands/DescribeDeliveryChannelsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeDeliveryChannelsCommandInput = DescribeDeliveryChannelsRequest; export type DescribeDeliveryChannelsCommandOutput = DescribeDeliveryChannelsResponse & __MetadataBearer; +/** + *

Returns details about the specified delivery channel. If a + * delivery channel is not specified, this action returns the details + * of all delivery channels associated with the account.

+ * + *

Currently, you can specify only one delivery channel per + * region in your account.

+ *
+ */ export class DescribeDeliveryChannelsCommand extends $Command< DescribeDeliveryChannelsCommandInput, DescribeDeliveryChannelsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeDeliveryChannelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeOrganizationConfigRuleStatusesCommand.ts b/clients/client-config-service/commands/DescribeOrganizationConfigRuleStatusesCommand.ts index 297e735697136..31c7c4f7f3eaf 100644 --- a/clients/client-config-service/commands/DescribeOrganizationConfigRuleStatusesCommand.ts +++ b/clients/client-config-service/commands/DescribeOrganizationConfigRuleStatusesCommand.ts @@ -24,6 +24,19 @@ export type DescribeOrganizationConfigRuleStatusesCommandInput = DescribeOrganiz export type DescribeOrganizationConfigRuleStatusesCommandOutput = DescribeOrganizationConfigRuleStatusesResponse & __MetadataBearer; +/** + *

Provides organization config rule deployment status for an organization.

+ *

Only a master account and a delegated administrator account can call this API. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ * + *

The status is not considered successful until organization config rule is successfully deployed in all the member + * accounts with an exception of excluded accounts.

+ *

When you specify the limit and the next token, you receive a paginated response. + * Limit and next token are not applicable if you specify organization config rule names. + * It is only applicable, when you request all the organization config rules.

+ *
+ */ export class DescribeOrganizationConfigRuleStatusesCommand extends $Command< DescribeOrganizationConfigRuleStatusesCommandInput, DescribeOrganizationConfigRuleStatusesCommandOutput, @@ -38,6 +51,9 @@ export class DescribeOrganizationConfigRuleStatusesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeOrganizationConfigRulesCommand.ts b/clients/client-config-service/commands/DescribeOrganizationConfigRulesCommand.ts index 9af2860b26382..8f828c82aa975 100644 --- a/clients/client-config-service/commands/DescribeOrganizationConfigRulesCommand.ts +++ b/clients/client-config-service/commands/DescribeOrganizationConfigRulesCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeOrganizationConfigRulesCommandInput = DescribeOrganizationConfigRulesRequest; export type DescribeOrganizationConfigRulesCommandOutput = DescribeOrganizationConfigRulesResponse & __MetadataBearer; +/** + *

Returns a list of organization config rules.

+ *

Only a master account and a delegated administrator account can call this API. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.


+ * + *

When you specify the limit and the next token, you receive a paginated response. + * Limit and next token are not applicable if you specify organization config rule names. + * It is only applicable, when you request all the organization config rules.

+ *
+ */ export class DescribeOrganizationConfigRulesCommand extends $Command< DescribeOrganizationConfigRulesCommandInput, DescribeOrganizationConfigRulesCommandOutput, @@ -34,6 +45,9 @@ export class DescribeOrganizationConfigRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeOrganizationConformancePackStatusesCommand.ts b/clients/client-config-service/commands/DescribeOrganizationConformancePackStatusesCommand.ts index db447fb481d55..33bc240f72128 100644 --- a/clients/client-config-service/commands/DescribeOrganizationConformancePackStatusesCommand.ts +++ b/clients/client-config-service/commands/DescribeOrganizationConformancePackStatusesCommand.ts @@ -24,6 +24,19 @@ export type DescribeOrganizationConformancePackStatusesCommandInput = DescribeOr export type DescribeOrganizationConformancePackStatusesCommandOutput = DescribeOrganizationConformancePackStatusesResponse & __MetadataBearer; +/** + *

Provides organization conformance pack deployment status for an organization.

+ *

Only a master account and a delegated administrator account can call this API. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ * + *

The status is not considered successful until organization conformance pack is successfully + * deployed in all the member accounts with an exception of excluded accounts.

+ *

When you specify the limit and the next token, you receive a paginated response. + * Limit and next token are not applicable if you specify organization conformance pack names. + * They are only applicable, when you request all the organization conformance packs.

+ *
+ */ export class DescribeOrganizationConformancePackStatusesCommand extends $Command< DescribeOrganizationConformancePackStatusesCommandInput, DescribeOrganizationConformancePackStatusesCommandOutput, @@ -38,6 +51,9 @@ export class DescribeOrganizationConformancePackStatusesCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeOrganizationConformancePacksCommand.ts b/clients/client-config-service/commands/DescribeOrganizationConformancePacksCommand.ts index e56e821ba4a11..06104f166939b 100644 --- a/clients/client-config-service/commands/DescribeOrganizationConformancePacksCommand.ts +++ b/clients/client-config-service/commands/DescribeOrganizationConformancePacksCommand.ts @@ -24,6 +24,17 @@ export type DescribeOrganizationConformancePacksCommandInput = DescribeOrganizat export type DescribeOrganizationConformancePacksCommandOutput = DescribeOrganizationConformancePacksResponse & __MetadataBearer; +/** + *

Returns a list of organization conformance packs.

+ *

Only a master account and a delegated administrator account can call this API. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ * + *

When you specify the limit and the next token, you receive a paginated response.

+ *

Limit and next token are not applicable if you specify organization conformance packs names. They are only applicable, + * when you request all the organization conformance packs.

+ *
+ */ export class DescribeOrganizationConformancePacksCommand extends $Command< DescribeOrganizationConformancePacksCommandInput, DescribeOrganizationConformancePacksCommandOutput, @@ -38,6 +49,9 @@ export class DescribeOrganizationConformancePacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribePendingAggregationRequestsCommand.ts b/clients/client-config-service/commands/DescribePendingAggregationRequestsCommand.ts index eb4ec2d9b5a99..afe9d4d03fc84 100644 --- a/clients/client-config-service/commands/DescribePendingAggregationRequestsCommand.ts +++ b/clients/client-config-service/commands/DescribePendingAggregationRequestsCommand.ts @@ -24,6 +24,9 @@ export type DescribePendingAggregationRequestsCommandInput = DescribePendingAggr export type DescribePendingAggregationRequestsCommandOutput = DescribePendingAggregationRequestsResponse & __MetadataBearer; +/** + *

Returns a list of all pending aggregation requests.

+ */ export class DescribePendingAggregationRequestsCommand extends $Command< DescribePendingAggregationRequestsCommandInput, DescribePendingAggregationRequestsCommandOutput, @@ -38,6 +41,9 @@ export class DescribePendingAggregationRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeRemediationConfigurationsCommand.ts b/clients/client-config-service/commands/DescribeRemediationConfigurationsCommand.ts index 7cc01de7b0fb9..9ccc59bd7846f 100644 --- a/clients/client-config-service/commands/DescribeRemediationConfigurationsCommand.ts +++ b/clients/client-config-service/commands/DescribeRemediationConfigurationsCommand.ts @@ -24,6 +24,9 @@ export type DescribeRemediationConfigurationsCommandInput = DescribeRemediationC export type DescribeRemediationConfigurationsCommandOutput = DescribeRemediationConfigurationsResponse & __MetadataBearer; +/** + *

Returns the details of one or more remediation configurations.

+ */ export class DescribeRemediationConfigurationsCommand extends $Command< DescribeRemediationConfigurationsCommandInput, DescribeRemediationConfigurationsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeRemediationConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeRemediationExceptionsCommand.ts b/clients/client-config-service/commands/DescribeRemediationExceptionsCommand.ts index f49b9b51c893d..0e6173f6f8b06 100644 --- a/clients/client-config-service/commands/DescribeRemediationExceptionsCommand.ts +++ b/clients/client-config-service/commands/DescribeRemediationExceptionsCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeRemediationExceptionsCommandInput = DescribeRemediationExceptionsRequest; export type DescribeRemediationExceptionsCommandOutput = DescribeRemediationExceptionsResponse & __MetadataBearer; +/** + *

Returns the details of one or more remediation exceptions. A detailed view of a remediation exception for a set of resources that includes an explanation of an exception and the time when the exception will be deleted. + * When you specify the limit and the next token, you receive a paginated response.

+ * + *

AWS Config generates a remediation exception when a problem occurs executing a remediation action to a specific resource. + * Remediation exceptions blocks auto-remediation until the exception is cleared.

+ *

When you specify the limit and the next token, you receive a paginated response.

+ *

Limit and next token are not applicable if you request resources in batch. It is only applicable, when you request all resources.

+ *
+ */ export class DescribeRemediationExceptionsCommand extends $Command< DescribeRemediationExceptionsCommandInput, DescribeRemediationExceptionsCommandOutput, @@ -34,6 +44,9 @@ export class DescribeRemediationExceptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeRemediationExecutionStatusCommand.ts b/clients/client-config-service/commands/DescribeRemediationExecutionStatusCommand.ts index fe69705161f45..4d4d4143b7efc 100644 --- a/clients/client-config-service/commands/DescribeRemediationExecutionStatusCommand.ts +++ b/clients/client-config-service/commands/DescribeRemediationExecutionStatusCommand.ts @@ -24,6 +24,10 @@ export type DescribeRemediationExecutionStatusCommandInput = DescribeRemediation export type DescribeRemediationExecutionStatusCommandOutput = DescribeRemediationExecutionStatusResponse & __MetadataBearer; +/** + *

Provides a detailed view of a Remediation Execution for a set of resources including state, timestamps for when steps for the remediation execution occur, and any error messages for steps that have failed. + * When you specify the limit and the next token, you receive a paginated response.

+ */ export class DescribeRemediationExecutionStatusCommand extends $Command< DescribeRemediationExecutionStatusCommandInput, DescribeRemediationExecutionStatusCommandOutput, @@ -38,6 +42,9 @@ export class DescribeRemediationExecutionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/DescribeRetentionConfigurationsCommand.ts b/clients/client-config-service/commands/DescribeRetentionConfigurationsCommand.ts index 6c0d237ebb938..07258a7c39300 100644 --- a/clients/client-config-service/commands/DescribeRetentionConfigurationsCommand.ts +++ b/clients/client-config-service/commands/DescribeRetentionConfigurationsCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeRetentionConfigurationsCommandInput = DescribeRetentionConfigurationsRequest; export type DescribeRetentionConfigurationsCommandOutput = DescribeRetentionConfigurationsResponse & __MetadataBearer; +/** + *

Returns the details of one or more retention configurations. If + * the retention configuration name is not specified, this action + * returns the details for all the retention configurations for that + * account.

+ * + *

Currently, AWS Config supports only one retention + * configuration per region in your account.

+ *
+ */ export class DescribeRetentionConfigurationsCommand extends $Command< DescribeRetentionConfigurationsCommandInput, DescribeRetentionConfigurationsCommandOutput, @@ -34,6 +44,9 @@ export class DescribeRetentionConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetAggregateComplianceDetailsByConfigRuleCommand.ts b/clients/client-config-service/commands/GetAggregateComplianceDetailsByConfigRuleCommand.ts index 0898a45fb73e6..87f784e0e1a3e 100644 --- a/clients/client-config-service/commands/GetAggregateComplianceDetailsByConfigRuleCommand.ts +++ b/clients/client-config-service/commands/GetAggregateComplianceDetailsByConfigRuleCommand.ts @@ -24,6 +24,17 @@ export type GetAggregateComplianceDetailsByConfigRuleCommandInput = GetAggregate export type GetAggregateComplianceDetailsByConfigRuleCommandOutput = GetAggregateComplianceDetailsByConfigRuleResponse & __MetadataBearer; +/** + *

Returns the evaluation results for the specified AWS Config + * rule for a specific resource in a rule. The results indicate which + * AWS resources were evaluated by the rule, when each resource was + * last evaluated, and whether each resource complies with the rule.

+ * + *

The results can return an empty result page. But if you + * have a nextToken, the results are displayed on the next + * page.

+ *
+ */ export class GetAggregateComplianceDetailsByConfigRuleCommand extends $Command< GetAggregateComplianceDetailsByConfigRuleCommandInput, GetAggregateComplianceDetailsByConfigRuleCommandOutput, @@ -38,6 +49,9 @@ export class GetAggregateComplianceDetailsByConfigRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetAggregateConfigRuleComplianceSummaryCommand.ts b/clients/client-config-service/commands/GetAggregateConfigRuleComplianceSummaryCommand.ts index ce869317e695f..8c6967b5c73d2 100644 --- a/clients/client-config-service/commands/GetAggregateConfigRuleComplianceSummaryCommand.ts +++ b/clients/client-config-service/commands/GetAggregateConfigRuleComplianceSummaryCommand.ts @@ -24,6 +24,15 @@ export type GetAggregateConfigRuleComplianceSummaryCommandInput = GetAggregateCo export type GetAggregateConfigRuleComplianceSummaryCommandOutput = GetAggregateConfigRuleComplianceSummaryResponse & __MetadataBearer; +/** + *

Returns the number of compliant and noncompliant rules for one + * or more accounts and regions in an aggregator.

+ * + *

The results can return an empty result page, but if you + * have a nextToken, the results are displayed on the next + * page.

+ *
+ */ export class GetAggregateConfigRuleComplianceSummaryCommand extends $Command< GetAggregateConfigRuleComplianceSummaryCommandInput, GetAggregateConfigRuleComplianceSummaryCommandOutput, @@ -38,6 +47,9 @@ export class GetAggregateConfigRuleComplianceSummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetAggregateDiscoveredResourceCountsCommand.ts b/clients/client-config-service/commands/GetAggregateDiscoveredResourceCountsCommand.ts index db3bc38c7ad3d..fac669019c6f6 100644 --- a/clients/client-config-service/commands/GetAggregateDiscoveredResourceCountsCommand.ts +++ b/clients/client-config-service/commands/GetAggregateDiscoveredResourceCountsCommand.ts @@ -24,6 +24,11 @@ export type GetAggregateDiscoveredResourceCountsCommandInput = GetAggregateDisco export type GetAggregateDiscoveredResourceCountsCommandOutput = GetAggregateDiscoveredResourceCountsResponse & __MetadataBearer; +/** + *

Returns the resource counts across accounts and regions that are present in your AWS Config aggregator. You can request the resource counts by providing filters and GroupByKey.

+ *

For example, if the input contains accountID 12345678910 and region us-east-1 in filters, the API returns the count of resources in account ID 12345678910 and region us-east-1. + * If the input contains ACCOUNT_ID as a GroupByKey, the API returns resource counts for all source accounts that are present in your aggregator.

+ */ export class GetAggregateDiscoveredResourceCountsCommand extends $Command< GetAggregateDiscoveredResourceCountsCommandInput, GetAggregateDiscoveredResourceCountsCommandOutput, @@ -38,6 +43,9 @@ export class GetAggregateDiscoveredResourceCountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetAggregateResourceConfigCommand.ts b/clients/client-config-service/commands/GetAggregateResourceConfigCommand.ts index 85f41c2cff4e0..11130a73a790d 100644 --- a/clients/client-config-service/commands/GetAggregateResourceConfigCommand.ts +++ b/clients/client-config-service/commands/GetAggregateResourceConfigCommand.ts @@ -20,6 +20,9 @@ import { export type GetAggregateResourceConfigCommandInput = GetAggregateResourceConfigRequest; export type GetAggregateResourceConfigCommandOutput = GetAggregateResourceConfigResponse & __MetadataBearer; +/** + *

Returns configuration item that is aggregated for your specific resource in a specific source account and region.

+ */ export class GetAggregateResourceConfigCommand extends $Command< GetAggregateResourceConfigCommandInput, GetAggregateResourceConfigCommandOutput, @@ -34,6 +37,9 @@ export class GetAggregateResourceConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetComplianceDetailsByConfigRuleCommand.ts b/clients/client-config-service/commands/GetComplianceDetailsByConfigRuleCommand.ts index 27a5c0ad71865..e4fd567122e2a 100644 --- a/clients/client-config-service/commands/GetComplianceDetailsByConfigRuleCommand.ts +++ b/clients/client-config-service/commands/GetComplianceDetailsByConfigRuleCommand.ts @@ -20,6 +20,12 @@ import { export type GetComplianceDetailsByConfigRuleCommandInput = GetComplianceDetailsByConfigRuleRequest; export type GetComplianceDetailsByConfigRuleCommandOutput = GetComplianceDetailsByConfigRuleResponse & __MetadataBearer; +/** + *

Returns the evaluation results for the specified AWS Config + * rule. The results indicate which AWS resources were evaluated by the + * rule, when each resource was last evaluated, and whether each + * resource complies with the rule.

+ */ export class GetComplianceDetailsByConfigRuleCommand extends $Command< GetComplianceDetailsByConfigRuleCommandInput, GetComplianceDetailsByConfigRuleCommandOutput, @@ -34,6 +40,9 @@ export class GetComplianceDetailsByConfigRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetComplianceDetailsByResourceCommand.ts b/clients/client-config-service/commands/GetComplianceDetailsByResourceCommand.ts index 98b9ef9966fd4..305dc873424a5 100644 --- a/clients/client-config-service/commands/GetComplianceDetailsByResourceCommand.ts +++ b/clients/client-config-service/commands/GetComplianceDetailsByResourceCommand.ts @@ -20,6 +20,12 @@ import { export type GetComplianceDetailsByResourceCommandInput = GetComplianceDetailsByResourceRequest; export type GetComplianceDetailsByResourceCommandOutput = GetComplianceDetailsByResourceResponse & __MetadataBearer; +/** + *

Returns the evaluation results for the specified AWS resource. + * The results indicate which AWS Config rules were used to evaluate + * the resource, when each rule was last used, and whether the resource + * complies with each rule.

+ */ export class GetComplianceDetailsByResourceCommand extends $Command< GetComplianceDetailsByResourceCommandInput, GetComplianceDetailsByResourceCommandOutput, @@ -34,6 +40,9 @@ export class GetComplianceDetailsByResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetComplianceSummaryByConfigRuleCommand.ts b/clients/client-config-service/commands/GetComplianceSummaryByConfigRuleCommand.ts index 9f034153fd6b7..07fbe0f7bc58a 100644 --- a/clients/client-config-service/commands/GetComplianceSummaryByConfigRuleCommand.ts +++ b/clients/client-config-service/commands/GetComplianceSummaryByConfigRuleCommand.ts @@ -20,6 +20,10 @@ import { export type GetComplianceSummaryByConfigRuleCommandInput = {}; export type GetComplianceSummaryByConfigRuleCommandOutput = GetComplianceSummaryByConfigRuleResponse & __MetadataBearer; +/** + *

Returns the number of AWS Config rules that are compliant and + * noncompliant, up to a maximum of 25 for each.

+ */ export class GetComplianceSummaryByConfigRuleCommand extends $Command< GetComplianceSummaryByConfigRuleCommandInput, GetComplianceSummaryByConfigRuleCommandOutput, @@ -34,6 +38,9 @@ export class GetComplianceSummaryByConfigRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetComplianceSummaryByResourceTypeCommand.ts b/clients/client-config-service/commands/GetComplianceSummaryByResourceTypeCommand.ts index 02c2a476f64b8..278e5c0aae1aa 100644 --- a/clients/client-config-service/commands/GetComplianceSummaryByResourceTypeCommand.ts +++ b/clients/client-config-service/commands/GetComplianceSummaryByResourceTypeCommand.ts @@ -24,6 +24,12 @@ export type GetComplianceSummaryByResourceTypeCommandInput = GetComplianceSummar export type GetComplianceSummaryByResourceTypeCommandOutput = GetComplianceSummaryByResourceTypeResponse & __MetadataBearer; +/** + *

Returns the number of resources that are compliant and the + * number that are noncompliant. You can specify one or more resource + * types to get these numbers for each resource type. The maximum + * number returned is 100.

+ */ export class GetComplianceSummaryByResourceTypeCommand extends $Command< GetComplianceSummaryByResourceTypeCommandInput, GetComplianceSummaryByResourceTypeCommandOutput, @@ -38,6 +44,9 @@ export class GetComplianceSummaryByResourceTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetConformancePackComplianceDetailsCommand.ts b/clients/client-config-service/commands/GetConformancePackComplianceDetailsCommand.ts index 9b3245863cd39..5a3ba3e7a9fa1 100644 --- a/clients/client-config-service/commands/GetConformancePackComplianceDetailsCommand.ts +++ b/clients/client-config-service/commands/GetConformancePackComplianceDetailsCommand.ts @@ -24,6 +24,9 @@ export type GetConformancePackComplianceDetailsCommandInput = GetConformancePack export type GetConformancePackComplianceDetailsCommandOutput = GetConformancePackComplianceDetailsResponse & __MetadataBearer; +/** + *

Returns compliance details of a conformance pack for all AWS resources that are monitered by conformance pack.

+ */ export class GetConformancePackComplianceDetailsCommand extends $Command< GetConformancePackComplianceDetailsCommandInput, GetConformancePackComplianceDetailsCommandOutput, @@ -38,6 +41,9 @@ export class GetConformancePackComplianceDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetConformancePackComplianceSummaryCommand.ts b/clients/client-config-service/commands/GetConformancePackComplianceSummaryCommand.ts index b3e1e710ad28b..61ce1f33e672b 100644 --- a/clients/client-config-service/commands/GetConformancePackComplianceSummaryCommand.ts +++ b/clients/client-config-service/commands/GetConformancePackComplianceSummaryCommand.ts @@ -24,6 +24,9 @@ export type GetConformancePackComplianceSummaryCommandInput = GetConformancePack export type GetConformancePackComplianceSummaryCommandOutput = GetConformancePackComplianceSummaryResponse & __MetadataBearer; +/** + *

Returns compliance details for the conformance pack based on the cumulative compliance results of all the rules in that conformance pack.

+ */ export class GetConformancePackComplianceSummaryCommand extends $Command< GetConformancePackComplianceSummaryCommandInput, GetConformancePackComplianceSummaryCommandOutput, @@ -38,6 +41,9 @@ export class GetConformancePackComplianceSummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetDiscoveredResourceCountsCommand.ts b/clients/client-config-service/commands/GetDiscoveredResourceCountsCommand.ts index 62c98ab30b793..a166a568c855d 100644 --- a/clients/client-config-service/commands/GetDiscoveredResourceCountsCommand.ts +++ b/clients/client-config-service/commands/GetDiscoveredResourceCountsCommand.ts @@ -20,6 +20,72 @@ import { export type GetDiscoveredResourceCountsCommandInput = GetDiscoveredResourceCountsRequest; export type GetDiscoveredResourceCountsCommandOutput = GetDiscoveredResourceCountsResponse & __MetadataBearer; +/** + *

Returns the resource types, the number of each resource type, + * and the total number of resources that AWS Config is recording in + * this region for your AWS account.

+ *

+ * Example + *

+ *
    + *
  1. + *

    AWS Config is recording three resource types in the US + * East (Ohio) Region for your account: 25 EC2 instances, 20 + * IAM users, and 15 S3 buckets.

    + *
  2. + *
  3. + *

    You make a call to the + * GetDiscoveredResourceCounts action and + * specify that you want all resource types.

    + *
  4. + *
  5. + *

    AWS Config returns the following:

    + * + *
      + *
    • + *

      The resource types (EC2 instances, IAM users, + * and S3 buckets).

      + *
    • + *
    • + *

      The number of each resource type (25, 20, and + * 15).

      + *
    • + *
    • + *

      The total number of all resources + * (60).

      + *
    • + *
    + * + *
  6. + *
+ * + *

The response is paginated. By default, AWS Config lists 100 + * ResourceCount objects on each page. You can + * customize this number with the limit parameter. The + * response includes a nextToken string. To get the next + * page of results, run the request again and specify the string for + * the nextToken parameter.

+ * + * + *

If you make a call to the GetDiscoveredResourceCounts action, you might + * not immediately receive resource counts in the following + * situations:

+ * + *
    + *
  • + *

    You are a new AWS Config customer.

    + *
  • + *
  • + *

    You just enabled resource recording.

    + *
  • + *
+ * + *

It might take a few minutes for AWS Config to record and + * count your resources. Wait a few minutes and then retry the + * GetDiscoveredResourceCounts action. + *

+ *
+ */ export class GetDiscoveredResourceCountsCommand extends $Command< GetDiscoveredResourceCountsCommandInput, GetDiscoveredResourceCountsCommandOutput, @@ -34,6 +100,9 @@ export class GetDiscoveredResourceCountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetOrganizationConfigRuleDetailedStatusCommand.ts b/clients/client-config-service/commands/GetOrganizationConfigRuleDetailedStatusCommand.ts index 5245b29ab26ca..b8c11daa0e05b 100644 --- a/clients/client-config-service/commands/GetOrganizationConfigRuleDetailedStatusCommand.ts +++ b/clients/client-config-service/commands/GetOrganizationConfigRuleDetailedStatusCommand.ts @@ -24,6 +24,12 @@ export type GetOrganizationConfigRuleDetailedStatusCommandInput = GetOrganizatio export type GetOrganizationConfigRuleDetailedStatusCommandOutput = GetOrganizationConfigRuleDetailedStatusResponse & __MetadataBearer; +/** + *

Returns detailed status for each member account within an organization for a given organization config rule.

+ *

Only a master account and a delegated administrator account can call this API. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ */ export class GetOrganizationConfigRuleDetailedStatusCommand extends $Command< GetOrganizationConfigRuleDetailedStatusCommandInput, GetOrganizationConfigRuleDetailedStatusCommandOutput, @@ -38,6 +44,9 @@ export class GetOrganizationConfigRuleDetailedStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetOrganizationConformancePackDetailedStatusCommand.ts b/clients/client-config-service/commands/GetOrganizationConformancePackDetailedStatusCommand.ts index 24f8477863d40..105e3b1a14109 100644 --- a/clients/client-config-service/commands/GetOrganizationConformancePackDetailedStatusCommand.ts +++ b/clients/client-config-service/commands/GetOrganizationConformancePackDetailedStatusCommand.ts @@ -24,6 +24,12 @@ export type GetOrganizationConformancePackDetailedStatusCommandInput = GetOrgani export type GetOrganizationConformancePackDetailedStatusCommandOutput = GetOrganizationConformancePackDetailedStatusResponse & __MetadataBearer; +/** + *

Returns detailed status for each member account within an organization for a given organization conformance pack.

+ *

Only a master account and a delegated administrator account can call this API. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ */ export class GetOrganizationConformancePackDetailedStatusCommand extends $Command< GetOrganizationConformancePackDetailedStatusCommandInput, GetOrganizationConformancePackDetailedStatusCommandOutput, @@ -38,6 +44,9 @@ export class GetOrganizationConformancePackDetailedStatusCommand extends $Comman // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/GetResourceConfigHistoryCommand.ts b/clients/client-config-service/commands/GetResourceConfigHistoryCommand.ts index 5b2871e1c5726..6b0264b8f3a3c 100644 --- a/clients/client-config-service/commands/GetResourceConfigHistoryCommand.ts +++ b/clients/client-config-service/commands/GetResourceConfigHistoryCommand.ts @@ -20,6 +20,28 @@ import { export type GetResourceConfigHistoryCommandInput = GetResourceConfigHistoryRequest; export type GetResourceConfigHistoryCommandOutput = GetResourceConfigHistoryResponse & __MetadataBearer; +/** + *

Returns a list of configuration items for the specified + * resource. The list contains details about each state of the resource + * during the specified time interval. If you specified a retention + * period to retain your ConfigurationItems between a + * minimum of 30 days and a maximum of 7 years (2557 days), AWS Config + * returns the ConfigurationItems for the specified + * retention period.

+ *

The response is paginated. By default, AWS Config returns a + * limit of 10 configuration items per page. You can customize this + * number with the limit parameter. The response includes + * a nextToken string. To get the next page of results, + * run the request again and specify the string for the + * nextToken parameter.

+ * + *

Each call to the API is limited to span a duration of seven + * days. It is likely that the number of records returned is + * smaller than the specified limit. In such cases, + * you can make another call, using the + * nextToken.

+ *
+ */ export class GetResourceConfigHistoryCommand extends $Command< GetResourceConfigHistoryCommandInput, GetResourceConfigHistoryCommandOutput, @@ -34,6 +56,9 @@ export class GetResourceConfigHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/ListAggregateDiscoveredResourcesCommand.ts b/clients/client-config-service/commands/ListAggregateDiscoveredResourcesCommand.ts index ffaf52762cd12..66edfd08edc35 100644 --- a/clients/client-config-service/commands/ListAggregateDiscoveredResourcesCommand.ts +++ b/clients/client-config-service/commands/ListAggregateDiscoveredResourcesCommand.ts @@ -20,6 +20,12 @@ import { export type ListAggregateDiscoveredResourcesCommandInput = ListAggregateDiscoveredResourcesRequest; export type ListAggregateDiscoveredResourcesCommandOutput = ListAggregateDiscoveredResourcesResponse & __MetadataBearer; +/** + *

Accepts a resource type and returns a list of resource identifiers that are aggregated for a specific resource type across accounts and regions. + * A resource identifier includes the resource type, ID, (if available) the custom resource name, source account, and source region. + * You can narrow the results to include only resources that have specific resource IDs, or a resource name, or source account ID, or source region.

+ *

For example, if the input consists of accountID 12345678910 and the region is us-east-1 for resource type AWS::EC2::Instance then the API returns all the EC2 instance identifiers of accountID 12345678910 and region us-east-1.

+ */ export class ListAggregateDiscoveredResourcesCommand extends $Command< ListAggregateDiscoveredResourcesCommandInput, ListAggregateDiscoveredResourcesCommandOutput, @@ -34,6 +40,9 @@ export class ListAggregateDiscoveredResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/ListDiscoveredResourcesCommand.ts b/clients/client-config-service/commands/ListDiscoveredResourcesCommand.ts index 4afb078c60a51..e02c74c3fba18 100644 --- a/clients/client-config-service/commands/ListDiscoveredResourcesCommand.ts +++ b/clients/client-config-service/commands/ListDiscoveredResourcesCommand.ts @@ -20,6 +20,25 @@ import { export type ListDiscoveredResourcesCommandInput = ListDiscoveredResourcesRequest; export type ListDiscoveredResourcesCommandOutput = ListDiscoveredResourcesResponse & __MetadataBearer; +/** + *

Accepts a resource type and returns a list of resource + * identifiers for the resources of that type. A resource identifier + * includes the resource type, ID, and (if available) the custom + * resource name. The results consist of resources that AWS Config has + * discovered, including those that AWS Config is not currently + * recording. You can narrow the results to include only resources that + * have specific resource IDs or a resource name.

+ * + *

You can specify either resource IDs or a resource name, but + * not both, in the same request.

+ *
+ *

The response is paginated. By default, AWS Config lists 100 + * resource identifiers on each page. You can customize this number + * with the limit parameter. The response includes a + * nextToken string. To get the next page of results, + * run the request again and specify the string for the + * nextToken parameter.

+ */ export class ListDiscoveredResourcesCommand extends $Command< ListDiscoveredResourcesCommandInput, ListDiscoveredResourcesCommandOutput, @@ -34,6 +53,9 @@ export class ListDiscoveredResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/ListTagsForResourceCommand.ts b/clients/client-config-service/commands/ListTagsForResourceCommand.ts index 39495809f5493..796bdb6ec2523 100644 --- a/clients/client-config-service/commands/ListTagsForResourceCommand.ts +++ b/clients/client-config-service/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

List the tags for AWS Config resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutAggregationAuthorizationCommand.ts b/clients/client-config-service/commands/PutAggregationAuthorizationCommand.ts index 021b97edd409f..4b61f14e6378e 100644 --- a/clients/client-config-service/commands/PutAggregationAuthorizationCommand.ts +++ b/clients/client-config-service/commands/PutAggregationAuthorizationCommand.ts @@ -20,6 +20,10 @@ import { export type PutAggregationAuthorizationCommandInput = PutAggregationAuthorizationRequest; export type PutAggregationAuthorizationCommandOutput = PutAggregationAuthorizationResponse & __MetadataBearer; +/** + *

Authorizes the aggregator account and region to collect data + * from the source account and region.

+ */ export class PutAggregationAuthorizationCommand extends $Command< PutAggregationAuthorizationCommandInput, PutAggregationAuthorizationCommandOutput, @@ -34,6 +38,9 @@ export class PutAggregationAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutConfigRuleCommand.ts b/clients/client-config-service/commands/PutConfigRuleCommand.ts index e379cfd1f57a3..a39657918eb37 100644 --- a/clients/client-config-service/commands/PutConfigRuleCommand.ts +++ b/clients/client-config-service/commands/PutConfigRuleCommand.ts @@ -20,6 +20,44 @@ import { export type PutConfigRuleCommandInput = PutConfigRuleRequest; export type PutConfigRuleCommandOutput = __MetadataBearer; +/** + *

Adds or updates an AWS Config rule for evaluating whether your + * AWS resources comply with your desired configurations.

+ *

You can use this action for custom AWS Config rules and AWS + * managed Config rules. A custom AWS Config rule is a rule that you + * develop and maintain. An AWS managed Config rule is a customizable, + * predefined rule that AWS Config provides.

+ *

If you are adding a new custom AWS Config rule, you must first + * create the AWS Lambda function that the rule invokes to evaluate + * your resources. When you use the PutConfigRule action + * to add the rule to AWS Config, you must specify the Amazon Resource + * Name (ARN) that AWS Lambda assigns to the function. Specify the ARN + * for the SourceIdentifier key. This key is part of the + * Source object, which is part of the + * ConfigRule object.

+ *

If you are adding an AWS managed Config rule, specify the + * rule's identifier for the SourceIdentifier key. To + * reference AWS managed Config rule identifiers, see About AWS Managed Config Rules.

+ *

For any new rule that you add, specify the + * ConfigRuleName in the ConfigRule + * object. Do not specify the ConfigRuleArn or the + * ConfigRuleId. These values are generated by AWS + * Config for new rules.

+ *

If you are updating a rule that you added previously, you can + * specify the rule by ConfigRuleName, + * ConfigRuleId, or ConfigRuleArn in the + * ConfigRule data type that you use in this + * request.

+ *

The maximum number of rules that AWS Config supports is 150.

+ * + *

For information about requesting a rule limit increase, see + * AWS Config Limits in the AWS General + * Reference Guide.

+ * + *

For more information about developing and using AWS Config + * rules, see Evaluating AWS Resource Configurations with AWS Config + * in the AWS Config Developer Guide.

+ */ export class PutConfigRuleCommand extends $Command< PutConfigRuleCommandInput, PutConfigRuleCommandOutput, @@ -34,6 +72,9 @@ export class PutConfigRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutConfigurationAggregatorCommand.ts b/clients/client-config-service/commands/PutConfigurationAggregatorCommand.ts index 60f1df49f2d89..b756925cd55f9 100644 --- a/clients/client-config-service/commands/PutConfigurationAggregatorCommand.ts +++ b/clients/client-config-service/commands/PutConfigurationAggregatorCommand.ts @@ -20,6 +20,20 @@ import { export type PutConfigurationAggregatorCommandInput = PutConfigurationAggregatorRequest; export type PutConfigurationAggregatorCommandOutput = PutConfigurationAggregatorResponse & __MetadataBearer; +/** + *

Creates and updates the configuration aggregator with the + * selected source accounts and regions. The source account can be + * individual account(s) or an organization.

+ * + *

AWS Config should be enabled in source accounts and regions + * you want to aggregate.

+ *

If your source type is an organization, you must be signed + * in to the master account and all features must be enabled in + * your organization. AWS Config calls + * EnableAwsServiceAccess API to enable + * integration between AWS Config and AWS Organizations.

+ *
+ */ export class PutConfigurationAggregatorCommand extends $Command< PutConfigurationAggregatorCommandInput, PutConfigurationAggregatorCommandOutput, @@ -34,6 +48,9 @@ export class PutConfigurationAggregatorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutConfigurationRecorderCommand.ts b/clients/client-config-service/commands/PutConfigurationRecorderCommand.ts index 9b9eacc0b3b8d..360027e0ac52f 100644 --- a/clients/client-config-service/commands/PutConfigurationRecorderCommand.ts +++ b/clients/client-config-service/commands/PutConfigurationRecorderCommand.ts @@ -20,6 +20,22 @@ import { export type PutConfigurationRecorderCommandInput = PutConfigurationRecorderRequest; export type PutConfigurationRecorderCommandOutput = __MetadataBearer; +/** + *

Creates a new configuration recorder to record the selected + * resource configurations.

+ *

You can use this action to change the role roleARN + * or the recordingGroup of an existing recorder. To + * change the role, call the action on the existing configuration + * recorder and specify a role.

+ * + *

Currently, you can specify only one configuration recorder + * per region in your account.

+ *

If ConfigurationRecorder does not have the + * recordingGroup parameter + * specified, the default is to record all supported resource + * types.

+ *
+ */ export class PutConfigurationRecorderCommand extends $Command< PutConfigurationRecorderCommandInput, PutConfigurationRecorderCommandOutput, @@ -34,6 +50,9 @@ export class PutConfigurationRecorderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutConformancePackCommand.ts b/clients/client-config-service/commands/PutConformancePackCommand.ts index 7b278be2da6ce..4b56aa44ed64d 100644 --- a/clients/client-config-service/commands/PutConformancePackCommand.ts +++ b/clients/client-config-service/commands/PutConformancePackCommand.ts @@ -20,6 +20,15 @@ import { export type PutConformancePackCommandInput = PutConformancePackRequest; export type PutConformancePackCommandOutput = PutConformancePackResponse & __MetadataBearer; +/** + *

Creates or updates a conformance pack. A conformance pack is a collection of AWS Config rules that can be easily deployed in an account and a region and across AWS Organization.

+ *

This API creates a service linked role AWSServiceRoleForConfigConforms in your account. + * The service linked role is created only when the role does not exist in your account.

+ * + *

You must specify either the TemplateS3Uri or the TemplateBody parameter, but not both. + * If you provide both AWS Config uses the TemplateS3Uri parameter and ignores the TemplateBody parameter.

+ *
+ */ export class PutConformancePackCommand extends $Command< PutConformancePackCommandInput, PutConformancePackCommandOutput, @@ -34,6 +43,9 @@ export class PutConformancePackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutDeliveryChannelCommand.ts b/clients/client-config-service/commands/PutDeliveryChannelCommand.ts index ca9e27dbeca92..d7a70aa6c6d1a 100644 --- a/clients/client-config-service/commands/PutDeliveryChannelCommand.ts +++ b/clients/client-config-service/commands/PutDeliveryChannelCommand.ts @@ -20,6 +20,25 @@ import { export type PutDeliveryChannelCommandInput = PutDeliveryChannelRequest; export type PutDeliveryChannelCommandOutput = __MetadataBearer; +/** + *

Creates a delivery channel object to deliver configuration + * information to an Amazon S3 bucket and Amazon SNS topic.

+ *

Before you can create a delivery channel, you must create a + * configuration recorder.

+ *

You can use this action to change the Amazon S3 bucket or an + * Amazon SNS topic of the existing delivery channel. To change the + * Amazon S3 bucket or an Amazon SNS topic, call this action and + * specify the changed values for the S3 bucket and the SNS topic. If + * you specify a different value for either the S3 bucket or the SNS + * topic, this action will keep the existing value for the parameter + * that is not changed.

+ * + *

You can have only one delivery channel per region in your + * account.

+ * + * + *
+ */ export class PutDeliveryChannelCommand extends $Command< PutDeliveryChannelCommandInput, PutDeliveryChannelCommandOutput, @@ -34,6 +53,9 @@ export class PutDeliveryChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutEvaluationsCommand.ts b/clients/client-config-service/commands/PutEvaluationsCommand.ts index 9a877c3a8a73e..cb6533c78bd1d 100644 --- a/clients/client-config-service/commands/PutEvaluationsCommand.ts +++ b/clients/client-config-service/commands/PutEvaluationsCommand.ts @@ -20,6 +20,11 @@ import { export type PutEvaluationsCommandInput = PutEvaluationsRequest; export type PutEvaluationsCommandOutput = PutEvaluationsResponse & __MetadataBearer; +/** + *

Used by an AWS Lambda function to deliver evaluation results to + * AWS Config. This action is required in every AWS Lambda function + * that is invoked by an AWS Config rule.

+ */ export class PutEvaluationsCommand extends $Command< PutEvaluationsCommandInput, PutEvaluationsCommandOutput, @@ -34,6 +39,9 @@ export class PutEvaluationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutOrganizationConfigRuleCommand.ts b/clients/client-config-service/commands/PutOrganizationConfigRuleCommand.ts index 2685fadb0228d..2960d4110bad1 100644 --- a/clients/client-config-service/commands/PutOrganizationConfigRuleCommand.ts +++ b/clients/client-config-service/commands/PutOrganizationConfigRuleCommand.ts @@ -20,6 +20,30 @@ import { export type PutOrganizationConfigRuleCommandInput = PutOrganizationConfigRuleRequest; export type PutOrganizationConfigRuleCommandOutput = PutOrganizationConfigRuleResponse & __MetadataBearer; +/** + *

Adds or updates organization config rule for your entire organization evaluating whether your AWS resources comply with your + * desired configurations.

+ *

Only a master account and a delegated administrator can create or update an organization config rule. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ *

This API enables organization service access through the EnableAWSServiceAccess action and creates a service linked + * role AWSServiceRoleForConfigMultiAccountSetup in the master or delegated administrator account of your organization. + * The service linked role is created only when the role does not exist in the caller account. + * AWS Config verifies the existence of role with GetRole action.

+ *

To use this API with delegated administrator, register a delegated administrator by calling AWS Organization + * register-delegated-administrator for config-multiaccountsetup.amazonaws.com.

+ *

You can use this action to create both custom AWS Config rules and AWS managed Config rules. + * If you are adding a new custom AWS Config rule, you must first create AWS Lambda function in the master account or a delegated + * administrator that the rule invokes to evaluate your resources. + * When you use the PutOrganizationConfigRule action to add the rule to AWS Config, you must + * specify the Amazon Resource Name (ARN) that AWS Lambda assigns to the function. + * If you are adding an AWS managed Config rule, specify the rule's identifier for the RuleIdentifier key.

+ *

The maximum number of organization config rules that AWS Config supports is 150 and 3 delegated administrator per organization.

+ * + *

Prerequisite: Ensure you call EnableAllFeatures API to enable all features in an organization.

+ *

Specify either OrganizationCustomRuleMetadata or OrganizationManagedRuleMetadata.

+ *
+ */ export class PutOrganizationConfigRuleCommand extends $Command< PutOrganizationConfigRuleCommandInput, PutOrganizationConfigRuleCommandOutput, @@ -34,6 +58,9 @@ export class PutOrganizationConfigRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutOrganizationConformancePackCommand.ts b/clients/client-config-service/commands/PutOrganizationConformancePackCommand.ts index 2b400f06854a3..65881a0bc0c56 100644 --- a/clients/client-config-service/commands/PutOrganizationConformancePackCommand.ts +++ b/clients/client-config-service/commands/PutOrganizationConformancePackCommand.ts @@ -20,6 +20,29 @@ import { export type PutOrganizationConformancePackCommandInput = PutOrganizationConformancePackRequest; export type PutOrganizationConformancePackCommandOutput = PutOrganizationConformancePackResponse & __MetadataBearer; +/** + *

Deploys conformance packs across member accounts in an AWS Organization.

+ *

Only a master account and a delegated administrator can call this API. + * When calling this API with a delegated administrator, you must ensure AWS Organizations + * ListDelegatedAdministrator permissions are added.

+ *

This API enables organization service access for config-multiaccountsetup.amazonaws.com + * through the EnableAWSServiceAccess action and creates a + * service linked role AWSServiceRoleForConfigMultiAccountSetup in the master or delegated administrator account of your organization. + * The service linked role is created only when the role does not exist in the caller account. + * To use this API with delegated administrator, register a delegated administrator by calling AWS Organization + * register-delegate-admin for config-multiaccountsetup.amazonaws.com.

+ * + * + * + * + *

Prerequisite: Ensure you call EnableAllFeatures API to enable all features in an organization.

+ *

You must specify either the TemplateS3Uri or the TemplateBody parameter, but not both. + * If you provide both AWS Config uses the TemplateS3Uri parameter and ignores the TemplateBody parameter.

+ *

AWS Config sets the state of a conformance pack to CREATE_IN_PROGRESS and UPDATE_IN_PROGRESS until the conformance pack is created or updated. + * You cannot update a conformance pack while it is in this state.

+ *

You can create 6 conformance packs with 25 AWS Config rules in each pack and 3 delegated administrator per organization.

+ *
+ */ export class PutOrganizationConformancePackCommand extends $Command< PutOrganizationConformancePackCommandInput, PutOrganizationConformancePackCommandOutput, @@ -34,6 +57,9 @@ export class PutOrganizationConformancePackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutRemediationConfigurationsCommand.ts b/clients/client-config-service/commands/PutRemediationConfigurationsCommand.ts index 89cf5b841fcba..9cacfaad8794d 100644 --- a/clients/client-config-service/commands/PutRemediationConfigurationsCommand.ts +++ b/clients/client-config-service/commands/PutRemediationConfigurationsCommand.ts @@ -20,6 +20,17 @@ import { export type PutRemediationConfigurationsCommandInput = PutRemediationConfigurationsRequest; export type PutRemediationConfigurationsCommandOutput = PutRemediationConfigurationsResponse & __MetadataBearer; +/** + *

Adds or updates the remediation configuration with a specific AWS Config rule with the + * selected target or action. + * The API creates the RemediationConfiguration object for the AWS Config rule. + * The AWS Config rule must already exist for you to add a remediation configuration. + * The target (SSM document) must exist and have permissions to use the target.

+ * + *

If you make backward incompatible changes to the SSM document, + * you must call this again to ensure the remediations can run.

+ *
+ */ export class PutRemediationConfigurationsCommand extends $Command< PutRemediationConfigurationsCommandInput, PutRemediationConfigurationsCommandOutput, @@ -34,6 +45,9 @@ export class PutRemediationConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutRemediationExceptionsCommand.ts b/clients/client-config-service/commands/PutRemediationExceptionsCommand.ts index 5a07025ee0602..47bdc5c1809e0 100644 --- a/clients/client-config-service/commands/PutRemediationExceptionsCommand.ts +++ b/clients/client-config-service/commands/PutRemediationExceptionsCommand.ts @@ -20,6 +20,14 @@ import { export type PutRemediationExceptionsCommandInput = PutRemediationExceptionsRequest; export type PutRemediationExceptionsCommandOutput = PutRemediationExceptionsResponse & __MetadataBearer; +/** + *

A remediation exception is when a specific resource is no longer considered for auto-remediation. + * This API adds a new exception or updates an exisiting exception for a specific resource with a specific AWS Config rule.

+ * + *

AWS Config generates a remediation exception when a problem occurs executing a remediation action to a specific resource. + * Remediation exceptions blocks auto-remediation until the exception is cleared.

+ *
+ */ export class PutRemediationExceptionsCommand extends $Command< PutRemediationExceptionsCommandInput, PutRemediationExceptionsCommandOutput, @@ -34,6 +42,9 @@ export class PutRemediationExceptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutResourceConfigCommand.ts b/clients/client-config-service/commands/PutResourceConfigCommand.ts index 312fac4b8c42f..911289f2be670 100644 --- a/clients/client-config-service/commands/PutResourceConfigCommand.ts +++ b/clients/client-config-service/commands/PutResourceConfigCommand.ts @@ -20,6 +20,18 @@ import { export type PutResourceConfigCommandInput = PutResourceConfigRequest; export type PutResourceConfigCommandOutput = __MetadataBearer; +/** + *

Records the configuration state for the resource provided in the request. + * + * The configuration state of a resource is represented in AWS Config as Configuration Items. + * Once this API records the configuration item, you can retrieve the list of configuration items for the custom resource type using existing AWS Config APIs.

+ * + *

The custom resource type must be registered with AWS CloudFormation. This API accepts the configuration item registered with AWS CloudFormation.

+ *

When you call this API, AWS Config only stores configuration state of the resource provided in the request. This API does not change or remediate the configuration of the resource. + *

+ *

Write-only schema properites are not recorded as part of the published configuration item.

+ *
+ */ export class PutResourceConfigCommand extends $Command< PutResourceConfigCommandInput, PutResourceConfigCommandOutput, @@ -34,6 +46,9 @@ export class PutResourceConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/PutRetentionConfigurationCommand.ts b/clients/client-config-service/commands/PutRetentionConfigurationCommand.ts index dcbccaf8bcfcc..0775e0af56d5f 100644 --- a/clients/client-config-service/commands/PutRetentionConfigurationCommand.ts +++ b/clients/client-config-service/commands/PutRetentionConfigurationCommand.ts @@ -20,6 +20,19 @@ import { export type PutRetentionConfigurationCommandInput = PutRetentionConfigurationRequest; export type PutRetentionConfigurationCommandOutput = PutRetentionConfigurationResponse & __MetadataBearer; +/** + *

Creates and updates the retention configuration with details + * about retention period (number of days) that AWS Config stores your + * historical information. The API creates the + * RetentionConfiguration object and names the object + * as default. When you have a + * RetentionConfiguration object named default, calling the API modifies the + * default object.

+ * + *

Currently, AWS Config supports only one retention + * configuration per region in your account.

+ *
+ */ export class PutRetentionConfigurationCommand extends $Command< PutRetentionConfigurationCommandInput, PutRetentionConfigurationCommandOutput, @@ -34,6 +47,9 @@ export class PutRetentionConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/SelectAggregateResourceConfigCommand.ts b/clients/client-config-service/commands/SelectAggregateResourceConfigCommand.ts index a776f12350adb..7a4f3d774c335 100644 --- a/clients/client-config-service/commands/SelectAggregateResourceConfigCommand.ts +++ b/clients/client-config-service/commands/SelectAggregateResourceConfigCommand.ts @@ -20,6 +20,14 @@ import { export type SelectAggregateResourceConfigCommandInput = SelectAggregateResourceConfigRequest; export type SelectAggregateResourceConfigCommandOutput = SelectAggregateResourceConfigResponse & __MetadataBearer; +/** + *

Accepts a structured query language (SQL) SELECT command and an aggregator to query configuration state of AWS resources across multiple accounts and regions, + * performs the corresponding search, and returns resource configurations matching the properties.

+ *

For more information about query components, see the + * + * Query Components + * section in the AWS Config Developer Guide.

+ */ export class SelectAggregateResourceConfigCommand extends $Command< SelectAggregateResourceConfigCommandInput, SelectAggregateResourceConfigCommandOutput, @@ -34,6 +42,9 @@ export class SelectAggregateResourceConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/SelectResourceConfigCommand.ts b/clients/client-config-service/commands/SelectResourceConfigCommand.ts index 732fc4ca30716..436987ff089e2 100644 --- a/clients/client-config-service/commands/SelectResourceConfigCommand.ts +++ b/clients/client-config-service/commands/SelectResourceConfigCommand.ts @@ -20,6 +20,13 @@ import { export type SelectResourceConfigCommandInput = SelectResourceConfigRequest; export type SelectResourceConfigCommandOutput = SelectResourceConfigResponse & __MetadataBearer; +/** + *

Accepts a structured query language (SQL) SELECT command, performs the corresponding search, and returns resource configurations matching the properties.

+ *

For more information about query components, see the + * + * Query Components + * section in the AWS Config Developer Guide.

+ */ export class SelectResourceConfigCommand extends $Command< SelectResourceConfigCommandInput, SelectResourceConfigCommandOutput, @@ -34,6 +41,9 @@ export class SelectResourceConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/StartConfigRulesEvaluationCommand.ts b/clients/client-config-service/commands/StartConfigRulesEvaluationCommand.ts index 79507e94e4ce0..1b3b21589e413 100644 --- a/clients/client-config-service/commands/StartConfigRulesEvaluationCommand.ts +++ b/clients/client-config-service/commands/StartConfigRulesEvaluationCommand.ts @@ -20,6 +20,56 @@ import { export type StartConfigRulesEvaluationCommandInput = StartConfigRulesEvaluationRequest; export type StartConfigRulesEvaluationCommandOutput = StartConfigRulesEvaluationResponse & __MetadataBearer; +/** + *

Runs an on-demand evaluation for the specified AWS Config rules + * against the last known configuration state of the resources. Use + * StartConfigRulesEvaluation when you want to test + * that a rule you updated is working as expected. + * StartConfigRulesEvaluation does not re-record the + * latest configuration state for your resources. It re-runs an + * evaluation against the last known state of your resources.

+ *

You can specify up to 25 AWS Config rules per request.

+ * + * + *

An existing StartConfigRulesEvaluation call for + * the specified rules must complete before you can call the API again. + * If you chose to have AWS Config stream to an Amazon SNS topic, you + * will receive a ConfigRuleEvaluationStarted notification + * when the evaluation starts.

+ * + *

You don't need to call the + * StartConfigRulesEvaluation API to run an + * evaluation for a new rule. When you create a rule, AWS Config + * evaluates your resources against the rule automatically. + *

+ *
+ *

The StartConfigRulesEvaluation API is useful if + * you want to run on-demand evaluations, such as the following + * example:

+ *
    + *
  1. + *

    You have a custom rule that evaluates your IAM + * resources every 24 hours.

    + *
  2. + *
  3. + *

    You update your Lambda function to add additional + * conditions to your rule.

    + *
  4. + *
  5. + *

    Instead of waiting for the next periodic evaluation, + * you call the StartConfigRulesEvaluation + * API.

    + *
  6. + *
  7. + *

    AWS Config invokes your Lambda function and evaluates + * your IAM resources.

    + *
  8. + *
  9. + *

    Your custom rule will still run periodic evaluations + * every 24 hours.

    + *
  10. + *
+ */ export class StartConfigRulesEvaluationCommand extends $Command< StartConfigRulesEvaluationCommandInput, StartConfigRulesEvaluationCommandOutput, @@ -34,6 +84,9 @@ export class StartConfigRulesEvaluationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/StartConfigurationRecorderCommand.ts b/clients/client-config-service/commands/StartConfigurationRecorderCommand.ts index 8df8073eaea6a..11f7ff28e7b6b 100644 --- a/clients/client-config-service/commands/StartConfigurationRecorderCommand.ts +++ b/clients/client-config-service/commands/StartConfigurationRecorderCommand.ts @@ -20,6 +20,12 @@ import { export type StartConfigurationRecorderCommandInput = StartConfigurationRecorderRequest; export type StartConfigurationRecorderCommandOutput = __MetadataBearer; +/** + *

Starts recording configurations of the AWS resources you have + * selected to record in your AWS account.

+ *

You must have created at least one delivery channel to + * successfully start the configuration recorder.

+ */ export class StartConfigurationRecorderCommand extends $Command< StartConfigurationRecorderCommandInput, StartConfigurationRecorderCommandOutput, @@ -34,6 +40,9 @@ export class StartConfigurationRecorderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/StartRemediationExecutionCommand.ts b/clients/client-config-service/commands/StartRemediationExecutionCommand.ts index 1f771d48d48c3..d3b2efcc9c0b6 100644 --- a/clients/client-config-service/commands/StartRemediationExecutionCommand.ts +++ b/clients/client-config-service/commands/StartRemediationExecutionCommand.ts @@ -20,6 +20,10 @@ import { export type StartRemediationExecutionCommandInput = StartRemediationExecutionRequest; export type StartRemediationExecutionCommandOutput = StartRemediationExecutionResponse & __MetadataBearer; +/** + *

Runs an on-demand remediation for the specified AWS Config rules against the last known remediation configuration. It runs an execution against the current state of your resources. Remediation execution is asynchronous.

+ *

You can specify up to 100 resource keys per request. An existing StartRemediationExecution call for the specified resource keys must complete before you can call the API again.

+ */ export class StartRemediationExecutionCommand extends $Command< StartRemediationExecutionCommandInput, StartRemediationExecutionCommandOutput, @@ -34,6 +38,9 @@ export class StartRemediationExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/StopConfigurationRecorderCommand.ts b/clients/client-config-service/commands/StopConfigurationRecorderCommand.ts index 97e0e39c9ef2d..b43f267de3229 100644 --- a/clients/client-config-service/commands/StopConfigurationRecorderCommand.ts +++ b/clients/client-config-service/commands/StopConfigurationRecorderCommand.ts @@ -20,6 +20,9 @@ import { export type StopConfigurationRecorderCommandInput = StopConfigurationRecorderRequest; export type StopConfigurationRecorderCommandOutput = __MetadataBearer; +/** + *

Stops recording configurations of the AWS resources you have selected to record in your AWS account.

+ */ export class StopConfigurationRecorderCommand extends $Command< StopConfigurationRecorderCommandInput, StopConfigurationRecorderCommandOutput, @@ -34,6 +37,9 @@ export class StopConfigurationRecorderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/TagResourceCommand.ts b/clients/client-config-service/commands/TagResourceCommand.ts index dc83ae66a46b7..7f810ca9a0fe7 100644 --- a/clients/client-config-service/commands/TagResourceCommand.ts +++ b/clients/client-config-service/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource are not specified in the request parameters, they are not changed. + * When a resource is deleted, the tags associated with that resource are deleted as well.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/commands/UntagResourceCommand.ts b/clients/client-config-service/commands/UntagResourceCommand.ts index 947094c81b5be..d065e50e1fbdc 100644 --- a/clients/client-config-service/commands/UntagResourceCommand.ts +++ b/clients/client-config-service/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Deletes specified tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConfigServiceClientResolvedConfig, diff --git a/clients/client-config-service/package.json b/clients/client-config-service/package.json index 2a43e685579f5..85b2f5d485ecb 100644 --- a/clients/client-config-service/package.json +++ b/clients/client-config-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Config Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-config-service/pagination/DescribeRemediationExceptionsPaginator.ts b/clients/client-config-service/pagination/DescribeRemediationExceptionsPaginator.ts index f8e2b494fe379..dba065a2c3ff1 100644 --- a/clients/client-config-service/pagination/DescribeRemediationExceptionsPaginator.ts +++ b/clients/client-config-service/pagination/DescribeRemediationExceptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ConfigServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConfigServiceClient, input: DescribeRemediationExceptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeRemediationExceptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ConfigService, input: DescribeRemediationExceptionsCommandInput, diff --git a/clients/client-config-service/pagination/DescribeRemediationExecutionStatusPaginator.ts b/clients/client-config-service/pagination/DescribeRemediationExecutionStatusPaginator.ts index 3f7a1faf93916..1bcc9440a3383 100644 --- a/clients/client-config-service/pagination/DescribeRemediationExecutionStatusPaginator.ts +++ b/clients/client-config-service/pagination/DescribeRemediationExecutionStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { ConfigServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConfigServiceClient, input: DescribeRemediationExecutionStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeRemediationExecutionStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ConfigService, input: DescribeRemediationExecutionStatusCommandInput, diff --git a/clients/client-config-service/pagination/GetResourceConfigHistoryPaginator.ts b/clients/client-config-service/pagination/GetResourceConfigHistoryPaginator.ts index 0a4a4774d0736..453f33c953126 100644 --- a/clients/client-config-service/pagination/GetResourceConfigHistoryPaginator.ts +++ b/clients/client-config-service/pagination/GetResourceConfigHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { ConfigServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConfigServiceClient, input: GetResourceConfigHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetResourceConfigHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ConfigService, input: GetResourceConfigHistoryCommandInput, diff --git a/clients/client-config-service/pagination/SelectAggregateResourceConfigPaginator.ts b/clients/client-config-service/pagination/SelectAggregateResourceConfigPaginator.ts index 6a4c2753e68db..4943f36b9d43e 100644 --- a/clients/client-config-service/pagination/SelectAggregateResourceConfigPaginator.ts +++ b/clients/client-config-service/pagination/SelectAggregateResourceConfigPaginator.ts @@ -8,6 +8,9 @@ import { import { ConfigServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConfigServiceClient, input: SelectAggregateResourceConfigCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SelectAggregateResourceConfigCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ConfigService, input: SelectAggregateResourceConfigCommandInput, diff --git a/clients/client-config-service/runtimeConfig.browser.ts b/clients/client-config-service/runtimeConfig.browser.ts index 2c0f371b6a18b..92f0db701edb4 100644 --- a/clients/client-config-service/runtimeConfig.browser.ts +++ b/clients/client-config-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ConfigServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-config-service/runtimeConfig.native.ts b/clients/client-config-service/runtimeConfig.native.ts index c81f365764a16..865c56277d199 100644 --- a/clients/client-config-service/runtimeConfig.native.ts +++ b/clients/client-config-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ConfigServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-config-service/runtimeConfig.shared.ts b/clients/client-config-service/runtimeConfig.shared.ts index 118d7a222e71d..a4214b2884dc0 100644 --- a/clients/client-config-service/runtimeConfig.shared.ts +++ b/clients/client-config-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-11-12", disableHostPrefix: false, diff --git a/clients/client-config-service/runtimeConfig.ts b/clients/client-config-service/runtimeConfig.ts index 8cd1c354e437d..fc47ea0d7f867 100644 --- a/clients/client-config-service/runtimeConfig.ts +++ b/clients/client-config-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ConfigServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-config-service/tsconfig.json b/clients/client-config-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-config-service/tsconfig.json +++ b/clients/client-config-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-connect/commands/AssociateRoutingProfileQueuesCommand.ts b/clients/client-connect/commands/AssociateRoutingProfileQueuesCommand.ts index c9d7f7eb4ce4e..1a3b7cb6cd8c3 100644 --- a/clients/client-connect/commands/AssociateRoutingProfileQueuesCommand.ts +++ b/clients/client-connect/commands/AssociateRoutingProfileQueuesCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateRoutingProfileQueuesCommandInput = AssociateRoutingProfileQueuesRequest; export type AssociateRoutingProfileQueuesCommandOutput = __MetadataBearer; +/** + *

Associates a set of queues with a routing profile.

+ */ export class AssociateRoutingProfileQueuesCommand extends $Command< AssociateRoutingProfileQueuesCommandInput, AssociateRoutingProfileQueuesCommandOutput, @@ -34,6 +37,9 @@ export class AssociateRoutingProfileQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/CreateContactFlowCommand.ts b/clients/client-connect/commands/CreateContactFlowCommand.ts index 655012327fc3f..637e5f6aa5afe 100644 --- a/clients/client-connect/commands/CreateContactFlowCommand.ts +++ b/clients/client-connect/commands/CreateContactFlowCommand.ts @@ -20,6 +20,11 @@ import { export type CreateContactFlowCommandInput = CreateContactFlowRequest; export type CreateContactFlowCommandOutput = CreateContactFlowResponse & __MetadataBearer; +/** + *

Creates a contact flow for the specified Amazon Connect instance.

+ *

You can also create and update contact flows using the Amazon Connect + * Flow language.

+ */ export class CreateContactFlowCommand extends $Command< CreateContactFlowCommandInput, CreateContactFlowCommandOutput, @@ -34,6 +39,9 @@ export class CreateContactFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/CreateRoutingProfileCommand.ts b/clients/client-connect/commands/CreateRoutingProfileCommand.ts index 7b365703291c3..efafcfb57d359 100644 --- a/clients/client-connect/commands/CreateRoutingProfileCommand.ts +++ b/clients/client-connect/commands/CreateRoutingProfileCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRoutingProfileCommandInput = CreateRoutingProfileRequest; export type CreateRoutingProfileCommandOutput = CreateRoutingProfileResponse & __MetadataBearer; +/** + *

Creates a new routing profile.

+ */ export class CreateRoutingProfileCommand extends $Command< CreateRoutingProfileCommandInput, CreateRoutingProfileCommandOutput, @@ -34,6 +37,9 @@ export class CreateRoutingProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/CreateUserCommand.ts b/clients/client-connect/commands/CreateUserCommand.ts index 0dac83b3f8a90..2c73c0fee7a72 100644 --- a/clients/client-connect/commands/CreateUserCommand.ts +++ b/clients/client-connect/commands/CreateUserCommand.ts @@ -20,6 +20,11 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResponse & __MetadataBearer; +/** + *

Creates a user account for the specified Amazon Connect instance.

+ *

For information about how to create user accounts using the Amazon Connect console, see Add Users in + * the Amazon Connect Administrator Guide.

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -34,6 +39,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/CreateUserHierarchyGroupCommand.ts b/clients/client-connect/commands/CreateUserHierarchyGroupCommand.ts index 0edac10ec6a42..6fd233afa2bb3 100644 --- a/clients/client-connect/commands/CreateUserHierarchyGroupCommand.ts +++ b/clients/client-connect/commands/CreateUserHierarchyGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUserHierarchyGroupCommandInput = CreateUserHierarchyGroupRequest; export type CreateUserHierarchyGroupCommandOutput = CreateUserHierarchyGroupResponse & __MetadataBearer; +/** + *

Creates a new user hierarchy group.

+ */ export class CreateUserHierarchyGroupCommand extends $Command< CreateUserHierarchyGroupCommandInput, CreateUserHierarchyGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateUserHierarchyGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/DeleteUserCommand.ts b/clients/client-connect/commands/DeleteUserCommand.ts index 6e5fa6ce47b39..94f7df1c13c65 100644 --- a/clients/client-connect/commands/DeleteUserCommand.ts +++ b/clients/client-connect/commands/DeleteUserCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = __MetadataBearer; +/** + *

Deletes a user account from the specified Amazon Connect instance.

+ *

For information about what happens to a user's data when their account is deleted, see + * Delete Users from + * Your Amazon Connect Instance in the Amazon Connect Administrator + * Guide.

+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -34,6 +41,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/DeleteUserHierarchyGroupCommand.ts b/clients/client-connect/commands/DeleteUserHierarchyGroupCommand.ts index faf3cb8dcf2c7..d4835d4f43e21 100644 --- a/clients/client-connect/commands/DeleteUserHierarchyGroupCommand.ts +++ b/clients/client-connect/commands/DeleteUserHierarchyGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserHierarchyGroupCommandInput = DeleteUserHierarchyGroupRequest; export type DeleteUserHierarchyGroupCommandOutput = __MetadataBearer; +/** + *

Deletes an existing user hierarchy group. It must not be associated with any agents or have any active child groups.

+ */ export class DeleteUserHierarchyGroupCommand extends $Command< DeleteUserHierarchyGroupCommandInput, DeleteUserHierarchyGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserHierarchyGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/DescribeContactFlowCommand.ts b/clients/client-connect/commands/DescribeContactFlowCommand.ts index 2d56307ef4184..a9dd8c31e0b8c 100644 --- a/clients/client-connect/commands/DescribeContactFlowCommand.ts +++ b/clients/client-connect/commands/DescribeContactFlowCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeContactFlowCommandInput = DescribeContactFlowRequest; export type DescribeContactFlowCommandOutput = DescribeContactFlowResponse & __MetadataBearer; +/** + *

Describes the specified contact flow.

+ *

You can also create and update contact flows using the Amazon Connect + * Flow language.

+ */ export class DescribeContactFlowCommand extends $Command< DescribeContactFlowCommandInput, DescribeContactFlowCommandOutput, @@ -34,6 +39,9 @@ export class DescribeContactFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/DescribeRoutingProfileCommand.ts b/clients/client-connect/commands/DescribeRoutingProfileCommand.ts index 5487a13bb5b25..82c1aced85ec1 100644 --- a/clients/client-connect/commands/DescribeRoutingProfileCommand.ts +++ b/clients/client-connect/commands/DescribeRoutingProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRoutingProfileCommandInput = DescribeRoutingProfileRequest; export type DescribeRoutingProfileCommandOutput = DescribeRoutingProfileResponse & __MetadataBearer; +/** + *

Describes the specified routing profile.

+ */ export class DescribeRoutingProfileCommand extends $Command< DescribeRoutingProfileCommandInput, DescribeRoutingProfileCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRoutingProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/DescribeUserCommand.ts b/clients/client-connect/commands/DescribeUserCommand.ts index 77c4ca875c8d2..29f143d607a62 100644 --- a/clients/client-connect/commands/DescribeUserCommand.ts +++ b/clients/client-connect/commands/DescribeUserCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeUserCommandInput = DescribeUserRequest; export type DescribeUserCommandOutput = DescribeUserResponse & __MetadataBearer; +/** + *

Describes the specified user account. You can find the instance ID in the console (it’s the + * final part of the ARN). The console does not display the user IDs. Instead, list the users and + * note the IDs provided in the output.

+ */ export class DescribeUserCommand extends $Command< DescribeUserCommandInput, DescribeUserCommandOutput, @@ -34,6 +39,9 @@ export class DescribeUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/DescribeUserHierarchyGroupCommand.ts b/clients/client-connect/commands/DescribeUserHierarchyGroupCommand.ts index 28c10c2142f5b..1c96c98a4eb0c 100644 --- a/clients/client-connect/commands/DescribeUserHierarchyGroupCommand.ts +++ b/clients/client-connect/commands/DescribeUserHierarchyGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserHierarchyGroupCommandInput = DescribeUserHierarchyGroupRequest; export type DescribeUserHierarchyGroupCommandOutput = DescribeUserHierarchyGroupResponse & __MetadataBearer; +/** + *

Describes the specified hierarchy group.

+ */ export class DescribeUserHierarchyGroupCommand extends $Command< DescribeUserHierarchyGroupCommandInput, DescribeUserHierarchyGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserHierarchyGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/DescribeUserHierarchyStructureCommand.ts b/clients/client-connect/commands/DescribeUserHierarchyStructureCommand.ts index bd52fb66630b7..87e38964b041c 100644 --- a/clients/client-connect/commands/DescribeUserHierarchyStructureCommand.ts +++ b/clients/client-connect/commands/DescribeUserHierarchyStructureCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserHierarchyStructureCommandInput = DescribeUserHierarchyStructureRequest; export type DescribeUserHierarchyStructureCommandOutput = DescribeUserHierarchyStructureResponse & __MetadataBearer; +/** + *

Describes the hierarchy structure of the specified Amazon Connect instance.

+ */ export class DescribeUserHierarchyStructureCommand extends $Command< DescribeUserHierarchyStructureCommandInput, DescribeUserHierarchyStructureCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserHierarchyStructureCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/DisassociateRoutingProfileQueuesCommand.ts b/clients/client-connect/commands/DisassociateRoutingProfileQueuesCommand.ts index a0cdd5f407414..57711b06a8e7a 100644 --- a/clients/client-connect/commands/DisassociateRoutingProfileQueuesCommand.ts +++ b/clients/client-connect/commands/DisassociateRoutingProfileQueuesCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateRoutingProfileQueuesCommandInput = DisassociateRoutingProfileQueuesRequest; export type DisassociateRoutingProfileQueuesCommandOutput = __MetadataBearer; +/** + *

Disassociates a set of queues from a routing profile.

+ */ export class DisassociateRoutingProfileQueuesCommand extends $Command< DisassociateRoutingProfileQueuesCommandInput, DisassociateRoutingProfileQueuesCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateRoutingProfileQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/GetContactAttributesCommand.ts b/clients/client-connect/commands/GetContactAttributesCommand.ts index 5d2dd0112f528..7bdce69930f72 100644 --- a/clients/client-connect/commands/GetContactAttributesCommand.ts +++ b/clients/client-connect/commands/GetContactAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type GetContactAttributesCommandInput = GetContactAttributesRequest; export type GetContactAttributesCommandOutput = GetContactAttributesResponse & __MetadataBearer; +/** + *

Retrieves the contact attributes for the specified contact.

+ */ export class GetContactAttributesCommand extends $Command< GetContactAttributesCommandInput, GetContactAttributesCommandOutput, @@ -34,6 +37,9 @@ export class GetContactAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/GetCurrentMetricDataCommand.ts b/clients/client-connect/commands/GetCurrentMetricDataCommand.ts index 0db7281befd2d..4999a6bf98bc3 100644 --- a/clients/client-connect/commands/GetCurrentMetricDataCommand.ts +++ b/clients/client-connect/commands/GetCurrentMetricDataCommand.ts @@ -20,6 +20,11 @@ import { export type GetCurrentMetricDataCommandInput = GetCurrentMetricDataRequest; export type GetCurrentMetricDataCommandOutput = GetCurrentMetricDataResponse & __MetadataBearer; +/** + *

Gets the real-time metric data from the specified Amazon Connect instance.

+ *

For a description of each metric, see Real-time Metrics + * Definitions in the Amazon Connect Administrator Guide.

+ */ export class GetCurrentMetricDataCommand extends $Command< GetCurrentMetricDataCommandInput, GetCurrentMetricDataCommandOutput, @@ -34,6 +39,9 @@ export class GetCurrentMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/GetFederationTokenCommand.ts b/clients/client-connect/commands/GetFederationTokenCommand.ts index bdc4a6d69be42..ede0301664d17 100644 --- a/clients/client-connect/commands/GetFederationTokenCommand.ts +++ b/clients/client-connect/commands/GetFederationTokenCommand.ts @@ -20,6 +20,9 @@ import { export type GetFederationTokenCommandInput = GetFederationTokenRequest; export type GetFederationTokenCommandOutput = GetFederationTokenResponse & __MetadataBearer; +/** + *

Retrieves a token for federation.

+ */ export class GetFederationTokenCommand extends $Command< GetFederationTokenCommandInput, GetFederationTokenCommandOutput, @@ -34,6 +37,9 @@ export class GetFederationTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/GetMetricDataCommand.ts b/clients/client-connect/commands/GetMetricDataCommand.ts index af4e3a98e48b3..88d9417819a1e 100644 --- a/clients/client-connect/commands/GetMetricDataCommand.ts +++ b/clients/client-connect/commands/GetMetricDataCommand.ts @@ -20,6 +20,11 @@ import { export type GetMetricDataCommandInput = GetMetricDataRequest; export type GetMetricDataCommandOutput = GetMetricDataResponse & __MetadataBearer; +/** + *

Gets historical metric data from the specified Amazon Connect instance.

+ *

For a description of each historical metric, see Historical Metrics + * Definitions in the Amazon Connect Administrator Guide.

+ */ export class GetMetricDataCommand extends $Command< GetMetricDataCommandInput, GetMetricDataCommandOutput, @@ -34,6 +39,9 @@ export class GetMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListContactFlowsCommand.ts b/clients/client-connect/commands/ListContactFlowsCommand.ts index ab6bbc635cd6a..76c462bac60dc 100644 --- a/clients/client-connect/commands/ListContactFlowsCommand.ts +++ b/clients/client-connect/commands/ListContactFlowsCommand.ts @@ -20,6 +20,13 @@ import { export type ListContactFlowsCommandInput = ListContactFlowsRequest; export type ListContactFlowsCommandOutput = ListContactFlowsResponse & __MetadataBearer; +/** + *

Provides information about the contact flows for the specified Amazon Connect instance.

+ *

You can also create and update contact flows using the Amazon Connect + * Flow language.

+ *

For more information about contact flows, see Contact Flows in the + * Amazon Connect Administrator Guide.

+ */ export class ListContactFlowsCommand extends $Command< ListContactFlowsCommandInput, ListContactFlowsCommandOutput, @@ -34,6 +41,9 @@ export class ListContactFlowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListHoursOfOperationsCommand.ts b/clients/client-connect/commands/ListHoursOfOperationsCommand.ts index f9ced9658a288..58708dd7f7729 100644 --- a/clients/client-connect/commands/ListHoursOfOperationsCommand.ts +++ b/clients/client-connect/commands/ListHoursOfOperationsCommand.ts @@ -20,6 +20,11 @@ import { export type ListHoursOfOperationsCommandInput = ListHoursOfOperationsRequest; export type ListHoursOfOperationsCommandOutput = ListHoursOfOperationsResponse & __MetadataBearer; +/** + *

Provides information about the hours of operation for the specified Amazon Connect instance.

+ *

For more information about hours of operation, see Set the Hours of Operation for a + * Queue in the Amazon Connect Administrator Guide.

+ */ export class ListHoursOfOperationsCommand extends $Command< ListHoursOfOperationsCommandInput, ListHoursOfOperationsCommandOutput, @@ -34,6 +39,9 @@ export class ListHoursOfOperationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListPhoneNumbersCommand.ts b/clients/client-connect/commands/ListPhoneNumbersCommand.ts index 76fc62c2aa0a9..3cae26c4d8221 100644 --- a/clients/client-connect/commands/ListPhoneNumbersCommand.ts +++ b/clients/client-connect/commands/ListPhoneNumbersCommand.ts @@ -20,6 +20,11 @@ import { export type ListPhoneNumbersCommandInput = ListPhoneNumbersRequest; export type ListPhoneNumbersCommandOutput = ListPhoneNumbersResponse & __MetadataBearer; +/** + *

Provides information about the phone numbers for the specified Amazon Connect instance.

+ *

For more information about phone numbers, see Set Up Phone Numbers for Your + * Contact Center in the Amazon Connect Administrator Guide.

+ */ export class ListPhoneNumbersCommand extends $Command< ListPhoneNumbersCommandInput, ListPhoneNumbersCommandOutput, @@ -34,6 +39,9 @@ export class ListPhoneNumbersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListPromptsCommand.ts b/clients/client-connect/commands/ListPromptsCommand.ts index df8e776c86747..3aeb59edaed9c 100644 --- a/clients/client-connect/commands/ListPromptsCommand.ts +++ b/clients/client-connect/commands/ListPromptsCommand.ts @@ -20,6 +20,10 @@ import { export type ListPromptsCommandInput = ListPromptsRequest; export type ListPromptsCommandOutput = ListPromptsResponse & __MetadataBearer; +/** + *

Provides information about the prompts for the specified Amazon Connect + * instance.

+ */ export class ListPromptsCommand extends $Command< ListPromptsCommandInput, ListPromptsCommandOutput, @@ -34,6 +38,9 @@ export class ListPromptsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListQueuesCommand.ts b/clients/client-connect/commands/ListQueuesCommand.ts index d365a5fbc8007..9539535faf3fb 100644 --- a/clients/client-connect/commands/ListQueuesCommand.ts +++ b/clients/client-connect/commands/ListQueuesCommand.ts @@ -20,6 +20,11 @@ import { export type ListQueuesCommandInput = ListQueuesRequest; export type ListQueuesCommandOutput = ListQueuesResponse & __MetadataBearer; +/** + *

Provides information about the queues for the specified Amazon Connect instance.

+ *

For more information about queues, see Queues: Standard and + * Agent in the Amazon Connect Administrator Guide.

+ */ export class ListQueuesCommand extends $Command< ListQueuesCommandInput, ListQueuesCommandOutput, @@ -34,6 +39,9 @@ export class ListQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListRoutingProfileQueuesCommand.ts b/clients/client-connect/commands/ListRoutingProfileQueuesCommand.ts index b0cdcf04a0aec..18c4d45e8180e 100644 --- a/clients/client-connect/commands/ListRoutingProfileQueuesCommand.ts +++ b/clients/client-connect/commands/ListRoutingProfileQueuesCommand.ts @@ -20,6 +20,9 @@ import { export type ListRoutingProfileQueuesCommandInput = ListRoutingProfileQueuesRequest; export type ListRoutingProfileQueuesCommandOutput = ListRoutingProfileQueuesResponse & __MetadataBearer; +/** + *

List the queues associated with a routing profile.

+ */ export class ListRoutingProfileQueuesCommand extends $Command< ListRoutingProfileQueuesCommandInput, ListRoutingProfileQueuesCommandOutput, @@ -34,6 +37,9 @@ export class ListRoutingProfileQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListRoutingProfilesCommand.ts b/clients/client-connect/commands/ListRoutingProfilesCommand.ts index 4d7c4c7632375..726f50bf23d51 100644 --- a/clients/client-connect/commands/ListRoutingProfilesCommand.ts +++ b/clients/client-connect/commands/ListRoutingProfilesCommand.ts @@ -20,6 +20,12 @@ import { export type ListRoutingProfilesCommandInput = ListRoutingProfilesRequest; export type ListRoutingProfilesCommandOutput = ListRoutingProfilesResponse & __MetadataBearer; +/** + *

Provides summary information about the routing profiles for the specified Amazon Connect + * instance.

+ *

For more information about routing profiles, see Routing Profiles and Create a Routing + * Profile in the Amazon Connect Administrator Guide.

+ */ export class ListRoutingProfilesCommand extends $Command< ListRoutingProfilesCommandInput, ListRoutingProfilesCommandOutput, @@ -34,6 +40,9 @@ export class ListRoutingProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListSecurityProfilesCommand.ts b/clients/client-connect/commands/ListSecurityProfilesCommand.ts index 680400705eb21..5f084aebc7019 100644 --- a/clients/client-connect/commands/ListSecurityProfilesCommand.ts +++ b/clients/client-connect/commands/ListSecurityProfilesCommand.ts @@ -20,6 +20,12 @@ import { export type ListSecurityProfilesCommandInput = ListSecurityProfilesRequest; export type ListSecurityProfilesCommandOutput = ListSecurityProfilesResponse & __MetadataBearer; +/** + *

Provides summary information about the security profiles for the specified Amazon Connect + * instance.

+ *

For more information about security profiles, see Security Profiles in the + * Amazon Connect Administrator Guide.

+ */ export class ListSecurityProfilesCommand extends $Command< ListSecurityProfilesCommandInput, ListSecurityProfilesCommandOutput, @@ -34,6 +40,9 @@ export class ListSecurityProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListTagsForResourceCommand.ts b/clients/client-connect/commands/ListTagsForResourceCommand.ts index 8b7d8ba089800..8412d897441ea 100644 --- a/clients/client-connect/commands/ListTagsForResourceCommand.ts +++ b/clients/client-connect/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags for the specified resource.

+ *

For sample policies that use tags, see Amazon Connect Identity-Based + * Policy Examples in the Amazon Connect Administrator Guide.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListUserHierarchyGroupsCommand.ts b/clients/client-connect/commands/ListUserHierarchyGroupsCommand.ts index f83a5dad93851..aed9551d621d9 100644 --- a/clients/client-connect/commands/ListUserHierarchyGroupsCommand.ts +++ b/clients/client-connect/commands/ListUserHierarchyGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type ListUserHierarchyGroupsCommandInput = ListUserHierarchyGroupsRequest; export type ListUserHierarchyGroupsCommandOutput = ListUserHierarchyGroupsResponse & __MetadataBearer; +/** + *

Provides summary information about the hierarchy groups for the specified Amazon Connect + * instance.

+ *

For more information about agent hierarchies, see Set Up Agent Hierarchies in the + * Amazon Connect Administrator Guide.

+ */ export class ListUserHierarchyGroupsCommand extends $Command< ListUserHierarchyGroupsCommandInput, ListUserHierarchyGroupsCommandOutput, @@ -34,6 +40,9 @@ export class ListUserHierarchyGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ListUsersCommand.ts b/clients/client-connect/commands/ListUsersCommand.ts index 523bd84afd5b1..4500b00a211bb 100644 --- a/clients/client-connect/commands/ListUsersCommand.ts +++ b/clients/client-connect/commands/ListUsersCommand.ts @@ -20,6 +20,9 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + *

Provides summary information about the users for the specified Amazon Connect instance.

+ */ export class ListUsersCommand extends $Command< ListUsersCommandInput, ListUsersCommandOutput, @@ -34,6 +37,9 @@ export class ListUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/ResumeContactRecordingCommand.ts b/clients/client-connect/commands/ResumeContactRecordingCommand.ts index 4bd8e7c7596bd..2028f53ea4004 100644 --- a/clients/client-connect/commands/ResumeContactRecordingCommand.ts +++ b/clients/client-connect/commands/ResumeContactRecordingCommand.ts @@ -20,6 +20,12 @@ import { export type ResumeContactRecordingCommandInput = ResumeContactRecordingRequest; export type ResumeContactRecordingCommandOutput = ResumeContactRecordingResponse & __MetadataBearer; +/** + *

When a contact is being recorded, and the recording has been suspended using + * SuspendContactRecording, this API resumes recording the call.

+ * + *

Only voice recordings are supported at this time.

+ */ export class ResumeContactRecordingCommand extends $Command< ResumeContactRecordingCommandInput, ResumeContactRecordingCommandOutput, @@ -34,6 +40,9 @@ export class ResumeContactRecordingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/StartChatContactCommand.ts b/clients/client-connect/commands/StartChatContactCommand.ts index 348f3caee728a..4ae5affa18b02 100644 --- a/clients/client-connect/commands/StartChatContactCommand.ts +++ b/clients/client-connect/commands/StartChatContactCommand.ts @@ -20,6 +20,30 @@ import { export type StartChatContactCommandInput = StartChatContactRequest; export type StartChatContactCommandOutput = StartChatContactResponse & __MetadataBearer; +/** + *

Initiates a contact flow to start a new chat for the customer. Response of this API provides + * a token required to obtain credentials from the CreateParticipantConnection API in the Amazon Connect Participant Service.

+ * + *

When a new chat contact is successfully created, clients need to subscribe to the + * participant’s connection for the created chat within 5 minutes. This is achieved by invoking + * CreateParticipantConnection with WEBSOCKET and CONNECTION_CREDENTIALS.

+ * + *

A 429 error occurs in two situations:

+ *
    + *
  • + *

    API rate limit is exceeded. API TPS throttling returns a TooManyRequests + * exception from the API Gateway.

    + *
  • + *
  • + *

    The quota for concurrent active + * chats is exceeded. Active chat throttling returns a + * LimitExceededException.

    + *
  • + *
+ * + *

For more information about how chat works, see Chat in the Amazon Connect Administrator + * Guide.

+ */ export class StartChatContactCommand extends $Command< StartChatContactCommandInput, StartChatContactCommandOutput, @@ -34,6 +58,9 @@ export class StartChatContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/StartContactRecordingCommand.ts b/clients/client-connect/commands/StartContactRecordingCommand.ts index deb3094a074f3..953e612d154cc 100644 --- a/clients/client-connect/commands/StartContactRecordingCommand.ts +++ b/clients/client-connect/commands/StartContactRecordingCommand.ts @@ -20,6 +20,16 @@ import { export type StartContactRecordingCommandInput = StartContactRecordingRequest; export type StartContactRecordingCommandOutput = StartContactRecordingResponse & __MetadataBearer; +/** + *

This API starts recording the contact when the agent joins the call. StartContactRecording + * is a one-time action. For example, if you use StopContactRecording to stop recording an ongoing + * call, you can't use StartContactRecording to restart it. For scenarios where the recording has + * started and you want to suspend and resume it, such as when collecting sensitive information (for + * example, a credit card number), use SuspendContactRecording and ResumeContactRecording.

+ *

You can use this API to override the recording behavior configured in the Set recording + * behavior block.

+ *

Only voice recordings are supported at this time.

+ */ export class StartContactRecordingCommand extends $Command< StartContactRecordingCommandInput, StartContactRecordingCommandOutput, @@ -34,6 +44,9 @@ export class StartContactRecordingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/StartOutboundVoiceContactCommand.ts b/clients/client-connect/commands/StartOutboundVoiceContactCommand.ts index 29f0a1b4ad38d..c8df7bfbde8ce 100644 --- a/clients/client-connect/commands/StartOutboundVoiceContactCommand.ts +++ b/clients/client-connect/commands/StartOutboundVoiceContactCommand.ts @@ -20,6 +20,22 @@ import { export type StartOutboundVoiceContactCommandInput = StartOutboundVoiceContactRequest; export type StartOutboundVoiceContactCommandOutput = StartOutboundVoiceContactResponse & __MetadataBearer; +/** + *

This API places an outbound call to a contact, and then initiates the contact flow. It + * performs the actions in the contact flow that's specified (in ContactFlowId).

+ * + *

Agents are not involved in initiating the outbound API (that is, dialing the contact). If + * the contact flow places an outbound call to a contact, and then puts the contact in queue, that's + * when the call is routed to the agent, like any other inbound case.

+ * + *

There is a 60 second dialing timeout for this operation. If the call is not connected after + * 60 seconds, it fails.

+ * + *

UK numbers with a 447 prefix are not allowed by default. Before you can dial these UK + * mobile numbers, you must submit a service quota increase request. For more information, see + * Amazon Connect Service Quotas in the Amazon Connect Administrator Guide.

+ *
+ */ export class StartOutboundVoiceContactCommand extends $Command< StartOutboundVoiceContactCommandInput, StartOutboundVoiceContactCommandOutput, @@ -34,6 +50,9 @@ export class StartOutboundVoiceContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/StopContactCommand.ts b/clients/client-connect/commands/StopContactCommand.ts index c517cb258532d..34af306471097 100644 --- a/clients/client-connect/commands/StopContactCommand.ts +++ b/clients/client-connect/commands/StopContactCommand.ts @@ -20,6 +20,9 @@ import { export type StopContactCommandInput = StopContactRequest; export type StopContactCommandOutput = StopContactResponse & __MetadataBearer; +/** + *

Ends the specified contact.

+ */ export class StopContactCommand extends $Command< StopContactCommandInput, StopContactCommandOutput, @@ -34,6 +37,9 @@ export class StopContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/StopContactRecordingCommand.ts b/clients/client-connect/commands/StopContactRecordingCommand.ts index fcbc679af2a8f..99f24f793176c 100644 --- a/clients/client-connect/commands/StopContactRecordingCommand.ts +++ b/clients/client-connect/commands/StopContactRecordingCommand.ts @@ -20,6 +20,15 @@ import { export type StopContactRecordingCommandInput = StopContactRecordingRequest; export type StopContactRecordingCommandOutput = StopContactRecordingResponse & __MetadataBearer; +/** + *

When a contact is being recorded, this API stops recording the call. StopContactRecording is + * a one-time action. If you use StopContactRecording to stop recording an ongoing call, you can't + * use StartContactRecording to restart it. For scenarios where the recording has started and you + * want to suspend it for sensitive information (for example, to collect a credit card number), and + * then restart it, use SuspendContactRecording and ResumeContactRecording.

+ * + *

Only voice recordings are supported at this time.

+ */ export class StopContactRecordingCommand extends $Command< StopContactRecordingCommandInput, StopContactRecordingCommandOutput, @@ -34,6 +43,9 @@ export class StopContactRecordingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/SuspendContactRecordingCommand.ts b/clients/client-connect/commands/SuspendContactRecordingCommand.ts index bd618e92be7ed..bade055ea4427 100644 --- a/clients/client-connect/commands/SuspendContactRecordingCommand.ts +++ b/clients/client-connect/commands/SuspendContactRecordingCommand.ts @@ -20,6 +20,14 @@ import { export type SuspendContactRecordingCommandInput = SuspendContactRecordingRequest; export type SuspendContactRecordingCommandOutput = SuspendContactRecordingResponse & __MetadataBearer; +/** + *

When a contact is being recorded, this API suspends recording the call. For example, you + * might suspend the call recording while collecting sensitive information, such as a credit card + * number. Then use ResumeContactRecording to restart recording.

+ *

The period of time that the recording is suspended is filled with silence in the final + * recording.

+ *

Only voice recordings are supported at this time.

+ */ export class SuspendContactRecordingCommand extends $Command< SuspendContactRecordingCommandInput, SuspendContactRecordingCommandOutput, @@ -34,6 +42,9 @@ export class SuspendContactRecordingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/TagResourceCommand.ts b/clients/client-connect/commands/TagResourceCommand.ts index 8029a1cf90c89..5fa785860fe99 100644 --- a/clients/client-connect/commands/TagResourceCommand.ts +++ b/clients/client-connect/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds the specified tags to the specified resource.

+ *

The supported resource types are users, routing profiles, and contact flows.

+ *

For sample policies that use tags, see Amazon Connect Identity-Based + * Policy Examples in the Amazon Connect Administrator Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UntagResourceCommand.ts b/clients/client-connect/commands/UntagResourceCommand.ts index e23d80f3552a1..4f3bb6f36a245 100644 --- a/clients/client-connect/commands/UntagResourceCommand.ts +++ b/clients/client-connect/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes the specified tags from the specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateContactAttributesCommand.ts b/clients/client-connect/commands/UpdateContactAttributesCommand.ts index fc3e3e07c29ac..0d0bb9c11fe02 100644 --- a/clients/client-connect/commands/UpdateContactAttributesCommand.ts +++ b/clients/client-connect/commands/UpdateContactAttributesCommand.ts @@ -20,6 +20,24 @@ import { export type UpdateContactAttributesCommandInput = UpdateContactAttributesRequest; export type UpdateContactAttributesCommandOutput = UpdateContactAttributesResponse & __MetadataBearer; +/** + *

Creates or updates the contact attributes associated with the specified contact.

+ *

You can add or update attributes for both ongoing and completed contacts. For example, you + * can update the customer's name or the reason the customer called while the call is active, or add + * notes about steps that the agent took during the call that are displayed to the next agent that + * takes the call. You can also update attributes for a contact using data from your CRM application + * and save the data with the contact in Amazon Connect. You could also flag calls for additional analysis, + * such as legal review or identifying abusive callers.

+ *

Contact attributes are available in Amazon Connect for 24 months, and are then deleted.

+ * + *

+ * Important: You cannot use the operation to update + * attributes for contacts that occurred prior to the release of the API, September 12, 2018. You + * can update attributes only for contacts that started after the release of the API. If you attempt + * to update attributes for a contact that occurred prior to the release of the API, a 400 error is + * returned. This applies also to queued callbacks that were initiated prior to the release of the + * API but are still active in your instance.

+ */ export class UpdateContactAttributesCommand extends $Command< UpdateContactAttributesCommandInput, UpdateContactAttributesCommandOutput, @@ -34,6 +52,9 @@ export class UpdateContactAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateContactFlowContentCommand.ts b/clients/client-connect/commands/UpdateContactFlowContentCommand.ts index 3a853560cf0d4..ecfe98f013fe8 100644 --- a/clients/client-connect/commands/UpdateContactFlowContentCommand.ts +++ b/clients/client-connect/commands/UpdateContactFlowContentCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateContactFlowContentCommandInput = UpdateContactFlowContentRequest; export type UpdateContactFlowContentCommandOutput = __MetadataBearer; +/** + *

Updates the specified contact flow.

+ *

You can also create and update contact flows using the Amazon Connect + * Flow language.

+ */ export class UpdateContactFlowContentCommand extends $Command< UpdateContactFlowContentCommandInput, UpdateContactFlowContentCommandOutput, @@ -34,6 +39,9 @@ export class UpdateContactFlowContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateContactFlowNameCommand.ts b/clients/client-connect/commands/UpdateContactFlowNameCommand.ts index a7208f9d4a96f..3729c2321b5ce 100644 --- a/clients/client-connect/commands/UpdateContactFlowNameCommand.ts +++ b/clients/client-connect/commands/UpdateContactFlowNameCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateContactFlowNameCommandInput = UpdateContactFlowNameRequest; export type UpdateContactFlowNameCommandOutput = __MetadataBearer; +/** + *

The name of the contact flow.

+ *

You can also create and update contact flows using the Amazon Connect + * Flow language.

+ */ export class UpdateContactFlowNameCommand extends $Command< UpdateContactFlowNameCommandInput, UpdateContactFlowNameCommandOutput, @@ -34,6 +39,9 @@ export class UpdateContactFlowNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateRoutingProfileConcurrencyCommand.ts b/clients/client-connect/commands/UpdateRoutingProfileConcurrencyCommand.ts index 992f5bf8a645b..a9047800dc2bf 100644 --- a/clients/client-connect/commands/UpdateRoutingProfileConcurrencyCommand.ts +++ b/clients/client-connect/commands/UpdateRoutingProfileConcurrencyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRoutingProfileConcurrencyCommandInput = UpdateRoutingProfileConcurrencyRequest; export type UpdateRoutingProfileConcurrencyCommandOutput = __MetadataBearer; +/** + *

Updates the channels that agents can handle in the Contact Control Panel (CCP) for a routing profile.

+ */ export class UpdateRoutingProfileConcurrencyCommand extends $Command< UpdateRoutingProfileConcurrencyCommandInput, UpdateRoutingProfileConcurrencyCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRoutingProfileConcurrencyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateRoutingProfileDefaultOutboundQueueCommand.ts b/clients/client-connect/commands/UpdateRoutingProfileDefaultOutboundQueueCommand.ts index b10c6bebef9c8..e7b9a64a97eab 100644 --- a/clients/client-connect/commands/UpdateRoutingProfileDefaultOutboundQueueCommand.ts +++ b/clients/client-connect/commands/UpdateRoutingProfileDefaultOutboundQueueCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRoutingProfileDefaultOutboundQueueCommandInput = UpdateRoutingProfileDefaultOutboundQueueRequest; export type UpdateRoutingProfileDefaultOutboundQueueCommandOutput = __MetadataBearer; +/** + *

Updates the default outbound queue of a routing profile.

+ */ export class UpdateRoutingProfileDefaultOutboundQueueCommand extends $Command< UpdateRoutingProfileDefaultOutboundQueueCommandInput, UpdateRoutingProfileDefaultOutboundQueueCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRoutingProfileDefaultOutboundQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateRoutingProfileNameCommand.ts b/clients/client-connect/commands/UpdateRoutingProfileNameCommand.ts index a434c10834da6..7c210c9b4ffa5 100644 --- a/clients/client-connect/commands/UpdateRoutingProfileNameCommand.ts +++ b/clients/client-connect/commands/UpdateRoutingProfileNameCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRoutingProfileNameCommandInput = UpdateRoutingProfileNameRequest; export type UpdateRoutingProfileNameCommandOutput = __MetadataBearer; +/** + *

Updates the name and description of a routing profile. The request accepts the following data in JSON format. At least Name or Description must be provided.

+ */ export class UpdateRoutingProfileNameCommand extends $Command< UpdateRoutingProfileNameCommandInput, UpdateRoutingProfileNameCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRoutingProfileNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateRoutingProfileQueuesCommand.ts b/clients/client-connect/commands/UpdateRoutingProfileQueuesCommand.ts index ebcc781a0b37f..a23013948ea0d 100644 --- a/clients/client-connect/commands/UpdateRoutingProfileQueuesCommand.ts +++ b/clients/client-connect/commands/UpdateRoutingProfileQueuesCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRoutingProfileQueuesCommandInput = UpdateRoutingProfileQueuesRequest; export type UpdateRoutingProfileQueuesCommandOutput = __MetadataBearer; +/** + *

Updates the properties associated with a set of queues for a routing profile.

+ */ export class UpdateRoutingProfileQueuesCommand extends $Command< UpdateRoutingProfileQueuesCommandInput, UpdateRoutingProfileQueuesCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRoutingProfileQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateUserHierarchyCommand.ts b/clients/client-connect/commands/UpdateUserHierarchyCommand.ts index 252f2d2587704..cd95a25c34f28 100644 --- a/clients/client-connect/commands/UpdateUserHierarchyCommand.ts +++ b/clients/client-connect/commands/UpdateUserHierarchyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserHierarchyCommandInput = UpdateUserHierarchyRequest; export type UpdateUserHierarchyCommandOutput = __MetadataBearer; +/** + *

Assigns the specified hierarchy group to the specified user.

+ */ export class UpdateUserHierarchyCommand extends $Command< UpdateUserHierarchyCommandInput, UpdateUserHierarchyCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserHierarchyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateUserHierarchyGroupNameCommand.ts b/clients/client-connect/commands/UpdateUserHierarchyGroupNameCommand.ts index 44f62bf01227b..484459e90c47a 100644 --- a/clients/client-connect/commands/UpdateUserHierarchyGroupNameCommand.ts +++ b/clients/client-connect/commands/UpdateUserHierarchyGroupNameCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserHierarchyGroupNameCommandInput = UpdateUserHierarchyGroupNameRequest; export type UpdateUserHierarchyGroupNameCommandOutput = __MetadataBearer; +/** + *

Updates the name of the user hierarchy group.

+ */ export class UpdateUserHierarchyGroupNameCommand extends $Command< UpdateUserHierarchyGroupNameCommandInput, UpdateUserHierarchyGroupNameCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserHierarchyGroupNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateUserHierarchyStructureCommand.ts b/clients/client-connect/commands/UpdateUserHierarchyStructureCommand.ts index e8f1b68fb4b4a..58035bca5741c 100644 --- a/clients/client-connect/commands/UpdateUserHierarchyStructureCommand.ts +++ b/clients/client-connect/commands/UpdateUserHierarchyStructureCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserHierarchyStructureCommandInput = UpdateUserHierarchyStructureRequest; export type UpdateUserHierarchyStructureCommandOutput = __MetadataBearer; +/** + *

Updates the user hierarchy structure: add, remove, and rename user hierarchy levels.

+ */ export class UpdateUserHierarchyStructureCommand extends $Command< UpdateUserHierarchyStructureCommandInput, UpdateUserHierarchyStructureCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserHierarchyStructureCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateUserIdentityInfoCommand.ts b/clients/client-connect/commands/UpdateUserIdentityInfoCommand.ts index 4e13e008cd224..8a5e8dcbbd10b 100644 --- a/clients/client-connect/commands/UpdateUserIdentityInfoCommand.ts +++ b/clients/client-connect/commands/UpdateUserIdentityInfoCommand.ts @@ -20,6 +20,18 @@ import { export type UpdateUserIdentityInfoCommandInput = UpdateUserIdentityInfoRequest; export type UpdateUserIdentityInfoCommandOutput = __MetadataBearer; +/** + *

Updates the identity information for the specified user.

+ * + *

Someone with the ability to invoke UpdateUserIndentityInfo can change the + * login credentials of other users by changing their email address. This poses a security risk to + * your organization. They can change the email address of a user to the attacker's email address, + * and then reset the password through email. We strongly recommend limiting who has the ability to + * invoke UpdateUserIndentityInfo. For more information, see Best + * Practices for Security Profiles in the Amazon Connect Administrator + * Guide.

+ *
+ */ export class UpdateUserIdentityInfoCommand extends $Command< UpdateUserIdentityInfoCommandInput, UpdateUserIdentityInfoCommandOutput, @@ -34,6 +46,9 @@ export class UpdateUserIdentityInfoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateUserPhoneConfigCommand.ts b/clients/client-connect/commands/UpdateUserPhoneConfigCommand.ts index 283ceefe49166..3d87e3a3224ae 100644 --- a/clients/client-connect/commands/UpdateUserPhoneConfigCommand.ts +++ b/clients/client-connect/commands/UpdateUserPhoneConfigCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserPhoneConfigCommandInput = UpdateUserPhoneConfigRequest; export type UpdateUserPhoneConfigCommandOutput = __MetadataBearer; +/** + *

Updates the phone configuration settings for the specified user.

+ */ export class UpdateUserPhoneConfigCommand extends $Command< UpdateUserPhoneConfigCommandInput, UpdateUserPhoneConfigCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserPhoneConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateUserRoutingProfileCommand.ts b/clients/client-connect/commands/UpdateUserRoutingProfileCommand.ts index adea9f5ca81fd..2e69f3bf154e1 100644 --- a/clients/client-connect/commands/UpdateUserRoutingProfileCommand.ts +++ b/clients/client-connect/commands/UpdateUserRoutingProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserRoutingProfileCommandInput = UpdateUserRoutingProfileRequest; export type UpdateUserRoutingProfileCommandOutput = __MetadataBearer; +/** + *

Assigns the specified routing profile to the specified user.

+ */ export class UpdateUserRoutingProfileCommand extends $Command< UpdateUserRoutingProfileCommandInput, UpdateUserRoutingProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserRoutingProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/commands/UpdateUserSecurityProfilesCommand.ts b/clients/client-connect/commands/UpdateUserSecurityProfilesCommand.ts index aaf9921dee618..59b900f6d4eef 100644 --- a/clients/client-connect/commands/UpdateUserSecurityProfilesCommand.ts +++ b/clients/client-connect/commands/UpdateUserSecurityProfilesCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserSecurityProfilesCommandInput = UpdateUserSecurityProfilesRequest; export type UpdateUserSecurityProfilesCommandOutput = __MetadataBearer; +/** + *

Assigns the specified security profiles to the specified user.

+ */ export class UpdateUserSecurityProfilesCommand extends $Command< UpdateUserSecurityProfilesCommandInput, UpdateUserSecurityProfilesCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserSecurityProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectClientResolvedConfig, diff --git a/clients/client-connect/package.json b/clients/client-connect/package.json index 028a8e50e6122..f9c25c3fe55ee 100644 --- a/clients/client-connect/package.json +++ b/clients/client-connect/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Connect Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-connect/pagination/GetCurrentMetricDataPaginator.ts b/clients/client-connect/pagination/GetCurrentMetricDataPaginator.ts index cb571b3a0f191..6ab125417ce66 100644 --- a/clients/client-connect/pagination/GetCurrentMetricDataPaginator.ts +++ b/clients/client-connect/pagination/GetCurrentMetricDataPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: GetCurrentMetricDataCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCurrentMetricDataCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: GetCurrentMetricDataCommandInput, diff --git a/clients/client-connect/pagination/GetMetricDataPaginator.ts b/clients/client-connect/pagination/GetMetricDataPaginator.ts index d8a915686d649..8dddc47a60758 100644 --- a/clients/client-connect/pagination/GetMetricDataPaginator.ts +++ b/clients/client-connect/pagination/GetMetricDataPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: GetMetricDataCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetMetricDataCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: GetMetricDataCommandInput, diff --git a/clients/client-connect/pagination/ListContactFlowsPaginator.ts b/clients/client-connect/pagination/ListContactFlowsPaginator.ts index 43ba59e73b83a..d6fa30007d337 100644 --- a/clients/client-connect/pagination/ListContactFlowsPaginator.ts +++ b/clients/client-connect/pagination/ListContactFlowsPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListContactFlowsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListContactFlowsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListContactFlowsCommandInput, diff --git a/clients/client-connect/pagination/ListHoursOfOperationsPaginator.ts b/clients/client-connect/pagination/ListHoursOfOperationsPaginator.ts index a984dc17a4d06..e1ecab0b84391 100644 --- a/clients/client-connect/pagination/ListHoursOfOperationsPaginator.ts +++ b/clients/client-connect/pagination/ListHoursOfOperationsPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListHoursOfOperationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHoursOfOperationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListHoursOfOperationsCommandInput, diff --git a/clients/client-connect/pagination/ListPhoneNumbersPaginator.ts b/clients/client-connect/pagination/ListPhoneNumbersPaginator.ts index 0b99eb389336d..660df5084a521 100644 --- a/clients/client-connect/pagination/ListPhoneNumbersPaginator.ts +++ b/clients/client-connect/pagination/ListPhoneNumbersPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListPhoneNumbersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPhoneNumbersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListPhoneNumbersCommandInput, diff --git a/clients/client-connect/pagination/ListPromptsPaginator.ts b/clients/client-connect/pagination/ListPromptsPaginator.ts index 4e708e2223b14..66a63fab2efd8 100644 --- a/clients/client-connect/pagination/ListPromptsPaginator.ts +++ b/clients/client-connect/pagination/ListPromptsPaginator.ts @@ -4,6 +4,9 @@ import { ListPromptsCommand, ListPromptsCommandInput, ListPromptsCommandOutput } import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListPromptsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPromptsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListPromptsCommandInput, diff --git a/clients/client-connect/pagination/ListQueuesPaginator.ts b/clients/client-connect/pagination/ListQueuesPaginator.ts index f2f4895ff3d79..7bb39492a1ccc 100644 --- a/clients/client-connect/pagination/ListQueuesPaginator.ts +++ b/clients/client-connect/pagination/ListQueuesPaginator.ts @@ -4,6 +4,9 @@ import { ListQueuesCommand, ListQueuesCommandInput, ListQueuesCommandOutput } fr import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListQueuesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListQueuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListQueuesCommandInput, diff --git a/clients/client-connect/pagination/ListRoutingProfileQueuesPaginator.ts b/clients/client-connect/pagination/ListRoutingProfileQueuesPaginator.ts index 04948ba894d33..cf9226cef9226 100644 --- a/clients/client-connect/pagination/ListRoutingProfileQueuesPaginator.ts +++ b/clients/client-connect/pagination/ListRoutingProfileQueuesPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListRoutingProfileQueuesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRoutingProfileQueuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListRoutingProfileQueuesCommandInput, diff --git a/clients/client-connect/pagination/ListRoutingProfilesPaginator.ts b/clients/client-connect/pagination/ListRoutingProfilesPaginator.ts index 22c762623cb49..5c3694cdc7da4 100644 --- a/clients/client-connect/pagination/ListRoutingProfilesPaginator.ts +++ b/clients/client-connect/pagination/ListRoutingProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListRoutingProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRoutingProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListRoutingProfilesCommandInput, diff --git a/clients/client-connect/pagination/ListSecurityProfilesPaginator.ts b/clients/client-connect/pagination/ListSecurityProfilesPaginator.ts index 522679277d57f..8b75e72e62d26 100644 --- a/clients/client-connect/pagination/ListSecurityProfilesPaginator.ts +++ b/clients/client-connect/pagination/ListSecurityProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListSecurityProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSecurityProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListSecurityProfilesCommandInput, diff --git a/clients/client-connect/pagination/ListUserHierarchyGroupsPaginator.ts b/clients/client-connect/pagination/ListUserHierarchyGroupsPaginator.ts index 24630d4a82fe0..c9a57e149b80a 100644 --- a/clients/client-connect/pagination/ListUserHierarchyGroupsPaginator.ts +++ b/clients/client-connect/pagination/ListUserHierarchyGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListUserHierarchyGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUserHierarchyGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListUserHierarchyGroupsCommandInput, diff --git a/clients/client-connect/pagination/ListUsersPaginator.ts b/clients/client-connect/pagination/ListUsersPaginator.ts index 2cc94748628b8..a75c74c727b2f 100644 --- a/clients/client-connect/pagination/ListUsersPaginator.ts +++ b/clients/client-connect/pagination/ListUsersPaginator.ts @@ -4,6 +4,9 @@ import { ListUsersCommand, ListUsersCommandInput, ListUsersCommandOutput } from import { ConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectClient, input: ListUsersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Connect, input: ListUsersCommandInput, diff --git a/clients/client-connect/runtimeConfig.browser.ts b/clients/client-connect/runtimeConfig.browser.ts index a81acb88d56c0..fbc326f9313aa 100644 --- a/clients/client-connect/runtimeConfig.browser.ts +++ b/clients/client-connect/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ConnectClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-connect/runtimeConfig.native.ts b/clients/client-connect/runtimeConfig.native.ts index ae32873e9d97d..b3dab48b2ae7a 100644 --- a/clients/client-connect/runtimeConfig.native.ts +++ b/clients/client-connect/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ConnectClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-connect/runtimeConfig.shared.ts b/clients/client-connect/runtimeConfig.shared.ts index a9dea73385fef..ced69eb979c7b 100644 --- a/clients/client-connect/runtimeConfig.shared.ts +++ b/clients/client-connect/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-08-08", disableHostPrefix: false, diff --git a/clients/client-connect/runtimeConfig.ts b/clients/client-connect/runtimeConfig.ts index 9ee8205ad0154..49f908e3a2769 100644 --- a/clients/client-connect/runtimeConfig.ts +++ b/clients/client-connect/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ConnectClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-connect/tsconfig.json b/clients/client-connect/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-connect/tsconfig.json +++ b/clients/client-connect/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-connectparticipant/commands/CreateParticipantConnectionCommand.ts b/clients/client-connectparticipant/commands/CreateParticipantConnectionCommand.ts index 349eda25e6dfb..5792c23c4f096 100644 --- a/clients/client-connectparticipant/commands/CreateParticipantConnectionCommand.ts +++ b/clients/client-connectparticipant/commands/CreateParticipantConnectionCommand.ts @@ -24,6 +24,25 @@ import { export type CreateParticipantConnectionCommandInput = CreateParticipantConnectionRequest; export type CreateParticipantConnectionCommandOutput = CreateParticipantConnectionResponse & __MetadataBearer; +/** + *

Creates the participant's connection. Note that ParticipantToken is used for invoking + * this API instead of ConnectionToken.

+ *

The participant token is valid for the lifetime of the participant – until the they + * are part of a contact.

+ *

The response URL for WEBSOCKET Type has a connect expiry timeout of 100s. Clients must + * manually connect to the returned websocket URL and subscribe to the desired topic.

+ *

For + * chat, you need to publish the following on the established websocket connection:

+ * + * + *

+ * {"topic":"aws/subscribe","content":{"topics":["aws/chat"]}} + *

+ * + *

Upon websocket URL expiry, as + * specified in the response ConnectionExpiry parameter, clients need to call this API + * again to obtain a new websocket URL and perform the same steps as before.

+ */ export class CreateParticipantConnectionCommand extends $Command< CreateParticipantConnectionCommandInput, CreateParticipantConnectionCommandOutput, @@ -38,6 +57,9 @@ export class CreateParticipantConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectParticipantClientResolvedConfig, diff --git a/clients/client-connectparticipant/commands/DisconnectParticipantCommand.ts b/clients/client-connectparticipant/commands/DisconnectParticipantCommand.ts index 8a6d17b86ec05..fe4bcadf5f7a3 100644 --- a/clients/client-connectparticipant/commands/DisconnectParticipantCommand.ts +++ b/clients/client-connectparticipant/commands/DisconnectParticipantCommand.ts @@ -24,6 +24,10 @@ import { export type DisconnectParticipantCommandInput = DisconnectParticipantRequest; export type DisconnectParticipantCommandOutput = DisconnectParticipantResponse & __MetadataBearer; +/** + *

Disconnects a participant. Note that ConnectionToken is used for invoking this API + * instead of ParticipantToken.

+ */ export class DisconnectParticipantCommand extends $Command< DisconnectParticipantCommandInput, DisconnectParticipantCommandOutput, @@ -38,6 +42,9 @@ export class DisconnectParticipantCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectParticipantClientResolvedConfig, diff --git a/clients/client-connectparticipant/commands/GetTranscriptCommand.ts b/clients/client-connectparticipant/commands/GetTranscriptCommand.ts index 380740aaae5db..701c38bbf68be 100644 --- a/clients/client-connectparticipant/commands/GetTranscriptCommand.ts +++ b/clients/client-connectparticipant/commands/GetTranscriptCommand.ts @@ -24,6 +24,10 @@ import { export type GetTranscriptCommandInput = GetTranscriptRequest; export type GetTranscriptCommandOutput = GetTranscriptResponse & __MetadataBearer; +/** + *

Retrieves a transcript of the session. Note that ConnectionToken is used for invoking + * this API instead of ParticipantToken.

+ */ export class GetTranscriptCommand extends $Command< GetTranscriptCommandInput, GetTranscriptCommandOutput, @@ -38,6 +42,9 @@ export class GetTranscriptCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectParticipantClientResolvedConfig, diff --git a/clients/client-connectparticipant/commands/SendEventCommand.ts b/clients/client-connectparticipant/commands/SendEventCommand.ts index 8ff66eaf4bea5..fb9cdab60311f 100644 --- a/clients/client-connectparticipant/commands/SendEventCommand.ts +++ b/clients/client-connectparticipant/commands/SendEventCommand.ts @@ -24,6 +24,10 @@ import { export type SendEventCommandInput = SendEventRequest; export type SendEventCommandOutput = SendEventResponse & __MetadataBearer; +/** + *

Sends an event. Note that ConnectionToken is used for invoking this API instead of + * ParticipantToken.

+ */ export class SendEventCommand extends $Command< SendEventCommandInput, SendEventCommandOutput, @@ -38,6 +42,9 @@ export class SendEventCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectParticipantClientResolvedConfig, diff --git a/clients/client-connectparticipant/commands/SendMessageCommand.ts b/clients/client-connectparticipant/commands/SendMessageCommand.ts index 7c34f558c1783..ea211f321672d 100644 --- a/clients/client-connectparticipant/commands/SendMessageCommand.ts +++ b/clients/client-connectparticipant/commands/SendMessageCommand.ts @@ -24,6 +24,10 @@ import { export type SendMessageCommandInput = SendMessageRequest; export type SendMessageCommandOutput = SendMessageResponse & __MetadataBearer; +/** + *

Sends a message. Note that ConnectionToken is used for invoking this API instead of + * ParticipantToken.

+ */ export class SendMessageCommand extends $Command< SendMessageCommandInput, SendMessageCommandOutput, @@ -38,6 +42,9 @@ export class SendMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ConnectParticipantClientResolvedConfig, diff --git a/clients/client-connectparticipant/package.json b/clients/client-connectparticipant/package.json index 22575f27fc243..b9889962b39d3 100644 --- a/clients/client-connectparticipant/package.json +++ b/clients/client-connectparticipant/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Connectparticipant Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-connectparticipant/pagination/GetTranscriptPaginator.ts b/clients/client-connectparticipant/pagination/GetTranscriptPaginator.ts index 4845256ae8d59..feccb402ac93e 100644 --- a/clients/client-connectparticipant/pagination/GetTranscriptPaginator.ts +++ b/clients/client-connectparticipant/pagination/GetTranscriptPaginator.ts @@ -8,6 +8,9 @@ import { import { ConnectParticipantPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ConnectParticipantClient, input: GetTranscriptCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTranscriptCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ConnectParticipant, input: GetTranscriptCommandInput, diff --git a/clients/client-connectparticipant/runtimeConfig.browser.ts b/clients/client-connectparticipant/runtimeConfig.browser.ts index f0f97bec052e7..96a8a9804916f 100644 --- a/clients/client-connectparticipant/runtimeConfig.browser.ts +++ b/clients/client-connectparticipant/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ConnectParticipantClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-connectparticipant/runtimeConfig.native.ts b/clients/client-connectparticipant/runtimeConfig.native.ts index 9f96f421b8e2c..8db6b6e6a5afc 100644 --- a/clients/client-connectparticipant/runtimeConfig.native.ts +++ b/clients/client-connectparticipant/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ConnectParticipantClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-connectparticipant/runtimeConfig.shared.ts b/clients/client-connectparticipant/runtimeConfig.shared.ts index b41e3ad2a38cc..e0499b826959a 100644 --- a/clients/client-connectparticipant/runtimeConfig.shared.ts +++ b/clients/client-connectparticipant/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-09-07", disableHostPrefix: false, diff --git a/clients/client-connectparticipant/runtimeConfig.ts b/clients/client-connectparticipant/runtimeConfig.ts index 94e371e778ad9..3369c8941a800 100644 --- a/clients/client-connectparticipant/runtimeConfig.ts +++ b/clients/client-connectparticipant/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ConnectParticipantClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-connectparticipant/tsconfig.json b/clients/client-connectparticipant/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-connectparticipant/tsconfig.json +++ b/clients/client-connectparticipant/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cost-and-usage-report-service/commands/DeleteReportDefinitionCommand.ts b/clients/client-cost-and-usage-report-service/commands/DeleteReportDefinitionCommand.ts index dc01808291fb4..c4b733b50ff18 100644 --- a/clients/client-cost-and-usage-report-service/commands/DeleteReportDefinitionCommand.ts +++ b/clients/client-cost-and-usage-report-service/commands/DeleteReportDefinitionCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteReportDefinitionCommandInput = DeleteReportDefinitionRequest; export type DeleteReportDefinitionCommandOutput = DeleteReportDefinitionResponse & __MetadataBearer; +/** + *

Deletes the specified report.

+ */ export class DeleteReportDefinitionCommand extends $Command< DeleteReportDefinitionCommandInput, DeleteReportDefinitionCommandOutput, @@ -38,6 +41,9 @@ export class DeleteReportDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostAndUsageReportServiceClientResolvedConfig, diff --git a/clients/client-cost-and-usage-report-service/commands/DescribeReportDefinitionsCommand.ts b/clients/client-cost-and-usage-report-service/commands/DescribeReportDefinitionsCommand.ts index f4715be77ace3..22a1523cad9a8 100644 --- a/clients/client-cost-and-usage-report-service/commands/DescribeReportDefinitionsCommand.ts +++ b/clients/client-cost-and-usage-report-service/commands/DescribeReportDefinitionsCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeReportDefinitionsCommandInput = DescribeReportDefinitionsRequest; export type DescribeReportDefinitionsCommandOutput = DescribeReportDefinitionsResponse & __MetadataBearer; +/** + *

Lists the AWS Cost and Usage reports available to this account.

+ */ export class DescribeReportDefinitionsCommand extends $Command< DescribeReportDefinitionsCommandInput, DescribeReportDefinitionsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeReportDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostAndUsageReportServiceClientResolvedConfig, diff --git a/clients/client-cost-and-usage-report-service/commands/ModifyReportDefinitionCommand.ts b/clients/client-cost-and-usage-report-service/commands/ModifyReportDefinitionCommand.ts index b2d36434e59ac..204f9cf8d1fdc 100644 --- a/clients/client-cost-and-usage-report-service/commands/ModifyReportDefinitionCommand.ts +++ b/clients/client-cost-and-usage-report-service/commands/ModifyReportDefinitionCommand.ts @@ -24,6 +24,9 @@ import { export type ModifyReportDefinitionCommandInput = ModifyReportDefinitionRequest; export type ModifyReportDefinitionCommandOutput = ModifyReportDefinitionResponse & __MetadataBearer; +/** + *

Allows you to programatically update your report preferences.

+ */ export class ModifyReportDefinitionCommand extends $Command< ModifyReportDefinitionCommandInput, ModifyReportDefinitionCommandOutput, @@ -38,6 +41,9 @@ export class ModifyReportDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostAndUsageReportServiceClientResolvedConfig, diff --git a/clients/client-cost-and-usage-report-service/commands/PutReportDefinitionCommand.ts b/clients/client-cost-and-usage-report-service/commands/PutReportDefinitionCommand.ts index d28a5702e6ed1..fef792768dd0b 100644 --- a/clients/client-cost-and-usage-report-service/commands/PutReportDefinitionCommand.ts +++ b/clients/client-cost-and-usage-report-service/commands/PutReportDefinitionCommand.ts @@ -24,6 +24,9 @@ import { export type PutReportDefinitionCommandInput = PutReportDefinitionRequest; export type PutReportDefinitionCommandOutput = PutReportDefinitionResponse & __MetadataBearer; +/** + *

Creates a new report using the description that you provide.

+ */ export class PutReportDefinitionCommand extends $Command< PutReportDefinitionCommandInput, PutReportDefinitionCommandOutput, @@ -38,6 +41,9 @@ export class PutReportDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostAndUsageReportServiceClientResolvedConfig, diff --git a/clients/client-cost-and-usage-report-service/package.json b/clients/client-cost-and-usage-report-service/package.json index 8e1dde0be047d..30606af8c684a 100644 --- a/clients/client-cost-and-usage-report-service/package.json +++ b/clients/client-cost-and-usage-report-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cost And Usage Report Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cost-and-usage-report-service/pagination/DescribeReportDefinitionsPaginator.ts b/clients/client-cost-and-usage-report-service/pagination/DescribeReportDefinitionsPaginator.ts index b2c8b0e4e958b..09bf17122d536 100644 --- a/clients/client-cost-and-usage-report-service/pagination/DescribeReportDefinitionsPaginator.ts +++ b/clients/client-cost-and-usage-report-service/pagination/DescribeReportDefinitionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CostAndUsageReportServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CostAndUsageReportServiceClient, input: DescribeReportDefinitionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReportDefinitionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CostAndUsageReportService, input: DescribeReportDefinitionsCommandInput, diff --git a/clients/client-cost-and-usage-report-service/runtimeConfig.browser.ts b/clients/client-cost-and-usage-report-service/runtimeConfig.browser.ts index c5e137dc94537..796cf591696c4 100644 --- a/clients/client-cost-and-usage-report-service/runtimeConfig.browser.ts +++ b/clients/client-cost-and-usage-report-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CostAndUsageReportServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cost-and-usage-report-service/runtimeConfig.native.ts b/clients/client-cost-and-usage-report-service/runtimeConfig.native.ts index 37b4e6e6845d7..d92776d084ff6 100644 --- a/clients/client-cost-and-usage-report-service/runtimeConfig.native.ts +++ b/clients/client-cost-and-usage-report-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CostAndUsageReportServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cost-and-usage-report-service/runtimeConfig.shared.ts b/clients/client-cost-and-usage-report-service/runtimeConfig.shared.ts index 79f7596f1c032..317d48ead6f9a 100644 --- a/clients/client-cost-and-usage-report-service/runtimeConfig.shared.ts +++ b/clients/client-cost-and-usage-report-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-01-06", disableHostPrefix: false, diff --git a/clients/client-cost-and-usage-report-service/runtimeConfig.ts b/clients/client-cost-and-usage-report-service/runtimeConfig.ts index 191a1d5d25164..d96a57092627b 100644 --- a/clients/client-cost-and-usage-report-service/runtimeConfig.ts +++ b/clients/client-cost-and-usage-report-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CostAndUsageReportServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cost-and-usage-report-service/tsconfig.json b/clients/client-cost-and-usage-report-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cost-and-usage-report-service/tsconfig.json +++ b/clients/client-cost-and-usage-report-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-cost-explorer/commands/CreateAnomalyMonitorCommand.ts b/clients/client-cost-explorer/commands/CreateAnomalyMonitorCommand.ts index 99799410ca69f..7818adba0d5d7 100644 --- a/clients/client-cost-explorer/commands/CreateAnomalyMonitorCommand.ts +++ b/clients/client-cost-explorer/commands/CreateAnomalyMonitorCommand.ts @@ -20,6 +20,10 @@ import { export type CreateAnomalyMonitorCommandInput = CreateAnomalyMonitorRequest; export type CreateAnomalyMonitorCommandOutput = CreateAnomalyMonitorResponse & __MetadataBearer; +/** + *

Creates a new cost anomaly detection monitor with the requested type and monitor + * specification.

+ */ export class CreateAnomalyMonitorCommand extends $Command< CreateAnomalyMonitorCommandInput, CreateAnomalyMonitorCommandOutput, @@ -34,6 +38,9 @@ export class CreateAnomalyMonitorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/CreateAnomalySubscriptionCommand.ts b/clients/client-cost-explorer/commands/CreateAnomalySubscriptionCommand.ts index 592255ba332a0..5766169705ebb 100644 --- a/clients/client-cost-explorer/commands/CreateAnomalySubscriptionCommand.ts +++ b/clients/client-cost-explorer/commands/CreateAnomalySubscriptionCommand.ts @@ -20,6 +20,11 @@ import { export type CreateAnomalySubscriptionCommandInput = CreateAnomalySubscriptionRequest; export type CreateAnomalySubscriptionCommandOutput = CreateAnomalySubscriptionResponse & __MetadataBearer; +/** + *

Adds a subscription to a cost anomaly detection monitor. You can use each subscription to + * define subscribers with email or SNS notifications. Email subscribers can set a dollar + * threshold and a time frequency for receiving notifications.

+ */ export class CreateAnomalySubscriptionCommand extends $Command< CreateAnomalySubscriptionCommandInput, CreateAnomalySubscriptionCommandOutput, @@ -34,6 +39,9 @@ export class CreateAnomalySubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/CreateCostCategoryDefinitionCommand.ts b/clients/client-cost-explorer/commands/CreateCostCategoryDefinitionCommand.ts index 993e6de56a30b..299e95d75f523 100644 --- a/clients/client-cost-explorer/commands/CreateCostCategoryDefinitionCommand.ts +++ b/clients/client-cost-explorer/commands/CreateCostCategoryDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateCostCategoryDefinitionCommandInput = CreateCostCategoryDefinitionRequest; export type CreateCostCategoryDefinitionCommandOutput = CreateCostCategoryDefinitionResponse & __MetadataBearer; +/** + *

Creates a new Cost Category with the requested name and rules.

+ */ export class CreateCostCategoryDefinitionCommand extends $Command< CreateCostCategoryDefinitionCommandInput, CreateCostCategoryDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateCostCategoryDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/DeleteAnomalyMonitorCommand.ts b/clients/client-cost-explorer/commands/DeleteAnomalyMonitorCommand.ts index 73e7f88d2943f..ad3054b2774d6 100644 --- a/clients/client-cost-explorer/commands/DeleteAnomalyMonitorCommand.ts +++ b/clients/client-cost-explorer/commands/DeleteAnomalyMonitorCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAnomalyMonitorCommandInput = DeleteAnomalyMonitorRequest; export type DeleteAnomalyMonitorCommandOutput = DeleteAnomalyMonitorResponse & __MetadataBearer; +/** + *

Deletes a cost anomaly monitor.

+ */ export class DeleteAnomalyMonitorCommand extends $Command< DeleteAnomalyMonitorCommandInput, DeleteAnomalyMonitorCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAnomalyMonitorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/DeleteAnomalySubscriptionCommand.ts b/clients/client-cost-explorer/commands/DeleteAnomalySubscriptionCommand.ts index d8719abb78db7..09c20d63c6b4e 100644 --- a/clients/client-cost-explorer/commands/DeleteAnomalySubscriptionCommand.ts +++ b/clients/client-cost-explorer/commands/DeleteAnomalySubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAnomalySubscriptionCommandInput = DeleteAnomalySubscriptionRequest; export type DeleteAnomalySubscriptionCommandOutput = DeleteAnomalySubscriptionResponse & __MetadataBearer; +/** + *

Deletes a cost anomaly subscription.

+ */ export class DeleteAnomalySubscriptionCommand extends $Command< DeleteAnomalySubscriptionCommandInput, DeleteAnomalySubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAnomalySubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/DeleteCostCategoryDefinitionCommand.ts b/clients/client-cost-explorer/commands/DeleteCostCategoryDefinitionCommand.ts index e8ef62d2461f0..2adb6f25a2750 100644 --- a/clients/client-cost-explorer/commands/DeleteCostCategoryDefinitionCommand.ts +++ b/clients/client-cost-explorer/commands/DeleteCostCategoryDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCostCategoryDefinitionCommandInput = DeleteCostCategoryDefinitionRequest; export type DeleteCostCategoryDefinitionCommandOutput = DeleteCostCategoryDefinitionResponse & __MetadataBearer; +/** + *

Deletes a Cost Category. Expenses from this month going forward will no longer be categorized with this Cost Category.

+ */ export class DeleteCostCategoryDefinitionCommand extends $Command< DeleteCostCategoryDefinitionCommandInput, DeleteCostCategoryDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCostCategoryDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/DescribeCostCategoryDefinitionCommand.ts b/clients/client-cost-explorer/commands/DescribeCostCategoryDefinitionCommand.ts index 80b9e29baa243..ad0caba1c4b38 100644 --- a/clients/client-cost-explorer/commands/DescribeCostCategoryDefinitionCommand.ts +++ b/clients/client-cost-explorer/commands/DescribeCostCategoryDefinitionCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeCostCategoryDefinitionCommandInput = DescribeCostCategoryDefinitionRequest; export type DescribeCostCategoryDefinitionCommandOutput = DescribeCostCategoryDefinitionResponse & __MetadataBearer; +/** + *

Returns the name, ARN, rules, definition, and effective dates of a Cost Category that's defined in the account.

+ *

You have the option to use EffectiveOn to return a Cost Category that is active on a specific date. If there is no EffectiveOn specified, you’ll see a Cost Category that is effective on the current date. If Cost Category is still effective, EffectiveEnd is omitted in the response.

+ */ export class DescribeCostCategoryDefinitionCommand extends $Command< DescribeCostCategoryDefinitionCommandInput, DescribeCostCategoryDefinitionCommandOutput, @@ -34,6 +38,9 @@ export class DescribeCostCategoryDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetAnomaliesCommand.ts b/clients/client-cost-explorer/commands/GetAnomaliesCommand.ts index 7b3442894c3b2..17a6f17cb0b54 100644 --- a/clients/client-cost-explorer/commands/GetAnomaliesCommand.ts +++ b/clients/client-cost-explorer/commands/GetAnomaliesCommand.ts @@ -20,6 +20,10 @@ import { export type GetAnomaliesCommandInput = GetAnomaliesRequest; export type GetAnomaliesCommandOutput = GetAnomaliesResponse & __MetadataBearer; +/** + *

Retrieves all of the cost anomalies detected on your account, during the time period + * specified by the DateInterval object.

+ */ export class GetAnomaliesCommand extends $Command< GetAnomaliesCommandInput, GetAnomaliesCommandOutput, @@ -34,6 +38,9 @@ export class GetAnomaliesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetAnomalyMonitorsCommand.ts b/clients/client-cost-explorer/commands/GetAnomalyMonitorsCommand.ts index a018364c67bb3..3ee85771b4b89 100644 --- a/clients/client-cost-explorer/commands/GetAnomalyMonitorsCommand.ts +++ b/clients/client-cost-explorer/commands/GetAnomalyMonitorsCommand.ts @@ -20,6 +20,10 @@ import { export type GetAnomalyMonitorsCommandInput = GetAnomalyMonitorsRequest; export type GetAnomalyMonitorsCommandOutput = GetAnomalyMonitorsResponse & __MetadataBearer; +/** + *

Retrieves the cost anomaly monitor definitions for your account. You can filter using a + * list of cost anomaly monitor Amazon Resource Names (ARNs).

+ */ export class GetAnomalyMonitorsCommand extends $Command< GetAnomalyMonitorsCommandInput, GetAnomalyMonitorsCommandOutput, @@ -34,6 +38,9 @@ export class GetAnomalyMonitorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetAnomalySubscriptionsCommand.ts b/clients/client-cost-explorer/commands/GetAnomalySubscriptionsCommand.ts index 96ff4496fe7eb..1530dfab0590b 100644 --- a/clients/client-cost-explorer/commands/GetAnomalySubscriptionsCommand.ts +++ b/clients/client-cost-explorer/commands/GetAnomalySubscriptionsCommand.ts @@ -20,6 +20,10 @@ import { export type GetAnomalySubscriptionsCommandInput = GetAnomalySubscriptionsRequest; export type GetAnomalySubscriptionsCommandOutput = GetAnomalySubscriptionsResponse & __MetadataBearer; +/** + *

Retrieves the cost anomaly subscription objects for your account. You can filter using a + * list of cost anomaly monitor Amazon Resource Names (ARNs).

+ */ export class GetAnomalySubscriptionsCommand extends $Command< GetAnomalySubscriptionsCommandInput, GetAnomalySubscriptionsCommandOutput, @@ -34,6 +38,9 @@ export class GetAnomalySubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetCostAndUsageCommand.ts b/clients/client-cost-explorer/commands/GetCostAndUsageCommand.ts index 67752b62419e3..890b356a9e24f 100644 --- a/clients/client-cost-explorer/commands/GetCostAndUsageCommand.ts +++ b/clients/client-cost-explorer/commands/GetCostAndUsageCommand.ts @@ -20,6 +20,14 @@ import { export type GetCostAndUsageCommandInput = GetCostAndUsageRequest; export type GetCostAndUsageCommandOutput = GetCostAndUsageResponse & __MetadataBearer; +/** + *

Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric, such as + * BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group + * your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list + * of valid dimensions, see the + * GetDimensionValues + * operation. Master account in an organization in AWS Organizations have access to all member accounts.

+ */ export class GetCostAndUsageCommand extends $Command< GetCostAndUsageCommandInput, GetCostAndUsageCommandOutput, @@ -34,6 +42,9 @@ export class GetCostAndUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetCostAndUsageWithResourcesCommand.ts b/clients/client-cost-explorer/commands/GetCostAndUsageWithResourcesCommand.ts index 45fcce2d204c5..3d796acab496b 100644 --- a/clients/client-cost-explorer/commands/GetCostAndUsageWithResourcesCommand.ts +++ b/clients/client-cost-explorer/commands/GetCostAndUsageWithResourcesCommand.ts @@ -20,6 +20,17 @@ import { export type GetCostAndUsageWithResourcesCommandInput = GetCostAndUsageWithResourcesRequest; export type GetCostAndUsageWithResourcesCommandOutput = GetCostAndUsageWithResourcesResponse & __MetadataBearer; +/** + *

Retrieves cost and usage metrics with resources for your account. You can specify which cost and + * usage-related metric, such as BlendedCosts or UsageQuantity, that + * you want the request to return. You can also filter and group your data by various dimensions, + * such as SERVICE or AZ, in a specific time range. For a complete list + * of valid dimensions, see the GetDimensionValues operation. Master account in an organization in AWS + * Organizations have access to all member accounts. This API is currently available for the Amazon Elastic Compute Cloud – Compute service only.

+ * + *

This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information on how to access the Settings page, see Controlling Access for Cost Explorer in the AWS Billing and Cost Management User Guide.

+ *
+ */ export class GetCostAndUsageWithResourcesCommand extends $Command< GetCostAndUsageWithResourcesCommandInput, GetCostAndUsageWithResourcesCommandOutput, @@ -34,6 +45,9 @@ export class GetCostAndUsageWithResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetCostForecastCommand.ts b/clients/client-cost-explorer/commands/GetCostForecastCommand.ts index d4ae88f887eaa..3122df039ff34 100644 --- a/clients/client-cost-explorer/commands/GetCostForecastCommand.ts +++ b/clients/client-cost-explorer/commands/GetCostForecastCommand.ts @@ -20,6 +20,9 @@ import { export type GetCostForecastCommandInput = GetCostForecastRequest; export type GetCostForecastCommandOutput = GetCostForecastResponse & __MetadataBearer; +/** + *

Retrieves a forecast for how much Amazon Web Services predicts that you will spend over the forecast time period that you select, based on your past costs.

+ */ export class GetCostForecastCommand extends $Command< GetCostForecastCommandInput, GetCostForecastCommandOutput, @@ -34,6 +37,9 @@ export class GetCostForecastCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetDimensionValuesCommand.ts b/clients/client-cost-explorer/commands/GetDimensionValuesCommand.ts index 64c107f1254b2..01e997f3778d0 100644 --- a/clients/client-cost-explorer/commands/GetDimensionValuesCommand.ts +++ b/clients/client-cost-explorer/commands/GetDimensionValuesCommand.ts @@ -20,6 +20,9 @@ import { export type GetDimensionValuesCommandInput = GetDimensionValuesRequest; export type GetDimensionValuesCommandOutput = GetDimensionValuesResponse & __MetadataBearer; +/** + *

Retrieves all available filter values for a specified filter over a period of time. You can search the dimension values for an arbitrary string.

+ */ export class GetDimensionValuesCommand extends $Command< GetDimensionValuesCommandInput, GetDimensionValuesCommandOutput, @@ -34,6 +37,9 @@ export class GetDimensionValuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetReservationCoverageCommand.ts b/clients/client-cost-explorer/commands/GetReservationCoverageCommand.ts index 6a32f34eb4ead..54327461709d8 100644 --- a/clients/client-cost-explorer/commands/GetReservationCoverageCommand.ts +++ b/clients/client-cost-explorer/commands/GetReservationCoverageCommand.ts @@ -20,6 +20,50 @@ import { export type GetReservationCoverageCommandInput = GetReservationCoverageRequest; export type GetReservationCoverageCommandOutput = GetReservationCoverageResponse & __MetadataBearer; +/** + *

Retrieves the reservation coverage for your account. This enables you to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service, or + * Amazon Redshift usage is covered by a reservation. An organization's master account can see the coverage of the associated member accounts. This supports dimensions, Cost Categories, and nested expressions. + * For any time period, you can filter data about reservation usage by the following dimensions:

+ *
    + *
  • + *

    AZ

    + *
  • + *
  • + *

    CACHE_ENGINE

    + *
  • + *
  • + *

    DATABASE_ENGINE

    + *
  • + *
  • + *

    DEPLOYMENT_OPTION

    + *
  • + *
  • + *

    INSTANCE_TYPE

    + *
  • + *
  • + *

    LINKED_ACCOUNT

    + *
  • + *
  • + *

    OPERATING_SYSTEM

    + *
  • + *
  • + *

    PLATFORM

    + *
  • + *
  • + *

    REGION

    + *
  • + *
  • + *

    SERVICE

    + *
  • + *
  • + *

    TAG

    + *
  • + *
  • + *

    TENANCY

    + *
  • + *
+ *

To determine valid values for a dimension, use the GetDimensionValues operation.

+ */ export class GetReservationCoverageCommand extends $Command< GetReservationCoverageCommandInput, GetReservationCoverageCommandOutput, @@ -34,6 +78,9 @@ export class GetReservationCoverageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetReservationPurchaseRecommendationCommand.ts b/clients/client-cost-explorer/commands/GetReservationPurchaseRecommendationCommand.ts index 8a6ce47c5d9ee..aef0abf51eeac 100644 --- a/clients/client-cost-explorer/commands/GetReservationPurchaseRecommendationCommand.ts +++ b/clients/client-cost-explorer/commands/GetReservationPurchaseRecommendationCommand.ts @@ -24,6 +24,18 @@ export type GetReservationPurchaseRecommendationCommandInput = GetReservationPur export type GetReservationPurchaseRecommendationCommandOutput = GetReservationPurchaseRecommendationResponse & __MetadataBearer; +/** + *

Gets recommendations for which reservations to purchase. These recommendations could help you reduce your costs. + * Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.

+ *

AWS generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage + * into categories that are eligible for a reservation. After AWS has these categories, it simulates every combination of reservations + * in each category of usage to identify the best number of each type of RI to purchase to maximize your estimated savings.

+ *

For example, AWS automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region + * and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. AWS recommends the smallest size instance + * in an instance family. This makes it easier to purchase a size-flexible RI. AWS also shows the equal number of normalized units + * so that you can purchase any instance size that you want. For this example, your RI recommendation would be for c4.large + * because that is the smallest size instance in the c4 instance family.

+ */ export class GetReservationPurchaseRecommendationCommand extends $Command< GetReservationPurchaseRecommendationCommandInput, GetReservationPurchaseRecommendationCommandOutput, @@ -38,6 +50,9 @@ export class GetReservationPurchaseRecommendationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetReservationUtilizationCommand.ts b/clients/client-cost-explorer/commands/GetReservationUtilizationCommand.ts index ac06f3fccfa87..c77a4b35696ed 100644 --- a/clients/client-cost-explorer/commands/GetReservationUtilizationCommand.ts +++ b/clients/client-cost-explorer/commands/GetReservationUtilizationCommand.ts @@ -20,6 +20,11 @@ import { export type GetReservationUtilizationCommandInput = GetReservationUtilizationRequest; export type GetReservationUtilizationCommandOutput = GetReservationUtilizationResponse & __MetadataBearer; +/** + *

Retrieves the reservation utilization for your account. Master account in an organization have access to member accounts. + * You can filter data by dimensions in a time period. You can use GetDimensionValues to determine the possible + * dimension values. Currently, you can group only by SUBSCRIPTION_ID.

+ */ export class GetReservationUtilizationCommand extends $Command< GetReservationUtilizationCommandInput, GetReservationUtilizationCommandOutput, @@ -34,6 +39,9 @@ export class GetReservationUtilizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetRightsizingRecommendationCommand.ts b/clients/client-cost-explorer/commands/GetRightsizingRecommendationCommand.ts index 5c1521cfdb6a2..1950bd8bcb033 100644 --- a/clients/client-cost-explorer/commands/GetRightsizingRecommendationCommand.ts +++ b/clients/client-cost-explorer/commands/GetRightsizingRecommendationCommand.ts @@ -20,6 +20,18 @@ import { export type GetRightsizingRecommendationCommandInput = GetRightsizingRecommendationRequest; export type GetRightsizingRecommendationCommandOutput = GetRightsizingRecommendationResponse & __MetadataBearer; +/** + *

Creates recommendations that + * help you save cost + * by identifying idle and underutilized Amazon EC2 instances.

+ *

Recommendations are generated to either downsize or terminate instances, along with + * providing savings detail and metrics. For details on calculation and function, see + * Optimizing + * Your Cost with Rightsizing + * Recommendations + * in the AWS Billing and Cost Management User + * Guide.

+ */ export class GetRightsizingRecommendationCommand extends $Command< GetRightsizingRecommendationCommandInput, GetRightsizingRecommendationCommandOutput, @@ -34,6 +46,9 @@ export class GetRightsizingRecommendationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetSavingsPlansCoverageCommand.ts b/clients/client-cost-explorer/commands/GetSavingsPlansCoverageCommand.ts index f5f502dda47c9..c83d2ad0ad5a9 100644 --- a/clients/client-cost-explorer/commands/GetSavingsPlansCoverageCommand.ts +++ b/clients/client-cost-explorer/commands/GetSavingsPlansCoverageCommand.ts @@ -20,6 +20,32 @@ import { export type GetSavingsPlansCoverageCommandInput = GetSavingsPlansCoverageRequest; export type GetSavingsPlansCoverageCommandOutput = GetSavingsPlansCoverageResponse & __MetadataBearer; +/** + *

Retrieves the Savings Plans covered for your account. This enables you to see how much of your cost is covered by a Savings Plan. An organization’s master account can see the coverage of the associated member accounts. This supports dimensions, Cost Categories, and nested expressions. For any time period, you can filter data for Savings Plans usage with the following dimensions:

+ *
    + *
  • + *

    + * LINKED_ACCOUNT + *

    + *
  • + *
  • + *

    + * REGION + *

    + *
  • + *
  • + *

    + * SERVICE + *

    + *
  • + *
  • + *

    + * INSTANCE_FAMILY + *

    + *
  • + *
+ *

To determine valid values for a dimension, use the GetDimensionValues operation.

+ */ export class GetSavingsPlansCoverageCommand extends $Command< GetSavingsPlansCoverageCommandInput, GetSavingsPlansCoverageCommandOutput, @@ -34,6 +60,9 @@ export class GetSavingsPlansCoverageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetSavingsPlansPurchaseRecommendationCommand.ts b/clients/client-cost-explorer/commands/GetSavingsPlansPurchaseRecommendationCommand.ts index 5763edd4af488..54fc92329ac07 100644 --- a/clients/client-cost-explorer/commands/GetSavingsPlansPurchaseRecommendationCommand.ts +++ b/clients/client-cost-explorer/commands/GetSavingsPlansPurchaseRecommendationCommand.ts @@ -24,6 +24,9 @@ export type GetSavingsPlansPurchaseRecommendationCommandInput = GetSavingsPlansP export type GetSavingsPlansPurchaseRecommendationCommandOutput = GetSavingsPlansPurchaseRecommendationResponse & __MetadataBearer; +/** + *

Retrieves your request parameters, Savings Plan Recommendations Summary and Details.

+ */ export class GetSavingsPlansPurchaseRecommendationCommand extends $Command< GetSavingsPlansPurchaseRecommendationCommandInput, GetSavingsPlansPurchaseRecommendationCommandOutput, @@ -38,6 +41,9 @@ export class GetSavingsPlansPurchaseRecommendationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetSavingsPlansUtilizationCommand.ts b/clients/client-cost-explorer/commands/GetSavingsPlansUtilizationCommand.ts index 668b883f6304d..d73e7a6322fad 100644 --- a/clients/client-cost-explorer/commands/GetSavingsPlansUtilizationCommand.ts +++ b/clients/client-cost-explorer/commands/GetSavingsPlansUtilizationCommand.ts @@ -20,6 +20,12 @@ import { export type GetSavingsPlansUtilizationCommandInput = GetSavingsPlansUtilizationRequest; export type GetSavingsPlansUtilizationCommandOutput = GetSavingsPlansUtilizationResponse & __MetadataBearer; +/** + *

Retrieves the Savings Plans utilization for your account across date ranges with daily or monthly granularity. Master account in an organization have access to member accounts. You can use GetDimensionValues in SAVINGS_PLANS to determine the possible dimension values.

+ * + *

You cannot group by any dimension values for GetSavingsPlansUtilization.

+ *
+ */ export class GetSavingsPlansUtilizationCommand extends $Command< GetSavingsPlansUtilizationCommandInput, GetSavingsPlansUtilizationCommandOutput, @@ -34,6 +40,9 @@ export class GetSavingsPlansUtilizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetSavingsPlansUtilizationDetailsCommand.ts b/clients/client-cost-explorer/commands/GetSavingsPlansUtilizationDetailsCommand.ts index 6ed66813b9518..58766d5a3adb6 100644 --- a/clients/client-cost-explorer/commands/GetSavingsPlansUtilizationDetailsCommand.ts +++ b/clients/client-cost-explorer/commands/GetSavingsPlansUtilizationDetailsCommand.ts @@ -24,6 +24,13 @@ export type GetSavingsPlansUtilizationDetailsCommandInput = GetSavingsPlansUtili export type GetSavingsPlansUtilizationDetailsCommandOutput = GetSavingsPlansUtilizationDetailsResponse & __MetadataBearer; +/** + *

Retrieves attribute data along with aggregate utilization and savings data for a given time period. This doesn't support granular or grouped data (daily/monthly) in response. You can't retrieve data by dates in a single response similar to GetSavingsPlanUtilization, but you have the option to make multiple calls to GetSavingsPlanUtilizationDetails by providing individual dates. You can use GetDimensionValues in SAVINGS_PLANS to determine the possible dimension values.

+ * + *

+ * GetSavingsPlanUtilizationDetails internally groups data by SavingsPlansArn.

+ *
+ */ export class GetSavingsPlansUtilizationDetailsCommand extends $Command< GetSavingsPlansUtilizationDetailsCommandInput, GetSavingsPlansUtilizationDetailsCommandOutput, @@ -38,6 +45,9 @@ export class GetSavingsPlansUtilizationDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetTagsCommand.ts b/clients/client-cost-explorer/commands/GetTagsCommand.ts index 8974eb4ddac5d..f9094ff7d5ae3 100644 --- a/clients/client-cost-explorer/commands/GetTagsCommand.ts +++ b/clients/client-cost-explorer/commands/GetTagsCommand.ts @@ -17,6 +17,9 @@ import { export type GetTagsCommandInput = GetTagsRequest; export type GetTagsCommandOutput = GetTagsResponse & __MetadataBearer; +/** + *

Queries for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.

+ */ export class GetTagsCommand extends $Command< GetTagsCommandInput, GetTagsCommandOutput, @@ -31,6 +34,9 @@ export class GetTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/GetUsageForecastCommand.ts b/clients/client-cost-explorer/commands/GetUsageForecastCommand.ts index ac2a73cc3d579..04d1c1b023815 100644 --- a/clients/client-cost-explorer/commands/GetUsageForecastCommand.ts +++ b/clients/client-cost-explorer/commands/GetUsageForecastCommand.ts @@ -20,6 +20,9 @@ import { export type GetUsageForecastCommandInput = GetUsageForecastRequest; export type GetUsageForecastCommandOutput = GetUsageForecastResponse & __MetadataBearer; +/** + *

Retrieves a forecast for how much Amazon Web Services predicts that you will use over the forecast time period that you select, based on your past usage.

+ */ export class GetUsageForecastCommand extends $Command< GetUsageForecastCommandInput, GetUsageForecastCommandOutput, @@ -34,6 +37,9 @@ export class GetUsageForecastCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/ListCostCategoryDefinitionsCommand.ts b/clients/client-cost-explorer/commands/ListCostCategoryDefinitionsCommand.ts index 015610ec14e2e..7df23bbc36533 100644 --- a/clients/client-cost-explorer/commands/ListCostCategoryDefinitionsCommand.ts +++ b/clients/client-cost-explorer/commands/ListCostCategoryDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListCostCategoryDefinitionsCommandInput = ListCostCategoryDefinitionsRequest; export type ListCostCategoryDefinitionsCommandOutput = ListCostCategoryDefinitionsResponse & __MetadataBearer; +/** + *

Returns the name, ARN, NumberOfRules and effective dates of all Cost Categories defined in the account. You have the option to use EffectiveOn to return a list of Cost Categories that were active on a specific date. If there is no EffectiveOn specified, you’ll see Cost Categories that are effective on the current date. If Cost Category is still effective, EffectiveEnd is omitted in the response. ListCostCategoryDefinitions supports pagination. The request can have a MaxResults range up to 100.

+ */ export class ListCostCategoryDefinitionsCommand extends $Command< ListCostCategoryDefinitionsCommandInput, ListCostCategoryDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListCostCategoryDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/ProvideAnomalyFeedbackCommand.ts b/clients/client-cost-explorer/commands/ProvideAnomalyFeedbackCommand.ts index cdbf50026816c..8057f106bd6a5 100644 --- a/clients/client-cost-explorer/commands/ProvideAnomalyFeedbackCommand.ts +++ b/clients/client-cost-explorer/commands/ProvideAnomalyFeedbackCommand.ts @@ -20,6 +20,9 @@ import { export type ProvideAnomalyFeedbackCommandInput = ProvideAnomalyFeedbackRequest; export type ProvideAnomalyFeedbackCommandOutput = ProvideAnomalyFeedbackResponse & __MetadataBearer; +/** + *

Modifies the feedback property of a given cost anomaly.

+ */ export class ProvideAnomalyFeedbackCommand extends $Command< ProvideAnomalyFeedbackCommandInput, ProvideAnomalyFeedbackCommandOutput, @@ -34,6 +37,9 @@ export class ProvideAnomalyFeedbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/UpdateAnomalyMonitorCommand.ts b/clients/client-cost-explorer/commands/UpdateAnomalyMonitorCommand.ts index 8e37e4768d1fe..96c4c847bc01d 100644 --- a/clients/client-cost-explorer/commands/UpdateAnomalyMonitorCommand.ts +++ b/clients/client-cost-explorer/commands/UpdateAnomalyMonitorCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateAnomalyMonitorCommandInput = UpdateAnomalyMonitorRequest; export type UpdateAnomalyMonitorCommandOutput = UpdateAnomalyMonitorResponse & __MetadataBearer; +/** + *

Updates an existing cost anomaly monitor. The changes made are applied going forward, and + * does not change anomalies detected in the past.

+ */ export class UpdateAnomalyMonitorCommand extends $Command< UpdateAnomalyMonitorCommandInput, UpdateAnomalyMonitorCommandOutput, @@ -34,6 +38,9 @@ export class UpdateAnomalyMonitorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/UpdateAnomalySubscriptionCommand.ts b/clients/client-cost-explorer/commands/UpdateAnomalySubscriptionCommand.ts index 9702e9b445fae..7dbcbc4a6f74b 100644 --- a/clients/client-cost-explorer/commands/UpdateAnomalySubscriptionCommand.ts +++ b/clients/client-cost-explorer/commands/UpdateAnomalySubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAnomalySubscriptionCommandInput = UpdateAnomalySubscriptionRequest; export type UpdateAnomalySubscriptionCommandOutput = UpdateAnomalySubscriptionResponse & __MetadataBearer; +/** + *

Updates an existing cost anomaly monitor subscription.

+ */ export class UpdateAnomalySubscriptionCommand extends $Command< UpdateAnomalySubscriptionCommandInput, UpdateAnomalySubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAnomalySubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/commands/UpdateCostCategoryDefinitionCommand.ts b/clients/client-cost-explorer/commands/UpdateCostCategoryDefinitionCommand.ts index 8e6932aeab938..83b35408b40f9 100644 --- a/clients/client-cost-explorer/commands/UpdateCostCategoryDefinitionCommand.ts +++ b/clients/client-cost-explorer/commands/UpdateCostCategoryDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateCostCategoryDefinitionCommandInput = UpdateCostCategoryDefinitionRequest; export type UpdateCostCategoryDefinitionCommandOutput = UpdateCostCategoryDefinitionResponse & __MetadataBearer; +/** + *

Updates an existing Cost Category. Changes made to the Cost Category rules will be used to categorize the current month’s expenses and future expenses. This won’t change categorization for the previous months.

+ */ export class UpdateCostCategoryDefinitionCommand extends $Command< UpdateCostCategoryDefinitionCommandInput, UpdateCostCategoryDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateCostCategoryDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: CostExplorerClientResolvedConfig, diff --git a/clients/client-cost-explorer/package.json b/clients/client-cost-explorer/package.json index 713263797ed58..e4033f2640302 100644 --- a/clients/client-cost-explorer/package.json +++ b/clients/client-cost-explorer/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Cost Explorer Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-cost-explorer/pagination/GetSavingsPlansCoveragePaginator.ts b/clients/client-cost-explorer/pagination/GetSavingsPlansCoveragePaginator.ts index 2b042d99aa59b..74d786f400ca1 100644 --- a/clients/client-cost-explorer/pagination/GetSavingsPlansCoveragePaginator.ts +++ b/clients/client-cost-explorer/pagination/GetSavingsPlansCoveragePaginator.ts @@ -8,6 +8,9 @@ import { import { CostExplorerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CostExplorerClient, input: GetSavingsPlansCoverageCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSavingsPlansCoverageCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CostExplorer, input: GetSavingsPlansCoverageCommandInput, diff --git a/clients/client-cost-explorer/pagination/GetSavingsPlansUtilizationDetailsPaginator.ts b/clients/client-cost-explorer/pagination/GetSavingsPlansUtilizationDetailsPaginator.ts index ee3126811f10e..4d55bb23bfe0f 100644 --- a/clients/client-cost-explorer/pagination/GetSavingsPlansUtilizationDetailsPaginator.ts +++ b/clients/client-cost-explorer/pagination/GetSavingsPlansUtilizationDetailsPaginator.ts @@ -8,6 +8,9 @@ import { import { CostExplorerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CostExplorerClient, input: GetSavingsPlansUtilizationDetailsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSavingsPlansUtilizationDetailsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CostExplorer, input: GetSavingsPlansUtilizationDetailsCommandInput, diff --git a/clients/client-cost-explorer/pagination/ListCostCategoryDefinitionsPaginator.ts b/clients/client-cost-explorer/pagination/ListCostCategoryDefinitionsPaginator.ts index 67e60aa3d5060..83af8f52b8856 100644 --- a/clients/client-cost-explorer/pagination/ListCostCategoryDefinitionsPaginator.ts +++ b/clients/client-cost-explorer/pagination/ListCostCategoryDefinitionsPaginator.ts @@ -8,6 +8,9 @@ import { import { CostExplorerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: CostExplorerClient, input: ListCostCategoryDefinitionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCostCategoryDefinitionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: CostExplorer, input: ListCostCategoryDefinitionsCommandInput, diff --git a/clients/client-cost-explorer/runtimeConfig.browser.ts b/clients/client-cost-explorer/runtimeConfig.browser.ts index 6b92e32b991af..53f9d83198d7d 100644 --- a/clients/client-cost-explorer/runtimeConfig.browser.ts +++ b/clients/client-cost-explorer/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./CostExplorerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-cost-explorer/runtimeConfig.native.ts b/clients/client-cost-explorer/runtimeConfig.native.ts index 672f5d053a293..76c2d7c94281a 100644 --- a/clients/client-cost-explorer/runtimeConfig.native.ts +++ b/clients/client-cost-explorer/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./CostExplorerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-cost-explorer/runtimeConfig.shared.ts b/clients/client-cost-explorer/runtimeConfig.shared.ts index 07c221de93812..da10d1fcb0f32 100644 --- a/clients/client-cost-explorer/runtimeConfig.shared.ts +++ b/clients/client-cost-explorer/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-25", disableHostPrefix: false, diff --git a/clients/client-cost-explorer/runtimeConfig.ts b/clients/client-cost-explorer/runtimeConfig.ts index 628e98cfbbb8d..56a478efe7867 100644 --- a/clients/client-cost-explorer/runtimeConfig.ts +++ b/clients/client-cost-explorer/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./CostExplorerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-cost-explorer/tsconfig.json b/clients/client-cost-explorer/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-cost-explorer/tsconfig.json +++ b/clients/client-cost-explorer/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-data-pipeline/commands/ActivatePipelineCommand.ts b/clients/client-data-pipeline/commands/ActivatePipelineCommand.ts index aa6287179c967..97c3538d24c57 100644 --- a/clients/client-data-pipeline/commands/ActivatePipelineCommand.ts +++ b/clients/client-data-pipeline/commands/ActivatePipelineCommand.ts @@ -20,6 +20,13 @@ import { export type ActivatePipelineCommandInput = ActivatePipelineInput; export type ActivatePipelineCommandOutput = ActivatePipelineOutput & __MetadataBearer; +/** + *

Validates the specified pipeline and starts processing pipeline tasks. If the pipeline does not pass validation, activation fails.

+ *

If you need to pause the pipeline to investigate an issue with a component, such as a data source or script, + * call DeactivatePipeline.

+ *

To activate a finished pipeline, modify the end date for the pipeline and then activate it.

+ *

If you activate an on-demand pipeline that is already running, it will cancel all running objects and re-run the pipeline. StartTimestamp does not apply to on-demand pipelines.

+ */ export class ActivatePipelineCommand extends $Command< ActivatePipelineCommandInput, ActivatePipelineCommandOutput, @@ -34,6 +41,9 @@ export class ActivatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/AddTagsCommand.ts b/clients/client-data-pipeline/commands/AddTagsCommand.ts index 454959631c60b..8a9d17f941eba 100644 --- a/clients/client-data-pipeline/commands/AddTagsCommand.ts +++ b/clients/client-data-pipeline/commands/AddTagsCommand.ts @@ -17,6 +17,9 @@ import { export type AddTagsCommandInput = AddTagsInput; export type AddTagsCommandOutput = AddTagsOutput & __MetadataBearer; +/** + *

Adds or modifies tags for the specified pipeline.

+ */ export class AddTagsCommand extends $Command< AddTagsCommandInput, AddTagsCommandOutput, @@ -31,6 +34,9 @@ export class AddTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/CreatePipelineCommand.ts b/clients/client-data-pipeline/commands/CreatePipelineCommand.ts index e518e0115de4a..1ce13bd140192 100644 --- a/clients/client-data-pipeline/commands/CreatePipelineCommand.ts +++ b/clients/client-data-pipeline/commands/CreatePipelineCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePipelineCommandInput = CreatePipelineInput; export type CreatePipelineCommandOutput = CreatePipelineOutput & __MetadataBearer; +/** + *

Creates a new, empty pipeline. Use PutPipelineDefinition to populate the pipeline.

+ */ export class CreatePipelineCommand extends $Command< CreatePipelineCommandInput, CreatePipelineCommandOutput, @@ -34,6 +37,9 @@ export class CreatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/DeactivatePipelineCommand.ts b/clients/client-data-pipeline/commands/DeactivatePipelineCommand.ts index 6c94e76cb9e0d..6a216ff61209a 100644 --- a/clients/client-data-pipeline/commands/DeactivatePipelineCommand.ts +++ b/clients/client-data-pipeline/commands/DeactivatePipelineCommand.ts @@ -20,6 +20,12 @@ import { export type DeactivatePipelineCommandInput = DeactivatePipelineInput; export type DeactivatePipelineCommandOutput = DeactivatePipelineOutput & __MetadataBearer; +/** + *

Deactivates the specified running pipeline. The pipeline is set to the DEACTIVATING + * state until the deactivation process completes.

+ *

To resume a deactivated pipeline, use ActivatePipeline. By default, the pipeline resumes from the last completed execution. + * Optionally, you can specify the date and time to resume the pipeline.

+ */ export class DeactivatePipelineCommand extends $Command< DeactivatePipelineCommandInput, DeactivatePipelineCommandOutput, @@ -34,6 +40,9 @@ export class DeactivatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/DeletePipelineCommand.ts b/clients/client-data-pipeline/commands/DeletePipelineCommand.ts index 90ab97cbf2b6c..e34c478cf0ba1 100644 --- a/clients/client-data-pipeline/commands/DeletePipelineCommand.ts +++ b/clients/client-data-pipeline/commands/DeletePipelineCommand.ts @@ -20,6 +20,12 @@ import { export type DeletePipelineCommandInput = DeletePipelineInput; export type DeletePipelineCommandOutput = __MetadataBearer; +/** + *

Deletes a pipeline, its pipeline definition, and its run history. AWS Data Pipeline attempts to cancel instances associated with the pipeline that are currently being processed by task runners.

+ *

Deleting a pipeline cannot be undone. You cannot query or restore a deleted pipeline. + * To temporarily pause a pipeline instead of deleting it, call SetStatus with the status set to PAUSE on individual components. + * Components that are paused by SetStatus can be resumed.

+ */ export class DeletePipelineCommand extends $Command< DeletePipelineCommandInput, DeletePipelineCommandOutput, @@ -34,6 +40,9 @@ export class DeletePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/DescribeObjectsCommand.ts b/clients/client-data-pipeline/commands/DescribeObjectsCommand.ts index a956026b17838..1b4d85bd7bcb6 100644 --- a/clients/client-data-pipeline/commands/DescribeObjectsCommand.ts +++ b/clients/client-data-pipeline/commands/DescribeObjectsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeObjectsCommandInput = DescribeObjectsInput; export type DescribeObjectsCommandOutput = DescribeObjectsOutput & __MetadataBearer; +/** + *

Gets the object definitions for a set of objects associated with the pipeline. Object definitions are composed of a set of fields that define the properties of the object.

+ */ export class DescribeObjectsCommand extends $Command< DescribeObjectsCommandInput, DescribeObjectsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeObjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/DescribePipelinesCommand.ts b/clients/client-data-pipeline/commands/DescribePipelinesCommand.ts index e2d84efe97877..8e6851f58f907 100644 --- a/clients/client-data-pipeline/commands/DescribePipelinesCommand.ts +++ b/clients/client-data-pipeline/commands/DescribePipelinesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribePipelinesCommandInput = DescribePipelinesInput; export type DescribePipelinesCommandOutput = DescribePipelinesOutput & __MetadataBearer; +/** + *

Retrieves metadata about one or more pipelines. The information retrieved includes the name of the pipeline, the pipeline identifier, its current state, and the user account that owns the pipeline. Using account credentials, you can retrieve metadata about pipelines that you or your IAM users have created. If you are using an IAM user account, you can retrieve metadata about only those pipelines for which you have read permissions.

+ *

To retrieve the full pipeline definition instead of metadata about the pipeline, call GetPipelineDefinition.

+ */ export class DescribePipelinesCommand extends $Command< DescribePipelinesCommandInput, DescribePipelinesCommandOutput, @@ -34,6 +38,9 @@ export class DescribePipelinesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/EvaluateExpressionCommand.ts b/clients/client-data-pipeline/commands/EvaluateExpressionCommand.ts index 7697e7e2b2486..db7eb27a5d46d 100644 --- a/clients/client-data-pipeline/commands/EvaluateExpressionCommand.ts +++ b/clients/client-data-pipeline/commands/EvaluateExpressionCommand.ts @@ -20,6 +20,10 @@ import { export type EvaluateExpressionCommandInput = EvaluateExpressionInput; export type EvaluateExpressionCommandOutput = EvaluateExpressionOutput & __MetadataBearer; +/** + *

Task runners call EvaluateExpression to evaluate a string in the context of the specified object. + * For example, a task runner can evaluate SQL queries stored in Amazon S3.

+ */ export class EvaluateExpressionCommand extends $Command< EvaluateExpressionCommandInput, EvaluateExpressionCommandOutput, @@ -34,6 +38,9 @@ export class EvaluateExpressionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/GetPipelineDefinitionCommand.ts b/clients/client-data-pipeline/commands/GetPipelineDefinitionCommand.ts index 9abbb38b7c432..d29af6a69956e 100644 --- a/clients/client-data-pipeline/commands/GetPipelineDefinitionCommand.ts +++ b/clients/client-data-pipeline/commands/GetPipelineDefinitionCommand.ts @@ -20,6 +20,10 @@ import { export type GetPipelineDefinitionCommandInput = GetPipelineDefinitionInput; export type GetPipelineDefinitionCommandOutput = GetPipelineDefinitionOutput & __MetadataBearer; +/** + *

Gets the definition of the specified pipeline. You can call GetPipelineDefinition to retrieve + * the pipeline definition that you provided using PutPipelineDefinition.

+ */ export class GetPipelineDefinitionCommand extends $Command< GetPipelineDefinitionCommandInput, GetPipelineDefinitionCommandOutput, @@ -34,6 +38,9 @@ export class GetPipelineDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/ListPipelinesCommand.ts b/clients/client-data-pipeline/commands/ListPipelinesCommand.ts index 95cfe7e3e247e..361f27e5a7692 100644 --- a/clients/client-data-pipeline/commands/ListPipelinesCommand.ts +++ b/clients/client-data-pipeline/commands/ListPipelinesCommand.ts @@ -20,6 +20,9 @@ import { export type ListPipelinesCommandInput = ListPipelinesInput; export type ListPipelinesCommandOutput = ListPipelinesOutput & __MetadataBearer; +/** + *

Lists the pipeline identifiers for all active pipelines that you have permission to access.

+ */ export class ListPipelinesCommand extends $Command< ListPipelinesCommandInput, ListPipelinesCommandOutput, @@ -34,6 +37,9 @@ export class ListPipelinesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/PollForTaskCommand.ts b/clients/client-data-pipeline/commands/PollForTaskCommand.ts index f03b94c3912c3..20b1eb3ae1ef6 100644 --- a/clients/client-data-pipeline/commands/PollForTaskCommand.ts +++ b/clients/client-data-pipeline/commands/PollForTaskCommand.ts @@ -20,6 +20,17 @@ import { export type PollForTaskCommandInput = PollForTaskInput; export type PollForTaskCommandOutput = PollForTaskOutput & __MetadataBearer; +/** + *

Task runners call PollForTask to receive a task to perform from AWS Data Pipeline. The task runner specifies which tasks it can perform + * by setting a value for the workerGroup parameter. The task returned can come from any of the pipelines that + * match the workerGroup value passed in by the task runner and that was launched using the IAM user credentials + * specified by the task runner.

+ *

If tasks are ready in the work queue, PollForTask returns a response immediately. If no tasks are available in the queue, + * PollForTask uses long-polling and holds on to a poll connection for up to a 90 seconds, during which time the first newly + * scheduled task is handed to the task runner. To accomodate this, set the socket timeout in your task runner to 90 seconds. The task + * runner should not call PollForTask again on the same workerGroup until it receives a response, and this can take up to 90 seconds. + *

+ */ export class PollForTaskCommand extends $Command< PollForTaskCommandInput, PollForTaskCommandOutput, @@ -34,6 +45,9 @@ export class PollForTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/PutPipelineDefinitionCommand.ts b/clients/client-data-pipeline/commands/PutPipelineDefinitionCommand.ts index 26f0a686a5057..5491d3dde5c6b 100644 --- a/clients/client-data-pipeline/commands/PutPipelineDefinitionCommand.ts +++ b/clients/client-data-pipeline/commands/PutPipelineDefinitionCommand.ts @@ -20,6 +20,30 @@ import { export type PutPipelineDefinitionCommandInput = PutPipelineDefinitionInput; export type PutPipelineDefinitionCommandOutput = PutPipelineDefinitionOutput & __MetadataBearer; +/** + *

Adds tasks, schedules, and preconditions to the specified pipeline. You can use PutPipelineDefinition to populate a new pipeline.

+ *

+ * PutPipelineDefinition also validates the configuration as it adds it to the pipeline. Changes to the pipeline are saved unless one + * of the following validation errors exist in the pipeline. + *

+ *
    + *
  1. + *

    An object is missing a name or identifier field.

    + *
  2. + *
  3. + *

    A string or reference field is empty.

    + *
  4. + *
  5. + *

    The number of objects in the pipeline exceeds the allowed maximum number of objects.

    + *
  6. + *
  7. + *

    The pipeline is in a FINISHED state.

    + *
  8. + *
+ *

+ * Pipeline object definitions are passed to the PutPipelineDefinition action and returned by the GetPipelineDefinition action. + *

+ */ export class PutPipelineDefinitionCommand extends $Command< PutPipelineDefinitionCommandInput, PutPipelineDefinitionCommandOutput, @@ -34,6 +58,9 @@ export class PutPipelineDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/QueryObjectsCommand.ts b/clients/client-data-pipeline/commands/QueryObjectsCommand.ts index c7deccf4d3445..3f32603bc29b4 100644 --- a/clients/client-data-pipeline/commands/QueryObjectsCommand.ts +++ b/clients/client-data-pipeline/commands/QueryObjectsCommand.ts @@ -20,6 +20,9 @@ import { export type QueryObjectsCommandInput = QueryObjectsInput; export type QueryObjectsCommandOutput = QueryObjectsOutput & __MetadataBearer; +/** + *

Queries the specified pipeline for the names of objects that match the specified set of conditions.

+ */ export class QueryObjectsCommand extends $Command< QueryObjectsCommandInput, QueryObjectsCommandOutput, @@ -34,6 +37,9 @@ export class QueryObjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/RemoveTagsCommand.ts b/clients/client-data-pipeline/commands/RemoveTagsCommand.ts index 2e0f1c7a63eda..227c1694cad69 100644 --- a/clients/client-data-pipeline/commands/RemoveTagsCommand.ts +++ b/clients/client-data-pipeline/commands/RemoveTagsCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveTagsCommandInput = RemoveTagsInput; export type RemoveTagsCommandOutput = RemoveTagsOutput & __MetadataBearer; +/** + *

Removes existing tags from the specified pipeline.

+ */ export class RemoveTagsCommand extends $Command< RemoveTagsCommandInput, RemoveTagsCommandOutput, @@ -34,6 +37,9 @@ export class RemoveTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/ReportTaskProgressCommand.ts b/clients/client-data-pipeline/commands/ReportTaskProgressCommand.ts index ba10c80b8779b..6da8af6169d04 100644 --- a/clients/client-data-pipeline/commands/ReportTaskProgressCommand.ts +++ b/clients/client-data-pipeline/commands/ReportTaskProgressCommand.ts @@ -20,6 +20,12 @@ import { export type ReportTaskProgressCommandInput = ReportTaskProgressInput; export type ReportTaskProgressCommandOutput = ReportTaskProgressOutput & __MetadataBearer; +/** + *

Task runners call ReportTaskProgress when assigned a task to acknowledge that it has the task. If the web service does not + * receive this acknowledgement within 2 minutes, it assigns the task in a subsequent PollForTask call. After this initial acknowledgement, + * the task runner only needs to report progress every 15 minutes to maintain its ownership of the task. You can change this reporting time + * from 15 minutes by specifying a reportProgressTimeout field in your pipeline.

+ */ export class ReportTaskProgressCommand extends $Command< ReportTaskProgressCommandInput, ReportTaskProgressCommandOutput, @@ -34,6 +40,9 @@ export class ReportTaskProgressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/ReportTaskRunnerHeartbeatCommand.ts b/clients/client-data-pipeline/commands/ReportTaskRunnerHeartbeatCommand.ts index a88d5267ef459..105b2f4029aaf 100644 --- a/clients/client-data-pipeline/commands/ReportTaskRunnerHeartbeatCommand.ts +++ b/clients/client-data-pipeline/commands/ReportTaskRunnerHeartbeatCommand.ts @@ -20,6 +20,11 @@ import { export type ReportTaskRunnerHeartbeatCommandInput = ReportTaskRunnerHeartbeatInput; export type ReportTaskRunnerHeartbeatCommandOutput = ReportTaskRunnerHeartbeatOutput & __MetadataBearer; +/** + *

Task runners call ReportTaskRunnerHeartbeat every 15 minutes to indicate that they are operational. + * If the AWS Data Pipeline Task Runner is launched on a resource managed by AWS Data Pipeline, the web service can use + * this call to detect when the task runner application has failed and restart a new instance.

+ */ export class ReportTaskRunnerHeartbeatCommand extends $Command< ReportTaskRunnerHeartbeatCommandInput, ReportTaskRunnerHeartbeatCommandOutput, @@ -34,6 +39,9 @@ export class ReportTaskRunnerHeartbeatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/SetStatusCommand.ts b/clients/client-data-pipeline/commands/SetStatusCommand.ts index 0fe0eb2aa2638..76d68c23cab84 100644 --- a/clients/client-data-pipeline/commands/SetStatusCommand.ts +++ b/clients/client-data-pipeline/commands/SetStatusCommand.ts @@ -17,6 +17,11 @@ import { export type SetStatusCommandInput = SetStatusInput; export type SetStatusCommandOutput = __MetadataBearer; +/** + *

Requests that the status of the specified physical or logical pipeline objects be updated in the specified pipeline. + * This update might not occur immediately, but is eventually consistent. The status that can be set depends on the type of object (for example, DataNode or Activity). + * You cannot perform this operation on FINISHED pipelines and attempting to do so returns InvalidRequestException.

+ */ export class SetStatusCommand extends $Command< SetStatusCommandInput, SetStatusCommandOutput, @@ -31,6 +36,9 @@ export class SetStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/SetTaskStatusCommand.ts b/clients/client-data-pipeline/commands/SetTaskStatusCommand.ts index a1337c42ad9e3..17ad6f5ada4d5 100644 --- a/clients/client-data-pipeline/commands/SetTaskStatusCommand.ts +++ b/clients/client-data-pipeline/commands/SetTaskStatusCommand.ts @@ -20,6 +20,11 @@ import { export type SetTaskStatusCommandInput = SetTaskStatusInput; export type SetTaskStatusCommandOutput = SetTaskStatusOutput & __MetadataBearer; +/** + *

Task runners call SetTaskStatus to notify AWS Data Pipeline that a task is completed and provide information about the final status. + * A task runner makes this call regardless of whether the task was sucessful. A task runner does not need to call SetTaskStatus for + * tasks that are canceled by the web service during a call to ReportTaskProgress.

+ */ export class SetTaskStatusCommand extends $Command< SetTaskStatusCommandInput, SetTaskStatusCommandOutput, @@ -34,6 +39,9 @@ export class SetTaskStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/commands/ValidatePipelineDefinitionCommand.ts b/clients/client-data-pipeline/commands/ValidatePipelineDefinitionCommand.ts index 67285b6a52898..6c86e23b324fa 100644 --- a/clients/client-data-pipeline/commands/ValidatePipelineDefinitionCommand.ts +++ b/clients/client-data-pipeline/commands/ValidatePipelineDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type ValidatePipelineDefinitionCommandInput = ValidatePipelineDefinitionInput; export type ValidatePipelineDefinitionCommandOutput = ValidatePipelineDefinitionOutput & __MetadataBearer; +/** + *

Validates the specified pipeline definition to ensure that it is well formed and can be run without error.

+ */ export class ValidatePipelineDefinitionCommand extends $Command< ValidatePipelineDefinitionCommandInput, ValidatePipelineDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class ValidatePipelineDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataPipelineClientResolvedConfig, diff --git a/clients/client-data-pipeline/package.json b/clients/client-data-pipeline/package.json index b6d861335dc89..b062195283c0b 100644 --- a/clients/client-data-pipeline/package.json +++ b/clients/client-data-pipeline/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Data Pipeline Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-data-pipeline/pagination/DescribeObjectsPaginator.ts b/clients/client-data-pipeline/pagination/DescribeObjectsPaginator.ts index b6a79e7c654de..be41fef4d84c2 100644 --- a/clients/client-data-pipeline/pagination/DescribeObjectsPaginator.ts +++ b/clients/client-data-pipeline/pagination/DescribeObjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataPipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataPipelineClient, input: DescribeObjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeObjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataPipeline, input: DescribeObjectsCommandInput, diff --git a/clients/client-data-pipeline/pagination/ListPipelinesPaginator.ts b/clients/client-data-pipeline/pagination/ListPipelinesPaginator.ts index 25aeb6ed436b6..cb929ee8ac9e2 100644 --- a/clients/client-data-pipeline/pagination/ListPipelinesPaginator.ts +++ b/clients/client-data-pipeline/pagination/ListPipelinesPaginator.ts @@ -8,6 +8,9 @@ import { import { DataPipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataPipelineClient, input: ListPipelinesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPipelinesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataPipeline, input: ListPipelinesCommandInput, diff --git a/clients/client-data-pipeline/pagination/QueryObjectsPaginator.ts b/clients/client-data-pipeline/pagination/QueryObjectsPaginator.ts index 6b4d2189275da..4259bbb054787 100644 --- a/clients/client-data-pipeline/pagination/QueryObjectsPaginator.ts +++ b/clients/client-data-pipeline/pagination/QueryObjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataPipelinePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataPipelineClient, input: QueryObjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new QueryObjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataPipeline, input: QueryObjectsCommandInput, diff --git a/clients/client-data-pipeline/runtimeConfig.browser.ts b/clients/client-data-pipeline/runtimeConfig.browser.ts index 9b310780c0d34..be57a4936bbfa 100644 --- a/clients/client-data-pipeline/runtimeConfig.browser.ts +++ b/clients/client-data-pipeline/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DataPipelineClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-data-pipeline/runtimeConfig.native.ts b/clients/client-data-pipeline/runtimeConfig.native.ts index 6f09ffe4895cf..d29208f6198c2 100644 --- a/clients/client-data-pipeline/runtimeConfig.native.ts +++ b/clients/client-data-pipeline/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DataPipelineClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-data-pipeline/runtimeConfig.shared.ts b/clients/client-data-pipeline/runtimeConfig.shared.ts index 3b6dde69221de..5d615499d402a 100644 --- a/clients/client-data-pipeline/runtimeConfig.shared.ts +++ b/clients/client-data-pipeline/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-10-29", disableHostPrefix: false, diff --git a/clients/client-data-pipeline/runtimeConfig.ts b/clients/client-data-pipeline/runtimeConfig.ts index b972bc12da3b1..b3bde8d16c6c7 100644 --- a/clients/client-data-pipeline/runtimeConfig.ts +++ b/clients/client-data-pipeline/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DataPipelineClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-data-pipeline/tsconfig.json b/clients/client-data-pipeline/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-data-pipeline/tsconfig.json +++ b/clients/client-data-pipeline/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-database-migration-service/commands/AddTagsToResourceCommand.ts b/clients/client-database-migration-service/commands/AddTagsToResourceCommand.ts index e6fe051c2fd4f..05685be63bd5f 100644 --- a/clients/client-database-migration-service/commands/AddTagsToResourceCommand.ts +++ b/clients/client-database-migration-service/commands/AddTagsToResourceCommand.ts @@ -24,6 +24,14 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceMessage; export type AddTagsToResourceCommandOutput = AddTagsToResourceResponse & __MetadataBearer; +/** + *

Adds metadata tags to an AWS DMS resource, including replication instance, endpoint, + * security group, and migration task. These tags can also be used with cost allocation + * reporting to track cost associated with DMS resources, or used in a Condition statement in + * an IAM policy for DMS. For more information, see + * Tag + * data type description.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -38,6 +46,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ApplyPendingMaintenanceActionCommand.ts b/clients/client-database-migration-service/commands/ApplyPendingMaintenanceActionCommand.ts index 3f67e4d13d3a4..6563c3026ba15 100644 --- a/clients/client-database-migration-service/commands/ApplyPendingMaintenanceActionCommand.ts +++ b/clients/client-database-migration-service/commands/ApplyPendingMaintenanceActionCommand.ts @@ -24,6 +24,9 @@ import { export type ApplyPendingMaintenanceActionCommandInput = ApplyPendingMaintenanceActionMessage; export type ApplyPendingMaintenanceActionCommandOutput = ApplyPendingMaintenanceActionResponse & __MetadataBearer; +/** + *

Applies a pending maintenance action to a resource (for example, to a replication instance).

+ */ export class ApplyPendingMaintenanceActionCommand extends $Command< ApplyPendingMaintenanceActionCommandInput, ApplyPendingMaintenanceActionCommandOutput, @@ -38,6 +41,9 @@ export class ApplyPendingMaintenanceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/CancelReplicationTaskAssessmentRunCommand.ts b/clients/client-database-migration-service/commands/CancelReplicationTaskAssessmentRunCommand.ts index be5ca22a11f06..a0330a67c14d3 100644 --- a/clients/client-database-migration-service/commands/CancelReplicationTaskAssessmentRunCommand.ts +++ b/clients/client-database-migration-service/commands/CancelReplicationTaskAssessmentRunCommand.ts @@ -28,6 +28,12 @@ export type CancelReplicationTaskAssessmentRunCommandInput = CancelReplicationTa export type CancelReplicationTaskAssessmentRunCommandOutput = CancelReplicationTaskAssessmentRunResponse & __MetadataBearer; +/** + *

Cancels a single premigration assessment run.

+ *

This operation prevents any individual assessments from running if they haven't started + * running. It also attempts to cancel any individual assessments that are currently + * running.

+ */ export class CancelReplicationTaskAssessmentRunCommand extends $Command< CancelReplicationTaskAssessmentRunCommandInput, CancelReplicationTaskAssessmentRunCommandOutput, @@ -42,6 +48,9 @@ export class CancelReplicationTaskAssessmentRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/CreateEndpointCommand.ts b/clients/client-database-migration-service/commands/CreateEndpointCommand.ts index 3ebf51eff7eb5..09bcc31792c17 100644 --- a/clients/client-database-migration-service/commands/CreateEndpointCommand.ts +++ b/clients/client-database-migration-service/commands/CreateEndpointCommand.ts @@ -24,6 +24,9 @@ import { export type CreateEndpointCommandInput = CreateEndpointMessage; export type CreateEndpointCommandOutput = CreateEndpointResponse & __MetadataBearer; +/** + *

Creates an endpoint using the provided settings.

+ */ export class CreateEndpointCommand extends $Command< CreateEndpointCommandInput, CreateEndpointCommandOutput, @@ -38,6 +41,9 @@ export class CreateEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/CreateEventSubscriptionCommand.ts b/clients/client-database-migration-service/commands/CreateEventSubscriptionCommand.ts index fda9c4eec2fc0..a22426a1567a7 100644 --- a/clients/client-database-migration-service/commands/CreateEventSubscriptionCommand.ts +++ b/clients/client-database-migration-service/commands/CreateEventSubscriptionCommand.ts @@ -24,6 +24,24 @@ import { export type CreateEventSubscriptionCommandInput = CreateEventSubscriptionMessage; export type CreateEventSubscriptionCommandOutput = CreateEventSubscriptionResponse & __MetadataBearer; +/** + *

Creates an AWS DMS event notification subscription.

+ *

You can specify the type of source (SourceType) you want to be notified of, + * provide a list of AWS DMS source IDs (SourceIds) that triggers the events, and + * provide a list of event categories (EventCategories) for events you want to be + * notified of. If you specify both the SourceType and SourceIds, + * such as SourceType = replication-instance and SourceIdentifier = + * my-replinstance, you will be notified of all the replication instance events for + * the specified source. If you specify a SourceType but don't specify a + * SourceIdentifier, you receive notice of the events for that source type for + * all your AWS DMS sources. If you don't specify either SourceType nor + * SourceIdentifier, you will be notified of events generated from all AWS DMS + * sources belonging to your customer account.

+ *

For more information about AWS DMS events, see Working with Events and + * Notifications in the AWS Database Migration Service User + * Guide. + *

+ */ export class CreateEventSubscriptionCommand extends $Command< CreateEventSubscriptionCommandInput, CreateEventSubscriptionCommandOutput, @@ -38,6 +56,9 @@ export class CreateEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/CreateReplicationInstanceCommand.ts b/clients/client-database-migration-service/commands/CreateReplicationInstanceCommand.ts index a145e5951ad1d..9743c5b7f1f32 100644 --- a/clients/client-database-migration-service/commands/CreateReplicationInstanceCommand.ts +++ b/clients/client-database-migration-service/commands/CreateReplicationInstanceCommand.ts @@ -24,6 +24,14 @@ import { export type CreateReplicationInstanceCommandInput = CreateReplicationInstanceMessage; export type CreateReplicationInstanceCommandOutput = CreateReplicationInstanceResponse & __MetadataBearer; +/** + *

Creates the replication instance using the specified parameters.

+ *

AWS DMS requires that your account have certain roles with appropriate permissions + * before you can create a replication instance. For information on the required roles, see + * Creating the IAM Roles to Use With the AWS CLI and AWS DMS API. For + * information on the required permissions, see + * IAM Permissions Needed to Use AWS DMS.

+ */ export class CreateReplicationInstanceCommand extends $Command< CreateReplicationInstanceCommandInput, CreateReplicationInstanceCommandOutput, @@ -38,6 +46,9 @@ export class CreateReplicationInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/CreateReplicationSubnetGroupCommand.ts b/clients/client-database-migration-service/commands/CreateReplicationSubnetGroupCommand.ts index c1d0d5709451a..e81cbb3353d20 100644 --- a/clients/client-database-migration-service/commands/CreateReplicationSubnetGroupCommand.ts +++ b/clients/client-database-migration-service/commands/CreateReplicationSubnetGroupCommand.ts @@ -24,6 +24,9 @@ import { export type CreateReplicationSubnetGroupCommandInput = CreateReplicationSubnetGroupMessage; export type CreateReplicationSubnetGroupCommandOutput = CreateReplicationSubnetGroupResponse & __MetadataBearer; +/** + *

Creates a replication subnet group given a list of the subnet IDs in a VPC.

+ */ export class CreateReplicationSubnetGroupCommand extends $Command< CreateReplicationSubnetGroupCommandInput, CreateReplicationSubnetGroupCommandOutput, @@ -38,6 +41,9 @@ export class CreateReplicationSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/CreateReplicationTaskCommand.ts b/clients/client-database-migration-service/commands/CreateReplicationTaskCommand.ts index e116b1dc6f27b..954caf77d3f0a 100644 --- a/clients/client-database-migration-service/commands/CreateReplicationTaskCommand.ts +++ b/clients/client-database-migration-service/commands/CreateReplicationTaskCommand.ts @@ -24,6 +24,9 @@ import { export type CreateReplicationTaskCommandInput = CreateReplicationTaskMessage; export type CreateReplicationTaskCommandOutput = CreateReplicationTaskResponse & __MetadataBearer; +/** + *

Creates a replication task using the specified parameters.

+ */ export class CreateReplicationTaskCommand extends $Command< CreateReplicationTaskCommandInput, CreateReplicationTaskCommandOutput, @@ -38,6 +41,9 @@ export class CreateReplicationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DeleteCertificateCommand.ts b/clients/client-database-migration-service/commands/DeleteCertificateCommand.ts index d950d882e2ba8..9b5b038d050da 100644 --- a/clients/client-database-migration-service/commands/DeleteCertificateCommand.ts +++ b/clients/client-database-migration-service/commands/DeleteCertificateCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteCertificateCommandInput = DeleteCertificateMessage; export type DeleteCertificateCommandOutput = DeleteCertificateResponse & __MetadataBearer; +/** + *

Deletes the specified certificate.

+ */ export class DeleteCertificateCommand extends $Command< DeleteCertificateCommandInput, DeleteCertificateCommandOutput, @@ -38,6 +41,9 @@ export class DeleteCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DeleteConnectionCommand.ts b/clients/client-database-migration-service/commands/DeleteConnectionCommand.ts index 1aa72d96fd097..de58246b53515 100644 --- a/clients/client-database-migration-service/commands/DeleteConnectionCommand.ts +++ b/clients/client-database-migration-service/commands/DeleteConnectionCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteConnectionCommandInput = DeleteConnectionMessage; export type DeleteConnectionCommandOutput = DeleteConnectionResponse & __MetadataBearer; +/** + *

Deletes the connection between a replication instance and an endpoint.

+ */ export class DeleteConnectionCommand extends $Command< DeleteConnectionCommandInput, DeleteConnectionCommandOutput, @@ -38,6 +41,9 @@ export class DeleteConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DeleteEndpointCommand.ts b/clients/client-database-migration-service/commands/DeleteEndpointCommand.ts index 5a888fc85a3c9..5891d1a4559d2 100644 --- a/clients/client-database-migration-service/commands/DeleteEndpointCommand.ts +++ b/clients/client-database-migration-service/commands/DeleteEndpointCommand.ts @@ -24,6 +24,14 @@ import { export type DeleteEndpointCommandInput = DeleteEndpointMessage; export type DeleteEndpointCommandOutput = DeleteEndpointResponse & __MetadataBearer; +/** + *

Deletes the specified endpoint.

+ * + *

All tasks associated with the endpoint must be deleted before you can delete the + * endpoint.

+ *
+ *

+ */ export class DeleteEndpointCommand extends $Command< DeleteEndpointCommandInput, DeleteEndpointCommandOutput, @@ -38,6 +46,9 @@ export class DeleteEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DeleteEventSubscriptionCommand.ts b/clients/client-database-migration-service/commands/DeleteEventSubscriptionCommand.ts index 8324eeb6ffe11..2d40169d84bc2 100644 --- a/clients/client-database-migration-service/commands/DeleteEventSubscriptionCommand.ts +++ b/clients/client-database-migration-service/commands/DeleteEventSubscriptionCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteEventSubscriptionCommandInput = DeleteEventSubscriptionMessage; export type DeleteEventSubscriptionCommandOutput = DeleteEventSubscriptionResponse & __MetadataBearer; +/** + *

Deletes an AWS DMS event subscription.

+ */ export class DeleteEventSubscriptionCommand extends $Command< DeleteEventSubscriptionCommandInput, DeleteEventSubscriptionCommandOutput, @@ -38,6 +41,9 @@ export class DeleteEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DeleteReplicationInstanceCommand.ts b/clients/client-database-migration-service/commands/DeleteReplicationInstanceCommand.ts index 779ada93578b7..67a1ec461afc6 100644 --- a/clients/client-database-migration-service/commands/DeleteReplicationInstanceCommand.ts +++ b/clients/client-database-migration-service/commands/DeleteReplicationInstanceCommand.ts @@ -24,6 +24,14 @@ import { export type DeleteReplicationInstanceCommandInput = DeleteReplicationInstanceMessage; export type DeleteReplicationInstanceCommandOutput = DeleteReplicationInstanceResponse & __MetadataBearer; +/** + *

Deletes the specified replication instance.

+ * + *

You must delete any migration tasks that are associated with the replication instance + * before you can delete it.

+ *
+ *

+ */ export class DeleteReplicationInstanceCommand extends $Command< DeleteReplicationInstanceCommandInput, DeleteReplicationInstanceCommandOutput, @@ -38,6 +46,9 @@ export class DeleteReplicationInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DeleteReplicationSubnetGroupCommand.ts b/clients/client-database-migration-service/commands/DeleteReplicationSubnetGroupCommand.ts index b113574a9ae6a..3c63bf135ba75 100644 --- a/clients/client-database-migration-service/commands/DeleteReplicationSubnetGroupCommand.ts +++ b/clients/client-database-migration-service/commands/DeleteReplicationSubnetGroupCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteReplicationSubnetGroupCommandInput = DeleteReplicationSubnetGroupMessage; export type DeleteReplicationSubnetGroupCommandOutput = DeleteReplicationSubnetGroupResponse & __MetadataBearer; +/** + *

Deletes a subnet group.

+ */ export class DeleteReplicationSubnetGroupCommand extends $Command< DeleteReplicationSubnetGroupCommandInput, DeleteReplicationSubnetGroupCommandOutput, @@ -38,6 +41,9 @@ export class DeleteReplicationSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DeleteReplicationTaskAssessmentRunCommand.ts b/clients/client-database-migration-service/commands/DeleteReplicationTaskAssessmentRunCommand.ts index f302d760874e3..365452cc24fbf 100644 --- a/clients/client-database-migration-service/commands/DeleteReplicationTaskAssessmentRunCommand.ts +++ b/clients/client-database-migration-service/commands/DeleteReplicationTaskAssessmentRunCommand.ts @@ -28,6 +28,12 @@ export type DeleteReplicationTaskAssessmentRunCommandInput = DeleteReplicationTa export type DeleteReplicationTaskAssessmentRunCommandOutput = DeleteReplicationTaskAssessmentRunResponse & __MetadataBearer; +/** + *

Deletes the record of a single premigration assessment run.

+ *

This operation removes all metadata that AWS DMS maintains about this assessment run. + * However, the operation leaves untouched all information about this assessment run that is + * stored in your Amazon S3 bucket.

+ */ export class DeleteReplicationTaskAssessmentRunCommand extends $Command< DeleteReplicationTaskAssessmentRunCommandInput, DeleteReplicationTaskAssessmentRunCommandOutput, @@ -42,6 +48,9 @@ export class DeleteReplicationTaskAssessmentRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DeleteReplicationTaskCommand.ts b/clients/client-database-migration-service/commands/DeleteReplicationTaskCommand.ts index bf57c4f8bce02..3a4440f5af366 100644 --- a/clients/client-database-migration-service/commands/DeleteReplicationTaskCommand.ts +++ b/clients/client-database-migration-service/commands/DeleteReplicationTaskCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteReplicationTaskCommandInput = DeleteReplicationTaskMessage; export type DeleteReplicationTaskCommandOutput = DeleteReplicationTaskResponse & __MetadataBearer; +/** + *

Deletes the specified replication task.

+ */ export class DeleteReplicationTaskCommand extends $Command< DeleteReplicationTaskCommandInput, DeleteReplicationTaskCommandOutput, @@ -38,6 +41,9 @@ export class DeleteReplicationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeAccountAttributesCommand.ts b/clients/client-database-migration-service/commands/DescribeAccountAttributesCommand.ts index d6a5edb2d385f..390208ac9473a 100644 --- a/clients/client-database-migration-service/commands/DescribeAccountAttributesCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeAccountAttributesCommand.ts @@ -24,6 +24,15 @@ import { export type DescribeAccountAttributesCommandInput = DescribeAccountAttributesMessage; export type DescribeAccountAttributesCommandOutput = DescribeAccountAttributesResponse & __MetadataBearer; +/** + *

Lists all of the AWS DMS attributes for a customer account. These attributes include AWS + * DMS quotas for the account and a unique account identifier in a particular DMS region. DMS + * quotas include a list of resource quotas supported by the account, such as the number of + * replication instances allowed. The description for each resource quota, includes the quota + * name, current usage toward that quota, and the quota's maximum value. DMS uses the unique + * account identifier to name each artifact used by DMS in the given region.

+ *

This command does not take any parameters.

+ */ export class DescribeAccountAttributesCommand extends $Command< DescribeAccountAttributesCommandInput, DescribeAccountAttributesCommandOutput, @@ -38,6 +47,9 @@ export class DescribeAccountAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeApplicableIndividualAssessmentsCommand.ts b/clients/client-database-migration-service/commands/DescribeApplicableIndividualAssessmentsCommand.ts index 5ec876ed739bd..52acf8d95aa2f 100644 --- a/clients/client-database-migration-service/commands/DescribeApplicableIndividualAssessmentsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeApplicableIndividualAssessmentsCommand.ts @@ -28,6 +28,23 @@ export type DescribeApplicableIndividualAssessmentsCommandInput = DescribeApplic export type DescribeApplicableIndividualAssessmentsCommandOutput = DescribeApplicableIndividualAssessmentsResponse & __MetadataBearer; +/** + *

Provides a list of individual assessments that you can specify for a new premigration + * assessment run, given one or more parameters.

+ *

If you specify an existing migration task, this operation provides the default individual + * assessments you can specify for that task. Otherwise, the specified parameters model elements + * of a possible migration task on which to base a premigration assessment run.

+ *

To use these migration task modeling parameters, you must specify an existing replication instance, + * a source database engine, a target database engine, and a migration type. This combination of + * parameters potentially limits the default individual assessments available for an assessment run + * created for a corresponding migration task.

+ *

If you specify no parameters, this operation provides a list of all possible individual assessments + * that you can specify for an assessment run. If you specify any one of the task modeling parameters, you must + * specify all of them or the operation cannot provide a list of individual assessments. + * The only parameter that you can specify alone is for an existing migration task. The specified task + * definition then determines the default list of individual assessments that you can specify in an + * assessment run for the task.

+ */ export class DescribeApplicableIndividualAssessmentsCommand extends $Command< DescribeApplicableIndividualAssessmentsCommandInput, DescribeApplicableIndividualAssessmentsCommandOutput, @@ -42,6 +59,9 @@ export class DescribeApplicableIndividualAssessmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeCertificatesCommand.ts b/clients/client-database-migration-service/commands/DescribeCertificatesCommand.ts index d717317e6a2a1..05f38feadae8b 100644 --- a/clients/client-database-migration-service/commands/DescribeCertificatesCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeCertificatesCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeCertificatesCommandInput = DescribeCertificatesMessage; export type DescribeCertificatesCommandOutput = DescribeCertificatesResponse & __MetadataBearer; +/** + *

Provides a description of the certificate.

+ */ export class DescribeCertificatesCommand extends $Command< DescribeCertificatesCommandInput, DescribeCertificatesCommandOutput, @@ -38,6 +41,9 @@ export class DescribeCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeConnectionsCommand.ts b/clients/client-database-migration-service/commands/DescribeConnectionsCommand.ts index 1f89275b5ee12..367f1a8a026a5 100644 --- a/clients/client-database-migration-service/commands/DescribeConnectionsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeConnectionsCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeConnectionsCommandInput = DescribeConnectionsMessage; export type DescribeConnectionsCommandOutput = DescribeConnectionsResponse & __MetadataBearer; +/** + *

Describes the status of the connections that have been made between the replication + * instance and an endpoint. Connections are created when you test an endpoint.

+ */ export class DescribeConnectionsCommand extends $Command< DescribeConnectionsCommandInput, DescribeConnectionsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeEndpointTypesCommand.ts b/clients/client-database-migration-service/commands/DescribeEndpointTypesCommand.ts index 55e067213703d..6ca0960f74068 100644 --- a/clients/client-database-migration-service/commands/DescribeEndpointTypesCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeEndpointTypesCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeEndpointTypesCommandInput = DescribeEndpointTypesMessage; export type DescribeEndpointTypesCommandOutput = DescribeEndpointTypesResponse & __MetadataBearer; +/** + *

Returns information about the type of endpoints available.

+ */ export class DescribeEndpointTypesCommand extends $Command< DescribeEndpointTypesCommandInput, DescribeEndpointTypesCommandOutput, @@ -38,6 +41,9 @@ export class DescribeEndpointTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeEndpointsCommand.ts b/clients/client-database-migration-service/commands/DescribeEndpointsCommand.ts index 445ab1bea2444..40ee4c7800e6b 100644 --- a/clients/client-database-migration-service/commands/DescribeEndpointsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeEndpointsCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeEndpointsCommandInput = DescribeEndpointsMessage; export type DescribeEndpointsCommandOutput = DescribeEndpointsResponse & __MetadataBearer; +/** + *

Returns information about the endpoints for your account in the current region.

+ */ export class DescribeEndpointsCommand extends $Command< DescribeEndpointsCommandInput, DescribeEndpointsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeEventCategoriesCommand.ts b/clients/client-database-migration-service/commands/DescribeEventCategoriesCommand.ts index 0cb548aa8b6cd..f2a41b6c1c5fd 100644 --- a/clients/client-database-migration-service/commands/DescribeEventCategoriesCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeEventCategoriesCommand.ts @@ -24,6 +24,13 @@ import { export type DescribeEventCategoriesCommandInput = DescribeEventCategoriesMessage; export type DescribeEventCategoriesCommandOutput = DescribeEventCategoriesResponse & __MetadataBearer; +/** + *

Lists categories for all event source types, or, if specified, for a specified source + * type. You can see a list of the event categories and source types in Working with Events + * and Notifications in the AWS Database Migration Service User + * Guide. + *

+ */ export class DescribeEventCategoriesCommand extends $Command< DescribeEventCategoriesCommandInput, DescribeEventCategoriesCommandOutput, @@ -38,6 +45,9 @@ export class DescribeEventCategoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeEventSubscriptionsCommand.ts b/clients/client-database-migration-service/commands/DescribeEventSubscriptionsCommand.ts index d65202264f9e7..2fb201bf622fe 100644 --- a/clients/client-database-migration-service/commands/DescribeEventSubscriptionsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeEventSubscriptionsCommand.ts @@ -24,6 +24,14 @@ import { export type DescribeEventSubscriptionsCommandInput = DescribeEventSubscriptionsMessage; export type DescribeEventSubscriptionsCommandOutput = DescribeEventSubscriptionsResponse & __MetadataBearer; +/** + *

Lists all the event subscriptions for a customer account. The description of a + * subscription includes SubscriptionName, SNSTopicARN, + * CustomerID, SourceType, SourceID, + * CreationTime, and Status.

+ *

If you specify SubscriptionName, this action lists the description for that + * subscription.

+ */ export class DescribeEventSubscriptionsCommand extends $Command< DescribeEventSubscriptionsCommandInput, DescribeEventSubscriptionsCommandOutput, @@ -38,6 +46,9 @@ export class DescribeEventSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeEventsCommand.ts b/clients/client-database-migration-service/commands/DescribeEventsCommand.ts index 0e62799f61c55..fd6293627ba99 100644 --- a/clients/client-database-migration-service/commands/DescribeEventsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeEventsCommand.ts @@ -24,6 +24,13 @@ import { export type DescribeEventsCommandInput = DescribeEventsMessage; export type DescribeEventsCommandOutput = DescribeEventsResponse & __MetadataBearer; +/** + *

Lists events for a given source identifier and source type. You can also specify a + * start and end time. For more information on AWS DMS events, see Working with Events and + * Notifications in the AWS Database Migration User + * Guide. + *

+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -38,6 +45,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeOrderableReplicationInstancesCommand.ts b/clients/client-database-migration-service/commands/DescribeOrderableReplicationInstancesCommand.ts index 29b269d08c956..240585090de5f 100644 --- a/clients/client-database-migration-service/commands/DescribeOrderableReplicationInstancesCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeOrderableReplicationInstancesCommand.ts @@ -28,6 +28,10 @@ export type DescribeOrderableReplicationInstancesCommandInput = DescribeOrderabl export type DescribeOrderableReplicationInstancesCommandOutput = DescribeOrderableReplicationInstancesResponse & __MetadataBearer; +/** + *

Returns information about the replication instance types that can be created in the + * specified region.

+ */ export class DescribeOrderableReplicationInstancesCommand extends $Command< DescribeOrderableReplicationInstancesCommandInput, DescribeOrderableReplicationInstancesCommandOutput, @@ -42,6 +46,9 @@ export class DescribeOrderableReplicationInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribePendingMaintenanceActionsCommand.ts b/clients/client-database-migration-service/commands/DescribePendingMaintenanceActionsCommand.ts index 2fd9fef7aaaf2..5034a511dbcff 100644 --- a/clients/client-database-migration-service/commands/DescribePendingMaintenanceActionsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribePendingMaintenanceActionsCommand.ts @@ -28,6 +28,9 @@ export type DescribePendingMaintenanceActionsCommandInput = DescribePendingMaint export type DescribePendingMaintenanceActionsCommandOutput = DescribePendingMaintenanceActionsResponse & __MetadataBearer; +/** + *

For internal use only

+ */ export class DescribePendingMaintenanceActionsCommand extends $Command< DescribePendingMaintenanceActionsCommandInput, DescribePendingMaintenanceActionsCommandOutput, @@ -42,6 +45,9 @@ export class DescribePendingMaintenanceActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeRefreshSchemasStatusCommand.ts b/clients/client-database-migration-service/commands/DescribeRefreshSchemasStatusCommand.ts index 4354313d0f2a0..73a6f1ba14d8b 100644 --- a/clients/client-database-migration-service/commands/DescribeRefreshSchemasStatusCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeRefreshSchemasStatusCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeRefreshSchemasStatusCommandInput = DescribeRefreshSchemasStatusMessage; export type DescribeRefreshSchemasStatusCommandOutput = DescribeRefreshSchemasStatusResponse & __MetadataBearer; +/** + *

Returns the status of the RefreshSchemas operation.

+ */ export class DescribeRefreshSchemasStatusCommand extends $Command< DescribeRefreshSchemasStatusCommandInput, DescribeRefreshSchemasStatusCommandOutput, @@ -38,6 +41,9 @@ export class DescribeRefreshSchemasStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeReplicationInstanceTaskLogsCommand.ts b/clients/client-database-migration-service/commands/DescribeReplicationInstanceTaskLogsCommand.ts index 6f1cbe293ba6d..0e632e2daee2e 100644 --- a/clients/client-database-migration-service/commands/DescribeReplicationInstanceTaskLogsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeReplicationInstanceTaskLogsCommand.ts @@ -28,6 +28,9 @@ export type DescribeReplicationInstanceTaskLogsCommandInput = DescribeReplicatio export type DescribeReplicationInstanceTaskLogsCommandOutput = DescribeReplicationInstanceTaskLogsResponse & __MetadataBearer; +/** + *

Returns information about the task logs for the specified task.

+ */ export class DescribeReplicationInstanceTaskLogsCommand extends $Command< DescribeReplicationInstanceTaskLogsCommandInput, DescribeReplicationInstanceTaskLogsCommandOutput, @@ -42,6 +45,9 @@ export class DescribeReplicationInstanceTaskLogsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeReplicationInstancesCommand.ts b/clients/client-database-migration-service/commands/DescribeReplicationInstancesCommand.ts index cc5ec35996544..4f9128766d23a 100644 --- a/clients/client-database-migration-service/commands/DescribeReplicationInstancesCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeReplicationInstancesCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeReplicationInstancesCommandInput = DescribeReplicationInstancesMessage; export type DescribeReplicationInstancesCommandOutput = DescribeReplicationInstancesResponse & __MetadataBearer; +/** + *

Returns information about replication instances for your account in the current + * region.

+ */ export class DescribeReplicationInstancesCommand extends $Command< DescribeReplicationInstancesCommandInput, DescribeReplicationInstancesCommandOutput, @@ -38,6 +42,9 @@ export class DescribeReplicationInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeReplicationSubnetGroupsCommand.ts b/clients/client-database-migration-service/commands/DescribeReplicationSubnetGroupsCommand.ts index c635e87d1b74c..4bd34c79f357e 100644 --- a/clients/client-database-migration-service/commands/DescribeReplicationSubnetGroupsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeReplicationSubnetGroupsCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeReplicationSubnetGroupsCommandInput = DescribeReplicationSubnetGroupsMessage; export type DescribeReplicationSubnetGroupsCommandOutput = DescribeReplicationSubnetGroupsResponse & __MetadataBearer; +/** + *

Returns information about the replication subnet groups.

+ */ export class DescribeReplicationSubnetGroupsCommand extends $Command< DescribeReplicationSubnetGroupsCommandInput, DescribeReplicationSubnetGroupsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeReplicationSubnetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeReplicationTaskAssessmentResultsCommand.ts b/clients/client-database-migration-service/commands/DescribeReplicationTaskAssessmentResultsCommand.ts index a23807593e1a6..3ac0f3643f0af 100644 --- a/clients/client-database-migration-service/commands/DescribeReplicationTaskAssessmentResultsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeReplicationTaskAssessmentResultsCommand.ts @@ -28,6 +28,10 @@ export type DescribeReplicationTaskAssessmentResultsCommandInput = DescribeRepli export type DescribeReplicationTaskAssessmentResultsCommandOutput = DescribeReplicationTaskAssessmentResultsResponse & __MetadataBearer; +/** + *

Returns the task assessment results from Amazon S3. This action always returns the + * latest results.

+ */ export class DescribeReplicationTaskAssessmentResultsCommand extends $Command< DescribeReplicationTaskAssessmentResultsCommandInput, DescribeReplicationTaskAssessmentResultsCommandOutput, @@ -42,6 +46,9 @@ export class DescribeReplicationTaskAssessmentResultsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeReplicationTaskAssessmentRunsCommand.ts b/clients/client-database-migration-service/commands/DescribeReplicationTaskAssessmentRunsCommand.ts index 6deb0703a6bde..7bebce00fedb2 100644 --- a/clients/client-database-migration-service/commands/DescribeReplicationTaskAssessmentRunsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeReplicationTaskAssessmentRunsCommand.ts @@ -28,6 +28,17 @@ export type DescribeReplicationTaskAssessmentRunsCommandInput = DescribeReplicat export type DescribeReplicationTaskAssessmentRunsCommandOutput = DescribeReplicationTaskAssessmentRunsResponse & __MetadataBearer; +/** + *

Returns a paginated list of premigration assessment runs based on filter + * settings.

+ *

These filter settings can specify a combination of premigration assessment runs, + * migration tasks, replication instances, and assessment run status values.

+ * + *

This operation doesn't return information about individual assessments. For this + * information, see the DescribeReplicationTaskIndividualAssessments + * operation.

+ *
+ */ export class DescribeReplicationTaskAssessmentRunsCommand extends $Command< DescribeReplicationTaskAssessmentRunsCommandInput, DescribeReplicationTaskAssessmentRunsCommandOutput, @@ -42,6 +53,9 @@ export class DescribeReplicationTaskAssessmentRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeReplicationTaskIndividualAssessmentsCommand.ts b/clients/client-database-migration-service/commands/DescribeReplicationTaskIndividualAssessmentsCommand.ts index 88f05542abf80..4a72f569bd7e9 100644 --- a/clients/client-database-migration-service/commands/DescribeReplicationTaskIndividualAssessmentsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeReplicationTaskIndividualAssessmentsCommand.ts @@ -28,6 +28,11 @@ export type DescribeReplicationTaskIndividualAssessmentsCommandInput = DescribeR export type DescribeReplicationTaskIndividualAssessmentsCommandOutput = DescribeReplicationTaskIndividualAssessmentsResponse & __MetadataBearer; +/** + *

Returns a paginated list of individual assessments based on filter settings.

+ *

These filter settings can specify a combination of premigration assessment runs, + * migration tasks, and assessment status values.

+ */ export class DescribeReplicationTaskIndividualAssessmentsCommand extends $Command< DescribeReplicationTaskIndividualAssessmentsCommandInput, DescribeReplicationTaskIndividualAssessmentsCommandOutput, @@ -42,6 +47,9 @@ export class DescribeReplicationTaskIndividualAssessmentsCommand extends $Comman // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeReplicationTasksCommand.ts b/clients/client-database-migration-service/commands/DescribeReplicationTasksCommand.ts index 3ec7663d34b96..2b99ee0822bab 100644 --- a/clients/client-database-migration-service/commands/DescribeReplicationTasksCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeReplicationTasksCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeReplicationTasksCommandInput = DescribeReplicationTasksMessage; export type DescribeReplicationTasksCommandOutput = DescribeReplicationTasksResponse & __MetadataBearer; +/** + *

Returns information about replication tasks for your account in the current + * region.

+ */ export class DescribeReplicationTasksCommand extends $Command< DescribeReplicationTasksCommandInput, DescribeReplicationTasksCommandOutput, @@ -38,6 +42,9 @@ export class DescribeReplicationTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeSchemasCommand.ts b/clients/client-database-migration-service/commands/DescribeSchemasCommand.ts index 319a66b5a743e..9b5ac15b87f7f 100644 --- a/clients/client-database-migration-service/commands/DescribeSchemasCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeSchemasCommand.ts @@ -24,6 +24,11 @@ import { export type DescribeSchemasCommandInput = DescribeSchemasMessage; export type DescribeSchemasCommandOutput = DescribeSchemasResponse & __MetadataBearer; +/** + *

Returns information about the schema for the specified endpoint.

+ * + *

+ */ export class DescribeSchemasCommand extends $Command< DescribeSchemasCommandInput, DescribeSchemasCommandOutput, @@ -38,6 +43,9 @@ export class DescribeSchemasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/DescribeTableStatisticsCommand.ts b/clients/client-database-migration-service/commands/DescribeTableStatisticsCommand.ts index d88d5fef64a96..26217c2e0b632 100644 --- a/clients/client-database-migration-service/commands/DescribeTableStatisticsCommand.ts +++ b/clients/client-database-migration-service/commands/DescribeTableStatisticsCommand.ts @@ -24,6 +24,13 @@ import { export type DescribeTableStatisticsCommandInput = DescribeTableStatisticsMessage; export type DescribeTableStatisticsCommandOutput = DescribeTableStatisticsResponse & __MetadataBearer; +/** + *

Returns table statistics on the database migration task, including table name, rows + * inserted, rows updated, and rows deleted.

+ *

Note that the "last updated" column the DMS console only indicates the time that AWS DMS + * last updated the table statistics record for a table. It does not indicate the time of the + * last update to the table.

+ */ export class DescribeTableStatisticsCommand extends $Command< DescribeTableStatisticsCommandInput, DescribeTableStatisticsCommandOutput, @@ -38,6 +45,9 @@ export class DescribeTableStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ImportCertificateCommand.ts b/clients/client-database-migration-service/commands/ImportCertificateCommand.ts index e4dccddfcc32f..1a6d3bec920e0 100644 --- a/clients/client-database-migration-service/commands/ImportCertificateCommand.ts +++ b/clients/client-database-migration-service/commands/ImportCertificateCommand.ts @@ -24,6 +24,9 @@ import { export type ImportCertificateCommandInput = ImportCertificateMessage; export type ImportCertificateCommandOutput = ImportCertificateResponse & __MetadataBearer; +/** + *

Uploads the specified certificate.

+ */ export class ImportCertificateCommand extends $Command< ImportCertificateCommandInput, ImportCertificateCommandOutput, @@ -38,6 +41,9 @@ export class ImportCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ListTagsForResourceCommand.ts b/clients/client-database-migration-service/commands/ListTagsForResourceCommand.ts index 948426cf5bf27..baf37ca9fa5bf 100644 --- a/clients/client-database-migration-service/commands/ListTagsForResourceCommand.ts +++ b/clients/client-database-migration-service/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,13 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceMessage; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists all metadata tags attached to an AWS DMS resource, including + * replication instance, endpoint, security group, and migration task. + * For more information, see + * Tag + * data type description.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +45,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ModifyEndpointCommand.ts b/clients/client-database-migration-service/commands/ModifyEndpointCommand.ts index fc27f73cf4290..e7e410ebadd79 100644 --- a/clients/client-database-migration-service/commands/ModifyEndpointCommand.ts +++ b/clients/client-database-migration-service/commands/ModifyEndpointCommand.ts @@ -24,6 +24,9 @@ import { export type ModifyEndpointCommandInput = ModifyEndpointMessage; export type ModifyEndpointCommandOutput = ModifyEndpointResponse & __MetadataBearer; +/** + *

Modifies the specified endpoint.

+ */ export class ModifyEndpointCommand extends $Command< ModifyEndpointCommandInput, ModifyEndpointCommandOutput, @@ -38,6 +41,9 @@ export class ModifyEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ModifyEventSubscriptionCommand.ts b/clients/client-database-migration-service/commands/ModifyEventSubscriptionCommand.ts index baf235be36c21..3d6abcf1af2ab 100644 --- a/clients/client-database-migration-service/commands/ModifyEventSubscriptionCommand.ts +++ b/clients/client-database-migration-service/commands/ModifyEventSubscriptionCommand.ts @@ -24,6 +24,9 @@ import { export type ModifyEventSubscriptionCommandInput = ModifyEventSubscriptionMessage; export type ModifyEventSubscriptionCommandOutput = ModifyEventSubscriptionResponse & __MetadataBearer; +/** + *

Modifies an existing AWS DMS event notification subscription.

+ */ export class ModifyEventSubscriptionCommand extends $Command< ModifyEventSubscriptionCommandInput, ModifyEventSubscriptionCommandOutput, @@ -38,6 +41,9 @@ export class ModifyEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ModifyReplicationInstanceCommand.ts b/clients/client-database-migration-service/commands/ModifyReplicationInstanceCommand.ts index d121ca6ac15ef..9439e706cf415 100644 --- a/clients/client-database-migration-service/commands/ModifyReplicationInstanceCommand.ts +++ b/clients/client-database-migration-service/commands/ModifyReplicationInstanceCommand.ts @@ -24,6 +24,13 @@ import { export type ModifyReplicationInstanceCommandInput = ModifyReplicationInstanceMessage; export type ModifyReplicationInstanceCommandOutput = ModifyReplicationInstanceResponse & __MetadataBearer; +/** + *

Modifies the replication instance to apply new settings. You can change one or more + * parameters by specifying these parameters and the new values in the request.

+ *

Some settings are applied during the maintenance window.

+ * + *

+ */ export class ModifyReplicationInstanceCommand extends $Command< ModifyReplicationInstanceCommandInput, ModifyReplicationInstanceCommandOutput, @@ -38,6 +45,9 @@ export class ModifyReplicationInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ModifyReplicationSubnetGroupCommand.ts b/clients/client-database-migration-service/commands/ModifyReplicationSubnetGroupCommand.ts index fe913bd561561..41c131ba45f19 100644 --- a/clients/client-database-migration-service/commands/ModifyReplicationSubnetGroupCommand.ts +++ b/clients/client-database-migration-service/commands/ModifyReplicationSubnetGroupCommand.ts @@ -24,6 +24,9 @@ import { export type ModifyReplicationSubnetGroupCommandInput = ModifyReplicationSubnetGroupMessage; export type ModifyReplicationSubnetGroupCommandOutput = ModifyReplicationSubnetGroupResponse & __MetadataBearer; +/** + *

Modifies the settings for the specified replication subnet group.

+ */ export class ModifyReplicationSubnetGroupCommand extends $Command< ModifyReplicationSubnetGroupCommandInput, ModifyReplicationSubnetGroupCommandOutput, @@ -38,6 +41,9 @@ export class ModifyReplicationSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ModifyReplicationTaskCommand.ts b/clients/client-database-migration-service/commands/ModifyReplicationTaskCommand.ts index 91dc2d38c1ed4..9f4278e6cd2da 100644 --- a/clients/client-database-migration-service/commands/ModifyReplicationTaskCommand.ts +++ b/clients/client-database-migration-service/commands/ModifyReplicationTaskCommand.ts @@ -24,6 +24,12 @@ import { export type ModifyReplicationTaskCommandInput = ModifyReplicationTaskMessage; export type ModifyReplicationTaskCommandOutput = ModifyReplicationTaskResponse & __MetadataBearer; +/** + *

Modifies the specified replication task.

+ *

You can't modify the task endpoints. The task must be stopped before you can modify it.

+ *

For more information about AWS DMS tasks, see Working with Migration Tasks in the + * AWS Database Migration Service User Guide.

+ */ export class ModifyReplicationTaskCommand extends $Command< ModifyReplicationTaskCommandInput, ModifyReplicationTaskCommandOutput, @@ -38,6 +44,9 @@ export class ModifyReplicationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/MoveReplicationTaskCommand.ts b/clients/client-database-migration-service/commands/MoveReplicationTaskCommand.ts index fe6791f4749eb..880b785c49dfa 100644 --- a/clients/client-database-migration-service/commands/MoveReplicationTaskCommand.ts +++ b/clients/client-database-migration-service/commands/MoveReplicationTaskCommand.ts @@ -24,6 +24,12 @@ import { export type MoveReplicationTaskCommandInput = MoveReplicationTaskMessage; export type MoveReplicationTaskCommandOutput = MoveReplicationTaskResponse & __MetadataBearer; +/** + *

Moves a replication task from its current replication instance to a different target + * replication instance using the specified parameters. The target replication instance must + * be created with the same or later AWS DMS version as the current replication + * instance.

+ */ export class MoveReplicationTaskCommand extends $Command< MoveReplicationTaskCommandInput, MoveReplicationTaskCommandOutput, @@ -38,6 +44,9 @@ export class MoveReplicationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/RebootReplicationInstanceCommand.ts b/clients/client-database-migration-service/commands/RebootReplicationInstanceCommand.ts index caa5eb39ab5f1..0a0a188256325 100644 --- a/clients/client-database-migration-service/commands/RebootReplicationInstanceCommand.ts +++ b/clients/client-database-migration-service/commands/RebootReplicationInstanceCommand.ts @@ -24,6 +24,10 @@ import { export type RebootReplicationInstanceCommandInput = RebootReplicationInstanceMessage; export type RebootReplicationInstanceCommandOutput = RebootReplicationInstanceResponse & __MetadataBearer; +/** + *

Reboots a replication instance. Rebooting results in a momentary outage, until the + * replication instance becomes available again.

+ */ export class RebootReplicationInstanceCommand extends $Command< RebootReplicationInstanceCommandInput, RebootReplicationInstanceCommandOutput, @@ -38,6 +42,9 @@ export class RebootReplicationInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/RefreshSchemasCommand.ts b/clients/client-database-migration-service/commands/RefreshSchemasCommand.ts index 60bba9a04b69e..1fe74df81a8ba 100644 --- a/clients/client-database-migration-service/commands/RefreshSchemasCommand.ts +++ b/clients/client-database-migration-service/commands/RefreshSchemasCommand.ts @@ -24,6 +24,11 @@ import { export type RefreshSchemasCommandInput = RefreshSchemasMessage; export type RefreshSchemasCommandOutput = RefreshSchemasResponse & __MetadataBearer; +/** + *

Populates the schema for the specified endpoint. This is an asynchronous operation and + * can take several minutes. You can check the status of this operation by calling the + * DescribeRefreshSchemasStatus operation.

+ */ export class RefreshSchemasCommand extends $Command< RefreshSchemasCommandInput, RefreshSchemasCommandOutput, @@ -38,6 +43,9 @@ export class RefreshSchemasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/ReloadTablesCommand.ts b/clients/client-database-migration-service/commands/ReloadTablesCommand.ts index 5a3d8b69a1b0a..cbe1ed96bff76 100644 --- a/clients/client-database-migration-service/commands/ReloadTablesCommand.ts +++ b/clients/client-database-migration-service/commands/ReloadTablesCommand.ts @@ -24,6 +24,9 @@ import { export type ReloadTablesCommandInput = ReloadTablesMessage; export type ReloadTablesCommandOutput = ReloadTablesResponse & __MetadataBearer; +/** + *

Reloads the target database table with the source data.

+ */ export class ReloadTablesCommand extends $Command< ReloadTablesCommandInput, ReloadTablesCommandOutput, @@ -38,6 +41,9 @@ export class ReloadTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/RemoveTagsFromResourceCommand.ts b/clients/client-database-migration-service/commands/RemoveTagsFromResourceCommand.ts index 9ceb4237c7603..8114fc5ee54ee 100644 --- a/clients/client-database-migration-service/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-database-migration-service/commands/RemoveTagsFromResourceCommand.ts @@ -24,6 +24,14 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceMessage; export type RemoveTagsFromResourceCommandOutput = RemoveTagsFromResourceResponse & __MetadataBearer; +/** + *

Removes metadata tags from an AWS DMS resource, including replication instance, + * endpoint, security group, and migration task. For more information, see + * + * Tag + * + * data type description.

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -38,6 +46,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/StartReplicationTaskAssessmentCommand.ts b/clients/client-database-migration-service/commands/StartReplicationTaskAssessmentCommand.ts index 0e10c26814b37..b90af42da6512 100644 --- a/clients/client-database-migration-service/commands/StartReplicationTaskAssessmentCommand.ts +++ b/clients/client-database-migration-service/commands/StartReplicationTaskAssessmentCommand.ts @@ -24,6 +24,10 @@ import { export type StartReplicationTaskAssessmentCommandInput = StartReplicationTaskAssessmentMessage; export type StartReplicationTaskAssessmentCommandOutput = StartReplicationTaskAssessmentResponse & __MetadataBearer; +/** + *

Starts the replication task assessment for unsupported data types in the source + * database.

+ */ export class StartReplicationTaskAssessmentCommand extends $Command< StartReplicationTaskAssessmentCommandInput, StartReplicationTaskAssessmentCommandOutput, @@ -38,6 +42,9 @@ export class StartReplicationTaskAssessmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/StartReplicationTaskAssessmentRunCommand.ts b/clients/client-database-migration-service/commands/StartReplicationTaskAssessmentRunCommand.ts index 7b23b7497319a..e0ba27a9df078 100644 --- a/clients/client-database-migration-service/commands/StartReplicationTaskAssessmentRunCommand.ts +++ b/clients/client-database-migration-service/commands/StartReplicationTaskAssessmentRunCommand.ts @@ -28,6 +28,15 @@ export type StartReplicationTaskAssessmentRunCommandInput = StartReplicationTask export type StartReplicationTaskAssessmentRunCommandOutput = StartReplicationTaskAssessmentRunResponse & __MetadataBearer; +/** + *

Starts a new premigration assessment run for one or more individual assessments + * of a migration task.

+ *

The assessments that you can specify depend on the source and target database engine and + * the migration type defined for the given task. To run this operation, your migration task + * must already be created. After you run this operation, you can review the status of each + * individual assessment. You can also run the migration task manually after the assessment + * run and its individual assessments complete.

+ */ export class StartReplicationTaskAssessmentRunCommand extends $Command< StartReplicationTaskAssessmentRunCommandInput, StartReplicationTaskAssessmentRunCommandOutput, @@ -42,6 +51,9 @@ export class StartReplicationTaskAssessmentRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/StartReplicationTaskCommand.ts b/clients/client-database-migration-service/commands/StartReplicationTaskCommand.ts index 6d48c0d1897a8..2c1954d71125d 100644 --- a/clients/client-database-migration-service/commands/StartReplicationTaskCommand.ts +++ b/clients/client-database-migration-service/commands/StartReplicationTaskCommand.ts @@ -24,6 +24,12 @@ import { export type StartReplicationTaskCommandInput = StartReplicationTaskMessage; export type StartReplicationTaskCommandOutput = StartReplicationTaskResponse & __MetadataBearer; +/** + *

Starts the replication task.

+ *

For more information about AWS DMS tasks, see Working with Migration Tasks in the + * AWS Database Migration Service User Guide. + *

+ */ export class StartReplicationTaskCommand extends $Command< StartReplicationTaskCommandInput, StartReplicationTaskCommandOutput, @@ -38,6 +44,9 @@ export class StartReplicationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/StopReplicationTaskCommand.ts b/clients/client-database-migration-service/commands/StopReplicationTaskCommand.ts index b9d9d038e3ea1..2d0c82cc96d1c 100644 --- a/clients/client-database-migration-service/commands/StopReplicationTaskCommand.ts +++ b/clients/client-database-migration-service/commands/StopReplicationTaskCommand.ts @@ -24,6 +24,9 @@ import { export type StopReplicationTaskCommandInput = StopReplicationTaskMessage; export type StopReplicationTaskCommandOutput = StopReplicationTaskResponse & __MetadataBearer; +/** + *

Stops the replication task.

+ */ export class StopReplicationTaskCommand extends $Command< StopReplicationTaskCommandInput, StopReplicationTaskCommandOutput, @@ -38,6 +41,9 @@ export class StopReplicationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/commands/TestConnectionCommand.ts b/clients/client-database-migration-service/commands/TestConnectionCommand.ts index 438f026fe938c..c3e444fadd301 100644 --- a/clients/client-database-migration-service/commands/TestConnectionCommand.ts +++ b/clients/client-database-migration-service/commands/TestConnectionCommand.ts @@ -24,6 +24,9 @@ import { export type TestConnectionCommandInput = TestConnectionMessage; export type TestConnectionCommandOutput = TestConnectionResponse & __MetadataBearer; +/** + *

Tests the connection between the replication instance and the endpoint.

+ */ export class TestConnectionCommand extends $Command< TestConnectionCommandInput, TestConnectionCommandOutput, @@ -38,6 +41,9 @@ export class TestConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DatabaseMigrationServiceClientResolvedConfig, diff --git a/clients/client-database-migration-service/package.json b/clients/client-database-migration-service/package.json index 7ab6ffdf16911..36dd3d03e9f17 100644 --- a/clients/client-database-migration-service/package.json +++ b/clients/client-database-migration-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Database Migration Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-database-migration-service/pagination/DescribeApplicableIndividualAssessmentsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeApplicableIndividualAssessmentsPaginator.ts index cb562aa9e1400..1d76aefb9f06e 100644 --- a/clients/client-database-migration-service/pagination/DescribeApplicableIndividualAssessmentsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeApplicableIndividualAssessmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeApplicableIndividualAssessmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeApplicableIndividualAssessmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeApplicableIndividualAssessmentsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeCertificatesPaginator.ts b/clients/client-database-migration-service/pagination/DescribeCertificatesPaginator.ts index 363544b42da9f..5a635bd50a197 100644 --- a/clients/client-database-migration-service/pagination/DescribeCertificatesPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeCertificatesCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeConnectionsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeConnectionsPaginator.ts index fa4d6a3125244..e8aa3b604facf 100644 --- a/clients/client-database-migration-service/pagination/DescribeConnectionsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeConnectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeConnectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeConnectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeConnectionsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeEndpointTypesPaginator.ts b/clients/client-database-migration-service/pagination/DescribeEndpointTypesPaginator.ts index 568df96fa5ca8..d348bb2454068 100644 --- a/clients/client-database-migration-service/pagination/DescribeEndpointTypesPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeEndpointTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeEndpointTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEndpointTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeEndpointTypesCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeEndpointsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeEndpointsPaginator.ts index 39cc5fd1f8130..bcaca9d60f487 100644 --- a/clients/client-database-migration-service/pagination/DescribeEndpointsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeEndpointsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeEventSubscriptionsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeEventSubscriptionsPaginator.ts index 565230cee45b8..a22f4381afe65 100644 --- a/clients/client-database-migration-service/pagination/DescribeEventSubscriptionsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeEventSubscriptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeEventSubscriptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventSubscriptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeEventSubscriptionsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeEventsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeEventsPaginator.ts index 25504773f72b5..da63764b05436 100644 --- a/clients/client-database-migration-service/pagination/DescribeEventsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeEventsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeOrderableReplicationInstancesPaginator.ts b/clients/client-database-migration-service/pagination/DescribeOrderableReplicationInstancesPaginator.ts index 448911843cb33..4065a7873978f 100644 --- a/clients/client-database-migration-service/pagination/DescribeOrderableReplicationInstancesPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeOrderableReplicationInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeOrderableReplicationInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOrderableReplicationInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeOrderableReplicationInstancesCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribePendingMaintenanceActionsPaginator.ts b/clients/client-database-migration-service/pagination/DescribePendingMaintenanceActionsPaginator.ts index f78662c69aac6..7f9302c69bf1e 100644 --- a/clients/client-database-migration-service/pagination/DescribePendingMaintenanceActionsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribePendingMaintenanceActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribePendingMaintenanceActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePendingMaintenanceActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribePendingMaintenanceActionsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeReplicationInstanceTaskLogsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeReplicationInstanceTaskLogsPaginator.ts index e71a498ebaf76..c0e668c38c1bf 100644 --- a/clients/client-database-migration-service/pagination/DescribeReplicationInstanceTaskLogsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeReplicationInstanceTaskLogsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeReplicationInstanceTaskLogsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReplicationInstanceTaskLogsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeReplicationInstanceTaskLogsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeReplicationInstancesPaginator.ts b/clients/client-database-migration-service/pagination/DescribeReplicationInstancesPaginator.ts index 83cf4519ff817..cd90d8ad9b546 100644 --- a/clients/client-database-migration-service/pagination/DescribeReplicationInstancesPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeReplicationInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeReplicationInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReplicationInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeReplicationInstancesCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeReplicationSubnetGroupsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeReplicationSubnetGroupsPaginator.ts index bbaa362b2b44b..9f87778a8d3da 100644 --- a/clients/client-database-migration-service/pagination/DescribeReplicationSubnetGroupsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeReplicationSubnetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeReplicationSubnetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReplicationSubnetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeReplicationSubnetGroupsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeReplicationTaskAssessmentResultsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeReplicationTaskAssessmentResultsPaginator.ts index 62a46016b56c9..f7f63eb5a290a 100644 --- a/clients/client-database-migration-service/pagination/DescribeReplicationTaskAssessmentResultsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeReplicationTaskAssessmentResultsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeReplicationTaskAssessmentResultsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReplicationTaskAssessmentResultsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeReplicationTaskAssessmentResultsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeReplicationTaskAssessmentRunsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeReplicationTaskAssessmentRunsPaginator.ts index 254b3b2839461..15f75efbeffff 100644 --- a/clients/client-database-migration-service/pagination/DescribeReplicationTaskAssessmentRunsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeReplicationTaskAssessmentRunsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeReplicationTaskAssessmentRunsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReplicationTaskAssessmentRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeReplicationTaskAssessmentRunsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeReplicationTaskIndividualAssessmentsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeReplicationTaskIndividualAssessmentsPaginator.ts index 1343891ab5f6a..52efc940db2b8 100644 --- a/clients/client-database-migration-service/pagination/DescribeReplicationTaskIndividualAssessmentsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeReplicationTaskIndividualAssessmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeReplicationTaskIndividualAssessmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReplicationTaskIndividualAssessmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeReplicationTaskIndividualAssessmentsCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeReplicationTasksPaginator.ts b/clients/client-database-migration-service/pagination/DescribeReplicationTasksPaginator.ts index c729e919b2fec..6cf6d85cf1d42 100644 --- a/clients/client-database-migration-service/pagination/DescribeReplicationTasksPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeReplicationTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeReplicationTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReplicationTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeReplicationTasksCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeSchemasPaginator.ts b/clients/client-database-migration-service/pagination/DescribeSchemasPaginator.ts index c6ce9c7a2ff9e..8835c51f0cbb4 100644 --- a/clients/client-database-migration-service/pagination/DescribeSchemasPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeSchemasPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeSchemasCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSchemasCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeSchemasCommandInput, diff --git a/clients/client-database-migration-service/pagination/DescribeTableStatisticsPaginator.ts b/clients/client-database-migration-service/pagination/DescribeTableStatisticsPaginator.ts index 7e04aa68c0971..7048afbca26e3 100644 --- a/clients/client-database-migration-service/pagination/DescribeTableStatisticsPaginator.ts +++ b/clients/client-database-migration-service/pagination/DescribeTableStatisticsPaginator.ts @@ -8,6 +8,9 @@ import { import { DatabaseMigrationServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DatabaseMigrationServiceClient, input: DescribeTableStatisticsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTableStatisticsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DatabaseMigrationService, input: DescribeTableStatisticsCommandInput, diff --git a/clients/client-database-migration-service/runtimeConfig.browser.ts b/clients/client-database-migration-service/runtimeConfig.browser.ts index f722f60d91072..2f358d8a26ee5 100644 --- a/clients/client-database-migration-service/runtimeConfig.browser.ts +++ b/clients/client-database-migration-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DatabaseMigrationServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-database-migration-service/runtimeConfig.native.ts b/clients/client-database-migration-service/runtimeConfig.native.ts index 09e939aa9aa6f..9cad9050d511b 100644 --- a/clients/client-database-migration-service/runtimeConfig.native.ts +++ b/clients/client-database-migration-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DatabaseMigrationServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-database-migration-service/runtimeConfig.shared.ts b/clients/client-database-migration-service/runtimeConfig.shared.ts index fe9f9967b7771..a4cf549ff91aa 100644 --- a/clients/client-database-migration-service/runtimeConfig.shared.ts +++ b/clients/client-database-migration-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-01-01", disableHostPrefix: false, diff --git a/clients/client-database-migration-service/runtimeConfig.ts b/clients/client-database-migration-service/runtimeConfig.ts index 9bab5b0e68288..385a6d603237a 100644 --- a/clients/client-database-migration-service/runtimeConfig.ts +++ b/clients/client-database-migration-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DatabaseMigrationServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-database-migration-service/tsconfig.json b/clients/client-database-migration-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-database-migration-service/tsconfig.json +++ b/clients/client-database-migration-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-databrew/commands/BatchDeleteRecipeVersionCommand.ts b/clients/client-databrew/commands/BatchDeleteRecipeVersionCommand.ts index 9692dd00ddcd9..928bd433bd864 100644 --- a/clients/client-databrew/commands/BatchDeleteRecipeVersionCommand.ts +++ b/clients/client-databrew/commands/BatchDeleteRecipeVersionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeleteRecipeVersionCommandInput = BatchDeleteRecipeVersionRequest; export type BatchDeleteRecipeVersionCommandOutput = BatchDeleteRecipeVersionResponse & __MetadataBearer; +/** + *

Deletes one or more versions of a recipe at a time.

+ */ export class BatchDeleteRecipeVersionCommand extends $Command< BatchDeleteRecipeVersionCommandInput, BatchDeleteRecipeVersionCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeleteRecipeVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/CreateDatasetCommand.ts b/clients/client-databrew/commands/CreateDatasetCommand.ts index cfc75f4797f77..4e0e3bbbf2881 100644 --- a/clients/client-databrew/commands/CreateDatasetCommand.ts +++ b/clients/client-databrew/commands/CreateDatasetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDatasetCommandInput = CreateDatasetRequest; export type CreateDatasetCommandOutput = CreateDatasetResponse & __MetadataBearer; +/** + *

Creates a new AWS Glue DataBrew dataset for this AWS account.

+ */ export class CreateDatasetCommand extends $Command< CreateDatasetCommandInput, CreateDatasetCommandOutput, @@ -34,6 +37,9 @@ export class CreateDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/CreateProfileJobCommand.ts b/clients/client-databrew/commands/CreateProfileJobCommand.ts index 7d592fa45589f..2c17f49c6454f 100644 --- a/clients/client-databrew/commands/CreateProfileJobCommand.ts +++ b/clients/client-databrew/commands/CreateProfileJobCommand.ts @@ -20,6 +20,10 @@ import { export type CreateProfileJobCommandInput = CreateProfileJobRequest; export type CreateProfileJobCommandOutput = CreateProfileJobResponse & __MetadataBearer; +/** + *

Creates a new job to profile an AWS Glue DataBrew dataset that exists in the current AWS + * account.

+ */ export class CreateProfileJobCommand extends $Command< CreateProfileJobCommandInput, CreateProfileJobCommandOutput, @@ -34,6 +38,9 @@ export class CreateProfileJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/CreateProjectCommand.ts b/clients/client-databrew/commands/CreateProjectCommand.ts index 1a6a51446cf30..eaa224e78bade 100644 --- a/clients/client-databrew/commands/CreateProjectCommand.ts +++ b/clients/client-databrew/commands/CreateProjectCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProjectCommandInput = CreateProjectRequest; export type CreateProjectCommandOutput = CreateProjectResponse & __MetadataBearer; +/** + *

Creates a new AWS Glue DataBrew project in the current AWS account.

+ */ export class CreateProjectCommand extends $Command< CreateProjectCommandInput, CreateProjectCommandOutput, @@ -34,6 +37,9 @@ export class CreateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/CreateRecipeCommand.ts b/clients/client-databrew/commands/CreateRecipeCommand.ts index 2d9a55057fef7..66f210bd27682 100644 --- a/clients/client-databrew/commands/CreateRecipeCommand.ts +++ b/clients/client-databrew/commands/CreateRecipeCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRecipeCommandInput = CreateRecipeRequest; export type CreateRecipeCommandOutput = CreateRecipeResponse & __MetadataBearer; +/** + *

Creates a new AWS Glue DataBrew recipe for the current AWS account.

+ */ export class CreateRecipeCommand extends $Command< CreateRecipeCommandInput, CreateRecipeCommandOutput, @@ -34,6 +37,9 @@ export class CreateRecipeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/CreateRecipeJobCommand.ts b/clients/client-databrew/commands/CreateRecipeJobCommand.ts index 76732745ed0ff..f53918508cf01 100644 --- a/clients/client-databrew/commands/CreateRecipeJobCommand.ts +++ b/clients/client-databrew/commands/CreateRecipeJobCommand.ts @@ -20,6 +20,11 @@ import { export type CreateRecipeJobCommandInput = CreateRecipeJobRequest; export type CreateRecipeJobCommandOutput = CreateRecipeJobResponse & __MetadataBearer; +/** + *

Creates a new job for an existing AWS Glue DataBrew recipe in the current AWS account. + * You can create a standalone job using either a project, or a combination of a recipe and + * a dataset.

+ */ export class CreateRecipeJobCommand extends $Command< CreateRecipeJobCommandInput, CreateRecipeJobCommandOutput, @@ -34,6 +39,9 @@ export class CreateRecipeJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/CreateScheduleCommand.ts b/clients/client-databrew/commands/CreateScheduleCommand.ts index 9d9457cdd0157..3243eb62a9fd0 100644 --- a/clients/client-databrew/commands/CreateScheduleCommand.ts +++ b/clients/client-databrew/commands/CreateScheduleCommand.ts @@ -20,6 +20,10 @@ import { export type CreateScheduleCommandInput = CreateScheduleRequest; export type CreateScheduleCommandOutput = CreateScheduleResponse & __MetadataBearer; +/** + *

Creates a new schedule for one or more AWS Glue DataBrew jobs. Jobs can be run at a + * specific date and time, or at regular intervals.

+ */ export class CreateScheduleCommand extends $Command< CreateScheduleCommandInput, CreateScheduleCommandOutput, @@ -34,6 +38,9 @@ export class CreateScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DeleteDatasetCommand.ts b/clients/client-databrew/commands/DeleteDatasetCommand.ts index 46c79e6c25809..41bce73381d34 100644 --- a/clients/client-databrew/commands/DeleteDatasetCommand.ts +++ b/clients/client-databrew/commands/DeleteDatasetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDatasetCommandInput = DeleteDatasetRequest; export type DeleteDatasetCommandOutput = DeleteDatasetResponse & __MetadataBearer; +/** + *

Deletes a dataset from AWS Glue DataBrew.

+ */ export class DeleteDatasetCommand extends $Command< DeleteDatasetCommandInput, DeleteDatasetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DeleteJobCommand.ts b/clients/client-databrew/commands/DeleteJobCommand.ts index bf47ae5a56562..422e451a9e956 100644 --- a/clients/client-databrew/commands/DeleteJobCommand.ts +++ b/clients/client-databrew/commands/DeleteJobCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteJobCommandInput = DeleteJobRequest; export type DeleteJobCommandOutput = DeleteJobResponse & __MetadataBearer; +/** + *

Deletes the specified AWS Glue DataBrew job from the current AWS account. The job can + * be for a recipe or for a profile.

+ */ export class DeleteJobCommand extends $Command< DeleteJobCommandInput, DeleteJobCommandOutput, @@ -34,6 +38,9 @@ export class DeleteJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DeleteProjectCommand.ts b/clients/client-databrew/commands/DeleteProjectCommand.ts index b3c567b6c82a1..779f07eed7db1 100644 --- a/clients/client-databrew/commands/DeleteProjectCommand.ts +++ b/clients/client-databrew/commands/DeleteProjectCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProjectCommandInput = DeleteProjectRequest; export type DeleteProjectCommandOutput = DeleteProjectResponse & __MetadataBearer; +/** + *

Deletes an existing AWS Glue DataBrew project from the current AWS account.

+ */ export class DeleteProjectCommand extends $Command< DeleteProjectCommandInput, DeleteProjectCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DeleteRecipeVersionCommand.ts b/clients/client-databrew/commands/DeleteRecipeVersionCommand.ts index 615d31c5dd1aa..1d14674452f7c 100644 --- a/clients/client-databrew/commands/DeleteRecipeVersionCommand.ts +++ b/clients/client-databrew/commands/DeleteRecipeVersionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRecipeVersionCommandInput = DeleteRecipeVersionRequest; export type DeleteRecipeVersionCommandOutput = DeleteRecipeVersionResponse & __MetadataBearer; +/** + *

Deletes a single version of an AWS Glue DataBrew recipe.

+ */ export class DeleteRecipeVersionCommand extends $Command< DeleteRecipeVersionCommandInput, DeleteRecipeVersionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRecipeVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DeleteScheduleCommand.ts b/clients/client-databrew/commands/DeleteScheduleCommand.ts index 819943238b1ac..762b0a55a35e9 100644 --- a/clients/client-databrew/commands/DeleteScheduleCommand.ts +++ b/clients/client-databrew/commands/DeleteScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteScheduleCommandInput = DeleteScheduleRequest; export type DeleteScheduleCommandOutput = DeleteScheduleResponse & __MetadataBearer; +/** + *

Deletes the specified AWS Glue DataBrew schedule from the current AWS account.

+ */ export class DeleteScheduleCommand extends $Command< DeleteScheduleCommandInput, DeleteScheduleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DescribeDatasetCommand.ts b/clients/client-databrew/commands/DescribeDatasetCommand.ts index f7b939124238d..a405b15606643 100644 --- a/clients/client-databrew/commands/DescribeDatasetCommand.ts +++ b/clients/client-databrew/commands/DescribeDatasetCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDatasetCommandInput = DescribeDatasetRequest; export type DescribeDatasetCommandOutput = DescribeDatasetResponse & __MetadataBearer; +/** + *

Returns the definition of a specific AWS Glue DataBrew dataset that is in the current + * AWS account.

+ */ export class DescribeDatasetCommand extends $Command< DescribeDatasetCommandInput, DescribeDatasetCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DescribeJobCommand.ts b/clients/client-databrew/commands/DescribeJobCommand.ts index 2aa1e983aecba..112dde489f8ec 100644 --- a/clients/client-databrew/commands/DescribeJobCommand.ts +++ b/clients/client-databrew/commands/DescribeJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeJobCommandInput = DescribeJobRequest; export type DescribeJobCommandOutput = DescribeJobResponse & __MetadataBearer; +/** + *

Returns the definition of a specific AWS Glue DataBrew job that is in the current AWS + * account.

+ */ export class DescribeJobCommand extends $Command< DescribeJobCommandInput, DescribeJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DescribeProjectCommand.ts b/clients/client-databrew/commands/DescribeProjectCommand.ts index 4bb2ce0a42098..14d76890e2060 100644 --- a/clients/client-databrew/commands/DescribeProjectCommand.ts +++ b/clients/client-databrew/commands/DescribeProjectCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeProjectCommandInput = DescribeProjectRequest; export type DescribeProjectCommandOutput = DescribeProjectResponse & __MetadataBearer; +/** + *

Returns the definition of a specific AWS Glue DataBrew project that is in the current + * AWS account.

+ */ export class DescribeProjectCommand extends $Command< DescribeProjectCommandInput, DescribeProjectCommandOutput, @@ -34,6 +38,9 @@ export class DescribeProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DescribeRecipeCommand.ts b/clients/client-databrew/commands/DescribeRecipeCommand.ts index 0d363aa20d1a1..83e176eb778ea 100644 --- a/clients/client-databrew/commands/DescribeRecipeCommand.ts +++ b/clients/client-databrew/commands/DescribeRecipeCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeRecipeCommandInput = DescribeRecipeRequest; export type DescribeRecipeCommandOutput = DescribeRecipeResponse & __MetadataBearer; +/** + *

Returns the definition of a specific AWS Glue DataBrew recipe that is in the current + * AWS account.

+ */ export class DescribeRecipeCommand extends $Command< DescribeRecipeCommandInput, DescribeRecipeCommandOutput, @@ -34,6 +38,9 @@ export class DescribeRecipeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/DescribeScheduleCommand.ts b/clients/client-databrew/commands/DescribeScheduleCommand.ts index fe417cce608c3..9d95ca8d682d9 100644 --- a/clients/client-databrew/commands/DescribeScheduleCommand.ts +++ b/clients/client-databrew/commands/DescribeScheduleCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeScheduleCommandInput = DescribeScheduleRequest; export type DescribeScheduleCommandOutput = DescribeScheduleResponse & __MetadataBearer; +/** + *

Returns the definition of a specific AWS Glue DataBrew schedule that is in the current + * AWS account.

+ */ export class DescribeScheduleCommand extends $Command< DescribeScheduleCommandInput, DescribeScheduleCommandOutput, @@ -34,6 +38,9 @@ export class DescribeScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/ListDatasetsCommand.ts b/clients/client-databrew/commands/ListDatasetsCommand.ts index 095762bd8529c..c0c69f4d8ae2f 100644 --- a/clients/client-databrew/commands/ListDatasetsCommand.ts +++ b/clients/client-databrew/commands/ListDatasetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDatasetsCommandInput = ListDatasetsRequest; export type ListDatasetsCommandOutput = ListDatasetsResponse & __MetadataBearer; +/** + *

Lists all of the AWS Glue DataBrew datasets for the current AWS account.

+ */ export class ListDatasetsCommand extends $Command< ListDatasetsCommandInput, ListDatasetsCommandOutput, @@ -34,6 +37,9 @@ export class ListDatasetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/ListJobRunsCommand.ts b/clients/client-databrew/commands/ListJobRunsCommand.ts index a16afb22df855..be2316692cd43 100644 --- a/clients/client-databrew/commands/ListJobRunsCommand.ts +++ b/clients/client-databrew/commands/ListJobRunsCommand.ts @@ -20,6 +20,10 @@ import { export type ListJobRunsCommandInput = ListJobRunsRequest; export type ListJobRunsCommandOutput = ListJobRunsResponse & __MetadataBearer; +/** + *

Lists all of the previous runs of a particular AWS Glue DataBrew job in the current + * AWS account.

+ */ export class ListJobRunsCommand extends $Command< ListJobRunsCommandInput, ListJobRunsCommandOutput, @@ -34,6 +38,9 @@ export class ListJobRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/ListJobsCommand.ts b/clients/client-databrew/commands/ListJobsCommand.ts index 28569f439b55e..c5a145b81d089 100644 --- a/clients/client-databrew/commands/ListJobsCommand.ts +++ b/clients/client-databrew/commands/ListJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResponse & __MetadataBearer; +/** + *

Lists the AWS Glue DataBrew jobs in the current AWS account.

+ */ export class ListJobsCommand extends $Command< ListJobsCommandInput, ListJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/ListProjectsCommand.ts b/clients/client-databrew/commands/ListProjectsCommand.ts index 5b9a1613fc8c2..d52e1e3056a98 100644 --- a/clients/client-databrew/commands/ListProjectsCommand.ts +++ b/clients/client-databrew/commands/ListProjectsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProjectsCommandInput = ListProjectsRequest; export type ListProjectsCommandOutput = ListProjectsResponse & __MetadataBearer; +/** + *

Lists all of the DataBrew projects in the current AWS account.

+ */ export class ListProjectsCommand extends $Command< ListProjectsCommandInput, ListProjectsCommandOutput, @@ -34,6 +37,9 @@ export class ListProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/ListRecipeVersionsCommand.ts b/clients/client-databrew/commands/ListRecipeVersionsCommand.ts index 4b5033ed738d8..3c91aaf680e02 100644 --- a/clients/client-databrew/commands/ListRecipeVersionsCommand.ts +++ b/clients/client-databrew/commands/ListRecipeVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListRecipeVersionsCommandInput = ListRecipeVersionsRequest; export type ListRecipeVersionsCommandOutput = ListRecipeVersionsResponse & __MetadataBearer; +/** + *

Lists all of the versions of a particular AWS Glue DataBrew recipe in the current AWS + * account.

+ */ export class ListRecipeVersionsCommand extends $Command< ListRecipeVersionsCommandInput, ListRecipeVersionsCommandOutput, @@ -34,6 +38,9 @@ export class ListRecipeVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/ListRecipesCommand.ts b/clients/client-databrew/commands/ListRecipesCommand.ts index b9c7bad065b57..831b9ac14cca6 100644 --- a/clients/client-databrew/commands/ListRecipesCommand.ts +++ b/clients/client-databrew/commands/ListRecipesCommand.ts @@ -20,6 +20,9 @@ import { export type ListRecipesCommandInput = ListRecipesRequest; export type ListRecipesCommandOutput = ListRecipesResponse & __MetadataBearer; +/** + *

Lists all of the AWS Glue DataBrew recipes in the current AWS account.

+ */ export class ListRecipesCommand extends $Command< ListRecipesCommandInput, ListRecipesCommandOutput, @@ -34,6 +37,9 @@ export class ListRecipesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/ListSchedulesCommand.ts b/clients/client-databrew/commands/ListSchedulesCommand.ts index 0c62e37a99b06..27640a21b95e7 100644 --- a/clients/client-databrew/commands/ListSchedulesCommand.ts +++ b/clients/client-databrew/commands/ListSchedulesCommand.ts @@ -20,6 +20,9 @@ import { export type ListSchedulesCommandInput = ListSchedulesRequest; export type ListSchedulesCommandOutput = ListSchedulesResponse & __MetadataBearer; +/** + *

Lists the AWS Glue DataBrew schedules in the current AWS account.

+ */ export class ListSchedulesCommand extends $Command< ListSchedulesCommandInput, ListSchedulesCommandOutput, @@ -34,6 +37,9 @@ export class ListSchedulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/ListTagsForResourceCommand.ts b/clients/client-databrew/commands/ListTagsForResourceCommand.ts index 74bbeeda0a4a9..7d72c1dad0e24 100644 --- a/clients/client-databrew/commands/ListTagsForResourceCommand.ts +++ b/clients/client-databrew/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists all the tags for an AWS Glue DataBrew resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/PublishRecipeCommand.ts b/clients/client-databrew/commands/PublishRecipeCommand.ts index 7933ee7dd8dde..ae35159a7f0ad 100644 --- a/clients/client-databrew/commands/PublishRecipeCommand.ts +++ b/clients/client-databrew/commands/PublishRecipeCommand.ts @@ -20,6 +20,10 @@ import { export type PublishRecipeCommandInput = PublishRecipeRequest; export type PublishRecipeCommandOutput = PublishRecipeResponse & __MetadataBearer; +/** + *

Publishes a new major version of an AWS Glue DataBrew recipe that exists in the + * current AWS account.

+ */ export class PublishRecipeCommand extends $Command< PublishRecipeCommandInput, PublishRecipeCommandOutput, @@ -34,6 +38,9 @@ export class PublishRecipeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/SendProjectSessionActionCommand.ts b/clients/client-databrew/commands/SendProjectSessionActionCommand.ts index 84ecef1406929..9b291ee7b4d68 100644 --- a/clients/client-databrew/commands/SendProjectSessionActionCommand.ts +++ b/clients/client-databrew/commands/SendProjectSessionActionCommand.ts @@ -20,6 +20,10 @@ import { export type SendProjectSessionActionCommandInput = SendProjectSessionActionRequest; export type SendProjectSessionActionCommandOutput = SendProjectSessionActionResponse & __MetadataBearer; +/** + *

Performs a recipe step within an interactive AWS Glue DataBrew session that's + * currently open.

+ */ export class SendProjectSessionActionCommand extends $Command< SendProjectSessionActionCommandInput, SendProjectSessionActionCommandOutput, @@ -34,6 +38,9 @@ export class SendProjectSessionActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/StartJobRunCommand.ts b/clients/client-databrew/commands/StartJobRunCommand.ts index c047f0a772b4a..bc048386504bf 100644 --- a/clients/client-databrew/commands/StartJobRunCommand.ts +++ b/clients/client-databrew/commands/StartJobRunCommand.ts @@ -20,6 +20,9 @@ import { export type StartJobRunCommandInput = StartJobRunRequest; export type StartJobRunCommandOutput = StartJobRunResponse & __MetadataBearer; +/** + *

Runs an AWS Glue DataBrew job that exists in the current AWS account.

+ */ export class StartJobRunCommand extends $Command< StartJobRunCommandInput, StartJobRunCommandOutput, @@ -34,6 +37,9 @@ export class StartJobRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/StartProjectSessionCommand.ts b/clients/client-databrew/commands/StartProjectSessionCommand.ts index d78f4c961b39d..8513f3178626e 100644 --- a/clients/client-databrew/commands/StartProjectSessionCommand.ts +++ b/clients/client-databrew/commands/StartProjectSessionCommand.ts @@ -20,6 +20,10 @@ import { export type StartProjectSessionCommandInput = StartProjectSessionRequest; export type StartProjectSessionCommandOutput = StartProjectSessionResponse & __MetadataBearer; +/** + *

Creates an interactive session, enabling you to manipulate an AWS Glue DataBrew + * project.

+ */ export class StartProjectSessionCommand extends $Command< StartProjectSessionCommandInput, StartProjectSessionCommandOutput, @@ -34,6 +38,9 @@ export class StartProjectSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/StopJobRunCommand.ts b/clients/client-databrew/commands/StopJobRunCommand.ts index def2ed1dc4380..83a2139c35504 100644 --- a/clients/client-databrew/commands/StopJobRunCommand.ts +++ b/clients/client-databrew/commands/StopJobRunCommand.ts @@ -20,6 +20,9 @@ import { export type StopJobRunCommandInput = StopJobRunRequest; export type StopJobRunCommandOutput = StopJobRunResponse & __MetadataBearer; +/** + *

Stops the specified job from running in the current AWS account.

+ */ export class StopJobRunCommand extends $Command< StopJobRunCommandInput, StopJobRunCommandOutput, @@ -34,6 +37,9 @@ export class StopJobRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/TagResourceCommand.ts b/clients/client-databrew/commands/TagResourceCommand.ts index 916890636ba39..ee1d705de2e47 100644 --- a/clients/client-databrew/commands/TagResourceCommand.ts +++ b/clients/client-databrew/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds metadata tags to an AWS Glue DataBrew resource, such as a dataset, job, project, + * or recipe.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/UntagResourceCommand.ts b/clients/client-databrew/commands/UntagResourceCommand.ts index 5f86ca1d58e9f..71e04dfb8c950 100644 --- a/clients/client-databrew/commands/UntagResourceCommand.ts +++ b/clients/client-databrew/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes metadata tags from an AWS Glue DataBrew resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/UpdateDatasetCommand.ts b/clients/client-databrew/commands/UpdateDatasetCommand.ts index 5a2b37ac4a311..f566685f6a7ec 100644 --- a/clients/client-databrew/commands/UpdateDatasetCommand.ts +++ b/clients/client-databrew/commands/UpdateDatasetCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDatasetCommandInput = UpdateDatasetRequest; export type UpdateDatasetCommandOutput = UpdateDatasetResponse & __MetadataBearer; +/** + *

Modifies the definition of an existing AWS Glue DataBrew dataset in the current AWS + * account.

+ */ export class UpdateDatasetCommand extends $Command< UpdateDatasetCommandInput, UpdateDatasetCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/UpdateProfileJobCommand.ts b/clients/client-databrew/commands/UpdateProfileJobCommand.ts index d017aa986727e..a33e322468bb2 100644 --- a/clients/client-databrew/commands/UpdateProfileJobCommand.ts +++ b/clients/client-databrew/commands/UpdateProfileJobCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateProfileJobCommandInput = UpdateProfileJobRequest; export type UpdateProfileJobCommandOutput = UpdateProfileJobResponse & __MetadataBearer; +/** + *

Modifies the definition of an existing AWS Glue DataBrew job in the current AWS + * account.

+ */ export class UpdateProfileJobCommand extends $Command< UpdateProfileJobCommandInput, UpdateProfileJobCommandOutput, @@ -34,6 +38,9 @@ export class UpdateProfileJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/UpdateProjectCommand.ts b/clients/client-databrew/commands/UpdateProjectCommand.ts index d7fe23e74e2e0..e5bdf26af5f0e 100644 --- a/clients/client-databrew/commands/UpdateProjectCommand.ts +++ b/clients/client-databrew/commands/UpdateProjectCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateProjectCommandInput = UpdateProjectRequest; export type UpdateProjectCommandOutput = UpdateProjectResponse & __MetadataBearer; +/** + *

Modifies the definition of an existing AWS Glue DataBrew project in the current AWS + * account.

+ */ export class UpdateProjectCommand extends $Command< UpdateProjectCommandInput, UpdateProjectCommandOutput, @@ -34,6 +38,9 @@ export class UpdateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/UpdateRecipeCommand.ts b/clients/client-databrew/commands/UpdateRecipeCommand.ts index 87d335164f5ba..1eda229f75c94 100644 --- a/clients/client-databrew/commands/UpdateRecipeCommand.ts +++ b/clients/client-databrew/commands/UpdateRecipeCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateRecipeCommandInput = UpdateRecipeRequest; export type UpdateRecipeCommandOutput = UpdateRecipeResponse & __MetadataBearer; +/** + *

Modifies the definition of the latest working version of an AWS Glue DataBrew recipe + * in the current AWS account.

+ */ export class UpdateRecipeCommand extends $Command< UpdateRecipeCommandInput, UpdateRecipeCommandOutput, @@ -34,6 +38,9 @@ export class UpdateRecipeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/UpdateRecipeJobCommand.ts b/clients/client-databrew/commands/UpdateRecipeJobCommand.ts index b9b1aeadce0d0..3cc0e3a6263a9 100644 --- a/clients/client-databrew/commands/UpdateRecipeJobCommand.ts +++ b/clients/client-databrew/commands/UpdateRecipeJobCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateRecipeJobCommandInput = UpdateRecipeJobRequest; export type UpdateRecipeJobCommandOutput = UpdateRecipeJobResponse & __MetadataBearer; +/** + *

Modifies the definition of an existing AWS Glue DataBrew recipe job in the current AWS + * account.

+ */ export class UpdateRecipeJobCommand extends $Command< UpdateRecipeJobCommandInput, UpdateRecipeJobCommandOutput, @@ -34,6 +38,9 @@ export class UpdateRecipeJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/commands/UpdateScheduleCommand.ts b/clients/client-databrew/commands/UpdateScheduleCommand.ts index d75d30af985bb..bc97198275be7 100644 --- a/clients/client-databrew/commands/UpdateScheduleCommand.ts +++ b/clients/client-databrew/commands/UpdateScheduleCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateScheduleCommandInput = UpdateScheduleRequest; export type UpdateScheduleCommandOutput = UpdateScheduleResponse & __MetadataBearer; +/** + *

Modifies the definition of an existing AWS Glue DataBrew schedule in the current AWS + * account.

+ */ export class UpdateScheduleCommand extends $Command< UpdateScheduleCommandInput, UpdateScheduleCommandOutput, @@ -34,6 +38,9 @@ export class UpdateScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataBrewClientResolvedConfig, diff --git a/clients/client-databrew/package.json b/clients/client-databrew/package.json index d80109b7e5c48..2e7caee821877 100644 --- a/clients/client-databrew/package.json +++ b/clients/client-databrew/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Databrew Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-databrew/pagination/ListDatasetsPaginator.ts b/clients/client-databrew/pagination/ListDatasetsPaginator.ts index 0269bf6f80d30..9f696624b4bec 100644 --- a/clients/client-databrew/pagination/ListDatasetsPaginator.ts +++ b/clients/client-databrew/pagination/ListDatasetsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataBrewPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataBrewClient, input: ListDatasetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataBrew, input: ListDatasetsCommandInput, diff --git a/clients/client-databrew/pagination/ListJobRunsPaginator.ts b/clients/client-databrew/pagination/ListJobRunsPaginator.ts index d3e8611f1594a..c82c597b21564 100644 --- a/clients/client-databrew/pagination/ListJobRunsPaginator.ts +++ b/clients/client-databrew/pagination/ListJobRunsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobRunsCommand, ListJobRunsCommandInput, ListJobRunsCommandOutput } import { DataBrewPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataBrewClient, input: ListJobRunsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataBrew, input: ListJobRunsCommandInput, diff --git a/clients/client-databrew/pagination/ListJobsPaginator.ts b/clients/client-databrew/pagination/ListJobsPaginator.ts index 0919bc3816184..e21718e028dce 100644 --- a/clients/client-databrew/pagination/ListJobsPaginator.ts +++ b/clients/client-databrew/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { DataBrewPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataBrewClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataBrew, input: ListJobsCommandInput, diff --git a/clients/client-databrew/pagination/ListProjectsPaginator.ts b/clients/client-databrew/pagination/ListProjectsPaginator.ts index 11669f88a09e9..c44b5b9194e12 100644 --- a/clients/client-databrew/pagination/ListProjectsPaginator.ts +++ b/clients/client-databrew/pagination/ListProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataBrewPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataBrewClient, input: ListProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataBrew, input: ListProjectsCommandInput, diff --git a/clients/client-databrew/pagination/ListRecipeVersionsPaginator.ts b/clients/client-databrew/pagination/ListRecipeVersionsPaginator.ts index af6387e7b4055..96a71d4ffd488 100644 --- a/clients/client-databrew/pagination/ListRecipeVersionsPaginator.ts +++ b/clients/client-databrew/pagination/ListRecipeVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataBrewPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataBrewClient, input: ListRecipeVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRecipeVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataBrew, input: ListRecipeVersionsCommandInput, diff --git a/clients/client-databrew/pagination/ListRecipesPaginator.ts b/clients/client-databrew/pagination/ListRecipesPaginator.ts index a8372e1a92fbb..d577fc69b44dd 100644 --- a/clients/client-databrew/pagination/ListRecipesPaginator.ts +++ b/clients/client-databrew/pagination/ListRecipesPaginator.ts @@ -4,6 +4,9 @@ import { ListRecipesCommand, ListRecipesCommandInput, ListRecipesCommandOutput } import { DataBrewPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataBrewClient, input: ListRecipesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRecipesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataBrew, input: ListRecipesCommandInput, diff --git a/clients/client-databrew/pagination/ListSchedulesPaginator.ts b/clients/client-databrew/pagination/ListSchedulesPaginator.ts index 54a76038c48c3..fe5c23886ebfb 100644 --- a/clients/client-databrew/pagination/ListSchedulesPaginator.ts +++ b/clients/client-databrew/pagination/ListSchedulesPaginator.ts @@ -8,6 +8,9 @@ import { import { DataBrewPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataBrewClient, input: ListSchedulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSchedulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataBrew, input: ListSchedulesCommandInput, diff --git a/clients/client-databrew/runtimeConfig.browser.ts b/clients/client-databrew/runtimeConfig.browser.ts index 227fac2239a97..8a58d45a97968 100644 --- a/clients/client-databrew/runtimeConfig.browser.ts +++ b/clients/client-databrew/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DataBrewClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-databrew/runtimeConfig.native.ts b/clients/client-databrew/runtimeConfig.native.ts index 0ca6302c47f75..fa48ccf8dc742 100644 --- a/clients/client-databrew/runtimeConfig.native.ts +++ b/clients/client-databrew/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DataBrewClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-databrew/runtimeConfig.shared.ts b/clients/client-databrew/runtimeConfig.shared.ts index 1aa9de937f56e..a163c9e32b225 100644 --- a/clients/client-databrew/runtimeConfig.shared.ts +++ b/clients/client-databrew/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-25", disableHostPrefix: false, diff --git a/clients/client-databrew/runtimeConfig.ts b/clients/client-databrew/runtimeConfig.ts index 9a9a226ee11fb..f349e2a52150c 100644 --- a/clients/client-databrew/runtimeConfig.ts +++ b/clients/client-databrew/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DataBrewClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-databrew/tsconfig.json b/clients/client-databrew/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-databrew/tsconfig.json +++ b/clients/client-databrew/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-dataexchange/commands/CancelJobCommand.ts b/clients/client-dataexchange/commands/CancelJobCommand.ts index 1154acea7ac28..50a3b20970479 100644 --- a/clients/client-dataexchange/commands/CancelJobCommand.ts +++ b/clients/client-dataexchange/commands/CancelJobCommand.ts @@ -20,6 +20,9 @@ import { export type CancelJobCommandInput = CancelJobRequest; export type CancelJobCommandOutput = __MetadataBearer; +/** + *

This operation cancels a job. Jobs can be cancelled only when they are in the WAITING state.

+ */ export class CancelJobCommand extends $Command< CancelJobCommandInput, CancelJobCommandOutput, @@ -34,6 +37,9 @@ export class CancelJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/CreateDataSetCommand.ts b/clients/client-dataexchange/commands/CreateDataSetCommand.ts index bffa010c6ad95..43275a0e7f513 100644 --- a/clients/client-dataexchange/commands/CreateDataSetCommand.ts +++ b/clients/client-dataexchange/commands/CreateDataSetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDataSetCommandInput = CreateDataSetRequest; export type CreateDataSetCommandOutput = CreateDataSetResponse & __MetadataBearer; +/** + *

This operation creates a data set.

+ */ export class CreateDataSetCommand extends $Command< CreateDataSetCommandInput, CreateDataSetCommandOutput, @@ -34,6 +37,9 @@ export class CreateDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/CreateJobCommand.ts b/clients/client-dataexchange/commands/CreateJobCommand.ts index d08fba9b138b1..9985b5bbd4cc4 100644 --- a/clients/client-dataexchange/commands/CreateJobCommand.ts +++ b/clients/client-dataexchange/commands/CreateJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateJobCommandInput = CreateJobRequest; export type CreateJobCommandOutput = CreateJobResponse & __MetadataBearer; +/** + *

This operation creates a job.

+ */ export class CreateJobCommand extends $Command< CreateJobCommandInput, CreateJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/CreateRevisionCommand.ts b/clients/client-dataexchange/commands/CreateRevisionCommand.ts index 5a32f7360b69a..e8dfc8c1ff6f5 100644 --- a/clients/client-dataexchange/commands/CreateRevisionCommand.ts +++ b/clients/client-dataexchange/commands/CreateRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRevisionCommandInput = CreateRevisionRequest; export type CreateRevisionCommandOutput = CreateRevisionResponse & __MetadataBearer; +/** + *

This operation creates a revision for a data set.

+ */ export class CreateRevisionCommand extends $Command< CreateRevisionCommandInput, CreateRevisionCommandOutput, @@ -34,6 +37,9 @@ export class CreateRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/DeleteAssetCommand.ts b/clients/client-dataexchange/commands/DeleteAssetCommand.ts index d4743fc5e80a9..27a59b0ec09c7 100644 --- a/clients/client-dataexchange/commands/DeleteAssetCommand.ts +++ b/clients/client-dataexchange/commands/DeleteAssetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAssetCommandInput = DeleteAssetRequest; export type DeleteAssetCommandOutput = __MetadataBearer; +/** + *

This operation deletes an asset.

+ */ export class DeleteAssetCommand extends $Command< DeleteAssetCommandInput, DeleteAssetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/DeleteDataSetCommand.ts b/clients/client-dataexchange/commands/DeleteDataSetCommand.ts index 21236442bf2af..11f66fa0a2fb2 100644 --- a/clients/client-dataexchange/commands/DeleteDataSetCommand.ts +++ b/clients/client-dataexchange/commands/DeleteDataSetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDataSetCommandInput = DeleteDataSetRequest; export type DeleteDataSetCommandOutput = __MetadataBearer; +/** + *

This operation deletes a data set.

+ */ export class DeleteDataSetCommand extends $Command< DeleteDataSetCommandInput, DeleteDataSetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/DeleteRevisionCommand.ts b/clients/client-dataexchange/commands/DeleteRevisionCommand.ts index 2ef12876e8cb6..7a35487f6a706 100644 --- a/clients/client-dataexchange/commands/DeleteRevisionCommand.ts +++ b/clients/client-dataexchange/commands/DeleteRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRevisionCommandInput = DeleteRevisionRequest; export type DeleteRevisionCommandOutput = __MetadataBearer; +/** + *

This operation deletes a revision.

+ */ export class DeleteRevisionCommand extends $Command< DeleteRevisionCommandInput, DeleteRevisionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/GetAssetCommand.ts b/clients/client-dataexchange/commands/GetAssetCommand.ts index 1fa22f7ea6d1d..0d4e04608da11 100644 --- a/clients/client-dataexchange/commands/GetAssetCommand.ts +++ b/clients/client-dataexchange/commands/GetAssetCommand.ts @@ -20,6 +20,9 @@ import { export type GetAssetCommandInput = GetAssetRequest; export type GetAssetCommandOutput = GetAssetResponse & __MetadataBearer; +/** + *

This operation returns information about an asset.

+ */ export class GetAssetCommand extends $Command< GetAssetCommandInput, GetAssetCommandOutput, @@ -34,6 +37,9 @@ export class GetAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/GetDataSetCommand.ts b/clients/client-dataexchange/commands/GetDataSetCommand.ts index 0ea4cbcd0fa4e..d15f1a5392ab7 100644 --- a/clients/client-dataexchange/commands/GetDataSetCommand.ts +++ b/clients/client-dataexchange/commands/GetDataSetCommand.ts @@ -20,6 +20,9 @@ import { export type GetDataSetCommandInput = GetDataSetRequest; export type GetDataSetCommandOutput = GetDataSetResponse & __MetadataBearer; +/** + *

This operation returns information about a data set.

+ */ export class GetDataSetCommand extends $Command< GetDataSetCommandInput, GetDataSetCommandOutput, @@ -34,6 +37,9 @@ export class GetDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/GetJobCommand.ts b/clients/client-dataexchange/commands/GetJobCommand.ts index 9c56fc2c286f8..99a95e0c17fa9 100644 --- a/clients/client-dataexchange/commands/GetJobCommand.ts +++ b/clients/client-dataexchange/commands/GetJobCommand.ts @@ -17,6 +17,9 @@ import { export type GetJobCommandInput = GetJobRequest; export type GetJobCommandOutput = GetJobResponse & __MetadataBearer; +/** + *

This operation returns information about a job.

+ */ export class GetJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetJobCommand extends $Command, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/GetRevisionCommand.ts b/clients/client-dataexchange/commands/GetRevisionCommand.ts index 6855f6ce60294..722290cd2702b 100644 --- a/clients/client-dataexchange/commands/GetRevisionCommand.ts +++ b/clients/client-dataexchange/commands/GetRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type GetRevisionCommandInput = GetRevisionRequest; export type GetRevisionCommandOutput = GetRevisionResponse & __MetadataBearer; +/** + *

This operation returns information about a revision.

+ */ export class GetRevisionCommand extends $Command< GetRevisionCommandInput, GetRevisionCommandOutput, @@ -34,6 +37,9 @@ export class GetRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/ListDataSetRevisionsCommand.ts b/clients/client-dataexchange/commands/ListDataSetRevisionsCommand.ts index 043e819116586..911222ac13827 100644 --- a/clients/client-dataexchange/commands/ListDataSetRevisionsCommand.ts +++ b/clients/client-dataexchange/commands/ListDataSetRevisionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDataSetRevisionsCommandInput = ListDataSetRevisionsRequest; export type ListDataSetRevisionsCommandOutput = ListDataSetRevisionsResponse & __MetadataBearer; +/** + *

This operation lists a data set's revisions sorted by CreatedAt in descending order.

+ */ export class ListDataSetRevisionsCommand extends $Command< ListDataSetRevisionsCommandInput, ListDataSetRevisionsCommandOutput, @@ -34,6 +37,9 @@ export class ListDataSetRevisionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/ListDataSetsCommand.ts b/clients/client-dataexchange/commands/ListDataSetsCommand.ts index ce36c07746a35..f582dd57d62a9 100644 --- a/clients/client-dataexchange/commands/ListDataSetsCommand.ts +++ b/clients/client-dataexchange/commands/ListDataSetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDataSetsCommandInput = ListDataSetsRequest; export type ListDataSetsCommandOutput = ListDataSetsResponse & __MetadataBearer; +/** + *

This operation lists your data sets. When listing by origin OWNED, results are sorted by CreatedAt in descending order. When listing by origin ENTITLED, there is no order and the maxResults parameter is ignored.

+ */ export class ListDataSetsCommand extends $Command< ListDataSetsCommandInput, ListDataSetsCommandOutput, @@ -34,6 +37,9 @@ export class ListDataSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/ListJobsCommand.ts b/clients/client-dataexchange/commands/ListJobsCommand.ts index 1104c03e52aa8..7bf87c6add816 100644 --- a/clients/client-dataexchange/commands/ListJobsCommand.ts +++ b/clients/client-dataexchange/commands/ListJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResponse & __MetadataBearer; +/** + *

This operation lists your jobs sorted by CreatedAt in descending order.

+ */ export class ListJobsCommand extends $Command< ListJobsCommandInput, ListJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/ListRevisionAssetsCommand.ts b/clients/client-dataexchange/commands/ListRevisionAssetsCommand.ts index 0a20aa545ccdb..5b0243311bcd8 100644 --- a/clients/client-dataexchange/commands/ListRevisionAssetsCommand.ts +++ b/clients/client-dataexchange/commands/ListRevisionAssetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListRevisionAssetsCommandInput = ListRevisionAssetsRequest; export type ListRevisionAssetsCommandOutput = ListRevisionAssetsResponse & __MetadataBearer; +/** + *

This operation lists a revision's assets sorted alphabetically in descending order.

+ */ export class ListRevisionAssetsCommand extends $Command< ListRevisionAssetsCommandInput, ListRevisionAssetsCommandOutput, @@ -34,6 +37,9 @@ export class ListRevisionAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/ListTagsForResourceCommand.ts b/clients/client-dataexchange/commands/ListTagsForResourceCommand.ts index 2cc2b13ea0e43..506864aa2c46c 100644 --- a/clients/client-dataexchange/commands/ListTagsForResourceCommand.ts +++ b/clients/client-dataexchange/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

This operation lists the tags on the resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/StartJobCommand.ts b/clients/client-dataexchange/commands/StartJobCommand.ts index c1936e35d0d9f..934699846c776 100644 --- a/clients/client-dataexchange/commands/StartJobCommand.ts +++ b/clients/client-dataexchange/commands/StartJobCommand.ts @@ -20,6 +20,9 @@ import { export type StartJobCommandInput = StartJobRequest; export type StartJobCommandOutput = StartJobResponse & __MetadataBearer; +/** + *

This operation starts a job.

+ */ export class StartJobCommand extends $Command< StartJobCommandInput, StartJobCommandOutput, @@ -34,6 +37,9 @@ export class StartJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/TagResourceCommand.ts b/clients/client-dataexchange/commands/TagResourceCommand.ts index 1796b15854f08..15867bd82a73d 100644 --- a/clients/client-dataexchange/commands/TagResourceCommand.ts +++ b/clients/client-dataexchange/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

This operation tags a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/UntagResourceCommand.ts b/clients/client-dataexchange/commands/UntagResourceCommand.ts index d1859f4451773..6896059c86f7a 100644 --- a/clients/client-dataexchange/commands/UntagResourceCommand.ts +++ b/clients/client-dataexchange/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

This operation removes one or more tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/UpdateAssetCommand.ts b/clients/client-dataexchange/commands/UpdateAssetCommand.ts index 59733f16e76cd..f8da3c80c2764 100644 --- a/clients/client-dataexchange/commands/UpdateAssetCommand.ts +++ b/clients/client-dataexchange/commands/UpdateAssetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAssetCommandInput = UpdateAssetRequest; export type UpdateAssetCommandOutput = UpdateAssetResponse & __MetadataBearer; +/** + *

This operation updates an asset.

+ */ export class UpdateAssetCommand extends $Command< UpdateAssetCommandInput, UpdateAssetCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/UpdateDataSetCommand.ts b/clients/client-dataexchange/commands/UpdateDataSetCommand.ts index 547f228bbfb5d..de75cb7b215d1 100644 --- a/clients/client-dataexchange/commands/UpdateDataSetCommand.ts +++ b/clients/client-dataexchange/commands/UpdateDataSetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDataSetCommandInput = UpdateDataSetRequest; export type UpdateDataSetCommandOutput = UpdateDataSetResponse & __MetadataBearer; +/** + *

This operation updates a data set.

+ */ export class UpdateDataSetCommand extends $Command< UpdateDataSetCommandInput, UpdateDataSetCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/commands/UpdateRevisionCommand.ts b/clients/client-dataexchange/commands/UpdateRevisionCommand.ts index 309dcba05c902..e13b8ce11c629 100644 --- a/clients/client-dataexchange/commands/UpdateRevisionCommand.ts +++ b/clients/client-dataexchange/commands/UpdateRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRevisionCommandInput = UpdateRevisionRequest; export type UpdateRevisionCommandOutput = UpdateRevisionResponse & __MetadataBearer; +/** + *

This operation updates a revision.

+ */ export class UpdateRevisionCommand extends $Command< UpdateRevisionCommandInput, UpdateRevisionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataExchangeClientResolvedConfig, diff --git a/clients/client-dataexchange/package.json b/clients/client-dataexchange/package.json index 7656ffd62a077..7ad4554cbc826 100644 --- a/clients/client-dataexchange/package.json +++ b/clients/client-dataexchange/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Dataexchange Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-dataexchange/pagination/ListDataSetRevisionsPaginator.ts b/clients/client-dataexchange/pagination/ListDataSetRevisionsPaginator.ts index 4acf309a64bf7..6ec70a1f125d4 100644 --- a/clients/client-dataexchange/pagination/ListDataSetRevisionsPaginator.ts +++ b/clients/client-dataexchange/pagination/ListDataSetRevisionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataExchangePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataExchangeClient, input: ListDataSetRevisionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDataSetRevisionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataExchange, input: ListDataSetRevisionsCommandInput, diff --git a/clients/client-dataexchange/pagination/ListDataSetsPaginator.ts b/clients/client-dataexchange/pagination/ListDataSetsPaginator.ts index 26db3bc0149a2..1186a9b8d8fe1 100644 --- a/clients/client-dataexchange/pagination/ListDataSetsPaginator.ts +++ b/clients/client-dataexchange/pagination/ListDataSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataExchangePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataExchangeClient, input: ListDataSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDataSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataExchange, input: ListDataSetsCommandInput, diff --git a/clients/client-dataexchange/pagination/ListJobsPaginator.ts b/clients/client-dataexchange/pagination/ListJobsPaginator.ts index d2f9057bf02f9..e98fb351d5fba 100644 --- a/clients/client-dataexchange/pagination/ListJobsPaginator.ts +++ b/clients/client-dataexchange/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { DataExchangePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataExchangeClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataExchange, input: ListJobsCommandInput, diff --git a/clients/client-dataexchange/pagination/ListRevisionAssetsPaginator.ts b/clients/client-dataexchange/pagination/ListRevisionAssetsPaginator.ts index 45708570eac5e..e931630630d32 100644 --- a/clients/client-dataexchange/pagination/ListRevisionAssetsPaginator.ts +++ b/clients/client-dataexchange/pagination/ListRevisionAssetsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataExchangePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataExchangeClient, input: ListRevisionAssetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRevisionAssetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataExchange, input: ListRevisionAssetsCommandInput, diff --git a/clients/client-dataexchange/runtimeConfig.browser.ts b/clients/client-dataexchange/runtimeConfig.browser.ts index de862855f3c6d..fe9e5ae646360 100644 --- a/clients/client-dataexchange/runtimeConfig.browser.ts +++ b/clients/client-dataexchange/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DataExchangeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-dataexchange/runtimeConfig.native.ts b/clients/client-dataexchange/runtimeConfig.native.ts index f815767682905..e255fb75e86be 100644 --- a/clients/client-dataexchange/runtimeConfig.native.ts +++ b/clients/client-dataexchange/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DataExchangeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-dataexchange/runtimeConfig.shared.ts b/clients/client-dataexchange/runtimeConfig.shared.ts index 54131ece225c5..43405f2bfcfc9 100644 --- a/clients/client-dataexchange/runtimeConfig.shared.ts +++ b/clients/client-dataexchange/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-25", disableHostPrefix: false, diff --git a/clients/client-dataexchange/runtimeConfig.ts b/clients/client-dataexchange/runtimeConfig.ts index ec030aa1b3d97..68d2306ee16fb 100644 --- a/clients/client-dataexchange/runtimeConfig.ts +++ b/clients/client-dataexchange/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DataExchangeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-dataexchange/tsconfig.json b/clients/client-dataexchange/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-dataexchange/tsconfig.json +++ b/clients/client-dataexchange/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-datasync/commands/CancelTaskExecutionCommand.ts b/clients/client-datasync/commands/CancelTaskExecutionCommand.ts index 1781b00751a03..9346693097a29 100644 --- a/clients/client-datasync/commands/CancelTaskExecutionCommand.ts +++ b/clients/client-datasync/commands/CancelTaskExecutionCommand.ts @@ -20,6 +20,16 @@ import { export type CancelTaskExecutionCommandInput = CancelTaskExecutionRequest; export type CancelTaskExecutionCommandOutput = CancelTaskExecutionResponse & __MetadataBearer; +/** + *

Cancels execution of a task.

+ *

When you cancel a task execution, the transfer of some files is abruptly interrupted. + * The contents of files that are transferred to the destination might be incomplete or + * inconsistent with the source files. However, if you start a new task execution on the same + * task and you allow the task execution to complete, file content on the destination is complete + * and consistent. This applies to other unexpected failures that interrupt a task execution. In + * all of these cases, AWS DataSync successfully complete the transfer when you start the next + * task execution.

+ */ export class CancelTaskExecutionCommand extends $Command< CancelTaskExecutionCommandInput, CancelTaskExecutionCommandOutput, @@ -34,6 +44,9 @@ export class CancelTaskExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/CreateAgentCommand.ts b/clients/client-datasync/commands/CreateAgentCommand.ts index e73e5c75bdccf..a55e92640c5c8 100644 --- a/clients/client-datasync/commands/CreateAgentCommand.ts +++ b/clients/client-datasync/commands/CreateAgentCommand.ts @@ -20,6 +20,23 @@ import { export type CreateAgentCommandInput = CreateAgentRequest; export type CreateAgentCommandOutput = CreateAgentResponse & __MetadataBearer; +/** + *

Activates an AWS DataSync agent that you have deployed on your host. The activation + * process associates your agent with your account. In the activation process, you specify + * information such as the AWS Region that you want to activate the agent in. You activate the + * agent in the AWS Region where your target locations (in Amazon S3 or Amazon EFS) reside. Your + * tasks are created in this AWS Region.

+ *

You can activate the agent in a VPC (virtual private cloud) or provide the agent access to + * a VPC endpoint so you can run tasks without going over the public internet.

+ *

You can use an agent for more than one location. If a task uses multiple agents, all of + * them need to have status AVAILABLE for the task to run. If you use multiple agents for a + * source location, the status of all the agents must be AVAILABLE for the task to run.

+ * + * + *

Agents are automatically updated by AWS on a regular basis, using a mechanism that + * ensures minimal interruption to your tasks.

+ *

+ */ export class CreateAgentCommand extends $Command< CreateAgentCommandInput, CreateAgentCommandOutput, @@ -34,6 +51,9 @@ export class CreateAgentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/CreateLocationEfsCommand.ts b/clients/client-datasync/commands/CreateLocationEfsCommand.ts index 3ca9020207906..6f224e4b94da6 100644 --- a/clients/client-datasync/commands/CreateLocationEfsCommand.ts +++ b/clients/client-datasync/commands/CreateLocationEfsCommand.ts @@ -20,6 +20,9 @@ import { export type CreateLocationEfsCommandInput = CreateLocationEfsRequest; export type CreateLocationEfsCommandOutput = CreateLocationEfsResponse & __MetadataBearer; +/** + *

Creates an endpoint for an Amazon EFS file system.

+ */ export class CreateLocationEfsCommand extends $Command< CreateLocationEfsCommandInput, CreateLocationEfsCommandOutput, @@ -34,6 +37,9 @@ export class CreateLocationEfsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/CreateLocationFsxWindowsCommand.ts b/clients/client-datasync/commands/CreateLocationFsxWindowsCommand.ts index a6f5f71f6dabd..1de67a65e98b4 100644 --- a/clients/client-datasync/commands/CreateLocationFsxWindowsCommand.ts +++ b/clients/client-datasync/commands/CreateLocationFsxWindowsCommand.ts @@ -20,6 +20,9 @@ import { export type CreateLocationFsxWindowsCommandInput = CreateLocationFsxWindowsRequest; export type CreateLocationFsxWindowsCommandOutput = CreateLocationFsxWindowsResponse & __MetadataBearer; +/** + *

Creates an endpoint for an Amazon FSx for Windows file system.

+ */ export class CreateLocationFsxWindowsCommand extends $Command< CreateLocationFsxWindowsCommandInput, CreateLocationFsxWindowsCommandOutput, @@ -34,6 +37,9 @@ export class CreateLocationFsxWindowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/CreateLocationNfsCommand.ts b/clients/client-datasync/commands/CreateLocationNfsCommand.ts index b2df8555217a2..6742952ce23ae 100644 --- a/clients/client-datasync/commands/CreateLocationNfsCommand.ts +++ b/clients/client-datasync/commands/CreateLocationNfsCommand.ts @@ -20,6 +20,10 @@ import { export type CreateLocationNfsCommandInput = CreateLocationNfsRequest; export type CreateLocationNfsCommandOutput = CreateLocationNfsResponse & __MetadataBearer; +/** + *

Defines a file system on a Network File System (NFS) server that can be read from or + * written to.

+ */ export class CreateLocationNfsCommand extends $Command< CreateLocationNfsCommandInput, CreateLocationNfsCommandOutput, @@ -34,6 +38,9 @@ export class CreateLocationNfsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/CreateLocationObjectStorageCommand.ts b/clients/client-datasync/commands/CreateLocationObjectStorageCommand.ts index 45e0579c7b898..bc78edf8c62bb 100644 --- a/clients/client-datasync/commands/CreateLocationObjectStorageCommand.ts +++ b/clients/client-datasync/commands/CreateLocationObjectStorageCommand.ts @@ -20,6 +20,10 @@ import { export type CreateLocationObjectStorageCommandInput = CreateLocationObjectStorageRequest; export type CreateLocationObjectStorageCommandOutput = CreateLocationObjectStorageResponse & __MetadataBearer; +/** + *

Creates an endpoint for a self-managed object storage bucket. For more information + * about self-managed object storage locations, see create-object-location.

+ */ export class CreateLocationObjectStorageCommand extends $Command< CreateLocationObjectStorageCommandInput, CreateLocationObjectStorageCommandOutput, @@ -34,6 +38,9 @@ export class CreateLocationObjectStorageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/CreateLocationS3Command.ts b/clients/client-datasync/commands/CreateLocationS3Command.ts index 86c18d31593ad..f93af5fea8e20 100644 --- a/clients/client-datasync/commands/CreateLocationS3Command.ts +++ b/clients/client-datasync/commands/CreateLocationS3Command.ts @@ -20,6 +20,15 @@ import { export type CreateLocationS3CommandInput = CreateLocationS3Request; export type CreateLocationS3CommandOutput = CreateLocationS3Response & __MetadataBearer; +/** + *

Creates an endpoint for an Amazon S3 bucket.

+ * + * + *

For + * more information, see + * https://docs.aws.amazon.com/datasync/latest/userguide/create-locations-cli.html#create-location-s3-cli + * in the AWS DataSync User Guide.

+ */ export class CreateLocationS3Command extends $Command< CreateLocationS3CommandInput, CreateLocationS3CommandOutput, @@ -34,6 +43,9 @@ export class CreateLocationS3Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/CreateLocationSmbCommand.ts b/clients/client-datasync/commands/CreateLocationSmbCommand.ts index 260d51ed20daa..1ebf85c5271cb 100644 --- a/clients/client-datasync/commands/CreateLocationSmbCommand.ts +++ b/clients/client-datasync/commands/CreateLocationSmbCommand.ts @@ -20,6 +20,10 @@ import { export type CreateLocationSmbCommandInput = CreateLocationSmbRequest; export type CreateLocationSmbCommandOutput = CreateLocationSmbResponse & __MetadataBearer; +/** + *

Defines a file system on a Server Message Block (SMB) server that can be read from or + * written to.

+ */ export class CreateLocationSmbCommand extends $Command< CreateLocationSmbCommandInput, CreateLocationSmbCommandOutput, @@ -34,6 +38,9 @@ export class CreateLocationSmbCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/CreateTaskCommand.ts b/clients/client-datasync/commands/CreateTaskCommand.ts index aec510bbecfae..969edfd4f8f57 100644 --- a/clients/client-datasync/commands/CreateTaskCommand.ts +++ b/clients/client-datasync/commands/CreateTaskCommand.ts @@ -20,6 +20,20 @@ import { export type CreateTaskCommandInput = CreateTaskRequest; export type CreateTaskCommandOutput = CreateTaskResponse & __MetadataBearer; +/** + *

Creates a task. A task is a set of two locations (source and destination) and a set of + * Options that you use to control the behavior of a task. If you don't specify Options when you + * create a task, AWS DataSync populates them with service defaults.

+ *

When you create a task, it first enters the CREATING state. During CREATING + * AWS DataSync attempts to mount the on-premises Network File System (NFS) location. The task + * transitions to the AVAILABLE state without waiting for the AWS location to become mounted. If + * required, AWS DataSync mounts the AWS location before each task execution.

+ *

If an agent that is associated with a source (NFS) location goes offline, the task + * transitions to the UNAVAILABLE status. If the status of the task remains in the CREATING + * status for more than a few minutes, it means that your agent might be having trouble mounting + * the source NFS file system. Check the task's ErrorCode and ErrorDetail. Mount issues are often + * caused by either a misconfigured firewall or a mistyped NFS server hostname.

+ */ export class CreateTaskCommand extends $Command< CreateTaskCommandInput, CreateTaskCommandOutput, @@ -34,6 +48,9 @@ export class CreateTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DeleteAgentCommand.ts b/clients/client-datasync/commands/DeleteAgentCommand.ts index f150efdd4fc2c..7bfcff65734f5 100644 --- a/clients/client-datasync/commands/DeleteAgentCommand.ts +++ b/clients/client-datasync/commands/DeleteAgentCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteAgentCommandInput = DeleteAgentRequest; export type DeleteAgentCommandOutput = DeleteAgentResponse & __MetadataBearer; +/** + *

Deletes an agent. To specify which agent to delete, use the Amazon Resource Name (ARN) + * of the agent in your request. The operation disassociates the agent from your AWS account. + * However, it doesn't delete the agent virtual machine (VM) from your on-premises + * environment.

+ */ export class DeleteAgentCommand extends $Command< DeleteAgentCommandInput, DeleteAgentCommandOutput, @@ -34,6 +40,9 @@ export class DeleteAgentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DeleteLocationCommand.ts b/clients/client-datasync/commands/DeleteLocationCommand.ts index c6af005c5a1b5..592da90207f3e 100644 --- a/clients/client-datasync/commands/DeleteLocationCommand.ts +++ b/clients/client-datasync/commands/DeleteLocationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLocationCommandInput = DeleteLocationRequest; export type DeleteLocationCommandOutput = DeleteLocationResponse & __MetadataBearer; +/** + *

Deletes the configuration of a location used by AWS DataSync.

+ */ export class DeleteLocationCommand extends $Command< DeleteLocationCommandInput, DeleteLocationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLocationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DeleteTaskCommand.ts b/clients/client-datasync/commands/DeleteTaskCommand.ts index 30334495331ee..c76b519de3c6e 100644 --- a/clients/client-datasync/commands/DeleteTaskCommand.ts +++ b/clients/client-datasync/commands/DeleteTaskCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTaskCommandInput = DeleteTaskRequest; export type DeleteTaskCommandOutput = DeleteTaskResponse & __MetadataBearer; +/** + *

Deletes a task.

+ */ export class DeleteTaskCommand extends $Command< DeleteTaskCommandInput, DeleteTaskCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeAgentCommand.ts b/clients/client-datasync/commands/DescribeAgentCommand.ts index 3696cdab615a6..96190d29a665f 100644 --- a/clients/client-datasync/commands/DescribeAgentCommand.ts +++ b/clients/client-datasync/commands/DescribeAgentCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAgentCommandInput = DescribeAgentRequest; export type DescribeAgentCommandOutput = DescribeAgentResponse & __MetadataBearer; +/** + *

Returns metadata such as the name, the network interfaces, and the status (that is, + * whether the agent is running or not) for an agent. To specify which agent to describe, use the + * Amazon Resource Name (ARN) of the agent in your request.

+ */ export class DescribeAgentCommand extends $Command< DescribeAgentCommandInput, DescribeAgentCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAgentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeLocationEfsCommand.ts b/clients/client-datasync/commands/DescribeLocationEfsCommand.ts index fdabd84938760..743f896878f0a 100644 --- a/clients/client-datasync/commands/DescribeLocationEfsCommand.ts +++ b/clients/client-datasync/commands/DescribeLocationEfsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLocationEfsCommandInput = DescribeLocationEfsRequest; export type DescribeLocationEfsCommandOutput = DescribeLocationEfsResponse & __MetadataBearer; +/** + *

Returns metadata, such as the path information about an Amazon EFS location.

+ */ export class DescribeLocationEfsCommand extends $Command< DescribeLocationEfsCommandInput, DescribeLocationEfsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLocationEfsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeLocationFsxWindowsCommand.ts b/clients/client-datasync/commands/DescribeLocationFsxWindowsCommand.ts index 962c485d2360f..2b978ed775a73 100644 --- a/clients/client-datasync/commands/DescribeLocationFsxWindowsCommand.ts +++ b/clients/client-datasync/commands/DescribeLocationFsxWindowsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLocationFsxWindowsCommandInput = DescribeLocationFsxWindowsRequest; export type DescribeLocationFsxWindowsCommandOutput = DescribeLocationFsxWindowsResponse & __MetadataBearer; +/** + *

Returns metadata, such as the path information about an Amazon FSx for Windows location.

+ */ export class DescribeLocationFsxWindowsCommand extends $Command< DescribeLocationFsxWindowsCommandInput, DescribeLocationFsxWindowsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLocationFsxWindowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeLocationNfsCommand.ts b/clients/client-datasync/commands/DescribeLocationNfsCommand.ts index 3707f733512ba..c090a1018d141 100644 --- a/clients/client-datasync/commands/DescribeLocationNfsCommand.ts +++ b/clients/client-datasync/commands/DescribeLocationNfsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLocationNfsCommandInput = DescribeLocationNfsRequest; export type DescribeLocationNfsCommandOutput = DescribeLocationNfsResponse & __MetadataBearer; +/** + *

Returns metadata, such as the path information, about an NFS location.

+ */ export class DescribeLocationNfsCommand extends $Command< DescribeLocationNfsCommandInput, DescribeLocationNfsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLocationNfsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeLocationObjectStorageCommand.ts b/clients/client-datasync/commands/DescribeLocationObjectStorageCommand.ts index 336a6cdd4a2cb..4e422cec7207c 100644 --- a/clients/client-datasync/commands/DescribeLocationObjectStorageCommand.ts +++ b/clients/client-datasync/commands/DescribeLocationObjectStorageCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeLocationObjectStorageCommandInput = DescribeLocationObjectStorageRequest; export type DescribeLocationObjectStorageCommandOutput = DescribeLocationObjectStorageResponse & __MetadataBearer; +/** + *

Returns metadata about a self-managed object storage server location. For more information + * about self-managed object storage locations, see create-object-location.

+ */ export class DescribeLocationObjectStorageCommand extends $Command< DescribeLocationObjectStorageCommandInput, DescribeLocationObjectStorageCommandOutput, @@ -34,6 +38,9 @@ export class DescribeLocationObjectStorageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeLocationS3Command.ts b/clients/client-datasync/commands/DescribeLocationS3Command.ts index b0674248bea37..b9ea14e881dcb 100644 --- a/clients/client-datasync/commands/DescribeLocationS3Command.ts +++ b/clients/client-datasync/commands/DescribeLocationS3Command.ts @@ -20,6 +20,9 @@ import { export type DescribeLocationS3CommandInput = DescribeLocationS3Request; export type DescribeLocationS3CommandOutput = DescribeLocationS3Response & __MetadataBearer; +/** + *

Returns metadata, such as bucket name, about an Amazon S3 bucket location.

+ */ export class DescribeLocationS3Command extends $Command< DescribeLocationS3CommandInput, DescribeLocationS3CommandOutput, @@ -34,6 +37,9 @@ export class DescribeLocationS3Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeLocationSmbCommand.ts b/clients/client-datasync/commands/DescribeLocationSmbCommand.ts index 7d7542c711f4b..34dbf9e9b37c1 100644 --- a/clients/client-datasync/commands/DescribeLocationSmbCommand.ts +++ b/clients/client-datasync/commands/DescribeLocationSmbCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLocationSmbCommandInput = DescribeLocationSmbRequest; export type DescribeLocationSmbCommandOutput = DescribeLocationSmbResponse & __MetadataBearer; +/** + *

Returns metadata, such as the path and user information about an SMB location.

+ */ export class DescribeLocationSmbCommand extends $Command< DescribeLocationSmbCommandInput, DescribeLocationSmbCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLocationSmbCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeTaskCommand.ts b/clients/client-datasync/commands/DescribeTaskCommand.ts index 997c798a3dc10..ffa2f64f44874 100644 --- a/clients/client-datasync/commands/DescribeTaskCommand.ts +++ b/clients/client-datasync/commands/DescribeTaskCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTaskCommandInput = DescribeTaskRequest; export type DescribeTaskCommandOutput = DescribeTaskResponse & __MetadataBearer; +/** + *

Returns metadata about a task.

+ */ export class DescribeTaskCommand extends $Command< DescribeTaskCommandInput, DescribeTaskCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/DescribeTaskExecutionCommand.ts b/clients/client-datasync/commands/DescribeTaskExecutionCommand.ts index 57f492a576b0c..d2b29b1ce6015 100644 --- a/clients/client-datasync/commands/DescribeTaskExecutionCommand.ts +++ b/clients/client-datasync/commands/DescribeTaskExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTaskExecutionCommandInput = DescribeTaskExecutionRequest; export type DescribeTaskExecutionCommandOutput = DescribeTaskExecutionResponse & __MetadataBearer; +/** + *

Returns detailed metadata about a task that is being executed.

+ */ export class DescribeTaskExecutionCommand extends $Command< DescribeTaskExecutionCommandInput, DescribeTaskExecutionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTaskExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/ListAgentsCommand.ts b/clients/client-datasync/commands/ListAgentsCommand.ts index 8ff4b78b717ec..1017783c04cc7 100644 --- a/clients/client-datasync/commands/ListAgentsCommand.ts +++ b/clients/client-datasync/commands/ListAgentsCommand.ts @@ -20,6 +20,16 @@ import { export type ListAgentsCommandInput = ListAgentsRequest; export type ListAgentsCommandOutput = ListAgentsResponse & __MetadataBearer; +/** + *

Returns a list of agents owned by an AWS account in the AWS Region specified in the + * request. The returned list is ordered by agent Amazon Resource Name (ARN).

+ *

By default, this operation returns a maximum of 100 agents. This operation supports + * pagination that enables you to optionally reduce the number of agents returned in a + * response.

+ *

If you have more agents than are returned in a response (that is, the response returns + * only a truncated list of your agents), the response contains a marker that you can specify in + * your next request to fetch the next page of agents.

+ */ export class ListAgentsCommand extends $Command< ListAgentsCommandInput, ListAgentsCommandOutput, @@ -34,6 +44,9 @@ export class ListAgentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/ListLocationsCommand.ts b/clients/client-datasync/commands/ListLocationsCommand.ts index 509c9b03d9e55..dc3fb081a1751 100644 --- a/clients/client-datasync/commands/ListLocationsCommand.ts +++ b/clients/client-datasync/commands/ListLocationsCommand.ts @@ -20,6 +20,12 @@ import { export type ListLocationsCommandInput = ListLocationsRequest; export type ListLocationsCommandOutput = ListLocationsResponse & __MetadataBearer; +/** + *

Returns a list of source and destination locations.

+ *

If you have more locations than are returned in a response (that is, the response + * returns only a truncated list of your agents), the response contains a token that you can + * specify in your next request to fetch the next page of locations.

+ */ export class ListLocationsCommand extends $Command< ListLocationsCommandInput, ListLocationsCommandOutput, @@ -34,6 +40,9 @@ export class ListLocationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/ListTagsForResourceCommand.ts b/clients/client-datasync/commands/ListTagsForResourceCommand.ts index 7e7bc75615b05..20bc70fb91e22 100644 --- a/clients/client-datasync/commands/ListTagsForResourceCommand.ts +++ b/clients/client-datasync/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns all the tags associated with a specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/ListTaskExecutionsCommand.ts b/clients/client-datasync/commands/ListTaskExecutionsCommand.ts index 495a652719b61..53ea01496fe49 100644 --- a/clients/client-datasync/commands/ListTaskExecutionsCommand.ts +++ b/clients/client-datasync/commands/ListTaskExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTaskExecutionsCommandInput = ListTaskExecutionsRequest; export type ListTaskExecutionsCommandOutput = ListTaskExecutionsResponse & __MetadataBearer; +/** + *

Returns a list of executed tasks.

+ */ export class ListTaskExecutionsCommand extends $Command< ListTaskExecutionsCommandInput, ListTaskExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class ListTaskExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/ListTasksCommand.ts b/clients/client-datasync/commands/ListTasksCommand.ts index 624a673dfc115..22fef3624e153 100644 --- a/clients/client-datasync/commands/ListTasksCommand.ts +++ b/clients/client-datasync/commands/ListTasksCommand.ts @@ -17,6 +17,9 @@ import { export type ListTasksCommandInput = ListTasksRequest; export type ListTasksCommandOutput = ListTasksResponse & __MetadataBearer; +/** + *

Returns a list of all the tasks.

+ */ export class ListTasksCommand extends $Command< ListTasksCommandInput, ListTasksCommandOutput, @@ -31,6 +34,9 @@ export class ListTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/StartTaskExecutionCommand.ts b/clients/client-datasync/commands/StartTaskExecutionCommand.ts index 87ccd7b048988..601d32ac33c97 100644 --- a/clients/client-datasync/commands/StartTaskExecutionCommand.ts +++ b/clients/client-datasync/commands/StartTaskExecutionCommand.ts @@ -20,6 +20,17 @@ import { export type StartTaskExecutionCommandInput = StartTaskExecutionRequest; export type StartTaskExecutionCommandOutput = StartTaskExecutionResponse & __MetadataBearer; +/** + *

Starts a specific invocation of a task. A TaskExecution value represents + * an individual run of a task. Each task can have at most one TaskExecution at a + * time.

+ *

+ * TaskExecution has the following transition phases: INITIALIZING | + * PREPARING | TRANSFERRING | VERIFYING | SUCCESS/FAILURE.

+ * + *

For detailed information, see the Task Execution section in the Components + * and Terminology topic in the AWS DataSync User Guide.

+ */ export class StartTaskExecutionCommand extends $Command< StartTaskExecutionCommandInput, StartTaskExecutionCommandOutput, @@ -34,6 +45,9 @@ export class StartTaskExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/TagResourceCommand.ts b/clients/client-datasync/commands/TagResourceCommand.ts index a273f4b40d98e..4755890c12ce1 100644 --- a/clients/client-datasync/commands/TagResourceCommand.ts +++ b/clients/client-datasync/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Applies a key-value pair to an AWS resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/UntagResourceCommand.ts b/clients/client-datasync/commands/UntagResourceCommand.ts index 66d397dfafd71..ab059772b777d 100644 --- a/clients/client-datasync/commands/UntagResourceCommand.ts +++ b/clients/client-datasync/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag from an AWS resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/UpdateAgentCommand.ts b/clients/client-datasync/commands/UpdateAgentCommand.ts index 3a19ea9d46fae..67d2b9846d880 100644 --- a/clients/client-datasync/commands/UpdateAgentCommand.ts +++ b/clients/client-datasync/commands/UpdateAgentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAgentCommandInput = UpdateAgentRequest; export type UpdateAgentCommandOutput = UpdateAgentResponse & __MetadataBearer; +/** + *

Updates the name of an agent.

+ */ export class UpdateAgentCommand extends $Command< UpdateAgentCommandInput, UpdateAgentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAgentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/UpdateTaskCommand.ts b/clients/client-datasync/commands/UpdateTaskCommand.ts index 7db0c35dcbb11..d8dbe4f1749ff 100644 --- a/clients/client-datasync/commands/UpdateTaskCommand.ts +++ b/clients/client-datasync/commands/UpdateTaskCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTaskCommandInput = UpdateTaskRequest; export type UpdateTaskCommandOutput = UpdateTaskResponse & __MetadataBearer; +/** + *

Updates the metadata associated with a task.

+ */ export class UpdateTaskCommand extends $Command< UpdateTaskCommandInput, UpdateTaskCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/commands/UpdateTaskExecutionCommand.ts b/clients/client-datasync/commands/UpdateTaskExecutionCommand.ts index 38941a8554ca3..d3258d4b2ec4e 100644 --- a/clients/client-datasync/commands/UpdateTaskExecutionCommand.ts +++ b/clients/client-datasync/commands/UpdateTaskExecutionCommand.ts @@ -20,6 +20,18 @@ import { export type UpdateTaskExecutionCommandInput = UpdateTaskExecutionRequest; export type UpdateTaskExecutionCommandOutput = UpdateTaskExecutionResponse & __MetadataBearer; +/** + *

Updates execution of a task.

+ *

You can modify bandwidth throttling for a task execution that is running or queued. + * For more information, see Adjusting Bandwidth Throttling for a Task Execution.

+ * + * + *

The only Option that can be modified by UpdateTaskExecution + * is + * BytesPerSecond + * .

+ *
+ */ export class UpdateTaskExecutionCommand extends $Command< UpdateTaskExecutionCommandInput, UpdateTaskExecutionCommandOutput, @@ -34,6 +46,9 @@ export class UpdateTaskExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DataSyncClientResolvedConfig, diff --git a/clients/client-datasync/package.json b/clients/client-datasync/package.json index a5722afb04fa8..e768a2188870e 100644 --- a/clients/client-datasync/package.json +++ b/clients/client-datasync/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Datasync Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-datasync/pagination/ListAgentsPaginator.ts b/clients/client-datasync/pagination/ListAgentsPaginator.ts index 92b6e1c498806..bd2f834d66363 100644 --- a/clients/client-datasync/pagination/ListAgentsPaginator.ts +++ b/clients/client-datasync/pagination/ListAgentsPaginator.ts @@ -4,6 +4,9 @@ import { ListAgentsCommand, ListAgentsCommandInput, ListAgentsCommandOutput } fr import { DataSyncPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataSyncClient, input: ListAgentsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAgentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataSync, input: ListAgentsCommandInput, diff --git a/clients/client-datasync/pagination/ListLocationsPaginator.ts b/clients/client-datasync/pagination/ListLocationsPaginator.ts index 56b046fe5d46e..3a5b8969fdf69 100644 --- a/clients/client-datasync/pagination/ListLocationsPaginator.ts +++ b/clients/client-datasync/pagination/ListLocationsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataSyncPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataSyncClient, input: ListLocationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLocationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataSync, input: ListLocationsCommandInput, diff --git a/clients/client-datasync/pagination/ListTagsForResourcePaginator.ts b/clients/client-datasync/pagination/ListTagsForResourcePaginator.ts index 43d42503472b3..0f1eb720c74c2 100644 --- a/clients/client-datasync/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-datasync/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { DataSyncPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataSyncClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataSync, input: ListTagsForResourceCommandInput, diff --git a/clients/client-datasync/pagination/ListTaskExecutionsPaginator.ts b/clients/client-datasync/pagination/ListTaskExecutionsPaginator.ts index 3248302b1cb3f..74064ad3afc54 100644 --- a/clients/client-datasync/pagination/ListTaskExecutionsPaginator.ts +++ b/clients/client-datasync/pagination/ListTaskExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DataSyncPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataSyncClient, input: ListTaskExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTaskExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataSync, input: ListTaskExecutionsCommandInput, diff --git a/clients/client-datasync/pagination/ListTasksPaginator.ts b/clients/client-datasync/pagination/ListTasksPaginator.ts index 31a92a57620ff..3984827d0d6c8 100644 --- a/clients/client-datasync/pagination/ListTasksPaginator.ts +++ b/clients/client-datasync/pagination/ListTasksPaginator.ts @@ -4,6 +4,9 @@ import { ListTasksCommand, ListTasksCommandInput, ListTasksCommandOutput } from import { DataSyncPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DataSyncClient, input: ListTasksCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DataSync, input: ListTasksCommandInput, diff --git a/clients/client-datasync/runtimeConfig.browser.ts b/clients/client-datasync/runtimeConfig.browser.ts index 571762e393d8d..98eb12c002604 100644 --- a/clients/client-datasync/runtimeConfig.browser.ts +++ b/clients/client-datasync/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DataSyncClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-datasync/runtimeConfig.native.ts b/clients/client-datasync/runtimeConfig.native.ts index 870d58aad6c00..54339bc051d30 100644 --- a/clients/client-datasync/runtimeConfig.native.ts +++ b/clients/client-datasync/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DataSyncClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-datasync/runtimeConfig.shared.ts b/clients/client-datasync/runtimeConfig.shared.ts index ae20e5494de4b..0dc85640e30e3 100644 --- a/clients/client-datasync/runtimeConfig.shared.ts +++ b/clients/client-datasync/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-09", disableHostPrefix: false, diff --git a/clients/client-datasync/runtimeConfig.ts b/clients/client-datasync/runtimeConfig.ts index 15185023d5fcb..99558ff59855f 100644 --- a/clients/client-datasync/runtimeConfig.ts +++ b/clients/client-datasync/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DataSyncClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-datasync/tsconfig.json b/clients/client-datasync/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-datasync/tsconfig.json +++ b/clients/client-datasync/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-dax/commands/CreateClusterCommand.ts b/clients/client-dax/commands/CreateClusterCommand.ts index 5aae2fd398301..ccc865d89434d 100644 --- a/clients/client-dax/commands/CreateClusterCommand.ts +++ b/clients/client-dax/commands/CreateClusterCommand.ts @@ -20,6 +20,9 @@ import { export type CreateClusterCommandInput = CreateClusterRequest; export type CreateClusterCommandOutput = CreateClusterResponse & __MetadataBearer; +/** + *

Creates a DAX cluster. All nodes in the cluster run the same DAX caching software.

+ */ export class CreateClusterCommand extends $Command< CreateClusterCommandInput, CreateClusterCommandOutput, @@ -34,6 +37,9 @@ export class CreateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/CreateParameterGroupCommand.ts b/clients/client-dax/commands/CreateParameterGroupCommand.ts index fdec9f8248dcf..68d800488abdb 100644 --- a/clients/client-dax/commands/CreateParameterGroupCommand.ts +++ b/clients/client-dax/commands/CreateParameterGroupCommand.ts @@ -20,6 +20,10 @@ import { export type CreateParameterGroupCommandInput = CreateParameterGroupRequest; export type CreateParameterGroupCommandOutput = CreateParameterGroupResponse & __MetadataBearer; +/** + *

Creates a new parameter group. A parameter group is a collection of parameters that + * you apply to all of the nodes in a DAX cluster.

+ */ export class CreateParameterGroupCommand extends $Command< CreateParameterGroupCommandInput, CreateParameterGroupCommandOutput, @@ -34,6 +38,9 @@ export class CreateParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/CreateSubnetGroupCommand.ts b/clients/client-dax/commands/CreateSubnetGroupCommand.ts index af3c0dfb825a8..3a40bc79a4e2d 100644 --- a/clients/client-dax/commands/CreateSubnetGroupCommand.ts +++ b/clients/client-dax/commands/CreateSubnetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSubnetGroupCommandInput = CreateSubnetGroupRequest; export type CreateSubnetGroupCommandOutput = CreateSubnetGroupResponse & __MetadataBearer; +/** + *

Creates a new subnet group.

+ */ export class CreateSubnetGroupCommand extends $Command< CreateSubnetGroupCommandInput, CreateSubnetGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DecreaseReplicationFactorCommand.ts b/clients/client-dax/commands/DecreaseReplicationFactorCommand.ts index a285e9189d077..5e1e9e5a364a9 100644 --- a/clients/client-dax/commands/DecreaseReplicationFactorCommand.ts +++ b/clients/client-dax/commands/DecreaseReplicationFactorCommand.ts @@ -20,6 +20,12 @@ import { export type DecreaseReplicationFactorCommandInput = DecreaseReplicationFactorRequest; export type DecreaseReplicationFactorCommandOutput = DecreaseReplicationFactorResponse & __MetadataBearer; +/** + *

Removes one or more nodes from a DAX cluster.

+ * + *

You cannot use DecreaseReplicationFactor to remove the last node in a DAX cluster. If you need to do this, use DeleteCluster instead.

+ *
+ */ export class DecreaseReplicationFactorCommand extends $Command< DecreaseReplicationFactorCommandInput, DecreaseReplicationFactorCommandOutput, @@ -34,6 +40,9 @@ export class DecreaseReplicationFactorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DeleteClusterCommand.ts b/clients/client-dax/commands/DeleteClusterCommand.ts index 2783a2a1b2932..be7cbb0e3daf9 100644 --- a/clients/client-dax/commands/DeleteClusterCommand.ts +++ b/clients/client-dax/commands/DeleteClusterCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteClusterCommandInput = DeleteClusterRequest; export type DeleteClusterCommandOutput = DeleteClusterResponse & __MetadataBearer; +/** + *

Deletes a previously provisioned DAX cluster. + * DeleteCluster deletes all associated nodes, node endpoints + * and the DAX cluster itself. When you receive a successful response from this action, + * DAX immediately begins deleting the cluster; you cannot cancel or revert this + * action.

+ */ export class DeleteClusterCommand extends $Command< DeleteClusterCommandInput, DeleteClusterCommandOutput, @@ -34,6 +41,9 @@ export class DeleteClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DeleteParameterGroupCommand.ts b/clients/client-dax/commands/DeleteParameterGroupCommand.ts index 49901e61b0ff1..e69a69efd6ee1 100644 --- a/clients/client-dax/commands/DeleteParameterGroupCommand.ts +++ b/clients/client-dax/commands/DeleteParameterGroupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteParameterGroupCommandInput = DeleteParameterGroupRequest; export type DeleteParameterGroupCommandOutput = DeleteParameterGroupResponse & __MetadataBearer; +/** + *

Deletes the specified parameter group. You cannot delete a parameter group if it is + * associated with any DAX clusters.

+ */ export class DeleteParameterGroupCommand extends $Command< DeleteParameterGroupCommandInput, DeleteParameterGroupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DeleteSubnetGroupCommand.ts b/clients/client-dax/commands/DeleteSubnetGroupCommand.ts index eaacee4de71cb..d9c1e85bf1fb8 100644 --- a/clients/client-dax/commands/DeleteSubnetGroupCommand.ts +++ b/clients/client-dax/commands/DeleteSubnetGroupCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteSubnetGroupCommandInput = DeleteSubnetGroupRequest; export type DeleteSubnetGroupCommandOutput = DeleteSubnetGroupResponse & __MetadataBearer; +/** + *

Deletes a subnet group.

+ * + *

You cannot delete a subnet group if it is associated with any DAX + * clusters.

+ *
+ */ export class DeleteSubnetGroupCommand extends $Command< DeleteSubnetGroupCommandInput, DeleteSubnetGroupCommandOutput, @@ -34,6 +41,9 @@ export class DeleteSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DescribeClustersCommand.ts b/clients/client-dax/commands/DescribeClustersCommand.ts index 467818fd825c5..64d5711e17849 100644 --- a/clients/client-dax/commands/DescribeClustersCommand.ts +++ b/clients/client-dax/commands/DescribeClustersCommand.ts @@ -20,6 +20,21 @@ import { export type DescribeClustersCommandInput = DescribeClustersRequest; export type DescribeClustersCommandOutput = DescribeClustersResponse & __MetadataBearer; +/** + *

Returns information about all provisioned DAX clusters if no cluster identifier + * is specified, or about a specific DAX cluster if a cluster identifier is + * supplied.

+ *

If the cluster is in the CREATING state, only cluster level information will be + * displayed until all of the nodes are successfully provisioned.

+ *

If the cluster is in the DELETING state, only cluster level information will be + * displayed.

+ *

If nodes are currently being added to the DAX cluster, node endpoint information + * and creation time for the additional nodes will not be displayed until they are + * completely provisioned. When the DAX cluster state is available, + * the cluster is ready for use.

+ *

If nodes are currently being removed from the DAX cluster, no endpoint + * information for the removed nodes is displayed.

+ */ export class DescribeClustersCommand extends $Command< DescribeClustersCommandInput, DescribeClustersCommandOutput, @@ -34,6 +49,9 @@ export class DescribeClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DescribeDefaultParametersCommand.ts b/clients/client-dax/commands/DescribeDefaultParametersCommand.ts index a7c93d606091b..47b265ea6cde3 100644 --- a/clients/client-dax/commands/DescribeDefaultParametersCommand.ts +++ b/clients/client-dax/commands/DescribeDefaultParametersCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDefaultParametersCommandInput = DescribeDefaultParametersRequest; export type DescribeDefaultParametersCommandOutput = DescribeDefaultParametersResponse & __MetadataBearer; +/** + *

Returns the default system parameter information for the DAX caching + * software.

+ */ export class DescribeDefaultParametersCommand extends $Command< DescribeDefaultParametersCommandInput, DescribeDefaultParametersCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDefaultParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DescribeEventsCommand.ts b/clients/client-dax/commands/DescribeEventsCommand.ts index 287c51f541d17..aa94247fc13e3 100644 --- a/clients/client-dax/commands/DescribeEventsCommand.ts +++ b/clients/client-dax/commands/DescribeEventsCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeEventsCommandInput = DescribeEventsRequest; export type DescribeEventsCommandOutput = DescribeEventsResponse & __MetadataBearer; +/** + *

Returns events related to DAX clusters and parameter groups. You can obtain + * events specific to a particular DAX cluster or parameter group by providing the name + * as a parameter.

+ *

By default, only the events occurring within the last 24 hours are returned; however, + * you can retrieve up to 14 days' worth of events if necessary.

+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +41,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DescribeParameterGroupsCommand.ts b/clients/client-dax/commands/DescribeParameterGroupsCommand.ts index 867fa1dc7f3ec..bccda25d99faf 100644 --- a/clients/client-dax/commands/DescribeParameterGroupsCommand.ts +++ b/clients/client-dax/commands/DescribeParameterGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeParameterGroupsCommandInput = DescribeParameterGroupsRequest; export type DescribeParameterGroupsCommandOutput = DescribeParameterGroupsResponse & __MetadataBearer; +/** + *

Returns a list of parameter group descriptions. If a parameter group name is + * specified, the list will contain only the descriptions for that group.

+ */ export class DescribeParameterGroupsCommand extends $Command< DescribeParameterGroupsCommandInput, DescribeParameterGroupsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeParameterGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DescribeParametersCommand.ts b/clients/client-dax/commands/DescribeParametersCommand.ts index 951ee557866b5..ed75246cc1b70 100644 --- a/clients/client-dax/commands/DescribeParametersCommand.ts +++ b/clients/client-dax/commands/DescribeParametersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeParametersCommandInput = DescribeParametersRequest; export type DescribeParametersCommandOutput = DescribeParametersResponse & __MetadataBearer; +/** + *

Returns the detailed parameter list for a particular parameter group.

+ */ export class DescribeParametersCommand extends $Command< DescribeParametersCommandInput, DescribeParametersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/DescribeSubnetGroupsCommand.ts b/clients/client-dax/commands/DescribeSubnetGroupsCommand.ts index e560e03c132b0..8703d2b8802f1 100644 --- a/clients/client-dax/commands/DescribeSubnetGroupsCommand.ts +++ b/clients/client-dax/commands/DescribeSubnetGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSubnetGroupsCommandInput = DescribeSubnetGroupsRequest; export type DescribeSubnetGroupsCommandOutput = DescribeSubnetGroupsResponse & __MetadataBearer; +/** + *

Returns a list of subnet group descriptions. If a subnet group name is specified, + * the list will contain only the description of that group.

+ */ export class DescribeSubnetGroupsCommand extends $Command< DescribeSubnetGroupsCommandInput, DescribeSubnetGroupsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSubnetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/IncreaseReplicationFactorCommand.ts b/clients/client-dax/commands/IncreaseReplicationFactorCommand.ts index 35e6da24bec53..18653c45762d2 100644 --- a/clients/client-dax/commands/IncreaseReplicationFactorCommand.ts +++ b/clients/client-dax/commands/IncreaseReplicationFactorCommand.ts @@ -20,6 +20,9 @@ import { export type IncreaseReplicationFactorCommandInput = IncreaseReplicationFactorRequest; export type IncreaseReplicationFactorCommandOutput = IncreaseReplicationFactorResponse & __MetadataBearer; +/** + *

Adds one or more nodes to a DAX cluster.

+ */ export class IncreaseReplicationFactorCommand extends $Command< IncreaseReplicationFactorCommandInput, IncreaseReplicationFactorCommandOutput, @@ -34,6 +37,9 @@ export class IncreaseReplicationFactorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/ListTagsCommand.ts b/clients/client-dax/commands/ListTagsCommand.ts index 6a3f92f21bf7f..6337f9c72ac30 100644 --- a/clients/client-dax/commands/ListTagsCommand.ts +++ b/clients/client-dax/commands/ListTagsCommand.ts @@ -17,6 +17,10 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResponse & __MetadataBearer; +/** + *

List all of the tags for a DAX cluster. You can call ListTags up to + * 10 times per second, per account.

+ */ export class ListTagsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +31,9 @@ export class ListTagsCommand extends $Command, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/RebootNodeCommand.ts b/clients/client-dax/commands/RebootNodeCommand.ts index 4b9d454d13f9c..dbc040af8882c 100644 --- a/clients/client-dax/commands/RebootNodeCommand.ts +++ b/clients/client-dax/commands/RebootNodeCommand.ts @@ -20,6 +20,15 @@ import { export type RebootNodeCommandInput = RebootNodeRequest; export type RebootNodeCommandOutput = RebootNodeResponse & __MetadataBearer; +/** + *

Reboots a single node of a DAX cluster. The reboot action takes place + * as soon as possible. During the + * reboot, the node status is set to REBOOTING.

+ * + *

+ * RebootNode restarts the DAX engine process and does not remove the contents of the cache.

+ *
+ */ export class RebootNodeCommand extends $Command< RebootNodeCommandInput, RebootNodeCommandOutput, @@ -34,6 +43,9 @@ export class RebootNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/TagResourceCommand.ts b/clients/client-dax/commands/TagResourceCommand.ts index d36de0dfbc537..57335ae1ed0a8 100644 --- a/clients/client-dax/commands/TagResourceCommand.ts +++ b/clients/client-dax/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Associates a set of tags with a DAX resource. You can call TagResource up to 5 times per second, per + * account.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/UntagResourceCommand.ts b/clients/client-dax/commands/UntagResourceCommand.ts index 4fe0b7685c086..c266bf6f7ca68 100644 --- a/clients/client-dax/commands/UntagResourceCommand.ts +++ b/clients/client-dax/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the association of tags from a DAX resource. You can call + * UntagResource up to 5 times per second, per account.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/UpdateClusterCommand.ts b/clients/client-dax/commands/UpdateClusterCommand.ts index 17e0e770252c9..328699499bbee 100644 --- a/clients/client-dax/commands/UpdateClusterCommand.ts +++ b/clients/client-dax/commands/UpdateClusterCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateClusterCommandInput = UpdateClusterRequest; export type UpdateClusterCommandOutput = UpdateClusterResponse & __MetadataBearer; +/** + *

Modifies the settings for a DAX cluster. You can use this action to change one or + * more cluster configuration parameters by specifying the parameters and the new + * values.

+ */ export class UpdateClusterCommand extends $Command< UpdateClusterCommandInput, UpdateClusterCommandOutput, @@ -34,6 +39,9 @@ export class UpdateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/UpdateParameterGroupCommand.ts b/clients/client-dax/commands/UpdateParameterGroupCommand.ts index 4e886a829a633..b6f09a2f5db29 100644 --- a/clients/client-dax/commands/UpdateParameterGroupCommand.ts +++ b/clients/client-dax/commands/UpdateParameterGroupCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateParameterGroupCommandInput = UpdateParameterGroupRequest; export type UpdateParameterGroupCommandOutput = UpdateParameterGroupResponse & __MetadataBearer; +/** + *

Modifies the parameters of a parameter group. You can modify up to 20 + * parameters in a single request by submitting a list parameter name and value + * pairs.

+ */ export class UpdateParameterGroupCommand extends $Command< UpdateParameterGroupCommandInput, UpdateParameterGroupCommandOutput, @@ -34,6 +39,9 @@ export class UpdateParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/commands/UpdateSubnetGroupCommand.ts b/clients/client-dax/commands/UpdateSubnetGroupCommand.ts index 0fe30c8f7935c..1668ecdc30597 100644 --- a/clients/client-dax/commands/UpdateSubnetGroupCommand.ts +++ b/clients/client-dax/commands/UpdateSubnetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSubnetGroupCommandInput = UpdateSubnetGroupRequest; export type UpdateSubnetGroupCommandOutput = UpdateSubnetGroupResponse & __MetadataBearer; +/** + *

Modifies an existing subnet group.

+ */ export class UpdateSubnetGroupCommand extends $Command< UpdateSubnetGroupCommandInput, UpdateSubnetGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DAXClientResolvedConfig, diff --git a/clients/client-dax/package.json b/clients/client-dax/package.json index 0094023638123..2cab74e365e68 100644 --- a/clients/client-dax/package.json +++ b/clients/client-dax/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Dax Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-dax/runtimeConfig.browser.ts b/clients/client-dax/runtimeConfig.browser.ts index fc523a1220af3..85675930b9340 100644 --- a/clients/client-dax/runtimeConfig.browser.ts +++ b/clients/client-dax/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DAXClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-dax/runtimeConfig.native.ts b/clients/client-dax/runtimeConfig.native.ts index 3d536585ba369..6fb187d530248 100644 --- a/clients/client-dax/runtimeConfig.native.ts +++ b/clients/client-dax/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DAXClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-dax/runtimeConfig.shared.ts b/clients/client-dax/runtimeConfig.shared.ts index d83a24596a768..551e309423971 100644 --- a/clients/client-dax/runtimeConfig.shared.ts +++ b/clients/client-dax/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-04-19", disableHostPrefix: false, diff --git a/clients/client-dax/runtimeConfig.ts b/clients/client-dax/runtimeConfig.ts index 0d6d9be9350d1..e69ce75ab04f7 100644 --- a/clients/client-dax/runtimeConfig.ts +++ b/clients/client-dax/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DAXClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-dax/tsconfig.json b/clients/client-dax/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-dax/tsconfig.json +++ b/clients/client-dax/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-detective/commands/AcceptInvitationCommand.ts b/clients/client-detective/commands/AcceptInvitationCommand.ts index 4f408549a4956..521d1455bece6 100644 --- a/clients/client-detective/commands/AcceptInvitationCommand.ts +++ b/clients/client-detective/commands/AcceptInvitationCommand.ts @@ -20,6 +20,12 @@ import { export type AcceptInvitationCommandInput = AcceptInvitationRequest; export type AcceptInvitationCommandOutput = __MetadataBearer; +/** + *

Accepts an invitation for the member account to contribute data to a behavior graph. + * This operation can only be called by an invited member account.

+ *

The request provides the ARN of behavior graph.

+ *

The member account status in the graph must be INVITED.

+ */ export class AcceptInvitationCommand extends $Command< AcceptInvitationCommandInput, AcceptInvitationCommandOutput, @@ -34,6 +40,9 @@ export class AcceptInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/CreateGraphCommand.ts b/clients/client-detective/commands/CreateGraphCommand.ts index 9ed70e573cb44..ec9d845519abb 100644 --- a/clients/client-detective/commands/CreateGraphCommand.ts +++ b/clients/client-detective/commands/CreateGraphCommand.ts @@ -20,6 +20,23 @@ import { export type CreateGraphCommandInput = {}; export type CreateGraphCommandOutput = CreateGraphResponse & __MetadataBearer; +/** + *

Creates a new behavior graph for the calling account, and sets that account as the + * master account. This operation is called by the account that is enabling Detective.

+ *

Before you try to enable Detective, make sure that your account has been enrolled in + * Amazon GuardDuty for at least 48 hours. If you do not meet this requirement, you cannot enable + * Detective. If you do meet the GuardDuty prerequisite, then when you make the request to enable + * Detective, it checks whether your data volume is within the Detective quota. If it exceeds the + * quota, then you cannot enable Detective.

+ *

The operation also enables Detective for the calling account in the currently selected + * Region. It returns the ARN of the new behavior graph.

+ *

+ * CreateGraph triggers a process to create the corresponding data tables for + * the new behavior graph.

+ *

An account can only be the master account for one behavior graph within a Region. If the + * same account calls CreateGraph with the same master account, it always returns + * the same behavior graph ARN. It does not create a new behavior graph.

+ */ export class CreateGraphCommand extends $Command< CreateGraphCommandInput, CreateGraphCommandOutput, @@ -34,6 +51,9 @@ export class CreateGraphCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/CreateMembersCommand.ts b/clients/client-detective/commands/CreateMembersCommand.ts index 6588e8904f561..7e421e36d407c 100644 --- a/clients/client-detective/commands/CreateMembersCommand.ts +++ b/clients/client-detective/commands/CreateMembersCommand.ts @@ -20,6 +20,29 @@ import { export type CreateMembersCommandInput = CreateMembersRequest; export type CreateMembersCommandOutput = CreateMembersResponse & __MetadataBearer; +/** + *

Sends a request to invite the specified AWS accounts to be member accounts in the + * behavior graph. This operation can only be called by the master account for a behavior + * graph.

+ *

+ * CreateMembers verifies the accounts and then sends invitations to the + * verified accounts.

+ *

The request provides the behavior graph ARN and the list of accounts to invite.

+ *

The response separates the requested accounts into two lists:

+ *
    + *
  • + *

    The accounts that CreateMembers was able to start the verification + * for. This list includes member accounts that are being verified, that have passed + * verification and are being sent an invitation, and that have failed + * verification.

    + *
  • + *
  • + *

    The accounts that CreateMembers was unable to process. This list + * includes accounts that were already invited to be member accounts in the behavior + * graph.

    + *
  • + *
+ */ export class CreateMembersCommand extends $Command< CreateMembersCommandInput, CreateMembersCommandOutput, @@ -34,6 +57,9 @@ export class CreateMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/DeleteGraphCommand.ts b/clients/client-detective/commands/DeleteGraphCommand.ts index 6918f8f092879..c9c4b5c681f06 100644 --- a/clients/client-detective/commands/DeleteGraphCommand.ts +++ b/clients/client-detective/commands/DeleteGraphCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteGraphCommandInput = DeleteGraphRequest; export type DeleteGraphCommandOutput = __MetadataBearer; +/** + *

Disables the specified behavior graph and queues it to be deleted. This operation + * removes the graph from each member account's list of behavior graphs.

+ *

+ * DeleteGraph can only be called by the master account for a behavior + * graph.

+ */ export class DeleteGraphCommand extends $Command< DeleteGraphCommandInput, DeleteGraphCommandOutput, @@ -34,6 +41,9 @@ export class DeleteGraphCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/DeleteMembersCommand.ts b/clients/client-detective/commands/DeleteMembersCommand.ts index 10069e204890c..1f68dac234607 100644 --- a/clients/client-detective/commands/DeleteMembersCommand.ts +++ b/clients/client-detective/commands/DeleteMembersCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteMembersCommandInput = DeleteMembersRequest; export type DeleteMembersCommandOutput = DeleteMembersResponse & __MetadataBearer; +/** + *

Deletes one or more member accounts from the master account behavior graph. This + * operation can only be called by a Detective master account. That account cannot use + * DeleteMembers to delete their own account from the behavior graph. To + * disable a behavior graph, the master account uses the DeleteGraph API + * method.

+ */ export class DeleteMembersCommand extends $Command< DeleteMembersCommandInput, DeleteMembersCommandOutput, @@ -34,6 +41,9 @@ export class DeleteMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/DisassociateMembershipCommand.ts b/clients/client-detective/commands/DisassociateMembershipCommand.ts index 66074fa436563..1ca0f9fbaacd1 100644 --- a/clients/client-detective/commands/DisassociateMembershipCommand.ts +++ b/clients/client-detective/commands/DisassociateMembershipCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateMembershipCommandInput = DisassociateMembershipRequest; export type DisassociateMembershipCommandOutput = __MetadataBearer; +/** + *

Removes the member account from the specified behavior graph. This operation can only be + * called by a member account that has the ENABLED status.

+ */ export class DisassociateMembershipCommand extends $Command< DisassociateMembershipCommandInput, DisassociateMembershipCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/GetMembersCommand.ts b/clients/client-detective/commands/GetMembersCommand.ts index 5097ba3954e85..ba3d09f832030 100644 --- a/clients/client-detective/commands/GetMembersCommand.ts +++ b/clients/client-detective/commands/GetMembersCommand.ts @@ -20,6 +20,10 @@ import { export type GetMembersCommandInput = GetMembersRequest; export type GetMembersCommandOutput = GetMembersResponse & __MetadataBearer; +/** + *

Returns the membership details for specified member accounts for a behavior + * graph.

+ */ export class GetMembersCommand extends $Command< GetMembersCommandInput, GetMembersCommandOutput, @@ -34,6 +38,9 @@ export class GetMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/ListGraphsCommand.ts b/clients/client-detective/commands/ListGraphsCommand.ts index ef753fc0e4a81..a03774dabde8d 100644 --- a/clients/client-detective/commands/ListGraphsCommand.ts +++ b/clients/client-detective/commands/ListGraphsCommand.ts @@ -20,6 +20,12 @@ import { export type ListGraphsCommandInput = ListGraphsRequest; export type ListGraphsCommandOutput = ListGraphsResponse & __MetadataBearer; +/** + *

Returns the list of behavior graphs that the calling account is a master of. This + * operation can only be called by a master account.

+ *

Because an account can currently only be the master of one behavior graph within a + * Region, the results always contain a single graph.

+ */ export class ListGraphsCommand extends $Command< ListGraphsCommandInput, ListGraphsCommandOutput, @@ -34,6 +40,9 @@ export class ListGraphsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/ListInvitationsCommand.ts b/clients/client-detective/commands/ListInvitationsCommand.ts index 11818838b4506..428ef11694c0c 100644 --- a/clients/client-detective/commands/ListInvitationsCommand.ts +++ b/clients/client-detective/commands/ListInvitationsCommand.ts @@ -20,6 +20,14 @@ import { export type ListInvitationsCommandInput = ListInvitationsRequest; export type ListInvitationsCommandOutput = ListInvitationsResponse & __MetadataBearer; +/** + *

Retrieves the list of open and accepted behavior graph invitations for the member + * account. This operation can only be called by a member account.

+ *

Open invitations are invitations that the member account has not responded to.

+ *

The results do not include behavior graphs for which the member account declined the + * invitation. The results also do not include behavior graphs that the member account + * resigned from or was removed from.

+ */ export class ListInvitationsCommand extends $Command< ListInvitationsCommandInput, ListInvitationsCommandOutput, @@ -34,6 +42,9 @@ export class ListInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/ListMembersCommand.ts b/clients/client-detective/commands/ListMembersCommand.ts index 42561fc1a3e77..2b8a9dd72caa5 100644 --- a/clients/client-detective/commands/ListMembersCommand.ts +++ b/clients/client-detective/commands/ListMembersCommand.ts @@ -20,6 +20,10 @@ import { export type ListMembersCommandInput = ListMembersRequest; export type ListMembersCommandOutput = ListMembersResponse & __MetadataBearer; +/** + *

Retrieves the list of member accounts for a behavior graph. Does not return member + * accounts that were removed from the behavior graph.

+ */ export class ListMembersCommand extends $Command< ListMembersCommandInput, ListMembersCommandOutput, @@ -34,6 +38,9 @@ export class ListMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/RejectInvitationCommand.ts b/clients/client-detective/commands/RejectInvitationCommand.ts index 516929184ad0a..1db721fa84998 100644 --- a/clients/client-detective/commands/RejectInvitationCommand.ts +++ b/clients/client-detective/commands/RejectInvitationCommand.ts @@ -20,6 +20,10 @@ import { export type RejectInvitationCommandInput = RejectInvitationRequest; export type RejectInvitationCommandOutput = __MetadataBearer; +/** + *

Rejects an invitation to contribute the account data to a behavior graph. This operation + * must be called by a member account that has the INVITED status.

+ */ export class RejectInvitationCommand extends $Command< RejectInvitationCommandInput, RejectInvitationCommandOutput, @@ -34,6 +38,9 @@ export class RejectInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/commands/StartMonitoringMemberCommand.ts b/clients/client-detective/commands/StartMonitoringMemberCommand.ts index 186209ab0e69d..f68e2e57cb562 100644 --- a/clients/client-detective/commands/StartMonitoringMemberCommand.ts +++ b/clients/client-detective/commands/StartMonitoringMemberCommand.ts @@ -20,6 +20,21 @@ import { export type StartMonitoringMemberCommandInput = StartMonitoringMemberRequest; export type StartMonitoringMemberCommandOutput = __MetadataBearer; +/** + *

Sends a request to enable data ingest for a member account that has a status of + * ACCEPTED_BUT_DISABLED.

+ *

For valid member accounts, the status is updated as follows.

+ *
    + *
  • + *

    If Detective enabled the member account, then the new status is + * ENABLED.

    + *
  • + *
  • + *

    If Detective cannot enable the member account, the status remains + * ACCEPTED_BUT_DISABLED.

    + *
  • + *
+ */ export class StartMonitoringMemberCommand extends $Command< StartMonitoringMemberCommandInput, StartMonitoringMemberCommandOutput, @@ -34,6 +49,9 @@ export class StartMonitoringMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DetectiveClientResolvedConfig, diff --git a/clients/client-detective/package.json b/clients/client-detective/package.json index bf6483d1cad3b..01ce0a65f1396 100644 --- a/clients/client-detective/package.json +++ b/clients/client-detective/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Detective Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-detective/pagination/ListGraphsPaginator.ts b/clients/client-detective/pagination/ListGraphsPaginator.ts index 51b795efe01bd..dff8dd30ee46f 100644 --- a/clients/client-detective/pagination/ListGraphsPaginator.ts +++ b/clients/client-detective/pagination/ListGraphsPaginator.ts @@ -4,6 +4,9 @@ import { ListGraphsCommand, ListGraphsCommandInput, ListGraphsCommandOutput } fr import { DetectivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DetectiveClient, input: ListGraphsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGraphsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Detective, input: ListGraphsCommandInput, diff --git a/clients/client-detective/pagination/ListInvitationsPaginator.ts b/clients/client-detective/pagination/ListInvitationsPaginator.ts index a351bf7345ca7..821df5f875b9c 100644 --- a/clients/client-detective/pagination/ListInvitationsPaginator.ts +++ b/clients/client-detective/pagination/ListInvitationsPaginator.ts @@ -8,6 +8,9 @@ import { import { DetectivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DetectiveClient, input: ListInvitationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInvitationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Detective, input: ListInvitationsCommandInput, diff --git a/clients/client-detective/pagination/ListMembersPaginator.ts b/clients/client-detective/pagination/ListMembersPaginator.ts index c6020b6ec3fba..c6ef41e725fe6 100644 --- a/clients/client-detective/pagination/ListMembersPaginator.ts +++ b/clients/client-detective/pagination/ListMembersPaginator.ts @@ -4,6 +4,9 @@ import { ListMembersCommand, ListMembersCommandInput, ListMembersCommandOutput } import { DetectivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DetectiveClient, input: ListMembersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMembersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Detective, input: ListMembersCommandInput, diff --git a/clients/client-detective/runtimeConfig.browser.ts b/clients/client-detective/runtimeConfig.browser.ts index b99bc65793844..b99c155c9b1a9 100644 --- a/clients/client-detective/runtimeConfig.browser.ts +++ b/clients/client-detective/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DetectiveClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-detective/runtimeConfig.native.ts b/clients/client-detective/runtimeConfig.native.ts index 0882e980ebdcd..b16fad6b8cde8 100644 --- a/clients/client-detective/runtimeConfig.native.ts +++ b/clients/client-detective/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DetectiveClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-detective/runtimeConfig.shared.ts b/clients/client-detective/runtimeConfig.shared.ts index df1f65e2ad565..057b4e63267c0 100644 --- a/clients/client-detective/runtimeConfig.shared.ts +++ b/clients/client-detective/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-10-26", disableHostPrefix: false, diff --git a/clients/client-detective/runtimeConfig.ts b/clients/client-detective/runtimeConfig.ts index 2b2db7b4bdbab..a46f863e1eda3 100644 --- a/clients/client-detective/runtimeConfig.ts +++ b/clients/client-detective/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DetectiveClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-detective/tsconfig.json b/clients/client-detective/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-detective/tsconfig.json +++ b/clients/client-detective/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-device-farm/commands/CreateDevicePoolCommand.ts b/clients/client-device-farm/commands/CreateDevicePoolCommand.ts index f914a02f986f0..36faaff4ef94a 100644 --- a/clients/client-device-farm/commands/CreateDevicePoolCommand.ts +++ b/clients/client-device-farm/commands/CreateDevicePoolCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDevicePoolCommandInput = CreateDevicePoolRequest; export type CreateDevicePoolCommandOutput = CreateDevicePoolResult & __MetadataBearer; +/** + *

Creates a device pool.

+ */ export class CreateDevicePoolCommand extends $Command< CreateDevicePoolCommandInput, CreateDevicePoolCommandOutput, @@ -34,6 +37,9 @@ export class CreateDevicePoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/CreateInstanceProfileCommand.ts b/clients/client-device-farm/commands/CreateInstanceProfileCommand.ts index d67da40b92b7b..e7102216c8149 100644 --- a/clients/client-device-farm/commands/CreateInstanceProfileCommand.ts +++ b/clients/client-device-farm/commands/CreateInstanceProfileCommand.ts @@ -20,6 +20,10 @@ import { export type CreateInstanceProfileCommandInput = CreateInstanceProfileRequest; export type CreateInstanceProfileCommandOutput = CreateInstanceProfileResult & __MetadataBearer; +/** + *

Creates a profile that can be applied to one or more private fleet device + * instances.

+ */ export class CreateInstanceProfileCommand extends $Command< CreateInstanceProfileCommandInput, CreateInstanceProfileCommandOutput, @@ -34,6 +38,9 @@ export class CreateInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/CreateNetworkProfileCommand.ts b/clients/client-device-farm/commands/CreateNetworkProfileCommand.ts index 54fbea5c0a113..f6b061348a359 100644 --- a/clients/client-device-farm/commands/CreateNetworkProfileCommand.ts +++ b/clients/client-device-farm/commands/CreateNetworkProfileCommand.ts @@ -20,6 +20,9 @@ import { export type CreateNetworkProfileCommandInput = CreateNetworkProfileRequest; export type CreateNetworkProfileCommandOutput = CreateNetworkProfileResult & __MetadataBearer; +/** + *

Creates a network profile.

+ */ export class CreateNetworkProfileCommand extends $Command< CreateNetworkProfileCommandInput, CreateNetworkProfileCommandOutput, @@ -34,6 +37,9 @@ export class CreateNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/CreateProjectCommand.ts b/clients/client-device-farm/commands/CreateProjectCommand.ts index c0781b7999e75..2e915b4e5aee3 100644 --- a/clients/client-device-farm/commands/CreateProjectCommand.ts +++ b/clients/client-device-farm/commands/CreateProjectCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProjectCommandInput = CreateProjectRequest; export type CreateProjectCommandOutput = CreateProjectResult & __MetadataBearer; +/** + *

Creates a project.

+ */ export class CreateProjectCommand extends $Command< CreateProjectCommandInput, CreateProjectCommandOutput, @@ -34,6 +37,9 @@ export class CreateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/CreateRemoteAccessSessionCommand.ts b/clients/client-device-farm/commands/CreateRemoteAccessSessionCommand.ts index a17e903975d70..ca6c7ea57f1e6 100644 --- a/clients/client-device-farm/commands/CreateRemoteAccessSessionCommand.ts +++ b/clients/client-device-farm/commands/CreateRemoteAccessSessionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRemoteAccessSessionCommandInput = CreateRemoteAccessSessionRequest; export type CreateRemoteAccessSessionCommandOutput = CreateRemoteAccessSessionResult & __MetadataBearer; +/** + *

Specifies and starts a remote access session.

+ */ export class CreateRemoteAccessSessionCommand extends $Command< CreateRemoteAccessSessionCommandInput, CreateRemoteAccessSessionCommandOutput, @@ -34,6 +37,9 @@ export class CreateRemoteAccessSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/CreateTestGridProjectCommand.ts b/clients/client-device-farm/commands/CreateTestGridProjectCommand.ts index 1d1fb888d6899..3e0bfd13bbf4e 100644 --- a/clients/client-device-farm/commands/CreateTestGridProjectCommand.ts +++ b/clients/client-device-farm/commands/CreateTestGridProjectCommand.ts @@ -20,6 +20,10 @@ import { export type CreateTestGridProjectCommandInput = CreateTestGridProjectRequest; export type CreateTestGridProjectCommandOutput = CreateTestGridProjectResult & __MetadataBearer; +/** + *

Creates a Selenium testing project. Projects are used to track TestGridSession + * instances.

+ */ export class CreateTestGridProjectCommand extends $Command< CreateTestGridProjectCommandInput, CreateTestGridProjectCommandOutput, @@ -34,6 +38,9 @@ export class CreateTestGridProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/CreateTestGridUrlCommand.ts b/clients/client-device-farm/commands/CreateTestGridUrlCommand.ts index 4a64c7480252f..03d5aa6bee536 100644 --- a/clients/client-device-farm/commands/CreateTestGridUrlCommand.ts +++ b/clients/client-device-farm/commands/CreateTestGridUrlCommand.ts @@ -20,6 +20,10 @@ import { export type CreateTestGridUrlCommandInput = CreateTestGridUrlRequest; export type CreateTestGridUrlCommandOutput = CreateTestGridUrlResult & __MetadataBearer; +/** + *

Creates a signed, short-term URL that can be passed to a Selenium RemoteWebDriver + * constructor.

+ */ export class CreateTestGridUrlCommand extends $Command< CreateTestGridUrlCommandInput, CreateTestGridUrlCommandOutput, @@ -34,6 +38,9 @@ export class CreateTestGridUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/CreateUploadCommand.ts b/clients/client-device-farm/commands/CreateUploadCommand.ts index 8f282ccc8de05..9ac47c286d67c 100644 --- a/clients/client-device-farm/commands/CreateUploadCommand.ts +++ b/clients/client-device-farm/commands/CreateUploadCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUploadCommandInput = CreateUploadRequest; export type CreateUploadCommandOutput = CreateUploadResult & __MetadataBearer; +/** + *

Uploads an app or test scripts.

+ */ export class CreateUploadCommand extends $Command< CreateUploadCommandInput, CreateUploadCommandOutput, @@ -34,6 +37,9 @@ export class CreateUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/CreateVPCEConfigurationCommand.ts b/clients/client-device-farm/commands/CreateVPCEConfigurationCommand.ts index 0a23dd9a10769..39db4ee1cd8dd 100644 --- a/clients/client-device-farm/commands/CreateVPCEConfigurationCommand.ts +++ b/clients/client-device-farm/commands/CreateVPCEConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type CreateVPCEConfigurationCommandInput = CreateVPCEConfigurationRequest; export type CreateVPCEConfigurationCommandOutput = CreateVPCEConfigurationResult & __MetadataBearer; +/** + *

Creates a configuration record in Device Farm for your Amazon Virtual Private Cloud + * (VPC) endpoint.

+ */ export class CreateVPCEConfigurationCommand extends $Command< CreateVPCEConfigurationCommandInput, CreateVPCEConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class CreateVPCEConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteDevicePoolCommand.ts b/clients/client-device-farm/commands/DeleteDevicePoolCommand.ts index 25d67413bb861..e8cb16b36f023 100644 --- a/clients/client-device-farm/commands/DeleteDevicePoolCommand.ts +++ b/clients/client-device-farm/commands/DeleteDevicePoolCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDevicePoolCommandInput = DeleteDevicePoolRequest; export type DeleteDevicePoolCommandOutput = DeleteDevicePoolResult & __MetadataBearer; +/** + *

Deletes a device pool given the pool ARN. Does not allow deletion of curated pools + * owned by the system.

+ */ export class DeleteDevicePoolCommand extends $Command< DeleteDevicePoolCommandInput, DeleteDevicePoolCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDevicePoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteInstanceProfileCommand.ts b/clients/client-device-farm/commands/DeleteInstanceProfileCommand.ts index 0f5750a91759b..8ae83bd344903 100644 --- a/clients/client-device-farm/commands/DeleteInstanceProfileCommand.ts +++ b/clients/client-device-farm/commands/DeleteInstanceProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteInstanceProfileCommandInput = DeleteInstanceProfileRequest; export type DeleteInstanceProfileCommandOutput = DeleteInstanceProfileResult & __MetadataBearer; +/** + *

Deletes a profile that can be applied to one or more private device instances.

+ */ export class DeleteInstanceProfileCommand extends $Command< DeleteInstanceProfileCommandInput, DeleteInstanceProfileCommandOutput, @@ -34,6 +37,9 @@ export class DeleteInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteNetworkProfileCommand.ts b/clients/client-device-farm/commands/DeleteNetworkProfileCommand.ts index 5f3474c7c3633..2bf851c25b1c4 100644 --- a/clients/client-device-farm/commands/DeleteNetworkProfileCommand.ts +++ b/clients/client-device-farm/commands/DeleteNetworkProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNetworkProfileCommandInput = DeleteNetworkProfileRequest; export type DeleteNetworkProfileCommandOutput = DeleteNetworkProfileResult & __MetadataBearer; +/** + *

Deletes a network profile.

+ */ export class DeleteNetworkProfileCommand extends $Command< DeleteNetworkProfileCommandInput, DeleteNetworkProfileCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteProjectCommand.ts b/clients/client-device-farm/commands/DeleteProjectCommand.ts index 10a9876b57a9f..17416a9db344c 100644 --- a/clients/client-device-farm/commands/DeleteProjectCommand.ts +++ b/clients/client-device-farm/commands/DeleteProjectCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteProjectCommandInput = DeleteProjectRequest; export type DeleteProjectCommandOutput = DeleteProjectResult & __MetadataBearer; +/** + *

Deletes an AWS Device Farm project, given the project ARN.

+ *

Deleting this resource does not stop an in-progress run.

+ */ export class DeleteProjectCommand extends $Command< DeleteProjectCommandInput, DeleteProjectCommandOutput, @@ -34,6 +38,9 @@ export class DeleteProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteRemoteAccessSessionCommand.ts b/clients/client-device-farm/commands/DeleteRemoteAccessSessionCommand.ts index 477fd5b511d77..67b201d37fe7d 100644 --- a/clients/client-device-farm/commands/DeleteRemoteAccessSessionCommand.ts +++ b/clients/client-device-farm/commands/DeleteRemoteAccessSessionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRemoteAccessSessionCommandInput = DeleteRemoteAccessSessionRequest; export type DeleteRemoteAccessSessionCommandOutput = DeleteRemoteAccessSessionResult & __MetadataBearer; +/** + *

Deletes a completed remote access session and its results.

+ */ export class DeleteRemoteAccessSessionCommand extends $Command< DeleteRemoteAccessSessionCommandInput, DeleteRemoteAccessSessionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRemoteAccessSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteRunCommand.ts b/clients/client-device-farm/commands/DeleteRunCommand.ts index 2ed88b66aec02..8d989c077aaa2 100644 --- a/clients/client-device-farm/commands/DeleteRunCommand.ts +++ b/clients/client-device-farm/commands/DeleteRunCommand.ts @@ -17,6 +17,10 @@ import { export type DeleteRunCommandInput = DeleteRunRequest; export type DeleteRunCommandOutput = DeleteRunResult & __MetadataBearer; +/** + *

Deletes the run, given the run ARN.

+ *

Deleting this resource does not stop an in-progress run.

+ */ export class DeleteRunCommand extends $Command< DeleteRunCommandInput, DeleteRunCommandOutput, @@ -31,6 +35,9 @@ export class DeleteRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteTestGridProjectCommand.ts b/clients/client-device-farm/commands/DeleteTestGridProjectCommand.ts index 9031bf660e503..5ecd592add981 100644 --- a/clients/client-device-farm/commands/DeleteTestGridProjectCommand.ts +++ b/clients/client-device-farm/commands/DeleteTestGridProjectCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteTestGridProjectCommandInput = DeleteTestGridProjectRequest; export type DeleteTestGridProjectCommandOutput = DeleteTestGridProjectResult & __MetadataBearer; +/** + *

Deletes a Selenium testing project and all content generated under it.

+ * + *

You cannot undo this operation.

+ *
+ * + *

You cannot delete a project if it has active sessions.

+ *
+ */ export class DeleteTestGridProjectCommand extends $Command< DeleteTestGridProjectCommandInput, DeleteTestGridProjectCommandOutput, @@ -34,6 +43,9 @@ export class DeleteTestGridProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteUploadCommand.ts b/clients/client-device-farm/commands/DeleteUploadCommand.ts index 871124905950c..2aa032649d1db 100644 --- a/clients/client-device-farm/commands/DeleteUploadCommand.ts +++ b/clients/client-device-farm/commands/DeleteUploadCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUploadCommandInput = DeleteUploadRequest; export type DeleteUploadCommandOutput = DeleteUploadResult & __MetadataBearer; +/** + *

Deletes an upload given the upload ARN.

+ */ export class DeleteUploadCommand extends $Command< DeleteUploadCommandInput, DeleteUploadCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/DeleteVPCEConfigurationCommand.ts b/clients/client-device-farm/commands/DeleteVPCEConfigurationCommand.ts index 3d8002c7c8994..d6dd017d7b511 100644 --- a/clients/client-device-farm/commands/DeleteVPCEConfigurationCommand.ts +++ b/clients/client-device-farm/commands/DeleteVPCEConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVPCEConfigurationCommandInput = DeleteVPCEConfigurationRequest; export type DeleteVPCEConfigurationCommandOutput = DeleteVPCEConfigurationResult & __MetadataBearer; +/** + *

Deletes a configuration for your Amazon Virtual Private Cloud (VPC) endpoint.

+ */ export class DeleteVPCEConfigurationCommand extends $Command< DeleteVPCEConfigurationCommandInput, DeleteVPCEConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVPCEConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetAccountSettingsCommand.ts b/clients/client-device-farm/commands/GetAccountSettingsCommand.ts index 3693859e8df96..df059e70df915 100644 --- a/clients/client-device-farm/commands/GetAccountSettingsCommand.ts +++ b/clients/client-device-farm/commands/GetAccountSettingsCommand.ts @@ -20,6 +20,10 @@ import { export type GetAccountSettingsCommandInput = GetAccountSettingsRequest; export type GetAccountSettingsCommandOutput = GetAccountSettingsResult & __MetadataBearer; +/** + *

Returns the number of unmetered iOS or unmetered Android devices that have been purchased by the + * account.

+ */ export class GetAccountSettingsCommand extends $Command< GetAccountSettingsCommandInput, GetAccountSettingsCommandOutput, @@ -34,6 +38,9 @@ export class GetAccountSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetDeviceCommand.ts b/clients/client-device-farm/commands/GetDeviceCommand.ts index 0aaec17432d3e..61b464860b956 100644 --- a/clients/client-device-farm/commands/GetDeviceCommand.ts +++ b/clients/client-device-farm/commands/GetDeviceCommand.ts @@ -17,6 +17,9 @@ import { export type GetDeviceCommandInput = GetDeviceRequest; export type GetDeviceCommandOutput = GetDeviceResult & __MetadataBearer; +/** + *

Gets information about a unique device type.

+ */ export class GetDeviceCommand extends $Command< GetDeviceCommandInput, GetDeviceCommandOutput, @@ -31,6 +34,9 @@ export class GetDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetDeviceInstanceCommand.ts b/clients/client-device-farm/commands/GetDeviceInstanceCommand.ts index c0a1052ec4d34..fbc38d137e083 100644 --- a/clients/client-device-farm/commands/GetDeviceInstanceCommand.ts +++ b/clients/client-device-farm/commands/GetDeviceInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeviceInstanceCommandInput = GetDeviceInstanceRequest; export type GetDeviceInstanceCommandOutput = GetDeviceInstanceResult & __MetadataBearer; +/** + *

Returns information about a device instance that belongs to a private device fleet.

+ */ export class GetDeviceInstanceCommand extends $Command< GetDeviceInstanceCommandInput, GetDeviceInstanceCommandOutput, @@ -34,6 +37,9 @@ export class GetDeviceInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetDevicePoolCommand.ts b/clients/client-device-farm/commands/GetDevicePoolCommand.ts index 57f056c89bdc9..c6e3c687a2966 100644 --- a/clients/client-device-farm/commands/GetDevicePoolCommand.ts +++ b/clients/client-device-farm/commands/GetDevicePoolCommand.ts @@ -20,6 +20,9 @@ import { export type GetDevicePoolCommandInput = GetDevicePoolRequest; export type GetDevicePoolCommandOutput = GetDevicePoolResult & __MetadataBearer; +/** + *

Gets information about a device pool.

+ */ export class GetDevicePoolCommand extends $Command< GetDevicePoolCommandInput, GetDevicePoolCommandOutput, @@ -34,6 +37,9 @@ export class GetDevicePoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetDevicePoolCompatibilityCommand.ts b/clients/client-device-farm/commands/GetDevicePoolCompatibilityCommand.ts index 0bdc161c94782..e5394bcc3f9d4 100644 --- a/clients/client-device-farm/commands/GetDevicePoolCompatibilityCommand.ts +++ b/clients/client-device-farm/commands/GetDevicePoolCompatibilityCommand.ts @@ -20,6 +20,9 @@ import { export type GetDevicePoolCompatibilityCommandInput = GetDevicePoolCompatibilityRequest; export type GetDevicePoolCompatibilityCommandOutput = GetDevicePoolCompatibilityResult & __MetadataBearer; +/** + *

Gets information about compatibility with a device pool.

+ */ export class GetDevicePoolCompatibilityCommand extends $Command< GetDevicePoolCompatibilityCommandInput, GetDevicePoolCompatibilityCommandOutput, @@ -34,6 +37,9 @@ export class GetDevicePoolCompatibilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetInstanceProfileCommand.ts b/clients/client-device-farm/commands/GetInstanceProfileCommand.ts index 83ec0063eeca6..61ff7a5f379af 100644 --- a/clients/client-device-farm/commands/GetInstanceProfileCommand.ts +++ b/clients/client-device-farm/commands/GetInstanceProfileCommand.ts @@ -20,6 +20,9 @@ import { export type GetInstanceProfileCommandInput = GetInstanceProfileRequest; export type GetInstanceProfileCommandOutput = GetInstanceProfileResult & __MetadataBearer; +/** + *

Returns information about the specified instance profile.

+ */ export class GetInstanceProfileCommand extends $Command< GetInstanceProfileCommandInput, GetInstanceProfileCommandOutput, @@ -34,6 +37,9 @@ export class GetInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetJobCommand.ts b/clients/client-device-farm/commands/GetJobCommand.ts index 6772f4551defb..238526ee9def9 100644 --- a/clients/client-device-farm/commands/GetJobCommand.ts +++ b/clients/client-device-farm/commands/GetJobCommand.ts @@ -17,6 +17,9 @@ import { export type GetJobCommandInput = GetJobRequest; export type GetJobCommandOutput = GetJobResult & __MetadataBearer; +/** + *

Gets information about a job.

+ */ export class GetJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetJobCommand extends $Command, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetNetworkProfileCommand.ts b/clients/client-device-farm/commands/GetNetworkProfileCommand.ts index 8adb7c509413e..d23bea3f8933d 100644 --- a/clients/client-device-farm/commands/GetNetworkProfileCommand.ts +++ b/clients/client-device-farm/commands/GetNetworkProfileCommand.ts @@ -20,6 +20,9 @@ import { export type GetNetworkProfileCommandInput = GetNetworkProfileRequest; export type GetNetworkProfileCommandOutput = GetNetworkProfileResult & __MetadataBearer; +/** + *

Returns information about a network profile.

+ */ export class GetNetworkProfileCommand extends $Command< GetNetworkProfileCommandInput, GetNetworkProfileCommandOutput, @@ -34,6 +37,9 @@ export class GetNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetOfferingStatusCommand.ts b/clients/client-device-farm/commands/GetOfferingStatusCommand.ts index a568ef59ea303..461518ea54e7f 100644 --- a/clients/client-device-farm/commands/GetOfferingStatusCommand.ts +++ b/clients/client-device-farm/commands/GetOfferingStatusCommand.ts @@ -20,6 +20,12 @@ import { export type GetOfferingStatusCommandInput = GetOfferingStatusRequest; export type GetOfferingStatusCommandOutput = GetOfferingStatusResult & __MetadataBearer; +/** + *

Gets the current status and future status of all offerings purchased by an AWS account. The response + * indicates how many offerings are currently available and the offerings that will be available in the next + * period. The API returns a NotEligible error if the user is not permitted to invoke the + * operation. If you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com.

+ */ export class GetOfferingStatusCommand extends $Command< GetOfferingStatusCommandInput, GetOfferingStatusCommandOutput, @@ -34,6 +40,9 @@ export class GetOfferingStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetProjectCommand.ts b/clients/client-device-farm/commands/GetProjectCommand.ts index b2ce764737496..db9c01a8a949a 100644 --- a/clients/client-device-farm/commands/GetProjectCommand.ts +++ b/clients/client-device-farm/commands/GetProjectCommand.ts @@ -20,6 +20,9 @@ import { export type GetProjectCommandInput = GetProjectRequest; export type GetProjectCommandOutput = GetProjectResult & __MetadataBearer; +/** + *

Gets information about a project.

+ */ export class GetProjectCommand extends $Command< GetProjectCommandInput, GetProjectCommandOutput, @@ -34,6 +37,9 @@ export class GetProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetRemoteAccessSessionCommand.ts b/clients/client-device-farm/commands/GetRemoteAccessSessionCommand.ts index e02687d87a600..cd30e143e43d9 100644 --- a/clients/client-device-farm/commands/GetRemoteAccessSessionCommand.ts +++ b/clients/client-device-farm/commands/GetRemoteAccessSessionCommand.ts @@ -20,6 +20,9 @@ import { export type GetRemoteAccessSessionCommandInput = GetRemoteAccessSessionRequest; export type GetRemoteAccessSessionCommandOutput = GetRemoteAccessSessionResult & __MetadataBearer; +/** + *

Returns a link to a currently running remote access session.

+ */ export class GetRemoteAccessSessionCommand extends $Command< GetRemoteAccessSessionCommandInput, GetRemoteAccessSessionCommandOutput, @@ -34,6 +37,9 @@ export class GetRemoteAccessSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetRunCommand.ts b/clients/client-device-farm/commands/GetRunCommand.ts index cdf3751d37e2d..71ad742be4ece 100644 --- a/clients/client-device-farm/commands/GetRunCommand.ts +++ b/clients/client-device-farm/commands/GetRunCommand.ts @@ -17,6 +17,9 @@ import { export type GetRunCommandInput = GetRunRequest; export type GetRunCommandOutput = GetRunResult & __MetadataBearer; +/** + *

Gets information about a run.

+ */ export class GetRunCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetRunCommand extends $Command, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetSuiteCommand.ts b/clients/client-device-farm/commands/GetSuiteCommand.ts index 2662105daf39b..20dbc650dec07 100644 --- a/clients/client-device-farm/commands/GetSuiteCommand.ts +++ b/clients/client-device-farm/commands/GetSuiteCommand.ts @@ -17,6 +17,9 @@ import { export type GetSuiteCommandInput = GetSuiteRequest; export type GetSuiteCommandOutput = GetSuiteResult & __MetadataBearer; +/** + *

Gets information about a suite.

+ */ export class GetSuiteCommand extends $Command< GetSuiteCommandInput, GetSuiteCommandOutput, @@ -31,6 +34,9 @@ export class GetSuiteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetTestCommand.ts b/clients/client-device-farm/commands/GetTestCommand.ts index a362ebc2c133d..c0ef52611aad9 100644 --- a/clients/client-device-farm/commands/GetTestCommand.ts +++ b/clients/client-device-farm/commands/GetTestCommand.ts @@ -17,6 +17,9 @@ import { export type GetTestCommandInput = GetTestRequest; export type GetTestCommandOutput = GetTestResult & __MetadataBearer; +/** + *

Gets information about a test.

+ */ export class GetTestCommand extends $Command< GetTestCommandInput, GetTestCommandOutput, @@ -31,6 +34,9 @@ export class GetTestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetTestGridProjectCommand.ts b/clients/client-device-farm/commands/GetTestGridProjectCommand.ts index 681c13350bab0..f0a0575618836 100644 --- a/clients/client-device-farm/commands/GetTestGridProjectCommand.ts +++ b/clients/client-device-farm/commands/GetTestGridProjectCommand.ts @@ -20,6 +20,9 @@ import { export type GetTestGridProjectCommandInput = GetTestGridProjectRequest; export type GetTestGridProjectCommandOutput = GetTestGridProjectResult & __MetadataBearer; +/** + *

Retrieves information about a Selenium testing project.

+ */ export class GetTestGridProjectCommand extends $Command< GetTestGridProjectCommandInput, GetTestGridProjectCommandOutput, @@ -34,6 +37,9 @@ export class GetTestGridProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetTestGridSessionCommand.ts b/clients/client-device-farm/commands/GetTestGridSessionCommand.ts index 9c589456b77e2..239ebdecc5979 100644 --- a/clients/client-device-farm/commands/GetTestGridSessionCommand.ts +++ b/clients/client-device-farm/commands/GetTestGridSessionCommand.ts @@ -20,6 +20,18 @@ import { export type GetTestGridSessionCommandInput = GetTestGridSessionRequest; export type GetTestGridSessionCommandOutput = GetTestGridSessionResult & __MetadataBearer; +/** + *

A session is an instance of a browser created through a RemoteWebDriver with the URL from CreateTestGridUrlResult$url. You can use the following to look up sessions:

+ * + *

+ */ export class GetTestGridSessionCommand extends $Command< GetTestGridSessionCommandInput, GetTestGridSessionCommandOutput, @@ -34,6 +46,9 @@ export class GetTestGridSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetUploadCommand.ts b/clients/client-device-farm/commands/GetUploadCommand.ts index e32e2f2353542..a0f154685bcaf 100644 --- a/clients/client-device-farm/commands/GetUploadCommand.ts +++ b/clients/client-device-farm/commands/GetUploadCommand.ts @@ -17,6 +17,9 @@ import { export type GetUploadCommandInput = GetUploadRequest; export type GetUploadCommandOutput = GetUploadResult & __MetadataBearer; +/** + *

Gets information about an upload.

+ */ export class GetUploadCommand extends $Command< GetUploadCommandInput, GetUploadCommandOutput, @@ -31,6 +34,9 @@ export class GetUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/GetVPCEConfigurationCommand.ts b/clients/client-device-farm/commands/GetVPCEConfigurationCommand.ts index 436d523b0927d..f29deb2157ce9 100644 --- a/clients/client-device-farm/commands/GetVPCEConfigurationCommand.ts +++ b/clients/client-device-farm/commands/GetVPCEConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type GetVPCEConfigurationCommandInput = GetVPCEConfigurationRequest; export type GetVPCEConfigurationCommandOutput = GetVPCEConfigurationResult & __MetadataBearer; +/** + *

Returns information about the configuration settings for your Amazon Virtual Private + * Cloud (VPC) endpoint.

+ */ export class GetVPCEConfigurationCommand extends $Command< GetVPCEConfigurationCommandInput, GetVPCEConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class GetVPCEConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/InstallToRemoteAccessSessionCommand.ts b/clients/client-device-farm/commands/InstallToRemoteAccessSessionCommand.ts index e173c949b3d1d..fbcc623413618 100644 --- a/clients/client-device-farm/commands/InstallToRemoteAccessSessionCommand.ts +++ b/clients/client-device-farm/commands/InstallToRemoteAccessSessionCommand.ts @@ -20,6 +20,11 @@ import { export type InstallToRemoteAccessSessionCommandInput = InstallToRemoteAccessSessionRequest; export type InstallToRemoteAccessSessionCommandOutput = InstallToRemoteAccessSessionResult & __MetadataBearer; +/** + *

Installs an application to the device in a remote access session. For Android + * applications, the file must be in .apk format. For iOS applications, the file must be in + * .ipa format.

+ */ export class InstallToRemoteAccessSessionCommand extends $Command< InstallToRemoteAccessSessionCommandInput, InstallToRemoteAccessSessionCommandOutput, @@ -34,6 +39,9 @@ export class InstallToRemoteAccessSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListArtifactsCommand.ts b/clients/client-device-farm/commands/ListArtifactsCommand.ts index 73effd8689a52..55b7eebd788a5 100644 --- a/clients/client-device-farm/commands/ListArtifactsCommand.ts +++ b/clients/client-device-farm/commands/ListArtifactsCommand.ts @@ -20,6 +20,9 @@ import { export type ListArtifactsCommandInput = ListArtifactsRequest; export type ListArtifactsCommandOutput = ListArtifactsResult & __MetadataBearer; +/** + *

Gets information about artifacts.

+ */ export class ListArtifactsCommand extends $Command< ListArtifactsCommandInput, ListArtifactsCommandOutput, @@ -34,6 +37,9 @@ export class ListArtifactsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListDeviceInstancesCommand.ts b/clients/client-device-farm/commands/ListDeviceInstancesCommand.ts index f2845fd025b0a..84f6f09a4d9b2 100644 --- a/clients/client-device-farm/commands/ListDeviceInstancesCommand.ts +++ b/clients/client-device-farm/commands/ListDeviceInstancesCommand.ts @@ -20,6 +20,10 @@ import { export type ListDeviceInstancesCommandInput = ListDeviceInstancesRequest; export type ListDeviceInstancesCommandOutput = ListDeviceInstancesResult & __MetadataBearer; +/** + *

Returns information about the private device instances associated with one or more AWS + * accounts.

+ */ export class ListDeviceInstancesCommand extends $Command< ListDeviceInstancesCommandInput, ListDeviceInstancesCommandOutput, @@ -34,6 +38,9 @@ export class ListDeviceInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListDevicePoolsCommand.ts b/clients/client-device-farm/commands/ListDevicePoolsCommand.ts index 32edc7549aaba..62776af41665d 100644 --- a/clients/client-device-farm/commands/ListDevicePoolsCommand.ts +++ b/clients/client-device-farm/commands/ListDevicePoolsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDevicePoolsCommandInput = ListDevicePoolsRequest; export type ListDevicePoolsCommandOutput = ListDevicePoolsResult & __MetadataBearer; +/** + *

Gets information about device pools.

+ */ export class ListDevicePoolsCommand extends $Command< ListDevicePoolsCommandInput, ListDevicePoolsCommandOutput, @@ -34,6 +37,9 @@ export class ListDevicePoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListDevicesCommand.ts b/clients/client-device-farm/commands/ListDevicesCommand.ts index fa4c6db076324..e6f1c6df8a610 100644 --- a/clients/client-device-farm/commands/ListDevicesCommand.ts +++ b/clients/client-device-farm/commands/ListDevicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDevicesCommandInput = ListDevicesRequest; export type ListDevicesCommandOutput = ListDevicesResult & __MetadataBearer; +/** + *

Gets information about unique device types.

+ */ export class ListDevicesCommand extends $Command< ListDevicesCommandInput, ListDevicesCommandOutput, @@ -34,6 +37,9 @@ export class ListDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListInstanceProfilesCommand.ts b/clients/client-device-farm/commands/ListInstanceProfilesCommand.ts index 635d805a94f0a..9e715233d373d 100644 --- a/clients/client-device-farm/commands/ListInstanceProfilesCommand.ts +++ b/clients/client-device-farm/commands/ListInstanceProfilesCommand.ts @@ -20,6 +20,9 @@ import { export type ListInstanceProfilesCommandInput = ListInstanceProfilesRequest; export type ListInstanceProfilesCommandOutput = ListInstanceProfilesResult & __MetadataBearer; +/** + *

Returns information about all the instance profiles in an AWS account.

+ */ export class ListInstanceProfilesCommand extends $Command< ListInstanceProfilesCommandInput, ListInstanceProfilesCommandOutput, @@ -34,6 +37,9 @@ export class ListInstanceProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListJobsCommand.ts b/clients/client-device-farm/commands/ListJobsCommand.ts index 3072637072c1b..3565d6796ec67 100644 --- a/clients/client-device-farm/commands/ListJobsCommand.ts +++ b/clients/client-device-farm/commands/ListJobsCommand.ts @@ -17,6 +17,9 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResult & __MetadataBearer; +/** + *

Gets information about jobs for a given test run.

+ */ export class ListJobsCommand extends $Command< ListJobsCommandInput, ListJobsCommandOutput, @@ -31,6 +34,9 @@ export class ListJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListNetworkProfilesCommand.ts b/clients/client-device-farm/commands/ListNetworkProfilesCommand.ts index e4675d4e97f98..176e3974cc79a 100644 --- a/clients/client-device-farm/commands/ListNetworkProfilesCommand.ts +++ b/clients/client-device-farm/commands/ListNetworkProfilesCommand.ts @@ -20,6 +20,9 @@ import { export type ListNetworkProfilesCommandInput = ListNetworkProfilesRequest; export type ListNetworkProfilesCommandOutput = ListNetworkProfilesResult & __MetadataBearer; +/** + *

Returns the list of available network profiles.

+ */ export class ListNetworkProfilesCommand extends $Command< ListNetworkProfilesCommandInput, ListNetworkProfilesCommandOutput, @@ -34,6 +37,9 @@ export class ListNetworkProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListOfferingPromotionsCommand.ts b/clients/client-device-farm/commands/ListOfferingPromotionsCommand.ts index 37aa803af2bff..60a4f565bbf20 100644 --- a/clients/client-device-farm/commands/ListOfferingPromotionsCommand.ts +++ b/clients/client-device-farm/commands/ListOfferingPromotionsCommand.ts @@ -20,6 +20,11 @@ import { export type ListOfferingPromotionsCommandInput = ListOfferingPromotionsRequest; export type ListOfferingPromotionsCommandOutput = ListOfferingPromotionsResult & __MetadataBearer; +/** + *

Returns a list of offering promotions. Each offering promotion record contains the ID and description + * of the promotion. The API returns a NotEligible error if the caller is not permitted to invoke + * the operation. Contact aws-devicefarm-support@amazon.com if you must be able to invoke this operation.

+ */ export class ListOfferingPromotionsCommand extends $Command< ListOfferingPromotionsCommandInput, ListOfferingPromotionsCommandOutput, @@ -34,6 +39,9 @@ export class ListOfferingPromotionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListOfferingTransactionsCommand.ts b/clients/client-device-farm/commands/ListOfferingTransactionsCommand.ts index 8eebc7e4b3250..b7cd59f492f59 100644 --- a/clients/client-device-farm/commands/ListOfferingTransactionsCommand.ts +++ b/clients/client-device-farm/commands/ListOfferingTransactionsCommand.ts @@ -20,6 +20,12 @@ import { export type ListOfferingTransactionsCommandInput = ListOfferingTransactionsRequest; export type ListOfferingTransactionsCommandOutput = ListOfferingTransactionsResult & __MetadataBearer; +/** + *

Returns a list of all historical purchases, renewals, and system renewal transactions for an AWS + * account. The list is paginated and ordered by a descending timestamp (most recent transactions are first). + * The API returns a NotEligible error if the user is not permitted to invoke the operation. If + * you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com.

+ */ export class ListOfferingTransactionsCommand extends $Command< ListOfferingTransactionsCommandInput, ListOfferingTransactionsCommandOutput, @@ -34,6 +40,9 @@ export class ListOfferingTransactionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListOfferingsCommand.ts b/clients/client-device-farm/commands/ListOfferingsCommand.ts index 8112c810f096b..b8c0b600b68c2 100644 --- a/clients/client-device-farm/commands/ListOfferingsCommand.ts +++ b/clients/client-device-farm/commands/ListOfferingsCommand.ts @@ -20,6 +20,12 @@ import { export type ListOfferingsCommandInput = ListOfferingsRequest; export type ListOfferingsCommandOutput = ListOfferingsResult & __MetadataBearer; +/** + *

Returns a list of products or offerings that the user can manage through the API. Each offering record + * indicates the recurring price per unit and the frequency for that offering. The API returns a + * NotEligible error if the user is not permitted to invoke the operation. If you must be + * able to invoke this operation, contact aws-devicefarm-support@amazon.com.

+ */ export class ListOfferingsCommand extends $Command< ListOfferingsCommandInput, ListOfferingsCommandOutput, @@ -34,6 +40,9 @@ export class ListOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListProjectsCommand.ts b/clients/client-device-farm/commands/ListProjectsCommand.ts index f4d142989fd6a..a8f715dd0f375 100644 --- a/clients/client-device-farm/commands/ListProjectsCommand.ts +++ b/clients/client-device-farm/commands/ListProjectsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProjectsCommandInput = ListProjectsRequest; export type ListProjectsCommandOutput = ListProjectsResult & __MetadataBearer; +/** + *

Gets information about projects.

+ */ export class ListProjectsCommand extends $Command< ListProjectsCommandInput, ListProjectsCommandOutput, @@ -34,6 +37,9 @@ export class ListProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListRemoteAccessSessionsCommand.ts b/clients/client-device-farm/commands/ListRemoteAccessSessionsCommand.ts index ea83a94d0456d..bb6377082fa60 100644 --- a/clients/client-device-farm/commands/ListRemoteAccessSessionsCommand.ts +++ b/clients/client-device-farm/commands/ListRemoteAccessSessionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListRemoteAccessSessionsCommandInput = ListRemoteAccessSessionsRequest; export type ListRemoteAccessSessionsCommandOutput = ListRemoteAccessSessionsResult & __MetadataBearer; +/** + *

Returns a list of all currently running remote access sessions.

+ */ export class ListRemoteAccessSessionsCommand extends $Command< ListRemoteAccessSessionsCommandInput, ListRemoteAccessSessionsCommandOutput, @@ -34,6 +37,9 @@ export class ListRemoteAccessSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListRunsCommand.ts b/clients/client-device-farm/commands/ListRunsCommand.ts index e50cafc73472a..98e1b31dc94e5 100644 --- a/clients/client-device-farm/commands/ListRunsCommand.ts +++ b/clients/client-device-farm/commands/ListRunsCommand.ts @@ -17,6 +17,9 @@ import { export type ListRunsCommandInput = ListRunsRequest; export type ListRunsCommandOutput = ListRunsResult & __MetadataBearer; +/** + *

Gets information about runs, given an AWS Device Farm project ARN.

+ */ export class ListRunsCommand extends $Command< ListRunsCommandInput, ListRunsCommandOutput, @@ -31,6 +34,9 @@ export class ListRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListSamplesCommand.ts b/clients/client-device-farm/commands/ListSamplesCommand.ts index fbbe8704e829e..f1227871402c7 100644 --- a/clients/client-device-farm/commands/ListSamplesCommand.ts +++ b/clients/client-device-farm/commands/ListSamplesCommand.ts @@ -20,6 +20,9 @@ import { export type ListSamplesCommandInput = ListSamplesRequest; export type ListSamplesCommandOutput = ListSamplesResult & __MetadataBearer; +/** + *

Gets information about samples, given an AWS Device Farm job ARN.

+ */ export class ListSamplesCommand extends $Command< ListSamplesCommandInput, ListSamplesCommandOutput, @@ -34,6 +37,9 @@ export class ListSamplesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListSuitesCommand.ts b/clients/client-device-farm/commands/ListSuitesCommand.ts index e7fc77c7ee602..7f16f1f546d22 100644 --- a/clients/client-device-farm/commands/ListSuitesCommand.ts +++ b/clients/client-device-farm/commands/ListSuitesCommand.ts @@ -20,6 +20,9 @@ import { export type ListSuitesCommandInput = ListSuitesRequest; export type ListSuitesCommandOutput = ListSuitesResult & __MetadataBearer; +/** + *

Gets information about test suites for a given job.

+ */ export class ListSuitesCommand extends $Command< ListSuitesCommandInput, ListSuitesCommandOutput, @@ -34,6 +37,9 @@ export class ListSuitesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListTagsForResourceCommand.ts b/clients/client-device-farm/commands/ListTagsForResourceCommand.ts index 2b4c222fbf0cb..b26f0799ce6ba 100644 --- a/clients/client-device-farm/commands/ListTagsForResourceCommand.ts +++ b/clients/client-device-farm/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

List the tags for an AWS Device Farm resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListTestGridProjectsCommand.ts b/clients/client-device-farm/commands/ListTestGridProjectsCommand.ts index c02c42ab689b8..d73e2b841b19f 100644 --- a/clients/client-device-farm/commands/ListTestGridProjectsCommand.ts +++ b/clients/client-device-farm/commands/ListTestGridProjectsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTestGridProjectsCommandInput = ListTestGridProjectsRequest; export type ListTestGridProjectsCommandOutput = ListTestGridProjectsResult & __MetadataBearer; +/** + *

Gets a list of all Selenium testing projects in your account.

+ */ export class ListTestGridProjectsCommand extends $Command< ListTestGridProjectsCommandInput, ListTestGridProjectsCommandOutput, @@ -34,6 +37,9 @@ export class ListTestGridProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListTestGridSessionActionsCommand.ts b/clients/client-device-farm/commands/ListTestGridSessionActionsCommand.ts index 080c20bad3095..2607a399c4b0b 100644 --- a/clients/client-device-farm/commands/ListTestGridSessionActionsCommand.ts +++ b/clients/client-device-farm/commands/ListTestGridSessionActionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTestGridSessionActionsCommandInput = ListTestGridSessionActionsRequest; export type ListTestGridSessionActionsCommandOutput = ListTestGridSessionActionsResult & __MetadataBearer; +/** + *

Returns a list of the actions taken in a TestGridSession.

+ */ export class ListTestGridSessionActionsCommand extends $Command< ListTestGridSessionActionsCommandInput, ListTestGridSessionActionsCommandOutput, @@ -34,6 +37,9 @@ export class ListTestGridSessionActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListTestGridSessionArtifactsCommand.ts b/clients/client-device-farm/commands/ListTestGridSessionArtifactsCommand.ts index d8e0d27ee847a..c81974bd90aa5 100644 --- a/clients/client-device-farm/commands/ListTestGridSessionArtifactsCommand.ts +++ b/clients/client-device-farm/commands/ListTestGridSessionArtifactsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTestGridSessionArtifactsCommandInput = ListTestGridSessionArtifactsRequest; export type ListTestGridSessionArtifactsCommandOutput = ListTestGridSessionArtifactsResult & __MetadataBearer; +/** + *

Retrieves a list of artifacts created during the session.

+ */ export class ListTestGridSessionArtifactsCommand extends $Command< ListTestGridSessionArtifactsCommandInput, ListTestGridSessionArtifactsCommandOutput, @@ -34,6 +37,9 @@ export class ListTestGridSessionArtifactsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListTestGridSessionsCommand.ts b/clients/client-device-farm/commands/ListTestGridSessionsCommand.ts index 654bfdd8488d1..8188c56502b9c 100644 --- a/clients/client-device-farm/commands/ListTestGridSessionsCommand.ts +++ b/clients/client-device-farm/commands/ListTestGridSessionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTestGridSessionsCommandInput = ListTestGridSessionsRequest; export type ListTestGridSessionsCommandOutput = ListTestGridSessionsResult & __MetadataBearer; +/** + *

Retrieves a list of sessions for a TestGridProject.

+ */ export class ListTestGridSessionsCommand extends $Command< ListTestGridSessionsCommandInput, ListTestGridSessionsCommandOutput, @@ -34,6 +37,9 @@ export class ListTestGridSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListTestsCommand.ts b/clients/client-device-farm/commands/ListTestsCommand.ts index d960f31d854fe..2030bceab3354 100644 --- a/clients/client-device-farm/commands/ListTestsCommand.ts +++ b/clients/client-device-farm/commands/ListTestsCommand.ts @@ -17,6 +17,9 @@ import { export type ListTestsCommandInput = ListTestsRequest; export type ListTestsCommandOutput = ListTestsResult & __MetadataBearer; +/** + *

Gets information about tests in a given test suite.

+ */ export class ListTestsCommand extends $Command< ListTestsCommandInput, ListTestsCommandOutput, @@ -31,6 +34,9 @@ export class ListTestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListUniqueProblemsCommand.ts b/clients/client-device-farm/commands/ListUniqueProblemsCommand.ts index 6d7c23d91adfa..243216d0d0de6 100644 --- a/clients/client-device-farm/commands/ListUniqueProblemsCommand.ts +++ b/clients/client-device-farm/commands/ListUniqueProblemsCommand.ts @@ -20,6 +20,13 @@ import { export type ListUniqueProblemsCommandInput = ListUniqueProblemsRequest; export type ListUniqueProblemsCommandOutput = ListUniqueProblemsResult & __MetadataBearer; +/** + *

Gets information about unique problems, such as exceptions or crashes.

+ *

Unique problems are defined as a single instance of an error across a run, job, or suite. For example, + * if a call in your application consistently raises an exception (OutOfBoundsException in + * MyActivity.java:386), ListUniqueProblems returns a single entry instead of many + * individual entries for that exception.

+ */ export class ListUniqueProblemsCommand extends $Command< ListUniqueProblemsCommandInput, ListUniqueProblemsCommandOutput, @@ -34,6 +41,9 @@ export class ListUniqueProblemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListUploadsCommand.ts b/clients/client-device-farm/commands/ListUploadsCommand.ts index 1b127ae9d6b35..c9c24882babde 100644 --- a/clients/client-device-farm/commands/ListUploadsCommand.ts +++ b/clients/client-device-farm/commands/ListUploadsCommand.ts @@ -20,6 +20,9 @@ import { export type ListUploadsCommandInput = ListUploadsRequest; export type ListUploadsCommandOutput = ListUploadsResult & __MetadataBearer; +/** + *

Gets information about uploads, given an AWS Device Farm project ARN.

+ */ export class ListUploadsCommand extends $Command< ListUploadsCommandInput, ListUploadsCommandOutput, @@ -34,6 +37,9 @@ export class ListUploadsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ListVPCEConfigurationsCommand.ts b/clients/client-device-farm/commands/ListVPCEConfigurationsCommand.ts index c1a36132c644a..97a441bb28b53 100644 --- a/clients/client-device-farm/commands/ListVPCEConfigurationsCommand.ts +++ b/clients/client-device-farm/commands/ListVPCEConfigurationsCommand.ts @@ -20,6 +20,10 @@ import { export type ListVPCEConfigurationsCommandInput = ListVPCEConfigurationsRequest; export type ListVPCEConfigurationsCommandOutput = ListVPCEConfigurationsResult & __MetadataBearer; +/** + *

Returns information about all Amazon Virtual Private Cloud (VPC) endpoint + * configurations in the AWS account.

+ */ export class ListVPCEConfigurationsCommand extends $Command< ListVPCEConfigurationsCommandInput, ListVPCEConfigurationsCommandOutput, @@ -34,6 +38,9 @@ export class ListVPCEConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/PurchaseOfferingCommand.ts b/clients/client-device-farm/commands/PurchaseOfferingCommand.ts index 3a78694a10951..f489e8a8cfe00 100644 --- a/clients/client-device-farm/commands/PurchaseOfferingCommand.ts +++ b/clients/client-device-farm/commands/PurchaseOfferingCommand.ts @@ -20,6 +20,12 @@ import { export type PurchaseOfferingCommandInput = PurchaseOfferingRequest; export type PurchaseOfferingCommandOutput = PurchaseOfferingResult & __MetadataBearer; +/** + *

Immediately purchases offerings for an AWS account. Offerings renew with the latest total purchased + * quantity for an offering, unless the renewal was overridden. The API returns a NotEligible + * error if the user is not permitted to invoke the operation. If you must be able to invoke this operation, + * contact aws-devicefarm-support@amazon.com.

+ */ export class PurchaseOfferingCommand extends $Command< PurchaseOfferingCommandInput, PurchaseOfferingCommandOutput, @@ -34,6 +40,9 @@ export class PurchaseOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/RenewOfferingCommand.ts b/clients/client-device-farm/commands/RenewOfferingCommand.ts index fff82ff8c5a9e..2e2648d6e2f71 100644 --- a/clients/client-device-farm/commands/RenewOfferingCommand.ts +++ b/clients/client-device-farm/commands/RenewOfferingCommand.ts @@ -20,6 +20,11 @@ import { export type RenewOfferingCommandInput = RenewOfferingRequest; export type RenewOfferingCommandOutput = RenewOfferingResult & __MetadataBearer; +/** + *

Explicitly sets the quantity of devices to renew for an offering, starting from the + * effectiveDate of the next period. The API returns a NotEligible error if the + * user is not permitted to invoke the operation. If you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com.

+ */ export class RenewOfferingCommand extends $Command< RenewOfferingCommandInput, RenewOfferingCommandOutput, @@ -34,6 +39,9 @@ export class RenewOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/ScheduleRunCommand.ts b/clients/client-device-farm/commands/ScheduleRunCommand.ts index d7a882eeb3e9c..6953a2082aa87 100644 --- a/clients/client-device-farm/commands/ScheduleRunCommand.ts +++ b/clients/client-device-farm/commands/ScheduleRunCommand.ts @@ -20,6 +20,9 @@ import { export type ScheduleRunCommandInput = ScheduleRunRequest; export type ScheduleRunCommandOutput = ScheduleRunResult & __MetadataBearer; +/** + *

Schedules a run.

+ */ export class ScheduleRunCommand extends $Command< ScheduleRunCommandInput, ScheduleRunCommandOutput, @@ -34,6 +37,9 @@ export class ScheduleRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/StopJobCommand.ts b/clients/client-device-farm/commands/StopJobCommand.ts index f11a5f2725b9f..8318f4c16ebf8 100644 --- a/clients/client-device-farm/commands/StopJobCommand.ts +++ b/clients/client-device-farm/commands/StopJobCommand.ts @@ -17,6 +17,12 @@ import { export type StopJobCommandInput = StopJobRequest; export type StopJobCommandOutput = StopJobResult & __MetadataBearer; +/** + *

Initiates a stop request for the current job. AWS Device Farm immediately stops the job on the device + * where tests have not started. You are not billed for this device. On the device where tests have started, + * setup suite and teardown suite tests run to completion on the device. You are billed for setup, teardown, + * and any tests that were in progress or already completed.

+ */ export class StopJobCommand extends $Command< StopJobCommandInput, StopJobCommandOutput, @@ -31,6 +37,9 @@ export class StopJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/StopRemoteAccessSessionCommand.ts b/clients/client-device-farm/commands/StopRemoteAccessSessionCommand.ts index 2143607197bb2..265c91a6a53a5 100644 --- a/clients/client-device-farm/commands/StopRemoteAccessSessionCommand.ts +++ b/clients/client-device-farm/commands/StopRemoteAccessSessionCommand.ts @@ -20,6 +20,9 @@ import { export type StopRemoteAccessSessionCommandInput = StopRemoteAccessSessionRequest; export type StopRemoteAccessSessionCommandOutput = StopRemoteAccessSessionResult & __MetadataBearer; +/** + *

Ends a specified remote access session.

+ */ export class StopRemoteAccessSessionCommand extends $Command< StopRemoteAccessSessionCommandInput, StopRemoteAccessSessionCommandOutput, @@ -34,6 +37,9 @@ export class StopRemoteAccessSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/StopRunCommand.ts b/clients/client-device-farm/commands/StopRunCommand.ts index 50faefb7559ca..919b4ce277c5c 100644 --- a/clients/client-device-farm/commands/StopRunCommand.ts +++ b/clients/client-device-farm/commands/StopRunCommand.ts @@ -17,6 +17,12 @@ import { export type StopRunCommandInput = StopRunRequest; export type StopRunCommandOutput = StopRunResult & __MetadataBearer; +/** + *

Initiates a stop request for the current test run. AWS Device Farm immediately stops the run on devices + * where tests have not started. You are not billed for these devices. On devices where tests have started + * executing, setup suite and teardown suite tests run to completion on those devices. You are billed for + * setup, teardown, and any tests that were in progress or already completed.

+ */ export class StopRunCommand extends $Command< StopRunCommandInput, StopRunCommandOutput, @@ -31,6 +37,9 @@ export class StopRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/TagResourceCommand.ts b/clients/client-device-farm/commands/TagResourceCommand.ts index 550486a72b79e..4fa2275223711 100644 --- a/clients/client-device-farm/commands/TagResourceCommand.ts +++ b/clients/client-device-farm/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Associates the specified tags to a resource with the specified resourceArn. If existing tags + * on a resource are not specified in the request parameters, they are not changed. When a resource is deleted, + * the tags associated with that resource are also deleted.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UntagResourceCommand.ts b/clients/client-device-farm/commands/UntagResourceCommand.ts index 5ce7e8b27aa0e..59939ce757df9 100644 --- a/clients/client-device-farm/commands/UntagResourceCommand.ts +++ b/clients/client-device-farm/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Deletes the specified tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UpdateDeviceInstanceCommand.ts b/clients/client-device-farm/commands/UpdateDeviceInstanceCommand.ts index c21d81223e1f4..5e35a5655d770 100644 --- a/clients/client-device-farm/commands/UpdateDeviceInstanceCommand.ts +++ b/clients/client-device-farm/commands/UpdateDeviceInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDeviceInstanceCommandInput = UpdateDeviceInstanceRequest; export type UpdateDeviceInstanceCommandOutput = UpdateDeviceInstanceResult & __MetadataBearer; +/** + *

Updates information about a private device instance.

+ */ export class UpdateDeviceInstanceCommand extends $Command< UpdateDeviceInstanceCommandInput, UpdateDeviceInstanceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDeviceInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UpdateDevicePoolCommand.ts b/clients/client-device-farm/commands/UpdateDevicePoolCommand.ts index 3e8bcc39759a1..63a257be964f8 100644 --- a/clients/client-device-farm/commands/UpdateDevicePoolCommand.ts +++ b/clients/client-device-farm/commands/UpdateDevicePoolCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateDevicePoolCommandInput = UpdateDevicePoolRequest; export type UpdateDevicePoolCommandOutput = UpdateDevicePoolResult & __MetadataBearer; +/** + *

Modifies the name, description, and rules in a device pool given the attributes and + * the pool ARN. Rule updates are all-or-nothing, meaning they can only be updated as a + * whole (or not at all).

+ */ export class UpdateDevicePoolCommand extends $Command< UpdateDevicePoolCommandInput, UpdateDevicePoolCommandOutput, @@ -34,6 +39,9 @@ export class UpdateDevicePoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UpdateInstanceProfileCommand.ts b/clients/client-device-farm/commands/UpdateInstanceProfileCommand.ts index a1ac2bee999aa..526d18378bd95 100644 --- a/clients/client-device-farm/commands/UpdateInstanceProfileCommand.ts +++ b/clients/client-device-farm/commands/UpdateInstanceProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateInstanceProfileCommandInput = UpdateInstanceProfileRequest; export type UpdateInstanceProfileCommandOutput = UpdateInstanceProfileResult & __MetadataBearer; +/** + *

Updates information about an existing private device instance profile.

+ */ export class UpdateInstanceProfileCommand extends $Command< UpdateInstanceProfileCommandInput, UpdateInstanceProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UpdateNetworkProfileCommand.ts b/clients/client-device-farm/commands/UpdateNetworkProfileCommand.ts index 9500c2139d122..dbd0fc6b880a9 100644 --- a/clients/client-device-farm/commands/UpdateNetworkProfileCommand.ts +++ b/clients/client-device-farm/commands/UpdateNetworkProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateNetworkProfileCommandInput = UpdateNetworkProfileRequest; export type UpdateNetworkProfileCommandOutput = UpdateNetworkProfileResult & __MetadataBearer; +/** + *

Updates the network profile.

+ */ export class UpdateNetworkProfileCommand extends $Command< UpdateNetworkProfileCommandInput, UpdateNetworkProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateNetworkProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UpdateProjectCommand.ts b/clients/client-device-farm/commands/UpdateProjectCommand.ts index 38649e975e27a..79f422ee02104 100644 --- a/clients/client-device-farm/commands/UpdateProjectCommand.ts +++ b/clients/client-device-farm/commands/UpdateProjectCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateProjectCommandInput = UpdateProjectRequest; export type UpdateProjectCommandOutput = UpdateProjectResult & __MetadataBearer; +/** + *

Modifies the specified project name, given the project ARN and a new + * name.

+ */ export class UpdateProjectCommand extends $Command< UpdateProjectCommandInput, UpdateProjectCommandOutput, @@ -34,6 +38,9 @@ export class UpdateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UpdateTestGridProjectCommand.ts b/clients/client-device-farm/commands/UpdateTestGridProjectCommand.ts index 0f08c27144ec7..be83d011e9e44 100644 --- a/clients/client-device-farm/commands/UpdateTestGridProjectCommand.ts +++ b/clients/client-device-farm/commands/UpdateTestGridProjectCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTestGridProjectCommandInput = UpdateTestGridProjectRequest; export type UpdateTestGridProjectCommandOutput = UpdateTestGridProjectResult & __MetadataBearer; +/** + *

Change details of a project.

+ */ export class UpdateTestGridProjectCommand extends $Command< UpdateTestGridProjectCommandInput, UpdateTestGridProjectCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTestGridProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UpdateUploadCommand.ts b/clients/client-device-farm/commands/UpdateUploadCommand.ts index cf5a0824a9b67..ba7c6bed5bb5a 100644 --- a/clients/client-device-farm/commands/UpdateUploadCommand.ts +++ b/clients/client-device-farm/commands/UpdateUploadCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUploadCommandInput = UpdateUploadRequest; export type UpdateUploadCommandOutput = UpdateUploadResult & __MetadataBearer; +/** + *

Updates an uploaded test spec.

+ */ export class UpdateUploadCommand extends $Command< UpdateUploadCommandInput, UpdateUploadCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/commands/UpdateVPCEConfigurationCommand.ts b/clients/client-device-farm/commands/UpdateVPCEConfigurationCommand.ts index b35d2b1c68146..bb1f51989d541 100644 --- a/clients/client-device-farm/commands/UpdateVPCEConfigurationCommand.ts +++ b/clients/client-device-farm/commands/UpdateVPCEConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVPCEConfigurationCommandInput = UpdateVPCEConfigurationRequest; export type UpdateVPCEConfigurationCommandOutput = UpdateVPCEConfigurationResult & __MetadataBearer; +/** + *

Updates information about an Amazon Virtual Private Cloud (VPC) endpoint configuration.

+ */ export class UpdateVPCEConfigurationCommand extends $Command< UpdateVPCEConfigurationCommandInput, UpdateVPCEConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVPCEConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DeviceFarmClientResolvedConfig, diff --git a/clients/client-device-farm/package.json b/clients/client-device-farm/package.json index e9fb18d3ccdf2..3d5ca3afaa858 100644 --- a/clients/client-device-farm/package.json +++ b/clients/client-device-farm/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Device Farm Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-device-farm/pagination/GetOfferingStatusPaginator.ts b/clients/client-device-farm/pagination/GetOfferingStatusPaginator.ts index 9f0b069fe623c..6edb1a0e52d05 100644 --- a/clients/client-device-farm/pagination/GetOfferingStatusPaginator.ts +++ b/clients/client-device-farm/pagination/GetOfferingStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: GetOfferingStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetOfferingStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: GetOfferingStatusCommandInput, diff --git a/clients/client-device-farm/pagination/ListArtifactsPaginator.ts b/clients/client-device-farm/pagination/ListArtifactsPaginator.ts index 0cedb9d27a7eb..0003829da1a6b 100644 --- a/clients/client-device-farm/pagination/ListArtifactsPaginator.ts +++ b/clients/client-device-farm/pagination/ListArtifactsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListArtifactsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListArtifactsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListArtifactsCommandInput, diff --git a/clients/client-device-farm/pagination/ListDevicePoolsPaginator.ts b/clients/client-device-farm/pagination/ListDevicePoolsPaginator.ts index e784eaccc399d..dbf6c8645054c 100644 --- a/clients/client-device-farm/pagination/ListDevicePoolsPaginator.ts +++ b/clients/client-device-farm/pagination/ListDevicePoolsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListDevicePoolsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDevicePoolsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListDevicePoolsCommandInput, diff --git a/clients/client-device-farm/pagination/ListDevicesPaginator.ts b/clients/client-device-farm/pagination/ListDevicesPaginator.ts index 72f6edfa6db54..37036fe5515d7 100644 --- a/clients/client-device-farm/pagination/ListDevicesPaginator.ts +++ b/clients/client-device-farm/pagination/ListDevicesPaginator.ts @@ -4,6 +4,9 @@ import { ListDevicesCommand, ListDevicesCommandInput, ListDevicesCommandOutput } import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListDevicesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListDevicesCommandInput, diff --git a/clients/client-device-farm/pagination/ListJobsPaginator.ts b/clients/client-device-farm/pagination/ListJobsPaginator.ts index 545c5d7dc5608..4ce1e1ad23ed8 100644 --- a/clients/client-device-farm/pagination/ListJobsPaginator.ts +++ b/clients/client-device-farm/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListJobsCommandInput, diff --git a/clients/client-device-farm/pagination/ListOfferingTransactionsPaginator.ts b/clients/client-device-farm/pagination/ListOfferingTransactionsPaginator.ts index cef51ef282b39..9f59f2fe60b1f 100644 --- a/clients/client-device-farm/pagination/ListOfferingTransactionsPaginator.ts +++ b/clients/client-device-farm/pagination/ListOfferingTransactionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListOfferingTransactionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOfferingTransactionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListOfferingTransactionsCommandInput, diff --git a/clients/client-device-farm/pagination/ListOfferingsPaginator.ts b/clients/client-device-farm/pagination/ListOfferingsPaginator.ts index 849d058dee7c7..13d17fb284795 100644 --- a/clients/client-device-farm/pagination/ListOfferingsPaginator.ts +++ b/clients/client-device-farm/pagination/ListOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListOfferingsCommandInput, diff --git a/clients/client-device-farm/pagination/ListProjectsPaginator.ts b/clients/client-device-farm/pagination/ListProjectsPaginator.ts index 482d7a14a01b7..b4544f57dd3ed 100644 --- a/clients/client-device-farm/pagination/ListProjectsPaginator.ts +++ b/clients/client-device-farm/pagination/ListProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListProjectsCommandInput, diff --git a/clients/client-device-farm/pagination/ListRunsPaginator.ts b/clients/client-device-farm/pagination/ListRunsPaginator.ts index 354c3ad50058d..feff3528502fb 100644 --- a/clients/client-device-farm/pagination/ListRunsPaginator.ts +++ b/clients/client-device-farm/pagination/ListRunsPaginator.ts @@ -4,6 +4,9 @@ import { ListRunsCommand, ListRunsCommandInput, ListRunsCommandOutput } from ".. import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListRunsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListRunsCommandInput, diff --git a/clients/client-device-farm/pagination/ListSamplesPaginator.ts b/clients/client-device-farm/pagination/ListSamplesPaginator.ts index 62acdc0af386c..3d10b11ba0d4f 100644 --- a/clients/client-device-farm/pagination/ListSamplesPaginator.ts +++ b/clients/client-device-farm/pagination/ListSamplesPaginator.ts @@ -4,6 +4,9 @@ import { ListSamplesCommand, ListSamplesCommandInput, ListSamplesCommandOutput } import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListSamplesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSamplesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListSamplesCommandInput, diff --git a/clients/client-device-farm/pagination/ListSuitesPaginator.ts b/clients/client-device-farm/pagination/ListSuitesPaginator.ts index 61c12d1cb9811..0760cf8c6f269 100644 --- a/clients/client-device-farm/pagination/ListSuitesPaginator.ts +++ b/clients/client-device-farm/pagination/ListSuitesPaginator.ts @@ -4,6 +4,9 @@ import { ListSuitesCommand, ListSuitesCommandInput, ListSuitesCommandOutput } fr import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListSuitesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSuitesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListSuitesCommandInput, diff --git a/clients/client-device-farm/pagination/ListTestGridProjectsPaginator.ts b/clients/client-device-farm/pagination/ListTestGridProjectsPaginator.ts index f04c533323f81..902c052e6c99f 100644 --- a/clients/client-device-farm/pagination/ListTestGridProjectsPaginator.ts +++ b/clients/client-device-farm/pagination/ListTestGridProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListTestGridProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTestGridProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListTestGridProjectsCommandInput, diff --git a/clients/client-device-farm/pagination/ListTestGridSessionActionsPaginator.ts b/clients/client-device-farm/pagination/ListTestGridSessionActionsPaginator.ts index 78d285876d4e8..c5a2b53ef57b3 100644 --- a/clients/client-device-farm/pagination/ListTestGridSessionActionsPaginator.ts +++ b/clients/client-device-farm/pagination/ListTestGridSessionActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListTestGridSessionActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTestGridSessionActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListTestGridSessionActionsCommandInput, diff --git a/clients/client-device-farm/pagination/ListTestGridSessionArtifactsPaginator.ts b/clients/client-device-farm/pagination/ListTestGridSessionArtifactsPaginator.ts index eea925e4d08ef..b2a71b5d56478 100644 --- a/clients/client-device-farm/pagination/ListTestGridSessionArtifactsPaginator.ts +++ b/clients/client-device-farm/pagination/ListTestGridSessionArtifactsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListTestGridSessionArtifactsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTestGridSessionArtifactsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListTestGridSessionArtifactsCommandInput, diff --git a/clients/client-device-farm/pagination/ListTestGridSessionsPaginator.ts b/clients/client-device-farm/pagination/ListTestGridSessionsPaginator.ts index 45804c04e1a0e..313a1d437837a 100644 --- a/clients/client-device-farm/pagination/ListTestGridSessionsPaginator.ts +++ b/clients/client-device-farm/pagination/ListTestGridSessionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListTestGridSessionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTestGridSessionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListTestGridSessionsCommandInput, diff --git a/clients/client-device-farm/pagination/ListTestsPaginator.ts b/clients/client-device-farm/pagination/ListTestsPaginator.ts index 3738f36874013..7eed341c6d9c8 100644 --- a/clients/client-device-farm/pagination/ListTestsPaginator.ts +++ b/clients/client-device-farm/pagination/ListTestsPaginator.ts @@ -4,6 +4,9 @@ import { ListTestsCommand, ListTestsCommandInput, ListTestsCommandOutput } from import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListTestsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTestsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListTestsCommandInput, diff --git a/clients/client-device-farm/pagination/ListUniqueProblemsPaginator.ts b/clients/client-device-farm/pagination/ListUniqueProblemsPaginator.ts index 1501843390c90..c50e54f5b3044 100644 --- a/clients/client-device-farm/pagination/ListUniqueProblemsPaginator.ts +++ b/clients/client-device-farm/pagination/ListUniqueProblemsPaginator.ts @@ -8,6 +8,9 @@ import { import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListUniqueProblemsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUniqueProblemsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListUniqueProblemsCommandInput, diff --git a/clients/client-device-farm/pagination/ListUploadsPaginator.ts b/clients/client-device-farm/pagination/ListUploadsPaginator.ts index a299e749dabe9..5c2dc19ee507f 100644 --- a/clients/client-device-farm/pagination/ListUploadsPaginator.ts +++ b/clients/client-device-farm/pagination/ListUploadsPaginator.ts @@ -4,6 +4,9 @@ import { ListUploadsCommand, ListUploadsCommandInput, ListUploadsCommandOutput } import { DeviceFarmPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DeviceFarmClient, input: ListUploadsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUploadsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DeviceFarm, input: ListUploadsCommandInput, diff --git a/clients/client-device-farm/runtimeConfig.browser.ts b/clients/client-device-farm/runtimeConfig.browser.ts index a34a9e8d07564..f82a2d7b06c65 100644 --- a/clients/client-device-farm/runtimeConfig.browser.ts +++ b/clients/client-device-farm/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DeviceFarmClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-device-farm/runtimeConfig.native.ts b/clients/client-device-farm/runtimeConfig.native.ts index 1200a8b5b7094..50894c54866f9 100644 --- a/clients/client-device-farm/runtimeConfig.native.ts +++ b/clients/client-device-farm/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DeviceFarmClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-device-farm/runtimeConfig.shared.ts b/clients/client-device-farm/runtimeConfig.shared.ts index f191356db3c97..b60123041deb7 100644 --- a/clients/client-device-farm/runtimeConfig.shared.ts +++ b/clients/client-device-farm/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-06-23", disableHostPrefix: false, diff --git a/clients/client-device-farm/runtimeConfig.ts b/clients/client-device-farm/runtimeConfig.ts index bf983c797f6a0..1d2df95bf0539 100644 --- a/clients/client-device-farm/runtimeConfig.ts +++ b/clients/client-device-farm/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DeviceFarmClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-device-farm/tsconfig.json b/clients/client-device-farm/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-device-farm/tsconfig.json +++ b/clients/client-device-farm/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-direct-connect/commands/AcceptDirectConnectGatewayAssociationProposalCommand.ts b/clients/client-direct-connect/commands/AcceptDirectConnectGatewayAssociationProposalCommand.ts index 73dde8def8ecd..b77ff2a0f97e2 100644 --- a/clients/client-direct-connect/commands/AcceptDirectConnectGatewayAssociationProposalCommand.ts +++ b/clients/client-direct-connect/commands/AcceptDirectConnectGatewayAssociationProposalCommand.ts @@ -24,6 +24,9 @@ export type AcceptDirectConnectGatewayAssociationProposalCommandInput = AcceptDi export type AcceptDirectConnectGatewayAssociationProposalCommandOutput = AcceptDirectConnectGatewayAssociationProposalResult & __MetadataBearer; +/** + *

Accepts a proposal request to attach a virtual private gateway or transit gateway to a Direct Connect gateway.

+ */ export class AcceptDirectConnectGatewayAssociationProposalCommand extends $Command< AcceptDirectConnectGatewayAssociationProposalCommandInput, AcceptDirectConnectGatewayAssociationProposalCommandOutput, @@ -38,6 +41,9 @@ export class AcceptDirectConnectGatewayAssociationProposalCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/AllocateConnectionOnInterconnectCommand.ts b/clients/client-direct-connect/commands/AllocateConnectionOnInterconnectCommand.ts index 6b8d274214176..188d90a3924d0 100644 --- a/clients/client-direct-connect/commands/AllocateConnectionOnInterconnectCommand.ts +++ b/clients/client-direct-connect/commands/AllocateConnectionOnInterconnectCommand.ts @@ -20,6 +20,14 @@ import { export type AllocateConnectionOnInterconnectCommandInput = AllocateConnectionOnInterconnectRequest; export type AllocateConnectionOnInterconnectCommandOutput = Connection & __MetadataBearer; +/** + *

Deprecated. Use AllocateHostedConnection instead.

+ *

Creates a hosted connection on an interconnect.

+ *

Allocates a VLAN number and a specified amount of bandwidth for use by a hosted connection on the specified interconnect.

+ * + *

Intended for use by AWS Direct Connect Partners only.

+ *
+ */ export class AllocateConnectionOnInterconnectCommand extends $Command< AllocateConnectionOnInterconnectCommandInput, AllocateConnectionOnInterconnectCommandOutput, @@ -34,6 +42,9 @@ export class AllocateConnectionOnInterconnectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/AllocateHostedConnectionCommand.ts b/clients/client-direct-connect/commands/AllocateHostedConnectionCommand.ts index 06274424b3531..740e0e246d5e6 100644 --- a/clients/client-direct-connect/commands/AllocateHostedConnectionCommand.ts +++ b/clients/client-direct-connect/commands/AllocateHostedConnectionCommand.ts @@ -20,6 +20,13 @@ import { export type AllocateHostedConnectionCommandInput = AllocateHostedConnectionRequest; export type AllocateHostedConnectionCommandOutput = Connection & __MetadataBearer; +/** + *

Creates a hosted connection on the specified interconnect or a link aggregation group (LAG) of interconnects.

+ *

Allocates a VLAN number and a specified amount of capacity (bandwidth) for use by a hosted connection on the specified interconnect or LAG of interconnects. AWS polices the hosted connection for the specified capacity and the AWS Direct Connect Partner must also police the hosted connection for the specified capacity.

+ * + *

Intended for use by AWS Direct Connect Partners only.

+ *
+ */ export class AllocateHostedConnectionCommand extends $Command< AllocateHostedConnectionCommandInput, AllocateHostedConnectionCommandOutput, @@ -34,6 +41,9 @@ export class AllocateHostedConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/AllocatePrivateVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/AllocatePrivateVirtualInterfaceCommand.ts index 9a78a3fc06ef8..142dbe34f6d0d 100644 --- a/clients/client-direct-connect/commands/AllocatePrivateVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/AllocatePrivateVirtualInterfaceCommand.ts @@ -20,6 +20,11 @@ import { export type AllocatePrivateVirtualInterfaceCommandInput = AllocatePrivateVirtualInterfaceRequest; export type AllocatePrivateVirtualInterfaceCommandOutput = VirtualInterface & __MetadataBearer; +/** + *

Provisions a private virtual interface to be owned by the specified AWS account.

+ *

Virtual interfaces created using this action must be confirmed by the owner using ConfirmPrivateVirtualInterface. + * Until then, the virtual interface is in the Confirming state and is not available to handle traffic.

+ */ export class AllocatePrivateVirtualInterfaceCommand extends $Command< AllocatePrivateVirtualInterfaceCommandInput, AllocatePrivateVirtualInterfaceCommandOutput, @@ -34,6 +39,9 @@ export class AllocatePrivateVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/AllocatePublicVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/AllocatePublicVirtualInterfaceCommand.ts index c6261f1dd8e48..8d9518a960c8d 100644 --- a/clients/client-direct-connect/commands/AllocatePublicVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/AllocatePublicVirtualInterfaceCommand.ts @@ -20,6 +20,14 @@ import { export type AllocatePublicVirtualInterfaceCommandInput = AllocatePublicVirtualInterfaceRequest; export type AllocatePublicVirtualInterfaceCommandOutput = VirtualInterface & __MetadataBearer; +/** + *

Provisions a public virtual interface to be owned by the specified AWS account.

+ *

The owner of a connection calls this function to provision a public virtual interface to be owned by the specified AWS account.

+ *

Virtual interfaces created using this function must be confirmed by the owner using ConfirmPublicVirtualInterface. + * Until this step has been completed, the virtual interface is in the confirming state and is not available to handle traffic.

+ *

When creating an IPv6 public virtual interface, omit the Amazon address and customer address. IPv6 addresses are automatically assigned from + * the Amazon pool of IPv6 addresses; you cannot specify custom IPv6 addresses.

+ */ export class AllocatePublicVirtualInterfaceCommand extends $Command< AllocatePublicVirtualInterfaceCommandInput, AllocatePublicVirtualInterfaceCommandOutput, @@ -34,6 +42,9 @@ export class AllocatePublicVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/AllocateTransitVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/AllocateTransitVirtualInterfaceCommand.ts index 770e527346053..3c610cda4d59b 100644 --- a/clients/client-direct-connect/commands/AllocateTransitVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/AllocateTransitVirtualInterfaceCommand.ts @@ -20,6 +20,11 @@ import { export type AllocateTransitVirtualInterfaceCommandInput = AllocateTransitVirtualInterfaceRequest; export type AllocateTransitVirtualInterfaceCommandOutput = AllocateTransitVirtualInterfaceResult & __MetadataBearer; +/** + *

Provisions a transit virtual interface to be owned by the specified AWS account. Use this type of interface to connect a transit gateway to your Direct Connect gateway.

+ *

The owner of a connection provisions a transit virtual interface to be owned by the specified AWS account.

+ *

After you create a transit virtual interface, it must be confirmed by the owner using ConfirmTransitVirtualInterface. Until this step has been completed, the transit virtual interface is in the requested state and is not available to handle traffic.

+ */ export class AllocateTransitVirtualInterfaceCommand extends $Command< AllocateTransitVirtualInterfaceCommandInput, AllocateTransitVirtualInterfaceCommandOutput, @@ -34,6 +39,9 @@ export class AllocateTransitVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/AssociateConnectionWithLagCommand.ts b/clients/client-direct-connect/commands/AssociateConnectionWithLagCommand.ts index ce7c00a2d0fc2..7967ba03fbfaa 100644 --- a/clients/client-direct-connect/commands/AssociateConnectionWithLagCommand.ts +++ b/clients/client-direct-connect/commands/AssociateConnectionWithLagCommand.ts @@ -20,6 +20,22 @@ import { export type AssociateConnectionWithLagCommandInput = AssociateConnectionWithLagRequest; export type AssociateConnectionWithLagCommandOutput = Connection & __MetadataBearer; +/** + *

Associates an existing connection with a link aggregation group (LAG). The connection + * is interrupted and re-established as a member of the LAG (connectivity to AWS is + * interrupted). The connection must be hosted on the same AWS Direct Connect endpoint as the LAG, and its + * bandwidth must match the bandwidth for the LAG. You can re-associate a connection that's + * currently associated with a different LAG; however, if removing the connection would cause + * the original LAG to fall below its setting for minimum number of operational connections, + * the request fails.

+ *

Any virtual interfaces that are directly associated with the connection are + * automatically re-associated with the LAG. If the connection was originally associated + * with a different LAG, the virtual interfaces remain associated with the original + * LAG.

+ *

For interconnects, any hosted connections are automatically re-associated with the + * LAG. If the interconnect was originally associated with a different LAG, the hosted + * connections remain associated with the original LAG.

+ */ export class AssociateConnectionWithLagCommand extends $Command< AssociateConnectionWithLagCommandInput, AssociateConnectionWithLagCommandOutput, @@ -34,6 +50,9 @@ export class AssociateConnectionWithLagCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/AssociateHostedConnectionCommand.ts b/clients/client-direct-connect/commands/AssociateHostedConnectionCommand.ts index ff07b59b28074..3e8ffb41a85f3 100644 --- a/clients/client-direct-connect/commands/AssociateHostedConnectionCommand.ts +++ b/clients/client-direct-connect/commands/AssociateHostedConnectionCommand.ts @@ -20,6 +20,16 @@ import { export type AssociateHostedConnectionCommandInput = AssociateHostedConnectionRequest; export type AssociateHostedConnectionCommandOutput = Connection & __MetadataBearer; +/** + *

Associates a hosted connection and its virtual interfaces with a link aggregation + * group (LAG) or interconnect. If the target interconnect or LAG has an existing hosted + * connection with a conflicting VLAN number or IP address, the operation fails. This + * action temporarily interrupts the hosted connection's connectivity to AWS as it is being + * migrated.

+ * + *

Intended for use by AWS Direct Connect Partners only.

+ *
+ */ export class AssociateHostedConnectionCommand extends $Command< AssociateHostedConnectionCommandInput, AssociateHostedConnectionCommandOutput, @@ -34,6 +44,9 @@ export class AssociateHostedConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/AssociateVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/AssociateVirtualInterfaceCommand.ts index ee1a6fd1384f9..89ef66644cad9 100644 --- a/clients/client-direct-connect/commands/AssociateVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/AssociateVirtualInterfaceCommand.ts @@ -20,6 +20,18 @@ import { export type AssociateVirtualInterfaceCommandInput = AssociateVirtualInterfaceRequest; export type AssociateVirtualInterfaceCommandOutput = VirtualInterface & __MetadataBearer; +/** + *

Associates a virtual interface with a specified link aggregation group (LAG) or + * connection. Connectivity to AWS is temporarily interrupted as the virtual interface is + * being migrated. If the target connection or LAG has an associated virtual interface with + * a conflicting VLAN number or a conflicting IP address, the operation fails.

+ *

Virtual interfaces associated with a hosted connection cannot be associated with a + * LAG; hosted connections must be migrated along with their virtual interfaces using AssociateHostedConnection.

+ *

To reassociate a virtual interface to a new connection or LAG, the requester + * must own either the virtual interface itself or the connection to which the virtual + * interface is currently associated. Additionally, the requester must own the connection + * or LAG for the association.

+ */ export class AssociateVirtualInterfaceCommand extends $Command< AssociateVirtualInterfaceCommandInput, AssociateVirtualInterfaceCommandOutput, @@ -34,6 +46,9 @@ export class AssociateVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/ConfirmConnectionCommand.ts b/clients/client-direct-connect/commands/ConfirmConnectionCommand.ts index ea81bc0d19ea5..a8dfde6e89189 100644 --- a/clients/client-direct-connect/commands/ConfirmConnectionCommand.ts +++ b/clients/client-direct-connect/commands/ConfirmConnectionCommand.ts @@ -20,6 +20,11 @@ import { export type ConfirmConnectionCommandInput = ConfirmConnectionRequest; export type ConfirmConnectionCommandOutput = ConfirmConnectionResponse & __MetadataBearer; +/** + *

Confirms the creation of the specified hosted connection on an interconnect.

+ *

Upon creation, the hosted connection is initially in the Ordering state, and + * remains in this state until the owner confirms creation of the hosted connection.

+ */ export class ConfirmConnectionCommand extends $Command< ConfirmConnectionCommandInput, ConfirmConnectionCommandOutput, @@ -34,6 +39,9 @@ export class ConfirmConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/ConfirmPrivateVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/ConfirmPrivateVirtualInterfaceCommand.ts index a5bcac59939aa..a68737b8c291a 100644 --- a/clients/client-direct-connect/commands/ConfirmPrivateVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/ConfirmPrivateVirtualInterfaceCommand.ts @@ -20,6 +20,12 @@ import { export type ConfirmPrivateVirtualInterfaceCommandInput = ConfirmPrivateVirtualInterfaceRequest; export type ConfirmPrivateVirtualInterfaceCommandOutput = ConfirmPrivateVirtualInterfaceResponse & __MetadataBearer; +/** + *

Accepts ownership of a private virtual interface created by another AWS account.

+ *

After the virtual interface owner makes this call, the virtual interface is + * created and attached to the specified virtual private gateway or Direct Connect gateway, and is + * made available to handle traffic.

+ */ export class ConfirmPrivateVirtualInterfaceCommand extends $Command< ConfirmPrivateVirtualInterfaceCommandInput, ConfirmPrivateVirtualInterfaceCommandOutput, @@ -34,6 +40,9 @@ export class ConfirmPrivateVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/ConfirmPublicVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/ConfirmPublicVirtualInterfaceCommand.ts index ceb478cc92025..7b610592b4d47 100644 --- a/clients/client-direct-connect/commands/ConfirmPublicVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/ConfirmPublicVirtualInterfaceCommand.ts @@ -20,6 +20,11 @@ import { export type ConfirmPublicVirtualInterfaceCommandInput = ConfirmPublicVirtualInterfaceRequest; export type ConfirmPublicVirtualInterfaceCommandOutput = ConfirmPublicVirtualInterfaceResponse & __MetadataBearer; +/** + *

Accepts ownership of a public virtual interface created by another AWS account.

+ *

After the virtual interface owner makes this call, the specified virtual interface is + * created and made available to handle traffic.

+ */ export class ConfirmPublicVirtualInterfaceCommand extends $Command< ConfirmPublicVirtualInterfaceCommandInput, ConfirmPublicVirtualInterfaceCommandOutput, @@ -34,6 +39,9 @@ export class ConfirmPublicVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/ConfirmTransitVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/ConfirmTransitVirtualInterfaceCommand.ts index 72878f59f74e6..d761d2189a5fe 100644 --- a/clients/client-direct-connect/commands/ConfirmTransitVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/ConfirmTransitVirtualInterfaceCommand.ts @@ -20,6 +20,11 @@ import { export type ConfirmTransitVirtualInterfaceCommandInput = ConfirmTransitVirtualInterfaceRequest; export type ConfirmTransitVirtualInterfaceCommandOutput = ConfirmTransitVirtualInterfaceResponse & __MetadataBearer; +/** + *

Accepts ownership of a transit virtual interface created by another AWS account.

+ * + *

After the owner of the transit virtual interface makes this call, the specified transit virtual interface is created and made available to handle traffic.

+ */ export class ConfirmTransitVirtualInterfaceCommand extends $Command< ConfirmTransitVirtualInterfaceCommandInput, ConfirmTransitVirtualInterfaceCommandOutput, @@ -34,6 +39,9 @@ export class ConfirmTransitVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreateBGPPeerCommand.ts b/clients/client-direct-connect/commands/CreateBGPPeerCommand.ts index e99cb3acae2e1..b1f857d244af3 100644 --- a/clients/client-direct-connect/commands/CreateBGPPeerCommand.ts +++ b/clients/client-direct-connect/commands/CreateBGPPeerCommand.ts @@ -20,6 +20,15 @@ import { export type CreateBGPPeerCommandInput = CreateBGPPeerRequest; export type CreateBGPPeerCommandOutput = CreateBGPPeerResponse & __MetadataBearer; +/** + *

Creates a BGP peer on the specified virtual interface.

+ *

You must create a BGP peer for the corresponding address family (IPv4/IPv6) in order to access AWS resources that also use that address family.

+ *

If logical redundancy is not supported by the connection, interconnect, or LAG, the BGP peer cannot + * be in the same address family as an existing BGP peer on the virtual interface.

+ *

When creating a IPv6 BGP peer, omit the Amazon address and customer address. IPv6 addresses are automatically assigned from + * the Amazon pool of IPv6 addresses; you cannot specify custom IPv6 addresses.

+ *

For a public virtual interface, the Autonomous System Number (ASN) must be private or already whitelisted for the virtual interface.

+ */ export class CreateBGPPeerCommand extends $Command< CreateBGPPeerCommandInput, CreateBGPPeerCommandOutput, @@ -34,6 +43,9 @@ export class CreateBGPPeerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreateConnectionCommand.ts b/clients/client-direct-connect/commands/CreateConnectionCommand.ts index 773f4f8e16ebb..fd1e75bbe9d69 100644 --- a/clients/client-direct-connect/commands/CreateConnectionCommand.ts +++ b/clients/client-direct-connect/commands/CreateConnectionCommand.ts @@ -20,6 +20,17 @@ import { export type CreateConnectionCommandInput = CreateConnectionRequest; export type CreateConnectionCommandOutput = Connection & __MetadataBearer; +/** + *

Creates a connection between a customer network and a specific AWS Direct Connect location.

+ * + *

A connection links your internal network to an AWS Direct Connect location over a standard Ethernet fiber-optic + * cable. One end of the cable is connected to your router, the other to an AWS Direct Connect router.

+ *

To find the locations for your Region, use DescribeLocations.

+ *

You can automatically add the new connection to a link aggregation group (LAG) by + * specifying a LAG ID in the request. This ensures that the new connection is allocated on the + * same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the endpoint, + * the request fails and no connection is created.

+ */ export class CreateConnectionCommand extends $Command< CreateConnectionCommandInput, CreateConnectionCommandOutput, @@ -34,6 +45,9 @@ export class CreateConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreateDirectConnectGatewayAssociationCommand.ts b/clients/client-direct-connect/commands/CreateDirectConnectGatewayAssociationCommand.ts index 4104e278aa230..7ee54016905e0 100644 --- a/clients/client-direct-connect/commands/CreateDirectConnectGatewayAssociationCommand.ts +++ b/clients/client-direct-connect/commands/CreateDirectConnectGatewayAssociationCommand.ts @@ -24,6 +24,10 @@ export type CreateDirectConnectGatewayAssociationCommandInput = CreateDirectConn export type CreateDirectConnectGatewayAssociationCommandOutput = CreateDirectConnectGatewayAssociationResult & __MetadataBearer; +/** + *

Creates an association between a Direct Connect gateway and a virtual private gateway. The virtual + * private gateway must be attached to a VPC and must not be associated with another Direct Connect gateway.

+ */ export class CreateDirectConnectGatewayAssociationCommand extends $Command< CreateDirectConnectGatewayAssociationCommandInput, CreateDirectConnectGatewayAssociationCommandOutput, @@ -38,6 +42,9 @@ export class CreateDirectConnectGatewayAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreateDirectConnectGatewayAssociationProposalCommand.ts b/clients/client-direct-connect/commands/CreateDirectConnectGatewayAssociationProposalCommand.ts index 6e45ef6538e21..441d5117ceae1 100644 --- a/clients/client-direct-connect/commands/CreateDirectConnectGatewayAssociationProposalCommand.ts +++ b/clients/client-direct-connect/commands/CreateDirectConnectGatewayAssociationProposalCommand.ts @@ -24,6 +24,10 @@ export type CreateDirectConnectGatewayAssociationProposalCommandInput = CreateDi export type CreateDirectConnectGatewayAssociationProposalCommandOutput = CreateDirectConnectGatewayAssociationProposalResult & __MetadataBearer; +/** + *

Creates a proposal to associate the specified virtual private gateway or transit gateway with the specified Direct Connect gateway.

+ *

You can associate a Direct Connect gateway and virtual private gateway or transit gateway that is owned by any AWS account.

+ */ export class CreateDirectConnectGatewayAssociationProposalCommand extends $Command< CreateDirectConnectGatewayAssociationProposalCommandInput, CreateDirectConnectGatewayAssociationProposalCommandOutput, @@ -38,6 +42,9 @@ export class CreateDirectConnectGatewayAssociationProposalCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreateDirectConnectGatewayCommand.ts b/clients/client-direct-connect/commands/CreateDirectConnectGatewayCommand.ts index bde4c7a8a9adc..cb2ab58315acd 100644 --- a/clients/client-direct-connect/commands/CreateDirectConnectGatewayCommand.ts +++ b/clients/client-direct-connect/commands/CreateDirectConnectGatewayCommand.ts @@ -20,6 +20,14 @@ import { export type CreateDirectConnectGatewayCommandInput = CreateDirectConnectGatewayRequest; export type CreateDirectConnectGatewayCommandOutput = CreateDirectConnectGatewayResult & __MetadataBearer; +/** + *

Creates a Direct Connect gateway, which is an intermediate object that enables you to connect a set + * of virtual interfaces and virtual private gateways. A Direct Connect gateway is global and visible in any + * AWS Region after it is created. The virtual interfaces and virtual private gateways that + * are connected through a Direct Connect gateway can be in different AWS Regions. This enables you to + * connect to a VPC in any Region, regardless of the Region in which the virtual interfaces + * are located, and pass traffic between them.

+ */ export class CreateDirectConnectGatewayCommand extends $Command< CreateDirectConnectGatewayCommandInput, CreateDirectConnectGatewayCommandOutput, @@ -34,6 +42,9 @@ export class CreateDirectConnectGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreateInterconnectCommand.ts b/clients/client-direct-connect/commands/CreateInterconnectCommand.ts index 8950286a9f791..f9dc3379c5eec 100644 --- a/clients/client-direct-connect/commands/CreateInterconnectCommand.ts +++ b/clients/client-direct-connect/commands/CreateInterconnectCommand.ts @@ -20,6 +20,24 @@ import { export type CreateInterconnectCommandInput = CreateInterconnectRequest; export type CreateInterconnectCommandOutput = Interconnect & __MetadataBearer; +/** + *

Creates an interconnect between an AWS Direct Connect Partner's network and a specific AWS Direct Connect location.

+ *

An interconnect is a connection that is capable of hosting other connections. The AWS + * Direct Connect partner can use an interconnect to provide AWS Direct Connect hosted + * connections to customers through their own network services. Like a standard connection, an + * interconnect links the partner's network to an AWS Direct Connect location over a standard Ethernet + * fiber-optic cable. One end is connected to the partner's router, the other to an AWS Direct Connect + * router.

+ *

You can automatically add the new interconnect to a link aggregation group (LAG) by + * specifying a LAG ID in the request. This ensures that the new interconnect is allocated on + * the same AWS Direct Connect endpoint that hosts the specified LAG. If there are no available ports on the + * endpoint, the request fails and no interconnect is created.

+ *

For each end customer, the AWS Direct Connect Partner provisions a connection on their interconnect by calling AllocateHostedConnection. + * The end customer can then connect to AWS resources by creating a virtual interface on their connection, using the VLAN assigned to them by the AWS Direct Connect Partner.

+ * + *

Intended for use by AWS Direct Connect Partners only.

+ *
+ */ export class CreateInterconnectCommand extends $Command< CreateInterconnectCommandInput, CreateInterconnectCommandOutput, @@ -34,6 +52,9 @@ export class CreateInterconnectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreateLagCommand.ts b/clients/client-direct-connect/commands/CreateLagCommand.ts index 5a80ada915803..6992ed59da4ea 100644 --- a/clients/client-direct-connect/commands/CreateLagCommand.ts +++ b/clients/client-direct-connect/commands/CreateLagCommand.ts @@ -17,6 +17,26 @@ import { export type CreateLagCommandInput = CreateLagRequest; export type CreateLagCommandOutput = Lag & __MetadataBearer; +/** + *

Creates a link aggregation group (LAG) with the specified number of bundled + * physical dedicated connections between the customer network and a specific AWS Direct Connect location. + * A LAG is a logical interface that uses the Link Aggregation Control Protocol + * (LACP) to aggregate multiple interfaces, enabling you to treat them as a single + * interface.

+ *

All connections in a LAG must use the same bandwidth (either 1Gbps or 10Gbps) and must terminate at the same AWS Direct Connect endpoint.

+ *

You can have up to 10 dedicated connections per LAG. Regardless of this limit, if you + * request more connections for the LAG than AWS Direct Connect can allocate on a single endpoint, no LAG is + * created.

+ *

You can specify an existing physical dedicated connection or interconnect to include in + * the LAG (which counts towards the total number of connections). Doing so interrupts the + * current physical dedicated connection, and re-establishes them as a member of the LAG. The LAG + * will be created on the same AWS Direct Connect endpoint to which the dedicated connection terminates. Any + * virtual interfaces associated with the dedicated connection are automatically disassociated + * and re-associated with the LAG. The connection ID does not change.

+ *

If the AWS account used to create a LAG is a registered AWS Direct Connect Partner, the LAG is + * automatically enabled to host sub-connections. For a LAG owned by a partner, any associated virtual + * interfaces cannot be directly configured.

+ */ export class CreateLagCommand extends $Command< CreateLagCommandInput, CreateLagCommandOutput, @@ -31,6 +51,9 @@ export class CreateLagCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreatePrivateVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/CreatePrivateVirtualInterfaceCommand.ts index f4bf54698d2c2..23d8096553a22 100644 --- a/clients/client-direct-connect/commands/CreatePrivateVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/CreatePrivateVirtualInterfaceCommand.ts @@ -20,6 +20,19 @@ import { export type CreatePrivateVirtualInterfaceCommandInput = CreatePrivateVirtualInterfaceRequest; export type CreatePrivateVirtualInterfaceCommandOutput = VirtualInterface & __MetadataBearer; +/** + *

Creates a private virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. + * A private virtual interface can be connected to either a Direct Connect gateway or a Virtual Private Gateway (VGW). + * Connecting the private virtual interface to a Direct Connect gateway enables the possibility for connecting to multiple + * VPCs, including VPCs in different AWS Regions. Connecting the private virtual interface to a VGW only + * provides access to a single VPC within the same Region.

+ *

Setting the MTU of a virtual interface to 9001 (jumbo frames) can cause an update to + * the underlying physical connection if it wasn't updated to support jumbo frames. Updating + * the connection disrupts network connectivity for all virtual interfaces associated with + * the connection for up to 30 seconds. To check whether your connection supports jumbo + * frames, call DescribeConnections. To check whether your virtual + * interface supports jumbo frames, call DescribeVirtualInterfaces.

+ */ export class CreatePrivateVirtualInterfaceCommand extends $Command< CreatePrivateVirtualInterfaceCommandInput, CreatePrivateVirtualInterfaceCommandOutput, @@ -34,6 +47,9 @@ export class CreatePrivateVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreatePublicVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/CreatePublicVirtualInterfaceCommand.ts index 112aea7b7a26c..f836494abcc47 100644 --- a/clients/client-direct-connect/commands/CreatePublicVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/CreatePublicVirtualInterfaceCommand.ts @@ -20,6 +20,12 @@ import { export type CreatePublicVirtualInterfaceCommandInput = CreatePublicVirtualInterfaceRequest; export type CreatePublicVirtualInterfaceCommandOutput = VirtualInterface & __MetadataBearer; +/** + *

Creates a public virtual interface. A virtual interface is the VLAN that transports AWS Direct Connect traffic. + * A public virtual interface supports sending traffic to public services of AWS such as Amazon S3.

+ *

When creating an IPv6 public virtual interface (addressFamily is ipv6), leave the customer + * and amazon address fields blank to use auto-assigned IPv6 space. Custom IPv6 addresses are not supported.

+ */ export class CreatePublicVirtualInterfaceCommand extends $Command< CreatePublicVirtualInterfaceCommandInput, CreatePublicVirtualInterfaceCommandOutput, @@ -34,6 +40,9 @@ export class CreatePublicVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/CreateTransitVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/CreateTransitVirtualInterfaceCommand.ts index d641aa2628ea9..d83c8823b0865 100644 --- a/clients/client-direct-connect/commands/CreateTransitVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/CreateTransitVirtualInterfaceCommand.ts @@ -20,6 +20,18 @@ import { export type CreateTransitVirtualInterfaceCommandInput = CreateTransitVirtualInterfaceRequest; export type CreateTransitVirtualInterfaceCommandOutput = CreateTransitVirtualInterfaceResult & __MetadataBearer; +/** + *

Creates a transit virtual interface. A transit virtual interface should be used to access one or more transit gateways associated with Direct Connect gateways. A transit virtual interface enables the connection of multiple VPCs attached to a transit gateway to a Direct Connect gateway.

+ * + *

If you associate your transit gateway with one or more Direct Connect gateways, the Autonomous System Number (ASN) used by the transit gateway and the Direct Connect gateway must be different. For example, if you use the default ASN 64512 for both your the transit gateway and Direct Connect gateway, the association request fails.

+ *
+ *

Setting the MTU of a virtual interface to 8500 (jumbo frames) can cause an update to + * the underlying physical connection if it wasn't updated to support jumbo frames. Updating + * the connection disrupts network connectivity for all virtual interfaces associated with + * the connection for up to 30 seconds. To check whether your connection supports jumbo + * frames, call DescribeConnections. To check whether your virtual + * interface supports jumbo frames, call DescribeVirtualInterfaces.

+ */ export class CreateTransitVirtualInterfaceCommand extends $Command< CreateTransitVirtualInterfaceCommandInput, CreateTransitVirtualInterfaceCommandOutput, @@ -34,6 +46,9 @@ export class CreateTransitVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DeleteBGPPeerCommand.ts b/clients/client-direct-connect/commands/DeleteBGPPeerCommand.ts index d219902469b29..65edee7af7c15 100644 --- a/clients/client-direct-connect/commands/DeleteBGPPeerCommand.ts +++ b/clients/client-direct-connect/commands/DeleteBGPPeerCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteBGPPeerCommandInput = DeleteBGPPeerRequest; export type DeleteBGPPeerCommandOutput = DeleteBGPPeerResponse & __MetadataBearer; +/** + *

Deletes the specified BGP peer on the specified virtual interface with the specified customer address and ASN.

+ *

You cannot delete the last BGP peer from a virtual interface.

+ */ export class DeleteBGPPeerCommand extends $Command< DeleteBGPPeerCommandInput, DeleteBGPPeerCommandOutput, @@ -34,6 +38,9 @@ export class DeleteBGPPeerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DeleteConnectionCommand.ts b/clients/client-direct-connect/commands/DeleteConnectionCommand.ts index bfdcfdabb437c..fdb3152695643 100644 --- a/clients/client-direct-connect/commands/DeleteConnectionCommand.ts +++ b/clients/client-direct-connect/commands/DeleteConnectionCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteConnectionCommandInput = DeleteConnectionRequest; export type DeleteConnectionCommandOutput = Connection & __MetadataBearer; +/** + *

Deletes the specified connection.

+ *

Deleting a connection only stops the AWS Direct Connect port hour and data transfer charges. + * If you are partnering with any third parties to connect with the AWS Direct Connect location, + * you must cancel your service with them separately.

+ */ export class DeleteConnectionCommand extends $Command< DeleteConnectionCommandInput, DeleteConnectionCommandOutput, @@ -34,6 +40,9 @@ export class DeleteConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DeleteDirectConnectGatewayAssociationCommand.ts b/clients/client-direct-connect/commands/DeleteDirectConnectGatewayAssociationCommand.ts index 4c13ca7450ab2..f7cdbf8c1b8eb 100644 --- a/clients/client-direct-connect/commands/DeleteDirectConnectGatewayAssociationCommand.ts +++ b/clients/client-direct-connect/commands/DeleteDirectConnectGatewayAssociationCommand.ts @@ -24,6 +24,10 @@ export type DeleteDirectConnectGatewayAssociationCommandInput = DeleteDirectConn export type DeleteDirectConnectGatewayAssociationCommandOutput = DeleteDirectConnectGatewayAssociationResult & __MetadataBearer; +/** + *

Deletes the association between the specified Direct Connect gateway and virtual private gateway.

+ *

We recommend that you specify the associationID to delete the association. Alternatively, if you own virtual gateway and a Direct Connect gateway association, you can specify the virtualGatewayId and directConnectGatewayId to delete an association.

+ */ export class DeleteDirectConnectGatewayAssociationCommand extends $Command< DeleteDirectConnectGatewayAssociationCommandInput, DeleteDirectConnectGatewayAssociationCommandOutput, @@ -38,6 +42,9 @@ export class DeleteDirectConnectGatewayAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DeleteDirectConnectGatewayAssociationProposalCommand.ts b/clients/client-direct-connect/commands/DeleteDirectConnectGatewayAssociationProposalCommand.ts index 220e6f4a91ef3..a266f7108a64c 100644 --- a/clients/client-direct-connect/commands/DeleteDirectConnectGatewayAssociationProposalCommand.ts +++ b/clients/client-direct-connect/commands/DeleteDirectConnectGatewayAssociationProposalCommand.ts @@ -24,6 +24,9 @@ export type DeleteDirectConnectGatewayAssociationProposalCommandInput = DeleteDi export type DeleteDirectConnectGatewayAssociationProposalCommandOutput = DeleteDirectConnectGatewayAssociationProposalResult & __MetadataBearer; +/** + *

Deletes the association proposal request between the specified Direct Connect gateway and virtual private gateway or transit gateway.

+ */ export class DeleteDirectConnectGatewayAssociationProposalCommand extends $Command< DeleteDirectConnectGatewayAssociationProposalCommandInput, DeleteDirectConnectGatewayAssociationProposalCommandOutput, @@ -38,6 +41,9 @@ export class DeleteDirectConnectGatewayAssociationProposalCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DeleteDirectConnectGatewayCommand.ts b/clients/client-direct-connect/commands/DeleteDirectConnectGatewayCommand.ts index f5e6811583a7a..0f141c930780c 100644 --- a/clients/client-direct-connect/commands/DeleteDirectConnectGatewayCommand.ts +++ b/clients/client-direct-connect/commands/DeleteDirectConnectGatewayCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDirectConnectGatewayCommandInput = DeleteDirectConnectGatewayRequest; export type DeleteDirectConnectGatewayCommandOutput = DeleteDirectConnectGatewayResult & __MetadataBearer; +/** + *

Deletes the specified Direct Connect gateway. You must first delete all virtual interfaces that are + * attached to the Direct Connect gateway and disassociate all virtual private gateways associated + * with the Direct Connect gateway.

+ */ export class DeleteDirectConnectGatewayCommand extends $Command< DeleteDirectConnectGatewayCommandInput, DeleteDirectConnectGatewayCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDirectConnectGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DeleteInterconnectCommand.ts b/clients/client-direct-connect/commands/DeleteInterconnectCommand.ts index 282ac622e7097..334e77f54cea2 100644 --- a/clients/client-direct-connect/commands/DeleteInterconnectCommand.ts +++ b/clients/client-direct-connect/commands/DeleteInterconnectCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteInterconnectCommandInput = DeleteInterconnectRequest; export type DeleteInterconnectCommandOutput = DeleteInterconnectResponse & __MetadataBearer; +/** + *

Deletes the specified interconnect.

+ * + *

Intended for use + * by AWS Direct Connect Partners only.

+ *
+ */ export class DeleteInterconnectCommand extends $Command< DeleteInterconnectCommandInput, DeleteInterconnectCommandOutput, @@ -34,6 +41,9 @@ export class DeleteInterconnectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DeleteLagCommand.ts b/clients/client-direct-connect/commands/DeleteLagCommand.ts index 01d660d031d12..f5143da55d828 100644 --- a/clients/client-direct-connect/commands/DeleteLagCommand.ts +++ b/clients/client-direct-connect/commands/DeleteLagCommand.ts @@ -17,6 +17,10 @@ import { export type DeleteLagCommandInput = DeleteLagRequest; export type DeleteLagCommandOutput = Lag & __MetadataBearer; +/** + *

Deletes the specified link aggregation group (LAG). You cannot delete a LAG if it has active + * virtual interfaces or hosted connections.

+ */ export class DeleteLagCommand extends $Command< DeleteLagCommandInput, DeleteLagCommandOutput, @@ -31,6 +35,9 @@ export class DeleteLagCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DeleteVirtualInterfaceCommand.ts b/clients/client-direct-connect/commands/DeleteVirtualInterfaceCommand.ts index 8b0dde776f794..fee5e64040bbd 100644 --- a/clients/client-direct-connect/commands/DeleteVirtualInterfaceCommand.ts +++ b/clients/client-direct-connect/commands/DeleteVirtualInterfaceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVirtualInterfaceCommandInput = DeleteVirtualInterfaceRequest; export type DeleteVirtualInterfaceCommandOutput = DeleteVirtualInterfaceResponse & __MetadataBearer; +/** + *

Deletes a virtual interface.

+ */ export class DeleteVirtualInterfaceCommand extends $Command< DeleteVirtualInterfaceCommandInput, DeleteVirtualInterfaceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVirtualInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeConnectionLoaCommand.ts b/clients/client-direct-connect/commands/DescribeConnectionLoaCommand.ts index 5b4d379e9cd1a..7ca04f044fca7 100644 --- a/clients/client-direct-connect/commands/DescribeConnectionLoaCommand.ts +++ b/clients/client-direct-connect/commands/DescribeConnectionLoaCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeConnectionLoaCommandInput = DescribeConnectionLoaRequest; export type DescribeConnectionLoaCommandOutput = DescribeConnectionLoaResponse & __MetadataBearer; +/** + *

Deprecated. Use DescribeLoa instead.

+ *

Gets the LOA-CFA for a connection.

+ *

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that your APN partner or + * service provider uses when establishing your cross connect to AWS at the colocation facility. For more information, + * see Requesting Cross Connects + * at AWS Direct Connect Locations in the AWS Direct Connect User Guide.

+ */ export class DescribeConnectionLoaCommand extends $Command< DescribeConnectionLoaCommandInput, DescribeConnectionLoaCommandOutput, @@ -34,6 +42,9 @@ export class DescribeConnectionLoaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeConnectionsCommand.ts b/clients/client-direct-connect/commands/DescribeConnectionsCommand.ts index 12d60920774af..5f386ec6df25e 100644 --- a/clients/client-direct-connect/commands/DescribeConnectionsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeConnectionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeConnectionsCommandInput = DescribeConnectionsRequest; export type DescribeConnectionsCommandOutput = Connections & __MetadataBearer; +/** + *

Displays the specified connection or all connections in this Region.

+ */ export class DescribeConnectionsCommand extends $Command< DescribeConnectionsCommandInput, DescribeConnectionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeConnectionsOnInterconnectCommand.ts b/clients/client-direct-connect/commands/DescribeConnectionsOnInterconnectCommand.ts index c14adc6cc7f1d..b68a09c2c1ea4 100644 --- a/clients/client-direct-connect/commands/DescribeConnectionsOnInterconnectCommand.ts +++ b/clients/client-direct-connect/commands/DescribeConnectionsOnInterconnectCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeConnectionsOnInterconnectCommandInput = DescribeConnectionsOnInterconnectRequest; export type DescribeConnectionsOnInterconnectCommandOutput = Connections & __MetadataBearer; +/** + *

Deprecated. Use DescribeHostedConnections instead.

+ *

Lists the connections that have been provisioned on the specified interconnect.

+ * + *

Intended for use by AWS Direct Connect Partners only.

+ *
+ */ export class DescribeConnectionsOnInterconnectCommand extends $Command< DescribeConnectionsOnInterconnectCommandInput, DescribeConnectionsOnInterconnectCommandOutput, @@ -34,6 +41,9 @@ export class DescribeConnectionsOnInterconnectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAssociationProposalsCommand.ts b/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAssociationProposalsCommand.ts index 481e30a8719e6..e7268d2a87e40 100644 --- a/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAssociationProposalsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAssociationProposalsCommand.ts @@ -24,6 +24,9 @@ export type DescribeDirectConnectGatewayAssociationProposalsCommandInput = Descr export type DescribeDirectConnectGatewayAssociationProposalsCommandOutput = DescribeDirectConnectGatewayAssociationProposalsResult & __MetadataBearer; +/** + *

Describes one or more association proposals for connection between a virtual private gateway or transit gateway and a Direct Connect gateway.

+ */ export class DescribeDirectConnectGatewayAssociationProposalsCommand extends $Command< DescribeDirectConnectGatewayAssociationProposalsCommandInput, DescribeDirectConnectGatewayAssociationProposalsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeDirectConnectGatewayAssociationProposalsCommand extends $Co // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAssociationsCommand.ts b/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAssociationsCommand.ts index e57d66c125215..8ce9f07d3fd48 100644 --- a/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAssociationsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAssociationsCommand.ts @@ -24,6 +24,15 @@ export type DescribeDirectConnectGatewayAssociationsCommandInput = DescribeDirec export type DescribeDirectConnectGatewayAssociationsCommandOutput = DescribeDirectConnectGatewayAssociationsResult & __MetadataBearer; +/** + *

Lists the associations between your Direct Connect gateways and virtual private gateways. + * You must specify a Direct Connect gateway, a virtual private gateway, or both. If you specify + * a Direct Connect gateway, the response contains all virtual private gateways associated with + * the Direct Connect gateway. If you specify a virtual private gateway, the response contains + * all Direct Connect gateways associated with the virtual private gateway. If you specify both, + * the response contains the association between the Direct Connect gateway and the virtual + * private gateway.

+ */ export class DescribeDirectConnectGatewayAssociationsCommand extends $Command< DescribeDirectConnectGatewayAssociationsCommandInput, DescribeDirectConnectGatewayAssociationsCommandOutput, @@ -38,6 +47,9 @@ export class DescribeDirectConnectGatewayAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAttachmentsCommand.ts b/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAttachmentsCommand.ts index e9cbc32240f9a..54c15311db68d 100644 --- a/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAttachmentsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeDirectConnectGatewayAttachmentsCommand.ts @@ -24,6 +24,13 @@ export type DescribeDirectConnectGatewayAttachmentsCommandInput = DescribeDirect export type DescribeDirectConnectGatewayAttachmentsCommandOutput = DescribeDirectConnectGatewayAttachmentsResult & __MetadataBearer; +/** + *

Lists the attachments between your Direct Connect gateways and virtual interfaces. You must specify + * a Direct Connect gateway, a virtual interface, or both. If you specify a Direct Connect gateway, the response contains + * all virtual interfaces attached to the Direct Connect gateway. If you specify a virtual interface, the + * response contains all Direct Connect gateways attached to the virtual interface. If you specify both, + * the response contains the attachment between the Direct Connect gateway and the virtual interface.

+ */ export class DescribeDirectConnectGatewayAttachmentsCommand extends $Command< DescribeDirectConnectGatewayAttachmentsCommandInput, DescribeDirectConnectGatewayAttachmentsCommandOutput, @@ -38,6 +45,9 @@ export class DescribeDirectConnectGatewayAttachmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeDirectConnectGatewaysCommand.ts b/clients/client-direct-connect/commands/DescribeDirectConnectGatewaysCommand.ts index 3b8c19c535ec9..f6b77a67cf60f 100644 --- a/clients/client-direct-connect/commands/DescribeDirectConnectGatewaysCommand.ts +++ b/clients/client-direct-connect/commands/DescribeDirectConnectGatewaysCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDirectConnectGatewaysCommandInput = DescribeDirectConnectGatewaysRequest; export type DescribeDirectConnectGatewaysCommandOutput = DescribeDirectConnectGatewaysResult & __MetadataBearer; +/** + *

Lists all your Direct Connect gateways or only the specified Direct Connect gateway. Deleted Direct Connect gateways are not returned.

+ */ export class DescribeDirectConnectGatewaysCommand extends $Command< DescribeDirectConnectGatewaysCommandInput, DescribeDirectConnectGatewaysCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDirectConnectGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeHostedConnectionsCommand.ts b/clients/client-direct-connect/commands/DescribeHostedConnectionsCommand.ts index a0b99919ff7bb..2f3f5084bd7c4 100644 --- a/clients/client-direct-connect/commands/DescribeHostedConnectionsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeHostedConnectionsCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeHostedConnectionsCommandInput = DescribeHostedConnectionsRequest; export type DescribeHostedConnectionsCommandOutput = Connections & __MetadataBearer; +/** + *

Lists the hosted connections that have been provisioned on the specified + * interconnect or link aggregation group (LAG).

+ * + *

Intended for use by AWS Direct Connect Partners only.

+ *
+ */ export class DescribeHostedConnectionsCommand extends $Command< DescribeHostedConnectionsCommandInput, DescribeHostedConnectionsCommandOutput, @@ -34,6 +41,9 @@ export class DescribeHostedConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeInterconnectLoaCommand.ts b/clients/client-direct-connect/commands/DescribeInterconnectLoaCommand.ts index 5f15434576bc6..7110ef9993ee4 100644 --- a/clients/client-direct-connect/commands/DescribeInterconnectLoaCommand.ts +++ b/clients/client-direct-connect/commands/DescribeInterconnectLoaCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeInterconnectLoaCommandInput = DescribeInterconnectLoaRequest; export type DescribeInterconnectLoaCommandOutput = DescribeInterconnectLoaResponse & __MetadataBearer; +/** + *

Deprecated. Use DescribeLoa instead.

+ *

Gets the LOA-CFA for the specified interconnect.

+ *

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing your cross connect to AWS at the colocation facility. + * For more information, see Requesting Cross Connects at AWS Direct Connect Locations + * in the AWS Direct Connect User Guide.

+ */ export class DescribeInterconnectLoaCommand extends $Command< DescribeInterconnectLoaCommandInput, DescribeInterconnectLoaCommandOutput, @@ -34,6 +41,9 @@ export class DescribeInterconnectLoaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeInterconnectsCommand.ts b/clients/client-direct-connect/commands/DescribeInterconnectsCommand.ts index df0b53c579534..92ab94ba40f9f 100644 --- a/clients/client-direct-connect/commands/DescribeInterconnectsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeInterconnectsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInterconnectsCommandInput = DescribeInterconnectsRequest; export type DescribeInterconnectsCommandOutput = Interconnects & __MetadataBearer; +/** + *

Lists the interconnects owned by the AWS account or only the specified interconnect.

+ */ export class DescribeInterconnectsCommand extends $Command< DescribeInterconnectsCommandInput, DescribeInterconnectsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInterconnectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeLagsCommand.ts b/clients/client-direct-connect/commands/DescribeLagsCommand.ts index be1c0057d0cbe..da3d0b77092f3 100644 --- a/clients/client-direct-connect/commands/DescribeLagsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeLagsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLagsCommandInput = DescribeLagsRequest; export type DescribeLagsCommandOutput = Lags & __MetadataBearer; +/** + *

Describes all your link aggregation groups (LAG) or the specified LAG.

+ */ export class DescribeLagsCommand extends $Command< DescribeLagsCommandInput, DescribeLagsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeLoaCommand.ts b/clients/client-direct-connect/commands/DescribeLoaCommand.ts index ba04c8b8da8ac..22af89c0baa51 100644 --- a/clients/client-direct-connect/commands/DescribeLoaCommand.ts +++ b/clients/client-direct-connect/commands/DescribeLoaCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeLoaCommandInput = DescribeLoaRequest; export type DescribeLoaCommandOutput = Loa & __MetadataBearer; +/** + *

Gets the LOA-CFA for a connection, interconnect, or link aggregation group (LAG).

+ *

The Letter of Authorization - Connecting Facility Assignment (LOA-CFA) is a document that is used when establishing + * your cross connect to AWS at the colocation facility. For more information, see Requesting Cross Connects at AWS Direct Connect Locations + * in the AWS Direct Connect User Guide.

+ */ export class DescribeLoaCommand extends $Command< DescribeLoaCommandInput, DescribeLoaCommandOutput, @@ -34,6 +40,9 @@ export class DescribeLoaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeLocationsCommand.ts b/clients/client-direct-connect/commands/DescribeLocationsCommand.ts index a6612962f510e..0a3223a8bdedc 100644 --- a/clients/client-direct-connect/commands/DescribeLocationsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeLocationsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeLocationsCommandInput = {}; export type DescribeLocationsCommandOutput = Locations & __MetadataBearer; +/** + *

Lists the AWS Direct Connect locations in the current AWS Region. These are the locations that can be selected when calling + * CreateConnection or CreateInterconnect.

+ */ export class DescribeLocationsCommand extends $Command< DescribeLocationsCommandInput, DescribeLocationsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeLocationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeTagsCommand.ts b/clients/client-direct-connect/commands/DescribeTagsCommand.ts index 4010342850b9f..ccd546a065102 100644 --- a/clients/client-direct-connect/commands/DescribeTagsCommand.ts +++ b/clients/client-direct-connect/commands/DescribeTagsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTagsCommandInput = DescribeTagsRequest; export type DescribeTagsCommandOutput = DescribeTagsResponse & __MetadataBearer; +/** + *

Describes the tags associated with the specified AWS Direct Connect resources.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeVirtualGatewaysCommand.ts b/clients/client-direct-connect/commands/DescribeVirtualGatewaysCommand.ts index 52eca7d520ab9..5e1b51bb26ae6 100644 --- a/clients/client-direct-connect/commands/DescribeVirtualGatewaysCommand.ts +++ b/clients/client-direct-connect/commands/DescribeVirtualGatewaysCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeVirtualGatewaysCommandInput = {}; export type DescribeVirtualGatewaysCommandOutput = VirtualGateways & __MetadataBearer; +/** + *

Lists the virtual private gateways owned by the AWS account.

+ *

You can create one or more AWS Direct Connect private virtual interfaces linked to a virtual private gateway.

+ */ export class DescribeVirtualGatewaysCommand extends $Command< DescribeVirtualGatewaysCommandInput, DescribeVirtualGatewaysCommandOutput, @@ -34,6 +38,9 @@ export class DescribeVirtualGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DescribeVirtualInterfacesCommand.ts b/clients/client-direct-connect/commands/DescribeVirtualInterfacesCommand.ts index 9b33e0fdf0b31..a57bea8115dec 100644 --- a/clients/client-direct-connect/commands/DescribeVirtualInterfacesCommand.ts +++ b/clients/client-direct-connect/commands/DescribeVirtualInterfacesCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeVirtualInterfacesCommandInput = DescribeVirtualInterfacesRequest; export type DescribeVirtualInterfacesCommandOutput = VirtualInterfaces & __MetadataBearer; +/** + *

Displays all virtual interfaces for an AWS account. Virtual interfaces deleted fewer + * than 15 minutes before you make the request are also returned. If you specify a + * connection ID, only the virtual interfaces associated with the connection are returned. + * If you specify a virtual interface ID, then only a single virtual interface is returned.

+ *

A virtual interface (VLAN) transmits the traffic between the AWS Direct Connect location and the customer network.

+ */ export class DescribeVirtualInterfacesCommand extends $Command< DescribeVirtualInterfacesCommandInput, DescribeVirtualInterfacesCommandOutput, @@ -34,6 +41,9 @@ export class DescribeVirtualInterfacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/DisassociateConnectionFromLagCommand.ts b/clients/client-direct-connect/commands/DisassociateConnectionFromLagCommand.ts index 5541f7648ce9c..7ed35943c6fc1 100644 --- a/clients/client-direct-connect/commands/DisassociateConnectionFromLagCommand.ts +++ b/clients/client-direct-connect/commands/DisassociateConnectionFromLagCommand.ts @@ -20,6 +20,18 @@ import { export type DisassociateConnectionFromLagCommandInput = DisassociateConnectionFromLagRequest; export type DisassociateConnectionFromLagCommandOutput = Connection & __MetadataBearer; +/** + *

Disassociates a connection from a link aggregation group (LAG). The connection is + * interrupted and re-established as a standalone connection (the connection is not + * deleted; to delete the connection, use the DeleteConnection request). + * If the LAG has associated virtual interfaces or hosted connections, they remain + * associated with the LAG. A disassociated connection owned by an AWS Direct Connect Partner is + * automatically converted to an interconnect.

+ *

If disassociating the connection would cause the LAG to fall below its setting for + * minimum number of operational connections, the request fails, except when it's the last + * member of the LAG. If all connections are disassociated, the LAG continues to exist as + * an empty LAG with no physical connections.

+ */ export class DisassociateConnectionFromLagCommand extends $Command< DisassociateConnectionFromLagCommandInput, DisassociateConnectionFromLagCommandOutput, @@ -34,6 +46,9 @@ export class DisassociateConnectionFromLagCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/ListVirtualInterfaceTestHistoryCommand.ts b/clients/client-direct-connect/commands/ListVirtualInterfaceTestHistoryCommand.ts index e0fca5679db7c..88d350ea8077a 100644 --- a/clients/client-direct-connect/commands/ListVirtualInterfaceTestHistoryCommand.ts +++ b/clients/client-direct-connect/commands/ListVirtualInterfaceTestHistoryCommand.ts @@ -20,6 +20,9 @@ import { export type ListVirtualInterfaceTestHistoryCommandInput = ListVirtualInterfaceTestHistoryRequest; export type ListVirtualInterfaceTestHistoryCommandOutput = ListVirtualInterfaceTestHistoryResponse & __MetadataBearer; +/** + *

Lists the virtual interface failover test history.

+ */ export class ListVirtualInterfaceTestHistoryCommand extends $Command< ListVirtualInterfaceTestHistoryCommandInput, ListVirtualInterfaceTestHistoryCommandOutput, @@ -34,6 +37,9 @@ export class ListVirtualInterfaceTestHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/StartBgpFailoverTestCommand.ts b/clients/client-direct-connect/commands/StartBgpFailoverTestCommand.ts index ca165097e9053..f66e1460476a5 100644 --- a/clients/client-direct-connect/commands/StartBgpFailoverTestCommand.ts +++ b/clients/client-direct-connect/commands/StartBgpFailoverTestCommand.ts @@ -20,6 +20,12 @@ import { export type StartBgpFailoverTestCommandInput = StartBgpFailoverTestRequest; export type StartBgpFailoverTestCommandOutput = StartBgpFailoverTestResponse & __MetadataBearer; +/** + *

Starts the virtual interface failover test that verifies your configuration meets your resiliency requirements by placing the BGP peering session in the DOWN state. You can then send traffic to verify that there are no outages.

+ *

You can run the test on public, private, transit, and hosted virtual interfaces.

+ *

You can use ListVirtualInterfaceTestHistory to view the virtual interface test history.

+ *

If you need to stop the test before the test interval completes, use StopBgpFailoverTest.

+ */ export class StartBgpFailoverTestCommand extends $Command< StartBgpFailoverTestCommandInput, StartBgpFailoverTestCommandOutput, @@ -34,6 +40,9 @@ export class StartBgpFailoverTestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/StopBgpFailoverTestCommand.ts b/clients/client-direct-connect/commands/StopBgpFailoverTestCommand.ts index efc119dddee55..00563c45db8d5 100644 --- a/clients/client-direct-connect/commands/StopBgpFailoverTestCommand.ts +++ b/clients/client-direct-connect/commands/StopBgpFailoverTestCommand.ts @@ -20,6 +20,9 @@ import { export type StopBgpFailoverTestCommandInput = StopBgpFailoverTestRequest; export type StopBgpFailoverTestCommandOutput = StopBgpFailoverTestResponse & __MetadataBearer; +/** + *

Stops the virtual interface failover test.

+ */ export class StopBgpFailoverTestCommand extends $Command< StopBgpFailoverTestCommandInput, StopBgpFailoverTestCommandOutput, @@ -34,6 +37,9 @@ export class StopBgpFailoverTestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/TagResourceCommand.ts b/clients/client-direct-connect/commands/TagResourceCommand.ts index cb13b05c6f00a..93254b92d3b91 100644 --- a/clients/client-direct-connect/commands/TagResourceCommand.ts +++ b/clients/client-direct-connect/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds the specified tags to the specified AWS Direct Connect resource. Each resource can have a maximum of 50 tags.

+ *

Each tag consists of a key and an optional value. If a tag with the same key is already associated with the resource, this action updates its value.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/UntagResourceCommand.ts b/clients/client-direct-connect/commands/UntagResourceCommand.ts index 0d1c63600b2d3..8c2923def4618 100644 --- a/clients/client-direct-connect/commands/UntagResourceCommand.ts +++ b/clients/client-direct-connect/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from the specified AWS Direct Connect resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/UpdateDirectConnectGatewayAssociationCommand.ts b/clients/client-direct-connect/commands/UpdateDirectConnectGatewayAssociationCommand.ts index 3c20d5855693e..0f4a1e7f11792 100644 --- a/clients/client-direct-connect/commands/UpdateDirectConnectGatewayAssociationCommand.ts +++ b/clients/client-direct-connect/commands/UpdateDirectConnectGatewayAssociationCommand.ts @@ -24,6 +24,10 @@ export type UpdateDirectConnectGatewayAssociationCommandInput = UpdateDirectConn export type UpdateDirectConnectGatewayAssociationCommandOutput = UpdateDirectConnectGatewayAssociationResult & __MetadataBearer; +/** + *

Updates the specified attributes of the Direct Connect gateway association.

+ *

Add or remove prefixes from the association.

+ */ export class UpdateDirectConnectGatewayAssociationCommand extends $Command< UpdateDirectConnectGatewayAssociationCommandInput, UpdateDirectConnectGatewayAssociationCommandOutput, @@ -38,6 +42,9 @@ export class UpdateDirectConnectGatewayAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/UpdateLagCommand.ts b/clients/client-direct-connect/commands/UpdateLagCommand.ts index 5cf1ad6e79c5e..30bf52105dbde 100644 --- a/clients/client-direct-connect/commands/UpdateLagCommand.ts +++ b/clients/client-direct-connect/commands/UpdateLagCommand.ts @@ -17,6 +17,25 @@ import { export type UpdateLagCommandInput = UpdateLagRequest; export type UpdateLagCommandOutput = Lag & __MetadataBearer; +/** + *

Updates the attributes of the specified link aggregation group (LAG).

+ *

You can update the following attributes:

+ *
    + *
  • + *

    The name of the LAG.

    + *
  • + *
  • + *

    The value for the minimum number of connections that must be operational + * for the LAG itself to be operational.

    + *
  • + *
+ *

When you create a LAG, the default value for the minimum number of operational + * connections is zero (0). If you update this value and the number of operational + * connections falls below the specified value, the LAG automatically goes down to avoid + * over-utilization of the remaining connections. Adjust this value with care, as it + * could force the LAG down if it is set higher than the current number of operational + * connections.

+ */ export class UpdateLagCommand extends $Command< UpdateLagCommandInput, UpdateLagCommandOutput, @@ -31,6 +50,9 @@ export class UpdateLagCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/commands/UpdateVirtualInterfaceAttributesCommand.ts b/clients/client-direct-connect/commands/UpdateVirtualInterfaceAttributesCommand.ts index a5e91f09c00a5..79ea9d91630d9 100644 --- a/clients/client-direct-connect/commands/UpdateVirtualInterfaceAttributesCommand.ts +++ b/clients/client-direct-connect/commands/UpdateVirtualInterfaceAttributesCommand.ts @@ -20,6 +20,15 @@ import { export type UpdateVirtualInterfaceAttributesCommandInput = UpdateVirtualInterfaceAttributesRequest; export type UpdateVirtualInterfaceAttributesCommandOutput = VirtualInterface & __MetadataBearer; +/** + *

Updates the specified attributes of the specified virtual private interface.

+ *

Setting the MTU of a virtual interface to 9001 (jumbo frames) can cause an update to + * the underlying physical connection if it wasn't updated to support jumbo frames. Updating + * the connection disrupts network connectivity for all virtual interfaces associated with + * the connection for up to 30 seconds. To check whether your connection supports jumbo + * frames, call DescribeConnections. To check whether your virtual q + * interface supports jumbo frames, call DescribeVirtualInterfaces.

+ */ export class UpdateVirtualInterfaceAttributesCommand extends $Command< UpdateVirtualInterfaceAttributesCommandInput, UpdateVirtualInterfaceAttributesCommandOutput, @@ -34,6 +43,9 @@ export class UpdateVirtualInterfaceAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectConnectClientResolvedConfig, diff --git a/clients/client-direct-connect/package.json b/clients/client-direct-connect/package.json index c0390788a58f8..fb24f9e9723ef 100644 --- a/clients/client-direct-connect/package.json +++ b/clients/client-direct-connect/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Direct Connect Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-direct-connect/runtimeConfig.browser.ts b/clients/client-direct-connect/runtimeConfig.browser.ts index 3e4cf4063c42a..72f6b75601217 100644 --- a/clients/client-direct-connect/runtimeConfig.browser.ts +++ b/clients/client-direct-connect/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DirectConnectClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-direct-connect/runtimeConfig.native.ts b/clients/client-direct-connect/runtimeConfig.native.ts index 8bcb1c1df6cbe..f3790d49a3e8a 100644 --- a/clients/client-direct-connect/runtimeConfig.native.ts +++ b/clients/client-direct-connect/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DirectConnectClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-direct-connect/runtimeConfig.shared.ts b/clients/client-direct-connect/runtimeConfig.shared.ts index 27439ef526562..7b1debe3c52be 100644 --- a/clients/client-direct-connect/runtimeConfig.shared.ts +++ b/clients/client-direct-connect/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-10-25", disableHostPrefix: false, diff --git a/clients/client-direct-connect/runtimeConfig.ts b/clients/client-direct-connect/runtimeConfig.ts index a812dc7d49e03..de45384040d4f 100644 --- a/clients/client-direct-connect/runtimeConfig.ts +++ b/clients/client-direct-connect/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DirectConnectClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-direct-connect/tsconfig.json b/clients/client-direct-connect/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-direct-connect/tsconfig.json +++ b/clients/client-direct-connect/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-directory-service/commands/AcceptSharedDirectoryCommand.ts b/clients/client-directory-service/commands/AcceptSharedDirectoryCommand.ts index 12204dc13d86e..6031b93dc874e 100644 --- a/clients/client-directory-service/commands/AcceptSharedDirectoryCommand.ts +++ b/clients/client-directory-service/commands/AcceptSharedDirectoryCommand.ts @@ -20,6 +20,9 @@ import { export type AcceptSharedDirectoryCommandInput = AcceptSharedDirectoryRequest; export type AcceptSharedDirectoryCommandOutput = AcceptSharedDirectoryResult & __MetadataBearer; +/** + *

Accepts a directory sharing request that was sent from the directory owner account.

+ */ export class AcceptSharedDirectoryCommand extends $Command< AcceptSharedDirectoryCommandInput, AcceptSharedDirectoryCommandOutput, @@ -34,6 +37,9 @@ export class AcceptSharedDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/AddIpRoutesCommand.ts b/clients/client-directory-service/commands/AddIpRoutesCommand.ts index 5af3c4a95a3a8..931c3e1122191 100644 --- a/clients/client-directory-service/commands/AddIpRoutesCommand.ts +++ b/clients/client-directory-service/commands/AddIpRoutesCommand.ts @@ -20,6 +20,10 @@ import { export type AddIpRoutesCommandInput = AddIpRoutesRequest; export type AddIpRoutesCommandOutput = AddIpRoutesResult & __MetadataBearer; +/** + *

If the DNS server for your on-premises domain uses a publicly addressable IP address, you must add a CIDR address block to correctly route traffic to and from your Microsoft AD on Amazon Web Services. AddIpRoutes adds this address block. You can also use AddIpRoutes to facilitate routing traffic that uses public IP ranges from your Microsoft AD on AWS to a peer VPC.

+ *

Before you call AddIpRoutes, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the AddIpRoutes operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

+ */ export class AddIpRoutesCommand extends $Command< AddIpRoutesCommandInput, AddIpRoutesCommandOutput, @@ -34,6 +38,9 @@ export class AddIpRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/AddTagsToResourceCommand.ts b/clients/client-directory-service/commands/AddTagsToResourceCommand.ts index e710cee6e434b..2fb10a26b290a 100644 --- a/clients/client-directory-service/commands/AddTagsToResourceCommand.ts +++ b/clients/client-directory-service/commands/AddTagsToResourceCommand.ts @@ -20,6 +20,9 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceRequest; export type AddTagsToResourceCommandOutput = AddTagsToResourceResult & __MetadataBearer; +/** + *

Adds or overwrites one or more tags for the specified directory. Each directory can have a maximum of 50 tags. Each tag consists of a key and optional value. Tag keys must be unique to each resource.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -34,6 +37,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CancelSchemaExtensionCommand.ts b/clients/client-directory-service/commands/CancelSchemaExtensionCommand.ts index 042d4fb46dc0e..c8e76f7621955 100644 --- a/clients/client-directory-service/commands/CancelSchemaExtensionCommand.ts +++ b/clients/client-directory-service/commands/CancelSchemaExtensionCommand.ts @@ -20,6 +20,9 @@ import { export type CancelSchemaExtensionCommandInput = CancelSchemaExtensionRequest; export type CancelSchemaExtensionCommandOutput = CancelSchemaExtensionResult & __MetadataBearer; +/** + *

Cancels an in-progress schema extension to a Microsoft AD directory. Once a schema extension has started replicating to all domain controllers, the task can no longer be canceled. A schema extension can be canceled during any of the following states; Initializing, CreatingSnapshot, and UpdatingSchema.

+ */ export class CancelSchemaExtensionCommand extends $Command< CancelSchemaExtensionCommandInput, CancelSchemaExtensionCommandOutput, @@ -34,6 +37,9 @@ export class CancelSchemaExtensionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/ConnectDirectoryCommand.ts b/clients/client-directory-service/commands/ConnectDirectoryCommand.ts index c5765e122fa0b..538aaef3c558d 100644 --- a/clients/client-directory-service/commands/ConnectDirectoryCommand.ts +++ b/clients/client-directory-service/commands/ConnectDirectoryCommand.ts @@ -20,6 +20,10 @@ import { export type ConnectDirectoryCommandInput = ConnectDirectoryRequest; export type ConnectDirectoryCommandOutput = ConnectDirectoryResult & __MetadataBearer; +/** + *

Creates an AD Connector to connect to an on-premises directory.

+ *

Before you call ConnectDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the ConnectDirectory operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

+ */ export class ConnectDirectoryCommand extends $Command< ConnectDirectoryCommandInput, ConnectDirectoryCommandOutput, @@ -34,6 +38,9 @@ export class ConnectDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CreateAliasCommand.ts b/clients/client-directory-service/commands/CreateAliasCommand.ts index 861d31eb40d6f..24c9aa879e131 100644 --- a/clients/client-directory-service/commands/CreateAliasCommand.ts +++ b/clients/client-directory-service/commands/CreateAliasCommand.ts @@ -20,6 +20,14 @@ import { export type CreateAliasCommandInput = CreateAliasRequest; export type CreateAliasCommandOutput = CreateAliasResult & __MetadataBearer; +/** + *

Creates an alias for a directory and assigns the alias to the directory. The alias is used + * to construct the access URL for the directory, such as + * http://.awsapps.com.

+ * + *

After an alias has been created, it cannot be deleted or reused, so this operation should only be used when absolutely necessary.

+ *
+ */ export class CreateAliasCommand extends $Command< CreateAliasCommandInput, CreateAliasCommandOutput, @@ -34,6 +42,9 @@ export class CreateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CreateComputerCommand.ts b/clients/client-directory-service/commands/CreateComputerCommand.ts index 30bb118614990..45855ffe923b4 100644 --- a/clients/client-directory-service/commands/CreateComputerCommand.ts +++ b/clients/client-directory-service/commands/CreateComputerCommand.ts @@ -20,6 +20,9 @@ import { export type CreateComputerCommandInput = CreateComputerRequest; export type CreateComputerCommandOutput = CreateComputerResult & __MetadataBearer; +/** + *

Creates a computer account in the specified directory, and joins the computer to the directory.

+ */ export class CreateComputerCommand extends $Command< CreateComputerCommandInput, CreateComputerCommandOutput, @@ -34,6 +37,9 @@ export class CreateComputerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CreateConditionalForwarderCommand.ts b/clients/client-directory-service/commands/CreateConditionalForwarderCommand.ts index 2b48438dc38b0..dbc11aaeddb88 100644 --- a/clients/client-directory-service/commands/CreateConditionalForwarderCommand.ts +++ b/clients/client-directory-service/commands/CreateConditionalForwarderCommand.ts @@ -20,6 +20,9 @@ import { export type CreateConditionalForwarderCommandInput = CreateConditionalForwarderRequest; export type CreateConditionalForwarderCommandOutput = CreateConditionalForwarderResult & __MetadataBearer; +/** + *

Creates a conditional forwarder associated with your AWS directory. Conditional forwarders are required in order to set up a trust relationship with another domain. The conditional forwarder points to the trusted domain.

+ */ export class CreateConditionalForwarderCommand extends $Command< CreateConditionalForwarderCommandInput, CreateConditionalForwarderCommandOutput, @@ -34,6 +37,9 @@ export class CreateConditionalForwarderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CreateDirectoryCommand.ts b/clients/client-directory-service/commands/CreateDirectoryCommand.ts index e725771d79cd5..57ce5055caaf3 100644 --- a/clients/client-directory-service/commands/CreateDirectoryCommand.ts +++ b/clients/client-directory-service/commands/CreateDirectoryCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDirectoryCommandInput = CreateDirectoryRequest; export type CreateDirectoryCommandOutput = CreateDirectoryResult & __MetadataBearer; +/** + *

Creates a Simple AD directory. For more information, see Simple Active Directory in the AWS Directory Service Admin Guide.

+ *

Before you call CreateDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the CreateDirectory operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

+ */ export class CreateDirectoryCommand extends $Command< CreateDirectoryCommandInput, CreateDirectoryCommandOutput, @@ -34,6 +38,9 @@ export class CreateDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CreateLogSubscriptionCommand.ts b/clients/client-directory-service/commands/CreateLogSubscriptionCommand.ts index 0ae22cf0e309f..08f30ad97c6ae 100644 --- a/clients/client-directory-service/commands/CreateLogSubscriptionCommand.ts +++ b/clients/client-directory-service/commands/CreateLogSubscriptionCommand.ts @@ -20,6 +20,10 @@ import { export type CreateLogSubscriptionCommandInput = CreateLogSubscriptionRequest; export type CreateLogSubscriptionCommandOutput = CreateLogSubscriptionResult & __MetadataBearer; +/** + *

Creates a subscription to forward real-time Directory Service domain controller + * security logs to the specified Amazon CloudWatch log group in your AWS account.

+ */ export class CreateLogSubscriptionCommand extends $Command< CreateLogSubscriptionCommandInput, CreateLogSubscriptionCommandOutput, @@ -34,6 +38,9 @@ export class CreateLogSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CreateMicrosoftADCommand.ts b/clients/client-directory-service/commands/CreateMicrosoftADCommand.ts index 93f5db98dbca6..88fe1bfe71dbb 100644 --- a/clients/client-directory-service/commands/CreateMicrosoftADCommand.ts +++ b/clients/client-directory-service/commands/CreateMicrosoftADCommand.ts @@ -20,6 +20,10 @@ import { export type CreateMicrosoftADCommandInput = CreateMicrosoftADRequest; export type CreateMicrosoftADCommandOutput = CreateMicrosoftADResult & __MetadataBearer; +/** + *

Creates a Microsoft AD directory in the AWS Cloud. For more information, see AWS Managed Microsoft AD in the AWS Directory Service Admin Guide.

+ *

Before you call CreateMicrosoftAD, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the CreateMicrosoftAD operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

+ */ export class CreateMicrosoftADCommand extends $Command< CreateMicrosoftADCommandInput, CreateMicrosoftADCommandOutput, @@ -34,6 +38,9 @@ export class CreateMicrosoftADCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CreateSnapshotCommand.ts b/clients/client-directory-service/commands/CreateSnapshotCommand.ts index aeaf860d852d3..55fe58b72de74 100644 --- a/clients/client-directory-service/commands/CreateSnapshotCommand.ts +++ b/clients/client-directory-service/commands/CreateSnapshotCommand.ts @@ -20,6 +20,12 @@ import { export type CreateSnapshotCommandInput = CreateSnapshotRequest; export type CreateSnapshotCommandOutput = CreateSnapshotResult & __MetadataBearer; +/** + *

Creates a snapshot of a Simple AD or Microsoft AD directory in the AWS cloud.

+ * + *

You cannot take snapshots of AD Connector directories.

+ *
+ */ export class CreateSnapshotCommand extends $Command< CreateSnapshotCommandInput, CreateSnapshotCommandOutput, @@ -34,6 +40,9 @@ export class CreateSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/CreateTrustCommand.ts b/clients/client-directory-service/commands/CreateTrustCommand.ts index d92a2346e2a29..2b9b152dd9cbb 100644 --- a/clients/client-directory-service/commands/CreateTrustCommand.ts +++ b/clients/client-directory-service/commands/CreateTrustCommand.ts @@ -20,6 +20,10 @@ import { export type CreateTrustCommandInput = CreateTrustRequest; export type CreateTrustCommandOutput = CreateTrustResult & __MetadataBearer; +/** + *

AWS Directory Service for Microsoft Active Directory allows you to configure trust relationships. For example, you can establish a trust between your AWS Managed Microsoft AD directory, and your existing on-premises Microsoft Active Directory. This would allow you to provide users and groups access to resources in either domain, with a single set of credentials.

+ *

This action initiates the creation of the AWS side of a trust relationship between an AWS Managed Microsoft AD directory and an external domain. You can create either a forest trust or an external trust.

+ */ export class CreateTrustCommand extends $Command< CreateTrustCommandInput, CreateTrustCommandOutput, @@ -34,6 +38,9 @@ export class CreateTrustCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DeleteConditionalForwarderCommand.ts b/clients/client-directory-service/commands/DeleteConditionalForwarderCommand.ts index 63e251aee70eb..c72b61a876f42 100644 --- a/clients/client-directory-service/commands/DeleteConditionalForwarderCommand.ts +++ b/clients/client-directory-service/commands/DeleteConditionalForwarderCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteConditionalForwarderCommandInput = DeleteConditionalForwarderRequest; export type DeleteConditionalForwarderCommandOutput = DeleteConditionalForwarderResult & __MetadataBearer; +/** + *

Deletes a conditional forwarder that has been set up for your AWS directory.

+ */ export class DeleteConditionalForwarderCommand extends $Command< DeleteConditionalForwarderCommandInput, DeleteConditionalForwarderCommandOutput, @@ -34,6 +37,9 @@ export class DeleteConditionalForwarderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DeleteDirectoryCommand.ts b/clients/client-directory-service/commands/DeleteDirectoryCommand.ts index 48e9a67c5e041..af706e66e8a73 100644 --- a/clients/client-directory-service/commands/DeleteDirectoryCommand.ts +++ b/clients/client-directory-service/commands/DeleteDirectoryCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDirectoryCommandInput = DeleteDirectoryRequest; export type DeleteDirectoryCommandOutput = DeleteDirectoryResult & __MetadataBearer; +/** + *

Deletes an AWS Directory Service directory.

+ *

Before you call DeleteDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the DeleteDirectory operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.

+ */ export class DeleteDirectoryCommand extends $Command< DeleteDirectoryCommandInput, DeleteDirectoryCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DeleteLogSubscriptionCommand.ts b/clients/client-directory-service/commands/DeleteLogSubscriptionCommand.ts index 2928d96c693d6..f2891d4b4ced3 100644 --- a/clients/client-directory-service/commands/DeleteLogSubscriptionCommand.ts +++ b/clients/client-directory-service/commands/DeleteLogSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLogSubscriptionCommandInput = DeleteLogSubscriptionRequest; export type DeleteLogSubscriptionCommandOutput = DeleteLogSubscriptionResult & __MetadataBearer; +/** + *

Deletes the specified log subscription.

+ */ export class DeleteLogSubscriptionCommand extends $Command< DeleteLogSubscriptionCommandInput, DeleteLogSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLogSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DeleteSnapshotCommand.ts b/clients/client-directory-service/commands/DeleteSnapshotCommand.ts index 0352c12ea64d3..dd870877fe160 100644 --- a/clients/client-directory-service/commands/DeleteSnapshotCommand.ts +++ b/clients/client-directory-service/commands/DeleteSnapshotCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSnapshotCommandInput = DeleteSnapshotRequest; export type DeleteSnapshotCommandOutput = DeleteSnapshotResult & __MetadataBearer; +/** + *

Deletes a directory snapshot.

+ */ export class DeleteSnapshotCommand extends $Command< DeleteSnapshotCommandInput, DeleteSnapshotCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DeleteTrustCommand.ts b/clients/client-directory-service/commands/DeleteTrustCommand.ts index fe6f68dc16c0b..540d301418e27 100644 --- a/clients/client-directory-service/commands/DeleteTrustCommand.ts +++ b/clients/client-directory-service/commands/DeleteTrustCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTrustCommandInput = DeleteTrustRequest; export type DeleteTrustCommandOutput = DeleteTrustResult & __MetadataBearer; +/** + *

Deletes an existing trust relationship between your AWS Managed Microsoft AD directory and an external domain.

+ */ export class DeleteTrustCommand extends $Command< DeleteTrustCommandInput, DeleteTrustCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTrustCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DeregisterCertificateCommand.ts b/clients/client-directory-service/commands/DeregisterCertificateCommand.ts index e2fd88a35e7c0..6b430918b57c1 100644 --- a/clients/client-directory-service/commands/DeregisterCertificateCommand.ts +++ b/clients/client-directory-service/commands/DeregisterCertificateCommand.ts @@ -20,6 +20,10 @@ import { export type DeregisterCertificateCommandInput = DeregisterCertificateRequest; export type DeregisterCertificateCommandOutput = DeregisterCertificateResult & __MetadataBearer; +/** + *

Deletes from the system the certificate that was registered for a secured LDAP + * connection.

+ */ export class DeregisterCertificateCommand extends $Command< DeregisterCertificateCommandInput, DeregisterCertificateCommandOutput, @@ -34,6 +38,9 @@ export class DeregisterCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DeregisterEventTopicCommand.ts b/clients/client-directory-service/commands/DeregisterEventTopicCommand.ts index 2c640826a141d..ee3ed73282ca5 100644 --- a/clients/client-directory-service/commands/DeregisterEventTopicCommand.ts +++ b/clients/client-directory-service/commands/DeregisterEventTopicCommand.ts @@ -20,6 +20,9 @@ import { export type DeregisterEventTopicCommandInput = DeregisterEventTopicRequest; export type DeregisterEventTopicCommandOutput = DeregisterEventTopicResult & __MetadataBearer; +/** + *

Removes the specified directory as a publisher to the specified SNS topic.

+ */ export class DeregisterEventTopicCommand extends $Command< DeregisterEventTopicCommandInput, DeregisterEventTopicCommandOutput, @@ -34,6 +37,9 @@ export class DeregisterEventTopicCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeCertificateCommand.ts b/clients/client-directory-service/commands/DescribeCertificateCommand.ts index a0042baafb62b..0018675c44075 100644 --- a/clients/client-directory-service/commands/DescribeCertificateCommand.ts +++ b/clients/client-directory-service/commands/DescribeCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCertificateCommandInput = DescribeCertificateRequest; export type DescribeCertificateCommandOutput = DescribeCertificateResult & __MetadataBearer; +/** + *

Displays information about the certificate registered for a secured LDAP connection.

+ */ export class DescribeCertificateCommand extends $Command< DescribeCertificateCommandInput, DescribeCertificateCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeConditionalForwardersCommand.ts b/clients/client-directory-service/commands/DescribeConditionalForwardersCommand.ts index 7aacd1920e7c7..16d7fee6f33ba 100644 --- a/clients/client-directory-service/commands/DescribeConditionalForwardersCommand.ts +++ b/clients/client-directory-service/commands/DescribeConditionalForwardersCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeConditionalForwardersCommandInput = DescribeConditionalForwardersRequest; export type DescribeConditionalForwardersCommandOutput = DescribeConditionalForwardersResult & __MetadataBearer; +/** + *

Obtains information about the conditional forwarders for this account.

+ *

If no input parameters are provided for RemoteDomainNames, this request describes all conditional forwarders for the specified directory ID.

+ */ export class DescribeConditionalForwardersCommand extends $Command< DescribeConditionalForwardersCommandInput, DescribeConditionalForwardersCommandOutput, @@ -34,6 +38,9 @@ export class DescribeConditionalForwardersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeDirectoriesCommand.ts b/clients/client-directory-service/commands/DescribeDirectoriesCommand.ts index 37d02719d3f7b..834010bc57b86 100644 --- a/clients/client-directory-service/commands/DescribeDirectoriesCommand.ts +++ b/clients/client-directory-service/commands/DescribeDirectoriesCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeDirectoriesCommandInput = DescribeDirectoriesRequest; export type DescribeDirectoriesCommandOutput = DescribeDirectoriesResult & __MetadataBearer; +/** + *

Obtains information about the directories that belong to this account.

+ *

You can retrieve information about specific directories by passing the directory + * identifiers in the DirectoryIds parameter. Otherwise, all directories that belong to + * the current account are returned.

+ *

This operation supports pagination with the use of the NextToken request and + * response parameters. If more results are available, the + * DescribeDirectoriesResult.NextToken member contains a token that you pass in the + * next call to DescribeDirectories to retrieve the next set of items.

+ *

You can also specify a maximum number of return results with the Limit + * parameter.

+ */ export class DescribeDirectoriesCommand extends $Command< DescribeDirectoriesCommandInput, DescribeDirectoriesCommandOutput, @@ -34,6 +46,9 @@ export class DescribeDirectoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeDomainControllersCommand.ts b/clients/client-directory-service/commands/DescribeDomainControllersCommand.ts index aa53a871d8d4d..662856290679e 100644 --- a/clients/client-directory-service/commands/DescribeDomainControllersCommand.ts +++ b/clients/client-directory-service/commands/DescribeDomainControllersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDomainControllersCommandInput = DescribeDomainControllersRequest; export type DescribeDomainControllersCommandOutput = DescribeDomainControllersResult & __MetadataBearer; +/** + *

Provides information about any domain controllers in your directory.

+ */ export class DescribeDomainControllersCommand extends $Command< DescribeDomainControllersCommandInput, DescribeDomainControllersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDomainControllersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeEventTopicsCommand.ts b/clients/client-directory-service/commands/DescribeEventTopicsCommand.ts index 45c35ae4ca0a3..228fecfd428c3 100644 --- a/clients/client-directory-service/commands/DescribeEventTopicsCommand.ts +++ b/clients/client-directory-service/commands/DescribeEventTopicsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEventTopicsCommandInput = DescribeEventTopicsRequest; export type DescribeEventTopicsCommandOutput = DescribeEventTopicsResult & __MetadataBearer; +/** + *

Obtains information about which SNS topics receive status messages from the specified directory.

+ *

If no input parameters are provided, such as DirectoryId or TopicName, this request describes all of the associations in the account.

+ */ export class DescribeEventTopicsCommand extends $Command< DescribeEventTopicsCommandInput, DescribeEventTopicsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEventTopicsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeLDAPSSettingsCommand.ts b/clients/client-directory-service/commands/DescribeLDAPSSettingsCommand.ts index 420c79e553a2a..4ae57159a2f6a 100644 --- a/clients/client-directory-service/commands/DescribeLDAPSSettingsCommand.ts +++ b/clients/client-directory-service/commands/DescribeLDAPSSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLDAPSSettingsCommandInput = DescribeLDAPSSettingsRequest; export type DescribeLDAPSSettingsCommandOutput = DescribeLDAPSSettingsResult & __MetadataBearer; +/** + *

Describes the status of LDAP security for the specified directory.

+ */ export class DescribeLDAPSSettingsCommand extends $Command< DescribeLDAPSSettingsCommandInput, DescribeLDAPSSettingsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLDAPSSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeSharedDirectoriesCommand.ts b/clients/client-directory-service/commands/DescribeSharedDirectoriesCommand.ts index 7121f4e793a7f..e34f7f6966289 100644 --- a/clients/client-directory-service/commands/DescribeSharedDirectoriesCommand.ts +++ b/clients/client-directory-service/commands/DescribeSharedDirectoriesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSharedDirectoriesCommandInput = DescribeSharedDirectoriesRequest; export type DescribeSharedDirectoriesCommandOutput = DescribeSharedDirectoriesResult & __MetadataBearer; +/** + *

Returns the shared directories in your account.

+ */ export class DescribeSharedDirectoriesCommand extends $Command< DescribeSharedDirectoriesCommandInput, DescribeSharedDirectoriesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSharedDirectoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeSnapshotsCommand.ts b/clients/client-directory-service/commands/DescribeSnapshotsCommand.ts index 059433e6608b0..282d7d8425640 100644 --- a/clients/client-directory-service/commands/DescribeSnapshotsCommand.ts +++ b/clients/client-directory-service/commands/DescribeSnapshotsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeSnapshotsCommandInput = DescribeSnapshotsRequest; export type DescribeSnapshotsCommandOutput = DescribeSnapshotsResult & __MetadataBearer; +/** + *

Obtains information about the directory snapshots that belong to this account.

+ *

This operation supports pagination with the use of the NextToken request and + * response parameters. If more results are available, the DescribeSnapshots.NextToken + * member contains a token that you pass in the next call to DescribeSnapshots to + * retrieve the next set of items.

+ *

You can also specify a maximum number of return results with the Limit + * parameter.

+ */ export class DescribeSnapshotsCommand extends $Command< DescribeSnapshotsCommandInput, DescribeSnapshotsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DescribeTrustsCommand.ts b/clients/client-directory-service/commands/DescribeTrustsCommand.ts index 5baebd575eff6..7e5526b4d5df0 100644 --- a/clients/client-directory-service/commands/DescribeTrustsCommand.ts +++ b/clients/client-directory-service/commands/DescribeTrustsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeTrustsCommandInput = DescribeTrustsRequest; export type DescribeTrustsCommandOutput = DescribeTrustsResult & __MetadataBearer; +/** + *

Obtains information about the trust relationships for this account.

+ *

If no input parameters are provided, such as DirectoryId or TrustIds, this request describes all the trust relationships belonging to the account.

+ */ export class DescribeTrustsCommand extends $Command< DescribeTrustsCommandInput, DescribeTrustsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeTrustsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DisableLDAPSCommand.ts b/clients/client-directory-service/commands/DisableLDAPSCommand.ts index 91ef9b0490b11..5293909857b76 100644 --- a/clients/client-directory-service/commands/DisableLDAPSCommand.ts +++ b/clients/client-directory-service/commands/DisableLDAPSCommand.ts @@ -20,6 +20,9 @@ import { export type DisableLDAPSCommandInput = DisableLDAPSRequest; export type DisableLDAPSCommandOutput = DisableLDAPSResult & __MetadataBearer; +/** + *

Deactivates LDAP secure calls for the specified directory.

+ */ export class DisableLDAPSCommand extends $Command< DisableLDAPSCommandInput, DisableLDAPSCommandOutput, @@ -34,6 +37,9 @@ export class DisableLDAPSCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DisableRadiusCommand.ts b/clients/client-directory-service/commands/DisableRadiusCommand.ts index 00a6e734749f4..3100375cbec73 100644 --- a/clients/client-directory-service/commands/DisableRadiusCommand.ts +++ b/clients/client-directory-service/commands/DisableRadiusCommand.ts @@ -20,6 +20,9 @@ import { export type DisableRadiusCommandInput = DisableRadiusRequest; export type DisableRadiusCommandOutput = DisableRadiusResult & __MetadataBearer; +/** + *

Disables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for an AD Connector or Microsoft AD directory.

+ */ export class DisableRadiusCommand extends $Command< DisableRadiusCommandInput, DisableRadiusCommandOutput, @@ -34,6 +37,9 @@ export class DisableRadiusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/DisableSsoCommand.ts b/clients/client-directory-service/commands/DisableSsoCommand.ts index ea204fa65e396..37439223bae79 100644 --- a/clients/client-directory-service/commands/DisableSsoCommand.ts +++ b/clients/client-directory-service/commands/DisableSsoCommand.ts @@ -20,6 +20,9 @@ import { export type DisableSsoCommandInput = DisableSsoRequest; export type DisableSsoCommandOutput = DisableSsoResult & __MetadataBearer; +/** + *

Disables single-sign on for a directory.

+ */ export class DisableSsoCommand extends $Command< DisableSsoCommandInput, DisableSsoCommandOutput, @@ -34,6 +37,9 @@ export class DisableSsoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/EnableLDAPSCommand.ts b/clients/client-directory-service/commands/EnableLDAPSCommand.ts index 40f5ded662473..6b143edd0cae3 100644 --- a/clients/client-directory-service/commands/EnableLDAPSCommand.ts +++ b/clients/client-directory-service/commands/EnableLDAPSCommand.ts @@ -20,6 +20,9 @@ import { export type EnableLDAPSCommandInput = EnableLDAPSRequest; export type EnableLDAPSCommandOutput = EnableLDAPSResult & __MetadataBearer; +/** + *

Activates the switch for the specific directory to always use LDAP secure calls.

+ */ export class EnableLDAPSCommand extends $Command< EnableLDAPSCommandInput, EnableLDAPSCommandOutput, @@ -34,6 +37,9 @@ export class EnableLDAPSCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/EnableRadiusCommand.ts b/clients/client-directory-service/commands/EnableRadiusCommand.ts index 79d7d5ff23aa2..236a4803a213c 100644 --- a/clients/client-directory-service/commands/EnableRadiusCommand.ts +++ b/clients/client-directory-service/commands/EnableRadiusCommand.ts @@ -20,6 +20,9 @@ import { export type EnableRadiusCommandInput = EnableRadiusRequest; export type EnableRadiusCommandOutput = EnableRadiusResult & __MetadataBearer; +/** + *

Enables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for an AD Connector or Microsoft AD directory.

+ */ export class EnableRadiusCommand extends $Command< EnableRadiusCommandInput, EnableRadiusCommandOutput, @@ -34,6 +37,9 @@ export class EnableRadiusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/EnableSsoCommand.ts b/clients/client-directory-service/commands/EnableSsoCommand.ts index 1ab2fb449e9df..c6ff2f68519ba 100644 --- a/clients/client-directory-service/commands/EnableSsoCommand.ts +++ b/clients/client-directory-service/commands/EnableSsoCommand.ts @@ -17,6 +17,9 @@ import { export type EnableSsoCommandInput = EnableSsoRequest; export type EnableSsoCommandOutput = EnableSsoResult & __MetadataBearer; +/** + *

Enables single sign-on for a directory. Single sign-on allows users in your directory to access certain AWS services from a computer joined to the directory without having to enter their credentials separately.

+ */ export class EnableSsoCommand extends $Command< EnableSsoCommandInput, EnableSsoCommandOutput, @@ -31,6 +34,9 @@ export class EnableSsoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/GetDirectoryLimitsCommand.ts b/clients/client-directory-service/commands/GetDirectoryLimitsCommand.ts index a8e2b24331248..13d7223903aa8 100644 --- a/clients/client-directory-service/commands/GetDirectoryLimitsCommand.ts +++ b/clients/client-directory-service/commands/GetDirectoryLimitsCommand.ts @@ -20,6 +20,9 @@ import { export type GetDirectoryLimitsCommandInput = GetDirectoryLimitsRequest; export type GetDirectoryLimitsCommandOutput = GetDirectoryLimitsResult & __MetadataBearer; +/** + *

Obtains directory limit information for the current Region.

+ */ export class GetDirectoryLimitsCommand extends $Command< GetDirectoryLimitsCommandInput, GetDirectoryLimitsCommandOutput, @@ -34,6 +37,9 @@ export class GetDirectoryLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/GetSnapshotLimitsCommand.ts b/clients/client-directory-service/commands/GetSnapshotLimitsCommand.ts index bec502479624f..f2f31956a568f 100644 --- a/clients/client-directory-service/commands/GetSnapshotLimitsCommand.ts +++ b/clients/client-directory-service/commands/GetSnapshotLimitsCommand.ts @@ -20,6 +20,9 @@ import { export type GetSnapshotLimitsCommandInput = GetSnapshotLimitsRequest; export type GetSnapshotLimitsCommandOutput = GetSnapshotLimitsResult & __MetadataBearer; +/** + *

Obtains the manual snapshot limits for a directory.

+ */ export class GetSnapshotLimitsCommand extends $Command< GetSnapshotLimitsCommandInput, GetSnapshotLimitsCommandOutput, @@ -34,6 +37,9 @@ export class GetSnapshotLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/ListCertificatesCommand.ts b/clients/client-directory-service/commands/ListCertificatesCommand.ts index 9547b0eb00b2f..5bf6eba661680 100644 --- a/clients/client-directory-service/commands/ListCertificatesCommand.ts +++ b/clients/client-directory-service/commands/ListCertificatesCommand.ts @@ -20,6 +20,9 @@ import { export type ListCertificatesCommandInput = ListCertificatesRequest; export type ListCertificatesCommandOutput = ListCertificatesResult & __MetadataBearer; +/** + *

For the specified directory, lists all the certificates registered for a secured LDAP connection.

+ */ export class ListCertificatesCommand extends $Command< ListCertificatesCommandInput, ListCertificatesCommandOutput, @@ -34,6 +37,9 @@ export class ListCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/ListIpRoutesCommand.ts b/clients/client-directory-service/commands/ListIpRoutesCommand.ts index b6ecd702ad939..54dbf21020fe7 100644 --- a/clients/client-directory-service/commands/ListIpRoutesCommand.ts +++ b/clients/client-directory-service/commands/ListIpRoutesCommand.ts @@ -20,6 +20,9 @@ import { export type ListIpRoutesCommandInput = ListIpRoutesRequest; export type ListIpRoutesCommandOutput = ListIpRoutesResult & __MetadataBearer; +/** + *

Lists the address blocks that you have added to a directory.

+ */ export class ListIpRoutesCommand extends $Command< ListIpRoutesCommandInput, ListIpRoutesCommandOutput, @@ -34,6 +37,9 @@ export class ListIpRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/ListLogSubscriptionsCommand.ts b/clients/client-directory-service/commands/ListLogSubscriptionsCommand.ts index a12821b24f77c..d382d93a35019 100644 --- a/clients/client-directory-service/commands/ListLogSubscriptionsCommand.ts +++ b/clients/client-directory-service/commands/ListLogSubscriptionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListLogSubscriptionsCommandInput = ListLogSubscriptionsRequest; export type ListLogSubscriptionsCommandOutput = ListLogSubscriptionsResult & __MetadataBearer; +/** + *

Lists the active log subscriptions for the AWS account.

+ */ export class ListLogSubscriptionsCommand extends $Command< ListLogSubscriptionsCommandInput, ListLogSubscriptionsCommandOutput, @@ -34,6 +37,9 @@ export class ListLogSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/ListSchemaExtensionsCommand.ts b/clients/client-directory-service/commands/ListSchemaExtensionsCommand.ts index 4d0e96143f498..672674e8d3fb4 100644 --- a/clients/client-directory-service/commands/ListSchemaExtensionsCommand.ts +++ b/clients/client-directory-service/commands/ListSchemaExtensionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSchemaExtensionsCommandInput = ListSchemaExtensionsRequest; export type ListSchemaExtensionsCommandOutput = ListSchemaExtensionsResult & __MetadataBearer; +/** + *

Lists all schema extensions applied to a Microsoft AD Directory.

+ */ export class ListSchemaExtensionsCommand extends $Command< ListSchemaExtensionsCommandInput, ListSchemaExtensionsCommandOutput, @@ -34,6 +37,9 @@ export class ListSchemaExtensionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/ListTagsForResourceCommand.ts b/clients/client-directory-service/commands/ListTagsForResourceCommand.ts index f5ddb410a08af..d148a71a07368 100644 --- a/clients/client-directory-service/commands/ListTagsForResourceCommand.ts +++ b/clients/client-directory-service/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResult & __MetadataBearer; +/** + *

Lists all tags on a directory.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/RegisterCertificateCommand.ts b/clients/client-directory-service/commands/RegisterCertificateCommand.ts index a64ce7aaf0331..16172619f1af3 100644 --- a/clients/client-directory-service/commands/RegisterCertificateCommand.ts +++ b/clients/client-directory-service/commands/RegisterCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type RegisterCertificateCommandInput = RegisterCertificateRequest; export type RegisterCertificateCommandOutput = RegisterCertificateResult & __MetadataBearer; +/** + *

Registers a certificate for secured LDAP connection.

+ */ export class RegisterCertificateCommand extends $Command< RegisterCertificateCommandInput, RegisterCertificateCommandOutput, @@ -34,6 +37,9 @@ export class RegisterCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/RegisterEventTopicCommand.ts b/clients/client-directory-service/commands/RegisterEventTopicCommand.ts index 13cf20f0c4de1..903ed3418c443 100644 --- a/clients/client-directory-service/commands/RegisterEventTopicCommand.ts +++ b/clients/client-directory-service/commands/RegisterEventTopicCommand.ts @@ -20,6 +20,9 @@ import { export type RegisterEventTopicCommandInput = RegisterEventTopicRequest; export type RegisterEventTopicCommandOutput = RegisterEventTopicResult & __MetadataBearer; +/** + *

Associates a directory with an SNS topic. This establishes the directory as a publisher to the specified SNS topic. You can then receive email or text (SMS) messages when the status of your directory changes. You get notified if your directory goes from an Active status to an Impaired or Inoperable status. You also receive a notification when the directory returns to an Active status.

+ */ export class RegisterEventTopicCommand extends $Command< RegisterEventTopicCommandInput, RegisterEventTopicCommandOutput, @@ -34,6 +37,9 @@ export class RegisterEventTopicCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/RejectSharedDirectoryCommand.ts b/clients/client-directory-service/commands/RejectSharedDirectoryCommand.ts index be511ed2bc584..0e8d1694a0d3c 100644 --- a/clients/client-directory-service/commands/RejectSharedDirectoryCommand.ts +++ b/clients/client-directory-service/commands/RejectSharedDirectoryCommand.ts @@ -20,6 +20,9 @@ import { export type RejectSharedDirectoryCommandInput = RejectSharedDirectoryRequest; export type RejectSharedDirectoryCommandOutput = RejectSharedDirectoryResult & __MetadataBearer; +/** + *

Rejects a directory sharing request that was sent from the directory owner account.

+ */ export class RejectSharedDirectoryCommand extends $Command< RejectSharedDirectoryCommandInput, RejectSharedDirectoryCommandOutput, @@ -34,6 +37,9 @@ export class RejectSharedDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/RemoveIpRoutesCommand.ts b/clients/client-directory-service/commands/RemoveIpRoutesCommand.ts index 11b56205ecd80..b3229ca20f705 100644 --- a/clients/client-directory-service/commands/RemoveIpRoutesCommand.ts +++ b/clients/client-directory-service/commands/RemoveIpRoutesCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveIpRoutesCommandInput = RemoveIpRoutesRequest; export type RemoveIpRoutesCommandOutput = RemoveIpRoutesResult & __MetadataBearer; +/** + *

Removes IP address blocks from a directory.

+ */ export class RemoveIpRoutesCommand extends $Command< RemoveIpRoutesCommandInput, RemoveIpRoutesCommandOutput, @@ -34,6 +37,9 @@ export class RemoveIpRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/RemoveTagsFromResourceCommand.ts b/clients/client-directory-service/commands/RemoveTagsFromResourceCommand.ts index 9c4199d8a3cd8..e3a1f1a929b7c 100644 --- a/clients/client-directory-service/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-directory-service/commands/RemoveTagsFromResourceCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceRequest; export type RemoveTagsFromResourceCommandOutput = RemoveTagsFromResourceResult & __MetadataBearer; +/** + *

Removes tags from a directory.

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -34,6 +37,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/ResetUserPasswordCommand.ts b/clients/client-directory-service/commands/ResetUserPasswordCommand.ts index 5ada6899f08a8..ec36144046867 100644 --- a/clients/client-directory-service/commands/ResetUserPasswordCommand.ts +++ b/clients/client-directory-service/commands/ResetUserPasswordCommand.ts @@ -20,6 +20,25 @@ import { export type ResetUserPasswordCommandInput = ResetUserPasswordRequest; export type ResetUserPasswordCommandOutput = ResetUserPasswordResult & __MetadataBearer; +/** + *

Resets the password for any user in your AWS Managed Microsoft AD or Simple AD directory.

+ *

You can reset the password for any user in your directory with the following exceptions:

+ *
    + *
  • + *

    For Simple AD, you cannot reset the password for any user that is a member of either the + * Domain Admins or Enterprise + * Admins group except for the administrator user.

    + *
  • + *
  • + *

    For AWS Managed Microsoft AD, you can only reset the password for a user that is in an OU + * based off of the NetBIOS name that you typed when you created your directory. For example, + * you cannot reset the password for a user in the AWS + * Reserved OU. For more information about the OU structure for an AWS Managed + * Microsoft AD directory, see What Gets Created in the AWS Directory Service Administration + * Guide.

    + *
  • + *
+ */ export class ResetUserPasswordCommand extends $Command< ResetUserPasswordCommandInput, ResetUserPasswordCommandOutput, @@ -34,6 +53,9 @@ export class ResetUserPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/RestoreFromSnapshotCommand.ts b/clients/client-directory-service/commands/RestoreFromSnapshotCommand.ts index 8f84c17a67b91..d04132bbf8e65 100644 --- a/clients/client-directory-service/commands/RestoreFromSnapshotCommand.ts +++ b/clients/client-directory-service/commands/RestoreFromSnapshotCommand.ts @@ -20,6 +20,14 @@ import { export type RestoreFromSnapshotCommandInput = RestoreFromSnapshotRequest; export type RestoreFromSnapshotCommandOutput = RestoreFromSnapshotResult & __MetadataBearer; +/** + *

Restores a directory using an existing directory snapshot.

+ *

When you restore a directory from a snapshot, any changes made to the directory after the snapshot date are overwritten.

+ *

This action returns as soon as the restore operation is initiated. You can monitor the + * progress of the restore operation by calling the DescribeDirectories operation with + * the directory identifier. When the DirectoryDescription.Stage value changes to + * Active, the restore operation is complete.

+ */ export class RestoreFromSnapshotCommand extends $Command< RestoreFromSnapshotCommandInput, RestoreFromSnapshotCommandOutput, @@ -34,6 +42,9 @@ export class RestoreFromSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/ShareDirectoryCommand.ts b/clients/client-directory-service/commands/ShareDirectoryCommand.ts index 423aed369570e..656153fde0cb9 100644 --- a/clients/client-directory-service/commands/ShareDirectoryCommand.ts +++ b/clients/client-directory-service/commands/ShareDirectoryCommand.ts @@ -20,6 +20,21 @@ import { export type ShareDirectoryCommandInput = ShareDirectoryRequest; export type ShareDirectoryCommandOutput = ShareDirectoryResult & __MetadataBearer; +/** + *

Shares a specified directory (DirectoryId) in your AWS account (directory + * owner) with another AWS account (directory consumer). With this operation you can use your + * directory from any AWS account and from any Amazon VPC within an AWS Region.

+ *

When you share your AWS Managed Microsoft AD directory, AWS Directory Service creates a + * shared directory in the directory consumer account. This shared directory contains the + * metadata to provide access to the directory within the directory owner account. The shared + * directory is visible in all VPCs in the directory consumer account.

+ *

The ShareMethod parameter determines whether the specified directory can be + * shared between AWS accounts inside the same AWS organization (ORGANIZATIONS). It + * also determines whether you can share the directory with any other AWS account either inside + * or outside of the organization (HANDSHAKE).

+ *

The ShareNotes parameter is only used when HANDSHAKE is called, + * which sends a directory sharing request to the directory consumer.

+ */ export class ShareDirectoryCommand extends $Command< ShareDirectoryCommandInput, ShareDirectoryCommandOutput, @@ -34,6 +49,9 @@ export class ShareDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/StartSchemaExtensionCommand.ts b/clients/client-directory-service/commands/StartSchemaExtensionCommand.ts index 11415fe8a27b1..d491d9e33642f 100644 --- a/clients/client-directory-service/commands/StartSchemaExtensionCommand.ts +++ b/clients/client-directory-service/commands/StartSchemaExtensionCommand.ts @@ -20,6 +20,9 @@ import { export type StartSchemaExtensionCommandInput = StartSchemaExtensionRequest; export type StartSchemaExtensionCommandOutput = StartSchemaExtensionResult & __MetadataBearer; +/** + *

Applies a schema extension to a Microsoft AD directory.

+ */ export class StartSchemaExtensionCommand extends $Command< StartSchemaExtensionCommandInput, StartSchemaExtensionCommandOutput, @@ -34,6 +37,9 @@ export class StartSchemaExtensionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/UnshareDirectoryCommand.ts b/clients/client-directory-service/commands/UnshareDirectoryCommand.ts index 0bfe7449aee5b..a54897be61351 100644 --- a/clients/client-directory-service/commands/UnshareDirectoryCommand.ts +++ b/clients/client-directory-service/commands/UnshareDirectoryCommand.ts @@ -20,6 +20,9 @@ import { export type UnshareDirectoryCommandInput = UnshareDirectoryRequest; export type UnshareDirectoryCommandOutput = UnshareDirectoryResult & __MetadataBearer; +/** + *

Stops the directory sharing between the directory owner and consumer accounts.

+ */ export class UnshareDirectoryCommand extends $Command< UnshareDirectoryCommandInput, UnshareDirectoryCommandOutput, @@ -34,6 +37,9 @@ export class UnshareDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/UpdateConditionalForwarderCommand.ts b/clients/client-directory-service/commands/UpdateConditionalForwarderCommand.ts index 253446ded2fe8..ebab2d3418cc0 100644 --- a/clients/client-directory-service/commands/UpdateConditionalForwarderCommand.ts +++ b/clients/client-directory-service/commands/UpdateConditionalForwarderCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConditionalForwarderCommandInput = UpdateConditionalForwarderRequest; export type UpdateConditionalForwarderCommandOutput = UpdateConditionalForwarderResult & __MetadataBearer; +/** + *

Updates a conditional forwarder that has been set up for your AWS directory.

+ */ export class UpdateConditionalForwarderCommand extends $Command< UpdateConditionalForwarderCommandInput, UpdateConditionalForwarderCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConditionalForwarderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/UpdateNumberOfDomainControllersCommand.ts b/clients/client-directory-service/commands/UpdateNumberOfDomainControllersCommand.ts index 49fa24d22e21d..8736e9fbd3ead 100644 --- a/clients/client-directory-service/commands/UpdateNumberOfDomainControllersCommand.ts +++ b/clients/client-directory-service/commands/UpdateNumberOfDomainControllersCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateNumberOfDomainControllersCommandInput = UpdateNumberOfDomainControllersRequest; export type UpdateNumberOfDomainControllersCommandOutput = UpdateNumberOfDomainControllersResult & __MetadataBearer; +/** + *

Adds or removes domain controllers to or from the directory. Based on the difference between current value and new value (provided through this API call), domain controllers will be added or removed. It may take up to 45 minutes for any new domain controllers to become fully active once the requested number of domain controllers is updated. During this time, you cannot make another update request.

+ */ export class UpdateNumberOfDomainControllersCommand extends $Command< UpdateNumberOfDomainControllersCommandInput, UpdateNumberOfDomainControllersCommandOutput, @@ -34,6 +37,9 @@ export class UpdateNumberOfDomainControllersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/UpdateRadiusCommand.ts b/clients/client-directory-service/commands/UpdateRadiusCommand.ts index 47a5a25ec447b..7d288f6df5669 100644 --- a/clients/client-directory-service/commands/UpdateRadiusCommand.ts +++ b/clients/client-directory-service/commands/UpdateRadiusCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRadiusCommandInput = UpdateRadiusRequest; export type UpdateRadiusCommandOutput = UpdateRadiusResult & __MetadataBearer; +/** + *

Updates the Remote Authentication Dial In User Service (RADIUS) server information for an AD Connector or Microsoft AD directory.

+ */ export class UpdateRadiusCommand extends $Command< UpdateRadiusCommandInput, UpdateRadiusCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRadiusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/UpdateTrustCommand.ts b/clients/client-directory-service/commands/UpdateTrustCommand.ts index 9e0f9b4dc8e4e..16da054ce074d 100644 --- a/clients/client-directory-service/commands/UpdateTrustCommand.ts +++ b/clients/client-directory-service/commands/UpdateTrustCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTrustCommandInput = UpdateTrustRequest; export type UpdateTrustCommandOutput = UpdateTrustResult & __MetadataBearer; +/** + *

Updates the trust that has been set up between your AWS Managed Microsoft AD directory and an on-premises Active Directory.

+ */ export class UpdateTrustCommand extends $Command< UpdateTrustCommandInput, UpdateTrustCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTrustCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/commands/VerifyTrustCommand.ts b/clients/client-directory-service/commands/VerifyTrustCommand.ts index d5b8dc3b50836..f093f7f8585ff 100644 --- a/clients/client-directory-service/commands/VerifyTrustCommand.ts +++ b/clients/client-directory-service/commands/VerifyTrustCommand.ts @@ -20,6 +20,10 @@ import { export type VerifyTrustCommandInput = VerifyTrustRequest; export type VerifyTrustCommandOutput = VerifyTrustResult & __MetadataBearer; +/** + *

AWS Directory Service for Microsoft Active Directory allows you to configure and verify trust relationships.

+ *

This action verifies a trust relationship between your AWS Managed Microsoft AD directory and an external domain.

+ */ export class VerifyTrustCommand extends $Command< VerifyTrustCommandInput, VerifyTrustCommandOutput, @@ -34,6 +38,9 @@ export class VerifyTrustCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DirectoryServiceClientResolvedConfig, diff --git a/clients/client-directory-service/package.json b/clients/client-directory-service/package.json index 452b64259b835..beddc5b84558b 100644 --- a/clients/client-directory-service/package.json +++ b/clients/client-directory-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Directory Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-directory-service/pagination/DescribeDomainControllersPaginator.ts b/clients/client-directory-service/pagination/DescribeDomainControllersPaginator.ts index ed7fc10b814c4..614648280c51b 100644 --- a/clients/client-directory-service/pagination/DescribeDomainControllersPaginator.ts +++ b/clients/client-directory-service/pagination/DescribeDomainControllersPaginator.ts @@ -8,6 +8,9 @@ import { import { DirectoryServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DirectoryServiceClient, input: DescribeDomainControllersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDomainControllersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DirectoryService, input: DescribeDomainControllersCommandInput, diff --git a/clients/client-directory-service/runtimeConfig.browser.ts b/clients/client-directory-service/runtimeConfig.browser.ts index 1916831aab01a..69d6c832fe0a2 100644 --- a/clients/client-directory-service/runtimeConfig.browser.ts +++ b/clients/client-directory-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DirectoryServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-directory-service/runtimeConfig.native.ts b/clients/client-directory-service/runtimeConfig.native.ts index 02a49796090e0..1feba5c63d243 100644 --- a/clients/client-directory-service/runtimeConfig.native.ts +++ b/clients/client-directory-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DirectoryServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-directory-service/runtimeConfig.shared.ts b/clients/client-directory-service/runtimeConfig.shared.ts index f12d19d8fe980..397d3a4ae629c 100644 --- a/clients/client-directory-service/runtimeConfig.shared.ts +++ b/clients/client-directory-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-04-16", disableHostPrefix: false, diff --git a/clients/client-directory-service/runtimeConfig.ts b/clients/client-directory-service/runtimeConfig.ts index f256b31e83c07..c14456b94afcb 100644 --- a/clients/client-directory-service/runtimeConfig.ts +++ b/clients/client-directory-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DirectoryServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-directory-service/tsconfig.json b/clients/client-directory-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-directory-service/tsconfig.json +++ b/clients/client-directory-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-dlm/commands/CreateLifecyclePolicyCommand.ts b/clients/client-dlm/commands/CreateLifecyclePolicyCommand.ts index 7954f415a0414..f4b3df5895aba 100644 --- a/clients/client-dlm/commands/CreateLifecyclePolicyCommand.ts +++ b/clients/client-dlm/commands/CreateLifecyclePolicyCommand.ts @@ -20,6 +20,10 @@ import { export type CreateLifecyclePolicyCommandInput = CreateLifecyclePolicyRequest; export type CreateLifecyclePolicyCommandOutput = CreateLifecyclePolicyResponse & __MetadataBearer; +/** + *

Creates a policy to manage the lifecycle of the specified AWS resources. You can + * create up to 100 lifecycle policies.

+ */ export class CreateLifecyclePolicyCommand extends $Command< CreateLifecyclePolicyCommandInput, CreateLifecyclePolicyCommandOutput, @@ -34,6 +38,9 @@ export class CreateLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DLMClientResolvedConfig, diff --git a/clients/client-dlm/commands/DeleteLifecyclePolicyCommand.ts b/clients/client-dlm/commands/DeleteLifecyclePolicyCommand.ts index 766d70bfafeb4..25db1ea7bd776 100644 --- a/clients/client-dlm/commands/DeleteLifecyclePolicyCommand.ts +++ b/clients/client-dlm/commands/DeleteLifecyclePolicyCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteLifecyclePolicyCommandInput = DeleteLifecyclePolicyRequest; export type DeleteLifecyclePolicyCommandOutput = DeleteLifecyclePolicyResponse & __MetadataBearer; +/** + *

Deletes the specified lifecycle policy and halts the automated operations that the + * policy specified.

+ */ export class DeleteLifecyclePolicyCommand extends $Command< DeleteLifecyclePolicyCommandInput, DeleteLifecyclePolicyCommandOutput, @@ -34,6 +38,9 @@ export class DeleteLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DLMClientResolvedConfig, diff --git a/clients/client-dlm/commands/GetLifecyclePoliciesCommand.ts b/clients/client-dlm/commands/GetLifecyclePoliciesCommand.ts index 0d055b8fd5ad1..71cf873083636 100644 --- a/clients/client-dlm/commands/GetLifecyclePoliciesCommand.ts +++ b/clients/client-dlm/commands/GetLifecyclePoliciesCommand.ts @@ -20,6 +20,10 @@ import { export type GetLifecyclePoliciesCommandInput = GetLifecyclePoliciesRequest; export type GetLifecyclePoliciesCommandOutput = GetLifecyclePoliciesResponse & __MetadataBearer; +/** + *

Gets summary information about all or the specified data lifecycle policies.

+ *

To get complete information about a policy, use GetLifecyclePolicy.

+ */ export class GetLifecyclePoliciesCommand extends $Command< GetLifecyclePoliciesCommandInput, GetLifecyclePoliciesCommandOutput, @@ -34,6 +38,9 @@ export class GetLifecyclePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DLMClientResolvedConfig, diff --git a/clients/client-dlm/commands/GetLifecyclePolicyCommand.ts b/clients/client-dlm/commands/GetLifecyclePolicyCommand.ts index c9120eb53ca41..54df9a1f1fad6 100644 --- a/clients/client-dlm/commands/GetLifecyclePolicyCommand.ts +++ b/clients/client-dlm/commands/GetLifecyclePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetLifecyclePolicyCommandInput = GetLifecyclePolicyRequest; export type GetLifecyclePolicyCommandOutput = GetLifecyclePolicyResponse & __MetadataBearer; +/** + *

Gets detailed information about the specified lifecycle policy.

+ */ export class GetLifecyclePolicyCommand extends $Command< GetLifecyclePolicyCommandInput, GetLifecyclePolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DLMClientResolvedConfig, diff --git a/clients/client-dlm/commands/ListTagsForResourceCommand.ts b/clients/client-dlm/commands/ListTagsForResourceCommand.ts index b5ddf9a562b2f..dd08ac75e35f0 100644 --- a/clients/client-dlm/commands/ListTagsForResourceCommand.ts +++ b/clients/client-dlm/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags for the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DLMClientResolvedConfig, diff --git a/clients/client-dlm/commands/TagResourceCommand.ts b/clients/client-dlm/commands/TagResourceCommand.ts index 99541f590d25e..e6bf3b4ef84ef 100644 --- a/clients/client-dlm/commands/TagResourceCommand.ts +++ b/clients/client-dlm/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds the specified tags to the specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DLMClientResolvedConfig, diff --git a/clients/client-dlm/commands/UntagResourceCommand.ts b/clients/client-dlm/commands/UntagResourceCommand.ts index 7b083cc9d5053..04573950b1d4d 100644 --- a/clients/client-dlm/commands/UntagResourceCommand.ts +++ b/clients/client-dlm/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the specified tags from the specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DLMClientResolvedConfig, diff --git a/clients/client-dlm/commands/UpdateLifecyclePolicyCommand.ts b/clients/client-dlm/commands/UpdateLifecyclePolicyCommand.ts index 4bf84ab26a2d5..e144d3912f488 100644 --- a/clients/client-dlm/commands/UpdateLifecyclePolicyCommand.ts +++ b/clients/client-dlm/commands/UpdateLifecyclePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateLifecyclePolicyCommandInput = UpdateLifecyclePolicyRequest; export type UpdateLifecyclePolicyCommandOutput = UpdateLifecyclePolicyResponse & __MetadataBearer; +/** + *

Updates the specified lifecycle policy.

+ */ export class UpdateLifecyclePolicyCommand extends $Command< UpdateLifecyclePolicyCommandInput, UpdateLifecyclePolicyCommandOutput, @@ -34,6 +37,9 @@ export class UpdateLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DLMClientResolvedConfig, diff --git a/clients/client-dlm/package.json b/clients/client-dlm/package.json index 378705ae00dfd..e1ebcfd3f37f3 100644 --- a/clients/client-dlm/package.json +++ b/clients/client-dlm/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Dlm Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-dlm/runtimeConfig.browser.ts b/clients/client-dlm/runtimeConfig.browser.ts index d6725422ce7d4..26d20a3b3a8e4 100644 --- a/clients/client-dlm/runtimeConfig.browser.ts +++ b/clients/client-dlm/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DLMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-dlm/runtimeConfig.native.ts b/clients/client-dlm/runtimeConfig.native.ts index 59093e3029227..3eb41cac64d8a 100644 --- a/clients/client-dlm/runtimeConfig.native.ts +++ b/clients/client-dlm/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DLMClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-dlm/runtimeConfig.shared.ts b/clients/client-dlm/runtimeConfig.shared.ts index ec59078d7378f..3034eb6843824 100644 --- a/clients/client-dlm/runtimeConfig.shared.ts +++ b/clients/client-dlm/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-01-12", disableHostPrefix: false, diff --git a/clients/client-dlm/runtimeConfig.ts b/clients/client-dlm/runtimeConfig.ts index a83c6a5e65b3b..88be42bbdb0eb 100644 --- a/clients/client-dlm/runtimeConfig.ts +++ b/clients/client-dlm/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DLMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-dlm/tsconfig.json b/clients/client-dlm/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-dlm/tsconfig.json +++ b/clients/client-dlm/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-docdb/commands/AddTagsToResourceCommand.ts b/clients/client-docdb/commands/AddTagsToResourceCommand.ts index db920e97ec68e..965fdd91eae3f 100644 --- a/clients/client-docdb/commands/AddTagsToResourceCommand.ts +++ b/clients/client-docdb/commands/AddTagsToResourceCommand.ts @@ -20,6 +20,12 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceMessage; export type AddTagsToResourceCommandOutput = __MetadataBearer; +/** + *

Adds metadata tags to an Amazon DocumentDB resource. You can use these tags + * with cost allocation reporting to track costs that are associated + * with Amazon DocumentDB resources. or in a Condition statement in + * an AWS Identity and Access Management (IAM) policy for Amazon DocumentDB.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -34,6 +40,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/ApplyPendingMaintenanceActionCommand.ts b/clients/client-docdb/commands/ApplyPendingMaintenanceActionCommand.ts index 254b23fa6dc2c..f3c06eb7b10e7 100644 --- a/clients/client-docdb/commands/ApplyPendingMaintenanceActionCommand.ts +++ b/clients/client-docdb/commands/ApplyPendingMaintenanceActionCommand.ts @@ -20,6 +20,10 @@ import { export type ApplyPendingMaintenanceActionCommandInput = ApplyPendingMaintenanceActionMessage; export type ApplyPendingMaintenanceActionCommandOutput = ApplyPendingMaintenanceActionResult & __MetadataBearer; +/** + *

Applies a pending maintenance action to a resource (for example, + * to an Amazon DocumentDB instance).

+ */ export class ApplyPendingMaintenanceActionCommand extends $Command< ApplyPendingMaintenanceActionCommandInput, ApplyPendingMaintenanceActionCommandOutput, @@ -34,6 +38,9 @@ export class ApplyPendingMaintenanceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/CopyDBClusterParameterGroupCommand.ts b/clients/client-docdb/commands/CopyDBClusterParameterGroupCommand.ts index 177404efc25cd..5bc8b180d3319 100644 --- a/clients/client-docdb/commands/CopyDBClusterParameterGroupCommand.ts +++ b/clients/client-docdb/commands/CopyDBClusterParameterGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CopyDBClusterParameterGroupCommandInput = CopyDBClusterParameterGroupMessage; export type CopyDBClusterParameterGroupCommandOutput = CopyDBClusterParameterGroupResult & __MetadataBearer; +/** + *

Copies the specified cluster parameter group.

+ */ export class CopyDBClusterParameterGroupCommand extends $Command< CopyDBClusterParameterGroupCommandInput, CopyDBClusterParameterGroupCommandOutput, @@ -34,6 +37,9 @@ export class CopyDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/CopyDBClusterSnapshotCommand.ts b/clients/client-docdb/commands/CopyDBClusterSnapshotCommand.ts index 1fd7490018306..fa00a073601e9 100644 --- a/clients/client-docdb/commands/CopyDBClusterSnapshotCommand.ts +++ b/clients/client-docdb/commands/CopyDBClusterSnapshotCommand.ts @@ -20,6 +20,20 @@ import { export type CopyDBClusterSnapshotCommandInput = CopyDBClusterSnapshotMessage; export type CopyDBClusterSnapshotCommandOutput = CopyDBClusterSnapshotResult & __MetadataBearer; +/** + *

Copies a snapshot of a cluster.

+ * + *

To copy a cluster snapshot from a shared manual cluster snapshot, + * SourceDBClusterSnapshotIdentifier must be the Amazon + * Resource Name (ARN) of the shared cluster snapshot. You can only + * copy a shared DB cluster snapshot, whether encrypted or not, in the + * same AWS Region.

+ * + *

To cancel the copy operation after it is in progress, delete the + * target cluster snapshot identified by + * TargetDBClusterSnapshotIdentifier while that cluster + * snapshot is in the copying status.

+ */ export class CopyDBClusterSnapshotCommand extends $Command< CopyDBClusterSnapshotCommandInput, CopyDBClusterSnapshotCommandOutput, @@ -34,6 +48,9 @@ export class CopyDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/CreateDBClusterCommand.ts b/clients/client-docdb/commands/CreateDBClusterCommand.ts index c1aa1ecc42284..e7eaab64959e1 100644 --- a/clients/client-docdb/commands/CreateDBClusterCommand.ts +++ b/clients/client-docdb/commands/CreateDBClusterCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBClusterCommandInput = CreateDBClusterMessage; export type CreateDBClusterCommandOutput = CreateDBClusterResult & __MetadataBearer; +/** + *

Creates a new Amazon DocumentDB cluster.

+ */ export class CreateDBClusterCommand extends $Command< CreateDBClusterCommandInput, CreateDBClusterCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/CreateDBClusterParameterGroupCommand.ts b/clients/client-docdb/commands/CreateDBClusterParameterGroupCommand.ts index 7aaed40f1b408..b44369130428e 100644 --- a/clients/client-docdb/commands/CreateDBClusterParameterGroupCommand.ts +++ b/clients/client-docdb/commands/CreateDBClusterParameterGroupCommand.ts @@ -20,6 +20,27 @@ import { export type CreateDBClusterParameterGroupCommandInput = CreateDBClusterParameterGroupMessage; export type CreateDBClusterParameterGroupCommandOutput = CreateDBClusterParameterGroupResult & __MetadataBearer; +/** + *

Creates a new cluster parameter group.

+ *

Parameters in a cluster parameter group apply to all of the + * instances in a cluster.

+ *

A cluster parameter group is initially created with the default + * parameters for the database engine used by instances in the cluster. + * In Amazon DocumentDB, you cannot make modifications directly to the + * default.docdb3.6 cluster parameter group. If your + * Amazon DocumentDB cluster is using the default cluster parameter group and you + * want to modify a value in it, you must first + * create a new parameter group + * or + * copy an existing parameter group, + * modify it, and then apply the modified parameter group to your + * cluster. For the new cluster parameter group and associated settings + * to take effect, you must then reboot the instances in the cluster + * without failover. For more information, + * see + * Modifying Amazon DocumentDB Cluster Parameter Groups. + *

+ */ export class CreateDBClusterParameterGroupCommand extends $Command< CreateDBClusterParameterGroupCommandInput, CreateDBClusterParameterGroupCommandOutput, @@ -34,6 +55,9 @@ export class CreateDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/CreateDBClusterSnapshotCommand.ts b/clients/client-docdb/commands/CreateDBClusterSnapshotCommand.ts index f247ed9d3c178..990731e904eb2 100644 --- a/clients/client-docdb/commands/CreateDBClusterSnapshotCommand.ts +++ b/clients/client-docdb/commands/CreateDBClusterSnapshotCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBClusterSnapshotCommandInput = CreateDBClusterSnapshotMessage; export type CreateDBClusterSnapshotCommandOutput = CreateDBClusterSnapshotResult & __MetadataBearer; +/** + *

Creates a snapshot of a cluster.

+ */ export class CreateDBClusterSnapshotCommand extends $Command< CreateDBClusterSnapshotCommandInput, CreateDBClusterSnapshotCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/CreateDBInstanceCommand.ts b/clients/client-docdb/commands/CreateDBInstanceCommand.ts index 3ce4de34825a7..f0c681018e8b8 100644 --- a/clients/client-docdb/commands/CreateDBInstanceCommand.ts +++ b/clients/client-docdb/commands/CreateDBInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBInstanceCommandInput = CreateDBInstanceMessage; export type CreateDBInstanceCommandOutput = CreateDBInstanceResult & __MetadataBearer; +/** + *

Creates a new instance.

+ */ export class CreateDBInstanceCommand extends $Command< CreateDBInstanceCommandInput, CreateDBInstanceCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/CreateDBSubnetGroupCommand.ts b/clients/client-docdb/commands/CreateDBSubnetGroupCommand.ts index b40892f60a3e7..3f370149538f1 100644 --- a/clients/client-docdb/commands/CreateDBSubnetGroupCommand.ts +++ b/clients/client-docdb/commands/CreateDBSubnetGroupCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDBSubnetGroupCommandInput = CreateDBSubnetGroupMessage; export type CreateDBSubnetGroupCommandOutput = CreateDBSubnetGroupResult & __MetadataBearer; +/** + *

Creates a new subnet group. subnet groups must contain at least one subnet in at + * least two Availability Zones in the AWS Region.

+ */ export class CreateDBSubnetGroupCommand extends $Command< CreateDBSubnetGroupCommandInput, CreateDBSubnetGroupCommandOutput, @@ -34,6 +38,9 @@ export class CreateDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DeleteDBClusterCommand.ts b/clients/client-docdb/commands/DeleteDBClusterCommand.ts index 98850f14b8bd5..054b7f4453490 100644 --- a/clients/client-docdb/commands/DeleteDBClusterCommand.ts +++ b/clients/client-docdb/commands/DeleteDBClusterCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDBClusterCommandInput = DeleteDBClusterMessage; export type DeleteDBClusterCommandOutput = DeleteDBClusterResult & __MetadataBearer; +/** + *

Deletes a previously provisioned cluster. When you delete a cluster, all + * automated backups for that cluster are deleted and can't be recovered. Manual DB + * cluster snapshots of the specified cluster are not deleted.

+ *

+ */ export class DeleteDBClusterCommand extends $Command< DeleteDBClusterCommandInput, DeleteDBClusterCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DeleteDBClusterParameterGroupCommand.ts b/clients/client-docdb/commands/DeleteDBClusterParameterGroupCommand.ts index 8b3234d7d58ae..1242a8131c388 100644 --- a/clients/client-docdb/commands/DeleteDBClusterParameterGroupCommand.ts +++ b/clients/client-docdb/commands/DeleteDBClusterParameterGroupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDBClusterParameterGroupCommandInput = DeleteDBClusterParameterGroupMessage; export type DeleteDBClusterParameterGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a specified cluster parameter group. The cluster parameter group to be + * deleted can't be associated with any clusters.

+ */ export class DeleteDBClusterParameterGroupCommand extends $Command< DeleteDBClusterParameterGroupCommandInput, DeleteDBClusterParameterGroupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DeleteDBClusterSnapshotCommand.ts b/clients/client-docdb/commands/DeleteDBClusterSnapshotCommand.ts index ac19bbfa03bdc..611e3e8c3115e 100644 --- a/clients/client-docdb/commands/DeleteDBClusterSnapshotCommand.ts +++ b/clients/client-docdb/commands/DeleteDBClusterSnapshotCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteDBClusterSnapshotCommandInput = DeleteDBClusterSnapshotMessage; export type DeleteDBClusterSnapshotCommandOutput = DeleteDBClusterSnapshotResult & __MetadataBearer; +/** + *

Deletes a cluster snapshot. If the snapshot is being copied, the copy operation is + * terminated.

+ * + *

The cluster snapshot must be in the available state to be + * deleted.

+ *
+ */ export class DeleteDBClusterSnapshotCommand extends $Command< DeleteDBClusterSnapshotCommandInput, DeleteDBClusterSnapshotCommandOutput, @@ -34,6 +42,9 @@ export class DeleteDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DeleteDBInstanceCommand.ts b/clients/client-docdb/commands/DeleteDBInstanceCommand.ts index b68a52e32a89e..f072180dac0cf 100644 --- a/clients/client-docdb/commands/DeleteDBInstanceCommand.ts +++ b/clients/client-docdb/commands/DeleteDBInstanceCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDBInstanceCommandInput = DeleteDBInstanceMessage; export type DeleteDBInstanceCommandOutput = DeleteDBInstanceResult & __MetadataBearer; +/** + *

Deletes a previously provisioned instance. + *

+ */ export class DeleteDBInstanceCommand extends $Command< DeleteDBInstanceCommandInput, DeleteDBInstanceCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DeleteDBSubnetGroupCommand.ts b/clients/client-docdb/commands/DeleteDBSubnetGroupCommand.ts index 1a6d898932ff0..e4e98fe697819 100644 --- a/clients/client-docdb/commands/DeleteDBSubnetGroupCommand.ts +++ b/clients/client-docdb/commands/DeleteDBSubnetGroupCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteDBSubnetGroupCommandInput = DeleteDBSubnetGroupMessage; export type DeleteDBSubnetGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a subnet group.

+ * + *

The specified database subnet group must not be associated with any DB + * instances.

+ *
+ */ export class DeleteDBSubnetGroupCommand extends $Command< DeleteDBSubnetGroupCommandInput, DeleteDBSubnetGroupCommandOutput, @@ -34,6 +41,9 @@ export class DeleteDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeCertificatesCommand.ts b/clients/client-docdb/commands/DescribeCertificatesCommand.ts index f33a7811720b5..26b422bfee821 100644 --- a/clients/client-docdb/commands/DescribeCertificatesCommand.ts +++ b/clients/client-docdb/commands/DescribeCertificatesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeCertificatesCommandInput = DescribeCertificatesMessage; export type DescribeCertificatesCommandOutput = CertificateMessage & __MetadataBearer; +/** + *

Returns a list of certificate authority (CA) certificates provided by Amazon DocumentDB for + * this AWS account.

+ */ export class DescribeCertificatesCommand extends $Command< DescribeCertificatesCommandInput, DescribeCertificatesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeDBClusterParameterGroupsCommand.ts b/clients/client-docdb/commands/DescribeDBClusterParameterGroupsCommand.ts index cc8d936637dce..4b382a933402f 100644 --- a/clients/client-docdb/commands/DescribeDBClusterParameterGroupsCommand.ts +++ b/clients/client-docdb/commands/DescribeDBClusterParameterGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDBClusterParameterGroupsCommandInput = DescribeDBClusterParameterGroupsMessage; export type DescribeDBClusterParameterGroupsCommandOutput = DBClusterParameterGroupsMessage & __MetadataBearer; +/** + *

Returns a list of DBClusterParameterGroup descriptions. If a + * DBClusterParameterGroupName parameter is specified, the list contains + * only the description of the specified cluster parameter group.

+ */ export class DescribeDBClusterParameterGroupsCommand extends $Command< DescribeDBClusterParameterGroupsCommandInput, DescribeDBClusterParameterGroupsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDBClusterParameterGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeDBClusterParametersCommand.ts b/clients/client-docdb/commands/DescribeDBClusterParametersCommand.ts index a744dcaf99518..19a1a88ad15b9 100644 --- a/clients/client-docdb/commands/DescribeDBClusterParametersCommand.ts +++ b/clients/client-docdb/commands/DescribeDBClusterParametersCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDBClusterParametersCommandInput = DescribeDBClusterParametersMessage; export type DescribeDBClusterParametersCommandOutput = DBClusterParameterGroupDetails & __MetadataBearer; +/** + *

Returns the detailed parameter list for a particular cluster parameter + * group.

+ */ export class DescribeDBClusterParametersCommand extends $Command< DescribeDBClusterParametersCommandInput, DescribeDBClusterParametersCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDBClusterParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeDBClusterSnapshotAttributesCommand.ts b/clients/client-docdb/commands/DescribeDBClusterSnapshotAttributesCommand.ts index 4386ef0970dca..23b7f01e7d79b 100644 --- a/clients/client-docdb/commands/DescribeDBClusterSnapshotAttributesCommand.ts +++ b/clients/client-docdb/commands/DescribeDBClusterSnapshotAttributesCommand.ts @@ -24,6 +24,16 @@ export type DescribeDBClusterSnapshotAttributesCommandInput = DescribeDBClusterS export type DescribeDBClusterSnapshotAttributesCommandOutput = DescribeDBClusterSnapshotAttributesResult & __MetadataBearer; +/** + *

Returns a list of cluster snapshot attribute names and values for a manual DB + * cluster snapshot.

+ *

When you share snapshots with other AWS accounts, + * DescribeDBClusterSnapshotAttributes returns the restore + * attribute and a list of IDs for the AWS accounts that are authorized to copy or restore + * the manual cluster snapshot. If all is included in the list of values + * for the restore attribute, then the manual cluster snapshot is public + * and can be copied or restored by all AWS accounts.

+ */ export class DescribeDBClusterSnapshotAttributesCommand extends $Command< DescribeDBClusterSnapshotAttributesCommandInput, DescribeDBClusterSnapshotAttributesCommandOutput, @@ -38,6 +48,9 @@ export class DescribeDBClusterSnapshotAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeDBClusterSnapshotsCommand.ts b/clients/client-docdb/commands/DescribeDBClusterSnapshotsCommand.ts index f3efbc519597c..b98c10352771f 100644 --- a/clients/client-docdb/commands/DescribeDBClusterSnapshotsCommand.ts +++ b/clients/client-docdb/commands/DescribeDBClusterSnapshotsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDBClusterSnapshotsCommandInput = DescribeDBClusterSnapshotsMessage; export type DescribeDBClusterSnapshotsCommandOutput = DBClusterSnapshotMessage & __MetadataBearer; +/** + *

Returns information about cluster snapshots. This API operation supports + * pagination.

+ */ export class DescribeDBClusterSnapshotsCommand extends $Command< DescribeDBClusterSnapshotsCommandInput, DescribeDBClusterSnapshotsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDBClusterSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeDBClustersCommand.ts b/clients/client-docdb/commands/DescribeDBClustersCommand.ts index 7935876cd2262..b6ffc75e65a24 100644 --- a/clients/client-docdb/commands/DescribeDBClustersCommand.ts +++ b/clients/client-docdb/commands/DescribeDBClustersCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeDBClustersCommandInput = DescribeDBClustersMessage; export type DescribeDBClustersCommandOutput = DBClusterMessage & __MetadataBearer; +/** + *

Returns information about provisioned Amazon DocumentDB clusters. This API + * operation supports pagination. For certain management features + * such as cluster and instance lifecycle management, Amazon DocumentDB leverages + * operational technology that is shared with Amazon RDS and Amazon + * Neptune. Use the filterName=engine,Values=docdb filter + * parameter to return only Amazon DocumentDB clusters.

+ */ export class DescribeDBClustersCommand extends $Command< DescribeDBClustersCommandInput, DescribeDBClustersCommandOutput, @@ -34,6 +42,9 @@ export class DescribeDBClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeDBEngineVersionsCommand.ts b/clients/client-docdb/commands/DescribeDBEngineVersionsCommand.ts index 907fe513b9227..35f3493d331ae 100644 --- a/clients/client-docdb/commands/DescribeDBEngineVersionsCommand.ts +++ b/clients/client-docdb/commands/DescribeDBEngineVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBEngineVersionsCommandInput = DescribeDBEngineVersionsMessage; export type DescribeDBEngineVersionsCommandOutput = DBEngineVersionMessage & __MetadataBearer; +/** + *

Returns a list of the available engines.

+ */ export class DescribeDBEngineVersionsCommand extends $Command< DescribeDBEngineVersionsCommandInput, DescribeDBEngineVersionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBEngineVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeDBInstancesCommand.ts b/clients/client-docdb/commands/DescribeDBInstancesCommand.ts index c4d55ab14a3a6..2303f0dfef89c 100644 --- a/clients/client-docdb/commands/DescribeDBInstancesCommand.ts +++ b/clients/client-docdb/commands/DescribeDBInstancesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDBInstancesCommandInput = DescribeDBInstancesMessage; export type DescribeDBInstancesCommandOutput = DBInstanceMessage & __MetadataBearer; +/** + *

Returns information about provisioned Amazon DocumentDB instances. This API supports + * pagination.

+ */ export class DescribeDBInstancesCommand extends $Command< DescribeDBInstancesCommandInput, DescribeDBInstancesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDBInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeDBSubnetGroupsCommand.ts b/clients/client-docdb/commands/DescribeDBSubnetGroupsCommand.ts index 26a2304bf4ef9..b9f7e3ba8e14b 100644 --- a/clients/client-docdb/commands/DescribeDBSubnetGroupsCommand.ts +++ b/clients/client-docdb/commands/DescribeDBSubnetGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDBSubnetGroupsCommandInput = DescribeDBSubnetGroupsMessage; export type DescribeDBSubnetGroupsCommandOutput = DBSubnetGroupMessage & __MetadataBearer; +/** + *

Returns a list of DBSubnetGroup descriptions. If a + * DBSubnetGroupName is specified, the list will contain only the + * descriptions of the specified DBSubnetGroup.

+ */ export class DescribeDBSubnetGroupsCommand extends $Command< DescribeDBSubnetGroupsCommandInput, DescribeDBSubnetGroupsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDBSubnetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeEngineDefaultClusterParametersCommand.ts b/clients/client-docdb/commands/DescribeEngineDefaultClusterParametersCommand.ts index 3abce1cd94fd4..ad4e731c701b9 100644 --- a/clients/client-docdb/commands/DescribeEngineDefaultClusterParametersCommand.ts +++ b/clients/client-docdb/commands/DescribeEngineDefaultClusterParametersCommand.ts @@ -24,6 +24,10 @@ export type DescribeEngineDefaultClusterParametersCommandInput = DescribeEngineD export type DescribeEngineDefaultClusterParametersCommandOutput = DescribeEngineDefaultClusterParametersResult & __MetadataBearer; +/** + *

Returns the default engine and system parameter information for the cluster database + * engine.

+ */ export class DescribeEngineDefaultClusterParametersCommand extends $Command< DescribeEngineDefaultClusterParametersCommandInput, DescribeEngineDefaultClusterParametersCommandOutput, @@ -38,6 +42,9 @@ export class DescribeEngineDefaultClusterParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeEventCategoriesCommand.ts b/clients/client-docdb/commands/DescribeEventCategoriesCommand.ts index 324873342085d..03fdd98cdaeca 100644 --- a/clients/client-docdb/commands/DescribeEventCategoriesCommand.ts +++ b/clients/client-docdb/commands/DescribeEventCategoriesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEventCategoriesCommandInput = DescribeEventCategoriesMessage; export type DescribeEventCategoriesCommandOutput = EventCategoriesMessage & __MetadataBearer; +/** + *

Displays a list of categories for all event source types, or, if specified, for a + * specified source type.

+ */ export class DescribeEventCategoriesCommand extends $Command< DescribeEventCategoriesCommandInput, DescribeEventCategoriesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEventCategoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeEventsCommand.ts b/clients/client-docdb/commands/DescribeEventsCommand.ts index cdcb9e72093cf..59b937e92e459 100644 --- a/clients/client-docdb/commands/DescribeEventsCommand.ts +++ b/clients/client-docdb/commands/DescribeEventsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeEventsCommandInput = DescribeEventsMessage; export type DescribeEventsCommandOutput = EventsMessage & __MetadataBearer; +/** + *

Returns events related to instances, security groups, snapshots, and DB + * parameter groups for the past 14 days. You can obtain events specific to a particular DB + * instance, security group, snapshot, or parameter group by providing the name as + * a parameter. By default, the events of the past hour are returned.

+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribeOrderableDBInstanceOptionsCommand.ts b/clients/client-docdb/commands/DescribeOrderableDBInstanceOptionsCommand.ts index a064aec39755d..627eaba451668 100644 --- a/clients/client-docdb/commands/DescribeOrderableDBInstanceOptionsCommand.ts +++ b/clients/client-docdb/commands/DescribeOrderableDBInstanceOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOrderableDBInstanceOptionsCommandInput = DescribeOrderableDBInstanceOptionsMessage; export type DescribeOrderableDBInstanceOptionsCommandOutput = OrderableDBInstanceOptionsMessage & __MetadataBearer; +/** + *

Returns a list of orderable instance options for the specified engine.

+ */ export class DescribeOrderableDBInstanceOptionsCommand extends $Command< DescribeOrderableDBInstanceOptionsCommandInput, DescribeOrderableDBInstanceOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOrderableDBInstanceOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/DescribePendingMaintenanceActionsCommand.ts b/clients/client-docdb/commands/DescribePendingMaintenanceActionsCommand.ts index be3250f0f3886..c74580bc77e48 100644 --- a/clients/client-docdb/commands/DescribePendingMaintenanceActionsCommand.ts +++ b/clients/client-docdb/commands/DescribePendingMaintenanceActionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribePendingMaintenanceActionsCommandInput = DescribePendingMaintenanceActionsMessage; export type DescribePendingMaintenanceActionsCommandOutput = PendingMaintenanceActionsMessage & __MetadataBearer; +/** + *

Returns a list of resources (for example, instances) that have at least one pending + * maintenance action.

+ */ export class DescribePendingMaintenanceActionsCommand extends $Command< DescribePendingMaintenanceActionsCommandInput, DescribePendingMaintenanceActionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribePendingMaintenanceActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/FailoverDBClusterCommand.ts b/clients/client-docdb/commands/FailoverDBClusterCommand.ts index aa03a9629390b..207a064dd055d 100644 --- a/clients/client-docdb/commands/FailoverDBClusterCommand.ts +++ b/clients/client-docdb/commands/FailoverDBClusterCommand.ts @@ -20,6 +20,15 @@ import { export type FailoverDBClusterCommandInput = FailoverDBClusterMessage; export type FailoverDBClusterCommandOutput = FailoverDBClusterResult & __MetadataBearer; +/** + *

Forces a failover for a cluster.

+ *

A failover for a cluster promotes one of the Amazon DocumentDB replicas (read-only instances) + * in the cluster to be the primary instance (the cluster writer).

+ *

If the primary instance fails, Amazon DocumentDB automatically fails over to an Amazon DocumentDB replica, + * if one exists. You can force a failover when you want to simulate a failure of a primary + * instance for + * testing.

+ */ export class FailoverDBClusterCommand extends $Command< FailoverDBClusterCommandInput, FailoverDBClusterCommandOutput, @@ -34,6 +43,9 @@ export class FailoverDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/ListTagsForResourceCommand.ts b/clients/client-docdb/commands/ListTagsForResourceCommand.ts index dfd7da5bcc659..94dae1b6f79ea 100644 --- a/clients/client-docdb/commands/ListTagsForResourceCommand.ts +++ b/clients/client-docdb/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceMessage; export type ListTagsForResourceCommandOutput = TagListMessage & __MetadataBearer; +/** + *

Lists all tags on an Amazon DocumentDB resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/ModifyDBClusterCommand.ts b/clients/client-docdb/commands/ModifyDBClusterCommand.ts index fbb0c301942ba..801a68acc5829 100644 --- a/clients/client-docdb/commands/ModifyDBClusterCommand.ts +++ b/clients/client-docdb/commands/ModifyDBClusterCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyDBClusterCommandInput = ModifyDBClusterMessage; export type ModifyDBClusterCommandOutput = ModifyDBClusterResult & __MetadataBearer; +/** + *

Modifies a setting for an Amazon DocumentDB cluster. You can change one or more database + * configuration parameters by specifying these parameters and the new values in the + * request.

+ */ export class ModifyDBClusterCommand extends $Command< ModifyDBClusterCommandInput, ModifyDBClusterCommandOutput, @@ -34,6 +39,9 @@ export class ModifyDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/ModifyDBClusterParameterGroupCommand.ts b/clients/client-docdb/commands/ModifyDBClusterParameterGroupCommand.ts index ec083f6fe5f44..0eb5a90219f15 100644 --- a/clients/client-docdb/commands/ModifyDBClusterParameterGroupCommand.ts +++ b/clients/client-docdb/commands/ModifyDBClusterParameterGroupCommand.ts @@ -20,6 +20,27 @@ import { export type ModifyDBClusterParameterGroupCommandInput = ModifyDBClusterParameterGroupMessage; export type ModifyDBClusterParameterGroupCommandOutput = DBClusterParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a cluster parameter group. To modify more than one + * parameter, submit a list of the following: ParameterName, + * ParameterValue, and ApplyMethod. A maximum of 20 + * parameters can be modified in a single request.

+ * + *

Changes to dynamic parameters are applied immediately. Changes to static + * parameters require a reboot or maintenance window + * + * before the change can take effect.

+ *
+ * + *

After you create a cluster parameter group, you should wait at least 5 minutes + * before creating your first cluster that uses that cluster parameter group as + * the default parameter group. This allows Amazon DocumentDB to fully complete the create action + * before the parameter group is used as the default for a new cluster. This step is + * especially important for parameters that are critical when creating the default + * database for a cluster, such as the character set for the default database + * defined by the character_set_database parameter.

+ *
+ */ export class ModifyDBClusterParameterGroupCommand extends $Command< ModifyDBClusterParameterGroupCommandInput, ModifyDBClusterParameterGroupCommandOutput, @@ -34,6 +55,9 @@ export class ModifyDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/ModifyDBClusterSnapshotAttributeCommand.ts b/clients/client-docdb/commands/ModifyDBClusterSnapshotAttributeCommand.ts index 373f9c871e84a..c3cd7ec571bc0 100644 --- a/clients/client-docdb/commands/ModifyDBClusterSnapshotAttributeCommand.ts +++ b/clients/client-docdb/commands/ModifyDBClusterSnapshotAttributeCommand.ts @@ -20,6 +20,21 @@ import { export type ModifyDBClusterSnapshotAttributeCommandInput = ModifyDBClusterSnapshotAttributeMessage; export type ModifyDBClusterSnapshotAttributeCommandOutput = ModifyDBClusterSnapshotAttributeResult & __MetadataBearer; +/** + *

Adds an attribute and values to, or removes an attribute and values from, a manual DB + * cluster snapshot.

+ *

To share a manual cluster snapshot with other AWS accounts, specify + * restore as the AttributeName, and use the + * ValuesToAdd parameter to add a list of IDs of the AWS accounts that are + * authorized to restore the manual cluster snapshot. Use the value all to + * make the manual cluster snapshot public, which means that it can be copied or + * restored by all AWS accounts. Do not add the all value for any manual DB + * cluster snapshots that contain private information that you don't want available to all + * AWS accounts. If a manual cluster snapshot is encrypted, it can be shared, but only + * by specifying a list of authorized AWS account IDs for the ValuesToAdd + * parameter. You can't use all as a value for that parameter in this + * case.

+ */ export class ModifyDBClusterSnapshotAttributeCommand extends $Command< ModifyDBClusterSnapshotAttributeCommandInput, ModifyDBClusterSnapshotAttributeCommandOutput, @@ -34,6 +49,9 @@ export class ModifyDBClusterSnapshotAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/ModifyDBInstanceCommand.ts b/clients/client-docdb/commands/ModifyDBInstanceCommand.ts index 13bc99ea7ed0e..0f52cd34b5dff 100644 --- a/clients/client-docdb/commands/ModifyDBInstanceCommand.ts +++ b/clients/client-docdb/commands/ModifyDBInstanceCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyDBInstanceCommandInput = ModifyDBInstanceMessage; export type ModifyDBInstanceCommandOutput = ModifyDBInstanceResult & __MetadataBearer; +/** + *

Modifies settings for an instance. You can change one or more database configuration + * parameters by specifying these parameters and the new values in the request.

+ */ export class ModifyDBInstanceCommand extends $Command< ModifyDBInstanceCommandInput, ModifyDBInstanceCommandOutput, @@ -34,6 +38,9 @@ export class ModifyDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/ModifyDBSubnetGroupCommand.ts b/clients/client-docdb/commands/ModifyDBSubnetGroupCommand.ts index 12d1b85f47cd8..7fb54340124e4 100644 --- a/clients/client-docdb/commands/ModifyDBSubnetGroupCommand.ts +++ b/clients/client-docdb/commands/ModifyDBSubnetGroupCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyDBSubnetGroupCommandInput = ModifyDBSubnetGroupMessage; export type ModifyDBSubnetGroupCommandOutput = ModifyDBSubnetGroupResult & __MetadataBearer; +/** + *

Modifies an existing subnet group. subnet groups must contain at least one + * subnet in at least two Availability Zones in the AWS Region.

+ */ export class ModifyDBSubnetGroupCommand extends $Command< ModifyDBSubnetGroupCommandInput, ModifyDBSubnetGroupCommandOutput, @@ -34,6 +38,9 @@ export class ModifyDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/RebootDBInstanceCommand.ts b/clients/client-docdb/commands/RebootDBInstanceCommand.ts index 3809964cfdeda..35b8a8d6178fb 100644 --- a/clients/client-docdb/commands/RebootDBInstanceCommand.ts +++ b/clients/client-docdb/commands/RebootDBInstanceCommand.ts @@ -20,6 +20,15 @@ import { export type RebootDBInstanceCommandInput = RebootDBInstanceMessage; export type RebootDBInstanceCommandOutput = RebootDBInstanceResult & __MetadataBearer; +/** + *

You might need to reboot your instance, usually for maintenance reasons. For + * example, if you make certain changes, or if you change the cluster parameter group + * that is associated with the instance, you must reboot the instance for the changes to + * take effect.

+ *

Rebooting an instance restarts the database engine service. Rebooting an instance + * results in a momentary outage, during which the instance status is set to + * rebooting.

+ */ export class RebootDBInstanceCommand extends $Command< RebootDBInstanceCommandInput, RebootDBInstanceCommandOutput, @@ -34,6 +43,9 @@ export class RebootDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/RemoveTagsFromResourceCommand.ts b/clients/client-docdb/commands/RemoveTagsFromResourceCommand.ts index 9cdd6285cefbb..0e9596104cc12 100644 --- a/clients/client-docdb/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-docdb/commands/RemoveTagsFromResourceCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceMessage; export type RemoveTagsFromResourceCommandOutput = __MetadataBearer; +/** + *

Removes metadata tags from an Amazon DocumentDB resource.

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -34,6 +37,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/ResetDBClusterParameterGroupCommand.ts b/clients/client-docdb/commands/ResetDBClusterParameterGroupCommand.ts index d1a0ab895a335..401f9de600c53 100644 --- a/clients/client-docdb/commands/ResetDBClusterParameterGroupCommand.ts +++ b/clients/client-docdb/commands/ResetDBClusterParameterGroupCommand.ts @@ -20,6 +20,16 @@ import { export type ResetDBClusterParameterGroupCommandInput = ResetDBClusterParameterGroupMessage; export type ResetDBClusterParameterGroupCommandOutput = DBClusterParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a cluster parameter group to the default value. To + * reset specific parameters, submit a list of the following: ParameterName + * and ApplyMethod. To reset the entire cluster parameter group, specify + * the DBClusterParameterGroupName and ResetAllParameters + * parameters.

+ *

When you reset the entire group, dynamic parameters are updated immediately and + * static parameters are set to pending-reboot to take effect on the next DB + * instance reboot.

+ */ export class ResetDBClusterParameterGroupCommand extends $Command< ResetDBClusterParameterGroupCommandInput, ResetDBClusterParameterGroupCommandOutput, @@ -34,6 +44,9 @@ export class ResetDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/RestoreDBClusterFromSnapshotCommand.ts b/clients/client-docdb/commands/RestoreDBClusterFromSnapshotCommand.ts index c721e2066a104..eea9f722cc640 100644 --- a/clients/client-docdb/commands/RestoreDBClusterFromSnapshotCommand.ts +++ b/clients/client-docdb/commands/RestoreDBClusterFromSnapshotCommand.ts @@ -20,6 +20,15 @@ import { export type RestoreDBClusterFromSnapshotCommandInput = RestoreDBClusterFromSnapshotMessage; export type RestoreDBClusterFromSnapshotCommandOutput = RestoreDBClusterFromSnapshotResult & __MetadataBearer; +/** + *

Creates a new cluster from a snapshot or cluster snapshot.

+ *

If a snapshot is specified, the target cluster is created from the source DB + * snapshot with a default configuration and default security group.

+ *

If a cluster snapshot is specified, the target cluster is created from the + * source cluster restore point with the same configuration as the original source DB + * cluster, except that the new cluster is created with the default security + * group.

+ */ export class RestoreDBClusterFromSnapshotCommand extends $Command< RestoreDBClusterFromSnapshotCommandInput, RestoreDBClusterFromSnapshotCommandOutput, @@ -34,6 +43,9 @@ export class RestoreDBClusterFromSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/RestoreDBClusterToPointInTimeCommand.ts b/clients/client-docdb/commands/RestoreDBClusterToPointInTimeCommand.ts index cb8d17b2a8a5d..9a3c8f571f099 100644 --- a/clients/client-docdb/commands/RestoreDBClusterToPointInTimeCommand.ts +++ b/clients/client-docdb/commands/RestoreDBClusterToPointInTimeCommand.ts @@ -20,6 +20,13 @@ import { export type RestoreDBClusterToPointInTimeCommandInput = RestoreDBClusterToPointInTimeMessage; export type RestoreDBClusterToPointInTimeCommandOutput = RestoreDBClusterToPointInTimeResult & __MetadataBearer; +/** + *

Restores a cluster to an arbitrary point in time. Users can restore to any point in + * time before LatestRestorableTime for up to + * BackupRetentionPeriod days. The target cluster is created from the + * source cluster with the same configuration as the original cluster, except that + * the new cluster is created with the default security group.

+ */ export class RestoreDBClusterToPointInTimeCommand extends $Command< RestoreDBClusterToPointInTimeCommandInput, RestoreDBClusterToPointInTimeCommandOutput, @@ -34,6 +41,9 @@ export class RestoreDBClusterToPointInTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/StartDBClusterCommand.ts b/clients/client-docdb/commands/StartDBClusterCommand.ts index 088654b2ce053..84beef46f55dc 100644 --- a/clients/client-docdb/commands/StartDBClusterCommand.ts +++ b/clients/client-docdb/commands/StartDBClusterCommand.ts @@ -20,6 +20,11 @@ import { export type StartDBClusterCommandInput = StartDBClusterMessage; export type StartDBClusterCommandOutput = StartDBClusterResult & __MetadataBearer; +/** + *

Restarts the stopped cluster that is specified by DBClusterIdentifier. + * For more information, see Stopping and + * Starting an Amazon DocumentDB Cluster.

+ */ export class StartDBClusterCommand extends $Command< StartDBClusterCommandInput, StartDBClusterCommandOutput, @@ -34,6 +39,9 @@ export class StartDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/commands/StopDBClusterCommand.ts b/clients/client-docdb/commands/StopDBClusterCommand.ts index ce68bdfaf4f43..477532a7ecf13 100644 --- a/clients/client-docdb/commands/StopDBClusterCommand.ts +++ b/clients/client-docdb/commands/StopDBClusterCommand.ts @@ -20,6 +20,12 @@ import { export type StopDBClusterCommandInput = StopDBClusterMessage; export type StopDBClusterCommandOutput = StopDBClusterResult & __MetadataBearer; +/** + *

Stops the running cluster that is specified by DBClusterIdentifier. The + * cluster must be in the available state. For more information, see + * Stopping and + * Starting an Amazon DocumentDB Cluster.

+ */ export class StopDBClusterCommand extends $Command< StopDBClusterCommandInput, StopDBClusterCommandOutput, @@ -34,6 +40,9 @@ export class StopDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DocDBClientResolvedConfig, diff --git a/clients/client-docdb/package.json b/clients/client-docdb/package.json index 713e63c5a8816..fa6a1b2ac27b8 100644 --- a/clients/client-docdb/package.json +++ b/clients/client-docdb/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Docdb Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-docdb/pagination/DescribeCertificatesPaginator.ts b/clients/client-docdb/pagination/DescribeCertificatesPaginator.ts index 4225fc983d97a..5f2475273a3e6 100644 --- a/clients/client-docdb/pagination/DescribeCertificatesPaginator.ts +++ b/clients/client-docdb/pagination/DescribeCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeCertificatesCommandInput, diff --git a/clients/client-docdb/pagination/DescribeDBClusterParameterGroupsPaginator.ts b/clients/client-docdb/pagination/DescribeDBClusterParameterGroupsPaginator.ts index d4672256f0475..f661bd8075a43 100644 --- a/clients/client-docdb/pagination/DescribeDBClusterParameterGroupsPaginator.ts +++ b/clients/client-docdb/pagination/DescribeDBClusterParameterGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeDBClusterParameterGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterParameterGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeDBClusterParameterGroupsCommandInput, diff --git a/clients/client-docdb/pagination/DescribeDBClusterParametersPaginator.ts b/clients/client-docdb/pagination/DescribeDBClusterParametersPaginator.ts index 93a4cd401ecd6..6d9c1786d8ca3 100644 --- a/clients/client-docdb/pagination/DescribeDBClusterParametersPaginator.ts +++ b/clients/client-docdb/pagination/DescribeDBClusterParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeDBClusterParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeDBClusterParametersCommandInput, diff --git a/clients/client-docdb/pagination/DescribeDBClusterSnapshotsPaginator.ts b/clients/client-docdb/pagination/DescribeDBClusterSnapshotsPaginator.ts index 8fbc5c8308e3c..4558b6d8a234c 100644 --- a/clients/client-docdb/pagination/DescribeDBClusterSnapshotsPaginator.ts +++ b/clients/client-docdb/pagination/DescribeDBClusterSnapshotsPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeDBClusterSnapshotsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterSnapshotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeDBClusterSnapshotsCommandInput, diff --git a/clients/client-docdb/pagination/DescribeDBClustersPaginator.ts b/clients/client-docdb/pagination/DescribeDBClustersPaginator.ts index f3e037907f22b..f4633df01d3b2 100644 --- a/clients/client-docdb/pagination/DescribeDBClustersPaginator.ts +++ b/clients/client-docdb/pagination/DescribeDBClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeDBClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeDBClustersCommandInput, diff --git a/clients/client-docdb/pagination/DescribeDBEngineVersionsPaginator.ts b/clients/client-docdb/pagination/DescribeDBEngineVersionsPaginator.ts index 0f91501394166..acb14637ce992 100644 --- a/clients/client-docdb/pagination/DescribeDBEngineVersionsPaginator.ts +++ b/clients/client-docdb/pagination/DescribeDBEngineVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeDBEngineVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBEngineVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeDBEngineVersionsCommandInput, diff --git a/clients/client-docdb/pagination/DescribeDBInstancesPaginator.ts b/clients/client-docdb/pagination/DescribeDBInstancesPaginator.ts index fd82a00816b85..9fb97e5b83fbe 100644 --- a/clients/client-docdb/pagination/DescribeDBInstancesPaginator.ts +++ b/clients/client-docdb/pagination/DescribeDBInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeDBInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeDBInstancesCommandInput, diff --git a/clients/client-docdb/pagination/DescribeDBSubnetGroupsPaginator.ts b/clients/client-docdb/pagination/DescribeDBSubnetGroupsPaginator.ts index ce57935eaaa0f..b12d859351b7e 100644 --- a/clients/client-docdb/pagination/DescribeDBSubnetGroupsPaginator.ts +++ b/clients/client-docdb/pagination/DescribeDBSubnetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeDBSubnetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBSubnetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeDBSubnetGroupsCommandInput, diff --git a/clients/client-docdb/pagination/DescribeEventsPaginator.ts b/clients/client-docdb/pagination/DescribeEventsPaginator.ts index 85cf707ad9904..e8ef850cfdb52 100644 --- a/clients/client-docdb/pagination/DescribeEventsPaginator.ts +++ b/clients/client-docdb/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeEventsCommandInput, diff --git a/clients/client-docdb/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts b/clients/client-docdb/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts index 04048ad478fd1..87749bdceca58 100644 --- a/clients/client-docdb/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts +++ b/clients/client-docdb/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribeOrderableDBInstanceOptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOrderableDBInstanceOptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribeOrderableDBInstanceOptionsCommandInput, diff --git a/clients/client-docdb/pagination/DescribePendingMaintenanceActionsPaginator.ts b/clients/client-docdb/pagination/DescribePendingMaintenanceActionsPaginator.ts index 30f9e1582e8ca..f6717fa92be27 100644 --- a/clients/client-docdb/pagination/DescribePendingMaintenanceActionsPaginator.ts +++ b/clients/client-docdb/pagination/DescribePendingMaintenanceActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { DocDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DocDBClient, input: DescribePendingMaintenanceActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePendingMaintenanceActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DocDB, input: DescribePendingMaintenanceActionsCommandInput, diff --git a/clients/client-docdb/runtimeConfig.browser.ts b/clients/client-docdb/runtimeConfig.browser.ts index 9d42437d375f5..ac5a5988db086 100644 --- a/clients/client-docdb/runtimeConfig.browser.ts +++ b/clients/client-docdb/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DocDBClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-docdb/runtimeConfig.native.ts b/clients/client-docdb/runtimeConfig.native.ts index 13cd9e75d29bb..3ad2a39f55414 100644 --- a/clients/client-docdb/runtimeConfig.native.ts +++ b/clients/client-docdb/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DocDBClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-docdb/runtimeConfig.shared.ts b/clients/client-docdb/runtimeConfig.shared.ts index 6c5afd6f19a75..7331c29e5ee1a 100644 --- a/clients/client-docdb/runtimeConfig.shared.ts +++ b/clients/client-docdb/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-10-31", disableHostPrefix: false, diff --git a/clients/client-docdb/runtimeConfig.ts b/clients/client-docdb/runtimeConfig.ts index 3c0386629cbd9..5e82f963d1fea 100644 --- a/clients/client-docdb/runtimeConfig.ts +++ b/clients/client-docdb/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DocDBClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-docdb/tsconfig.json b/clients/client-docdb/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-docdb/tsconfig.json +++ b/clients/client-docdb/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-dynamodb-streams/commands/DescribeStreamCommand.ts b/clients/client-dynamodb-streams/commands/DescribeStreamCommand.ts index 2ee0056fe5b1f..ed9414643cddf 100644 --- a/clients/client-dynamodb-streams/commands/DescribeStreamCommand.ts +++ b/clients/client-dynamodb-streams/commands/DescribeStreamCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeStreamCommandInput = DescribeStreamInput; export type DescribeStreamCommandOutput = DescribeStreamOutput & __MetadataBearer; +/** + *

Returns information about a stream, including the current status of the stream, its Amazon Resource Name (ARN), the composition of its shards, and its corresponding DynamoDB table.

+ * + *

You can call DescribeStream at a maximum rate of 10 times per second.

+ *
+ *

Each shard in the stream has a SequenceNumberRange associated with it. If the + * SequenceNumberRange has a StartingSequenceNumber but no + * EndingSequenceNumber, then the shard is still open (able to receive more stream + * records). If both StartingSequenceNumber and EndingSequenceNumber + * are present, then that shard is closed and can no longer receive more data.

+ */ export class DescribeStreamCommand extends $Command< DescribeStreamCommandInput, DescribeStreamCommandOutput, @@ -34,6 +45,9 @@ export class DescribeStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBStreamsClientResolvedConfig, diff --git a/clients/client-dynamodb-streams/commands/GetRecordsCommand.ts b/clients/client-dynamodb-streams/commands/GetRecordsCommand.ts index 30cfb18c99627..358759207e40c 100644 --- a/clients/client-dynamodb-streams/commands/GetRecordsCommand.ts +++ b/clients/client-dynamodb-streams/commands/GetRecordsCommand.ts @@ -20,6 +20,19 @@ import { export type GetRecordsCommandInput = GetRecordsInput; export type GetRecordsCommandOutput = GetRecordsOutput & __MetadataBearer; +/** + *

Retrieves the stream records from a given shard.

+ *

Specify a shard iterator using the ShardIterator parameter. The shard iterator + * specifies the position in the shard from which you want to start reading stream records + * sequentially. If there are no stream records available in the portion of the shard that the + * iterator points to, GetRecords returns an empty list. Note that it might take + * multiple calls to get to a portion of the shard that contains stream records.

+ * + *

+ * GetRecords can retrieve a maximum of 1 MB of data or 1000 stream records, + * whichever comes first.

+ *
+ */ export class GetRecordsCommand extends $Command< GetRecordsCommandInput, GetRecordsCommandOutput, @@ -34,6 +47,9 @@ export class GetRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBStreamsClientResolvedConfig, diff --git a/clients/client-dynamodb-streams/commands/GetShardIteratorCommand.ts b/clients/client-dynamodb-streams/commands/GetShardIteratorCommand.ts index f78faebaa9f01..6a5a046b13062 100644 --- a/clients/client-dynamodb-streams/commands/GetShardIteratorCommand.ts +++ b/clients/client-dynamodb-streams/commands/GetShardIteratorCommand.ts @@ -20,6 +20,16 @@ import { export type GetShardIteratorCommandInput = GetShardIteratorInput; export type GetShardIteratorCommandOutput = GetShardIteratorOutput & __MetadataBearer; +/** + *

Returns a shard iterator. A shard iterator provides information + * about how to retrieve the stream records from within a shard. Use + * the shard iterator in a subsequent + * GetRecords request to read the stream records + * from the shard.

+ * + *

A shard iterator expires 15 minutes after it is returned to the requester.

+ *
+ */ export class GetShardIteratorCommand extends $Command< GetShardIteratorCommandInput, GetShardIteratorCommandOutput, @@ -34,6 +44,9 @@ export class GetShardIteratorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBStreamsClientResolvedConfig, diff --git a/clients/client-dynamodb-streams/commands/ListStreamsCommand.ts b/clients/client-dynamodb-streams/commands/ListStreamsCommand.ts index 6e05b27451082..347b9d8a11ae3 100644 --- a/clients/client-dynamodb-streams/commands/ListStreamsCommand.ts +++ b/clients/client-dynamodb-streams/commands/ListStreamsCommand.ts @@ -20,6 +20,14 @@ import { export type ListStreamsCommandInput = ListStreamsInput; export type ListStreamsCommandOutput = ListStreamsOutput & __MetadataBearer; +/** + *

Returns an array of stream ARNs associated with the current account and endpoint. If the + * TableName parameter is present, then ListStreams will return only the + * streams ARNs for that table.

+ * + *

You can call ListStreams at a maximum rate of 5 times per second.

+ *
+ */ export class ListStreamsCommand extends $Command< ListStreamsCommandInput, ListStreamsCommandOutput, @@ -34,6 +42,9 @@ export class ListStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBStreamsClientResolvedConfig, diff --git a/clients/client-dynamodb-streams/package.json b/clients/client-dynamodb-streams/package.json index 29d2fc9c8791e..a6fc6e951f8b9 100644 --- a/clients/client-dynamodb-streams/package.json +++ b/clients/client-dynamodb-streams/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Dynamodb Streams Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-dynamodb-streams/runtimeConfig.browser.ts b/clients/client-dynamodb-streams/runtimeConfig.browser.ts index 7554332ccc86a..208ca5607300a 100644 --- a/clients/client-dynamodb-streams/runtimeConfig.browser.ts +++ b/clients/client-dynamodb-streams/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DynamoDBStreamsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-dynamodb-streams/runtimeConfig.native.ts b/clients/client-dynamodb-streams/runtimeConfig.native.ts index 882ef845ee9e3..1acb3d688fbab 100644 --- a/clients/client-dynamodb-streams/runtimeConfig.native.ts +++ b/clients/client-dynamodb-streams/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DynamoDBStreamsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-dynamodb-streams/runtimeConfig.shared.ts b/clients/client-dynamodb-streams/runtimeConfig.shared.ts index 0a74274d52b1f..5621b7688c7f8 100644 --- a/clients/client-dynamodb-streams/runtimeConfig.shared.ts +++ b/clients/client-dynamodb-streams/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-08-10", disableHostPrefix: false, diff --git a/clients/client-dynamodb-streams/runtimeConfig.ts b/clients/client-dynamodb-streams/runtimeConfig.ts index 0b1a40bba78a7..3338b79dcebdf 100644 --- a/clients/client-dynamodb-streams/runtimeConfig.ts +++ b/clients/client-dynamodb-streams/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DynamoDBStreamsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-dynamodb-streams/tsconfig.json b/clients/client-dynamodb-streams/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-dynamodb-streams/tsconfig.json +++ b/clients/client-dynamodb-streams/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-dynamodb/commands/BatchGetItemCommand.ts b/clients/client-dynamodb/commands/BatchGetItemCommand.ts index 81077f6e9cf6f..ec8d9dab44cc4 100644 --- a/clients/client-dynamodb/commands/BatchGetItemCommand.ts +++ b/clients/client-dynamodb/commands/BatchGetItemCommand.ts @@ -20,6 +20,54 @@ import { export type BatchGetItemCommandInput = BatchGetItemInput; export type BatchGetItemCommandOutput = BatchGetItemOutput & __MetadataBearer; +/** + *

The BatchGetItem operation returns the attributes of one or more items from one or + * more tables. You identify requested items by primary key.

+ *

A single operation can retrieve up to 16 MB of data, which can contain as many as 100 + * items. BatchGetItem returns a partial result if the response size limit is + * exceeded, the table's provisioned throughput is exceeded, or an internal processing + * failure occurs. If a partial result is returned, the operation returns a value for + * UnprocessedKeys. You can use this value to retry the operation starting + * with the next item to get.

+ * + *

If you request more than 100 items, BatchGetItem returns a + * ValidationException with the message "Too many items requested for + * the BatchGetItem call."

+ *
+ *

For example, if you ask to retrieve 100 items, but each individual item is 300 KB in + * size, the system returns 52 items (so as not to exceed the 16 MB limit). It also returns + * an appropriate UnprocessedKeys value so you can get the next page of + * results. If desired, your application can include its own logic to assemble the pages of + * results into one dataset.

+ *

If none of the items can be processed due to insufficient + * provisioned throughput on all of the tables in the request, then + * BatchGetItem returns a + * ProvisionedThroughputExceededException. If at least + * one of the items is successfully processed, then + * BatchGetItem completes successfully, while returning the keys of the + * unread items in UnprocessedKeys.

+ * + *

If DynamoDB returns any unprocessed items, you should retry the batch operation on those + * items. However, we strongly recommend that you use an exponential backoff algorithm. + * If you retry the batch operation immediately, the underlying read or write requests can + * still fail due to throttling on the individual tables. If you delay the batch operation + * using exponential backoff, the individual requests in the batch are much more likely to + * succeed.

+ *

For more information, see Batch + * Operations and Error Handling in the Amazon DynamoDB Developer Guide.

+ *
+ *

By default, BatchGetItem performs eventually consistent reads on every table in the + * request. If you want strongly consistent reads instead, you can set ConsistentRead to + * true for any or all tables.

+ *

In order to minimize response latency, BatchGetItem retrieves items in parallel.

+ *

When designing your application, keep in mind that DynamoDB does not return items in any + * particular order. To help parse the response by item, include the primary key values for the + * items in your request in the ProjectionExpression parameter.

+ *

If a requested item does not exist, it is not returned in the result. Requests for + * nonexistent items consume the minimum read capacity units according to the type of read. + * For more information, see Working with Tables in the Amazon DynamoDB Developer + * Guide.

+ */ export class BatchGetItemCommand extends $Command< BatchGetItemCommandInput, BatchGetItemCommandOutput, @@ -34,6 +82,9 @@ export class BatchGetItemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/BatchWriteItemCommand.ts b/clients/client-dynamodb/commands/BatchWriteItemCommand.ts index 7129c8bb8253b..0a368e23e2c5a 100644 --- a/clients/client-dynamodb/commands/BatchWriteItemCommand.ts +++ b/clients/client-dynamodb/commands/BatchWriteItemCommand.ts @@ -20,6 +20,83 @@ import { export type BatchWriteItemCommandInput = BatchWriteItemInput; export type BatchWriteItemCommandOutput = BatchWriteItemOutput & __MetadataBearer; +/** + *

The BatchWriteItem operation puts or deletes multiple items in one or more + * tables. A single call to BatchWriteItem can write up to 16 MB of data, + * which can comprise as many as 25 put or delete requests. Individual items to be written + * can be as large as 400 KB.

+ * + *

+ * BatchWriteItem cannot update items. To update items, use the UpdateItem + * action.

+ *
+ *

The individual PutItem and DeleteItem operations specified in + * BatchWriteItem are atomic; however BatchWriteItem as a whole is not. If any + * requested operations fail because the table's provisioned throughput is exceeded or an + * internal processing failure occurs, the failed operations are returned in the + * UnprocessedItems response parameter. You can investigate and optionally resend the + * requests. Typically, you would call BatchWriteItem in a loop. Each iteration would + * check for unprocessed items and submit a new BatchWriteItem request with those + * unprocessed items until all items have been processed.

+ *

If none of the items can be processed due to insufficient + * provisioned throughput on all of the tables in the request, then + * BatchWriteItem returns a + * ProvisionedThroughputExceededException.

+ * + *

If DynamoDB returns any unprocessed items, you should retry the batch operation on those + * items. However, we strongly recommend that you use an exponential backoff algorithm. + * If you retry the batch operation immediately, the underlying read or write requests can + * still fail due to throttling on the individual tables. If you delay the batch operation + * using exponential backoff, the individual requests in the batch are much more likely to + * succeed.

+ *

For more information, see Batch Operations and Error Handling in the Amazon DynamoDB + * Developer Guide.

+ *
+ * + *

With BatchWriteItem, you can efficiently write or delete large amounts of + * data, such as from Amazon EMR, or copy data from another database into DynamoDB. In + * order to improve performance with these large-scale operations, + * BatchWriteItem does not behave in the same way as individual + * PutItem and DeleteItem calls would. For example, you + * cannot specify conditions on individual put and delete requests, and + * BatchWriteItem does not return deleted items in the response.

+ *

If you use a programming language that supports concurrency, you can use + * threads to write items in parallel. Your application must include the necessary logic to + * manage the threads. With languages that don't support threading, you must update + * or delete the specified items one at a time. In both situations, BatchWriteItem + * performs the specified put and delete operations in + * parallel, giving you the power of the thread pool approach without having to introduce + * complexity into your application.

+ *

Parallel processing reduces latency, but each specified put and delete request consumes the same number of write capacity units whether it is processed in parallel or not. Delete operations on nonexistent items consume one write capacity unit.

+ *

If one or more of the following is true, DynamoDB rejects the entire batch write operation:

+ *
    + *
  • + *

    One or more tables specified in the BatchWriteItem request does not exist.

    + *
  • + *
  • + *

    Primary key attributes specified on an item in the request do not match those in the corresponding table's primary key schema.

    + *
  • + *
  • + *

    You try to perform multiple operations on the same item in the same BatchWriteItem + * request. For example, you cannot put and delete the same item in the same + * BatchWriteItem request.

    + *
  • + *
  • + *

    + * Your request contains at least two items with identical hash and range keys (which essentially is two put operations). + *

    + *
  • + *
  • + *

    There are more than 25 requests in the batch.

    + *
  • + *
  • + *

    Any individual item in a batch exceeds 400 KB.

    + *
  • + *
  • + *

    The total request size exceeds 16 MB.

    + *
  • + *
+ */ export class BatchWriteItemCommand extends $Command< BatchWriteItemCommandInput, BatchWriteItemCommandOutput, @@ -34,6 +111,9 @@ export class BatchWriteItemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/CreateBackupCommand.ts b/clients/client-dynamodb/commands/CreateBackupCommand.ts index 4cf49ebb61cfd..c3a025500006a 100644 --- a/clients/client-dynamodb/commands/CreateBackupCommand.ts +++ b/clients/client-dynamodb/commands/CreateBackupCommand.ts @@ -20,6 +20,38 @@ import { export type CreateBackupCommandInput = CreateBackupInput; export type CreateBackupCommandOutput = CreateBackupOutput & __MetadataBearer; +/** + *

Creates a backup for an existing table.

+ *

Each time you create an on-demand backup, the entire table data is backed up. There + * is no limit to the number of on-demand backups that can be taken.

+ *

When you create an on-demand backup, a time marker of the request is cataloged, and + * the backup is created asynchronously, by applying all changes until the time of the + * request to the last full table snapshot. Backup requests are processed instantaneously + * and become available for restore within minutes.

+ *

You can call CreateBackup at a maximum rate of 50 times per second.

+ *

All backups in DynamoDB work without consuming any provisioned throughput on the table.

+ *

If you submit a backup request on 2018-12-14 at 14:25:00, the backup is guaranteed + * to contain all data committed to the table up to 14:24:00, and data committed after + * 14:26:00 will not be. The backup might contain data modifications made between 14:24:00 + * and 14:26:00. On-demand backup does not support causal consistency.

+ *

+ * Along with data, the following are also included on the backups: + *

+ *
    + *
  • + *

    Global secondary indexes (GSIs)

    + *
  • + *
  • + *

    Local secondary indexes (LSIs)

    + *
  • + *
  • + *

    Streams

    + *
  • + *
  • + *

    Provisioned read and write capacity

    + *
  • + *
+ */ export class CreateBackupCommand extends $Command< CreateBackupCommandInput, CreateBackupCommandOutput, @@ -34,6 +66,9 @@ export class CreateBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/CreateGlobalTableCommand.ts b/clients/client-dynamodb/commands/CreateGlobalTableCommand.ts index 9dabcf65c6ad8..9d49b721a8d55 100644 --- a/clients/client-dynamodb/commands/CreateGlobalTableCommand.ts +++ b/clients/client-dynamodb/commands/CreateGlobalTableCommand.ts @@ -20,6 +20,76 @@ import { export type CreateGlobalTableCommandInput = CreateGlobalTableInput; export type CreateGlobalTableCommandOutput = CreateGlobalTableOutput & __MetadataBearer; +/** + *

Creates a global table from an existing table. A global table creates a replication + * relationship between two or more DynamoDB tables with the same table name in the + * provided Regions.

+ * + *

This operation only applies to Version 2017.11.29 of global tables.

+ *
+ * + *

If you want to add a new replica table to a global table, each of the following conditions + * must be true:

+ *
    + *
  • + *

    The table must have the same primary key as all of the other replicas.

    + *
  • + *
  • + *

    The table must have the same name as all of the other replicas.

    + *
  • + *
  • + *

    The table must have DynamoDB Streams enabled, with the stream containing both the new and the old + * images of the item.

    + *
  • + *
  • + *

    None of the replica tables in the global table can contain any data.

    + *
  • + *
+ *

+ * If global secondary indexes are specified, then the following conditions must also be met: + *

+ *
    + *
  • + *

    + * The global secondary indexes must have the same name. + *

    + *
  • + *
  • + *

    + * The global secondary indexes must have the same hash key and sort key (if present). + *

    + *
  • + *
+ *

+ * If local secondary indexes are specified, then the following conditions must also be met: + *

+ *
    + *
  • + *

    + * The local secondary indexes must have the same name. + *

    + *
  • + *
  • + *

    + * The local secondary indexes must have the same hash key and sort key (if present). + *

    + *
  • + *
+ * + * + *

+ * Write capacity settings should be set consistently across your replica tables and + * secondary indexes. DynamoDB strongly recommends enabling auto scaling to manage the write + * capacity settings for all of your global tables replicas and indexes. + *

+ *

+ * If you prefer to manage write capacity settings manually, you should provision equal + * replicated write capacity units to your replica tables. You should also provision + * equal replicated write capacity units to matching secondary indexes across + * your global table. + *

+ *
+ */ export class CreateGlobalTableCommand extends $Command< CreateGlobalTableCommandInput, CreateGlobalTableCommandOutput, @@ -34,6 +104,9 @@ export class CreateGlobalTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/CreateTableCommand.ts b/clients/client-dynamodb/commands/CreateTableCommand.ts index 3aa052d367c79..ad84d3c9f266e 100644 --- a/clients/client-dynamodb/commands/CreateTableCommand.ts +++ b/clients/client-dynamodb/commands/CreateTableCommand.ts @@ -20,6 +20,21 @@ import { export type CreateTableCommandInput = CreateTableInput; export type CreateTableCommandOutput = CreateTableOutput & __MetadataBearer; +/** + *

The CreateTable operation adds a new table to your account. In an AWS + * account, table names must be unique within each Region. That is, you can have two tables + * with same name if you create the tables in different Regions.

+ *

+ * CreateTable is an asynchronous operation. Upon receiving a CreateTable request, + * DynamoDB immediately returns a response with a TableStatus of CREATING. After + * the table is created, DynamoDB sets the TableStatus to ACTIVE. You can + * perform read and write operations only on an ACTIVE table.

+ *

You can optionally define secondary indexes on the new table, as part of the CreateTable + * operation. If you want to create multiple tables with secondary indexes on them, you must create the + * tables sequentially. Only one table with secondary indexes can be in the CREATING state at + * any given time.

+ *

You can use the DescribeTable action to check the table status.

+ */ export class CreateTableCommand extends $Command< CreateTableCommandInput, CreateTableCommandOutput, @@ -34,6 +49,9 @@ export class CreateTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DeleteBackupCommand.ts b/clients/client-dynamodb/commands/DeleteBackupCommand.ts index eca4795dca759..7da622219d617 100644 --- a/clients/client-dynamodb/commands/DeleteBackupCommand.ts +++ b/clients/client-dynamodb/commands/DeleteBackupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteBackupCommandInput = DeleteBackupInput; export type DeleteBackupCommandOutput = DeleteBackupOutput & __MetadataBearer; +/** + *

Deletes an existing backup of a table.

+ *

You can call DeleteBackup at a maximum rate of 10 times per second.

+ */ export class DeleteBackupCommand extends $Command< DeleteBackupCommandInput, DeleteBackupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DeleteItemCommand.ts b/clients/client-dynamodb/commands/DeleteItemCommand.ts index 2eaaa71c571fa..37434d96c638b 100644 --- a/clients/client-dynamodb/commands/DeleteItemCommand.ts +++ b/clients/client-dynamodb/commands/DeleteItemCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteItemCommandInput = DeleteItemInput; export type DeleteItemCommandOutput = DeleteItemOutput & __MetadataBearer; +/** + *

Deletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value.

+ *

In addition to deleting an item, you can also return the item's attribute values in the same + * operation, using the ReturnValues parameter.

+ *

Unless you specify conditions, the DeleteItem is an idempotent operation; running it + * multiple times on the same item or attribute does not result in an error response.

+ *

Conditional deletes are useful for deleting items only if specific conditions are met. If those conditions are met, DynamoDB performs the delete. Otherwise, the item is not deleted.

+ */ export class DeleteItemCommand extends $Command< DeleteItemCommandInput, DeleteItemCommandOutput, @@ -34,6 +42,9 @@ export class DeleteItemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DeleteTableCommand.ts b/clients/client-dynamodb/commands/DeleteTableCommand.ts index d9ecb296cb473..f3660983f61e0 100644 --- a/clients/client-dynamodb/commands/DeleteTableCommand.ts +++ b/clients/client-dynamodb/commands/DeleteTableCommand.ts @@ -20,6 +20,25 @@ import { export type DeleteTableCommandInput = DeleteTableInput; export type DeleteTableCommandOutput = DeleteTableOutput & __MetadataBearer; +/** + *

The DeleteTable operation deletes a table and all of its items. After a + * DeleteTable request, the specified table is in the DELETING state until + * DynamoDB completes the deletion. If the table is in the ACTIVE state, you can delete + * it. If a table is in CREATING or UPDATING states, then DynamoDB returns + * a ResourceInUseException. If the specified table does not exist, DynamoDB returns a + * ResourceNotFoundException. If table is already in the DELETING state, no + * error is returned.

+ * + *

DynamoDB might continue to accept data read and write operations, such as GetItem and + * PutItem, on a table in the DELETING state until the table deletion is + * complete.

+ *
+ *

When you delete a table, any indexes on that table are also deleted.

+ *

If you have DynamoDB Streams enabled on the table, then the corresponding stream on that table goes + * into the DISABLED state, and the stream is automatically deleted after 24 hours.

+ * + *

Use the DescribeTable action to check the status of the table.

+ */ export class DeleteTableCommand extends $Command< DeleteTableCommandInput, DeleteTableCommandOutput, @@ -34,6 +53,9 @@ export class DeleteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeBackupCommand.ts b/clients/client-dynamodb/commands/DescribeBackupCommand.ts index 598168689676d..f0e576ff568bc 100644 --- a/clients/client-dynamodb/commands/DescribeBackupCommand.ts +++ b/clients/client-dynamodb/commands/DescribeBackupCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeBackupCommandInput = DescribeBackupInput; export type DescribeBackupCommandOutput = DescribeBackupOutput & __MetadataBearer; +/** + *

Describes an existing backup of a table.

+ *

You can call DescribeBackup at a maximum rate of 10 times per second.

+ */ export class DescribeBackupCommand extends $Command< DescribeBackupCommandInput, DescribeBackupCommandOutput, @@ -34,6 +38,9 @@ export class DescribeBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeContinuousBackupsCommand.ts b/clients/client-dynamodb/commands/DescribeContinuousBackupsCommand.ts index 1db88ad144258..793280a5847e5 100644 --- a/clients/client-dynamodb/commands/DescribeContinuousBackupsCommand.ts +++ b/clients/client-dynamodb/commands/DescribeContinuousBackupsCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeContinuousBackupsCommandInput = DescribeContinuousBackupsInput; export type DescribeContinuousBackupsCommandOutput = DescribeContinuousBackupsOutput & __MetadataBearer; +/** + *

Checks the status of continuous backups and point in time recovery on the specified table. + * Continuous backups are ENABLED on all tables at table creation. + * If point in time recovery is enabled, PointInTimeRecoveryStatus will be set to ENABLED.

+ *

After continuous backups and point in time recovery are enabled, you can restore to any + * point in time within EarliestRestorableDateTime and + * LatestRestorableDateTime.

+ *

+ * LatestRestorableDateTime is typically 5 minutes before the current time. You can restore your table to any point + * in time during the last 35 days. + *

+ *

You can call DescribeContinuousBackups at a maximum rate of 10 times per second.

+ */ export class DescribeContinuousBackupsCommand extends $Command< DescribeContinuousBackupsCommandInput, DescribeContinuousBackupsCommandOutput, @@ -34,6 +47,9 @@ export class DescribeContinuousBackupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeContributorInsightsCommand.ts b/clients/client-dynamodb/commands/DescribeContributorInsightsCommand.ts index 199c5ee59b530..bfa56233f40a9 100644 --- a/clients/client-dynamodb/commands/DescribeContributorInsightsCommand.ts +++ b/clients/client-dynamodb/commands/DescribeContributorInsightsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeContributorInsightsCommandInput = DescribeContributorInsightsInput; export type DescribeContributorInsightsCommandOutput = DescribeContributorInsightsOutput & __MetadataBearer; +/** + *

Returns information about contributor insights, for a given table or global secondary index.

+ */ export class DescribeContributorInsightsCommand extends $Command< DescribeContributorInsightsCommandInput, DescribeContributorInsightsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeContributorInsightsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeEndpointsCommand.ts b/clients/client-dynamodb/commands/DescribeEndpointsCommand.ts index 46d34fdc7ad32..4e317bfab8a4b 100644 --- a/clients/client-dynamodb/commands/DescribeEndpointsCommand.ts +++ b/clients/client-dynamodb/commands/DescribeEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEndpointsCommandInput = DescribeEndpointsRequest; export type DescribeEndpointsCommandOutput = DescribeEndpointsResponse & __MetadataBearer; +/** + *

Returns the regional endpoint information.

+ */ export class DescribeEndpointsCommand extends $Command< DescribeEndpointsCommandInput, DescribeEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeExportCommand.ts b/clients/client-dynamodb/commands/DescribeExportCommand.ts index 8e04ac26efbd5..2019507fd770f 100644 --- a/clients/client-dynamodb/commands/DescribeExportCommand.ts +++ b/clients/client-dynamodb/commands/DescribeExportCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeExportCommandInput = DescribeExportInput; export type DescribeExportCommandOutput = DescribeExportOutput & __MetadataBearer; +/** + *

Describes an existing table export.

+ */ export class DescribeExportCommand extends $Command< DescribeExportCommandInput, DescribeExportCommandOutput, @@ -34,6 +37,9 @@ export class DescribeExportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeGlobalTableCommand.ts b/clients/client-dynamodb/commands/DescribeGlobalTableCommand.ts index 1b6b171f70854..931e1d6484adc 100644 --- a/clients/client-dynamodb/commands/DescribeGlobalTableCommand.ts +++ b/clients/client-dynamodb/commands/DescribeGlobalTableCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeGlobalTableCommandInput = DescribeGlobalTableInput; export type DescribeGlobalTableCommandOutput = DescribeGlobalTableOutput & __MetadataBearer; +/** + *

Returns information about the specified global table.

+ * + *

This operation only applies to Version 2017.11.29 of global tables. + * If you are using global tables Version 2019.11.21 you can use DescribeTable instead.

+ *
+ */ export class DescribeGlobalTableCommand extends $Command< DescribeGlobalTableCommandInput, DescribeGlobalTableCommandOutput, @@ -34,6 +41,9 @@ export class DescribeGlobalTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeGlobalTableSettingsCommand.ts b/clients/client-dynamodb/commands/DescribeGlobalTableSettingsCommand.ts index 32e696643f488..44045cef681e2 100644 --- a/clients/client-dynamodb/commands/DescribeGlobalTableSettingsCommand.ts +++ b/clients/client-dynamodb/commands/DescribeGlobalTableSettingsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeGlobalTableSettingsCommandInput = DescribeGlobalTableSettingsInput; export type DescribeGlobalTableSettingsCommandOutput = DescribeGlobalTableSettingsOutput & __MetadataBearer; +/** + *

Describes Region-specific settings for a global table.

+ * + *

This operation only applies to Version 2017.11.29 of global tables.

+ *
+ */ export class DescribeGlobalTableSettingsCommand extends $Command< DescribeGlobalTableSettingsCommandInput, DescribeGlobalTableSettingsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeGlobalTableSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeLimitsCommand.ts b/clients/client-dynamodb/commands/DescribeLimitsCommand.ts index 78c9231582fec..20b92088c5bf0 100644 --- a/clients/client-dynamodb/commands/DescribeLimitsCommand.ts +++ b/clients/client-dynamodb/commands/DescribeLimitsCommand.ts @@ -20,6 +20,72 @@ import { export type DescribeLimitsCommandInput = DescribeLimitsInput; export type DescribeLimitsCommandOutput = DescribeLimitsOutput & __MetadataBearer; +/** + *

Returns the current provisioned-capacity quotas for your AWS account in a Region, both + * for the Region as a whole and for any one DynamoDB table that you create there.

+ *

When you establish an AWS account, the account has initial quotas on the maximum read + * capacity units and write capacity units that you can provision across all of your + * DynamoDB tables in a given Region. Also, there are per-table quotas that apply when you + * create a table there. For more information, see Service, Account, and Table + * Quotas page in the Amazon DynamoDB Developer + * Guide.

+ * + *

Although you can increase these quotas by filing a case at AWS Support Center, obtaining the increase is not + * instantaneous. The DescribeLimits action lets you write code to compare the + * capacity you are currently using to those quotas imposed by your account so that you + * have enough time to apply for an increase before you hit a quota.

+ * + *

For example, you could use one of the AWS SDKs to do the following:

+ * + *
    + *
  1. + *

    Call DescribeLimits for a particular Region to obtain your current + * account quotas on provisioned capacity there.

    + *
  2. + *
  3. + *

    Create a variable to hold the aggregate read capacity units provisioned for all + * your tables in that Region, and one to hold the aggregate write capacity units. + * Zero them both.

    + *
  4. + *
  5. + *

    Call ListTables to obtain a list of all your DynamoDB tables.

    + *
  6. + *
  7. + *

    For each table name listed by ListTables, do the following:

    + *
      + *
    • + *

      Call DescribeTable with the table name.

      + *
    • + *
    • + *

      Use the data returned by DescribeTable to add the read capacity units and write capacity + * units provisioned for the table itself to your variables.

      + *
    • + *
    • + *

      If the table has one or more global secondary indexes (GSIs), loop over these GSIs and add their provisioned capacity values to your variables as well.

      + *
    • + *
    + *
  8. + *
  9. + *

    Report the account quotas for that Region returned by DescribeLimits, along with + * the total current provisioned capacity levels you have calculated.

    + *
  10. + *
+ * + *

This will let you see whether you are getting close to your account-level quotas.

+ *

The per-table quotas apply only when you are creating a new table. They restrict the sum + * of the provisioned capacity of the new table itself and all its global secondary + * indexes.

+ *

For existing tables and their GSIs, DynamoDB doesn't let you increase provisioned + * capacity extremely rapidly, but the only quota that applies is that the aggregate + * provisioned capacity over all your tables and GSIs cannot exceed either of the + * per-account quotas.

+ * + *

+ * DescribeLimits should only be called periodically. You can expect throttling + * errors if you call it more than once in a minute.

+ *
+ *

The DescribeLimits Request element has no content.

+ */ export class DescribeLimitsCommand extends $Command< DescribeLimitsCommandInput, DescribeLimitsCommandOutput, @@ -34,6 +100,9 @@ export class DescribeLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeTableCommand.ts b/clients/client-dynamodb/commands/DescribeTableCommand.ts index 67ff35a561278..c476050ad7e5a 100644 --- a/clients/client-dynamodb/commands/DescribeTableCommand.ts +++ b/clients/client-dynamodb/commands/DescribeTableCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeTableCommandInput = DescribeTableInput; export type DescribeTableCommandOutput = DescribeTableOutput & __MetadataBearer; +/** + *

Returns information about the table, including the current status of the table, when it was created, the primary key schema, and any indexes on the table.

+ * + *

If you issue a DescribeTable request immediately after a CreateTable request, DynamoDB might + * return a ResourceNotFoundException. This is because DescribeTable uses an eventually + * consistent query, and the metadata for your table might not be available at that moment. + * Wait for a few seconds, and then try the DescribeTable request again.

+ *
+ */ export class DescribeTableCommand extends $Command< DescribeTableCommandInput, DescribeTableCommandOutput, @@ -34,6 +43,9 @@ export class DescribeTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeTableReplicaAutoScalingCommand.ts b/clients/client-dynamodb/commands/DescribeTableReplicaAutoScalingCommand.ts index 98674484dd51d..cf4a9a77a9f07 100644 --- a/clients/client-dynamodb/commands/DescribeTableReplicaAutoScalingCommand.ts +++ b/clients/client-dynamodb/commands/DescribeTableReplicaAutoScalingCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeTableReplicaAutoScalingCommandInput = DescribeTableReplicaAutoScalingInput; export type DescribeTableReplicaAutoScalingCommandOutput = DescribeTableReplicaAutoScalingOutput & __MetadataBearer; +/** + *

Describes auto scaling settings across replicas of the global table at once.

+ * + *

This operation only applies to Version 2019.11.21 of global tables.

+ *
+ */ export class DescribeTableReplicaAutoScalingCommand extends $Command< DescribeTableReplicaAutoScalingCommandInput, DescribeTableReplicaAutoScalingCommandOutput, @@ -34,6 +40,9 @@ export class DescribeTableReplicaAutoScalingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/DescribeTimeToLiveCommand.ts b/clients/client-dynamodb/commands/DescribeTimeToLiveCommand.ts index 66018fefb4b34..dea713b1b09bc 100644 --- a/clients/client-dynamodb/commands/DescribeTimeToLiveCommand.ts +++ b/clients/client-dynamodb/commands/DescribeTimeToLiveCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTimeToLiveCommandInput = DescribeTimeToLiveInput; export type DescribeTimeToLiveCommandOutput = DescribeTimeToLiveOutput & __MetadataBearer; +/** + *

Gives a description of the Time to Live (TTL) status on the specified table.

+ */ export class DescribeTimeToLiveCommand extends $Command< DescribeTimeToLiveCommandInput, DescribeTimeToLiveCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTimeToLiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/ExportTableToPointInTimeCommand.ts b/clients/client-dynamodb/commands/ExportTableToPointInTimeCommand.ts index 7091ea8f0fc1c..0d9a90685a7a8 100644 --- a/clients/client-dynamodb/commands/ExportTableToPointInTimeCommand.ts +++ b/clients/client-dynamodb/commands/ExportTableToPointInTimeCommand.ts @@ -20,6 +20,11 @@ import { export type ExportTableToPointInTimeCommandInput = ExportTableToPointInTimeInput; export type ExportTableToPointInTimeCommandOutput = ExportTableToPointInTimeOutput & __MetadataBearer; +/** + *

Exports table data to an S3 bucket. The table must have point in time recovery + * enabled, and you can export data from any time within the point in time recovery + * window.

+ */ export class ExportTableToPointInTimeCommand extends $Command< ExportTableToPointInTimeCommandInput, ExportTableToPointInTimeCommandOutput, @@ -34,6 +39,9 @@ export class ExportTableToPointInTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/GetItemCommand.ts b/clients/client-dynamodb/commands/GetItemCommand.ts index 1df225bf3281c..b8267d4b54f1f 100644 --- a/clients/client-dynamodb/commands/GetItemCommand.ts +++ b/clients/client-dynamodb/commands/GetItemCommand.ts @@ -17,6 +17,15 @@ import { export type GetItemCommandInput = GetItemInput; export type GetItemCommandOutput = GetItemOutput & __MetadataBearer; +/** + *

The GetItem operation returns a set of attributes for the item with the given primary + * key. If there is no matching item, GetItem does not return any data and there will be no Item element in the response.

+ *

+ * GetItem provides an eventually consistent read by default. If your application + * requires a strongly consistent read, set ConsistentRead to true. Although + * a strongly consistent read might take more time than an eventually consistent read, it always + * returns the last updated value.

+ */ export class GetItemCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +36,9 @@ export class GetItemCommand extends $Command, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/ListBackupsCommand.ts b/clients/client-dynamodb/commands/ListBackupsCommand.ts index da586a60a3924..ebae925c93cc0 100644 --- a/clients/client-dynamodb/commands/ListBackupsCommand.ts +++ b/clients/client-dynamodb/commands/ListBackupsCommand.ts @@ -20,6 +20,15 @@ import { export type ListBackupsCommandInput = ListBackupsInput; export type ListBackupsCommandOutput = ListBackupsOutput & __MetadataBearer; +/** + *

List backups associated with an AWS account. To list backups for a given table, specify + * TableName. ListBackups returns a paginated list of results + * with at most 1 MB worth of items in a page. You can also specify a maximum number of + * entries to be returned in a page.

+ *

In the request, start time is inclusive, but end time is exclusive. Note that these + * boundaries are for the time at which the original backup was requested.

+ *

You can call ListBackups a maximum of five times per second.

+ */ export class ListBackupsCommand extends $Command< ListBackupsCommandInput, ListBackupsCommandOutput, @@ -34,6 +43,9 @@ export class ListBackupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/ListContributorInsightsCommand.ts b/clients/client-dynamodb/commands/ListContributorInsightsCommand.ts index fb449ecff39a5..d702c4e5770b8 100644 --- a/clients/client-dynamodb/commands/ListContributorInsightsCommand.ts +++ b/clients/client-dynamodb/commands/ListContributorInsightsCommand.ts @@ -20,6 +20,9 @@ import { export type ListContributorInsightsCommandInput = ListContributorInsightsInput; export type ListContributorInsightsCommandOutput = ListContributorInsightsOutput & __MetadataBearer; +/** + *

Returns a list of ContributorInsightsSummary for a table and all its global secondary indexes.

+ */ export class ListContributorInsightsCommand extends $Command< ListContributorInsightsCommandInput, ListContributorInsightsCommandOutput, @@ -34,6 +37,9 @@ export class ListContributorInsightsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/ListExportsCommand.ts b/clients/client-dynamodb/commands/ListExportsCommand.ts index e889542ac8ae1..aa7afb144568c 100644 --- a/clients/client-dynamodb/commands/ListExportsCommand.ts +++ b/clients/client-dynamodb/commands/ListExportsCommand.ts @@ -20,6 +20,9 @@ import { export type ListExportsCommandInput = ListExportsInput; export type ListExportsCommandOutput = ListExportsOutput & __MetadataBearer; +/** + *

Lists completed exports within the past 90 days.

+ */ export class ListExportsCommand extends $Command< ListExportsCommandInput, ListExportsCommandOutput, @@ -34,6 +37,9 @@ export class ListExportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/ListGlobalTablesCommand.ts b/clients/client-dynamodb/commands/ListGlobalTablesCommand.ts index dc0dbe3a5d4af..e97db9ecf275c 100644 --- a/clients/client-dynamodb/commands/ListGlobalTablesCommand.ts +++ b/clients/client-dynamodb/commands/ListGlobalTablesCommand.ts @@ -20,6 +20,12 @@ import { export type ListGlobalTablesCommandInput = ListGlobalTablesInput; export type ListGlobalTablesCommandOutput = ListGlobalTablesOutput & __MetadataBearer; +/** + *

Lists all global tables that have a replica in the specified Region.

+ * + *

This operation only applies to Version 2017.11.29 of global tables.

+ *
+ */ export class ListGlobalTablesCommand extends $Command< ListGlobalTablesCommandInput, ListGlobalTablesCommandOutput, @@ -34,6 +40,9 @@ export class ListGlobalTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/ListTablesCommand.ts b/clients/client-dynamodb/commands/ListTablesCommand.ts index 5aa39d364ab2d..391c158a74a91 100644 --- a/clients/client-dynamodb/commands/ListTablesCommand.ts +++ b/clients/client-dynamodb/commands/ListTablesCommand.ts @@ -20,6 +20,11 @@ import { export type ListTablesCommandInput = ListTablesInput; export type ListTablesCommandOutput = ListTablesOutput & __MetadataBearer; +/** + *

Returns an array of table names associated with the current account and endpoint. The output + * from ListTables is paginated, with each page returning a maximum of 100 table + * names.

+ */ export class ListTablesCommand extends $Command< ListTablesCommandInput, ListTablesCommandOutput, @@ -34,6 +39,9 @@ export class ListTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/ListTagsOfResourceCommand.ts b/clients/client-dynamodb/commands/ListTagsOfResourceCommand.ts index 35a117152b673..3aabb9b164510 100644 --- a/clients/client-dynamodb/commands/ListTagsOfResourceCommand.ts +++ b/clients/client-dynamodb/commands/ListTagsOfResourceCommand.ts @@ -20,6 +20,12 @@ import { export type ListTagsOfResourceCommandInput = ListTagsOfResourceInput; export type ListTagsOfResourceCommandOutput = ListTagsOfResourceOutput & __MetadataBearer; +/** + *

List all tags on an Amazon DynamoDB resource. You can call ListTagsOfResource up to 10 times per second, per account.

+ *

For an overview on tagging DynamoDB resources, see + * Tagging for DynamoDB + * in the Amazon DynamoDB Developer Guide.

+ */ export class ListTagsOfResourceCommand extends $Command< ListTagsOfResourceCommandInput, ListTagsOfResourceCommandOutput, @@ -34,6 +40,9 @@ export class ListTagsOfResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/PutItemCommand.ts b/clients/client-dynamodb/commands/PutItemCommand.ts index 581630e3f2755..aa9a0dc619e5e 100644 --- a/clients/client-dynamodb/commands/PutItemCommand.ts +++ b/clients/client-dynamodb/commands/PutItemCommand.ts @@ -17,6 +17,76 @@ import { export type PutItemCommandInput = PutItemInput; export type PutItemCommandOutput = PutItemOutput & __MetadataBearer; +/** + *

Creates a new item, or replaces an old item with a new item. If an item that has the same primary key as the new item already exists in the specified table, the new item completely replaces the existing item. You can perform a conditional put operation (add a new item if one with the specified primary key doesn't exist), or replace an existing item if it has certain attribute values. You can return the item's attribute values in the same operation, using the ReturnValues parameter.

+ * + *

This topic provides general information about the PutItem API.

+ *

For information on how to call the PutItem API using the AWS SDK in specific languages, see the following:

+ * + *
+ * + *

When you add an item, the primary key attributes are the only required attributes. + * Attribute values cannot be null.

+ *

Empty String and Binary attribute values are allowed. Attribute values of type String and Binary must have a length greater than zero if the attribute is used as a key attribute for a table or index. + * Set type attributes cannot be empty.

+ *

Invalid Requests with empty values will + * be rejected with a ValidationException exception.

+ * + *

To prevent a new item from replacing an existing item, use a conditional expression + * that contains the attribute_not_exists function with the name of the + * attribute being used as the partition key for the table. Since every record must contain + * that attribute, the attribute_not_exists function will only succeed if + * no matching item exists.

+ *
+ *

For more information about PutItem, see Working with Items in the Amazon DynamoDB Developer Guide.

+ */ export class PutItemCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +97,9 @@ export class PutItemCommand extends $Command, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/QueryCommand.ts b/clients/client-dynamodb/commands/QueryCommand.ts index bf4f1a597dee6..87a6b462457ef 100644 --- a/clients/client-dynamodb/commands/QueryCommand.ts +++ b/clients/client-dynamodb/commands/QueryCommand.ts @@ -17,6 +17,64 @@ import { export type QueryCommandInput = QueryInput; export type QueryCommandOutput = QueryOutput & __MetadataBearer; +/** + *

The Query operation finds items based on primary key values. + * You can query any table or secondary index that has a composite primary key (a partition + * key and a sort key). + *

+ *

Use the KeyConditionExpression parameter to provide a specific value + * for the partition key. The Query operation will return all of the items + * from the table or index with that partition key value. You can optionally narrow the + * scope of the Query operation by specifying a sort key value and a + * comparison operator in KeyConditionExpression. To further refine the Query results, + * you can optionally provide a FilterExpression. A FilterExpression determines which items + * within the results should be returned to you. All of the other results are discarded. + *

+ *

+ * A Query operation always returns a result set. If no matching items are found, + * the result set will be empty. Queries that do not return results consume the minimum number of + * read capacity units for that type of read operation. + *

+ * + *

+ * DynamoDB calculates the number of read capacity units consumed based on item size, + * not on the amount of data that is returned to an application. The number of capacity + * units consumed will be the same whether you request all of the attributes (the default behavior) + * or just some of them (using a projection expression). The number will also be the same + * whether or not you use a FilterExpression. + *

+ *
+ *

+ * Query results are always sorted by the sort key value. If the data type of the sort key is Number, + * the results are returned in numeric order; otherwise, the results are returned in order of UTF-8 bytes. + * By default, the sort order is ascending. To reverse the order, set the ScanIndexForward parameter + * to false. + *

+ *

A single Query operation will read up to the maximum number of items + * set (if using the Limit parameter) or a maximum of 1 MB of data and then + * apply any filtering to the results using FilterExpression. If + * LastEvaluatedKey is present in the response, you will need to paginate + * the result set. For more information, see Paginating + * the Results in the Amazon DynamoDB Developer Guide.

+ *

+ * FilterExpression is applied after a Query finishes, but before + * the results are returned. + * A FilterExpression cannot contain partition key or sort key attributes. + * You need to specify those attributes in the KeyConditionExpression. + *

+ * + *

+ * A Query operation can return an empty result set and a LastEvaluatedKey + * if all the items read for the page of results are filtered out. + *

+ *
+ *

You can query a table, a local secondary index, or a global secondary index. For a + * query on a table or on a local secondary index, you can set the + * ConsistentRead parameter to true and obtain a + * strongly consistent result. Global secondary indexes support eventually consistent reads + * only, so do not specify ConsistentRead when querying a global + * secondary index.

+ */ export class QueryCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +85,9 @@ export class QueryCommand extends $Command, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/RestoreTableFromBackupCommand.ts b/clients/client-dynamodb/commands/RestoreTableFromBackupCommand.ts index fd287f3e03043..fb5f1e6b458fe 100644 --- a/clients/client-dynamodb/commands/RestoreTableFromBackupCommand.ts +++ b/clients/client-dynamodb/commands/RestoreTableFromBackupCommand.ts @@ -20,6 +20,33 @@ import { export type RestoreTableFromBackupCommandInput = RestoreTableFromBackupInput; export type RestoreTableFromBackupCommandOutput = RestoreTableFromBackupOutput & __MetadataBearer; +/** + *

Creates a new table from an existing backup. Any number of users can execute up to 4 concurrent restores + * (any type of restore) in a given account. + *

+ *

You can call RestoreTableFromBackup at a maximum rate of 10 times per second.

+ *

You must manually set up the following on the restored table:

+ *
    + *
  • + *

    Auto scaling policies

    + *
  • + *
  • + *

    IAM policies

    + *
  • + *
  • + *

    Amazon CloudWatch metrics and alarms

    + *
  • + *
  • + *

    Tags

    + *
  • + *
  • + *

    Stream settings

    + *
  • + *
  • + *

    Time to Live (TTL) settings

    + *
  • + *
+ */ export class RestoreTableFromBackupCommand extends $Command< RestoreTableFromBackupCommandInput, RestoreTableFromBackupCommandOutput, @@ -34,6 +61,9 @@ export class RestoreTableFromBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/RestoreTableToPointInTimeCommand.ts b/clients/client-dynamodb/commands/RestoreTableToPointInTimeCommand.ts index 23efd15463671..ad5a96759db44 100644 --- a/clients/client-dynamodb/commands/RestoreTableToPointInTimeCommand.ts +++ b/clients/client-dynamodb/commands/RestoreTableToPointInTimeCommand.ts @@ -20,6 +20,64 @@ import { export type RestoreTableToPointInTimeCommandInput = RestoreTableToPointInTimeInput; export type RestoreTableToPointInTimeCommandOutput = RestoreTableToPointInTimeOutput & __MetadataBearer; +/** + *

Restores the specified table to the specified point in time within + * EarliestRestorableDateTime and LatestRestorableDateTime. + * You can restore your table to any point in time during the last 35 days. + * Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account. + *

+ *

+ * When you restore using point in time recovery, DynamoDB restores your table data to the state based on + * the selected date and time (day:hour:minute:second) to a new table. + *

+ *

+ * Along with data, the following are also included on the new restored table using point in time recovery: + *

+ *
    + *
  • + *

    Global secondary indexes (GSIs)

    + *
  • + *
  • + *

    Local secondary indexes (LSIs)

    + *
  • + *
  • + *

    Provisioned read and write capacity

    + *
  • + *
  • + *

    Encryption settings

    + * + *

    + * All these settings come from the current settings of the source table at the time of restore. + *

    + *
    + *
  • + *
+ * + *

You must manually set up the following on the restored table:

+ *
    + *
  • + *

    Auto scaling policies

    + *
  • + *
  • + *

    IAM policies

    + *
  • + *
  • + *

    Amazon CloudWatch metrics and alarms

    + *
  • + *
  • + *

    Tags

    + *
  • + *
  • + *

    Stream settings

    + *
  • + *
  • + *

    Time to Live (TTL) settings

    + *
  • + *
  • + *

    Point in time recovery settings

    + *
  • + *
+ */ export class RestoreTableToPointInTimeCommand extends $Command< RestoreTableToPointInTimeCommandInput, RestoreTableToPointInTimeCommandOutput, @@ -34,6 +92,9 @@ export class RestoreTableToPointInTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/ScanCommand.ts b/clients/client-dynamodb/commands/ScanCommand.ts index 8c5443b65611d..f643c9c4b1648 100644 --- a/clients/client-dynamodb/commands/ScanCommand.ts +++ b/clients/client-dynamodb/commands/ScanCommand.ts @@ -17,6 +17,33 @@ import { export type ScanCommandInput = ScanInput; export type ScanCommandOutput = ScanOutput & __MetadataBearer; +/** + *

The Scan operation returns one or more items and item attributes by accessing every + * item in a table or a secondary index. To have DynamoDB return fewer items, you can provide a FilterExpression operation.

+ *

If the total number of scanned items exceeds the maximum dataset size limit of 1 MB, the + * scan stops and results are returned to the user as a LastEvaluatedKey value + * to continue the scan in a subsequent operation. The results also include the number of + * items exceeding the limit. A scan can result in no table data meeting the filter + * criteria.

+ *

A single Scan operation reads up to the maximum number of items set (if + * using the Limit parameter) or a maximum of 1 MB of data and then apply any + * filtering to the results using FilterExpression. If + * LastEvaluatedKey is present in the response, you need to paginate the + * result set. For more information, see Paginating the + * Results in the Amazon DynamoDB Developer Guide.

+ *

+ * Scan operations proceed sequentially; however, for faster performance on + * a large table or secondary index, applications can request a parallel Scan + * operation by providing the Segment and TotalSegments + * parameters. For more information, see Parallel + * Scan in the Amazon DynamoDB Developer Guide.

+ *

+ * Scan uses eventually consistent reads when accessing the data in a + * table; therefore, the result set might not include the changes to data in the table + * immediately before the operation began. If you need a consistent copy of the data, as of + * the time that the Scan begins, you can set the ConsistentRead + * parameter to true.

+ */ export class ScanCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +54,9 @@ export class ScanCommand extends $Command, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/TagResourceCommand.ts b/clients/client-dynamodb/commands/TagResourceCommand.ts index e62b3f4aa0cbc..0960b353c8405 100644 --- a/clients/client-dynamodb/commands/TagResourceCommand.ts +++ b/clients/client-dynamodb/commands/TagResourceCommand.ts @@ -20,6 +20,15 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Associate a set of tags with an Amazon DynamoDB resource. You can then activate these + * user-defined tags so that they appear on the Billing and Cost Management console for + * cost allocation tracking. You can call TagResource up to five times per second, per + * account.

+ *

For an overview on tagging DynamoDB resources, see + * Tagging for DynamoDB + * in the Amazon DynamoDB Developer Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +43,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/TransactGetItemsCommand.ts b/clients/client-dynamodb/commands/TransactGetItemsCommand.ts index 8e508b6faaa9f..a6757ea9ee4a3 100644 --- a/clients/client-dynamodb/commands/TransactGetItemsCommand.ts +++ b/clients/client-dynamodb/commands/TransactGetItemsCommand.ts @@ -20,6 +20,34 @@ import { export type TransactGetItemsCommandInput = TransactGetItemsInput; export type TransactGetItemsCommandOutput = TransactGetItemsOutput & __MetadataBearer; +/** + *

+ * TransactGetItems is a synchronous operation that atomically retrieves + * multiple items from one or more tables (but not from indexes) in a single account and + * Region. A TransactGetItems call can contain up to 25 + * TransactGetItem objects, each of which contains a Get + * structure that specifies an item to retrieve from a table in the account and Region. A + * call to TransactGetItems cannot retrieve items from tables in more than one + * AWS account or Region. The aggregate size of the items in the transaction cannot exceed + * 4 MB.

+ *

DynamoDB rejects the entire TransactGetItems request if any of the following is true:

+ *
    + *
  • + *

    A conflicting operation is in the process of updating an + * item to be read.

    + *
  • + *
  • + *

    There is insufficient provisioned capacity for the transaction + * to be completed.

    + *
  • + *
  • + *

    There is a user error, such as an invalid data format.

    + *
  • + *
  • + *

    The aggregate size of the items in the transaction cannot exceed 4 MB.

    + *
  • + *
+ */ export class TransactGetItemsCommand extends $Command< TransactGetItemsCommandInput, TransactGetItemsCommandOutput, @@ -34,6 +62,9 @@ export class TransactGetItemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/TransactWriteItemsCommand.ts b/clients/client-dynamodb/commands/TransactWriteItemsCommand.ts index 8caecbe74c7ee..b0cb43e30f0b8 100644 --- a/clients/client-dynamodb/commands/TransactWriteItemsCommand.ts +++ b/clients/client-dynamodb/commands/TransactWriteItemsCommand.ts @@ -20,6 +20,82 @@ import { export type TransactWriteItemsCommandInput = TransactWriteItemsInput; export type TransactWriteItemsCommandOutput = TransactWriteItemsOutput & __MetadataBearer; +/** + *

+ * TransactWriteItems is a synchronous write operation that groups up to 25 + * action requests. These actions can target items in different tables, but not in + * different AWS accounts or Regions, and no two actions can target the same item. For + * example, you cannot both ConditionCheck and Update the same + * item. The aggregate size of the items in the transaction cannot exceed 4 MB.

+ * + *

The actions are completed atomically so that either all of + * them succeed, or all of them fail. They are defined by the following objects:

+ * + *
    + *
  • + *

    + * Put  —   Initiates a PutItem operation to write a new + * item. This structure specifies the primary key of the item to be written, the + * name of the table to write it in, an optional condition expression that must be + * satisfied for the write to succeed, a list of the item's attributes, and a field + * indicating whether to retrieve the item's attributes if the condition is not + * met.

    + *
  • + *
  • + *

    + * Update  —   Initiates an UpdateItem operation to + * update an existing item. This structure specifies the primary key of the item to + * be updated, the name of the table where it resides, an optional condition + * expression that must be satisfied for the update to succeed, an expression that + * defines one or more attributes to be updated, and a field indicating whether to + * retrieve the item's attributes if the condition is not met.

    + *
  • + *
  • + *

    + * Delete  —   Initiates a DeleteItem operation to + * delete an existing item. This structure specifies the primary key of the item to + * be deleted, the name of the table where it resides, an optional condition + * expression that must be satisfied for the deletion to succeed, and a field + * indicating whether to retrieve the item's attributes if the condition is not + * met.

    + *
  • + *
  • + *

    + * ConditionCheck  —   Applies a condition to an item that is not + * being modified by the transaction. This structure specifies the primary key of + * the item to be checked, the name of the table where it resides, a condition + * expression that must be satisfied for the transaction to succeed, and a field + * indicating whether to retrieve the item's attributes if the condition is not + * met.

    + *
  • + *
+ * + *

DynamoDB rejects the entire TransactWriteItems request if any of the following is true:

+ *
    + *
  • + *

    A condition in one of the condition expressions is not met.

    + *
  • + *
  • + *

    An ongoing operation is in the process of updating the same + * item.

    + *
  • + *
  • + *

    There is insufficient provisioned capacity for the transaction + * to be completed.

    + *
  • + *
  • + *

    An item size becomes too large (bigger than 400 KB), a local secondary index (LSI) becomes too + * large, or a similar validation error occurs because of changes made by the + * transaction.

    + *
  • + *
  • + *

    The aggregate size of the items in the transaction exceeds 4 MB.

    + *
  • + *
  • + *

    There is a user error, such as an invalid data format.

    + *
  • + *
+ */ export class TransactWriteItemsCommand extends $Command< TransactWriteItemsCommandInput, TransactWriteItemsCommandOutput, @@ -34,6 +110,9 @@ export class TransactWriteItemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UntagResourceCommand.ts b/clients/client-dynamodb/commands/UntagResourceCommand.ts index d8d9f2e063602..6e45afbb6b44f 100644 --- a/clients/client-dynamodb/commands/UntagResourceCommand.ts +++ b/clients/client-dynamodb/commands/UntagResourceCommand.ts @@ -20,6 +20,13 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes the association of tags from an Amazon DynamoDB resource. You can call + * UntagResource up to five times per second, per account.

+ *

For an overview on tagging DynamoDB resources, see + * Tagging for DynamoDB + * in the Amazon DynamoDB Developer Guide.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +41,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UpdateContinuousBackupsCommand.ts b/clients/client-dynamodb/commands/UpdateContinuousBackupsCommand.ts index 705fe13d1dbe0..ff3fcb98fe55a 100644 --- a/clients/client-dynamodb/commands/UpdateContinuousBackupsCommand.ts +++ b/clients/client-dynamodb/commands/UpdateContinuousBackupsCommand.ts @@ -20,6 +20,20 @@ import { export type UpdateContinuousBackupsCommandInput = UpdateContinuousBackupsInput; export type UpdateContinuousBackupsCommandOutput = UpdateContinuousBackupsOutput & __MetadataBearer; +/** + *

+ * UpdateContinuousBackups enables or disables point in time recovery for the specified table. + * A successful UpdateContinuousBackups call returns the current ContinuousBackupsDescription. + * Continuous backups are ENABLED on all tables at table creation. + * If point in time recovery is enabled, PointInTimeRecoveryStatus will be set to ENABLED.

+ *

+ * Once continuous backups and point in time recovery are enabled, you can restore to any point in time within + * EarliestRestorableDateTime and LatestRestorableDateTime. + *

+ *

+ * LatestRestorableDateTime is typically 5 minutes before the current time. + * You can restore your table to any point in time during the last 35 days.

+ */ export class UpdateContinuousBackupsCommand extends $Command< UpdateContinuousBackupsCommandInput, UpdateContinuousBackupsCommandOutput, @@ -34,6 +48,9 @@ export class UpdateContinuousBackupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UpdateContributorInsightsCommand.ts b/clients/client-dynamodb/commands/UpdateContributorInsightsCommand.ts index ad621cdf58029..b168813e95452 100644 --- a/clients/client-dynamodb/commands/UpdateContributorInsightsCommand.ts +++ b/clients/client-dynamodb/commands/UpdateContributorInsightsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateContributorInsightsCommandInput = UpdateContributorInsightsInput; export type UpdateContributorInsightsCommandOutput = UpdateContributorInsightsOutput & __MetadataBearer; +/** + *

Updates the status for contributor insights for a specific table or index.

+ */ export class UpdateContributorInsightsCommand extends $Command< UpdateContributorInsightsCommandInput, UpdateContributorInsightsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateContributorInsightsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UpdateGlobalTableCommand.ts b/clients/client-dynamodb/commands/UpdateGlobalTableCommand.ts index adcfbf348d641..28df2b0e68847 100644 --- a/clients/client-dynamodb/commands/UpdateGlobalTableCommand.ts +++ b/clients/client-dynamodb/commands/UpdateGlobalTableCommand.ts @@ -20,6 +20,37 @@ import { export type UpdateGlobalTableCommandInput = UpdateGlobalTableInput; export type UpdateGlobalTableCommandOutput = UpdateGlobalTableOutput & __MetadataBearer; +/** + *

Adds or removes replicas in the specified global table. The global table must already + * exist to be able to use this operation. Any replica to be added must be empty, have the + * same name as the global table, have the same key schema, have DynamoDB Streams enabled, + * and have the same provisioned and maximum write capacity units.

+ * + *

Although you can use UpdateGlobalTable to add replicas and remove replicas in + * a single request, for simplicity we recommend that you issue separate requests for + * adding or removing replicas.

+ *
+ *

+ * If global secondary indexes are specified, then the following conditions must also be met: + *

+ *
    + *
  • + *

    + * The global secondary indexes must have the same name. + *

    + *
  • + *
  • + *

    + * The global secondary indexes must have the same hash key and sort key (if present). + *

    + *
  • + *
  • + *

    + * The global secondary indexes must have the same provisioned and maximum write capacity units. + *

    + *
  • + *
+ */ export class UpdateGlobalTableCommand extends $Command< UpdateGlobalTableCommandInput, UpdateGlobalTableCommandOutput, @@ -34,6 +65,9 @@ export class UpdateGlobalTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UpdateGlobalTableSettingsCommand.ts b/clients/client-dynamodb/commands/UpdateGlobalTableSettingsCommand.ts index c0b908678eee7..1957f7ab268bb 100644 --- a/clients/client-dynamodb/commands/UpdateGlobalTableSettingsCommand.ts +++ b/clients/client-dynamodb/commands/UpdateGlobalTableSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGlobalTableSettingsCommandInput = UpdateGlobalTableSettingsInput; export type UpdateGlobalTableSettingsCommandOutput = UpdateGlobalTableSettingsOutput & __MetadataBearer; +/** + *

Updates settings for a global table.

+ */ export class UpdateGlobalTableSettingsCommand extends $Command< UpdateGlobalTableSettingsCommandInput, UpdateGlobalTableSettingsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGlobalTableSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UpdateItemCommand.ts b/clients/client-dynamodb/commands/UpdateItemCommand.ts index 02822b11f857e..ddbe7cc7b96b7 100644 --- a/clients/client-dynamodb/commands/UpdateItemCommand.ts +++ b/clients/client-dynamodb/commands/UpdateItemCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateItemCommandInput = UpdateItemInput; export type UpdateItemCommandOutput = UpdateItemOutput & __MetadataBearer; +/** + *

Edits an existing item's attributes, or adds a new item to the table if it does not already exist. You can put, delete, or add attribute values. You can also perform a conditional update on an existing item (insert a new attribute name-value pair if it doesn't exist, or replace an existing name-value pair if it has certain expected attribute values).

+ *

You can also return the item's attribute values in the same UpdateItem + * operation using the ReturnValues parameter.

+ */ export class UpdateItemCommand extends $Command< UpdateItemCommandInput, UpdateItemCommandOutput, @@ -34,6 +39,9 @@ export class UpdateItemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UpdateTableCommand.ts b/clients/client-dynamodb/commands/UpdateTableCommand.ts index 519e89183e3cd..910c1748df49d 100644 --- a/clients/client-dynamodb/commands/UpdateTableCommand.ts +++ b/clients/client-dynamodb/commands/UpdateTableCommand.ts @@ -20,6 +20,31 @@ import { export type UpdateTableCommandInput = UpdateTableInput; export type UpdateTableCommandOutput = UpdateTableOutput & __MetadataBearer; +/** + *

Modifies the provisioned throughput settings, global secondary indexes, or DynamoDB Streams settings for a given table.

+ *

You can only perform one of the following operations at once:

+ *
    + *
  • + *

    Modify the provisioned throughput settings of the table.

    + *
  • + *
  • + *

    Enable or disable DynamoDB Streams on the table.

    + *
  • + *
  • + *

    Remove a global secondary index from the table.

    + *
  • + *
  • + *

    Create a new global secondary index on the table. After the index begins + * backfilling, you can use UpdateTable to perform other + * operations.

    + *
  • + *
+ *

+ * UpdateTable is an asynchronous operation; while it is executing, the table status + * changes from ACTIVE to UPDATING. While it is UPDATING, + * you cannot issue another UpdateTable request. When the table returns to the + * ACTIVE state, the UpdateTable operation is complete.

+ */ export class UpdateTableCommand extends $Command< UpdateTableCommandInput, UpdateTableCommandOutput, @@ -34,6 +59,9 @@ export class UpdateTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UpdateTableReplicaAutoScalingCommand.ts b/clients/client-dynamodb/commands/UpdateTableReplicaAutoScalingCommand.ts index c30a6fcbb1d5b..887907f869b87 100644 --- a/clients/client-dynamodb/commands/UpdateTableReplicaAutoScalingCommand.ts +++ b/clients/client-dynamodb/commands/UpdateTableReplicaAutoScalingCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateTableReplicaAutoScalingCommandInput = UpdateTableReplicaAutoScalingInput; export type UpdateTableReplicaAutoScalingCommandOutput = UpdateTableReplicaAutoScalingOutput & __MetadataBearer; +/** + *

Updates auto scaling settings on your global tables at once.

+ * + *

This operation only applies to Version 2019.11.21 of global tables.

+ *
+ */ export class UpdateTableReplicaAutoScalingCommand extends $Command< UpdateTableReplicaAutoScalingCommandInput, UpdateTableReplicaAutoScalingCommandOutput, @@ -34,6 +40,9 @@ export class UpdateTableReplicaAutoScalingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/commands/UpdateTimeToLiveCommand.ts b/clients/client-dynamodb/commands/UpdateTimeToLiveCommand.ts index 5efcb1f8346b6..24326167a30f2 100644 --- a/clients/client-dynamodb/commands/UpdateTimeToLiveCommand.ts +++ b/clients/client-dynamodb/commands/UpdateTimeToLiveCommand.ts @@ -20,6 +20,33 @@ import { export type UpdateTimeToLiveCommandInput = UpdateTimeToLiveInput; export type UpdateTimeToLiveCommandOutput = UpdateTimeToLiveOutput & __MetadataBearer; +/** + *

The UpdateTimeToLive method enables or disables Time to Live (TTL) for the + * specified table. A successful UpdateTimeToLive call returns the current + * TimeToLiveSpecification. It can take up to one hour for the change to + * fully process. Any additional UpdateTimeToLive calls for the same table + * during this one hour duration result in a ValidationException.

+ *

TTL compares the current time in epoch time format to the time stored in the TTL + * attribute of an item. If the epoch time value stored in the attribute is less than the + * current time, the item is marked as expired and subsequently deleted.

+ * + *

The epoch time format is the number of seconds elapsed since 12:00:00 AM January 1, + * 1970 UTC.

+ *
+ *

DynamoDB deletes expired items on a best-effort basis to ensure availability of + * throughput for other data operations. + *

+ * + *

DynamoDB typically deletes expired items within two days of expiration. The exact duration + * within which an item gets deleted after expiration is specific to the + * nature of the workload. Items that have expired and not been deleted will still show up in reads, + * queries, and scans.

+ *
+ *

As items are deleted, they are removed from any local secondary index and global + * secondary index immediately in the same eventually consistent way as a standard delete + * operation.

+ *

For more information, see Time To Live in the Amazon DynamoDB Developer Guide.

+ */ export class UpdateTimeToLiveCommand extends $Command< UpdateTimeToLiveCommandInput, UpdateTimeToLiveCommandOutput, @@ -34,6 +61,9 @@ export class UpdateTimeToLiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: DynamoDBClientResolvedConfig, diff --git a/clients/client-dynamodb/package.json b/clients/client-dynamodb/package.json index 70be3815317b2..fb863034cee5f 100644 --- a/clients/client-dynamodb/package.json +++ b/clients/client-dynamodb/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Dynamodb Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-dynamodb/pagination/ListContributorInsightsPaginator.ts b/clients/client-dynamodb/pagination/ListContributorInsightsPaginator.ts index 4dbe3b72d8d9e..a9f0d6f170d70 100644 --- a/clients/client-dynamodb/pagination/ListContributorInsightsPaginator.ts +++ b/clients/client-dynamodb/pagination/ListContributorInsightsPaginator.ts @@ -8,6 +8,9 @@ import { import { DynamoDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DynamoDBClient, input: ListContributorInsightsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListContributorInsightsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DynamoDB, input: ListContributorInsightsCommandInput, diff --git a/clients/client-dynamodb/pagination/ListExportsPaginator.ts b/clients/client-dynamodb/pagination/ListExportsPaginator.ts index 29cb0fc083549..aba280cf76d09 100644 --- a/clients/client-dynamodb/pagination/ListExportsPaginator.ts +++ b/clients/client-dynamodb/pagination/ListExportsPaginator.ts @@ -4,6 +4,9 @@ import { ListExportsCommand, ListExportsCommandInput, ListExportsCommandOutput } import { DynamoDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DynamoDBClient, input: ListExportsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListExportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DynamoDB, input: ListExportsCommandInput, diff --git a/clients/client-dynamodb/pagination/ListTablesPaginator.ts b/clients/client-dynamodb/pagination/ListTablesPaginator.ts index c2b0554f1f476..fe49ac7eb53ce 100644 --- a/clients/client-dynamodb/pagination/ListTablesPaginator.ts +++ b/clients/client-dynamodb/pagination/ListTablesPaginator.ts @@ -4,6 +4,9 @@ import { ListTablesCommand, ListTablesCommandInput, ListTablesCommandOutput } fr import { DynamoDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: DynamoDBClient, input: ListTablesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: DynamoDB, input: ListTablesCommandInput, diff --git a/clients/client-dynamodb/runtimeConfig.browser.ts b/clients/client-dynamodb/runtimeConfig.browser.ts index a441c32925561..5cb53e6753656 100644 --- a/clients/client-dynamodb/runtimeConfig.browser.ts +++ b/clients/client-dynamodb/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./DynamoDBClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-dynamodb/runtimeConfig.native.ts b/clients/client-dynamodb/runtimeConfig.native.ts index 611563ca10599..f015139582b9d 100644 --- a/clients/client-dynamodb/runtimeConfig.native.ts +++ b/clients/client-dynamodb/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./DynamoDBClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-dynamodb/runtimeConfig.shared.ts b/clients/client-dynamodb/runtimeConfig.shared.ts index 0a74274d52b1f..5621b7688c7f8 100644 --- a/clients/client-dynamodb/runtimeConfig.shared.ts +++ b/clients/client-dynamodb/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-08-10", disableHostPrefix: false, diff --git a/clients/client-dynamodb/runtimeConfig.ts b/clients/client-dynamodb/runtimeConfig.ts index 6b262803ebf18..80e1f5a134398 100644 --- a/clients/client-dynamodb/runtimeConfig.ts +++ b/clients/client-dynamodb/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./DynamoDBClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-dynamodb/tsconfig.json b/clients/client-dynamodb/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-dynamodb/tsconfig.json +++ b/clients/client-dynamodb/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ebs/commands/CompleteSnapshotCommand.ts b/clients/client-ebs/commands/CompleteSnapshotCommand.ts index 45651bd21b1f6..638f56182c9a0 100644 --- a/clients/client-ebs/commands/CompleteSnapshotCommand.ts +++ b/clients/client-ebs/commands/CompleteSnapshotCommand.ts @@ -20,6 +20,11 @@ import { export type CompleteSnapshotCommandInput = CompleteSnapshotRequest; export type CompleteSnapshotCommandOutput = CompleteSnapshotResponse & __MetadataBearer; +/** + *

Seals and completes the snapshot after all of the required blocks of data have been + * written to it. Completing the snapshot changes the status to completed. You + * cannot write new blocks to a snapshot after it has been completed.

+ */ export class CompleteSnapshotCommand extends $Command< CompleteSnapshotCommandInput, CompleteSnapshotCommandOutput, @@ -34,6 +39,9 @@ export class CompleteSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EBSClientResolvedConfig, diff --git a/clients/client-ebs/commands/GetSnapshotBlockCommand.ts b/clients/client-ebs/commands/GetSnapshotBlockCommand.ts index ab1e5a550ec8a..e3fc4d769f7e3 100644 --- a/clients/client-ebs/commands/GetSnapshotBlockCommand.ts +++ b/clients/client-ebs/commands/GetSnapshotBlockCommand.ts @@ -20,6 +20,9 @@ import { export type GetSnapshotBlockCommandInput = GetSnapshotBlockRequest; export type GetSnapshotBlockCommandOutput = GetSnapshotBlockResponse & __MetadataBearer; +/** + *

Returns the data in a block in an Amazon Elastic Block Store snapshot.

+ */ export class GetSnapshotBlockCommand extends $Command< GetSnapshotBlockCommandInput, GetSnapshotBlockCommandOutput, @@ -34,6 +37,9 @@ export class GetSnapshotBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EBSClientResolvedConfig, diff --git a/clients/client-ebs/commands/ListChangedBlocksCommand.ts b/clients/client-ebs/commands/ListChangedBlocksCommand.ts index c9d2ef9cc4575..209524bf9aa2d 100644 --- a/clients/client-ebs/commands/ListChangedBlocksCommand.ts +++ b/clients/client-ebs/commands/ListChangedBlocksCommand.ts @@ -20,6 +20,10 @@ import { export type ListChangedBlocksCommandInput = ListChangedBlocksRequest; export type ListChangedBlocksCommandOutput = ListChangedBlocksResponse & __MetadataBearer; +/** + *

Returns information about the blocks that are different between two + * Amazon Elastic Block Store snapshots of the same volume/snapshot lineage.

+ */ export class ListChangedBlocksCommand extends $Command< ListChangedBlocksCommandInput, ListChangedBlocksCommandOutput, @@ -34,6 +38,9 @@ export class ListChangedBlocksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EBSClientResolvedConfig, diff --git a/clients/client-ebs/commands/ListSnapshotBlocksCommand.ts b/clients/client-ebs/commands/ListSnapshotBlocksCommand.ts index 0f91839c0a753..b09e8e46d2929 100644 --- a/clients/client-ebs/commands/ListSnapshotBlocksCommand.ts +++ b/clients/client-ebs/commands/ListSnapshotBlocksCommand.ts @@ -20,6 +20,9 @@ import { export type ListSnapshotBlocksCommandInput = ListSnapshotBlocksRequest; export type ListSnapshotBlocksCommandOutput = ListSnapshotBlocksResponse & __MetadataBearer; +/** + *

Returns information about the blocks in an Amazon Elastic Block Store snapshot.

+ */ export class ListSnapshotBlocksCommand extends $Command< ListSnapshotBlocksCommandInput, ListSnapshotBlocksCommandOutput, @@ -34,6 +37,9 @@ export class ListSnapshotBlocksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EBSClientResolvedConfig, diff --git a/clients/client-ebs/commands/PutSnapshotBlockCommand.ts b/clients/client-ebs/commands/PutSnapshotBlockCommand.ts index b1f808273f0fe..113d2d8a6e2b6 100644 --- a/clients/client-ebs/commands/PutSnapshotBlockCommand.ts +++ b/clients/client-ebs/commands/PutSnapshotBlockCommand.ts @@ -22,6 +22,12 @@ export type PutSnapshotBlockCommandInput = OmitWrites a block of data to a snapshot. If the specified block contains + * data, the existing data is overwritten. The target snapshot must be in the + * pending state.

+ *

Data written to a snapshot must be aligned with 512-byte sectors.

+ */ export class PutSnapshotBlockCommand extends $Command< PutSnapshotBlockCommandInput, PutSnapshotBlockCommandOutput, @@ -36,6 +42,9 @@ export class PutSnapshotBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EBSClientResolvedConfig, diff --git a/clients/client-ebs/commands/StartSnapshotCommand.ts b/clients/client-ebs/commands/StartSnapshotCommand.ts index 336ead179004f..eea898cecc259 100644 --- a/clients/client-ebs/commands/StartSnapshotCommand.ts +++ b/clients/client-ebs/commands/StartSnapshotCommand.ts @@ -20,6 +20,12 @@ import { export type StartSnapshotCommandInput = StartSnapshotRequest; export type StartSnapshotCommandOutput = StartSnapshotResponse & __MetadataBearer; +/** + *

Creates a new Amazon EBS snapshot. The new snapshot enters the pending state + * after the request completes.

+ *

After creating the snapshot, use PutSnapshotBlock to + * write blocks of data to the snapshot.

+ */ export class StartSnapshotCommand extends $Command< StartSnapshotCommandInput, StartSnapshotCommandOutput, @@ -34,6 +40,9 @@ export class StartSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EBSClientResolvedConfig, diff --git a/clients/client-ebs/package.json b/clients/client-ebs/package.json index 5d0cb470b74e0..87b645e1c3a7d 100644 --- a/clients/client-ebs/package.json +++ b/clients/client-ebs/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ebs Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ebs/pagination/ListChangedBlocksPaginator.ts b/clients/client-ebs/pagination/ListChangedBlocksPaginator.ts index 26bb71ca5148a..a7575b1507bc7 100644 --- a/clients/client-ebs/pagination/ListChangedBlocksPaginator.ts +++ b/clients/client-ebs/pagination/ListChangedBlocksPaginator.ts @@ -8,6 +8,9 @@ import { import { EBSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EBSClient, input: ListChangedBlocksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListChangedBlocksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EBS, input: ListChangedBlocksCommandInput, diff --git a/clients/client-ebs/pagination/ListSnapshotBlocksPaginator.ts b/clients/client-ebs/pagination/ListSnapshotBlocksPaginator.ts index 11690d67bf9b6..85bbeb535f9de 100644 --- a/clients/client-ebs/pagination/ListSnapshotBlocksPaginator.ts +++ b/clients/client-ebs/pagination/ListSnapshotBlocksPaginator.ts @@ -8,6 +8,9 @@ import { import { EBSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EBSClient, input: ListSnapshotBlocksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSnapshotBlocksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EBS, input: ListSnapshotBlocksCommandInput, diff --git a/clients/client-ebs/runtimeConfig.browser.ts b/clients/client-ebs/runtimeConfig.browser.ts index fe66edaf7358b..c49193882b40b 100644 --- a/clients/client-ebs/runtimeConfig.browser.ts +++ b/clients/client-ebs/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./EBSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ebs/runtimeConfig.native.ts b/clients/client-ebs/runtimeConfig.native.ts index 74ec06911d5f1..45a219b271f69 100644 --- a/clients/client-ebs/runtimeConfig.native.ts +++ b/clients/client-ebs/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./EBSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ebs/runtimeConfig.shared.ts b/clients/client-ebs/runtimeConfig.shared.ts index 7aea2b4f0a730..b440335379dbe 100644 --- a/clients/client-ebs/runtimeConfig.shared.ts +++ b/clients/client-ebs/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-11-02", disableHostPrefix: false, diff --git a/clients/client-ebs/runtimeConfig.ts b/clients/client-ebs/runtimeConfig.ts index bd79a7156edca..4c73edb206eae 100644 --- a/clients/client-ebs/runtimeConfig.ts +++ b/clients/client-ebs/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./EBSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ebs/tsconfig.json b/clients/client-ebs/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ebs/tsconfig.json +++ b/clients/client-ebs/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ec2-instance-connect/commands/SendSSHPublicKeyCommand.ts b/clients/client-ec2-instance-connect/commands/SendSSHPublicKeyCommand.ts index 391f070c559c6..0fc7e13e82563 100644 --- a/clients/client-ec2-instance-connect/commands/SendSSHPublicKeyCommand.ts +++ b/clients/client-ec2-instance-connect/commands/SendSSHPublicKeyCommand.ts @@ -24,6 +24,9 @@ import { export type SendSSHPublicKeyCommandInput = SendSSHPublicKeyRequest; export type SendSSHPublicKeyCommandOutput = SendSSHPublicKeyResponse & __MetadataBearer; +/** + *

Pushes an SSH public key to a particular OS user on a given EC2 instance for 60 seconds.

+ */ export class SendSSHPublicKeyCommand extends $Command< SendSSHPublicKeyCommandInput, SendSSHPublicKeyCommandOutput, @@ -38,6 +41,9 @@ export class SendSSHPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2InstanceConnectClientResolvedConfig, diff --git a/clients/client-ec2-instance-connect/package.json b/clients/client-ec2-instance-connect/package.json index 2071e3b7a18c3..77a6ba738a432 100644 --- a/clients/client-ec2-instance-connect/package.json +++ b/clients/client-ec2-instance-connect/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ec2 Instance Connect Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ec2-instance-connect/runtimeConfig.browser.ts b/clients/client-ec2-instance-connect/runtimeConfig.browser.ts index 8f534e92fdd61..119751d44e332 100644 --- a/clients/client-ec2-instance-connect/runtimeConfig.browser.ts +++ b/clients/client-ec2-instance-connect/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./EC2InstanceConnectClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ec2-instance-connect/runtimeConfig.native.ts b/clients/client-ec2-instance-connect/runtimeConfig.native.ts index 33501821bb337..a8c90fe154563 100644 --- a/clients/client-ec2-instance-connect/runtimeConfig.native.ts +++ b/clients/client-ec2-instance-connect/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./EC2InstanceConnectClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ec2-instance-connect/runtimeConfig.shared.ts b/clients/client-ec2-instance-connect/runtimeConfig.shared.ts index 300551b101431..d3ad6c1d51742 100644 --- a/clients/client-ec2-instance-connect/runtimeConfig.shared.ts +++ b/clients/client-ec2-instance-connect/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-04-02", disableHostPrefix: false, diff --git a/clients/client-ec2-instance-connect/runtimeConfig.ts b/clients/client-ec2-instance-connect/runtimeConfig.ts index 954f5331f5b7a..dc88e54cfc039 100644 --- a/clients/client-ec2-instance-connect/runtimeConfig.ts +++ b/clients/client-ec2-instance-connect/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./EC2InstanceConnectClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ec2-instance-connect/tsconfig.json b/clients/client-ec2-instance-connect/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ec2-instance-connect/tsconfig.json +++ b/clients/client-ec2-instance-connect/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ec2/commands/AcceptReservedInstancesExchangeQuoteCommand.ts b/clients/client-ec2/commands/AcceptReservedInstancesExchangeQuoteCommand.ts index 097227dbc7492..44ff11e2abc4d 100644 --- a/clients/client-ec2/commands/AcceptReservedInstancesExchangeQuoteCommand.ts +++ b/clients/client-ec2/commands/AcceptReservedInstancesExchangeQuoteCommand.ts @@ -24,6 +24,9 @@ export type AcceptReservedInstancesExchangeQuoteCommandInput = AcceptReservedIns export type AcceptReservedInstancesExchangeQuoteCommandOutput = AcceptReservedInstancesExchangeQuoteResult & __MetadataBearer; +/** + *

Accepts the Convertible Reserved Instance exchange quote described in the GetReservedInstancesExchangeQuote call.

+ */ export class AcceptReservedInstancesExchangeQuoteCommand extends $Command< AcceptReservedInstancesExchangeQuoteCommandInput, AcceptReservedInstancesExchangeQuoteCommandOutput, @@ -38,6 +41,9 @@ export class AcceptReservedInstancesExchangeQuoteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AcceptTransitGatewayPeeringAttachmentCommand.ts b/clients/client-ec2/commands/AcceptTransitGatewayPeeringAttachmentCommand.ts index cce44d7491250..c743a3759cfe1 100644 --- a/clients/client-ec2/commands/AcceptTransitGatewayPeeringAttachmentCommand.ts +++ b/clients/client-ec2/commands/AcceptTransitGatewayPeeringAttachmentCommand.ts @@ -24,6 +24,10 @@ export type AcceptTransitGatewayPeeringAttachmentCommandInput = AcceptTransitGat export type AcceptTransitGatewayPeeringAttachmentCommandOutput = AcceptTransitGatewayPeeringAttachmentResult & __MetadataBearer; +/** + *

Accepts a transit gateway peering attachment request. The peering attachment must be + * in the pendingAcceptance state.

+ */ export class AcceptTransitGatewayPeeringAttachmentCommand extends $Command< AcceptTransitGatewayPeeringAttachmentCommandInput, AcceptTransitGatewayPeeringAttachmentCommandOutput, @@ -38,6 +42,9 @@ export class AcceptTransitGatewayPeeringAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AcceptTransitGatewayVpcAttachmentCommand.ts b/clients/client-ec2/commands/AcceptTransitGatewayVpcAttachmentCommand.ts index 3950d176a4ba9..7bdec4af4bbf0 100644 --- a/clients/client-ec2/commands/AcceptTransitGatewayVpcAttachmentCommand.ts +++ b/clients/client-ec2/commands/AcceptTransitGatewayVpcAttachmentCommand.ts @@ -20,6 +20,12 @@ import { export type AcceptTransitGatewayVpcAttachmentCommandInput = AcceptTransitGatewayVpcAttachmentRequest; export type AcceptTransitGatewayVpcAttachmentCommandOutput = AcceptTransitGatewayVpcAttachmentResult & __MetadataBearer; +/** + *

Accepts a request to attach a VPC to a transit gateway.

+ *

The VPC attachment must be in the pendingAcceptance state. + * Use DescribeTransitGatewayVpcAttachments to view your pending VPC attachment requests. + * Use RejectTransitGatewayVpcAttachment to reject a VPC attachment request.

+ */ export class AcceptTransitGatewayVpcAttachmentCommand extends $Command< AcceptTransitGatewayVpcAttachmentCommandInput, AcceptTransitGatewayVpcAttachmentCommandOutput, @@ -34,6 +40,9 @@ export class AcceptTransitGatewayVpcAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AcceptVpcEndpointConnectionsCommand.ts b/clients/client-ec2/commands/AcceptVpcEndpointConnectionsCommand.ts index 12c638d87ad3a..355199cb8fe8b 100644 --- a/clients/client-ec2/commands/AcceptVpcEndpointConnectionsCommand.ts +++ b/clients/client-ec2/commands/AcceptVpcEndpointConnectionsCommand.ts @@ -20,6 +20,10 @@ import { export type AcceptVpcEndpointConnectionsCommandInput = AcceptVpcEndpointConnectionsRequest; export type AcceptVpcEndpointConnectionsCommandOutput = AcceptVpcEndpointConnectionsResult & __MetadataBearer; +/** + *

Accepts one or more interface VPC endpoint connection requests to your VPC endpoint + * service.

+ */ export class AcceptVpcEndpointConnectionsCommand extends $Command< AcceptVpcEndpointConnectionsCommandInput, AcceptVpcEndpointConnectionsCommandOutput, @@ -34,6 +38,9 @@ export class AcceptVpcEndpointConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AcceptVpcPeeringConnectionCommand.ts b/clients/client-ec2/commands/AcceptVpcPeeringConnectionCommand.ts index 33b61ab19016f..b1e745e65a1af 100644 --- a/clients/client-ec2/commands/AcceptVpcPeeringConnectionCommand.ts +++ b/clients/client-ec2/commands/AcceptVpcPeeringConnectionCommand.ts @@ -20,6 +20,14 @@ import { export type AcceptVpcPeeringConnectionCommandInput = AcceptVpcPeeringConnectionRequest; export type AcceptVpcPeeringConnectionCommandOutput = AcceptVpcPeeringConnectionResult & __MetadataBearer; +/** + *

Accept a VPC peering connection request. To accept a request, the VPC peering connection must + * be in the pending-acceptance state, and you must be the owner of the peer VPC. + * Use DescribeVpcPeeringConnections to view your outstanding VPC + * peering connection requests.

+ *

For an inter-Region VPC peering connection request, you must accept the VPC peering + * connection in the Region of the accepter VPC.

+ */ export class AcceptVpcPeeringConnectionCommand extends $Command< AcceptVpcPeeringConnectionCommandInput, AcceptVpcPeeringConnectionCommandOutput, @@ -34,6 +42,9 @@ export class AcceptVpcPeeringConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AdvertiseByoipCidrCommand.ts b/clients/client-ec2/commands/AdvertiseByoipCidrCommand.ts index b2cc22bc3abd1..b155175ddc223 100644 --- a/clients/client-ec2/commands/AdvertiseByoipCidrCommand.ts +++ b/clients/client-ec2/commands/AdvertiseByoipCidrCommand.ts @@ -20,6 +20,19 @@ import { export type AdvertiseByoipCidrCommandInput = AdvertiseByoipCidrRequest; export type AdvertiseByoipCidrCommandOutput = AdvertiseByoipCidrResult & __MetadataBearer; +/** + *

Advertises an IPv4 or IPv6 address range that is provisioned for use with your AWS resources through + * bring your own IP addresses (BYOIP).

+ *

You can perform this operation at most once every 10 seconds, even if you specify different + * address ranges each time.

+ *

We recommend that you stop advertising the BYOIP CIDR from other locations when you advertise + * it from AWS. To minimize down time, you can configure your AWS resources to use an address from a + * BYOIP CIDR before it is advertised, and then simultaneously stop advertising it from the current + * location and start advertising it through AWS.

+ *

It can take a few minutes before traffic to the specified addresses starts routing to AWS + * because of BGP propagation delays.

+ *

To stop advertising the BYOIP CIDR, use WithdrawByoipCidr.

+ */ export class AdvertiseByoipCidrCommand extends $Command< AdvertiseByoipCidrCommandInput, AdvertiseByoipCidrCommandOutput, @@ -34,6 +47,9 @@ export class AdvertiseByoipCidrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AllocateAddressCommand.ts b/clients/client-ec2/commands/AllocateAddressCommand.ts index 5eafc0d4a05db..c4f4f75a371cd 100644 --- a/clients/client-ec2/commands/AllocateAddressCommand.ts +++ b/clients/client-ec2/commands/AllocateAddressCommand.ts @@ -17,6 +17,21 @@ import { export type AllocateAddressCommandInput = AllocateAddressRequest; export type AllocateAddressCommandOutput = AllocateAddressResult & __MetadataBearer; +/** + *

Allocates an Elastic IP address to your AWS account. After you allocate the Elastic IP address you can associate + * it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address + * pool and can be allocated to a different AWS account.

+ *

You can allocate an Elastic IP address from an address pool owned by AWS or from an address pool created + * from a public IPv4 address range that you have brought to AWS for use with your AWS resources using bring your own + * IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.

+ *

[EC2-VPC] If you release an Elastic IP address, you might be able to recover it. You cannot recover an + * Elastic IP address that you released after it is allocated to another AWS account. You cannot recover an Elastic IP + * address for EC2-Classic. To attempt to recover an Elastic IP address that you released, specify it in this operation.

+ *

An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate + * 5 Elastic IP addresses for EC2-Classic per Region and 5 Elastic IP addresses for EC2-VPC per Region.

+ *

For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

+ *

You can allocate a carrier IP address which is a public IP address from a telecommunication carrier, to a network interface which resides in a subnet in a Wavelength Zone (for example an EC2 instance).

+ */ export class AllocateAddressCommand extends $Command< AllocateAddressCommandInput, AllocateAddressCommandOutput, @@ -31,6 +46,9 @@ export class AllocateAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AllocateHostsCommand.ts b/clients/client-ec2/commands/AllocateHostsCommand.ts index add98b1b4657c..377b5efcd1aaa 100644 --- a/clients/client-ec2/commands/AllocateHostsCommand.ts +++ b/clients/client-ec2/commands/AllocateHostsCommand.ts @@ -17,6 +17,11 @@ import { export type AllocateHostsCommandInput = AllocateHostsRequest; export type AllocateHostsCommandOutput = AllocateHostsResult & __MetadataBearer; +/** + *

Allocates a Dedicated Host to your account. At a minimum, specify the supported instance + * type or instance family, the Availability Zone in which to allocate the host, and the number of + * hosts to allocate.

+ */ export class AllocateHostsCommand extends $Command< AllocateHostsCommandInput, AllocateHostsCommandOutput, @@ -31,6 +36,9 @@ export class AllocateHostsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ApplySecurityGroupsToClientVpnTargetNetworkCommand.ts b/clients/client-ec2/commands/ApplySecurityGroupsToClientVpnTargetNetworkCommand.ts index d265109d35868..c91993cfe3824 100644 --- a/clients/client-ec2/commands/ApplySecurityGroupsToClientVpnTargetNetworkCommand.ts +++ b/clients/client-ec2/commands/ApplySecurityGroupsToClientVpnTargetNetworkCommand.ts @@ -24,6 +24,10 @@ export type ApplySecurityGroupsToClientVpnTargetNetworkCommandInput = ApplySecur export type ApplySecurityGroupsToClientVpnTargetNetworkCommandOutput = ApplySecurityGroupsToClientVpnTargetNetworkResult & __MetadataBearer; +/** + *

Applies a security group to the association between the target network and the Client VPN endpoint. This action replaces the existing + * security groups with the specified security groups.

+ */ export class ApplySecurityGroupsToClientVpnTargetNetworkCommand extends $Command< ApplySecurityGroupsToClientVpnTargetNetworkCommandInput, ApplySecurityGroupsToClientVpnTargetNetworkCommandOutput, @@ -38,6 +42,9 @@ export class ApplySecurityGroupsToClientVpnTargetNetworkCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssignIpv6AddressesCommand.ts b/clients/client-ec2/commands/AssignIpv6AddressesCommand.ts index dcc89810181b0..084f289f4b59d 100644 --- a/clients/client-ec2/commands/AssignIpv6AddressesCommand.ts +++ b/clients/client-ec2/commands/AssignIpv6AddressesCommand.ts @@ -20,6 +20,15 @@ import { export type AssignIpv6AddressesCommandInput = AssignIpv6AddressesRequest; export type AssignIpv6AddressesCommandOutput = AssignIpv6AddressesResult & __MetadataBearer; +/** + *

Assigns one or more IPv6 addresses to the specified network interface. You can + * specify one or more specific IPv6 addresses, or you can specify the number of IPv6 + * addresses to be automatically assigned from within the subnet's IPv6 CIDR block range. + * You can assign as many IPv6 addresses to a network interface as you can assign private + * IPv4 addresses, and the limit varies per instance type. For information, see IP Addresses Per Network Interface Per Instance Type + * in the Amazon Elastic Compute Cloud User Guide.

+ *

You must specify either the IPv6 addresses or the IPv6 address count in the request.

+ */ export class AssignIpv6AddressesCommand extends $Command< AssignIpv6AddressesCommandInput, AssignIpv6AddressesCommandOutput, @@ -34,6 +43,9 @@ export class AssignIpv6AddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssignPrivateIpAddressesCommand.ts b/clients/client-ec2/commands/AssignPrivateIpAddressesCommand.ts index a7d8bf724a139..8f8ef9b4ab2b6 100644 --- a/clients/client-ec2/commands/AssignPrivateIpAddressesCommand.ts +++ b/clients/client-ec2/commands/AssignPrivateIpAddressesCommand.ts @@ -20,6 +20,20 @@ import { export type AssignPrivateIpAddressesCommandInput = AssignPrivateIpAddressesRequest; export type AssignPrivateIpAddressesCommandOutput = AssignPrivateIpAddressesResult & __MetadataBearer; +/** + *

Assigns one or more secondary private IP addresses to the specified network interface.

+ *

You can specify one or more specific secondary IP addresses, or you can specify the number + * of secondary IP addresses to be automatically assigned within the subnet's CIDR block range. + * The number of secondary IP addresses that you can assign to an instance varies by instance type. + * For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about + * Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

+ *

When you move a secondary private IP address to another network interface, any Elastic IP address + * that is associated with the IP address is also moved.

+ *

Remapping an IP address is an asynchronous operation. When you move an IP address from one network + * interface to another, check network/interfaces/macs/mac/local-ipv4s in the instance + * metadata to confirm that the remapping is complete.

+ *

You must specify either the IP addresses or the IP address count in the request.

+ */ export class AssignPrivateIpAddressesCommand extends $Command< AssignPrivateIpAddressesCommandInput, AssignPrivateIpAddressesCommandOutput, @@ -34,6 +48,9 @@ export class AssignPrivateIpAddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateAddressCommand.ts b/clients/client-ec2/commands/AssociateAddressCommand.ts index c7bd9a238a3a4..62ad6bc1a44f0 100644 --- a/clients/client-ec2/commands/AssociateAddressCommand.ts +++ b/clients/client-ec2/commands/AssociateAddressCommand.ts @@ -20,6 +20,33 @@ import { export type AssociateAddressCommandInput = AssociateAddressRequest; export type AssociateAddressCommandOutput = AssociateAddressResult & __MetadataBearer; +/** + *

Associates an Elastic IP address, or carrier IP address (for instances that are in + * subnets in Wavelength Zones) with an instance or a network interface. Before you can use an + * Elastic IP address, you must allocate it to your account.

+ *

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. + * For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

+ *

[EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already + * associated with a different instance, it is disassociated from that instance and associated + * with the specified instance. If you associate an Elastic IP address with an instance that has + * an existing Elastic IP address, the existing address is disassociated from the instance, but + * remains allocated to your account.

+ *

[VPC in an EC2-Classic account] If you don't specify a private IP address, the Elastic + * IP address is associated with the primary IP address. If the Elastic IP address is already + * associated with a different instance or a network interface, you get an error unless you allow + * reassociation. You cannot associate an Elastic IP address with an instance or network + * interface that has an existing Elastic IP address.

+ *

[Subnets in Wavelength Zones] You can associate an IP address from the telecommunication + * carrier to the instance or network interface.

+ *

You cannot associate an Elastic IP address with an interface in a different network border group.

+ * + *

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 + * doesn't return an error, and you may be charged for each time the Elastic IP address is + * remapped to the same instance. For more information, see the Elastic IP + * Addresses section of Amazon EC2 + * Pricing.

+ *
+ */ export class AssociateAddressCommand extends $Command< AssociateAddressCommandInput, AssociateAddressCommandOutput, @@ -34,6 +61,9 @@ export class AssociateAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateClientVpnTargetNetworkCommand.ts b/clients/client-ec2/commands/AssociateClientVpnTargetNetworkCommand.ts index 5f87eba369d6f..7e1f5468fde0b 100644 --- a/clients/client-ec2/commands/AssociateClientVpnTargetNetworkCommand.ts +++ b/clients/client-ec2/commands/AssociateClientVpnTargetNetworkCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateClientVpnTargetNetworkCommandInput = AssociateClientVpnTargetNetworkRequest; export type AssociateClientVpnTargetNetworkCommandOutput = AssociateClientVpnTargetNetworkResult & __MetadataBearer; +/** + *

Associates a target network with a Client VPN endpoint. A target network is a subnet in a VPC. You can associate multiple subnets from the same VPC with a Client VPN endpoint. You can associate only one subnet in each Availability Zone. We recommend that you associate at least two subnets to provide Availability Zone redundancy.

+ *

If you specified a VPC when you created the Client VPN endpoint or if you have previous subnet associations, the specified subnet must be in the same VPC. To specify a subnet that's in a different VPC, you must first modify the Client VPN endpoint (ModifyClientVpnEndpoint) and change the VPC that's associated with it.

+ */ export class AssociateClientVpnTargetNetworkCommand extends $Command< AssociateClientVpnTargetNetworkCommandInput, AssociateClientVpnTargetNetworkCommandOutput, @@ -34,6 +38,9 @@ export class AssociateClientVpnTargetNetworkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateDhcpOptionsCommand.ts b/clients/client-ec2/commands/AssociateDhcpOptionsCommand.ts index c8ef55741019b..c1bcea5b6424f 100644 --- a/clients/client-ec2/commands/AssociateDhcpOptionsCommand.ts +++ b/clients/client-ec2/commands/AssociateDhcpOptionsCommand.ts @@ -20,6 +20,12 @@ import { export type AssociateDhcpOptionsCommandInput = AssociateDhcpOptionsRequest; export type AssociateDhcpOptionsCommandOutput = __MetadataBearer; +/** + *

Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.

+ *

After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

+ *

For more information, see DHCP Options Sets + * in the Amazon Virtual Private Cloud User Guide.

+ */ export class AssociateDhcpOptionsCommand extends $Command< AssociateDhcpOptionsCommandInput, AssociateDhcpOptionsCommandOutput, @@ -34,6 +40,9 @@ export class AssociateDhcpOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateEnclaveCertificateIamRoleCommand.ts b/clients/client-ec2/commands/AssociateEnclaveCertificateIamRoleCommand.ts index 1934046bdb382..35c766e8c4534 100644 --- a/clients/client-ec2/commands/AssociateEnclaveCertificateIamRoleCommand.ts +++ b/clients/client-ec2/commands/AssociateEnclaveCertificateIamRoleCommand.ts @@ -24,6 +24,23 @@ export type AssociateEnclaveCertificateIamRoleCommandInput = AssociateEnclaveCer export type AssociateEnclaveCertificateIamRoleCommandOutput = AssociateEnclaveCertificateIamRoleResult & __MetadataBearer; +/** + *

Associates an AWS Identity and Access Management (IAM) role with an AWS Certificate Manager (ACM) certificate. + * This enables the certificate to be used by the ACM for Nitro Enclaves application inside an enclave. For more + * information, see AWS Certificate + * Manager for Nitro Enclaves in the AWS Nitro Enclaves User Guide.

+ * + *

When the IAM role is associated with the ACM certificate, places the certificate, certificate chain, and encrypted + * private key in an Amazon S3 bucket that only the associated IAM role can access. The private key of the certificate + * is encrypted with an AWS-managed KMS customer master (CMK) that has an attached attestation-based CMK policy.

+ * + *

To enable the IAM role to access the Amazon S3 object, you must grant it permission to call s3:GetObject + * on the Amazon S3 bucket returned by the command. To enable the IAM role to access the AWS KMS CMK, you must + * grant it permission to call kms:Decrypt on AWS KMS CMK returned by the command. For more + * information, see + * Grant the role permission to access the certificate and encryption key in the + * AWS Nitro Enclaves User Guide.

+ */ export class AssociateEnclaveCertificateIamRoleCommand extends $Command< AssociateEnclaveCertificateIamRoleCommandInput, AssociateEnclaveCertificateIamRoleCommandOutput, @@ -38,6 +55,9 @@ export class AssociateEnclaveCertificateIamRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateIamInstanceProfileCommand.ts b/clients/client-ec2/commands/AssociateIamInstanceProfileCommand.ts index d2fe35aa0784c..a7e75c51839be 100644 --- a/clients/client-ec2/commands/AssociateIamInstanceProfileCommand.ts +++ b/clients/client-ec2/commands/AssociateIamInstanceProfileCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateIamInstanceProfileCommandInput = AssociateIamInstanceProfileRequest; export type AssociateIamInstanceProfileCommandOutput = AssociateIamInstanceProfileResult & __MetadataBearer; +/** + *

Associates an IAM instance profile with a running or stopped instance. You cannot + * associate more than one IAM instance profile with an instance.

+ */ export class AssociateIamInstanceProfileCommand extends $Command< AssociateIamInstanceProfileCommandInput, AssociateIamInstanceProfileCommandOutput, @@ -34,6 +38,9 @@ export class AssociateIamInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateRouteTableCommand.ts b/clients/client-ec2/commands/AssociateRouteTableCommand.ts index ced5b9c72b89e..e62a563490dcc 100644 --- a/clients/client-ec2/commands/AssociateRouteTableCommand.ts +++ b/clients/client-ec2/commands/AssociateRouteTableCommand.ts @@ -20,6 +20,15 @@ import { export type AssociateRouteTableCommandInput = AssociateRouteTableRequest; export type AssociateRouteTableCommandOutput = AssociateRouteTableResult & __MetadataBearer; +/** + *

Associates a subnet in your VPC or an internet gateway or virtual private gateway + * attached to your VPC with a route table in your VPC. This association causes traffic + * from the subnet or gateway to be routed according to the routes in the route table. The + * action returns an association ID, which you need in order to disassociate the route + * table later. A route table can be associated with multiple subnets.

+ *

For more information, see Route Tables in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class AssociateRouteTableCommand extends $Command< AssociateRouteTableCommandInput, AssociateRouteTableCommandOutput, @@ -34,6 +43,9 @@ export class AssociateRouteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateSubnetCidrBlockCommand.ts b/clients/client-ec2/commands/AssociateSubnetCidrBlockCommand.ts index cc656c81a527e..071fc832490a6 100644 --- a/clients/client-ec2/commands/AssociateSubnetCidrBlockCommand.ts +++ b/clients/client-ec2/commands/AssociateSubnetCidrBlockCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateSubnetCidrBlockCommandInput = AssociateSubnetCidrBlockRequest; export type AssociateSubnetCidrBlockCommandOutput = AssociateSubnetCidrBlockResult & __MetadataBearer; +/** + *

Associates a CIDR block with your subnet. You can only associate a single IPv6 CIDR + * block with your subnet. An IPv6 CIDR block must have a prefix length of /64.

+ */ export class AssociateSubnetCidrBlockCommand extends $Command< AssociateSubnetCidrBlockCommandInput, AssociateSubnetCidrBlockCommandOutput, @@ -34,6 +38,9 @@ export class AssociateSubnetCidrBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateTransitGatewayMulticastDomainCommand.ts b/clients/client-ec2/commands/AssociateTransitGatewayMulticastDomainCommand.ts index 1d5528651a130..8b5cdd08a1f62 100644 --- a/clients/client-ec2/commands/AssociateTransitGatewayMulticastDomainCommand.ts +++ b/clients/client-ec2/commands/AssociateTransitGatewayMulticastDomainCommand.ts @@ -24,6 +24,10 @@ export type AssociateTransitGatewayMulticastDomainCommandInput = AssociateTransi export type AssociateTransitGatewayMulticastDomainCommandOutput = AssociateTransitGatewayMulticastDomainResult & __MetadataBearer; +/** + *

Associates the specified subnets and transit gateway attachments with the specified transit gateway multicast domain.

+ *

The transit gateway attachment must be in the available state before you can add a resource. Use DescribeTransitGatewayAttachments to see the state of the attachment.

+ */ export class AssociateTransitGatewayMulticastDomainCommand extends $Command< AssociateTransitGatewayMulticastDomainCommandInput, AssociateTransitGatewayMulticastDomainCommandOutput, @@ -38,6 +42,9 @@ export class AssociateTransitGatewayMulticastDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateTransitGatewayRouteTableCommand.ts b/clients/client-ec2/commands/AssociateTransitGatewayRouteTableCommand.ts index 767013c49b002..038b9b46cbca3 100644 --- a/clients/client-ec2/commands/AssociateTransitGatewayRouteTableCommand.ts +++ b/clients/client-ec2/commands/AssociateTransitGatewayRouteTableCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateTransitGatewayRouteTableCommandInput = AssociateTransitGatewayRouteTableRequest; export type AssociateTransitGatewayRouteTableCommandOutput = AssociateTransitGatewayRouteTableResult & __MetadataBearer; +/** + *

Associates the specified attachment with the specified transit gateway route table. You can + * associate only one route table with an attachment.

+ */ export class AssociateTransitGatewayRouteTableCommand extends $Command< AssociateTransitGatewayRouteTableCommandInput, AssociateTransitGatewayRouteTableCommandOutput, @@ -34,6 +38,9 @@ export class AssociateTransitGatewayRouteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AssociateVpcCidrBlockCommand.ts b/clients/client-ec2/commands/AssociateVpcCidrBlockCommand.ts index b802b243ae3e0..7a425e6a26f13 100644 --- a/clients/client-ec2/commands/AssociateVpcCidrBlockCommand.ts +++ b/clients/client-ec2/commands/AssociateVpcCidrBlockCommand.ts @@ -20,6 +20,17 @@ import { export type AssociateVpcCidrBlockCommandInput = AssociateVpcCidrBlockRequest; export type AssociateVpcCidrBlockCommandOutput = AssociateVpcCidrBlockResult & __MetadataBearer; +/** + *

Associates a CIDR block with your VPC. You can associate a secondary IPv4 CIDR block, + * an Amazon-provided IPv6 CIDR block, or an IPv6 CIDR block from an IPv6 address pool that + * you provisioned through bring your own IP addresses (BYOIP). The IPv6 CIDR block size is fixed + * at /56.

+ *

You must specify one of the following in the request: an IPv4 CIDR block, an IPv6 + * pool, or an Amazon-provided IPv6 CIDR block.

+ *

For more information about associating CIDR blocks with your VPC and applicable + * restrictions, see VPC and Subnet Sizing in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class AssociateVpcCidrBlockCommand extends $Command< AssociateVpcCidrBlockCommandInput, AssociateVpcCidrBlockCommandOutput, @@ -34,6 +45,9 @@ export class AssociateVpcCidrBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AttachClassicLinkVpcCommand.ts b/clients/client-ec2/commands/AttachClassicLinkVpcCommand.ts index bfc28e2baef91..0aaafc021d5f8 100644 --- a/clients/client-ec2/commands/AttachClassicLinkVpcCommand.ts +++ b/clients/client-ec2/commands/AttachClassicLinkVpcCommand.ts @@ -20,6 +20,15 @@ import { export type AttachClassicLinkVpcCommandInput = AttachClassicLinkVpcRequest; export type AttachClassicLinkVpcCommandOutput = AttachClassicLinkVpcResult & __MetadataBearer; +/** + *

Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC's + * security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You + * can only link an instance that's in the running state. An instance is + * automatically unlinked from a VPC when it's stopped - you can link it to the VPC again when + * you restart it.

+ *

After you've linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

+ *

Linking your instance to a VPC is sometimes referred to as attaching your instance.

+ */ export class AttachClassicLinkVpcCommand extends $Command< AttachClassicLinkVpcCommandInput, AttachClassicLinkVpcCommandOutput, @@ -34,6 +43,9 @@ export class AttachClassicLinkVpcCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AttachInternetGatewayCommand.ts b/clients/client-ec2/commands/AttachInternetGatewayCommand.ts index 7302c36227e36..265779c49b1c2 100644 --- a/clients/client-ec2/commands/AttachInternetGatewayCommand.ts +++ b/clients/client-ec2/commands/AttachInternetGatewayCommand.ts @@ -20,6 +20,10 @@ import { export type AttachInternetGatewayCommandInput = AttachInternetGatewayRequest; export type AttachInternetGatewayCommandOutput = __MetadataBearer; +/** + *

Attaches an internet gateway or a virtual private gateway to a VPC, enabling connectivity between the internet and + * the VPC. For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

+ */ export class AttachInternetGatewayCommand extends $Command< AttachInternetGatewayCommandInput, AttachInternetGatewayCommandOutput, @@ -34,6 +38,9 @@ export class AttachInternetGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AttachNetworkInterfaceCommand.ts b/clients/client-ec2/commands/AttachNetworkInterfaceCommand.ts index 6cede2fff0f71..3e9beddd7abe4 100644 --- a/clients/client-ec2/commands/AttachNetworkInterfaceCommand.ts +++ b/clients/client-ec2/commands/AttachNetworkInterfaceCommand.ts @@ -20,6 +20,9 @@ import { export type AttachNetworkInterfaceCommandInput = AttachNetworkInterfaceRequest; export type AttachNetworkInterfaceCommandOutput = AttachNetworkInterfaceResult & __MetadataBearer; +/** + *

Attaches a network interface to an instance.

+ */ export class AttachNetworkInterfaceCommand extends $Command< AttachNetworkInterfaceCommandInput, AttachNetworkInterfaceCommandOutput, @@ -34,6 +37,9 @@ export class AttachNetworkInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AttachVolumeCommand.ts b/clients/client-ec2/commands/AttachVolumeCommand.ts index 3fd768676dcd8..9f98f8032dfd8 100644 --- a/clients/client-ec2/commands/AttachVolumeCommand.ts +++ b/clients/client-ec2/commands/AttachVolumeCommand.ts @@ -17,6 +17,33 @@ import { export type AttachVolumeCommandInput = AttachVolumeRequest; export type AttachVolumeCommandOutput = VolumeAttachment & __MetadataBearer; +/** + *

Attaches an EBS volume to a running or stopped instance and exposes it to the instance + * with the specified device name.

+ *

Encrypted EBS volumes must be attached to instances that support Amazon EBS encryption. For + * more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

+ *

After you attach an EBS volume, you must make it available. For more information, see + * Making an EBS volume available for use.

+ *

If a volume has an AWS Marketplace product code:

+ *
    + *
  • + *

    The volume can be attached only to a stopped instance.

    + *
  • + *
  • + *

    AWS Marketplace product codes are copied from the volume to the instance.

    + *
  • + *
  • + *

    You must be subscribed to the product.

    + *
  • + *
  • + *

    The instance type and operating system of the instance must support the product. For + * example, you can't detach a volume from a Windows instance and attach it to a Linux + * instance.

    + *
  • + *
+ *

For more information, see Attaching Amazon EBS volumes in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class AttachVolumeCommand extends $Command< AttachVolumeCommandInput, AttachVolumeCommandOutput, @@ -31,6 +58,9 @@ export class AttachVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AttachVpnGatewayCommand.ts b/clients/client-ec2/commands/AttachVpnGatewayCommand.ts index d8953c6d89d58..0a832ea4f36e9 100644 --- a/clients/client-ec2/commands/AttachVpnGatewayCommand.ts +++ b/clients/client-ec2/commands/AttachVpnGatewayCommand.ts @@ -20,6 +20,11 @@ import { export type AttachVpnGatewayCommandInput = AttachVpnGatewayRequest; export type AttachVpnGatewayCommandOutput = AttachVpnGatewayResult & __MetadataBearer; +/** + *

Attaches a virtual private gateway to a VPC. You can attach one virtual private + * gateway to one VPC at a time.

+ *

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

+ */ export class AttachVpnGatewayCommand extends $Command< AttachVpnGatewayCommandInput, AttachVpnGatewayCommandOutput, @@ -34,6 +39,9 @@ export class AttachVpnGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AuthorizeClientVpnIngressCommand.ts b/clients/client-ec2/commands/AuthorizeClientVpnIngressCommand.ts index ccc6af11cc7eb..abaf3813c6da0 100644 --- a/clients/client-ec2/commands/AuthorizeClientVpnIngressCommand.ts +++ b/clients/client-ec2/commands/AuthorizeClientVpnIngressCommand.ts @@ -20,6 +20,11 @@ import { export type AuthorizeClientVpnIngressCommandInput = AuthorizeClientVpnIngressRequest; export type AuthorizeClientVpnIngressCommandOutput = AuthorizeClientVpnIngressResult & __MetadataBearer; +/** + *

Adds an ingress authorization rule to a Client VPN endpoint. Ingress authorization rules act as + * firewall rules that grant access to networks. You must configure ingress authorization rules to + * enable clients to access resources in AWS or on-premises networks.

+ */ export class AuthorizeClientVpnIngressCommand extends $Command< AuthorizeClientVpnIngressCommandInput, AuthorizeClientVpnIngressCommandOutput, @@ -34,6 +39,9 @@ export class AuthorizeClientVpnIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AuthorizeSecurityGroupEgressCommand.ts b/clients/client-ec2/commands/AuthorizeSecurityGroupEgressCommand.ts index 16c605c45014f..6a0974c212bfc 100644 --- a/clients/client-ec2/commands/AuthorizeSecurityGroupEgressCommand.ts +++ b/clients/client-ec2/commands/AuthorizeSecurityGroupEgressCommand.ts @@ -20,6 +20,17 @@ import { export type AuthorizeSecurityGroupEgressCommandInput = AuthorizeSecurityGroupEgressRequest; export type AuthorizeSecurityGroupEgressCommandOutput = __MetadataBearer; +/** + *

[VPC only] Adds the specified egress rules to a security group for use with a VPC.

+ *

An outbound rule permits instances to send traffic to the specified IPv4 or IPv6 CIDR + * address ranges, or to the instances associated with the specified destination security groups.

+ *

You specify a protocol for each rule (for example, TCP). + * For the TCP and UDP protocols, you must also specify the destination port or port range. + * For the ICMP protocol, you must also specify the ICMP type and code. + * You can use -1 for the type or code to mean all types or all codes.

+ *

Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

+ *

For more information about VPC security group limits, see Amazon VPC Limits.

+ */ export class AuthorizeSecurityGroupEgressCommand extends $Command< AuthorizeSecurityGroupEgressCommandInput, AuthorizeSecurityGroupEgressCommandOutput, @@ -34,6 +45,9 @@ export class AuthorizeSecurityGroupEgressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/AuthorizeSecurityGroupIngressCommand.ts b/clients/client-ec2/commands/AuthorizeSecurityGroupIngressCommand.ts index 1105c5533b841..41af7f321d9bc 100644 --- a/clients/client-ec2/commands/AuthorizeSecurityGroupIngressCommand.ts +++ b/clients/client-ec2/commands/AuthorizeSecurityGroupIngressCommand.ts @@ -20,6 +20,18 @@ import { export type AuthorizeSecurityGroupIngressCommandInput = AuthorizeSecurityGroupIngressRequest; export type AuthorizeSecurityGroupIngressCommandOutput = __MetadataBearer; +/** + *

Adds the specified ingress rules to a security group.

+ *

An inbound rule permits instances to receive traffic from the specified IPv4 or IPv6 CIDR + * address ranges, or from the instances associated with the specified destination security groups.

+ *

You specify a protocol for each rule (for example, TCP). + * For TCP and UDP, you must also specify the destination port or port range. + * For ICMP/ICMPv6, you must also specify the ICMP/ICMPv6 type and code. + * You can use -1 to mean all types or all codes.

+ *

Rule changes are propagated to instances within the security group as quickly as possible. + * However, a small delay might occur.

+ *

For more information about VPC security group limits, see Amazon VPC Limits.

+ */ export class AuthorizeSecurityGroupIngressCommand extends $Command< AuthorizeSecurityGroupIngressCommandInput, AuthorizeSecurityGroupIngressCommandOutput, @@ -34,6 +46,9 @@ export class AuthorizeSecurityGroupIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/BundleInstanceCommand.ts b/clients/client-ec2/commands/BundleInstanceCommand.ts index 286a4051a52c0..255215323822b 100644 --- a/clients/client-ec2/commands/BundleInstanceCommand.ts +++ b/clients/client-ec2/commands/BundleInstanceCommand.ts @@ -17,6 +17,13 @@ import { export type BundleInstanceCommandInput = BundleInstanceRequest; export type BundleInstanceCommandOutput = BundleInstanceResult & __MetadataBearer; +/** + *

Bundles an Amazon instance store-backed Windows instance.

+ *

During bundling, only the root device volume (C:\) is bundled. Data on other instance store volumes is not preserved.

+ * + *

This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

+ *
+ */ export class BundleInstanceCommand extends $Command< BundleInstanceCommandInput, BundleInstanceCommandOutput, @@ -31,6 +38,9 @@ export class BundleInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CancelBundleTaskCommand.ts b/clients/client-ec2/commands/CancelBundleTaskCommand.ts index 67f68f9986043..8f852ec55129f 100644 --- a/clients/client-ec2/commands/CancelBundleTaskCommand.ts +++ b/clients/client-ec2/commands/CancelBundleTaskCommand.ts @@ -20,6 +20,9 @@ import { export type CancelBundleTaskCommandInput = CancelBundleTaskRequest; export type CancelBundleTaskCommandOutput = CancelBundleTaskResult & __MetadataBearer; +/** + *

Cancels a bundling operation for an instance store-backed Windows instance.

+ */ export class CancelBundleTaskCommand extends $Command< CancelBundleTaskCommandInput, CancelBundleTaskCommandOutput, @@ -34,6 +37,9 @@ export class CancelBundleTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CancelCapacityReservationCommand.ts b/clients/client-ec2/commands/CancelCapacityReservationCommand.ts index 49721d344b9ae..d3a0febc6eb72 100644 --- a/clients/client-ec2/commands/CancelCapacityReservationCommand.ts +++ b/clients/client-ec2/commands/CancelCapacityReservationCommand.ts @@ -20,6 +20,14 @@ import { export type CancelCapacityReservationCommandInput = CancelCapacityReservationRequest; export type CancelCapacityReservationCommandOutput = CancelCapacityReservationResult & __MetadataBearer; +/** + *

Cancels the specified Capacity Reservation, releases the reserved capacity, and changes the Capacity Reservation's state to + * cancelled.

+ *

Instances running in the reserved capacity continue running until you stop them. Stopped + * instances that target the Capacity Reservation can no longer launch. Modify these instances to either + * target a different Capacity Reservation, launch On-Demand Instance capacity, or run in any open Capacity Reservation + * that has matching attributes and sufficient capacity.

+ */ export class CancelCapacityReservationCommand extends $Command< CancelCapacityReservationCommandInput, CancelCapacityReservationCommandOutput, @@ -34,6 +42,9 @@ export class CancelCapacityReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CancelConversionTaskCommand.ts b/clients/client-ec2/commands/CancelConversionTaskCommand.ts index 8e39fe9a675ba..6a55606ed4540 100644 --- a/clients/client-ec2/commands/CancelConversionTaskCommand.ts +++ b/clients/client-ec2/commands/CancelConversionTaskCommand.ts @@ -20,6 +20,13 @@ import { export type CancelConversionTaskCommandInput = CancelConversionRequest; export type CancelConversionTaskCommandOutput = __MetadataBearer; +/** + *

Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all + * artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is + * in the process of transferring the final disk image, the command fails and returns an exception.

+ *

For more information, see Importing a Virtual Machine Using the Amazon + * EC2 CLI.

+ */ export class CancelConversionTaskCommand extends $Command< CancelConversionTaskCommandInput, CancelConversionTaskCommandOutput, @@ -34,6 +41,9 @@ export class CancelConversionTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CancelExportTaskCommand.ts b/clients/client-ec2/commands/CancelExportTaskCommand.ts index 62a53bae9e36b..90adebe816ad0 100644 --- a/clients/client-ec2/commands/CancelExportTaskCommand.ts +++ b/clients/client-ec2/commands/CancelExportTaskCommand.ts @@ -20,6 +20,11 @@ import { export type CancelExportTaskCommandInput = CancelExportTaskRequest; export type CancelExportTaskCommandOutput = __MetadataBearer; +/** + *

Cancels an active export task. The request removes all artifacts of the export, including any partially-created + * Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the + * command fails and returns an error.

+ */ export class CancelExportTaskCommand extends $Command< CancelExportTaskCommandInput, CancelExportTaskCommandOutput, @@ -34,6 +39,9 @@ export class CancelExportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CancelImportTaskCommand.ts b/clients/client-ec2/commands/CancelImportTaskCommand.ts index 69d8c963aecf9..1c81c51d052a7 100644 --- a/clients/client-ec2/commands/CancelImportTaskCommand.ts +++ b/clients/client-ec2/commands/CancelImportTaskCommand.ts @@ -20,6 +20,9 @@ import { export type CancelImportTaskCommandInput = CancelImportTaskRequest; export type CancelImportTaskCommandOutput = CancelImportTaskResult & __MetadataBearer; +/** + *

Cancels an in-process import virtual machine or import snapshot task.

+ */ export class CancelImportTaskCommand extends $Command< CancelImportTaskCommandInput, CancelImportTaskCommandOutput, @@ -34,6 +37,9 @@ export class CancelImportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CancelReservedInstancesListingCommand.ts b/clients/client-ec2/commands/CancelReservedInstancesListingCommand.ts index fb446fcc52121..85e021587fcc1 100644 --- a/clients/client-ec2/commands/CancelReservedInstancesListingCommand.ts +++ b/clients/client-ec2/commands/CancelReservedInstancesListingCommand.ts @@ -20,6 +20,12 @@ import { export type CancelReservedInstancesListingCommandInput = CancelReservedInstancesListingRequest; export type CancelReservedInstancesListingCommandOutput = CancelReservedInstancesListingResult & __MetadataBearer; +/** + *

Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

+ *

For more information, see + * Reserved Instance Marketplace + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class CancelReservedInstancesListingCommand extends $Command< CancelReservedInstancesListingCommandInput, CancelReservedInstancesListingCommandOutput, @@ -34,6 +40,9 @@ export class CancelReservedInstancesListingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CancelSpotFleetRequestsCommand.ts b/clients/client-ec2/commands/CancelSpotFleetRequestsCommand.ts index 7c31cf4827c25..bb262c974ae60 100644 --- a/clients/client-ec2/commands/CancelSpotFleetRequestsCommand.ts +++ b/clients/client-ec2/commands/CancelSpotFleetRequestsCommand.ts @@ -20,6 +20,14 @@ import { export type CancelSpotFleetRequestsCommandInput = CancelSpotFleetRequestsRequest; export type CancelSpotFleetRequestsCommandOutput = CancelSpotFleetRequestsResponse & __MetadataBearer; +/** + *

Cancels the specified Spot Fleet requests.

+ *

After you cancel a Spot Fleet request, the Spot Fleet launches no new Spot Instances. + * You must specify whether the Spot Fleet should also terminate its Spot Instances. + * If you terminate the instances, the Spot Fleet request enters the cancelled_terminating state. + * Otherwise, the Spot Fleet request enters the cancelled_running state and the instances + * continue to run until they are interrupted or you terminate them manually.

+ */ export class CancelSpotFleetRequestsCommand extends $Command< CancelSpotFleetRequestsCommandInput, CancelSpotFleetRequestsCommandOutput, @@ -34,6 +42,9 @@ export class CancelSpotFleetRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CancelSpotInstanceRequestsCommand.ts b/clients/client-ec2/commands/CancelSpotInstanceRequestsCommand.ts index d30b3d7b1b3f1..642e267bc48bb 100644 --- a/clients/client-ec2/commands/CancelSpotInstanceRequestsCommand.ts +++ b/clients/client-ec2/commands/CancelSpotInstanceRequestsCommand.ts @@ -20,6 +20,12 @@ import { export type CancelSpotInstanceRequestsCommandInput = CancelSpotInstanceRequestsRequest; export type CancelSpotInstanceRequestsCommandOutput = CancelSpotInstanceRequestsResult & __MetadataBearer; +/** + *

Cancels one or more Spot Instance requests.

+ * + *

Canceling a Spot Instance request does not terminate running Spot Instances associated with the request.

+ *
+ */ export class CancelSpotInstanceRequestsCommand extends $Command< CancelSpotInstanceRequestsCommandInput, CancelSpotInstanceRequestsCommandOutput, @@ -34,6 +40,9 @@ export class CancelSpotInstanceRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ConfirmProductInstanceCommand.ts b/clients/client-ec2/commands/ConfirmProductInstanceCommand.ts index 1299ef649224c..eca7631fdafd0 100644 --- a/clients/client-ec2/commands/ConfirmProductInstanceCommand.ts +++ b/clients/client-ec2/commands/ConfirmProductInstanceCommand.ts @@ -20,6 +20,11 @@ import { export type ConfirmProductInstanceCommandInput = ConfirmProductInstanceRequest; export type ConfirmProductInstanceCommandOutput = ConfirmProductInstanceResult & __MetadataBearer; +/** + *

Determines whether a product code is associated with an instance. This action can only + * be used by the owner of the product code. It is useful when a product code owner must + * verify whether another user's instance is eligible for support.

+ */ export class ConfirmProductInstanceCommand extends $Command< ConfirmProductInstanceCommandInput, ConfirmProductInstanceCommandOutput, @@ -34,6 +39,9 @@ export class ConfirmProductInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CopyFpgaImageCommand.ts b/clients/client-ec2/commands/CopyFpgaImageCommand.ts index 535078f6e06b2..9c3e11b8ed5ab 100644 --- a/clients/client-ec2/commands/CopyFpgaImageCommand.ts +++ b/clients/client-ec2/commands/CopyFpgaImageCommand.ts @@ -17,6 +17,9 @@ import { export type CopyFpgaImageCommandInput = CopyFpgaImageRequest; export type CopyFpgaImageCommandOutput = CopyFpgaImageResult & __MetadataBearer; +/** + *

Copies the specified Amazon FPGA Image (AFI) to the current Region.

+ */ export class CopyFpgaImageCommand extends $Command< CopyFpgaImageCommandInput, CopyFpgaImageCommandOutput, @@ -31,6 +34,9 @@ export class CopyFpgaImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CopyImageCommand.ts b/clients/client-ec2/commands/CopyImageCommand.ts index f6f15407f5106..536421696e6d5 100644 --- a/clients/client-ec2/commands/CopyImageCommand.ts +++ b/clients/client-ec2/commands/CopyImageCommand.ts @@ -17,6 +17,14 @@ import { export type CopyImageCommandInput = CopyImageRequest; export type CopyImageCommandOutput = CopyImageResult & __MetadataBearer; +/** + *

Initiates the copy of an AMI from the specified source Region to the current Region. You specify the destination Region by using its endpoint when making the request.

+ *

Copies of encrypted backing snapshots for the AMI are encrypted. Copies of unencrypted backing snapshots + * remain unencrypted, unless you set Encrypted during the copy operation. You cannot create an unencrypted + * copy of an encrypted backing snapshot.

+ *

For more information about the prerequisites and limits when copying an AMI, see Copying an AMI + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class CopyImageCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +35,9 @@ export class CopyImageCommand extends $Command, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CopySnapshotCommand.ts b/clients/client-ec2/commands/CopySnapshotCommand.ts index 8f0b0e127dc51..f6e1dc26ce743 100644 --- a/clients/client-ec2/commands/CopySnapshotCommand.ts +++ b/clients/client-ec2/commands/CopySnapshotCommand.ts @@ -18,6 +18,21 @@ import { export type CopySnapshotCommandInput = CopySnapshotRequest; export type CopySnapshotCommandOutput = CopySnapshotResult & __MetadataBearer; +/** + *

Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the + * snapshot within the same Region or from one Region to another. You can use the snapshot to + * create EBS volumes or Amazon Machine Images (AMIs).

+ *

Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain + * unencrypted, unless you enable encryption for the snapshot copy operation. By default, encrypted + * snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a + * different CMK.

+ *

To copy an encrypted snapshot that has been shared from another account, you must have + * permissions for the CMK used to encrypt the snapshot.

+ *

Snapshots created by copying another snapshot have an arbitrary volume ID that should not + * be used for any purpose.

+ *

For more information, see Copying an Amazon EBS snapshot in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class CopySnapshotCommand extends $Command< CopySnapshotCommandInput, CopySnapshotCommandOutput, @@ -32,6 +47,9 @@ export class CopySnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateCapacityReservationCommand.ts b/clients/client-ec2/commands/CreateCapacityReservationCommand.ts index 3e19b6d765e46..29fec3235a8e5 100644 --- a/clients/client-ec2/commands/CreateCapacityReservationCommand.ts +++ b/clients/client-ec2/commands/CreateCapacityReservationCommand.ts @@ -20,6 +20,25 @@ import { export type CreateCapacityReservationCommandInput = CreateCapacityReservationRequest; export type CreateCapacityReservationCommandOutput = CreateCapacityReservationResult & __MetadataBearer; +/** + *

Creates a new Capacity Reservation with the specified attributes.

+ *

Capacity Reservations enable you to reserve capacity for your Amazon EC2 instances in a specific Availability Zone for any duration. This + * gives you the flexibility to selectively add capacity reservations and still get the Regional RI discounts for that usage. + * By creating Capacity Reservations, you ensure that you always have access to Amazon EC2 capacity when you need it, for as long as you need it. + * For more information, see Capacity Reservations in the Amazon Elastic Compute Cloud User Guide.

+ * + *

Your request to create a Capacity Reservation could fail if Amazon EC2 does not have sufficient capacity to + * fulfill the request. If your request fails due to Amazon EC2 capacity constraints, either try + * again at a later time, try in a different Availability Zone, or request a smaller + * capacity reservation. If your application is flexible across instance types and sizes, + * try to create a Capacity Reservation with different instance attributes.

+ * + *

Your request could also fail if the requested quantity exceeds your On-Demand Instance + * limit for the selected instance type. If your request fails due to limit constraints, + * increase your On-Demand Instance limit for the required instance type and try again. For + * more information about increasing your instance limits, see Amazon EC2 Service + * Limits in the Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateCapacityReservationCommand extends $Command< CreateCapacityReservationCommandInput, CreateCapacityReservationCommandOutput, @@ -34,6 +53,9 @@ export class CreateCapacityReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateCarrierGatewayCommand.ts b/clients/client-ec2/commands/CreateCarrierGatewayCommand.ts index ed241d28670cf..66a4339f2b34d 100644 --- a/clients/client-ec2/commands/CreateCarrierGatewayCommand.ts +++ b/clients/client-ec2/commands/CreateCarrierGatewayCommand.ts @@ -20,6 +20,10 @@ import { export type CreateCarrierGatewayCommandInput = CreateCarrierGatewayRequest; export type CreateCarrierGatewayCommandOutput = CreateCarrierGatewayResult & __MetadataBearer; +/** + *

Creates a carrier gateway. For more information about carrier gateways, see Carrier gateways in the AWS Wavelength Developer + * Guide.

+ */ export class CreateCarrierGatewayCommand extends $Command< CreateCarrierGatewayCommandInput, CreateCarrierGatewayCommandOutput, @@ -34,6 +38,9 @@ export class CreateCarrierGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateClientVpnEndpointCommand.ts b/clients/client-ec2/commands/CreateClientVpnEndpointCommand.ts index 8a8e65a16e5a0..e5beb1a351021 100644 --- a/clients/client-ec2/commands/CreateClientVpnEndpointCommand.ts +++ b/clients/client-ec2/commands/CreateClientVpnEndpointCommand.ts @@ -20,6 +20,11 @@ import { export type CreateClientVpnEndpointCommandInput = CreateClientVpnEndpointRequest; export type CreateClientVpnEndpointCommandOutput = CreateClientVpnEndpointResult & __MetadataBearer; +/** + *

Creates a Client VPN endpoint. A Client VPN endpoint is the resource you create and configure to + * enable and manage client VPN sessions. It is the destination endpoint at which all client VPN sessions + * are terminated.

+ */ export class CreateClientVpnEndpointCommand extends $Command< CreateClientVpnEndpointCommandInput, CreateClientVpnEndpointCommandOutput, @@ -34,6 +39,9 @@ export class CreateClientVpnEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateClientVpnRouteCommand.ts b/clients/client-ec2/commands/CreateClientVpnRouteCommand.ts index e8d68aeeab292..da9999bdc5805 100644 --- a/clients/client-ec2/commands/CreateClientVpnRouteCommand.ts +++ b/clients/client-ec2/commands/CreateClientVpnRouteCommand.ts @@ -20,6 +20,10 @@ import { export type CreateClientVpnRouteCommandInput = CreateClientVpnRouteRequest; export type CreateClientVpnRouteCommandOutput = CreateClientVpnRouteResult & __MetadataBearer; +/** + *

Adds a route to a network to a Client VPN endpoint. Each Client VPN endpoint has a route table that describes the + * available destination network routes. Each route in the route table specifies the path for traffic to specific resources or networks.

+ */ export class CreateClientVpnRouteCommand extends $Command< CreateClientVpnRouteCommandInput, CreateClientVpnRouteCommandOutput, @@ -34,6 +38,9 @@ export class CreateClientVpnRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateCustomerGatewayCommand.ts b/clients/client-ec2/commands/CreateCustomerGatewayCommand.ts index ac3c712c358da..42efc8560a035 100644 --- a/clients/client-ec2/commands/CreateCustomerGatewayCommand.ts +++ b/clients/client-ec2/commands/CreateCustomerGatewayCommand.ts @@ -20,6 +20,44 @@ import { export type CreateCustomerGatewayCommandInput = CreateCustomerGatewayRequest; export type CreateCustomerGatewayCommandOutput = CreateCustomerGatewayResult & __MetadataBearer; +/** + *

Provides information to AWS about your VPN customer gateway device. The customer + * gateway is the appliance at your end of the VPN connection. (The device on the AWS side + * of the VPN connection is the virtual private gateway.) You must provide the + * internet-routable IP address of the customer gateway's external interface. The IP + * address must be static and can be behind a device performing network address translation + * (NAT).

+ *

For devices that use Border Gateway Protocol (BGP), you can also provide the device's + * BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your + * network. If you don't have an ASN already, you can use a private ASN (in the 64512 - + * 65534 range).

+ * + *

Amazon EC2 supports all 4-byte ASN numbers in the range of 1 - 2147483647, with the + * exception of the following:

+ *
    + *
  • + *

    7224 - reserved in the us-east-1 Region

    + *
  • + *
  • + *

    9059 - reserved in the eu-west-1 Region

    + *
  • + *
  • + *

    17943 - reserved in the ap-southeast-1 Region

    + *
  • + *
  • + *

    10124 - reserved in the ap-northeast-1 Region

    + *
  • + *
+ *
+ *

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN + * User Guide.

+ * + *

To create more than one customer gateway with the same VPN type, IP address, and + * BGP ASN, specify a unique device name for each customer gateway. Identical requests + * return information about the existing customer gateway and do not create new + * customer gateways.

+ *
+ */ export class CreateCustomerGatewayCommand extends $Command< CreateCustomerGatewayCommandInput, CreateCustomerGatewayCommandOutput, @@ -34,6 +72,9 @@ export class CreateCustomerGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateDefaultSubnetCommand.ts b/clients/client-ec2/commands/CreateDefaultSubnetCommand.ts index e589beb42c6bb..2be69531efb1c 100644 --- a/clients/client-ec2/commands/CreateDefaultSubnetCommand.ts +++ b/clients/client-ec2/commands/CreateDefaultSubnetCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDefaultSubnetCommandInput = CreateDefaultSubnetRequest; export type CreateDefaultSubnetCommandOutput = CreateDefaultSubnetResult & __MetadataBearer; +/** + *

Creates a default subnet with a size /20 IPv4 CIDR block in the + * specified Availability Zone in your default VPC. You can have only one default subnet + * per Availability Zone. For more information, see Creating a Default + * Subnet in the Amazon Virtual Private Cloud User Guide.

+ */ export class CreateDefaultSubnetCommand extends $Command< CreateDefaultSubnetCommandInput, CreateDefaultSubnetCommandOutput, @@ -34,6 +40,9 @@ export class CreateDefaultSubnetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateDefaultVpcCommand.ts b/clients/client-ec2/commands/CreateDefaultVpcCommand.ts index d5fcf9ac8f547..9a9386e85ea23 100644 --- a/clients/client-ec2/commands/CreateDefaultVpcCommand.ts +++ b/clients/client-ec2/commands/CreateDefaultVpcCommand.ts @@ -20,6 +20,20 @@ import { export type CreateDefaultVpcCommandInput = CreateDefaultVpcRequest; export type CreateDefaultVpcCommandOutput = CreateDefaultVpcResult & __MetadataBearer; +/** + *

Creates a default VPC with a size /16 IPv4 CIDR block and a default subnet + * in each Availability Zone. For more information about the components of a default VPC, + * see Default VPC and + * Default Subnets in the Amazon Virtual Private Cloud User Guide. You cannot + * specify the components of the default VPC yourself.

+ *

If you deleted your previous default VPC, you can create a default VPC. You cannot have + * more than one default VPC per Region.

+ *

If your account supports EC2-Classic, you cannot use this action to create a default VPC + * in a Region that supports EC2-Classic. If you want a default VPC in a Region that + * supports EC2-Classic, see "I really want a default VPC for my existing EC2 account. Is + * that possible?" in the Default VPCs + * FAQ.

+ */ export class CreateDefaultVpcCommand extends $Command< CreateDefaultVpcCommandInput, CreateDefaultVpcCommandOutput, @@ -34,6 +48,9 @@ export class CreateDefaultVpcCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateDhcpOptionsCommand.ts b/clients/client-ec2/commands/CreateDhcpOptionsCommand.ts index b2783641f401c..ce002a2dce226 100644 --- a/clients/client-ec2/commands/CreateDhcpOptionsCommand.ts +++ b/clients/client-ec2/commands/CreateDhcpOptionsCommand.ts @@ -20,6 +20,61 @@ import { export type CreateDhcpOptionsCommandInput = CreateDhcpOptionsRequest; export type CreateDhcpOptionsCommandOutput = CreateDhcpOptionsResult & __MetadataBearer; +/** + *

Creates a set of DHCP options for your VPC. After creating the set, you must + * associate it with the VPC, causing all existing and new instances that you launch in + * the VPC to use this set of DHCP options. The following are the individual DHCP + * options you can specify. For more information about the options, see RFC 2132.

+ *
    + *
  • + *

    + * domain-name-servers - The IP addresses of up to four domain name + * servers, or AmazonProvidedDNS. The default DHCP option set specifies + * AmazonProvidedDNS. If specifying more than one domain name server, specify the + * IP addresses in a single parameter, separated by commas. To have your instance + * receive a custom DNS hostname as specified in domain-name, you must + * set domain-name-servers to a custom DNS server.

    + *
  • + *
  • + *

    + * domain-name - If you're using AmazonProvidedDNS in + * us-east-1, specify ec2.internal. If you're using + * AmazonProvidedDNS in another Region, specify + * region.compute.internal (for example, + * ap-northeast-1.compute.internal). Otherwise, specify a domain + * name (for example, ExampleCompany.com). This value is used to complete + * unqualified DNS hostnames. Important: Some + * Linux operating systems accept multiple domain names separated by spaces. + * However, Windows and other Linux operating systems treat the value as a single + * domain, which results in unexpected behavior. If your DHCP options set is + * associated with a VPC that has instances with multiple operating systems, + * specify only one domain name.

    + *
  • + *
  • + *

    + * ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) + * servers.

    + *
  • + *
  • + *

    + * netbios-name-servers - The IP addresses of up to four NetBIOS name + * servers.

    + *
  • + *
  • + *

    + * netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that + * you specify 2 (broadcast and multicast are not currently supported). For more information + * about these node types, see RFC 2132.

    + *
  • + *
+ * + *

Your VPC automatically starts out with a set of DHCP options that includes only a DNS + * server that we provide (AmazonProvidedDNS). If you create a set of options, and if your + * VPC has an internet gateway, make sure to set the domain-name-servers + * option either to AmazonProvidedDNS or to a domain name server of your + * choice. For more information, see DHCP Options Sets in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class CreateDhcpOptionsCommand extends $Command< CreateDhcpOptionsCommandInput, CreateDhcpOptionsCommandOutput, @@ -34,6 +89,9 @@ export class CreateDhcpOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateEgressOnlyInternetGatewayCommand.ts b/clients/client-ec2/commands/CreateEgressOnlyInternetGatewayCommand.ts index f578a3c66d464..e42603f41ec20 100644 --- a/clients/client-ec2/commands/CreateEgressOnlyInternetGatewayCommand.ts +++ b/clients/client-ec2/commands/CreateEgressOnlyInternetGatewayCommand.ts @@ -20,6 +20,12 @@ import { export type CreateEgressOnlyInternetGatewayCommandInput = CreateEgressOnlyInternetGatewayRequest; export type CreateEgressOnlyInternetGatewayCommandOutput = CreateEgressOnlyInternetGatewayResult & __MetadataBearer; +/** + *

[IPv6 only] Creates an egress-only internet gateway for your VPC. An egress-only + * internet gateway is used to enable outbound communication over IPv6 from instances in + * your VPC to the internet, and prevents hosts outside of your VPC from initiating an IPv6 + * connection with your instance.

+ */ export class CreateEgressOnlyInternetGatewayCommand extends $Command< CreateEgressOnlyInternetGatewayCommandInput, CreateEgressOnlyInternetGatewayCommandOutput, @@ -34,6 +40,9 @@ export class CreateEgressOnlyInternetGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateFleetCommand.ts b/clients/client-ec2/commands/CreateFleetCommand.ts index b79dfc957c634..5d6e0660c52e4 100644 --- a/clients/client-ec2/commands/CreateFleetCommand.ts +++ b/clients/client-ec2/commands/CreateFleetCommand.ts @@ -17,6 +17,12 @@ import { export type CreateFleetCommandInput = CreateFleetRequest; export type CreateFleetCommandOutput = CreateFleetResult & __MetadataBearer; +/** + *

Launches an EC2 Fleet.

+ *

You can create a single EC2 Fleet that includes multiple launch specifications that vary by + * instance type, AMI, Availability Zone, or subnet.

+ *

For more information, see Launching an EC2 Fleet in the Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateFleetCommand extends $Command< CreateFleetCommandInput, CreateFleetCommandOutput, @@ -31,6 +37,9 @@ export class CreateFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateFlowLogsCommand.ts b/clients/client-ec2/commands/CreateFlowLogsCommand.ts index 7097006c5511c..5936b52c2cc77 100644 --- a/clients/client-ec2/commands/CreateFlowLogsCommand.ts +++ b/clients/client-ec2/commands/CreateFlowLogsCommand.ts @@ -17,6 +17,22 @@ import { export type CreateFlowLogsCommandInput = CreateFlowLogsRequest; export type CreateFlowLogsCommandOutput = CreateFlowLogsResult & __MetadataBearer; +/** + *

Creates one or more flow logs to capture information about IP traffic for a specific network interface, + * subnet, or VPC.

+ * + *

Flow log data for a monitored network interface is recorded as flow log records, which are log events + * consisting of fields that describe the traffic flow. For more information, see + * Flow Log Records + * in the Amazon Virtual Private Cloud User Guide.

+ * + *

When publishing to CloudWatch Logs, flow log records are published to a log group, and each network + * interface has a unique log stream in the log group. When publishing to Amazon S3, flow log records for all + * of the monitored network interfaces are published to a single log file object that is stored in the specified + * bucket.

+ * + *

For more information, see VPC Flow Logs in the Amazon Virtual Private Cloud User Guide.

+ */ export class CreateFlowLogsCommand extends $Command< CreateFlowLogsCommandInput, CreateFlowLogsCommandOutput, @@ -31,6 +47,9 @@ export class CreateFlowLogsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateFpgaImageCommand.ts b/clients/client-ec2/commands/CreateFpgaImageCommand.ts index 536ce1967abf2..58df9fc7aea62 100644 --- a/clients/client-ec2/commands/CreateFpgaImageCommand.ts +++ b/clients/client-ec2/commands/CreateFpgaImageCommand.ts @@ -17,6 +17,14 @@ import { export type CreateFpgaImageCommandInput = CreateFpgaImageRequest; export type CreateFpgaImageCommandOutput = CreateFpgaImageResult & __MetadataBearer; +/** + *

Creates an Amazon FPGA Image (AFI) from the specified design checkpoint (DCP).

+ *

The create operation is asynchronous. To verify that the AFI is ready for use, + * check the output logs.

+ *

An AFI contains the FPGA bitstream that is ready to download to an FPGA. + * You can securely deploy an AFI on multiple FPGA-accelerated instances. + * For more information, see the AWS FPGA Hardware Development Kit.

+ */ export class CreateFpgaImageCommand extends $Command< CreateFpgaImageCommandInput, CreateFpgaImageCommandOutput, @@ -31,6 +39,9 @@ export class CreateFpgaImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateImageCommand.ts b/clients/client-ec2/commands/CreateImageCommand.ts index 9aa751bf45a49..c933c1d336061 100644 --- a/clients/client-ec2/commands/CreateImageCommand.ts +++ b/clients/client-ec2/commands/CreateImageCommand.ts @@ -17,6 +17,12 @@ import { export type CreateImageCommandInput = CreateImageRequest; export type CreateImageCommandOutput = CreateImageResult & __MetadataBearer; +/** + *

Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

+ *

If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

+ *

For more information, see Creating Amazon EBS-Backed Linux AMIs + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateImageCommand extends $Command< CreateImageCommandInput, CreateImageCommandOutput, @@ -31,6 +37,9 @@ export class CreateImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateInstanceExportTaskCommand.ts b/clients/client-ec2/commands/CreateInstanceExportTaskCommand.ts index da3cbabc8e59c..0b17c77638457 100644 --- a/clients/client-ec2/commands/CreateInstanceExportTaskCommand.ts +++ b/clients/client-ec2/commands/CreateInstanceExportTaskCommand.ts @@ -20,6 +20,12 @@ import { export type CreateInstanceExportTaskCommandInput = CreateInstanceExportTaskRequest; export type CreateInstanceExportTaskCommandOutput = CreateInstanceExportTaskResult & __MetadataBearer; +/** + *

Exports a running or stopped instance to an Amazon S3 bucket.

+ *

For information about the supported operating systems, image formats, and known limitations for the types of + * instances you can export, see Exporting an Instance as + * a VM Using VM Import/Export in the VM Import/Export User Guide.

+ */ export class CreateInstanceExportTaskCommand extends $Command< CreateInstanceExportTaskCommandInput, CreateInstanceExportTaskCommandOutput, @@ -34,6 +40,9 @@ export class CreateInstanceExportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateInternetGatewayCommand.ts b/clients/client-ec2/commands/CreateInternetGatewayCommand.ts index 6dc06245b3379..fcb689e361e20 100644 --- a/clients/client-ec2/commands/CreateInternetGatewayCommand.ts +++ b/clients/client-ec2/commands/CreateInternetGatewayCommand.ts @@ -20,6 +20,11 @@ import { export type CreateInternetGatewayCommandInput = CreateInternetGatewayRequest; export type CreateInternetGatewayCommandOutput = CreateInternetGatewayResult & __MetadataBearer; +/** + *

Creates an internet gateway for use with a VPC. After creating the internet gateway, + * you attach it to a VPC using AttachInternetGateway.

+ *

For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

+ */ export class CreateInternetGatewayCommand extends $Command< CreateInternetGatewayCommandInput, CreateInternetGatewayCommandOutput, @@ -34,6 +39,9 @@ export class CreateInternetGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateKeyPairCommand.ts b/clients/client-ec2/commands/CreateKeyPairCommand.ts index 5f2a33965d36d..0a166aa181693 100644 --- a/clients/client-ec2/commands/CreateKeyPairCommand.ts +++ b/clients/client-ec2/commands/CreateKeyPairCommand.ts @@ -17,6 +17,18 @@ import { export type CreateKeyPairCommandInput = CreateKeyPairRequest; export type CreateKeyPairCommandOutput = KeyPair & __MetadataBearer; +/** + *

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public + * key and displays the private key for you to save to a file. The private key is returned + * as an unencrypted PEM encoded PKCS#1 private key. If a key with the specified name + * already exists, Amazon EC2 returns an error.

+ *

You can have up to five thousand key pairs per Region.

+ *

The key pair returned to you is available only in the Region in which you create it. + * If you prefer, you can create your own key pair using a third-party tool and upload it + * to any Region using ImportKeyPair.

+ *

For more information, see Key Pairs in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateKeyPairCommand extends $Command< CreateKeyPairCommandInput, CreateKeyPairCommandOutput, @@ -31,6 +43,9 @@ export class CreateKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateLaunchTemplateCommand.ts b/clients/client-ec2/commands/CreateLaunchTemplateCommand.ts index d0021870fd05f..578909455e8e9 100644 --- a/clients/client-ec2/commands/CreateLaunchTemplateCommand.ts +++ b/clients/client-ec2/commands/CreateLaunchTemplateCommand.ts @@ -20,6 +20,13 @@ import { export type CreateLaunchTemplateCommandInput = CreateLaunchTemplateRequest; export type CreateLaunchTemplateCommandOutput = CreateLaunchTemplateResult & __MetadataBearer; +/** + *

Creates a launch template. A launch template contains the parameters to launch an + * instance. When you launch an instance using RunInstances, you can + * specify a launch template instead of providing the launch parameters in the request. For + * more information, see Launching an instance from a + * launch templatein the Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateLaunchTemplateCommand extends $Command< CreateLaunchTemplateCommandInput, CreateLaunchTemplateCommandOutput, @@ -34,6 +41,9 @@ export class CreateLaunchTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateLaunchTemplateVersionCommand.ts b/clients/client-ec2/commands/CreateLaunchTemplateVersionCommand.ts index bf907842647c0..a87fe158f73e3 100644 --- a/clients/client-ec2/commands/CreateLaunchTemplateVersionCommand.ts +++ b/clients/client-ec2/commands/CreateLaunchTemplateVersionCommand.ts @@ -20,6 +20,14 @@ import { export type CreateLaunchTemplateVersionCommandInput = CreateLaunchTemplateVersionRequest; export type CreateLaunchTemplateVersionCommandOutput = CreateLaunchTemplateVersionResult & __MetadataBearer; +/** + *

Creates a new version for a launch template. You can specify an existing version of + * launch template from which to base the new version.

+ *

Launch template versions are numbered in the order in which they are created. You + * cannot specify, change, or replace the numbering of launch template versions.

+ *

For + * more information, see Managing launch template versionsin the Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateLaunchTemplateVersionCommand extends $Command< CreateLaunchTemplateVersionCommandInput, CreateLaunchTemplateVersionCommandOutput, @@ -34,6 +42,9 @@ export class CreateLaunchTemplateVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateLocalGatewayRouteCommand.ts b/clients/client-ec2/commands/CreateLocalGatewayRouteCommand.ts index 98b3656cc658b..c83993adff4ba 100644 --- a/clients/client-ec2/commands/CreateLocalGatewayRouteCommand.ts +++ b/clients/client-ec2/commands/CreateLocalGatewayRouteCommand.ts @@ -20,6 +20,9 @@ import { export type CreateLocalGatewayRouteCommandInput = CreateLocalGatewayRouteRequest; export type CreateLocalGatewayRouteCommandOutput = CreateLocalGatewayRouteResult & __MetadataBearer; +/** + *

Creates a static route for the specified local gateway route table.

+ */ export class CreateLocalGatewayRouteCommand extends $Command< CreateLocalGatewayRouteCommandInput, CreateLocalGatewayRouteCommandOutput, @@ -34,6 +37,9 @@ export class CreateLocalGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateLocalGatewayRouteTableVpcAssociationCommand.ts b/clients/client-ec2/commands/CreateLocalGatewayRouteTableVpcAssociationCommand.ts index ea48cd1f095b6..fc0ccdb60c6d5 100644 --- a/clients/client-ec2/commands/CreateLocalGatewayRouteTableVpcAssociationCommand.ts +++ b/clients/client-ec2/commands/CreateLocalGatewayRouteTableVpcAssociationCommand.ts @@ -24,6 +24,9 @@ export type CreateLocalGatewayRouteTableVpcAssociationCommandInput = CreateLocal export type CreateLocalGatewayRouteTableVpcAssociationCommandOutput = CreateLocalGatewayRouteTableVpcAssociationResult & __MetadataBearer; +/** + *

Associates the specified VPC with the specified local gateway route table.

+ */ export class CreateLocalGatewayRouteTableVpcAssociationCommand extends $Command< CreateLocalGatewayRouteTableVpcAssociationCommandInput, CreateLocalGatewayRouteTableVpcAssociationCommandOutput, @@ -38,6 +41,9 @@ export class CreateLocalGatewayRouteTableVpcAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateManagedPrefixListCommand.ts b/clients/client-ec2/commands/CreateManagedPrefixListCommand.ts index 0f4161d8f1df4..2700bc718386f 100644 --- a/clients/client-ec2/commands/CreateManagedPrefixListCommand.ts +++ b/clients/client-ec2/commands/CreateManagedPrefixListCommand.ts @@ -20,6 +20,10 @@ import { export type CreateManagedPrefixListCommandInput = CreateManagedPrefixListRequest; export type CreateManagedPrefixListCommandOutput = CreateManagedPrefixListResult & __MetadataBearer; +/** + *

Creates a managed prefix list. You can specify one or more entries for the prefix list. Each entry consists of a CIDR block and an optional description.

+ *

You must specify the maximum number of entries for the prefix list. The maximum number of entries cannot be changed later.

+ */ export class CreateManagedPrefixListCommand extends $Command< CreateManagedPrefixListCommandInput, CreateManagedPrefixListCommandOutput, @@ -34,6 +38,9 @@ export class CreateManagedPrefixListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateNatGatewayCommand.ts b/clients/client-ec2/commands/CreateNatGatewayCommand.ts index 75aea7d0bff60..c588582dac43d 100644 --- a/clients/client-ec2/commands/CreateNatGatewayCommand.ts +++ b/clients/client-ec2/commands/CreateNatGatewayCommand.ts @@ -20,6 +20,14 @@ import { export type CreateNatGatewayCommandInput = CreateNatGatewayRequest; export type CreateNatGatewayCommandOutput = CreateNatGatewayResult & __MetadataBearer; +/** + *

Creates a NAT gateway in the specified public subnet. This action creates a network + * interface in the specified subnet with a private IP address from the IP address range of + * the subnet. Internet-bound traffic from a private subnet can be routed to the NAT + * gateway, therefore enabling instances in the private subnet to connect to the internet. + * For more information, see NAT Gateways in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class CreateNatGatewayCommand extends $Command< CreateNatGatewayCommandInput, CreateNatGatewayCommandOutput, @@ -34,6 +42,9 @@ export class CreateNatGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateNetworkAclCommand.ts b/clients/client-ec2/commands/CreateNetworkAclCommand.ts index 0e7f66362cc16..7ffde5a6d2271 100644 --- a/clients/client-ec2/commands/CreateNetworkAclCommand.ts +++ b/clients/client-ec2/commands/CreateNetworkAclCommand.ts @@ -20,6 +20,11 @@ import { export type CreateNetworkAclCommandInput = CreateNetworkAclRequest; export type CreateNetworkAclCommandOutput = CreateNetworkAclResult & __MetadataBearer; +/** + *

Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

+ *

For more information, see Network ACLs in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class CreateNetworkAclCommand extends $Command< CreateNetworkAclCommandInput, CreateNetworkAclCommandOutput, @@ -34,6 +39,9 @@ export class CreateNetworkAclCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateNetworkAclEntryCommand.ts b/clients/client-ec2/commands/CreateNetworkAclEntryCommand.ts index be0e19de15c8a..0c1202fb12873 100644 --- a/clients/client-ec2/commands/CreateNetworkAclEntryCommand.ts +++ b/clients/client-ec2/commands/CreateNetworkAclEntryCommand.ts @@ -20,6 +20,16 @@ import { export type CreateNetworkAclEntryCommandInput = CreateNetworkAclEntryRequest; export type CreateNetworkAclEntryCommandOutput = __MetadataBearer; +/** + *

Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules + * and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated + * with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of + * ingress rules and a separate set of egress rules.

+ *

We recommend that you leave room between the rule numbers (for example, 100, 110, 120, ...), and not number them one right after the + * other (for example, 101, 102, 103, ...). This makes it easier to add a rule between existing ones without having to renumber the rules.

+ *

After you add an entry, you can't modify it; you must either replace it, or create an entry and delete the old one.

+ *

For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

+ */ export class CreateNetworkAclEntryCommand extends $Command< CreateNetworkAclEntryCommandInput, CreateNetworkAclEntryCommandOutput, @@ -34,6 +44,9 @@ export class CreateNetworkAclEntryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateNetworkInterfaceCommand.ts b/clients/client-ec2/commands/CreateNetworkInterfaceCommand.ts index 626cc49e4774a..aec401e3638e7 100644 --- a/clients/client-ec2/commands/CreateNetworkInterfaceCommand.ts +++ b/clients/client-ec2/commands/CreateNetworkInterfaceCommand.ts @@ -20,6 +20,11 @@ import { export type CreateNetworkInterfaceCommandInput = CreateNetworkInterfaceRequest; export type CreateNetworkInterfaceCommandOutput = CreateNetworkInterfaceResult & __MetadataBearer; +/** + *

Creates a network interface in the specified subnet.

+ *

For more information about network interfaces, see Elastic Network Interfaces + * in the Amazon Virtual Private Cloud User Guide.

+ */ export class CreateNetworkInterfaceCommand extends $Command< CreateNetworkInterfaceCommandInput, CreateNetworkInterfaceCommandOutput, @@ -34,6 +39,9 @@ export class CreateNetworkInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateNetworkInterfacePermissionCommand.ts b/clients/client-ec2/commands/CreateNetworkInterfacePermissionCommand.ts index a34e4204ceddb..cdf58b25056f4 100644 --- a/clients/client-ec2/commands/CreateNetworkInterfacePermissionCommand.ts +++ b/clients/client-ec2/commands/CreateNetworkInterfacePermissionCommand.ts @@ -20,6 +20,11 @@ import { export type CreateNetworkInterfacePermissionCommandInput = CreateNetworkInterfacePermissionRequest; export type CreateNetworkInterfacePermissionCommandOutput = CreateNetworkInterfacePermissionResult & __MetadataBearer; +/** + *

Grants an AWS-authorized account permission to attach the specified network interface to + * an instance in their account.

+ *

You can grant permission to a single AWS account only, and only one account at a time.

+ */ export class CreateNetworkInterfacePermissionCommand extends $Command< CreateNetworkInterfacePermissionCommandInput, CreateNetworkInterfacePermissionCommandOutput, @@ -34,6 +39,9 @@ export class CreateNetworkInterfacePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreatePlacementGroupCommand.ts b/clients/client-ec2/commands/CreatePlacementGroupCommand.ts index fca15634f0eea..e90a939239663 100644 --- a/clients/client-ec2/commands/CreatePlacementGroupCommand.ts +++ b/clients/client-ec2/commands/CreatePlacementGroupCommand.ts @@ -20,6 +20,18 @@ import { export type CreatePlacementGroupCommandInput = CreatePlacementGroupRequest; export type CreatePlacementGroupCommandOutput = CreatePlacementGroupResult & __MetadataBearer; +/** + *

Creates a placement group in which to launch instances. The strategy of the placement + * group determines how the instances are organized within the group.

+ *

A cluster placement group is a logical grouping of instances within a + * single Availability Zone that benefit from low network latency, high network throughput. + * A spread placement group places instances on distinct hardware. A + * partition placement group places groups of instances in different + * partitions, where instances in one partition do not share the same hardware with + * instances in another partition.

+ *

For more information, see Placement groups in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class CreatePlacementGroupCommand extends $Command< CreatePlacementGroupCommandInput, CreatePlacementGroupCommandOutput, @@ -34,6 +46,9 @@ export class CreatePlacementGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateReservedInstancesListingCommand.ts b/clients/client-ec2/commands/CreateReservedInstancesListingCommand.ts index 10c5fddd1e0e1..ff34d460f8cec 100644 --- a/clients/client-ec2/commands/CreateReservedInstancesListingCommand.ts +++ b/clients/client-ec2/commands/CreateReservedInstancesListingCommand.ts @@ -20,6 +20,24 @@ import { export type CreateReservedInstancesListingCommandInput = CreateReservedInstancesListingRequest; export type CreateReservedInstancesListingCommandOutput = CreateReservedInstancesListingResult & __MetadataBearer; +/** + *

Creates a listing for Amazon EC2 Standard Reserved Instances to be sold in the Reserved Instance + * Marketplace. You can submit one Standard Reserved Instance listing at a time. To get a list of your + * Standard Reserved Instances, you can use the DescribeReservedInstances operation.

+ * + *

Only Standard Reserved Instances can be sold in the Reserved Instance Marketplace. + * Convertible Reserved Instances cannot be sold.

+ *
+ *

The Reserved Instance Marketplace matches sellers who want to resell Standard Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

+ *

To sell your Standard Reserved Instances, you must first register as a seller in the Reserved Instance + * Marketplace. After completing the registration process, you can create a Reserved Instance + * Marketplace listing of some or all of your Standard Reserved Instances, and specify the upfront price + * to receive for them. Your Standard Reserved Instance listings then become available for purchase. To + * view the details of your Standard Reserved Instance listing, you can use the + * DescribeReservedInstancesListings operation.

+ *

For more information, see Reserved Instance Marketplace in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateReservedInstancesListingCommand extends $Command< CreateReservedInstancesListingCommandInput, CreateReservedInstancesListingCommandOutput, @@ -34,6 +52,9 @@ export class CreateReservedInstancesListingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateRouteCommand.ts b/clients/client-ec2/commands/CreateRouteCommand.ts index f1881e8a0cfbe..aa1b05dd624ab 100644 --- a/clients/client-ec2/commands/CreateRouteCommand.ts +++ b/clients/client-ec2/commands/CreateRouteCommand.ts @@ -17,6 +17,29 @@ import { export type CreateRouteCommandInput = CreateRouteRequest; export type CreateRouteCommandOutput = CreateRouteResult & __MetadataBearer; +/** + *

Creates a route in a route table within a VPC.

+ *

You must specify one of the following targets: internet gateway or virtual private + * gateway, NAT instance, NAT gateway, VPC peering connection, network interface, egress-only internet gateway, or transit gateway.

+ *

When determining how to route traffic, we use the route with the most specific match. + * For example, traffic is destined for the IPv4 address 192.0.2.3, and the + * route table includes the following two IPv4 routes:

+ *
    + *
  • + *

    + * 192.0.2.0/24 (goes to some target A)

    + *
  • + *
  • + *

    + * 192.0.2.0/28 (goes to some target B)

    + *
  • + *
+ *

Both routes apply to the traffic destined for 192.0.2.3. However, the second route + * in the list covers a smaller number of IP addresses and is therefore more specific, + * so we use that route to determine where to target the traffic.

+ *

For more information about route tables, see Route Tables in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class CreateRouteCommand extends $Command< CreateRouteCommandInput, CreateRouteCommandOutput, @@ -31,6 +54,9 @@ export class CreateRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateRouteTableCommand.ts b/clients/client-ec2/commands/CreateRouteTableCommand.ts index 1c3a193fd8b13..28ad4a4793b8f 100644 --- a/clients/client-ec2/commands/CreateRouteTableCommand.ts +++ b/clients/client-ec2/commands/CreateRouteTableCommand.ts @@ -20,6 +20,11 @@ import { export type CreateRouteTableCommandInput = CreateRouteTableRequest; export type CreateRouteTableCommandOutput = CreateRouteTableResult & __MetadataBearer; +/** + *

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

+ *

For more information, see Route Tables in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class CreateRouteTableCommand extends $Command< CreateRouteTableCommandInput, CreateRouteTableCommandOutput, @@ -34,6 +39,9 @@ export class CreateRouteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateSecurityGroupCommand.ts b/clients/client-ec2/commands/CreateSecurityGroupCommand.ts index da510c8dfd57d..64a3f21862b0e 100644 --- a/clients/client-ec2/commands/CreateSecurityGroupCommand.ts +++ b/clients/client-ec2/commands/CreateSecurityGroupCommand.ts @@ -20,6 +20,23 @@ import { export type CreateSecurityGroupCommandInput = CreateSecurityGroupRequest; export type CreateSecurityGroupCommandOutput = CreateSecurityGroupResult & __MetadataBearer; +/** + *

Creates a security group.

+ *

A security group acts as a virtual firewall for your instance to control inbound and outbound traffic. + * For more information, see + * Amazon EC2 Security Groups in + * the Amazon Elastic Compute Cloud User Guide and + * Security Groups for Your VPC in the + * Amazon Virtual Private Cloud User Guide.

+ *

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

+ *

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

+ *

You can add or remove rules from your security groups using + * AuthorizeSecurityGroupIngress, + * AuthorizeSecurityGroupEgress, + * RevokeSecurityGroupIngress, and + * RevokeSecurityGroupEgress.

+ *

For more information about VPC security group limits, see Amazon VPC Limits.

+ */ export class CreateSecurityGroupCommand extends $Command< CreateSecurityGroupCommandInput, CreateSecurityGroupCommandOutput, @@ -34,6 +51,9 @@ export class CreateSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateSnapshotCommand.ts b/clients/client-ec2/commands/CreateSnapshotCommand.ts index 8b632bb935aa8..7bdfcc334d6a8 100644 --- a/clients/client-ec2/commands/CreateSnapshotCommand.ts +++ b/clients/client-ec2/commands/CreateSnapshotCommand.ts @@ -17,6 +17,29 @@ import { export type CreateSnapshotCommandInput = CreateSnapshotRequest; export type CreateSnapshotCommandOutput = Snapshot & __MetadataBearer; +/** + *

Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for + * backups, to make copies of EBS volumes, and to save data before shutting down an + * instance.

+ *

When a snapshot is created, any AWS Marketplace product codes that are associated with the + * source volume are propagated to the snapshot.

+ *

You can take a snapshot of an attached volume that is in use. However, snapshots only + * capture data that has been written to your EBS volume at the time the snapshot command is + * issued; this may exclude any data that has been cached by any applications or the operating + * system. If you can pause any file systems on the volume long enough to take a snapshot, your + * snapshot should be complete. However, if you cannot pause all file writes to the volume, you + * should unmount the volume from within the instance, issue the snapshot command, and then + * remount the volume to ensure a consistent and complete snapshot. You may remount and use your + * volume while the snapshot status is pending.

+ *

To create a snapshot for EBS volumes that serve as root devices, you should stop the + * instance before taking the snapshot.

+ *

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that + * are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes + * and any associated snapshots always remain protected.

+ *

You can tag your snapshots during creation. For more information, see Tagging your Amazon EC2 + * resources in the Amazon Elastic Compute Cloud User Guide.

+ *

For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateSnapshotCommand extends $Command< CreateSnapshotCommandInput, CreateSnapshotCommandOutput, @@ -31,6 +54,9 @@ export class CreateSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateSnapshotsCommand.ts b/clients/client-ec2/commands/CreateSnapshotsCommand.ts index b2b8949eaabb2..e102756eb7da9 100644 --- a/clients/client-ec2/commands/CreateSnapshotsCommand.ts +++ b/clients/client-ec2/commands/CreateSnapshotsCommand.ts @@ -17,6 +17,12 @@ import { export type CreateSnapshotsCommandInput = CreateSnapshotsRequest; export type CreateSnapshotsCommandOutput = CreateSnapshotsResult & __MetadataBearer; +/** + *

Creates crash-consistent snapshots of multiple EBS volumes and stores the data in S3. + * Volumes are chosen by specifying an instance. Any attached volumes will produce one snapshot + * each that is crash-consistent across the instance. Boot volumes can be excluded by changing the + * parameters.

+ */ export class CreateSnapshotsCommand extends $Command< CreateSnapshotsCommandInput, CreateSnapshotsCommandOutput, @@ -31,6 +37,9 @@ export class CreateSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateSpotDatafeedSubscriptionCommand.ts b/clients/client-ec2/commands/CreateSpotDatafeedSubscriptionCommand.ts index 30e20687371f4..e225f3c53e514 100644 --- a/clients/client-ec2/commands/CreateSpotDatafeedSubscriptionCommand.ts +++ b/clients/client-ec2/commands/CreateSpotDatafeedSubscriptionCommand.ts @@ -20,6 +20,12 @@ import { export type CreateSpotDatafeedSubscriptionCommandInput = CreateSpotDatafeedSubscriptionRequest; export type CreateSpotDatafeedSubscriptionCommandOutput = CreateSpotDatafeedSubscriptionResult & __MetadataBearer; +/** + *

Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. + * You can create one data feed per AWS account. For more information, see + * Spot Instance data feed + * in the Amazon EC2 User Guide for Linux Instances.

+ */ export class CreateSpotDatafeedSubscriptionCommand extends $Command< CreateSpotDatafeedSubscriptionCommandInput, CreateSpotDatafeedSubscriptionCommandOutput, @@ -34,6 +40,9 @@ export class CreateSpotDatafeedSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateSubnetCommand.ts b/clients/client-ec2/commands/CreateSubnetCommand.ts index b9e2a53f33eec..44f1250b43acc 100644 --- a/clients/client-ec2/commands/CreateSubnetCommand.ts +++ b/clients/client-ec2/commands/CreateSubnetCommand.ts @@ -17,6 +17,26 @@ import { export type CreateSubnetCommandInput = CreateSubnetRequest; export type CreateSubnetCommandOutput = CreateSubnetResult & __MetadataBearer; +/** + *

Creates a subnet in a specified VPC.

+ *

You must specify an IPv4 CIDR block for the subnet. After you create a subnet, you + * can't change its CIDR block. The allowed block size is between a /16 netmask (65,536 IP + * addresses) and /28 netmask (16 IP addresses). The CIDR block must not overlap with the + * CIDR block of an existing subnet in the VPC.

+ *

If you've associated an IPv6 CIDR block with your VPC, you can create a subnet with an + * IPv6 CIDR block that uses a /64 prefix length.

+ * + *

AWS reserves both the first four and the last IPv4 address in each subnet's CIDR + * block. They're not available for use.

+ *
+ *

If you add more than one subnet to a VPC, they're set up in a star topology with a + * logical router in the middle.

+ *

When you stop an instance in a subnet, it retains its private IPv4 address. It's + * therefore possible to have a subnet with no running instances (they're all stopped), but + * no remaining IP addresses available.

+ *

For more information about subnets, see Your VPC and Subnets in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class CreateSubnetCommand extends $Command< CreateSubnetCommandInput, CreateSubnetCommandOutput, @@ -31,6 +51,9 @@ export class CreateSubnetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTagsCommand.ts b/clients/client-ec2/commands/CreateTagsCommand.ts index 11582c99cd284..bb8823c164663 100644 --- a/clients/client-ec2/commands/CreateTagsCommand.ts +++ b/clients/client-ec2/commands/CreateTagsCommand.ts @@ -17,6 +17,18 @@ import { export type CreateTagsCommandInput = CreateTagsRequest; export type CreateTagsCommandOutput = __MetadataBearer; +/** + *

Adds or overwrites only the specified tags for the specified Amazon EC2 resource or + * resources. When you specify an existing tag key, the value is overwritten with + * the new value. Each resource can have a maximum of 50 tags. Each tag consists of a key and + * optional value. Tag keys must be unique per resource.

+ * + *

For more information about tags, see Tagging Your Resources in the + * Amazon Elastic Compute Cloud User Guide. For more information about + * creating IAM policies that control users' access to resources based on tags, see Supported + * Resource-Level Permissions for Amazon EC2 API Actions in the Amazon + * Elastic Compute Cloud User Guide.

+ */ export class CreateTagsCommand extends $Command< CreateTagsCommandInput, CreateTagsCommandOutput, @@ -31,6 +43,9 @@ export class CreateTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTrafficMirrorFilterCommand.ts b/clients/client-ec2/commands/CreateTrafficMirrorFilterCommand.ts index 1a6487d2bda65..4e6f6f57a8739 100644 --- a/clients/client-ec2/commands/CreateTrafficMirrorFilterCommand.ts +++ b/clients/client-ec2/commands/CreateTrafficMirrorFilterCommand.ts @@ -20,6 +20,12 @@ import { export type CreateTrafficMirrorFilterCommandInput = CreateTrafficMirrorFilterRequest; export type CreateTrafficMirrorFilterCommandOutput = CreateTrafficMirrorFilterResult & __MetadataBearer; +/** + *

Creates a Traffic Mirror filter.

+ *

A Traffic Mirror filter is a set of rules that defines the traffic to mirror.

+ *

By default, no traffic is mirrored. To mirror traffic, use CreateTrafficMirrorFilterRule to add Traffic Mirror rules to the filter. The rules you + * add define what traffic gets mirrored. You can also use ModifyTrafficMirrorFilterNetworkServices to mirror supported network services.

+ */ export class CreateTrafficMirrorFilterCommand extends $Command< CreateTrafficMirrorFilterCommandInput, CreateTrafficMirrorFilterCommandOutput, @@ -34,6 +40,9 @@ export class CreateTrafficMirrorFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTrafficMirrorFilterRuleCommand.ts b/clients/client-ec2/commands/CreateTrafficMirrorFilterRuleCommand.ts index b88b7f9ecba5d..2b8086cc96b5e 100644 --- a/clients/client-ec2/commands/CreateTrafficMirrorFilterRuleCommand.ts +++ b/clients/client-ec2/commands/CreateTrafficMirrorFilterRuleCommand.ts @@ -20,6 +20,11 @@ import { export type CreateTrafficMirrorFilterRuleCommandInput = CreateTrafficMirrorFilterRuleRequest; export type CreateTrafficMirrorFilterRuleCommandOutput = CreateTrafficMirrorFilterRuleResult & __MetadataBearer; +/** + *

Creates a Traffic Mirror filter rule.

+ *

A Traffic Mirror rule defines the Traffic Mirror source traffic to mirror.

+ *

You need the Traffic Mirror filter ID when you create the rule.

+ */ export class CreateTrafficMirrorFilterRuleCommand extends $Command< CreateTrafficMirrorFilterRuleCommandInput, CreateTrafficMirrorFilterRuleCommandOutput, @@ -34,6 +39,9 @@ export class CreateTrafficMirrorFilterRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTrafficMirrorSessionCommand.ts b/clients/client-ec2/commands/CreateTrafficMirrorSessionCommand.ts index 9b3dc74406f18..2df002f003858 100644 --- a/clients/client-ec2/commands/CreateTrafficMirrorSessionCommand.ts +++ b/clients/client-ec2/commands/CreateTrafficMirrorSessionCommand.ts @@ -20,6 +20,15 @@ import { export type CreateTrafficMirrorSessionCommandInput = CreateTrafficMirrorSessionRequest; export type CreateTrafficMirrorSessionCommandOutput = CreateTrafficMirrorSessionResult & __MetadataBearer; +/** + *

Creates a Traffic Mirror session.

+ *

A Traffic Mirror session actively copies packets from a Traffic Mirror source to a Traffic Mirror target. Create a filter, and then assign it + * to the session to define a subset of the traffic to mirror, for example all TCP + * traffic.

+ *

The Traffic Mirror source and the Traffic Mirror target (monitoring appliances) can be in the same VPC, or in a different VPC connected via VPC peering or a transit gateway.

+ *

By default, no traffic is mirrored. Use CreateTrafficMirrorFilter to + * create filter rules that specify the traffic to mirror.

+ */ export class CreateTrafficMirrorSessionCommand extends $Command< CreateTrafficMirrorSessionCommandInput, CreateTrafficMirrorSessionCommandOutput, @@ -34,6 +43,9 @@ export class CreateTrafficMirrorSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTrafficMirrorTargetCommand.ts b/clients/client-ec2/commands/CreateTrafficMirrorTargetCommand.ts index 8ac5e561d35fd..9785b99746ff0 100644 --- a/clients/client-ec2/commands/CreateTrafficMirrorTargetCommand.ts +++ b/clients/client-ec2/commands/CreateTrafficMirrorTargetCommand.ts @@ -20,6 +20,14 @@ import { export type CreateTrafficMirrorTargetCommandInput = CreateTrafficMirrorTargetRequest; export type CreateTrafficMirrorTargetCommandOutput = CreateTrafficMirrorTargetResult & __MetadataBearer; +/** + *

Creates a target for your Traffic Mirror session.

+ *

A Traffic Mirror target is the destination for mirrored traffic. The Traffic Mirror source and + * the Traffic Mirror target (monitoring appliances) can be in the same VPC, or in + * different VPCs connected via VPC peering or a transit gateway.

+ *

A Traffic Mirror target can be a network interface, or a Network Load Balancer.

+ *

To use the target in a Traffic Mirror session, use CreateTrafficMirrorSession.

+ */ export class CreateTrafficMirrorTargetCommand extends $Command< CreateTrafficMirrorTargetCommandInput, CreateTrafficMirrorTargetCommandOutput, @@ -34,6 +42,9 @@ export class CreateTrafficMirrorTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTransitGatewayCommand.ts b/clients/client-ec2/commands/CreateTransitGatewayCommand.ts index f87ec099e8a83..de0de357a5117 100644 --- a/clients/client-ec2/commands/CreateTransitGatewayCommand.ts +++ b/clients/client-ec2/commands/CreateTransitGatewayCommand.ts @@ -20,6 +20,21 @@ import { export type CreateTransitGatewayCommandInput = CreateTransitGatewayRequest; export type CreateTransitGatewayCommandOutput = CreateTransitGatewayResult & __MetadataBearer; +/** + *

Creates a transit gateway.

+ *

You can use a transit gateway to interconnect your virtual private clouds (VPC) and on-premises networks. + * After the transit gateway enters the available state, you can attach your VPCs and VPN + * connections to the transit gateway.

+ *

To attach your VPCs, use CreateTransitGatewayVpcAttachment.

+ *

To attach a VPN connection, use CreateCustomerGateway to create a customer + * gateway and specify the ID of the customer gateway and the ID of the transit gateway in a call to + * CreateVpnConnection.

+ *

When you create a transit gateway, we create a default transit gateway route table and use it as the default association route table + * and the default propagation route table. You can use CreateTransitGatewayRouteTable to create + * additional transit gateway route tables. If you disable automatic route propagation, we do not create a default transit gateway route table. + * You can use EnableTransitGatewayRouteTablePropagation to propagate routes from a resource + * attachment to a transit gateway route table. If you disable automatic associations, you can use AssociateTransitGatewayRouteTable to associate a resource attachment with a transit gateway route table.

+ */ export class CreateTransitGatewayCommand extends $Command< CreateTransitGatewayCommandInput, CreateTransitGatewayCommandOutput, @@ -34,6 +49,9 @@ export class CreateTransitGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTransitGatewayMulticastDomainCommand.ts b/clients/client-ec2/commands/CreateTransitGatewayMulticastDomainCommand.ts index a6475f9a9e985..d18ab23ee789d 100644 --- a/clients/client-ec2/commands/CreateTransitGatewayMulticastDomainCommand.ts +++ b/clients/client-ec2/commands/CreateTransitGatewayMulticastDomainCommand.ts @@ -24,6 +24,10 @@ export type CreateTransitGatewayMulticastDomainCommandInput = CreateTransitGatew export type CreateTransitGatewayMulticastDomainCommandOutput = CreateTransitGatewayMulticastDomainResult & __MetadataBearer; +/** + *

Creates a multicast domain using the specified transit gateway.

+ *

The transit gateway must be in the available state before you create a domain. Use DescribeTransitGateways to see the state of transit gateway.

+ */ export class CreateTransitGatewayMulticastDomainCommand extends $Command< CreateTransitGatewayMulticastDomainCommandInput, CreateTransitGatewayMulticastDomainCommandOutput, @@ -38,6 +42,9 @@ export class CreateTransitGatewayMulticastDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTransitGatewayPeeringAttachmentCommand.ts b/clients/client-ec2/commands/CreateTransitGatewayPeeringAttachmentCommand.ts index d089adaa936e1..81dd5cc7b3717 100644 --- a/clients/client-ec2/commands/CreateTransitGatewayPeeringAttachmentCommand.ts +++ b/clients/client-ec2/commands/CreateTransitGatewayPeeringAttachmentCommand.ts @@ -24,6 +24,14 @@ export type CreateTransitGatewayPeeringAttachmentCommandInput = CreateTransitGat export type CreateTransitGatewayPeeringAttachmentCommandOutput = CreateTransitGatewayPeeringAttachmentResult & __MetadataBearer; +/** + *

Requests a transit gateway peering attachment between the specified transit gateway + * (requester) and a peer transit gateway (accepter). The transit gateways must be in + * different Regions. The peer transit gateway can be in your account or a different AWS + * account.

+ *

After you create the peering attachment, the owner of the accepter + * transit gateway must accept the attachment request.

+ */ export class CreateTransitGatewayPeeringAttachmentCommand extends $Command< CreateTransitGatewayPeeringAttachmentCommandInput, CreateTransitGatewayPeeringAttachmentCommandOutput, @@ -38,6 +46,9 @@ export class CreateTransitGatewayPeeringAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTransitGatewayPrefixListReferenceCommand.ts b/clients/client-ec2/commands/CreateTransitGatewayPrefixListReferenceCommand.ts index 21f945ed325fa..db7214715da8a 100644 --- a/clients/client-ec2/commands/CreateTransitGatewayPrefixListReferenceCommand.ts +++ b/clients/client-ec2/commands/CreateTransitGatewayPrefixListReferenceCommand.ts @@ -24,6 +24,9 @@ export type CreateTransitGatewayPrefixListReferenceCommandInput = CreateTransitG export type CreateTransitGatewayPrefixListReferenceCommandOutput = CreateTransitGatewayPrefixListReferenceResult & __MetadataBearer; +/** + *

Creates a reference (route) to a prefix list in a specified transit gateway route table.

+ */ export class CreateTransitGatewayPrefixListReferenceCommand extends $Command< CreateTransitGatewayPrefixListReferenceCommandInput, CreateTransitGatewayPrefixListReferenceCommandOutput, @@ -38,6 +41,9 @@ export class CreateTransitGatewayPrefixListReferenceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTransitGatewayRouteCommand.ts b/clients/client-ec2/commands/CreateTransitGatewayRouteCommand.ts index bb1b17d8d9e98..0bd4c7c14bc65 100644 --- a/clients/client-ec2/commands/CreateTransitGatewayRouteCommand.ts +++ b/clients/client-ec2/commands/CreateTransitGatewayRouteCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTransitGatewayRouteCommandInput = CreateTransitGatewayRouteRequest; export type CreateTransitGatewayRouteCommandOutput = CreateTransitGatewayRouteResult & __MetadataBearer; +/** + *

Creates a static route for the specified transit gateway route table.

+ */ export class CreateTransitGatewayRouteCommand extends $Command< CreateTransitGatewayRouteCommandInput, CreateTransitGatewayRouteCommandOutput, @@ -34,6 +37,9 @@ export class CreateTransitGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTransitGatewayRouteTableCommand.ts b/clients/client-ec2/commands/CreateTransitGatewayRouteTableCommand.ts index f026109d26e78..54a23f6f8bebf 100644 --- a/clients/client-ec2/commands/CreateTransitGatewayRouteTableCommand.ts +++ b/clients/client-ec2/commands/CreateTransitGatewayRouteTableCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTransitGatewayRouteTableCommandInput = CreateTransitGatewayRouteTableRequest; export type CreateTransitGatewayRouteTableCommandOutput = CreateTransitGatewayRouteTableResult & __MetadataBearer; +/** + *

Creates a route table for the specified transit gateway.

+ */ export class CreateTransitGatewayRouteTableCommand extends $Command< CreateTransitGatewayRouteTableCommandInput, CreateTransitGatewayRouteTableCommandOutput, @@ -34,6 +37,9 @@ export class CreateTransitGatewayRouteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateTransitGatewayVpcAttachmentCommand.ts b/clients/client-ec2/commands/CreateTransitGatewayVpcAttachmentCommand.ts index efa5dbd734da6..5ce08b1d7e2b7 100644 --- a/clients/client-ec2/commands/CreateTransitGatewayVpcAttachmentCommand.ts +++ b/clients/client-ec2/commands/CreateTransitGatewayVpcAttachmentCommand.ts @@ -20,6 +20,12 @@ import { export type CreateTransitGatewayVpcAttachmentCommandInput = CreateTransitGatewayVpcAttachmentRequest; export type CreateTransitGatewayVpcAttachmentCommandOutput = CreateTransitGatewayVpcAttachmentResult & __MetadataBearer; +/** + *

Attaches the specified VPC to the specified transit gateway.

+ *

If you attach a VPC with a CIDR range that overlaps the CIDR range of a VPC that is already attached, + * the new VPC CIDR range is not propagated to the default propagation route table.

+ *

To send VPC traffic to an attached transit gateway, add a route to the VPC route table using CreateRoute.

+ */ export class CreateTransitGatewayVpcAttachmentCommand extends $Command< CreateTransitGatewayVpcAttachmentCommandInput, CreateTransitGatewayVpcAttachmentCommandOutput, @@ -34,6 +40,9 @@ export class CreateTransitGatewayVpcAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVolumeCommand.ts b/clients/client-ec2/commands/CreateVolumeCommand.ts index 689ca3d862fc9..0ad13d901229b 100644 --- a/clients/client-ec2/commands/CreateVolumeCommand.ts +++ b/clients/client-ec2/commands/CreateVolumeCommand.ts @@ -17,6 +17,22 @@ import { export type CreateVolumeCommandInput = CreateVolumeRequest; export type CreateVolumeCommandOutput = Volume & __MetadataBearer; +/** + *

Creates an EBS volume that can be attached to an instance in the same Availability Zone. + * The volume is created in the regional endpoint that you send the HTTP request to. For more + * information see Regions and + * Endpoints.

+ *

You can create a new empty volume or restore a volume from an EBS snapshot. + * Any AWS Marketplace product codes from the snapshot are propagated to the volume.

+ *

You can create encrypted volumes. Encrypted volumes must be attached to instances that + * support Amazon EBS encryption. Volumes that are created from encrypted snapshots are also automatically + * encrypted. For more information, see Amazon EBS Encryption + * in the Amazon Elastic Compute Cloud User Guide.

+ *

You can tag your volumes during creation. For more information, see Tagging your Amazon EC2 + * resources in the Amazon Elastic Compute Cloud User Guide.

+ *

For more information, see Creating an Amazon EBS volume in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateVolumeCommand extends $Command< CreateVolumeCommandInput, CreateVolumeCommandOutput, @@ -31,6 +47,9 @@ export class CreateVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVpcCommand.ts b/clients/client-ec2/commands/CreateVpcCommand.ts index 3066b02dcd8c0..b9f359594670f 100644 --- a/clients/client-ec2/commands/CreateVpcCommand.ts +++ b/clients/client-ec2/commands/CreateVpcCommand.ts @@ -17,6 +17,19 @@ import { export type CreateVpcCommandInput = CreateVpcRequest; export type CreateVpcCommandOutput = CreateVpcResult & __MetadataBearer; +/** + *

Creates a VPC with the specified IPv4 CIDR block. The smallest VPC you can create + * uses a /28 netmask (16 IPv4 addresses), and the largest uses a /16 netmask (65,536 IPv4 + * addresses). For more information about how large to make your VPC, see Your VPC and + * Subnets in the Amazon Virtual Private Cloud User Guide.

+ *

You can optionally request an IPv6 CIDR block for the VPC. You can request an Amazon-provided IPv6 CIDR block from Amazon's pool of IPv6 addresses, or an IPv6 CIDR block from an IPv6 address pool that you provisioned through bring your own IP addresses (BYOIP).

+ *

By default, each instance you launch in the VPC has the default DHCP options, which + * include only a default DNS server that we provide (AmazonProvidedDNS). For more + * information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

+ *

You can specify the instance tenancy value for the VPC when you create it. You can't change + * this value for the VPC after you create it. For more information, see Dedicated Instances in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class CreateVpcCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +40,9 @@ export class CreateVpcCommand extends $Command, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVpcEndpointCommand.ts b/clients/client-ec2/commands/CreateVpcEndpointCommand.ts index 4cdc9e0a83d89..1b1fe3e2e1ec3 100644 --- a/clients/client-ec2/commands/CreateVpcEndpointCommand.ts +++ b/clients/client-ec2/commands/CreateVpcEndpointCommand.ts @@ -20,6 +20,23 @@ import { export type CreateVpcEndpointCommandInput = CreateVpcEndpointRequest; export type CreateVpcEndpointCommandOutput = CreateVpcEndpointResult & __MetadataBearer; +/** + *

Creates a VPC endpoint for a specified service. An endpoint enables you to create a + * private connection between your VPC and the service. The service may be provided by AWS, + * an AWS Marketplace Partner, or another AWS account. For more information, see VPC Endpoints in + * the Amazon Virtual Private Cloud User Guide.

+ *

A gateway endpoint serves as a target for a route in your route table for + * traffic destined for the AWS service. You can specify an endpoint policy to attach to + * the endpoint, which will control access to the service from your VPC. You can also + * specify the VPC route tables that use the endpoint.

+ *

An interface endpoint is a network interface in your subnet that + * serves as an endpoint for communicating with the specified service. You can specify the + * subnets in which to create an endpoint, and the security groups to associate with the + * endpoint network interface.

+ *

A GatewayLoadBalancer endpoint is a network interface in your subnet that serves an endpoint for communicating with a Gateway Load Balancer that you've configured as a VPC endpoint service.

+ *

Use DescribeVpcEndpointServices to get a list of supported + * services.

+ */ export class CreateVpcEndpointCommand extends $Command< CreateVpcEndpointCommandInput, CreateVpcEndpointCommandOutput, @@ -34,6 +51,9 @@ export class CreateVpcEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVpcEndpointConnectionNotificationCommand.ts b/clients/client-ec2/commands/CreateVpcEndpointConnectionNotificationCommand.ts index 1004b3826e8e9..73422c5095c0b 100644 --- a/clients/client-ec2/commands/CreateVpcEndpointConnectionNotificationCommand.ts +++ b/clients/client-ec2/commands/CreateVpcEndpointConnectionNotificationCommand.ts @@ -24,6 +24,13 @@ export type CreateVpcEndpointConnectionNotificationCommandInput = CreateVpcEndpo export type CreateVpcEndpointConnectionNotificationCommandOutput = CreateVpcEndpointConnectionNotificationResult & __MetadataBearer; +/** + *

Creates a connection notification for a specified VPC endpoint or VPC endpoint + * service. A connection notification notifies you of specific endpoint events. You must + * create an SNS topic to receive notifications. For more information, see Create a Topic in + * the Amazon Simple Notification Service Developer Guide.

+ *

You can create a connection notification for interface endpoints only.

+ */ export class CreateVpcEndpointConnectionNotificationCommand extends $Command< CreateVpcEndpointConnectionNotificationCommandInput, CreateVpcEndpointConnectionNotificationCommandOutput, @@ -38,6 +45,9 @@ export class CreateVpcEndpointConnectionNotificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVpcEndpointServiceConfigurationCommand.ts b/clients/client-ec2/commands/CreateVpcEndpointServiceConfigurationCommand.ts index e0d7122fc0c1a..60e92f4b67ae3 100644 --- a/clients/client-ec2/commands/CreateVpcEndpointServiceConfigurationCommand.ts +++ b/clients/client-ec2/commands/CreateVpcEndpointServiceConfigurationCommand.ts @@ -24,6 +24,28 @@ export type CreateVpcEndpointServiceConfigurationCommandInput = CreateVpcEndpoin export type CreateVpcEndpointServiceConfigurationCommandOutput = CreateVpcEndpointServiceConfigurationResult & __MetadataBearer; +/** + *

Creates a VPC endpoint service configuration to which service consumers (AWS accounts, + * IAM users, and IAM roles) can connect.

+ *

To create an endpoint service configuration, you must first create one of the + * following for your service:

+ *
    + *
  • + *

    A Network Load Balancer. Service consumers connect to your service using an + * interface endpoint.

    + *
  • + *
  • + *

    A Gateway Load Balancer. Service consumers connect to your service using a + * Gateway Load Balancer endpoint.

    + *
  • + *
+ *

For more information, see VPC Endpoint Services in the + * Amazon Virtual Private Cloud User Guide.

+ *

If you set the private DNS name, you must prove that you own the private DNS domain + * name. For more information, see VPC Endpoint Service + * Private DNS Name Verification in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class CreateVpcEndpointServiceConfigurationCommand extends $Command< CreateVpcEndpointServiceConfigurationCommandInput, CreateVpcEndpointServiceConfigurationCommandOutput, @@ -38,6 +60,9 @@ export class CreateVpcEndpointServiceConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVpcPeeringConnectionCommand.ts b/clients/client-ec2/commands/CreateVpcPeeringConnectionCommand.ts index 264e770e0ad93..5ccb0ddc45f4a 100644 --- a/clients/client-ec2/commands/CreateVpcPeeringConnectionCommand.ts +++ b/clients/client-ec2/commands/CreateVpcPeeringConnectionCommand.ts @@ -20,6 +20,20 @@ import { export type CreateVpcPeeringConnectionCommandInput = CreateVpcPeeringConnectionRequest; export type CreateVpcPeeringConnectionCommandOutput = CreateVpcPeeringConnectionResult & __MetadataBearer; +/** + *

Requests a VPC peering connection between two VPCs: a requester VPC that you own and + * an accepter VPC with which to create the connection. The accepter VPC can belong to + * another AWS account and can be in a different Region to the requester VPC. The requester + * VPC and accepter VPC cannot have overlapping CIDR blocks.

+ * + *

Limitations and rules apply to a VPC peering connection. For more information, see the limitations section in the VPC Peering Guide.

+ *
+ *

The owner of the accepter VPC must accept the peering request to activate the peering + * connection. The VPC peering connection request expires after 7 days, after which it + * cannot be accepted or rejected.

+ *

If you create a VPC peering connection request between VPCs with overlapping CIDR + * blocks, the VPC peering connection has a status of failed.

+ */ export class CreateVpcPeeringConnectionCommand extends $Command< CreateVpcPeeringConnectionCommandInput, CreateVpcPeeringConnectionCommandOutput, @@ -34,6 +48,9 @@ export class CreateVpcPeeringConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVpnConnectionCommand.ts b/clients/client-ec2/commands/CreateVpnConnectionCommand.ts index fa2868dd82ca4..efcd8d9a2a4a9 100644 --- a/clients/client-ec2/commands/CreateVpnConnectionCommand.ts +++ b/clients/client-ec2/commands/CreateVpnConnectionCommand.ts @@ -20,6 +20,24 @@ import { export type CreateVpnConnectionCommandInput = CreateVpnConnectionRequest; export type CreateVpnConnectionCommandOutput = CreateVpnConnectionResult & __MetadataBearer; +/** + *

Creates a VPN connection between an existing virtual private gateway or transit gateway and a + * customer gateway. The supported connection type is ipsec.1.

+ *

The response includes information that you need to give to your network administrator + * to configure your customer gateway.

+ * + *

We strongly recommend that you use HTTPS when calling this operation because the + * response contains sensitive cryptographic information for configuring your customer + * gateway device.

+ *
+ *

If you decide to shut down your VPN connection for any reason and later create a new + * VPN connection, you must reconfigure your customer gateway with the new information + * returned from this call.

+ *

This is an idempotent operation. If you perform the operation more than once, Amazon + * EC2 doesn't return an error.

+ *

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN + * User Guide.

+ */ export class CreateVpnConnectionCommand extends $Command< CreateVpnConnectionCommandInput, CreateVpnConnectionCommandOutput, @@ -34,6 +52,9 @@ export class CreateVpnConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVpnConnectionRouteCommand.ts b/clients/client-ec2/commands/CreateVpnConnectionRouteCommand.ts index a64c2184da2fe..25cbe59151ffb 100644 --- a/clients/client-ec2/commands/CreateVpnConnectionRouteCommand.ts +++ b/clients/client-ec2/commands/CreateVpnConnectionRouteCommand.ts @@ -20,6 +20,10 @@ import { export type CreateVpnConnectionRouteCommandInput = CreateVpnConnectionRouteRequest; export type CreateVpnConnectionRouteCommandOutput = __MetadataBearer; +/** + *

Creates a static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

+ *

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

+ */ export class CreateVpnConnectionRouteCommand extends $Command< CreateVpnConnectionRouteCommandInput, CreateVpnConnectionRouteCommandOutput, @@ -34,6 +38,9 @@ export class CreateVpnConnectionRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/CreateVpnGatewayCommand.ts b/clients/client-ec2/commands/CreateVpnGatewayCommand.ts index acac34971405a..4a610df7cceee 100644 --- a/clients/client-ec2/commands/CreateVpnGatewayCommand.ts +++ b/clients/client-ec2/commands/CreateVpnGatewayCommand.ts @@ -20,6 +20,10 @@ import { export type CreateVpnGatewayCommandInput = CreateVpnGatewayRequest; export type CreateVpnGatewayCommandOutput = CreateVpnGatewayResult & __MetadataBearer; +/** + *

Creates a virtual private gateway. A virtual private gateway is the endpoint on the VPC side of your VPN connection. You can create a virtual private gateway before creating the VPC itself.

+ *

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

+ */ export class CreateVpnGatewayCommand extends $Command< CreateVpnGatewayCommandInput, CreateVpnGatewayCommandOutput, @@ -34,6 +38,9 @@ export class CreateVpnGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteCarrierGatewayCommand.ts b/clients/client-ec2/commands/DeleteCarrierGatewayCommand.ts index 070b86c2cca0c..da47f71807398 100644 --- a/clients/client-ec2/commands/DeleteCarrierGatewayCommand.ts +++ b/clients/client-ec2/commands/DeleteCarrierGatewayCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteCarrierGatewayCommandInput = DeleteCarrierGatewayRequest; export type DeleteCarrierGatewayCommandOutput = DeleteCarrierGatewayResult & __MetadataBearer; +/** + *

Deletes a carrier gateway.

+ * + *

If you do not delete the route that contains the carrier gateway as the + * Target, the route is a blackhole route. For information about how to delete a route, see + * DeleteRoute.

+ *
+ */ export class DeleteCarrierGatewayCommand extends $Command< DeleteCarrierGatewayCommandInput, DeleteCarrierGatewayCommandOutput, @@ -34,6 +42,9 @@ export class DeleteCarrierGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteClientVpnEndpointCommand.ts b/clients/client-ec2/commands/DeleteClientVpnEndpointCommand.ts index dd0e14b91f0f1..417412540b5a6 100644 --- a/clients/client-ec2/commands/DeleteClientVpnEndpointCommand.ts +++ b/clients/client-ec2/commands/DeleteClientVpnEndpointCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteClientVpnEndpointCommandInput = DeleteClientVpnEndpointRequest; export type DeleteClientVpnEndpointCommandOutput = DeleteClientVpnEndpointResult & __MetadataBearer; +/** + *

Deletes the specified Client VPN endpoint. You must disassociate all target networks before you + * can delete a Client VPN endpoint.

+ */ export class DeleteClientVpnEndpointCommand extends $Command< DeleteClientVpnEndpointCommandInput, DeleteClientVpnEndpointCommandOutput, @@ -34,6 +38,9 @@ export class DeleteClientVpnEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteClientVpnRouteCommand.ts b/clients/client-ec2/commands/DeleteClientVpnRouteCommand.ts index 37ff7cae13d3c..0d7ef42e304d5 100644 --- a/clients/client-ec2/commands/DeleteClientVpnRouteCommand.ts +++ b/clients/client-ec2/commands/DeleteClientVpnRouteCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteClientVpnRouteCommandInput = DeleteClientVpnRouteRequest; export type DeleteClientVpnRouteCommandOutput = DeleteClientVpnRouteResult & __MetadataBearer; +/** + *

Deletes a route from a Client VPN endpoint. You can only delete routes that you manually added using + * the CreateClientVpnRoute action. You cannot delete routes that were + * automatically added when associating a subnet. To remove routes that have been automatically added, + * disassociate the target subnet from the Client VPN endpoint.

+ */ export class DeleteClientVpnRouteCommand extends $Command< DeleteClientVpnRouteCommandInput, DeleteClientVpnRouteCommandOutput, @@ -34,6 +40,9 @@ export class DeleteClientVpnRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteCustomerGatewayCommand.ts b/clients/client-ec2/commands/DeleteCustomerGatewayCommand.ts index 72994e7dc86df..ad616a2692204 100644 --- a/clients/client-ec2/commands/DeleteCustomerGatewayCommand.ts +++ b/clients/client-ec2/commands/DeleteCustomerGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCustomerGatewayCommandInput = DeleteCustomerGatewayRequest; export type DeleteCustomerGatewayCommandOutput = __MetadataBearer; +/** + *

Deletes the specified customer gateway. You must delete the VPN connection before you can delete the customer gateway.

+ */ export class DeleteCustomerGatewayCommand extends $Command< DeleteCustomerGatewayCommandInput, DeleteCustomerGatewayCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCustomerGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteDhcpOptionsCommand.ts b/clients/client-ec2/commands/DeleteDhcpOptionsCommand.ts index 438d67f83e5aa..2944781e52fc7 100644 --- a/clients/client-ec2/commands/DeleteDhcpOptionsCommand.ts +++ b/clients/client-ec2/commands/DeleteDhcpOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDhcpOptionsCommandInput = DeleteDhcpOptionsRequest; export type DeleteDhcpOptionsCommandOutput = __MetadataBearer; +/** + *

Deletes the specified set of DHCP options. You must disassociate the set of DHCP options before you can delete it. You can disassociate the set of DHCP options by associating either a new set of options or the default set of options with the VPC.

+ */ export class DeleteDhcpOptionsCommand extends $Command< DeleteDhcpOptionsCommandInput, DeleteDhcpOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDhcpOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteEgressOnlyInternetGatewayCommand.ts b/clients/client-ec2/commands/DeleteEgressOnlyInternetGatewayCommand.ts index 2097a45938ae6..6d68f677f63d0 100644 --- a/clients/client-ec2/commands/DeleteEgressOnlyInternetGatewayCommand.ts +++ b/clients/client-ec2/commands/DeleteEgressOnlyInternetGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEgressOnlyInternetGatewayCommandInput = DeleteEgressOnlyInternetGatewayRequest; export type DeleteEgressOnlyInternetGatewayCommandOutput = DeleteEgressOnlyInternetGatewayResult & __MetadataBearer; +/** + *

Deletes an egress-only internet gateway.

+ */ export class DeleteEgressOnlyInternetGatewayCommand extends $Command< DeleteEgressOnlyInternetGatewayCommandInput, DeleteEgressOnlyInternetGatewayCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEgressOnlyInternetGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteFleetsCommand.ts b/clients/client-ec2/commands/DeleteFleetsCommand.ts index b169a845cef1c..7eda47cb863d0 100644 --- a/clients/client-ec2/commands/DeleteFleetsCommand.ts +++ b/clients/client-ec2/commands/DeleteFleetsCommand.ts @@ -17,6 +17,35 @@ import { export type DeleteFleetsCommandInput = DeleteFleetsRequest; export type DeleteFleetsCommandOutput = DeleteFleetsResult & __MetadataBearer; +/** + *

Deletes the specified EC2 Fleet.

+ *

After you delete an EC2 Fleet, it launches no new instances.

+ *

You must specify whether a deleted EC2 Fleet should also terminate its instances. If you + * choose to terminate the instances, the EC2 Fleet enters the deleted_terminating + * state. Otherwise, the EC2 Fleet enters the deleted_running state, and the instances + * continue to run until they are interrupted or you terminate them manually.

+ *

For instant fleets, EC2 Fleet must terminate the instances when the fleet is + * deleted. A deleted instant fleet with running instances is not + * supported.

+ *

+ * Restrictions + *

+ *
    + *
  • + *

    You can delete up to 25 instant fleets in a single request. If you exceed this + * number, no instant fleets are deleted and an error is returned. There is no + * restriction on the number of fleets of type maintain or request that can be deleted + * in a single request.

    + *
  • + *
  • + *

    Up to 1000 instances can be terminated in a single request to delete + * instant fleets.

    + *
  • + *
+ * + *

For more information, see Deleting an EC2 + * Fleet in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DeleteFleetsCommand extends $Command< DeleteFleetsCommandInput, DeleteFleetsCommandOutput, @@ -31,6 +60,9 @@ export class DeleteFleetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteFlowLogsCommand.ts b/clients/client-ec2/commands/DeleteFlowLogsCommand.ts index 30f4c2f4b428c..157e36bd09ca8 100644 --- a/clients/client-ec2/commands/DeleteFlowLogsCommand.ts +++ b/clients/client-ec2/commands/DeleteFlowLogsCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteFlowLogsCommandInput = DeleteFlowLogsRequest; export type DeleteFlowLogsCommandOutput = DeleteFlowLogsResult & __MetadataBearer; +/** + *

Deletes one or more flow logs.

+ */ export class DeleteFlowLogsCommand extends $Command< DeleteFlowLogsCommandInput, DeleteFlowLogsCommandOutput, @@ -31,6 +34,9 @@ export class DeleteFlowLogsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteFpgaImageCommand.ts b/clients/client-ec2/commands/DeleteFpgaImageCommand.ts index b8222d6ceda24..aa31ad1a555e6 100644 --- a/clients/client-ec2/commands/DeleteFpgaImageCommand.ts +++ b/clients/client-ec2/commands/DeleteFpgaImageCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteFpgaImageCommandInput = DeleteFpgaImageRequest; export type DeleteFpgaImageCommandOutput = DeleteFpgaImageResult & __MetadataBearer; +/** + *

Deletes the specified Amazon FPGA Image (AFI).

+ */ export class DeleteFpgaImageCommand extends $Command< DeleteFpgaImageCommandInput, DeleteFpgaImageCommandOutput, @@ -31,6 +34,9 @@ export class DeleteFpgaImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteInternetGatewayCommand.ts b/clients/client-ec2/commands/DeleteInternetGatewayCommand.ts index dee262ef622b7..85c6c820c38f3 100644 --- a/clients/client-ec2/commands/DeleteInternetGatewayCommand.ts +++ b/clients/client-ec2/commands/DeleteInternetGatewayCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteInternetGatewayCommandInput = DeleteInternetGatewayRequest; export type DeleteInternetGatewayCommandOutput = __MetadataBearer; +/** + *

Deletes the specified internet gateway. You must detach the internet gateway from the + * VPC before you can delete it.

+ */ export class DeleteInternetGatewayCommand extends $Command< DeleteInternetGatewayCommandInput, DeleteInternetGatewayCommandOutput, @@ -34,6 +38,9 @@ export class DeleteInternetGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteKeyPairCommand.ts b/clients/client-ec2/commands/DeleteKeyPairCommand.ts index ca8e493c91fc7..cc01587a2f4ef 100644 --- a/clients/client-ec2/commands/DeleteKeyPairCommand.ts +++ b/clients/client-ec2/commands/DeleteKeyPairCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteKeyPairCommandInput = DeleteKeyPairRequest; export type DeleteKeyPairCommandOutput = __MetadataBearer; +/** + *

Deletes the specified key pair, by removing the public key from Amazon EC2.

+ */ export class DeleteKeyPairCommand extends $Command< DeleteKeyPairCommandInput, DeleteKeyPairCommandOutput, @@ -31,6 +34,9 @@ export class DeleteKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteLaunchTemplateCommand.ts b/clients/client-ec2/commands/DeleteLaunchTemplateCommand.ts index 224a7d5317487..43a25c4182b29 100644 --- a/clients/client-ec2/commands/DeleteLaunchTemplateCommand.ts +++ b/clients/client-ec2/commands/DeleteLaunchTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLaunchTemplateCommandInput = DeleteLaunchTemplateRequest; export type DeleteLaunchTemplateCommandOutput = DeleteLaunchTemplateResult & __MetadataBearer; +/** + *

Deletes a launch template. Deleting a launch template deletes all of its versions.

+ */ export class DeleteLaunchTemplateCommand extends $Command< DeleteLaunchTemplateCommandInput, DeleteLaunchTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLaunchTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteLaunchTemplateVersionsCommand.ts b/clients/client-ec2/commands/DeleteLaunchTemplateVersionsCommand.ts index 4f88eff207e22..de10e56580bc1 100644 --- a/clients/client-ec2/commands/DeleteLaunchTemplateVersionsCommand.ts +++ b/clients/client-ec2/commands/DeleteLaunchTemplateVersionsCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteLaunchTemplateVersionsCommandInput = DeleteLaunchTemplateVersionsRequest; export type DeleteLaunchTemplateVersionsCommandOutput = DeleteLaunchTemplateVersionsResult & __MetadataBearer; +/** + *

Deletes one or more versions of a launch template. You cannot delete the default + * version of a launch template; you must first assign a different version as the default. + * If the default version is the only version for the launch template, you must delete the + * entire launch template using DeleteLaunchTemplate.

+ */ export class DeleteLaunchTemplateVersionsCommand extends $Command< DeleteLaunchTemplateVersionsCommandInput, DeleteLaunchTemplateVersionsCommandOutput, @@ -34,6 +40,9 @@ export class DeleteLaunchTemplateVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteLocalGatewayRouteCommand.ts b/clients/client-ec2/commands/DeleteLocalGatewayRouteCommand.ts index d0a1fb12b376c..213af40bb2e26 100644 --- a/clients/client-ec2/commands/DeleteLocalGatewayRouteCommand.ts +++ b/clients/client-ec2/commands/DeleteLocalGatewayRouteCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLocalGatewayRouteCommandInput = DeleteLocalGatewayRouteRequest; export type DeleteLocalGatewayRouteCommandOutput = DeleteLocalGatewayRouteResult & __MetadataBearer; +/** + *

Deletes the specified route from the specified local gateway route table.

+ */ export class DeleteLocalGatewayRouteCommand extends $Command< DeleteLocalGatewayRouteCommandInput, DeleteLocalGatewayRouteCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLocalGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteLocalGatewayRouteTableVpcAssociationCommand.ts b/clients/client-ec2/commands/DeleteLocalGatewayRouteTableVpcAssociationCommand.ts index fdc76e5a87674..64568375c76f2 100644 --- a/clients/client-ec2/commands/DeleteLocalGatewayRouteTableVpcAssociationCommand.ts +++ b/clients/client-ec2/commands/DeleteLocalGatewayRouteTableVpcAssociationCommand.ts @@ -24,6 +24,9 @@ export type DeleteLocalGatewayRouteTableVpcAssociationCommandInput = DeleteLocal export type DeleteLocalGatewayRouteTableVpcAssociationCommandOutput = DeleteLocalGatewayRouteTableVpcAssociationResult & __MetadataBearer; +/** + *

Deletes the specified association between a VPC and local gateway route table.

+ */ export class DeleteLocalGatewayRouteTableVpcAssociationCommand extends $Command< DeleteLocalGatewayRouteTableVpcAssociationCommandInput, DeleteLocalGatewayRouteTableVpcAssociationCommandOutput, @@ -38,6 +41,9 @@ export class DeleteLocalGatewayRouteTableVpcAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteManagedPrefixListCommand.ts b/clients/client-ec2/commands/DeleteManagedPrefixListCommand.ts index bad10bef71aa9..35b867b371dad 100644 --- a/clients/client-ec2/commands/DeleteManagedPrefixListCommand.ts +++ b/clients/client-ec2/commands/DeleteManagedPrefixListCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteManagedPrefixListCommandInput = DeleteManagedPrefixListRequest; export type DeleteManagedPrefixListCommandOutput = DeleteManagedPrefixListResult & __MetadataBearer; +/** + *

Deletes the specified managed prefix list. You must first remove all references to the prefix list in your resources.

+ */ export class DeleteManagedPrefixListCommand extends $Command< DeleteManagedPrefixListCommandInput, DeleteManagedPrefixListCommandOutput, @@ -34,6 +37,9 @@ export class DeleteManagedPrefixListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteNatGatewayCommand.ts b/clients/client-ec2/commands/DeleteNatGatewayCommand.ts index f68bfb1dfbead..1bed82c28be2d 100644 --- a/clients/client-ec2/commands/DeleteNatGatewayCommand.ts +++ b/clients/client-ec2/commands/DeleteNatGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNatGatewayCommandInput = DeleteNatGatewayRequest; export type DeleteNatGatewayCommandOutput = DeleteNatGatewayResult & __MetadataBearer; +/** + *

Deletes the specified NAT gateway. Deleting a NAT gateway disassociates its Elastic IP address, but does not release the address from your account. Deleting a NAT gateway does not delete any NAT gateway routes in your route tables.

+ */ export class DeleteNatGatewayCommand extends $Command< DeleteNatGatewayCommandInput, DeleteNatGatewayCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNatGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteNetworkAclCommand.ts b/clients/client-ec2/commands/DeleteNetworkAclCommand.ts index 14df6b8b97d25..66984687dbe62 100644 --- a/clients/client-ec2/commands/DeleteNetworkAclCommand.ts +++ b/clients/client-ec2/commands/DeleteNetworkAclCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNetworkAclCommandInput = DeleteNetworkAclRequest; export type DeleteNetworkAclCommandOutput = __MetadataBearer; +/** + *

Deletes the specified network ACL. You can't delete the ACL if it's associated with any subnets. You can't delete the default network ACL.

+ */ export class DeleteNetworkAclCommand extends $Command< DeleteNetworkAclCommandInput, DeleteNetworkAclCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNetworkAclCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteNetworkAclEntryCommand.ts b/clients/client-ec2/commands/DeleteNetworkAclEntryCommand.ts index a51f0d2cd377b..46338bfb89dfa 100644 --- a/clients/client-ec2/commands/DeleteNetworkAclEntryCommand.ts +++ b/clients/client-ec2/commands/DeleteNetworkAclEntryCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNetworkAclEntryCommandInput = DeleteNetworkAclEntryRequest; export type DeleteNetworkAclEntryCommandOutput = __MetadataBearer; +/** + *

Deletes the specified ingress or egress entry (rule) from the specified network ACL.

+ */ export class DeleteNetworkAclEntryCommand extends $Command< DeleteNetworkAclEntryCommandInput, DeleteNetworkAclEntryCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNetworkAclEntryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteNetworkInterfaceCommand.ts b/clients/client-ec2/commands/DeleteNetworkInterfaceCommand.ts index 2a1759e7126a4..8054eb99d9e19 100644 --- a/clients/client-ec2/commands/DeleteNetworkInterfaceCommand.ts +++ b/clients/client-ec2/commands/DeleteNetworkInterfaceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNetworkInterfaceCommandInput = DeleteNetworkInterfaceRequest; export type DeleteNetworkInterfaceCommandOutput = __MetadataBearer; +/** + *

Deletes the specified network interface. You must detach the network interface before you can delete it.

+ */ export class DeleteNetworkInterfaceCommand extends $Command< DeleteNetworkInterfaceCommandInput, DeleteNetworkInterfaceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNetworkInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteNetworkInterfacePermissionCommand.ts b/clients/client-ec2/commands/DeleteNetworkInterfacePermissionCommand.ts index 23951560051ed..92b55f4177520 100644 --- a/clients/client-ec2/commands/DeleteNetworkInterfacePermissionCommand.ts +++ b/clients/client-ec2/commands/DeleteNetworkInterfacePermissionCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteNetworkInterfacePermissionCommandInput = DeleteNetworkInterfacePermissionRequest; export type DeleteNetworkInterfacePermissionCommandOutput = DeleteNetworkInterfacePermissionResult & __MetadataBearer; +/** + *

Deletes a permission for a network interface. By default, you cannot delete the + * permission if the account for which you're removing the permission has attached the + * network interface to an instance. However, you can force delete the permission, + * regardless of any attachment.

+ */ export class DeleteNetworkInterfacePermissionCommand extends $Command< DeleteNetworkInterfacePermissionCommandInput, DeleteNetworkInterfacePermissionCommandOutput, @@ -34,6 +40,9 @@ export class DeleteNetworkInterfacePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeletePlacementGroupCommand.ts b/clients/client-ec2/commands/DeletePlacementGroupCommand.ts index 638efd9b7dffb..b2605a1f9bc6a 100644 --- a/clients/client-ec2/commands/DeletePlacementGroupCommand.ts +++ b/clients/client-ec2/commands/DeletePlacementGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DeletePlacementGroupCommandInput = DeletePlacementGroupRequest; export type DeletePlacementGroupCommandOutput = __MetadataBearer; +/** + *

Deletes the specified placement group. You must terminate all instances in the + * placement group before you can delete the placement group. For more information, see + * Placement groups in the Amazon Elastic Compute Cloud User + * Guide.

+ */ export class DeletePlacementGroupCommand extends $Command< DeletePlacementGroupCommandInput, DeletePlacementGroupCommandOutput, @@ -34,6 +40,9 @@ export class DeletePlacementGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteQueuedReservedInstancesCommand.ts b/clients/client-ec2/commands/DeleteQueuedReservedInstancesCommand.ts index 788d40ad89604..33b101fcef44b 100644 --- a/clients/client-ec2/commands/DeleteQueuedReservedInstancesCommand.ts +++ b/clients/client-ec2/commands/DeleteQueuedReservedInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteQueuedReservedInstancesCommandInput = DeleteQueuedReservedInstancesRequest; export type DeleteQueuedReservedInstancesCommandOutput = DeleteQueuedReservedInstancesResult & __MetadataBearer; +/** + *

Deletes the queued purchases for the specified Reserved Instances.

+ */ export class DeleteQueuedReservedInstancesCommand extends $Command< DeleteQueuedReservedInstancesCommandInput, DeleteQueuedReservedInstancesCommandOutput, @@ -34,6 +37,9 @@ export class DeleteQueuedReservedInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteRouteCommand.ts b/clients/client-ec2/commands/DeleteRouteCommand.ts index 9d846f665c7c6..93e17402eeba7 100644 --- a/clients/client-ec2/commands/DeleteRouteCommand.ts +++ b/clients/client-ec2/commands/DeleteRouteCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteRouteCommandInput = DeleteRouteRequest; export type DeleteRouteCommandOutput = __MetadataBearer; +/** + *

Deletes the specified route from the specified route table.

+ */ export class DeleteRouteCommand extends $Command< DeleteRouteCommandInput, DeleteRouteCommandOutput, @@ -31,6 +34,9 @@ export class DeleteRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteRouteTableCommand.ts b/clients/client-ec2/commands/DeleteRouteTableCommand.ts index fd24a46d08b69..8eecbd0017195 100644 --- a/clients/client-ec2/commands/DeleteRouteTableCommand.ts +++ b/clients/client-ec2/commands/DeleteRouteTableCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRouteTableCommandInput = DeleteRouteTableRequest; export type DeleteRouteTableCommandOutput = __MetadataBearer; +/** + *

Deletes the specified route table. You must disassociate the route table from any subnets before you can delete it. You can't delete the main route table.

+ */ export class DeleteRouteTableCommand extends $Command< DeleteRouteTableCommandInput, DeleteRouteTableCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRouteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteSecurityGroupCommand.ts b/clients/client-ec2/commands/DeleteSecurityGroupCommand.ts index 50a1457cef4e7..ea4e01bd0d955 100644 --- a/clients/client-ec2/commands/DeleteSecurityGroupCommand.ts +++ b/clients/client-ec2/commands/DeleteSecurityGroupCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteSecurityGroupCommandInput = DeleteSecurityGroupRequest; export type DeleteSecurityGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a security group.

+ *

If you attempt to delete a security group that is associated with an instance, or is + * referenced by another security group, the operation fails with + * InvalidGroup.InUse in EC2-Classic or + * DependencyViolation in EC2-VPC.

+ */ export class DeleteSecurityGroupCommand extends $Command< DeleteSecurityGroupCommandInput, DeleteSecurityGroupCommandOutput, @@ -34,6 +41,9 @@ export class DeleteSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteSnapshotCommand.ts b/clients/client-ec2/commands/DeleteSnapshotCommand.ts index 1820c53a06b46..b63eda023e78c 100644 --- a/clients/client-ec2/commands/DeleteSnapshotCommand.ts +++ b/clients/client-ec2/commands/DeleteSnapshotCommand.ts @@ -17,6 +17,18 @@ import { export type DeleteSnapshotCommandInput = DeleteSnapshotRequest; export type DeleteSnapshotCommandOutput = __MetadataBearer; +/** + *

Deletes the specified snapshot.

+ *

When you make periodic snapshots of a volume, the snapshots are incremental, and only the + * blocks on the device that have changed since your last snapshot are saved in the new snapshot. + * When you delete a snapshot, only the data not needed for any other snapshot is removed. So + * regardless of which prior snapshots have been deleted, all active snapshots will have access + * to all the information needed to restore the volume.

+ *

You cannot delete a snapshot of the root device of an EBS volume used by a registered AMI. + * You must first de-register the AMI before you can delete the snapshot.

+ *

For more information, see Deleting an Amazon EBS snapshot in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class DeleteSnapshotCommand extends $Command< DeleteSnapshotCommandInput, DeleteSnapshotCommandOutput, @@ -31,6 +43,9 @@ export class DeleteSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteSpotDatafeedSubscriptionCommand.ts b/clients/client-ec2/commands/DeleteSpotDatafeedSubscriptionCommand.ts index 9105b08796ca1..7c8ebb52606e7 100644 --- a/clients/client-ec2/commands/DeleteSpotDatafeedSubscriptionCommand.ts +++ b/clients/client-ec2/commands/DeleteSpotDatafeedSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSpotDatafeedSubscriptionCommandInput = DeleteSpotDatafeedSubscriptionRequest; export type DeleteSpotDatafeedSubscriptionCommandOutput = __MetadataBearer; +/** + *

Deletes the data feed for Spot Instances.

+ */ export class DeleteSpotDatafeedSubscriptionCommand extends $Command< DeleteSpotDatafeedSubscriptionCommandInput, DeleteSpotDatafeedSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSpotDatafeedSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteSubnetCommand.ts b/clients/client-ec2/commands/DeleteSubnetCommand.ts index f3b1c9ff5cb05..da499ed1ad947 100644 --- a/clients/client-ec2/commands/DeleteSubnetCommand.ts +++ b/clients/client-ec2/commands/DeleteSubnetCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteSubnetCommandInput = DeleteSubnetRequest; export type DeleteSubnetCommandOutput = __MetadataBearer; +/** + *

Deletes the specified subnet. You must terminate all running instances in the subnet before you can delete the subnet.

+ */ export class DeleteSubnetCommand extends $Command< DeleteSubnetCommandInput, DeleteSubnetCommandOutput, @@ -31,6 +34,9 @@ export class DeleteSubnetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTagsCommand.ts b/clients/client-ec2/commands/DeleteTagsCommand.ts index d3e927686b56d..e475d9c8e8377 100644 --- a/clients/client-ec2/commands/DeleteTagsCommand.ts +++ b/clients/client-ec2/commands/DeleteTagsCommand.ts @@ -17,6 +17,12 @@ import { export type DeleteTagsCommandInput = DeleteTagsRequest; export type DeleteTagsCommandOutput = __MetadataBearer; +/** + *

Deletes the specified set of tags from the specified set of resources.

+ *

To list the current tags, use DescribeTags. For more information about tags, see + * Tagging Your Resources + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -31,6 +37,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTrafficMirrorFilterCommand.ts b/clients/client-ec2/commands/DeleteTrafficMirrorFilterCommand.ts index ad74e82405e57..00fd14bfd9651 100644 --- a/clients/client-ec2/commands/DeleteTrafficMirrorFilterCommand.ts +++ b/clients/client-ec2/commands/DeleteTrafficMirrorFilterCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTrafficMirrorFilterCommandInput = DeleteTrafficMirrorFilterRequest; export type DeleteTrafficMirrorFilterCommandOutput = DeleteTrafficMirrorFilterResult & __MetadataBearer; +/** + *

Deletes the specified Traffic Mirror filter.

+ *

You cannot delete a Traffic Mirror filter that is in use by a Traffic Mirror session.

+ */ export class DeleteTrafficMirrorFilterCommand extends $Command< DeleteTrafficMirrorFilterCommandInput, DeleteTrafficMirrorFilterCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTrafficMirrorFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTrafficMirrorFilterRuleCommand.ts b/clients/client-ec2/commands/DeleteTrafficMirrorFilterRuleCommand.ts index 457e18d51253e..a780b5fd9dbaa 100644 --- a/clients/client-ec2/commands/DeleteTrafficMirrorFilterRuleCommand.ts +++ b/clients/client-ec2/commands/DeleteTrafficMirrorFilterRuleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTrafficMirrorFilterRuleCommandInput = DeleteTrafficMirrorFilterRuleRequest; export type DeleteTrafficMirrorFilterRuleCommandOutput = DeleteTrafficMirrorFilterRuleResult & __MetadataBearer; +/** + *

Deletes the specified Traffic Mirror rule.

+ */ export class DeleteTrafficMirrorFilterRuleCommand extends $Command< DeleteTrafficMirrorFilterRuleCommandInput, DeleteTrafficMirrorFilterRuleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTrafficMirrorFilterRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTrafficMirrorSessionCommand.ts b/clients/client-ec2/commands/DeleteTrafficMirrorSessionCommand.ts index 2489abc217ae4..6ee0663a70554 100644 --- a/clients/client-ec2/commands/DeleteTrafficMirrorSessionCommand.ts +++ b/clients/client-ec2/commands/DeleteTrafficMirrorSessionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTrafficMirrorSessionCommandInput = DeleteTrafficMirrorSessionRequest; export type DeleteTrafficMirrorSessionCommandOutput = DeleteTrafficMirrorSessionResult & __MetadataBearer; +/** + *

Deletes the specified Traffic Mirror session.

+ */ export class DeleteTrafficMirrorSessionCommand extends $Command< DeleteTrafficMirrorSessionCommandInput, DeleteTrafficMirrorSessionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTrafficMirrorSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTrafficMirrorTargetCommand.ts b/clients/client-ec2/commands/DeleteTrafficMirrorTargetCommand.ts index 414820218a3a9..fc0f1f7009817 100644 --- a/clients/client-ec2/commands/DeleteTrafficMirrorTargetCommand.ts +++ b/clients/client-ec2/commands/DeleteTrafficMirrorTargetCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTrafficMirrorTargetCommandInput = DeleteTrafficMirrorTargetRequest; export type DeleteTrafficMirrorTargetCommandOutput = DeleteTrafficMirrorTargetResult & __MetadataBearer; +/** + *

Deletes the specified Traffic Mirror target.

+ *

You cannot delete a Traffic Mirror target that is in use by a Traffic Mirror session.

+ */ export class DeleteTrafficMirrorTargetCommand extends $Command< DeleteTrafficMirrorTargetCommandInput, DeleteTrafficMirrorTargetCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTrafficMirrorTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTransitGatewayCommand.ts b/clients/client-ec2/commands/DeleteTransitGatewayCommand.ts index 7e0b9ecb48a88..e64791563930c 100644 --- a/clients/client-ec2/commands/DeleteTransitGatewayCommand.ts +++ b/clients/client-ec2/commands/DeleteTransitGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTransitGatewayCommandInput = DeleteTransitGatewayRequest; export type DeleteTransitGatewayCommandOutput = DeleteTransitGatewayResult & __MetadataBearer; +/** + *

Deletes the specified transit gateway.

+ */ export class DeleteTransitGatewayCommand extends $Command< DeleteTransitGatewayCommandInput, DeleteTransitGatewayCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTransitGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTransitGatewayMulticastDomainCommand.ts b/clients/client-ec2/commands/DeleteTransitGatewayMulticastDomainCommand.ts index 2b473f993c6d6..35a6b10cc4f78 100644 --- a/clients/client-ec2/commands/DeleteTransitGatewayMulticastDomainCommand.ts +++ b/clients/client-ec2/commands/DeleteTransitGatewayMulticastDomainCommand.ts @@ -24,6 +24,9 @@ export type DeleteTransitGatewayMulticastDomainCommandInput = DeleteTransitGatew export type DeleteTransitGatewayMulticastDomainCommandOutput = DeleteTransitGatewayMulticastDomainResult & __MetadataBearer; +/** + *

Deletes the specified transit gateway multicast domain.

+ */ export class DeleteTransitGatewayMulticastDomainCommand extends $Command< DeleteTransitGatewayMulticastDomainCommandInput, DeleteTransitGatewayMulticastDomainCommandOutput, @@ -38,6 +41,9 @@ export class DeleteTransitGatewayMulticastDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTransitGatewayPeeringAttachmentCommand.ts b/clients/client-ec2/commands/DeleteTransitGatewayPeeringAttachmentCommand.ts index eb348e5e2f5c8..21dcab31b97c0 100644 --- a/clients/client-ec2/commands/DeleteTransitGatewayPeeringAttachmentCommand.ts +++ b/clients/client-ec2/commands/DeleteTransitGatewayPeeringAttachmentCommand.ts @@ -22,6 +22,9 @@ export type DeleteTransitGatewayPeeringAttachmentCommandInput = DeleteTransitGat export type DeleteTransitGatewayPeeringAttachmentCommandOutput = DeleteTransitGatewayPeeringAttachmentResult & __MetadataBearer; +/** + *

Deletes a transit gateway peering attachment.

+ */ export class DeleteTransitGatewayPeeringAttachmentCommand extends $Command< DeleteTransitGatewayPeeringAttachmentCommandInput, DeleteTransitGatewayPeeringAttachmentCommandOutput, @@ -36,6 +39,9 @@ export class DeleteTransitGatewayPeeringAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTransitGatewayPrefixListReferenceCommand.ts b/clients/client-ec2/commands/DeleteTransitGatewayPrefixListReferenceCommand.ts index 1dacd83b9fefb..666959d5d28bc 100644 --- a/clients/client-ec2/commands/DeleteTransitGatewayPrefixListReferenceCommand.ts +++ b/clients/client-ec2/commands/DeleteTransitGatewayPrefixListReferenceCommand.ts @@ -24,6 +24,9 @@ export type DeleteTransitGatewayPrefixListReferenceCommandInput = DeleteTransitG export type DeleteTransitGatewayPrefixListReferenceCommandOutput = DeleteTransitGatewayPrefixListReferenceResult & __MetadataBearer; +/** + *

Deletes a reference (route) to a prefix list in a specified transit gateway route table.

+ */ export class DeleteTransitGatewayPrefixListReferenceCommand extends $Command< DeleteTransitGatewayPrefixListReferenceCommandInput, DeleteTransitGatewayPrefixListReferenceCommandOutput, @@ -38,6 +41,9 @@ export class DeleteTransitGatewayPrefixListReferenceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTransitGatewayRouteCommand.ts b/clients/client-ec2/commands/DeleteTransitGatewayRouteCommand.ts index fd7519bbd34b1..4c5fd06531943 100644 --- a/clients/client-ec2/commands/DeleteTransitGatewayRouteCommand.ts +++ b/clients/client-ec2/commands/DeleteTransitGatewayRouteCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTransitGatewayRouteCommandInput = DeleteTransitGatewayRouteRequest; export type DeleteTransitGatewayRouteCommandOutput = DeleteTransitGatewayRouteResult & __MetadataBearer; +/** + *

Deletes the specified route from the specified transit gateway route table.

+ */ export class DeleteTransitGatewayRouteCommand extends $Command< DeleteTransitGatewayRouteCommandInput, DeleteTransitGatewayRouteCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTransitGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTransitGatewayRouteTableCommand.ts b/clients/client-ec2/commands/DeleteTransitGatewayRouteTableCommand.ts index 4304f8702b790..2e43f71c09dd8 100644 --- a/clients/client-ec2/commands/DeleteTransitGatewayRouteTableCommand.ts +++ b/clients/client-ec2/commands/DeleteTransitGatewayRouteTableCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTransitGatewayRouteTableCommandInput = DeleteTransitGatewayRouteTableRequest; export type DeleteTransitGatewayRouteTableCommandOutput = DeleteTransitGatewayRouteTableResult & __MetadataBearer; +/** + *

Deletes the specified transit gateway route table. You must disassociate the route table from any + * transit gateway route tables before you can delete it.

+ */ export class DeleteTransitGatewayRouteTableCommand extends $Command< DeleteTransitGatewayRouteTableCommandInput, DeleteTransitGatewayRouteTableCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTransitGatewayRouteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteTransitGatewayVpcAttachmentCommand.ts b/clients/client-ec2/commands/DeleteTransitGatewayVpcAttachmentCommand.ts index 82b24ef0de0e1..300a6268af61d 100644 --- a/clients/client-ec2/commands/DeleteTransitGatewayVpcAttachmentCommand.ts +++ b/clients/client-ec2/commands/DeleteTransitGatewayVpcAttachmentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTransitGatewayVpcAttachmentCommandInput = DeleteTransitGatewayVpcAttachmentRequest; export type DeleteTransitGatewayVpcAttachmentCommandOutput = DeleteTransitGatewayVpcAttachmentResult & __MetadataBearer; +/** + *

Deletes the specified VPC attachment.

+ */ export class DeleteTransitGatewayVpcAttachmentCommand extends $Command< DeleteTransitGatewayVpcAttachmentCommandInput, DeleteTransitGatewayVpcAttachmentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTransitGatewayVpcAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVolumeCommand.ts b/clients/client-ec2/commands/DeleteVolumeCommand.ts index d3d648fe9a5df..adeec044fc10d 100644 --- a/clients/client-ec2/commands/DeleteVolumeCommand.ts +++ b/clients/client-ec2/commands/DeleteVolumeCommand.ts @@ -17,6 +17,13 @@ import { export type DeleteVolumeCommandInput = DeleteVolumeRequest; export type DeleteVolumeCommandOutput = __MetadataBearer; +/** + *

Deletes the specified EBS volume. The volume must be in the available state + * (not attached to an instance).

+ *

The volume can remain in the deleting state for several minutes.

+ *

For more information, see Deleting an Amazon EBS volume in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class DeleteVolumeCommand extends $Command< DeleteVolumeCommandInput, DeleteVolumeCommandOutput, @@ -31,6 +38,9 @@ export class DeleteVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVpcCommand.ts b/clients/client-ec2/commands/DeleteVpcCommand.ts index c277caf573a0a..32e600e525182 100644 --- a/clients/client-ec2/commands/DeleteVpcCommand.ts +++ b/clients/client-ec2/commands/DeleteVpcCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteVpcCommandInput = DeleteVpcRequest; export type DeleteVpcCommandOutput = __MetadataBearer; +/** + *

Deletes the specified VPC. You must detach or delete all gateways and resources that are associated with the VPC before you can delete it. For example, you must terminate all instances running in the VPC, delete all security groups associated with the VPC (except the default one), delete all route tables associated with the VPC (except the default one), and so on.

+ */ export class DeleteVpcCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class DeleteVpcCommand extends $Command, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVpcEndpointConnectionNotificationsCommand.ts b/clients/client-ec2/commands/DeleteVpcEndpointConnectionNotificationsCommand.ts index 84accc04b19ac..558f6aa0091b4 100644 --- a/clients/client-ec2/commands/DeleteVpcEndpointConnectionNotificationsCommand.ts +++ b/clients/client-ec2/commands/DeleteVpcEndpointConnectionNotificationsCommand.ts @@ -24,6 +24,9 @@ export type DeleteVpcEndpointConnectionNotificationsCommandInput = DeleteVpcEndp export type DeleteVpcEndpointConnectionNotificationsCommandOutput = DeleteVpcEndpointConnectionNotificationsResult & __MetadataBearer; +/** + *

Deletes one or more VPC endpoint connection notifications.

+ */ export class DeleteVpcEndpointConnectionNotificationsCommand extends $Command< DeleteVpcEndpointConnectionNotificationsCommandInput, DeleteVpcEndpointConnectionNotificationsCommandOutput, @@ -38,6 +41,9 @@ export class DeleteVpcEndpointConnectionNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVpcEndpointServiceConfigurationsCommand.ts b/clients/client-ec2/commands/DeleteVpcEndpointServiceConfigurationsCommand.ts index 32cd678c98428..d2c2f08e62fcc 100644 --- a/clients/client-ec2/commands/DeleteVpcEndpointServiceConfigurationsCommand.ts +++ b/clients/client-ec2/commands/DeleteVpcEndpointServiceConfigurationsCommand.ts @@ -24,6 +24,12 @@ export type DeleteVpcEndpointServiceConfigurationsCommandInput = DeleteVpcEndpoi export type DeleteVpcEndpointServiceConfigurationsCommandOutput = DeleteVpcEndpointServiceConfigurationsResult & __MetadataBearer; +/** + *

Deletes one or more VPC endpoint service configurations in your account. Before you + * delete the endpoint service configuration, you must reject any Available or + * PendingAcceptance interface endpoint connections that are attached to + * the service.

+ */ export class DeleteVpcEndpointServiceConfigurationsCommand extends $Command< DeleteVpcEndpointServiceConfigurationsCommandInput, DeleteVpcEndpointServiceConfigurationsCommandOutput, @@ -38,6 +44,9 @@ export class DeleteVpcEndpointServiceConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVpcEndpointsCommand.ts b/clients/client-ec2/commands/DeleteVpcEndpointsCommand.ts index d4c68bc58c06e..61d15e36a50cd 100644 --- a/clients/client-ec2/commands/DeleteVpcEndpointsCommand.ts +++ b/clients/client-ec2/commands/DeleteVpcEndpointsCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteVpcEndpointsCommandInput = DeleteVpcEndpointsRequest; export type DeleteVpcEndpointsCommandOutput = DeleteVpcEndpointsResult & __MetadataBearer; +/** + *

Deletes one or more specified VPC endpoints. Deleting a gateway endpoint also deletes + * the endpoint routes in the route tables that were associated with the endpoint. Deleting + * an interface endpoint or a Gateway Load Balancer endpoint deletes the endpoint network interfaces. Gateway Load Balancer endpoints can only be deleted if the routes that are associated with the endpoint are deleted.

+ */ export class DeleteVpcEndpointsCommand extends $Command< DeleteVpcEndpointsCommandInput, DeleteVpcEndpointsCommandOutput, @@ -34,6 +39,9 @@ export class DeleteVpcEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVpcPeeringConnectionCommand.ts b/clients/client-ec2/commands/DeleteVpcPeeringConnectionCommand.ts index 3758fba016e88..9b9d654e9bbda 100644 --- a/clients/client-ec2/commands/DeleteVpcPeeringConnectionCommand.ts +++ b/clients/client-ec2/commands/DeleteVpcPeeringConnectionCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteVpcPeeringConnectionCommandInput = DeleteVpcPeeringConnectionRequest; export type DeleteVpcPeeringConnectionCommandOutput = DeleteVpcPeeringConnectionResult & __MetadataBearer; +/** + *

Deletes a VPC peering connection. Either the owner of the requester VPC or the owner + * of the accepter VPC can delete the VPC peering connection if it's in the + * active state. The owner of the requester VPC can delete a VPC peering + * connection in the pending-acceptance state. You cannot delete a VPC peering + * connection that's in the failed state.

+ */ export class DeleteVpcPeeringConnectionCommand extends $Command< DeleteVpcPeeringConnectionCommandInput, DeleteVpcPeeringConnectionCommandOutput, @@ -34,6 +41,9 @@ export class DeleteVpcPeeringConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVpnConnectionCommand.ts b/clients/client-ec2/commands/DeleteVpnConnectionCommand.ts index 2437b3c0c8549..b8bdfbc883c42 100644 --- a/clients/client-ec2/commands/DeleteVpnConnectionCommand.ts +++ b/clients/client-ec2/commands/DeleteVpnConnectionCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteVpnConnectionCommandInput = DeleteVpnConnectionRequest; export type DeleteVpnConnectionCommandOutput = __MetadataBearer; +/** + *

Deletes the specified VPN connection.

+ *

If you're deleting the VPC and its associated components, we recommend that you detach the virtual private gateway from the VPC and delete the VPC before deleting the VPN connection. If you believe that the tunnel credentials for your VPN connection have been compromised, you can delete the VPN connection and create a new one that has new keys, without needing to delete the VPC or virtual private gateway. If you create a new VPN connection, you must reconfigure the customer gateway device using the new configuration information returned with the new VPN connection ID.

+ *

For certificate-based authentication, delete all AWS Certificate Manager (ACM) private certificates used for the AWS-side tunnel endpoints for the VPN connection before deleting the VPN connection.

+ */ export class DeleteVpnConnectionCommand extends $Command< DeleteVpnConnectionCommandInput, DeleteVpnConnectionCommandOutput, @@ -34,6 +39,9 @@ export class DeleteVpnConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVpnConnectionRouteCommand.ts b/clients/client-ec2/commands/DeleteVpnConnectionRouteCommand.ts index 0eca7b7c90629..d1813f83461a3 100644 --- a/clients/client-ec2/commands/DeleteVpnConnectionRouteCommand.ts +++ b/clients/client-ec2/commands/DeleteVpnConnectionRouteCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVpnConnectionRouteCommandInput = DeleteVpnConnectionRouteRequest; export type DeleteVpnConnectionRouteCommandOutput = __MetadataBearer; +/** + *

Deletes the specified static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

+ */ export class DeleteVpnConnectionRouteCommand extends $Command< DeleteVpnConnectionRouteCommandInput, DeleteVpnConnectionRouteCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVpnConnectionRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeleteVpnGatewayCommand.ts b/clients/client-ec2/commands/DeleteVpnGatewayCommand.ts index 1f67aacebded2..3640ac5ed6102 100644 --- a/clients/client-ec2/commands/DeleteVpnGatewayCommand.ts +++ b/clients/client-ec2/commands/DeleteVpnGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVpnGatewayCommandInput = DeleteVpnGatewayRequest; export type DeleteVpnGatewayCommandOutput = __MetadataBearer; +/** + *

Deletes the specified virtual private gateway. You must first detach the virtual private gateway from the VPC. Note that you don't need to delete the virtual private gateway if you plan to delete and recreate the VPN connection between your VPC and your network.

+ */ export class DeleteVpnGatewayCommand extends $Command< DeleteVpnGatewayCommandInput, DeleteVpnGatewayCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVpnGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeprovisionByoipCidrCommand.ts b/clients/client-ec2/commands/DeprovisionByoipCidrCommand.ts index 132b45c44302c..bcf9b52754243 100644 --- a/clients/client-ec2/commands/DeprovisionByoipCidrCommand.ts +++ b/clients/client-ec2/commands/DeprovisionByoipCidrCommand.ts @@ -20,6 +20,12 @@ import { export type DeprovisionByoipCidrCommandInput = DeprovisionByoipCidrRequest; export type DeprovisionByoipCidrCommandOutput = DeprovisionByoipCidrResult & __MetadataBearer; +/** + *

Releases the specified address range that you provisioned for use with your AWS resources + * through bring your own IP addresses (BYOIP) and deletes the corresponding address pool.

+ *

Before you can release an address range, you must stop advertising it using WithdrawByoipCidr and you must not have any IP addresses allocated from its + * address range.

+ */ export class DeprovisionByoipCidrCommand extends $Command< DeprovisionByoipCidrCommandInput, DeprovisionByoipCidrCommandOutput, @@ -34,6 +40,9 @@ export class DeprovisionByoipCidrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeregisterImageCommand.ts b/clients/client-ec2/commands/DeregisterImageCommand.ts index 494533095187c..4ca1c2d920238 100644 --- a/clients/client-ec2/commands/DeregisterImageCommand.ts +++ b/clients/client-ec2/commands/DeregisterImageCommand.ts @@ -17,6 +17,16 @@ import { export type DeregisterImageCommandInput = DeregisterImageRequest; export type DeregisterImageCommandOutput = __MetadataBearer; +/** + *

Deregisters the specified AMI. After you deregister an AMI, it can't be used to launch + * new instances; however, it doesn't affect any instances that you've already launched + * from the AMI. You'll continue to incur usage costs for those instances until you + * terminate them.

+ *

When you deregister an Amazon EBS-backed AMI, it doesn't affect the snapshot that was + * created for the root volume of the instance during the AMI creation process. When you + * deregister an instance store-backed AMI, it doesn't affect the files that you uploaded + * to Amazon S3 when you created the AMI.

+ */ export class DeregisterImageCommand extends $Command< DeregisterImageCommandInput, DeregisterImageCommandOutput, @@ -31,6 +41,9 @@ export class DeregisterImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeregisterInstanceEventNotificationAttributesCommand.ts b/clients/client-ec2/commands/DeregisterInstanceEventNotificationAttributesCommand.ts index de5ef90852620..a9836efa39679 100644 --- a/clients/client-ec2/commands/DeregisterInstanceEventNotificationAttributesCommand.ts +++ b/clients/client-ec2/commands/DeregisterInstanceEventNotificationAttributesCommand.ts @@ -24,6 +24,10 @@ export type DeregisterInstanceEventNotificationAttributesCommandInput = Deregist export type DeregisterInstanceEventNotificationAttributesCommandOutput = DeregisterInstanceEventNotificationAttributesResult & __MetadataBearer; +/** + *

Deregisters tag keys to prevent tags that have the specified tag keys from being included + * in scheduled event notifications for resources in the Region.

+ */ export class DeregisterInstanceEventNotificationAttributesCommand extends $Command< DeregisterInstanceEventNotificationAttributesCommandInput, DeregisterInstanceEventNotificationAttributesCommandOutput, @@ -38,6 +42,9 @@ export class DeregisterInstanceEventNotificationAttributesCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeregisterTransitGatewayMulticastGroupMembersCommand.ts b/clients/client-ec2/commands/DeregisterTransitGatewayMulticastGroupMembersCommand.ts index 03a39a6ff3ad2..616ec5f7bc94a 100644 --- a/clients/client-ec2/commands/DeregisterTransitGatewayMulticastGroupMembersCommand.ts +++ b/clients/client-ec2/commands/DeregisterTransitGatewayMulticastGroupMembersCommand.ts @@ -24,6 +24,9 @@ export type DeregisterTransitGatewayMulticastGroupMembersCommandInput = Deregist export type DeregisterTransitGatewayMulticastGroupMembersCommandOutput = DeregisterTransitGatewayMulticastGroupMembersResult & __MetadataBearer; +/** + *

Deregisters the specified members (network interfaces) from the transit gateway multicast group.

+ */ export class DeregisterTransitGatewayMulticastGroupMembersCommand extends $Command< DeregisterTransitGatewayMulticastGroupMembersCommandInput, DeregisterTransitGatewayMulticastGroupMembersCommandOutput, @@ -38,6 +41,9 @@ export class DeregisterTransitGatewayMulticastGroupMembersCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DeregisterTransitGatewayMulticastGroupSourcesCommand.ts b/clients/client-ec2/commands/DeregisterTransitGatewayMulticastGroupSourcesCommand.ts index c221ca89e67bc..f3394b51d7d60 100644 --- a/clients/client-ec2/commands/DeregisterTransitGatewayMulticastGroupSourcesCommand.ts +++ b/clients/client-ec2/commands/DeregisterTransitGatewayMulticastGroupSourcesCommand.ts @@ -24,6 +24,9 @@ export type DeregisterTransitGatewayMulticastGroupSourcesCommandInput = Deregist export type DeregisterTransitGatewayMulticastGroupSourcesCommandOutput = DeregisterTransitGatewayMulticastGroupSourcesResult & __MetadataBearer; +/** + *

Deregisters the specified sources (network interfaces) from the transit gateway multicast group.

+ */ export class DeregisterTransitGatewayMulticastGroupSourcesCommand extends $Command< DeregisterTransitGatewayMulticastGroupSourcesCommandInput, DeregisterTransitGatewayMulticastGroupSourcesCommandOutput, @@ -38,6 +41,9 @@ export class DeregisterTransitGatewayMulticastGroupSourcesCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeAccountAttributesCommand.ts b/clients/client-ec2/commands/DescribeAccountAttributesCommand.ts index 64d21305163f0..017dd7a9064eb 100644 --- a/clients/client-ec2/commands/DescribeAccountAttributesCommand.ts +++ b/clients/client-ec2/commands/DescribeAccountAttributesCommand.ts @@ -20,6 +20,43 @@ import { export type DescribeAccountAttributesCommandInput = DescribeAccountAttributesRequest; export type DescribeAccountAttributesCommandOutput = DescribeAccountAttributesResult & __MetadataBearer; +/** + *

Describes attributes of your AWS account. The following are the supported account attributes:

+ *
    + *
  • + *

    + * supported-platforms: Indicates whether your account can launch instances + * into EC2-Classic and EC2-VPC, or only into EC2-VPC.

    + *
  • + *
  • + *

    + * default-vpc: The ID of the default VPC for your account, or + * none.

    + *
  • + *
  • + *

    + * max-instances: This attribute is no longer supported. The returned + * value does not reflect your actual vCPU limit for running On-Demand Instances. + * For more information, see On-Demand Instance Limits in the + * Amazon Elastic Compute Cloud User Guide.

    + *
  • + *
  • + *

    + * vpc-max-security-groups-per-interface: The maximum number of security groups + * that you can assign to a network interface.

    + *
  • + *
  • + *

    + * max-elastic-ips: The maximum number of Elastic IP addresses that you can + * allocate for use with EC2-Classic.

    + *
  • + *
  • + *

    + * vpc-max-elastic-ips: The maximum number of Elastic IP addresses that you can + * allocate for use with EC2-VPC.

    + *
  • + *
+ */ export class DescribeAccountAttributesCommand extends $Command< DescribeAccountAttributesCommandInput, DescribeAccountAttributesCommandOutput, @@ -34,6 +71,9 @@ export class DescribeAccountAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeAddressesCommand.ts b/clients/client-ec2/commands/DescribeAddressesCommand.ts index 8f19774346c9f..3f0e1f54998c7 100644 --- a/clients/client-ec2/commands/DescribeAddressesCommand.ts +++ b/clients/client-ec2/commands/DescribeAddressesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAddressesCommandInput = DescribeAddressesRequest; export type DescribeAddressesCommandOutput = DescribeAddressesResult & __MetadataBearer; +/** + *

Describes the specified Elastic IP addresses or all of your Elastic IP addresses.

+ *

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. + * For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeAddressesCommand extends $Command< DescribeAddressesCommandInput, DescribeAddressesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeAggregateIdFormatCommand.ts b/clients/client-ec2/commands/DescribeAggregateIdFormatCommand.ts index 560b89650d32a..9a4402d22b1a7 100644 --- a/clients/client-ec2/commands/DescribeAggregateIdFormatCommand.ts +++ b/clients/client-ec2/commands/DescribeAggregateIdFormatCommand.ts @@ -20,6 +20,26 @@ import { export type DescribeAggregateIdFormatCommandInput = DescribeAggregateIdFormatRequest; export type DescribeAggregateIdFormatCommandOutput = DescribeAggregateIdFormatResult & __MetadataBearer; +/** + *

Describes the longer ID format settings for all resource types in a specific + * Region. This request is useful for performing a quick audit to determine whether a + * specific Region is fully opted in for longer IDs (17-character IDs).

+ * + *

This request only returns information about resource types that support longer IDs.

+ *

The following resource types support longer IDs: bundle | + * conversion-task | customer-gateway | dhcp-options | + * elastic-ip-allocation | elastic-ip-association | + * export-task | flow-log | image | + * import-task | instance | internet-gateway | + * network-acl | network-acl-association | + * network-interface | network-interface-attachment | + * prefix-list | reservation | route-table | + * route-table-association | security-group | + * snapshot | subnet | + * subnet-cidr-block-association | volume | vpc | + * vpc-cidr-block-association | vpc-endpoint | + * vpc-peering-connection | vpn-connection | vpn-gateway.

+ */ export class DescribeAggregateIdFormatCommand extends $Command< DescribeAggregateIdFormatCommandInput, DescribeAggregateIdFormatCommandOutput, @@ -34,6 +54,9 @@ export class DescribeAggregateIdFormatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeAvailabilityZonesCommand.ts b/clients/client-ec2/commands/DescribeAvailabilityZonesCommand.ts index 7dff3a60bca02..f318b7008ad00 100644 --- a/clients/client-ec2/commands/DescribeAvailabilityZonesCommand.ts +++ b/clients/client-ec2/commands/DescribeAvailabilityZonesCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeAvailabilityZonesCommandInput = DescribeAvailabilityZonesRequest; export type DescribeAvailabilityZonesCommandOutput = DescribeAvailabilityZonesResult & __MetadataBearer; +/** + *

Describes the Availability Zones, Local Zones, and Wavelength Zones that are available to + * you. If there is an event impacting a zone, you can use this request to view the state and any + * provided messages for that zone.

+ *

For more information about Availability Zones, Local Zones, and Wavelength Zones, see + * Regions, Zones and + * Outposts in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeAvailabilityZonesCommand extends $Command< DescribeAvailabilityZonesCommandInput, DescribeAvailabilityZonesCommandOutput, @@ -34,6 +42,9 @@ export class DescribeAvailabilityZonesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeBundleTasksCommand.ts b/clients/client-ec2/commands/DescribeBundleTasksCommand.ts index 34ad201bf5547..b476fb2db63d3 100644 --- a/clients/client-ec2/commands/DescribeBundleTasksCommand.ts +++ b/clients/client-ec2/commands/DescribeBundleTasksCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeBundleTasksCommandInput = DescribeBundleTasksRequest; export type DescribeBundleTasksCommandOutput = DescribeBundleTasksResult & __MetadataBearer; +/** + *

Describes the specified bundle tasks or all of your bundle tasks.

+ * + *

Completed bundle tasks are listed for only a limited time. If your bundle task is no longer in the list, you can still register an AMI from it. Just use RegisterImage with the Amazon S3 bucket name and image manifest name you provided to the bundle task.

+ *
+ */ export class DescribeBundleTasksCommand extends $Command< DescribeBundleTasksCommandInput, DescribeBundleTasksCommandOutput, @@ -34,6 +40,9 @@ export class DescribeBundleTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeByoipCidrsCommand.ts b/clients/client-ec2/commands/DescribeByoipCidrsCommand.ts index 0595605ec3429..06352395cfec7 100644 --- a/clients/client-ec2/commands/DescribeByoipCidrsCommand.ts +++ b/clients/client-ec2/commands/DescribeByoipCidrsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeByoipCidrsCommandInput = DescribeByoipCidrsRequest; export type DescribeByoipCidrsCommandOutput = DescribeByoipCidrsResult & __MetadataBearer; +/** + *

Describes the IP address ranges that were specified in calls to ProvisionByoipCidr.

+ *

To describe the address pools that were created when you provisioned the address + * ranges, use DescribePublicIpv4Pools or DescribeIpv6Pools.

+ */ export class DescribeByoipCidrsCommand extends $Command< DescribeByoipCidrsCommandInput, DescribeByoipCidrsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeByoipCidrsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeCapacityReservationsCommand.ts b/clients/client-ec2/commands/DescribeCapacityReservationsCommand.ts index 9faa6cecf6201..f4ccd7160e31a 100644 --- a/clients/client-ec2/commands/DescribeCapacityReservationsCommand.ts +++ b/clients/client-ec2/commands/DescribeCapacityReservationsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeCapacityReservationsCommandInput = DescribeCapacityReservationsRequest; export type DescribeCapacityReservationsCommandOutput = DescribeCapacityReservationsResult & __MetadataBearer; +/** + *

Describes one or more of your Capacity Reservations. The results describe only the Capacity Reservations in the AWS + * Region that you're currently using.

+ */ export class DescribeCapacityReservationsCommand extends $Command< DescribeCapacityReservationsCommandInput, DescribeCapacityReservationsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeCapacityReservationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeCarrierGatewaysCommand.ts b/clients/client-ec2/commands/DescribeCarrierGatewaysCommand.ts index 57fd348797df9..245133e3d80e8 100644 --- a/clients/client-ec2/commands/DescribeCarrierGatewaysCommand.ts +++ b/clients/client-ec2/commands/DescribeCarrierGatewaysCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCarrierGatewaysCommandInput = DescribeCarrierGatewaysRequest; export type DescribeCarrierGatewaysCommandOutput = DescribeCarrierGatewaysResult & __MetadataBearer; +/** + *

Describes one or more of your carrier gateways.

+ */ export class DescribeCarrierGatewaysCommand extends $Command< DescribeCarrierGatewaysCommandInput, DescribeCarrierGatewaysCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCarrierGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeClassicLinkInstancesCommand.ts b/clients/client-ec2/commands/DescribeClassicLinkInstancesCommand.ts index c76eddd777e94..1d5cc7a1a6173 100644 --- a/clients/client-ec2/commands/DescribeClassicLinkInstancesCommand.ts +++ b/clients/client-ec2/commands/DescribeClassicLinkInstancesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeClassicLinkInstancesCommandInput = DescribeClassicLinkInstancesRequest; export type DescribeClassicLinkInstancesCommandOutput = DescribeClassicLinkInstancesResult & __MetadataBearer; +/** + *

Describes one or more of your linked EC2-Classic instances. This request only returns + * information about EC2-Classic instances linked to a VPC through ClassicLink. You cannot + * use this request to return information about other instances.

+ */ export class DescribeClassicLinkInstancesCommand extends $Command< DescribeClassicLinkInstancesCommandInput, DescribeClassicLinkInstancesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeClassicLinkInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeClientVpnAuthorizationRulesCommand.ts b/clients/client-ec2/commands/DescribeClientVpnAuthorizationRulesCommand.ts index 6d5cbc29f5d59..0c26be31f9c41 100644 --- a/clients/client-ec2/commands/DescribeClientVpnAuthorizationRulesCommand.ts +++ b/clients/client-ec2/commands/DescribeClientVpnAuthorizationRulesCommand.ts @@ -24,6 +24,9 @@ export type DescribeClientVpnAuthorizationRulesCommandInput = DescribeClientVpnA export type DescribeClientVpnAuthorizationRulesCommandOutput = DescribeClientVpnAuthorizationRulesResult & __MetadataBearer; +/** + *

Describes the authorization rules for a specified Client VPN endpoint.

+ */ export class DescribeClientVpnAuthorizationRulesCommand extends $Command< DescribeClientVpnAuthorizationRulesCommandInput, DescribeClientVpnAuthorizationRulesCommandOutput, @@ -38,6 +41,9 @@ export class DescribeClientVpnAuthorizationRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeClientVpnConnectionsCommand.ts b/clients/client-ec2/commands/DescribeClientVpnConnectionsCommand.ts index 933fb943371f0..77b20ea4d2389 100644 --- a/clients/client-ec2/commands/DescribeClientVpnConnectionsCommand.ts +++ b/clients/client-ec2/commands/DescribeClientVpnConnectionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeClientVpnConnectionsCommandInput = DescribeClientVpnConnectionsRequest; export type DescribeClientVpnConnectionsCommandOutput = DescribeClientVpnConnectionsResult & __MetadataBearer; +/** + *

Describes active client connections and connections that have been terminated within the last 60 + * minutes for the specified Client VPN endpoint.

+ */ export class DescribeClientVpnConnectionsCommand extends $Command< DescribeClientVpnConnectionsCommandInput, DescribeClientVpnConnectionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeClientVpnConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeClientVpnEndpointsCommand.ts b/clients/client-ec2/commands/DescribeClientVpnEndpointsCommand.ts index b19c7c83cb6a1..c3ddead2fedb8 100644 --- a/clients/client-ec2/commands/DescribeClientVpnEndpointsCommand.ts +++ b/clients/client-ec2/commands/DescribeClientVpnEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClientVpnEndpointsCommandInput = DescribeClientVpnEndpointsRequest; export type DescribeClientVpnEndpointsCommandOutput = DescribeClientVpnEndpointsResult & __MetadataBearer; +/** + *

Describes one or more Client VPN endpoints in the account.

+ */ export class DescribeClientVpnEndpointsCommand extends $Command< DescribeClientVpnEndpointsCommandInput, DescribeClientVpnEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClientVpnEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeClientVpnRoutesCommand.ts b/clients/client-ec2/commands/DescribeClientVpnRoutesCommand.ts index 2030c703a5cb7..ff68c9b07cb9c 100644 --- a/clients/client-ec2/commands/DescribeClientVpnRoutesCommand.ts +++ b/clients/client-ec2/commands/DescribeClientVpnRoutesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClientVpnRoutesCommandInput = DescribeClientVpnRoutesRequest; export type DescribeClientVpnRoutesCommandOutput = DescribeClientVpnRoutesResult & __MetadataBearer; +/** + *

Describes the routes for the specified Client VPN endpoint.

+ */ export class DescribeClientVpnRoutesCommand extends $Command< DescribeClientVpnRoutesCommandInput, DescribeClientVpnRoutesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClientVpnRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeClientVpnTargetNetworksCommand.ts b/clients/client-ec2/commands/DescribeClientVpnTargetNetworksCommand.ts index f8c076c38be10..94cf04449312f 100644 --- a/clients/client-ec2/commands/DescribeClientVpnTargetNetworksCommand.ts +++ b/clients/client-ec2/commands/DescribeClientVpnTargetNetworksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClientVpnTargetNetworksCommandInput = DescribeClientVpnTargetNetworksRequest; export type DescribeClientVpnTargetNetworksCommandOutput = DescribeClientVpnTargetNetworksResult & __MetadataBearer; +/** + *

Describes the target networks associated with the specified Client VPN endpoint.

+ */ export class DescribeClientVpnTargetNetworksCommand extends $Command< DescribeClientVpnTargetNetworksCommandInput, DescribeClientVpnTargetNetworksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClientVpnTargetNetworksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeCoipPoolsCommand.ts b/clients/client-ec2/commands/DescribeCoipPoolsCommand.ts index 21beb5e4ddbb5..b354cbbe9382b 100644 --- a/clients/client-ec2/commands/DescribeCoipPoolsCommand.ts +++ b/clients/client-ec2/commands/DescribeCoipPoolsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCoipPoolsCommandInput = DescribeCoipPoolsRequest; export type DescribeCoipPoolsCommandOutput = DescribeCoipPoolsResult & __MetadataBearer; +/** + *

Describes the specified customer-owned address pools or all of your customer-owned address pools.

+ */ export class DescribeCoipPoolsCommand extends $Command< DescribeCoipPoolsCommandInput, DescribeCoipPoolsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCoipPoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeConversionTasksCommand.ts b/clients/client-ec2/commands/DescribeConversionTasksCommand.ts index 2ebed02611084..6d7c00316edeb 100644 --- a/clients/client-ec2/commands/DescribeConversionTasksCommand.ts +++ b/clients/client-ec2/commands/DescribeConversionTasksCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeConversionTasksCommandInput = DescribeConversionTasksRequest; export type DescribeConversionTasksCommandOutput = DescribeConversionTasksResult & __MetadataBearer; +/** + *

Describes the specified conversion tasks or all your conversion tasks. For more information, see the + * VM Import/Export User Guide.

+ *

For information about the import manifest referenced by this API action, see VM Import Manifest.

+ */ export class DescribeConversionTasksCommand extends $Command< DescribeConversionTasksCommandInput, DescribeConversionTasksCommandOutput, @@ -34,6 +39,9 @@ export class DescribeConversionTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeCustomerGatewaysCommand.ts b/clients/client-ec2/commands/DescribeCustomerGatewaysCommand.ts index 0e21863e6aafa..9c082552541e4 100644 --- a/clients/client-ec2/commands/DescribeCustomerGatewaysCommand.ts +++ b/clients/client-ec2/commands/DescribeCustomerGatewaysCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeCustomerGatewaysCommandInput = DescribeCustomerGatewaysRequest; export type DescribeCustomerGatewaysCommandOutput = DescribeCustomerGatewaysResult & __MetadataBearer; +/** + *

Describes one or more of your VPN customer gateways.

+ *

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

+ */ export class DescribeCustomerGatewaysCommand extends $Command< DescribeCustomerGatewaysCommandInput, DescribeCustomerGatewaysCommandOutput, @@ -34,6 +38,9 @@ export class DescribeCustomerGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeDhcpOptionsCommand.ts b/clients/client-ec2/commands/DescribeDhcpOptionsCommand.ts index 473d0a914069e..012d95a31a6b1 100644 --- a/clients/client-ec2/commands/DescribeDhcpOptionsCommand.ts +++ b/clients/client-ec2/commands/DescribeDhcpOptionsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDhcpOptionsCommandInput = DescribeDhcpOptionsRequest; export type DescribeDhcpOptionsCommandOutput = DescribeDhcpOptionsResult & __MetadataBearer; +/** + *

Describes one or more of your DHCP options sets.

+ *

For more information, see DHCP Options Sets in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class DescribeDhcpOptionsCommand extends $Command< DescribeDhcpOptionsCommandInput, DescribeDhcpOptionsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDhcpOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeEgressOnlyInternetGatewaysCommand.ts b/clients/client-ec2/commands/DescribeEgressOnlyInternetGatewaysCommand.ts index 204a06590757d..365366bd8a9b2 100644 --- a/clients/client-ec2/commands/DescribeEgressOnlyInternetGatewaysCommand.ts +++ b/clients/client-ec2/commands/DescribeEgressOnlyInternetGatewaysCommand.ts @@ -24,6 +24,9 @@ export type DescribeEgressOnlyInternetGatewaysCommandInput = DescribeEgressOnlyI export type DescribeEgressOnlyInternetGatewaysCommandOutput = DescribeEgressOnlyInternetGatewaysResult & __MetadataBearer; +/** + *

Describes one or more of your egress-only internet gateways.

+ */ export class DescribeEgressOnlyInternetGatewaysCommand extends $Command< DescribeEgressOnlyInternetGatewaysCommandInput, DescribeEgressOnlyInternetGatewaysCommandOutput, @@ -38,6 +41,9 @@ export class DescribeEgressOnlyInternetGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeElasticGpusCommand.ts b/clients/client-ec2/commands/DescribeElasticGpusCommand.ts index 8981370db96ed..7e81da0c48502 100644 --- a/clients/client-ec2/commands/DescribeElasticGpusCommand.ts +++ b/clients/client-ec2/commands/DescribeElasticGpusCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeElasticGpusCommandInput = DescribeElasticGpusRequest; export type DescribeElasticGpusCommandOutput = DescribeElasticGpusResult & __MetadataBearer; +/** + *

Describes the Elastic Graphics accelerator associated with your instances. For more information + * about Elastic Graphics, see Amazon Elastic Graphics.

+ */ export class DescribeElasticGpusCommand extends $Command< DescribeElasticGpusCommandInput, DescribeElasticGpusCommandOutput, @@ -34,6 +38,9 @@ export class DescribeElasticGpusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeExportImageTasksCommand.ts b/clients/client-ec2/commands/DescribeExportImageTasksCommand.ts index d404a8daefa05..c119aa97bf76b 100644 --- a/clients/client-ec2/commands/DescribeExportImageTasksCommand.ts +++ b/clients/client-ec2/commands/DescribeExportImageTasksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeExportImageTasksCommandInput = DescribeExportImageTasksRequest; export type DescribeExportImageTasksCommandOutput = DescribeExportImageTasksResult & __MetadataBearer; +/** + *

Describes the specified export image tasks or all of your export image tasks.

+ */ export class DescribeExportImageTasksCommand extends $Command< DescribeExportImageTasksCommandInput, DescribeExportImageTasksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeExportImageTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeExportTasksCommand.ts b/clients/client-ec2/commands/DescribeExportTasksCommand.ts index 188ccde8cf1e1..2ed6bffbc48f8 100644 --- a/clients/client-ec2/commands/DescribeExportTasksCommand.ts +++ b/clients/client-ec2/commands/DescribeExportTasksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeExportTasksCommandInput = DescribeExportTasksRequest; export type DescribeExportTasksCommandOutput = DescribeExportTasksResult & __MetadataBearer; +/** + *

Describes the specified export instance tasks or all of your export instance tasks.

+ */ export class DescribeExportTasksCommand extends $Command< DescribeExportTasksCommandInput, DescribeExportTasksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeExportTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeFastSnapshotRestoresCommand.ts b/clients/client-ec2/commands/DescribeFastSnapshotRestoresCommand.ts index 4a7810e3193f5..41aee132f7ae4 100644 --- a/clients/client-ec2/commands/DescribeFastSnapshotRestoresCommand.ts +++ b/clients/client-ec2/commands/DescribeFastSnapshotRestoresCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFastSnapshotRestoresCommandInput = DescribeFastSnapshotRestoresRequest; export type DescribeFastSnapshotRestoresCommandOutput = DescribeFastSnapshotRestoresResult & __MetadataBearer; +/** + *

Describes the state of fast snapshot restores for your snapshots.

+ */ export class DescribeFastSnapshotRestoresCommand extends $Command< DescribeFastSnapshotRestoresCommandInput, DescribeFastSnapshotRestoresCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFastSnapshotRestoresCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeFleetHistoryCommand.ts b/clients/client-ec2/commands/DescribeFleetHistoryCommand.ts index 003ae9057db2b..0ba17e7e654e9 100644 --- a/clients/client-ec2/commands/DescribeFleetHistoryCommand.ts +++ b/clients/client-ec2/commands/DescribeFleetHistoryCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeFleetHistoryCommandInput = DescribeFleetHistoryRequest; export type DescribeFleetHistoryCommandOutput = DescribeFleetHistoryResult & __MetadataBearer; +/** + *

Describes the events for the specified EC2 Fleet during the specified time.

+ *

EC2 Fleet events are delayed by up to 30 seconds before they can be described. This ensures + * that you can query by the last evaluated time and not miss a recorded event. EC2 Fleet events + * are available for 48 hours.

+ */ export class DescribeFleetHistoryCommand extends $Command< DescribeFleetHistoryCommandInput, DescribeFleetHistoryCommandOutput, @@ -34,6 +40,9 @@ export class DescribeFleetHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeFleetInstancesCommand.ts b/clients/client-ec2/commands/DescribeFleetInstancesCommand.ts index 34945857d6b75..20fb9f151a838 100644 --- a/clients/client-ec2/commands/DescribeFleetInstancesCommand.ts +++ b/clients/client-ec2/commands/DescribeFleetInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFleetInstancesCommandInput = DescribeFleetInstancesRequest; export type DescribeFleetInstancesCommandOutput = DescribeFleetInstancesResult & __MetadataBearer; +/** + *

Describes the running instances for the specified EC2 Fleet.

+ */ export class DescribeFleetInstancesCommand extends $Command< DescribeFleetInstancesCommandInput, DescribeFleetInstancesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFleetInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeFleetsCommand.ts b/clients/client-ec2/commands/DescribeFleetsCommand.ts index 0678f38df1bcb..4a5aebb868acb 100644 --- a/clients/client-ec2/commands/DescribeFleetsCommand.ts +++ b/clients/client-ec2/commands/DescribeFleetsCommand.ts @@ -17,6 +17,9 @@ import { export type DescribeFleetsCommandInput = DescribeFleetsRequest; export type DescribeFleetsCommandOutput = DescribeFleetsResult & __MetadataBearer; +/** + *

Describes the specified EC2 Fleets or all of your EC2 Fleets.

+ */ export class DescribeFleetsCommand extends $Command< DescribeFleetsCommandInput, DescribeFleetsCommandOutput, @@ -31,6 +34,9 @@ export class DescribeFleetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeFlowLogsCommand.ts b/clients/client-ec2/commands/DescribeFlowLogsCommand.ts index 11e943224272d..78cc2e172f5db 100644 --- a/clients/client-ec2/commands/DescribeFlowLogsCommand.ts +++ b/clients/client-ec2/commands/DescribeFlowLogsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeFlowLogsCommandInput = DescribeFlowLogsRequest; export type DescribeFlowLogsCommandOutput = DescribeFlowLogsResult & __MetadataBearer; +/** + *

Describes one or more flow logs. To view the information in your flow logs (the log + * streams for the network interfaces), you must use the CloudWatch Logs console or the CloudWatch Logs + * API.

+ */ export class DescribeFlowLogsCommand extends $Command< DescribeFlowLogsCommandInput, DescribeFlowLogsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeFlowLogsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeFpgaImageAttributeCommand.ts b/clients/client-ec2/commands/DescribeFpgaImageAttributeCommand.ts index b50e11fe75e1e..d6e3d620bf166 100644 --- a/clients/client-ec2/commands/DescribeFpgaImageAttributeCommand.ts +++ b/clients/client-ec2/commands/DescribeFpgaImageAttributeCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFpgaImageAttributeCommandInput = DescribeFpgaImageAttributeRequest; export type DescribeFpgaImageAttributeCommandOutput = DescribeFpgaImageAttributeResult & __MetadataBearer; +/** + *

Describes the specified attribute of the specified Amazon FPGA Image (AFI).

+ */ export class DescribeFpgaImageAttributeCommand extends $Command< DescribeFpgaImageAttributeCommandInput, DescribeFpgaImageAttributeCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFpgaImageAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeFpgaImagesCommand.ts b/clients/client-ec2/commands/DescribeFpgaImagesCommand.ts index 782207322a9c5..47107b4049143 100644 --- a/clients/client-ec2/commands/DescribeFpgaImagesCommand.ts +++ b/clients/client-ec2/commands/DescribeFpgaImagesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeFpgaImagesCommandInput = DescribeFpgaImagesRequest; export type DescribeFpgaImagesCommandOutput = DescribeFpgaImagesResult & __MetadataBearer; +/** + *

Describes the Amazon FPGA Images (AFIs) available to you. These include public AFIs, + * private AFIs that you own, and AFIs owned by other AWS accounts for which you have load + * permissions.

+ */ export class DescribeFpgaImagesCommand extends $Command< DescribeFpgaImagesCommandInput, DescribeFpgaImagesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeFpgaImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeHostReservationOfferingsCommand.ts b/clients/client-ec2/commands/DescribeHostReservationOfferingsCommand.ts index 611ec62bfdcfd..2f159d1739422 100644 --- a/clients/client-ec2/commands/DescribeHostReservationOfferingsCommand.ts +++ b/clients/client-ec2/commands/DescribeHostReservationOfferingsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeHostReservationOfferingsCommandInput = DescribeHostReservationOfferingsRequest; export type DescribeHostReservationOfferingsCommandOutput = DescribeHostReservationOfferingsResult & __MetadataBearer; +/** + *

Describes the Dedicated Host reservations that are available to purchase.

+ *

The results describe all of the Dedicated Host reservation offerings, including + * offerings that might not match the instance family and Region of your Dedicated Hosts. + * When purchasing an offering, ensure that the instance family and Region of the offering + * matches that of the Dedicated Hosts with which it is to be associated. For more + * information about supported instance types, see Dedicated Hosts + * Overview in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeHostReservationOfferingsCommand extends $Command< DescribeHostReservationOfferingsCommandInput, DescribeHostReservationOfferingsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeHostReservationOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeHostReservationsCommand.ts b/clients/client-ec2/commands/DescribeHostReservationsCommand.ts index d8eee500595c0..17d8088fec155 100644 --- a/clients/client-ec2/commands/DescribeHostReservationsCommand.ts +++ b/clients/client-ec2/commands/DescribeHostReservationsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeHostReservationsCommandInput = DescribeHostReservationsRequest; export type DescribeHostReservationsCommandOutput = DescribeHostReservationsResult & __MetadataBearer; +/** + *

Describes reservations that are associated with Dedicated Hosts in your + * account.

+ */ export class DescribeHostReservationsCommand extends $Command< DescribeHostReservationsCommandInput, DescribeHostReservationsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeHostReservationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeHostsCommand.ts b/clients/client-ec2/commands/DescribeHostsCommand.ts index 90ce2198d6db1..fbaf22c546972 100644 --- a/clients/client-ec2/commands/DescribeHostsCommand.ts +++ b/clients/client-ec2/commands/DescribeHostsCommand.ts @@ -17,6 +17,12 @@ import { export type DescribeHostsCommandInput = DescribeHostsRequest; export type DescribeHostsCommandOutput = DescribeHostsResult & __MetadataBearer; +/** + *

Describes the specified Dedicated Hosts or all your Dedicated Hosts.

+ *

The results describe only the Dedicated Hosts in the Region you're currently using. + * All listed instances consume capacity on your Dedicated Host. Dedicated Hosts that have + * recently been released are listed with the state released.

+ */ export class DescribeHostsCommand extends $Command< DescribeHostsCommandInput, DescribeHostsCommandOutput, @@ -31,6 +37,9 @@ export class DescribeHostsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeIamInstanceProfileAssociationsCommand.ts b/clients/client-ec2/commands/DescribeIamInstanceProfileAssociationsCommand.ts index c4611cc6ec78f..ce5b363bde8c7 100644 --- a/clients/client-ec2/commands/DescribeIamInstanceProfileAssociationsCommand.ts +++ b/clients/client-ec2/commands/DescribeIamInstanceProfileAssociationsCommand.ts @@ -24,6 +24,9 @@ export type DescribeIamInstanceProfileAssociationsCommandInput = DescribeIamInst export type DescribeIamInstanceProfileAssociationsCommandOutput = DescribeIamInstanceProfileAssociationsResult & __MetadataBearer; +/** + *

Describes your IAM instance profile associations.

+ */ export class DescribeIamInstanceProfileAssociationsCommand extends $Command< DescribeIamInstanceProfileAssociationsCommandInput, DescribeIamInstanceProfileAssociationsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeIamInstanceProfileAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeIdFormatCommand.ts b/clients/client-ec2/commands/DescribeIdFormatCommand.ts index 5143ebc4fbc7f..52354c40341a0 100644 --- a/clients/client-ec2/commands/DescribeIdFormatCommand.ts +++ b/clients/client-ec2/commands/DescribeIdFormatCommand.ts @@ -20,6 +20,28 @@ import { export type DescribeIdFormatCommandInput = DescribeIdFormatRequest; export type DescribeIdFormatCommandOutput = DescribeIdFormatResult & __MetadataBearer; +/** + *

Describes the ID format settings for your resources on a per-Region basis, for example, to view which resource types are enabled for longer IDs. This request only returns information about resource types whose ID formats can be modified; it does not return information about other resource types.

+ *

The following resource types support longer IDs: bundle | + * conversion-task | customer-gateway | dhcp-options | + * elastic-ip-allocation | elastic-ip-association | + * export-task | flow-log | image | + * import-task | instance | internet-gateway | + * network-acl | network-acl-association | + * network-interface | network-interface-attachment | + * prefix-list | reservation | route-table | + * route-table-association | security-group | + * snapshot | subnet | + * subnet-cidr-block-association | volume | vpc + * | vpc-cidr-block-association | vpc-endpoint | + * vpc-peering-connection | vpn-connection | vpn-gateway.

+ *

These settings apply to the IAM user who makes the request; they do not apply to the entire + * AWS account. By default, an IAM user defaults to the same settings as the root user, unless + * they explicitly override the settings by running the ModifyIdFormat command. Resources + * created with longer IDs are visible to all IAM users, regardless of these settings and + * provided that they have permission to use the relevant Describe command for the + * resource type.

+ */ export class DescribeIdFormatCommand extends $Command< DescribeIdFormatCommandInput, DescribeIdFormatCommandOutput, @@ -34,6 +56,9 @@ export class DescribeIdFormatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeIdentityIdFormatCommand.ts b/clients/client-ec2/commands/DescribeIdentityIdFormatCommand.ts index 4e9e837439da1..2d4d48d29255b 100644 --- a/clients/client-ec2/commands/DescribeIdentityIdFormatCommand.ts +++ b/clients/client-ec2/commands/DescribeIdentityIdFormatCommand.ts @@ -20,6 +20,27 @@ import { export type DescribeIdentityIdFormatCommandInput = DescribeIdentityIdFormatRequest; export type DescribeIdentityIdFormatCommandOutput = DescribeIdentityIdFormatResult & __MetadataBearer; +/** + *

Describes the ID format settings for resources for the specified IAM user, IAM role, or root + * user. For example, you can view the resource types that are enabled for longer IDs. This request only + * returns information about resource types whose ID formats can be modified; it does not return + * information about other resource types. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

+ *

The following resource types support longer IDs: bundle | + * conversion-task | customer-gateway | dhcp-options | + * elastic-ip-allocation | elastic-ip-association | + * export-task | flow-log | image | + * import-task | instance | internet-gateway | + * network-acl | network-acl-association | + * network-interface | network-interface-attachment | + * prefix-list | reservation | route-table | + * route-table-association | security-group | + * snapshot | subnet | + * subnet-cidr-block-association | volume | vpc + * | vpc-cidr-block-association | vpc-endpoint | + * vpc-peering-connection | vpn-connection | vpn-gateway.

+ *

These settings apply to the principal specified in the request. They do not apply to the + * principal that makes the request.

+ */ export class DescribeIdentityIdFormatCommand extends $Command< DescribeIdentityIdFormatCommandInput, DescribeIdentityIdFormatCommandOutput, @@ -34,6 +55,9 @@ export class DescribeIdentityIdFormatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeImageAttributeCommand.ts b/clients/client-ec2/commands/DescribeImageAttributeCommand.ts index fb84b53357d94..a404971f0fb36 100644 --- a/clients/client-ec2/commands/DescribeImageAttributeCommand.ts +++ b/clients/client-ec2/commands/DescribeImageAttributeCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImageAttributeCommandInput = DescribeImageAttributeRequest; export type DescribeImageAttributeCommandOutput = ImageAttribute & __MetadataBearer; +/** + *

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

+ */ export class DescribeImageAttributeCommand extends $Command< DescribeImageAttributeCommandInput, DescribeImageAttributeCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImageAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeImagesCommand.ts b/clients/client-ec2/commands/DescribeImagesCommand.ts index 27bd956a5cefd..e8e3d6d0ca77b 100644 --- a/clients/client-ec2/commands/DescribeImagesCommand.ts +++ b/clients/client-ec2/commands/DescribeImagesCommand.ts @@ -17,6 +17,13 @@ import { export type DescribeImagesCommandInput = DescribeImagesRequest; export type DescribeImagesCommandOutput = DescribeImagesResult & __MetadataBearer; +/** + *

Describes the specified images (AMIs, AKIs, and ARIs) available to you or all of the images available to you.

+ *

The images available to you include public images, private images that you own, and private images owned by other AWS accounts for which you have explicit launch permissions.

+ *

Recently deregistered images appear in the returned results for a short interval and then return empty results. + * After all instances that reference a deregistered AMI are terminated, specifying the ID of the image results + * in an error indicating that the AMI ID cannot be found.

+ */ export class DescribeImagesCommand extends $Command< DescribeImagesCommandInput, DescribeImagesCommandOutput, @@ -31,6 +38,9 @@ export class DescribeImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeImportImageTasksCommand.ts b/clients/client-ec2/commands/DescribeImportImageTasksCommand.ts index 864c40364329f..9b29d01517207 100644 --- a/clients/client-ec2/commands/DescribeImportImageTasksCommand.ts +++ b/clients/client-ec2/commands/DescribeImportImageTasksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImportImageTasksCommandInput = DescribeImportImageTasksRequest; export type DescribeImportImageTasksCommandOutput = DescribeImportImageTasksResult & __MetadataBearer; +/** + *

Displays details about an import virtual machine or import snapshot tasks that are already created.

+ */ export class DescribeImportImageTasksCommand extends $Command< DescribeImportImageTasksCommandInput, DescribeImportImageTasksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImportImageTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeImportSnapshotTasksCommand.ts b/clients/client-ec2/commands/DescribeImportSnapshotTasksCommand.ts index fd00835f650fa..d941c0dd2991b 100644 --- a/clients/client-ec2/commands/DescribeImportSnapshotTasksCommand.ts +++ b/clients/client-ec2/commands/DescribeImportSnapshotTasksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImportSnapshotTasksCommandInput = DescribeImportSnapshotTasksRequest; export type DescribeImportSnapshotTasksCommandOutput = DescribeImportSnapshotTasksResult & __MetadataBearer; +/** + *

Describes your import snapshot tasks.

+ */ export class DescribeImportSnapshotTasksCommand extends $Command< DescribeImportSnapshotTasksCommandInput, DescribeImportSnapshotTasksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImportSnapshotTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeInstanceAttributeCommand.ts b/clients/client-ec2/commands/DescribeInstanceAttributeCommand.ts index e5eccacbc0dda..9b4155127bdd9 100644 --- a/clients/client-ec2/commands/DescribeInstanceAttributeCommand.ts +++ b/clients/client-ec2/commands/DescribeInstanceAttributeCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeInstanceAttributeCommandInput = DescribeInstanceAttributeRequest; export type DescribeInstanceAttributeCommandOutput = InstanceAttribute & __MetadataBearer; +/** + *

Describes the specified attribute of the specified instance. You can specify only one + * attribute at a time. Valid attribute values are: instanceType | + * kernel | ramdisk | userData | + * disableApiTermination | instanceInitiatedShutdownBehavior + * | rootDeviceName | blockDeviceMapping | + * productCodes | sourceDestCheck | groupSet | + * ebsOptimized | sriovNetSupport + *

+ */ export class DescribeInstanceAttributeCommand extends $Command< DescribeInstanceAttributeCommandInput, DescribeInstanceAttributeCommandOutput, @@ -34,6 +44,9 @@ export class DescribeInstanceAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeInstanceCreditSpecificationsCommand.ts b/clients/client-ec2/commands/DescribeInstanceCreditSpecificationsCommand.ts index 028ccfe024210..274cc03a07995 100644 --- a/clients/client-ec2/commands/DescribeInstanceCreditSpecificationsCommand.ts +++ b/clients/client-ec2/commands/DescribeInstanceCreditSpecificationsCommand.ts @@ -24,6 +24,29 @@ export type DescribeInstanceCreditSpecificationsCommandInput = DescribeInstanceC export type DescribeInstanceCreditSpecificationsCommandOutput = DescribeInstanceCreditSpecificationsResult & __MetadataBearer; +/** + *

Describes the credit option for CPU usage of the specified burstable performance + * instances. The credit options are standard and + * unlimited.

+ *

If you do not specify an instance ID, Amazon EC2 returns burstable performance + * instances with the unlimited credit option, as well as instances that were + * previously configured as T2, T3, and T3a with the unlimited credit option. + * For example, if you resize a T2 instance, while it is configured as + * unlimited, to an M4 instance, Amazon EC2 returns the M4 + * instance.

+ *

If you specify one or more instance IDs, Amazon EC2 returns the credit option + * (standard or unlimited) of those instances. If you specify + * an instance ID that is not valid, such as an instance that is not a burstable + * performance instance, an error is returned.

+ *

Recently terminated instances might appear in the returned results. This interval is + * usually less than one hour.

+ *

If an Availability Zone is experiencing a service disruption and you specify instance + * IDs in the affected zone, or do not specify any instance IDs at all, the call fails. If + * you specify only instance IDs in an unaffected zone, the call works normally.

+ *

For more information, see Burstable + * performance instances in the Amazon Elastic Compute Cloud User + * Guide.

+ */ export class DescribeInstanceCreditSpecificationsCommand extends $Command< DescribeInstanceCreditSpecificationsCommandInput, DescribeInstanceCreditSpecificationsCommandOutput, @@ -38,6 +61,9 @@ export class DescribeInstanceCreditSpecificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeInstanceEventNotificationAttributesCommand.ts b/clients/client-ec2/commands/DescribeInstanceEventNotificationAttributesCommand.ts index 21dd7c06ba375..9fc39488b0e83 100644 --- a/clients/client-ec2/commands/DescribeInstanceEventNotificationAttributesCommand.ts +++ b/clients/client-ec2/commands/DescribeInstanceEventNotificationAttributesCommand.ts @@ -24,6 +24,10 @@ export type DescribeInstanceEventNotificationAttributesCommandInput = DescribeIn export type DescribeInstanceEventNotificationAttributesCommandOutput = DescribeInstanceEventNotificationAttributesResult & __MetadataBearer; +/** + *

Describes the tag keys that are registered to appear in scheduled event notifications for + * resources in the current Region.

+ */ export class DescribeInstanceEventNotificationAttributesCommand extends $Command< DescribeInstanceEventNotificationAttributesCommandInput, DescribeInstanceEventNotificationAttributesCommandOutput, @@ -38,6 +42,9 @@ export class DescribeInstanceEventNotificationAttributesCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeInstanceStatusCommand.ts b/clients/client-ec2/commands/DescribeInstanceStatusCommand.ts index e0f0f549f650d..e000dc9cdac64 100644 --- a/clients/client-ec2/commands/DescribeInstanceStatusCommand.ts +++ b/clients/client-ec2/commands/DescribeInstanceStatusCommand.ts @@ -20,6 +20,38 @@ import { export type DescribeInstanceStatusCommandInput = DescribeInstanceStatusRequest; export type DescribeInstanceStatusCommandOutput = DescribeInstanceStatusResult & __MetadataBearer; +/** + *

Describes the status of the specified instances or all of your instances. By default, + * only running instances are described, unless you specifically indicate to return the + * status of all instances.

+ *

Instance status includes the following components:

+ *
    + *
  • + *

    + * Status checks - Amazon EC2 performs status + * checks on running EC2 instances to identify hardware and software issues. For + * more information, see Status checks for your instances and Troubleshooting + * instances with failed status checks in the Amazon Elastic + * Compute Cloud User Guide.

    + *
  • + *
  • + *

    + * Scheduled events - Amazon EC2 can schedule + * events (such as reboot, stop, or terminate) for your instances related to + * hardware issues, software updates, or system maintenance. For more information, + * see Scheduled events for your instances in the Amazon Elastic + * Compute Cloud User Guide.

    + *
  • + *
  • + *

    + * Instance state - You can manage your instances + * from the moment you launch them through their termination. For more information, + * see Instance + * lifecycle in the Amazon Elastic Compute Cloud User + * Guide.

    + *
  • + *
+ */ export class DescribeInstanceStatusCommand extends $Command< DescribeInstanceStatusCommandInput, DescribeInstanceStatusCommandOutput, @@ -34,6 +66,9 @@ export class DescribeInstanceStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeInstanceTypeOfferingsCommand.ts b/clients/client-ec2/commands/DescribeInstanceTypeOfferingsCommand.ts index 733e10358e391..c3ad54ce04d5c 100644 --- a/clients/client-ec2/commands/DescribeInstanceTypeOfferingsCommand.ts +++ b/clients/client-ec2/commands/DescribeInstanceTypeOfferingsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeInstanceTypeOfferingsCommandInput = DescribeInstanceTypeOfferingsRequest; export type DescribeInstanceTypeOfferingsCommandOutput = DescribeInstanceTypeOfferingsResult & __MetadataBearer; +/** + *

Returns a list of all instance types offered. The results can be filtered by location (Region or Availability + * Zone). If no location is specified, the instance types offered in the current Region are returned.

+ */ export class DescribeInstanceTypeOfferingsCommand extends $Command< DescribeInstanceTypeOfferingsCommandInput, DescribeInstanceTypeOfferingsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeInstanceTypeOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeInstanceTypesCommand.ts b/clients/client-ec2/commands/DescribeInstanceTypesCommand.ts index 79e1f1c206420..f2e2d32c76350 100644 --- a/clients/client-ec2/commands/DescribeInstanceTypesCommand.ts +++ b/clients/client-ec2/commands/DescribeInstanceTypesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeInstanceTypesCommandInput = DescribeInstanceTypesRequest; export type DescribeInstanceTypesCommandOutput = DescribeInstanceTypesResult & __MetadataBearer; +/** + *

Describes the details of the instance types that are offered in a location. The results can be filtered by the + * attributes of the instance types.

+ */ export class DescribeInstanceTypesCommand extends $Command< DescribeInstanceTypesCommandInput, DescribeInstanceTypesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeInstanceTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeInstancesCommand.ts b/clients/client-ec2/commands/DescribeInstancesCommand.ts index 49ba24ee85941..ac3df34a131d8 100644 --- a/clients/client-ec2/commands/DescribeInstancesCommand.ts +++ b/clients/client-ec2/commands/DescribeInstancesCommand.ts @@ -20,6 +20,23 @@ import { export type DescribeInstancesCommandInput = DescribeInstancesRequest; export type DescribeInstancesCommandOutput = DescribeInstancesResult & __MetadataBearer; +/** + *

Describes the specified instances or all instances.

+ *

If you specify instance IDs, the output includes information for only the specified instances. + * If you specify filters, the output includes information for only those instances that meet the filter criteria. + * If you do not specify instance IDs or filters, the output includes information for all instances, + * which can affect performance. We recommend that you use pagination to ensure that the operation + * returns quickly and successfully.

+ *

If you specify an instance ID that is not valid, an error is returned. If you + * specify an instance that you do not own, it is not included in the output.

+ *

Recently terminated instances might appear in the returned results. This interval is + * usually less than one hour.

+ *

If you describe instances in the rare case where an Availability Zone is experiencing + * a service disruption and you specify instance IDs that are in the affected zone, or do + * not specify any instance IDs at all, the call fails. If you describe instances and + * specify only instance IDs that are in an unaffected zone, the call works + * normally.

+ */ export class DescribeInstancesCommand extends $Command< DescribeInstancesCommandInput, DescribeInstancesCommandOutput, @@ -34,6 +51,9 @@ export class DescribeInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeInternetGatewaysCommand.ts b/clients/client-ec2/commands/DescribeInternetGatewaysCommand.ts index f6f54f0227091..a3e377dee783e 100644 --- a/clients/client-ec2/commands/DescribeInternetGatewaysCommand.ts +++ b/clients/client-ec2/commands/DescribeInternetGatewaysCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInternetGatewaysCommandInput = DescribeInternetGatewaysRequest; export type DescribeInternetGatewaysCommandOutput = DescribeInternetGatewaysResult & __MetadataBearer; +/** + *

Describes one or more of your internet gateways.

+ */ export class DescribeInternetGatewaysCommand extends $Command< DescribeInternetGatewaysCommandInput, DescribeInternetGatewaysCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInternetGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeIpv6PoolsCommand.ts b/clients/client-ec2/commands/DescribeIpv6PoolsCommand.ts index f7c6408b65ea6..b61a4c565c965 100644 --- a/clients/client-ec2/commands/DescribeIpv6PoolsCommand.ts +++ b/clients/client-ec2/commands/DescribeIpv6PoolsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeIpv6PoolsCommandInput = DescribeIpv6PoolsRequest; export type DescribeIpv6PoolsCommandOutput = DescribeIpv6PoolsResult & __MetadataBearer; +/** + *

Describes your IPv6 address pools.

+ */ export class DescribeIpv6PoolsCommand extends $Command< DescribeIpv6PoolsCommandInput, DescribeIpv6PoolsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeIpv6PoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeKeyPairsCommand.ts b/clients/client-ec2/commands/DescribeKeyPairsCommand.ts index 26624c44d5a16..869b495d2ee4e 100644 --- a/clients/client-ec2/commands/DescribeKeyPairsCommand.ts +++ b/clients/client-ec2/commands/DescribeKeyPairsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeKeyPairsCommandInput = DescribeKeyPairsRequest; export type DescribeKeyPairsCommandOutput = DescribeKeyPairsResult & __MetadataBearer; +/** + *

Describes the specified key pairs or all of your key pairs.

+ *

For more information about key pairs, see Key Pairs + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeKeyPairsCommand extends $Command< DescribeKeyPairsCommandInput, DescribeKeyPairsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeKeyPairsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeLaunchTemplateVersionsCommand.ts b/clients/client-ec2/commands/DescribeLaunchTemplateVersionsCommand.ts index 1c643c365eed3..1d8d91bf386bf 100644 --- a/clients/client-ec2/commands/DescribeLaunchTemplateVersionsCommand.ts +++ b/clients/client-ec2/commands/DescribeLaunchTemplateVersionsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeLaunchTemplateVersionsCommandInput = DescribeLaunchTemplateVersionsRequest; export type DescribeLaunchTemplateVersionsCommandOutput = DescribeLaunchTemplateVersionsResult & __MetadataBearer; +/** + *

Describes one or more versions of a specified launch template. You can describe all + * versions, individual versions, or a range of versions. You can also describe all the + * latest versions or all the default versions of all the launch templates in your + * account.

+ */ export class DescribeLaunchTemplateVersionsCommand extends $Command< DescribeLaunchTemplateVersionsCommandInput, DescribeLaunchTemplateVersionsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeLaunchTemplateVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeLaunchTemplatesCommand.ts b/clients/client-ec2/commands/DescribeLaunchTemplatesCommand.ts index 19627688d379a..b810e8130bd34 100644 --- a/clients/client-ec2/commands/DescribeLaunchTemplatesCommand.ts +++ b/clients/client-ec2/commands/DescribeLaunchTemplatesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLaunchTemplatesCommandInput = DescribeLaunchTemplatesRequest; export type DescribeLaunchTemplatesCommandOutput = DescribeLaunchTemplatesResult & __MetadataBearer; +/** + *

Describes one or more launch templates.

+ */ export class DescribeLaunchTemplatesCommand extends $Command< DescribeLaunchTemplatesCommandInput, DescribeLaunchTemplatesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLaunchTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommand.ts b/clients/client-ec2/commands/DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommand.ts index 8d5d0f80c5202..63134eeb54c58 100644 --- a/clients/client-ec2/commands/DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommand.ts +++ b/clients/client-ec2/commands/DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommand.ts @@ -24,6 +24,9 @@ export type DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsComma export type DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommandOutput = DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsResult & __MetadataBearer; +/** + *

Describes the associations between virtual interface groups and local gateway route tables.

+ */ export class DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommand extends $Command< DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommandInput, DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsComm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeLocalGatewayRouteTableVpcAssociationsCommand.ts b/clients/client-ec2/commands/DescribeLocalGatewayRouteTableVpcAssociationsCommand.ts index e626f3d0905f7..5b991d94c00b7 100644 --- a/clients/client-ec2/commands/DescribeLocalGatewayRouteTableVpcAssociationsCommand.ts +++ b/clients/client-ec2/commands/DescribeLocalGatewayRouteTableVpcAssociationsCommand.ts @@ -24,6 +24,9 @@ export type DescribeLocalGatewayRouteTableVpcAssociationsCommandInput = Describe export type DescribeLocalGatewayRouteTableVpcAssociationsCommandOutput = DescribeLocalGatewayRouteTableVpcAssociationsResult & __MetadataBearer; +/** + *

Describes the specified associations between VPCs and local gateway route tables.

+ */ export class DescribeLocalGatewayRouteTableVpcAssociationsCommand extends $Command< DescribeLocalGatewayRouteTableVpcAssociationsCommandInput, DescribeLocalGatewayRouteTableVpcAssociationsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeLocalGatewayRouteTableVpcAssociationsCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeLocalGatewayRouteTablesCommand.ts b/clients/client-ec2/commands/DescribeLocalGatewayRouteTablesCommand.ts index 92aaa6f4936d7..13a2c82a43aa2 100644 --- a/clients/client-ec2/commands/DescribeLocalGatewayRouteTablesCommand.ts +++ b/clients/client-ec2/commands/DescribeLocalGatewayRouteTablesCommand.ts @@ -21,6 +21,10 @@ import { export type DescribeLocalGatewayRouteTablesCommandInput = DescribeLocalGatewayRouteTablesRequest; export type DescribeLocalGatewayRouteTablesCommandOutput = DescribeLocalGatewayRouteTablesResult & __MetadataBearer; +/** + *

Describes one or more local gateway route tables. By default, all local gateway route tables are described. + * Alternatively, you can filter the results.

+ */ export class DescribeLocalGatewayRouteTablesCommand extends $Command< DescribeLocalGatewayRouteTablesCommandInput, DescribeLocalGatewayRouteTablesCommandOutput, @@ -35,6 +39,9 @@ export class DescribeLocalGatewayRouteTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeLocalGatewayVirtualInterfaceGroupsCommand.ts b/clients/client-ec2/commands/DescribeLocalGatewayVirtualInterfaceGroupsCommand.ts index ceffa1d5e9a62..01b9c4df22db6 100644 --- a/clients/client-ec2/commands/DescribeLocalGatewayVirtualInterfaceGroupsCommand.ts +++ b/clients/client-ec2/commands/DescribeLocalGatewayVirtualInterfaceGroupsCommand.ts @@ -24,6 +24,9 @@ export type DescribeLocalGatewayVirtualInterfaceGroupsCommandInput = DescribeLoc export type DescribeLocalGatewayVirtualInterfaceGroupsCommandOutput = DescribeLocalGatewayVirtualInterfaceGroupsResult & __MetadataBearer; +/** + *

Describes the specified local gateway virtual interface groups.

+ */ export class DescribeLocalGatewayVirtualInterfaceGroupsCommand extends $Command< DescribeLocalGatewayVirtualInterfaceGroupsCommandInput, DescribeLocalGatewayVirtualInterfaceGroupsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeLocalGatewayVirtualInterfaceGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeLocalGatewayVirtualInterfacesCommand.ts b/clients/client-ec2/commands/DescribeLocalGatewayVirtualInterfacesCommand.ts index 41e5131caead1..f75fa535f0cd4 100644 --- a/clients/client-ec2/commands/DescribeLocalGatewayVirtualInterfacesCommand.ts +++ b/clients/client-ec2/commands/DescribeLocalGatewayVirtualInterfacesCommand.ts @@ -24,6 +24,9 @@ export type DescribeLocalGatewayVirtualInterfacesCommandInput = DescribeLocalGat export type DescribeLocalGatewayVirtualInterfacesCommandOutput = DescribeLocalGatewayVirtualInterfacesResult & __MetadataBearer; +/** + *

Describes the specified local gateway virtual interfaces.

+ */ export class DescribeLocalGatewayVirtualInterfacesCommand extends $Command< DescribeLocalGatewayVirtualInterfacesCommandInput, DescribeLocalGatewayVirtualInterfacesCommandOutput, @@ -38,6 +41,9 @@ export class DescribeLocalGatewayVirtualInterfacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeLocalGatewaysCommand.ts b/clients/client-ec2/commands/DescribeLocalGatewaysCommand.ts index 4e08fb4836d7f..a6518e77d9d99 100644 --- a/clients/client-ec2/commands/DescribeLocalGatewaysCommand.ts +++ b/clients/client-ec2/commands/DescribeLocalGatewaysCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeLocalGatewaysCommandInput = DescribeLocalGatewaysRequest; export type DescribeLocalGatewaysCommandOutput = DescribeLocalGatewaysResult & __MetadataBearer; +/** + *

Describes one or more local gateways. By default, all local gateways are described. + * Alternatively, you can filter the results.

+ */ export class DescribeLocalGatewaysCommand extends $Command< DescribeLocalGatewaysCommandInput, DescribeLocalGatewaysCommandOutput, @@ -34,6 +38,9 @@ export class DescribeLocalGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeManagedPrefixListsCommand.ts b/clients/client-ec2/commands/DescribeManagedPrefixListsCommand.ts index 4f615a90bde32..03f3b898d87fb 100644 --- a/clients/client-ec2/commands/DescribeManagedPrefixListsCommand.ts +++ b/clients/client-ec2/commands/DescribeManagedPrefixListsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeManagedPrefixListsCommandInput = DescribeManagedPrefixListsRequest; export type DescribeManagedPrefixListsCommandOutput = DescribeManagedPrefixListsResult & __MetadataBearer; +/** + *

Describes your managed prefix lists and any AWS-managed prefix lists.

+ *

To view the entries for your prefix list, use GetManagedPrefixListEntries.

+ */ export class DescribeManagedPrefixListsCommand extends $Command< DescribeManagedPrefixListsCommandInput, DescribeManagedPrefixListsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeManagedPrefixListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeMovingAddressesCommand.ts b/clients/client-ec2/commands/DescribeMovingAddressesCommand.ts index 707dc968187b6..024bd9e6b9b53 100644 --- a/clients/client-ec2/commands/DescribeMovingAddressesCommand.ts +++ b/clients/client-ec2/commands/DescribeMovingAddressesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMovingAddressesCommandInput = DescribeMovingAddressesRequest; export type DescribeMovingAddressesCommandOutput = DescribeMovingAddressesResult & __MetadataBearer; +/** + *

Describes your Elastic IP addresses that are being moved to the EC2-VPC platform, or that are being restored to the EC2-Classic platform. This request does not return information about any other Elastic IP addresses in your account.

+ */ export class DescribeMovingAddressesCommand extends $Command< DescribeMovingAddressesCommandInput, DescribeMovingAddressesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMovingAddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeNatGatewaysCommand.ts b/clients/client-ec2/commands/DescribeNatGatewaysCommand.ts index 1f99c4a4a57fe..8f41d5bf9fcf7 100644 --- a/clients/client-ec2/commands/DescribeNatGatewaysCommand.ts +++ b/clients/client-ec2/commands/DescribeNatGatewaysCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNatGatewaysCommandInput = DescribeNatGatewaysRequest; export type DescribeNatGatewaysCommandOutput = DescribeNatGatewaysResult & __MetadataBearer; +/** + *

Describes one or more of your NAT gateways.

+ */ export class DescribeNatGatewaysCommand extends $Command< DescribeNatGatewaysCommandInput, DescribeNatGatewaysCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNatGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeNetworkAclsCommand.ts b/clients/client-ec2/commands/DescribeNetworkAclsCommand.ts index 9808c30b6e0c5..c60d68236ae80 100644 --- a/clients/client-ec2/commands/DescribeNetworkAclsCommand.ts +++ b/clients/client-ec2/commands/DescribeNetworkAclsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeNetworkAclsCommandInput = DescribeNetworkAclsRequest; export type DescribeNetworkAclsCommandOutput = DescribeNetworkAclsResult & __MetadataBearer; +/** + *

Describes one or more of your network ACLs.

+ *

For more information, see Network ACLs in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class DescribeNetworkAclsCommand extends $Command< DescribeNetworkAclsCommandInput, DescribeNetworkAclsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeNetworkAclsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeNetworkInterfaceAttributeCommand.ts b/clients/client-ec2/commands/DescribeNetworkInterfaceAttributeCommand.ts index 015fcd6078acf..340ae43aeb88e 100644 --- a/clients/client-ec2/commands/DescribeNetworkInterfaceAttributeCommand.ts +++ b/clients/client-ec2/commands/DescribeNetworkInterfaceAttributeCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNetworkInterfaceAttributeCommandInput = DescribeNetworkInterfaceAttributeRequest; export type DescribeNetworkInterfaceAttributeCommandOutput = DescribeNetworkInterfaceAttributeResult & __MetadataBearer; +/** + *

Describes a network interface attribute. You can specify only one attribute at a time.

+ */ export class DescribeNetworkInterfaceAttributeCommand extends $Command< DescribeNetworkInterfaceAttributeCommandInput, DescribeNetworkInterfaceAttributeCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNetworkInterfaceAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeNetworkInterfacePermissionsCommand.ts b/clients/client-ec2/commands/DescribeNetworkInterfacePermissionsCommand.ts index a189f3c4c9e3e..899ac290ef46d 100644 --- a/clients/client-ec2/commands/DescribeNetworkInterfacePermissionsCommand.ts +++ b/clients/client-ec2/commands/DescribeNetworkInterfacePermissionsCommand.ts @@ -24,6 +24,9 @@ export type DescribeNetworkInterfacePermissionsCommandInput = DescribeNetworkInt export type DescribeNetworkInterfacePermissionsCommandOutput = DescribeNetworkInterfacePermissionsResult & __MetadataBearer; +/** + *

Describes the permissions for your network interfaces.

+ */ export class DescribeNetworkInterfacePermissionsCommand extends $Command< DescribeNetworkInterfacePermissionsCommandInput, DescribeNetworkInterfacePermissionsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeNetworkInterfacePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeNetworkInterfacesCommand.ts b/clients/client-ec2/commands/DescribeNetworkInterfacesCommand.ts index 5cf2bbf940e99..eddf58c27a9b9 100644 --- a/clients/client-ec2/commands/DescribeNetworkInterfacesCommand.ts +++ b/clients/client-ec2/commands/DescribeNetworkInterfacesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNetworkInterfacesCommandInput = DescribeNetworkInterfacesRequest; export type DescribeNetworkInterfacesCommandOutput = DescribeNetworkInterfacesResult & __MetadataBearer; +/** + *

Describes one or more of your network interfaces.

+ */ export class DescribeNetworkInterfacesCommand extends $Command< DescribeNetworkInterfacesCommandInput, DescribeNetworkInterfacesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNetworkInterfacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribePlacementGroupsCommand.ts b/clients/client-ec2/commands/DescribePlacementGroupsCommand.ts index cea9f56ed4b86..e6c7ad891c527 100644 --- a/clients/client-ec2/commands/DescribePlacementGroupsCommand.ts +++ b/clients/client-ec2/commands/DescribePlacementGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribePlacementGroupsCommandInput = DescribePlacementGroupsRequest; export type DescribePlacementGroupsCommandOutput = DescribePlacementGroupsResult & __MetadataBearer; +/** + *

Describes the specified placement groups or all of your placement groups. For more + * information, see Placement groups in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribePlacementGroupsCommand extends $Command< DescribePlacementGroupsCommandInput, DescribePlacementGroupsCommandOutput, @@ -34,6 +39,9 @@ export class DescribePlacementGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribePrefixListsCommand.ts b/clients/client-ec2/commands/DescribePrefixListsCommand.ts index ae57d81c80dc4..09be022ef2648 100644 --- a/clients/client-ec2/commands/DescribePrefixListsCommand.ts +++ b/clients/client-ec2/commands/DescribePrefixListsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribePrefixListsCommandInput = DescribePrefixListsRequest; export type DescribePrefixListsCommandOutput = DescribePrefixListsResult & __MetadataBearer; +/** + *

Describes available AWS services in a prefix list format, which includes the prefix list + * name and prefix list ID of the service and the IP address range for the service.

+ *

We recommend that you use DescribeManagedPrefixLists instead.

+ */ export class DescribePrefixListsCommand extends $Command< DescribePrefixListsCommandInput, DescribePrefixListsCommandOutput, @@ -34,6 +39,9 @@ export class DescribePrefixListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribePrincipalIdFormatCommand.ts b/clients/client-ec2/commands/DescribePrincipalIdFormatCommand.ts index 2aa4f3125fce4..c3b111ed72a69 100644 --- a/clients/client-ec2/commands/DescribePrincipalIdFormatCommand.ts +++ b/clients/client-ec2/commands/DescribePrincipalIdFormatCommand.ts @@ -20,6 +20,26 @@ import { export type DescribePrincipalIdFormatCommandInput = DescribePrincipalIdFormatRequest; export type DescribePrincipalIdFormatCommandOutput = DescribePrincipalIdFormatResult & __MetadataBearer; +/** + *

Describes the ID format settings for the root user and all IAM roles and IAM users + * that have explicitly specified a longer ID (17-character ID) preference.

+ *

By default, all IAM roles and IAM users default to the same ID settings as the root user, unless they + * explicitly override the settings. This request is useful for identifying those IAM users and IAM roles + * that have overridden the default ID settings.

+ *

The following resource types support longer IDs: bundle | + * conversion-task | customer-gateway | dhcp-options | + * elastic-ip-allocation | elastic-ip-association | + * export-task | flow-log | image | + * import-task | instance | internet-gateway | + * network-acl | network-acl-association | + * network-interface | network-interface-attachment | + * prefix-list | reservation | route-table | + * route-table-association | security-group | + * snapshot | subnet | + * subnet-cidr-block-association | volume | vpc + * | vpc-cidr-block-association | vpc-endpoint | + * vpc-peering-connection | vpn-connection | vpn-gateway.

+ */ export class DescribePrincipalIdFormatCommand extends $Command< DescribePrincipalIdFormatCommandInput, DescribePrincipalIdFormatCommandOutput, @@ -34,6 +54,9 @@ export class DescribePrincipalIdFormatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribePublicIpv4PoolsCommand.ts b/clients/client-ec2/commands/DescribePublicIpv4PoolsCommand.ts index 840d05072cb16..c6c60d3dcd466 100644 --- a/clients/client-ec2/commands/DescribePublicIpv4PoolsCommand.ts +++ b/clients/client-ec2/commands/DescribePublicIpv4PoolsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePublicIpv4PoolsCommandInput = DescribePublicIpv4PoolsRequest; export type DescribePublicIpv4PoolsCommandOutput = DescribePublicIpv4PoolsResult & __MetadataBearer; +/** + *

Describes the specified IPv4 address pools.

+ */ export class DescribePublicIpv4PoolsCommand extends $Command< DescribePublicIpv4PoolsCommandInput, DescribePublicIpv4PoolsCommandOutput, @@ -34,6 +37,9 @@ export class DescribePublicIpv4PoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeRegionsCommand.ts b/clients/client-ec2/commands/DescribeRegionsCommand.ts index d69d23173fa4e..afc2bc62638f0 100644 --- a/clients/client-ec2/commands/DescribeRegionsCommand.ts +++ b/clients/client-ec2/commands/DescribeRegionsCommand.ts @@ -17,6 +17,12 @@ import { export type DescribeRegionsCommandInput = DescribeRegionsRequest; export type DescribeRegionsCommandOutput = DescribeRegionsResult & __MetadataBearer; +/** + *

Describes the Regions that are enabled for your account, or all Regions.

+ *

For a list of the Regions supported by Amazon EC2, see + * Regions and Endpoints.

+ *

For information about enabling and disabling Regions for your account, see Managing AWS Regions in the AWS General Reference.

+ */ export class DescribeRegionsCommand extends $Command< DescribeRegionsCommandInput, DescribeRegionsCommandOutput, @@ -31,6 +37,9 @@ export class DescribeRegionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeReservedInstancesCommand.ts b/clients/client-ec2/commands/DescribeReservedInstancesCommand.ts index 2aee59c044068..eed2d16996b06 100644 --- a/clients/client-ec2/commands/DescribeReservedInstancesCommand.ts +++ b/clients/client-ec2/commands/DescribeReservedInstancesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeReservedInstancesCommandInput = DescribeReservedInstancesRequest; export type DescribeReservedInstancesCommandOutput = DescribeReservedInstancesResult & __MetadataBearer; +/** + *

Describes one or more of the Reserved Instances that you purchased.

+ *

For more information about Reserved Instances, see Reserved + * Instances in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeReservedInstancesCommand extends $Command< DescribeReservedInstancesCommandInput, DescribeReservedInstancesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeReservedInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeReservedInstancesListingsCommand.ts b/clients/client-ec2/commands/DescribeReservedInstancesListingsCommand.ts index dc3c62261bfe9..d7d227360f4ba 100644 --- a/clients/client-ec2/commands/DescribeReservedInstancesListingsCommand.ts +++ b/clients/client-ec2/commands/DescribeReservedInstancesListingsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeReservedInstancesListingsCommandInput = DescribeReservedInstancesListingsRequest; export type DescribeReservedInstancesListingsCommandOutput = DescribeReservedInstancesListingsResult & __MetadataBearer; +/** + *

Describes your account's Reserved Instance listings in the Reserved Instance Marketplace.

+ *

The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

+ *

As a seller, you choose to list some or all of your Reserved Instances, and you specify the upfront price to receive for them. Your Reserved Instances are then listed in the Reserved Instance Marketplace and are available for purchase.

+ *

As a buyer, you specify the configuration of the Reserved Instance to purchase, and the Marketplace matches what you're searching for with what's available. The Marketplace first sells the lowest priced Reserved Instances to you, and continues to sell available Reserved Instance listings to you until your demand is met. You are charged based on the total price of all of the listings that you purchase.

+ *

For more information, see Reserved Instance Marketplace + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeReservedInstancesListingsCommand extends $Command< DescribeReservedInstancesListingsCommandInput, DescribeReservedInstancesListingsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeReservedInstancesListingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeReservedInstancesModificationsCommand.ts b/clients/client-ec2/commands/DescribeReservedInstancesModificationsCommand.ts index 707feeb75de19..99800210035c9 100644 --- a/clients/client-ec2/commands/DescribeReservedInstancesModificationsCommand.ts +++ b/clients/client-ec2/commands/DescribeReservedInstancesModificationsCommand.ts @@ -24,6 +24,10 @@ export type DescribeReservedInstancesModificationsCommandInput = DescribeReserve export type DescribeReservedInstancesModificationsCommandOutput = DescribeReservedInstancesModificationsResult & __MetadataBearer; +/** + *

Describes the modifications made to your Reserved Instances. If no parameter is specified, information about all your Reserved Instances modification requests is returned. If a modification ID is specified, only information about the specific modification is returned.

+ *

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeReservedInstancesModificationsCommand extends $Command< DescribeReservedInstancesModificationsCommandInput, DescribeReservedInstancesModificationsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeReservedInstancesModificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeReservedInstancesOfferingsCommand.ts b/clients/client-ec2/commands/DescribeReservedInstancesOfferingsCommand.ts index 0342ff3474d6d..097e62be62d5a 100644 --- a/clients/client-ec2/commands/DescribeReservedInstancesOfferingsCommand.ts +++ b/clients/client-ec2/commands/DescribeReservedInstancesOfferingsCommand.ts @@ -24,6 +24,12 @@ export type DescribeReservedInstancesOfferingsCommandInput = DescribeReservedIns export type DescribeReservedInstancesOfferingsCommandOutput = DescribeReservedInstancesOfferingsResult & __MetadataBearer; +/** + *

Describes Reserved Instance offerings that are available for purchase. With Reserved Instances, you purchase the right to launch instances for a period of time. During that time period, you do not receive insufficient capacity errors, and you pay a lower usage rate than the rate charged for On-Demand instances for the actual time used.

+ *

If you have listed your own Reserved Instances for sale in the Reserved Instance Marketplace, they will be excluded from these results. This is to ensure that you do not purchase your own Reserved Instances.

+ *

For more information, see Reserved Instance Marketplace + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeReservedInstancesOfferingsCommand extends $Command< DescribeReservedInstancesOfferingsCommandInput, DescribeReservedInstancesOfferingsCommandOutput, @@ -38,6 +44,9 @@ export class DescribeReservedInstancesOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeRouteTablesCommand.ts b/clients/client-ec2/commands/DescribeRouteTablesCommand.ts index 380456fa090ae..fa0f29d6a1892 100644 --- a/clients/client-ec2/commands/DescribeRouteTablesCommand.ts +++ b/clients/client-ec2/commands/DescribeRouteTablesCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeRouteTablesCommandInput = DescribeRouteTablesRequest; export type DescribeRouteTablesCommandOutput = DescribeRouteTablesResult & __MetadataBearer; +/** + *

Describes one or more of your route tables.

+ *

Each subnet in your VPC must be associated with a route table. If a subnet is not explicitly associated with any route table, it is implicitly associated with the main route table. This command does not return the subnet ID for implicit associations.

+ *

For more information, see Route Tables in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class DescribeRouteTablesCommand extends $Command< DescribeRouteTablesCommandInput, DescribeRouteTablesCommandOutput, @@ -34,6 +40,9 @@ export class DescribeRouteTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeScheduledInstanceAvailabilityCommand.ts b/clients/client-ec2/commands/DescribeScheduledInstanceAvailabilityCommand.ts index eb2d2520118f7..62bc9f4788f37 100644 --- a/clients/client-ec2/commands/DescribeScheduledInstanceAvailabilityCommand.ts +++ b/clients/client-ec2/commands/DescribeScheduledInstanceAvailabilityCommand.ts @@ -24,6 +24,12 @@ export type DescribeScheduledInstanceAvailabilityCommandInput = DescribeSchedule export type DescribeScheduledInstanceAvailabilityCommandOutput = DescribeScheduledInstanceAvailabilityResult & __MetadataBearer; +/** + *

Finds available schedules that meet the specified criteria.

+ *

You can search for an available schedule no more than 3 months in advance. You must meet the minimum required duration of 1,200 hours per year. For example, the minimum daily schedule is 4 hours, the minimum weekly schedule is 24 hours, and the minimum monthly schedule is 100 hours.

+ *

After you find a schedule that meets your needs, call PurchaseScheduledInstances + * to purchase Scheduled Instances with that schedule.

+ */ export class DescribeScheduledInstanceAvailabilityCommand extends $Command< DescribeScheduledInstanceAvailabilityCommandInput, DescribeScheduledInstanceAvailabilityCommandOutput, @@ -38,6 +44,9 @@ export class DescribeScheduledInstanceAvailabilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeScheduledInstancesCommand.ts b/clients/client-ec2/commands/DescribeScheduledInstancesCommand.ts index b5e40a6dea185..90f3f3812453c 100644 --- a/clients/client-ec2/commands/DescribeScheduledInstancesCommand.ts +++ b/clients/client-ec2/commands/DescribeScheduledInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeScheduledInstancesCommandInput = DescribeScheduledInstancesRequest; export type DescribeScheduledInstancesCommandOutput = DescribeScheduledInstancesResult & __MetadataBearer; +/** + *

Describes the specified Scheduled Instances or all your Scheduled Instances.

+ */ export class DescribeScheduledInstancesCommand extends $Command< DescribeScheduledInstancesCommandInput, DescribeScheduledInstancesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeScheduledInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSecurityGroupReferencesCommand.ts b/clients/client-ec2/commands/DescribeSecurityGroupReferencesCommand.ts index dc2b8c73613ab..878389327f731 100644 --- a/clients/client-ec2/commands/DescribeSecurityGroupReferencesCommand.ts +++ b/clients/client-ec2/commands/DescribeSecurityGroupReferencesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSecurityGroupReferencesCommandInput = DescribeSecurityGroupReferencesRequest; export type DescribeSecurityGroupReferencesCommandOutput = DescribeSecurityGroupReferencesResult & __MetadataBearer; +/** + *

[VPC only] Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.

+ */ export class DescribeSecurityGroupReferencesCommand extends $Command< DescribeSecurityGroupReferencesCommandInput, DescribeSecurityGroupReferencesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSecurityGroupReferencesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSecurityGroupsCommand.ts b/clients/client-ec2/commands/DescribeSecurityGroupsCommand.ts index 4e458b2f26ff9..043311fec5fcf 100644 --- a/clients/client-ec2/commands/DescribeSecurityGroupsCommand.ts +++ b/clients/client-ec2/commands/DescribeSecurityGroupsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeSecurityGroupsCommandInput = DescribeSecurityGroupsRequest; export type DescribeSecurityGroupsCommandOutput = DescribeSecurityGroupsResult & __MetadataBearer; +/** + *

Describes the specified security groups or all of your security groups.

+ *

A security group is for use with instances either in the EC2-Classic platform + * or in a specific VPC. For more information, see + * Amazon EC2 Security Groups in + * the Amazon Elastic Compute Cloud User Guide and + * Security Groups for Your VPC in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class DescribeSecurityGroupsCommand extends $Command< DescribeSecurityGroupsCommandInput, DescribeSecurityGroupsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSnapshotAttributeCommand.ts b/clients/client-ec2/commands/DescribeSnapshotAttributeCommand.ts index 8bfe638f6a386..05bf43eeeb827 100644 --- a/clients/client-ec2/commands/DescribeSnapshotAttributeCommand.ts +++ b/clients/client-ec2/commands/DescribeSnapshotAttributeCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeSnapshotAttributeCommandInput = DescribeSnapshotAttributeRequest; export type DescribeSnapshotAttributeCommandOutput = DescribeSnapshotAttributeResult & __MetadataBearer; +/** + *

Describes the specified attribute of the specified snapshot. You can specify only one + * attribute at a time.

+ *

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeSnapshotAttributeCommand extends $Command< DescribeSnapshotAttributeCommandInput, DescribeSnapshotAttributeCommandOutput, @@ -34,6 +39,9 @@ export class DescribeSnapshotAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSnapshotsCommand.ts b/clients/client-ec2/commands/DescribeSnapshotsCommand.ts index 48a81c677f8c8..977ed0730688f 100644 --- a/clients/client-ec2/commands/DescribeSnapshotsCommand.ts +++ b/clients/client-ec2/commands/DescribeSnapshotsCommand.ts @@ -20,6 +20,55 @@ import { export type DescribeSnapshotsCommandInput = DescribeSnapshotsRequest; export type DescribeSnapshotsCommandOutput = DescribeSnapshotsResult & __MetadataBearer; +/** + *

Describes the specified EBS snapshots available to you or all of the EBS snapshots + * available to you.

+ *

The snapshots available to you include public snapshots, private snapshots that you own, + * and private snapshots owned by other AWS accounts for which you have explicit create volume + * permissions.

+ *

The create volume permissions fall into the following categories:

+ *
    + *
  • + *

    + * public: The owner of the snapshot granted create volume + * permissions for the snapshot to the all group. All AWS accounts have create + * volume permissions for these snapshots.

    + *
  • + *
  • + *

    + * explicit: The owner of the snapshot granted create volume + * permissions to a specific AWS account.

    + *
  • + *
  • + *

    + * implicit: An AWS account has implicit create volume permissions + * for all snapshots it owns.

    + *
  • + *
+ *

The list of snapshots returned can be filtered by specifying snapshot IDs, snapshot + * owners, or AWS accounts with create volume permissions. If no options are specified, Amazon + * EC2 returns all snapshots for which you have create volume permissions.

+ *

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are + * returned. If you specify an invalid snapshot ID, an error is returned. If you specify a + * snapshot ID for which you do not have access, it is not included in the returned + * results.

+ *

If you specify one or more snapshot owners using the OwnerIds option, only + * snapshots from the specified owners and for which you have access are returned. The results + * can include the AWS account IDs of the specified owners, amazon for snapshots + * owned by Amazon, or self for snapshots that you own.

+ *

If you specify a list of restorable users, only snapshots with create snapshot permissions + * for those users are returned. You can specify AWS account IDs (if you own the snapshots), + * self for snapshots for which you own or have explicit permissions, or + * all for public snapshots.

+ *

If you are describing a long list of snapshots, we recommend that you paginate the output to make the + * list more manageable. The MaxResults parameter sets the maximum number of results + * returned in a single page. If the list of results exceeds your MaxResults value, + * then that number of results is returned along with a NextToken value that can be + * passed to a subsequent DescribeSnapshots request to retrieve the remaining + * results.

+ *

To get the state of fast snapshot restores for a snapshot, use DescribeFastSnapshotRestores.

+ *

For more information about EBS snapshots, see Amazon EBS Snapshots in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeSnapshotsCommand extends $Command< DescribeSnapshotsCommandInput, DescribeSnapshotsCommandOutput, @@ -34,6 +83,9 @@ export class DescribeSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSpotDatafeedSubscriptionCommand.ts b/clients/client-ec2/commands/DescribeSpotDatafeedSubscriptionCommand.ts index e5eaa8addcde6..cc0b6fab50492 100644 --- a/clients/client-ec2/commands/DescribeSpotDatafeedSubscriptionCommand.ts +++ b/clients/client-ec2/commands/DescribeSpotDatafeedSubscriptionCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSpotDatafeedSubscriptionCommandInput = DescribeSpotDatafeedSubscriptionRequest; export type DescribeSpotDatafeedSubscriptionCommandOutput = DescribeSpotDatafeedSubscriptionResult & __MetadataBearer; +/** + *

Describes the data feed for Spot Instances. For more information, see Spot + * Instance data feed in the Amazon EC2 User Guide for Linux Instances.

+ */ export class DescribeSpotDatafeedSubscriptionCommand extends $Command< DescribeSpotDatafeedSubscriptionCommandInput, DescribeSpotDatafeedSubscriptionCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSpotDatafeedSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSpotFleetInstancesCommand.ts b/clients/client-ec2/commands/DescribeSpotFleetInstancesCommand.ts index 8b6f183b09562..4028360e72342 100644 --- a/clients/client-ec2/commands/DescribeSpotFleetInstancesCommand.ts +++ b/clients/client-ec2/commands/DescribeSpotFleetInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSpotFleetInstancesCommandInput = DescribeSpotFleetInstancesRequest; export type DescribeSpotFleetInstancesCommandOutput = DescribeSpotFleetInstancesResponse & __MetadataBearer; +/** + *

Describes the running instances for the specified Spot Fleet.

+ */ export class DescribeSpotFleetInstancesCommand extends $Command< DescribeSpotFleetInstancesCommandInput, DescribeSpotFleetInstancesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSpotFleetInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSpotFleetRequestHistoryCommand.ts b/clients/client-ec2/commands/DescribeSpotFleetRequestHistoryCommand.ts index ade2de435520b..30bc1e3ad15dc 100644 --- a/clients/client-ec2/commands/DescribeSpotFleetRequestHistoryCommand.ts +++ b/clients/client-ec2/commands/DescribeSpotFleetRequestHistoryCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeSpotFleetRequestHistoryCommandInput = DescribeSpotFleetRequestHistoryRequest; export type DescribeSpotFleetRequestHistoryCommandOutput = DescribeSpotFleetRequestHistoryResponse & __MetadataBearer; +/** + *

Describes the events for the specified Spot Fleet request during the specified time.

+ *

Spot Fleet events are delayed by up to 30 seconds before they can be described. This ensures that you can query + * by the last evaluated time and not miss a recorded event. Spot Fleet events are available for 48 hours.

+ */ export class DescribeSpotFleetRequestHistoryCommand extends $Command< DescribeSpotFleetRequestHistoryCommandInput, DescribeSpotFleetRequestHistoryCommandOutput, @@ -34,6 +39,9 @@ export class DescribeSpotFleetRequestHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSpotFleetRequestsCommand.ts b/clients/client-ec2/commands/DescribeSpotFleetRequestsCommand.ts index be9f26fe40fd2..37f3eb6c87afb 100644 --- a/clients/client-ec2/commands/DescribeSpotFleetRequestsCommand.ts +++ b/clients/client-ec2/commands/DescribeSpotFleetRequestsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSpotFleetRequestsCommandInput = DescribeSpotFleetRequestsRequest; export type DescribeSpotFleetRequestsCommandOutput = DescribeSpotFleetRequestsResponse & __MetadataBearer; +/** + *

Describes your Spot Fleet requests.

+ *

Spot Fleet requests are deleted 48 hours after they are canceled and their instances are terminated.

+ */ export class DescribeSpotFleetRequestsCommand extends $Command< DescribeSpotFleetRequestsCommandInput, DescribeSpotFleetRequestsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSpotFleetRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSpotInstanceRequestsCommand.ts b/clients/client-ec2/commands/DescribeSpotInstanceRequestsCommand.ts index 299685dfa594f..27fadc4622246 100644 --- a/clients/client-ec2/commands/DescribeSpotInstanceRequestsCommand.ts +++ b/clients/client-ec2/commands/DescribeSpotInstanceRequestsCommand.ts @@ -20,6 +20,24 @@ import { export type DescribeSpotInstanceRequestsCommandInput = DescribeSpotInstanceRequestsRequest; export type DescribeSpotInstanceRequestsCommandOutput = DescribeSpotInstanceRequestsResult & __MetadataBearer; +/** + *

Describes the specified Spot Instance requests.

+ *

You can use DescribeSpotInstanceRequests to find a + * running Spot Instance by examining the response. If the status of + * the Spot Instance is fulfilled, the instance ID + * appears in the response and contains the identifier of the instance. + * Alternatively, you can use DescribeInstances with a filter to + * look for instances where the instance lifecycle is spot.

+ *

We recommend that you set MaxResults to a value between 5 and 1000 to + * limit the number of results returned. This paginates the output, which makes the list + * more manageable and returns the results faster. If the list of results exceeds your + * MaxResults value, then that number of results is returned along with a + * NextToken value that can be passed to a subsequent + * DescribeSpotInstanceRequests request to retrieve the remaining + * results.

+ *

Spot Instance requests are deleted four hours after they are canceled and their instances + * are terminated.

+ */ export class DescribeSpotInstanceRequestsCommand extends $Command< DescribeSpotInstanceRequestsCommandInput, DescribeSpotInstanceRequestsCommandOutput, @@ -34,6 +52,9 @@ export class DescribeSpotInstanceRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSpotPriceHistoryCommand.ts b/clients/client-ec2/commands/DescribeSpotPriceHistoryCommand.ts index 3b957f0a25039..47c91ec683486 100644 --- a/clients/client-ec2/commands/DescribeSpotPriceHistoryCommand.ts +++ b/clients/client-ec2/commands/DescribeSpotPriceHistoryCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeSpotPriceHistoryCommandInput = DescribeSpotPriceHistoryRequest; export type DescribeSpotPriceHistoryCommandOutput = DescribeSpotPriceHistoryResult & __MetadataBearer; +/** + *

Describes the Spot price history. For more information, see + * Spot Instance pricing history + * in the Amazon EC2 User Guide for Linux Instances.

+ *

When you specify a start and end time, this operation returns the prices of the instance types within the time range that you specified and the time when the price changed. + * The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

+ */ export class DescribeSpotPriceHistoryCommand extends $Command< DescribeSpotPriceHistoryCommandInput, DescribeSpotPriceHistoryCommandOutput, @@ -34,6 +41,9 @@ export class DescribeSpotPriceHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeStaleSecurityGroupsCommand.ts b/clients/client-ec2/commands/DescribeStaleSecurityGroupsCommand.ts index e02d52a01e852..1ccac679e2cb3 100644 --- a/clients/client-ec2/commands/DescribeStaleSecurityGroupsCommand.ts +++ b/clients/client-ec2/commands/DescribeStaleSecurityGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeStaleSecurityGroupsCommandInput = DescribeStaleSecurityGroupsRequest; export type DescribeStaleSecurityGroupsCommandOutput = DescribeStaleSecurityGroupsResult & __MetadataBearer; +/** + *

[VPC only] Describes the stale security group rules for security groups in a specified VPC. Rules are stale when they reference a deleted security group in a peer VPC, or a security group in a peer VPC for which the VPC peering connection has been deleted.

+ */ export class DescribeStaleSecurityGroupsCommand extends $Command< DescribeStaleSecurityGroupsCommandInput, DescribeStaleSecurityGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeStaleSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeSubnetsCommand.ts b/clients/client-ec2/commands/DescribeSubnetsCommand.ts index e1bdb0f1b087a..4d486bc5fde02 100644 --- a/clients/client-ec2/commands/DescribeSubnetsCommand.ts +++ b/clients/client-ec2/commands/DescribeSubnetsCommand.ts @@ -17,6 +17,11 @@ import { export type DescribeSubnetsCommandInput = DescribeSubnetsRequest; export type DescribeSubnetsCommandOutput = DescribeSubnetsResult & __MetadataBearer; +/** + *

Describes one or more of your subnets.

+ *

For more information, see Your VPC and Subnets in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class DescribeSubnetsCommand extends $Command< DescribeSubnetsCommandInput, DescribeSubnetsCommandOutput, @@ -31,6 +36,9 @@ export class DescribeSubnetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTagsCommand.ts b/clients/client-ec2/commands/DescribeTagsCommand.ts index b2d4656acb673..e771648cc300b 100644 --- a/clients/client-ec2/commands/DescribeTagsCommand.ts +++ b/clients/client-ec2/commands/DescribeTagsCommand.ts @@ -17,6 +17,11 @@ import { export type DescribeTagsCommandInput = DescribeTagsRequest; export type DescribeTagsCommandOutput = DescribeTagsResult & __MetadataBearer; +/** + *

Describes the specified tags for your EC2 resources.

+ *

For more information about tags, see Tagging Your Resources in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -31,6 +36,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTrafficMirrorFiltersCommand.ts b/clients/client-ec2/commands/DescribeTrafficMirrorFiltersCommand.ts index a8bdacf1abd4a..68ae29478fd26 100644 --- a/clients/client-ec2/commands/DescribeTrafficMirrorFiltersCommand.ts +++ b/clients/client-ec2/commands/DescribeTrafficMirrorFiltersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTrafficMirrorFiltersCommandInput = DescribeTrafficMirrorFiltersRequest; export type DescribeTrafficMirrorFiltersCommandOutput = DescribeTrafficMirrorFiltersResult & __MetadataBearer; +/** + *

Describes one or more Traffic Mirror filters.

+ */ export class DescribeTrafficMirrorFiltersCommand extends $Command< DescribeTrafficMirrorFiltersCommandInput, DescribeTrafficMirrorFiltersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTrafficMirrorFiltersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTrafficMirrorSessionsCommand.ts b/clients/client-ec2/commands/DescribeTrafficMirrorSessionsCommand.ts index 242f59f8feb20..6aafa691f9e33 100644 --- a/clients/client-ec2/commands/DescribeTrafficMirrorSessionsCommand.ts +++ b/clients/client-ec2/commands/DescribeTrafficMirrorSessionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTrafficMirrorSessionsCommandInput = DescribeTrafficMirrorSessionsRequest; export type DescribeTrafficMirrorSessionsCommandOutput = DescribeTrafficMirrorSessionsResult & __MetadataBearer; +/** + *

Describes one or more Traffic Mirror sessions. By default, all Traffic Mirror sessions are described. Alternatively, you can filter the results.

+ */ export class DescribeTrafficMirrorSessionsCommand extends $Command< DescribeTrafficMirrorSessionsCommandInput, DescribeTrafficMirrorSessionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTrafficMirrorSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTrafficMirrorTargetsCommand.ts b/clients/client-ec2/commands/DescribeTrafficMirrorTargetsCommand.ts index fb985fde5a643..5f7129ec75959 100644 --- a/clients/client-ec2/commands/DescribeTrafficMirrorTargetsCommand.ts +++ b/clients/client-ec2/commands/DescribeTrafficMirrorTargetsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTrafficMirrorTargetsCommandInput = DescribeTrafficMirrorTargetsRequest; export type DescribeTrafficMirrorTargetsCommandOutput = DescribeTrafficMirrorTargetsResult & __MetadataBearer; +/** + *

Information about one or more Traffic Mirror targets.

+ */ export class DescribeTrafficMirrorTargetsCommand extends $Command< DescribeTrafficMirrorTargetsCommandInput, DescribeTrafficMirrorTargetsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTrafficMirrorTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTransitGatewayAttachmentsCommand.ts b/clients/client-ec2/commands/DescribeTransitGatewayAttachmentsCommand.ts index 4061cc42379c9..3d82039a0183c 100644 --- a/clients/client-ec2/commands/DescribeTransitGatewayAttachmentsCommand.ts +++ b/clients/client-ec2/commands/DescribeTransitGatewayAttachmentsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeTransitGatewayAttachmentsCommandInput = DescribeTransitGatewayAttachmentsRequest; export type DescribeTransitGatewayAttachmentsCommandOutput = DescribeTransitGatewayAttachmentsResult & __MetadataBearer; +/** + *

Describes one or more attachments between resources and transit gateways. By default, all attachments are described. + * Alternatively, you can filter the results by attachment ID, attachment state, resource ID, or resource owner.

+ */ export class DescribeTransitGatewayAttachmentsCommand extends $Command< DescribeTransitGatewayAttachmentsCommandInput, DescribeTransitGatewayAttachmentsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeTransitGatewayAttachmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTransitGatewayMulticastDomainsCommand.ts b/clients/client-ec2/commands/DescribeTransitGatewayMulticastDomainsCommand.ts index 54862f85a5623..ef5ed23dfa902 100644 --- a/clients/client-ec2/commands/DescribeTransitGatewayMulticastDomainsCommand.ts +++ b/clients/client-ec2/commands/DescribeTransitGatewayMulticastDomainsCommand.ts @@ -24,6 +24,9 @@ export type DescribeTransitGatewayMulticastDomainsCommandInput = DescribeTransit export type DescribeTransitGatewayMulticastDomainsCommandOutput = DescribeTransitGatewayMulticastDomainsResult & __MetadataBearer; +/** + *

Describes one or more transit gateway multicast domains.

+ */ export class DescribeTransitGatewayMulticastDomainsCommand extends $Command< DescribeTransitGatewayMulticastDomainsCommandInput, DescribeTransitGatewayMulticastDomainsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeTransitGatewayMulticastDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTransitGatewayPeeringAttachmentsCommand.ts b/clients/client-ec2/commands/DescribeTransitGatewayPeeringAttachmentsCommand.ts index 6c52a887fbe03..b076d48dcbd41 100644 --- a/clients/client-ec2/commands/DescribeTransitGatewayPeeringAttachmentsCommand.ts +++ b/clients/client-ec2/commands/DescribeTransitGatewayPeeringAttachmentsCommand.ts @@ -24,6 +24,9 @@ export type DescribeTransitGatewayPeeringAttachmentsCommandInput = DescribeTrans export type DescribeTransitGatewayPeeringAttachmentsCommandOutput = DescribeTransitGatewayPeeringAttachmentsResult & __MetadataBearer; +/** + *

Describes your transit gateway peering attachments.

+ */ export class DescribeTransitGatewayPeeringAttachmentsCommand extends $Command< DescribeTransitGatewayPeeringAttachmentsCommandInput, DescribeTransitGatewayPeeringAttachmentsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeTransitGatewayPeeringAttachmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTransitGatewayRouteTablesCommand.ts b/clients/client-ec2/commands/DescribeTransitGatewayRouteTablesCommand.ts index dd25102a74653..de10dfc5f8526 100644 --- a/clients/client-ec2/commands/DescribeTransitGatewayRouteTablesCommand.ts +++ b/clients/client-ec2/commands/DescribeTransitGatewayRouteTablesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeTransitGatewayRouteTablesCommandInput = DescribeTransitGatewayRouteTablesRequest; export type DescribeTransitGatewayRouteTablesCommandOutput = DescribeTransitGatewayRouteTablesResult & __MetadataBearer; +/** + *

Describes one or more transit gateway route tables. By default, all transit gateway route tables are described. + * Alternatively, you can filter the results.

+ */ export class DescribeTransitGatewayRouteTablesCommand extends $Command< DescribeTransitGatewayRouteTablesCommandInput, DescribeTransitGatewayRouteTablesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeTransitGatewayRouteTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTransitGatewayVpcAttachmentsCommand.ts b/clients/client-ec2/commands/DescribeTransitGatewayVpcAttachmentsCommand.ts index 65937ac0427de..fcff9e5ea7664 100644 --- a/clients/client-ec2/commands/DescribeTransitGatewayVpcAttachmentsCommand.ts +++ b/clients/client-ec2/commands/DescribeTransitGatewayVpcAttachmentsCommand.ts @@ -24,6 +24,10 @@ export type DescribeTransitGatewayVpcAttachmentsCommandInput = DescribeTransitGa export type DescribeTransitGatewayVpcAttachmentsCommandOutput = DescribeTransitGatewayVpcAttachmentsResult & __MetadataBearer; +/** + *

Describes one or more VPC attachments. By default, all VPC attachments are described. + * Alternatively, you can filter the results.

+ */ export class DescribeTransitGatewayVpcAttachmentsCommand extends $Command< DescribeTransitGatewayVpcAttachmentsCommandInput, DescribeTransitGatewayVpcAttachmentsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeTransitGatewayVpcAttachmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeTransitGatewaysCommand.ts b/clients/client-ec2/commands/DescribeTransitGatewaysCommand.ts index 5f510a218fdbb..6044af5531c7b 100644 --- a/clients/client-ec2/commands/DescribeTransitGatewaysCommand.ts +++ b/clients/client-ec2/commands/DescribeTransitGatewaysCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeTransitGatewaysCommandInput = DescribeTransitGatewaysRequest; export type DescribeTransitGatewaysCommandOutput = DescribeTransitGatewaysResult & __MetadataBearer; +/** + *

Describes one or more transit gateways. By default, all transit gateways are described. Alternatively, you can + * filter the results.

+ */ export class DescribeTransitGatewaysCommand extends $Command< DescribeTransitGatewaysCommandInput, DescribeTransitGatewaysCommandOutput, @@ -34,6 +38,9 @@ export class DescribeTransitGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVolumeAttributeCommand.ts b/clients/client-ec2/commands/DescribeVolumeAttributeCommand.ts index 95e4a3be462e6..dbc332947fea0 100644 --- a/clients/client-ec2/commands/DescribeVolumeAttributeCommand.ts +++ b/clients/client-ec2/commands/DescribeVolumeAttributeCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeVolumeAttributeCommandInput = DescribeVolumeAttributeRequest; export type DescribeVolumeAttributeCommandOutput = DescribeVolumeAttributeResult & __MetadataBearer; +/** + *

Describes the specified attribute of the specified volume. You can specify only one + * attribute at a time.

+ *

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeVolumeAttributeCommand extends $Command< DescribeVolumeAttributeCommandInput, DescribeVolumeAttributeCommandOutput, @@ -34,6 +39,9 @@ export class DescribeVolumeAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVolumeStatusCommand.ts b/clients/client-ec2/commands/DescribeVolumeStatusCommand.ts index 5e8b81cccdb7d..f2b1bdd8f366a 100644 --- a/clients/client-ec2/commands/DescribeVolumeStatusCommand.ts +++ b/clients/client-ec2/commands/DescribeVolumeStatusCommand.ts @@ -20,6 +20,42 @@ import { export type DescribeVolumeStatusCommandInput = DescribeVolumeStatusRequest; export type DescribeVolumeStatusCommandOutput = DescribeVolumeStatusResult & __MetadataBearer; +/** + *

Describes the status of the specified volumes. Volume status provides the result of the + * checks performed on your volumes to determine events that can impair the performance of your + * volumes. The performance of a volume can be affected if an issue occurs on the volume's + * underlying host. If the volume's underlying host experiences a power outage or system issue, + * after the system is restored, there could be data inconsistencies on the volume. Volume events + * notify you if this occurs. Volume actions notify you if any action needs to be taken in + * response to the event.

+ *

The DescribeVolumeStatus operation provides the following information about + * the specified volumes:

+ *

+ * Status: Reflects the current status of the volume. The possible + * values are ok, impaired , warning, or + * insufficient-data. If all checks pass, the overall status of the volume is + * ok. If the check fails, the overall status is impaired. If the + * status is insufficient-data, then the checks may still be taking place on your + * volume at the time. We recommend that you retry the request. For more information about volume + * status, see Monitoring the status of your volumes in the + * Amazon Elastic Compute Cloud User Guide.

+ *

+ * Events: Reflect the cause of a volume status and may require you to + * take action. For example, if your volume returns an impaired status, then the + * volume event might be potential-data-inconsistency. This means that your volume + * has been affected by an issue with the underlying host, has all I/O operations disabled, and + * may have inconsistent data.

+ *

+ * Actions: Reflect the actions you may have to take in response to an + * event. For example, if the status of the volume is impaired and the volume event + * shows potential-data-inconsistency, then the action shows + * enable-volume-io. This means that you may want to enable the I/O operations for + * the volume by calling the EnableVolumeIO action and then check the volume + * for data consistency.

+ *

Volume status is based on the volume status checks, and does not reflect the volume state. + * Therefore, volume status does not indicate volumes in the error state (for + * example, when a volume is incapable of accepting I/O.)

+ */ export class DescribeVolumeStatusCommand extends $Command< DescribeVolumeStatusCommandInput, DescribeVolumeStatusCommandOutput, @@ -34,6 +70,9 @@ export class DescribeVolumeStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVolumesCommand.ts b/clients/client-ec2/commands/DescribeVolumesCommand.ts index f65ba6ef295e5..d4c6ddf073450 100644 --- a/clients/client-ec2/commands/DescribeVolumesCommand.ts +++ b/clients/client-ec2/commands/DescribeVolumesCommand.ts @@ -17,6 +17,16 @@ import { export type DescribeVolumesCommandInput = DescribeVolumesRequest; export type DescribeVolumesCommandOutput = DescribeVolumesResult & __MetadataBearer; +/** + *

Describes the specified EBS volumes or all of your EBS volumes.

+ *

If you are describing a long list of volumes, we recommend that you paginate the output to make the list + * more manageable. The MaxResults parameter sets the maximum number of results + * returned in a single page. If the list of results exceeds your MaxResults value, + * then that number of results is returned along with a NextToken value that can be + * passed to a subsequent DescribeVolumes request to retrieve the remaining + * results.

+ *

For more information about EBS volumes, see Amazon EBS Volumes in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeVolumesCommand extends $Command< DescribeVolumesCommandInput, DescribeVolumesCommandOutput, @@ -31,6 +41,9 @@ export class DescribeVolumesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVolumesModificationsCommand.ts b/clients/client-ec2/commands/DescribeVolumesModificationsCommand.ts index 150ae1ce5962a..6ecfc4453689b 100644 --- a/clients/client-ec2/commands/DescribeVolumesModificationsCommand.ts +++ b/clients/client-ec2/commands/DescribeVolumesModificationsCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeVolumesModificationsCommandInput = DescribeVolumesModificationsRequest; export type DescribeVolumesModificationsCommandOutput = DescribeVolumesModificationsResult & __MetadataBearer; +/** + *

Describes the most recent volume modification request for the specified EBS volumes.

+ *

If a volume has never been modified, some information in the output will be null. + * If a volume has been modified more than once, the output includes only the most + * recent modification request.

+ *

You can also use CloudWatch Events to check the status of a modification to an EBS + * volume. For information about CloudWatch Events, see the Amazon CloudWatch Events User Guide. For more information, see + * Monitoring volume modifications in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeVolumesModificationsCommand extends $Command< DescribeVolumesModificationsCommandInput, DescribeVolumesModificationsCommandOutput, @@ -34,6 +44,9 @@ export class DescribeVolumesModificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcAttributeCommand.ts b/clients/client-ec2/commands/DescribeVpcAttributeCommand.ts index e48aa9115df89..18ba47a891596 100644 --- a/clients/client-ec2/commands/DescribeVpcAttributeCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcAttributeCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeVpcAttributeCommandInput = DescribeVpcAttributeRequest; export type DescribeVpcAttributeCommandOutput = DescribeVpcAttributeResult & __MetadataBearer; +/** + *

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

+ */ export class DescribeVpcAttributeCommand extends $Command< DescribeVpcAttributeCommandInput, DescribeVpcAttributeCommandOutput, @@ -34,6 +37,9 @@ export class DescribeVpcAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcClassicLinkCommand.ts b/clients/client-ec2/commands/DescribeVpcClassicLinkCommand.ts index de6de97ca3784..0786df97ff179 100644 --- a/clients/client-ec2/commands/DescribeVpcClassicLinkCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcClassicLinkCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeVpcClassicLinkCommandInput = DescribeVpcClassicLinkRequest; export type DescribeVpcClassicLinkCommandOutput = DescribeVpcClassicLinkResult & __MetadataBearer; +/** + *

Describes the ClassicLink status of one or more VPCs.

+ */ export class DescribeVpcClassicLinkCommand extends $Command< DescribeVpcClassicLinkCommandInput, DescribeVpcClassicLinkCommandOutput, @@ -34,6 +37,9 @@ export class DescribeVpcClassicLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcClassicLinkDnsSupportCommand.ts b/clients/client-ec2/commands/DescribeVpcClassicLinkDnsSupportCommand.ts index 800278d150719..a66c48d90fbab 100644 --- a/clients/client-ec2/commands/DescribeVpcClassicLinkDnsSupportCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcClassicLinkDnsSupportCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeVpcClassicLinkDnsSupportCommandInput = DescribeVpcClassicLinkDnsSupportRequest; export type DescribeVpcClassicLinkDnsSupportCommandOutput = DescribeVpcClassicLinkDnsSupportResult & __MetadataBearer; +/** + *

Describes the ClassicLink DNS support status of one or more VPCs. If enabled, the DNS + * hostname of a linked EC2-Classic instance resolves to its private IP address when + * addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname + * of an instance in a VPC resolves to its private IP address when addressed from a linked + * EC2-Classic instance. For more information, see ClassicLink in the Amazon Elastic Compute Cloud User Guide.

+ */ export class DescribeVpcClassicLinkDnsSupportCommand extends $Command< DescribeVpcClassicLinkDnsSupportCommandInput, DescribeVpcClassicLinkDnsSupportCommandOutput, @@ -34,6 +41,9 @@ export class DescribeVpcClassicLinkDnsSupportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcEndpointConnectionNotificationsCommand.ts b/clients/client-ec2/commands/DescribeVpcEndpointConnectionNotificationsCommand.ts index 2f80394fbd117..79b8e7239c042 100644 --- a/clients/client-ec2/commands/DescribeVpcEndpointConnectionNotificationsCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcEndpointConnectionNotificationsCommand.ts @@ -24,6 +24,10 @@ export type DescribeVpcEndpointConnectionNotificationsCommandInput = DescribeVpc export type DescribeVpcEndpointConnectionNotificationsCommandOutput = DescribeVpcEndpointConnectionNotificationsResult & __MetadataBearer; +/** + *

Describes the connection notifications for VPC endpoints and VPC endpoint + * services.

+ */ export class DescribeVpcEndpointConnectionNotificationsCommand extends $Command< DescribeVpcEndpointConnectionNotificationsCommandInput, DescribeVpcEndpointConnectionNotificationsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeVpcEndpointConnectionNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcEndpointConnectionsCommand.ts b/clients/client-ec2/commands/DescribeVpcEndpointConnectionsCommand.ts index 59edd6c2d5d2f..8bdd3261a6490 100644 --- a/clients/client-ec2/commands/DescribeVpcEndpointConnectionsCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcEndpointConnectionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeVpcEndpointConnectionsCommandInput = DescribeVpcEndpointConnectionsRequest; export type DescribeVpcEndpointConnectionsCommandOutput = DescribeVpcEndpointConnectionsResult & __MetadataBearer; +/** + *

Describes the VPC endpoint connections to your VPC endpoint services, including any + * endpoints that are pending your acceptance.

+ */ export class DescribeVpcEndpointConnectionsCommand extends $Command< DescribeVpcEndpointConnectionsCommandInput, DescribeVpcEndpointConnectionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeVpcEndpointConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcEndpointServiceConfigurationsCommand.ts b/clients/client-ec2/commands/DescribeVpcEndpointServiceConfigurationsCommand.ts index 73e31ef342137..4b32df5835594 100644 --- a/clients/client-ec2/commands/DescribeVpcEndpointServiceConfigurationsCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcEndpointServiceConfigurationsCommand.ts @@ -24,6 +24,9 @@ export type DescribeVpcEndpointServiceConfigurationsCommandInput = DescribeVpcEn export type DescribeVpcEndpointServiceConfigurationsCommandOutput = DescribeVpcEndpointServiceConfigurationsResult & __MetadataBearer; +/** + *

Describes the VPC endpoint service configurations in your account (your services).

+ */ export class DescribeVpcEndpointServiceConfigurationsCommand extends $Command< DescribeVpcEndpointServiceConfigurationsCommandInput, DescribeVpcEndpointServiceConfigurationsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeVpcEndpointServiceConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcEndpointServicePermissionsCommand.ts b/clients/client-ec2/commands/DescribeVpcEndpointServicePermissionsCommand.ts index b5c971bafc186..87c14db1bc7b3 100644 --- a/clients/client-ec2/commands/DescribeVpcEndpointServicePermissionsCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcEndpointServicePermissionsCommand.ts @@ -24,6 +24,10 @@ export type DescribeVpcEndpointServicePermissionsCommandInput = DescribeVpcEndpo export type DescribeVpcEndpointServicePermissionsCommandOutput = DescribeVpcEndpointServicePermissionsResult & __MetadataBearer; +/** + *

Describes the principals (service consumers) that are permitted to discover your VPC + * endpoint service.

+ */ export class DescribeVpcEndpointServicePermissionsCommand extends $Command< DescribeVpcEndpointServicePermissionsCommandInput, DescribeVpcEndpointServicePermissionsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeVpcEndpointServicePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcEndpointServicesCommand.ts b/clients/client-ec2/commands/DescribeVpcEndpointServicesCommand.ts index b8afa412d4ee6..8562fd93cd0b2 100644 --- a/clients/client-ec2/commands/DescribeVpcEndpointServicesCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcEndpointServicesCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeVpcEndpointServicesCommandInput = DescribeVpcEndpointServicesRequest; export type DescribeVpcEndpointServicesCommandOutput = DescribeVpcEndpointServicesResult & __MetadataBearer; +/** + *

Describes available services to which you can create a VPC endpoint.

+ *

When the service provider and the consumer have different accounts multiple + * Availability Zones, and the consumer views the VPC endpoint service information, the + * response only includes the common Availability Zones. For example, when the service + * provider account uses us-east-1a and us-east-1c and the + * consumer uses us-east-1a and us-east-1a and us-east-1b, the response + * includes the VPC endpoint services in the common Availability Zone, + * us-east-1a.

+ */ export class DescribeVpcEndpointServicesCommand extends $Command< DescribeVpcEndpointServicesCommandInput, DescribeVpcEndpointServicesCommandOutput, @@ -34,6 +44,9 @@ export class DescribeVpcEndpointServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcEndpointsCommand.ts b/clients/client-ec2/commands/DescribeVpcEndpointsCommand.ts index 59f0eff755df8..80d9537967cc2 100644 --- a/clients/client-ec2/commands/DescribeVpcEndpointsCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeVpcEndpointsCommandInput = DescribeVpcEndpointsRequest; export type DescribeVpcEndpointsCommandOutput = DescribeVpcEndpointsResult & __MetadataBearer; +/** + *

Describes one or more of your VPC endpoints.

+ */ export class DescribeVpcEndpointsCommand extends $Command< DescribeVpcEndpointsCommandInput, DescribeVpcEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeVpcEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcPeeringConnectionsCommand.ts b/clients/client-ec2/commands/DescribeVpcPeeringConnectionsCommand.ts index 6dd4040968a5e..376e293402915 100644 --- a/clients/client-ec2/commands/DescribeVpcPeeringConnectionsCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcPeeringConnectionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeVpcPeeringConnectionsCommandInput = DescribeVpcPeeringConnectionsRequest; export type DescribeVpcPeeringConnectionsCommandOutput = DescribeVpcPeeringConnectionsResult & __MetadataBearer; +/** + *

Describes one or more of your VPC peering connections.

+ */ export class DescribeVpcPeeringConnectionsCommand extends $Command< DescribeVpcPeeringConnectionsCommandInput, DescribeVpcPeeringConnectionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeVpcPeeringConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpcsCommand.ts b/clients/client-ec2/commands/DescribeVpcsCommand.ts index 1e118d856d4a6..34a77e75d6a92 100644 --- a/clients/client-ec2/commands/DescribeVpcsCommand.ts +++ b/clients/client-ec2/commands/DescribeVpcsCommand.ts @@ -17,6 +17,9 @@ import { export type DescribeVpcsCommandInput = DescribeVpcsRequest; export type DescribeVpcsCommandOutput = DescribeVpcsResult & __MetadataBearer; +/** + *

Describes one or more of your VPCs.

+ */ export class DescribeVpcsCommand extends $Command< DescribeVpcsCommandInput, DescribeVpcsCommandOutput, @@ -31,6 +34,9 @@ export class DescribeVpcsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpnConnectionsCommand.ts b/clients/client-ec2/commands/DescribeVpnConnectionsCommand.ts index 7e0874200bac9..25e803ced3367 100644 --- a/clients/client-ec2/commands/DescribeVpnConnectionsCommand.ts +++ b/clients/client-ec2/commands/DescribeVpnConnectionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeVpnConnectionsCommandInput = DescribeVpnConnectionsRequest; export type DescribeVpnConnectionsCommandOutput = DescribeVpnConnectionsResult & __MetadataBearer; +/** + *

Describes one or more of your VPN connections.

+ *

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

+ */ export class DescribeVpnConnectionsCommand extends $Command< DescribeVpnConnectionsCommandInput, DescribeVpnConnectionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeVpnConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DescribeVpnGatewaysCommand.ts b/clients/client-ec2/commands/DescribeVpnGatewaysCommand.ts index 940494e889765..9c252a6170260 100644 --- a/clients/client-ec2/commands/DescribeVpnGatewaysCommand.ts +++ b/clients/client-ec2/commands/DescribeVpnGatewaysCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeVpnGatewaysCommandInput = DescribeVpnGatewaysRequest; export type DescribeVpnGatewaysCommandOutput = DescribeVpnGatewaysResult & __MetadataBearer; +/** + *

Describes one or more of your virtual private gateways.

+ *

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

+ */ export class DescribeVpnGatewaysCommand extends $Command< DescribeVpnGatewaysCommandInput, DescribeVpnGatewaysCommandOutput, @@ -34,6 +38,9 @@ export class DescribeVpnGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DetachClassicLinkVpcCommand.ts b/clients/client-ec2/commands/DetachClassicLinkVpcCommand.ts index bd0cfaba18a40..7ae4668f77636 100644 --- a/clients/client-ec2/commands/DetachClassicLinkVpcCommand.ts +++ b/clients/client-ec2/commands/DetachClassicLinkVpcCommand.ts @@ -20,6 +20,9 @@ import { export type DetachClassicLinkVpcCommandInput = DetachClassicLinkVpcRequest; export type DetachClassicLinkVpcCommandOutput = DetachClassicLinkVpcResult & __MetadataBearer; +/** + *

Unlinks (detaches) a linked EC2-Classic instance from a VPC. After the instance has been unlinked, the VPC security groups are no longer associated with it. An instance is automatically unlinked from a VPC when it's stopped.

+ */ export class DetachClassicLinkVpcCommand extends $Command< DetachClassicLinkVpcCommandInput, DetachClassicLinkVpcCommandOutput, @@ -34,6 +37,9 @@ export class DetachClassicLinkVpcCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DetachInternetGatewayCommand.ts b/clients/client-ec2/commands/DetachInternetGatewayCommand.ts index 9e582bb236399..2a1407585f2e3 100644 --- a/clients/client-ec2/commands/DetachInternetGatewayCommand.ts +++ b/clients/client-ec2/commands/DetachInternetGatewayCommand.ts @@ -20,6 +20,11 @@ import { export type DetachInternetGatewayCommandInput = DetachInternetGatewayRequest; export type DetachInternetGatewayCommandOutput = __MetadataBearer; +/** + *

Detaches an internet gateway from a VPC, disabling connectivity between the internet + * and the VPC. The VPC must not contain any running instances with Elastic IP addresses or + * public IPv4 addresses.

+ */ export class DetachInternetGatewayCommand extends $Command< DetachInternetGatewayCommandInput, DetachInternetGatewayCommandOutput, @@ -34,6 +39,9 @@ export class DetachInternetGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DetachNetworkInterfaceCommand.ts b/clients/client-ec2/commands/DetachNetworkInterfaceCommand.ts index ae358e6b0db99..7b453eb783f8d 100644 --- a/clients/client-ec2/commands/DetachNetworkInterfaceCommand.ts +++ b/clients/client-ec2/commands/DetachNetworkInterfaceCommand.ts @@ -20,6 +20,9 @@ import { export type DetachNetworkInterfaceCommandInput = DetachNetworkInterfaceRequest; export type DetachNetworkInterfaceCommandOutput = __MetadataBearer; +/** + *

Detaches a network interface from an instance.

+ */ export class DetachNetworkInterfaceCommand extends $Command< DetachNetworkInterfaceCommandInput, DetachNetworkInterfaceCommandOutput, @@ -34,6 +37,9 @@ export class DetachNetworkInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DetachVolumeCommand.ts b/clients/client-ec2/commands/DetachVolumeCommand.ts index 4eaed0272f99c..e812b65d1d06c 100644 --- a/clients/client-ec2/commands/DetachVolumeCommand.ts +++ b/clients/client-ec2/commands/DetachVolumeCommand.ts @@ -18,6 +18,19 @@ import { export type DetachVolumeCommandInput = DetachVolumeRequest; export type DetachVolumeCommandOutput = VolumeAttachment & __MetadataBearer; +/** + *

Detaches an EBS volume from an instance. Make sure to unmount any file systems on the + * device within your operating system before detaching the volume. Failure to do so can result + * in the volume becoming stuck in the busy state while detaching. If this happens, + * detachment can be delayed indefinitely until you unmount the volume, force detachment, reboot + * the instance, or all three. If an EBS volume is the root device of an instance, it can't be + * detached while the instance is running. To detach the root volume, stop the instance + * first.

+ *

When a volume with an AWS Marketplace product code is detached from an instance, the + * product code is no longer associated with the instance.

+ *

For more information, see Detaching an Amazon EBS volume in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class DetachVolumeCommand extends $Command< DetachVolumeCommandInput, DetachVolumeCommandOutput, @@ -32,6 +45,9 @@ export class DetachVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DetachVpnGatewayCommand.ts b/clients/client-ec2/commands/DetachVpnGatewayCommand.ts index ada799dcb37ac..3b9e25f1fa9ec 100644 --- a/clients/client-ec2/commands/DetachVpnGatewayCommand.ts +++ b/clients/client-ec2/commands/DetachVpnGatewayCommand.ts @@ -20,6 +20,11 @@ import { export type DetachVpnGatewayCommandInput = DetachVpnGatewayRequest; export type DetachVpnGatewayCommandOutput = __MetadataBearer; +/** + *

Detaches a virtual private gateway from a VPC. You do this if you're planning to turn off the VPC and not use it anymore. You can confirm a virtual private gateway has been completely detached from a VPC by describing the virtual private gateway (any attachments to the virtual private gateway are also described).

+ *

You must wait for the attachment's state to switch to detached before + * you can delete the VPC or attach a different VPC to the virtual private gateway.

+ */ export class DetachVpnGatewayCommand extends $Command< DetachVpnGatewayCommandInput, DetachVpnGatewayCommandOutput, @@ -34,6 +39,9 @@ export class DetachVpnGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisableEbsEncryptionByDefaultCommand.ts b/clients/client-ec2/commands/DisableEbsEncryptionByDefaultCommand.ts index df15b48baa799..e72a6b56b13c5 100644 --- a/clients/client-ec2/commands/DisableEbsEncryptionByDefaultCommand.ts +++ b/clients/client-ec2/commands/DisableEbsEncryptionByDefaultCommand.ts @@ -20,6 +20,15 @@ import { export type DisableEbsEncryptionByDefaultCommandInput = DisableEbsEncryptionByDefaultRequest; export type DisableEbsEncryptionByDefaultCommandOutput = DisableEbsEncryptionByDefaultResult & __MetadataBearer; +/** + *

Disables EBS encryption by default for your account in the current Region.

+ *

After you disable encryption by default, you can still create encrypted volumes by + * enabling encryption when you create each volume.

+ *

Disabling encryption by default does not change the encryption status of your + * existing volumes.

+ *

For more information, see Amazon EBS Encryption in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class DisableEbsEncryptionByDefaultCommand extends $Command< DisableEbsEncryptionByDefaultCommandInput, DisableEbsEncryptionByDefaultCommandOutput, @@ -34,6 +43,9 @@ export class DisableEbsEncryptionByDefaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisableFastSnapshotRestoresCommand.ts b/clients/client-ec2/commands/DisableFastSnapshotRestoresCommand.ts index 52d7d861a9701..24262b12a4ba7 100644 --- a/clients/client-ec2/commands/DisableFastSnapshotRestoresCommand.ts +++ b/clients/client-ec2/commands/DisableFastSnapshotRestoresCommand.ts @@ -20,6 +20,9 @@ import { export type DisableFastSnapshotRestoresCommandInput = DisableFastSnapshotRestoresRequest; export type DisableFastSnapshotRestoresCommandOutput = DisableFastSnapshotRestoresResult & __MetadataBearer; +/** + *

Disables fast snapshot restores for the specified snapshots in the specified Availability Zones.

+ */ export class DisableFastSnapshotRestoresCommand extends $Command< DisableFastSnapshotRestoresCommandInput, DisableFastSnapshotRestoresCommandOutput, @@ -34,6 +37,9 @@ export class DisableFastSnapshotRestoresCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisableTransitGatewayRouteTablePropagationCommand.ts b/clients/client-ec2/commands/DisableTransitGatewayRouteTablePropagationCommand.ts index f6a083f490b31..3e22b1a8d939d 100644 --- a/clients/client-ec2/commands/DisableTransitGatewayRouteTablePropagationCommand.ts +++ b/clients/client-ec2/commands/DisableTransitGatewayRouteTablePropagationCommand.ts @@ -24,6 +24,10 @@ export type DisableTransitGatewayRouteTablePropagationCommandInput = DisableTran export type DisableTransitGatewayRouteTablePropagationCommandOutput = DisableTransitGatewayRouteTablePropagationResult & __MetadataBearer; +/** + *

Disables the specified resource attachment from propagating routes to the specified + * propagation route table.

+ */ export class DisableTransitGatewayRouteTablePropagationCommand extends $Command< DisableTransitGatewayRouteTablePropagationCommandInput, DisableTransitGatewayRouteTablePropagationCommandOutput, @@ -38,6 +42,9 @@ export class DisableTransitGatewayRouteTablePropagationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisableVgwRoutePropagationCommand.ts b/clients/client-ec2/commands/DisableVgwRoutePropagationCommand.ts index 075f4bd2004fb..b9119a690e521 100644 --- a/clients/client-ec2/commands/DisableVgwRoutePropagationCommand.ts +++ b/clients/client-ec2/commands/DisableVgwRoutePropagationCommand.ts @@ -20,6 +20,9 @@ import { export type DisableVgwRoutePropagationCommandInput = DisableVgwRoutePropagationRequest; export type DisableVgwRoutePropagationCommandOutput = __MetadataBearer; +/** + *

Disables a virtual private gateway (VGW) from propagating routes to a specified route table of a VPC.

+ */ export class DisableVgwRoutePropagationCommand extends $Command< DisableVgwRoutePropagationCommandInput, DisableVgwRoutePropagationCommandOutput, @@ -34,6 +37,9 @@ export class DisableVgwRoutePropagationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisableVpcClassicLinkCommand.ts b/clients/client-ec2/commands/DisableVpcClassicLinkCommand.ts index 5a252abd281f0..e84ba8f2b4ad1 100644 --- a/clients/client-ec2/commands/DisableVpcClassicLinkCommand.ts +++ b/clients/client-ec2/commands/DisableVpcClassicLinkCommand.ts @@ -20,6 +20,9 @@ import { export type DisableVpcClassicLinkCommandInput = DisableVpcClassicLinkRequest; export type DisableVpcClassicLinkCommandOutput = DisableVpcClassicLinkResult & __MetadataBearer; +/** + *

Disables ClassicLink for a VPC. You cannot disable ClassicLink for a VPC that has EC2-Classic instances linked to it.

+ */ export class DisableVpcClassicLinkCommand extends $Command< DisableVpcClassicLinkCommandInput, DisableVpcClassicLinkCommandOutput, @@ -34,6 +37,9 @@ export class DisableVpcClassicLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisableVpcClassicLinkDnsSupportCommand.ts b/clients/client-ec2/commands/DisableVpcClassicLinkDnsSupportCommand.ts index 53c2d48c3a7ff..02c9df7516584 100644 --- a/clients/client-ec2/commands/DisableVpcClassicLinkDnsSupportCommand.ts +++ b/clients/client-ec2/commands/DisableVpcClassicLinkDnsSupportCommand.ts @@ -20,6 +20,13 @@ import { export type DisableVpcClassicLinkDnsSupportCommandInput = DisableVpcClassicLinkDnsSupportRequest; export type DisableVpcClassicLinkDnsSupportCommandOutput = DisableVpcClassicLinkDnsSupportResult & __MetadataBearer; +/** + *

Disables ClassicLink DNS support for a VPC. If disabled, DNS hostnames resolve to + * public IP addresses when addressed between a linked EC2-Classic instance and instances + * in the VPC to which it's linked. For more information, see ClassicLink in the + * Amazon Elastic Compute Cloud User Guide.

+ *

You must specify a VPC ID in the request.

+ */ export class DisableVpcClassicLinkDnsSupportCommand extends $Command< DisableVpcClassicLinkDnsSupportCommandInput, DisableVpcClassicLinkDnsSupportCommandOutput, @@ -34,6 +41,9 @@ export class DisableVpcClassicLinkDnsSupportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateAddressCommand.ts b/clients/client-ec2/commands/DisassociateAddressCommand.ts index 2bda9744e8f1e..74620f2da8002 100644 --- a/clients/client-ec2/commands/DisassociateAddressCommand.ts +++ b/clients/client-ec2/commands/DisassociateAddressCommand.ts @@ -20,6 +20,13 @@ import { export type DisassociateAddressCommandInput = DisassociateAddressRequest; export type DisassociateAddressCommandOutput = __MetadataBearer; +/** + *

Disassociates an Elastic IP address from the instance or network interface it's associated with.

+ *

An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more + * information, see Elastic IP + * Addresses in the Amazon Elastic Compute Cloud User Guide.

+ *

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

+ */ export class DisassociateAddressCommand extends $Command< DisassociateAddressCommandInput, DisassociateAddressCommandOutput, @@ -34,6 +41,9 @@ export class DisassociateAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateClientVpnTargetNetworkCommand.ts b/clients/client-ec2/commands/DisassociateClientVpnTargetNetworkCommand.ts index 141a5c85a42fe..fd3cbb8316286 100644 --- a/clients/client-ec2/commands/DisassociateClientVpnTargetNetworkCommand.ts +++ b/clients/client-ec2/commands/DisassociateClientVpnTargetNetworkCommand.ts @@ -24,6 +24,25 @@ export type DisassociateClientVpnTargetNetworkCommandInput = DisassociateClientV export type DisassociateClientVpnTargetNetworkCommandOutput = DisassociateClientVpnTargetNetworkResult & __MetadataBearer; +/** + *

Disassociates a target network from the specified Client VPN endpoint. When you disassociate the + * last target network from a Client VPN, the following happens:

+ *
    + *
  • + *

    The route that was automatically added for the VPC is deleted

    + *
  • + *
  • + *

    All active client connections are terminated

    + *
  • + *
  • + *

    New client connections are disallowed

    + *
  • + *
  • + *

    The Client VPN endpoint's status changes to pending-associate + *

    + *
  • + *
+ */ export class DisassociateClientVpnTargetNetworkCommand extends $Command< DisassociateClientVpnTargetNetworkCommandInput, DisassociateClientVpnTargetNetworkCommandOutput, @@ -38,6 +57,9 @@ export class DisassociateClientVpnTargetNetworkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateEnclaveCertificateIamRoleCommand.ts b/clients/client-ec2/commands/DisassociateEnclaveCertificateIamRoleCommand.ts index 94c4e7d841599..b4506193cdd7e 100644 --- a/clients/client-ec2/commands/DisassociateEnclaveCertificateIamRoleCommand.ts +++ b/clients/client-ec2/commands/DisassociateEnclaveCertificateIamRoleCommand.ts @@ -24,6 +24,13 @@ export type DisassociateEnclaveCertificateIamRoleCommandInput = DisassociateEncl export type DisassociateEnclaveCertificateIamRoleCommandOutput = DisassociateEnclaveCertificateIamRoleResult & __MetadataBearer; +/** + *

Disassociates an IAM role from an AWS Certificate Manager (ACM) certificate. Disassociating an IAM role + * from an ACM certificate removes the Amazon S3 object that contains the certificate, certificate chain, and + * encrypted private key from the Amazon S3 bucket. It also revokes the IAM role's permission to use the + * AWS Key Management Service (KMS) customer master key (CMK) used to encrypt the private key. This effectively revokes the role's + * permission to use the certificate.

+ */ export class DisassociateEnclaveCertificateIamRoleCommand extends $Command< DisassociateEnclaveCertificateIamRoleCommandInput, DisassociateEnclaveCertificateIamRoleCommandOutput, @@ -38,6 +45,9 @@ export class DisassociateEnclaveCertificateIamRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateIamInstanceProfileCommand.ts b/clients/client-ec2/commands/DisassociateIamInstanceProfileCommand.ts index 435900e303589..505c70a7f9c16 100644 --- a/clients/client-ec2/commands/DisassociateIamInstanceProfileCommand.ts +++ b/clients/client-ec2/commands/DisassociateIamInstanceProfileCommand.ts @@ -20,6 +20,11 @@ import { export type DisassociateIamInstanceProfileCommandInput = DisassociateIamInstanceProfileRequest; export type DisassociateIamInstanceProfileCommandOutput = DisassociateIamInstanceProfileResult & __MetadataBearer; +/** + *

Disassociates an IAM instance profile from a running or stopped instance.

+ *

Use DescribeIamInstanceProfileAssociations to get the association + * ID.

+ */ export class DisassociateIamInstanceProfileCommand extends $Command< DisassociateIamInstanceProfileCommandInput, DisassociateIamInstanceProfileCommandOutput, @@ -34,6 +39,9 @@ export class DisassociateIamInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateRouteTableCommand.ts b/clients/client-ec2/commands/DisassociateRouteTableCommand.ts index bf7141be58f6a..d7af504ff97ed 100644 --- a/clients/client-ec2/commands/DisassociateRouteTableCommand.ts +++ b/clients/client-ec2/commands/DisassociateRouteTableCommand.ts @@ -20,6 +20,13 @@ import { export type DisassociateRouteTableCommandInput = DisassociateRouteTableRequest; export type DisassociateRouteTableCommandOutput = __MetadataBearer; +/** + *

Disassociates a subnet or gateway from a route table.

+ *

After you perform this action, the subnet no longer uses the routes in the route table. + * Instead, it uses the routes in the VPC's main route table. For more information + * about route tables, see Route + * Tables in the Amazon Virtual Private Cloud User Guide.

+ */ export class DisassociateRouteTableCommand extends $Command< DisassociateRouteTableCommandInput, DisassociateRouteTableCommandOutput, @@ -34,6 +41,9 @@ export class DisassociateRouteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateSubnetCidrBlockCommand.ts b/clients/client-ec2/commands/DisassociateSubnetCidrBlockCommand.ts index be0a71fceac91..6f02e695c36c1 100644 --- a/clients/client-ec2/commands/DisassociateSubnetCidrBlockCommand.ts +++ b/clients/client-ec2/commands/DisassociateSubnetCidrBlockCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateSubnetCidrBlockCommandInput = DisassociateSubnetCidrBlockRequest; export type DisassociateSubnetCidrBlockCommandOutput = DisassociateSubnetCidrBlockResult & __MetadataBearer; +/** + *

Disassociates a CIDR block from a subnet. Currently, you can disassociate an IPv6 CIDR block only. You must detach or delete all gateways and resources that are associated with the CIDR block before you can disassociate it.

+ */ export class DisassociateSubnetCidrBlockCommand extends $Command< DisassociateSubnetCidrBlockCommandInput, DisassociateSubnetCidrBlockCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateSubnetCidrBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateTransitGatewayMulticastDomainCommand.ts b/clients/client-ec2/commands/DisassociateTransitGatewayMulticastDomainCommand.ts index 6c8c59cb9245a..5f6535200167e 100644 --- a/clients/client-ec2/commands/DisassociateTransitGatewayMulticastDomainCommand.ts +++ b/clients/client-ec2/commands/DisassociateTransitGatewayMulticastDomainCommand.ts @@ -24,6 +24,9 @@ export type DisassociateTransitGatewayMulticastDomainCommandInput = Disassociate export type DisassociateTransitGatewayMulticastDomainCommandOutput = DisassociateTransitGatewayMulticastDomainResult & __MetadataBearer; +/** + *

Disassociates the specified subnets from the transit gateway multicast domain.

+ */ export class DisassociateTransitGatewayMulticastDomainCommand extends $Command< DisassociateTransitGatewayMulticastDomainCommandInput, DisassociateTransitGatewayMulticastDomainCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateTransitGatewayMulticastDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateTransitGatewayRouteTableCommand.ts b/clients/client-ec2/commands/DisassociateTransitGatewayRouteTableCommand.ts index cdf732e93202e..1f2051265523d 100644 --- a/clients/client-ec2/commands/DisassociateTransitGatewayRouteTableCommand.ts +++ b/clients/client-ec2/commands/DisassociateTransitGatewayRouteTableCommand.ts @@ -24,6 +24,9 @@ export type DisassociateTransitGatewayRouteTableCommandInput = DisassociateTrans export type DisassociateTransitGatewayRouteTableCommandOutput = DisassociateTransitGatewayRouteTableResult & __MetadataBearer; +/** + *

Disassociates a resource attachment from a transit gateway route table.

+ */ export class DisassociateTransitGatewayRouteTableCommand extends $Command< DisassociateTransitGatewayRouteTableCommandInput, DisassociateTransitGatewayRouteTableCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateTransitGatewayRouteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/DisassociateVpcCidrBlockCommand.ts b/clients/client-ec2/commands/DisassociateVpcCidrBlockCommand.ts index 98fe1bdeb3e09..7a6080bda5a16 100644 --- a/clients/client-ec2/commands/DisassociateVpcCidrBlockCommand.ts +++ b/clients/client-ec2/commands/DisassociateVpcCidrBlockCommand.ts @@ -20,6 +20,14 @@ import { export type DisassociateVpcCidrBlockCommandInput = DisassociateVpcCidrBlockRequest; export type DisassociateVpcCidrBlockCommandOutput = DisassociateVpcCidrBlockResult & __MetadataBearer; +/** + *

Disassociates a CIDR block from a VPC. To disassociate the CIDR block, you must + * specify its association ID. You can get the association ID by using + * DescribeVpcs. You must detach or delete all gateways and resources that + * are associated with the CIDR block before you can disassociate it.

+ *

You cannot disassociate the CIDR block with which you originally created the VPC (the + * primary CIDR block).

+ */ export class DisassociateVpcCidrBlockCommand extends $Command< DisassociateVpcCidrBlockCommandInput, DisassociateVpcCidrBlockCommandOutput, @@ -34,6 +42,9 @@ export class DisassociateVpcCidrBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/EnableEbsEncryptionByDefaultCommand.ts b/clients/client-ec2/commands/EnableEbsEncryptionByDefaultCommand.ts index 20364d13dc260..8195ca4f07e46 100644 --- a/clients/client-ec2/commands/EnableEbsEncryptionByDefaultCommand.ts +++ b/clients/client-ec2/commands/EnableEbsEncryptionByDefaultCommand.ts @@ -20,6 +20,20 @@ import { export type EnableEbsEncryptionByDefaultCommandInput = EnableEbsEncryptionByDefaultRequest; export type EnableEbsEncryptionByDefaultCommandOutput = EnableEbsEncryptionByDefaultResult & __MetadataBearer; +/** + *

Enables EBS encryption by default for your account in the current Region.

+ *

After you enable encryption by default, the EBS volumes that you create are + * are always encrypted, either using the default CMK or the CMK that you specified + * when you created each volume. For more information, see Amazon EBS Encryption in the + * Amazon Elastic Compute Cloud User Guide.

+ *

You can specify the default CMK for encryption by default using ModifyEbsDefaultKmsKeyId + * or ResetEbsDefaultKmsKeyId.

+ *

Enabling encryption by default has no effect on the encryption status of your + * existing volumes.

+ *

After you enable encryption by default, you can no longer launch instances + * using instance types that do not support encryption. For more information, see Supported + * instance types.

+ */ export class EnableEbsEncryptionByDefaultCommand extends $Command< EnableEbsEncryptionByDefaultCommandInput, EnableEbsEncryptionByDefaultCommandOutput, @@ -34,6 +48,9 @@ export class EnableEbsEncryptionByDefaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/EnableFastSnapshotRestoresCommand.ts b/clients/client-ec2/commands/EnableFastSnapshotRestoresCommand.ts index 85e8b92aa849f..2ebb4794e5c41 100644 --- a/clients/client-ec2/commands/EnableFastSnapshotRestoresCommand.ts +++ b/clients/client-ec2/commands/EnableFastSnapshotRestoresCommand.ts @@ -20,6 +20,14 @@ import { export type EnableFastSnapshotRestoresCommandInput = EnableFastSnapshotRestoresRequest; export type EnableFastSnapshotRestoresCommandOutput = EnableFastSnapshotRestoresResult & __MetadataBearer; +/** + *

Enables fast snapshot restores for the specified snapshots in the specified Availability Zones.

+ *

You get the full benefit of fast snapshot restores after they enter the enabled state. + * To get the current state of fast snapshot restores, use DescribeFastSnapshotRestores. + * To disable fast snapshot restores, use DisableFastSnapshotRestores.

+ *

For more information, see Amazon EBS fast snapshot + * restore in the Amazon Elastic Compute Cloud User Guide.

+ */ export class EnableFastSnapshotRestoresCommand extends $Command< EnableFastSnapshotRestoresCommandInput, EnableFastSnapshotRestoresCommandOutput, @@ -34,6 +42,9 @@ export class EnableFastSnapshotRestoresCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/EnableTransitGatewayRouteTablePropagationCommand.ts b/clients/client-ec2/commands/EnableTransitGatewayRouteTablePropagationCommand.ts index a0b425487c1d9..7b0a3da148a6e 100644 --- a/clients/client-ec2/commands/EnableTransitGatewayRouteTablePropagationCommand.ts +++ b/clients/client-ec2/commands/EnableTransitGatewayRouteTablePropagationCommand.ts @@ -24,6 +24,10 @@ export type EnableTransitGatewayRouteTablePropagationCommandInput = EnableTransi export type EnableTransitGatewayRouteTablePropagationCommandOutput = EnableTransitGatewayRouteTablePropagationResult & __MetadataBearer; +/** + *

Enables the specified attachment to propagate routes to the specified + * propagation route table.

+ */ export class EnableTransitGatewayRouteTablePropagationCommand extends $Command< EnableTransitGatewayRouteTablePropagationCommandInput, EnableTransitGatewayRouteTablePropagationCommandOutput, @@ -38,6 +42,9 @@ export class EnableTransitGatewayRouteTablePropagationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/EnableVgwRoutePropagationCommand.ts b/clients/client-ec2/commands/EnableVgwRoutePropagationCommand.ts index ef37d6438e9b3..b4c16c2f6738a 100644 --- a/clients/client-ec2/commands/EnableVgwRoutePropagationCommand.ts +++ b/clients/client-ec2/commands/EnableVgwRoutePropagationCommand.ts @@ -20,6 +20,9 @@ import { export type EnableVgwRoutePropagationCommandInput = EnableVgwRoutePropagationRequest; export type EnableVgwRoutePropagationCommandOutput = __MetadataBearer; +/** + *

Enables a virtual private gateway (VGW) to propagate routes to the specified route table of a VPC.

+ */ export class EnableVgwRoutePropagationCommand extends $Command< EnableVgwRoutePropagationCommandInput, EnableVgwRoutePropagationCommandOutput, @@ -34,6 +37,9 @@ export class EnableVgwRoutePropagationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/EnableVolumeIOCommand.ts b/clients/client-ec2/commands/EnableVolumeIOCommand.ts index 4e02217fe4b10..bdfb503a356c6 100644 --- a/clients/client-ec2/commands/EnableVolumeIOCommand.ts +++ b/clients/client-ec2/commands/EnableVolumeIOCommand.ts @@ -17,6 +17,10 @@ import { export type EnableVolumeIOCommandInput = EnableVolumeIORequest; export type EnableVolumeIOCommandOutput = __MetadataBearer; +/** + *

Enables I/O operations for a volume that had I/O operations disabled because the data on + * the volume was potentially inconsistent.

+ */ export class EnableVolumeIOCommand extends $Command< EnableVolumeIOCommandInput, EnableVolumeIOCommandOutput, @@ -31,6 +35,9 @@ export class EnableVolumeIOCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/EnableVpcClassicLinkCommand.ts b/clients/client-ec2/commands/EnableVpcClassicLinkCommand.ts index 2ee9340ddfba5..1812b723d00b9 100644 --- a/clients/client-ec2/commands/EnableVpcClassicLinkCommand.ts +++ b/clients/client-ec2/commands/EnableVpcClassicLinkCommand.ts @@ -20,6 +20,15 @@ import { export type EnableVpcClassicLinkCommandInput = EnableVpcClassicLinkRequest; export type EnableVpcClassicLinkCommandOutput = EnableVpcClassicLinkResult & __MetadataBearer; +/** + *

Enables a VPC for ClassicLink. You can then link EC2-Classic instances to your + * ClassicLink-enabled VPC to allow communication over private IP addresses. You cannot + * enable your VPC for ClassicLink if any of your VPC route tables have existing routes for + * address ranges within the 10.0.0.0/8 IP address range, excluding local + * routes for VPCs in the 10.0.0.0/16 and 10.1.0.0/16 IP address + * ranges. For more information, see ClassicLink in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class EnableVpcClassicLinkCommand extends $Command< EnableVpcClassicLinkCommandInput, EnableVpcClassicLinkCommandOutput, @@ -34,6 +43,9 @@ export class EnableVpcClassicLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/EnableVpcClassicLinkDnsSupportCommand.ts b/clients/client-ec2/commands/EnableVpcClassicLinkDnsSupportCommand.ts index 3e96c98b50f6d..5f9624e033a00 100644 --- a/clients/client-ec2/commands/EnableVpcClassicLinkDnsSupportCommand.ts +++ b/clients/client-ec2/commands/EnableVpcClassicLinkDnsSupportCommand.ts @@ -20,6 +20,15 @@ import { export type EnableVpcClassicLinkDnsSupportCommandInput = EnableVpcClassicLinkDnsSupportRequest; export type EnableVpcClassicLinkDnsSupportCommandOutput = EnableVpcClassicLinkDnsSupportResult & __MetadataBearer; +/** + *

Enables a VPC to support DNS hostname resolution for ClassicLink. If enabled, the DNS + * hostname of a linked EC2-Classic instance resolves to its private IP address when + * addressed from an instance in the VPC to which it's linked. Similarly, the DNS hostname + * of an instance in a VPC resolves to its private IP address when addressed from a linked + * EC2-Classic instance. For more information, see ClassicLink in the + * Amazon Elastic Compute Cloud User Guide.

+ *

You must specify a VPC ID in the request.

+ */ export class EnableVpcClassicLinkDnsSupportCommand extends $Command< EnableVpcClassicLinkDnsSupportCommandInput, EnableVpcClassicLinkDnsSupportCommandOutput, @@ -34,6 +43,9 @@ export class EnableVpcClassicLinkDnsSupportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ExportClientVpnClientCertificateRevocationListCommand.ts b/clients/client-ec2/commands/ExportClientVpnClientCertificateRevocationListCommand.ts index 5f95849e0d409..dfef61ec7a320 100644 --- a/clients/client-ec2/commands/ExportClientVpnClientCertificateRevocationListCommand.ts +++ b/clients/client-ec2/commands/ExportClientVpnClientCertificateRevocationListCommand.ts @@ -24,6 +24,9 @@ export type ExportClientVpnClientCertificateRevocationListCommandInput = ExportC export type ExportClientVpnClientCertificateRevocationListCommandOutput = ExportClientVpnClientCertificateRevocationListResult & __MetadataBearer; +/** + *

Downloads the client certificate revocation list for the specified Client VPN endpoint.

+ */ export class ExportClientVpnClientCertificateRevocationListCommand extends $Command< ExportClientVpnClientCertificateRevocationListCommandInput, ExportClientVpnClientCertificateRevocationListCommandOutput, @@ -38,6 +41,9 @@ export class ExportClientVpnClientCertificateRevocationListCommand extends $Comm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ExportClientVpnClientConfigurationCommand.ts b/clients/client-ec2/commands/ExportClientVpnClientConfigurationCommand.ts index 6ff264b58bdb9..cf0a9255b983a 100644 --- a/clients/client-ec2/commands/ExportClientVpnClientConfigurationCommand.ts +++ b/clients/client-ec2/commands/ExportClientVpnClientConfigurationCommand.ts @@ -24,6 +24,11 @@ export type ExportClientVpnClientConfigurationCommandInput = ExportClientVpnClie export type ExportClientVpnClientConfigurationCommandOutput = ExportClientVpnClientConfigurationResult & __MetadataBearer; +/** + *

Downloads the contents of the Client VPN endpoint configuration file for the specified Client VPN endpoint. The Client VPN endpoint configuration + * file includes the Client VPN endpoint and certificate information clients need to establish a connection + * with the Client VPN endpoint.

+ */ export class ExportClientVpnClientConfigurationCommand extends $Command< ExportClientVpnClientConfigurationCommandInput, ExportClientVpnClientConfigurationCommandOutput, @@ -38,6 +43,9 @@ export class ExportClientVpnClientConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ExportImageCommand.ts b/clients/client-ec2/commands/ExportImageCommand.ts index dc15f5dd6b7df..0b6a32d1f7acd 100644 --- a/clients/client-ec2/commands/ExportImageCommand.ts +++ b/clients/client-ec2/commands/ExportImageCommand.ts @@ -17,6 +17,10 @@ import { export type ExportImageCommandInput = ExportImageRequest; export type ExportImageCommandOutput = ExportImageResult & __MetadataBearer; +/** + *

Exports an Amazon Machine Image (AMI) to a VM file. For more information, see Exporting a VM Directory from an Amazon Machine Image + * (AMI) in the VM Import/Export User Guide.

+ */ export class ExportImageCommand extends $Command< ExportImageCommandInput, ExportImageCommandOutput, @@ -31,6 +35,9 @@ export class ExportImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ExportTransitGatewayRoutesCommand.ts b/clients/client-ec2/commands/ExportTransitGatewayRoutesCommand.ts index 65633472d8a95..0a5b128495865 100644 --- a/clients/client-ec2/commands/ExportTransitGatewayRoutesCommand.ts +++ b/clients/client-ec2/commands/ExportTransitGatewayRoutesCommand.ts @@ -20,6 +20,13 @@ import { export type ExportTransitGatewayRoutesCommandInput = ExportTransitGatewayRoutesRequest; export type ExportTransitGatewayRoutesCommandOutput = ExportTransitGatewayRoutesResult & __MetadataBearer; +/** + *

Exports routes from the specified transit gateway route table to the specified S3 bucket. + * By default, all routes are exported. Alternatively, you can filter by CIDR range.

+ *

The routes are saved to the specified bucket in a JSON file. For more information, see + * Export Route Tables + * to Amazon S3 in Transit Gateways.

+ */ export class ExportTransitGatewayRoutesCommand extends $Command< ExportTransitGatewayRoutesCommandInput, ExportTransitGatewayRoutesCommandOutput, @@ -34,6 +41,9 @@ export class ExportTransitGatewayRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetAssociatedEnclaveCertificateIamRolesCommand.ts b/clients/client-ec2/commands/GetAssociatedEnclaveCertificateIamRolesCommand.ts index 54af17432f209..a544dd1fc6f01 100644 --- a/clients/client-ec2/commands/GetAssociatedEnclaveCertificateIamRolesCommand.ts +++ b/clients/client-ec2/commands/GetAssociatedEnclaveCertificateIamRolesCommand.ts @@ -24,6 +24,12 @@ export type GetAssociatedEnclaveCertificateIamRolesCommandInput = GetAssociatedE export type GetAssociatedEnclaveCertificateIamRolesCommandOutput = GetAssociatedEnclaveCertificateIamRolesResult & __MetadataBearer; +/** + *

Returns the IAM roles that are associated with the specified AWS Certificate Manager (ACM) certificate. + * It also returns the name of the Amazon S3 bucket and the Amazon S3 object key where the certificate, certificate chain, + * and encrypted private key bundle are stored, and the ARN of the AWS Key Management Service (KMS) customer master key (CMK) + * that's used to encrypt the private key.

+ */ export class GetAssociatedEnclaveCertificateIamRolesCommand extends $Command< GetAssociatedEnclaveCertificateIamRolesCommandInput, GetAssociatedEnclaveCertificateIamRolesCommandOutput, @@ -38,6 +44,9 @@ export class GetAssociatedEnclaveCertificateIamRolesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetAssociatedIpv6PoolCidrsCommand.ts b/clients/client-ec2/commands/GetAssociatedIpv6PoolCidrsCommand.ts index a29a076b5ead7..dd62a053dbe98 100644 --- a/clients/client-ec2/commands/GetAssociatedIpv6PoolCidrsCommand.ts +++ b/clients/client-ec2/commands/GetAssociatedIpv6PoolCidrsCommand.ts @@ -20,6 +20,9 @@ import { export type GetAssociatedIpv6PoolCidrsCommandInput = GetAssociatedIpv6PoolCidrsRequest; export type GetAssociatedIpv6PoolCidrsCommandOutput = GetAssociatedIpv6PoolCidrsResult & __MetadataBearer; +/** + *

Gets information about the IPv6 CIDR block associations for a specified IPv6 address pool.

+ */ export class GetAssociatedIpv6PoolCidrsCommand extends $Command< GetAssociatedIpv6PoolCidrsCommandInput, GetAssociatedIpv6PoolCidrsCommandOutput, @@ -34,6 +37,9 @@ export class GetAssociatedIpv6PoolCidrsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetCapacityReservationUsageCommand.ts b/clients/client-ec2/commands/GetCapacityReservationUsageCommand.ts index 3f0a5b602c182..05190b615cf29 100644 --- a/clients/client-ec2/commands/GetCapacityReservationUsageCommand.ts +++ b/clients/client-ec2/commands/GetCapacityReservationUsageCommand.ts @@ -20,6 +20,11 @@ import { export type GetCapacityReservationUsageCommandInput = GetCapacityReservationUsageRequest; export type GetCapacityReservationUsageCommandOutput = GetCapacityReservationUsageResult & __MetadataBearer; +/** + *

Gets usage information about a Capacity Reservation. If the Capacity Reservation is shared, it shows usage information for the Capacity Reservation owner + * and each AWS account that is currently using the shared capacity. If the Capacity Reservation is not shared, it shows only + * the Capacity Reservation owner's usage.

+ */ export class GetCapacityReservationUsageCommand extends $Command< GetCapacityReservationUsageCommandInput, GetCapacityReservationUsageCommandOutput, @@ -34,6 +39,9 @@ export class GetCapacityReservationUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetCoipPoolUsageCommand.ts b/clients/client-ec2/commands/GetCoipPoolUsageCommand.ts index 920b96764ff46..0201c9b0a4c4e 100644 --- a/clients/client-ec2/commands/GetCoipPoolUsageCommand.ts +++ b/clients/client-ec2/commands/GetCoipPoolUsageCommand.ts @@ -20,6 +20,9 @@ import { export type GetCoipPoolUsageCommandInput = GetCoipPoolUsageRequest; export type GetCoipPoolUsageCommandOutput = GetCoipPoolUsageResult & __MetadataBearer; +/** + *

Describes the allocations from the specified customer-owned address pool.

+ */ export class GetCoipPoolUsageCommand extends $Command< GetCoipPoolUsageCommandInput, GetCoipPoolUsageCommandOutput, @@ -34,6 +37,9 @@ export class GetCoipPoolUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetConsoleOutputCommand.ts b/clients/client-ec2/commands/GetConsoleOutputCommand.ts index f7b9f4a368ab7..f47bb7bf69e9e 100644 --- a/clients/client-ec2/commands/GetConsoleOutputCommand.ts +++ b/clients/client-ec2/commands/GetConsoleOutputCommand.ts @@ -20,6 +20,21 @@ import { export type GetConsoleOutputCommandInput = GetConsoleOutputRequest; export type GetConsoleOutputCommandOutput = GetConsoleOutputResult & __MetadataBearer; +/** + *

Gets the console output for the specified instance. For Linux instances, the instance + * console output displays the exact console output that would normally be displayed on a + * physical monitor attached to a computer. For Windows instances, the instance console + * output includes the last three system event log errors.

+ *

By default, the console output returns buffered information that was posted shortly + * after an instance transition state (start, stop, reboot, or terminate). This information + * is available for at least one hour after the most recent post. Only the most recent 64 + * KB of console output is available.

+ *

You can optionally retrieve the latest serial console output at any time during the + * instance lifecycle. This option is supported on instance types that use the Nitro + * hypervisor.

+ *

For more information, see Instance + * Console Output in the Amazon Elastic Compute Cloud User Guide.

+ */ export class GetConsoleOutputCommand extends $Command< GetConsoleOutputCommandInput, GetConsoleOutputCommandOutput, @@ -34,6 +49,9 @@ export class GetConsoleOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetConsoleScreenshotCommand.ts b/clients/client-ec2/commands/GetConsoleScreenshotCommand.ts index b3a4265fa0756..db9cbf0977115 100644 --- a/clients/client-ec2/commands/GetConsoleScreenshotCommand.ts +++ b/clients/client-ec2/commands/GetConsoleScreenshotCommand.ts @@ -20,6 +20,11 @@ import { export type GetConsoleScreenshotCommandInput = GetConsoleScreenshotRequest; export type GetConsoleScreenshotCommandOutput = GetConsoleScreenshotResult & __MetadataBearer; +/** + *

Retrieve a JPG-format screenshot of a running instance to help with + * troubleshooting.

+ *

The returned content is Base64-encoded.

+ */ export class GetConsoleScreenshotCommand extends $Command< GetConsoleScreenshotCommandInput, GetConsoleScreenshotCommandOutput, @@ -34,6 +39,9 @@ export class GetConsoleScreenshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetDefaultCreditSpecificationCommand.ts b/clients/client-ec2/commands/GetDefaultCreditSpecificationCommand.ts index 7050c95564fbb..1d78c7b7e9351 100644 --- a/clients/client-ec2/commands/GetDefaultCreditSpecificationCommand.ts +++ b/clients/client-ec2/commands/GetDefaultCreditSpecificationCommand.ts @@ -20,6 +20,12 @@ import { export type GetDefaultCreditSpecificationCommandInput = GetDefaultCreditSpecificationRequest; export type GetDefaultCreditSpecificationCommandOutput = GetDefaultCreditSpecificationResult & __MetadataBearer; +/** + *

Describes the default credit option for CPU usage of a burstable performance instance family.

+ *

For more information, see Burstable + * performance instances in the Amazon Elastic Compute Cloud User + * Guide.

+ */ export class GetDefaultCreditSpecificationCommand extends $Command< GetDefaultCreditSpecificationCommandInput, GetDefaultCreditSpecificationCommandOutput, @@ -34,6 +40,9 @@ export class GetDefaultCreditSpecificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetEbsDefaultKmsKeyIdCommand.ts b/clients/client-ec2/commands/GetEbsDefaultKmsKeyIdCommand.ts index 0ea23c4f2850b..51ee20192920a 100644 --- a/clients/client-ec2/commands/GetEbsDefaultKmsKeyIdCommand.ts +++ b/clients/client-ec2/commands/GetEbsDefaultKmsKeyIdCommand.ts @@ -20,6 +20,13 @@ import { export type GetEbsDefaultKmsKeyIdCommandInput = GetEbsDefaultKmsKeyIdRequest; export type GetEbsDefaultKmsKeyIdCommandOutput = GetEbsDefaultKmsKeyIdResult & __MetadataBearer; +/** + *

Describes the default customer master key (CMK) for EBS encryption by default for your account in this Region. + * You can change the default CMK for encryption by default using ModifyEbsDefaultKmsKeyId or + * ResetEbsDefaultKmsKeyId.

+ *

For more information, see Amazon EBS Encryption + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class GetEbsDefaultKmsKeyIdCommand extends $Command< GetEbsDefaultKmsKeyIdCommandInput, GetEbsDefaultKmsKeyIdCommandOutput, @@ -34,6 +41,9 @@ export class GetEbsDefaultKmsKeyIdCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetEbsEncryptionByDefaultCommand.ts b/clients/client-ec2/commands/GetEbsEncryptionByDefaultCommand.ts index 377cb49d2a690..dc690fefd7ddd 100644 --- a/clients/client-ec2/commands/GetEbsEncryptionByDefaultCommand.ts +++ b/clients/client-ec2/commands/GetEbsEncryptionByDefaultCommand.ts @@ -21,6 +21,12 @@ import { export type GetEbsEncryptionByDefaultCommandInput = GetEbsEncryptionByDefaultRequest; export type GetEbsEncryptionByDefaultCommandOutput = GetEbsEncryptionByDefaultResult & __MetadataBearer; +/** + *

Describes whether EBS encryption by default is enabled for your account in the current + * Region.

+ *

For more information, see Amazon EBS Encryption + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class GetEbsEncryptionByDefaultCommand extends $Command< GetEbsEncryptionByDefaultCommandInput, GetEbsEncryptionByDefaultCommandOutput, @@ -35,6 +41,9 @@ export class GetEbsEncryptionByDefaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetGroupsForCapacityReservationCommand.ts b/clients/client-ec2/commands/GetGroupsForCapacityReservationCommand.ts index 7388937f9254d..b6571fced5dc1 100644 --- a/clients/client-ec2/commands/GetGroupsForCapacityReservationCommand.ts +++ b/clients/client-ec2/commands/GetGroupsForCapacityReservationCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupsForCapacityReservationCommandInput = GetGroupsForCapacityReservationRequest; export type GetGroupsForCapacityReservationCommandOutput = GetGroupsForCapacityReservationResult & __MetadataBearer; +/** + *

Lists the resource groups to which a Capacity Reservation has been added.

+ */ export class GetGroupsForCapacityReservationCommand extends $Command< GetGroupsForCapacityReservationCommandInput, GetGroupsForCapacityReservationCommandOutput, @@ -34,6 +37,9 @@ export class GetGroupsForCapacityReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetHostReservationPurchasePreviewCommand.ts b/clients/client-ec2/commands/GetHostReservationPurchasePreviewCommand.ts index 4ae09fc47fc42..1d0c1f63e261a 100644 --- a/clients/client-ec2/commands/GetHostReservationPurchasePreviewCommand.ts +++ b/clients/client-ec2/commands/GetHostReservationPurchasePreviewCommand.ts @@ -20,6 +20,13 @@ import { export type GetHostReservationPurchasePreviewCommandInput = GetHostReservationPurchasePreviewRequest; export type GetHostReservationPurchasePreviewCommandOutput = GetHostReservationPurchasePreviewResult & __MetadataBearer; +/** + *

Preview a reservation purchase with configurations that match those of your + * Dedicated Host. You must have active Dedicated Hosts in your account before you purchase + * a reservation.

+ *

This is a preview of the PurchaseHostReservation action and does + * not result in the offering being purchased.

+ */ export class GetHostReservationPurchasePreviewCommand extends $Command< GetHostReservationPurchasePreviewCommandInput, GetHostReservationPurchasePreviewCommandOutput, @@ -34,6 +41,9 @@ export class GetHostReservationPurchasePreviewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetLaunchTemplateDataCommand.ts b/clients/client-ec2/commands/GetLaunchTemplateDataCommand.ts index ddf1eac86a648..eb96a1ad799b1 100644 --- a/clients/client-ec2/commands/GetLaunchTemplateDataCommand.ts +++ b/clients/client-ec2/commands/GetLaunchTemplateDataCommand.ts @@ -20,6 +20,13 @@ import { export type GetLaunchTemplateDataCommandInput = GetLaunchTemplateDataRequest; export type GetLaunchTemplateDataCommandOutput = GetLaunchTemplateDataResult & __MetadataBearer; +/** + *

Retrieves the configuration data of the specified instance. You can use this data + * to create a launch template.

+ *

This action calls on other describe actions to get instance information. Depending on your instance configuration, you may need to allow the following + * actions in your IAM policy: DescribeSpotInstanceRequests, DescribeInstanceCreditSpecifications, DescribeVolumes, DescribeInstanceAttribute, and DescribeElasticGpus. Or, you can allow + * describe* depending on your instance requirements.

+ */ export class GetLaunchTemplateDataCommand extends $Command< GetLaunchTemplateDataCommandInput, GetLaunchTemplateDataCommandOutput, @@ -34,6 +41,9 @@ export class GetLaunchTemplateDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetManagedPrefixListAssociationsCommand.ts b/clients/client-ec2/commands/GetManagedPrefixListAssociationsCommand.ts index 91161434842ce..854d5f79de7af 100644 --- a/clients/client-ec2/commands/GetManagedPrefixListAssociationsCommand.ts +++ b/clients/client-ec2/commands/GetManagedPrefixListAssociationsCommand.ts @@ -20,6 +20,9 @@ import { export type GetManagedPrefixListAssociationsCommandInput = GetManagedPrefixListAssociationsRequest; export type GetManagedPrefixListAssociationsCommandOutput = GetManagedPrefixListAssociationsResult & __MetadataBearer; +/** + *

Gets information about the resources that are associated with the specified managed prefix list.

+ */ export class GetManagedPrefixListAssociationsCommand extends $Command< GetManagedPrefixListAssociationsCommandInput, GetManagedPrefixListAssociationsCommandOutput, @@ -34,6 +37,9 @@ export class GetManagedPrefixListAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetManagedPrefixListEntriesCommand.ts b/clients/client-ec2/commands/GetManagedPrefixListEntriesCommand.ts index cbc01423d14e8..ee04bc363f9cf 100644 --- a/clients/client-ec2/commands/GetManagedPrefixListEntriesCommand.ts +++ b/clients/client-ec2/commands/GetManagedPrefixListEntriesCommand.ts @@ -20,6 +20,9 @@ import { export type GetManagedPrefixListEntriesCommandInput = GetManagedPrefixListEntriesRequest; export type GetManagedPrefixListEntriesCommandOutput = GetManagedPrefixListEntriesResult & __MetadataBearer; +/** + *

Gets information about the entries for a specified managed prefix list.

+ */ export class GetManagedPrefixListEntriesCommand extends $Command< GetManagedPrefixListEntriesCommandInput, GetManagedPrefixListEntriesCommandOutput, @@ -34,6 +37,9 @@ export class GetManagedPrefixListEntriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetPasswordDataCommand.ts b/clients/client-ec2/commands/GetPasswordDataCommand.ts index 899c5d0592c95..1a9b177458b4a 100644 --- a/clients/client-ec2/commands/GetPasswordDataCommand.ts +++ b/clients/client-ec2/commands/GetPasswordDataCommand.ts @@ -17,6 +17,21 @@ import { export type GetPasswordDataCommandInput = GetPasswordDataRequest; export type GetPasswordDataCommandOutput = GetPasswordDataResult & __MetadataBearer; +/** + *

Retrieves the encrypted administrator password for a running Windows instance.

+ *

The Windows password is generated at boot by the EC2Config service or + * EC2Launch scripts (Windows Server 2016 and later). This usually only + * happens the first time an instance is launched. For more information, see EC2Config and EC2Launch in the + * Amazon Elastic Compute Cloud User Guide.

+ *

For the EC2Config service, the password is not generated for rebundled + * AMIs unless Ec2SetPassword is enabled before bundling.

+ *

The password is encrypted using the key pair that you specified when you launched the + * instance. You must provide the corresponding key pair file.

+ *

When you launch an instance, password generation and encryption may take a few + * minutes. If you try to retrieve the password before it's available, the output returns + * an empty string. We recommend that you wait up to 15 minutes after launching an instance + * before trying to retrieve the generated password.

+ */ export class GetPasswordDataCommand extends $Command< GetPasswordDataCommandInput, GetPasswordDataCommandOutput, @@ -31,6 +46,9 @@ export class GetPasswordDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetReservedInstancesExchangeQuoteCommand.ts b/clients/client-ec2/commands/GetReservedInstancesExchangeQuoteCommand.ts index 68c73eadf564f..94f7b909fe032 100644 --- a/clients/client-ec2/commands/GetReservedInstancesExchangeQuoteCommand.ts +++ b/clients/client-ec2/commands/GetReservedInstancesExchangeQuoteCommand.ts @@ -20,6 +20,11 @@ import { export type GetReservedInstancesExchangeQuoteCommandInput = GetReservedInstancesExchangeQuoteRequest; export type GetReservedInstancesExchangeQuoteCommandOutput = GetReservedInstancesExchangeQuoteResult & __MetadataBearer; +/** + *

Returns a quote and exchange information for exchanging one or more specified + * Convertible Reserved Instances for a new Convertible Reserved Instance. If the exchange + * cannot be performed, the reason is returned in the response. Use AcceptReservedInstancesExchangeQuote to perform the exchange.

+ */ export class GetReservedInstancesExchangeQuoteCommand extends $Command< GetReservedInstancesExchangeQuoteCommandInput, GetReservedInstancesExchangeQuoteCommandOutput, @@ -34,6 +39,9 @@ export class GetReservedInstancesExchangeQuoteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetTransitGatewayAttachmentPropagationsCommand.ts b/clients/client-ec2/commands/GetTransitGatewayAttachmentPropagationsCommand.ts index 76d6e4e286891..c39e0734f4267 100644 --- a/clients/client-ec2/commands/GetTransitGatewayAttachmentPropagationsCommand.ts +++ b/clients/client-ec2/commands/GetTransitGatewayAttachmentPropagationsCommand.ts @@ -24,6 +24,9 @@ export type GetTransitGatewayAttachmentPropagationsCommandInput = GetTransitGate export type GetTransitGatewayAttachmentPropagationsCommandOutput = GetTransitGatewayAttachmentPropagationsResult & __MetadataBearer; +/** + *

Lists the route tables to which the specified resource attachment propagates routes.

+ */ export class GetTransitGatewayAttachmentPropagationsCommand extends $Command< GetTransitGatewayAttachmentPropagationsCommandInput, GetTransitGatewayAttachmentPropagationsCommandOutput, @@ -38,6 +41,9 @@ export class GetTransitGatewayAttachmentPropagationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetTransitGatewayMulticastDomainAssociationsCommand.ts b/clients/client-ec2/commands/GetTransitGatewayMulticastDomainAssociationsCommand.ts index a22f96c86221b..f819c8edf1918 100644 --- a/clients/client-ec2/commands/GetTransitGatewayMulticastDomainAssociationsCommand.ts +++ b/clients/client-ec2/commands/GetTransitGatewayMulticastDomainAssociationsCommand.ts @@ -24,6 +24,9 @@ export type GetTransitGatewayMulticastDomainAssociationsCommandInput = GetTransi export type GetTransitGatewayMulticastDomainAssociationsCommandOutput = GetTransitGatewayMulticastDomainAssociationsResult & __MetadataBearer; +/** + *

Gets information about the associations for the transit gateway multicast domain.

+ */ export class GetTransitGatewayMulticastDomainAssociationsCommand extends $Command< GetTransitGatewayMulticastDomainAssociationsCommandInput, GetTransitGatewayMulticastDomainAssociationsCommandOutput, @@ -38,6 +41,9 @@ export class GetTransitGatewayMulticastDomainAssociationsCommand extends $Comman // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetTransitGatewayPrefixListReferencesCommand.ts b/clients/client-ec2/commands/GetTransitGatewayPrefixListReferencesCommand.ts index b8df41d7d1e02..90a69682a03c8 100644 --- a/clients/client-ec2/commands/GetTransitGatewayPrefixListReferencesCommand.ts +++ b/clients/client-ec2/commands/GetTransitGatewayPrefixListReferencesCommand.ts @@ -24,6 +24,9 @@ export type GetTransitGatewayPrefixListReferencesCommandInput = GetTransitGatewa export type GetTransitGatewayPrefixListReferencesCommandOutput = GetTransitGatewayPrefixListReferencesResult & __MetadataBearer; +/** + *

Gets information about the prefix list references in a specified transit gateway route table.

+ */ export class GetTransitGatewayPrefixListReferencesCommand extends $Command< GetTransitGatewayPrefixListReferencesCommandInput, GetTransitGatewayPrefixListReferencesCommandOutput, @@ -38,6 +41,9 @@ export class GetTransitGatewayPrefixListReferencesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetTransitGatewayRouteTableAssociationsCommand.ts b/clients/client-ec2/commands/GetTransitGatewayRouteTableAssociationsCommand.ts index 81326b05524f5..0e5c914056f0c 100644 --- a/clients/client-ec2/commands/GetTransitGatewayRouteTableAssociationsCommand.ts +++ b/clients/client-ec2/commands/GetTransitGatewayRouteTableAssociationsCommand.ts @@ -24,6 +24,9 @@ export type GetTransitGatewayRouteTableAssociationsCommandInput = GetTransitGate export type GetTransitGatewayRouteTableAssociationsCommandOutput = GetTransitGatewayRouteTableAssociationsResult & __MetadataBearer; +/** + *

Gets information about the associations for the specified transit gateway route table.

+ */ export class GetTransitGatewayRouteTableAssociationsCommand extends $Command< GetTransitGatewayRouteTableAssociationsCommandInput, GetTransitGatewayRouteTableAssociationsCommandOutput, @@ -38,6 +41,9 @@ export class GetTransitGatewayRouteTableAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/GetTransitGatewayRouteTablePropagationsCommand.ts b/clients/client-ec2/commands/GetTransitGatewayRouteTablePropagationsCommand.ts index f43e152d22b4f..d3e7c3b39ceac 100644 --- a/clients/client-ec2/commands/GetTransitGatewayRouteTablePropagationsCommand.ts +++ b/clients/client-ec2/commands/GetTransitGatewayRouteTablePropagationsCommand.ts @@ -24,6 +24,9 @@ export type GetTransitGatewayRouteTablePropagationsCommandInput = GetTransitGate export type GetTransitGatewayRouteTablePropagationsCommandOutput = GetTransitGatewayRouteTablePropagationsResult & __MetadataBearer; +/** + *

Gets information about the route table propagations for the specified transit gateway route table.

+ */ export class GetTransitGatewayRouteTablePropagationsCommand extends $Command< GetTransitGatewayRouteTablePropagationsCommandInput, GetTransitGatewayRouteTablePropagationsCommandOutput, @@ -38,6 +41,9 @@ export class GetTransitGatewayRouteTablePropagationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ImportClientVpnClientCertificateRevocationListCommand.ts b/clients/client-ec2/commands/ImportClientVpnClientCertificateRevocationListCommand.ts index fcc0b27459a2a..929ab3dcb21a1 100644 --- a/clients/client-ec2/commands/ImportClientVpnClientCertificateRevocationListCommand.ts +++ b/clients/client-ec2/commands/ImportClientVpnClientCertificateRevocationListCommand.ts @@ -24,6 +24,10 @@ export type ImportClientVpnClientCertificateRevocationListCommandInput = ImportC export type ImportClientVpnClientCertificateRevocationListCommandOutput = ImportClientVpnClientCertificateRevocationListResult & __MetadataBearer; +/** + *

Uploads a client certificate revocation list to the specified Client VPN endpoint. Uploading a client certificate revocation list overwrites the existing client certificate revocation list.

+ *

Uploading a client certificate revocation list resets existing client connections.

+ */ export class ImportClientVpnClientCertificateRevocationListCommand extends $Command< ImportClientVpnClientCertificateRevocationListCommandInput, ImportClientVpnClientCertificateRevocationListCommandOutput, @@ -38,6 +42,9 @@ export class ImportClientVpnClientCertificateRevocationListCommand extends $Comm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ImportImageCommand.ts b/clients/client-ec2/commands/ImportImageCommand.ts index d2bbeeffdbca4..4789d154154ff 100644 --- a/clients/client-ec2/commands/ImportImageCommand.ts +++ b/clients/client-ec2/commands/ImportImageCommand.ts @@ -17,6 +17,11 @@ import { export type ImportImageCommandInput = ImportImageRequest; export type ImportImageCommandOutput = ImportImageResult & __MetadataBearer; +/** + *

Import single or multi-volume disk images or EBS snapshots into an Amazon Machine Image (AMI). For more + * information, see Importing a VM as an + * Image Using VM Import/Export in the VM Import/Export User Guide.

+ */ export class ImportImageCommand extends $Command< ImportImageCommandInput, ImportImageCommandOutput, @@ -31,6 +36,9 @@ export class ImportImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ImportInstanceCommand.ts b/clients/client-ec2/commands/ImportInstanceCommand.ts index 5d2211f81ef3c..b27e6fb2cace0 100644 --- a/clients/client-ec2/commands/ImportInstanceCommand.ts +++ b/clients/client-ec2/commands/ImportInstanceCommand.ts @@ -17,6 +17,13 @@ import { export type ImportInstanceCommandInput = ImportInstanceRequest; export type ImportInstanceCommandOutput = ImportInstanceResult & __MetadataBearer; +/** + *

Creates an import instance task using metadata from the specified disk image. ImportInstance only + * supports single-volume VMs. To import multi-volume VMs, use ImportImage. For more information, see + * Importing a + * Virtual Machine Using the Amazon EC2 CLI.

+ *

For information about the import manifest referenced by this API action, see VM Import Manifest.

+ */ export class ImportInstanceCommand extends $Command< ImportInstanceCommandInput, ImportInstanceCommandOutput, @@ -31,6 +38,9 @@ export class ImportInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ImportKeyPairCommand.ts b/clients/client-ec2/commands/ImportKeyPairCommand.ts index ebe20af71ac80..222ba83ef9a52 100644 --- a/clients/client-ec2/commands/ImportKeyPairCommand.ts +++ b/clients/client-ec2/commands/ImportKeyPairCommand.ts @@ -17,6 +17,14 @@ import { export type ImportKeyPairCommandInput = ImportKeyPairRequest; export type ImportKeyPairCommandOutput = ImportKeyPairResult & __MetadataBearer; +/** + *

Imports the public key from an RSA key pair that you created with a third-party tool. + * Compare this with CreateKeyPair, in which AWS creates the key pair and gives the keys to you + * (AWS keeps a copy of the public key). With ImportKeyPair, you create the key pair and give AWS just the public key. + * The private key is never transferred between you and AWS.

+ *

For more information about key pairs, see Key Pairs + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class ImportKeyPairCommand extends $Command< ImportKeyPairCommandInput, ImportKeyPairCommandOutput, @@ -31,6 +39,9 @@ export class ImportKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ImportSnapshotCommand.ts b/clients/client-ec2/commands/ImportSnapshotCommand.ts index f17d18d5a1d10..bc086810b1a54 100644 --- a/clients/client-ec2/commands/ImportSnapshotCommand.ts +++ b/clients/client-ec2/commands/ImportSnapshotCommand.ts @@ -17,6 +17,9 @@ import { export type ImportSnapshotCommandInput = ImportSnapshotRequest; export type ImportSnapshotCommandOutput = ImportSnapshotResult & __MetadataBearer; +/** + *

Imports a disk into an EBS snapshot.

+ */ export class ImportSnapshotCommand extends $Command< ImportSnapshotCommandInput, ImportSnapshotCommandOutput, @@ -31,6 +34,9 @@ export class ImportSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ImportVolumeCommand.ts b/clients/client-ec2/commands/ImportVolumeCommand.ts index 68a4fc81990ba..6861e86dd8905 100644 --- a/clients/client-ec2/commands/ImportVolumeCommand.ts +++ b/clients/client-ec2/commands/ImportVolumeCommand.ts @@ -17,6 +17,11 @@ import { export type ImportVolumeCommandInput = ImportVolumeRequest; export type ImportVolumeCommandOutput = ImportVolumeResult & __MetadataBearer; +/** + *

Creates an import volume task using metadata from the specified disk image.For more information, see Importing + * Disks to Amazon EBS.

+ *

For information about the import manifest referenced by this API action, see VM Import Manifest.

+ */ export class ImportVolumeCommand extends $Command< ImportVolumeCommandInput, ImportVolumeCommandOutput, @@ -31,6 +36,9 @@ export class ImportVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyAvailabilityZoneGroupCommand.ts b/clients/client-ec2/commands/ModifyAvailabilityZoneGroupCommand.ts index b0f70db483f75..1bba3a4fdcae2 100644 --- a/clients/client-ec2/commands/ModifyAvailabilityZoneGroupCommand.ts +++ b/clients/client-ec2/commands/ModifyAvailabilityZoneGroupCommand.ts @@ -20,6 +20,12 @@ import { export type ModifyAvailabilityZoneGroupCommandInput = ModifyAvailabilityZoneGroupRequest; export type ModifyAvailabilityZoneGroupCommandOutput = ModifyAvailabilityZoneGroupResult & __MetadataBearer; +/** + *

Changes the opt-in status of the Local Zone and Wavelength Zone group for your + * account.

+ *

Use + * DescribeAvailabilityZones to view the value for GroupName.

+ */ export class ModifyAvailabilityZoneGroupCommand extends $Command< ModifyAvailabilityZoneGroupCommandInput, ModifyAvailabilityZoneGroupCommandOutput, @@ -34,6 +40,9 @@ export class ModifyAvailabilityZoneGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyCapacityReservationCommand.ts b/clients/client-ec2/commands/ModifyCapacityReservationCommand.ts index 8a7c1108ed912..b307de4fae247 100644 --- a/clients/client-ec2/commands/ModifyCapacityReservationCommand.ts +++ b/clients/client-ec2/commands/ModifyCapacityReservationCommand.ts @@ -20,6 +20,13 @@ import { export type ModifyCapacityReservationCommandInput = ModifyCapacityReservationRequest; export type ModifyCapacityReservationCommandOutput = ModifyCapacityReservationResult & __MetadataBearer; +/** + *

Modifies a Capacity Reservation's capacity and the conditions under which it is to be released. You + * cannot change a Capacity Reservation's instance type, EBS optimization, instance store settings, + * platform, Availability Zone, or instance eligibility. If you need to modify any of these + * attributes, we recommend that you cancel the Capacity Reservation, and then create a new one with + * the required attributes.

+ */ export class ModifyCapacityReservationCommand extends $Command< ModifyCapacityReservationCommandInput, ModifyCapacityReservationCommandOutput, @@ -34,6 +41,9 @@ export class ModifyCapacityReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyClientVpnEndpointCommand.ts b/clients/client-ec2/commands/ModifyClientVpnEndpointCommand.ts index 4b54dcef58dba..2a2757e9f8c98 100644 --- a/clients/client-ec2/commands/ModifyClientVpnEndpointCommand.ts +++ b/clients/client-ec2/commands/ModifyClientVpnEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyClientVpnEndpointCommandInput = ModifyClientVpnEndpointRequest; export type ModifyClientVpnEndpointCommandOutput = ModifyClientVpnEndpointResult & __MetadataBearer; +/** + *

Modifies the specified Client VPN endpoint. Modifying the DNS server resets existing client connections.

+ */ export class ModifyClientVpnEndpointCommand extends $Command< ModifyClientVpnEndpointCommandInput, ModifyClientVpnEndpointCommandOutput, @@ -34,6 +37,9 @@ export class ModifyClientVpnEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyDefaultCreditSpecificationCommand.ts b/clients/client-ec2/commands/ModifyDefaultCreditSpecificationCommand.ts index 51f19aa6b246c..7b3192f90c49f 100644 --- a/clients/client-ec2/commands/ModifyDefaultCreditSpecificationCommand.ts +++ b/clients/client-ec2/commands/ModifyDefaultCreditSpecificationCommand.ts @@ -20,6 +20,22 @@ import { export type ModifyDefaultCreditSpecificationCommandInput = ModifyDefaultCreditSpecificationRequest; export type ModifyDefaultCreditSpecificationCommandOutput = ModifyDefaultCreditSpecificationResult & __MetadataBearer; +/** + *

Modifies the default credit option for CPU usage of burstable performance instances. + * The default credit option is set at the account level per AWS Region, and is specified + * per instance family. All new burstable performance instances in the account launch using + * the default credit option.

+ *

+ * ModifyDefaultCreditSpecification is an asynchronous operation, which works at an AWS + * Region level and modifies the credit option for each Availability Zone. All zones in a + * Region are updated within five minutes. But if instances are launched during this + * operation, they might not get the new credit option until the zone is updated. To verify + * whether the update has occurred, you can call GetDefaultCreditSpecification and check + * DefaultCreditSpecification for updates.

+ *

For more information, see Burstable + * performance instances in the Amazon Elastic Compute Cloud User + * Guide.

+ */ export class ModifyDefaultCreditSpecificationCommand extends $Command< ModifyDefaultCreditSpecificationCommandInput, ModifyDefaultCreditSpecificationCommandOutput, @@ -34,6 +50,9 @@ export class ModifyDefaultCreditSpecificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyEbsDefaultKmsKeyIdCommand.ts b/clients/client-ec2/commands/ModifyEbsDefaultKmsKeyIdCommand.ts index a29314b1d0ca6..6c80d8e9b02c4 100644 --- a/clients/client-ec2/commands/ModifyEbsDefaultKmsKeyIdCommand.ts +++ b/clients/client-ec2/commands/ModifyEbsDefaultKmsKeyIdCommand.ts @@ -20,6 +20,16 @@ import { export type ModifyEbsDefaultKmsKeyIdCommandInput = ModifyEbsDefaultKmsKeyIdRequest; export type ModifyEbsDefaultKmsKeyIdCommandOutput = ModifyEbsDefaultKmsKeyIdResult & __MetadataBearer; +/** + *

Changes the default customer master key (CMK) for EBS encryption by default for your account in this Region.

+ *

AWS creates a unique AWS managed CMK in each Region for use with encryption by default. If + * you change the default CMK to a symmetric customer managed CMK, it is used instead of the AWS + * managed CMK. To reset the default CMK to the AWS managed CMK for EBS, use ResetEbsDefaultKmsKeyId. Amazon EBS does not support asymmetric CMKs.

+ *

If you delete or disable the customer managed CMK that you specified for use with + * encryption by default, your instances will fail to launch.

+ *

For more information, see Amazon EBS Encryption + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class ModifyEbsDefaultKmsKeyIdCommand extends $Command< ModifyEbsDefaultKmsKeyIdCommandInput, ModifyEbsDefaultKmsKeyIdCommandOutput, @@ -34,6 +44,9 @@ export class ModifyEbsDefaultKmsKeyIdCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyFleetCommand.ts b/clients/client-ec2/commands/ModifyFleetCommand.ts index fbac63cea6e84..828e2859743d0 100644 --- a/clients/client-ec2/commands/ModifyFleetCommand.ts +++ b/clients/client-ec2/commands/ModifyFleetCommand.ts @@ -17,6 +17,30 @@ import { export type ModifyFleetCommandInput = ModifyFleetRequest; export type ModifyFleetCommandOutput = ModifyFleetResult & __MetadataBearer; +/** + *

Modifies the specified EC2 Fleet.

+ *

You can only modify an EC2 Fleet request of type maintain.

+ *

While the EC2 Fleet is being modified, it is in the modifying state.

+ *

To scale up your EC2 Fleet, increase its target capacity. The EC2 Fleet launches the additional + * Spot Instances according to the allocation strategy for the EC2 Fleet request. If the allocation + * strategy is lowest-price, the EC2 Fleet launches instances using the Spot Instance + * pool with the lowest price. If the allocation strategy is diversified, the + * EC2 Fleet distributes the instances across the Spot Instance pools. If the allocation strategy + * is capacity-optimized, EC2 Fleet launches instances from Spot Instance pools with optimal + * capacity for the number of instances that are launching.

+ *

To scale down your EC2 Fleet, decrease its target capacity. First, the EC2 Fleet cancels any open + * requests that exceed the new target capacity. You can request that the EC2 Fleet terminate Spot + * Instances until the size of the fleet no longer exceeds the new target capacity. If the + * allocation strategy is lowest-price, the EC2 Fleet terminates the instances with + * the highest price per unit. If the allocation strategy is capacity-optimized, + * the EC2 Fleet terminates the instances in the Spot Instance pools that have the least available + * Spot Instance capacity. If the allocation strategy is diversified, the EC2 Fleet terminates + * instances across the Spot Instance pools. Alternatively, you can request that the EC2 Fleet keep + * the fleet at its current size, but not replace any Spot Instances that are interrupted or + * that you terminate manually.

+ *

If you are finished with your EC2 Fleet for now, but will use it again later, you can set the + * target capacity to 0.

+ */ export class ModifyFleetCommand extends $Command< ModifyFleetCommandInput, ModifyFleetCommandOutput, @@ -31,6 +55,9 @@ export class ModifyFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyFpgaImageAttributeCommand.ts b/clients/client-ec2/commands/ModifyFpgaImageAttributeCommand.ts index 4792a3a7439ec..2aa02f1255802 100644 --- a/clients/client-ec2/commands/ModifyFpgaImageAttributeCommand.ts +++ b/clients/client-ec2/commands/ModifyFpgaImageAttributeCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyFpgaImageAttributeCommandInput = ModifyFpgaImageAttributeRequest; export type ModifyFpgaImageAttributeCommandOutput = ModifyFpgaImageAttributeResult & __MetadataBearer; +/** + *

Modifies the specified attribute of the specified Amazon FPGA Image (AFI).

+ */ export class ModifyFpgaImageAttributeCommand extends $Command< ModifyFpgaImageAttributeCommandInput, ModifyFpgaImageAttributeCommandOutput, @@ -34,6 +37,9 @@ export class ModifyFpgaImageAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyHostsCommand.ts b/clients/client-ec2/commands/ModifyHostsCommand.ts index 31cc3e1ac2cae..5cf991a826e87 100644 --- a/clients/client-ec2/commands/ModifyHostsCommand.ts +++ b/clients/client-ec2/commands/ModifyHostsCommand.ts @@ -17,6 +17,16 @@ import { export type ModifyHostsCommandInput = ModifyHostsRequest; export type ModifyHostsCommandOutput = ModifyHostsResult & __MetadataBearer; +/** + *

Modify the auto-placement setting of a Dedicated Host. When auto-placement is enabled, + * any instances that you launch with a tenancy of host but without a specific host + * ID are placed onto any available Dedicated Host in your account that has auto-placement enabled. + * When auto-placement is disabled, you need to provide a host ID to have the instance launch onto + * a specific host. If no host ID is provided, the instance is launched onto a suitable host with + * auto-placement enabled.

+ *

You can also use this API action to modify a Dedicated Host to support either multiple + * instance types in an instance family, or to support a specific instance type only.

+ */ export class ModifyHostsCommand extends $Command< ModifyHostsCommandInput, ModifyHostsCommandOutput, @@ -31,6 +41,9 @@ export class ModifyHostsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyIdFormatCommand.ts b/clients/client-ec2/commands/ModifyIdFormatCommand.ts index 20135dc61c85c..e245feb1f682a 100644 --- a/clients/client-ec2/commands/ModifyIdFormatCommand.ts +++ b/clients/client-ec2/commands/ModifyIdFormatCommand.ts @@ -17,6 +17,32 @@ import { export type ModifyIdFormatCommandInput = ModifyIdFormatRequest; export type ModifyIdFormatCommandOutput = __MetadataBearer; +/** + *

Modifies the ID format for the specified resource on a per-Region basis. You can + * specify that resources should receive longer IDs (17-character IDs) when they are + * created.

+ *

This request can only be used to modify longer ID settings for resource types that + * are within the opt-in period. Resources currently in their opt-in period include: + * bundle | conversion-task | customer-gateway | dhcp-options | + * elastic-ip-allocation | elastic-ip-association | + * export-task | flow-log | image | + * import-task | internet-gateway | network-acl + * | network-acl-association | network-interface | + * network-interface-attachment | prefix-list | + * route-table | route-table-association | + * security-group | subnet | + * subnet-cidr-block-association | vpc | + * vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

+ *

This setting applies to the IAM user who makes the request; it does not apply to the + * entire AWS account. By default, an IAM user defaults to the same settings as the root user. If + * you're using this action as the root user, then these settings apply to the entire account, + * unless an IAM user explicitly overrides these settings for themselves. For more information, + * see Resource IDs + * in the Amazon Elastic Compute Cloud User Guide.

+ *

Resources created with longer IDs are visible to all IAM roles and users, regardless + * of these settings and provided that they have permission to use the relevant + * Describe command for the resource type.

+ */ export class ModifyIdFormatCommand extends $Command< ModifyIdFormatCommandInput, ModifyIdFormatCommandOutput, @@ -31,6 +57,9 @@ export class ModifyIdFormatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyIdentityIdFormatCommand.ts b/clients/client-ec2/commands/ModifyIdentityIdFormatCommand.ts index 38330ee25851d..be8679a2b4fda 100644 --- a/clients/client-ec2/commands/ModifyIdentityIdFormatCommand.ts +++ b/clients/client-ec2/commands/ModifyIdentityIdFormatCommand.ts @@ -20,6 +20,30 @@ import { export type ModifyIdentityIdFormatCommandInput = ModifyIdentityIdFormatRequest; export type ModifyIdentityIdFormatCommandOutput = __MetadataBearer; +/** + *

Modifies the ID format of a resource for a specified IAM user, IAM role, or the root + * user for an account; or all IAM users, IAM roles, and the root user for an account. You can + * specify that resources should receive longer IDs (17-character IDs) when they are created.

+ *

This request can only be used to modify longer ID settings for resource types that are + * within the opt-in period. Resources currently in their opt-in period include: + * bundle | conversion-task | customer-gateway | dhcp-options | + * elastic-ip-allocation | elastic-ip-association | + * export-task | flow-log | image | + * import-task | internet-gateway | network-acl + * | network-acl-association | network-interface | + * network-interface-attachment | prefix-list | + * route-table | route-table-association | + * security-group | subnet | + * subnet-cidr-block-association | vpc | + * vpc-cidr-block-association | vpc-endpoint | vpc-peering-connection | vpn-connection | vpn-gateway.

+ *

For more information, see Resource IDs in the + * Amazon Elastic Compute Cloud User Guide.

+ *

This setting applies to the principal specified in the request; it does not apply to the + * principal that makes the request.

+ *

Resources created with longer IDs are visible to all IAM roles and users, regardless of these + * settings and provided that they have permission to use the relevant Describe + * command for the resource type.

+ */ export class ModifyIdentityIdFormatCommand extends $Command< ModifyIdentityIdFormatCommandInput, ModifyIdentityIdFormatCommandOutput, @@ -34,6 +58,9 @@ export class ModifyIdentityIdFormatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyImageAttributeCommand.ts b/clients/client-ec2/commands/ModifyImageAttributeCommand.ts index 08251d8856a55..1169cc228842e 100644 --- a/clients/client-ec2/commands/ModifyImageAttributeCommand.ts +++ b/clients/client-ec2/commands/ModifyImageAttributeCommand.ts @@ -20,6 +20,14 @@ import { export type ModifyImageAttributeCommandInput = ModifyImageAttributeRequest; export type ModifyImageAttributeCommandOutput = __MetadataBearer; +/** + *

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time. + * You can use the Attribute parameter to specify the attribute or one of the following parameters: + * Description, LaunchPermission, or ProductCode.

+ *

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

+ *

To enable the SriovNetSupport enhanced networking attribute of an image, enable SriovNetSupport on an instance + * and create an AMI from the instance.

+ */ export class ModifyImageAttributeCommand extends $Command< ModifyImageAttributeCommandInput, ModifyImageAttributeCommandOutput, @@ -34,6 +42,9 @@ export class ModifyImageAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyInstanceAttributeCommand.ts b/clients/client-ec2/commands/ModifyInstanceAttributeCommand.ts index 2f5107c14a6bf..e9cf1af41c0d4 100644 --- a/clients/client-ec2/commands/ModifyInstanceAttributeCommand.ts +++ b/clients/client-ec2/commands/ModifyInstanceAttributeCommand.ts @@ -20,6 +20,19 @@ import { export type ModifyInstanceAttributeCommandInput = ModifyInstanceAttributeRequest; export type ModifyInstanceAttributeCommandOutput = __MetadataBearer; +/** + *

Modifies the specified attribute of the specified instance. You can specify only one + * attribute at a time.

+ *

+ * Note: Using this action to change the security groups + * associated with an elastic network interface (ENI) attached to an instance in a VPC can + * result in an error if the instance has more than one ENI. To change the security groups + * associated with an ENI attached to an instance that has multiple ENIs, we recommend that + * you use the ModifyNetworkInterfaceAttribute action.

+ *

To modify some attributes, the instance must be stopped. For more information, see + * Modifying attributes of a stopped instance in the Amazon Elastic + * Compute Cloud User Guide.

+ */ export class ModifyInstanceAttributeCommand extends $Command< ModifyInstanceAttributeCommandInput, ModifyInstanceAttributeCommandOutput, @@ -34,6 +47,9 @@ export class ModifyInstanceAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyInstanceCapacityReservationAttributesCommand.ts b/clients/client-ec2/commands/ModifyInstanceCapacityReservationAttributesCommand.ts index a2f59388ff069..b9093128cb952 100644 --- a/clients/client-ec2/commands/ModifyInstanceCapacityReservationAttributesCommand.ts +++ b/clients/client-ec2/commands/ModifyInstanceCapacityReservationAttributesCommand.ts @@ -24,6 +24,11 @@ export type ModifyInstanceCapacityReservationAttributesCommandInput = ModifyInst export type ModifyInstanceCapacityReservationAttributesCommandOutput = ModifyInstanceCapacityReservationAttributesResult & __MetadataBearer; +/** + *

Modifies the Capacity Reservation settings for a stopped instance. Use this action to configure an + * instance to target a specific Capacity Reservation, run in any open Capacity Reservation with matching + * attributes, or run On-Demand Instance capacity.

+ */ export class ModifyInstanceCapacityReservationAttributesCommand extends $Command< ModifyInstanceCapacityReservationAttributesCommandInput, ModifyInstanceCapacityReservationAttributesCommandOutput, @@ -38,6 +43,9 @@ export class ModifyInstanceCapacityReservationAttributesCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyInstanceCreditSpecificationCommand.ts b/clients/client-ec2/commands/ModifyInstanceCreditSpecificationCommand.ts index 0b0b9900194e0..0c3abc614bb9f 100644 --- a/clients/client-ec2/commands/ModifyInstanceCreditSpecificationCommand.ts +++ b/clients/client-ec2/commands/ModifyInstanceCreditSpecificationCommand.ts @@ -20,6 +20,14 @@ import { export type ModifyInstanceCreditSpecificationCommandInput = ModifyInstanceCreditSpecificationRequest; export type ModifyInstanceCreditSpecificationCommandOutput = ModifyInstanceCreditSpecificationResult & __MetadataBearer; +/** + *

Modifies the credit option for CPU usage on a running or stopped burstable performance + * instance. The credit options are standard and + * unlimited.

+ *

For more information, see Burstable + * performance instances in the Amazon Elastic Compute Cloud User + * Guide.

+ */ export class ModifyInstanceCreditSpecificationCommand extends $Command< ModifyInstanceCreditSpecificationCommandInput, ModifyInstanceCreditSpecificationCommandOutput, @@ -34,6 +42,9 @@ export class ModifyInstanceCreditSpecificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyInstanceEventStartTimeCommand.ts b/clients/client-ec2/commands/ModifyInstanceEventStartTimeCommand.ts index 16e67bf1b6dd0..b88f47ecfad1c 100644 --- a/clients/client-ec2/commands/ModifyInstanceEventStartTimeCommand.ts +++ b/clients/client-ec2/commands/ModifyInstanceEventStartTimeCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyInstanceEventStartTimeCommandInput = ModifyInstanceEventStartTimeRequest; export type ModifyInstanceEventStartTimeCommandOutput = ModifyInstanceEventStartTimeResult & __MetadataBearer; +/** + *

Modifies the start time for a scheduled Amazon EC2 instance event.

+ */ export class ModifyInstanceEventStartTimeCommand extends $Command< ModifyInstanceEventStartTimeCommandInput, ModifyInstanceEventStartTimeCommandOutput, @@ -34,6 +37,9 @@ export class ModifyInstanceEventStartTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyInstanceMetadataOptionsCommand.ts b/clients/client-ec2/commands/ModifyInstanceMetadataOptionsCommand.ts index 9582871b57d71..503ed2dbf430e 100644 --- a/clients/client-ec2/commands/ModifyInstanceMetadataOptionsCommand.ts +++ b/clients/client-ec2/commands/ModifyInstanceMetadataOptionsCommand.ts @@ -20,6 +20,14 @@ import { export type ModifyInstanceMetadataOptionsCommandInput = ModifyInstanceMetadataOptionsRequest; export type ModifyInstanceMetadataOptionsCommandOutput = ModifyInstanceMetadataOptionsResult & __MetadataBearer; +/** + *

Modify the instance metadata parameters on a running or stopped instance. When you + * modify the parameters on a stopped instance, they are applied when the instance is + * started. When you modify the parameters on a running instance, the API responds with a + * state of “pending”. After the parameter modifications are successfully applied to the + * instance, the state of the modifications changes from “pending” to “applied” in + * subsequent describe-instances API calls. For more information, see Instance metadata and user data.

+ */ export class ModifyInstanceMetadataOptionsCommand extends $Command< ModifyInstanceMetadataOptionsCommandInput, ModifyInstanceMetadataOptionsCommandOutput, @@ -34,6 +42,9 @@ export class ModifyInstanceMetadataOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyInstancePlacementCommand.ts b/clients/client-ec2/commands/ModifyInstancePlacementCommand.ts index a99eb36978fa1..46ecd39ace219 100644 --- a/clients/client-ec2/commands/ModifyInstancePlacementCommand.ts +++ b/clients/client-ec2/commands/ModifyInstancePlacementCommand.ts @@ -20,6 +20,36 @@ import { export type ModifyInstancePlacementCommandInput = ModifyInstancePlacementRequest; export type ModifyInstancePlacementCommandOutput = ModifyInstancePlacementResult & __MetadataBearer; +/** + *

Modifies the placement attributes for a specified instance. You can do the + * following:

+ *
    + *
  • + *

    Modify the affinity between an instance and a Dedicated + * Host. When affinity is set to host and the instance is + * not associated with a specific Dedicated Host, the next time the instance is + * launched, it is automatically associated with the host on which it lands. If the + * instance is restarted or rebooted, this relationship persists.

    + *
  • + *
  • + *

    Change the Dedicated Host with which an instance is associated.

    + *
  • + *
  • + *

    Change the instance tenancy of an instance from host to + * dedicated, or from dedicated to + * host.

    + *
  • + *
  • + *

    Move an instance to or from a placement + * group.

    + *
  • + *
+ *

At least one attribute for affinity, host ID, tenancy, or placement group name must + * be specified in the request. Affinity and tenancy can be modified in the same + * request.

+ *

To modify the host ID, tenancy, placement group, or partition for an instance, the + * instance must be in the stopped state.

+ */ export class ModifyInstancePlacementCommand extends $Command< ModifyInstancePlacementCommandInput, ModifyInstancePlacementCommandOutput, @@ -34,6 +64,9 @@ export class ModifyInstancePlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyLaunchTemplateCommand.ts b/clients/client-ec2/commands/ModifyLaunchTemplateCommand.ts index cc6b5be6d8b67..e9fb945d34dc5 100644 --- a/clients/client-ec2/commands/ModifyLaunchTemplateCommand.ts +++ b/clients/client-ec2/commands/ModifyLaunchTemplateCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyLaunchTemplateCommandInput = ModifyLaunchTemplateRequest; export type ModifyLaunchTemplateCommandOutput = ModifyLaunchTemplateResult & __MetadataBearer; +/** + *

Modifies a launch template. You can specify which version of the launch template to + * set as the default version. When launching an instance, the default version applies when + * a launch template version is not specified.

+ */ export class ModifyLaunchTemplateCommand extends $Command< ModifyLaunchTemplateCommandInput, ModifyLaunchTemplateCommandOutput, @@ -34,6 +39,9 @@ export class ModifyLaunchTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyManagedPrefixListCommand.ts b/clients/client-ec2/commands/ModifyManagedPrefixListCommand.ts index 1d0cda7a59ca4..8cc55de17f5cc 100644 --- a/clients/client-ec2/commands/ModifyManagedPrefixListCommand.ts +++ b/clients/client-ec2/commands/ModifyManagedPrefixListCommand.ts @@ -20,6 +20,13 @@ import { export type ModifyManagedPrefixListCommandInput = ModifyManagedPrefixListRequest; export type ModifyManagedPrefixListCommandOutput = ModifyManagedPrefixListResult & __MetadataBearer; +/** + *

Modifies the specified managed prefix list.

+ *

Adding or removing entries in a prefix list creates a new version of the prefix list. + * Changing the name of the prefix list does not affect the version.

+ *

If you specify a current version number that does not match the true current version + * number, the request fails.

+ */ export class ModifyManagedPrefixListCommand extends $Command< ModifyManagedPrefixListCommandInput, ModifyManagedPrefixListCommandOutput, @@ -34,6 +41,9 @@ export class ModifyManagedPrefixListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyNetworkInterfaceAttributeCommand.ts b/clients/client-ec2/commands/ModifyNetworkInterfaceAttributeCommand.ts index ac538e01fa6b4..7d78e4e2067ad 100644 --- a/clients/client-ec2/commands/ModifyNetworkInterfaceAttributeCommand.ts +++ b/clients/client-ec2/commands/ModifyNetworkInterfaceAttributeCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyNetworkInterfaceAttributeCommandInput = ModifyNetworkInterfaceAttributeRequest; export type ModifyNetworkInterfaceAttributeCommandOutput = __MetadataBearer; +/** + *

Modifies the specified network interface attribute. You can specify only one + * attribute at a time. You can use this action to attach and detach security groups from + * an existing EC2 instance.

+ */ export class ModifyNetworkInterfaceAttributeCommand extends $Command< ModifyNetworkInterfaceAttributeCommandInput, ModifyNetworkInterfaceAttributeCommandOutput, @@ -34,6 +39,9 @@ export class ModifyNetworkInterfaceAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyReservedInstancesCommand.ts b/clients/client-ec2/commands/ModifyReservedInstancesCommand.ts index 3b455d570008a..b4036adcded6e 100644 --- a/clients/client-ec2/commands/ModifyReservedInstancesCommand.ts +++ b/clients/client-ec2/commands/ModifyReservedInstancesCommand.ts @@ -20,6 +20,14 @@ import { export type ModifyReservedInstancesCommandInput = ModifyReservedInstancesRequest; export type ModifyReservedInstancesCommandOutput = ModifyReservedInstancesResult & __MetadataBearer; +/** + *

Modifies the Availability Zone, instance count, instance type, or network platform + * (EC2-Classic or EC2-VPC) of your Reserved Instances. The Reserved Instances to be + * modified must be identical, except for Availability Zone, network platform, and instance + * type.

+ *

For more information, see Modifying Reserved + * Instances in the Amazon Elastic Compute Cloud User Guide.

+ */ export class ModifyReservedInstancesCommand extends $Command< ModifyReservedInstancesCommandInput, ModifyReservedInstancesCommandOutput, @@ -34,6 +42,9 @@ export class ModifyReservedInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifySnapshotAttributeCommand.ts b/clients/client-ec2/commands/ModifySnapshotAttributeCommand.ts index 63c5caa12f476..4dbc6ef9b0d82 100644 --- a/clients/client-ec2/commands/ModifySnapshotAttributeCommand.ts +++ b/clients/client-ec2/commands/ModifySnapshotAttributeCommand.ts @@ -20,6 +20,16 @@ import { export type ModifySnapshotAttributeCommandInput = ModifySnapshotAttributeRequest; export type ModifySnapshotAttributeCommandOutput = __MetadataBearer; +/** + *

Adds or removes permission settings for the specified snapshot. You may add or remove + * specified AWS account IDs from a snapshot's list of create volume permissions, but you cannot + * do both in a single operation. If you need to both add and remove account IDs for a snapshot, + * you must use multiple operations. You can make up to 500 modifications to a snapshot in a single operation.

+ *

Encrypted snapshots and snapshots with AWS Marketplace product codes cannot be made + * public. Snapshots encrypted with your default CMK cannot be shared with other accounts.

+ *

For more information about modifying snapshot permissions, see Sharing snapshots in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class ModifySnapshotAttributeCommand extends $Command< ModifySnapshotAttributeCommandInput, ModifySnapshotAttributeCommandOutput, @@ -34,6 +44,9 @@ export class ModifySnapshotAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifySpotFleetRequestCommand.ts b/clients/client-ec2/commands/ModifySpotFleetRequestCommand.ts index 12dac44ae79a7..67d9eb9f7bbb5 100644 --- a/clients/client-ec2/commands/ModifySpotFleetRequestCommand.ts +++ b/clients/client-ec2/commands/ModifySpotFleetRequestCommand.ts @@ -20,6 +20,32 @@ import { export type ModifySpotFleetRequestCommandInput = ModifySpotFleetRequestRequest; export type ModifySpotFleetRequestCommandOutput = ModifySpotFleetRequestResponse & __MetadataBearer; +/** + *

Modifies the specified Spot Fleet request.

+ *

You can only modify a Spot Fleet request of type maintain.

+ *

While the Spot Fleet request is being modified, it is in the modifying state.

+ *

To scale up your Spot Fleet, increase its target capacity. The Spot Fleet launches the + * additional Spot Instances according to the allocation strategy for the Spot Fleet + * request. If the allocation strategy is lowestPrice, the Spot Fleet launches + * instances using the Spot Instance pool with the lowest price. If the allocation strategy + * is diversified, the Spot Fleet distributes the instances across the Spot + * Instance pools. If the allocation strategy is capacityOptimized, Spot Fleet + * launches instances from Spot Instance pools with optimal capacity for the number of instances + * that are launching.

+ *

To scale down your Spot Fleet, decrease its target capacity. First, the Spot Fleet + * cancels any open requests that exceed the new target capacity. You can request that the + * Spot Fleet terminate Spot Instances until the size of the fleet no longer exceeds the + * new target capacity. If the allocation strategy is lowestPrice, the Spot + * Fleet terminates the instances with the highest price per unit. If the allocation + * strategy is capacityOptimized, the Spot Fleet terminates the instances in + * the Spot Instance pools that have the least available Spot Instance capacity. If the allocation + * strategy is diversified, the Spot Fleet terminates instances across the + * Spot Instance pools. Alternatively, you can request that the Spot Fleet keep the fleet + * at its current size, but not replace any Spot Instances that are interrupted or that you + * terminate manually.

+ *

If you are finished with your Spot Fleet for now, but will use it again later, you can set the + * target capacity to 0.

+ */ export class ModifySpotFleetRequestCommand extends $Command< ModifySpotFleetRequestCommandInput, ModifySpotFleetRequestCommandOutput, @@ -34,6 +60,9 @@ export class ModifySpotFleetRequestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifySubnetAttributeCommand.ts b/clients/client-ec2/commands/ModifySubnetAttributeCommand.ts index 2e201abb10bf9..6f311651185f1 100644 --- a/clients/client-ec2/commands/ModifySubnetAttributeCommand.ts +++ b/clients/client-ec2/commands/ModifySubnetAttributeCommand.ts @@ -20,6 +20,9 @@ import { export type ModifySubnetAttributeCommandInput = ModifySubnetAttributeRequest; export type ModifySubnetAttributeCommandOutput = __MetadataBearer; +/** + *

Modifies a subnet attribute. You can only modify one attribute at a time.

+ */ export class ModifySubnetAttributeCommand extends $Command< ModifySubnetAttributeCommandInput, ModifySubnetAttributeCommandOutput, @@ -34,6 +37,9 @@ export class ModifySubnetAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyTrafficMirrorFilterNetworkServicesCommand.ts b/clients/client-ec2/commands/ModifyTrafficMirrorFilterNetworkServicesCommand.ts index 2c8b23356051a..205bf9b439784 100644 --- a/clients/client-ec2/commands/ModifyTrafficMirrorFilterNetworkServicesCommand.ts +++ b/clients/client-ec2/commands/ModifyTrafficMirrorFilterNetworkServicesCommand.ts @@ -24,6 +24,14 @@ export type ModifyTrafficMirrorFilterNetworkServicesCommandInput = ModifyTraffic export type ModifyTrafficMirrorFilterNetworkServicesCommandOutput = ModifyTrafficMirrorFilterNetworkServicesResult & __MetadataBearer; +/** + *

Allows or restricts mirroring network services.

+ *

By default, Amazon DNS network services are not eligible for Traffic Mirror. Use AddNetworkServices to add network services to a Traffic Mirror filter. When a network service is added to the Traffic Mirror filter, all traffic related to that network service will be mirrored. + * When you no longer want to mirror network services, use RemoveNetworkServices to remove the network services from the Traffic Mirror filter. + *

+ *

For information about filter rule properties, see + * Network Services in the Traffic Mirroring User Guide .

+ */ export class ModifyTrafficMirrorFilterNetworkServicesCommand extends $Command< ModifyTrafficMirrorFilterNetworkServicesCommandInput, ModifyTrafficMirrorFilterNetworkServicesCommandOutput, @@ -38,6 +46,9 @@ export class ModifyTrafficMirrorFilterNetworkServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyTrafficMirrorFilterRuleCommand.ts b/clients/client-ec2/commands/ModifyTrafficMirrorFilterRuleCommand.ts index c0a01169deec5..2e7262823e421 100644 --- a/clients/client-ec2/commands/ModifyTrafficMirrorFilterRuleCommand.ts +++ b/clients/client-ec2/commands/ModifyTrafficMirrorFilterRuleCommand.ts @@ -20,6 +20,12 @@ import { export type ModifyTrafficMirrorFilterRuleCommandInput = ModifyTrafficMirrorFilterRuleRequest; export type ModifyTrafficMirrorFilterRuleCommandOutput = ModifyTrafficMirrorFilterRuleResult & __MetadataBearer; +/** + *

Modifies the specified Traffic Mirror rule.

+ *

+ * DestinationCidrBlock and SourceCidrBlock must both be an IPv4 + * range or an IPv6 range.

+ */ export class ModifyTrafficMirrorFilterRuleCommand extends $Command< ModifyTrafficMirrorFilterRuleCommandInput, ModifyTrafficMirrorFilterRuleCommandOutput, @@ -34,6 +40,9 @@ export class ModifyTrafficMirrorFilterRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyTrafficMirrorSessionCommand.ts b/clients/client-ec2/commands/ModifyTrafficMirrorSessionCommand.ts index 80615e80e8f8f..34b8ea38b2359 100644 --- a/clients/client-ec2/commands/ModifyTrafficMirrorSessionCommand.ts +++ b/clients/client-ec2/commands/ModifyTrafficMirrorSessionCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyTrafficMirrorSessionCommandInput = ModifyTrafficMirrorSessionRequest; export type ModifyTrafficMirrorSessionCommandOutput = ModifyTrafficMirrorSessionResult & __MetadataBearer; +/** + *

Modifies a Traffic Mirror session.

+ */ export class ModifyTrafficMirrorSessionCommand extends $Command< ModifyTrafficMirrorSessionCommandInput, ModifyTrafficMirrorSessionCommandOutput, @@ -34,6 +37,9 @@ export class ModifyTrafficMirrorSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyTransitGatewayCommand.ts b/clients/client-ec2/commands/ModifyTransitGatewayCommand.ts index e1c39485e3c7c..49c066c8ecbb2 100644 --- a/clients/client-ec2/commands/ModifyTransitGatewayCommand.ts +++ b/clients/client-ec2/commands/ModifyTransitGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyTransitGatewayCommandInput = ModifyTransitGatewayRequest; export type ModifyTransitGatewayCommandOutput = ModifyTransitGatewayResult & __MetadataBearer; +/** + *

Modifies the specified transit gateway. When you modify a transit gateway, the modified options are applied to new transit gateway attachments only. Your existing transit gateway attachments are not modified.

+ */ export class ModifyTransitGatewayCommand extends $Command< ModifyTransitGatewayCommandInput, ModifyTransitGatewayCommandOutput, @@ -34,6 +37,9 @@ export class ModifyTransitGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyTransitGatewayPrefixListReferenceCommand.ts b/clients/client-ec2/commands/ModifyTransitGatewayPrefixListReferenceCommand.ts index 4f20b1d3760e0..5ab6187522297 100644 --- a/clients/client-ec2/commands/ModifyTransitGatewayPrefixListReferenceCommand.ts +++ b/clients/client-ec2/commands/ModifyTransitGatewayPrefixListReferenceCommand.ts @@ -24,6 +24,9 @@ export type ModifyTransitGatewayPrefixListReferenceCommandInput = ModifyTransitG export type ModifyTransitGatewayPrefixListReferenceCommandOutput = ModifyTransitGatewayPrefixListReferenceResult & __MetadataBearer; +/** + *

Modifies a reference (route) to a prefix list in a specified transit gateway route table.

+ */ export class ModifyTransitGatewayPrefixListReferenceCommand extends $Command< ModifyTransitGatewayPrefixListReferenceCommandInput, ModifyTransitGatewayPrefixListReferenceCommandOutput, @@ -38,6 +41,9 @@ export class ModifyTransitGatewayPrefixListReferenceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyTransitGatewayVpcAttachmentCommand.ts b/clients/client-ec2/commands/ModifyTransitGatewayVpcAttachmentCommand.ts index 3f8f0f48e7ac3..a1634a02af3b9 100644 --- a/clients/client-ec2/commands/ModifyTransitGatewayVpcAttachmentCommand.ts +++ b/clients/client-ec2/commands/ModifyTransitGatewayVpcAttachmentCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyTransitGatewayVpcAttachmentCommandInput = ModifyTransitGatewayVpcAttachmentRequest; export type ModifyTransitGatewayVpcAttachmentCommandOutput = ModifyTransitGatewayVpcAttachmentResult & __MetadataBearer; +/** + *

Modifies the specified VPC attachment.

+ */ export class ModifyTransitGatewayVpcAttachmentCommand extends $Command< ModifyTransitGatewayVpcAttachmentCommandInput, ModifyTransitGatewayVpcAttachmentCommandOutput, @@ -34,6 +37,9 @@ export class ModifyTransitGatewayVpcAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVolumeAttributeCommand.ts b/clients/client-ec2/commands/ModifyVolumeAttributeCommand.ts index 772da6982f684..a2d4c1f08b332 100644 --- a/clients/client-ec2/commands/ModifyVolumeAttributeCommand.ts +++ b/clients/client-ec2/commands/ModifyVolumeAttributeCommand.ts @@ -20,6 +20,15 @@ import { export type ModifyVolumeAttributeCommandInput = ModifyVolumeAttributeRequest; export type ModifyVolumeAttributeCommandOutput = __MetadataBearer; +/** + *

Modifies a volume attribute.

+ *

By default, all I/O operations for the volume are suspended when the data on the volume is + * determined to be potentially inconsistent, to prevent undetectable, latent data corruption. + * The I/O access to the volume can be resumed by first enabling I/O access and then checking the + * data consistency on your volume.

+ *

You can change the default behavior to resume I/O operations. We recommend that you change + * this only for boot volumes or for volumes that are stateless or disposable.

+ */ export class ModifyVolumeAttributeCommand extends $Command< ModifyVolumeAttributeCommandInput, ModifyVolumeAttributeCommandOutput, @@ -34,6 +43,9 @@ export class ModifyVolumeAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVolumeCommand.ts b/clients/client-ec2/commands/ModifyVolumeCommand.ts index 4234420d6c9d9..85ca3b162bfcf 100644 --- a/clients/client-ec2/commands/ModifyVolumeCommand.ts +++ b/clients/client-ec2/commands/ModifyVolumeCommand.ts @@ -17,6 +17,31 @@ import { export type ModifyVolumeCommandInput = ModifyVolumeRequest; export type ModifyVolumeCommandOutput = ModifyVolumeResult & __MetadataBearer; +/** + *

You can modify several parameters of an existing EBS volume, including volume size, volume + * type, and IOPS capacity. If your EBS volume is attached to a current-generation EC2 instance + * type, you may be able to apply these changes without stopping the instance or detaching the + * volume from it. For more information about modifying an EBS volume running Linux, see Modifying the size, IOPS, or + * type of an EBS volume on Linux. For more information about modifying an EBS volume + * running Windows, see Modifying the size, IOPS, or type of an EBS volume on Windows.

+ *

When you complete a resize operation on your volume, you need to extend the volume's + * file-system size to take advantage of the new storage capacity. For information about + * extending a Linux file system, see Extending a Linux + * file system. For information about extending a Windows file system, see Extending a + * Windows file system.

+ *

You can use CloudWatch Events to check the status of a modification to an EBS volume. For + * information about CloudWatch Events, see the Amazon CloudWatch Events User Guide. You can also track the status of a + * modification using DescribeVolumesModifications. For information + * about tracking status changes using either method, see Monitoring volume + * modifications.

+ *

With previous-generation instance types, resizing an EBS volume may require detaching and + * reattaching the volume or stopping and restarting the instance. For more information, see + * Modifying the size, + * IOPS, or type of an EBS volume on Linux and Modifying the size, IOPS, or type of an EBS + * volume on Windows.

+ *

If you reach the maximum volume modification rate per volume limit, you will need to wait + * at least six hours before applying further modifications to the affected EBS volume.

+ */ export class ModifyVolumeCommand extends $Command< ModifyVolumeCommandInput, ModifyVolumeCommandOutput, @@ -31,6 +56,9 @@ export class ModifyVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpcAttributeCommand.ts b/clients/client-ec2/commands/ModifyVpcAttributeCommand.ts index 0780d8fcaf82d..1f48b1aab1dac 100644 --- a/clients/client-ec2/commands/ModifyVpcAttributeCommand.ts +++ b/clients/client-ec2/commands/ModifyVpcAttributeCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyVpcAttributeCommandInput = ModifyVpcAttributeRequest; export type ModifyVpcAttributeCommandOutput = __MetadataBearer; +/** + *

Modifies the specified attribute of the specified VPC.

+ */ export class ModifyVpcAttributeCommand extends $Command< ModifyVpcAttributeCommandInput, ModifyVpcAttributeCommandOutput, @@ -34,6 +37,9 @@ export class ModifyVpcAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpcEndpointCommand.ts b/clients/client-ec2/commands/ModifyVpcEndpointCommand.ts index 8867e633173ca..748ab0d269793 100644 --- a/clients/client-ec2/commands/ModifyVpcEndpointCommand.ts +++ b/clients/client-ec2/commands/ModifyVpcEndpointCommand.ts @@ -20,6 +20,12 @@ import { export type ModifyVpcEndpointCommandInput = ModifyVpcEndpointRequest; export type ModifyVpcEndpointCommandOutput = ModifyVpcEndpointResult & __MetadataBearer; +/** + *

Modifies attributes of a specified VPC endpoint. The attributes that you can modify + * depend on the type of VPC endpoint (interface, gateway, or Gateway Load Balancer). For more information, see + * VPC + * Endpoints in the Amazon Virtual Private Cloud User Guide.

+ */ export class ModifyVpcEndpointCommand extends $Command< ModifyVpcEndpointCommandInput, ModifyVpcEndpointCommandOutput, @@ -34,6 +40,9 @@ export class ModifyVpcEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpcEndpointConnectionNotificationCommand.ts b/clients/client-ec2/commands/ModifyVpcEndpointConnectionNotificationCommand.ts index 0f458a7d2022b..54bbcf7878eb4 100644 --- a/clients/client-ec2/commands/ModifyVpcEndpointConnectionNotificationCommand.ts +++ b/clients/client-ec2/commands/ModifyVpcEndpointConnectionNotificationCommand.ts @@ -24,6 +24,10 @@ export type ModifyVpcEndpointConnectionNotificationCommandInput = ModifyVpcEndpo export type ModifyVpcEndpointConnectionNotificationCommandOutput = ModifyVpcEndpointConnectionNotificationResult & __MetadataBearer; +/** + *

Modifies a connection notification for VPC endpoint or VPC endpoint service. You + * can change the SNS topic for the notification, or the events for which to be notified.

+ */ export class ModifyVpcEndpointConnectionNotificationCommand extends $Command< ModifyVpcEndpointConnectionNotificationCommandInput, ModifyVpcEndpointConnectionNotificationCommandOutput, @@ -38,6 +42,9 @@ export class ModifyVpcEndpointConnectionNotificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpcEndpointServiceConfigurationCommand.ts b/clients/client-ec2/commands/ModifyVpcEndpointServiceConfigurationCommand.ts index c1e2aa08e8a3d..c65df4f9621da 100644 --- a/clients/client-ec2/commands/ModifyVpcEndpointServiceConfigurationCommand.ts +++ b/clients/client-ec2/commands/ModifyVpcEndpointServiceConfigurationCommand.ts @@ -24,6 +24,16 @@ export type ModifyVpcEndpointServiceConfigurationCommandInput = ModifyVpcEndpoin export type ModifyVpcEndpointServiceConfigurationCommandOutput = ModifyVpcEndpointServiceConfigurationResult & __MetadataBearer; +/** + *

Modifies the attributes of your VPC endpoint service configuration. You can change the + * Network Load Balancers or Gateway Load Balancers for your service, and you can specify whether acceptance is + * required for requests to connect to your endpoint service through an interface VPC + * endpoint.

+ *

If you set or modify the private DNS name, you must prove that you own the private DNS + * domain name. For more information, see VPC Endpoint Service + * Private DNS Name Verification in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class ModifyVpcEndpointServiceConfigurationCommand extends $Command< ModifyVpcEndpointServiceConfigurationCommandInput, ModifyVpcEndpointServiceConfigurationCommandOutput, @@ -38,6 +48,9 @@ export class ModifyVpcEndpointServiceConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpcEndpointServicePermissionsCommand.ts b/clients/client-ec2/commands/ModifyVpcEndpointServicePermissionsCommand.ts index 50e1ec35a7e60..64fddd417d527 100644 --- a/clients/client-ec2/commands/ModifyVpcEndpointServicePermissionsCommand.ts +++ b/clients/client-ec2/commands/ModifyVpcEndpointServicePermissionsCommand.ts @@ -24,6 +24,13 @@ export type ModifyVpcEndpointServicePermissionsCommandInput = ModifyVpcEndpointS export type ModifyVpcEndpointServicePermissionsCommandOutput = ModifyVpcEndpointServicePermissionsResult & __MetadataBearer; +/** + *

Modifies the permissions for your VPC endpoint service. You can add or remove permissions for service consumers (IAM users, + * IAM roles, and AWS accounts) to connect to your endpoint service.

+ *

If you grant permissions to all principals, the service is public. Any users who know the name of a + * public service can send a request to attach an endpoint. If the service does not require manual approval, + * attachments are automatically approved.

+ */ export class ModifyVpcEndpointServicePermissionsCommand extends $Command< ModifyVpcEndpointServicePermissionsCommandInput, ModifyVpcEndpointServicePermissionsCommandOutput, @@ -38,6 +45,9 @@ export class ModifyVpcEndpointServicePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpcPeeringConnectionOptionsCommand.ts b/clients/client-ec2/commands/ModifyVpcPeeringConnectionOptionsCommand.ts index fb0241f9f5f9d..66f48196cd903 100644 --- a/clients/client-ec2/commands/ModifyVpcPeeringConnectionOptionsCommand.ts +++ b/clients/client-ec2/commands/ModifyVpcPeeringConnectionOptionsCommand.ts @@ -20,6 +20,30 @@ import { export type ModifyVpcPeeringConnectionOptionsCommandInput = ModifyVpcPeeringConnectionOptionsRequest; export type ModifyVpcPeeringConnectionOptionsCommandOutput = ModifyVpcPeeringConnectionOptionsResult & __MetadataBearer; +/** + *

Modifies the VPC peering connection options on one side of a VPC peering connection. You can do the following:

+ *
    + *
  • + *

    Enable/disable communication over the peering connection between an EC2-Classic instance that's linked to your VPC (using ClassicLink) and instances in the peer VPC.

    + *
  • + *
  • + *

    Enable/disable communication over the peering connection between instances in your VPC and an EC2-Classic instance that's linked to the peer VPC.

    + *
  • + *
  • + *

    Enable/disable the ability to resolve public DNS hostnames to private IP + * addresses when queried from instances in the peer VPC.

    + *
  • + *
+ *

If the peered VPCs are in the same AWS account, you can enable DNS resolution for queries + * from the local VPC. This ensures that queries from the local VPC resolve to private IP + * addresses in the peer VPC. This option is not available if the peered VPCs are in + * different AWS accounts or different Regions. For peered VPCs in different AWS accounts, + * each AWS account owner must initiate a separate request to modify the peering connection + * options. For inter-region peering connections, you must use the Region for the requester + * VPC to modify the requester VPC peering options and the Region for the accepter VPC to + * modify the accepter VPC peering options. To verify which VPCs are the accepter and the + * requester for a VPC peering connection, use the DescribeVpcPeeringConnections command.

+ */ export class ModifyVpcPeeringConnectionOptionsCommand extends $Command< ModifyVpcPeeringConnectionOptionsCommandInput, ModifyVpcPeeringConnectionOptionsCommandOutput, @@ -34,6 +58,9 @@ export class ModifyVpcPeeringConnectionOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpcTenancyCommand.ts b/clients/client-ec2/commands/ModifyVpcTenancyCommand.ts index 08b9a2e21a2e4..9a741d939671d 100644 --- a/clients/client-ec2/commands/ModifyVpcTenancyCommand.ts +++ b/clients/client-ec2/commands/ModifyVpcTenancyCommand.ts @@ -20,6 +20,16 @@ import { export type ModifyVpcTenancyCommandInput = ModifyVpcTenancyRequest; export type ModifyVpcTenancyCommandOutput = ModifyVpcTenancyResult & __MetadataBearer; +/** + *

Modifies the instance tenancy attribute of the specified VPC. You can change the + * instance tenancy attribute of a VPC to default only. You cannot change the + * instance tenancy attribute to dedicated.

+ *

After you modify the tenancy of the VPC, any new instances that you launch into the + * VPC have a tenancy of default, unless you specify otherwise during launch. + * The tenancy of any existing instances in the VPC is not affected.

+ *

For more information, see Dedicated Instances in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class ModifyVpcTenancyCommand extends $Command< ModifyVpcTenancyCommandInput, ModifyVpcTenancyCommandOutput, @@ -34,6 +44,9 @@ export class ModifyVpcTenancyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpnConnectionCommand.ts b/clients/client-ec2/commands/ModifyVpnConnectionCommand.ts index dec7176b7d63a..c5325378b4a79 100644 --- a/clients/client-ec2/commands/ModifyVpnConnectionCommand.ts +++ b/clients/client-ec2/commands/ModifyVpnConnectionCommand.ts @@ -20,6 +20,41 @@ import { export type ModifyVpnConnectionCommandInput = ModifyVpnConnectionRequest; export type ModifyVpnConnectionCommandOutput = ModifyVpnConnectionResult & __MetadataBearer; +/** + *

Modifies the customer gateway or the target gateway of an AWS Site-to-Site VPN connection. To modify the target gateway, the following migration + * options are available:

+ *
    + *
  • + *

    An existing virtual private gateway to a new virtual private gateway

    + *
  • + *
  • + *

    An existing virtual private gateway to a transit gateway

    + *
  • + *
  • + *

    An existing transit gateway to a new transit gateway

    + *
  • + *
  • + *

    An existing transit gateway to a virtual private gateway

    + *
  • + *
+ *

Before you perform the migration to the new gateway, you must configure the new gateway. Use CreateVpnGateway to create a virtual private gateway, or CreateTransitGateway to create a transit gateway.

+ *

This step is required when you migrate from a virtual private gateway with static routes to + * a transit gateway.

+ *

You must delete the static routes before you migrate to the new gateway.

+ * + *

Keep a copy of the static route before you delete it. You will need to add back these + * routes to the transit gateway after the VPN connection migration is complete.

+ * + *

After you migrate to the new gateway, you might need to modify your VPC route table. Use CreateRoute and DeleteRoute to make the changes described in VPN Gateway Target Modification Required VPC Route Table Updates in the AWS Site-to-Site VPN User Guide.

+ *

+ * When the new gateway is a transit gateway, modify the transit gateway route table to allow traffic between the VPC and the AWS Site-to-Site VPN connection. Use CreateTransitGatewayRoute to add the routes.

+ * + *

If you deleted VPN static routes, you must add the static routes to the transit gateway + * route table.

+ *

After you perform this operation, the AWS VPN endpoint's IP addresses on the AWS side and + * the tunnel options remain intact. Your AWS Site-to-Site VPN connection will be temporarily unavailable + * for a brief period while we provision the new endpoints.

+ */ export class ModifyVpnConnectionCommand extends $Command< ModifyVpnConnectionCommandInput, ModifyVpnConnectionCommandOutput, @@ -34,6 +69,9 @@ export class ModifyVpnConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpnConnectionOptionsCommand.ts b/clients/client-ec2/commands/ModifyVpnConnectionOptionsCommand.ts index 408b7cef8b47c..d25438a02b67e 100644 --- a/clients/client-ec2/commands/ModifyVpnConnectionOptionsCommand.ts +++ b/clients/client-ec2/commands/ModifyVpnConnectionOptionsCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyVpnConnectionOptionsCommandInput = ModifyVpnConnectionOptionsRequest; export type ModifyVpnConnectionOptionsCommandOutput = ModifyVpnConnectionOptionsResult & __MetadataBearer; +/** + *

Modifies the connection options for your Site-to-Site VPN connection.

+ *

When you modify the VPN connection options, the VPN endpoint IP addresses on the AWS side do not change, and the tunnel options do not change. Your VPN connection will be temporarily unavailable for a brief period while the VPN connection is updated.

+ */ export class ModifyVpnConnectionOptionsCommand extends $Command< ModifyVpnConnectionOptionsCommandInput, ModifyVpnConnectionOptionsCommandOutput, @@ -34,6 +38,9 @@ export class ModifyVpnConnectionOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpnTunnelCertificateCommand.ts b/clients/client-ec2/commands/ModifyVpnTunnelCertificateCommand.ts index 39efeefefb4a1..8551234e73116 100644 --- a/clients/client-ec2/commands/ModifyVpnTunnelCertificateCommand.ts +++ b/clients/client-ec2/commands/ModifyVpnTunnelCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyVpnTunnelCertificateCommandInput = ModifyVpnTunnelCertificateRequest; export type ModifyVpnTunnelCertificateCommandOutput = ModifyVpnTunnelCertificateResult & __MetadataBearer; +/** + *

Modifies the VPN tunnel endpoint certificate.

+ */ export class ModifyVpnTunnelCertificateCommand extends $Command< ModifyVpnTunnelCertificateCommandInput, ModifyVpnTunnelCertificateCommandOutput, @@ -34,6 +37,9 @@ export class ModifyVpnTunnelCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ModifyVpnTunnelOptionsCommand.ts b/clients/client-ec2/commands/ModifyVpnTunnelOptionsCommand.ts index 4db9cca3c6491..713089d898a42 100644 --- a/clients/client-ec2/commands/ModifyVpnTunnelOptionsCommand.ts +++ b/clients/client-ec2/commands/ModifyVpnTunnelOptionsCommand.ts @@ -20,6 +20,12 @@ import { export type ModifyVpnTunnelOptionsCommandInput = ModifyVpnTunnelOptionsRequest; export type ModifyVpnTunnelOptionsCommandOutput = ModifyVpnTunnelOptionsResult & __MetadataBearer; +/** + *

Modifies the options for a VPN tunnel in an AWS Site-to-Site VPN connection. You can modify + * multiple options for a tunnel in a single request, but you can only modify one tunnel at + * a time. For more information, see Site-to-Site VPN Tunnel Options for Your Site-to-Site VPN + * Connection in the AWS Site-to-Site VPN User Guide.

+ */ export class ModifyVpnTunnelOptionsCommand extends $Command< ModifyVpnTunnelOptionsCommandInput, ModifyVpnTunnelOptionsCommandOutput, @@ -34,6 +40,9 @@ export class ModifyVpnTunnelOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/MonitorInstancesCommand.ts b/clients/client-ec2/commands/MonitorInstancesCommand.ts index 4a209877ce78a..6c7d0251a26c1 100644 --- a/clients/client-ec2/commands/MonitorInstancesCommand.ts +++ b/clients/client-ec2/commands/MonitorInstancesCommand.ts @@ -20,6 +20,13 @@ import { export type MonitorInstancesCommandInput = MonitorInstancesRequest; export type MonitorInstancesCommandOutput = MonitorInstancesResult & __MetadataBearer; +/** + *

Enables detailed monitoring for a running instance. Otherwise, basic monitoring is + * enabled. For more information, see Monitoring your instances and + * volumes in the Amazon Elastic Compute Cloud User + * Guide.

+ *

To disable detailed monitoring, see .

+ */ export class MonitorInstancesCommand extends $Command< MonitorInstancesCommandInput, MonitorInstancesCommandOutput, @@ -34,6 +41,9 @@ export class MonitorInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/MoveAddressToVpcCommand.ts b/clients/client-ec2/commands/MoveAddressToVpcCommand.ts index 0bad4d1447abb..541d94bd319e0 100644 --- a/clients/client-ec2/commands/MoveAddressToVpcCommand.ts +++ b/clients/client-ec2/commands/MoveAddressToVpcCommand.ts @@ -20,6 +20,14 @@ import { export type MoveAddressToVpcCommandInput = MoveAddressToVpcRequest; export type MoveAddressToVpcCommandOutput = MoveAddressToVpcResult & __MetadataBearer; +/** + *

Moves an Elastic IP address from the EC2-Classic platform to the EC2-VPC platform. The + * Elastic IP address must be allocated to your account for more than 24 hours, and it must not + * be associated with an instance. After the Elastic IP address is moved, it is no longer + * available for use in the EC2-Classic platform, unless you move it back using the + * RestoreAddressToClassic request. You cannot move an Elastic IP address that was + * originally allocated for use in the EC2-VPC platform to the EC2-Classic platform.

+ */ export class MoveAddressToVpcCommand extends $Command< MoveAddressToVpcCommandInput, MoveAddressToVpcCommandOutput, @@ -34,6 +42,9 @@ export class MoveAddressToVpcCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ProvisionByoipCidrCommand.ts b/clients/client-ec2/commands/ProvisionByoipCidrCommand.ts index 51fde9072b0c9..72bcffc571c5f 100644 --- a/clients/client-ec2/commands/ProvisionByoipCidrCommand.ts +++ b/clients/client-ec2/commands/ProvisionByoipCidrCommand.ts @@ -20,6 +20,20 @@ import { export type ProvisionByoipCidrCommandInput = ProvisionByoipCidrRequest; export type ProvisionByoipCidrCommandOutput = ProvisionByoipCidrResult & __MetadataBearer; +/** + *

Provisions an IPv4 or IPv6 address range for use with your AWS resources through bring your own IP + * addresses (BYOIP) and creates a corresponding address pool. After the address range is + * provisioned, it is ready to be advertised using AdvertiseByoipCidr.

+ *

AWS verifies that you own the address range and are authorized to advertise it. + * You must ensure that the address range is registered to you and that you created an + * RPKI ROA to authorize Amazon ASNs 16509 and 14618 to advertise the address range. + * For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.

+ *

Provisioning an address range is an asynchronous operation, so the call returns immediately, + * but the address range is not ready to use until its status changes from pending-provision + * to provisioned. To monitor the status of an address range, use DescribeByoipCidrs. + * To allocate an Elastic IP address from your IPv4 address pool, use AllocateAddress + * with either the specific address from the address pool or the ID of the address pool.

+ */ export class ProvisionByoipCidrCommand extends $Command< ProvisionByoipCidrCommandInput, ProvisionByoipCidrCommandOutput, @@ -34,6 +48,9 @@ export class ProvisionByoipCidrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/PurchaseHostReservationCommand.ts b/clients/client-ec2/commands/PurchaseHostReservationCommand.ts index eaea169072c3c..9e984851b35eb 100644 --- a/clients/client-ec2/commands/PurchaseHostReservationCommand.ts +++ b/clients/client-ec2/commands/PurchaseHostReservationCommand.ts @@ -20,6 +20,12 @@ import { export type PurchaseHostReservationCommandInput = PurchaseHostReservationRequest; export type PurchaseHostReservationCommandOutput = PurchaseHostReservationResult & __MetadataBearer; +/** + *

Purchase a reservation with configurations that match those of your Dedicated Host. + * You must have active Dedicated Hosts in your account before you purchase a reservation. + * This action results in the specified reservation being purchased and charged to your + * account.

+ */ export class PurchaseHostReservationCommand extends $Command< PurchaseHostReservationCommandInput, PurchaseHostReservationCommandOutput, @@ -34,6 +40,9 @@ export class PurchaseHostReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/PurchaseReservedInstancesOfferingCommand.ts b/clients/client-ec2/commands/PurchaseReservedInstancesOfferingCommand.ts index 3972f218fa8c3..01181031e48a7 100644 --- a/clients/client-ec2/commands/PurchaseReservedInstancesOfferingCommand.ts +++ b/clients/client-ec2/commands/PurchaseReservedInstancesOfferingCommand.ts @@ -20,6 +20,18 @@ import { export type PurchaseReservedInstancesOfferingCommandInput = PurchaseReservedInstancesOfferingRequest; export type PurchaseReservedInstancesOfferingCommandOutput = PurchaseReservedInstancesOfferingResult & __MetadataBearer; +/** + *

Purchases a Reserved Instance for use with your account. With Reserved Instances, you pay a lower + * hourly rate compared to On-Demand instance pricing.

+ *

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings + * that match your specifications. After you've purchased a Reserved Instance, you can check for your + * new Reserved Instance with DescribeReservedInstances.

+ *

To queue a purchase for a future date and time, specify a purchase time. If you do not specify a + * purchase time, the default is the current time.

+ *

For more information, see Reserved Instances and + * Reserved Instance Marketplace + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class PurchaseReservedInstancesOfferingCommand extends $Command< PurchaseReservedInstancesOfferingCommandInput, PurchaseReservedInstancesOfferingCommandOutput, @@ -34,6 +46,9 @@ export class PurchaseReservedInstancesOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/PurchaseScheduledInstancesCommand.ts b/clients/client-ec2/commands/PurchaseScheduledInstancesCommand.ts index fe1fa34397ad1..15a37d30331e7 100644 --- a/clients/client-ec2/commands/PurchaseScheduledInstancesCommand.ts +++ b/clients/client-ec2/commands/PurchaseScheduledInstancesCommand.ts @@ -20,6 +20,14 @@ import { export type PurchaseScheduledInstancesCommandInput = PurchaseScheduledInstancesRequest; export type PurchaseScheduledInstancesCommandOutput = PurchaseScheduledInstancesResult & __MetadataBearer; +/** + *

Purchases the Scheduled Instances with the specified schedule.

+ *

Scheduled Instances enable you to purchase Amazon EC2 compute capacity by the hour for a one-year term. + * Before you can purchase a Scheduled Instance, you must call DescribeScheduledInstanceAvailability + * to check for available schedules and obtain a purchase token. After you purchase a Scheduled Instance, + * you must call RunScheduledInstances during each scheduled time period.

+ *

After you purchase a Scheduled Instance, you can't cancel, modify, or resell your purchase.

+ */ export class PurchaseScheduledInstancesCommand extends $Command< PurchaseScheduledInstancesCommandInput, PurchaseScheduledInstancesCommandOutput, @@ -34,6 +42,9 @@ export class PurchaseScheduledInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RebootInstancesCommand.ts b/clients/client-ec2/commands/RebootInstancesCommand.ts index 8a4411e39946f..c12364732de44 100644 --- a/clients/client-ec2/commands/RebootInstancesCommand.ts +++ b/clients/client-ec2/commands/RebootInstancesCommand.ts @@ -17,6 +17,17 @@ import { export type RebootInstancesCommandInput = RebootInstancesRequest; export type RebootInstancesCommandOutput = __MetadataBearer; +/** + *

Requests a reboot of the specified instances. This operation is asynchronous; it only + * queues a request to reboot the specified instances. The operation succeeds if the + * instances are valid and belong to you. Requests to reboot terminated instances are + * ignored.

+ *

If an instance does not cleanly shut down within a few minutes, Amazon EC2 performs a + * hard reboot.

+ *

For more information about troubleshooting, see Getting console output and + * rebooting instances in the Amazon Elastic Compute Cloud User + * Guide.

+ */ export class RebootInstancesCommand extends $Command< RebootInstancesCommandInput, RebootInstancesCommandOutput, @@ -31,6 +42,9 @@ export class RebootInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RegisterImageCommand.ts b/clients/client-ec2/commands/RegisterImageCommand.ts index d85bdc491cb2b..0d2404d78e826 100644 --- a/clients/client-ec2/commands/RegisterImageCommand.ts +++ b/clients/client-ec2/commands/RegisterImageCommand.ts @@ -17,6 +17,47 @@ import { export type RegisterImageCommandInput = RegisterImageRequest; export type RegisterImageCommandOutput = RegisterImageResult & __MetadataBearer; +/** + *

Registers an AMI. When you're creating an AMI, this is the final step you must complete + * before you can launch an instance from the AMI. For more information about creating AMIs, see + * Creating your + * own AMIs in the Amazon Elastic Compute Cloud User Guide.

+ * + *

For Amazon EBS-backed instances, CreateImage creates and registers the AMI in a single request, so you don't have to register the AMI yourself.

+ *
+ * + *

You can also use RegisterImage to create an Amazon EBS-backed Linux AMI from + * a snapshot of a root device volume. You specify the snapshot using the block device mapping. + * For more information, see Launching a Linux instance from + * a backup in the Amazon Elastic Compute Cloud User Guide.

+ * + *

If any snapshots have AWS Marketplace product codes, they are copied to the new + * AMI.

+ *

Windows and some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and SUSE + * Linux Enterprise Server (SLES), use the EC2 billing product code associated with an AMI to + * verify the subscription status for package updates. To create a new AMI for operating systems + * that require a billing product code, instead of registering the AMI, do the following to + * preserve the billing product code association:

+ *
    + *
  1. + *

    Launch an instance from an existing AMI with that billing product code.

    + *
  2. + *
  3. + *

    Customize the instance.

    + *
  4. + *
  5. + *

    Create an AMI from the instance using CreateImage.

    + *
  6. + *
+ *

If you purchase a Reserved Instance to apply to an On-Demand Instance that was launched + * from an AMI with a billing product code, make sure that the Reserved Instance has the matching + * billing product code. If you purchase a Reserved Instance without the matching billing product + * code, the Reserved Instance will not be applied to the On-Demand Instance. For information + * about how to obtain the platform details and billing information of an AMI, see Obtaining billing + * information in the Amazon Elastic Compute Cloud User Guide.

+ *

If needed, you can deregister an AMI at any time. Any modifications you make to an AMI backed by an instance store volume invalidates its registration. + * If you make changes to an image, deregister the previous image and register the new image.

+ */ export class RegisterImageCommand extends $Command< RegisterImageCommandInput, RegisterImageCommandOutput, @@ -31,6 +72,9 @@ export class RegisterImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RegisterInstanceEventNotificationAttributesCommand.ts b/clients/client-ec2/commands/RegisterInstanceEventNotificationAttributesCommand.ts index aac28d1b8123f..0b2c2cddf66d5 100644 --- a/clients/client-ec2/commands/RegisterInstanceEventNotificationAttributesCommand.ts +++ b/clients/client-ec2/commands/RegisterInstanceEventNotificationAttributesCommand.ts @@ -24,6 +24,11 @@ export type RegisterInstanceEventNotificationAttributesCommandInput = RegisterIn export type RegisterInstanceEventNotificationAttributesCommandOutput = RegisterInstanceEventNotificationAttributesResult & __MetadataBearer; +/** + *

Registers a set of tag keys to include in scheduled event notifications for your resources. + *

+ *

To remove tags, use .

+ */ export class RegisterInstanceEventNotificationAttributesCommand extends $Command< RegisterInstanceEventNotificationAttributesCommandInput, RegisterInstanceEventNotificationAttributesCommandOutput, @@ -38,6 +43,9 @@ export class RegisterInstanceEventNotificationAttributesCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RegisterTransitGatewayMulticastGroupMembersCommand.ts b/clients/client-ec2/commands/RegisterTransitGatewayMulticastGroupMembersCommand.ts index 74cf206b3cbc5..51873ac4428a3 100644 --- a/clients/client-ec2/commands/RegisterTransitGatewayMulticastGroupMembersCommand.ts +++ b/clients/client-ec2/commands/RegisterTransitGatewayMulticastGroupMembersCommand.ts @@ -24,6 +24,14 @@ export type RegisterTransitGatewayMulticastGroupMembersCommandInput = RegisterTr export type RegisterTransitGatewayMulticastGroupMembersCommandOutput = RegisterTransitGatewayMulticastGroupMembersResult & __MetadataBearer; +/** + *

Registers members (network interfaces) with the transit gateway multicast group. A member is a network interface associated + * with a supported EC2 instance that receives multicast traffic. For information about + * supported instances, see Multicast + * Consideration in Amazon VPC Transit Gateways.

+ *

After you add the members, use SearchTransitGatewayMulticastGroups to verify that the members were added + * to the transit gateway multicast group.

+ */ export class RegisterTransitGatewayMulticastGroupMembersCommand extends $Command< RegisterTransitGatewayMulticastGroupMembersCommandInput, RegisterTransitGatewayMulticastGroupMembersCommandOutput, @@ -38,6 +46,9 @@ export class RegisterTransitGatewayMulticastGroupMembersCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RegisterTransitGatewayMulticastGroupSourcesCommand.ts b/clients/client-ec2/commands/RegisterTransitGatewayMulticastGroupSourcesCommand.ts index 45a6b1ac7044d..7cde36711e7a0 100644 --- a/clients/client-ec2/commands/RegisterTransitGatewayMulticastGroupSourcesCommand.ts +++ b/clients/client-ec2/commands/RegisterTransitGatewayMulticastGroupSourcesCommand.ts @@ -24,6 +24,14 @@ export type RegisterTransitGatewayMulticastGroupSourcesCommandInput = RegisterTr export type RegisterTransitGatewayMulticastGroupSourcesCommandOutput = RegisterTransitGatewayMulticastGroupSourcesResult & __MetadataBearer; +/** + *

Registers sources (network interfaces) with the specified transit gateway multicast group.

+ *

A multicast source is a network interface attached to a supported instance that sends + * multicast traffic. For information about supported instances, see Multicast + * Considerations in Amazon VPC Transit Gateways.

+ *

After you add the source, use SearchTransitGatewayMulticastGroups to verify that the source was added to the multicast + * group.

+ */ export class RegisterTransitGatewayMulticastGroupSourcesCommand extends $Command< RegisterTransitGatewayMulticastGroupSourcesCommandInput, RegisterTransitGatewayMulticastGroupSourcesCommandOutput, @@ -38,6 +46,9 @@ export class RegisterTransitGatewayMulticastGroupSourcesCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RejectTransitGatewayPeeringAttachmentCommand.ts b/clients/client-ec2/commands/RejectTransitGatewayPeeringAttachmentCommand.ts index 371b0aa010ebc..6352c97e5bf16 100644 --- a/clients/client-ec2/commands/RejectTransitGatewayPeeringAttachmentCommand.ts +++ b/clients/client-ec2/commands/RejectTransitGatewayPeeringAttachmentCommand.ts @@ -24,6 +24,9 @@ export type RejectTransitGatewayPeeringAttachmentCommandInput = RejectTransitGat export type RejectTransitGatewayPeeringAttachmentCommandOutput = RejectTransitGatewayPeeringAttachmentResult & __MetadataBearer; +/** + *

Rejects a transit gateway peering attachment request.

+ */ export class RejectTransitGatewayPeeringAttachmentCommand extends $Command< RejectTransitGatewayPeeringAttachmentCommandInput, RejectTransitGatewayPeeringAttachmentCommandOutput, @@ -38,6 +41,9 @@ export class RejectTransitGatewayPeeringAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RejectTransitGatewayVpcAttachmentCommand.ts b/clients/client-ec2/commands/RejectTransitGatewayVpcAttachmentCommand.ts index 89c9fa43d5476..f7358584fbb4c 100644 --- a/clients/client-ec2/commands/RejectTransitGatewayVpcAttachmentCommand.ts +++ b/clients/client-ec2/commands/RejectTransitGatewayVpcAttachmentCommand.ts @@ -20,6 +20,12 @@ import { export type RejectTransitGatewayVpcAttachmentCommandInput = RejectTransitGatewayVpcAttachmentRequest; export type RejectTransitGatewayVpcAttachmentCommandOutput = RejectTransitGatewayVpcAttachmentResult & __MetadataBearer; +/** + *

Rejects a request to attach a VPC to a transit gateway.

+ *

The VPC attachment must be in the pendingAcceptance state. + * Use DescribeTransitGatewayVpcAttachments to view your pending VPC attachment requests. + * Use AcceptTransitGatewayVpcAttachment to accept a VPC attachment request.

+ */ export class RejectTransitGatewayVpcAttachmentCommand extends $Command< RejectTransitGatewayVpcAttachmentCommandInput, RejectTransitGatewayVpcAttachmentCommandOutput, @@ -34,6 +40,9 @@ export class RejectTransitGatewayVpcAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RejectVpcEndpointConnectionsCommand.ts b/clients/client-ec2/commands/RejectVpcEndpointConnectionsCommand.ts index e5f4e762419ad..a09687d5aa640 100644 --- a/clients/client-ec2/commands/RejectVpcEndpointConnectionsCommand.ts +++ b/clients/client-ec2/commands/RejectVpcEndpointConnectionsCommand.ts @@ -20,6 +20,10 @@ import { export type RejectVpcEndpointConnectionsCommandInput = RejectVpcEndpointConnectionsRequest; export type RejectVpcEndpointConnectionsCommandOutput = RejectVpcEndpointConnectionsResult & __MetadataBearer; +/** + *

Rejects one or more VPC endpoint connection requests to your VPC endpoint + * service.

+ */ export class RejectVpcEndpointConnectionsCommand extends $Command< RejectVpcEndpointConnectionsCommandInput, RejectVpcEndpointConnectionsCommandOutput, @@ -34,6 +38,9 @@ export class RejectVpcEndpointConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RejectVpcPeeringConnectionCommand.ts b/clients/client-ec2/commands/RejectVpcPeeringConnectionCommand.ts index 5b453e1617cd2..391c3efbd2970 100644 --- a/clients/client-ec2/commands/RejectVpcPeeringConnectionCommand.ts +++ b/clients/client-ec2/commands/RejectVpcPeeringConnectionCommand.ts @@ -20,6 +20,12 @@ import { export type RejectVpcPeeringConnectionCommandInput = RejectVpcPeeringConnectionRequest; export type RejectVpcPeeringConnectionCommandOutput = RejectVpcPeeringConnectionResult & __MetadataBearer; +/** + *

Rejects a VPC peering connection request. The VPC peering connection must be in the + * pending-acceptance state. Use the DescribeVpcPeeringConnections request + * to view your outstanding VPC peering connection requests. To delete an active VPC peering + * connection, or to delete a VPC peering connection request that you initiated, use DeleteVpcPeeringConnection.

+ */ export class RejectVpcPeeringConnectionCommand extends $Command< RejectVpcPeeringConnectionCommandInput, RejectVpcPeeringConnectionCommandOutput, @@ -34,6 +40,9 @@ export class RejectVpcPeeringConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReleaseAddressCommand.ts b/clients/client-ec2/commands/ReleaseAddressCommand.ts index bbdbc7d3f2e3d..65a8f76c1011e 100644 --- a/clients/client-ec2/commands/ReleaseAddressCommand.ts +++ b/clients/client-ec2/commands/ReleaseAddressCommand.ts @@ -17,6 +17,20 @@ import { export type ReleaseAddressCommandInput = ReleaseAddressRequest; export type ReleaseAddressCommandOutput = __MetadataBearer; +/** + *

Releases the specified Elastic IP address.

+ *

[EC2-Classic, default VPC] Releasing an Elastic IP address automatically disassociates it + * from any instance that it's associated with. To disassociate an Elastic IP address without + * releasing it, use DisassociateAddress.

+ *

[Nondefault VPC] You must use DisassociateAddress to disassociate the Elastic IP address + * before you can release it. Otherwise, Amazon EC2 returns an error (InvalidIPAddress.InUse).

+ *

After releasing an Elastic IP address, it is released to the IP address pool. + * Be sure to update your DNS records and any servers or devices that communicate with the address. + * If you attempt to release an Elastic IP address that you already released, you'll get an + * AuthFailure error if the address is already allocated to another AWS account.

+ *

[EC2-VPC] After you release an Elastic IP address for use in a VPC, you might be able to recover it. + * For more information, see AllocateAddress.

+ */ export class ReleaseAddressCommand extends $Command< ReleaseAddressCommandInput, ReleaseAddressCommandOutput, @@ -31,6 +45,9 @@ export class ReleaseAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReleaseHostsCommand.ts b/clients/client-ec2/commands/ReleaseHostsCommand.ts index 72e75d46d9422..9463902aede56 100644 --- a/clients/client-ec2/commands/ReleaseHostsCommand.ts +++ b/clients/client-ec2/commands/ReleaseHostsCommand.ts @@ -17,6 +17,17 @@ import { export type ReleaseHostsCommandInput = ReleaseHostsRequest; export type ReleaseHostsCommandOutput = ReleaseHostsResult & __MetadataBearer; +/** + *

When you no longer want to use an On-Demand Dedicated Host it can be released. + * On-Demand billing is stopped and the host goes into released state. The + * host ID of Dedicated Hosts that have been released can no longer be specified in another + * request, for example, to modify the host. You must stop or terminate all instances on a + * host before it can be released.

+ *

When Dedicated Hosts are released, it may take some time for them to stop counting + * toward your limit and you may receive capacity errors when trying to allocate new + * Dedicated Hosts. Wait a few minutes and then try again.

+ *

Released hosts still appear in a DescribeHosts response.

+ */ export class ReleaseHostsCommand extends $Command< ReleaseHostsCommandInput, ReleaseHostsCommandOutput, @@ -31,6 +42,9 @@ export class ReleaseHostsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReplaceIamInstanceProfileAssociationCommand.ts b/clients/client-ec2/commands/ReplaceIamInstanceProfileAssociationCommand.ts index 9514431f7cc28..93287695a0fae 100644 --- a/clients/client-ec2/commands/ReplaceIamInstanceProfileAssociationCommand.ts +++ b/clients/client-ec2/commands/ReplaceIamInstanceProfileAssociationCommand.ts @@ -24,6 +24,13 @@ export type ReplaceIamInstanceProfileAssociationCommandInput = ReplaceIamInstanc export type ReplaceIamInstanceProfileAssociationCommandOutput = ReplaceIamInstanceProfileAssociationResult & __MetadataBearer; +/** + *

Replaces an IAM instance profile for the specified running instance. You can use + * this action to change the IAM instance profile that's associated with an instance + * without having to disassociate the existing IAM instance profile first.

+ *

Use DescribeIamInstanceProfileAssociations to get the association + * ID.

+ */ export class ReplaceIamInstanceProfileAssociationCommand extends $Command< ReplaceIamInstanceProfileAssociationCommandInput, ReplaceIamInstanceProfileAssociationCommandOutput, @@ -38,6 +45,9 @@ export class ReplaceIamInstanceProfileAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReplaceNetworkAclAssociationCommand.ts b/clients/client-ec2/commands/ReplaceNetworkAclAssociationCommand.ts index 756c150dc6eca..b17cfdeebe4ec 100644 --- a/clients/client-ec2/commands/ReplaceNetworkAclAssociationCommand.ts +++ b/clients/client-ec2/commands/ReplaceNetworkAclAssociationCommand.ts @@ -20,6 +20,13 @@ import { export type ReplaceNetworkAclAssociationCommandInput = ReplaceNetworkAclAssociationRequest; export type ReplaceNetworkAclAssociationCommandOutput = ReplaceNetworkAclAssociationResult & __MetadataBearer; +/** + *

Changes which network ACL a subnet is associated with. By default when you create a + * subnet, it's automatically associated with the default network ACL. For more + * information, see Network + * ACLs in the Amazon Virtual Private Cloud User Guide.

+ *

This is an idempotent operation.

+ */ export class ReplaceNetworkAclAssociationCommand extends $Command< ReplaceNetworkAclAssociationCommandInput, ReplaceNetworkAclAssociationCommandOutput, @@ -34,6 +41,9 @@ export class ReplaceNetworkAclAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReplaceNetworkAclEntryCommand.ts b/clients/client-ec2/commands/ReplaceNetworkAclEntryCommand.ts index 788d827e5465b..b3cc0a9bf7892 100644 --- a/clients/client-ec2/commands/ReplaceNetworkAclEntryCommand.ts +++ b/clients/client-ec2/commands/ReplaceNetworkAclEntryCommand.ts @@ -20,6 +20,10 @@ import { export type ReplaceNetworkAclEntryCommandInput = ReplaceNetworkAclEntryRequest; export type ReplaceNetworkAclEntryCommandOutput = __MetadataBearer; +/** + *

Replaces an entry (rule) in a network ACL. For more information, see Network ACLs in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class ReplaceNetworkAclEntryCommand extends $Command< ReplaceNetworkAclEntryCommandInput, ReplaceNetworkAclEntryCommandOutput, @@ -34,6 +38,9 @@ export class ReplaceNetworkAclEntryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReplaceRouteCommand.ts b/clients/client-ec2/commands/ReplaceRouteCommand.ts index ee474ad40e48d..879bb4618a0f3 100644 --- a/clients/client-ec2/commands/ReplaceRouteCommand.ts +++ b/clients/client-ec2/commands/ReplaceRouteCommand.ts @@ -17,6 +17,14 @@ import { export type ReplaceRouteCommandInput = ReplaceRouteRequest; export type ReplaceRouteCommandOutput = __MetadataBearer; +/** + *

Replaces an existing route within a route table in a VPC. You must provide only one of + * the following: internet gateway, virtual private gateway, NAT instance, NAT gateway, VPC + * peering connection, network interface, egress-only internet gateway, or transit + * gateway.

+ *

For more information, see Route Tables in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class ReplaceRouteCommand extends $Command< ReplaceRouteCommandInput, ReplaceRouteCommandOutput, @@ -31,6 +39,9 @@ export class ReplaceRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReplaceRouteTableAssociationCommand.ts b/clients/client-ec2/commands/ReplaceRouteTableAssociationCommand.ts index 459661d959023..c39abc97c6656 100644 --- a/clients/client-ec2/commands/ReplaceRouteTableAssociationCommand.ts +++ b/clients/client-ec2/commands/ReplaceRouteTableAssociationCommand.ts @@ -20,6 +20,13 @@ import { export type ReplaceRouteTableAssociationCommandInput = ReplaceRouteTableAssociationRequest; export type ReplaceRouteTableAssociationCommandOutput = ReplaceRouteTableAssociationResult & __MetadataBearer; +/** + *

Changes the route table associated with a given subnet, internet gateway, or virtual private gateway in a VPC. After the operation + * completes, the subnet or gateway uses the routes in the new route table. For more + * information about route tables, see Route + * Tables in the Amazon Virtual Private Cloud User Guide.

+ *

You can also use this operation to change which table is the main route table in the VPC. Specify the main route table's association ID and the route table ID of the new main route table.

+ */ export class ReplaceRouteTableAssociationCommand extends $Command< ReplaceRouteTableAssociationCommandInput, ReplaceRouteTableAssociationCommandOutput, @@ -34,6 +41,9 @@ export class ReplaceRouteTableAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReplaceTransitGatewayRouteCommand.ts b/clients/client-ec2/commands/ReplaceTransitGatewayRouteCommand.ts index 281376ef6d03a..87b82c57e7d4b 100644 --- a/clients/client-ec2/commands/ReplaceTransitGatewayRouteCommand.ts +++ b/clients/client-ec2/commands/ReplaceTransitGatewayRouteCommand.ts @@ -20,6 +20,9 @@ import { export type ReplaceTransitGatewayRouteCommandInput = ReplaceTransitGatewayRouteRequest; export type ReplaceTransitGatewayRouteCommandOutput = ReplaceTransitGatewayRouteResult & __MetadataBearer; +/** + *

Replaces the specified route in the specified transit gateway route table.

+ */ export class ReplaceTransitGatewayRouteCommand extends $Command< ReplaceTransitGatewayRouteCommandInput, ReplaceTransitGatewayRouteCommandOutput, @@ -34,6 +37,9 @@ export class ReplaceTransitGatewayRouteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ReportInstanceStatusCommand.ts b/clients/client-ec2/commands/ReportInstanceStatusCommand.ts index 8caf575ce062a..21da3355744a3 100644 --- a/clients/client-ec2/commands/ReportInstanceStatusCommand.ts +++ b/clients/client-ec2/commands/ReportInstanceStatusCommand.ts @@ -20,6 +20,13 @@ import { export type ReportInstanceStatusCommandInput = ReportInstanceStatusRequest; export type ReportInstanceStatusCommandOutput = __MetadataBearer; +/** + *

Submits feedback about the status of an instance. The instance must be in the + * running state. If your experience with the instance differs from the + * instance status returned by DescribeInstanceStatus, use ReportInstanceStatus to report your experience with the instance. Amazon + * EC2 collects this information to improve the accuracy of status checks.

+ *

Use of this action does not change the value returned by DescribeInstanceStatus.

+ */ export class ReportInstanceStatusCommand extends $Command< ReportInstanceStatusCommandInput, ReportInstanceStatusCommandOutput, @@ -34,6 +41,9 @@ export class ReportInstanceStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RequestSpotFleetCommand.ts b/clients/client-ec2/commands/RequestSpotFleetCommand.ts index fe10627cab560..9f3da38cfe744 100644 --- a/clients/client-ec2/commands/RequestSpotFleetCommand.ts +++ b/clients/client-ec2/commands/RequestSpotFleetCommand.ts @@ -20,6 +20,24 @@ import { export type RequestSpotFleetCommandInput = RequestSpotFleetRequest; export type RequestSpotFleetCommandOutput = RequestSpotFleetResponse & __MetadataBearer; +/** + *

Creates a Spot Fleet request.

+ *

The Spot Fleet request specifies the total target capacity and the On-Demand target + * capacity. Amazon EC2 calculates the difference between the total capacity and On-Demand + * capacity, and launches the difference as Spot capacity.

+ *

You can submit a single request that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

+ *

By default, the Spot Fleet requests Spot Instances in the Spot Instance pool where the + * price per unit is the lowest. Each launch specification can include its own instance + * weighting that reflects the value of the instance type to your application + * workload.

+ *

Alternatively, you can specify that the Spot Fleet distribute the target capacity across the Spot pools included in its launch specifications. By ensuring that the Spot Instances in your Spot Fleet are in different Spot pools, you can improve the availability of your fleet.

+ *

You can specify tags for the Spot Fleet request and instances launched by the fleet. You + * cannot tag other resource types in a Spot Fleet request because only the + * spot-fleet-request and instance resource types are + * supported.

+ *

For more information, see Spot Fleet requests + * in the Amazon EC2 User Guide for Linux Instances.

+ */ export class RequestSpotFleetCommand extends $Command< RequestSpotFleetCommandInput, RequestSpotFleetCommandOutput, @@ -34,6 +52,9 @@ export class RequestSpotFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RequestSpotInstancesCommand.ts b/clients/client-ec2/commands/RequestSpotInstancesCommand.ts index 8d2e36685c758..7b47f44373a95 100644 --- a/clients/client-ec2/commands/RequestSpotInstancesCommand.ts +++ b/clients/client-ec2/commands/RequestSpotInstancesCommand.ts @@ -20,6 +20,10 @@ import { export type RequestSpotInstancesCommandInput = RequestSpotInstancesRequest; export type RequestSpotInstancesCommandOutput = RequestSpotInstancesResult & __MetadataBearer; +/** + *

Creates a Spot Instance request.

+ *

For more information, see Spot Instance requests in the Amazon EC2 User Guide for Linux Instances.

+ */ export class RequestSpotInstancesCommand extends $Command< RequestSpotInstancesCommandInput, RequestSpotInstancesCommandOutput, @@ -34,6 +38,9 @@ export class RequestSpotInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ResetEbsDefaultKmsKeyIdCommand.ts b/clients/client-ec2/commands/ResetEbsDefaultKmsKeyIdCommand.ts index 183c7bcc79635..b26d3dcef4735 100644 --- a/clients/client-ec2/commands/ResetEbsDefaultKmsKeyIdCommand.ts +++ b/clients/client-ec2/commands/ResetEbsDefaultKmsKeyIdCommand.ts @@ -20,6 +20,14 @@ import { export type ResetEbsDefaultKmsKeyIdCommandInput = ResetEbsDefaultKmsKeyIdRequest; export type ResetEbsDefaultKmsKeyIdCommandOutput = ResetEbsDefaultKmsKeyIdResult & __MetadataBearer; +/** + *

Resets the default customer master key (CMK) for EBS encryption for your account in this Region + * to the AWS managed CMK for EBS.

+ *

After resetting the default CMK to the AWS managed CMK, you can continue to encrypt by a + * customer managed CMK by specifying it when you create the volume. For more information, see + * Amazon EBS Encryption + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class ResetEbsDefaultKmsKeyIdCommand extends $Command< ResetEbsDefaultKmsKeyIdCommandInput, ResetEbsDefaultKmsKeyIdCommandOutput, @@ -34,6 +42,9 @@ export class ResetEbsDefaultKmsKeyIdCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ResetFpgaImageAttributeCommand.ts b/clients/client-ec2/commands/ResetFpgaImageAttributeCommand.ts index 91abccc9ea239..2de4729dfcb3a 100644 --- a/clients/client-ec2/commands/ResetFpgaImageAttributeCommand.ts +++ b/clients/client-ec2/commands/ResetFpgaImageAttributeCommand.ts @@ -20,6 +20,10 @@ import { export type ResetFpgaImageAttributeCommandInput = ResetFpgaImageAttributeRequest; export type ResetFpgaImageAttributeCommandOutput = ResetFpgaImageAttributeResult & __MetadataBearer; +/** + *

Resets the specified attribute of the specified Amazon FPGA Image (AFI) to its default value. + * You can only reset the load permission attribute.

+ */ export class ResetFpgaImageAttributeCommand extends $Command< ResetFpgaImageAttributeCommandInput, ResetFpgaImageAttributeCommandOutput, @@ -34,6 +38,9 @@ export class ResetFpgaImageAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ResetImageAttributeCommand.ts b/clients/client-ec2/commands/ResetImageAttributeCommand.ts index 36efa75ef4828..870c0b5391cd4 100644 --- a/clients/client-ec2/commands/ResetImageAttributeCommand.ts +++ b/clients/client-ec2/commands/ResetImageAttributeCommand.ts @@ -20,6 +20,12 @@ import { export type ResetImageAttributeCommandInput = ResetImageAttributeRequest; export type ResetImageAttributeCommandOutput = __MetadataBearer; +/** + *

Resets an attribute of an AMI to its default value.

+ * + *

The productCodes attribute can't be reset.

+ *
+ */ export class ResetImageAttributeCommand extends $Command< ResetImageAttributeCommandInput, ResetImageAttributeCommandOutput, @@ -34,6 +40,9 @@ export class ResetImageAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ResetInstanceAttributeCommand.ts b/clients/client-ec2/commands/ResetInstanceAttributeCommand.ts index 870237183edb7..2c21758170f42 100644 --- a/clients/client-ec2/commands/ResetInstanceAttributeCommand.ts +++ b/clients/client-ec2/commands/ResetInstanceAttributeCommand.ts @@ -20,6 +20,17 @@ import { export type ResetInstanceAttributeCommandInput = ResetInstanceAttributeRequest; export type ResetInstanceAttributeCommandOutput = __MetadataBearer; +/** + *

Resets an attribute of an instance to its default value. To reset the + * kernel or ramdisk, the instance must be in a stopped + * state. To reset the sourceDestCheck, the instance can be either running or + * stopped.

+ *

The sourceDestCheck attribute controls whether source/destination + * checking is enabled. The default value is true, which means checking is + * enabled. This value must be false for a NAT instance to perform NAT. For + * more information, see NAT Instances in the + * Amazon Virtual Private Cloud User Guide.

+ */ export class ResetInstanceAttributeCommand extends $Command< ResetInstanceAttributeCommandInput, ResetInstanceAttributeCommandOutput, @@ -34,6 +45,9 @@ export class ResetInstanceAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ResetNetworkInterfaceAttributeCommand.ts b/clients/client-ec2/commands/ResetNetworkInterfaceAttributeCommand.ts index 4a25092a73db0..98ce7b42364c6 100644 --- a/clients/client-ec2/commands/ResetNetworkInterfaceAttributeCommand.ts +++ b/clients/client-ec2/commands/ResetNetworkInterfaceAttributeCommand.ts @@ -20,6 +20,9 @@ import { export type ResetNetworkInterfaceAttributeCommandInput = ResetNetworkInterfaceAttributeRequest; export type ResetNetworkInterfaceAttributeCommandOutput = __MetadataBearer; +/** + *

Resets a network interface attribute. You can specify only one attribute at a time.

+ */ export class ResetNetworkInterfaceAttributeCommand extends $Command< ResetNetworkInterfaceAttributeCommandInput, ResetNetworkInterfaceAttributeCommandOutput, @@ -34,6 +37,9 @@ export class ResetNetworkInterfaceAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/ResetSnapshotAttributeCommand.ts b/clients/client-ec2/commands/ResetSnapshotAttributeCommand.ts index 5fd2d3ed64637..21d5ba5962379 100644 --- a/clients/client-ec2/commands/ResetSnapshotAttributeCommand.ts +++ b/clients/client-ec2/commands/ResetSnapshotAttributeCommand.ts @@ -20,6 +20,11 @@ import { export type ResetSnapshotAttributeCommandInput = ResetSnapshotAttributeRequest; export type ResetSnapshotAttributeCommandOutput = __MetadataBearer; +/** + *

Resets permission settings for the specified snapshot.

+ *

For more information about modifying snapshot permissions, see Sharing snapshots in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class ResetSnapshotAttributeCommand extends $Command< ResetSnapshotAttributeCommandInput, ResetSnapshotAttributeCommandOutput, @@ -34,6 +39,9 @@ export class ResetSnapshotAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RestoreAddressToClassicCommand.ts b/clients/client-ec2/commands/RestoreAddressToClassicCommand.ts index 910488aaa792e..32eaf142984f7 100644 --- a/clients/client-ec2/commands/RestoreAddressToClassicCommand.ts +++ b/clients/client-ec2/commands/RestoreAddressToClassicCommand.ts @@ -20,6 +20,9 @@ import { export type RestoreAddressToClassicCommandInput = RestoreAddressToClassicRequest; export type RestoreAddressToClassicCommandOutput = RestoreAddressToClassicResult & __MetadataBearer; +/** + *

Restores an Elastic IP address that was previously moved to the EC2-VPC platform back to the EC2-Classic platform. You cannot move an Elastic IP address that was originally allocated for use in EC2-VPC. The Elastic IP address must not be associated with an instance or network interface.

+ */ export class RestoreAddressToClassicCommand extends $Command< RestoreAddressToClassicCommandInput, RestoreAddressToClassicCommandOutput, @@ -34,6 +37,9 @@ export class RestoreAddressToClassicCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RestoreManagedPrefixListVersionCommand.ts b/clients/client-ec2/commands/RestoreManagedPrefixListVersionCommand.ts index 13dd3026b9a47..d28323367b0d9 100644 --- a/clients/client-ec2/commands/RestoreManagedPrefixListVersionCommand.ts +++ b/clients/client-ec2/commands/RestoreManagedPrefixListVersionCommand.ts @@ -20,6 +20,9 @@ import { export type RestoreManagedPrefixListVersionCommandInput = RestoreManagedPrefixListVersionRequest; export type RestoreManagedPrefixListVersionCommandOutput = RestoreManagedPrefixListVersionResult & __MetadataBearer; +/** + *

Restores the entries from a previous version of a managed prefix list to a new version of the prefix list.

+ */ export class RestoreManagedPrefixListVersionCommand extends $Command< RestoreManagedPrefixListVersionCommandInput, RestoreManagedPrefixListVersionCommandOutput, @@ -34,6 +37,9 @@ export class RestoreManagedPrefixListVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RevokeClientVpnIngressCommand.ts b/clients/client-ec2/commands/RevokeClientVpnIngressCommand.ts index b5f35179d321c..7cdd5bd109939 100644 --- a/clients/client-ec2/commands/RevokeClientVpnIngressCommand.ts +++ b/clients/client-ec2/commands/RevokeClientVpnIngressCommand.ts @@ -20,6 +20,9 @@ import { export type RevokeClientVpnIngressCommandInput = RevokeClientVpnIngressRequest; export type RevokeClientVpnIngressCommandOutput = RevokeClientVpnIngressResult & __MetadataBearer; +/** + *

Removes an ingress authorization rule from a Client VPN endpoint.

+ */ export class RevokeClientVpnIngressCommand extends $Command< RevokeClientVpnIngressCommandInput, RevokeClientVpnIngressCommandOutput, @@ -34,6 +37,9 @@ export class RevokeClientVpnIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RevokeSecurityGroupEgressCommand.ts b/clients/client-ec2/commands/RevokeSecurityGroupEgressCommand.ts index d056878185cda..672b282f771a6 100644 --- a/clients/client-ec2/commands/RevokeSecurityGroupEgressCommand.ts +++ b/clients/client-ec2/commands/RevokeSecurityGroupEgressCommand.ts @@ -20,6 +20,23 @@ import { export type RevokeSecurityGroupEgressCommandInput = RevokeSecurityGroupEgressRequest; export type RevokeSecurityGroupEgressCommandOutput = RevokeSecurityGroupEgressResult & __MetadataBearer; +/** + *

[VPC only] Removes the specified egress rules from a security group for EC2-VPC. + * This action does not apply to security groups for use in EC2-Classic. To remove a rule, the + * values that you specify (for example, ports) must match the existing rule's values + * exactly.

+ * + *

[Default VPC] If the values you specify do not match the existing rule's values, no error is + * returned, and the output describes the security group rules that were not revoked.

+ *

AWS recommends that you use DescribeSecurityGroups to verify + * that the rule has been removed.

+ *
+ *

Each rule consists of the protocol and the IPv4 or IPv6 CIDR range or source security + * group. For the TCP and UDP protocols, you must also specify the destination port or range of + * ports. For the ICMP protocol, you must also specify the ICMP type and code. If the security group rule + * has a description, you do not have to specify the description to revoke the rule.

+ *

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

+ */ export class RevokeSecurityGroupEgressCommand extends $Command< RevokeSecurityGroupEgressCommandInput, RevokeSecurityGroupEgressCommandOutput, @@ -34,6 +51,9 @@ export class RevokeSecurityGroupEgressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RevokeSecurityGroupIngressCommand.ts b/clients/client-ec2/commands/RevokeSecurityGroupIngressCommand.ts index 954fc32a3eadf..addc24fe081a0 100644 --- a/clients/client-ec2/commands/RevokeSecurityGroupIngressCommand.ts +++ b/clients/client-ec2/commands/RevokeSecurityGroupIngressCommand.ts @@ -20,6 +20,21 @@ import { export type RevokeSecurityGroupIngressCommandInput = RevokeSecurityGroupIngressRequest; export type RevokeSecurityGroupIngressCommandOutput = RevokeSecurityGroupIngressResult & __MetadataBearer; +/** + *

Removes the specified ingress rules from a security group. To remove a rule, the values + * that you specify (for example, ports) must match the existing rule's values exactly.

+ * + * + *

[EC2-Classic , default VPC] If the values you specify do not match the existing rule's values, + * no error is returned, and the output describes the security group rules that were + * not revoked.

+ *

AWS recommends that you use DescribeSecurityGroups to verify + * that the rule has been removed.

+ *
+ * + *

Each rule consists of the protocol and the CIDR range or source security group. For the TCP and UDP protocols, you must also specify the destination port or range of ports. For the ICMP protocol, you must also specify the ICMP type and code. If the security group rule has a description, you do not have to specify the description to revoke the rule.

+ *

Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

+ */ export class RevokeSecurityGroupIngressCommand extends $Command< RevokeSecurityGroupIngressCommandInput, RevokeSecurityGroupIngressCommandOutput, @@ -34,6 +49,9 @@ export class RevokeSecurityGroupIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RunInstancesCommand.ts b/clients/client-ec2/commands/RunInstancesCommand.ts index 41aed1b2d96b8..be0639478a354 100644 --- a/clients/client-ec2/commands/RunInstancesCommand.ts +++ b/clients/client-ec2/commands/RunInstancesCommand.ts @@ -18,6 +18,67 @@ import { export type RunInstancesCommandInput = RunInstancesRequest; export type RunInstancesCommandOutput = Reservation & __MetadataBearer; +/** + *

Launches the specified number of instances using an AMI for which you have + * permissions.

+ *

You can specify a number of options, or leave the default options. The following rules + * apply:

+ *
    + *
  • + *

    [EC2-VPC] If you don't specify a subnet ID, we choose a default subnet from + * your default VPC for you. If you don't have a default VPC, you must specify a + * subnet ID in the request.

    + *
  • + *
  • + *

    [EC2-Classic] If don't specify an Availability Zone, we choose one for + * you.

    + *
  • + *
  • + *

    Some instance types must be launched into a VPC. If you do not have a default + * VPC, or if you do not specify a subnet ID, the request fails. For more + * information, see Instance types available only in a VPC.

    + *
  • + *
  • + *

    [EC2-VPC] All instances have a network interface with a primary private IPv4 + * address. If you don't specify this address, we choose one from the IPv4 range of + * your subnet.

    + *
  • + *
  • + *

    Not all instance types support IPv6 addresses. For more information, see + * Instance + * types.

    + *
  • + *
  • + *

    If you don't specify a security group ID, we use the default security group. + * For more information, see Security + * groups.

    + *
  • + *
  • + *

    If any of the AMIs have a product code attached for which the user has not + * subscribed, the request fails.

    + *
  • + *
+ *

You can create a launch template, + * which is a resource that contains the parameters to launch an instance. When you launch + * an instance using RunInstances, you can specify the launch template + * instead of specifying the launch parameters.

+ *

To ensure faster instance launches, break up large requests into smaller batches. For + * example, create five separate launch requests for 100 instances each instead of one + * launch request for 500 instances.

+ *

An instance is ready for you to use when it's in the running state. You + * can check the state of your instance using DescribeInstances. You can + * tag instances and EBS volumes during launch, after launch, or both. For more + * information, see CreateTags and Tagging your Amazon EC2 + * resources.

+ *

Linux instances have access to the public key of the key pair at boot. You can use + * this key to provide secure access to the instance. Amazon EC2 public images use this + * feature to provide secure access without passwords. For more information, see Key + * pairs in the Amazon Elastic Compute Cloud User + * Guide.

+ *

For troubleshooting, see What to do if + * an instance immediately terminates, and Troubleshooting connecting to your instance in the Amazon Elastic + * Compute Cloud User Guide.

+ */ export class RunInstancesCommand extends $Command< RunInstancesCommandInput, RunInstancesCommandOutput, @@ -32,6 +93,9 @@ export class RunInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/RunScheduledInstancesCommand.ts b/clients/client-ec2/commands/RunScheduledInstancesCommand.ts index 52225e6272f37..ae067b5919709 100644 --- a/clients/client-ec2/commands/RunScheduledInstancesCommand.ts +++ b/clients/client-ec2/commands/RunScheduledInstancesCommand.ts @@ -20,6 +20,14 @@ import { export type RunScheduledInstancesCommandInput = RunScheduledInstancesRequest; export type RunScheduledInstancesCommandOutput = RunScheduledInstancesResult & __MetadataBearer; +/** + *

Launches the specified Scheduled Instances.

+ *

Before you can launch a Scheduled Instance, you must purchase it and obtain an identifier using PurchaseScheduledInstances.

+ *

You must launch a Scheduled Instance during its scheduled time period. You can't stop or reboot a Scheduled Instance, + * but you can terminate it as needed. If you terminate a Scheduled Instance before the current scheduled time period ends, + * you can launch it again after a few minutes. For more information, see Scheduled Instances + * in the Amazon Elastic Compute Cloud User Guide.

+ */ export class RunScheduledInstancesCommand extends $Command< RunScheduledInstancesCommandInput, RunScheduledInstancesCommandOutput, @@ -34,6 +42,9 @@ export class RunScheduledInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/SearchLocalGatewayRoutesCommand.ts b/clients/client-ec2/commands/SearchLocalGatewayRoutesCommand.ts index 9be1ed8d25c8b..1261cbc8c9fe1 100644 --- a/clients/client-ec2/commands/SearchLocalGatewayRoutesCommand.ts +++ b/clients/client-ec2/commands/SearchLocalGatewayRoutesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchLocalGatewayRoutesCommandInput = SearchLocalGatewayRoutesRequest; export type SearchLocalGatewayRoutesCommandOutput = SearchLocalGatewayRoutesResult & __MetadataBearer; +/** + *

Searches for routes in the specified local gateway route table.

+ */ export class SearchLocalGatewayRoutesCommand extends $Command< SearchLocalGatewayRoutesCommandInput, SearchLocalGatewayRoutesCommandOutput, @@ -34,6 +37,9 @@ export class SearchLocalGatewayRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/SearchTransitGatewayMulticastGroupsCommand.ts b/clients/client-ec2/commands/SearchTransitGatewayMulticastGroupsCommand.ts index 8e6c9981a1fb9..15b885dbf5cdc 100644 --- a/clients/client-ec2/commands/SearchTransitGatewayMulticastGroupsCommand.ts +++ b/clients/client-ec2/commands/SearchTransitGatewayMulticastGroupsCommand.ts @@ -24,6 +24,9 @@ export type SearchTransitGatewayMulticastGroupsCommandInput = SearchTransitGatew export type SearchTransitGatewayMulticastGroupsCommandOutput = SearchTransitGatewayMulticastGroupsResult & __MetadataBearer; +/** + *

Searches one or more transit gateway multicast groups and returns the group membership information.

+ */ export class SearchTransitGatewayMulticastGroupsCommand extends $Command< SearchTransitGatewayMulticastGroupsCommandInput, SearchTransitGatewayMulticastGroupsCommandOutput, @@ -38,6 +41,9 @@ export class SearchTransitGatewayMulticastGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/SearchTransitGatewayRoutesCommand.ts b/clients/client-ec2/commands/SearchTransitGatewayRoutesCommand.ts index ae2d233c03c5f..0c429703055d6 100644 --- a/clients/client-ec2/commands/SearchTransitGatewayRoutesCommand.ts +++ b/clients/client-ec2/commands/SearchTransitGatewayRoutesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchTransitGatewayRoutesCommandInput = SearchTransitGatewayRoutesRequest; export type SearchTransitGatewayRoutesCommandOutput = SearchTransitGatewayRoutesResult & __MetadataBearer; +/** + *

Searches for routes in the specified transit gateway route table.

+ */ export class SearchTransitGatewayRoutesCommand extends $Command< SearchTransitGatewayRoutesCommandInput, SearchTransitGatewayRoutesCommandOutput, @@ -34,6 +37,9 @@ export class SearchTransitGatewayRoutesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/SendDiagnosticInterruptCommand.ts b/clients/client-ec2/commands/SendDiagnosticInterruptCommand.ts index a6e7fcfcac026..dc40f6922a46d 100644 --- a/clients/client-ec2/commands/SendDiagnosticInterruptCommand.ts +++ b/clients/client-ec2/commands/SendDiagnosticInterruptCommand.ts @@ -20,6 +20,24 @@ import { export type SendDiagnosticInterruptCommandInput = SendDiagnosticInterruptRequest; export type SendDiagnosticInterruptCommandOutput = __MetadataBearer; +/** + *

Sends a diagnostic interrupt to the specified Amazon EC2 instance to trigger a + * kernel panic (on Linux instances), or a + * blue screen/stop error (on Windows + * instances). For instances based on Intel and AMD processors, the interrupt is + * received as a non-maskable interrupt (NMI).

+ * + *

In general, the operating system crashes and reboots when a kernel panic or stop + * error is triggered. The operating system can also be configured to perform diagnostic + * tasks, such as generating a memory dump file, loading a secondary kernel, or + * obtaining a call trace.

+ * + *

Before sending a diagnostic interrupt to your instance, ensure that its operating + * system is configured to perform the required diagnostic tasks.

+ * + *

For more information about configuring your operating system to generate a crash dump + * when a kernel panic or stop error occurs, see Send a diagnostic interrupt (Linux instances) or Send a Diagnostic Interrupt (Windows instances).

+ */ export class SendDiagnosticInterruptCommand extends $Command< SendDiagnosticInterruptCommandInput, SendDiagnosticInterruptCommandOutput, @@ -34,6 +52,9 @@ export class SendDiagnosticInterruptCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/StartInstancesCommand.ts b/clients/client-ec2/commands/StartInstancesCommand.ts index b189c1c64b802..60702209497da 100644 --- a/clients/client-ec2/commands/StartInstancesCommand.ts +++ b/clients/client-ec2/commands/StartInstancesCommand.ts @@ -17,6 +17,25 @@ import { export type StartInstancesCommandInput = StartInstancesRequest; export type StartInstancesCommandOutput = StartInstancesResult & __MetadataBearer; +/** + *

Starts an Amazon EBS-backed instance that you've previously stopped.

+ *

Instances that use Amazon EBS volumes as their root devices can be quickly stopped and + * started. When an instance is stopped, the compute resources are released and you are not + * billed for instance usage. However, your root partition Amazon EBS volume remains and + * continues to persist your data, and you are charged for Amazon EBS volume usage. You can + * restart your instance at any time. Every time you start your Windows instance, Amazon + * EC2 charges you for a full instance hour. If you stop and restart your Windows instance, + * a new instance hour begins and Amazon EC2 charges you for another full instance hour + * even if you are still within the same 60-minute period when it was stopped. Every time + * you start your Linux instance, Amazon EC2 charges a one-minute minimum for instance + * usage, and thereafter charges per second for instance usage.

+ *

Before stopping an instance, make sure it is in a state from which it can be + * restarted. Stopping an instance does not preserve data stored in RAM.

+ *

Performing this operation on an instance that uses an instance store as its root + * device returns an error.

+ *

For more information, see Stopping instances in the + * Amazon Elastic Compute Cloud User Guide.

+ */ export class StartInstancesCommand extends $Command< StartInstancesCommandInput, StartInstancesCommandOutput, @@ -31,6 +50,9 @@ export class StartInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/StartVpcEndpointServicePrivateDnsVerificationCommand.ts b/clients/client-ec2/commands/StartVpcEndpointServicePrivateDnsVerificationCommand.ts index c1ce75405f44c..0405905318c06 100644 --- a/clients/client-ec2/commands/StartVpcEndpointServicePrivateDnsVerificationCommand.ts +++ b/clients/client-ec2/commands/StartVpcEndpointServicePrivateDnsVerificationCommand.ts @@ -24,6 +24,12 @@ export type StartVpcEndpointServicePrivateDnsVerificationCommandInput = StartVpc export type StartVpcEndpointServicePrivateDnsVerificationCommandOutput = StartVpcEndpointServicePrivateDnsVerificationResult & __MetadataBearer; +/** + *

Initiates the verification process to prove that the service provider owns the private + * DNS name domain for the endpoint service.

+ *

The service provider must successfully perform the verification before the consumer can use the name to access the service.

+ *

Before the service provider runs this command, they must add a record to the DNS server. For more information, see Adding a TXT Record to Your Domain's DNS Server in the Amazon VPC User Guide.

+ */ export class StartVpcEndpointServicePrivateDnsVerificationCommand extends $Command< StartVpcEndpointServicePrivateDnsVerificationCommandInput, StartVpcEndpointServicePrivateDnsVerificationCommandOutput, @@ -38,6 +44,9 @@ export class StartVpcEndpointServicePrivateDnsVerificationCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/StopInstancesCommand.ts b/clients/client-ec2/commands/StopInstancesCommand.ts index 8fae1ed163b80..65d20d723056d 100644 --- a/clients/client-ec2/commands/StopInstancesCommand.ts +++ b/clients/client-ec2/commands/StopInstancesCommand.ts @@ -17,6 +17,42 @@ import { export type StopInstancesCommandInput = StopInstancesRequest; export type StopInstancesCommandOutput = StopInstancesResult & __MetadataBearer; +/** + *

Stops an Amazon EBS-backed instance.

+ *

You can use the Stop action to hibernate an instance if the instance is enabled for + * hibernation and it meets the hibernation + * prerequisites. For more information, see Hibernate your instance in the + * Amazon Elastic Compute Cloud User Guide.

+ *

We don't charge usage for a stopped instance, or data transfer fees; however, your + * root partition Amazon EBS volume remains and continues to persist your data, and you are + * charged for Amazon EBS volume usage. Every time you start your Windows instance, Amazon + * EC2 charges you for a full instance hour. If you stop and restart your Windows instance, + * a new instance hour begins and Amazon EC2 charges you for another full instance hour + * even if you are still within the same 60-minute period when it was stopped. Every time + * you start your Linux instance, Amazon EC2 charges a one-minute minimum for instance + * usage, and thereafter charges per second for instance usage.

+ *

You can't stop or hibernate instance store-backed instances. You can't use the Stop + * action to hibernate Spot Instances, but you can specify that Amazon EC2 should hibernate + * Spot Instances when they are interrupted. For more information, see Hibernating interrupted Spot Instances in the Amazon Elastic + * Compute Cloud User Guide.

+ *

When you stop or hibernate an instance, we shut it down. You can restart your instance + * at any time. Before stopping or hibernating an instance, make sure it is in a state from + * which it can be restarted. Stopping an instance does not preserve data stored in RAM, + * but hibernating an instance does preserve data stored in RAM. If an instance cannot + * hibernate successfully, a normal shutdown occurs.

+ *

Stopping and hibernating an instance is different to rebooting or terminating it. For + * example, when you stop or hibernate an instance, the root device and any other devices + * attached to the instance persist. When you terminate an instance, the root device and + * any other devices attached during the instance launch are automatically deleted. For + * more information about the differences between rebooting, stopping, hibernating, and + * terminating instances, see Instance lifecycle + * in the Amazon Elastic Compute Cloud User Guide.

+ *

When you stop an instance, we attempt to shut it down forcibly after a short while. If + * your instance appears stuck in the stopping state after a period of time, there may be + * an issue with the underlying host computer. For more information, see Troubleshooting + * stopping your instance in the Amazon Elastic Compute Cloud User + * Guide.

+ */ export class StopInstancesCommand extends $Command< StopInstancesCommandInput, StopInstancesCommandOutput, @@ -31,6 +67,9 @@ export class StopInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/TerminateClientVpnConnectionsCommand.ts b/clients/client-ec2/commands/TerminateClientVpnConnectionsCommand.ts index 1df01a35159cf..fbe3f66f3647c 100644 --- a/clients/client-ec2/commands/TerminateClientVpnConnectionsCommand.ts +++ b/clients/client-ec2/commands/TerminateClientVpnConnectionsCommand.ts @@ -20,6 +20,9 @@ import { export type TerminateClientVpnConnectionsCommandInput = TerminateClientVpnConnectionsRequest; export type TerminateClientVpnConnectionsCommandOutput = TerminateClientVpnConnectionsResult & __MetadataBearer; +/** + *

Terminates active Client VPN endpoint connections. This action can be used to terminate a specific client connection, or up to five connections established by a specific user.

+ */ export class TerminateClientVpnConnectionsCommand extends $Command< TerminateClientVpnConnectionsCommandInput, TerminateClientVpnConnectionsCommandOutput, @@ -34,6 +37,9 @@ export class TerminateClientVpnConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/TerminateInstancesCommand.ts b/clients/client-ec2/commands/TerminateInstancesCommand.ts index 767ffa12dfdca..9d898792b5745 100644 --- a/clients/client-ec2/commands/TerminateInstancesCommand.ts +++ b/clients/client-ec2/commands/TerminateInstancesCommand.ts @@ -20,6 +20,26 @@ import { export type TerminateInstancesCommandInput = TerminateInstancesRequest; export type TerminateInstancesCommandOutput = TerminateInstancesResult & __MetadataBearer; +/** + *

Shuts down the specified instances. This operation is idempotent; if you terminate an + * instance more than once, each call succeeds.

+ *

If you specify multiple instances and the request fails (for example, because of a + * single incorrect instance ID), none of the instances are terminated.

+ *

Terminated instances remain visible after termination (for approximately one + * hour).

+ *

By default, Amazon EC2 deletes all EBS volumes that were attached when the instance + * launched. Volumes attached after instance launch continue running.

+ *

You can stop, start, and terminate EBS-backed instances. You can only terminate + * instance store-backed instances. What happens to an instance differs if you stop it or + * terminate it. For example, when you stop an instance, the root device and any other + * devices attached to the instance persist. When you terminate an instance, any attached + * EBS volumes with the DeleteOnTermination block device mapping parameter set + * to true are automatically deleted. For more information about the + * differences between stopping and terminating instances, see Instance lifecycle + * in the Amazon Elastic Compute Cloud User Guide.

+ *

For more information about troubleshooting, see Troubleshooting terminating your instance in the Amazon Elastic + * Compute Cloud User Guide.

+ */ export class TerminateInstancesCommand extends $Command< TerminateInstancesCommandInput, TerminateInstancesCommandOutput, @@ -34,6 +54,9 @@ export class TerminateInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/UnassignIpv6AddressesCommand.ts b/clients/client-ec2/commands/UnassignIpv6AddressesCommand.ts index 51ef094238d54..09b9d5aed087d 100644 --- a/clients/client-ec2/commands/UnassignIpv6AddressesCommand.ts +++ b/clients/client-ec2/commands/UnassignIpv6AddressesCommand.ts @@ -20,6 +20,9 @@ import { export type UnassignIpv6AddressesCommandInput = UnassignIpv6AddressesRequest; export type UnassignIpv6AddressesCommandOutput = UnassignIpv6AddressesResult & __MetadataBearer; +/** + *

Unassigns one or more IPv6 addresses from a network interface.

+ */ export class UnassignIpv6AddressesCommand extends $Command< UnassignIpv6AddressesCommandInput, UnassignIpv6AddressesCommandOutput, @@ -34,6 +37,9 @@ export class UnassignIpv6AddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/UnassignPrivateIpAddressesCommand.ts b/clients/client-ec2/commands/UnassignPrivateIpAddressesCommand.ts index ea8827c14884e..ce395ffea5684 100644 --- a/clients/client-ec2/commands/UnassignPrivateIpAddressesCommand.ts +++ b/clients/client-ec2/commands/UnassignPrivateIpAddressesCommand.ts @@ -20,6 +20,9 @@ import { export type UnassignPrivateIpAddressesCommandInput = UnassignPrivateIpAddressesRequest; export type UnassignPrivateIpAddressesCommandOutput = __MetadataBearer; +/** + *

Unassigns one or more secondary private IP addresses from a network interface.

+ */ export class UnassignPrivateIpAddressesCommand extends $Command< UnassignPrivateIpAddressesCommandInput, UnassignPrivateIpAddressesCommandOutput, @@ -34,6 +37,9 @@ export class UnassignPrivateIpAddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/UnmonitorInstancesCommand.ts b/clients/client-ec2/commands/UnmonitorInstancesCommand.ts index e960d51d80187..dd81a48f5e38b 100644 --- a/clients/client-ec2/commands/UnmonitorInstancesCommand.ts +++ b/clients/client-ec2/commands/UnmonitorInstancesCommand.ts @@ -20,6 +20,11 @@ import { export type UnmonitorInstancesCommandInput = UnmonitorInstancesRequest; export type UnmonitorInstancesCommandOutput = UnmonitorInstancesResult & __MetadataBearer; +/** + *

Disables detailed monitoring for a running instance. For more information, see Monitoring + * your instances and volumes in the Amazon Elastic Compute Cloud + * User Guide.

+ */ export class UnmonitorInstancesCommand extends $Command< UnmonitorInstancesCommandInput, UnmonitorInstancesCommandOutput, @@ -34,6 +39,9 @@ export class UnmonitorInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/UpdateSecurityGroupRuleDescriptionsEgressCommand.ts b/clients/client-ec2/commands/UpdateSecurityGroupRuleDescriptionsEgressCommand.ts index c6617fafafb6d..c09d0f52f83fb 100644 --- a/clients/client-ec2/commands/UpdateSecurityGroupRuleDescriptionsEgressCommand.ts +++ b/clients/client-ec2/commands/UpdateSecurityGroupRuleDescriptionsEgressCommand.ts @@ -24,6 +24,14 @@ export type UpdateSecurityGroupRuleDescriptionsEgressCommandInput = UpdateSecuri export type UpdateSecurityGroupRuleDescriptionsEgressCommandOutput = UpdateSecurityGroupRuleDescriptionsEgressResult & __MetadataBearer; +/** + *

[VPC only] Updates the description of an egress (outbound) security group rule. You + * can replace an existing description, or add a description to a rule that did not have one + * previously.

+ *

You specify the description as part of the IP permissions structure. You can remove a + * description for a security group rule by omitting the description parameter in the + * request.

+ */ export class UpdateSecurityGroupRuleDescriptionsEgressCommand extends $Command< UpdateSecurityGroupRuleDescriptionsEgressCommandInput, UpdateSecurityGroupRuleDescriptionsEgressCommandOutput, @@ -38,6 +46,9 @@ export class UpdateSecurityGroupRuleDescriptionsEgressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/UpdateSecurityGroupRuleDescriptionsIngressCommand.ts b/clients/client-ec2/commands/UpdateSecurityGroupRuleDescriptionsIngressCommand.ts index 07b93740ade7f..fd6da288dcbed 100644 --- a/clients/client-ec2/commands/UpdateSecurityGroupRuleDescriptionsIngressCommand.ts +++ b/clients/client-ec2/commands/UpdateSecurityGroupRuleDescriptionsIngressCommand.ts @@ -24,6 +24,14 @@ export type UpdateSecurityGroupRuleDescriptionsIngressCommandInput = UpdateSecur export type UpdateSecurityGroupRuleDescriptionsIngressCommandOutput = UpdateSecurityGroupRuleDescriptionsIngressResult & __MetadataBearer; +/** + *

Updates the description of an ingress (inbound) security group rule. You can replace an + * existing description, or add a description to a rule that did not have one + * previously.

+ *

You specify the description as part of the IP permissions structure. You can remove a + * description for a security group rule by omitting the description parameter in the + * request.

+ */ export class UpdateSecurityGroupRuleDescriptionsIngressCommand extends $Command< UpdateSecurityGroupRuleDescriptionsIngressCommandInput, UpdateSecurityGroupRuleDescriptionsIngressCommandOutput, @@ -38,6 +46,9 @@ export class UpdateSecurityGroupRuleDescriptionsIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/commands/WithdrawByoipCidrCommand.ts b/clients/client-ec2/commands/WithdrawByoipCidrCommand.ts index b952fbfa3a348..5d9662239ef20 100644 --- a/clients/client-ec2/commands/WithdrawByoipCidrCommand.ts +++ b/clients/client-ec2/commands/WithdrawByoipCidrCommand.ts @@ -20,6 +20,13 @@ import { export type WithdrawByoipCidrCommandInput = WithdrawByoipCidrRequest; export type WithdrawByoipCidrCommandOutput = WithdrawByoipCidrResult & __MetadataBearer; +/** + *

Stops advertising an address range that is provisioned as an address pool.

+ *

You can perform this operation at most once every 10 seconds, even if you specify different + * address ranges each time.

+ *

It can take a few minutes before traffic to the specified addresses stops routing to AWS + * because of BGP propagation delays.

+ */ export class WithdrawByoipCidrCommand extends $Command< WithdrawByoipCidrCommandInput, WithdrawByoipCidrCommandOutput, @@ -34,6 +41,9 @@ export class WithdrawByoipCidrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ClientResolvedConfig, diff --git a/clients/client-ec2/package.json b/clients/client-ec2/package.json index b8540f7eb9209..c397b66c207c8 100644 --- a/clients/client-ec2/package.json +++ b/clients/client-ec2/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ec2 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -67,7 +67,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ec2/pagination/DescribeCapacityReservationsPaginator.ts b/clients/client-ec2/pagination/DescribeCapacityReservationsPaginator.ts index 45ca826c143d6..06dfa06c1fc1e 100644 --- a/clients/client-ec2/pagination/DescribeCapacityReservationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeCapacityReservationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeCapacityReservationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCapacityReservationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeCapacityReservationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeCarrierGatewaysPaginator.ts b/clients/client-ec2/pagination/DescribeCarrierGatewaysPaginator.ts index 93b47d0c0ea24..f03b815927aa6 100644 --- a/clients/client-ec2/pagination/DescribeCarrierGatewaysPaginator.ts +++ b/clients/client-ec2/pagination/DescribeCarrierGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeCarrierGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCarrierGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeCarrierGatewaysCommandInput, diff --git a/clients/client-ec2/pagination/DescribeClassicLinkInstancesPaginator.ts b/clients/client-ec2/pagination/DescribeClassicLinkInstancesPaginator.ts index 54f1eb470d088..45fc5c2896c27 100644 --- a/clients/client-ec2/pagination/DescribeClassicLinkInstancesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeClassicLinkInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeClassicLinkInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClassicLinkInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeClassicLinkInstancesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeClientVpnAuthorizationRulesPaginator.ts b/clients/client-ec2/pagination/DescribeClientVpnAuthorizationRulesPaginator.ts index 03f3880b31863..3876baaf2e382 100644 --- a/clients/client-ec2/pagination/DescribeClientVpnAuthorizationRulesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeClientVpnAuthorizationRulesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeClientVpnAuthorizationRulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClientVpnAuthorizationRulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeClientVpnAuthorizationRulesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeClientVpnConnectionsPaginator.ts b/clients/client-ec2/pagination/DescribeClientVpnConnectionsPaginator.ts index 654443d3f4644..2bb536a091991 100644 --- a/clients/client-ec2/pagination/DescribeClientVpnConnectionsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeClientVpnConnectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeClientVpnConnectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClientVpnConnectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeClientVpnConnectionsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeClientVpnEndpointsPaginator.ts b/clients/client-ec2/pagination/DescribeClientVpnEndpointsPaginator.ts index f7d3a64439626..782b59d6d2805 100644 --- a/clients/client-ec2/pagination/DescribeClientVpnEndpointsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeClientVpnEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeClientVpnEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClientVpnEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeClientVpnEndpointsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeClientVpnRoutesPaginator.ts b/clients/client-ec2/pagination/DescribeClientVpnRoutesPaginator.ts index 1aae0605c4e36..dcaa1204ec420 100644 --- a/clients/client-ec2/pagination/DescribeClientVpnRoutesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeClientVpnRoutesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeClientVpnRoutesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClientVpnRoutesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeClientVpnRoutesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeClientVpnTargetNetworksPaginator.ts b/clients/client-ec2/pagination/DescribeClientVpnTargetNetworksPaginator.ts index f56b392775ac5..0c200ad2b4cd9 100644 --- a/clients/client-ec2/pagination/DescribeClientVpnTargetNetworksPaginator.ts +++ b/clients/client-ec2/pagination/DescribeClientVpnTargetNetworksPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeClientVpnTargetNetworksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClientVpnTargetNetworksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeClientVpnTargetNetworksCommandInput, diff --git a/clients/client-ec2/pagination/DescribeCoipPoolsPaginator.ts b/clients/client-ec2/pagination/DescribeCoipPoolsPaginator.ts index 4387b0f1846e9..8a7a70efd4698 100644 --- a/clients/client-ec2/pagination/DescribeCoipPoolsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeCoipPoolsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeCoipPoolsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCoipPoolsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeCoipPoolsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeDhcpOptionsPaginator.ts b/clients/client-ec2/pagination/DescribeDhcpOptionsPaginator.ts index c77f04cb8259e..5d50d8b30b328 100644 --- a/clients/client-ec2/pagination/DescribeDhcpOptionsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeDhcpOptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeDhcpOptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDhcpOptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeDhcpOptionsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeEgressOnlyInternetGatewaysPaginator.ts b/clients/client-ec2/pagination/DescribeEgressOnlyInternetGatewaysPaginator.ts index 938185395908c..ce8dd578e1b91 100644 --- a/clients/client-ec2/pagination/DescribeEgressOnlyInternetGatewaysPaginator.ts +++ b/clients/client-ec2/pagination/DescribeEgressOnlyInternetGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeEgressOnlyInternetGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEgressOnlyInternetGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeEgressOnlyInternetGatewaysCommandInput, diff --git a/clients/client-ec2/pagination/DescribeExportImageTasksPaginator.ts b/clients/client-ec2/pagination/DescribeExportImageTasksPaginator.ts index 2b3a137a2101f..64f9013cbf067 100644 --- a/clients/client-ec2/pagination/DescribeExportImageTasksPaginator.ts +++ b/clients/client-ec2/pagination/DescribeExportImageTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeExportImageTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeExportImageTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeExportImageTasksCommandInput, diff --git a/clients/client-ec2/pagination/DescribeFastSnapshotRestoresPaginator.ts b/clients/client-ec2/pagination/DescribeFastSnapshotRestoresPaginator.ts index a82adbf1590da..11fcef158d200 100644 --- a/clients/client-ec2/pagination/DescribeFastSnapshotRestoresPaginator.ts +++ b/clients/client-ec2/pagination/DescribeFastSnapshotRestoresPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeFastSnapshotRestoresCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFastSnapshotRestoresCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeFastSnapshotRestoresCommandInput, diff --git a/clients/client-ec2/pagination/DescribeFleetsPaginator.ts b/clients/client-ec2/pagination/DescribeFleetsPaginator.ts index ff97a38d980fc..f9e8e819a6381 100644 --- a/clients/client-ec2/pagination/DescribeFleetsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeFleetsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeFleetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFleetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeFleetsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeFlowLogsPaginator.ts b/clients/client-ec2/pagination/DescribeFlowLogsPaginator.ts index 8c0667641a851..50763da1105b7 100644 --- a/clients/client-ec2/pagination/DescribeFlowLogsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeFlowLogsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeFlowLogsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFlowLogsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeFlowLogsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeFpgaImagesPaginator.ts b/clients/client-ec2/pagination/DescribeFpgaImagesPaginator.ts index 8d77085890f81..b60145f246091 100644 --- a/clients/client-ec2/pagination/DescribeFpgaImagesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeFpgaImagesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeFpgaImagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFpgaImagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeFpgaImagesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeHostReservationOfferingsPaginator.ts b/clients/client-ec2/pagination/DescribeHostReservationOfferingsPaginator.ts index 531fd868767e8..3030b55d51105 100644 --- a/clients/client-ec2/pagination/DescribeHostReservationOfferingsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeHostReservationOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeHostReservationOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeHostReservationOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeHostReservationOfferingsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeHostReservationsPaginator.ts b/clients/client-ec2/pagination/DescribeHostReservationsPaginator.ts index bcd0d8b7f3559..a447340aaa253 100644 --- a/clients/client-ec2/pagination/DescribeHostReservationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeHostReservationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeHostReservationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeHostReservationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeHostReservationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeHostsPaginator.ts b/clients/client-ec2/pagination/DescribeHostsPaginator.ts index 43c1ad9eb068f..a0df4998ae19f 100644 --- a/clients/client-ec2/pagination/DescribeHostsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeHostsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeHostsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeHostsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeHostsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeIamInstanceProfileAssociationsPaginator.ts b/clients/client-ec2/pagination/DescribeIamInstanceProfileAssociationsPaginator.ts index 33224c29d4317..ed3e3dfc99955 100644 --- a/clients/client-ec2/pagination/DescribeIamInstanceProfileAssociationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeIamInstanceProfileAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeIamInstanceProfileAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeIamInstanceProfileAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeIamInstanceProfileAssociationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeImportImageTasksPaginator.ts b/clients/client-ec2/pagination/DescribeImportImageTasksPaginator.ts index 434c7a67ffbb6..49b59b112158c 100644 --- a/clients/client-ec2/pagination/DescribeImportImageTasksPaginator.ts +++ b/clients/client-ec2/pagination/DescribeImportImageTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeImportImageTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeImportImageTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeImportImageTasksCommandInput, diff --git a/clients/client-ec2/pagination/DescribeImportSnapshotTasksPaginator.ts b/clients/client-ec2/pagination/DescribeImportSnapshotTasksPaginator.ts index c5ec7a56c8b04..3278bd77dfdc4 100644 --- a/clients/client-ec2/pagination/DescribeImportSnapshotTasksPaginator.ts +++ b/clients/client-ec2/pagination/DescribeImportSnapshotTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeImportSnapshotTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeImportSnapshotTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeImportSnapshotTasksCommandInput, diff --git a/clients/client-ec2/pagination/DescribeInstanceCreditSpecificationsPaginator.ts b/clients/client-ec2/pagination/DescribeInstanceCreditSpecificationsPaginator.ts index 75c633a61f2b4..576489acc7e55 100644 --- a/clients/client-ec2/pagination/DescribeInstanceCreditSpecificationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeInstanceCreditSpecificationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeInstanceCreditSpecificationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstanceCreditSpecificationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeInstanceCreditSpecificationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeInstanceStatusPaginator.ts b/clients/client-ec2/pagination/DescribeInstanceStatusPaginator.ts index 73a2ad4cca550..b56500248d001 100644 --- a/clients/client-ec2/pagination/DescribeInstanceStatusPaginator.ts +++ b/clients/client-ec2/pagination/DescribeInstanceStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeInstanceStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstanceStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeInstanceStatusCommandInput, diff --git a/clients/client-ec2/pagination/DescribeInstanceTypeOfferingsPaginator.ts b/clients/client-ec2/pagination/DescribeInstanceTypeOfferingsPaginator.ts index 529773b1357b2..f70be5d640ddd 100644 --- a/clients/client-ec2/pagination/DescribeInstanceTypeOfferingsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeInstanceTypeOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeInstanceTypeOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstanceTypeOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeInstanceTypeOfferingsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeInstanceTypesPaginator.ts b/clients/client-ec2/pagination/DescribeInstanceTypesPaginator.ts index 8c8b40a46d3b6..d34e6ffc6df74 100644 --- a/clients/client-ec2/pagination/DescribeInstanceTypesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeInstanceTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeInstanceTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstanceTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeInstanceTypesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeInstancesPaginator.ts b/clients/client-ec2/pagination/DescribeInstancesPaginator.ts index 38fb9991a3a1b..9912e821fde46 100644 --- a/clients/client-ec2/pagination/DescribeInstancesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeInstancesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeInternetGatewaysPaginator.ts b/clients/client-ec2/pagination/DescribeInternetGatewaysPaginator.ts index c6172d0bbc286..8eeeaf5e8b091 100644 --- a/clients/client-ec2/pagination/DescribeInternetGatewaysPaginator.ts +++ b/clients/client-ec2/pagination/DescribeInternetGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeInternetGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInternetGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeInternetGatewaysCommandInput, diff --git a/clients/client-ec2/pagination/DescribeIpv6PoolsPaginator.ts b/clients/client-ec2/pagination/DescribeIpv6PoolsPaginator.ts index 42710e6cb046d..9298461e3684a 100644 --- a/clients/client-ec2/pagination/DescribeIpv6PoolsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeIpv6PoolsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeIpv6PoolsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeIpv6PoolsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeIpv6PoolsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeLaunchTemplateVersionsPaginator.ts b/clients/client-ec2/pagination/DescribeLaunchTemplateVersionsPaginator.ts index 0078227992033..ec36f84076c5a 100644 --- a/clients/client-ec2/pagination/DescribeLaunchTemplateVersionsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeLaunchTemplateVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeLaunchTemplateVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLaunchTemplateVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeLaunchTemplateVersionsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeLaunchTemplatesPaginator.ts b/clients/client-ec2/pagination/DescribeLaunchTemplatesPaginator.ts index 93cc36b1240ad..a49b317f4dede 100644 --- a/clients/client-ec2/pagination/DescribeLaunchTemplatesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeLaunchTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeLaunchTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLaunchTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeLaunchTemplatesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsPaginator.ts b/clients/client-ec2/pagination/DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsPaginator.ts index 7a59f211dd728..1f86fe2437935 100644 --- a/clients/client-ec2/pagination/DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeLocalGatewayRouteTableVpcAssociationsPaginator.ts b/clients/client-ec2/pagination/DescribeLocalGatewayRouteTableVpcAssociationsPaginator.ts index dbd222a87f364..c7e02aed05f74 100644 --- a/clients/client-ec2/pagination/DescribeLocalGatewayRouteTableVpcAssociationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeLocalGatewayRouteTableVpcAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeLocalGatewayRouteTableVpcAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLocalGatewayRouteTableVpcAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeLocalGatewayRouteTableVpcAssociationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeLocalGatewayRouteTablesPaginator.ts b/clients/client-ec2/pagination/DescribeLocalGatewayRouteTablesPaginator.ts index 556e6e366a8b4..833e862306522 100644 --- a/clients/client-ec2/pagination/DescribeLocalGatewayRouteTablesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeLocalGatewayRouteTablesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeLocalGatewayRouteTablesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLocalGatewayRouteTablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeLocalGatewayRouteTablesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeLocalGatewayVirtualInterfaceGroupsPaginator.ts b/clients/client-ec2/pagination/DescribeLocalGatewayVirtualInterfaceGroupsPaginator.ts index 7a21862455c18..8f3981db3fa81 100644 --- a/clients/client-ec2/pagination/DescribeLocalGatewayVirtualInterfaceGroupsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeLocalGatewayVirtualInterfaceGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeLocalGatewayVirtualInterfaceGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLocalGatewayVirtualInterfaceGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeLocalGatewayVirtualInterfaceGroupsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeLocalGatewayVirtualInterfacesPaginator.ts b/clients/client-ec2/pagination/DescribeLocalGatewayVirtualInterfacesPaginator.ts index 018bf99ac9909..4b6a57a31b661 100644 --- a/clients/client-ec2/pagination/DescribeLocalGatewayVirtualInterfacesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeLocalGatewayVirtualInterfacesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeLocalGatewayVirtualInterfacesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLocalGatewayVirtualInterfacesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeLocalGatewayVirtualInterfacesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeLocalGatewaysPaginator.ts b/clients/client-ec2/pagination/DescribeLocalGatewaysPaginator.ts index 2ec7dcf3ff51c..373f05e0b2be3 100644 --- a/clients/client-ec2/pagination/DescribeLocalGatewaysPaginator.ts +++ b/clients/client-ec2/pagination/DescribeLocalGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeLocalGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLocalGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeLocalGatewaysCommandInput, diff --git a/clients/client-ec2/pagination/DescribeManagedPrefixListsPaginator.ts b/clients/client-ec2/pagination/DescribeManagedPrefixListsPaginator.ts index b9f8b86f1454a..4092fc8e8ef5d 100644 --- a/clients/client-ec2/pagination/DescribeManagedPrefixListsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeManagedPrefixListsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeManagedPrefixListsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeManagedPrefixListsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeManagedPrefixListsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeMovingAddressesPaginator.ts b/clients/client-ec2/pagination/DescribeMovingAddressesPaginator.ts index dc23db821c4a1..6cb0189cdca81 100644 --- a/clients/client-ec2/pagination/DescribeMovingAddressesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeMovingAddressesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeMovingAddressesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMovingAddressesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeMovingAddressesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeNatGatewaysPaginator.ts b/clients/client-ec2/pagination/DescribeNatGatewaysPaginator.ts index e3e1df6116b94..f45a2fac6e78a 100644 --- a/clients/client-ec2/pagination/DescribeNatGatewaysPaginator.ts +++ b/clients/client-ec2/pagination/DescribeNatGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeNatGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeNatGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeNatGatewaysCommandInput, diff --git a/clients/client-ec2/pagination/DescribeNetworkAclsPaginator.ts b/clients/client-ec2/pagination/DescribeNetworkAclsPaginator.ts index 34e03a45d083d..bce660e91993f 100644 --- a/clients/client-ec2/pagination/DescribeNetworkAclsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeNetworkAclsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeNetworkAclsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeNetworkAclsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeNetworkAclsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeNetworkInterfacePermissionsPaginator.ts b/clients/client-ec2/pagination/DescribeNetworkInterfacePermissionsPaginator.ts index 79b164c505b8f..651beecd55d54 100644 --- a/clients/client-ec2/pagination/DescribeNetworkInterfacePermissionsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeNetworkInterfacePermissionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeNetworkInterfacePermissionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeNetworkInterfacePermissionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeNetworkInterfacePermissionsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeNetworkInterfacesPaginator.ts b/clients/client-ec2/pagination/DescribeNetworkInterfacesPaginator.ts index e850b842ca20d..65b4dd6af7fa8 100644 --- a/clients/client-ec2/pagination/DescribeNetworkInterfacesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeNetworkInterfacesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeNetworkInterfacesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeNetworkInterfacesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeNetworkInterfacesCommandInput, diff --git a/clients/client-ec2/pagination/DescribePrefixListsPaginator.ts b/clients/client-ec2/pagination/DescribePrefixListsPaginator.ts index 50d62cecd79b6..26937edee82b4 100644 --- a/clients/client-ec2/pagination/DescribePrefixListsPaginator.ts +++ b/clients/client-ec2/pagination/DescribePrefixListsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribePrefixListsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePrefixListsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribePrefixListsCommandInput, diff --git a/clients/client-ec2/pagination/DescribePrincipalIdFormatPaginator.ts b/clients/client-ec2/pagination/DescribePrincipalIdFormatPaginator.ts index 3562aa573c6d0..bbc82b64af155 100644 --- a/clients/client-ec2/pagination/DescribePrincipalIdFormatPaginator.ts +++ b/clients/client-ec2/pagination/DescribePrincipalIdFormatPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribePrincipalIdFormatCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePrincipalIdFormatCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribePrincipalIdFormatCommandInput, diff --git a/clients/client-ec2/pagination/DescribePublicIpv4PoolsPaginator.ts b/clients/client-ec2/pagination/DescribePublicIpv4PoolsPaginator.ts index 8222ffdd5f978..77243888047f6 100644 --- a/clients/client-ec2/pagination/DescribePublicIpv4PoolsPaginator.ts +++ b/clients/client-ec2/pagination/DescribePublicIpv4PoolsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribePublicIpv4PoolsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePublicIpv4PoolsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribePublicIpv4PoolsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeReservedInstancesModificationsPaginator.ts b/clients/client-ec2/pagination/DescribeReservedInstancesModificationsPaginator.ts index 99b6eba2c044c..40050696eeb97 100644 --- a/clients/client-ec2/pagination/DescribeReservedInstancesModificationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeReservedInstancesModificationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeReservedInstancesModificationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedInstancesModificationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeReservedInstancesModificationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeReservedInstancesOfferingsPaginator.ts b/clients/client-ec2/pagination/DescribeReservedInstancesOfferingsPaginator.ts index e0377a2b049de..71490ba7feb77 100644 --- a/clients/client-ec2/pagination/DescribeReservedInstancesOfferingsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeReservedInstancesOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeReservedInstancesOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedInstancesOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeReservedInstancesOfferingsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeRouteTablesPaginator.ts b/clients/client-ec2/pagination/DescribeRouteTablesPaginator.ts index f3b49272a8410..d1b7126cac3c3 100644 --- a/clients/client-ec2/pagination/DescribeRouteTablesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeRouteTablesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeRouteTablesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeRouteTablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeRouteTablesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeScheduledInstanceAvailabilityPaginator.ts b/clients/client-ec2/pagination/DescribeScheduledInstanceAvailabilityPaginator.ts index 4a1c0d2fa9d01..904c8b42a84e6 100644 --- a/clients/client-ec2/pagination/DescribeScheduledInstanceAvailabilityPaginator.ts +++ b/clients/client-ec2/pagination/DescribeScheduledInstanceAvailabilityPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeScheduledInstanceAvailabilityCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScheduledInstanceAvailabilityCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeScheduledInstanceAvailabilityCommandInput, diff --git a/clients/client-ec2/pagination/DescribeScheduledInstancesPaginator.ts b/clients/client-ec2/pagination/DescribeScheduledInstancesPaginator.ts index 35c5a4bb34cc4..56281c3899fec 100644 --- a/clients/client-ec2/pagination/DescribeScheduledInstancesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeScheduledInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeScheduledInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScheduledInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeScheduledInstancesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeSecurityGroupsPaginator.ts b/clients/client-ec2/pagination/DescribeSecurityGroupsPaginator.ts index 92a160c234bf6..ce11a001fd874 100644 --- a/clients/client-ec2/pagination/DescribeSecurityGroupsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeSecurityGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeSecurityGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSecurityGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeSecurityGroupsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeSnapshotsPaginator.ts b/clients/client-ec2/pagination/DescribeSnapshotsPaginator.ts index 8e3aefca10350..6a526bce90561 100644 --- a/clients/client-ec2/pagination/DescribeSnapshotsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeSnapshotsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeSnapshotsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSnapshotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeSnapshotsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeSpotFleetRequestsPaginator.ts b/clients/client-ec2/pagination/DescribeSpotFleetRequestsPaginator.ts index 6e76b715a445a..7fcc6793955f9 100644 --- a/clients/client-ec2/pagination/DescribeSpotFleetRequestsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeSpotFleetRequestsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeSpotFleetRequestsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSpotFleetRequestsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeSpotFleetRequestsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeSpotInstanceRequestsPaginator.ts b/clients/client-ec2/pagination/DescribeSpotInstanceRequestsPaginator.ts index 070e07c97ff7b..44324f3c2eaba 100644 --- a/clients/client-ec2/pagination/DescribeSpotInstanceRequestsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeSpotInstanceRequestsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeSpotInstanceRequestsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSpotInstanceRequestsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeSpotInstanceRequestsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeSpotPriceHistoryPaginator.ts b/clients/client-ec2/pagination/DescribeSpotPriceHistoryPaginator.ts index 8c852f78f22eb..f7bfe2f9b9306 100644 --- a/clients/client-ec2/pagination/DescribeSpotPriceHistoryPaginator.ts +++ b/clients/client-ec2/pagination/DescribeSpotPriceHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeSpotPriceHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSpotPriceHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeSpotPriceHistoryCommandInput, diff --git a/clients/client-ec2/pagination/DescribeStaleSecurityGroupsPaginator.ts b/clients/client-ec2/pagination/DescribeStaleSecurityGroupsPaginator.ts index c2d5460cb6b57..82b1bf03732e9 100644 --- a/clients/client-ec2/pagination/DescribeStaleSecurityGroupsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeStaleSecurityGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeStaleSecurityGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeStaleSecurityGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeStaleSecurityGroupsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeSubnetsPaginator.ts b/clients/client-ec2/pagination/DescribeSubnetsPaginator.ts index 3e0216575363d..978b308eb3e00 100644 --- a/clients/client-ec2/pagination/DescribeSubnetsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeSubnetsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeSubnetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSubnetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeSubnetsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTagsPaginator.ts b/clients/client-ec2/pagination/DescribeTagsPaginator.ts index dc3bff7d7bac2..23b687ef86569 100644 --- a/clients/client-ec2/pagination/DescribeTagsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTagsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTagsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTagsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTrafficMirrorFiltersPaginator.ts b/clients/client-ec2/pagination/DescribeTrafficMirrorFiltersPaginator.ts index 5c3f95fa6470f..46e65de1becfb 100644 --- a/clients/client-ec2/pagination/DescribeTrafficMirrorFiltersPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTrafficMirrorFiltersPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTrafficMirrorFiltersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTrafficMirrorFiltersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTrafficMirrorFiltersCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTrafficMirrorSessionsPaginator.ts b/clients/client-ec2/pagination/DescribeTrafficMirrorSessionsPaginator.ts index 7b57f6fc07dfb..12b7ee4a19a19 100644 --- a/clients/client-ec2/pagination/DescribeTrafficMirrorSessionsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTrafficMirrorSessionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTrafficMirrorSessionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTrafficMirrorSessionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTrafficMirrorSessionsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTrafficMirrorTargetsPaginator.ts b/clients/client-ec2/pagination/DescribeTrafficMirrorTargetsPaginator.ts index 388600c4c4068..ea41d7eff704b 100644 --- a/clients/client-ec2/pagination/DescribeTrafficMirrorTargetsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTrafficMirrorTargetsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTrafficMirrorTargetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTrafficMirrorTargetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTrafficMirrorTargetsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTransitGatewayAttachmentsPaginator.ts b/clients/client-ec2/pagination/DescribeTransitGatewayAttachmentsPaginator.ts index 409aed3dcf64e..10ad6bc060d0e 100644 --- a/clients/client-ec2/pagination/DescribeTransitGatewayAttachmentsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTransitGatewayAttachmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTransitGatewayAttachmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTransitGatewayAttachmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTransitGatewayAttachmentsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTransitGatewayMulticastDomainsPaginator.ts b/clients/client-ec2/pagination/DescribeTransitGatewayMulticastDomainsPaginator.ts index 88d9fa02ebe7e..05bd47c0eecde 100644 --- a/clients/client-ec2/pagination/DescribeTransitGatewayMulticastDomainsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTransitGatewayMulticastDomainsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTransitGatewayMulticastDomainsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTransitGatewayMulticastDomainsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTransitGatewayMulticastDomainsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTransitGatewayPeeringAttachmentsPaginator.ts b/clients/client-ec2/pagination/DescribeTransitGatewayPeeringAttachmentsPaginator.ts index 1cced79f12b4d..6c45bd89ebc56 100644 --- a/clients/client-ec2/pagination/DescribeTransitGatewayPeeringAttachmentsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTransitGatewayPeeringAttachmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTransitGatewayPeeringAttachmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTransitGatewayPeeringAttachmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTransitGatewayPeeringAttachmentsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTransitGatewayRouteTablesPaginator.ts b/clients/client-ec2/pagination/DescribeTransitGatewayRouteTablesPaginator.ts index 8a26516e85eeb..2ec40ff21c0c6 100644 --- a/clients/client-ec2/pagination/DescribeTransitGatewayRouteTablesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTransitGatewayRouteTablesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTransitGatewayRouteTablesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTransitGatewayRouteTablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTransitGatewayRouteTablesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTransitGatewayVpcAttachmentsPaginator.ts b/clients/client-ec2/pagination/DescribeTransitGatewayVpcAttachmentsPaginator.ts index b500c30304298..407749ca4e0bf 100644 --- a/clients/client-ec2/pagination/DescribeTransitGatewayVpcAttachmentsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTransitGatewayVpcAttachmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTransitGatewayVpcAttachmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTransitGatewayVpcAttachmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTransitGatewayVpcAttachmentsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeTransitGatewaysPaginator.ts b/clients/client-ec2/pagination/DescribeTransitGatewaysPaginator.ts index 6675fdddebb08..bd6d27b2ffaeb 100644 --- a/clients/client-ec2/pagination/DescribeTransitGatewaysPaginator.ts +++ b/clients/client-ec2/pagination/DescribeTransitGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeTransitGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTransitGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeTransitGatewaysCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVolumeStatusPaginator.ts b/clients/client-ec2/pagination/DescribeVolumeStatusPaginator.ts index fcd073062e667..c54813636e948 100644 --- a/clients/client-ec2/pagination/DescribeVolumeStatusPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVolumeStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVolumeStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVolumeStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVolumeStatusCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVolumesModificationsPaginator.ts b/clients/client-ec2/pagination/DescribeVolumesModificationsPaginator.ts index d1a6dc48ec442..9585e69119c1a 100644 --- a/clients/client-ec2/pagination/DescribeVolumesModificationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVolumesModificationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVolumesModificationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVolumesModificationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVolumesModificationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVolumesPaginator.ts b/clients/client-ec2/pagination/DescribeVolumesPaginator.ts index e3f27a1702c20..246270e6059a6 100644 --- a/clients/client-ec2/pagination/DescribeVolumesPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVolumesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVolumesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVolumesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVolumesCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVpcClassicLinkDnsSupportPaginator.ts b/clients/client-ec2/pagination/DescribeVpcClassicLinkDnsSupportPaginator.ts index 87bbf9d187b19..f5e16ff35b2ea 100644 --- a/clients/client-ec2/pagination/DescribeVpcClassicLinkDnsSupportPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVpcClassicLinkDnsSupportPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVpcClassicLinkDnsSupportCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVpcClassicLinkDnsSupportCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVpcClassicLinkDnsSupportCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVpcEndpointConnectionNotificationsPaginator.ts b/clients/client-ec2/pagination/DescribeVpcEndpointConnectionNotificationsPaginator.ts index 0e844e3218765..c1179296d3068 100644 --- a/clients/client-ec2/pagination/DescribeVpcEndpointConnectionNotificationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVpcEndpointConnectionNotificationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVpcEndpointConnectionNotificationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVpcEndpointConnectionNotificationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVpcEndpointConnectionNotificationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVpcEndpointConnectionsPaginator.ts b/clients/client-ec2/pagination/DescribeVpcEndpointConnectionsPaginator.ts index 33dfbad57b3f3..1a4a6dfcc5e4e 100644 --- a/clients/client-ec2/pagination/DescribeVpcEndpointConnectionsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVpcEndpointConnectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVpcEndpointConnectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVpcEndpointConnectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVpcEndpointConnectionsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVpcEndpointServiceConfigurationsPaginator.ts b/clients/client-ec2/pagination/DescribeVpcEndpointServiceConfigurationsPaginator.ts index 4c06f751359af..e3f2d8e6c7885 100644 --- a/clients/client-ec2/pagination/DescribeVpcEndpointServiceConfigurationsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVpcEndpointServiceConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVpcEndpointServiceConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVpcEndpointServiceConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVpcEndpointServiceConfigurationsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVpcEndpointServicePermissionsPaginator.ts b/clients/client-ec2/pagination/DescribeVpcEndpointServicePermissionsPaginator.ts index f7dd745a4b196..f4e57c51f788d 100644 --- a/clients/client-ec2/pagination/DescribeVpcEndpointServicePermissionsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVpcEndpointServicePermissionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVpcEndpointServicePermissionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVpcEndpointServicePermissionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVpcEndpointServicePermissionsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVpcEndpointsPaginator.ts b/clients/client-ec2/pagination/DescribeVpcEndpointsPaginator.ts index ff988222a4708..459c7a6f41822 100644 --- a/clients/client-ec2/pagination/DescribeVpcEndpointsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVpcEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVpcEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVpcEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVpcEndpointsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVpcPeeringConnectionsPaginator.ts b/clients/client-ec2/pagination/DescribeVpcPeeringConnectionsPaginator.ts index 57626d3af62ba..898fa61d5322d 100644 --- a/clients/client-ec2/pagination/DescribeVpcPeeringConnectionsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVpcPeeringConnectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVpcPeeringConnectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVpcPeeringConnectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVpcPeeringConnectionsCommandInput, diff --git a/clients/client-ec2/pagination/DescribeVpcsPaginator.ts b/clients/client-ec2/pagination/DescribeVpcsPaginator.ts index d5c49caf22271..1c27af59c79fe 100644 --- a/clients/client-ec2/pagination/DescribeVpcsPaginator.ts +++ b/clients/client-ec2/pagination/DescribeVpcsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: DescribeVpcsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVpcsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: DescribeVpcsCommandInput, diff --git a/clients/client-ec2/pagination/GetAssociatedIpv6PoolCidrsPaginator.ts b/clients/client-ec2/pagination/GetAssociatedIpv6PoolCidrsPaginator.ts index eeacb146ec719..601c6fa316bd3 100644 --- a/clients/client-ec2/pagination/GetAssociatedIpv6PoolCidrsPaginator.ts +++ b/clients/client-ec2/pagination/GetAssociatedIpv6PoolCidrsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetAssociatedIpv6PoolCidrsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetAssociatedIpv6PoolCidrsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetAssociatedIpv6PoolCidrsCommandInput, diff --git a/clients/client-ec2/pagination/GetGroupsForCapacityReservationPaginator.ts b/clients/client-ec2/pagination/GetGroupsForCapacityReservationPaginator.ts index 7110625d37150..051dd199d5ffd 100644 --- a/clients/client-ec2/pagination/GetGroupsForCapacityReservationPaginator.ts +++ b/clients/client-ec2/pagination/GetGroupsForCapacityReservationPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetGroupsForCapacityReservationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetGroupsForCapacityReservationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetGroupsForCapacityReservationCommandInput, diff --git a/clients/client-ec2/pagination/GetManagedPrefixListAssociationsPaginator.ts b/clients/client-ec2/pagination/GetManagedPrefixListAssociationsPaginator.ts index cfe122f6b68f5..d47ae6cf4d600 100644 --- a/clients/client-ec2/pagination/GetManagedPrefixListAssociationsPaginator.ts +++ b/clients/client-ec2/pagination/GetManagedPrefixListAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetManagedPrefixListAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetManagedPrefixListAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetManagedPrefixListAssociationsCommandInput, diff --git a/clients/client-ec2/pagination/GetManagedPrefixListEntriesPaginator.ts b/clients/client-ec2/pagination/GetManagedPrefixListEntriesPaginator.ts index 006418248a806..adfaad8f2458b 100644 --- a/clients/client-ec2/pagination/GetManagedPrefixListEntriesPaginator.ts +++ b/clients/client-ec2/pagination/GetManagedPrefixListEntriesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetManagedPrefixListEntriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetManagedPrefixListEntriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetManagedPrefixListEntriesCommandInput, diff --git a/clients/client-ec2/pagination/GetTransitGatewayAttachmentPropagationsPaginator.ts b/clients/client-ec2/pagination/GetTransitGatewayAttachmentPropagationsPaginator.ts index 9eadf2f6de109..a0815cfa0f032 100644 --- a/clients/client-ec2/pagination/GetTransitGatewayAttachmentPropagationsPaginator.ts +++ b/clients/client-ec2/pagination/GetTransitGatewayAttachmentPropagationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetTransitGatewayAttachmentPropagationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTransitGatewayAttachmentPropagationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetTransitGatewayAttachmentPropagationsCommandInput, diff --git a/clients/client-ec2/pagination/GetTransitGatewayMulticastDomainAssociationsPaginator.ts b/clients/client-ec2/pagination/GetTransitGatewayMulticastDomainAssociationsPaginator.ts index 1a8803997b526..8d495a31fc1e5 100644 --- a/clients/client-ec2/pagination/GetTransitGatewayMulticastDomainAssociationsPaginator.ts +++ b/clients/client-ec2/pagination/GetTransitGatewayMulticastDomainAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetTransitGatewayMulticastDomainAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTransitGatewayMulticastDomainAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetTransitGatewayMulticastDomainAssociationsCommandInput, diff --git a/clients/client-ec2/pagination/GetTransitGatewayPrefixListReferencesPaginator.ts b/clients/client-ec2/pagination/GetTransitGatewayPrefixListReferencesPaginator.ts index c7ed91192e47c..ade72ee007c73 100644 --- a/clients/client-ec2/pagination/GetTransitGatewayPrefixListReferencesPaginator.ts +++ b/clients/client-ec2/pagination/GetTransitGatewayPrefixListReferencesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetTransitGatewayPrefixListReferencesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTransitGatewayPrefixListReferencesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetTransitGatewayPrefixListReferencesCommandInput, diff --git a/clients/client-ec2/pagination/GetTransitGatewayRouteTableAssociationsPaginator.ts b/clients/client-ec2/pagination/GetTransitGatewayRouteTableAssociationsPaginator.ts index 9f5cb4bfab510..3569f5d33ebc9 100644 --- a/clients/client-ec2/pagination/GetTransitGatewayRouteTableAssociationsPaginator.ts +++ b/clients/client-ec2/pagination/GetTransitGatewayRouteTableAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetTransitGatewayRouteTableAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTransitGatewayRouteTableAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetTransitGatewayRouteTableAssociationsCommandInput, diff --git a/clients/client-ec2/pagination/GetTransitGatewayRouteTablePropagationsPaginator.ts b/clients/client-ec2/pagination/GetTransitGatewayRouteTablePropagationsPaginator.ts index cb7898708fc4a..b777c118e020b 100644 --- a/clients/client-ec2/pagination/GetTransitGatewayRouteTablePropagationsPaginator.ts +++ b/clients/client-ec2/pagination/GetTransitGatewayRouteTablePropagationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: GetTransitGatewayRouteTablePropagationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTransitGatewayRouteTablePropagationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: GetTransitGatewayRouteTablePropagationsCommandInput, diff --git a/clients/client-ec2/pagination/SearchLocalGatewayRoutesPaginator.ts b/clients/client-ec2/pagination/SearchLocalGatewayRoutesPaginator.ts index 15f5fb67440e8..9f0acd6087a56 100644 --- a/clients/client-ec2/pagination/SearchLocalGatewayRoutesPaginator.ts +++ b/clients/client-ec2/pagination/SearchLocalGatewayRoutesPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: SearchLocalGatewayRoutesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchLocalGatewayRoutesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: SearchLocalGatewayRoutesCommandInput, diff --git a/clients/client-ec2/pagination/SearchTransitGatewayMulticastGroupsPaginator.ts b/clients/client-ec2/pagination/SearchTransitGatewayMulticastGroupsPaginator.ts index d3421031cf8c3..20ee4b724de77 100644 --- a/clients/client-ec2/pagination/SearchTransitGatewayMulticastGroupsPaginator.ts +++ b/clients/client-ec2/pagination/SearchTransitGatewayMulticastGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { EC2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EC2Client, input: SearchTransitGatewayMulticastGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchTransitGatewayMulticastGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EC2, input: SearchTransitGatewayMulticastGroupsCommandInput, diff --git a/clients/client-ec2/runtimeConfig.browser.ts b/clients/client-ec2/runtimeConfig.browser.ts index 68832cc300913..1aa7cf58f2c70 100644 --- a/clients/client-ec2/runtimeConfig.browser.ts +++ b/clients/client-ec2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./EC2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ec2/runtimeConfig.native.ts b/clients/client-ec2/runtimeConfig.native.ts index 2242aea937a54..8f7b7fcc1d8f5 100644 --- a/clients/client-ec2/runtimeConfig.native.ts +++ b/clients/client-ec2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./EC2Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ec2/runtimeConfig.shared.ts b/clients/client-ec2/runtimeConfig.shared.ts index 06fbb3eaeb117..91def91d414ce 100644 --- a/clients/client-ec2/runtimeConfig.shared.ts +++ b/clients/client-ec2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-11-15", disableHostPrefix: false, diff --git a/clients/client-ec2/runtimeConfig.ts b/clients/client-ec2/runtimeConfig.ts index 62e1682c9c13a..e087b571b3030 100644 --- a/clients/client-ec2/runtimeConfig.ts +++ b/clients/client-ec2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./EC2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ec2/tsconfig.json b/clients/client-ec2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ec2/tsconfig.json +++ b/clients/client-ec2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ecr/commands/BatchCheckLayerAvailabilityCommand.ts b/clients/client-ecr/commands/BatchCheckLayerAvailabilityCommand.ts index b8811dc44f1a0..fbd2761273ae8 100644 --- a/clients/client-ecr/commands/BatchCheckLayerAvailabilityCommand.ts +++ b/clients/client-ecr/commands/BatchCheckLayerAvailabilityCommand.ts @@ -20,6 +20,16 @@ import { export type BatchCheckLayerAvailabilityCommandInput = BatchCheckLayerAvailabilityRequest; export type BatchCheckLayerAvailabilityCommandOutput = BatchCheckLayerAvailabilityResponse & __MetadataBearer; +/** + *

Checks the availability of one or more image layers in a repository.

+ *

When an image is pushed to a repository, each image layer is checked to verify if it + * has been uploaded before. If it has been uploaded, then the image layer is + * skipped.

+ * + *

This operation is used by the Amazon ECR proxy and is not generally used by + * customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

+ *
+ */ export class BatchCheckLayerAvailabilityCommand extends $Command< BatchCheckLayerAvailabilityCommandInput, BatchCheckLayerAvailabilityCommandOutput, @@ -34,6 +44,9 @@ export class BatchCheckLayerAvailabilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/BatchDeleteImageCommand.ts b/clients/client-ecr/commands/BatchDeleteImageCommand.ts index 032ca369ea2fb..83a04d9ce917b 100644 --- a/clients/client-ecr/commands/BatchDeleteImageCommand.ts +++ b/clients/client-ecr/commands/BatchDeleteImageCommand.ts @@ -20,6 +20,14 @@ import { export type BatchDeleteImageCommandInput = BatchDeleteImageRequest; export type BatchDeleteImageCommandOutput = BatchDeleteImageResponse & __MetadataBearer; +/** + *

Deletes a list of specified images within a repository. Images are specified with + * either an imageTag or imageDigest.

+ *

You can remove a tag from an image by specifying the image's tag in your request. When + * you remove the last tag from an image, the image is deleted from your repository.

+ *

You can completely delete an image (and all of its tags) by specifying the image's + * digest in your request.

+ */ export class BatchDeleteImageCommand extends $Command< BatchDeleteImageCommandInput, BatchDeleteImageCommandOutput, @@ -34,6 +42,9 @@ export class BatchDeleteImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/BatchGetImageCommand.ts b/clients/client-ecr/commands/BatchGetImageCommand.ts index 500d299f02bed..6ccf291ef63cd 100644 --- a/clients/client-ecr/commands/BatchGetImageCommand.ts +++ b/clients/client-ecr/commands/BatchGetImageCommand.ts @@ -20,6 +20,12 @@ import { export type BatchGetImageCommandInput = BatchGetImageRequest; export type BatchGetImageCommandOutput = BatchGetImageResponse & __MetadataBearer; +/** + *

Gets detailed information for an image. Images are specified with either an + * imageTag or imageDigest.

+ *

When an image is pulled, the BatchGetImage API is called once to retrieve the image + * manifest.

+ */ export class BatchGetImageCommand extends $Command< BatchGetImageCommandInput, BatchGetImageCommandOutput, @@ -34,6 +40,9 @@ export class BatchGetImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/CompleteLayerUploadCommand.ts b/clients/client-ecr/commands/CompleteLayerUploadCommand.ts index f48f139e61749..a32411499c0de 100644 --- a/clients/client-ecr/commands/CompleteLayerUploadCommand.ts +++ b/clients/client-ecr/commands/CompleteLayerUploadCommand.ts @@ -20,6 +20,17 @@ import { export type CompleteLayerUploadCommandInput = CompleteLayerUploadRequest; export type CompleteLayerUploadCommandOutput = CompleteLayerUploadResponse & __MetadataBearer; +/** + *

Informs Amazon ECR that the image layer upload has completed for a specified registry, + * repository name, and upload ID. You can optionally provide a sha256 digest + * of the image layer for data validation purposes.

+ *

When an image is pushed, the CompleteLayerUpload API is called once per each new image + * layer to verify that the upload has completed.

+ * + *

This operation is used by the Amazon ECR proxy and is not generally used by + * customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

+ *
+ */ export class CompleteLayerUploadCommand extends $Command< CompleteLayerUploadCommandInput, CompleteLayerUploadCommandOutput, @@ -34,6 +45,9 @@ export class CompleteLayerUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/CreateRepositoryCommand.ts b/clients/client-ecr/commands/CreateRepositoryCommand.ts index a8b72bb406699..b7df891e132fd 100644 --- a/clients/client-ecr/commands/CreateRepositoryCommand.ts +++ b/clients/client-ecr/commands/CreateRepositoryCommand.ts @@ -20,6 +20,10 @@ import { export type CreateRepositoryCommandInput = CreateRepositoryRequest; export type CreateRepositoryCommandOutput = CreateRepositoryResponse & __MetadataBearer; +/** + *

Creates a repository. For more information, see Amazon ECR Repositories in the + * Amazon Elastic Container Registry User Guide.

+ */ export class CreateRepositoryCommand extends $Command< CreateRepositoryCommandInput, CreateRepositoryCommandOutput, @@ -34,6 +38,9 @@ export class CreateRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/DeleteLifecyclePolicyCommand.ts b/clients/client-ecr/commands/DeleteLifecyclePolicyCommand.ts index b32df15fb391d..480ca20e2a863 100644 --- a/clients/client-ecr/commands/DeleteLifecyclePolicyCommand.ts +++ b/clients/client-ecr/commands/DeleteLifecyclePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLifecyclePolicyCommandInput = DeleteLifecyclePolicyRequest; export type DeleteLifecyclePolicyCommandOutput = DeleteLifecyclePolicyResponse & __MetadataBearer; +/** + *

Deletes the lifecycle policy associated with the specified repository.

+ */ export class DeleteLifecyclePolicyCommand extends $Command< DeleteLifecyclePolicyCommandInput, DeleteLifecyclePolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/DeleteRepositoryCommand.ts b/clients/client-ecr/commands/DeleteRepositoryCommand.ts index 5d1b13691b573..12d27f921f417 100644 --- a/clients/client-ecr/commands/DeleteRepositoryCommand.ts +++ b/clients/client-ecr/commands/DeleteRepositoryCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteRepositoryCommandInput = DeleteRepositoryRequest; export type DeleteRepositoryCommandOutput = DeleteRepositoryResponse & __MetadataBearer; +/** + *

Deletes a repository. If the repository contains images, you must either delete all + * images in the repository or use the force option to delete the + * repository.

+ */ export class DeleteRepositoryCommand extends $Command< DeleteRepositoryCommandInput, DeleteRepositoryCommandOutput, @@ -34,6 +39,9 @@ export class DeleteRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/DeleteRepositoryPolicyCommand.ts b/clients/client-ecr/commands/DeleteRepositoryPolicyCommand.ts index 57a8b29f6245d..54ce2b3659c9b 100644 --- a/clients/client-ecr/commands/DeleteRepositoryPolicyCommand.ts +++ b/clients/client-ecr/commands/DeleteRepositoryPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRepositoryPolicyCommandInput = DeleteRepositoryPolicyRequest; export type DeleteRepositoryPolicyCommandOutput = DeleteRepositoryPolicyResponse & __MetadataBearer; +/** + *

Deletes the repository policy associated with the specified repository.

+ */ export class DeleteRepositoryPolicyCommand extends $Command< DeleteRepositoryPolicyCommandInput, DeleteRepositoryPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRepositoryPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/DescribeImageScanFindingsCommand.ts b/clients/client-ecr/commands/DescribeImageScanFindingsCommand.ts index a1930c9dd5c30..ca9c67ae40a47 100644 --- a/clients/client-ecr/commands/DescribeImageScanFindingsCommand.ts +++ b/clients/client-ecr/commands/DescribeImageScanFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImageScanFindingsCommandInput = DescribeImageScanFindingsRequest; export type DescribeImageScanFindingsCommandOutput = DescribeImageScanFindingsResponse & __MetadataBearer; +/** + *

Returns the scan findings for the specified image.

+ */ export class DescribeImageScanFindingsCommand extends $Command< DescribeImageScanFindingsCommandInput, DescribeImageScanFindingsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImageScanFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/DescribeImagesCommand.ts b/clients/client-ecr/commands/DescribeImagesCommand.ts index 23304d2cade8d..ec63fd46b5d2b 100644 --- a/clients/client-ecr/commands/DescribeImagesCommand.ts +++ b/clients/client-ecr/commands/DescribeImagesCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeImagesCommandInput = DescribeImagesRequest; export type DescribeImagesCommandOutput = DescribeImagesResponse & __MetadataBearer; +/** + *

Returns metadata about the images in a repository.

+ * + *

Beginning with Docker version 1.9, the Docker client compresses image layers + * before pushing them to a V2 Docker registry. The output of the docker + * images command shows the uncompressed image size, so it may return a + * larger image size than the image sizes returned by DescribeImages.

+ *
+ */ export class DescribeImagesCommand extends $Command< DescribeImagesCommandInput, DescribeImagesCommandOutput, @@ -34,6 +43,9 @@ export class DescribeImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/DescribeRepositoriesCommand.ts b/clients/client-ecr/commands/DescribeRepositoriesCommand.ts index a2aef4dd5d407..db0f2862a17a7 100644 --- a/clients/client-ecr/commands/DescribeRepositoriesCommand.ts +++ b/clients/client-ecr/commands/DescribeRepositoriesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRepositoriesCommandInput = DescribeRepositoriesRequest; export type DescribeRepositoriesCommandOutput = DescribeRepositoriesResponse & __MetadataBearer; +/** + *

Describes image repositories in a registry.

+ */ export class DescribeRepositoriesCommand extends $Command< DescribeRepositoriesCommandInput, DescribeRepositoriesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRepositoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/GetAuthorizationTokenCommand.ts b/clients/client-ecr/commands/GetAuthorizationTokenCommand.ts index f8e4b53fb6db9..8292448dd32b1 100644 --- a/clients/client-ecr/commands/GetAuthorizationTokenCommand.ts +++ b/clients/client-ecr/commands/GetAuthorizationTokenCommand.ts @@ -20,6 +20,16 @@ import { export type GetAuthorizationTokenCommandInput = GetAuthorizationTokenRequest; export type GetAuthorizationTokenCommandOutput = GetAuthorizationTokenResponse & __MetadataBearer; +/** + *

Retrieves an authorization token. An authorization token represents your IAM + * authentication credentials and can be used to access any Amazon ECR registry that your IAM + * principal has access to. The authorization token is valid for 12 hours.

+ *

The authorizationToken returned is a base64 encoded string that can be + * decoded and used in a docker login command to authenticate to a registry. + * The AWS CLI offers an get-login-password command that simplifies the login + * process. For more information, see Registry + * Authentication in the Amazon Elastic Container Registry User Guide.

+ */ export class GetAuthorizationTokenCommand extends $Command< GetAuthorizationTokenCommandInput, GetAuthorizationTokenCommandOutput, @@ -34,6 +44,9 @@ export class GetAuthorizationTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/GetDownloadUrlForLayerCommand.ts b/clients/client-ecr/commands/GetDownloadUrlForLayerCommand.ts index dc3918200e979..e6cd4561e1bbc 100644 --- a/clients/client-ecr/commands/GetDownloadUrlForLayerCommand.ts +++ b/clients/client-ecr/commands/GetDownloadUrlForLayerCommand.ts @@ -20,6 +20,16 @@ import { export type GetDownloadUrlForLayerCommandInput = GetDownloadUrlForLayerRequest; export type GetDownloadUrlForLayerCommandOutput = GetDownloadUrlForLayerResponse & __MetadataBearer; +/** + *

Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You + * can only get URLs for image layers that are referenced in an image.

+ *

When an image is pulled, the GetDownloadUrlForLayer API is called once per image layer + * that is not already cached.

+ * + *

This operation is used by the Amazon ECR proxy and is not generally used by + * customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

+ *
+ */ export class GetDownloadUrlForLayerCommand extends $Command< GetDownloadUrlForLayerCommandInput, GetDownloadUrlForLayerCommandOutput, @@ -34,6 +44,9 @@ export class GetDownloadUrlForLayerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/GetLifecyclePolicyCommand.ts b/clients/client-ecr/commands/GetLifecyclePolicyCommand.ts index 9008d79bf03ef..c31f8ed55d697 100644 --- a/clients/client-ecr/commands/GetLifecyclePolicyCommand.ts +++ b/clients/client-ecr/commands/GetLifecyclePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetLifecyclePolicyCommandInput = GetLifecyclePolicyRequest; export type GetLifecyclePolicyCommandOutput = GetLifecyclePolicyResponse & __MetadataBearer; +/** + *

Retrieves the lifecycle policy for the specified repository.

+ */ export class GetLifecyclePolicyCommand extends $Command< GetLifecyclePolicyCommandInput, GetLifecyclePolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/GetLifecyclePolicyPreviewCommand.ts b/clients/client-ecr/commands/GetLifecyclePolicyPreviewCommand.ts index a75f0d96ad3d3..b713e53a77b4a 100644 --- a/clients/client-ecr/commands/GetLifecyclePolicyPreviewCommand.ts +++ b/clients/client-ecr/commands/GetLifecyclePolicyPreviewCommand.ts @@ -20,6 +20,10 @@ import { export type GetLifecyclePolicyPreviewCommandInput = GetLifecyclePolicyPreviewRequest; export type GetLifecyclePolicyPreviewCommandOutput = GetLifecyclePolicyPreviewResponse & __MetadataBearer; +/** + *

Retrieves the results of the lifecycle policy preview request for the specified + * repository.

+ */ export class GetLifecyclePolicyPreviewCommand extends $Command< GetLifecyclePolicyPreviewCommandInput, GetLifecyclePolicyPreviewCommandOutput, @@ -34,6 +38,9 @@ export class GetLifecyclePolicyPreviewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/GetRepositoryPolicyCommand.ts b/clients/client-ecr/commands/GetRepositoryPolicyCommand.ts index 2d2ec52169f1e..0d6dc63a877f8 100644 --- a/clients/client-ecr/commands/GetRepositoryPolicyCommand.ts +++ b/clients/client-ecr/commands/GetRepositoryPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetRepositoryPolicyCommandInput = GetRepositoryPolicyRequest; export type GetRepositoryPolicyCommandOutput = GetRepositoryPolicyResponse & __MetadataBearer; +/** + *

Retrieves the repository policy for the specified repository.

+ */ export class GetRepositoryPolicyCommand extends $Command< GetRepositoryPolicyCommandInput, GetRepositoryPolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetRepositoryPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/InitiateLayerUploadCommand.ts b/clients/client-ecr/commands/InitiateLayerUploadCommand.ts index 7202f73a975aa..3e6cd0ac610f7 100644 --- a/clients/client-ecr/commands/InitiateLayerUploadCommand.ts +++ b/clients/client-ecr/commands/InitiateLayerUploadCommand.ts @@ -20,6 +20,16 @@ import { export type InitiateLayerUploadCommandInput = InitiateLayerUploadRequest; export type InitiateLayerUploadCommandOutput = InitiateLayerUploadResponse & __MetadataBearer; +/** + *

Notifies Amazon ECR that you intend to upload an image layer.

+ *

When an image is pushed, the InitiateLayerUpload API is called once per image layer + * that has not already been uploaded. Whether or not an image layer has been uploaded is + * determined by the BatchCheckLayerAvailability API action.

+ * + *

This operation is used by the Amazon ECR proxy and is not generally used by + * customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

+ *
+ */ export class InitiateLayerUploadCommand extends $Command< InitiateLayerUploadCommandInput, InitiateLayerUploadCommandOutput, @@ -34,6 +44,9 @@ export class InitiateLayerUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/ListImagesCommand.ts b/clients/client-ecr/commands/ListImagesCommand.ts index cc50817c22620..960066daadd50 100644 --- a/clients/client-ecr/commands/ListImagesCommand.ts +++ b/clients/client-ecr/commands/ListImagesCommand.ts @@ -20,6 +20,15 @@ import { export type ListImagesCommandInput = ListImagesRequest; export type ListImagesCommandOutput = ListImagesResponse & __MetadataBearer; +/** + *

Lists all the image IDs for the specified repository.

+ *

You can filter images based on whether or not they are tagged by using the + * tagStatus filter and specifying either TAGGED, + * UNTAGGED or ANY. For example, you can filter your results + * to return only UNTAGGED images and then pipe that result to a BatchDeleteImage operation to delete them. Or, you can filter your + * results to return only TAGGED images to list all of the tags in your + * repository.

+ */ export class ListImagesCommand extends $Command< ListImagesCommandInput, ListImagesCommandOutput, @@ -34,6 +43,9 @@ export class ListImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/ListTagsForResourceCommand.ts b/clients/client-ecr/commands/ListTagsForResourceCommand.ts index 61bc26b61615f..2db8663b46602 100644 --- a/clients/client-ecr/commands/ListTagsForResourceCommand.ts +++ b/clients/client-ecr/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

List the tags for an Amazon ECR resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/PutImageCommand.ts b/clients/client-ecr/commands/PutImageCommand.ts index c403deb3fd849..e3eca47bf4774 100644 --- a/clients/client-ecr/commands/PutImageCommand.ts +++ b/clients/client-ecr/commands/PutImageCommand.ts @@ -17,6 +17,17 @@ import { export type PutImageCommandInput = PutImageRequest; export type PutImageCommandOutput = PutImageResponse & __MetadataBearer; +/** + *

Creates or updates the image manifest and tags associated with an image.

+ *

When an image is pushed and all new image layers have been uploaded, the PutImage API + * is called once to create or update the image manifest and the tags associated with the + * image.

+ * + * + *

This operation is used by the Amazon ECR proxy and is not generally used by + * customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

+ *
+ */ export class PutImageCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +38,9 @@ export class PutImageCommand extends $Command, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/PutImageScanningConfigurationCommand.ts b/clients/client-ecr/commands/PutImageScanningConfigurationCommand.ts index dc57fa47f9534..c9711a6674727 100644 --- a/clients/client-ecr/commands/PutImageScanningConfigurationCommand.ts +++ b/clients/client-ecr/commands/PutImageScanningConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type PutImageScanningConfigurationCommandInput = PutImageScanningConfigurationRequest; export type PutImageScanningConfigurationCommandOutput = PutImageScanningConfigurationResponse & __MetadataBearer; +/** + *

Updates the image scanning configuration for the specified repository.

+ */ export class PutImageScanningConfigurationCommand extends $Command< PutImageScanningConfigurationCommandInput, PutImageScanningConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class PutImageScanningConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/PutImageTagMutabilityCommand.ts b/clients/client-ecr/commands/PutImageTagMutabilityCommand.ts index ff308f1d8ccbd..403418872d18c 100644 --- a/clients/client-ecr/commands/PutImageTagMutabilityCommand.ts +++ b/clients/client-ecr/commands/PutImageTagMutabilityCommand.ts @@ -20,6 +20,11 @@ import { export type PutImageTagMutabilityCommandInput = PutImageTagMutabilityRequest; export type PutImageTagMutabilityCommandOutput = PutImageTagMutabilityResponse & __MetadataBearer; +/** + *

Updates the image tag mutability settings for the specified repository. For more + * information, see Image Tag + * Mutability in the Amazon Elastic Container Registry User Guide.

+ */ export class PutImageTagMutabilityCommand extends $Command< PutImageTagMutabilityCommandInput, PutImageTagMutabilityCommandOutput, @@ -34,6 +39,9 @@ export class PutImageTagMutabilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/PutLifecyclePolicyCommand.ts b/clients/client-ecr/commands/PutLifecyclePolicyCommand.ts index 402b69eac7615..3da8d19d4f0dd 100644 --- a/clients/client-ecr/commands/PutLifecyclePolicyCommand.ts +++ b/clients/client-ecr/commands/PutLifecyclePolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutLifecyclePolicyCommandInput = PutLifecyclePolicyRequest; export type PutLifecyclePolicyCommandOutput = PutLifecyclePolicyResponse & __MetadataBearer; +/** + *

Creates or updates the lifecycle policy for the specified repository. For more + * information, see Lifecycle Policy + * Template.

+ */ export class PutLifecyclePolicyCommand extends $Command< PutLifecyclePolicyCommandInput, PutLifecyclePolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/SetRepositoryPolicyCommand.ts b/clients/client-ecr/commands/SetRepositoryPolicyCommand.ts index 1d5532109eb04..40885f2ff8229 100644 --- a/clients/client-ecr/commands/SetRepositoryPolicyCommand.ts +++ b/clients/client-ecr/commands/SetRepositoryPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type SetRepositoryPolicyCommandInput = SetRepositoryPolicyRequest; export type SetRepositoryPolicyCommandOutput = SetRepositoryPolicyResponse & __MetadataBearer; +/** + *

Applies a repository policy to the specified repository to control access permissions. + * For more information, see Amazon ECR Repository + * Policies in the Amazon Elastic Container Registry User Guide.

+ */ export class SetRepositoryPolicyCommand extends $Command< SetRepositoryPolicyCommandInput, SetRepositoryPolicyCommandOutput, @@ -34,6 +39,9 @@ export class SetRepositoryPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/StartImageScanCommand.ts b/clients/client-ecr/commands/StartImageScanCommand.ts index fa3e2637ba8b0..71916827ee85d 100644 --- a/clients/client-ecr/commands/StartImageScanCommand.ts +++ b/clients/client-ecr/commands/StartImageScanCommand.ts @@ -20,6 +20,12 @@ import { export type StartImageScanCommandInput = StartImageScanRequest; export type StartImageScanCommandOutput = StartImageScanResponse & __MetadataBearer; +/** + *

Starts an image vulnerability scan. An image scan can only be started once per day on + * an individual image. This limit includes if an image was scanned on initial push. For + * more information, see Image Scanning in the + * Amazon Elastic Container Registry User Guide.

+ */ export class StartImageScanCommand extends $Command< StartImageScanCommandInput, StartImageScanCommandOutput, @@ -34,6 +40,9 @@ export class StartImageScanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/StartLifecyclePolicyPreviewCommand.ts b/clients/client-ecr/commands/StartLifecyclePolicyPreviewCommand.ts index 4e76068ef09d8..caf9934704b9c 100644 --- a/clients/client-ecr/commands/StartLifecyclePolicyPreviewCommand.ts +++ b/clients/client-ecr/commands/StartLifecyclePolicyPreviewCommand.ts @@ -20,6 +20,10 @@ import { export type StartLifecyclePolicyPreviewCommandInput = StartLifecyclePolicyPreviewRequest; export type StartLifecyclePolicyPreviewCommandOutput = StartLifecyclePolicyPreviewResponse & __MetadataBearer; +/** + *

Starts a preview of a lifecycle policy for the specified repository. This allows you + * to see the results before associating the lifecycle policy with the repository.

+ */ export class StartLifecyclePolicyPreviewCommand extends $Command< StartLifecyclePolicyPreviewCommandInput, StartLifecyclePolicyPreviewCommandOutput, @@ -34,6 +38,9 @@ export class StartLifecyclePolicyPreviewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/TagResourceCommand.ts b/clients/client-ecr/commands/TagResourceCommand.ts index 554b80c1ab667..984fbdd4d3763 100644 --- a/clients/client-ecr/commands/TagResourceCommand.ts +++ b/clients/client-ecr/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds specified tags to a resource with the specified ARN. Existing tags on a resource + * are not changed if they are not specified in the request parameters.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/UntagResourceCommand.ts b/clients/client-ecr/commands/UntagResourceCommand.ts index 14ead39f117a1..ab1686d62c5c8 100644 --- a/clients/client-ecr/commands/UntagResourceCommand.ts +++ b/clients/client-ecr/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Deletes specified tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/commands/UploadLayerPartCommand.ts b/clients/client-ecr/commands/UploadLayerPartCommand.ts index d25f095507403..5a77f10a5143a 100644 --- a/clients/client-ecr/commands/UploadLayerPartCommand.ts +++ b/clients/client-ecr/commands/UploadLayerPartCommand.ts @@ -20,6 +20,16 @@ import { export type UploadLayerPartCommandInput = UploadLayerPartRequest; export type UploadLayerPartCommandOutput = UploadLayerPartResponse & __MetadataBearer; +/** + *

Uploads an image layer part to Amazon ECR.

+ *

When an image is pushed, each new image layer is uploaded in parts. The maximum size + * of each image layer part can be 20971520 bytes (or about 20MB). The UploadLayerPart API + * is called once per each new image layer part.

+ * + *

This operation is used by the Amazon ECR proxy and is not generally used by + * customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

+ *
+ */ export class UploadLayerPartCommand extends $Command< UploadLayerPartCommandInput, UploadLayerPartCommandOutput, @@ -34,6 +44,9 @@ export class UploadLayerPartCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECRClientResolvedConfig, diff --git a/clients/client-ecr/package.json b/clients/client-ecr/package.json index b0ba80ae67e18..5be999554b795 100644 --- a/clients/client-ecr/package.json +++ b/clients/client-ecr/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ecr Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ecr/pagination/DescribeImageScanFindingsPaginator.ts b/clients/client-ecr/pagination/DescribeImageScanFindingsPaginator.ts index 733d38e6d3518..f2bb4ad206c98 100644 --- a/clients/client-ecr/pagination/DescribeImageScanFindingsPaginator.ts +++ b/clients/client-ecr/pagination/DescribeImageScanFindingsPaginator.ts @@ -8,6 +8,9 @@ import { import { ECRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECRClient, input: DescribeImageScanFindingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeImageScanFindingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECR, input: DescribeImageScanFindingsCommandInput, diff --git a/clients/client-ecr/pagination/DescribeImagesPaginator.ts b/clients/client-ecr/pagination/DescribeImagesPaginator.ts index b9a8b44d736e4..9fafce7310306 100644 --- a/clients/client-ecr/pagination/DescribeImagesPaginator.ts +++ b/clients/client-ecr/pagination/DescribeImagesPaginator.ts @@ -8,6 +8,9 @@ import { import { ECRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECRClient, input: DescribeImagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeImagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECR, input: DescribeImagesCommandInput, diff --git a/clients/client-ecr/pagination/DescribeRepositoriesPaginator.ts b/clients/client-ecr/pagination/DescribeRepositoriesPaginator.ts index f2ce9d1cc77f0..96114b60435b6 100644 --- a/clients/client-ecr/pagination/DescribeRepositoriesPaginator.ts +++ b/clients/client-ecr/pagination/DescribeRepositoriesPaginator.ts @@ -8,6 +8,9 @@ import { import { ECRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECRClient, input: DescribeRepositoriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeRepositoriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECR, input: DescribeRepositoriesCommandInput, diff --git a/clients/client-ecr/pagination/GetLifecyclePolicyPreviewPaginator.ts b/clients/client-ecr/pagination/GetLifecyclePolicyPreviewPaginator.ts index 9cbb1396b55f4..32738ab4f8f62 100644 --- a/clients/client-ecr/pagination/GetLifecyclePolicyPreviewPaginator.ts +++ b/clients/client-ecr/pagination/GetLifecyclePolicyPreviewPaginator.ts @@ -8,6 +8,9 @@ import { import { ECRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECRClient, input: GetLifecyclePolicyPreviewCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetLifecyclePolicyPreviewCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECR, input: GetLifecyclePolicyPreviewCommandInput, diff --git a/clients/client-ecr/pagination/ListImagesPaginator.ts b/clients/client-ecr/pagination/ListImagesPaginator.ts index e091fc73596db..c824224c80c77 100644 --- a/clients/client-ecr/pagination/ListImagesPaginator.ts +++ b/clients/client-ecr/pagination/ListImagesPaginator.ts @@ -4,6 +4,9 @@ import { ListImagesCommand, ListImagesCommandInput, ListImagesCommandOutput } fr import { ECRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECRClient, input: ListImagesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECR, input: ListImagesCommandInput, diff --git a/clients/client-ecr/runtimeConfig.browser.ts b/clients/client-ecr/runtimeConfig.browser.ts index 41fb0a153cef9..975cef0e2644a 100644 --- a/clients/client-ecr/runtimeConfig.browser.ts +++ b/clients/client-ecr/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ECRClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ecr/runtimeConfig.native.ts b/clients/client-ecr/runtimeConfig.native.ts index 1a2d5cf7693f9..eef2372a336c2 100644 --- a/clients/client-ecr/runtimeConfig.native.ts +++ b/clients/client-ecr/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ECRClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ecr/runtimeConfig.shared.ts b/clients/client-ecr/runtimeConfig.shared.ts index 4c8ac60258bb4..51dd5a3482c3b 100644 --- a/clients/client-ecr/runtimeConfig.shared.ts +++ b/clients/client-ecr/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-09-21", disableHostPrefix: false, diff --git a/clients/client-ecr/runtimeConfig.ts b/clients/client-ecr/runtimeConfig.ts index 6530ec2a2d22e..2bad181d3b209 100644 --- a/clients/client-ecr/runtimeConfig.ts +++ b/clients/client-ecr/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ECRClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ecr/tsconfig.json b/clients/client-ecr/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ecr/tsconfig.json +++ b/clients/client-ecr/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ecs/commands/CreateCapacityProviderCommand.ts b/clients/client-ecs/commands/CreateCapacityProviderCommand.ts index d2c6a68a20a25..3a27231979b13 100644 --- a/clients/client-ecs/commands/CreateCapacityProviderCommand.ts +++ b/clients/client-ecs/commands/CreateCapacityProviderCommand.ts @@ -20,6 +20,15 @@ import { export type CreateCapacityProviderCommandInput = CreateCapacityProviderRequest; export type CreateCapacityProviderCommandOutput = CreateCapacityProviderResponse & __MetadataBearer; +/** + *

Creates a new capacity provider. Capacity providers are associated with an Amazon ECS + * cluster and are used in capacity provider strategies to facilitate cluster auto + * scaling.

+ *

Only capacity providers using an Auto Scaling group can be created. Amazon ECS tasks on + * AWS Fargate use the FARGATE and FARGATE_SPOT capacity providers + * which are already created and available to all accounts in Regions supported by + * AWS Fargate.

+ */ export class CreateCapacityProviderCommand extends $Command< CreateCapacityProviderCommandInput, CreateCapacityProviderCommandOutput, @@ -34,6 +43,9 @@ export class CreateCapacityProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/CreateClusterCommand.ts b/clients/client-ecs/commands/CreateClusterCommand.ts index 98ee560dd6bb8..a4982c761fb65 100644 --- a/clients/client-ecs/commands/CreateClusterCommand.ts +++ b/clients/client-ecs/commands/CreateClusterCommand.ts @@ -20,6 +20,20 @@ import { export type CreateClusterCommandInput = CreateClusterRequest; export type CreateClusterCommandOutput = CreateClusterResponse & __MetadataBearer; +/** + *

Creates a new Amazon ECS cluster. By default, your account receives a default + * cluster when you launch your first container instance. However, you can create your own + * cluster with a unique name with the CreateCluster action.

+ * + *

When you call the CreateCluster API operation, Amazon ECS attempts to + * create the Amazon ECS service-linked role for your account so that required resources in + * other AWS services can be managed on your behalf. However, if the IAM user that + * makes the call does not have permissions to create the service-linked role, it is + * not created. For more information, see Using + * Service-Linked Roles for Amazon ECS in the + * Amazon Elastic Container Service Developer Guide.

+ *
+ */ export class CreateClusterCommand extends $Command< CreateClusterCommandInput, CreateClusterCommandOutput, @@ -34,6 +48,9 @@ export class CreateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/CreateServiceCommand.ts b/clients/client-ecs/commands/CreateServiceCommand.ts index 7ef295c6963a5..4e8459f9025d8 100644 --- a/clients/client-ecs/commands/CreateServiceCommand.ts +++ b/clients/client-ecs/commands/CreateServiceCommand.ts @@ -20,6 +20,114 @@ import { export type CreateServiceCommandInput = CreateServiceRequest; export type CreateServiceCommandOutput = CreateServiceResponse & __MetadataBearer; +/** + *

Runs and maintains a desired number of tasks from a specified task definition. If the + * number of tasks running in a service drops below the desiredCount, Amazon ECS + * runs another copy of the task in the specified cluster. To update an existing service, + * see the UpdateService action.

+ *

In addition to maintaining the desired count of tasks in your service, you can + * optionally run your service behind one or more load balancers. The load balancers + * distribute traffic across the tasks that are associated with the service. For more + * information, see Service Load Balancing in the + * Amazon Elastic Container Service Developer Guide.

+ *

Tasks for services that do not use a load balancer are considered + * healthy if they're in the RUNNING state. Tasks for services that + * do use a load balancer are considered healthy if they're in the + * RUNNING state and the container instance that they're hosted on is + * reported as healthy by the load balancer.

+ *

There are two service scheduler strategies available:

+ *
    + *
  • + *

    + * REPLICA - The replica scheduling strategy places and + * maintains the desired number of tasks across your cluster. By default, the + * service scheduler spreads tasks across Availability Zones. You can use task + * placement strategies and constraints to customize task placement decisions. For + * more information, see Service Scheduler Concepts in the + * Amazon Elastic Container Service Developer Guide.

    + *
  • + *
  • + *

    + * DAEMON - The daemon scheduling strategy deploys exactly one + * task on each active container instance that meets all of the task placement + * constraints that you specify in your cluster. The service scheduler also + * evaluates the task placement constraints for running tasks and will stop tasks + * that do not meet the placement constraints. When using this strategy, you don't + * need to specify a desired number of tasks, a task placement strategy, or use + * Service Auto Scaling policies. For more information, see Service Scheduler Concepts in the + * Amazon Elastic Container Service Developer Guide.

    + *
  • + *
+ *

You can optionally specify a deployment configuration for your service. The deployment + * is triggered by changing properties, such as the task definition or the desired count of + * a service, with an UpdateService operation. The default value for a + * replica service for minimumHealthyPercent is 100%. The default value for a + * daemon service for minimumHealthyPercent is 0%.

+ *

If a service is using the ECS deployment controller, the minimum healthy + * percent represents a lower limit on the number of tasks in a service that must remain in + * the RUNNING state during a deployment, as a percentage of the desired + * number of tasks (rounded up to the nearest integer), and while any container instances + * are in the DRAINING state if the service contains tasks using the + * EC2 launch type. This parameter enables you to deploy without using + * additional cluster capacity. For example, if your service has a desired number of four + * tasks and a minimum healthy percent of 50%, the scheduler might stop two existing tasks + * to free up cluster capacity before starting two new tasks. Tasks for services that + * do not use a load balancer are considered healthy if they're in + * the RUNNING state. Tasks for services that do use a + * load balancer are considered healthy if they're in the RUNNING state and + * they're reported as healthy by the load balancer. The default value for minimum healthy + * percent is 100%.

+ *

If a service is using the ECS deployment controller, the maximum percent parameter represents an upper limit on the + * number of tasks in a service that are allowed in the RUNNING or + * PENDING state during a deployment, as a percentage of the desired + * number of tasks (rounded down to the nearest integer), and while any container instances + * are in the DRAINING state if the service contains tasks using the + * EC2 launch type. This parameter enables you to define the deployment batch + * size. For example, if your service has a desired number of four tasks and a maximum + * percent value of 200%, the scheduler may start four new tasks before stopping the four + * older tasks (provided that the cluster resources required to do this are available). The + * default value for maximum percent is 200%.

+ *

If a service is using either the CODE_DEPLOY or EXTERNAL + * deployment controller types and tasks that use the EC2 launch type, the + * minimum healthy percent and maximum percent values are used only to define the lower and upper limit + * on the number of the tasks in the service that remain in the RUNNING state + * while the container instances are in the DRAINING state. If the tasks in + * the service use the Fargate launch type, the minimum healthy percent and + * maximum percent values aren't used, although they're currently visible when describing + * your service.

+ *

When creating a service that uses the EXTERNAL deployment controller, you + * can specify only parameters that aren't controlled at the task set level. The only + * required parameter is the service name. You control your services using the CreateTaskSet operation. For more information, see Amazon ECS Deployment Types in the Amazon Elastic Container Service Developer Guide.

+ *

When the service scheduler launches new tasks, it determines task placement in your + * cluster using the following logic:

+ *
    + *
  • + *

    Determine which of the container instances in your cluster can support your + * service's task definition (for example, they have the required CPU, memory, + * ports, and container instance attributes).

    + *
  • + *
  • + *

    By default, the service scheduler attempts to balance tasks across + * Availability Zones in this manner (although you can choose a different placement + * strategy) with the placementStrategy parameter):

    + *
      + *
    • + *

      Sort the valid container instances, giving priority to instances that + * have the fewest number of running tasks for this service in their + * respective Availability Zone. For example, if zone A has one running + * service task and zones B and C each have zero, valid container instances + * in either zone B or C are considered optimal for placement.

      + *
    • + *
    • + *

      Place the new service task on a valid container instance in an optimal + * Availability Zone (based on the previous steps), favoring container + * instances with the fewest number of running tasks for this + * service.

      + *
    • + *
    + *
  • + *
+ */ export class CreateServiceCommand extends $Command< CreateServiceCommandInput, CreateServiceCommandOutput, @@ -34,6 +142,9 @@ export class CreateServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/CreateTaskSetCommand.ts b/clients/client-ecs/commands/CreateTaskSetCommand.ts index 9a0aadc66ec50..e0d107da10dba 100644 --- a/clients/client-ecs/commands/CreateTaskSetCommand.ts +++ b/clients/client-ecs/commands/CreateTaskSetCommand.ts @@ -20,6 +20,12 @@ import { export type CreateTaskSetCommandInput = CreateTaskSetRequest; export type CreateTaskSetCommandOutput = CreateTaskSetResponse & __MetadataBearer; +/** + *

Create a task set in the specified cluster and service. This is used when a service + * uses the EXTERNAL deployment controller type. For more information, see + * Amazon ECS Deployment + * Types in the Amazon Elastic Container Service Developer Guide.

+ */ export class CreateTaskSetCommand extends $Command< CreateTaskSetCommandInput, CreateTaskSetCommandOutput, @@ -34,6 +40,9 @@ export class CreateTaskSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DeleteAccountSettingCommand.ts b/clients/client-ecs/commands/DeleteAccountSettingCommand.ts index c597e69f98987..56eac8d19057f 100644 --- a/clients/client-ecs/commands/DeleteAccountSettingCommand.ts +++ b/clients/client-ecs/commands/DeleteAccountSettingCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAccountSettingCommandInput = DeleteAccountSettingRequest; export type DeleteAccountSettingCommandOutput = DeleteAccountSettingResponse & __MetadataBearer; +/** + *

Disables an account setting for a specified IAM user, IAM role, or the root user for + * an account.

+ */ export class DeleteAccountSettingCommand extends $Command< DeleteAccountSettingCommandInput, DeleteAccountSettingCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAccountSettingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DeleteAttributesCommand.ts b/clients/client-ecs/commands/DeleteAttributesCommand.ts index 15a1c24bb1bb4..234326a600715 100644 --- a/clients/client-ecs/commands/DeleteAttributesCommand.ts +++ b/clients/client-ecs/commands/DeleteAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAttributesCommandInput = DeleteAttributesRequest; export type DeleteAttributesCommandOutput = DeleteAttributesResponse & __MetadataBearer; +/** + *

Deletes one or more custom attributes from an Amazon ECS resource.

+ */ export class DeleteAttributesCommand extends $Command< DeleteAttributesCommandInput, DeleteAttributesCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DeleteCapacityProviderCommand.ts b/clients/client-ecs/commands/DeleteCapacityProviderCommand.ts index 990c2f3a469f2..d650f0d4e92e9 100644 --- a/clients/client-ecs/commands/DeleteCapacityProviderCommand.ts +++ b/clients/client-ecs/commands/DeleteCapacityProviderCommand.ts @@ -20,6 +20,23 @@ import { export type DeleteCapacityProviderCommandInput = DeleteCapacityProviderRequest; export type DeleteCapacityProviderCommandOutput = DeleteCapacityProviderResponse & __MetadataBearer; +/** + *

Deletes the specified capacity provider.

+ * + *

The FARGATE and FARGATE_SPOT capacity providers are + * reserved and cannot be deleted. You can disassociate them from a cluster using + * either the PutClusterCapacityProviders API or by deleting the + * cluster.

+ *
+ *

Prior to a capacity provider being deleted, the capacity provider must be removed from + * the capacity provider strategy from all services. The UpdateService + * API can be used to remove a capacity provider from a service's capacity provider + * strategy. When updating a service, the forceNewDeployment option can be + * used to ensure that any tasks using the Amazon EC2 instance capacity provided by the capacity + * provider are transitioned to use the capacity from the remaining capacity providers. + * Only capacity providers that are not associated with a cluster can be deleted. To remove + * a capacity provider from a cluster, you can either use PutClusterCapacityProviders or delete the cluster.

+ */ export class DeleteCapacityProviderCommand extends $Command< DeleteCapacityProviderCommandInput, DeleteCapacityProviderCommandOutput, @@ -34,6 +51,9 @@ export class DeleteCapacityProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DeleteClusterCommand.ts b/clients/client-ecs/commands/DeleteClusterCommand.ts index 711aecdf08c14..1a0ce75a1083c 100644 --- a/clients/client-ecs/commands/DeleteClusterCommand.ts +++ b/clients/client-ecs/commands/DeleteClusterCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteClusterCommandInput = DeleteClusterRequest; export type DeleteClusterCommandOutput = DeleteClusterResponse & __MetadataBearer; +/** + *

Deletes the specified cluster. The cluster will transition to the + * INACTIVE state. Clusters with an INACTIVE status may + * remain discoverable in your account for a period of time. However, this behavior is + * subject to change in the future, so you should not rely on INACTIVE + * clusters persisting.

+ *

You must deregister all container instances from this cluster before you may delete + * it. You can list the container instances in a cluster with ListContainerInstances and deregister them with DeregisterContainerInstance.

+ */ export class DeleteClusterCommand extends $Command< DeleteClusterCommandInput, DeleteClusterCommandOutput, @@ -34,6 +43,9 @@ export class DeleteClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DeleteServiceCommand.ts b/clients/client-ecs/commands/DeleteServiceCommand.ts index 0e0746b27f313..d909e87ad2b8a 100644 --- a/clients/client-ecs/commands/DeleteServiceCommand.ts +++ b/clients/client-ecs/commands/DeleteServiceCommand.ts @@ -20,6 +20,29 @@ import { export type DeleteServiceCommandInput = DeleteServiceRequest; export type DeleteServiceCommandOutput = DeleteServiceResponse & __MetadataBearer; +/** + *

Deletes a specified service within a cluster. You can delete a service if you have no + * running tasks in it and the desired task count is zero. If the service is actively + * maintaining tasks, you cannot delete it, and you must update the service to a desired + * task count of zero. For more information, see UpdateService.

+ * + *

When you delete a service, if there are still running tasks that require cleanup, + * the service status moves from ACTIVE to DRAINING, and the + * service is no longer visible in the console or in the ListServices + * API operation. After all tasks have transitioned to either STOPPING or + * STOPPED status, the service status moves from DRAINING + * to INACTIVE. Services in the DRAINING or + * INACTIVE status can still be viewed with the DescribeServices API operation. However, in the future, + * INACTIVE services may be cleaned up and purged from Amazon ECS record + * keeping, and DescribeServices calls on those services return a + * ServiceNotFoundException error.

+ *
+ * + *

If you attempt to create a new service with the same name as an existing service + * in either ACTIVE or DRAINING status, you receive an + * error.

+ *
+ */ export class DeleteServiceCommand extends $Command< DeleteServiceCommandInput, DeleteServiceCommandOutput, @@ -34,6 +57,9 @@ export class DeleteServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DeleteTaskSetCommand.ts b/clients/client-ecs/commands/DeleteTaskSetCommand.ts index c9de2a031a7dc..104f418d12d9c 100644 --- a/clients/client-ecs/commands/DeleteTaskSetCommand.ts +++ b/clients/client-ecs/commands/DeleteTaskSetCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTaskSetCommandInput = DeleteTaskSetRequest; export type DeleteTaskSetCommandOutput = DeleteTaskSetResponse & __MetadataBearer; +/** + *

Deletes a specified task set within a service. This is used when a service uses the + * EXTERNAL deployment controller type. For more information, see Amazon ECS Deployment Types in the Amazon Elastic Container Service Developer Guide.

+ */ export class DeleteTaskSetCommand extends $Command< DeleteTaskSetCommandInput, DeleteTaskSetCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTaskSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DeregisterContainerInstanceCommand.ts b/clients/client-ecs/commands/DeregisterContainerInstanceCommand.ts index 658c442e6d99a..ccb4f0be6f0ad 100644 --- a/clients/client-ecs/commands/DeregisterContainerInstanceCommand.ts +++ b/clients/client-ecs/commands/DeregisterContainerInstanceCommand.ts @@ -20,6 +20,21 @@ import { export type DeregisterContainerInstanceCommandInput = DeregisterContainerInstanceRequest; export type DeregisterContainerInstanceCommandOutput = DeregisterContainerInstanceResponse & __MetadataBearer; +/** + *

Deregisters an Amazon ECS container instance from the specified cluster. This instance is + * no longer available to run tasks.

+ *

If you intend to use the container instance for some other purpose after + * deregistration, you should stop all of the tasks running on the container instance + * before deregistration. That prevents any orphaned tasks from consuming resources.

+ *

Deregistering a container instance removes the instance from a cluster, but it does + * not terminate the EC2 instance. If you are finished using the instance, be sure to + * terminate it in the Amazon EC2 console to stop billing.

+ * + *

If you terminate a running container instance, Amazon ECS automatically deregisters the + * instance from your cluster (stopped container instances or instances with + * disconnected agents are not automatically deregistered when terminated).

+ *
+ */ export class DeregisterContainerInstanceCommand extends $Command< DeregisterContainerInstanceCommandInput, DeregisterContainerInstanceCommandOutput, @@ -34,6 +49,9 @@ export class DeregisterContainerInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DeregisterTaskDefinitionCommand.ts b/clients/client-ecs/commands/DeregisterTaskDefinitionCommand.ts index baf3593b04b2d..fd4f6d3e68a54 100644 --- a/clients/client-ecs/commands/DeregisterTaskDefinitionCommand.ts +++ b/clients/client-ecs/commands/DeregisterTaskDefinitionCommand.ts @@ -20,6 +20,24 @@ import { export type DeregisterTaskDefinitionCommandInput = DeregisterTaskDefinitionRequest; export type DeregisterTaskDefinitionCommandOutput = DeregisterTaskDefinitionResponse & __MetadataBearer; +/** + *

Deregisters the specified task definition by family and revision. Upon deregistration, + * the task definition is marked as INACTIVE. Existing tasks and services that + * reference an INACTIVE task definition continue to run without disruption. + * Existing services that reference an INACTIVE task definition can still + * scale up or down by modifying the service's desired count.

+ *

You cannot use an INACTIVE task definition to run new tasks or create new + * services, and you cannot update an existing service to reference an + * INACTIVE task definition. However, there may be up to a 10-minute + * window following deregistration where these restrictions have not yet taken + * effect.

+ * + *

At this time, INACTIVE task definitions remain discoverable in your + * account indefinitely. However, this behavior is subject to change in the future, so + * you should not rely on INACTIVE task definitions persisting beyond the + * lifecycle of any associated tasks and services.

+ *
+ */ export class DeregisterTaskDefinitionCommand extends $Command< DeregisterTaskDefinitionCommandInput, DeregisterTaskDefinitionCommandOutput, @@ -34,6 +52,9 @@ export class DeregisterTaskDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DescribeCapacityProvidersCommand.ts b/clients/client-ecs/commands/DescribeCapacityProvidersCommand.ts index 71d6a965e2fe0..14a733848c01c 100644 --- a/clients/client-ecs/commands/DescribeCapacityProvidersCommand.ts +++ b/clients/client-ecs/commands/DescribeCapacityProvidersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCapacityProvidersCommandInput = DescribeCapacityProvidersRequest; export type DescribeCapacityProvidersCommandOutput = DescribeCapacityProvidersResponse & __MetadataBearer; +/** + *

Describes one or more of your capacity providers.

+ */ export class DescribeCapacityProvidersCommand extends $Command< DescribeCapacityProvidersCommandInput, DescribeCapacityProvidersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCapacityProvidersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DescribeClustersCommand.ts b/clients/client-ecs/commands/DescribeClustersCommand.ts index 4ff97067ba7d3..bdb37ab1e2deb 100644 --- a/clients/client-ecs/commands/DescribeClustersCommand.ts +++ b/clients/client-ecs/commands/DescribeClustersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClustersCommandInput = DescribeClustersRequest; export type DescribeClustersCommandOutput = DescribeClustersResponse & __MetadataBearer; +/** + *

Describes one or more of your clusters.

+ */ export class DescribeClustersCommand extends $Command< DescribeClustersCommandInput, DescribeClustersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DescribeContainerInstancesCommand.ts b/clients/client-ecs/commands/DescribeContainerInstancesCommand.ts index 4852b7a799cab..8c7cb7f9a3d33 100644 --- a/clients/client-ecs/commands/DescribeContainerInstancesCommand.ts +++ b/clients/client-ecs/commands/DescribeContainerInstancesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeContainerInstancesCommandInput = DescribeContainerInstancesRequest; export type DescribeContainerInstancesCommandOutput = DescribeContainerInstancesResponse & __MetadataBearer; +/** + *

Describes Amazon Elastic Container Service container instances. Returns metadata about registered and + * remaining resources on each container instance requested.

+ */ export class DescribeContainerInstancesCommand extends $Command< DescribeContainerInstancesCommandInput, DescribeContainerInstancesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeContainerInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DescribeServicesCommand.ts b/clients/client-ecs/commands/DescribeServicesCommand.ts index ead40d8505d8d..9f17094f50a37 100644 --- a/clients/client-ecs/commands/DescribeServicesCommand.ts +++ b/clients/client-ecs/commands/DescribeServicesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeServicesCommandInput = DescribeServicesRequest; export type DescribeServicesCommandOutput = DescribeServicesResponse & __MetadataBearer; +/** + *

Describes the specified services running in your cluster.

+ */ export class DescribeServicesCommand extends $Command< DescribeServicesCommandInput, DescribeServicesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DescribeTaskDefinitionCommand.ts b/clients/client-ecs/commands/DescribeTaskDefinitionCommand.ts index 55b47943c11d7..962aa180ac1c9 100644 --- a/clients/client-ecs/commands/DescribeTaskDefinitionCommand.ts +++ b/clients/client-ecs/commands/DescribeTaskDefinitionCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeTaskDefinitionCommandInput = DescribeTaskDefinitionRequest; export type DescribeTaskDefinitionCommandOutput = DescribeTaskDefinitionResponse & __MetadataBearer; +/** + *

Describes a task definition. You can specify a family and + * revision to find information about a specific task definition, or you + * can simply specify the family to find the latest ACTIVE revision in that + * family.

+ * + *

You can only describe INACTIVE task definitions while an active task + * or service references them.

+ *
+ */ export class DescribeTaskDefinitionCommand extends $Command< DescribeTaskDefinitionCommandInput, DescribeTaskDefinitionCommandOutput, @@ -34,6 +44,9 @@ export class DescribeTaskDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DescribeTaskSetsCommand.ts b/clients/client-ecs/commands/DescribeTaskSetsCommand.ts index a7d9d56c593ac..e61c3468b85f0 100644 --- a/clients/client-ecs/commands/DescribeTaskSetsCommand.ts +++ b/clients/client-ecs/commands/DescribeTaskSetsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeTaskSetsCommandInput = DescribeTaskSetsRequest; export type DescribeTaskSetsCommandOutput = DescribeTaskSetsResponse & __MetadataBearer; +/** + *

Describes the task sets in the specified cluster and service. This is used when a + * service uses the EXTERNAL deployment controller type. For more information, + * see Amazon ECS Deployment + * Types in the Amazon Elastic Container Service Developer Guide.

+ */ export class DescribeTaskSetsCommand extends $Command< DescribeTaskSetsCommandInput, DescribeTaskSetsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeTaskSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DescribeTasksCommand.ts b/clients/client-ecs/commands/DescribeTasksCommand.ts index 2f1d065856d2e..3043a81d36b3e 100644 --- a/clients/client-ecs/commands/DescribeTasksCommand.ts +++ b/clients/client-ecs/commands/DescribeTasksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTasksCommandInput = DescribeTasksRequest; export type DescribeTasksCommandOutput = DescribeTasksResponse & __MetadataBearer; +/** + *

Describes a specified task or tasks.

+ */ export class DescribeTasksCommand extends $Command< DescribeTasksCommandInput, DescribeTasksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/DiscoverPollEndpointCommand.ts b/clients/client-ecs/commands/DiscoverPollEndpointCommand.ts index cdaa9d73e87a4..76810d96642ee 100644 --- a/clients/client-ecs/commands/DiscoverPollEndpointCommand.ts +++ b/clients/client-ecs/commands/DiscoverPollEndpointCommand.ts @@ -20,6 +20,13 @@ import { export type DiscoverPollEndpointCommandInput = DiscoverPollEndpointRequest; export type DiscoverPollEndpointCommandOutput = DiscoverPollEndpointResponse & __MetadataBearer; +/** + * + *

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

+ *
+ *

Returns an endpoint for + * the Amazon ECS agent to poll for updates.

+ */ export class DiscoverPollEndpointCommand extends $Command< DiscoverPollEndpointCommandInput, DiscoverPollEndpointCommandOutput, @@ -34,6 +41,9 @@ export class DiscoverPollEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListAccountSettingsCommand.ts b/clients/client-ecs/commands/ListAccountSettingsCommand.ts index 92f70b966d04a..7960f7c0707f6 100644 --- a/clients/client-ecs/commands/ListAccountSettingsCommand.ts +++ b/clients/client-ecs/commands/ListAccountSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAccountSettingsCommandInput = ListAccountSettingsRequest; export type ListAccountSettingsCommandOutput = ListAccountSettingsResponse & __MetadataBearer; +/** + *

Lists the account settings for a specified principal.

+ */ export class ListAccountSettingsCommand extends $Command< ListAccountSettingsCommandInput, ListAccountSettingsCommandOutput, @@ -34,6 +37,9 @@ export class ListAccountSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListAttributesCommand.ts b/clients/client-ecs/commands/ListAttributesCommand.ts index f4a3e9fefb416..10892bbf69573 100644 --- a/clients/client-ecs/commands/ListAttributesCommand.ts +++ b/clients/client-ecs/commands/ListAttributesCommand.ts @@ -20,6 +20,15 @@ import { export type ListAttributesCommandInput = ListAttributesRequest; export type ListAttributesCommandOutput = ListAttributesResponse & __MetadataBearer; +/** + *

Lists the attributes for Amazon ECS resources within a specified target type and cluster. + * When you specify a target type and cluster, ListAttributes returns a list + * of attribute objects, one for each attribute on each resource. You can filter the list + * of results to a single attribute name to only return results that have that name. You + * can also filter the results by attribute name and value, for example, to see which + * container instances in a cluster are running a Linux AMI + * (ecs.os-type=linux).

+ */ export class ListAttributesCommand extends $Command< ListAttributesCommandInput, ListAttributesCommandOutput, @@ -34,6 +43,9 @@ export class ListAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListClustersCommand.ts b/clients/client-ecs/commands/ListClustersCommand.ts index a8372efe79eca..1a0842059b3ed 100644 --- a/clients/client-ecs/commands/ListClustersCommand.ts +++ b/clients/client-ecs/commands/ListClustersCommand.ts @@ -20,6 +20,9 @@ import { export type ListClustersCommandInput = ListClustersRequest; export type ListClustersCommandOutput = ListClustersResponse & __MetadataBearer; +/** + *

Returns a list of existing clusters.

+ */ export class ListClustersCommand extends $Command< ListClustersCommandInput, ListClustersCommandOutput, @@ -34,6 +37,9 @@ export class ListClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListContainerInstancesCommand.ts b/clients/client-ecs/commands/ListContainerInstancesCommand.ts index d51feea74ce3a..b345fb606aae0 100644 --- a/clients/client-ecs/commands/ListContainerInstancesCommand.ts +++ b/clients/client-ecs/commands/ListContainerInstancesCommand.ts @@ -20,6 +20,12 @@ import { export type ListContainerInstancesCommandInput = ListContainerInstancesRequest; export type ListContainerInstancesCommandOutput = ListContainerInstancesResponse & __MetadataBearer; +/** + *

Returns a list of container instances in a specified cluster. You can filter the + * results of a ListContainerInstances operation with cluster query language + * statements inside the filter parameter. For more information, see Cluster Query Language in the + * Amazon Elastic Container Service Developer Guide.

+ */ export class ListContainerInstancesCommand extends $Command< ListContainerInstancesCommandInput, ListContainerInstancesCommandOutput, @@ -34,6 +40,9 @@ export class ListContainerInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListServicesCommand.ts b/clients/client-ecs/commands/ListServicesCommand.ts index 8fd1b3b6ede3f..2130a007eb2bf 100644 --- a/clients/client-ecs/commands/ListServicesCommand.ts +++ b/clients/client-ecs/commands/ListServicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListServicesCommandInput = ListServicesRequest; export type ListServicesCommandOutput = ListServicesResponse & __MetadataBearer; +/** + *

Lists the services that are running in a specified cluster.

+ */ export class ListServicesCommand extends $Command< ListServicesCommandInput, ListServicesCommandOutput, @@ -34,6 +37,9 @@ export class ListServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListTagsForResourceCommand.ts b/clients/client-ecs/commands/ListTagsForResourceCommand.ts index 41dead204326e..02e31424051e7 100644 --- a/clients/client-ecs/commands/ListTagsForResourceCommand.ts +++ b/clients/client-ecs/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

List the tags for an Amazon ECS resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListTaskDefinitionFamiliesCommand.ts b/clients/client-ecs/commands/ListTaskDefinitionFamiliesCommand.ts index 3b29b3699608a..be9f5b729bc82 100644 --- a/clients/client-ecs/commands/ListTaskDefinitionFamiliesCommand.ts +++ b/clients/client-ecs/commands/ListTaskDefinitionFamiliesCommand.ts @@ -20,6 +20,15 @@ import { export type ListTaskDefinitionFamiliesCommandInput = ListTaskDefinitionFamiliesRequest; export type ListTaskDefinitionFamiliesCommandOutput = ListTaskDefinitionFamiliesResponse & __MetadataBearer; +/** + *

Returns a list of task definition families that are registered to your account (which + * may include task definition families that no longer have any ACTIVE task + * definition revisions).

+ *

You can filter out task definition families that do not contain any + * ACTIVE task definition revisions by setting the status + * parameter to ACTIVE. You can also filter the results with the + * familyPrefix parameter.

+ */ export class ListTaskDefinitionFamiliesCommand extends $Command< ListTaskDefinitionFamiliesCommandInput, ListTaskDefinitionFamiliesCommandOutput, @@ -34,6 +43,9 @@ export class ListTaskDefinitionFamiliesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListTaskDefinitionsCommand.ts b/clients/client-ecs/commands/ListTaskDefinitionsCommand.ts index bc7c0e667ab91..d5c44d12f3324 100644 --- a/clients/client-ecs/commands/ListTaskDefinitionsCommand.ts +++ b/clients/client-ecs/commands/ListTaskDefinitionsCommand.ts @@ -20,6 +20,11 @@ import { export type ListTaskDefinitionsCommandInput = ListTaskDefinitionsRequest; export type ListTaskDefinitionsCommandOutput = ListTaskDefinitionsResponse & __MetadataBearer; +/** + *

Returns a list of task definitions that are registered to your account. You can filter + * the results by family name with the familyPrefix parameter or by status + * with the status parameter.

+ */ export class ListTaskDefinitionsCommand extends $Command< ListTaskDefinitionsCommandInput, ListTaskDefinitionsCommandOutput, @@ -34,6 +39,9 @@ export class ListTaskDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/ListTasksCommand.ts b/clients/client-ecs/commands/ListTasksCommand.ts index 8f575b5010247..ac8c6aa56776e 100644 --- a/clients/client-ecs/commands/ListTasksCommand.ts +++ b/clients/client-ecs/commands/ListTasksCommand.ts @@ -17,6 +17,14 @@ import { export type ListTasksCommandInput = ListTasksRequest; export type ListTasksCommandOutput = ListTasksResponse & __MetadataBearer; +/** + *

Returns a list of tasks for a specified cluster. You can filter the results by family + * name, by a particular container instance, or by the desired status of the task with the + * family, containerInstance, and desiredStatus + * parameters.

+ *

Recently stopped tasks might appear in the returned results. Currently, stopped tasks + * appear in the returned results for at least one hour.

+ */ export class ListTasksCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +35,9 @@ export class ListTasksCommand extends $Command, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/PutAccountSettingCommand.ts b/clients/client-ecs/commands/PutAccountSettingCommand.ts index b5dcadf2076bc..83572a0150ff6 100644 --- a/clients/client-ecs/commands/PutAccountSettingCommand.ts +++ b/clients/client-ecs/commands/PutAccountSettingCommand.ts @@ -20,6 +20,32 @@ import { export type PutAccountSettingCommandInput = PutAccountSettingRequest; export type PutAccountSettingCommandOutput = PutAccountSettingResponse & __MetadataBearer; +/** + *

Modifies an account setting. Account settings are set on a per-Region basis.

+ *

If you change the account setting for the root user, the default settings for all of + * the IAM users and roles for which no individual account setting has been specified are + * reset. For more information, see Account + * Settings in the Amazon Elastic Container Service Developer Guide.

+ *

When serviceLongArnFormat, taskLongArnFormat, or + * containerInstanceLongArnFormat are specified, the Amazon Resource Name + * (ARN) and resource ID format of the resource type for a specified IAM user, IAM role, or + * the root user for an account is affected. The opt-in and opt-out account setting must be + * set for each Amazon ECS resource separately. The ARN and resource ID format of a resource + * will be defined by the opt-in status of the IAM user or role that created the resource. + * You must enable this setting to use Amazon ECS features such as resource tagging.

+ *

When awsvpcTrunking is specified, the elastic network interface (ENI) + * limit for any new container instances that support the feature is changed. If + * awsvpcTrunking is enabled, any new container instances that support the + * feature are launched have the increased ENI limits available to them. For more + * information, see Elastic Network + * Interface Trunking in the Amazon Elastic Container Service Developer Guide.

+ *

When containerInsights is specified, the default setting indicating + * whether CloudWatch Container Insights is enabled for your clusters is changed. If + * containerInsights is enabled, any new clusters that are created will + * have Container Insights enabled unless you disable it during cluster creation. For more + * information, see CloudWatch + * Container Insights in the Amazon Elastic Container Service Developer Guide.

+ */ export class PutAccountSettingCommand extends $Command< PutAccountSettingCommandInput, PutAccountSettingCommandOutput, @@ -34,6 +60,9 @@ export class PutAccountSettingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/PutAccountSettingDefaultCommand.ts b/clients/client-ecs/commands/PutAccountSettingDefaultCommand.ts index 6c03e1e3bffdb..4ad756dcbb0fa 100644 --- a/clients/client-ecs/commands/PutAccountSettingDefaultCommand.ts +++ b/clients/client-ecs/commands/PutAccountSettingDefaultCommand.ts @@ -20,6 +20,11 @@ import { export type PutAccountSettingDefaultCommandInput = PutAccountSettingDefaultRequest; export type PutAccountSettingDefaultCommandOutput = PutAccountSettingDefaultResponse & __MetadataBearer; +/** + *

Modifies an account setting for all IAM users on an account for whom no individual + * account setting has been specified. Account settings are set on a per-Region + * basis.

+ */ export class PutAccountSettingDefaultCommand extends $Command< PutAccountSettingDefaultCommandInput, PutAccountSettingDefaultCommandOutput, @@ -34,6 +39,9 @@ export class PutAccountSettingDefaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/PutAttributesCommand.ts b/clients/client-ecs/commands/PutAttributesCommand.ts index aca31498b4736..2310131f1374a 100644 --- a/clients/client-ecs/commands/PutAttributesCommand.ts +++ b/clients/client-ecs/commands/PutAttributesCommand.ts @@ -20,6 +20,13 @@ import { export type PutAttributesCommandInput = PutAttributesRequest; export type PutAttributesCommandOutput = PutAttributesResponse & __MetadataBearer; +/** + *

Create or update an attribute on an Amazon ECS resource. If the attribute does not exist, + * it is created. If the attribute exists, its value is replaced with the specified value. + * To delete an attribute, use DeleteAttributes. For more information, + * see Attributes in the + * Amazon Elastic Container Service Developer Guide.

+ */ export class PutAttributesCommand extends $Command< PutAttributesCommandInput, PutAttributesCommandOutput, @@ -34,6 +41,9 @@ export class PutAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/PutClusterCapacityProvidersCommand.ts b/clients/client-ecs/commands/PutClusterCapacityProvidersCommand.ts index 002641567ee63..9772bb02c9841 100644 --- a/clients/client-ecs/commands/PutClusterCapacityProvidersCommand.ts +++ b/clients/client-ecs/commands/PutClusterCapacityProvidersCommand.ts @@ -20,6 +20,22 @@ import { export type PutClusterCapacityProvidersCommandInput = PutClusterCapacityProvidersRequest; export type PutClusterCapacityProvidersCommandOutput = PutClusterCapacityProvidersResponse & __MetadataBearer; +/** + *

Modifies the available capacity providers and the default capacity provider strategy + * for a cluster.

+ *

You must specify both the available capacity providers and a default capacity provider + * strategy for the cluster. If the specified cluster has existing capacity providers + * associated with it, you must specify all existing capacity providers in addition to any + * new ones you want to add. Any existing capacity providers associated with a cluster that + * are omitted from a PutClusterCapacityProviders API call will be + * disassociated with the cluster. You can only disassociate an existing capacity provider + * from a cluster if it's not being used by any existing tasks.

+ *

When creating a service or running a task on a cluster, if no capacity provider or + * launch type is specified, then the cluster's default capacity provider strategy is used. + * It is recommended to define a default capacity provider strategy for your cluster, + * however you may specify an empty array ([]) to bypass defining a default + * strategy.

+ */ export class PutClusterCapacityProvidersCommand extends $Command< PutClusterCapacityProvidersCommandInput, PutClusterCapacityProvidersCommandOutput, @@ -34,6 +50,9 @@ export class PutClusterCapacityProvidersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/RegisterContainerInstanceCommand.ts b/clients/client-ecs/commands/RegisterContainerInstanceCommand.ts index fadb7f2f1bb7a..facbdd5b5c0f1 100644 --- a/clients/client-ecs/commands/RegisterContainerInstanceCommand.ts +++ b/clients/client-ecs/commands/RegisterContainerInstanceCommand.ts @@ -20,6 +20,14 @@ import { export type RegisterContainerInstanceCommandInput = RegisterContainerInstanceRequest; export type RegisterContainerInstanceCommandOutput = RegisterContainerInstanceResponse & __MetadataBearer; +/** + * + *

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

+ *
+ *

Registers an EC2 + * instance into the specified cluster. This instance becomes available to place containers + * on.

+ */ export class RegisterContainerInstanceCommand extends $Command< RegisterContainerInstanceCommandInput, RegisterContainerInstanceCommandOutput, @@ -34,6 +42,9 @@ export class RegisterContainerInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/RegisterTaskDefinitionCommand.ts b/clients/client-ecs/commands/RegisterTaskDefinitionCommand.ts index 857a67f2a05cd..d64ab3ed6cd32 100644 --- a/clients/client-ecs/commands/RegisterTaskDefinitionCommand.ts +++ b/clients/client-ecs/commands/RegisterTaskDefinitionCommand.ts @@ -20,6 +20,26 @@ import { export type RegisterTaskDefinitionCommandInput = RegisterTaskDefinitionRequest; export type RegisterTaskDefinitionCommandOutput = RegisterTaskDefinitionResponse & __MetadataBearer; +/** + *

Registers a new task definition from the supplied family and + * containerDefinitions. Optionally, you can add data volumes to your + * containers with the volumes parameter. For more information about task + * definition parameters and defaults, see Amazon ECS Task + * Definitions in the Amazon Elastic Container Service Developer Guide.

+ *

You can specify an IAM role for your task with the taskRoleArn parameter. + * When you specify an IAM role for a task, its containers can then use the latest versions + * of the AWS CLI or SDKs to make API requests to the AWS services that are specified in + * the IAM policy associated with the role. For more information, see IAM + * Roles for Tasks in the Amazon Elastic Container Service Developer Guide.

+ *

You can specify a Docker networking mode for the containers in your task definition + * with the networkMode parameter. The available network modes correspond to + * those described in Network + * settings in the Docker run reference. If you specify the awsvpc + * network mode, the task is allocated an elastic network interface, and you must specify a + * NetworkConfiguration when you create a service or run a task with + * the task definition. For more information, see Task Networking + * in the Amazon Elastic Container Service Developer Guide.

+ */ export class RegisterTaskDefinitionCommand extends $Command< RegisterTaskDefinitionCommandInput, RegisterTaskDefinitionCommandOutput, @@ -34,6 +54,9 @@ export class RegisterTaskDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/RunTaskCommand.ts b/clients/client-ecs/commands/RunTaskCommand.ts index 57632f59d2b53..bf2c44a3222a6 100644 --- a/clients/client-ecs/commands/RunTaskCommand.ts +++ b/clients/client-ecs/commands/RunTaskCommand.ts @@ -17,6 +17,37 @@ import { export type RunTaskCommandInput = RunTaskRequest; export type RunTaskCommandOutput = RunTaskResponse & __MetadataBearer; +/** + *

Starts a new task using the specified task definition.

+ *

You can allow Amazon ECS to place tasks for you, or you can customize how Amazon ECS places + * tasks using placement constraints and placement strategies. For more information, see + * Scheduling Tasks in the + * Amazon Elastic Container Service Developer Guide.

+ *

Alternatively, you can use StartTask to use your own scheduler or + * place tasks manually on specific container instances.

+ *

The Amazon ECS API follows an eventual consistency model, due to the distributed nature of + * the system supporting the API. This means that the result of an API command you run that + * affects your Amazon ECS resources might not be immediately visible to all subsequent commands + * you run. Keep this in mind when you carry out an API command that immediately follows a + * previous API command.

+ *

To manage eventual consistency, you can do the following:

+ *
    + *
  • + *

    Confirm the state of the resource before you run a command to modify it. Run + * the DescribeTasks command using an exponential backoff algorithm to ensure that + * you allow enough time for the previous command to propagate through the system. + * To do this, run the DescribeTasks command repeatedly, starting with a couple of + * seconds of wait time and increasing gradually up to five minutes of wait + * time.

    + *
  • + *
  • + *

    Add wait time between subsequent commands, even if the DescribeTasks command + * returns an accurate response. Apply an exponential backoff algorithm starting + * with a couple of seconds of wait time, and increase gradually up to about five + * minutes of wait time.

    + *
  • + *
+ */ export class RunTaskCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +58,9 @@ export class RunTaskCommand extends $Command, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/StartTaskCommand.ts b/clients/client-ecs/commands/StartTaskCommand.ts index 7c9b8fe64d167..2a1551a67a09f 100644 --- a/clients/client-ecs/commands/StartTaskCommand.ts +++ b/clients/client-ecs/commands/StartTaskCommand.ts @@ -17,6 +17,13 @@ import { export type StartTaskCommandInput = StartTaskRequest; export type StartTaskCommandOutput = StartTaskResponse & __MetadataBearer; +/** + *

Starts a new task from the specified task definition on the specified container + * instance or instances.

+ *

Alternatively, you can use RunTask to place tasks for you. For more + * information, see Scheduling Tasks in the + * Amazon Elastic Container Service Developer Guide.

+ */ export class StartTaskCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +34,9 @@ export class StartTaskCommand extends $Command, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/StopTaskCommand.ts b/clients/client-ecs/commands/StopTaskCommand.ts index aabaf1adfd047..b0c89c9bee17a 100644 --- a/clients/client-ecs/commands/StopTaskCommand.ts +++ b/clients/client-ecs/commands/StopTaskCommand.ts @@ -17,6 +17,21 @@ import { export type StopTaskCommandInput = StopTaskRequest; export type StopTaskCommandOutput = StopTaskResponse & __MetadataBearer; +/** + *

Stops a running task. Any tags associated with the task will be deleted.

+ *

When StopTask is called on a task, the equivalent of docker + * stop is issued to the containers running in the task. This results in a + * SIGTERM value and a default 30-second timeout, after which the + * SIGKILL value is sent and the containers are forcibly stopped. If the + * container handles the SIGTERM value gracefully and exits within 30 seconds + * from receiving it, no SIGKILL value is sent.

+ * + *

The default 30-second timeout can be configured on the Amazon ECS container agent with + * the ECS_CONTAINER_STOP_TIMEOUT variable. For more information, see + * Amazon ECS Container Agent Configuration in the + * Amazon Elastic Container Service Developer Guide.

+ *
+ */ export class StopTaskCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +42,9 @@ export class StopTaskCommand extends $Command, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/SubmitAttachmentStateChangesCommand.ts b/clients/client-ecs/commands/SubmitAttachmentStateChangesCommand.ts index da13cc28c0edf..42828649c6196 100644 --- a/clients/client-ecs/commands/SubmitAttachmentStateChangesCommand.ts +++ b/clients/client-ecs/commands/SubmitAttachmentStateChangesCommand.ts @@ -20,6 +20,13 @@ import { export type SubmitAttachmentStateChangesCommandInput = SubmitAttachmentStateChangesRequest; export type SubmitAttachmentStateChangesCommandOutput = SubmitAttachmentStateChangesResponse & __MetadataBearer; +/** + * + *

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

+ *
+ *

Sent to + * acknowledge that an attachment changed states.

+ */ export class SubmitAttachmentStateChangesCommand extends $Command< SubmitAttachmentStateChangesCommandInput, SubmitAttachmentStateChangesCommandOutput, @@ -34,6 +41,9 @@ export class SubmitAttachmentStateChangesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/SubmitContainerStateChangeCommand.ts b/clients/client-ecs/commands/SubmitContainerStateChangeCommand.ts index a37047c3891f5..e88db991ebc69 100644 --- a/clients/client-ecs/commands/SubmitContainerStateChangeCommand.ts +++ b/clients/client-ecs/commands/SubmitContainerStateChangeCommand.ts @@ -20,6 +20,13 @@ import { export type SubmitContainerStateChangeCommandInput = SubmitContainerStateChangeRequest; export type SubmitContainerStateChangeCommandOutput = SubmitContainerStateChangeResponse & __MetadataBearer; +/** + * + *

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

+ *
+ *

Sent to + * acknowledge that a container changed states.

+ */ export class SubmitContainerStateChangeCommand extends $Command< SubmitContainerStateChangeCommandInput, SubmitContainerStateChangeCommandOutput, @@ -34,6 +41,9 @@ export class SubmitContainerStateChangeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/SubmitTaskStateChangeCommand.ts b/clients/client-ecs/commands/SubmitTaskStateChangeCommand.ts index eacea88224deb..4829dfec07985 100644 --- a/clients/client-ecs/commands/SubmitTaskStateChangeCommand.ts +++ b/clients/client-ecs/commands/SubmitTaskStateChangeCommand.ts @@ -20,6 +20,13 @@ import { export type SubmitTaskStateChangeCommandInput = SubmitTaskStateChangeRequest; export type SubmitTaskStateChangeCommandOutput = SubmitTaskStateChangeResponse & __MetadataBearer; +/** + * + *

This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.

+ *
+ *

Sent to acknowledge + * that a task changed states.

+ */ export class SubmitTaskStateChangeCommand extends $Command< SubmitTaskStateChangeCommandInput, SubmitTaskStateChangeCommandOutput, @@ -34,6 +41,9 @@ export class SubmitTaskStateChangeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/TagResourceCommand.ts b/clients/client-ecs/commands/TagResourceCommand.ts index 51b678cd4f3dc..fd836dd779cfe 100644 --- a/clients/client-ecs/commands/TagResourceCommand.ts +++ b/clients/client-ecs/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Associates the specified tags to a resource with the specified + * resourceArn. If existing tags on a resource are not specified in the + * request parameters, they are not changed. When a resource is deleted, the tags + * associated with that resource are deleted as well.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/UntagResourceCommand.ts b/clients/client-ecs/commands/UntagResourceCommand.ts index c9623a2fffbae..01bee5f9597df 100644 --- a/clients/client-ecs/commands/UntagResourceCommand.ts +++ b/clients/client-ecs/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Deletes specified tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/UpdateClusterSettingsCommand.ts b/clients/client-ecs/commands/UpdateClusterSettingsCommand.ts index a957dd4e44f9d..ac99d5ed68362 100644 --- a/clients/client-ecs/commands/UpdateClusterSettingsCommand.ts +++ b/clients/client-ecs/commands/UpdateClusterSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateClusterSettingsCommandInput = UpdateClusterSettingsRequest; export type UpdateClusterSettingsCommandOutput = UpdateClusterSettingsResponse & __MetadataBearer; +/** + *

Modifies the settings to use for a cluster.

+ */ export class UpdateClusterSettingsCommand extends $Command< UpdateClusterSettingsCommandInput, UpdateClusterSettingsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateClusterSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/UpdateContainerAgentCommand.ts b/clients/client-ecs/commands/UpdateContainerAgentCommand.ts index 84e0833b6403f..7df171ada2494 100644 --- a/clients/client-ecs/commands/UpdateContainerAgentCommand.ts +++ b/clients/client-ecs/commands/UpdateContainerAgentCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateContainerAgentCommandInput = UpdateContainerAgentRequest; export type UpdateContainerAgentCommandOutput = UpdateContainerAgentResponse & __MetadataBearer; +/** + *

Updates the Amazon ECS container agent on a specified container instance. Updating the + * Amazon ECS container agent does not interrupt running tasks or services on the container + * instance. The process for updating the agent differs depending on whether your container + * instance was launched with the Amazon ECS-optimized AMI or another operating system.

+ *

+ * UpdateContainerAgent requires the Amazon ECS-optimized AMI or Amazon Linux with + * the ecs-init service installed and running. For help updating the Amazon ECS + * container agent on other operating systems, see Manually Updating the Amazon ECS Container Agent in the + * Amazon Elastic Container Service Developer Guide.

+ */ export class UpdateContainerAgentCommand extends $Command< UpdateContainerAgentCommandInput, UpdateContainerAgentCommandOutput, @@ -34,6 +45,9 @@ export class UpdateContainerAgentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/UpdateContainerInstancesStateCommand.ts b/clients/client-ecs/commands/UpdateContainerInstancesStateCommand.ts index 41f102ae9688a..1c94fc9ece189 100644 --- a/clients/client-ecs/commands/UpdateContainerInstancesStateCommand.ts +++ b/clients/client-ecs/commands/UpdateContainerInstancesStateCommand.ts @@ -20,6 +20,57 @@ import { export type UpdateContainerInstancesStateCommandInput = UpdateContainerInstancesStateRequest; export type UpdateContainerInstancesStateCommandOutput = UpdateContainerInstancesStateResponse & __MetadataBearer; +/** + *

Modifies the status of an Amazon ECS container instance.

+ *

Once a container instance has reached an ACTIVE state, you can change the + * status of a container instance to DRAINING to manually remove an instance + * from a cluster, for example to perform system updates, update the Docker daemon, or + * scale down the cluster size.

+ * + *

A container instance cannot be changed to DRAINING until it has + * reached an ACTIVE status. If the instance is in any other status, an + * error will be received.

+ *
+ *

When you set a container instance to DRAINING, Amazon ECS prevents new tasks + * from being scheduled for placement on the container instance and replacement service + * tasks are started on other container instances in the cluster if the resources are + * available. Service tasks on the container instance that are in the PENDING + * state are stopped immediately.

+ *

Service tasks on the container instance that are in the RUNNING state are + * stopped and replaced according to the service's deployment configuration parameters, + * minimumHealthyPercent and maximumPercent. You can change + * the deployment configuration of your service using UpdateService.

+ *
    + *
  • + *

    If minimumHealthyPercent is below 100%, the scheduler can ignore + * desiredCount temporarily during task replacement. For example, + * desiredCount is four tasks, a minimum of 50% allows the + * scheduler to stop two existing tasks before starting two new tasks. If the + * minimum is 100%, the service scheduler can't remove existing tasks until the + * replacement tasks are considered healthy. Tasks for services that do not use a + * load balancer are considered healthy if they are in the RUNNING + * state. Tasks for services that use a load balancer are considered healthy if + * they are in the RUNNING state and the container instance they are + * hosted on is reported as healthy by the load balancer.

    + *
  • + *
  • + *

    The maximumPercent parameter represents an upper limit on the + * number of running tasks during task replacement, which enables you to define the + * replacement batch size. For example, if desiredCount is four tasks, + * a maximum of 200% starts four new tasks before stopping the four tasks to be + * drained, provided that the cluster resources required to do this are available. + * If the maximum is 100%, then replacement tasks can't start until the draining + * tasks have stopped.

    + *
  • + *
+ *

Any PENDING or RUNNING tasks that do not belong to a service + * are not affected. You must wait for them to finish or stop them manually.

+ *

A container instance has completed draining when it has no more RUNNING + * tasks. You can verify this using ListTasks.

+ *

When a container instance has been drained, you can set a container instance to + * ACTIVE status and once it has reached that status the Amazon ECS scheduler + * can begin scheduling tasks on the instance again.

+ */ export class UpdateContainerInstancesStateCommand extends $Command< UpdateContainerInstancesStateCommandInput, UpdateContainerInstancesStateCommandOutput, @@ -34,6 +85,9 @@ export class UpdateContainerInstancesStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/UpdateServiceCommand.ts b/clients/client-ecs/commands/UpdateServiceCommand.ts index c2f727cb8b6f1..4eb76d4472ff4 100644 --- a/clients/client-ecs/commands/UpdateServiceCommand.ts +++ b/clients/client-ecs/commands/UpdateServiceCommand.ts @@ -20,6 +20,117 @@ import { export type UpdateServiceCommandInput = UpdateServiceRequest; export type UpdateServiceCommandOutput = UpdateServiceResponse & __MetadataBearer; +/** + * + *

Updating the task placement strategies and constraints on an Amazon ECS service remains + * in preview and is a Beta Service as defined by and subject to the Beta Service + * Participation Service Terms located at https://aws.amazon.com/service-terms ("Beta Terms"). These Beta Terms + * apply to your participation in this preview.

+ *
+ *

Modifies the parameters of a service.

+ *

For services using the rolling update (ECS) deployment controller, the + * desired count, deployment configuration, network configuration, task placement + * constraints and strategies, or task definition used can be updated.

+ *

For services using the blue/green (CODE_DEPLOY) deployment controller, + * only the desired count, deployment configuration, task placement constraints and + * strategies, and health check grace period can be updated using this API. If the network + * configuration, platform version, or task definition need to be updated, a new AWS CodeDeploy + * deployment should be created. For more information, see CreateDeployment in the AWS CodeDeploy API Reference.

+ *

For services using an external deployment controller, you can update only the desired + * count, task placement constraints and strategies, and health check grace period using + * this API. If the launch type, load balancer, network configuration, platform version, or + * task definition need to be updated, you should create a new task set. For more + * information, see CreateTaskSet.

+ *

You can add to or subtract from the number of instantiations of a task definition in a + * service by specifying the cluster that the service is running in and a new + * desiredCount parameter.

+ *

If you have updated the Docker image of your application, you can create a new task + * definition with that image and deploy it to your service. The service scheduler uses the + * minimum healthy percent and maximum percent parameters (in the service's deployment + * configuration) to determine the deployment strategy.

+ * + *

If your updated Docker image uses the same tag as what is in the existing task + * definition for your service (for example, my_image:latest), you do not + * need to create a new revision of your task definition. You can update the service + * using the forceNewDeployment option. The new tasks launched by the + * deployment pull the current image/tag combination from your repository when they + * start.

+ *
+ *

You can also update the deployment configuration of a service. When a deployment is + * triggered by updating the task definition of a service, the service scheduler uses the + * deployment configuration parameters, minimumHealthyPercent and + * maximumPercent, to determine the deployment strategy.

+ *
    + *
  • + *

    If minimumHealthyPercent is below 100%, the scheduler can ignore + * desiredCount temporarily during a deployment. For example, if + * desiredCount is four tasks, a minimum of 50% allows the + * scheduler to stop two existing tasks before starting two new tasks. Tasks for + * services that do not use a load balancer are considered healthy if they are in + * the RUNNING state. Tasks for services that use a load balancer are + * considered healthy if they are in the RUNNING state and the + * container instance they are hosted on is reported as healthy by the load + * balancer.

    + *
  • + *
  • + *

    The maximumPercent parameter represents an upper limit on the + * number of running tasks during a deployment, which enables you to define the + * deployment batch size. For example, if desiredCount is four tasks, + * a maximum of 200% starts four new tasks before stopping the four older tasks + * (provided that the cluster resources required to do this are available).

    + *
  • + *
+ *

When UpdateService stops a task during a deployment, the equivalent + * of docker stop is issued to the containers running in the task. This + * results in a SIGTERM and a 30-second timeout, after which + * SIGKILL is sent and the containers are forcibly stopped. If the + * container handles the SIGTERM gracefully and exits within 30 seconds from + * receiving it, no SIGKILL is sent.

+ *

When the service scheduler launches new tasks, it determines task placement in your + * cluster with the following logic:

+ *
    + *
  • + *

    Determine which of the container instances in your cluster can support your + * service's task definition (for example, they have the required CPU, memory, + * ports, and container instance attributes).

    + *
  • + *
  • + *

    By default, the service scheduler attempts to balance tasks across + * Availability Zones in this manner (although you can choose a different placement + * strategy):

    + *
      + *
    • + *

      Sort the valid container instances by the fewest number of running + * tasks for this service in the same Availability Zone as the instance. + * For example, if zone A has one running service task and zones B and C + * each have zero, valid container instances in either zone B or C are + * considered optimal for placement.

      + *
    • + *
    • + *

      Place the new service task on a valid container instance in an optimal + * Availability Zone (based on the previous steps), favoring container + * instances with the fewest number of running tasks for this + * service.

      + *
    • + *
    + *
  • + *
+ *

When the service scheduler stops running tasks, it attempts to maintain balance across + * the Availability Zones in your cluster using the following logic:

+ *
    + *
  • + *

    Sort the container instances by the largest number of running tasks for this + * service in the same Availability Zone as the instance. For example, if zone A + * has one running service task and zones B and C each have two, container + * instances in either zone B or C are considered optimal for termination.

    + *
  • + *
  • + *

    Stop the task on a container instance in an optimal Availability Zone (based + * on the previous steps), favoring container instances with the largest number of + * running tasks for this service.

    + *
  • + *
+ */ export class UpdateServiceCommand extends $Command< UpdateServiceCommandInput, UpdateServiceCommandOutput, @@ -34,6 +145,9 @@ export class UpdateServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/UpdateServicePrimaryTaskSetCommand.ts b/clients/client-ecs/commands/UpdateServicePrimaryTaskSetCommand.ts index 02bdf4d0412c2..506fc5231fedc 100644 --- a/clients/client-ecs/commands/UpdateServicePrimaryTaskSetCommand.ts +++ b/clients/client-ecs/commands/UpdateServicePrimaryTaskSetCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateServicePrimaryTaskSetCommandInput = UpdateServicePrimaryTaskSetRequest; export type UpdateServicePrimaryTaskSetCommandOutput = UpdateServicePrimaryTaskSetResponse & __MetadataBearer; +/** + *

Modifies which task set in a service is the primary task set. Any parameters that are + * updated on the primary task set in a service will transition to the service. This is + * used when a service uses the EXTERNAL deployment controller type. For more + * information, see Amazon ECS Deployment + * Types in the Amazon Elastic Container Service Developer Guide.

+ */ export class UpdateServicePrimaryTaskSetCommand extends $Command< UpdateServicePrimaryTaskSetCommandInput, UpdateServicePrimaryTaskSetCommandOutput, @@ -34,6 +41,9 @@ export class UpdateServicePrimaryTaskSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/commands/UpdateTaskSetCommand.ts b/clients/client-ecs/commands/UpdateTaskSetCommand.ts index a3cec277c1907..b2c794a77d18f 100644 --- a/clients/client-ecs/commands/UpdateTaskSetCommand.ts +++ b/clients/client-ecs/commands/UpdateTaskSetCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateTaskSetCommandInput = UpdateTaskSetRequest; export type UpdateTaskSetCommandOutput = UpdateTaskSetResponse & __MetadataBearer; +/** + *

Modifies a task set. This is used when a service uses the EXTERNAL + * deployment controller type. For more information, see Amazon ECS Deployment + * Types in the Amazon Elastic Container Service Developer Guide.

+ */ export class UpdateTaskSetCommand extends $Command< UpdateTaskSetCommandInput, UpdateTaskSetCommandOutput, @@ -34,6 +39,9 @@ export class UpdateTaskSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ECSClientResolvedConfig, diff --git a/clients/client-ecs/package.json b/clients/client-ecs/package.json index 05090009e7b62..b915d34d3e964 100644 --- a/clients/client-ecs/package.json +++ b/clients/client-ecs/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ecs Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ecs/pagination/ListAccountSettingsPaginator.ts b/clients/client-ecs/pagination/ListAccountSettingsPaginator.ts index 0bd9810767c8b..d53f60525ec38 100644 --- a/clients/client-ecs/pagination/ListAccountSettingsPaginator.ts +++ b/clients/client-ecs/pagination/ListAccountSettingsPaginator.ts @@ -8,6 +8,9 @@ import { import { ECSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECSClient, input: ListAccountSettingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountSettingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECS, input: ListAccountSettingsCommandInput, diff --git a/clients/client-ecs/pagination/ListAttributesPaginator.ts b/clients/client-ecs/pagination/ListAttributesPaginator.ts index 7893f624abf78..65223f380c645 100644 --- a/clients/client-ecs/pagination/ListAttributesPaginator.ts +++ b/clients/client-ecs/pagination/ListAttributesPaginator.ts @@ -8,6 +8,9 @@ import { import { ECSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECSClient, input: ListAttributesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttributesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECS, input: ListAttributesCommandInput, diff --git a/clients/client-ecs/pagination/ListClustersPaginator.ts b/clients/client-ecs/pagination/ListClustersPaginator.ts index 096866b89cfe0..3c213bedd3e08 100644 --- a/clients/client-ecs/pagination/ListClustersPaginator.ts +++ b/clients/client-ecs/pagination/ListClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { ECSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECSClient, input: ListClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECS, input: ListClustersCommandInput, diff --git a/clients/client-ecs/pagination/ListContainerInstancesPaginator.ts b/clients/client-ecs/pagination/ListContainerInstancesPaginator.ts index 6df887c46d06d..e99b1a55aecb1 100644 --- a/clients/client-ecs/pagination/ListContainerInstancesPaginator.ts +++ b/clients/client-ecs/pagination/ListContainerInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { ECSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECSClient, input: ListContainerInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListContainerInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECS, input: ListContainerInstancesCommandInput, diff --git a/clients/client-ecs/pagination/ListServicesPaginator.ts b/clients/client-ecs/pagination/ListServicesPaginator.ts index 8ef1779605ff5..378729f1da896 100644 --- a/clients/client-ecs/pagination/ListServicesPaginator.ts +++ b/clients/client-ecs/pagination/ListServicesPaginator.ts @@ -8,6 +8,9 @@ import { import { ECSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECSClient, input: ListServicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECS, input: ListServicesCommandInput, diff --git a/clients/client-ecs/pagination/ListTaskDefinitionFamiliesPaginator.ts b/clients/client-ecs/pagination/ListTaskDefinitionFamiliesPaginator.ts index e43a1a1eb536e..660c00a9049d2 100644 --- a/clients/client-ecs/pagination/ListTaskDefinitionFamiliesPaginator.ts +++ b/clients/client-ecs/pagination/ListTaskDefinitionFamiliesPaginator.ts @@ -8,6 +8,9 @@ import { import { ECSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECSClient, input: ListTaskDefinitionFamiliesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTaskDefinitionFamiliesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECS, input: ListTaskDefinitionFamiliesCommandInput, diff --git a/clients/client-ecs/pagination/ListTaskDefinitionsPaginator.ts b/clients/client-ecs/pagination/ListTaskDefinitionsPaginator.ts index 04380c5d0c3fa..14d1ee4d60efe 100644 --- a/clients/client-ecs/pagination/ListTaskDefinitionsPaginator.ts +++ b/clients/client-ecs/pagination/ListTaskDefinitionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ECSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECSClient, input: ListTaskDefinitionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTaskDefinitionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECS, input: ListTaskDefinitionsCommandInput, diff --git a/clients/client-ecs/pagination/ListTasksPaginator.ts b/clients/client-ecs/pagination/ListTasksPaginator.ts index 74fb47dd895a0..0c01d8d0ab7ba 100644 --- a/clients/client-ecs/pagination/ListTasksPaginator.ts +++ b/clients/client-ecs/pagination/ListTasksPaginator.ts @@ -4,6 +4,9 @@ import { ListTasksCommand, ListTasksCommandInput, ListTasksCommandOutput } from import { ECSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ECSClient, input: ListTasksCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ECS, input: ListTasksCommandInput, diff --git a/clients/client-ecs/runtimeConfig.browser.ts b/clients/client-ecs/runtimeConfig.browser.ts index aaef73e7e39ab..3e81f0856b321 100644 --- a/clients/client-ecs/runtimeConfig.browser.ts +++ b/clients/client-ecs/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ECSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ecs/runtimeConfig.native.ts b/clients/client-ecs/runtimeConfig.native.ts index 61f08ea092deb..0339c7eae4a8a 100644 --- a/clients/client-ecs/runtimeConfig.native.ts +++ b/clients/client-ecs/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ECSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ecs/runtimeConfig.shared.ts b/clients/client-ecs/runtimeConfig.shared.ts index b3d16e5c0fc6c..aff3eecc56a9c 100644 --- a/clients/client-ecs/runtimeConfig.shared.ts +++ b/clients/client-ecs/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-11-13", disableHostPrefix: false, diff --git a/clients/client-ecs/runtimeConfig.ts b/clients/client-ecs/runtimeConfig.ts index 4525eafe39212..d519403c91b5c 100644 --- a/clients/client-ecs/runtimeConfig.ts +++ b/clients/client-ecs/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ECSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ecs/tsconfig.json b/clients/client-ecs/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ecs/tsconfig.json +++ b/clients/client-ecs/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-efs/commands/CreateAccessPointCommand.ts b/clients/client-efs/commands/CreateAccessPointCommand.ts index 364a808a96044..4cfc37b150c74 100644 --- a/clients/client-efs/commands/CreateAccessPointCommand.ts +++ b/clients/client-efs/commands/CreateAccessPointCommand.ts @@ -20,6 +20,14 @@ import { export type CreateAccessPointCommandInput = CreateAccessPointRequest; export type CreateAccessPointCommandOutput = AccessPointDescription & __MetadataBearer; +/** + *

Creates an EFS access point. An access point is an application-specific view into an EFS file system that applies an operating system user and + * group, and a file system path, to any file system request made through the access point. The operating system + * user and group override any identity information provided by the NFS client. The file system path is exposed as + * the access point's root directory. Applications using the access point can only access data in its own directory and below. To learn more, see + * Mounting a File System Using EFS Access Points.

+ *

This operation requires permissions for the elasticfilesystem:CreateAccessPoint action.

+ */ export class CreateAccessPointCommand extends $Command< CreateAccessPointCommandInput, CreateAccessPointCommandOutput, @@ -34,6 +42,9 @@ export class CreateAccessPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/CreateFileSystemCommand.ts b/clients/client-efs/commands/CreateFileSystemCommand.ts index a6a1bdfddfb8d..30a14deede035 100644 --- a/clients/client-efs/commands/CreateFileSystemCommand.ts +++ b/clients/client-efs/commands/CreateFileSystemCommand.ts @@ -20,6 +20,58 @@ import { export type CreateFileSystemCommandInput = CreateFileSystemRequest; export type CreateFileSystemCommandOutput = FileSystemDescription & __MetadataBearer; +/** + *

Creates a new, empty file system. The operation requires a creation token in the + * request that Amazon EFS uses to ensure idempotent creation (calling the operation with same + * creation token has no effect). If a file system does not currently exist that is owned by the + * caller's AWS account with the specified creation token, this operation does the + * following:

+ *
    + *
  • + *

    Creates a new, empty file system. The file system will have an Amazon EFS assigned + * ID, and an initial lifecycle state creating.

    + *
  • + *
  • + *

    Returns with the description of the created file system.

    + *
  • + *
+ *

Otherwise, this operation returns a FileSystemAlreadyExists error with the + * ID of the existing file system.

+ * + *

For basic use cases, you can use a randomly generated UUID for the creation + * token.

+ *
+ *

The idempotent operation allows you to retry a CreateFileSystem call without + * risk of creating an extra file system. This can happen when an initial call fails in a way + * that leaves it uncertain whether or not a file system was actually created. An example might + * be that a transport level timeout occurred or your connection was reset. As long as you use + * the same creation token, if the initial call had succeeded in creating a file system, the + * client can learn of its existence from the FileSystemAlreadyExists error.

+ * + * + * + *

The CreateFileSystem call returns while the file system's lifecycle + * state is still creating. You can check the file system creation status by + * calling the DescribeFileSystems operation, which among other things returns the file + * system state.

+ *
+ * + *

This operation also takes an optional PerformanceMode parameter that you + * choose for your file system. We recommend generalPurpose performance mode for + * most file systems. File systems using the maxIO performance mode can scale to + * higher levels of aggregate throughput and operations per second with a tradeoff of slightly + * higher latencies for most file operations. The performance mode can't be changed after + * the file system has been created. For more information, see Amazon EFS: Performance + * Modes.

+ * + *

After the file system is fully created, Amazon EFS sets its lifecycle state to + * available, at which point you can create one or more mount targets for the file + * system in your VPC. For more information, see CreateMountTarget. You mount your Amazon EFS file system on an EC2 instances in + * your VPC by using the mount target. For more information, see Amazon EFS: How it Works.

+ * + *

This operation requires permissions for the + * elasticfilesystem:CreateFileSystem action.

+ */ export class CreateFileSystemCommand extends $Command< CreateFileSystemCommandInput, CreateFileSystemCommandOutput, @@ -34,6 +86,9 @@ export class CreateFileSystemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/CreateMountTargetCommand.ts b/clients/client-efs/commands/CreateMountTargetCommand.ts index 4500cb1df583f..0228883ba485b 100644 --- a/clients/client-efs/commands/CreateMountTargetCommand.ts +++ b/clients/client-efs/commands/CreateMountTargetCommand.ts @@ -20,6 +20,135 @@ import { export type CreateMountTargetCommandInput = CreateMountTargetRequest; export type CreateMountTargetCommandOutput = MountTargetDescription & __MetadataBearer; +/** + *

Creates a mount target for a file system. You can then mount the file system on EC2 + * instances by using the mount target.

+ *

You can create one mount target in each Availability Zone in your VPC. All EC2 + * instances in a VPC within a given Availability Zone share a single mount target for a given + * file system. If you have multiple subnets in an Availability Zone, you create a mount target + * in one of the subnets. EC2 instances do not need to be in the same subnet as the mount target + * in order to access their file system. For more information, see Amazon EFS: How it Works.

+ *

In the request, you also specify a file system ID for which you are creating the mount + * target and the file system's lifecycle state must be available. For more + * information, see DescribeFileSystems.

+ *

In the request, you also provide a subnet ID, which determines the following:

+ *
    + *
  • + *

    VPC in which Amazon EFS creates the mount target

    + *
  • + *
  • + *

    Availability Zone in which Amazon EFS creates the mount target

    + *
  • + *
  • + *

    IP address range from which Amazon EFS selects the IP address of the mount target + * (if you don't specify an IP address in the request)

    + *
  • + *
+ * + *

After creating the mount target, Amazon EFS returns a response that includes, a + * MountTargetId and an IpAddress. You use this IP address when + * mounting the file system in an EC2 instance. You can also use the mount target's DNS name + * when mounting the file system. The EC2 instance on which you mount the file system by using + * the mount target can resolve the mount target's DNS name to its IP address. For more + * information, see How it Works: + * Implementation Overview.

+ *

Note that you can create mount targets for a file system in only one VPC, and there can + * be only one mount target per Availability Zone. That is, if the file system already has one or + * more mount targets created for it, the subnet specified in the request to add another mount + * target must meet the following requirements:

+ *
    + *
  • + *

    Must belong to the same VPC as the subnets of the existing mount targets

    + *
  • + *
  • + *

    Must not be in the same Availability Zone as any of the subnets of the existing + * mount targets

    + *
  • + *
+ * + *

If the request satisfies the requirements, Amazon EFS does the following:

+ *
    + *
  • + *

    Creates a new mount target in the specified subnet.

    + *
  • + *
  • + *

    Also creates a new network interface in the subnet as follows:

    + *
      + *
    • + *

      If the request provides an IpAddress, Amazon EFS assigns that IP + * address to the network interface. Otherwise, Amazon EFS assigns a free address in the + * subnet (in the same way that the Amazon EC2 CreateNetworkInterface call + * does when a request does not specify a primary private IP address).

      + *
    • + *
    • + *

      If the request provides SecurityGroups, this network interface is + * associated with those security groups. Otherwise, it belongs to the default security + * group for the subnet's VPC.

      + *
    • + *
    • + *

      Assigns the description Mount target fsmt-id for + * file system fs-id + * where + * fsmt-id + * is the mount target ID, and + * fs-id + * is the FileSystemId.

      + *
    • + *
    • + *

      Sets the requesterManaged property of the network interface to + * true, and the requesterId value to + * EFS.

      + *
    • + *
    + *

    Each Amazon EFS mount target has one corresponding requester-managed EC2 network + * interface. After the network interface is created, Amazon EFS sets the + * NetworkInterfaceId field in the mount target's description to the + * network interface ID, and the IpAddress field to its address. If network + * interface creation fails, the entire CreateMountTarget operation + * fails.

    + *
  • + *
+ * + *

The CreateMountTarget call returns only after creating the network + * interface, but while the mount target state is still creating, you can check + * the mount target creation status by calling the DescribeMountTargets operation, which among other things returns the mount + * target state.

+ *
+ *

We recommend that you create a mount target in each of the Availability Zones. There + * are cost considerations for using a file system in an Availability Zone through a mount target + * created in another Availability Zone. For more information, see Amazon EFS. In addition, by always using a mount target local to the + * instance's Availability Zone, you eliminate a partial failure scenario. If the + * Availability Zone in which your mount target is created goes down, then you can't access + * your file system through that mount target.

+ *

This operation requires permissions for the following action on the file + * system:

+ *
    + *
  • + *

    + * elasticfilesystem:CreateMountTarget + *

    + *
  • + *
+ *

This operation also requires permissions for the following Amazon EC2 + * actions:

+ *
    + *
  • + *

    + * ec2:DescribeSubnets + *

    + *
  • + *
  • + *

    + * ec2:DescribeNetworkInterfaces + *

    + *
  • + *
  • + *

    + * ec2:CreateNetworkInterface + *

    + *
  • + *
+ */ export class CreateMountTargetCommand extends $Command< CreateMountTargetCommandInput, CreateMountTargetCommandOutput, @@ -34,6 +163,9 @@ export class CreateMountTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/CreateTagsCommand.ts b/clients/client-efs/commands/CreateTagsCommand.ts index 57b07aa3a84af..39af9ef1d1231 100644 --- a/clients/client-efs/commands/CreateTagsCommand.ts +++ b/clients/client-efs/commands/CreateTagsCommand.ts @@ -20,6 +20,14 @@ import { export type CreateTagsCommandInput = CreateTagsRequest; export type CreateTagsCommandOutput = __MetadataBearer; +/** + *

Creates or overwrites tags associated with a file system. Each tag is a key-value pair. If + * a tag key specified in the request already exists on the file system, this operation + * overwrites its value with the value provided in the request. If you add the Name + * tag to your file system, Amazon EFS returns it in the response to the DescribeFileSystems operation.

+ *

This operation requires permission for the elasticfilesystem:CreateTags + * action.

+ */ export class CreateTagsCommand extends $Command< CreateTagsCommandInput, CreateTagsCommandOutput, @@ -34,6 +42,9 @@ export class CreateTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DeleteAccessPointCommand.ts b/clients/client-efs/commands/DeleteAccessPointCommand.ts index 597b8b43a7e9a..cb08e90ead37a 100644 --- a/clients/client-efs/commands/DeleteAccessPointCommand.ts +++ b/clients/client-efs/commands/DeleteAccessPointCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteAccessPointCommandInput = DeleteAccessPointRequest; export type DeleteAccessPointCommandOutput = __MetadataBearer; +/** + *

Deletes the specified access point. After deletion is complete, new clients can no + * longer connect to the access points. Clients connected to the access point at the time of + * deletion will continue to function until they terminate their connection.

+ *

This operation requires permissions for the elasticfilesystem:DeleteAccessPoint action.

+ */ export class DeleteAccessPointCommand extends $Command< DeleteAccessPointCommandInput, DeleteAccessPointCommandOutput, @@ -34,6 +40,9 @@ export class DeleteAccessPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DeleteFileSystemCommand.ts b/clients/client-efs/commands/DeleteFileSystemCommand.ts index 86c03b87be8e4..64468b6bfdf70 100644 --- a/clients/client-efs/commands/DeleteFileSystemCommand.ts +++ b/clients/client-efs/commands/DeleteFileSystemCommand.ts @@ -20,6 +20,23 @@ import { export type DeleteFileSystemCommandInput = DeleteFileSystemRequest; export type DeleteFileSystemCommandOutput = __MetadataBearer; +/** + *

Deletes a file system, permanently severing access to its contents. Upon return, the + * file system no longer exists and you can't access any contents of the deleted file + * system.

+ *

You can't delete a file system that is in use. That is, if the file system has + * any mount targets, you must first delete them. For more information, see DescribeMountTargets and DeleteMountTarget.

+ * + * + *

The DeleteFileSystem call returns while the file system state is still + * deleting. You can check the file system deletion status by calling the DescribeFileSystems operation, which returns a list of file systems in your + * account. If you pass file system ID or creation token for the deleted file system, the DescribeFileSystems returns a 404 FileSystemNotFound + * error.

+ *
+ * + *

This operation requires permissions for the + * elasticfilesystem:DeleteFileSystem action.

+ */ export class DeleteFileSystemCommand extends $Command< DeleteFileSystemCommandInput, DeleteFileSystemCommandOutput, @@ -34,6 +51,9 @@ export class DeleteFileSystemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DeleteFileSystemPolicyCommand.ts b/clients/client-efs/commands/DeleteFileSystemPolicyCommand.ts index bfc323ea2dee7..2a168f506edeb 100644 --- a/clients/client-efs/commands/DeleteFileSystemPolicyCommand.ts +++ b/clients/client-efs/commands/DeleteFileSystemPolicyCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteFileSystemPolicyCommandInput = DeleteFileSystemPolicyRequest; export type DeleteFileSystemPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the FileSystemPolicy for the specified file system. + * The default FileSystemPolicy goes into effect once the existing policy is deleted. + * For more information about the default file system policy, see Using Resource-based Policies with EFS.

+ *

This operation requires permissions for the elasticfilesystem:DeleteFileSystemPolicy action.

+ */ export class DeleteFileSystemPolicyCommand extends $Command< DeleteFileSystemPolicyCommandInput, DeleteFileSystemPolicyCommandOutput, @@ -34,6 +40,9 @@ export class DeleteFileSystemPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DeleteMountTargetCommand.ts b/clients/client-efs/commands/DeleteMountTargetCommand.ts index bc2eeb886f8b7..2ca38145882b1 100644 --- a/clients/client-efs/commands/DeleteMountTargetCommand.ts +++ b/clients/client-efs/commands/DeleteMountTargetCommand.ts @@ -20,6 +20,42 @@ import { export type DeleteMountTargetCommandInput = DeleteMountTargetRequest; export type DeleteMountTargetCommandOutput = __MetadataBearer; +/** + *

Deletes the specified mount target.

+ * + *

This operation forcibly breaks any mounts of the file system by using the mount target + * that is being deleted, which might disrupt instances or applications using those mounts. To + * avoid applications getting cut off abruptly, you might consider unmounting any mounts of the + * mount target, if feasible. The operation also deletes the associated network interface. + * Uncommitted writes might be lost, but breaking a mount target using this operation does not + * corrupt the file system itself. The file system you created remains. You can mount an EC2 + * instance in your VPC by using another mount target.

+ *

This operation requires permissions for the following action on the file + * system:

+ *
    + *
  • + *

    + * elasticfilesystem:DeleteMountTarget + *

    + *
  • + *
+ * + * + *

The DeleteMountTarget call returns while the mount target state is still + * deleting. You can check the mount target deletion by calling the DescribeMountTargets operation, which returns a list of mount target + * descriptions for the given file system.

+ *
+ * + *

The operation also requires permissions for the following Amazon EC2 action on the + * mount target's network interface:

+ *
    + *
  • + *

    + * ec2:DeleteNetworkInterface + *

    + *
  • + *
+ */ export class DeleteMountTargetCommand extends $Command< DeleteMountTargetCommandInput, DeleteMountTargetCommandOutput, @@ -34,6 +70,9 @@ export class DeleteMountTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DeleteTagsCommand.ts b/clients/client-efs/commands/DeleteTagsCommand.ts index 92529fc244fa6..c4155a694f44b 100644 --- a/clients/client-efs/commands/DeleteTagsCommand.ts +++ b/clients/client-efs/commands/DeleteTagsCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteTagsCommandInput = DeleteTagsRequest; export type DeleteTagsCommandOutput = __MetadataBearer; +/** + *

Deletes the specified tags from a file system. If the DeleteTags request + * includes a tag key that doesn't exist, Amazon EFS ignores it and doesn't cause an + * error. For more information about tags and related restrictions, see Tag Restrictions in the + * AWS Billing and Cost Management User Guide.

+ * + *

This operation requires permissions for the elasticfilesystem:DeleteTags + * action.

+ */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -34,6 +43,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DescribeAccessPointsCommand.ts b/clients/client-efs/commands/DescribeAccessPointsCommand.ts index e43c9edb9354f..1e3de15448909 100644 --- a/clients/client-efs/commands/DescribeAccessPointsCommand.ts +++ b/clients/client-efs/commands/DescribeAccessPointsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeAccessPointsCommandInput = DescribeAccessPointsRequest; export type DescribeAccessPointsCommandOutput = DescribeAccessPointsResponse & __MetadataBearer; +/** + *

Returns the description of a specific Amazon EFS access point if the AccessPointId is provided. + * If you provide an EFS FileSystemId, it returns descriptions of all access points for that file system. + * You can provide either an AccessPointId or a FileSystemId in the request, but not both.

+ *

This operation requires permissions for the elasticfilesystem:DescribeAccessPoints action.

+ */ export class DescribeAccessPointsCommand extends $Command< DescribeAccessPointsCommandInput, DescribeAccessPointsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeAccessPointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DescribeBackupPolicyCommand.ts b/clients/client-efs/commands/DescribeBackupPolicyCommand.ts index 0b5ce9fbedb11..17515d849c545 100644 --- a/clients/client-efs/commands/DescribeBackupPolicyCommand.ts +++ b/clients/client-efs/commands/DescribeBackupPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBackupPolicyCommandInput = DescribeBackupPolicyRequest; export type DescribeBackupPolicyCommandOutput = BackupPolicyDescription & __MetadataBearer; +/** + *

Returns the backup policy for the specified EFS file system.

+ */ export class DescribeBackupPolicyCommand extends $Command< DescribeBackupPolicyCommandInput, DescribeBackupPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBackupPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DescribeFileSystemPolicyCommand.ts b/clients/client-efs/commands/DescribeFileSystemPolicyCommand.ts index e4df31faa2b7e..8424fa7f85e0d 100644 --- a/clients/client-efs/commands/DescribeFileSystemPolicyCommand.ts +++ b/clients/client-efs/commands/DescribeFileSystemPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeFileSystemPolicyCommandInput = DescribeFileSystemPolicyRequest; export type DescribeFileSystemPolicyCommandOutput = FileSystemPolicyDescription & __MetadataBearer; +/** + *

Returns the FileSystemPolicy for the specified EFS file system.

+ *

This operation requires permissions for the elasticfilesystem:DescribeFileSystemPolicy action.

+ */ export class DescribeFileSystemPolicyCommand extends $Command< DescribeFileSystemPolicyCommandInput, DescribeFileSystemPolicyCommandOutput, @@ -34,6 +38,9 @@ export class DescribeFileSystemPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DescribeFileSystemsCommand.ts b/clients/client-efs/commands/DescribeFileSystemsCommand.ts index c290246c709bb..5d281e021d8ee 100644 --- a/clients/client-efs/commands/DescribeFileSystemsCommand.ts +++ b/clients/client-efs/commands/DescribeFileSystemsCommand.ts @@ -20,6 +20,31 @@ import { export type DescribeFileSystemsCommandInput = DescribeFileSystemsRequest; export type DescribeFileSystemsCommandOutput = DescribeFileSystemsResponse & __MetadataBearer; +/** + *

Returns the description of a specific Amazon EFS file system if either the file system + * CreationToken or the FileSystemId is provided. Otherwise, it + * returns descriptions of all file systems owned by the caller's AWS account in the AWS + * Region of the endpoint that you're calling.

+ * + *

When retrieving all file system descriptions, you can optionally specify the + * MaxItems parameter to limit the number of descriptions in a response. + * Currently, this number is automatically set to 10. If more file system descriptions remain, + * Amazon EFS returns a NextMarker, an opaque token, in the response. In this case, + * you should send a subsequent request with the Marker request parameter set to the + * value of NextMarker.

+ * + *

To retrieve a list of your file system descriptions, this operation is used in an + * iterative process, where DescribeFileSystems is called first without the + * Marker and then the operation continues to call it with the Marker + * parameter set to the value of the NextMarker from the previous response until the + * response has no NextMarker.

+ * + *

The order of file systems returned in the response of one + * DescribeFileSystems call and the order of file systems returned across the + * responses of a multi-call iteration is unspecified.

+ *

This operation requires permissions for the + * elasticfilesystem:DescribeFileSystems action.

+ */ export class DescribeFileSystemsCommand extends $Command< DescribeFileSystemsCommandInput, DescribeFileSystemsCommandOutput, @@ -34,6 +59,9 @@ export class DescribeFileSystemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DescribeLifecycleConfigurationCommand.ts b/clients/client-efs/commands/DescribeLifecycleConfigurationCommand.ts index 10a26d95b8de9..a456619170da8 100644 --- a/clients/client-efs/commands/DescribeLifecycleConfigurationCommand.ts +++ b/clients/client-efs/commands/DescribeLifecycleConfigurationCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeLifecycleConfigurationCommandInput = DescribeLifecycleConfigurationRequest; export type DescribeLifecycleConfigurationCommandOutput = LifecycleConfigurationDescription & __MetadataBearer; +/** + *

Returns the current LifecycleConfiguration object for the specified Amazon + * EFS file system. EFS lifecycle management uses the LifecycleConfiguration object + * to identify which files to move to the EFS Infrequent Access (IA) storage class. For a file system + * without a LifecycleConfiguration object, the call returns an empty array in the + * response.

+ *

This operation requires permissions for the + * elasticfilesystem:DescribeLifecycleConfiguration operation.

+ */ export class DescribeLifecycleConfigurationCommand extends $Command< DescribeLifecycleConfigurationCommandInput, DescribeLifecycleConfigurationCommandOutput, @@ -34,6 +43,9 @@ export class DescribeLifecycleConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DescribeMountTargetSecurityGroupsCommand.ts b/clients/client-efs/commands/DescribeMountTargetSecurityGroupsCommand.ts index f61ddf3dedcce..f781347b39797 100644 --- a/clients/client-efs/commands/DescribeMountTargetSecurityGroupsCommand.ts +++ b/clients/client-efs/commands/DescribeMountTargetSecurityGroupsCommand.ts @@ -24,6 +24,24 @@ export type DescribeMountTargetSecurityGroupsCommandInput = DescribeMountTargetS export type DescribeMountTargetSecurityGroupsCommandOutput = DescribeMountTargetSecurityGroupsResponse & __MetadataBearer; +/** + *

Returns the security groups currently in effect for a mount target. This operation + * requires that the network interface of the mount target has been created and the lifecycle + * state of the mount target is not deleted.

+ *

This operation requires permissions for the following actions:

+ *
    + *
  • + *

    + * elasticfilesystem:DescribeMountTargetSecurityGroups action on the mount + * target's file system.

    + *
  • + *
  • + *

    + * ec2:DescribeNetworkInterfaceAttribute action on the mount target's + * network interface.

    + *
  • + *
+ */ export class DescribeMountTargetSecurityGroupsCommand extends $Command< DescribeMountTargetSecurityGroupsCommandInput, DescribeMountTargetSecurityGroupsCommandOutput, @@ -38,6 +56,9 @@ export class DescribeMountTargetSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DescribeMountTargetsCommand.ts b/clients/client-efs/commands/DescribeMountTargetsCommand.ts index ba33e531ea305..9c81c5af1efdb 100644 --- a/clients/client-efs/commands/DescribeMountTargetsCommand.ts +++ b/clients/client-efs/commands/DescribeMountTargetsCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeMountTargetsCommandInput = DescribeMountTargetsRequest; export type DescribeMountTargetsCommandOutput = DescribeMountTargetsResponse & __MetadataBearer; +/** + *

Returns the descriptions of all the current mount targets, or a specific mount target, + * for a file system. When requesting all of the current mount targets, the order of mount + * targets returned in the response is unspecified.

+ * + *

This operation requires permissions for the + * elasticfilesystem:DescribeMountTargets action, on either the file system ID + * that you specify in FileSystemId, or on the file system of the mount target that + * you specify in MountTargetId.

+ */ export class DescribeMountTargetsCommand extends $Command< DescribeMountTargetsCommandInput, DescribeMountTargetsCommandOutput, @@ -34,6 +44,9 @@ export class DescribeMountTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/DescribeTagsCommand.ts b/clients/client-efs/commands/DescribeTagsCommand.ts index 190968d8e4fd7..6b71158c9a38c 100644 --- a/clients/client-efs/commands/DescribeTagsCommand.ts +++ b/clients/client-efs/commands/DescribeTagsCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeTagsCommandInput = DescribeTagsRequest; export type DescribeTagsCommandOutput = DescribeTagsResponse & __MetadataBearer; +/** + *

Returns the tags associated with a file system. The order of tags returned in the + * response of one DescribeTags call and the order of tags returned across the + * responses of a multiple-call iteration (when using pagination) is unspecified.

+ *

This operation requires permissions for the + * elasticfilesystem:DescribeTags action.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -34,6 +41,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/ListTagsForResourceCommand.ts b/clients/client-efs/commands/ListTagsForResourceCommand.ts index 4da62f0e8cea3..25184101feaba 100644 --- a/clients/client-efs/commands/ListTagsForResourceCommand.ts +++ b/clients/client-efs/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists all tags for a top-level EFS resource. You must provide the ID of the resource that you want to retrieve the tags for.

+ *

This operation requires permissions for the elasticfilesystem:DescribeAccessPoints action.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/ModifyMountTargetSecurityGroupsCommand.ts b/clients/client-efs/commands/ModifyMountTargetSecurityGroupsCommand.ts index 68e766f78f68c..3253fc8829a0f 100644 --- a/clients/client-efs/commands/ModifyMountTargetSecurityGroupsCommand.ts +++ b/clients/client-efs/commands/ModifyMountTargetSecurityGroupsCommand.ts @@ -20,6 +20,28 @@ import { export type ModifyMountTargetSecurityGroupsCommandInput = ModifyMountTargetSecurityGroupsRequest; export type ModifyMountTargetSecurityGroupsCommandOutput = __MetadataBearer; +/** + *

Modifies the set of security groups in effect for a mount target.

+ *

When you create a mount target, Amazon EFS also creates a new network interface. For + * more information, see CreateMountTarget. This operation replaces the security groups in effect for the + * network interface associated with a mount target, with the SecurityGroups + * provided in the request. This operation requires that the network interface of the mount + * target has been created and the lifecycle state of the mount target is not + * deleted.

+ *

The operation requires permissions for the following actions:

+ *
    + *
  • + *

    + * elasticfilesystem:ModifyMountTargetSecurityGroups action on the mount + * target's file system.

    + *
  • + *
  • + *

    + * ec2:ModifyNetworkInterfaceAttribute action on the mount target's network + * interface.

    + *
  • + *
+ */ export class ModifyMountTargetSecurityGroupsCommand extends $Command< ModifyMountTargetSecurityGroupsCommandInput, ModifyMountTargetSecurityGroupsCommandOutput, @@ -34,6 +56,9 @@ export class ModifyMountTargetSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/PutBackupPolicyCommand.ts b/clients/client-efs/commands/PutBackupPolicyCommand.ts index e1603b808e433..41942ead2f2fe 100644 --- a/clients/client-efs/commands/PutBackupPolicyCommand.ts +++ b/clients/client-efs/commands/PutBackupPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type PutBackupPolicyCommandInput = PutBackupPolicyRequest; export type PutBackupPolicyCommandOutput = BackupPolicyDescription & __MetadataBearer; +/** + *

Updates the file system's backup policy. Use this action to start or stop automatic backups of the file system.

+ */ export class PutBackupPolicyCommand extends $Command< PutBackupPolicyCommandInput, PutBackupPolicyCommandOutput, @@ -34,6 +37,9 @@ export class PutBackupPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/PutFileSystemPolicyCommand.ts b/clients/client-efs/commands/PutFileSystemPolicyCommand.ts index 8bd19350e2d1a..1966d184938cf 100644 --- a/clients/client-efs/commands/PutFileSystemPolicyCommand.ts +++ b/clients/client-efs/commands/PutFileSystemPolicyCommand.ts @@ -20,6 +20,16 @@ import { export type PutFileSystemPolicyCommandInput = PutFileSystemPolicyRequest; export type PutFileSystemPolicyCommandOutput = FileSystemPolicyDescription & __MetadataBearer; +/** + *

Applies an Amazon EFS FileSystemPolicy to an Amazon EFS file system. + * A file system policy is an IAM resource-based policy and can contain multiple policy statements. + * A file system always has exactly one file system policy, which can be the default policy or + * an explicit policy set or updated using this API operation. + * When an explicit policy is set, it overrides the default policy. For more information about the default file system policy, see + * Default EFS File System Policy. + *

+ *

This operation requires permissions for the elasticfilesystem:PutFileSystemPolicy action.

+ */ export class PutFileSystemPolicyCommand extends $Command< PutFileSystemPolicyCommandInput, PutFileSystemPolicyCommandOutput, @@ -34,6 +44,9 @@ export class PutFileSystemPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/PutLifecycleConfigurationCommand.ts b/clients/client-efs/commands/PutLifecycleConfigurationCommand.ts index fcb329a58c306..25e6fcaa7e2b4 100644 --- a/clients/client-efs/commands/PutLifecycleConfigurationCommand.ts +++ b/clients/client-efs/commands/PutLifecycleConfigurationCommand.ts @@ -20,6 +20,37 @@ import { export type PutLifecycleConfigurationCommandInput = PutLifecycleConfigurationRequest; export type PutLifecycleConfigurationCommandOutput = LifecycleConfigurationDescription & __MetadataBearer; +/** + *

Enables lifecycle management by creating a new LifecycleConfiguration + * object. A LifecycleConfiguration object defines when files in an Amazon EFS file + * system are automatically transitioned to the lower-cost EFS Infrequent Access (IA) storage class. + * A LifecycleConfiguration applies to all files in a file system.

+ *

Each Amazon EFS file system supports one lifecycle configuration, which applies to all files in the file system. If a + * LifecycleConfiguration object already exists for the specified file system, a + * PutLifecycleConfiguration call modifies the existing configuration. A + * PutLifecycleConfiguration call with an empty LifecyclePolicies + * array in the request body deletes any existing LifecycleConfiguration and + * disables lifecycle management.

+ * + * + *

In the request, specify the following:

+ *
    + *
  • + *

    The ID for the file system for which you are enabling, disabling, or modifying lifecycle management.

    + *
  • + *
  • + *

    A LifecyclePolicies array of LifecyclePolicy objects that + * define when files are moved to the IA storage class. The array can contain only one + * LifecyclePolicy item.

    + *
  • + *
+ * + *

This operation requires permissions for the + * elasticfilesystem:PutLifecycleConfiguration operation.

+ *

To apply a LifecycleConfiguration object to an encrypted file system, you + * need the same AWS Key Management Service (AWS KMS) permissions as when you created the encrypted + * file system.

+ */ export class PutLifecycleConfigurationCommand extends $Command< PutLifecycleConfigurationCommandInput, PutLifecycleConfigurationCommandOutput, @@ -34,6 +65,9 @@ export class PutLifecycleConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/TagResourceCommand.ts b/clients/client-efs/commands/TagResourceCommand.ts index b083cd95c9d26..dfe6efc2b5f92 100644 --- a/clients/client-efs/commands/TagResourceCommand.ts +++ b/clients/client-efs/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Creates a tag for an EFS resource. You can create tags for EFS file systems and access points using this API operation.

+ *

This operation requires permissions for the elasticfilesystem:TagResource action.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/UntagResourceCommand.ts b/clients/client-efs/commands/UntagResourceCommand.ts index cdbc3be79bd39..28a789dd8c669 100644 --- a/clients/client-efs/commands/UntagResourceCommand.ts +++ b/clients/client-efs/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes tags from an EFS resource. You can remove tags from EFS file systems and access points using this API operation.

+ *

This operation requires permissions for the elasticfilesystem:UntagResource action.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/commands/UpdateFileSystemCommand.ts b/clients/client-efs/commands/UpdateFileSystemCommand.ts index 34ac00f75cbfc..30bdc371b0870 100644 --- a/clients/client-efs/commands/UpdateFileSystemCommand.ts +++ b/clients/client-efs/commands/UpdateFileSystemCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateFileSystemCommandInput = UpdateFileSystemRequest; export type UpdateFileSystemCommandOutput = FileSystemDescription & __MetadataBearer; +/** + *

Updates the throughput mode or the amount of provisioned throughput of an existing file + * system.

+ */ export class UpdateFileSystemCommand extends $Command< UpdateFileSystemCommandInput, UpdateFileSystemCommandOutput, @@ -34,6 +38,9 @@ export class UpdateFileSystemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EFSClientResolvedConfig, diff --git a/clients/client-efs/package.json b/clients/client-efs/package.json index f7b0189d68df2..9610cd7cbe68f 100644 --- a/clients/client-efs/package.json +++ b/clients/client-efs/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Efs Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-efs/pagination/DescribeAccessPointsPaginator.ts b/clients/client-efs/pagination/DescribeAccessPointsPaginator.ts index f5e51efd3365a..b47b00f9f2d67 100644 --- a/clients/client-efs/pagination/DescribeAccessPointsPaginator.ts +++ b/clients/client-efs/pagination/DescribeAccessPointsPaginator.ts @@ -8,6 +8,9 @@ import { import { EFSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EFSClient, input: DescribeAccessPointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAccessPointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EFS, input: DescribeAccessPointsCommandInput, diff --git a/clients/client-efs/pagination/DescribeFileSystemsPaginator.ts b/clients/client-efs/pagination/DescribeFileSystemsPaginator.ts index 36729d8eb047a..9d1e88a53334a 100644 --- a/clients/client-efs/pagination/DescribeFileSystemsPaginator.ts +++ b/clients/client-efs/pagination/DescribeFileSystemsPaginator.ts @@ -8,6 +8,9 @@ import { import { EFSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EFSClient, input: DescribeFileSystemsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFileSystemsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EFS, input: DescribeFileSystemsCommandInput, diff --git a/clients/client-efs/pagination/DescribeTagsPaginator.ts b/clients/client-efs/pagination/DescribeTagsPaginator.ts index 3904a49e13ad6..b3f82e6a8f23b 100644 --- a/clients/client-efs/pagination/DescribeTagsPaginator.ts +++ b/clients/client-efs/pagination/DescribeTagsPaginator.ts @@ -8,6 +8,9 @@ import { import { EFSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EFSClient, input: DescribeTagsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EFS, input: DescribeTagsCommandInput, diff --git a/clients/client-efs/pagination/ListTagsForResourcePaginator.ts b/clients/client-efs/pagination/ListTagsForResourcePaginator.ts index b947b1bbb43c4..76e5eba656d9f 100644 --- a/clients/client-efs/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-efs/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { EFSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EFSClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EFS, input: ListTagsForResourceCommandInput, diff --git a/clients/client-efs/runtimeConfig.browser.ts b/clients/client-efs/runtimeConfig.browser.ts index 3c08b860b48da..c8885543070f1 100644 --- a/clients/client-efs/runtimeConfig.browser.ts +++ b/clients/client-efs/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./EFSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-efs/runtimeConfig.native.ts b/clients/client-efs/runtimeConfig.native.ts index 9fac0c66e4ca8..ad1cccea4b598 100644 --- a/clients/client-efs/runtimeConfig.native.ts +++ b/clients/client-efs/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./EFSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-efs/runtimeConfig.shared.ts b/clients/client-efs/runtimeConfig.shared.ts index 8728da975859c..86f159a39e1d2 100644 --- a/clients/client-efs/runtimeConfig.shared.ts +++ b/clients/client-efs/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-02-01", disableHostPrefix: false, diff --git a/clients/client-efs/runtimeConfig.ts b/clients/client-efs/runtimeConfig.ts index e5d569e7cb299..e47ff76c0d555 100644 --- a/clients/client-efs/runtimeConfig.ts +++ b/clients/client-efs/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./EFSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-efs/tsconfig.json b/clients/client-efs/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-efs/tsconfig.json +++ b/clients/client-efs/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-eks/commands/CreateClusterCommand.ts b/clients/client-eks/commands/CreateClusterCommand.ts index 1cac77c847fa7..a45a6fbbe1bf5 100644 --- a/clients/client-eks/commands/CreateClusterCommand.ts +++ b/clients/client-eks/commands/CreateClusterCommand.ts @@ -20,6 +20,45 @@ import { export type CreateClusterCommandInput = CreateClusterRequest; export type CreateClusterCommandOutput = CreateClusterResponse & __MetadataBearer; +/** + *

Creates an Amazon EKS control plane.

+ *

The Amazon EKS control plane consists of control plane instances that run the Kubernetes + * software, such as etcd and the API server. The control plane runs in an + * account managed by AWS, and the Kubernetes API is exposed via the Amazon EKS API server + * endpoint. Each Amazon EKS cluster control plane is single-tenant and unique and runs on its + * own set of Amazon EC2 instances.

+ *

The cluster control plane is provisioned across multiple Availability Zones and + * fronted by an Elastic Load Balancing Network Load Balancer. Amazon EKS also provisions elastic network interfaces in your VPC + * subnets to provide connectivity from the control plane instances to the worker nodes + * (for example, to support kubectl exec, logs, and + * proxy data flows).

+ *

Amazon EKS worker nodes run in your AWS account and connect to your cluster's control + * plane via the Kubernetes API server endpoint and a certificate file that is created for + * your cluster.

+ *

You can use the endpointPublicAccess and + * endpointPrivateAccess parameters to enable or disable public and + * private access to your cluster's Kubernetes API server endpoint. By default, public + * access is enabled, and private access is disabled. For more information, see Amazon EKS Cluster + * Endpoint Access Control in the + * Amazon EKS User Guide + * .

+ *

You can use the logging parameter to enable or disable exporting the + * Kubernetes control plane logs for your cluster to CloudWatch Logs. By default, cluster control + * plane logs aren't exported to CloudWatch Logs. For more information, see Amazon EKS + * Cluster Control Plane Logs in the + * + * Amazon EKS User Guide + * .

+ * + *

CloudWatch Logs ingestion, archive storage, and data scanning rates apply to exported + * control plane logs. For more information, see Amazon CloudWatch Pricing.

+ *
+ *

Cluster creation typically takes between 10 and 15 minutes. After you create an Amazon EKS + * cluster, you must configure your Kubernetes tooling to communicate with the API server + * and launch worker nodes into your cluster. For more information, see Managing Cluster + * Authentication and Launching Amazon EKS Worker Nodes in the + * Amazon EKS User Guide.

+ */ export class CreateClusterCommand extends $Command< CreateClusterCommandInput, CreateClusterCommandOutput, @@ -34,6 +73,9 @@ export class CreateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/CreateFargateProfileCommand.ts b/clients/client-eks/commands/CreateFargateProfileCommand.ts index 263ef83efa4bd..a0c49d4c131f9 100644 --- a/clients/client-eks/commands/CreateFargateProfileCommand.ts +++ b/clients/client-eks/commands/CreateFargateProfileCommand.ts @@ -20,6 +20,32 @@ import { export type CreateFargateProfileCommandInput = CreateFargateProfileRequest; export type CreateFargateProfileCommandOutput = CreateFargateProfileResponse & __MetadataBearer; +/** + *

Creates an AWS Fargate profile for your Amazon EKS cluster. You must have at least one Fargate + * profile in a cluster to be able to run pods on Fargate.

+ *

The Fargate profile allows an administrator to declare which pods run on Fargate and specify + * which pods run on which Fargate profile. This declaration is done through the profile’s + * selectors. Each profile can have up to five selectors that contain a namespace and + * labels. A namespace is required for every selector. The label field consists of multiple + * optional key-value pairs. Pods that match the selectors are scheduled on Fargate. If a + * to-be-scheduled pod matches any of the selectors in the Fargate profile, then that pod is + * run on Fargate.

+ *

When you create a Fargate profile, you must specify a pod execution role to use with the + * pods that are scheduled with the profile. This role is added to the cluster's Kubernetes + * Role Based Access + * Control (RBAC) for authorization so that the kubelet that is + * running on the Fargate infrastructure can register with your Amazon EKS cluster so that it can + * appear in your cluster as a node. The pod execution role also provides IAM permissions + * to the Fargate infrastructure to allow read access to Amazon ECR image repositories. For more + * information, see Pod Execution Role in the Amazon EKS User Guide.

+ *

Fargate profiles are immutable. However, you can create a new updated profile to replace + * an existing profile and then delete the original after the updated profile has finished + * creating.

+ *

If any Fargate profiles in a cluster are in the DELETING status, you must + * wait for that Fargate profile to finish deleting before you can create any other profiles + * in that cluster.

+ *

For more information, see AWS Fargate Profile in the Amazon EKS User Guide.

+ */ export class CreateFargateProfileCommand extends $Command< CreateFargateProfileCommandInput, CreateFargateProfileCommandOutput, @@ -34,6 +60,9 @@ export class CreateFargateProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/CreateNodegroupCommand.ts b/clients/client-eks/commands/CreateNodegroupCommand.ts index 1cde7734ba899..42d79f830f37c 100644 --- a/clients/client-eks/commands/CreateNodegroupCommand.ts +++ b/clients/client-eks/commands/CreateNodegroupCommand.ts @@ -20,6 +20,18 @@ import { export type CreateNodegroupCommandInput = CreateNodegroupRequest; export type CreateNodegroupCommandOutput = CreateNodegroupResponse & __MetadataBearer; +/** + *

Creates a managed worker node group for an Amazon EKS cluster. You can only create a node + * group for your cluster that is equal to the current Kubernetes version for the cluster. + * All node groups are created with the latest AMI release version for the respective minor + * Kubernetes version of the cluster, unless you deploy a custom AMI using a launch + * template. For more information about using launch templates, see Launch + * template support.

+ *

An Amazon EKS managed node group is an Amazon EC2 Auto Scaling group and associated Amazon EC2 instances that + * are managed by AWS for an Amazon EKS cluster. Each node group uses a version of the + * Amazon EKS-optimized Amazon Linux 2 AMI. For more information, see Managed + * Node Groups in the Amazon EKS User Guide.

+ */ export class CreateNodegroupCommand extends $Command< CreateNodegroupCommandInput, CreateNodegroupCommandOutput, @@ -34,6 +46,9 @@ export class CreateNodegroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/DeleteClusterCommand.ts b/clients/client-eks/commands/DeleteClusterCommand.ts index d74673f583269..01f873ad09650 100644 --- a/clients/client-eks/commands/DeleteClusterCommand.ts +++ b/clients/client-eks/commands/DeleteClusterCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteClusterCommandInput = DeleteClusterRequest; export type DeleteClusterCommandOutput = DeleteClusterResponse & __MetadataBearer; +/** + *

Deletes the Amazon EKS cluster control plane.

+ *

If you have active services in your cluster that are associated with a load balancer, + * you must delete those services before deleting the cluster so that the load balancers + * are deleted properly. Otherwise, you can have orphaned resources in your VPC that + * prevent you from being able to delete the VPC. For more information, see Deleting a + * Cluster in the Amazon EKS User Guide.

+ *

If you have managed node groups or Fargate profiles attached to the cluster, you must + * delete them first. For more information, see DeleteNodegroup and DeleteFargateProfile.

+ */ export class DeleteClusterCommand extends $Command< DeleteClusterCommandInput, DeleteClusterCommandOutput, @@ -34,6 +44,9 @@ export class DeleteClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/DeleteFargateProfileCommand.ts b/clients/client-eks/commands/DeleteFargateProfileCommand.ts index 1422f53197646..300d9dbfbd9e3 100644 --- a/clients/client-eks/commands/DeleteFargateProfileCommand.ts +++ b/clients/client-eks/commands/DeleteFargateProfileCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteFargateProfileCommandInput = DeleteFargateProfileRequest; export type DeleteFargateProfileCommandOutput = DeleteFargateProfileResponse & __MetadataBearer; +/** + *

Deletes an AWS Fargate profile.

+ *

When you delete a Fargate profile, any pods running on Fargate that were created with the + * profile are deleted. If those pods match another Fargate profile, then they are scheduled + * on Fargate with that profile. If they no longer match any Fargate profiles, then they are not + * scheduled on Fargate and they may remain in a pending state.

+ *

Only one Fargate profile in a cluster can be in the DELETING status at a + * time. You must wait for a Fargate profile to finish deleting before you can delete any + * other profiles in that cluster.

+ */ export class DeleteFargateProfileCommand extends $Command< DeleteFargateProfileCommandInput, DeleteFargateProfileCommandOutput, @@ -34,6 +44,9 @@ export class DeleteFargateProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/DeleteNodegroupCommand.ts b/clients/client-eks/commands/DeleteNodegroupCommand.ts index 1f281f12babfe..0cf352e3f7379 100644 --- a/clients/client-eks/commands/DeleteNodegroupCommand.ts +++ b/clients/client-eks/commands/DeleteNodegroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNodegroupCommandInput = DeleteNodegroupRequest; export type DeleteNodegroupCommandOutput = DeleteNodegroupResponse & __MetadataBearer; +/** + *

Deletes an Amazon EKS node group for a cluster.

+ */ export class DeleteNodegroupCommand extends $Command< DeleteNodegroupCommandInput, DeleteNodegroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNodegroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/DescribeClusterCommand.ts b/clients/client-eks/commands/DescribeClusterCommand.ts index f0f7a3c7c0f06..67eb0db81b819 100644 --- a/clients/client-eks/commands/DescribeClusterCommand.ts +++ b/clients/client-eks/commands/DescribeClusterCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeClusterCommandInput = DescribeClusterRequest; export type DescribeClusterCommandOutput = DescribeClusterResponse & __MetadataBearer; +/** + *

Returns descriptive information about an Amazon EKS cluster.

+ *

The API server endpoint and certificate authority data returned by this operation are + * required for kubelet and kubectl to communicate with your + * Kubernetes API server. For more information, see Create a + * kubeconfig for Amazon EKS.

+ * + *

The API server endpoint and certificate authority data aren't available until the + * cluster reaches the ACTIVE state.

+ *
+ */ export class DescribeClusterCommand extends $Command< DescribeClusterCommandInput, DescribeClusterCommandOutput, @@ -34,6 +45,9 @@ export class DescribeClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/DescribeFargateProfileCommand.ts b/clients/client-eks/commands/DescribeFargateProfileCommand.ts index 3c18919f58c72..11f2cb34216c1 100644 --- a/clients/client-eks/commands/DescribeFargateProfileCommand.ts +++ b/clients/client-eks/commands/DescribeFargateProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFargateProfileCommandInput = DescribeFargateProfileRequest; export type DescribeFargateProfileCommandOutput = DescribeFargateProfileResponse & __MetadataBearer; +/** + *

Returns descriptive information about an AWS Fargate profile.

+ */ export class DescribeFargateProfileCommand extends $Command< DescribeFargateProfileCommandInput, DescribeFargateProfileCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFargateProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/DescribeNodegroupCommand.ts b/clients/client-eks/commands/DescribeNodegroupCommand.ts index eefd1520761f5..738e0ce1d36c6 100644 --- a/clients/client-eks/commands/DescribeNodegroupCommand.ts +++ b/clients/client-eks/commands/DescribeNodegroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNodegroupCommandInput = DescribeNodegroupRequest; export type DescribeNodegroupCommandOutput = DescribeNodegroupResponse & __MetadataBearer; +/** + *

Returns descriptive information about an Amazon EKS node group.

+ */ export class DescribeNodegroupCommand extends $Command< DescribeNodegroupCommandInput, DescribeNodegroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNodegroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/DescribeUpdateCommand.ts b/clients/client-eks/commands/DescribeUpdateCommand.ts index a44996ca00b75..b6798174f2191 100644 --- a/clients/client-eks/commands/DescribeUpdateCommand.ts +++ b/clients/client-eks/commands/DescribeUpdateCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeUpdateCommandInput = DescribeUpdateRequest; export type DescribeUpdateCommandOutput = DescribeUpdateResponse & __MetadataBearer; +/** + *

Returns descriptive information about an update against your Amazon EKS cluster or + * associated managed node group.

+ *

When the status of the update is Succeeded, the update is complete. If an + * update fails, the status is Failed, and an error detail explains the reason + * for the failure.

+ */ export class DescribeUpdateCommand extends $Command< DescribeUpdateCommandInput, DescribeUpdateCommandOutput, @@ -34,6 +41,9 @@ export class DescribeUpdateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/ListClustersCommand.ts b/clients/client-eks/commands/ListClustersCommand.ts index fd8e04a7f5bca..0d9fa999df22b 100644 --- a/clients/client-eks/commands/ListClustersCommand.ts +++ b/clients/client-eks/commands/ListClustersCommand.ts @@ -20,6 +20,9 @@ import { export type ListClustersCommandInput = ListClustersRequest; export type ListClustersCommandOutput = ListClustersResponse & __MetadataBearer; +/** + *

Lists the Amazon EKS clusters in your AWS account in the specified Region.

+ */ export class ListClustersCommand extends $Command< ListClustersCommandInput, ListClustersCommandOutput, @@ -34,6 +37,9 @@ export class ListClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/ListFargateProfilesCommand.ts b/clients/client-eks/commands/ListFargateProfilesCommand.ts index 3ce9d01809151..034e3a3f3abeb 100644 --- a/clients/client-eks/commands/ListFargateProfilesCommand.ts +++ b/clients/client-eks/commands/ListFargateProfilesCommand.ts @@ -20,6 +20,10 @@ import { export type ListFargateProfilesCommandInput = ListFargateProfilesRequest; export type ListFargateProfilesCommandOutput = ListFargateProfilesResponse & __MetadataBearer; +/** + *

Lists the AWS Fargate profiles associated with the specified cluster in your AWS + * account in the specified Region.

+ */ export class ListFargateProfilesCommand extends $Command< ListFargateProfilesCommandInput, ListFargateProfilesCommandOutput, @@ -34,6 +38,9 @@ export class ListFargateProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/ListNodegroupsCommand.ts b/clients/client-eks/commands/ListNodegroupsCommand.ts index 4fcb50cdf18ec..7fb99461eebb3 100644 --- a/clients/client-eks/commands/ListNodegroupsCommand.ts +++ b/clients/client-eks/commands/ListNodegroupsCommand.ts @@ -20,6 +20,10 @@ import { export type ListNodegroupsCommandInput = ListNodegroupsRequest; export type ListNodegroupsCommandOutput = ListNodegroupsResponse & __MetadataBearer; +/** + *

Lists the Amazon EKS managed node groups associated with the specified cluster in your + * AWS account in the specified Region. Self-managed node groups are not listed.

+ */ export class ListNodegroupsCommand extends $Command< ListNodegroupsCommandInput, ListNodegroupsCommandOutput, @@ -34,6 +38,9 @@ export class ListNodegroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/ListTagsForResourceCommand.ts b/clients/client-eks/commands/ListTagsForResourceCommand.ts index d65b01fb74da8..871b025f3b068 100644 --- a/clients/client-eks/commands/ListTagsForResourceCommand.ts +++ b/clients/client-eks/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

List the tags for an Amazon EKS resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/ListUpdatesCommand.ts b/clients/client-eks/commands/ListUpdatesCommand.ts index 6693ab1853f00..011b996cdd33b 100644 --- a/clients/client-eks/commands/ListUpdatesCommand.ts +++ b/clients/client-eks/commands/ListUpdatesCommand.ts @@ -20,6 +20,10 @@ import { export type ListUpdatesCommandInput = ListUpdatesRequest; export type ListUpdatesCommandOutput = ListUpdatesResponse & __MetadataBearer; +/** + *

Lists the updates associated with an Amazon EKS cluster or managed node group in your AWS + * account, in the specified Region.

+ */ export class ListUpdatesCommand extends $Command< ListUpdatesCommandInput, ListUpdatesCommandOutput, @@ -34,6 +38,9 @@ export class ListUpdatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/TagResourceCommand.ts b/clients/client-eks/commands/TagResourceCommand.ts index b85855f33ea63..1f47de0d5e75b 100644 --- a/clients/client-eks/commands/TagResourceCommand.ts +++ b/clients/client-eks/commands/TagResourceCommand.ts @@ -20,6 +20,15 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Associates the specified tags to a resource with the specified + * resourceArn. If existing tags on a resource are not specified in the + * request parameters, they are not changed. When a resource is deleted, the tags + * associated with that resource are deleted as well. Tags that you create for Amazon EKS + * resources do not propagate to any other resources associated with the cluster. For + * example, if you tag a cluster with this operation, that tag does not automatically + * propagate to the subnets and worker nodes associated with the cluster.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +43,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/UntagResourceCommand.ts b/clients/client-eks/commands/UntagResourceCommand.ts index ac37d650e8fb9..3eaef311f7d7c 100644 --- a/clients/client-eks/commands/UntagResourceCommand.ts +++ b/clients/client-eks/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Deletes specified tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/UpdateClusterConfigCommand.ts b/clients/client-eks/commands/UpdateClusterConfigCommand.ts index 2e96772a52fab..500482d8d2e74 100644 --- a/clients/client-eks/commands/UpdateClusterConfigCommand.ts +++ b/clients/client-eks/commands/UpdateClusterConfigCommand.ts @@ -20,6 +20,36 @@ import { export type UpdateClusterConfigCommandInput = UpdateClusterConfigRequest; export type UpdateClusterConfigCommandOutput = UpdateClusterConfigResponse & __MetadataBearer; +/** + *

Updates an Amazon EKS cluster configuration. Your cluster continues to function during the + * update. The response output includes an update ID that you can use to track the status + * of your cluster update with the DescribeUpdate API operation.

+ *

You can use this API operation to enable or disable exporting the Kubernetes control + * plane logs for your cluster to CloudWatch Logs. By default, cluster control plane logs aren't + * exported to CloudWatch Logs. For more information, see Amazon EKS + * Cluster Control Plane Logs in the + * + * Amazon EKS User Guide + * .

+ * + *

CloudWatch Logs ingestion, archive storage, and data scanning rates apply to exported + * control plane logs. For more information, see Amazon CloudWatch Pricing.

+ *
+ *

You can also use this API operation to enable or disable public and private access to + * your cluster's Kubernetes API server endpoint. By default, public access is enabled, and + * private access is disabled. For more information, see Amazon EKS Cluster + * Endpoint Access Control in the + * Amazon EKS User Guide + * .

+ * + *

At this time, you can not update the subnets or security group IDs for an existing + * cluster.

+ *
+ *

Cluster updates are asynchronous, and they should finish within a few minutes. During + * an update, the cluster status moves to UPDATING (this status transition is + * eventually consistent). When the update is complete (either Failed or + * Successful), the cluster status moves to Active.

+ */ export class UpdateClusterConfigCommand extends $Command< UpdateClusterConfigCommandInput, UpdateClusterConfigCommandOutput, @@ -34,6 +64,9 @@ export class UpdateClusterConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/UpdateClusterVersionCommand.ts b/clients/client-eks/commands/UpdateClusterVersionCommand.ts index ce777569ee4d6..9f2b39a987c36 100644 --- a/clients/client-eks/commands/UpdateClusterVersionCommand.ts +++ b/clients/client-eks/commands/UpdateClusterVersionCommand.ts @@ -20,6 +20,19 @@ import { export type UpdateClusterVersionCommandInput = UpdateClusterVersionRequest; export type UpdateClusterVersionCommandOutput = UpdateClusterVersionResponse & __MetadataBearer; +/** + *

Updates an Amazon EKS cluster to the specified Kubernetes version. Your cluster continues + * to function during the update. The response output includes an update ID that you can + * use to track the status of your cluster update with the DescribeUpdate + * API operation.

+ *

Cluster updates are asynchronous, and they should finish within a few minutes. During + * an update, the cluster status moves to UPDATING (this status transition is + * eventually consistent). When the update is complete (either Failed or + * Successful), the cluster status moves to Active.

+ *

If your cluster has managed node groups attached to it, all of your node groups’ + * Kubernetes versions must match the cluster’s Kubernetes version in order to update the + * cluster to a new Kubernetes version.

+ */ export class UpdateClusterVersionCommand extends $Command< UpdateClusterVersionCommandInput, UpdateClusterVersionCommandOutput, @@ -34,6 +47,9 @@ export class UpdateClusterVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/UpdateNodegroupConfigCommand.ts b/clients/client-eks/commands/UpdateNodegroupConfigCommand.ts index 8a650e26ea368..fde9df33fd421 100644 --- a/clients/client-eks/commands/UpdateNodegroupConfigCommand.ts +++ b/clients/client-eks/commands/UpdateNodegroupConfigCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateNodegroupConfigCommandInput = UpdateNodegroupConfigRequest; export type UpdateNodegroupConfigCommandOutput = UpdateNodegroupConfigResponse & __MetadataBearer; +/** + *

Updates an Amazon EKS managed node group configuration. Your node group continues to + * function during the update. The response output includes an update ID that you can use + * to track the status of your node group update with the DescribeUpdate + * API operation. Currently you can update the Kubernetes labels for a node group or the + * scaling configuration.

+ */ export class UpdateNodegroupConfigCommand extends $Command< UpdateNodegroupConfigCommandInput, UpdateNodegroupConfigCommandOutput, @@ -34,6 +41,9 @@ export class UpdateNodegroupConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/commands/UpdateNodegroupVersionCommand.ts b/clients/client-eks/commands/UpdateNodegroupVersionCommand.ts index a46877528c295..6500403fc73cd 100644 --- a/clients/client-eks/commands/UpdateNodegroupVersionCommand.ts +++ b/clients/client-eks/commands/UpdateNodegroupVersionCommand.ts @@ -20,6 +20,25 @@ import { export type UpdateNodegroupVersionCommandInput = UpdateNodegroupVersionRequest; export type UpdateNodegroupVersionCommandOutput = UpdateNodegroupVersionResponse & __MetadataBearer; +/** + *

Updates the Kubernetes version or AMI version of an Amazon EKS managed node group.

+ *

You can update a node group using a launch template only if the node group was + * originally deployed with a launch template. If you need to update a custom AMI in a node + * group that was deployed with a launch template, then update your custom AMI, specify the + * new ID in a new version of the launch template, and then update the node group to the + * new version of the launch template.

+ *

If you update without a launch template, then you can update to the latest available + * AMI version of a node group's current Kubernetes version by not specifying a Kubernetes + * version in the request. You can update to the latest AMI version of your cluster's + * current Kubernetes version by specifying your cluster's Kubernetes version in the + * request. For more information, see Amazon EKS-Optimized Linux AMI Versions in the Amazon EKS User Guide.

+ *

You cannot roll back a node group to an earlier Kubernetes version or AMI + * version.

+ *

When a node in a managed node group is terminated due to a scaling action or update, + * the pods in that node are drained first. Amazon EKS attempts to drain the nodes gracefully + * and will fail if it is unable to do so. You can force the update if Amazon EKS + * is unable to drain the nodes as a result of a pod disruption budget issue.

+ */ export class UpdateNodegroupVersionCommand extends $Command< UpdateNodegroupVersionCommandInput, UpdateNodegroupVersionCommandOutput, @@ -34,6 +53,9 @@ export class UpdateNodegroupVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EKSClientResolvedConfig, diff --git a/clients/client-eks/package.json b/clients/client-eks/package.json index 57e0d68b1b0f0..e74fe5f8350a2 100644 --- a/clients/client-eks/package.json +++ b/clients/client-eks/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Eks Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-eks/pagination/ListClustersPaginator.ts b/clients/client-eks/pagination/ListClustersPaginator.ts index e3f27a59b0636..0237b8ff31046 100644 --- a/clients/client-eks/pagination/ListClustersPaginator.ts +++ b/clients/client-eks/pagination/ListClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { EKSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EKSClient, input: ListClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EKS, input: ListClustersCommandInput, diff --git a/clients/client-eks/pagination/ListFargateProfilesPaginator.ts b/clients/client-eks/pagination/ListFargateProfilesPaginator.ts index 39a498e05e2eb..cff6b5cfe4399 100644 --- a/clients/client-eks/pagination/ListFargateProfilesPaginator.ts +++ b/clients/client-eks/pagination/ListFargateProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { EKSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EKSClient, input: ListFargateProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFargateProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EKS, input: ListFargateProfilesCommandInput, diff --git a/clients/client-eks/pagination/ListNodegroupsPaginator.ts b/clients/client-eks/pagination/ListNodegroupsPaginator.ts index 110165fad81cf..613587c83dd56 100644 --- a/clients/client-eks/pagination/ListNodegroupsPaginator.ts +++ b/clients/client-eks/pagination/ListNodegroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { EKSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EKSClient, input: ListNodegroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNodegroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EKS, input: ListNodegroupsCommandInput, diff --git a/clients/client-eks/pagination/ListUpdatesPaginator.ts b/clients/client-eks/pagination/ListUpdatesPaginator.ts index c158882a747ad..5ac926f998c27 100644 --- a/clients/client-eks/pagination/ListUpdatesPaginator.ts +++ b/clients/client-eks/pagination/ListUpdatesPaginator.ts @@ -4,6 +4,9 @@ import { ListUpdatesCommand, ListUpdatesCommandInput, ListUpdatesCommandOutput } import { EKSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EKSClient, input: ListUpdatesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUpdatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EKS, input: ListUpdatesCommandInput, diff --git a/clients/client-eks/runtimeConfig.browser.ts b/clients/client-eks/runtimeConfig.browser.ts index 001a8f9dda3e6..a3a7f56b3a490 100644 --- a/clients/client-eks/runtimeConfig.browser.ts +++ b/clients/client-eks/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./EKSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-eks/runtimeConfig.native.ts b/clients/client-eks/runtimeConfig.native.ts index f45ac0687fc11..c24b5017a2823 100644 --- a/clients/client-eks/runtimeConfig.native.ts +++ b/clients/client-eks/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./EKSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-eks/runtimeConfig.shared.ts b/clients/client-eks/runtimeConfig.shared.ts index 7b2f31400a79b..98698fee82831 100644 --- a/clients/client-eks/runtimeConfig.shared.ts +++ b/clients/client-eks/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-11-01", disableHostPrefix: false, diff --git a/clients/client-eks/runtimeConfig.ts b/clients/client-eks/runtimeConfig.ts index 84c19a01dae76..679ea0f0c8753 100644 --- a/clients/client-eks/runtimeConfig.ts +++ b/clients/client-eks/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./EKSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-eks/tsconfig.json b/clients/client-eks/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-eks/tsconfig.json +++ b/clients/client-eks/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-elastic-beanstalk/commands/AbortEnvironmentUpdateCommand.ts b/clients/client-elastic-beanstalk/commands/AbortEnvironmentUpdateCommand.ts index 8ab2e93b4f356..9a181391e1d54 100644 --- a/clients/client-elastic-beanstalk/commands/AbortEnvironmentUpdateCommand.ts +++ b/clients/client-elastic-beanstalk/commands/AbortEnvironmentUpdateCommand.ts @@ -20,6 +20,10 @@ import { export type AbortEnvironmentUpdateCommandInput = AbortEnvironmentUpdateMessage; export type AbortEnvironmentUpdateCommandOutput = __MetadataBearer; +/** + *

Cancels in-progress environment configuration update or application version + * deployment.

+ */ export class AbortEnvironmentUpdateCommand extends $Command< AbortEnvironmentUpdateCommandInput, AbortEnvironmentUpdateCommandOutput, @@ -34,6 +38,9 @@ export class AbortEnvironmentUpdateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/ApplyEnvironmentManagedActionCommand.ts b/clients/client-elastic-beanstalk/commands/ApplyEnvironmentManagedActionCommand.ts index 489b6fde42dde..9aeb914c9017a 100644 --- a/clients/client-elastic-beanstalk/commands/ApplyEnvironmentManagedActionCommand.ts +++ b/clients/client-elastic-beanstalk/commands/ApplyEnvironmentManagedActionCommand.ts @@ -20,6 +20,11 @@ import { export type ApplyEnvironmentManagedActionCommandInput = ApplyEnvironmentManagedActionRequest; export type ApplyEnvironmentManagedActionCommandOutput = ApplyEnvironmentManagedActionResult & __MetadataBearer; +/** + *

Applies a scheduled managed action immediately. A managed action can be applied only if + * its status is Scheduled. Get the status and action ID of a managed action with + * DescribeEnvironmentManagedActions.

+ */ export class ApplyEnvironmentManagedActionCommand extends $Command< ApplyEnvironmentManagedActionCommandInput, ApplyEnvironmentManagedActionCommandOutput, @@ -34,6 +39,9 @@ export class ApplyEnvironmentManagedActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/AssociateEnvironmentOperationsRoleCommand.ts b/clients/client-elastic-beanstalk/commands/AssociateEnvironmentOperationsRoleCommand.ts index 987477fd055ca..ce7f9bfb6a6ce 100644 --- a/clients/client-elastic-beanstalk/commands/AssociateEnvironmentOperationsRoleCommand.ts +++ b/clients/client-elastic-beanstalk/commands/AssociateEnvironmentOperationsRoleCommand.ts @@ -20,6 +20,12 @@ import { export type AssociateEnvironmentOperationsRoleCommandInput = AssociateEnvironmentOperationsRoleMessage; export type AssociateEnvironmentOperationsRoleCommandOutput = __MetadataBearer; +/** + *

Add or change the operations role used by an environment. After this call is made, Elastic Beanstalk + * uses the associated operations role for permissions to downstream services during subsequent + * calls acting on this environment. For more information, see Operations roles in the + * AWS Elastic Beanstalk Developer Guide.

+ */ export class AssociateEnvironmentOperationsRoleCommand extends $Command< AssociateEnvironmentOperationsRoleCommandInput, AssociateEnvironmentOperationsRoleCommandOutput, @@ -34,6 +40,9 @@ export class AssociateEnvironmentOperationsRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/CheckDNSAvailabilityCommand.ts b/clients/client-elastic-beanstalk/commands/CheckDNSAvailabilityCommand.ts index 14fecfb716bc1..35ea88045f543 100644 --- a/clients/client-elastic-beanstalk/commands/CheckDNSAvailabilityCommand.ts +++ b/clients/client-elastic-beanstalk/commands/CheckDNSAvailabilityCommand.ts @@ -20,6 +20,9 @@ import { export type CheckDNSAvailabilityCommandInput = CheckDNSAvailabilityMessage; export type CheckDNSAvailabilityCommandOutput = CheckDNSAvailabilityResultMessage & __MetadataBearer; +/** + *

Checks if the specified CNAME is available.

+ */ export class CheckDNSAvailabilityCommand extends $Command< CheckDNSAvailabilityCommandInput, CheckDNSAvailabilityCommandOutput, @@ -34,6 +37,9 @@ export class CheckDNSAvailabilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/ComposeEnvironmentsCommand.ts b/clients/client-elastic-beanstalk/commands/ComposeEnvironmentsCommand.ts index 1cb3973cbe3e8..8b806287301ce 100644 --- a/clients/client-elastic-beanstalk/commands/ComposeEnvironmentsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/ComposeEnvironmentsCommand.ts @@ -20,6 +20,14 @@ import { export type ComposeEnvironmentsCommandInput = ComposeEnvironmentsMessage; export type ComposeEnvironmentsCommandOutput = EnvironmentDescriptionsMessage & __MetadataBearer; +/** + *

Create or update a group of environments that each run a separate component of a single + * application. Takes a list of version labels that specify application source bundles for each + * of the environments to create or update. The name of each environment and other required + * information must be included in the source bundles in an environment manifest named + * env.yaml. See Compose Environments + * for details.

+ */ export class ComposeEnvironmentsCommand extends $Command< ComposeEnvironmentsCommandInput, ComposeEnvironmentsCommandOutput, @@ -34,6 +42,9 @@ export class ComposeEnvironmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/CreateApplicationCommand.ts b/clients/client-elastic-beanstalk/commands/CreateApplicationCommand.ts index b84183c762538..38576bdf460c3 100644 --- a/clients/client-elastic-beanstalk/commands/CreateApplicationCommand.ts +++ b/clients/client-elastic-beanstalk/commands/CreateApplicationCommand.ts @@ -20,6 +20,10 @@ import { export type CreateApplicationCommandInput = CreateApplicationMessage; export type CreateApplicationCommandOutput = ApplicationDescriptionMessage & __MetadataBearer; +/** + *

Creates an application that has one configuration template named default + * and no application versions.

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -34,6 +38,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/CreateApplicationVersionCommand.ts b/clients/client-elastic-beanstalk/commands/CreateApplicationVersionCommand.ts index b1d12cf169024..fe2dac50fb909 100644 --- a/clients/client-elastic-beanstalk/commands/CreateApplicationVersionCommand.ts +++ b/clients/client-elastic-beanstalk/commands/CreateApplicationVersionCommand.ts @@ -20,6 +20,25 @@ import { export type CreateApplicationVersionCommandInput = CreateApplicationVersionMessage; export type CreateApplicationVersionCommandOutput = ApplicationVersionDescriptionMessage & __MetadataBearer; +/** + *

Creates an application version for the specified application. You can create an + * application version from a source bundle in Amazon S3, a commit in AWS CodeCommit, or the + * output of an AWS CodeBuild build as follows:

+ *

Specify a commit in an AWS CodeCommit repository with + * SourceBuildInformation.

+ *

Specify a build in an AWS CodeBuild with SourceBuildInformation and + * BuildConfiguration.

+ *

Specify a source bundle in S3 with SourceBundle + *

+ *

Omit both SourceBuildInformation and SourceBundle to use the + * default sample application.

+ * + *

After you create an application version with a specified Amazon S3 bucket and key + * location, you can't change that Amazon S3 location. If you change the Amazon S3 location, + * you receive an exception when you attempt to launch an environment from the application + * version.

+ *
+ */ export class CreateApplicationVersionCommand extends $Command< CreateApplicationVersionCommandInput, CreateApplicationVersionCommandOutput, @@ -34,6 +53,9 @@ export class CreateApplicationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/CreateConfigurationTemplateCommand.ts b/clients/client-elastic-beanstalk/commands/CreateConfigurationTemplateCommand.ts index 6082add396cb5..a33cba2ff480f 100644 --- a/clients/client-elastic-beanstalk/commands/CreateConfigurationTemplateCommand.ts +++ b/clients/client-elastic-beanstalk/commands/CreateConfigurationTemplateCommand.ts @@ -20,6 +20,32 @@ import { export type CreateConfigurationTemplateCommandInput = CreateConfigurationTemplateMessage; export type CreateConfigurationTemplateCommandOutput = ConfigurationSettingsDescription & __MetadataBearer; +/** + *

Creates an AWS Elastic Beanstalk configuration template, associated with a specific Elastic Beanstalk + * application. You define application configuration settings in a configuration template. You + * can then use the configuration template to deploy different versions of the application with + * the same configuration settings.

+ *

Templates aren't associated with any environment. The EnvironmentName + * response element is always null.

+ *

Related Topics

+ * + */ export class CreateConfigurationTemplateCommand extends $Command< CreateConfigurationTemplateCommandInput, CreateConfigurationTemplateCommandOutput, @@ -34,6 +60,9 @@ export class CreateConfigurationTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/CreateEnvironmentCommand.ts b/clients/client-elastic-beanstalk/commands/CreateEnvironmentCommand.ts index 0d8358fdaa1bf..e71ce1f13248b 100644 --- a/clients/client-elastic-beanstalk/commands/CreateEnvironmentCommand.ts +++ b/clients/client-elastic-beanstalk/commands/CreateEnvironmentCommand.ts @@ -20,6 +20,10 @@ import { export type CreateEnvironmentCommandInput = CreateEnvironmentMessage; export type CreateEnvironmentCommandOutput = EnvironmentDescription & __MetadataBearer; +/** + *

Launches an AWS Elastic Beanstalk environment for the specified application using the specified + * configuration.

+ */ export class CreateEnvironmentCommand extends $Command< CreateEnvironmentCommandInput, CreateEnvironmentCommandOutput, @@ -34,6 +38,9 @@ export class CreateEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/CreatePlatformVersionCommand.ts b/clients/client-elastic-beanstalk/commands/CreatePlatformVersionCommand.ts index 0ae2bc317255d..255817170a301 100644 --- a/clients/client-elastic-beanstalk/commands/CreatePlatformVersionCommand.ts +++ b/clients/client-elastic-beanstalk/commands/CreatePlatformVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePlatformVersionCommandInput = CreatePlatformVersionRequest; export type CreatePlatformVersionCommandOutput = CreatePlatformVersionResult & __MetadataBearer; +/** + *

Create a new version of your custom platform.

+ */ export class CreatePlatformVersionCommand extends $Command< CreatePlatformVersionCommandInput, CreatePlatformVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreatePlatformVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/CreateStorageLocationCommand.ts b/clients/client-elastic-beanstalk/commands/CreateStorageLocationCommand.ts index dda121b30c742..02c7230941f51 100644 --- a/clients/client-elastic-beanstalk/commands/CreateStorageLocationCommand.ts +++ b/clients/client-elastic-beanstalk/commands/CreateStorageLocationCommand.ts @@ -20,6 +20,13 @@ import { export type CreateStorageLocationCommandInput = {}; export type CreateStorageLocationCommandOutput = CreateStorageLocationResultMessage & __MetadataBearer; +/** + *

Creates a bucket in Amazon S3 to store application versions, logs, and other files used + * by Elastic Beanstalk environments. The Elastic Beanstalk console and EB CLI call this API the + * first time you create an environment in a region. If the storage location already exists, + * CreateStorageLocation still returns the bucket name but does not create a new + * bucket.

+ */ export class CreateStorageLocationCommand extends $Command< CreateStorageLocationCommandInput, CreateStorageLocationCommandOutput, @@ -34,6 +41,9 @@ export class CreateStorageLocationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DeleteApplicationCommand.ts b/clients/client-elastic-beanstalk/commands/DeleteApplicationCommand.ts index c7b2338da2010..944a1963786f0 100644 --- a/clients/client-elastic-beanstalk/commands/DeleteApplicationCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DeleteApplicationCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteApplicationCommandInput = DeleteApplicationMessage; export type DeleteApplicationCommandOutput = __MetadataBearer; +/** + *

Deletes the specified application along with all associated versions and + * configurations. The application versions will not be deleted from your Amazon S3 + * bucket.

+ * + *

You cannot delete an application that has a running environment.

+ *
+ */ export class DeleteApplicationCommand extends $Command< DeleteApplicationCommandInput, DeleteApplicationCommandOutput, @@ -34,6 +42,9 @@ export class DeleteApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DeleteApplicationVersionCommand.ts b/clients/client-elastic-beanstalk/commands/DeleteApplicationVersionCommand.ts index e4b01e97e9faa..3473ad794de43 100644 --- a/clients/client-elastic-beanstalk/commands/DeleteApplicationVersionCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DeleteApplicationVersionCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteApplicationVersionCommandInput = DeleteApplicationVersionMessage; export type DeleteApplicationVersionCommandOutput = __MetadataBearer; +/** + *

Deletes the specified version from the specified application.

+ * + *

You cannot delete an application version that is associated with a running + * environment.

+ *
+ */ export class DeleteApplicationVersionCommand extends $Command< DeleteApplicationVersionCommandInput, DeleteApplicationVersionCommandOutput, @@ -34,6 +41,9 @@ export class DeleteApplicationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DeleteConfigurationTemplateCommand.ts b/clients/client-elastic-beanstalk/commands/DeleteConfigurationTemplateCommand.ts index a58968f93ee72..3c80ee3a2f12b 100644 --- a/clients/client-elastic-beanstalk/commands/DeleteConfigurationTemplateCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DeleteConfigurationTemplateCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteConfigurationTemplateCommandInput = DeleteConfigurationTemplateMessage; export type DeleteConfigurationTemplateCommandOutput = __MetadataBearer; +/** + *

Deletes the specified configuration template.

+ * + *

When you launch an environment using a configuration template, the environment gets a + * copy of the template. You can delete or modify the environment's copy of the template + * without affecting the running environment.

+ *
+ */ export class DeleteConfigurationTemplateCommand extends $Command< DeleteConfigurationTemplateCommandInput, DeleteConfigurationTemplateCommandOutput, @@ -34,6 +42,9 @@ export class DeleteConfigurationTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DeleteEnvironmentConfigurationCommand.ts b/clients/client-elastic-beanstalk/commands/DeleteEnvironmentConfigurationCommand.ts index ffca65efe8211..dcd843d0a3d87 100644 --- a/clients/client-elastic-beanstalk/commands/DeleteEnvironmentConfigurationCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DeleteEnvironmentConfigurationCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteEnvironmentConfigurationCommandInput = DeleteEnvironmentConfigurationMessage; export type DeleteEnvironmentConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the draft configuration associated with the running environment.

+ *

Updating a running environment with any configuration changes creates a draft + * configuration set. You can get the draft configuration using DescribeConfigurationSettings while the update is in progress or if the update + * fails. The DeploymentStatus for the draft configuration indicates whether the + * deployment is in process or has failed. The draft configuration remains in existence until it + * is deleted with this action.

+ */ export class DeleteEnvironmentConfigurationCommand extends $Command< DeleteEnvironmentConfigurationCommandInput, DeleteEnvironmentConfigurationCommandOutput, @@ -34,6 +42,9 @@ export class DeleteEnvironmentConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DeletePlatformVersionCommand.ts b/clients/client-elastic-beanstalk/commands/DeletePlatformVersionCommand.ts index b33cc8fd44557..8562785914abc 100644 --- a/clients/client-elastic-beanstalk/commands/DeletePlatformVersionCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DeletePlatformVersionCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePlatformVersionCommandInput = DeletePlatformVersionRequest; export type DeletePlatformVersionCommandOutput = DeletePlatformVersionResult & __MetadataBearer; +/** + *

Deletes the specified version of a custom platform.

+ */ export class DeletePlatformVersionCommand extends $Command< DeletePlatformVersionCommandInput, DeletePlatformVersionCommandOutput, @@ -34,6 +37,9 @@ export class DeletePlatformVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeAccountAttributesCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeAccountAttributesCommand.ts index f3fed6700da9d..66a529ffd60bd 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeAccountAttributesCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeAccountAttributesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAccountAttributesCommandInput = {}; export type DescribeAccountAttributesCommandOutput = DescribeAccountAttributesResult & __MetadataBearer; +/** + *

Returns attributes related to AWS Elastic Beanstalk that are associated with the calling AWS + * account.

+ *

The result currently has one set of attributes—resource quotas.

+ */ export class DescribeAccountAttributesCommand extends $Command< DescribeAccountAttributesCommandInput, DescribeAccountAttributesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAccountAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeApplicationVersionsCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeApplicationVersionsCommand.ts index ed27575215cbf..8effa2a611df7 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeApplicationVersionsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeApplicationVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeApplicationVersionsCommandInput = DescribeApplicationVersionsMessage; export type DescribeApplicationVersionsCommandOutput = ApplicationVersionDescriptionsMessage & __MetadataBearer; +/** + *

Retrieve a list of application versions.

+ */ export class DescribeApplicationVersionsCommand extends $Command< DescribeApplicationVersionsCommandInput, DescribeApplicationVersionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeApplicationVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeApplicationsCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeApplicationsCommand.ts index 824e2f6009fb2..293e0d67b0492 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeApplicationsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeApplicationsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeApplicationsCommandInput = DescribeApplicationsMessage; export type DescribeApplicationsCommandOutput = ApplicationDescriptionsMessage & __MetadataBearer; +/** + *

Returns the descriptions of existing applications.

+ */ export class DescribeApplicationsCommand extends $Command< DescribeApplicationsCommandInput, DescribeApplicationsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeConfigurationOptionsCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeConfigurationOptionsCommand.ts index a1c26fb770252..2b9fa256abf67 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeConfigurationOptionsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeConfigurationOptionsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeConfigurationOptionsCommandInput = DescribeConfigurationOptionsMessage; export type DescribeConfigurationOptionsCommandOutput = ConfigurationOptionsDescription & __MetadataBearer; +/** + *

Describes the configuration options that are used in a particular configuration + * template or environment, or that a specified solution stack defines. The description includes + * the values the options, their default values, and an indication of the required action on a + * running environment if an option value is changed.

+ */ export class DescribeConfigurationOptionsCommand extends $Command< DescribeConfigurationOptionsCommandInput, DescribeConfigurationOptionsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeConfigurationOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeConfigurationSettingsCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeConfigurationSettingsCommand.ts index bb623390eb964..9c72bc69dffed 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeConfigurationSettingsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeConfigurationSettingsCommand.ts @@ -20,6 +20,23 @@ import { export type DescribeConfigurationSettingsCommandInput = DescribeConfigurationSettingsMessage; export type DescribeConfigurationSettingsCommandOutput = ConfigurationSettingsDescriptions & __MetadataBearer; +/** + *

Returns a description of the settings for the specified configuration set, that is, + * either a configuration template or the configuration set associated with a running + * environment.

+ *

When describing the settings for the configuration set associated with a running + * environment, it is possible to receive two sets of setting descriptions. One is the deployed + * configuration set, and the other is a draft configuration of an environment that is either in + * the process of deployment or that failed to deploy.

+ *

Related Topics

+ * + */ export class DescribeConfigurationSettingsCommand extends $Command< DescribeConfigurationSettingsCommandInput, DescribeConfigurationSettingsCommandOutput, @@ -34,6 +51,9 @@ export class DescribeConfigurationSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentHealthCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentHealthCommand.ts index 996531e56ef7a..611e3d610d9cb 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentHealthCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentHealthCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeEnvironmentHealthCommandInput = DescribeEnvironmentHealthRequest; export type DescribeEnvironmentHealthCommandOutput = DescribeEnvironmentHealthResult & __MetadataBearer; +/** + *

Returns information about the overall health of the specified environment. The + * DescribeEnvironmentHealth operation is only available with + * AWS Elastic Beanstalk Enhanced Health.

+ */ export class DescribeEnvironmentHealthCommand extends $Command< DescribeEnvironmentHealthCommandInput, DescribeEnvironmentHealthCommandOutput, @@ -34,6 +39,9 @@ export class DescribeEnvironmentHealthCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentManagedActionHistoryCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentManagedActionHistoryCommand.ts index 5cdf60bb4c879..49cf3c660eb4c 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentManagedActionHistoryCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentManagedActionHistoryCommand.ts @@ -24,6 +24,9 @@ export type DescribeEnvironmentManagedActionHistoryCommandInput = DescribeEnviro export type DescribeEnvironmentManagedActionHistoryCommandOutput = DescribeEnvironmentManagedActionHistoryResult & __MetadataBearer; +/** + *

Lists an environment's completed and failed managed actions.

+ */ export class DescribeEnvironmentManagedActionHistoryCommand extends $Command< DescribeEnvironmentManagedActionHistoryCommandInput, DescribeEnvironmentManagedActionHistoryCommandOutput, @@ -38,6 +41,9 @@ export class DescribeEnvironmentManagedActionHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentManagedActionsCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentManagedActionsCommand.ts index 9214e0947184f..2937c39f6bac4 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentManagedActionsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentManagedActionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEnvironmentManagedActionsCommandInput = DescribeEnvironmentManagedActionsRequest; export type DescribeEnvironmentManagedActionsCommandOutput = DescribeEnvironmentManagedActionsResult & __MetadataBearer; +/** + *

Lists an environment's upcoming and in-progress managed actions.

+ */ export class DescribeEnvironmentManagedActionsCommand extends $Command< DescribeEnvironmentManagedActionsCommandInput, DescribeEnvironmentManagedActionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEnvironmentManagedActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentResourcesCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentResourcesCommand.ts index 9fc05fca7ab96..c8ee07b19d92b 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentResourcesCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEnvironmentResourcesCommandInput = DescribeEnvironmentResourcesMessage; export type DescribeEnvironmentResourcesCommandOutput = EnvironmentResourceDescriptionsMessage & __MetadataBearer; +/** + *

Returns AWS resources for this environment.

+ */ export class DescribeEnvironmentResourcesCommand extends $Command< DescribeEnvironmentResourcesCommandInput, DescribeEnvironmentResourcesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEnvironmentResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentsCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentsCommand.ts index 199f5faee4509..e520f559e6d7a 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeEnvironmentsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeEnvironmentsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEnvironmentsCommandInput = DescribeEnvironmentsMessage; export type DescribeEnvironmentsCommandOutput = EnvironmentDescriptionsMessage & __MetadataBearer; +/** + *

Returns descriptions for existing environments.

+ */ export class DescribeEnvironmentsCommand extends $Command< DescribeEnvironmentsCommandInput, DescribeEnvironmentsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEnvironmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeEventsCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeEventsCommand.ts index 7afdb89dab577..dc74c9d70103a 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeEventsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeEventsCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeEventsCommandInput = DescribeEventsMessage; export type DescribeEventsCommandOutput = EventDescriptionsMessage & __MetadataBearer; +/** + *

Returns list of event descriptions matching criteria up to the last 6 weeks.

+ * + *

This action returns the most recent 1,000 events from the specified + * NextToken.

+ *
+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +41,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribeInstancesHealthCommand.ts b/clients/client-elastic-beanstalk/commands/DescribeInstancesHealthCommand.ts index 8eb549d19190b..ecc37cd0bdedf 100644 --- a/clients/client-elastic-beanstalk/commands/DescribeInstancesHealthCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribeInstancesHealthCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeInstancesHealthCommandInput = DescribeInstancesHealthRequest; export type DescribeInstancesHealthCommandOutput = DescribeInstancesHealthResult & __MetadataBearer; +/** + *

Retrieves detailed information about the health of instances in your AWS Elastic + * Beanstalk. This operation requires enhanced health + * reporting.

+ */ export class DescribeInstancesHealthCommand extends $Command< DescribeInstancesHealthCommandInput, DescribeInstancesHealthCommandOutput, @@ -34,6 +39,9 @@ export class DescribeInstancesHealthCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DescribePlatformVersionCommand.ts b/clients/client-elastic-beanstalk/commands/DescribePlatformVersionCommand.ts index 28f7901335d0d..f7cf7136d7550 100644 --- a/clients/client-elastic-beanstalk/commands/DescribePlatformVersionCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DescribePlatformVersionCommand.ts @@ -20,6 +20,12 @@ import { export type DescribePlatformVersionCommandInput = DescribePlatformVersionRequest; export type DescribePlatformVersionCommandOutput = DescribePlatformVersionResult & __MetadataBearer; +/** + *

Describes a platform version. Provides full details. Compare to ListPlatformVersions, which provides summary information about a list of + * platform versions.

+ *

For definitions of platform version and other platform-related terms, see AWS Elastic Beanstalk + * Platforms Glossary.

+ */ export class DescribePlatformVersionCommand extends $Command< DescribePlatformVersionCommandInput, DescribePlatformVersionCommandOutput, @@ -34,6 +40,9 @@ export class DescribePlatformVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/DisassociateEnvironmentOperationsRoleCommand.ts b/clients/client-elastic-beanstalk/commands/DisassociateEnvironmentOperationsRoleCommand.ts index bf09c31bd399b..3f856df9a7583 100644 --- a/clients/client-elastic-beanstalk/commands/DisassociateEnvironmentOperationsRoleCommand.ts +++ b/clients/client-elastic-beanstalk/commands/DisassociateEnvironmentOperationsRoleCommand.ts @@ -20,6 +20,12 @@ import { export type DisassociateEnvironmentOperationsRoleCommandInput = DisassociateEnvironmentOperationsRoleMessage; export type DisassociateEnvironmentOperationsRoleCommandOutput = __MetadataBearer; +/** + *

Disassociate the operations role from an environment. After this call is made, Elastic Beanstalk uses + * the caller's permissions for permissions to downstream services during subsequent calls acting + * on this environment. For more information, see Operations roles in the + * AWS Elastic Beanstalk Developer Guide.

+ */ export class DisassociateEnvironmentOperationsRoleCommand extends $Command< DisassociateEnvironmentOperationsRoleCommandInput, DisassociateEnvironmentOperationsRoleCommandOutput, @@ -34,6 +40,9 @@ export class DisassociateEnvironmentOperationsRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/ListAvailableSolutionStacksCommand.ts b/clients/client-elastic-beanstalk/commands/ListAvailableSolutionStacksCommand.ts index 9908594a38265..6711368e9bb96 100644 --- a/clients/client-elastic-beanstalk/commands/ListAvailableSolutionStacksCommand.ts +++ b/clients/client-elastic-beanstalk/commands/ListAvailableSolutionStacksCommand.ts @@ -20,6 +20,10 @@ import { export type ListAvailableSolutionStacksCommandInput = {}; export type ListAvailableSolutionStacksCommandOutput = ListAvailableSolutionStacksResultMessage & __MetadataBearer; +/** + *

Returns a list of the available solution stack names, with the public version first and + * then in reverse chronological order.

+ */ export class ListAvailableSolutionStacksCommand extends $Command< ListAvailableSolutionStacksCommandInput, ListAvailableSolutionStacksCommandOutput, @@ -34,6 +38,9 @@ export class ListAvailableSolutionStacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/ListPlatformBranchesCommand.ts b/clients/client-elastic-beanstalk/commands/ListPlatformBranchesCommand.ts index 61a38221736fb..38bbd2fc5ec08 100644 --- a/clients/client-elastic-beanstalk/commands/ListPlatformBranchesCommand.ts +++ b/clients/client-elastic-beanstalk/commands/ListPlatformBranchesCommand.ts @@ -20,6 +20,12 @@ import { export type ListPlatformBranchesCommandInput = ListPlatformBranchesRequest; export type ListPlatformBranchesCommandOutput = ListPlatformBranchesResult & __MetadataBearer; +/** + *

Lists the platform branches available for your account in an AWS Region. Provides + * summary information about each platform branch.

+ *

For definitions of platform branch and other platform-related terms, see AWS Elastic Beanstalk + * Platforms Glossary.

+ */ export class ListPlatformBranchesCommand extends $Command< ListPlatformBranchesCommandInput, ListPlatformBranchesCommandOutput, @@ -34,6 +40,9 @@ export class ListPlatformBranchesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/ListPlatformVersionsCommand.ts b/clients/client-elastic-beanstalk/commands/ListPlatformVersionsCommand.ts index d415cc46b01fb..cb8eaade12364 100644 --- a/clients/client-elastic-beanstalk/commands/ListPlatformVersionsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/ListPlatformVersionsCommand.ts @@ -20,6 +20,13 @@ import { export type ListPlatformVersionsCommandInput = ListPlatformVersionsRequest; export type ListPlatformVersionsCommandOutput = ListPlatformVersionsResult & __MetadataBearer; +/** + *

Lists the platform versions available for your account in an AWS Region. Provides + * summary information about each platform version. Compare to DescribePlatformVersion, which provides full details about a single platform + * version.

+ *

For definitions of platform version and other platform-related terms, see AWS Elastic Beanstalk + * Platforms Glossary.

+ */ export class ListPlatformVersionsCommand extends $Command< ListPlatformVersionsCommandInput, ListPlatformVersionsCommandOutput, @@ -34,6 +41,9 @@ export class ListPlatformVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/ListTagsForResourceCommand.ts b/clients/client-elastic-beanstalk/commands/ListTagsForResourceCommand.ts index 3b61759974c0b..37fbcd7e3ffd8 100644 --- a/clients/client-elastic-beanstalk/commands/ListTagsForResourceCommand.ts +++ b/clients/client-elastic-beanstalk/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,12 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceMessage; export type ListTagsForResourceCommandOutput = ResourceTagsDescriptionMessage & __MetadataBearer; +/** + *

Return the tags applied to an AWS Elastic Beanstalk resource. The response contains a list of tag key-value pairs.

+ *

Elastic Beanstalk supports tagging of all of its resources. For details about resource tagging, see + * Tagging Application + * Resources.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +40,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/RebuildEnvironmentCommand.ts b/clients/client-elastic-beanstalk/commands/RebuildEnvironmentCommand.ts index 18e42683b7a5f..29eadf4b1ffcd 100644 --- a/clients/client-elastic-beanstalk/commands/RebuildEnvironmentCommand.ts +++ b/clients/client-elastic-beanstalk/commands/RebuildEnvironmentCommand.ts @@ -20,6 +20,10 @@ import { export type RebuildEnvironmentCommandInput = RebuildEnvironmentMessage; export type RebuildEnvironmentCommandOutput = __MetadataBearer; +/** + *

Deletes and recreates all of the AWS resources (for example: the Auto Scaling group, + * load balancer, etc.) for a specified environment and forces a restart.

+ */ export class RebuildEnvironmentCommand extends $Command< RebuildEnvironmentCommandInput, RebuildEnvironmentCommandOutput, @@ -34,6 +38,9 @@ export class RebuildEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/RequestEnvironmentInfoCommand.ts b/clients/client-elastic-beanstalk/commands/RequestEnvironmentInfoCommand.ts index db541f69a5172..748152fa64313 100644 --- a/clients/client-elastic-beanstalk/commands/RequestEnvironmentInfoCommand.ts +++ b/clients/client-elastic-beanstalk/commands/RequestEnvironmentInfoCommand.ts @@ -20,6 +20,24 @@ import { export type RequestEnvironmentInfoCommandInput = RequestEnvironmentInfoMessage; export type RequestEnvironmentInfoCommandOutput = __MetadataBearer; +/** + *

Initiates a request to compile the specified type of information of the deployed + * environment.

+ *

Setting the InfoType to tail compiles the last lines from + * the application server log files of every Amazon EC2 instance in your environment.

+ *

Setting the InfoType to bundle compresses the application + * server log files for every Amazon EC2 instance into a .zip file. Legacy and .NET + * containers do not support bundle logs.

+ *

Use RetrieveEnvironmentInfo to obtain the set of logs.

+ *

Related Topics

+ * + */ export class RequestEnvironmentInfoCommand extends $Command< RequestEnvironmentInfoCommandInput, RequestEnvironmentInfoCommandOutput, @@ -34,6 +52,9 @@ export class RequestEnvironmentInfoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/RestartAppServerCommand.ts b/clients/client-elastic-beanstalk/commands/RestartAppServerCommand.ts index 9a562209bc672..c81baf2681feb 100644 --- a/clients/client-elastic-beanstalk/commands/RestartAppServerCommand.ts +++ b/clients/client-elastic-beanstalk/commands/RestartAppServerCommand.ts @@ -20,6 +20,10 @@ import { export type RestartAppServerCommandInput = RestartAppServerMessage; export type RestartAppServerCommandOutput = __MetadataBearer; +/** + *

Causes the environment to restart the application container server running on each + * Amazon EC2 instance.

+ */ export class RestartAppServerCommand extends $Command< RestartAppServerCommandInput, RestartAppServerCommandOutput, @@ -34,6 +38,9 @@ export class RestartAppServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/RetrieveEnvironmentInfoCommand.ts b/clients/client-elastic-beanstalk/commands/RetrieveEnvironmentInfoCommand.ts index 4e9697c34923b..4975c92b27004 100644 --- a/clients/client-elastic-beanstalk/commands/RetrieveEnvironmentInfoCommand.ts +++ b/clients/client-elastic-beanstalk/commands/RetrieveEnvironmentInfoCommand.ts @@ -20,6 +20,18 @@ import { export type RetrieveEnvironmentInfoCommandInput = RetrieveEnvironmentInfoMessage; export type RetrieveEnvironmentInfoCommandOutput = RetrieveEnvironmentInfoResultMessage & __MetadataBearer; +/** + *

Retrieves the compiled information from a RequestEnvironmentInfo + * request.

+ *

Related Topics

+ * + */ export class RetrieveEnvironmentInfoCommand extends $Command< RetrieveEnvironmentInfoCommandInput, RetrieveEnvironmentInfoCommandOutput, @@ -34,6 +46,9 @@ export class RetrieveEnvironmentInfoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/SwapEnvironmentCNAMEsCommand.ts b/clients/client-elastic-beanstalk/commands/SwapEnvironmentCNAMEsCommand.ts index 953b0145e6719..4e0efc66acdc5 100644 --- a/clients/client-elastic-beanstalk/commands/SwapEnvironmentCNAMEsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/SwapEnvironmentCNAMEsCommand.ts @@ -20,6 +20,9 @@ import { export type SwapEnvironmentCNAMEsCommandInput = SwapEnvironmentCNAMEsMessage; export type SwapEnvironmentCNAMEsCommandOutput = __MetadataBearer; +/** + *

Swaps the CNAMEs of two environments.

+ */ export class SwapEnvironmentCNAMEsCommand extends $Command< SwapEnvironmentCNAMEsCommandInput, SwapEnvironmentCNAMEsCommandOutput, @@ -34,6 +37,9 @@ export class SwapEnvironmentCNAMEsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/TerminateEnvironmentCommand.ts b/clients/client-elastic-beanstalk/commands/TerminateEnvironmentCommand.ts index 36c1e32d06432..c0ccfe651db4c 100644 --- a/clients/client-elastic-beanstalk/commands/TerminateEnvironmentCommand.ts +++ b/clients/client-elastic-beanstalk/commands/TerminateEnvironmentCommand.ts @@ -20,6 +20,9 @@ import { export type TerminateEnvironmentCommandInput = TerminateEnvironmentMessage; export type TerminateEnvironmentCommandOutput = EnvironmentDescription & __MetadataBearer; +/** + *

Terminates the specified environment.

+ */ export class TerminateEnvironmentCommand extends $Command< TerminateEnvironmentCommandInput, TerminateEnvironmentCommandOutput, @@ -34,6 +37,9 @@ export class TerminateEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/UpdateApplicationCommand.ts b/clients/client-elastic-beanstalk/commands/UpdateApplicationCommand.ts index 0021e5575b8a5..49073af795e59 100644 --- a/clients/client-elastic-beanstalk/commands/UpdateApplicationCommand.ts +++ b/clients/client-elastic-beanstalk/commands/UpdateApplicationCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationMessage; export type UpdateApplicationCommandOutput = ApplicationDescriptionMessage & __MetadataBearer; +/** + *

Updates the specified application to have the specified properties.

+ * + *

If a property (for example, description) is not provided, the value + * remains unchanged. To clear these properties, specify an empty string.

+ *
+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -34,6 +41,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/UpdateApplicationResourceLifecycleCommand.ts b/clients/client-elastic-beanstalk/commands/UpdateApplicationResourceLifecycleCommand.ts index e85c978313a7e..5d95b99f68a51 100644 --- a/clients/client-elastic-beanstalk/commands/UpdateApplicationResourceLifecycleCommand.ts +++ b/clients/client-elastic-beanstalk/commands/UpdateApplicationResourceLifecycleCommand.ts @@ -24,6 +24,9 @@ export type UpdateApplicationResourceLifecycleCommandInput = UpdateApplicationRe export type UpdateApplicationResourceLifecycleCommandOutput = ApplicationResourceLifecycleDescriptionMessage & __MetadataBearer; +/** + *

Modifies lifecycle settings for an application.

+ */ export class UpdateApplicationResourceLifecycleCommand extends $Command< UpdateApplicationResourceLifecycleCommandInput, UpdateApplicationResourceLifecycleCommandOutput, @@ -38,6 +41,9 @@ export class UpdateApplicationResourceLifecycleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/UpdateApplicationVersionCommand.ts b/clients/client-elastic-beanstalk/commands/UpdateApplicationVersionCommand.ts index 5802393cd6dde..9aadc4768eb42 100644 --- a/clients/client-elastic-beanstalk/commands/UpdateApplicationVersionCommand.ts +++ b/clients/client-elastic-beanstalk/commands/UpdateApplicationVersionCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateApplicationVersionCommandInput = UpdateApplicationVersionMessage; export type UpdateApplicationVersionCommandOutput = ApplicationVersionDescriptionMessage & __MetadataBearer; +/** + *

Updates the specified application version to have the specified properties.

+ * + *

If a property (for example, description) is not provided, the value + * remains unchanged. To clear properties, specify an empty string.

+ *
+ */ export class UpdateApplicationVersionCommand extends $Command< UpdateApplicationVersionCommandInput, UpdateApplicationVersionCommandOutput, @@ -34,6 +41,9 @@ export class UpdateApplicationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/UpdateConfigurationTemplateCommand.ts b/clients/client-elastic-beanstalk/commands/UpdateConfigurationTemplateCommand.ts index 6b6b394d14f5b..cb82133586368 100644 --- a/clients/client-elastic-beanstalk/commands/UpdateConfigurationTemplateCommand.ts +++ b/clients/client-elastic-beanstalk/commands/UpdateConfigurationTemplateCommand.ts @@ -20,6 +20,22 @@ import { export type UpdateConfigurationTemplateCommandInput = UpdateConfigurationTemplateMessage; export type UpdateConfigurationTemplateCommandOutput = ConfigurationSettingsDescription & __MetadataBearer; +/** + *

Updates the specified configuration template to have the specified properties or + * configuration option values.

+ * + *

If a property (for example, ApplicationName) is not provided, its value + * remains unchanged. To clear such properties, specify an empty string.

+ *
+ *

Related Topics

+ * + */ export class UpdateConfigurationTemplateCommand extends $Command< UpdateConfigurationTemplateCommandInput, UpdateConfigurationTemplateCommandOutput, @@ -34,6 +50,9 @@ export class UpdateConfigurationTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/UpdateEnvironmentCommand.ts b/clients/client-elastic-beanstalk/commands/UpdateEnvironmentCommand.ts index 4507d34ab4865..4bc299e5c1228 100644 --- a/clients/client-elastic-beanstalk/commands/UpdateEnvironmentCommand.ts +++ b/clients/client-elastic-beanstalk/commands/UpdateEnvironmentCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateEnvironmentCommandInput = UpdateEnvironmentMessage; export type UpdateEnvironmentCommandOutput = EnvironmentDescription & __MetadataBearer; +/** + *

Updates the environment description, deploys a new application version, updates the + * configuration settings to an entirely new configuration template, or updates select + * configuration option values in the running environment.

+ *

Attempting to update both the release and configuration is not allowed and AWS Elastic + * Beanstalk returns an InvalidParameterCombination error.

+ *

When updating the configuration settings to a new template or individual settings, a + * draft configuration is created and DescribeConfigurationSettings for this + * environment returns two setting descriptions with different DeploymentStatus + * values.

+ */ export class UpdateEnvironmentCommand extends $Command< UpdateEnvironmentCommandInput, UpdateEnvironmentCommandOutput, @@ -34,6 +45,9 @@ export class UpdateEnvironmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/UpdateTagsForResourceCommand.ts b/clients/client-elastic-beanstalk/commands/UpdateTagsForResourceCommand.ts index 5fd7f78d4d082..032c09e5e3002 100644 --- a/clients/client-elastic-beanstalk/commands/UpdateTagsForResourceCommand.ts +++ b/clients/client-elastic-beanstalk/commands/UpdateTagsForResourceCommand.ts @@ -20,6 +20,28 @@ import { export type UpdateTagsForResourceCommandInput = UpdateTagsForResourceMessage; export type UpdateTagsForResourceCommandOutput = __MetadataBearer; +/** + *

Update the list of tags applied to an AWS Elastic Beanstalk resource. Two lists can be passed: TagsToAdd + * for tags to add or update, and TagsToRemove.

+ *

Elastic Beanstalk supports tagging of all of its resources. For details about resource tagging, see + * Tagging Application + * Resources.

+ *

If you create a custom IAM user policy to control permission to this operation, specify + * one of the following two virtual actions (or both) instead of the API operation name:

+ *
+ *
elasticbeanstalk:AddTags
+ *
+ *

Controls permission to call UpdateTagsForResource and pass a list of tags to add in the TagsToAdd + * parameter.

+ *
+ *
elasticbeanstalk:RemoveTags
+ *
+ *

Controls permission to call UpdateTagsForResource and pass a list of tag keys to remove in the TagsToRemove + * parameter.

+ *
+ *
+ *

For details about creating a custom user policy, see Creating a Custom User Policy.

+ */ export class UpdateTagsForResourceCommand extends $Command< UpdateTagsForResourceCommandInput, UpdateTagsForResourceCommandOutput, @@ -34,6 +56,9 @@ export class UpdateTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/commands/ValidateConfigurationSettingsCommand.ts b/clients/client-elastic-beanstalk/commands/ValidateConfigurationSettingsCommand.ts index fe363598560d9..1296bc289ef44 100644 --- a/clients/client-elastic-beanstalk/commands/ValidateConfigurationSettingsCommand.ts +++ b/clients/client-elastic-beanstalk/commands/ValidateConfigurationSettingsCommand.ts @@ -20,6 +20,12 @@ import { export type ValidateConfigurationSettingsCommandInput = ValidateConfigurationSettingsMessage; export type ValidateConfigurationSettingsCommandOutput = ConfigurationSettingsValidationMessages & __MetadataBearer; +/** + *

Takes a set of configuration settings and either a configuration template or + * environment, and determines whether those values are valid.

+ *

This action returns a list of messages indicating any errors or warnings associated + * with the selection of option values.

+ */ export class ValidateConfigurationSettingsCommand extends $Command< ValidateConfigurationSettingsCommandInput, ValidateConfigurationSettingsCommandOutput, @@ -34,6 +40,9 @@ export class ValidateConfigurationSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticBeanstalkClientResolvedConfig, diff --git a/clients/client-elastic-beanstalk/package.json b/clients/client-elastic-beanstalk/package.json index 01788e4a8d4b4..9b04ab5a5f2e3 100644 --- a/clients/client-elastic-beanstalk/package.json +++ b/clients/client-elastic-beanstalk/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Elastic Beanstalk Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-elastic-beanstalk/pagination/DescribeEnvironmentManagedActionHistoryPaginator.ts b/clients/client-elastic-beanstalk/pagination/DescribeEnvironmentManagedActionHistoryPaginator.ts index f45b8ada7e0ab..0617af584c3b3 100644 --- a/clients/client-elastic-beanstalk/pagination/DescribeEnvironmentManagedActionHistoryPaginator.ts +++ b/clients/client-elastic-beanstalk/pagination/DescribeEnvironmentManagedActionHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticBeanstalkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticBeanstalkClient, input: DescribeEnvironmentManagedActionHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEnvironmentManagedActionHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticBeanstalk, input: DescribeEnvironmentManagedActionHistoryCommandInput, diff --git a/clients/client-elastic-beanstalk/pagination/DescribeEventsPaginator.ts b/clients/client-elastic-beanstalk/pagination/DescribeEventsPaginator.ts index 8a26d703c8bfd..78747bf55478d 100644 --- a/clients/client-elastic-beanstalk/pagination/DescribeEventsPaginator.ts +++ b/clients/client-elastic-beanstalk/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticBeanstalkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticBeanstalkClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticBeanstalk, input: DescribeEventsCommandInput, diff --git a/clients/client-elastic-beanstalk/pagination/ListPlatformBranchesPaginator.ts b/clients/client-elastic-beanstalk/pagination/ListPlatformBranchesPaginator.ts index 39349b7fa8dfa..1be4a7a649abc 100644 --- a/clients/client-elastic-beanstalk/pagination/ListPlatformBranchesPaginator.ts +++ b/clients/client-elastic-beanstalk/pagination/ListPlatformBranchesPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticBeanstalkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticBeanstalkClient, input: ListPlatformBranchesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPlatformBranchesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticBeanstalk, input: ListPlatformBranchesCommandInput, diff --git a/clients/client-elastic-beanstalk/pagination/ListPlatformVersionsPaginator.ts b/clients/client-elastic-beanstalk/pagination/ListPlatformVersionsPaginator.ts index c4340c8de89f9..6337a7412a22d 100644 --- a/clients/client-elastic-beanstalk/pagination/ListPlatformVersionsPaginator.ts +++ b/clients/client-elastic-beanstalk/pagination/ListPlatformVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticBeanstalkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticBeanstalkClient, input: ListPlatformVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPlatformVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticBeanstalk, input: ListPlatformVersionsCommandInput, diff --git a/clients/client-elastic-beanstalk/runtimeConfig.browser.ts b/clients/client-elastic-beanstalk/runtimeConfig.browser.ts index 881c08c6bf49d..cccc16d0958ba 100644 --- a/clients/client-elastic-beanstalk/runtimeConfig.browser.ts +++ b/clients/client-elastic-beanstalk/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ElasticBeanstalkClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-elastic-beanstalk/runtimeConfig.native.ts b/clients/client-elastic-beanstalk/runtimeConfig.native.ts index bb63bd9ad04e9..848ae9a1aa504 100644 --- a/clients/client-elastic-beanstalk/runtimeConfig.native.ts +++ b/clients/client-elastic-beanstalk/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ElasticBeanstalkClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-elastic-beanstalk/runtimeConfig.shared.ts b/clients/client-elastic-beanstalk/runtimeConfig.shared.ts index 25f8c75f8d100..1795359c5daa1 100644 --- a/clients/client-elastic-beanstalk/runtimeConfig.shared.ts +++ b/clients/client-elastic-beanstalk/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2010-12-01", disableHostPrefix: false, diff --git a/clients/client-elastic-beanstalk/runtimeConfig.ts b/clients/client-elastic-beanstalk/runtimeConfig.ts index b03f9650625b7..a22e1a8cb295e 100644 --- a/clients/client-elastic-beanstalk/runtimeConfig.ts +++ b/clients/client-elastic-beanstalk/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ElasticBeanstalkClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-elastic-beanstalk/tsconfig.json b/clients/client-elastic-beanstalk/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-elastic-beanstalk/tsconfig.json +++ b/clients/client-elastic-beanstalk/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-elastic-inference/commands/DescribeAcceleratorOfferingsCommand.ts b/clients/client-elastic-inference/commands/DescribeAcceleratorOfferingsCommand.ts index f53127758e56b..60e1365a8f36a 100644 --- a/clients/client-elastic-inference/commands/DescribeAcceleratorOfferingsCommand.ts +++ b/clients/client-elastic-inference/commands/DescribeAcceleratorOfferingsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAcceleratorOfferingsCommandInput = DescribeAcceleratorOfferingsRequest; export type DescribeAcceleratorOfferingsCommandOutput = DescribeAcceleratorOfferingsResponse & __MetadataBearer; +/** + *

+ * Describes the locations in which a given accelerator type or set of types is present in a given region. + *

+ */ export class DescribeAcceleratorOfferingsCommand extends $Command< DescribeAcceleratorOfferingsCommandInput, DescribeAcceleratorOfferingsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAcceleratorOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticInferenceClientResolvedConfig, diff --git a/clients/client-elastic-inference/commands/DescribeAcceleratorTypesCommand.ts b/clients/client-elastic-inference/commands/DescribeAcceleratorTypesCommand.ts index ff6d03a03272e..ad4d183968a92 100644 --- a/clients/client-elastic-inference/commands/DescribeAcceleratorTypesCommand.ts +++ b/clients/client-elastic-inference/commands/DescribeAcceleratorTypesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAcceleratorTypesCommandInput = DescribeAcceleratorTypesRequest; export type DescribeAcceleratorTypesCommandOutput = DescribeAcceleratorTypesResponse & __MetadataBearer; +/** + *

+ * Describes the accelerator types available in a given region, as well as their characteristics, such as memory and throughput. + *

+ */ export class DescribeAcceleratorTypesCommand extends $Command< DescribeAcceleratorTypesCommandInput, DescribeAcceleratorTypesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAcceleratorTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticInferenceClientResolvedConfig, diff --git a/clients/client-elastic-inference/commands/DescribeAcceleratorsCommand.ts b/clients/client-elastic-inference/commands/DescribeAcceleratorsCommand.ts index fa4f9d7358281..055faa63ae830 100644 --- a/clients/client-elastic-inference/commands/DescribeAcceleratorsCommand.ts +++ b/clients/client-elastic-inference/commands/DescribeAcceleratorsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAcceleratorsCommandInput = DescribeAcceleratorsRequest; export type DescribeAcceleratorsCommandOutput = DescribeAcceleratorsResponse & __MetadataBearer; +/** + *

+ * Describes information over a provided set of accelerators belonging to an account. + *

+ */ export class DescribeAcceleratorsCommand extends $Command< DescribeAcceleratorsCommandInput, DescribeAcceleratorsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAcceleratorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticInferenceClientResolvedConfig, diff --git a/clients/client-elastic-inference/commands/ListTagsForResourceCommand.ts b/clients/client-elastic-inference/commands/ListTagsForResourceCommand.ts index ac483a63062c4..5de8eee1b2b26 100644 --- a/clients/client-elastic-inference/commands/ListTagsForResourceCommand.ts +++ b/clients/client-elastic-inference/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResult & __MetadataBearer; +/** + *

+ * Returns all tags of an Elastic Inference Accelerator. + *

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticInferenceClientResolvedConfig, diff --git a/clients/client-elastic-inference/commands/TagResourceCommand.ts b/clients/client-elastic-inference/commands/TagResourceCommand.ts index 1cbf2009a2fa2..bf3e523852db5 100644 --- a/clients/client-elastic-inference/commands/TagResourceCommand.ts +++ b/clients/client-elastic-inference/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResult & __MetadataBearer; +/** + *

+ * Adds the specified tags to an Elastic Inference Accelerator. + *

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticInferenceClientResolvedConfig, diff --git a/clients/client-elastic-inference/commands/UntagResourceCommand.ts b/clients/client-elastic-inference/commands/UntagResourceCommand.ts index 374f4c157076e..c258147f1f492 100644 --- a/clients/client-elastic-inference/commands/UntagResourceCommand.ts +++ b/clients/client-elastic-inference/commands/UntagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResult & __MetadataBearer; +/** + *

+ * Removes the specified tags from an Elastic Inference Accelerator. + *

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticInferenceClientResolvedConfig, diff --git a/clients/client-elastic-inference/package.json b/clients/client-elastic-inference/package.json index 45c86d558a786..c977df7c2f088 100644 --- a/clients/client-elastic-inference/package.json +++ b/clients/client-elastic-inference/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Elastic Inference Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-elastic-inference/pagination/DescribeAcceleratorsPaginator.ts b/clients/client-elastic-inference/pagination/DescribeAcceleratorsPaginator.ts index 37404c39fcd99..cd9c3c363bc97 100644 --- a/clients/client-elastic-inference/pagination/DescribeAcceleratorsPaginator.ts +++ b/clients/client-elastic-inference/pagination/DescribeAcceleratorsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticInferencePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticInferenceClient, input: DescribeAcceleratorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAcceleratorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticInference, input: DescribeAcceleratorsCommandInput, diff --git a/clients/client-elastic-inference/runtimeConfig.browser.ts b/clients/client-elastic-inference/runtimeConfig.browser.ts index 538989082c844..097120a917b74 100644 --- a/clients/client-elastic-inference/runtimeConfig.browser.ts +++ b/clients/client-elastic-inference/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ElasticInferenceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-elastic-inference/runtimeConfig.native.ts b/clients/client-elastic-inference/runtimeConfig.native.ts index fea6814e5bac3..f11ac3fdcf14c 100644 --- a/clients/client-elastic-inference/runtimeConfig.native.ts +++ b/clients/client-elastic-inference/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ElasticInferenceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-elastic-inference/runtimeConfig.shared.ts b/clients/client-elastic-inference/runtimeConfig.shared.ts index c9c36fba732bf..3b004358d8184 100644 --- a/clients/client-elastic-inference/runtimeConfig.shared.ts +++ b/clients/client-elastic-inference/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-25", disableHostPrefix: false, diff --git a/clients/client-elastic-inference/runtimeConfig.ts b/clients/client-elastic-inference/runtimeConfig.ts index 32415194336bd..a5ed0615a7290 100644 --- a/clients/client-elastic-inference/runtimeConfig.ts +++ b/clients/client-elastic-inference/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ElasticInferenceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-elastic-inference/tsconfig.json b/clients/client-elastic-inference/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-elastic-inference/tsconfig.json +++ b/clients/client-elastic-inference/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-elastic-load-balancing-v2/commands/AddListenerCertificatesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/AddListenerCertificatesCommand.ts index 86f7c4a653416..677d64e8ed8fc 100644 --- a/clients/client-elastic-load-balancing-v2/commands/AddListenerCertificatesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/AddListenerCertificatesCommand.ts @@ -24,6 +24,14 @@ import { export type AddListenerCertificatesCommandInput = AddListenerCertificatesInput; export type AddListenerCertificatesCommandOutput = AddListenerCertificatesOutput & __MetadataBearer; +/** + *

Adds the specified SSL server certificate to the certificate list for the specified HTTPS or TLS listener.

+ *

If the certificate in already in the certificate list, the call is successful but the certificate + * is not added again.

+ * + *

For more information, see HTTPS listeners in the Application Load Balancers Guide or TLS listeners in the + * Network Load Balancers Guide.

+ */ export class AddListenerCertificatesCommand extends $Command< AddListenerCertificatesCommandInput, AddListenerCertificatesCommandOutput, @@ -38,6 +46,9 @@ export class AddListenerCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/AddTagsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/AddTagsCommand.ts index 959f4132740cc..c7276d7fef2e0 100644 --- a/clients/client-elastic-load-balancing-v2/commands/AddTagsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/AddTagsCommand.ts @@ -21,6 +21,13 @@ import { export type AddTagsCommandInput = AddTagsInput; export type AddTagsCommandOutput = AddTagsOutput & __MetadataBearer; +/** + *

Adds the specified tags to the specified Elastic Load Balancing resource. You can tag your + * Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, + * listeners, and rules.

+ *

Each tag consists of a key and an optional value. If a resource already has a tag with + * the same key, AddTags updates its value.

+ */ export class AddTagsCommand extends $Command< AddTagsCommandInput, AddTagsCommandOutput, @@ -35,6 +42,9 @@ export class AddTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/CreateListenerCommand.ts b/clients/client-elastic-load-balancing-v2/commands/CreateListenerCommand.ts index 5273a0d8c6846..e554dead71f87 100644 --- a/clients/client-elastic-load-balancing-v2/commands/CreateListenerCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/CreateListenerCommand.ts @@ -24,6 +24,36 @@ import { export type CreateListenerCommandInput = CreateListenerInput; export type CreateListenerCommandOutput = CreateListenerOutput & __MetadataBearer; +/** + *

Creates a listener for the specified Application Load Balancer, Network Load Balancer. or + * Gateway Load Balancer.

+ * + * + *

For more information, see the following:

+ * + * + *

This operation is idempotent, which means that it completes at most one time. If you + * attempt to create multiple listeners with the same settings, each call succeeds.

+ */ export class CreateListenerCommand extends $Command< CreateListenerCommandInput, CreateListenerCommandOutput, @@ -38,6 +68,9 @@ export class CreateListenerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/CreateLoadBalancerCommand.ts b/clients/client-elastic-load-balancing-v2/commands/CreateLoadBalancerCommand.ts index 89da316abf7c6..dec97ccb43076 100644 --- a/clients/client-elastic-load-balancing-v2/commands/CreateLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/CreateLoadBalancerCommand.ts @@ -24,6 +24,34 @@ import { export type CreateLoadBalancerCommandInput = CreateLoadBalancerInput; export type CreateLoadBalancerCommandOutput = CreateLoadBalancerOutput & __MetadataBearer; +/** + *

Creates an Application Load Balancer, Network Load Balancer, or Gateway Load Balancer.

+ * + * + * + *

For more information, see the following:

+ * + * + *

This operation is idempotent, which means that it completes at most one time. If you + * attempt to create multiple load balancers with the same settings, each call + * succeeds.

+ */ export class CreateLoadBalancerCommand extends $Command< CreateLoadBalancerCommandInput, CreateLoadBalancerCommandOutput, @@ -38,6 +66,9 @@ export class CreateLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/CreateRuleCommand.ts b/clients/client-elastic-load-balancing-v2/commands/CreateRuleCommand.ts index 912cefac0c5dc..9eee78842123d 100644 --- a/clients/client-elastic-load-balancing-v2/commands/CreateRuleCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/CreateRuleCommand.ts @@ -21,6 +21,14 @@ import { export type CreateRuleCommandInput = CreateRuleInput; export type CreateRuleCommandOutput = CreateRuleOutput & __MetadataBearer; +/** + *

Creates a rule for the specified listener. The listener must be associated with an + * Application Load Balancer.

+ *

Each rule consists of a priority, one or more actions, and one or more conditions. + * Rules are evaluated in priority order, from the lowest value to the highest value. + * When the conditions for a rule are met, its actions are performed. If the conditions for no rules are met, + * the actions for the default rule are performed. For more information, see Listener rules in the Application Load Balancers Guide.

+ */ export class CreateRuleCommand extends $Command< CreateRuleCommandInput, CreateRuleCommandOutput, @@ -35,6 +43,9 @@ export class CreateRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/CreateTargetGroupCommand.ts b/clients/client-elastic-load-balancing-v2/commands/CreateTargetGroupCommand.ts index db26c5e9d954b..c39a2ccd6f99c 100644 --- a/clients/client-elastic-load-balancing-v2/commands/CreateTargetGroupCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/CreateTargetGroupCommand.ts @@ -24,6 +24,33 @@ import { export type CreateTargetGroupCommandInput = CreateTargetGroupInput; export type CreateTargetGroupCommandOutput = CreateTargetGroupOutput & __MetadataBearer; +/** + *

Creates a target group.

+ * + * + * + *

For more information, see the following:

+ * + * + *

This operation is idempotent, which means that it completes at most one time. If you + * attempt to create multiple target groups with the same settings, each call succeeds.

+ */ export class CreateTargetGroupCommand extends $Command< CreateTargetGroupCommandInput, CreateTargetGroupCommandOutput, @@ -38,6 +65,9 @@ export class CreateTargetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DeleteListenerCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DeleteListenerCommand.ts index 6a3c6bff04ffe..a1215551d3df5 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DeleteListenerCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DeleteListenerCommand.ts @@ -24,6 +24,11 @@ import { export type DeleteListenerCommandInput = DeleteListenerInput; export type DeleteListenerCommandOutput = DeleteListenerOutput & __MetadataBearer; +/** + *

Deletes the specified listener.

+ *

Alternatively, your listener is deleted when you delete the load balancer to which it + * is attached.

+ */ export class DeleteListenerCommand extends $Command< DeleteListenerCommandInput, DeleteListenerCommandOutput, @@ -38,6 +43,9 @@ export class DeleteListenerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DeleteLoadBalancerCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DeleteLoadBalancerCommand.ts index bd96c753274c0..772127f65b537 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DeleteLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DeleteLoadBalancerCommand.ts @@ -24,6 +24,15 @@ import { export type DeleteLoadBalancerCommandInput = DeleteLoadBalancerInput; export type DeleteLoadBalancerCommandOutput = DeleteLoadBalancerOutput & __MetadataBearer; +/** + *

Deletes the specified Application Load Balancer, Network Load Balancer, or Gateway Load + * Balancer. Deleting a load balancer also deletes its listeners.

+ *

You can't delete a load balancer if deletion protection is enabled. If the load + * balancer does not exist or has already been deleted, the call succeeds.

+ *

Deleting a load balancer does not affect its registered targets. For example, your EC2 + * instances continue to run and are still registered to their target groups. If you no longer + * need these EC2 instances, you can stop or terminate them.

+ */ export class DeleteLoadBalancerCommand extends $Command< DeleteLoadBalancerCommandInput, DeleteLoadBalancerCommandOutput, @@ -38,6 +47,9 @@ export class DeleteLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DeleteRuleCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DeleteRuleCommand.ts index 0f1dfceffc255..ff4428690e986 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DeleteRuleCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DeleteRuleCommand.ts @@ -21,6 +21,10 @@ import { export type DeleteRuleCommandInput = DeleteRuleInput; export type DeleteRuleCommandOutput = DeleteRuleOutput & __MetadataBearer; +/** + *

Deletes the specified rule.

+ *

You can't delete the default rule.

+ */ export class DeleteRuleCommand extends $Command< DeleteRuleCommandInput, DeleteRuleCommandOutput, @@ -35,6 +39,9 @@ export class DeleteRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DeleteTargetGroupCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DeleteTargetGroupCommand.ts index 02146cb4072f3..d44b3c684b6e1 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DeleteTargetGroupCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DeleteTargetGroupCommand.ts @@ -24,6 +24,13 @@ import { export type DeleteTargetGroupCommandInput = DeleteTargetGroupInput; export type DeleteTargetGroupCommandOutput = DeleteTargetGroupOutput & __MetadataBearer; +/** + *

Deletes the specified target group.

+ *

You can delete a target group if it is not referenced by any actions. Deleting a target + * group also deletes any associated health checks. Deleting a target group does not affect its + * registered targets. For example, any EC2 instances continue to run until you stop or terminate + * them.

+ */ export class DeleteTargetGroupCommand extends $Command< DeleteTargetGroupCommandInput, DeleteTargetGroupCommandOutput, @@ -38,6 +45,9 @@ export class DeleteTargetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DeregisterTargetsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DeregisterTargetsCommand.ts index 911e6ff23f598..136e91029387e 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DeregisterTargetsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DeregisterTargetsCommand.ts @@ -24,6 +24,10 @@ import { export type DeregisterTargetsCommandInput = DeregisterTargetsInput; export type DeregisterTargetsCommandOutput = DeregisterTargetsOutput & __MetadataBearer; +/** + *

Deregisters the specified targets from the specified target group. After the targets + * are deregistered, they no longer receive traffic from the load balancer.

+ */ export class DeregisterTargetsCommand extends $Command< DeregisterTargetsCommandInput, DeregisterTargetsCommandOutput, @@ -38,6 +42,9 @@ export class DeregisterTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeAccountLimitsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeAccountLimitsCommand.ts index ba5511bc8167e..baad3a6cdba0f 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeAccountLimitsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeAccountLimitsCommand.ts @@ -24,6 +24,27 @@ import { export type DescribeAccountLimitsCommandInput = DescribeAccountLimitsInput; export type DescribeAccountLimitsCommandOutput = DescribeAccountLimitsOutput & __MetadataBearer; +/** + *

Describes the current Elastic Load Balancing resource limits for your AWS account.

+ *

For more information, see the following:

+ * + */ export class DescribeAccountLimitsCommand extends $Command< DescribeAccountLimitsCommandInput, DescribeAccountLimitsCommandOutput, @@ -38,6 +59,9 @@ export class DescribeAccountLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeListenerCertificatesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeListenerCertificatesCommand.ts index 1f51166b9d2bb..87550f8ce8492 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeListenerCertificatesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeListenerCertificatesCommand.ts @@ -24,6 +24,13 @@ import { export type DescribeListenerCertificatesCommandInput = DescribeListenerCertificatesInput; export type DescribeListenerCertificatesCommandOutput = DescribeListenerCertificatesOutput & __MetadataBearer; +/** + *

Describes the default certificate and the certificate list for the specified HTTPS or TLS listener.

+ *

If the default certificate is also in the certificate list, it appears twice in the results + * (once with IsDefault set to true and once with IsDefault set to false).

+ *

For more information, see SSL certificates in the Application Load Balancers Guide or + * Server certificates in the Network Load Balancers Guide.

+ */ export class DescribeListenerCertificatesCommand extends $Command< DescribeListenerCertificatesCommandInput, DescribeListenerCertificatesCommandOutput, @@ -38,6 +45,9 @@ export class DescribeListenerCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeListenersCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeListenersCommand.ts index 4f12152dc5865..aceabe721cb5c 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeListenersCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeListenersCommand.ts @@ -24,6 +24,11 @@ import { export type DescribeListenersCommandInput = DescribeListenersInput; export type DescribeListenersCommandOutput = DescribeListenersOutput & __MetadataBearer; +/** + *

Describes the specified listeners or the listeners for the specified Application Load + * Balancer, Network Load Balancer, or Gateway Load Balancer. You must specify either a load + * balancer or one or more listeners.

+ */ export class DescribeListenersCommand extends $Command< DescribeListenersCommandInput, DescribeListenersCommandOutput, @@ -38,6 +43,9 @@ export class DescribeListenersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeLoadBalancerAttributesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeLoadBalancerAttributesCommand.ts index bad3c98513451..fba95d1fbd335 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeLoadBalancerAttributesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeLoadBalancerAttributesCommand.ts @@ -24,6 +24,29 @@ import { export type DescribeLoadBalancerAttributesCommandInput = DescribeLoadBalancerAttributesInput; export type DescribeLoadBalancerAttributesCommandOutput = DescribeLoadBalancerAttributesOutput & __MetadataBearer; +/** + *

Describes the attributes for the specified Application Load Balancer, Network Load Balancer, + * or Gateway Load Balancer.

+ * + *

For more information, see the following:

+ * + */ export class DescribeLoadBalancerAttributesCommand extends $Command< DescribeLoadBalancerAttributesCommandInput, DescribeLoadBalancerAttributesCommandOutput, @@ -38,6 +61,9 @@ export class DescribeLoadBalancerAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeLoadBalancersCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeLoadBalancersCommand.ts index 4728c14c6dc88..a1e0c82c2f312 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeLoadBalancersCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeLoadBalancersCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeLoadBalancersCommandInput = DescribeLoadBalancersInput; export type DescribeLoadBalancersCommandOutput = DescribeLoadBalancersOutput & __MetadataBearer; +/** + *

Describes the specified load balancers or all of your load balancers.

+ */ export class DescribeLoadBalancersCommand extends $Command< DescribeLoadBalancersCommandInput, DescribeLoadBalancersCommandOutput, @@ -38,6 +41,9 @@ export class DescribeLoadBalancersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeRulesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeRulesCommand.ts index dab83d37e0eb8..e3bbab6688bdf 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeRulesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeRulesCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeRulesCommandInput = DescribeRulesInput; export type DescribeRulesCommandOutput = DescribeRulesOutput & __MetadataBearer; +/** + *

Describes the specified rules or the rules for the specified listener. You must specify + * either a listener or one or more rules.

+ */ export class DescribeRulesCommand extends $Command< DescribeRulesCommandInput, DescribeRulesCommandOutput, @@ -38,6 +42,9 @@ export class DescribeRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeSSLPoliciesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeSSLPoliciesCommand.ts index 894108aec76dc..d0cc97f165001 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeSSLPoliciesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeSSLPoliciesCommand.ts @@ -24,6 +24,11 @@ import { export type DescribeSSLPoliciesCommandInput = DescribeSSLPoliciesInput; export type DescribeSSLPoliciesCommandOutput = DescribeSSLPoliciesOutput & __MetadataBearer; +/** + *

Describes the specified policies or all policies used for SSL negotiation.

+ *

For more information, see Security policies in the Application Load Balancers Guide or + * Security policies in the Network Load Balancers Guide.

+ */ export class DescribeSSLPoliciesCommand extends $Command< DescribeSSLPoliciesCommandInput, DescribeSSLPoliciesCommandOutput, @@ -38,6 +43,9 @@ export class DescribeSSLPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeTagsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeTagsCommand.ts index 20b5a1a80dc55..531787ce25be7 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeTagsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeTagsCommand.ts @@ -21,6 +21,11 @@ import { export type DescribeTagsCommandInput = DescribeTagsInput; export type DescribeTagsCommandOutput = DescribeTagsOutput & __MetadataBearer; +/** + *

Describes the tags for the specified Elastic Load Balancing resources. You can describe + * the tags for one or more Application Load Balancers, Network Load Balancers, Gateway Load + * Balancers, target groups, listeners, or rules.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -35,6 +40,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeTargetGroupAttributesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeTargetGroupAttributesCommand.ts index 1b2b3adff5ec1..5597abd178fd3 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeTargetGroupAttributesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeTargetGroupAttributesCommand.ts @@ -24,6 +24,27 @@ import { export type DescribeTargetGroupAttributesCommandInput = DescribeTargetGroupAttributesInput; export type DescribeTargetGroupAttributesCommandOutput = DescribeTargetGroupAttributesOutput & __MetadataBearer; +/** + *

Describes the attributes for the specified target group.

+ *

For more information, see the following:

+ * + */ export class DescribeTargetGroupAttributesCommand extends $Command< DescribeTargetGroupAttributesCommandInput, DescribeTargetGroupAttributesCommandOutput, @@ -38,6 +59,9 @@ export class DescribeTargetGroupAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeTargetGroupsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeTargetGroupsCommand.ts index dad8c3d76bf7c..534923d52dde7 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeTargetGroupsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeTargetGroupsCommand.ts @@ -24,6 +24,12 @@ import { export type DescribeTargetGroupsCommandInput = DescribeTargetGroupsInput; export type DescribeTargetGroupsCommandOutput = DescribeTargetGroupsOutput & __MetadataBearer; +/** + *

Describes the specified target groups or all of your target groups. By default, all + * target groups are described. Alternatively, you can specify one of the following to filter the + * results: the ARN of the load balancer, the names of one or more target groups, or the ARNs of + * one or more target groups.

+ */ export class DescribeTargetGroupsCommand extends $Command< DescribeTargetGroupsCommandInput, DescribeTargetGroupsCommandOutput, @@ -38,6 +44,9 @@ export class DescribeTargetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/DescribeTargetHealthCommand.ts b/clients/client-elastic-load-balancing-v2/commands/DescribeTargetHealthCommand.ts index 848f14cb364d6..b5f17d6c07ba4 100644 --- a/clients/client-elastic-load-balancing-v2/commands/DescribeTargetHealthCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/DescribeTargetHealthCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeTargetHealthCommandInput = DescribeTargetHealthInput; export type DescribeTargetHealthCommandOutput = DescribeTargetHealthOutput & __MetadataBearer; +/** + *

Describes the health of the specified targets or all of your targets.

+ */ export class DescribeTargetHealthCommand extends $Command< DescribeTargetHealthCommandInput, DescribeTargetHealthCommandOutput, @@ -38,6 +41,9 @@ export class DescribeTargetHealthCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/ModifyListenerCommand.ts b/clients/client-elastic-load-balancing-v2/commands/ModifyListenerCommand.ts index 53a30fde51c85..d6ff16b413844 100644 --- a/clients/client-elastic-load-balancing-v2/commands/ModifyListenerCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/ModifyListenerCommand.ts @@ -24,6 +24,16 @@ import { export type ModifyListenerCommandInput = ModifyListenerInput; export type ModifyListenerCommandOutput = ModifyListenerOutput & __MetadataBearer; +/** + *

Replaces the specified properties of the specified listener. Any properties that you do not + * specify remain unchanged.

+ *

Changing the protocol from HTTPS to HTTP, or from TLS to TCP, removes the security policy + * and default certificate properties. If you change the protocol from HTTP to HTTPS, or from + * TCP to TLS, you must add the security policy and default certificate properties.

+ *

To add an item to a list, remove an item from a list, or update an item in a list, + * you must provide the entire list. For example, to add an action, specify a list with the + * current actions plus the new action.

+ */ export class ModifyListenerCommand extends $Command< ModifyListenerCommandInput, ModifyListenerCommandOutput, @@ -38,6 +48,9 @@ export class ModifyListenerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/ModifyLoadBalancerAttributesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/ModifyLoadBalancerAttributesCommand.ts index 08a4bbb5a8e91..edff999c28170 100644 --- a/clients/client-elastic-load-balancing-v2/commands/ModifyLoadBalancerAttributesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/ModifyLoadBalancerAttributesCommand.ts @@ -24,6 +24,12 @@ import { export type ModifyLoadBalancerAttributesCommandInput = ModifyLoadBalancerAttributesInput; export type ModifyLoadBalancerAttributesCommandOutput = ModifyLoadBalancerAttributesOutput & __MetadataBearer; +/** + *

Modifies the specified attributes of the specified Application Load Balancer, Network Load + * Balancer, or Gateway Load Balancer.

+ *

If any of the specified attributes can't be modified as requested, the call fails. Any + * existing attributes that you do not modify retain their current values.

+ */ export class ModifyLoadBalancerAttributesCommand extends $Command< ModifyLoadBalancerAttributesCommandInput, ModifyLoadBalancerAttributesCommandOutput, @@ -38,6 +44,9 @@ export class ModifyLoadBalancerAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/ModifyRuleCommand.ts b/clients/client-elastic-load-balancing-v2/commands/ModifyRuleCommand.ts index 4d97fb73c31c9..3a6b62911c9be 100644 --- a/clients/client-elastic-load-balancing-v2/commands/ModifyRuleCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/ModifyRuleCommand.ts @@ -21,6 +21,13 @@ import { export type ModifyRuleCommandInput = ModifyRuleInput; export type ModifyRuleCommandOutput = ModifyRuleOutput & __MetadataBearer; +/** + *

Replaces the specified properties of the specified rule. Any properties that you do not + * specify are unchanged.

+ *

To add an item to a list, remove an item from a list, or update an item in a list, + * you must provide the entire list. For example, to add an action, specify a list with the + * current actions plus the new action.

+ */ export class ModifyRuleCommand extends $Command< ModifyRuleCommandInput, ModifyRuleCommandOutput, @@ -35,6 +42,9 @@ export class ModifyRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/ModifyTargetGroupAttributesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/ModifyTargetGroupAttributesCommand.ts index 9f94b7ac344f6..71084499d0102 100644 --- a/clients/client-elastic-load-balancing-v2/commands/ModifyTargetGroupAttributesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/ModifyTargetGroupAttributesCommand.ts @@ -24,6 +24,9 @@ import { export type ModifyTargetGroupAttributesCommandInput = ModifyTargetGroupAttributesInput; export type ModifyTargetGroupAttributesCommandOutput = ModifyTargetGroupAttributesOutput & __MetadataBearer; +/** + *

Modifies the specified attributes of the specified target group.

+ */ export class ModifyTargetGroupAttributesCommand extends $Command< ModifyTargetGroupAttributesCommandInput, ModifyTargetGroupAttributesCommandOutput, @@ -38,6 +41,9 @@ export class ModifyTargetGroupAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/ModifyTargetGroupCommand.ts b/clients/client-elastic-load-balancing-v2/commands/ModifyTargetGroupCommand.ts index 184e82ba4bb2c..ef203584d4b3f 100644 --- a/clients/client-elastic-load-balancing-v2/commands/ModifyTargetGroupCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/ModifyTargetGroupCommand.ts @@ -24,6 +24,10 @@ import { export type ModifyTargetGroupCommandInput = ModifyTargetGroupInput; export type ModifyTargetGroupCommandOutput = ModifyTargetGroupOutput & __MetadataBearer; +/** + *

Modifies the health checks used when evaluating the health state of the targets in the + * specified target group.

+ */ export class ModifyTargetGroupCommand extends $Command< ModifyTargetGroupCommandInput, ModifyTargetGroupCommandOutput, @@ -38,6 +42,9 @@ export class ModifyTargetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/RegisterTargetsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/RegisterTargetsCommand.ts index 65423ab36c3c3..53738970858b4 100644 --- a/clients/client-elastic-load-balancing-v2/commands/RegisterTargetsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/RegisterTargetsCommand.ts @@ -24,6 +24,20 @@ import { export type RegisterTargetsCommandInput = RegisterTargetsInput; export type RegisterTargetsCommandOutput = RegisterTargetsOutput & __MetadataBearer; +/** + *

Registers the specified targets with the specified target group.

+ * + *

If the target is an EC2 instance, it must be in the running state when you register it.

+ * + *

By default, the load balancer routes requests to registered targets using the protocol + * and port for the target group. Alternatively, you can override the port for a target when you + * register it. You can register each EC2 instance or IP address with the same target group + * multiple times using different ports.

+ * + *

With a Network Load Balancer, you cannot register instances by instance ID if they have + * the following instance types: C1, CC1, CC2, CG1, CG2, CR1, CS1, G1, G2, HI1, HS1, M1, M2, M3, + * and T1. You can register instances of these types by IP address.

+ */ export class RegisterTargetsCommand extends $Command< RegisterTargetsCommandInput, RegisterTargetsCommandOutput, @@ -38,6 +52,9 @@ export class RegisterTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/RemoveListenerCertificatesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/RemoveListenerCertificatesCommand.ts index e5b7c36ba4e9a..ae4d05a0687a3 100644 --- a/clients/client-elastic-load-balancing-v2/commands/RemoveListenerCertificatesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/RemoveListenerCertificatesCommand.ts @@ -24,6 +24,9 @@ import { export type RemoveListenerCertificatesCommandInput = RemoveListenerCertificatesInput; export type RemoveListenerCertificatesCommandOutput = RemoveListenerCertificatesOutput & __MetadataBearer; +/** + *

Removes the specified certificate from the certificate list for the specified HTTPS or TLS listener.

+ */ export class RemoveListenerCertificatesCommand extends $Command< RemoveListenerCertificatesCommandInput, RemoveListenerCertificatesCommandOutput, @@ -38,6 +41,9 @@ export class RemoveListenerCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/RemoveTagsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/RemoveTagsCommand.ts index 18c9aaf5caf20..30804fc84c4fe 100644 --- a/clients/client-elastic-load-balancing-v2/commands/RemoveTagsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/RemoveTagsCommand.ts @@ -21,6 +21,11 @@ import { export type RemoveTagsCommandInput = RemoveTagsInput; export type RemoveTagsCommandOutput = RemoveTagsOutput & __MetadataBearer; +/** + *

Removes the specified tags from the specified Elastic Load Balancing resources. You can + * remove the tags for one or more Application Load Balancers, Network Load Balancers, Gateway + * Load Balancers, target groups, listeners, or rules.

+ */ export class RemoveTagsCommand extends $Command< RemoveTagsCommandInput, RemoveTagsCommandOutput, @@ -35,6 +40,9 @@ export class RemoveTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/SetIpAddressTypeCommand.ts b/clients/client-elastic-load-balancing-v2/commands/SetIpAddressTypeCommand.ts index fc4e57ac9b59d..3cdadc9a1f9d9 100644 --- a/clients/client-elastic-load-balancing-v2/commands/SetIpAddressTypeCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/SetIpAddressTypeCommand.ts @@ -24,6 +24,10 @@ import { export type SetIpAddressTypeCommandInput = SetIpAddressTypeInput; export type SetIpAddressTypeCommandOutput = SetIpAddressTypeOutput & __MetadataBearer; +/** + *

Sets the type of IP addresses used by the subnets of the specified Application Load + * Balancer or Network Load Balancer.

+ */ export class SetIpAddressTypeCommand extends $Command< SetIpAddressTypeCommandInput, SetIpAddressTypeCommandOutput, @@ -38,6 +42,9 @@ export class SetIpAddressTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/SetRulePrioritiesCommand.ts b/clients/client-elastic-load-balancing-v2/commands/SetRulePrioritiesCommand.ts index a1b0e55056e64..0163b78f95e11 100644 --- a/clients/client-elastic-load-balancing-v2/commands/SetRulePrioritiesCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/SetRulePrioritiesCommand.ts @@ -24,6 +24,11 @@ import { export type SetRulePrioritiesCommandInput = SetRulePrioritiesInput; export type SetRulePrioritiesCommandOutput = SetRulePrioritiesOutput & __MetadataBearer; +/** + *

Sets the priorities of the specified rules.

+ *

You can reorder the rules as long as there are no priority conflicts in the new order. + * Any existing rules that you do not specify retain their current priority.

+ */ export class SetRulePrioritiesCommand extends $Command< SetRulePrioritiesCommandInput, SetRulePrioritiesCommandOutput, @@ -38,6 +43,9 @@ export class SetRulePrioritiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/SetSecurityGroupsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/SetSecurityGroupsCommand.ts index 43cc24c24fe95..68a437a4c2b9a 100644 --- a/clients/client-elastic-load-balancing-v2/commands/SetSecurityGroupsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/SetSecurityGroupsCommand.ts @@ -24,6 +24,12 @@ import { export type SetSecurityGroupsCommandInput = SetSecurityGroupsInput; export type SetSecurityGroupsCommandOutput = SetSecurityGroupsOutput & __MetadataBearer; +/** + *

Associates the specified security groups with the specified Application Load Balancer. + * The specified security groups override the previously associated security groups.

+ *

You can't specify a security group for a Network Load Balancer or Gateway Load + * Balancer.

+ */ export class SetSecurityGroupsCommand extends $Command< SetSecurityGroupsCommandInput, SetSecurityGroupsCommandOutput, @@ -38,6 +44,9 @@ export class SetSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/commands/SetSubnetsCommand.ts b/clients/client-elastic-load-balancing-v2/commands/SetSubnetsCommand.ts index a2f50585b40d6..f4411455ce4d7 100644 --- a/clients/client-elastic-load-balancing-v2/commands/SetSubnetsCommand.ts +++ b/clients/client-elastic-load-balancing-v2/commands/SetSubnetsCommand.ts @@ -21,6 +21,14 @@ import { export type SetSubnetsCommandInput = SetSubnetsInput; export type SetSubnetsCommandOutput = SetSubnetsOutput & __MetadataBearer; +/** + *

Enables the Availability Zones for the specified public subnets for the specified + * Application Load Balancer or Network Load Balancer. The specified subnets replace the + * previously enabled subnets.

+ *

When you specify subnets for a Network Load Balancer, you must include all + * subnets that were enabled previously, with their existing configurations, plus any + * additional subnets.

+ */ export class SetSubnetsCommand extends $Command< SetSubnetsCommandInput, SetSubnetsCommandOutput, @@ -35,6 +43,9 @@ export class SetSubnetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingV2ClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing-v2/package.json b/clients/client-elastic-load-balancing-v2/package.json index d7d06e9b5743f..51e5f72e9b37e 100644 --- a/clients/client-elastic-load-balancing-v2/package.json +++ b/clients/client-elastic-load-balancing-v2/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Elastic Load Balancing V2 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-elastic-load-balancing-v2/pagination/DescribeListenersPaginator.ts b/clients/client-elastic-load-balancing-v2/pagination/DescribeListenersPaginator.ts index 5353fd896fd79..fab76e9033bd6 100644 --- a/clients/client-elastic-load-balancing-v2/pagination/DescribeListenersPaginator.ts +++ b/clients/client-elastic-load-balancing-v2/pagination/DescribeListenersPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticLoadBalancingV2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticLoadBalancingV2Client, input: DescribeListenersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeListenersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticLoadBalancingV2, input: DescribeListenersCommandInput, diff --git a/clients/client-elastic-load-balancing-v2/pagination/DescribeLoadBalancersPaginator.ts b/clients/client-elastic-load-balancing-v2/pagination/DescribeLoadBalancersPaginator.ts index 4ec75612be675..cec53d186374c 100644 --- a/clients/client-elastic-load-balancing-v2/pagination/DescribeLoadBalancersPaginator.ts +++ b/clients/client-elastic-load-balancing-v2/pagination/DescribeLoadBalancersPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticLoadBalancingV2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticLoadBalancingV2Client, input: DescribeLoadBalancersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLoadBalancersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticLoadBalancingV2, input: DescribeLoadBalancersCommandInput, diff --git a/clients/client-elastic-load-balancing-v2/pagination/DescribeTargetGroupsPaginator.ts b/clients/client-elastic-load-balancing-v2/pagination/DescribeTargetGroupsPaginator.ts index f0ebd584686dc..b65cf88d149c1 100644 --- a/clients/client-elastic-load-balancing-v2/pagination/DescribeTargetGroupsPaginator.ts +++ b/clients/client-elastic-load-balancing-v2/pagination/DescribeTargetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticLoadBalancingV2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticLoadBalancingV2Client, input: DescribeTargetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTargetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticLoadBalancingV2, input: DescribeTargetGroupsCommandInput, diff --git a/clients/client-elastic-load-balancing-v2/runtimeConfig.browser.ts b/clients/client-elastic-load-balancing-v2/runtimeConfig.browser.ts index 9325f73b62b56..fc983a0be958f 100644 --- a/clients/client-elastic-load-balancing-v2/runtimeConfig.browser.ts +++ b/clients/client-elastic-load-balancing-v2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ElasticLoadBalancingV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-elastic-load-balancing-v2/runtimeConfig.native.ts b/clients/client-elastic-load-balancing-v2/runtimeConfig.native.ts index 99473d7cbc2c3..d52871de013ab 100644 --- a/clients/client-elastic-load-balancing-v2/runtimeConfig.native.ts +++ b/clients/client-elastic-load-balancing-v2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ElasticLoadBalancingV2Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-elastic-load-balancing-v2/runtimeConfig.shared.ts b/clients/client-elastic-load-balancing-v2/runtimeConfig.shared.ts index d73c6110e698b..ce2e8b36b3518 100644 --- a/clients/client-elastic-load-balancing-v2/runtimeConfig.shared.ts +++ b/clients/client-elastic-load-balancing-v2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-12-01", disableHostPrefix: false, diff --git a/clients/client-elastic-load-balancing-v2/runtimeConfig.ts b/clients/client-elastic-load-balancing-v2/runtimeConfig.ts index 47d2f68cf72eb..c3a2a71bef9a3 100644 --- a/clients/client-elastic-load-balancing-v2/runtimeConfig.ts +++ b/clients/client-elastic-load-balancing-v2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ElasticLoadBalancingV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-elastic-load-balancing-v2/tsconfig.json b/clients/client-elastic-load-balancing-v2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-elastic-load-balancing-v2/tsconfig.json +++ b/clients/client-elastic-load-balancing-v2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-elastic-load-balancing/commands/AddTagsCommand.ts b/clients/client-elastic-load-balancing/commands/AddTagsCommand.ts index 7da728a472f6e..0dffe1b11ca98 100644 --- a/clients/client-elastic-load-balancing/commands/AddTagsCommand.ts +++ b/clients/client-elastic-load-balancing/commands/AddTagsCommand.ts @@ -21,6 +21,15 @@ import { export type AddTagsCommandInput = AddTagsInput; export type AddTagsCommandOutput = AddTagsOutput & __MetadataBearer; +/** + *

Adds the specified tags to the specified load balancer. Each load balancer can have a maximum of 10 tags.

+ * + *

Each tag consists of a key and an optional value. If a tag with the same key is already associated + * with the load balancer, AddTags updates its value.

+ * + *

For more information, see Tag Your Classic Load Balancer + * in the Classic Load Balancers Guide.

+ */ export class AddTagsCommand extends $Command< AddTagsCommandInput, AddTagsCommandOutput, @@ -35,6 +44,9 @@ export class AddTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/ApplySecurityGroupsToLoadBalancerCommand.ts b/clients/client-elastic-load-balancing/commands/ApplySecurityGroupsToLoadBalancerCommand.ts index 94490f6c61f66..3408d2513ffe5 100644 --- a/clients/client-elastic-load-balancing/commands/ApplySecurityGroupsToLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/ApplySecurityGroupsToLoadBalancerCommand.ts @@ -24,6 +24,11 @@ import { export type ApplySecurityGroupsToLoadBalancerCommandInput = ApplySecurityGroupsToLoadBalancerInput; export type ApplySecurityGroupsToLoadBalancerCommandOutput = ApplySecurityGroupsToLoadBalancerOutput & __MetadataBearer; +/** + *

Associates one or more security groups with your load balancer in a virtual private cloud (VPC). The specified security groups override the previously associated security groups.

+ *

For more information, see Security Groups for Load Balancers in a VPC + * in the Classic Load Balancers Guide.

+ */ export class ApplySecurityGroupsToLoadBalancerCommand extends $Command< ApplySecurityGroupsToLoadBalancerCommandInput, ApplySecurityGroupsToLoadBalancerCommandOutput, @@ -38,6 +43,9 @@ export class ApplySecurityGroupsToLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/AttachLoadBalancerToSubnetsCommand.ts b/clients/client-elastic-load-balancing/commands/AttachLoadBalancerToSubnetsCommand.ts index 6ff0401c7196b..e81f29837784a 100644 --- a/clients/client-elastic-load-balancing/commands/AttachLoadBalancerToSubnetsCommand.ts +++ b/clients/client-elastic-load-balancing/commands/AttachLoadBalancerToSubnetsCommand.ts @@ -24,6 +24,12 @@ import { export type AttachLoadBalancerToSubnetsCommandInput = AttachLoadBalancerToSubnetsInput; export type AttachLoadBalancerToSubnetsCommandOutput = AttachLoadBalancerToSubnetsOutput & __MetadataBearer; +/** + *

Adds one or more subnets to the set of configured subnets for the specified load balancer.

+ *

The load balancer evenly distributes requests across all registered subnets. + * For more information, see Add or Remove Subnets for Your Load Balancer in a VPC + * in the Classic Load Balancers Guide.

+ */ export class AttachLoadBalancerToSubnetsCommand extends $Command< AttachLoadBalancerToSubnetsCommandInput, AttachLoadBalancerToSubnetsCommandOutput, @@ -38,6 +44,9 @@ export class AttachLoadBalancerToSubnetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/ConfigureHealthCheckCommand.ts b/clients/client-elastic-load-balancing/commands/ConfigureHealthCheckCommand.ts index dface20e6d4d3..2e0d553b9884b 100644 --- a/clients/client-elastic-load-balancing/commands/ConfigureHealthCheckCommand.ts +++ b/clients/client-elastic-load-balancing/commands/ConfigureHealthCheckCommand.ts @@ -24,6 +24,11 @@ import { export type ConfigureHealthCheckCommandInput = ConfigureHealthCheckInput; export type ConfigureHealthCheckCommandOutput = ConfigureHealthCheckOutput & __MetadataBearer; +/** + *

Specifies the health check settings to use when evaluating the health state of your EC2 instances.

+ *

For more information, see Configure Health Checks for Your Load Balancer + * in the Classic Load Balancers Guide.

+ */ export class ConfigureHealthCheckCommand extends $Command< ConfigureHealthCheckCommandInput, ConfigureHealthCheckCommandOutput, @@ -38,6 +43,9 @@ export class ConfigureHealthCheckCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/CreateAppCookieStickinessPolicyCommand.ts b/clients/client-elastic-load-balancing/commands/CreateAppCookieStickinessPolicyCommand.ts index 319db3c19844f..6b74511c9d186 100644 --- a/clients/client-elastic-load-balancing/commands/CreateAppCookieStickinessPolicyCommand.ts +++ b/clients/client-elastic-load-balancing/commands/CreateAppCookieStickinessPolicyCommand.ts @@ -24,6 +24,17 @@ import { export type CreateAppCookieStickinessPolicyCommandInput = CreateAppCookieStickinessPolicyInput; export type CreateAppCookieStickinessPolicyCommandOutput = CreateAppCookieStickinessPolicyOutput & __MetadataBearer; +/** + *

Generates a stickiness policy with sticky session lifetimes that follow that of an application-generated cookie. This policy can be associated only with HTTP/HTTPS listeners.

+ *

This policy is similar to the policy created by CreateLBCookieStickinessPolicy, + * except that the lifetime of the special Elastic Load Balancing cookie, AWSELB, + * follows the lifetime of the application-generated cookie specified in the policy configuration. + * The load balancer only inserts a new stickiness cookie when the application response + * includes a new application cookie.

+ *

If the application cookie is explicitly removed or expires, the session stops being sticky until a new application cookie is issued.

+ *

For more information, see Application-Controlled Session Stickiness + * in the Classic Load Balancers Guide.

+ */ export class CreateAppCookieStickinessPolicyCommand extends $Command< CreateAppCookieStickinessPolicyCommandInput, CreateAppCookieStickinessPolicyCommandOutput, @@ -38,6 +49,9 @@ export class CreateAppCookieStickinessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/CreateLBCookieStickinessPolicyCommand.ts b/clients/client-elastic-load-balancing/commands/CreateLBCookieStickinessPolicyCommand.ts index bdd1b1e3721b4..b089f879adfd1 100644 --- a/clients/client-elastic-load-balancing/commands/CreateLBCookieStickinessPolicyCommand.ts +++ b/clients/client-elastic-load-balancing/commands/CreateLBCookieStickinessPolicyCommand.ts @@ -24,6 +24,15 @@ import { export type CreateLBCookieStickinessPolicyCommandInput = CreateLBCookieStickinessPolicyInput; export type CreateLBCookieStickinessPolicyCommandOutput = CreateLBCookieStickinessPolicyOutput & __MetadataBearer; +/** + *

Generates a stickiness policy with sticky session lifetimes controlled by the lifetime of the browser (user-agent) or a specified expiration period. This policy can be associated only with HTTP/HTTPS listeners.

+ *

When a load balancer implements this policy, the load balancer uses a special cookie to track the instance for each request. When the load balancer receives a request, it first checks to see if this cookie is present in the request. + * If so, the load balancer sends the request to the application server specified in the cookie. If not, the load balancer sends the request to a server that is chosen based on the existing load-balancing algorithm.

+ *

A cookie is inserted into the response for binding subsequent requests from the same user to that server. The validity of the cookie is based on the cookie expiration time, which is specified in the policy configuration.

+ * + *

For more information, see Duration-Based Session Stickiness + * in the Classic Load Balancers Guide.

+ */ export class CreateLBCookieStickinessPolicyCommand extends $Command< CreateLBCookieStickinessPolicyCommandInput, CreateLBCookieStickinessPolicyCommandOutput, @@ -38,6 +47,9 @@ export class CreateLBCookieStickinessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/CreateLoadBalancerCommand.ts b/clients/client-elastic-load-balancing/commands/CreateLoadBalancerCommand.ts index 816e6be1f774b..97f2790ebf002 100644 --- a/clients/client-elastic-load-balancing/commands/CreateLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/CreateLoadBalancerCommand.ts @@ -24,6 +24,22 @@ import { export type CreateLoadBalancerCommandInput = CreateAccessPointInput; export type CreateLoadBalancerCommandOutput = CreateAccessPointOutput & __MetadataBearer; +/** + *

Creates a Classic Load Balancer.

+ * + *

You can add listeners, security groups, subnets, and tags when you create your load balancer, + * or you can add them later using CreateLoadBalancerListeners, + * ApplySecurityGroupsToLoadBalancer, AttachLoadBalancerToSubnets, + * and AddTags.

+ *

To describe your current load balancers, see DescribeLoadBalancers. + * When you are finished with a load balancer, you can delete it using + * DeleteLoadBalancer.

+ * + *

You can create up to 20 load balancers per region per account. + * You can request an increase for the number of load balancers for your account. + * For more information, see Limits for Your Classic Load Balancer + * in the Classic Load Balancers Guide.

+ */ export class CreateLoadBalancerCommand extends $Command< CreateLoadBalancerCommandInput, CreateLoadBalancerCommandOutput, @@ -38,6 +54,9 @@ export class CreateLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/CreateLoadBalancerListenersCommand.ts b/clients/client-elastic-load-balancing/commands/CreateLoadBalancerListenersCommand.ts index 124f78b542c00..bcd7c5904d233 100644 --- a/clients/client-elastic-load-balancing/commands/CreateLoadBalancerListenersCommand.ts +++ b/clients/client-elastic-load-balancing/commands/CreateLoadBalancerListenersCommand.ts @@ -24,6 +24,11 @@ import { export type CreateLoadBalancerListenersCommandInput = CreateLoadBalancerListenerInput; export type CreateLoadBalancerListenersCommandOutput = CreateLoadBalancerListenerOutput & __MetadataBearer; +/** + *

Creates one or more listeners for the specified load balancer. If a listener with the specified port does not already exist, it is created; otherwise, the properties of the new listener must match the properties of the existing listener.

+ *

For more information, see Listeners for Your Classic Load Balancer + * in the Classic Load Balancers Guide.

+ */ export class CreateLoadBalancerListenersCommand extends $Command< CreateLoadBalancerListenersCommandInput, CreateLoadBalancerListenersCommandOutput, @@ -38,6 +43,9 @@ export class CreateLoadBalancerListenersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/CreateLoadBalancerPolicyCommand.ts b/clients/client-elastic-load-balancing/commands/CreateLoadBalancerPolicyCommand.ts index a8549c1b67cfb..94118998278a6 100644 --- a/clients/client-elastic-load-balancing/commands/CreateLoadBalancerPolicyCommand.ts +++ b/clients/client-elastic-load-balancing/commands/CreateLoadBalancerPolicyCommand.ts @@ -24,6 +24,10 @@ import { export type CreateLoadBalancerPolicyCommandInput = CreateLoadBalancerPolicyInput; export type CreateLoadBalancerPolicyCommandOutput = CreateLoadBalancerPolicyOutput & __MetadataBearer; +/** + *

Creates a policy with the specified attributes for the specified load balancer.

+ *

Policies are settings that are saved for your load balancer and that can be applied to the listener or the application server, depending on the policy type.

+ */ export class CreateLoadBalancerPolicyCommand extends $Command< CreateLoadBalancerPolicyCommandInput, CreateLoadBalancerPolicyCommandOutput, @@ -38,6 +42,9 @@ export class CreateLoadBalancerPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerCommand.ts b/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerCommand.ts index 5f04dcb9b5112..edd28519ccffa 100644 --- a/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerCommand.ts @@ -24,6 +24,12 @@ import { export type DeleteLoadBalancerCommandInput = DeleteAccessPointInput; export type DeleteLoadBalancerCommandOutput = DeleteAccessPointOutput & __MetadataBearer; +/** + *

Deletes the specified load balancer.

+ *

If you are attempting to recreate a load balancer, you must reconfigure all settings. The DNS name associated with a deleted load balancer are no longer usable. The name and associated DNS record of the deleted load balancer no longer exist and traffic sent to any of its IP addresses is no longer delivered to your instances.

+ *

If the load balancer does not exist or has already been deleted, the call to + * DeleteLoadBalancer still succeeds.

+ */ export class DeleteLoadBalancerCommand extends $Command< DeleteLoadBalancerCommandInput, DeleteLoadBalancerCommandOutput, @@ -38,6 +44,9 @@ export class DeleteLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerListenersCommand.ts b/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerListenersCommand.ts index 278c5d5ddb293..9ed29a1bffd0d 100644 --- a/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerListenersCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerListenersCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteLoadBalancerListenersCommandInput = DeleteLoadBalancerListenerInput; export type DeleteLoadBalancerListenersCommandOutput = DeleteLoadBalancerListenerOutput & __MetadataBearer; +/** + *

Deletes the specified listeners from the specified load balancer.

+ */ export class DeleteLoadBalancerListenersCommand extends $Command< DeleteLoadBalancerListenersCommandInput, DeleteLoadBalancerListenersCommandOutput, @@ -38,6 +41,9 @@ export class DeleteLoadBalancerListenersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerPolicyCommand.ts b/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerPolicyCommand.ts index 250234be30a3f..436dccda053c7 100644 --- a/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerPolicyCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DeleteLoadBalancerPolicyCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteLoadBalancerPolicyCommandInput = DeleteLoadBalancerPolicyInput; export type DeleteLoadBalancerPolicyCommandOutput = DeleteLoadBalancerPolicyOutput & __MetadataBearer; +/** + *

Deletes the specified policy from the specified load balancer. This policy must not be enabled for any listeners.

+ */ export class DeleteLoadBalancerPolicyCommand extends $Command< DeleteLoadBalancerPolicyCommandInput, DeleteLoadBalancerPolicyCommandOutput, @@ -38,6 +41,9 @@ export class DeleteLoadBalancerPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DeregisterInstancesFromLoadBalancerCommand.ts b/clients/client-elastic-load-balancing/commands/DeregisterInstancesFromLoadBalancerCommand.ts index 9c616517f0f2c..42c1da6022042 100644 --- a/clients/client-elastic-load-balancing/commands/DeregisterInstancesFromLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DeregisterInstancesFromLoadBalancerCommand.ts @@ -24,6 +24,14 @@ import { export type DeregisterInstancesFromLoadBalancerCommandInput = DeregisterEndPointsInput; export type DeregisterInstancesFromLoadBalancerCommandOutput = DeregisterEndPointsOutput & __MetadataBearer; +/** + *

Deregisters the specified instances from the specified load balancer. After the instance is deregistered, it no longer receives traffic from the load balancer.

+ * + *

You can use DescribeLoadBalancers to verify that the instance is deregistered from the load balancer.

+ * + *

For more information, see Register or De-Register EC2 Instances + * in the Classic Load Balancers Guide.

+ */ export class DeregisterInstancesFromLoadBalancerCommand extends $Command< DeregisterInstancesFromLoadBalancerCommandInput, DeregisterInstancesFromLoadBalancerCommandOutput, @@ -38,6 +46,9 @@ export class DeregisterInstancesFromLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DescribeAccountLimitsCommand.ts b/clients/client-elastic-load-balancing/commands/DescribeAccountLimitsCommand.ts index a0055a7cf7afb..4901c21e3671c 100644 --- a/clients/client-elastic-load-balancing/commands/DescribeAccountLimitsCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DescribeAccountLimitsCommand.ts @@ -24,6 +24,11 @@ import { export type DescribeAccountLimitsCommandInput = DescribeAccountLimitsInput; export type DescribeAccountLimitsCommandOutput = DescribeAccountLimitsOutput & __MetadataBearer; +/** + *

Describes the current Elastic Load Balancing resource limits for your AWS account.

+ *

For more information, see Limits for Your Classic Load Balancer + * in the Classic Load Balancers Guide.

+ */ export class DescribeAccountLimitsCommand extends $Command< DescribeAccountLimitsCommandInput, DescribeAccountLimitsCommandOutput, @@ -38,6 +43,9 @@ export class DescribeAccountLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DescribeInstanceHealthCommand.ts b/clients/client-elastic-load-balancing/commands/DescribeInstanceHealthCommand.ts index 637c0973f1135..691c30e6add11 100644 --- a/clients/client-elastic-load-balancing/commands/DescribeInstanceHealthCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DescribeInstanceHealthCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeInstanceHealthCommandInput = DescribeEndPointStateInput; export type DescribeInstanceHealthCommandOutput = DescribeEndPointStateOutput & __MetadataBearer; +/** + *

Describes the state of the specified instances with respect to the specified load balancer. If no instances are specified, the call describes the state of all instances that are currently registered with the load balancer. If instances are specified, their state is returned even if they are no longer registered with the load balancer. The state of terminated instances is not returned.

+ */ export class DescribeInstanceHealthCommand extends $Command< DescribeInstanceHealthCommandInput, DescribeInstanceHealthCommandOutput, @@ -38,6 +41,9 @@ export class DescribeInstanceHealthCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerAttributesCommand.ts b/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerAttributesCommand.ts index ccb2268a45ab4..c1c318378bff3 100644 --- a/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerAttributesCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerAttributesCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeLoadBalancerAttributesCommandInput = DescribeLoadBalancerAttributesInput; export type DescribeLoadBalancerAttributesCommandOutput = DescribeLoadBalancerAttributesOutput & __MetadataBearer; +/** + *

Describes the attributes for the specified load balancer.

+ */ export class DescribeLoadBalancerAttributesCommand extends $Command< DescribeLoadBalancerAttributesCommandInput, DescribeLoadBalancerAttributesCommandOutput, @@ -38,6 +41,9 @@ export class DescribeLoadBalancerAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerPoliciesCommand.ts b/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerPoliciesCommand.ts index c183b8251f251..0663c3ddfa438 100644 --- a/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerPoliciesCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerPoliciesCommand.ts @@ -24,6 +24,13 @@ import { export type DescribeLoadBalancerPoliciesCommandInput = DescribeLoadBalancerPoliciesInput; export type DescribeLoadBalancerPoliciesCommandOutput = DescribeLoadBalancerPoliciesOutput & __MetadataBearer; +/** + *

Describes the specified policies.

+ *

If you specify a load balancer name, the action returns the descriptions of all policies created for the load balancer. + * If you specify a policy name associated with your load balancer, the action returns the description of that policy. + * If you don't specify a load balancer name, the action returns descriptions of the specified sample policies, or descriptions of all sample policies. + * The names of the sample policies have the ELBSample- prefix.

+ */ export class DescribeLoadBalancerPoliciesCommand extends $Command< DescribeLoadBalancerPoliciesCommandInput, DescribeLoadBalancerPoliciesCommandOutput, @@ -38,6 +45,9 @@ export class DescribeLoadBalancerPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerPolicyTypesCommand.ts b/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerPolicyTypesCommand.ts index 77e73f5fedf6d..f854a27c444aa 100644 --- a/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerPolicyTypesCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DescribeLoadBalancerPolicyTypesCommand.ts @@ -24,6 +24,16 @@ import { export type DescribeLoadBalancerPolicyTypesCommandInput = DescribeLoadBalancerPolicyTypesInput; export type DescribeLoadBalancerPolicyTypesCommandOutput = DescribeLoadBalancerPolicyTypesOutput & __MetadataBearer; +/** + *

Describes the specified load balancer policy types or all load balancer policy types.

+ *

The description of each type indicates how it can be used. For example, + * some policies can be used only with layer 7 listeners, + * some policies can be used only with layer 4 listeners, + * and some policies can be used only with your EC2 instances.

+ *

You can use CreateLoadBalancerPolicy to create a policy configuration for any of these policy types. + * Then, depending on the policy type, use either SetLoadBalancerPoliciesOfListener or + * SetLoadBalancerPoliciesForBackendServer to set the policy.

+ */ export class DescribeLoadBalancerPolicyTypesCommand extends $Command< DescribeLoadBalancerPolicyTypesCommandInput, DescribeLoadBalancerPolicyTypesCommandOutput, @@ -38,6 +48,9 @@ export class DescribeLoadBalancerPolicyTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DescribeLoadBalancersCommand.ts b/clients/client-elastic-load-balancing/commands/DescribeLoadBalancersCommand.ts index 718f28357a510..f2ad61e1936b5 100644 --- a/clients/client-elastic-load-balancing/commands/DescribeLoadBalancersCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DescribeLoadBalancersCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeLoadBalancersCommandInput = DescribeAccessPointsInput; export type DescribeLoadBalancersCommandOutput = DescribeAccessPointsOutput & __MetadataBearer; +/** + *

Describes the specified the load balancers. If no load balancers are specified, the call describes all of your load balancers.

+ */ export class DescribeLoadBalancersCommand extends $Command< DescribeLoadBalancersCommandInput, DescribeLoadBalancersCommandOutput, @@ -38,6 +41,9 @@ export class DescribeLoadBalancersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DescribeTagsCommand.ts b/clients/client-elastic-load-balancing/commands/DescribeTagsCommand.ts index 11d10e00ebd0b..48021918372f0 100644 --- a/clients/client-elastic-load-balancing/commands/DescribeTagsCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DescribeTagsCommand.ts @@ -21,6 +21,9 @@ import { export type DescribeTagsCommandInput = DescribeTagsInput; export type DescribeTagsCommandOutput = DescribeTagsOutput & __MetadataBearer; +/** + *

Describes the tags associated with the specified load balancers.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -35,6 +38,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DetachLoadBalancerFromSubnetsCommand.ts b/clients/client-elastic-load-balancing/commands/DetachLoadBalancerFromSubnetsCommand.ts index 41da51e52b6af..bd2bbe2cec913 100644 --- a/clients/client-elastic-load-balancing/commands/DetachLoadBalancerFromSubnetsCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DetachLoadBalancerFromSubnetsCommand.ts @@ -24,6 +24,12 @@ import { export type DetachLoadBalancerFromSubnetsCommandInput = DetachLoadBalancerFromSubnetsInput; export type DetachLoadBalancerFromSubnetsCommandOutput = DetachLoadBalancerFromSubnetsOutput & __MetadataBearer; +/** + *

Removes the specified subnets from the set of configured subnets for the load balancer.

+ *

After a subnet is removed, all EC2 instances registered with the load balancer + * in the removed subnet go into the OutOfService state. Then, + * the load balancer balances the traffic among the remaining routable subnets.

+ */ export class DetachLoadBalancerFromSubnetsCommand extends $Command< DetachLoadBalancerFromSubnetsCommandInput, DetachLoadBalancerFromSubnetsCommandOutput, @@ -38,6 +44,9 @@ export class DetachLoadBalancerFromSubnetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/DisableAvailabilityZonesForLoadBalancerCommand.ts b/clients/client-elastic-load-balancing/commands/DisableAvailabilityZonesForLoadBalancerCommand.ts index 4d50870c457e6..188ead993c264 100644 --- a/clients/client-elastic-load-balancing/commands/DisableAvailabilityZonesForLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/DisableAvailabilityZonesForLoadBalancerCommand.ts @@ -24,6 +24,17 @@ import { export type DisableAvailabilityZonesForLoadBalancerCommandInput = RemoveAvailabilityZonesInput; export type DisableAvailabilityZonesForLoadBalancerCommandOutput = RemoveAvailabilityZonesOutput & __MetadataBearer; +/** + *

Removes the specified Availability Zones from the set of Availability Zones for the specified load balancer + * in EC2-Classic or a default VPC.

+ *

For load balancers in a non-default VPC, use DetachLoadBalancerFromSubnets.

+ *

There must be at least one Availability Zone registered with a load balancer at all times. + * After an Availability Zone is removed, all instances registered with the load balancer that are in the removed + * Availability Zone go into the OutOfService state. Then, the load balancer attempts to equally balance + * the traffic among its remaining Availability Zones.

+ *

For more information, see Add or Remove Availability Zones + * in the Classic Load Balancers Guide.

+ */ export class DisableAvailabilityZonesForLoadBalancerCommand extends $Command< DisableAvailabilityZonesForLoadBalancerCommandInput, DisableAvailabilityZonesForLoadBalancerCommandOutput, @@ -38,6 +49,9 @@ export class DisableAvailabilityZonesForLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/EnableAvailabilityZonesForLoadBalancerCommand.ts b/clients/client-elastic-load-balancing/commands/EnableAvailabilityZonesForLoadBalancerCommand.ts index 584be3cb70d34..f7a61513920aa 100644 --- a/clients/client-elastic-load-balancing/commands/EnableAvailabilityZonesForLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/EnableAvailabilityZonesForLoadBalancerCommand.ts @@ -24,6 +24,14 @@ import { export type EnableAvailabilityZonesForLoadBalancerCommandInput = AddAvailabilityZonesInput; export type EnableAvailabilityZonesForLoadBalancerCommandOutput = AddAvailabilityZonesOutput & __MetadataBearer; +/** + *

Adds the specified Availability Zones to the set of Availability Zones for the specified load balancer + * in EC2-Classic or a default VPC.

+ *

For load balancers in a non-default VPC, use AttachLoadBalancerToSubnets.

+ *

The load balancer evenly distributes requests across all its registered Availability Zones + * that contain instances. For more information, see Add or Remove Availability Zones + * in the Classic Load Balancers Guide.

+ */ export class EnableAvailabilityZonesForLoadBalancerCommand extends $Command< EnableAvailabilityZonesForLoadBalancerCommandInput, EnableAvailabilityZonesForLoadBalancerCommandOutput, @@ -38,6 +46,9 @@ export class EnableAvailabilityZonesForLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/ModifyLoadBalancerAttributesCommand.ts b/clients/client-elastic-load-balancing/commands/ModifyLoadBalancerAttributesCommand.ts index 7d04b67b0fea9..7525902eda616 100644 --- a/clients/client-elastic-load-balancing/commands/ModifyLoadBalancerAttributesCommand.ts +++ b/clients/client-elastic-load-balancing/commands/ModifyLoadBalancerAttributesCommand.ts @@ -24,6 +24,35 @@ import { export type ModifyLoadBalancerAttributesCommandInput = ModifyLoadBalancerAttributesInput; export type ModifyLoadBalancerAttributesCommandOutput = ModifyLoadBalancerAttributesOutput & __MetadataBearer; +/** + *

Modifies the attributes of the specified load balancer.

+ *

You can modify the load balancer attributes, such as AccessLogs, ConnectionDraining, and + * CrossZoneLoadBalancing by either enabling or disabling them. Or, you can modify the load balancer attribute + * ConnectionSettings by specifying an idle connection timeout value for your load balancer.

+ *

For more information, see the following in the Classic Load Balancers Guide:

+ * + */ export class ModifyLoadBalancerAttributesCommand extends $Command< ModifyLoadBalancerAttributesCommandInput, ModifyLoadBalancerAttributesCommandOutput, @@ -38,6 +67,9 @@ export class ModifyLoadBalancerAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/RegisterInstancesWithLoadBalancerCommand.ts b/clients/client-elastic-load-balancing/commands/RegisterInstancesWithLoadBalancerCommand.ts index 92b828d07bb2e..db28ad93eb167 100644 --- a/clients/client-elastic-load-balancing/commands/RegisterInstancesWithLoadBalancerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/RegisterInstancesWithLoadBalancerCommand.ts @@ -24,6 +24,27 @@ import { export type RegisterInstancesWithLoadBalancerCommandInput = RegisterEndPointsInput; export type RegisterInstancesWithLoadBalancerCommandOutput = RegisterEndPointsOutput & __MetadataBearer; +/** + *

Adds the specified instances to the specified load balancer.

+ * + *

The instance must be a running instance in the same network as the load balancer (EC2-Classic or the same VPC). If you have EC2-Classic instances and a load balancer in a VPC with ClassicLink enabled, you can link the EC2-Classic instances to that VPC and then register the linked EC2-Classic instances with the load balancer in the VPC.

+ * + *

Note that RegisterInstanceWithLoadBalancer completes when the request has been registered. + * Instance registration takes a little time to complete. To check the state of the registered instances, use + * DescribeLoadBalancers or DescribeInstanceHealth.

+ * + *

After the instance is registered, it starts receiving traffic + * and requests from the load balancer. Any instance that is not + * in one of the Availability Zones registered for the load balancer + * is moved to the OutOfService state. If an Availability Zone + * is added to the load balancer later, any instances registered with the + * load balancer move to the InService state.

+ * + *

To deregister instances from a load balancer, use DeregisterInstancesFromLoadBalancer.

+ * + *

For more information, see Register or De-Register EC2 Instances + * in the Classic Load Balancers Guide.

+ */ export class RegisterInstancesWithLoadBalancerCommand extends $Command< RegisterInstancesWithLoadBalancerCommandInput, RegisterInstancesWithLoadBalancerCommandOutput, @@ -38,6 +59,9 @@ export class RegisterInstancesWithLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/RemoveTagsCommand.ts b/clients/client-elastic-load-balancing/commands/RemoveTagsCommand.ts index 48309268c9a55..55f0dc13242b5 100644 --- a/clients/client-elastic-load-balancing/commands/RemoveTagsCommand.ts +++ b/clients/client-elastic-load-balancing/commands/RemoveTagsCommand.ts @@ -21,6 +21,9 @@ import { export type RemoveTagsCommandInput = RemoveTagsInput; export type RemoveTagsCommandOutput = RemoveTagsOutput & __MetadataBearer; +/** + *

Removes one or more tags from the specified load balancer.

+ */ export class RemoveTagsCommand extends $Command< RemoveTagsCommandInput, RemoveTagsCommandOutput, @@ -35,6 +38,9 @@ export class RemoveTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/SetLoadBalancerListenerSSLCertificateCommand.ts b/clients/client-elastic-load-balancing/commands/SetLoadBalancerListenerSSLCertificateCommand.ts index f9f449a226615..a988a70f0e056 100644 --- a/clients/client-elastic-load-balancing/commands/SetLoadBalancerListenerSSLCertificateCommand.ts +++ b/clients/client-elastic-load-balancing/commands/SetLoadBalancerListenerSSLCertificateCommand.ts @@ -28,6 +28,13 @@ export type SetLoadBalancerListenerSSLCertificateCommandInput = SetLoadBalancerL export type SetLoadBalancerListenerSSLCertificateCommandOutput = SetLoadBalancerListenerSSLCertificateOutput & __MetadataBearer; +/** + *

Sets the certificate that terminates the specified listener's SSL connections. The specified certificate replaces any prior certificate that was used on the same load balancer and port.

+ * + *

For more information about updating your SSL certificate, see + * Replace the SSL Certificate for Your Load Balancer + * in the Classic Load Balancers Guide.

+ */ export class SetLoadBalancerListenerSSLCertificateCommand extends $Command< SetLoadBalancerListenerSSLCertificateCommandInput, SetLoadBalancerListenerSSLCertificateCommandOutput, @@ -42,6 +49,9 @@ export class SetLoadBalancerListenerSSLCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/SetLoadBalancerPoliciesForBackendServerCommand.ts b/clients/client-elastic-load-balancing/commands/SetLoadBalancerPoliciesForBackendServerCommand.ts index 4cc2005e2ae8f..5459bdec34e71 100644 --- a/clients/client-elastic-load-balancing/commands/SetLoadBalancerPoliciesForBackendServerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/SetLoadBalancerPoliciesForBackendServerCommand.ts @@ -28,6 +28,19 @@ export type SetLoadBalancerPoliciesForBackendServerCommandInput = SetLoadBalance export type SetLoadBalancerPoliciesForBackendServerCommandOutput = SetLoadBalancerPoliciesForBackendServerOutput & __MetadataBearer; +/** + *

Replaces the set of policies associated with the specified port on which the EC2 instance is listening with a new set of policies. + * At this time, only the back-end server authentication policy type can be applied to the instance ports; this policy type is composed of multiple public key policies.

+ *

Each time you use SetLoadBalancerPoliciesForBackendServer to enable the policies, + * use the PolicyNames parameter to list the policies that you want to enable.

+ *

You can use DescribeLoadBalancers or DescribeLoadBalancerPolicies to verify that the policy + * is associated with the EC2 instance.

+ * + *

For more information about enabling back-end instance authentication, see Configure Back-end Instance Authentication + * in the Classic Load Balancers Guide. For more information about Proxy Protocol, see + * Configure Proxy Protocol Support + * in the Classic Load Balancers Guide.

+ */ export class SetLoadBalancerPoliciesForBackendServerCommand extends $Command< SetLoadBalancerPoliciesForBackendServerCommandInput, SetLoadBalancerPoliciesForBackendServerCommandOutput, @@ -42,6 +55,9 @@ export class SetLoadBalancerPoliciesForBackendServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/commands/SetLoadBalancerPoliciesOfListenerCommand.ts b/clients/client-elastic-load-balancing/commands/SetLoadBalancerPoliciesOfListenerCommand.ts index 62f3533d4fea6..990dd1a414012 100644 --- a/clients/client-elastic-load-balancing/commands/SetLoadBalancerPoliciesOfListenerCommand.ts +++ b/clients/client-elastic-load-balancing/commands/SetLoadBalancerPoliciesOfListenerCommand.ts @@ -24,6 +24,15 @@ import { export type SetLoadBalancerPoliciesOfListenerCommandInput = SetLoadBalancerPoliciesOfListenerInput; export type SetLoadBalancerPoliciesOfListenerCommandOutput = SetLoadBalancerPoliciesOfListenerOutput & __MetadataBearer; +/** + *

Replaces the current set of policies for the specified load balancer port with the specified set of policies.

+ *

To enable back-end server authentication, use SetLoadBalancerPoliciesForBackendServer.

+ *

For more information about setting policies, see + * Update the SSL Negotiation Configuration, + * Duration-Based Session Stickiness, and + * Application-Controlled Session Stickiness + * in the Classic Load Balancers Guide.

+ */ export class SetLoadBalancerPoliciesOfListenerCommand extends $Command< SetLoadBalancerPoliciesOfListenerCommandInput, SetLoadBalancerPoliciesOfListenerCommandOutput, @@ -38,6 +47,9 @@ export class SetLoadBalancerPoliciesOfListenerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticLoadBalancingClientResolvedConfig, diff --git a/clients/client-elastic-load-balancing/package.json b/clients/client-elastic-load-balancing/package.json index d778a70b331fa..0b25bc664dc97 100644 --- a/clients/client-elastic-load-balancing/package.json +++ b/clients/client-elastic-load-balancing/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Elastic Load Balancing Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-elastic-load-balancing/pagination/DescribeLoadBalancersPaginator.ts b/clients/client-elastic-load-balancing/pagination/DescribeLoadBalancersPaginator.ts index dd123273d65b5..2dc511a24687b 100644 --- a/clients/client-elastic-load-balancing/pagination/DescribeLoadBalancersPaginator.ts +++ b/clients/client-elastic-load-balancing/pagination/DescribeLoadBalancersPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticLoadBalancingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticLoadBalancingClient, input: DescribeLoadBalancersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeLoadBalancersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticLoadBalancing, input: DescribeLoadBalancersCommandInput, diff --git a/clients/client-elastic-load-balancing/runtimeConfig.browser.ts b/clients/client-elastic-load-balancing/runtimeConfig.browser.ts index 9a715e61f7420..2af59187728c7 100644 --- a/clients/client-elastic-load-balancing/runtimeConfig.browser.ts +++ b/clients/client-elastic-load-balancing/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ElasticLoadBalancingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-elastic-load-balancing/runtimeConfig.native.ts b/clients/client-elastic-load-balancing/runtimeConfig.native.ts index ce18887d3c752..e19210d6be4be 100644 --- a/clients/client-elastic-load-balancing/runtimeConfig.native.ts +++ b/clients/client-elastic-load-balancing/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ElasticLoadBalancingClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-elastic-load-balancing/runtimeConfig.shared.ts b/clients/client-elastic-load-balancing/runtimeConfig.shared.ts index c2053091510ac..2010bc612c7c7 100644 --- a/clients/client-elastic-load-balancing/runtimeConfig.shared.ts +++ b/clients/client-elastic-load-balancing/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-06-01", disableHostPrefix: false, diff --git a/clients/client-elastic-load-balancing/runtimeConfig.ts b/clients/client-elastic-load-balancing/runtimeConfig.ts index ad8e3714932ac..7df45914a3cb4 100644 --- a/clients/client-elastic-load-balancing/runtimeConfig.ts +++ b/clients/client-elastic-load-balancing/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ElasticLoadBalancingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-elastic-load-balancing/tsconfig.json b/clients/client-elastic-load-balancing/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-elastic-load-balancing/tsconfig.json +++ b/clients/client-elastic-load-balancing/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-elastic-transcoder/commands/CancelJobCommand.ts b/clients/client-elastic-transcoder/commands/CancelJobCommand.ts index b18eeb7e9eb6e..a31e4b8474789 100644 --- a/clients/client-elastic-transcoder/commands/CancelJobCommand.ts +++ b/clients/client-elastic-transcoder/commands/CancelJobCommand.ts @@ -24,6 +24,14 @@ import { export type CancelJobCommandInput = CancelJobRequest; export type CancelJobCommandOutput = CancelJobResponse & __MetadataBearer; +/** + *

The CancelJob operation cancels an unfinished job.

+ * + *

You can only cancel a job that has a status of Submitted. To prevent a + * pipeline from starting to process a job while you're getting the job identifier, use + * UpdatePipelineStatus to temporarily pause the pipeline.

+ *
+ */ export class CancelJobCommand extends $Command< CancelJobCommandInput, CancelJobCommandOutput, @@ -38,6 +46,9 @@ export class CancelJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/CreateJobCommand.ts b/clients/client-elastic-transcoder/commands/CreateJobCommand.ts index 0f04f5ec6cff1..ddddf97341f96 100644 --- a/clients/client-elastic-transcoder/commands/CreateJobCommand.ts +++ b/clients/client-elastic-transcoder/commands/CreateJobCommand.ts @@ -24,6 +24,13 @@ import { export type CreateJobCommandInput = CreateJobRequest; export type CreateJobCommandOutput = CreateJobResponse & __MetadataBearer; +/** + *

When you create a job, Elastic Transcoder returns JSON data that includes the values that you specified + * plus information about the job that is created.

+ *

If you have specified more than one output for your jobs (for example, one output for the + * Kindle Fire and another output for the Apple iPhone 4s), you currently must use the Elastic Transcoder API to + * list the jobs (as opposed to the AWS Console).

+ */ export class CreateJobCommand extends $Command< CreateJobCommandInput, CreateJobCommandOutput, @@ -38,6 +45,9 @@ export class CreateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/CreatePipelineCommand.ts b/clients/client-elastic-transcoder/commands/CreatePipelineCommand.ts index 48c977207a7a4..8655f3bfc112d 100644 --- a/clients/client-elastic-transcoder/commands/CreatePipelineCommand.ts +++ b/clients/client-elastic-transcoder/commands/CreatePipelineCommand.ts @@ -24,6 +24,9 @@ import { export type CreatePipelineCommandInput = CreatePipelineRequest; export type CreatePipelineCommandOutput = CreatePipelineResponse & __MetadataBearer; +/** + *

The CreatePipeline operation creates a pipeline with settings that you specify.

+ */ export class CreatePipelineCommand extends $Command< CreatePipelineCommandInput, CreatePipelineCommandOutput, @@ -38,6 +41,9 @@ export class CreatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/CreatePresetCommand.ts b/clients/client-elastic-transcoder/commands/CreatePresetCommand.ts index f2c2df91418c3..240a924f5626c 100644 --- a/clients/client-elastic-transcoder/commands/CreatePresetCommand.ts +++ b/clients/client-elastic-transcoder/commands/CreatePresetCommand.ts @@ -24,6 +24,22 @@ import { export type CreatePresetCommandInput = CreatePresetRequest; export type CreatePresetCommandOutput = CreatePresetResponse & __MetadataBearer; +/** + *

The CreatePreset operation creates a preset with settings that you specify.

+ * + *

Elastic Transcoder checks the CreatePreset settings to ensure that they meet Elastic Transcoder requirements + * and to determine whether they comply with H.264 standards. If your settings are not + * valid for Elastic Transcoder, Elastic Transcoder returns an HTTP 400 response (ValidationException) and + * does not create the preset. If the settings are valid for Elastic Transcoder but aren't strictly + * compliant with the H.264 standard, Elastic Transcoder creates the preset and returns a warning message + * in the response. This helps you determine whether your settings comply with the H.264 + * standard while giving you greater flexibility with respect to the video that Elastic Transcoder + * produces.

+ *
+ *

Elastic Transcoder uses the H.264 video-compression format. For more information, see the International + * Telecommunication Union publication Recommendation ITU-T H.264: Advanced video coding + * for generic audiovisual services.

+ */ export class CreatePresetCommand extends $Command< CreatePresetCommandInput, CreatePresetCommandOutput, @@ -38,6 +54,9 @@ export class CreatePresetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/DeletePipelineCommand.ts b/clients/client-elastic-transcoder/commands/DeletePipelineCommand.ts index eb708de1d1716..60cd28235d95e 100644 --- a/clients/client-elastic-transcoder/commands/DeletePipelineCommand.ts +++ b/clients/client-elastic-transcoder/commands/DeletePipelineCommand.ts @@ -24,6 +24,12 @@ import { export type DeletePipelineCommandInput = DeletePipelineRequest; export type DeletePipelineCommandOutput = DeletePipelineResponse & __MetadataBearer; +/** + *

The DeletePipeline operation removes a pipeline.

+ *

You can only delete a pipeline that has never been used or that is not currently in use + * (doesn't contain any active jobs). If the pipeline is currently in use, + * DeletePipeline returns an error.

+ */ export class DeletePipelineCommand extends $Command< DeletePipelineCommandInput, DeletePipelineCommandOutput, @@ -38,6 +44,9 @@ export class DeletePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/DeletePresetCommand.ts b/clients/client-elastic-transcoder/commands/DeletePresetCommand.ts index f693deeb59dd3..de817808d6f60 100644 --- a/clients/client-elastic-transcoder/commands/DeletePresetCommand.ts +++ b/clients/client-elastic-transcoder/commands/DeletePresetCommand.ts @@ -24,6 +24,12 @@ import { export type DeletePresetCommandInput = DeletePresetRequest; export type DeletePresetCommandOutput = DeletePresetResponse & __MetadataBearer; +/** + *

The DeletePreset operation removes a preset that you've added in an AWS region.

+ * + *

You can't delete the default presets that are included with Elastic Transcoder.

+ *
+ */ export class DeletePresetCommand extends $Command< DeletePresetCommandInput, DeletePresetCommandOutput, @@ -38,6 +44,9 @@ export class DeletePresetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/ListJobsByPipelineCommand.ts b/clients/client-elastic-transcoder/commands/ListJobsByPipelineCommand.ts index eb1a58526d200..f57794aa8972d 100644 --- a/clients/client-elastic-transcoder/commands/ListJobsByPipelineCommand.ts +++ b/clients/client-elastic-transcoder/commands/ListJobsByPipelineCommand.ts @@ -24,6 +24,11 @@ import { export type ListJobsByPipelineCommandInput = ListJobsByPipelineRequest; export type ListJobsByPipelineCommandOutput = ListJobsByPipelineResponse & __MetadataBearer; +/** + *

The ListJobsByPipeline operation gets a list of the jobs currently in a pipeline.

+ *

Elastic Transcoder returns all of the jobs currently in the specified pipeline. The response body contains + * one element for each job that satisfies the search criteria.

+ */ export class ListJobsByPipelineCommand extends $Command< ListJobsByPipelineCommandInput, ListJobsByPipelineCommandOutput, @@ -38,6 +43,9 @@ export class ListJobsByPipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/ListJobsByStatusCommand.ts b/clients/client-elastic-transcoder/commands/ListJobsByStatusCommand.ts index 3c67a54a3772b..9b78d54cec582 100644 --- a/clients/client-elastic-transcoder/commands/ListJobsByStatusCommand.ts +++ b/clients/client-elastic-transcoder/commands/ListJobsByStatusCommand.ts @@ -24,6 +24,10 @@ import { export type ListJobsByStatusCommandInput = ListJobsByStatusRequest; export type ListJobsByStatusCommandOutput = ListJobsByStatusResponse & __MetadataBearer; +/** + *

The ListJobsByStatus operation gets a list of jobs that have a specified status. The response + * body contains one element for each job that satisfies the search criteria.

+ */ export class ListJobsByStatusCommand extends $Command< ListJobsByStatusCommandInput, ListJobsByStatusCommandOutput, @@ -38,6 +42,9 @@ export class ListJobsByStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/ListPipelinesCommand.ts b/clients/client-elastic-transcoder/commands/ListPipelinesCommand.ts index f5f74616f1c7c..107211e038e5a 100644 --- a/clients/client-elastic-transcoder/commands/ListPipelinesCommand.ts +++ b/clients/client-elastic-transcoder/commands/ListPipelinesCommand.ts @@ -24,6 +24,9 @@ import { export type ListPipelinesCommandInput = ListPipelinesRequest; export type ListPipelinesCommandOutput = ListPipelinesResponse & __MetadataBearer; +/** + *

The ListPipelines operation gets a list of the pipelines associated with the current AWS account.

+ */ export class ListPipelinesCommand extends $Command< ListPipelinesCommandInput, ListPipelinesCommandOutput, @@ -38,6 +41,9 @@ export class ListPipelinesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/ListPresetsCommand.ts b/clients/client-elastic-transcoder/commands/ListPresetsCommand.ts index 0ff6dcf902b31..a00a8758c1e30 100644 --- a/clients/client-elastic-transcoder/commands/ListPresetsCommand.ts +++ b/clients/client-elastic-transcoder/commands/ListPresetsCommand.ts @@ -24,6 +24,10 @@ import { export type ListPresetsCommandInput = ListPresetsRequest; export type ListPresetsCommandOutput = ListPresetsResponse & __MetadataBearer; +/** + *

The ListPresets operation gets a list of the default presets included with Elastic Transcoder and the presets that + * you've added in an AWS region.

+ */ export class ListPresetsCommand extends $Command< ListPresetsCommandInput, ListPresetsCommandOutput, @@ -38,6 +42,9 @@ export class ListPresetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/ReadJobCommand.ts b/clients/client-elastic-transcoder/commands/ReadJobCommand.ts index 9b7d99c78e0b4..2ff8a55ebf002 100644 --- a/clients/client-elastic-transcoder/commands/ReadJobCommand.ts +++ b/clients/client-elastic-transcoder/commands/ReadJobCommand.ts @@ -24,6 +24,9 @@ import { export type ReadJobCommandInput = ReadJobRequest; export type ReadJobCommandOutput = ReadJobResponse & __MetadataBearer; +/** + *

The ReadJob operation returns detailed information about a job.

+ */ export class ReadJobCommand extends $Command< ReadJobCommandInput, ReadJobCommandOutput, @@ -38,6 +41,9 @@ export class ReadJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/ReadPipelineCommand.ts b/clients/client-elastic-transcoder/commands/ReadPipelineCommand.ts index 4f0ddea128593..f87ba8377d28e 100644 --- a/clients/client-elastic-transcoder/commands/ReadPipelineCommand.ts +++ b/clients/client-elastic-transcoder/commands/ReadPipelineCommand.ts @@ -24,6 +24,9 @@ import { export type ReadPipelineCommandInput = ReadPipelineRequest; export type ReadPipelineCommandOutput = ReadPipelineResponse & __MetadataBearer; +/** + *

The ReadPipeline operation gets detailed information about a pipeline.

+ */ export class ReadPipelineCommand extends $Command< ReadPipelineCommandInput, ReadPipelineCommandOutput, @@ -38,6 +41,9 @@ export class ReadPipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/ReadPresetCommand.ts b/clients/client-elastic-transcoder/commands/ReadPresetCommand.ts index 2619744d93707..d1956ece8e83c 100644 --- a/clients/client-elastic-transcoder/commands/ReadPresetCommand.ts +++ b/clients/client-elastic-transcoder/commands/ReadPresetCommand.ts @@ -24,6 +24,9 @@ import { export type ReadPresetCommandInput = ReadPresetRequest; export type ReadPresetCommandOutput = ReadPresetResponse & __MetadataBearer; +/** + *

The ReadPreset operation gets detailed information about a preset.

+ */ export class ReadPresetCommand extends $Command< ReadPresetCommandInput, ReadPresetCommandOutput, @@ -38,6 +41,9 @@ export class ReadPresetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/TestRoleCommand.ts b/clients/client-elastic-transcoder/commands/TestRoleCommand.ts index ecb68b3675fab..839ac155e8a5f 100644 --- a/clients/client-elastic-transcoder/commands/TestRoleCommand.ts +++ b/clients/client-elastic-transcoder/commands/TestRoleCommand.ts @@ -24,6 +24,14 @@ import { export type TestRoleCommandInput = TestRoleRequest; export type TestRoleCommandOutput = TestRoleResponse & __MetadataBearer; +/** + *

The TestRole operation tests the IAM role used to create the pipeline.

+ *

The TestRole action lets you determine whether the IAM role you are using + * has sufficient permissions to let Elastic Transcoder perform tasks associated with the transcoding + * process. The action attempts to assume the specified IAM role, checks read access to the + * input and output buckets, and tries to send a test notification to Amazon SNS topics + * that you specify.

+ */ export class TestRoleCommand extends $Command< TestRoleCommandInput, TestRoleCommandOutput, @@ -38,6 +46,9 @@ export class TestRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/UpdatePipelineCommand.ts b/clients/client-elastic-transcoder/commands/UpdatePipelineCommand.ts index 98c1845189157..62444635b45a4 100644 --- a/clients/client-elastic-transcoder/commands/UpdatePipelineCommand.ts +++ b/clients/client-elastic-transcoder/commands/UpdatePipelineCommand.ts @@ -24,6 +24,14 @@ import { export type UpdatePipelineCommandInput = UpdatePipelineRequest; export type UpdatePipelineCommandOutput = UpdatePipelineResponse & __MetadataBearer; +/** + *

Use the UpdatePipeline operation to update settings for a pipeline.

+ * + *

When you change pipeline settings, your changes take effect immediately. + * Jobs that you have already submitted and that Elastic Transcoder has not started to process are + * affected in addition to jobs that you submit after you change settings.

+ *
+ */ export class UpdatePipelineCommand extends $Command< UpdatePipelineCommandInput, UpdatePipelineCommandOutput, @@ -38,6 +46,9 @@ export class UpdatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/UpdatePipelineNotificationsCommand.ts b/clients/client-elastic-transcoder/commands/UpdatePipelineNotificationsCommand.ts index 4b32b8318d575..55ea7d8514734 100644 --- a/clients/client-elastic-transcoder/commands/UpdatePipelineNotificationsCommand.ts +++ b/clients/client-elastic-transcoder/commands/UpdatePipelineNotificationsCommand.ts @@ -24,6 +24,10 @@ import { export type UpdatePipelineNotificationsCommandInput = UpdatePipelineNotificationsRequest; export type UpdatePipelineNotificationsCommandOutput = UpdatePipelineNotificationsResponse & __MetadataBearer; +/** + *

With the UpdatePipelineNotifications operation, you can update Amazon Simple Notification Service (Amazon SNS) notifications for a pipeline.

+ *

When you update notifications for a pipeline, Elastic Transcoder returns the values that you specified in the request.

+ */ export class UpdatePipelineNotificationsCommand extends $Command< UpdatePipelineNotificationsCommandInput, UpdatePipelineNotificationsCommandOutput, @@ -38,6 +42,9 @@ export class UpdatePipelineNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/commands/UpdatePipelineStatusCommand.ts b/clients/client-elastic-transcoder/commands/UpdatePipelineStatusCommand.ts index 8dee153a8bcc2..69fd770fe7b83 100644 --- a/clients/client-elastic-transcoder/commands/UpdatePipelineStatusCommand.ts +++ b/clients/client-elastic-transcoder/commands/UpdatePipelineStatusCommand.ts @@ -24,6 +24,14 @@ import { export type UpdatePipelineStatusCommandInput = UpdatePipelineStatusRequest; export type UpdatePipelineStatusCommandOutput = UpdatePipelineStatusResponse & __MetadataBearer; +/** + *

The UpdatePipelineStatus operation pauses or reactivates a pipeline, so that the pipeline + * stops or restarts the processing of jobs.

+ *

Changing the pipeline status is useful if you want to cancel one or more jobs. You can't + * cancel jobs after Elastic Transcoder has started processing them; if you pause the pipeline to which + * you submitted the jobs, you have more time to get the job IDs for the jobs that you want + * to cancel, and to send a CancelJob request.

+ */ export class UpdatePipelineStatusCommand extends $Command< UpdatePipelineStatusCommandInput, UpdatePipelineStatusCommandOutput, @@ -38,6 +46,9 @@ export class UpdatePipelineStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticTranscoderClientResolvedConfig, diff --git a/clients/client-elastic-transcoder/package.json b/clients/client-elastic-transcoder/package.json index d68fcb18165c2..4a22ebeaa8f2b 100644 --- a/clients/client-elastic-transcoder/package.json +++ b/clients/client-elastic-transcoder/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Elastic Transcoder Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-elastic-transcoder/pagination/ListJobsByPipelinePaginator.ts b/clients/client-elastic-transcoder/pagination/ListJobsByPipelinePaginator.ts index 957227ac870bd..f309ab62b0b25 100644 --- a/clients/client-elastic-transcoder/pagination/ListJobsByPipelinePaginator.ts +++ b/clients/client-elastic-transcoder/pagination/ListJobsByPipelinePaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticTranscoderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticTranscoderClient, input: ListJobsByPipelineCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsByPipelineCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticTranscoder, input: ListJobsByPipelineCommandInput, diff --git a/clients/client-elastic-transcoder/pagination/ListJobsByStatusPaginator.ts b/clients/client-elastic-transcoder/pagination/ListJobsByStatusPaginator.ts index f933bd772e37a..5e82edc05301d 100644 --- a/clients/client-elastic-transcoder/pagination/ListJobsByStatusPaginator.ts +++ b/clients/client-elastic-transcoder/pagination/ListJobsByStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticTranscoderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticTranscoderClient, input: ListJobsByStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsByStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticTranscoder, input: ListJobsByStatusCommandInput, diff --git a/clients/client-elastic-transcoder/pagination/ListPipelinesPaginator.ts b/clients/client-elastic-transcoder/pagination/ListPipelinesPaginator.ts index 42ca2517ccddd..987d6c246afd0 100644 --- a/clients/client-elastic-transcoder/pagination/ListPipelinesPaginator.ts +++ b/clients/client-elastic-transcoder/pagination/ListPipelinesPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticTranscoderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticTranscoderClient, input: ListPipelinesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPipelinesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticTranscoder, input: ListPipelinesCommandInput, diff --git a/clients/client-elastic-transcoder/pagination/ListPresetsPaginator.ts b/clients/client-elastic-transcoder/pagination/ListPresetsPaginator.ts index 10c49e92886ff..3e3ed507a7a38 100644 --- a/clients/client-elastic-transcoder/pagination/ListPresetsPaginator.ts +++ b/clients/client-elastic-transcoder/pagination/ListPresetsPaginator.ts @@ -4,6 +4,9 @@ import { ListPresetsCommand, ListPresetsCommandInput, ListPresetsCommandOutput } import { ElasticTranscoderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticTranscoderClient, input: ListPresetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPresetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticTranscoder, input: ListPresetsCommandInput, diff --git a/clients/client-elastic-transcoder/runtimeConfig.browser.ts b/clients/client-elastic-transcoder/runtimeConfig.browser.ts index bf9afc6011b88..d4cbf889aa119 100644 --- a/clients/client-elastic-transcoder/runtimeConfig.browser.ts +++ b/clients/client-elastic-transcoder/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ElasticTranscoderClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-elastic-transcoder/runtimeConfig.native.ts b/clients/client-elastic-transcoder/runtimeConfig.native.ts index ba5177509170b..5420df3ac78bb 100644 --- a/clients/client-elastic-transcoder/runtimeConfig.native.ts +++ b/clients/client-elastic-transcoder/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ElasticTranscoderClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-elastic-transcoder/runtimeConfig.shared.ts b/clients/client-elastic-transcoder/runtimeConfig.shared.ts index af3ed25e547d9..635d8037dd6a6 100644 --- a/clients/client-elastic-transcoder/runtimeConfig.shared.ts +++ b/clients/client-elastic-transcoder/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-09-25", disableHostPrefix: false, diff --git a/clients/client-elastic-transcoder/runtimeConfig.ts b/clients/client-elastic-transcoder/runtimeConfig.ts index b3e2683922fbb..a401f1692959c 100644 --- a/clients/client-elastic-transcoder/runtimeConfig.ts +++ b/clients/client-elastic-transcoder/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ElasticTranscoderClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-elastic-transcoder/tsconfig.json b/clients/client-elastic-transcoder/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-elastic-transcoder/tsconfig.json +++ b/clients/client-elastic-transcoder/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-elasticache/commands/AddTagsToResourceCommand.ts b/clients/client-elasticache/commands/AddTagsToResourceCommand.ts index 9de446343a385..bc4060e552dc4 100644 --- a/clients/client-elasticache/commands/AddTagsToResourceCommand.ts +++ b/clients/client-elasticache/commands/AddTagsToResourceCommand.ts @@ -20,6 +20,20 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceMessage; export type AddTagsToResourceCommandOutput = TagListMessage & __MetadataBearer; +/** + *

Adds up to 50 cost allocation tags to the named resource. + * A cost allocation tag is a key-value pair where the key and value are case-sensitive. + * You can use cost allocation tags to categorize and track your AWS costs.

+ *

+ * When you apply tags to your ElastiCache resources, + * AWS generates a cost allocation report as a comma-separated value (CSV) file + * with your usage and costs aggregated by your tags. + * You can apply tags that represent business categories (such as cost centers, application names, or owners) + * to organize your costs across multiple services. + * For more information, + * see Using Cost Allocation Tags in Amazon ElastiCache + * in the ElastiCache User Guide.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -34,6 +48,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/AuthorizeCacheSecurityGroupIngressCommand.ts b/clients/client-elasticache/commands/AuthorizeCacheSecurityGroupIngressCommand.ts index e1af9d0bfd0e2..3163be973bf2f 100644 --- a/clients/client-elasticache/commands/AuthorizeCacheSecurityGroupIngressCommand.ts +++ b/clients/client-elasticache/commands/AuthorizeCacheSecurityGroupIngressCommand.ts @@ -24,6 +24,15 @@ export type AuthorizeCacheSecurityGroupIngressCommandInput = AuthorizeCacheSecur export type AuthorizeCacheSecurityGroupIngressCommandOutput = AuthorizeCacheSecurityGroupIngressResult & __MetadataBearer; +/** + *

Allows network ingress to a cache + * security group. Applications using ElastiCache must be running on Amazon EC2, and Amazon EC2 + * security groups are used as the authorization mechanism.

+ * + *

You cannot authorize ingress from an Amazon EC2 security group in one region to an + * ElastiCache cluster in another region.

+ *
+ */ export class AuthorizeCacheSecurityGroupIngressCommand extends $Command< AuthorizeCacheSecurityGroupIngressCommandInput, AuthorizeCacheSecurityGroupIngressCommandOutput, @@ -38,6 +47,9 @@ export class AuthorizeCacheSecurityGroupIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/BatchApplyUpdateActionCommand.ts b/clients/client-elasticache/commands/BatchApplyUpdateActionCommand.ts index 6432f083a3966..147d171186ab9 100644 --- a/clients/client-elasticache/commands/BatchApplyUpdateActionCommand.ts +++ b/clients/client-elasticache/commands/BatchApplyUpdateActionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchApplyUpdateActionCommandInput = BatchApplyUpdateActionMessage; export type BatchApplyUpdateActionCommandOutput = UpdateActionResultsMessage & __MetadataBearer; +/** + *

Apply the service update. For more information on service updates and applying them, see Applying Service Updates.

+ */ export class BatchApplyUpdateActionCommand extends $Command< BatchApplyUpdateActionCommandInput, BatchApplyUpdateActionCommandOutput, @@ -34,6 +37,9 @@ export class BatchApplyUpdateActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/BatchStopUpdateActionCommand.ts b/clients/client-elasticache/commands/BatchStopUpdateActionCommand.ts index bdb48f47afa9c..e1725900b8968 100644 --- a/clients/client-elasticache/commands/BatchStopUpdateActionCommand.ts +++ b/clients/client-elasticache/commands/BatchStopUpdateActionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchStopUpdateActionCommandInput = BatchStopUpdateActionMessage; export type BatchStopUpdateActionCommandOutput = UpdateActionResultsMessage & __MetadataBearer; +/** + *

Stop the service update. For more information on service updates and stopping them, see Stopping Service Updates.

+ */ export class BatchStopUpdateActionCommand extends $Command< BatchStopUpdateActionCommandInput, BatchStopUpdateActionCommandOutput, @@ -34,6 +37,9 @@ export class BatchStopUpdateActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CompleteMigrationCommand.ts b/clients/client-elasticache/commands/CompleteMigrationCommand.ts index c48e001614ad2..67376d9b67155 100644 --- a/clients/client-elasticache/commands/CompleteMigrationCommand.ts +++ b/clients/client-elasticache/commands/CompleteMigrationCommand.ts @@ -20,6 +20,9 @@ import { export type CompleteMigrationCommandInput = CompleteMigrationMessage; export type CompleteMigrationCommandOutput = CompleteMigrationResponse & __MetadataBearer; +/** + *

Complete the migration of data.

+ */ export class CompleteMigrationCommand extends $Command< CompleteMigrationCommandInput, CompleteMigrationCommandOutput, @@ -34,6 +37,9 @@ export class CompleteMigrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CopySnapshotCommand.ts b/clients/client-elasticache/commands/CopySnapshotCommand.ts index 57db3d5a49eeb..f3ab10bac0764 100644 --- a/clients/client-elasticache/commands/CopySnapshotCommand.ts +++ b/clients/client-elasticache/commands/CopySnapshotCommand.ts @@ -17,6 +17,102 @@ import { export type CopySnapshotCommandInput = CopySnapshotMessage; export type CopySnapshotCommandOutput = CopySnapshotResult & __MetadataBearer; +/** + *

Makes a copy of an existing snapshot.

+ * + * + *

This operation is valid for Redis only.

+ *
+ * + * + *

Users or groups that have permissions to use the CopySnapshot operation + * can create their own Amazon S3 buckets and copy snapshots to it. + * To control access to your snapshots, use an IAM policy to control who has the ability to use + * the CopySnapshot operation. + * For more information about using IAM to control the use of ElastiCache operations, see Exporting Snapshots + * and Authentication & Access Control.

+ *
+ * + *

You could receive the following error messages.

+ *

+ * Error Messages + *

+ *
    + *
  • + *

    + * Error Message: + * The S3 bucket %s is outside of the region.

    + *

    + * Solution: + * Create an Amazon S3 bucket in the same region as your snapshot. + * For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.

    + *
  • + *
  • + *

    + * Error Message: + * The S3 bucket %s does not exist.

    + *

    + * Solution: + * Create an Amazon S3 bucket in the same region as your snapshot. + * For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.

    + *
  • + *
  • + *

    + * Error Message: + * The S3 bucket %s is not owned by the authenticated user.

    + *

    + * Solution: + * Create an Amazon S3 bucket in the same region as your snapshot. + * For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.

    + *
  • + *
  • + *

    + * Error Message: + * The authenticated user does not have sufficient permissions to perform the desired activity.

    + *

    + * Solution: + * Contact your system administrator to get the needed permissions.

    + *
  • + *
  • + *

    + * Error Message: + * The S3 bucket %s already contains an object with key %s.

    + *

    + * Solution: + * Give the TargetSnapshotName a new and unique value. + * If exporting a snapshot, + * you could alternatively create a new Amazon S3 bucket + * and use this same value for TargetSnapshotName.

    + *
  • + *
  • + *

    + * Error Message: + * ElastiCache has not been granted READ permissions %s on the S3 Bucket.

    + *

    + * Solution: + * Add List and Read permissions on the bucket. + * For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.

    + *
  • + *
  • + *

    + * Error Message: + * ElastiCache has not been granted WRITE permissions %s on the S3 Bucket.

    + *

    + * Solution: + * Add Upload/Delete permissions on the bucket. + * For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.

    + *
  • + *
  • + *

    + * Error Message: + * ElastiCache has not been granted READ_ACP permissions %s on the S3 Bucket.

    + *

    + * Solution: + * Add View Permissions on the bucket. + * For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.

    + *
  • + *
+ */ export class CopySnapshotCommand extends $Command< CopySnapshotCommandInput, CopySnapshotCommandOutput, @@ -31,6 +127,9 @@ export class CopySnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateCacheClusterCommand.ts b/clients/client-elasticache/commands/CreateCacheClusterCommand.ts index 315208af3480d..e9b706fc0358e 100644 --- a/clients/client-elasticache/commands/CreateCacheClusterCommand.ts +++ b/clients/client-elasticache/commands/CreateCacheClusterCommand.ts @@ -20,6 +20,12 @@ import { export type CreateCacheClusterCommandInput = CreateCacheClusterMessage; export type CreateCacheClusterCommandOutput = CreateCacheClusterResult & __MetadataBearer; +/** + *

Creates a cluster. All nodes in the + * cluster run the same protocol-compliant cache engine software, either Memcached + * or Redis.

+ *

This operation is not supported for Redis (cluster mode enabled) clusters.

+ */ export class CreateCacheClusterCommand extends $Command< CreateCacheClusterCommandInput, CreateCacheClusterCommandOutput, @@ -34,6 +40,9 @@ export class CreateCacheClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateCacheParameterGroupCommand.ts b/clients/client-elasticache/commands/CreateCacheParameterGroupCommand.ts index 3deffaa6f6fea..5283db08af8a9 100644 --- a/clients/client-elasticache/commands/CreateCacheParameterGroupCommand.ts +++ b/clients/client-elasticache/commands/CreateCacheParameterGroupCommand.ts @@ -20,6 +20,24 @@ import { export type CreateCacheParameterGroupCommandInput = CreateCacheParameterGroupMessage; export type CreateCacheParameterGroupCommandOutput = CreateCacheParameterGroupResult & __MetadataBearer; +/** + *

Creates a new Amazon ElastiCache cache parameter group. An ElastiCache + * cache parameter group is a collection of parameters and their values that are applied to all of the nodes + * in any cluster or replication group using the CacheParameterGroup.

+ *

A newly created CacheParameterGroup is an exact duplicate of the default parameter group + * for the CacheParameterGroupFamily. To customize the newly created CacheParameterGroup you can + * change the values of specific parameters. For more information, see:

+ * + */ export class CreateCacheParameterGroupCommand extends $Command< CreateCacheParameterGroupCommandInput, CreateCacheParameterGroupCommandOutput, @@ -34,6 +52,9 @@ export class CreateCacheParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateCacheSecurityGroupCommand.ts b/clients/client-elasticache/commands/CreateCacheSecurityGroupCommand.ts index c33b05f78e8fc..c51c007710775 100644 --- a/clients/client-elasticache/commands/CreateCacheSecurityGroupCommand.ts +++ b/clients/client-elasticache/commands/CreateCacheSecurityGroupCommand.ts @@ -20,6 +20,14 @@ import { export type CreateCacheSecurityGroupCommandInput = CreateCacheSecurityGroupMessage; export type CreateCacheSecurityGroupCommandOutput = CreateCacheSecurityGroupResult & __MetadataBearer; +/** + *

Creates a new cache security group. Use a + * cache security group to control access to one or more clusters.

+ *

Cache security groups are only used when you are creating a cluster outside of an Amazon + * Virtual Private Cloud (Amazon VPC). If you are creating a cluster inside of a VPC, use a cache + * subnet group instead. For more information, + * see CreateCacheSubnetGroup.

+ */ export class CreateCacheSecurityGroupCommand extends $Command< CreateCacheSecurityGroupCommandInput, CreateCacheSecurityGroupCommandOutput, @@ -34,6 +42,9 @@ export class CreateCacheSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateCacheSubnetGroupCommand.ts b/clients/client-elasticache/commands/CreateCacheSubnetGroupCommand.ts index 0eecc7b508545..bbcb95e6880cb 100644 --- a/clients/client-elasticache/commands/CreateCacheSubnetGroupCommand.ts +++ b/clients/client-elasticache/commands/CreateCacheSubnetGroupCommand.ts @@ -20,6 +20,10 @@ import { export type CreateCacheSubnetGroupCommandInput = CreateCacheSubnetGroupMessage; export type CreateCacheSubnetGroupCommandOutput = CreateCacheSubnetGroupResult & __MetadataBearer; +/** + *

Creates a new cache subnet group.

+ *

Use this parameter only when you are creating a cluster in an Amazon Virtual Private Cloud (Amazon VPC).

+ */ export class CreateCacheSubnetGroupCommand extends $Command< CreateCacheSubnetGroupCommandInput, CreateCacheSubnetGroupCommandOutput, @@ -34,6 +38,9 @@ export class CreateCacheSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateGlobalReplicationGroupCommand.ts b/clients/client-elasticache/commands/CreateGlobalReplicationGroupCommand.ts index a591807dc07f8..c60be7b0a8747 100644 --- a/clients/client-elasticache/commands/CreateGlobalReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/CreateGlobalReplicationGroupCommand.ts @@ -20,6 +20,22 @@ import { export type CreateGlobalReplicationGroupCommandInput = CreateGlobalReplicationGroupMessage; export type CreateGlobalReplicationGroupCommandOutput = CreateGlobalReplicationGroupResult & __MetadataBearer; +/** + *

Global Datastore for Redis offers fully managed, fast, + * reliable and secure cross-region replication. + * Using Global Datastore for Redis, you can create cross-region + * read replica clusters for ElastiCache for Redis to enable low-latency reads + * and disaster recovery across regions. For more information, + * see Replication Across Regions Using Global Datastore.

+ *
    + *
  • + *

    The GlobalReplicationGroupIdSuffix is the name of the Global Datastore.

    + *
  • + *
  • + *

    The PrimaryReplicationGroupId represents the name of the primary cluster that accepts writes and will replicate updates to the secondary cluster.

    + *
  • + *
+ */ export class CreateGlobalReplicationGroupCommand extends $Command< CreateGlobalReplicationGroupCommandInput, CreateGlobalReplicationGroupCommandOutput, @@ -34,6 +50,9 @@ export class CreateGlobalReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateReplicationGroupCommand.ts b/clients/client-elasticache/commands/CreateReplicationGroupCommand.ts index 3e66a08ed92e7..88820ba96dc5a 100644 --- a/clients/client-elasticache/commands/CreateReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/CreateReplicationGroupCommand.ts @@ -20,6 +20,27 @@ import { export type CreateReplicationGroupCommandInput = CreateReplicationGroupMessage; export type CreateReplicationGroupCommandOutput = CreateReplicationGroupResult & __MetadataBearer; +/** + *

Creates a Redis (cluster mode disabled) or a Redis (cluster mode enabled) replication group.

+ *

This API can be used to create a standalone regional replication group or a secondary replication group associated with a Global Datastore.

+ *

A Redis (cluster mode disabled) replication group is a collection of clusters, + * where one of the clusters is a read/write primary and the others are read-only replicas. + * Writes to the primary are asynchronously propagated to the replicas.

+ *

A Redis (cluster mode enabled) replication group is a collection of 1 to 90 node groups (shards). + * Each node group (shard) has one read/write primary node and up to 5 read-only replica nodes. + * Writes to the primary are asynchronously propagated to the replicas. + * Redis (cluster mode enabled) replication groups partition the data across node groups (shards).

+ *

When a Redis (cluster mode disabled) replication group has been successfully created, + * you can add one or more read replicas to it, up to a total of 5 read replicas. + * If you need to increase or decrease the number of node groups (console: shards), + * you can avail yourself of ElastiCache for Redis' scaling. For more information, + * see Scaling ElastiCache for Redis Clusters in the ElastiCache User Guide.

+ * + * + * + *

This operation is valid for Redis only.

+ *
+ */ export class CreateReplicationGroupCommand extends $Command< CreateReplicationGroupCommandInput, CreateReplicationGroupCommandOutput, @@ -34,6 +55,9 @@ export class CreateReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateSnapshotCommand.ts b/clients/client-elasticache/commands/CreateSnapshotCommand.ts index f98121d13823b..d00bd04e48a74 100644 --- a/clients/client-elasticache/commands/CreateSnapshotCommand.ts +++ b/clients/client-elasticache/commands/CreateSnapshotCommand.ts @@ -20,6 +20,14 @@ import { export type CreateSnapshotCommandInput = CreateSnapshotMessage; export type CreateSnapshotCommandOutput = CreateSnapshotResult & __MetadataBearer; +/** + *

Creates a copy of an entire cluster or replication group at a + * specific moment in time.

+ * + * + *

This operation is valid for Redis only.

+ *
+ */ export class CreateSnapshotCommand extends $Command< CreateSnapshotCommandInput, CreateSnapshotCommandOutput, @@ -34,6 +42,9 @@ export class CreateSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateUserCommand.ts b/clients/client-elasticache/commands/CreateUserCommand.ts index ac540e62301df..01a52ba73de21 100644 --- a/clients/client-elasticache/commands/CreateUserCommand.ts +++ b/clients/client-elasticache/commands/CreateUserCommand.ts @@ -17,6 +17,9 @@ import { export type CreateUserCommandInput = CreateUserMessage; export type CreateUserCommandOutput = User & __MetadataBearer; +/** + *

For Redis engine version 6.x onwards: Creates a Redis user. For more information, see Using Role Based Access Control (RBAC).

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -31,6 +34,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/CreateUserGroupCommand.ts b/clients/client-elasticache/commands/CreateUserGroupCommand.ts index 8685b6a179eb6..f800b3b7c754f 100644 --- a/clients/client-elasticache/commands/CreateUserGroupCommand.ts +++ b/clients/client-elasticache/commands/CreateUserGroupCommand.ts @@ -20,6 +20,10 @@ import { export type CreateUserGroupCommandInput = CreateUserGroupMessage; export type CreateUserGroupCommandOutput = UserGroup & __MetadataBearer; +/** + *

For Redis engine version 6.x onwards: Creates a Redis user group. For more information, see Using Role Based Access Control (RBAC) + *

+ */ export class CreateUserGroupCommand extends $Command< CreateUserGroupCommandInput, CreateUserGroupCommandOutput, @@ -34,6 +38,9 @@ export class CreateUserGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DecreaseNodeGroupsInGlobalReplicationGroupCommand.ts b/clients/client-elasticache/commands/DecreaseNodeGroupsInGlobalReplicationGroupCommand.ts index 33772cf3b33a6..2957d93be8759 100644 --- a/clients/client-elasticache/commands/DecreaseNodeGroupsInGlobalReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/DecreaseNodeGroupsInGlobalReplicationGroupCommand.ts @@ -24,6 +24,9 @@ export type DecreaseNodeGroupsInGlobalReplicationGroupCommandInput = DecreaseNod export type DecreaseNodeGroupsInGlobalReplicationGroupCommandOutput = DecreaseNodeGroupsInGlobalReplicationGroupResult & __MetadataBearer; +/** + *

Decreases the number of node groups in a Global Datastore

+ */ export class DecreaseNodeGroupsInGlobalReplicationGroupCommand extends $Command< DecreaseNodeGroupsInGlobalReplicationGroupCommandInput, DecreaseNodeGroupsInGlobalReplicationGroupCommandOutput, @@ -38,6 +41,9 @@ export class DecreaseNodeGroupsInGlobalReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DecreaseReplicaCountCommand.ts b/clients/client-elasticache/commands/DecreaseReplicaCountCommand.ts index 268987526c0d3..e0d3d315ca4ba 100644 --- a/clients/client-elasticache/commands/DecreaseReplicaCountCommand.ts +++ b/clients/client-elasticache/commands/DecreaseReplicaCountCommand.ts @@ -20,6 +20,11 @@ import { export type DecreaseReplicaCountCommandInput = DecreaseReplicaCountMessage; export type DecreaseReplicaCountCommandOutput = DecreaseReplicaCountResult & __MetadataBearer; +/** + *

Dynamically decreases the number of replicas in a Redis (cluster mode disabled) replication group or the number of + * replica nodes in one or more node groups (shards) of a Redis (cluster mode enabled) replication group. This operation + * is performed with no cluster down time.

+ */ export class DecreaseReplicaCountCommand extends $Command< DecreaseReplicaCountCommandInput, DecreaseReplicaCountCommandOutput, @@ -34,6 +39,9 @@ export class DecreaseReplicaCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteCacheClusterCommand.ts b/clients/client-elasticache/commands/DeleteCacheClusterCommand.ts index 132e0da737852..2d3d5ee378671 100644 --- a/clients/client-elasticache/commands/DeleteCacheClusterCommand.ts +++ b/clients/client-elasticache/commands/DeleteCacheClusterCommand.ts @@ -20,6 +20,31 @@ import { export type DeleteCacheClusterCommandInput = DeleteCacheClusterMessage; export type DeleteCacheClusterCommandOutput = DeleteCacheClusterResult & __MetadataBearer; +/** + *

Deletes a previously provisioned cluster. + * DeleteCacheCluster deletes all associated cache nodes, node endpoints and the + * cluster itself. When you receive a successful response from this operation, + * Amazon ElastiCache immediately begins deleting the cluster; you cannot cancel or revert + * this operation.

+ *

This operation is not valid for:

+ *
    + *
  • + *

    Redis (cluster mode enabled) clusters

    + *
  • + *
  • + *

    A cluster that is the last read replica of a replication group

    + *
  • + *
  • + *

    A node group (shard) that has Multi-AZ mode enabled

    + *
  • + *
  • + *

    A cluster from a Redis (cluster mode enabled) replication group

    + *
  • + *
  • + *

    A cluster that is not in the available state

    + *
  • + *
+ */ export class DeleteCacheClusterCommand extends $Command< DeleteCacheClusterCommandInput, DeleteCacheClusterCommandOutput, @@ -34,6 +59,9 @@ export class DeleteCacheClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteCacheParameterGroupCommand.ts b/clients/client-elasticache/commands/DeleteCacheParameterGroupCommand.ts index bbf9063376594..5d889c79c4f14 100644 --- a/clients/client-elasticache/commands/DeleteCacheParameterGroupCommand.ts +++ b/clients/client-elasticache/commands/DeleteCacheParameterGroupCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteCacheParameterGroupCommandInput = DeleteCacheParameterGroupMessage; export type DeleteCacheParameterGroupCommandOutput = __MetadataBearer; +/** + *

Deletes the specified cache parameter + * group. You cannot delete a cache parameter group if it is associated with any cache + * clusters.

+ */ export class DeleteCacheParameterGroupCommand extends $Command< DeleteCacheParameterGroupCommandInput, DeleteCacheParameterGroupCommandOutput, @@ -34,6 +39,9 @@ export class DeleteCacheParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteCacheSecurityGroupCommand.ts b/clients/client-elasticache/commands/DeleteCacheSecurityGroupCommand.ts index 56c8217c51220..7097d3553c0e9 100644 --- a/clients/client-elasticache/commands/DeleteCacheSecurityGroupCommand.ts +++ b/clients/client-elasticache/commands/DeleteCacheSecurityGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteCacheSecurityGroupCommandInput = DeleteCacheSecurityGroupMessage; export type DeleteCacheSecurityGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a cache security group.

+ * + *

You cannot delete a cache security group if it is associated with any clusters.

+ *
+ */ export class DeleteCacheSecurityGroupCommand extends $Command< DeleteCacheSecurityGroupCommandInput, DeleteCacheSecurityGroupCommandOutput, @@ -34,6 +40,9 @@ export class DeleteCacheSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteCacheSubnetGroupCommand.ts b/clients/client-elasticache/commands/DeleteCacheSubnetGroupCommand.ts index aa6af8b5348fe..855870b43ba4b 100644 --- a/clients/client-elasticache/commands/DeleteCacheSubnetGroupCommand.ts +++ b/clients/client-elasticache/commands/DeleteCacheSubnetGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteCacheSubnetGroupCommandInput = DeleteCacheSubnetGroupMessage; export type DeleteCacheSubnetGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a cache subnet group.

+ * + *

You cannot delete a cache subnet group if it is associated with any clusters.

+ *
+ */ export class DeleteCacheSubnetGroupCommand extends $Command< DeleteCacheSubnetGroupCommandInput, DeleteCacheSubnetGroupCommandOutput, @@ -34,6 +40,9 @@ export class DeleteCacheSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteGlobalReplicationGroupCommand.ts b/clients/client-elasticache/commands/DeleteGlobalReplicationGroupCommand.ts index c7a506e2314ca..ad7c140296bb4 100644 --- a/clients/client-elasticache/commands/DeleteGlobalReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/DeleteGlobalReplicationGroupCommand.ts @@ -20,6 +20,22 @@ import { export type DeleteGlobalReplicationGroupCommandInput = DeleteGlobalReplicationGroupMessage; export type DeleteGlobalReplicationGroupCommandOutput = DeleteGlobalReplicationGroupResult & __MetadataBearer; +/** + *

Deleting a Global Datastore is a two-step process:

+ *
    + *
  • + *

    First, you must DisassociateGlobalReplicationGroup to remove the secondary clusters in the Global Datastore.

    + *
  • + *
  • + *

    Once the Global Datastore contains only the primary cluster, you can use DeleteGlobalReplicationGroup API to delete the Global Datastore while retainining the primary cluster using Retain…= true.

    + *
  • + *
+ * + *

Since the Global Datastore has only a primary cluster, you can delete the Global Datastore + * while retaining the primary by setting RetainPrimaryCluster=true.

+ *

When you receive a successful response from this operation, Amazon ElastiCache immediately begins deleting the selected resources; + * you cannot cancel or revert this operation.

+ */ export class DeleteGlobalReplicationGroupCommand extends $Command< DeleteGlobalReplicationGroupCommandInput, DeleteGlobalReplicationGroupCommandOutput, @@ -34,6 +50,9 @@ export class DeleteGlobalReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteReplicationGroupCommand.ts b/clients/client-elasticache/commands/DeleteReplicationGroupCommand.ts index 948227bd1b06c..a339bf95ac131 100644 --- a/clients/client-elasticache/commands/DeleteReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/DeleteReplicationGroupCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteReplicationGroupCommandInput = DeleteReplicationGroupMessage; export type DeleteReplicationGroupCommandOutput = DeleteReplicationGroupResult & __MetadataBearer; +/** + *

Deletes an existing replication group. + * By default, this operation deletes the entire replication group, including the primary/primaries and all of the read replicas. + * If the replication group has only one primary, + * you can optionally delete only the read replicas, while retaining the primary by setting RetainPrimaryCluster=true.

+ *

When you receive a successful response from this operation, Amazon ElastiCache immediately begins deleting the selected resources; + * you cannot cancel or revert this operation.

+ * + *

This operation is valid for Redis only.

+ *
+ */ export class DeleteReplicationGroupCommand extends $Command< DeleteReplicationGroupCommandInput, DeleteReplicationGroupCommandOutput, @@ -34,6 +45,9 @@ export class DeleteReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteSnapshotCommand.ts b/clients/client-elasticache/commands/DeleteSnapshotCommand.ts index c39b2d0dda081..8809760f81cfb 100644 --- a/clients/client-elasticache/commands/DeleteSnapshotCommand.ts +++ b/clients/client-elasticache/commands/DeleteSnapshotCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteSnapshotCommandInput = DeleteSnapshotMessage; export type DeleteSnapshotCommandOutput = DeleteSnapshotResult & __MetadataBearer; +/** + *

Deletes an existing snapshot. When you receive a + * successful response from this operation, ElastiCache immediately begins deleting the snapshot; + * you cannot cancel or revert this operation.

+ * + * + *

This operation is valid for Redis only.

+ *
+ */ export class DeleteSnapshotCommand extends $Command< DeleteSnapshotCommandInput, DeleteSnapshotCommandOutput, @@ -34,6 +43,9 @@ export class DeleteSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteUserCommand.ts b/clients/client-elasticache/commands/DeleteUserCommand.ts index 365ee035313e2..fde2c6f58c780 100644 --- a/clients/client-elasticache/commands/DeleteUserCommand.ts +++ b/clients/client-elasticache/commands/DeleteUserCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteUserCommandInput = DeleteUserMessage; export type DeleteUserCommandOutput = User & __MetadataBearer; +/** + *

For Redis engine version 6.x onwards: Deletes a user. The user will be removed from all user groups and in turn removed from all replication groups. For more information, see Using Role Based Access Control (RBAC).

+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -31,6 +34,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DeleteUserGroupCommand.ts b/clients/client-elasticache/commands/DeleteUserGroupCommand.ts index fccfe0ad72f2f..bb3b849271e9a 100644 --- a/clients/client-elasticache/commands/DeleteUserGroupCommand.ts +++ b/clients/client-elasticache/commands/DeleteUserGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserGroupCommandInput = DeleteUserGroupMessage; export type DeleteUserGroupCommandOutput = UserGroup & __MetadataBearer; +/** + *

For Redis engine version 6.x onwards: Deletes a ser group. The user group must first be disassociated from the replcation group before it can be deleted. For more information, see Using Role Based Access Control (RBAC).

+ */ export class DeleteUserGroupCommand extends $Command< DeleteUserGroupCommandInput, DeleteUserGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeCacheClustersCommand.ts b/clients/client-elasticache/commands/DescribeCacheClustersCommand.ts index 5bd45eafae701..9517fcfa60dea 100644 --- a/clients/client-elasticache/commands/DescribeCacheClustersCommand.ts +++ b/clients/client-elasticache/commands/DescribeCacheClustersCommand.ts @@ -20,6 +20,24 @@ import { export type DescribeCacheClustersCommandInput = DescribeCacheClustersMessage; export type DescribeCacheClustersCommandOutput = CacheClusterMessage & __MetadataBearer; +/** + *

Returns information about all provisioned + * clusters if no cluster identifier is specified, or about a specific cache + * cluster if a cluster identifier is supplied.

+ *

By default, abbreviated information about the clusters is returned. You can + * use the optional ShowCacheNodeInfo flag to retrieve detailed information about the + * cache nodes associated with the clusters. These details include the DNS address + * and port for the cache node endpoint.

+ *

If the cluster is in the creating state, only cluster-level information is displayed + * until all of the nodes are successfully provisioned.

+ *

If the cluster is in the deleting state, only cluster-level information is displayed.

+ *

If cache nodes are currently being added to the cluster, node endpoint information + * and creation time for the additional nodes are not displayed until they are + * completely provisioned. When the cluster state is available, the cluster is + * ready for use.

+ *

If cache nodes are currently being removed from the cluster, no endpoint information + * for the removed nodes is displayed.

+ */ export class DescribeCacheClustersCommand extends $Command< DescribeCacheClustersCommandInput, DescribeCacheClustersCommandOutput, @@ -34,6 +52,9 @@ export class DescribeCacheClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeCacheEngineVersionsCommand.ts b/clients/client-elasticache/commands/DescribeCacheEngineVersionsCommand.ts index 762a9164383f1..db355a26b0b51 100644 --- a/clients/client-elasticache/commands/DescribeCacheEngineVersionsCommand.ts +++ b/clients/client-elasticache/commands/DescribeCacheEngineVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeCacheEngineVersionsCommandInput = DescribeCacheEngineVersionsMessage; export type DescribeCacheEngineVersionsCommandOutput = CacheEngineVersionMessage & __MetadataBearer; +/** + *

Returns a list of the available cache + * engines and their versions.

+ */ export class DescribeCacheEngineVersionsCommand extends $Command< DescribeCacheEngineVersionsCommandInput, DescribeCacheEngineVersionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeCacheEngineVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeCacheParameterGroupsCommand.ts b/clients/client-elasticache/commands/DescribeCacheParameterGroupsCommand.ts index b2c80edf030cc..e1b14bfd11385 100644 --- a/clients/client-elasticache/commands/DescribeCacheParameterGroupsCommand.ts +++ b/clients/client-elasticache/commands/DescribeCacheParameterGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeCacheParameterGroupsCommandInput = DescribeCacheParameterGroupsMessage; export type DescribeCacheParameterGroupsCommandOutput = CacheParameterGroupsMessage & __MetadataBearer; +/** + *

Returns a list of cache parameter group + * descriptions. If a cache parameter group name is specified, the list contains only + * the descriptions for that group.

+ */ export class DescribeCacheParameterGroupsCommand extends $Command< DescribeCacheParameterGroupsCommandInput, DescribeCacheParameterGroupsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeCacheParameterGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeCacheParametersCommand.ts b/clients/client-elasticache/commands/DescribeCacheParametersCommand.ts index afcdae5ffc0ab..8aa27a7ce4dd6 100644 --- a/clients/client-elasticache/commands/DescribeCacheParametersCommand.ts +++ b/clients/client-elasticache/commands/DescribeCacheParametersCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeCacheParametersCommandInput = DescribeCacheParametersMessage; export type DescribeCacheParametersCommandOutput = CacheParameterGroupDetails & __MetadataBearer; +/** + *

Returns the detailed parameter list for a + * particular cache parameter group.

+ */ export class DescribeCacheParametersCommand extends $Command< DescribeCacheParametersCommandInput, DescribeCacheParametersCommandOutput, @@ -34,6 +38,9 @@ export class DescribeCacheParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeCacheSecurityGroupsCommand.ts b/clients/client-elasticache/commands/DescribeCacheSecurityGroupsCommand.ts index 136538cae545b..1f6654623361d 100644 --- a/clients/client-elasticache/commands/DescribeCacheSecurityGroupsCommand.ts +++ b/clients/client-elasticache/commands/DescribeCacheSecurityGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeCacheSecurityGroupsCommandInput = DescribeCacheSecurityGroupsMessage; export type DescribeCacheSecurityGroupsCommandOutput = CacheSecurityGroupMessage & __MetadataBearer; +/** + *

Returns a list of cache security group + * descriptions. If a cache security group name is specified, the list contains only + * the description of that group. This applicable only when you have ElastiCache in Classic setup + *

+ */ export class DescribeCacheSecurityGroupsCommand extends $Command< DescribeCacheSecurityGroupsCommandInput, DescribeCacheSecurityGroupsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeCacheSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeCacheSubnetGroupsCommand.ts b/clients/client-elasticache/commands/DescribeCacheSubnetGroupsCommand.ts index 9666b59357a83..20547a9cf0c8d 100644 --- a/clients/client-elasticache/commands/DescribeCacheSubnetGroupsCommand.ts +++ b/clients/client-elasticache/commands/DescribeCacheSubnetGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeCacheSubnetGroupsCommandInput = DescribeCacheSubnetGroupsMessage; export type DescribeCacheSubnetGroupsCommandOutput = CacheSubnetGroupMessage & __MetadataBearer; +/** + *

Returns a list of cache subnet group + * descriptions. If a subnet group name is specified, the list contains only the + * description of that group. This is applicable only when you have ElastiCache in VPC setup. All ElastiCache clusters now launch in VPC by default. + *

+ */ export class DescribeCacheSubnetGroupsCommand extends $Command< DescribeCacheSubnetGroupsCommandInput, DescribeCacheSubnetGroupsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeCacheSubnetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeEngineDefaultParametersCommand.ts b/clients/client-elasticache/commands/DescribeEngineDefaultParametersCommand.ts index 53c4844d1599a..327ef1312d4c2 100644 --- a/clients/client-elasticache/commands/DescribeEngineDefaultParametersCommand.ts +++ b/clients/client-elasticache/commands/DescribeEngineDefaultParametersCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEngineDefaultParametersCommandInput = DescribeEngineDefaultParametersMessage; export type DescribeEngineDefaultParametersCommandOutput = DescribeEngineDefaultParametersResult & __MetadataBearer; +/** + *

Returns the default engine and + * system parameter information for the specified cache engine.

+ */ export class DescribeEngineDefaultParametersCommand extends $Command< DescribeEngineDefaultParametersCommandInput, DescribeEngineDefaultParametersCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEngineDefaultParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeEventsCommand.ts b/clients/client-elasticache/commands/DescribeEventsCommand.ts index 23af9e2358510..a578b191e6951 100644 --- a/clients/client-elasticache/commands/DescribeEventsCommand.ts +++ b/clients/client-elasticache/commands/DescribeEventsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeEventsCommandInput = DescribeEventsMessage; export type DescribeEventsCommandOutput = EventsMessage & __MetadataBearer; +/** + *

Returns events related to clusters, cache + * security groups, and cache parameter groups. You can obtain events specific to a + * particular cluster, cache security group, or cache parameter group by providing + * the name as a parameter.

+ *

By default, only the events occurring within the last hour are returned; + * however, you can retrieve up to 14 days' worth of events if necessary.

+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeGlobalReplicationGroupsCommand.ts b/clients/client-elasticache/commands/DescribeGlobalReplicationGroupsCommand.ts index c1ee77f06251d..ddd6a3b98a14e 100644 --- a/clients/client-elasticache/commands/DescribeGlobalReplicationGroupsCommand.ts +++ b/clients/client-elasticache/commands/DescribeGlobalReplicationGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeGlobalReplicationGroupsCommandInput = DescribeGlobalReplicationGroupsMessage; export type DescribeGlobalReplicationGroupsCommandOutput = DescribeGlobalReplicationGroupsResult & __MetadataBearer; +/** + *

Returns information about a particular global replication group. If no identifier is specified, returns information about all Global Datastores.

+ */ export class DescribeGlobalReplicationGroupsCommand extends $Command< DescribeGlobalReplicationGroupsCommandInput, DescribeGlobalReplicationGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeGlobalReplicationGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeReplicationGroupsCommand.ts b/clients/client-elasticache/commands/DescribeReplicationGroupsCommand.ts index b5c7442e36805..44de96e87ff98 100644 --- a/clients/client-elasticache/commands/DescribeReplicationGroupsCommand.ts +++ b/clients/client-elasticache/commands/DescribeReplicationGroupsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeReplicationGroupsCommandInput = DescribeReplicationGroupsMessage; export type DescribeReplicationGroupsCommandOutput = ReplicationGroupMessage & __MetadataBearer; +/** + *

Returns information about a particular + * replication group. If no identifier is specified, DescribeReplicationGroups + * returns information about all replication groups.

+ * + *

This operation is valid for Redis only.

+ *
+ */ export class DescribeReplicationGroupsCommand extends $Command< DescribeReplicationGroupsCommandInput, DescribeReplicationGroupsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeReplicationGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeReservedCacheNodesCommand.ts b/clients/client-elasticache/commands/DescribeReservedCacheNodesCommand.ts index 2ba80078330b5..90c41d91928d2 100644 --- a/clients/client-elasticache/commands/DescribeReservedCacheNodesCommand.ts +++ b/clients/client-elasticache/commands/DescribeReservedCacheNodesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeReservedCacheNodesCommandInput = DescribeReservedCacheNodesMessage; export type DescribeReservedCacheNodesCommandOutput = ReservedCacheNodeMessage & __MetadataBearer; +/** + *

Returns information about reserved cache + * nodes for this account, or about a specified reserved cache node.

+ */ export class DescribeReservedCacheNodesCommand extends $Command< DescribeReservedCacheNodesCommandInput, DescribeReservedCacheNodesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeReservedCacheNodesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeReservedCacheNodesOfferingsCommand.ts b/clients/client-elasticache/commands/DescribeReservedCacheNodesOfferingsCommand.ts index 6c5cfc7939c7b..40d2b6f940fb7 100644 --- a/clients/client-elasticache/commands/DescribeReservedCacheNodesOfferingsCommand.ts +++ b/clients/client-elasticache/commands/DescribeReservedCacheNodesOfferingsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeReservedCacheNodesOfferingsCommandInput = DescribeReservedCacheNodesOfferingsMessage; export type DescribeReservedCacheNodesOfferingsCommandOutput = ReservedCacheNodesOfferingMessage & __MetadataBearer; +/** + *

Lists available reserved cache + * node offerings.

+ */ export class DescribeReservedCacheNodesOfferingsCommand extends $Command< DescribeReservedCacheNodesOfferingsCommandInput, DescribeReservedCacheNodesOfferingsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeReservedCacheNodesOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeServiceUpdatesCommand.ts b/clients/client-elasticache/commands/DescribeServiceUpdatesCommand.ts index 4b2ad53fcc2ee..bb9a666a6685c 100644 --- a/clients/client-elasticache/commands/DescribeServiceUpdatesCommand.ts +++ b/clients/client-elasticache/commands/DescribeServiceUpdatesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeServiceUpdatesCommandInput = DescribeServiceUpdatesMessage; export type DescribeServiceUpdatesCommandOutput = ServiceUpdatesMessage & __MetadataBearer; +/** + *

Returns details of the service updates

+ */ export class DescribeServiceUpdatesCommand extends $Command< DescribeServiceUpdatesCommandInput, DescribeServiceUpdatesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeServiceUpdatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeSnapshotsCommand.ts b/clients/client-elasticache/commands/DescribeSnapshotsCommand.ts index 33690acb71f6f..c5932edcb4439 100644 --- a/clients/client-elasticache/commands/DescribeSnapshotsCommand.ts +++ b/clients/client-elasticache/commands/DescribeSnapshotsCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeSnapshotsCommandInput = DescribeSnapshotsMessage; export type DescribeSnapshotsCommandOutput = DescribeSnapshotsListMessage & __MetadataBearer; +/** + *

Returns information about cluster or replication group snapshots. + * By default, DescribeSnapshots lists all of your snapshots; it can optionally + * describe a single snapshot, or just the snapshots associated with a particular cache + * cluster.

+ * + * + *

This operation is valid for Redis only.

+ *
+ */ export class DescribeSnapshotsCommand extends $Command< DescribeSnapshotsCommandInput, DescribeSnapshotsCommandOutput, @@ -34,6 +44,9 @@ export class DescribeSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeUpdateActionsCommand.ts b/clients/client-elasticache/commands/DescribeUpdateActionsCommand.ts index c140cd96e9bb1..b94858cb18905 100644 --- a/clients/client-elasticache/commands/DescribeUpdateActionsCommand.ts +++ b/clients/client-elasticache/commands/DescribeUpdateActionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUpdateActionsCommandInput = DescribeUpdateActionsMessage; export type DescribeUpdateActionsCommandOutput = UpdateActionsMessage & __MetadataBearer; +/** + *

Returns details of the update actions

+ */ export class DescribeUpdateActionsCommand extends $Command< DescribeUpdateActionsCommandInput, DescribeUpdateActionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUpdateActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeUserGroupsCommand.ts b/clients/client-elasticache/commands/DescribeUserGroupsCommand.ts index e83ec6d78b468..1d353ebd96f7d 100644 --- a/clients/client-elasticache/commands/DescribeUserGroupsCommand.ts +++ b/clients/client-elasticache/commands/DescribeUserGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserGroupsCommandInput = DescribeUserGroupsMessage; export type DescribeUserGroupsCommandOutput = DescribeUserGroupsResult & __MetadataBearer; +/** + *

Returns a list of user groups.

+ */ export class DescribeUserGroupsCommand extends $Command< DescribeUserGroupsCommandInput, DescribeUserGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DescribeUsersCommand.ts b/clients/client-elasticache/commands/DescribeUsersCommand.ts index 8e313f05bf315..73e22365ac701 100644 --- a/clients/client-elasticache/commands/DescribeUsersCommand.ts +++ b/clients/client-elasticache/commands/DescribeUsersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUsersCommandInput = DescribeUsersMessage; export type DescribeUsersCommandOutput = DescribeUsersResult & __MetadataBearer; +/** + *

Returns a list of users.

+ */ export class DescribeUsersCommand extends $Command< DescribeUsersCommandInput, DescribeUsersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/DisassociateGlobalReplicationGroupCommand.ts b/clients/client-elasticache/commands/DisassociateGlobalReplicationGroupCommand.ts index ec5db7cb5402b..f662c7978a256 100644 --- a/clients/client-elasticache/commands/DisassociateGlobalReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/DisassociateGlobalReplicationGroupCommand.ts @@ -24,6 +24,9 @@ export type DisassociateGlobalReplicationGroupCommandInput = DisassociateGlobalR export type DisassociateGlobalReplicationGroupCommandOutput = DisassociateGlobalReplicationGroupResult & __MetadataBearer; +/** + *

Remove a secondary cluster from the Global Datastore using the Global Datastore name. The secondary cluster will no longer receive updates from the primary cluster, but will remain as a standalone cluster in that AWS region.

+ */ export class DisassociateGlobalReplicationGroupCommand extends $Command< DisassociateGlobalReplicationGroupCommandInput, DisassociateGlobalReplicationGroupCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateGlobalReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/FailoverGlobalReplicationGroupCommand.ts b/clients/client-elasticache/commands/FailoverGlobalReplicationGroupCommand.ts index 47610855dd0da..515df4dbc2f8a 100644 --- a/clients/client-elasticache/commands/FailoverGlobalReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/FailoverGlobalReplicationGroupCommand.ts @@ -20,6 +20,9 @@ import { export type FailoverGlobalReplicationGroupCommandInput = FailoverGlobalReplicationGroupMessage; export type FailoverGlobalReplicationGroupCommandOutput = FailoverGlobalReplicationGroupResult & __MetadataBearer; +/** + *

Used to failover the primary region to a selected secondary region. The selected secondary region will become primary, and all other clusters will become secondary.

+ */ export class FailoverGlobalReplicationGroupCommand extends $Command< FailoverGlobalReplicationGroupCommandInput, FailoverGlobalReplicationGroupCommandOutput, @@ -34,6 +37,9 @@ export class FailoverGlobalReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/IncreaseNodeGroupsInGlobalReplicationGroupCommand.ts b/clients/client-elasticache/commands/IncreaseNodeGroupsInGlobalReplicationGroupCommand.ts index ecb9ca4a01396..475ff359bdbcc 100644 --- a/clients/client-elasticache/commands/IncreaseNodeGroupsInGlobalReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/IncreaseNodeGroupsInGlobalReplicationGroupCommand.ts @@ -24,6 +24,9 @@ export type IncreaseNodeGroupsInGlobalReplicationGroupCommandInput = IncreaseNod export type IncreaseNodeGroupsInGlobalReplicationGroupCommandOutput = IncreaseNodeGroupsInGlobalReplicationGroupResult & __MetadataBearer; +/** + *

Increase the number of node groups in the Global Datastore

+ */ export class IncreaseNodeGroupsInGlobalReplicationGroupCommand extends $Command< IncreaseNodeGroupsInGlobalReplicationGroupCommandInput, IncreaseNodeGroupsInGlobalReplicationGroupCommandOutput, @@ -38,6 +41,9 @@ export class IncreaseNodeGroupsInGlobalReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/IncreaseReplicaCountCommand.ts b/clients/client-elasticache/commands/IncreaseReplicaCountCommand.ts index e2716aca14ef0..8c9320be5acc0 100644 --- a/clients/client-elasticache/commands/IncreaseReplicaCountCommand.ts +++ b/clients/client-elasticache/commands/IncreaseReplicaCountCommand.ts @@ -20,6 +20,11 @@ import { export type IncreaseReplicaCountCommandInput = IncreaseReplicaCountMessage; export type IncreaseReplicaCountCommandOutput = IncreaseReplicaCountResult & __MetadataBearer; +/** + *

Dynamically increases the number of replics in a Redis (cluster mode disabled) replication group or the number of + * replica nodes in one or more node groups (shards) of a Redis (cluster mode enabled) replication group. This operation + * is performed with no cluster down time.

+ */ export class IncreaseReplicaCountCommand extends $Command< IncreaseReplicaCountCommandInput, IncreaseReplicaCountCommandOutput, @@ -34,6 +39,9 @@ export class IncreaseReplicaCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ListAllowedNodeTypeModificationsCommand.ts b/clients/client-elasticache/commands/ListAllowedNodeTypeModificationsCommand.ts index 87ac05d556b8d..b2726931e8575 100644 --- a/clients/client-elasticache/commands/ListAllowedNodeTypeModificationsCommand.ts +++ b/clients/client-elasticache/commands/ListAllowedNodeTypeModificationsCommand.ts @@ -20,6 +20,14 @@ import { export type ListAllowedNodeTypeModificationsCommandInput = ListAllowedNodeTypeModificationsMessage; export type ListAllowedNodeTypeModificationsCommandOutput = AllowedNodeTypeModificationsMessage & __MetadataBearer; +/** + *

Lists all available node types that you + * can scale your Redis cluster's or replication group's current node type.

+ * + *

When you use the ModifyCacheCluster or ModifyReplicationGroup operations to + * scale your cluster or replication group, the value of the CacheNodeType parameter + * must be one of the node types returned by this operation.

+ */ export class ListAllowedNodeTypeModificationsCommand extends $Command< ListAllowedNodeTypeModificationsCommandInput, ListAllowedNodeTypeModificationsCommandOutput, @@ -34,6 +42,9 @@ export class ListAllowedNodeTypeModificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ListTagsForResourceCommand.ts b/clients/client-elasticache/commands/ListTagsForResourceCommand.ts index d48fa03631e8a..cb9cf89451878 100644 --- a/clients/client-elasticache/commands/ListTagsForResourceCommand.ts +++ b/clients/client-elasticache/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,16 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceMessage; export type ListTagsForResourceCommandOutput = TagListMessage & __MetadataBearer; +/** + *

Lists all cost allocation tags currently on the named resource. + * A cost allocation tag is a key-value pair where the key is case-sensitive and the value is optional. + * You can use cost allocation tags to categorize and track your AWS costs.

+ *

If the cluster is not in the available state, ListTagsForResource + * returns an error.

+ * + *

You can have a maximum of 50 cost allocation tags on an ElastiCache resource. + * For more information, see Monitoring Costs with Tags.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +44,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ModifyCacheClusterCommand.ts b/clients/client-elasticache/commands/ModifyCacheClusterCommand.ts index 588cd1c8bd1a7..72e11e192acda 100644 --- a/clients/client-elasticache/commands/ModifyCacheClusterCommand.ts +++ b/clients/client-elasticache/commands/ModifyCacheClusterCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyCacheClusterCommandInput = ModifyCacheClusterMessage; export type ModifyCacheClusterCommandOutput = ModifyCacheClusterResult & __MetadataBearer; +/** + *

Modifies the settings for a cluster. You + * can use this operation to change one or more cluster configuration parameters by + * specifying the parameters and the new values.

+ */ export class ModifyCacheClusterCommand extends $Command< ModifyCacheClusterCommandInput, ModifyCacheClusterCommandOutput, @@ -34,6 +39,9 @@ export class ModifyCacheClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ModifyCacheParameterGroupCommand.ts b/clients/client-elasticache/commands/ModifyCacheParameterGroupCommand.ts index 7c0ad9e5d3f7b..793dfea1722e8 100644 --- a/clients/client-elasticache/commands/ModifyCacheParameterGroupCommand.ts +++ b/clients/client-elasticache/commands/ModifyCacheParameterGroupCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyCacheParameterGroupCommandInput = ModifyCacheParameterGroupMessage; export type ModifyCacheParameterGroupCommandOutput = CacheParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a cache + * parameter group. You can modify up to 20 parameters in a single request by submitting a + * list parameter name and value pairs.

+ */ export class ModifyCacheParameterGroupCommand extends $Command< ModifyCacheParameterGroupCommandInput, ModifyCacheParameterGroupCommandOutput, @@ -34,6 +39,9 @@ export class ModifyCacheParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ModifyCacheSubnetGroupCommand.ts b/clients/client-elasticache/commands/ModifyCacheSubnetGroupCommand.ts index 888bad582d87f..df3ae2c2c6c1a 100644 --- a/clients/client-elasticache/commands/ModifyCacheSubnetGroupCommand.ts +++ b/clients/client-elasticache/commands/ModifyCacheSubnetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyCacheSubnetGroupCommandInput = ModifyCacheSubnetGroupMessage; export type ModifyCacheSubnetGroupCommandOutput = ModifyCacheSubnetGroupResult & __MetadataBearer; +/** + *

Modifies an existing cache subnet group.

+ */ export class ModifyCacheSubnetGroupCommand extends $Command< ModifyCacheSubnetGroupCommandInput, ModifyCacheSubnetGroupCommandOutput, @@ -34,6 +37,9 @@ export class ModifyCacheSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ModifyGlobalReplicationGroupCommand.ts b/clients/client-elasticache/commands/ModifyGlobalReplicationGroupCommand.ts index f53c23f5a88b8..1e6c4186a169c 100644 --- a/clients/client-elasticache/commands/ModifyGlobalReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/ModifyGlobalReplicationGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyGlobalReplicationGroupCommandInput = ModifyGlobalReplicationGroupMessage; export type ModifyGlobalReplicationGroupCommandOutput = ModifyGlobalReplicationGroupResult & __MetadataBearer; +/** + *

Modifies the settings for a Global Datastore.

+ */ export class ModifyGlobalReplicationGroupCommand extends $Command< ModifyGlobalReplicationGroupCommandInput, ModifyGlobalReplicationGroupCommandOutput, @@ -34,6 +37,9 @@ export class ModifyGlobalReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ModifyReplicationGroupCommand.ts b/clients/client-elasticache/commands/ModifyReplicationGroupCommand.ts index 9b62977d2299f..37b24b0ddcdac 100644 --- a/clients/client-elasticache/commands/ModifyReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/ModifyReplicationGroupCommand.ts @@ -20,6 +20,25 @@ import { export type ModifyReplicationGroupCommandInput = ModifyReplicationGroupMessage; export type ModifyReplicationGroupCommandOutput = ModifyReplicationGroupResult & __MetadataBearer; +/** + *

Modifies the settings for a replication group.

+ * + * + * + *

This operation is valid for Redis only.

+ *
+ */ export class ModifyReplicationGroupCommand extends $Command< ModifyReplicationGroupCommandInput, ModifyReplicationGroupCommandOutput, @@ -34,6 +53,9 @@ export class ModifyReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ModifyReplicationGroupShardConfigurationCommand.ts b/clients/client-elasticache/commands/ModifyReplicationGroupShardConfigurationCommand.ts index 8f70a40333b70..6920bb79471f1 100644 --- a/clients/client-elasticache/commands/ModifyReplicationGroupShardConfigurationCommand.ts +++ b/clients/client-elasticache/commands/ModifyReplicationGroupShardConfigurationCommand.ts @@ -24,6 +24,10 @@ export type ModifyReplicationGroupShardConfigurationCommandInput = ModifyReplica export type ModifyReplicationGroupShardConfigurationCommandOutput = ModifyReplicationGroupShardConfigurationResult & __MetadataBearer; +/** + *

Modifies a replication group's shards (node groups) by allowing you to + * add shards, remove shards, or rebalance the keyspaces among exisiting shards.

+ */ export class ModifyReplicationGroupShardConfigurationCommand extends $Command< ModifyReplicationGroupShardConfigurationCommandInput, ModifyReplicationGroupShardConfigurationCommandOutput, @@ -38,6 +42,9 @@ export class ModifyReplicationGroupShardConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ModifyUserCommand.ts b/clients/client-elasticache/commands/ModifyUserCommand.ts index 1a77c4c688a45..358f586dcc45a 100644 --- a/clients/client-elasticache/commands/ModifyUserCommand.ts +++ b/clients/client-elasticache/commands/ModifyUserCommand.ts @@ -17,6 +17,9 @@ import { export type ModifyUserCommandInput = ModifyUserMessage; export type ModifyUserCommandOutput = User & __MetadataBearer; +/** + *

Changes user password(s) and/or access string.

+ */ export class ModifyUserCommand extends $Command< ModifyUserCommandInput, ModifyUserCommandOutput, @@ -31,6 +34,9 @@ export class ModifyUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ModifyUserGroupCommand.ts b/clients/client-elasticache/commands/ModifyUserGroupCommand.ts index a096dbc7ffcb1..505a7b6dd1a23 100644 --- a/clients/client-elasticache/commands/ModifyUserGroupCommand.ts +++ b/clients/client-elasticache/commands/ModifyUserGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyUserGroupCommandInput = ModifyUserGroupMessage; export type ModifyUserGroupCommandOutput = UserGroup & __MetadataBearer; +/** + *

Changes the list of users that belong to the user group.

+ */ export class ModifyUserGroupCommand extends $Command< ModifyUserGroupCommandInput, ModifyUserGroupCommandOutput, @@ -34,6 +37,9 @@ export class ModifyUserGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/PurchaseReservedCacheNodesOfferingCommand.ts b/clients/client-elasticache/commands/PurchaseReservedCacheNodesOfferingCommand.ts index 5f7530dfe952b..b0626ae252a02 100644 --- a/clients/client-elasticache/commands/PurchaseReservedCacheNodesOfferingCommand.ts +++ b/clients/client-elasticache/commands/PurchaseReservedCacheNodesOfferingCommand.ts @@ -24,6 +24,10 @@ export type PurchaseReservedCacheNodesOfferingCommandInput = PurchaseReservedCac export type PurchaseReservedCacheNodesOfferingCommandOutput = PurchaseReservedCacheNodesOfferingResult & __MetadataBearer; +/** + *

Allows you to purchase a reserved + * cache node offering.

+ */ export class PurchaseReservedCacheNodesOfferingCommand extends $Command< PurchaseReservedCacheNodesOfferingCommandInput, PurchaseReservedCacheNodesOfferingCommandOutput, @@ -38,6 +42,9 @@ export class PurchaseReservedCacheNodesOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/RebalanceSlotsInGlobalReplicationGroupCommand.ts b/clients/client-elasticache/commands/RebalanceSlotsInGlobalReplicationGroupCommand.ts index c4bb227d81dfa..715bc27b4bca0 100644 --- a/clients/client-elasticache/commands/RebalanceSlotsInGlobalReplicationGroupCommand.ts +++ b/clients/client-elasticache/commands/RebalanceSlotsInGlobalReplicationGroupCommand.ts @@ -24,6 +24,9 @@ export type RebalanceSlotsInGlobalReplicationGroupCommandInput = RebalanceSlotsI export type RebalanceSlotsInGlobalReplicationGroupCommandOutput = RebalanceSlotsInGlobalReplicationGroupResult & __MetadataBearer; +/** + *

Redistribute slots to ensure uniform distribution across existing shards in the cluster.

+ */ export class RebalanceSlotsInGlobalReplicationGroupCommand extends $Command< RebalanceSlotsInGlobalReplicationGroupCommandInput, RebalanceSlotsInGlobalReplicationGroupCommandOutput, @@ -38,6 +41,9 @@ export class RebalanceSlotsInGlobalReplicationGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/RebootCacheClusterCommand.ts b/clients/client-elasticache/commands/RebootCacheClusterCommand.ts index 4937532cac0a5..0917b8c042815 100644 --- a/clients/client-elasticache/commands/RebootCacheClusterCommand.ts +++ b/clients/client-elasticache/commands/RebootCacheClusterCommand.ts @@ -20,6 +20,21 @@ import { export type RebootCacheClusterCommandInput = RebootCacheClusterMessage; export type RebootCacheClusterCommandOutput = RebootCacheClusterResult & __MetadataBearer; +/** + *

Reboots some, or all, of the cache nodes + * within a provisioned cluster. This operation applies any modified cache parameter + * groups to the cluster. The reboot operation takes place as soon as possible, and + * results in a momentary outage to the cluster. During the reboot, the cluster + * status is set to REBOOTING.

+ *

The reboot causes the contents of the cache (for each cache node being rebooted) to be lost.

+ *

When the reboot is complete, a cluster event is created.

+ * + *

Rebooting a cluster is currently supported on Memcached and Redis (cluster mode disabled) clusters. + * Rebooting is not supported on Redis (cluster mode enabled) clusters.

+ * + *

If you make changes to parameters that require a Redis (cluster mode enabled) cluster reboot for the changes to be applied, + * see Rebooting a Cluster for an alternate process.

+ */ export class RebootCacheClusterCommand extends $Command< RebootCacheClusterCommandInput, RebootCacheClusterCommandOutput, @@ -34,6 +49,9 @@ export class RebootCacheClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/RemoveTagsFromResourceCommand.ts b/clients/client-elasticache/commands/RemoveTagsFromResourceCommand.ts index c09d32fa42980..1051e1aba631e 100644 --- a/clients/client-elasticache/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-elasticache/commands/RemoveTagsFromResourceCommand.ts @@ -20,6 +20,10 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceMessage; export type RemoveTagsFromResourceCommandOutput = TagListMessage & __MetadataBearer; +/** + *

Removes the tags identified by the TagKeys + * list from the named resource.

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -34,6 +38,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/ResetCacheParameterGroupCommand.ts b/clients/client-elasticache/commands/ResetCacheParameterGroupCommand.ts index fc39301a6607d..683b7c4e7422a 100644 --- a/clients/client-elasticache/commands/ResetCacheParameterGroupCommand.ts +++ b/clients/client-elasticache/commands/ResetCacheParameterGroupCommand.ts @@ -20,6 +20,12 @@ import { export type ResetCacheParameterGroupCommandInput = ResetCacheParameterGroupMessage; export type ResetCacheParameterGroupCommandOutput = CacheParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a cache + * parameter group to the engine or system default value. You can reset specific parameters + * by submitting a list of parameter names. To reset the entire cache parameter group, + * specify the ResetAllParameters and CacheParameterGroupName parameters.

+ */ export class ResetCacheParameterGroupCommand extends $Command< ResetCacheParameterGroupCommandInput, ResetCacheParameterGroupCommandOutput, @@ -34,6 +40,9 @@ export class ResetCacheParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/RevokeCacheSecurityGroupIngressCommand.ts b/clients/client-elasticache/commands/RevokeCacheSecurityGroupIngressCommand.ts index 9c522bbf954c4..c3b25b3cb4747 100644 --- a/clients/client-elasticache/commands/RevokeCacheSecurityGroupIngressCommand.ts +++ b/clients/client-elasticache/commands/RevokeCacheSecurityGroupIngressCommand.ts @@ -20,6 +20,11 @@ import { export type RevokeCacheSecurityGroupIngressCommandInput = RevokeCacheSecurityGroupIngressMessage; export type RevokeCacheSecurityGroupIngressCommandOutput = RevokeCacheSecurityGroupIngressResult & __MetadataBearer; +/** + *

Revokes ingress from a cache security group. + * Use this operation to disallow access from an Amazon EC2 security group + * that had been previously authorized.

+ */ export class RevokeCacheSecurityGroupIngressCommand extends $Command< RevokeCacheSecurityGroupIngressCommandInput, RevokeCacheSecurityGroupIngressCommandOutput, @@ -34,6 +39,9 @@ export class RevokeCacheSecurityGroupIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/StartMigrationCommand.ts b/clients/client-elasticache/commands/StartMigrationCommand.ts index 353b15faf74ff..c01416af841f2 100644 --- a/clients/client-elasticache/commands/StartMigrationCommand.ts +++ b/clients/client-elasticache/commands/StartMigrationCommand.ts @@ -20,6 +20,9 @@ import { export type StartMigrationCommandInput = StartMigrationMessage; export type StartMigrationCommandOutput = StartMigrationResponse & __MetadataBearer; +/** + *

Start the migration of data.

+ */ export class StartMigrationCommand extends $Command< StartMigrationCommandInput, StartMigrationCommandOutput, @@ -34,6 +37,9 @@ export class StartMigrationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/commands/TestFailoverCommand.ts b/clients/client-elasticache/commands/TestFailoverCommand.ts index 9b6e932075e8c..fcd092e557914 100644 --- a/clients/client-elasticache/commands/TestFailoverCommand.ts +++ b/clients/client-elasticache/commands/TestFailoverCommand.ts @@ -17,6 +17,71 @@ import { export type TestFailoverCommandInput = TestFailoverMessage; export type TestFailoverCommandOutput = TestFailoverResult & __MetadataBearer; +/** + *

Represents the input of a TestFailover operation which test automatic failover on + * a specified node group (called shard in the console) in a replication group (called cluster in the console).

+ * + *

+ * Note the following + *

+ *
    + *
  • + *

    A customer can use this operation to test automatic failover on up to 5 shards (called node groups in the ElastiCache API and AWS CLI) + * in any rolling 24-hour period.

    + *
  • + *
  • + *

    If calling this operation on shards in different clusters (called replication groups in the API and CLI), the calls can be made concurrently.

    + *

    + *
  • + *
  • + *

    If calling this operation multiple times on different shards in the same Redis (cluster mode enabled) replication group, + * the first node replacement must complete before a subsequent call can be made.

    + *
  • + *
  • + *

    To determine whether the node replacement is complete you can check Events using the Amazon ElastiCache console, + * the AWS CLI, or the ElastiCache API. + * Look for the following automatic failover related events, listed here in order of occurrance:

    + *
      + *
    1. + *

      Replication group message: Test Failover API called for node group + *

      + *
    2. + *
    3. + *

      Cache cluster message: Failover from primary node to replica node completed + *

      + *
    4. + *
    5. + *

      Replication group message: Failover from primary node to replica node completed + *

      + *
    6. + *
    7. + *

      Cache cluster message: Recovering cache nodes + *

      + *
    8. + *
    9. + *

      Cache cluster message: Finished recovery for cache nodes + *

      + *
    10. + *
    + * + *

    For more information see:

    + * + *
  • + *
+ * + *

Also see, Testing Multi-AZ in the ElastiCache User Guide.

+ */ export class TestFailoverCommand extends $Command< TestFailoverCommandInput, TestFailoverCommandOutput, @@ -31,6 +96,9 @@ export class TestFailoverCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElastiCacheClientResolvedConfig, diff --git a/clients/client-elasticache/package.json b/clients/client-elasticache/package.json index 8a4cc9a92cec9..46f7500e3a692 100644 --- a/clients/client-elasticache/package.json +++ b/clients/client-elasticache/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Elasticache Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-elasticache/pagination/DescribeCacheClustersPaginator.ts b/clients/client-elasticache/pagination/DescribeCacheClustersPaginator.ts index 0c44688222efd..09a496bb30101 100644 --- a/clients/client-elasticache/pagination/DescribeCacheClustersPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeCacheClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeCacheClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCacheClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeCacheClustersCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeCacheEngineVersionsPaginator.ts b/clients/client-elasticache/pagination/DescribeCacheEngineVersionsPaginator.ts index 5bdf804e17399..6f73db1d90f29 100644 --- a/clients/client-elasticache/pagination/DescribeCacheEngineVersionsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeCacheEngineVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeCacheEngineVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCacheEngineVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeCacheEngineVersionsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeCacheParameterGroupsPaginator.ts b/clients/client-elasticache/pagination/DescribeCacheParameterGroupsPaginator.ts index cf943a96f1a70..28f8978113715 100644 --- a/clients/client-elasticache/pagination/DescribeCacheParameterGroupsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeCacheParameterGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeCacheParameterGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCacheParameterGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeCacheParameterGroupsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeCacheParametersPaginator.ts b/clients/client-elasticache/pagination/DescribeCacheParametersPaginator.ts index d4e4eb17e6ac8..5f25bdc68fa98 100644 --- a/clients/client-elasticache/pagination/DescribeCacheParametersPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeCacheParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeCacheParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCacheParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeCacheParametersCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeCacheSecurityGroupsPaginator.ts b/clients/client-elasticache/pagination/DescribeCacheSecurityGroupsPaginator.ts index 9d36aa5aac5d8..160d8c69dbe3c 100644 --- a/clients/client-elasticache/pagination/DescribeCacheSecurityGroupsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeCacheSecurityGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeCacheSecurityGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCacheSecurityGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeCacheSecurityGroupsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeCacheSubnetGroupsPaginator.ts b/clients/client-elasticache/pagination/DescribeCacheSubnetGroupsPaginator.ts index 971a9c84c46fe..4e4354339bd91 100644 --- a/clients/client-elasticache/pagination/DescribeCacheSubnetGroupsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeCacheSubnetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeCacheSubnetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCacheSubnetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeCacheSubnetGroupsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeEngineDefaultParametersPaginator.ts b/clients/client-elasticache/pagination/DescribeEngineDefaultParametersPaginator.ts index 6ccd65c148ebd..6725e0882e6a1 100644 --- a/clients/client-elasticache/pagination/DescribeEngineDefaultParametersPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeEngineDefaultParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeEngineDefaultParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEngineDefaultParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeEngineDefaultParametersCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeEventsPaginator.ts b/clients/client-elasticache/pagination/DescribeEventsPaginator.ts index d5e668bacc1e4..946330ea7dd54 100644 --- a/clients/client-elasticache/pagination/DescribeEventsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeEventsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeGlobalReplicationGroupsPaginator.ts b/clients/client-elasticache/pagination/DescribeGlobalReplicationGroupsPaginator.ts index 7688d4f26344e..4c77daa168096 100644 --- a/clients/client-elasticache/pagination/DescribeGlobalReplicationGroupsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeGlobalReplicationGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeGlobalReplicationGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeGlobalReplicationGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeGlobalReplicationGroupsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeReplicationGroupsPaginator.ts b/clients/client-elasticache/pagination/DescribeReplicationGroupsPaginator.ts index fd4f12452cfeb..694be89ed7e26 100644 --- a/clients/client-elasticache/pagination/DescribeReplicationGroupsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeReplicationGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeReplicationGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReplicationGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeReplicationGroupsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeReservedCacheNodesOfferingsPaginator.ts b/clients/client-elasticache/pagination/DescribeReservedCacheNodesOfferingsPaginator.ts index e3a20ffc05530..0661f036eb06a 100644 --- a/clients/client-elasticache/pagination/DescribeReservedCacheNodesOfferingsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeReservedCacheNodesOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeReservedCacheNodesOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedCacheNodesOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeReservedCacheNodesOfferingsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeReservedCacheNodesPaginator.ts b/clients/client-elasticache/pagination/DescribeReservedCacheNodesPaginator.ts index 91f39ebcd76bc..ce9883c5111ec 100644 --- a/clients/client-elasticache/pagination/DescribeReservedCacheNodesPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeReservedCacheNodesPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeReservedCacheNodesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedCacheNodesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeReservedCacheNodesCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeServiceUpdatesPaginator.ts b/clients/client-elasticache/pagination/DescribeServiceUpdatesPaginator.ts index 4e307a71faf4b..51198ad620665 100644 --- a/clients/client-elasticache/pagination/DescribeServiceUpdatesPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeServiceUpdatesPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeServiceUpdatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeServiceUpdatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeServiceUpdatesCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeSnapshotsPaginator.ts b/clients/client-elasticache/pagination/DescribeSnapshotsPaginator.ts index 136fc4d4cbd83..e4fa35b23fa65 100644 --- a/clients/client-elasticache/pagination/DescribeSnapshotsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeSnapshotsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeSnapshotsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSnapshotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeSnapshotsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeUpdateActionsPaginator.ts b/clients/client-elasticache/pagination/DescribeUpdateActionsPaginator.ts index f1d90846e9813..04dc41a137ca4 100644 --- a/clients/client-elasticache/pagination/DescribeUpdateActionsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeUpdateActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeUpdateActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeUpdateActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeUpdateActionsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeUserGroupsPaginator.ts b/clients/client-elasticache/pagination/DescribeUserGroupsPaginator.ts index 589d7cb60e849..94c1d51797733 100644 --- a/clients/client-elasticache/pagination/DescribeUserGroupsPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeUserGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeUserGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeUserGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeUserGroupsCommandInput, diff --git a/clients/client-elasticache/pagination/DescribeUsersPaginator.ts b/clients/client-elasticache/pagination/DescribeUsersPaginator.ts index 375e5be886285..a1fb03855fe72 100644 --- a/clients/client-elasticache/pagination/DescribeUsersPaginator.ts +++ b/clients/client-elasticache/pagination/DescribeUsersPaginator.ts @@ -8,6 +8,9 @@ import { import { ElastiCachePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElastiCacheClient, input: DescribeUsersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElastiCache, input: DescribeUsersCommandInput, diff --git a/clients/client-elasticache/runtimeConfig.browser.ts b/clients/client-elasticache/runtimeConfig.browser.ts index 584572ff92d0b..1ae5b8f0e5035 100644 --- a/clients/client-elasticache/runtimeConfig.browser.ts +++ b/clients/client-elasticache/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ElastiCacheClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-elasticache/runtimeConfig.native.ts b/clients/client-elasticache/runtimeConfig.native.ts index 7dc6f8a79a8d5..8e7ad69a6ef2a 100644 --- a/clients/client-elasticache/runtimeConfig.native.ts +++ b/clients/client-elasticache/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ElastiCacheClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-elasticache/runtimeConfig.shared.ts b/clients/client-elasticache/runtimeConfig.shared.ts index cb58364907bde..53379af31787f 100644 --- a/clients/client-elasticache/runtimeConfig.shared.ts +++ b/clients/client-elasticache/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-02-02", disableHostPrefix: false, diff --git a/clients/client-elasticache/runtimeConfig.ts b/clients/client-elasticache/runtimeConfig.ts index 84de7fc02db62..a16e31a99c422 100644 --- a/clients/client-elasticache/runtimeConfig.ts +++ b/clients/client-elasticache/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ElastiCacheClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-elasticache/tsconfig.json b/clients/client-elasticache/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-elasticache/tsconfig.json +++ b/clients/client-elasticache/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-elasticsearch-service/commands/AcceptInboundCrossClusterSearchConnectionCommand.ts b/clients/client-elasticsearch-service/commands/AcceptInboundCrossClusterSearchConnectionCommand.ts index 71e32b59bf372..6807371956ce3 100644 --- a/clients/client-elasticsearch-service/commands/AcceptInboundCrossClusterSearchConnectionCommand.ts +++ b/clients/client-elasticsearch-service/commands/AcceptInboundCrossClusterSearchConnectionCommand.ts @@ -28,6 +28,9 @@ export type AcceptInboundCrossClusterSearchConnectionCommandInput = AcceptInboun export type AcceptInboundCrossClusterSearchConnectionCommandOutput = AcceptInboundCrossClusterSearchConnectionResponse & __MetadataBearer; +/** + *

Allows the destination domain owner to accept an inbound cross-cluster search connection request.

+ */ export class AcceptInboundCrossClusterSearchConnectionCommand extends $Command< AcceptInboundCrossClusterSearchConnectionCommandInput, AcceptInboundCrossClusterSearchConnectionCommandOutput, @@ -42,6 +45,9 @@ export class AcceptInboundCrossClusterSearchConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/AddTagsCommand.ts b/clients/client-elasticsearch-service/commands/AddTagsCommand.ts index e1969d535f665..d2cf1ecad0a36 100644 --- a/clients/client-elasticsearch-service/commands/AddTagsCommand.ts +++ b/clients/client-elasticsearch-service/commands/AddTagsCommand.ts @@ -24,6 +24,10 @@ import { export type AddTagsCommandInput = AddTagsRequest; export type AddTagsCommandOutput = __MetadataBearer; +/** + *

Attaches tags to an existing Elasticsearch domain. Tags are a set of case-sensitive key value pairs. An Elasticsearch domain may have up to 10 tags. See + * Tagging Amazon Elasticsearch Service Domains for more information.

+ */ export class AddTagsCommand extends $Command< AddTagsCommandInput, AddTagsCommandOutput, @@ -38,6 +42,9 @@ export class AddTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/AssociatePackageCommand.ts b/clients/client-elasticsearch-service/commands/AssociatePackageCommand.ts index 060a67887908e..f3777ac17da31 100644 --- a/clients/client-elasticsearch-service/commands/AssociatePackageCommand.ts +++ b/clients/client-elasticsearch-service/commands/AssociatePackageCommand.ts @@ -24,6 +24,9 @@ import { export type AssociatePackageCommandInput = AssociatePackageRequest; export type AssociatePackageCommandOutput = AssociatePackageResponse & __MetadataBearer; +/** + *

Associates a package with an Amazon ES domain.

+ */ export class AssociatePackageCommand extends $Command< AssociatePackageCommandInput, AssociatePackageCommandOutput, @@ -38,6 +41,9 @@ export class AssociatePackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/CancelElasticsearchServiceSoftwareUpdateCommand.ts b/clients/client-elasticsearch-service/commands/CancelElasticsearchServiceSoftwareUpdateCommand.ts index d9fe5d75f0960..3569504d63627 100644 --- a/clients/client-elasticsearch-service/commands/CancelElasticsearchServiceSoftwareUpdateCommand.ts +++ b/clients/client-elasticsearch-service/commands/CancelElasticsearchServiceSoftwareUpdateCommand.ts @@ -28,6 +28,9 @@ export type CancelElasticsearchServiceSoftwareUpdateCommandInput = CancelElastic export type CancelElasticsearchServiceSoftwareUpdateCommandOutput = CancelElasticsearchServiceSoftwareUpdateResponse & __MetadataBearer; +/** + *

Cancels a scheduled service software update for an Amazon ES domain. You can only perform this operation before the AutomatedUpdateDate and when the UpdateStatus is in the PENDING_UPDATE state.

+ */ export class CancelElasticsearchServiceSoftwareUpdateCommand extends $Command< CancelElasticsearchServiceSoftwareUpdateCommandInput, CancelElasticsearchServiceSoftwareUpdateCommandOutput, @@ -42,6 +45,9 @@ export class CancelElasticsearchServiceSoftwareUpdateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/CreateElasticsearchDomainCommand.ts b/clients/client-elasticsearch-service/commands/CreateElasticsearchDomainCommand.ts index ceeb2285b5aea..acb4d338a80dc 100644 --- a/clients/client-elasticsearch-service/commands/CreateElasticsearchDomainCommand.ts +++ b/clients/client-elasticsearch-service/commands/CreateElasticsearchDomainCommand.ts @@ -24,6 +24,10 @@ import { export type CreateElasticsearchDomainCommandInput = CreateElasticsearchDomainRequest; export type CreateElasticsearchDomainCommandOutput = CreateElasticsearchDomainResponse & __MetadataBearer; +/** + *

Creates a new Elasticsearch domain. For more information, + * see Creating Elasticsearch Domains in the Amazon Elasticsearch Service Developer Guide.

+ */ export class CreateElasticsearchDomainCommand extends $Command< CreateElasticsearchDomainCommandInput, CreateElasticsearchDomainCommandOutput, @@ -38,6 +42,9 @@ export class CreateElasticsearchDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/CreateOutboundCrossClusterSearchConnectionCommand.ts b/clients/client-elasticsearch-service/commands/CreateOutboundCrossClusterSearchConnectionCommand.ts index 8576bc08915b7..b4091a5727dac 100644 --- a/clients/client-elasticsearch-service/commands/CreateOutboundCrossClusterSearchConnectionCommand.ts +++ b/clients/client-elasticsearch-service/commands/CreateOutboundCrossClusterSearchConnectionCommand.ts @@ -28,6 +28,9 @@ export type CreateOutboundCrossClusterSearchConnectionCommandInput = CreateOutbo export type CreateOutboundCrossClusterSearchConnectionCommandOutput = CreateOutboundCrossClusterSearchConnectionResponse & __MetadataBearer; +/** + *

Creates a new cross-cluster search connection from a source domain to a destination domain.

+ */ export class CreateOutboundCrossClusterSearchConnectionCommand extends $Command< CreateOutboundCrossClusterSearchConnectionCommandInput, CreateOutboundCrossClusterSearchConnectionCommandOutput, @@ -42,6 +45,9 @@ export class CreateOutboundCrossClusterSearchConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/CreatePackageCommand.ts b/clients/client-elasticsearch-service/commands/CreatePackageCommand.ts index a13b15d31ef3d..620bdae650555 100644 --- a/clients/client-elasticsearch-service/commands/CreatePackageCommand.ts +++ b/clients/client-elasticsearch-service/commands/CreatePackageCommand.ts @@ -24,6 +24,9 @@ import { export type CreatePackageCommandInput = CreatePackageRequest; export type CreatePackageCommandOutput = CreatePackageResponse & __MetadataBearer; +/** + *

Create a package for use with Amazon ES domains.

+ */ export class CreatePackageCommand extends $Command< CreatePackageCommandInput, CreatePackageCommandOutput, @@ -38,6 +41,9 @@ export class CreatePackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DeleteElasticsearchDomainCommand.ts b/clients/client-elasticsearch-service/commands/DeleteElasticsearchDomainCommand.ts index 179c2bf27c386..37cdbe4e4daff 100644 --- a/clients/client-elasticsearch-service/commands/DeleteElasticsearchDomainCommand.ts +++ b/clients/client-elasticsearch-service/commands/DeleteElasticsearchDomainCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteElasticsearchDomainCommandInput = DeleteElasticsearchDomainRequest; export type DeleteElasticsearchDomainCommandOutput = DeleteElasticsearchDomainResponse & __MetadataBearer; +/** + *

Permanently deletes the specified Elasticsearch domain and all of its data. Once a domain is deleted, it cannot be recovered.

+ */ export class DeleteElasticsearchDomainCommand extends $Command< DeleteElasticsearchDomainCommandInput, DeleteElasticsearchDomainCommandOutput, @@ -38,6 +41,9 @@ export class DeleteElasticsearchDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DeleteElasticsearchServiceRoleCommand.ts b/clients/client-elasticsearch-service/commands/DeleteElasticsearchServiceRoleCommand.ts index f616f32a6a449..ea029f0ed2b4b 100644 --- a/clients/client-elasticsearch-service/commands/DeleteElasticsearchServiceRoleCommand.ts +++ b/clients/client-elasticsearch-service/commands/DeleteElasticsearchServiceRoleCommand.ts @@ -23,6 +23,9 @@ import { export type DeleteElasticsearchServiceRoleCommandInput = {}; export type DeleteElasticsearchServiceRoleCommandOutput = __MetadataBearer; +/** + *

Deletes the service-linked role that Elasticsearch Service uses to manage and maintain VPC domains. Role deletion will fail if any existing VPC domains use the role. You must delete any such Elasticsearch domains before deleting the role. See Deleting Elasticsearch Service Role in VPC Endpoints for Amazon Elasticsearch Service Domains.

+ */ export class DeleteElasticsearchServiceRoleCommand extends $Command< DeleteElasticsearchServiceRoleCommandInput, DeleteElasticsearchServiceRoleCommandOutput, @@ -37,6 +40,9 @@ export class DeleteElasticsearchServiceRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DeleteInboundCrossClusterSearchConnectionCommand.ts b/clients/client-elasticsearch-service/commands/DeleteInboundCrossClusterSearchConnectionCommand.ts index 819ebc525ea63..f7b35e911cf72 100644 --- a/clients/client-elasticsearch-service/commands/DeleteInboundCrossClusterSearchConnectionCommand.ts +++ b/clients/client-elasticsearch-service/commands/DeleteInboundCrossClusterSearchConnectionCommand.ts @@ -28,6 +28,9 @@ export type DeleteInboundCrossClusterSearchConnectionCommandInput = DeleteInboun export type DeleteInboundCrossClusterSearchConnectionCommandOutput = DeleteInboundCrossClusterSearchConnectionResponse & __MetadataBearer; +/** + *

Allows the destination domain owner to delete an existing inbound cross-cluster search connection.

+ */ export class DeleteInboundCrossClusterSearchConnectionCommand extends $Command< DeleteInboundCrossClusterSearchConnectionCommandInput, DeleteInboundCrossClusterSearchConnectionCommandOutput, @@ -42,6 +45,9 @@ export class DeleteInboundCrossClusterSearchConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DeleteOutboundCrossClusterSearchConnectionCommand.ts b/clients/client-elasticsearch-service/commands/DeleteOutboundCrossClusterSearchConnectionCommand.ts index 6ae9d5534b2b9..220a1aac166ab 100644 --- a/clients/client-elasticsearch-service/commands/DeleteOutboundCrossClusterSearchConnectionCommand.ts +++ b/clients/client-elasticsearch-service/commands/DeleteOutboundCrossClusterSearchConnectionCommand.ts @@ -28,6 +28,9 @@ export type DeleteOutboundCrossClusterSearchConnectionCommandInput = DeleteOutbo export type DeleteOutboundCrossClusterSearchConnectionCommandOutput = DeleteOutboundCrossClusterSearchConnectionResponse & __MetadataBearer; +/** + *

Allows the source domain owner to delete an existing outbound cross-cluster search connection.

+ */ export class DeleteOutboundCrossClusterSearchConnectionCommand extends $Command< DeleteOutboundCrossClusterSearchConnectionCommandInput, DeleteOutboundCrossClusterSearchConnectionCommandOutput, @@ -42,6 +45,9 @@ export class DeleteOutboundCrossClusterSearchConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DeletePackageCommand.ts b/clients/client-elasticsearch-service/commands/DeletePackageCommand.ts index 0add5651b7b13..5a0cff14246ab 100644 --- a/clients/client-elasticsearch-service/commands/DeletePackageCommand.ts +++ b/clients/client-elasticsearch-service/commands/DeletePackageCommand.ts @@ -24,6 +24,9 @@ import { export type DeletePackageCommandInput = DeletePackageRequest; export type DeletePackageCommandOutput = DeletePackageResponse & __MetadataBearer; +/** + *

Delete the package.

+ */ export class DeletePackageCommand extends $Command< DeletePackageCommandInput, DeletePackageCommandOutput, @@ -38,6 +41,9 @@ export class DeletePackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainCommand.ts b/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainCommand.ts index da67e3a5d6564..7ceb41e572493 100644 --- a/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeElasticsearchDomainCommandInput = DescribeElasticsearchDomainRequest; export type DescribeElasticsearchDomainCommandOutput = DescribeElasticsearchDomainResponse & __MetadataBearer; +/** + *

Returns domain configuration information about the specified Elasticsearch domain, including the domain ID, domain endpoint, and domain ARN.

+ */ export class DescribeElasticsearchDomainCommand extends $Command< DescribeElasticsearchDomainCommandInput, DescribeElasticsearchDomainCommandOutput, @@ -38,6 +41,9 @@ export class DescribeElasticsearchDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainConfigCommand.ts b/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainConfigCommand.ts index 41b61699ddf99..2cce882a04e17 100644 --- a/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainConfigCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainConfigCommand.ts @@ -28,6 +28,9 @@ export type DescribeElasticsearchDomainConfigCommandInput = DescribeElasticsearc export type DescribeElasticsearchDomainConfigCommandOutput = DescribeElasticsearchDomainConfigResponse & __MetadataBearer; +/** + *

Provides cluster configuration information about the specified Elasticsearch domain, such as the state, creation date, update version, and update date for cluster options.

+ */ export class DescribeElasticsearchDomainConfigCommand extends $Command< DescribeElasticsearchDomainConfigCommandInput, DescribeElasticsearchDomainConfigCommandOutput, @@ -42,6 +45,9 @@ export class DescribeElasticsearchDomainConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainsCommand.ts b/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainsCommand.ts index 7a8312b8155f2..e33bdb936e2e9 100644 --- a/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainsCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribeElasticsearchDomainsCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeElasticsearchDomainsCommandInput = DescribeElasticsearchDomainsRequest; export type DescribeElasticsearchDomainsCommandOutput = DescribeElasticsearchDomainsResponse & __MetadataBearer; +/** + *

Returns domain configuration information about the specified Elasticsearch domains, including the domain ID, domain endpoint, and domain ARN.

+ */ export class DescribeElasticsearchDomainsCommand extends $Command< DescribeElasticsearchDomainsCommandInput, DescribeElasticsearchDomainsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeElasticsearchDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribeElasticsearchInstanceTypeLimitsCommand.ts b/clients/client-elasticsearch-service/commands/DescribeElasticsearchInstanceTypeLimitsCommand.ts index 7b639cf2b3317..984d31b433188 100644 --- a/clients/client-elasticsearch-service/commands/DescribeElasticsearchInstanceTypeLimitsCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribeElasticsearchInstanceTypeLimitsCommand.ts @@ -28,6 +28,16 @@ export type DescribeElasticsearchInstanceTypeLimitsCommandInput = DescribeElasti export type DescribeElasticsearchInstanceTypeLimitsCommandOutput = DescribeElasticsearchInstanceTypeLimitsResponse & __MetadataBearer; +/** + *

+ * Describe Elasticsearch Limits for a given InstanceType and ElasticsearchVersion. + * When modifying existing Domain, specify the + * + * DomainName + * + * to know what Limits are supported for modifying. + *

+ */ export class DescribeElasticsearchInstanceTypeLimitsCommand extends $Command< DescribeElasticsearchInstanceTypeLimitsCommandInput, DescribeElasticsearchInstanceTypeLimitsCommandOutput, @@ -42,6 +52,9 @@ export class DescribeElasticsearchInstanceTypeLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribeInboundCrossClusterSearchConnectionsCommand.ts b/clients/client-elasticsearch-service/commands/DescribeInboundCrossClusterSearchConnectionsCommand.ts index 623c23f1f099c..cc45fc3b8ad99 100644 --- a/clients/client-elasticsearch-service/commands/DescribeInboundCrossClusterSearchConnectionsCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribeInboundCrossClusterSearchConnectionsCommand.ts @@ -28,6 +28,9 @@ export type DescribeInboundCrossClusterSearchConnectionsCommandInput = DescribeI export type DescribeInboundCrossClusterSearchConnectionsCommandOutput = DescribeInboundCrossClusterSearchConnectionsResponse & __MetadataBearer; +/** + *

Lists all the inbound cross-cluster search connections for a destination domain.

+ */ export class DescribeInboundCrossClusterSearchConnectionsCommand extends $Command< DescribeInboundCrossClusterSearchConnectionsCommandInput, DescribeInboundCrossClusterSearchConnectionsCommandOutput, @@ -42,6 +45,9 @@ export class DescribeInboundCrossClusterSearchConnectionsCommand extends $Comman // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribeOutboundCrossClusterSearchConnectionsCommand.ts b/clients/client-elasticsearch-service/commands/DescribeOutboundCrossClusterSearchConnectionsCommand.ts index a47cb114588a2..6535df678561c 100644 --- a/clients/client-elasticsearch-service/commands/DescribeOutboundCrossClusterSearchConnectionsCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribeOutboundCrossClusterSearchConnectionsCommand.ts @@ -28,6 +28,9 @@ export type DescribeOutboundCrossClusterSearchConnectionsCommandInput = Describe export type DescribeOutboundCrossClusterSearchConnectionsCommandOutput = DescribeOutboundCrossClusterSearchConnectionsResponse & __MetadataBearer; +/** + *

Lists all the outbound cross-cluster search connections for a source domain.

+ */ export class DescribeOutboundCrossClusterSearchConnectionsCommand extends $Command< DescribeOutboundCrossClusterSearchConnectionsCommandInput, DescribeOutboundCrossClusterSearchConnectionsCommandOutput, @@ -42,6 +45,9 @@ export class DescribeOutboundCrossClusterSearchConnectionsCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribePackagesCommand.ts b/clients/client-elasticsearch-service/commands/DescribePackagesCommand.ts index e39c31b3f24ba..dc9ccb061d259 100644 --- a/clients/client-elasticsearch-service/commands/DescribePackagesCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribePackagesCommand.ts @@ -24,6 +24,9 @@ import { export type DescribePackagesCommandInput = DescribePackagesRequest; export type DescribePackagesCommandOutput = DescribePackagesResponse & __MetadataBearer; +/** + *

Describes all packages available to Amazon ES. Includes options for filtering, limiting the number of results, and pagination.

+ */ export class DescribePackagesCommand extends $Command< DescribePackagesCommandInput, DescribePackagesCommandOutput, @@ -38,6 +41,9 @@ export class DescribePackagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribeReservedElasticsearchInstanceOfferingsCommand.ts b/clients/client-elasticsearch-service/commands/DescribeReservedElasticsearchInstanceOfferingsCommand.ts index 2e0097f848d14..183b6df1d950d 100644 --- a/clients/client-elasticsearch-service/commands/DescribeReservedElasticsearchInstanceOfferingsCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribeReservedElasticsearchInstanceOfferingsCommand.ts @@ -28,6 +28,9 @@ export type DescribeReservedElasticsearchInstanceOfferingsCommandInput = Describ export type DescribeReservedElasticsearchInstanceOfferingsCommandOutput = DescribeReservedElasticsearchInstanceOfferingsResponse & __MetadataBearer; +/** + *

Lists available reserved Elasticsearch instance offerings.

+ */ export class DescribeReservedElasticsearchInstanceOfferingsCommand extends $Command< DescribeReservedElasticsearchInstanceOfferingsCommandInput, DescribeReservedElasticsearchInstanceOfferingsCommandOutput, @@ -42,6 +45,9 @@ export class DescribeReservedElasticsearchInstanceOfferingsCommand extends $Comm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DescribeReservedElasticsearchInstancesCommand.ts b/clients/client-elasticsearch-service/commands/DescribeReservedElasticsearchInstancesCommand.ts index 682a1eddc666d..4919d2607ca8a 100644 --- a/clients/client-elasticsearch-service/commands/DescribeReservedElasticsearchInstancesCommand.ts +++ b/clients/client-elasticsearch-service/commands/DescribeReservedElasticsearchInstancesCommand.ts @@ -28,6 +28,9 @@ export type DescribeReservedElasticsearchInstancesCommandInput = DescribeReserve export type DescribeReservedElasticsearchInstancesCommandOutput = DescribeReservedElasticsearchInstancesResponse & __MetadataBearer; +/** + *

Returns information about reserved Elasticsearch instances for this account.

+ */ export class DescribeReservedElasticsearchInstancesCommand extends $Command< DescribeReservedElasticsearchInstancesCommandInput, DescribeReservedElasticsearchInstancesCommandOutput, @@ -42,6 +45,9 @@ export class DescribeReservedElasticsearchInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/DissociatePackageCommand.ts b/clients/client-elasticsearch-service/commands/DissociatePackageCommand.ts index 043f880885416..ae74994cea1ad 100644 --- a/clients/client-elasticsearch-service/commands/DissociatePackageCommand.ts +++ b/clients/client-elasticsearch-service/commands/DissociatePackageCommand.ts @@ -24,6 +24,9 @@ import { export type DissociatePackageCommandInput = DissociatePackageRequest; export type DissociatePackageCommandOutput = DissociatePackageResponse & __MetadataBearer; +/** + *

Dissociates a package from the Amazon ES domain.

+ */ export class DissociatePackageCommand extends $Command< DissociatePackageCommandInput, DissociatePackageCommandOutput, @@ -38,6 +41,9 @@ export class DissociatePackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/GetCompatibleElasticsearchVersionsCommand.ts b/clients/client-elasticsearch-service/commands/GetCompatibleElasticsearchVersionsCommand.ts index d5e488b9fbadb..e7036ddd26059 100644 --- a/clients/client-elasticsearch-service/commands/GetCompatibleElasticsearchVersionsCommand.ts +++ b/clients/client-elasticsearch-service/commands/GetCompatibleElasticsearchVersionsCommand.ts @@ -28,6 +28,16 @@ export type GetCompatibleElasticsearchVersionsCommandInput = GetCompatibleElasti export type GetCompatibleElasticsearchVersionsCommandOutput = GetCompatibleElasticsearchVersionsResponse & __MetadataBearer; +/** + *

+ * Returns a list of upgrade compatible Elastisearch versions. + * You can optionally pass a + * + * DomainName + * + * to get all upgrade compatible Elasticsearch versions for that specific domain. + *

+ */ export class GetCompatibleElasticsearchVersionsCommand extends $Command< GetCompatibleElasticsearchVersionsCommandInput, GetCompatibleElasticsearchVersionsCommandOutput, @@ -42,6 +52,9 @@ export class GetCompatibleElasticsearchVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/GetPackageVersionHistoryCommand.ts b/clients/client-elasticsearch-service/commands/GetPackageVersionHistoryCommand.ts index cb00237fe48d2..d89ce108ec10f 100644 --- a/clients/client-elasticsearch-service/commands/GetPackageVersionHistoryCommand.ts +++ b/clients/client-elasticsearch-service/commands/GetPackageVersionHistoryCommand.ts @@ -24,6 +24,9 @@ import { export type GetPackageVersionHistoryCommandInput = GetPackageVersionHistoryRequest; export type GetPackageVersionHistoryCommandOutput = GetPackageVersionHistoryResponse & __MetadataBearer; +/** + *

Returns a list of versions of the package, along with their creation time and commit message.

+ */ export class GetPackageVersionHistoryCommand extends $Command< GetPackageVersionHistoryCommandInput, GetPackageVersionHistoryCommandOutput, @@ -38,6 +41,9 @@ export class GetPackageVersionHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/GetUpgradeHistoryCommand.ts b/clients/client-elasticsearch-service/commands/GetUpgradeHistoryCommand.ts index e206b9f53d3fe..5f887a7086d8a 100644 --- a/clients/client-elasticsearch-service/commands/GetUpgradeHistoryCommand.ts +++ b/clients/client-elasticsearch-service/commands/GetUpgradeHistoryCommand.ts @@ -24,6 +24,9 @@ import { export type GetUpgradeHistoryCommandInput = GetUpgradeHistoryRequest; export type GetUpgradeHistoryCommandOutput = GetUpgradeHistoryResponse & __MetadataBearer; +/** + *

Retrieves the complete history of the last 10 upgrades that were performed on the domain.

+ */ export class GetUpgradeHistoryCommand extends $Command< GetUpgradeHistoryCommandInput, GetUpgradeHistoryCommandOutput, @@ -38,6 +41,9 @@ export class GetUpgradeHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/GetUpgradeStatusCommand.ts b/clients/client-elasticsearch-service/commands/GetUpgradeStatusCommand.ts index 1fe5b02235e21..37d6ade64f574 100644 --- a/clients/client-elasticsearch-service/commands/GetUpgradeStatusCommand.ts +++ b/clients/client-elasticsearch-service/commands/GetUpgradeStatusCommand.ts @@ -24,6 +24,9 @@ import { export type GetUpgradeStatusCommandInput = GetUpgradeStatusRequest; export type GetUpgradeStatusCommandOutput = GetUpgradeStatusResponse & __MetadataBearer; +/** + *

Retrieves the latest status of the last upgrade or upgrade eligibility check that was performed on the domain.

+ */ export class GetUpgradeStatusCommand extends $Command< GetUpgradeStatusCommandInput, GetUpgradeStatusCommandOutput, @@ -38,6 +41,9 @@ export class GetUpgradeStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/ListDomainNamesCommand.ts b/clients/client-elasticsearch-service/commands/ListDomainNamesCommand.ts index 75683345c45c5..8c09a9be94ee6 100644 --- a/clients/client-elasticsearch-service/commands/ListDomainNamesCommand.ts +++ b/clients/client-elasticsearch-service/commands/ListDomainNamesCommand.ts @@ -24,6 +24,9 @@ import { export type ListDomainNamesCommandInput = {}; export type ListDomainNamesCommandOutput = ListDomainNamesResponse & __MetadataBearer; +/** + *

Returns the name of all Elasticsearch domains owned by the current user's account.

+ */ export class ListDomainNamesCommand extends $Command< ListDomainNamesCommandInput, ListDomainNamesCommandOutput, @@ -38,6 +41,9 @@ export class ListDomainNamesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/ListDomainsForPackageCommand.ts b/clients/client-elasticsearch-service/commands/ListDomainsForPackageCommand.ts index 7e29e312f61a8..ef090ae8f87e0 100644 --- a/clients/client-elasticsearch-service/commands/ListDomainsForPackageCommand.ts +++ b/clients/client-elasticsearch-service/commands/ListDomainsForPackageCommand.ts @@ -24,6 +24,9 @@ import { export type ListDomainsForPackageCommandInput = ListDomainsForPackageRequest; export type ListDomainsForPackageCommandOutput = ListDomainsForPackageResponse & __MetadataBearer; +/** + *

Lists all Amazon ES domains associated with the package.

+ */ export class ListDomainsForPackageCommand extends $Command< ListDomainsForPackageCommandInput, ListDomainsForPackageCommandOutput, @@ -38,6 +41,9 @@ export class ListDomainsForPackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/ListElasticsearchInstanceTypesCommand.ts b/clients/client-elasticsearch-service/commands/ListElasticsearchInstanceTypesCommand.ts index 04461ff385fa0..1558e1ad1657f 100644 --- a/clients/client-elasticsearch-service/commands/ListElasticsearchInstanceTypesCommand.ts +++ b/clients/client-elasticsearch-service/commands/ListElasticsearchInstanceTypesCommand.ts @@ -24,6 +24,9 @@ import { export type ListElasticsearchInstanceTypesCommandInput = ListElasticsearchInstanceTypesRequest; export type ListElasticsearchInstanceTypesCommandOutput = ListElasticsearchInstanceTypesResponse & __MetadataBearer; +/** + *

List all Elasticsearch instance types that are supported for given ElasticsearchVersion

+ */ export class ListElasticsearchInstanceTypesCommand extends $Command< ListElasticsearchInstanceTypesCommandInput, ListElasticsearchInstanceTypesCommandOutput, @@ -38,6 +41,9 @@ export class ListElasticsearchInstanceTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/ListElasticsearchVersionsCommand.ts b/clients/client-elasticsearch-service/commands/ListElasticsearchVersionsCommand.ts index a56a1d7adb801..e34da9c41a539 100644 --- a/clients/client-elasticsearch-service/commands/ListElasticsearchVersionsCommand.ts +++ b/clients/client-elasticsearch-service/commands/ListElasticsearchVersionsCommand.ts @@ -24,6 +24,9 @@ import { export type ListElasticsearchVersionsCommandInput = ListElasticsearchVersionsRequest; export type ListElasticsearchVersionsCommandOutput = ListElasticsearchVersionsResponse & __MetadataBearer; +/** + *

List all supported Elasticsearch versions

+ */ export class ListElasticsearchVersionsCommand extends $Command< ListElasticsearchVersionsCommandInput, ListElasticsearchVersionsCommandOutput, @@ -38,6 +41,9 @@ export class ListElasticsearchVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/ListPackagesForDomainCommand.ts b/clients/client-elasticsearch-service/commands/ListPackagesForDomainCommand.ts index c9a6afcb901d2..4a825f097f70b 100644 --- a/clients/client-elasticsearch-service/commands/ListPackagesForDomainCommand.ts +++ b/clients/client-elasticsearch-service/commands/ListPackagesForDomainCommand.ts @@ -24,6 +24,9 @@ import { export type ListPackagesForDomainCommandInput = ListPackagesForDomainRequest; export type ListPackagesForDomainCommandOutput = ListPackagesForDomainResponse & __MetadataBearer; +/** + *

Lists all packages associated with the Amazon ES domain.

+ */ export class ListPackagesForDomainCommand extends $Command< ListPackagesForDomainCommandInput, ListPackagesForDomainCommandOutput, @@ -38,6 +41,9 @@ export class ListPackagesForDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/ListTagsCommand.ts b/clients/client-elasticsearch-service/commands/ListTagsCommand.ts index f3e0a49ef4112..8f52741d8c2f2 100644 --- a/clients/client-elasticsearch-service/commands/ListTagsCommand.ts +++ b/clients/client-elasticsearch-service/commands/ListTagsCommand.ts @@ -24,6 +24,9 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResponse & __MetadataBearer; +/** + *

Returns all tags for the given Elasticsearch domain.

+ */ export class ListTagsCommand extends $Command< ListTagsCommandInput, ListTagsCommandOutput, @@ -38,6 +41,9 @@ export class ListTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/PurchaseReservedElasticsearchInstanceOfferingCommand.ts b/clients/client-elasticsearch-service/commands/PurchaseReservedElasticsearchInstanceOfferingCommand.ts index 1762f80f74c00..344a4089d6cf6 100644 --- a/clients/client-elasticsearch-service/commands/PurchaseReservedElasticsearchInstanceOfferingCommand.ts +++ b/clients/client-elasticsearch-service/commands/PurchaseReservedElasticsearchInstanceOfferingCommand.ts @@ -28,6 +28,9 @@ export type PurchaseReservedElasticsearchInstanceOfferingCommandInput = Purchase export type PurchaseReservedElasticsearchInstanceOfferingCommandOutput = PurchaseReservedElasticsearchInstanceOfferingResponse & __MetadataBearer; +/** + *

Allows you to purchase reserved Elasticsearch instances.

+ */ export class PurchaseReservedElasticsearchInstanceOfferingCommand extends $Command< PurchaseReservedElasticsearchInstanceOfferingCommandInput, PurchaseReservedElasticsearchInstanceOfferingCommandOutput, @@ -42,6 +45,9 @@ export class PurchaseReservedElasticsearchInstanceOfferingCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/RejectInboundCrossClusterSearchConnectionCommand.ts b/clients/client-elasticsearch-service/commands/RejectInboundCrossClusterSearchConnectionCommand.ts index 996b4e15af55f..2f1ede0267716 100644 --- a/clients/client-elasticsearch-service/commands/RejectInboundCrossClusterSearchConnectionCommand.ts +++ b/clients/client-elasticsearch-service/commands/RejectInboundCrossClusterSearchConnectionCommand.ts @@ -28,6 +28,9 @@ export type RejectInboundCrossClusterSearchConnectionCommandInput = RejectInboun export type RejectInboundCrossClusterSearchConnectionCommandOutput = RejectInboundCrossClusterSearchConnectionResponse & __MetadataBearer; +/** + *

Allows the destination domain owner to reject an inbound cross-cluster search connection request.

+ */ export class RejectInboundCrossClusterSearchConnectionCommand extends $Command< RejectInboundCrossClusterSearchConnectionCommandInput, RejectInboundCrossClusterSearchConnectionCommandOutput, @@ -42,6 +45,9 @@ export class RejectInboundCrossClusterSearchConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/RemoveTagsCommand.ts b/clients/client-elasticsearch-service/commands/RemoveTagsCommand.ts index bb18d53fc7a34..7d503068acacc 100644 --- a/clients/client-elasticsearch-service/commands/RemoveTagsCommand.ts +++ b/clients/client-elasticsearch-service/commands/RemoveTagsCommand.ts @@ -24,6 +24,9 @@ import { export type RemoveTagsCommandInput = RemoveTagsRequest; export type RemoveTagsCommandOutput = __MetadataBearer; +/** + *

Removes the specified set of tags from the specified Elasticsearch domain.

+ */ export class RemoveTagsCommand extends $Command< RemoveTagsCommandInput, RemoveTagsCommandOutput, @@ -38,6 +41,9 @@ export class RemoveTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/StartElasticsearchServiceSoftwareUpdateCommand.ts b/clients/client-elasticsearch-service/commands/StartElasticsearchServiceSoftwareUpdateCommand.ts index 9c9c483869d46..90bcc6031650e 100644 --- a/clients/client-elasticsearch-service/commands/StartElasticsearchServiceSoftwareUpdateCommand.ts +++ b/clients/client-elasticsearch-service/commands/StartElasticsearchServiceSoftwareUpdateCommand.ts @@ -28,6 +28,9 @@ export type StartElasticsearchServiceSoftwareUpdateCommandInput = StartElasticse export type StartElasticsearchServiceSoftwareUpdateCommandOutput = StartElasticsearchServiceSoftwareUpdateResponse & __MetadataBearer; +/** + *

Schedules a service software update for an Amazon ES domain.

+ */ export class StartElasticsearchServiceSoftwareUpdateCommand extends $Command< StartElasticsearchServiceSoftwareUpdateCommandInput, StartElasticsearchServiceSoftwareUpdateCommandOutput, @@ -42,6 +45,9 @@ export class StartElasticsearchServiceSoftwareUpdateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/UpdateElasticsearchDomainConfigCommand.ts b/clients/client-elasticsearch-service/commands/UpdateElasticsearchDomainConfigCommand.ts index f69f651973a75..a40391e73bc32 100644 --- a/clients/client-elasticsearch-service/commands/UpdateElasticsearchDomainConfigCommand.ts +++ b/clients/client-elasticsearch-service/commands/UpdateElasticsearchDomainConfigCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateElasticsearchDomainConfigCommandInput = UpdateElasticsearchDomainConfigRequest; export type UpdateElasticsearchDomainConfigCommandOutput = UpdateElasticsearchDomainConfigResponse & __MetadataBearer; +/** + *

Modifies the cluster configuration of the specified Elasticsearch domain, setting as setting the instance type and the number of instances.

+ */ export class UpdateElasticsearchDomainConfigCommand extends $Command< UpdateElasticsearchDomainConfigCommandInput, UpdateElasticsearchDomainConfigCommandOutput, @@ -38,6 +41,9 @@ export class UpdateElasticsearchDomainConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/UpdatePackageCommand.ts b/clients/client-elasticsearch-service/commands/UpdatePackageCommand.ts index 56982bf5ad754..9663998b33d17 100644 --- a/clients/client-elasticsearch-service/commands/UpdatePackageCommand.ts +++ b/clients/client-elasticsearch-service/commands/UpdatePackageCommand.ts @@ -24,6 +24,9 @@ import { export type UpdatePackageCommandInput = UpdatePackageRequest; export type UpdatePackageCommandOutput = UpdatePackageResponse & __MetadataBearer; +/** + *

Updates a package for use with Amazon ES domains.

+ */ export class UpdatePackageCommand extends $Command< UpdatePackageCommandInput, UpdatePackageCommandOutput, @@ -38,6 +41,9 @@ export class UpdatePackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/commands/UpgradeElasticsearchDomainCommand.ts b/clients/client-elasticsearch-service/commands/UpgradeElasticsearchDomainCommand.ts index dec38e5c148e0..f1ad80ba9e2e1 100644 --- a/clients/client-elasticsearch-service/commands/UpgradeElasticsearchDomainCommand.ts +++ b/clients/client-elasticsearch-service/commands/UpgradeElasticsearchDomainCommand.ts @@ -24,6 +24,9 @@ import { export type UpgradeElasticsearchDomainCommandInput = UpgradeElasticsearchDomainRequest; export type UpgradeElasticsearchDomainCommandOutput = UpgradeElasticsearchDomainResponse & __MetadataBearer; +/** + *

Allows you to either upgrade your domain or perform an Upgrade eligibility check to a compatible Elasticsearch version.

+ */ export class UpgradeElasticsearchDomainCommand extends $Command< UpgradeElasticsearchDomainCommandInput, UpgradeElasticsearchDomainCommandOutput, @@ -38,6 +41,9 @@ export class UpgradeElasticsearchDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ElasticsearchServiceClientResolvedConfig, diff --git a/clients/client-elasticsearch-service/package.json b/clients/client-elasticsearch-service/package.json index b3bb7c7edf30d..196d1c53dabc2 100644 --- a/clients/client-elasticsearch-service/package.json +++ b/clients/client-elasticsearch-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Elasticsearch Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-elasticsearch-service/pagination/DescribeInboundCrossClusterSearchConnectionsPaginator.ts b/clients/client-elasticsearch-service/pagination/DescribeInboundCrossClusterSearchConnectionsPaginator.ts index 50e8fbcad5e90..61c3c81a91fbd 100644 --- a/clients/client-elasticsearch-service/pagination/DescribeInboundCrossClusterSearchConnectionsPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/DescribeInboundCrossClusterSearchConnectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: DescribeInboundCrossClusterSearchConnectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInboundCrossClusterSearchConnectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: DescribeInboundCrossClusterSearchConnectionsCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/DescribeOutboundCrossClusterSearchConnectionsPaginator.ts b/clients/client-elasticsearch-service/pagination/DescribeOutboundCrossClusterSearchConnectionsPaginator.ts index 70a9c9b5760a0..b6600818aea03 100644 --- a/clients/client-elasticsearch-service/pagination/DescribeOutboundCrossClusterSearchConnectionsPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/DescribeOutboundCrossClusterSearchConnectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: DescribeOutboundCrossClusterSearchConnectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOutboundCrossClusterSearchConnectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: DescribeOutboundCrossClusterSearchConnectionsCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/DescribePackagesPaginator.ts b/clients/client-elasticsearch-service/pagination/DescribePackagesPaginator.ts index 98c9c4538ad2d..3fd9ab3d4ae55 100644 --- a/clients/client-elasticsearch-service/pagination/DescribePackagesPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/DescribePackagesPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: DescribePackagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePackagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: DescribePackagesCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/DescribeReservedElasticsearchInstanceOfferingsPaginator.ts b/clients/client-elasticsearch-service/pagination/DescribeReservedElasticsearchInstanceOfferingsPaginator.ts index dd5081ac2bf22..0ead8123b0a88 100644 --- a/clients/client-elasticsearch-service/pagination/DescribeReservedElasticsearchInstanceOfferingsPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/DescribeReservedElasticsearchInstanceOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: DescribeReservedElasticsearchInstanceOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedElasticsearchInstanceOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: DescribeReservedElasticsearchInstanceOfferingsCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/DescribeReservedElasticsearchInstancesPaginator.ts b/clients/client-elasticsearch-service/pagination/DescribeReservedElasticsearchInstancesPaginator.ts index 18b7a79075b46..3c375c4ffddc8 100644 --- a/clients/client-elasticsearch-service/pagination/DescribeReservedElasticsearchInstancesPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/DescribeReservedElasticsearchInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: DescribeReservedElasticsearchInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedElasticsearchInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: DescribeReservedElasticsearchInstancesCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/GetPackageVersionHistoryPaginator.ts b/clients/client-elasticsearch-service/pagination/GetPackageVersionHistoryPaginator.ts index 69bba39322ac8..ab5884269c939 100644 --- a/clients/client-elasticsearch-service/pagination/GetPackageVersionHistoryPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/GetPackageVersionHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: GetPackageVersionHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetPackageVersionHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: GetPackageVersionHistoryCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/GetUpgradeHistoryPaginator.ts b/clients/client-elasticsearch-service/pagination/GetUpgradeHistoryPaginator.ts index 4de249039a8a9..44849ee57cb63 100644 --- a/clients/client-elasticsearch-service/pagination/GetUpgradeHistoryPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/GetUpgradeHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: GetUpgradeHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetUpgradeHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: GetUpgradeHistoryCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/ListDomainsForPackagePaginator.ts b/clients/client-elasticsearch-service/pagination/ListDomainsForPackagePaginator.ts index 26016eb80d96e..a9659148e8e35 100644 --- a/clients/client-elasticsearch-service/pagination/ListDomainsForPackagePaginator.ts +++ b/clients/client-elasticsearch-service/pagination/ListDomainsForPackagePaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: ListDomainsForPackageCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainsForPackageCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: ListDomainsForPackageCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/ListElasticsearchInstanceTypesPaginator.ts b/clients/client-elasticsearch-service/pagination/ListElasticsearchInstanceTypesPaginator.ts index 2b2a4932e7a87..070c8ddba67f0 100644 --- a/clients/client-elasticsearch-service/pagination/ListElasticsearchInstanceTypesPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/ListElasticsearchInstanceTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: ListElasticsearchInstanceTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListElasticsearchInstanceTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: ListElasticsearchInstanceTypesCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/ListElasticsearchVersionsPaginator.ts b/clients/client-elasticsearch-service/pagination/ListElasticsearchVersionsPaginator.ts index 9cff045e236ab..f0f18ad9f89e4 100644 --- a/clients/client-elasticsearch-service/pagination/ListElasticsearchVersionsPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/ListElasticsearchVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: ListElasticsearchVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListElasticsearchVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: ListElasticsearchVersionsCommandInput, diff --git a/clients/client-elasticsearch-service/pagination/ListPackagesForDomainPaginator.ts b/clients/client-elasticsearch-service/pagination/ListPackagesForDomainPaginator.ts index bff52f1f51afa..cfad8833d2a0c 100644 --- a/clients/client-elasticsearch-service/pagination/ListPackagesForDomainPaginator.ts +++ b/clients/client-elasticsearch-service/pagination/ListPackagesForDomainPaginator.ts @@ -8,6 +8,9 @@ import { import { ElasticsearchServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ElasticsearchServiceClient, input: ListPackagesForDomainCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPackagesForDomainCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ElasticsearchService, input: ListPackagesForDomainCommandInput, diff --git a/clients/client-elasticsearch-service/runtimeConfig.browser.ts b/clients/client-elasticsearch-service/runtimeConfig.browser.ts index 2a5dd8434b079..9c0c6be1ee6e8 100644 --- a/clients/client-elasticsearch-service/runtimeConfig.browser.ts +++ b/clients/client-elasticsearch-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ElasticsearchServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-elasticsearch-service/runtimeConfig.native.ts b/clients/client-elasticsearch-service/runtimeConfig.native.ts index 53e6f631ee2a4..263f5a6fc63ca 100644 --- a/clients/client-elasticsearch-service/runtimeConfig.native.ts +++ b/clients/client-elasticsearch-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ElasticsearchServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-elasticsearch-service/runtimeConfig.shared.ts b/clients/client-elasticsearch-service/runtimeConfig.shared.ts index 29d12cc1ecfc5..f7402b7cf0137 100644 --- a/clients/client-elasticsearch-service/runtimeConfig.shared.ts +++ b/clients/client-elasticsearch-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-01-01", disableHostPrefix: false, diff --git a/clients/client-elasticsearch-service/runtimeConfig.ts b/clients/client-elasticsearch-service/runtimeConfig.ts index ebf1cef9599e0..eae4a9f996ed6 100644 --- a/clients/client-elasticsearch-service/runtimeConfig.ts +++ b/clients/client-elasticsearch-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ElasticsearchServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-elasticsearch-service/tsconfig.json b/clients/client-elasticsearch-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-elasticsearch-service/tsconfig.json +++ b/clients/client-elasticsearch-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-emr/commands/AddInstanceFleetCommand.ts b/clients/client-emr/commands/AddInstanceFleetCommand.ts index 1ea2ba79c22c2..f1a0b71a0dd03 100644 --- a/clients/client-emr/commands/AddInstanceFleetCommand.ts +++ b/clients/client-emr/commands/AddInstanceFleetCommand.ts @@ -20,6 +20,12 @@ import { export type AddInstanceFleetCommandInput = AddInstanceFleetInput; export type AddInstanceFleetCommandOutput = AddInstanceFleetOutput & __MetadataBearer; +/** + *

Adds an instance fleet to a running cluster.

+ * + *

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x.

+ *
+ */ export class AddInstanceFleetCommand extends $Command< AddInstanceFleetCommandInput, AddInstanceFleetCommandOutput, @@ -34,6 +40,9 @@ export class AddInstanceFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/AddInstanceGroupsCommand.ts b/clients/client-emr/commands/AddInstanceGroupsCommand.ts index 205e0ade50975..cea3de097956c 100644 --- a/clients/client-emr/commands/AddInstanceGroupsCommand.ts +++ b/clients/client-emr/commands/AddInstanceGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type AddInstanceGroupsCommandInput = AddInstanceGroupsInput; export type AddInstanceGroupsCommandOutput = AddInstanceGroupsOutput & __MetadataBearer; +/** + *

Adds one or more instance groups to a running cluster.

+ */ export class AddInstanceGroupsCommand extends $Command< AddInstanceGroupsCommandInput, AddInstanceGroupsCommandOutput, @@ -34,6 +37,9 @@ export class AddInstanceGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/AddJobFlowStepsCommand.ts b/clients/client-emr/commands/AddJobFlowStepsCommand.ts index 12a9537c745c8..8527b6980c830 100644 --- a/clients/client-emr/commands/AddJobFlowStepsCommand.ts +++ b/clients/client-emr/commands/AddJobFlowStepsCommand.ts @@ -20,6 +20,13 @@ import { export type AddJobFlowStepsCommandInput = AddJobFlowStepsInput; export type AddJobFlowStepsCommandOutput = AddJobFlowStepsOutput & __MetadataBearer; +/** + *

AddJobFlowSteps adds new steps to a running cluster. A maximum of 256 steps are allowed in each job flow.

+ *

If your cluster is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps to process your data. You can bypass the 256-step limitation in various ways, including using SSH to connect to the master node and submitting queries directly to the software running on the master node, such as Hive and Hadoop. For more information on how to do this, see Add More than 256 Steps to a Cluster in the Amazon EMR Management Guide.

+ *

A step specifies the location of a JAR file stored either on the master node of the cluster or in Amazon S3. Each step is performed by the main function of the main class of the JAR file. The main class can be specified either in the manifest of the JAR or by using the MainFunction parameter of the step.

+ *

Amazon EMR executes each step in the order listed. For a step to be considered complete, the main function must exit with a zero exit code and all Hadoop jobs started while the step was running must have completed and run successfully.

+ *

You can only add steps to a cluster that is in one of the following states: STARTING, BOOTSTRAPPING, RUNNING, or WAITING.

+ */ export class AddJobFlowStepsCommand extends $Command< AddJobFlowStepsCommandInput, AddJobFlowStepsCommandOutput, @@ -34,6 +41,9 @@ export class AddJobFlowStepsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/AddTagsCommand.ts b/clients/client-emr/commands/AddTagsCommand.ts index 9aae2f31490de..6b3d179a71f7b 100644 --- a/clients/client-emr/commands/AddTagsCommand.ts +++ b/clients/client-emr/commands/AddTagsCommand.ts @@ -17,6 +17,11 @@ import { export type AddTagsCommandInput = AddTagsInput; export type AddTagsCommandOutput = AddTagsOutput & __MetadataBearer; +/** + *

Adds tags to an Amazon EMR resource. Tags make it easier to associate clusters in various ways, such as grouping clusters to track your Amazon EMR resource allocation costs. + * For more information, see Tag Clusters. + *

+ */ export class AddTagsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +32,9 @@ export class AddTagsCommand extends $Command, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/CancelStepsCommand.ts b/clients/client-emr/commands/CancelStepsCommand.ts index bcd2826392f78..d5a9e0fd75a35 100644 --- a/clients/client-emr/commands/CancelStepsCommand.ts +++ b/clients/client-emr/commands/CancelStepsCommand.ts @@ -20,6 +20,9 @@ import { export type CancelStepsCommandInput = CancelStepsInput; export type CancelStepsCommandOutput = CancelStepsOutput & __MetadataBearer; +/** + *

Cancels a pending step or steps in a running cluster. Available only in Amazon EMR versions 4.8.0 and later, excluding version 5.0.0. A maximum of 256 steps are allowed in each CancelSteps request. CancelSteps is idempotent but asynchronous; it does not guarantee a step will be canceled, even if the request is successfully submitted. You can only cancel steps that are in a PENDING state.

+ */ export class CancelStepsCommand extends $Command< CancelStepsCommandInput, CancelStepsCommandOutput, @@ -34,6 +37,9 @@ export class CancelStepsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/CreateSecurityConfigurationCommand.ts b/clients/client-emr/commands/CreateSecurityConfigurationCommand.ts index 6aace33dbacd1..f57626c45e16d 100644 --- a/clients/client-emr/commands/CreateSecurityConfigurationCommand.ts +++ b/clients/client-emr/commands/CreateSecurityConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSecurityConfigurationCommandInput = CreateSecurityConfigurationInput; export type CreateSecurityConfigurationCommandOutput = CreateSecurityConfigurationOutput & __MetadataBearer; +/** + *

Creates a security configuration, which is stored in the service and can be specified when a cluster is created.

+ */ export class CreateSecurityConfigurationCommand extends $Command< CreateSecurityConfigurationCommandInput, CreateSecurityConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class CreateSecurityConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/DeleteSecurityConfigurationCommand.ts b/clients/client-emr/commands/DeleteSecurityConfigurationCommand.ts index 9abb33bd71930..34236effaa1e3 100644 --- a/clients/client-emr/commands/DeleteSecurityConfigurationCommand.ts +++ b/clients/client-emr/commands/DeleteSecurityConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSecurityConfigurationCommandInput = DeleteSecurityConfigurationInput; export type DeleteSecurityConfigurationCommandOutput = DeleteSecurityConfigurationOutput & __MetadataBearer; +/** + *

Deletes a security configuration.

+ */ export class DeleteSecurityConfigurationCommand extends $Command< DeleteSecurityConfigurationCommandInput, DeleteSecurityConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSecurityConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/DescribeClusterCommand.ts b/clients/client-emr/commands/DescribeClusterCommand.ts index 08f75af08ea25..fd433e47a8f0e 100644 --- a/clients/client-emr/commands/DescribeClusterCommand.ts +++ b/clients/client-emr/commands/DescribeClusterCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClusterCommandInput = DescribeClusterInput; export type DescribeClusterCommandOutput = DescribeClusterOutput & __MetadataBearer; +/** + *

Provides cluster-level details including status, hardware and software configuration, VPC settings, and so on.

+ */ export class DescribeClusterCommand extends $Command< DescribeClusterCommandInput, DescribeClusterCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/DescribeJobFlowsCommand.ts b/clients/client-emr/commands/DescribeJobFlowsCommand.ts index d41aa82b6ba8e..6daa517d0c928 100644 --- a/clients/client-emr/commands/DescribeJobFlowsCommand.ts +++ b/clients/client-emr/commands/DescribeJobFlowsCommand.ts @@ -20,6 +20,25 @@ import { export type DescribeJobFlowsCommandInput = DescribeJobFlowsInput; export type DescribeJobFlowsCommandOutput = DescribeJobFlowsOutput & __MetadataBearer; +/** + *

This API is deprecated and will eventually be removed. We recommend you use ListClusters, + * DescribeCluster, ListSteps, ListInstanceGroups and ListBootstrapActions + * instead.

+ *

DescribeJobFlows returns a list of job flows that match all of the supplied parameters. The parameters can include a list of job flow IDs, job flow states, and restrictions on job flow creation date and time.

+ *

Regardless of supplied parameters, only job flows created within the last two months are returned.

+ *

If no parameters are supplied, then job flows matching either of the following criteria are returned:

+ *
    + *
  • + *

    Job flows created and completed in the last two weeks

    + *
  • + *
  • + *

    Job flows created within the last two months that are in one of the following states: RUNNING, WAITING, SHUTTING_DOWN, + * STARTING + *

    + *
  • + *
+ *

Amazon EMR can return a maximum of 512 job flow descriptions.

+ */ export class DescribeJobFlowsCommand extends $Command< DescribeJobFlowsCommandInput, DescribeJobFlowsCommandOutput, @@ -34,6 +53,9 @@ export class DescribeJobFlowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/DescribeNotebookExecutionCommand.ts b/clients/client-emr/commands/DescribeNotebookExecutionCommand.ts index 066de51832073..d53a37ea4da11 100644 --- a/clients/client-emr/commands/DescribeNotebookExecutionCommand.ts +++ b/clients/client-emr/commands/DescribeNotebookExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNotebookExecutionCommandInput = DescribeNotebookExecutionInput; export type DescribeNotebookExecutionCommandOutput = DescribeNotebookExecutionOutput & __MetadataBearer; +/** + *

Provides details of a notebook execution.

+ */ export class DescribeNotebookExecutionCommand extends $Command< DescribeNotebookExecutionCommandInput, DescribeNotebookExecutionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNotebookExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/DescribeSecurityConfigurationCommand.ts b/clients/client-emr/commands/DescribeSecurityConfigurationCommand.ts index d2be1444fa2ea..c39ba93137bab 100644 --- a/clients/client-emr/commands/DescribeSecurityConfigurationCommand.ts +++ b/clients/client-emr/commands/DescribeSecurityConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSecurityConfigurationCommandInput = DescribeSecurityConfigurationInput; export type DescribeSecurityConfigurationCommandOutput = DescribeSecurityConfigurationOutput & __MetadataBearer; +/** + *

Provides the details of a security configuration by returning the configuration JSON.

+ */ export class DescribeSecurityConfigurationCommand extends $Command< DescribeSecurityConfigurationCommandInput, DescribeSecurityConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSecurityConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/DescribeStepCommand.ts b/clients/client-emr/commands/DescribeStepCommand.ts index 7f66d1616112d..cbe0ceaf1ab6a 100644 --- a/clients/client-emr/commands/DescribeStepCommand.ts +++ b/clients/client-emr/commands/DescribeStepCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeStepCommandInput = DescribeStepInput; export type DescribeStepCommandOutput = DescribeStepOutput & __MetadataBearer; +/** + *

Provides more detail about the cluster step.

+ */ export class DescribeStepCommand extends $Command< DescribeStepCommandInput, DescribeStepCommandOutput, @@ -34,6 +37,9 @@ export class DescribeStepCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/GetBlockPublicAccessConfigurationCommand.ts b/clients/client-emr/commands/GetBlockPublicAccessConfigurationCommand.ts index 1aa3012a5bd15..471eebddc8711 100644 --- a/clients/client-emr/commands/GetBlockPublicAccessConfigurationCommand.ts +++ b/clients/client-emr/commands/GetBlockPublicAccessConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetBlockPublicAccessConfigurationCommandInput = GetBlockPublicAccessConfigurationInput; export type GetBlockPublicAccessConfigurationCommandOutput = GetBlockPublicAccessConfigurationOutput & __MetadataBearer; +/** + *

Returns the Amazon EMR block public access configuration for your AWS account in the current Region. For more information see Configure Block Public Access for Amazon EMR in the Amazon EMR Management Guide.

+ */ export class GetBlockPublicAccessConfigurationCommand extends $Command< GetBlockPublicAccessConfigurationCommandInput, GetBlockPublicAccessConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetBlockPublicAccessConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/GetManagedScalingPolicyCommand.ts b/clients/client-emr/commands/GetManagedScalingPolicyCommand.ts index e6d37ca86d2bd..3444fb92185a1 100644 --- a/clients/client-emr/commands/GetManagedScalingPolicyCommand.ts +++ b/clients/client-emr/commands/GetManagedScalingPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type GetManagedScalingPolicyCommandInput = GetManagedScalingPolicyInput; export type GetManagedScalingPolicyCommandOutput = GetManagedScalingPolicyOutput & __MetadataBearer; +/** + *

+ * Fetches the attached managed scaling policy for an Amazon EMR cluster. + *

+ */ export class GetManagedScalingPolicyCommand extends $Command< GetManagedScalingPolicyCommandInput, GetManagedScalingPolicyCommandOutput, @@ -34,6 +39,9 @@ export class GetManagedScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ListBootstrapActionsCommand.ts b/clients/client-emr/commands/ListBootstrapActionsCommand.ts index 9e7de7ae7c628..695cdc1e006ae 100644 --- a/clients/client-emr/commands/ListBootstrapActionsCommand.ts +++ b/clients/client-emr/commands/ListBootstrapActionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListBootstrapActionsCommandInput = ListBootstrapActionsInput; export type ListBootstrapActionsCommandOutput = ListBootstrapActionsOutput & __MetadataBearer; +/** + *

Provides information about the bootstrap actions associated with a cluster.

+ */ export class ListBootstrapActionsCommand extends $Command< ListBootstrapActionsCommandInput, ListBootstrapActionsCommandOutput, @@ -34,6 +37,9 @@ export class ListBootstrapActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ListClustersCommand.ts b/clients/client-emr/commands/ListClustersCommand.ts index 62261026f2078..f41034ea1aaad 100644 --- a/clients/client-emr/commands/ListClustersCommand.ts +++ b/clients/client-emr/commands/ListClustersCommand.ts @@ -20,6 +20,9 @@ import { export type ListClustersCommandInput = ListClustersInput; export type ListClustersCommandOutput = ListClustersOutput & __MetadataBearer; +/** + *

Provides the status of all clusters visible to this AWS account. Allows you to filter the list of clusters based on certain criteria; for example, filtering by cluster creation date and time or by status. This call returns a maximum of 50 clusters per call, but returns a marker to track the paging of the cluster list across multiple ListClusters calls.

+ */ export class ListClustersCommand extends $Command< ListClustersCommandInput, ListClustersCommandOutput, @@ -34,6 +37,9 @@ export class ListClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ListInstanceFleetsCommand.ts b/clients/client-emr/commands/ListInstanceFleetsCommand.ts index 25a18d1d96036..73088369f378c 100644 --- a/clients/client-emr/commands/ListInstanceFleetsCommand.ts +++ b/clients/client-emr/commands/ListInstanceFleetsCommand.ts @@ -20,6 +20,12 @@ import { export type ListInstanceFleetsCommandInput = ListInstanceFleetsInput; export type ListInstanceFleetsCommandOutput = ListInstanceFleetsOutput & __MetadataBearer; +/** + *

Lists all available details about the instance fleets in a cluster.

+ * + *

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

+ *
+ */ export class ListInstanceFleetsCommand extends $Command< ListInstanceFleetsCommandInput, ListInstanceFleetsCommandOutput, @@ -34,6 +40,9 @@ export class ListInstanceFleetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ListInstanceGroupsCommand.ts b/clients/client-emr/commands/ListInstanceGroupsCommand.ts index e9be6ac265a76..824ac45d730de 100644 --- a/clients/client-emr/commands/ListInstanceGroupsCommand.ts +++ b/clients/client-emr/commands/ListInstanceGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListInstanceGroupsCommandInput = ListInstanceGroupsInput; export type ListInstanceGroupsCommandOutput = ListInstanceGroupsOutput & __MetadataBearer; +/** + *

Provides all available details about the instance groups in a cluster.

+ */ export class ListInstanceGroupsCommand extends $Command< ListInstanceGroupsCommandInput, ListInstanceGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListInstanceGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ListInstancesCommand.ts b/clients/client-emr/commands/ListInstancesCommand.ts index 7b15dec8fded9..4c0a127ad1fb4 100644 --- a/clients/client-emr/commands/ListInstancesCommand.ts +++ b/clients/client-emr/commands/ListInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type ListInstancesCommandInput = ListInstancesInput; export type ListInstancesCommandOutput = ListInstancesOutput & __MetadataBearer; +/** + *

Provides information for all active EC2 instances and EC2 instances terminated in the last 30 days, up to a maximum of 2,000. EC2 instances in any of the following states are considered active: AWAITING_FULFILLMENT, PROVISIONING, BOOTSTRAPPING, RUNNING.

+ */ export class ListInstancesCommand extends $Command< ListInstancesCommandInput, ListInstancesCommandOutput, @@ -34,6 +37,9 @@ export class ListInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ListNotebookExecutionsCommand.ts b/clients/client-emr/commands/ListNotebookExecutionsCommand.ts index 39313a0258969..d0935c875daf7 100644 --- a/clients/client-emr/commands/ListNotebookExecutionsCommand.ts +++ b/clients/client-emr/commands/ListNotebookExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListNotebookExecutionsCommandInput = ListNotebookExecutionsInput; export type ListNotebookExecutionsCommandOutput = ListNotebookExecutionsOutput & __MetadataBearer; +/** + *

Provides summaries of all notebook executions. You can filter the list based on multiple criteria such as status, time range, and editor id. Returns a maximum of 50 notebook executions and a marker to track the paging of a longer notebook execution list across multiple ListNotebookExecution calls.

+ */ export class ListNotebookExecutionsCommand extends $Command< ListNotebookExecutionsCommandInput, ListNotebookExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class ListNotebookExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ListSecurityConfigurationsCommand.ts b/clients/client-emr/commands/ListSecurityConfigurationsCommand.ts index a1f2ee2558cac..6dd99064c13cf 100644 --- a/clients/client-emr/commands/ListSecurityConfigurationsCommand.ts +++ b/clients/client-emr/commands/ListSecurityConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSecurityConfigurationsCommandInput = ListSecurityConfigurationsInput; export type ListSecurityConfigurationsCommandOutput = ListSecurityConfigurationsOutput & __MetadataBearer; +/** + *

Lists all the security configurations visible to this account, providing their creation dates and times, and their names. This call returns a maximum of 50 clusters per call, but returns a marker to track the paging of the cluster list across multiple ListSecurityConfigurations calls.

+ */ export class ListSecurityConfigurationsCommand extends $Command< ListSecurityConfigurationsCommandInput, ListSecurityConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class ListSecurityConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ListStepsCommand.ts b/clients/client-emr/commands/ListStepsCommand.ts index 845de353567b1..f174d866bad81 100644 --- a/clients/client-emr/commands/ListStepsCommand.ts +++ b/clients/client-emr/commands/ListStepsCommand.ts @@ -17,6 +17,9 @@ import { export type ListStepsCommandInput = ListStepsInput; export type ListStepsCommandOutput = ListStepsOutput & __MetadataBearer; +/** + *

Provides a list of steps for the cluster in reverse order unless you specify stepIds with the request of filter by StepStates. You can specify a maximum of ten stepIDs.

+ */ export class ListStepsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class ListStepsCommand extends $Command, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ModifyClusterCommand.ts b/clients/client-emr/commands/ModifyClusterCommand.ts index 9812866f17cc3..a2ecea34075a4 100644 --- a/clients/client-emr/commands/ModifyClusterCommand.ts +++ b/clients/client-emr/commands/ModifyClusterCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyClusterCommandInput = ModifyClusterInput; export type ModifyClusterCommandOutput = ModifyClusterOutput & __MetadataBearer; +/** + *

Modifies the number of steps that can be executed concurrently for the cluster specified using ClusterID.

+ */ export class ModifyClusterCommand extends $Command< ModifyClusterCommandInput, ModifyClusterCommandOutput, @@ -34,6 +37,9 @@ export class ModifyClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ModifyInstanceFleetCommand.ts b/clients/client-emr/commands/ModifyInstanceFleetCommand.ts index 25fcbaf764a94..6585b495a1888 100644 --- a/clients/client-emr/commands/ModifyInstanceFleetCommand.ts +++ b/clients/client-emr/commands/ModifyInstanceFleetCommand.ts @@ -20,6 +20,12 @@ import { export type ModifyInstanceFleetCommandInput = ModifyInstanceFleetInput; export type ModifyInstanceFleetCommandOutput = __MetadataBearer; +/** + *

Modifies the target On-Demand and target Spot capacities for the instance fleet with the specified InstanceFleetID within the cluster specified using ClusterID. The call either succeeds or fails atomically.

+ * + *

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

+ *
+ */ export class ModifyInstanceFleetCommand extends $Command< ModifyInstanceFleetCommandInput, ModifyInstanceFleetCommandOutput, @@ -34,6 +40,9 @@ export class ModifyInstanceFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/ModifyInstanceGroupsCommand.ts b/clients/client-emr/commands/ModifyInstanceGroupsCommand.ts index 2fd207e97503e..768a572958f66 100644 --- a/clients/client-emr/commands/ModifyInstanceGroupsCommand.ts +++ b/clients/client-emr/commands/ModifyInstanceGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyInstanceGroupsCommandInput = ModifyInstanceGroupsInput; export type ModifyInstanceGroupsCommandOutput = __MetadataBearer; +/** + *

ModifyInstanceGroups modifies the number of nodes and configuration settings of an instance group. The input parameters include the new target instance count for the group and the instance group ID. The call will either succeed or fail atomically.

+ */ export class ModifyInstanceGroupsCommand extends $Command< ModifyInstanceGroupsCommandInput, ModifyInstanceGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ModifyInstanceGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/PutAutoScalingPolicyCommand.ts b/clients/client-emr/commands/PutAutoScalingPolicyCommand.ts index 6a1b99eed89a9..fdc22c6ba2fb5 100644 --- a/clients/client-emr/commands/PutAutoScalingPolicyCommand.ts +++ b/clients/client-emr/commands/PutAutoScalingPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type PutAutoScalingPolicyCommandInput = PutAutoScalingPolicyInput; export type PutAutoScalingPolicyCommandOutput = PutAutoScalingPolicyOutput & __MetadataBearer; +/** + *

Creates or updates an automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster. The automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric.

+ */ export class PutAutoScalingPolicyCommand extends $Command< PutAutoScalingPolicyCommandInput, PutAutoScalingPolicyCommandOutput, @@ -34,6 +37,9 @@ export class PutAutoScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/PutBlockPublicAccessConfigurationCommand.ts b/clients/client-emr/commands/PutBlockPublicAccessConfigurationCommand.ts index 9ec7ed2466d74..9f45805fab0a8 100644 --- a/clients/client-emr/commands/PutBlockPublicAccessConfigurationCommand.ts +++ b/clients/client-emr/commands/PutBlockPublicAccessConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type PutBlockPublicAccessConfigurationCommandInput = PutBlockPublicAccessConfigurationInput; export type PutBlockPublicAccessConfigurationCommandOutput = PutBlockPublicAccessConfigurationOutput & __MetadataBearer; +/** + *

Creates or updates an Amazon EMR block public access configuration for your AWS account in the current Region. For more information see Configure Block Public Access for Amazon EMR in the Amazon EMR Management Guide.

+ */ export class PutBlockPublicAccessConfigurationCommand extends $Command< PutBlockPublicAccessConfigurationCommandInput, PutBlockPublicAccessConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class PutBlockPublicAccessConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/PutManagedScalingPolicyCommand.ts b/clients/client-emr/commands/PutManagedScalingPolicyCommand.ts index dfa0e608dd5f6..90b8e743a1e5e 100644 --- a/clients/client-emr/commands/PutManagedScalingPolicyCommand.ts +++ b/clients/client-emr/commands/PutManagedScalingPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutManagedScalingPolicyCommandInput = PutManagedScalingPolicyInput; export type PutManagedScalingPolicyCommandOutput = PutManagedScalingPolicyOutput & __MetadataBearer; +/** + *

+ * Creates or updates a managed scaling policy for an Amazon EMR cluster. The managed scaling policy defines the limits for resources, such as EC2 instances that can be added or terminated from a cluster. The policy only applies to the core and task nodes. The master node cannot be scaled after initial configuration. + *

+ */ export class PutManagedScalingPolicyCommand extends $Command< PutManagedScalingPolicyCommandInput, PutManagedScalingPolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutManagedScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/RemoveAutoScalingPolicyCommand.ts b/clients/client-emr/commands/RemoveAutoScalingPolicyCommand.ts index 45d70684beafb..32c40d2b53145 100644 --- a/clients/client-emr/commands/RemoveAutoScalingPolicyCommand.ts +++ b/clients/client-emr/commands/RemoveAutoScalingPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveAutoScalingPolicyCommandInput = RemoveAutoScalingPolicyInput; export type RemoveAutoScalingPolicyCommandOutput = RemoveAutoScalingPolicyOutput & __MetadataBearer; +/** + *

Removes an automatic scaling policy from a specified instance group within an EMR cluster.

+ */ export class RemoveAutoScalingPolicyCommand extends $Command< RemoveAutoScalingPolicyCommandInput, RemoveAutoScalingPolicyCommandOutput, @@ -34,6 +37,9 @@ export class RemoveAutoScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/RemoveManagedScalingPolicyCommand.ts b/clients/client-emr/commands/RemoveManagedScalingPolicyCommand.ts index b7fea23915446..00699f146357a 100644 --- a/clients/client-emr/commands/RemoveManagedScalingPolicyCommand.ts +++ b/clients/client-emr/commands/RemoveManagedScalingPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type RemoveManagedScalingPolicyCommandInput = RemoveManagedScalingPolicyInput; export type RemoveManagedScalingPolicyCommandOutput = RemoveManagedScalingPolicyOutput & __MetadataBearer; +/** + *

+ * Removes a managed scaling policy from a specified EMR cluster. + *

+ */ export class RemoveManagedScalingPolicyCommand extends $Command< RemoveManagedScalingPolicyCommandInput, RemoveManagedScalingPolicyCommandOutput, @@ -34,6 +39,9 @@ export class RemoveManagedScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/RemoveTagsCommand.ts b/clients/client-emr/commands/RemoveTagsCommand.ts index d5733bb12716e..cf3a4309ccef4 100644 --- a/clients/client-emr/commands/RemoveTagsCommand.ts +++ b/clients/client-emr/commands/RemoveTagsCommand.ts @@ -20,6 +20,12 @@ import { export type RemoveTagsCommandInput = RemoveTagsInput; export type RemoveTagsCommandOutput = RemoveTagsOutput & __MetadataBearer; +/** + *

Removes tags from an Amazon EMR resource. Tags make it easier to associate clusters in various ways, such as grouping clusters to track your Amazon EMR resource allocation costs. + * For more information, see Tag Clusters. + *

+ *

The following example removes the stack tag with value Prod from a cluster:

+ */ export class RemoveTagsCommand extends $Command< RemoveTagsCommandInput, RemoveTagsCommandOutput, @@ -34,6 +40,9 @@ export class RemoveTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/RunJobFlowCommand.ts b/clients/client-emr/commands/RunJobFlowCommand.ts index 35803601677d2..87efa8a25ffc7 100644 --- a/clients/client-emr/commands/RunJobFlowCommand.ts +++ b/clients/client-emr/commands/RunJobFlowCommand.ts @@ -20,6 +20,27 @@ import { export type RunJobFlowCommandInput = RunJobFlowInput; export type RunJobFlowCommandOutput = RunJobFlowOutput & __MetadataBearer; +/** + *

RunJobFlow creates and starts running a new cluster (job flow). The cluster runs the steps + * specified. After the steps complete, the cluster stops and the HDFS partition is + * lost. To prevent loss of data, configure the last step of the job flow to store results in + * Amazon S3. If the JobFlowInstancesConfig + * KeepJobFlowAliveWhenNoSteps parameter is + * set to TRUE, the cluster transitions to the WAITING state rather than shutting down after the steps have completed.

+ * + *

For additional protection, you can set the + * JobFlowInstancesConfig + * TerminationProtected parameter to TRUE to lock the + * cluster and prevent it from being + * terminated by API call, user intervention, or in the event of a job flow error.

+ * + *

A maximum of 256 steps are allowed in each job flow.

+ *

If your cluster is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps to process your data. You can bypass the 256-step limitation in various ways, including using the SSH shell to connect to the master node and submitting queries directly to the software running on the master node, such as Hive and Hadoop. For more information on how to do this, see Add More than 256 Steps to a Cluster in the Amazon EMR Management Guide.

+ *

For long running clusters, we recommend that you periodically store your results.

+ * + *

The instance fleets configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions. The RunJobFlow request can contain InstanceFleets parameters or InstanceGroups parameters, but not both.

+ *
+ */ export class RunJobFlowCommand extends $Command< RunJobFlowCommandInput, RunJobFlowCommandOutput, @@ -34,6 +55,9 @@ export class RunJobFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/SetTerminationProtectionCommand.ts b/clients/client-emr/commands/SetTerminationProtectionCommand.ts index a4fb0ff465052..4b955bae7bae5 100644 --- a/clients/client-emr/commands/SetTerminationProtectionCommand.ts +++ b/clients/client-emr/commands/SetTerminationProtectionCommand.ts @@ -20,6 +20,18 @@ import { export type SetTerminationProtectionCommandInput = SetTerminationProtectionInput; export type SetTerminationProtectionCommandOutput = __MetadataBearer; +/** + *

SetTerminationProtection locks a cluster (job flow) so the EC2 instances in the cluster cannot be terminated by user intervention, an API call, or in the event of a job-flow error. The cluster still terminates upon successful completion of the job flow. Calling SetTerminationProtection on a cluster is similar to calling the Amazon EC2 DisableAPITermination API on all EC2 instances in a cluster.

+ *

+ * SetTerminationProtection is used to prevent accidental termination of a cluster and to ensure that in the event of an error, the instances persist so that you can recover any data stored in their ephemeral instance storage.

+ * + *

To terminate a cluster that has been locked by setting SetTerminationProtection to true, + * you must first unlock the job flow by a subsequent call to SetTerminationProtection + * in which you set the value to false.

+ *

For more information, seeManaging Cluster Termination in the + * Amazon EMR Management Guide. + *

+ */ export class SetTerminationProtectionCommand extends $Command< SetTerminationProtectionCommandInput, SetTerminationProtectionCommandOutput, @@ -34,6 +46,9 @@ export class SetTerminationProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/SetVisibleToAllUsersCommand.ts b/clients/client-emr/commands/SetVisibleToAllUsersCommand.ts index 2cb4028be62d9..5fd45695d456c 100644 --- a/clients/client-emr/commands/SetVisibleToAllUsersCommand.ts +++ b/clients/client-emr/commands/SetVisibleToAllUsersCommand.ts @@ -20,6 +20,9 @@ import { export type SetVisibleToAllUsersCommandInput = SetVisibleToAllUsersInput; export type SetVisibleToAllUsersCommandOutput = __MetadataBearer; +/** + *

Sets the Cluster$VisibleToAllUsers value, which determines whether the cluster is visible to all IAM users of the AWS account associated with the cluster. Only the IAM user who created the cluster or the AWS account root user can call this action. The default value, true, indicates that all IAM users in the AWS account can perform cluster actions if they have the proper IAM policy permissions. If set to false, only the IAM user that created the cluster can perform actions. This action works on running clusters. You can override the default true setting when you create a cluster by using the VisibleToAllUsers parameter with RunJobFlow.

+ */ export class SetVisibleToAllUsersCommand extends $Command< SetVisibleToAllUsersCommandInput, SetVisibleToAllUsersCommandOutput, @@ -34,6 +37,9 @@ export class SetVisibleToAllUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/StartNotebookExecutionCommand.ts b/clients/client-emr/commands/StartNotebookExecutionCommand.ts index 9d92599385d7a..63942c531a93a 100644 --- a/clients/client-emr/commands/StartNotebookExecutionCommand.ts +++ b/clients/client-emr/commands/StartNotebookExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type StartNotebookExecutionCommandInput = StartNotebookExecutionInput; export type StartNotebookExecutionCommandOutput = StartNotebookExecutionOutput & __MetadataBearer; +/** + *

Starts a notebook execution.

+ */ export class StartNotebookExecutionCommand extends $Command< StartNotebookExecutionCommandInput, StartNotebookExecutionCommandOutput, @@ -34,6 +37,9 @@ export class StartNotebookExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/StopNotebookExecutionCommand.ts b/clients/client-emr/commands/StopNotebookExecutionCommand.ts index 5ca2e774b64ef..e8c66e73e35c9 100644 --- a/clients/client-emr/commands/StopNotebookExecutionCommand.ts +++ b/clients/client-emr/commands/StopNotebookExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type StopNotebookExecutionCommandInput = StopNotebookExecutionInput; export type StopNotebookExecutionCommandOutput = __MetadataBearer; +/** + *

Stops a notebook execution.

+ */ export class StopNotebookExecutionCommand extends $Command< StopNotebookExecutionCommandInput, StopNotebookExecutionCommandOutput, @@ -34,6 +37,9 @@ export class StopNotebookExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/commands/TerminateJobFlowsCommand.ts b/clients/client-emr/commands/TerminateJobFlowsCommand.ts index 04bb0c2caab63..e9b2df3af02e6 100644 --- a/clients/client-emr/commands/TerminateJobFlowsCommand.ts +++ b/clients/client-emr/commands/TerminateJobFlowsCommand.ts @@ -20,6 +20,10 @@ import { export type TerminateJobFlowsCommandInput = TerminateJobFlowsInput; export type TerminateJobFlowsCommandOutput = __MetadataBearer; +/** + *

TerminateJobFlows shuts a list of clusters (job flows) down. When a job flow is shut down, any step not yet completed is canceled and the EC2 instances on which the cluster is running are stopped. Any log files not already saved are uploaded to Amazon S3 if a LogUri was specified when the cluster was created.

+ *

The maximum number of clusters allowed is 10. The call to TerminateJobFlows is asynchronous. Depending on the configuration of the cluster, it may take up to 1-5 minutes for the cluster to completely terminate and release allocated resources, such as Amazon EC2 instances.

+ */ export class TerminateJobFlowsCommand extends $Command< TerminateJobFlowsCommandInput, TerminateJobFlowsCommandOutput, @@ -34,6 +38,9 @@ export class TerminateJobFlowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EMRClientResolvedConfig, diff --git a/clients/client-emr/package.json b/clients/client-emr/package.json index 0f70ea246c085..316b469b5bb17 100644 --- a/clients/client-emr/package.json +++ b/clients/client-emr/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Emr Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-emr/pagination/ListBootstrapActionsPaginator.ts b/clients/client-emr/pagination/ListBootstrapActionsPaginator.ts index 60174a1bd524b..47b7fcefcb2b5 100644 --- a/clients/client-emr/pagination/ListBootstrapActionsPaginator.ts +++ b/clients/client-emr/pagination/ListBootstrapActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EMRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EMRClient, input: ListBootstrapActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBootstrapActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EMR, input: ListBootstrapActionsCommandInput, diff --git a/clients/client-emr/pagination/ListClustersPaginator.ts b/clients/client-emr/pagination/ListClustersPaginator.ts index cfcb4ecbc827e..85df17359c54a 100644 --- a/clients/client-emr/pagination/ListClustersPaginator.ts +++ b/clients/client-emr/pagination/ListClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { EMRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EMRClient, input: ListClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EMR, input: ListClustersCommandInput, diff --git a/clients/client-emr/pagination/ListInstanceFleetsPaginator.ts b/clients/client-emr/pagination/ListInstanceFleetsPaginator.ts index 26ada99ed6132..9b3b0c7c4925d 100644 --- a/clients/client-emr/pagination/ListInstanceFleetsPaginator.ts +++ b/clients/client-emr/pagination/ListInstanceFleetsPaginator.ts @@ -8,6 +8,9 @@ import { import { EMRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EMRClient, input: ListInstanceFleetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInstanceFleetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EMR, input: ListInstanceFleetsCommandInput, diff --git a/clients/client-emr/pagination/ListInstanceGroupsPaginator.ts b/clients/client-emr/pagination/ListInstanceGroupsPaginator.ts index 35ffbd8d9b453..98093461df6e5 100644 --- a/clients/client-emr/pagination/ListInstanceGroupsPaginator.ts +++ b/clients/client-emr/pagination/ListInstanceGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { EMRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EMRClient, input: ListInstanceGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInstanceGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EMR, input: ListInstanceGroupsCommandInput, diff --git a/clients/client-emr/pagination/ListInstancesPaginator.ts b/clients/client-emr/pagination/ListInstancesPaginator.ts index 72689cdea3821..ca66e7b2d5654 100644 --- a/clients/client-emr/pagination/ListInstancesPaginator.ts +++ b/clients/client-emr/pagination/ListInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { EMRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EMRClient, input: ListInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EMR, input: ListInstancesCommandInput, diff --git a/clients/client-emr/pagination/ListNotebookExecutionsPaginator.ts b/clients/client-emr/pagination/ListNotebookExecutionsPaginator.ts index 4c3887dc98bb6..908053a3e3c84 100644 --- a/clients/client-emr/pagination/ListNotebookExecutionsPaginator.ts +++ b/clients/client-emr/pagination/ListNotebookExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { EMRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EMRClient, input: ListNotebookExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNotebookExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EMR, input: ListNotebookExecutionsCommandInput, diff --git a/clients/client-emr/pagination/ListSecurityConfigurationsPaginator.ts b/clients/client-emr/pagination/ListSecurityConfigurationsPaginator.ts index 1815d52321d07..cee04c3a4a9e4 100644 --- a/clients/client-emr/pagination/ListSecurityConfigurationsPaginator.ts +++ b/clients/client-emr/pagination/ListSecurityConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { EMRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EMRClient, input: ListSecurityConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSecurityConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EMR, input: ListSecurityConfigurationsCommandInput, diff --git a/clients/client-emr/pagination/ListStepsPaginator.ts b/clients/client-emr/pagination/ListStepsPaginator.ts index 686fcad246bbb..d35b7cb27ac25 100644 --- a/clients/client-emr/pagination/ListStepsPaginator.ts +++ b/clients/client-emr/pagination/ListStepsPaginator.ts @@ -4,6 +4,9 @@ import { ListStepsCommand, ListStepsCommandInput, ListStepsCommandOutput } from import { EMRPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: EMRClient, input: ListStepsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStepsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: EMR, input: ListStepsCommandInput, diff --git a/clients/client-emr/runtimeConfig.browser.ts b/clients/client-emr/runtimeConfig.browser.ts index 23083089b6966..4311396dfb40a 100644 --- a/clients/client-emr/runtimeConfig.browser.ts +++ b/clients/client-emr/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./EMRClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-emr/runtimeConfig.native.ts b/clients/client-emr/runtimeConfig.native.ts index 817bcb2285608..baf9056f41d2d 100644 --- a/clients/client-emr/runtimeConfig.native.ts +++ b/clients/client-emr/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./EMRClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-emr/runtimeConfig.shared.ts b/clients/client-emr/runtimeConfig.shared.ts index 5115efd30556b..2f96332b02bb6 100644 --- a/clients/client-emr/runtimeConfig.shared.ts +++ b/clients/client-emr/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2009-03-31", disableHostPrefix: false, diff --git a/clients/client-emr/runtimeConfig.ts b/clients/client-emr/runtimeConfig.ts index b3c7347205a7f..29b1438f6c255 100644 --- a/clients/client-emr/runtimeConfig.ts +++ b/clients/client-emr/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./EMRClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-emr/tsconfig.json b/clients/client-emr/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-emr/tsconfig.json +++ b/clients/client-emr/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-eventbridge/commands/ActivateEventSourceCommand.ts b/clients/client-eventbridge/commands/ActivateEventSourceCommand.ts index 54c60d9855d49..c19712a57fdb4 100644 --- a/clients/client-eventbridge/commands/ActivateEventSourceCommand.ts +++ b/clients/client-eventbridge/commands/ActivateEventSourceCommand.ts @@ -20,6 +20,10 @@ import { export type ActivateEventSourceCommandInput = ActivateEventSourceRequest; export type ActivateEventSourceCommandOutput = __MetadataBearer; +/** + *

Activates a partner event source that has been deactivated. Once activated, your + * matching event bus will start receiving events from the event source.

+ */ export class ActivateEventSourceCommand extends $Command< ActivateEventSourceCommandInput, ActivateEventSourceCommandOutput, @@ -34,6 +38,9 @@ export class ActivateEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/CancelReplayCommand.ts b/clients/client-eventbridge/commands/CancelReplayCommand.ts index 6f4bbc6cd02ce..76147dc128b1b 100644 --- a/clients/client-eventbridge/commands/CancelReplayCommand.ts +++ b/clients/client-eventbridge/commands/CancelReplayCommand.ts @@ -20,6 +20,9 @@ import { export type CancelReplayCommandInput = CancelReplayRequest; export type CancelReplayCommandOutput = CancelReplayResponse & __MetadataBearer; +/** + *

Cancels the specified replay.

+ */ export class CancelReplayCommand extends $Command< CancelReplayCommandInput, CancelReplayCommandOutput, @@ -34,6 +37,9 @@ export class CancelReplayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/CreateArchiveCommand.ts b/clients/client-eventbridge/commands/CreateArchiveCommand.ts index eec2960df595f..7649cd4fe6270 100644 --- a/clients/client-eventbridge/commands/CreateArchiveCommand.ts +++ b/clients/client-eventbridge/commands/CreateArchiveCommand.ts @@ -20,6 +20,11 @@ import { export type CreateArchiveCommandInput = CreateArchiveRequest; export type CreateArchiveCommandOutput = CreateArchiveResponse & __MetadataBearer; +/** + *

Creates an archive of events with the specified settings. When you create an archive, + * incoming events might not immediately start being sent to the archive. Allow a short + * period of time for changes to take effect.

+ */ export class CreateArchiveCommand extends $Command< CreateArchiveCommandInput, CreateArchiveCommandOutput, @@ -34,6 +39,9 @@ export class CreateArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/CreateEventBusCommand.ts b/clients/client-eventbridge/commands/CreateEventBusCommand.ts index 289cdd473723b..6617dc51c562a 100644 --- a/clients/client-eventbridge/commands/CreateEventBusCommand.ts +++ b/clients/client-eventbridge/commands/CreateEventBusCommand.ts @@ -20,6 +20,11 @@ import { export type CreateEventBusCommandInput = CreateEventBusRequest; export type CreateEventBusCommandOutput = CreateEventBusResponse & __MetadataBearer; +/** + *

Creates a new event bus within your account. This can be a custom event bus which you + * can use to receive events from your custom applications and services, or it can be a + * partner event bus which can be matched to a partner event source.

+ */ export class CreateEventBusCommand extends $Command< CreateEventBusCommandInput, CreateEventBusCommandOutput, @@ -34,6 +39,9 @@ export class CreateEventBusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/CreatePartnerEventSourceCommand.ts b/clients/client-eventbridge/commands/CreatePartnerEventSourceCommand.ts index cea4d5f476169..12b1d369545b6 100644 --- a/clients/client-eventbridge/commands/CreatePartnerEventSourceCommand.ts +++ b/clients/client-eventbridge/commands/CreatePartnerEventSourceCommand.ts @@ -20,6 +20,32 @@ import { export type CreatePartnerEventSourceCommandInput = CreatePartnerEventSourceRequest; export type CreatePartnerEventSourceCommandOutput = CreatePartnerEventSourceResponse & __MetadataBearer; +/** + *

Called by an SaaS partner to create a partner event source. This operation is not used + * by AWS customers.

+ *

Each partner event source can be used by one AWS account to create a matching partner + * event bus in that AWS account. A SaaS partner must create one partner event source for + * each AWS account that wants to receive those event types.

+ *

A partner event source creates events based on resources within the SaaS partner's + * service or application.

+ *

An AWS account that creates a partner event bus that matches the partner event source + * can use that event bus to receive events from the partner, and then process them using + * AWS Events rules and targets.

+ *

Partner event source names follow this format:

+ *

+ * + * partner_name/event_namespace/event_name + * + *

+ *

+ * partner_name is determined during partner registration and + * identifies the partner to AWS customers. event_namespace is + * determined by the partner and is a way for the partner to categorize their events. + * event_name is determined by the partner, and should uniquely + * identify an event-generating resource within the partner system. The combination of + * event_namespace and event_name should help + * AWS customers decide whether to create an event bus to receive these events.

+ */ export class CreatePartnerEventSourceCommand extends $Command< CreatePartnerEventSourceCommandInput, CreatePartnerEventSourceCommandOutput, @@ -34,6 +60,9 @@ export class CreatePartnerEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DeactivateEventSourceCommand.ts b/clients/client-eventbridge/commands/DeactivateEventSourceCommand.ts index bd1ffc9676b00..ab3ad4fd57350 100644 --- a/clients/client-eventbridge/commands/DeactivateEventSourceCommand.ts +++ b/clients/client-eventbridge/commands/DeactivateEventSourceCommand.ts @@ -20,6 +20,13 @@ import { export type DeactivateEventSourceCommandInput = DeactivateEventSourceRequest; export type DeactivateEventSourceCommandOutput = __MetadataBearer; +/** + *

You can use this operation to temporarily stop receiving events from the specified + * partner event source. The matching event bus is not deleted.

+ *

When you deactivate a partner event source, the source goes into PENDING state. If it + * remains in PENDING state for more than two weeks, it is deleted.

+ *

To activate a deactivated partner event source, use ActivateEventSource.

+ */ export class DeactivateEventSourceCommand extends $Command< DeactivateEventSourceCommandInput, DeactivateEventSourceCommandOutput, @@ -34,6 +41,9 @@ export class DeactivateEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DeleteArchiveCommand.ts b/clients/client-eventbridge/commands/DeleteArchiveCommand.ts index a26ca9613cda7..50ffb1175db03 100644 --- a/clients/client-eventbridge/commands/DeleteArchiveCommand.ts +++ b/clients/client-eventbridge/commands/DeleteArchiveCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteArchiveCommandInput = DeleteArchiveRequest; export type DeleteArchiveCommandOutput = DeleteArchiveResponse & __MetadataBearer; +/** + *

Deletes the specified archive.

+ */ export class DeleteArchiveCommand extends $Command< DeleteArchiveCommandInput, DeleteArchiveCommandOutput, @@ -34,6 +37,9 @@ export class DeleteArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DeleteEventBusCommand.ts b/clients/client-eventbridge/commands/DeleteEventBusCommand.ts index e5f0f8fc3afcf..3af0e0ca49999 100644 --- a/clients/client-eventbridge/commands/DeleteEventBusCommand.ts +++ b/clients/client-eventbridge/commands/DeleteEventBusCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteEventBusCommandInput = DeleteEventBusRequest; export type DeleteEventBusCommandOutput = __MetadataBearer; +/** + *

Deletes the specified custom event bus or partner event bus. All rules associated with + * this event bus need to be deleted. You can't delete your account's default event + * bus.

+ */ export class DeleteEventBusCommand extends $Command< DeleteEventBusCommandInput, DeleteEventBusCommandOutput, @@ -34,6 +39,9 @@ export class DeleteEventBusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DeletePartnerEventSourceCommand.ts b/clients/client-eventbridge/commands/DeletePartnerEventSourceCommand.ts index 06d25f31d589e..40465ab161b17 100644 --- a/clients/client-eventbridge/commands/DeletePartnerEventSourceCommand.ts +++ b/clients/client-eventbridge/commands/DeletePartnerEventSourceCommand.ts @@ -20,6 +20,13 @@ import { export type DeletePartnerEventSourceCommandInput = DeletePartnerEventSourceRequest; export type DeletePartnerEventSourceCommandOutput = __MetadataBearer; +/** + *

This operation is used by SaaS partners to delete a partner event source. This + * operation is not used by AWS customers.

+ *

When you delete an event source, the status of the corresponding partner event bus in + * the AWS customer account becomes DELETED.

+ *

+ */ export class DeletePartnerEventSourceCommand extends $Command< DeletePartnerEventSourceCommandInput, DeletePartnerEventSourceCommandOutput, @@ -34,6 +41,9 @@ export class DeletePartnerEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DeleteRuleCommand.ts b/clients/client-eventbridge/commands/DeleteRuleCommand.ts index 0f75a2a88bc0e..983438092f164 100644 --- a/clients/client-eventbridge/commands/DeleteRuleCommand.ts +++ b/clients/client-eventbridge/commands/DeleteRuleCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteRuleCommandInput = DeleteRuleRequest; export type DeleteRuleCommandOutput = __MetadataBearer; +/** + *

Deletes the specified rule.

+ *

Before you can delete the rule, you must remove all targets, using RemoveTargets.

+ * + *

When you delete a rule, incoming events might continue to match to the deleted + * rule. Allow a short period of time for changes to take effect.

+ * + *

Managed rules are rules created and managed by another AWS service on your behalf. + * These rules are created by those other AWS services to support functionality in those + * services. You can delete these rules using the Force option, but you should + * do so only if you are sure the other service is not still using that rule.

+ */ export class DeleteRuleCommand extends $Command< DeleteRuleCommandInput, DeleteRuleCommandOutput, @@ -34,6 +46,9 @@ export class DeleteRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DescribeArchiveCommand.ts b/clients/client-eventbridge/commands/DescribeArchiveCommand.ts index 8b466d5226491..728da71599444 100644 --- a/clients/client-eventbridge/commands/DescribeArchiveCommand.ts +++ b/clients/client-eventbridge/commands/DescribeArchiveCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeArchiveCommandInput = DescribeArchiveRequest; export type DescribeArchiveCommandOutput = DescribeArchiveResponse & __MetadataBearer; +/** + *

Retrieves details about an archive.

+ */ export class DescribeArchiveCommand extends $Command< DescribeArchiveCommandInput, DescribeArchiveCommandOutput, @@ -34,6 +37,9 @@ export class DescribeArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DescribeEventBusCommand.ts b/clients/client-eventbridge/commands/DescribeEventBusCommand.ts index 25a392c723903..95f3b4952661a 100644 --- a/clients/client-eventbridge/commands/DescribeEventBusCommand.ts +++ b/clients/client-eventbridge/commands/DescribeEventBusCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeEventBusCommandInput = DescribeEventBusRequest; export type DescribeEventBusCommandOutput = DescribeEventBusResponse & __MetadataBearer; +/** + *

Displays details about an event bus in your account. This can include the external + * AWS accounts that are permitted to write events to your default event bus, and the + * associated policy. For custom event buses and partner event buses, it displays the name, + * ARN, policy, state, and creation time.

+ *

To enable your account to receive events from other accounts on its default event + * bus, use PutPermission.

+ *

For more information about partner event buses, see CreateEventBus.

+ */ export class DescribeEventBusCommand extends $Command< DescribeEventBusCommandInput, DescribeEventBusCommandOutput, @@ -34,6 +43,9 @@ export class DescribeEventBusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DescribeEventSourceCommand.ts b/clients/client-eventbridge/commands/DescribeEventSourceCommand.ts index 35525ced081f8..9c9328e4bd588 100644 --- a/clients/client-eventbridge/commands/DescribeEventSourceCommand.ts +++ b/clients/client-eventbridge/commands/DescribeEventSourceCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEventSourceCommandInput = DescribeEventSourceRequest; export type DescribeEventSourceCommandOutput = DescribeEventSourceResponse & __MetadataBearer; +/** + *

This operation lists details about a partner event source that is shared with your + * account.

+ */ export class DescribeEventSourceCommand extends $Command< DescribeEventSourceCommandInput, DescribeEventSourceCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DescribePartnerEventSourceCommand.ts b/clients/client-eventbridge/commands/DescribePartnerEventSourceCommand.ts index 8d06cb3d01c7a..2497ef0ffce5f 100644 --- a/clients/client-eventbridge/commands/DescribePartnerEventSourceCommand.ts +++ b/clients/client-eventbridge/commands/DescribePartnerEventSourceCommand.ts @@ -20,6 +20,12 @@ import { export type DescribePartnerEventSourceCommandInput = DescribePartnerEventSourceRequest; export type DescribePartnerEventSourceCommandOutput = DescribePartnerEventSourceResponse & __MetadataBearer; +/** + *

An SaaS partner can use this operation to list details about a partner event source + * that they have created. AWS customers do not use this operation. Instead, AWS customers + * can use DescribeEventSource to see details about a partner event + * source that is shared with them.

+ */ export class DescribePartnerEventSourceCommand extends $Command< DescribePartnerEventSourceCommandInput, DescribePartnerEventSourceCommandOutput, @@ -34,6 +40,9 @@ export class DescribePartnerEventSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DescribeReplayCommand.ts b/clients/client-eventbridge/commands/DescribeReplayCommand.ts index 90c2b79da148b..781fb772b31b9 100644 --- a/clients/client-eventbridge/commands/DescribeReplayCommand.ts +++ b/clients/client-eventbridge/commands/DescribeReplayCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeReplayCommandInput = DescribeReplayRequest; export type DescribeReplayCommandOutput = DescribeReplayResponse & __MetadataBearer; +/** + *

Retrieves details about a replay. Use DescribeReplay to determine the + * progress of a running replay. A replay processes events to replay based on + * the time in the event, and replays them using 1 minute intervals. If you use StartReplay and specify an + * EventStartTime and an EventEndTime that covers a 20 minute + * time range, the events are replayed from the first minute of that 20 minute range first. + * Then the events from the second minute are replayed. You can use + * DescribeReplay to determine the progress of a replay. The value + * returned for EventLastReplayedTime indicates the time within the specified + * time range associated with the last event replayed.

+ */ export class DescribeReplayCommand extends $Command< DescribeReplayCommandInput, DescribeReplayCommandOutput, @@ -34,6 +45,9 @@ export class DescribeReplayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DescribeRuleCommand.ts b/clients/client-eventbridge/commands/DescribeRuleCommand.ts index 39a8205e0a0eb..2dfe8c16f3e05 100644 --- a/clients/client-eventbridge/commands/DescribeRuleCommand.ts +++ b/clients/client-eventbridge/commands/DescribeRuleCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeRuleCommandInput = DescribeRuleRequest; export type DescribeRuleCommandOutput = DescribeRuleResponse & __MetadataBearer; +/** + *

Describes the specified rule.

+ *

DescribeRule does not list the targets of a rule. To see the targets associated + * with a rule, use ListTargetsByRule.

+ */ export class DescribeRuleCommand extends $Command< DescribeRuleCommandInput, DescribeRuleCommandOutput, @@ -34,6 +39,9 @@ export class DescribeRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/DisableRuleCommand.ts b/clients/client-eventbridge/commands/DisableRuleCommand.ts index 043a149915130..4369ce07186b6 100644 --- a/clients/client-eventbridge/commands/DisableRuleCommand.ts +++ b/clients/client-eventbridge/commands/DisableRuleCommand.ts @@ -20,6 +20,13 @@ import { export type DisableRuleCommandInput = DisableRuleRequest; export type DisableRuleCommandOutput = __MetadataBearer; +/** + *

Disables the specified rule. A disabled rule won't match any events, and won't + * self-trigger if it has a schedule expression.

+ * + *

When you disable a rule, incoming events might continue to match to the disabled + * rule. Allow a short period of time for changes to take effect.

+ */ export class DisableRuleCommand extends $Command< DisableRuleCommandInput, DisableRuleCommandOutput, @@ -34,6 +41,9 @@ export class DisableRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/EnableRuleCommand.ts b/clients/client-eventbridge/commands/EnableRuleCommand.ts index fa6f84effd8a3..bc8be02052ed8 100644 --- a/clients/client-eventbridge/commands/EnableRuleCommand.ts +++ b/clients/client-eventbridge/commands/EnableRuleCommand.ts @@ -20,6 +20,13 @@ import { export type EnableRuleCommandInput = EnableRuleRequest; export type EnableRuleCommandOutput = __MetadataBearer; +/** + *

Enables the specified rule. If the rule does not exist, the operation + * fails.

+ * + *

When you enable a rule, incoming events might not immediately start matching to a + * newly enabled rule. Allow a short period of time for changes to take effect.

+ */ export class EnableRuleCommand extends $Command< EnableRuleCommandInput, EnableRuleCommandOutput, @@ -34,6 +41,9 @@ export class EnableRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListArchivesCommand.ts b/clients/client-eventbridge/commands/ListArchivesCommand.ts index 98b4cbcc6356e..2f9769715bd36 100644 --- a/clients/client-eventbridge/commands/ListArchivesCommand.ts +++ b/clients/client-eventbridge/commands/ListArchivesCommand.ts @@ -20,6 +20,10 @@ import { export type ListArchivesCommandInput = ListArchivesRequest; export type ListArchivesCommandOutput = ListArchivesResponse & __MetadataBearer; +/** + *

Lists your archives. You can either list all the archives or you can provide a prefix + * to match to the archive names. Filter parameters are exclusive.

+ */ export class ListArchivesCommand extends $Command< ListArchivesCommandInput, ListArchivesCommandOutput, @@ -34,6 +38,9 @@ export class ListArchivesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListEventBusesCommand.ts b/clients/client-eventbridge/commands/ListEventBusesCommand.ts index 756fb7f64a8ed..8559fdf21f9fc 100644 --- a/clients/client-eventbridge/commands/ListEventBusesCommand.ts +++ b/clients/client-eventbridge/commands/ListEventBusesCommand.ts @@ -20,6 +20,10 @@ import { export type ListEventBusesCommandInput = ListEventBusesRequest; export type ListEventBusesCommandOutput = ListEventBusesResponse & __MetadataBearer; +/** + *

Lists all the event buses in your account, including the default event bus, custom + * event buses, and partner event buses.

+ */ export class ListEventBusesCommand extends $Command< ListEventBusesCommandInput, ListEventBusesCommandOutput, @@ -34,6 +38,9 @@ export class ListEventBusesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListEventSourcesCommand.ts b/clients/client-eventbridge/commands/ListEventSourcesCommand.ts index 00a7f2b673559..da4461a955a49 100644 --- a/clients/client-eventbridge/commands/ListEventSourcesCommand.ts +++ b/clients/client-eventbridge/commands/ListEventSourcesCommand.ts @@ -20,6 +20,10 @@ import { export type ListEventSourcesCommandInput = ListEventSourcesRequest; export type ListEventSourcesCommandOutput = ListEventSourcesResponse & __MetadataBearer; +/** + *

You can use this to see all the partner event sources that have been shared with your + * AWS account. For more information about partner event sources, see CreateEventBus.

+ */ export class ListEventSourcesCommand extends $Command< ListEventSourcesCommandInput, ListEventSourcesCommandOutput, @@ -34,6 +38,9 @@ export class ListEventSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListPartnerEventSourceAccountsCommand.ts b/clients/client-eventbridge/commands/ListPartnerEventSourceAccountsCommand.ts index 66f6205c7dc04..edb87f9906556 100644 --- a/clients/client-eventbridge/commands/ListPartnerEventSourceAccountsCommand.ts +++ b/clients/client-eventbridge/commands/ListPartnerEventSourceAccountsCommand.ts @@ -20,6 +20,11 @@ import { export type ListPartnerEventSourceAccountsCommandInput = ListPartnerEventSourceAccountsRequest; export type ListPartnerEventSourceAccountsCommandOutput = ListPartnerEventSourceAccountsResponse & __MetadataBearer; +/** + *

An SaaS partner can use this operation to display the AWS account ID that a particular + * partner event source name is associated with. This operation is not used by AWS + * customers.

+ */ export class ListPartnerEventSourceAccountsCommand extends $Command< ListPartnerEventSourceAccountsCommandInput, ListPartnerEventSourceAccountsCommandOutput, @@ -34,6 +39,9 @@ export class ListPartnerEventSourceAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListPartnerEventSourcesCommand.ts b/clients/client-eventbridge/commands/ListPartnerEventSourcesCommand.ts index 689a7f1601a39..c8d1c8a20de47 100644 --- a/clients/client-eventbridge/commands/ListPartnerEventSourcesCommand.ts +++ b/clients/client-eventbridge/commands/ListPartnerEventSourcesCommand.ts @@ -20,6 +20,10 @@ import { export type ListPartnerEventSourcesCommandInput = ListPartnerEventSourcesRequest; export type ListPartnerEventSourcesCommandOutput = ListPartnerEventSourcesResponse & __MetadataBearer; +/** + *

An SaaS partner can use this operation to list all the partner event source names that + * they have created. This operation is not used by AWS customers.

+ */ export class ListPartnerEventSourcesCommand extends $Command< ListPartnerEventSourcesCommandInput, ListPartnerEventSourcesCommandOutput, @@ -34,6 +38,9 @@ export class ListPartnerEventSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListReplaysCommand.ts b/clients/client-eventbridge/commands/ListReplaysCommand.ts index 7a5ab2aec3c6e..e10c0fc8722b5 100644 --- a/clients/client-eventbridge/commands/ListReplaysCommand.ts +++ b/clients/client-eventbridge/commands/ListReplaysCommand.ts @@ -20,6 +20,10 @@ import { export type ListReplaysCommandInput = ListReplaysRequest; export type ListReplaysCommandOutput = ListReplaysResponse & __MetadataBearer; +/** + *

Lists your replays. You can either list all the replays or you can provide a prefix to + * match to the replay names. Filter parameters are exclusive.

+ */ export class ListReplaysCommand extends $Command< ListReplaysCommandInput, ListReplaysCommandOutput, @@ -34,6 +38,9 @@ export class ListReplaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListRuleNamesByTargetCommand.ts b/clients/client-eventbridge/commands/ListRuleNamesByTargetCommand.ts index 1d2c3e178e58c..f2ee06e762876 100644 --- a/clients/client-eventbridge/commands/ListRuleNamesByTargetCommand.ts +++ b/clients/client-eventbridge/commands/ListRuleNamesByTargetCommand.ts @@ -20,6 +20,10 @@ import { export type ListRuleNamesByTargetCommandInput = ListRuleNamesByTargetRequest; export type ListRuleNamesByTargetCommandOutput = ListRuleNamesByTargetResponse & __MetadataBearer; +/** + *

Lists the rules for the specified target. You can see which of the rules in Amazon + * EventBridge can invoke a specific target in your account.

+ */ export class ListRuleNamesByTargetCommand extends $Command< ListRuleNamesByTargetCommandInput, ListRuleNamesByTargetCommandOutput, @@ -34,6 +38,9 @@ export class ListRuleNamesByTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListRulesCommand.ts b/clients/client-eventbridge/commands/ListRulesCommand.ts index 6aaec665dfd7d..2097207ee7c48 100644 --- a/clients/client-eventbridge/commands/ListRulesCommand.ts +++ b/clients/client-eventbridge/commands/ListRulesCommand.ts @@ -17,6 +17,13 @@ import { export type ListRulesCommandInput = ListRulesRequest; export type ListRulesCommandOutput = ListRulesResponse & __MetadataBearer; +/** + *

Lists your Amazon EventBridge rules. You can either list all the rules or you can + * provide a prefix to match to the rule names.

+ * + *

ListRules does not list the targets of a rule. To see the targets associated with a + * rule, use ListTargetsByRule.

+ */ export class ListRulesCommand extends $Command< ListRulesCommandInput, ListRulesCommandOutput, @@ -31,6 +38,9 @@ export class ListRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListTagsForResourceCommand.ts b/clients/client-eventbridge/commands/ListTagsForResourceCommand.ts index 6f6029d368705..97a3f82c81b2a 100644 --- a/clients/client-eventbridge/commands/ListTagsForResourceCommand.ts +++ b/clients/client-eventbridge/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Displays the tags associated with an EventBridge resource. In EventBridge, rules and + * event buses can be tagged.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/ListTargetsByRuleCommand.ts b/clients/client-eventbridge/commands/ListTargetsByRuleCommand.ts index b9a613ba0e5f7..746fcea40b5e6 100644 --- a/clients/client-eventbridge/commands/ListTargetsByRuleCommand.ts +++ b/clients/client-eventbridge/commands/ListTargetsByRuleCommand.ts @@ -20,6 +20,9 @@ import { export type ListTargetsByRuleCommandInput = ListTargetsByRuleRequest; export type ListTargetsByRuleCommandOutput = ListTargetsByRuleResponse & __MetadataBearer; +/** + *

Lists the targets assigned to the specified rule.

+ */ export class ListTargetsByRuleCommand extends $Command< ListTargetsByRuleCommandInput, ListTargetsByRuleCommandOutput, @@ -34,6 +37,9 @@ export class ListTargetsByRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/PutEventsCommand.ts b/clients/client-eventbridge/commands/PutEventsCommand.ts index 06a6cb077700f..c80a4dff95565 100644 --- a/clients/client-eventbridge/commands/PutEventsCommand.ts +++ b/clients/client-eventbridge/commands/PutEventsCommand.ts @@ -17,6 +17,10 @@ import { export type PutEventsCommandInput = PutEventsRequest; export type PutEventsCommandOutput = PutEventsResponse & __MetadataBearer; +/** + *

Sends custom events to Amazon EventBridge so that they can be matched to + * rules.

+ */ export class PutEventsCommand extends $Command< PutEventsCommandInput, PutEventsCommandOutput, @@ -31,6 +35,9 @@ export class PutEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/PutPartnerEventsCommand.ts b/clients/client-eventbridge/commands/PutPartnerEventsCommand.ts index e3c493a6ee962..581c94de25261 100644 --- a/clients/client-eventbridge/commands/PutPartnerEventsCommand.ts +++ b/clients/client-eventbridge/commands/PutPartnerEventsCommand.ts @@ -20,6 +20,10 @@ import { export type PutPartnerEventsCommandInput = PutPartnerEventsRequest; export type PutPartnerEventsCommandOutput = PutPartnerEventsResponse & __MetadataBearer; +/** + *

This is used by SaaS partners to write events to a customer's partner event bus. AWS + * customers do not use this operation.

+ */ export class PutPartnerEventsCommand extends $Command< PutPartnerEventsCommandInput, PutPartnerEventsCommandOutput, @@ -34,6 +38,9 @@ export class PutPartnerEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/PutPermissionCommand.ts b/clients/client-eventbridge/commands/PutPermissionCommand.ts index adddf5c4e3f46..fec315c3db3a3 100644 --- a/clients/client-eventbridge/commands/PutPermissionCommand.ts +++ b/clients/client-eventbridge/commands/PutPermissionCommand.ts @@ -20,6 +20,30 @@ import { export type PutPermissionCommandInput = PutPermissionRequest; export type PutPermissionCommandOutput = __MetadataBearer; +/** + *

Running PutPermission permits the specified AWS account or AWS + * organization to put events to the specified event bus. Amazon + * EventBridge (CloudWatch Events) rules in your account are triggered by these events + * arriving to an event bus in your account.

+ *

For another account to send events to your account, that external account must have + * an EventBridge rule with your account's event bus as a target.

+ * + *

To enable multiple AWS accounts to put events to your event bus, run + * PutPermission once for each of these accounts. Or, if all the accounts + * are members of the same AWS organization, you can run PutPermission once + * specifying Principal as "*" and specifying the AWS organization ID in + * Condition, to grant permissions to all accounts in that + * organization.

+ * + *

If you grant permissions using an organization, then accounts in that organization + * must specify a RoleArn with proper permissions when they use + * PutTarget to add your account's event bus as a target. For more + * information, see Sending and Receiving Events Between AWS Accounts in the Amazon + * EventBridge User Guide.

+ * + *

The permission policy on the default event bus cannot exceed 10 KB in + * size.

+ */ export class PutPermissionCommand extends $Command< PutPermissionCommandInput, PutPermissionCommandOutput, @@ -34,6 +58,9 @@ export class PutPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/PutRuleCommand.ts b/clients/client-eventbridge/commands/PutRuleCommand.ts index ad4c51aa6ca84..dba019a21b5f3 100644 --- a/clients/client-eventbridge/commands/PutRuleCommand.ts +++ b/clients/client-eventbridge/commands/PutRuleCommand.ts @@ -17,6 +17,58 @@ import { export type PutRuleCommandInput = PutRuleRequest; export type PutRuleCommandOutput = PutRuleResponse & __MetadataBearer; +/** + *

Creates or updates the specified rule. Rules are enabled by default, or based on + * value of the state. You can disable a rule using DisableRule.

+ * + *

A single rule watches for events from a single event bus. Events generated by AWS + * services go to your account's default event bus. Events generated by SaaS partner + * services or applications go to the matching partner event bus. If you have custom + * applications or services, you can specify whether their events go to your default event + * bus or a custom event bus that you have created. For more information, see CreateEventBus.

+ * + *

If you are updating an existing rule, the rule is replaced with what you specify in + * this PutRule command. If you omit arguments in PutRule, the + * old values for those arguments are not kept. Instead, they are replaced with null + * values.

+ * + *

When you create or update a rule, incoming events might not immediately start + * matching to new or updated rules. Allow a short period of time for changes to take + * effect.

+ * + *

A rule must contain at least an EventPattern or ScheduleExpression. Rules with + * EventPatterns are triggered when a matching event is observed. Rules with + * ScheduleExpressions self-trigger based on the given schedule. A rule can have both an + * EventPattern and a ScheduleExpression, in which case the rule triggers on matching + * events as well as on a schedule.

+ * + *

When you initially create a rule, you can optionally assign one or more tags to the + * rule. Tags can help you organize and categorize your resources. You can also use them to + * scope user permissions, by granting a user permission to access or change only rules + * with certain tag values. To use the PutRule operation and assign tags, you + * must have both the events:PutRule and events:TagResource + * permissions.

+ *

If you are updating an existing rule, any tags you specify in the PutRule + * operation are ignored. To update the tags of an existing rule, use TagResource and UntagResource.

+ * + *

Most services in AWS treat : or / as the same character in Amazon Resource Names + * (ARNs). However, EventBridge uses an exact match in event patterns and rules. Be sure to + * use the correct ARN characters when creating event patterns so that they match the ARN + * syntax in the event you want to match.

+ * + *

In EventBridge, it is possible to create rules that lead to infinite loops, where a + * rule is fired repeatedly. For example, a rule might detect that ACLs have changed on an + * S3 bucket, and trigger software to change them to the desired state. If the rule is not + * written carefully, the subsequent change to the ACLs fires the rule again, creating an + * infinite loop.

+ *

To prevent this, write the rules so that the triggered actions do not re-fire the same + * rule. For example, your rule could fire only if ACLs are found to be in a bad state, + * instead of after any change.

+ *

An infinite loop can quickly cause higher than expected charges. We recommend that you + * use budgeting, which alerts you when charges exceed your specified limit. For more + * information, see Managing Your + * Costs with Budgets.

+ */ export class PutRuleCommand extends $Command< PutRuleCommandInput, PutRuleCommandOutput, @@ -31,6 +83,9 @@ export class PutRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/PutTargetsCommand.ts b/clients/client-eventbridge/commands/PutTargetsCommand.ts index 319614e392c80..cecfd8c8c9c08 100644 --- a/clients/client-eventbridge/commands/PutTargetsCommand.ts +++ b/clients/client-eventbridge/commands/PutTargetsCommand.ts @@ -20,6 +20,153 @@ import { export type PutTargetsCommandInput = PutTargetsRequest; export type PutTargetsCommandOutput = PutTargetsResponse & __MetadataBearer; +/** + *

Adds the specified targets to the specified rule, or updates the targets if they + * are already associated with the rule.

+ *

Targets are the resources that are invoked when a rule is triggered.

+ *

You can configure the following as targets for Events:

+ * + *
    + *
  • + *

    EC2 instances

    + *
  • + *
  • + *

    SSM Run Command

    + *
  • + *
  • + *

    SSM Automation

    + *
  • + *
  • + *

    AWS Lambda functions

    + *
  • + *
  • + *

    Data streams in Amazon Kinesis Data Streams

    + *
  • + *
  • + *

    Data delivery streams in Amazon Kinesis Data Firehose

    + *
  • + *
  • + *

    Amazon ECS tasks

    + *
  • + *
  • + *

    AWS Step Functions state machines

    + *
  • + *
  • + *

    AWS Batch jobs

    + *
  • + *
  • + *

    AWS CodeBuild projects

    + *
  • + *
  • + *

    Pipelines in AWS CodePipeline

    + *
  • + *
  • + *

    Amazon Inspector assessment templates

    + *
  • + *
  • + *

    Amazon SNS topics

    + *
  • + *
  • + *

    Amazon SQS queues, including FIFO queues

    + *
  • + *
  • + *

    The default event bus of another AWS account

    + *
  • + *
  • + *

    Amazon API Gateway REST APIs

    + *
  • + *
  • + *

    Redshift Clusters to invoke Data API ExecuteStatement on

    + *
  • + *
+ * + * + * + *

Creating rules with built-in targets is supported only in the AWS Management + * Console. The built-in targets are EC2 CreateSnapshot API call, EC2 + * RebootInstances API call, EC2 StopInstances API call, and + * EC2 TerminateInstances API call.

+ * + *

For some target types, PutTargets provides target-specific parameters. + * If the target is a Kinesis data stream, you can optionally specify which shard the event + * goes to by using the KinesisParameters argument. To invoke a command on + * multiple EC2 instances with one rule, you can use the RunCommandParameters + * field.

+ *

To be able to make API calls against the resources that you own, Amazon EventBridge + * (CloudWatch Events) needs the appropriate permissions. For AWS Lambda and Amazon SNS + * resources, EventBridge relies on resource-based policies. For EC2 instances, Kinesis + * data streams, AWS Step Functions state machines and API Gateway REST APIs, EventBridge + * relies on IAM roles that you specify in the RoleARN argument in + * PutTargets. For more information, see Authentication and Access Control in the Amazon EventBridge User + * Guide.

+ * + *

If another AWS account is in the same region and has granted you permission (using + * PutPermission), you can send events to that account. Set that account's + * event bus as a target of the rules in your account. To send the matched events to the + * other account, specify that account's event bus as the Arn value when you + * run PutTargets. If your account sends events to another account, your + * account is charged for each sent event. Each event sent to another account is charged as + * a custom event. The account receiving the event is not charged. For more information, + * see Amazon EventBridge + * (CloudWatch Events) Pricing.

+ * + * + *

+ * Input, InputPath, and InputTransformer are + * not available with PutTarget if the target is an event bus of a + * different AWS account.

+ *
+ * + *

If you are setting the event bus of another account as the target, and that account + * granted permission to your account through an organization instead of directly by the + * account ID, then you must specify a RoleArn with proper permissions in the + * Target structure. For more information, see Sending and Receiving Events Between AWS Accounts in the Amazon + * EventBridge User Guide.

+ * + *

For more information about enabling cross-account events, see PutPermission.

+ * + *

+ * Input, InputPath, and + * InputTransformer are mutually exclusive and + * optional parameters of a target. When a rule is triggered due to a matched + * event:

+ * + *
    + *
  • + *

    If none of the following arguments are specified for a target, then the + * entire event is passed to the target in JSON format (unless the target is Amazon + * EC2 Run Command or Amazon ECS task, in which case nothing from the event is + * passed to the target).

    + *
  • + *
  • + *

    If Input is specified in the form of valid + * JSON, then the matched event is overridden with this constant.

    + *
  • + *
  • + *

    If InputPath is specified in the form of + * JSONPath (for example, $.detail), then only the part of the event + * specified in the path is passed to the target (for example, only the detail part + * of the event is passed).

    + *
  • + *
  • + *

    If InputTransformer is specified, then one + * or more specified JSONPaths are extracted from the event and used as values in a + * template that you specify as the input to the target.

    + *
  • + *
+ * + *

When you specify InputPath or InputTransformer, you must + * use JSON dot notation, not bracket notation.

+ * + *

When you add targets to a rule and the associated rule triggers soon after, new or + * updated targets might not be immediately invoked. Allow a short period of time for + * changes to take effect.

+ * + *

This action can partially fail if too many requests are made at the same time. If + * that happens, FailedEntryCount is non-zero in the response and each entry + * in FailedEntries provides the ID of the failed target and the error + * code.

+ */ export class PutTargetsCommand extends $Command< PutTargetsCommandInput, PutTargetsCommandOutput, @@ -34,6 +181,9 @@ export class PutTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/RemovePermissionCommand.ts b/clients/client-eventbridge/commands/RemovePermissionCommand.ts index 68ecf7b52b4d9..31c1fdbfefe93 100644 --- a/clients/client-eventbridge/commands/RemovePermissionCommand.ts +++ b/clients/client-eventbridge/commands/RemovePermissionCommand.ts @@ -20,6 +20,12 @@ import { export type RemovePermissionCommandInput = RemovePermissionRequest; export type RemovePermissionCommandOutput = __MetadataBearer; +/** + *

Revokes the permission of another AWS account to be able to put events to the + * specified event bus. Specify the account to revoke by the StatementId value + * that you associated with the account when you granted it permission with + * PutPermission. You can find the StatementId by using DescribeEventBus.

+ */ export class RemovePermissionCommand extends $Command< RemovePermissionCommandInput, RemovePermissionCommandOutput, @@ -34,6 +40,9 @@ export class RemovePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/RemoveTargetsCommand.ts b/clients/client-eventbridge/commands/RemoveTargetsCommand.ts index e26e4faab0f97..7957ae52d95a2 100644 --- a/clients/client-eventbridge/commands/RemoveTargetsCommand.ts +++ b/clients/client-eventbridge/commands/RemoveTargetsCommand.ts @@ -20,6 +20,19 @@ import { export type RemoveTargetsCommandInput = RemoveTargetsRequest; export type RemoveTargetsCommandOutput = RemoveTargetsResponse & __MetadataBearer; +/** + *

Removes the specified targets from the specified rule. When the rule is triggered, + * those targets are no longer be invoked.

+ * + *

When you remove a target, when the associated rule triggers, removed targets might + * continue to be invoked. Allow a short period of time for changes to take + * effect.

+ * + *

This action can partially fail if too many requests are made at the same time. If + * that happens, FailedEntryCount is non-zero in the response and each entry + * in FailedEntries provides the ID of the failed target and the error + * code.

+ */ export class RemoveTargetsCommand extends $Command< RemoveTargetsCommandInput, RemoveTargetsCommandOutput, @@ -34,6 +47,9 @@ export class RemoveTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/StartReplayCommand.ts b/clients/client-eventbridge/commands/StartReplayCommand.ts index 16b73359a8e23..7a5b3ed709752 100644 --- a/clients/client-eventbridge/commands/StartReplayCommand.ts +++ b/clients/client-eventbridge/commands/StartReplayCommand.ts @@ -20,6 +20,17 @@ import { export type StartReplayCommandInput = StartReplayRequest; export type StartReplayCommandOutput = StartReplayResponse & __MetadataBearer; +/** + *

Starts the specified replay. Events are not necessarily replayed in the exact same + * order that they were added to the archive. A replay processes events to replay based on + * the time in the event, and replays them using 1 minute intervals. If you specify an + * EventStartTime and an EventEndTime that covers a 20 minute + * time range, the events are replayed from the first minute of that 20 minute range first. + * Then the events from the second minute are replayed. You can use + * DescribeReplay to determine the progress of a replay. The value + * returned for EventLastReplayedTime indicates the time within the specified + * time range associated with the last event replayed.

+ */ export class StartReplayCommand extends $Command< StartReplayCommandInput, StartReplayCommandOutput, @@ -34,6 +45,9 @@ export class StartReplayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/TagResourceCommand.ts b/clients/client-eventbridge/commands/TagResourceCommand.ts index 55426fc2bd872..10c4c43852fdb 100644 --- a/clients/client-eventbridge/commands/TagResourceCommand.ts +++ b/clients/client-eventbridge/commands/TagResourceCommand.ts @@ -20,6 +20,19 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Assigns one or more tags (key-value pairs) to the specified EventBridge resource. Tags + * can help you organize and categorize your resources. You can also use them to scope user + * permissions by granting a user permission to access or change only resources with + * certain tag values. In EventBridge, rules and event buses can be tagged.

+ *

Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of + * characters.

+ *

You can use the TagResource action with a resource that already has tags. + * If you specify a new tag key, this tag is appended to the list of tags associated with + * the resource. If you specify a tag key that is already associated with the resource, the + * new tag value that you specify replaces the previous value for that tag.

+ *

You can associate as many as 50 tags with a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +47,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/TestEventPatternCommand.ts b/clients/client-eventbridge/commands/TestEventPatternCommand.ts index e39e2c02e5590..6434781070ac9 100644 --- a/clients/client-eventbridge/commands/TestEventPatternCommand.ts +++ b/clients/client-eventbridge/commands/TestEventPatternCommand.ts @@ -20,6 +20,13 @@ import { export type TestEventPatternCommandInput = TestEventPatternRequest; export type TestEventPatternCommandOutput = TestEventPatternResponse & __MetadataBearer; +/** + *

Tests whether the specified event pattern matches the provided event.

+ *

Most services in AWS treat : or / as the same character in Amazon Resource Names + * (ARNs). However, EventBridge uses an exact match in event patterns and rules. Be sure to + * use the correct ARN characters when creating event patterns so that they match the ARN + * syntax in the event you want to match.

+ */ export class TestEventPatternCommand extends $Command< TestEventPatternCommandInput, TestEventPatternCommandOutput, @@ -34,6 +41,9 @@ export class TestEventPatternCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/UntagResourceCommand.ts b/clients/client-eventbridge/commands/UntagResourceCommand.ts index 5abb4a6fc430f..f85d4ddc22628 100644 --- a/clients/client-eventbridge/commands/UntagResourceCommand.ts +++ b/clients/client-eventbridge/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from the specified EventBridge resource. In Amazon + * EventBridge (CloudWatch Events, rules and event buses can be tagged.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/commands/UpdateArchiveCommand.ts b/clients/client-eventbridge/commands/UpdateArchiveCommand.ts index c83198964a564..504eb18c1a935 100644 --- a/clients/client-eventbridge/commands/UpdateArchiveCommand.ts +++ b/clients/client-eventbridge/commands/UpdateArchiveCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateArchiveCommandInput = UpdateArchiveRequest; export type UpdateArchiveCommandOutput = UpdateArchiveResponse & __MetadataBearer; +/** + *

Updates the specified archive.

+ */ export class UpdateArchiveCommand extends $Command< UpdateArchiveCommandInput, UpdateArchiveCommandOutput, @@ -34,6 +37,9 @@ export class UpdateArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EventBridgeClientResolvedConfig, diff --git a/clients/client-eventbridge/package.json b/clients/client-eventbridge/package.json index daa01d2d7efb6..f972efcd8e214 100644 --- a/clients/client-eventbridge/package.json +++ b/clients/client-eventbridge/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Eventbridge Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-eventbridge/runtimeConfig.browser.ts b/clients/client-eventbridge/runtimeConfig.browser.ts index f1351774a252e..7ba88c74d0598 100644 --- a/clients/client-eventbridge/runtimeConfig.browser.ts +++ b/clients/client-eventbridge/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./EventBridgeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-eventbridge/runtimeConfig.native.ts b/clients/client-eventbridge/runtimeConfig.native.ts index 574c111306db2..0e5f70f3a1488 100644 --- a/clients/client-eventbridge/runtimeConfig.native.ts +++ b/clients/client-eventbridge/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./EventBridgeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-eventbridge/runtimeConfig.shared.ts b/clients/client-eventbridge/runtimeConfig.shared.ts index 2e920ae26073d..763c06b2e68a4 100644 --- a/clients/client-eventbridge/runtimeConfig.shared.ts +++ b/clients/client-eventbridge/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-10-07", disableHostPrefix: false, diff --git a/clients/client-eventbridge/runtimeConfig.ts b/clients/client-eventbridge/runtimeConfig.ts index 6e9f3e7f4220a..49ab30278bb46 100644 --- a/clients/client-eventbridge/runtimeConfig.ts +++ b/clients/client-eventbridge/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./EventBridgeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-eventbridge/tsconfig.json b/clients/client-eventbridge/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-eventbridge/tsconfig.json +++ b/clients/client-eventbridge/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-firehose/commands/CreateDeliveryStreamCommand.ts b/clients/client-firehose/commands/CreateDeliveryStreamCommand.ts index c421281a374fc..2e21a87d2cd5c 100644 --- a/clients/client-firehose/commands/CreateDeliveryStreamCommand.ts +++ b/clients/client-firehose/commands/CreateDeliveryStreamCommand.ts @@ -20,6 +20,77 @@ import { export type CreateDeliveryStreamCommandInput = CreateDeliveryStreamInput; export type CreateDeliveryStreamCommandOutput = CreateDeliveryStreamOutput & __MetadataBearer; +/** + *

Creates a Kinesis Data Firehose delivery stream.

+ * + *

By default, you can create up to 50 delivery streams per AWS Region.

+ *

This is an asynchronous operation that immediately returns. The initial status of the + * delivery stream is CREATING. After the delivery stream is created, its status + * is ACTIVE and it now accepts data. If the delivery stream creation fails, the + * status transitions to CREATING_FAILED. Attempts to send data to a delivery + * stream that is not in the ACTIVE state cause an exception. To check the state + * of a delivery stream, use DescribeDeliveryStream.

+ *

If the status of a delivery stream is CREATING_FAILED, this status + * doesn't change, and you can't invoke CreateDeliveryStream again on it. + * However, you can invoke the DeleteDeliveryStream operation to delete + * it.

+ *

A Kinesis Data Firehose delivery stream can be configured to receive records directly + * from providers using PutRecord or PutRecordBatch, or it + * can be configured to use an existing Kinesis stream as its source. To specify a Kinesis + * data stream as input, set the DeliveryStreamType parameter to + * KinesisStreamAsSource, and provide the Kinesis stream Amazon Resource Name + * (ARN) and role ARN in the KinesisStreamSourceConfiguration + * parameter.

+ *

To create a delivery stream with server-side encryption (SSE) enabled, include DeliveryStreamEncryptionConfigurationInput in your request. This is + * optional. You can also invoke StartDeliveryStreamEncryption to turn on + * SSE for an existing delivery stream that doesn't have SSE enabled.

+ *

A delivery stream is configured with a single destination: Amazon S3, Amazon ES, + * Amazon Redshift, or Splunk. You must specify only one of the following destination + * configuration parameters: ExtendedS3DestinationConfiguration, + * S3DestinationConfiguration, + * ElasticsearchDestinationConfiguration, + * RedshiftDestinationConfiguration, or + * SplunkDestinationConfiguration.

+ *

When you specify S3DestinationConfiguration, you can also provide the + * following optional values: BufferingHints, EncryptionConfiguration, and + * CompressionFormat. By default, if no BufferingHints value is + * provided, Kinesis Data Firehose buffers data up to 5 MB or for 5 minutes, whichever + * condition is satisfied first. BufferingHints is a hint, so there are some + * cases where the service cannot adhere to these conditions strictly. For example, record + * boundaries might be such that the size is a little over or under the configured buffering + * size. By default, no encryption is performed. We strongly recommend that you enable + * encryption to ensure secure data storage in Amazon S3.

+ * + *

A few notes about Amazon Redshift as a destination:

+ *
    + *
  • + *

    An Amazon Redshift destination requires an S3 bucket as intermediate location. + * Kinesis Data Firehose first delivers data to Amazon S3 and then uses + * COPY syntax to load data into an Amazon Redshift table. This is + * specified in the RedshiftDestinationConfiguration.S3Configuration + * parameter.

    + * + *
  • + *
  • + *

    The compression formats SNAPPY or ZIP cannot be + * specified in RedshiftDestinationConfiguration.S3Configuration because + * the Amazon Redshift COPY operation that reads from the S3 bucket doesn't + * support these compression formats.

    + *
  • + *
  • + *

    We strongly recommend that you use the user name and password you provide + * exclusively with Kinesis Data Firehose, and that the permissions for the account are + * restricted for Amazon Redshift INSERT permissions.

    + * + *
  • + *
+ *

Kinesis Data Firehose assumes the IAM role that is configured as part of the + * destination. The role should allow the Kinesis Data Firehose principal to assume the role, + * and the role should have permissions that allow the service to deliver the data. For more + * information, see Grant Kinesis Data + * Firehose Access to an Amazon S3 Destination in the Amazon Kinesis Data + * Firehose Developer Guide.

+ */ export class CreateDeliveryStreamCommand extends $Command< CreateDeliveryStreamCommandInput, CreateDeliveryStreamCommandOutput, @@ -34,6 +105,9 @@ export class CreateDeliveryStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/DeleteDeliveryStreamCommand.ts b/clients/client-firehose/commands/DeleteDeliveryStreamCommand.ts index 4d640dadc1f6d..ac4465ea3e969 100644 --- a/clients/client-firehose/commands/DeleteDeliveryStreamCommand.ts +++ b/clients/client-firehose/commands/DeleteDeliveryStreamCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteDeliveryStreamCommandInput = DeleteDeliveryStreamInput; export type DeleteDeliveryStreamCommandOutput = DeleteDeliveryStreamOutput & __MetadataBearer; +/** + *

Deletes a delivery stream and its data.

+ *

To check the state of a delivery stream, use DescribeDeliveryStream. You can delete a delivery stream only if it is in one of the following states: + * ACTIVE, DELETING, CREATING_FAILED, or + * DELETING_FAILED. You can't delete a delivery stream that is in the + * CREATING state. While the deletion request is in process, the delivery + * stream is in the DELETING state.

+ *

While the delivery stream is in the DELETING state, the service might + * continue to accept records, but it doesn't make any guarantees with respect to delivering + * the data. Therefore, as a best practice, first stop any applications that are sending + * records before you delete a delivery stream.

+ */ export class DeleteDeliveryStreamCommand extends $Command< DeleteDeliveryStreamCommandInput, DeleteDeliveryStreamCommandOutput, @@ -34,6 +46,9 @@ export class DeleteDeliveryStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/DescribeDeliveryStreamCommand.ts b/clients/client-firehose/commands/DescribeDeliveryStreamCommand.ts index 2bd7b27329cce..a9057a41fd9bc 100644 --- a/clients/client-firehose/commands/DescribeDeliveryStreamCommand.ts +++ b/clients/client-firehose/commands/DescribeDeliveryStreamCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeDeliveryStreamCommandInput = DescribeDeliveryStreamInput; export type DescribeDeliveryStreamCommandOutput = DescribeDeliveryStreamOutput & __MetadataBearer; +/** + *

Describes the specified delivery stream and its status. For example, after your + * delivery stream is created, call DescribeDeliveryStream to see whether the + * delivery stream is ACTIVE and therefore ready for data to be sent to it.

+ *

If the status of a delivery stream is CREATING_FAILED, this status + * doesn't change, and you can't invoke CreateDeliveryStream again on it. + * However, you can invoke the DeleteDeliveryStream operation to delete it. + * If the status is DELETING_FAILED, you can force deletion by invoking DeleteDeliveryStream again but with DeleteDeliveryStreamInput$AllowForceDelete set to true.

+ */ export class DescribeDeliveryStreamCommand extends $Command< DescribeDeliveryStreamCommandInput, DescribeDeliveryStreamCommandOutput, @@ -34,6 +43,9 @@ export class DescribeDeliveryStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/ListDeliveryStreamsCommand.ts b/clients/client-firehose/commands/ListDeliveryStreamsCommand.ts index e443a72091682..e7c7df366810e 100644 --- a/clients/client-firehose/commands/ListDeliveryStreamsCommand.ts +++ b/clients/client-firehose/commands/ListDeliveryStreamsCommand.ts @@ -20,6 +20,16 @@ import { export type ListDeliveryStreamsCommandInput = ListDeliveryStreamsInput; export type ListDeliveryStreamsCommandOutput = ListDeliveryStreamsOutput & __MetadataBearer; +/** + *

Lists your delivery streams in alphabetical order of their names.

+ *

The number of delivery streams might be too large to return using a single call to + * ListDeliveryStreams. You can limit the number of delivery streams returned, + * using the Limit parameter. To determine whether there are more delivery + * streams to list, check the value of HasMoreDeliveryStreams in the output. If + * there are more delivery streams to list, you can request them by calling this operation + * again and setting the ExclusiveStartDeliveryStreamName parameter to the name + * of the last delivery stream returned in the last call.

+ */ export class ListDeliveryStreamsCommand extends $Command< ListDeliveryStreamsCommandInput, ListDeliveryStreamsCommandOutput, @@ -34,6 +44,9 @@ export class ListDeliveryStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/ListTagsForDeliveryStreamCommand.ts b/clients/client-firehose/commands/ListTagsForDeliveryStreamCommand.ts index bb7164310b5be..5788ed374150c 100644 --- a/clients/client-firehose/commands/ListTagsForDeliveryStreamCommand.ts +++ b/clients/client-firehose/commands/ListTagsForDeliveryStreamCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForDeliveryStreamCommandInput = ListTagsForDeliveryStreamInput; export type ListTagsForDeliveryStreamCommandOutput = ListTagsForDeliveryStreamOutput & __MetadataBearer; +/** + *

Lists the tags for the specified delivery stream. This operation has a limit of five + * transactions per second per account.

+ */ export class ListTagsForDeliveryStreamCommand extends $Command< ListTagsForDeliveryStreamCommandInput, ListTagsForDeliveryStreamCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForDeliveryStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/PutRecordBatchCommand.ts b/clients/client-firehose/commands/PutRecordBatchCommand.ts index d4ad3e251bb45..c6af3b7de15e7 100644 --- a/clients/client-firehose/commands/PutRecordBatchCommand.ts +++ b/clients/client-firehose/commands/PutRecordBatchCommand.ts @@ -20,6 +20,59 @@ import { export type PutRecordBatchCommandInput = PutRecordBatchInput; export type PutRecordBatchCommandOutput = PutRecordBatchOutput & __MetadataBearer; +/** + *

Writes multiple data records into a delivery stream in a single call, which can + * achieve higher throughput per producer than when writing single records. To write single + * data records into a delivery stream, use PutRecord. Applications using + * these operations are referred to as producers.

+ *

For information about service quota, see Amazon Kinesis Data Firehose + * Quota.

+ *

Each PutRecordBatch request supports up to 500 records. Each record + * in the request can be as large as 1,000 KB (before 64-bit encoding), up to a limit of 4 MB + * for the entire request. These limits cannot be changed.

+ *

You must specify the name of the delivery stream and the data record when using PutRecord. The data record consists of a data blob that can be up to 1,000 + * KB in size, and any kind of data. For example, it could be a segment from a log file, + * geographic location data, website clickstream data, and so on.

+ *

Kinesis Data Firehose buffers records before delivering them to the destination. To + * disambiguate the data blobs at the destination, a common solution is to use delimiters in + * the data, such as a newline (\n) or some other character unique within the + * data. This allows the consumer application to parse individual data items when reading the + * data from the destination.

+ *

The PutRecordBatch response includes a count of failed records, + * FailedPutCount, and an array of responses, RequestResponses. + * Even if the PutRecordBatch call succeeds, the value of + * FailedPutCount may be greater than 0, indicating that there are records for + * which the operation didn't succeed. Each entry in the RequestResponses array + * provides additional information about the processed record. It directly correlates with a + * record in the request array using the same ordering, from the top to the bottom. The + * response array always includes the same number of records as the request array. + * RequestResponses includes both successfully and unsuccessfully processed + * records. Kinesis Data Firehose tries to process all records in each PutRecordBatch request. A single record failure does not stop the processing + * of subsequent records.

+ *

A successfully processed record includes a RecordId value, which is + * unique for the record. An unsuccessfully processed record includes ErrorCode + * and ErrorMessage values. ErrorCode reflects the type of error, + * and is one of the following values: ServiceUnavailableException or + * InternalFailure. ErrorMessage provides more detailed + * information about the error.

+ *

If there is an internal server error or a timeout, the write might have completed or + * it might have failed. If FailedPutCount is greater than 0, retry the request, + * resending only those records that might have failed processing. This minimizes the possible + * duplicate records and also reduces the total bytes sent (and corresponding charges). We + * recommend that you handle any duplicates at the destination.

+ *

If PutRecordBatch throws ServiceUnavailableException, + * back off and retry. If the exception persists, it is possible that the throughput limits + * have been exceeded for the delivery stream.

+ * + *

Data records sent to Kinesis Data Firehose are stored for 24 hours from the time they + * are added to a delivery stream as it attempts to send the records to the destination. If + * the destination is unreachable for more than 24 hours, the data is no longer + * available.

+ * + *

Don't concatenate two or more base64 strings to form the data fields of your records. + * Instead, concatenate the raw data, then perform base64 encoding.

+ *
+ */ export class PutRecordBatchCommand extends $Command< PutRecordBatchCommandInput, PutRecordBatchCommandOutput, @@ -34,6 +87,9 @@ export class PutRecordBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/PutRecordCommand.ts b/clients/client-firehose/commands/PutRecordCommand.ts index 1cb9d3ed8c5dd..bb55bdfeb5b18 100644 --- a/clients/client-firehose/commands/PutRecordCommand.ts +++ b/clients/client-firehose/commands/PutRecordCommand.ts @@ -17,6 +17,40 @@ import { export type PutRecordCommandInput = PutRecordInput; export type PutRecordCommandOutput = PutRecordOutput & __MetadataBearer; +/** + *

Writes a single data record into an Amazon Kinesis Data Firehose delivery stream. To + * write multiple data records into a delivery stream, use PutRecordBatch. + * Applications using these operations are referred to as producers.

+ *

By default, each delivery stream can take in up to 2,000 transactions per second, + * 5,000 records per second, or 5 MB per second. If you use PutRecord and + * PutRecordBatch, the limits are an aggregate across these two + * operations for each delivery stream. For more information about limits and how to request + * an increase, see Amazon + * Kinesis Data Firehose Limits.

+ *

You must specify the name of the delivery stream and the data record when using PutRecord. The data record consists of a data blob that can be up to 1,000 + * KB in size, and any kind of data. For example, it can be a segment from a log file, + * geographic location data, website clickstream data, and so on.

+ *

Kinesis Data Firehose buffers records before delivering them to the destination. To + * disambiguate the data blobs at the destination, a common solution is to use delimiters in + * the data, such as a newline (\n) or some other character unique within the + * data. This allows the consumer application to parse individual data items when reading the + * data from the destination.

+ *

The PutRecord operation returns a RecordId, which is a + * unique string assigned to each record. Producer applications can use this ID for purposes + * such as auditability and investigation.

+ *

If the PutRecord operation throws a + * ServiceUnavailableException, back off and retry. If the exception persists, + * it is possible that the throughput limits have been exceeded for the delivery stream.

+ *

Data records sent to Kinesis Data Firehose are stored for 24 hours from the time they + * are added to a delivery stream as it tries to send the records to the destination. If the + * destination is unreachable for more than 24 hours, the data is no longer + * available.

+ * + * + *

Don't concatenate two or more base64 strings to form the data fields of your records. + * Instead, concatenate the raw data, then perform base64 encoding.

+ *
+ */ export class PutRecordCommand extends $Command< PutRecordCommandInput, PutRecordCommandOutput, @@ -31,6 +65,9 @@ export class PutRecordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/StartDeliveryStreamEncryptionCommand.ts b/clients/client-firehose/commands/StartDeliveryStreamEncryptionCommand.ts index 2f7ac1f2efdbc..428b17ea5bba8 100644 --- a/clients/client-firehose/commands/StartDeliveryStreamEncryptionCommand.ts +++ b/clients/client-firehose/commands/StartDeliveryStreamEncryptionCommand.ts @@ -20,6 +20,44 @@ import { export type StartDeliveryStreamEncryptionCommandInput = StartDeliveryStreamEncryptionInput; export type StartDeliveryStreamEncryptionCommandOutput = StartDeliveryStreamEncryptionOutput & __MetadataBearer; +/** + *

Enables server-side encryption (SSE) for the delivery stream.

+ *

This operation is asynchronous. It returns immediately. When you invoke it, Kinesis Data + * Firehose first sets the encryption status of the stream to ENABLING, and then + * to ENABLED. The encryption status of a delivery stream is the + * Status property in DeliveryStreamEncryptionConfiguration. + * If the operation fails, the encryption status changes to ENABLING_FAILED. You + * can continue to read and write data to your delivery stream while the encryption status is + * ENABLING, but the data is not encrypted. It can take up to 5 seconds after + * the encryption status changes to ENABLED before all records written to the + * delivery stream are encrypted. To find out whether a record or a batch of records was + * encrypted, check the response elements PutRecordOutput$Encrypted and + * PutRecordBatchOutput$Encrypted, respectively.

+ *

To check the encryption status of a delivery stream, use DescribeDeliveryStream.

+ *

Even if encryption is currently enabled for a delivery stream, you can still invoke this + * operation on it to change the ARN of the CMK or both its type and ARN. If you invoke this + * method to change the CMK, and the old CMK is of type CUSTOMER_MANAGED_CMK, + * Kinesis Data Firehose schedules the grant it had on the old CMK for retirement. If the new + * CMK is of type CUSTOMER_MANAGED_CMK, Kinesis Data Firehose creates a grant + * that enables it to use the new CMK to encrypt and decrypt data and to manage the + * grant.

+ *

If a delivery stream already has encryption enabled and then you invoke this operation + * to change the ARN of the CMK or both its type and ARN and you get + * ENABLING_FAILED, this only means that the attempt to change the CMK failed. + * In this case, encryption remains enabled with the old CMK.

+ *

If the encryption status of your delivery stream is ENABLING_FAILED, you + * can invoke this operation again with a valid CMK. The CMK must be enabled and the key + * policy mustn't explicitly deny the permission for Kinesis Data Firehose to invoke KMS + * encrypt and decrypt operations.

+ *

You can enable SSE for a delivery stream only if it's a delivery stream that uses + * DirectPut as its source.

+ *

The StartDeliveryStreamEncryption and + * StopDeliveryStreamEncryption operations have a combined limit of 25 calls + * per delivery stream per 24 hours. For example, you reach the limit if you call + * StartDeliveryStreamEncryption 13 times and + * StopDeliveryStreamEncryption 12 times for the same delivery stream in a + * 24-hour period.

+ */ export class StartDeliveryStreamEncryptionCommand extends $Command< StartDeliveryStreamEncryptionCommandInput, StartDeliveryStreamEncryptionCommandOutput, @@ -34,6 +72,9 @@ export class StartDeliveryStreamEncryptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/StopDeliveryStreamEncryptionCommand.ts b/clients/client-firehose/commands/StopDeliveryStreamEncryptionCommand.ts index 720a0aa043615..ece886c8c08fc 100644 --- a/clients/client-firehose/commands/StopDeliveryStreamEncryptionCommand.ts +++ b/clients/client-firehose/commands/StopDeliveryStreamEncryptionCommand.ts @@ -20,6 +20,28 @@ import { export type StopDeliveryStreamEncryptionCommandInput = StopDeliveryStreamEncryptionInput; export type StopDeliveryStreamEncryptionCommandOutput = StopDeliveryStreamEncryptionOutput & __MetadataBearer; +/** + *

Disables server-side encryption (SSE) for the delivery stream.

+ *

This operation is asynchronous. It returns immediately. When you invoke it, Kinesis Data + * Firehose first sets the encryption status of the stream to DISABLING, and then + * to DISABLED. You can continue to read and write data to your stream while its + * status is DISABLING. It can take up to 5 seconds after the encryption status + * changes to DISABLED before all records written to the delivery stream are no + * longer subject to encryption. To find out whether a record or a batch of records was + * encrypted, check the response elements PutRecordOutput$Encrypted and + * PutRecordBatchOutput$Encrypted, respectively.

+ *

To check the encryption state of a delivery stream, use DescribeDeliveryStream.

+ *

If SSE is enabled using a customer managed CMK and then you invoke + * StopDeliveryStreamEncryption, Kinesis Data Firehose schedules the related + * KMS grant for retirement and then retires it after it ensures that it is finished + * delivering records to the destination.

+ *

The StartDeliveryStreamEncryption and + * StopDeliveryStreamEncryption operations have a combined limit of 25 calls + * per delivery stream per 24 hours. For example, you reach the limit if you call + * StartDeliveryStreamEncryption 13 times and + * StopDeliveryStreamEncryption 12 times for the same delivery stream in a + * 24-hour period.

+ */ export class StopDeliveryStreamEncryptionCommand extends $Command< StopDeliveryStreamEncryptionCommandInput, StopDeliveryStreamEncryptionCommandOutput, @@ -34,6 +56,9 @@ export class StopDeliveryStreamEncryptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/TagDeliveryStreamCommand.ts b/clients/client-firehose/commands/TagDeliveryStreamCommand.ts index 5a4851ed0210b..7f670855c1daa 100644 --- a/clients/client-firehose/commands/TagDeliveryStreamCommand.ts +++ b/clients/client-firehose/commands/TagDeliveryStreamCommand.ts @@ -20,6 +20,17 @@ import { export type TagDeliveryStreamCommandInput = TagDeliveryStreamInput; export type TagDeliveryStreamCommandOutput = TagDeliveryStreamOutput & __MetadataBearer; +/** + *

Adds or updates tags for the specified delivery stream. A tag is a key-value pair + * that you can define and assign to AWS resources. If you specify a tag that already exists, + * the tag value is replaced with the value that you specify in the request. Tags are + * metadata. For example, you can add friendly names and descriptions or other types of + * information that can help you distinguish the delivery stream. For more information about + * tags, see Using Cost Allocation Tags in the AWS Billing and Cost Management + * User Guide.

+ *

Each delivery stream can have up to 50 tags.

+ *

This operation has a limit of five transactions per second per account.

+ */ export class TagDeliveryStreamCommand extends $Command< TagDeliveryStreamCommandInput, TagDeliveryStreamCommandOutput, @@ -34,6 +45,9 @@ export class TagDeliveryStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/UntagDeliveryStreamCommand.ts b/clients/client-firehose/commands/UntagDeliveryStreamCommand.ts index 0e610c42afdd1..93b8a59fba644 100644 --- a/clients/client-firehose/commands/UntagDeliveryStreamCommand.ts +++ b/clients/client-firehose/commands/UntagDeliveryStreamCommand.ts @@ -20,6 +20,12 @@ import { export type UntagDeliveryStreamCommandInput = UntagDeliveryStreamInput; export type UntagDeliveryStreamCommandOutput = UntagDeliveryStreamOutput & __MetadataBearer; +/** + *

Removes tags from the specified delivery stream. Removed tags are deleted, and you + * can't recover them after this operation successfully completes.

+ *

If you specify a tag that doesn't exist, the operation ignores it.

+ *

This operation has a limit of five transactions per second per account.

+ */ export class UntagDeliveryStreamCommand extends $Command< UntagDeliveryStreamCommandInput, UntagDeliveryStreamCommandOutput, @@ -34,6 +40,9 @@ export class UntagDeliveryStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/commands/UpdateDestinationCommand.ts b/clients/client-firehose/commands/UpdateDestinationCommand.ts index e7582ce28f09c..63b9b2aed80e1 100644 --- a/clients/client-firehose/commands/UpdateDestinationCommand.ts +++ b/clients/client-firehose/commands/UpdateDestinationCommand.ts @@ -20,6 +20,32 @@ import { export type UpdateDestinationCommandInput = UpdateDestinationInput; export type UpdateDestinationCommandOutput = UpdateDestinationOutput & __MetadataBearer; +/** + *

Updates the specified destination of the specified delivery stream.

+ * + *

Use this operation to change the destination type (for example, to replace the Amazon + * S3 destination with Amazon Redshift) or change the parameters associated with a destination + * (for example, to change the bucket name of the Amazon S3 destination). The update might not + * occur immediately. The target delivery stream remains active while the configurations are + * updated, so data writes to the delivery stream can continue during this process. The + * updated configurations are usually effective within a few minutes.

+ *

Switching between Amazon ES and other services is not supported. For an Amazon ES + * destination, you can only update to another Amazon ES destination.

+ *

If the destination type is the same, Kinesis Data Firehose merges the configuration + * parameters specified with the destination configuration that already exists on the delivery + * stream. If any of the parameters are not specified in the call, the existing values are + * retained. For example, in the Amazon S3 destination, if EncryptionConfiguration is not specified, then the existing + * EncryptionConfiguration is maintained on the destination.

+ *

If the destination type is not the same, for example, changing the destination from + * Amazon S3 to Amazon Redshift, Kinesis Data Firehose does not merge any parameters. In this + * case, all parameters must be specified.

+ * + *

Kinesis Data Firehose uses CurrentDeliveryStreamVersionId to avoid race + * conditions and conflicting merges. This is a required field, and the service updates the + * configuration only if the existing configuration has a version ID that matches. After the + * update is applied successfully, the version ID is updated, and can be retrieved using DescribeDeliveryStream. Use the new version ID to set + * CurrentDeliveryStreamVersionId in the next call.

+ */ export class UpdateDestinationCommand extends $Command< UpdateDestinationCommandInput, UpdateDestinationCommandOutput, @@ -34,6 +60,9 @@ export class UpdateDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FirehoseClientResolvedConfig, diff --git a/clients/client-firehose/package.json b/clients/client-firehose/package.json index d279e967be664..731fb3230e2d1 100644 --- a/clients/client-firehose/package.json +++ b/clients/client-firehose/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Firehose Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-firehose/runtimeConfig.browser.ts b/clients/client-firehose/runtimeConfig.browser.ts index b40d93e18fbdd..8385939325656 100644 --- a/clients/client-firehose/runtimeConfig.browser.ts +++ b/clients/client-firehose/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./FirehoseClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-firehose/runtimeConfig.native.ts b/clients/client-firehose/runtimeConfig.native.ts index 7be6727357572..56e99155daabf 100644 --- a/clients/client-firehose/runtimeConfig.native.ts +++ b/clients/client-firehose/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./FirehoseClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-firehose/runtimeConfig.shared.ts b/clients/client-firehose/runtimeConfig.shared.ts index 3799853526b5f..376f6aa06a61c 100644 --- a/clients/client-firehose/runtimeConfig.shared.ts +++ b/clients/client-firehose/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-08-04", disableHostPrefix: false, diff --git a/clients/client-firehose/runtimeConfig.ts b/clients/client-firehose/runtimeConfig.ts index 78caa0585490a..53ec05d589dbe 100644 --- a/clients/client-firehose/runtimeConfig.ts +++ b/clients/client-firehose/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./FirehoseClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-firehose/tsconfig.json b/clients/client-firehose/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-firehose/tsconfig.json +++ b/clients/client-firehose/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-fms/commands/AssociateAdminAccountCommand.ts b/clients/client-fms/commands/AssociateAdminAccountCommand.ts index d9e67157b671d..d2316c50b5974 100644 --- a/clients/client-fms/commands/AssociateAdminAccountCommand.ts +++ b/clients/client-fms/commands/AssociateAdminAccountCommand.ts @@ -20,6 +20,15 @@ import { export type AssociateAdminAccountCommandInput = AssociateAdminAccountRequest; export type AssociateAdminAccountCommandOutput = __MetadataBearer; +/** + *

Sets the AWS Firewall Manager administrator account. AWS Firewall Manager must be + * associated with the master account of your AWS organization or associated with a member + * account that has the appropriate permissions. If the account ID that you submit is not an AWS + * Organizations master account, AWS Firewall Manager will set the appropriate permissions for + * the given member account.

+ *

The account that you associate with AWS Firewall Manager is called the AWS Firewall + * Manager administrator account.

+ */ export class AssociateAdminAccountCommand extends $Command< AssociateAdminAccountCommandInput, AssociateAdminAccountCommandOutput, @@ -34,6 +43,9 @@ export class AssociateAdminAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/DeleteAppsListCommand.ts b/clients/client-fms/commands/DeleteAppsListCommand.ts index 4bb8f573ddfe1..4c7522944c548 100644 --- a/clients/client-fms/commands/DeleteAppsListCommand.ts +++ b/clients/client-fms/commands/DeleteAppsListCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAppsListCommandInput = DeleteAppsListRequest; export type DeleteAppsListCommandOutput = __MetadataBearer; +/** + *

Permanently deletes an AWS Firewall Manager applications list.

+ */ export class DeleteAppsListCommand extends $Command< DeleteAppsListCommandInput, DeleteAppsListCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAppsListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/DeleteNotificationChannelCommand.ts b/clients/client-fms/commands/DeleteNotificationChannelCommand.ts index 0cb11a7975298..3150c9d205a2b 100644 --- a/clients/client-fms/commands/DeleteNotificationChannelCommand.ts +++ b/clients/client-fms/commands/DeleteNotificationChannelCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteNotificationChannelCommandInput = DeleteNotificationChannelRequest; export type DeleteNotificationChannelCommandOutput = __MetadataBearer; +/** + *

Deletes an AWS Firewall Manager association with the IAM role and the Amazon Simple + * Notification Service (SNS) topic that is used to record AWS Firewall Manager SNS logs.

+ */ export class DeleteNotificationChannelCommand extends $Command< DeleteNotificationChannelCommandInput, DeleteNotificationChannelCommandOutput, @@ -34,6 +38,9 @@ export class DeleteNotificationChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/DeletePolicyCommand.ts b/clients/client-fms/commands/DeletePolicyCommand.ts index 8588f7302b3c6..ce26bee36e1a1 100644 --- a/clients/client-fms/commands/DeletePolicyCommand.ts +++ b/clients/client-fms/commands/DeletePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePolicyCommandInput = DeletePolicyRequest; export type DeletePolicyCommandOutput = __MetadataBearer; +/** + *

Permanently deletes an AWS Firewall Manager policy.

+ */ export class DeletePolicyCommand extends $Command< DeletePolicyCommandInput, DeletePolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeletePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/DeleteProtocolsListCommand.ts b/clients/client-fms/commands/DeleteProtocolsListCommand.ts index ac2d19d7a9ec6..43d02ae78de2e 100644 --- a/clients/client-fms/commands/DeleteProtocolsListCommand.ts +++ b/clients/client-fms/commands/DeleteProtocolsListCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProtocolsListCommandInput = DeleteProtocolsListRequest; export type DeleteProtocolsListCommandOutput = __MetadataBearer; +/** + *

Permanently deletes an AWS Firewall Manager protocols list.

+ */ export class DeleteProtocolsListCommand extends $Command< DeleteProtocolsListCommandInput, DeleteProtocolsListCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProtocolsListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/DisassociateAdminAccountCommand.ts b/clients/client-fms/commands/DisassociateAdminAccountCommand.ts index 6ad2d46db6f76..c1ea5a63d95e5 100644 --- a/clients/client-fms/commands/DisassociateAdminAccountCommand.ts +++ b/clients/client-fms/commands/DisassociateAdminAccountCommand.ts @@ -20,6 +20,11 @@ import { export type DisassociateAdminAccountCommandInput = DisassociateAdminAccountRequest; export type DisassociateAdminAccountCommandOutput = __MetadataBearer; +/** + *

Disassociates the account that has been set as the AWS Firewall Manager administrator + * account. To set a different account as the administrator account, you must submit an + * AssociateAdminAccount request.

+ */ export class DisassociateAdminAccountCommand extends $Command< DisassociateAdminAccountCommandInput, DisassociateAdminAccountCommandOutput, @@ -34,6 +39,9 @@ export class DisassociateAdminAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/GetAdminAccountCommand.ts b/clients/client-fms/commands/GetAdminAccountCommand.ts index 9bb26f590f7ce..86a757f8e68a3 100644 --- a/clients/client-fms/commands/GetAdminAccountCommand.ts +++ b/clients/client-fms/commands/GetAdminAccountCommand.ts @@ -20,6 +20,10 @@ import { export type GetAdminAccountCommandInput = GetAdminAccountRequest; export type GetAdminAccountCommandOutput = GetAdminAccountResponse & __MetadataBearer; +/** + *

Returns the AWS Organizations master account that is associated with AWS Firewall Manager + * as the AWS Firewall Manager administrator.

+ */ export class GetAdminAccountCommand extends $Command< GetAdminAccountCommandInput, GetAdminAccountCommandOutput, @@ -34,6 +38,9 @@ export class GetAdminAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/GetAppsListCommand.ts b/clients/client-fms/commands/GetAppsListCommand.ts index 0455a87361cbe..f2bc717f3142a 100644 --- a/clients/client-fms/commands/GetAppsListCommand.ts +++ b/clients/client-fms/commands/GetAppsListCommand.ts @@ -20,6 +20,9 @@ import { export type GetAppsListCommandInput = GetAppsListRequest; export type GetAppsListCommandOutput = GetAppsListResponse & __MetadataBearer; +/** + *

Returns information about the specified AWS Firewall Manager applications list.

+ */ export class GetAppsListCommand extends $Command< GetAppsListCommandInput, GetAppsListCommandOutput, @@ -34,6 +37,9 @@ export class GetAppsListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/GetComplianceDetailCommand.ts b/clients/client-fms/commands/GetComplianceDetailCommand.ts index 9041bce48587e..54833e7ddd462 100644 --- a/clients/client-fms/commands/GetComplianceDetailCommand.ts +++ b/clients/client-fms/commands/GetComplianceDetailCommand.ts @@ -20,6 +20,17 @@ import { export type GetComplianceDetailCommandInput = GetComplianceDetailRequest; export type GetComplianceDetailCommandOutput = GetComplianceDetailResponse & __MetadataBearer; +/** + *

Returns detailed compliance information about the specified member account. Details + * include resources that are in and out of compliance with the specified policy. Resources are + * considered noncompliant for AWS WAF and Shield Advanced policies if the specified policy has + * not been applied to them. Resources are considered noncompliant for security group policies if + * they are in scope of the policy, they violate one or more of the policy rules, and remediation + * is disabled or not possible. Resources are considered noncompliant for Network Firewall policies + * if a firewall is missing in the VPC, if the firewall endpoint isn't set up in an expected Availability Zone and subnet, + * if a subnet created by the Firewall Manager doesn't have the expected route table, + * and for modifications to a firewall policy that violate the Firewall Manager policy's rules.

+ */ export class GetComplianceDetailCommand extends $Command< GetComplianceDetailCommandInput, GetComplianceDetailCommandOutput, @@ -34,6 +45,9 @@ export class GetComplianceDetailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/GetNotificationChannelCommand.ts b/clients/client-fms/commands/GetNotificationChannelCommand.ts index 04a4e3b392bd0..2521611ba0bef 100644 --- a/clients/client-fms/commands/GetNotificationChannelCommand.ts +++ b/clients/client-fms/commands/GetNotificationChannelCommand.ts @@ -20,6 +20,11 @@ import { export type GetNotificationChannelCommandInput = GetNotificationChannelRequest; export type GetNotificationChannelCommandOutput = GetNotificationChannelResponse & __MetadataBearer; +/** + *

Information + * about the Amazon Simple Notification Service (SNS) topic that is used to + * record AWS Firewall Manager SNS logs.

+ */ export class GetNotificationChannelCommand extends $Command< GetNotificationChannelCommandInput, GetNotificationChannelCommandOutput, @@ -34,6 +39,9 @@ export class GetNotificationChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/GetPolicyCommand.ts b/clients/client-fms/commands/GetPolicyCommand.ts index eae6bbfea6ec5..55a5a6f565f7a 100644 --- a/clients/client-fms/commands/GetPolicyCommand.ts +++ b/clients/client-fms/commands/GetPolicyCommand.ts @@ -17,6 +17,9 @@ import { export type GetPolicyCommandInput = GetPolicyRequest; export type GetPolicyCommandOutput = GetPolicyResponse & __MetadataBearer; +/** + *

Returns information about the specified AWS Firewall Manager policy.

+ */ export class GetPolicyCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetPolicyCommand extends $Command, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/GetProtectionStatusCommand.ts b/clients/client-fms/commands/GetProtectionStatusCommand.ts index d6a861d3eae4b..b14916b2b6b6e 100644 --- a/clients/client-fms/commands/GetProtectionStatusCommand.ts +++ b/clients/client-fms/commands/GetProtectionStatusCommand.ts @@ -20,6 +20,10 @@ import { export type GetProtectionStatusCommandInput = GetProtectionStatusRequest; export type GetProtectionStatusCommandOutput = GetProtectionStatusResponse & __MetadataBearer; +/** + *

If you created a Shield Advanced policy, returns policy-level attack summary information + * in the event of a potential DDoS attack. Other policy types are currently unsupported.

+ */ export class GetProtectionStatusCommand extends $Command< GetProtectionStatusCommandInput, GetProtectionStatusCommandOutput, @@ -34,6 +38,9 @@ export class GetProtectionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/GetProtocolsListCommand.ts b/clients/client-fms/commands/GetProtocolsListCommand.ts index 981b3e6cab4d6..cc9b5e4f18aba 100644 --- a/clients/client-fms/commands/GetProtocolsListCommand.ts +++ b/clients/client-fms/commands/GetProtocolsListCommand.ts @@ -20,6 +20,9 @@ import { export type GetProtocolsListCommandInput = GetProtocolsListRequest; export type GetProtocolsListCommandOutput = GetProtocolsListResponse & __MetadataBearer; +/** + *

Returns information about the specified AWS Firewall Manager protocols list.

+ */ export class GetProtocolsListCommand extends $Command< GetProtocolsListCommandInput, GetProtocolsListCommandOutput, @@ -34,6 +37,9 @@ export class GetProtocolsListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/GetViolationDetailsCommand.ts b/clients/client-fms/commands/GetViolationDetailsCommand.ts index 2451b20318add..1afab2345c1dc 100644 --- a/clients/client-fms/commands/GetViolationDetailsCommand.ts +++ b/clients/client-fms/commands/GetViolationDetailsCommand.ts @@ -20,6 +20,9 @@ import { export type GetViolationDetailsCommandInput = GetViolationDetailsRequest; export type GetViolationDetailsCommandOutput = GetViolationDetailsResponse & __MetadataBearer; +/** + *

Retrieves violations for a resource based on the specified AWS Firewall Manager policy and AWS account.

+ */ export class GetViolationDetailsCommand extends $Command< GetViolationDetailsCommandInput, GetViolationDetailsCommandOutput, @@ -34,6 +37,9 @@ export class GetViolationDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/ListAppsListsCommand.ts b/clients/client-fms/commands/ListAppsListsCommand.ts index d69fb06076b70..a59ab4ef0aad9 100644 --- a/clients/client-fms/commands/ListAppsListsCommand.ts +++ b/clients/client-fms/commands/ListAppsListsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAppsListsCommandInput = ListAppsListsRequest; export type ListAppsListsCommandOutput = ListAppsListsResponse & __MetadataBearer; +/** + *

Returns an array of AppsListDataSummary objects.

+ */ export class ListAppsListsCommand extends $Command< ListAppsListsCommandInput, ListAppsListsCommandOutput, @@ -34,6 +37,9 @@ export class ListAppsListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/ListComplianceStatusCommand.ts b/clients/client-fms/commands/ListComplianceStatusCommand.ts index 7397e5a642547..ad44a2099680f 100644 --- a/clients/client-fms/commands/ListComplianceStatusCommand.ts +++ b/clients/client-fms/commands/ListComplianceStatusCommand.ts @@ -20,6 +20,11 @@ import { export type ListComplianceStatusCommandInput = ListComplianceStatusRequest; export type ListComplianceStatusCommandOutput = ListComplianceStatusResponse & __MetadataBearer; +/** + *

Returns an array of PolicyComplianceStatus objects. Use + * PolicyComplianceStatus to get a summary of which member accounts are protected + * by the specified policy.

+ */ export class ListComplianceStatusCommand extends $Command< ListComplianceStatusCommandInput, ListComplianceStatusCommandOutput, @@ -34,6 +39,9 @@ export class ListComplianceStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/ListMemberAccountsCommand.ts b/clients/client-fms/commands/ListMemberAccountsCommand.ts index bfecaa4effd10..689423855b47d 100644 --- a/clients/client-fms/commands/ListMemberAccountsCommand.ts +++ b/clients/client-fms/commands/ListMemberAccountsCommand.ts @@ -20,6 +20,12 @@ import { export type ListMemberAccountsCommandInput = ListMemberAccountsRequest; export type ListMemberAccountsCommandOutput = ListMemberAccountsResponse & __MetadataBearer; +/** + *

Returns a MemberAccounts object that lists the member accounts in the + * administrator's AWS organization.

+ *

The ListMemberAccounts must be submitted by the account that is set as the + * AWS Firewall Manager administrator.

+ */ export class ListMemberAccountsCommand extends $Command< ListMemberAccountsCommandInput, ListMemberAccountsCommandOutput, @@ -34,6 +40,9 @@ export class ListMemberAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/ListPoliciesCommand.ts b/clients/client-fms/commands/ListPoliciesCommand.ts index 45ca7ed653a48..3b2c4be628671 100644 --- a/clients/client-fms/commands/ListPoliciesCommand.ts +++ b/clients/client-fms/commands/ListPoliciesCommand.ts @@ -20,6 +20,9 @@ import { export type ListPoliciesCommandInput = ListPoliciesRequest; export type ListPoliciesCommandOutput = ListPoliciesResponse & __MetadataBearer; +/** + *

Returns an array of PolicySummary objects.

+ */ export class ListPoliciesCommand extends $Command< ListPoliciesCommandInput, ListPoliciesCommandOutput, @@ -34,6 +37,9 @@ export class ListPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/ListProtocolsListsCommand.ts b/clients/client-fms/commands/ListProtocolsListsCommand.ts index ef270e8b469b6..2a865153a9d83 100644 --- a/clients/client-fms/commands/ListProtocolsListsCommand.ts +++ b/clients/client-fms/commands/ListProtocolsListsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProtocolsListsCommandInput = ListProtocolsListsRequest; export type ListProtocolsListsCommandOutput = ListProtocolsListsResponse & __MetadataBearer; +/** + *

Returns an array of ProtocolsListDataSummary objects.

+ */ export class ListProtocolsListsCommand extends $Command< ListProtocolsListsCommandInput, ListProtocolsListsCommandOutput, @@ -34,6 +37,9 @@ export class ListProtocolsListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/ListTagsForResourceCommand.ts b/clients/client-fms/commands/ListTagsForResourceCommand.ts index 9ae4443cc20b0..874ae57e9e577 100644 --- a/clients/client-fms/commands/ListTagsForResourceCommand.ts +++ b/clients/client-fms/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves the list of tags for the specified AWS resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/PutAppsListCommand.ts b/clients/client-fms/commands/PutAppsListCommand.ts index 3f3d9574ccc80..db57d771290a1 100644 --- a/clients/client-fms/commands/PutAppsListCommand.ts +++ b/clients/client-fms/commands/PutAppsListCommand.ts @@ -20,6 +20,9 @@ import { export type PutAppsListCommandInput = PutAppsListRequest; export type PutAppsListCommandOutput = PutAppsListResponse & __MetadataBearer; +/** + *

Creates an AWS Firewall Manager applications list.

+ */ export class PutAppsListCommand extends $Command< PutAppsListCommandInput, PutAppsListCommandOutput, @@ -34,6 +37,9 @@ export class PutAppsListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/PutNotificationChannelCommand.ts b/clients/client-fms/commands/PutNotificationChannelCommand.ts index d625130795346..afb4a9755b4d6 100644 --- a/clients/client-fms/commands/PutNotificationChannelCommand.ts +++ b/clients/client-fms/commands/PutNotificationChannelCommand.ts @@ -20,6 +20,13 @@ import { export type PutNotificationChannelCommandInput = PutNotificationChannelRequest; export type PutNotificationChannelCommandOutput = __MetadataBearer; +/** + *

Designates the IAM role and Amazon Simple Notification Service (SNS) topic that AWS + * Firewall Manager uses to record SNS logs.

+ *

To perform this action outside of the console, you must configure the SNS topic to allow the Firewall Manager + * role AWSServiceRoleForFMS to publish SNS logs. For more information, see + * Firewall Manager required permissions for API actions in the AWS Firewall Manager Developer Guide.

+ */ export class PutNotificationChannelCommand extends $Command< PutNotificationChannelCommandInput, PutNotificationChannelCommandOutput, @@ -34,6 +41,9 @@ export class PutNotificationChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/PutPolicyCommand.ts b/clients/client-fms/commands/PutPolicyCommand.ts index 3d1a10507dfcc..5fd3a01b809b7 100644 --- a/clients/client-fms/commands/PutPolicyCommand.ts +++ b/clients/client-fms/commands/PutPolicyCommand.ts @@ -17,6 +17,37 @@ import { export type PutPolicyCommandInput = PutPolicyRequest; export type PutPolicyCommandOutput = PutPolicyResponse & __MetadataBearer; +/** + *

Creates an AWS Firewall Manager policy.

+ *

Firewall Manager provides the following types of policies:

+ *
    + *
  • + *

    An AWS WAF policy (type WAFV2), which defines rule groups to run first in the + * corresponding AWS WAF web ACL and rule groups to run last in the web ACL.

    + *
  • + *
  • + *

    An AWS WAF Classic policy (type WAF), which defines a rule group.

    + *
  • + *
  • + *

    A Shield Advanced policy, which applies Shield Advanced protection to specified + * accounts and resources.

    + *
  • + *
  • + *

    A security group policy, which manages VPC security groups across your AWS + * organization.

    + *
  • + *
  • + *

    An AWS Network Firewall policy, which provides firewall rules to filter network traffic in specified + * Amazon VPCs.

    + *
  • + *
+ *

Each policy is specific to one of the types. If you want to enforce more than one + * policy type across accounts, create multiple policies. You can create multiple + * policies for each type.

+ *

You must be subscribed to Shield Advanced to create a Shield Advanced policy. For more + * information about subscribing to Shield Advanced, see + * CreateSubscription.

+ */ export class PutPolicyCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +58,9 @@ export class PutPolicyCommand extends $Command, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/PutProtocolsListCommand.ts b/clients/client-fms/commands/PutProtocolsListCommand.ts index 5a535f296a7ce..82aa6e38e1d30 100644 --- a/clients/client-fms/commands/PutProtocolsListCommand.ts +++ b/clients/client-fms/commands/PutProtocolsListCommand.ts @@ -20,6 +20,9 @@ import { export type PutProtocolsListCommandInput = PutProtocolsListRequest; export type PutProtocolsListCommandOutput = PutProtocolsListResponse & __MetadataBearer; +/** + *

Creates an AWS Firewall Manager protocols list.

+ */ export class PutProtocolsListCommand extends $Command< PutProtocolsListCommandInput, PutProtocolsListCommandOutput, @@ -34,6 +37,9 @@ export class PutProtocolsListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/TagResourceCommand.ts b/clients/client-fms/commands/TagResourceCommand.ts index 22bd8c706a118..904c3c1a8f55a 100644 --- a/clients/client-fms/commands/TagResourceCommand.ts +++ b/clients/client-fms/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds one or more tags to an AWS resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/commands/UntagResourceCommand.ts b/clients/client-fms/commands/UntagResourceCommand.ts index 5211ea55ba1bd..ba8b040d64936 100644 --- a/clients/client-fms/commands/UntagResourceCommand.ts +++ b/clients/client-fms/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from an AWS resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FMSClientResolvedConfig, diff --git a/clients/client-fms/package.json b/clients/client-fms/package.json index b80ec6c9ea7f8..684e3a7dac487 100644 --- a/clients/client-fms/package.json +++ b/clients/client-fms/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Fms Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-fms/pagination/ListComplianceStatusPaginator.ts b/clients/client-fms/pagination/ListComplianceStatusPaginator.ts index 4a7221dbfdd49..9023cac33704e 100644 --- a/clients/client-fms/pagination/ListComplianceStatusPaginator.ts +++ b/clients/client-fms/pagination/ListComplianceStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { FMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FMSClient, input: ListComplianceStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListComplianceStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FMS, input: ListComplianceStatusCommandInput, diff --git a/clients/client-fms/pagination/ListMemberAccountsPaginator.ts b/clients/client-fms/pagination/ListMemberAccountsPaginator.ts index 5561b85d36c0f..95b89ef91d1bc 100644 --- a/clients/client-fms/pagination/ListMemberAccountsPaginator.ts +++ b/clients/client-fms/pagination/ListMemberAccountsPaginator.ts @@ -8,6 +8,9 @@ import { import { FMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FMSClient, input: ListMemberAccountsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMemberAccountsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FMS, input: ListMemberAccountsCommandInput, diff --git a/clients/client-fms/pagination/ListPoliciesPaginator.ts b/clients/client-fms/pagination/ListPoliciesPaginator.ts index 704a0eb8407dc..2a7a7fb2fd53e 100644 --- a/clients/client-fms/pagination/ListPoliciesPaginator.ts +++ b/clients/client-fms/pagination/ListPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { FMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FMSClient, input: ListPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FMS, input: ListPoliciesCommandInput, diff --git a/clients/client-fms/runtimeConfig.browser.ts b/clients/client-fms/runtimeConfig.browser.ts index 65b99b95d5b5a..7a3ad455b49e6 100644 --- a/clients/client-fms/runtimeConfig.browser.ts +++ b/clients/client-fms/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./FMSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-fms/runtimeConfig.native.ts b/clients/client-fms/runtimeConfig.native.ts index 1559480f62208..2881bc1eeb16c 100644 --- a/clients/client-fms/runtimeConfig.native.ts +++ b/clients/client-fms/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./FMSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-fms/runtimeConfig.shared.ts b/clients/client-fms/runtimeConfig.shared.ts index 0dd71d11ffe79..2c044a4c501e8 100644 --- a/clients/client-fms/runtimeConfig.shared.ts +++ b/clients/client-fms/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-01-01", disableHostPrefix: false, diff --git a/clients/client-fms/runtimeConfig.ts b/clients/client-fms/runtimeConfig.ts index 2f2355d0a2406..73908a670ecf8 100644 --- a/clients/client-fms/runtimeConfig.ts +++ b/clients/client-fms/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./FMSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-fms/tsconfig.json b/clients/client-fms/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-fms/tsconfig.json +++ b/clients/client-fms/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-forecast/commands/CreateDatasetCommand.ts b/clients/client-forecast/commands/CreateDatasetCommand.ts index cd52e8718a0a8..4383bab78aa3b 100644 --- a/clients/client-forecast/commands/CreateDatasetCommand.ts +++ b/clients/client-forecast/commands/CreateDatasetCommand.ts @@ -20,6 +20,50 @@ import { export type CreateDatasetCommandInput = CreateDatasetRequest; export type CreateDatasetCommandOutput = CreateDatasetResponse & __MetadataBearer; +/** + *

Creates an Amazon Forecast dataset. The information about the dataset that you provide helps + * Forecast understand how to consume the data for model training. This includes the + * following:

+ *
    + *
  • + *

    + * + * DataFrequency + * - How frequently your historical + * time-series data is collected.

    + *
  • + *
  • + *

    + * + * Domain + * and + * + * DatasetType + * - Each dataset has an associated dataset + * domain and a type within the domain. Amazon Forecast provides a list of predefined domains and + * types within each domain. For each unique dataset domain and type within the domain, + * Amazon Forecast requires your data to include a minimum set of predefined fields.

    + *
  • + *
  • + *

    + * + * Schema + * - A schema specifies the fields in the dataset, + * including the field name and data type.

    + *
  • + *
+ *

After creating a dataset, you import your training data into it and add the dataset to a + * dataset group. You use the dataset group to create a predictor. For more information, see + * howitworks-datasets-groups.

+ *

To get a list of all your datasets, use the ListDatasets + * operation.

+ *

For example Forecast datasets, see the Amazon Forecast Sample GitHub + * repository.

+ * + *

The Status of a dataset must be ACTIVE before you can import + * training data. Use the DescribeDataset operation to get the status.

+ *
+ */ export class CreateDatasetCommand extends $Command< CreateDatasetCommandInput, CreateDatasetCommandOutput, @@ -34,6 +78,9 @@ export class CreateDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/CreateDatasetGroupCommand.ts b/clients/client-forecast/commands/CreateDatasetGroupCommand.ts index 9e7cc643e3e29..de3f0fa2ab5fb 100644 --- a/clients/client-forecast/commands/CreateDatasetGroupCommand.ts +++ b/clients/client-forecast/commands/CreateDatasetGroupCommand.ts @@ -20,6 +20,18 @@ import { export type CreateDatasetGroupCommandInput = CreateDatasetGroupRequest; export type CreateDatasetGroupCommandOutput = CreateDatasetGroupResponse & __MetadataBearer; +/** + *

Creates a dataset group, which holds a collection of related datasets. You can add + * datasets to the dataset group when you create the dataset group, or later by using the UpdateDatasetGroup operation.

+ *

After creating a dataset group and adding datasets, you use the dataset group when you + * create a predictor. For more information, see howitworks-datasets-groups.

+ *

To get a list of all your datasets groups, use the ListDatasetGroups + * operation.

+ * + *

The Status of a dataset group must be ACTIVE before you can + * use the dataset group to create a predictor. To get the status, use the DescribeDatasetGroup operation.

+ *
+ */ export class CreateDatasetGroupCommand extends $Command< CreateDatasetGroupCommandInput, CreateDatasetGroupCommandOutput, @@ -34,6 +46,9 @@ export class CreateDatasetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/CreateDatasetImportJobCommand.ts b/clients/client-forecast/commands/CreateDatasetImportJobCommand.ts index c7b9f7e932359..ce0cae34bbd0f 100644 --- a/clients/client-forecast/commands/CreateDatasetImportJobCommand.ts +++ b/clients/client-forecast/commands/CreateDatasetImportJobCommand.ts @@ -20,6 +20,28 @@ import { export type CreateDatasetImportJobCommandInput = CreateDatasetImportJobRequest; export type CreateDatasetImportJobCommandOutput = CreateDatasetImportJobResponse & __MetadataBearer; +/** + *

Imports your training data to an Amazon Forecast dataset. You provide the location of your + * training data in an Amazon Simple Storage Service (Amazon S3) bucket and the Amazon Resource Name (ARN) of the dataset + * that you want to import the data to.

+ *

You must specify a DataSource object that includes an AWS Identity and Access Management (IAM) + * role that Amazon Forecast can assume to access the data, as Amazon Forecast makes a copy of your data and + * processes it in an internal AWS system. For more information, see aws-forecast-iam-roles.

+ *

The training data must be in CSV format. The delimiter must be a comma (,).

+ *

You can specify the path to a specific CSV file, the S3 bucket, or to a folder in the S3 + * bucket. For the latter two cases, Amazon Forecast imports all files up to the limit of 10,000 + * files.

+ * + * + *

Because dataset imports are not aggregated, your most recent dataset import is the one + * that is used when training a predictor or generating a forecast. Make sure that your most + * recent dataset import contains all of the data you want to model off of, and not just the new + * data collected since the previous import.

+ * + * + *

To get a list of all your dataset import jobs, filtered by specified criteria, use the + * ListDatasetImportJobs operation.

+ */ export class CreateDatasetImportJobCommand extends $Command< CreateDatasetImportJobCommandInput, CreateDatasetImportJobCommandOutput, @@ -34,6 +56,9 @@ export class CreateDatasetImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/CreateForecastCommand.ts b/clients/client-forecast/commands/CreateForecastCommand.ts index a729d922070fe..6ebc8d03844c6 100644 --- a/clients/client-forecast/commands/CreateForecastCommand.ts +++ b/clients/client-forecast/commands/CreateForecastCommand.ts @@ -20,6 +20,27 @@ import { export type CreateForecastCommandInput = CreateForecastRequest; export type CreateForecastCommandOutput = CreateForecastResponse & __MetadataBearer; +/** + *

Creates a forecast for each item in the TARGET_TIME_SERIES dataset that was + * used to train the predictor. This is known as inference. To retrieve the forecast for a single + * item at low latency, use the operation. To + * export the complete forecast into your Amazon Simple Storage Service (Amazon S3) bucket, use the CreateForecastExportJob operation.

+ *

The range of the forecast is determined by the ForecastHorizon value, which + * you specify in the CreatePredictor request. When you query a forecast, you + * can request a specific date range within the forecast.

+ *

To get a list of all your forecasts, use the ListForecasts + * operation.

+ * + *

The forecasts generated by Amazon Forecast are in the same time zone as the dataset that was + * used to create the predictor.

+ *
+ *

For more information, see howitworks-forecast.

+ * + *

The Status of the forecast must be ACTIVE before you can query + * or export the forecast. Use the DescribeForecast operation to get the + * status.

+ *
+ */ export class CreateForecastCommand extends $Command< CreateForecastCommandInput, CreateForecastCommandOutput, @@ -34,6 +55,9 @@ export class CreateForecastCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/CreateForecastExportJobCommand.ts b/clients/client-forecast/commands/CreateForecastExportJobCommand.ts index 087b9416126f4..081c269cb6454 100644 --- a/clients/client-forecast/commands/CreateForecastExportJobCommand.ts +++ b/clients/client-forecast/commands/CreateForecastExportJobCommand.ts @@ -20,6 +20,22 @@ import { export type CreateForecastExportJobCommandInput = CreateForecastExportJobRequest; export type CreateForecastExportJobCommandOutput = CreateForecastExportJobResponse & __MetadataBearer; +/** + *

Exports a forecast created by the CreateForecast operation to your + * Amazon Simple Storage Service (Amazon S3) bucket. The forecast file name will match the following conventions:

+ *

__

+ *

where the component is in Java SimpleDateFormat + * (yyyy-MM-ddTHH-mm-ssZ).

+ *

You must specify a DataDestination object that includes an AWS Identity and Access Management + * (IAM) role that Amazon Forecast can assume to access the Amazon S3 bucket. For more information, see + * aws-forecast-iam-roles.

+ *

For more information, see howitworks-forecast.

+ *

To get a list of all your forecast export jobs, use the ListForecastExportJobs operation.

+ * + *

The Status of the forecast export job must be ACTIVE before + * you can access the forecast in your Amazon S3 bucket. To get the status, use the DescribeForecastExportJob operation.

+ *
+ */ export class CreateForecastExportJobCommand extends $Command< CreateForecastExportJobCommandInput, CreateForecastExportJobCommandOutput, @@ -34,6 +50,9 @@ export class CreateForecastExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/CreatePredictorCommand.ts b/clients/client-forecast/commands/CreatePredictorCommand.ts index 10793ea9620a2..a8f782a8fb828 100644 --- a/clients/client-forecast/commands/CreatePredictorCommand.ts +++ b/clients/client-forecast/commands/CreatePredictorCommand.ts @@ -20,6 +20,70 @@ import { export type CreatePredictorCommandInput = CreatePredictorRequest; export type CreatePredictorCommandOutput = CreatePredictorResponse & __MetadataBearer; +/** + *

Creates an Amazon Forecast predictor.

+ *

In the request, provide a dataset group and either specify an algorithm or let + * Amazon Forecast choose an algorithm for you using AutoML. If you specify an algorithm, you also can + * override algorithm-specific hyperparameters.

+ *

Amazon Forecast uses the algorithm to train a predictor using the latest version of the + * datasets in the specified dataset group. You can then generate a + * forecast using the CreateForecast operation.

+ *

+ * To see the evaluation metrics, use the GetAccuracyMetrics operation. + *

+ *

You can specify a featurization configuration to fill and aggregate the data + * fields in the TARGET_TIME_SERIES dataset to improve model training. For more + * information, see FeaturizationConfig.

+ *

For RELATED_TIME_SERIES datasets, CreatePredictor verifies that the + * DataFrequency specified when the dataset was created matches the + * ForecastFrequency. TARGET_TIME_SERIES datasets don't have this restriction. + * Amazon Forecast also verifies the delimiter and timestamp format. For more information, see howitworks-datasets-groups.

+ *

By default, predictors are trained and evaluated at the 0.1 (P10), 0.5 (P50), and 0.9 + * (P90) quantiles. You can choose custom forecast types to train and evaluate your predictor + * by setting the ForecastTypes. + *

+ *

+ * AutoML + *

+ *

If you want Amazon Forecast to evaluate each algorithm and choose the one that minimizes the + * objective function, set PerformAutoML to true. The + * objective function is defined as the mean of the weighted losses over the + * forecast types. By default, these are the p10, p50, and p90 + * quantile losses. For more information, see EvaluationResult.

+ *

When AutoML is enabled, the following properties are disallowed:

+ *
    + *
  • + *

    + * AlgorithmArn + *

    + *
  • + *
  • + *

    + * HPOConfig + *

    + *
  • + *
  • + *

    + * PerformHPO + *

    + *
  • + *
  • + *

    + * TrainingParameters + *

    + *
  • + *
+ * + * + * + *

To get a list of all of your predictors, use the ListPredictors + * operation.

+ * + *

Before you can use the predictor to create a forecast, the Status of the + * predictor must be ACTIVE, signifying that training has completed. To get the + * status, use the DescribePredictor operation.

+ *
+ */ export class CreatePredictorCommand extends $Command< CreatePredictorCommandInput, CreatePredictorCommandOutput, @@ -34,6 +98,9 @@ export class CreatePredictorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DeleteDatasetCommand.ts b/clients/client-forecast/commands/DeleteDatasetCommand.ts index d667f6e880db9..fc612d297323d 100644 --- a/clients/client-forecast/commands/DeleteDatasetCommand.ts +++ b/clients/client-forecast/commands/DeleteDatasetCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteDatasetCommandInput = DeleteDatasetRequest; export type DeleteDatasetCommandOutput = __MetadataBearer; +/** + *

Deletes an Amazon Forecast dataset that was created using the CreateDataset + * operation. You can only delete datasets that have a status of ACTIVE or + * CREATE_FAILED. To get the status use the DescribeDataset + * operation.

+ * + *

Forecast does not automatically update any dataset groups that contain the deleted dataset. + * In order to update the dataset group, use the + * operation, omitting the deleted dataset's ARN.

+ *
+ */ export class DeleteDatasetCommand extends $Command< DeleteDatasetCommandInput, DeleteDatasetCommandOutput, @@ -34,6 +45,9 @@ export class DeleteDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DeleteDatasetGroupCommand.ts b/clients/client-forecast/commands/DeleteDatasetGroupCommand.ts index c3d07b6418733..900cb54faffba 100644 --- a/clients/client-forecast/commands/DeleteDatasetGroupCommand.ts +++ b/clients/client-forecast/commands/DeleteDatasetGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDatasetGroupCommandInput = DeleteDatasetGroupRequest; export type DeleteDatasetGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a dataset group created using the CreateDatasetGroup operation. + * You can only delete dataset groups that have a status of ACTIVE, + * CREATE_FAILED, or UPDATE_FAILED. To get the status, use the DescribeDatasetGroup operation.

+ *

This operation deletes only the dataset group, not the datasets in the group.

+ */ export class DeleteDatasetGroupCommand extends $Command< DeleteDatasetGroupCommandInput, DeleteDatasetGroupCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDatasetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DeleteDatasetImportJobCommand.ts b/clients/client-forecast/commands/DeleteDatasetImportJobCommand.ts index 657d6a3c946a6..54f4b13c6c0a9 100644 --- a/clients/client-forecast/commands/DeleteDatasetImportJobCommand.ts +++ b/clients/client-forecast/commands/DeleteDatasetImportJobCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDatasetImportJobCommandInput = DeleteDatasetImportJobRequest; export type DeleteDatasetImportJobCommandOutput = __MetadataBearer; +/** + *

Deletes a dataset import job created using the CreateDatasetImportJob + * operation. You can delete only dataset import jobs that have a status of ACTIVE + * or CREATE_FAILED. To get the status, use the DescribeDatasetImportJob operation.

+ */ export class DeleteDatasetImportJobCommand extends $Command< DeleteDatasetImportJobCommandInput, DeleteDatasetImportJobCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDatasetImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DeleteForecastCommand.ts b/clients/client-forecast/commands/DeleteForecastCommand.ts index 183f3f39b60ca..763284e4c7647 100644 --- a/clients/client-forecast/commands/DeleteForecastCommand.ts +++ b/clients/client-forecast/commands/DeleteForecastCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteForecastCommandInput = DeleteForecastRequest; export type DeleteForecastCommandOutput = __MetadataBearer; +/** + *

Deletes a forecast created using the CreateForecast operation. You can + * delete only forecasts that have a status of ACTIVE or CREATE_FAILED. + * To get the status, use the DescribeForecast operation.

+ *

You can't delete a forecast while it is being exported. After a forecast is deleted, you + * can no longer query the forecast.

+ */ export class DeleteForecastCommand extends $Command< DeleteForecastCommandInput, DeleteForecastCommandOutput, @@ -34,6 +41,9 @@ export class DeleteForecastCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DeleteForecastExportJobCommand.ts b/clients/client-forecast/commands/DeleteForecastExportJobCommand.ts index aa3200251e245..0765dd281aef8 100644 --- a/clients/client-forecast/commands/DeleteForecastExportJobCommand.ts +++ b/clients/client-forecast/commands/DeleteForecastExportJobCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteForecastExportJobCommandInput = DeleteForecastExportJobRequest; export type DeleteForecastExportJobCommandOutput = __MetadataBearer; +/** + *

Deletes a forecast export job created using the CreateForecastExportJob + * operation. You can delete only export jobs that have a status of ACTIVE or + * CREATE_FAILED. To get the status, use the DescribeForecastExportJob operation.

+ */ export class DeleteForecastExportJobCommand extends $Command< DeleteForecastExportJobCommandInput, DeleteForecastExportJobCommandOutput, @@ -34,6 +39,9 @@ export class DeleteForecastExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DeletePredictorCommand.ts b/clients/client-forecast/commands/DeletePredictorCommand.ts index aaca1696a908a..31d1f858ebb2d 100644 --- a/clients/client-forecast/commands/DeletePredictorCommand.ts +++ b/clients/client-forecast/commands/DeletePredictorCommand.ts @@ -20,6 +20,11 @@ import { export type DeletePredictorCommandInput = DeletePredictorRequest; export type DeletePredictorCommandOutput = __MetadataBearer; +/** + *

Deletes a predictor created using the CreatePredictor operation. You can + * delete only predictor that have a status of ACTIVE or CREATE_FAILED. + * To get the status, use the DescribePredictor operation.

+ */ export class DeletePredictorCommand extends $Command< DeletePredictorCommandInput, DeletePredictorCommandOutput, @@ -34,6 +39,9 @@ export class DeletePredictorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DescribeDatasetCommand.ts b/clients/client-forecast/commands/DescribeDatasetCommand.ts index b8b1a24a53943..de9f10786ab25 100644 --- a/clients/client-forecast/commands/DescribeDatasetCommand.ts +++ b/clients/client-forecast/commands/DescribeDatasetCommand.ts @@ -20,6 +20,29 @@ import { export type DescribeDatasetCommandInput = DescribeDatasetRequest; export type DescribeDatasetCommandOutput = DescribeDatasetResponse & __MetadataBearer; +/** + *

Describes an Amazon Forecast dataset created using the CreateDataset + * operation.

+ *

In addition to listing the parameters specified in the CreateDataset request, + * this operation includes the following dataset properties:

+ *
    + *
  • + *

    + * CreationTime + *

    + *
  • + *
  • + *

    + * LastModificationTime + *

    + *
  • + *
  • + *

    + * Status + *

    + *
  • + *
+ */ export class DescribeDatasetCommand extends $Command< DescribeDatasetCommandInput, DescribeDatasetCommandOutput, @@ -34,6 +57,9 @@ export class DescribeDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DescribeDatasetGroupCommand.ts b/clients/client-forecast/commands/DescribeDatasetGroupCommand.ts index 371986a134071..2ae1f71ec78ac 100644 --- a/clients/client-forecast/commands/DescribeDatasetGroupCommand.ts +++ b/clients/client-forecast/commands/DescribeDatasetGroupCommand.ts @@ -20,6 +20,33 @@ import { export type DescribeDatasetGroupCommandInput = DescribeDatasetGroupRequest; export type DescribeDatasetGroupCommandOutput = DescribeDatasetGroupResponse & __MetadataBearer; +/** + *

Describes a dataset group created using the CreateDatasetGroup + * operation.

+ *

In addition to listing the parameters provided in the CreateDatasetGroup + * request, this operation includes the following properties:

+ *
    + *
  • + *

    + * DatasetArns - The datasets belonging to the group.

    + *
  • + *
  • + *

    + * CreationTime + *

    + *
  • + *
  • + *

    + * LastModificationTime + *

    + *
  • + *
  • + *

    + * Status + *

    + *
  • + *
+ */ export class DescribeDatasetGroupCommand extends $Command< DescribeDatasetGroupCommandInput, DescribeDatasetGroupCommandOutput, @@ -34,6 +61,9 @@ export class DescribeDatasetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DescribeDatasetImportJobCommand.ts b/clients/client-forecast/commands/DescribeDatasetImportJobCommand.ts index db18282d941d6..ef9937313eaee 100644 --- a/clients/client-forecast/commands/DescribeDatasetImportJobCommand.ts +++ b/clients/client-forecast/commands/DescribeDatasetImportJobCommand.ts @@ -20,6 +20,43 @@ import { export type DescribeDatasetImportJobCommandInput = DescribeDatasetImportJobRequest; export type DescribeDatasetImportJobCommandOutput = DescribeDatasetImportJobResponse & __MetadataBearer; +/** + *

Describes a dataset import job created using the CreateDatasetImportJob + * operation.

+ *

In addition to listing the parameters provided in the CreateDatasetImportJob + * request, this operation includes the following properties:

+ *
    + *
  • + *

    + * CreationTime + *

    + *
  • + *
  • + *

    + * LastModificationTime + *

    + *
  • + *
  • + *

    + * DataSize + *

    + *
  • + *
  • + *

    + * FieldStatistics + *

    + *
  • + *
  • + *

    + * Status + *

    + *
  • + *
  • + *

    + * Message - If an error occurred, information about the error.

    + *
  • + *
+ */ export class DescribeDatasetImportJobCommand extends $Command< DescribeDatasetImportJobCommandInput, DescribeDatasetImportJobCommandOutput, @@ -34,6 +71,9 @@ export class DescribeDatasetImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DescribeForecastCommand.ts b/clients/client-forecast/commands/DescribeForecastCommand.ts index fae4c18467dfb..4ba819248c046 100644 --- a/clients/client-forecast/commands/DescribeForecastCommand.ts +++ b/clients/client-forecast/commands/DescribeForecastCommand.ts @@ -20,6 +20,37 @@ import { export type DescribeForecastCommandInput = DescribeForecastRequest; export type DescribeForecastCommandOutput = DescribeForecastResponse & __MetadataBearer; +/** + *

Describes a forecast created using the CreateForecast operation.

+ *

In addition to listing the properties provided in the CreateForecast request, + * this operation lists the following properties:

+ *
    + *
  • + *

    + * DatasetGroupArn - The dataset group that provided the training + * data.

    + *
  • + *
  • + *

    + * CreationTime + *

    + *
  • + *
  • + *

    + * LastModificationTime + *

    + *
  • + *
  • + *

    + * Status + *

    + *
  • + *
  • + *

    + * Message - If an error occurred, information about the error.

    + *
  • + *
+ */ export class DescribeForecastCommand extends $Command< DescribeForecastCommandInput, DescribeForecastCommandOutput, @@ -34,6 +65,9 @@ export class DescribeForecastCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DescribeForecastExportJobCommand.ts b/clients/client-forecast/commands/DescribeForecastExportJobCommand.ts index 1ac4562f4f03c..362f2afcaf44d 100644 --- a/clients/client-forecast/commands/DescribeForecastExportJobCommand.ts +++ b/clients/client-forecast/commands/DescribeForecastExportJobCommand.ts @@ -20,6 +20,33 @@ import { export type DescribeForecastExportJobCommandInput = DescribeForecastExportJobRequest; export type DescribeForecastExportJobCommandOutput = DescribeForecastExportJobResponse & __MetadataBearer; +/** + *

Describes a forecast export job created using the CreateForecastExportJob operation.

+ *

In addition to listing the properties provided by the user in the + * CreateForecastExportJob request, this operation lists the following + * properties:

+ *
    + *
  • + *

    + * CreationTime + *

    + *
  • + *
  • + *

    + * LastModificationTime + *

    + *
  • + *
  • + *

    + * Status + *

    + *
  • + *
  • + *

    + * Message - If an error occurred, information about the error.

    + *
  • + *
+ */ export class DescribeForecastExportJobCommand extends $Command< DescribeForecastExportJobCommandInput, DescribeForecastExportJobCommandOutput, @@ -34,6 +61,9 @@ export class DescribeForecastExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/DescribePredictorCommand.ts b/clients/client-forecast/commands/DescribePredictorCommand.ts index 4f47b5272c266..ae603334a7187 100644 --- a/clients/client-forecast/commands/DescribePredictorCommand.ts +++ b/clients/client-forecast/commands/DescribePredictorCommand.ts @@ -20,6 +20,43 @@ import { export type DescribePredictorCommandInput = DescribePredictorRequest; export type DescribePredictorCommandOutput = DescribePredictorResponse & __MetadataBearer; +/** + *

Describes a predictor created using the CreatePredictor + * operation.

+ *

In addition to listing the properties provided in the CreatePredictor + * request, this operation lists the following properties:

+ *
    + *
  • + *

    + * DatasetImportJobArns - The dataset import jobs used to import training + * data.

    + *
  • + *
  • + *

    + * AutoMLAlgorithmArns - If AutoML is performed, the algorithms that were + * evaluated.

    + *
  • + *
  • + *

    + * CreationTime + *

    + *
  • + *
  • + *

    + * LastModificationTime + *

    + *
  • + *
  • + *

    + * Status + *

    + *
  • + *
  • + *

    + * Message - If an error occurred, information about the error.

    + *
  • + *
+ */ export class DescribePredictorCommand extends $Command< DescribePredictorCommandInput, DescribePredictorCommandOutput, @@ -34,6 +71,9 @@ export class DescribePredictorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/GetAccuracyMetricsCommand.ts b/clients/client-forecast/commands/GetAccuracyMetricsCommand.ts index eda23c193366f..5d3eb8db37e88 100644 --- a/clients/client-forecast/commands/GetAccuracyMetricsCommand.ts +++ b/clients/client-forecast/commands/GetAccuracyMetricsCommand.ts @@ -20,6 +20,28 @@ import { export type GetAccuracyMetricsCommandInput = GetAccuracyMetricsRequest; export type GetAccuracyMetricsCommandOutput = GetAccuracyMetricsResponse & __MetadataBearer; +/** + *

Provides metrics on the accuracy of the models that were trained by the CreatePredictor operation. Use metrics to see how well the model performed and + * to decide whether to use the predictor to generate a forecast. For more information, see + * Predictor + * Metrics.

+ *

This operation generates metrics for each backtest window that was evaluated. The number of backtest windows + * (NumberOfBacktestWindows) is specified using the + * EvaluationParameters object, which is optionally + * included in the CreatePredictor request. If + * NumberOfBacktestWindows isn't specified, the number defaults to one.

+ *

The parameters of the filling method determine which items contribute to + * the metrics. If you want all items to contribute, specify zero. + * If you want only those items that have complete data in the range being evaluated to + * contribute, specify nan. + * For more information, see FeaturizationMethod.

+ * + * + *

Before you can get accuracy metrics, the Status of the predictor must be + * ACTIVE, signifying that training has completed. + * To get the status, use the DescribePredictor operation.

+ *
+ */ export class GetAccuracyMetricsCommand extends $Command< GetAccuracyMetricsCommandInput, GetAccuracyMetricsCommandOutput, @@ -34,6 +56,9 @@ export class GetAccuracyMetricsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/ListDatasetGroupsCommand.ts b/clients/client-forecast/commands/ListDatasetGroupsCommand.ts index cff515bcc365c..445fb2b32aaec 100644 --- a/clients/client-forecast/commands/ListDatasetGroupsCommand.ts +++ b/clients/client-forecast/commands/ListDatasetGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type ListDatasetGroupsCommandInput = ListDatasetGroupsRequest; export type ListDatasetGroupsCommandOutput = ListDatasetGroupsResponse & __MetadataBearer; +/** + *

Returns a list of dataset groups created using the CreateDatasetGroup + * operation. For each dataset group, this operation returns a summary of its properties, + * including its Amazon Resource Name (ARN). You can retrieve the complete set of properties by + * using the dataset group ARN with the DescribeDatasetGroup operation.

+ */ export class ListDatasetGroupsCommand extends $Command< ListDatasetGroupsCommandInput, ListDatasetGroupsCommandOutput, @@ -34,6 +40,9 @@ export class ListDatasetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/ListDatasetImportJobsCommand.ts b/clients/client-forecast/commands/ListDatasetImportJobsCommand.ts index 3eaf8937421c4..97bfb4b754ae1 100644 --- a/clients/client-forecast/commands/ListDatasetImportJobsCommand.ts +++ b/clients/client-forecast/commands/ListDatasetImportJobsCommand.ts @@ -20,6 +20,12 @@ import { export type ListDatasetImportJobsCommandInput = ListDatasetImportJobsRequest; export type ListDatasetImportJobsCommandOutput = ListDatasetImportJobsResponse & __MetadataBearer; +/** + *

Returns a list of dataset import jobs created using the CreateDatasetImportJob operation. For each import job, this operation returns a + * summary of its properties, including its Amazon Resource Name (ARN). You can retrieve the + * complete set of properties by using the ARN with the DescribeDatasetImportJob operation. You can filter the list by providing an array of Filter + * objects.

+ */ export class ListDatasetImportJobsCommand extends $Command< ListDatasetImportJobsCommandInput, ListDatasetImportJobsCommandOutput, @@ -34,6 +40,9 @@ export class ListDatasetImportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/ListDatasetsCommand.ts b/clients/client-forecast/commands/ListDatasetsCommand.ts index 596f9ddef67d7..a1248412dcbf1 100644 --- a/clients/client-forecast/commands/ListDatasetsCommand.ts +++ b/clients/client-forecast/commands/ListDatasetsCommand.ts @@ -20,6 +20,11 @@ import { export type ListDatasetsCommandInput = ListDatasetsRequest; export type ListDatasetsCommandOutput = ListDatasetsResponse & __MetadataBearer; +/** + *

Returns a list of datasets created using the CreateDataset operation. + * For each dataset, a summary of its properties, including its Amazon Resource Name (ARN), is + * returned. To retrieve the complete set of properties, use the ARN with the DescribeDataset operation.

+ */ export class ListDatasetsCommand extends $Command< ListDatasetsCommandInput, ListDatasetsCommandOutput, @@ -34,6 +39,9 @@ export class ListDatasetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/ListForecastExportJobsCommand.ts b/clients/client-forecast/commands/ListForecastExportJobsCommand.ts index f7b34b84c1690..3818e8782092b 100644 --- a/clients/client-forecast/commands/ListForecastExportJobsCommand.ts +++ b/clients/client-forecast/commands/ListForecastExportJobsCommand.ts @@ -20,6 +20,12 @@ import { export type ListForecastExportJobsCommandInput = ListForecastExportJobsRequest; export type ListForecastExportJobsCommandOutput = ListForecastExportJobsResponse & __MetadataBearer; +/** + *

Returns a list of forecast export jobs created using the CreateForecastExportJob operation. For each forecast export job, this operation + * returns a summary of its properties, including its Amazon Resource Name (ARN). To retrieve the + * complete set of properties, use the ARN with the DescribeForecastExportJob + * operation. You can filter the list using an array of Filter objects.

+ */ export class ListForecastExportJobsCommand extends $Command< ListForecastExportJobsCommandInput, ListForecastExportJobsCommandOutput, @@ -34,6 +40,9 @@ export class ListForecastExportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/ListForecastsCommand.ts b/clients/client-forecast/commands/ListForecastsCommand.ts index 0b85a839ac5b4..197e3fe9990b4 100644 --- a/clients/client-forecast/commands/ListForecastsCommand.ts +++ b/clients/client-forecast/commands/ListForecastsCommand.ts @@ -20,6 +20,13 @@ import { export type ListForecastsCommandInput = ListForecastsRequest; export type ListForecastsCommandOutput = ListForecastsResponse & __MetadataBearer; +/** + *

Returns a list of forecasts created using the CreateForecast operation. + * For each forecast, this operation returns a summary of its properties, including its Amazon + * Resource Name (ARN). To retrieve the complete set of properties, specify the ARN with the + * DescribeForecast operation. You can filter the list using an array of + * Filter objects.

+ */ export class ListForecastsCommand extends $Command< ListForecastsCommandInput, ListForecastsCommandOutput, @@ -34,6 +41,9 @@ export class ListForecastsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/ListPredictorsCommand.ts b/clients/client-forecast/commands/ListPredictorsCommand.ts index a3da56c4d0baf..7968987c8ebda 100644 --- a/clients/client-forecast/commands/ListPredictorsCommand.ts +++ b/clients/client-forecast/commands/ListPredictorsCommand.ts @@ -20,6 +20,13 @@ import { export type ListPredictorsCommandInput = ListPredictorsRequest; export type ListPredictorsCommandOutput = ListPredictorsResponse & __MetadataBearer; +/** + *

Returns a list of predictors created using the CreatePredictor + * operation. For each predictor, this operation returns a summary of its properties, including + * its Amazon Resource Name (ARN). You can retrieve the complete set of properties by using the + * ARN with the DescribePredictor operation. You can filter the list using an + * array of Filter objects.

+ */ export class ListPredictorsCommand extends $Command< ListPredictorsCommandInput, ListPredictorsCommandOutput, @@ -34,6 +41,9 @@ export class ListPredictorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/ListTagsForResourceCommand.ts b/clients/client-forecast/commands/ListTagsForResourceCommand.ts index 357d8ba3d8102..584e314596408 100644 --- a/clients/client-forecast/commands/ListTagsForResourceCommand.ts +++ b/clients/client-forecast/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags for an Amazon Forecast resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/TagResourceCommand.ts b/clients/client-forecast/commands/TagResourceCommand.ts index 59a347d604739..debd126b0cf59 100644 --- a/clients/client-forecast/commands/TagResourceCommand.ts +++ b/clients/client-forecast/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags associated with that resource are also deleted.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/UntagResourceCommand.ts b/clients/client-forecast/commands/UntagResourceCommand.ts index 22b4785a3854b..5e5d827f59cd3 100644 --- a/clients/client-forecast/commands/UntagResourceCommand.ts +++ b/clients/client-forecast/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Deletes the specified tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/commands/UpdateDatasetGroupCommand.ts b/clients/client-forecast/commands/UpdateDatasetGroupCommand.ts index 1229a8a73c002..242b4d28628e6 100644 --- a/clients/client-forecast/commands/UpdateDatasetGroupCommand.ts +++ b/clients/client-forecast/commands/UpdateDatasetGroupCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateDatasetGroupCommandInput = UpdateDatasetGroupRequest; export type UpdateDatasetGroupCommandOutput = UpdateDatasetGroupResponse & __MetadataBearer; +/** + *

Replaces the datasets in a dataset group with the specified datasets.

+ * + *

The Status of the dataset group must be ACTIVE before you can + * use the dataset group to create a predictor. Use the DescribeDatasetGroup + * operation to get the status.

+ *
+ */ export class UpdateDatasetGroupCommand extends $Command< UpdateDatasetGroupCommandInput, UpdateDatasetGroupCommandOutput, @@ -34,6 +42,9 @@ export class UpdateDatasetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastClientResolvedConfig, diff --git a/clients/client-forecast/package.json b/clients/client-forecast/package.json index 725e397ebe27a..4cd9403b084e1 100644 --- a/clients/client-forecast/package.json +++ b/clients/client-forecast/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Forecast Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-forecast/pagination/ListDatasetGroupsPaginator.ts b/clients/client-forecast/pagination/ListDatasetGroupsPaginator.ts index fe10478cae2ab..07ca6e2dc282f 100644 --- a/clients/client-forecast/pagination/ListDatasetGroupsPaginator.ts +++ b/clients/client-forecast/pagination/ListDatasetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ForecastPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ForecastClient, input: ListDatasetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Forecast, input: ListDatasetGroupsCommandInput, diff --git a/clients/client-forecast/pagination/ListDatasetImportJobsPaginator.ts b/clients/client-forecast/pagination/ListDatasetImportJobsPaginator.ts index 4dd6eef9a378b..61e6813f89933 100644 --- a/clients/client-forecast/pagination/ListDatasetImportJobsPaginator.ts +++ b/clients/client-forecast/pagination/ListDatasetImportJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { ForecastPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ForecastClient, input: ListDatasetImportJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetImportJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Forecast, input: ListDatasetImportJobsCommandInput, diff --git a/clients/client-forecast/pagination/ListDatasetsPaginator.ts b/clients/client-forecast/pagination/ListDatasetsPaginator.ts index d52e65e94a2de..7f2041a8ac662 100644 --- a/clients/client-forecast/pagination/ListDatasetsPaginator.ts +++ b/clients/client-forecast/pagination/ListDatasetsPaginator.ts @@ -8,6 +8,9 @@ import { import { ForecastPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ForecastClient, input: ListDatasetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Forecast, input: ListDatasetsCommandInput, diff --git a/clients/client-forecast/pagination/ListForecastExportJobsPaginator.ts b/clients/client-forecast/pagination/ListForecastExportJobsPaginator.ts index 866f9e15e5ea7..1d71a062fbc57 100644 --- a/clients/client-forecast/pagination/ListForecastExportJobsPaginator.ts +++ b/clients/client-forecast/pagination/ListForecastExportJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { ForecastPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ForecastClient, input: ListForecastExportJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListForecastExportJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Forecast, input: ListForecastExportJobsCommandInput, diff --git a/clients/client-forecast/pagination/ListForecastsPaginator.ts b/clients/client-forecast/pagination/ListForecastsPaginator.ts index b8f4521d25e4e..ef36b724a1f5e 100644 --- a/clients/client-forecast/pagination/ListForecastsPaginator.ts +++ b/clients/client-forecast/pagination/ListForecastsPaginator.ts @@ -8,6 +8,9 @@ import { import { ForecastPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ForecastClient, input: ListForecastsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListForecastsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Forecast, input: ListForecastsCommandInput, diff --git a/clients/client-forecast/pagination/ListPredictorsPaginator.ts b/clients/client-forecast/pagination/ListPredictorsPaginator.ts index cf23da37be0b2..4c2a3182cf70b 100644 --- a/clients/client-forecast/pagination/ListPredictorsPaginator.ts +++ b/clients/client-forecast/pagination/ListPredictorsPaginator.ts @@ -8,6 +8,9 @@ import { import { ForecastPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ForecastClient, input: ListPredictorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPredictorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Forecast, input: ListPredictorsCommandInput, diff --git a/clients/client-forecast/runtimeConfig.browser.ts b/clients/client-forecast/runtimeConfig.browser.ts index c693909b89f82..226c128db4bfc 100644 --- a/clients/client-forecast/runtimeConfig.browser.ts +++ b/clients/client-forecast/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ForecastClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-forecast/runtimeConfig.native.ts b/clients/client-forecast/runtimeConfig.native.ts index 007e15dbe8d93..152d020ae81c3 100644 --- a/clients/client-forecast/runtimeConfig.native.ts +++ b/clients/client-forecast/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ForecastClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-forecast/runtimeConfig.shared.ts b/clients/client-forecast/runtimeConfig.shared.ts index a7f2df37d629f..b8df8e0765e72 100644 --- a/clients/client-forecast/runtimeConfig.shared.ts +++ b/clients/client-forecast/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-06-26", disableHostPrefix: false, diff --git a/clients/client-forecast/runtimeConfig.ts b/clients/client-forecast/runtimeConfig.ts index 0cada314c6827..21856457fadc0 100644 --- a/clients/client-forecast/runtimeConfig.ts +++ b/clients/client-forecast/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ForecastClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-forecast/tsconfig.json b/clients/client-forecast/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-forecast/tsconfig.json +++ b/clients/client-forecast/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-forecastquery/commands/QueryForecastCommand.ts b/clients/client-forecastquery/commands/QueryForecastCommand.ts index 63d44c6a17b68..67954334dfe8b 100644 --- a/clients/client-forecastquery/commands/QueryForecastCommand.ts +++ b/clients/client-forecastquery/commands/QueryForecastCommand.ts @@ -20,6 +20,20 @@ import { export type QueryForecastCommandInput = QueryForecastRequest; export type QueryForecastCommandOutput = QueryForecastResponse & __MetadataBearer; +/** + *

Retrieves a forecast for a single item, filtered by the supplied criteria.

+ *

The criteria is a key-value pair. The key is either item_id (or the + * equivalent non-timestamp, non-target field) from the TARGET_TIME_SERIES dataset, + * or one of the forecast dimensions specified as part of the FeaturizationConfig + * object.

+ *

By default, QueryForecast returns the complete date range for the filtered + * forecast. You can request a specific date range.

+ *

To get the full forecast, use the CreateForecastExportJob operation.

+ * + *

The forecasts generated by Amazon Forecast are in the same timezone as the dataset that was + * used to create the predictor.

+ *
+ */ export class QueryForecastCommand extends $Command< QueryForecastCommandInput, QueryForecastCommandOutput, @@ -34,6 +48,9 @@ export class QueryForecastCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ForecastqueryClientResolvedConfig, diff --git a/clients/client-forecastquery/package.json b/clients/client-forecastquery/package.json index f4270f4ab155b..1a07ea997b063 100644 --- a/clients/client-forecastquery/package.json +++ b/clients/client-forecastquery/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Forecastquery Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-forecastquery/runtimeConfig.browser.ts b/clients/client-forecastquery/runtimeConfig.browser.ts index fe7c55ac8b7ee..066548687b61d 100644 --- a/clients/client-forecastquery/runtimeConfig.browser.ts +++ b/clients/client-forecastquery/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ForecastqueryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-forecastquery/runtimeConfig.native.ts b/clients/client-forecastquery/runtimeConfig.native.ts index 5b2493390597b..98bec5c1d37f3 100644 --- a/clients/client-forecastquery/runtimeConfig.native.ts +++ b/clients/client-forecastquery/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ForecastqueryClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-forecastquery/runtimeConfig.shared.ts b/clients/client-forecastquery/runtimeConfig.shared.ts index a7f2df37d629f..b8df8e0765e72 100644 --- a/clients/client-forecastquery/runtimeConfig.shared.ts +++ b/clients/client-forecastquery/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-06-26", disableHostPrefix: false, diff --git a/clients/client-forecastquery/runtimeConfig.ts b/clients/client-forecastquery/runtimeConfig.ts index a8229dde60a6a..1de92622a3d40 100644 --- a/clients/client-forecastquery/runtimeConfig.ts +++ b/clients/client-forecastquery/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ForecastqueryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-forecastquery/tsconfig.json b/clients/client-forecastquery/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-forecastquery/tsconfig.json +++ b/clients/client-forecastquery/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-frauddetector/commands/BatchCreateVariableCommand.ts b/clients/client-frauddetector/commands/BatchCreateVariableCommand.ts index 99a240d674e70..1621c69cf150d 100644 --- a/clients/client-frauddetector/commands/BatchCreateVariableCommand.ts +++ b/clients/client-frauddetector/commands/BatchCreateVariableCommand.ts @@ -20,6 +20,9 @@ import { export type BatchCreateVariableCommandInput = BatchCreateVariableRequest; export type BatchCreateVariableCommandOutput = BatchCreateVariableResult & __MetadataBearer; +/** + *

Creates a batch of variables.

+ */ export class BatchCreateVariableCommand extends $Command< BatchCreateVariableCommandInput, BatchCreateVariableCommandOutput, @@ -34,6 +37,9 @@ export class BatchCreateVariableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/BatchGetVariableCommand.ts b/clients/client-frauddetector/commands/BatchGetVariableCommand.ts index 908657c9ced6c..8b1ad4ba86185 100644 --- a/clients/client-frauddetector/commands/BatchGetVariableCommand.ts +++ b/clients/client-frauddetector/commands/BatchGetVariableCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetVariableCommandInput = BatchGetVariableRequest; export type BatchGetVariableCommandOutput = BatchGetVariableResult & __MetadataBearer; +/** + *

Gets a batch of variables.

+ */ export class BatchGetVariableCommand extends $Command< BatchGetVariableCommandInput, BatchGetVariableCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetVariableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/CreateDetectorVersionCommand.ts b/clients/client-frauddetector/commands/CreateDetectorVersionCommand.ts index b8f326442d233..f7a72fdf5a73c 100644 --- a/clients/client-frauddetector/commands/CreateDetectorVersionCommand.ts +++ b/clients/client-frauddetector/commands/CreateDetectorVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDetectorVersionCommandInput = CreateDetectorVersionRequest; export type CreateDetectorVersionCommandOutput = CreateDetectorVersionResult & __MetadataBearer; +/** + *

Creates a detector version. The detector version starts in a DRAFT status.

+ */ export class CreateDetectorVersionCommand extends $Command< CreateDetectorVersionCommandInput, CreateDetectorVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateDetectorVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/CreateModelCommand.ts b/clients/client-frauddetector/commands/CreateModelCommand.ts index 3ecd0448ef8b1..0cb826eb5b699 100644 --- a/clients/client-frauddetector/commands/CreateModelCommand.ts +++ b/clients/client-frauddetector/commands/CreateModelCommand.ts @@ -20,6 +20,9 @@ import { export type CreateModelCommandInput = CreateModelRequest; export type CreateModelCommandOutput = CreateModelResult & __MetadataBearer; +/** + *

Creates a model using the specified model type.

+ */ export class CreateModelCommand extends $Command< CreateModelCommandInput, CreateModelCommandOutput, @@ -34,6 +37,9 @@ export class CreateModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/CreateModelVersionCommand.ts b/clients/client-frauddetector/commands/CreateModelVersionCommand.ts index 6c39b23a8d230..3e57a194d7d9e 100644 --- a/clients/client-frauddetector/commands/CreateModelVersionCommand.ts +++ b/clients/client-frauddetector/commands/CreateModelVersionCommand.ts @@ -20,6 +20,10 @@ import { export type CreateModelVersionCommandInput = CreateModelVersionRequest; export type CreateModelVersionCommandOutput = CreateModelVersionResult & __MetadataBearer; +/** + *

Creates a version of the model using the specified model type and model id. + *

+ */ export class CreateModelVersionCommand extends $Command< CreateModelVersionCommandInput, CreateModelVersionCommandOutput, @@ -34,6 +38,9 @@ export class CreateModelVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/CreateRuleCommand.ts b/clients/client-frauddetector/commands/CreateRuleCommand.ts index d390b8cfee427..3aa99ea873208 100644 --- a/clients/client-frauddetector/commands/CreateRuleCommand.ts +++ b/clients/client-frauddetector/commands/CreateRuleCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRuleCommandInput = CreateRuleRequest; export type CreateRuleCommandOutput = CreateRuleResult & __MetadataBearer; +/** + *

Creates a rule for use with the specified detector.

+ */ export class CreateRuleCommand extends $Command< CreateRuleCommandInput, CreateRuleCommandOutput, @@ -34,6 +37,9 @@ export class CreateRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/CreateVariableCommand.ts b/clients/client-frauddetector/commands/CreateVariableCommand.ts index 517f70199954e..d7dee78d56ee1 100644 --- a/clients/client-frauddetector/commands/CreateVariableCommand.ts +++ b/clients/client-frauddetector/commands/CreateVariableCommand.ts @@ -20,6 +20,9 @@ import { export type CreateVariableCommandInput = CreateVariableRequest; export type CreateVariableCommandOutput = CreateVariableResult & __MetadataBearer; +/** + *

Creates a variable.

+ */ export class CreateVariableCommand extends $Command< CreateVariableCommandInput, CreateVariableCommandOutput, @@ -34,6 +37,9 @@ export class CreateVariableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteDetectorCommand.ts b/clients/client-frauddetector/commands/DeleteDetectorCommand.ts index c59fadf1bac6b..cab72aedbd2f9 100644 --- a/clients/client-frauddetector/commands/DeleteDetectorCommand.ts +++ b/clients/client-frauddetector/commands/DeleteDetectorCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDetectorCommandInput = DeleteDetectorRequest; export type DeleteDetectorCommandOutput = DeleteDetectorResult & __MetadataBearer; +/** + *

Deletes the detector. Before deleting a detector, you must first delete all detector versions and rule versions associated with the detector.

+ *

When you delete a detector, Amazon Fraud Detector permanently deletes the detector and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteDetectorCommand extends $Command< DeleteDetectorCommandInput, DeleteDetectorCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteDetectorVersionCommand.ts b/clients/client-frauddetector/commands/DeleteDetectorVersionCommand.ts index cbbf9ffc7cbb8..6c2929f355e56 100644 --- a/clients/client-frauddetector/commands/DeleteDetectorVersionCommand.ts +++ b/clients/client-frauddetector/commands/DeleteDetectorVersionCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDetectorVersionCommandInput = DeleteDetectorVersionRequest; export type DeleteDetectorVersionCommandOutput = DeleteDetectorVersionResult & __MetadataBearer; +/** + *

Deletes the detector version. You cannot delete detector versions that are in ACTIVE status.

+ *

When you delete a detector version, Amazon Fraud Detector permanently deletes the detector and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteDetectorVersionCommand extends $Command< DeleteDetectorVersionCommandInput, DeleteDetectorVersionCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDetectorVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteEntityTypeCommand.ts b/clients/client-frauddetector/commands/DeleteEntityTypeCommand.ts index ff4f260c74b29..a87ced7197397 100644 --- a/clients/client-frauddetector/commands/DeleteEntityTypeCommand.ts +++ b/clients/client-frauddetector/commands/DeleteEntityTypeCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteEntityTypeCommandInput = DeleteEntityTypeRequest; export type DeleteEntityTypeCommandOutput = DeleteEntityTypeResult & __MetadataBearer; +/** + *

Deletes an entity type.

+ *

You cannot delete an entity type that is included in an event type.

+ *

When you delete an entity type, Amazon Fraud Detector permanently deletes that entity type from the evaluation history, and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteEntityTypeCommand extends $Command< DeleteEntityTypeCommandInput, DeleteEntityTypeCommandOutput, @@ -34,6 +39,9 @@ export class DeleteEntityTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteEventCommand.ts b/clients/client-frauddetector/commands/DeleteEventCommand.ts index 8304af92416d9..e819a42529e5b 100644 --- a/clients/client-frauddetector/commands/DeleteEventCommand.ts +++ b/clients/client-frauddetector/commands/DeleteEventCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteEventCommandInput = DeleteEventRequest; export type DeleteEventCommandOutput = DeleteEventResult & __MetadataBearer; +/** + *

Deletes the specified event.

+ *

When you delete an event, Amazon Fraud Detector permanently deletes that event from the evaluation history, and the event data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteEventCommand extends $Command< DeleteEventCommandInput, DeleteEventCommandOutput, @@ -34,6 +38,9 @@ export class DeleteEventCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteEventTypeCommand.ts b/clients/client-frauddetector/commands/DeleteEventTypeCommand.ts index 3082df8b10dcd..4e7dd609b4b84 100644 --- a/clients/client-frauddetector/commands/DeleteEventTypeCommand.ts +++ b/clients/client-frauddetector/commands/DeleteEventTypeCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteEventTypeCommandInput = DeleteEventTypeRequest; export type DeleteEventTypeCommandOutput = DeleteEventTypeResult & __MetadataBearer; +/** + *

Deletes an event type.

+ *

You cannot delete an event type that is used in a detector or a model.

+ *

When you delete an entity type, Amazon Fraud Detector permanently deletes that entity type from the evaluation history, and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteEventTypeCommand extends $Command< DeleteEventTypeCommandInput, DeleteEventTypeCommandOutput, @@ -34,6 +39,9 @@ export class DeleteEventTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteExternalModelCommand.ts b/clients/client-frauddetector/commands/DeleteExternalModelCommand.ts index e2875874fc434..9d5ca0610f671 100644 --- a/clients/client-frauddetector/commands/DeleteExternalModelCommand.ts +++ b/clients/client-frauddetector/commands/DeleteExternalModelCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteExternalModelCommandInput = DeleteExternalModelRequest; export type DeleteExternalModelCommandOutput = DeleteExternalModelResult & __MetadataBearer; +/** + *

Removes a SageMaker model from Amazon Fraud Detector.

+ *

You can remove an Amazon SageMaker model if it is not associated with a detector version. Removing a SageMaker model disconnects it from Amazon Fraud Detector, but the model remains available in SageMaker.

+ */ export class DeleteExternalModelCommand extends $Command< DeleteExternalModelCommandInput, DeleteExternalModelCommandOutput, @@ -34,6 +38,9 @@ export class DeleteExternalModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteLabelCommand.ts b/clients/client-frauddetector/commands/DeleteLabelCommand.ts index a24b1b4271e55..e62ee1d3bfe96 100644 --- a/clients/client-frauddetector/commands/DeleteLabelCommand.ts +++ b/clients/client-frauddetector/commands/DeleteLabelCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteLabelCommandInput = DeleteLabelRequest; export type DeleteLabelCommandOutput = DeleteLabelResult & __MetadataBearer; +/** + *

Deletes a label.

+ *

You cannot delete labels that are included in an event type in Amazon Fraud Detector.

+ *

You cannot delete a label assigned to an event ID. You must first delete the relevant event ID.

+ * + *

When you delete a label, Amazon Fraud Detector permanently deletes that label from the evaluation history, and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteLabelCommand extends $Command< DeleteLabelCommandInput, DeleteLabelCommandOutput, @@ -34,6 +41,9 @@ export class DeleteLabelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteModelCommand.ts b/clients/client-frauddetector/commands/DeleteModelCommand.ts index e42907080bf9d..37909645966f3 100644 --- a/clients/client-frauddetector/commands/DeleteModelCommand.ts +++ b/clients/client-frauddetector/commands/DeleteModelCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteModelCommandInput = DeleteModelRequest; export type DeleteModelCommandOutput = DeleteModelResult & __MetadataBearer; +/** + *

Deletes a model.

+ *

You can delete models and model versions in Amazon Fraud Detector, provided that they are not associated with a detector version.

+ *

When you delete a model, Amazon Fraud Detector permanently deletes that model from the evaluation history, and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteModelCommand extends $Command< DeleteModelCommandInput, DeleteModelCommandOutput, @@ -34,6 +39,9 @@ export class DeleteModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteModelVersionCommand.ts b/clients/client-frauddetector/commands/DeleteModelVersionCommand.ts index 036cd0896cc3a..7f2cef51607f8 100644 --- a/clients/client-frauddetector/commands/DeleteModelVersionCommand.ts +++ b/clients/client-frauddetector/commands/DeleteModelVersionCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteModelVersionCommandInput = DeleteModelVersionRequest; export type DeleteModelVersionCommandOutput = DeleteModelVersionResult & __MetadataBearer; +/** + *

Deletes a model version.

+ *

You can delete models and model versions in Amazon Fraud Detector, provided that they are not associated with a detector version.

+ *

When you delete a model version, Amazon Fraud Detector permanently deletes that model version from the evaluation history, and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteModelVersionCommand extends $Command< DeleteModelVersionCommandInput, DeleteModelVersionCommandOutput, @@ -34,6 +39,9 @@ export class DeleteModelVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteOutcomeCommand.ts b/clients/client-frauddetector/commands/DeleteOutcomeCommand.ts index 5d5df2b294a5c..dc134d09c6e9c 100644 --- a/clients/client-frauddetector/commands/DeleteOutcomeCommand.ts +++ b/clients/client-frauddetector/commands/DeleteOutcomeCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteOutcomeCommandInput = DeleteOutcomeRequest; export type DeleteOutcomeCommandOutput = DeleteOutcomeResult & __MetadataBearer; +/** + *

Deletes an outcome.

+ *

You cannot delete an outcome that is used in a rule version.

+ *

When you delete an outcome, Amazon Fraud Detector permanently deletes that outcome from the evaluation history, and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteOutcomeCommand extends $Command< DeleteOutcomeCommandInput, DeleteOutcomeCommandOutput, @@ -34,6 +39,9 @@ export class DeleteOutcomeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteRuleCommand.ts b/clients/client-frauddetector/commands/DeleteRuleCommand.ts index 6609a375612df..556204d555992 100644 --- a/clients/client-frauddetector/commands/DeleteRuleCommand.ts +++ b/clients/client-frauddetector/commands/DeleteRuleCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteRuleCommandInput = DeleteRuleRequest; export type DeleteRuleCommandOutput = DeleteRuleResult & __MetadataBearer; +/** + *

Deletes the rule. You cannot delete a rule if it is used by an ACTIVE or INACTIVE detector version.

+ *

When you delete a rule, Amazon Fraud Detector permanently deletes that rule from the evaluation history, and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteRuleCommand extends $Command< DeleteRuleCommandInput, DeleteRuleCommandOutput, @@ -34,6 +38,9 @@ export class DeleteRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DeleteVariableCommand.ts b/clients/client-frauddetector/commands/DeleteVariableCommand.ts index eefd575dad67e..624010618bd37 100644 --- a/clients/client-frauddetector/commands/DeleteVariableCommand.ts +++ b/clients/client-frauddetector/commands/DeleteVariableCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteVariableCommandInput = DeleteVariableRequest; export type DeleteVariableCommandOutput = DeleteVariableResult & __MetadataBearer; +/** + *

Deletes a variable.

+ *

You can't delete variables that are included in an event type in Amazon Fraud Detector.

+ *

Amazon Fraud Detector automatically deletes model output variables and SageMaker model output variables when you delete the model. You can't delete these variables manually.

+ *

When you delete a variable, Amazon Fraud Detector permanently deletes that variable from the evaluation history, and the data is no longer stored in Amazon Fraud Detector.

+ */ export class DeleteVariableCommand extends $Command< DeleteVariableCommandInput, DeleteVariableCommandOutput, @@ -34,6 +40,9 @@ export class DeleteVariableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DescribeDetectorCommand.ts b/clients/client-frauddetector/commands/DescribeDetectorCommand.ts index ca71be90ba247..573320a4fb83d 100644 --- a/clients/client-frauddetector/commands/DescribeDetectorCommand.ts +++ b/clients/client-frauddetector/commands/DescribeDetectorCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDetectorCommandInput = DescribeDetectorRequest; export type DescribeDetectorCommandOutput = DescribeDetectorResult & __MetadataBearer; +/** + *

Gets all versions for a specified detector.

+ */ export class DescribeDetectorCommand extends $Command< DescribeDetectorCommandInput, DescribeDetectorCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/DescribeModelVersionsCommand.ts b/clients/client-frauddetector/commands/DescribeModelVersionsCommand.ts index 343124456a420..d94eefc26e87a 100644 --- a/clients/client-frauddetector/commands/DescribeModelVersionsCommand.ts +++ b/clients/client-frauddetector/commands/DescribeModelVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeModelVersionsCommandInput = DescribeModelVersionsRequest; export type DescribeModelVersionsCommandOutput = DescribeModelVersionsResult & __MetadataBearer; +/** + *

Gets all of the model versions for the specified model type or for the specified model type and model ID. You can also get details for a single, specified model version.

+ */ export class DescribeModelVersionsCommand extends $Command< DescribeModelVersionsCommandInput, DescribeModelVersionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeModelVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetDetectorVersionCommand.ts b/clients/client-frauddetector/commands/GetDetectorVersionCommand.ts index 05bb9613f7603..0678cabe52624 100644 --- a/clients/client-frauddetector/commands/GetDetectorVersionCommand.ts +++ b/clients/client-frauddetector/commands/GetDetectorVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetDetectorVersionCommandInput = GetDetectorVersionRequest; export type GetDetectorVersionCommandOutput = GetDetectorVersionResult & __MetadataBearer; +/** + *

Gets a particular detector version.

+ */ export class GetDetectorVersionCommand extends $Command< GetDetectorVersionCommandInput, GetDetectorVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetDetectorVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetDetectorsCommand.ts b/clients/client-frauddetector/commands/GetDetectorsCommand.ts index da79b99ff9b87..18e818a9a62cc 100644 --- a/clients/client-frauddetector/commands/GetDetectorsCommand.ts +++ b/clients/client-frauddetector/commands/GetDetectorsCommand.ts @@ -20,6 +20,14 @@ import { export type GetDetectorsCommandInput = GetDetectorsRequest; export type GetDetectorsCommandOutput = GetDetectorsResult & __MetadataBearer; +/** + *

Gets all detectors or a single detector if a detectorId is specified. This is a paginated API. If you + * provide a null maxResults, this action retrieves a maximum of 10 records + * per page. If you provide a maxResults, the value must be between 5 and 10. + * To get the next page results, provide the pagination token from the + * GetDetectorsResponse as part of your request. A null pagination token + * fetches the records from the beginning.

+ */ export class GetDetectorsCommand extends $Command< GetDetectorsCommandInput, GetDetectorsCommandOutput, @@ -34,6 +42,9 @@ export class GetDetectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetEntityTypesCommand.ts b/clients/client-frauddetector/commands/GetEntityTypesCommand.ts index 57d776ffb1690..ce0b1b19e790e 100644 --- a/clients/client-frauddetector/commands/GetEntityTypesCommand.ts +++ b/clients/client-frauddetector/commands/GetEntityTypesCommand.ts @@ -20,6 +20,14 @@ import { export type GetEntityTypesCommandInput = GetEntityTypesRequest; export type GetEntityTypesCommandOutput = GetEntityTypesResult & __MetadataBearer; +/** + *

Gets all entity types or a specific entity type if a name is specified. This is a paginated API. If you + * provide a null maxResults, this action retrieves a maximum of 10 records + * per page. If you provide a maxResults, the value must be between 5 and 10. + * To get the next page results, provide the pagination token from the + * GetEntityTypesResponse as part of your request. A null pagination token + * fetches the records from the beginning.

+ */ export class GetEntityTypesCommand extends $Command< GetEntityTypesCommandInput, GetEntityTypesCommandOutput, @@ -34,6 +42,9 @@ export class GetEntityTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetEventPredictionCommand.ts b/clients/client-frauddetector/commands/GetEventPredictionCommand.ts index 0fab730bd0cfc..78d7f5135c056 100644 --- a/clients/client-frauddetector/commands/GetEventPredictionCommand.ts +++ b/clients/client-frauddetector/commands/GetEventPredictionCommand.ts @@ -20,6 +20,9 @@ import { export type GetEventPredictionCommandInput = GetEventPredictionRequest; export type GetEventPredictionCommandOutput = GetEventPredictionResult & __MetadataBearer; +/** + *

Evaluates an event against a detector version. If a version ID is not provided, the detector’s (ACTIVE) version is used.

+ */ export class GetEventPredictionCommand extends $Command< GetEventPredictionCommandInput, GetEventPredictionCommandOutput, @@ -34,6 +37,9 @@ export class GetEventPredictionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetEventTypesCommand.ts b/clients/client-frauddetector/commands/GetEventTypesCommand.ts index 414021436fc0b..a2451639330d9 100644 --- a/clients/client-frauddetector/commands/GetEventTypesCommand.ts +++ b/clients/client-frauddetector/commands/GetEventTypesCommand.ts @@ -20,6 +20,14 @@ import { export type GetEventTypesCommandInput = GetEventTypesRequest; export type GetEventTypesCommandOutput = GetEventTypesResult & __MetadataBearer; +/** + *

Gets all event types or a specific event type if name is provided. This is a paginated API. If you + * provide a null maxResults, this action retrieves a maximum of 10 records + * per page. If you provide a maxResults, the value must be between 5 and 10. + * To get the next page results, provide the pagination token from the + * GetEventTypesResponse as part of your request. A null pagination token + * fetches the records from the beginning.

+ */ export class GetEventTypesCommand extends $Command< GetEventTypesCommandInput, GetEventTypesCommandOutput, @@ -34,6 +42,9 @@ export class GetEventTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetExternalModelsCommand.ts b/clients/client-frauddetector/commands/GetExternalModelsCommand.ts index ddd76258e73bf..fe3685f2230a9 100644 --- a/clients/client-frauddetector/commands/GetExternalModelsCommand.ts +++ b/clients/client-frauddetector/commands/GetExternalModelsCommand.ts @@ -20,6 +20,14 @@ import { export type GetExternalModelsCommandInput = GetExternalModelsRequest; export type GetExternalModelsCommandOutput = GetExternalModelsResult & __MetadataBearer; +/** + *

Gets the details for one or more Amazon SageMaker models that have been imported into the + * service. This is a paginated API. If you provide a null maxResults, this + * actions retrieves a maximum of 10 records per page. If you provide a + * maxResults, the value must be between 5 and 10. To get the next page + * results, provide the pagination token from the GetExternalModelsResult as part + * of your request. A null pagination token fetches the records from the beginning.

+ */ export class GetExternalModelsCommand extends $Command< GetExternalModelsCommandInput, GetExternalModelsCommandOutput, @@ -34,6 +42,9 @@ export class GetExternalModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetKMSEncryptionKeyCommand.ts b/clients/client-frauddetector/commands/GetKMSEncryptionKeyCommand.ts index fcf3ab8c773dd..429e55ae3934b 100644 --- a/clients/client-frauddetector/commands/GetKMSEncryptionKeyCommand.ts +++ b/clients/client-frauddetector/commands/GetKMSEncryptionKeyCommand.ts @@ -20,6 +20,9 @@ import { export type GetKMSEncryptionKeyCommandInput = {}; export type GetKMSEncryptionKeyCommandOutput = GetKMSEncryptionKeyResult & __MetadataBearer; +/** + *

Gets the encryption key if a Key Management Service (KMS) customer master key (CMK) has been specified to be used to encrypt content in Amazon Fraud Detector.

+ */ export class GetKMSEncryptionKeyCommand extends $Command< GetKMSEncryptionKeyCommandInput, GetKMSEncryptionKeyCommandOutput, @@ -34,6 +37,9 @@ export class GetKMSEncryptionKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetLabelsCommand.ts b/clients/client-frauddetector/commands/GetLabelsCommand.ts index a29aa775d9128..5770c6e1cde6f 100644 --- a/clients/client-frauddetector/commands/GetLabelsCommand.ts +++ b/clients/client-frauddetector/commands/GetLabelsCommand.ts @@ -17,6 +17,14 @@ import { export type GetLabelsCommandInput = GetLabelsRequest; export type GetLabelsCommandOutput = GetLabelsResult & __MetadataBearer; +/** + *

Gets all labels or a specific label if name is provided. This is a paginated API. If you + * provide a null maxResults, this action retrieves a maximum of 50 records + * per page. If you provide a maxResults, the value must be between 10 and 50. + * To get the next page results, provide the pagination token from the + * GetGetLabelsResponse as part of your request. A null pagination token + * fetches the records from the beginning.

+ */ export class GetLabelsCommand extends $Command< GetLabelsCommandInput, GetLabelsCommandOutput, @@ -31,6 +39,9 @@ export class GetLabelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetModelVersionCommand.ts b/clients/client-frauddetector/commands/GetModelVersionCommand.ts index bae2ed7eb1533..775f9113700a1 100644 --- a/clients/client-frauddetector/commands/GetModelVersionCommand.ts +++ b/clients/client-frauddetector/commands/GetModelVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetModelVersionCommandInput = GetModelVersionRequest; export type GetModelVersionCommandOutput = GetModelVersionResult & __MetadataBearer; +/** + *

Gets the details of the specified model version.

+ */ export class GetModelVersionCommand extends $Command< GetModelVersionCommandInput, GetModelVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetModelVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetModelsCommand.ts b/clients/client-frauddetector/commands/GetModelsCommand.ts index cfb455dfeb2b5..459e782aee3da 100644 --- a/clients/client-frauddetector/commands/GetModelsCommand.ts +++ b/clients/client-frauddetector/commands/GetModelsCommand.ts @@ -17,6 +17,15 @@ import { export type GetModelsCommandInput = GetModelsRequest; export type GetModelsCommandOutput = GetModelsResult & __MetadataBearer; +/** + *

Gets one or more models. Gets all models for the AWS account if no model type and no model id provided. Gets all models for the AWS account and model type, if the model type is specified but model id is not provided. Gets a specific model if (model type, model id) tuple is specified.

+ *

This is a paginated API. If you + * provide a null maxResults, this action retrieves a maximum of 10 records + * per page. If you provide a maxResults, the value must be between 1 and 10. + * To get the next page results, provide the pagination token from the + * response as part of your request. A null pagination token + * fetches the records from the beginning.

+ */ export class GetModelsCommand extends $Command< GetModelsCommandInput, GetModelsCommandOutput, @@ -31,6 +40,9 @@ export class GetModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetOutcomesCommand.ts b/clients/client-frauddetector/commands/GetOutcomesCommand.ts index d9d763634c1b0..def9fe84b08e8 100644 --- a/clients/client-frauddetector/commands/GetOutcomesCommand.ts +++ b/clients/client-frauddetector/commands/GetOutcomesCommand.ts @@ -20,6 +20,14 @@ import { export type GetOutcomesCommandInput = GetOutcomesRequest; export type GetOutcomesCommandOutput = GetOutcomesResult & __MetadataBearer; +/** + *

Gets one or more outcomes. This is a paginated + * API. If you provide a null maxResults, this actions retrieves a maximum of + * 100 records per page. If you provide a maxResults, the value must be + * between 50 and 100. To get the next page results, provide the pagination token from the + * GetOutcomesResult as part of your request. A null pagination token + * fetches the records from the beginning.

+ */ export class GetOutcomesCommand extends $Command< GetOutcomesCommandInput, GetOutcomesCommandOutput, @@ -34,6 +42,9 @@ export class GetOutcomesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetRulesCommand.ts b/clients/client-frauddetector/commands/GetRulesCommand.ts index fff324df1f7e0..92dc9e0a2a837 100644 --- a/clients/client-frauddetector/commands/GetRulesCommand.ts +++ b/clients/client-frauddetector/commands/GetRulesCommand.ts @@ -17,6 +17,10 @@ import { export type GetRulesCommandInput = GetRulesRequest; export type GetRulesCommandOutput = GetRulesResult & __MetadataBearer; +/** + *

Get all rules for a detector (paginated) if ruleId and ruleVersion are not specified. Gets all rules for the detector and the ruleId if present (paginated). Gets a specific rule if both the ruleId and the ruleVersion are specified.

+ *

This is a paginated API. Providing null maxResults results in retrieving maximum of 100 records per page. If you provide maxResults the value must be between 50 and 100. To get the next page result, a provide a pagination token from GetRulesResult as part of your request. Null pagination token fetches the records from the beginning.

+ */ export class GetRulesCommand extends $Command< GetRulesCommandInput, GetRulesCommandOutput, @@ -31,6 +35,9 @@ export class GetRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/GetVariablesCommand.ts b/clients/client-frauddetector/commands/GetVariablesCommand.ts index 50366207a15fe..53b009faa5d1d 100644 --- a/clients/client-frauddetector/commands/GetVariablesCommand.ts +++ b/clients/client-frauddetector/commands/GetVariablesCommand.ts @@ -20,6 +20,14 @@ import { export type GetVariablesCommandInput = GetVariablesRequest; export type GetVariablesCommandOutput = GetVariablesResult & __MetadataBearer; +/** + *

Gets all of the variables or the specific variable. This is a + * paginated API. Providing null maxSizePerPage results in retrieving maximum of + * 100 records per page. If you provide maxSizePerPage the value must be between + * 50 and 100. To get the next page result, a provide a pagination token from + * GetVariablesResult as part of your request. Null pagination token + * fetches the records from the beginning.

+ */ export class GetVariablesCommand extends $Command< GetVariablesCommandInput, GetVariablesCommandOutput, @@ -34,6 +42,9 @@ export class GetVariablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/ListTagsForResourceCommand.ts b/clients/client-frauddetector/commands/ListTagsForResourceCommand.ts index 191e9c3a3e173..9d9bfec036a79 100644 --- a/clients/client-frauddetector/commands/ListTagsForResourceCommand.ts +++ b/clients/client-frauddetector/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResult & __MetadataBearer; +/** + *

Lists all tags associated with the resource. This is a paginated API. To get the next page results, provide the pagination token from the + * response as part of your request. A null pagination token + * fetches the records from the beginning.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/PutDetectorCommand.ts b/clients/client-frauddetector/commands/PutDetectorCommand.ts index 7c4d617c33011..1d66025fe3a92 100644 --- a/clients/client-frauddetector/commands/PutDetectorCommand.ts +++ b/clients/client-frauddetector/commands/PutDetectorCommand.ts @@ -20,6 +20,9 @@ import { export type PutDetectorCommandInput = PutDetectorRequest; export type PutDetectorCommandOutput = PutDetectorResult & __MetadataBearer; +/** + *

Creates or updates a detector.

+ */ export class PutDetectorCommand extends $Command< PutDetectorCommandInput, PutDetectorCommandOutput, @@ -34,6 +37,9 @@ export class PutDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/PutEntityTypeCommand.ts b/clients/client-frauddetector/commands/PutEntityTypeCommand.ts index 9447a4b7db84a..ef605de7d0f20 100644 --- a/clients/client-frauddetector/commands/PutEntityTypeCommand.ts +++ b/clients/client-frauddetector/commands/PutEntityTypeCommand.ts @@ -20,6 +20,9 @@ import { export type PutEntityTypeCommandInput = PutEntityTypeRequest; export type PutEntityTypeCommandOutput = PutEntityTypeResult & __MetadataBearer; +/** + *

Creates or updates an entity type. An entity represents who is performing the event. As part of a fraud prediction, you pass the entity ID to indicate the specific entity who performed the event. An entity type classifies the entity. Example classifications include customer, merchant, or account.

+ */ export class PutEntityTypeCommand extends $Command< PutEntityTypeCommandInput, PutEntityTypeCommandOutput, @@ -34,6 +37,9 @@ export class PutEntityTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/PutEventTypeCommand.ts b/clients/client-frauddetector/commands/PutEventTypeCommand.ts index e04f1c5be6aa2..08e5ea520fcdb 100644 --- a/clients/client-frauddetector/commands/PutEventTypeCommand.ts +++ b/clients/client-frauddetector/commands/PutEventTypeCommand.ts @@ -20,6 +20,9 @@ import { export type PutEventTypeCommandInput = PutEventTypeRequest; export type PutEventTypeCommandOutput = PutEventTypeResult & __MetadataBearer; +/** + *

Creates or updates an event type. An event is a business activity that is evaluated for fraud risk. With Amazon Fraud Detector, you generate fraud predictions for events. An event type defines the structure for an event sent to Amazon Fraud Detector. This includes the variables sent as part of the event, the entity performing the event (such as a customer), and the labels that classify the event. Example event types include online payment transactions, account registrations, and authentications.

+ */ export class PutEventTypeCommand extends $Command< PutEventTypeCommandInput, PutEventTypeCommandOutput, @@ -34,6 +37,9 @@ export class PutEventTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/PutExternalModelCommand.ts b/clients/client-frauddetector/commands/PutExternalModelCommand.ts index 3c8c97fb49d5f..5c5a051c55725 100644 --- a/clients/client-frauddetector/commands/PutExternalModelCommand.ts +++ b/clients/client-frauddetector/commands/PutExternalModelCommand.ts @@ -20,6 +20,9 @@ import { export type PutExternalModelCommandInput = PutExternalModelRequest; export type PutExternalModelCommandOutput = PutExternalModelResult & __MetadataBearer; +/** + *

Creates or updates an Amazon SageMaker model endpoint. You can also use this action to update the configuration of the model endpoint, including the IAM role and/or the mapped variables.

+ */ export class PutExternalModelCommand extends $Command< PutExternalModelCommandInput, PutExternalModelCommandOutput, @@ -34,6 +37,9 @@ export class PutExternalModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/PutKMSEncryptionKeyCommand.ts b/clients/client-frauddetector/commands/PutKMSEncryptionKeyCommand.ts index 464d3a22d35fc..fa26f01f4cc04 100644 --- a/clients/client-frauddetector/commands/PutKMSEncryptionKeyCommand.ts +++ b/clients/client-frauddetector/commands/PutKMSEncryptionKeyCommand.ts @@ -20,6 +20,9 @@ import { export type PutKMSEncryptionKeyCommandInput = PutKMSEncryptionKeyRequest; export type PutKMSEncryptionKeyCommandOutput = PutKMSEncryptionKeyResult & __MetadataBearer; +/** + *

Specifies the Key Management Service (KMS) customer master key (CMK) to be used to encrypt content in Amazon Fraud Detector.

+ */ export class PutKMSEncryptionKeyCommand extends $Command< PutKMSEncryptionKeyCommandInput, PutKMSEncryptionKeyCommandOutput, @@ -34,6 +37,9 @@ export class PutKMSEncryptionKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/PutLabelCommand.ts b/clients/client-frauddetector/commands/PutLabelCommand.ts index d6479a6191ca1..d15e168d54a83 100644 --- a/clients/client-frauddetector/commands/PutLabelCommand.ts +++ b/clients/client-frauddetector/commands/PutLabelCommand.ts @@ -17,6 +17,9 @@ import { export type PutLabelCommandInput = PutLabelRequest; export type PutLabelCommandOutput = PutLabelResult & __MetadataBearer; +/** + *

Creates or updates label. A label classifies an event as fraudulent or legitimate. Labels are associated with event types and used to train supervised machine learning models in Amazon Fraud Detector.

+ */ export class PutLabelCommand extends $Command< PutLabelCommandInput, PutLabelCommandOutput, @@ -31,6 +34,9 @@ export class PutLabelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/PutOutcomeCommand.ts b/clients/client-frauddetector/commands/PutOutcomeCommand.ts index b73aae2c75269..393d93e843c51 100644 --- a/clients/client-frauddetector/commands/PutOutcomeCommand.ts +++ b/clients/client-frauddetector/commands/PutOutcomeCommand.ts @@ -20,6 +20,9 @@ import { export type PutOutcomeCommandInput = PutOutcomeRequest; export type PutOutcomeCommandOutput = PutOutcomeResult & __MetadataBearer; +/** + *

Creates or updates an outcome.

+ */ export class PutOutcomeCommand extends $Command< PutOutcomeCommandInput, PutOutcomeCommandOutput, @@ -34,6 +37,9 @@ export class PutOutcomeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/TagResourceCommand.ts b/clients/client-frauddetector/commands/TagResourceCommand.ts index edc50fb8985f1..a730f48d54ec5 100644 --- a/clients/client-frauddetector/commands/TagResourceCommand.ts +++ b/clients/client-frauddetector/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResult & __MetadataBearer; +/** + *

Assigns tags to a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UntagResourceCommand.ts b/clients/client-frauddetector/commands/UntagResourceCommand.ts index 0c2685bacbf09..eb6a1e30dd2e3 100644 --- a/clients/client-frauddetector/commands/UntagResourceCommand.ts +++ b/clients/client-frauddetector/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResult & __MetadataBearer; +/** + *

Removes tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateDetectorVersionCommand.ts b/clients/client-frauddetector/commands/UpdateDetectorVersionCommand.ts index 8c3a11bd2b113..e21f02e236256 100644 --- a/clients/client-frauddetector/commands/UpdateDetectorVersionCommand.ts +++ b/clients/client-frauddetector/commands/UpdateDetectorVersionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDetectorVersionCommandInput = UpdateDetectorVersionRequest; export type UpdateDetectorVersionCommandOutput = UpdateDetectorVersionResult & __MetadataBearer; +/** + *

Updates a detector version. The detector version attributes that you can update include models, external model endpoints, rules, rule execution mode, and description. You can only update a DRAFT detector version.

+ */ export class UpdateDetectorVersionCommand extends $Command< UpdateDetectorVersionCommandInput, UpdateDetectorVersionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDetectorVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateDetectorVersionMetadataCommand.ts b/clients/client-frauddetector/commands/UpdateDetectorVersionMetadataCommand.ts index 14a4fcca88dda..be8abca2cd427 100644 --- a/clients/client-frauddetector/commands/UpdateDetectorVersionMetadataCommand.ts +++ b/clients/client-frauddetector/commands/UpdateDetectorVersionMetadataCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDetectorVersionMetadataCommandInput = UpdateDetectorVersionMetadataRequest; export type UpdateDetectorVersionMetadataCommandOutput = UpdateDetectorVersionMetadataResult & __MetadataBearer; +/** + *

Updates the detector version's description. You can update the metadata for any detector version (DRAFT, ACTIVE, or + * INACTIVE).

+ */ export class UpdateDetectorVersionMetadataCommand extends $Command< UpdateDetectorVersionMetadataCommandInput, UpdateDetectorVersionMetadataCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDetectorVersionMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateDetectorVersionStatusCommand.ts b/clients/client-frauddetector/commands/UpdateDetectorVersionStatusCommand.ts index e976c3a07f4a7..1828045410307 100644 --- a/clients/client-frauddetector/commands/UpdateDetectorVersionStatusCommand.ts +++ b/clients/client-frauddetector/commands/UpdateDetectorVersionStatusCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDetectorVersionStatusCommandInput = UpdateDetectorVersionStatusRequest; export type UpdateDetectorVersionStatusCommandOutput = UpdateDetectorVersionStatusResult & __MetadataBearer; +/** + *

Updates the detector version’s status. You can perform the following promotions or + * demotions using UpdateDetectorVersionStatus: DRAFT to ACTIVE, ACTIVE to INACTIVE, and INACTIVE to ACTIVE.

+ */ export class UpdateDetectorVersionStatusCommand extends $Command< UpdateDetectorVersionStatusCommandInput, UpdateDetectorVersionStatusCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDetectorVersionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateModelCommand.ts b/clients/client-frauddetector/commands/UpdateModelCommand.ts index 00768d145dfc0..89c18eee1ca24 100644 --- a/clients/client-frauddetector/commands/UpdateModelCommand.ts +++ b/clients/client-frauddetector/commands/UpdateModelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateModelCommandInput = UpdateModelRequest; export type UpdateModelCommandOutput = UpdateModelResult & __MetadataBearer; +/** + *

Updates a model. You can update the description attribute using this action.

+ */ export class UpdateModelCommand extends $Command< UpdateModelCommandInput, UpdateModelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateModelVersionCommand.ts b/clients/client-frauddetector/commands/UpdateModelVersionCommand.ts index b98efca174136..1ad74e52f4d1c 100644 --- a/clients/client-frauddetector/commands/UpdateModelVersionCommand.ts +++ b/clients/client-frauddetector/commands/UpdateModelVersionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateModelVersionCommandInput = UpdateModelVersionRequest; export type UpdateModelVersionCommandOutput = UpdateModelVersionResult & __MetadataBearer; +/** + *

Updates a model version. Updating a model version retrains an existing model version using updated training data and produces a new minor version of the model. You can update the training data set location and data access role attributes using this action. This action creates and trains a new minor version of the model, for example version 1.01, 1.02, 1.03.

+ */ export class UpdateModelVersionCommand extends $Command< UpdateModelVersionCommandInput, UpdateModelVersionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateModelVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateModelVersionStatusCommand.ts b/clients/client-frauddetector/commands/UpdateModelVersionStatusCommand.ts index 28d0c5b6a6dff..98f6e241031ff 100644 --- a/clients/client-frauddetector/commands/UpdateModelVersionStatusCommand.ts +++ b/clients/client-frauddetector/commands/UpdateModelVersionStatusCommand.ts @@ -20,6 +20,18 @@ import { export type UpdateModelVersionStatusCommandInput = UpdateModelVersionStatusRequest; export type UpdateModelVersionStatusCommandOutput = UpdateModelVersionStatusResult & __MetadataBearer; +/** + *

Updates the status of a model version.

+ *

You can perform the following status updates:

+ *
    + *
  1. + *

    Change the TRAINING_COMPLETE status to ACTIVE.

    + *
  2. + *
  3. + *

    Change ACTIVEto INACTIVE.

    + *
  4. + *
+ */ export class UpdateModelVersionStatusCommand extends $Command< UpdateModelVersionStatusCommandInput, UpdateModelVersionStatusCommandOutput, @@ -34,6 +46,9 @@ export class UpdateModelVersionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateRuleMetadataCommand.ts b/clients/client-frauddetector/commands/UpdateRuleMetadataCommand.ts index 2abc5c159f7e0..1eb401a77e69e 100644 --- a/clients/client-frauddetector/commands/UpdateRuleMetadataCommand.ts +++ b/clients/client-frauddetector/commands/UpdateRuleMetadataCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRuleMetadataCommandInput = UpdateRuleMetadataRequest; export type UpdateRuleMetadataCommandOutput = UpdateRuleMetadataResult & __MetadataBearer; +/** + *

Updates a rule's metadata. The description attribute can be updated.

+ */ export class UpdateRuleMetadataCommand extends $Command< UpdateRuleMetadataCommandInput, UpdateRuleMetadataCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRuleMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateRuleVersionCommand.ts b/clients/client-frauddetector/commands/UpdateRuleVersionCommand.ts index 9745f0800e5a8..6f5bc84b66e41 100644 --- a/clients/client-frauddetector/commands/UpdateRuleVersionCommand.ts +++ b/clients/client-frauddetector/commands/UpdateRuleVersionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRuleVersionCommandInput = UpdateRuleVersionRequest; export type UpdateRuleVersionCommandOutput = UpdateRuleVersionResult & __MetadataBearer; +/** + *

Updates a rule version resulting in a new rule version. Updates a rule version resulting in a new rule version (version 1, 2, 3 ...).

+ */ export class UpdateRuleVersionCommand extends $Command< UpdateRuleVersionCommandInput, UpdateRuleVersionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRuleVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/commands/UpdateVariableCommand.ts b/clients/client-frauddetector/commands/UpdateVariableCommand.ts index c97a4f1e360a0..459f3b768a820 100644 --- a/clients/client-frauddetector/commands/UpdateVariableCommand.ts +++ b/clients/client-frauddetector/commands/UpdateVariableCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVariableCommandInput = UpdateVariableRequest; export type UpdateVariableCommandOutput = UpdateVariableResult & __MetadataBearer; +/** + *

Updates a variable.

+ */ export class UpdateVariableCommand extends $Command< UpdateVariableCommandInput, UpdateVariableCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVariableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FraudDetectorClientResolvedConfig, diff --git a/clients/client-frauddetector/package.json b/clients/client-frauddetector/package.json index 78e34ef30ae50..3e7b0c1e4d876 100644 --- a/clients/client-frauddetector/package.json +++ b/clients/client-frauddetector/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Frauddetector Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-frauddetector/pagination/DescribeModelVersionsPaginator.ts b/clients/client-frauddetector/pagination/DescribeModelVersionsPaginator.ts index 46689ff6461a4..4369b26719a5e 100644 --- a/clients/client-frauddetector/pagination/DescribeModelVersionsPaginator.ts +++ b/clients/client-frauddetector/pagination/DescribeModelVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: DescribeModelVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeModelVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: DescribeModelVersionsCommandInput, diff --git a/clients/client-frauddetector/pagination/GetDetectorsPaginator.ts b/clients/client-frauddetector/pagination/GetDetectorsPaginator.ts index 36d6d703ffec3..94f00e1b48970 100644 --- a/clients/client-frauddetector/pagination/GetDetectorsPaginator.ts +++ b/clients/client-frauddetector/pagination/GetDetectorsPaginator.ts @@ -8,6 +8,9 @@ import { import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetDetectorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDetectorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetDetectorsCommandInput, diff --git a/clients/client-frauddetector/pagination/GetEntityTypesPaginator.ts b/clients/client-frauddetector/pagination/GetEntityTypesPaginator.ts index a4d37a734319e..7f841ccac0e3b 100644 --- a/clients/client-frauddetector/pagination/GetEntityTypesPaginator.ts +++ b/clients/client-frauddetector/pagination/GetEntityTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetEntityTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetEntityTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetEntityTypesCommandInput, diff --git a/clients/client-frauddetector/pagination/GetEventTypesPaginator.ts b/clients/client-frauddetector/pagination/GetEventTypesPaginator.ts index 0ce500054c562..6a2967586aefd 100644 --- a/clients/client-frauddetector/pagination/GetEventTypesPaginator.ts +++ b/clients/client-frauddetector/pagination/GetEventTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetEventTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetEventTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetEventTypesCommandInput, diff --git a/clients/client-frauddetector/pagination/GetExternalModelsPaginator.ts b/clients/client-frauddetector/pagination/GetExternalModelsPaginator.ts index c8c96ed57702f..ff4846bbeb5b6 100644 --- a/clients/client-frauddetector/pagination/GetExternalModelsPaginator.ts +++ b/clients/client-frauddetector/pagination/GetExternalModelsPaginator.ts @@ -8,6 +8,9 @@ import { import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetExternalModelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetExternalModelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetExternalModelsCommandInput, diff --git a/clients/client-frauddetector/pagination/GetLabelsPaginator.ts b/clients/client-frauddetector/pagination/GetLabelsPaginator.ts index ca1207af45287..f9fe145e4f300 100644 --- a/clients/client-frauddetector/pagination/GetLabelsPaginator.ts +++ b/clients/client-frauddetector/pagination/GetLabelsPaginator.ts @@ -4,6 +4,9 @@ import { GetLabelsCommand, GetLabelsCommandInput, GetLabelsCommandOutput } from import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetLabelsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetLabelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetLabelsCommandInput, diff --git a/clients/client-frauddetector/pagination/GetModelsPaginator.ts b/clients/client-frauddetector/pagination/GetModelsPaginator.ts index 18ee9b5308a47..907d9d5fdf6d4 100644 --- a/clients/client-frauddetector/pagination/GetModelsPaginator.ts +++ b/clients/client-frauddetector/pagination/GetModelsPaginator.ts @@ -4,6 +4,9 @@ import { GetModelsCommand, GetModelsCommandInput, GetModelsCommandOutput } from import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetModelsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetModelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetModelsCommandInput, diff --git a/clients/client-frauddetector/pagination/GetOutcomesPaginator.ts b/clients/client-frauddetector/pagination/GetOutcomesPaginator.ts index 5f5beebeb6112..4f305109cc856 100644 --- a/clients/client-frauddetector/pagination/GetOutcomesPaginator.ts +++ b/clients/client-frauddetector/pagination/GetOutcomesPaginator.ts @@ -4,6 +4,9 @@ import { GetOutcomesCommand, GetOutcomesCommandInput, GetOutcomesCommandOutput } import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetOutcomesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetOutcomesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetOutcomesCommandInput, diff --git a/clients/client-frauddetector/pagination/GetRulesPaginator.ts b/clients/client-frauddetector/pagination/GetRulesPaginator.ts index 0a8b4782cebdd..c996b52b410a1 100644 --- a/clients/client-frauddetector/pagination/GetRulesPaginator.ts +++ b/clients/client-frauddetector/pagination/GetRulesPaginator.ts @@ -4,6 +4,9 @@ import { GetRulesCommand, GetRulesCommandInput, GetRulesCommandOutput } from ".. import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetRulesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetRulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetRulesCommandInput, diff --git a/clients/client-frauddetector/pagination/GetVariablesPaginator.ts b/clients/client-frauddetector/pagination/GetVariablesPaginator.ts index 43864b53d45a7..ffc5cbbcf04cf 100644 --- a/clients/client-frauddetector/pagination/GetVariablesPaginator.ts +++ b/clients/client-frauddetector/pagination/GetVariablesPaginator.ts @@ -8,6 +8,9 @@ import { import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: GetVariablesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetVariablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: GetVariablesCommandInput, diff --git a/clients/client-frauddetector/pagination/ListTagsForResourcePaginator.ts b/clients/client-frauddetector/pagination/ListTagsForResourcePaginator.ts index 244965c9b845c..af89987b97562 100644 --- a/clients/client-frauddetector/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-frauddetector/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { FraudDetectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FraudDetectorClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FraudDetector, input: ListTagsForResourceCommandInput, diff --git a/clients/client-frauddetector/runtimeConfig.browser.ts b/clients/client-frauddetector/runtimeConfig.browser.ts index 0590a66662058..50655bf6c8345 100644 --- a/clients/client-frauddetector/runtimeConfig.browser.ts +++ b/clients/client-frauddetector/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./FraudDetectorClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-frauddetector/runtimeConfig.native.ts b/clients/client-frauddetector/runtimeConfig.native.ts index 2c432a94fad85..ed6f21b6f56a2 100644 --- a/clients/client-frauddetector/runtimeConfig.native.ts +++ b/clients/client-frauddetector/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./FraudDetectorClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-frauddetector/runtimeConfig.shared.ts b/clients/client-frauddetector/runtimeConfig.shared.ts index 51a699721b235..15622080ea94f 100644 --- a/clients/client-frauddetector/runtimeConfig.shared.ts +++ b/clients/client-frauddetector/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-11-15", disableHostPrefix: false, diff --git a/clients/client-frauddetector/runtimeConfig.ts b/clients/client-frauddetector/runtimeConfig.ts index 58771819952e9..8c169c22c4637 100644 --- a/clients/client-frauddetector/runtimeConfig.ts +++ b/clients/client-frauddetector/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./FraudDetectorClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-frauddetector/tsconfig.json b/clients/client-frauddetector/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-frauddetector/tsconfig.json +++ b/clients/client-frauddetector/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-fsx/commands/AssociateFileSystemAliasesCommand.ts b/clients/client-fsx/commands/AssociateFileSystemAliasesCommand.ts index c95a305ce034b..3c8531f3a96cc 100644 --- a/clients/client-fsx/commands/AssociateFileSystemAliasesCommand.ts +++ b/clients/client-fsx/commands/AssociateFileSystemAliasesCommand.ts @@ -20,6 +20,19 @@ import { export type AssociateFileSystemAliasesCommandInput = AssociateFileSystemAliasesRequest; export type AssociateFileSystemAliasesCommandOutput = AssociateFileSystemAliasesResponse & __MetadataBearer; +/** + *

Use this action to associate one or more Domain Name Server (DNS) aliases with an existing Amazon FSx for Windows File Server file system. + * A file systen can have a maximum of 50 DNS aliases associated with it at any one time. If you try to + * associate a DNS alias that is already associated with the file system, FSx takes no action on that alias in the request. + * For more information, see Working with DNS Aliases and + * Walkthrough 5: Using DNS aliases to access your file system, including + * additional steps you must take to be able to access your file system using a DNS alias.

+ *

The system response shows the DNS aliases that + * Amazon FSx is attempting to associate with the file system. + * Use the API + * operation to monitor the status of the aliases Amazon FSx is + * associating with the file system.

+ */ export class AssociateFileSystemAliasesCommand extends $Command< AssociateFileSystemAliasesCommandInput, AssociateFileSystemAliasesCommandOutput, @@ -34,6 +47,9 @@ export class AssociateFileSystemAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/CancelDataRepositoryTaskCommand.ts b/clients/client-fsx/commands/CancelDataRepositoryTaskCommand.ts index bb3039e3cf80d..67d8c35db836d 100644 --- a/clients/client-fsx/commands/CancelDataRepositoryTaskCommand.ts +++ b/clients/client-fsx/commands/CancelDataRepositoryTaskCommand.ts @@ -20,6 +20,21 @@ import { export type CancelDataRepositoryTaskCommandInput = CancelDataRepositoryTaskRequest; export type CancelDataRepositoryTaskCommandOutput = CancelDataRepositoryTaskResponse & __MetadataBearer; +/** + *

Cancels an existing Amazon FSx for Lustre data repository task if that task is in either the + * PENDING or EXECUTING state. When you cancel a task, Amazon FSx does the following.

+ *
    + *
  • + *

    Any files that FSx has already exported are not reverted.

    + *
  • + *
  • + *

    FSx continues to export any files that are "in-flight" when the cancel operation is received.

    + *
  • + *
  • + *

    FSx does not export any files that have not yet been exported.

    + *
  • + *
+ */ export class CancelDataRepositoryTaskCommand extends $Command< CancelDataRepositoryTaskCommandInput, CancelDataRepositoryTaskCommandOutput, @@ -34,6 +49,9 @@ export class CancelDataRepositoryTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/CreateBackupCommand.ts b/clients/client-fsx/commands/CreateBackupCommand.ts index caf69539a43c8..119af1b0d99bf 100644 --- a/clients/client-fsx/commands/CreateBackupCommand.ts +++ b/clients/client-fsx/commands/CreateBackupCommand.ts @@ -20,6 +20,52 @@ import { export type CreateBackupCommandInput = CreateBackupRequest; export type CreateBackupCommandOutput = CreateBackupResponse & __MetadataBearer; +/** + *

Creates a backup of an existing Amazon FSx file system. + * Creating regular backups for your file system is a best practice, enabling you to restore a file system + * from a backup if an issue arises with the original file system.

+ *

For Amazon FSx for Lustre file systems, you can create a backup only + * for file systems with the following configuration:

+ *
    + *
  • + *

    a Persistent deployment type

    + *
  • + *
  • + *

    is not linked to a data respository.

    + *
  • + *
+ *

For more information about backing up Amazon FSx for Lustre file systems, + * see Working with FSx for Lustre backups.

+ *

For more information about backing up Amazon FSx for Lustre file systems, + * see Working with FSx for Windows backups.

+ * + *

If a backup with the specified client request token exists, and the parameters + * match, this operation returns the description of the existing backup. If a backup + * specified client request token exists, and the parameters don't match, this + * operation returns IncompatibleParameterError. If a backup with the + * specified client request token doesn't exist, CreateBackup does the + * following:

+ *
    + *
  • + *

    Creates a new Amazon FSx backup with an assigned ID, and an initial + * lifecycle state of CREATING.

    + *
  • + *
  • + *

    Returns the description of the backup.

    + *
  • + *
+ * + *

By using the idempotent operation, you can retry a CreateBackup + * operation without the risk of creating an extra backup. This approach can be useful when + * an initial call fails in a way that makes it unclear whether a backup was created. If + * you use the same client request token and the initial call created a backup, the + * operation returns a successful result because all the parameters are the same.

+ * + *

The CreateBackup operation returns while the backup's + * lifecycle state is still CREATING. You can check the backup creation + * status by calling the DescribeBackups operation, which returns the + * backup state along with other information.

+ */ export class CreateBackupCommand extends $Command< CreateBackupCommandInput, CreateBackupCommandOutput, @@ -34,6 +80,9 @@ export class CreateBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/CreateDataRepositoryTaskCommand.ts b/clients/client-fsx/commands/CreateDataRepositoryTaskCommand.ts index fc7072baa7035..1013490a3e776 100644 --- a/clients/client-fsx/commands/CreateDataRepositoryTaskCommand.ts +++ b/clients/client-fsx/commands/CreateDataRepositoryTaskCommand.ts @@ -20,6 +20,17 @@ import { export type CreateDataRepositoryTaskCommandInput = CreateDataRepositoryTaskRequest; export type CreateDataRepositoryTaskCommandOutput = CreateDataRepositoryTaskResponse & __MetadataBearer; +/** + *

Creates an Amazon FSx for Lustre data repository task. You use data repository tasks + * to perform bulk operations between your Amazon FSx file system and its linked data + * repository. An example of a data repository task is + * exporting any data and metadata changes, including POSIX metadata, to files, directories, and symbolic links (symlinks) from your FSx file system to its linked data repository. A + * CreateDataRepositoryTask operation will fail if a data repository is not + * linked to the FSx file system. To learn more about data repository tasks, see + * Using Data Repository Tasks. + * To learn more about linking a data repository to your file system, see + * Setting the Export Prefix.

+ */ export class CreateDataRepositoryTaskCommand extends $Command< CreateDataRepositoryTaskCommandInput, CreateDataRepositoryTaskCommandOutput, @@ -34,6 +45,9 @@ export class CreateDataRepositoryTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/CreateFileSystemCommand.ts b/clients/client-fsx/commands/CreateFileSystemCommand.ts index 5ae86480ff658..04ec671ca6c60 100644 --- a/clients/client-fsx/commands/CreateFileSystemCommand.ts +++ b/clients/client-fsx/commands/CreateFileSystemCommand.ts @@ -20,6 +20,41 @@ import { export type CreateFileSystemCommandInput = CreateFileSystemRequest; export type CreateFileSystemCommandOutput = CreateFileSystemResponse & __MetadataBearer; +/** + *

Creates a new, empty Amazon FSx file system.

+ * + *

If a file system with the specified client request token exists and the parameters + * match, CreateFileSystem returns the description of the existing file + * system. If a file system specified client request token exists and the parameters + * don't match, this call returns IncompatibleParameterError. If a file + * system with the specified client request token doesn't exist, + * CreateFileSystem does the following:

+ *
    + *
  • + *

    Creates a new, empty Amazon FSx file system with an assigned ID, and an + * initial lifecycle state of CREATING.

    + *
  • + *
  • + *

    Returns the description of the file system.

    + *
  • + *
+ * + *

This operation requires a client request token in the request that Amazon FSx uses + * to ensure idempotent creation. This means that calling the operation multiple times with + * the same client request token has no effect. By using the idempotent operation, you can + * retry a CreateFileSystem operation without the risk of creating an extra + * file system. This approach can be useful when an initial call fails in a way that makes + * it unclear whether a file system was created. Examples are if a transport level timeout + * occurred, or your connection was reset. If you use the same client request token and the + * initial call created a file system, the client receives success as long as the + * parameters are the same.

+ * + *

The CreateFileSystem call returns while the file system's + * lifecycle state is still CREATING. You can check the file-system + * creation status by calling the DescribeFileSystems operation, + * which returns the file system state along with other information.

+ *
+ */ export class CreateFileSystemCommand extends $Command< CreateFileSystemCommandInput, CreateFileSystemCommandOutput, @@ -34,6 +69,9 @@ export class CreateFileSystemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/CreateFileSystemFromBackupCommand.ts b/clients/client-fsx/commands/CreateFileSystemFromBackupCommand.ts index dd62191363695..e0433b8f9e11b 100644 --- a/clients/client-fsx/commands/CreateFileSystemFromBackupCommand.ts +++ b/clients/client-fsx/commands/CreateFileSystemFromBackupCommand.ts @@ -20,6 +20,44 @@ import { export type CreateFileSystemFromBackupCommandInput = CreateFileSystemFromBackupRequest; export type CreateFileSystemFromBackupCommandOutput = CreateFileSystemFromBackupResponse & __MetadataBearer; +/** + *

Creates a new Amazon FSx file system from an existing Amazon FSx backup.

+ * + *

If a file system with the specified client request token exists and the parameters + * match, this operation returns the description of the file system. If a client + * request token specified by the file system exists and the parameters don't match, + * this call returns IncompatibleParameterError. If a file system with the + * specified client request token doesn't exist, this operation does the following:

+ * + *
    + *
  • + *

    Creates a new Amazon FSx file system from backup with an assigned ID, and + * an initial lifecycle state of CREATING.

    + *
  • + *
  • + *

    Returns the description of the file system.

    + *
  • + *
+ * + *

Parameters like Active Directory, default share name, automatic backup, and backup + * settings default to the parameters of the file system that was backed up, unless + * overridden. You can explicitly supply other settings.

+ * + *

By using the idempotent operation, you can retry a + * CreateFileSystemFromBackup call without the risk of creating an extra + * file system. This approach can be useful when an initial call fails in a way that makes + * it unclear whether a file system was created. Examples are if a transport level timeout + * occurred, or your connection was reset. If you use the same client request token and the + * initial call created a file system, the client receives success as long as the + * parameters are the same.

+ * + *

The CreateFileSystemFromBackup call returns while the file + * system's lifecycle state is still CREATING. You can check the + * file-system creation status by calling the DescribeFileSystems + * operation, which returns the file system state along with other + * information.

+ *
+ */ export class CreateFileSystemFromBackupCommand extends $Command< CreateFileSystemFromBackupCommandInput, CreateFileSystemFromBackupCommandOutput, @@ -34,6 +72,9 @@ export class CreateFileSystemFromBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/DeleteBackupCommand.ts b/clients/client-fsx/commands/DeleteBackupCommand.ts index 9915c69d5fb80..29bb35838e277 100644 --- a/clients/client-fsx/commands/DeleteBackupCommand.ts +++ b/clients/client-fsx/commands/DeleteBackupCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteBackupCommandInput = DeleteBackupRequest; export type DeleteBackupCommandOutput = DeleteBackupResponse & __MetadataBearer; +/** + *

Deletes an Amazon FSx backup, deleting its contents. After deletion, the backup no longer exists, and its data is gone.

+ * + *

The DeleteBackup call returns instantly. The backup will not show up + * in later DescribeBackups calls.

+ * + * + *

The data in a deleted backup is also deleted and can't be recovered by any + * means.

+ *
+ */ export class DeleteBackupCommand extends $Command< DeleteBackupCommandInput, DeleteBackupCommandOutput, @@ -34,6 +45,9 @@ export class DeleteBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/DeleteFileSystemCommand.ts b/clients/client-fsx/commands/DeleteFileSystemCommand.ts index 6dcd33e5a266a..172418ba8b745 100644 --- a/clients/client-fsx/commands/DeleteFileSystemCommand.ts +++ b/clients/client-fsx/commands/DeleteFileSystemCommand.ts @@ -20,6 +20,31 @@ import { export type DeleteFileSystemCommandInput = DeleteFileSystemRequest; export type DeleteFileSystemCommandOutput = DeleteFileSystemResponse & __MetadataBearer; +/** + *

Deletes a file system, deleting its contents. After deletion, the file system no + * longer exists, and its data is gone. Any existing automatic backups will also be + * deleted.

+ *

By default, when you delete an Amazon FSx for Windows File Server file system, a + * final backup is created upon deletion. This final backup is not subject to the file + * system's retention policy, and must be manually deleted.

+ * + * + *

The DeleteFileSystem action returns while the file system has the + * DELETING status. You can check the file system deletion status by + * calling the DescribeFileSystems action, which returns a list of file + * systems in your account. If you pass the file system ID for a deleted file system, the + * DescribeFileSystems returns a FileSystemNotFound + * error.

+ * + *

Deleting an Amazon FSx for Lustre file system will fail with a 400 BadRequest if + * a data repository task is in a PENDING or EXECUTING + * state.

+ *
+ * + *

The data in a deleted file system is also deleted and can't be recovered by + * any means.

+ *
+ */ export class DeleteFileSystemCommand extends $Command< DeleteFileSystemCommandInput, DeleteFileSystemCommandOutput, @@ -34,6 +59,9 @@ export class DeleteFileSystemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/DescribeBackupsCommand.ts b/clients/client-fsx/commands/DescribeBackupsCommand.ts index c34d267d2b348..c07b1602163ac 100644 --- a/clients/client-fsx/commands/DescribeBackupsCommand.ts +++ b/clients/client-fsx/commands/DescribeBackupsCommand.ts @@ -20,6 +20,39 @@ import { export type DescribeBackupsCommandInput = DescribeBackupsRequest; export type DescribeBackupsCommandOutput = DescribeBackupsResponse & __MetadataBearer; +/** + *

Returns the description of specific Amazon FSx backups, if + * a BackupIds value is provided for that backup. Otherwise, it returns all + * backups owned by your AWS account in the AWS Region of the endpoint that you're + * calling.

+ * + *

When retrieving all backups, you can optionally specify the MaxResults + * parameter to limit the number of backups in a response. If more backups remain, Amazon + * FSx returns a NextToken value in the response. In this case, send a later + * request with the NextToken request parameter set to the value of + * NextToken from the last response.

+ * + *

This action is used in an iterative process to retrieve a list of your backups. + * DescribeBackups is called first without a NextTokenvalue. + * Then the action continues to be called with the NextToken parameter set to + * the value of the last NextToken value until a response has no + * NextToken.

+ * + *

When using this action, keep the following in mind:

+ *
    + *
  • + *

    The implementation might return fewer than MaxResults file + * system descriptions while still including a NextToken + * value.

    + * + *
  • + *
  • + *

    The order of backups returned in the response of one + * DescribeBackups call and the order of backups returned across + * the responses of a multi-call iteration is unspecified.

    + *
  • + *
+ */ export class DescribeBackupsCommand extends $Command< DescribeBackupsCommandInput, DescribeBackupsCommandOutput, @@ -34,6 +67,9 @@ export class DescribeBackupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/DescribeDataRepositoryTasksCommand.ts b/clients/client-fsx/commands/DescribeDataRepositoryTasksCommand.ts index c7c1ca07accc9..61d04ae529422 100644 --- a/clients/client-fsx/commands/DescribeDataRepositoryTasksCommand.ts +++ b/clients/client-fsx/commands/DescribeDataRepositoryTasksCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeDataRepositoryTasksCommandInput = DescribeDataRepositoryTasksRequest; export type DescribeDataRepositoryTasksCommandOutput = DescribeDataRepositoryTasksResponse & __MetadataBearer; +/** + *

Returns the description of specific Amazon FSx for Lustre data repository tasks, if + * one or more TaskIds values are provided in the request, or if filters are used in the request. + * You can use filters to narrow the response to include just tasks for specific file systems, + * or tasks in a specific lifecycle state. Otherwise, it returns all data repository tasks owned + * by your AWS account in the AWS Region of the endpoint that you're calling.

+ * + *

When retrieving all tasks, you can paginate the response by using the optional MaxResults + * parameter to limit the number of tasks returned in a response. If more tasks remain, Amazon + * FSx returns a NextToken value in the response. In this case, send a later + * request with the NextToken request parameter set to the value of + * NextToken from the last response.

+ */ export class DescribeDataRepositoryTasksCommand extends $Command< DescribeDataRepositoryTasksCommandInput, DescribeDataRepositoryTasksCommandOutput, @@ -34,6 +47,9 @@ export class DescribeDataRepositoryTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/DescribeFileSystemAliasesCommand.ts b/clients/client-fsx/commands/DescribeFileSystemAliasesCommand.ts index da3623ba6f245..2177bcce62709 100644 --- a/clients/client-fsx/commands/DescribeFileSystemAliasesCommand.ts +++ b/clients/client-fsx/commands/DescribeFileSystemAliasesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeFileSystemAliasesCommandInput = DescribeFileSystemAliasesRequest; export type DescribeFileSystemAliasesCommandOutput = DescribeFileSystemAliasesResponse & __MetadataBearer; +/** + *

Returns the DNS aliases that are associated with the specified Amazon FSx for Windows File Server file system. A history of + * all DNS aliases that have been associated with and disassociated from the file system is available in the list of AdministrativeAction + * provided in the DescribeFileSystems operation response.

+ */ export class DescribeFileSystemAliasesCommand extends $Command< DescribeFileSystemAliasesCommandInput, DescribeFileSystemAliasesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeFileSystemAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/DescribeFileSystemsCommand.ts b/clients/client-fsx/commands/DescribeFileSystemsCommand.ts index 2dcfc324746a1..d4fd86fdc2037 100644 --- a/clients/client-fsx/commands/DescribeFileSystemsCommand.ts +++ b/clients/client-fsx/commands/DescribeFileSystemsCommand.ts @@ -20,6 +20,40 @@ import { export type DescribeFileSystemsCommandInput = DescribeFileSystemsRequest; export type DescribeFileSystemsCommandOutput = DescribeFileSystemsResponse & __MetadataBearer; +/** + *

Returns the description of specific Amazon FSx file systems, if a + * FileSystemIds value is provided for that file system. Otherwise, it + * returns descriptions of all file systems owned by your AWS account in the AWS Region of + * the endpoint that you're calling.

+ * + *

When retrieving all file system descriptions, you can optionally specify the + * MaxResults parameter to limit the number of descriptions in a response. + * If more file system descriptions remain, Amazon FSx returns a NextToken + * value in the response. In this case, send a later request with the + * NextToken request parameter set to the value of NextToken + * from the last response.

+ * + *

This action is used in an iterative process to retrieve a list of your file system + * descriptions. DescribeFileSystems is called first without a + * NextTokenvalue. Then the action continues to be called with the + * NextToken parameter set to the value of the last NextToken + * value until a response has no NextToken.

+ * + *

When using this action, keep the following in mind:

+ *
    + *
  • + *

    The implementation might return fewer than MaxResults file + * system descriptions while still including a NextToken + * value.

    + * + *
  • + *
  • + *

    The order of file systems returned in the response of one + * DescribeFileSystems call and the order of file systems returned + * across the responses of a multicall iteration is unspecified.

    + *
  • + *
+ */ export class DescribeFileSystemsCommand extends $Command< DescribeFileSystemsCommandInput, DescribeFileSystemsCommandOutput, @@ -34,6 +68,9 @@ export class DescribeFileSystemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/DisassociateFileSystemAliasesCommand.ts b/clients/client-fsx/commands/DisassociateFileSystemAliasesCommand.ts index 9189050f3e5fa..ee3d8c9a92f85 100644 --- a/clients/client-fsx/commands/DisassociateFileSystemAliasesCommand.ts +++ b/clients/client-fsx/commands/DisassociateFileSystemAliasesCommand.ts @@ -20,6 +20,17 @@ import { export type DisassociateFileSystemAliasesCommandInput = DisassociateFileSystemAliasesRequest; export type DisassociateFileSystemAliasesCommandOutput = DisassociateFileSystemAliasesResponse & __MetadataBearer; +/** + *

Use this action to disassociate, or remove, one or more Domain Name Service (DNS) aliases + * from an Amazon FSx for Windows File Server file system. If you attempt to disassociate a DNS alias that is not + * associated with the file system, Amazon FSx responds with a 400 Bad Request. For more information, see + * Working with DNS Aliases.

+ *

The system generated response showing the DNS aliases that + * Amazon FSx is attempting to disassociate from the file system. + * Use the API + * operation to monitor the status of the aliases Amazon FSx is + * disassociating with the file system.

+ */ export class DisassociateFileSystemAliasesCommand extends $Command< DisassociateFileSystemAliasesCommandInput, DisassociateFileSystemAliasesCommandOutput, @@ -34,6 +45,9 @@ export class DisassociateFileSystemAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/ListTagsForResourceCommand.ts b/clients/client-fsx/commands/ListTagsForResourceCommand.ts index c6a48e963a31f..d48be1fa9280d 100644 --- a/clients/client-fsx/commands/ListTagsForResourceCommand.ts +++ b/clients/client-fsx/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,37 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists tags for an Amazon FSx file systems and backups in the case of Amazon FSx for + * Windows File Server.

+ * + *

When retrieving all tags, you can optionally specify the MaxResults + * parameter to limit the number of tags in a response. If more tags remain, Amazon FSx + * returns a NextToken value in the response. In this case, send a later + * request with the NextToken request parameter set to the value of + * NextToken from the last response.

+ * + *

This action is used in an iterative process to retrieve a list of your tags. + * ListTagsForResource is called first without a + * NextTokenvalue. Then the action continues to be called with the + * NextToken parameter set to the value of the last NextToken + * value until a response has no NextToken.

+ * + *

When using this action, keep the following in mind:

+ *
    + *
  • + *

    The implementation might return fewer than MaxResults file + * system descriptions while still including a NextToken + * value.

    + * + *
  • + *
  • + *

    The order of tags returned in the response of one + * ListTagsForResource call and the order of tags returned across + * the responses of a multi-call iteration is unspecified.

    + *
  • + *
+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +65,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/TagResourceCommand.ts b/clients/client-fsx/commands/TagResourceCommand.ts index bff03e2861457..7b3d862c85bec 100644 --- a/clients/client-fsx/commands/TagResourceCommand.ts +++ b/clients/client-fsx/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Tags an Amazon FSx resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/UntagResourceCommand.ts b/clients/client-fsx/commands/UntagResourceCommand.ts index 3281113657476..50a68966f0ffd 100644 --- a/clients/client-fsx/commands/UntagResourceCommand.ts +++ b/clients/client-fsx/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

This action removes a tag from an Amazon FSx resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/commands/UpdateFileSystemCommand.ts b/clients/client-fsx/commands/UpdateFileSystemCommand.ts index 24a79efb86675..e036145650563 100644 --- a/clients/client-fsx/commands/UpdateFileSystemCommand.ts +++ b/clients/client-fsx/commands/UpdateFileSystemCommand.ts @@ -20,6 +20,48 @@ import { export type UpdateFileSystemCommandInput = UpdateFileSystemRequest; export type UpdateFileSystemCommandOutput = UpdateFileSystemResponse & __MetadataBearer; +/** + *

Use this operation to update the configuration of an existing Amazon FSx file system. + * You can update multiple properties in a single request.

+ *

For Amazon FSx for Windows File Server file systems, you can update the following + * properties:

+ *
    + *
  • + *

    AutomaticBackupRetentionDays

    + *
  • + *
  • + *

    DailyAutomaticBackupStartTime

    + *
  • + *
  • + *

    SelfManagedActiveDirectoryConfiguration

    + *
  • + *
  • + *

    StorageCapacity

    + *
  • + *
  • + *

    ThroughputCapacity

    + *
  • + *
  • + *

    WeeklyMaintenanceStartTime

    + *
  • + *
+ *

For Amazon FSx for Lustre file systems, you can update the following + * properties:

+ *
    + *
  • + *

    AutoImportPolicy

    + *
  • + *
  • + *

    AutomaticBackupRetentionDays

    + *
  • + *
  • + *

    DailyAutomaticBackupStartTime

    + *
  • + *
  • + *

    WeeklyMaintenanceStartTime

    + *
  • + *
+ */ export class UpdateFileSystemCommand extends $Command< UpdateFileSystemCommandInput, UpdateFileSystemCommandOutput, @@ -34,6 +76,9 @@ export class UpdateFileSystemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: FSxClientResolvedConfig, diff --git a/clients/client-fsx/package.json b/clients/client-fsx/package.json index d798364f22bd2..a4949b7ea15c8 100644 --- a/clients/client-fsx/package.json +++ b/clients/client-fsx/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Fsx Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-fsx/pagination/DescribeBackupsPaginator.ts b/clients/client-fsx/pagination/DescribeBackupsPaginator.ts index 81f02bf8af79a..c3785412c5e8a 100644 --- a/clients/client-fsx/pagination/DescribeBackupsPaginator.ts +++ b/clients/client-fsx/pagination/DescribeBackupsPaginator.ts @@ -8,6 +8,9 @@ import { import { FSxPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FSxClient, input: DescribeBackupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBackupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FSx, input: DescribeBackupsCommandInput, diff --git a/clients/client-fsx/pagination/DescribeDataRepositoryTasksPaginator.ts b/clients/client-fsx/pagination/DescribeDataRepositoryTasksPaginator.ts index e8ec84d9dcf94..6a44d2a35fb32 100644 --- a/clients/client-fsx/pagination/DescribeDataRepositoryTasksPaginator.ts +++ b/clients/client-fsx/pagination/DescribeDataRepositoryTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { FSxPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FSxClient, input: DescribeDataRepositoryTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDataRepositoryTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FSx, input: DescribeDataRepositoryTasksCommandInput, diff --git a/clients/client-fsx/pagination/DescribeFileSystemAliasesPaginator.ts b/clients/client-fsx/pagination/DescribeFileSystemAliasesPaginator.ts index c5ad9b1896e4b..4528ba84d5d78 100644 --- a/clients/client-fsx/pagination/DescribeFileSystemAliasesPaginator.ts +++ b/clients/client-fsx/pagination/DescribeFileSystemAliasesPaginator.ts @@ -8,6 +8,9 @@ import { import { FSxPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FSxClient, input: DescribeFileSystemAliasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFileSystemAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FSx, input: DescribeFileSystemAliasesCommandInput, diff --git a/clients/client-fsx/pagination/DescribeFileSystemsPaginator.ts b/clients/client-fsx/pagination/DescribeFileSystemsPaginator.ts index 7f1f53c76720c..d9f59223c985a 100644 --- a/clients/client-fsx/pagination/DescribeFileSystemsPaginator.ts +++ b/clients/client-fsx/pagination/DescribeFileSystemsPaginator.ts @@ -8,6 +8,9 @@ import { import { FSxPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: FSxClient, input: DescribeFileSystemsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFileSystemsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: FSx, input: DescribeFileSystemsCommandInput, diff --git a/clients/client-fsx/runtimeConfig.browser.ts b/clients/client-fsx/runtimeConfig.browser.ts index 062ffafc88d2b..3ac2f574e6110 100644 --- a/clients/client-fsx/runtimeConfig.browser.ts +++ b/clients/client-fsx/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./FSxClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-fsx/runtimeConfig.native.ts b/clients/client-fsx/runtimeConfig.native.ts index 01130d8925380..e48c057da2410 100644 --- a/clients/client-fsx/runtimeConfig.native.ts +++ b/clients/client-fsx/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./FSxClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-fsx/runtimeConfig.shared.ts b/clients/client-fsx/runtimeConfig.shared.ts index c0bd8c5aa61f8..7e83153543bff 100644 --- a/clients/client-fsx/runtimeConfig.shared.ts +++ b/clients/client-fsx/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-03-01", disableHostPrefix: false, diff --git a/clients/client-fsx/runtimeConfig.ts b/clients/client-fsx/runtimeConfig.ts index acbda5fb5cd8b..94f668bfffc11 100644 --- a/clients/client-fsx/runtimeConfig.ts +++ b/clients/client-fsx/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./FSxClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-fsx/tsconfig.json b/clients/client-fsx/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-fsx/tsconfig.json +++ b/clients/client-fsx/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-gamelift/commands/AcceptMatchCommand.ts b/clients/client-gamelift/commands/AcceptMatchCommand.ts index 1d6df866d8a7a..6066dc052d609 100644 --- a/clients/client-gamelift/commands/AcceptMatchCommand.ts +++ b/clients/client-gamelift/commands/AcceptMatchCommand.ts @@ -20,6 +20,67 @@ import { export type AcceptMatchCommandInput = AcceptMatchInput; export type AcceptMatchCommandOutput = AcceptMatchOutput & __MetadataBearer; +/** + *

Registers a player's acceptance or rejection of a proposed FlexMatch match. A + * matchmaking configuration may require player acceptance; if so, then matches built with + * that configuration cannot be completed unless all players accept the proposed match + * within a specified time limit.

+ *

When FlexMatch builds a match, all the matchmaking tickets involved in the proposed + * match are placed into status REQUIRES_ACCEPTANCE. This is a trigger for + * your game to get acceptance from all players in the ticket. Acceptances are only valid + * for tickets when they are in this status; all other acceptances result in an + * error.

+ *

To register acceptance, specify the ticket ID, a response, and one or more players. + * Once all players have registered acceptance, the matchmaking tickets advance to status + * PLACING, where a new game session is created for the match.

+ *

If any player rejects the match, or if acceptances are not received before a specified + * timeout, the proposed match is dropped. The matchmaking tickets are then handled in one + * of two ways: For tickets where one or more players rejected the match, the ticket status + * is returned to SEARCHING to find a new match. For tickets where one or more + * players failed to respond, the ticket status is set to CANCELLED, and + * processing is terminated. A new matchmaking request for these players can be submitted + * as needed.

+ *

+ * Learn more + *

+ *

+ * + * Add FlexMatch to a Game Client + *

+ *

+ * FlexMatch Events Reference + *

+ *

+ * Related operations + *

+ * + */ export class AcceptMatchCommand extends $Command< AcceptMatchCommandInput, AcceptMatchCommandOutput, @@ -34,6 +95,9 @@ export class AcceptMatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ClaimGameServerCommand.ts b/clients/client-gamelift/commands/ClaimGameServerCommand.ts index 184465e214174..55ddff6228edf 100644 --- a/clients/client-gamelift/commands/ClaimGameServerCommand.ts +++ b/clients/client-gamelift/commands/ClaimGameServerCommand.ts @@ -20,6 +20,84 @@ import { export type ClaimGameServerCommandInput = ClaimGameServerInput; export type ClaimGameServerCommandOutput = ClaimGameServerOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Locates an available game server and temporarily reserves it to host gameplay and + * players. This operation is called from a game client or client service (such as a + * matchmaker) to request hosting resources for a new game session. In response, GameLift FleetIQ + * locates an available game server, places it in CLAIMED status for 60 + * seconds, and returns connection information that players can use to connect to the game + * server.

+ *

To claim a game server, identify a game server group. You can also specify a game + * server ID, although this approach bypasses GameLift FleetIQ placement optimization. Optionally, + * include game data to pass to the game server at the start of a game session, such as a + * game map or player information.

+ *

When a game server is successfully claimed, connection information is returned. A + * claimed game server's utilization status remains AVAILABLE while the claim + * status is set to CLAIMED for up to 60 seconds. This time period gives the + * game server time to update its status to UTILIZED (using UpdateGameServer) once players join. If the game server's status is not + * updated within 60 seconds, the game server reverts to unclaimed status and is available + * to be claimed by another request. The claim time period is a fixed value and is not + * configurable.

+ *

If you try to claim a specific game server, this request will fail in the following + * cases:

+ *
    + *
  • + *

    If the game server utilization status is UTILIZED.

    + *
  • + *
  • + *

    If the game server claim status is CLAIMED.

    + *
  • + *
+ * + *

When claiming a specific game server, this request will succeed even if the game + * server is running on an instance in DRAINING status. To avoid this, + * first check the instance status by calling DescribeGameServerInstances.

+ *
+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class ClaimGameServerCommand extends $Command< ClaimGameServerCommandInput, ClaimGameServerCommandOutput, @@ -34,6 +112,9 @@ export class ClaimGameServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateAliasCommand.ts b/clients/client-gamelift/commands/CreateAliasCommand.ts index 5a92ffed3d31a..68b0b433d98e7 100644 --- a/clients/client-gamelift/commands/CreateAliasCommand.ts +++ b/clients/client-gamelift/commands/CreateAliasCommand.ts @@ -20,6 +20,54 @@ import { export type CreateAliasCommandInput = CreateAliasInput; export type CreateAliasCommandOutput = CreateAliasOutput & __MetadataBearer; +/** + *

Creates an alias for a fleet. In most situations, you can use an alias ID in place of + * a fleet ID. An alias provides a level of abstraction for a fleet that is useful when + * redirecting player traffic from one fleet to another, such as when updating your game + * build.

+ *

Amazon GameLift supports two types of routing strategies for aliases: simple and terminal. A + * simple alias points to an active fleet. A terminal alias is used to display messaging or + * link to a URL instead of routing players to an active fleet. For example, you might use + * a terminal alias when a game version is no longer supported and you want to direct + * players to an upgrade site.

+ *

To create a fleet alias, specify an alias name, routing strategy, and optional + * description. Each simple alias can point to only one fleet, but a fleet can have + * multiple aliases. If successful, a new alias record is returned, including an alias ID + * and an ARN. You can reassign an alias to another fleet by calling + * UpdateAlias.

+ * + */ export class CreateAliasCommand extends $Command< CreateAliasCommandInput, CreateAliasCommandOutput, @@ -34,6 +82,9 @@ export class CreateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateBuildCommand.ts b/clients/client-gamelift/commands/CreateBuildCommand.ts index 062d7a0724c6e..8190d499f9af2 100644 --- a/clients/client-gamelift/commands/CreateBuildCommand.ts +++ b/clients/client-gamelift/commands/CreateBuildCommand.ts @@ -20,6 +20,81 @@ import { export type CreateBuildCommandInput = CreateBuildInput; export type CreateBuildCommandOutput = CreateBuildOutput & __MetadataBearer; +/** + *

Creates a new Amazon GameLift build resource for your game server binary files. Game server + * binaries must be combined into a zip file for use with Amazon GameLift.

+ * + *

When setting up a new game build for GameLift, we recommend using the AWS CLI + * command + * upload-build + * . This helper command combines two tasks: (1) it + * uploads your build files from a file directory to a GameLift Amazon S3 location, and (2) + * it creates a new build resource.

+ *
+ *

The CreateBuild operation can used in the following scenarios:

+ *
    + *
  • + *

    To create a new game build with build files that are in an S3 location under + * an AWS account that you control. To use this option, you must first give Amazon GameLift + * access to the S3 bucket. With permissions in place, call + * CreateBuild and specify a build name, operating system, and the + * S3 storage location of your game build.

    + *
  • + *
  • + *

    To directly upload your build files to a GameLift S3 location. To use this + * option, first call CreateBuild and specify a build name and + * operating system. This operation creates a new build resource and also returns an + * S3 location with temporary access credentials. Use the credentials to manually + * upload your build files to the specified S3 location. For more information, + * see Uploading Objects in the Amazon S3 Developer + * Guide. Build files can be uploaded to the GameLift S3 location + * once only; that can't be updated.

    + *
  • + *
+ *

If successful, this operation creates a new build resource with a unique build ID and + * places it in INITIALIZED status. A build must be in READY + * status before you can create fleets with it.

+ *

+ * Learn more + *

+ *

+ * Uploading Your + * Game + *

+ *

+ * Create a Build with Files in Amazon S3 + *

+ *

+ * Related operations + *

+ * + */ export class CreateBuildCommand extends $Command< CreateBuildCommandInput, CreateBuildCommandOutput, @@ -34,6 +109,9 @@ export class CreateBuildCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateFleetCommand.ts b/clients/client-gamelift/commands/CreateFleetCommand.ts index 5a57a129349f1..bb71352bf4100 100644 --- a/clients/client-gamelift/commands/CreateFleetCommand.ts +++ b/clients/client-gamelift/commands/CreateFleetCommand.ts @@ -20,6 +20,92 @@ import { export type CreateFleetCommandInput = CreateFleetInput; export type CreateFleetCommandOutput = CreateFleetOutput & __MetadataBearer; +/** + *

Creates a new fleet to run your game servers. whether they are custom game builds or + * Realtime Servers with game-specific script. A fleet is a set of Amazon Elastic Compute Cloud + * (Amazon EC2) instances, each of which can host multiple game sessions. When creating a + * fleet, you choose the hardware specifications, set some configuration options, and + * specify the game server to deploy on the new fleet.

+ *

To create a new fleet, provide the following: (1) a fleet name, (2) an EC2 instance + * type and fleet type (spot or on-demand), (3) the build ID for your game build or script + * ID if using Realtime Servers, and (4) a runtime configuration, which determines how game servers + * will run on each instance in the fleet.

+ * + *

If the CreateFleet call is successful, Amazon GameLift performs the following + * tasks. You can track the process of a fleet by checking the fleet status or by + * monitoring fleet creation events:

+ *
    + *
  • + *

    Creates a fleet resource. Status: NEW.

    + *
  • + *
  • + *

    Begins writing events to the fleet event log, which can be accessed in the + * Amazon GameLift console.

    + *
  • + *
  • + *

    Sets the fleet's target capacity to 1 (desired instances), which triggers + * Amazon GameLift to start one new EC2 instance.

    + *
  • + *
  • + *

    Downloads the game build or Realtime script to the new instance and installs it. + * Statuses: DOWNLOADING, VALIDATING, + * BUILDING.

    + *
  • + *
  • + *

    Starts launching server processes on the instance. If the fleet is configured + * to run multiple server processes per instance, Amazon GameLift staggers each process + * launch by a few seconds. Status: ACTIVATING.

    + *
  • + *
  • + *

    Sets the fleet's status to ACTIVE as soon as one server + * process is ready to host a game session.

    + *
  • + *
+ *

+ * Learn more + *

+ *

+ * Setting Up Fleets + *

+ *

+ * Debug Fleet Creation Issues + *

+ *

+ * Related operations + *

+ * + */ export class CreateFleetCommand extends $Command< CreateFleetCommandInput, CreateFleetCommandOutput, @@ -34,6 +120,9 @@ export class CreateFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateGameServerGroupCommand.ts b/clients/client-gamelift/commands/CreateGameServerGroupCommand.ts index bbacb1034e420..9eb1294866c60 100644 --- a/clients/client-gamelift/commands/CreateGameServerGroupCommand.ts +++ b/clients/client-gamelift/commands/CreateGameServerGroupCommand.ts @@ -20,6 +20,93 @@ import { export type CreateGameServerGroupCommandInput = CreateGameServerGroupInput; export type CreateGameServerGroupCommandOutput = CreateGameServerGroupOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Creates a GameLift FleetIQ game server group for managing game hosting on a collection of + * Amazon EC2 instances for game hosting. This operation creates the game server group, + * creates an Auto Scaling group in your AWS account, and establishes a link between the + * two groups. You can view the status of your game server groups in the GameLift console. + * Game server group metrics and events are emitted to Amazon CloudWatch.

+ *

Before creating a new game server group, you must have the following:

+ *
    + *
  • + *

    An Amazon EC2 launch template that specifies how to launch Amazon EC2 instances + * with your game server build. For more information, see Launching an Instance from a Launch Template in the + * Amazon EC2 User Guide.

    + *
  • + *
  • + *

    An IAM role that extends limited access to your AWS account to allow GameLift FleetIQ to create and + * interact with the Auto Scaling group. For more information, see Create IAM roles for cross-service interaction in the GameLift FleetIQ Developer + * Guide.

    + *
  • + *
+ *

To create a new game server group, specify a unique group name, IAM role and Amazon EC2 + * launch template, and provide a list of instance types that can be used in the group. You + * must also set initial maximum and minimum limits on the group's instance count. You can + * optionally set an Auto Scaling policy with target tracking based on a GameLift FleetIQ + * metric.

+ *

Once the game server group and corresponding Auto Scaling group are created, you have + * full access to change the Auto Scaling group's configuration as needed. Several + * properties that are set when creating a game server group, including maximum/minimum + * size and auto-scaling policy settings, must be updated directly in the Auto Scaling + * group. Keep in mind that some Auto Scaling group properties are periodically updated by + * GameLift FleetIQ as part of its balancing activities to optimize for availability and + * cost.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ * + *

+ * Related operations + *

+ * + */ export class CreateGameServerGroupCommand extends $Command< CreateGameServerGroupCommandInput, CreateGameServerGroupCommandOutput, @@ -34,6 +121,9 @@ export class CreateGameServerGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateGameSessionCommand.ts b/clients/client-gamelift/commands/CreateGameSessionCommand.ts index f9291a4f0525f..2d0f7074da034 100644 --- a/clients/client-gamelift/commands/CreateGameSessionCommand.ts +++ b/clients/client-gamelift/commands/CreateGameSessionCommand.ts @@ -20,6 +20,89 @@ import { export type CreateGameSessionCommandInput = CreateGameSessionInput; export type CreateGameSessionCommandOutput = CreateGameSessionOutput & __MetadataBearer; +/** + *

Creates a multiplayer game session for players. This operation creates a game session + * record and assigns an available server process in the specified fleet to host the game + * session. A fleet must have an ACTIVE status before a game session can be + * created in it.

+ *

To create a game session, specify either fleet ID or alias ID and indicate a + * maximum number of players to allow in the game session. You can also provide a name and + * game-specific properties for this game session. If successful, a GameSession object is returned containing the game session properties + * and other settings you specified.

+ *

+ * Idempotency tokens. You can add a token that + * uniquely identifies game session requests. This is useful for ensuring that game session + * requests are idempotent. Multiple requests with the same idempotency token are processed + * only once; subsequent requests return the original result. All response values are the + * same with the exception of game session status, which may change.

+ *

+ * Resource creation limits. If you are creating a + * game session on a fleet with a resource creation limit policy in force, then you must + * specify a creator ID. Without this ID, Amazon GameLift has no way to evaluate the policy for this + * new game session request.

+ *

+ * Player acceptance policy. By default, newly created + * game sessions are open to new players. You can restrict new player access by using UpdateGameSession to change the game session's player session creation + * policy.

+ *

+ * Game session logs. Logs are retained for all + * active game sessions for 14 days. To access the logs, call GetGameSessionLogUrl to download the log files.

+ *

+ * Available in Amazon GameLift Local. + *

+ * + */ export class CreateGameSessionCommand extends $Command< CreateGameSessionCommandInput, CreateGameSessionCommandOutput, @@ -34,6 +117,9 @@ export class CreateGameSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateGameSessionQueueCommand.ts b/clients/client-gamelift/commands/CreateGameSessionQueueCommand.ts index 0610f26ad2a8f..f86eeb2e2854d 100644 --- a/clients/client-gamelift/commands/CreateGameSessionQueueCommand.ts +++ b/clients/client-gamelift/commands/CreateGameSessionQueueCommand.ts @@ -20,6 +20,72 @@ import { export type CreateGameSessionQueueCommandInput = CreateGameSessionQueueInput; export type CreateGameSessionQueueCommandOutput = CreateGameSessionQueueOutput & __MetadataBearer; +/** + *

Establishes a new queue for processing requests to place new game sessions. A queue + * identifies where new game sessions can be hosted -- by specifying a list of destinations + * (fleets or aliases) -- and how long requests can wait in the queue before timing out. + * You can set up a queue to try to place game sessions on fleets in multiple Regions. To + * add placement requests to a queue, call StartGameSessionPlacement and + * reference the queue name.

+ *

+ * Destination order. When processing a request for a + * game session, Amazon GameLift tries each destination in order until it finds one with available + * resources to host the new game session. A queue's default order is determined by how + * destinations are listed. The default order is overridden when a game session placement + * request provides player latency information. Player latency information enables Amazon GameLift + * to prioritize destinations where players report the lowest average latency, as a result + * placing the new game session where the majority of players will have the best possible + * gameplay experience.

+ *

+ * Player latency policies. For placement requests + * containing player latency information, use player latency policies to protect individual + * players from very high latencies. With a latency cap, even when a destination can + * deliver a low latency for most players, the game is not placed where any individual + * player is reporting latency higher than a policy's maximum. A queue can have multiple + * latency policies, which are enforced consecutively starting with the policy with the + * lowest latency cap. Use multiple policies to gradually relax latency controls; for + * example, you might set a policy with a low latency cap for the first 60 seconds, a + * second policy with a higher cap for the next 60 seconds, etc.

+ *

To create a new queue, provide a name, timeout value, a list of destinations and, + * if desired, a set of latency policies. If successful, a new queue object is + * returned.

+ *

+ * Learn more + *

+ *

+ * + * Design a Game Session Queue + *

+ *

+ * + * Create a Game Session Queue + *

+ *

+ * Related operations + *

+ * + */ export class CreateGameSessionQueueCommand extends $Command< CreateGameSessionQueueCommandInput, CreateGameSessionQueueCommandOutput, @@ -34,6 +100,9 @@ export class CreateGameSessionQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateMatchmakingConfigurationCommand.ts b/clients/client-gamelift/commands/CreateMatchmakingConfigurationCommand.ts index e8c86c016a851..e3f9c4f50e4d4 100644 --- a/clients/client-gamelift/commands/CreateMatchmakingConfigurationCommand.ts +++ b/clients/client-gamelift/commands/CreateMatchmakingConfigurationCommand.ts @@ -20,6 +20,77 @@ import { export type CreateMatchmakingConfigurationCommandInput = CreateMatchmakingConfigurationInput; export type CreateMatchmakingConfigurationCommandOutput = CreateMatchmakingConfigurationOutput & __MetadataBearer; +/** + *

Defines a new matchmaking configuration for use with FlexMatch. A matchmaking + * configuration sets out guidelines for matching players and getting the matches into + * games. You can set up multiple matchmaking configurations to handle the scenarios needed + * for your game. Each matchmaking ticket (StartMatchmaking or StartMatchBackfill) specifies a configuration for the match and provides + * player attributes to support the configuration being used.

+ *

To create a matchmaking configuration, at a minimum you must specify the following: + * configuration name; a rule set that governs how to evaluate players and find acceptable + * matches; a game session queue to use when placing a new game session for the match; and + * the maximum time allowed for a matchmaking attempt.

+ *

To track the progress of matchmaking tickets, set up an Amazon Simple Notification Service (SNS) to receive + * notifications, and provide the topic ARN in the matchmaking configuration. An + * alternative method, continuously poling ticket status with DescribeMatchmaking, should only be used for games in development with + * low matchmaking usage.

+ *

+ * Learn more + *

+ *

+ * + * Design a FlexMatch Matchmaker + *

+ *

+ * + * Set Up FlexMatch Event Notification + *

+ *

+ * Related operations + *

+ * + */ export class CreateMatchmakingConfigurationCommand extends $Command< CreateMatchmakingConfigurationCommandInput, CreateMatchmakingConfigurationCommandOutput, @@ -34,6 +105,9 @@ export class CreateMatchmakingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateMatchmakingRuleSetCommand.ts b/clients/client-gamelift/commands/CreateMatchmakingRuleSetCommand.ts index a9ed56e601550..8e840c0b2de54 100644 --- a/clients/client-gamelift/commands/CreateMatchmakingRuleSetCommand.ts +++ b/clients/client-gamelift/commands/CreateMatchmakingRuleSetCommand.ts @@ -20,6 +20,86 @@ import { export type CreateMatchmakingRuleSetCommandInput = CreateMatchmakingRuleSetInput; export type CreateMatchmakingRuleSetCommandOutput = CreateMatchmakingRuleSetOutput & __MetadataBearer; +/** + *

Creates a new rule set for FlexMatch matchmaking. A rule set describes the type of match + * to create, such as the number and size of teams. It also sets the parameters for + * acceptable player matches, such as minimum skill level or character type. A rule set is + * used by a MatchmakingConfiguration.

+ *

To create a matchmaking rule set, provide unique rule set name and the rule set body + * in JSON format. Rule sets must be defined in the same Region as the matchmaking + * configuration they are used with.

+ *

Since matchmaking rule sets cannot be edited, it is a good idea to check the rule + * set syntax using ValidateMatchmakingRuleSet before creating a new rule + * set.

+ *

+ * Learn more + *

+ * + *

+ * Related operations + *

+ * + */ export class CreateMatchmakingRuleSetCommand extends $Command< CreateMatchmakingRuleSetCommandInput, CreateMatchmakingRuleSetCommandOutput, @@ -34,6 +114,9 @@ export class CreateMatchmakingRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreatePlayerSessionCommand.ts b/clients/client-gamelift/commands/CreatePlayerSessionCommand.ts index 22faf622dcd08..1e6a3dc0be02e 100644 --- a/clients/client-gamelift/commands/CreatePlayerSessionCommand.ts +++ b/clients/client-gamelift/commands/CreatePlayerSessionCommand.ts @@ -20,6 +20,58 @@ import { export type CreatePlayerSessionCommandInput = CreatePlayerSessionInput; export type CreatePlayerSessionCommandOutput = CreatePlayerSessionOutput & __MetadataBearer; +/** + *

Reserves an open player slot in an active game session. Before a + * player can be added, a game session must have an ACTIVE status, have a + * creation policy of ALLOW_ALL, and have an open player slot. To add a group + * of players to a game session, use CreatePlayerSessions. When the player + * connects to the game server and references a player session ID, the game server contacts the + * Amazon GameLift service to validate the player reservation and accept the player.

+ *

To create a player session, specify a game session ID, player ID, and optionally a + * string of player data. If successful, a slot is reserved in the game session for the player + * and a new PlayerSession object is returned. Player sessions cannot be + * updated.

+ *

+ * Available in Amazon GameLift Local. + *

+ * + */ export class CreatePlayerSessionCommand extends $Command< CreatePlayerSessionCommandInput, CreatePlayerSessionCommandOutput, @@ -34,6 +86,9 @@ export class CreatePlayerSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreatePlayerSessionsCommand.ts b/clients/client-gamelift/commands/CreatePlayerSessionsCommand.ts index 8780e252d4795..af24bffd3c774 100644 --- a/clients/client-gamelift/commands/CreatePlayerSessionsCommand.ts +++ b/clients/client-gamelift/commands/CreatePlayerSessionsCommand.ts @@ -20,6 +20,58 @@ import { export type CreatePlayerSessionsCommandInput = CreatePlayerSessionsInput; export type CreatePlayerSessionsCommandOutput = CreatePlayerSessionsOutput & __MetadataBearer; +/** + *

Reserves open slots in a game session for a group of players. + * Before players can be added, a game session must have an + * ACTIVE status, have a creation policy of ALLOW_ALL, and + * have an open player slot. To add a single player to a game session, use CreatePlayerSession. When a player connects to the game server and + * references a player session ID, the game server contacts the + * Amazon GameLift service to validate the player reservation and accept the player.

+ *

To create player sessions, specify a game session ID, a list of player IDs, and + * optionally a set of player data strings. If successful, a slot is reserved in the game + * session for each player and a set of new PlayerSession objects is returned. + * Player sessions cannot be updated.

+ *

+ * Available in Amazon GameLift Local. + *

+ * + */ export class CreatePlayerSessionsCommand extends $Command< CreatePlayerSessionsCommandInput, CreatePlayerSessionsCommandOutput, @@ -34,6 +86,9 @@ export class CreatePlayerSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateScriptCommand.ts b/clients/client-gamelift/commands/CreateScriptCommand.ts index a5e27454ef2f2..ac2a3671c07c9 100644 --- a/clients/client-gamelift/commands/CreateScriptCommand.ts +++ b/clients/client-gamelift/commands/CreateScriptCommand.ts @@ -20,6 +20,71 @@ import { export type CreateScriptCommandInput = CreateScriptInput; export type CreateScriptCommandOutput = CreateScriptOutput & __MetadataBearer; +/** + *

Creates a new script record for your Realtime Servers script. Realtime scripts are JavaScript that + * provide configuration settings and optional custom game logic for your game. The script + * is deployed when you create a Realtime Servers fleet to host your game sessions. Script logic is + * executed during an active game session.

+ *

To create a new script record, specify a script name and provide the script file(s). + * The script files and all dependencies must be zipped into a single file. You can pull + * the zip file from either of these locations:

+ *
    + *
  • + *

    A locally available directory. Use the ZipFile parameter for this + * option.

    + *
  • + *
  • + *

    An Amazon Simple Storage Service (Amazon S3) bucket under your AWS account. Use the + * StorageLocation parameter for this option. You'll need + * to have an Identity Access Management (IAM) role that allows the Amazon GameLift + * service to access your S3 bucket.

    + *
  • + *
+ *

If the call is successful, a new script record is created with a unique script ID. If the + * script file is provided as a local file, the file is uploaded to an Amazon GameLift-owned S3 bucket + * and the script record's storage location reflects this location. If the script file is provided + * as an S3 bucket, Amazon GameLift accesses the file at this storage location as needed for deployment.

+ *

+ * Learn more + *

+ * + *

+ * Amazon GameLift Realtime Servers + *

+ *

+ * Set Up a Role for Amazon GameLift Access + *

+ *

+ * Related operations + *

+ * + */ export class CreateScriptCommand extends $Command< CreateScriptCommandInput, CreateScriptCommandOutput, @@ -34,6 +99,9 @@ export class CreateScriptCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateVpcPeeringAuthorizationCommand.ts b/clients/client-gamelift/commands/CreateVpcPeeringAuthorizationCommand.ts index be2fca06fcf5e..7eb06f22754a9 100644 --- a/clients/client-gamelift/commands/CreateVpcPeeringAuthorizationCommand.ts +++ b/clients/client-gamelift/commands/CreateVpcPeeringAuthorizationCommand.ts @@ -20,6 +20,62 @@ import { export type CreateVpcPeeringAuthorizationCommandInput = CreateVpcPeeringAuthorizationInput; export type CreateVpcPeeringAuthorizationCommandOutput = CreateVpcPeeringAuthorizationOutput & __MetadataBearer; +/** + *

Requests authorization to create or delete a peer connection between the VPC for + * your Amazon GameLift fleet and a virtual private cloud (VPC) in your AWS account. VPC peering enables the game + * servers on your fleet to communicate directly with other AWS resources. Once you've + * received authorization, call CreateVpcPeeringConnection to establish + * the peering connection. For more information, see VPC Peering with Amazon GameLift + * Fleets.

+ *

You can peer with VPCs that are owned by any AWS account you have access to, + * including the account that you use to manage your Amazon GameLift fleets. You cannot peer with + * VPCs that are in different Regions.

+ *

To request authorization to create a connection, call this operation from the AWS + * account with the VPC that you want to peer to your Amazon GameLift fleet. For example, to + * enable your game servers to retrieve data from a DynamoDB table, use the account that + * manages that DynamoDB resource. Identify the following values: (1) The ID of the VPC + * that you want to peer with, and (2) the ID of the AWS account that you use to manage + * Amazon GameLift. If successful, VPC peering is authorized for the specified VPC.

+ *

To request authorization to delete a connection, call this operation from the AWS + * account with the VPC that is peered with your Amazon GameLift fleet. Identify the following + * values: (1) VPC ID that you want to delete the peering connection for, and (2) ID of the + * AWS account that you use to manage Amazon GameLift.

+ *

The authorization remains valid for 24 hours unless it is canceled by a call to + * DeleteVpcPeeringAuthorization. You must create or delete the + * peering connection while the authorization is valid.

+ * + */ export class CreateVpcPeeringAuthorizationCommand extends $Command< CreateVpcPeeringAuthorizationCommandInput, CreateVpcPeeringAuthorizationCommandOutput, @@ -34,6 +90,9 @@ export class CreateVpcPeeringAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/CreateVpcPeeringConnectionCommand.ts b/clients/client-gamelift/commands/CreateVpcPeeringConnectionCommand.ts index 9da50b491ce87..bbb0f175c2fe1 100644 --- a/clients/client-gamelift/commands/CreateVpcPeeringConnectionCommand.ts +++ b/clients/client-gamelift/commands/CreateVpcPeeringConnectionCommand.ts @@ -20,6 +20,59 @@ import { export type CreateVpcPeeringConnectionCommandInput = CreateVpcPeeringConnectionInput; export type CreateVpcPeeringConnectionCommandOutput = CreateVpcPeeringConnectionOutput & __MetadataBearer; +/** + *

Establishes a VPC peering connection between a virtual private cloud (VPC) in an AWS account with the VPC + * for your Amazon GameLift fleet. VPC peering enables the game servers on your fleet to + * communicate directly with other AWS resources. You can peer with VPCs in any AWS account + * that you have access to, including the account that you use to manage your Amazon GameLift + * fleets. You cannot peer with VPCs that are in different Regions. For more information, + * see VPC Peering with Amazon GameLift Fleets.

+ *

Before calling this operation to establish the peering connection, you first need + * to call CreateVpcPeeringAuthorization and identify the VPC you want to + * peer with. Once the authorization for the specified VPC is issued, you have 24 hours to + * establish the connection. These two operations handle all tasks necessary to peer the + * two VPCs, including acceptance, updating routing tables, etc.

+ *

To establish the connection, call this operation from the AWS account that is used + * to manage the Amazon GameLift fleets. Identify the following values: (1) The ID of the fleet + * you want to be enable a VPC peering connection for; (2) The AWS account with the VPC + * that you want to peer with; and (3) The ID of the VPC you want to peer with. This + * operation is asynchronous. If successful, a VpcPeeringConnection + * request is created. You can use continuous polling to track the request's status using + * DescribeVpcPeeringConnections, or by monitoring fleet events for + * success or failure using DescribeFleetEvents.

+ * + */ export class CreateVpcPeeringConnectionCommand extends $Command< CreateVpcPeeringConnectionCommandInput, CreateVpcPeeringConnectionCommandOutput, @@ -34,6 +87,9 @@ export class CreateVpcPeeringConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteAliasCommand.ts b/clients/client-gamelift/commands/DeleteAliasCommand.ts index 19c53264f163f..5cb720a54ba14 100644 --- a/clients/client-gamelift/commands/DeleteAliasCommand.ts +++ b/clients/client-gamelift/commands/DeleteAliasCommand.ts @@ -20,6 +20,43 @@ import { export type DeleteAliasCommandInput = DeleteAliasInput; export type DeleteAliasCommandOutput = __MetadataBearer; +/** + *

Deletes an alias. This operation removes all record of the alias. Game clients + * attempting to access a server process using the deleted alias receive an error. To + * delete an alias, specify the alias ID to be deleted.

+ * + */ export class DeleteAliasCommand extends $Command< DeleteAliasCommandInput, DeleteAliasCommandOutput, @@ -34,6 +71,9 @@ export class DeleteAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteBuildCommand.ts b/clients/client-gamelift/commands/DeleteBuildCommand.ts index a3a5eadcdb8f9..f460afb1f1367 100644 --- a/clients/client-gamelift/commands/DeleteBuildCommand.ts +++ b/clients/client-gamelift/commands/DeleteBuildCommand.ts @@ -20,6 +20,49 @@ import { export type DeleteBuildCommandInput = DeleteBuildInput; export type DeleteBuildCommandOutput = __MetadataBearer; +/** + *

Deletes a build. This operation permanently deletes the build resource and any uploaded + * build files. Deleting a build does not affect the status of any active fleets using the + * build, but you can no longer create new fleets with the deleted build.

+ *

To delete a build, specify the build ID.

+ *

+ * Learn more + *

+ *

+ * + * Upload a Custom Server Build + *

+ *

+ * Related operations + *

+ * + */ export class DeleteBuildCommand extends $Command< DeleteBuildCommandInput, DeleteBuildCommandOutput, @@ -34,6 +77,9 @@ export class DeleteBuildCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteFleetCommand.ts b/clients/client-gamelift/commands/DeleteFleetCommand.ts index 49e1d783f3a17..5164e50e0636e 100644 --- a/clients/client-gamelift/commands/DeleteFleetCommand.ts +++ b/clients/client-gamelift/commands/DeleteFleetCommand.ts @@ -20,6 +20,57 @@ import { export type DeleteFleetCommandInput = DeleteFleetInput; export type DeleteFleetCommandOutput = __MetadataBearer; +/** + *

Deletes everything related to a fleet. Before deleting a fleet, you must set the + * fleet's desired capacity to zero. See UpdateFleetCapacity.

+ *

If the fleet being deleted has a VPC peering connection, you first need to get a + * valid authorization (good for 24 hours) by calling CreateVpcPeeringAuthorization. + * You do not need to explicitly delete the VPC peering connection--this is done as part of the + * delete fleet process.

+ *

This operation removes the fleet and its resources. Once a fleet is deleted, you can no + * longer use any of the resource in that fleet.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class DeleteFleetCommand extends $Command< DeleteFleetCommandInput, DeleteFleetCommandOutput, @@ -34,6 +85,9 @@ export class DeleteFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteGameServerGroupCommand.ts b/clients/client-gamelift/commands/DeleteGameServerGroupCommand.ts index 90d36f08122cb..5dbc2ae56d5be 100644 --- a/clients/client-gamelift/commands/DeleteGameServerGroupCommand.ts +++ b/clients/client-gamelift/commands/DeleteGameServerGroupCommand.ts @@ -20,6 +20,87 @@ import { export type DeleteGameServerGroupCommandInput = DeleteGameServerGroupInput; export type DeleteGameServerGroupCommandOutput = DeleteGameServerGroupOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Terminates a game server group and permanently deletes the game server group record. + * You have several options for how these resources are impacted when deleting the game + * server group. Depending on the type of delete operation selected, this operation might + * affect these resources:

+ *
    + *
  • + *

    The game server group

    + *
  • + *
  • + *

    The corresponding Auto Scaling group

    + *
  • + *
  • + *

    All game servers that are currently running in the group

    + *
  • + *
+ *

To delete a game server group, identify the game server group to delete and specify + * the type of delete operation to initiate. Game server groups can only be deleted if they + * are in ACTIVE or ERROR status.

+ *

If the delete request is successful, a series of operations are kicked off. The game + * server group status is changed to DELETE_SCHEDULED, which prevents new game + * servers from being registered and stops automatic scaling activity. Once all game + * servers in the game server group are deregistered, GameLift FleetIQ can begin deleting resources. + * If any of the delete operations fail, the game server group is placed in + * ERROR status.

+ *

GameLift FleetIQ emits delete events to Amazon CloudWatch.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class DeleteGameServerGroupCommand extends $Command< DeleteGameServerGroupCommandInput, DeleteGameServerGroupCommandOutput, @@ -34,6 +115,9 @@ export class DeleteGameServerGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteGameSessionQueueCommand.ts b/clients/client-gamelift/commands/DeleteGameSessionQueueCommand.ts index 8e9ba32d179f0..514fb165cdc62 100644 --- a/clients/client-gamelift/commands/DeleteGameSessionQueueCommand.ts +++ b/clients/client-gamelift/commands/DeleteGameSessionQueueCommand.ts @@ -20,6 +20,42 @@ import { export type DeleteGameSessionQueueCommandInput = DeleteGameSessionQueueInput; export type DeleteGameSessionQueueCommandOutput = DeleteGameSessionQueueOutput & __MetadataBearer; +/** + *

Deletes a game session queue. Once a queue is successfully deleted, unfulfilled StartGameSessionPlacement requests that reference the queue will fail. + * To delete a queue, specify the queue name.

+ *

+ * Learn more + *

+ *

+ * + * Using Multi-Region Queues + *

+ *

+ * Related operations + *

+ * + */ export class DeleteGameSessionQueueCommand extends $Command< DeleteGameSessionQueueCommandInput, DeleteGameSessionQueueCommandOutput, @@ -34,6 +70,9 @@ export class DeleteGameSessionQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteMatchmakingConfigurationCommand.ts b/clients/client-gamelift/commands/DeleteMatchmakingConfigurationCommand.ts index 8c89c1aebd9c1..0893a1974e2da 100644 --- a/clients/client-gamelift/commands/DeleteMatchmakingConfigurationCommand.ts +++ b/clients/client-gamelift/commands/DeleteMatchmakingConfigurationCommand.ts @@ -20,6 +20,56 @@ import { export type DeleteMatchmakingConfigurationCommandInput = DeleteMatchmakingConfigurationInput; export type DeleteMatchmakingConfigurationCommandOutput = DeleteMatchmakingConfigurationOutput & __MetadataBearer; +/** + *

Permanently removes a FlexMatch matchmaking configuration. To delete, specify the + * configuration name. A matchmaking configuration cannot be deleted if it is being used in + * any active matchmaking tickets.

+ *

+ * Related operations + *

+ * + */ export class DeleteMatchmakingConfigurationCommand extends $Command< DeleteMatchmakingConfigurationCommandInput, DeleteMatchmakingConfigurationCommandOutput, @@ -34,6 +84,9 @@ export class DeleteMatchmakingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteMatchmakingRuleSetCommand.ts b/clients/client-gamelift/commands/DeleteMatchmakingRuleSetCommand.ts index be8a97c9eece4..2d95e0eb9965e 100644 --- a/clients/client-gamelift/commands/DeleteMatchmakingRuleSetCommand.ts +++ b/clients/client-gamelift/commands/DeleteMatchmakingRuleSetCommand.ts @@ -20,6 +20,67 @@ import { export type DeleteMatchmakingRuleSetCommandInput = DeleteMatchmakingRuleSetInput; export type DeleteMatchmakingRuleSetCommandOutput = DeleteMatchmakingRuleSetOutput & __MetadataBearer; +/** + *

Deletes an existing matchmaking rule set. To delete the rule set, provide the rule + * set name. Rule sets cannot be deleted if they are currently being used by a matchmaking + * configuration.

+ *

+ * Learn more + *

+ * + *

+ * Related operations + *

+ * + */ export class DeleteMatchmakingRuleSetCommand extends $Command< DeleteMatchmakingRuleSetCommandInput, DeleteMatchmakingRuleSetCommandOutput, @@ -34,6 +95,9 @@ export class DeleteMatchmakingRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteScalingPolicyCommand.ts b/clients/client-gamelift/commands/DeleteScalingPolicyCommand.ts index 4874ab2bba730..0da824214635c 100644 --- a/clients/client-gamelift/commands/DeleteScalingPolicyCommand.ts +++ b/clients/client-gamelift/commands/DeleteScalingPolicyCommand.ts @@ -20,6 +20,62 @@ import { export type DeleteScalingPolicyCommandInput = DeleteScalingPolicyInput; export type DeleteScalingPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes a fleet scaling policy. Once deleted, the policy is no longer in + * force and GameLift removes all record of it. To delete a scaling policy, specify both the scaling + * policy name and the fleet ID it is associated with.

+ *

To temporarily suspend scaling policies, call StopFleetActions. + * This operation suspends all policies for the fleet.

+ * + */ export class DeleteScalingPolicyCommand extends $Command< DeleteScalingPolicyCommandInput, DeleteScalingPolicyCommandOutput, @@ -34,6 +90,9 @@ export class DeleteScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteScriptCommand.ts b/clients/client-gamelift/commands/DeleteScriptCommand.ts index 6961521c17489..369755252edb9 100644 --- a/clients/client-gamelift/commands/DeleteScriptCommand.ts +++ b/clients/client-gamelift/commands/DeleteScriptCommand.ts @@ -20,6 +20,51 @@ import { export type DeleteScriptCommandInput = DeleteScriptInput; export type DeleteScriptCommandOutput = __MetadataBearer; +/** + *

Deletes a Realtime script. This operation permanently deletes the script record. If + * script files were uploaded, they are also deleted (files stored in an S3 bucket are not + * deleted).

+ *

To delete a script, specify the script ID. Before deleting a script, be sure to + * terminate all fleets that are deployed with the script being deleted. Fleet instances + * periodically check for script updates, and if the script record no longer exists, the + * instance will go into an error state and be unable to host game sessions.

+ *

+ * Learn more + *

+ *

+ * Amazon GameLift Realtime Servers + *

+ *

+ * Related operations + *

+ * + */ export class DeleteScriptCommand extends $Command< DeleteScriptCommandInput, DeleteScriptCommandOutput, @@ -34,6 +79,9 @@ export class DeleteScriptCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteVpcPeeringAuthorizationCommand.ts b/clients/client-gamelift/commands/DeleteVpcPeeringAuthorizationCommand.ts index fd6de4513a385..9367f9694d036 100644 --- a/clients/client-gamelift/commands/DeleteVpcPeeringAuthorizationCommand.ts +++ b/clients/client-gamelift/commands/DeleteVpcPeeringAuthorizationCommand.ts @@ -20,6 +20,42 @@ import { export type DeleteVpcPeeringAuthorizationCommandInput = DeleteVpcPeeringAuthorizationInput; export type DeleteVpcPeeringAuthorizationCommandOutput = DeleteVpcPeeringAuthorizationOutput & __MetadataBearer; +/** + *

Cancels a pending VPC peering authorization for the specified VPC. If you need to + * delete an existing VPC peering connection, call DeleteVpcPeeringConnection.

+ * + */ export class DeleteVpcPeeringAuthorizationCommand extends $Command< DeleteVpcPeeringAuthorizationCommandInput, DeleteVpcPeeringAuthorizationCommandOutput, @@ -34,6 +70,9 @@ export class DeleteVpcPeeringAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeleteVpcPeeringConnectionCommand.ts b/clients/client-gamelift/commands/DeleteVpcPeeringConnectionCommand.ts index 650e3684ef277..b786664ee06f7 100644 --- a/clients/client-gamelift/commands/DeleteVpcPeeringConnectionCommand.ts +++ b/clients/client-gamelift/commands/DeleteVpcPeeringConnectionCommand.ts @@ -20,6 +20,47 @@ import { export type DeleteVpcPeeringConnectionCommandInput = DeleteVpcPeeringConnectionInput; export type DeleteVpcPeeringConnectionCommandOutput = DeleteVpcPeeringConnectionOutput & __MetadataBearer; +/** + *

Removes a VPC peering connection. To delete the connection, you must have a valid + * authorization for the VPC peering connection that you want to delete. You can check for + * an authorization by calling DescribeVpcPeeringAuthorizations or + * request a new one using CreateVpcPeeringAuthorization.

+ *

Once a valid authorization exists, call this operation from the AWS account that is + * used to manage the Amazon GameLift fleets. Identify the connection to delete by the connection + * ID and fleet ID. If successful, the connection is removed.

+ * + */ export class DeleteVpcPeeringConnectionCommand extends $Command< DeleteVpcPeeringConnectionCommandInput, DeleteVpcPeeringConnectionCommandOutput, @@ -34,6 +75,9 @@ export class DeleteVpcPeeringConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DeregisterGameServerCommand.ts b/clients/client-gamelift/commands/DeregisterGameServerCommand.ts index 7e3c3644216ff..2fa4d37cf688c 100644 --- a/clients/client-gamelift/commands/DeregisterGameServerCommand.ts +++ b/clients/client-gamelift/commands/DeregisterGameServerCommand.ts @@ -20,6 +20,58 @@ import { export type DeregisterGameServerCommandInput = DeregisterGameServerInput; export type DeregisterGameServerCommandOutput = __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Removes the game server from a game server group. As a result of this operation, the + * deregistered game server can no longer be claimed and will not be returned in a list of + * active game servers.

+ *

To deregister a game server, specify the game server group and game server ID. If + * successful, this operation emits a CloudWatch event with termination timestamp and + * reason.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class DeregisterGameServerCommand extends $Command< DeregisterGameServerCommandInput, DeregisterGameServerCommandOutput, @@ -34,6 +86,9 @@ export class DeregisterGameServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeAliasCommand.ts b/clients/client-gamelift/commands/DescribeAliasCommand.ts index d531cc8e8b234..31a6a0d2fda27 100644 --- a/clients/client-gamelift/commands/DescribeAliasCommand.ts +++ b/clients/client-gamelift/commands/DescribeAliasCommand.ts @@ -20,6 +20,44 @@ import { export type DescribeAliasCommandInput = DescribeAliasInput; export type DescribeAliasCommandOutput = DescribeAliasOutput & __MetadataBearer; +/** + *

Retrieves properties for an alias. This operation returns all alias metadata and + * settings. To get an alias's target fleet ID only, use ResolveAlias.

+ *

To get alias properties, specify the alias ID. If successful, the requested alias + * record is returned.

+ * + */ export class DescribeAliasCommand extends $Command< DescribeAliasCommandInput, DescribeAliasCommandOutput, @@ -34,6 +72,9 @@ export class DescribeAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeBuildCommand.ts b/clients/client-gamelift/commands/DescribeBuildCommand.ts index 2827f4745a0c6..c7de3309a71fa 100644 --- a/clients/client-gamelift/commands/DescribeBuildCommand.ts +++ b/clients/client-gamelift/commands/DescribeBuildCommand.ts @@ -20,6 +20,47 @@ import { export type DescribeBuildCommandInput = DescribeBuildInput; export type DescribeBuildCommandOutput = DescribeBuildOutput & __MetadataBearer; +/** + *

Retrieves properties for a custom game build. To request a build resource, specify a + * build ID. If successful, an object containing the build properties is returned.

+ *

+ * Learn more + *

+ *

+ * + * Upload a Custom Server Build + *

+ *

+ * Related operations + *

+ * + */ export class DescribeBuildCommand extends $Command< DescribeBuildCommandInput, DescribeBuildCommandOutput, @@ -34,6 +75,9 @@ export class DescribeBuildCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeEC2InstanceLimitsCommand.ts b/clients/client-gamelift/commands/DescribeEC2InstanceLimitsCommand.ts index fe14d5e226324..674c2b7450e80 100644 --- a/clients/client-gamelift/commands/DescribeEC2InstanceLimitsCommand.ts +++ b/clients/client-gamelift/commands/DescribeEC2InstanceLimitsCommand.ts @@ -20,6 +20,61 @@ import { export type DescribeEC2InstanceLimitsCommandInput = DescribeEC2InstanceLimitsInput; export type DescribeEC2InstanceLimitsCommandOutput = DescribeEC2InstanceLimitsOutput & __MetadataBearer; +/** + *

Retrieves the following information for the specified EC2 instance + * type:

+ *
    + *
  • + *

    Maximum number of instances allowed per AWS account (service limit).

    + *
  • + *
  • + *

    Current usage for the AWS account.

    + *
  • + *
+ *

To learn more about the capabilities of each instance type, see Amazon EC2 Instance + * Types. Note that the instance types offered may vary depending on the region.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class DescribeEC2InstanceLimitsCommand extends $Command< DescribeEC2InstanceLimitsCommandInput, DescribeEC2InstanceLimitsCommandOutput, @@ -34,6 +89,9 @@ export class DescribeEC2InstanceLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeFleetAttributesCommand.ts b/clients/client-gamelift/commands/DescribeFleetAttributesCommand.ts index 19f8a0dc6348c..6b1cdc3d23b77 100644 --- a/clients/client-gamelift/commands/DescribeFleetAttributesCommand.ts +++ b/clients/client-gamelift/commands/DescribeFleetAttributesCommand.ts @@ -20,6 +20,95 @@ import { export type DescribeFleetAttributesCommandInput = DescribeFleetAttributesInput; export type DescribeFleetAttributesCommandOutput = DescribeFleetAttributesOutput & __MetadataBearer; +/** + *

Retrieves core properties, including configuration, status, and metadata, for a fleet.

+ *

To get attributes for one or more fleets, provide a list of fleet IDs or fleet ARNs. + * To get attributes for all fleets, do not specify a fleet identifier. When requesting + * attributes for multiple fleets, use the pagination parameters to retrieve results as a + * set of sequential pages. If successful, a FleetAttributes object is + * returned for each fleet requested, unless the fleet identifier is not found.

+ * + *

Some API operations may limit the number of fleet IDs allowed in one request. If a + * request exceeds this limit, the request fails and the error message includes the + * maximum allowed number.

+ *
+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class DescribeFleetAttributesCommand extends $Command< DescribeFleetAttributesCommandInput, DescribeFleetAttributesCommandOutput, @@ -34,6 +123,9 @@ export class DescribeFleetAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeFleetCapacityCommand.ts b/clients/client-gamelift/commands/DescribeFleetCapacityCommand.ts index 8c646d5c74f17..f24731e1b844b 100644 --- a/clients/client-gamelift/commands/DescribeFleetCapacityCommand.ts +++ b/clients/client-gamelift/commands/DescribeFleetCapacityCommand.ts @@ -20,6 +20,100 @@ import { export type DescribeFleetCapacityCommandInput = DescribeFleetCapacityInput; export type DescribeFleetCapacityCommandOutput = DescribeFleetCapacityOutput & __MetadataBearer; +/** + *

Retrieves the current capacity statistics for one or more fleets. These statistics + * present a snapshot of the fleet's instances and provide insight on current or imminent + * scaling activity. To get statistics on game hosting activity in the fleet, see DescribeFleetUtilization.

+ *

You can request capacity for all fleets or specify a list of one or more fleet + * identifiers. When requesting multiple fleets, use the pagination parameters to retrieve + * results as a set of sequential pages. If successful, a FleetCapacity + * object is returned for each requested fleet ID. When a list of fleet IDs is provided, + * attribute objects are returned only for fleets that currently exist.

+ * + *

Some API operations may limit the number of fleet IDs allowed in one request. If a + * request exceeds this limit, the request fails and the error message includes the + * maximum allowed.

+ *
+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * GameLift Metrics for Fleets + *

+ *

+ * Related operations + *

+ * + */ export class DescribeFleetCapacityCommand extends $Command< DescribeFleetCapacityCommandInput, DescribeFleetCapacityCommandOutput, @@ -34,6 +128,9 @@ export class DescribeFleetCapacityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeFleetEventsCommand.ts b/clients/client-gamelift/commands/DescribeFleetEventsCommand.ts index 54b44a1133742..597e9bfe67ea2 100644 --- a/clients/client-gamelift/commands/DescribeFleetEventsCommand.ts +++ b/clients/client-gamelift/commands/DescribeFleetEventsCommand.ts @@ -20,6 +20,88 @@ import { export type DescribeFleetEventsCommandInput = DescribeFleetEventsInput; export type DescribeFleetEventsCommandOutput = DescribeFleetEventsOutput & __MetadataBearer; +/** + *

Retrieves entries from the specified fleet's event log. You can specify a time + * range to limit the result set. Use the pagination parameters to retrieve results as a + * set of sequential pages. If successful, a collection of event log entries matching the + * request are returned.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class DescribeFleetEventsCommand extends $Command< DescribeFleetEventsCommandInput, DescribeFleetEventsCommandOutput, @@ -34,6 +116,9 @@ export class DescribeFleetEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeFleetPortSettingsCommand.ts b/clients/client-gamelift/commands/DescribeFleetPortSettingsCommand.ts index 60c0ddc8828fe..3887adebad716 100644 --- a/clients/client-gamelift/commands/DescribeFleetPortSettingsCommand.ts +++ b/clients/client-gamelift/commands/DescribeFleetPortSettingsCommand.ts @@ -20,6 +20,92 @@ import { export type DescribeFleetPortSettingsCommandInput = DescribeFleetPortSettingsInput; export type DescribeFleetPortSettingsCommandOutput = DescribeFleetPortSettingsOutput & __MetadataBearer; +/** + *

Retrieves a fleet's inbound connection permissions. Connection permissions specify the + * range of IP addresses and port settings that incoming traffic can use to access server + * processes in the fleet. Game sessions that are running on instances in the fleet use + * connections that fall in this range.

+ *

To get a fleet's inbound connection permissions, specify the fleet's unique + * identifier. If successful, a collection of IpPermission objects is + * returned for the requested fleet ID. If the requested fleet has been deleted, the result + * set is empty.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class DescribeFleetPortSettingsCommand extends $Command< DescribeFleetPortSettingsCommandInput, DescribeFleetPortSettingsCommandOutput, @@ -34,6 +120,9 @@ export class DescribeFleetPortSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeFleetUtilizationCommand.ts b/clients/client-gamelift/commands/DescribeFleetUtilizationCommand.ts index 4d7c3ae027d5c..cfba69543ffab 100644 --- a/clients/client-gamelift/commands/DescribeFleetUtilizationCommand.ts +++ b/clients/client-gamelift/commands/DescribeFleetUtilizationCommand.ts @@ -20,6 +20,99 @@ import { export type DescribeFleetUtilizationCommandInput = DescribeFleetUtilizationInput; export type DescribeFleetUtilizationCommandOutput = DescribeFleetUtilizationOutput & __MetadataBearer; +/** + *

Retrieves utilization statistics for one or more fleets. These statistics provide + * insight into how available hosting resources are currently being used. To get statistics + * on available hosting resources, see DescribeFleetCapacity.

+ *

You can request utilization data for all fleets, or specify a list of one or more + * fleet IDs. When requesting multiple fleets, use the pagination parameters to retrieve + * results as a set of sequential pages. If successful, a FleetUtilization object is returned for each requested fleet ID, unless the fleet identifier is not + * found.

+ * + *

Some API operations may limit the number of fleet IDs allowed in one request. If a + * request exceeds this limit, the request fails and the error message includes the + * maximum allowed.

+ *
+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * GameLift Metrics for Fleets + *

+ *

+ * Related operations + *

+ * + */ export class DescribeFleetUtilizationCommand extends $Command< DescribeFleetUtilizationCommandInput, DescribeFleetUtilizationCommandOutput, @@ -34,6 +127,9 @@ export class DescribeFleetUtilizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeGameServerCommand.ts b/clients/client-gamelift/commands/DescribeGameServerCommand.ts index 02a4fd999e4fc..04ac26908bcc4 100644 --- a/clients/client-gamelift/commands/DescribeGameServerCommand.ts +++ b/clients/client-gamelift/commands/DescribeGameServerCommand.ts @@ -20,6 +20,56 @@ import { export type DescribeGameServerCommandInput = DescribeGameServerInput; export type DescribeGameServerCommandOutput = DescribeGameServerOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Retrieves information for a registered game server. Information includes game server + * status, health check info, and the instance that the game server is running on.

+ *

To retrieve game server information, specify the game server ID. If successful, the + * requested game server object is returned.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class DescribeGameServerCommand extends $Command< DescribeGameServerCommandInput, DescribeGameServerCommandOutput, @@ -34,6 +84,9 @@ export class DescribeGameServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeGameServerGroupCommand.ts b/clients/client-gamelift/commands/DescribeGameServerGroupCommand.ts index 4b6711623ae98..c86fc2e3aab92 100644 --- a/clients/client-gamelift/commands/DescribeGameServerGroupCommand.ts +++ b/clients/client-gamelift/commands/DescribeGameServerGroupCommand.ts @@ -20,6 +20,68 @@ import { export type DescribeGameServerGroupCommandInput = DescribeGameServerGroupInput; export type DescribeGameServerGroupCommandOutput = DescribeGameServerGroupOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Retrieves information on a game server group. This operation returns only properties + * related to GameLift FleetIQ. To view or update properties for the corresponding Auto Scaling group, + * such as launch template, auto scaling policies, and maximum/minimum group size, access + * the Auto Scaling group directly.

+ *

To get attributes for a game server group, provide a group name or ARN value. If + * successful, a GameServerGroup object is returned.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class DescribeGameServerGroupCommand extends $Command< DescribeGameServerGroupCommandInput, DescribeGameServerGroupCommandOutput, @@ -34,6 +96,9 @@ export class DescribeGameServerGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeGameServerInstancesCommand.ts b/clients/client-gamelift/commands/DescribeGameServerInstancesCommand.ts index 4608306d306db..f9912036ca1c6 100644 --- a/clients/client-gamelift/commands/DescribeGameServerInstancesCommand.ts +++ b/clients/client-gamelift/commands/DescribeGameServerInstancesCommand.ts @@ -20,6 +20,78 @@ import { export type DescribeGameServerInstancesCommandInput = DescribeGameServerInstancesInput; export type DescribeGameServerInstancesCommandOutput = DescribeGameServerInstancesOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Retrieves status information about the Amazon EC2 instances associated with a GameLift FleetIQ + * game server group. Use this operation to detect when instances are active or not + * available to host new game servers. If you are looking for instance configuration + * information, call DescribeGameServerGroup or access the corresponding + * Auto Scaling group properties.

+ *

To request status for all instances in the game server group, provide a game server + * group ID only. To request status for specific instances, provide the game server group + * ID and one or more instance IDs. Use the pagination parameters to retrieve results in + * sequential segments. If successful, a collection of GameServerInstance + * objects is returned. + * + *

+ *

This operation is not designed to be called with every game server claim request; this + * practice can cause you to exceed your API limit, which results in errors. Instead, as a + * best practice, cache the results and refresh your cache no more than once every 10 + * seconds.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class DescribeGameServerInstancesCommand extends $Command< DescribeGameServerInstancesCommandInput, DescribeGameServerInstancesCommandOutput, @@ -34,6 +106,9 @@ export class DescribeGameServerInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeGameSessionDetailsCommand.ts b/clients/client-gamelift/commands/DescribeGameSessionDetailsCommand.ts index aea16ce397cda..32fd90c0beca9 100644 --- a/clients/client-gamelift/commands/DescribeGameSessionDetailsCommand.ts +++ b/clients/client-gamelift/commands/DescribeGameSessionDetailsCommand.ts @@ -20,6 +20,70 @@ import { export type DescribeGameSessionDetailsCommandInput = DescribeGameSessionDetailsInput; export type DescribeGameSessionDetailsCommandOutput = DescribeGameSessionDetailsOutput & __MetadataBearer; +/** + *

Retrieves properties, including the protection policy in force, for one or more + * game sessions. This operation can be used in several ways: (1) provide a + * GameSessionId or GameSessionArn to request details for a + * specific game session; (2) provide either a FleetId or an + * AliasId to request properties for all game sessions running on a fleet.

+ *

To get game session record(s), specify just one of the following: game session ID, + * fleet ID, or alias ID. You can filter this request by game session status. Use the + * pagination parameters to retrieve results as a set of sequential pages. If successful, a + * GameSessionDetail object is returned for each session matching the + * request.

+ * + */ export class DescribeGameSessionDetailsCommand extends $Command< DescribeGameSessionDetailsCommandInput, DescribeGameSessionDetailsCommandOutput, @@ -34,6 +98,9 @@ export class DescribeGameSessionDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeGameSessionPlacementCommand.ts b/clients/client-gamelift/commands/DescribeGameSessionPlacementCommand.ts index d530583867b5f..3747c767ef4f3 100644 --- a/clients/client-gamelift/commands/DescribeGameSessionPlacementCommand.ts +++ b/clients/client-gamelift/commands/DescribeGameSessionPlacementCommand.ts @@ -20,6 +20,62 @@ import { export type DescribeGameSessionPlacementCommandInput = DescribeGameSessionPlacementInput; export type DescribeGameSessionPlacementCommandOutput = DescribeGameSessionPlacementOutput & __MetadataBearer; +/** + *

Retrieves properties and current status of a game session placement request. To get + * game session placement details, specify the placement ID. If successful, a GameSessionPlacement object is returned.

+ * + */ export class DescribeGameSessionPlacementCommand extends $Command< DescribeGameSessionPlacementCommandInput, DescribeGameSessionPlacementCommandOutput, @@ -34,6 +90,9 @@ export class DescribeGameSessionPlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeGameSessionQueuesCommand.ts b/clients/client-gamelift/commands/DescribeGameSessionQueuesCommand.ts index b3e6f8ee6ca1f..d44608614e385 100644 --- a/clients/client-gamelift/commands/DescribeGameSessionQueuesCommand.ts +++ b/clients/client-gamelift/commands/DescribeGameSessionQueuesCommand.ts @@ -20,6 +20,45 @@ import { export type DescribeGameSessionQueuesCommandInput = DescribeGameSessionQueuesInput; export type DescribeGameSessionQueuesCommandOutput = DescribeGameSessionQueuesOutput & __MetadataBearer; +/** + *

Retrieves the properties for one or more game session queues. When requesting + * multiple queues, use the pagination parameters to retrieve results as a set of + * sequential pages. If successful, a GameSessionQueue object is returned + * for each requested queue. When specifying a list of queues, objects are returned only + * for queues that currently exist in the Region.

+ *

+ * Learn more + *

+ *

+ * + * View Your Queues + *

+ *

+ * Related operations + *

+ * + */ export class DescribeGameSessionQueuesCommand extends $Command< DescribeGameSessionQueuesCommandInput, DescribeGameSessionQueuesCommandOutput, @@ -34,6 +73,9 @@ export class DescribeGameSessionQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeGameSessionsCommand.ts b/clients/client-gamelift/commands/DescribeGameSessionsCommand.ts index a5134056d0313..78d4e38beb6fb 100644 --- a/clients/client-gamelift/commands/DescribeGameSessionsCommand.ts +++ b/clients/client-gamelift/commands/DescribeGameSessionsCommand.ts @@ -20,6 +20,71 @@ import { export type DescribeGameSessionsCommandInput = DescribeGameSessionsInput; export type DescribeGameSessionsCommandOutput = DescribeGameSessionsOutput & __MetadataBearer; +/** + *

Retrieves a set of one or more game sessions. Request a specific game session or + * request all game sessions on a fleet. Alternatively, use SearchGameSessions to request a set of active game sessions that are + * filtered by certain criteria. To retrieve protection policy settings for game sessions, + * use DescribeGameSessionDetails.

+ *

To get game sessions, specify one of the following: game session ID, fleet ID, or + * alias ID. You can filter this request by game session status. Use the pagination + * parameters to retrieve results as a set of sequential pages. If successful, a GameSession object is returned for each game session matching the + * request.

+ *

+ * Available in Amazon GameLift Local. + *

+ * + */ export class DescribeGameSessionsCommand extends $Command< DescribeGameSessionsCommandInput, DescribeGameSessionsCommandOutput, @@ -34,6 +99,9 @@ export class DescribeGameSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeInstancesCommand.ts b/clients/client-gamelift/commands/DescribeInstancesCommand.ts index 9c1e9d560850c..699666be9a5b5 100644 --- a/clients/client-gamelift/commands/DescribeInstancesCommand.ts +++ b/clients/client-gamelift/commands/DescribeInstancesCommand.ts @@ -20,6 +20,39 @@ import { export type DescribeInstancesCommandInput = DescribeInstancesInput; export type DescribeInstancesCommandOutput = DescribeInstancesOutput & __MetadataBearer; +/** + *

Retrieves information about a fleet's instances, including instance IDs. Use this + * operation to get details on all instances in the fleet or get details on one specific + * instance.

+ *

To get a specific instance, specify fleet ID and instance ID. To get all instances + * in a fleet, specify a fleet ID only. Use the pagination parameters to retrieve results + * as a set of sequential pages. If successful, an Instance object is + * returned for each result.

+ *

+ * Learn more + *

+ *

+ * Remotely Access Fleet Instances + *

+ *

+ * Debug Fleet Issues + *

+ *

+ * Related operations + *

+ * + */ export class DescribeInstancesCommand extends $Command< DescribeInstancesCommandInput, DescribeInstancesCommandOutput, @@ -34,6 +67,9 @@ export class DescribeInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeMatchmakingCommand.ts b/clients/client-gamelift/commands/DescribeMatchmakingCommand.ts index 44c54e9026f0a..d6f6c940ecd35 100644 --- a/clients/client-gamelift/commands/DescribeMatchmakingCommand.ts +++ b/clients/client-gamelift/commands/DescribeMatchmakingCommand.ts @@ -20,6 +20,63 @@ import { export type DescribeMatchmakingCommandInput = DescribeMatchmakingInput; export type DescribeMatchmakingCommandOutput = DescribeMatchmakingOutput & __MetadataBearer; +/** + *

Retrieves one or more matchmaking tickets. Use this operation to retrieve ticket + * information, including--after a successful match is made--connection information for the + * resulting new game session.

+ *

To request matchmaking tickets, provide a list of up to 10 ticket IDs. If the + * request is successful, a ticket object is returned for each requested ID that currently + * exists.

+ *

This operation is not designed to be continually called to track matchmaking ticket + * status. This practice can cause you to exceed your API limit, which results in errors. + * Instead, as a best practice, set up an Amazon Simple Notification Service (SNS) to receive notifications, and provide + * the topic ARN in the matchmaking configuration. Continuously poling ticket status with + * DescribeMatchmaking should only be used for games in development + * with low matchmaking usage.

+ *

+ *

+ * Learn more + *

+ *

+ * + * Add FlexMatch to a Game Client + *

+ *

+ * + * Set Up FlexMatch Event Notification + *

+ *

+ * Related operations + *

+ * + * + */ export class DescribeMatchmakingCommand extends $Command< DescribeMatchmakingCommandInput, DescribeMatchmakingCommandOutput, @@ -34,6 +91,9 @@ export class DescribeMatchmakingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeMatchmakingConfigurationsCommand.ts b/clients/client-gamelift/commands/DescribeMatchmakingConfigurationsCommand.ts index 8a8a5e66717cc..f3d7eb4beda49 100644 --- a/clients/client-gamelift/commands/DescribeMatchmakingConfigurationsCommand.ts +++ b/clients/client-gamelift/commands/DescribeMatchmakingConfigurationsCommand.ts @@ -20,6 +20,67 @@ import { export type DescribeMatchmakingConfigurationsCommandInput = DescribeMatchmakingConfigurationsInput; export type DescribeMatchmakingConfigurationsCommandOutput = DescribeMatchmakingConfigurationsOutput & __MetadataBearer; +/** + *

Retrieves the details of FlexMatch matchmaking configurations.

+ *

This operation offers the following options: (1) retrieve all matchmaking + * configurations, (2) retrieve configurations for a specified list, or (3) retrieve all + * configurations that use a specified rule set name. When requesting multiple items, use + * the pagination parameters to retrieve results as a set of sequential pages.

+ *

If successful, a configuration is returned for each requested name. When specifying a + * list of names, only configurations that currently exist are returned.

+ *

+ * Learn more + *

+ *

+ * Setting Up FlexMatch + * Matchmakers + *

+ *

+ * Related operations + *

+ * + */ export class DescribeMatchmakingConfigurationsCommand extends $Command< DescribeMatchmakingConfigurationsCommandInput, DescribeMatchmakingConfigurationsCommandOutput, @@ -34,6 +95,9 @@ export class DescribeMatchmakingConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeMatchmakingRuleSetsCommand.ts b/clients/client-gamelift/commands/DescribeMatchmakingRuleSetsCommand.ts index 761fe3d17f64c..ef2563d8873de 100644 --- a/clients/client-gamelift/commands/DescribeMatchmakingRuleSetsCommand.ts +++ b/clients/client-gamelift/commands/DescribeMatchmakingRuleSetsCommand.ts @@ -20,6 +20,68 @@ import { export type DescribeMatchmakingRuleSetsCommandInput = DescribeMatchmakingRuleSetsInput; export type DescribeMatchmakingRuleSetsCommandOutput = DescribeMatchmakingRuleSetsOutput & __MetadataBearer; +/** + *

Retrieves the details for FlexMatch matchmaking rule sets. You can request all + * existing rule sets for the Region, or provide a list of one or more rule set names. When + * requesting multiple items, use the pagination parameters to retrieve results as a set of + * sequential pages. If successful, a rule set is returned for each requested name.

+ *

+ * Learn more + *

+ * + *

+ * Related operations + *

+ * + */ export class DescribeMatchmakingRuleSetsCommand extends $Command< DescribeMatchmakingRuleSetsCommandInput, DescribeMatchmakingRuleSetsCommandOutput, @@ -34,6 +96,9 @@ export class DescribeMatchmakingRuleSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribePlayerSessionsCommand.ts b/clients/client-gamelift/commands/DescribePlayerSessionsCommand.ts index 4a71c94f4fe75..30bc7dbb4ce7c 100644 --- a/clients/client-gamelift/commands/DescribePlayerSessionsCommand.ts +++ b/clients/client-gamelift/commands/DescribePlayerSessionsCommand.ts @@ -20,6 +20,59 @@ import { export type DescribePlayerSessionsCommandInput = DescribePlayerSessionsInput; export type DescribePlayerSessionsCommandOutput = DescribePlayerSessionsOutput & __MetadataBearer; +/** + *

Retrieves properties for one or more player sessions. This operation can be used in + * several ways: (1) provide a PlayerSessionId to request properties for a + * specific player session; (2) provide a GameSessionId to request properties + * for all player sessions in the specified game session; (3) provide a + * PlayerId to request properties for all player sessions of a specified + * player.

+ *

To get game session record(s), specify only one of the following: a player session + * ID, a game session ID, or a player ID. You can filter this request by player session + * status. Use the pagination parameters to retrieve results as a set of sequential pages. + * If successful, a PlayerSession object is returned for each session + * matching the request.

+ *

+ * Available in Amazon GameLift Local. + *

+ * + */ export class DescribePlayerSessionsCommand extends $Command< DescribePlayerSessionsCommandInput, DescribePlayerSessionsCommandOutput, @@ -34,6 +87,9 @@ export class DescribePlayerSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeRuntimeConfigurationCommand.ts b/clients/client-gamelift/commands/DescribeRuntimeConfigurationCommand.ts index b5fd1418bab6f..5e447b0a5655a 100644 --- a/clients/client-gamelift/commands/DescribeRuntimeConfigurationCommand.ts +++ b/clients/client-gamelift/commands/DescribeRuntimeConfigurationCommand.ts @@ -20,6 +20,92 @@ import { export type DescribeRuntimeConfigurationCommandInput = DescribeRuntimeConfigurationInput; export type DescribeRuntimeConfigurationCommandOutput = DescribeRuntimeConfigurationOutput & __MetadataBearer; +/** + *

Retrieves a fleet's runtime configuration settings. The runtime configuration tells + * Amazon GameLift which server processes to run (and how) on each instance in the fleet.

+ *

To get a runtime configuration, specify the fleet's unique identifier. If successful, + * a RuntimeConfiguration object is returned for the requested fleet. If the requested fleet has been + * deleted, the result set is empty.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Running Multiple Processes on a Fleet + *

+ *

+ * Related operations + *

+ * + */ export class DescribeRuntimeConfigurationCommand extends $Command< DescribeRuntimeConfigurationCommandInput, DescribeRuntimeConfigurationCommandOutput, @@ -34,6 +120,9 @@ export class DescribeRuntimeConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeScalingPoliciesCommand.ts b/clients/client-gamelift/commands/DescribeScalingPoliciesCommand.ts index 121afd8901f71..928340dea4385 100644 --- a/clients/client-gamelift/commands/DescribeScalingPoliciesCommand.ts +++ b/clients/client-gamelift/commands/DescribeScalingPoliciesCommand.ts @@ -20,6 +20,66 @@ import { export type DescribeScalingPoliciesCommandInput = DescribeScalingPoliciesInput; export type DescribeScalingPoliciesCommandOutput = DescribeScalingPoliciesOutput & __MetadataBearer; +/** + *

Retrieves all scaling policies applied to a fleet.

+ *

To get a fleet's scaling policies, specify the fleet ID. You can filter this + * request by policy status, such as to retrieve only active scaling policies. Use the + * pagination parameters to retrieve results as a set of sequential pages. If successful, + * set of ScalingPolicy objects is returned for the fleet.

+ *

A fleet may have all of its scaling policies suspended (StopFleetActions). This operation does not affect the status of the scaling + * policies, which remains ACTIVE. To see whether a fleet's scaling policies are in force + * or suspended, call DescribeFleetAttributes and check the stopped + * actions.

+ * + */ export class DescribeScalingPoliciesCommand extends $Command< DescribeScalingPoliciesCommandInput, DescribeScalingPoliciesCommandOutput, @@ -34,6 +94,9 @@ export class DescribeScalingPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeScriptCommand.ts b/clients/client-gamelift/commands/DescribeScriptCommand.ts index 546abc8d244e8..6022435112c05 100644 --- a/clients/client-gamelift/commands/DescribeScriptCommand.ts +++ b/clients/client-gamelift/commands/DescribeScriptCommand.ts @@ -20,6 +20,47 @@ import { export type DescribeScriptCommandInput = DescribeScriptInput; export type DescribeScriptCommandOutput = DescribeScriptOutput & __MetadataBearer; +/** + *

Retrieves properties for a Realtime script.

+ *

To request a script record, specify the script ID. If successful, an object containing the script properties + * is returned.

+ *

+ * Learn more + *

+ *

+ * Amazon GameLift Realtime Servers + *

+ *

+ * Related operations + *

+ * + */ export class DescribeScriptCommand extends $Command< DescribeScriptCommandInput, DescribeScriptCommandOutput, @@ -34,6 +75,9 @@ export class DescribeScriptCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeVpcPeeringAuthorizationsCommand.ts b/clients/client-gamelift/commands/DescribeVpcPeeringAuthorizationsCommand.ts index bcd5ac2ea3f59..0676253e9d875 100644 --- a/clients/client-gamelift/commands/DescribeVpcPeeringAuthorizationsCommand.ts +++ b/clients/client-gamelift/commands/DescribeVpcPeeringAuthorizationsCommand.ts @@ -20,6 +20,43 @@ import { export type DescribeVpcPeeringAuthorizationsCommandInput = DescribeVpcPeeringAuthorizationsInput; export type DescribeVpcPeeringAuthorizationsCommandOutput = DescribeVpcPeeringAuthorizationsOutput & __MetadataBearer; +/** + *

Retrieves valid VPC peering authorizations that are pending for the AWS account. + * This operation returns all VPC peering authorizations and requests for peering. This + * includes those initiated and received by this account.

+ * + */ export class DescribeVpcPeeringAuthorizationsCommand extends $Command< DescribeVpcPeeringAuthorizationsCommandInput, DescribeVpcPeeringAuthorizationsCommandOutput, @@ -34,6 +71,9 @@ export class DescribeVpcPeeringAuthorizationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/DescribeVpcPeeringConnectionsCommand.ts b/clients/client-gamelift/commands/DescribeVpcPeeringConnectionsCommand.ts index c151691728da2..d2760bf1edb93 100644 --- a/clients/client-gamelift/commands/DescribeVpcPeeringConnectionsCommand.ts +++ b/clients/client-gamelift/commands/DescribeVpcPeeringConnectionsCommand.ts @@ -20,6 +20,47 @@ import { export type DescribeVpcPeeringConnectionsCommandInput = DescribeVpcPeeringConnectionsInput; export type DescribeVpcPeeringConnectionsCommandOutput = DescribeVpcPeeringConnectionsOutput & __MetadataBearer; +/** + *

Retrieves information on VPC peering connections. Use this operation to get peering + * information for all fleets or for one specific fleet ID.

+ *

To retrieve connection information, call this operation from the AWS account that + * is used to manage the Amazon GameLift fleets. Specify a fleet ID or leave the parameter empty + * to retrieve all connection records. If successful, the retrieved information includes + * both active and pending connections. Active connections identify the IpV4 CIDR block + * that the VPC uses to connect.

+ * + */ export class DescribeVpcPeeringConnectionsCommand extends $Command< DescribeVpcPeeringConnectionsCommandInput, DescribeVpcPeeringConnectionsCommandOutput, @@ -34,6 +75,9 @@ export class DescribeVpcPeeringConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/GetGameSessionLogUrlCommand.ts b/clients/client-gamelift/commands/GetGameSessionLogUrlCommand.ts index 78982efa35363..5a2d7fde7318a 100644 --- a/clients/client-gamelift/commands/GetGameSessionLogUrlCommand.ts +++ b/clients/client-gamelift/commands/GetGameSessionLogUrlCommand.ts @@ -20,6 +20,68 @@ import { export type GetGameSessionLogUrlCommandInput = GetGameSessionLogUrlInput; export type GetGameSessionLogUrlCommandOutput = GetGameSessionLogUrlOutput & __MetadataBearer; +/** + *

Retrieves the location of stored game session logs for a specified game session. + * When a game session is terminated, Amazon GameLift automatically stores the logs in Amazon S3 and + * retains them for 14 days. Use this URL to download the logs.

+ * + *

See the AWS Service + * Limits page for maximum log file sizes. Log files that exceed this limit + * are not saved.

+ *
+ * + */ export class GetGameSessionLogUrlCommand extends $Command< GetGameSessionLogUrlCommandInput, GetGameSessionLogUrlCommandOutput, @@ -34,6 +96,9 @@ export class GetGameSessionLogUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/GetInstanceAccessCommand.ts b/clients/client-gamelift/commands/GetInstanceAccessCommand.ts index 893f1713a1c18..0f0050d2d8400 100644 --- a/clients/client-gamelift/commands/GetInstanceAccessCommand.ts +++ b/clients/client-gamelift/commands/GetInstanceAccessCommand.ts @@ -20,6 +20,48 @@ import { export type GetInstanceAccessCommandInput = GetInstanceAccessInput; export type GetInstanceAccessCommandOutput = GetInstanceAccessOutput & __MetadataBearer; +/** + *

Requests remote access to a fleet instance. Remote access is useful for debugging, + * gathering benchmarking data, or observing activity in real time.

+ *

To remotely access an instance, you need credentials that match the operating system + * of the instance. For a Windows instance, Amazon GameLift returns a user name and password as + * strings for use with a Windows Remote Desktop client. For a Linux instance, Amazon GameLift + * returns a user name and RSA private key, also as strings, for use with an SSH client. + * The private key must be saved in the proper format to a .pem file before + * using. If you're making this request using the AWS CLI, saving the secret can be handled + * as part of the GetInstanceAccess request, as shown in one of the examples for this + * operation.

+ *

To request access to a specific instance, specify the IDs of both the instance and the + * fleet it belongs to. You can retrieve a fleet's instance IDs by calling DescribeInstances. If successful, an InstanceAccess + * object is returned that contains the instance's IP address and a set of + * credentials.

+ *

+ * Learn more + *

+ *

+ * Remotely Access Fleet + * Instances + *

+ *

+ * Debug Fleet + * Issues + *

+ *

+ * Related operations + *

+ * + */ export class GetInstanceAccessCommand extends $Command< GetInstanceAccessCommandInput, GetInstanceAccessCommandOutput, @@ -34,6 +76,9 @@ export class GetInstanceAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ListAliasesCommand.ts b/clients/client-gamelift/commands/ListAliasesCommand.ts index 0e354a4653a4f..95cc98f86c49f 100644 --- a/clients/client-gamelift/commands/ListAliasesCommand.ts +++ b/clients/client-gamelift/commands/ListAliasesCommand.ts @@ -20,6 +20,46 @@ import { export type ListAliasesCommandInput = ListAliasesInput; export type ListAliasesCommandOutput = ListAliasesOutput & __MetadataBearer; +/** + *

Retrieves all aliases for this AWS account. You can filter the result set by + * alias name and/or routing strategy type. Use the pagination parameters to retrieve + * results in sequential pages.

+ * + *

Returned aliases are not listed in any particular order.

+ *
+ * + */ export class ListAliasesCommand extends $Command< ListAliasesCommandInput, ListAliasesCommandOutput, @@ -34,6 +74,9 @@ export class ListAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ListBuildsCommand.ts b/clients/client-gamelift/commands/ListBuildsCommand.ts index 8a6881d4874c2..d89e47dcc1945 100644 --- a/clients/client-gamelift/commands/ListBuildsCommand.ts +++ b/clients/client-gamelift/commands/ListBuildsCommand.ts @@ -20,6 +20,52 @@ import { export type ListBuildsCommandInput = ListBuildsInput; export type ListBuildsCommandOutput = ListBuildsOutput & __MetadataBearer; +/** + *

Retrieves build resources for all builds associated with the AWS account in use. You + * can limit results to builds that are in a specific status by using the + * Status parameter. Use the pagination parameters to retrieve results in + * a set of sequential pages.

+ * + *

Build resources are not listed in any particular order.

+ *
+ *

+ * Learn more + *

+ *

+ * + * Upload a Custom Server Build + *

+ *

+ * Related operations + *

+ * + */ export class ListBuildsCommand extends $Command< ListBuildsCommandInput, ListBuildsCommandOutput, @@ -34,6 +80,9 @@ export class ListBuildsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ListFleetsCommand.ts b/clients/client-gamelift/commands/ListFleetsCommand.ts index e365bae1b4546..c76f2aa09ad54 100644 --- a/clients/client-gamelift/commands/ListFleetsCommand.ts +++ b/clients/client-gamelift/commands/ListFleetsCommand.ts @@ -20,6 +20,55 @@ import { export type ListFleetsCommandInput = ListFleetsInput; export type ListFleetsCommandOutput = ListFleetsOutput & __MetadataBearer; +/** + *

Retrieves a collection of fleet resources for this AWS account. You can filter the + * result set to find only those fleets that are deployed with a specific build or script. + * Use the pagination parameters to retrieve results in sequential pages.

+ * + *

Fleet resources are not listed in a particular order.

+ *
+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class ListFleetsCommand extends $Command< ListFleetsCommandInput, ListFleetsCommandOutput, @@ -34,6 +83,9 @@ export class ListFleetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ListGameServerGroupsCommand.ts b/clients/client-gamelift/commands/ListGameServerGroupsCommand.ts index acfecb0b1fa50..be94e16209f83 100644 --- a/clients/client-gamelift/commands/ListGameServerGroupsCommand.ts +++ b/clients/client-gamelift/commands/ListGameServerGroupsCommand.ts @@ -20,6 +20,65 @@ import { export type ListGameServerGroupsCommandInput = ListGameServerGroupsInput; export type ListGameServerGroupsCommandOutput = ListGameServerGroupsOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Retrieves information on all game servers groups that exist in the current AWS + * account for the selected Region. Use the pagination parameters to retrieve results in a + * set of sequential segments.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class ListGameServerGroupsCommand extends $Command< ListGameServerGroupsCommandInput, ListGameServerGroupsCommandOutput, @@ -34,6 +93,9 @@ export class ListGameServerGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ListGameServersCommand.ts b/clients/client-gamelift/commands/ListGameServersCommand.ts index 7eedf311ca8bf..122c144770ef8 100644 --- a/clients/client-gamelift/commands/ListGameServersCommand.ts +++ b/clients/client-gamelift/commands/ListGameServersCommand.ts @@ -20,6 +20,55 @@ import { export type ListGameServersCommandInput = ListGameServersInput; export type ListGameServersCommandOutput = ListGameServersOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Retrieves information on all game servers that are currently active in a specified + * game server group. You can opt to sort the list by game server age. Use the + * pagination parameters to retrieve results in a set of sequential segments.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class ListGameServersCommand extends $Command< ListGameServersCommandInput, ListGameServersCommandOutput, @@ -34,6 +83,9 @@ export class ListGameServersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ListScriptsCommand.ts b/clients/client-gamelift/commands/ListScriptsCommand.ts index 8b047b7c6c88d..05720875c9650 100644 --- a/clients/client-gamelift/commands/ListScriptsCommand.ts +++ b/clients/client-gamelift/commands/ListScriptsCommand.ts @@ -20,6 +20,45 @@ import { export type ListScriptsCommandInput = ListScriptsInput; export type ListScriptsCommandOutput = ListScriptsOutput & __MetadataBearer; +/** + *

Retrieves script records for all Realtime scripts that are associated with the AWS account in use.

+ *

+ * Learn more + *

+ *

+ * Amazon GameLift Realtime Servers + *

+ *

+ * Related operations + *

+ * + */ export class ListScriptsCommand extends $Command< ListScriptsCommandInput, ListScriptsCommandOutput, @@ -34,6 +73,9 @@ export class ListScriptsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ListTagsForResourceCommand.ts b/clients/client-gamelift/commands/ListTagsForResourceCommand.ts index 9b0f82317bf3d..39f72a5c59578 100644 --- a/clients/client-gamelift/commands/ListTagsForResourceCommand.ts +++ b/clients/client-gamelift/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,68 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

+ * Retrieves all tags that are assigned to a GameLift resource. + * Resource tags are used to organize AWS resources for a range of purposes. + * This operation handles the permissions necessary to manage tags for the following + * GameLift resource types:

+ *
    + *
  • + *

    Build

    + *
  • + *
  • + *

    Script

    + *
  • + *
  • + *

    Fleet

    + *
  • + *
  • + *

    Alias

    + *
  • + *
  • + *

    GameSessionQueue

    + *
  • + *
  • + *

    MatchmakingConfiguration

    + *
  • + *
  • + *

    MatchmakingRuleSet

    + *
  • + *
+ *

To list tags for a resource, specify the unique ARN value for the resource.

+ *

+ * Learn more + *

+ *

+ * Tagging AWS Resources in the + * AWS General Reference + *

+ *

+ * + * AWS Tagging Strategies + *

+ *

+ * Related operations + *

+ * + */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +96,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/PutScalingPolicyCommand.ts b/clients/client-gamelift/commands/PutScalingPolicyCommand.ts index 59cbc69a9f02d..8c244b1fed6c8 100644 --- a/clients/client-gamelift/commands/PutScalingPolicyCommand.ts +++ b/clients/client-gamelift/commands/PutScalingPolicyCommand.ts @@ -20,6 +20,120 @@ import { export type PutScalingPolicyCommandInput = PutScalingPolicyInput; export type PutScalingPolicyCommandOutput = PutScalingPolicyOutput & __MetadataBearer; +/** + *

Creates or updates a scaling policy for a fleet. Scaling policies are used to + * automatically scale a fleet's hosting capacity to meet player demand. An active scaling + * policy instructs Amazon GameLift to track a fleet metric and automatically change the fleet's + * capacity when a certain threshold is reached. There are two types of scaling policies: + * target-based and rule-based. Use a target-based policy to quickly and efficiently manage + * fleet scaling; this option is the most commonly used. Use rule-based policies when you + * need to exert fine-grained control over auto-scaling.

+ *

Fleets can have multiple scaling policies of each type in force at the same time; + * you can have one target-based policy, one or multiple rule-based scaling policies, or + * both. We recommend caution, however, because multiple auto-scaling policies can have + * unintended consequences.

+ *

You can temporarily suspend all scaling policies for a fleet by calling StopFleetActions with the fleet action AUTO_SCALING. To resume scaling + * policies, call StartFleetActions with the same fleet action. To stop + * just one scaling policy--or to permanently remove it, you must delete the policy with + * DeleteScalingPolicy.

+ *

Learn more about how to work with auto-scaling in Set Up Fleet Automatic + * Scaling.

+ *

+ * Target-based policy + *

+ *

A target-based policy tracks a single metric: PercentAvailableGameSessions. This + * metric tells us how much of a fleet's hosting capacity is ready to host game sessions + * but is not currently in use. This is the fleet's buffer; it measures the additional + * player demand that the fleet could handle at current capacity. With a target-based + * policy, you set your ideal buffer size and leave it to Amazon GameLift to take whatever action + * is needed to maintain that target.

+ *

For example, you might choose to maintain a 10% buffer for a fleet that has the + * capacity to host 100 simultaneous game sessions. This policy tells Amazon GameLift to take + * action whenever the fleet's available capacity falls below or rises above 10 game + * sessions. Amazon GameLift will start new instances or stop unused instances in order to return + * to the 10% buffer.

+ *

To create or update a target-based policy, specify a fleet ID and name, and set the + * policy type to "TargetBased". Specify the metric to track (PercentAvailableGameSessions) + * and reference a TargetConfiguration object with your desired buffer + * value. Exclude all other parameters. On a successful request, the policy name is + * returned. The scaling policy is automatically in force as soon as it's successfully + * created. If the fleet's auto-scaling actions are temporarily suspended, the new policy + * will be in force once the fleet actions are restarted.

+ *

+ * Rule-based policy + *

+ *

A rule-based policy tracks specified fleet metric, sets a threshold value, and + * specifies the type of action to initiate when triggered. With a rule-based policy, you + * can select from several available fleet metrics. Each policy specifies whether to scale + * up or scale down (and by how much), so you need one policy for each type of action.

+ *

For example, a policy may make the following statement: "If the percentage of idle + * instances is greater than 20% for more than 15 minutes, then reduce the fleet capacity + * by 10%."

+ *

A policy's rule statement has the following structure:

+ *

If [MetricName] is [ComparisonOperator] + * [Threshold] for [EvaluationPeriods] minutes, then + * [ScalingAdjustmentType] to/by + * [ScalingAdjustment].

+ *

To implement the example, the rule statement would look like this:

+ *

If [PercentIdleInstances] is [GreaterThanThreshold] + * [20] for [15] minutes, then + * [PercentChangeInCapacity] to/by [10].

+ *

To create or update a scaling policy, specify a unique combination of name and + * fleet ID, and set the policy type to "RuleBased". Specify the parameter values for a + * policy rule statement. On a successful request, the policy name is returned. Scaling + * policies are automatically in force as soon as they're successfully created. If the + * fleet's auto-scaling actions are temporarily suspended, the new policy will be in force + * once the fleet actions are restarted.

+ * + */ export class PutScalingPolicyCommand extends $Command< PutScalingPolicyCommandInput, PutScalingPolicyCommandOutput, @@ -34,6 +148,9 @@ export class PutScalingPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/RegisterGameServerCommand.ts b/clients/client-gamelift/commands/RegisterGameServerCommand.ts index 2662e33b041fc..dfca66f0412a9 100644 --- a/clients/client-gamelift/commands/RegisterGameServerCommand.ts +++ b/clients/client-gamelift/commands/RegisterGameServerCommand.ts @@ -20,6 +20,66 @@ import { export type RegisterGameServerCommandInput = RegisterGameServerInput; export type RegisterGameServerCommandOutput = RegisterGameServerOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Creates a new game server resource and notifies GameLift FleetIQ that the game server is ready to + * host gameplay and players. This operation is called by a game server process that is + * running on an instance in a game server group. Registering game servers enables GameLift FleetIQ to + * track available game servers and enables game clients and services to claim a game + * server for a new game session.

+ *

To register a game server, identify the game server group and instance where the game + * server is running, and provide a unique identifier for the game server. You can also + * include connection and game server data. When a game client or service requests a game + * server by calling ClaimGameServer, this information is returned in the + * response.

+ *

Once a game server is successfully registered, it is put in status + * AVAILABLE. A request to register a game server may fail if the instance + * it is running on is in the process of shutting down as part of instance balancing or + * scale-down activity.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class RegisterGameServerCommand extends $Command< RegisterGameServerCommandInput, RegisterGameServerCommandOutput, @@ -34,6 +94,9 @@ export class RegisterGameServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/RequestUploadCredentialsCommand.ts b/clients/client-gamelift/commands/RequestUploadCredentialsCommand.ts index 59b8de7bcac43..e13dee26d823f 100644 --- a/clients/client-gamelift/commands/RequestUploadCredentialsCommand.ts +++ b/clients/client-gamelift/commands/RequestUploadCredentialsCommand.ts @@ -20,6 +20,51 @@ import { export type RequestUploadCredentialsCommandInput = RequestUploadCredentialsInput; export type RequestUploadCredentialsCommandOutput = RequestUploadCredentialsOutput & __MetadataBearer; +/** + *

Retrieves a fresh set of credentials for use when uploading a new set of game build + * files to Amazon GameLift's Amazon S3. This is done as part of the build creation process; see + * CreateBuild.

+ *

To request new credentials, specify the build ID as returned with an initial + * CreateBuild request. If successful, a new set of credentials are + * returned, along with the S3 storage location associated with the build ID.

+ *

+ * Learn more + *

+ *

+ * + * Create a Build with Files in S3 + *

+ *

+ * Related operations + *

+ * + */ export class RequestUploadCredentialsCommand extends $Command< RequestUploadCredentialsCommandInput, RequestUploadCredentialsCommandOutput, @@ -34,6 +79,9 @@ export class RequestUploadCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ResolveAliasCommand.ts b/clients/client-gamelift/commands/ResolveAliasCommand.ts index 7e814c0c3aa92..7c429664da6a6 100644 --- a/clients/client-gamelift/commands/ResolveAliasCommand.ts +++ b/clients/client-gamelift/commands/ResolveAliasCommand.ts @@ -20,6 +20,41 @@ import { export type ResolveAliasCommandInput = ResolveAliasInput; export type ResolveAliasCommandOutput = ResolveAliasOutput & __MetadataBearer; +/** + *

Retrieves the fleet ID that an alias is currently pointing to.

+ * + */ export class ResolveAliasCommand extends $Command< ResolveAliasCommandInput, ResolveAliasCommandOutput, @@ -34,6 +69,9 @@ export class ResolveAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ResumeGameServerGroupCommand.ts b/clients/client-gamelift/commands/ResumeGameServerGroupCommand.ts index ca4c0063ed489..f5b4e001dd814 100644 --- a/clients/client-gamelift/commands/ResumeGameServerGroupCommand.ts +++ b/clients/client-gamelift/commands/ResumeGameServerGroupCommand.ts @@ -20,6 +20,71 @@ import { export type ResumeGameServerGroupCommandInput = ResumeGameServerGroupInput; export type ResumeGameServerGroupCommandOutput = ResumeGameServerGroupOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Reinstates activity on a game server group after it has been suspended. A game server + * group might be suspended by theSuspendGameServerGroup operation, or it + * might be suspended involuntarily due to a configuration problem. In the second case, you + * can manually resume activity on the group once the configuration problem has been + * resolved. Refer to the game server group status and status reason for more information + * on why group activity is suspended.

+ *

To resume activity, specify a game server group ARN and the type of activity to be + * resumed. If successful, a GameServerGroup object is returned showing + * that the resumed activity is no longer listed in SuspendedActions.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class ResumeGameServerGroupCommand extends $Command< ResumeGameServerGroupCommandInput, ResumeGameServerGroupCommandOutput, @@ -34,6 +99,9 @@ export class ResumeGameServerGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/SearchGameSessionsCommand.ts b/clients/client-gamelift/commands/SearchGameSessionsCommand.ts index afb00f101d251..f6157a3ed8477 100644 --- a/clients/client-gamelift/commands/SearchGameSessionsCommand.ts +++ b/clients/client-gamelift/commands/SearchGameSessionsCommand.ts @@ -20,6 +20,128 @@ import { export type SearchGameSessionsCommandInput = SearchGameSessionsInput; export type SearchGameSessionsCommandOutput = SearchGameSessionsOutput & __MetadataBearer; +/** + *

Retrieves all active game sessions that match a set of search criteria and sorts + * them in a specified order. You can search or sort by the following game session + * attributes:

+ *
    + *
  • + *

    + * gameSessionId -- A unique identifier for the game session. You can use + * either a GameSessionId or GameSessionArn value. + *

    + *
  • + *
  • + *

    + * gameSessionName -- Name assigned to a game + * session. This value is set when requesting a new game session with CreateGameSession or updating with UpdateGameSession. Game session names do not need to be unique + * to a game session.

    + *
  • + *
  • + *

    + * gameSessionProperties -- Custom data + * defined in a game session's GameProperty parameter. + * GameProperty values are stored as key:value pairs; the filter + * expression must indicate the key and a string to search the data values for. For + * example, to search for game sessions with custom data containing the key:value + * pair "gameMode:brawl", specify the following: + * gameSessionProperties.gameMode = "brawl". All custom data + * values are searched as strings.

    + *
  • + *
  • + *

    + * maximumSessions -- Maximum number of + * player sessions allowed for a game session. This value is set when requesting a + * new game session with CreateGameSession or updating with UpdateGameSession.

    + *
  • + *
  • + *

    + * creationTimeMillis -- Value indicating + * when a game session was created. It is expressed in Unix time as + * milliseconds.

    + *
  • + *
  • + *

    + * playerSessionCount -- Number of players + * currently connected to a game session. This value changes rapidly as players + * join the session or drop out.

    + *
  • + *
  • + *

    + * hasAvailablePlayerSessions -- Boolean + * value indicating whether a game session has reached its maximum number of + * players. It is highly recommended that all search requests include this filter + * attribute to optimize search performance and return only sessions that players + * can join.

    + *
  • + *
+ * + *

Returned values for playerSessionCount and + * hasAvailablePlayerSessions change quickly as players join sessions + * and others drop out. Results should be considered a snapshot in time. Be sure to + * refresh search results often, and handle sessions that fill up before a player can + * join.

+ *
+ *

To search or sort, specify either a fleet ID or an alias ID, and provide a search + * filter expression, a sort expression, or both. If successful, a collection of GameSession objects matching the request is returned. Use the pagination + * parameters to retrieve results as a set of sequential pages.

+ *

You can search for game sessions one fleet at a time only. To find game sessions + * across multiple fleets, you must search each fleet separately and combine the results. + * This search feature finds only game sessions that are in ACTIVE status. To + * locate games in statuses other than active, use DescribeGameSessionDetails.

+ * + */ export class SearchGameSessionsCommand extends $Command< SearchGameSessionsCommandInput, SearchGameSessionsCommandOutput, @@ -34,6 +156,9 @@ export class SearchGameSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/StartFleetActionsCommand.ts b/clients/client-gamelift/commands/StartFleetActionsCommand.ts index 763b178b8f51b..18730e72f65cf 100644 --- a/clients/client-gamelift/commands/StartFleetActionsCommand.ts +++ b/clients/client-gamelift/commands/StartFleetActionsCommand.ts @@ -20,6 +20,56 @@ import { export type StartFleetActionsCommandInput = StartFleetActionsInput; export type StartFleetActionsCommandOutput = StartFleetActionsOutput & __MetadataBearer; +/** + *

Resumes activity on a fleet that was suspended with StopFleetActions. Currently, this operation is used to restart a fleet's + * auto-scaling activity.

+ *

To start fleet actions, specify the fleet ID and the type of actions to restart. When + * auto-scaling fleet actions are restarted, Amazon GameLift once again initiates scaling events + * as triggered by the fleet's scaling policies. If actions on the fleet were never + * stopped, this operation will have no effect. You can view a fleet's stopped actions + * using DescribeFleetAttributes.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class StartFleetActionsCommand extends $Command< StartFleetActionsCommandInput, StartFleetActionsCommandOutput, @@ -34,6 +84,9 @@ export class StartFleetActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/StartGameSessionPlacementCommand.ts b/clients/client-gamelift/commands/StartGameSessionPlacementCommand.ts index 2d5ad09ceb97f..5c9110cd6fbe2 100644 --- a/clients/client-gamelift/commands/StartGameSessionPlacementCommand.ts +++ b/clients/client-gamelift/commands/StartGameSessionPlacementCommand.ts @@ -20,6 +20,100 @@ import { export type StartGameSessionPlacementCommandInput = StartGameSessionPlacementInput; export type StartGameSessionPlacementCommandOutput = StartGameSessionPlacementOutput & __MetadataBearer; +/** + *

Places a request for a new game session in a queue (see CreateGameSessionQueue). When processing a placement request, Amazon GameLift + * searches for available resources on the queue's destinations, scanning each until it + * finds resources or the placement request times out.

+ *

A game session placement request can also request player sessions. When a new game + * session is successfully created, Amazon GameLift creates a player session for each player + * included in the request.

+ *

When placing a game session, by default Amazon GameLift tries each fleet in the order they + * are listed in the queue configuration. Ideally, a queue's destinations are listed in + * preference order.

+ *

Alternatively, when requesting a game session with players, you can also provide + * latency data for each player in relevant Regions. Latency data indicates the performance + * lag a player experiences when connected to a fleet in the Region. Amazon GameLift uses latency + * data to reorder the list of destinations to place the game session in a Region with + * minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each + * Region's average lag for all players and reorders to get the best game play across all + * players.

+ *

To place a new game session request, specify the following:

+ *
    + *
  • + *

    The queue name and a set of game session properties and settings

    + *
  • + *
  • + *

    A unique ID (such as a UUID) for the placement. You use this ID to track + * the status of the placement request

    + *
  • + *
  • + *

    (Optional) A set of player data and a unique player ID for each player that + * you are joining to the new game session (player data is optional, but if you + * include it, you must also provide a unique ID for each player)

    + *
  • + *
  • + *

    Latency data for all players (if you want to optimize game play for the + * players)

    + *
  • + *
+ *

If successful, a new game session placement is created.

+ *

To track the status of a placement request, call DescribeGameSessionPlacement and check the request's status. If the + * status is FULFILLED, a new game session has been created and a game session + * ARN and Region are referenced. If the placement request times out, you can resubmit the + * request or retry it with a different queue.

+ * + */ export class StartGameSessionPlacementCommand extends $Command< StartGameSessionPlacementCommandInput, StartGameSessionPlacementCommandOutput, @@ -34,6 +128,9 @@ export class StartGameSessionPlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/StartMatchBackfillCommand.ts b/clients/client-gamelift/commands/StartMatchBackfillCommand.ts index ed13c8f6a00ed..f457b04400dc2 100644 --- a/clients/client-gamelift/commands/StartMatchBackfillCommand.ts +++ b/clients/client-gamelift/commands/StartMatchBackfillCommand.ts @@ -20,6 +20,68 @@ import { export type StartMatchBackfillCommandInput = StartMatchBackfillInput; export type StartMatchBackfillCommandOutput = StartMatchBackfillOutput & __MetadataBearer; +/** + *

Finds new players to fill open slots in an existing game session. This operation + * can be used to add players to matched games that start with fewer than the maximum + * number of players or to replace players when they drop out. By backfilling with the same + * matchmaker used to create the original match, you ensure that new players meet the match + * criteria and maintain a consistent experience throughout the game session. You can + * backfill a match anytime after a game session has been created.

+ *

To request a match backfill, specify a unique ticket ID, the existing game + * session's ARN, a matchmaking configuration, and a set of data that describes all current + * players in the game session. If successful, a match backfill ticket is created and + * returned with status set to QUEUED. The ticket is placed in the matchmaker's ticket pool + * and processed. Track the status of the ticket to respond as needed.

+ *

The process of finding backfill matches is essentially identical to the initial + * matchmaking process. The matchmaker searches the pool and groups tickets together to + * form potential matches, allowing only one backfill ticket per potential match. Once the + * a match is formed, the matchmaker creates player sessions for the new players. All + * tickets in the match are updated with the game session's connection information, and the + * GameSession object is updated to include matchmaker data on the + * new players. For more detail on how match backfill requests are processed, see How + * Amazon GameLift FlexMatch Works.

+ *

+ * Learn more + *

+ *

+ * + * Backfill Existing Games with FlexMatch + *

+ *

+ * + * How GameLift FlexMatch Works + *

+ *

+ * Related operations + *

+ * + */ export class StartMatchBackfillCommand extends $Command< StartMatchBackfillCommandInput, StartMatchBackfillCommandOutput, @@ -34,6 +96,9 @@ export class StartMatchBackfillCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/StartMatchmakingCommand.ts b/clients/client-gamelift/commands/StartMatchmakingCommand.ts index 4f42581825463..0b176fc21c2dd 100644 --- a/clients/client-gamelift/commands/StartMatchmakingCommand.ts +++ b/clients/client-gamelift/commands/StartMatchmakingCommand.ts @@ -20,6 +20,109 @@ import { export type StartMatchmakingCommandInput = StartMatchmakingInput; export type StartMatchmakingCommandOutput = StartMatchmakingOutput & __MetadataBearer; +/** + *

Uses FlexMatch to create a game match for a group of players based on custom + * matchmaking rules, and starts a new game for the matched players. Each matchmaking + * request specifies the type of match to build (team configuration, rules for an + * acceptable match, etc.). The request also specifies the players to find a match for and + * where to host the new game session for optimal performance. A matchmaking request might + * start with a single player or a group of players who want to play together. FlexMatch + * finds additional players as needed to fill the match. Match type, rules, and the queue + * used to place a new game session are defined in a MatchmakingConfiguration. + *

+ *

To start matchmaking, provide a unique ticket ID, specify a matchmaking configuration, + * and include the players to be matched. You must also include a set of player attributes + * relevant for the matchmaking configuration. If successful, a matchmaking ticket is + * returned with status set to QUEUED.

+ *

Track the status of the ticket to respond as needed and acquire game session + * connection information for successfully completed matches. Ticket status updates are + * tracked using event notification through Amazon Simple Notification Service (SNS), which is defined in the matchmaking + * configuration.

+ *

+ * Processing a matchmaking request -- FlexMatch + * handles a matchmaking request as follows:

+ *
    + *
  1. + *

    Your client code submits a StartMatchmaking request for one or + * more players and tracks the status of the request ticket.

    + *
  2. + *
  3. + *

    FlexMatch uses this ticket and others in process to build an acceptable + * match. When a potential match is identified, all tickets in the proposed match + * are advanced to the next status.

    + *
  4. + *
  5. + *

    If the match requires player acceptance (set in the matchmaking + * configuration), the tickets move into status REQUIRES_ACCEPTANCE. + * This status triggers your client code to solicit acceptance from all players in + * every ticket involved in the match, and then call AcceptMatch + * for each player. If any player rejects or fails to accept the match before a + * specified timeout, the proposed match is dropped (see AcceptMatch + * for more details).

    + *
  6. + *
  7. + *

    Once a match is proposed and accepted, the matchmaking tickets move into + * status PLACING. FlexMatch locates resources for a new game session + * using the game session queue (set in the matchmaking configuration) and creates + * the game session based on the match data.

    + *
  8. + *
  9. + *

    When the match is successfully placed, the matchmaking tickets move into + * COMPLETED status. Connection information (including game + * session endpoint and player session) is added to the matchmaking tickets. + * Matched players can use the connection information to join the game.

    + *
  10. + *
+ *

+ * Learn more + *

+ *

+ * + * Add FlexMatch to a Game Client + *

+ *

+ * + * Set Up FlexMatch Event Notification + *

+ *

+ * + * FlexMatch Integration Roadmap + *

+ *

+ * + * How GameLift FlexMatch Works + *

+ *

+ * Related operations + *

+ * + */ export class StartMatchmakingCommand extends $Command< StartMatchmakingCommandInput, StartMatchmakingCommandOutput, @@ -34,6 +137,9 @@ export class StartMatchmakingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/StopFleetActionsCommand.ts b/clients/client-gamelift/commands/StopFleetActionsCommand.ts index 73ab99e25dba1..ed61461f30878 100644 --- a/clients/client-gamelift/commands/StopFleetActionsCommand.ts +++ b/clients/client-gamelift/commands/StopFleetActionsCommand.ts @@ -20,6 +20,55 @@ import { export type StopFleetActionsCommandInput = StopFleetActionsInput; export type StopFleetActionsCommandOutput = StopFleetActionsOutput & __MetadataBearer; +/** + *

Suspends activity on a fleet. Currently, this operation is used to stop a fleet's + * auto-scaling activity. It is used to temporarily stop triggering scaling events. The + * policies can be retained and auto-scaling activity can be restarted using StartFleetActions. You can view a fleet's stopped actions using DescribeFleetAttributes.

+ *

To stop fleet actions, specify the fleet ID and the type of actions to suspend. When + * auto-scaling fleet actions are stopped, Amazon GameLift no longer initiates scaling events except + * in response to manual changes using UpdateFleetCapacity.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class StopFleetActionsCommand extends $Command< StopFleetActionsCommandInput, StopFleetActionsCommandOutput, @@ -34,6 +83,9 @@ export class StopFleetActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/StopGameSessionPlacementCommand.ts b/clients/client-gamelift/commands/StopGameSessionPlacementCommand.ts index 1909a5816db8b..9969deab9c527 100644 --- a/clients/client-gamelift/commands/StopGameSessionPlacementCommand.ts +++ b/clients/client-gamelift/commands/StopGameSessionPlacementCommand.ts @@ -20,6 +20,63 @@ import { export type StopGameSessionPlacementCommandInput = StopGameSessionPlacementInput; export type StopGameSessionPlacementCommandOutput = StopGameSessionPlacementOutput & __MetadataBearer; +/** + *

Cancels a game session placement that is in PENDING status. To stop a + * placement, provide the placement ID values. If successful, the placement is moved to + * CANCELLED status.

+ * + */ export class StopGameSessionPlacementCommand extends $Command< StopGameSessionPlacementCommandInput, StopGameSessionPlacementCommandOutput, @@ -34,6 +91,9 @@ export class StopGameSessionPlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/StopMatchmakingCommand.ts b/clients/client-gamelift/commands/StopMatchmakingCommand.ts index 45f5375e9e295..1c24266dcb344 100644 --- a/clients/client-gamelift/commands/StopMatchmakingCommand.ts +++ b/clients/client-gamelift/commands/StopMatchmakingCommand.ts @@ -20,6 +20,57 @@ import { export type StopMatchmakingCommandInput = StopMatchmakingInput; export type StopMatchmakingCommandOutput = StopMatchmakingOutput & __MetadataBearer; +/** + *

Cancels a matchmaking ticket or match backfill ticket that is currently being + * processed. To stop the matchmaking operation, specify the ticket ID. If successful, work + * on the ticket is stopped, and the ticket status is changed to + * CANCELLED.

+ *

This call is also used to turn off automatic backfill for an individual game session. + * This is for game sessions that are created with a matchmaking configuration that has + * automatic backfill enabled. The ticket ID is included in the MatchmakerData + * of an updated game session object, which is provided to the game server.

+ * + *

If the operation is successful, the service sends back an empty JSON struct with the HTTP 200 response + * (not an empty HTTP body).

+ *
+ *

+ * Learn more + *

+ *

+ * + * Add FlexMatch to a Game Client + *

+ *

+ * Related operations + *

+ * + */ export class StopMatchmakingCommand extends $Command< StopMatchmakingCommandInput, StopMatchmakingCommandOutput, @@ -34,6 +85,9 @@ export class StopMatchmakingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/SuspendGameServerGroupCommand.ts b/clients/client-gamelift/commands/SuspendGameServerGroupCommand.ts index e53709d8c3c4a..1807229eddb81 100644 --- a/clients/client-gamelift/commands/SuspendGameServerGroupCommand.ts +++ b/clients/client-gamelift/commands/SuspendGameServerGroupCommand.ts @@ -20,6 +20,81 @@ import { export type SuspendGameServerGroupCommandInput = SuspendGameServerGroupInput; export type SuspendGameServerGroupCommandOutput = SuspendGameServerGroupOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Temporarily stops activity on a game server group without terminating instances or the + * game server group. You can restart activity by calling ResumeGameServerGroup. You can suspend the following activity:

+ *
    + *
  • + *

    + * Instance type replacement - This activity + * evaluates the current game hosting viability of all Spot instance types that are + * defined for the game server group. It updates the Auto Scaling group to remove + * nonviable Spot Instance types, which have a higher chance of game server + * interruptions. It then balances capacity across the remaining viable Spot + * Instance types. When this activity is suspended, the Auto Scaling group + * continues with its current balance, regardless of viability. Instance + * protection, utilization metrics, and capacity scaling activities continue to be + * active.

    + *
  • + *
+ *

To suspend activity, specify a game server group ARN and the type of activity to be + * suspended. If successful, a GameServerGroup object is returned showing + * that the activity is listed in SuspendedActions.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class SuspendGameServerGroupCommand extends $Command< SuspendGameServerGroupCommandInput, SuspendGameServerGroupCommandOutput, @@ -34,6 +109,9 @@ export class SuspendGameServerGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/TagResourceCommand.ts b/clients/client-gamelift/commands/TagResourceCommand.ts index 9b568f9debb71..682e8ce3afaef 100644 --- a/clients/client-gamelift/commands/TagResourceCommand.ts +++ b/clients/client-gamelift/commands/TagResourceCommand.ts @@ -20,6 +20,70 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Assigns a tag to a GameLift resource. AWS resource tags provide an additional + * management tool set. You can use tags to organize resources, create IAM permissions + * policies to manage access to groups of resources, customize AWS cost breakdowns, etc. + * This operation handles the permissions necessary to manage tags for the following GameLift + * resource types:

+ *
    + *
  • + *

    Build

    + *
  • + *
  • + *

    Script

    + *
  • + *
  • + *

    Fleet

    + *
  • + *
  • + *

    Alias

    + *
  • + *
  • + *

    GameSessionQueue

    + *
  • + *
  • + *

    MatchmakingConfiguration

    + *
  • + *
  • + *

    MatchmakingRuleSet

    + *
  • + *
+ *

To add a tag to a resource, specify the unique ARN value for the resource and provide + * a tag list containing one or more tags. The operation succeeds even if the list includes + * tags that are already assigned to the specified resource.

+ *

+ * Learn more + *

+ *

+ * Tagging AWS Resources in the + * AWS General Reference + *

+ *

+ * + * AWS Tagging Strategies + *

+ *

+ * Related operations + *

+ * + */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +98,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UntagResourceCommand.ts b/clients/client-gamelift/commands/UntagResourceCommand.ts index f2a6ea08b05e9..b4bd06fa97d79 100644 --- a/clients/client-gamelift/commands/UntagResourceCommand.ts +++ b/clients/client-gamelift/commands/UntagResourceCommand.ts @@ -20,6 +20,70 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag that is assigned to a GameLift resource. + * Resource tags are used to organize AWS resources for a range of purposes. + * This operation handles the permissions necessary to manage tags for the following + * GameLift resource types:

+ *
    + *
  • + *

    Build

    + *
  • + *
  • + *

    Script

    + *
  • + *
  • + *

    Fleet

    + *
  • + *
  • + *

    Alias

    + *
  • + *
  • + *

    GameSessionQueue

    + *
  • + *
  • + *

    MatchmakingConfiguration

    + *
  • + *
  • + *

    MatchmakingRuleSet

    + *
  • + *
+ *

To remove a tag from a resource, specify the unique ARN value for the resource and provide + * a string list containing one or more tags to be removed. + * This operation succeeds even if the list includes tags that are not currently assigned to the + * specified resource.

+ *

+ * Learn more + *

+ *

+ * Tagging AWS Resources in the + * AWS General Reference + *

+ *

+ * + * AWS Tagging Strategies + *

+ *

+ * Related operations + *

+ * + */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +98,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateAliasCommand.ts b/clients/client-gamelift/commands/UpdateAliasCommand.ts index a963ce97fb371..45a18b6eb1c9a 100644 --- a/clients/client-gamelift/commands/UpdateAliasCommand.ts +++ b/clients/client-gamelift/commands/UpdateAliasCommand.ts @@ -20,6 +20,44 @@ import { export type UpdateAliasCommandInput = UpdateAliasInput; export type UpdateAliasCommandOutput = UpdateAliasOutput & __MetadataBearer; +/** + *

Updates properties for an alias. To update properties, specify the alias ID to be + * updated and provide the information to be changed. To reassign an alias to another + * fleet, provide an updated routing strategy. If successful, the updated alias record is + * returned.

+ * + */ export class UpdateAliasCommand extends $Command< UpdateAliasCommandInput, UpdateAliasCommandOutput, @@ -34,6 +72,9 @@ export class UpdateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateBuildCommand.ts b/clients/client-gamelift/commands/UpdateBuildCommand.ts index 470c868bc996d..158eee4d2ae3d 100644 --- a/clients/client-gamelift/commands/UpdateBuildCommand.ts +++ b/clients/client-gamelift/commands/UpdateBuildCommand.ts @@ -20,6 +20,48 @@ import { export type UpdateBuildCommandInput = UpdateBuildInput; export type UpdateBuildCommandOutput = UpdateBuildOutput & __MetadataBearer; +/** + *

Updates metadata in a build resource, including the build name and version. To update + * the metadata, specify the build ID to update and provide the new values. If successful, + * a build object containing the updated metadata is returned.

+ *

+ * Learn more + *

+ *

+ * + * Upload a Custom Server Build + *

+ *

+ * Related operations + *

+ * + */ export class UpdateBuildCommand extends $Command< UpdateBuildCommandInput, UpdateBuildCommandOutput, @@ -34,6 +76,9 @@ export class UpdateBuildCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateFleetAttributesCommand.ts b/clients/client-gamelift/commands/UpdateFleetAttributesCommand.ts index 0010641a748e3..6e1d2d2e4dc4f 100644 --- a/clients/client-gamelift/commands/UpdateFleetAttributesCommand.ts +++ b/clients/client-gamelift/commands/UpdateFleetAttributesCommand.ts @@ -20,6 +20,72 @@ import { export type UpdateFleetAttributesCommandInput = UpdateFleetAttributesInput; export type UpdateFleetAttributesCommandOutput = UpdateFleetAttributesOutput & __MetadataBearer; +/** + *

Updates fleet properties, including name and description, for a fleet. To update + * metadata, specify the fleet ID and the property values that you want to change. If + * successful, the fleet ID for the updated fleet is returned.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class UpdateFleetAttributesCommand extends $Command< UpdateFleetAttributesCommandInput, UpdateFleetAttributesCommandOutput, @@ -34,6 +100,9 @@ export class UpdateFleetAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateFleetCapacityCommand.ts b/clients/client-gamelift/commands/UpdateFleetCapacityCommand.ts index cb35b0a1fe12a..254b7383654c0 100644 --- a/clients/client-gamelift/commands/UpdateFleetCapacityCommand.ts +++ b/clients/client-gamelift/commands/UpdateFleetCapacityCommand.ts @@ -20,6 +20,83 @@ import { export type UpdateFleetCapacityCommandInput = UpdateFleetCapacityInput; export type UpdateFleetCapacityCommandOutput = UpdateFleetCapacityOutput & __MetadataBearer; +/** + *

Updates capacity settings for a fleet. Use this operation to specify the number of + * EC2 instances (hosts) that you want this fleet to contain. Before calling this operation, + * you may want to call DescribeEC2InstanceLimits to get the maximum + * capacity based on the fleet's EC2 instance type.

+ *

Specify minimum and maximum number of instances. Amazon GameLift will not change fleet + * capacity to values fall outside of this range. This is particularly important when using + * auto-scaling (see PutScalingPolicy) to allow capacity to adjust based + * on player demand while imposing limits on automatic adjustments.

+ *

To update fleet capacity, specify the fleet ID and the number of instances you want + * the fleet to host. If successful, Amazon GameLift starts or terminates instances so that the + * fleet's active instance count matches the desired instance count. You can view a fleet's + * current capacity information by calling DescribeFleetCapacity. If the + * desired instance count is higher than the instance type's limit, the "Limit Exceeded" + * exception occurs.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class UpdateFleetCapacityCommand extends $Command< UpdateFleetCapacityCommandInput, UpdateFleetCapacityCommandOutput, @@ -34,6 +111,9 @@ export class UpdateFleetCapacityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateFleetPortSettingsCommand.ts b/clients/client-gamelift/commands/UpdateFleetPortSettingsCommand.ts index be8e8b5cbd471..b10be2fe7065b 100644 --- a/clients/client-gamelift/commands/UpdateFleetPortSettingsCommand.ts +++ b/clients/client-gamelift/commands/UpdateFleetPortSettingsCommand.ts @@ -20,6 +20,75 @@ import { export type UpdateFleetPortSettingsCommandInput = UpdateFleetPortSettingsInput; export type UpdateFleetPortSettingsCommandOutput = UpdateFleetPortSettingsOutput & __MetadataBearer; +/** + *

Updates port settings for a fleet. To update settings, specify the fleet ID to be + * updated and list the permissions you want to update. List the permissions you want to + * add in InboundPermissionAuthorizations, and permissions you want to remove + * in InboundPermissionRevocations. Permissions to be removed must match + * existing fleet permissions. If successful, the fleet ID for the updated fleet is + * returned.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class UpdateFleetPortSettingsCommand extends $Command< UpdateFleetPortSettingsCommandInput, UpdateFleetPortSettingsCommandOutput, @@ -34,6 +103,9 @@ export class UpdateFleetPortSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateGameServerCommand.ts b/clients/client-gamelift/commands/UpdateGameServerCommand.ts index dd083dc107b6a..a5d08600e2e4a 100644 --- a/clients/client-gamelift/commands/UpdateGameServerCommand.ts +++ b/clients/client-gamelift/commands/UpdateGameServerCommand.ts @@ -20,6 +20,77 @@ import { export type UpdateGameServerCommandInput = UpdateGameServerInput; export type UpdateGameServerCommandOutput = UpdateGameServerOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Updates information about a registered game server to help GameLift FleetIQ to track game server + * availability. This operation is called by a game server process that is running on an + * instance in a game server group.

+ *

Use this operation to update the following types of game server information. You can + * make all three types of updates in the same request:

+ *
    + *
  • + *

    To update the game server's utilization status, identify the game server and game server group + * and specify the current utilization status. Use this status to identify when + * game servers are currently hosting games and when they are available to be + * claimed.

    + *
  • + *
  • + *

    To report health status, identify the game server and game server group and set health check + * to HEALTHY. If a game server does not report health status for a + * certain length of time, the game server is no longer considered healthy. As a + * result, it will be eventually deregistered from the game server group to avoid + * affecting utilization metrics. The best practice is to report health every 60 + * seconds.

    + *
  • + *
  • + *

    To change game server metadata, provide updated game server data.

    + *
  • + *
+ *

Once a game server is successfully updated, the relevant statuses and timestamps are updated.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ *

+ * Related operations + *

+ * + */ export class UpdateGameServerCommand extends $Command< UpdateGameServerCommandInput, UpdateGameServerCommandOutput, @@ -34,6 +105,9 @@ export class UpdateGameServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateGameServerGroupCommand.ts b/clients/client-gamelift/commands/UpdateGameServerGroupCommand.ts index ec0c6f8ca84fc..a28ed057b7112 100644 --- a/clients/client-gamelift/commands/UpdateGameServerGroupCommand.ts +++ b/clients/client-gamelift/commands/UpdateGameServerGroupCommand.ts @@ -20,6 +20,69 @@ import { export type UpdateGameServerGroupCommandInput = UpdateGameServerGroupInput; export type UpdateGameServerGroupCommandOutput = UpdateGameServerGroupOutput & __MetadataBearer; +/** + *

+ * This operation is used with the Amazon GameLift FleetIQ solution and game server groups. + *

+ *

Updates GameLift FleetIQ-specific properties for a game server group. Many Auto Scaling group + * properties are updated on the Auto Scaling group directly, including the launch + * template, Auto Scaling policies, and maximum/minimum/desired instance counts.

+ *

To update the game server group, specify the game server group ID and provide the + * updated values. Before applying the updates, the new values are validated to ensure that + * GameLift FleetIQ can continue to perform instance balancing activity. If successful, a GameServerGroup object is returned.

+ *

+ * Learn more + *

+ *

+ * GameLift FleetIQ Guide + *

+ * + *

+ * Related operations + *

+ * + */ export class UpdateGameServerGroupCommand extends $Command< UpdateGameServerGroupCommandInput, UpdateGameServerGroupCommandOutput, @@ -34,6 +97,9 @@ export class UpdateGameServerGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateGameSessionCommand.ts b/clients/client-gamelift/commands/UpdateGameSessionCommand.ts index a2af655b3174b..dd4f703ff83bf 100644 --- a/clients/client-gamelift/commands/UpdateGameSessionCommand.ts +++ b/clients/client-gamelift/commands/UpdateGameSessionCommand.ts @@ -20,6 +20,66 @@ import { export type UpdateGameSessionCommandInput = UpdateGameSessionInput; export type UpdateGameSessionCommandOutput = UpdateGameSessionOutput & __MetadataBearer; +/** + *

Updates game session properties. This includes the session name, maximum player + * count, protection policy, which controls whether or not an active game session can be + * terminated during a scale-down event, and the player session creation policy, which + * controls whether or not new players can join the session. To update a game session, + * specify the game session ID and the values you want to change. If successful, an updated + * GameSession object is returned.

+ * + */ export class UpdateGameSessionCommand extends $Command< UpdateGameSessionCommandInput, UpdateGameSessionCommandOutput, @@ -34,6 +94,9 @@ export class UpdateGameSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateGameSessionQueueCommand.ts b/clients/client-gamelift/commands/UpdateGameSessionQueueCommand.ts index 245da2e8b82be..d1091ae02c7c3 100644 --- a/clients/client-gamelift/commands/UpdateGameSessionQueueCommand.ts +++ b/clients/client-gamelift/commands/UpdateGameSessionQueueCommand.ts @@ -20,6 +20,44 @@ import { export type UpdateGameSessionQueueCommandInput = UpdateGameSessionQueueInput; export type UpdateGameSessionQueueCommandOutput = UpdateGameSessionQueueOutput & __MetadataBearer; +/** + *

Updates settings for a game session queue, which determines how new game session + * requests in the queue are processed. To update settings, specify the queue name to be + * updated and provide the new settings. When updating destinations, provide a complete + * list of destinations.

+ *

+ * Learn more + *

+ *

+ * + * Using Multi-Region Queues + *

+ *

+ * Related operations + *

+ * + */ export class UpdateGameSessionQueueCommand extends $Command< UpdateGameSessionQueueCommandInput, UpdateGameSessionQueueCommandOutput, @@ -34,6 +72,9 @@ export class UpdateGameSessionQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateMatchmakingConfigurationCommand.ts b/clients/client-gamelift/commands/UpdateMatchmakingConfigurationCommand.ts index e440f23b957ec..7645beb9cd9ae 100644 --- a/clients/client-gamelift/commands/UpdateMatchmakingConfigurationCommand.ts +++ b/clients/client-gamelift/commands/UpdateMatchmakingConfigurationCommand.ts @@ -20,6 +20,63 @@ import { export type UpdateMatchmakingConfigurationCommandInput = UpdateMatchmakingConfigurationInput; export type UpdateMatchmakingConfigurationCommandOutput = UpdateMatchmakingConfigurationOutput & __MetadataBearer; +/** + *

Updates settings for a FlexMatch matchmaking configuration. These changes affect all matches and game sessions + * that are created after the update. To update settings, + * specify the configuration name to be updated and provide the new settings.

+ *

+ * Learn more + *

+ *

+ * + * Design a FlexMatch Matchmaker + *

+ *

+ * Related operations + *

+ * + */ export class UpdateMatchmakingConfigurationCommand extends $Command< UpdateMatchmakingConfigurationCommandInput, UpdateMatchmakingConfigurationCommandOutput, @@ -34,6 +91,9 @@ export class UpdateMatchmakingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateRuntimeConfigurationCommand.ts b/clients/client-gamelift/commands/UpdateRuntimeConfigurationCommand.ts index 54f2d6cf67cd5..469948822ce8d 100644 --- a/clients/client-gamelift/commands/UpdateRuntimeConfigurationCommand.ts +++ b/clients/client-gamelift/commands/UpdateRuntimeConfigurationCommand.ts @@ -20,6 +20,81 @@ import { export type UpdateRuntimeConfigurationCommandInput = UpdateRuntimeConfigurationInput; export type UpdateRuntimeConfigurationCommandOutput = UpdateRuntimeConfigurationOutput & __MetadataBearer; +/** + *

Updates the current runtime configuration for the specified fleet, which tells Amazon GameLift + * how to launch server processes on instances in the fleet. You can update a fleet's + * runtime configuration at any time after the fleet is created; it does not need to be in + * an ACTIVE status.

+ *

To update runtime configuration, specify the fleet ID and provide a + * RuntimeConfiguration object with an updated set of server process + * configurations.

+ *

Each instance in a Amazon GameLift fleet checks regularly for an updated runtime configuration + * and changes how it launches server processes to comply with the latest version. Existing + * server processes are not affected by the update; runtime configuration changes are + * applied gradually as existing processes shut down and new processes are launched during + * Amazon GameLift's normal process recycling activity.

+ *

+ * Learn more + *

+ *

+ * Setting up GameLift Fleets + *

+ *

+ * Related operations + *

+ * + */ export class UpdateRuntimeConfigurationCommand extends $Command< UpdateRuntimeConfigurationCommandInput, UpdateRuntimeConfigurationCommandOutput, @@ -34,6 +109,9 @@ export class UpdateRuntimeConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/UpdateScriptCommand.ts b/clients/client-gamelift/commands/UpdateScriptCommand.ts index 2aaba638d2523..9eb8856957677 100644 --- a/clients/client-gamelift/commands/UpdateScriptCommand.ts +++ b/clients/client-gamelift/commands/UpdateScriptCommand.ts @@ -20,6 +20,54 @@ import { export type UpdateScriptCommandInput = UpdateScriptInput; export type UpdateScriptCommandOutput = UpdateScriptOutput & __MetadataBearer; +/** + *

Updates Realtime script metadata and content.

+ *

To update script metadata, specify the script ID and provide updated name and/or + * version values.

+ *

To update script content, provide an updated zip file by pointing to either a local + * file or an Amazon S3 bucket location. You can use either method regardless of how the + * original script was uploaded. Use the Version parameter to track + * updates to the script.

+ *

If the call is successful, the updated metadata is stored in the script record and a + * revised script is uploaded to the Amazon GameLift service. Once the script is updated and + * acquired by a fleet instance, the new version is used for all new game sessions.

+ *

+ * Learn more + *

+ *

+ * Amazon GameLift Realtime Servers + *

+ *

+ * Related operations + *

+ * + */ export class UpdateScriptCommand extends $Command< UpdateScriptCommandInput, UpdateScriptCommandOutput, @@ -34,6 +82,9 @@ export class UpdateScriptCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/commands/ValidateMatchmakingRuleSetCommand.ts b/clients/client-gamelift/commands/ValidateMatchmakingRuleSetCommand.ts index c2e1907d13e13..ae428506868d0 100644 --- a/clients/client-gamelift/commands/ValidateMatchmakingRuleSetCommand.ts +++ b/clients/client-gamelift/commands/ValidateMatchmakingRuleSetCommand.ts @@ -20,6 +20,67 @@ import { export type ValidateMatchmakingRuleSetCommandInput = ValidateMatchmakingRuleSetInput; export type ValidateMatchmakingRuleSetCommandOutput = ValidateMatchmakingRuleSetOutput & __MetadataBearer; +/** + *

Validates the syntax of a matchmaking rule or rule set. This operation checks that + * the rule set is using syntactically correct JSON and that it conforms to allowed + * property expressions. To validate syntax, provide a rule set JSON string.

+ *

+ * Learn more + *

+ * + *

+ * Related operations + *

+ * + */ export class ValidateMatchmakingRuleSetCommand extends $Command< ValidateMatchmakingRuleSetCommandInput, ValidateMatchmakingRuleSetCommandOutput, @@ -34,6 +95,9 @@ export class ValidateMatchmakingRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GameLiftClientResolvedConfig, diff --git a/clients/client-gamelift/package.json b/clients/client-gamelift/package.json index 66717074f0317..bf538cbb09d52 100644 --- a/clients/client-gamelift/package.json +++ b/clients/client-gamelift/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Gamelift Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-gamelift/pagination/DescribeFleetAttributesPaginator.ts b/clients/client-gamelift/pagination/DescribeFleetAttributesPaginator.ts index 10dc7eb1574b0..4c06b8ce3105e 100644 --- a/clients/client-gamelift/pagination/DescribeFleetAttributesPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeFleetAttributesPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeFleetAttributesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFleetAttributesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeFleetAttributesCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeFleetCapacityPaginator.ts b/clients/client-gamelift/pagination/DescribeFleetCapacityPaginator.ts index 3b6dd75073032..b9e301849168f 100644 --- a/clients/client-gamelift/pagination/DescribeFleetCapacityPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeFleetCapacityPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeFleetCapacityCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFleetCapacityCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeFleetCapacityCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeFleetEventsPaginator.ts b/clients/client-gamelift/pagination/DescribeFleetEventsPaginator.ts index 1dd80236e3ece..1c66be86868ec 100644 --- a/clients/client-gamelift/pagination/DescribeFleetEventsPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeFleetEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeFleetEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFleetEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeFleetEventsCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeFleetUtilizationPaginator.ts b/clients/client-gamelift/pagination/DescribeFleetUtilizationPaginator.ts index f4cbaf30f096c..a075129d73fa4 100644 --- a/clients/client-gamelift/pagination/DescribeFleetUtilizationPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeFleetUtilizationPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeFleetUtilizationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFleetUtilizationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeFleetUtilizationCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeGameServerInstancesPaginator.ts b/clients/client-gamelift/pagination/DescribeGameServerInstancesPaginator.ts index 218c57065bd20..7cfd81cd8a7d4 100644 --- a/clients/client-gamelift/pagination/DescribeGameServerInstancesPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeGameServerInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeGameServerInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeGameServerInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeGameServerInstancesCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeGameSessionDetailsPaginator.ts b/clients/client-gamelift/pagination/DescribeGameSessionDetailsPaginator.ts index c4fdf386c99cf..c8a778c2afcfd 100644 --- a/clients/client-gamelift/pagination/DescribeGameSessionDetailsPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeGameSessionDetailsPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeGameSessionDetailsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeGameSessionDetailsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeGameSessionDetailsCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeGameSessionQueuesPaginator.ts b/clients/client-gamelift/pagination/DescribeGameSessionQueuesPaginator.ts index 166a20ffb1db9..fd03fd1791624 100644 --- a/clients/client-gamelift/pagination/DescribeGameSessionQueuesPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeGameSessionQueuesPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeGameSessionQueuesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeGameSessionQueuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeGameSessionQueuesCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeGameSessionsPaginator.ts b/clients/client-gamelift/pagination/DescribeGameSessionsPaginator.ts index f553722dd3d39..de4d71f046d63 100644 --- a/clients/client-gamelift/pagination/DescribeGameSessionsPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeGameSessionsPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeGameSessionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeGameSessionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeGameSessionsCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeInstancesPaginator.ts b/clients/client-gamelift/pagination/DescribeInstancesPaginator.ts index 60482965d3884..b768769cb182f 100644 --- a/clients/client-gamelift/pagination/DescribeInstancesPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeInstancesCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeMatchmakingConfigurationsPaginator.ts b/clients/client-gamelift/pagination/DescribeMatchmakingConfigurationsPaginator.ts index 071feb3200e33..8bcfe34145b6a 100644 --- a/clients/client-gamelift/pagination/DescribeMatchmakingConfigurationsPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeMatchmakingConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeMatchmakingConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMatchmakingConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeMatchmakingConfigurationsCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeMatchmakingRuleSetsPaginator.ts b/clients/client-gamelift/pagination/DescribeMatchmakingRuleSetsPaginator.ts index 698b38b870e6b..18a96bc2c4341 100644 --- a/clients/client-gamelift/pagination/DescribeMatchmakingRuleSetsPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeMatchmakingRuleSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeMatchmakingRuleSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMatchmakingRuleSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeMatchmakingRuleSetsCommandInput, diff --git a/clients/client-gamelift/pagination/DescribePlayerSessionsPaginator.ts b/clients/client-gamelift/pagination/DescribePlayerSessionsPaginator.ts index 16498e2c0c004..b12fea1a889c5 100644 --- a/clients/client-gamelift/pagination/DescribePlayerSessionsPaginator.ts +++ b/clients/client-gamelift/pagination/DescribePlayerSessionsPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribePlayerSessionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePlayerSessionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribePlayerSessionsCommandInput, diff --git a/clients/client-gamelift/pagination/DescribeScalingPoliciesPaginator.ts b/clients/client-gamelift/pagination/DescribeScalingPoliciesPaginator.ts index 837bc24de9889..0f9e98063bacf 100644 --- a/clients/client-gamelift/pagination/DescribeScalingPoliciesPaginator.ts +++ b/clients/client-gamelift/pagination/DescribeScalingPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: DescribeScalingPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScalingPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: DescribeScalingPoliciesCommandInput, diff --git a/clients/client-gamelift/pagination/ListAliasesPaginator.ts b/clients/client-gamelift/pagination/ListAliasesPaginator.ts index 6073171edad74..f3116d0cdabe4 100644 --- a/clients/client-gamelift/pagination/ListAliasesPaginator.ts +++ b/clients/client-gamelift/pagination/ListAliasesPaginator.ts @@ -4,6 +4,9 @@ import { ListAliasesCommand, ListAliasesCommandInput, ListAliasesCommandOutput } import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: ListAliasesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: ListAliasesCommandInput, diff --git a/clients/client-gamelift/pagination/ListBuildsPaginator.ts b/clients/client-gamelift/pagination/ListBuildsPaginator.ts index 7073efb8e1e20..3636c48833ac4 100644 --- a/clients/client-gamelift/pagination/ListBuildsPaginator.ts +++ b/clients/client-gamelift/pagination/ListBuildsPaginator.ts @@ -4,6 +4,9 @@ import { ListBuildsCommand, ListBuildsCommandInput, ListBuildsCommandOutput } fr import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: ListBuildsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBuildsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: ListBuildsCommandInput, diff --git a/clients/client-gamelift/pagination/ListFleetsPaginator.ts b/clients/client-gamelift/pagination/ListFleetsPaginator.ts index 8e116c373480e..327a10d315c4c 100644 --- a/clients/client-gamelift/pagination/ListFleetsPaginator.ts +++ b/clients/client-gamelift/pagination/ListFleetsPaginator.ts @@ -4,6 +4,9 @@ import { ListFleetsCommand, ListFleetsCommandInput, ListFleetsCommandOutput } fr import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: ListFleetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFleetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: ListFleetsCommandInput, diff --git a/clients/client-gamelift/pagination/ListGameServerGroupsPaginator.ts b/clients/client-gamelift/pagination/ListGameServerGroupsPaginator.ts index 746bb66411f2c..c4ea43b82be46 100644 --- a/clients/client-gamelift/pagination/ListGameServerGroupsPaginator.ts +++ b/clients/client-gamelift/pagination/ListGameServerGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: ListGameServerGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGameServerGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: ListGameServerGroupsCommandInput, diff --git a/clients/client-gamelift/pagination/ListGameServersPaginator.ts b/clients/client-gamelift/pagination/ListGameServersPaginator.ts index 083c0c50a61fe..26218a2e1ca1d 100644 --- a/clients/client-gamelift/pagination/ListGameServersPaginator.ts +++ b/clients/client-gamelift/pagination/ListGameServersPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: ListGameServersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGameServersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: ListGameServersCommandInput, diff --git a/clients/client-gamelift/pagination/ListScriptsPaginator.ts b/clients/client-gamelift/pagination/ListScriptsPaginator.ts index d4bda4d771ae1..046378cf361d8 100644 --- a/clients/client-gamelift/pagination/ListScriptsPaginator.ts +++ b/clients/client-gamelift/pagination/ListScriptsPaginator.ts @@ -4,6 +4,9 @@ import { ListScriptsCommand, ListScriptsCommandInput, ListScriptsCommandOutput } import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: ListScriptsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListScriptsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: ListScriptsCommandInput, diff --git a/clients/client-gamelift/pagination/SearchGameSessionsPaginator.ts b/clients/client-gamelift/pagination/SearchGameSessionsPaginator.ts index 18fa727a31292..743dcacd29bee 100644 --- a/clients/client-gamelift/pagination/SearchGameSessionsPaginator.ts +++ b/clients/client-gamelift/pagination/SearchGameSessionsPaginator.ts @@ -8,6 +8,9 @@ import { import { GameLiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GameLiftClient, input: SearchGameSessionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchGameSessionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GameLift, input: SearchGameSessionsCommandInput, diff --git a/clients/client-gamelift/runtimeConfig.browser.ts b/clients/client-gamelift/runtimeConfig.browser.ts index a69589d16f5ab..6d07cfd14e54c 100644 --- a/clients/client-gamelift/runtimeConfig.browser.ts +++ b/clients/client-gamelift/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./GameLiftClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-gamelift/runtimeConfig.native.ts b/clients/client-gamelift/runtimeConfig.native.ts index 6ad68a4689568..2180707fe0555 100644 --- a/clients/client-gamelift/runtimeConfig.native.ts +++ b/clients/client-gamelift/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./GameLiftClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-gamelift/runtimeConfig.shared.ts b/clients/client-gamelift/runtimeConfig.shared.ts index ca97050bec016..39569afc2e9f5 100644 --- a/clients/client-gamelift/runtimeConfig.shared.ts +++ b/clients/client-gamelift/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-10-01", disableHostPrefix: false, diff --git a/clients/client-gamelift/runtimeConfig.ts b/clients/client-gamelift/runtimeConfig.ts index f45c5d3ce6d9c..30d6766730089 100644 --- a/clients/client-gamelift/runtimeConfig.ts +++ b/clients/client-gamelift/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./GameLiftClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-gamelift/tsconfig.json b/clients/client-gamelift/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-gamelift/tsconfig.json +++ b/clients/client-gamelift/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-glacier/commands/AbortMultipartUploadCommand.ts b/clients/client-glacier/commands/AbortMultipartUploadCommand.ts index 616070bc5f1ee..71926337272ed 100644 --- a/clients/client-glacier/commands/AbortMultipartUploadCommand.ts +++ b/clients/client-glacier/commands/AbortMultipartUploadCommand.ts @@ -20,6 +20,26 @@ import { export type AbortMultipartUploadCommandInput = AbortMultipartUploadInput; export type AbortMultipartUploadCommandOutput = __MetadataBearer; +/** + *

This operation aborts a multipart upload identified by the upload ID.

+ * + * + *

After the Abort Multipart Upload request succeeds, you cannot upload any more parts + * to the multipart upload or complete the multipart upload. Aborting a completed upload + * fails. However, aborting an already-aborted upload will succeed, for a short time. For more + * information about uploading a part and completing a multipart upload, see UploadMultipartPart and CompleteMultipartUpload.

+ * + *

This operation is idempotent.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Working with Archives in + * Amazon S3 Glacier and Abort Multipart + * Upload in the Amazon Glacier Developer Guide.

+ */ export class AbortMultipartUploadCommand extends $Command< AbortMultipartUploadCommandInput, AbortMultipartUploadCommandOutput, @@ -34,6 +54,9 @@ export class AbortMultipartUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/AbortVaultLockCommand.ts b/clients/client-glacier/commands/AbortVaultLockCommand.ts index 5f4e1fb2d2588..b29798c5237a8 100644 --- a/clients/client-glacier/commands/AbortVaultLockCommand.ts +++ b/clients/client-glacier/commands/AbortVaultLockCommand.ts @@ -20,6 +20,22 @@ import { export type AbortVaultLockCommandInput = AbortVaultLockInput; export type AbortVaultLockCommandOutput = __MetadataBearer; +/** + *

This operation aborts the vault locking process if the vault lock is not in the + * Locked state. If the vault lock is in the Locked state when + * this operation is requested, the operation returns an AccessDeniedException + * error. Aborting the vault locking process removes the vault lock policy from the specified + * vault.

+ *

A vault lock is put into the InProgress state by calling InitiateVaultLock. A vault lock is put into the Locked state by + * calling CompleteVaultLock. You can get the state of a vault lock by + * calling GetVaultLock. For more information about the vault locking + * process, see Amazon Glacier Vault Lock. For more information about vault lock policies, see + * Amazon + * Glacier Access Control with Vault Lock Policies.

+ *

This operation is idempotent. You can successfully invoke this operation multiple + * times, if the vault lock is in the InProgress state or if there is no policy + * associated with the vault.

+ */ export class AbortVaultLockCommand extends $Command< AbortVaultLockCommandInput, AbortVaultLockCommandOutput, @@ -34,6 +50,9 @@ export class AbortVaultLockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/AddTagsToVaultCommand.ts b/clients/client-glacier/commands/AddTagsToVaultCommand.ts index 6cf995f4e1ffc..0fcc8902bc6e4 100644 --- a/clients/client-glacier/commands/AddTagsToVaultCommand.ts +++ b/clients/client-glacier/commands/AddTagsToVaultCommand.ts @@ -20,6 +20,14 @@ import { export type AddTagsToVaultCommandInput = AddTagsToVaultInput; export type AddTagsToVaultCommandOutput = __MetadataBearer; +/** + *

This operation adds the specified tags to a vault. Each tag is composed of a key and + * a value. Each vault can have up to 10 tags. If your request would cause the tag limit for + * the vault to be exceeded, the operation throws the LimitExceededException + * error. If a tag already exists on the vault under a specified key, the existing key value + * will be overwritten. For more information about tags, see Tagging Amazon S3 Glacier Resources. + *

+ */ export class AddTagsToVaultCommand extends $Command< AddTagsToVaultCommandInput, AddTagsToVaultCommandOutput, @@ -34,6 +42,9 @@ export class AddTagsToVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/CompleteMultipartUploadCommand.ts b/clients/client-glacier/commands/CompleteMultipartUploadCommand.ts index f69f486468020..5eefdb47d19d8 100644 --- a/clients/client-glacier/commands/CompleteMultipartUploadCommand.ts +++ b/clients/client-glacier/commands/CompleteMultipartUploadCommand.ts @@ -20,6 +20,46 @@ import { export type CompleteMultipartUploadCommandInput = CompleteMultipartUploadInput; export type CompleteMultipartUploadCommandOutput = ArchiveCreationOutput & __MetadataBearer; +/** + *

You call this operation to inform Amazon S3 Glacier (Glacier) that all the archive parts have been + * uploaded and that Glacier can now assemble the archive from the uploaded parts. + * After assembling and saving the archive to the vault, Glacier returns the URI path + * of the newly created archive resource. Using the URI path, you can then access the archive. + * After you upload an archive, you should save the archive ID returned to retrieve the + * archive at a later point. You can also get the vault inventory to obtain a list of archive + * IDs in a vault. For more information, see InitiateJob.

+ * + *

In the request, you must include the computed SHA256 tree hash of the entire archive + * you have uploaded. For information about computing a SHA256 tree hash, see Computing + * Checksums. On the server side, Glacier also constructs the SHA256 tree + * hash of the assembled archive. If the values match, Glacier saves the archive to the + * vault; otherwise, it returns an error, and the operation fails. The ListParts operation returns a list of parts uploaded for a specific + * multipart upload. It includes checksum information for each uploaded part that can be used + * to debug a bad checksum issue.

+ * + *

Additionally, Glacier also checks for any missing content ranges when + * assembling the archive, if missing content ranges are found, Glacier returns an + * error and the operation fails.

+ * + *

Complete Multipart Upload is an idempotent operation. After your first successful + * complete multipart upload, if you call the operation again within a short period, the + * operation will succeed and return the same archive ID. This is useful in the event you + * experience a network issue that causes an aborted connection or receive a 500 server error, + * in which case you can repeat your Complete Multipart Upload request and get the same + * archive ID without creating duplicate archives. Note, however, that after the multipart + * upload completes, you cannot call the List Parts operation and the multipart upload will + * not appear in List Multipart Uploads response, even if idempotent complete is + * possible.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Uploading Large Archives in + * Parts (Multipart Upload) and Complete Multipart + * Upload in the Amazon Glacier Developer Guide.

+ */ export class CompleteMultipartUploadCommand extends $Command< CompleteMultipartUploadCommandInput, CompleteMultipartUploadCommandOutput, @@ -34,6 +74,9 @@ export class CompleteMultipartUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/CompleteVaultLockCommand.ts b/clients/client-glacier/commands/CompleteVaultLockCommand.ts index bc9b38e5a3437..1c4492f631ba8 100644 --- a/clients/client-glacier/commands/CompleteVaultLockCommand.ts +++ b/clients/client-glacier/commands/CompleteVaultLockCommand.ts @@ -20,6 +20,22 @@ import { export type CompleteVaultLockCommandInput = CompleteVaultLockInput; export type CompleteVaultLockCommandOutput = __MetadataBearer; +/** + *

This operation completes the vault locking process by transitioning the vault lock + * from the InProgress state to the Locked state, which causes the + * vault lock policy to become unchangeable. A vault lock is put into the + * InProgress state by calling InitiateVaultLock. You can + * obtain the state of the vault lock by calling GetVaultLock. For more + * information about the vault locking process, Amazon Glacier Vault Lock.

+ *

This operation is idempotent. This request is always successful if the vault lock is + * in the Locked state and the provided lock ID matches the lock ID originally + * used to lock the vault.

+ *

If an invalid lock ID is passed in the request when the vault lock is in the + * Locked state, the operation returns an AccessDeniedException + * error. If an invalid lock ID is passed in the request when the vault lock is in the + * InProgress state, the operation throws an InvalidParameter + * error.

+ */ export class CompleteVaultLockCommand extends $Command< CompleteVaultLockCommandInput, CompleteVaultLockCommandOutput, @@ -34,6 +50,9 @@ export class CompleteVaultLockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/CreateVaultCommand.ts b/clients/client-glacier/commands/CreateVaultCommand.ts index 8f8b3451e571b..57364be6ad846 100644 --- a/clients/client-glacier/commands/CreateVaultCommand.ts +++ b/clients/client-glacier/commands/CreateVaultCommand.ts @@ -20,6 +20,32 @@ import { export type CreateVaultCommandInput = CreateVaultInput; export type CreateVaultCommandOutput = CreateVaultOutput & __MetadataBearer; +/** + *

This operation creates a new vault with the specified name. The name of the vault + * must be unique within a region for an AWS account. You can create up to 1,000 vaults per + * account. If you need to create more vaults, contact Amazon S3 Glacier.

+ *

You must use the following guidelines when naming a vault.

+ *
    + *
  • + *

    Names can be between 1 and 255 characters long.

    + *
  • + *
  • + *

    Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), and '.' + * (period).

    + *
  • + *
+ * + *

This operation is idempotent.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Creating a Vault in Amazon + * Glacier and Create Vault in the + * Amazon Glacier Developer Guide.

+ */ export class CreateVaultCommand extends $Command< CreateVaultCommandInput, CreateVaultCommandOutput, @@ -34,6 +60,9 @@ export class CreateVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/DeleteArchiveCommand.ts b/clients/client-glacier/commands/DeleteArchiveCommand.ts index 4948321312f0a..656bcffc417dd 100644 --- a/clients/client-glacier/commands/DeleteArchiveCommand.ts +++ b/clients/client-glacier/commands/DeleteArchiveCommand.ts @@ -20,6 +20,35 @@ import { export type DeleteArchiveCommandInput = DeleteArchiveInput; export type DeleteArchiveCommandOutput = __MetadataBearer; +/** + *

This operation deletes an archive from a vault. Subsequent requests to initiate a + * retrieval of this archive will fail. Archive retrievals that are in progress for this + * archive ID may or may not succeed according to the following scenarios:

+ *
    + *
  • + *

    If the archive retrieval job is actively preparing the data for download when + * Amazon S3 Glacier receives the delete archive request, the archival retrieval operation + * might fail.

    + *
  • + *
  • + *

    If the archive retrieval job has successfully prepared the archive for download + * when Amazon S3 Glacier receives the delete archive request, you will be able to download + * the output.

    + *
  • + *
+ * + *

This operation is idempotent. Attempting to delete an already-deleted archive does + * not result in an error.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Deleting an Archive in Amazon + * Glacier and Delete Archive in the + * Amazon Glacier Developer Guide.

+ */ export class DeleteArchiveCommand extends $Command< DeleteArchiveCommandInput, DeleteArchiveCommandOutput, @@ -34,6 +63,9 @@ export class DeleteArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/DeleteVaultAccessPolicyCommand.ts b/clients/client-glacier/commands/DeleteVaultAccessPolicyCommand.ts index 1e778bf84b21d..2ad20ac7bcd9b 100644 --- a/clients/client-glacier/commands/DeleteVaultAccessPolicyCommand.ts +++ b/clients/client-glacier/commands/DeleteVaultAccessPolicyCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteVaultAccessPolicyCommandInput = DeleteVaultAccessPolicyInput; export type DeleteVaultAccessPolicyCommandOutput = __MetadataBearer; +/** + *

This operation deletes the access policy associated with the specified vault. The + * operation is eventually consistent; that is, it might take some time for Amazon S3 Glacier to + * completely remove the access policy, and you might still see the effect of the policy for a + * short time after you send the delete request.

+ *

This operation is idempotent. You can invoke delete multiple times, even if there is + * no policy associated with the vault. For more information about vault access policies, see + * Amazon Glacier Access Control with Vault Access Policies.

+ */ export class DeleteVaultAccessPolicyCommand extends $Command< DeleteVaultAccessPolicyCommandInput, DeleteVaultAccessPolicyCommandOutput, @@ -34,6 +43,9 @@ export class DeleteVaultAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/DeleteVaultCommand.ts b/clients/client-glacier/commands/DeleteVaultCommand.ts index 49db25237dac4..3c1a2235e7657 100644 --- a/clients/client-glacier/commands/DeleteVaultCommand.ts +++ b/clients/client-glacier/commands/DeleteVaultCommand.ts @@ -20,6 +20,28 @@ import { export type DeleteVaultCommandInput = DeleteVaultInput; export type DeleteVaultCommandOutput = __MetadataBearer; +/** + *

This operation deletes a vault. Amazon S3 Glacier will delete a vault only if there are + * no archives in the vault as of the last inventory and there have been no writes to the + * vault since the last inventory. If either of these conditions is not satisfied, the vault + * deletion fails (that is, the vault is not removed) and Amazon S3 Glacier returns an error. You + * can use DescribeVault to return the number of archives in a vault, and + * you can use Initiate a Job (POST + * jobs) to initiate a new inventory retrieval for a vault. The inventory contains + * the archive IDs you use to delete archives using Delete Archive (DELETE + * archive).

+ * + *

This operation is idempotent.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Deleting a Vault in Amazon + * Glacier and Delete Vault in the + * Amazon S3 Glacier Developer Guide.

+ */ export class DeleteVaultCommand extends $Command< DeleteVaultCommandInput, DeleteVaultCommandOutput, @@ -34,6 +56,9 @@ export class DeleteVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/DeleteVaultNotificationsCommand.ts b/clients/client-glacier/commands/DeleteVaultNotificationsCommand.ts index cf2b4b8400933..d2676718ecc4d 100644 --- a/clients/client-glacier/commands/DeleteVaultNotificationsCommand.ts +++ b/clients/client-glacier/commands/DeleteVaultNotificationsCommand.ts @@ -20,6 +20,21 @@ import { export type DeleteVaultNotificationsCommandInput = DeleteVaultNotificationsInput; export type DeleteVaultNotificationsCommandOutput = __MetadataBearer; +/** + *

This operation deletes the notification configuration set for a vault. The operation + * is eventually consistent; that is, it might take some time for Amazon S3 Glacier to completely + * disable the notifications and you might still receive some notifications for a short time + * after you send the delete request.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access + * Control Using AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Configuring Vault + * Notifications in Amazon S3 Glacier and Delete Vault + * Notification Configuration in the Amazon S3 Glacier Developer Guide.

+ */ export class DeleteVaultNotificationsCommand extends $Command< DeleteVaultNotificationsCommandInput, DeleteVaultNotificationsCommandOutput, @@ -34,6 +49,9 @@ export class DeleteVaultNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/DescribeJobCommand.ts b/clients/client-glacier/commands/DescribeJobCommand.ts index d5bd035efdf5a..c3838f7923e19 100644 --- a/clients/client-glacier/commands/DescribeJobCommand.ts +++ b/clients/client-glacier/commands/DescribeJobCommand.ts @@ -20,6 +20,32 @@ import { export type DescribeJobCommandInput = DescribeJobInput; export type DescribeJobCommandOutput = GlacierJobDescription & __MetadataBearer; +/** + *

This operation returns information about a job you previously initiated, including + * the job initiation date, the user who initiated the job, the job status code/message and + * the Amazon SNS topic to notify after Amazon S3 Glacier (Glacier) completes the job. For more information + * about initiating a job, see InitiateJob.

+ * + * + *

This operation enables you to check the status of your job. However, it is + * strongly recommended that you set up an Amazon SNS topic and specify it in your initiate + * job request so that Glacier can notify the topic after it completes the + * job.

+ *
+ * + *

A job ID will not expire for at least 24 hours after Glacier completes the + * job.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ * + *

For more information about using this operation, + * see the documentation for the underlying REST API Describe Job + * in the Amazon Glacier Developer Guide.

+ */ export class DescribeJobCommand extends $Command< DescribeJobCommandInput, DescribeJobCommandOutput, @@ -34,6 +60,9 @@ export class DescribeJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/DescribeVaultCommand.ts b/clients/client-glacier/commands/DescribeVaultCommand.ts index 190b7d9da3c34..2859ac4635a47 100644 --- a/clients/client-glacier/commands/DescribeVaultCommand.ts +++ b/clients/client-glacier/commands/DescribeVaultCommand.ts @@ -20,6 +20,26 @@ import { export type DescribeVaultCommandInput = DescribeVaultInput; export type DescribeVaultCommandOutput = DescribeVaultOutput & __MetadataBearer; +/** + *

This operation returns information about a vault, including the vault's Amazon + * Resource Name (ARN), the date the vault was created, the number of archives it contains, + * and the total size of all the archives in the vault. The number of archives and their total + * size are as of the last inventory generation. This means that if you add or remove an + * archive from a vault, and then immediately use Describe Vault, the change in contents will + * not be immediately reflected. If you want to retrieve the latest inventory of the vault, + * use InitiateJob. Amazon S3 Glacier generates vault inventories approximately + * daily. For more information, see Downloading a Vault Inventory in + * Amazon S3 Glacier.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Retrieving Vault Metadata in + * Amazon S3 Glacier and Describe Vault in the + * Amazon Glacier Developer Guide.

+ */ export class DescribeVaultCommand extends $Command< DescribeVaultCommandInput, DescribeVaultCommandOutput, @@ -34,6 +54,9 @@ export class DescribeVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/GetDataRetrievalPolicyCommand.ts b/clients/client-glacier/commands/GetDataRetrievalPolicyCommand.ts index 673f2a1d63eaf..c96f6779e96c5 100644 --- a/clients/client-glacier/commands/GetDataRetrievalPolicyCommand.ts +++ b/clients/client-glacier/commands/GetDataRetrievalPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type GetDataRetrievalPolicyCommandInput = GetDataRetrievalPolicyInput; export type GetDataRetrievalPolicyCommandOutput = GetDataRetrievalPolicyOutput & __MetadataBearer; +/** + *

This operation returns the current data retrieval policy for the account and region + * specified in the GET request. For more information about data retrieval policies, see + * Amazon Glacier Data Retrieval Policies.

+ */ export class GetDataRetrievalPolicyCommand extends $Command< GetDataRetrievalPolicyCommandInput, GetDataRetrievalPolicyCommandOutput, @@ -34,6 +39,9 @@ export class GetDataRetrievalPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/GetJobOutputCommand.ts b/clients/client-glacier/commands/GetJobOutputCommand.ts index 33bcf306e88a5..8381386342bf5 100644 --- a/clients/client-glacier/commands/GetJobOutputCommand.ts +++ b/clients/client-glacier/commands/GetJobOutputCommand.ts @@ -20,6 +20,45 @@ import { export type GetJobOutputCommandInput = GetJobOutputInput; export type GetJobOutputCommandOutput = GetJobOutputOutput & __MetadataBearer; +/** + *

This operation downloads the output of the job you initiated using InitiateJob. Depending on the job type you specified when you initiated the + * job, the output will be either the content of an archive or a vault inventory.

+ * + *

You can download all the job output or download a portion of the output by specifying + * a byte range. In the case of an archive retrieval job, depending on the byte range you + * specify, Amazon S3 Glacier (Glacier) returns the checksum for the portion of the data. You can compute the + * checksum on the client and verify that the values match to ensure the portion you downloaded + * is the correct data.

+ *

A job ID will not expire for at least 24 hours after Glacier completes the job. That + * a byte range. For both archive and inventory retrieval jobs, you should verify the downloaded + * size against the size returned in the headers from the + * Get Job Output response.

+ *

For archive retrieval jobs, you should also verify that the size is what you expected. If + * you download a portion of the output, the expected size is based on the range of bytes + * you specified. For example, if you specify a range of bytes=0-1048575, you should + * verify your download size is 1,048,576 bytes. If you download an entire archive, the + * expected size is the size of the archive when you uploaded it to Amazon S3 Glacier + * The expected size is also returned in the headers from the + * Get Job Output response.

+ *

In the case of an archive retrieval job, depending on the byte range you + * specify, Glacier returns the checksum for the portion of the data. To ensure the portion you downloaded + * is the correct data, compute the checksum on the client, verify that the values match, + * and verify that the size is what you expected.

+ * + *

A job ID does not expire for at least 24 hours after Glacier completes the + * job. That is, you can download the job output within the 24 hours period after Amazon + * Glacier completes the job.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and the underlying REST API, see Downloading a + * Vault Inventory, Downloading an + * Archive, and Get Job Output + *

+ */ export class GetJobOutputCommand extends $Command< GetJobOutputCommandInput, GetJobOutputCommandOutput, @@ -34,6 +73,9 @@ export class GetJobOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/GetVaultAccessPolicyCommand.ts b/clients/client-glacier/commands/GetVaultAccessPolicyCommand.ts index c34424fc0a7a2..92e4a0b2c8cc1 100644 --- a/clients/client-glacier/commands/GetVaultAccessPolicyCommand.ts +++ b/clients/client-glacier/commands/GetVaultAccessPolicyCommand.ts @@ -20,6 +20,14 @@ import { export type GetVaultAccessPolicyCommandInput = GetVaultAccessPolicyInput; export type GetVaultAccessPolicyCommandOutput = GetVaultAccessPolicyOutput & __MetadataBearer; +/** + *

This operation retrieves the access-policy subresource set on the vault; + * for more information on setting this subresource, see Set Vault Access Policy + * (PUT access-policy). If there is no access policy set on the vault, the + * operation returns a 404 Not found error. For more information about vault + * access policies, see Amazon Glacier Access Control + * with Vault Access Policies.

+ */ export class GetVaultAccessPolicyCommand extends $Command< GetVaultAccessPolicyCommandInput, GetVaultAccessPolicyCommandOutput, @@ -34,6 +42,9 @@ export class GetVaultAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/GetVaultLockCommand.ts b/clients/client-glacier/commands/GetVaultLockCommand.ts index c1c0f957b65f6..b4d11ac56e6bd 100644 --- a/clients/client-glacier/commands/GetVaultLockCommand.ts +++ b/clients/client-glacier/commands/GetVaultLockCommand.ts @@ -20,6 +20,36 @@ import { export type GetVaultLockCommandInput = GetVaultLockInput; export type GetVaultLockCommandOutput = GetVaultLockOutput & __MetadataBearer; +/** + *

This operation retrieves the following attributes from the lock-policy + * subresource set on the specified vault:

+ *
    + *
  • + *

    The vault lock policy set on the vault.

    + *
  • + *
  • + *

    The state of the vault lock, which is either InProgess or + * Locked.

    + *
  • + *
  • + *

    When the lock ID expires. The lock ID is used to complete the vault locking + * process.

    + *
  • + *
  • + *

    When the vault lock was initiated and put into the InProgress + * state.

    + *
  • + *
+ * + *

A vault lock is put into the InProgress state by calling InitiateVaultLock. A vault lock is put into the Locked state by + * calling CompleteVaultLock. You can abort the vault locking process by + * calling AbortVaultLock. For more information about the vault locking + * process, Amazon + * Glacier Vault Lock.

+ *

If there is no vault lock policy set on the vault, the operation returns a 404 + * Not found error. For more information about vault lock policies, Amazon + * Glacier Access Control with Vault Lock Policies.

+ */ export class GetVaultLockCommand extends $Command< GetVaultLockCommandInput, GetVaultLockCommandOutput, @@ -34,6 +64,9 @@ export class GetVaultLockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/GetVaultNotificationsCommand.ts b/clients/client-glacier/commands/GetVaultNotificationsCommand.ts index 3cbedc32898ad..7bce27c5d8eb7 100644 --- a/clients/client-glacier/commands/GetVaultNotificationsCommand.ts +++ b/clients/client-glacier/commands/GetVaultNotificationsCommand.ts @@ -20,6 +20,24 @@ import { export type GetVaultNotificationsCommandInput = GetVaultNotificationsInput; export type GetVaultNotificationsCommandOutput = GetVaultNotificationsOutput & __MetadataBearer; +/** + *

This operation retrieves the notification-configuration subresource of + * the specified vault.

+ * + *

For information about setting a notification configuration on a vault, see SetVaultNotifications. If a notification configuration for a vault is not + * set, the operation returns a 404 Not Found error. For more information about + * vault notifications, see Configuring Vault + * Notifications in Amazon S3 Glacier.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Configuring Vault + * Notifications in Amazon S3 Glacier and Get Vault Notification + * Configuration in the Amazon Glacier Developer Guide.

+ */ export class GetVaultNotificationsCommand extends $Command< GetVaultNotificationsCommandInput, GetVaultNotificationsCommandOutput, @@ -34,6 +52,9 @@ export class GetVaultNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/InitiateJobCommand.ts b/clients/client-glacier/commands/InitiateJobCommand.ts index 417d9873ef0a8..10c769ca290a8 100644 --- a/clients/client-glacier/commands/InitiateJobCommand.ts +++ b/clients/client-glacier/commands/InitiateJobCommand.ts @@ -20,6 +20,13 @@ import { export type InitiateJobCommandInput = InitiateJobInput; export type InitiateJobCommandOutput = InitiateJobOutput & __MetadataBearer; +/** + *

This operation initiates a job of the specified type, which can be a select, an archival retrieval, + * or a vault retrieval. For more information about using this operation, + * see the documentation for the underlying REST API Initiate + * a Job. + *

+ */ export class InitiateJobCommand extends $Command< InitiateJobCommandInput, InitiateJobCommandOutput, @@ -34,6 +41,9 @@ export class InitiateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/InitiateMultipartUploadCommand.ts b/clients/client-glacier/commands/InitiateMultipartUploadCommand.ts index 68a0fde39147f..cd5f4e9bbf937 100644 --- a/clients/client-glacier/commands/InitiateMultipartUploadCommand.ts +++ b/clients/client-glacier/commands/InitiateMultipartUploadCommand.ts @@ -20,6 +20,42 @@ import { export type InitiateMultipartUploadCommandInput = InitiateMultipartUploadInput; export type InitiateMultipartUploadCommandOutput = InitiateMultipartUploadOutput & __MetadataBearer; +/** + *

This operation initiates a multipart upload. Amazon S3 Glacier creates a multipart + * upload resource and returns its ID in the response. The multipart upload ID is used in + * subsequent requests to upload parts of an archive (see UploadMultipartPart).

+ * + *

When you initiate a multipart upload, you specify the part size in number of bytes. + * The part size must be a megabyte (1024 KB) multiplied by a power of 2-for example, 1048576 + * (1 MB), 2097152 (2 MB), 4194304 (4 MB), 8388608 (8 MB), and so on. The minimum allowable + * part size is 1 MB, and the maximum is 4 GB.

+ * + *

Every part you upload to this resource (see UploadMultipartPart), + * except the last one, must have the same size. The last one can be the same size or smaller. + * For example, suppose you want to upload a 16.2 MB file. If you initiate the multipart + * upload with a part size of 4 MB, you will upload four parts of 4 MB each and one part of + * 0.2 MB.

+ * + * + *

You don't need to know the size of the archive when you start a multipart upload + * because Amazon S3 Glacier does not require you to specify the overall archive + * size.

+ *
+ * + *

After you complete the multipart upload, Amazon S3 Glacier (Glacier) removes the multipart upload + * resource referenced by the ID. Glacier also removes the multipart upload resource if + * you cancel the multipart upload or it may be removed if there is no activity for a period + * of 24 hours.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Uploading Large Archives in + * Parts (Multipart Upload) and Initiate Multipart + * Upload in the Amazon Glacier Developer Guide.

+ */ export class InitiateMultipartUploadCommand extends $Command< InitiateMultipartUploadCommandInput, InitiateMultipartUploadCommandOutput, @@ -34,6 +70,9 @@ export class InitiateMultipartUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/InitiateVaultLockCommand.ts b/clients/client-glacier/commands/InitiateVaultLockCommand.ts index 0f32940b2268c..dbb3615d0cc94 100644 --- a/clients/client-glacier/commands/InitiateVaultLockCommand.ts +++ b/clients/client-glacier/commands/InitiateVaultLockCommand.ts @@ -20,6 +20,43 @@ import { export type InitiateVaultLockCommandInput = InitiateVaultLockInput; export type InitiateVaultLockCommandOutput = InitiateVaultLockOutput & __MetadataBearer; +/** + *

This operation initiates the vault locking process by doing the following:

+ *
    + *
  • + *

    Installing a vault lock policy on the specified vault.

    + *
  • + *
  • + *

    Setting the lock state of vault lock to InProgress.

    + *
  • + *
  • + *

    Returning a lock ID, which is used to complete the vault locking + * process.

    + *
  • + *
+ * + *

You can set one vault lock policy for each vault and this policy can be up to 20 KB + * in size. For more information about vault lock policies, see Amazon Glacier Access Control with + * Vault Lock Policies.

+ *

You must complete the vault locking process within 24 hours after the vault lock + * enters the InProgress state. After the 24 hour window ends, the lock ID + * expires, the vault automatically exits the InProgress state, and the vault + * lock policy is removed from the vault. You call CompleteVaultLock to + * complete the vault locking process by setting the state of the vault lock to + * Locked.

+ *

After a vault lock is in the Locked state, you cannot initiate a new + * vault lock for the vault.

+ * + *

You can abort the vault locking process by calling AbortVaultLock. + * You can get the state of the vault lock by calling GetVaultLock. For more + * information about the vault locking process, Amazon Glacier Vault + * Lock.

+ * + *

If this operation is called when the vault lock is in the InProgress + * state, the operation returns an AccessDeniedException error. When the vault + * lock is in the InProgress state you must call AbortVaultLock + * before you can initiate a new vault lock policy.

+ */ export class InitiateVaultLockCommand extends $Command< InitiateVaultLockCommandInput, InitiateVaultLockCommandOutput, @@ -34,6 +71,9 @@ export class InitiateVaultLockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/ListJobsCommand.ts b/clients/client-glacier/commands/ListJobsCommand.ts index b64ae5fad6a35..79bb9ffb4e386 100644 --- a/clients/client-glacier/commands/ListJobsCommand.ts +++ b/clients/client-glacier/commands/ListJobsCommand.ts @@ -20,6 +20,44 @@ import { export type ListJobsCommandInput = ListJobsInput; export type ListJobsCommandOutput = ListJobsOutput & __MetadataBearer; +/** + *

This operation lists jobs for a vault, including jobs that are in-progress and jobs + * that have recently finished. The List Job operation returns a list of these jobs sorted by job initiation + * time.

+ * + * + *

Amazon Glacier retains recently completed jobs for a period before deleting them; + * however, it eventually removes completed jobs. The output of completed jobs can be + * retrieved. Retaining completed jobs for a period of time after they have completed + * enables you to get a job output in the event you miss the job completion notification or + * your first attempt to download it fails. For example, suppose you start an archive + * retrieval job to download an archive. After the job completes, you start to download the + * archive but encounter a network error. In this scenario, you can retry and download the + * archive while the job exists.

+ *
+ * + *

The List Jobs operation supports pagination. You should always check the response Marker field. + * If there are no more jobs to list, the Marker field is set to null. If there are more jobs to list, + * the Marker field is set to a non-null value, which you can use to continue the pagination of the list. + * To return a list of jobs that begins at a specific job, + * set the marker request parameter to the Marker value for that job that you obtained from a previous List Jobs request.

+ * + *

You can set a maximum limit for the number of jobs returned in the response by + * specifying the limit parameter in the request. The default limit is 50. The + * number of jobs returned might be fewer than the limit, but the number of returned jobs + * never exceeds the limit.

+ * + *

Additionally, you can filter the jobs list returned by specifying the optional + * statuscode parameter or completed parameter, or both. Using + * the statuscode parameter, you can specify to return only jobs that match + * either the InProgress, Succeeded, or Failed status. + * Using the completed parameter, you can specify to return only jobs that were + * completed (true) or jobs that were not completed + * (false).

+ * + *

For more information about using this operation, + * see the documentation for the underlying REST API List Jobs.

+ */ export class ListJobsCommand extends $Command< ListJobsCommandInput, ListJobsCommandOutput, @@ -34,6 +72,9 @@ export class ListJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/ListMultipartUploadsCommand.ts b/clients/client-glacier/commands/ListMultipartUploadsCommand.ts index b21d07baaefa7..60229e511fd33 100644 --- a/clients/client-glacier/commands/ListMultipartUploadsCommand.ts +++ b/clients/client-glacier/commands/ListMultipartUploadsCommand.ts @@ -20,6 +20,34 @@ import { export type ListMultipartUploadsCommandInput = ListMultipartUploadsInput; export type ListMultipartUploadsCommandOutput = ListMultipartUploadsOutput & __MetadataBearer; +/** + *

This operation lists in-progress multipart uploads for the specified vault. An + * in-progress multipart upload is a multipart upload that has been initiated by an InitiateMultipartUpload request, but has not yet been completed or aborted. + * The list returned in the List Multipart Upload response has no guaranteed order.

+ * + *

The List Multipart Uploads operation supports pagination. By default, this operation + * returns up to 50 multipart uploads in the response. You should always check the response + * for a marker at which to continue the list; if there are no more items the + * marker is null. To return a list of multipart uploads that + * begins at a specific upload, set the marker request parameter to the value you + * obtained from a previous List Multipart Upload request. You can also limit the number of + * uploads returned in the response by specifying the limit parameter in the + * request.

+ * + *

Note the difference between this operation and listing parts (ListParts). The List Multipart Uploads operation lists all multipart uploads + * for a vault and does not require a multipart upload ID. The List Parts operation requires a + * multipart upload ID since parts are associated with a single upload.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ * + *

For conceptual information and the underlying REST API, see Working + * with Archives in Amazon S3 Glacier and List Multipart Uploads + * in the Amazon Glacier Developer Guide.

+ */ export class ListMultipartUploadsCommand extends $Command< ListMultipartUploadsCommandInput, ListMultipartUploadsCommandOutput, @@ -34,6 +62,9 @@ export class ListMultipartUploadsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/ListPartsCommand.ts b/clients/client-glacier/commands/ListPartsCommand.ts index 769146ddccf66..5ee8fe7205a38 100644 --- a/clients/client-glacier/commands/ListPartsCommand.ts +++ b/clients/client-glacier/commands/ListPartsCommand.ts @@ -20,6 +20,30 @@ import { export type ListPartsCommandInput = ListPartsInput; export type ListPartsCommandOutput = ListPartsOutput & __MetadataBearer; +/** + *

This operation lists the parts of an archive that have been uploaded in a specific + * multipart upload. You can make this request at any time during an in-progress multipart + * upload before you complete the upload (see CompleteMultipartUpload. List + * Parts returns an error for completed uploads. The list returned in the List Parts response + * is sorted by part range.

+ * + *

The List Parts operation supports pagination. By default, this operation returns up + * to 50 uploaded parts in the response. You should always check the response for a + * marker at which to continue the list; if there are no more items the + * marker is null. To return a list of parts that begins at a + * specific part, set the marker request parameter to the value you obtained from + * a previous List Parts request. You can also limit the number of parts returned in the + * response by specifying the limit parameter in the request.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and the underlying REST API, see Working + * with Archives in Amazon S3 Glacier and List Parts in the + * Amazon Glacier Developer Guide.

+ */ export class ListPartsCommand extends $Command< ListPartsCommandInput, ListPartsCommandOutput, @@ -34,6 +58,9 @@ export class ListPartsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/ListProvisionedCapacityCommand.ts b/clients/client-glacier/commands/ListProvisionedCapacityCommand.ts index 100438072e0f7..4bed16bbaee0e 100644 --- a/clients/client-glacier/commands/ListProvisionedCapacityCommand.ts +++ b/clients/client-glacier/commands/ListProvisionedCapacityCommand.ts @@ -20,6 +20,10 @@ import { export type ListProvisionedCapacityCommandInput = ListProvisionedCapacityInput; export type ListProvisionedCapacityCommandOutput = ListProvisionedCapacityOutput & __MetadataBearer; +/** + *

This operation lists the provisioned capacity units for the specified AWS + * account.

+ */ export class ListProvisionedCapacityCommand extends $Command< ListProvisionedCapacityCommandInput, ListProvisionedCapacityCommandOutput, @@ -34,6 +38,9 @@ export class ListProvisionedCapacityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/ListTagsForVaultCommand.ts b/clients/client-glacier/commands/ListTagsForVaultCommand.ts index 9d6a6b38f004d..72e41216dec3e 100644 --- a/clients/client-glacier/commands/ListTagsForVaultCommand.ts +++ b/clients/client-glacier/commands/ListTagsForVaultCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForVaultCommandInput = ListTagsForVaultInput; export type ListTagsForVaultCommandOutput = ListTagsForVaultOutput & __MetadataBearer; +/** + *

This operation lists all the tags attached to a vault. The operation returns an empty + * map if there are no tags. For more information about tags, see Tagging Amazon S3 Glacier + * Resources.

+ */ export class ListTagsForVaultCommand extends $Command< ListTagsForVaultCommandInput, ListTagsForVaultCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/ListVaultsCommand.ts b/clients/client-glacier/commands/ListVaultsCommand.ts index 74ef69d91f388..919894a085ded 100644 --- a/clients/client-glacier/commands/ListVaultsCommand.ts +++ b/clients/client-glacier/commands/ListVaultsCommand.ts @@ -20,6 +20,27 @@ import { export type ListVaultsCommandInput = ListVaultsInput; export type ListVaultsCommandOutput = ListVaultsOutput & __MetadataBearer; +/** + *

This operation lists all vaults owned by the calling user's account. The list + * returned in the response is ASCII-sorted by vault name.

+ * + *

By default, this operation returns up to 10 items. If there are more vaults to + * list, the response marker field contains the vault Amazon Resource Name (ARN) + * at which to continue the list with a new List Vaults request; otherwise, the + * marker field is null. To return a list of vaults that begins + * at a specific vault, set the marker request parameter to the vault ARN you + * obtained from a previous List Vaults request. You can also limit the number of vaults + * returned in the response by specifying the limit parameter in the request.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Retrieving Vault Metadata in + * Amazon S3 Glacier and List Vaults in the + * Amazon Glacier Developer Guide.

+ */ export class ListVaultsCommand extends $Command< ListVaultsCommandInput, ListVaultsCommandOutput, @@ -34,6 +55,9 @@ export class ListVaultsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/PurchaseProvisionedCapacityCommand.ts b/clients/client-glacier/commands/PurchaseProvisionedCapacityCommand.ts index c2c85cd46bf42..5ac7ff95f0198 100644 --- a/clients/client-glacier/commands/PurchaseProvisionedCapacityCommand.ts +++ b/clients/client-glacier/commands/PurchaseProvisionedCapacityCommand.ts @@ -20,6 +20,9 @@ import { export type PurchaseProvisionedCapacityCommandInput = PurchaseProvisionedCapacityInput; export type PurchaseProvisionedCapacityCommandOutput = PurchaseProvisionedCapacityOutput & __MetadataBearer; +/** + *

This operation purchases a provisioned capacity unit for an AWS account.

+ */ export class PurchaseProvisionedCapacityCommand extends $Command< PurchaseProvisionedCapacityCommandInput, PurchaseProvisionedCapacityCommandOutput, @@ -34,6 +37,9 @@ export class PurchaseProvisionedCapacityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/RemoveTagsFromVaultCommand.ts b/clients/client-glacier/commands/RemoveTagsFromVaultCommand.ts index 9b557c4acb6ad..07b5ab7a7c50e 100644 --- a/clients/client-glacier/commands/RemoveTagsFromVaultCommand.ts +++ b/clients/client-glacier/commands/RemoveTagsFromVaultCommand.ts @@ -20,6 +20,12 @@ import { export type RemoveTagsFromVaultCommandInput = RemoveTagsFromVaultInput; export type RemoveTagsFromVaultCommandOutput = __MetadataBearer; +/** + *

This operation removes one or more tags from the set of tags attached to a vault. For + * more information about tags, see Tagging Amazon S3 Glacier Resources. + * This operation is idempotent. The operation will be successful, even if there are no tags + * attached to the vault.

+ */ export class RemoveTagsFromVaultCommand extends $Command< RemoveTagsFromVaultCommandInput, RemoveTagsFromVaultCommandOutput, @@ -34,6 +40,9 @@ export class RemoveTagsFromVaultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/SetDataRetrievalPolicyCommand.ts b/clients/client-glacier/commands/SetDataRetrievalPolicyCommand.ts index a54e33309ee9f..f3e1bca821113 100644 --- a/clients/client-glacier/commands/SetDataRetrievalPolicyCommand.ts +++ b/clients/client-glacier/commands/SetDataRetrievalPolicyCommand.ts @@ -20,6 +20,14 @@ import { export type SetDataRetrievalPolicyCommandInput = SetDataRetrievalPolicyInput; export type SetDataRetrievalPolicyCommandOutput = __MetadataBearer; +/** + *

This operation sets and then enacts a data retrieval policy in the region specified + * in the PUT request. You can set one policy per region for an AWS account. The policy is + * enacted within a few minutes of a successful PUT operation.

+ *

The set policy operation does not affect retrieval jobs that were in progress before + * the policy was enacted. For more information about data retrieval policies, see Amazon + * Glacier Data Retrieval Policies.

+ */ export class SetDataRetrievalPolicyCommand extends $Command< SetDataRetrievalPolicyCommandInput, SetDataRetrievalPolicyCommandOutput, @@ -34,6 +42,9 @@ export class SetDataRetrievalPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/SetVaultAccessPolicyCommand.ts b/clients/client-glacier/commands/SetVaultAccessPolicyCommand.ts index 8827f0112c683..0c3b42fb0e2e6 100644 --- a/clients/client-glacier/commands/SetVaultAccessPolicyCommand.ts +++ b/clients/client-glacier/commands/SetVaultAccessPolicyCommand.ts @@ -20,6 +20,14 @@ import { export type SetVaultAccessPolicyCommandInput = SetVaultAccessPolicyInput; export type SetVaultAccessPolicyCommandOutput = __MetadataBearer; +/** + *

This operation configures an access policy for a vault and will overwrite an existing + * policy. To configure a vault access policy, send a PUT request to the + * access-policy subresource of the vault. An access policy is specific to a + * vault and is also called a vault subresource. You can set one access policy per vault and + * the policy can be up to 20 KB in size. For more information about vault access policies, + * see Amazon Glacier Access Control with Vault Access Policies.

+ */ export class SetVaultAccessPolicyCommand extends $Command< SetVaultAccessPolicyCommandInput, SetVaultAccessPolicyCommandOutput, @@ -34,6 +42,9 @@ export class SetVaultAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/SetVaultNotificationsCommand.ts b/clients/client-glacier/commands/SetVaultNotificationsCommand.ts index f5699cd4de991..794dc17116087 100644 --- a/clients/client-glacier/commands/SetVaultNotificationsCommand.ts +++ b/clients/client-glacier/commands/SetVaultNotificationsCommand.ts @@ -20,6 +20,46 @@ import { export type SetVaultNotificationsCommandInput = SetVaultNotificationsInput; export type SetVaultNotificationsCommandOutput = __MetadataBearer; +/** + *

This operation configures notifications that will be sent when specific events happen + * to a vault. By default, you don't get any notifications.

+ * + *

To configure vault notifications, send a PUT request to the + * notification-configuration subresource of the vault. The request should + * include a JSON document that provides an Amazon SNS topic and specific events for which you + * want Amazon S3 Glacier to send notifications to the topic.

+ * + *

Amazon SNS topics must grant permission to the vault to be allowed to publish + * notifications to the topic. You can configure a vault to publish a notification for the + * following vault events:

+ * + *
    + *
  • + *

    + * ArchiveRetrievalCompleted This event occurs when a + * job that was initiated for an archive retrieval is completed (InitiateJob). The status of the completed job can be "Succeeded" or + * "Failed". The notification sent to the SNS topic is the same output as returned from + * DescribeJob.

    + *
  • + *
  • + * + *

    + * InventoryRetrievalCompleted This event occurs when a + * job that was initiated for an inventory retrieval is completed (InitiateJob). The status of the completed job can be "Succeeded" or + * "Failed". The notification sent to the SNS topic is the same output as returned from + * DescribeJob.

    + *
  • + *
+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Configuring Vault + * Notifications in Amazon S3 Glacier and Set Vault Notification + * Configuration in the Amazon Glacier Developer Guide.

+ */ export class SetVaultNotificationsCommand extends $Command< SetVaultNotificationsCommandInput, SetVaultNotificationsCommandOutput, @@ -34,6 +74,9 @@ export class SetVaultNotificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/UploadArchiveCommand.ts b/clients/client-glacier/commands/UploadArchiveCommand.ts index 44261fcfbb385..ea3552d376a34 100644 --- a/clients/client-glacier/commands/UploadArchiveCommand.ts +++ b/clients/client-glacier/commands/UploadArchiveCommand.ts @@ -22,6 +22,40 @@ export type UploadArchiveCommandInput = Omit & { }; export type UploadArchiveCommandOutput = ArchiveCreationOutput & __MetadataBearer; +/** + *

This operation adds an archive to a vault. This is a synchronous operation, and for a + * successful upload, your data is durably persisted. Amazon S3 Glacier returns the archive ID in + * the x-amz-archive-id header of the response.

+ * + *

You must use the archive ID to access your data in Amazon S3 Glacier. After you upload + * an archive, you should save the archive ID returned so that you can retrieve or delete the + * archive later. Besides saving the archive ID, you can also index it and give it a friendly + * name to allow for better searching. You can also use the optional archive description field + * to specify how the archive is referred to in an external index of archives, such as you + * might create in Amazon DynamoDB. You can also get the vault inventory to obtain a list of + * archive IDs in a vault. For more information, see InitiateJob.

+ * + *

You must provide a SHA256 tree hash of the data you are uploading. For information + * about computing a SHA256 tree hash, see Computing Checksums.

+ * + *

You can optionally specify an archive description of up to 1,024 printable ASCII + * characters. You can get the archive description when you either retrieve the archive or get + * the vault inventory. For more information, see InitiateJob. Amazon + * Glacier does not interpret the description in any way. An archive description does not need + * to be unique. You cannot use the description to retrieve or sort the archive list.

+ * + *

Archives are immutable. After you upload an archive, you cannot edit the archive or + * its description.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Uploading an Archive in Amazon + * Glacier and Upload Archive in the + * Amazon Glacier Developer Guide.

+ */ export class UploadArchiveCommand extends $Command< UploadArchiveCommandInput, UploadArchiveCommandOutput, @@ -36,6 +70,9 @@ export class UploadArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/commands/UploadMultipartPartCommand.ts b/clients/client-glacier/commands/UploadMultipartPartCommand.ts index ce199f758f2e7..1bacc86c80522 100644 --- a/clients/client-glacier/commands/UploadMultipartPartCommand.ts +++ b/clients/client-glacier/commands/UploadMultipartPartCommand.ts @@ -22,6 +22,59 @@ export type UploadMultipartPartCommandInput = OmitThis operation uploads a part of an archive. You can upload archive parts in any + * order. You can also upload them in parallel. You can upload up to 10,000 parts for a + * multipart upload.

+ * + *

Amazon Glacier rejects your upload part request if any of the following conditions is + * true:

+ * + *
    + *
  • + *

    + * SHA256 tree hash does not matchTo ensure that part + * data is not corrupted in transmission, you compute a SHA256 tree hash of the part and + * include it in your request. Upon receiving the part data, Amazon S3 Glacier also + * computes a SHA256 tree hash. If these hash values don't match, the operation fails. + * For information about computing a SHA256 tree hash, see Computing + * Checksums.

    + *
  • + *
  • + *

    + * Part size does not matchThe size of each part except + * the last must match the size specified in the corresponding InitiateMultipartUpload request. The size of the last part must be the + * same size as, or smaller than, the specified size.

    + * + *

    If you upload a part whose size is smaller than the part size you specified + * in your initiate multipart upload request and that part is not the last part, then + * the upload part request will succeed. However, the subsequent Complete Multipart + * Upload request will fail.

    + *
    + *
  • + *
  • + *

    + * Range does not alignThe byte range value in the + * request does not align with the part size specified in the corresponding initiate + * request. For example, if you specify a part size of 4194304 bytes (4 MB), then 0 to + * 4194303 bytes (4 MB - 1) and 4194304 (4 MB) to 8388607 (8 MB - 1) are valid part + * ranges. However, if you set a range value of 2 MB to 6 MB, the range does not align + * with the part size and the upload will fail.

    + *
  • + *
+ * + *

This operation is idempotent. If you upload the same part multiple times, the data + * included in the most recent request overwrites the previously uploaded data.

+ * + *

An AWS account has full permission to perform all operations (actions). However, AWS + * Identity and Access Management (IAM) users don't have any permissions by default. You must + * grant them explicit permission to perform specific actions. For more information, see + * Access Control Using + * AWS Identity and Access Management (IAM).

+ *

For conceptual information and underlying REST API, see Uploading Large Archives in + * Parts (Multipart Upload) and Upload Part in the + * Amazon Glacier Developer Guide.

+ */ export class UploadMultipartPartCommand extends $Command< UploadMultipartPartCommandInput, UploadMultipartPartCommandOutput, @@ -36,6 +89,9 @@ export class UploadMultipartPartCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlacierClientResolvedConfig, diff --git a/clients/client-glacier/package.json b/clients/client-glacier/package.json index 3ebd94543ad49..41e44a63f84c3 100644 --- a/clients/client-glacier/package.json +++ b/clients/client-glacier/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Glacier Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-glacier/runtimeConfig.browser.ts b/clients/client-glacier/runtimeConfig.browser.ts index 0d5d7a9ed2571..e1024f7af463b 100644 --- a/clients/client-glacier/runtimeConfig.browser.ts +++ b/clients/client-glacier/runtimeConfig.browser.ts @@ -13,6 +13,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./GlacierClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-glacier/runtimeConfig.native.ts b/clients/client-glacier/runtimeConfig.native.ts index b5980f88fc4e6..4ec7e88ba2315 100644 --- a/clients/client-glacier/runtimeConfig.native.ts +++ b/clients/client-glacier/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./GlacierClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-glacier/runtimeConfig.shared.ts b/clients/client-glacier/runtimeConfig.shared.ts index a679f991ea87d..7d22049c6bfea 100644 --- a/clients/client-glacier/runtimeConfig.shared.ts +++ b/clients/client-glacier/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-06-01", disableHostPrefix: false, diff --git a/clients/client-glacier/runtimeConfig.ts b/clients/client-glacier/runtimeConfig.ts index bf44218caa20e..86a45687b07a2 100644 --- a/clients/client-glacier/runtimeConfig.ts +++ b/clients/client-glacier/runtimeConfig.ts @@ -15,6 +15,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./GlacierClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-glacier/tsconfig.json b/clients/client-glacier/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-glacier/tsconfig.json +++ b/clients/client-glacier/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-global-accelerator/commands/AdvertiseByoipCidrCommand.ts b/clients/client-global-accelerator/commands/AdvertiseByoipCidrCommand.ts index 97a5f83c61b6d..7a069acd51fae 100644 --- a/clients/client-global-accelerator/commands/AdvertiseByoipCidrCommand.ts +++ b/clients/client-global-accelerator/commands/AdvertiseByoipCidrCommand.ts @@ -24,6 +24,17 @@ import { export type AdvertiseByoipCidrCommandInput = AdvertiseByoipCidrRequest; export type AdvertiseByoipCidrCommandOutput = AdvertiseByoipCidrResponse & __MetadataBearer; +/** + *

Advertises an IPv4 address range that is provisioned for use with your AWS resources + * through bring your own IP addresses (BYOIP). It can take a few minutes before traffic to + * the specified addresses starts routing to AWS because of propagation delays. To + * see an AWS CLI example of advertising an address range, scroll down to + * Example.

+ *

To stop advertising the BYOIP address range, use + * WithdrawByoipCidr.

+ *

For more information, see Bring Your Own + * IP Addresses (BYOIP) in the AWS Global Accelerator Developer Guide.

+ */ export class AdvertiseByoipCidrCommand extends $Command< AdvertiseByoipCidrCommandInput, AdvertiseByoipCidrCommandOutput, @@ -38,6 +49,9 @@ export class AdvertiseByoipCidrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/CreateAcceleratorCommand.ts b/clients/client-global-accelerator/commands/CreateAcceleratorCommand.ts index a51e3ede9801f..fa31871a8429f 100644 --- a/clients/client-global-accelerator/commands/CreateAcceleratorCommand.ts +++ b/clients/client-global-accelerator/commands/CreateAcceleratorCommand.ts @@ -24,6 +24,15 @@ import { export type CreateAcceleratorCommandInput = CreateAcceleratorRequest; export type CreateAcceleratorCommandOutput = CreateAcceleratorResponse & __MetadataBearer; +/** + *

Create an accelerator. An accelerator includes one or more listeners that process inbound connections and direct traffic + * to one or more endpoint groups, each of which includes endpoints, such as Network Load Balancers. To see an AWS CLI + * example of creating an accelerator, scroll down to Example.

+ * + *

Global Accelerator is a global service that supports endpoints in multiple AWS Regions but you must specify the + * US West (Oregon) Region to create or update accelerators.

+ *
+ */ export class CreateAcceleratorCommand extends $Command< CreateAcceleratorCommandInput, CreateAcceleratorCommandOutput, @@ -38,6 +47,9 @@ export class CreateAcceleratorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/CreateEndpointGroupCommand.ts b/clients/client-global-accelerator/commands/CreateEndpointGroupCommand.ts index 4613b43f53965..43ae86c81f130 100644 --- a/clients/client-global-accelerator/commands/CreateEndpointGroupCommand.ts +++ b/clients/client-global-accelerator/commands/CreateEndpointGroupCommand.ts @@ -24,6 +24,11 @@ import { export type CreateEndpointGroupCommandInput = CreateEndpointGroupRequest; export type CreateEndpointGroupCommandOutput = CreateEndpointGroupResponse & __MetadataBearer; +/** + *

Create an endpoint group for the specified listener. An endpoint group is a collection of endpoints in one AWS + * Region. A resource must be valid and active when you add it as an endpoint.

+ *

To see an AWS CLI example of creating an endpoint group, scroll down to Example.

+ */ export class CreateEndpointGroupCommand extends $Command< CreateEndpointGroupCommandInput, CreateEndpointGroupCommandOutput, @@ -38,6 +43,9 @@ export class CreateEndpointGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/CreateListenerCommand.ts b/clients/client-global-accelerator/commands/CreateListenerCommand.ts index ef7070db91939..22f2a2dee6043 100644 --- a/clients/client-global-accelerator/commands/CreateListenerCommand.ts +++ b/clients/client-global-accelerator/commands/CreateListenerCommand.ts @@ -24,6 +24,11 @@ import { export type CreateListenerCommandInput = CreateListenerRequest; export type CreateListenerCommandOutput = CreateListenerResponse & __MetadataBearer; +/** + *

Create a listener to process inbound connections from clients to an accelerator. Connections arrive to assigned static + * IP addresses on a port, port range, or list of port ranges that you specify. To see an AWS CLI example of creating a + * listener, scroll down to Example.

+ */ export class CreateListenerCommand extends $Command< CreateListenerCommandInput, CreateListenerCommandOutput, @@ -38,6 +43,9 @@ export class CreateListenerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/DeleteAcceleratorCommand.ts b/clients/client-global-accelerator/commands/DeleteAcceleratorCommand.ts index 3de32fa6c0247..96f755410690c 100644 --- a/clients/client-global-accelerator/commands/DeleteAcceleratorCommand.ts +++ b/clients/client-global-accelerator/commands/DeleteAcceleratorCommand.ts @@ -24,6 +24,23 @@ import { export type DeleteAcceleratorCommandInput = DeleteAcceleratorRequest; export type DeleteAcceleratorCommandOutput = __MetadataBearer; +/** + *

Delete an accelerator. Before you can delete an accelerator, you must disable it and remove all dependent resources + * (listeners and endpoint groups). To disable the accelerator, update the accelerator to set Enabled to false.

+ * + *

When you create an accelerator, by default, Global Accelerator provides you with a set of two static IP addresses. + * Alternatively, you can bring your own IP address ranges to Global Accelerator and assign IP addresses from those ranges. + *

+ *

The IP + * addresses are assigned to your accelerator for as long as it exists, even if you disable the accelerator and + * it no longer accepts or routes traffic. However, when you delete an accelerator, you lose the + * static IP addresses that are assigned to the accelerator, so you can no longer route traffic by using them. + * As a best practice, ensure that you have permissions in place to avoid inadvertently deleting accelerators. You + * can use IAM policies with Global Accelerator to limit the users who have permissions to delete an accelerator. For more information, + * see Authentication and Access Control in + * the AWS Global Accelerator Developer Guide.

+ *
+ */ export class DeleteAcceleratorCommand extends $Command< DeleteAcceleratorCommandInput, DeleteAcceleratorCommandOutput, @@ -38,6 +55,9 @@ export class DeleteAcceleratorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/DeleteEndpointGroupCommand.ts b/clients/client-global-accelerator/commands/DeleteEndpointGroupCommand.ts index b998f684953fc..f2529b6da686b 100644 --- a/clients/client-global-accelerator/commands/DeleteEndpointGroupCommand.ts +++ b/clients/client-global-accelerator/commands/DeleteEndpointGroupCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteEndpointGroupCommandInput = DeleteEndpointGroupRequest; export type DeleteEndpointGroupCommandOutput = __MetadataBearer; +/** + *

Delete an endpoint group from a listener.

+ */ export class DeleteEndpointGroupCommand extends $Command< DeleteEndpointGroupCommandInput, DeleteEndpointGroupCommandOutput, @@ -38,6 +41,9 @@ export class DeleteEndpointGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/DeleteListenerCommand.ts b/clients/client-global-accelerator/commands/DeleteListenerCommand.ts index 435e6419bc1b2..289f9e1c6ef66 100644 --- a/clients/client-global-accelerator/commands/DeleteListenerCommand.ts +++ b/clients/client-global-accelerator/commands/DeleteListenerCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteListenerCommandInput = DeleteListenerRequest; export type DeleteListenerCommandOutput = __MetadataBearer; +/** + *

Delete a listener from an accelerator.

+ */ export class DeleteListenerCommand extends $Command< DeleteListenerCommandInput, DeleteListenerCommandOutput, @@ -38,6 +41,9 @@ export class DeleteListenerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/DeprovisionByoipCidrCommand.ts b/clients/client-global-accelerator/commands/DeprovisionByoipCidrCommand.ts index 025c0585ae536..714df0218920a 100644 --- a/clients/client-global-accelerator/commands/DeprovisionByoipCidrCommand.ts +++ b/clients/client-global-accelerator/commands/DeprovisionByoipCidrCommand.ts @@ -24,6 +24,17 @@ import { export type DeprovisionByoipCidrCommandInput = DeprovisionByoipCidrRequest; export type DeprovisionByoipCidrCommandOutput = DeprovisionByoipCidrResponse & __MetadataBearer; +/** + *

Releases the specified address range that you provisioned to use with your AWS resources + * through bring your own IP addresses (BYOIP) and deletes the corresponding address pool. To + * see an AWS CLI example of deprovisioning an address range, scroll down to + * Example.

+ *

Before you can release an address range, you must stop advertising it by using WithdrawByoipCidr and you must not have + * any accelerators that are using static IP addresses allocated from its address range. + *

+ *

For more information, see Bring Your Own + * IP Addresses (BYOIP) in the AWS Global Accelerator Developer Guide.

+ */ export class DeprovisionByoipCidrCommand extends $Command< DeprovisionByoipCidrCommandInput, DeprovisionByoipCidrCommandOutput, @@ -38,6 +49,9 @@ export class DeprovisionByoipCidrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/DescribeAcceleratorAttributesCommand.ts b/clients/client-global-accelerator/commands/DescribeAcceleratorAttributesCommand.ts index c8232b198a94b..27c888199aa35 100644 --- a/clients/client-global-accelerator/commands/DescribeAcceleratorAttributesCommand.ts +++ b/clients/client-global-accelerator/commands/DescribeAcceleratorAttributesCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeAcceleratorAttributesCommandInput = DescribeAcceleratorAttributesRequest; export type DescribeAcceleratorAttributesCommandOutput = DescribeAcceleratorAttributesResponse & __MetadataBearer; +/** + *

Describe the attributes of an accelerator. To see an AWS CLI example of describing the attributes of an accelerator, + * scroll down to Example.

+ */ export class DescribeAcceleratorAttributesCommand extends $Command< DescribeAcceleratorAttributesCommandInput, DescribeAcceleratorAttributesCommandOutput, @@ -38,6 +42,9 @@ export class DescribeAcceleratorAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/DescribeAcceleratorCommand.ts b/clients/client-global-accelerator/commands/DescribeAcceleratorCommand.ts index 69e4e34cc5a33..1658de5f26d9c 100644 --- a/clients/client-global-accelerator/commands/DescribeAcceleratorCommand.ts +++ b/clients/client-global-accelerator/commands/DescribeAcceleratorCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeAcceleratorCommandInput = DescribeAcceleratorRequest; export type DescribeAcceleratorCommandOutput = DescribeAcceleratorResponse & __MetadataBearer; +/** + *

Describe an accelerator. To see an AWS CLI example of describing an accelerator, scroll down to Example.

+ */ export class DescribeAcceleratorCommand extends $Command< DescribeAcceleratorCommandInput, DescribeAcceleratorCommandOutput, @@ -38,6 +41,9 @@ export class DescribeAcceleratorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/DescribeEndpointGroupCommand.ts b/clients/client-global-accelerator/commands/DescribeEndpointGroupCommand.ts index e86165467194d..30735f6bc1988 100644 --- a/clients/client-global-accelerator/commands/DescribeEndpointGroupCommand.ts +++ b/clients/client-global-accelerator/commands/DescribeEndpointGroupCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeEndpointGroupCommandInput = DescribeEndpointGroupRequest; export type DescribeEndpointGroupCommandOutput = DescribeEndpointGroupResponse & __MetadataBearer; +/** + *

Describe an endpoint group. To see an AWS CLI example of describing + * an endpoint group, scroll down to Example.

+ */ export class DescribeEndpointGroupCommand extends $Command< DescribeEndpointGroupCommandInput, DescribeEndpointGroupCommandOutput, @@ -38,6 +42,9 @@ export class DescribeEndpointGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/DescribeListenerCommand.ts b/clients/client-global-accelerator/commands/DescribeListenerCommand.ts index e11422a019c07..707f5da8121e9 100644 --- a/clients/client-global-accelerator/commands/DescribeListenerCommand.ts +++ b/clients/client-global-accelerator/commands/DescribeListenerCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeListenerCommandInput = DescribeListenerRequest; export type DescribeListenerCommandOutput = DescribeListenerResponse & __MetadataBearer; +/** + *

Describe a listener. To see an AWS CLI example of describing a listener, scroll down to Example.

+ */ export class DescribeListenerCommand extends $Command< DescribeListenerCommandInput, DescribeListenerCommandOutput, @@ -38,6 +41,9 @@ export class DescribeListenerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/ListAcceleratorsCommand.ts b/clients/client-global-accelerator/commands/ListAcceleratorsCommand.ts index ae168ce2ed03a..79fbea7325741 100644 --- a/clients/client-global-accelerator/commands/ListAcceleratorsCommand.ts +++ b/clients/client-global-accelerator/commands/ListAcceleratorsCommand.ts @@ -24,6 +24,10 @@ import { export type ListAcceleratorsCommandInput = ListAcceleratorsRequest; export type ListAcceleratorsCommandOutput = ListAcceleratorsResponse & __MetadataBearer; +/** + *

List the accelerators for an AWS account. To see an AWS CLI example of listing the accelerators for an AWS account, + * scroll down to Example.

+ */ export class ListAcceleratorsCommand extends $Command< ListAcceleratorsCommandInput, ListAcceleratorsCommandOutput, @@ -38,6 +42,9 @@ export class ListAcceleratorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/ListByoipCidrsCommand.ts b/clients/client-global-accelerator/commands/ListByoipCidrsCommand.ts index 11aec2e86ff13..8819d4d4c2440 100644 --- a/clients/client-global-accelerator/commands/ListByoipCidrsCommand.ts +++ b/clients/client-global-accelerator/commands/ListByoipCidrsCommand.ts @@ -24,6 +24,12 @@ import { export type ListByoipCidrsCommandInput = ListByoipCidrsRequest; export type ListByoipCidrsCommandOutput = ListByoipCidrsResponse & __MetadataBearer; +/** + *

Lists the IP address ranges that were specified in calls to ProvisionByoipCidr, including + * the current state and a history of state changes.

+ *

To see an AWS CLI example of listing BYOIP CIDR addresses, scroll down to + * Example.

+ */ export class ListByoipCidrsCommand extends $Command< ListByoipCidrsCommandInput, ListByoipCidrsCommandOutput, @@ -38,6 +44,9 @@ export class ListByoipCidrsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/ListEndpointGroupsCommand.ts b/clients/client-global-accelerator/commands/ListEndpointGroupsCommand.ts index 10abf8134b07d..a8a3c3e98347a 100644 --- a/clients/client-global-accelerator/commands/ListEndpointGroupsCommand.ts +++ b/clients/client-global-accelerator/commands/ListEndpointGroupsCommand.ts @@ -24,6 +24,10 @@ import { export type ListEndpointGroupsCommandInput = ListEndpointGroupsRequest; export type ListEndpointGroupsCommandOutput = ListEndpointGroupsResponse & __MetadataBearer; +/** + *

List the endpoint groups that are associated with a listener. To see an AWS CLI example of listing + * the endpoint groups for listener, scroll down to Example.

+ */ export class ListEndpointGroupsCommand extends $Command< ListEndpointGroupsCommandInput, ListEndpointGroupsCommandOutput, @@ -38,6 +42,9 @@ export class ListEndpointGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/ListListenersCommand.ts b/clients/client-global-accelerator/commands/ListListenersCommand.ts index 8f9b29d2dd483..af241aef4d7d4 100644 --- a/clients/client-global-accelerator/commands/ListListenersCommand.ts +++ b/clients/client-global-accelerator/commands/ListListenersCommand.ts @@ -24,6 +24,10 @@ import { export type ListListenersCommandInput = ListListenersRequest; export type ListListenersCommandOutput = ListListenersResponse & __MetadataBearer; +/** + *

List the listeners for an accelerator. To see an AWS CLI example of listing the listeners for an accelerator, + * scroll down to Example.

+ */ export class ListListenersCommand extends $Command< ListListenersCommandInput, ListListenersCommandOutput, @@ -38,6 +42,9 @@ export class ListListenersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/ListTagsForResourceCommand.ts b/clients/client-global-accelerator/commands/ListTagsForResourceCommand.ts index 142880b3bcea4..20b5ef7dde64d 100644 --- a/clients/client-global-accelerator/commands/ListTagsForResourceCommand.ts +++ b/clients/client-global-accelerator/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,12 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

List all tags for an accelerator. To see an AWS CLI example of listing tags for an accelerator, + * scroll down to Example.

+ *

For more information, see Tagging + * in AWS Global Accelerator in the AWS Global Accelerator Developer Guide.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +44,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/ProvisionByoipCidrCommand.ts b/clients/client-global-accelerator/commands/ProvisionByoipCidrCommand.ts index 3cc6389311a3f..caf47c6ec2b23 100644 --- a/clients/client-global-accelerator/commands/ProvisionByoipCidrCommand.ts +++ b/clients/client-global-accelerator/commands/ProvisionByoipCidrCommand.ts @@ -24,6 +24,16 @@ import { export type ProvisionByoipCidrCommandInput = ProvisionByoipCidrRequest; export type ProvisionByoipCidrCommandOutput = ProvisionByoipCidrResponse & __MetadataBearer; +/** + *

Provisions an IP address range to use with your AWS resources through bring your own IP + * addresses (BYOIP) and creates a corresponding address pool. After the address range is provisioned, + * it is ready to be advertised using + * AdvertiseByoipCidr.

+ *

To see an AWS CLI example of provisioning an address range for BYOIP, scroll down to + * Example.

+ *

For more information, see Bring Your Own + * IP Addresses (BYOIP) in the AWS Global Accelerator Developer Guide.

+ */ export class ProvisionByoipCidrCommand extends $Command< ProvisionByoipCidrCommandInput, ProvisionByoipCidrCommandOutput, @@ -38,6 +48,9 @@ export class ProvisionByoipCidrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/TagResourceCommand.ts b/clients/client-global-accelerator/commands/TagResourceCommand.ts index 8738d8fae7d42..5f8ac3744883a 100644 --- a/clients/client-global-accelerator/commands/TagResourceCommand.ts +++ b/clients/client-global-accelerator/commands/TagResourceCommand.ts @@ -24,6 +24,12 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Add tags to an accelerator resource. To see an AWS CLI example of adding tags to an accelerator, scroll down to + * Example.

+ *

For more information, see Tagging + * in AWS Global Accelerator in the AWS Global Accelerator Developer Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +44,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/UntagResourceCommand.ts b/clients/client-global-accelerator/commands/UntagResourceCommand.ts index 09097fd168b32..976b28d06223a 100644 --- a/clients/client-global-accelerator/commands/UntagResourceCommand.ts +++ b/clients/client-global-accelerator/commands/UntagResourceCommand.ts @@ -24,6 +24,13 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Remove tags from a Global Accelerator resource. When you specify a tag key, the action removes both that key and its associated value. To + * see an AWS CLI example of removing tags from an accelerator, scroll down to Example. + * The operation succeeds even if you attempt to remove tags from an accelerator that was already removed.

+ *

For more information, see Tagging + * in AWS Global Accelerator in the AWS Global Accelerator Developer Guide.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +45,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/UpdateAcceleratorAttributesCommand.ts b/clients/client-global-accelerator/commands/UpdateAcceleratorAttributesCommand.ts index f88497b00d016..2a802f7c00927 100644 --- a/clients/client-global-accelerator/commands/UpdateAcceleratorAttributesCommand.ts +++ b/clients/client-global-accelerator/commands/UpdateAcceleratorAttributesCommand.ts @@ -24,6 +24,10 @@ import { export type UpdateAcceleratorAttributesCommandInput = UpdateAcceleratorAttributesRequest; export type UpdateAcceleratorAttributesCommandOutput = UpdateAcceleratorAttributesResponse & __MetadataBearer; +/** + *

Update the attributes for an accelerator. To see an AWS CLI example of updating an accelerator to enable flow logs, + * scroll down to Example.

+ */ export class UpdateAcceleratorAttributesCommand extends $Command< UpdateAcceleratorAttributesCommandInput, UpdateAcceleratorAttributesCommandOutput, @@ -38,6 +42,9 @@ export class UpdateAcceleratorAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/UpdateAcceleratorCommand.ts b/clients/client-global-accelerator/commands/UpdateAcceleratorCommand.ts index d6aafc96c8ff5..4b36a0c6b9c57 100644 --- a/clients/client-global-accelerator/commands/UpdateAcceleratorCommand.ts +++ b/clients/client-global-accelerator/commands/UpdateAcceleratorCommand.ts @@ -24,6 +24,15 @@ import { export type UpdateAcceleratorCommandInput = UpdateAcceleratorRequest; export type UpdateAcceleratorCommandOutput = UpdateAcceleratorResponse & __MetadataBearer; +/** + *

Update an accelerator. To see an AWS CLI example of updating an accelerator, + * scroll down to Example.

+ * + * + *

Global Accelerator is a global service that supports endpoints in multiple AWS Regions but you must specify the + * US West (Oregon) Region to create or update accelerators.

+ *
+ */ export class UpdateAcceleratorCommand extends $Command< UpdateAcceleratorCommandInput, UpdateAcceleratorCommandOutput, @@ -38,6 +47,9 @@ export class UpdateAcceleratorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/UpdateEndpointGroupCommand.ts b/clients/client-global-accelerator/commands/UpdateEndpointGroupCommand.ts index afcd3dcf9bfa2..0ab9c4306a4ad 100644 --- a/clients/client-global-accelerator/commands/UpdateEndpointGroupCommand.ts +++ b/clients/client-global-accelerator/commands/UpdateEndpointGroupCommand.ts @@ -24,6 +24,10 @@ import { export type UpdateEndpointGroupCommandInput = UpdateEndpointGroupRequest; export type UpdateEndpointGroupCommandOutput = UpdateEndpointGroupResponse & __MetadataBearer; +/** + *

Update an endpoint group. A resource must be valid and active when you add it as an endpoint.

+ *

To see an AWS CLI example of updating an endpoint group, scroll down to Example.

+ */ export class UpdateEndpointGroupCommand extends $Command< UpdateEndpointGroupCommandInput, UpdateEndpointGroupCommandOutput, @@ -38,6 +42,9 @@ export class UpdateEndpointGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/UpdateListenerCommand.ts b/clients/client-global-accelerator/commands/UpdateListenerCommand.ts index 01d9a1e4b346e..bdc8805c7365e 100644 --- a/clients/client-global-accelerator/commands/UpdateListenerCommand.ts +++ b/clients/client-global-accelerator/commands/UpdateListenerCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateListenerCommandInput = UpdateListenerRequest; export type UpdateListenerCommandOutput = UpdateListenerResponse & __MetadataBearer; +/** + *

Update a listener. To see an AWS CLI example of updating listener, scroll down to Example.

+ */ export class UpdateListenerCommand extends $Command< UpdateListenerCommandInput, UpdateListenerCommandOutput, @@ -38,6 +41,9 @@ export class UpdateListenerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/commands/WithdrawByoipCidrCommand.ts b/clients/client-global-accelerator/commands/WithdrawByoipCidrCommand.ts index 513c2189fad3b..6af1345933bbb 100644 --- a/clients/client-global-accelerator/commands/WithdrawByoipCidrCommand.ts +++ b/clients/client-global-accelerator/commands/WithdrawByoipCidrCommand.ts @@ -24,6 +24,16 @@ import { export type WithdrawByoipCidrCommandInput = WithdrawByoipCidrRequest; export type WithdrawByoipCidrCommandOutput = WithdrawByoipCidrResponse & __MetadataBearer; +/** + *

Stops advertising an address range that is provisioned as an address pool. + * You can perform this operation at most once every 10 seconds, even if you specify different address + * ranges each time. To see an AWS CLI example of withdrawing an address range for BYOIP so + * it will no longer be advertised by AWS, scroll down to Example.

+ *

It can take a few minutes before traffic to the specified addresses stops routing to AWS because of + * propagation delays.

+ *

For more information, see Bring Your Own + * IP Addresses (BYOIP) in the AWS Global Accelerator Developer Guide.

+ */ export class WithdrawByoipCidrCommand extends $Command< WithdrawByoipCidrCommandInput, WithdrawByoipCidrCommandOutput, @@ -38,6 +48,9 @@ export class WithdrawByoipCidrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlobalAcceleratorClientResolvedConfig, diff --git a/clients/client-global-accelerator/package.json b/clients/client-global-accelerator/package.json index 573ddb5b7d449..076a52c1236dd 100644 --- a/clients/client-global-accelerator/package.json +++ b/clients/client-global-accelerator/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Global Accelerator Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-global-accelerator/runtimeConfig.browser.ts b/clients/client-global-accelerator/runtimeConfig.browser.ts index 627706d27cb40..4b43c10c09695 100644 --- a/clients/client-global-accelerator/runtimeConfig.browser.ts +++ b/clients/client-global-accelerator/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./GlobalAcceleratorClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-global-accelerator/runtimeConfig.native.ts b/clients/client-global-accelerator/runtimeConfig.native.ts index b0dc68c9b1ac1..5255941fe136f 100644 --- a/clients/client-global-accelerator/runtimeConfig.native.ts +++ b/clients/client-global-accelerator/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./GlobalAcceleratorClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-global-accelerator/runtimeConfig.shared.ts b/clients/client-global-accelerator/runtimeConfig.shared.ts index cf00f51b86175..c811f05db0eb6 100644 --- a/clients/client-global-accelerator/runtimeConfig.shared.ts +++ b/clients/client-global-accelerator/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-08-08", disableHostPrefix: false, diff --git a/clients/client-global-accelerator/runtimeConfig.ts b/clients/client-global-accelerator/runtimeConfig.ts index 139b92365403a..e8e36b46ebd24 100644 --- a/clients/client-global-accelerator/runtimeConfig.ts +++ b/clients/client-global-accelerator/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./GlobalAcceleratorClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-global-accelerator/tsconfig.json b/clients/client-global-accelerator/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-global-accelerator/tsconfig.json +++ b/clients/client-global-accelerator/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-glue/commands/BatchCreatePartitionCommand.ts b/clients/client-glue/commands/BatchCreatePartitionCommand.ts index 8f84944628ae1..42fd359d463ba 100644 --- a/clients/client-glue/commands/BatchCreatePartitionCommand.ts +++ b/clients/client-glue/commands/BatchCreatePartitionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchCreatePartitionCommandInput = BatchCreatePartitionRequest; export type BatchCreatePartitionCommandOutput = BatchCreatePartitionResponse & __MetadataBearer; +/** + *

Creates one or more partitions in a batch operation.

+ */ export class BatchCreatePartitionCommand extends $Command< BatchCreatePartitionCommandInput, BatchCreatePartitionCommandOutput, @@ -34,6 +37,9 @@ export class BatchCreatePartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchDeleteConnectionCommand.ts b/clients/client-glue/commands/BatchDeleteConnectionCommand.ts index fe4c09aa3083b..09324b1e4dd76 100644 --- a/clients/client-glue/commands/BatchDeleteConnectionCommand.ts +++ b/clients/client-glue/commands/BatchDeleteConnectionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeleteConnectionCommandInput = BatchDeleteConnectionRequest; export type BatchDeleteConnectionCommandOutput = BatchDeleteConnectionResponse & __MetadataBearer; +/** + *

Deletes a list of connection definitions from the Data Catalog.

+ */ export class BatchDeleteConnectionCommand extends $Command< BatchDeleteConnectionCommandInput, BatchDeleteConnectionCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeleteConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchDeletePartitionCommand.ts b/clients/client-glue/commands/BatchDeletePartitionCommand.ts index 9359bf12652f5..32905add84d7d 100644 --- a/clients/client-glue/commands/BatchDeletePartitionCommand.ts +++ b/clients/client-glue/commands/BatchDeletePartitionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeletePartitionCommandInput = BatchDeletePartitionRequest; export type BatchDeletePartitionCommandOutput = BatchDeletePartitionResponse & __MetadataBearer; +/** + *

Deletes one or more partitions in a batch operation.

+ */ export class BatchDeletePartitionCommand extends $Command< BatchDeletePartitionCommandInput, BatchDeletePartitionCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeletePartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchDeleteTableCommand.ts b/clients/client-glue/commands/BatchDeleteTableCommand.ts index 62f19ef95b9aa..a10ec5a236c23 100644 --- a/clients/client-glue/commands/BatchDeleteTableCommand.ts +++ b/clients/client-glue/commands/BatchDeleteTableCommand.ts @@ -20,6 +20,19 @@ import { export type BatchDeleteTableCommandInput = BatchDeleteTableRequest; export type BatchDeleteTableCommandOutput = BatchDeleteTableResponse & __MetadataBearer; +/** + *

Deletes multiple tables at once.

+ * + *

After completing this operation, you no longer have access to the table versions and + * partitions that belong to the deleted table. AWS Glue deletes these "orphaned" resources + * asynchronously in a timely manner, at the discretion of the service.

+ *

To ensure the immediate deletion of all related resources, before calling + * BatchDeleteTable, use DeleteTableVersion or + * BatchDeleteTableVersion, and DeletePartition or + * BatchDeletePartition, to delete any resources that belong to the + * table.

+ *
+ */ export class BatchDeleteTableCommand extends $Command< BatchDeleteTableCommandInput, BatchDeleteTableCommandOutput, @@ -34,6 +47,9 @@ export class BatchDeleteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchDeleteTableVersionCommand.ts b/clients/client-glue/commands/BatchDeleteTableVersionCommand.ts index 45d483f6a1e55..ece127289e1d0 100644 --- a/clients/client-glue/commands/BatchDeleteTableVersionCommand.ts +++ b/clients/client-glue/commands/BatchDeleteTableVersionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeleteTableVersionCommandInput = BatchDeleteTableVersionRequest; export type BatchDeleteTableVersionCommandOutput = BatchDeleteTableVersionResponse & __MetadataBearer; +/** + *

Deletes a specified batch of versions of a table.

+ */ export class BatchDeleteTableVersionCommand extends $Command< BatchDeleteTableVersionCommandInput, BatchDeleteTableVersionCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeleteTableVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchGetCrawlersCommand.ts b/clients/client-glue/commands/BatchGetCrawlersCommand.ts index 8e9c9ff1ff969..8feced3a5b0f0 100644 --- a/clients/client-glue/commands/BatchGetCrawlersCommand.ts +++ b/clients/client-glue/commands/BatchGetCrawlersCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetCrawlersCommandInput = BatchGetCrawlersRequest; export type BatchGetCrawlersCommandOutput = BatchGetCrawlersResponse & __MetadataBearer; +/** + *

Returns a list of resource metadata for a given list of crawler names. After calling the ListCrawlers operation, you can call this operation to access the data to which you have been granted permissions. This operation supports all IAM permissions, including permission conditions that uses tags.

+ */ export class BatchGetCrawlersCommand extends $Command< BatchGetCrawlersCommandInput, BatchGetCrawlersCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetCrawlersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchGetDevEndpointsCommand.ts b/clients/client-glue/commands/BatchGetDevEndpointsCommand.ts index 17fabf15b83db..4751980ab6f57 100644 --- a/clients/client-glue/commands/BatchGetDevEndpointsCommand.ts +++ b/clients/client-glue/commands/BatchGetDevEndpointsCommand.ts @@ -20,6 +20,12 @@ import { export type BatchGetDevEndpointsCommandInput = BatchGetDevEndpointsRequest; export type BatchGetDevEndpointsCommandOutput = BatchGetDevEndpointsResponse & __MetadataBearer; +/** + *

Returns a list of resource metadata for a given list of development endpoint names. After + * calling the ListDevEndpoints operation, you can call this operation to access the + * data to which you have been granted permissions. This operation supports all IAM permissions, + * including permission conditions that uses tags.

+ */ export class BatchGetDevEndpointsCommand extends $Command< BatchGetDevEndpointsCommandInput, BatchGetDevEndpointsCommandOutput, @@ -34,6 +40,9 @@ export class BatchGetDevEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchGetJobsCommand.ts b/clients/client-glue/commands/BatchGetJobsCommand.ts index 6fee4c68e4131..07f0f49501ec4 100644 --- a/clients/client-glue/commands/BatchGetJobsCommand.ts +++ b/clients/client-glue/commands/BatchGetJobsCommand.ts @@ -20,6 +20,10 @@ import { export type BatchGetJobsCommandInput = BatchGetJobsRequest; export type BatchGetJobsCommandOutput = BatchGetJobsResponse & __MetadataBearer; +/** + *

Returns a list of resource metadata for a given list of job names. After calling the ListJobs operation, you can call this operation to access the data to which you have been granted permissions. This operation supports all IAM permissions, including permission conditions that uses tags. + *

+ */ export class BatchGetJobsCommand extends $Command< BatchGetJobsCommandInput, BatchGetJobsCommandOutput, @@ -34,6 +38,9 @@ export class BatchGetJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchGetPartitionCommand.ts b/clients/client-glue/commands/BatchGetPartitionCommand.ts index 6bb61757e0570..bb344b66ae0bd 100644 --- a/clients/client-glue/commands/BatchGetPartitionCommand.ts +++ b/clients/client-glue/commands/BatchGetPartitionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetPartitionCommandInput = BatchGetPartitionRequest; export type BatchGetPartitionCommandOutput = BatchGetPartitionResponse & __MetadataBearer; +/** + *

Retrieves partitions in a batch request.

+ */ export class BatchGetPartitionCommand extends $Command< BatchGetPartitionCommandInput, BatchGetPartitionCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetPartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchGetTriggersCommand.ts b/clients/client-glue/commands/BatchGetTriggersCommand.ts index 8b4775debbeb9..7ad0d200627f7 100644 --- a/clients/client-glue/commands/BatchGetTriggersCommand.ts +++ b/clients/client-glue/commands/BatchGetTriggersCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetTriggersCommandInput = BatchGetTriggersRequest; export type BatchGetTriggersCommandOutput = BatchGetTriggersResponse & __MetadataBearer; +/** + *

Returns a list of resource metadata for a given list of trigger names. After calling the ListTriggers operation, you can call this operation to access the data to which you have been granted permissions. This operation supports all IAM permissions, including permission conditions that uses tags.

+ */ export class BatchGetTriggersCommand extends $Command< BatchGetTriggersCommandInput, BatchGetTriggersCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetTriggersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchGetWorkflowsCommand.ts b/clients/client-glue/commands/BatchGetWorkflowsCommand.ts index b8d5aca146b27..77f472b98adda 100644 --- a/clients/client-glue/commands/BatchGetWorkflowsCommand.ts +++ b/clients/client-glue/commands/BatchGetWorkflowsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetWorkflowsCommandInput = BatchGetWorkflowsRequest; export type BatchGetWorkflowsCommandOutput = BatchGetWorkflowsResponse & __MetadataBearer; +/** + *

Returns a list of resource metadata for a given list of workflow names. After calling the ListWorkflows operation, you can call this operation to access the data to which you have been granted permissions. This operation supports all IAM permissions, including permission conditions that uses tags.

+ */ export class BatchGetWorkflowsCommand extends $Command< BatchGetWorkflowsCommandInput, BatchGetWorkflowsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetWorkflowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchStopJobRunCommand.ts b/clients/client-glue/commands/BatchStopJobRunCommand.ts index c6bcac9f3da27..e2733278f27b3 100644 --- a/clients/client-glue/commands/BatchStopJobRunCommand.ts +++ b/clients/client-glue/commands/BatchStopJobRunCommand.ts @@ -20,6 +20,9 @@ import { export type BatchStopJobRunCommandInput = BatchStopJobRunRequest; export type BatchStopJobRunCommandOutput = BatchStopJobRunResponse & __MetadataBearer; +/** + *

Stops one or more job runs for a specified job definition.

+ */ export class BatchStopJobRunCommand extends $Command< BatchStopJobRunCommandInput, BatchStopJobRunCommandOutput, @@ -34,6 +37,9 @@ export class BatchStopJobRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/BatchUpdatePartitionCommand.ts b/clients/client-glue/commands/BatchUpdatePartitionCommand.ts index 0ef6342349760..e8aac4d673120 100644 --- a/clients/client-glue/commands/BatchUpdatePartitionCommand.ts +++ b/clients/client-glue/commands/BatchUpdatePartitionCommand.ts @@ -20,6 +20,9 @@ import { export type BatchUpdatePartitionCommandInput = BatchUpdatePartitionRequest; export type BatchUpdatePartitionCommandOutput = BatchUpdatePartitionResponse & __MetadataBearer; +/** + *

Updates one or more partitions in a batch operation.

+ */ export class BatchUpdatePartitionCommand extends $Command< BatchUpdatePartitionCommandInput, BatchUpdatePartitionCommandOutput, @@ -34,6 +37,9 @@ export class BatchUpdatePartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CancelMLTaskRunCommand.ts b/clients/client-glue/commands/CancelMLTaskRunCommand.ts index 573ce3eee6a65..bee5fc7dca202 100644 --- a/clients/client-glue/commands/CancelMLTaskRunCommand.ts +++ b/clients/client-glue/commands/CancelMLTaskRunCommand.ts @@ -20,6 +20,12 @@ import { export type CancelMLTaskRunCommandInput = CancelMLTaskRunRequest; export type CancelMLTaskRunCommandOutput = CancelMLTaskRunResponse & __MetadataBearer; +/** + *

Cancels (stops) a task run. Machine learning task runs are asynchronous tasks that AWS + * Glue runs on your behalf as part of various machine learning workflows. You can cancel a + * machine learning task run at any time by calling CancelMLTaskRun with a task + * run's parent transform's TransformID and the task run's TaskRunId.

+ */ export class CancelMLTaskRunCommand extends $Command< CancelMLTaskRunCommandInput, CancelMLTaskRunCommandOutput, @@ -34,6 +40,9 @@ export class CancelMLTaskRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateClassifierCommand.ts b/clients/client-glue/commands/CreateClassifierCommand.ts index cb1981c051965..83727e0b5772a 100644 --- a/clients/client-glue/commands/CreateClassifierCommand.ts +++ b/clients/client-glue/commands/CreateClassifierCommand.ts @@ -20,6 +20,11 @@ import { export type CreateClassifierCommandInput = CreateClassifierRequest; export type CreateClassifierCommandOutput = CreateClassifierResponse & __MetadataBearer; +/** + *

Creates a classifier in the user's account. This can be a GrokClassifier, an + * XMLClassifier, a JsonClassifier, or a CsvClassifier, + * depending on which field of the request is present.

+ */ export class CreateClassifierCommand extends $Command< CreateClassifierCommandInput, CreateClassifierCommandOutput, @@ -34,6 +39,9 @@ export class CreateClassifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateConnectionCommand.ts b/clients/client-glue/commands/CreateConnectionCommand.ts index 82f8df42956cf..6b8999fb5b483 100644 --- a/clients/client-glue/commands/CreateConnectionCommand.ts +++ b/clients/client-glue/commands/CreateConnectionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateConnectionCommandInput = CreateConnectionRequest; export type CreateConnectionCommandOutput = CreateConnectionResponse & __MetadataBearer; +/** + *

Creates a connection definition in the Data Catalog.

+ */ export class CreateConnectionCommand extends $Command< CreateConnectionCommandInput, CreateConnectionCommandOutput, @@ -34,6 +37,9 @@ export class CreateConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateCrawlerCommand.ts b/clients/client-glue/commands/CreateCrawlerCommand.ts index 24a9eb405903c..659488dc29cd6 100644 --- a/clients/client-glue/commands/CreateCrawlerCommand.ts +++ b/clients/client-glue/commands/CreateCrawlerCommand.ts @@ -20,6 +20,11 @@ import { export type CreateCrawlerCommandInput = CreateCrawlerRequest; export type CreateCrawlerCommandOutput = CreateCrawlerResponse & __MetadataBearer; +/** + *

Creates a new crawler with specified targets, role, configuration, and optional schedule. + * At least one crawl target must be specified, in the s3Targets field, the + * jdbcTargets field, or the DynamoDBTargets field.

+ */ export class CreateCrawlerCommand extends $Command< CreateCrawlerCommandInput, CreateCrawlerCommandOutput, @@ -34,6 +39,9 @@ export class CreateCrawlerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateDatabaseCommand.ts b/clients/client-glue/commands/CreateDatabaseCommand.ts index 706bfe06f0411..611ecb017e418 100644 --- a/clients/client-glue/commands/CreateDatabaseCommand.ts +++ b/clients/client-glue/commands/CreateDatabaseCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDatabaseCommandInput = CreateDatabaseRequest; export type CreateDatabaseCommandOutput = CreateDatabaseResponse & __MetadataBearer; +/** + *

Creates a new database in a Data Catalog.

+ */ export class CreateDatabaseCommand extends $Command< CreateDatabaseCommandInput, CreateDatabaseCommandOutput, @@ -34,6 +37,9 @@ export class CreateDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateDevEndpointCommand.ts b/clients/client-glue/commands/CreateDevEndpointCommand.ts index 2830fae2c87c9..30e81d5eca35e 100644 --- a/clients/client-glue/commands/CreateDevEndpointCommand.ts +++ b/clients/client-glue/commands/CreateDevEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDevEndpointCommandInput = CreateDevEndpointRequest; export type CreateDevEndpointCommandOutput = CreateDevEndpointResponse & __MetadataBearer; +/** + *

Creates a new development endpoint.

+ */ export class CreateDevEndpointCommand extends $Command< CreateDevEndpointCommandInput, CreateDevEndpointCommandOutput, @@ -34,6 +37,9 @@ export class CreateDevEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateJobCommand.ts b/clients/client-glue/commands/CreateJobCommand.ts index 5bc47794ce198..d6eaa7df66c9a 100644 --- a/clients/client-glue/commands/CreateJobCommand.ts +++ b/clients/client-glue/commands/CreateJobCommand.ts @@ -17,6 +17,9 @@ import { export type CreateJobCommandInput = CreateJobRequest; export type CreateJobCommandOutput = CreateJobResponse & __MetadataBearer; +/** + *

Creates a new job definition.

+ */ export class CreateJobCommand extends $Command< CreateJobCommandInput, CreateJobCommandOutput, @@ -31,6 +34,9 @@ export class CreateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateMLTransformCommand.ts b/clients/client-glue/commands/CreateMLTransformCommand.ts index 849764f65d6cb..53b503c932f24 100644 --- a/clients/client-glue/commands/CreateMLTransformCommand.ts +++ b/clients/client-glue/commands/CreateMLTransformCommand.ts @@ -20,6 +20,21 @@ import { export type CreateMLTransformCommandInput = CreateMLTransformRequest; export type CreateMLTransformCommandOutput = CreateMLTransformResponse & __MetadataBearer; +/** + *

Creates an AWS Glue machine learning transform. This operation creates the transform and + * all the necessary parameters to train it.

+ * + *

Call this operation as the first step in the process of using a machine learning transform + * (such as the FindMatches transform) for deduplicating data. You can provide an + * optional Description, in addition to the parameters that you want to use for your + * algorithm.

+ * + *

You must also specify certain parameters for the tasks that AWS Glue runs on your + * behalf as part of learning from your data and creating a high-quality machine learning + * transform. These parameters include Role, and optionally, + * AllocatedCapacity, Timeout, and MaxRetries. For more + * information, see Jobs.

+ */ export class CreateMLTransformCommand extends $Command< CreateMLTransformCommandInput, CreateMLTransformCommandOutput, @@ -34,6 +49,9 @@ export class CreateMLTransformCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreatePartitionCommand.ts b/clients/client-glue/commands/CreatePartitionCommand.ts index fffe58398c193..f4ba0026c8341 100644 --- a/clients/client-glue/commands/CreatePartitionCommand.ts +++ b/clients/client-glue/commands/CreatePartitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePartitionCommandInput = CreatePartitionRequest; export type CreatePartitionCommandOutput = CreatePartitionResponse & __MetadataBearer; +/** + *

Creates a new partition.

+ */ export class CreatePartitionCommand extends $Command< CreatePartitionCommandInput, CreatePartitionCommandOutput, @@ -34,6 +37,9 @@ export class CreatePartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateScriptCommand.ts b/clients/client-glue/commands/CreateScriptCommand.ts index cf1c1644fd92c..abb3f5c9421f4 100644 --- a/clients/client-glue/commands/CreateScriptCommand.ts +++ b/clients/client-glue/commands/CreateScriptCommand.ts @@ -20,6 +20,9 @@ import { export type CreateScriptCommandInput = CreateScriptRequest; export type CreateScriptCommandOutput = CreateScriptResponse & __MetadataBearer; +/** + *

Transforms a directed acyclic graph (DAG) into code.

+ */ export class CreateScriptCommand extends $Command< CreateScriptCommandInput, CreateScriptCommandOutput, @@ -34,6 +37,9 @@ export class CreateScriptCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateSecurityConfigurationCommand.ts b/clients/client-glue/commands/CreateSecurityConfigurationCommand.ts index 0ab4df6e0cb00..8ee7c1452c4b2 100644 --- a/clients/client-glue/commands/CreateSecurityConfigurationCommand.ts +++ b/clients/client-glue/commands/CreateSecurityConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSecurityConfigurationCommandInput = CreateSecurityConfigurationRequest; export type CreateSecurityConfigurationCommandOutput = CreateSecurityConfigurationResponse & __MetadataBearer; +/** + *

Creates a new security configuration. A security configuration is a set of security properties that can be used by AWS Glue. You can use a security configuration to encrypt data at rest. For information about using security configurations in AWS Glue, see Encrypting Data Written by Crawlers, Jobs, and Development Endpoints.

+ */ export class CreateSecurityConfigurationCommand extends $Command< CreateSecurityConfigurationCommandInput, CreateSecurityConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class CreateSecurityConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateTableCommand.ts b/clients/client-glue/commands/CreateTableCommand.ts index 70f832ac19691..5afecf2004b54 100644 --- a/clients/client-glue/commands/CreateTableCommand.ts +++ b/clients/client-glue/commands/CreateTableCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTableCommandInput = CreateTableRequest; export type CreateTableCommandOutput = CreateTableResponse & __MetadataBearer; +/** + *

Creates a new table definition in the Data Catalog.

+ */ export class CreateTableCommand extends $Command< CreateTableCommandInput, CreateTableCommandOutput, @@ -34,6 +37,9 @@ export class CreateTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateTriggerCommand.ts b/clients/client-glue/commands/CreateTriggerCommand.ts index 4be3a5854ee51..5100feba97740 100644 --- a/clients/client-glue/commands/CreateTriggerCommand.ts +++ b/clients/client-glue/commands/CreateTriggerCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTriggerCommandInput = CreateTriggerRequest; export type CreateTriggerCommandOutput = CreateTriggerResponse & __MetadataBearer; +/** + *

Creates a new trigger.

+ */ export class CreateTriggerCommand extends $Command< CreateTriggerCommandInput, CreateTriggerCommandOutput, @@ -34,6 +37,9 @@ export class CreateTriggerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateUserDefinedFunctionCommand.ts b/clients/client-glue/commands/CreateUserDefinedFunctionCommand.ts index 129ae6171a31e..d00a791b5aef5 100644 --- a/clients/client-glue/commands/CreateUserDefinedFunctionCommand.ts +++ b/clients/client-glue/commands/CreateUserDefinedFunctionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUserDefinedFunctionCommandInput = CreateUserDefinedFunctionRequest; export type CreateUserDefinedFunctionCommandOutput = CreateUserDefinedFunctionResponse & __MetadataBearer; +/** + *

Creates a new function definition in the Data Catalog.

+ */ export class CreateUserDefinedFunctionCommand extends $Command< CreateUserDefinedFunctionCommandInput, CreateUserDefinedFunctionCommandOutput, @@ -34,6 +37,9 @@ export class CreateUserDefinedFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/CreateWorkflowCommand.ts b/clients/client-glue/commands/CreateWorkflowCommand.ts index aa80ac4dc2f71..ebf75917247ac 100644 --- a/clients/client-glue/commands/CreateWorkflowCommand.ts +++ b/clients/client-glue/commands/CreateWorkflowCommand.ts @@ -20,6 +20,9 @@ import { export type CreateWorkflowCommandInput = CreateWorkflowRequest; export type CreateWorkflowCommandOutput = CreateWorkflowResponse & __MetadataBearer; +/** + *

Creates a new workflow.

+ */ export class CreateWorkflowCommand extends $Command< CreateWorkflowCommandInput, CreateWorkflowCommandOutput, @@ -34,6 +37,9 @@ export class CreateWorkflowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteClassifierCommand.ts b/clients/client-glue/commands/DeleteClassifierCommand.ts index fef7cbc6a095d..4b7b6dce53bbb 100644 --- a/clients/client-glue/commands/DeleteClassifierCommand.ts +++ b/clients/client-glue/commands/DeleteClassifierCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteClassifierCommandInput = DeleteClassifierRequest; export type DeleteClassifierCommandOutput = DeleteClassifierResponse & __MetadataBearer; +/** + *

Removes a classifier from the Data Catalog.

+ */ export class DeleteClassifierCommand extends $Command< DeleteClassifierCommandInput, DeleteClassifierCommandOutput, @@ -34,6 +37,9 @@ export class DeleteClassifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteColumnStatisticsForPartitionCommand.ts b/clients/client-glue/commands/DeleteColumnStatisticsForPartitionCommand.ts index 389cb80fae0c3..8987695b4ce76 100644 --- a/clients/client-glue/commands/DeleteColumnStatisticsForPartitionCommand.ts +++ b/clients/client-glue/commands/DeleteColumnStatisticsForPartitionCommand.ts @@ -24,6 +24,11 @@ export type DeleteColumnStatisticsForPartitionCommandInput = DeleteColumnStatist export type DeleteColumnStatisticsForPartitionCommandOutput = DeleteColumnStatisticsForPartitionResponse & __MetadataBearer; +/** + *

Delete the partition column statistics of a column.

+ * + *

The Identity and Access Management (IAM) permission required for this operation is DeletePartition.

+ */ export class DeleteColumnStatisticsForPartitionCommand extends $Command< DeleteColumnStatisticsForPartitionCommandInput, DeleteColumnStatisticsForPartitionCommandOutput, @@ -38,6 +43,9 @@ export class DeleteColumnStatisticsForPartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteColumnStatisticsForTableCommand.ts b/clients/client-glue/commands/DeleteColumnStatisticsForTableCommand.ts index 386834696e54d..d4eb4589cbc1d 100644 --- a/clients/client-glue/commands/DeleteColumnStatisticsForTableCommand.ts +++ b/clients/client-glue/commands/DeleteColumnStatisticsForTableCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteColumnStatisticsForTableCommandInput = DeleteColumnStatisticsForTableRequest; export type DeleteColumnStatisticsForTableCommandOutput = DeleteColumnStatisticsForTableResponse & __MetadataBearer; +/** + *

Retrieves table statistics of columns.

+ * + *

The Identity and Access Management (IAM) permission required for this operation is DeleteTable.

+ */ export class DeleteColumnStatisticsForTableCommand extends $Command< DeleteColumnStatisticsForTableCommandInput, DeleteColumnStatisticsForTableCommandOutput, @@ -34,6 +39,9 @@ export class DeleteColumnStatisticsForTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteConnectionCommand.ts b/clients/client-glue/commands/DeleteConnectionCommand.ts index 04a513fe57c22..367cea95c0dee 100644 --- a/clients/client-glue/commands/DeleteConnectionCommand.ts +++ b/clients/client-glue/commands/DeleteConnectionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteConnectionCommandInput = DeleteConnectionRequest; export type DeleteConnectionCommandOutput = DeleteConnectionResponse & __MetadataBearer; +/** + *

Deletes a connection from the Data Catalog.

+ */ export class DeleteConnectionCommand extends $Command< DeleteConnectionCommandInput, DeleteConnectionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteCrawlerCommand.ts b/clients/client-glue/commands/DeleteCrawlerCommand.ts index adf369111d527..f30f5e9af17a2 100644 --- a/clients/client-glue/commands/DeleteCrawlerCommand.ts +++ b/clients/client-glue/commands/DeleteCrawlerCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteCrawlerCommandInput = DeleteCrawlerRequest; export type DeleteCrawlerCommandOutput = DeleteCrawlerResponse & __MetadataBearer; +/** + *

Removes a specified crawler from the AWS Glue Data Catalog, unless the crawler state is + * RUNNING.

+ */ export class DeleteCrawlerCommand extends $Command< DeleteCrawlerCommandInput, DeleteCrawlerCommandOutput, @@ -34,6 +38,9 @@ export class DeleteCrawlerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteDatabaseCommand.ts b/clients/client-glue/commands/DeleteDatabaseCommand.ts index 6116715731dc9..d37d8a91bcdf8 100644 --- a/clients/client-glue/commands/DeleteDatabaseCommand.ts +++ b/clients/client-glue/commands/DeleteDatabaseCommand.ts @@ -20,6 +20,21 @@ import { export type DeleteDatabaseCommandInput = DeleteDatabaseRequest; export type DeleteDatabaseCommandOutput = DeleteDatabaseResponse & __MetadataBearer; +/** + *

Removes a specified database from a Data Catalog.

+ * + *

After completing this operation, you no longer have access to the tables (and all table + * versions and partitions that might belong to the tables) and the user-defined functions in + * the deleted database. AWS Glue deletes these "orphaned" resources asynchronously in a timely + * manner, at the discretion of the service.

+ *

To ensure the immediate deletion of all related resources, before calling + * DeleteDatabase, use DeleteTableVersion or + * BatchDeleteTableVersion, DeletePartition or + * BatchDeletePartition, DeleteUserDefinedFunction, and + * DeleteTable or BatchDeleteTable, to delete any resources that + * belong to the database.

+ *
+ */ export class DeleteDatabaseCommand extends $Command< DeleteDatabaseCommandInput, DeleteDatabaseCommandOutput, @@ -34,6 +49,9 @@ export class DeleteDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteDevEndpointCommand.ts b/clients/client-glue/commands/DeleteDevEndpointCommand.ts index 5587c723e1215..bef1fe93581e6 100644 --- a/clients/client-glue/commands/DeleteDevEndpointCommand.ts +++ b/clients/client-glue/commands/DeleteDevEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDevEndpointCommandInput = DeleteDevEndpointRequest; export type DeleteDevEndpointCommandOutput = DeleteDevEndpointResponse & __MetadataBearer; +/** + *

Deletes a specified development endpoint.

+ */ export class DeleteDevEndpointCommand extends $Command< DeleteDevEndpointCommandInput, DeleteDevEndpointCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDevEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteJobCommand.ts b/clients/client-glue/commands/DeleteJobCommand.ts index ac9504ec42605..e183aab791b00 100644 --- a/clients/client-glue/commands/DeleteJobCommand.ts +++ b/clients/client-glue/commands/DeleteJobCommand.ts @@ -17,6 +17,10 @@ import { export type DeleteJobCommandInput = DeleteJobRequest; export type DeleteJobCommandOutput = DeleteJobResponse & __MetadataBearer; +/** + *

Deletes a specified job definition. If the job definition + * is not found, no exception is thrown.

+ */ export class DeleteJobCommand extends $Command< DeleteJobCommandInput, DeleteJobCommandOutput, @@ -31,6 +35,9 @@ export class DeleteJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteMLTransformCommand.ts b/clients/client-glue/commands/DeleteMLTransformCommand.ts index cca2876295eeb..8b02db79e04fa 100644 --- a/clients/client-glue/commands/DeleteMLTransformCommand.ts +++ b/clients/client-glue/commands/DeleteMLTransformCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteMLTransformCommandInput = DeleteMLTransformRequest; export type DeleteMLTransformCommandOutput = DeleteMLTransformResponse & __MetadataBearer; +/** + *

Deletes an AWS Glue machine learning transform. Machine learning transforms are a special + * type of transform that use machine learning to learn the details of the transformation to be + * performed by learning from examples provided by humans. These transformations are then saved + * by AWS Glue. If you no longer need a transform, you can delete it by calling + * DeleteMLTransforms. However, any AWS Glue jobs that still reference the deleted + * transform will no longer succeed.

+ */ export class DeleteMLTransformCommand extends $Command< DeleteMLTransformCommandInput, DeleteMLTransformCommandOutput, @@ -34,6 +42,9 @@ export class DeleteMLTransformCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeletePartitionCommand.ts b/clients/client-glue/commands/DeletePartitionCommand.ts index dfe8654e15d5e..b7703959327af 100644 --- a/clients/client-glue/commands/DeletePartitionCommand.ts +++ b/clients/client-glue/commands/DeletePartitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePartitionCommandInput = DeletePartitionRequest; export type DeletePartitionCommandOutput = DeletePartitionResponse & __MetadataBearer; +/** + *

Deletes a specified partition.

+ */ export class DeletePartitionCommand extends $Command< DeletePartitionCommandInput, DeletePartitionCommandOutput, @@ -34,6 +37,9 @@ export class DeletePartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteResourcePolicyCommand.ts b/clients/client-glue/commands/DeleteResourcePolicyCommand.ts index 05d369cf4352f..2cc1b16a79e06 100644 --- a/clients/client-glue/commands/DeleteResourcePolicyCommand.ts +++ b/clients/client-glue/commands/DeleteResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourcePolicyCommandInput = DeleteResourcePolicyRequest; export type DeleteResourcePolicyCommandOutput = DeleteResourcePolicyResponse & __MetadataBearer; +/** + *

Deletes a specified policy.

+ */ export class DeleteResourcePolicyCommand extends $Command< DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteSecurityConfigurationCommand.ts b/clients/client-glue/commands/DeleteSecurityConfigurationCommand.ts index 9353cfe365f26..842ea8553c511 100644 --- a/clients/client-glue/commands/DeleteSecurityConfigurationCommand.ts +++ b/clients/client-glue/commands/DeleteSecurityConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSecurityConfigurationCommandInput = DeleteSecurityConfigurationRequest; export type DeleteSecurityConfigurationCommandOutput = DeleteSecurityConfigurationResponse & __MetadataBearer; +/** + *

Deletes a specified security configuration.

+ */ export class DeleteSecurityConfigurationCommand extends $Command< DeleteSecurityConfigurationCommandInput, DeleteSecurityConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSecurityConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteTableCommand.ts b/clients/client-glue/commands/DeleteTableCommand.ts index 146bea3e88b78..2f25f41b07255 100644 --- a/clients/client-glue/commands/DeleteTableCommand.ts +++ b/clients/client-glue/commands/DeleteTableCommand.ts @@ -20,6 +20,19 @@ import { export type DeleteTableCommandInput = DeleteTableRequest; export type DeleteTableCommandOutput = DeleteTableResponse & __MetadataBearer; +/** + *

Removes a table definition from the Data Catalog.

+ * + *

After completing this operation, you no longer have access to the table versions and + * partitions that belong to the deleted table. AWS Glue deletes these "orphaned" resources + * asynchronously in a timely manner, at the discretion of the service.

+ *

To ensure the immediate deletion of all related resources, before calling + * DeleteTable, use DeleteTableVersion or + * BatchDeleteTableVersion, and DeletePartition or + * BatchDeletePartition, to delete any resources that belong to the + * table.

+ *
+ */ export class DeleteTableCommand extends $Command< DeleteTableCommandInput, DeleteTableCommandOutput, @@ -34,6 +47,9 @@ export class DeleteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteTableVersionCommand.ts b/clients/client-glue/commands/DeleteTableVersionCommand.ts index f3ca34840cddc..f92b1f64bbbd1 100644 --- a/clients/client-glue/commands/DeleteTableVersionCommand.ts +++ b/clients/client-glue/commands/DeleteTableVersionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTableVersionCommandInput = DeleteTableVersionRequest; export type DeleteTableVersionCommandOutput = DeleteTableVersionResponse & __MetadataBearer; +/** + *

Deletes a specified version of a table.

+ */ export class DeleteTableVersionCommand extends $Command< DeleteTableVersionCommandInput, DeleteTableVersionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTableVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteTriggerCommand.ts b/clients/client-glue/commands/DeleteTriggerCommand.ts index 460655ff4c587..48b0e0e50c649 100644 --- a/clients/client-glue/commands/DeleteTriggerCommand.ts +++ b/clients/client-glue/commands/DeleteTriggerCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTriggerCommandInput = DeleteTriggerRequest; export type DeleteTriggerCommandOutput = DeleteTriggerResponse & __MetadataBearer; +/** + *

Deletes a specified trigger. If the trigger is not found, no + * exception is thrown.

+ */ export class DeleteTriggerCommand extends $Command< DeleteTriggerCommandInput, DeleteTriggerCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTriggerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteUserDefinedFunctionCommand.ts b/clients/client-glue/commands/DeleteUserDefinedFunctionCommand.ts index 3c409e04c80d7..797c86e0352e9 100644 --- a/clients/client-glue/commands/DeleteUserDefinedFunctionCommand.ts +++ b/clients/client-glue/commands/DeleteUserDefinedFunctionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserDefinedFunctionCommandInput = DeleteUserDefinedFunctionRequest; export type DeleteUserDefinedFunctionCommandOutput = DeleteUserDefinedFunctionResponse & __MetadataBearer; +/** + *

Deletes an existing function definition from the Data Catalog.

+ */ export class DeleteUserDefinedFunctionCommand extends $Command< DeleteUserDefinedFunctionCommandInput, DeleteUserDefinedFunctionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserDefinedFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/DeleteWorkflowCommand.ts b/clients/client-glue/commands/DeleteWorkflowCommand.ts index b187f151b853b..595a853be4a94 100644 --- a/clients/client-glue/commands/DeleteWorkflowCommand.ts +++ b/clients/client-glue/commands/DeleteWorkflowCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteWorkflowCommandInput = DeleteWorkflowRequest; export type DeleteWorkflowCommandOutput = DeleteWorkflowResponse & __MetadataBearer; +/** + *

Deletes a workflow.

+ */ export class DeleteWorkflowCommand extends $Command< DeleteWorkflowCommandInput, DeleteWorkflowCommandOutput, @@ -34,6 +37,9 @@ export class DeleteWorkflowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetCatalogImportStatusCommand.ts b/clients/client-glue/commands/GetCatalogImportStatusCommand.ts index 1c210a15c1f3c..44f7a15e22f51 100644 --- a/clients/client-glue/commands/GetCatalogImportStatusCommand.ts +++ b/clients/client-glue/commands/GetCatalogImportStatusCommand.ts @@ -20,6 +20,9 @@ import { export type GetCatalogImportStatusCommandInput = GetCatalogImportStatusRequest; export type GetCatalogImportStatusCommandOutput = GetCatalogImportStatusResponse & __MetadataBearer; +/** + *

Retrieves the status of a migration operation.

+ */ export class GetCatalogImportStatusCommand extends $Command< GetCatalogImportStatusCommandInput, GetCatalogImportStatusCommandOutput, @@ -34,6 +37,9 @@ export class GetCatalogImportStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetClassifierCommand.ts b/clients/client-glue/commands/GetClassifierCommand.ts index 5c7dd1b3b2b11..f1f53d9682e52 100644 --- a/clients/client-glue/commands/GetClassifierCommand.ts +++ b/clients/client-glue/commands/GetClassifierCommand.ts @@ -20,6 +20,9 @@ import { export type GetClassifierCommandInput = GetClassifierRequest; export type GetClassifierCommandOutput = GetClassifierResponse & __MetadataBearer; +/** + *

Retrieve a classifier by name.

+ */ export class GetClassifierCommand extends $Command< GetClassifierCommandInput, GetClassifierCommandOutput, @@ -34,6 +37,9 @@ export class GetClassifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetClassifiersCommand.ts b/clients/client-glue/commands/GetClassifiersCommand.ts index ffdd2f23e5e8e..7e6fa8f5b6cfa 100644 --- a/clients/client-glue/commands/GetClassifiersCommand.ts +++ b/clients/client-glue/commands/GetClassifiersCommand.ts @@ -20,6 +20,9 @@ import { export type GetClassifiersCommandInput = GetClassifiersRequest; export type GetClassifiersCommandOutput = GetClassifiersResponse & __MetadataBearer; +/** + *

Lists all classifier objects in the Data Catalog.

+ */ export class GetClassifiersCommand extends $Command< GetClassifiersCommandInput, GetClassifiersCommandOutput, @@ -34,6 +37,9 @@ export class GetClassifiersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetColumnStatisticsForPartitionCommand.ts b/clients/client-glue/commands/GetColumnStatisticsForPartitionCommand.ts index cfc7f49e2cbfe..ba479ffb37ce4 100644 --- a/clients/client-glue/commands/GetColumnStatisticsForPartitionCommand.ts +++ b/clients/client-glue/commands/GetColumnStatisticsForPartitionCommand.ts @@ -20,6 +20,11 @@ import { export type GetColumnStatisticsForPartitionCommandInput = GetColumnStatisticsForPartitionRequest; export type GetColumnStatisticsForPartitionCommandOutput = GetColumnStatisticsForPartitionResponse & __MetadataBearer; +/** + *

Retrieves partition statistics of columns.

+ * + *

The Identity and Access Management (IAM) permission required for this operation is GetPartition.

+ */ export class GetColumnStatisticsForPartitionCommand extends $Command< GetColumnStatisticsForPartitionCommandInput, GetColumnStatisticsForPartitionCommandOutput, @@ -34,6 +39,9 @@ export class GetColumnStatisticsForPartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetColumnStatisticsForTableCommand.ts b/clients/client-glue/commands/GetColumnStatisticsForTableCommand.ts index 253e6d6d9cef3..d9c1cc9f4e73d 100644 --- a/clients/client-glue/commands/GetColumnStatisticsForTableCommand.ts +++ b/clients/client-glue/commands/GetColumnStatisticsForTableCommand.ts @@ -20,6 +20,11 @@ import { export type GetColumnStatisticsForTableCommandInput = GetColumnStatisticsForTableRequest; export type GetColumnStatisticsForTableCommandOutput = GetColumnStatisticsForTableResponse & __MetadataBearer; +/** + *

Retrieves table statistics of columns.

+ * + *

The Identity and Access Management (IAM) permission required for this operation is GetTable.

+ */ export class GetColumnStatisticsForTableCommand extends $Command< GetColumnStatisticsForTableCommandInput, GetColumnStatisticsForTableCommandOutput, @@ -34,6 +39,9 @@ export class GetColumnStatisticsForTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetConnectionCommand.ts b/clients/client-glue/commands/GetConnectionCommand.ts index 61a0dbe94d704..1b978030b11c3 100644 --- a/clients/client-glue/commands/GetConnectionCommand.ts +++ b/clients/client-glue/commands/GetConnectionCommand.ts @@ -20,6 +20,9 @@ import { export type GetConnectionCommandInput = GetConnectionRequest; export type GetConnectionCommandOutput = GetConnectionResponse & __MetadataBearer; +/** + *

Retrieves a connection definition from the Data Catalog.

+ */ export class GetConnectionCommand extends $Command< GetConnectionCommandInput, GetConnectionCommandOutput, @@ -34,6 +37,9 @@ export class GetConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetConnectionsCommand.ts b/clients/client-glue/commands/GetConnectionsCommand.ts index 18eaadaa4847e..7794715eb0c6e 100644 --- a/clients/client-glue/commands/GetConnectionsCommand.ts +++ b/clients/client-glue/commands/GetConnectionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetConnectionsCommandInput = GetConnectionsRequest; export type GetConnectionsCommandOutput = GetConnectionsResponse & __MetadataBearer; +/** + *

Retrieves a list of connection definitions from the Data Catalog.

+ */ export class GetConnectionsCommand extends $Command< GetConnectionsCommandInput, GetConnectionsCommandOutput, @@ -34,6 +37,9 @@ export class GetConnectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetCrawlerCommand.ts b/clients/client-glue/commands/GetCrawlerCommand.ts index 78166f7ab1e07..c3f8f0d86400d 100644 --- a/clients/client-glue/commands/GetCrawlerCommand.ts +++ b/clients/client-glue/commands/GetCrawlerCommand.ts @@ -20,6 +20,9 @@ import { export type GetCrawlerCommandInput = GetCrawlerRequest; export type GetCrawlerCommandOutput = GetCrawlerResponse & __MetadataBearer; +/** + *

Retrieves metadata for a specified crawler.

+ */ export class GetCrawlerCommand extends $Command< GetCrawlerCommandInput, GetCrawlerCommandOutput, @@ -34,6 +37,9 @@ export class GetCrawlerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetCrawlerMetricsCommand.ts b/clients/client-glue/commands/GetCrawlerMetricsCommand.ts index 62ae761135808..4d25bb46ca4f8 100644 --- a/clients/client-glue/commands/GetCrawlerMetricsCommand.ts +++ b/clients/client-glue/commands/GetCrawlerMetricsCommand.ts @@ -20,6 +20,9 @@ import { export type GetCrawlerMetricsCommandInput = GetCrawlerMetricsRequest; export type GetCrawlerMetricsCommandOutput = GetCrawlerMetricsResponse & __MetadataBearer; +/** + *

Retrieves metrics about specified crawlers.

+ */ export class GetCrawlerMetricsCommand extends $Command< GetCrawlerMetricsCommandInput, GetCrawlerMetricsCommandOutput, @@ -34,6 +37,9 @@ export class GetCrawlerMetricsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetCrawlersCommand.ts b/clients/client-glue/commands/GetCrawlersCommand.ts index f070b792b2600..f4d796118957d 100644 --- a/clients/client-glue/commands/GetCrawlersCommand.ts +++ b/clients/client-glue/commands/GetCrawlersCommand.ts @@ -20,6 +20,10 @@ import { export type GetCrawlersCommandInput = GetCrawlersRequest; export type GetCrawlersCommandOutput = GetCrawlersResponse & __MetadataBearer; +/** + *

Retrieves metadata for all crawlers defined in the customer + * account.

+ */ export class GetCrawlersCommand extends $Command< GetCrawlersCommandInput, GetCrawlersCommandOutput, @@ -34,6 +38,9 @@ export class GetCrawlersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetDataCatalogEncryptionSettingsCommand.ts b/clients/client-glue/commands/GetDataCatalogEncryptionSettingsCommand.ts index b3cc840f82cd7..2192ee0cd7c60 100644 --- a/clients/client-glue/commands/GetDataCatalogEncryptionSettingsCommand.ts +++ b/clients/client-glue/commands/GetDataCatalogEncryptionSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetDataCatalogEncryptionSettingsCommandInput = GetDataCatalogEncryptionSettingsRequest; export type GetDataCatalogEncryptionSettingsCommandOutput = GetDataCatalogEncryptionSettingsResponse & __MetadataBearer; +/** + *

Retrieves the security configuration for a specified catalog.

+ */ export class GetDataCatalogEncryptionSettingsCommand extends $Command< GetDataCatalogEncryptionSettingsCommandInput, GetDataCatalogEncryptionSettingsCommandOutput, @@ -34,6 +37,9 @@ export class GetDataCatalogEncryptionSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetDatabaseCommand.ts b/clients/client-glue/commands/GetDatabaseCommand.ts index 0b55f36729860..9ed1d628e1fe1 100644 --- a/clients/client-glue/commands/GetDatabaseCommand.ts +++ b/clients/client-glue/commands/GetDatabaseCommand.ts @@ -20,6 +20,9 @@ import { export type GetDatabaseCommandInput = GetDatabaseRequest; export type GetDatabaseCommandOutput = GetDatabaseResponse & __MetadataBearer; +/** + *

Retrieves the definition of a specified database.

+ */ export class GetDatabaseCommand extends $Command< GetDatabaseCommandInput, GetDatabaseCommandOutput, @@ -34,6 +37,9 @@ export class GetDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetDatabasesCommand.ts b/clients/client-glue/commands/GetDatabasesCommand.ts index 998d932a6cdfc..670bb2d30e0fb 100644 --- a/clients/client-glue/commands/GetDatabasesCommand.ts +++ b/clients/client-glue/commands/GetDatabasesCommand.ts @@ -20,6 +20,9 @@ import { export type GetDatabasesCommandInput = GetDatabasesRequest; export type GetDatabasesCommandOutput = GetDatabasesResponse & __MetadataBearer; +/** + *

Retrieves all databases defined in a given Data Catalog.

+ */ export class GetDatabasesCommand extends $Command< GetDatabasesCommandInput, GetDatabasesCommandOutput, @@ -34,6 +37,9 @@ export class GetDatabasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetDataflowGraphCommand.ts b/clients/client-glue/commands/GetDataflowGraphCommand.ts index a49c0011eea71..cf590fab8bad1 100644 --- a/clients/client-glue/commands/GetDataflowGraphCommand.ts +++ b/clients/client-glue/commands/GetDataflowGraphCommand.ts @@ -20,6 +20,9 @@ import { export type GetDataflowGraphCommandInput = GetDataflowGraphRequest; export type GetDataflowGraphCommandOutput = GetDataflowGraphResponse & __MetadataBearer; +/** + *

Transforms a Python script into a directed acyclic graph (DAG).

+ */ export class GetDataflowGraphCommand extends $Command< GetDataflowGraphCommandInput, GetDataflowGraphCommandOutput, @@ -34,6 +37,9 @@ export class GetDataflowGraphCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetDevEndpointCommand.ts b/clients/client-glue/commands/GetDevEndpointCommand.ts index d060a0aea84ce..0e0c791553252 100644 --- a/clients/client-glue/commands/GetDevEndpointCommand.ts +++ b/clients/client-glue/commands/GetDevEndpointCommand.ts @@ -20,6 +20,14 @@ import { export type GetDevEndpointCommandInput = GetDevEndpointRequest; export type GetDevEndpointCommandOutput = GetDevEndpointResponse & __MetadataBearer; +/** + *

Retrieves information about a specified development endpoint.

+ * + *

When you create a development endpoint in a virtual private cloud (VPC), AWS Glue returns only + * a private IP address, and the public IP address field is not populated. When you create a + * non-VPC development endpoint, AWS Glue returns only a public IP address.

+ *
+ */ export class GetDevEndpointCommand extends $Command< GetDevEndpointCommandInput, GetDevEndpointCommandOutput, @@ -34,6 +42,9 @@ export class GetDevEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetDevEndpointsCommand.ts b/clients/client-glue/commands/GetDevEndpointsCommand.ts index 10b843f93ac43..ffa44ada3ed6e 100644 --- a/clients/client-glue/commands/GetDevEndpointsCommand.ts +++ b/clients/client-glue/commands/GetDevEndpointsCommand.ts @@ -20,6 +20,14 @@ import { export type GetDevEndpointsCommandInput = GetDevEndpointsRequest; export type GetDevEndpointsCommandOutput = GetDevEndpointsResponse & __MetadataBearer; +/** + *

Retrieves all the development endpoints in this AWS account.

+ * + *

When you create a development endpoint in a virtual private cloud (VPC), AWS Glue returns only a private IP address + * and the public IP address field is not populated. When you create a non-VPC development + * endpoint, AWS Glue returns only a public IP address.

+ *
+ */ export class GetDevEndpointsCommand extends $Command< GetDevEndpointsCommandInput, GetDevEndpointsCommandOutput, @@ -34,6 +42,9 @@ export class GetDevEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetJobBookmarkCommand.ts b/clients/client-glue/commands/GetJobBookmarkCommand.ts index 094598e98b434..aca5c4e4005dc 100644 --- a/clients/client-glue/commands/GetJobBookmarkCommand.ts +++ b/clients/client-glue/commands/GetJobBookmarkCommand.ts @@ -20,6 +20,9 @@ import { export type GetJobBookmarkCommandInput = GetJobBookmarkRequest; export type GetJobBookmarkCommandOutput = GetJobBookmarkResponse & __MetadataBearer; +/** + *

Returns information on a job bookmark entry.

+ */ export class GetJobBookmarkCommand extends $Command< GetJobBookmarkCommandInput, GetJobBookmarkCommandOutput, @@ -34,6 +37,9 @@ export class GetJobBookmarkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetJobCommand.ts b/clients/client-glue/commands/GetJobCommand.ts index 36ee5f29c49d9..f10eb3ca9dc2d 100644 --- a/clients/client-glue/commands/GetJobCommand.ts +++ b/clients/client-glue/commands/GetJobCommand.ts @@ -17,6 +17,9 @@ import { export type GetJobCommandInput = GetJobRequest; export type GetJobCommandOutput = GetJobResponse & __MetadataBearer; +/** + *

Retrieves an existing job definition.

+ */ export class GetJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetJobCommand extends $Command, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetJobRunCommand.ts b/clients/client-glue/commands/GetJobRunCommand.ts index a3e9ab9e33c8d..fd07df0e4b224 100644 --- a/clients/client-glue/commands/GetJobRunCommand.ts +++ b/clients/client-glue/commands/GetJobRunCommand.ts @@ -17,6 +17,9 @@ import { export type GetJobRunCommandInput = GetJobRunRequest; export type GetJobRunCommandOutput = GetJobRunResponse & __MetadataBearer; +/** + *

Retrieves the metadata for a given job run.

+ */ export class GetJobRunCommand extends $Command< GetJobRunCommandInput, GetJobRunCommandOutput, @@ -31,6 +34,9 @@ export class GetJobRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetJobRunsCommand.ts b/clients/client-glue/commands/GetJobRunsCommand.ts index 16f6a869feb51..76b4cf0f24dd3 100644 --- a/clients/client-glue/commands/GetJobRunsCommand.ts +++ b/clients/client-glue/commands/GetJobRunsCommand.ts @@ -20,6 +20,9 @@ import { export type GetJobRunsCommandInput = GetJobRunsRequest; export type GetJobRunsCommandOutput = GetJobRunsResponse & __MetadataBearer; +/** + *

Retrieves metadata for all runs of a given job definition.

+ */ export class GetJobRunsCommand extends $Command< GetJobRunsCommandInput, GetJobRunsCommandOutput, @@ -34,6 +37,9 @@ export class GetJobRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetJobsCommand.ts b/clients/client-glue/commands/GetJobsCommand.ts index 3b7015263a3d8..c19a99b1a576f 100644 --- a/clients/client-glue/commands/GetJobsCommand.ts +++ b/clients/client-glue/commands/GetJobsCommand.ts @@ -17,6 +17,9 @@ import { export type GetJobsCommandInput = GetJobsRequest; export type GetJobsCommandOutput = GetJobsResponse & __MetadataBearer; +/** + *

Retrieves all current job definitions.

+ */ export class GetJobsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetJobsCommand extends $Command, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetMLTaskRunCommand.ts b/clients/client-glue/commands/GetMLTaskRunCommand.ts index e32e9c72202fc..ed6f07fa7a992 100644 --- a/clients/client-glue/commands/GetMLTaskRunCommand.ts +++ b/clients/client-glue/commands/GetMLTaskRunCommand.ts @@ -20,6 +20,13 @@ import { export type GetMLTaskRunCommandInput = GetMLTaskRunRequest; export type GetMLTaskRunCommandOutput = GetMLTaskRunResponse & __MetadataBearer; +/** + *

Gets details for a specific task run on a machine learning transform. Machine learning + * task runs are asynchronous tasks that AWS Glue runs on your behalf as part of various machine + * learning workflows. You can check the stats of any task run by calling + * GetMLTaskRun with the TaskRunID and its parent transform's + * TransformID.

+ */ export class GetMLTaskRunCommand extends $Command< GetMLTaskRunCommandInput, GetMLTaskRunCommandOutput, @@ -34,6 +41,9 @@ export class GetMLTaskRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetMLTaskRunsCommand.ts b/clients/client-glue/commands/GetMLTaskRunsCommand.ts index 742ee4bdc970f..5d45f2301cbd2 100644 --- a/clients/client-glue/commands/GetMLTaskRunsCommand.ts +++ b/clients/client-glue/commands/GetMLTaskRunsCommand.ts @@ -20,6 +20,15 @@ import { export type GetMLTaskRunsCommandInput = GetMLTaskRunsRequest; export type GetMLTaskRunsCommandOutput = GetMLTaskRunsResponse & __MetadataBearer; +/** + *

Gets a list of runs for a machine learning transform. Machine learning task runs are + * asynchronous tasks that AWS Glue runs on your behalf as part of various machine learning + * workflows. You can get a sortable, filterable list of machine learning task runs by calling + * GetMLTaskRuns with their parent transform's TransformID and other + * optional parameters as documented in this section.

+ * + *

This operation returns a list of historic runs and must be paginated.

+ */ export class GetMLTaskRunsCommand extends $Command< GetMLTaskRunsCommandInput, GetMLTaskRunsCommandOutput, @@ -34,6 +43,9 @@ export class GetMLTaskRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetMLTransformCommand.ts b/clients/client-glue/commands/GetMLTransformCommand.ts index bff000e97390a..40a828e8a8b2c 100644 --- a/clients/client-glue/commands/GetMLTransformCommand.ts +++ b/clients/client-glue/commands/GetMLTransformCommand.ts @@ -21,6 +21,13 @@ import { export type GetMLTransformCommandInput = GetMLTransformRequest; export type GetMLTransformCommandOutput = GetMLTransformResponse & __MetadataBearer; +/** + *

Gets an AWS Glue machine learning transform artifact and all its corresponding metadata. + * Machine learning transforms are a special type of transform that use machine learning to learn + * the details of the transformation to be performed by learning from examples provided by + * humans. These transformations are then saved by AWS Glue. You can retrieve their metadata by + * calling GetMLTransform.

+ */ export class GetMLTransformCommand extends $Command< GetMLTransformCommandInput, GetMLTransformCommandOutput, @@ -35,6 +42,9 @@ export class GetMLTransformCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetMLTransformsCommand.ts b/clients/client-glue/commands/GetMLTransformsCommand.ts index 1cbe6f11d0e21..773f46cc439bd 100644 --- a/clients/client-glue/commands/GetMLTransformsCommand.ts +++ b/clients/client-glue/commands/GetMLTransformsCommand.ts @@ -20,6 +20,13 @@ import { export type GetMLTransformsCommandInput = GetMLTransformsRequest; export type GetMLTransformsCommandOutput = GetMLTransformsResponse & __MetadataBearer; +/** + *

Gets a sortable, filterable list of existing AWS Glue machine learning transforms. Machine + * learning transforms are a special type of transform that use machine learning to learn the + * details of the transformation to be performed by learning from examples provided by humans. + * These transformations are then saved by AWS Glue, and you can retrieve their metadata by + * calling GetMLTransforms.

+ */ export class GetMLTransformsCommand extends $Command< GetMLTransformsCommandInput, GetMLTransformsCommandOutput, @@ -34,6 +41,9 @@ export class GetMLTransformsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetMappingCommand.ts b/clients/client-glue/commands/GetMappingCommand.ts index b2c78abc02b6f..5a90b5b5994ef 100644 --- a/clients/client-glue/commands/GetMappingCommand.ts +++ b/clients/client-glue/commands/GetMappingCommand.ts @@ -20,6 +20,9 @@ import { export type GetMappingCommandInput = GetMappingRequest; export type GetMappingCommandOutput = GetMappingResponse & __MetadataBearer; +/** + *

Creates mappings.

+ */ export class GetMappingCommand extends $Command< GetMappingCommandInput, GetMappingCommandOutput, @@ -34,6 +37,9 @@ export class GetMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetPartitionCommand.ts b/clients/client-glue/commands/GetPartitionCommand.ts index 044affa1c6d2a..1160c1c16a565 100644 --- a/clients/client-glue/commands/GetPartitionCommand.ts +++ b/clients/client-glue/commands/GetPartitionCommand.ts @@ -20,6 +20,9 @@ import { export type GetPartitionCommandInput = GetPartitionRequest; export type GetPartitionCommandOutput = GetPartitionResponse & __MetadataBearer; +/** + *

Retrieves information about a specified partition.

+ */ export class GetPartitionCommand extends $Command< GetPartitionCommandInput, GetPartitionCommandOutput, @@ -34,6 +37,9 @@ export class GetPartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetPartitionIndexesCommand.ts b/clients/client-glue/commands/GetPartitionIndexesCommand.ts index 7c7db02e669d9..46232660f8f03 100644 --- a/clients/client-glue/commands/GetPartitionIndexesCommand.ts +++ b/clients/client-glue/commands/GetPartitionIndexesCommand.ts @@ -20,6 +20,9 @@ import { export type GetPartitionIndexesCommandInput = GetPartitionIndexesRequest; export type GetPartitionIndexesCommandOutput = GetPartitionIndexesResponse & __MetadataBearer; +/** + *

Retrieves the partition indexes associated with a table.

+ */ export class GetPartitionIndexesCommand extends $Command< GetPartitionIndexesCommandInput, GetPartitionIndexesCommandOutput, @@ -34,6 +37,9 @@ export class GetPartitionIndexesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetPartitionsCommand.ts b/clients/client-glue/commands/GetPartitionsCommand.ts index 6e0b46b9fe159..0cefe3a42da7e 100644 --- a/clients/client-glue/commands/GetPartitionsCommand.ts +++ b/clients/client-glue/commands/GetPartitionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetPartitionsCommandInput = GetPartitionsRequest; export type GetPartitionsCommandOutput = GetPartitionsResponse & __MetadataBearer; +/** + *

Retrieves information about the partitions in a table.

+ */ export class GetPartitionsCommand extends $Command< GetPartitionsCommandInput, GetPartitionsCommandOutput, @@ -34,6 +37,9 @@ export class GetPartitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetPlanCommand.ts b/clients/client-glue/commands/GetPlanCommand.ts index ab16bb01d9b6a..874ebdb2b82e2 100644 --- a/clients/client-glue/commands/GetPlanCommand.ts +++ b/clients/client-glue/commands/GetPlanCommand.ts @@ -17,6 +17,9 @@ import { export type GetPlanCommandInput = GetPlanRequest; export type GetPlanCommandOutput = GetPlanResponse & __MetadataBearer; +/** + *

Gets code to perform a specified mapping.

+ */ export class GetPlanCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetPlanCommand extends $Command, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetResourcePoliciesCommand.ts b/clients/client-glue/commands/GetResourcePoliciesCommand.ts index fa216dc4f4428..54de2253beb80 100644 --- a/clients/client-glue/commands/GetResourcePoliciesCommand.ts +++ b/clients/client-glue/commands/GetResourcePoliciesCommand.ts @@ -20,6 +20,11 @@ import { export type GetResourcePoliciesCommandInput = GetResourcePoliciesRequest; export type GetResourcePoliciesCommandOutput = GetResourcePoliciesResponse & __MetadataBearer; +/** + *

Retrieves the security configurations for the resource policies set on individual resources, and also the account-level policy.

+ * + *

This operation also returns the Data Catalog resource policy. However, if you enabled metadata encryption in Data Catalog settings, and you do not have permission on the AWS KMS key, the operation can't return the Data Catalog resource policy.

+ */ export class GetResourcePoliciesCommand extends $Command< GetResourcePoliciesCommandInput, GetResourcePoliciesCommandOutput, @@ -34,6 +39,9 @@ export class GetResourcePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetResourcePolicyCommand.ts b/clients/client-glue/commands/GetResourcePolicyCommand.ts index e8e4c84d32d48..ac595789975fa 100644 --- a/clients/client-glue/commands/GetResourcePolicyCommand.ts +++ b/clients/client-glue/commands/GetResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourcePolicyCommandInput = GetResourcePolicyRequest; export type GetResourcePolicyCommandOutput = GetResourcePolicyResponse & __MetadataBearer; +/** + *

Retrieves a specified resource policy.

+ */ export class GetResourcePolicyCommand extends $Command< GetResourcePolicyCommandInput, GetResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetSecurityConfigurationCommand.ts b/clients/client-glue/commands/GetSecurityConfigurationCommand.ts index 906bda2d0a797..36c37b4c08fcf 100644 --- a/clients/client-glue/commands/GetSecurityConfigurationCommand.ts +++ b/clients/client-glue/commands/GetSecurityConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetSecurityConfigurationCommandInput = GetSecurityConfigurationRequest; export type GetSecurityConfigurationCommandOutput = GetSecurityConfigurationResponse & __MetadataBearer; +/** + *

Retrieves a specified security configuration.

+ */ export class GetSecurityConfigurationCommand extends $Command< GetSecurityConfigurationCommandInput, GetSecurityConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetSecurityConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetSecurityConfigurationsCommand.ts b/clients/client-glue/commands/GetSecurityConfigurationsCommand.ts index 03cba3ecf0819..2c59fe995dfa9 100644 --- a/clients/client-glue/commands/GetSecurityConfigurationsCommand.ts +++ b/clients/client-glue/commands/GetSecurityConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type GetSecurityConfigurationsCommandInput = GetSecurityConfigurationsRequest; export type GetSecurityConfigurationsCommandOutput = GetSecurityConfigurationsResponse & __MetadataBearer; +/** + *

Retrieves a list of all security configurations.

+ */ export class GetSecurityConfigurationsCommand extends $Command< GetSecurityConfigurationsCommandInput, GetSecurityConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class GetSecurityConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetTableCommand.ts b/clients/client-glue/commands/GetTableCommand.ts index b0f4df1739560..33770814566bf 100644 --- a/clients/client-glue/commands/GetTableCommand.ts +++ b/clients/client-glue/commands/GetTableCommand.ts @@ -17,6 +17,10 @@ import { export type GetTableCommandInput = GetTableRequest; export type GetTableCommandOutput = GetTableResponse & __MetadataBearer; +/** + *

Retrieves the Table definition in a Data Catalog for + * a specified table.

+ */ export class GetTableCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +31,9 @@ export class GetTableCommand extends $Command, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetTableVersionCommand.ts b/clients/client-glue/commands/GetTableVersionCommand.ts index 6db2026d3e9e1..faa0fe381f448 100644 --- a/clients/client-glue/commands/GetTableVersionCommand.ts +++ b/clients/client-glue/commands/GetTableVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetTableVersionCommandInput = GetTableVersionRequest; export type GetTableVersionCommandOutput = GetTableVersionResponse & __MetadataBearer; +/** + *

Retrieves a specified version of a table.

+ */ export class GetTableVersionCommand extends $Command< GetTableVersionCommandInput, GetTableVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetTableVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetTableVersionsCommand.ts b/clients/client-glue/commands/GetTableVersionsCommand.ts index 95fc90b2d19df..ccc9a51b7e226 100644 --- a/clients/client-glue/commands/GetTableVersionsCommand.ts +++ b/clients/client-glue/commands/GetTableVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type GetTableVersionsCommandInput = GetTableVersionsRequest; export type GetTableVersionsCommandOutput = GetTableVersionsResponse & __MetadataBearer; +/** + *

Retrieves a list of strings that identify available versions of + * a specified table.

+ */ export class GetTableVersionsCommand extends $Command< GetTableVersionsCommandInput, GetTableVersionsCommandOutput, @@ -34,6 +38,9 @@ export class GetTableVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetTablesCommand.ts b/clients/client-glue/commands/GetTablesCommand.ts index d33c8b67c5ba2..dc2e08f4d83da 100644 --- a/clients/client-glue/commands/GetTablesCommand.ts +++ b/clients/client-glue/commands/GetTablesCommand.ts @@ -17,6 +17,10 @@ import { export type GetTablesCommandInput = GetTablesRequest; export type GetTablesCommandOutput = GetTablesResponse & __MetadataBearer; +/** + *

Retrieves the definitions of some or all of the tables in a given + * Database.

+ */ export class GetTablesCommand extends $Command< GetTablesCommandInput, GetTablesCommandOutput, @@ -31,6 +35,9 @@ export class GetTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetTagsCommand.ts b/clients/client-glue/commands/GetTagsCommand.ts index 158035ce153b5..eff7df264f5ac 100644 --- a/clients/client-glue/commands/GetTagsCommand.ts +++ b/clients/client-glue/commands/GetTagsCommand.ts @@ -17,6 +17,9 @@ import { export type GetTagsCommandInput = GetTagsRequest; export type GetTagsCommandOutput = GetTagsResponse & __MetadataBearer; +/** + *

Retrieves a list of tags associated with a resource.

+ */ export class GetTagsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetTagsCommand extends $Command, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetTriggerCommand.ts b/clients/client-glue/commands/GetTriggerCommand.ts index 64fd5d0d5392f..f26021f3f46f2 100644 --- a/clients/client-glue/commands/GetTriggerCommand.ts +++ b/clients/client-glue/commands/GetTriggerCommand.ts @@ -20,6 +20,9 @@ import { export type GetTriggerCommandInput = GetTriggerRequest; export type GetTriggerCommandOutput = GetTriggerResponse & __MetadataBearer; +/** + *

Retrieves the definition of a trigger.

+ */ export class GetTriggerCommand extends $Command< GetTriggerCommandInput, GetTriggerCommandOutput, @@ -34,6 +37,9 @@ export class GetTriggerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetTriggersCommand.ts b/clients/client-glue/commands/GetTriggersCommand.ts index 8ed0b87b9a14a..98dbca9c66261 100644 --- a/clients/client-glue/commands/GetTriggersCommand.ts +++ b/clients/client-glue/commands/GetTriggersCommand.ts @@ -20,6 +20,9 @@ import { export type GetTriggersCommandInput = GetTriggersRequest; export type GetTriggersCommandOutput = GetTriggersResponse & __MetadataBearer; +/** + *

Gets all the triggers associated with a job.

+ */ export class GetTriggersCommand extends $Command< GetTriggersCommandInput, GetTriggersCommandOutput, @@ -34,6 +37,9 @@ export class GetTriggersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetUserDefinedFunctionCommand.ts b/clients/client-glue/commands/GetUserDefinedFunctionCommand.ts index 6192524ea37b0..75bc370405618 100644 --- a/clients/client-glue/commands/GetUserDefinedFunctionCommand.ts +++ b/clients/client-glue/commands/GetUserDefinedFunctionCommand.ts @@ -20,6 +20,9 @@ import { export type GetUserDefinedFunctionCommandInput = GetUserDefinedFunctionRequest; export type GetUserDefinedFunctionCommandOutput = GetUserDefinedFunctionResponse & __MetadataBearer; +/** + *

Retrieves a specified function definition from the Data Catalog.

+ */ export class GetUserDefinedFunctionCommand extends $Command< GetUserDefinedFunctionCommandInput, GetUserDefinedFunctionCommandOutput, @@ -34,6 +37,9 @@ export class GetUserDefinedFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetUserDefinedFunctionsCommand.ts b/clients/client-glue/commands/GetUserDefinedFunctionsCommand.ts index 7300003d34511..ed5352ef64883 100644 --- a/clients/client-glue/commands/GetUserDefinedFunctionsCommand.ts +++ b/clients/client-glue/commands/GetUserDefinedFunctionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetUserDefinedFunctionsCommandInput = GetUserDefinedFunctionsRequest; export type GetUserDefinedFunctionsCommandOutput = GetUserDefinedFunctionsResponse & __MetadataBearer; +/** + *

Retrieves multiple function definitions from the Data Catalog.

+ */ export class GetUserDefinedFunctionsCommand extends $Command< GetUserDefinedFunctionsCommandInput, GetUserDefinedFunctionsCommandOutput, @@ -34,6 +37,9 @@ export class GetUserDefinedFunctionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetWorkflowCommand.ts b/clients/client-glue/commands/GetWorkflowCommand.ts index c12d2137f2079..f9291d743997e 100644 --- a/clients/client-glue/commands/GetWorkflowCommand.ts +++ b/clients/client-glue/commands/GetWorkflowCommand.ts @@ -20,6 +20,9 @@ import { export type GetWorkflowCommandInput = GetWorkflowRequest; export type GetWorkflowCommandOutput = GetWorkflowResponse & __MetadataBearer; +/** + *

Retrieves resource metadata for a workflow.

+ */ export class GetWorkflowCommand extends $Command< GetWorkflowCommandInput, GetWorkflowCommandOutput, @@ -34,6 +37,9 @@ export class GetWorkflowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetWorkflowRunCommand.ts b/clients/client-glue/commands/GetWorkflowRunCommand.ts index 9579aea4edb27..23159ec1ac118 100644 --- a/clients/client-glue/commands/GetWorkflowRunCommand.ts +++ b/clients/client-glue/commands/GetWorkflowRunCommand.ts @@ -20,6 +20,9 @@ import { export type GetWorkflowRunCommandInput = GetWorkflowRunRequest; export type GetWorkflowRunCommandOutput = GetWorkflowRunResponse & __MetadataBearer; +/** + *

Retrieves the metadata for a given workflow run.

+ */ export class GetWorkflowRunCommand extends $Command< GetWorkflowRunCommandInput, GetWorkflowRunCommandOutput, @@ -34,6 +37,9 @@ export class GetWorkflowRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetWorkflowRunPropertiesCommand.ts b/clients/client-glue/commands/GetWorkflowRunPropertiesCommand.ts index 8172470a444ab..15d28442e3b33 100644 --- a/clients/client-glue/commands/GetWorkflowRunPropertiesCommand.ts +++ b/clients/client-glue/commands/GetWorkflowRunPropertiesCommand.ts @@ -20,6 +20,9 @@ import { export type GetWorkflowRunPropertiesCommandInput = GetWorkflowRunPropertiesRequest; export type GetWorkflowRunPropertiesCommandOutput = GetWorkflowRunPropertiesResponse & __MetadataBearer; +/** + *

Retrieves the workflow run properties which were set during the run.

+ */ export class GetWorkflowRunPropertiesCommand extends $Command< GetWorkflowRunPropertiesCommandInput, GetWorkflowRunPropertiesCommandOutput, @@ -34,6 +37,9 @@ export class GetWorkflowRunPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/GetWorkflowRunsCommand.ts b/clients/client-glue/commands/GetWorkflowRunsCommand.ts index 6f1c2a5677b54..7e6a28b73885b 100644 --- a/clients/client-glue/commands/GetWorkflowRunsCommand.ts +++ b/clients/client-glue/commands/GetWorkflowRunsCommand.ts @@ -20,6 +20,9 @@ import { export type GetWorkflowRunsCommandInput = GetWorkflowRunsRequest; export type GetWorkflowRunsCommandOutput = GetWorkflowRunsResponse & __MetadataBearer; +/** + *

Retrieves metadata for all runs of a given workflow.

+ */ export class GetWorkflowRunsCommand extends $Command< GetWorkflowRunsCommandInput, GetWorkflowRunsCommandOutput, @@ -34,6 +37,9 @@ export class GetWorkflowRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ImportCatalogToGlueCommand.ts b/clients/client-glue/commands/ImportCatalogToGlueCommand.ts index 6787b0ee32fa8..12c009d5d963a 100644 --- a/clients/client-glue/commands/ImportCatalogToGlueCommand.ts +++ b/clients/client-glue/commands/ImportCatalogToGlueCommand.ts @@ -20,6 +20,9 @@ import { export type ImportCatalogToGlueCommandInput = ImportCatalogToGlueRequest; export type ImportCatalogToGlueCommandOutput = ImportCatalogToGlueResponse & __MetadataBearer; +/** + *

Imports an existing Amazon Athena Data Catalog to AWS Glue

+ */ export class ImportCatalogToGlueCommand extends $Command< ImportCatalogToGlueCommandInput, ImportCatalogToGlueCommandOutput, @@ -34,6 +37,9 @@ export class ImportCatalogToGlueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ListCrawlersCommand.ts b/clients/client-glue/commands/ListCrawlersCommand.ts index a2762722914fb..029f219b43f36 100644 --- a/clients/client-glue/commands/ListCrawlersCommand.ts +++ b/clients/client-glue/commands/ListCrawlersCommand.ts @@ -20,6 +20,15 @@ import { export type ListCrawlersCommandInput = ListCrawlersRequest; export type ListCrawlersCommandOutput = ListCrawlersResponse & __MetadataBearer; +/** + *

Retrieves the names of all crawler resources in this AWS account, or the + * resources with the specified tag. This operation allows you to see which + * resources are available in your account, and their names.

+ * + *

This operation takes the optional Tags field, which you can use as a filter on + * the response so that tagged resources can be retrieved as a group. If you choose to use tags + * filtering, only resources with the tag are retrieved.

+ */ export class ListCrawlersCommand extends $Command< ListCrawlersCommandInput, ListCrawlersCommandOutput, @@ -34,6 +43,9 @@ export class ListCrawlersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ListDevEndpointsCommand.ts b/clients/client-glue/commands/ListDevEndpointsCommand.ts index 9abcd05f912ba..ca7e28b1f348b 100644 --- a/clients/client-glue/commands/ListDevEndpointsCommand.ts +++ b/clients/client-glue/commands/ListDevEndpointsCommand.ts @@ -20,6 +20,15 @@ import { export type ListDevEndpointsCommandInput = ListDevEndpointsRequest; export type ListDevEndpointsCommandOutput = ListDevEndpointsResponse & __MetadataBearer; +/** + *

Retrieves the names of all DevEndpoint resources in this AWS account, or the + * resources with the specified tag. This operation allows you to see which resources are + * available in your account, and their names.

+ * + *

This operation takes the optional Tags field, which you can use as a filter on + * the response so that tagged resources can be retrieved as a group. If you choose to use tags + * filtering, only resources with the tag are retrieved.

+ */ export class ListDevEndpointsCommand extends $Command< ListDevEndpointsCommandInput, ListDevEndpointsCommandOutput, @@ -34,6 +43,9 @@ export class ListDevEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ListJobsCommand.ts b/clients/client-glue/commands/ListJobsCommand.ts index 086ec66a0b380..b429481c8f3f3 100644 --- a/clients/client-glue/commands/ListJobsCommand.ts +++ b/clients/client-glue/commands/ListJobsCommand.ts @@ -17,6 +17,13 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResponse & __MetadataBearer; +/** + *

Retrieves the names of all job resources in this AWS account, or the resources with the specified tag. This operation allows you to see which resources are available in your account, and their names.

+ * + *

This operation takes the optional Tags field, which you can use as a filter on + * the response so that tagged resources can be retrieved as a group. If you choose to use tags + * filtering, only resources with the tag are retrieved.

+ */ export class ListJobsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +34,9 @@ export class ListJobsCommand extends $Command, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ListMLTransformsCommand.ts b/clients/client-glue/commands/ListMLTransformsCommand.ts index cebe97433d627..23309ac0bdcbe 100644 --- a/clients/client-glue/commands/ListMLTransformsCommand.ts +++ b/clients/client-glue/commands/ListMLTransformsCommand.ts @@ -20,6 +20,13 @@ import { export type ListMLTransformsCommandInput = ListMLTransformsRequest; export type ListMLTransformsCommandOutput = ListMLTransformsResponse & __MetadataBearer; +/** + *

Retrieves a sortable, filterable list of existing AWS Glue machine learning transforms in this AWS account, + * or the resources with the specified tag. This operation takes the optional Tags field, which you can use as + * a filter of the responses so that tagged resources can be retrieved as a group. If you choose to use tag + * filtering, only resources with the tags are retrieved. + *

+ */ export class ListMLTransformsCommand extends $Command< ListMLTransformsCommandInput, ListMLTransformsCommandOutput, @@ -34,6 +41,9 @@ export class ListMLTransformsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ListTriggersCommand.ts b/clients/client-glue/commands/ListTriggersCommand.ts index 756b7cda22d38..c1ef71b31d90b 100644 --- a/clients/client-glue/commands/ListTriggersCommand.ts +++ b/clients/client-glue/commands/ListTriggersCommand.ts @@ -20,6 +20,13 @@ import { export type ListTriggersCommandInput = ListTriggersRequest; export type ListTriggersCommandOutput = ListTriggersResponse & __MetadataBearer; +/** + *

Retrieves the names of all trigger resources in this AWS account, or the resources with the specified tag. This operation allows you to see which resources are available in your account, and their names.

+ * + *

This operation takes the optional Tags field, which you can use as a filter on + * the response so that tagged resources can be retrieved as a group. If you choose to use tags + * filtering, only resources with the tag are retrieved.

+ */ export class ListTriggersCommand extends $Command< ListTriggersCommandInput, ListTriggersCommandOutput, @@ -34,6 +41,9 @@ export class ListTriggersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ListWorkflowsCommand.ts b/clients/client-glue/commands/ListWorkflowsCommand.ts index 62eb4d386de0b..248603ae3e94c 100644 --- a/clients/client-glue/commands/ListWorkflowsCommand.ts +++ b/clients/client-glue/commands/ListWorkflowsCommand.ts @@ -20,6 +20,9 @@ import { export type ListWorkflowsCommandInput = ListWorkflowsRequest; export type ListWorkflowsCommandOutput = ListWorkflowsResponse & __MetadataBearer; +/** + *

Lists names of workflows created in the account.

+ */ export class ListWorkflowsCommand extends $Command< ListWorkflowsCommandInput, ListWorkflowsCommandOutput, @@ -34,6 +37,9 @@ export class ListWorkflowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/PutDataCatalogEncryptionSettingsCommand.ts b/clients/client-glue/commands/PutDataCatalogEncryptionSettingsCommand.ts index 68de5e3ed86ec..bdf482260037b 100644 --- a/clients/client-glue/commands/PutDataCatalogEncryptionSettingsCommand.ts +++ b/clients/client-glue/commands/PutDataCatalogEncryptionSettingsCommand.ts @@ -20,6 +20,10 @@ import { export type PutDataCatalogEncryptionSettingsCommandInput = PutDataCatalogEncryptionSettingsRequest; export type PutDataCatalogEncryptionSettingsCommandOutput = PutDataCatalogEncryptionSettingsResponse & __MetadataBearer; +/** + *

Sets the security configuration for a specified catalog. After the configuration has been + * set, the specified encryption is applied to every catalog write thereafter.

+ */ export class PutDataCatalogEncryptionSettingsCommand extends $Command< PutDataCatalogEncryptionSettingsCommandInput, PutDataCatalogEncryptionSettingsCommandOutput, @@ -34,6 +38,9 @@ export class PutDataCatalogEncryptionSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/PutResourcePolicyCommand.ts b/clients/client-glue/commands/PutResourcePolicyCommand.ts index 02833f64d5bd0..550f43faaec91 100644 --- a/clients/client-glue/commands/PutResourcePolicyCommand.ts +++ b/clients/client-glue/commands/PutResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type PutResourcePolicyCommandInput = PutResourcePolicyRequest; export type PutResourcePolicyCommandOutput = PutResourcePolicyResponse & __MetadataBearer; +/** + *

Sets the Data Catalog resource policy for access control.

+ */ export class PutResourcePolicyCommand extends $Command< PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class PutResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/PutWorkflowRunPropertiesCommand.ts b/clients/client-glue/commands/PutWorkflowRunPropertiesCommand.ts index c67507eff19ec..90459782ba177 100644 --- a/clients/client-glue/commands/PutWorkflowRunPropertiesCommand.ts +++ b/clients/client-glue/commands/PutWorkflowRunPropertiesCommand.ts @@ -20,6 +20,9 @@ import { export type PutWorkflowRunPropertiesCommandInput = PutWorkflowRunPropertiesRequest; export type PutWorkflowRunPropertiesCommandOutput = PutWorkflowRunPropertiesResponse & __MetadataBearer; +/** + *

Puts the specified workflow run properties for the given workflow run. If a property already exists for the specified run, then it overrides the value otherwise adds the property to existing properties.

+ */ export class PutWorkflowRunPropertiesCommand extends $Command< PutWorkflowRunPropertiesCommandInput, PutWorkflowRunPropertiesCommandOutput, @@ -34,6 +37,9 @@ export class PutWorkflowRunPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ResetJobBookmarkCommand.ts b/clients/client-glue/commands/ResetJobBookmarkCommand.ts index 4392bf6e23d53..885e979034a34 100644 --- a/clients/client-glue/commands/ResetJobBookmarkCommand.ts +++ b/clients/client-glue/commands/ResetJobBookmarkCommand.ts @@ -20,6 +20,9 @@ import { export type ResetJobBookmarkCommandInput = ResetJobBookmarkRequest; export type ResetJobBookmarkCommandOutput = ResetJobBookmarkResponse & __MetadataBearer; +/** + *

Resets a bookmark entry.

+ */ export class ResetJobBookmarkCommand extends $Command< ResetJobBookmarkCommandInput, ResetJobBookmarkCommandOutput, @@ -34,6 +37,9 @@ export class ResetJobBookmarkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/ResumeWorkflowRunCommand.ts b/clients/client-glue/commands/ResumeWorkflowRunCommand.ts index 5065db094fc73..cb12ab8ce15ad 100644 --- a/clients/client-glue/commands/ResumeWorkflowRunCommand.ts +++ b/clients/client-glue/commands/ResumeWorkflowRunCommand.ts @@ -20,6 +20,9 @@ import { export type ResumeWorkflowRunCommandInput = ResumeWorkflowRunRequest; export type ResumeWorkflowRunCommandOutput = ResumeWorkflowRunResponse & __MetadataBearer; +/** + *

Restarts selected nodes of a previous partially completed workflow run and resumes the workflow run. The selected nodes and all nodes that are downstream from the selected nodes are run.

+ */ export class ResumeWorkflowRunCommand extends $Command< ResumeWorkflowRunCommandInput, ResumeWorkflowRunCommandOutput, @@ -34,6 +37,9 @@ export class ResumeWorkflowRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/SearchTablesCommand.ts b/clients/client-glue/commands/SearchTablesCommand.ts index d37f79d4e75d9..e79a72905f9f0 100644 --- a/clients/client-glue/commands/SearchTablesCommand.ts +++ b/clients/client-glue/commands/SearchTablesCommand.ts @@ -20,6 +20,10 @@ import { export type SearchTablesCommandInput = SearchTablesRequest; export type SearchTablesCommandOutput = SearchTablesResponse & __MetadataBearer; +/** + *

Searches a set of tables based on properties in the table metadata as well as on the parent database. You can search against text or filter conditions.

+ *

You can only get tables that you have access to based on the security policies defined in Lake Formation. You need at least a read-only access to the table for it to be returned. If you do not have access to all the columns in the table, these columns will not be searched against when returning the list of tables back to you. If you have access to the columns but not the data in the columns, those columns and the associated metadata for those columns will be included in the search.

+ */ export class SearchTablesCommand extends $Command< SearchTablesCommandInput, SearchTablesCommandOutput, @@ -34,6 +38,9 @@ export class SearchTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartCrawlerCommand.ts b/clients/client-glue/commands/StartCrawlerCommand.ts index da5b148da68f4..9de9bb5927db6 100644 --- a/clients/client-glue/commands/StartCrawlerCommand.ts +++ b/clients/client-glue/commands/StartCrawlerCommand.ts @@ -20,6 +20,11 @@ import { export type StartCrawlerCommandInput = StartCrawlerRequest; export type StartCrawlerCommandOutput = StartCrawlerResponse & __MetadataBearer; +/** + *

Starts a crawl using the specified crawler, regardless + * of what is scheduled. If the crawler is already running, returns a + * CrawlerRunningException.

+ */ export class StartCrawlerCommand extends $Command< StartCrawlerCommandInput, StartCrawlerCommandOutput, @@ -34,6 +39,9 @@ export class StartCrawlerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartCrawlerScheduleCommand.ts b/clients/client-glue/commands/StartCrawlerScheduleCommand.ts index 62c8568c7ace6..2ee1fd5784f8a 100644 --- a/clients/client-glue/commands/StartCrawlerScheduleCommand.ts +++ b/clients/client-glue/commands/StartCrawlerScheduleCommand.ts @@ -20,6 +20,11 @@ import { export type StartCrawlerScheduleCommandInput = StartCrawlerScheduleRequest; export type StartCrawlerScheduleCommandOutput = StartCrawlerScheduleResponse & __MetadataBearer; +/** + *

Changes the schedule state of the specified crawler to + * SCHEDULED, unless the crawler is already running or the + * schedule state is already SCHEDULED.

+ */ export class StartCrawlerScheduleCommand extends $Command< StartCrawlerScheduleCommandInput, StartCrawlerScheduleCommandOutput, @@ -34,6 +39,9 @@ export class StartCrawlerScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartExportLabelsTaskRunCommand.ts b/clients/client-glue/commands/StartExportLabelsTaskRunCommand.ts index 8247cff39bcbd..7b3953c46e726 100644 --- a/clients/client-glue/commands/StartExportLabelsTaskRunCommand.ts +++ b/clients/client-glue/commands/StartExportLabelsTaskRunCommand.ts @@ -20,6 +20,17 @@ import { export type StartExportLabelsTaskRunCommandInput = StartExportLabelsTaskRunRequest; export type StartExportLabelsTaskRunCommandOutput = StartExportLabelsTaskRunResponse & __MetadataBearer; +/** + *

Begins an asynchronous task to export all labeled data for a particular transform. This + * task is the only label-related API call that is not part of the typical active learning + * workflow. You typically use StartExportLabelsTaskRun when you want to work with + * all of your existing labels at the same time, such as when you want to remove or change labels + * that were previously submitted as truth. This API operation accepts the + * TransformId whose labels you want to export and an Amazon Simple Storage + * Service (Amazon S3) path to export the labels to. The operation returns a + * TaskRunId. You can check on the status of your task run by calling the + * GetMLTaskRun API.

+ */ export class StartExportLabelsTaskRunCommand extends $Command< StartExportLabelsTaskRunCommandInput, StartExportLabelsTaskRunCommandOutput, @@ -34,6 +45,9 @@ export class StartExportLabelsTaskRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartImportLabelsTaskRunCommand.ts b/clients/client-glue/commands/StartImportLabelsTaskRunCommand.ts index 56bfd2818653e..4ab52a396984e 100644 --- a/clients/client-glue/commands/StartImportLabelsTaskRunCommand.ts +++ b/clients/client-glue/commands/StartImportLabelsTaskRunCommand.ts @@ -20,6 +20,33 @@ import { export type StartImportLabelsTaskRunCommandInput = StartImportLabelsTaskRunRequest; export type StartImportLabelsTaskRunCommandOutput = StartImportLabelsTaskRunResponse & __MetadataBearer; +/** + *

Enables you to provide additional labels (examples of truth) to be used to teach the + * machine learning transform and improve its quality. This API operation is generally used as + * part of the active learning workflow that starts with the + * StartMLLabelingSetGenerationTaskRun call and that ultimately results in + * improving the quality of your machine learning transform.

+ * + *

After the StartMLLabelingSetGenerationTaskRun finishes, AWS Glue machine learning + * will have generated a series of questions for humans to answer. (Answering these questions is + * often called 'labeling' in the machine learning workflows). In the case of the + * FindMatches transform, these questions are of the form, “What is the correct + * way to group these rows together into groups composed entirely of matching records?” After the + * labeling process is finished, users upload their answers/labels with a call to + * StartImportLabelsTaskRun. After StartImportLabelsTaskRun finishes, + * all future runs of the machine learning transform use the new and improved labels and perform + * a higher-quality transformation.

+ * + *

By default, StartMLLabelingSetGenerationTaskRun continually learns from and + * combines all labels that you upload unless you set Replace to true. If you set + * Replace to true, StartImportLabelsTaskRun deletes and forgets all + * previously uploaded labels and learns only from the exact set that you upload. Replacing + * labels can be helpful if you realize that you previously uploaded incorrect labels, and you + * believe that they are having a negative effect on your transform quality.

+ * + *

You can check on the status of your task run by calling the GetMLTaskRun + * operation.

+ */ export class StartImportLabelsTaskRunCommand extends $Command< StartImportLabelsTaskRunCommandInput, StartImportLabelsTaskRunCommandOutput, @@ -34,6 +61,9 @@ export class StartImportLabelsTaskRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartJobRunCommand.ts b/clients/client-glue/commands/StartJobRunCommand.ts index 40aba7bf71d3e..076a2d035ae39 100644 --- a/clients/client-glue/commands/StartJobRunCommand.ts +++ b/clients/client-glue/commands/StartJobRunCommand.ts @@ -20,6 +20,9 @@ import { export type StartJobRunCommandInput = StartJobRunRequest; export type StartJobRunCommandOutput = StartJobRunResponse & __MetadataBearer; +/** + *

Starts a job run using a job definition.

+ */ export class StartJobRunCommand extends $Command< StartJobRunCommandInput, StartJobRunCommandOutput, @@ -34,6 +37,9 @@ export class StartJobRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartMLEvaluationTaskRunCommand.ts b/clients/client-glue/commands/StartMLEvaluationTaskRunCommand.ts index b9ebe68795542..ce90287cffcfb 100644 --- a/clients/client-glue/commands/StartMLEvaluationTaskRunCommand.ts +++ b/clients/client-glue/commands/StartMLEvaluationTaskRunCommand.ts @@ -20,6 +20,16 @@ import { export type StartMLEvaluationTaskRunCommandInput = StartMLEvaluationTaskRunRequest; export type StartMLEvaluationTaskRunCommandOutput = StartMLEvaluationTaskRunResponse & __MetadataBearer; +/** + *

Starts a task to estimate the quality of the transform.

+ * + *

When you provide label sets as examples of truth, AWS Glue machine learning uses some of + * those examples to learn from them. The rest of the labels are used as a test to estimate + * quality.

+ * + *

Returns a unique identifier for the run. You can call GetMLTaskRun to get more + * information about the stats of the EvaluationTaskRun.

+ */ export class StartMLEvaluationTaskRunCommand extends $Command< StartMLEvaluationTaskRunCommandInput, StartMLEvaluationTaskRunCommandOutput, @@ -34,6 +44,9 @@ export class StartMLEvaluationTaskRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartMLLabelingSetGenerationTaskRunCommand.ts b/clients/client-glue/commands/StartMLLabelingSetGenerationTaskRunCommand.ts index 7c0ee420372f6..6606784f3ac07 100644 --- a/clients/client-glue/commands/StartMLLabelingSetGenerationTaskRunCommand.ts +++ b/clients/client-glue/commands/StartMLLabelingSetGenerationTaskRunCommand.ts @@ -24,6 +24,22 @@ export type StartMLLabelingSetGenerationTaskRunCommandInput = StartMLLabelingSet export type StartMLLabelingSetGenerationTaskRunCommandOutput = StartMLLabelingSetGenerationTaskRunResponse & __MetadataBearer; +/** + *

Starts the active learning workflow for your machine learning transform to improve the + * transform's quality by generating label sets and adding labels.

+ * + *

When the StartMLLabelingSetGenerationTaskRun finishes, AWS Glue will have + * generated a "labeling set" or a set of questions for humans to answer.

+ * + *

In the case of the FindMatches transform, these questions are of the form, + * “What is the correct way to group these rows together into groups composed entirely of + * matching records?”

+ * + *

After the labeling process is finished, you can upload your labels with a call to + * StartImportLabelsTaskRun. After StartImportLabelsTaskRun finishes, + * all future runs of the machine learning transform will use the new and improved labels and + * perform a higher-quality transformation.

+ */ export class StartMLLabelingSetGenerationTaskRunCommand extends $Command< StartMLLabelingSetGenerationTaskRunCommandInput, StartMLLabelingSetGenerationTaskRunCommandOutput, @@ -38,6 +54,9 @@ export class StartMLLabelingSetGenerationTaskRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartTriggerCommand.ts b/clients/client-glue/commands/StartTriggerCommand.ts index 23a2b5e169eb5..1c8fda5204b65 100644 --- a/clients/client-glue/commands/StartTriggerCommand.ts +++ b/clients/client-glue/commands/StartTriggerCommand.ts @@ -20,6 +20,11 @@ import { export type StartTriggerCommandInput = StartTriggerRequest; export type StartTriggerCommandOutput = StartTriggerResponse & __MetadataBearer; +/** + *

Starts an existing trigger. See Triggering + * Jobs for information about how different types of trigger are + * started.

+ */ export class StartTriggerCommand extends $Command< StartTriggerCommandInput, StartTriggerCommandOutput, @@ -34,6 +39,9 @@ export class StartTriggerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StartWorkflowRunCommand.ts b/clients/client-glue/commands/StartWorkflowRunCommand.ts index 68b0f4babd2f6..87593a5d46349 100644 --- a/clients/client-glue/commands/StartWorkflowRunCommand.ts +++ b/clients/client-glue/commands/StartWorkflowRunCommand.ts @@ -20,6 +20,9 @@ import { export type StartWorkflowRunCommandInput = StartWorkflowRunRequest; export type StartWorkflowRunCommandOutput = StartWorkflowRunResponse & __MetadataBearer; +/** + *

Starts a new run of the specified workflow.

+ */ export class StartWorkflowRunCommand extends $Command< StartWorkflowRunCommandInput, StartWorkflowRunCommandOutput, @@ -34,6 +37,9 @@ export class StartWorkflowRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StopCrawlerCommand.ts b/clients/client-glue/commands/StopCrawlerCommand.ts index fc873e4b37cc0..c605ad5df0f71 100644 --- a/clients/client-glue/commands/StopCrawlerCommand.ts +++ b/clients/client-glue/commands/StopCrawlerCommand.ts @@ -20,6 +20,9 @@ import { export type StopCrawlerCommandInput = StopCrawlerRequest; export type StopCrawlerCommandOutput = StopCrawlerResponse & __MetadataBearer; +/** + *

If the specified crawler is running, stops the crawl.

+ */ export class StopCrawlerCommand extends $Command< StopCrawlerCommandInput, StopCrawlerCommandOutput, @@ -34,6 +37,9 @@ export class StopCrawlerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StopCrawlerScheduleCommand.ts b/clients/client-glue/commands/StopCrawlerScheduleCommand.ts index c9f4a99bbb299..f76a55c79935c 100644 --- a/clients/client-glue/commands/StopCrawlerScheduleCommand.ts +++ b/clients/client-glue/commands/StopCrawlerScheduleCommand.ts @@ -20,6 +20,11 @@ import { export type StopCrawlerScheduleCommandInput = StopCrawlerScheduleRequest; export type StopCrawlerScheduleCommandOutput = StopCrawlerScheduleResponse & __MetadataBearer; +/** + *

Sets the schedule state of the specified crawler to + * NOT_SCHEDULED, but does not stop the crawler if it is + * already running.

+ */ export class StopCrawlerScheduleCommand extends $Command< StopCrawlerScheduleCommandInput, StopCrawlerScheduleCommandOutput, @@ -34,6 +39,9 @@ export class StopCrawlerScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StopTriggerCommand.ts b/clients/client-glue/commands/StopTriggerCommand.ts index a794e3dda7ff5..2d19d22df78fe 100644 --- a/clients/client-glue/commands/StopTriggerCommand.ts +++ b/clients/client-glue/commands/StopTriggerCommand.ts @@ -20,6 +20,9 @@ import { export type StopTriggerCommandInput = StopTriggerRequest; export type StopTriggerCommandOutput = StopTriggerResponse & __MetadataBearer; +/** + *

Stops a specified trigger.

+ */ export class StopTriggerCommand extends $Command< StopTriggerCommandInput, StopTriggerCommandOutput, @@ -34,6 +37,9 @@ export class StopTriggerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/StopWorkflowRunCommand.ts b/clients/client-glue/commands/StopWorkflowRunCommand.ts index 824808765a58e..dd411b7f092e3 100644 --- a/clients/client-glue/commands/StopWorkflowRunCommand.ts +++ b/clients/client-glue/commands/StopWorkflowRunCommand.ts @@ -20,6 +20,9 @@ import { export type StopWorkflowRunCommandInput = StopWorkflowRunRequest; export type StopWorkflowRunCommandOutput = StopWorkflowRunResponse & __MetadataBearer; +/** + *

Stops the execution of the specified workflow run.

+ */ export class StopWorkflowRunCommand extends $Command< StopWorkflowRunCommandInput, StopWorkflowRunCommandOutput, @@ -34,6 +37,9 @@ export class StopWorkflowRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/TagResourceCommand.ts b/clients/client-glue/commands/TagResourceCommand.ts index 6a8e8a0074c90..ded8bfe947d2c 100644 --- a/clients/client-glue/commands/TagResourceCommand.ts +++ b/clients/client-glue/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds tags to a resource. A tag is a label you can assign to an AWS resource. + * In AWS Glue, you can tag only certain resources. For information about what + * resources you can tag, see AWS Tags in AWS Glue.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UntagResourceCommand.ts b/clients/client-glue/commands/UntagResourceCommand.ts index ce9614e31ad8b..21958cee4e925 100644 --- a/clients/client-glue/commands/UntagResourceCommand.ts +++ b/clients/client-glue/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateClassifierCommand.ts b/clients/client-glue/commands/UpdateClassifierCommand.ts index 161986490e6f9..3457e271afc0a 100644 --- a/clients/client-glue/commands/UpdateClassifierCommand.ts +++ b/clients/client-glue/commands/UpdateClassifierCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateClassifierCommandInput = UpdateClassifierRequest; export type UpdateClassifierCommandOutput = UpdateClassifierResponse & __MetadataBearer; +/** + *

Modifies an existing classifier (a GrokClassifier, + * an XMLClassifier, a JsonClassifier, or a CsvClassifier, depending on + * which field is present).

+ */ export class UpdateClassifierCommand extends $Command< UpdateClassifierCommandInput, UpdateClassifierCommandOutput, @@ -34,6 +39,9 @@ export class UpdateClassifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateColumnStatisticsForPartitionCommand.ts b/clients/client-glue/commands/UpdateColumnStatisticsForPartitionCommand.ts index 6cde2335e468b..c55111370b66b 100644 --- a/clients/client-glue/commands/UpdateColumnStatisticsForPartitionCommand.ts +++ b/clients/client-glue/commands/UpdateColumnStatisticsForPartitionCommand.ts @@ -24,6 +24,11 @@ export type UpdateColumnStatisticsForPartitionCommandInput = UpdateColumnStatist export type UpdateColumnStatisticsForPartitionCommandOutput = UpdateColumnStatisticsForPartitionResponse & __MetadataBearer; +/** + *

Creates or updates partition statistics of columns.

+ * + *

The Identity and Access Management (IAM) permission required for this operation is UpdatePartition.

+ */ export class UpdateColumnStatisticsForPartitionCommand extends $Command< UpdateColumnStatisticsForPartitionCommandInput, UpdateColumnStatisticsForPartitionCommandOutput, @@ -38,6 +43,9 @@ export class UpdateColumnStatisticsForPartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateColumnStatisticsForTableCommand.ts b/clients/client-glue/commands/UpdateColumnStatisticsForTableCommand.ts index 7553b31cd67cd..7f2ab31cbcae9 100644 --- a/clients/client-glue/commands/UpdateColumnStatisticsForTableCommand.ts +++ b/clients/client-glue/commands/UpdateColumnStatisticsForTableCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateColumnStatisticsForTableCommandInput = UpdateColumnStatisticsForTableRequest; export type UpdateColumnStatisticsForTableCommandOutput = UpdateColumnStatisticsForTableResponse & __MetadataBearer; +/** + *

Creates or updates table statistics of columns.

+ * + *

The Identity and Access Management (IAM) permission required for this operation is UpdateTable.

+ */ export class UpdateColumnStatisticsForTableCommand extends $Command< UpdateColumnStatisticsForTableCommandInput, UpdateColumnStatisticsForTableCommandOutput, @@ -34,6 +39,9 @@ export class UpdateColumnStatisticsForTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateConnectionCommand.ts b/clients/client-glue/commands/UpdateConnectionCommand.ts index 6e8f7fc7f39e4..d21ecc7770d8d 100644 --- a/clients/client-glue/commands/UpdateConnectionCommand.ts +++ b/clients/client-glue/commands/UpdateConnectionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConnectionCommandInput = UpdateConnectionRequest; export type UpdateConnectionCommandOutput = UpdateConnectionResponse & __MetadataBearer; +/** + *

Updates a connection definition in the Data Catalog.

+ */ export class UpdateConnectionCommand extends $Command< UpdateConnectionCommandInput, UpdateConnectionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConnectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateCrawlerCommand.ts b/clients/client-glue/commands/UpdateCrawlerCommand.ts index 011be4d872cde..96fdfe98dc039 100644 --- a/clients/client-glue/commands/UpdateCrawlerCommand.ts +++ b/clients/client-glue/commands/UpdateCrawlerCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateCrawlerCommandInput = UpdateCrawlerRequest; export type UpdateCrawlerCommandOutput = UpdateCrawlerResponse & __MetadataBearer; +/** + *

Updates a crawler. If a crawler is + * running, you must stop it using StopCrawler before updating + * it.

+ */ export class UpdateCrawlerCommand extends $Command< UpdateCrawlerCommandInput, UpdateCrawlerCommandOutput, @@ -34,6 +39,9 @@ export class UpdateCrawlerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateCrawlerScheduleCommand.ts b/clients/client-glue/commands/UpdateCrawlerScheduleCommand.ts index 39890360377d9..8e97c1a9c4d65 100644 --- a/clients/client-glue/commands/UpdateCrawlerScheduleCommand.ts +++ b/clients/client-glue/commands/UpdateCrawlerScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateCrawlerScheduleCommandInput = UpdateCrawlerScheduleRequest; export type UpdateCrawlerScheduleCommandOutput = UpdateCrawlerScheduleResponse & __MetadataBearer; +/** + *

Updates the schedule of a crawler using a cron expression.

+ */ export class UpdateCrawlerScheduleCommand extends $Command< UpdateCrawlerScheduleCommandInput, UpdateCrawlerScheduleCommandOutput, @@ -34,6 +37,9 @@ export class UpdateCrawlerScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateDatabaseCommand.ts b/clients/client-glue/commands/UpdateDatabaseCommand.ts index 3213de87a25f6..d7b26aa9dcbad 100644 --- a/clients/client-glue/commands/UpdateDatabaseCommand.ts +++ b/clients/client-glue/commands/UpdateDatabaseCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDatabaseCommandInput = UpdateDatabaseRequest; export type UpdateDatabaseCommandOutput = UpdateDatabaseResponse & __MetadataBearer; +/** + *

Updates an existing database definition in a Data Catalog.

+ */ export class UpdateDatabaseCommand extends $Command< UpdateDatabaseCommandInput, UpdateDatabaseCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateDevEndpointCommand.ts b/clients/client-glue/commands/UpdateDevEndpointCommand.ts index f1842a3db91c8..45f413b25e1bd 100644 --- a/clients/client-glue/commands/UpdateDevEndpointCommand.ts +++ b/clients/client-glue/commands/UpdateDevEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDevEndpointCommandInput = UpdateDevEndpointRequest; export type UpdateDevEndpointCommandOutput = UpdateDevEndpointResponse & __MetadataBearer; +/** + *

Updates a specified development endpoint.

+ */ export class UpdateDevEndpointCommand extends $Command< UpdateDevEndpointCommandInput, UpdateDevEndpointCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDevEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateJobCommand.ts b/clients/client-glue/commands/UpdateJobCommand.ts index decab9dba59b9..6198b17250b54 100644 --- a/clients/client-glue/commands/UpdateJobCommand.ts +++ b/clients/client-glue/commands/UpdateJobCommand.ts @@ -17,6 +17,9 @@ import { export type UpdateJobCommandInput = UpdateJobRequest; export type UpdateJobCommandOutput = UpdateJobResponse & __MetadataBearer; +/** + *

Updates an existing job definition.

+ */ export class UpdateJobCommand extends $Command< UpdateJobCommandInput, UpdateJobCommandOutput, @@ -31,6 +34,9 @@ export class UpdateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateMLTransformCommand.ts b/clients/client-glue/commands/UpdateMLTransformCommand.ts index 0c168b63766d1..ff0cf63f67767 100644 --- a/clients/client-glue/commands/UpdateMLTransformCommand.ts +++ b/clients/client-glue/commands/UpdateMLTransformCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateMLTransformCommandInput = UpdateMLTransformRequest; export type UpdateMLTransformCommandOutput = UpdateMLTransformResponse & __MetadataBearer; +/** + *

Updates an existing machine learning transform. Call this operation to tune the algorithm parameters to achieve better results.

+ * + *

After calling this operation, you can call the StartMLEvaluationTaskRun + * operation to assess how well your new parameters achieved your goals (such as improving the + * quality of your machine learning transform, or making it more cost-effective).

+ */ export class UpdateMLTransformCommand extends $Command< UpdateMLTransformCommandInput, UpdateMLTransformCommandOutput, @@ -34,6 +41,9 @@ export class UpdateMLTransformCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdatePartitionCommand.ts b/clients/client-glue/commands/UpdatePartitionCommand.ts index 6877680dd0ed3..26f73d72af419 100644 --- a/clients/client-glue/commands/UpdatePartitionCommand.ts +++ b/clients/client-glue/commands/UpdatePartitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePartitionCommandInput = UpdatePartitionRequest; export type UpdatePartitionCommandOutput = UpdatePartitionResponse & __MetadataBearer; +/** + *

Updates a partition.

+ */ export class UpdatePartitionCommand extends $Command< UpdatePartitionCommandInput, UpdatePartitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePartitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateTableCommand.ts b/clients/client-glue/commands/UpdateTableCommand.ts index 1ec77d6beca2d..0e1653771d2b5 100644 --- a/clients/client-glue/commands/UpdateTableCommand.ts +++ b/clients/client-glue/commands/UpdateTableCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTableCommandInput = UpdateTableRequest; export type UpdateTableCommandOutput = UpdateTableResponse & __MetadataBearer; +/** + *

Updates a metadata table in the Data Catalog.

+ */ export class UpdateTableCommand extends $Command< UpdateTableCommandInput, UpdateTableCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateTriggerCommand.ts b/clients/client-glue/commands/UpdateTriggerCommand.ts index e6c7965affad3..8294f2ec2f4aa 100644 --- a/clients/client-glue/commands/UpdateTriggerCommand.ts +++ b/clients/client-glue/commands/UpdateTriggerCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTriggerCommandInput = UpdateTriggerRequest; export type UpdateTriggerCommandOutput = UpdateTriggerResponse & __MetadataBearer; +/** + *

Updates a trigger definition.

+ */ export class UpdateTriggerCommand extends $Command< UpdateTriggerCommandInput, UpdateTriggerCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTriggerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateUserDefinedFunctionCommand.ts b/clients/client-glue/commands/UpdateUserDefinedFunctionCommand.ts index 9253e5b39b86a..8118d00c064f2 100644 --- a/clients/client-glue/commands/UpdateUserDefinedFunctionCommand.ts +++ b/clients/client-glue/commands/UpdateUserDefinedFunctionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserDefinedFunctionCommandInput = UpdateUserDefinedFunctionRequest; export type UpdateUserDefinedFunctionCommandOutput = UpdateUserDefinedFunctionResponse & __MetadataBearer; +/** + *

Updates an existing function definition in the Data Catalog.

+ */ export class UpdateUserDefinedFunctionCommand extends $Command< UpdateUserDefinedFunctionCommandInput, UpdateUserDefinedFunctionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserDefinedFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/commands/UpdateWorkflowCommand.ts b/clients/client-glue/commands/UpdateWorkflowCommand.ts index 43bf6960044f4..c0deeecec894d 100644 --- a/clients/client-glue/commands/UpdateWorkflowCommand.ts +++ b/clients/client-glue/commands/UpdateWorkflowCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateWorkflowCommandInput = UpdateWorkflowRequest; export type UpdateWorkflowCommandOutput = UpdateWorkflowResponse & __MetadataBearer; +/** + *

Updates an existing workflow.

+ */ export class UpdateWorkflowCommand extends $Command< UpdateWorkflowCommandInput, UpdateWorkflowCommandOutput, @@ -34,6 +37,9 @@ export class UpdateWorkflowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GlueClientResolvedConfig, diff --git a/clients/client-glue/package.json b/clients/client-glue/package.json index d5fd5b2e09eed..0ef6649695f1c 100644 --- a/clients/client-glue/package.json +++ b/clients/client-glue/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Glue Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-glue/pagination/GetClassifiersPaginator.ts b/clients/client-glue/pagination/GetClassifiersPaginator.ts index e7ed7f12264a3..7517534b5d2d5 100644 --- a/clients/client-glue/pagination/GetClassifiersPaginator.ts +++ b/clients/client-glue/pagination/GetClassifiersPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetClassifiersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetClassifiersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetClassifiersCommandInput, diff --git a/clients/client-glue/pagination/GetConnectionsPaginator.ts b/clients/client-glue/pagination/GetConnectionsPaginator.ts index 9bfcee7c13563..657b66d50b1c3 100644 --- a/clients/client-glue/pagination/GetConnectionsPaginator.ts +++ b/clients/client-glue/pagination/GetConnectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetConnectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetConnectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetConnectionsCommandInput, diff --git a/clients/client-glue/pagination/GetCrawlerMetricsPaginator.ts b/clients/client-glue/pagination/GetCrawlerMetricsPaginator.ts index 59d9afd468975..cd60ffe48da6a 100644 --- a/clients/client-glue/pagination/GetCrawlerMetricsPaginator.ts +++ b/clients/client-glue/pagination/GetCrawlerMetricsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetCrawlerMetricsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCrawlerMetricsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetCrawlerMetricsCommandInput, diff --git a/clients/client-glue/pagination/GetCrawlersPaginator.ts b/clients/client-glue/pagination/GetCrawlersPaginator.ts index 1d42636c17555..05f37cb2f9bfa 100644 --- a/clients/client-glue/pagination/GetCrawlersPaginator.ts +++ b/clients/client-glue/pagination/GetCrawlersPaginator.ts @@ -4,6 +4,9 @@ import { GetCrawlersCommand, GetCrawlersCommandInput, GetCrawlersCommandOutput } import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetCrawlersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCrawlersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetCrawlersCommandInput, diff --git a/clients/client-glue/pagination/GetDatabasesPaginator.ts b/clients/client-glue/pagination/GetDatabasesPaginator.ts index abbbdb1dd36ed..f890193888a51 100644 --- a/clients/client-glue/pagination/GetDatabasesPaginator.ts +++ b/clients/client-glue/pagination/GetDatabasesPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetDatabasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDatabasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetDatabasesCommandInput, diff --git a/clients/client-glue/pagination/GetDevEndpointsPaginator.ts b/clients/client-glue/pagination/GetDevEndpointsPaginator.ts index 2fe0c49c8b907..ae5bca6a628b2 100644 --- a/clients/client-glue/pagination/GetDevEndpointsPaginator.ts +++ b/clients/client-glue/pagination/GetDevEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetDevEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDevEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetDevEndpointsCommandInput, diff --git a/clients/client-glue/pagination/GetJobRunsPaginator.ts b/clients/client-glue/pagination/GetJobRunsPaginator.ts index 5298654e0ce53..7e969fe00cf63 100644 --- a/clients/client-glue/pagination/GetJobRunsPaginator.ts +++ b/clients/client-glue/pagination/GetJobRunsPaginator.ts @@ -4,6 +4,9 @@ import { GetJobRunsCommand, GetJobRunsCommandInput, GetJobRunsCommandOutput } fr import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetJobRunsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetJobRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetJobRunsCommandInput, diff --git a/clients/client-glue/pagination/GetJobsPaginator.ts b/clients/client-glue/pagination/GetJobsPaginator.ts index 6520712ce56f2..6a00ce2670574 100644 --- a/clients/client-glue/pagination/GetJobsPaginator.ts +++ b/clients/client-glue/pagination/GetJobsPaginator.ts @@ -4,6 +4,9 @@ import { GetJobsCommand, GetJobsCommandInput, GetJobsCommandOutput } from "../co import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetJobsCommandInput, diff --git a/clients/client-glue/pagination/GetMLTaskRunsPaginator.ts b/clients/client-glue/pagination/GetMLTaskRunsPaginator.ts index d91e1dcc649e0..b0f473e872514 100644 --- a/clients/client-glue/pagination/GetMLTaskRunsPaginator.ts +++ b/clients/client-glue/pagination/GetMLTaskRunsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetMLTaskRunsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetMLTaskRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetMLTaskRunsCommandInput, diff --git a/clients/client-glue/pagination/GetMLTransformsPaginator.ts b/clients/client-glue/pagination/GetMLTransformsPaginator.ts index be32b4f75cef8..2cdcbbd436be7 100644 --- a/clients/client-glue/pagination/GetMLTransformsPaginator.ts +++ b/clients/client-glue/pagination/GetMLTransformsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetMLTransformsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetMLTransformsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetMLTransformsCommandInput, diff --git a/clients/client-glue/pagination/GetPartitionIndexesPaginator.ts b/clients/client-glue/pagination/GetPartitionIndexesPaginator.ts index e258e7d64b46c..0813f73375033 100644 --- a/clients/client-glue/pagination/GetPartitionIndexesPaginator.ts +++ b/clients/client-glue/pagination/GetPartitionIndexesPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetPartitionIndexesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetPartitionIndexesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetPartitionIndexesCommandInput, diff --git a/clients/client-glue/pagination/GetPartitionsPaginator.ts b/clients/client-glue/pagination/GetPartitionsPaginator.ts index 8506c30a30142..247ca5aba86a7 100644 --- a/clients/client-glue/pagination/GetPartitionsPaginator.ts +++ b/clients/client-glue/pagination/GetPartitionsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetPartitionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetPartitionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetPartitionsCommandInput, diff --git a/clients/client-glue/pagination/GetSecurityConfigurationsPaginator.ts b/clients/client-glue/pagination/GetSecurityConfigurationsPaginator.ts index 0f06e52d240cb..5f405cae86f1e 100644 --- a/clients/client-glue/pagination/GetSecurityConfigurationsPaginator.ts +++ b/clients/client-glue/pagination/GetSecurityConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetSecurityConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSecurityConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetSecurityConfigurationsCommandInput, diff --git a/clients/client-glue/pagination/GetTableVersionsPaginator.ts b/clients/client-glue/pagination/GetTableVersionsPaginator.ts index 05fabd5ed8d5f..ab2f362a7bdae 100644 --- a/clients/client-glue/pagination/GetTableVersionsPaginator.ts +++ b/clients/client-glue/pagination/GetTableVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetTableVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTableVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetTableVersionsCommandInput, diff --git a/clients/client-glue/pagination/GetTablesPaginator.ts b/clients/client-glue/pagination/GetTablesPaginator.ts index c8c0ac65c11c6..a8ebf3abc76df 100644 --- a/clients/client-glue/pagination/GetTablesPaginator.ts +++ b/clients/client-glue/pagination/GetTablesPaginator.ts @@ -4,6 +4,9 @@ import { GetTablesCommand, GetTablesCommandInput, GetTablesCommandOutput } from import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetTablesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetTablesCommandInput, diff --git a/clients/client-glue/pagination/GetTriggersPaginator.ts b/clients/client-glue/pagination/GetTriggersPaginator.ts index 02330cb66bb76..26fd8e6a8c83e 100644 --- a/clients/client-glue/pagination/GetTriggersPaginator.ts +++ b/clients/client-glue/pagination/GetTriggersPaginator.ts @@ -4,6 +4,9 @@ import { GetTriggersCommand, GetTriggersCommandInput, GetTriggersCommandOutput } import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetTriggersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTriggersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetTriggersCommandInput, diff --git a/clients/client-glue/pagination/GetUserDefinedFunctionsPaginator.ts b/clients/client-glue/pagination/GetUserDefinedFunctionsPaginator.ts index ae83581682123..65493d50e2eed 100644 --- a/clients/client-glue/pagination/GetUserDefinedFunctionsPaginator.ts +++ b/clients/client-glue/pagination/GetUserDefinedFunctionsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetUserDefinedFunctionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetUserDefinedFunctionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetUserDefinedFunctionsCommandInput, diff --git a/clients/client-glue/pagination/GetWorkflowRunsPaginator.ts b/clients/client-glue/pagination/GetWorkflowRunsPaginator.ts index a7afc036a19aa..755abfb69ad2c 100644 --- a/clients/client-glue/pagination/GetWorkflowRunsPaginator.ts +++ b/clients/client-glue/pagination/GetWorkflowRunsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: GetWorkflowRunsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetWorkflowRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: GetWorkflowRunsCommandInput, diff --git a/clients/client-glue/pagination/ListCrawlersPaginator.ts b/clients/client-glue/pagination/ListCrawlersPaginator.ts index bde96f3186360..3cd9e970997a3 100644 --- a/clients/client-glue/pagination/ListCrawlersPaginator.ts +++ b/clients/client-glue/pagination/ListCrawlersPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: ListCrawlersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCrawlersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: ListCrawlersCommandInput, diff --git a/clients/client-glue/pagination/ListDevEndpointsPaginator.ts b/clients/client-glue/pagination/ListDevEndpointsPaginator.ts index 212b6a9df687f..5a8590f59c840 100644 --- a/clients/client-glue/pagination/ListDevEndpointsPaginator.ts +++ b/clients/client-glue/pagination/ListDevEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: ListDevEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDevEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: ListDevEndpointsCommandInput, diff --git a/clients/client-glue/pagination/ListJobsPaginator.ts b/clients/client-glue/pagination/ListJobsPaginator.ts index 002031d09bc84..c199e6a7ace73 100644 --- a/clients/client-glue/pagination/ListJobsPaginator.ts +++ b/clients/client-glue/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: ListJobsCommandInput, diff --git a/clients/client-glue/pagination/ListMLTransformsPaginator.ts b/clients/client-glue/pagination/ListMLTransformsPaginator.ts index 9d35fdbdb29dd..1d2489de203af 100644 --- a/clients/client-glue/pagination/ListMLTransformsPaginator.ts +++ b/clients/client-glue/pagination/ListMLTransformsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: ListMLTransformsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMLTransformsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: ListMLTransformsCommandInput, diff --git a/clients/client-glue/pagination/ListTriggersPaginator.ts b/clients/client-glue/pagination/ListTriggersPaginator.ts index 5dee5156809ac..c420438001123 100644 --- a/clients/client-glue/pagination/ListTriggersPaginator.ts +++ b/clients/client-glue/pagination/ListTriggersPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: ListTriggersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTriggersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: ListTriggersCommandInput, diff --git a/clients/client-glue/pagination/ListWorkflowsPaginator.ts b/clients/client-glue/pagination/ListWorkflowsPaginator.ts index da91ad2241c9f..3fb5f906b2361 100644 --- a/clients/client-glue/pagination/ListWorkflowsPaginator.ts +++ b/clients/client-glue/pagination/ListWorkflowsPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: ListWorkflowsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorkflowsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: ListWorkflowsCommandInput, diff --git a/clients/client-glue/pagination/SearchTablesPaginator.ts b/clients/client-glue/pagination/SearchTablesPaginator.ts index 995249131652c..3c4192d28f5f9 100644 --- a/clients/client-glue/pagination/SearchTablesPaginator.ts +++ b/clients/client-glue/pagination/SearchTablesPaginator.ts @@ -8,6 +8,9 @@ import { import { GluePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GlueClient, input: SearchTablesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchTablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Glue, input: SearchTablesCommandInput, diff --git a/clients/client-glue/runtimeConfig.browser.ts b/clients/client-glue/runtimeConfig.browser.ts index c44a80d14f414..5b879ad928f14 100644 --- a/clients/client-glue/runtimeConfig.browser.ts +++ b/clients/client-glue/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./GlueClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-glue/runtimeConfig.native.ts b/clients/client-glue/runtimeConfig.native.ts index 2dd6efaecd553..cfaeac2fcf549 100644 --- a/clients/client-glue/runtimeConfig.native.ts +++ b/clients/client-glue/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./GlueClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-glue/runtimeConfig.shared.ts b/clients/client-glue/runtimeConfig.shared.ts index 1d5fb6c198f98..82e851ea63434 100644 --- a/clients/client-glue/runtimeConfig.shared.ts +++ b/clients/client-glue/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-03-31", disableHostPrefix: false, diff --git a/clients/client-glue/runtimeConfig.ts b/clients/client-glue/runtimeConfig.ts index 8a304eb4fd91a..57795af494f82 100644 --- a/clients/client-glue/runtimeConfig.ts +++ b/clients/client-glue/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./GlueClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-glue/tsconfig.json b/clients/client-glue/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-glue/tsconfig.json +++ b/clients/client-glue/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-greengrass/commands/AssociateRoleToGroupCommand.ts b/clients/client-greengrass/commands/AssociateRoleToGroupCommand.ts index 9f921834d864f..cf2d6124b54e3 100644 --- a/clients/client-greengrass/commands/AssociateRoleToGroupCommand.ts +++ b/clients/client-greengrass/commands/AssociateRoleToGroupCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateRoleToGroupCommandInput = AssociateRoleToGroupRequest; export type AssociateRoleToGroupCommandOutput = AssociateRoleToGroupResponse & __MetadataBearer; +/** + * Associates a role with a group. Your Greengrass core will use the role to access AWS cloud services. The role's permissions should allow Greengrass core Lambda functions to perform actions against the cloud. + */ export class AssociateRoleToGroupCommand extends $Command< AssociateRoleToGroupCommandInput, AssociateRoleToGroupCommandOutput, @@ -34,6 +37,9 @@ export class AssociateRoleToGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/AssociateServiceRoleToAccountCommand.ts b/clients/client-greengrass/commands/AssociateServiceRoleToAccountCommand.ts index 0547a3e2530d1..fc0571d8453a4 100644 --- a/clients/client-greengrass/commands/AssociateServiceRoleToAccountCommand.ts +++ b/clients/client-greengrass/commands/AssociateServiceRoleToAccountCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateServiceRoleToAccountCommandInput = AssociateServiceRoleToAccountRequest; export type AssociateServiceRoleToAccountCommandOutput = AssociateServiceRoleToAccountResponse & __MetadataBearer; +/** + * Associates a role with your account. AWS IoT Greengrass will use the role to access your Lambda functions and AWS IoT resources. This is necessary for deployments to succeed. The role must have at least minimum permissions in the policy ''AWSGreengrassResourceAccessRolePolicy''. + */ export class AssociateServiceRoleToAccountCommand extends $Command< AssociateServiceRoleToAccountCommandInput, AssociateServiceRoleToAccountCommandOutput, @@ -34,6 +37,9 @@ export class AssociateServiceRoleToAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateConnectorDefinitionCommand.ts b/clients/client-greengrass/commands/CreateConnectorDefinitionCommand.ts index cf7b6b6eb35bf..227d8fd1d2394 100644 --- a/clients/client-greengrass/commands/CreateConnectorDefinitionCommand.ts +++ b/clients/client-greengrass/commands/CreateConnectorDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateConnectorDefinitionCommandInput = CreateConnectorDefinitionRequest; export type CreateConnectorDefinitionCommandOutput = CreateConnectorDefinitionResponse & __MetadataBearer; +/** + * Creates a connector definition. You may provide the initial version of the connector definition now or use ''CreateConnectorDefinitionVersion'' at a later time. + */ export class CreateConnectorDefinitionCommand extends $Command< CreateConnectorDefinitionCommandInput, CreateConnectorDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateConnectorDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateConnectorDefinitionVersionCommand.ts b/clients/client-greengrass/commands/CreateConnectorDefinitionVersionCommand.ts index 232e940b3d690..715d158845a9c 100644 --- a/clients/client-greengrass/commands/CreateConnectorDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/CreateConnectorDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateConnectorDefinitionVersionCommandInput = CreateConnectorDefinitionVersionRequest; export type CreateConnectorDefinitionVersionCommandOutput = CreateConnectorDefinitionVersionResponse & __MetadataBearer; +/** + * Creates a version of a connector definition which has already been defined. + */ export class CreateConnectorDefinitionVersionCommand extends $Command< CreateConnectorDefinitionVersionCommandInput, CreateConnectorDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateConnectorDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateCoreDefinitionCommand.ts b/clients/client-greengrass/commands/CreateCoreDefinitionCommand.ts index 040dee3918f66..5b5e565b484f8 100644 --- a/clients/client-greengrass/commands/CreateCoreDefinitionCommand.ts +++ b/clients/client-greengrass/commands/CreateCoreDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateCoreDefinitionCommandInput = CreateCoreDefinitionRequest; export type CreateCoreDefinitionCommandOutput = CreateCoreDefinitionResponse & __MetadataBearer; +/** + * Creates a core definition. You may provide the initial version of the core definition now or use ''CreateCoreDefinitionVersion'' at a later time. Greengrass groups must each contain exactly one Greengrass core. + */ export class CreateCoreDefinitionCommand extends $Command< CreateCoreDefinitionCommandInput, CreateCoreDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateCoreDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateCoreDefinitionVersionCommand.ts b/clients/client-greengrass/commands/CreateCoreDefinitionVersionCommand.ts index 965e1c2bb2671..a1c28c5e8bb21 100644 --- a/clients/client-greengrass/commands/CreateCoreDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/CreateCoreDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateCoreDefinitionVersionCommandInput = CreateCoreDefinitionVersionRequest; export type CreateCoreDefinitionVersionCommandOutput = CreateCoreDefinitionVersionResponse & __MetadataBearer; +/** + * Creates a version of a core definition that has already been defined. Greengrass groups must each contain exactly one Greengrass core. + */ export class CreateCoreDefinitionVersionCommand extends $Command< CreateCoreDefinitionVersionCommandInput, CreateCoreDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateCoreDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateDeploymentCommand.ts b/clients/client-greengrass/commands/CreateDeploymentCommand.ts index b12fe0a434fd3..b53f454e5690a 100644 --- a/clients/client-greengrass/commands/CreateDeploymentCommand.ts +++ b/clients/client-greengrass/commands/CreateDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDeploymentCommandInput = CreateDeploymentRequest; export type CreateDeploymentCommandOutput = CreateDeploymentResponse & __MetadataBearer; +/** + * Creates a deployment. ''CreateDeployment'' requests are idempotent with respect to the ''X-Amzn-Client-Token'' token and the request parameters. + */ export class CreateDeploymentCommand extends $Command< CreateDeploymentCommandInput, CreateDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class CreateDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateDeviceDefinitionCommand.ts b/clients/client-greengrass/commands/CreateDeviceDefinitionCommand.ts index 1d5f32a27ccea..c54a9ef05d9fb 100644 --- a/clients/client-greengrass/commands/CreateDeviceDefinitionCommand.ts +++ b/clients/client-greengrass/commands/CreateDeviceDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDeviceDefinitionCommandInput = CreateDeviceDefinitionRequest; export type CreateDeviceDefinitionCommandOutput = CreateDeviceDefinitionResponse & __MetadataBearer; +/** + * Creates a device definition. You may provide the initial version of the device definition now or use ''CreateDeviceDefinitionVersion'' at a later time. + */ export class CreateDeviceDefinitionCommand extends $Command< CreateDeviceDefinitionCommandInput, CreateDeviceDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateDeviceDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateDeviceDefinitionVersionCommand.ts b/clients/client-greengrass/commands/CreateDeviceDefinitionVersionCommand.ts index 330236dd3fca2..d73ef4eec4032 100644 --- a/clients/client-greengrass/commands/CreateDeviceDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/CreateDeviceDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDeviceDefinitionVersionCommandInput = CreateDeviceDefinitionVersionRequest; export type CreateDeviceDefinitionVersionCommandOutput = CreateDeviceDefinitionVersionResponse & __MetadataBearer; +/** + * Creates a version of a device definition that has already been defined. + */ export class CreateDeviceDefinitionVersionCommand extends $Command< CreateDeviceDefinitionVersionCommandInput, CreateDeviceDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateDeviceDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateFunctionDefinitionCommand.ts b/clients/client-greengrass/commands/CreateFunctionDefinitionCommand.ts index b791898ae00e0..96fa8db3fcc19 100644 --- a/clients/client-greengrass/commands/CreateFunctionDefinitionCommand.ts +++ b/clients/client-greengrass/commands/CreateFunctionDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFunctionDefinitionCommandInput = CreateFunctionDefinitionRequest; export type CreateFunctionDefinitionCommandOutput = CreateFunctionDefinitionResponse & __MetadataBearer; +/** + * Creates a Lambda function definition which contains a list of Lambda functions and their configurations to be used in a group. You can create an initial version of the definition by providing a list of Lambda functions and their configurations now, or use ''CreateFunctionDefinitionVersion'' later. + */ export class CreateFunctionDefinitionCommand extends $Command< CreateFunctionDefinitionCommandInput, CreateFunctionDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateFunctionDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateFunctionDefinitionVersionCommand.ts b/clients/client-greengrass/commands/CreateFunctionDefinitionVersionCommand.ts index 1dcb6aa4200de..6674b7b1ad156 100644 --- a/clients/client-greengrass/commands/CreateFunctionDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/CreateFunctionDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFunctionDefinitionVersionCommandInput = CreateFunctionDefinitionVersionRequest; export type CreateFunctionDefinitionVersionCommandOutput = CreateFunctionDefinitionVersionResponse & __MetadataBearer; +/** + * Creates a version of a Lambda function definition that has already been defined. + */ export class CreateFunctionDefinitionVersionCommand extends $Command< CreateFunctionDefinitionVersionCommandInput, CreateFunctionDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateFunctionDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateGroupCertificateAuthorityCommand.ts b/clients/client-greengrass/commands/CreateGroupCertificateAuthorityCommand.ts index a3e59a56eaef4..05a471fe42680 100644 --- a/clients/client-greengrass/commands/CreateGroupCertificateAuthorityCommand.ts +++ b/clients/client-greengrass/commands/CreateGroupCertificateAuthorityCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGroupCertificateAuthorityCommandInput = CreateGroupCertificateAuthorityRequest; export type CreateGroupCertificateAuthorityCommandOutput = CreateGroupCertificateAuthorityResponse & __MetadataBearer; +/** + * Creates a CA for the group. If a CA already exists, it will rotate the existing CA. + */ export class CreateGroupCertificateAuthorityCommand extends $Command< CreateGroupCertificateAuthorityCommandInput, CreateGroupCertificateAuthorityCommandOutput, @@ -34,6 +37,9 @@ export class CreateGroupCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateGroupCommand.ts b/clients/client-greengrass/commands/CreateGroupCommand.ts index 31d1581c1b346..ac3742c8df4ff 100644 --- a/clients/client-greengrass/commands/CreateGroupCommand.ts +++ b/clients/client-greengrass/commands/CreateGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGroupCommandInput = CreateGroupRequest; export type CreateGroupCommandOutput = CreateGroupResponse & __MetadataBearer; +/** + * Creates a group. You may provide the initial version of the group or use ''CreateGroupVersion'' at a later time. Tip: You can use the ''gg_group_setup'' package (https://github.com/awslabs/aws-greengrass-group-setup) as a library or command-line application to create and deploy Greengrass groups. + */ export class CreateGroupCommand extends $Command< CreateGroupCommandInput, CreateGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateGroupVersionCommand.ts b/clients/client-greengrass/commands/CreateGroupVersionCommand.ts index 97180910ca93a..b7b7f73363ca2 100644 --- a/clients/client-greengrass/commands/CreateGroupVersionCommand.ts +++ b/clients/client-greengrass/commands/CreateGroupVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGroupVersionCommandInput = CreateGroupVersionRequest; export type CreateGroupVersionCommandOutput = CreateGroupVersionResponse & __MetadataBearer; +/** + * Creates a version of a group which has already been defined. + */ export class CreateGroupVersionCommand extends $Command< CreateGroupVersionCommandInput, CreateGroupVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateGroupVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateLoggerDefinitionCommand.ts b/clients/client-greengrass/commands/CreateLoggerDefinitionCommand.ts index fce792f40d52d..461eb6700034b 100644 --- a/clients/client-greengrass/commands/CreateLoggerDefinitionCommand.ts +++ b/clients/client-greengrass/commands/CreateLoggerDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateLoggerDefinitionCommandInput = CreateLoggerDefinitionRequest; export type CreateLoggerDefinitionCommandOutput = CreateLoggerDefinitionResponse & __MetadataBearer; +/** + * Creates a logger definition. You may provide the initial version of the logger definition now or use ''CreateLoggerDefinitionVersion'' at a later time. + */ export class CreateLoggerDefinitionCommand extends $Command< CreateLoggerDefinitionCommandInput, CreateLoggerDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateLoggerDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateLoggerDefinitionVersionCommand.ts b/clients/client-greengrass/commands/CreateLoggerDefinitionVersionCommand.ts index 0d057c7516be8..a68a10e211655 100644 --- a/clients/client-greengrass/commands/CreateLoggerDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/CreateLoggerDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateLoggerDefinitionVersionCommandInput = CreateLoggerDefinitionVersionRequest; export type CreateLoggerDefinitionVersionCommandOutput = CreateLoggerDefinitionVersionResponse & __MetadataBearer; +/** + * Creates a version of a logger definition that has already been defined. + */ export class CreateLoggerDefinitionVersionCommand extends $Command< CreateLoggerDefinitionVersionCommandInput, CreateLoggerDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateLoggerDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateResourceDefinitionCommand.ts b/clients/client-greengrass/commands/CreateResourceDefinitionCommand.ts index 76049b633746f..5749fd6f4e712 100644 --- a/clients/client-greengrass/commands/CreateResourceDefinitionCommand.ts +++ b/clients/client-greengrass/commands/CreateResourceDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateResourceDefinitionCommandInput = CreateResourceDefinitionRequest; export type CreateResourceDefinitionCommandOutput = CreateResourceDefinitionResponse & __MetadataBearer; +/** + * Creates a resource definition which contains a list of resources to be used in a group. You can create an initial version of the definition by providing a list of resources now, or use ''CreateResourceDefinitionVersion'' later. + */ export class CreateResourceDefinitionCommand extends $Command< CreateResourceDefinitionCommandInput, CreateResourceDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateResourceDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateResourceDefinitionVersionCommand.ts b/clients/client-greengrass/commands/CreateResourceDefinitionVersionCommand.ts index f0308b48575cb..f8d99f299b64d 100644 --- a/clients/client-greengrass/commands/CreateResourceDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/CreateResourceDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateResourceDefinitionVersionCommandInput = CreateResourceDefinitionVersionRequest; export type CreateResourceDefinitionVersionCommandOutput = CreateResourceDefinitionVersionResponse & __MetadataBearer; +/** + * Creates a version of a resource definition that has already been defined. + */ export class CreateResourceDefinitionVersionCommand extends $Command< CreateResourceDefinitionVersionCommandInput, CreateResourceDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateResourceDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateSoftwareUpdateJobCommand.ts b/clients/client-greengrass/commands/CreateSoftwareUpdateJobCommand.ts index 5a761d4cf8aba..7b6327b221701 100644 --- a/clients/client-greengrass/commands/CreateSoftwareUpdateJobCommand.ts +++ b/clients/client-greengrass/commands/CreateSoftwareUpdateJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSoftwareUpdateJobCommandInput = CreateSoftwareUpdateJobRequest; export type CreateSoftwareUpdateJobCommandOutput = CreateSoftwareUpdateJobResponse & __MetadataBearer; +/** + * Creates a software update for a core or group of cores (specified as an IoT thing group.) Use this to update the OTA Agent as well as the Greengrass core software. It makes use of the IoT Jobs feature which provides additional commands to manage a Greengrass core software update job. + */ export class CreateSoftwareUpdateJobCommand extends $Command< CreateSoftwareUpdateJobCommandInput, CreateSoftwareUpdateJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateSoftwareUpdateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateSubscriptionDefinitionCommand.ts b/clients/client-greengrass/commands/CreateSubscriptionDefinitionCommand.ts index e236e466f8e46..7ad8c4d89e9e7 100644 --- a/clients/client-greengrass/commands/CreateSubscriptionDefinitionCommand.ts +++ b/clients/client-greengrass/commands/CreateSubscriptionDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSubscriptionDefinitionCommandInput = CreateSubscriptionDefinitionRequest; export type CreateSubscriptionDefinitionCommandOutput = CreateSubscriptionDefinitionResponse & __MetadataBearer; +/** + * Creates a subscription definition. You may provide the initial version of the subscription definition now or use ''CreateSubscriptionDefinitionVersion'' at a later time. + */ export class CreateSubscriptionDefinitionCommand extends $Command< CreateSubscriptionDefinitionCommandInput, CreateSubscriptionDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateSubscriptionDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/CreateSubscriptionDefinitionVersionCommand.ts b/clients/client-greengrass/commands/CreateSubscriptionDefinitionVersionCommand.ts index 0edcfc36e0bd0..9e2a63720b39e 100644 --- a/clients/client-greengrass/commands/CreateSubscriptionDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/CreateSubscriptionDefinitionVersionCommand.ts @@ -24,6 +24,9 @@ export type CreateSubscriptionDefinitionVersionCommandInput = CreateSubscription export type CreateSubscriptionDefinitionVersionCommandOutput = CreateSubscriptionDefinitionVersionResponse & __MetadataBearer; +/** + * Creates a version of a subscription definition which has already been defined. + */ export class CreateSubscriptionDefinitionVersionCommand extends $Command< CreateSubscriptionDefinitionVersionCommandInput, CreateSubscriptionDefinitionVersionCommandOutput, @@ -38,6 +41,9 @@ export class CreateSubscriptionDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DeleteConnectorDefinitionCommand.ts b/clients/client-greengrass/commands/DeleteConnectorDefinitionCommand.ts index 9f14d41a2b413..58fb7b998693d 100644 --- a/clients/client-greengrass/commands/DeleteConnectorDefinitionCommand.ts +++ b/clients/client-greengrass/commands/DeleteConnectorDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteConnectorDefinitionCommandInput = DeleteConnectorDefinitionRequest; export type DeleteConnectorDefinitionCommandOutput = DeleteConnectorDefinitionResponse & __MetadataBearer; +/** + * Deletes a connector definition. + */ export class DeleteConnectorDefinitionCommand extends $Command< DeleteConnectorDefinitionCommandInput, DeleteConnectorDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteConnectorDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DeleteCoreDefinitionCommand.ts b/clients/client-greengrass/commands/DeleteCoreDefinitionCommand.ts index 4e662e19935c1..f14a29062d5df 100644 --- a/clients/client-greengrass/commands/DeleteCoreDefinitionCommand.ts +++ b/clients/client-greengrass/commands/DeleteCoreDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCoreDefinitionCommandInput = DeleteCoreDefinitionRequest; export type DeleteCoreDefinitionCommandOutput = DeleteCoreDefinitionResponse & __MetadataBearer; +/** + * Deletes a core definition. + */ export class DeleteCoreDefinitionCommand extends $Command< DeleteCoreDefinitionCommandInput, DeleteCoreDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCoreDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DeleteDeviceDefinitionCommand.ts b/clients/client-greengrass/commands/DeleteDeviceDefinitionCommand.ts index c60635ca4680e..6e080e967a594 100644 --- a/clients/client-greengrass/commands/DeleteDeviceDefinitionCommand.ts +++ b/clients/client-greengrass/commands/DeleteDeviceDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDeviceDefinitionCommandInput = DeleteDeviceDefinitionRequest; export type DeleteDeviceDefinitionCommandOutput = DeleteDeviceDefinitionResponse & __MetadataBearer; +/** + * Deletes a device definition. + */ export class DeleteDeviceDefinitionCommand extends $Command< DeleteDeviceDefinitionCommandInput, DeleteDeviceDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDeviceDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DeleteFunctionDefinitionCommand.ts b/clients/client-greengrass/commands/DeleteFunctionDefinitionCommand.ts index 6694a4484a73a..ae82851f0e2cb 100644 --- a/clients/client-greengrass/commands/DeleteFunctionDefinitionCommand.ts +++ b/clients/client-greengrass/commands/DeleteFunctionDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFunctionDefinitionCommandInput = DeleteFunctionDefinitionRequest; export type DeleteFunctionDefinitionCommandOutput = DeleteFunctionDefinitionResponse & __MetadataBearer; +/** + * Deletes a Lambda function definition. + */ export class DeleteFunctionDefinitionCommand extends $Command< DeleteFunctionDefinitionCommandInput, DeleteFunctionDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFunctionDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DeleteGroupCommand.ts b/clients/client-greengrass/commands/DeleteGroupCommand.ts index 06ecdbc348d97..4f7f5a1c39b7b 100644 --- a/clients/client-greengrass/commands/DeleteGroupCommand.ts +++ b/clients/client-greengrass/commands/DeleteGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGroupCommandInput = DeleteGroupRequest; export type DeleteGroupCommandOutput = DeleteGroupResponse & __MetadataBearer; +/** + * Deletes a group. + */ export class DeleteGroupCommand extends $Command< DeleteGroupCommandInput, DeleteGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DeleteLoggerDefinitionCommand.ts b/clients/client-greengrass/commands/DeleteLoggerDefinitionCommand.ts index 9d82110e1b971..6fa32923ad3e9 100644 --- a/clients/client-greengrass/commands/DeleteLoggerDefinitionCommand.ts +++ b/clients/client-greengrass/commands/DeleteLoggerDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLoggerDefinitionCommandInput = DeleteLoggerDefinitionRequest; export type DeleteLoggerDefinitionCommandOutput = DeleteLoggerDefinitionResponse & __MetadataBearer; +/** + * Deletes a logger definition. + */ export class DeleteLoggerDefinitionCommand extends $Command< DeleteLoggerDefinitionCommandInput, DeleteLoggerDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLoggerDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DeleteResourceDefinitionCommand.ts b/clients/client-greengrass/commands/DeleteResourceDefinitionCommand.ts index 97fa0495849f8..0c1026a38e826 100644 --- a/clients/client-greengrass/commands/DeleteResourceDefinitionCommand.ts +++ b/clients/client-greengrass/commands/DeleteResourceDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourceDefinitionCommandInput = DeleteResourceDefinitionRequest; export type DeleteResourceDefinitionCommandOutput = DeleteResourceDefinitionResponse & __MetadataBearer; +/** + * Deletes a resource definition. + */ export class DeleteResourceDefinitionCommand extends $Command< DeleteResourceDefinitionCommandInput, DeleteResourceDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourceDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DeleteSubscriptionDefinitionCommand.ts b/clients/client-greengrass/commands/DeleteSubscriptionDefinitionCommand.ts index 525d4ec7c5272..cf3664ab2f8d0 100644 --- a/clients/client-greengrass/commands/DeleteSubscriptionDefinitionCommand.ts +++ b/clients/client-greengrass/commands/DeleteSubscriptionDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSubscriptionDefinitionCommandInput = DeleteSubscriptionDefinitionRequest; export type DeleteSubscriptionDefinitionCommandOutput = DeleteSubscriptionDefinitionResponse & __MetadataBearer; +/** + * Deletes a subscription definition. + */ export class DeleteSubscriptionDefinitionCommand extends $Command< DeleteSubscriptionDefinitionCommandInput, DeleteSubscriptionDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSubscriptionDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DisassociateRoleFromGroupCommand.ts b/clients/client-greengrass/commands/DisassociateRoleFromGroupCommand.ts index 78dd70270fa7c..210ecb5e34b40 100644 --- a/clients/client-greengrass/commands/DisassociateRoleFromGroupCommand.ts +++ b/clients/client-greengrass/commands/DisassociateRoleFromGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateRoleFromGroupCommandInput = DisassociateRoleFromGroupRequest; export type DisassociateRoleFromGroupCommandOutput = DisassociateRoleFromGroupResponse & __MetadataBearer; +/** + * Disassociates the role from a group. + */ export class DisassociateRoleFromGroupCommand extends $Command< DisassociateRoleFromGroupCommandInput, DisassociateRoleFromGroupCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateRoleFromGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/DisassociateServiceRoleFromAccountCommand.ts b/clients/client-greengrass/commands/DisassociateServiceRoleFromAccountCommand.ts index 57bdf4cb833c7..942763972a8ec 100644 --- a/clients/client-greengrass/commands/DisassociateServiceRoleFromAccountCommand.ts +++ b/clients/client-greengrass/commands/DisassociateServiceRoleFromAccountCommand.ts @@ -24,6 +24,9 @@ export type DisassociateServiceRoleFromAccountCommandInput = DisassociateService export type DisassociateServiceRoleFromAccountCommandOutput = DisassociateServiceRoleFromAccountResponse & __MetadataBearer; +/** + * Disassociates the service role from your account. Without a service role, deployments will not work. + */ export class DisassociateServiceRoleFromAccountCommand extends $Command< DisassociateServiceRoleFromAccountCommandInput, DisassociateServiceRoleFromAccountCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateServiceRoleFromAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetAssociatedRoleCommand.ts b/clients/client-greengrass/commands/GetAssociatedRoleCommand.ts index 62e634162fc9d..5b8e6ad214800 100644 --- a/clients/client-greengrass/commands/GetAssociatedRoleCommand.ts +++ b/clients/client-greengrass/commands/GetAssociatedRoleCommand.ts @@ -20,6 +20,9 @@ import { export type GetAssociatedRoleCommandInput = GetAssociatedRoleRequest; export type GetAssociatedRoleCommandOutput = GetAssociatedRoleResponse & __MetadataBearer; +/** + * Retrieves the role associated with a particular group. + */ export class GetAssociatedRoleCommand extends $Command< GetAssociatedRoleCommandInput, GetAssociatedRoleCommandOutput, @@ -34,6 +37,9 @@ export class GetAssociatedRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetBulkDeploymentStatusCommand.ts b/clients/client-greengrass/commands/GetBulkDeploymentStatusCommand.ts index 390752340c9b6..f0b726d4b1698 100644 --- a/clients/client-greengrass/commands/GetBulkDeploymentStatusCommand.ts +++ b/clients/client-greengrass/commands/GetBulkDeploymentStatusCommand.ts @@ -20,6 +20,9 @@ import { export type GetBulkDeploymentStatusCommandInput = GetBulkDeploymentStatusRequest; export type GetBulkDeploymentStatusCommandOutput = GetBulkDeploymentStatusResponse & __MetadataBearer; +/** + * Returns the status of a bulk deployment. + */ export class GetBulkDeploymentStatusCommand extends $Command< GetBulkDeploymentStatusCommandInput, GetBulkDeploymentStatusCommandOutput, @@ -34,6 +37,9 @@ export class GetBulkDeploymentStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetConnectivityInfoCommand.ts b/clients/client-greengrass/commands/GetConnectivityInfoCommand.ts index 4721df64e33e1..35355d32f400a 100644 --- a/clients/client-greengrass/commands/GetConnectivityInfoCommand.ts +++ b/clients/client-greengrass/commands/GetConnectivityInfoCommand.ts @@ -20,6 +20,9 @@ import { export type GetConnectivityInfoCommandInput = GetConnectivityInfoRequest; export type GetConnectivityInfoCommandOutput = GetConnectivityInfoResponse & __MetadataBearer; +/** + * Retrieves the connectivity information for a core. + */ export class GetConnectivityInfoCommand extends $Command< GetConnectivityInfoCommandInput, GetConnectivityInfoCommandOutput, @@ -34,6 +37,9 @@ export class GetConnectivityInfoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetConnectorDefinitionCommand.ts b/clients/client-greengrass/commands/GetConnectorDefinitionCommand.ts index 109e971fdb4a9..c27ed2f6721bb 100644 --- a/clients/client-greengrass/commands/GetConnectorDefinitionCommand.ts +++ b/clients/client-greengrass/commands/GetConnectorDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type GetConnectorDefinitionCommandInput = GetConnectorDefinitionRequest; export type GetConnectorDefinitionCommandOutput = GetConnectorDefinitionResponse & __MetadataBearer; +/** + * Retrieves information about a connector definition. + */ export class GetConnectorDefinitionCommand extends $Command< GetConnectorDefinitionCommandInput, GetConnectorDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class GetConnectorDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetConnectorDefinitionVersionCommand.ts b/clients/client-greengrass/commands/GetConnectorDefinitionVersionCommand.ts index 4693e1f7718f6..685246e3845d1 100644 --- a/clients/client-greengrass/commands/GetConnectorDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/GetConnectorDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetConnectorDefinitionVersionCommandInput = GetConnectorDefinitionVersionRequest; export type GetConnectorDefinitionVersionCommandOutput = GetConnectorDefinitionVersionResponse & __MetadataBearer; +/** + * Retrieves information about a connector definition version, including the connectors that the version contains. Connectors are prebuilt modules that interact with local infrastructure, device protocols, AWS, and other cloud services. + */ export class GetConnectorDefinitionVersionCommand extends $Command< GetConnectorDefinitionVersionCommandInput, GetConnectorDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetConnectorDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetCoreDefinitionCommand.ts b/clients/client-greengrass/commands/GetCoreDefinitionCommand.ts index 815a4a6ad1787..ea1b3a3daddf9 100644 --- a/clients/client-greengrass/commands/GetCoreDefinitionCommand.ts +++ b/clients/client-greengrass/commands/GetCoreDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type GetCoreDefinitionCommandInput = GetCoreDefinitionRequest; export type GetCoreDefinitionCommandOutput = GetCoreDefinitionResponse & __MetadataBearer; +/** + * Retrieves information about a core definition version. + */ export class GetCoreDefinitionCommand extends $Command< GetCoreDefinitionCommandInput, GetCoreDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class GetCoreDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetCoreDefinitionVersionCommand.ts b/clients/client-greengrass/commands/GetCoreDefinitionVersionCommand.ts index c11d91dc7a195..9be271316baf1 100644 --- a/clients/client-greengrass/commands/GetCoreDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/GetCoreDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetCoreDefinitionVersionCommandInput = GetCoreDefinitionVersionRequest; export type GetCoreDefinitionVersionCommandOutput = GetCoreDefinitionVersionResponse & __MetadataBearer; +/** + * Retrieves information about a core definition version. + */ export class GetCoreDefinitionVersionCommand extends $Command< GetCoreDefinitionVersionCommandInput, GetCoreDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetCoreDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetDeploymentStatusCommand.ts b/clients/client-greengrass/commands/GetDeploymentStatusCommand.ts index d3fc29ed38844..c61d57a86d4bf 100644 --- a/clients/client-greengrass/commands/GetDeploymentStatusCommand.ts +++ b/clients/client-greengrass/commands/GetDeploymentStatusCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeploymentStatusCommandInput = GetDeploymentStatusRequest; export type GetDeploymentStatusCommandOutput = GetDeploymentStatusResponse & __MetadataBearer; +/** + * Returns the status of a deployment. + */ export class GetDeploymentStatusCommand extends $Command< GetDeploymentStatusCommandInput, GetDeploymentStatusCommandOutput, @@ -34,6 +37,9 @@ export class GetDeploymentStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetDeviceDefinitionCommand.ts b/clients/client-greengrass/commands/GetDeviceDefinitionCommand.ts index fe5a1e333b7b8..2d6779005c0fe 100644 --- a/clients/client-greengrass/commands/GetDeviceDefinitionCommand.ts +++ b/clients/client-greengrass/commands/GetDeviceDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeviceDefinitionCommandInput = GetDeviceDefinitionRequest; export type GetDeviceDefinitionCommandOutput = GetDeviceDefinitionResponse & __MetadataBearer; +/** + * Retrieves information about a device definition. + */ export class GetDeviceDefinitionCommand extends $Command< GetDeviceDefinitionCommandInput, GetDeviceDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class GetDeviceDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetDeviceDefinitionVersionCommand.ts b/clients/client-greengrass/commands/GetDeviceDefinitionVersionCommand.ts index 59469194296f8..81f11d0829917 100644 --- a/clients/client-greengrass/commands/GetDeviceDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/GetDeviceDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeviceDefinitionVersionCommandInput = GetDeviceDefinitionVersionRequest; export type GetDeviceDefinitionVersionCommandOutput = GetDeviceDefinitionVersionResponse & __MetadataBearer; +/** + * Retrieves information about a device definition version. + */ export class GetDeviceDefinitionVersionCommand extends $Command< GetDeviceDefinitionVersionCommandInput, GetDeviceDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetDeviceDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetFunctionDefinitionCommand.ts b/clients/client-greengrass/commands/GetFunctionDefinitionCommand.ts index 48c0a5ca7f06c..909e762f23589 100644 --- a/clients/client-greengrass/commands/GetFunctionDefinitionCommand.ts +++ b/clients/client-greengrass/commands/GetFunctionDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type GetFunctionDefinitionCommandInput = GetFunctionDefinitionRequest; export type GetFunctionDefinitionCommandOutput = GetFunctionDefinitionResponse & __MetadataBearer; +/** + * Retrieves information about a Lambda function definition, including its creation time and latest version. + */ export class GetFunctionDefinitionCommand extends $Command< GetFunctionDefinitionCommandInput, GetFunctionDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class GetFunctionDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetFunctionDefinitionVersionCommand.ts b/clients/client-greengrass/commands/GetFunctionDefinitionVersionCommand.ts index 3967820f132d3..2e2f938ab56c5 100644 --- a/clients/client-greengrass/commands/GetFunctionDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/GetFunctionDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetFunctionDefinitionVersionCommandInput = GetFunctionDefinitionVersionRequest; export type GetFunctionDefinitionVersionCommandOutput = GetFunctionDefinitionVersionResponse & __MetadataBearer; +/** + * Retrieves information about a Lambda function definition version, including which Lambda functions are included in the version and their configurations. + */ export class GetFunctionDefinitionVersionCommand extends $Command< GetFunctionDefinitionVersionCommandInput, GetFunctionDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetFunctionDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetGroupCertificateAuthorityCommand.ts b/clients/client-greengrass/commands/GetGroupCertificateAuthorityCommand.ts index e8a9a8bb28f09..e938e8f94fc7d 100644 --- a/clients/client-greengrass/commands/GetGroupCertificateAuthorityCommand.ts +++ b/clients/client-greengrass/commands/GetGroupCertificateAuthorityCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupCertificateAuthorityCommandInput = GetGroupCertificateAuthorityRequest; export type GetGroupCertificateAuthorityCommandOutput = GetGroupCertificateAuthorityResponse & __MetadataBearer; +/** + * Retreives the CA associated with a group. Returns the public key of the CA. + */ export class GetGroupCertificateAuthorityCommand extends $Command< GetGroupCertificateAuthorityCommandInput, GetGroupCertificateAuthorityCommandOutput, @@ -34,6 +37,9 @@ export class GetGroupCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetGroupCertificateConfigurationCommand.ts b/clients/client-greengrass/commands/GetGroupCertificateConfigurationCommand.ts index 25b0f5f9ce95b..dafc5f4b420cf 100644 --- a/clients/client-greengrass/commands/GetGroupCertificateConfigurationCommand.ts +++ b/clients/client-greengrass/commands/GetGroupCertificateConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupCertificateConfigurationCommandInput = GetGroupCertificateConfigurationRequest; export type GetGroupCertificateConfigurationCommandOutput = GetGroupCertificateConfigurationResponse & __MetadataBearer; +/** + * Retrieves the current configuration for the CA used by the group. + */ export class GetGroupCertificateConfigurationCommand extends $Command< GetGroupCertificateConfigurationCommandInput, GetGroupCertificateConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetGroupCertificateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetGroupCommand.ts b/clients/client-greengrass/commands/GetGroupCommand.ts index cf94d4ae1e307..5d0f75ee3f2e4 100644 --- a/clients/client-greengrass/commands/GetGroupCommand.ts +++ b/clients/client-greengrass/commands/GetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupCommandInput = GetGroupRequest; export type GetGroupCommandOutput = GetGroupResponse & __MetadataBearer; +/** + * Retrieves information about a group. + */ export class GetGroupCommand extends $Command< GetGroupCommandInput, GetGroupCommandOutput, @@ -34,6 +37,9 @@ export class GetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetGroupVersionCommand.ts b/clients/client-greengrass/commands/GetGroupVersionCommand.ts index 6f99ac572f8c6..24b6b392f7e71 100644 --- a/clients/client-greengrass/commands/GetGroupVersionCommand.ts +++ b/clients/client-greengrass/commands/GetGroupVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupVersionCommandInput = GetGroupVersionRequest; export type GetGroupVersionCommandOutput = GetGroupVersionResponse & __MetadataBearer; +/** + * Retrieves information about a group version. + */ export class GetGroupVersionCommand extends $Command< GetGroupVersionCommandInput, GetGroupVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetGroupVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetLoggerDefinitionCommand.ts b/clients/client-greengrass/commands/GetLoggerDefinitionCommand.ts index fc37c401828eb..287aaa78e2d45 100644 --- a/clients/client-greengrass/commands/GetLoggerDefinitionCommand.ts +++ b/clients/client-greengrass/commands/GetLoggerDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type GetLoggerDefinitionCommandInput = GetLoggerDefinitionRequest; export type GetLoggerDefinitionCommandOutput = GetLoggerDefinitionResponse & __MetadataBearer; +/** + * Retrieves information about a logger definition. + */ export class GetLoggerDefinitionCommand extends $Command< GetLoggerDefinitionCommandInput, GetLoggerDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class GetLoggerDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetLoggerDefinitionVersionCommand.ts b/clients/client-greengrass/commands/GetLoggerDefinitionVersionCommand.ts index 6f96842bc347f..c1cd5d17c3fc5 100644 --- a/clients/client-greengrass/commands/GetLoggerDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/GetLoggerDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetLoggerDefinitionVersionCommandInput = GetLoggerDefinitionVersionRequest; export type GetLoggerDefinitionVersionCommandOutput = GetLoggerDefinitionVersionResponse & __MetadataBearer; +/** + * Retrieves information about a logger definition version. + */ export class GetLoggerDefinitionVersionCommand extends $Command< GetLoggerDefinitionVersionCommandInput, GetLoggerDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetLoggerDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetResourceDefinitionCommand.ts b/clients/client-greengrass/commands/GetResourceDefinitionCommand.ts index e1a466466f763..57e1a83e432a6 100644 --- a/clients/client-greengrass/commands/GetResourceDefinitionCommand.ts +++ b/clients/client-greengrass/commands/GetResourceDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourceDefinitionCommandInput = GetResourceDefinitionRequest; export type GetResourceDefinitionCommandOutput = GetResourceDefinitionResponse & __MetadataBearer; +/** + * Retrieves information about a resource definition, including its creation time and latest version. + */ export class GetResourceDefinitionCommand extends $Command< GetResourceDefinitionCommandInput, GetResourceDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class GetResourceDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetResourceDefinitionVersionCommand.ts b/clients/client-greengrass/commands/GetResourceDefinitionVersionCommand.ts index 7a0db1f92c801..16dac9dfbde9c 100644 --- a/clients/client-greengrass/commands/GetResourceDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/GetResourceDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourceDefinitionVersionCommandInput = GetResourceDefinitionVersionRequest; export type GetResourceDefinitionVersionCommandOutput = GetResourceDefinitionVersionResponse & __MetadataBearer; +/** + * Retrieves information about a resource definition version, including which resources are included in the version. + */ export class GetResourceDefinitionVersionCommand extends $Command< GetResourceDefinitionVersionCommandInput, GetResourceDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetResourceDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetServiceRoleForAccountCommand.ts b/clients/client-greengrass/commands/GetServiceRoleForAccountCommand.ts index 3f72a6dfd0812..6646e7970c3e7 100644 --- a/clients/client-greengrass/commands/GetServiceRoleForAccountCommand.ts +++ b/clients/client-greengrass/commands/GetServiceRoleForAccountCommand.ts @@ -20,6 +20,9 @@ import { export type GetServiceRoleForAccountCommandInput = GetServiceRoleForAccountRequest; export type GetServiceRoleForAccountCommandOutput = GetServiceRoleForAccountResponse & __MetadataBearer; +/** + * Retrieves the service role that is attached to your account. + */ export class GetServiceRoleForAccountCommand extends $Command< GetServiceRoleForAccountCommandInput, GetServiceRoleForAccountCommandOutput, @@ -34,6 +37,9 @@ export class GetServiceRoleForAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetSubscriptionDefinitionCommand.ts b/clients/client-greengrass/commands/GetSubscriptionDefinitionCommand.ts index e2313a1ff3178..627ffd16d1e3e 100644 --- a/clients/client-greengrass/commands/GetSubscriptionDefinitionCommand.ts +++ b/clients/client-greengrass/commands/GetSubscriptionDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type GetSubscriptionDefinitionCommandInput = GetSubscriptionDefinitionRequest; export type GetSubscriptionDefinitionCommandOutput = GetSubscriptionDefinitionResponse & __MetadataBearer; +/** + * Retrieves information about a subscription definition. + */ export class GetSubscriptionDefinitionCommand extends $Command< GetSubscriptionDefinitionCommandInput, GetSubscriptionDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class GetSubscriptionDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetSubscriptionDefinitionVersionCommand.ts b/clients/client-greengrass/commands/GetSubscriptionDefinitionVersionCommand.ts index 47a4cd6f5bde7..e921c453d6561 100644 --- a/clients/client-greengrass/commands/GetSubscriptionDefinitionVersionCommand.ts +++ b/clients/client-greengrass/commands/GetSubscriptionDefinitionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetSubscriptionDefinitionVersionCommandInput = GetSubscriptionDefinitionVersionRequest; export type GetSubscriptionDefinitionVersionCommandOutput = GetSubscriptionDefinitionVersionResponse & __MetadataBearer; +/** + * Retrieves information about a subscription definition version. + */ export class GetSubscriptionDefinitionVersionCommand extends $Command< GetSubscriptionDefinitionVersionCommandInput, GetSubscriptionDefinitionVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetSubscriptionDefinitionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/GetThingRuntimeConfigurationCommand.ts b/clients/client-greengrass/commands/GetThingRuntimeConfigurationCommand.ts index 6b8bd92047b2d..930bb86fd5ccb 100644 --- a/clients/client-greengrass/commands/GetThingRuntimeConfigurationCommand.ts +++ b/clients/client-greengrass/commands/GetThingRuntimeConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetThingRuntimeConfigurationCommandInput = GetThingRuntimeConfigurationRequest; export type GetThingRuntimeConfigurationCommandOutput = GetThingRuntimeConfigurationResponse & __MetadataBearer; +/** + * Get the runtime configuration of a thing. + */ export class GetThingRuntimeConfigurationCommand extends $Command< GetThingRuntimeConfigurationCommandInput, GetThingRuntimeConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetThingRuntimeConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListBulkDeploymentDetailedReportsCommand.ts b/clients/client-greengrass/commands/ListBulkDeploymentDetailedReportsCommand.ts index 38db69e57ea7a..0772f0bb53395 100644 --- a/clients/client-greengrass/commands/ListBulkDeploymentDetailedReportsCommand.ts +++ b/clients/client-greengrass/commands/ListBulkDeploymentDetailedReportsCommand.ts @@ -24,6 +24,9 @@ export type ListBulkDeploymentDetailedReportsCommandInput = ListBulkDeploymentDe export type ListBulkDeploymentDetailedReportsCommandOutput = ListBulkDeploymentDetailedReportsResponse & __MetadataBearer; +/** + * Gets a paginated list of the deployments that have been started in a bulk deployment operation, and their current deployment status. + */ export class ListBulkDeploymentDetailedReportsCommand extends $Command< ListBulkDeploymentDetailedReportsCommandInput, ListBulkDeploymentDetailedReportsCommandOutput, @@ -38,6 +41,9 @@ export class ListBulkDeploymentDetailedReportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListBulkDeploymentsCommand.ts b/clients/client-greengrass/commands/ListBulkDeploymentsCommand.ts index 455a5a3922773..e969c4de12beb 100644 --- a/clients/client-greengrass/commands/ListBulkDeploymentsCommand.ts +++ b/clients/client-greengrass/commands/ListBulkDeploymentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListBulkDeploymentsCommandInput = ListBulkDeploymentsRequest; export type ListBulkDeploymentsCommandOutput = ListBulkDeploymentsResponse & __MetadataBearer; +/** + * Returns a list of bulk deployments. + */ export class ListBulkDeploymentsCommand extends $Command< ListBulkDeploymentsCommandInput, ListBulkDeploymentsCommandOutput, @@ -34,6 +37,9 @@ export class ListBulkDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListConnectorDefinitionVersionsCommand.ts b/clients/client-greengrass/commands/ListConnectorDefinitionVersionsCommand.ts index 80de02db76d50..fcf6426614283 100644 --- a/clients/client-greengrass/commands/ListConnectorDefinitionVersionsCommand.ts +++ b/clients/client-greengrass/commands/ListConnectorDefinitionVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListConnectorDefinitionVersionsCommandInput = ListConnectorDefinitionVersionsRequest; export type ListConnectorDefinitionVersionsCommandOutput = ListConnectorDefinitionVersionsResponse & __MetadataBearer; +/** + * Lists the versions of a connector definition, which are containers for connectors. Connectors run on the Greengrass core and contain built-in integration with local infrastructure, device protocols, AWS, and other cloud services. + */ export class ListConnectorDefinitionVersionsCommand extends $Command< ListConnectorDefinitionVersionsCommandInput, ListConnectorDefinitionVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListConnectorDefinitionVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListConnectorDefinitionsCommand.ts b/clients/client-greengrass/commands/ListConnectorDefinitionsCommand.ts index 3c3fa2b01a33c..2557d7b6cd630 100644 --- a/clients/client-greengrass/commands/ListConnectorDefinitionsCommand.ts +++ b/clients/client-greengrass/commands/ListConnectorDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListConnectorDefinitionsCommandInput = ListConnectorDefinitionsRequest; export type ListConnectorDefinitionsCommandOutput = ListConnectorDefinitionsResponse & __MetadataBearer; +/** + * Retrieves a list of connector definitions. + */ export class ListConnectorDefinitionsCommand extends $Command< ListConnectorDefinitionsCommandInput, ListConnectorDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListConnectorDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListCoreDefinitionVersionsCommand.ts b/clients/client-greengrass/commands/ListCoreDefinitionVersionsCommand.ts index 5bcb02f6ee1dd..f09ca38a07eb8 100644 --- a/clients/client-greengrass/commands/ListCoreDefinitionVersionsCommand.ts +++ b/clients/client-greengrass/commands/ListCoreDefinitionVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListCoreDefinitionVersionsCommandInput = ListCoreDefinitionVersionsRequest; export type ListCoreDefinitionVersionsCommandOutput = ListCoreDefinitionVersionsResponse & __MetadataBearer; +/** + * Lists the versions of a core definition. + */ export class ListCoreDefinitionVersionsCommand extends $Command< ListCoreDefinitionVersionsCommandInput, ListCoreDefinitionVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListCoreDefinitionVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListCoreDefinitionsCommand.ts b/clients/client-greengrass/commands/ListCoreDefinitionsCommand.ts index f1cb26447df45..5565ddfc1c71c 100644 --- a/clients/client-greengrass/commands/ListCoreDefinitionsCommand.ts +++ b/clients/client-greengrass/commands/ListCoreDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListCoreDefinitionsCommandInput = ListCoreDefinitionsRequest; export type ListCoreDefinitionsCommandOutput = ListCoreDefinitionsResponse & __MetadataBearer; +/** + * Retrieves a list of core definitions. + */ export class ListCoreDefinitionsCommand extends $Command< ListCoreDefinitionsCommandInput, ListCoreDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListCoreDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListDeploymentsCommand.ts b/clients/client-greengrass/commands/ListDeploymentsCommand.ts index 910303cf3c083..8161826428502 100644 --- a/clients/client-greengrass/commands/ListDeploymentsCommand.ts +++ b/clients/client-greengrass/commands/ListDeploymentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDeploymentsCommandInput = ListDeploymentsRequest; export type ListDeploymentsCommandOutput = ListDeploymentsResponse & __MetadataBearer; +/** + * Returns a history of deployments for the group. + */ export class ListDeploymentsCommand extends $Command< ListDeploymentsCommandInput, ListDeploymentsCommandOutput, @@ -34,6 +37,9 @@ export class ListDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListDeviceDefinitionVersionsCommand.ts b/clients/client-greengrass/commands/ListDeviceDefinitionVersionsCommand.ts index 204c6b465f9d0..fcce4d7367049 100644 --- a/clients/client-greengrass/commands/ListDeviceDefinitionVersionsCommand.ts +++ b/clients/client-greengrass/commands/ListDeviceDefinitionVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDeviceDefinitionVersionsCommandInput = ListDeviceDefinitionVersionsRequest; export type ListDeviceDefinitionVersionsCommandOutput = ListDeviceDefinitionVersionsResponse & __MetadataBearer; +/** + * Lists the versions of a device definition. + */ export class ListDeviceDefinitionVersionsCommand extends $Command< ListDeviceDefinitionVersionsCommandInput, ListDeviceDefinitionVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListDeviceDefinitionVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListDeviceDefinitionsCommand.ts b/clients/client-greengrass/commands/ListDeviceDefinitionsCommand.ts index 09c4cb6588ed8..17f3f30423aec 100644 --- a/clients/client-greengrass/commands/ListDeviceDefinitionsCommand.ts +++ b/clients/client-greengrass/commands/ListDeviceDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDeviceDefinitionsCommandInput = ListDeviceDefinitionsRequest; export type ListDeviceDefinitionsCommandOutput = ListDeviceDefinitionsResponse & __MetadataBearer; +/** + * Retrieves a list of device definitions. + */ export class ListDeviceDefinitionsCommand extends $Command< ListDeviceDefinitionsCommandInput, ListDeviceDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListDeviceDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListFunctionDefinitionVersionsCommand.ts b/clients/client-greengrass/commands/ListFunctionDefinitionVersionsCommand.ts index 20702fc95106f..6dfe1636ca39e 100644 --- a/clients/client-greengrass/commands/ListFunctionDefinitionVersionsCommand.ts +++ b/clients/client-greengrass/commands/ListFunctionDefinitionVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFunctionDefinitionVersionsCommandInput = ListFunctionDefinitionVersionsRequest; export type ListFunctionDefinitionVersionsCommandOutput = ListFunctionDefinitionVersionsResponse & __MetadataBearer; +/** + * Lists the versions of a Lambda function definition. + */ export class ListFunctionDefinitionVersionsCommand extends $Command< ListFunctionDefinitionVersionsCommandInput, ListFunctionDefinitionVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListFunctionDefinitionVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListFunctionDefinitionsCommand.ts b/clients/client-greengrass/commands/ListFunctionDefinitionsCommand.ts index 1707e22e1f4ac..09937d2e4c4f9 100644 --- a/clients/client-greengrass/commands/ListFunctionDefinitionsCommand.ts +++ b/clients/client-greengrass/commands/ListFunctionDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFunctionDefinitionsCommandInput = ListFunctionDefinitionsRequest; export type ListFunctionDefinitionsCommandOutput = ListFunctionDefinitionsResponse & __MetadataBearer; +/** + * Retrieves a list of Lambda function definitions. + */ export class ListFunctionDefinitionsCommand extends $Command< ListFunctionDefinitionsCommandInput, ListFunctionDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListFunctionDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListGroupCertificateAuthoritiesCommand.ts b/clients/client-greengrass/commands/ListGroupCertificateAuthoritiesCommand.ts index 9437fe21e165e..967cb0e58331a 100644 --- a/clients/client-greengrass/commands/ListGroupCertificateAuthoritiesCommand.ts +++ b/clients/client-greengrass/commands/ListGroupCertificateAuthoritiesCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroupCertificateAuthoritiesCommandInput = ListGroupCertificateAuthoritiesRequest; export type ListGroupCertificateAuthoritiesCommandOutput = ListGroupCertificateAuthoritiesResponse & __MetadataBearer; +/** + * Retrieves the current CAs for a group. + */ export class ListGroupCertificateAuthoritiesCommand extends $Command< ListGroupCertificateAuthoritiesCommandInput, ListGroupCertificateAuthoritiesCommandOutput, @@ -34,6 +37,9 @@ export class ListGroupCertificateAuthoritiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListGroupVersionsCommand.ts b/clients/client-greengrass/commands/ListGroupVersionsCommand.ts index 543e88c4acf0d..dc2f8b45f13bf 100644 --- a/clients/client-greengrass/commands/ListGroupVersionsCommand.ts +++ b/clients/client-greengrass/commands/ListGroupVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroupVersionsCommandInput = ListGroupVersionsRequest; export type ListGroupVersionsCommandOutput = ListGroupVersionsResponse & __MetadataBearer; +/** + * Lists the versions of a group. + */ export class ListGroupVersionsCommand extends $Command< ListGroupVersionsCommandInput, ListGroupVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListGroupVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListGroupsCommand.ts b/clients/client-greengrass/commands/ListGroupsCommand.ts index 2ef9f1aebe98e..674a28142e4b3 100644 --- a/clients/client-greengrass/commands/ListGroupsCommand.ts +++ b/clients/client-greengrass/commands/ListGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroupsCommandInput = ListGroupsRequest; export type ListGroupsCommandOutput = ListGroupsResponse & __MetadataBearer; +/** + * Retrieves a list of groups. + */ export class ListGroupsCommand extends $Command< ListGroupsCommandInput, ListGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListLoggerDefinitionVersionsCommand.ts b/clients/client-greengrass/commands/ListLoggerDefinitionVersionsCommand.ts index 81573e08ab81e..9e921a199c883 100644 --- a/clients/client-greengrass/commands/ListLoggerDefinitionVersionsCommand.ts +++ b/clients/client-greengrass/commands/ListLoggerDefinitionVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListLoggerDefinitionVersionsCommandInput = ListLoggerDefinitionVersionsRequest; export type ListLoggerDefinitionVersionsCommandOutput = ListLoggerDefinitionVersionsResponse & __MetadataBearer; +/** + * Lists the versions of a logger definition. + */ export class ListLoggerDefinitionVersionsCommand extends $Command< ListLoggerDefinitionVersionsCommandInput, ListLoggerDefinitionVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListLoggerDefinitionVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListLoggerDefinitionsCommand.ts b/clients/client-greengrass/commands/ListLoggerDefinitionsCommand.ts index 2b7be509ad718..104fa7ebd63f6 100644 --- a/clients/client-greengrass/commands/ListLoggerDefinitionsCommand.ts +++ b/clients/client-greengrass/commands/ListLoggerDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListLoggerDefinitionsCommandInput = ListLoggerDefinitionsRequest; export type ListLoggerDefinitionsCommandOutput = ListLoggerDefinitionsResponse & __MetadataBearer; +/** + * Retrieves a list of logger definitions. + */ export class ListLoggerDefinitionsCommand extends $Command< ListLoggerDefinitionsCommandInput, ListLoggerDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListLoggerDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListResourceDefinitionVersionsCommand.ts b/clients/client-greengrass/commands/ListResourceDefinitionVersionsCommand.ts index 1cbf5841827e5..5b1aa4a34de2e 100644 --- a/clients/client-greengrass/commands/ListResourceDefinitionVersionsCommand.ts +++ b/clients/client-greengrass/commands/ListResourceDefinitionVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourceDefinitionVersionsCommandInput = ListResourceDefinitionVersionsRequest; export type ListResourceDefinitionVersionsCommandOutput = ListResourceDefinitionVersionsResponse & __MetadataBearer; +/** + * Lists the versions of a resource definition. + */ export class ListResourceDefinitionVersionsCommand extends $Command< ListResourceDefinitionVersionsCommandInput, ListResourceDefinitionVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListResourceDefinitionVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListResourceDefinitionsCommand.ts b/clients/client-greengrass/commands/ListResourceDefinitionsCommand.ts index 97e17cc425c3e..d01a6595ba539 100644 --- a/clients/client-greengrass/commands/ListResourceDefinitionsCommand.ts +++ b/clients/client-greengrass/commands/ListResourceDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourceDefinitionsCommandInput = ListResourceDefinitionsRequest; export type ListResourceDefinitionsCommandOutput = ListResourceDefinitionsResponse & __MetadataBearer; +/** + * Retrieves a list of resource definitions. + */ export class ListResourceDefinitionsCommand extends $Command< ListResourceDefinitionsCommandInput, ListResourceDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListResourceDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListSubscriptionDefinitionVersionsCommand.ts b/clients/client-greengrass/commands/ListSubscriptionDefinitionVersionsCommand.ts index 91987bee18c1c..f433f97541d72 100644 --- a/clients/client-greengrass/commands/ListSubscriptionDefinitionVersionsCommand.ts +++ b/clients/client-greengrass/commands/ListSubscriptionDefinitionVersionsCommand.ts @@ -24,6 +24,9 @@ export type ListSubscriptionDefinitionVersionsCommandInput = ListSubscriptionDef export type ListSubscriptionDefinitionVersionsCommandOutput = ListSubscriptionDefinitionVersionsResponse & __MetadataBearer; +/** + * Lists the versions of a subscription definition. + */ export class ListSubscriptionDefinitionVersionsCommand extends $Command< ListSubscriptionDefinitionVersionsCommandInput, ListSubscriptionDefinitionVersionsCommandOutput, @@ -38,6 +41,9 @@ export class ListSubscriptionDefinitionVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListSubscriptionDefinitionsCommand.ts b/clients/client-greengrass/commands/ListSubscriptionDefinitionsCommand.ts index 482a94806806d..f19c24fa2c792 100644 --- a/clients/client-greengrass/commands/ListSubscriptionDefinitionsCommand.ts +++ b/clients/client-greengrass/commands/ListSubscriptionDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSubscriptionDefinitionsCommandInput = ListSubscriptionDefinitionsRequest; export type ListSubscriptionDefinitionsCommandOutput = ListSubscriptionDefinitionsResponse & __MetadataBearer; +/** + * Retrieves a list of subscription definitions. + */ export class ListSubscriptionDefinitionsCommand extends $Command< ListSubscriptionDefinitionsCommandInput, ListSubscriptionDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListSubscriptionDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ListTagsForResourceCommand.ts b/clients/client-greengrass/commands/ListTagsForResourceCommand.ts index 470159c1efe1a..e016214154723 100644 --- a/clients/client-greengrass/commands/ListTagsForResourceCommand.ts +++ b/clients/client-greengrass/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + * Retrieves a list of resource tags for a resource arn. + */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/ResetDeploymentsCommand.ts b/clients/client-greengrass/commands/ResetDeploymentsCommand.ts index ce1c74f4975f3..024fd0aa31d94 100644 --- a/clients/client-greengrass/commands/ResetDeploymentsCommand.ts +++ b/clients/client-greengrass/commands/ResetDeploymentsCommand.ts @@ -20,6 +20,9 @@ import { export type ResetDeploymentsCommandInput = ResetDeploymentsRequest; export type ResetDeploymentsCommandOutput = ResetDeploymentsResponse & __MetadataBearer; +/** + * Resets a group's deployments. + */ export class ResetDeploymentsCommand extends $Command< ResetDeploymentsCommandInput, ResetDeploymentsCommandOutput, @@ -34,6 +37,9 @@ export class ResetDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/StartBulkDeploymentCommand.ts b/clients/client-greengrass/commands/StartBulkDeploymentCommand.ts index b7ab88b68fc94..4e5a2fbc44e1e 100644 --- a/clients/client-greengrass/commands/StartBulkDeploymentCommand.ts +++ b/clients/client-greengrass/commands/StartBulkDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type StartBulkDeploymentCommandInput = StartBulkDeploymentRequest; export type StartBulkDeploymentCommandOutput = StartBulkDeploymentResponse & __MetadataBearer; +/** + * Deploys multiple groups in one operation. This action starts the bulk deployment of a specified set of group versions. Each group version deployment will be triggered with an adaptive rate that has a fixed upper limit. We recommend that you include an ''X-Amzn-Client-Token'' token in every ''StartBulkDeployment'' request. These requests are idempotent with respect to the token and the request parameters. + */ export class StartBulkDeploymentCommand extends $Command< StartBulkDeploymentCommandInput, StartBulkDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class StartBulkDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/StopBulkDeploymentCommand.ts b/clients/client-greengrass/commands/StopBulkDeploymentCommand.ts index d52aa1ab6e0ef..e6b4c81aea69d 100644 --- a/clients/client-greengrass/commands/StopBulkDeploymentCommand.ts +++ b/clients/client-greengrass/commands/StopBulkDeploymentCommand.ts @@ -20,6 +20,9 @@ import { export type StopBulkDeploymentCommandInput = StopBulkDeploymentRequest; export type StopBulkDeploymentCommandOutput = StopBulkDeploymentResponse & __MetadataBearer; +/** + * Stops the execution of a bulk deployment. This action returns a status of ''Stopping'' until the deployment is stopped. You cannot start a new bulk deployment while a previous deployment is in the ''Stopping'' state. This action doesn't rollback completed deployments or cancel pending deployments. + */ export class StopBulkDeploymentCommand extends $Command< StopBulkDeploymentCommandInput, StopBulkDeploymentCommandOutput, @@ -34,6 +37,9 @@ export class StopBulkDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/TagResourceCommand.ts b/clients/client-greengrass/commands/TagResourceCommand.ts index 813216deaa513..11d598d9d8104 100644 --- a/clients/client-greengrass/commands/TagResourceCommand.ts +++ b/clients/client-greengrass/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + * Adds tags to a Greengrass resource. Valid resources are 'Group', 'ConnectorDefinition', 'CoreDefinition', 'DeviceDefinition', 'FunctionDefinition', 'LoggerDefinition', 'SubscriptionDefinition', 'ResourceDefinition', and 'BulkDeployment'. + */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UntagResourceCommand.ts b/clients/client-greengrass/commands/UntagResourceCommand.ts index bd3944181b52a..1a073d4aef3f1 100644 --- a/clients/client-greengrass/commands/UntagResourceCommand.ts +++ b/clients/client-greengrass/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + * Remove resource tags from a Greengrass Resource. + */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateConnectivityInfoCommand.ts b/clients/client-greengrass/commands/UpdateConnectivityInfoCommand.ts index 8c77de89527a1..0ce43118b9982 100644 --- a/clients/client-greengrass/commands/UpdateConnectivityInfoCommand.ts +++ b/clients/client-greengrass/commands/UpdateConnectivityInfoCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConnectivityInfoCommandInput = UpdateConnectivityInfoRequest; export type UpdateConnectivityInfoCommandOutput = UpdateConnectivityInfoResponse & __MetadataBearer; +/** + * Updates the connectivity information for the core. Any devices that belong to the group which has this core will receive this information in order to find the location of the core and connect to it. + */ export class UpdateConnectivityInfoCommand extends $Command< UpdateConnectivityInfoCommandInput, UpdateConnectivityInfoCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConnectivityInfoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateConnectorDefinitionCommand.ts b/clients/client-greengrass/commands/UpdateConnectorDefinitionCommand.ts index d72e8576311e8..4ab767918b02b 100644 --- a/clients/client-greengrass/commands/UpdateConnectorDefinitionCommand.ts +++ b/clients/client-greengrass/commands/UpdateConnectorDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConnectorDefinitionCommandInput = UpdateConnectorDefinitionRequest; export type UpdateConnectorDefinitionCommandOutput = UpdateConnectorDefinitionResponse & __MetadataBearer; +/** + * Updates a connector definition. + */ export class UpdateConnectorDefinitionCommand extends $Command< UpdateConnectorDefinitionCommandInput, UpdateConnectorDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConnectorDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateCoreDefinitionCommand.ts b/clients/client-greengrass/commands/UpdateCoreDefinitionCommand.ts index 7d4881c7abf68..e8852e2924ac2 100644 --- a/clients/client-greengrass/commands/UpdateCoreDefinitionCommand.ts +++ b/clients/client-greengrass/commands/UpdateCoreDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateCoreDefinitionCommandInput = UpdateCoreDefinitionRequest; export type UpdateCoreDefinitionCommandOutput = UpdateCoreDefinitionResponse & __MetadataBearer; +/** + * Updates a core definition. + */ export class UpdateCoreDefinitionCommand extends $Command< UpdateCoreDefinitionCommandInput, UpdateCoreDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateCoreDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateDeviceDefinitionCommand.ts b/clients/client-greengrass/commands/UpdateDeviceDefinitionCommand.ts index a881078ae5f82..3ce6f8d26470e 100644 --- a/clients/client-greengrass/commands/UpdateDeviceDefinitionCommand.ts +++ b/clients/client-greengrass/commands/UpdateDeviceDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDeviceDefinitionCommandInput = UpdateDeviceDefinitionRequest; export type UpdateDeviceDefinitionCommandOutput = UpdateDeviceDefinitionResponse & __MetadataBearer; +/** + * Updates a device definition. + */ export class UpdateDeviceDefinitionCommand extends $Command< UpdateDeviceDefinitionCommandInput, UpdateDeviceDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDeviceDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateFunctionDefinitionCommand.ts b/clients/client-greengrass/commands/UpdateFunctionDefinitionCommand.ts index 2c14ba042a3c5..9e93805093a98 100644 --- a/clients/client-greengrass/commands/UpdateFunctionDefinitionCommand.ts +++ b/clients/client-greengrass/commands/UpdateFunctionDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFunctionDefinitionCommandInput = UpdateFunctionDefinitionRequest; export type UpdateFunctionDefinitionCommandOutput = UpdateFunctionDefinitionResponse & __MetadataBearer; +/** + * Updates a Lambda function definition. + */ export class UpdateFunctionDefinitionCommand extends $Command< UpdateFunctionDefinitionCommandInput, UpdateFunctionDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFunctionDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateGroupCertificateConfigurationCommand.ts b/clients/client-greengrass/commands/UpdateGroupCertificateConfigurationCommand.ts index 6087ab63eabc9..a1da892f7b565 100644 --- a/clients/client-greengrass/commands/UpdateGroupCertificateConfigurationCommand.ts +++ b/clients/client-greengrass/commands/UpdateGroupCertificateConfigurationCommand.ts @@ -24,6 +24,9 @@ export type UpdateGroupCertificateConfigurationCommandInput = UpdateGroupCertifi export type UpdateGroupCertificateConfigurationCommandOutput = UpdateGroupCertificateConfigurationResponse & __MetadataBearer; +/** + * Updates the Certificate expiry time for a group. + */ export class UpdateGroupCertificateConfigurationCommand extends $Command< UpdateGroupCertificateConfigurationCommandInput, UpdateGroupCertificateConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class UpdateGroupCertificateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateGroupCommand.ts b/clients/client-greengrass/commands/UpdateGroupCommand.ts index 8a4e77e1be941..4c0d3d2df232e 100644 --- a/clients/client-greengrass/commands/UpdateGroupCommand.ts +++ b/clients/client-greengrass/commands/UpdateGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGroupCommandInput = UpdateGroupRequest; export type UpdateGroupCommandOutput = UpdateGroupResponse & __MetadataBearer; +/** + * Updates a group. + */ export class UpdateGroupCommand extends $Command< UpdateGroupCommandInput, UpdateGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateLoggerDefinitionCommand.ts b/clients/client-greengrass/commands/UpdateLoggerDefinitionCommand.ts index 7017ba4048230..d822b0f6d4bdf 100644 --- a/clients/client-greengrass/commands/UpdateLoggerDefinitionCommand.ts +++ b/clients/client-greengrass/commands/UpdateLoggerDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateLoggerDefinitionCommandInput = UpdateLoggerDefinitionRequest; export type UpdateLoggerDefinitionCommandOutput = UpdateLoggerDefinitionResponse & __MetadataBearer; +/** + * Updates a logger definition. + */ export class UpdateLoggerDefinitionCommand extends $Command< UpdateLoggerDefinitionCommandInput, UpdateLoggerDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateLoggerDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateResourceDefinitionCommand.ts b/clients/client-greengrass/commands/UpdateResourceDefinitionCommand.ts index d0fd947f259cb..edd0b113308e3 100644 --- a/clients/client-greengrass/commands/UpdateResourceDefinitionCommand.ts +++ b/clients/client-greengrass/commands/UpdateResourceDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateResourceDefinitionCommandInput = UpdateResourceDefinitionRequest; export type UpdateResourceDefinitionCommandOutput = UpdateResourceDefinitionResponse & __MetadataBearer; +/** + * Updates a resource definition. + */ export class UpdateResourceDefinitionCommand extends $Command< UpdateResourceDefinitionCommandInput, UpdateResourceDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateResourceDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateSubscriptionDefinitionCommand.ts b/clients/client-greengrass/commands/UpdateSubscriptionDefinitionCommand.ts index bd5d250de6f53..80cddee60a99b 100644 --- a/clients/client-greengrass/commands/UpdateSubscriptionDefinitionCommand.ts +++ b/clients/client-greengrass/commands/UpdateSubscriptionDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSubscriptionDefinitionCommandInput = UpdateSubscriptionDefinitionRequest; export type UpdateSubscriptionDefinitionCommandOutput = UpdateSubscriptionDefinitionResponse & __MetadataBearer; +/** + * Updates a subscription definition. + */ export class UpdateSubscriptionDefinitionCommand extends $Command< UpdateSubscriptionDefinitionCommandInput, UpdateSubscriptionDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSubscriptionDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/commands/UpdateThingRuntimeConfigurationCommand.ts b/clients/client-greengrass/commands/UpdateThingRuntimeConfigurationCommand.ts index 323de7fc83926..ed91a6a04379e 100644 --- a/clients/client-greengrass/commands/UpdateThingRuntimeConfigurationCommand.ts +++ b/clients/client-greengrass/commands/UpdateThingRuntimeConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateThingRuntimeConfigurationCommandInput = UpdateThingRuntimeConfigurationRequest; export type UpdateThingRuntimeConfigurationCommandOutput = UpdateThingRuntimeConfigurationResponse & __MetadataBearer; +/** + * Updates the runtime configuration of a thing. + */ export class UpdateThingRuntimeConfigurationCommand extends $Command< UpdateThingRuntimeConfigurationCommandInput, UpdateThingRuntimeConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateThingRuntimeConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GreengrassClientResolvedConfig, diff --git a/clients/client-greengrass/package.json b/clients/client-greengrass/package.json index bc581669dbab4..601e2b348d71f 100644 --- a/clients/client-greengrass/package.json +++ b/clients/client-greengrass/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Greengrass Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-greengrass/runtimeConfig.browser.ts b/clients/client-greengrass/runtimeConfig.browser.ts index 9548a3da889cb..3ca845ae999e4 100644 --- a/clients/client-greengrass/runtimeConfig.browser.ts +++ b/clients/client-greengrass/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./GreengrassClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-greengrass/runtimeConfig.native.ts b/clients/client-greengrass/runtimeConfig.native.ts index 702dca231123a..37cafa18bc80c 100644 --- a/clients/client-greengrass/runtimeConfig.native.ts +++ b/clients/client-greengrass/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./GreengrassClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-greengrass/runtimeConfig.shared.ts b/clients/client-greengrass/runtimeConfig.shared.ts index a502b2b9e6555..1ff85b0d8b4d0 100644 --- a/clients/client-greengrass/runtimeConfig.shared.ts +++ b/clients/client-greengrass/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-06-07", disableHostPrefix: false, diff --git a/clients/client-greengrass/runtimeConfig.ts b/clients/client-greengrass/runtimeConfig.ts index accc6a3ae04c1..3dee4468021ef 100644 --- a/clients/client-greengrass/runtimeConfig.ts +++ b/clients/client-greengrass/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./GreengrassClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-greengrass/tsconfig.json b/clients/client-greengrass/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-greengrass/tsconfig.json +++ b/clients/client-greengrass/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-groundstation/commands/CancelContactCommand.ts b/clients/client-groundstation/commands/CancelContactCommand.ts index f863fcac4460c..f992e6f4f0c96 100644 --- a/clients/client-groundstation/commands/CancelContactCommand.ts +++ b/clients/client-groundstation/commands/CancelContactCommand.ts @@ -20,6 +20,9 @@ import { export type CancelContactCommandInput = CancelContactRequest; export type CancelContactCommandOutput = ContactIdResponse & __MetadataBearer; +/** + *

Cancels a contact with a specified contact ID.

+ */ export class CancelContactCommand extends $Command< CancelContactCommandInput, CancelContactCommandOutput, @@ -34,6 +37,9 @@ export class CancelContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/CreateConfigCommand.ts b/clients/client-groundstation/commands/CreateConfigCommand.ts index 9159031136679..1b7236ee9cf50 100644 --- a/clients/client-groundstation/commands/CreateConfigCommand.ts +++ b/clients/client-groundstation/commands/CreateConfigCommand.ts @@ -20,6 +20,10 @@ import { export type CreateConfigCommandInput = CreateConfigRequest; export type CreateConfigCommandOutput = ConfigIdResponse & __MetadataBearer; +/** + *

Creates a Config with the specified configData parameters.

+ *

Only one type of configData can be specified.

+ */ export class CreateConfigCommand extends $Command< CreateConfigCommandInput, CreateConfigCommandOutput, @@ -34,6 +38,9 @@ export class CreateConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/CreateDataflowEndpointGroupCommand.ts b/clients/client-groundstation/commands/CreateDataflowEndpointGroupCommand.ts index b9ea06dfdd553..5c89de3d7b86c 100644 --- a/clients/client-groundstation/commands/CreateDataflowEndpointGroupCommand.ts +++ b/clients/client-groundstation/commands/CreateDataflowEndpointGroupCommand.ts @@ -20,6 +20,13 @@ import { export type CreateDataflowEndpointGroupCommandInput = CreateDataflowEndpointGroupRequest; export type CreateDataflowEndpointGroupCommandOutput = DataflowEndpointGroupIdResponse & __MetadataBearer; +/** + *

Creates a DataflowEndpoint group containing the specified list of DataflowEndpoint objects.

+ *

The name field in each endpoint is used in your mission profile DataflowEndpointConfig + * to specify which endpoints to use during a contact.

+ *

When a contact uses multiple DataflowEndpointConfig objects, each Config + * must match a DataflowEndpoint in the same group.

+ */ export class CreateDataflowEndpointGroupCommand extends $Command< CreateDataflowEndpointGroupCommandInput, CreateDataflowEndpointGroupCommandOutput, @@ -34,6 +41,9 @@ export class CreateDataflowEndpointGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/CreateMissionProfileCommand.ts b/clients/client-groundstation/commands/CreateMissionProfileCommand.ts index c6107def17918..00408ae2ccab4 100644 --- a/clients/client-groundstation/commands/CreateMissionProfileCommand.ts +++ b/clients/client-groundstation/commands/CreateMissionProfileCommand.ts @@ -20,6 +20,12 @@ import { export type CreateMissionProfileCommandInput = CreateMissionProfileRequest; export type CreateMissionProfileCommandOutput = MissionProfileIdResponse & __MetadataBearer; +/** + *

Creates a mission profile.

+ *

+ * dataflowEdges is a list of lists of strings. Each lower level list of strings + * has two elements: a from ARN and a to ARN.

+ */ export class CreateMissionProfileCommand extends $Command< CreateMissionProfileCommandInput, CreateMissionProfileCommandOutput, @@ -34,6 +40,9 @@ export class CreateMissionProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/DeleteConfigCommand.ts b/clients/client-groundstation/commands/DeleteConfigCommand.ts index 1309da0bd2bc8..055afd84bc1c9 100644 --- a/clients/client-groundstation/commands/DeleteConfigCommand.ts +++ b/clients/client-groundstation/commands/DeleteConfigCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteConfigCommandInput = DeleteConfigRequest; export type DeleteConfigCommandOutput = ConfigIdResponse & __MetadataBearer; +/** + *

Deletes a Config.

+ */ export class DeleteConfigCommand extends $Command< DeleteConfigCommandInput, DeleteConfigCommandOutput, @@ -34,6 +37,9 @@ export class DeleteConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/DeleteDataflowEndpointGroupCommand.ts b/clients/client-groundstation/commands/DeleteDataflowEndpointGroupCommand.ts index 910995d411329..cc0452ddee4e5 100644 --- a/clients/client-groundstation/commands/DeleteDataflowEndpointGroupCommand.ts +++ b/clients/client-groundstation/commands/DeleteDataflowEndpointGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDataflowEndpointGroupCommandInput = DeleteDataflowEndpointGroupRequest; export type DeleteDataflowEndpointGroupCommandOutput = DataflowEndpointGroupIdResponse & __MetadataBearer; +/** + *

Deletes a dataflow endpoint group.

+ */ export class DeleteDataflowEndpointGroupCommand extends $Command< DeleteDataflowEndpointGroupCommandInput, DeleteDataflowEndpointGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDataflowEndpointGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/DeleteMissionProfileCommand.ts b/clients/client-groundstation/commands/DeleteMissionProfileCommand.ts index 7eefd35848475..38be80057068e 100644 --- a/clients/client-groundstation/commands/DeleteMissionProfileCommand.ts +++ b/clients/client-groundstation/commands/DeleteMissionProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMissionProfileCommandInput = DeleteMissionProfileRequest; export type DeleteMissionProfileCommandOutput = MissionProfileIdResponse & __MetadataBearer; +/** + *

Deletes a mission profile.

+ */ export class DeleteMissionProfileCommand extends $Command< DeleteMissionProfileCommandInput, DeleteMissionProfileCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMissionProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/DescribeContactCommand.ts b/clients/client-groundstation/commands/DescribeContactCommand.ts index 56e62ab8066bd..768b5a4459810 100644 --- a/clients/client-groundstation/commands/DescribeContactCommand.ts +++ b/clients/client-groundstation/commands/DescribeContactCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeContactCommandInput = DescribeContactRequest; export type DescribeContactCommandOutput = DescribeContactResponse & __MetadataBearer; +/** + *

Describes an existing contact.

+ */ export class DescribeContactCommand extends $Command< DescribeContactCommandInput, DescribeContactCommandOutput, @@ -34,6 +37,9 @@ export class DescribeContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/GetConfigCommand.ts b/clients/client-groundstation/commands/GetConfigCommand.ts index 0684b40a862ca..c348dec188b19 100644 --- a/clients/client-groundstation/commands/GetConfigCommand.ts +++ b/clients/client-groundstation/commands/GetConfigCommand.ts @@ -20,6 +20,10 @@ import { export type GetConfigCommandInput = GetConfigRequest; export type GetConfigCommandOutput = GetConfigResponse & __MetadataBearer; +/** + *

Returns Config information.

+ *

Only one Config response can be returned.

+ */ export class GetConfigCommand extends $Command< GetConfigCommandInput, GetConfigCommandOutput, @@ -34,6 +38,9 @@ export class GetConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/GetDataflowEndpointGroupCommand.ts b/clients/client-groundstation/commands/GetDataflowEndpointGroupCommand.ts index ce5e7e1232199..3661c5b49d3bf 100644 --- a/clients/client-groundstation/commands/GetDataflowEndpointGroupCommand.ts +++ b/clients/client-groundstation/commands/GetDataflowEndpointGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetDataflowEndpointGroupCommandInput = GetDataflowEndpointGroupRequest; export type GetDataflowEndpointGroupCommandOutput = GetDataflowEndpointGroupResponse & __MetadataBearer; +/** + *

Returns the dataflow endpoint group.

+ */ export class GetDataflowEndpointGroupCommand extends $Command< GetDataflowEndpointGroupCommandInput, GetDataflowEndpointGroupCommandOutput, @@ -34,6 +37,9 @@ export class GetDataflowEndpointGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/GetMinuteUsageCommand.ts b/clients/client-groundstation/commands/GetMinuteUsageCommand.ts index 2564f0c8a46ef..504c566c6a600 100644 --- a/clients/client-groundstation/commands/GetMinuteUsageCommand.ts +++ b/clients/client-groundstation/commands/GetMinuteUsageCommand.ts @@ -20,6 +20,9 @@ import { export type GetMinuteUsageCommandInput = GetMinuteUsageRequest; export type GetMinuteUsageCommandOutput = GetMinuteUsageResponse & __MetadataBearer; +/** + *

Returns the number of minutes used by account.

+ */ export class GetMinuteUsageCommand extends $Command< GetMinuteUsageCommandInput, GetMinuteUsageCommandOutput, @@ -34,6 +37,9 @@ export class GetMinuteUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/GetMissionProfileCommand.ts b/clients/client-groundstation/commands/GetMissionProfileCommand.ts index bafdda6704a53..d5aeee3460fa1 100644 --- a/clients/client-groundstation/commands/GetMissionProfileCommand.ts +++ b/clients/client-groundstation/commands/GetMissionProfileCommand.ts @@ -20,6 +20,9 @@ import { export type GetMissionProfileCommandInput = GetMissionProfileRequest; export type GetMissionProfileCommandOutput = GetMissionProfileResponse & __MetadataBearer; +/** + *

Returns a mission profile.

+ */ export class GetMissionProfileCommand extends $Command< GetMissionProfileCommandInput, GetMissionProfileCommandOutput, @@ -34,6 +37,9 @@ export class GetMissionProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/GetSatelliteCommand.ts b/clients/client-groundstation/commands/GetSatelliteCommand.ts index 9c3eaa49bc644..88901770d84c9 100644 --- a/clients/client-groundstation/commands/GetSatelliteCommand.ts +++ b/clients/client-groundstation/commands/GetSatelliteCommand.ts @@ -20,6 +20,9 @@ import { export type GetSatelliteCommandInput = GetSatelliteRequest; export type GetSatelliteCommandOutput = GetSatelliteResponse & __MetadataBearer; +/** + *

Returns a satellite.

+ */ export class GetSatelliteCommand extends $Command< GetSatelliteCommandInput, GetSatelliteCommandOutput, @@ -34,6 +37,9 @@ export class GetSatelliteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/ListConfigsCommand.ts b/clients/client-groundstation/commands/ListConfigsCommand.ts index d23215ef44fe5..bf4e969323219 100644 --- a/clients/client-groundstation/commands/ListConfigsCommand.ts +++ b/clients/client-groundstation/commands/ListConfigsCommand.ts @@ -20,6 +20,9 @@ import { export type ListConfigsCommandInput = ListConfigsRequest; export type ListConfigsCommandOutput = ListConfigsResponse & __MetadataBearer; +/** + *

Returns a list of Config objects.

+ */ export class ListConfigsCommand extends $Command< ListConfigsCommandInput, ListConfigsCommandOutput, @@ -34,6 +37,9 @@ export class ListConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/ListContactsCommand.ts b/clients/client-groundstation/commands/ListContactsCommand.ts index 6a06a919a2b27..38681d93b37ee 100644 --- a/clients/client-groundstation/commands/ListContactsCommand.ts +++ b/clients/client-groundstation/commands/ListContactsCommand.ts @@ -20,6 +20,12 @@ import { export type ListContactsCommandInput = ListContactsRequest; export type ListContactsCommandOutput = ListContactsResponse & __MetadataBearer; +/** + *

Returns a list of contacts.

+ *

If statusList contains AVAILABLE, the request must include + * groundStation, missionprofileArn, and satelliteArn. + *

+ */ export class ListContactsCommand extends $Command< ListContactsCommandInput, ListContactsCommandOutput, @@ -34,6 +40,9 @@ export class ListContactsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/ListDataflowEndpointGroupsCommand.ts b/clients/client-groundstation/commands/ListDataflowEndpointGroupsCommand.ts index ff5ae51f0ed40..b6ef0b23f2143 100644 --- a/clients/client-groundstation/commands/ListDataflowEndpointGroupsCommand.ts +++ b/clients/client-groundstation/commands/ListDataflowEndpointGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDataflowEndpointGroupsCommandInput = ListDataflowEndpointGroupsRequest; export type ListDataflowEndpointGroupsCommandOutput = ListDataflowEndpointGroupsResponse & __MetadataBearer; +/** + *

Returns a list of DataflowEndpoint groups.

+ */ export class ListDataflowEndpointGroupsCommand extends $Command< ListDataflowEndpointGroupsCommandInput, ListDataflowEndpointGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListDataflowEndpointGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/ListGroundStationsCommand.ts b/clients/client-groundstation/commands/ListGroundStationsCommand.ts index bc19706f98226..798f0309c62d2 100644 --- a/clients/client-groundstation/commands/ListGroundStationsCommand.ts +++ b/clients/client-groundstation/commands/ListGroundStationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroundStationsCommandInput = ListGroundStationsRequest; export type ListGroundStationsCommandOutput = ListGroundStationsResponse & __MetadataBearer; +/** + *

Returns a list of ground stations.

+ */ export class ListGroundStationsCommand extends $Command< ListGroundStationsCommandInput, ListGroundStationsCommandOutput, @@ -34,6 +37,9 @@ export class ListGroundStationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/ListMissionProfilesCommand.ts b/clients/client-groundstation/commands/ListMissionProfilesCommand.ts index 17172ab2de691..8d22a729f2c96 100644 --- a/clients/client-groundstation/commands/ListMissionProfilesCommand.ts +++ b/clients/client-groundstation/commands/ListMissionProfilesCommand.ts @@ -20,6 +20,9 @@ import { export type ListMissionProfilesCommandInput = ListMissionProfilesRequest; export type ListMissionProfilesCommandOutput = ListMissionProfilesResponse & __MetadataBearer; +/** + *

Returns a list of mission profiles.

+ */ export class ListMissionProfilesCommand extends $Command< ListMissionProfilesCommandInput, ListMissionProfilesCommandOutput, @@ -34,6 +37,9 @@ export class ListMissionProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/ListSatellitesCommand.ts b/clients/client-groundstation/commands/ListSatellitesCommand.ts index f2fdd05987d8a..a155ca3f43276 100644 --- a/clients/client-groundstation/commands/ListSatellitesCommand.ts +++ b/clients/client-groundstation/commands/ListSatellitesCommand.ts @@ -20,6 +20,9 @@ import { export type ListSatellitesCommandInput = ListSatellitesRequest; export type ListSatellitesCommandOutput = ListSatellitesResponse & __MetadataBearer; +/** + *

Returns a list of satellites.

+ */ export class ListSatellitesCommand extends $Command< ListSatellitesCommandInput, ListSatellitesCommandOutput, @@ -34,6 +37,9 @@ export class ListSatellitesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/ListTagsForResourceCommand.ts b/clients/client-groundstation/commands/ListTagsForResourceCommand.ts index 7eea180989e13..94218a6e37a0b 100644 --- a/clients/client-groundstation/commands/ListTagsForResourceCommand.ts +++ b/clients/client-groundstation/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns a list of tags for a specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/ReserveContactCommand.ts b/clients/client-groundstation/commands/ReserveContactCommand.ts index 3751b34959b79..f5480ebb7d481 100644 --- a/clients/client-groundstation/commands/ReserveContactCommand.ts +++ b/clients/client-groundstation/commands/ReserveContactCommand.ts @@ -20,6 +20,9 @@ import { export type ReserveContactCommandInput = ReserveContactRequest; export type ReserveContactCommandOutput = ContactIdResponse & __MetadataBearer; +/** + *

Reserves a contact using specified parameters.

+ */ export class ReserveContactCommand extends $Command< ReserveContactCommandInput, ReserveContactCommandOutput, @@ -34,6 +37,9 @@ export class ReserveContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/TagResourceCommand.ts b/clients/client-groundstation/commands/TagResourceCommand.ts index d0184f2fb3e43..f93ca4bcebfde 100644 --- a/clients/client-groundstation/commands/TagResourceCommand.ts +++ b/clients/client-groundstation/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Assigns a tag to a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/UntagResourceCommand.ts b/clients/client-groundstation/commands/UntagResourceCommand.ts index bfe9ae60a779f..0323eaaab32d0 100644 --- a/clients/client-groundstation/commands/UntagResourceCommand.ts +++ b/clients/client-groundstation/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Deassigns a resource tag.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/UpdateConfigCommand.ts b/clients/client-groundstation/commands/UpdateConfigCommand.ts index c1c16b4503ad3..89d8302673214 100644 --- a/clients/client-groundstation/commands/UpdateConfigCommand.ts +++ b/clients/client-groundstation/commands/UpdateConfigCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateConfigCommandInput = UpdateConfigRequest; export type UpdateConfigCommandOutput = ConfigIdResponse & __MetadataBearer; +/** + *

Updates the Config used when scheduling contacts.

+ *

Updating a Config will not update the execution parameters + * for existing future contacts scheduled with this Config.

+ */ export class UpdateConfigCommand extends $Command< UpdateConfigCommandInput, UpdateConfigCommandOutput, @@ -34,6 +39,9 @@ export class UpdateConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/commands/UpdateMissionProfileCommand.ts b/clients/client-groundstation/commands/UpdateMissionProfileCommand.ts index 80dcf4a788140..b9d53cc02b612 100644 --- a/clients/client-groundstation/commands/UpdateMissionProfileCommand.ts +++ b/clients/client-groundstation/commands/UpdateMissionProfileCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateMissionProfileCommandInput = UpdateMissionProfileRequest; export type UpdateMissionProfileCommandOutput = MissionProfileIdResponse & __MetadataBearer; +/** + *

Updates a mission profile.

+ *

Updating a mission profile will not update the execution parameters + * for existing future contacts.

+ */ export class UpdateMissionProfileCommand extends $Command< UpdateMissionProfileCommandInput, UpdateMissionProfileCommandOutput, @@ -34,6 +39,9 @@ export class UpdateMissionProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GroundStationClientResolvedConfig, diff --git a/clients/client-groundstation/package.json b/clients/client-groundstation/package.json index df1cbc2712ac4..f671c807fb732 100644 --- a/clients/client-groundstation/package.json +++ b/clients/client-groundstation/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Groundstation Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-groundstation/pagination/ListConfigsPaginator.ts b/clients/client-groundstation/pagination/ListConfigsPaginator.ts index 256c3d06bb1c8..34c6e6e0263b2 100644 --- a/clients/client-groundstation/pagination/ListConfigsPaginator.ts +++ b/clients/client-groundstation/pagination/ListConfigsPaginator.ts @@ -4,6 +4,9 @@ import { ListConfigsCommand, ListConfigsCommandInput, ListConfigsCommandOutput } import { GroundStationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GroundStationClient, input: ListConfigsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConfigsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GroundStation, input: ListConfigsCommandInput, diff --git a/clients/client-groundstation/pagination/ListContactsPaginator.ts b/clients/client-groundstation/pagination/ListContactsPaginator.ts index 9f9e6d3cfdb60..261f08fdad0d7 100644 --- a/clients/client-groundstation/pagination/ListContactsPaginator.ts +++ b/clients/client-groundstation/pagination/ListContactsPaginator.ts @@ -8,6 +8,9 @@ import { import { GroundStationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GroundStationClient, input: ListContactsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListContactsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GroundStation, input: ListContactsCommandInput, diff --git a/clients/client-groundstation/pagination/ListDataflowEndpointGroupsPaginator.ts b/clients/client-groundstation/pagination/ListDataflowEndpointGroupsPaginator.ts index 6be057fde6a4e..f730d7b9832b3 100644 --- a/clients/client-groundstation/pagination/ListDataflowEndpointGroupsPaginator.ts +++ b/clients/client-groundstation/pagination/ListDataflowEndpointGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { GroundStationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GroundStationClient, input: ListDataflowEndpointGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDataflowEndpointGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GroundStation, input: ListDataflowEndpointGroupsCommandInput, diff --git a/clients/client-groundstation/pagination/ListGroundStationsPaginator.ts b/clients/client-groundstation/pagination/ListGroundStationsPaginator.ts index 7675c08dc355b..0750bb69fc8c5 100644 --- a/clients/client-groundstation/pagination/ListGroundStationsPaginator.ts +++ b/clients/client-groundstation/pagination/ListGroundStationsPaginator.ts @@ -8,6 +8,9 @@ import { import { GroundStationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GroundStationClient, input: ListGroundStationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroundStationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GroundStation, input: ListGroundStationsCommandInput, diff --git a/clients/client-groundstation/pagination/ListMissionProfilesPaginator.ts b/clients/client-groundstation/pagination/ListMissionProfilesPaginator.ts index bdb0f156f4200..466a7eacceeed 100644 --- a/clients/client-groundstation/pagination/ListMissionProfilesPaginator.ts +++ b/clients/client-groundstation/pagination/ListMissionProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { GroundStationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GroundStationClient, input: ListMissionProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMissionProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GroundStation, input: ListMissionProfilesCommandInput, diff --git a/clients/client-groundstation/pagination/ListSatellitesPaginator.ts b/clients/client-groundstation/pagination/ListSatellitesPaginator.ts index 2d1bc9a2a292d..f33aa6c5e00ee 100644 --- a/clients/client-groundstation/pagination/ListSatellitesPaginator.ts +++ b/clients/client-groundstation/pagination/ListSatellitesPaginator.ts @@ -8,6 +8,9 @@ import { import { GroundStationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GroundStationClient, input: ListSatellitesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSatellitesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GroundStation, input: ListSatellitesCommandInput, diff --git a/clients/client-groundstation/runtimeConfig.browser.ts b/clients/client-groundstation/runtimeConfig.browser.ts index b659604a9af5a..15340a15c6af5 100644 --- a/clients/client-groundstation/runtimeConfig.browser.ts +++ b/clients/client-groundstation/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./GroundStationClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-groundstation/runtimeConfig.native.ts b/clients/client-groundstation/runtimeConfig.native.ts index f6369a98f2493..3475909505162 100644 --- a/clients/client-groundstation/runtimeConfig.native.ts +++ b/clients/client-groundstation/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./GroundStationClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-groundstation/runtimeConfig.shared.ts b/clients/client-groundstation/runtimeConfig.shared.ts index f827501f81df4..bfc6b14a96581 100644 --- a/clients/client-groundstation/runtimeConfig.shared.ts +++ b/clients/client-groundstation/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-05-23", disableHostPrefix: false, diff --git a/clients/client-groundstation/runtimeConfig.ts b/clients/client-groundstation/runtimeConfig.ts index 5d1e416710b0d..132b23b9b6e67 100644 --- a/clients/client-groundstation/runtimeConfig.ts +++ b/clients/client-groundstation/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./GroundStationClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-groundstation/tsconfig.json b/clients/client-groundstation/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-groundstation/tsconfig.json +++ b/clients/client-groundstation/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-guardduty/commands/AcceptInvitationCommand.ts b/clients/client-guardduty/commands/AcceptInvitationCommand.ts index 2be2a3cb6f6af..ac5c598ead21c 100644 --- a/clients/client-guardduty/commands/AcceptInvitationCommand.ts +++ b/clients/client-guardduty/commands/AcceptInvitationCommand.ts @@ -20,6 +20,9 @@ import { export type AcceptInvitationCommandInput = AcceptInvitationRequest; export type AcceptInvitationCommandOutput = AcceptInvitationResponse & __MetadataBearer; +/** + *

Accepts the invitation to be monitored by a master GuardDuty account.

+ */ export class AcceptInvitationCommand extends $Command< AcceptInvitationCommandInput, AcceptInvitationCommandOutput, @@ -34,6 +37,9 @@ export class AcceptInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ArchiveFindingsCommand.ts b/clients/client-guardduty/commands/ArchiveFindingsCommand.ts index 76686078d5722..75c7d0a7b2140 100644 --- a/clients/client-guardduty/commands/ArchiveFindingsCommand.ts +++ b/clients/client-guardduty/commands/ArchiveFindingsCommand.ts @@ -20,6 +20,13 @@ import { export type ArchiveFindingsCommandInput = ArchiveFindingsRequest; export type ArchiveFindingsCommandOutput = ArchiveFindingsResponse & __MetadataBearer; +/** + *

Archives GuardDuty findings that are specified by the list of finding IDs.

+ * + *

Only the master account can archive findings. Member accounts don't have permission to + * archive findings from their accounts.

+ *
+ */ export class ArchiveFindingsCommand extends $Command< ArchiveFindingsCommandInput, ArchiveFindingsCommandOutput, @@ -34,6 +41,9 @@ export class ArchiveFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/CreateDetectorCommand.ts b/clients/client-guardduty/commands/CreateDetectorCommand.ts index 4d4f8100b1b0b..4841fb50578be 100644 --- a/clients/client-guardduty/commands/CreateDetectorCommand.ts +++ b/clients/client-guardduty/commands/CreateDetectorCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDetectorCommandInput = CreateDetectorRequest; export type CreateDetectorCommandOutput = CreateDetectorResponse & __MetadataBearer; +/** + *

Creates a single Amazon GuardDuty detector. A detector is a resource that represents the + * GuardDuty service. To start using GuardDuty, you must create a detector in each Region where + * you enable the service. You can have only one detector per account per Region. All data + * sources are enabled in a new detector by default.

+ */ export class CreateDetectorCommand extends $Command< CreateDetectorCommandInput, CreateDetectorCommandOutput, @@ -34,6 +40,9 @@ export class CreateDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/CreateFilterCommand.ts b/clients/client-guardduty/commands/CreateFilterCommand.ts index 7857de3978adc..91efa81f1eeaf 100644 --- a/clients/client-guardduty/commands/CreateFilterCommand.ts +++ b/clients/client-guardduty/commands/CreateFilterCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFilterCommandInput = CreateFilterRequest; export type CreateFilterCommandOutput = CreateFilterResponse & __MetadataBearer; +/** + *

Creates a filter using the specified finding criteria.

+ */ export class CreateFilterCommand extends $Command< CreateFilterCommandInput, CreateFilterCommandOutput, @@ -34,6 +37,9 @@ export class CreateFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/CreateIPSetCommand.ts b/clients/client-guardduty/commands/CreateIPSetCommand.ts index 38c78ee9279e5..a40819b9bbf64 100644 --- a/clients/client-guardduty/commands/CreateIPSetCommand.ts +++ b/clients/client-guardduty/commands/CreateIPSetCommand.ts @@ -20,6 +20,12 @@ import { export type CreateIPSetCommandInput = CreateIPSetRequest; export type CreateIPSetCommandOutput = CreateIPSetResponse & __MetadataBearer; +/** + *

Creates a new IPSet, which is called a trusted IP list in the console user interface. An + * IPSet is a list of IP addresses that are trusted for secure communication with AWS + * infrastructure and applications. GuardDuty doesn't generate findings for IP addresses that are + * included in IPSets. Only users from the master account can use this operation.

+ */ export class CreateIPSetCommand extends $Command< CreateIPSetCommandInput, CreateIPSetCommandOutput, @@ -34,6 +40,9 @@ export class CreateIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/CreateMembersCommand.ts b/clients/client-guardduty/commands/CreateMembersCommand.ts index ad21ea615ccb0..6010aea074468 100644 --- a/clients/client-guardduty/commands/CreateMembersCommand.ts +++ b/clients/client-guardduty/commands/CreateMembersCommand.ts @@ -20,6 +20,20 @@ import { export type CreateMembersCommandInput = CreateMembersRequest; export type CreateMembersCommandOutput = CreateMembersResponse & __MetadataBearer; +/** + *

Creates member accounts of the current AWS account by specifying a list of AWS account + * IDs. This step is a prerequisite for managing the associated member accounts either by + * invitation or through an organization.

+ *

When using Create Members as an organizations delegated administrator this + * action will enable GuardDuty in the added member accounts, with the exception of the + * organization master account, which must enable GuardDuty prior to being added as a + * member.

+ *

If you are adding accounts by invitation use this action after GuardDuty has been enabled + * in potential member accounts and before using + * Invite + * Members + * .

+ */ export class CreateMembersCommand extends $Command< CreateMembersCommandInput, CreateMembersCommandOutput, @@ -34,6 +48,9 @@ export class CreateMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/CreatePublishingDestinationCommand.ts b/clients/client-guardduty/commands/CreatePublishingDestinationCommand.ts index dbf47b9a33f8a..9d58d1bd0aac9 100644 --- a/clients/client-guardduty/commands/CreatePublishingDestinationCommand.ts +++ b/clients/client-guardduty/commands/CreatePublishingDestinationCommand.ts @@ -20,6 +20,10 @@ import { export type CreatePublishingDestinationCommandInput = CreatePublishingDestinationRequest; export type CreatePublishingDestinationCommandOutput = CreatePublishingDestinationResponse & __MetadataBearer; +/** + *

Creates a publishing destination to export findings to. The resource to export findings to + * must exist before you use this operation.

+ */ export class CreatePublishingDestinationCommand extends $Command< CreatePublishingDestinationCommandInput, CreatePublishingDestinationCommandOutput, @@ -34,6 +38,9 @@ export class CreatePublishingDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/CreateSampleFindingsCommand.ts b/clients/client-guardduty/commands/CreateSampleFindingsCommand.ts index 188e8b79f9b4d..59974a7ab36ab 100644 --- a/clients/client-guardduty/commands/CreateSampleFindingsCommand.ts +++ b/clients/client-guardduty/commands/CreateSampleFindingsCommand.ts @@ -20,6 +20,11 @@ import { export type CreateSampleFindingsCommandInput = CreateSampleFindingsRequest; export type CreateSampleFindingsCommandOutput = CreateSampleFindingsResponse & __MetadataBearer; +/** + *

Generates example findings of types specified by the list of finding types. If 'NULL' is + * specified for findingTypes, the API generates example findings of all supported + * finding types.

+ */ export class CreateSampleFindingsCommand extends $Command< CreateSampleFindingsCommandInput, CreateSampleFindingsCommandOutput, @@ -34,6 +39,9 @@ export class CreateSampleFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/CreateThreatIntelSetCommand.ts b/clients/client-guardduty/commands/CreateThreatIntelSetCommand.ts index 70545b311586c..49f32ffe7a8ea 100644 --- a/clients/client-guardduty/commands/CreateThreatIntelSetCommand.ts +++ b/clients/client-guardduty/commands/CreateThreatIntelSetCommand.ts @@ -20,6 +20,11 @@ import { export type CreateThreatIntelSetCommandInput = CreateThreatIntelSetRequest; export type CreateThreatIntelSetCommandOutput = CreateThreatIntelSetResponse & __MetadataBearer; +/** + *

Creates a new ThreatIntelSet. ThreatIntelSets consist of known malicious IP addresses. + * GuardDuty generates findings based on ThreatIntelSets. Only users of the master account can + * use this operation.

+ */ export class CreateThreatIntelSetCommand extends $Command< CreateThreatIntelSetCommandInput, CreateThreatIntelSetCommandOutput, @@ -34,6 +39,9 @@ export class CreateThreatIntelSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DeclineInvitationsCommand.ts b/clients/client-guardduty/commands/DeclineInvitationsCommand.ts index c18576a131575..0bad11016eef2 100644 --- a/clients/client-guardduty/commands/DeclineInvitationsCommand.ts +++ b/clients/client-guardduty/commands/DeclineInvitationsCommand.ts @@ -20,6 +20,10 @@ import { export type DeclineInvitationsCommandInput = DeclineInvitationsRequest; export type DeclineInvitationsCommandOutput = DeclineInvitationsResponse & __MetadataBearer; +/** + *

Declines invitations sent to the current member account by AWS accounts specified by their + * account IDs.

+ */ export class DeclineInvitationsCommand extends $Command< DeclineInvitationsCommandInput, DeclineInvitationsCommandOutput, @@ -34,6 +38,9 @@ export class DeclineInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DeleteDetectorCommand.ts b/clients/client-guardduty/commands/DeleteDetectorCommand.ts index a9fe4b752a9bf..a0bfb59b552af 100644 --- a/clients/client-guardduty/commands/DeleteDetectorCommand.ts +++ b/clients/client-guardduty/commands/DeleteDetectorCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDetectorCommandInput = DeleteDetectorRequest; export type DeleteDetectorCommandOutput = DeleteDetectorResponse & __MetadataBearer; +/** + *

Deletes an Amazon GuardDuty detector that is specified by the detector ID.

+ */ export class DeleteDetectorCommand extends $Command< DeleteDetectorCommandInput, DeleteDetectorCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DeleteFilterCommand.ts b/clients/client-guardduty/commands/DeleteFilterCommand.ts index eb2cc9a975b98..3d35ba63bf6d6 100644 --- a/clients/client-guardduty/commands/DeleteFilterCommand.ts +++ b/clients/client-guardduty/commands/DeleteFilterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFilterCommandInput = DeleteFilterRequest; export type DeleteFilterCommandOutput = DeleteFilterResponse & __MetadataBearer; +/** + *

Deletes the filter specified by the filter name.

+ */ export class DeleteFilterCommand extends $Command< DeleteFilterCommandInput, DeleteFilterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DeleteIPSetCommand.ts b/clients/client-guardduty/commands/DeleteIPSetCommand.ts index a2252ce774ac3..d631a24522d77 100644 --- a/clients/client-guardduty/commands/DeleteIPSetCommand.ts +++ b/clients/client-guardduty/commands/DeleteIPSetCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteIPSetCommandInput = DeleteIPSetRequest; export type DeleteIPSetCommandOutput = DeleteIPSetResponse & __MetadataBearer; +/** + *

Deletes the IPSet specified by the ipSetId. IPSets are called trusted IP + * lists in the console user interface.

+ */ export class DeleteIPSetCommand extends $Command< DeleteIPSetCommandInput, DeleteIPSetCommandOutput, @@ -34,6 +38,9 @@ export class DeleteIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DeleteInvitationsCommand.ts b/clients/client-guardduty/commands/DeleteInvitationsCommand.ts index cf066b34ae5c5..59309c9642d45 100644 --- a/clients/client-guardduty/commands/DeleteInvitationsCommand.ts +++ b/clients/client-guardduty/commands/DeleteInvitationsCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteInvitationsCommandInput = DeleteInvitationsRequest; export type DeleteInvitationsCommandOutput = DeleteInvitationsResponse & __MetadataBearer; +/** + *

Deletes invitations sent to the current member account by AWS accounts specified by their + * account IDs.

+ */ export class DeleteInvitationsCommand extends $Command< DeleteInvitationsCommandInput, DeleteInvitationsCommandOutput, @@ -34,6 +38,9 @@ export class DeleteInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DeleteMembersCommand.ts b/clients/client-guardduty/commands/DeleteMembersCommand.ts index f3fbb7d4fee5e..7029e7b763de1 100644 --- a/clients/client-guardduty/commands/DeleteMembersCommand.ts +++ b/clients/client-guardduty/commands/DeleteMembersCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteMembersCommandInput = DeleteMembersRequest; export type DeleteMembersCommandOutput = DeleteMembersResponse & __MetadataBearer; +/** + *

Deletes GuardDuty member accounts (to the current GuardDuty master account) specified by + * the account IDs.

+ */ export class DeleteMembersCommand extends $Command< DeleteMembersCommandInput, DeleteMembersCommandOutput, @@ -34,6 +38,9 @@ export class DeleteMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DeletePublishingDestinationCommand.ts b/clients/client-guardduty/commands/DeletePublishingDestinationCommand.ts index 30fa982d732bc..621878830dd8d 100644 --- a/clients/client-guardduty/commands/DeletePublishingDestinationCommand.ts +++ b/clients/client-guardduty/commands/DeletePublishingDestinationCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePublishingDestinationCommandInput = DeletePublishingDestinationRequest; export type DeletePublishingDestinationCommandOutput = DeletePublishingDestinationResponse & __MetadataBearer; +/** + *

Deletes the publishing definition with the specified destinationId.

+ */ export class DeletePublishingDestinationCommand extends $Command< DeletePublishingDestinationCommandInput, DeletePublishingDestinationCommandOutput, @@ -34,6 +37,9 @@ export class DeletePublishingDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DeleteThreatIntelSetCommand.ts b/clients/client-guardduty/commands/DeleteThreatIntelSetCommand.ts index 9d7b0e6ed5e79..e5fb3dbba5809 100644 --- a/clients/client-guardduty/commands/DeleteThreatIntelSetCommand.ts +++ b/clients/client-guardduty/commands/DeleteThreatIntelSetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteThreatIntelSetCommandInput = DeleteThreatIntelSetRequest; export type DeleteThreatIntelSetCommandOutput = DeleteThreatIntelSetResponse & __MetadataBearer; +/** + *

Deletes the ThreatIntelSet specified by the ThreatIntelSet ID.

+ */ export class DeleteThreatIntelSetCommand extends $Command< DeleteThreatIntelSetCommandInput, DeleteThreatIntelSetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteThreatIntelSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DescribeOrganizationConfigurationCommand.ts b/clients/client-guardduty/commands/DescribeOrganizationConfigurationCommand.ts index a19529860cb0a..aa35238962582 100644 --- a/clients/client-guardduty/commands/DescribeOrganizationConfigurationCommand.ts +++ b/clients/client-guardduty/commands/DescribeOrganizationConfigurationCommand.ts @@ -24,6 +24,10 @@ export type DescribeOrganizationConfigurationCommandInput = DescribeOrganization export type DescribeOrganizationConfigurationCommandOutput = DescribeOrganizationConfigurationResponse & __MetadataBearer; +/** + *

Returns information about the account selected as the delegated administrator for + * GuardDuty.

+ */ export class DescribeOrganizationConfigurationCommand extends $Command< DescribeOrganizationConfigurationCommandInput, DescribeOrganizationConfigurationCommandOutput, @@ -38,6 +42,9 @@ export class DescribeOrganizationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DescribePublishingDestinationCommand.ts b/clients/client-guardduty/commands/DescribePublishingDestinationCommand.ts index 362cf3dda7d96..5974775da8734 100644 --- a/clients/client-guardduty/commands/DescribePublishingDestinationCommand.ts +++ b/clients/client-guardduty/commands/DescribePublishingDestinationCommand.ts @@ -20,6 +20,10 @@ import { export type DescribePublishingDestinationCommandInput = DescribePublishingDestinationRequest; export type DescribePublishingDestinationCommandOutput = DescribePublishingDestinationResponse & __MetadataBearer; +/** + *

Returns information about the publishing destination specified by the provided + * destinationId.

+ */ export class DescribePublishingDestinationCommand extends $Command< DescribePublishingDestinationCommandInput, DescribePublishingDestinationCommandOutput, @@ -34,6 +38,9 @@ export class DescribePublishingDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DisableOrganizationAdminAccountCommand.ts b/clients/client-guardduty/commands/DisableOrganizationAdminAccountCommand.ts index 3ce400a3078da..393196dc0b893 100644 --- a/clients/client-guardduty/commands/DisableOrganizationAdminAccountCommand.ts +++ b/clients/client-guardduty/commands/DisableOrganizationAdminAccountCommand.ts @@ -20,6 +20,10 @@ import { export type DisableOrganizationAdminAccountCommandInput = DisableOrganizationAdminAccountRequest; export type DisableOrganizationAdminAccountCommandOutput = DisableOrganizationAdminAccountResponse & __MetadataBearer; +/** + *

Disables an AWS account within the Organization as the GuardDuty delegated + * administrator.

+ */ export class DisableOrganizationAdminAccountCommand extends $Command< DisableOrganizationAdminAccountCommandInput, DisableOrganizationAdminAccountCommandOutput, @@ -34,6 +38,9 @@ export class DisableOrganizationAdminAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DisassociateFromMasterAccountCommand.ts b/clients/client-guardduty/commands/DisassociateFromMasterAccountCommand.ts index 76c9735b5cf93..7500576f5ba57 100644 --- a/clients/client-guardduty/commands/DisassociateFromMasterAccountCommand.ts +++ b/clients/client-guardduty/commands/DisassociateFromMasterAccountCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateFromMasterAccountCommandInput = DisassociateFromMasterAccountRequest; export type DisassociateFromMasterAccountCommandOutput = DisassociateFromMasterAccountResponse & __MetadataBearer; +/** + *

Disassociates the current GuardDuty member account from its master account.

+ */ export class DisassociateFromMasterAccountCommand extends $Command< DisassociateFromMasterAccountCommandInput, DisassociateFromMasterAccountCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateFromMasterAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/DisassociateMembersCommand.ts b/clients/client-guardduty/commands/DisassociateMembersCommand.ts index 5f5ed446c51fc..269456cd6eba8 100644 --- a/clients/client-guardduty/commands/DisassociateMembersCommand.ts +++ b/clients/client-guardduty/commands/DisassociateMembersCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateMembersCommandInput = DisassociateMembersRequest; export type DisassociateMembersCommandOutput = DisassociateMembersResponse & __MetadataBearer; +/** + *

Disassociates GuardDuty member accounts (to the current GuardDuty master account) + * specified by the account IDs.

+ */ export class DisassociateMembersCommand extends $Command< DisassociateMembersCommandInput, DisassociateMembersCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/EnableOrganizationAdminAccountCommand.ts b/clients/client-guardduty/commands/EnableOrganizationAdminAccountCommand.ts index 738ad2ea4286f..03ee6d0fdccce 100644 --- a/clients/client-guardduty/commands/EnableOrganizationAdminAccountCommand.ts +++ b/clients/client-guardduty/commands/EnableOrganizationAdminAccountCommand.ts @@ -20,6 +20,10 @@ import { export type EnableOrganizationAdminAccountCommandInput = EnableOrganizationAdminAccountRequest; export type EnableOrganizationAdminAccountCommandOutput = EnableOrganizationAdminAccountResponse & __MetadataBearer; +/** + *

Enables an AWS account within the organization as the GuardDuty delegated + * administrator.

+ */ export class EnableOrganizationAdminAccountCommand extends $Command< EnableOrganizationAdminAccountCommandInput, EnableOrganizationAdminAccountCommandOutput, @@ -34,6 +38,9 @@ export class EnableOrganizationAdminAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetDetectorCommand.ts b/clients/client-guardduty/commands/GetDetectorCommand.ts index 01680fcb5eef6..df41dd723d45c 100644 --- a/clients/client-guardduty/commands/GetDetectorCommand.ts +++ b/clients/client-guardduty/commands/GetDetectorCommand.ts @@ -20,6 +20,9 @@ import { export type GetDetectorCommandInput = GetDetectorRequest; export type GetDetectorCommandOutput = GetDetectorResponse & __MetadataBearer; +/** + *

Retrieves an Amazon GuardDuty detector specified by the detectorId.

+ */ export class GetDetectorCommand extends $Command< GetDetectorCommandInput, GetDetectorCommandOutput, @@ -34,6 +37,9 @@ export class GetDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetFilterCommand.ts b/clients/client-guardduty/commands/GetFilterCommand.ts index 8c0374cfb0e8e..5ac11bccd98ef 100644 --- a/clients/client-guardduty/commands/GetFilterCommand.ts +++ b/clients/client-guardduty/commands/GetFilterCommand.ts @@ -20,6 +20,9 @@ import { export type GetFilterCommandInput = GetFilterRequest; export type GetFilterCommandOutput = GetFilterResponse & __MetadataBearer; +/** + *

Returns the details of the filter specified by the filter name.

+ */ export class GetFilterCommand extends $Command< GetFilterCommandInput, GetFilterCommandOutput, @@ -34,6 +37,9 @@ export class GetFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetFindingsCommand.ts b/clients/client-guardduty/commands/GetFindingsCommand.ts index f7cf860922cad..3fb9332421a02 100644 --- a/clients/client-guardduty/commands/GetFindingsCommand.ts +++ b/clients/client-guardduty/commands/GetFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetFindingsCommandInput = GetFindingsRequest; export type GetFindingsCommandOutput = GetFindingsResponse & __MetadataBearer; +/** + *

Describes Amazon GuardDuty findings specified by finding IDs.

+ */ export class GetFindingsCommand extends $Command< GetFindingsCommandInput, GetFindingsCommandOutput, @@ -34,6 +37,9 @@ export class GetFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetFindingsStatisticsCommand.ts b/clients/client-guardduty/commands/GetFindingsStatisticsCommand.ts index 9ad0d634b68ae..edf000f1b09e6 100644 --- a/clients/client-guardduty/commands/GetFindingsStatisticsCommand.ts +++ b/clients/client-guardduty/commands/GetFindingsStatisticsCommand.ts @@ -20,6 +20,9 @@ import { export type GetFindingsStatisticsCommandInput = GetFindingsStatisticsRequest; export type GetFindingsStatisticsCommandOutput = GetFindingsStatisticsResponse & __MetadataBearer; +/** + *

Lists Amazon GuardDuty findings statistics for the specified detector ID.

+ */ export class GetFindingsStatisticsCommand extends $Command< GetFindingsStatisticsCommandInput, GetFindingsStatisticsCommandOutput, @@ -34,6 +37,9 @@ export class GetFindingsStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetIPSetCommand.ts b/clients/client-guardduty/commands/GetIPSetCommand.ts index 13dccc4c37e0e..5d9edf67eba77 100644 --- a/clients/client-guardduty/commands/GetIPSetCommand.ts +++ b/clients/client-guardduty/commands/GetIPSetCommand.ts @@ -20,6 +20,9 @@ import { export type GetIPSetCommandInput = GetIPSetRequest; export type GetIPSetCommandOutput = GetIPSetResponse & __MetadataBearer; +/** + *

Retrieves the IPSet specified by the ipSetId.

+ */ export class GetIPSetCommand extends $Command< GetIPSetCommandInput, GetIPSetCommandOutput, @@ -34,6 +37,9 @@ export class GetIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetInvitationsCountCommand.ts b/clients/client-guardduty/commands/GetInvitationsCountCommand.ts index fa940d2de826d..baac73a6f1a6a 100644 --- a/clients/client-guardduty/commands/GetInvitationsCountCommand.ts +++ b/clients/client-guardduty/commands/GetInvitationsCountCommand.ts @@ -20,6 +20,10 @@ import { export type GetInvitationsCountCommandInput = GetInvitationsCountRequest; export type GetInvitationsCountCommandOutput = GetInvitationsCountResponse & __MetadataBearer; +/** + *

Returns the count of all GuardDuty membership invitations that were sent to the current + * member account except the currently accepted invitation.

+ */ export class GetInvitationsCountCommand extends $Command< GetInvitationsCountCommandInput, GetInvitationsCountCommandOutput, @@ -34,6 +38,9 @@ export class GetInvitationsCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetMasterAccountCommand.ts b/clients/client-guardduty/commands/GetMasterAccountCommand.ts index 7cc61d0b90838..5b89640d1ef41 100644 --- a/clients/client-guardduty/commands/GetMasterAccountCommand.ts +++ b/clients/client-guardduty/commands/GetMasterAccountCommand.ts @@ -20,6 +20,10 @@ import { export type GetMasterAccountCommandInput = GetMasterAccountRequest; export type GetMasterAccountCommandOutput = GetMasterAccountResponse & __MetadataBearer; +/** + *

Provides the details for the GuardDuty master account associated with the current + * GuardDuty member account.

+ */ export class GetMasterAccountCommand extends $Command< GetMasterAccountCommandInput, GetMasterAccountCommandOutput, @@ -34,6 +38,9 @@ export class GetMasterAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetMemberDetectorsCommand.ts b/clients/client-guardduty/commands/GetMemberDetectorsCommand.ts index 5d688ae004ea9..03d6ba4c372ac 100644 --- a/clients/client-guardduty/commands/GetMemberDetectorsCommand.ts +++ b/clients/client-guardduty/commands/GetMemberDetectorsCommand.ts @@ -20,6 +20,9 @@ import { export type GetMemberDetectorsCommandInput = GetMemberDetectorsRequest; export type GetMemberDetectorsCommandOutput = GetMemberDetectorsResponse & __MetadataBearer; +/** + *

Describes which data sources are enabled for the member account's detector.

+ */ export class GetMemberDetectorsCommand extends $Command< GetMemberDetectorsCommandInput, GetMemberDetectorsCommandOutput, @@ -34,6 +37,9 @@ export class GetMemberDetectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetMembersCommand.ts b/clients/client-guardduty/commands/GetMembersCommand.ts index ec3eb43af42fc..0736e954a1415 100644 --- a/clients/client-guardduty/commands/GetMembersCommand.ts +++ b/clients/client-guardduty/commands/GetMembersCommand.ts @@ -20,6 +20,10 @@ import { export type GetMembersCommandInput = GetMembersRequest; export type GetMembersCommandOutput = GetMembersResponse & __MetadataBearer; +/** + *

Retrieves GuardDuty member accounts (to the current GuardDuty master account) specified by + * the account IDs.

+ */ export class GetMembersCommand extends $Command< GetMembersCommandInput, GetMembersCommandOutput, @@ -34,6 +38,9 @@ export class GetMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetThreatIntelSetCommand.ts b/clients/client-guardduty/commands/GetThreatIntelSetCommand.ts index e198f7bfa7835..9aa344db76552 100644 --- a/clients/client-guardduty/commands/GetThreatIntelSetCommand.ts +++ b/clients/client-guardduty/commands/GetThreatIntelSetCommand.ts @@ -20,6 +20,9 @@ import { export type GetThreatIntelSetCommandInput = GetThreatIntelSetRequest; export type GetThreatIntelSetCommandOutput = GetThreatIntelSetResponse & __MetadataBearer; +/** + *

Retrieves the ThreatIntelSet that is specified by the ThreatIntelSet ID.

+ */ export class GetThreatIntelSetCommand extends $Command< GetThreatIntelSetCommandInput, GetThreatIntelSetCommandOutput, @@ -34,6 +37,9 @@ export class GetThreatIntelSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/GetUsageStatisticsCommand.ts b/clients/client-guardduty/commands/GetUsageStatisticsCommand.ts index 71e8fafd5e9cd..be7f63a4a3a16 100644 --- a/clients/client-guardduty/commands/GetUsageStatisticsCommand.ts +++ b/clients/client-guardduty/commands/GetUsageStatisticsCommand.ts @@ -20,6 +20,12 @@ import { export type GetUsageStatisticsCommandInput = GetUsageStatisticsRequest; export type GetUsageStatisticsCommandOutput = GetUsageStatisticsResponse & __MetadataBearer; +/** + *

Lists Amazon GuardDuty usage statistics over the last 30 days for the specified detector + * ID. For newly enabled detectors or data sources the cost returned will include only the usage + * so far under 30 days, this may differ from the cost metrics in the console, which projects + * usage over 30 days to provide a monthly cost estimate. For more information see Understanding How Usage Costs are Calculated.

+ */ export class GetUsageStatisticsCommand extends $Command< GetUsageStatisticsCommandInput, GetUsageStatisticsCommandOutput, @@ -34,6 +40,9 @@ export class GetUsageStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/InviteMembersCommand.ts b/clients/client-guardduty/commands/InviteMembersCommand.ts index 7234ab1ddf231..1fe4cfde80d9f 100644 --- a/clients/client-guardduty/commands/InviteMembersCommand.ts +++ b/clients/client-guardduty/commands/InviteMembersCommand.ts @@ -20,6 +20,11 @@ import { export type InviteMembersCommandInput = InviteMembersRequest; export type InviteMembersCommandOutput = InviteMembersResponse & __MetadataBearer; +/** + *

Invites other AWS accounts (created as members of the current AWS account by + * CreateMembers) to enable GuardDuty, and allow the current AWS account to view and manage these + * accounts' GuardDuty findings on their behalf as the master account.

+ */ export class InviteMembersCommand extends $Command< InviteMembersCommandInput, InviteMembersCommandOutput, @@ -34,6 +39,9 @@ export class InviteMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListDetectorsCommand.ts b/clients/client-guardduty/commands/ListDetectorsCommand.ts index f161a1bc897e0..c981906886945 100644 --- a/clients/client-guardduty/commands/ListDetectorsCommand.ts +++ b/clients/client-guardduty/commands/ListDetectorsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDetectorsCommandInput = ListDetectorsRequest; export type ListDetectorsCommandOutput = ListDetectorsResponse & __MetadataBearer; +/** + *

Lists detectorIds of all the existing Amazon GuardDuty detector resources.

+ */ export class ListDetectorsCommand extends $Command< ListDetectorsCommandInput, ListDetectorsCommandOutput, @@ -34,6 +37,9 @@ export class ListDetectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListFiltersCommand.ts b/clients/client-guardduty/commands/ListFiltersCommand.ts index 5285743d4019f..e70fcf46b7822 100644 --- a/clients/client-guardduty/commands/ListFiltersCommand.ts +++ b/clients/client-guardduty/commands/ListFiltersCommand.ts @@ -20,6 +20,9 @@ import { export type ListFiltersCommandInput = ListFiltersRequest; export type ListFiltersCommandOutput = ListFiltersResponse & __MetadataBearer; +/** + *

Returns a paginated list of the current filters.

+ */ export class ListFiltersCommand extends $Command< ListFiltersCommandInput, ListFiltersCommandOutput, @@ -34,6 +37,9 @@ export class ListFiltersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListFindingsCommand.ts b/clients/client-guardduty/commands/ListFindingsCommand.ts index 4c66f89331758..441047a971e2c 100644 --- a/clients/client-guardduty/commands/ListFindingsCommand.ts +++ b/clients/client-guardduty/commands/ListFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFindingsCommandInput = ListFindingsRequest; export type ListFindingsCommandOutput = ListFindingsResponse & __MetadataBearer; +/** + *

Lists Amazon GuardDuty findings for the specified detector ID.

+ */ export class ListFindingsCommand extends $Command< ListFindingsCommandInput, ListFindingsCommandOutput, @@ -34,6 +37,9 @@ export class ListFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListIPSetsCommand.ts b/clients/client-guardduty/commands/ListIPSetsCommand.ts index 8f465f026c158..a90f22ee6153c 100644 --- a/clients/client-guardduty/commands/ListIPSetsCommand.ts +++ b/clients/client-guardduty/commands/ListIPSetsCommand.ts @@ -20,6 +20,11 @@ import { export type ListIPSetsCommandInput = ListIPSetsRequest; export type ListIPSetsCommandOutput = ListIPSetsResponse & __MetadataBearer; +/** + *

Lists the IPSets of the GuardDuty service specified by the detector ID. If you use this + * operation from a member account, the IPSets returned are the IPSets from the associated master + * account.

+ */ export class ListIPSetsCommand extends $Command< ListIPSetsCommandInput, ListIPSetsCommandOutput, @@ -34,6 +39,9 @@ export class ListIPSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListInvitationsCommand.ts b/clients/client-guardduty/commands/ListInvitationsCommand.ts index e68c7801b7ae1..b376050dc7371 100644 --- a/clients/client-guardduty/commands/ListInvitationsCommand.ts +++ b/clients/client-guardduty/commands/ListInvitationsCommand.ts @@ -20,6 +20,10 @@ import { export type ListInvitationsCommandInput = ListInvitationsRequest; export type ListInvitationsCommandOutput = ListInvitationsResponse & __MetadataBearer; +/** + *

Lists all GuardDuty membership invitations that were sent to the current AWS + * account.

+ */ export class ListInvitationsCommand extends $Command< ListInvitationsCommandInput, ListInvitationsCommandOutput, @@ -34,6 +38,9 @@ export class ListInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListMembersCommand.ts b/clients/client-guardduty/commands/ListMembersCommand.ts index 801f7dd54e130..d8782a301a986 100644 --- a/clients/client-guardduty/commands/ListMembersCommand.ts +++ b/clients/client-guardduty/commands/ListMembersCommand.ts @@ -20,6 +20,9 @@ import { export type ListMembersCommandInput = ListMembersRequest; export type ListMembersCommandOutput = ListMembersResponse & __MetadataBearer; +/** + *

Lists details about all member accounts for the current GuardDuty master account.

+ */ export class ListMembersCommand extends $Command< ListMembersCommandInput, ListMembersCommandOutput, @@ -34,6 +37,9 @@ export class ListMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListOrganizationAdminAccountsCommand.ts b/clients/client-guardduty/commands/ListOrganizationAdminAccountsCommand.ts index 29bffdf7532d9..7986e99ca2594 100644 --- a/clients/client-guardduty/commands/ListOrganizationAdminAccountsCommand.ts +++ b/clients/client-guardduty/commands/ListOrganizationAdminAccountsCommand.ts @@ -20,6 +20,9 @@ import { export type ListOrganizationAdminAccountsCommandInput = ListOrganizationAdminAccountsRequest; export type ListOrganizationAdminAccountsCommandOutput = ListOrganizationAdminAccountsResponse & __MetadataBearer; +/** + *

Lists the accounts configured as GuardDuty delegated administrators.

+ */ export class ListOrganizationAdminAccountsCommand extends $Command< ListOrganizationAdminAccountsCommandInput, ListOrganizationAdminAccountsCommandOutput, @@ -34,6 +37,9 @@ export class ListOrganizationAdminAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListPublishingDestinationsCommand.ts b/clients/client-guardduty/commands/ListPublishingDestinationsCommand.ts index 31a6aba6f287a..589f121cd1d44 100644 --- a/clients/client-guardduty/commands/ListPublishingDestinationsCommand.ts +++ b/clients/client-guardduty/commands/ListPublishingDestinationsCommand.ts @@ -20,6 +20,10 @@ import { export type ListPublishingDestinationsCommandInput = ListPublishingDestinationsRequest; export type ListPublishingDestinationsCommandOutput = ListPublishingDestinationsResponse & __MetadataBearer; +/** + *

Returns a list of publishing destinations associated with the specified + * dectectorId.

+ */ export class ListPublishingDestinationsCommand extends $Command< ListPublishingDestinationsCommandInput, ListPublishingDestinationsCommandOutput, @@ -34,6 +38,9 @@ export class ListPublishingDestinationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListTagsForResourceCommand.ts b/clients/client-guardduty/commands/ListTagsForResourceCommand.ts index b17311a09af92..9da171144699a 100644 --- a/clients/client-guardduty/commands/ListTagsForResourceCommand.ts +++ b/clients/client-guardduty/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists tags for a resource. Tagging is currently supported for detectors, finding filters, + * IP sets, and threat intel sets, with a limit of 50 tags per resource. When invoked, this + * operation returns all assigned tags for a given resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/ListThreatIntelSetsCommand.ts b/clients/client-guardduty/commands/ListThreatIntelSetsCommand.ts index 1913950106ed9..9164d7d93a477 100644 --- a/clients/client-guardduty/commands/ListThreatIntelSetsCommand.ts +++ b/clients/client-guardduty/commands/ListThreatIntelSetsCommand.ts @@ -20,6 +20,11 @@ import { export type ListThreatIntelSetsCommandInput = ListThreatIntelSetsRequest; export type ListThreatIntelSetsCommandOutput = ListThreatIntelSetsResponse & __MetadataBearer; +/** + *

Lists the ThreatIntelSets of the GuardDuty service specified by the detector ID. If you + * use this operation from a member account, the ThreatIntelSets associated with the master + * account are returned.

+ */ export class ListThreatIntelSetsCommand extends $Command< ListThreatIntelSetsCommandInput, ListThreatIntelSetsCommandOutput, @@ -34,6 +39,9 @@ export class ListThreatIntelSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/StartMonitoringMembersCommand.ts b/clients/client-guardduty/commands/StartMonitoringMembersCommand.ts index 1bc24ea5f7515..83d917f9f1f3a 100644 --- a/clients/client-guardduty/commands/StartMonitoringMembersCommand.ts +++ b/clients/client-guardduty/commands/StartMonitoringMembersCommand.ts @@ -20,6 +20,11 @@ import { export type StartMonitoringMembersCommandInput = StartMonitoringMembersRequest; export type StartMonitoringMembersCommandOutput = StartMonitoringMembersResponse & __MetadataBearer; +/** + *

Turns on GuardDuty monitoring of the specified member accounts. Use this operation to + * restart monitoring of accounts that you stopped monitoring with the + * StopMonitoringMembers operation.

+ */ export class StartMonitoringMembersCommand extends $Command< StartMonitoringMembersCommandInput, StartMonitoringMembersCommandOutput, @@ -34,6 +39,9 @@ export class StartMonitoringMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/StopMonitoringMembersCommand.ts b/clients/client-guardduty/commands/StopMonitoringMembersCommand.ts index 9fb9a26913f12..18c4fdee46f6f 100644 --- a/clients/client-guardduty/commands/StopMonitoringMembersCommand.ts +++ b/clients/client-guardduty/commands/StopMonitoringMembersCommand.ts @@ -20,6 +20,11 @@ import { export type StopMonitoringMembersCommandInput = StopMonitoringMembersRequest; export type StopMonitoringMembersCommandOutput = StopMonitoringMembersResponse & __MetadataBearer; +/** + *

Stops GuardDuty monitoring for the specified member accounts. Use the + * StartMonitoringMembers operation to restart monitoring for those + * accounts.

+ */ export class StopMonitoringMembersCommand extends $Command< StopMonitoringMembersCommandInput, StopMonitoringMembersCommandOutput, @@ -34,6 +39,9 @@ export class StopMonitoringMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/TagResourceCommand.ts b/clients/client-guardduty/commands/TagResourceCommand.ts index 249f1c4dd2116..523dc6bcc2f1f 100644 --- a/clients/client-guardduty/commands/TagResourceCommand.ts +++ b/clients/client-guardduty/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds tags to a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UnarchiveFindingsCommand.ts b/clients/client-guardduty/commands/UnarchiveFindingsCommand.ts index 31cc942c1c5c9..11af8dac5dd18 100644 --- a/clients/client-guardduty/commands/UnarchiveFindingsCommand.ts +++ b/clients/client-guardduty/commands/UnarchiveFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type UnarchiveFindingsCommandInput = UnarchiveFindingsRequest; export type UnarchiveFindingsCommandOutput = UnarchiveFindingsResponse & __MetadataBearer; +/** + *

Unarchives GuardDuty findings specified by the findingIds.

+ */ export class UnarchiveFindingsCommand extends $Command< UnarchiveFindingsCommandInput, UnarchiveFindingsCommandOutput, @@ -34,6 +37,9 @@ export class UnarchiveFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UntagResourceCommand.ts b/clients/client-guardduty/commands/UntagResourceCommand.ts index 0e3a997826e95..f8bf3b7b52e90 100644 --- a/clients/client-guardduty/commands/UntagResourceCommand.ts +++ b/clients/client-guardduty/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UpdateDetectorCommand.ts b/clients/client-guardduty/commands/UpdateDetectorCommand.ts index 10849878543c4..dd59dbb11e8c6 100644 --- a/clients/client-guardduty/commands/UpdateDetectorCommand.ts +++ b/clients/client-guardduty/commands/UpdateDetectorCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDetectorCommandInput = UpdateDetectorRequest; export type UpdateDetectorCommandOutput = UpdateDetectorResponse & __MetadataBearer; +/** + *

Updates the Amazon GuardDuty detector specified by the detectorId.

+ */ export class UpdateDetectorCommand extends $Command< UpdateDetectorCommandInput, UpdateDetectorCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UpdateFilterCommand.ts b/clients/client-guardduty/commands/UpdateFilterCommand.ts index 27d93f43afe35..d7c687e96e976 100644 --- a/clients/client-guardduty/commands/UpdateFilterCommand.ts +++ b/clients/client-guardduty/commands/UpdateFilterCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFilterCommandInput = UpdateFilterRequest; export type UpdateFilterCommandOutput = UpdateFilterResponse & __MetadataBearer; +/** + *

Updates the filter specified by the filter name.

+ */ export class UpdateFilterCommand extends $Command< UpdateFilterCommandInput, UpdateFilterCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UpdateFindingsFeedbackCommand.ts b/clients/client-guardduty/commands/UpdateFindingsFeedbackCommand.ts index df6f46c6e1fdd..ebb0ddeac7da9 100644 --- a/clients/client-guardduty/commands/UpdateFindingsFeedbackCommand.ts +++ b/clients/client-guardduty/commands/UpdateFindingsFeedbackCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFindingsFeedbackCommandInput = UpdateFindingsFeedbackRequest; export type UpdateFindingsFeedbackCommandOutput = UpdateFindingsFeedbackResponse & __MetadataBearer; +/** + *

Marks the specified GuardDuty findings as useful or not useful.

+ */ export class UpdateFindingsFeedbackCommand extends $Command< UpdateFindingsFeedbackCommandInput, UpdateFindingsFeedbackCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFindingsFeedbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UpdateIPSetCommand.ts b/clients/client-guardduty/commands/UpdateIPSetCommand.ts index bb804598b1c42..7f3c2076ad1dd 100644 --- a/clients/client-guardduty/commands/UpdateIPSetCommand.ts +++ b/clients/client-guardduty/commands/UpdateIPSetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateIPSetCommandInput = UpdateIPSetRequest; export type UpdateIPSetCommandOutput = UpdateIPSetResponse & __MetadataBearer; +/** + *

Updates the IPSet specified by the IPSet ID.

+ */ export class UpdateIPSetCommand extends $Command< UpdateIPSetCommandInput, UpdateIPSetCommandOutput, @@ -34,6 +37,9 @@ export class UpdateIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UpdateMemberDetectorsCommand.ts b/clients/client-guardduty/commands/UpdateMemberDetectorsCommand.ts index 8d60dde073654..ffbf36784053a 100644 --- a/clients/client-guardduty/commands/UpdateMemberDetectorsCommand.ts +++ b/clients/client-guardduty/commands/UpdateMemberDetectorsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMemberDetectorsCommandInput = UpdateMemberDetectorsRequest; export type UpdateMemberDetectorsCommandOutput = UpdateMemberDetectorsResponse & __MetadataBearer; +/** + *

Contains information on member accounts to be updated.

+ */ export class UpdateMemberDetectorsCommand extends $Command< UpdateMemberDetectorsCommandInput, UpdateMemberDetectorsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMemberDetectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UpdateOrganizationConfigurationCommand.ts b/clients/client-guardduty/commands/UpdateOrganizationConfigurationCommand.ts index 0ea76cb83e596..95f30281367ef 100644 --- a/clients/client-guardduty/commands/UpdateOrganizationConfigurationCommand.ts +++ b/clients/client-guardduty/commands/UpdateOrganizationConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateOrganizationConfigurationCommandInput = UpdateOrganizationConfigurationRequest; export type UpdateOrganizationConfigurationCommandOutput = UpdateOrganizationConfigurationResponse & __MetadataBearer; +/** + *

Updates the delegated administrator account with the values provided.

+ */ export class UpdateOrganizationConfigurationCommand extends $Command< UpdateOrganizationConfigurationCommandInput, UpdateOrganizationConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateOrganizationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UpdatePublishingDestinationCommand.ts b/clients/client-guardduty/commands/UpdatePublishingDestinationCommand.ts index dfd9998ba7e49..6106794387e2d 100644 --- a/clients/client-guardduty/commands/UpdatePublishingDestinationCommand.ts +++ b/clients/client-guardduty/commands/UpdatePublishingDestinationCommand.ts @@ -20,6 +20,10 @@ import { export type UpdatePublishingDestinationCommandInput = UpdatePublishingDestinationRequest; export type UpdatePublishingDestinationCommandOutput = UpdatePublishingDestinationResponse & __MetadataBearer; +/** + *

Updates information about the publishing destination specified by the + * destinationId.

+ */ export class UpdatePublishingDestinationCommand extends $Command< UpdatePublishingDestinationCommandInput, UpdatePublishingDestinationCommandOutput, @@ -34,6 +38,9 @@ export class UpdatePublishingDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/commands/UpdateThreatIntelSetCommand.ts b/clients/client-guardduty/commands/UpdateThreatIntelSetCommand.ts index 7d5c8043005be..7e2e985968c04 100644 --- a/clients/client-guardduty/commands/UpdateThreatIntelSetCommand.ts +++ b/clients/client-guardduty/commands/UpdateThreatIntelSetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateThreatIntelSetCommandInput = UpdateThreatIntelSetRequest; export type UpdateThreatIntelSetCommandOutput = UpdateThreatIntelSetResponse & __MetadataBearer; +/** + *

Updates the ThreatIntelSet specified by the ThreatIntelSet ID.

+ */ export class UpdateThreatIntelSetCommand extends $Command< UpdateThreatIntelSetCommandInput, UpdateThreatIntelSetCommandOutput, @@ -34,6 +37,9 @@ export class UpdateThreatIntelSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: GuardDutyClientResolvedConfig, diff --git a/clients/client-guardduty/package.json b/clients/client-guardduty/package.json index 160df1af5d956..b009723e6c594 100644 --- a/clients/client-guardduty/package.json +++ b/clients/client-guardduty/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Guardduty Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-guardduty/pagination/GetUsageStatisticsPaginator.ts b/clients/client-guardduty/pagination/GetUsageStatisticsPaginator.ts index 7c1e03670645e..3d6081266ccc3 100644 --- a/clients/client-guardduty/pagination/GetUsageStatisticsPaginator.ts +++ b/clients/client-guardduty/pagination/GetUsageStatisticsPaginator.ts @@ -8,6 +8,9 @@ import { import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: GetUsageStatisticsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetUsageStatisticsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: GetUsageStatisticsCommandInput, diff --git a/clients/client-guardduty/pagination/ListDetectorsPaginator.ts b/clients/client-guardduty/pagination/ListDetectorsPaginator.ts index ce69773fab308..2ea55401217d3 100644 --- a/clients/client-guardduty/pagination/ListDetectorsPaginator.ts +++ b/clients/client-guardduty/pagination/ListDetectorsPaginator.ts @@ -8,6 +8,9 @@ import { import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListDetectorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDetectorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListDetectorsCommandInput, diff --git a/clients/client-guardduty/pagination/ListFiltersPaginator.ts b/clients/client-guardduty/pagination/ListFiltersPaginator.ts index 73d2698030ecc..d142d0e458301 100644 --- a/clients/client-guardduty/pagination/ListFiltersPaginator.ts +++ b/clients/client-guardduty/pagination/ListFiltersPaginator.ts @@ -4,6 +4,9 @@ import { ListFiltersCommand, ListFiltersCommandInput, ListFiltersCommandOutput } import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListFiltersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFiltersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListFiltersCommandInput, diff --git a/clients/client-guardduty/pagination/ListFindingsPaginator.ts b/clients/client-guardduty/pagination/ListFindingsPaginator.ts index a323f990c36b8..bcba6cc5f8596 100644 --- a/clients/client-guardduty/pagination/ListFindingsPaginator.ts +++ b/clients/client-guardduty/pagination/ListFindingsPaginator.ts @@ -8,6 +8,9 @@ import { import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListFindingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFindingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListFindingsCommandInput, diff --git a/clients/client-guardduty/pagination/ListIPSetsPaginator.ts b/clients/client-guardduty/pagination/ListIPSetsPaginator.ts index 271eaffe0ac38..2423522b85506 100644 --- a/clients/client-guardduty/pagination/ListIPSetsPaginator.ts +++ b/clients/client-guardduty/pagination/ListIPSetsPaginator.ts @@ -4,6 +4,9 @@ import { ListIPSetsCommand, ListIPSetsCommandInput, ListIPSetsCommandOutput } fr import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListIPSetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListIPSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListIPSetsCommandInput, diff --git a/clients/client-guardduty/pagination/ListInvitationsPaginator.ts b/clients/client-guardduty/pagination/ListInvitationsPaginator.ts index 99ac86c74f9f7..041abe4cb5fca 100644 --- a/clients/client-guardduty/pagination/ListInvitationsPaginator.ts +++ b/clients/client-guardduty/pagination/ListInvitationsPaginator.ts @@ -8,6 +8,9 @@ import { import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListInvitationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInvitationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListInvitationsCommandInput, diff --git a/clients/client-guardduty/pagination/ListMembersPaginator.ts b/clients/client-guardduty/pagination/ListMembersPaginator.ts index ef4c88fa047c0..123eebc68590d 100644 --- a/clients/client-guardduty/pagination/ListMembersPaginator.ts +++ b/clients/client-guardduty/pagination/ListMembersPaginator.ts @@ -4,6 +4,9 @@ import { ListMembersCommand, ListMembersCommandInput, ListMembersCommandOutput } import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListMembersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMembersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListMembersCommandInput, diff --git a/clients/client-guardduty/pagination/ListOrganizationAdminAccountsPaginator.ts b/clients/client-guardduty/pagination/ListOrganizationAdminAccountsPaginator.ts index 83d36268e677e..6e42dda1d4a65 100644 --- a/clients/client-guardduty/pagination/ListOrganizationAdminAccountsPaginator.ts +++ b/clients/client-guardduty/pagination/ListOrganizationAdminAccountsPaginator.ts @@ -8,6 +8,9 @@ import { import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListOrganizationAdminAccountsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOrganizationAdminAccountsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListOrganizationAdminAccountsCommandInput, diff --git a/clients/client-guardduty/pagination/ListPublishingDestinationsPaginator.ts b/clients/client-guardduty/pagination/ListPublishingDestinationsPaginator.ts index f8c618ba4a755..b9f9f86b64a83 100644 --- a/clients/client-guardduty/pagination/ListPublishingDestinationsPaginator.ts +++ b/clients/client-guardduty/pagination/ListPublishingDestinationsPaginator.ts @@ -8,6 +8,9 @@ import { import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListPublishingDestinationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPublishingDestinationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListPublishingDestinationsCommandInput, diff --git a/clients/client-guardduty/pagination/ListThreatIntelSetsPaginator.ts b/clients/client-guardduty/pagination/ListThreatIntelSetsPaginator.ts index 0e3d2c8250a39..1e08f51d28095 100644 --- a/clients/client-guardduty/pagination/ListThreatIntelSetsPaginator.ts +++ b/clients/client-guardduty/pagination/ListThreatIntelSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { GuardDutyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: GuardDutyClient, input: ListThreatIntelSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThreatIntelSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: GuardDuty, input: ListThreatIntelSetsCommandInput, diff --git a/clients/client-guardduty/runtimeConfig.browser.ts b/clients/client-guardduty/runtimeConfig.browser.ts index 71d969a430793..3682a7c2f51b3 100644 --- a/clients/client-guardduty/runtimeConfig.browser.ts +++ b/clients/client-guardduty/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./GuardDutyClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-guardduty/runtimeConfig.native.ts b/clients/client-guardduty/runtimeConfig.native.ts index 0f30b64c32427..e17adf04da27d 100644 --- a/clients/client-guardduty/runtimeConfig.native.ts +++ b/clients/client-guardduty/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./GuardDutyClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-guardduty/runtimeConfig.shared.ts b/clients/client-guardduty/runtimeConfig.shared.ts index 0b989ef332f3c..854298e6c8a82 100644 --- a/clients/client-guardduty/runtimeConfig.shared.ts +++ b/clients/client-guardduty/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-11-28", disableHostPrefix: false, diff --git a/clients/client-guardduty/runtimeConfig.ts b/clients/client-guardduty/runtimeConfig.ts index b820f895047e4..fd1af1067c3eb 100644 --- a/clients/client-guardduty/runtimeConfig.ts +++ b/clients/client-guardduty/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./GuardDutyClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-guardduty/tsconfig.json b/clients/client-guardduty/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-guardduty/tsconfig.json +++ b/clients/client-guardduty/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-health/commands/DescribeAffectedAccountsForOrganizationCommand.ts b/clients/client-health/commands/DescribeAffectedAccountsForOrganizationCommand.ts index 1f4b2632e2d81..18f8406954cd7 100644 --- a/clients/client-health/commands/DescribeAffectedAccountsForOrganizationCommand.ts +++ b/clients/client-health/commands/DescribeAffectedAccountsForOrganizationCommand.ts @@ -24,6 +24,18 @@ export type DescribeAffectedAccountsForOrganizationCommandInput = DescribeAffect export type DescribeAffectedAccountsForOrganizationCommandOutput = DescribeAffectedAccountsForOrganizationResponse & __MetadataBearer; +/** + *

Returns a list of accounts in the organization from AWS Organizations that are affected by the + * provided event. For more information about the different types of AWS Health events, see + * Event.

+ *

Before you can call this operation, you must first enable AWS Health to work with + * AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization + * operation from your organization's master account.

+ * + * + *

This API operation uses pagination. Specify the nextToken parameter in the next request to return more results.

+ *
+ */ export class DescribeAffectedAccountsForOrganizationCommand extends $Command< DescribeAffectedAccountsForOrganizationCommandInput, DescribeAffectedAccountsForOrganizationCommandOutput, @@ -38,6 +50,9 @@ export class DescribeAffectedAccountsForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeAffectedEntitiesCommand.ts b/clients/client-health/commands/DescribeAffectedEntitiesCommand.ts index 3445b7af58418..529fde064efde 100644 --- a/clients/client-health/commands/DescribeAffectedEntitiesCommand.ts +++ b/clients/client-health/commands/DescribeAffectedEntitiesCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeAffectedEntitiesCommandInput = DescribeAffectedEntitiesRequest; export type DescribeAffectedEntitiesCommandOutput = DescribeAffectedEntitiesResponse & __MetadataBearer; +/** + *

Returns a list of entities that have been affected by the specified events, based on the + * specified filter criteria. Entities can refer to individual customer resources, groups of + * customer resources, or any other construct, depending on the AWS service. Events that have + * impact beyond that of the affected entities, or where the extent of impact is unknown, + * include at least one entity indicating this.

+ *

At least one event ARN is required. Results are sorted by the + * lastUpdatedTime of the entity, starting with the most recent.

+ * + * + *

This API operation uses pagination. Specify the nextToken parameter in the next request to return more results.

+ *
+ */ export class DescribeAffectedEntitiesCommand extends $Command< DescribeAffectedEntitiesCommandInput, DescribeAffectedEntitiesCommandOutput, @@ -34,6 +47,9 @@ export class DescribeAffectedEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeAffectedEntitiesForOrganizationCommand.ts b/clients/client-health/commands/DescribeAffectedEntitiesForOrganizationCommand.ts index 6f900604264f5..9da5aa333dd41 100644 --- a/clients/client-health/commands/DescribeAffectedEntitiesForOrganizationCommand.ts +++ b/clients/client-health/commands/DescribeAffectedEntitiesForOrganizationCommand.ts @@ -24,6 +24,21 @@ export type DescribeAffectedEntitiesForOrganizationCommandInput = DescribeAffect export type DescribeAffectedEntitiesForOrganizationCommandOutput = DescribeAffectedEntitiesForOrganizationResponse & __MetadataBearer; +/** + *

Returns a list of entities that have been affected by one or more events for one or more + * accounts in your organization in AWS Organizations, based on the filter criteria. Entities can refer + * to individual customer resources, groups of customer resources, or any other construct, + * depending on the AWS service.

+ *

At least one event Amazon Resource Name (ARN) and account ID are required. Results are + * sorted by the lastUpdatedTime of the entity, starting with the most + * recent.

+ *

Before you can call this operation, you must first enable AWS Health to work with + * AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization + * operation from your organization's master account.

+ * + *

This API operation uses pagination. Specify the nextToken parameter in the next request to return more results.

+ *
+ */ export class DescribeAffectedEntitiesForOrganizationCommand extends $Command< DescribeAffectedEntitiesForOrganizationCommandInput, DescribeAffectedEntitiesForOrganizationCommandOutput, @@ -38,6 +53,9 @@ export class DescribeAffectedEntitiesForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeEntityAggregatesCommand.ts b/clients/client-health/commands/DescribeEntityAggregatesCommand.ts index deb612e001273..77335bebd8817 100644 --- a/clients/client-health/commands/DescribeEntityAggregatesCommand.ts +++ b/clients/client-health/commands/DescribeEntityAggregatesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEntityAggregatesCommandInput = DescribeEntityAggregatesRequest; export type DescribeEntityAggregatesCommandOutput = DescribeEntityAggregatesResponse & __MetadataBearer; +/** + *

Returns the number of entities that are affected by each of the specified events. If no + * events are specified, the counts of all affected entities are returned.

+ */ export class DescribeEntityAggregatesCommand extends $Command< DescribeEntityAggregatesCommandInput, DescribeEntityAggregatesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEntityAggregatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeEventAggregatesCommand.ts b/clients/client-health/commands/DescribeEventAggregatesCommand.ts index 2794f2384d3f7..b6d5bae49a6e6 100644 --- a/clients/client-health/commands/DescribeEventAggregatesCommand.ts +++ b/clients/client-health/commands/DescribeEventAggregatesCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeEventAggregatesCommandInput = DescribeEventAggregatesRequest; export type DescribeEventAggregatesCommandOutput = DescribeEventAggregatesResponse & __MetadataBearer; +/** + *

Returns the number of events of each event type (issue, scheduled change, and account + * notification). If no filter is specified, the counts of all events in each category are + * returned.

+ * + * + *

This API operation uses pagination. Specify the nextToken parameter in the next request to return more results.

+ *
+ */ export class DescribeEventAggregatesCommand extends $Command< DescribeEventAggregatesCommandInput, DescribeEventAggregatesCommandOutput, @@ -34,6 +43,9 @@ export class DescribeEventAggregatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeEventDetailsCommand.ts b/clients/client-health/commands/DescribeEventDetailsCommand.ts index dd44cb6c4a8ee..5707f3d7f98fa 100644 --- a/clients/client-health/commands/DescribeEventDetailsCommand.ts +++ b/clients/client-health/commands/DescribeEventDetailsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeEventDetailsCommandInput = DescribeEventDetailsRequest; export type DescribeEventDetailsCommandOutput = DescribeEventDetailsResponse & __MetadataBearer; +/** + *

Returns detailed information about one or more specified events. Information includes + * standard event data (Region, service, and so on, as returned by DescribeEvents), a + * detailed event description, and possible additional metadata that depends upon the nature + * of the event. Affected entities are not included. To retrieve those, use the DescribeAffectedEntities operation.

+ *

If a specified event cannot be retrieved, an error message is returned for that + * event.

+ */ export class DescribeEventDetailsCommand extends $Command< DescribeEventDetailsCommandInput, DescribeEventDetailsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeEventDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeEventDetailsForOrganizationCommand.ts b/clients/client-health/commands/DescribeEventDetailsForOrganizationCommand.ts index e6db5c4d8a8ec..c3d1f4e11813c 100644 --- a/clients/client-health/commands/DescribeEventDetailsForOrganizationCommand.ts +++ b/clients/client-health/commands/DescribeEventDetailsForOrganizationCommand.ts @@ -24,6 +24,34 @@ export type DescribeEventDetailsForOrganizationCommandInput = DescribeEventDetai export type DescribeEventDetailsForOrganizationCommandOutput = DescribeEventDetailsForOrganizationResponse & __MetadataBearer; +/** + *

Returns detailed information about one or more specified events for one or more accounts + * in your organization. Information includes standard event data (Region, service, and so on, + * as returned by DescribeEventsForOrganization), a detailed event description, and possible + * additional metadata that depends upon the nature of the event. Affected entities are not + * included; to retrieve those, use the DescribeAffectedEntitiesForOrganization operation.

+ *

Before you can call this operation, you must first enable AWS Health to work with + * AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization + * operation from your organization's master account.

+ *

When you call the DescribeEventDetailsForOrganization operation, you + * specify the organizationEventDetailFilters object in the request. Depending on + * the AWS Health event type, note the following differences:

+ *
    + *
  • + *

    If the event is public, the awsAccountId parameter must be empty. If + * you specify an account ID for a public event, then an error message is returned. + * That's because the event might apply to all AWS accounts and isn't specific to an + * account in your organization.

    + *
  • + *
  • + *

    If the event is specific to an account, then you must specify the + * awsAccountId parameter in the request. If you don't specify an + * account ID, an error message returns because the event is specific to an AWS + * account in your organization.

    + *
  • + *
+ *

For more information, see Event.

+ */ export class DescribeEventDetailsForOrganizationCommand extends $Command< DescribeEventDetailsForOrganizationCommandInput, DescribeEventDetailsForOrganizationCommandOutput, @@ -38,6 +66,9 @@ export class DescribeEventDetailsForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeEventTypesCommand.ts b/clients/client-health/commands/DescribeEventTypesCommand.ts index 099a08f2d1a6b..bf045b2717842 100644 --- a/clients/client-health/commands/DescribeEventTypesCommand.ts +++ b/clients/client-health/commands/DescribeEventTypesCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeEventTypesCommandInput = DescribeEventTypesRequest; export type DescribeEventTypesCommandOutput = DescribeEventTypesResponse & __MetadataBearer; +/** + *

Returns the event types that meet the specified filter criteria. If no filter criteria + * are specified, all event types are returned, in no particular order.

+ * + * + *

This API operation uses pagination. Specify the nextToken parameter in the next request to return more results.

+ *
+ */ export class DescribeEventTypesCommand extends $Command< DescribeEventTypesCommandInput, DescribeEventTypesCommandOutput, @@ -34,6 +42,9 @@ export class DescribeEventTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeEventsCommand.ts b/clients/client-health/commands/DescribeEventsCommand.ts index 9f4c00d60c61f..399be25513911 100644 --- a/clients/client-health/commands/DescribeEventsCommand.ts +++ b/clients/client-health/commands/DescribeEventsCommand.ts @@ -20,6 +20,32 @@ import { export type DescribeEventsCommandInput = DescribeEventsRequest; export type DescribeEventsCommandOutput = DescribeEventsResponse & __MetadataBearer; +/** + *

Returns information about events that meet the specified filter criteria. Events are + * returned in a summary form and do not include the detailed description, any additional + * metadata that depends on the event type, or any affected resources. To retrieve that + * information, use the DescribeEventDetails and DescribeAffectedEntities operations.

+ *

If no filter criteria are specified, all events are returned. Results are sorted by + * lastModifiedTime, starting with the most recent event.

+ * + *
    + *
  • + *

    When you call the DescribeEvents operation and specify an entity for the + * entityValues parameter, AWS Health might return public events that + * aren't specific to that resource. For example, if you call DescribeEvents + * and specify an ID for an Amazon Elastic Compute Cloud (Amazon EC2) instance, AWS Health might return events + * that aren't specific to that resource or service. To get events that are specific to a + * service, use the services parameter in the filter object. For + * more information, see Event.

    + *
  • + *
  • + *

    This API operation uses pagination. Specify the nextToken parameter in the next request to return more results.

    + *
  • + *
+ * + * + *
+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +60,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeEventsForOrganizationCommand.ts b/clients/client-health/commands/DescribeEventsForOrganizationCommand.ts index a92a37e8b95c5..d612c76ebb4a3 100644 --- a/clients/client-health/commands/DescribeEventsForOrganizationCommand.ts +++ b/clients/client-health/commands/DescribeEventsForOrganizationCommand.ts @@ -20,6 +20,40 @@ import { export type DescribeEventsForOrganizationCommandInput = DescribeEventsForOrganizationRequest; export type DescribeEventsForOrganizationCommandOutput = DescribeEventsForOrganizationResponse & __MetadataBearer; +/** + *

Returns information about events across your organization in AWS Organizations. You can use + * thefilters parameter to specify the events that you want to return. Events + * are returned in a summary form and don't include the affected accounts, detailed + * description, any additional metadata that depends on the event type, or any affected + * resources. To retrieve that information, use the following operations:

+ * + *

If you don't specify a filter, the + * DescribeEventsForOrganizations returns all events across your organization. + * Results are sorted by lastModifiedTime, starting with the most recent event.

+ *

For more information about the different types of AWS Health events, see Event.

+ *

Before you can call this operation, you must first enable AWS Health to work with + * AWS Organizations. To do this, call the EnableHealthServiceAccessForOrganization operation from your organization's + * master AWS account.

+ * + *

This API operation uses pagination. Specify the nextToken parameter in the next request to return more results.

+ *
+ */ export class DescribeEventsForOrganizationCommand extends $Command< DescribeEventsForOrganizationCommandInput, DescribeEventsForOrganizationCommandOutput, @@ -34,6 +68,9 @@ export class DescribeEventsForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DescribeHealthServiceStatusForOrganizationCommand.ts b/clients/client-health/commands/DescribeHealthServiceStatusForOrganizationCommand.ts index 26af65a476104..17d6710a6214f 100644 --- a/clients/client-health/commands/DescribeHealthServiceStatusForOrganizationCommand.ts +++ b/clients/client-health/commands/DescribeHealthServiceStatusForOrganizationCommand.ts @@ -21,6 +21,12 @@ export type DescribeHealthServiceStatusForOrganizationCommandInput = {}; export type DescribeHealthServiceStatusForOrganizationCommandOutput = DescribeHealthServiceStatusForOrganizationResponse & __MetadataBearer; +/** + *

This operation provides status information on enabling or disabling AWS Health to work + * with your organization. To call this operation, you must sign in as an IAM user, assume + * an IAM role, or sign in as the root user (not recommended) in the organization's master + * account.

+ */ export class DescribeHealthServiceStatusForOrganizationCommand extends $Command< DescribeHealthServiceStatusForOrganizationCommandInput, DescribeHealthServiceStatusForOrganizationCommandOutput, @@ -35,6 +41,9 @@ export class DescribeHealthServiceStatusForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/DisableHealthServiceAccessForOrganizationCommand.ts b/clients/client-health/commands/DisableHealthServiceAccessForOrganizationCommand.ts index c96b21343a652..adcb917ba7c2f 100644 --- a/clients/client-health/commands/DisableHealthServiceAccessForOrganizationCommand.ts +++ b/clients/client-health/commands/DisableHealthServiceAccessForOrganizationCommand.ts @@ -19,6 +19,24 @@ import { export type DisableHealthServiceAccessForOrganizationCommandInput = {}; export type DisableHealthServiceAccessForOrganizationCommandOutput = __MetadataBearer; +/** + *

Disables AWS Health from working with AWS Organizations. To call this operation, you must sign + * in as an AWS Identity and Access Management (IAM) user, assume an IAM role, or sign in as the root user (not + * recommended) in the organization's master AWS account. For more information, see Aggregating + * AWS Health events in the + * AWS Health User Guide.

+ *

This operation doesn't remove the service-linked role (SLR) from the AWS master + * account in your organization. You must use the IAM console, API, or AWS Command Line Interface (AWS CLI) to + * remove the SLR. For more information, see Deleting a Service-Linked Role in the + * IAM User Guide.

+ * + *

You can also disable the organizational feature by using the Organizations DisableAWSServiceAccess API operation. After you call this operation, + * AWS Health stops aggregating events for all other AWS accounts in your organization. + * If you call the AWS Health API operations for organizational view, AWS Health returns + * an error. AWS Health continues to aggregate health events for your AWS + * account.

+ *
+ */ export class DisableHealthServiceAccessForOrganizationCommand extends $Command< DisableHealthServiceAccessForOrganizationCommandInput, DisableHealthServiceAccessForOrganizationCommandOutput, @@ -33,6 +51,9 @@ export class DisableHealthServiceAccessForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/commands/EnableHealthServiceAccessForOrganizationCommand.ts b/clients/client-health/commands/EnableHealthServiceAccessForOrganizationCommand.ts index a4fb76f762f1e..b5b4e446e9bd1 100644 --- a/clients/client-health/commands/EnableHealthServiceAccessForOrganizationCommand.ts +++ b/clients/client-health/commands/EnableHealthServiceAccessForOrganizationCommand.ts @@ -19,6 +19,14 @@ import { export type EnableHealthServiceAccessForOrganizationCommandInput = {}; export type EnableHealthServiceAccessForOrganizationCommandOutput = __MetadataBearer; +/** + *

Calling this operation enables AWS Health to work with AWS Organizations. This applies a + * service-linked role (SLR) to the master account in the organization. To call this + * operation, you must sign in as an IAM user, assume an IAM role, or sign in as the root + * user (not recommended) in the organization's master account.

+ *

For more information, see Aggregating AWS Health events in the AWS Health User + * Guide.

+ */ export class EnableHealthServiceAccessForOrganizationCommand extends $Command< EnableHealthServiceAccessForOrganizationCommandInput, EnableHealthServiceAccessForOrganizationCommandOutput, @@ -33,6 +41,9 @@ export class EnableHealthServiceAccessForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HealthClientResolvedConfig, diff --git a/clients/client-health/package.json b/clients/client-health/package.json index 6f63a491bac5f..24c88b852120a 100644 --- a/clients/client-health/package.json +++ b/clients/client-health/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Health Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-health/pagination/DescribeAffectedAccountsForOrganizationPaginator.ts b/clients/client-health/pagination/DescribeAffectedAccountsForOrganizationPaginator.ts index 38ced66a57fcd..10c476ae580ed 100644 --- a/clients/client-health/pagination/DescribeAffectedAccountsForOrganizationPaginator.ts +++ b/clients/client-health/pagination/DescribeAffectedAccountsForOrganizationPaginator.ts @@ -8,6 +8,9 @@ import { import { HealthPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: HealthClient, input: DescribeAffectedAccountsForOrganizationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAffectedAccountsForOrganizationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Health, input: DescribeAffectedAccountsForOrganizationCommandInput, diff --git a/clients/client-health/pagination/DescribeAffectedEntitiesForOrganizationPaginator.ts b/clients/client-health/pagination/DescribeAffectedEntitiesForOrganizationPaginator.ts index 767f4a25a31c9..85f6d5076d18c 100644 --- a/clients/client-health/pagination/DescribeAffectedEntitiesForOrganizationPaginator.ts +++ b/clients/client-health/pagination/DescribeAffectedEntitiesForOrganizationPaginator.ts @@ -8,6 +8,9 @@ import { import { HealthPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: HealthClient, input: DescribeAffectedEntitiesForOrganizationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAffectedEntitiesForOrganizationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Health, input: DescribeAffectedEntitiesForOrganizationCommandInput, diff --git a/clients/client-health/pagination/DescribeAffectedEntitiesPaginator.ts b/clients/client-health/pagination/DescribeAffectedEntitiesPaginator.ts index 943ea27fd1618..12c053ff73668 100644 --- a/clients/client-health/pagination/DescribeAffectedEntitiesPaginator.ts +++ b/clients/client-health/pagination/DescribeAffectedEntitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { HealthPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: HealthClient, input: DescribeAffectedEntitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAffectedEntitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Health, input: DescribeAffectedEntitiesCommandInput, diff --git a/clients/client-health/pagination/DescribeEventAggregatesPaginator.ts b/clients/client-health/pagination/DescribeEventAggregatesPaginator.ts index aed4fc3f77444..0982773c5ec3a 100644 --- a/clients/client-health/pagination/DescribeEventAggregatesPaginator.ts +++ b/clients/client-health/pagination/DescribeEventAggregatesPaginator.ts @@ -8,6 +8,9 @@ import { import { HealthPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: HealthClient, input: DescribeEventAggregatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventAggregatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Health, input: DescribeEventAggregatesCommandInput, diff --git a/clients/client-health/pagination/DescribeEventTypesPaginator.ts b/clients/client-health/pagination/DescribeEventTypesPaginator.ts index 1e4172d540cac..682de5aed161d 100644 --- a/clients/client-health/pagination/DescribeEventTypesPaginator.ts +++ b/clients/client-health/pagination/DescribeEventTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { HealthPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: HealthClient, input: DescribeEventTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Health, input: DescribeEventTypesCommandInput, diff --git a/clients/client-health/pagination/DescribeEventsForOrganizationPaginator.ts b/clients/client-health/pagination/DescribeEventsForOrganizationPaginator.ts index 0b1b89175557e..49191922f064a 100644 --- a/clients/client-health/pagination/DescribeEventsForOrganizationPaginator.ts +++ b/clients/client-health/pagination/DescribeEventsForOrganizationPaginator.ts @@ -8,6 +8,9 @@ import { import { HealthPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: HealthClient, input: DescribeEventsForOrganizationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsForOrganizationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Health, input: DescribeEventsForOrganizationCommandInput, diff --git a/clients/client-health/pagination/DescribeEventsPaginator.ts b/clients/client-health/pagination/DescribeEventsPaginator.ts index be63c2389e9ee..ae6e443d36ed1 100644 --- a/clients/client-health/pagination/DescribeEventsPaginator.ts +++ b/clients/client-health/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { HealthPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: HealthClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Health, input: DescribeEventsCommandInput, diff --git a/clients/client-health/runtimeConfig.browser.ts b/clients/client-health/runtimeConfig.browser.ts index 5561e6b091244..5376b3e1377b9 100644 --- a/clients/client-health/runtimeConfig.browser.ts +++ b/clients/client-health/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./HealthClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-health/runtimeConfig.native.ts b/clients/client-health/runtimeConfig.native.ts index f22065eecf3c7..6abcd5288a07d 100644 --- a/clients/client-health/runtimeConfig.native.ts +++ b/clients/client-health/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./HealthClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-health/runtimeConfig.shared.ts b/clients/client-health/runtimeConfig.shared.ts index 10b2c25b19109..c7bbe880bd8fd 100644 --- a/clients/client-health/runtimeConfig.shared.ts +++ b/clients/client-health/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-08-04", disableHostPrefix: false, diff --git a/clients/client-health/runtimeConfig.ts b/clients/client-health/runtimeConfig.ts index eced86c66d652..4674df4347074 100644 --- a/clients/client-health/runtimeConfig.ts +++ b/clients/client-health/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./HealthClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-health/tsconfig.json b/clients/client-health/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-health/tsconfig.json +++ b/clients/client-health/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-honeycode/commands/GetScreenDataCommand.ts b/clients/client-honeycode/commands/GetScreenDataCommand.ts index 1fe0aac2f7914..c77e8c039ef84 100644 --- a/clients/client-honeycode/commands/GetScreenDataCommand.ts +++ b/clients/client-honeycode/commands/GetScreenDataCommand.ts @@ -20,6 +20,13 @@ import { export type GetScreenDataCommandInput = GetScreenDataRequest; export type GetScreenDataCommandOutput = GetScreenDataResult & __MetadataBearer; +/** + *

+ * The GetScreenData API allows retrieval of data from a screen in a Honeycode app. + * The API allows setting local variables in the screen to filter, sort or otherwise affect what will be + * displayed on the screen. + *

+ */ export class GetScreenDataCommand extends $Command< GetScreenDataCommandInput, GetScreenDataCommandOutput, @@ -34,6 +41,9 @@ export class GetScreenDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HoneycodeClientResolvedConfig, diff --git a/clients/client-honeycode/commands/InvokeScreenAutomationCommand.ts b/clients/client-honeycode/commands/InvokeScreenAutomationCommand.ts index 941439af45e55..7b82559390205 100644 --- a/clients/client-honeycode/commands/InvokeScreenAutomationCommand.ts +++ b/clients/client-honeycode/commands/InvokeScreenAutomationCommand.ts @@ -20,6 +20,13 @@ import { export type InvokeScreenAutomationCommandInput = InvokeScreenAutomationRequest; export type InvokeScreenAutomationCommandOutput = InvokeScreenAutomationResult & __MetadataBearer; +/** + *

+ * The InvokeScreenAutomation API allows invoking an action defined in a screen in a Honeycode app. + * The API allows setting local variables, which can then be used in the automation being invoked. + * This allows automating the Honeycode app interactions to write, update or delete data in the workbook. + *

+ */ export class InvokeScreenAutomationCommand extends $Command< InvokeScreenAutomationCommandInput, InvokeScreenAutomationCommandOutput, @@ -34,6 +41,9 @@ export class InvokeScreenAutomationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: HoneycodeClientResolvedConfig, diff --git a/clients/client-honeycode/package.json b/clients/client-honeycode/package.json index 942b492841801..b87591eea8f68 100644 --- a/clients/client-honeycode/package.json +++ b/clients/client-honeycode/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Honeycode Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-honeycode/runtimeConfig.browser.ts b/clients/client-honeycode/runtimeConfig.browser.ts index d3c800225b42d..fbf853594aba8 100644 --- a/clients/client-honeycode/runtimeConfig.browser.ts +++ b/clients/client-honeycode/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./HoneycodeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-honeycode/runtimeConfig.native.ts b/clients/client-honeycode/runtimeConfig.native.ts index 7c7a79f3e0545..44dbb946ab270 100644 --- a/clients/client-honeycode/runtimeConfig.native.ts +++ b/clients/client-honeycode/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./HoneycodeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-honeycode/runtimeConfig.shared.ts b/clients/client-honeycode/runtimeConfig.shared.ts index 54170c1420210..afb8f12c1181c 100644 --- a/clients/client-honeycode/runtimeConfig.shared.ts +++ b/clients/client-honeycode/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-03-01", disableHostPrefix: false, diff --git a/clients/client-honeycode/runtimeConfig.ts b/clients/client-honeycode/runtimeConfig.ts index 266b7ad3966bc..7bb6c92a8d222 100644 --- a/clients/client-honeycode/runtimeConfig.ts +++ b/clients/client-honeycode/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./HoneycodeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-honeycode/tsconfig.json b/clients/client-honeycode/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-honeycode/tsconfig.json +++ b/clients/client-honeycode/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iam/commands/AddClientIDToOpenIDConnectProviderCommand.ts b/clients/client-iam/commands/AddClientIDToOpenIDConnectProviderCommand.ts index e78a75b81c60f..cd9d934669932 100644 --- a/clients/client-iam/commands/AddClientIDToOpenIDConnectProviderCommand.ts +++ b/clients/client-iam/commands/AddClientIDToOpenIDConnectProviderCommand.ts @@ -20,6 +20,12 @@ import { export type AddClientIDToOpenIDConnectProviderCommandInput = AddClientIDToOpenIDConnectProviderRequest; export type AddClientIDToOpenIDConnectProviderCommandOutput = __MetadataBearer; +/** + *

Adds a new client ID (also known as audience) to the list of client IDs already + * registered for the specified IAM OpenID Connect (OIDC) provider resource.

+ *

This operation is idempotent; it does not fail or return an error if you add an existing + * client ID to the provider.

+ */ export class AddClientIDToOpenIDConnectProviderCommand extends $Command< AddClientIDToOpenIDConnectProviderCommandInput, AddClientIDToOpenIDConnectProviderCommandOutput, @@ -34,6 +40,9 @@ export class AddClientIDToOpenIDConnectProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/AddRoleToInstanceProfileCommand.ts b/clients/client-iam/commands/AddRoleToInstanceProfileCommand.ts index f1100ac6d8047..2093cb68193e5 100644 --- a/clients/client-iam/commands/AddRoleToInstanceProfileCommand.ts +++ b/clients/client-iam/commands/AddRoleToInstanceProfileCommand.ts @@ -20,6 +20,21 @@ import { export type AddRoleToInstanceProfileCommandInput = AddRoleToInstanceProfileRequest; export type AddRoleToInstanceProfileCommandOutput = __MetadataBearer; +/** + *

Adds the specified IAM role to the specified instance profile. An instance profile can + * contain only one role. (The number and size of IAM resources in an AWS account are limited. For more information, see IAM and STS Quotas in the IAM User Guide.) You can remove the existing role + * and then add a different role to an instance profile. You must then wait for the change to + * appear across all of AWS because of eventual consistency. + * To force the change, you must disassociate + * the instance profile and then associate the + * instance profile, or you can stop your instance and then restart it.

+ * + *

The caller of this API must be granted the PassRole permission on the + * IAM role by a permissions policy.

+ *
+ *

For more information about roles, go to Working with Roles. For more + * information about instance profiles, go to About Instance Profiles.

+ */ export class AddRoleToInstanceProfileCommand extends $Command< AddRoleToInstanceProfileCommandInput, AddRoleToInstanceProfileCommandOutput, @@ -34,6 +49,9 @@ export class AddRoleToInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/AddUserToGroupCommand.ts b/clients/client-iam/commands/AddUserToGroupCommand.ts index 8cfe74178fcb7..b0dd314d0db31 100644 --- a/clients/client-iam/commands/AddUserToGroupCommand.ts +++ b/clients/client-iam/commands/AddUserToGroupCommand.ts @@ -20,6 +20,9 @@ import { export type AddUserToGroupCommandInput = AddUserToGroupRequest; export type AddUserToGroupCommandOutput = __MetadataBearer; +/** + *

Adds the specified user to the specified group.

+ */ export class AddUserToGroupCommand extends $Command< AddUserToGroupCommandInput, AddUserToGroupCommandOutput, @@ -34,6 +37,9 @@ export class AddUserToGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/AttachGroupPolicyCommand.ts b/clients/client-iam/commands/AttachGroupPolicyCommand.ts index 64901dcf1db9b..a0497e8697056 100644 --- a/clients/client-iam/commands/AttachGroupPolicyCommand.ts +++ b/clients/client-iam/commands/AttachGroupPolicyCommand.ts @@ -20,6 +20,13 @@ import { export type AttachGroupPolicyCommandInput = AttachGroupPolicyRequest; export type AttachGroupPolicyCommandOutput = __MetadataBearer; +/** + *

Attaches the specified managed policy to the specified IAM group.

+ *

You use this API to attach a managed policy to a group. To embed an inline policy in a + * group, use PutGroupPolicy.

+ *

For more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class AttachGroupPolicyCommand extends $Command< AttachGroupPolicyCommandInput, AttachGroupPolicyCommandOutput, @@ -34,6 +41,9 @@ export class AttachGroupPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/AttachRolePolicyCommand.ts b/clients/client-iam/commands/AttachRolePolicyCommand.ts index 7d6e243c56e54..e600542217e5d 100644 --- a/clients/client-iam/commands/AttachRolePolicyCommand.ts +++ b/clients/client-iam/commands/AttachRolePolicyCommand.ts @@ -20,6 +20,20 @@ import { export type AttachRolePolicyCommandInput = AttachRolePolicyRequest; export type AttachRolePolicyCommandOutput = __MetadataBearer; +/** + *

Attaches the specified managed policy to the specified IAM role. When you attach a + * managed policy to a role, the managed policy becomes part of the role's permission (access) + * policy.

+ * + *

You cannot use a managed policy as the role's trust policy. The role's trust policy + * is created at the same time as the role, using CreateRole. You can + * update a role's trust policy using UpdateAssumeRolePolicy.

+ *
+ *

Use this API to attach a managed policy to a role. To embed an + * inline policy in a role, use PutRolePolicy. For more information about + * policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class AttachRolePolicyCommand extends $Command< AttachRolePolicyCommandInput, AttachRolePolicyCommandOutput, @@ -34,6 +48,9 @@ export class AttachRolePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/AttachUserPolicyCommand.ts b/clients/client-iam/commands/AttachUserPolicyCommand.ts index a61e7efdc4be1..2f16f413aba77 100644 --- a/clients/client-iam/commands/AttachUserPolicyCommand.ts +++ b/clients/client-iam/commands/AttachUserPolicyCommand.ts @@ -20,6 +20,13 @@ import { export type AttachUserPolicyCommandInput = AttachUserPolicyRequest; export type AttachUserPolicyCommandOutput = __MetadataBearer; +/** + *

Attaches the specified managed policy to the specified user.

+ *

You use this API to attach a managed policy to a user. To embed an + * inline policy in a user, use PutUserPolicy.

+ *

For more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class AttachUserPolicyCommand extends $Command< AttachUserPolicyCommandInput, AttachUserPolicyCommandOutput, @@ -34,6 +41,9 @@ export class AttachUserPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ChangePasswordCommand.ts b/clients/client-iam/commands/ChangePasswordCommand.ts index 5e8ca9a5070f8..cad872648c56e 100644 --- a/clients/client-iam/commands/ChangePasswordCommand.ts +++ b/clients/client-iam/commands/ChangePasswordCommand.ts @@ -20,6 +20,13 @@ import { export type ChangePasswordCommandInput = ChangePasswordRequest; export type ChangePasswordCommandOutput = __MetadataBearer; +/** + *

Changes the password of the IAM user who is calling this operation. The AWS account + * root user password is not affected by this operation.

+ *

To change the password for a different user, see UpdateLoginProfile. + * For more information about modifying passwords, see Managing Passwords in the + * IAM User Guide.

+ */ export class ChangePasswordCommand extends $Command< ChangePasswordCommandInput, ChangePasswordCommandOutput, @@ -34,6 +41,9 @@ export class ChangePasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateAccessKeyCommand.ts b/clients/client-iam/commands/CreateAccessKeyCommand.ts index 301804d8a5f83..2c078aeed2858 100644 --- a/clients/client-iam/commands/CreateAccessKeyCommand.ts +++ b/clients/client-iam/commands/CreateAccessKeyCommand.ts @@ -20,6 +20,21 @@ import { export type CreateAccessKeyCommandInput = CreateAccessKeyRequest; export type CreateAccessKeyCommandOutput = CreateAccessKeyResponse & __MetadataBearer; +/** + *

Creates a new AWS secret access key and corresponding AWS access key ID for the + * specified user. The default status for new keys is Active.

+ *

If you do not specify a user name, IAM determines the user name implicitly based on + * the AWS access key ID signing the request. This operation works for access keys under the + * AWS account. Consequently, you can use this operation to manage AWS account root user + * credentials. This is true even if the AWS account has no associated users.

+ *

The number and size of IAM resources in an AWS account are limited. For more information, see IAM and STS Quotas in the IAM User Guide.

+ * + *

To ensure the security of your AWS account, the secret access key is accessible + * only during key and user creation. You must save the key (for example, in a text file) + * if you want to be able to access it again. If a secret key is lost, you can delete the + * access keys for the associated user and then create new keys.

+ *
+ */ export class CreateAccessKeyCommand extends $Command< CreateAccessKeyCommandInput, CreateAccessKeyCommandOutput, @@ -34,6 +49,9 @@ export class CreateAccessKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateAccountAliasCommand.ts b/clients/client-iam/commands/CreateAccountAliasCommand.ts index f6bb37e33ffbb..c3cbad5c90ff8 100644 --- a/clients/client-iam/commands/CreateAccountAliasCommand.ts +++ b/clients/client-iam/commands/CreateAccountAliasCommand.ts @@ -20,6 +20,12 @@ import { export type CreateAccountAliasCommandInput = CreateAccountAliasRequest; export type CreateAccountAliasCommandOutput = __MetadataBearer; +/** + *

Creates an alias for your AWS account. For information about using an AWS account + * alias, see Using an + * Alias for Your AWS Account ID in the + * IAM User Guide.

+ */ export class CreateAccountAliasCommand extends $Command< CreateAccountAliasCommandInput, CreateAccountAliasCommandOutput, @@ -34,6 +40,9 @@ export class CreateAccountAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateGroupCommand.ts b/clients/client-iam/commands/CreateGroupCommand.ts index 29c5582017ffa..773323b7a15d1 100644 --- a/clients/client-iam/commands/CreateGroupCommand.ts +++ b/clients/client-iam/commands/CreateGroupCommand.ts @@ -17,6 +17,10 @@ import { export type CreateGroupCommandInput = CreateGroupRequest; export type CreateGroupCommandOutput = CreateGroupResponse & __MetadataBearer; +/** + *

Creates a new group.

+ *

The number and size of IAM resources in an AWS account are limited. For more information, see IAM and STS Quotas in the IAM User Guide.

+ */ export class CreateGroupCommand extends $Command< CreateGroupCommandInput, CreateGroupCommandOutput, @@ -31,6 +35,9 @@ export class CreateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateInstanceProfileCommand.ts b/clients/client-iam/commands/CreateInstanceProfileCommand.ts index 4e47b49a44671..399568a959387 100644 --- a/clients/client-iam/commands/CreateInstanceProfileCommand.ts +++ b/clients/client-iam/commands/CreateInstanceProfileCommand.ts @@ -20,6 +20,11 @@ import { export type CreateInstanceProfileCommandInput = CreateInstanceProfileRequest; export type CreateInstanceProfileCommandOutput = CreateInstanceProfileResponse & __MetadataBearer; +/** + *

Creates a new instance profile. For information about instance profiles, go to About Instance + * Profiles.

+ *

The number and size of IAM resources in an AWS account are limited. For more information, see IAM and STS Quotas in the IAM User Guide.

+ */ export class CreateInstanceProfileCommand extends $Command< CreateInstanceProfileCommandInput, CreateInstanceProfileCommandOutput, @@ -34,6 +39,9 @@ export class CreateInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateLoginProfileCommand.ts b/clients/client-iam/commands/CreateLoginProfileCommand.ts index 0f64d48a0061d..5fc9793864793 100644 --- a/clients/client-iam/commands/CreateLoginProfileCommand.ts +++ b/clients/client-iam/commands/CreateLoginProfileCommand.ts @@ -20,6 +20,11 @@ import { export type CreateLoginProfileCommandInput = CreateLoginProfileRequest; export type CreateLoginProfileCommandOutput = CreateLoginProfileResponse & __MetadataBearer; +/** + *

Creates a password for the specified user, giving the user the ability to access AWS + * services through the AWS Management Console. For more information about managing passwords, see Managing + * Passwords in the IAM User Guide.

+ */ export class CreateLoginProfileCommand extends $Command< CreateLoginProfileCommandInput, CreateLoginProfileCommandOutput, @@ -34,6 +39,9 @@ export class CreateLoginProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateOpenIDConnectProviderCommand.ts b/clients/client-iam/commands/CreateOpenIDConnectProviderCommand.ts index 7887d4ca26d24..225b8b55c1d38 100644 --- a/clients/client-iam/commands/CreateOpenIDConnectProviderCommand.ts +++ b/clients/client-iam/commands/CreateOpenIDConnectProviderCommand.ts @@ -20,6 +20,31 @@ import { export type CreateOpenIDConnectProviderCommandInput = CreateOpenIDConnectProviderRequest; export type CreateOpenIDConnectProviderCommandOutput = CreateOpenIDConnectProviderResponse & __MetadataBearer; +/** + *

Creates an IAM entity to describe an identity provider (IdP) that supports OpenID Connect (OIDC).

+ *

The OIDC provider that you create with this operation can be used as a principal in a + * role's trust policy. Such a policy establishes a trust relationship between AWS and the + * OIDC provider.

+ *

When you create the IAM OIDC provider, you specify the following:

+ *
    + *
  • + *

    The URL of the OIDC identity provider (IdP) to trust

    + *
  • + *
  • + *

    A list of client IDs (also known as audiences) that identify the application or + * applications that are allowed to authenticate using the OIDC provider

    + *
  • + *
  • + *

    A list of thumbprints of one or more server certificates that the IdP uses

    + *
  • + *
+ *

You get all of this information from the OIDC IdP that you want to use to access + * AWS.

+ * + *

The trust for the OIDC provider is derived from the IAM provider that this + * operation creates. Therefore, it is best to limit access to the CreateOpenIDConnectProvider operation to highly privileged users.

+ *
+ */ export class CreateOpenIDConnectProviderCommand extends $Command< CreateOpenIDConnectProviderCommandInput, CreateOpenIDConnectProviderCommandOutput, @@ -34,6 +59,9 @@ export class CreateOpenIDConnectProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreatePolicyCommand.ts b/clients/client-iam/commands/CreatePolicyCommand.ts index ba4804fb8c0c8..288572c2b195e 100644 --- a/clients/client-iam/commands/CreatePolicyCommand.ts +++ b/clients/client-iam/commands/CreatePolicyCommand.ts @@ -17,6 +17,15 @@ import { export type CreatePolicyCommandInput = CreatePolicyRequest; export type CreatePolicyCommandOutput = CreatePolicyResponse & __MetadataBearer; +/** + *

Creates a new managed policy for your AWS account.

+ *

This operation creates a policy version with a version identifier of v1 and + * sets v1 as the policy's default version. For more information about policy versions, see + * Versioning for Managed Policies in the + * IAM User Guide.

+ *

For more information about managed policies in general, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class CreatePolicyCommand extends $Command< CreatePolicyCommandInput, CreatePolicyCommandOutput, @@ -31,6 +40,9 @@ export class CreatePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreatePolicyVersionCommand.ts b/clients/client-iam/commands/CreatePolicyVersionCommand.ts index 17a9fa07afe8e..2cdd526102adf 100644 --- a/clients/client-iam/commands/CreatePolicyVersionCommand.ts +++ b/clients/client-iam/commands/CreatePolicyVersionCommand.ts @@ -20,6 +20,16 @@ import { export type CreatePolicyVersionCommandInput = CreatePolicyVersionRequest; export type CreatePolicyVersionCommandOutput = CreatePolicyVersionResponse & __MetadataBearer; +/** + *

Creates a new version of the specified managed policy. To update a managed policy, you + * create a new policy version. A managed policy can have up to five versions. If the policy + * has five versions, you must delete an existing version using DeletePolicyVersion before you create a new version.

+ *

Optionally, you can set the new version as the policy's default version. The default + * version is the version that is in effect for the IAM users, groups, and roles to which + * the policy is attached.

+ *

For more information about managed policy versions, see Versioning for Managed + * Policies in the IAM User Guide.

+ */ export class CreatePolicyVersionCommand extends $Command< CreatePolicyVersionCommandInput, CreatePolicyVersionCommandOutput, @@ -34,6 +44,9 @@ export class CreatePolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateRoleCommand.ts b/clients/client-iam/commands/CreateRoleCommand.ts index 1085f63ca0b3b..3683c5cb4b878 100644 --- a/clients/client-iam/commands/CreateRoleCommand.ts +++ b/clients/client-iam/commands/CreateRoleCommand.ts @@ -17,6 +17,11 @@ import { export type CreateRoleCommandInput = CreateRoleRequest; export type CreateRoleCommandOutput = CreateRoleResponse & __MetadataBearer; +/** + *

Creates a new role for your AWS account. For more information about roles, go to + * IAM + * Roles. The number and size of IAM resources in an AWS account are limited. For more information, see IAM and STS Quotas in the IAM User Guide.

+ */ export class CreateRoleCommand extends $Command< CreateRoleCommandInput, CreateRoleCommandOutput, @@ -31,6 +36,9 @@ export class CreateRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateSAMLProviderCommand.ts b/clients/client-iam/commands/CreateSAMLProviderCommand.ts index 535348181c627..06a0132859204 100644 --- a/clients/client-iam/commands/CreateSAMLProviderCommand.ts +++ b/clients/client-iam/commands/CreateSAMLProviderCommand.ts @@ -20,6 +20,26 @@ import { export type CreateSAMLProviderCommandInput = CreateSAMLProviderRequest; export type CreateSAMLProviderCommandOutput = CreateSAMLProviderResponse & __MetadataBearer; +/** + *

Creates an IAM resource that describes an identity provider (IdP) that supports SAML + * 2.0.

+ *

The SAML provider resource that you create with this operation can be used as a + * principal in an IAM role's trust policy. Such a policy can enable federated users who + * sign in using the SAML IdP to assume the role. You can create an IAM role that supports + * Web-based single sign-on (SSO) to the AWS Management Console or one that supports API access to + * AWS.

+ *

When you create the SAML provider resource, you upload a SAML metadata document that you + * get from your IdP. That document includes the issuer's name, expiration information, and + * keys that can be used to validate the SAML authentication response (assertions) that the + * IdP sends. You must generate the metadata document using the identity management software + * that is used as your organization's IdP.

+ * + *

This operation requires Signature Version 4.

+ *
+ *

For more information, see Enabling SAML 2.0 + * Federated Users to Access the AWS Management Console and About SAML 2.0-based + * Federation in the IAM User Guide.

+ */ export class CreateSAMLProviderCommand extends $Command< CreateSAMLProviderCommandInput, CreateSAMLProviderCommandOutput, @@ -34,6 +54,9 @@ export class CreateSAMLProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateServiceLinkedRoleCommand.ts b/clients/client-iam/commands/CreateServiceLinkedRoleCommand.ts index 3e2d40fe8fb56..cd4104df28e13 100644 --- a/clients/client-iam/commands/CreateServiceLinkedRoleCommand.ts +++ b/clients/client-iam/commands/CreateServiceLinkedRoleCommand.ts @@ -20,6 +20,17 @@ import { export type CreateServiceLinkedRoleCommandInput = CreateServiceLinkedRoleRequest; export type CreateServiceLinkedRoleCommandOutput = CreateServiceLinkedRoleResponse & __MetadataBearer; +/** + *

Creates an IAM role that is linked to a specific AWS service. The service controls + * the attached policies and when the role can be deleted. This helps ensure that the service + * is not broken by an unexpectedly changed or deleted role, which could put your AWS + * resources into an unknown state. Allowing the service to control the role helps improve + * service stability and proper cleanup when a service and its role are no longer needed. For + * more information, see Using Service-Linked Roles + * in the IAM User Guide.

+ *

To attach a policy to this service-linked role, you must make the request using the + * AWS service that depends on this role.

+ */ export class CreateServiceLinkedRoleCommand extends $Command< CreateServiceLinkedRoleCommandInput, CreateServiceLinkedRoleCommandOutput, @@ -34,6 +45,9 @@ export class CreateServiceLinkedRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateServiceSpecificCredentialCommand.ts b/clients/client-iam/commands/CreateServiceSpecificCredentialCommand.ts index 72ecf9ec71d6a..7be51a51ae3a0 100644 --- a/clients/client-iam/commands/CreateServiceSpecificCredentialCommand.ts +++ b/clients/client-iam/commands/CreateServiceSpecificCredentialCommand.ts @@ -20,6 +20,18 @@ import { export type CreateServiceSpecificCredentialCommandInput = CreateServiceSpecificCredentialRequest; export type CreateServiceSpecificCredentialCommandOutput = CreateServiceSpecificCredentialResponse & __MetadataBearer; +/** + *

Generates a set of credentials consisting of a user name and password that can be used + * to access the service specified in the request. These credentials are generated by IAM, + * and can be used only for the specified service.

+ *

You can have a maximum of two sets of service-specific credentials for each supported + * service per user.

+ *

The only supported service at this time is AWS CodeCommit.

+ *

You can reset the password to a new service-generated value by calling ResetServiceSpecificCredential.

+ *

For more information about service-specific credentials, see Using IAM with AWS CodeCommit: Git + * Credentials, SSH Keys, and AWS Access Keys in the + * IAM User Guide.

+ */ export class CreateServiceSpecificCredentialCommand extends $Command< CreateServiceSpecificCredentialCommandInput, CreateServiceSpecificCredentialCommandOutput, @@ -34,6 +46,9 @@ export class CreateServiceSpecificCredentialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateUserCommand.ts b/clients/client-iam/commands/CreateUserCommand.ts index eaccbfdcf4b29..cf9674c07a52b 100644 --- a/clients/client-iam/commands/CreateUserCommand.ts +++ b/clients/client-iam/commands/CreateUserCommand.ts @@ -17,6 +17,10 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResponse & __MetadataBearer; +/** + *

Creates a new IAM user for your AWS account.

+ *

The number and size of IAM resources in an AWS account are limited. For more information, see IAM and STS Quotas in the IAM User Guide.

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -31,6 +35,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/CreateVirtualMFADeviceCommand.ts b/clients/client-iam/commands/CreateVirtualMFADeviceCommand.ts index a6ada1f8eea37..237377e061fa9 100644 --- a/clients/client-iam/commands/CreateVirtualMFADeviceCommand.ts +++ b/clients/client-iam/commands/CreateVirtualMFADeviceCommand.ts @@ -20,6 +20,20 @@ import { export type CreateVirtualMFADeviceCommandInput = CreateVirtualMFADeviceRequest; export type CreateVirtualMFADeviceCommandOutput = CreateVirtualMFADeviceResponse & __MetadataBearer; +/** + *

Creates a new virtual MFA device for the AWS account. After creating the virtual MFA, + * use EnableMFADevice to attach the MFA device to an IAM user. For more + * information about creating and working with virtual MFA devices, go to Using a Virtual MFA + * Device in the IAM User Guide.

+ *

The number and size of IAM resources in an AWS account are limited. For more information, see IAM and STS Quotas in the IAM User Guide.

+ * + *

The seed information contained in the QR code and the Base32 string should be treated + * like any other secret access information. In other words, protect the seed information + * as you would your AWS access keys or your passwords. After you provision your virtual + * device, you should ensure that the information is destroyed following secure + * procedures.

+ *
+ */ export class CreateVirtualMFADeviceCommand extends $Command< CreateVirtualMFADeviceCommandInput, CreateVirtualMFADeviceCommandOutput, @@ -34,6 +48,9 @@ export class CreateVirtualMFADeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeactivateMFADeviceCommand.ts b/clients/client-iam/commands/DeactivateMFADeviceCommand.ts index 85f1213930746..f7f1d968a6741 100644 --- a/clients/client-iam/commands/DeactivateMFADeviceCommand.ts +++ b/clients/client-iam/commands/DeactivateMFADeviceCommand.ts @@ -20,6 +20,13 @@ import { export type DeactivateMFADeviceCommandInput = DeactivateMFADeviceRequest; export type DeactivateMFADeviceCommandOutput = __MetadataBearer; +/** + *

Deactivates the specified MFA device and removes it from association with the user name + * for which it was originally enabled.

+ *

For more information about creating and working with virtual MFA devices, go to Enabling a Virtual + * Multi-factor Authentication (MFA) Device in the + * IAM User Guide.

+ */ export class DeactivateMFADeviceCommand extends $Command< DeactivateMFADeviceCommandInput, DeactivateMFADeviceCommandOutput, @@ -34,6 +41,9 @@ export class DeactivateMFADeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteAccessKeyCommand.ts b/clients/client-iam/commands/DeleteAccessKeyCommand.ts index 39b24e8360a27..385b4bfb47e91 100644 --- a/clients/client-iam/commands/DeleteAccessKeyCommand.ts +++ b/clients/client-iam/commands/DeleteAccessKeyCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteAccessKeyCommandInput = DeleteAccessKeyRequest; export type DeleteAccessKeyCommandOutput = __MetadataBearer; +/** + *

Deletes the access key pair associated with the specified IAM user.

+ *

If you do not specify a user name, IAM determines the user name implicitly based on + * the AWS access key ID signing the request. This operation works for access keys under the + * AWS account. Consequently, you can use this operation to manage AWS account root user + * credentials even if the AWS account has no associated users.

+ */ export class DeleteAccessKeyCommand extends $Command< DeleteAccessKeyCommandInput, DeleteAccessKeyCommandOutput, @@ -34,6 +41,9 @@ export class DeleteAccessKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteAccountAliasCommand.ts b/clients/client-iam/commands/DeleteAccountAliasCommand.ts index 34232d216d395..943d6b785d2b4 100644 --- a/clients/client-iam/commands/DeleteAccountAliasCommand.ts +++ b/clients/client-iam/commands/DeleteAccountAliasCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteAccountAliasCommandInput = DeleteAccountAliasRequest; export type DeleteAccountAliasCommandOutput = __MetadataBearer; +/** + *

Deletes the specified AWS account alias. For information about using an AWS account + * alias, see Using an + * Alias for Your AWS Account ID in the + * IAM User Guide.

+ */ export class DeleteAccountAliasCommand extends $Command< DeleteAccountAliasCommandInput, DeleteAccountAliasCommandOutput, @@ -34,6 +40,9 @@ export class DeleteAccountAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteAccountPasswordPolicyCommand.ts b/clients/client-iam/commands/DeleteAccountPasswordPolicyCommand.ts index 378ce61a3ed5d..1bc1be9b4b81e 100644 --- a/clients/client-iam/commands/DeleteAccountPasswordPolicyCommand.ts +++ b/clients/client-iam/commands/DeleteAccountPasswordPolicyCommand.ts @@ -19,6 +19,9 @@ import { export type DeleteAccountPasswordPolicyCommandInput = {}; export type DeleteAccountPasswordPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the password policy for the AWS account. There are no parameters.

+ */ export class DeleteAccountPasswordPolicyCommand extends $Command< DeleteAccountPasswordPolicyCommandInput, DeleteAccountPasswordPolicyCommandOutput, @@ -33,6 +36,9 @@ export class DeleteAccountPasswordPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteGroupCommand.ts b/clients/client-iam/commands/DeleteGroupCommand.ts index 7ed6f0eba8fa2..1fac110dfac40 100644 --- a/clients/client-iam/commands/DeleteGroupCommand.ts +++ b/clients/client-iam/commands/DeleteGroupCommand.ts @@ -17,6 +17,10 @@ import { export type DeleteGroupCommandInput = DeleteGroupRequest; export type DeleteGroupCommandOutput = __MetadataBearer; +/** + *

Deletes the specified IAM group. The group must not contain any users or have any + * attached policies.

+ */ export class DeleteGroupCommand extends $Command< DeleteGroupCommandInput, DeleteGroupCommandOutput, @@ -31,6 +35,9 @@ export class DeleteGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteGroupPolicyCommand.ts b/clients/client-iam/commands/DeleteGroupPolicyCommand.ts index c789c4cca79fd..d5a72d8643022 100644 --- a/clients/client-iam/commands/DeleteGroupPolicyCommand.ts +++ b/clients/client-iam/commands/DeleteGroupPolicyCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteGroupPolicyCommandInput = DeleteGroupPolicyRequest; export type DeleteGroupPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified inline policy that is embedded in the specified IAM + * group.

+ *

A group can also have managed policies attached to it. To detach a managed policy from a + * group, use DetachGroupPolicy. For more information about policies, refer + * to Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ */ export class DeleteGroupPolicyCommand extends $Command< DeleteGroupPolicyCommandInput, DeleteGroupPolicyCommandOutput, @@ -34,6 +43,9 @@ export class DeleteGroupPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteInstanceProfileCommand.ts b/clients/client-iam/commands/DeleteInstanceProfileCommand.ts index 694f823f153eb..b74e7499cd276 100644 --- a/clients/client-iam/commands/DeleteInstanceProfileCommand.ts +++ b/clients/client-iam/commands/DeleteInstanceProfileCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteInstanceProfileCommandInput = DeleteInstanceProfileRequest; export type DeleteInstanceProfileCommandOutput = __MetadataBearer; +/** + *

Deletes the specified instance profile. The instance profile must not have an associated + * role.

+ * + *

Make sure that you do not have any Amazon EC2 instances running with the instance + * profile you are about to delete. Deleting a role or instance profile that is associated + * with a running instance will break any applications running on the instance.

+ *
+ *

For more information about instance profiles, go to About Instance Profiles.

+ */ export class DeleteInstanceProfileCommand extends $Command< DeleteInstanceProfileCommandInput, DeleteInstanceProfileCommandOutput, @@ -34,6 +44,9 @@ export class DeleteInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteLoginProfileCommand.ts b/clients/client-iam/commands/DeleteLoginProfileCommand.ts index c374151803df3..dafba21374423 100644 --- a/clients/client-iam/commands/DeleteLoginProfileCommand.ts +++ b/clients/client-iam/commands/DeleteLoginProfileCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteLoginProfileCommandInput = DeleteLoginProfileRequest; export type DeleteLoginProfileCommandOutput = __MetadataBearer; +/** + *

Deletes the password for the specified IAM user, which terminates the user's ability + * to access AWS services through the AWS Management Console.

+ * + *

Deleting a user's password does not prevent a user from accessing AWS through the + * command line interface or the API. To prevent all user access, you must also either make + * any access keys inactive or delete them. For more information about making keys inactive + * or deleting them, see UpdateAccessKey and DeleteAccessKey.

+ *
+ */ export class DeleteLoginProfileCommand extends $Command< DeleteLoginProfileCommandInput, DeleteLoginProfileCommandOutput, @@ -34,6 +44,9 @@ export class DeleteLoginProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteOpenIDConnectProviderCommand.ts b/clients/client-iam/commands/DeleteOpenIDConnectProviderCommand.ts index 0ce90ec2565c3..f2c120e97a079 100644 --- a/clients/client-iam/commands/DeleteOpenIDConnectProviderCommand.ts +++ b/clients/client-iam/commands/DeleteOpenIDConnectProviderCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteOpenIDConnectProviderCommandInput = DeleteOpenIDConnectProviderRequest; export type DeleteOpenIDConnectProviderCommandOutput = __MetadataBearer; +/** + *

Deletes an OpenID Connect identity provider (IdP) resource object in IAM.

+ *

Deleting an IAM OIDC provider resource does not update any roles that reference the + * provider as a principal in their trust policies. Any attempt to assume a role that + * references a deleted provider fails.

+ *

This operation is idempotent; it does not fail or return an error if you call the + * operation for a provider that does not exist.

+ */ export class DeleteOpenIDConnectProviderCommand extends $Command< DeleteOpenIDConnectProviderCommandInput, DeleteOpenIDConnectProviderCommandOutput, @@ -34,6 +42,9 @@ export class DeleteOpenIDConnectProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeletePolicyCommand.ts b/clients/client-iam/commands/DeletePolicyCommand.ts index 4f18b28e7935e..3119dd2b36b6b 100644 --- a/clients/client-iam/commands/DeletePolicyCommand.ts +++ b/clients/client-iam/commands/DeletePolicyCommand.ts @@ -17,6 +17,32 @@ import { export type DeletePolicyCommandInput = DeletePolicyRequest; export type DeletePolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified managed policy.

+ *

Before you can delete a managed policy, you must first detach the policy from all users, + * groups, and roles that it is attached to. In addition, you must delete all the policy's + * versions. The following steps describe the process for deleting a managed policy:

+ *
    + *
  • + *

    Detach the policy from all users, groups, and roles that the policy is attached + * to, using the DetachUserPolicy, DetachGroupPolicy, or DetachRolePolicy API operations. To list all the users, + * groups, and roles that a policy is attached to, use ListEntitiesForPolicy.

    + *
  • + *
  • + *

    Delete all versions of the policy using DeletePolicyVersion. To + * list the policy's versions, use ListPolicyVersions. You cannot use + * DeletePolicyVersion to delete the version that is marked as the + * default version. You delete the policy's default version in the next step of the + * process.

    + *
  • + *
  • + *

    Delete the policy (this automatically deletes the policy's default version) using + * this API.

    + *
  • + *
+ *

For information about managed policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class DeletePolicyCommand extends $Command< DeletePolicyCommandInput, DeletePolicyCommandOutput, @@ -31,6 +57,9 @@ export class DeletePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeletePolicyVersionCommand.ts b/clients/client-iam/commands/DeletePolicyVersionCommand.ts index c193067926a6a..276713028322c 100644 --- a/clients/client-iam/commands/DeletePolicyVersionCommand.ts +++ b/clients/client-iam/commands/DeletePolicyVersionCommand.ts @@ -20,6 +20,14 @@ import { export type DeletePolicyVersionCommandInput = DeletePolicyVersionRequest; export type DeletePolicyVersionCommandOutput = __MetadataBearer; +/** + *

Deletes the specified version from the specified managed policy.

+ *

You cannot delete the default version from a policy using this API. To delete the + * default version from a policy, use DeletePolicy. To find out which + * version of a policy is marked as the default version, use ListPolicyVersions.

+ *

For information about versions for managed policies, see Versioning for Managed + * Policies in the IAM User Guide.

+ */ export class DeletePolicyVersionCommand extends $Command< DeletePolicyVersionCommandInput, DeletePolicyVersionCommandOutput, @@ -34,6 +42,9 @@ export class DeletePolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteRoleCommand.ts b/clients/client-iam/commands/DeleteRoleCommand.ts index 693ef29117c6c..ea3e08dcacdc1 100644 --- a/clients/client-iam/commands/DeleteRoleCommand.ts +++ b/clients/client-iam/commands/DeleteRoleCommand.ts @@ -17,6 +17,15 @@ import { export type DeleteRoleCommandInput = DeleteRoleRequest; export type DeleteRoleCommandOutput = __MetadataBearer; +/** + *

Deletes the specified role. The role must not have any policies attached. For more + * information about roles, go to Working with Roles.

+ * + *

Make sure that you do not have any Amazon EC2 instances running with the role you are + * about to delete. Deleting a role or instance profile that is associated with a running + * instance will break any applications running on the instance.

+ *
+ */ export class DeleteRoleCommand extends $Command< DeleteRoleCommandInput, DeleteRoleCommandOutput, @@ -31,6 +40,9 @@ export class DeleteRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteRolePermissionsBoundaryCommand.ts b/clients/client-iam/commands/DeleteRolePermissionsBoundaryCommand.ts index 0b028a81081c9..10042cdf96247 100644 --- a/clients/client-iam/commands/DeleteRolePermissionsBoundaryCommand.ts +++ b/clients/client-iam/commands/DeleteRolePermissionsBoundaryCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteRolePermissionsBoundaryCommandInput = DeleteRolePermissionsBoundaryRequest; export type DeleteRolePermissionsBoundaryCommandOutput = __MetadataBearer; +/** + *

Deletes the permissions boundary for the specified IAM role.

+ * + *

Deleting the permissions boundary for a role might increase its permissions. For + * example, it might allow anyone who assumes the role to perform all the actions granted + * in its permissions policies.

+ *
+ */ export class DeleteRolePermissionsBoundaryCommand extends $Command< DeleteRolePermissionsBoundaryCommandInput, DeleteRolePermissionsBoundaryCommandOutput, @@ -34,6 +42,9 @@ export class DeleteRolePermissionsBoundaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteRolePolicyCommand.ts b/clients/client-iam/commands/DeleteRolePolicyCommand.ts index bd10fd8b316e6..b3a6bb01902fd 100644 --- a/clients/client-iam/commands/DeleteRolePolicyCommand.ts +++ b/clients/client-iam/commands/DeleteRolePolicyCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteRolePolicyCommandInput = DeleteRolePolicyRequest; export type DeleteRolePolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified inline policy that is embedded in the specified IAM role.

+ *

A role can also have managed policies attached to it. To detach a managed policy from a + * role, use DetachRolePolicy. For more information about policies, refer to + * Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ */ export class DeleteRolePolicyCommand extends $Command< DeleteRolePolicyCommandInput, DeleteRolePolicyCommandOutput, @@ -34,6 +42,9 @@ export class DeleteRolePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteSAMLProviderCommand.ts b/clients/client-iam/commands/DeleteSAMLProviderCommand.ts index 641f919011472..802c62f2ce985 100644 --- a/clients/client-iam/commands/DeleteSAMLProviderCommand.ts +++ b/clients/client-iam/commands/DeleteSAMLProviderCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteSAMLProviderCommandInput = DeleteSAMLProviderRequest; export type DeleteSAMLProviderCommandOutput = __MetadataBearer; +/** + *

Deletes a SAML provider resource in IAM.

+ *

Deleting the provider resource from IAM does not update any roles that reference the + * SAML provider resource's ARN as a principal in their trust policies. Any attempt to assume + * a role that references a non-existent provider resource ARN fails.

+ * + *

This operation requires Signature Version 4.

+ *
+ */ export class DeleteSAMLProviderCommand extends $Command< DeleteSAMLProviderCommandInput, DeleteSAMLProviderCommandOutput, @@ -34,6 +43,9 @@ export class DeleteSAMLProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteSSHPublicKeyCommand.ts b/clients/client-iam/commands/DeleteSSHPublicKeyCommand.ts index 843e10111f838..f8e25b23021bb 100644 --- a/clients/client-iam/commands/DeleteSSHPublicKeyCommand.ts +++ b/clients/client-iam/commands/DeleteSSHPublicKeyCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteSSHPublicKeyCommandInput = DeleteSSHPublicKeyRequest; export type DeleteSSHPublicKeyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified SSH public key.

+ *

The SSH public key deleted by this operation is used only for authenticating the + * associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to + * authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH + * Connections in the AWS CodeCommit User Guide.

+ */ export class DeleteSSHPublicKeyCommand extends $Command< DeleteSSHPublicKeyCommandInput, DeleteSSHPublicKeyCommandOutput, @@ -34,6 +41,9 @@ export class DeleteSSHPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteServerCertificateCommand.ts b/clients/client-iam/commands/DeleteServerCertificateCommand.ts index d69e678bf3051..4002a94dcd017 100644 --- a/clients/client-iam/commands/DeleteServerCertificateCommand.ts +++ b/clients/client-iam/commands/DeleteServerCertificateCommand.ts @@ -20,6 +20,22 @@ import { export type DeleteServerCertificateCommandInput = DeleteServerCertificateRequest; export type DeleteServerCertificateCommandOutput = __MetadataBearer; +/** + *

Deletes the specified server certificate.

+ *

For more information about working with server certificates, see Working with + * Server Certificates in the IAM User Guide. This topic + * also includes a list of AWS services that can use the server certificates that you manage + * with IAM.

+ * + *

If you are using a server certificate with Elastic Load Balancing, deleting the + * certificate could have implications for your application. If Elastic Load Balancing + * doesn't detect the deletion of bound certificates, it may continue to use the + * certificates. This could cause Elastic Load Balancing to stop accepting traffic. We + * recommend that you remove the reference to the certificate from Elastic Load Balancing + * before using this command to delete the certificate. For more information, go to DeleteLoadBalancerListeners in the Elastic Load Balancing API + * Reference.

+ *
+ */ export class DeleteServerCertificateCommand extends $Command< DeleteServerCertificateCommandInput, DeleteServerCertificateCommandOutput, @@ -34,6 +50,9 @@ export class DeleteServerCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteServiceLinkedRoleCommand.ts b/clients/client-iam/commands/DeleteServiceLinkedRoleCommand.ts index b4a0da0266441..2f4fc10a2f42f 100644 --- a/clients/client-iam/commands/DeleteServiceLinkedRoleCommand.ts +++ b/clients/client-iam/commands/DeleteServiceLinkedRoleCommand.ts @@ -20,6 +20,23 @@ import { export type DeleteServiceLinkedRoleCommandInput = DeleteServiceLinkedRoleRequest; export type DeleteServiceLinkedRoleCommandOutput = DeleteServiceLinkedRoleResponse & __MetadataBearer; +/** + *

Submits a service-linked role deletion request and returns a + * DeletionTaskId, which you can use to check the status of the deletion. Before + * you call this operation, confirm that the role has no active sessions and that any + * resources used by the role in the linked service are deleted. If you call this operation + * more than once for the same service-linked role and an earlier deletion task is not + * complete, then the DeletionTaskId of the earlier request is returned.

+ *

If you submit a deletion request for a service-linked role whose linked service is still + * accessing a resource, then the deletion task fails. If it fails, the GetServiceLinkedRoleDeletionStatus API operation returns the reason for the + * failure, usually including the resources that must be deleted. To delete the service-linked + * role, you must first remove those resources from the linked service and then submit the + * deletion request again. Resources are specific to the service that is linked to the role. + * For more information about removing resources from a service, see the AWS documentation for your service.

+ *

For more information about service-linked roles, see Roles + * Terms and Concepts: AWS Service-Linked Role in the + * IAM User Guide.

+ */ export class DeleteServiceLinkedRoleCommand extends $Command< DeleteServiceLinkedRoleCommandInput, DeleteServiceLinkedRoleCommandOutput, @@ -34,6 +51,9 @@ export class DeleteServiceLinkedRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteServiceSpecificCredentialCommand.ts b/clients/client-iam/commands/DeleteServiceSpecificCredentialCommand.ts index 56f81ba0886c1..8b8943cba7ab0 100644 --- a/clients/client-iam/commands/DeleteServiceSpecificCredentialCommand.ts +++ b/clients/client-iam/commands/DeleteServiceSpecificCredentialCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteServiceSpecificCredentialCommandInput = DeleteServiceSpecificCredentialRequest; export type DeleteServiceSpecificCredentialCommandOutput = __MetadataBearer; +/** + *

Deletes the specified service-specific credential.

+ */ export class DeleteServiceSpecificCredentialCommand extends $Command< DeleteServiceSpecificCredentialCommandInput, DeleteServiceSpecificCredentialCommandOutput, @@ -34,6 +37,9 @@ export class DeleteServiceSpecificCredentialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteSigningCertificateCommand.ts b/clients/client-iam/commands/DeleteSigningCertificateCommand.ts index cc09248d87321..96fd8eefbe398 100644 --- a/clients/client-iam/commands/DeleteSigningCertificateCommand.ts +++ b/clients/client-iam/commands/DeleteSigningCertificateCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteSigningCertificateCommandInput = DeleteSigningCertificateRequest; export type DeleteSigningCertificateCommandOutput = __MetadataBearer; +/** + *

Deletes a signing certificate associated with the specified IAM user.

+ *

If you do not specify a user name, IAM determines the user name implicitly based on + * the AWS access key ID signing the request. This operation works for access keys under the + * AWS account. Consequently, you can use this operation to manage AWS account root user + * credentials even if the AWS account has no associated IAM users.

+ */ export class DeleteSigningCertificateCommand extends $Command< DeleteSigningCertificateCommandInput, DeleteSigningCertificateCommandOutput, @@ -34,6 +41,9 @@ export class DeleteSigningCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteUserCommand.ts b/clients/client-iam/commands/DeleteUserCommand.ts index 9745d8072d4e0..1f0907f1e2f34 100644 --- a/clients/client-iam/commands/DeleteUserCommand.ts +++ b/clients/client-iam/commands/DeleteUserCommand.ts @@ -17,6 +17,42 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = __MetadataBearer; +/** + *

Deletes the specified IAM user. Unlike the AWS Management Console, when you delete a user + * programmatically, you must delete the items attached to the user manually, or the deletion + * fails. For more information, see Deleting an IAM + * User. Before attempting to delete a user, remove the following items:

+ * + */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -31,6 +67,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteUserPermissionsBoundaryCommand.ts b/clients/client-iam/commands/DeleteUserPermissionsBoundaryCommand.ts index f7bb64bddfa8a..413a8b859beab 100644 --- a/clients/client-iam/commands/DeleteUserPermissionsBoundaryCommand.ts +++ b/clients/client-iam/commands/DeleteUserPermissionsBoundaryCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteUserPermissionsBoundaryCommandInput = DeleteUserPermissionsBoundaryRequest; export type DeleteUserPermissionsBoundaryCommandOutput = __MetadataBearer; +/** + *

Deletes the permissions boundary for the specified IAM user.

+ * + *

Deleting the permissions boundary for a user might increase its permissions by + * allowing the user to perform all the actions granted in its permissions policies. + *

+ *
+ */ export class DeleteUserPermissionsBoundaryCommand extends $Command< DeleteUserPermissionsBoundaryCommandInput, DeleteUserPermissionsBoundaryCommandOutput, @@ -34,6 +42,9 @@ export class DeleteUserPermissionsBoundaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteUserPolicyCommand.ts b/clients/client-iam/commands/DeleteUserPolicyCommand.ts index 72375a40c7b52..f97acd7136c6a 100644 --- a/clients/client-iam/commands/DeleteUserPolicyCommand.ts +++ b/clients/client-iam/commands/DeleteUserPolicyCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteUserPolicyCommandInput = DeleteUserPolicyRequest; export type DeleteUserPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified inline policy that is embedded in the specified IAM user.

+ *

A user can also have managed policies attached to it. To detach a managed policy from a + * user, use DetachUserPolicy. For more information about policies, refer to + * Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ */ export class DeleteUserPolicyCommand extends $Command< DeleteUserPolicyCommandInput, DeleteUserPolicyCommandOutput, @@ -34,6 +42,9 @@ export class DeleteUserPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DeleteVirtualMFADeviceCommand.ts b/clients/client-iam/commands/DeleteVirtualMFADeviceCommand.ts index 86d03d3c8d227..5bf04f537aac8 100644 --- a/clients/client-iam/commands/DeleteVirtualMFADeviceCommand.ts +++ b/clients/client-iam/commands/DeleteVirtualMFADeviceCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteVirtualMFADeviceCommandInput = DeleteVirtualMFADeviceRequest; export type DeleteVirtualMFADeviceCommandOutput = __MetadataBearer; +/** + *

Deletes a virtual MFA device.

+ * + *

You must deactivate a user's virtual MFA device before you can delete it. For + * information about deactivating MFA devices, see DeactivateMFADevice. + *

+ *
+ */ export class DeleteVirtualMFADeviceCommand extends $Command< DeleteVirtualMFADeviceCommandInput, DeleteVirtualMFADeviceCommandOutput, @@ -34,6 +42,9 @@ export class DeleteVirtualMFADeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DetachGroupPolicyCommand.ts b/clients/client-iam/commands/DetachGroupPolicyCommand.ts index 26916c5ec8fdf..6fe234aeb7643 100644 --- a/clients/client-iam/commands/DetachGroupPolicyCommand.ts +++ b/clients/client-iam/commands/DetachGroupPolicyCommand.ts @@ -20,6 +20,13 @@ import { export type DetachGroupPolicyCommandInput = DetachGroupPolicyRequest; export type DetachGroupPolicyCommandOutput = __MetadataBearer; +/** + *

Removes the specified managed policy from the specified IAM group.

+ *

A group can also have inline policies embedded with it. To delete an inline policy, use + * the DeleteGroupPolicy API. For information about policies, see Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ */ export class DetachGroupPolicyCommand extends $Command< DetachGroupPolicyCommandInput, DetachGroupPolicyCommandOutput, @@ -34,6 +41,9 @@ export class DetachGroupPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DetachRolePolicyCommand.ts b/clients/client-iam/commands/DetachRolePolicyCommand.ts index 8231ff8441c8f..5ffed2cf0dfb0 100644 --- a/clients/client-iam/commands/DetachRolePolicyCommand.ts +++ b/clients/client-iam/commands/DetachRolePolicyCommand.ts @@ -20,6 +20,13 @@ import { export type DetachRolePolicyCommandInput = DetachRolePolicyRequest; export type DetachRolePolicyCommandOutput = __MetadataBearer; +/** + *

Removes the specified managed policy from the specified role.

+ *

A role can also have inline policies embedded with it. To delete an inline policy, use + * the DeleteRolePolicy API. For information about policies, see Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ */ export class DetachRolePolicyCommand extends $Command< DetachRolePolicyCommandInput, DetachRolePolicyCommandOutput, @@ -34,6 +41,9 @@ export class DetachRolePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/DetachUserPolicyCommand.ts b/clients/client-iam/commands/DetachUserPolicyCommand.ts index 13cf2f0b41e16..5362f0eb99355 100644 --- a/clients/client-iam/commands/DetachUserPolicyCommand.ts +++ b/clients/client-iam/commands/DetachUserPolicyCommand.ts @@ -20,6 +20,13 @@ import { export type DetachUserPolicyCommandInput = DetachUserPolicyRequest; export type DetachUserPolicyCommandOutput = __MetadataBearer; +/** + *

Removes the specified managed policy from the specified user.

+ *

A user can also have inline policies embedded with it. To delete an inline policy, use + * the DeleteUserPolicy API. For information about policies, see Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ */ export class DetachUserPolicyCommand extends $Command< DetachUserPolicyCommandInput, DetachUserPolicyCommandOutput, @@ -34,6 +41,9 @@ export class DetachUserPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/EnableMFADeviceCommand.ts b/clients/client-iam/commands/EnableMFADeviceCommand.ts index bb86ea5fad174..7d0f105b40bbf 100644 --- a/clients/client-iam/commands/EnableMFADeviceCommand.ts +++ b/clients/client-iam/commands/EnableMFADeviceCommand.ts @@ -20,6 +20,11 @@ import { export type EnableMFADeviceCommandInput = EnableMFADeviceRequest; export type EnableMFADeviceCommandOutput = __MetadataBearer; +/** + *

Enables the specified MFA device and associates it with the specified IAM user. When + * enabled, the MFA device is required for every subsequent login by the IAM user associated + * with the device.

+ */ export class EnableMFADeviceCommand extends $Command< EnableMFADeviceCommandInput, EnableMFADeviceCommandOutput, @@ -34,6 +39,9 @@ export class EnableMFADeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GenerateCredentialReportCommand.ts b/clients/client-iam/commands/GenerateCredentialReportCommand.ts index 280126a8ab0b0..fe90e6e1da852 100644 --- a/clients/client-iam/commands/GenerateCredentialReportCommand.ts +++ b/clients/client-iam/commands/GenerateCredentialReportCommand.ts @@ -20,6 +20,11 @@ import { export type GenerateCredentialReportCommandInput = {}; export type GenerateCredentialReportCommandOutput = GenerateCredentialReportResponse & __MetadataBearer; +/** + *

Generates a credential report for the AWS account. For more information about the + * credential report, see Getting Credential Reports in the + * IAM User Guide.

+ */ export class GenerateCredentialReportCommand extends $Command< GenerateCredentialReportCommandInput, GenerateCredentialReportCommandOutput, @@ -34,6 +39,9 @@ export class GenerateCredentialReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GenerateOrganizationsAccessReportCommand.ts b/clients/client-iam/commands/GenerateOrganizationsAccessReportCommand.ts index faaf0df2784fe..7943affdb8faa 100644 --- a/clients/client-iam/commands/GenerateOrganizationsAccessReportCommand.ts +++ b/clients/client-iam/commands/GenerateOrganizationsAccessReportCommand.ts @@ -24,6 +24,134 @@ export type GenerateOrganizationsAccessReportCommandInput = GenerateOrganization export type GenerateOrganizationsAccessReportCommandOutput = GenerateOrganizationsAccessReportResponse & __MetadataBearer; +/** + *

Generates a report for service last accessed data for AWS Organizations. You can generate a report + * for any entities (organization root, organizational unit, or account) or policies in your + * organization.

+ *

To call this operation, you must be signed in using your AWS Organizations master account + * credentials. You can use your long-term IAM user or root user credentials, or temporary + * credentials from assuming an IAM role. SCPs must be enabled for your organization root. + * You must have the required IAM and AWS Organizations permissions. For more information, see Refining + * Permissions Using Service Last Accessed Data in the + * IAM User Guide.

+ *

You can generate a service last accessed data report for entities by specifying only the + * entity's path. This data includes a list of services that are allowed by any service + * control policies (SCPs) that apply to the entity.

+ *

You can generate a service last accessed data report for a policy by specifying an + * entity's path and an optional AWS Organizations policy ID. This data includes a list of services that + * are allowed by the specified SCP.

+ *

For each service in both report types, the data includes the most recent account + * activity that the policy allows to account principals in the entity or the entity's + * children. For important information about the data, reporting period, permissions required, + * troubleshooting, and supported Regions see Reducing Permissions Using + * Service Last Accessed Data in the IAM User Guide.

+ * + *

The data includes all attempts to access AWS, not just the successful ones. This + * includes all attempts that were made using the AWS Management Console, the AWS API through any of + * the SDKs, or any of the command line tools. An unexpected entry in the service last + * accessed data does not mean that an account has been compromised, because the request + * might have been denied. Refer to your CloudTrail logs as the authoritative source for + * information about all API calls and whether they were successful or denied access. For + * more information, see Logging IAM Events with + * CloudTrail in the IAM User Guide.

+ *
+ *

This operation returns a JobId. Use this parameter in the + * GetOrganizationsAccessReport + * operation to check the status of the + * report generation. To check the status of this request, use the JobId + * parameter in the + * GetOrganizationsAccessReport + * operation and + * test the JobStatus response parameter. When the job is complete, you can + * retrieve the report.

+ *

To generate a service last accessed data report for entities, specify an entity path + * without specifying the optional AWS Organizations policy ID. The type of entity that you specify + * determines the data returned in the report.

+ *
    + *
  • + *

    + * Root – When you specify the organizations + * root as the entity, the resulting report lists all of the services allowed by SCPs + * that are attached to your root. For each service, the report includes data for all + * accounts in your organization except the master account, because the master account + * is not limited by SCPs.

    + *
  • + *
  • + *

    + * OU – When you specify an organizational + * unit (OU) as the entity, the resulting report lists all of the services allowed by + * SCPs that are attached to the OU and its parents. For each service, the report + * includes data for all accounts in the OU or its children. This data excludes the + * master account, because the master account is not limited by SCPs.

    + *
  • + *
  • + *

    + * Master account – When you specify the + * master account, the resulting report lists all AWS services, because the master + * account is not limited by SCPs. For each service, the report includes data for only + * the master account.

    + *
  • + *
  • + *

    + * Account – When you specify another account + * as the entity, the resulting report lists all of the services allowed by SCPs that + * are attached to the account and its parents. For each service, the report includes + * data for only the specified account.

    + *
  • + *
+ *

To generate a service last accessed data report for policies, specify an entity path and + * the optional AWS Organizations policy ID. The type of entity that you specify determines the data + * returned for each service.

+ *
    + *
  • + *

    + * Root – When you specify the root entity + * and a policy ID, the resulting report lists all of the services that are allowed by + * the specified SCP. For each service, the report includes data for all accounts in + * your organization to which the SCP applies. This data excludes the master account, + * because the master account is not limited by SCPs. If the SCP is not attached to any + * entities in the organization, then the report will return a list of services with no + * data.

    + *
  • + *
  • + *

    + * OU – When you specify an OU entity and a + * policy ID, the resulting report lists all of the services that are allowed by the + * specified SCP. For each service, the report includes data for all accounts in the OU + * or its children to which the SCP applies. This means that other accounts outside the + * OU that are affected by the SCP might not be included in the data. This data excludes + * the master account, because the master account is not limited by SCPs. If the SCP is + * not attached to the OU or one of its children, the report will return a list of + * services with no data.

    + *
  • + *
  • + *

    + * Master account – When you specify the + * master account, the resulting report lists all AWS services, because the master + * account is not limited by SCPs. If you specify a policy ID in the CLI or API, the + * policy is ignored. For each service, the report includes data for only the master + * account.

    + *
  • + *
  • + *

    + * Account – When you specify another account + * entity and a policy ID, the resulting report lists all of the services that are + * allowed by the specified SCP. For each service, the report includes data for only the + * specified account. This means that other accounts in the organization that are + * affected by the SCP might not be included in the data. If the SCP is not attached to + * the account, the report will return a list of services with no data.

    + *
  • + *
+ * + *

Service last accessed data does not use other policy types when determining whether a + * principal could access a service. These other policy types include identity-based + * policies, resource-based policies, access control lists, IAM permissions boundaries, + * and STS assume role policies. It only applies SCP logic. For more about the evaluation + * of policy types, see Evaluating Policies in the IAM User Guide.

+ *
+ *

For more information about service last accessed data, see Reducing Policy Scope by + * Viewing User Activity in the IAM User Guide.

+ */ export class GenerateOrganizationsAccessReportCommand extends $Command< GenerateOrganizationsAccessReportCommandInput, GenerateOrganizationsAccessReportCommandOutput, @@ -38,6 +166,9 @@ export class GenerateOrganizationsAccessReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GenerateServiceLastAccessedDetailsCommand.ts b/clients/client-iam/commands/GenerateServiceLastAccessedDetailsCommand.ts index 1afcef7e7c0a6..1fe7b5dc7bb81 100644 --- a/clients/client-iam/commands/GenerateServiceLastAccessedDetailsCommand.ts +++ b/clients/client-iam/commands/GenerateServiceLastAccessedDetailsCommand.ts @@ -24,6 +24,59 @@ export type GenerateServiceLastAccessedDetailsCommandInput = GenerateServiceLast export type GenerateServiceLastAccessedDetailsCommandOutput = GenerateServiceLastAccessedDetailsResponse & __MetadataBearer; +/** + *

Generates a report that includes details about when an IAM resource (user, group, + * role, or policy) was last used in an attempt to access AWS services. Recent activity + * usually appears within four hours. IAM reports activity for the last 365 days, or less if + * your Region began supporting this feature within the last year. For more information, see + * Regions Where Data Is Tracked.

+ * + *

The service last accessed data includes all attempts to access an AWS API, not just + * the successful ones. This includes all attempts that were made using the AWS Management Console, the + * AWS API through any of the SDKs, or any of the command line tools. An unexpected entry + * in the service last accessed data does not mean that your account has been compromised, + * because the request might have been denied. Refer to your CloudTrail logs as the + * authoritative source for information about all API calls and whether they were + * successful or denied access. For more information, see Logging IAM Events with + * CloudTrail in the IAM User Guide.

+ *
+ *

The GenerateServiceLastAccessedDetails operation returns a + * JobId. Use this parameter in the following operations to retrieve the + * following details from your report:

+ *
    + *
  • + *

    + * GetServiceLastAccessedDetails – Use this operation for + * users, groups, roles, or policies to list every AWS service that the resource could + * access using permissions policies. For each service, the response includes + * information about the most recent access attempt.

    + *

    The JobId returned by GenerateServiceLastAccessedDetail + * must be used by the same role within a session, or by the same user when used to call + * GetServiceLastAccessedDetail.

    + *
  • + *
  • + *

    + * GetServiceLastAccessedDetailsWithEntities – Use this + * operation for groups and policies to list information about the associated entities + * (users or roles) that attempted to access a specific AWS service.

    + *
  • + *
+ *

To check the status of the GenerateServiceLastAccessedDetails request, use + * the JobId parameter in the same operations and test the JobStatus + * response parameter.

+ *

For additional information about the permissions policies that allow an identity (user, + * group, or role) to access specific services, use the ListPoliciesGrantingServiceAccess operation.

+ * + *

Service last accessed data does not use other policy types when determining whether a + * resource could access a service. These other policy types include resource-based + * policies, access control lists, AWS Organizations policies, IAM permissions boundaries, + * and AWS STS assume role policies. It only applies permissions policy logic. For more + * about the evaluation of policy types, see Evaluating Policies in the IAM User Guide.

+ *
+ *

For more information about service and action last accessed data, see Reducing + * Permissions Using Service Last Accessed Data in the + * IAM User Guide.

+ */ export class GenerateServiceLastAccessedDetailsCommand extends $Command< GenerateServiceLastAccessedDetailsCommandInput, GenerateServiceLastAccessedDetailsCommandOutput, @@ -38,6 +91,9 @@ export class GenerateServiceLastAccessedDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetAccessKeyLastUsedCommand.ts b/clients/client-iam/commands/GetAccessKeyLastUsedCommand.ts index 8d8c9b9ceea88..938a82f5d9b3a 100644 --- a/clients/client-iam/commands/GetAccessKeyLastUsedCommand.ts +++ b/clients/client-iam/commands/GetAccessKeyLastUsedCommand.ts @@ -20,6 +20,11 @@ import { export type GetAccessKeyLastUsedCommandInput = GetAccessKeyLastUsedRequest; export type GetAccessKeyLastUsedCommandOutput = GetAccessKeyLastUsedResponse & __MetadataBearer; +/** + *

Retrieves information about when the specified access key was last used. The information + * includes the date and time of last use, along with the AWS service and Region that were + * specified in the last request made with that key.

+ */ export class GetAccessKeyLastUsedCommand extends $Command< GetAccessKeyLastUsedCommandInput, GetAccessKeyLastUsedCommandOutput, @@ -34,6 +39,9 @@ export class GetAccessKeyLastUsedCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetAccountAuthorizationDetailsCommand.ts b/clients/client-iam/commands/GetAccountAuthorizationDetailsCommand.ts index 5ae08c61b5e20..42b64f8f87c94 100644 --- a/clients/client-iam/commands/GetAccountAuthorizationDetailsCommand.ts +++ b/clients/client-iam/commands/GetAccountAuthorizationDetailsCommand.ts @@ -20,6 +20,22 @@ import { export type GetAccountAuthorizationDetailsCommandInput = GetAccountAuthorizationDetailsRequest; export type GetAccountAuthorizationDetailsCommandOutput = GetAccountAuthorizationDetailsResponse & __MetadataBearer; +/** + *

Retrieves information about all IAM users, groups, roles, and policies in your AWS + * account, including their relationships to one another. Use this API to obtain a snapshot of + * the configuration of IAM permissions (users, groups, roles, and policies) in your + * account.

+ * + *

Policies returned by this API are URL-encoded compliant + * with RFC 3986. You can use a URL + * decoding method to convert the policy back to plain JSON text. For example, if you use Java, you + * can use the decode method of the java.net.URLDecoder utility class in + * the Java SDK. Other languages and SDKs provide similar functionality.

+ *
+ *

You can optionally filter the results using the + * Filter parameter. You can paginate the results using the + * MaxItems and Marker parameters.

+ */ export class GetAccountAuthorizationDetailsCommand extends $Command< GetAccountAuthorizationDetailsCommandInput, GetAccountAuthorizationDetailsCommandOutput, @@ -34,6 +50,9 @@ export class GetAccountAuthorizationDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetAccountPasswordPolicyCommand.ts b/clients/client-iam/commands/GetAccountPasswordPolicyCommand.ts index f03c5a2e022ea..7be1210d07155 100644 --- a/clients/client-iam/commands/GetAccountPasswordPolicyCommand.ts +++ b/clients/client-iam/commands/GetAccountPasswordPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type GetAccountPasswordPolicyCommandInput = {}; export type GetAccountPasswordPolicyCommandOutput = GetAccountPasswordPolicyResponse & __MetadataBearer; +/** + *

Retrieves the password policy for the AWS account. For more information about using a + * password policy, go to Managing an IAM Password + * Policy.

+ */ export class GetAccountPasswordPolicyCommand extends $Command< GetAccountPasswordPolicyCommandInput, GetAccountPasswordPolicyCommandOutput, @@ -34,6 +39,9 @@ export class GetAccountPasswordPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetAccountSummaryCommand.ts b/clients/client-iam/commands/GetAccountSummaryCommand.ts index 8acd256456f2f..f208574fa457a 100644 --- a/clients/client-iam/commands/GetAccountSummaryCommand.ts +++ b/clients/client-iam/commands/GetAccountSummaryCommand.ts @@ -20,6 +20,11 @@ import { export type GetAccountSummaryCommandInput = {}; export type GetAccountSummaryCommandOutput = GetAccountSummaryResponse & __MetadataBearer; +/** + *

Retrieves information about IAM entity usage and IAM quotas in the AWS + * account.

+ *

The number and size of IAM resources in an AWS account are limited. For more information, see IAM and STS Quotas in the IAM User Guide.

+ */ export class GetAccountSummaryCommand extends $Command< GetAccountSummaryCommandInput, GetAccountSummaryCommandOutput, @@ -34,6 +39,9 @@ export class GetAccountSummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetContextKeysForCustomPolicyCommand.ts b/clients/client-iam/commands/GetContextKeysForCustomPolicyCommand.ts index 441cb3411be14..64e89c2613321 100644 --- a/clients/client-iam/commands/GetContextKeysForCustomPolicyCommand.ts +++ b/clients/client-iam/commands/GetContextKeysForCustomPolicyCommand.ts @@ -20,6 +20,17 @@ import { export type GetContextKeysForCustomPolicyCommandInput = GetContextKeysForCustomPolicyRequest; export type GetContextKeysForCustomPolicyCommandOutput = GetContextKeysForPolicyResponse & __MetadataBearer; +/** + *

Gets a list of all of the context keys referenced in the input policies. The policies + * are supplied as a list of one or more strings. To get the context keys from policies + * associated with an IAM user, group, or role, use GetContextKeysForPrincipalPolicy.

+ *

Context keys are variables maintained by AWS and its services that provide details + * about the context of an API query request. Context keys can be evaluated by testing against + * a value specified in an IAM policy. Use GetContextKeysForCustomPolicy to + * understand what key names and values you must supply when you call SimulateCustomPolicy. Note that all parameters are shown in unencoded form + * here for clarity but must be URL encoded to be included as a part of a real HTML + * request.

+ */ export class GetContextKeysForCustomPolicyCommand extends $Command< GetContextKeysForCustomPolicyCommandInput, GetContextKeysForCustomPolicyCommandOutput, @@ -34,6 +45,9 @@ export class GetContextKeysForCustomPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetContextKeysForPrincipalPolicyCommand.ts b/clients/client-iam/commands/GetContextKeysForPrincipalPolicyCommand.ts index a2c7f5ffd2bec..ba297a8e20367 100644 --- a/clients/client-iam/commands/GetContextKeysForPrincipalPolicyCommand.ts +++ b/clients/client-iam/commands/GetContextKeysForPrincipalPolicyCommand.ts @@ -20,6 +20,24 @@ import { export type GetContextKeysForPrincipalPolicyCommandInput = GetContextKeysForPrincipalPolicyRequest; export type GetContextKeysForPrincipalPolicyCommandOutput = GetContextKeysForPolicyResponse & __MetadataBearer; +/** + *

Gets a list of all of the context keys referenced in all the IAM policies that are + * attached to the specified IAM entity. The entity can be an IAM user, group, or role. If + * you specify a user, then the request also includes all of the policies attached to groups + * that the user is a member of.

+ *

You can optionally include a list of one or more additional policies, specified as + * strings. If you want to include only a list of policies by string, use + * GetContextKeysForCustomPolicy instead.

+ *

+ * Note: This API discloses information about the permissions + * granted to other users. If you do not want users to see other user's permissions, then + * consider allowing them to use GetContextKeysForCustomPolicy + * instead.

+ *

Context keys are variables maintained by AWS and its services that provide details + * about the context of an API query request. Context keys can be evaluated by testing against + * a value in an IAM policy. Use GetContextKeysForPrincipalPolicy to + * understand what key names and values you must supply when you call SimulatePrincipalPolicy.

+ */ export class GetContextKeysForPrincipalPolicyCommand extends $Command< GetContextKeysForPrincipalPolicyCommandInput, GetContextKeysForPrincipalPolicyCommandOutput, @@ -34,6 +52,9 @@ export class GetContextKeysForPrincipalPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetCredentialReportCommand.ts b/clients/client-iam/commands/GetCredentialReportCommand.ts index ec059275f0bf6..53c7f11f618f8 100644 --- a/clients/client-iam/commands/GetCredentialReportCommand.ts +++ b/clients/client-iam/commands/GetCredentialReportCommand.ts @@ -20,6 +20,11 @@ import { export type GetCredentialReportCommandInput = {}; export type GetCredentialReportCommandOutput = GetCredentialReportResponse & __MetadataBearer; +/** + *

Retrieves a credential report for the AWS account. For more information about the + * credential report, see Getting Credential Reports in the + * IAM User Guide.

+ */ export class GetCredentialReportCommand extends $Command< GetCredentialReportCommandInput, GetCredentialReportCommandOutput, @@ -34,6 +39,9 @@ export class GetCredentialReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetGroupCommand.ts b/clients/client-iam/commands/GetGroupCommand.ts index fd449548e2093..ad5f0aa533152 100644 --- a/clients/client-iam/commands/GetGroupCommand.ts +++ b/clients/client-iam/commands/GetGroupCommand.ts @@ -17,6 +17,10 @@ import { export type GetGroupCommandInput = GetGroupRequest; export type GetGroupCommandOutput = GetGroupResponse & __MetadataBearer; +/** + *

Returns a list of IAM users that are in the specified IAM group. You can paginate + * the results using the MaxItems and Marker parameters.

+ */ export class GetGroupCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +31,9 @@ export class GetGroupCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetGroupPolicyCommand.ts b/clients/client-iam/commands/GetGroupPolicyCommand.ts index bc32a82038c8d..ee96a74d83501 100644 --- a/clients/client-iam/commands/GetGroupPolicyCommand.ts +++ b/clients/client-iam/commands/GetGroupPolicyCommand.ts @@ -20,6 +20,22 @@ import { export type GetGroupPolicyCommandInput = GetGroupPolicyRequest; export type GetGroupPolicyCommandOutput = GetGroupPolicyResponse & __MetadataBearer; +/** + *

Retrieves the specified inline policy document that is embedded in the specified IAM + * group.

+ * + *

Policies returned by this API are URL-encoded compliant + * with RFC 3986. You can use a URL + * decoding method to convert the policy back to plain JSON text. For example, if you use Java, you + * can use the decode method of the java.net.URLDecoder utility class in + * the Java SDK. Other languages and SDKs provide similar functionality.

+ *
+ *

An IAM group can also have managed policies + * attached to it. To retrieve a managed policy document that is attached to a group, use + * GetPolicy to determine the policy's default version, then use GetPolicyVersion to retrieve the policy document.

+ *

For more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class GetGroupPolicyCommand extends $Command< GetGroupPolicyCommandInput, GetGroupPolicyCommandOutput, @@ -34,6 +50,9 @@ export class GetGroupPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetInstanceProfileCommand.ts b/clients/client-iam/commands/GetInstanceProfileCommand.ts index a7ca07b7be1de..e1d55eab8b475 100644 --- a/clients/client-iam/commands/GetInstanceProfileCommand.ts +++ b/clients/client-iam/commands/GetInstanceProfileCommand.ts @@ -20,6 +20,12 @@ import { export type GetInstanceProfileCommandInput = GetInstanceProfileRequest; export type GetInstanceProfileCommandOutput = GetInstanceProfileResponse & __MetadataBearer; +/** + *

Retrieves information about the specified instance profile, including the instance + * profile's path, GUID, ARN, and role. For more information about instance profiles, see + * About + * Instance Profiles in the IAM User Guide.

+ */ export class GetInstanceProfileCommand extends $Command< GetInstanceProfileCommandInput, GetInstanceProfileCommandOutput, @@ -34,6 +40,9 @@ export class GetInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetLoginProfileCommand.ts b/clients/client-iam/commands/GetLoginProfileCommand.ts index 6fd5b4203105a..2d90eceb6c41f 100644 --- a/clients/client-iam/commands/GetLoginProfileCommand.ts +++ b/clients/client-iam/commands/GetLoginProfileCommand.ts @@ -20,6 +20,11 @@ import { export type GetLoginProfileCommandInput = GetLoginProfileRequest; export type GetLoginProfileCommandOutput = GetLoginProfileResponse & __MetadataBearer; +/** + *

Retrieves the user name and password-creation date for the specified IAM user. If the + * user has not been assigned a password, the operation returns a 404 + * (NoSuchEntity) error.

+ */ export class GetLoginProfileCommand extends $Command< GetLoginProfileCommandInput, GetLoginProfileCommandOutput, @@ -34,6 +39,9 @@ export class GetLoginProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetOpenIDConnectProviderCommand.ts b/clients/client-iam/commands/GetOpenIDConnectProviderCommand.ts index 565ad5e1f379e..943a6e649dc4a 100644 --- a/clients/client-iam/commands/GetOpenIDConnectProviderCommand.ts +++ b/clients/client-iam/commands/GetOpenIDConnectProviderCommand.ts @@ -20,6 +20,10 @@ import { export type GetOpenIDConnectProviderCommandInput = GetOpenIDConnectProviderRequest; export type GetOpenIDConnectProviderCommandOutput = GetOpenIDConnectProviderResponse & __MetadataBearer; +/** + *

Returns information about the specified OpenID Connect (OIDC) provider resource object + * in IAM.

+ */ export class GetOpenIDConnectProviderCommand extends $Command< GetOpenIDConnectProviderCommandInput, GetOpenIDConnectProviderCommandOutput, @@ -34,6 +38,9 @@ export class GetOpenIDConnectProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetOrganizationsAccessReportCommand.ts b/clients/client-iam/commands/GetOrganizationsAccessReportCommand.ts index 03b1ad9b425a6..870e5f6122a0d 100644 --- a/clients/client-iam/commands/GetOrganizationsAccessReportCommand.ts +++ b/clients/client-iam/commands/GetOrganizationsAccessReportCommand.ts @@ -20,6 +20,25 @@ import { export type GetOrganizationsAccessReportCommandInput = GetOrganizationsAccessReportRequest; export type GetOrganizationsAccessReportCommandOutput = GetOrganizationsAccessReportResponse & __MetadataBearer; +/** + *

Retrieves the service last accessed data report for AWS Organizations that was previously generated + * using the + * GenerateOrganizationsAccessReport + * operation. This + * operation retrieves the status of your report job and the report contents.

+ *

Depending on the parameters that you passed when you generated the report, the data + * returned could include different information. For details, see GenerateOrganizationsAccessReport.

+ *

To call this operation, you must be signed in to the master account in your + * organization. SCPs must be enabled for your organization root. You must have permissions to + * perform this operation. For more information, see Refining Permissions Using + * Service Last Accessed Data in the IAM User Guide.

+ *

For each service that principals in an account (root users, IAM users, or IAM roles) + * could access using SCPs, the operation returns details about the most recent access + * attempt. If there was no attempt, the service is listed without details about the most + * recent attempt to access the service. If the operation fails, it returns the reason that it + * failed.

+ *

By default, the list is sorted by service namespace.

+ */ export class GetOrganizationsAccessReportCommand extends $Command< GetOrganizationsAccessReportCommandInput, GetOrganizationsAccessReportCommandOutput, @@ -34,6 +53,9 @@ export class GetOrganizationsAccessReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetPolicyCommand.ts b/clients/client-iam/commands/GetPolicyCommand.ts index 5f84f2622af82..5766d99ab1ce7 100644 --- a/clients/client-iam/commands/GetPolicyCommand.ts +++ b/clients/client-iam/commands/GetPolicyCommand.ts @@ -17,6 +17,18 @@ import { export type GetPolicyCommandInput = GetPolicyRequest; export type GetPolicyCommandOutput = GetPolicyResponse & __MetadataBearer; +/** + *

Retrieves information about the specified managed policy, including the policy's default + * version and the total number of IAM users, groups, and roles to which the policy is + * attached. To retrieve the list of the specific users, groups, and roles that the policy is + * attached to, use the ListEntitiesForPolicy API. This API returns metadata + * about the policy. To retrieve the actual policy document for a specific version of the + * policy, use GetPolicyVersion.

+ *

This API retrieves information about managed policies. To retrieve information about an + * inline policy that is embedded with an IAM user, group, or role, use the GetUserPolicy, GetGroupPolicy, or GetRolePolicy API.

+ *

For more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class GetPolicyCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +39,9 @@ export class GetPolicyCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetPolicyVersionCommand.ts b/clients/client-iam/commands/GetPolicyVersionCommand.ts index 2a09ea693070b..8ccd159bb20f5 100644 --- a/clients/client-iam/commands/GetPolicyVersionCommand.ts +++ b/clients/client-iam/commands/GetPolicyVersionCommand.ts @@ -20,6 +20,25 @@ import { export type GetPolicyVersionCommandInput = GetPolicyVersionRequest; export type GetPolicyVersionCommandOutput = GetPolicyVersionResponse & __MetadataBearer; +/** + *

Retrieves information about the specified version of the specified managed policy, + * including the policy document.

+ * + *

Policies returned by this API are URL-encoded compliant + * with RFC 3986. You can use a URL + * decoding method to convert the policy back to plain JSON text. For example, if you use Java, you + * can use the decode method of the java.net.URLDecoder utility class in + * the Java SDK. Other languages and SDKs provide similar functionality.

+ *
+ *

To list the available + * versions for a policy, use ListPolicyVersions.

+ *

This API retrieves information about managed policies. To retrieve information about an + * inline policy that is embedded in a user, group, or role, use the GetUserPolicy, GetGroupPolicy, or GetRolePolicy API.

+ *

For more information about the types of policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ *

For more information about managed policy versions, see Versioning for Managed + * Policies in the IAM User Guide.

+ */ export class GetPolicyVersionCommand extends $Command< GetPolicyVersionCommandInput, GetPolicyVersionCommandOutput, @@ -34,6 +53,9 @@ export class GetPolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetRoleCommand.ts b/clients/client-iam/commands/GetRoleCommand.ts index 74f81d47f32b1..c54a364eb7eee 100644 --- a/clients/client-iam/commands/GetRoleCommand.ts +++ b/clients/client-iam/commands/GetRoleCommand.ts @@ -17,6 +17,18 @@ import { export type GetRoleCommandInput = GetRoleRequest; export type GetRoleCommandOutput = GetRoleResponse & __MetadataBearer; +/** + *

Retrieves information about the specified role, including the role's path, GUID, ARN, + * and the role's trust policy that grants permission to assume the role. For more information + * about roles, see Working with Roles.

+ * + *

Policies returned by this API are URL-encoded compliant + * with RFC 3986. You can use a URL + * decoding method to convert the policy back to plain JSON text. For example, if you use Java, you + * can use the decode method of the java.net.URLDecoder utility class in + * the Java SDK. Other languages and SDKs provide similar functionality.

+ *
+ */ export class GetRoleCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +39,9 @@ export class GetRoleCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetRolePolicyCommand.ts b/clients/client-iam/commands/GetRolePolicyCommand.ts index 041dad45477c1..041d31dd7a4fb 100644 --- a/clients/client-iam/commands/GetRolePolicyCommand.ts +++ b/clients/client-iam/commands/GetRolePolicyCommand.ts @@ -20,6 +20,23 @@ import { export type GetRolePolicyCommandInput = GetRolePolicyRequest; export type GetRolePolicyCommandOutput = GetRolePolicyResponse & __MetadataBearer; +/** + *

Retrieves the specified inline policy document that is embedded with the specified IAM + * role.

+ * + *

Policies returned by this API are URL-encoded compliant + * with RFC 3986. You can use a URL + * decoding method to convert the policy back to plain JSON text. For example, if you use Java, you + * can use the decode method of the java.net.URLDecoder utility class in + * the Java SDK. Other languages and SDKs provide similar functionality.

+ *
+ *

An IAM role can also have managed policies + * attached to it. To retrieve a managed policy document that is attached to a role, use GetPolicy to determine the policy's default version, then use GetPolicyVersion to retrieve the policy document.

+ *

For more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ *

For more information about roles, see Using Roles to Delegate Permissions and + * Federate Identities.

+ */ export class GetRolePolicyCommand extends $Command< GetRolePolicyCommandInput, GetRolePolicyCommandOutput, @@ -34,6 +51,9 @@ export class GetRolePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetSAMLProviderCommand.ts b/clients/client-iam/commands/GetSAMLProviderCommand.ts index 7fd0ca7a8650b..31f472bec80c8 100644 --- a/clients/client-iam/commands/GetSAMLProviderCommand.ts +++ b/clients/client-iam/commands/GetSAMLProviderCommand.ts @@ -20,6 +20,13 @@ import { export type GetSAMLProviderCommandInput = GetSAMLProviderRequest; export type GetSAMLProviderCommandOutput = GetSAMLProviderResponse & __MetadataBearer; +/** + *

Returns the SAML provider metadocument that was uploaded when the IAM SAML provider + * resource object was created or updated.

+ * + *

This operation requires Signature Version 4.

+ *
+ */ export class GetSAMLProviderCommand extends $Command< GetSAMLProviderCommandInput, GetSAMLProviderCommandOutput, @@ -34,6 +41,9 @@ export class GetSAMLProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetSSHPublicKeyCommand.ts b/clients/client-iam/commands/GetSSHPublicKeyCommand.ts index a4a304ea26180..b013b5de13ae5 100644 --- a/clients/client-iam/commands/GetSSHPublicKeyCommand.ts +++ b/clients/client-iam/commands/GetSSHPublicKeyCommand.ts @@ -20,6 +20,13 @@ import { export type GetSSHPublicKeyCommandInput = GetSSHPublicKeyRequest; export type GetSSHPublicKeyCommandOutput = GetSSHPublicKeyResponse & __MetadataBearer; +/** + *

Retrieves the specified SSH public key, including metadata about the key.

+ *

The SSH public key retrieved by this operation is used only for authenticating the + * associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to + * authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH + * Connections in the AWS CodeCommit User Guide.

+ */ export class GetSSHPublicKeyCommand extends $Command< GetSSHPublicKeyCommandInput, GetSSHPublicKeyCommandOutput, @@ -34,6 +41,9 @@ export class GetSSHPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetServerCertificateCommand.ts b/clients/client-iam/commands/GetServerCertificateCommand.ts index 9073d9df129a8..cce8847049819 100644 --- a/clients/client-iam/commands/GetServerCertificateCommand.ts +++ b/clients/client-iam/commands/GetServerCertificateCommand.ts @@ -20,6 +20,13 @@ import { export type GetServerCertificateCommandInput = GetServerCertificateRequest; export type GetServerCertificateCommandOutput = GetServerCertificateResponse & __MetadataBearer; +/** + *

Retrieves information about the specified server certificate stored in IAM.

+ *

For more information about working with server certificates, see Working with + * Server Certificates in the IAM User Guide. This topic + * includes a list of AWS services that can use the server certificates that you manage with + * IAM.

+ */ export class GetServerCertificateCommand extends $Command< GetServerCertificateCommandInput, GetServerCertificateCommandOutput, @@ -34,6 +41,9 @@ export class GetServerCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetServiceLastAccessedDetailsCommand.ts b/clients/client-iam/commands/GetServiceLastAccessedDetailsCommand.ts index 98a670a7eb691..c53961125b8d8 100644 --- a/clients/client-iam/commands/GetServiceLastAccessedDetailsCommand.ts +++ b/clients/client-iam/commands/GetServiceLastAccessedDetailsCommand.ts @@ -20,6 +20,60 @@ import { export type GetServiceLastAccessedDetailsCommandInput = GetServiceLastAccessedDetailsRequest; export type GetServiceLastAccessedDetailsCommandOutput = GetServiceLastAccessedDetailsResponse & __MetadataBearer; +/** + *

Retrieves a service last accessed report that was created using the + * GenerateServiceLastAccessedDetails operation. You can use the + * JobId parameter in GetServiceLastAccessedDetails to retrieve + * the status of your report job. When the report is complete, you can retrieve the generated + * report. The report includes a list of AWS services that the resource (user, group, role, + * or managed policy) can access.

+ * + *

Service last accessed data does not use other policy types when determining whether a + * resource could access a service. These other policy types include resource-based + * policies, access control lists, AWS Organizations policies, IAM permissions boundaries, + * and AWS STS assume role policies. It only applies permissions policy logic. For more + * about the evaluation of policy types, see Evaluating Policies in the IAM User Guide.

+ *
+ *

For each service that the resource could access using permissions policies, the + * operation returns details about the most recent access attempt. If there was no attempt, + * the service is listed without details about the most recent attempt to access the service. + * If the operation fails, the GetServiceLastAccessedDetails operation returns + * the reason that it failed.

+ *

The GetServiceLastAccessedDetails operation returns a list of services. + * This list includes the number of entities that have attempted to access the service and the + * date and time of the last attempt. It also returns the ARN of the following entity, + * depending on the resource ARN that you used to generate the report:

+ *
    + *
  • + *

    + * User – Returns the user ARN that you used + * to generate the report

    + *
  • + *
  • + *

    + * Group – Returns the ARN of the group + * member (user) that last attempted to access the service

    + *
  • + *
  • + *

    + * Role – Returns the role ARN that you used + * to generate the report

    + *
  • + *
  • + *

    + * Policy – Returns the ARN of the user or + * role that last used the policy to attempt to access the service

    + *
  • + *
+ *

By default, the list is sorted by service namespace.

+ *

If you specified ACTION_LEVEL granularity when you generated the report, + * this operation returns service and action last accessed data. This includes the most recent + * access attempt for each tracked action within a service. Otherwise, this operation returns + * only service data.

+ *

For more information about service and action last accessed data, see Reducing + * Permissions Using Service Last Accessed Data in the + * IAM User Guide.

+ */ export class GetServiceLastAccessedDetailsCommand extends $Command< GetServiceLastAccessedDetailsCommandInput, GetServiceLastAccessedDetailsCommandOutput, @@ -34,6 +88,9 @@ export class GetServiceLastAccessedDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetServiceLastAccessedDetailsWithEntitiesCommand.ts b/clients/client-iam/commands/GetServiceLastAccessedDetailsWithEntitiesCommand.ts index 49676ae76b8d3..ab6a28e3514b2 100644 --- a/clients/client-iam/commands/GetServiceLastAccessedDetailsWithEntitiesCommand.ts +++ b/clients/client-iam/commands/GetServiceLastAccessedDetailsWithEntitiesCommand.ts @@ -24,6 +24,33 @@ export type GetServiceLastAccessedDetailsWithEntitiesCommandInput = GetServiceLa export type GetServiceLastAccessedDetailsWithEntitiesCommandOutput = GetServiceLastAccessedDetailsWithEntitiesResponse & __MetadataBearer; +/** + *

After you generate a group or policy report using the + * GenerateServiceLastAccessedDetails operation, you can use the + * JobId parameter in GetServiceLastAccessedDetailsWithEntities. + * This operation retrieves the status of your report job and a list of entities that could + * have used group or policy permissions to access the specified service.

+ *
    + *
  • + *

    + * Group – For a group report, this operation + * returns a list of users in the group that could have used the group’s policies in an + * attempt to access the service.

    + *
  • + *
  • + *

    + * Policy – For a policy report, this + * operation returns a list of entities (users or roles) that could have used the policy + * in an attempt to access the service.

    + *
  • + *
+ *

You can also use this operation for user or role reports to retrieve details about those + * entities.

+ *

If the operation fails, the GetServiceLastAccessedDetailsWithEntities + * operation returns the reason that it failed.

+ *

By default, the list of associated entities is sorted by date, with the most recent + * access listed first.

+ */ export class GetServiceLastAccessedDetailsWithEntitiesCommand extends $Command< GetServiceLastAccessedDetailsWithEntitiesCommandInput, GetServiceLastAccessedDetailsWithEntitiesCommandOutput, @@ -38,6 +65,9 @@ export class GetServiceLastAccessedDetailsWithEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetServiceLinkedRoleDeletionStatusCommand.ts b/clients/client-iam/commands/GetServiceLinkedRoleDeletionStatusCommand.ts index f4ba527fed91c..82a75fec95d5c 100644 --- a/clients/client-iam/commands/GetServiceLinkedRoleDeletionStatusCommand.ts +++ b/clients/client-iam/commands/GetServiceLinkedRoleDeletionStatusCommand.ts @@ -24,6 +24,13 @@ export type GetServiceLinkedRoleDeletionStatusCommandInput = GetServiceLinkedRol export type GetServiceLinkedRoleDeletionStatusCommandOutput = GetServiceLinkedRoleDeletionStatusResponse & __MetadataBearer; +/** + *

Retrieves the status of your service-linked role deletion. After you use the DeleteServiceLinkedRole API operation to submit a service-linked role for + * deletion, you can use the DeletionTaskId parameter in + * GetServiceLinkedRoleDeletionStatus to check the status of the deletion. If + * the deletion fails, this operation returns the reason that it failed, if that information + * is returned by the service.

+ */ export class GetServiceLinkedRoleDeletionStatusCommand extends $Command< GetServiceLinkedRoleDeletionStatusCommandInput, GetServiceLinkedRoleDeletionStatusCommandOutput, @@ -38,6 +45,9 @@ export class GetServiceLinkedRoleDeletionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetUserCommand.ts b/clients/client-iam/commands/GetUserCommand.ts index 257e43335cbd9..5cc6ac82e1511 100644 --- a/clients/client-iam/commands/GetUserCommand.ts +++ b/clients/client-iam/commands/GetUserCommand.ts @@ -17,6 +17,12 @@ import { export type GetUserCommandInput = GetUserRequest; export type GetUserCommandOutput = GetUserResponse & __MetadataBearer; +/** + *

Retrieves information about the specified IAM user, including the user's creation + * date, path, unique ID, and ARN.

+ *

If you do not specify a user name, IAM determines the user name implicitly based on + * the AWS access key ID used to sign the request to this API.

+ */ export class GetUserCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +33,9 @@ export class GetUserCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/GetUserPolicyCommand.ts b/clients/client-iam/commands/GetUserPolicyCommand.ts index 3df18daaebc7e..caea5e9a80e38 100644 --- a/clients/client-iam/commands/GetUserPolicyCommand.ts +++ b/clients/client-iam/commands/GetUserPolicyCommand.ts @@ -20,6 +20,21 @@ import { export type GetUserPolicyCommandInput = GetUserPolicyRequest; export type GetUserPolicyCommandOutput = GetUserPolicyResponse & __MetadataBearer; +/** + *

Retrieves the specified inline policy document that is embedded in the specified IAM + * user.

+ * + *

Policies returned by this API are URL-encoded compliant + * with RFC 3986. You can use a URL + * decoding method to convert the policy back to plain JSON text. For example, if you use Java, you + * can use the decode method of the java.net.URLDecoder utility class in + * the Java SDK. Other languages and SDKs provide similar functionality.

+ *
+ *

An IAM user can also have managed policies + * attached to it. To retrieve a managed policy document that is attached to a user, use GetPolicy to determine the policy's default version. Then use GetPolicyVersion to retrieve the policy document.

+ *

For more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class GetUserPolicyCommand extends $Command< GetUserPolicyCommandInput, GetUserPolicyCommandOutput, @@ -34,6 +49,9 @@ export class GetUserPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListAccessKeysCommand.ts b/clients/client-iam/commands/ListAccessKeysCommand.ts index 70c4972ecb670..e0646af837750 100644 --- a/clients/client-iam/commands/ListAccessKeysCommand.ts +++ b/clients/client-iam/commands/ListAccessKeysCommand.ts @@ -20,6 +20,21 @@ import { export type ListAccessKeysCommandInput = ListAccessKeysRequest; export type ListAccessKeysCommandOutput = ListAccessKeysResponse & __MetadataBearer; +/** + *

Returns information about the access key IDs associated with the specified IAM user. + * If there is none, the operation returns an empty list.

+ *

Although each user is limited to a small number of keys, you can still paginate the + * results using the MaxItems and Marker parameters.

+ *

If the UserName field is not specified, the user name is determined + * implicitly based on the AWS access key ID used to sign the request. This operation works + * for access keys under the AWS account. Consequently, you can use this operation to manage + * AWS account root user credentials even if the AWS account has no associated + * users.

+ * + *

To ensure the security of your AWS account, the secret access key is accessible + * only during key and user creation.

+ *
+ */ export class ListAccessKeysCommand extends $Command< ListAccessKeysCommandInput, ListAccessKeysCommandOutput, @@ -34,6 +49,9 @@ export class ListAccessKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListAccountAliasesCommand.ts b/clients/client-iam/commands/ListAccountAliasesCommand.ts index ea92380e47745..3f302b5b57f1b 100644 --- a/clients/client-iam/commands/ListAccountAliasesCommand.ts +++ b/clients/client-iam/commands/ListAccountAliasesCommand.ts @@ -20,6 +20,11 @@ import { export type ListAccountAliasesCommandInput = ListAccountAliasesRequest; export type ListAccountAliasesCommandOutput = ListAccountAliasesResponse & __MetadataBearer; +/** + *

Lists the account alias associated with the AWS account (Note: you can have only one). + * For information about using an AWS account alias, see Using an Alias for Your AWS Account ID + * in the IAM User Guide.

+ */ export class ListAccountAliasesCommand extends $Command< ListAccountAliasesCommandInput, ListAccountAliasesCommandOutput, @@ -34,6 +39,9 @@ export class ListAccountAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListAttachedGroupPoliciesCommand.ts b/clients/client-iam/commands/ListAttachedGroupPoliciesCommand.ts index 7ebe7f3edb600..147190224db0a 100644 --- a/clients/client-iam/commands/ListAttachedGroupPoliciesCommand.ts +++ b/clients/client-iam/commands/ListAttachedGroupPoliciesCommand.ts @@ -20,6 +20,18 @@ import { export type ListAttachedGroupPoliciesCommandInput = ListAttachedGroupPoliciesRequest; export type ListAttachedGroupPoliciesCommandOutput = ListAttachedGroupPoliciesResponse & __MetadataBearer; +/** + *

Lists all managed policies that are attached to the specified IAM group.

+ *

An IAM group can also have inline policies embedded with it. To list the inline + * policies for a group, use the ListGroupPolicies API. For information + * about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ *

You can paginate the results using the MaxItems and Marker + * parameters. You can use the PathPrefix parameter to limit the list of policies + * to only those matching the specified path prefix. If there are no policies attached to the + * specified group (or none that match the specified path prefix), the operation returns an + * empty list.

+ */ export class ListAttachedGroupPoliciesCommand extends $Command< ListAttachedGroupPoliciesCommandInput, ListAttachedGroupPoliciesCommandOutput, @@ -34,6 +46,9 @@ export class ListAttachedGroupPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListAttachedRolePoliciesCommand.ts b/clients/client-iam/commands/ListAttachedRolePoliciesCommand.ts index 9e1be860894e7..e0609a6885270 100644 --- a/clients/client-iam/commands/ListAttachedRolePoliciesCommand.ts +++ b/clients/client-iam/commands/ListAttachedRolePoliciesCommand.ts @@ -20,6 +20,18 @@ import { export type ListAttachedRolePoliciesCommandInput = ListAttachedRolePoliciesRequest; export type ListAttachedRolePoliciesCommandOutput = ListAttachedRolePoliciesResponse & __MetadataBearer; +/** + *

Lists all managed policies that are attached to the specified IAM role.

+ *

An IAM role can also have inline policies embedded with it. To list the inline + * policies for a role, use the ListRolePolicies API. For information about + * policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ *

You can paginate the results using the MaxItems and Marker + * parameters. You can use the PathPrefix parameter to limit the list of policies + * to only those matching the specified path prefix. If there are no policies attached to the + * specified role (or none that match the specified path prefix), the operation returns an + * empty list.

+ */ export class ListAttachedRolePoliciesCommand extends $Command< ListAttachedRolePoliciesCommandInput, ListAttachedRolePoliciesCommandOutput, @@ -34,6 +46,9 @@ export class ListAttachedRolePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListAttachedUserPoliciesCommand.ts b/clients/client-iam/commands/ListAttachedUserPoliciesCommand.ts index cb932fbf9eb10..5c3cc00bbc349 100644 --- a/clients/client-iam/commands/ListAttachedUserPoliciesCommand.ts +++ b/clients/client-iam/commands/ListAttachedUserPoliciesCommand.ts @@ -20,6 +20,18 @@ import { export type ListAttachedUserPoliciesCommandInput = ListAttachedUserPoliciesRequest; export type ListAttachedUserPoliciesCommandOutput = ListAttachedUserPoliciesResponse & __MetadataBearer; +/** + *

Lists all managed policies that are attached to the specified IAM user.

+ *

An IAM user can also have inline policies embedded with it. To list the inline + * policies for a user, use the ListUserPolicies API. For information about + * policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ *

You can paginate the results using the MaxItems and Marker + * parameters. You can use the PathPrefix parameter to limit the list of policies + * to only those matching the specified path prefix. If there are no policies attached to the + * specified group (or none that match the specified path prefix), the operation returns an + * empty list.

+ */ export class ListAttachedUserPoliciesCommand extends $Command< ListAttachedUserPoliciesCommandInput, ListAttachedUserPoliciesCommandOutput, @@ -34,6 +46,9 @@ export class ListAttachedUserPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListEntitiesForPolicyCommand.ts b/clients/client-iam/commands/ListEntitiesForPolicyCommand.ts index bdbc49f31cfe6..71d7a883acfe9 100644 --- a/clients/client-iam/commands/ListEntitiesForPolicyCommand.ts +++ b/clients/client-iam/commands/ListEntitiesForPolicyCommand.ts @@ -20,6 +20,16 @@ import { export type ListEntitiesForPolicyCommandInput = ListEntitiesForPolicyRequest; export type ListEntitiesForPolicyCommandOutput = ListEntitiesForPolicyResponse & __MetadataBearer; +/** + *

Lists all IAM users, groups, and roles that the specified managed policy is attached + * to.

+ *

You can use the optional EntityFilter parameter to limit the results to a + * particular type of entity (users, groups, or roles). For example, to list only the roles + * that are attached to the specified policy, set EntityFilter to + * Role.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListEntitiesForPolicyCommand extends $Command< ListEntitiesForPolicyCommandInput, ListEntitiesForPolicyCommandOutput, @@ -34,6 +44,9 @@ export class ListEntitiesForPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListGroupPoliciesCommand.ts b/clients/client-iam/commands/ListGroupPoliciesCommand.ts index 7327b438c6aa7..7afd6789dee6f 100644 --- a/clients/client-iam/commands/ListGroupPoliciesCommand.ts +++ b/clients/client-iam/commands/ListGroupPoliciesCommand.ts @@ -20,6 +20,17 @@ import { export type ListGroupPoliciesCommandInput = ListGroupPoliciesRequest; export type ListGroupPoliciesCommandOutput = ListGroupPoliciesResponse & __MetadataBearer; +/** + *

Lists the names of the inline policies that are embedded in the specified IAM + * group.

+ *

An IAM group can also have managed policies attached to it. To list the managed + * policies that are attached to a group, use ListAttachedGroupPolicies. For + * more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ *

You can paginate the results using the MaxItems and Marker + * parameters. If there are no inline policies embedded with the specified group, the + * operation returns an empty list.

+ */ export class ListGroupPoliciesCommand extends $Command< ListGroupPoliciesCommandInput, ListGroupPoliciesCommandOutput, @@ -34,6 +45,9 @@ export class ListGroupPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListGroupsCommand.ts b/clients/client-iam/commands/ListGroupsCommand.ts index 224f3ef97c1eb..86a6309b9c65e 100644 --- a/clients/client-iam/commands/ListGroupsCommand.ts +++ b/clients/client-iam/commands/ListGroupsCommand.ts @@ -17,6 +17,11 @@ import { export type ListGroupsCommandInput = ListGroupsRequest; export type ListGroupsCommandOutput = ListGroupsResponse & __MetadataBearer; +/** + *

Lists the IAM groups that have the specified path prefix.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListGroupsCommand extends $Command< ListGroupsCommandInput, ListGroupsCommandOutput, @@ -31,6 +36,9 @@ export class ListGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListGroupsForUserCommand.ts b/clients/client-iam/commands/ListGroupsForUserCommand.ts index 5f28a390ea679..0e6c121376654 100644 --- a/clients/client-iam/commands/ListGroupsForUserCommand.ts +++ b/clients/client-iam/commands/ListGroupsForUserCommand.ts @@ -20,6 +20,11 @@ import { export type ListGroupsForUserCommandInput = ListGroupsForUserRequest; export type ListGroupsForUserCommandOutput = ListGroupsForUserResponse & __MetadataBearer; +/** + *

Lists the IAM groups that the specified IAM user belongs to.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListGroupsForUserCommand extends $Command< ListGroupsForUserCommandInput, ListGroupsForUserCommandOutput, @@ -34,6 +39,9 @@ export class ListGroupsForUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListInstanceProfilesCommand.ts b/clients/client-iam/commands/ListInstanceProfilesCommand.ts index 9287197d301f9..b158db2728495 100644 --- a/clients/client-iam/commands/ListInstanceProfilesCommand.ts +++ b/clients/client-iam/commands/ListInstanceProfilesCommand.ts @@ -20,6 +20,13 @@ import { export type ListInstanceProfilesCommandInput = ListInstanceProfilesRequest; export type ListInstanceProfilesCommandOutput = ListInstanceProfilesResponse & __MetadataBearer; +/** + *

Lists the instance profiles that have the specified path prefix. If there are none, the + * operation returns an empty list. For more information about instance profiles, go to About Instance + * Profiles.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListInstanceProfilesCommand extends $Command< ListInstanceProfilesCommandInput, ListInstanceProfilesCommandOutput, @@ -34,6 +41,9 @@ export class ListInstanceProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListInstanceProfilesForRoleCommand.ts b/clients/client-iam/commands/ListInstanceProfilesForRoleCommand.ts index bfd2f9ed4fd47..21cda7bde96ca 100644 --- a/clients/client-iam/commands/ListInstanceProfilesForRoleCommand.ts +++ b/clients/client-iam/commands/ListInstanceProfilesForRoleCommand.ts @@ -20,6 +20,14 @@ import { export type ListInstanceProfilesForRoleCommandInput = ListInstanceProfilesForRoleRequest; export type ListInstanceProfilesForRoleCommandOutput = ListInstanceProfilesForRoleResponse & __MetadataBearer; +/** + *

Lists the instance profiles that have the specified associated IAM role. If there are + * none, the operation returns an empty list. For more information about instance profiles, go + * to About + * Instance Profiles.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListInstanceProfilesForRoleCommand extends $Command< ListInstanceProfilesForRoleCommandInput, ListInstanceProfilesForRoleCommandOutput, @@ -34,6 +42,9 @@ export class ListInstanceProfilesForRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListMFADevicesCommand.ts b/clients/client-iam/commands/ListMFADevicesCommand.ts index 59d5c18e551a0..2f1be508245b8 100644 --- a/clients/client-iam/commands/ListMFADevicesCommand.ts +++ b/clients/client-iam/commands/ListMFADevicesCommand.ts @@ -20,6 +20,14 @@ import { export type ListMFADevicesCommandInput = ListMFADevicesRequest; export type ListMFADevicesCommandOutput = ListMFADevicesResponse & __MetadataBearer; +/** + *

Lists the MFA devices for an IAM user. If the request includes a IAM user name, then + * this operation lists all the MFA devices associated with the specified user. If you do not + * specify a user name, IAM determines the user name implicitly based on the AWS access + * key ID signing the request for this API.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListMFADevicesCommand extends $Command< ListMFADevicesCommandInput, ListMFADevicesCommandOutput, @@ -34,6 +42,9 @@ export class ListMFADevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListOpenIDConnectProvidersCommand.ts b/clients/client-iam/commands/ListOpenIDConnectProvidersCommand.ts index fb8c2e19ea224..2031e01be0755 100644 --- a/clients/client-iam/commands/ListOpenIDConnectProvidersCommand.ts +++ b/clients/client-iam/commands/ListOpenIDConnectProvidersCommand.ts @@ -20,6 +20,10 @@ import { export type ListOpenIDConnectProvidersCommandInput = ListOpenIDConnectProvidersRequest; export type ListOpenIDConnectProvidersCommandOutput = ListOpenIDConnectProvidersResponse & __MetadataBearer; +/** + *

Lists information about the IAM OpenID Connect (OIDC) provider resource objects + * defined in the AWS account.

+ */ export class ListOpenIDConnectProvidersCommand extends $Command< ListOpenIDConnectProvidersCommandInput, ListOpenIDConnectProvidersCommandOutput, @@ -34,6 +38,9 @@ export class ListOpenIDConnectProvidersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListPoliciesCommand.ts b/clients/client-iam/commands/ListPoliciesCommand.ts index f4ef98c6ead08..0a6c0987d174f 100644 --- a/clients/client-iam/commands/ListPoliciesCommand.ts +++ b/clients/client-iam/commands/ListPoliciesCommand.ts @@ -17,6 +17,19 @@ import { export type ListPoliciesCommandInput = ListPoliciesRequest; export type ListPoliciesCommandOutput = ListPoliciesResponse & __MetadataBearer; +/** + *

Lists all the managed policies that are available in your AWS account, including your + * own customer-defined managed policies and all AWS managed policies.

+ *

You can filter the list of policies that is returned using the optional + * OnlyAttached, Scope, and PathPrefix parameters. + * For example, to list only the customer managed policies in your AWS account, set + * Scope to Local. To list only AWS managed policies, set + * Scope to AWS.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ *

For more information about managed policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class ListPoliciesCommand extends $Command< ListPoliciesCommandInput, ListPoliciesCommandOutput, @@ -31,6 +44,9 @@ export class ListPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListPoliciesGrantingServiceAccessCommand.ts b/clients/client-iam/commands/ListPoliciesGrantingServiceAccessCommand.ts index 3e842b507917b..9b1c8e43f711e 100644 --- a/clients/client-iam/commands/ListPoliciesGrantingServiceAccessCommand.ts +++ b/clients/client-iam/commands/ListPoliciesGrantingServiceAccessCommand.ts @@ -24,6 +24,48 @@ export type ListPoliciesGrantingServiceAccessCommandInput = ListPoliciesGranting export type ListPoliciesGrantingServiceAccessCommandOutput = ListPoliciesGrantingServiceAccessResponse & __MetadataBearer; +/** + *

Retrieves a list of policies that the IAM identity (user, group, or role) can use to + * access each specified service.

+ * + *

This operation does not use other policy types when determining whether a resource + * could access a service. These other policy types include resource-based policies, access + * control lists, AWS Organizations policies, IAM permissions boundaries, and AWS STS + * assume role policies. It only applies permissions policy logic. For more about the + * evaluation of policy types, see Evaluating Policies in the IAM User Guide.

+ *
+ *

The list of policies returned by the operation depends on the ARN of the identity that + * you provide.

+ *
    + *
  • + *

    + * User – The list of policies includes the + * managed and inline policies that are attached to the user directly. The list also + * includes any additional managed and inline policies that are attached to the group to + * which the user belongs.

    + *
  • + *
  • + *

    + * Group – The list of policies includes only + * the managed and inline policies that are attached to the group directly. Policies + * that are attached to the group’s user are not included.

    + *
  • + *
  • + *

    + * Role – The list of policies includes only + * the managed and inline policies that are attached to the role.

    + *
  • + *
+ *

For each managed policy, this operation returns the ARN and policy name. For each inline + * policy, it returns the policy name and the entity to which it is attached. Inline policies + * do not have an ARN. For more information about these policy types, see Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ *

Policies that are attached to users and roles as permissions boundaries are not + * returned. To view which managed policy is currently used to set the permissions boundary + * for a user or role, use the GetUser or GetRole + * operations.

+ */ export class ListPoliciesGrantingServiceAccessCommand extends $Command< ListPoliciesGrantingServiceAccessCommandInput, ListPoliciesGrantingServiceAccessCommandOutput, @@ -38,6 +80,9 @@ export class ListPoliciesGrantingServiceAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListPolicyVersionsCommand.ts b/clients/client-iam/commands/ListPolicyVersionsCommand.ts index e5dbad6cb05b3..6a8f51e2cac06 100644 --- a/clients/client-iam/commands/ListPolicyVersionsCommand.ts +++ b/clients/client-iam/commands/ListPolicyVersionsCommand.ts @@ -20,6 +20,12 @@ import { export type ListPolicyVersionsCommandInput = ListPolicyVersionsRequest; export type ListPolicyVersionsCommandOutput = ListPolicyVersionsResponse & __MetadataBearer; +/** + *

Lists information about the versions of the specified managed policy, including the + * version that is currently set as the policy's default version.

+ *

For more information about managed policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class ListPolicyVersionsCommand extends $Command< ListPolicyVersionsCommandInput, ListPolicyVersionsCommandOutput, @@ -34,6 +40,9 @@ export class ListPolicyVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListRolePoliciesCommand.ts b/clients/client-iam/commands/ListRolePoliciesCommand.ts index 31c1ca0e2358f..556e5b4f07e54 100644 --- a/clients/client-iam/commands/ListRolePoliciesCommand.ts +++ b/clients/client-iam/commands/ListRolePoliciesCommand.ts @@ -20,6 +20,17 @@ import { export type ListRolePoliciesCommandInput = ListRolePoliciesRequest; export type ListRolePoliciesCommandOutput = ListRolePoliciesResponse & __MetadataBearer; +/** + *

Lists the names of the inline policies that are embedded in the specified IAM + * role.

+ *

An IAM role can also have managed policies attached to it. To list the managed + * policies that are attached to a role, use ListAttachedRolePolicies. For + * more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ *

You can paginate the results using the MaxItems and Marker + * parameters. If there are no inline policies embedded with the specified role, the operation + * returns an empty list.

+ */ export class ListRolePoliciesCommand extends $Command< ListRolePoliciesCommandInput, ListRolePoliciesCommandOutput, @@ -34,6 +45,9 @@ export class ListRolePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListRoleTagsCommand.ts b/clients/client-iam/commands/ListRoleTagsCommand.ts index ad9eb1224c625..4d59fe9797240 100644 --- a/clients/client-iam/commands/ListRoleTagsCommand.ts +++ b/clients/client-iam/commands/ListRoleTagsCommand.ts @@ -17,6 +17,11 @@ import { export type ListRoleTagsCommandInput = ListRoleTagsRequest; export type ListRoleTagsCommandOutput = ListRoleTagsResponse & __MetadataBearer; +/** + *

Lists the tags that are attached to the specified role. The returned list of tags is + * sorted by tag key. For more information about tagging, see Tagging IAM Identities in the + * IAM User Guide.

+ */ export class ListRoleTagsCommand extends $Command< ListRoleTagsCommandInput, ListRoleTagsCommandOutput, @@ -31,6 +36,9 @@ export class ListRoleTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListRolesCommand.ts b/clients/client-iam/commands/ListRolesCommand.ts index dc669f1aba60e..fc878c1bc0dcb 100644 --- a/clients/client-iam/commands/ListRolesCommand.ts +++ b/clients/client-iam/commands/ListRolesCommand.ts @@ -17,6 +17,13 @@ import { export type ListRolesCommandInput = ListRolesRequest; export type ListRolesCommandOutput = ListRolesResponse & __MetadataBearer; +/** + *

Lists the IAM roles that have the specified path prefix. If there are none, the + * operation returns an empty list. For more information about roles, go to Working with + * Roles.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListRolesCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +34,9 @@ export class ListRolesCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListSAMLProvidersCommand.ts b/clients/client-iam/commands/ListSAMLProvidersCommand.ts index 2f22f7cd3a592..60c017329d7e9 100644 --- a/clients/client-iam/commands/ListSAMLProvidersCommand.ts +++ b/clients/client-iam/commands/ListSAMLProvidersCommand.ts @@ -20,6 +20,12 @@ import { export type ListSAMLProvidersCommandInput = ListSAMLProvidersRequest; export type ListSAMLProvidersCommandOutput = ListSAMLProvidersResponse & __MetadataBearer; +/** + *

Lists the SAML provider resource objects defined in IAM in the account.

+ * + *

This operation requires Signature Version 4.

+ *
+ */ export class ListSAMLProvidersCommand extends $Command< ListSAMLProvidersCommandInput, ListSAMLProvidersCommandOutput, @@ -34,6 +40,9 @@ export class ListSAMLProvidersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListSSHPublicKeysCommand.ts b/clients/client-iam/commands/ListSSHPublicKeysCommand.ts index ce42b813f7ef5..18416839aa863 100644 --- a/clients/client-iam/commands/ListSSHPublicKeysCommand.ts +++ b/clients/client-iam/commands/ListSSHPublicKeysCommand.ts @@ -20,6 +20,16 @@ import { export type ListSSHPublicKeysCommandInput = ListSSHPublicKeysRequest; export type ListSSHPublicKeysCommandOutput = ListSSHPublicKeysResponse & __MetadataBearer; +/** + *

Returns information about the SSH public keys associated with the specified IAM user. + * If none exists, the operation returns an empty list.

+ *

The SSH public keys returned by this operation are used only for authenticating the + * IAM user to an AWS CodeCommit repository. For more information about using SSH keys to + * authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH + * Connections in the AWS CodeCommit User Guide.

+ *

Although each user is limited to a small number of keys, you can still paginate the + * results using the MaxItems and Marker parameters.

+ */ export class ListSSHPublicKeysCommand extends $Command< ListSSHPublicKeysCommandInput, ListSSHPublicKeysCommandOutput, @@ -34,6 +44,9 @@ export class ListSSHPublicKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListServerCertificatesCommand.ts b/clients/client-iam/commands/ListServerCertificatesCommand.ts index feeb94f040e83..f81737669021d 100644 --- a/clients/client-iam/commands/ListServerCertificatesCommand.ts +++ b/clients/client-iam/commands/ListServerCertificatesCommand.ts @@ -20,6 +20,16 @@ import { export type ListServerCertificatesCommandInput = ListServerCertificatesRequest; export type ListServerCertificatesCommandOutput = ListServerCertificatesResponse & __MetadataBearer; +/** + *

Lists the server certificates stored in IAM that have the specified path prefix. If + * none exist, the operation returns an empty list.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ *

For more information about working with server certificates, see Working with + * Server Certificates in the IAM User Guide. This topic + * also includes a list of AWS services that can use the server certificates that you manage + * with IAM.

+ */ export class ListServerCertificatesCommand extends $Command< ListServerCertificatesCommandInput, ListServerCertificatesCommandOutput, @@ -34,6 +44,9 @@ export class ListServerCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListServiceSpecificCredentialsCommand.ts b/clients/client-iam/commands/ListServiceSpecificCredentialsCommand.ts index 477bc7ae740f1..98c8b82df84ab 100644 --- a/clients/client-iam/commands/ListServiceSpecificCredentialsCommand.ts +++ b/clients/client-iam/commands/ListServiceSpecificCredentialsCommand.ts @@ -20,6 +20,14 @@ import { export type ListServiceSpecificCredentialsCommandInput = ListServiceSpecificCredentialsRequest; export type ListServiceSpecificCredentialsCommandOutput = ListServiceSpecificCredentialsResponse & __MetadataBearer; +/** + *

Returns information about the service-specific credentials associated with the specified + * IAM user. If none exists, the operation returns an empty list. The service-specific + * credentials returned by this operation are used only for authenticating the IAM user to a + * specific service. For more information about using service-specific credentials to + * authenticate to an AWS service, see Set Up service-specific credentials in + * the AWS CodeCommit User Guide.

+ */ export class ListServiceSpecificCredentialsCommand extends $Command< ListServiceSpecificCredentialsCommandInput, ListServiceSpecificCredentialsCommandOutput, @@ -34,6 +42,9 @@ export class ListServiceSpecificCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListSigningCertificatesCommand.ts b/clients/client-iam/commands/ListSigningCertificatesCommand.ts index c9878ea226a38..666bc09e2d6ac 100644 --- a/clients/client-iam/commands/ListSigningCertificatesCommand.ts +++ b/clients/client-iam/commands/ListSigningCertificatesCommand.ts @@ -20,6 +20,18 @@ import { export type ListSigningCertificatesCommandInput = ListSigningCertificatesRequest; export type ListSigningCertificatesCommandOutput = ListSigningCertificatesResponse & __MetadataBearer; +/** + *

Returns information about the signing certificates associated with the specified IAM + * user. If none exists, the operation returns an empty list.

+ *

Although each user is limited to a small number of signing certificates, you can still + * paginate the results using the MaxItems and Marker + * parameters.

+ *

If the UserName field is not specified, the user name is determined + * implicitly based on the AWS access key ID used to sign the request for this API. This + * operation works for access keys under the AWS account. Consequently, you can use this + * operation to manage AWS account root user credentials even if the AWS account has no + * associated users.

+ */ export class ListSigningCertificatesCommand extends $Command< ListSigningCertificatesCommandInput, ListSigningCertificatesCommandOutput, @@ -34,6 +46,9 @@ export class ListSigningCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListUserPoliciesCommand.ts b/clients/client-iam/commands/ListUserPoliciesCommand.ts index 567bba9acd5f3..2c4c618ebb005 100644 --- a/clients/client-iam/commands/ListUserPoliciesCommand.ts +++ b/clients/client-iam/commands/ListUserPoliciesCommand.ts @@ -20,6 +20,16 @@ import { export type ListUserPoliciesCommandInput = ListUserPoliciesRequest; export type ListUserPoliciesCommandOutput = ListUserPoliciesResponse & __MetadataBearer; +/** + *

Lists the names of the inline policies embedded in the specified IAM user.

+ *

An IAM user can also have managed policies attached to it. To list the managed + * policies that are attached to a user, use ListAttachedUserPolicies. For + * more information about policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ *

You can paginate the results using the MaxItems and Marker + * parameters. If there are no inline policies embedded with the specified user, the operation + * returns an empty list.

+ */ export class ListUserPoliciesCommand extends $Command< ListUserPoliciesCommandInput, ListUserPoliciesCommandOutput, @@ -34,6 +44,9 @@ export class ListUserPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListUserTagsCommand.ts b/clients/client-iam/commands/ListUserTagsCommand.ts index ed8615336f7e0..4fb378793f5bf 100644 --- a/clients/client-iam/commands/ListUserTagsCommand.ts +++ b/clients/client-iam/commands/ListUserTagsCommand.ts @@ -17,6 +17,11 @@ import { export type ListUserTagsCommandInput = ListUserTagsRequest; export type ListUserTagsCommandOutput = ListUserTagsResponse & __MetadataBearer; +/** + *

Lists the tags that are attached to the specified user. The returned list of tags is + * sorted by tag key. For more information about tagging, see Tagging IAM Identities in the + * IAM User Guide.

+ */ export class ListUserTagsCommand extends $Command< ListUserTagsCommandInput, ListUserTagsCommandOutput, @@ -31,6 +36,9 @@ export class ListUserTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListUsersCommand.ts b/clients/client-iam/commands/ListUsersCommand.ts index b3a0096718e9d..78837f6050a2d 100644 --- a/clients/client-iam/commands/ListUsersCommand.ts +++ b/clients/client-iam/commands/ListUsersCommand.ts @@ -17,6 +17,13 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + *

Lists the IAM users that have the specified path prefix. If no path prefix is + * specified, the operation returns all users in the AWS account. If there are none, the + * operation returns an empty list.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListUsersCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +34,9 @@ export class ListUsersCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ListVirtualMFADevicesCommand.ts b/clients/client-iam/commands/ListVirtualMFADevicesCommand.ts index f1db964fe5d2a..b652813de5726 100644 --- a/clients/client-iam/commands/ListVirtualMFADevicesCommand.ts +++ b/clients/client-iam/commands/ListVirtualMFADevicesCommand.ts @@ -20,6 +20,14 @@ import { export type ListVirtualMFADevicesCommandInput = ListVirtualMFADevicesRequest; export type ListVirtualMFADevicesCommandOutput = ListVirtualMFADevicesResponse & __MetadataBearer; +/** + *

Lists the virtual MFA devices defined in the AWS account by assignment status. If you + * do not specify an assignment status, the operation returns a list of all virtual MFA + * devices. Assignment status can be Assigned, Unassigned, or + * Any.

+ *

You can paginate the results using the MaxItems and Marker + * parameters.

+ */ export class ListVirtualMFADevicesCommand extends $Command< ListVirtualMFADevicesCommandInput, ListVirtualMFADevicesCommandOutput, @@ -34,6 +42,9 @@ export class ListVirtualMFADevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/PutGroupPolicyCommand.ts b/clients/client-iam/commands/PutGroupPolicyCommand.ts index 87c9d33ea92c5..dad9b20945d80 100644 --- a/clients/client-iam/commands/PutGroupPolicyCommand.ts +++ b/clients/client-iam/commands/PutGroupPolicyCommand.ts @@ -20,6 +20,23 @@ import { export type PutGroupPolicyCommandInput = PutGroupPolicyRequest; export type PutGroupPolicyCommandOutput = __MetadataBearer; +/** + *

Adds or updates an inline policy document that is embedded in the specified IAM + * group.

+ *

A user can also have managed policies attached to it. To attach a managed policy to a + * group, use AttachGroupPolicy. To create a new managed policy, use CreatePolicy. For information about policies, see Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ *

For information about limits on the number of inline policies that you can embed in a + * group, see Limitations on IAM Entities in the + * IAM User Guide.

+ * + *

Because policy documents can be large, you should use POST rather than GET when + * calling PutGroupPolicy. For general information about using the Query API + * with IAM, go to Making Query Requests in the + * IAM User Guide.

+ *
+ */ export class PutGroupPolicyCommand extends $Command< PutGroupPolicyCommandInput, PutGroupPolicyCommandOutput, @@ -34,6 +51,9 @@ export class PutGroupPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/PutRolePermissionsBoundaryCommand.ts b/clients/client-iam/commands/PutRolePermissionsBoundaryCommand.ts index 8c54821e1c825..5dd9e8fe1628c 100644 --- a/clients/client-iam/commands/PutRolePermissionsBoundaryCommand.ts +++ b/clients/client-iam/commands/PutRolePermissionsBoundaryCommand.ts @@ -20,6 +20,20 @@ import { export type PutRolePermissionsBoundaryCommandInput = PutRolePermissionsBoundaryRequest; export type PutRolePermissionsBoundaryCommandOutput = __MetadataBearer; +/** + *

Adds or updates the policy that is specified as the IAM role's permissions boundary. + * You can use an AWS managed policy or a customer managed policy to set the boundary for a + * role. Use the boundary to control the maximum permissions that the role can have. Setting a + * permissions boundary is an advanced feature that can affect the permissions for the + * role.

+ *

You cannot set the boundary for a service-linked role.

+ * + *

Policies used as permissions boundaries do not provide permissions. You must also + * attach a permissions policy to the role. To learn how the effective permissions for a + * role are evaluated, see IAM JSON Policy + * Evaluation Logic in the IAM User Guide.

+ *
+ */ export class PutRolePermissionsBoundaryCommand extends $Command< PutRolePermissionsBoundaryCommandInput, PutRolePermissionsBoundaryCommandOutput, @@ -34,6 +48,9 @@ export class PutRolePermissionsBoundaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/PutRolePolicyCommand.ts b/clients/client-iam/commands/PutRolePolicyCommand.ts index dfa7237aba15e..4b8ac01f7e2d8 100644 --- a/clients/client-iam/commands/PutRolePolicyCommand.ts +++ b/clients/client-iam/commands/PutRolePolicyCommand.ts @@ -20,6 +20,29 @@ import { export type PutRolePolicyCommandInput = PutRolePolicyRequest; export type PutRolePolicyCommandOutput = __MetadataBearer; +/** + *

Adds or updates an inline policy document that is embedded in the specified IAM + * role.

+ *

When you embed an inline policy in a role, the inline policy is used as part of the + * role's access (permissions) policy. The role's trust policy is created at the same time as + * the role, using CreateRole. You can update a role's trust policy using + * UpdateAssumeRolePolicy. For more information about IAM roles, go to + * Using Roles to + * Delegate Permissions and Federate Identities.

+ *

A role can also have a managed policy attached to it. To attach a managed policy to a + * role, use AttachRolePolicy. To create a new managed policy, use CreatePolicy. For information about policies, see Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ *

For information about limits on the number of inline policies that you can embed with a + * role, see Limitations on IAM Entities in the + * IAM User Guide.

+ * + *

Because policy documents can be large, you should use POST rather than GET when + * calling PutRolePolicy. For general information about using the Query API + * with IAM, go to Making Query Requests in the + * IAM User Guide.

+ *
+ */ export class PutRolePolicyCommand extends $Command< PutRolePolicyCommandInput, PutRolePolicyCommandOutput, @@ -34,6 +57,9 @@ export class PutRolePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/PutUserPermissionsBoundaryCommand.ts b/clients/client-iam/commands/PutUserPermissionsBoundaryCommand.ts index 87d9c1746f51a..7d131f8408cd5 100644 --- a/clients/client-iam/commands/PutUserPermissionsBoundaryCommand.ts +++ b/clients/client-iam/commands/PutUserPermissionsBoundaryCommand.ts @@ -20,6 +20,19 @@ import { export type PutUserPermissionsBoundaryCommandInput = PutUserPermissionsBoundaryRequest; export type PutUserPermissionsBoundaryCommandOutput = __MetadataBearer; +/** + *

Adds or updates the policy that is specified as the IAM user's permissions boundary. + * You can use an AWS managed policy or a customer managed policy to set the boundary for a + * user. Use the boundary to control the maximum permissions that the user can have. Setting a + * permissions boundary is an advanced feature that can affect the permissions for the + * user.

+ * + *

Policies that are used as permissions boundaries do not provide permissions. You must + * also attach a permissions policy to the user. To learn how the effective permissions for + * a user are evaluated, see IAM JSON Policy + * Evaluation Logic in the IAM User Guide.

+ *
+ */ export class PutUserPermissionsBoundaryCommand extends $Command< PutUserPermissionsBoundaryCommandInput, PutUserPermissionsBoundaryCommandOutput, @@ -34,6 +47,9 @@ export class PutUserPermissionsBoundaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/PutUserPolicyCommand.ts b/clients/client-iam/commands/PutUserPolicyCommand.ts index 9ac79eac47d43..cb4991a2a9db7 100644 --- a/clients/client-iam/commands/PutUserPolicyCommand.ts +++ b/clients/client-iam/commands/PutUserPolicyCommand.ts @@ -20,6 +20,24 @@ import { export type PutUserPolicyCommandInput = PutUserPolicyRequest; export type PutUserPolicyCommandOutput = __MetadataBearer; +/** + *

Adds or updates an inline policy document that is embedded in the specified IAM + * user.

+ *

An IAM user can also have a managed policy attached to it. To attach a managed policy + * to a user, use AttachUserPolicy. To create a new managed policy, use + * CreatePolicy. For information about policies, see Managed + * Policies and Inline Policies in the + * IAM User Guide.

+ *

For information about limits on the number of inline policies that you can embed in a + * user, see Limitations on IAM Entities in the + * IAM User Guide.

+ * + *

Because policy documents can be large, you should use POST rather than GET when + * calling PutUserPolicy. For general information about using the Query API + * with IAM, go to Making Query Requests in the + * IAM User Guide.

+ *
+ */ export class PutUserPolicyCommand extends $Command< PutUserPolicyCommandInput, PutUserPolicyCommandOutput, @@ -34,6 +52,9 @@ export class PutUserPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/RemoveClientIDFromOpenIDConnectProviderCommand.ts b/clients/client-iam/commands/RemoveClientIDFromOpenIDConnectProviderCommand.ts index 319993f5d1440..87a5c4b8dee80 100644 --- a/clients/client-iam/commands/RemoveClientIDFromOpenIDConnectProviderCommand.ts +++ b/clients/client-iam/commands/RemoveClientIDFromOpenIDConnectProviderCommand.ts @@ -20,6 +20,12 @@ import { export type RemoveClientIDFromOpenIDConnectProviderCommandInput = RemoveClientIDFromOpenIDConnectProviderRequest; export type RemoveClientIDFromOpenIDConnectProviderCommandOutput = __MetadataBearer; +/** + *

Removes the specified client ID (also known as audience) from the list of client IDs + * registered for the specified IAM OpenID Connect (OIDC) provider resource object.

+ *

This operation is idempotent; it does not fail or return an error if you try to remove a + * client ID that does not exist.

+ */ export class RemoveClientIDFromOpenIDConnectProviderCommand extends $Command< RemoveClientIDFromOpenIDConnectProviderCommandInput, RemoveClientIDFromOpenIDConnectProviderCommandOutput, @@ -34,6 +40,9 @@ export class RemoveClientIDFromOpenIDConnectProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/RemoveRoleFromInstanceProfileCommand.ts b/clients/client-iam/commands/RemoveRoleFromInstanceProfileCommand.ts index 3d4aa3b338f76..b0121674a3ff4 100644 --- a/clients/client-iam/commands/RemoveRoleFromInstanceProfileCommand.ts +++ b/clients/client-iam/commands/RemoveRoleFromInstanceProfileCommand.ts @@ -20,6 +20,17 @@ import { export type RemoveRoleFromInstanceProfileCommandInput = RemoveRoleFromInstanceProfileRequest; export type RemoveRoleFromInstanceProfileCommandOutput = __MetadataBearer; +/** + *

Removes the specified IAM role from the specified EC2 instance profile.

+ * + *

Make sure that you do not have any Amazon EC2 instances running with the role you are + * about to remove from the instance profile. Removing a role from an instance profile that + * is associated with a running instance might break any applications running on the + * instance.

+ *
+ *

For more information about IAM roles, go to Working with Roles. For more + * information about instance profiles, go to About Instance Profiles.

+ */ export class RemoveRoleFromInstanceProfileCommand extends $Command< RemoveRoleFromInstanceProfileCommandInput, RemoveRoleFromInstanceProfileCommandOutput, @@ -34,6 +45,9 @@ export class RemoveRoleFromInstanceProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/RemoveUserFromGroupCommand.ts b/clients/client-iam/commands/RemoveUserFromGroupCommand.ts index efd5814110734..6e0c9a34af306 100644 --- a/clients/client-iam/commands/RemoveUserFromGroupCommand.ts +++ b/clients/client-iam/commands/RemoveUserFromGroupCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveUserFromGroupCommandInput = RemoveUserFromGroupRequest; export type RemoveUserFromGroupCommandOutput = __MetadataBearer; +/** + *

Removes the specified user from the specified group.

+ */ export class RemoveUserFromGroupCommand extends $Command< RemoveUserFromGroupCommandInput, RemoveUserFromGroupCommandOutput, @@ -34,6 +37,9 @@ export class RemoveUserFromGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ResetServiceSpecificCredentialCommand.ts b/clients/client-iam/commands/ResetServiceSpecificCredentialCommand.ts index b3238052b0d04..b8f0a911304c6 100644 --- a/clients/client-iam/commands/ResetServiceSpecificCredentialCommand.ts +++ b/clients/client-iam/commands/ResetServiceSpecificCredentialCommand.ts @@ -20,6 +20,11 @@ import { export type ResetServiceSpecificCredentialCommandInput = ResetServiceSpecificCredentialRequest; export type ResetServiceSpecificCredentialCommandOutput = ResetServiceSpecificCredentialResponse & __MetadataBearer; +/** + *

Resets the password for a service-specific credential. The new password is AWS + * generated and cryptographically strong. It cannot be configured by the user. Resetting the + * password immediately invalidates the previous password associated with this user.

+ */ export class ResetServiceSpecificCredentialCommand extends $Command< ResetServiceSpecificCredentialCommandInput, ResetServiceSpecificCredentialCommandOutput, @@ -34,6 +39,9 @@ export class ResetServiceSpecificCredentialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/ResyncMFADeviceCommand.ts b/clients/client-iam/commands/ResyncMFADeviceCommand.ts index a5ea4c3d9ea33..95afddd193079 100644 --- a/clients/client-iam/commands/ResyncMFADeviceCommand.ts +++ b/clients/client-iam/commands/ResyncMFADeviceCommand.ts @@ -20,6 +20,12 @@ import { export type ResyncMFADeviceCommandInput = ResyncMFADeviceRequest; export type ResyncMFADeviceCommandOutput = __MetadataBearer; +/** + *

Synchronizes the specified MFA device with its IAM resource object on the AWS + * servers.

+ *

For more information about creating and working with virtual MFA devices, go to Using a Virtual MFA + * Device in the IAM User Guide.

+ */ export class ResyncMFADeviceCommand extends $Command< ResyncMFADeviceCommandInput, ResyncMFADeviceCommandOutput, @@ -34,6 +40,9 @@ export class ResyncMFADeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/SetDefaultPolicyVersionCommand.ts b/clients/client-iam/commands/SetDefaultPolicyVersionCommand.ts index b51ecf8bf8219..4aa18bc3b9231 100644 --- a/clients/client-iam/commands/SetDefaultPolicyVersionCommand.ts +++ b/clients/client-iam/commands/SetDefaultPolicyVersionCommand.ts @@ -20,6 +20,14 @@ import { export type SetDefaultPolicyVersionCommandInput = SetDefaultPolicyVersionRequest; export type SetDefaultPolicyVersionCommandOutput = __MetadataBearer; +/** + *

Sets the specified version of the specified policy as the policy's default (operative) + * version.

+ *

This operation affects all users, groups, and roles that the policy is attached to. To + * list the users, groups, and roles that the policy is attached to, use the ListEntitiesForPolicy API.

+ *

For information about managed policies, see Managed Policies and Inline + * Policies in the IAM User Guide.

+ */ export class SetDefaultPolicyVersionCommand extends $Command< SetDefaultPolicyVersionCommandInput, SetDefaultPolicyVersionCommandOutput, @@ -34,6 +42,9 @@ export class SetDefaultPolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/SetSecurityTokenServicePreferencesCommand.ts b/clients/client-iam/commands/SetSecurityTokenServicePreferencesCommand.ts index 3284fcbd0a190..c4323fb666e1c 100644 --- a/clients/client-iam/commands/SetSecurityTokenServicePreferencesCommand.ts +++ b/clients/client-iam/commands/SetSecurityTokenServicePreferencesCommand.ts @@ -20,6 +20,24 @@ import { export type SetSecurityTokenServicePreferencesCommandInput = SetSecurityTokenServicePreferencesRequest; export type SetSecurityTokenServicePreferencesCommandOutput = __MetadataBearer; +/** + *

Sets the specified version of the global endpoint token as the token version used for + * the AWS account.

+ *

By default, AWS Security Token Service (STS) is available as a global service, and all STS requests + * go to a single endpoint at https://sts.amazonaws.com. AWS recommends using + * Regional STS endpoints to reduce latency, build in redundancy, and increase session token + * availability. For information about Regional endpoints for STS, see AWS Regions and + * Endpoints in the AWS General Reference.

+ *

If you make an STS call to the global endpoint, the resulting session tokens might be + * valid in some Regions but not others. It depends on the version that is set in this + * operation. Version 1 tokens are valid only in AWS Regions that are available by default. + * These tokens do not work in manually enabled Regions, such as Asia Pacific (Hong Kong). + * Version 2 tokens are valid in all Regions. However, version 2 tokens are longer and might + * affect systems where you temporarily store tokens. For information, see Activating and Deactivating STS in an AWS Region in the + * IAM User Guide.

+ *

To view the current session token version, see the + * GlobalEndpointTokenVersion entry in the response of the GetAccountSummary operation.

+ */ export class SetSecurityTokenServicePreferencesCommand extends $Command< SetSecurityTokenServicePreferencesCommandInput, SetSecurityTokenServicePreferencesCommandOutput, @@ -34,6 +52,9 @@ export class SetSecurityTokenServicePreferencesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/SimulateCustomPolicyCommand.ts b/clients/client-iam/commands/SimulateCustomPolicyCommand.ts index 524f88016e7b4..9f0f97ad79cc2 100644 --- a/clients/client-iam/commands/SimulateCustomPolicyCommand.ts +++ b/clients/client-iam/commands/SimulateCustomPolicyCommand.ts @@ -20,6 +20,21 @@ import { export type SimulateCustomPolicyCommandInput = SimulateCustomPolicyRequest; export type SimulateCustomPolicyCommandOutput = SimulatePolicyResponse & __MetadataBearer; +/** + *

Simulate how a set of IAM policies and optionally a resource-based policy works with a + * list of API operations and AWS resources to determine the policies' effective + * permissions. The policies are provided as strings.

+ *

The simulation does not perform the API operations; it only checks the authorization to + * determine if the simulated policies allow or deny the operations.

+ *

If you want to simulate existing policies that are attached to an IAM user, group, or + * role, use SimulatePrincipalPolicy instead.

+ *

Context keys are variables that are maintained by AWS and its services and which + * provide details about the context of an API query request. You can use the + * Condition element of an IAM policy to evaluate context keys. To get the + * list of context keys that the policies require for correct simulation, use GetContextKeysForCustomPolicy.

+ *

If the output is long, you can use MaxItems and Marker + * parameters to paginate the results.

+ */ export class SimulateCustomPolicyCommand extends $Command< SimulateCustomPolicyCommandInput, SimulateCustomPolicyCommandOutput, @@ -34,6 +49,9 @@ export class SimulateCustomPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/SimulatePrincipalPolicyCommand.ts b/clients/client-iam/commands/SimulatePrincipalPolicyCommand.ts index 86188c406bf79..7e5061e7a9dc0 100644 --- a/clients/client-iam/commands/SimulatePrincipalPolicyCommand.ts +++ b/clients/client-iam/commands/SimulatePrincipalPolicyCommand.ts @@ -20,6 +20,30 @@ import { export type SimulatePrincipalPolicyCommandInput = SimulatePrincipalPolicyRequest; export type SimulatePrincipalPolicyCommandOutput = SimulatePolicyResponse & __MetadataBearer; +/** + *

Simulate how a set of IAM policies attached to an IAM entity works with a list of + * API operations and AWS resources to determine the policies' effective permissions. The + * entity can be an IAM user, group, or role. If you specify a user, then the simulation + * also includes all of the policies that are attached to groups that the user belongs + * to.

+ *

You can optionally include a list of one or more additional policies specified as + * strings to include in the simulation. If you want to simulate only policies specified as + * strings, use SimulateCustomPolicy instead.

+ *

You can also optionally include one resource-based policy to be evaluated with each of + * the resources included in the simulation.

+ *

The simulation does not perform the API operations; it only checks the authorization to + * determine if the simulated policies allow or deny the operations.

+ *

+ * Note: This API discloses information about the permissions + * granted to other users. If you do not want users to see other user's permissions, then + * consider allowing them to use SimulateCustomPolicy instead.

+ *

Context keys are variables maintained by AWS and its services that provide details + * about the context of an API query request. You can use the Condition element + * of an IAM policy to evaluate context keys. To get the list of context keys that the + * policies require for correct simulation, use GetContextKeysForPrincipalPolicy.

+ *

If the output is long, you can use the MaxItems and Marker + * parameters to paginate the results.

+ */ export class SimulatePrincipalPolicyCommand extends $Command< SimulatePrincipalPolicyCommandInput, SimulatePrincipalPolicyCommandOutput, @@ -34,6 +58,9 @@ export class SimulatePrincipalPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/TagRoleCommand.ts b/clients/client-iam/commands/TagRoleCommand.ts index 326afc18d94f9..15b48df896b54 100644 --- a/clients/client-iam/commands/TagRoleCommand.ts +++ b/clients/client-iam/commands/TagRoleCommand.ts @@ -17,6 +17,53 @@ import { export type TagRoleCommandInput = TagRoleRequest; export type TagRoleCommandOutput = __MetadataBearer; +/** + *

Adds one or more tags to an IAM role. The role can be a regular role or a + * service-linked role. If a tag with the same key name already exists, then that tag is + * overwritten with the new value.

+ *

A tag consists of a key name and an associated value. By assigning tags to your + * resources, you can do the following:

+ *
    + *
  • + *

    + * Administrative grouping and discovery - Attach + * tags to resources to aid in organization and search. For example, you could search for all + * resources with the key name Project and the value + * MyImportantProject. Or search for all resources with the key name + * Cost Center and the value 41200.

    + *
  • + *
  • + *

    + * Access control - Reference tags in IAM + * user-based and resource-based policies. You can use tags to restrict access to only an + * IAM user or role that has a specified tag attached. You can also restrict access to only + * those resources that have a certain tag attached. For examples of policies that show how + * to use tags to control access, see Control Access Using IAM Tags in the + * IAM User Guide.

    + *
  • + *
  • + *

    + * Cost allocation - Use tags to help track which + * individuals and teams are using which AWS resources.

    + *
  • + *
+ * + *
    + *
  • + *

    Make sure that you have no invalid tags and that you do not exceed the allowed + * number of tags per role. In either case, the entire request fails and + * no tags are added to the role.

    + *
  • + *
  • + *

    AWS always interprets the tag Value as a single string. If you + * need to store an array, you can store comma-separated values in the string. However, you + * must interpret the value in your code.

    + *
  • + *
+ *
+ *

For more information about tagging, see Tagging IAM Identities in the + * IAM User Guide.

+ */ export class TagRoleCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +74,9 @@ export class TagRoleCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/TagUserCommand.ts b/clients/client-iam/commands/TagUserCommand.ts index c26866b4e6b62..c4fbc55d1724e 100644 --- a/clients/client-iam/commands/TagUserCommand.ts +++ b/clients/client-iam/commands/TagUserCommand.ts @@ -17,6 +17,53 @@ import { export type TagUserCommandInput = TagUserRequest; export type TagUserCommandOutput = __MetadataBearer; +/** + *

Adds one or more tags to an IAM user. If a tag with the same key name already exists, + * then that tag is overwritten with the new value.

+ * + *

A tag consists of a key name and an associated value. By assigning tags to your + * resources, you can do the following:

+ *
    + *
  • + *

    + * Administrative grouping and discovery - Attach + * tags to resources to aid in organization and search. For example, you could search for all + * resources with the key name Project and the value + * MyImportantProject. Or search for all resources with the key name + * Cost Center and the value 41200.

    + *
  • + *
  • + *

    + * Access control - Reference tags in IAM + * user-based and resource-based policies. You can use tags to restrict access to only an + * IAM requesting user or to a role that has a specified tag attached. You can also + * restrict access to only those resources that have a certain tag attached. For examples of + * policies that show how to use tags to control access, see Control Access Using IAM Tags in the + * IAM User Guide.

    + *
  • + *
  • + *

    + * Cost allocation - Use tags to help track which + * individuals and teams are using which AWS resources.

    + *
  • + *
+ * + *
    + *
  • + *

    Make sure that you have no invalid tags and that you do not exceed the allowed + * number of tags per role. In either case, the entire request fails and + * no tags are added to the role.

    + *
  • + *
  • + *

    AWS always interprets the tag Value as a single string. If you + * need to store an array, you can store comma-separated values in the string. However, you + * must interpret the value in your code.

    + *
  • + *
+ *
+ *

For more information about tagging, see Tagging IAM Identities in the + * IAM User Guide.

+ */ export class TagUserCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +74,9 @@ export class TagUserCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UntagRoleCommand.ts b/clients/client-iam/commands/UntagRoleCommand.ts index 690b80981cf85..a4519d7bc6ac5 100644 --- a/clients/client-iam/commands/UntagRoleCommand.ts +++ b/clients/client-iam/commands/UntagRoleCommand.ts @@ -17,6 +17,11 @@ import { export type UntagRoleCommandInput = UntagRoleRequest; export type UntagRoleCommandOutput = __MetadataBearer; +/** + *

Removes the specified tags from the role. For more information about tagging, see + * Tagging IAM Identities + * in the IAM User Guide.

+ */ export class UntagRoleCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +32,9 @@ export class UntagRoleCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UntagUserCommand.ts b/clients/client-iam/commands/UntagUserCommand.ts index d43b66315f9f0..0cc2c4b33a0d7 100644 --- a/clients/client-iam/commands/UntagUserCommand.ts +++ b/clients/client-iam/commands/UntagUserCommand.ts @@ -17,6 +17,11 @@ import { export type UntagUserCommandInput = UntagUserRequest; export type UntagUserCommandOutput = __MetadataBearer; +/** + *

Removes the specified tags from the user. For more information about tagging, see + * Tagging IAM Identities + * in the IAM User Guide.

+ */ export class UntagUserCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +32,9 @@ export class UntagUserCommand extends $Command, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateAccessKeyCommand.ts b/clients/client-iam/commands/UpdateAccessKeyCommand.ts index 488c808d5bee7..907660d6250dd 100644 --- a/clients/client-iam/commands/UpdateAccessKeyCommand.ts +++ b/clients/client-iam/commands/UpdateAccessKeyCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateAccessKeyCommandInput = UpdateAccessKeyRequest; export type UpdateAccessKeyCommandOutput = __MetadataBearer; +/** + *

Changes the status of the specified access key from Active to Inactive, or vice versa. + * This operation can be used to disable a user's key as part of a key rotation + * workflow.

+ *

If the UserName is not specified, the user name is determined implicitly + * based on the AWS access key ID used to sign the request. This operation works for access + * keys under the AWS account. Consequently, you can use this operation to manage AWS + * account root user credentials even if the AWS account has no associated users.

+ *

For information about rotating keys, see Managing Keys and Certificates in + * the IAM User Guide.

+ */ export class UpdateAccessKeyCommand extends $Command< UpdateAccessKeyCommandInput, UpdateAccessKeyCommandOutput, @@ -34,6 +45,9 @@ export class UpdateAccessKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateAccountPasswordPolicyCommand.ts b/clients/client-iam/commands/UpdateAccountPasswordPolicyCommand.ts index 9b4a419d626f8..0c8f5d76aa67b 100644 --- a/clients/client-iam/commands/UpdateAccountPasswordPolicyCommand.ts +++ b/clients/client-iam/commands/UpdateAccountPasswordPolicyCommand.ts @@ -20,6 +20,23 @@ import { export type UpdateAccountPasswordPolicyCommandInput = UpdateAccountPasswordPolicyRequest; export type UpdateAccountPasswordPolicyCommandOutput = __MetadataBearer; +/** + *

Updates the password policy settings for the AWS account.

+ * + *
    + *
  • + *

    This operation does not support partial updates. No parameters are required, + * but if you do not specify a parameter, that parameter's value reverts to its + * default value. See the Request Parameters section + * for each parameter's default value. Also note that some parameters do not allow + * the default parameter to be explicitly set. Instead, to invoke the default value, + * do not include that parameter when you invoke the operation.

    + *
  • + *
+ *
+ *

For more information about using a password policy, see Managing an IAM Password + * Policy in the IAM User Guide.

+ */ export class UpdateAccountPasswordPolicyCommand extends $Command< UpdateAccountPasswordPolicyCommandInput, UpdateAccountPasswordPolicyCommandOutput, @@ -34,6 +51,9 @@ export class UpdateAccountPasswordPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateAssumeRolePolicyCommand.ts b/clients/client-iam/commands/UpdateAssumeRolePolicyCommand.ts index cd933a12eb7ae..906d5c99d8df6 100644 --- a/clients/client-iam/commands/UpdateAssumeRolePolicyCommand.ts +++ b/clients/client-iam/commands/UpdateAssumeRolePolicyCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateAssumeRolePolicyCommandInput = UpdateAssumeRolePolicyRequest; export type UpdateAssumeRolePolicyCommandOutput = __MetadataBearer; +/** + *

Updates the policy that grants an IAM entity permission to assume a role. This is + * typically referred to as the "role trust policy". For more information about roles, go to + * Using Roles to + * Delegate Permissions and Federate Identities.

+ */ export class UpdateAssumeRolePolicyCommand extends $Command< UpdateAssumeRolePolicyCommandInput, UpdateAssumeRolePolicyCommandOutput, @@ -34,6 +40,9 @@ export class UpdateAssumeRolePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateGroupCommand.ts b/clients/client-iam/commands/UpdateGroupCommand.ts index 78345cc35c005..1b82fa29fb163 100644 --- a/clients/client-iam/commands/UpdateGroupCommand.ts +++ b/clients/client-iam/commands/UpdateGroupCommand.ts @@ -17,6 +17,22 @@ import { export type UpdateGroupCommandInput = UpdateGroupRequest; export type UpdateGroupCommandOutput = __MetadataBearer; +/** + *

Updates the name and/or the path of the specified IAM group.

+ * + *

You should understand the implications of changing a group's path or name. For more + * information, see Renaming Users and + * Groups in the IAM User Guide.

+ *
+ * + *

The person making the request (the principal), must have permission to change the + * role group with the old name and the new name. For example, to change the group named + * Managers to MGRs, the principal must have a policy that + * allows them to update both groups. If the principal has permission to update the + * Managers group, but not the MGRs group, then the update + * fails. For more information about permissions, see Access Management.

+ *
+ */ export class UpdateGroupCommand extends $Command< UpdateGroupCommandInput, UpdateGroupCommandOutput, @@ -31,6 +47,9 @@ export class UpdateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateLoginProfileCommand.ts b/clients/client-iam/commands/UpdateLoginProfileCommand.ts index 93e6b9a9f352c..68836417498f7 100644 --- a/clients/client-iam/commands/UpdateLoginProfileCommand.ts +++ b/clients/client-iam/commands/UpdateLoginProfileCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateLoginProfileCommandInput = UpdateLoginProfileRequest; export type UpdateLoginProfileCommandOutput = __MetadataBearer; +/** + *

Changes the password for the specified IAM user.

+ *

IAM users can change their own passwords by calling ChangePassword. + * For more information about modifying passwords, see Managing Passwords in the + * IAM User Guide.

+ */ export class UpdateLoginProfileCommand extends $Command< UpdateLoginProfileCommandInput, UpdateLoginProfileCommandOutput, @@ -34,6 +40,9 @@ export class UpdateLoginProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateOpenIDConnectProviderThumbprintCommand.ts b/clients/client-iam/commands/UpdateOpenIDConnectProviderThumbprintCommand.ts index 51094d67f67e6..b0289e83ba5ac 100644 --- a/clients/client-iam/commands/UpdateOpenIDConnectProviderThumbprintCommand.ts +++ b/clients/client-iam/commands/UpdateOpenIDConnectProviderThumbprintCommand.ts @@ -20,6 +20,22 @@ import { export type UpdateOpenIDConnectProviderThumbprintCommandInput = UpdateOpenIDConnectProviderThumbprintRequest; export type UpdateOpenIDConnectProviderThumbprintCommandOutput = __MetadataBearer; +/** + *

Replaces the existing list of server certificate thumbprints associated with an OpenID + * Connect (OIDC) provider resource object with a new list of thumbprints.

+ *

The list that you pass with this operation completely replaces the existing list of + * thumbprints. (The lists are not merged.)

+ *

Typically, you need to update a thumbprint only when the identity provider's certificate + * changes, which occurs rarely. However, if the provider's certificate + * does change, any attempt to assume an IAM role that specifies the + * OIDC provider as a principal fails until the certificate thumbprint is updated.

+ * + *

Trust for the OIDC provider is derived from the provider's certificate and is + * validated by the thumbprint. Therefore, it is best to limit access to the + * UpdateOpenIDConnectProviderThumbprint operation to highly privileged + * users.

+ *
+ */ export class UpdateOpenIDConnectProviderThumbprintCommand extends $Command< UpdateOpenIDConnectProviderThumbprintCommandInput, UpdateOpenIDConnectProviderThumbprintCommandOutput, @@ -34,6 +50,9 @@ export class UpdateOpenIDConnectProviderThumbprintCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateRoleCommand.ts b/clients/client-iam/commands/UpdateRoleCommand.ts index a58eb92a875a5..45c0cbd3cf0e0 100644 --- a/clients/client-iam/commands/UpdateRoleCommand.ts +++ b/clients/client-iam/commands/UpdateRoleCommand.ts @@ -17,6 +17,9 @@ import { export type UpdateRoleCommandInput = UpdateRoleRequest; export type UpdateRoleCommandOutput = UpdateRoleResponse & __MetadataBearer; +/** + *

Updates the description or maximum session duration setting of a role.

+ */ export class UpdateRoleCommand extends $Command< UpdateRoleCommandInput, UpdateRoleCommandOutput, @@ -31,6 +34,9 @@ export class UpdateRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateRoleDescriptionCommand.ts b/clients/client-iam/commands/UpdateRoleDescriptionCommand.ts index 72336ff7249e0..cb2fe7a5997fa 100644 --- a/clients/client-iam/commands/UpdateRoleDescriptionCommand.ts +++ b/clients/client-iam/commands/UpdateRoleDescriptionCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateRoleDescriptionCommandInput = UpdateRoleDescriptionRequest; export type UpdateRoleDescriptionCommandOutput = UpdateRoleDescriptionResponse & __MetadataBearer; +/** + *

Use UpdateRole instead.

+ *

Modifies only the description of a role. This operation performs the same function as + * the Description parameter in the UpdateRole operation.

+ */ export class UpdateRoleDescriptionCommand extends $Command< UpdateRoleDescriptionCommandInput, UpdateRoleDescriptionCommandOutput, @@ -34,6 +39,9 @@ export class UpdateRoleDescriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateSAMLProviderCommand.ts b/clients/client-iam/commands/UpdateSAMLProviderCommand.ts index 003d102f506ea..ca14e2fb92e55 100644 --- a/clients/client-iam/commands/UpdateSAMLProviderCommand.ts +++ b/clients/client-iam/commands/UpdateSAMLProviderCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateSAMLProviderCommandInput = UpdateSAMLProviderRequest; export type UpdateSAMLProviderCommandOutput = UpdateSAMLProviderResponse & __MetadataBearer; +/** + *

Updates the metadata document for an existing SAML provider resource object.

+ * + *

This operation requires Signature Version 4.

+ *
+ */ export class UpdateSAMLProviderCommand extends $Command< UpdateSAMLProviderCommandInput, UpdateSAMLProviderCommandOutput, @@ -34,6 +40,9 @@ export class UpdateSAMLProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateSSHPublicKeyCommand.ts b/clients/client-iam/commands/UpdateSSHPublicKeyCommand.ts index f92b685c4de9b..63fd02a300b6e 100644 --- a/clients/client-iam/commands/UpdateSSHPublicKeyCommand.ts +++ b/clients/client-iam/commands/UpdateSSHPublicKeyCommand.ts @@ -20,6 +20,15 @@ import { export type UpdateSSHPublicKeyCommandInput = UpdateSSHPublicKeyRequest; export type UpdateSSHPublicKeyCommandOutput = __MetadataBearer; +/** + *

Sets the status of an IAM user's SSH public key to active or inactive. SSH public keys + * that are inactive cannot be used for authentication. This operation can be used to disable + * a user's SSH public key as part of a key rotation work flow.

+ *

The SSH public key affected by this operation is used only for authenticating the + * associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to + * authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH + * Connections in the AWS CodeCommit User Guide.

+ */ export class UpdateSSHPublicKeyCommand extends $Command< UpdateSSHPublicKeyCommandInput, UpdateSSHPublicKeyCommandOutput, @@ -34,6 +43,9 @@ export class UpdateSSHPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateServerCertificateCommand.ts b/clients/client-iam/commands/UpdateServerCertificateCommand.ts index c4c74fbff0f9a..f6ec8a8123265 100644 --- a/clients/client-iam/commands/UpdateServerCertificateCommand.ts +++ b/clients/client-iam/commands/UpdateServerCertificateCommand.ts @@ -20,6 +20,29 @@ import { export type UpdateServerCertificateCommandInput = UpdateServerCertificateRequest; export type UpdateServerCertificateCommandOutput = __MetadataBearer; +/** + *

Updates the name and/or the path of the specified server certificate stored in + * IAM.

+ *

For more information about working with server certificates, see Working with + * Server Certificates in the IAM User Guide. This topic + * also includes a list of AWS services that can use the server certificates that you manage + * with IAM.

+ * + *

You should understand the implications of changing a server certificate's path or + * name. For more information, see Renaming a Server Certificate in the + * IAM User Guide.

+ *
+ * + *

The person making the request (the principal), must have permission to change the + * server certificate with the old name and the new name. For example, to change the + * certificate named ProductionCert to ProdCert, the principal + * must have a policy that allows them to update both certificates. If the principal has + * permission to update the ProductionCert group, but not the + * ProdCert certificate, then the update fails. For more information about + * permissions, see Access + * Management in the IAM User Guide.

+ *
+ */ export class UpdateServerCertificateCommand extends $Command< UpdateServerCertificateCommandInput, UpdateServerCertificateCommandOutput, @@ -34,6 +57,9 @@ export class UpdateServerCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateServiceSpecificCredentialCommand.ts b/clients/client-iam/commands/UpdateServiceSpecificCredentialCommand.ts index 69b88ba53f646..0b70914710d15 100644 --- a/clients/client-iam/commands/UpdateServiceSpecificCredentialCommand.ts +++ b/clients/client-iam/commands/UpdateServiceSpecificCredentialCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateServiceSpecificCredentialCommandInput = UpdateServiceSpecificCredentialRequest; export type UpdateServiceSpecificCredentialCommandOutput = __MetadataBearer; +/** + *

Sets the status of a service-specific credential to Active or + * Inactive. Service-specific credentials that are inactive cannot be used for + * authentication to the service. This operation can be used to disable a user's + * service-specific credential as part of a credential rotation work flow.

+ */ export class UpdateServiceSpecificCredentialCommand extends $Command< UpdateServiceSpecificCredentialCommandInput, UpdateServiceSpecificCredentialCommandOutput, @@ -34,6 +40,9 @@ export class UpdateServiceSpecificCredentialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateSigningCertificateCommand.ts b/clients/client-iam/commands/UpdateSigningCertificateCommand.ts index e63bb513f4851..88568eb6dee1e 100644 --- a/clients/client-iam/commands/UpdateSigningCertificateCommand.ts +++ b/clients/client-iam/commands/UpdateSigningCertificateCommand.ts @@ -20,6 +20,16 @@ import { export type UpdateSigningCertificateCommandInput = UpdateSigningCertificateRequest; export type UpdateSigningCertificateCommandOutput = __MetadataBearer; +/** + *

Changes the status of the specified user signing certificate from active to disabled, or + * vice versa. This operation can be used to disable an IAM user's signing certificate as + * part of a certificate rotation work flow.

+ *

If the UserName field is not specified, the user name is determined + * implicitly based on the AWS access key ID used to sign the request. This operation works + * for access keys under the AWS account. Consequently, you can use this operation to manage + * AWS account root user credentials even if the AWS account has no associated + * users.

+ */ export class UpdateSigningCertificateCommand extends $Command< UpdateSigningCertificateCommandInput, UpdateSigningCertificateCommandOutput, @@ -34,6 +44,9 @@ export class UpdateSigningCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UpdateUserCommand.ts b/clients/client-iam/commands/UpdateUserCommand.ts index 81c9fc18469ab..9c696229f69d6 100644 --- a/clients/client-iam/commands/UpdateUserCommand.ts +++ b/clients/client-iam/commands/UpdateUserCommand.ts @@ -17,6 +17,22 @@ import { export type UpdateUserCommandInput = UpdateUserRequest; export type UpdateUserCommandOutput = __MetadataBearer; +/** + *

Updates the name and/or the path of the specified IAM user.

+ * + *

You should understand the implications of changing an IAM user's path or name. For + * more information, see Renaming an IAM + * User and Renaming an IAM Group in + * the IAM User Guide.

+ *
+ * + *

To change a user name, the requester must have appropriate permissions on both the + * source object and the target object. For example, to change Bob to Robert, the entity + * making the request must have permission on Bob and Robert, or must have permission on + * all (*). For more information about permissions, see Permissions and Policies. + *

+ *
+ */ export class UpdateUserCommand extends $Command< UpdateUserCommandInput, UpdateUserCommandOutput, @@ -31,6 +47,9 @@ export class UpdateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UploadSSHPublicKeyCommand.ts b/clients/client-iam/commands/UploadSSHPublicKeyCommand.ts index 021105a1b2479..37af2fad1e87c 100644 --- a/clients/client-iam/commands/UploadSSHPublicKeyCommand.ts +++ b/clients/client-iam/commands/UploadSSHPublicKeyCommand.ts @@ -20,6 +20,13 @@ import { export type UploadSSHPublicKeyCommandInput = UploadSSHPublicKeyRequest; export type UploadSSHPublicKeyCommandOutput = UploadSSHPublicKeyResponse & __MetadataBearer; +/** + *

Uploads an SSH public key and associates it with the specified IAM user.

+ *

The SSH public key uploaded by this operation can be used only for authenticating the + * associated IAM user to an AWS CodeCommit repository. For more information about using SSH keys to + * authenticate to an AWS CodeCommit repository, see Set up AWS CodeCommit for SSH + * Connections in the AWS CodeCommit User Guide.

+ */ export class UploadSSHPublicKeyCommand extends $Command< UploadSSHPublicKeyCommandInput, UploadSSHPublicKeyCommandOutput, @@ -34,6 +41,9 @@ export class UploadSSHPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UploadServerCertificateCommand.ts b/clients/client-iam/commands/UploadServerCertificateCommand.ts index 089c357538f06..91ef42a38551a 100644 --- a/clients/client-iam/commands/UploadServerCertificateCommand.ts +++ b/clients/client-iam/commands/UploadServerCertificateCommand.ts @@ -20,6 +20,32 @@ import { export type UploadServerCertificateCommandInput = UploadServerCertificateRequest; export type UploadServerCertificateCommandOutput = UploadServerCertificateResponse & __MetadataBearer; +/** + *

Uploads a server certificate entity for the AWS account. The server certificate entity + * includes a public key certificate, a private key, and an optional certificate chain, which + * should all be PEM-encoded.

+ *

We recommend that you use AWS Certificate + * Manager to provision, manage, and deploy your server certificates. With ACM you + * can request a certificate, deploy it to AWS resources, and let ACM handle certificate + * renewals for you. Certificates provided by ACM are free. For more information about using + * ACM, see the AWS Certificate + * Manager User Guide.

+ *

For more information about working with server certificates, see Working with + * Server Certificates in the IAM User Guide. This topic + * includes a list of AWS services that can use the server certificates that you manage with + * IAM.

+ *

For information about the number of server certificates you can upload, see Limitations on IAM + * Entities and Objects in the IAM User Guide.

+ * + *

Because the body of the public key certificate, private key, and the certificate + * chain can be large, you should use POST rather than GET when calling + * UploadServerCertificate. For information about setting up signatures and + * authorization through the API, go to Signing AWS API Requests + * in the AWS General Reference. For general information about using the + * Query API with IAM, go to Calling the API by Making HTTP Query + * Requests in the IAM User Guide.

+ *
+ */ export class UploadServerCertificateCommand extends $Command< UploadServerCertificateCommandInput, UploadServerCertificateCommandOutput, @@ -34,6 +60,9 @@ export class UploadServerCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/commands/UploadSigningCertificateCommand.ts b/clients/client-iam/commands/UploadSigningCertificateCommand.ts index 8c82ef1e5c5af..65f151e179109 100644 --- a/clients/client-iam/commands/UploadSigningCertificateCommand.ts +++ b/clients/client-iam/commands/UploadSigningCertificateCommand.ts @@ -20,6 +20,25 @@ import { export type UploadSigningCertificateCommandInput = UploadSigningCertificateRequest; export type UploadSigningCertificateCommandOutput = UploadSigningCertificateResponse & __MetadataBearer; +/** + *

Uploads an X.509 signing certificate and associates it with the specified IAM user. + * Some AWS services use X.509 signing certificates to validate requests that are signed + * with a corresponding private key. When you upload the certificate, its default status is + * Active.

+ *

If the UserName is not specified, the IAM user name is determined + * implicitly based on the AWS access key ID used to sign the request. This operation works + * for access keys under the AWS account. Consequently, you can use this operation to manage + * AWS account root user credentials even if the AWS account has no associated + * users.

+ * + *

Because the body of an X.509 certificate can be large, you should use POST rather + * than GET when calling UploadSigningCertificate. For information about + * setting up signatures and authorization through the API, go to Signing AWS + * API Requests in the AWS General Reference. For general + * information about using the Query API with IAM, go to Making Query Requests in the + * IAM User Guide.

+ *
+ */ export class UploadSigningCertificateCommand extends $Command< UploadSigningCertificateCommandInput, UploadSigningCertificateCommandOutput, @@ -34,6 +53,9 @@ export class UploadSigningCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IAMClientResolvedConfig, diff --git a/clients/client-iam/package.json b/clients/client-iam/package.json index 975d1cde5832a..f3ceed1855409 100644 --- a/clients/client-iam/package.json +++ b/clients/client-iam/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iam Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iam/pagination/GetAccountAuthorizationDetailsPaginator.ts b/clients/client-iam/pagination/GetAccountAuthorizationDetailsPaginator.ts index 55a2272bca48d..a8a8715391dd7 100644 --- a/clients/client-iam/pagination/GetAccountAuthorizationDetailsPaginator.ts +++ b/clients/client-iam/pagination/GetAccountAuthorizationDetailsPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: GetAccountAuthorizationDetailsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetAccountAuthorizationDetailsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: GetAccountAuthorizationDetailsCommandInput, diff --git a/clients/client-iam/pagination/GetGroupPaginator.ts b/clients/client-iam/pagination/GetGroupPaginator.ts index 03178a381df01..0062f2dbe9f18 100644 --- a/clients/client-iam/pagination/GetGroupPaginator.ts +++ b/clients/client-iam/pagination/GetGroupPaginator.ts @@ -4,6 +4,9 @@ import { GetGroupCommand, GetGroupCommandInput, GetGroupCommandOutput } from ".. import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: GetGroupCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetGroupCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: GetGroupCommandInput, diff --git a/clients/client-iam/pagination/ListAccessKeysPaginator.ts b/clients/client-iam/pagination/ListAccessKeysPaginator.ts index 4c6be08a49f93..e9a38e3fa274b 100644 --- a/clients/client-iam/pagination/ListAccessKeysPaginator.ts +++ b/clients/client-iam/pagination/ListAccessKeysPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListAccessKeysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccessKeysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListAccessKeysCommandInput, diff --git a/clients/client-iam/pagination/ListAccountAliasesPaginator.ts b/clients/client-iam/pagination/ListAccountAliasesPaginator.ts index 858ee4831e48e..472ddfabdd0bf 100644 --- a/clients/client-iam/pagination/ListAccountAliasesPaginator.ts +++ b/clients/client-iam/pagination/ListAccountAliasesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListAccountAliasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListAccountAliasesCommandInput, diff --git a/clients/client-iam/pagination/ListAttachedGroupPoliciesPaginator.ts b/clients/client-iam/pagination/ListAttachedGroupPoliciesPaginator.ts index 341ae0dbfd021..a943472126186 100644 --- a/clients/client-iam/pagination/ListAttachedGroupPoliciesPaginator.ts +++ b/clients/client-iam/pagination/ListAttachedGroupPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListAttachedGroupPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttachedGroupPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListAttachedGroupPoliciesCommandInput, diff --git a/clients/client-iam/pagination/ListAttachedRolePoliciesPaginator.ts b/clients/client-iam/pagination/ListAttachedRolePoliciesPaginator.ts index d0b8587b2b26b..f9d9bf7eee963 100644 --- a/clients/client-iam/pagination/ListAttachedRolePoliciesPaginator.ts +++ b/clients/client-iam/pagination/ListAttachedRolePoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListAttachedRolePoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttachedRolePoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListAttachedRolePoliciesCommandInput, diff --git a/clients/client-iam/pagination/ListAttachedUserPoliciesPaginator.ts b/clients/client-iam/pagination/ListAttachedUserPoliciesPaginator.ts index 0a1c83d153314..1151979828aee 100644 --- a/clients/client-iam/pagination/ListAttachedUserPoliciesPaginator.ts +++ b/clients/client-iam/pagination/ListAttachedUserPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListAttachedUserPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttachedUserPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListAttachedUserPoliciesCommandInput, diff --git a/clients/client-iam/pagination/ListEntitiesForPolicyPaginator.ts b/clients/client-iam/pagination/ListEntitiesForPolicyPaginator.ts index 695e6b223f930..396f14a8da0ab 100644 --- a/clients/client-iam/pagination/ListEntitiesForPolicyPaginator.ts +++ b/clients/client-iam/pagination/ListEntitiesForPolicyPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListEntitiesForPolicyCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEntitiesForPolicyCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListEntitiesForPolicyCommandInput, diff --git a/clients/client-iam/pagination/ListGroupPoliciesPaginator.ts b/clients/client-iam/pagination/ListGroupPoliciesPaginator.ts index 40e05488f893f..e453e2461e82c 100644 --- a/clients/client-iam/pagination/ListGroupPoliciesPaginator.ts +++ b/clients/client-iam/pagination/ListGroupPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListGroupPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListGroupPoliciesCommandInput, diff --git a/clients/client-iam/pagination/ListGroupsForUserPaginator.ts b/clients/client-iam/pagination/ListGroupsForUserPaginator.ts index 2f8b5e385efd5..1f8cbad474d93 100644 --- a/clients/client-iam/pagination/ListGroupsForUserPaginator.ts +++ b/clients/client-iam/pagination/ListGroupsForUserPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListGroupsForUserCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupsForUserCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListGroupsForUserCommandInput, diff --git a/clients/client-iam/pagination/ListGroupsPaginator.ts b/clients/client-iam/pagination/ListGroupsPaginator.ts index 993b4e9def78d..e600f27d954a9 100644 --- a/clients/client-iam/pagination/ListGroupsPaginator.ts +++ b/clients/client-iam/pagination/ListGroupsPaginator.ts @@ -4,6 +4,9 @@ import { ListGroupsCommand, ListGroupsCommandInput, ListGroupsCommandOutput } fr import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListGroupsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListGroupsCommandInput, diff --git a/clients/client-iam/pagination/ListInstanceProfilesForRolePaginator.ts b/clients/client-iam/pagination/ListInstanceProfilesForRolePaginator.ts index 350557729794c..6b371ba9d9fd7 100644 --- a/clients/client-iam/pagination/ListInstanceProfilesForRolePaginator.ts +++ b/clients/client-iam/pagination/ListInstanceProfilesForRolePaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListInstanceProfilesForRoleCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInstanceProfilesForRoleCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListInstanceProfilesForRoleCommandInput, diff --git a/clients/client-iam/pagination/ListInstanceProfilesPaginator.ts b/clients/client-iam/pagination/ListInstanceProfilesPaginator.ts index 81d1d524cfe49..577f3b4afd09e 100644 --- a/clients/client-iam/pagination/ListInstanceProfilesPaginator.ts +++ b/clients/client-iam/pagination/ListInstanceProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListInstanceProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInstanceProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListInstanceProfilesCommandInput, diff --git a/clients/client-iam/pagination/ListMFADevicesPaginator.ts b/clients/client-iam/pagination/ListMFADevicesPaginator.ts index 73fc18f57f558..bfe5d892b9347 100644 --- a/clients/client-iam/pagination/ListMFADevicesPaginator.ts +++ b/clients/client-iam/pagination/ListMFADevicesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListMFADevicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMFADevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListMFADevicesCommandInput, diff --git a/clients/client-iam/pagination/ListPoliciesPaginator.ts b/clients/client-iam/pagination/ListPoliciesPaginator.ts index a2f907b1cce8c..a9d1a42fea243 100644 --- a/clients/client-iam/pagination/ListPoliciesPaginator.ts +++ b/clients/client-iam/pagination/ListPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListPoliciesCommandInput, diff --git a/clients/client-iam/pagination/ListPolicyVersionsPaginator.ts b/clients/client-iam/pagination/ListPolicyVersionsPaginator.ts index ee30e98804dda..39bb601369442 100644 --- a/clients/client-iam/pagination/ListPolicyVersionsPaginator.ts +++ b/clients/client-iam/pagination/ListPolicyVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListPolicyVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPolicyVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListPolicyVersionsCommandInput, diff --git a/clients/client-iam/pagination/ListRolePoliciesPaginator.ts b/clients/client-iam/pagination/ListRolePoliciesPaginator.ts index 234b71eb6305d..27012826a253d 100644 --- a/clients/client-iam/pagination/ListRolePoliciesPaginator.ts +++ b/clients/client-iam/pagination/ListRolePoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListRolePoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRolePoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListRolePoliciesCommandInput, diff --git a/clients/client-iam/pagination/ListRolesPaginator.ts b/clients/client-iam/pagination/ListRolesPaginator.ts index 8f8d1b991a9f5..f4bb963390d1b 100644 --- a/clients/client-iam/pagination/ListRolesPaginator.ts +++ b/clients/client-iam/pagination/ListRolesPaginator.ts @@ -4,6 +4,9 @@ import { ListRolesCommand, ListRolesCommandInput, ListRolesCommandOutput } from import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListRolesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRolesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListRolesCommandInput, diff --git a/clients/client-iam/pagination/ListSSHPublicKeysPaginator.ts b/clients/client-iam/pagination/ListSSHPublicKeysPaginator.ts index 21720a2a12f65..90e4875163f28 100644 --- a/clients/client-iam/pagination/ListSSHPublicKeysPaginator.ts +++ b/clients/client-iam/pagination/ListSSHPublicKeysPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListSSHPublicKeysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSSHPublicKeysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListSSHPublicKeysCommandInput, diff --git a/clients/client-iam/pagination/ListServerCertificatesPaginator.ts b/clients/client-iam/pagination/ListServerCertificatesPaginator.ts index 3de5d6c40d4fc..89c6fc5888ac3 100644 --- a/clients/client-iam/pagination/ListServerCertificatesPaginator.ts +++ b/clients/client-iam/pagination/ListServerCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListServerCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServerCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListServerCertificatesCommandInput, diff --git a/clients/client-iam/pagination/ListSigningCertificatesPaginator.ts b/clients/client-iam/pagination/ListSigningCertificatesPaginator.ts index cc0282ecda4ab..faecd35eee5cd 100644 --- a/clients/client-iam/pagination/ListSigningCertificatesPaginator.ts +++ b/clients/client-iam/pagination/ListSigningCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListSigningCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSigningCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListSigningCertificatesCommandInput, diff --git a/clients/client-iam/pagination/ListUserPoliciesPaginator.ts b/clients/client-iam/pagination/ListUserPoliciesPaginator.ts index 86034a14cf9ec..f1a5bfa1247ed 100644 --- a/clients/client-iam/pagination/ListUserPoliciesPaginator.ts +++ b/clients/client-iam/pagination/ListUserPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListUserPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUserPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListUserPoliciesCommandInput, diff --git a/clients/client-iam/pagination/ListUsersPaginator.ts b/clients/client-iam/pagination/ListUsersPaginator.ts index 0eda56562ec82..89cb48e52dcc3 100644 --- a/clients/client-iam/pagination/ListUsersPaginator.ts +++ b/clients/client-iam/pagination/ListUsersPaginator.ts @@ -4,6 +4,9 @@ import { ListUsersCommand, ListUsersCommandInput, ListUsersCommandOutput } from import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListUsersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListUsersCommandInput, diff --git a/clients/client-iam/pagination/ListVirtualMFADevicesPaginator.ts b/clients/client-iam/pagination/ListVirtualMFADevicesPaginator.ts index 73eacbebf6713..6d451e6061363 100644 --- a/clients/client-iam/pagination/ListVirtualMFADevicesPaginator.ts +++ b/clients/client-iam/pagination/ListVirtualMFADevicesPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: ListVirtualMFADevicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVirtualMFADevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: ListVirtualMFADevicesCommandInput, diff --git a/clients/client-iam/pagination/SimulateCustomPolicyPaginator.ts b/clients/client-iam/pagination/SimulateCustomPolicyPaginator.ts index 1856b811e9ff6..ee1347cee20b7 100644 --- a/clients/client-iam/pagination/SimulateCustomPolicyPaginator.ts +++ b/clients/client-iam/pagination/SimulateCustomPolicyPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: SimulateCustomPolicyCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SimulateCustomPolicyCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: SimulateCustomPolicyCommandInput, diff --git a/clients/client-iam/pagination/SimulatePrincipalPolicyPaginator.ts b/clients/client-iam/pagination/SimulatePrincipalPolicyPaginator.ts index 26d00b87d3b9c..10aef266baf8c 100644 --- a/clients/client-iam/pagination/SimulatePrincipalPolicyPaginator.ts +++ b/clients/client-iam/pagination/SimulatePrincipalPolicyPaginator.ts @@ -8,6 +8,9 @@ import { import { IAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IAMClient, input: SimulatePrincipalPolicyCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SimulatePrincipalPolicyCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IAM, input: SimulatePrincipalPolicyCommandInput, diff --git a/clients/client-iam/runtimeConfig.browser.ts b/clients/client-iam/runtimeConfig.browser.ts index 933c3ba400f90..08d82fb24098b 100644 --- a/clients/client-iam/runtimeConfig.browser.ts +++ b/clients/client-iam/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IAMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iam/runtimeConfig.native.ts b/clients/client-iam/runtimeConfig.native.ts index f0701dadd7675..106f9305b8347 100644 --- a/clients/client-iam/runtimeConfig.native.ts +++ b/clients/client-iam/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IAMClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iam/runtimeConfig.shared.ts b/clients/client-iam/runtimeConfig.shared.ts index c8206a66e394e..64e85dc139acb 100644 --- a/clients/client-iam/runtimeConfig.shared.ts +++ b/clients/client-iam/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2010-05-08", disableHostPrefix: false, diff --git a/clients/client-iam/runtimeConfig.ts b/clients/client-iam/runtimeConfig.ts index 4f1d1b6b5a8e4..c89b77e118c7b 100644 --- a/clients/client-iam/runtimeConfig.ts +++ b/clients/client-iam/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IAMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iam/tsconfig.json b/clients/client-iam/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iam/tsconfig.json +++ b/clients/client-iam/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-identitystore/commands/DescribeGroupCommand.ts b/clients/client-identitystore/commands/DescribeGroupCommand.ts index 3fd21dda2c66c..3bd153532ee2f 100644 --- a/clients/client-identitystore/commands/DescribeGroupCommand.ts +++ b/clients/client-identitystore/commands/DescribeGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeGroupCommandInput = DescribeGroupRequest; export type DescribeGroupCommandOutput = DescribeGroupResponse & __MetadataBearer; +/** + *

Retrieves the group metadata and attributes from GroupId in an identity store.

+ */ export class DescribeGroupCommand extends $Command< DescribeGroupCommandInput, DescribeGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IdentitystoreClientResolvedConfig, diff --git a/clients/client-identitystore/commands/DescribeUserCommand.ts b/clients/client-identitystore/commands/DescribeUserCommand.ts index a3a90b6bc4d12..f7941e81f9404 100644 --- a/clients/client-identitystore/commands/DescribeUserCommand.ts +++ b/clients/client-identitystore/commands/DescribeUserCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserCommandInput = DescribeUserRequest; export type DescribeUserCommandOutput = DescribeUserResponse & __MetadataBearer; +/** + *

Retrieves the user metadata and attributes from UserId in an identity store.

+ */ export class DescribeUserCommand extends $Command< DescribeUserCommandInput, DescribeUserCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IdentitystoreClientResolvedConfig, diff --git a/clients/client-identitystore/commands/ListGroupsCommand.ts b/clients/client-identitystore/commands/ListGroupsCommand.ts index 884cebf0bd459..4e2015ce0ade9 100644 --- a/clients/client-identitystore/commands/ListGroupsCommand.ts +++ b/clients/client-identitystore/commands/ListGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroupsCommandInput = ListGroupsRequest; export type ListGroupsCommandOutput = ListGroupsResponse & __MetadataBearer; +/** + *

Lists the attribute name and value of the group that you specified in the search. We only support DisplayName as a valid filter attribute path currently, and filter is required. This API returns minimum attributes, including GroupId and group DisplayName in the response.

+ */ export class ListGroupsCommand extends $Command< ListGroupsCommandInput, ListGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IdentitystoreClientResolvedConfig, diff --git a/clients/client-identitystore/commands/ListUsersCommand.ts b/clients/client-identitystore/commands/ListUsersCommand.ts index 3824983ce9c7b..4a0ed03412e24 100644 --- a/clients/client-identitystore/commands/ListUsersCommand.ts +++ b/clients/client-identitystore/commands/ListUsersCommand.ts @@ -17,6 +17,9 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + *

Lists the attribute name and value of the user that you specified in the search. We only support UserName as a valid filter attribute path currently, and filter is required. This API returns minimum attributes, including UserId and UserName in the response.

+ */ export class ListUsersCommand extends $Command< ListUsersCommandInput, ListUsersCommandOutput, @@ -31,6 +34,9 @@ export class ListUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IdentitystoreClientResolvedConfig, diff --git a/clients/client-identitystore/package.json b/clients/client-identitystore/package.json index 4e5428bf2f805..3fe0afed46a05 100644 --- a/clients/client-identitystore/package.json +++ b/clients/client-identitystore/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Identitystore Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-identitystore/pagination/ListGroupsPaginator.ts b/clients/client-identitystore/pagination/ListGroupsPaginator.ts index 8ff5c6828d766..d6e6e09855a7c 100644 --- a/clients/client-identitystore/pagination/ListGroupsPaginator.ts +++ b/clients/client-identitystore/pagination/ListGroupsPaginator.ts @@ -4,6 +4,9 @@ import { ListGroupsCommand, ListGroupsCommandInput, ListGroupsCommandOutput } fr import { IdentitystorePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IdentitystoreClient, input: ListGroupsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Identitystore, input: ListGroupsCommandInput, diff --git a/clients/client-identitystore/pagination/ListUsersPaginator.ts b/clients/client-identitystore/pagination/ListUsersPaginator.ts index df86313ba753f..75e5b1882d441 100644 --- a/clients/client-identitystore/pagination/ListUsersPaginator.ts +++ b/clients/client-identitystore/pagination/ListUsersPaginator.ts @@ -4,6 +4,9 @@ import { ListUsersCommand, ListUsersCommandInput, ListUsersCommandOutput } from import { IdentitystorePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IdentitystoreClient, input: ListUsersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Identitystore, input: ListUsersCommandInput, diff --git a/clients/client-identitystore/runtimeConfig.browser.ts b/clients/client-identitystore/runtimeConfig.browser.ts index 6c1535b3f1c56..00cc4521d0f7c 100644 --- a/clients/client-identitystore/runtimeConfig.browser.ts +++ b/clients/client-identitystore/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IdentitystoreClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-identitystore/runtimeConfig.native.ts b/clients/client-identitystore/runtimeConfig.native.ts index a311e59d97fb2..b19b8146668ff 100644 --- a/clients/client-identitystore/runtimeConfig.native.ts +++ b/clients/client-identitystore/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IdentitystoreClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-identitystore/runtimeConfig.shared.ts b/clients/client-identitystore/runtimeConfig.shared.ts index 2546ff0047737..7291a5137dfd8 100644 --- a/clients/client-identitystore/runtimeConfig.shared.ts +++ b/clients/client-identitystore/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-06-15", disableHostPrefix: false, diff --git a/clients/client-identitystore/runtimeConfig.ts b/clients/client-identitystore/runtimeConfig.ts index 84117368195e0..17f04bfe149d8 100644 --- a/clients/client-identitystore/runtimeConfig.ts +++ b/clients/client-identitystore/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IdentitystoreClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-identitystore/tsconfig.json b/clients/client-identitystore/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-identitystore/tsconfig.json +++ b/clients/client-identitystore/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-imagebuilder/commands/CancelImageCreationCommand.ts b/clients/client-imagebuilder/commands/CancelImageCreationCommand.ts index 3d99c0c46db08..110519350f32e 100644 --- a/clients/client-imagebuilder/commands/CancelImageCreationCommand.ts +++ b/clients/client-imagebuilder/commands/CancelImageCreationCommand.ts @@ -20,6 +20,10 @@ import { export type CancelImageCreationCommandInput = CancelImageCreationRequest; export type CancelImageCreationCommandOutput = CancelImageCreationResponse & __MetadataBearer; +/** + *

CancelImageCreation cancels the creation of Image. This operation can only be used on + * images in a non-terminal state.

+ */ export class CancelImageCreationCommand extends $Command< CancelImageCreationCommandInput, CancelImageCreationCommandOutput, @@ -34,6 +38,9 @@ export class CancelImageCreationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/CreateComponentCommand.ts b/clients/client-imagebuilder/commands/CreateComponentCommand.ts index f9372b860f070..ec63a243f5cc2 100644 --- a/clients/client-imagebuilder/commands/CreateComponentCommand.ts +++ b/clients/client-imagebuilder/commands/CreateComponentCommand.ts @@ -20,6 +20,10 @@ import { export type CreateComponentCommandInput = CreateComponentRequest; export type CreateComponentCommandOutput = CreateComponentResponse & __MetadataBearer; +/** + *

Creates a new component that can be used to build, validate, test, and assess your + * image.

+ */ export class CreateComponentCommand extends $Command< CreateComponentCommandInput, CreateComponentCommandOutput, @@ -34,6 +38,9 @@ export class CreateComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/CreateDistributionConfigurationCommand.ts b/clients/client-imagebuilder/commands/CreateDistributionConfigurationCommand.ts index 581126ecfbab1..62cd48e5f07cc 100644 --- a/clients/client-imagebuilder/commands/CreateDistributionConfigurationCommand.ts +++ b/clients/client-imagebuilder/commands/CreateDistributionConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDistributionConfigurationCommandInput = CreateDistributionConfigurationRequest; export type CreateDistributionConfigurationCommandOutput = CreateDistributionConfigurationResponse & __MetadataBearer; +/** + *

Creates a new distribution configuration. Distribution configurations define and configure + * the outputs of your pipeline.

+ */ export class CreateDistributionConfigurationCommand extends $Command< CreateDistributionConfigurationCommandInput, CreateDistributionConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class CreateDistributionConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/CreateImageCommand.ts b/clients/client-imagebuilder/commands/CreateImageCommand.ts index 44a1352f7b53b..2e2ccc190fd7f 100644 --- a/clients/client-imagebuilder/commands/CreateImageCommand.ts +++ b/clients/client-imagebuilder/commands/CreateImageCommand.ts @@ -20,6 +20,10 @@ import { export type CreateImageCommandInput = CreateImageRequest; export type CreateImageCommandOutput = CreateImageResponse & __MetadataBearer; +/** + *

Creates a new image. This request will create a new image along with all of the + * configured output resources defined in the distribution configuration.

+ */ export class CreateImageCommand extends $Command< CreateImageCommandInput, CreateImageCommandOutput, @@ -34,6 +38,9 @@ export class CreateImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/CreateImagePipelineCommand.ts b/clients/client-imagebuilder/commands/CreateImagePipelineCommand.ts index dfe5c5cac3e42..07c55253deed7 100644 --- a/clients/client-imagebuilder/commands/CreateImagePipelineCommand.ts +++ b/clients/client-imagebuilder/commands/CreateImagePipelineCommand.ts @@ -20,6 +20,10 @@ import { export type CreateImagePipelineCommandInput = CreateImagePipelineRequest; export type CreateImagePipelineCommandOutput = CreateImagePipelineResponse & __MetadataBearer; +/** + *

Creates a new image pipeline. Image pipelines enable you to automate the creation and + * distribution of images.

+ */ export class CreateImagePipelineCommand extends $Command< CreateImagePipelineCommandInput, CreateImagePipelineCommandOutput, @@ -34,6 +38,9 @@ export class CreateImagePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/CreateImageRecipeCommand.ts b/clients/client-imagebuilder/commands/CreateImageRecipeCommand.ts index ef2d0493ae75a..7b886f828e4b9 100644 --- a/clients/client-imagebuilder/commands/CreateImageRecipeCommand.ts +++ b/clients/client-imagebuilder/commands/CreateImageRecipeCommand.ts @@ -20,6 +20,10 @@ import { export type CreateImageRecipeCommandInput = CreateImageRecipeRequest; export type CreateImageRecipeCommandOutput = CreateImageRecipeResponse & __MetadataBearer; +/** + *

Creates a new image recipe. Image recipes define how images are configured, tested, and + * assessed.

+ */ export class CreateImageRecipeCommand extends $Command< CreateImageRecipeCommandInput, CreateImageRecipeCommandOutput, @@ -34,6 +38,9 @@ export class CreateImageRecipeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/CreateInfrastructureConfigurationCommand.ts b/clients/client-imagebuilder/commands/CreateInfrastructureConfigurationCommand.ts index 2bcabd8f6ef24..d7934c47259c5 100644 --- a/clients/client-imagebuilder/commands/CreateInfrastructureConfigurationCommand.ts +++ b/clients/client-imagebuilder/commands/CreateInfrastructureConfigurationCommand.ts @@ -24,6 +24,10 @@ export type CreateInfrastructureConfigurationCommandInput = CreateInfrastructure export type CreateInfrastructureConfigurationCommandOutput = CreateInfrastructureConfigurationResponse & __MetadataBearer; +/** + *

Creates a new infrastructure configuration. An infrastructure configuration defines the + * environment in which your image will be built and tested.

+ */ export class CreateInfrastructureConfigurationCommand extends $Command< CreateInfrastructureConfigurationCommandInput, CreateInfrastructureConfigurationCommandOutput, @@ -38,6 +42,9 @@ export class CreateInfrastructureConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/DeleteComponentCommand.ts b/clients/client-imagebuilder/commands/DeleteComponentCommand.ts index ad3f8915abae4..7788f43e4bba2 100644 --- a/clients/client-imagebuilder/commands/DeleteComponentCommand.ts +++ b/clients/client-imagebuilder/commands/DeleteComponentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteComponentCommandInput = DeleteComponentRequest; export type DeleteComponentCommandOutput = DeleteComponentResponse & __MetadataBearer; +/** + *

Deletes a component build version.

+ */ export class DeleteComponentCommand extends $Command< DeleteComponentCommandInput, DeleteComponentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/DeleteDistributionConfigurationCommand.ts b/clients/client-imagebuilder/commands/DeleteDistributionConfigurationCommand.ts index 6bc75ee6c2d9b..11ed7c156ffdd 100644 --- a/clients/client-imagebuilder/commands/DeleteDistributionConfigurationCommand.ts +++ b/clients/client-imagebuilder/commands/DeleteDistributionConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDistributionConfigurationCommandInput = DeleteDistributionConfigurationRequest; export type DeleteDistributionConfigurationCommandOutput = DeleteDistributionConfigurationResponse & __MetadataBearer; +/** + *

Deletes a distribution configuration.

+ */ export class DeleteDistributionConfigurationCommand extends $Command< DeleteDistributionConfigurationCommandInput, DeleteDistributionConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDistributionConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/DeleteImageCommand.ts b/clients/client-imagebuilder/commands/DeleteImageCommand.ts index bd192e87fb6f9..c37d1cf815f80 100644 --- a/clients/client-imagebuilder/commands/DeleteImageCommand.ts +++ b/clients/client-imagebuilder/commands/DeleteImageCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteImageCommandInput = DeleteImageRequest; export type DeleteImageCommandOutput = DeleteImageResponse & __MetadataBearer; +/** + *

Deletes an image.

+ */ export class DeleteImageCommand extends $Command< DeleteImageCommandInput, DeleteImageCommandOutput, @@ -34,6 +37,9 @@ export class DeleteImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/DeleteImagePipelineCommand.ts b/clients/client-imagebuilder/commands/DeleteImagePipelineCommand.ts index 43273f77e74d0..b08fcb7f68312 100644 --- a/clients/client-imagebuilder/commands/DeleteImagePipelineCommand.ts +++ b/clients/client-imagebuilder/commands/DeleteImagePipelineCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteImagePipelineCommandInput = DeleteImagePipelineRequest; export type DeleteImagePipelineCommandOutput = DeleteImagePipelineResponse & __MetadataBearer; +/** + *

Deletes an image pipeline.

+ */ export class DeleteImagePipelineCommand extends $Command< DeleteImagePipelineCommandInput, DeleteImagePipelineCommandOutput, @@ -34,6 +37,9 @@ export class DeleteImagePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/DeleteImageRecipeCommand.ts b/clients/client-imagebuilder/commands/DeleteImageRecipeCommand.ts index 190d0b7edd78d..7a66720e1c66b 100644 --- a/clients/client-imagebuilder/commands/DeleteImageRecipeCommand.ts +++ b/clients/client-imagebuilder/commands/DeleteImageRecipeCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteImageRecipeCommandInput = DeleteImageRecipeRequest; export type DeleteImageRecipeCommandOutput = DeleteImageRecipeResponse & __MetadataBearer; +/** + *

Deletes an image recipe.

+ */ export class DeleteImageRecipeCommand extends $Command< DeleteImageRecipeCommandInput, DeleteImageRecipeCommandOutput, @@ -34,6 +37,9 @@ export class DeleteImageRecipeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/DeleteInfrastructureConfigurationCommand.ts b/clients/client-imagebuilder/commands/DeleteInfrastructureConfigurationCommand.ts index dbe157399e90d..ac0cac1b7e417 100644 --- a/clients/client-imagebuilder/commands/DeleteInfrastructureConfigurationCommand.ts +++ b/clients/client-imagebuilder/commands/DeleteInfrastructureConfigurationCommand.ts @@ -24,6 +24,9 @@ export type DeleteInfrastructureConfigurationCommandInput = DeleteInfrastructure export type DeleteInfrastructureConfigurationCommandOutput = DeleteInfrastructureConfigurationResponse & __MetadataBearer; +/** + *

Deletes an infrastructure configuration.

+ */ export class DeleteInfrastructureConfigurationCommand extends $Command< DeleteInfrastructureConfigurationCommandInput, DeleteInfrastructureConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class DeleteInfrastructureConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetComponentCommand.ts b/clients/client-imagebuilder/commands/GetComponentCommand.ts index 8bc382ad0f536..a7add27ebe19a 100644 --- a/clients/client-imagebuilder/commands/GetComponentCommand.ts +++ b/clients/client-imagebuilder/commands/GetComponentCommand.ts @@ -20,6 +20,9 @@ import { export type GetComponentCommandInput = GetComponentRequest; export type GetComponentCommandOutput = GetComponentResponse & __MetadataBearer; +/** + *

Gets a component object.

+ */ export class GetComponentCommand extends $Command< GetComponentCommandInput, GetComponentCommandOutput, @@ -34,6 +37,9 @@ export class GetComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetComponentPolicyCommand.ts b/clients/client-imagebuilder/commands/GetComponentPolicyCommand.ts index d31dede7ee1c2..84b2bb2a2cacf 100644 --- a/clients/client-imagebuilder/commands/GetComponentPolicyCommand.ts +++ b/clients/client-imagebuilder/commands/GetComponentPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetComponentPolicyCommandInput = GetComponentPolicyRequest; export type GetComponentPolicyCommandOutput = GetComponentPolicyResponse & __MetadataBearer; +/** + *

Gets a component policy.

+ */ export class GetComponentPolicyCommand extends $Command< GetComponentPolicyCommandInput, GetComponentPolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetComponentPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetDistributionConfigurationCommand.ts b/clients/client-imagebuilder/commands/GetDistributionConfigurationCommand.ts index 370420ce2d65f..03c0c9db8f3a7 100644 --- a/clients/client-imagebuilder/commands/GetDistributionConfigurationCommand.ts +++ b/clients/client-imagebuilder/commands/GetDistributionConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetDistributionConfigurationCommandInput = GetDistributionConfigurationRequest; export type GetDistributionConfigurationCommandOutput = GetDistributionConfigurationResponse & __MetadataBearer; +/** + *

Gets a distribution configuration.

+ */ export class GetDistributionConfigurationCommand extends $Command< GetDistributionConfigurationCommandInput, GetDistributionConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetDistributionConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetImageCommand.ts b/clients/client-imagebuilder/commands/GetImageCommand.ts index e466d6d662660..25b75b680079e 100644 --- a/clients/client-imagebuilder/commands/GetImageCommand.ts +++ b/clients/client-imagebuilder/commands/GetImageCommand.ts @@ -20,6 +20,9 @@ import { export type GetImageCommandInput = GetImageRequest; export type GetImageCommandOutput = GetImageResponse & __MetadataBearer; +/** + *

Gets an image.

+ */ export class GetImageCommand extends $Command< GetImageCommandInput, GetImageCommandOutput, @@ -34,6 +37,9 @@ export class GetImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetImagePipelineCommand.ts b/clients/client-imagebuilder/commands/GetImagePipelineCommand.ts index eaf13cc326d01..73e003e21df45 100644 --- a/clients/client-imagebuilder/commands/GetImagePipelineCommand.ts +++ b/clients/client-imagebuilder/commands/GetImagePipelineCommand.ts @@ -20,6 +20,9 @@ import { export type GetImagePipelineCommandInput = GetImagePipelineRequest; export type GetImagePipelineCommandOutput = GetImagePipelineResponse & __MetadataBearer; +/** + *

Gets an image pipeline.

+ */ export class GetImagePipelineCommand extends $Command< GetImagePipelineCommandInput, GetImagePipelineCommandOutput, @@ -34,6 +37,9 @@ export class GetImagePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetImagePolicyCommand.ts b/clients/client-imagebuilder/commands/GetImagePolicyCommand.ts index 186dd846ca6bb..a93c14f2155d7 100644 --- a/clients/client-imagebuilder/commands/GetImagePolicyCommand.ts +++ b/clients/client-imagebuilder/commands/GetImagePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetImagePolicyCommandInput = GetImagePolicyRequest; export type GetImagePolicyCommandOutput = GetImagePolicyResponse & __MetadataBearer; +/** + *

Gets an image policy.

+ */ export class GetImagePolicyCommand extends $Command< GetImagePolicyCommandInput, GetImagePolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetImagePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetImageRecipeCommand.ts b/clients/client-imagebuilder/commands/GetImageRecipeCommand.ts index 0feb9c4675e7d..7f0f355dd6511 100644 --- a/clients/client-imagebuilder/commands/GetImageRecipeCommand.ts +++ b/clients/client-imagebuilder/commands/GetImageRecipeCommand.ts @@ -20,6 +20,9 @@ import { export type GetImageRecipeCommandInput = GetImageRecipeRequest; export type GetImageRecipeCommandOutput = GetImageRecipeResponse & __MetadataBearer; +/** + *

Gets an image recipe.

+ */ export class GetImageRecipeCommand extends $Command< GetImageRecipeCommandInput, GetImageRecipeCommandOutput, @@ -34,6 +37,9 @@ export class GetImageRecipeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetImageRecipePolicyCommand.ts b/clients/client-imagebuilder/commands/GetImageRecipePolicyCommand.ts index 69cfd67956f74..8c9977b5b9b38 100644 --- a/clients/client-imagebuilder/commands/GetImageRecipePolicyCommand.ts +++ b/clients/client-imagebuilder/commands/GetImageRecipePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetImageRecipePolicyCommandInput = GetImageRecipePolicyRequest; export type GetImageRecipePolicyCommandOutput = GetImageRecipePolicyResponse & __MetadataBearer; +/** + *

Gets an image recipe policy.

+ */ export class GetImageRecipePolicyCommand extends $Command< GetImageRecipePolicyCommandInput, GetImageRecipePolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetImageRecipePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/GetInfrastructureConfigurationCommand.ts b/clients/client-imagebuilder/commands/GetInfrastructureConfigurationCommand.ts index 885e0cda6d950..b4d16d2d595b1 100644 --- a/clients/client-imagebuilder/commands/GetInfrastructureConfigurationCommand.ts +++ b/clients/client-imagebuilder/commands/GetInfrastructureConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetInfrastructureConfigurationCommandInput = GetInfrastructureConfigurationRequest; export type GetInfrastructureConfigurationCommandOutput = GetInfrastructureConfigurationResponse & __MetadataBearer; +/** + *

Gets an infrastructure configuration.

+ */ export class GetInfrastructureConfigurationCommand extends $Command< GetInfrastructureConfigurationCommandInput, GetInfrastructureConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetInfrastructureConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ImportComponentCommand.ts b/clients/client-imagebuilder/commands/ImportComponentCommand.ts index bea5c655bced7..3c6154c1dd1f3 100644 --- a/clients/client-imagebuilder/commands/ImportComponentCommand.ts +++ b/clients/client-imagebuilder/commands/ImportComponentCommand.ts @@ -20,6 +20,9 @@ import { export type ImportComponentCommandInput = ImportComponentRequest; export type ImportComponentCommandOutput = ImportComponentResponse & __MetadataBearer; +/** + *

Imports a component and transforms its data into a component document.

+ */ export class ImportComponentCommand extends $Command< ImportComponentCommandInput, ImportComponentCommandOutput, @@ -34,6 +37,9 @@ export class ImportComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListComponentBuildVersionsCommand.ts b/clients/client-imagebuilder/commands/ListComponentBuildVersionsCommand.ts index 9dc87d565d0f0..3c50b89f78859 100644 --- a/clients/client-imagebuilder/commands/ListComponentBuildVersionsCommand.ts +++ b/clients/client-imagebuilder/commands/ListComponentBuildVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListComponentBuildVersionsCommandInput = ListComponentBuildVersionsRequest; export type ListComponentBuildVersionsCommandOutput = ListComponentBuildVersionsResponse & __MetadataBearer; +/** + *

Returns the list of component build versions for the specified semantic version.

+ */ export class ListComponentBuildVersionsCommand extends $Command< ListComponentBuildVersionsCommandInput, ListComponentBuildVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListComponentBuildVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListComponentsCommand.ts b/clients/client-imagebuilder/commands/ListComponentsCommand.ts index 61a26b93bd6e2..56d9c0692b007 100644 --- a/clients/client-imagebuilder/commands/ListComponentsCommand.ts +++ b/clients/client-imagebuilder/commands/ListComponentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListComponentsCommandInput = ListComponentsRequest; export type ListComponentsCommandOutput = ListComponentsResponse & __MetadataBearer; +/** + *

Returns the list of component build versions for the specified semantic version.

+ */ export class ListComponentsCommand extends $Command< ListComponentsCommandInput, ListComponentsCommandOutput, @@ -34,6 +37,9 @@ export class ListComponentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListDistributionConfigurationsCommand.ts b/clients/client-imagebuilder/commands/ListDistributionConfigurationsCommand.ts index da390d61345d5..015f3aad267e5 100644 --- a/clients/client-imagebuilder/commands/ListDistributionConfigurationsCommand.ts +++ b/clients/client-imagebuilder/commands/ListDistributionConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDistributionConfigurationsCommandInput = ListDistributionConfigurationsRequest; export type ListDistributionConfigurationsCommandOutput = ListDistributionConfigurationsResponse & __MetadataBearer; +/** + *

Returns a list of distribution configurations.

+ */ export class ListDistributionConfigurationsCommand extends $Command< ListDistributionConfigurationsCommandInput, ListDistributionConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class ListDistributionConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListImageBuildVersionsCommand.ts b/clients/client-imagebuilder/commands/ListImageBuildVersionsCommand.ts index 5c9bc1cc2805d..66290de523ff5 100644 --- a/clients/client-imagebuilder/commands/ListImageBuildVersionsCommand.ts +++ b/clients/client-imagebuilder/commands/ListImageBuildVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListImageBuildVersionsCommandInput = ListImageBuildVersionsRequest; export type ListImageBuildVersionsCommandOutput = ListImageBuildVersionsResponse & __MetadataBearer; +/** + *

Returns a list of image build versions.

+ */ export class ListImageBuildVersionsCommand extends $Command< ListImageBuildVersionsCommandInput, ListImageBuildVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListImageBuildVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListImagePipelineImagesCommand.ts b/clients/client-imagebuilder/commands/ListImagePipelineImagesCommand.ts index 23c4d037d774b..5ac6c9fd3c31c 100644 --- a/clients/client-imagebuilder/commands/ListImagePipelineImagesCommand.ts +++ b/clients/client-imagebuilder/commands/ListImagePipelineImagesCommand.ts @@ -20,6 +20,9 @@ import { export type ListImagePipelineImagesCommandInput = ListImagePipelineImagesRequest; export type ListImagePipelineImagesCommandOutput = ListImagePipelineImagesResponse & __MetadataBearer; +/** + *

Returns a list of images created by the specified pipeline.

+ */ export class ListImagePipelineImagesCommand extends $Command< ListImagePipelineImagesCommandInput, ListImagePipelineImagesCommandOutput, @@ -34,6 +37,9 @@ export class ListImagePipelineImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListImagePipelinesCommand.ts b/clients/client-imagebuilder/commands/ListImagePipelinesCommand.ts index 31bd8107c0cf9..b64bec240da9f 100644 --- a/clients/client-imagebuilder/commands/ListImagePipelinesCommand.ts +++ b/clients/client-imagebuilder/commands/ListImagePipelinesCommand.ts @@ -20,6 +20,9 @@ import { export type ListImagePipelinesCommandInput = ListImagePipelinesRequest; export type ListImagePipelinesCommandOutput = ListImagePipelinesResponse & __MetadataBearer; +/** + *

Returns a list of image pipelines.

+ */ export class ListImagePipelinesCommand extends $Command< ListImagePipelinesCommandInput, ListImagePipelinesCommandOutput, @@ -34,6 +37,9 @@ export class ListImagePipelinesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListImageRecipesCommand.ts b/clients/client-imagebuilder/commands/ListImageRecipesCommand.ts index 9947a6f745862..2313283197299 100644 --- a/clients/client-imagebuilder/commands/ListImageRecipesCommand.ts +++ b/clients/client-imagebuilder/commands/ListImageRecipesCommand.ts @@ -20,6 +20,9 @@ import { export type ListImageRecipesCommandInput = ListImageRecipesRequest; export type ListImageRecipesCommandOutput = ListImageRecipesResponse & __MetadataBearer; +/** + *

Returns a list of image recipes.

+ */ export class ListImageRecipesCommand extends $Command< ListImageRecipesCommandInput, ListImageRecipesCommandOutput, @@ -34,6 +37,9 @@ export class ListImageRecipesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListImagesCommand.ts b/clients/client-imagebuilder/commands/ListImagesCommand.ts index fcb09d5e3abe1..9876496416b00 100644 --- a/clients/client-imagebuilder/commands/ListImagesCommand.ts +++ b/clients/client-imagebuilder/commands/ListImagesCommand.ts @@ -20,6 +20,9 @@ import { export type ListImagesCommandInput = ListImagesRequest; export type ListImagesCommandOutput = ListImagesResponse & __MetadataBearer; +/** + *

Returns the list of images that you have access to.

+ */ export class ListImagesCommand extends $Command< ListImagesCommandInput, ListImagesCommandOutput, @@ -34,6 +37,9 @@ export class ListImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListInfrastructureConfigurationsCommand.ts b/clients/client-imagebuilder/commands/ListInfrastructureConfigurationsCommand.ts index e324db654e68d..c0e8d30890600 100644 --- a/clients/client-imagebuilder/commands/ListInfrastructureConfigurationsCommand.ts +++ b/clients/client-imagebuilder/commands/ListInfrastructureConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListInfrastructureConfigurationsCommandInput = ListInfrastructureConfigurationsRequest; export type ListInfrastructureConfigurationsCommandOutput = ListInfrastructureConfigurationsResponse & __MetadataBearer; +/** + *

Returns a list of infrastructure configurations.

+ */ export class ListInfrastructureConfigurationsCommand extends $Command< ListInfrastructureConfigurationsCommandInput, ListInfrastructureConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class ListInfrastructureConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/ListTagsForResourceCommand.ts b/clients/client-imagebuilder/commands/ListTagsForResourceCommand.ts index 9f825fdf2318e..26f0607d5dae5 100644 --- a/clients/client-imagebuilder/commands/ListTagsForResourceCommand.ts +++ b/clients/client-imagebuilder/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns the list of tags for the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/PutComponentPolicyCommand.ts b/clients/client-imagebuilder/commands/PutComponentPolicyCommand.ts index 17b3c0f1c6150..3aad4a680ed76 100644 --- a/clients/client-imagebuilder/commands/PutComponentPolicyCommand.ts +++ b/clients/client-imagebuilder/commands/PutComponentPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutComponentPolicyCommandInput = PutComponentPolicyRequest; export type PutComponentPolicyCommandOutput = PutComponentPolicyResponse & __MetadataBearer; +/** + *

Applies a policy to a component. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API + * PutComponentPolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to + * all principals with whom the resource is shared.

+ */ export class PutComponentPolicyCommand extends $Command< PutComponentPolicyCommandInput, PutComponentPolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutComponentPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/PutImagePolicyCommand.ts b/clients/client-imagebuilder/commands/PutImagePolicyCommand.ts index 3c3b21b0df0f5..a97406279ecf6 100644 --- a/clients/client-imagebuilder/commands/PutImagePolicyCommand.ts +++ b/clients/client-imagebuilder/commands/PutImagePolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutImagePolicyCommandInput = PutImagePolicyRequest; export type PutImagePolicyCommandOutput = PutImagePolicyResponse & __MetadataBearer; +/** + *

Applies a policy to an image. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API + * PutImagePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to + * all principals with whom the resource is shared.

+ */ export class PutImagePolicyCommand extends $Command< PutImagePolicyCommandInput, PutImagePolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutImagePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/PutImageRecipePolicyCommand.ts b/clients/client-imagebuilder/commands/PutImageRecipePolicyCommand.ts index 6f4f0a6725f40..44824d3089ed2 100644 --- a/clients/client-imagebuilder/commands/PutImageRecipePolicyCommand.ts +++ b/clients/client-imagebuilder/commands/PutImageRecipePolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutImageRecipePolicyCommandInput = PutImageRecipePolicyRequest; export type PutImageRecipePolicyCommandOutput = PutImageRecipePolicyResponse & __MetadataBearer; +/** + *

Applies a policy to an image recipe. We recommend that you call the RAM API CreateResourceShare to share resources. If you call the Image Builder API + * PutImageRecipePolicy, you must also call the RAM API PromoteResourceShareCreatedFromPolicy in order for the resource to be visible to + * all principals with whom the resource is shared.

+ */ export class PutImageRecipePolicyCommand extends $Command< PutImageRecipePolicyCommandInput, PutImageRecipePolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutImageRecipePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/StartImagePipelineExecutionCommand.ts b/clients/client-imagebuilder/commands/StartImagePipelineExecutionCommand.ts index 785774b9cb191..8ec9aadbefdce 100644 --- a/clients/client-imagebuilder/commands/StartImagePipelineExecutionCommand.ts +++ b/clients/client-imagebuilder/commands/StartImagePipelineExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type StartImagePipelineExecutionCommandInput = StartImagePipelineExecutionRequest; export type StartImagePipelineExecutionCommandOutput = StartImagePipelineExecutionResponse & __MetadataBearer; +/** + *

Manually triggers a pipeline to create an image.

+ */ export class StartImagePipelineExecutionCommand extends $Command< StartImagePipelineExecutionCommandInput, StartImagePipelineExecutionCommandOutput, @@ -34,6 +37,9 @@ export class StartImagePipelineExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/TagResourceCommand.ts b/clients/client-imagebuilder/commands/TagResourceCommand.ts index 85a6fd4ebc49f..d91a6a436e6d6 100644 --- a/clients/client-imagebuilder/commands/TagResourceCommand.ts +++ b/clients/client-imagebuilder/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds a tag to a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/UntagResourceCommand.ts b/clients/client-imagebuilder/commands/UntagResourceCommand.ts index 3ec9db5d8738c..feb1ec45eee92 100644 --- a/clients/client-imagebuilder/commands/UntagResourceCommand.ts +++ b/clients/client-imagebuilder/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/UpdateDistributionConfigurationCommand.ts b/clients/client-imagebuilder/commands/UpdateDistributionConfigurationCommand.ts index 4bf609f2abcc4..523e71daa7dbd 100644 --- a/clients/client-imagebuilder/commands/UpdateDistributionConfigurationCommand.ts +++ b/clients/client-imagebuilder/commands/UpdateDistributionConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDistributionConfigurationCommandInput = UpdateDistributionConfigurationRequest; export type UpdateDistributionConfigurationCommandOutput = UpdateDistributionConfigurationResponse & __MetadataBearer; +/** + *

Updates a new distribution configuration. Distribution configurations define and + * configure the outputs of your pipeline.

+ */ export class UpdateDistributionConfigurationCommand extends $Command< UpdateDistributionConfigurationCommandInput, UpdateDistributionConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDistributionConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/UpdateImagePipelineCommand.ts b/clients/client-imagebuilder/commands/UpdateImagePipelineCommand.ts index e48e0d0539236..06bf867661737 100644 --- a/clients/client-imagebuilder/commands/UpdateImagePipelineCommand.ts +++ b/clients/client-imagebuilder/commands/UpdateImagePipelineCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateImagePipelineCommandInput = UpdateImagePipelineRequest; export type UpdateImagePipelineCommandOutput = UpdateImagePipelineResponse & __MetadataBearer; +/** + *

Updates a new image pipeline. Image pipelines enable you to automate the creation and + * distribution of images.

+ */ export class UpdateImagePipelineCommand extends $Command< UpdateImagePipelineCommandInput, UpdateImagePipelineCommandOutput, @@ -34,6 +38,9 @@ export class UpdateImagePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/commands/UpdateInfrastructureConfigurationCommand.ts b/clients/client-imagebuilder/commands/UpdateInfrastructureConfigurationCommand.ts index 5e5f4a0bf8e15..0cfa8f4e9ea49 100644 --- a/clients/client-imagebuilder/commands/UpdateInfrastructureConfigurationCommand.ts +++ b/clients/client-imagebuilder/commands/UpdateInfrastructureConfigurationCommand.ts @@ -24,6 +24,10 @@ export type UpdateInfrastructureConfigurationCommandInput = UpdateInfrastructure export type UpdateInfrastructureConfigurationCommandOutput = UpdateInfrastructureConfigurationResponse & __MetadataBearer; +/** + *

Updates a new infrastructure configuration. An infrastructure configuration defines the + * environment in which your image will be built and tested.

+ */ export class UpdateInfrastructureConfigurationCommand extends $Command< UpdateInfrastructureConfigurationCommandInput, UpdateInfrastructureConfigurationCommandOutput, @@ -38,6 +42,9 @@ export class UpdateInfrastructureConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ImagebuilderClientResolvedConfig, diff --git a/clients/client-imagebuilder/package.json b/clients/client-imagebuilder/package.json index 6faf1706ed186..3f79bc56c410f 100644 --- a/clients/client-imagebuilder/package.json +++ b/clients/client-imagebuilder/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Imagebuilder Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-imagebuilder/pagination/ListComponentBuildVersionsPaginator.ts b/clients/client-imagebuilder/pagination/ListComponentBuildVersionsPaginator.ts index 9c7c9d37bf674..6bfcc1757f579 100644 --- a/clients/client-imagebuilder/pagination/ListComponentBuildVersionsPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListComponentBuildVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListComponentBuildVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListComponentBuildVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListComponentBuildVersionsCommandInput, diff --git a/clients/client-imagebuilder/pagination/ListComponentsPaginator.ts b/clients/client-imagebuilder/pagination/ListComponentsPaginator.ts index a8dc81bbc30a0..54c13bec4fc6c 100644 --- a/clients/client-imagebuilder/pagination/ListComponentsPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListComponentsPaginator.ts @@ -8,6 +8,9 @@ import { import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListComponentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListComponentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListComponentsCommandInput, diff --git a/clients/client-imagebuilder/pagination/ListDistributionConfigurationsPaginator.ts b/clients/client-imagebuilder/pagination/ListDistributionConfigurationsPaginator.ts index cfd96c469e2a7..60f29505979c1 100644 --- a/clients/client-imagebuilder/pagination/ListDistributionConfigurationsPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListDistributionConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListDistributionConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDistributionConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListDistributionConfigurationsCommandInput, diff --git a/clients/client-imagebuilder/pagination/ListImageBuildVersionsPaginator.ts b/clients/client-imagebuilder/pagination/ListImageBuildVersionsPaginator.ts index 2400e96dc834f..eda4e00948ff9 100644 --- a/clients/client-imagebuilder/pagination/ListImageBuildVersionsPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListImageBuildVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListImageBuildVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImageBuildVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListImageBuildVersionsCommandInput, diff --git a/clients/client-imagebuilder/pagination/ListImagePipelineImagesPaginator.ts b/clients/client-imagebuilder/pagination/ListImagePipelineImagesPaginator.ts index 09f664f53c00c..97e23b84616bf 100644 --- a/clients/client-imagebuilder/pagination/ListImagePipelineImagesPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListImagePipelineImagesPaginator.ts @@ -8,6 +8,9 @@ import { import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListImagePipelineImagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImagePipelineImagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListImagePipelineImagesCommandInput, diff --git a/clients/client-imagebuilder/pagination/ListImagePipelinesPaginator.ts b/clients/client-imagebuilder/pagination/ListImagePipelinesPaginator.ts index c3b8f505eb3b5..7e7a545fa0010 100644 --- a/clients/client-imagebuilder/pagination/ListImagePipelinesPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListImagePipelinesPaginator.ts @@ -8,6 +8,9 @@ import { import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListImagePipelinesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImagePipelinesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListImagePipelinesCommandInput, diff --git a/clients/client-imagebuilder/pagination/ListImageRecipesPaginator.ts b/clients/client-imagebuilder/pagination/ListImageRecipesPaginator.ts index 9707a89238685..3c3e565e8b868 100644 --- a/clients/client-imagebuilder/pagination/ListImageRecipesPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListImageRecipesPaginator.ts @@ -8,6 +8,9 @@ import { import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListImageRecipesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImageRecipesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListImageRecipesCommandInput, diff --git a/clients/client-imagebuilder/pagination/ListImagesPaginator.ts b/clients/client-imagebuilder/pagination/ListImagesPaginator.ts index e76a555e601d1..2742ff5b0eab8 100644 --- a/clients/client-imagebuilder/pagination/ListImagesPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListImagesPaginator.ts @@ -4,6 +4,9 @@ import { ListImagesCommand, ListImagesCommandInput, ListImagesCommandOutput } fr import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListImagesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListImagesCommandInput, diff --git a/clients/client-imagebuilder/pagination/ListInfrastructureConfigurationsPaginator.ts b/clients/client-imagebuilder/pagination/ListInfrastructureConfigurationsPaginator.ts index 6f70312e8738f..4f49e1a25465a 100644 --- a/clients/client-imagebuilder/pagination/ListInfrastructureConfigurationsPaginator.ts +++ b/clients/client-imagebuilder/pagination/ListInfrastructureConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { ImagebuilderPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ImagebuilderClient, input: ListInfrastructureConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInfrastructureConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Imagebuilder, input: ListInfrastructureConfigurationsCommandInput, diff --git a/clients/client-imagebuilder/runtimeConfig.browser.ts b/clients/client-imagebuilder/runtimeConfig.browser.ts index 7348b5790a161..ade0137f8ba62 100644 --- a/clients/client-imagebuilder/runtimeConfig.browser.ts +++ b/clients/client-imagebuilder/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ImagebuilderClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-imagebuilder/runtimeConfig.native.ts b/clients/client-imagebuilder/runtimeConfig.native.ts index 71c9b3feaa75a..6b13e01d7af4c 100644 --- a/clients/client-imagebuilder/runtimeConfig.native.ts +++ b/clients/client-imagebuilder/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ImagebuilderClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-imagebuilder/runtimeConfig.shared.ts b/clients/client-imagebuilder/runtimeConfig.shared.ts index 08ff748278de9..547e5b1709e0c 100644 --- a/clients/client-imagebuilder/runtimeConfig.shared.ts +++ b/clients/client-imagebuilder/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-02", disableHostPrefix: false, diff --git a/clients/client-imagebuilder/runtimeConfig.ts b/clients/client-imagebuilder/runtimeConfig.ts index e1ef3094f7e9b..840a8b42e4d98 100644 --- a/clients/client-imagebuilder/runtimeConfig.ts +++ b/clients/client-imagebuilder/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ImagebuilderClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-imagebuilder/tsconfig.json b/clients/client-imagebuilder/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-imagebuilder/tsconfig.json +++ b/clients/client-imagebuilder/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-inspector/commands/AddAttributesToFindingsCommand.ts b/clients/client-inspector/commands/AddAttributesToFindingsCommand.ts index d36b025fa5b53..87ac2351c160a 100644 --- a/clients/client-inspector/commands/AddAttributesToFindingsCommand.ts +++ b/clients/client-inspector/commands/AddAttributesToFindingsCommand.ts @@ -20,6 +20,10 @@ import { export type AddAttributesToFindingsCommandInput = AddAttributesToFindingsRequest; export type AddAttributesToFindingsCommandOutput = AddAttributesToFindingsResponse & __MetadataBearer; +/** + *

Assigns attributes (key and value pairs) to the findings that are specified by the + * ARNs of the findings.

+ */ export class AddAttributesToFindingsCommand extends $Command< AddAttributesToFindingsCommandInput, AddAttributesToFindingsCommandOutput, @@ -34,6 +38,9 @@ export class AddAttributesToFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/CreateAssessmentTargetCommand.ts b/clients/client-inspector/commands/CreateAssessmentTargetCommand.ts index 1f8f8188f39a8..2255d411430f2 100644 --- a/clients/client-inspector/commands/CreateAssessmentTargetCommand.ts +++ b/clients/client-inspector/commands/CreateAssessmentTargetCommand.ts @@ -20,6 +20,16 @@ import { export type CreateAssessmentTargetCommandInput = CreateAssessmentTargetRequest; export type CreateAssessmentTargetCommandOutput = CreateAssessmentTargetResponse & __MetadataBearer; +/** + *

Creates a new assessment target using the ARN of the resource group that is generated + * by CreateResourceGroup. If resourceGroupArn is not specified, all EC2 + * instances in the current AWS account and region are included in the assessment target. If + * the service-linked role isn’t already registered, this action also creates and + * registers a service-linked role to grant Amazon Inspector access to AWS Services needed to + * perform security assessments. You can create up to 50 assessment targets per AWS account. + * You can run up to 500 concurrent agents per AWS account. For more information, see + * Amazon Inspector Assessment Targets.

+ */ export class CreateAssessmentTargetCommand extends $Command< CreateAssessmentTargetCommandInput, CreateAssessmentTargetCommandOutput, @@ -34,6 +44,9 @@ export class CreateAssessmentTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/CreateAssessmentTemplateCommand.ts b/clients/client-inspector/commands/CreateAssessmentTemplateCommand.ts index d25057a6fb244..21e9822f5b02a 100644 --- a/clients/client-inspector/commands/CreateAssessmentTemplateCommand.ts +++ b/clients/client-inspector/commands/CreateAssessmentTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type CreateAssessmentTemplateCommandInput = CreateAssessmentTemplateRequest; export type CreateAssessmentTemplateCommandOutput = CreateAssessmentTemplateResponse & __MetadataBearer; +/** + *

Creates an assessment template for the assessment target that is specified by the ARN + * of the assessment target. If the service-linked role isn’t already registered, this action also creates and + * registers a service-linked role to grant Amazon Inspector access to AWS Services needed to + * perform security assessments.

+ */ export class CreateAssessmentTemplateCommand extends $Command< CreateAssessmentTemplateCommandInput, CreateAssessmentTemplateCommandOutput, @@ -34,6 +40,9 @@ export class CreateAssessmentTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/CreateExclusionsPreviewCommand.ts b/clients/client-inspector/commands/CreateExclusionsPreviewCommand.ts index 8cefce7184f2b..14a4623a387a7 100644 --- a/clients/client-inspector/commands/CreateExclusionsPreviewCommand.ts +++ b/clients/client-inspector/commands/CreateExclusionsPreviewCommand.ts @@ -20,6 +20,11 @@ import { export type CreateExclusionsPreviewCommandInput = CreateExclusionsPreviewRequest; export type CreateExclusionsPreviewCommandOutput = CreateExclusionsPreviewResponse & __MetadataBearer; +/** + *

Starts the generation of an exclusions preview for the specified assessment template. + * The exclusions preview lists the potential exclusions (ExclusionPreview) that Inspector can + * detect before it runs the assessment.

+ */ export class CreateExclusionsPreviewCommand extends $Command< CreateExclusionsPreviewCommandInput, CreateExclusionsPreviewCommandOutput, @@ -34,6 +39,9 @@ export class CreateExclusionsPreviewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/CreateResourceGroupCommand.ts b/clients/client-inspector/commands/CreateResourceGroupCommand.ts index 1c5050d33ecb9..1e431b45b3814 100644 --- a/clients/client-inspector/commands/CreateResourceGroupCommand.ts +++ b/clients/client-inspector/commands/CreateResourceGroupCommand.ts @@ -20,6 +20,12 @@ import { export type CreateResourceGroupCommandInput = CreateResourceGroupRequest; export type CreateResourceGroupCommandOutput = CreateResourceGroupResponse & __MetadataBearer; +/** + *

Creates a resource group using the specified set of tags (key and value pairs) that + * are used to select the EC2 instances to be included in an Amazon Inspector assessment + * target. The created resource group is then used to create an Amazon Inspector assessment + * target. For more information, see CreateAssessmentTarget.

+ */ export class CreateResourceGroupCommand extends $Command< CreateResourceGroupCommandInput, CreateResourceGroupCommandOutput, @@ -34,6 +40,9 @@ export class CreateResourceGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DeleteAssessmentRunCommand.ts b/clients/client-inspector/commands/DeleteAssessmentRunCommand.ts index c99f0d5fad11e..fd28a696d20c1 100644 --- a/clients/client-inspector/commands/DeleteAssessmentRunCommand.ts +++ b/clients/client-inspector/commands/DeleteAssessmentRunCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAssessmentRunCommandInput = DeleteAssessmentRunRequest; export type DeleteAssessmentRunCommandOutput = __MetadataBearer; +/** + *

Deletes the assessment run that is specified by the ARN of the assessment + * run.

+ */ export class DeleteAssessmentRunCommand extends $Command< DeleteAssessmentRunCommandInput, DeleteAssessmentRunCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAssessmentRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DeleteAssessmentTargetCommand.ts b/clients/client-inspector/commands/DeleteAssessmentTargetCommand.ts index 5e4221514f575..05609d5b86f94 100644 --- a/clients/client-inspector/commands/DeleteAssessmentTargetCommand.ts +++ b/clients/client-inspector/commands/DeleteAssessmentTargetCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAssessmentTargetCommandInput = DeleteAssessmentTargetRequest; export type DeleteAssessmentTargetCommandOutput = __MetadataBearer; +/** + *

Deletes the assessment target that is specified by the ARN of the assessment + * target.

+ */ export class DeleteAssessmentTargetCommand extends $Command< DeleteAssessmentTargetCommandInput, DeleteAssessmentTargetCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAssessmentTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DeleteAssessmentTemplateCommand.ts b/clients/client-inspector/commands/DeleteAssessmentTemplateCommand.ts index 03c44a3c630cc..ae8dfe20fad29 100644 --- a/clients/client-inspector/commands/DeleteAssessmentTemplateCommand.ts +++ b/clients/client-inspector/commands/DeleteAssessmentTemplateCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAssessmentTemplateCommandInput = DeleteAssessmentTemplateRequest; export type DeleteAssessmentTemplateCommandOutput = __MetadataBearer; +/** + *

Deletes the assessment template that is specified by the ARN of the assessment + * template.

+ */ export class DeleteAssessmentTemplateCommand extends $Command< DeleteAssessmentTemplateCommandInput, DeleteAssessmentTemplateCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAssessmentTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DescribeAssessmentRunsCommand.ts b/clients/client-inspector/commands/DescribeAssessmentRunsCommand.ts index 733d2f35ecea6..ba5cd989ab1fc 100644 --- a/clients/client-inspector/commands/DescribeAssessmentRunsCommand.ts +++ b/clients/client-inspector/commands/DescribeAssessmentRunsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAssessmentRunsCommandInput = DescribeAssessmentRunsRequest; export type DescribeAssessmentRunsCommandOutput = DescribeAssessmentRunsResponse & __MetadataBearer; +/** + *

Describes the assessment runs that are specified by the ARNs of the assessment + * runs.

+ */ export class DescribeAssessmentRunsCommand extends $Command< DescribeAssessmentRunsCommandInput, DescribeAssessmentRunsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAssessmentRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DescribeAssessmentTargetsCommand.ts b/clients/client-inspector/commands/DescribeAssessmentTargetsCommand.ts index 9353f95490431..fb20221ceb2b8 100644 --- a/clients/client-inspector/commands/DescribeAssessmentTargetsCommand.ts +++ b/clients/client-inspector/commands/DescribeAssessmentTargetsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAssessmentTargetsCommandInput = DescribeAssessmentTargetsRequest; export type DescribeAssessmentTargetsCommandOutput = DescribeAssessmentTargetsResponse & __MetadataBearer; +/** + *

Describes the assessment targets that are specified by the ARNs of the assessment + * targets.

+ */ export class DescribeAssessmentTargetsCommand extends $Command< DescribeAssessmentTargetsCommandInput, DescribeAssessmentTargetsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAssessmentTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DescribeAssessmentTemplatesCommand.ts b/clients/client-inspector/commands/DescribeAssessmentTemplatesCommand.ts index 35a7697a3f1c6..fb624d421ad39 100644 --- a/clients/client-inspector/commands/DescribeAssessmentTemplatesCommand.ts +++ b/clients/client-inspector/commands/DescribeAssessmentTemplatesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAssessmentTemplatesCommandInput = DescribeAssessmentTemplatesRequest; export type DescribeAssessmentTemplatesCommandOutput = DescribeAssessmentTemplatesResponse & __MetadataBearer; +/** + *

Describes the assessment templates that are specified by the ARNs of the assessment + * templates.

+ */ export class DescribeAssessmentTemplatesCommand extends $Command< DescribeAssessmentTemplatesCommandInput, DescribeAssessmentTemplatesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAssessmentTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DescribeCrossAccountAccessRoleCommand.ts b/clients/client-inspector/commands/DescribeCrossAccountAccessRoleCommand.ts index 8b7e3abd552f8..ce3406943d19b 100644 --- a/clients/client-inspector/commands/DescribeCrossAccountAccessRoleCommand.ts +++ b/clients/client-inspector/commands/DescribeCrossAccountAccessRoleCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeCrossAccountAccessRoleCommandInput = {}; export type DescribeCrossAccountAccessRoleCommandOutput = DescribeCrossAccountAccessRoleResponse & __MetadataBearer; +/** + *

Describes the IAM role that enables Amazon Inspector to access your AWS + * account.

+ */ export class DescribeCrossAccountAccessRoleCommand extends $Command< DescribeCrossAccountAccessRoleCommandInput, DescribeCrossAccountAccessRoleCommandOutput, @@ -34,6 +38,9 @@ export class DescribeCrossAccountAccessRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DescribeExclusionsCommand.ts b/clients/client-inspector/commands/DescribeExclusionsCommand.ts index 73e3dbdd6fae8..fb35241fcc434 100644 --- a/clients/client-inspector/commands/DescribeExclusionsCommand.ts +++ b/clients/client-inspector/commands/DescribeExclusionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeExclusionsCommandInput = DescribeExclusionsRequest; export type DescribeExclusionsCommandOutput = DescribeExclusionsResponse & __MetadataBearer; +/** + *

Describes the exclusions that are specified by the exclusions' ARNs.

+ */ export class DescribeExclusionsCommand extends $Command< DescribeExclusionsCommandInput, DescribeExclusionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeExclusionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DescribeFindingsCommand.ts b/clients/client-inspector/commands/DescribeFindingsCommand.ts index fc24dea73624f..b665a67123825 100644 --- a/clients/client-inspector/commands/DescribeFindingsCommand.ts +++ b/clients/client-inspector/commands/DescribeFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFindingsCommandInput = DescribeFindingsRequest; export type DescribeFindingsCommandOutput = DescribeFindingsResponse & __MetadataBearer; +/** + *

Describes the findings that are specified by the ARNs of the findings.

+ */ export class DescribeFindingsCommand extends $Command< DescribeFindingsCommandInput, DescribeFindingsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DescribeResourceGroupsCommand.ts b/clients/client-inspector/commands/DescribeResourceGroupsCommand.ts index bab114d63b034..d31d4c0672bcb 100644 --- a/clients/client-inspector/commands/DescribeResourceGroupsCommand.ts +++ b/clients/client-inspector/commands/DescribeResourceGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeResourceGroupsCommandInput = DescribeResourceGroupsRequest; export type DescribeResourceGroupsCommandOutput = DescribeResourceGroupsResponse & __MetadataBearer; +/** + *

Describes the resource groups that are specified by the ARNs of the resource + * groups.

+ */ export class DescribeResourceGroupsCommand extends $Command< DescribeResourceGroupsCommandInput, DescribeResourceGroupsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeResourceGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/DescribeRulesPackagesCommand.ts b/clients/client-inspector/commands/DescribeRulesPackagesCommand.ts index 424325d906c76..78032c9f7f36a 100644 --- a/clients/client-inspector/commands/DescribeRulesPackagesCommand.ts +++ b/clients/client-inspector/commands/DescribeRulesPackagesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeRulesPackagesCommandInput = DescribeRulesPackagesRequest; export type DescribeRulesPackagesCommandOutput = DescribeRulesPackagesResponse & __MetadataBearer; +/** + *

Describes the rules packages that are specified by the ARNs of the rules + * packages.

+ */ export class DescribeRulesPackagesCommand extends $Command< DescribeRulesPackagesCommandInput, DescribeRulesPackagesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeRulesPackagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/GetAssessmentReportCommand.ts b/clients/client-inspector/commands/GetAssessmentReportCommand.ts index 9d41b7d860357..a3413ad1b1b55 100644 --- a/clients/client-inspector/commands/GetAssessmentReportCommand.ts +++ b/clients/client-inspector/commands/GetAssessmentReportCommand.ts @@ -20,6 +20,10 @@ import { export type GetAssessmentReportCommandInput = GetAssessmentReportRequest; export type GetAssessmentReportCommandOutput = GetAssessmentReportResponse & __MetadataBearer; +/** + *

Produces an assessment report that includes detailed and comprehensive results of a + * specified assessment run.

+ */ export class GetAssessmentReportCommand extends $Command< GetAssessmentReportCommandInput, GetAssessmentReportCommandOutput, @@ -34,6 +38,9 @@ export class GetAssessmentReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/GetExclusionsPreviewCommand.ts b/clients/client-inspector/commands/GetExclusionsPreviewCommand.ts index 688d34c69b38e..fb0836ea36227 100644 --- a/clients/client-inspector/commands/GetExclusionsPreviewCommand.ts +++ b/clients/client-inspector/commands/GetExclusionsPreviewCommand.ts @@ -20,6 +20,11 @@ import { export type GetExclusionsPreviewCommandInput = GetExclusionsPreviewRequest; export type GetExclusionsPreviewCommandOutput = GetExclusionsPreviewResponse & __MetadataBearer; +/** + *

Retrieves the exclusions preview (a list of ExclusionPreview objects) specified by + * the preview token. You can obtain the preview token by running the CreateExclusionsPreview + * API.

+ */ export class GetExclusionsPreviewCommand extends $Command< GetExclusionsPreviewCommandInput, GetExclusionsPreviewCommandOutput, @@ -34,6 +39,9 @@ export class GetExclusionsPreviewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/GetTelemetryMetadataCommand.ts b/clients/client-inspector/commands/GetTelemetryMetadataCommand.ts index 43cd2f006eb30..1a25772048702 100644 --- a/clients/client-inspector/commands/GetTelemetryMetadataCommand.ts +++ b/clients/client-inspector/commands/GetTelemetryMetadataCommand.ts @@ -20,6 +20,10 @@ import { export type GetTelemetryMetadataCommandInput = GetTelemetryMetadataRequest; export type GetTelemetryMetadataCommandOutput = GetTelemetryMetadataResponse & __MetadataBearer; +/** + *

Information about the data that is collected for the specified assessment + * run.

+ */ export class GetTelemetryMetadataCommand extends $Command< GetTelemetryMetadataCommandInput, GetTelemetryMetadataCommandOutput, @@ -34,6 +38,9 @@ export class GetTelemetryMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListAssessmentRunAgentsCommand.ts b/clients/client-inspector/commands/ListAssessmentRunAgentsCommand.ts index baff3a5fea41f..13de4d90441e1 100644 --- a/clients/client-inspector/commands/ListAssessmentRunAgentsCommand.ts +++ b/clients/client-inspector/commands/ListAssessmentRunAgentsCommand.ts @@ -20,6 +20,10 @@ import { export type ListAssessmentRunAgentsCommandInput = ListAssessmentRunAgentsRequest; export type ListAssessmentRunAgentsCommandOutput = ListAssessmentRunAgentsResponse & __MetadataBearer; +/** + *

Lists the agents of the assessment runs that are specified by the ARNs of the + * assessment runs.

+ */ export class ListAssessmentRunAgentsCommand extends $Command< ListAssessmentRunAgentsCommandInput, ListAssessmentRunAgentsCommandOutput, @@ -34,6 +38,9 @@ export class ListAssessmentRunAgentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListAssessmentRunsCommand.ts b/clients/client-inspector/commands/ListAssessmentRunsCommand.ts index 20a3c5e9358f5..9041538880ae5 100644 --- a/clients/client-inspector/commands/ListAssessmentRunsCommand.ts +++ b/clients/client-inspector/commands/ListAssessmentRunsCommand.ts @@ -20,6 +20,10 @@ import { export type ListAssessmentRunsCommandInput = ListAssessmentRunsRequest; export type ListAssessmentRunsCommandOutput = ListAssessmentRunsResponse & __MetadataBearer; +/** + *

Lists the assessment runs that correspond to the assessment templates that are + * specified by the ARNs of the assessment templates.

+ */ export class ListAssessmentRunsCommand extends $Command< ListAssessmentRunsCommandInput, ListAssessmentRunsCommandOutput, @@ -34,6 +38,9 @@ export class ListAssessmentRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListAssessmentTargetsCommand.ts b/clients/client-inspector/commands/ListAssessmentTargetsCommand.ts index c1b03f94fab5b..b60c37cb51787 100644 --- a/clients/client-inspector/commands/ListAssessmentTargetsCommand.ts +++ b/clients/client-inspector/commands/ListAssessmentTargetsCommand.ts @@ -20,6 +20,11 @@ import { export type ListAssessmentTargetsCommandInput = ListAssessmentTargetsRequest; export type ListAssessmentTargetsCommandOutput = ListAssessmentTargetsResponse & __MetadataBearer; +/** + *

Lists the ARNs of the assessment targets within this AWS account. For more + * information about assessment targets, see Amazon Inspector Assessment + * Targets.

+ */ export class ListAssessmentTargetsCommand extends $Command< ListAssessmentTargetsCommandInput, ListAssessmentTargetsCommandOutput, @@ -34,6 +39,9 @@ export class ListAssessmentTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListAssessmentTemplatesCommand.ts b/clients/client-inspector/commands/ListAssessmentTemplatesCommand.ts index a3e9044f573c4..27031373a039d 100644 --- a/clients/client-inspector/commands/ListAssessmentTemplatesCommand.ts +++ b/clients/client-inspector/commands/ListAssessmentTemplatesCommand.ts @@ -20,6 +20,10 @@ import { export type ListAssessmentTemplatesCommandInput = ListAssessmentTemplatesRequest; export type ListAssessmentTemplatesCommandOutput = ListAssessmentTemplatesResponse & __MetadataBearer; +/** + *

Lists the assessment templates that correspond to the assessment targets that are + * specified by the ARNs of the assessment targets.

+ */ export class ListAssessmentTemplatesCommand extends $Command< ListAssessmentTemplatesCommandInput, ListAssessmentTemplatesCommandOutput, @@ -34,6 +38,9 @@ export class ListAssessmentTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListEventSubscriptionsCommand.ts b/clients/client-inspector/commands/ListEventSubscriptionsCommand.ts index bf3804387f35f..055ad1facd65c 100644 --- a/clients/client-inspector/commands/ListEventSubscriptionsCommand.ts +++ b/clients/client-inspector/commands/ListEventSubscriptionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListEventSubscriptionsCommandInput = ListEventSubscriptionsRequest; export type ListEventSubscriptionsCommandOutput = ListEventSubscriptionsResponse & __MetadataBearer; +/** + *

Lists all the event subscriptions for the assessment template that is specified by + * the ARN of the assessment template. For more information, see SubscribeToEvent and UnsubscribeFromEvent.

+ */ export class ListEventSubscriptionsCommand extends $Command< ListEventSubscriptionsCommandInput, ListEventSubscriptionsCommandOutput, @@ -34,6 +38,9 @@ export class ListEventSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListExclusionsCommand.ts b/clients/client-inspector/commands/ListExclusionsCommand.ts index 22944899bda42..4883b5628fd54 100644 --- a/clients/client-inspector/commands/ListExclusionsCommand.ts +++ b/clients/client-inspector/commands/ListExclusionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListExclusionsCommandInput = ListExclusionsRequest; export type ListExclusionsCommandOutput = ListExclusionsResponse & __MetadataBearer; +/** + *

List exclusions that are generated by the assessment run.

+ */ export class ListExclusionsCommand extends $Command< ListExclusionsCommandInput, ListExclusionsCommandOutput, @@ -34,6 +37,9 @@ export class ListExclusionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListFindingsCommand.ts b/clients/client-inspector/commands/ListFindingsCommand.ts index ef32049b9f13d..6b5f9c80b3936 100644 --- a/clients/client-inspector/commands/ListFindingsCommand.ts +++ b/clients/client-inspector/commands/ListFindingsCommand.ts @@ -20,6 +20,10 @@ import { export type ListFindingsCommandInput = ListFindingsRequest; export type ListFindingsCommandOutput = ListFindingsResponse & __MetadataBearer; +/** + *

Lists findings that are generated by the assessment runs that are specified by the + * ARNs of the assessment runs.

+ */ export class ListFindingsCommand extends $Command< ListFindingsCommandInput, ListFindingsCommandOutput, @@ -34,6 +38,9 @@ export class ListFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListRulesPackagesCommand.ts b/clients/client-inspector/commands/ListRulesPackagesCommand.ts index 4045c2c8f5785..c68debb6a1a97 100644 --- a/clients/client-inspector/commands/ListRulesPackagesCommand.ts +++ b/clients/client-inspector/commands/ListRulesPackagesCommand.ts @@ -20,6 +20,9 @@ import { export type ListRulesPackagesCommandInput = ListRulesPackagesRequest; export type ListRulesPackagesCommandOutput = ListRulesPackagesResponse & __MetadataBearer; +/** + *

Lists all available Amazon Inspector rules packages.

+ */ export class ListRulesPackagesCommand extends $Command< ListRulesPackagesCommandInput, ListRulesPackagesCommandOutput, @@ -34,6 +37,9 @@ export class ListRulesPackagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/ListTagsForResourceCommand.ts b/clients/client-inspector/commands/ListTagsForResourceCommand.ts index a5011d5d01b55..86fa051335bc3 100644 --- a/clients/client-inspector/commands/ListTagsForResourceCommand.ts +++ b/clients/client-inspector/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists all tags associated with an assessment template.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/PreviewAgentsCommand.ts b/clients/client-inspector/commands/PreviewAgentsCommand.ts index b55bd011e39a2..4d5bbd6a98230 100644 --- a/clients/client-inspector/commands/PreviewAgentsCommand.ts +++ b/clients/client-inspector/commands/PreviewAgentsCommand.ts @@ -20,6 +20,10 @@ import { export type PreviewAgentsCommandInput = PreviewAgentsRequest; export type PreviewAgentsCommandOutput = PreviewAgentsResponse & __MetadataBearer; +/** + *

Previews the agents installed on the EC2 instances that are part of the specified + * assessment target.

+ */ export class PreviewAgentsCommand extends $Command< PreviewAgentsCommandInput, PreviewAgentsCommandOutput, @@ -34,6 +38,9 @@ export class PreviewAgentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/RegisterCrossAccountAccessRoleCommand.ts b/clients/client-inspector/commands/RegisterCrossAccountAccessRoleCommand.ts index d2561dd17049f..5a071733c5c64 100644 --- a/clients/client-inspector/commands/RegisterCrossAccountAccessRoleCommand.ts +++ b/clients/client-inspector/commands/RegisterCrossAccountAccessRoleCommand.ts @@ -20,6 +20,10 @@ import { export type RegisterCrossAccountAccessRoleCommandInput = RegisterCrossAccountAccessRoleRequest; export type RegisterCrossAccountAccessRoleCommandOutput = __MetadataBearer; +/** + *

Registers the IAM role that grants Amazon Inspector access to AWS Services needed to + * perform security assessments.

+ */ export class RegisterCrossAccountAccessRoleCommand extends $Command< RegisterCrossAccountAccessRoleCommandInput, RegisterCrossAccountAccessRoleCommandOutput, @@ -34,6 +38,9 @@ export class RegisterCrossAccountAccessRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/RemoveAttributesFromFindingsCommand.ts b/clients/client-inspector/commands/RemoveAttributesFromFindingsCommand.ts index c9b2001dd986e..eb41e0276a265 100644 --- a/clients/client-inspector/commands/RemoveAttributesFromFindingsCommand.ts +++ b/clients/client-inspector/commands/RemoveAttributesFromFindingsCommand.ts @@ -20,6 +20,10 @@ import { export type RemoveAttributesFromFindingsCommandInput = RemoveAttributesFromFindingsRequest; export type RemoveAttributesFromFindingsCommandOutput = RemoveAttributesFromFindingsResponse & __MetadataBearer; +/** + *

Removes entire attributes (key and value pairs) from the findings that are specified + * by the ARNs of the findings where an attribute with the specified key exists.

+ */ export class RemoveAttributesFromFindingsCommand extends $Command< RemoveAttributesFromFindingsCommandInput, RemoveAttributesFromFindingsCommandOutput, @@ -34,6 +38,9 @@ export class RemoveAttributesFromFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/SetTagsForResourceCommand.ts b/clients/client-inspector/commands/SetTagsForResourceCommand.ts index 78287ba0a15af..d2a282fb69263 100644 --- a/clients/client-inspector/commands/SetTagsForResourceCommand.ts +++ b/clients/client-inspector/commands/SetTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type SetTagsForResourceCommandInput = SetTagsForResourceRequest; export type SetTagsForResourceCommandOutput = __MetadataBearer; +/** + *

Sets tags (key and value pairs) to the assessment template that is specified by the + * ARN of the assessment template.

+ */ export class SetTagsForResourceCommand extends $Command< SetTagsForResourceCommandInput, SetTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class SetTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/StartAssessmentRunCommand.ts b/clients/client-inspector/commands/StartAssessmentRunCommand.ts index ddb66d77e0128..ac672cbf22350 100644 --- a/clients/client-inspector/commands/StartAssessmentRunCommand.ts +++ b/clients/client-inspector/commands/StartAssessmentRunCommand.ts @@ -20,6 +20,11 @@ import { export type StartAssessmentRunCommandInput = StartAssessmentRunRequest; export type StartAssessmentRunCommandOutput = StartAssessmentRunResponse & __MetadataBearer; +/** + *

Starts the assessment run specified by the ARN of the assessment template. For this + * API to function properly, you must not exceed the limit of running up to 500 concurrent + * agents per AWS account.

+ */ export class StartAssessmentRunCommand extends $Command< StartAssessmentRunCommandInput, StartAssessmentRunCommandOutput, @@ -34,6 +39,9 @@ export class StartAssessmentRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/StopAssessmentRunCommand.ts b/clients/client-inspector/commands/StopAssessmentRunCommand.ts index 5723d0bff76b7..a5de9f5817e51 100644 --- a/clients/client-inspector/commands/StopAssessmentRunCommand.ts +++ b/clients/client-inspector/commands/StopAssessmentRunCommand.ts @@ -20,6 +20,10 @@ import { export type StopAssessmentRunCommandInput = StopAssessmentRunRequest; export type StopAssessmentRunCommandOutput = __MetadataBearer; +/** + *

Stops the assessment run that is specified by the ARN of the assessment + * run.

+ */ export class StopAssessmentRunCommand extends $Command< StopAssessmentRunCommandInput, StopAssessmentRunCommandOutput, @@ -34,6 +38,9 @@ export class StopAssessmentRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/SubscribeToEventCommand.ts b/clients/client-inspector/commands/SubscribeToEventCommand.ts index ead9041fcdfd3..753cb6043da56 100644 --- a/clients/client-inspector/commands/SubscribeToEventCommand.ts +++ b/clients/client-inspector/commands/SubscribeToEventCommand.ts @@ -20,6 +20,10 @@ import { export type SubscribeToEventCommandInput = SubscribeToEventRequest; export type SubscribeToEventCommandOutput = __MetadataBearer; +/** + *

Enables the process of sending Amazon Simple Notification Service (SNS) notifications + * about a specified event to a specified SNS topic.

+ */ export class SubscribeToEventCommand extends $Command< SubscribeToEventCommandInput, SubscribeToEventCommandOutput, @@ -34,6 +38,9 @@ export class SubscribeToEventCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/UnsubscribeFromEventCommand.ts b/clients/client-inspector/commands/UnsubscribeFromEventCommand.ts index 91220642f30bc..c79bd14e3444c 100644 --- a/clients/client-inspector/commands/UnsubscribeFromEventCommand.ts +++ b/clients/client-inspector/commands/UnsubscribeFromEventCommand.ts @@ -20,6 +20,10 @@ import { export type UnsubscribeFromEventCommandInput = UnsubscribeFromEventRequest; export type UnsubscribeFromEventCommandOutput = __MetadataBearer; +/** + *

Disables the process of sending Amazon Simple Notification Service (SNS) + * notifications about a specified event to a specified SNS topic.

+ */ export class UnsubscribeFromEventCommand extends $Command< UnsubscribeFromEventCommandInput, UnsubscribeFromEventCommandOutput, @@ -34,6 +38,9 @@ export class UnsubscribeFromEventCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/commands/UpdateAssessmentTargetCommand.ts b/clients/client-inspector/commands/UpdateAssessmentTargetCommand.ts index 3e3b7e36832bb..2173068d05524 100644 --- a/clients/client-inspector/commands/UpdateAssessmentTargetCommand.ts +++ b/clients/client-inspector/commands/UpdateAssessmentTargetCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateAssessmentTargetCommandInput = UpdateAssessmentTargetRequest; export type UpdateAssessmentTargetCommandOutput = __MetadataBearer; +/** + *

Updates the assessment target that is specified by the ARN of the assessment + * target.

+ *

If resourceGroupArn is not specified, all EC2 instances in the current AWS account + * and region are included in the assessment target.

+ */ export class UpdateAssessmentTargetCommand extends $Command< UpdateAssessmentTargetCommandInput, UpdateAssessmentTargetCommandOutput, @@ -34,6 +40,9 @@ export class UpdateAssessmentTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: InspectorClientResolvedConfig, diff --git a/clients/client-inspector/package.json b/clients/client-inspector/package.json index 9b995acb46b4a..48a31fc560f84 100644 --- a/clients/client-inspector/package.json +++ b/clients/client-inspector/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Inspector Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-inspector/pagination/GetExclusionsPreviewPaginator.ts b/clients/client-inspector/pagination/GetExclusionsPreviewPaginator.ts index c5102c45d0914..0051e0cacbfc4 100644 --- a/clients/client-inspector/pagination/GetExclusionsPreviewPaginator.ts +++ b/clients/client-inspector/pagination/GetExclusionsPreviewPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: GetExclusionsPreviewCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetExclusionsPreviewCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: GetExclusionsPreviewCommandInput, diff --git a/clients/client-inspector/pagination/ListAssessmentRunAgentsPaginator.ts b/clients/client-inspector/pagination/ListAssessmentRunAgentsPaginator.ts index eb8cb5567d5e0..53bf56151bbab 100644 --- a/clients/client-inspector/pagination/ListAssessmentRunAgentsPaginator.ts +++ b/clients/client-inspector/pagination/ListAssessmentRunAgentsPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: ListAssessmentRunAgentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssessmentRunAgentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: ListAssessmentRunAgentsCommandInput, diff --git a/clients/client-inspector/pagination/ListAssessmentRunsPaginator.ts b/clients/client-inspector/pagination/ListAssessmentRunsPaginator.ts index 2d08914740505..490050af56617 100644 --- a/clients/client-inspector/pagination/ListAssessmentRunsPaginator.ts +++ b/clients/client-inspector/pagination/ListAssessmentRunsPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: ListAssessmentRunsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssessmentRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: ListAssessmentRunsCommandInput, diff --git a/clients/client-inspector/pagination/ListAssessmentTargetsPaginator.ts b/clients/client-inspector/pagination/ListAssessmentTargetsPaginator.ts index 726d8c6b44a3b..731acc609568f 100644 --- a/clients/client-inspector/pagination/ListAssessmentTargetsPaginator.ts +++ b/clients/client-inspector/pagination/ListAssessmentTargetsPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: ListAssessmentTargetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssessmentTargetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: ListAssessmentTargetsCommandInput, diff --git a/clients/client-inspector/pagination/ListAssessmentTemplatesPaginator.ts b/clients/client-inspector/pagination/ListAssessmentTemplatesPaginator.ts index f40bd1635e1a5..30fdbb6d792d1 100644 --- a/clients/client-inspector/pagination/ListAssessmentTemplatesPaginator.ts +++ b/clients/client-inspector/pagination/ListAssessmentTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: ListAssessmentTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssessmentTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: ListAssessmentTemplatesCommandInput, diff --git a/clients/client-inspector/pagination/ListEventSubscriptionsPaginator.ts b/clients/client-inspector/pagination/ListEventSubscriptionsPaginator.ts index 7d342661b39bb..9a7debde3c883 100644 --- a/clients/client-inspector/pagination/ListEventSubscriptionsPaginator.ts +++ b/clients/client-inspector/pagination/ListEventSubscriptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: ListEventSubscriptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEventSubscriptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: ListEventSubscriptionsCommandInput, diff --git a/clients/client-inspector/pagination/ListExclusionsPaginator.ts b/clients/client-inspector/pagination/ListExclusionsPaginator.ts index 3a15f95d17049..a223b40aee0fa 100644 --- a/clients/client-inspector/pagination/ListExclusionsPaginator.ts +++ b/clients/client-inspector/pagination/ListExclusionsPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: ListExclusionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListExclusionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: ListExclusionsCommandInput, diff --git a/clients/client-inspector/pagination/ListFindingsPaginator.ts b/clients/client-inspector/pagination/ListFindingsPaginator.ts index c9d3a9e0b5e60..7e43a1e7d7817 100644 --- a/clients/client-inspector/pagination/ListFindingsPaginator.ts +++ b/clients/client-inspector/pagination/ListFindingsPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: ListFindingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFindingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: ListFindingsCommandInput, diff --git a/clients/client-inspector/pagination/ListRulesPackagesPaginator.ts b/clients/client-inspector/pagination/ListRulesPackagesPaginator.ts index b0c66f298b63c..7c2d0272218b9 100644 --- a/clients/client-inspector/pagination/ListRulesPackagesPaginator.ts +++ b/clients/client-inspector/pagination/ListRulesPackagesPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: ListRulesPackagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRulesPackagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: ListRulesPackagesCommandInput, diff --git a/clients/client-inspector/pagination/PreviewAgentsPaginator.ts b/clients/client-inspector/pagination/PreviewAgentsPaginator.ts index 3116486575359..2c1705f599b54 100644 --- a/clients/client-inspector/pagination/PreviewAgentsPaginator.ts +++ b/clients/client-inspector/pagination/PreviewAgentsPaginator.ts @@ -8,6 +8,9 @@ import { import { InspectorPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: InspectorClient, input: PreviewAgentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new PreviewAgentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Inspector, input: PreviewAgentsCommandInput, diff --git a/clients/client-inspector/runtimeConfig.browser.ts b/clients/client-inspector/runtimeConfig.browser.ts index f3eb6c91d1d2b..62e8c2508ea3b 100644 --- a/clients/client-inspector/runtimeConfig.browser.ts +++ b/clients/client-inspector/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./InspectorClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-inspector/runtimeConfig.native.ts b/clients/client-inspector/runtimeConfig.native.ts index 2fdc349e058a1..d8d382462da9d 100644 --- a/clients/client-inspector/runtimeConfig.native.ts +++ b/clients/client-inspector/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./InspectorClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-inspector/runtimeConfig.shared.ts b/clients/client-inspector/runtimeConfig.shared.ts index 34d77165267f1..e735430eef544 100644 --- a/clients/client-inspector/runtimeConfig.shared.ts +++ b/clients/client-inspector/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-02-16", disableHostPrefix: false, diff --git a/clients/client-inspector/runtimeConfig.ts b/clients/client-inspector/runtimeConfig.ts index 4e24aae64cd19..96a508aadadd4 100644 --- a/clients/client-inspector/runtimeConfig.ts +++ b/clients/client-inspector/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./InspectorClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-inspector/tsconfig.json b/clients/client-inspector/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-inspector/tsconfig.json +++ b/clients/client-inspector/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iot-1click-devices-service/commands/ClaimDevicesByClaimCodeCommand.ts b/clients/client-iot-1click-devices-service/commands/ClaimDevicesByClaimCodeCommand.ts index 3171a5c5d140b..a5304f71ec069 100644 --- a/clients/client-iot-1click-devices-service/commands/ClaimDevicesByClaimCodeCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/ClaimDevicesByClaimCodeCommand.ts @@ -24,6 +24,10 @@ import { export type ClaimDevicesByClaimCodeCommandInput = ClaimDevicesByClaimCodeRequest; export type ClaimDevicesByClaimCodeCommandOutput = ClaimDevicesByClaimCodeResponse & __MetadataBearer; +/** + *

Adds device(s) to your account (i.e., claim one or more devices) if and only if you + * received a claim code with the device(s).

+ */ export class ClaimDevicesByClaimCodeCommand extends $Command< ClaimDevicesByClaimCodeCommandInput, ClaimDevicesByClaimCodeCommandOutput, @@ -38,6 +42,9 @@ export class ClaimDevicesByClaimCodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/DescribeDeviceCommand.ts b/clients/client-iot-1click-devices-service/commands/DescribeDeviceCommand.ts index ee4ed0a87aa82..f44ac3472d178 100644 --- a/clients/client-iot-1click-devices-service/commands/DescribeDeviceCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/DescribeDeviceCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeDeviceCommandInput = DescribeDeviceRequest; export type DescribeDeviceCommandOutput = DescribeDeviceResponse & __MetadataBearer; +/** + *

Given a device ID, returns a DescribeDeviceResponse object describing the + * details of the device.

+ */ export class DescribeDeviceCommand extends $Command< DescribeDeviceCommandInput, DescribeDeviceCommandOutput, @@ -38,6 +42,9 @@ export class DescribeDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/FinalizeDeviceClaimCommand.ts b/clients/client-iot-1click-devices-service/commands/FinalizeDeviceClaimCommand.ts index 737b8faa279c6..737bce33300b0 100644 --- a/clients/client-iot-1click-devices-service/commands/FinalizeDeviceClaimCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/FinalizeDeviceClaimCommand.ts @@ -24,6 +24,13 @@ import { export type FinalizeDeviceClaimCommandInput = FinalizeDeviceClaimRequest; export type FinalizeDeviceClaimCommandOutput = FinalizeDeviceClaimResponse & __MetadataBearer; +/** + *

Given a device ID, finalizes the claim request for the associated device.

+ *

Claiming a device consists of initiating a claim, then publishing a device event, + * and finalizing the claim. For a device of type button, a device event can + * be published by simply clicking the device.

+ *
+ */ export class FinalizeDeviceClaimCommand extends $Command< FinalizeDeviceClaimCommandInput, FinalizeDeviceClaimCommandOutput, @@ -38,6 +45,9 @@ export class FinalizeDeviceClaimCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/GetDeviceMethodsCommand.ts b/clients/client-iot-1click-devices-service/commands/GetDeviceMethodsCommand.ts index da73415db2f75..ed8b2c6267dc4 100644 --- a/clients/client-iot-1click-devices-service/commands/GetDeviceMethodsCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/GetDeviceMethodsCommand.ts @@ -24,6 +24,9 @@ import { export type GetDeviceMethodsCommandInput = GetDeviceMethodsRequest; export type GetDeviceMethodsCommandOutput = GetDeviceMethodsResponse & __MetadataBearer; +/** + *

Given a device ID, returns the invokable methods associated with the device.

+ */ export class GetDeviceMethodsCommand extends $Command< GetDeviceMethodsCommandInput, GetDeviceMethodsCommandOutput, @@ -38,6 +41,9 @@ export class GetDeviceMethodsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/InitiateDeviceClaimCommand.ts b/clients/client-iot-1click-devices-service/commands/InitiateDeviceClaimCommand.ts index 93aec6aea3777..73334be99088a 100644 --- a/clients/client-iot-1click-devices-service/commands/InitiateDeviceClaimCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/InitiateDeviceClaimCommand.ts @@ -24,6 +24,13 @@ import { export type InitiateDeviceClaimCommandInput = InitiateDeviceClaimRequest; export type InitiateDeviceClaimCommandOutput = InitiateDeviceClaimResponse & __MetadataBearer; +/** + *

Given a device ID, initiates a claim request for the associated device.

+ *

Claiming a device consists of initiating a claim, then publishing a device event, + * and finalizing the claim. For a device of type button, a device event can + * be published by simply clicking the device.

+ *
+ */ export class InitiateDeviceClaimCommand extends $Command< InitiateDeviceClaimCommandInput, InitiateDeviceClaimCommandOutput, @@ -38,6 +45,9 @@ export class InitiateDeviceClaimCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/InvokeDeviceMethodCommand.ts b/clients/client-iot-1click-devices-service/commands/InvokeDeviceMethodCommand.ts index e625c073c0a7e..8912aad467054 100644 --- a/clients/client-iot-1click-devices-service/commands/InvokeDeviceMethodCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/InvokeDeviceMethodCommand.ts @@ -24,6 +24,10 @@ import { export type InvokeDeviceMethodCommandInput = InvokeDeviceMethodRequest; export type InvokeDeviceMethodCommandOutput = InvokeDeviceMethodResponse & __MetadataBearer; +/** + *

Given a device ID, issues a request to invoke a named device method (with possible + * parameters). See the "Example POST" code snippet below.

+ */ export class InvokeDeviceMethodCommand extends $Command< InvokeDeviceMethodCommandInput, InvokeDeviceMethodCommandOutput, @@ -38,6 +42,9 @@ export class InvokeDeviceMethodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/ListDeviceEventsCommand.ts b/clients/client-iot-1click-devices-service/commands/ListDeviceEventsCommand.ts index 56da393bebb30..baaca877c5570 100644 --- a/clients/client-iot-1click-devices-service/commands/ListDeviceEventsCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/ListDeviceEventsCommand.ts @@ -24,6 +24,10 @@ import { export type ListDeviceEventsCommandInput = ListDeviceEventsRequest; export type ListDeviceEventsCommandOutput = ListDeviceEventsResponse & __MetadataBearer; +/** + *

Using a device ID, returns a DeviceEventsResponse object containing an + * array of events for the device.

+ */ export class ListDeviceEventsCommand extends $Command< ListDeviceEventsCommandInput, ListDeviceEventsCommandOutput, @@ -38,6 +42,9 @@ export class ListDeviceEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/ListDevicesCommand.ts b/clients/client-iot-1click-devices-service/commands/ListDevicesCommand.ts index f3d99e9d60c31..d1f1ab3b42609 100644 --- a/clients/client-iot-1click-devices-service/commands/ListDevicesCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/ListDevicesCommand.ts @@ -24,6 +24,9 @@ import { export type ListDevicesCommandInput = ListDevicesRequest; export type ListDevicesCommandOutput = ListDevicesResponse & __MetadataBearer; +/** + *

Lists the 1-Click compatible devices associated with your AWS account.

+ */ export class ListDevicesCommand extends $Command< ListDevicesCommandInput, ListDevicesCommandOutput, @@ -38,6 +41,9 @@ export class ListDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/ListTagsForResourceCommand.ts b/clients/client-iot-1click-devices-service/commands/ListTagsForResourceCommand.ts index 1b3139ffdace6..c9cc4ccb0c123 100644 --- a/clients/client-iot-1click-devices-service/commands/ListTagsForResourceCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags associated with the specified resource ARN.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +41,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/TagResourceCommand.ts b/clients/client-iot-1click-devices-service/commands/TagResourceCommand.ts index d200c23c6f3f0..ada0959573207 100644 --- a/clients/client-iot-1click-devices-service/commands/TagResourceCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/TagResourceCommand.ts @@ -24,6 +24,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds or updates the tags associated with the resource ARN. See AWS IoT 1-Click Service Limits for the maximum number of tags allowed per + * resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +42,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/UnclaimDeviceCommand.ts b/clients/client-iot-1click-devices-service/commands/UnclaimDeviceCommand.ts index 3056a375c51b6..4903f6ba0bd8e 100644 --- a/clients/client-iot-1click-devices-service/commands/UnclaimDeviceCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/UnclaimDeviceCommand.ts @@ -24,6 +24,9 @@ import { export type UnclaimDeviceCommandInput = UnclaimDeviceRequest; export type UnclaimDeviceCommandOutput = UnclaimDeviceResponse & __MetadataBearer; +/** + *

Disassociates a device from your AWS account using its device ID.

+ */ export class UnclaimDeviceCommand extends $Command< UnclaimDeviceCommandInput, UnclaimDeviceCommandOutput, @@ -38,6 +41,9 @@ export class UnclaimDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/UntagResourceCommand.ts b/clients/client-iot-1click-devices-service/commands/UntagResourceCommand.ts index fc1289f200d17..111ed8e845ff5 100644 --- a/clients/client-iot-1click-devices-service/commands/UntagResourceCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/UntagResourceCommand.ts @@ -24,6 +24,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Using tag keys, deletes the tags (key/value pairs) associated with the specified + * resource ARN.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +42,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/commands/UpdateDeviceStateCommand.ts b/clients/client-iot-1click-devices-service/commands/UpdateDeviceStateCommand.ts index ad83f06bc2fa6..7340739944407 100644 --- a/clients/client-iot-1click-devices-service/commands/UpdateDeviceStateCommand.ts +++ b/clients/client-iot-1click-devices-service/commands/UpdateDeviceStateCommand.ts @@ -24,6 +24,10 @@ import { export type UpdateDeviceStateCommandInput = UpdateDeviceStateRequest; export type UpdateDeviceStateCommandOutput = UpdateDeviceStateResponse & __MetadataBearer; +/** + *

Using a Boolean value (true or false), this operation + * enables or disables the device given a device ID.

+ */ export class UpdateDeviceStateCommand extends $Command< UpdateDeviceStateCommandInput, UpdateDeviceStateCommandOutput, @@ -38,6 +42,9 @@ export class UpdateDeviceStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickDevicesServiceClientResolvedConfig, diff --git a/clients/client-iot-1click-devices-service/package.json b/clients/client-iot-1click-devices-service/package.json index fad95743d137c..f3336c9e82358 100644 --- a/clients/client-iot-1click-devices-service/package.json +++ b/clients/client-iot-1click-devices-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iot 1click Devices Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iot-1click-devices-service/runtimeConfig.browser.ts b/clients/client-iot-1click-devices-service/runtimeConfig.browser.ts index 278d015c1a18c..e4b50b48c0e40 100644 --- a/clients/client-iot-1click-devices-service/runtimeConfig.browser.ts +++ b/clients/client-iot-1click-devices-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoT1ClickDevicesServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iot-1click-devices-service/runtimeConfig.native.ts b/clients/client-iot-1click-devices-service/runtimeConfig.native.ts index e33cfc81c61eb..f86e6e9dce990 100644 --- a/clients/client-iot-1click-devices-service/runtimeConfig.native.ts +++ b/clients/client-iot-1click-devices-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoT1ClickDevicesServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iot-1click-devices-service/runtimeConfig.shared.ts b/clients/client-iot-1click-devices-service/runtimeConfig.shared.ts index 9524019aa5539..b0026e2e76d09 100644 --- a/clients/client-iot-1click-devices-service/runtimeConfig.shared.ts +++ b/clients/client-iot-1click-devices-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-05-14", disableHostPrefix: false, diff --git a/clients/client-iot-1click-devices-service/runtimeConfig.ts b/clients/client-iot-1click-devices-service/runtimeConfig.ts index 968e027b845d6..5ee39c34cfd09 100644 --- a/clients/client-iot-1click-devices-service/runtimeConfig.ts +++ b/clients/client-iot-1click-devices-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoT1ClickDevicesServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iot-1click-devices-service/tsconfig.json b/clients/client-iot-1click-devices-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iot-1click-devices-service/tsconfig.json +++ b/clients/client-iot-1click-devices-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iot-1click-projects/commands/AssociateDeviceWithPlacementCommand.ts b/clients/client-iot-1click-projects/commands/AssociateDeviceWithPlacementCommand.ts index a23790a2660f3..f5c2ff1987090 100644 --- a/clients/client-iot-1click-projects/commands/AssociateDeviceWithPlacementCommand.ts +++ b/clients/client-iot-1click-projects/commands/AssociateDeviceWithPlacementCommand.ts @@ -24,6 +24,9 @@ import { export type AssociateDeviceWithPlacementCommandInput = AssociateDeviceWithPlacementRequest; export type AssociateDeviceWithPlacementCommandOutput = AssociateDeviceWithPlacementResponse & __MetadataBearer; +/** + *

Associates a physical device with a placement.

+ */ export class AssociateDeviceWithPlacementCommand extends $Command< AssociateDeviceWithPlacementCommandInput, AssociateDeviceWithPlacementCommandOutput, @@ -38,6 +41,9 @@ export class AssociateDeviceWithPlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/CreatePlacementCommand.ts b/clients/client-iot-1click-projects/commands/CreatePlacementCommand.ts index 580931cd35dd0..8ee2577955561 100644 --- a/clients/client-iot-1click-projects/commands/CreatePlacementCommand.ts +++ b/clients/client-iot-1click-projects/commands/CreatePlacementCommand.ts @@ -24,6 +24,9 @@ import { export type CreatePlacementCommandInput = CreatePlacementRequest; export type CreatePlacementCommandOutput = CreatePlacementResponse & __MetadataBearer; +/** + *

Creates an empty placement.

+ */ export class CreatePlacementCommand extends $Command< CreatePlacementCommandInput, CreatePlacementCommandOutput, @@ -38,6 +41,9 @@ export class CreatePlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/CreateProjectCommand.ts b/clients/client-iot-1click-projects/commands/CreateProjectCommand.ts index 8541787ecb3c3..4756553630e2a 100644 --- a/clients/client-iot-1click-projects/commands/CreateProjectCommand.ts +++ b/clients/client-iot-1click-projects/commands/CreateProjectCommand.ts @@ -24,6 +24,10 @@ import { export type CreateProjectCommandInput = CreateProjectRequest; export type CreateProjectCommandOutput = CreateProjectResponse & __MetadataBearer; +/** + *

Creates an empty project with a placement template. A project contains zero or more + * placements that adhere to the placement template defined in the project.

+ */ export class CreateProjectCommand extends $Command< CreateProjectCommandInput, CreateProjectCommandOutput, @@ -38,6 +42,9 @@ export class CreateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/DeletePlacementCommand.ts b/clients/client-iot-1click-projects/commands/DeletePlacementCommand.ts index d2b0956a894be..fe0c4ef4fc7ce 100644 --- a/clients/client-iot-1click-projects/commands/DeletePlacementCommand.ts +++ b/clients/client-iot-1click-projects/commands/DeletePlacementCommand.ts @@ -24,6 +24,13 @@ import { export type DeletePlacementCommandInput = DeletePlacementRequest; export type DeletePlacementCommandOutput = DeletePlacementResponse & __MetadataBearer; +/** + *

Deletes a placement. To delete a placement, it must not have any devices associated with + * it.

+ * + *

When you delete a placement, all associated data becomes irretrievable.

+ *
+ */ export class DeletePlacementCommand extends $Command< DeletePlacementCommandInput, DeletePlacementCommandOutput, @@ -38,6 +45,9 @@ export class DeletePlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/DeleteProjectCommand.ts b/clients/client-iot-1click-projects/commands/DeleteProjectCommand.ts index f91d3b1b6b20b..3cf812bf2be3b 100644 --- a/clients/client-iot-1click-projects/commands/DeleteProjectCommand.ts +++ b/clients/client-iot-1click-projects/commands/DeleteProjectCommand.ts @@ -24,6 +24,13 @@ import { export type DeleteProjectCommandInput = DeleteProjectRequest; export type DeleteProjectCommandOutput = DeleteProjectResponse & __MetadataBearer; +/** + *

Deletes a project. To delete a project, it must not have any placements associated with + * it.

+ * + *

When you delete a project, all associated data becomes irretrievable.

+ *
+ */ export class DeleteProjectCommand extends $Command< DeleteProjectCommandInput, DeleteProjectCommandOutput, @@ -38,6 +45,9 @@ export class DeleteProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/DescribePlacementCommand.ts b/clients/client-iot-1click-projects/commands/DescribePlacementCommand.ts index 48409c3cadf34..a071fded3c40d 100644 --- a/clients/client-iot-1click-projects/commands/DescribePlacementCommand.ts +++ b/clients/client-iot-1click-projects/commands/DescribePlacementCommand.ts @@ -24,6 +24,9 @@ import { export type DescribePlacementCommandInput = DescribePlacementRequest; export type DescribePlacementCommandOutput = DescribePlacementResponse & __MetadataBearer; +/** + *

Describes a placement in a project.

+ */ export class DescribePlacementCommand extends $Command< DescribePlacementCommandInput, DescribePlacementCommandOutput, @@ -38,6 +41,9 @@ export class DescribePlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/DescribeProjectCommand.ts b/clients/client-iot-1click-projects/commands/DescribeProjectCommand.ts index ef801d2d6993f..3a1d576fa4a79 100644 --- a/clients/client-iot-1click-projects/commands/DescribeProjectCommand.ts +++ b/clients/client-iot-1click-projects/commands/DescribeProjectCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeProjectCommandInput = DescribeProjectRequest; export type DescribeProjectCommandOutput = DescribeProjectResponse & __MetadataBearer; +/** + *

Returns an object describing a project.

+ */ export class DescribeProjectCommand extends $Command< DescribeProjectCommandInput, DescribeProjectCommandOutput, @@ -38,6 +41,9 @@ export class DescribeProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/DisassociateDeviceFromPlacementCommand.ts b/clients/client-iot-1click-projects/commands/DisassociateDeviceFromPlacementCommand.ts index 03a9ce27d7c22..1fd943038ba4e 100644 --- a/clients/client-iot-1click-projects/commands/DisassociateDeviceFromPlacementCommand.ts +++ b/clients/client-iot-1click-projects/commands/DisassociateDeviceFromPlacementCommand.ts @@ -24,6 +24,9 @@ import { export type DisassociateDeviceFromPlacementCommandInput = DisassociateDeviceFromPlacementRequest; export type DisassociateDeviceFromPlacementCommandOutput = DisassociateDeviceFromPlacementResponse & __MetadataBearer; +/** + *

Removes a physical device from a placement.

+ */ export class DisassociateDeviceFromPlacementCommand extends $Command< DisassociateDeviceFromPlacementCommandInput, DisassociateDeviceFromPlacementCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateDeviceFromPlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/GetDevicesInPlacementCommand.ts b/clients/client-iot-1click-projects/commands/GetDevicesInPlacementCommand.ts index 0a37f195a39a9..f062965a0dd0c 100644 --- a/clients/client-iot-1click-projects/commands/GetDevicesInPlacementCommand.ts +++ b/clients/client-iot-1click-projects/commands/GetDevicesInPlacementCommand.ts @@ -24,6 +24,9 @@ import { export type GetDevicesInPlacementCommandInput = GetDevicesInPlacementRequest; export type GetDevicesInPlacementCommandOutput = GetDevicesInPlacementResponse & __MetadataBearer; +/** + *

Returns an object enumerating the devices in a placement.

+ */ export class GetDevicesInPlacementCommand extends $Command< GetDevicesInPlacementCommandInput, GetDevicesInPlacementCommandOutput, @@ -38,6 +41,9 @@ export class GetDevicesInPlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/ListPlacementsCommand.ts b/clients/client-iot-1click-projects/commands/ListPlacementsCommand.ts index 86b79c38eef4a..862b463f66e6f 100644 --- a/clients/client-iot-1click-projects/commands/ListPlacementsCommand.ts +++ b/clients/client-iot-1click-projects/commands/ListPlacementsCommand.ts @@ -24,6 +24,9 @@ import { export type ListPlacementsCommandInput = ListPlacementsRequest; export type ListPlacementsCommandOutput = ListPlacementsResponse & __MetadataBearer; +/** + *

Lists the placement(s) of a project.

+ */ export class ListPlacementsCommand extends $Command< ListPlacementsCommandInput, ListPlacementsCommandOutput, @@ -38,6 +41,9 @@ export class ListPlacementsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/ListProjectsCommand.ts b/clients/client-iot-1click-projects/commands/ListProjectsCommand.ts index eadd70ec615a5..92cc52a106515 100644 --- a/clients/client-iot-1click-projects/commands/ListProjectsCommand.ts +++ b/clients/client-iot-1click-projects/commands/ListProjectsCommand.ts @@ -24,6 +24,9 @@ import { export type ListProjectsCommandInput = ListProjectsRequest; export type ListProjectsCommandOutput = ListProjectsResponse & __MetadataBearer; +/** + *

Lists the AWS IoT 1-Click project(s) associated with your AWS account and region.

+ */ export class ListProjectsCommand extends $Command< ListProjectsCommandInput, ListProjectsCommandOutput, @@ -38,6 +41,9 @@ export class ListProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/ListTagsForResourceCommand.ts b/clients/client-iot-1click-projects/commands/ListTagsForResourceCommand.ts index 307f3997a91d8..7676a224e8e4d 100644 --- a/clients/client-iot-1click-projects/commands/ListTagsForResourceCommand.ts +++ b/clients/client-iot-1click-projects/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags (metadata key/value pairs) which you have assigned to the resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +41,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/TagResourceCommand.ts b/clients/client-iot-1click-projects/commands/TagResourceCommand.ts index a55d1152bb9d4..4d27d15b4c8d8 100644 --- a/clients/client-iot-1click-projects/commands/TagResourceCommand.ts +++ b/clients/client-iot-1click-projects/commands/TagResourceCommand.ts @@ -24,6 +24,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Creates or modifies tags for a resource. Tags are key/value pairs (metadata) that can be + * used to manage a resource. For more information, see AWS Tagging + * Strategies.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +43,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/UntagResourceCommand.ts b/clients/client-iot-1click-projects/commands/UntagResourceCommand.ts index 45356a6eddc79..ef1349ab8ec27 100644 --- a/clients/client-iot-1click-projects/commands/UntagResourceCommand.ts +++ b/clients/client-iot-1click-projects/commands/UntagResourceCommand.ts @@ -24,6 +24,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags (metadata key/value pairs) from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +41,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/UpdatePlacementCommand.ts b/clients/client-iot-1click-projects/commands/UpdatePlacementCommand.ts index cf3d59cdf2d0e..785f824c24580 100644 --- a/clients/client-iot-1click-projects/commands/UpdatePlacementCommand.ts +++ b/clients/client-iot-1click-projects/commands/UpdatePlacementCommand.ts @@ -24,6 +24,10 @@ import { export type UpdatePlacementCommandInput = UpdatePlacementRequest; export type UpdatePlacementCommandOutput = UpdatePlacementResponse & __MetadataBearer; +/** + *

Updates a placement with the given attributes. To clear an attribute, pass an empty value + * (i.e., "").

+ */ export class UpdatePlacementCommand extends $Command< UpdatePlacementCommandInput, UpdatePlacementCommandOutput, @@ -38,6 +42,9 @@ export class UpdatePlacementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/commands/UpdateProjectCommand.ts b/clients/client-iot-1click-projects/commands/UpdateProjectCommand.ts index 67941d6a7fcc4..d767942e0210e 100644 --- a/clients/client-iot-1click-projects/commands/UpdateProjectCommand.ts +++ b/clients/client-iot-1click-projects/commands/UpdateProjectCommand.ts @@ -24,6 +24,12 @@ import { export type UpdateProjectCommandInput = UpdateProjectRequest; export type UpdateProjectCommandOutput = UpdateProjectResponse & __MetadataBearer; +/** + *

Updates a project associated with your AWS account and region. With the exception of + * device template names, you can pass just the values that need to be updated because the update + * request will change only the values that are provided. To clear a value, pass the empty string + * (i.e., "").

+ */ export class UpdateProjectCommand extends $Command< UpdateProjectCommandInput, UpdateProjectCommandOutput, @@ -38,6 +44,9 @@ export class UpdateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoT1ClickProjectsClientResolvedConfig, diff --git a/clients/client-iot-1click-projects/package.json b/clients/client-iot-1click-projects/package.json index 0470391d045e3..8ed39b8978de1 100644 --- a/clients/client-iot-1click-projects/package.json +++ b/clients/client-iot-1click-projects/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iot 1click Projects Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iot-1click-projects/pagination/ListPlacementsPaginator.ts b/clients/client-iot-1click-projects/pagination/ListPlacementsPaginator.ts index f5af5c95d497f..2957ffee9502b 100644 --- a/clients/client-iot-1click-projects/pagination/ListPlacementsPaginator.ts +++ b/clients/client-iot-1click-projects/pagination/ListPlacementsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoT1ClickProjectsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoT1ClickProjectsClient, input: ListPlacementsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPlacementsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT1ClickProjects, input: ListPlacementsCommandInput, diff --git a/clients/client-iot-1click-projects/pagination/ListProjectsPaginator.ts b/clients/client-iot-1click-projects/pagination/ListProjectsPaginator.ts index 8f0130751f5a1..d6508087f99fd 100644 --- a/clients/client-iot-1click-projects/pagination/ListProjectsPaginator.ts +++ b/clients/client-iot-1click-projects/pagination/ListProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoT1ClickProjectsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoT1ClickProjectsClient, input: ListProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT1ClickProjects, input: ListProjectsCommandInput, diff --git a/clients/client-iot-1click-projects/runtimeConfig.browser.ts b/clients/client-iot-1click-projects/runtimeConfig.browser.ts index 182c86a6ed454..d7384e4152ad7 100644 --- a/clients/client-iot-1click-projects/runtimeConfig.browser.ts +++ b/clients/client-iot-1click-projects/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoT1ClickProjectsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iot-1click-projects/runtimeConfig.native.ts b/clients/client-iot-1click-projects/runtimeConfig.native.ts index 956fc81cf416b..a5bd4ffe1fc08 100644 --- a/clients/client-iot-1click-projects/runtimeConfig.native.ts +++ b/clients/client-iot-1click-projects/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoT1ClickProjectsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iot-1click-projects/runtimeConfig.shared.ts b/clients/client-iot-1click-projects/runtimeConfig.shared.ts index 9524019aa5539..b0026e2e76d09 100644 --- a/clients/client-iot-1click-projects/runtimeConfig.shared.ts +++ b/clients/client-iot-1click-projects/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-05-14", disableHostPrefix: false, diff --git a/clients/client-iot-1click-projects/runtimeConfig.ts b/clients/client-iot-1click-projects/runtimeConfig.ts index 86d038297e46d..c336965ae3902 100644 --- a/clients/client-iot-1click-projects/runtimeConfig.ts +++ b/clients/client-iot-1click-projects/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoT1ClickProjectsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iot-1click-projects/tsconfig.json b/clients/client-iot-1click-projects/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iot-1click-projects/tsconfig.json +++ b/clients/client-iot-1click-projects/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iot-data-plane/commands/DeleteThingShadowCommand.ts b/clients/client-iot-data-plane/commands/DeleteThingShadowCommand.ts index c12e942594c99..0bbb6a4437b18 100644 --- a/clients/client-iot-data-plane/commands/DeleteThingShadowCommand.ts +++ b/clients/client-iot-data-plane/commands/DeleteThingShadowCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteThingShadowCommandInput = DeleteThingShadowRequest; export type DeleteThingShadowCommandOutput = DeleteThingShadowResponse & __MetadataBearer; +/** + *

Deletes the shadow for the specified thing.

+ *

For more information, see DeleteThingShadow in the AWS IoT Developer Guide.

+ */ export class DeleteThingShadowCommand extends $Command< DeleteThingShadowCommandInput, DeleteThingShadowCommandOutput, @@ -34,6 +38,9 @@ export class DeleteThingShadowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-data-plane/commands/GetThingShadowCommand.ts b/clients/client-iot-data-plane/commands/GetThingShadowCommand.ts index 4ff7e78ffcc4f..a36acb724b7d6 100644 --- a/clients/client-iot-data-plane/commands/GetThingShadowCommand.ts +++ b/clients/client-iot-data-plane/commands/GetThingShadowCommand.ts @@ -20,6 +20,11 @@ import { export type GetThingShadowCommandInput = GetThingShadowRequest; export type GetThingShadowCommandOutput = GetThingShadowResponse & __MetadataBearer; +/** + *

Gets the shadow for the specified thing.

+ *

For more information, see GetThingShadow in the + * AWS IoT Developer Guide.

+ */ export class GetThingShadowCommand extends $Command< GetThingShadowCommandInput, GetThingShadowCommandOutput, @@ -34,6 +39,9 @@ export class GetThingShadowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-data-plane/commands/ListNamedShadowsForThingCommand.ts b/clients/client-iot-data-plane/commands/ListNamedShadowsForThingCommand.ts index 4eac4ca01d877..219874ad14fae 100644 --- a/clients/client-iot-data-plane/commands/ListNamedShadowsForThingCommand.ts +++ b/clients/client-iot-data-plane/commands/ListNamedShadowsForThingCommand.ts @@ -20,6 +20,9 @@ import { export type ListNamedShadowsForThingCommandInput = ListNamedShadowsForThingRequest; export type ListNamedShadowsForThingCommandOutput = ListNamedShadowsForThingResponse & __MetadataBearer; +/** + *

Lists the shadows for the specified thing.

+ */ export class ListNamedShadowsForThingCommand extends $Command< ListNamedShadowsForThingCommandInput, ListNamedShadowsForThingCommandOutput, @@ -34,6 +37,9 @@ export class ListNamedShadowsForThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-data-plane/commands/PublishCommand.ts b/clients/client-iot-data-plane/commands/PublishCommand.ts index 762a9a85d562e..4b5e047c64735 100644 --- a/clients/client-iot-data-plane/commands/PublishCommand.ts +++ b/clients/client-iot-data-plane/commands/PublishCommand.ts @@ -20,6 +20,11 @@ import { export type PublishCommandInput = PublishRequest; export type PublishCommandOutput = __MetadataBearer; +/** + *

Publishes state information.

+ *

For more information, see HTTP Protocol in the + * AWS IoT Developer Guide.

+ */ export class PublishCommand extends $Command< PublishCommandInput, PublishCommandOutput, @@ -34,6 +39,9 @@ export class PublishCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-data-plane/commands/UpdateThingShadowCommand.ts b/clients/client-iot-data-plane/commands/UpdateThingShadowCommand.ts index 499317c8d378f..b10bbf1f78fd8 100644 --- a/clients/client-iot-data-plane/commands/UpdateThingShadowCommand.ts +++ b/clients/client-iot-data-plane/commands/UpdateThingShadowCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateThingShadowCommandInput = UpdateThingShadowRequest; export type UpdateThingShadowCommandOutput = UpdateThingShadowResponse & __MetadataBearer; +/** + *

Updates the shadow for the specified thing.

+ *

For more information, see UpdateThingShadow in the + * AWS IoT Developer Guide.

+ */ export class UpdateThingShadowCommand extends $Command< UpdateThingShadowCommandInput, UpdateThingShadowCommandOutput, @@ -34,6 +39,9 @@ export class UpdateThingShadowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-data-plane/package.json b/clients/client-iot-data-plane/package.json index 7df323ee6a604..bf500a2d8f3e6 100644 --- a/clients/client-iot-data-plane/package.json +++ b/clients/client-iot-data-plane/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iot Data Plane Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iot-data-plane/runtimeConfig.browser.ts b/clients/client-iot-data-plane/runtimeConfig.browser.ts index a0797320e5584..99dfa23ebd14b 100644 --- a/clients/client-iot-data-plane/runtimeConfig.browser.ts +++ b/clients/client-iot-data-plane/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTDataPlaneClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iot-data-plane/runtimeConfig.native.ts b/clients/client-iot-data-plane/runtimeConfig.native.ts index 61cea8cb5c1ab..f667ec0e62316 100644 --- a/clients/client-iot-data-plane/runtimeConfig.native.ts +++ b/clients/client-iot-data-plane/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTDataPlaneClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iot-data-plane/runtimeConfig.shared.ts b/clients/client-iot-data-plane/runtimeConfig.shared.ts index 4e3b0ae85858e..4214e2d61dbdd 100644 --- a/clients/client-iot-data-plane/runtimeConfig.shared.ts +++ b/clients/client-iot-data-plane/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-05-28", disableHostPrefix: false, diff --git a/clients/client-iot-data-plane/runtimeConfig.ts b/clients/client-iot-data-plane/runtimeConfig.ts index 461e3c3be8bae..b9d051dce059b 100644 --- a/clients/client-iot-data-plane/runtimeConfig.ts +++ b/clients/client-iot-data-plane/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTDataPlaneClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iot-data-plane/tsconfig.json b/clients/client-iot-data-plane/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iot-data-plane/tsconfig.json +++ b/clients/client-iot-data-plane/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iot-events-data/commands/BatchPutMessageCommand.ts b/clients/client-iot-events-data/commands/BatchPutMessageCommand.ts index 0eaf37b4a370a..e20739ad53213 100644 --- a/clients/client-iot-events-data/commands/BatchPutMessageCommand.ts +++ b/clients/client-iot-events-data/commands/BatchPutMessageCommand.ts @@ -20,6 +20,13 @@ import { export type BatchPutMessageCommandInput = BatchPutMessageRequest; export type BatchPutMessageCommandOutput = BatchPutMessageResponse & __MetadataBearer; +/** + *

Sends a set of messages to the AWS IoT Events system. Each message payload is transformed + * into the input you specify ("inputName") and ingested into any detectors that monitor + * that input. If multiple messages are sent, the order in which the messages are processed isn't + * guaranteed. To guarantee ordering, you must send messages one at a time and wait for a successful + * response.

+ */ export class BatchPutMessageCommand extends $Command< BatchPutMessageCommandInput, BatchPutMessageCommandOutput, @@ -34,6 +41,9 @@ export class BatchPutMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsDataClientResolvedConfig, diff --git a/clients/client-iot-events-data/commands/BatchUpdateDetectorCommand.ts b/clients/client-iot-events-data/commands/BatchUpdateDetectorCommand.ts index abb4b0069f2c1..9156d0161593b 100644 --- a/clients/client-iot-events-data/commands/BatchUpdateDetectorCommand.ts +++ b/clients/client-iot-events-data/commands/BatchUpdateDetectorCommand.ts @@ -20,6 +20,10 @@ import { export type BatchUpdateDetectorCommandInput = BatchUpdateDetectorRequest; export type BatchUpdateDetectorCommandOutput = BatchUpdateDetectorResponse & __MetadataBearer; +/** + *

Updates the state, variable values, and timer settings of one or more detectors (instances) + * of a specified detector model.

+ */ export class BatchUpdateDetectorCommand extends $Command< BatchUpdateDetectorCommandInput, BatchUpdateDetectorCommandOutput, @@ -34,6 +38,9 @@ export class BatchUpdateDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsDataClientResolvedConfig, diff --git a/clients/client-iot-events-data/commands/DescribeDetectorCommand.ts b/clients/client-iot-events-data/commands/DescribeDetectorCommand.ts index 41e68ef2bbd07..fcf072e1a8550 100644 --- a/clients/client-iot-events-data/commands/DescribeDetectorCommand.ts +++ b/clients/client-iot-events-data/commands/DescribeDetectorCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDetectorCommandInput = DescribeDetectorRequest; export type DescribeDetectorCommandOutput = DescribeDetectorResponse & __MetadataBearer; +/** + *

Returns information about the specified detector (instance).

+ */ export class DescribeDetectorCommand extends $Command< DescribeDetectorCommandInput, DescribeDetectorCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDetectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsDataClientResolvedConfig, diff --git a/clients/client-iot-events-data/commands/ListDetectorsCommand.ts b/clients/client-iot-events-data/commands/ListDetectorsCommand.ts index 1f1ea9405edd5..406e72feb893e 100644 --- a/clients/client-iot-events-data/commands/ListDetectorsCommand.ts +++ b/clients/client-iot-events-data/commands/ListDetectorsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDetectorsCommandInput = ListDetectorsRequest; export type ListDetectorsCommandOutput = ListDetectorsResponse & __MetadataBearer; +/** + *

Lists detectors (the instances of a detector model).

+ */ export class ListDetectorsCommand extends $Command< ListDetectorsCommandInput, ListDetectorsCommandOutput, @@ -34,6 +37,9 @@ export class ListDetectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsDataClientResolvedConfig, diff --git a/clients/client-iot-events-data/package.json b/clients/client-iot-events-data/package.json index 442d376537aa5..8cf0224be6cb0 100644 --- a/clients/client-iot-events-data/package.json +++ b/clients/client-iot-events-data/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iot Events Data Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iot-events-data/runtimeConfig.browser.ts b/clients/client-iot-events-data/runtimeConfig.browser.ts index be1179d214a33..aeaac0bbbd7ce 100644 --- a/clients/client-iot-events-data/runtimeConfig.browser.ts +++ b/clients/client-iot-events-data/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTEventsDataClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iot-events-data/runtimeConfig.native.ts b/clients/client-iot-events-data/runtimeConfig.native.ts index 1f5604b65a6d9..78149a851e496 100644 --- a/clients/client-iot-events-data/runtimeConfig.native.ts +++ b/clients/client-iot-events-data/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTEventsDataClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iot-events-data/runtimeConfig.shared.ts b/clients/client-iot-events-data/runtimeConfig.shared.ts index 695d570477521..a1868ace9fef3 100644 --- a/clients/client-iot-events-data/runtimeConfig.shared.ts +++ b/clients/client-iot-events-data/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-10-23", disableHostPrefix: false, diff --git a/clients/client-iot-events-data/runtimeConfig.ts b/clients/client-iot-events-data/runtimeConfig.ts index cec773704efed..f6b6214026111 100644 --- a/clients/client-iot-events-data/runtimeConfig.ts +++ b/clients/client-iot-events-data/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTEventsDataClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iot-events-data/tsconfig.json b/clients/client-iot-events-data/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iot-events-data/tsconfig.json +++ b/clients/client-iot-events-data/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iot-events/commands/CreateDetectorModelCommand.ts b/clients/client-iot-events/commands/CreateDetectorModelCommand.ts index 623947ff3bcf2..8027d585906ee 100644 --- a/clients/client-iot-events/commands/CreateDetectorModelCommand.ts +++ b/clients/client-iot-events/commands/CreateDetectorModelCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDetectorModelCommandInput = CreateDetectorModelRequest; export type CreateDetectorModelCommandOutput = CreateDetectorModelResponse & __MetadataBearer; +/** + *

Creates a detector model.

+ */ export class CreateDetectorModelCommand extends $Command< CreateDetectorModelCommandInput, CreateDetectorModelCommandOutput, @@ -34,6 +37,9 @@ export class CreateDetectorModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/CreateInputCommand.ts b/clients/client-iot-events/commands/CreateInputCommand.ts index 01779b3b49bc2..31799c2ef57d5 100644 --- a/clients/client-iot-events/commands/CreateInputCommand.ts +++ b/clients/client-iot-events/commands/CreateInputCommand.ts @@ -20,6 +20,9 @@ import { export type CreateInputCommandInput = CreateInputRequest; export type CreateInputCommandOutput = CreateInputResponse & __MetadataBearer; +/** + *

Creates an input.

+ */ export class CreateInputCommand extends $Command< CreateInputCommandInput, CreateInputCommandOutput, @@ -34,6 +37,9 @@ export class CreateInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/DeleteDetectorModelCommand.ts b/clients/client-iot-events/commands/DeleteDetectorModelCommand.ts index 4cfb3e4be0585..fffdba434624c 100644 --- a/clients/client-iot-events/commands/DeleteDetectorModelCommand.ts +++ b/clients/client-iot-events/commands/DeleteDetectorModelCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDetectorModelCommandInput = DeleteDetectorModelRequest; export type DeleteDetectorModelCommandOutput = DeleteDetectorModelResponse & __MetadataBearer; +/** + *

Deletes a detector model. Any active instances of the detector model are also + * deleted.

+ */ export class DeleteDetectorModelCommand extends $Command< DeleteDetectorModelCommandInput, DeleteDetectorModelCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDetectorModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/DeleteInputCommand.ts b/clients/client-iot-events/commands/DeleteInputCommand.ts index 717de52f7ad2c..02cbda273b220 100644 --- a/clients/client-iot-events/commands/DeleteInputCommand.ts +++ b/clients/client-iot-events/commands/DeleteInputCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteInputCommandInput = DeleteInputRequest; export type DeleteInputCommandOutput = DeleteInputResponse & __MetadataBearer; +/** + *

Deletes an input.

+ */ export class DeleteInputCommand extends $Command< DeleteInputCommandInput, DeleteInputCommandOutput, @@ -34,6 +37,9 @@ export class DeleteInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/DescribeDetectorModelCommand.ts b/clients/client-iot-events/commands/DescribeDetectorModelCommand.ts index 304b246bf3c67..06cb2cfca237b 100644 --- a/clients/client-iot-events/commands/DescribeDetectorModelCommand.ts +++ b/clients/client-iot-events/commands/DescribeDetectorModelCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDetectorModelCommandInput = DescribeDetectorModelRequest; export type DescribeDetectorModelCommandOutput = DescribeDetectorModelResponse & __MetadataBearer; +/** + *

Describes a detector model. If the version parameter is not specified, + * information about the latest version is returned.

+ */ export class DescribeDetectorModelCommand extends $Command< DescribeDetectorModelCommandInput, DescribeDetectorModelCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDetectorModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/DescribeInputCommand.ts b/clients/client-iot-events/commands/DescribeInputCommand.ts index dbfe3b332516b..e551c4b91c7fa 100644 --- a/clients/client-iot-events/commands/DescribeInputCommand.ts +++ b/clients/client-iot-events/commands/DescribeInputCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInputCommandInput = DescribeInputRequest; export type DescribeInputCommandOutput = DescribeInputResponse & __MetadataBearer; +/** + *

Describes an input.

+ */ export class DescribeInputCommand extends $Command< DescribeInputCommandInput, DescribeInputCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/DescribeLoggingOptionsCommand.ts b/clients/client-iot-events/commands/DescribeLoggingOptionsCommand.ts index 8a1667c19ddee..2049b4c3690b8 100644 --- a/clients/client-iot-events/commands/DescribeLoggingOptionsCommand.ts +++ b/clients/client-iot-events/commands/DescribeLoggingOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLoggingOptionsCommandInput = DescribeLoggingOptionsRequest; export type DescribeLoggingOptionsCommandOutput = DescribeLoggingOptionsResponse & __MetadataBearer; +/** + *

Retrieves the current settings of the AWS IoT Events logging options.

+ */ export class DescribeLoggingOptionsCommand extends $Command< DescribeLoggingOptionsCommandInput, DescribeLoggingOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/ListDetectorModelVersionsCommand.ts b/clients/client-iot-events/commands/ListDetectorModelVersionsCommand.ts index 6bc6022b8c4ae..da6ca63bea030 100644 --- a/clients/client-iot-events/commands/ListDetectorModelVersionsCommand.ts +++ b/clients/client-iot-events/commands/ListDetectorModelVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDetectorModelVersionsCommandInput = ListDetectorModelVersionsRequest; export type ListDetectorModelVersionsCommandOutput = ListDetectorModelVersionsResponse & __MetadataBearer; +/** + *

Lists all the versions of a detector model. Only the metadata associated with each + * detector model version is returned.

+ */ export class ListDetectorModelVersionsCommand extends $Command< ListDetectorModelVersionsCommandInput, ListDetectorModelVersionsCommandOutput, @@ -34,6 +38,9 @@ export class ListDetectorModelVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/ListDetectorModelsCommand.ts b/clients/client-iot-events/commands/ListDetectorModelsCommand.ts index adc9d6a2a3d60..204205d3038c1 100644 --- a/clients/client-iot-events/commands/ListDetectorModelsCommand.ts +++ b/clients/client-iot-events/commands/ListDetectorModelsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDetectorModelsCommandInput = ListDetectorModelsRequest; export type ListDetectorModelsCommandOutput = ListDetectorModelsResponse & __MetadataBearer; +/** + *

Lists the detector models you have created. Only the metadata associated with each + * detector model is returned.

+ */ export class ListDetectorModelsCommand extends $Command< ListDetectorModelsCommandInput, ListDetectorModelsCommandOutput, @@ -34,6 +38,9 @@ export class ListDetectorModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/ListInputsCommand.ts b/clients/client-iot-events/commands/ListInputsCommand.ts index 1df289f760835..77ab91282cf47 100644 --- a/clients/client-iot-events/commands/ListInputsCommand.ts +++ b/clients/client-iot-events/commands/ListInputsCommand.ts @@ -20,6 +20,9 @@ import { export type ListInputsCommandInput = ListInputsRequest; export type ListInputsCommandOutput = ListInputsResponse & __MetadataBearer; +/** + *

Lists the inputs you have created.

+ */ export class ListInputsCommand extends $Command< ListInputsCommandInput, ListInputsCommandOutput, @@ -34,6 +37,9 @@ export class ListInputsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/ListTagsForResourceCommand.ts b/clients/client-iot-events/commands/ListTagsForResourceCommand.ts index 3f303fcc57b1e..6e7a9ca17c60d 100644 --- a/clients/client-iot-events/commands/ListTagsForResourceCommand.ts +++ b/clients/client-iot-events/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags (metadata) you have assigned to the resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/PutLoggingOptionsCommand.ts b/clients/client-iot-events/commands/PutLoggingOptionsCommand.ts index 33ac44fcb86d0..bac8f617714f5 100644 --- a/clients/client-iot-events/commands/PutLoggingOptionsCommand.ts +++ b/clients/client-iot-events/commands/PutLoggingOptionsCommand.ts @@ -20,6 +20,13 @@ import { export type PutLoggingOptionsCommandInput = PutLoggingOptionsRequest; export type PutLoggingOptionsCommandOutput = __MetadataBearer; +/** + *

Sets or updates the AWS IoT Events logging options.

+ *

If you update the value of any loggingOptions field, it takes up to one + * minute for the change to take effect. If you change the policy attached to the role you + * specified in the roleArn field (for example, to correct an invalid policy), it + * takes up to five minutes for that change to take effect.

+ */ export class PutLoggingOptionsCommand extends $Command< PutLoggingOptionsCommandInput, PutLoggingOptionsCommandOutput, @@ -34,6 +41,9 @@ export class PutLoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/TagResourceCommand.ts b/clients/client-iot-events/commands/TagResourceCommand.ts index dce670183d36e..b9de6d8eac07d 100644 --- a/clients/client-iot-events/commands/TagResourceCommand.ts +++ b/clients/client-iot-events/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds to or modifies the tags of the given resource. Tags are metadata that can be used to + * manage a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/UntagResourceCommand.ts b/clients/client-iot-events/commands/UntagResourceCommand.ts index cf375638a3fef..3aeb78b81d2bd 100644 --- a/clients/client-iot-events/commands/UntagResourceCommand.ts +++ b/clients/client-iot-events/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the given tags (metadata) from the resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/UpdateDetectorModelCommand.ts b/clients/client-iot-events/commands/UpdateDetectorModelCommand.ts index 886f72009d654..4a433663eeb9e 100644 --- a/clients/client-iot-events/commands/UpdateDetectorModelCommand.ts +++ b/clients/client-iot-events/commands/UpdateDetectorModelCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDetectorModelCommandInput = UpdateDetectorModelRequest; export type UpdateDetectorModelCommandOutput = UpdateDetectorModelResponse & __MetadataBearer; +/** + *

Updates a detector model. Detectors (instances) spawned by the previous version are + * deleted and then re-created as new inputs arrive.

+ */ export class UpdateDetectorModelCommand extends $Command< UpdateDetectorModelCommandInput, UpdateDetectorModelCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDetectorModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/commands/UpdateInputCommand.ts b/clients/client-iot-events/commands/UpdateInputCommand.ts index 684ffc26a84c2..583f20886ca13 100644 --- a/clients/client-iot-events/commands/UpdateInputCommand.ts +++ b/clients/client-iot-events/commands/UpdateInputCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateInputCommandInput = UpdateInputRequest; export type UpdateInputCommandOutput = UpdateInputResponse & __MetadataBearer; +/** + *

Updates an input.

+ */ export class UpdateInputCommand extends $Command< UpdateInputCommandInput, UpdateInputCommandOutput, @@ -34,6 +37,9 @@ export class UpdateInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTEventsClientResolvedConfig, diff --git a/clients/client-iot-events/package.json b/clients/client-iot-events/package.json index dfbf7be2593b6..c6f9f1f8ebe70 100644 --- a/clients/client-iot-events/package.json +++ b/clients/client-iot-events/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iot Events Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iot-events/runtimeConfig.browser.ts b/clients/client-iot-events/runtimeConfig.browser.ts index d84f0b016e072..af63c349236a1 100644 --- a/clients/client-iot-events/runtimeConfig.browser.ts +++ b/clients/client-iot-events/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTEventsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iot-events/runtimeConfig.native.ts b/clients/client-iot-events/runtimeConfig.native.ts index 548e52573008a..2f1a3ebeef314 100644 --- a/clients/client-iot-events/runtimeConfig.native.ts +++ b/clients/client-iot-events/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTEventsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iot-events/runtimeConfig.shared.ts b/clients/client-iot-events/runtimeConfig.shared.ts index 79c7af2a73804..11c587bc5bd54 100644 --- a/clients/client-iot-events/runtimeConfig.shared.ts +++ b/clients/client-iot-events/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-07-27", disableHostPrefix: false, diff --git a/clients/client-iot-events/runtimeConfig.ts b/clients/client-iot-events/runtimeConfig.ts index 8a9ac3b3968e2..0246c2690c054 100644 --- a/clients/client-iot-events/runtimeConfig.ts +++ b/clients/client-iot-events/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTEventsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iot-events/tsconfig.json b/clients/client-iot-events/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iot-events/tsconfig.json +++ b/clients/client-iot-events/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iot-jobs-data-plane/commands/DescribeJobExecutionCommand.ts b/clients/client-iot-jobs-data-plane/commands/DescribeJobExecutionCommand.ts index ccf6b5e809d63..6d9d6a2c1091d 100644 --- a/clients/client-iot-jobs-data-plane/commands/DescribeJobExecutionCommand.ts +++ b/clients/client-iot-jobs-data-plane/commands/DescribeJobExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeJobExecutionCommandInput = DescribeJobExecutionRequest; export type DescribeJobExecutionCommandOutput = DescribeJobExecutionResponse & __MetadataBearer; +/** + *

Gets details of a job execution.

+ */ export class DescribeJobExecutionCommand extends $Command< DescribeJobExecutionCommandInput, DescribeJobExecutionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeJobExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTJobsDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-jobs-data-plane/commands/GetPendingJobExecutionsCommand.ts b/clients/client-iot-jobs-data-plane/commands/GetPendingJobExecutionsCommand.ts index 45b22749235d0..a54ed07bee778 100644 --- a/clients/client-iot-jobs-data-plane/commands/GetPendingJobExecutionsCommand.ts +++ b/clients/client-iot-jobs-data-plane/commands/GetPendingJobExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetPendingJobExecutionsCommandInput = GetPendingJobExecutionsRequest; export type GetPendingJobExecutionsCommandOutput = GetPendingJobExecutionsResponse & __MetadataBearer; +/** + *

Gets the list of all jobs for a thing that are not in a terminal status.

+ */ export class GetPendingJobExecutionsCommand extends $Command< GetPendingJobExecutionsCommandInput, GetPendingJobExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class GetPendingJobExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTJobsDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-jobs-data-plane/commands/StartNextPendingJobExecutionCommand.ts b/clients/client-iot-jobs-data-plane/commands/StartNextPendingJobExecutionCommand.ts index c093a6a556d13..760819952b14f 100644 --- a/clients/client-iot-jobs-data-plane/commands/StartNextPendingJobExecutionCommand.ts +++ b/clients/client-iot-jobs-data-plane/commands/StartNextPendingJobExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type StartNextPendingJobExecutionCommandInput = StartNextPendingJobExecutionRequest; export type StartNextPendingJobExecutionCommandOutput = StartNextPendingJobExecutionResponse & __MetadataBearer; +/** + *

Gets and starts the next pending (status IN_PROGRESS or QUEUED) job execution for a thing.

+ */ export class StartNextPendingJobExecutionCommand extends $Command< StartNextPendingJobExecutionCommandInput, StartNextPendingJobExecutionCommandOutput, @@ -34,6 +37,9 @@ export class StartNextPendingJobExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTJobsDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-jobs-data-plane/commands/UpdateJobExecutionCommand.ts b/clients/client-iot-jobs-data-plane/commands/UpdateJobExecutionCommand.ts index e3b431c70d619..81eb059540ae1 100644 --- a/clients/client-iot-jobs-data-plane/commands/UpdateJobExecutionCommand.ts +++ b/clients/client-iot-jobs-data-plane/commands/UpdateJobExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateJobExecutionCommandInput = UpdateJobExecutionRequest; export type UpdateJobExecutionCommandOutput = UpdateJobExecutionResponse & __MetadataBearer; +/** + *

Updates the status of a job execution.

+ */ export class UpdateJobExecutionCommand extends $Command< UpdateJobExecutionCommandInput, UpdateJobExecutionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateJobExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTJobsDataPlaneClientResolvedConfig, diff --git a/clients/client-iot-jobs-data-plane/package.json b/clients/client-iot-jobs-data-plane/package.json index 2c543ba2c3aa0..aedf0b9cdab33 100644 --- a/clients/client-iot-jobs-data-plane/package.json +++ b/clients/client-iot-jobs-data-plane/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iot Jobs Data Plane Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iot-jobs-data-plane/runtimeConfig.browser.ts b/clients/client-iot-jobs-data-plane/runtimeConfig.browser.ts index 979d3b794658d..07c150111dc97 100644 --- a/clients/client-iot-jobs-data-plane/runtimeConfig.browser.ts +++ b/clients/client-iot-jobs-data-plane/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTJobsDataPlaneClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iot-jobs-data-plane/runtimeConfig.native.ts b/clients/client-iot-jobs-data-plane/runtimeConfig.native.ts index 2dd80f26e6f46..923cfbf906623 100644 --- a/clients/client-iot-jobs-data-plane/runtimeConfig.native.ts +++ b/clients/client-iot-jobs-data-plane/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTJobsDataPlaneClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iot-jobs-data-plane/runtimeConfig.shared.ts b/clients/client-iot-jobs-data-plane/runtimeConfig.shared.ts index 39d66020af5e4..313d0c5aa1304 100644 --- a/clients/client-iot-jobs-data-plane/runtimeConfig.shared.ts +++ b/clients/client-iot-jobs-data-plane/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-09-29", disableHostPrefix: false, diff --git a/clients/client-iot-jobs-data-plane/runtimeConfig.ts b/clients/client-iot-jobs-data-plane/runtimeConfig.ts index b04a075950214..a9963712a96f2 100644 --- a/clients/client-iot-jobs-data-plane/runtimeConfig.ts +++ b/clients/client-iot-jobs-data-plane/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTJobsDataPlaneClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iot-jobs-data-plane/tsconfig.json b/clients/client-iot-jobs-data-plane/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iot-jobs-data-plane/tsconfig.json +++ b/clients/client-iot-jobs-data-plane/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iot/commands/AcceptCertificateTransferCommand.ts b/clients/client-iot/commands/AcceptCertificateTransferCommand.ts index e2fb5de13af27..669f56b5610ed 100644 --- a/clients/client-iot/commands/AcceptCertificateTransferCommand.ts +++ b/clients/client-iot/commands/AcceptCertificateTransferCommand.ts @@ -20,6 +20,12 @@ import { export type AcceptCertificateTransferCommandInput = AcceptCertificateTransferRequest; export type AcceptCertificateTransferCommandOutput = __MetadataBearer; +/** + *

Accepts a pending certificate transfer. The default state of the certificate is + * INACTIVE.

+ *

To check for pending certificate transfers, call ListCertificates + * to enumerate your certificates.

+ */ export class AcceptCertificateTransferCommand extends $Command< AcceptCertificateTransferCommandInput, AcceptCertificateTransferCommandOutput, @@ -34,6 +40,9 @@ export class AcceptCertificateTransferCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/AddThingToBillingGroupCommand.ts b/clients/client-iot/commands/AddThingToBillingGroupCommand.ts index b0e065e0111dc..38c6f5acefed8 100644 --- a/clients/client-iot/commands/AddThingToBillingGroupCommand.ts +++ b/clients/client-iot/commands/AddThingToBillingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type AddThingToBillingGroupCommandInput = AddThingToBillingGroupRequest; export type AddThingToBillingGroupCommandOutput = AddThingToBillingGroupResponse & __MetadataBearer; +/** + *

Adds a thing to a billing group.

+ */ export class AddThingToBillingGroupCommand extends $Command< AddThingToBillingGroupCommandInput, AddThingToBillingGroupCommandOutput, @@ -34,6 +37,9 @@ export class AddThingToBillingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/AddThingToThingGroupCommand.ts b/clients/client-iot/commands/AddThingToThingGroupCommand.ts index 1f0dd68755373..c7943432027c0 100644 --- a/clients/client-iot/commands/AddThingToThingGroupCommand.ts +++ b/clients/client-iot/commands/AddThingToThingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type AddThingToThingGroupCommandInput = AddThingToThingGroupRequest; export type AddThingToThingGroupCommandOutput = AddThingToThingGroupResponse & __MetadataBearer; +/** + *

Adds a thing to a thing group.

+ */ export class AddThingToThingGroupCommand extends $Command< AddThingToThingGroupCommandInput, AddThingToThingGroupCommandOutput, @@ -34,6 +37,9 @@ export class AddThingToThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/AssociateTargetsWithJobCommand.ts b/clients/client-iot/commands/AssociateTargetsWithJobCommand.ts index 0a6e40f61d520..2032f4558c896 100644 --- a/clients/client-iot/commands/AssociateTargetsWithJobCommand.ts +++ b/clients/client-iot/commands/AssociateTargetsWithJobCommand.ts @@ -20,6 +20,21 @@ import { export type AssociateTargetsWithJobCommandInput = AssociateTargetsWithJobRequest; export type AssociateTargetsWithJobCommandOutput = AssociateTargetsWithJobResponse & __MetadataBearer; +/** + *

Associates a group with a continuous job. The following criteria must be met:

+ *
    + *
  • + *

    The job must have been created with the targetSelection field set to + * "CONTINUOUS".

    + *
  • + *
  • + *

    The job status must currently be "IN_PROGRESS".

    + *
  • + *
  • + *

    The total number of targets associated with a job must not exceed 100.

    + *
  • + *
+ */ export class AssociateTargetsWithJobCommand extends $Command< AssociateTargetsWithJobCommandInput, AssociateTargetsWithJobCommandOutput, @@ -34,6 +49,9 @@ export class AssociateTargetsWithJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/AttachPolicyCommand.ts b/clients/client-iot/commands/AttachPolicyCommand.ts index e57f7d423c15a..2d8decc90cc05 100644 --- a/clients/client-iot/commands/AttachPolicyCommand.ts +++ b/clients/client-iot/commands/AttachPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type AttachPolicyCommandInput = AttachPolicyRequest; export type AttachPolicyCommandOutput = __MetadataBearer; +/** + *

Attaches a policy to the specified target.

+ */ export class AttachPolicyCommand extends $Command< AttachPolicyCommandInput, AttachPolicyCommandOutput, @@ -34,6 +37,9 @@ export class AttachPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/AttachPrincipalPolicyCommand.ts b/clients/client-iot/commands/AttachPrincipalPolicyCommand.ts index 1ed250527e8e0..3e06680e39ede 100644 --- a/clients/client-iot/commands/AttachPrincipalPolicyCommand.ts +++ b/clients/client-iot/commands/AttachPrincipalPolicyCommand.ts @@ -20,6 +20,12 @@ import { export type AttachPrincipalPolicyCommandInput = AttachPrincipalPolicyRequest; export type AttachPrincipalPolicyCommandOutput = __MetadataBearer; +/** + *

Attaches the specified policy to the specified principal (certificate or other + * credential).

+ *

+ * Note: This API is deprecated. Please use AttachPolicy instead.

+ */ export class AttachPrincipalPolicyCommand extends $Command< AttachPrincipalPolicyCommandInput, AttachPrincipalPolicyCommandOutput, @@ -34,6 +40,9 @@ export class AttachPrincipalPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/AttachSecurityProfileCommand.ts b/clients/client-iot/commands/AttachSecurityProfileCommand.ts index 6430c03998fed..30542df81d74c 100644 --- a/clients/client-iot/commands/AttachSecurityProfileCommand.ts +++ b/clients/client-iot/commands/AttachSecurityProfileCommand.ts @@ -20,6 +20,10 @@ import { export type AttachSecurityProfileCommandInput = AttachSecurityProfileRequest; export type AttachSecurityProfileCommandOutput = AttachSecurityProfileResponse & __MetadataBearer; +/** + *

Associates a Device Defender security profile with a thing group or this account. Each + * thing group or account can have up to five security profiles associated with it.

+ */ export class AttachSecurityProfileCommand extends $Command< AttachSecurityProfileCommandInput, AttachSecurityProfileCommandOutput, @@ -34,6 +38,9 @@ export class AttachSecurityProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/AttachThingPrincipalCommand.ts b/clients/client-iot/commands/AttachThingPrincipalCommand.ts index 223e241e2a35c..c034bbe05739b 100644 --- a/clients/client-iot/commands/AttachThingPrincipalCommand.ts +++ b/clients/client-iot/commands/AttachThingPrincipalCommand.ts @@ -20,6 +20,11 @@ import { export type AttachThingPrincipalCommandInput = AttachThingPrincipalRequest; export type AttachThingPrincipalCommandOutput = AttachThingPrincipalResponse & __MetadataBearer; +/** + *

Attaches the specified principal to the specified thing. A principal can be X.509 + * certificates, IAM users, groups, and roles, Amazon Cognito identities or federated + * identities.

+ */ export class AttachThingPrincipalCommand extends $Command< AttachThingPrincipalCommandInput, AttachThingPrincipalCommandOutput, @@ -34,6 +39,9 @@ export class AttachThingPrincipalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CancelAuditMitigationActionsTaskCommand.ts b/clients/client-iot/commands/CancelAuditMitigationActionsTaskCommand.ts index 39fa5ada1b8ae..4891445c6e257 100644 --- a/clients/client-iot/commands/CancelAuditMitigationActionsTaskCommand.ts +++ b/clients/client-iot/commands/CancelAuditMitigationActionsTaskCommand.ts @@ -20,6 +20,9 @@ import { export type CancelAuditMitigationActionsTaskCommandInput = CancelAuditMitigationActionsTaskRequest; export type CancelAuditMitigationActionsTaskCommandOutput = CancelAuditMitigationActionsTaskResponse & __MetadataBearer; +/** + *

Cancels a mitigation action task that is in progress. If the task is not in progress, an InvalidRequestException occurs.

+ */ export class CancelAuditMitigationActionsTaskCommand extends $Command< CancelAuditMitigationActionsTaskCommandInput, CancelAuditMitigationActionsTaskCommandOutput, @@ -34,6 +37,9 @@ export class CancelAuditMitigationActionsTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CancelAuditTaskCommand.ts b/clients/client-iot/commands/CancelAuditTaskCommand.ts index 63bb35c1a6a1a..7177db0c0c334 100644 --- a/clients/client-iot/commands/CancelAuditTaskCommand.ts +++ b/clients/client-iot/commands/CancelAuditTaskCommand.ts @@ -20,6 +20,10 @@ import { export type CancelAuditTaskCommandInput = CancelAuditTaskRequest; export type CancelAuditTaskCommandOutput = CancelAuditTaskResponse & __MetadataBearer; +/** + *

Cancels an audit that is in progress. The audit can be either scheduled or on-demand. + * If the audit is not in progress, an "InvalidRequestException" occurs.

+ */ export class CancelAuditTaskCommand extends $Command< CancelAuditTaskCommandInput, CancelAuditTaskCommandOutput, @@ -34,6 +38,9 @@ export class CancelAuditTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CancelCertificateTransferCommand.ts b/clients/client-iot/commands/CancelCertificateTransferCommand.ts index 28b388596f0ea..8daaed4352bb0 100644 --- a/clients/client-iot/commands/CancelCertificateTransferCommand.ts +++ b/clients/client-iot/commands/CancelCertificateTransferCommand.ts @@ -20,6 +20,16 @@ import { export type CancelCertificateTransferCommandInput = CancelCertificateTransferRequest; export type CancelCertificateTransferCommandOutput = __MetadataBearer; +/** + *

Cancels a pending transfer for the specified certificate.

+ *

+ * Note Only the transfer source account can use this + * operation to cancel a transfer. (Transfer destinations can use RejectCertificateTransfer instead.) After transfer, AWS IoT returns the + * certificate to the source account in the INACTIVE state. After the destination account has + * accepted the transfer, the transfer cannot be cancelled.

+ *

After a certificate transfer is cancelled, the status of the certificate changes from + * PENDING_TRANSFER to INACTIVE.

+ */ export class CancelCertificateTransferCommand extends $Command< CancelCertificateTransferCommandInput, CancelCertificateTransferCommandOutput, @@ -34,6 +44,9 @@ export class CancelCertificateTransferCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CancelJobCommand.ts b/clients/client-iot/commands/CancelJobCommand.ts index 44eb90de881e7..a4d9e3d27709c 100644 --- a/clients/client-iot/commands/CancelJobCommand.ts +++ b/clients/client-iot/commands/CancelJobCommand.ts @@ -20,6 +20,9 @@ import { export type CancelJobCommandInput = CancelJobRequest; export type CancelJobCommandOutput = CancelJobResponse & __MetadataBearer; +/** + *

Cancels a job.

+ */ export class CancelJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class CancelJobCommand extends $Command, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CancelJobExecutionCommand.ts b/clients/client-iot/commands/CancelJobExecutionCommand.ts index 850a77f2f4e12..b5c9545b0d715 100644 --- a/clients/client-iot/commands/CancelJobExecutionCommand.ts +++ b/clients/client-iot/commands/CancelJobExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type CancelJobExecutionCommandInput = CancelJobExecutionRequest; export type CancelJobExecutionCommandOutput = __MetadataBearer; +/** + *

Cancels the execution of a job for a given thing.

+ */ export class CancelJobExecutionCommand extends $Command< CancelJobExecutionCommandInput, CancelJobExecutionCommandOutput, @@ -34,6 +37,9 @@ export class CancelJobExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ClearDefaultAuthorizerCommand.ts b/clients/client-iot/commands/ClearDefaultAuthorizerCommand.ts index e694b98a9543d..b82875a914743 100644 --- a/clients/client-iot/commands/ClearDefaultAuthorizerCommand.ts +++ b/clients/client-iot/commands/ClearDefaultAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type ClearDefaultAuthorizerCommandInput = ClearDefaultAuthorizerRequest; export type ClearDefaultAuthorizerCommandOutput = ClearDefaultAuthorizerResponse & __MetadataBearer; +/** + *

Clears the default authorizer.

+ */ export class ClearDefaultAuthorizerCommand extends $Command< ClearDefaultAuthorizerCommandInput, ClearDefaultAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class ClearDefaultAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ConfirmTopicRuleDestinationCommand.ts b/clients/client-iot/commands/ConfirmTopicRuleDestinationCommand.ts index 4da3444ff45a3..bcd1508c500d4 100644 --- a/clients/client-iot/commands/ConfirmTopicRuleDestinationCommand.ts +++ b/clients/client-iot/commands/ConfirmTopicRuleDestinationCommand.ts @@ -20,6 +20,12 @@ import { export type ConfirmTopicRuleDestinationCommandInput = ConfirmTopicRuleDestinationRequest; export type ConfirmTopicRuleDestinationCommandOutput = ConfirmTopicRuleDestinationResponse & __MetadataBearer; +/** + *

Confirms a topic rule destination. When you create a rule requiring a destination, AWS + * IoT sends a confirmation message to the endpoint or base address you specify. The message + * includes a token which you pass back when calling ConfirmTopicRuleDestination + * to confirm that you own or have access to the endpoint.

+ */ export class ConfirmTopicRuleDestinationCommand extends $Command< ConfirmTopicRuleDestinationCommandInput, ConfirmTopicRuleDestinationCommandOutput, @@ -34,6 +40,9 @@ export class ConfirmTopicRuleDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateAuditSuppressionCommand.ts b/clients/client-iot/commands/CreateAuditSuppressionCommand.ts index 188d2cfae793f..ec1985c5e9eeb 100644 --- a/clients/client-iot/commands/CreateAuditSuppressionCommand.ts +++ b/clients/client-iot/commands/CreateAuditSuppressionCommand.ts @@ -20,6 +20,11 @@ import { export type CreateAuditSuppressionCommandInput = CreateAuditSuppressionRequest; export type CreateAuditSuppressionCommandOutput = CreateAuditSuppressionResponse & __MetadataBearer; +/** + *

+ * Creates a Device Defender audit suppression. + *

+ */ export class CreateAuditSuppressionCommand extends $Command< CreateAuditSuppressionCommandInput, CreateAuditSuppressionCommandOutput, @@ -34,6 +39,9 @@ export class CreateAuditSuppressionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateAuthorizerCommand.ts b/clients/client-iot/commands/CreateAuthorizerCommand.ts index 770929f16576a..cd18451b3eed1 100644 --- a/clients/client-iot/commands/CreateAuthorizerCommand.ts +++ b/clients/client-iot/commands/CreateAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAuthorizerCommandInput = CreateAuthorizerRequest; export type CreateAuthorizerCommandOutput = CreateAuthorizerResponse & __MetadataBearer; +/** + *

Creates an authorizer.

+ */ export class CreateAuthorizerCommand extends $Command< CreateAuthorizerCommandInput, CreateAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class CreateAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateBillingGroupCommand.ts b/clients/client-iot/commands/CreateBillingGroupCommand.ts index 1eefb2914aa30..eb18217c5d50a 100644 --- a/clients/client-iot/commands/CreateBillingGroupCommand.ts +++ b/clients/client-iot/commands/CreateBillingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateBillingGroupCommandInput = CreateBillingGroupRequest; export type CreateBillingGroupCommandOutput = CreateBillingGroupResponse & __MetadataBearer; +/** + *

Creates a billing group.

+ */ export class CreateBillingGroupCommand extends $Command< CreateBillingGroupCommandInput, CreateBillingGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateBillingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateCertificateFromCsrCommand.ts b/clients/client-iot/commands/CreateCertificateFromCsrCommand.ts index b30e6acc75dc1..a82c409a9332c 100644 --- a/clients/client-iot/commands/CreateCertificateFromCsrCommand.ts +++ b/clients/client-iot/commands/CreateCertificateFromCsrCommand.ts @@ -20,6 +20,43 @@ import { export type CreateCertificateFromCsrCommandInput = CreateCertificateFromCsrRequest; export type CreateCertificateFromCsrCommandOutput = CreateCertificateFromCsrResponse & __MetadataBearer; +/** + *

Creates an X.509 certificate using the specified certificate signing + * request.

+ *

+ * Note: The CSR must include a public key that is either an + * RSA key with a length of at least 2048 bits or an ECC key from NIST P-256 or NIST P-384 + * curves.

+ *

+ * Note: Reusing the same certificate signing request (CSR) + * results in a distinct certificate.

+ *

You can create multiple certificates in a batch by creating a directory, copying + * multiple .csr files into that directory, and then specifying that directory on the command + * line. The following commands show how to create a batch of certificates given a batch of + * CSRs.

+ *

Assuming a set of CSRs are located inside of the directory + * my-csr-directory:

+ * + *

On Linux and OS X, the command is:

+ * + *

$ ls my-csr-directory/ | xargs -I {} aws iot create-certificate-from-csr + * --certificate-signing-request file://my-csr-directory/{}

+ *

This command lists all of the CSRs in my-csr-directory and pipes each CSR file name + * to the aws iot create-certificate-from-csr AWS CLI command to create a certificate for the + * corresponding CSR.

+ *

The aws iot create-certificate-from-csr part of the command can also be run in + * parallel to speed up the certificate creation process:

+ *

$ ls my-csr-directory/ | xargs -P 10 -I {} aws iot create-certificate-from-csr + * --certificate-signing-request file://my-csr-directory/{}

+ *

On Windows PowerShell, the command to create certificates for all CSRs in + * my-csr-directory is:

+ *

> ls -Name my-csr-directory | %{aws iot create-certificate-from-csr + * --certificate-signing-request file://my-csr-directory/$_}

+ *

On a Windows command prompt, the command to create certificates for all CSRs in + * my-csr-directory is:

+ *

> forfiles /p my-csr-directory /c "cmd /c aws iot create-certificate-from-csr + * --certificate-signing-request file://@path"

+ */ export class CreateCertificateFromCsrCommand extends $Command< CreateCertificateFromCsrCommandInput, CreateCertificateFromCsrCommandOutput, @@ -34,6 +71,9 @@ export class CreateCertificateFromCsrCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateDimensionCommand.ts b/clients/client-iot/commands/CreateDimensionCommand.ts index b41870a769acc..de0b2c21c39dc 100644 --- a/clients/client-iot/commands/CreateDimensionCommand.ts +++ b/clients/client-iot/commands/CreateDimensionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDimensionCommandInput = CreateDimensionRequest; export type CreateDimensionCommandOutput = CreateDimensionResponse & __MetadataBearer; +/** + *

Create a dimension that you can use to limit the scope of a metric used in a security profile for AWS IoT Device Defender. For example, using a TOPIC_FILTER dimension, you can narrow down the scope of the metric only to MQTT topics whose name match the pattern specified in the dimension.

+ */ export class CreateDimensionCommand extends $Command< CreateDimensionCommandInput, CreateDimensionCommandOutput, @@ -34,6 +37,9 @@ export class CreateDimensionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateDomainConfigurationCommand.ts b/clients/client-iot/commands/CreateDomainConfigurationCommand.ts index d00e0b6c44bf5..03aebba39c57d 100644 --- a/clients/client-iot/commands/CreateDomainConfigurationCommand.ts +++ b/clients/client-iot/commands/CreateDomainConfigurationCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDomainConfigurationCommandInput = CreateDomainConfigurationRequest; export type CreateDomainConfigurationCommandOutput = CreateDomainConfigurationResponse & __MetadataBearer; +/** + *

Creates a domain configuration.

+ * + *

The domain configuration feature is in public preview and is subject to change.

+ *
+ */ export class CreateDomainConfigurationCommand extends $Command< CreateDomainConfigurationCommandInput, CreateDomainConfigurationCommandOutput, @@ -34,6 +40,9 @@ export class CreateDomainConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateDynamicThingGroupCommand.ts b/clients/client-iot/commands/CreateDynamicThingGroupCommand.ts index 8eb87f2906b98..59a7cb3a7e714 100644 --- a/clients/client-iot/commands/CreateDynamicThingGroupCommand.ts +++ b/clients/client-iot/commands/CreateDynamicThingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDynamicThingGroupCommandInput = CreateDynamicThingGroupRequest; export type CreateDynamicThingGroupCommandOutput = CreateDynamicThingGroupResponse & __MetadataBearer; +/** + *

Creates a dynamic thing group.

+ */ export class CreateDynamicThingGroupCommand extends $Command< CreateDynamicThingGroupCommandInput, CreateDynamicThingGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateDynamicThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateJobCommand.ts b/clients/client-iot/commands/CreateJobCommand.ts index 524843ea99b5d..a8098346d1468 100644 --- a/clients/client-iot/commands/CreateJobCommand.ts +++ b/clients/client-iot/commands/CreateJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateJobCommandInput = CreateJobRequest; export type CreateJobCommandOutput = CreateJobResponse & __MetadataBearer; +/** + *

Creates a job.

+ */ export class CreateJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class CreateJobCommand extends $Command, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateKeysAndCertificateCommand.ts b/clients/client-iot/commands/CreateKeysAndCertificateCommand.ts index bec41d7bc8ace..9052bc44768ee 100644 --- a/clients/client-iot/commands/CreateKeysAndCertificateCommand.ts +++ b/clients/client-iot/commands/CreateKeysAndCertificateCommand.ts @@ -20,6 +20,14 @@ import { export type CreateKeysAndCertificateCommandInput = CreateKeysAndCertificateRequest; export type CreateKeysAndCertificateCommandOutput = CreateKeysAndCertificateResponse & __MetadataBearer; +/** + *

Creates a 2048-bit RSA key pair and issues an X.509 certificate using the issued + * public key. You can also call CreateKeysAndCertificate over MQTT from a + * device, for more information, see Provisioning MQTT API.

+ *

+ * Note This is the only time AWS IoT issues the private key + * for this certificate, so it is important to keep it in a secure location.

+ */ export class CreateKeysAndCertificateCommand extends $Command< CreateKeysAndCertificateCommandInput, CreateKeysAndCertificateCommandOutput, @@ -34,6 +42,9 @@ export class CreateKeysAndCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateMitigationActionCommand.ts b/clients/client-iot/commands/CreateMitigationActionCommand.ts index 406811939c2d0..c578e6a2c3c56 100644 --- a/clients/client-iot/commands/CreateMitigationActionCommand.ts +++ b/clients/client-iot/commands/CreateMitigationActionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateMitigationActionCommandInput = CreateMitigationActionRequest; export type CreateMitigationActionCommandOutput = CreateMitigationActionResponse & __MetadataBearer; +/** + *

Defines an action that can be applied to audit findings by using StartAuditMitigationActionsTask. Only certain types of mitigation actions can be applied to specific check names. For more information, see Mitigation actions. Each mitigation action can apply only one type of change.

+ */ export class CreateMitigationActionCommand extends $Command< CreateMitigationActionCommandInput, CreateMitigationActionCommandOutput, @@ -34,6 +37,9 @@ export class CreateMitigationActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateOTAUpdateCommand.ts b/clients/client-iot/commands/CreateOTAUpdateCommand.ts index 24756a7338e47..2f85617bc9119 100644 --- a/clients/client-iot/commands/CreateOTAUpdateCommand.ts +++ b/clients/client-iot/commands/CreateOTAUpdateCommand.ts @@ -20,6 +20,9 @@ import { export type CreateOTAUpdateCommandInput = CreateOTAUpdateRequest; export type CreateOTAUpdateCommandOutput = CreateOTAUpdateResponse & __MetadataBearer; +/** + *

Creates an AWS IoT OTAUpdate on a target group of things or groups.

+ */ export class CreateOTAUpdateCommand extends $Command< CreateOTAUpdateCommandInput, CreateOTAUpdateCommandOutput, @@ -34,6 +37,9 @@ export class CreateOTAUpdateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreatePolicyCommand.ts b/clients/client-iot/commands/CreatePolicyCommand.ts index 80e99b040ec85..0c3e918221620 100644 --- a/clients/client-iot/commands/CreatePolicyCommand.ts +++ b/clients/client-iot/commands/CreatePolicyCommand.ts @@ -20,6 +20,12 @@ import { export type CreatePolicyCommandInput = CreatePolicyRequest; export type CreatePolicyCommandOutput = CreatePolicyResponse & __MetadataBearer; +/** + *

Creates an AWS IoT policy.

+ *

The created policy is the default version for the policy. This operation creates a + * policy version with a version identifier of 1 and sets + * 1 as the policy's default version.

+ */ export class CreatePolicyCommand extends $Command< CreatePolicyCommandInput, CreatePolicyCommandOutput, @@ -34,6 +40,9 @@ export class CreatePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreatePolicyVersionCommand.ts b/clients/client-iot/commands/CreatePolicyVersionCommand.ts index 9178948b6e680..72dbd3b1f74e7 100644 --- a/clients/client-iot/commands/CreatePolicyVersionCommand.ts +++ b/clients/client-iot/commands/CreatePolicyVersionCommand.ts @@ -20,6 +20,15 @@ import { export type CreatePolicyVersionCommandInput = CreatePolicyVersionRequest; export type CreatePolicyVersionCommandOutput = CreatePolicyVersionResponse & __MetadataBearer; +/** + *

Creates a new version of the specified AWS IoT policy. To update a policy, create a + * new policy version. A managed policy can have up to five versions. If the policy has five + * versions, you must use DeletePolicyVersion to delete an existing version + * before you create a new one.

+ *

Optionally, you can set the new version as the policy's default version. The default + * version is the operative version (that is, the version that is in effect for the + * certificates to which the policy is attached).

+ */ export class CreatePolicyVersionCommand extends $Command< CreatePolicyVersionCommandInput, CreatePolicyVersionCommandOutput, @@ -34,6 +43,9 @@ export class CreatePolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateProvisioningClaimCommand.ts b/clients/client-iot/commands/CreateProvisioningClaimCommand.ts index 6e1fb75716ea3..268629ed5b664 100644 --- a/clients/client-iot/commands/CreateProvisioningClaimCommand.ts +++ b/clients/client-iot/commands/CreateProvisioningClaimCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProvisioningClaimCommandInput = CreateProvisioningClaimRequest; export type CreateProvisioningClaimCommandOutput = CreateProvisioningClaimResponse & __MetadataBearer; +/** + *

Creates a provisioning claim.

+ */ export class CreateProvisioningClaimCommand extends $Command< CreateProvisioningClaimCommandInput, CreateProvisioningClaimCommandOutput, @@ -34,6 +37,9 @@ export class CreateProvisioningClaimCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateProvisioningTemplateCommand.ts b/clients/client-iot/commands/CreateProvisioningTemplateCommand.ts index 5325eb860ef50..13c28546d282d 100644 --- a/clients/client-iot/commands/CreateProvisioningTemplateCommand.ts +++ b/clients/client-iot/commands/CreateProvisioningTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProvisioningTemplateCommandInput = CreateProvisioningTemplateRequest; export type CreateProvisioningTemplateCommandOutput = CreateProvisioningTemplateResponse & __MetadataBearer; +/** + *

Creates a fleet provisioning template.

+ */ export class CreateProvisioningTemplateCommand extends $Command< CreateProvisioningTemplateCommandInput, CreateProvisioningTemplateCommandOutput, @@ -34,6 +37,9 @@ export class CreateProvisioningTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateProvisioningTemplateVersionCommand.ts b/clients/client-iot/commands/CreateProvisioningTemplateVersionCommand.ts index 537868d0e0466..2551768468fb0 100644 --- a/clients/client-iot/commands/CreateProvisioningTemplateVersionCommand.ts +++ b/clients/client-iot/commands/CreateProvisioningTemplateVersionCommand.ts @@ -24,6 +24,9 @@ export type CreateProvisioningTemplateVersionCommandInput = CreateProvisioningTe export type CreateProvisioningTemplateVersionCommandOutput = CreateProvisioningTemplateVersionResponse & __MetadataBearer; +/** + *

Creates a new version of a fleet provisioning template.

+ */ export class CreateProvisioningTemplateVersionCommand extends $Command< CreateProvisioningTemplateVersionCommandInput, CreateProvisioningTemplateVersionCommandOutput, @@ -38,6 +41,9 @@ export class CreateProvisioningTemplateVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateRoleAliasCommand.ts b/clients/client-iot/commands/CreateRoleAliasCommand.ts index c24572a10680a..1546e625ad6d5 100644 --- a/clients/client-iot/commands/CreateRoleAliasCommand.ts +++ b/clients/client-iot/commands/CreateRoleAliasCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRoleAliasCommandInput = CreateRoleAliasRequest; export type CreateRoleAliasCommandOutput = CreateRoleAliasResponse & __MetadataBearer; +/** + *

Creates a role alias.

+ */ export class CreateRoleAliasCommand extends $Command< CreateRoleAliasCommandInput, CreateRoleAliasCommandOutput, @@ -34,6 +37,9 @@ export class CreateRoleAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateScheduledAuditCommand.ts b/clients/client-iot/commands/CreateScheduledAuditCommand.ts index ac5f220fe2823..83a49ded187a5 100644 --- a/clients/client-iot/commands/CreateScheduledAuditCommand.ts +++ b/clients/client-iot/commands/CreateScheduledAuditCommand.ts @@ -20,6 +20,10 @@ import { export type CreateScheduledAuditCommandInput = CreateScheduledAuditRequest; export type CreateScheduledAuditCommandOutput = CreateScheduledAuditResponse & __MetadataBearer; +/** + *

Creates a scheduled audit that is run at a specified + * time interval.

+ */ export class CreateScheduledAuditCommand extends $Command< CreateScheduledAuditCommandInput, CreateScheduledAuditCommandOutput, @@ -34,6 +38,9 @@ export class CreateScheduledAuditCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateSecurityProfileCommand.ts b/clients/client-iot/commands/CreateSecurityProfileCommand.ts index 73180e81a2032..f27056ac461ad 100644 --- a/clients/client-iot/commands/CreateSecurityProfileCommand.ts +++ b/clients/client-iot/commands/CreateSecurityProfileCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSecurityProfileCommandInput = CreateSecurityProfileRequest; export type CreateSecurityProfileCommandOutput = CreateSecurityProfileResponse & __MetadataBearer; +/** + *

Creates a Device Defender security profile.

+ */ export class CreateSecurityProfileCommand extends $Command< CreateSecurityProfileCommandInput, CreateSecurityProfileCommandOutput, @@ -34,6 +37,9 @@ export class CreateSecurityProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateStreamCommand.ts b/clients/client-iot/commands/CreateStreamCommand.ts index f170d8b7cac3f..281cf48693b63 100644 --- a/clients/client-iot/commands/CreateStreamCommand.ts +++ b/clients/client-iot/commands/CreateStreamCommand.ts @@ -20,6 +20,11 @@ import { export type CreateStreamCommandInput = CreateStreamRequest; export type CreateStreamCommandOutput = CreateStreamResponse & __MetadataBearer; +/** + *

Creates a stream for delivering one or more large files in chunks over MQTT. A stream transports data + * bytes in chunks or blocks packaged as MQTT messages from a source like S3. You can have one or more files + * associated with a stream.

+ */ export class CreateStreamCommand extends $Command< CreateStreamCommandInput, CreateStreamCommandOutput, @@ -34,6 +39,9 @@ export class CreateStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateThingCommand.ts b/clients/client-iot/commands/CreateThingCommand.ts index e0eab3c235187..2119e6d91e64c 100644 --- a/clients/client-iot/commands/CreateThingCommand.ts +++ b/clients/client-iot/commands/CreateThingCommand.ts @@ -20,6 +20,16 @@ import { export type CreateThingCommandInput = CreateThingRequest; export type CreateThingCommandOutput = CreateThingResponse & __MetadataBearer; +/** + *

Creates a thing record in the registry. If this call is made multiple times using + * the same thing name and configuration, the call will succeed. If this call is made with + * the same thing name but different configuration a + * ResourceAlreadyExistsException is thrown.

+ * + *

This is a control plane operation. See Authorization for + * information about authorizing control plane actions.

+ *
+ */ export class CreateThingCommand extends $Command< CreateThingCommandInput, CreateThingCommandOutput, @@ -34,6 +44,9 @@ export class CreateThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateThingGroupCommand.ts b/clients/client-iot/commands/CreateThingGroupCommand.ts index bd7b5d6828006..843e138d3c43a 100644 --- a/clients/client-iot/commands/CreateThingGroupCommand.ts +++ b/clients/client-iot/commands/CreateThingGroupCommand.ts @@ -20,6 +20,13 @@ import { export type CreateThingGroupCommandInput = CreateThingGroupRequest; export type CreateThingGroupCommandOutput = CreateThingGroupResponse & __MetadataBearer; +/** + *

Create a thing group.

+ * + *

This is a control plane operation. See Authorization for + * information about authorizing control plane actions.

+ *
+ */ export class CreateThingGroupCommand extends $Command< CreateThingGroupCommandInput, CreateThingGroupCommandOutput, @@ -34,6 +41,9 @@ export class CreateThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateThingTypeCommand.ts b/clients/client-iot/commands/CreateThingTypeCommand.ts index 8405bb455c5bd..795fcfdd45b87 100644 --- a/clients/client-iot/commands/CreateThingTypeCommand.ts +++ b/clients/client-iot/commands/CreateThingTypeCommand.ts @@ -20,6 +20,9 @@ import { export type CreateThingTypeCommandInput = CreateThingTypeRequest; export type CreateThingTypeCommandOutput = CreateThingTypeResponse & __MetadataBearer; +/** + *

Creates a new thing type.

+ */ export class CreateThingTypeCommand extends $Command< CreateThingTypeCommandInput, CreateThingTypeCommandOutput, @@ -34,6 +37,9 @@ export class CreateThingTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateTopicRuleCommand.ts b/clients/client-iot/commands/CreateTopicRuleCommand.ts index ba533208a8341..9003b72f30852 100644 --- a/clients/client-iot/commands/CreateTopicRuleCommand.ts +++ b/clients/client-iot/commands/CreateTopicRuleCommand.ts @@ -20,6 +20,10 @@ import { export type CreateTopicRuleCommandInput = CreateTopicRuleRequest; export type CreateTopicRuleCommandOutput = __MetadataBearer; +/** + *

Creates a rule. Creating rules is an administrator-level action. Any user who has + * permission to create rules will be able to access data processed by the rule.

+ */ export class CreateTopicRuleCommand extends $Command< CreateTopicRuleCommandInput, CreateTopicRuleCommandOutput, @@ -34,6 +38,9 @@ export class CreateTopicRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/CreateTopicRuleDestinationCommand.ts b/clients/client-iot/commands/CreateTopicRuleDestinationCommand.ts index 5c7c633c69414..0de9683e55405 100644 --- a/clients/client-iot/commands/CreateTopicRuleDestinationCommand.ts +++ b/clients/client-iot/commands/CreateTopicRuleDestinationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTopicRuleDestinationCommandInput = CreateTopicRuleDestinationRequest; export type CreateTopicRuleDestinationCommandOutput = CreateTopicRuleDestinationResponse & __MetadataBearer; +/** + *

Creates a topic rule destination. The destination must be confirmed prior to use.

+ */ export class CreateTopicRuleDestinationCommand extends $Command< CreateTopicRuleDestinationCommandInput, CreateTopicRuleDestinationCommandOutput, @@ -34,6 +37,9 @@ export class CreateTopicRuleDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteAccountAuditConfigurationCommand.ts b/clients/client-iot/commands/DeleteAccountAuditConfigurationCommand.ts index c35086dffeb45..bcbeec81a7000 100644 --- a/clients/client-iot/commands/DeleteAccountAuditConfigurationCommand.ts +++ b/clients/client-iot/commands/DeleteAccountAuditConfigurationCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteAccountAuditConfigurationCommandInput = DeleteAccountAuditConfigurationRequest; export type DeleteAccountAuditConfigurationCommandOutput = DeleteAccountAuditConfigurationResponse & __MetadataBearer; +/** + *

Restores the default settings for Device Defender audits for this account. Any + * configuration data you entered is deleted and all audit checks are reset to + * disabled.

+ */ export class DeleteAccountAuditConfigurationCommand extends $Command< DeleteAccountAuditConfigurationCommandInput, DeleteAccountAuditConfigurationCommandOutput, @@ -34,6 +39,9 @@ export class DeleteAccountAuditConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteAuditSuppressionCommand.ts b/clients/client-iot/commands/DeleteAuditSuppressionCommand.ts index a005ff78fce2f..47ed9adf61292 100644 --- a/clients/client-iot/commands/DeleteAuditSuppressionCommand.ts +++ b/clients/client-iot/commands/DeleteAuditSuppressionCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteAuditSuppressionCommandInput = DeleteAuditSuppressionRequest; export type DeleteAuditSuppressionCommandOutput = DeleteAuditSuppressionResponse & __MetadataBearer; +/** + *

+ * Deletes a Device Defender audit suppression. + *

+ */ export class DeleteAuditSuppressionCommand extends $Command< DeleteAuditSuppressionCommandInput, DeleteAuditSuppressionCommandOutput, @@ -34,6 +39,9 @@ export class DeleteAuditSuppressionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteAuthorizerCommand.ts b/clients/client-iot/commands/DeleteAuthorizerCommand.ts index 33df4de23a2b6..c72766f555539 100644 --- a/clients/client-iot/commands/DeleteAuthorizerCommand.ts +++ b/clients/client-iot/commands/DeleteAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAuthorizerCommandInput = DeleteAuthorizerRequest; export type DeleteAuthorizerCommandOutput = DeleteAuthorizerResponse & __MetadataBearer; +/** + *

Deletes an authorizer.

+ */ export class DeleteAuthorizerCommand extends $Command< DeleteAuthorizerCommandInput, DeleteAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteBillingGroupCommand.ts b/clients/client-iot/commands/DeleteBillingGroupCommand.ts index 3498a10466970..d1de7648a6419 100644 --- a/clients/client-iot/commands/DeleteBillingGroupCommand.ts +++ b/clients/client-iot/commands/DeleteBillingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBillingGroupCommandInput = DeleteBillingGroupRequest; export type DeleteBillingGroupCommandOutput = DeleteBillingGroupResponse & __MetadataBearer; +/** + *

Deletes the billing group.

+ */ export class DeleteBillingGroupCommand extends $Command< DeleteBillingGroupCommandInput, DeleteBillingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBillingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteCACertificateCommand.ts b/clients/client-iot/commands/DeleteCACertificateCommand.ts index 18b7491bbe148..5e14cfec1ba6b 100644 --- a/clients/client-iot/commands/DeleteCACertificateCommand.ts +++ b/clients/client-iot/commands/DeleteCACertificateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCACertificateCommandInput = DeleteCACertificateRequest; export type DeleteCACertificateCommandOutput = DeleteCACertificateResponse & __MetadataBearer; +/** + *

Deletes a registered CA certificate.

+ */ export class DeleteCACertificateCommand extends $Command< DeleteCACertificateCommandInput, DeleteCACertificateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCACertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteCertificateCommand.ts b/clients/client-iot/commands/DeleteCertificateCommand.ts index f514908e14272..4a1f187525417 100644 --- a/clients/client-iot/commands/DeleteCertificateCommand.ts +++ b/clients/client-iot/commands/DeleteCertificateCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteCertificateCommandInput = DeleteCertificateRequest; export type DeleteCertificateCommandOutput = __MetadataBearer; +/** + *

Deletes the specified certificate.

+ *

A certificate cannot be deleted if it has a policy or IoT thing attached to it or if + * its status is set to ACTIVE. To delete a certificate, first use the DetachPrincipalPolicy API to detach all policies. Next, use the UpdateCertificate API to set the certificate to the INACTIVE + * status.

+ */ export class DeleteCertificateCommand extends $Command< DeleteCertificateCommandInput, DeleteCertificateCommandOutput, @@ -34,6 +40,9 @@ export class DeleteCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteDimensionCommand.ts b/clients/client-iot/commands/DeleteDimensionCommand.ts index 165d3482c40ce..f769767132f98 100644 --- a/clients/client-iot/commands/DeleteDimensionCommand.ts +++ b/clients/client-iot/commands/DeleteDimensionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDimensionCommandInput = DeleteDimensionRequest; export type DeleteDimensionCommandOutput = DeleteDimensionResponse & __MetadataBearer; +/** + *

Removes the specified dimension from your AWS account.

+ */ export class DeleteDimensionCommand extends $Command< DeleteDimensionCommandInput, DeleteDimensionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDimensionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteDomainConfigurationCommand.ts b/clients/client-iot/commands/DeleteDomainConfigurationCommand.ts index 7204537fbbca8..9fd3a215485b5 100644 --- a/clients/client-iot/commands/DeleteDomainConfigurationCommand.ts +++ b/clients/client-iot/commands/DeleteDomainConfigurationCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDomainConfigurationCommandInput = DeleteDomainConfigurationRequest; export type DeleteDomainConfigurationCommandOutput = DeleteDomainConfigurationResponse & __MetadataBearer; +/** + *

Deletes the specified domain configuration.

+ * + *

The domain configuration feature is in public preview and is subject to change.

+ *
+ */ export class DeleteDomainConfigurationCommand extends $Command< DeleteDomainConfigurationCommandInput, DeleteDomainConfigurationCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDomainConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteDynamicThingGroupCommand.ts b/clients/client-iot/commands/DeleteDynamicThingGroupCommand.ts index da3e7448966a2..0c6540e305c58 100644 --- a/clients/client-iot/commands/DeleteDynamicThingGroupCommand.ts +++ b/clients/client-iot/commands/DeleteDynamicThingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDynamicThingGroupCommandInput = DeleteDynamicThingGroupRequest; export type DeleteDynamicThingGroupCommandOutput = DeleteDynamicThingGroupResponse & __MetadataBearer; +/** + *

Deletes a dynamic thing group.

+ */ export class DeleteDynamicThingGroupCommand extends $Command< DeleteDynamicThingGroupCommandInput, DeleteDynamicThingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDynamicThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteJobCommand.ts b/clients/client-iot/commands/DeleteJobCommand.ts index a3244ace975ff..b8f4b475d6f5f 100644 --- a/clients/client-iot/commands/DeleteJobCommand.ts +++ b/clients/client-iot/commands/DeleteJobCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteJobCommandInput = DeleteJobRequest; export type DeleteJobCommandOutput = __MetadataBearer; +/** + *

Deletes a job and its related job executions.

+ *

Deleting a job may take time, depending on the number of job + * executions created for the job and various other factors. While the job + * is being deleted, the status of the job will be shown as + * "DELETION_IN_PROGRESS". Attempting to delete or cancel a job whose status + * is already "DELETION_IN_PROGRESS" will result in an error.

+ *

Only 10 jobs may have status "DELETION_IN_PROGRESS" at the same time, or + * a LimitExceededException will occur.

+ */ export class DeleteJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +40,9 @@ export class DeleteJobCommand extends $Command, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteJobExecutionCommand.ts b/clients/client-iot/commands/DeleteJobExecutionCommand.ts index 2101b21bd1a62..4e1d56535de69 100644 --- a/clients/client-iot/commands/DeleteJobExecutionCommand.ts +++ b/clients/client-iot/commands/DeleteJobExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteJobExecutionCommandInput = DeleteJobExecutionRequest; export type DeleteJobExecutionCommandOutput = __MetadataBearer; +/** + *

Deletes a job execution.

+ */ export class DeleteJobExecutionCommand extends $Command< DeleteJobExecutionCommandInput, DeleteJobExecutionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteJobExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteMitigationActionCommand.ts b/clients/client-iot/commands/DeleteMitigationActionCommand.ts index 62621152024be..671bd300ac114 100644 --- a/clients/client-iot/commands/DeleteMitigationActionCommand.ts +++ b/clients/client-iot/commands/DeleteMitigationActionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMitigationActionCommandInput = DeleteMitigationActionRequest; export type DeleteMitigationActionCommandOutput = DeleteMitigationActionResponse & __MetadataBearer; +/** + *

Deletes a defined mitigation action from your AWS account.

+ */ export class DeleteMitigationActionCommand extends $Command< DeleteMitigationActionCommandInput, DeleteMitigationActionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMitigationActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteOTAUpdateCommand.ts b/clients/client-iot/commands/DeleteOTAUpdateCommand.ts index 53315934f0d8b..6c1a7d67a1e16 100644 --- a/clients/client-iot/commands/DeleteOTAUpdateCommand.ts +++ b/clients/client-iot/commands/DeleteOTAUpdateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteOTAUpdateCommandInput = DeleteOTAUpdateRequest; export type DeleteOTAUpdateCommandOutput = DeleteOTAUpdateResponse & __MetadataBearer; +/** + *

Delete an OTA update.

+ */ export class DeleteOTAUpdateCommand extends $Command< DeleteOTAUpdateCommandInput, DeleteOTAUpdateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteOTAUpdateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeletePolicyCommand.ts b/clients/client-iot/commands/DeletePolicyCommand.ts index 92a5b0a5b48fb..6730aafd78805 100644 --- a/clients/client-iot/commands/DeletePolicyCommand.ts +++ b/clients/client-iot/commands/DeletePolicyCommand.ts @@ -20,6 +20,16 @@ import { export type DeletePolicyCommandInput = DeletePolicyRequest; export type DeletePolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified policy.

+ *

A policy cannot be deleted if it has non-default versions or it is attached to any + * certificate.

+ *

To delete a policy, use the DeletePolicyVersion API to delete all non-default + * versions of the policy; use the DetachPrincipalPolicy API to detach the policy from any + * certificate; and then use the DeletePolicy API to delete the policy.

+ *

When a policy is deleted using DeletePolicy, its default version is deleted with + * it.

+ */ export class DeletePolicyCommand extends $Command< DeletePolicyCommandInput, DeletePolicyCommandOutput, @@ -34,6 +44,9 @@ export class DeletePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeletePolicyVersionCommand.ts b/clients/client-iot/commands/DeletePolicyVersionCommand.ts index 45febb5e2f5d0..b53eee1f7bb14 100644 --- a/clients/client-iot/commands/DeletePolicyVersionCommand.ts +++ b/clients/client-iot/commands/DeletePolicyVersionCommand.ts @@ -20,6 +20,11 @@ import { export type DeletePolicyVersionCommandInput = DeletePolicyVersionRequest; export type DeletePolicyVersionCommandOutput = __MetadataBearer; +/** + *

Deletes the specified version of the specified policy. You cannot delete the default + * version of a policy using this API. To delete the default version of a policy, use DeletePolicy. To find out which version of a policy is marked as the default + * version, use ListPolicyVersions.

+ */ export class DeletePolicyVersionCommand extends $Command< DeletePolicyVersionCommandInput, DeletePolicyVersionCommandOutput, @@ -34,6 +39,9 @@ export class DeletePolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteProvisioningTemplateCommand.ts b/clients/client-iot/commands/DeleteProvisioningTemplateCommand.ts index f19b90211158a..e5c8a4c758f3d 100644 --- a/clients/client-iot/commands/DeleteProvisioningTemplateCommand.ts +++ b/clients/client-iot/commands/DeleteProvisioningTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProvisioningTemplateCommandInput = DeleteProvisioningTemplateRequest; export type DeleteProvisioningTemplateCommandOutput = DeleteProvisioningTemplateResponse & __MetadataBearer; +/** + *

Deletes a fleet provisioning template.

+ */ export class DeleteProvisioningTemplateCommand extends $Command< DeleteProvisioningTemplateCommandInput, DeleteProvisioningTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProvisioningTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteProvisioningTemplateVersionCommand.ts b/clients/client-iot/commands/DeleteProvisioningTemplateVersionCommand.ts index 801ea3e5967f3..b4b1a361af919 100644 --- a/clients/client-iot/commands/DeleteProvisioningTemplateVersionCommand.ts +++ b/clients/client-iot/commands/DeleteProvisioningTemplateVersionCommand.ts @@ -24,6 +24,9 @@ export type DeleteProvisioningTemplateVersionCommandInput = DeleteProvisioningTe export type DeleteProvisioningTemplateVersionCommandOutput = DeleteProvisioningTemplateVersionResponse & __MetadataBearer; +/** + *

Deletes a fleet provisioning template version.

+ */ export class DeleteProvisioningTemplateVersionCommand extends $Command< DeleteProvisioningTemplateVersionCommandInput, DeleteProvisioningTemplateVersionCommandOutput, @@ -38,6 +41,9 @@ export class DeleteProvisioningTemplateVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteRegistrationCodeCommand.ts b/clients/client-iot/commands/DeleteRegistrationCodeCommand.ts index 5e3498976f22c..0fca4366e2f88 100644 --- a/clients/client-iot/commands/DeleteRegistrationCodeCommand.ts +++ b/clients/client-iot/commands/DeleteRegistrationCodeCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRegistrationCodeCommandInput = DeleteRegistrationCodeRequest; export type DeleteRegistrationCodeCommandOutput = DeleteRegistrationCodeResponse & __MetadataBearer; +/** + *

Deletes a CA certificate registration code.

+ */ export class DeleteRegistrationCodeCommand extends $Command< DeleteRegistrationCodeCommandInput, DeleteRegistrationCodeCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRegistrationCodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteRoleAliasCommand.ts b/clients/client-iot/commands/DeleteRoleAliasCommand.ts index 21899a68e5633..669fb29437e15 100644 --- a/clients/client-iot/commands/DeleteRoleAliasCommand.ts +++ b/clients/client-iot/commands/DeleteRoleAliasCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRoleAliasCommandInput = DeleteRoleAliasRequest; export type DeleteRoleAliasCommandOutput = DeleteRoleAliasResponse & __MetadataBearer; +/** + *

Deletes a role alias

+ */ export class DeleteRoleAliasCommand extends $Command< DeleteRoleAliasCommandInput, DeleteRoleAliasCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRoleAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteScheduledAuditCommand.ts b/clients/client-iot/commands/DeleteScheduledAuditCommand.ts index 71f69034fc65e..365496c790af8 100644 --- a/clients/client-iot/commands/DeleteScheduledAuditCommand.ts +++ b/clients/client-iot/commands/DeleteScheduledAuditCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteScheduledAuditCommandInput = DeleteScheduledAuditRequest; export type DeleteScheduledAuditCommandOutput = DeleteScheduledAuditResponse & __MetadataBearer; +/** + *

Deletes a scheduled audit.

+ */ export class DeleteScheduledAuditCommand extends $Command< DeleteScheduledAuditCommandInput, DeleteScheduledAuditCommandOutput, @@ -34,6 +37,9 @@ export class DeleteScheduledAuditCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteSecurityProfileCommand.ts b/clients/client-iot/commands/DeleteSecurityProfileCommand.ts index d27e6489f741b..9de55ebafdb18 100644 --- a/clients/client-iot/commands/DeleteSecurityProfileCommand.ts +++ b/clients/client-iot/commands/DeleteSecurityProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSecurityProfileCommandInput = DeleteSecurityProfileRequest; export type DeleteSecurityProfileCommandOutput = DeleteSecurityProfileResponse & __MetadataBearer; +/** + *

Deletes a Device Defender security profile.

+ */ export class DeleteSecurityProfileCommand extends $Command< DeleteSecurityProfileCommandInput, DeleteSecurityProfileCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSecurityProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteStreamCommand.ts b/clients/client-iot/commands/DeleteStreamCommand.ts index 246af33bdb5ac..9b51913daed9e 100644 --- a/clients/client-iot/commands/DeleteStreamCommand.ts +++ b/clients/client-iot/commands/DeleteStreamCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteStreamCommandInput = DeleteStreamRequest; export type DeleteStreamCommandOutput = DeleteStreamResponse & __MetadataBearer; +/** + *

Deletes a stream.

+ */ export class DeleteStreamCommand extends $Command< DeleteStreamCommandInput, DeleteStreamCommandOutput, @@ -34,6 +37,9 @@ export class DeleteStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteThingCommand.ts b/clients/client-iot/commands/DeleteThingCommand.ts index 994a959ff63f3..6a72c364c0541 100644 --- a/clients/client-iot/commands/DeleteThingCommand.ts +++ b/clients/client-iot/commands/DeleteThingCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteThingCommandInput = DeleteThingRequest; export type DeleteThingCommandOutput = DeleteThingResponse & __MetadataBearer; +/** + *

Deletes the specified thing. Returns successfully with no error if the deletion is + * successful or you specify a thing that doesn't exist.

+ */ export class DeleteThingCommand extends $Command< DeleteThingCommandInput, DeleteThingCommandOutput, @@ -34,6 +38,9 @@ export class DeleteThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteThingGroupCommand.ts b/clients/client-iot/commands/DeleteThingGroupCommand.ts index 762b5a915085e..04e9444c58bb5 100644 --- a/clients/client-iot/commands/DeleteThingGroupCommand.ts +++ b/clients/client-iot/commands/DeleteThingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteThingGroupCommandInput = DeleteThingGroupRequest; export type DeleteThingGroupCommandOutput = DeleteThingGroupResponse & __MetadataBearer; +/** + *

Deletes a thing group.

+ */ export class DeleteThingGroupCommand extends $Command< DeleteThingGroupCommandInput, DeleteThingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteThingTypeCommand.ts b/clients/client-iot/commands/DeleteThingTypeCommand.ts index 79e77cef8d74f..0e3c3f1a1f7be 100644 --- a/clients/client-iot/commands/DeleteThingTypeCommand.ts +++ b/clients/client-iot/commands/DeleteThingTypeCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteThingTypeCommandInput = DeleteThingTypeRequest; export type DeleteThingTypeCommandOutput = DeleteThingTypeResponse & __MetadataBearer; +/** + *

Deletes the specified thing type. You cannot delete a thing type if it has things + * associated with it. To delete a thing type, first mark it as deprecated by calling DeprecateThingType, then remove any associated things by calling UpdateThing to change the thing type on any associated thing, and + * finally use DeleteThingType to delete the thing type.

+ */ export class DeleteThingTypeCommand extends $Command< DeleteThingTypeCommandInput, DeleteThingTypeCommandOutput, @@ -34,6 +39,9 @@ export class DeleteThingTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteTopicRuleCommand.ts b/clients/client-iot/commands/DeleteTopicRuleCommand.ts index 01b195ece8f76..34699f38668dc 100644 --- a/clients/client-iot/commands/DeleteTopicRuleCommand.ts +++ b/clients/client-iot/commands/DeleteTopicRuleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTopicRuleCommandInput = DeleteTopicRuleRequest; export type DeleteTopicRuleCommandOutput = __MetadataBearer; +/** + *

Deletes the rule.

+ */ export class DeleteTopicRuleCommand extends $Command< DeleteTopicRuleCommandInput, DeleteTopicRuleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTopicRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteTopicRuleDestinationCommand.ts b/clients/client-iot/commands/DeleteTopicRuleDestinationCommand.ts index 606b6dfb895b5..b652b8107e171 100644 --- a/clients/client-iot/commands/DeleteTopicRuleDestinationCommand.ts +++ b/clients/client-iot/commands/DeleteTopicRuleDestinationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTopicRuleDestinationCommandInput = DeleteTopicRuleDestinationRequest; export type DeleteTopicRuleDestinationCommandOutput = DeleteTopicRuleDestinationResponse & __MetadataBearer; +/** + *

Deletes a topic rule destination.

+ */ export class DeleteTopicRuleDestinationCommand extends $Command< DeleteTopicRuleDestinationCommandInput, DeleteTopicRuleDestinationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTopicRuleDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeleteV2LoggingLevelCommand.ts b/clients/client-iot/commands/DeleteV2LoggingLevelCommand.ts index 323ff850216d0..40eaac192f07b 100644 --- a/clients/client-iot/commands/DeleteV2LoggingLevelCommand.ts +++ b/clients/client-iot/commands/DeleteV2LoggingLevelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteV2LoggingLevelCommandInput = DeleteV2LoggingLevelRequest; export type DeleteV2LoggingLevelCommandOutput = __MetadataBearer; +/** + *

Deletes a logging level.

+ */ export class DeleteV2LoggingLevelCommand extends $Command< DeleteV2LoggingLevelCommandInput, DeleteV2LoggingLevelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteV2LoggingLevelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DeprecateThingTypeCommand.ts b/clients/client-iot/commands/DeprecateThingTypeCommand.ts index d9addce72730d..ddfaf3d29e117 100644 --- a/clients/client-iot/commands/DeprecateThingTypeCommand.ts +++ b/clients/client-iot/commands/DeprecateThingTypeCommand.ts @@ -20,6 +20,10 @@ import { export type DeprecateThingTypeCommandInput = DeprecateThingTypeRequest; export type DeprecateThingTypeCommandOutput = DeprecateThingTypeResponse & __MetadataBearer; +/** + *

Deprecates a thing type. You can not associate new things with deprecated thing + * type.

+ */ export class DeprecateThingTypeCommand extends $Command< DeprecateThingTypeCommandInput, DeprecateThingTypeCommandOutput, @@ -34,6 +38,9 @@ export class DeprecateThingTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeAccountAuditConfigurationCommand.ts b/clients/client-iot/commands/DescribeAccountAuditConfigurationCommand.ts index 8cae3cabada89..c2ff0b63f8024 100644 --- a/clients/client-iot/commands/DescribeAccountAuditConfigurationCommand.ts +++ b/clients/client-iot/commands/DescribeAccountAuditConfigurationCommand.ts @@ -24,6 +24,11 @@ export type DescribeAccountAuditConfigurationCommandInput = DescribeAccountAudit export type DescribeAccountAuditConfigurationCommandOutput = DescribeAccountAuditConfigurationResponse & __MetadataBearer; +/** + *

Gets information about the Device Defender audit settings for this account. + * Settings include how audit notifications are sent and which audit checks are + * enabled or disabled.

+ */ export class DescribeAccountAuditConfigurationCommand extends $Command< DescribeAccountAuditConfigurationCommandInput, DescribeAccountAuditConfigurationCommandOutput, @@ -38,6 +43,9 @@ export class DescribeAccountAuditConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeAuditFindingCommand.ts b/clients/client-iot/commands/DescribeAuditFindingCommand.ts index f89bb08511324..79e4d729e5a4d 100644 --- a/clients/client-iot/commands/DescribeAuditFindingCommand.ts +++ b/clients/client-iot/commands/DescribeAuditFindingCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAuditFindingCommandInput = DescribeAuditFindingRequest; export type DescribeAuditFindingCommandOutput = DescribeAuditFindingResponse & __MetadataBearer; +/** + *

Gets information about a single audit finding. Properties include the reason for noncompliance, the severity of the issue, and when the audit that returned the finding was started.

+ */ export class DescribeAuditFindingCommand extends $Command< DescribeAuditFindingCommandInput, DescribeAuditFindingCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAuditFindingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeAuditMitigationActionsTaskCommand.ts b/clients/client-iot/commands/DescribeAuditMitigationActionsTaskCommand.ts index 989c5875fd95a..1150c86433914 100644 --- a/clients/client-iot/commands/DescribeAuditMitigationActionsTaskCommand.ts +++ b/clients/client-iot/commands/DescribeAuditMitigationActionsTaskCommand.ts @@ -24,6 +24,9 @@ export type DescribeAuditMitigationActionsTaskCommandInput = DescribeAuditMitiga export type DescribeAuditMitigationActionsTaskCommandOutput = DescribeAuditMitigationActionsTaskResponse & __MetadataBearer; +/** + *

Gets information about an audit mitigation task that is used to apply mitigation actions to a set of audit findings. Properties include the actions being applied, the audit checks to which they're being applied, the task status, and aggregated task statistics.

+ */ export class DescribeAuditMitigationActionsTaskCommand extends $Command< DescribeAuditMitigationActionsTaskCommandInput, DescribeAuditMitigationActionsTaskCommandOutput, @@ -38,6 +41,9 @@ export class DescribeAuditMitigationActionsTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeAuditSuppressionCommand.ts b/clients/client-iot/commands/DescribeAuditSuppressionCommand.ts index de8f50dbf8ea6..9c8a262213b87 100644 --- a/clients/client-iot/commands/DescribeAuditSuppressionCommand.ts +++ b/clients/client-iot/commands/DescribeAuditSuppressionCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAuditSuppressionCommandInput = DescribeAuditSuppressionRequest; export type DescribeAuditSuppressionCommandOutput = DescribeAuditSuppressionResponse & __MetadataBearer; +/** + *

+ * Gets information about a Device Defender audit suppression. + *

+ */ export class DescribeAuditSuppressionCommand extends $Command< DescribeAuditSuppressionCommandInput, DescribeAuditSuppressionCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAuditSuppressionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeAuditTaskCommand.ts b/clients/client-iot/commands/DescribeAuditTaskCommand.ts index daabbeff059d4..3da3acd92e83d 100644 --- a/clients/client-iot/commands/DescribeAuditTaskCommand.ts +++ b/clients/client-iot/commands/DescribeAuditTaskCommand.ts @@ -21,6 +21,9 @@ import { export type DescribeAuditTaskCommandInput = DescribeAuditTaskRequest; export type DescribeAuditTaskCommandOutput = DescribeAuditTaskResponse & __MetadataBearer; +/** + *

Gets information about a Device Defender audit.

+ */ export class DescribeAuditTaskCommand extends $Command< DescribeAuditTaskCommandInput, DescribeAuditTaskCommandOutput, @@ -35,6 +38,9 @@ export class DescribeAuditTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeAuthorizerCommand.ts b/clients/client-iot/commands/DescribeAuthorizerCommand.ts index e8897690da562..ac628f1677907 100644 --- a/clients/client-iot/commands/DescribeAuthorizerCommand.ts +++ b/clients/client-iot/commands/DescribeAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAuthorizerCommandInput = DescribeAuthorizerRequest; export type DescribeAuthorizerCommandOutput = DescribeAuthorizerResponse & __MetadataBearer; +/** + *

Describes an authorizer.

+ */ export class DescribeAuthorizerCommand extends $Command< DescribeAuthorizerCommandInput, DescribeAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeBillingGroupCommand.ts b/clients/client-iot/commands/DescribeBillingGroupCommand.ts index d00a0140db4c8..998d50be0ed8d 100644 --- a/clients/client-iot/commands/DescribeBillingGroupCommand.ts +++ b/clients/client-iot/commands/DescribeBillingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBillingGroupCommandInput = DescribeBillingGroupRequest; export type DescribeBillingGroupCommandOutput = DescribeBillingGroupResponse & __MetadataBearer; +/** + *

Returns information about a billing group.

+ */ export class DescribeBillingGroupCommand extends $Command< DescribeBillingGroupCommandInput, DescribeBillingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBillingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeCACertificateCommand.ts b/clients/client-iot/commands/DescribeCACertificateCommand.ts index 9f183d68b2baa..a99959231d84f 100644 --- a/clients/client-iot/commands/DescribeCACertificateCommand.ts +++ b/clients/client-iot/commands/DescribeCACertificateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCACertificateCommandInput = DescribeCACertificateRequest; export type DescribeCACertificateCommandOutput = DescribeCACertificateResponse & __MetadataBearer; +/** + *

Describes a registered CA certificate.

+ */ export class DescribeCACertificateCommand extends $Command< DescribeCACertificateCommandInput, DescribeCACertificateCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCACertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeCertificateCommand.ts b/clients/client-iot/commands/DescribeCertificateCommand.ts index f7efec6517a0c..aee96de5640ea 100644 --- a/clients/client-iot/commands/DescribeCertificateCommand.ts +++ b/clients/client-iot/commands/DescribeCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCertificateCommandInput = DescribeCertificateRequest; export type DescribeCertificateCommandOutput = DescribeCertificateResponse & __MetadataBearer; +/** + *

Gets information about the specified certificate.

+ */ export class DescribeCertificateCommand extends $Command< DescribeCertificateCommandInput, DescribeCertificateCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeDefaultAuthorizerCommand.ts b/clients/client-iot/commands/DescribeDefaultAuthorizerCommand.ts index 9bfce8f571a1c..0adee233ee685 100644 --- a/clients/client-iot/commands/DescribeDefaultAuthorizerCommand.ts +++ b/clients/client-iot/commands/DescribeDefaultAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDefaultAuthorizerCommandInput = DescribeDefaultAuthorizerRequest; export type DescribeDefaultAuthorizerCommandOutput = DescribeDefaultAuthorizerResponse & __MetadataBearer; +/** + *

Describes the default authorizer.

+ */ export class DescribeDefaultAuthorizerCommand extends $Command< DescribeDefaultAuthorizerCommandInput, DescribeDefaultAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDefaultAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeDimensionCommand.ts b/clients/client-iot/commands/DescribeDimensionCommand.ts index 66ce7ac47f524..ebf94f1bbc070 100644 --- a/clients/client-iot/commands/DescribeDimensionCommand.ts +++ b/clients/client-iot/commands/DescribeDimensionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDimensionCommandInput = DescribeDimensionRequest; export type DescribeDimensionCommandOutput = DescribeDimensionResponse & __MetadataBearer; +/** + *

Provides details about a dimension that is defined in your AWS account.

+ */ export class DescribeDimensionCommand extends $Command< DescribeDimensionCommandInput, DescribeDimensionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDimensionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeDomainConfigurationCommand.ts b/clients/client-iot/commands/DescribeDomainConfigurationCommand.ts index ff6b457dc1bef..dbd770ed95315 100644 --- a/clients/client-iot/commands/DescribeDomainConfigurationCommand.ts +++ b/clients/client-iot/commands/DescribeDomainConfigurationCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeDomainConfigurationCommandInput = DescribeDomainConfigurationRequest; export type DescribeDomainConfigurationCommandOutput = DescribeDomainConfigurationResponse & __MetadataBearer; +/** + *

Gets summary information about a domain configuration.

+ * + *

The domain configuration feature is in public preview and is subject to change.

+ *
+ */ export class DescribeDomainConfigurationCommand extends $Command< DescribeDomainConfigurationCommandInput, DescribeDomainConfigurationCommandOutput, @@ -34,6 +40,9 @@ export class DescribeDomainConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeEndpointCommand.ts b/clients/client-iot/commands/DescribeEndpointCommand.ts index e622f51b03253..3ac3ef962744b 100644 --- a/clients/client-iot/commands/DescribeEndpointCommand.ts +++ b/clients/client-iot/commands/DescribeEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEndpointCommandInput = DescribeEndpointRequest; export type DescribeEndpointCommandOutput = DescribeEndpointResponse & __MetadataBearer; +/** + *

Returns a unique endpoint specific to the AWS account making the call.

+ */ export class DescribeEndpointCommand extends $Command< DescribeEndpointCommandInput, DescribeEndpointCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeEventConfigurationsCommand.ts b/clients/client-iot/commands/DescribeEventConfigurationsCommand.ts index e4d95a1aa63e4..7255cfcf1c737 100644 --- a/clients/client-iot/commands/DescribeEventConfigurationsCommand.ts +++ b/clients/client-iot/commands/DescribeEventConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEventConfigurationsCommandInput = DescribeEventConfigurationsRequest; export type DescribeEventConfigurationsCommandOutput = DescribeEventConfigurationsResponse & __MetadataBearer; +/** + *

Describes event configurations.

+ */ export class DescribeEventConfigurationsCommand extends $Command< DescribeEventConfigurationsCommandInput, DescribeEventConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEventConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeIndexCommand.ts b/clients/client-iot/commands/DescribeIndexCommand.ts index 6cd05755f5c31..c4336141fd46a 100644 --- a/clients/client-iot/commands/DescribeIndexCommand.ts +++ b/clients/client-iot/commands/DescribeIndexCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeIndexCommandInput = DescribeIndexRequest; export type DescribeIndexCommandOutput = DescribeIndexResponse & __MetadataBearer; +/** + *

Describes a search index.

+ */ export class DescribeIndexCommand extends $Command< DescribeIndexCommandInput, DescribeIndexCommandOutput, @@ -34,6 +37,9 @@ export class DescribeIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeJobCommand.ts b/clients/client-iot/commands/DescribeJobCommand.ts index 4cc18d8250412..a5023d194dc85 100644 --- a/clients/client-iot/commands/DescribeJobCommand.ts +++ b/clients/client-iot/commands/DescribeJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeJobCommandInput = DescribeJobRequest; export type DescribeJobCommandOutput = DescribeJobResponse & __MetadataBearer; +/** + *

Describes a job.

+ */ export class DescribeJobCommand extends $Command< DescribeJobCommandInput, DescribeJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeJobExecutionCommand.ts b/clients/client-iot/commands/DescribeJobExecutionCommand.ts index f76e98776c4de..dff53b1eca394 100644 --- a/clients/client-iot/commands/DescribeJobExecutionCommand.ts +++ b/clients/client-iot/commands/DescribeJobExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeJobExecutionCommandInput = DescribeJobExecutionRequest; export type DescribeJobExecutionCommandOutput = DescribeJobExecutionResponse & __MetadataBearer; +/** + *

Describes a job execution.

+ */ export class DescribeJobExecutionCommand extends $Command< DescribeJobExecutionCommandInput, DescribeJobExecutionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeJobExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeMitigationActionCommand.ts b/clients/client-iot/commands/DescribeMitigationActionCommand.ts index bd28b253fe567..58e9948098029 100644 --- a/clients/client-iot/commands/DescribeMitigationActionCommand.ts +++ b/clients/client-iot/commands/DescribeMitigationActionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMitigationActionCommandInput = DescribeMitigationActionRequest; export type DescribeMitigationActionCommandOutput = DescribeMitigationActionResponse & __MetadataBearer; +/** + *

Gets information about a mitigation action.

+ */ export class DescribeMitigationActionCommand extends $Command< DescribeMitigationActionCommandInput, DescribeMitigationActionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMitigationActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeProvisioningTemplateCommand.ts b/clients/client-iot/commands/DescribeProvisioningTemplateCommand.ts index 6c98a8576fff5..575d911ad6f5c 100644 --- a/clients/client-iot/commands/DescribeProvisioningTemplateCommand.ts +++ b/clients/client-iot/commands/DescribeProvisioningTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProvisioningTemplateCommandInput = DescribeProvisioningTemplateRequest; export type DescribeProvisioningTemplateCommandOutput = DescribeProvisioningTemplateResponse & __MetadataBearer; +/** + *

Returns information about a fleet provisioning template.

+ */ export class DescribeProvisioningTemplateCommand extends $Command< DescribeProvisioningTemplateCommandInput, DescribeProvisioningTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProvisioningTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeProvisioningTemplateVersionCommand.ts b/clients/client-iot/commands/DescribeProvisioningTemplateVersionCommand.ts index 1640a4b8206e8..5d261c9eae83d 100644 --- a/clients/client-iot/commands/DescribeProvisioningTemplateVersionCommand.ts +++ b/clients/client-iot/commands/DescribeProvisioningTemplateVersionCommand.ts @@ -24,6 +24,9 @@ export type DescribeProvisioningTemplateVersionCommandInput = DescribeProvisioni export type DescribeProvisioningTemplateVersionCommandOutput = DescribeProvisioningTemplateVersionResponse & __MetadataBearer; +/** + *

Returns information about a fleet provisioning template version.

+ */ export class DescribeProvisioningTemplateVersionCommand extends $Command< DescribeProvisioningTemplateVersionCommandInput, DescribeProvisioningTemplateVersionCommandOutput, @@ -38,6 +41,9 @@ export class DescribeProvisioningTemplateVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeRoleAliasCommand.ts b/clients/client-iot/commands/DescribeRoleAliasCommand.ts index 0b6204a211c04..a867a1fe7e9c2 100644 --- a/clients/client-iot/commands/DescribeRoleAliasCommand.ts +++ b/clients/client-iot/commands/DescribeRoleAliasCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRoleAliasCommandInput = DescribeRoleAliasRequest; export type DescribeRoleAliasCommandOutput = DescribeRoleAliasResponse & __MetadataBearer; +/** + *

Describes a role alias.

+ */ export class DescribeRoleAliasCommand extends $Command< DescribeRoleAliasCommandInput, DescribeRoleAliasCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRoleAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeScheduledAuditCommand.ts b/clients/client-iot/commands/DescribeScheduledAuditCommand.ts index 2750df667c52d..0ad9a7fbf3fc1 100644 --- a/clients/client-iot/commands/DescribeScheduledAuditCommand.ts +++ b/clients/client-iot/commands/DescribeScheduledAuditCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeScheduledAuditCommandInput = DescribeScheduledAuditRequest; export type DescribeScheduledAuditCommandOutput = DescribeScheduledAuditResponse & __MetadataBearer; +/** + *

Gets information about a scheduled audit.

+ */ export class DescribeScheduledAuditCommand extends $Command< DescribeScheduledAuditCommandInput, DescribeScheduledAuditCommandOutput, @@ -34,6 +37,9 @@ export class DescribeScheduledAuditCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeSecurityProfileCommand.ts b/clients/client-iot/commands/DescribeSecurityProfileCommand.ts index 8231c541b9c07..6900ad5cb8740 100644 --- a/clients/client-iot/commands/DescribeSecurityProfileCommand.ts +++ b/clients/client-iot/commands/DescribeSecurityProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSecurityProfileCommandInput = DescribeSecurityProfileRequest; export type DescribeSecurityProfileCommandOutput = DescribeSecurityProfileResponse & __MetadataBearer; +/** + *

Gets information about a Device Defender security profile.

+ */ export class DescribeSecurityProfileCommand extends $Command< DescribeSecurityProfileCommandInput, DescribeSecurityProfileCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSecurityProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeStreamCommand.ts b/clients/client-iot/commands/DescribeStreamCommand.ts index 1588b6216ed95..24a73db7e79d4 100644 --- a/clients/client-iot/commands/DescribeStreamCommand.ts +++ b/clients/client-iot/commands/DescribeStreamCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeStreamCommandInput = DescribeStreamRequest; export type DescribeStreamCommandOutput = DescribeStreamResponse & __MetadataBearer; +/** + *

Gets information about a stream.

+ */ export class DescribeStreamCommand extends $Command< DescribeStreamCommandInput, DescribeStreamCommandOutput, @@ -34,6 +37,9 @@ export class DescribeStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeThingCommand.ts b/clients/client-iot/commands/DescribeThingCommand.ts index ce4457448752c..3774edfbde4ce 100644 --- a/clients/client-iot/commands/DescribeThingCommand.ts +++ b/clients/client-iot/commands/DescribeThingCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeThingCommandInput = DescribeThingRequest; export type DescribeThingCommandOutput = DescribeThingResponse & __MetadataBearer; +/** + *

Gets information about the specified thing.

+ */ export class DescribeThingCommand extends $Command< DescribeThingCommandInput, DescribeThingCommandOutput, @@ -34,6 +37,9 @@ export class DescribeThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeThingGroupCommand.ts b/clients/client-iot/commands/DescribeThingGroupCommand.ts index 8e27f7ed09702..93be35ea2fddb 100644 --- a/clients/client-iot/commands/DescribeThingGroupCommand.ts +++ b/clients/client-iot/commands/DescribeThingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeThingGroupCommandInput = DescribeThingGroupRequest; export type DescribeThingGroupCommandOutput = DescribeThingGroupResponse & __MetadataBearer; +/** + *

Describe a thing group.

+ */ export class DescribeThingGroupCommand extends $Command< DescribeThingGroupCommandInput, DescribeThingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeThingRegistrationTaskCommand.ts b/clients/client-iot/commands/DescribeThingRegistrationTaskCommand.ts index a074f8a13a6a0..9d19b189cbdfc 100644 --- a/clients/client-iot/commands/DescribeThingRegistrationTaskCommand.ts +++ b/clients/client-iot/commands/DescribeThingRegistrationTaskCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeThingRegistrationTaskCommandInput = DescribeThingRegistrationTaskRequest; export type DescribeThingRegistrationTaskCommandOutput = DescribeThingRegistrationTaskResponse & __MetadataBearer; +/** + *

Describes a bulk thing provisioning task.

+ */ export class DescribeThingRegistrationTaskCommand extends $Command< DescribeThingRegistrationTaskCommandInput, DescribeThingRegistrationTaskCommandOutput, @@ -34,6 +37,9 @@ export class DescribeThingRegistrationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DescribeThingTypeCommand.ts b/clients/client-iot/commands/DescribeThingTypeCommand.ts index 0787c6138602c..e5505eec6d0e9 100644 --- a/clients/client-iot/commands/DescribeThingTypeCommand.ts +++ b/clients/client-iot/commands/DescribeThingTypeCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeThingTypeCommandInput = DescribeThingTypeRequest; export type DescribeThingTypeCommandOutput = DescribeThingTypeResponse & __MetadataBearer; +/** + *

Gets information about the specified thing type.

+ */ export class DescribeThingTypeCommand extends $Command< DescribeThingTypeCommandInput, DescribeThingTypeCommandOutput, @@ -34,6 +37,9 @@ export class DescribeThingTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DetachPolicyCommand.ts b/clients/client-iot/commands/DetachPolicyCommand.ts index 54be3a7233798..2a23f16bca984 100644 --- a/clients/client-iot/commands/DetachPolicyCommand.ts +++ b/clients/client-iot/commands/DetachPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DetachPolicyCommandInput = DetachPolicyRequest; export type DetachPolicyCommandOutput = __MetadataBearer; +/** + *

Detaches a policy from the specified target.

+ */ export class DetachPolicyCommand extends $Command< DetachPolicyCommandInput, DetachPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DetachPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DetachPrincipalPolicyCommand.ts b/clients/client-iot/commands/DetachPrincipalPolicyCommand.ts index 394ccdf16ab5d..60e652ef1c70f 100644 --- a/clients/client-iot/commands/DetachPrincipalPolicyCommand.ts +++ b/clients/client-iot/commands/DetachPrincipalPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type DetachPrincipalPolicyCommandInput = DetachPrincipalPolicyRequest; export type DetachPrincipalPolicyCommandOutput = __MetadataBearer; +/** + *

Removes the specified policy from the specified certificate.

+ *

+ * Note: This API is deprecated. Please use DetachPolicy instead.

+ */ export class DetachPrincipalPolicyCommand extends $Command< DetachPrincipalPolicyCommandInput, DetachPrincipalPolicyCommandOutput, @@ -34,6 +39,9 @@ export class DetachPrincipalPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DetachSecurityProfileCommand.ts b/clients/client-iot/commands/DetachSecurityProfileCommand.ts index 1260c2776179a..154b6d18487d0 100644 --- a/clients/client-iot/commands/DetachSecurityProfileCommand.ts +++ b/clients/client-iot/commands/DetachSecurityProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DetachSecurityProfileCommandInput = DetachSecurityProfileRequest; export type DetachSecurityProfileCommandOutput = DetachSecurityProfileResponse & __MetadataBearer; +/** + *

Disassociates a Device Defender security profile from a thing group or from this account.

+ */ export class DetachSecurityProfileCommand extends $Command< DetachSecurityProfileCommandInput, DetachSecurityProfileCommandOutput, @@ -34,6 +37,9 @@ export class DetachSecurityProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DetachThingPrincipalCommand.ts b/clients/client-iot/commands/DetachThingPrincipalCommand.ts index bc79540ce09ab..41408c7b7be38 100644 --- a/clients/client-iot/commands/DetachThingPrincipalCommand.ts +++ b/clients/client-iot/commands/DetachThingPrincipalCommand.ts @@ -20,6 +20,15 @@ import { export type DetachThingPrincipalCommandInput = DetachThingPrincipalRequest; export type DetachThingPrincipalCommandOutput = DetachThingPrincipalResponse & __MetadataBearer; +/** + *

Detaches the specified principal from the specified thing. A principal can be X.509 + * certificates, IAM users, groups, and roles, Amazon Cognito identities or federated + * identities.

+ * + *

This call is asynchronous. It might take several seconds for the detachment to + * propagate.

+ *
+ */ export class DetachThingPrincipalCommand extends $Command< DetachThingPrincipalCommandInput, DetachThingPrincipalCommandOutput, @@ -34,6 +43,9 @@ export class DetachThingPrincipalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/DisableTopicRuleCommand.ts b/clients/client-iot/commands/DisableTopicRuleCommand.ts index 6db8804f56c32..338fda5e7ec87 100644 --- a/clients/client-iot/commands/DisableTopicRuleCommand.ts +++ b/clients/client-iot/commands/DisableTopicRuleCommand.ts @@ -20,6 +20,9 @@ import { export type DisableTopicRuleCommandInput = DisableTopicRuleRequest; export type DisableTopicRuleCommandOutput = __MetadataBearer; +/** + *

Disables the rule.

+ */ export class DisableTopicRuleCommand extends $Command< DisableTopicRuleCommandInput, DisableTopicRuleCommandOutput, @@ -34,6 +37,9 @@ export class DisableTopicRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/EnableTopicRuleCommand.ts b/clients/client-iot/commands/EnableTopicRuleCommand.ts index 750a3b4546b7e..4cd038606a54f 100644 --- a/clients/client-iot/commands/EnableTopicRuleCommand.ts +++ b/clients/client-iot/commands/EnableTopicRuleCommand.ts @@ -20,6 +20,9 @@ import { export type EnableTopicRuleCommandInput = EnableTopicRuleRequest; export type EnableTopicRuleCommandOutput = __MetadataBearer; +/** + *

Enables the rule.

+ */ export class EnableTopicRuleCommand extends $Command< EnableTopicRuleCommandInput, EnableTopicRuleCommandOutput, @@ -34,6 +37,9 @@ export class EnableTopicRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetCardinalityCommand.ts b/clients/client-iot/commands/GetCardinalityCommand.ts index ac752fbd17699..5585f07b11c71 100644 --- a/clients/client-iot/commands/GetCardinalityCommand.ts +++ b/clients/client-iot/commands/GetCardinalityCommand.ts @@ -20,6 +20,9 @@ import { export type GetCardinalityCommandInput = GetCardinalityRequest; export type GetCardinalityCommandOutput = GetCardinalityResponse & __MetadataBearer; +/** + *

Returns the approximate count of unique values that match the query.

+ */ export class GetCardinalityCommand extends $Command< GetCardinalityCommandInput, GetCardinalityCommandOutput, @@ -34,6 +37,9 @@ export class GetCardinalityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetEffectivePoliciesCommand.ts b/clients/client-iot/commands/GetEffectivePoliciesCommand.ts index 7ef9241a6fc04..8707ec3be3eea 100644 --- a/clients/client-iot/commands/GetEffectivePoliciesCommand.ts +++ b/clients/client-iot/commands/GetEffectivePoliciesCommand.ts @@ -20,6 +20,10 @@ import { export type GetEffectivePoliciesCommandInput = GetEffectivePoliciesRequest; export type GetEffectivePoliciesCommandOutput = GetEffectivePoliciesResponse & __MetadataBearer; +/** + *

Gets a list of the policies that have an effect on the authorization behavior of the + * specified device when it connects to the AWS IoT device gateway.

+ */ export class GetEffectivePoliciesCommand extends $Command< GetEffectivePoliciesCommandInput, GetEffectivePoliciesCommandOutput, @@ -34,6 +38,9 @@ export class GetEffectivePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetIndexingConfigurationCommand.ts b/clients/client-iot/commands/GetIndexingConfigurationCommand.ts index 34300982a560a..16935768df517 100644 --- a/clients/client-iot/commands/GetIndexingConfigurationCommand.ts +++ b/clients/client-iot/commands/GetIndexingConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetIndexingConfigurationCommandInput = GetIndexingConfigurationRequest; export type GetIndexingConfigurationCommandOutput = GetIndexingConfigurationResponse & __MetadataBearer; +/** + *

Gets the indexing configuration.

+ */ export class GetIndexingConfigurationCommand extends $Command< GetIndexingConfigurationCommandInput, GetIndexingConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetIndexingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetJobDocumentCommand.ts b/clients/client-iot/commands/GetJobDocumentCommand.ts index d345942758f92..0f4aecf4b0916 100644 --- a/clients/client-iot/commands/GetJobDocumentCommand.ts +++ b/clients/client-iot/commands/GetJobDocumentCommand.ts @@ -20,6 +20,9 @@ import { export type GetJobDocumentCommandInput = GetJobDocumentRequest; export type GetJobDocumentCommandOutput = GetJobDocumentResponse & __MetadataBearer; +/** + *

Gets a job document.

+ */ export class GetJobDocumentCommand extends $Command< GetJobDocumentCommandInput, GetJobDocumentCommandOutput, @@ -34,6 +37,9 @@ export class GetJobDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetLoggingOptionsCommand.ts b/clients/client-iot/commands/GetLoggingOptionsCommand.ts index d5854de0e5ea6..fc6271029f6f5 100644 --- a/clients/client-iot/commands/GetLoggingOptionsCommand.ts +++ b/clients/client-iot/commands/GetLoggingOptionsCommand.ts @@ -20,6 +20,11 @@ import { export type GetLoggingOptionsCommandInput = GetLoggingOptionsRequest; export type GetLoggingOptionsCommandOutput = GetLoggingOptionsResponse & __MetadataBearer; +/** + *

Gets the logging options.

+ *

NOTE: use of this command is not recommended. Use GetV2LoggingOptions + * instead.

+ */ export class GetLoggingOptionsCommand extends $Command< GetLoggingOptionsCommandInput, GetLoggingOptionsCommandOutput, @@ -34,6 +39,9 @@ export class GetLoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetOTAUpdateCommand.ts b/clients/client-iot/commands/GetOTAUpdateCommand.ts index 30182c6d6fb13..a798b2032dcdf 100644 --- a/clients/client-iot/commands/GetOTAUpdateCommand.ts +++ b/clients/client-iot/commands/GetOTAUpdateCommand.ts @@ -20,6 +20,9 @@ import { export type GetOTAUpdateCommandInput = GetOTAUpdateRequest; export type GetOTAUpdateCommandOutput = GetOTAUpdateResponse & __MetadataBearer; +/** + *

Gets an OTA update.

+ */ export class GetOTAUpdateCommand extends $Command< GetOTAUpdateCommandInput, GetOTAUpdateCommandOutput, @@ -34,6 +37,9 @@ export class GetOTAUpdateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetPercentilesCommand.ts b/clients/client-iot/commands/GetPercentilesCommand.ts index 1300dd05e04fa..64d65d1ec5b94 100644 --- a/clients/client-iot/commands/GetPercentilesCommand.ts +++ b/clients/client-iot/commands/GetPercentilesCommand.ts @@ -20,6 +20,17 @@ import { export type GetPercentilesCommandInput = GetPercentilesRequest; export type GetPercentilesCommandOutput = GetPercentilesResponse & __MetadataBearer; +/** + *

Groups the aggregated values that match the query into percentile groupings. The default + * percentile groupings are: 1,5,25,50,75,95,99, although you can specify your own + * when you call GetPercentiles. This function returns a value for each + * percentile group specified (or the default percentile groupings). The percentile group + * "1" contains the aggregated field value that occurs in approximately one percent of the + * values that match the query. The percentile group "5" contains the aggregated field value + * that occurs in approximately five percent of the values that match the query, and so on. + * The result is an approximation, the more values that match the query, the more accurate + * the percentile values.

+ */ export class GetPercentilesCommand extends $Command< GetPercentilesCommandInput, GetPercentilesCommandOutput, @@ -34,6 +45,9 @@ export class GetPercentilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetPolicyCommand.ts b/clients/client-iot/commands/GetPolicyCommand.ts index b3347342de5d8..72d9d946061c9 100644 --- a/clients/client-iot/commands/GetPolicyCommand.ts +++ b/clients/client-iot/commands/GetPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type GetPolicyCommandInput = GetPolicyRequest; export type GetPolicyCommandOutput = GetPolicyResponse & __MetadataBearer; +/** + *

Gets information about the specified policy with the policy document of the default + * version.

+ */ export class GetPolicyCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +34,9 @@ export class GetPolicyCommand extends $Command, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetPolicyVersionCommand.ts b/clients/client-iot/commands/GetPolicyVersionCommand.ts index 18366bd39821e..895f8b41ae913 100644 --- a/clients/client-iot/commands/GetPolicyVersionCommand.ts +++ b/clients/client-iot/commands/GetPolicyVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetPolicyVersionCommandInput = GetPolicyVersionRequest; export type GetPolicyVersionCommandOutput = GetPolicyVersionResponse & __MetadataBearer; +/** + *

Gets information about the specified policy version.

+ */ export class GetPolicyVersionCommand extends $Command< GetPolicyVersionCommandInput, GetPolicyVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetPolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetRegistrationCodeCommand.ts b/clients/client-iot/commands/GetRegistrationCodeCommand.ts index 990794b8a6c28..dc8ceb623b898 100644 --- a/clients/client-iot/commands/GetRegistrationCodeCommand.ts +++ b/clients/client-iot/commands/GetRegistrationCodeCommand.ts @@ -20,6 +20,9 @@ import { export type GetRegistrationCodeCommandInput = GetRegistrationCodeRequest; export type GetRegistrationCodeCommandOutput = GetRegistrationCodeResponse & __MetadataBearer; +/** + *

Gets a registration code used to register a CA certificate with AWS IoT.

+ */ export class GetRegistrationCodeCommand extends $Command< GetRegistrationCodeCommandInput, GetRegistrationCodeCommandOutput, @@ -34,6 +37,9 @@ export class GetRegistrationCodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetStatisticsCommand.ts b/clients/client-iot/commands/GetStatisticsCommand.ts index 20542206ba483..57f6c81ea7406 100644 --- a/clients/client-iot/commands/GetStatisticsCommand.ts +++ b/clients/client-iot/commands/GetStatisticsCommand.ts @@ -20,6 +20,11 @@ import { export type GetStatisticsCommandInput = GetStatisticsRequest; export type GetStatisticsCommandOutput = GetStatisticsResponse & __MetadataBearer; +/** + *

Returns the count, average, sum, minimum, maximum, sum of squares, variance, + * and standard deviation for the specified aggregated field. If the aggregation field is of type + * String, only the count statistic is returned.

+ */ export class GetStatisticsCommand extends $Command< GetStatisticsCommandInput, GetStatisticsCommandOutput, @@ -34,6 +39,9 @@ export class GetStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetTopicRuleCommand.ts b/clients/client-iot/commands/GetTopicRuleCommand.ts index 9fdd599c26d41..8c47f388a7638 100644 --- a/clients/client-iot/commands/GetTopicRuleCommand.ts +++ b/clients/client-iot/commands/GetTopicRuleCommand.ts @@ -20,6 +20,9 @@ import { export type GetTopicRuleCommandInput = GetTopicRuleRequest; export type GetTopicRuleCommandOutput = GetTopicRuleResponse & __MetadataBearer; +/** + *

Gets information about the rule.

+ */ export class GetTopicRuleCommand extends $Command< GetTopicRuleCommandInput, GetTopicRuleCommandOutput, @@ -34,6 +37,9 @@ export class GetTopicRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetTopicRuleDestinationCommand.ts b/clients/client-iot/commands/GetTopicRuleDestinationCommand.ts index 9c9a4071f3348..84448d401e32a 100644 --- a/clients/client-iot/commands/GetTopicRuleDestinationCommand.ts +++ b/clients/client-iot/commands/GetTopicRuleDestinationCommand.ts @@ -20,6 +20,9 @@ import { export type GetTopicRuleDestinationCommandInput = GetTopicRuleDestinationRequest; export type GetTopicRuleDestinationCommandOutput = GetTopicRuleDestinationResponse & __MetadataBearer; +/** + *

Gets information about a topic rule destination.

+ */ export class GetTopicRuleDestinationCommand extends $Command< GetTopicRuleDestinationCommandInput, GetTopicRuleDestinationCommandOutput, @@ -34,6 +37,9 @@ export class GetTopicRuleDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/GetV2LoggingOptionsCommand.ts b/clients/client-iot/commands/GetV2LoggingOptionsCommand.ts index 7dec0e3dd98b9..82ac8e69c80fe 100644 --- a/clients/client-iot/commands/GetV2LoggingOptionsCommand.ts +++ b/clients/client-iot/commands/GetV2LoggingOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetV2LoggingOptionsCommandInput = GetV2LoggingOptionsRequest; export type GetV2LoggingOptionsCommandOutput = GetV2LoggingOptionsResponse & __MetadataBearer; +/** + *

Gets the fine grained logging options.

+ */ export class GetV2LoggingOptionsCommand extends $Command< GetV2LoggingOptionsCommandInput, GetV2LoggingOptionsCommandOutput, @@ -34,6 +37,9 @@ export class GetV2LoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListActiveViolationsCommand.ts b/clients/client-iot/commands/ListActiveViolationsCommand.ts index e4178e66d54d5..3961009449108 100644 --- a/clients/client-iot/commands/ListActiveViolationsCommand.ts +++ b/clients/client-iot/commands/ListActiveViolationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListActiveViolationsCommandInput = ListActiveViolationsRequest; export type ListActiveViolationsCommandOutput = ListActiveViolationsResponse & __MetadataBearer; +/** + *

Lists the active violations for a given Device Defender security profile.

+ */ export class ListActiveViolationsCommand extends $Command< ListActiveViolationsCommandInput, ListActiveViolationsCommandOutput, @@ -34,6 +37,9 @@ export class ListActiveViolationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListAttachedPoliciesCommand.ts b/clients/client-iot/commands/ListAttachedPoliciesCommand.ts index 63e3c9862f2c7..ca3f3f351c65b 100644 --- a/clients/client-iot/commands/ListAttachedPoliciesCommand.ts +++ b/clients/client-iot/commands/ListAttachedPoliciesCommand.ts @@ -20,6 +20,9 @@ import { export type ListAttachedPoliciesCommandInput = ListAttachedPoliciesRequest; export type ListAttachedPoliciesCommandOutput = ListAttachedPoliciesResponse & __MetadataBearer; +/** + *

Lists the policies attached to the specified thing group.

+ */ export class ListAttachedPoliciesCommand extends $Command< ListAttachedPoliciesCommandInput, ListAttachedPoliciesCommandOutput, @@ -34,6 +37,9 @@ export class ListAttachedPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListAuditFindingsCommand.ts b/clients/client-iot/commands/ListAuditFindingsCommand.ts index 1369889c3a0ce..3857d35426d63 100644 --- a/clients/client-iot/commands/ListAuditFindingsCommand.ts +++ b/clients/client-iot/commands/ListAuditFindingsCommand.ts @@ -20,6 +20,10 @@ import { export type ListAuditFindingsCommandInput = ListAuditFindingsRequest; export type ListAuditFindingsCommandOutput = ListAuditFindingsResponse & __MetadataBearer; +/** + *

Lists the findings (results) of a Device Defender audit or of the audits + * performed during a specified time period. (Findings are retained for 90 days.)

+ */ export class ListAuditFindingsCommand extends $Command< ListAuditFindingsCommandInput, ListAuditFindingsCommandOutput, @@ -34,6 +38,9 @@ export class ListAuditFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListAuditMitigationActionsExecutionsCommand.ts b/clients/client-iot/commands/ListAuditMitigationActionsExecutionsCommand.ts index e319d11a355a0..b698917b03b0c 100644 --- a/clients/client-iot/commands/ListAuditMitigationActionsExecutionsCommand.ts +++ b/clients/client-iot/commands/ListAuditMitigationActionsExecutionsCommand.ts @@ -24,6 +24,9 @@ export type ListAuditMitigationActionsExecutionsCommandInput = ListAuditMitigati export type ListAuditMitigationActionsExecutionsCommandOutput = ListAuditMitigationActionsExecutionsResponse & __MetadataBearer; +/** + *

Gets the status of audit mitigation action tasks that were executed.

+ */ export class ListAuditMitigationActionsExecutionsCommand extends $Command< ListAuditMitigationActionsExecutionsCommandInput, ListAuditMitigationActionsExecutionsCommandOutput, @@ -38,6 +41,9 @@ export class ListAuditMitigationActionsExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListAuditMitigationActionsTasksCommand.ts b/clients/client-iot/commands/ListAuditMitigationActionsTasksCommand.ts index 6affdd5d1b104..566c96461e6b0 100644 --- a/clients/client-iot/commands/ListAuditMitigationActionsTasksCommand.ts +++ b/clients/client-iot/commands/ListAuditMitigationActionsTasksCommand.ts @@ -20,6 +20,9 @@ import { export type ListAuditMitigationActionsTasksCommandInput = ListAuditMitigationActionsTasksRequest; export type ListAuditMitigationActionsTasksCommandOutput = ListAuditMitigationActionsTasksResponse & __MetadataBearer; +/** + *

Gets a list of audit mitigation action tasks that match the specified filters.

+ */ export class ListAuditMitigationActionsTasksCommand extends $Command< ListAuditMitigationActionsTasksCommandInput, ListAuditMitigationActionsTasksCommandOutput, @@ -34,6 +37,9 @@ export class ListAuditMitigationActionsTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListAuditSuppressionsCommand.ts b/clients/client-iot/commands/ListAuditSuppressionsCommand.ts index 61de3eb287e7e..9dc3d2534f8dd 100644 --- a/clients/client-iot/commands/ListAuditSuppressionsCommand.ts +++ b/clients/client-iot/commands/ListAuditSuppressionsCommand.ts @@ -20,6 +20,11 @@ import { export type ListAuditSuppressionsCommandInput = ListAuditSuppressionsRequest; export type ListAuditSuppressionsCommandOutput = ListAuditSuppressionsResponse & __MetadataBearer; +/** + *

+ * Lists your Device Defender audit listings. + *

+ */ export class ListAuditSuppressionsCommand extends $Command< ListAuditSuppressionsCommandInput, ListAuditSuppressionsCommandOutput, @@ -34,6 +39,9 @@ export class ListAuditSuppressionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListAuditTasksCommand.ts b/clients/client-iot/commands/ListAuditTasksCommand.ts index e6080a5e21dac..80b9f0de04dc0 100644 --- a/clients/client-iot/commands/ListAuditTasksCommand.ts +++ b/clients/client-iot/commands/ListAuditTasksCommand.ts @@ -20,6 +20,10 @@ import { export type ListAuditTasksCommandInput = ListAuditTasksRequest; export type ListAuditTasksCommandOutput = ListAuditTasksResponse & __MetadataBearer; +/** + *

Lists the Device Defender audits that have been performed during a given + * time period.

+ */ export class ListAuditTasksCommand extends $Command< ListAuditTasksCommandInput, ListAuditTasksCommandOutput, @@ -34,6 +38,9 @@ export class ListAuditTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListAuthorizersCommand.ts b/clients/client-iot/commands/ListAuthorizersCommand.ts index 25265a48a0ca1..0d1a122fb3f89 100644 --- a/clients/client-iot/commands/ListAuthorizersCommand.ts +++ b/clients/client-iot/commands/ListAuthorizersCommand.ts @@ -20,6 +20,9 @@ import { export type ListAuthorizersCommandInput = ListAuthorizersRequest; export type ListAuthorizersCommandOutput = ListAuthorizersResponse & __MetadataBearer; +/** + *

Lists the authorizers registered in your account.

+ */ export class ListAuthorizersCommand extends $Command< ListAuthorizersCommandInput, ListAuthorizersCommandOutput, @@ -34,6 +37,9 @@ export class ListAuthorizersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListBillingGroupsCommand.ts b/clients/client-iot/commands/ListBillingGroupsCommand.ts index b974de77357b6..12bd23c2c6cee 100644 --- a/clients/client-iot/commands/ListBillingGroupsCommand.ts +++ b/clients/client-iot/commands/ListBillingGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListBillingGroupsCommandInput = ListBillingGroupsRequest; export type ListBillingGroupsCommandOutput = ListBillingGroupsResponse & __MetadataBearer; +/** + *

Lists the billing groups you have created.

+ */ export class ListBillingGroupsCommand extends $Command< ListBillingGroupsCommandInput, ListBillingGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListBillingGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListCACertificatesCommand.ts b/clients/client-iot/commands/ListCACertificatesCommand.ts index 238dd2b11855a..cabef04f792cd 100644 --- a/clients/client-iot/commands/ListCACertificatesCommand.ts +++ b/clients/client-iot/commands/ListCACertificatesCommand.ts @@ -20,6 +20,11 @@ import { export type ListCACertificatesCommandInput = ListCACertificatesRequest; export type ListCACertificatesCommandOutput = ListCACertificatesResponse & __MetadataBearer; +/** + *

Lists the CA certificates registered for your AWS account.

+ *

The results are paginated with a default page size of 25. You can use the returned + * marker to retrieve additional results.

+ */ export class ListCACertificatesCommand extends $Command< ListCACertificatesCommandInput, ListCACertificatesCommandOutput, @@ -34,6 +39,9 @@ export class ListCACertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListCertificatesByCACommand.ts b/clients/client-iot/commands/ListCertificatesByCACommand.ts index 3d17285f857b1..623959ef9ccd7 100644 --- a/clients/client-iot/commands/ListCertificatesByCACommand.ts +++ b/clients/client-iot/commands/ListCertificatesByCACommand.ts @@ -20,6 +20,9 @@ import { export type ListCertificatesByCACommandInput = ListCertificatesByCARequest; export type ListCertificatesByCACommandOutput = ListCertificatesByCAResponse & __MetadataBearer; +/** + *

List the device certificates signed by the specified CA certificate.

+ */ export class ListCertificatesByCACommand extends $Command< ListCertificatesByCACommandInput, ListCertificatesByCACommandOutput, @@ -34,6 +37,9 @@ export class ListCertificatesByCACommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListCertificatesCommand.ts b/clients/client-iot/commands/ListCertificatesCommand.ts index 29012646bb754..e3e043524d913 100644 --- a/clients/client-iot/commands/ListCertificatesCommand.ts +++ b/clients/client-iot/commands/ListCertificatesCommand.ts @@ -20,6 +20,11 @@ import { export type ListCertificatesCommandInput = ListCertificatesRequest; export type ListCertificatesCommandOutput = ListCertificatesResponse & __MetadataBearer; +/** + *

Lists the certificates registered in your AWS account.

+ *

The results are paginated with a default page size of 25. You can use the returned + * marker to retrieve additional results.

+ */ export class ListCertificatesCommand extends $Command< ListCertificatesCommandInput, ListCertificatesCommandOutput, @@ -34,6 +39,9 @@ export class ListCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListDimensionsCommand.ts b/clients/client-iot/commands/ListDimensionsCommand.ts index 76612293051df..022d8bca363d3 100644 --- a/clients/client-iot/commands/ListDimensionsCommand.ts +++ b/clients/client-iot/commands/ListDimensionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDimensionsCommandInput = ListDimensionsRequest; export type ListDimensionsCommandOutput = ListDimensionsResponse & __MetadataBearer; +/** + *

List the set of dimensions that are defined for your AWS account.

+ */ export class ListDimensionsCommand extends $Command< ListDimensionsCommandInput, ListDimensionsCommandOutput, @@ -34,6 +37,9 @@ export class ListDimensionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListDomainConfigurationsCommand.ts b/clients/client-iot/commands/ListDomainConfigurationsCommand.ts index f29d66c2221a0..85cb80dbfa51a 100644 --- a/clients/client-iot/commands/ListDomainConfigurationsCommand.ts +++ b/clients/client-iot/commands/ListDomainConfigurationsCommand.ts @@ -20,6 +20,12 @@ import { export type ListDomainConfigurationsCommandInput = ListDomainConfigurationsRequest; export type ListDomainConfigurationsCommandOutput = ListDomainConfigurationsResponse & __MetadataBearer; +/** + *

Gets a list of domain configurations for the user. This list is sorted alphabetically by domain configuration name.

+ * + *

The domain configuration feature is in public preview and is subject to change.

+ *
+ */ export class ListDomainConfigurationsCommand extends $Command< ListDomainConfigurationsCommandInput, ListDomainConfigurationsCommandOutput, @@ -34,6 +40,9 @@ export class ListDomainConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListIndicesCommand.ts b/clients/client-iot/commands/ListIndicesCommand.ts index d97b87cc42b16..1360ac92e58ac 100644 --- a/clients/client-iot/commands/ListIndicesCommand.ts +++ b/clients/client-iot/commands/ListIndicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListIndicesCommandInput = ListIndicesRequest; export type ListIndicesCommandOutput = ListIndicesResponse & __MetadataBearer; +/** + *

Lists the search indices.

+ */ export class ListIndicesCommand extends $Command< ListIndicesCommandInput, ListIndicesCommandOutput, @@ -34,6 +37,9 @@ export class ListIndicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListJobExecutionsForJobCommand.ts b/clients/client-iot/commands/ListJobExecutionsForJobCommand.ts index 36bcba39c7fd3..f7cacaacbe9f1 100644 --- a/clients/client-iot/commands/ListJobExecutionsForJobCommand.ts +++ b/clients/client-iot/commands/ListJobExecutionsForJobCommand.ts @@ -20,6 +20,9 @@ import { export type ListJobExecutionsForJobCommandInput = ListJobExecutionsForJobRequest; export type ListJobExecutionsForJobCommandOutput = ListJobExecutionsForJobResponse & __MetadataBearer; +/** + *

Lists the job executions for a job.

+ */ export class ListJobExecutionsForJobCommand extends $Command< ListJobExecutionsForJobCommandInput, ListJobExecutionsForJobCommandOutput, @@ -34,6 +37,9 @@ export class ListJobExecutionsForJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListJobExecutionsForThingCommand.ts b/clients/client-iot/commands/ListJobExecutionsForThingCommand.ts index 2a0c4c53715d2..dcbd6eca3123f 100644 --- a/clients/client-iot/commands/ListJobExecutionsForThingCommand.ts +++ b/clients/client-iot/commands/ListJobExecutionsForThingCommand.ts @@ -20,6 +20,9 @@ import { export type ListJobExecutionsForThingCommandInput = ListJobExecutionsForThingRequest; export type ListJobExecutionsForThingCommandOutput = ListJobExecutionsForThingResponse & __MetadataBearer; +/** + *

Lists the job executions for the specified thing.

+ */ export class ListJobExecutionsForThingCommand extends $Command< ListJobExecutionsForThingCommandInput, ListJobExecutionsForThingCommandOutput, @@ -34,6 +37,9 @@ export class ListJobExecutionsForThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListJobsCommand.ts b/clients/client-iot/commands/ListJobsCommand.ts index 61877dbe7c759..3c3d10962a601 100644 --- a/clients/client-iot/commands/ListJobsCommand.ts +++ b/clients/client-iot/commands/ListJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResponse & __MetadataBearer; +/** + *

Lists jobs.

+ */ export class ListJobsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class ListJobsCommand extends $Command, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListMitigationActionsCommand.ts b/clients/client-iot/commands/ListMitigationActionsCommand.ts index 408f4c9db18f2..ec596fb434132 100644 --- a/clients/client-iot/commands/ListMitigationActionsCommand.ts +++ b/clients/client-iot/commands/ListMitigationActionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListMitigationActionsCommandInput = ListMitigationActionsRequest; export type ListMitigationActionsCommandOutput = ListMitigationActionsResponse & __MetadataBearer; +/** + *

Gets a list of all mitigation actions that match the specified filter criteria.

+ */ export class ListMitigationActionsCommand extends $Command< ListMitigationActionsCommandInput, ListMitigationActionsCommandOutput, @@ -34,6 +37,9 @@ export class ListMitigationActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListOTAUpdatesCommand.ts b/clients/client-iot/commands/ListOTAUpdatesCommand.ts index 963e2cd209146..4fb859de24ba6 100644 --- a/clients/client-iot/commands/ListOTAUpdatesCommand.ts +++ b/clients/client-iot/commands/ListOTAUpdatesCommand.ts @@ -20,6 +20,9 @@ import { export type ListOTAUpdatesCommandInput = ListOTAUpdatesRequest; export type ListOTAUpdatesCommandOutput = ListOTAUpdatesResponse & __MetadataBearer; +/** + *

Lists OTA updates.

+ */ export class ListOTAUpdatesCommand extends $Command< ListOTAUpdatesCommandInput, ListOTAUpdatesCommandOutput, @@ -34,6 +37,9 @@ export class ListOTAUpdatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListOutgoingCertificatesCommand.ts b/clients/client-iot/commands/ListOutgoingCertificatesCommand.ts index cf3e8ccf2dafd..af01c7bd2095c 100644 --- a/clients/client-iot/commands/ListOutgoingCertificatesCommand.ts +++ b/clients/client-iot/commands/ListOutgoingCertificatesCommand.ts @@ -20,6 +20,9 @@ import { export type ListOutgoingCertificatesCommandInput = ListOutgoingCertificatesRequest; export type ListOutgoingCertificatesCommandOutput = ListOutgoingCertificatesResponse & __MetadataBearer; +/** + *

Lists certificates that are being transferred but not yet accepted.

+ */ export class ListOutgoingCertificatesCommand extends $Command< ListOutgoingCertificatesCommandInput, ListOutgoingCertificatesCommandOutput, @@ -34,6 +37,9 @@ export class ListOutgoingCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListPoliciesCommand.ts b/clients/client-iot/commands/ListPoliciesCommand.ts index 44aba5e6098d8..171a8606dc26f 100644 --- a/clients/client-iot/commands/ListPoliciesCommand.ts +++ b/clients/client-iot/commands/ListPoliciesCommand.ts @@ -20,6 +20,9 @@ import { export type ListPoliciesCommandInput = ListPoliciesRequest; export type ListPoliciesCommandOutput = ListPoliciesResponse & __MetadataBearer; +/** + *

Lists your policies.

+ */ export class ListPoliciesCommand extends $Command< ListPoliciesCommandInput, ListPoliciesCommandOutput, @@ -34,6 +37,9 @@ export class ListPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListPolicyPrincipalsCommand.ts b/clients/client-iot/commands/ListPolicyPrincipalsCommand.ts index 7f3aeaff659b4..e132cfe28db8e 100644 --- a/clients/client-iot/commands/ListPolicyPrincipalsCommand.ts +++ b/clients/client-iot/commands/ListPolicyPrincipalsCommand.ts @@ -20,6 +20,11 @@ import { export type ListPolicyPrincipalsCommandInput = ListPolicyPrincipalsRequest; export type ListPolicyPrincipalsCommandOutput = ListPolicyPrincipalsResponse & __MetadataBearer; +/** + *

Lists the principals associated with the specified policy.

+ *

+ * Note: This API is deprecated. Please use ListTargetsForPolicy instead.

+ */ export class ListPolicyPrincipalsCommand extends $Command< ListPolicyPrincipalsCommandInput, ListPolicyPrincipalsCommandOutput, @@ -34,6 +39,9 @@ export class ListPolicyPrincipalsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListPolicyVersionsCommand.ts b/clients/client-iot/commands/ListPolicyVersionsCommand.ts index 5df50a65546cb..6bf5de8c8c0ac 100644 --- a/clients/client-iot/commands/ListPolicyVersionsCommand.ts +++ b/clients/client-iot/commands/ListPolicyVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListPolicyVersionsCommandInput = ListPolicyVersionsRequest; export type ListPolicyVersionsCommandOutput = ListPolicyVersionsResponse & __MetadataBearer; +/** + *

Lists the versions of the specified policy and identifies the default + * version.

+ */ export class ListPolicyVersionsCommand extends $Command< ListPolicyVersionsCommandInput, ListPolicyVersionsCommandOutput, @@ -34,6 +38,9 @@ export class ListPolicyVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListPrincipalPoliciesCommand.ts b/clients/client-iot/commands/ListPrincipalPoliciesCommand.ts index 009d47eea490a..11d87c9fb328d 100644 --- a/clients/client-iot/commands/ListPrincipalPoliciesCommand.ts +++ b/clients/client-iot/commands/ListPrincipalPoliciesCommand.ts @@ -20,6 +20,12 @@ import { export type ListPrincipalPoliciesCommandInput = ListPrincipalPoliciesRequest; export type ListPrincipalPoliciesCommandOutput = ListPrincipalPoliciesResponse & __MetadataBearer; +/** + *

Lists the policies attached to the specified principal. If you use an Cognito + * identity, the ID must be in AmazonCognito Identity format.

+ *

+ * Note: This API is deprecated. Please use ListAttachedPolicies instead.

+ */ export class ListPrincipalPoliciesCommand extends $Command< ListPrincipalPoliciesCommandInput, ListPrincipalPoliciesCommandOutput, @@ -34,6 +40,9 @@ export class ListPrincipalPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListPrincipalThingsCommand.ts b/clients/client-iot/commands/ListPrincipalThingsCommand.ts index 78bbaa3ec8e86..8ffd2e0197ac6 100644 --- a/clients/client-iot/commands/ListPrincipalThingsCommand.ts +++ b/clients/client-iot/commands/ListPrincipalThingsCommand.ts @@ -20,6 +20,11 @@ import { export type ListPrincipalThingsCommandInput = ListPrincipalThingsRequest; export type ListPrincipalThingsCommandOutput = ListPrincipalThingsResponse & __MetadataBearer; +/** + *

Lists the things associated with the specified principal. A principal can be X.509 + * certificates, IAM users, groups, and roles, Amazon Cognito identities or federated + * identities.

+ */ export class ListPrincipalThingsCommand extends $Command< ListPrincipalThingsCommandInput, ListPrincipalThingsCommandOutput, @@ -34,6 +39,9 @@ export class ListPrincipalThingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListProvisioningTemplateVersionsCommand.ts b/clients/client-iot/commands/ListProvisioningTemplateVersionsCommand.ts index fe3252cf780ba..f8aded8734d55 100644 --- a/clients/client-iot/commands/ListProvisioningTemplateVersionsCommand.ts +++ b/clients/client-iot/commands/ListProvisioningTemplateVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProvisioningTemplateVersionsCommandInput = ListProvisioningTemplateVersionsRequest; export type ListProvisioningTemplateVersionsCommandOutput = ListProvisioningTemplateVersionsResponse & __MetadataBearer; +/** + *

A list of fleet provisioning template versions.

+ */ export class ListProvisioningTemplateVersionsCommand extends $Command< ListProvisioningTemplateVersionsCommandInput, ListProvisioningTemplateVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListProvisioningTemplateVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListProvisioningTemplatesCommand.ts b/clients/client-iot/commands/ListProvisioningTemplatesCommand.ts index 85b99479eac43..0fe4e2d6cdea0 100644 --- a/clients/client-iot/commands/ListProvisioningTemplatesCommand.ts +++ b/clients/client-iot/commands/ListProvisioningTemplatesCommand.ts @@ -20,6 +20,9 @@ import { export type ListProvisioningTemplatesCommandInput = ListProvisioningTemplatesRequest; export type ListProvisioningTemplatesCommandOutput = ListProvisioningTemplatesResponse & __MetadataBearer; +/** + *

Lists the fleet provisioning templates in your AWS account.

+ */ export class ListProvisioningTemplatesCommand extends $Command< ListProvisioningTemplatesCommandInput, ListProvisioningTemplatesCommandOutput, @@ -34,6 +37,9 @@ export class ListProvisioningTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListRoleAliasesCommand.ts b/clients/client-iot/commands/ListRoleAliasesCommand.ts index 126549dee3f7d..0540affe5056f 100644 --- a/clients/client-iot/commands/ListRoleAliasesCommand.ts +++ b/clients/client-iot/commands/ListRoleAliasesCommand.ts @@ -20,6 +20,9 @@ import { export type ListRoleAliasesCommandInput = ListRoleAliasesRequest; export type ListRoleAliasesCommandOutput = ListRoleAliasesResponse & __MetadataBearer; +/** + *

Lists the role aliases registered in your account.

+ */ export class ListRoleAliasesCommand extends $Command< ListRoleAliasesCommandInput, ListRoleAliasesCommandOutput, @@ -34,6 +37,9 @@ export class ListRoleAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListScheduledAuditsCommand.ts b/clients/client-iot/commands/ListScheduledAuditsCommand.ts index 84ef325ff5097..873ab3abccf88 100644 --- a/clients/client-iot/commands/ListScheduledAuditsCommand.ts +++ b/clients/client-iot/commands/ListScheduledAuditsCommand.ts @@ -20,6 +20,9 @@ import { export type ListScheduledAuditsCommandInput = ListScheduledAuditsRequest; export type ListScheduledAuditsCommandOutput = ListScheduledAuditsResponse & __MetadataBearer; +/** + *

Lists all of your scheduled audits.

+ */ export class ListScheduledAuditsCommand extends $Command< ListScheduledAuditsCommandInput, ListScheduledAuditsCommandOutput, @@ -34,6 +37,9 @@ export class ListScheduledAuditsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListSecurityProfilesCommand.ts b/clients/client-iot/commands/ListSecurityProfilesCommand.ts index 16e7a5e257745..a3f4aa0548110 100644 --- a/clients/client-iot/commands/ListSecurityProfilesCommand.ts +++ b/clients/client-iot/commands/ListSecurityProfilesCommand.ts @@ -20,6 +20,10 @@ import { export type ListSecurityProfilesCommandInput = ListSecurityProfilesRequest; export type ListSecurityProfilesCommandOutput = ListSecurityProfilesResponse & __MetadataBearer; +/** + *

Lists the Device Defender security profiles you have created. You can use filters to list only those security + * profiles associated with a thing group or only those associated with your account.

+ */ export class ListSecurityProfilesCommand extends $Command< ListSecurityProfilesCommandInput, ListSecurityProfilesCommandOutput, @@ -34,6 +38,9 @@ export class ListSecurityProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListSecurityProfilesForTargetCommand.ts b/clients/client-iot/commands/ListSecurityProfilesForTargetCommand.ts index 73e6bbed3035a..60bdcf68ef2c3 100644 --- a/clients/client-iot/commands/ListSecurityProfilesForTargetCommand.ts +++ b/clients/client-iot/commands/ListSecurityProfilesForTargetCommand.ts @@ -20,6 +20,9 @@ import { export type ListSecurityProfilesForTargetCommandInput = ListSecurityProfilesForTargetRequest; export type ListSecurityProfilesForTargetCommandOutput = ListSecurityProfilesForTargetResponse & __MetadataBearer; +/** + *

Lists the Device Defender security profiles attached to a target (thing group).

+ */ export class ListSecurityProfilesForTargetCommand extends $Command< ListSecurityProfilesForTargetCommandInput, ListSecurityProfilesForTargetCommandOutput, @@ -34,6 +37,9 @@ export class ListSecurityProfilesForTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListStreamsCommand.ts b/clients/client-iot/commands/ListStreamsCommand.ts index 2b3d225bfad36..0b0d3e7c0d0a5 100644 --- a/clients/client-iot/commands/ListStreamsCommand.ts +++ b/clients/client-iot/commands/ListStreamsCommand.ts @@ -20,6 +20,9 @@ import { export type ListStreamsCommandInput = ListStreamsRequest; export type ListStreamsCommandOutput = ListStreamsResponse & __MetadataBearer; +/** + *

Lists all of the streams in your AWS account.

+ */ export class ListStreamsCommand extends $Command< ListStreamsCommandInput, ListStreamsCommandOutput, @@ -34,6 +37,9 @@ export class ListStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListTagsForResourceCommand.ts b/clients/client-iot/commands/ListTagsForResourceCommand.ts index 8778f0c8f1d2b..c4be3d6234fe1 100644 --- a/clients/client-iot/commands/ListTagsForResourceCommand.ts +++ b/clients/client-iot/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags (metadata) you have assigned to the resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListTargetsForPolicyCommand.ts b/clients/client-iot/commands/ListTargetsForPolicyCommand.ts index 545554563d65e..ae658edff830d 100644 --- a/clients/client-iot/commands/ListTargetsForPolicyCommand.ts +++ b/clients/client-iot/commands/ListTargetsForPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type ListTargetsForPolicyCommandInput = ListTargetsForPolicyRequest; export type ListTargetsForPolicyCommandOutput = ListTargetsForPolicyResponse & __MetadataBearer; +/** + *

List targets for the specified policy.

+ */ export class ListTargetsForPolicyCommand extends $Command< ListTargetsForPolicyCommandInput, ListTargetsForPolicyCommandOutput, @@ -34,6 +37,9 @@ export class ListTargetsForPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListTargetsForSecurityProfileCommand.ts b/clients/client-iot/commands/ListTargetsForSecurityProfileCommand.ts index ebd6a1b38a817..fdfeaf8b9d550 100644 --- a/clients/client-iot/commands/ListTargetsForSecurityProfileCommand.ts +++ b/clients/client-iot/commands/ListTargetsForSecurityProfileCommand.ts @@ -20,6 +20,9 @@ import { export type ListTargetsForSecurityProfileCommandInput = ListTargetsForSecurityProfileRequest; export type ListTargetsForSecurityProfileCommandOutput = ListTargetsForSecurityProfileResponse & __MetadataBearer; +/** + *

Lists the targets (thing groups) associated with a given Device Defender security profile.

+ */ export class ListTargetsForSecurityProfileCommand extends $Command< ListTargetsForSecurityProfileCommandInput, ListTargetsForSecurityProfileCommandOutput, @@ -34,6 +37,9 @@ export class ListTargetsForSecurityProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingGroupsCommand.ts b/clients/client-iot/commands/ListThingGroupsCommand.ts index 90c10b7def77f..6c7fe9a166189 100644 --- a/clients/client-iot/commands/ListThingGroupsCommand.ts +++ b/clients/client-iot/commands/ListThingGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListThingGroupsCommandInput = ListThingGroupsRequest; export type ListThingGroupsCommandOutput = ListThingGroupsResponse & __MetadataBearer; +/** + *

List the thing groups in your account.

+ */ export class ListThingGroupsCommand extends $Command< ListThingGroupsCommandInput, ListThingGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListThingGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingGroupsForThingCommand.ts b/clients/client-iot/commands/ListThingGroupsForThingCommand.ts index 62ac7fe579f65..fc19a1ae6a058 100644 --- a/clients/client-iot/commands/ListThingGroupsForThingCommand.ts +++ b/clients/client-iot/commands/ListThingGroupsForThingCommand.ts @@ -20,6 +20,9 @@ import { export type ListThingGroupsForThingCommandInput = ListThingGroupsForThingRequest; export type ListThingGroupsForThingCommandOutput = ListThingGroupsForThingResponse & __MetadataBearer; +/** + *

List the thing groups to which the specified thing belongs.

+ */ export class ListThingGroupsForThingCommand extends $Command< ListThingGroupsForThingCommandInput, ListThingGroupsForThingCommandOutput, @@ -34,6 +37,9 @@ export class ListThingGroupsForThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingPrincipalsCommand.ts b/clients/client-iot/commands/ListThingPrincipalsCommand.ts index ffa17f1bcaa11..29fe3eef4acd7 100644 --- a/clients/client-iot/commands/ListThingPrincipalsCommand.ts +++ b/clients/client-iot/commands/ListThingPrincipalsCommand.ts @@ -20,6 +20,11 @@ import { export type ListThingPrincipalsCommandInput = ListThingPrincipalsRequest; export type ListThingPrincipalsCommandOutput = ListThingPrincipalsResponse & __MetadataBearer; +/** + *

Lists the principals associated with the specified thing. A principal can be X.509 + * certificates, IAM users, groups, and roles, Amazon Cognito identities or federated + * identities.

+ */ export class ListThingPrincipalsCommand extends $Command< ListThingPrincipalsCommandInput, ListThingPrincipalsCommandOutput, @@ -34,6 +39,9 @@ export class ListThingPrincipalsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingRegistrationTaskReportsCommand.ts b/clients/client-iot/commands/ListThingRegistrationTaskReportsCommand.ts index 3188ebb6d4016..0cd13dccf1e0c 100644 --- a/clients/client-iot/commands/ListThingRegistrationTaskReportsCommand.ts +++ b/clients/client-iot/commands/ListThingRegistrationTaskReportsCommand.ts @@ -20,6 +20,9 @@ import { export type ListThingRegistrationTaskReportsCommandInput = ListThingRegistrationTaskReportsRequest; export type ListThingRegistrationTaskReportsCommandOutput = ListThingRegistrationTaskReportsResponse & __MetadataBearer; +/** + *

Information about the thing registration tasks.

+ */ export class ListThingRegistrationTaskReportsCommand extends $Command< ListThingRegistrationTaskReportsCommandInput, ListThingRegistrationTaskReportsCommandOutput, @@ -34,6 +37,9 @@ export class ListThingRegistrationTaskReportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingRegistrationTasksCommand.ts b/clients/client-iot/commands/ListThingRegistrationTasksCommand.ts index a43717fad9fe0..b8c50901233e9 100644 --- a/clients/client-iot/commands/ListThingRegistrationTasksCommand.ts +++ b/clients/client-iot/commands/ListThingRegistrationTasksCommand.ts @@ -20,6 +20,9 @@ import { export type ListThingRegistrationTasksCommandInput = ListThingRegistrationTasksRequest; export type ListThingRegistrationTasksCommandOutput = ListThingRegistrationTasksResponse & __MetadataBearer; +/** + *

List bulk thing provisioning tasks.

+ */ export class ListThingRegistrationTasksCommand extends $Command< ListThingRegistrationTasksCommandInput, ListThingRegistrationTasksCommandOutput, @@ -34,6 +37,9 @@ export class ListThingRegistrationTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingTypesCommand.ts b/clients/client-iot/commands/ListThingTypesCommand.ts index 8bca32772752b..75f900233cd1b 100644 --- a/clients/client-iot/commands/ListThingTypesCommand.ts +++ b/clients/client-iot/commands/ListThingTypesCommand.ts @@ -20,6 +20,9 @@ import { export type ListThingTypesCommandInput = ListThingTypesRequest; export type ListThingTypesCommandOutput = ListThingTypesResponse & __MetadataBearer; +/** + *

Lists the existing thing types.

+ */ export class ListThingTypesCommand extends $Command< ListThingTypesCommandInput, ListThingTypesCommandOutput, @@ -34,6 +37,9 @@ export class ListThingTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingsCommand.ts b/clients/client-iot/commands/ListThingsCommand.ts index 60f137f788a8b..30528e3ca962b 100644 --- a/clients/client-iot/commands/ListThingsCommand.ts +++ b/clients/client-iot/commands/ListThingsCommand.ts @@ -20,6 +20,16 @@ import { export type ListThingsCommandInput = ListThingsRequest; export type ListThingsCommandOutput = ListThingsResponse & __MetadataBearer; +/** + *

Lists your things. Use the attributeName and + * attributeValue parameters to filter your things. + * For example, calling ListThings with attributeName=Color and + * attributeValue=Red retrieves all things in the registry that contain an attribute + * Color with the value Red.

+ * + *

You will not be charged for calling this API if an Access denied error is returned. You will also not be charged if no attributes or pagination token was provided in request and no pagination token and no results were returned.

+ *
+ */ export class ListThingsCommand extends $Command< ListThingsCommandInput, ListThingsCommandOutput, @@ -34,6 +44,9 @@ export class ListThingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingsInBillingGroupCommand.ts b/clients/client-iot/commands/ListThingsInBillingGroupCommand.ts index 46e175cc4ccf8..58f24b93532c4 100644 --- a/clients/client-iot/commands/ListThingsInBillingGroupCommand.ts +++ b/clients/client-iot/commands/ListThingsInBillingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ListThingsInBillingGroupCommandInput = ListThingsInBillingGroupRequest; export type ListThingsInBillingGroupCommandOutput = ListThingsInBillingGroupResponse & __MetadataBearer; +/** + *

Lists the things you have added to the given billing group.

+ */ export class ListThingsInBillingGroupCommand extends $Command< ListThingsInBillingGroupCommandInput, ListThingsInBillingGroupCommandOutput, @@ -34,6 +37,9 @@ export class ListThingsInBillingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListThingsInThingGroupCommand.ts b/clients/client-iot/commands/ListThingsInThingGroupCommand.ts index 412842f3aca17..d4936c4f80969 100644 --- a/clients/client-iot/commands/ListThingsInThingGroupCommand.ts +++ b/clients/client-iot/commands/ListThingsInThingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ListThingsInThingGroupCommandInput = ListThingsInThingGroupRequest; export type ListThingsInThingGroupCommandOutput = ListThingsInThingGroupResponse & __MetadataBearer; +/** + *

Lists the things in the specified group.

+ */ export class ListThingsInThingGroupCommand extends $Command< ListThingsInThingGroupCommandInput, ListThingsInThingGroupCommandOutput, @@ -34,6 +37,9 @@ export class ListThingsInThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListTopicRuleDestinationsCommand.ts b/clients/client-iot/commands/ListTopicRuleDestinationsCommand.ts index 696093a54227f..2ffdc85eed47a 100644 --- a/clients/client-iot/commands/ListTopicRuleDestinationsCommand.ts +++ b/clients/client-iot/commands/ListTopicRuleDestinationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTopicRuleDestinationsCommandInput = ListTopicRuleDestinationsRequest; export type ListTopicRuleDestinationsCommandOutput = ListTopicRuleDestinationsResponse & __MetadataBearer; +/** + *

Lists all the topic rule destinations in your AWS account.

+ */ export class ListTopicRuleDestinationsCommand extends $Command< ListTopicRuleDestinationsCommandInput, ListTopicRuleDestinationsCommandOutput, @@ -34,6 +37,9 @@ export class ListTopicRuleDestinationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListTopicRulesCommand.ts b/clients/client-iot/commands/ListTopicRulesCommand.ts index 1016583d3f56e..ce2d2897d5aaf 100644 --- a/clients/client-iot/commands/ListTopicRulesCommand.ts +++ b/clients/client-iot/commands/ListTopicRulesCommand.ts @@ -20,6 +20,9 @@ import { export type ListTopicRulesCommandInput = ListTopicRulesRequest; export type ListTopicRulesCommandOutput = ListTopicRulesResponse & __MetadataBearer; +/** + *

Lists the rules for the specific topic.

+ */ export class ListTopicRulesCommand extends $Command< ListTopicRulesCommandInput, ListTopicRulesCommandOutput, @@ -34,6 +37,9 @@ export class ListTopicRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListV2LoggingLevelsCommand.ts b/clients/client-iot/commands/ListV2LoggingLevelsCommand.ts index 0c44a19d9987d..a113d2311c684 100644 --- a/clients/client-iot/commands/ListV2LoggingLevelsCommand.ts +++ b/clients/client-iot/commands/ListV2LoggingLevelsCommand.ts @@ -20,6 +20,9 @@ import { export type ListV2LoggingLevelsCommandInput = ListV2LoggingLevelsRequest; export type ListV2LoggingLevelsCommandOutput = ListV2LoggingLevelsResponse & __MetadataBearer; +/** + *

Lists logging levels.

+ */ export class ListV2LoggingLevelsCommand extends $Command< ListV2LoggingLevelsCommandInput, ListV2LoggingLevelsCommandOutput, @@ -34,6 +37,9 @@ export class ListV2LoggingLevelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ListViolationEventsCommand.ts b/clients/client-iot/commands/ListViolationEventsCommand.ts index 7aa9027aa1783..e9d1022b3e174 100644 --- a/clients/client-iot/commands/ListViolationEventsCommand.ts +++ b/clients/client-iot/commands/ListViolationEventsCommand.ts @@ -20,6 +20,11 @@ import { export type ListViolationEventsCommandInput = ListViolationEventsRequest; export type ListViolationEventsCommandOutput = ListViolationEventsResponse & __MetadataBearer; +/** + *

Lists the Device Defender security profile violations discovered during the given time period. + * You can use filters to limit the results to those alerts issued for a particular security profile, + * behavior, or thing (device).

+ */ export class ListViolationEventsCommand extends $Command< ListViolationEventsCommandInput, ListViolationEventsCommandOutput, @@ -34,6 +39,9 @@ export class ListViolationEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/RegisterCACertificateCommand.ts b/clients/client-iot/commands/RegisterCACertificateCommand.ts index 96b0f930a2439..f7b09a06f3fb2 100644 --- a/clients/client-iot/commands/RegisterCACertificateCommand.ts +++ b/clients/client-iot/commands/RegisterCACertificateCommand.ts @@ -20,6 +20,14 @@ import { export type RegisterCACertificateCommandInput = RegisterCACertificateRequest; export type RegisterCACertificateCommandOutput = RegisterCACertificateResponse & __MetadataBearer; +/** + *

Registers a CA certificate with AWS IoT. This CA certificate can then be used to sign + * device certificates, which can be then registered with AWS IoT. You can register up to 10 + * CA certificates per AWS account that have the same subject field. This enables you to have + * up to 10 certificate authorities sign your device certificates. If you have more than one + * CA certificate registered, make sure you pass the CA certificate when you register your + * device certificates with the RegisterCertificate API.

+ */ export class RegisterCACertificateCommand extends $Command< RegisterCACertificateCommandInput, RegisterCACertificateCommandOutput, @@ -34,6 +42,9 @@ export class RegisterCACertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/RegisterCertificateCommand.ts b/clients/client-iot/commands/RegisterCertificateCommand.ts index bce4c5b9533cb..1a4e915030540 100644 --- a/clients/client-iot/commands/RegisterCertificateCommand.ts +++ b/clients/client-iot/commands/RegisterCertificateCommand.ts @@ -20,6 +20,11 @@ import { export type RegisterCertificateCommandInput = RegisterCertificateRequest; export type RegisterCertificateCommandOutput = RegisterCertificateResponse & __MetadataBearer; +/** + *

Registers a device certificate with AWS IoT. If you have more than one CA certificate + * that has the same subject field, you must specify the CA certificate that was used to sign + * the device certificate being registered.

+ */ export class RegisterCertificateCommand extends $Command< RegisterCertificateCommandInput, RegisterCertificateCommandOutput, @@ -34,6 +39,9 @@ export class RegisterCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/RegisterCertificateWithoutCACommand.ts b/clients/client-iot/commands/RegisterCertificateWithoutCACommand.ts index b08e9a7494546..1bcb06665cbaa 100644 --- a/clients/client-iot/commands/RegisterCertificateWithoutCACommand.ts +++ b/clients/client-iot/commands/RegisterCertificateWithoutCACommand.ts @@ -20,6 +20,9 @@ import { export type RegisterCertificateWithoutCACommandInput = RegisterCertificateWithoutCARequest; export type RegisterCertificateWithoutCACommandOutput = RegisterCertificateWithoutCAResponse & __MetadataBearer; +/** + *

Register a certificate that does not have a certificate authority (CA).

+ */ export class RegisterCertificateWithoutCACommand extends $Command< RegisterCertificateWithoutCACommandInput, RegisterCertificateWithoutCACommandOutput, @@ -34,6 +37,9 @@ export class RegisterCertificateWithoutCACommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/RegisterThingCommand.ts b/clients/client-iot/commands/RegisterThingCommand.ts index efacbd18a2c4a..57e37b850e150 100644 --- a/clients/client-iot/commands/RegisterThingCommand.ts +++ b/clients/client-iot/commands/RegisterThingCommand.ts @@ -20,6 +20,12 @@ import { export type RegisterThingCommandInput = RegisterThingRequest; export type RegisterThingCommandOutput = RegisterThingResponse & __MetadataBearer; +/** + *

Provisions a thing in the device registry. RegisterThing calls other AWS IoT control + * plane APIs. These calls might exceed your account level + * AWS IoT Throttling Limits and cause throttle errors. Please contact AWS Customer Support to raise + * your throttling limits if necessary.

+ */ export class RegisterThingCommand extends $Command< RegisterThingCommandInput, RegisterThingCommandOutput, @@ -34,6 +40,9 @@ export class RegisterThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/RejectCertificateTransferCommand.ts b/clients/client-iot/commands/RejectCertificateTransferCommand.ts index 3da468d198666..7d5c2ef070185 100644 --- a/clients/client-iot/commands/RejectCertificateTransferCommand.ts +++ b/clients/client-iot/commands/RejectCertificateTransferCommand.ts @@ -20,6 +20,15 @@ import { export type RejectCertificateTransferCommandInput = RejectCertificateTransferRequest; export type RejectCertificateTransferCommandOutput = __MetadataBearer; +/** + *

Rejects a pending certificate transfer. After AWS IoT rejects a certificate transfer, + * the certificate status changes from PENDING_TRANSFER to + * INACTIVE.

+ *

To check for pending certificate transfers, call ListCertificates + * to enumerate your certificates.

+ *

This operation can only be called by the transfer destination. After it is called, + * the certificate will be returned to the source's account in the INACTIVE state.

+ */ export class RejectCertificateTransferCommand extends $Command< RejectCertificateTransferCommandInput, RejectCertificateTransferCommandOutput, @@ -34,6 +43,9 @@ export class RejectCertificateTransferCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/RemoveThingFromBillingGroupCommand.ts b/clients/client-iot/commands/RemoveThingFromBillingGroupCommand.ts index 8e84ebbf57167..34184a8666440 100644 --- a/clients/client-iot/commands/RemoveThingFromBillingGroupCommand.ts +++ b/clients/client-iot/commands/RemoveThingFromBillingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveThingFromBillingGroupCommandInput = RemoveThingFromBillingGroupRequest; export type RemoveThingFromBillingGroupCommandOutput = RemoveThingFromBillingGroupResponse & __MetadataBearer; +/** + *

Removes the given thing from the billing group.

+ */ export class RemoveThingFromBillingGroupCommand extends $Command< RemoveThingFromBillingGroupCommandInput, RemoveThingFromBillingGroupCommandOutput, @@ -34,6 +37,9 @@ export class RemoveThingFromBillingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/RemoveThingFromThingGroupCommand.ts b/clients/client-iot/commands/RemoveThingFromThingGroupCommand.ts index 2cfaca769fb3b..7d12ddb0cc354 100644 --- a/clients/client-iot/commands/RemoveThingFromThingGroupCommand.ts +++ b/clients/client-iot/commands/RemoveThingFromThingGroupCommand.ts @@ -20,6 +20,14 @@ import { export type RemoveThingFromThingGroupCommandInput = RemoveThingFromThingGroupRequest; export type RemoveThingFromThingGroupCommandOutput = RemoveThingFromThingGroupResponse & __MetadataBearer; +/** + *

Remove the specified thing from the specified group.

+ *

You must specify either a thingGroupArn or a + * thingGroupName to identify the thing group and + * either a thingArn or a thingName to + * identify the thing to remove from the thing group. + *

+ */ export class RemoveThingFromThingGroupCommand extends $Command< RemoveThingFromThingGroupCommandInput, RemoveThingFromThingGroupCommandOutput, @@ -34,6 +42,9 @@ export class RemoveThingFromThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ReplaceTopicRuleCommand.ts b/clients/client-iot/commands/ReplaceTopicRuleCommand.ts index 6d343bb7a9d57..1ac362801ccb2 100644 --- a/clients/client-iot/commands/ReplaceTopicRuleCommand.ts +++ b/clients/client-iot/commands/ReplaceTopicRuleCommand.ts @@ -20,6 +20,11 @@ import { export type ReplaceTopicRuleCommandInput = ReplaceTopicRuleRequest; export type ReplaceTopicRuleCommandOutput = __MetadataBearer; +/** + *

Replaces the rule. You must specify all parameters for the new rule. Creating rules + * is an administrator-level action. Any user who has permission to create rules will be able + * to access data processed by the rule.

+ */ export class ReplaceTopicRuleCommand extends $Command< ReplaceTopicRuleCommandInput, ReplaceTopicRuleCommandOutput, @@ -34,6 +39,9 @@ export class ReplaceTopicRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/SearchIndexCommand.ts b/clients/client-iot/commands/SearchIndexCommand.ts index d4d67f860adef..01a9de4bbc199 100644 --- a/clients/client-iot/commands/SearchIndexCommand.ts +++ b/clients/client-iot/commands/SearchIndexCommand.ts @@ -20,6 +20,9 @@ import { export type SearchIndexCommandInput = SearchIndexRequest; export type SearchIndexCommandOutput = SearchIndexResponse & __MetadataBearer; +/** + *

The query search index.

+ */ export class SearchIndexCommand extends $Command< SearchIndexCommandInput, SearchIndexCommandOutput, @@ -34,6 +37,9 @@ export class SearchIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/SetDefaultAuthorizerCommand.ts b/clients/client-iot/commands/SetDefaultAuthorizerCommand.ts index 7ec5c35e69bc1..2a83de20264a2 100644 --- a/clients/client-iot/commands/SetDefaultAuthorizerCommand.ts +++ b/clients/client-iot/commands/SetDefaultAuthorizerCommand.ts @@ -20,6 +20,10 @@ import { export type SetDefaultAuthorizerCommandInput = SetDefaultAuthorizerRequest; export type SetDefaultAuthorizerCommandOutput = SetDefaultAuthorizerResponse & __MetadataBearer; +/** + *

Sets the default authorizer. This will be used if a websocket connection is made + * without specifying an authorizer.

+ */ export class SetDefaultAuthorizerCommand extends $Command< SetDefaultAuthorizerCommandInput, SetDefaultAuthorizerCommandOutput, @@ -34,6 +38,9 @@ export class SetDefaultAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/SetDefaultPolicyVersionCommand.ts b/clients/client-iot/commands/SetDefaultPolicyVersionCommand.ts index a76960e0c38fb..554e5bcf77b24 100644 --- a/clients/client-iot/commands/SetDefaultPolicyVersionCommand.ts +++ b/clients/client-iot/commands/SetDefaultPolicyVersionCommand.ts @@ -20,6 +20,12 @@ import { export type SetDefaultPolicyVersionCommandInput = SetDefaultPolicyVersionRequest; export type SetDefaultPolicyVersionCommandOutput = __MetadataBearer; +/** + *

Sets the specified version of the specified policy as the policy's default + * (operative) version. This action affects all certificates to which the policy is attached. + * To list the principals the policy is attached to, use the ListPrincipalPolicy + * API.

+ */ export class SetDefaultPolicyVersionCommand extends $Command< SetDefaultPolicyVersionCommandInput, SetDefaultPolicyVersionCommandOutput, @@ -34,6 +40,9 @@ export class SetDefaultPolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/SetLoggingOptionsCommand.ts b/clients/client-iot/commands/SetLoggingOptionsCommand.ts index b2c5d243ef178..c40fddaf302e9 100644 --- a/clients/client-iot/commands/SetLoggingOptionsCommand.ts +++ b/clients/client-iot/commands/SetLoggingOptionsCommand.ts @@ -20,6 +20,11 @@ import { export type SetLoggingOptionsCommandInput = SetLoggingOptionsRequest; export type SetLoggingOptionsCommandOutput = __MetadataBearer; +/** + *

Sets the logging options.

+ *

NOTE: use of this command is not recommended. Use SetV2LoggingOptions + * instead.

+ */ export class SetLoggingOptionsCommand extends $Command< SetLoggingOptionsCommandInput, SetLoggingOptionsCommandOutput, @@ -34,6 +39,9 @@ export class SetLoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/SetV2LoggingLevelCommand.ts b/clients/client-iot/commands/SetV2LoggingLevelCommand.ts index 43bcc1bbfab52..b6a33ef50a4f7 100644 --- a/clients/client-iot/commands/SetV2LoggingLevelCommand.ts +++ b/clients/client-iot/commands/SetV2LoggingLevelCommand.ts @@ -20,6 +20,9 @@ import { export type SetV2LoggingLevelCommandInput = SetV2LoggingLevelRequest; export type SetV2LoggingLevelCommandOutput = __MetadataBearer; +/** + *

Sets the logging level.

+ */ export class SetV2LoggingLevelCommand extends $Command< SetV2LoggingLevelCommandInput, SetV2LoggingLevelCommandOutput, @@ -34,6 +37,9 @@ export class SetV2LoggingLevelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/SetV2LoggingOptionsCommand.ts b/clients/client-iot/commands/SetV2LoggingOptionsCommand.ts index 738110af5de7d..5aec8337b930c 100644 --- a/clients/client-iot/commands/SetV2LoggingOptionsCommand.ts +++ b/clients/client-iot/commands/SetV2LoggingOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type SetV2LoggingOptionsCommandInput = SetV2LoggingOptionsRequest; export type SetV2LoggingOptionsCommandOutput = __MetadataBearer; +/** + *

Sets the logging options for the V2 logging service.

+ */ export class SetV2LoggingOptionsCommand extends $Command< SetV2LoggingOptionsCommandInput, SetV2LoggingOptionsCommandOutput, @@ -34,6 +37,9 @@ export class SetV2LoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/StartAuditMitigationActionsTaskCommand.ts b/clients/client-iot/commands/StartAuditMitigationActionsTaskCommand.ts index ee0cede0b7d47..002e9a8929e12 100644 --- a/clients/client-iot/commands/StartAuditMitigationActionsTaskCommand.ts +++ b/clients/client-iot/commands/StartAuditMitigationActionsTaskCommand.ts @@ -20,6 +20,9 @@ import { export type StartAuditMitigationActionsTaskCommandInput = StartAuditMitigationActionsTaskRequest; export type StartAuditMitigationActionsTaskCommandOutput = StartAuditMitigationActionsTaskResponse & __MetadataBearer; +/** + *

Starts a task that applies a set of mitigation actions to the specified target.

+ */ export class StartAuditMitigationActionsTaskCommand extends $Command< StartAuditMitigationActionsTaskCommandInput, StartAuditMitigationActionsTaskCommandOutput, @@ -34,6 +37,9 @@ export class StartAuditMitigationActionsTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/StartOnDemandAuditTaskCommand.ts b/clients/client-iot/commands/StartOnDemandAuditTaskCommand.ts index 65776cefc7563..fc451b8ca0622 100644 --- a/clients/client-iot/commands/StartOnDemandAuditTaskCommand.ts +++ b/clients/client-iot/commands/StartOnDemandAuditTaskCommand.ts @@ -20,6 +20,9 @@ import { export type StartOnDemandAuditTaskCommandInput = StartOnDemandAuditTaskRequest; export type StartOnDemandAuditTaskCommandOutput = StartOnDemandAuditTaskResponse & __MetadataBearer; +/** + *

Starts an on-demand Device Defender audit.

+ */ export class StartOnDemandAuditTaskCommand extends $Command< StartOnDemandAuditTaskCommandInput, StartOnDemandAuditTaskCommandOutput, @@ -34,6 +37,9 @@ export class StartOnDemandAuditTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/StartThingRegistrationTaskCommand.ts b/clients/client-iot/commands/StartThingRegistrationTaskCommand.ts index b3174fff07b3f..3c6a03855932a 100644 --- a/clients/client-iot/commands/StartThingRegistrationTaskCommand.ts +++ b/clients/client-iot/commands/StartThingRegistrationTaskCommand.ts @@ -20,6 +20,9 @@ import { export type StartThingRegistrationTaskCommandInput = StartThingRegistrationTaskRequest; export type StartThingRegistrationTaskCommandOutput = StartThingRegistrationTaskResponse & __MetadataBearer; +/** + *

Creates a bulk thing provisioning task.

+ */ export class StartThingRegistrationTaskCommand extends $Command< StartThingRegistrationTaskCommandInput, StartThingRegistrationTaskCommandOutput, @@ -34,6 +37,9 @@ export class StartThingRegistrationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/StopThingRegistrationTaskCommand.ts b/clients/client-iot/commands/StopThingRegistrationTaskCommand.ts index 5111905c00ae6..3055d1037b0df 100644 --- a/clients/client-iot/commands/StopThingRegistrationTaskCommand.ts +++ b/clients/client-iot/commands/StopThingRegistrationTaskCommand.ts @@ -20,6 +20,9 @@ import { export type StopThingRegistrationTaskCommandInput = StopThingRegistrationTaskRequest; export type StopThingRegistrationTaskCommandOutput = StopThingRegistrationTaskResponse & __MetadataBearer; +/** + *

Cancels a bulk thing provisioning task.

+ */ export class StopThingRegistrationTaskCommand extends $Command< StopThingRegistrationTaskCommandInput, StopThingRegistrationTaskCommandOutput, @@ -34,6 +37,9 @@ export class StopThingRegistrationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/TagResourceCommand.ts b/clients/client-iot/commands/TagResourceCommand.ts index 73618303a19ef..4e33890f6f011 100644 --- a/clients/client-iot/commands/TagResourceCommand.ts +++ b/clients/client-iot/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds to or modifies the tags of the given resource. Tags are metadata which can be + * used to manage a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/TestAuthorizationCommand.ts b/clients/client-iot/commands/TestAuthorizationCommand.ts index e213efdbe0b10..1f2ac98fdbe23 100644 --- a/clients/client-iot/commands/TestAuthorizationCommand.ts +++ b/clients/client-iot/commands/TestAuthorizationCommand.ts @@ -20,6 +20,11 @@ import { export type TestAuthorizationCommandInput = TestAuthorizationRequest; export type TestAuthorizationCommandOutput = TestAuthorizationResponse & __MetadataBearer; +/** + *

Tests if a specified principal is authorized to perform an AWS IoT action on a + * specified resource. Use this to test and debug the authorization behavior of devices that + * connect to the AWS IoT device gateway.

+ */ export class TestAuthorizationCommand extends $Command< TestAuthorizationCommandInput, TestAuthorizationCommandOutput, @@ -34,6 +39,9 @@ export class TestAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/TestInvokeAuthorizerCommand.ts b/clients/client-iot/commands/TestInvokeAuthorizerCommand.ts index bd2b57816a958..5994dc313f912 100644 --- a/clients/client-iot/commands/TestInvokeAuthorizerCommand.ts +++ b/clients/client-iot/commands/TestInvokeAuthorizerCommand.ts @@ -20,6 +20,11 @@ import { export type TestInvokeAuthorizerCommandInput = TestInvokeAuthorizerRequest; export type TestInvokeAuthorizerCommandOutput = TestInvokeAuthorizerResponse & __MetadataBearer; +/** + *

Tests a custom authorization behavior by invoking a specified custom authorizer. Use + * this to test and debug the custom authorization behavior of devices that connect to the AWS + * IoT device gateway.

+ */ export class TestInvokeAuthorizerCommand extends $Command< TestInvokeAuthorizerCommandInput, TestInvokeAuthorizerCommandOutput, @@ -34,6 +39,9 @@ export class TestInvokeAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/TransferCertificateCommand.ts b/clients/client-iot/commands/TransferCertificateCommand.ts index 62734a1fdd3d0..6971c075e6c3b 100644 --- a/clients/client-iot/commands/TransferCertificateCommand.ts +++ b/clients/client-iot/commands/TransferCertificateCommand.ts @@ -20,6 +20,16 @@ import { export type TransferCertificateCommandInput = TransferCertificateRequest; export type TransferCertificateCommandOutput = TransferCertificateResponse & __MetadataBearer; +/** + *

Transfers the specified certificate to the specified AWS account.

+ *

You can cancel the transfer until it is acknowledged by the recipient.

+ *

No notification is sent to the transfer destination's account. It is up to the caller + * to notify the transfer target.

+ *

The certificate being transferred must not be in the ACTIVE state. You can use the + * UpdateCertificate API to deactivate it.

+ *

The certificate must not have any policies attached to it. You can use the + * DetachPrincipalPolicy API to detach them.

+ */ export class TransferCertificateCommand extends $Command< TransferCertificateCommandInput, TransferCertificateCommandOutput, @@ -34,6 +44,9 @@ export class TransferCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UntagResourceCommand.ts b/clients/client-iot/commands/UntagResourceCommand.ts index 324ce76665f6d..b4b9227ea1543 100644 --- a/clients/client-iot/commands/UntagResourceCommand.ts +++ b/clients/client-iot/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the given tags (metadata) from the resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateAccountAuditConfigurationCommand.ts b/clients/client-iot/commands/UpdateAccountAuditConfigurationCommand.ts index ad88528607f4b..b478184e08a65 100644 --- a/clients/client-iot/commands/UpdateAccountAuditConfigurationCommand.ts +++ b/clients/client-iot/commands/UpdateAccountAuditConfigurationCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateAccountAuditConfigurationCommandInput = UpdateAccountAuditConfigurationRequest; export type UpdateAccountAuditConfigurationCommandOutput = UpdateAccountAuditConfigurationResponse & __MetadataBearer; +/** + *

Configures or reconfigures the Device Defender audit settings for this account. + * Settings include how audit notifications are sent and which audit checks are + * enabled or disabled.

+ */ export class UpdateAccountAuditConfigurationCommand extends $Command< UpdateAccountAuditConfigurationCommandInput, UpdateAccountAuditConfigurationCommandOutput, @@ -34,6 +39,9 @@ export class UpdateAccountAuditConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateAuditSuppressionCommand.ts b/clients/client-iot/commands/UpdateAuditSuppressionCommand.ts index 8f87a487d10a5..9aef512b9d8b2 100644 --- a/clients/client-iot/commands/UpdateAuditSuppressionCommand.ts +++ b/clients/client-iot/commands/UpdateAuditSuppressionCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateAuditSuppressionCommandInput = UpdateAuditSuppressionRequest; export type UpdateAuditSuppressionCommandOutput = UpdateAuditSuppressionResponse & __MetadataBearer; +/** + *

+ * Updates a Device Defender audit suppression. + *

+ */ export class UpdateAuditSuppressionCommand extends $Command< UpdateAuditSuppressionCommandInput, UpdateAuditSuppressionCommandOutput, @@ -34,6 +39,9 @@ export class UpdateAuditSuppressionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateAuthorizerCommand.ts b/clients/client-iot/commands/UpdateAuthorizerCommand.ts index 41067e734ff37..18b59f5b45494 100644 --- a/clients/client-iot/commands/UpdateAuthorizerCommand.ts +++ b/clients/client-iot/commands/UpdateAuthorizerCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAuthorizerCommandInput = UpdateAuthorizerRequest; export type UpdateAuthorizerCommandOutput = UpdateAuthorizerResponse & __MetadataBearer; +/** + *

Updates an authorizer.

+ */ export class UpdateAuthorizerCommand extends $Command< UpdateAuthorizerCommandInput, UpdateAuthorizerCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAuthorizerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateBillingGroupCommand.ts b/clients/client-iot/commands/UpdateBillingGroupCommand.ts index c434f72b2e0ed..97c7288da9e7a 100644 --- a/clients/client-iot/commands/UpdateBillingGroupCommand.ts +++ b/clients/client-iot/commands/UpdateBillingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateBillingGroupCommandInput = UpdateBillingGroupRequest; export type UpdateBillingGroupCommandOutput = UpdateBillingGroupResponse & __MetadataBearer; +/** + *

Updates information about the billing group.

+ */ export class UpdateBillingGroupCommand extends $Command< UpdateBillingGroupCommandInput, UpdateBillingGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateBillingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateCACertificateCommand.ts b/clients/client-iot/commands/UpdateCACertificateCommand.ts index 78e70219d9778..a91063a6ef196 100644 --- a/clients/client-iot/commands/UpdateCACertificateCommand.ts +++ b/clients/client-iot/commands/UpdateCACertificateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateCACertificateCommandInput = UpdateCACertificateRequest; export type UpdateCACertificateCommandOutput = __MetadataBearer; +/** + *

Updates a registered CA certificate.

+ */ export class UpdateCACertificateCommand extends $Command< UpdateCACertificateCommandInput, UpdateCACertificateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateCACertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateCertificateCommand.ts b/clients/client-iot/commands/UpdateCertificateCommand.ts index f0373ee40f24f..87c6bdc2ae8c4 100644 --- a/clients/client-iot/commands/UpdateCertificateCommand.ts +++ b/clients/client-iot/commands/UpdateCertificateCommand.ts @@ -20,6 +20,15 @@ import { export type UpdateCertificateCommandInput = UpdateCertificateRequest; export type UpdateCertificateCommandOutput = __MetadataBearer; +/** + *

Updates the status of the specified certificate. This operation is + * idempotent.

+ *

Certificates must be in the ACTIVE state to authenticate devices that use + * a certificate to connect to AWS IoT.

+ *

Within a few minutes of updating a certificate from the ACTIVE state to any other + * state, AWS IoT disconnects all devices that used that certificate to connect. Devices cannot + * use a certificate that is not in the ACTIVE state to reconnect.

+ */ export class UpdateCertificateCommand extends $Command< UpdateCertificateCommandInput, UpdateCertificateCommandOutput, @@ -34,6 +43,9 @@ export class UpdateCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateDimensionCommand.ts b/clients/client-iot/commands/UpdateDimensionCommand.ts index a61800378b455..3f428e0efa582 100644 --- a/clients/client-iot/commands/UpdateDimensionCommand.ts +++ b/clients/client-iot/commands/UpdateDimensionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDimensionCommandInput = UpdateDimensionRequest; export type UpdateDimensionCommandOutput = UpdateDimensionResponse & __MetadataBearer; +/** + *

Updates the definition for a dimension. You cannot change the type of a dimension after it is created (you can delete it and re-create it).

+ */ export class UpdateDimensionCommand extends $Command< UpdateDimensionCommandInput, UpdateDimensionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDimensionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateDomainConfigurationCommand.ts b/clients/client-iot/commands/UpdateDomainConfigurationCommand.ts index 8430b74b65fb8..8eeac086bd751 100644 --- a/clients/client-iot/commands/UpdateDomainConfigurationCommand.ts +++ b/clients/client-iot/commands/UpdateDomainConfigurationCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateDomainConfigurationCommandInput = UpdateDomainConfigurationRequest; export type UpdateDomainConfigurationCommandOutput = UpdateDomainConfigurationResponse & __MetadataBearer; +/** + *

Updates values stored in the domain configuration. Domain configurations for default endpoints can't be updated.

+ * + *

The domain configuration feature is in public preview and is subject to change.

+ *
+ */ export class UpdateDomainConfigurationCommand extends $Command< UpdateDomainConfigurationCommandInput, UpdateDomainConfigurationCommandOutput, @@ -34,6 +40,9 @@ export class UpdateDomainConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateDynamicThingGroupCommand.ts b/clients/client-iot/commands/UpdateDynamicThingGroupCommand.ts index 2b243d6969c37..ce10c5bdc85ca 100644 --- a/clients/client-iot/commands/UpdateDynamicThingGroupCommand.ts +++ b/clients/client-iot/commands/UpdateDynamicThingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDynamicThingGroupCommandInput = UpdateDynamicThingGroupRequest; export type UpdateDynamicThingGroupCommandOutput = UpdateDynamicThingGroupResponse & __MetadataBearer; +/** + *

Updates a dynamic thing group.

+ */ export class UpdateDynamicThingGroupCommand extends $Command< UpdateDynamicThingGroupCommandInput, UpdateDynamicThingGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDynamicThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateEventConfigurationsCommand.ts b/clients/client-iot/commands/UpdateEventConfigurationsCommand.ts index b2cdab67cbd41..59c5abce456e7 100644 --- a/clients/client-iot/commands/UpdateEventConfigurationsCommand.ts +++ b/clients/client-iot/commands/UpdateEventConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEventConfigurationsCommandInput = UpdateEventConfigurationsRequest; export type UpdateEventConfigurationsCommandOutput = UpdateEventConfigurationsResponse & __MetadataBearer; +/** + *

Updates the event configurations.

+ */ export class UpdateEventConfigurationsCommand extends $Command< UpdateEventConfigurationsCommandInput, UpdateEventConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEventConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateIndexingConfigurationCommand.ts b/clients/client-iot/commands/UpdateIndexingConfigurationCommand.ts index 1d76528fbc873..4b7d2c7e83ca8 100644 --- a/clients/client-iot/commands/UpdateIndexingConfigurationCommand.ts +++ b/clients/client-iot/commands/UpdateIndexingConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateIndexingConfigurationCommandInput = UpdateIndexingConfigurationRequest; export type UpdateIndexingConfigurationCommandOutput = UpdateIndexingConfigurationResponse & __MetadataBearer; +/** + *

Updates the search configuration.

+ */ export class UpdateIndexingConfigurationCommand extends $Command< UpdateIndexingConfigurationCommandInput, UpdateIndexingConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateIndexingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateJobCommand.ts b/clients/client-iot/commands/UpdateJobCommand.ts index a7e2c30075fbc..d99e5099b04c6 100644 --- a/clients/client-iot/commands/UpdateJobCommand.ts +++ b/clients/client-iot/commands/UpdateJobCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateJobCommandInput = UpdateJobRequest; export type UpdateJobCommandOutput = __MetadataBearer; +/** + *

Updates supported fields of the specified job.

+ */ export class UpdateJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class UpdateJobCommand extends $Command, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateMitigationActionCommand.ts b/clients/client-iot/commands/UpdateMitigationActionCommand.ts index 4d3b3cdfeab29..3abf2820b22b9 100644 --- a/clients/client-iot/commands/UpdateMitigationActionCommand.ts +++ b/clients/client-iot/commands/UpdateMitigationActionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMitigationActionCommandInput = UpdateMitigationActionRequest; export type UpdateMitigationActionCommandOutput = UpdateMitigationActionResponse & __MetadataBearer; +/** + *

Updates the definition for the specified mitigation action.

+ */ export class UpdateMitigationActionCommand extends $Command< UpdateMitigationActionCommandInput, UpdateMitigationActionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMitigationActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateProvisioningTemplateCommand.ts b/clients/client-iot/commands/UpdateProvisioningTemplateCommand.ts index 658e4322086d0..2400be1072e06 100644 --- a/clients/client-iot/commands/UpdateProvisioningTemplateCommand.ts +++ b/clients/client-iot/commands/UpdateProvisioningTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProvisioningTemplateCommandInput = UpdateProvisioningTemplateRequest; export type UpdateProvisioningTemplateCommandOutput = UpdateProvisioningTemplateResponse & __MetadataBearer; +/** + *

Updates a fleet provisioning template.

+ */ export class UpdateProvisioningTemplateCommand extends $Command< UpdateProvisioningTemplateCommandInput, UpdateProvisioningTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProvisioningTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateRoleAliasCommand.ts b/clients/client-iot/commands/UpdateRoleAliasCommand.ts index fdb1fc045b0da..94fe68c76c68d 100644 --- a/clients/client-iot/commands/UpdateRoleAliasCommand.ts +++ b/clients/client-iot/commands/UpdateRoleAliasCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRoleAliasCommandInput = UpdateRoleAliasRequest; export type UpdateRoleAliasCommandOutput = UpdateRoleAliasResponse & __MetadataBearer; +/** + *

Updates a role alias.

+ */ export class UpdateRoleAliasCommand extends $Command< UpdateRoleAliasCommandInput, UpdateRoleAliasCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRoleAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateScheduledAuditCommand.ts b/clients/client-iot/commands/UpdateScheduledAuditCommand.ts index 84ddcc4dc79d8..fbbe7bdc0c8c4 100644 --- a/clients/client-iot/commands/UpdateScheduledAuditCommand.ts +++ b/clients/client-iot/commands/UpdateScheduledAuditCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateScheduledAuditCommandInput = UpdateScheduledAuditRequest; export type UpdateScheduledAuditCommandOutput = UpdateScheduledAuditResponse & __MetadataBearer; +/** + *

Updates a scheduled audit, including which checks are performed and + * how often the audit takes place.

+ */ export class UpdateScheduledAuditCommand extends $Command< UpdateScheduledAuditCommandInput, UpdateScheduledAuditCommandOutput, @@ -34,6 +38,9 @@ export class UpdateScheduledAuditCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateSecurityProfileCommand.ts b/clients/client-iot/commands/UpdateSecurityProfileCommand.ts index 48876f9d997b7..cde75a33638aa 100644 --- a/clients/client-iot/commands/UpdateSecurityProfileCommand.ts +++ b/clients/client-iot/commands/UpdateSecurityProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSecurityProfileCommandInput = UpdateSecurityProfileRequest; export type UpdateSecurityProfileCommandOutput = UpdateSecurityProfileResponse & __MetadataBearer; +/** + *

Updates a Device Defender security profile.

+ */ export class UpdateSecurityProfileCommand extends $Command< UpdateSecurityProfileCommandInput, UpdateSecurityProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSecurityProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateStreamCommand.ts b/clients/client-iot/commands/UpdateStreamCommand.ts index 1dde035a0a810..fa75a7b077471 100644 --- a/clients/client-iot/commands/UpdateStreamCommand.ts +++ b/clients/client-iot/commands/UpdateStreamCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateStreamCommandInput = UpdateStreamRequest; export type UpdateStreamCommandOutput = UpdateStreamResponse & __MetadataBearer; +/** + *

Updates an existing stream. The stream version will be incremented by one.

+ */ export class UpdateStreamCommand extends $Command< UpdateStreamCommandInput, UpdateStreamCommandOutput, @@ -34,6 +37,9 @@ export class UpdateStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateThingCommand.ts b/clients/client-iot/commands/UpdateThingCommand.ts index 79aa63ebf33fb..22eae234330c1 100644 --- a/clients/client-iot/commands/UpdateThingCommand.ts +++ b/clients/client-iot/commands/UpdateThingCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateThingCommandInput = UpdateThingRequest; export type UpdateThingCommandOutput = UpdateThingResponse & __MetadataBearer; +/** + *

Updates the data for a thing.

+ */ export class UpdateThingCommand extends $Command< UpdateThingCommandInput, UpdateThingCommandOutput, @@ -34,6 +37,9 @@ export class UpdateThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateThingGroupCommand.ts b/clients/client-iot/commands/UpdateThingGroupCommand.ts index 2ed49e0537770..4e67857b41f3b 100644 --- a/clients/client-iot/commands/UpdateThingGroupCommand.ts +++ b/clients/client-iot/commands/UpdateThingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateThingGroupCommandInput = UpdateThingGroupRequest; export type UpdateThingGroupCommandOutput = UpdateThingGroupResponse & __MetadataBearer; +/** + *

Update a thing group.

+ */ export class UpdateThingGroupCommand extends $Command< UpdateThingGroupCommandInput, UpdateThingGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateThingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateThingGroupsForThingCommand.ts b/clients/client-iot/commands/UpdateThingGroupsForThingCommand.ts index 83ab61254c980..df644974c80cd 100644 --- a/clients/client-iot/commands/UpdateThingGroupsForThingCommand.ts +++ b/clients/client-iot/commands/UpdateThingGroupsForThingCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateThingGroupsForThingCommandInput = UpdateThingGroupsForThingRequest; export type UpdateThingGroupsForThingCommandOutput = UpdateThingGroupsForThingResponse & __MetadataBearer; +/** + *

Updates the groups to which the thing belongs.

+ */ export class UpdateThingGroupsForThingCommand extends $Command< UpdateThingGroupsForThingCommandInput, UpdateThingGroupsForThingCommandOutput, @@ -34,6 +37,9 @@ export class UpdateThingGroupsForThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/UpdateTopicRuleDestinationCommand.ts b/clients/client-iot/commands/UpdateTopicRuleDestinationCommand.ts index ff59dd34d7c99..b342ee82adf35 100644 --- a/clients/client-iot/commands/UpdateTopicRuleDestinationCommand.ts +++ b/clients/client-iot/commands/UpdateTopicRuleDestinationCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateTopicRuleDestinationCommandInput = UpdateTopicRuleDestinationRequest; export type UpdateTopicRuleDestinationCommandOutput = UpdateTopicRuleDestinationResponse & __MetadataBearer; +/** + *

Updates a topic rule destination. You use this to change the status, endpoint URL, or + * confirmation URL of the destination.

+ */ export class UpdateTopicRuleDestinationCommand extends $Command< UpdateTopicRuleDestinationCommandInput, UpdateTopicRuleDestinationCommandOutput, @@ -34,6 +38,9 @@ export class UpdateTopicRuleDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/commands/ValidateSecurityProfileBehaviorsCommand.ts b/clients/client-iot/commands/ValidateSecurityProfileBehaviorsCommand.ts index 805ec02ef6ae8..bf18e5ee8fdd6 100644 --- a/clients/client-iot/commands/ValidateSecurityProfileBehaviorsCommand.ts +++ b/clients/client-iot/commands/ValidateSecurityProfileBehaviorsCommand.ts @@ -20,6 +20,9 @@ import { export type ValidateSecurityProfileBehaviorsCommandInput = ValidateSecurityProfileBehaviorsRequest; export type ValidateSecurityProfileBehaviorsCommandOutput = ValidateSecurityProfileBehaviorsResponse & __MetadataBearer; +/** + *

Validates a Device Defender security profile behaviors specification.

+ */ export class ValidateSecurityProfileBehaviorsCommand extends $Command< ValidateSecurityProfileBehaviorsCommandInput, ValidateSecurityProfileBehaviorsCommandOutput, @@ -34,6 +37,9 @@ export class ValidateSecurityProfileBehaviorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTClientResolvedConfig, diff --git a/clients/client-iot/package.json b/clients/client-iot/package.json index 95ebeb3f838da..e9d6e661e4747 100644 --- a/clients/client-iot/package.json +++ b/clients/client-iot/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iot Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iot/pagination/ListActiveViolationsPaginator.ts b/clients/client-iot/pagination/ListActiveViolationsPaginator.ts index 14379ed8bed38..a11fb3d36ab8f 100644 --- a/clients/client-iot/pagination/ListActiveViolationsPaginator.ts +++ b/clients/client-iot/pagination/ListActiveViolationsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListActiveViolationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListActiveViolationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListActiveViolationsCommandInput, diff --git a/clients/client-iot/pagination/ListAttachedPoliciesPaginator.ts b/clients/client-iot/pagination/ListAttachedPoliciesPaginator.ts index c53c9d791c518..3a956dfe4aa0f 100644 --- a/clients/client-iot/pagination/ListAttachedPoliciesPaginator.ts +++ b/clients/client-iot/pagination/ListAttachedPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListAttachedPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttachedPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListAttachedPoliciesCommandInput, diff --git a/clients/client-iot/pagination/ListAuditFindingsPaginator.ts b/clients/client-iot/pagination/ListAuditFindingsPaginator.ts index b3e02b379ad08..c1c6fb1a0b551 100644 --- a/clients/client-iot/pagination/ListAuditFindingsPaginator.ts +++ b/clients/client-iot/pagination/ListAuditFindingsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListAuditFindingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAuditFindingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListAuditFindingsCommandInput, diff --git a/clients/client-iot/pagination/ListAuditMitigationActionsExecutionsPaginator.ts b/clients/client-iot/pagination/ListAuditMitigationActionsExecutionsPaginator.ts index 1f55cec6624fa..1f5d8a9c415e9 100644 --- a/clients/client-iot/pagination/ListAuditMitigationActionsExecutionsPaginator.ts +++ b/clients/client-iot/pagination/ListAuditMitigationActionsExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListAuditMitigationActionsExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAuditMitigationActionsExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListAuditMitigationActionsExecutionsCommandInput, diff --git a/clients/client-iot/pagination/ListAuditMitigationActionsTasksPaginator.ts b/clients/client-iot/pagination/ListAuditMitigationActionsTasksPaginator.ts index e552db291da75..9e0374efa7d70 100644 --- a/clients/client-iot/pagination/ListAuditMitigationActionsTasksPaginator.ts +++ b/clients/client-iot/pagination/ListAuditMitigationActionsTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListAuditMitigationActionsTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAuditMitigationActionsTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListAuditMitigationActionsTasksCommandInput, diff --git a/clients/client-iot/pagination/ListAuditSuppressionsPaginator.ts b/clients/client-iot/pagination/ListAuditSuppressionsPaginator.ts index 65e3c8eb5e0c4..83fdb20ec7220 100644 --- a/clients/client-iot/pagination/ListAuditSuppressionsPaginator.ts +++ b/clients/client-iot/pagination/ListAuditSuppressionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListAuditSuppressionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAuditSuppressionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListAuditSuppressionsCommandInput, diff --git a/clients/client-iot/pagination/ListAuditTasksPaginator.ts b/clients/client-iot/pagination/ListAuditTasksPaginator.ts index fdbb907786063..4162bedc491c4 100644 --- a/clients/client-iot/pagination/ListAuditTasksPaginator.ts +++ b/clients/client-iot/pagination/ListAuditTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListAuditTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAuditTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListAuditTasksCommandInput, diff --git a/clients/client-iot/pagination/ListAuthorizersPaginator.ts b/clients/client-iot/pagination/ListAuthorizersPaginator.ts index 86cf42d92b2f2..9915eeedbbb1f 100644 --- a/clients/client-iot/pagination/ListAuthorizersPaginator.ts +++ b/clients/client-iot/pagination/ListAuthorizersPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListAuthorizersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAuthorizersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListAuthorizersCommandInput, diff --git a/clients/client-iot/pagination/ListBillingGroupsPaginator.ts b/clients/client-iot/pagination/ListBillingGroupsPaginator.ts index efbcf371cd525..fd377bba3ef24 100644 --- a/clients/client-iot/pagination/ListBillingGroupsPaginator.ts +++ b/clients/client-iot/pagination/ListBillingGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListBillingGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBillingGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListBillingGroupsCommandInput, diff --git a/clients/client-iot/pagination/ListCACertificatesPaginator.ts b/clients/client-iot/pagination/ListCACertificatesPaginator.ts index 49c4a856165e1..8a3f8a6d702a7 100644 --- a/clients/client-iot/pagination/ListCACertificatesPaginator.ts +++ b/clients/client-iot/pagination/ListCACertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListCACertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCACertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListCACertificatesCommandInput, diff --git a/clients/client-iot/pagination/ListCertificatesByCAPaginator.ts b/clients/client-iot/pagination/ListCertificatesByCAPaginator.ts index 1f2f10afe9f32..b3a770a88365d 100644 --- a/clients/client-iot/pagination/ListCertificatesByCAPaginator.ts +++ b/clients/client-iot/pagination/ListCertificatesByCAPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListCertificatesByCACommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCertificatesByCACommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListCertificatesByCACommandInput, diff --git a/clients/client-iot/pagination/ListCertificatesPaginator.ts b/clients/client-iot/pagination/ListCertificatesPaginator.ts index 4667c62859253..d56155ca860f1 100644 --- a/clients/client-iot/pagination/ListCertificatesPaginator.ts +++ b/clients/client-iot/pagination/ListCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListCertificatesCommandInput, diff --git a/clients/client-iot/pagination/ListDimensionsPaginator.ts b/clients/client-iot/pagination/ListDimensionsPaginator.ts index 3c5b4e1bc92d6..ed19cf64c33d4 100644 --- a/clients/client-iot/pagination/ListDimensionsPaginator.ts +++ b/clients/client-iot/pagination/ListDimensionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListDimensionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDimensionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListDimensionsCommandInput, diff --git a/clients/client-iot/pagination/ListDomainConfigurationsPaginator.ts b/clients/client-iot/pagination/ListDomainConfigurationsPaginator.ts index 488c9ad4b338c..c4a4c69b01c36 100644 --- a/clients/client-iot/pagination/ListDomainConfigurationsPaginator.ts +++ b/clients/client-iot/pagination/ListDomainConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListDomainConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListDomainConfigurationsCommandInput, diff --git a/clients/client-iot/pagination/ListIndicesPaginator.ts b/clients/client-iot/pagination/ListIndicesPaginator.ts index b7a19288bbfa4..8bf54b3773c12 100644 --- a/clients/client-iot/pagination/ListIndicesPaginator.ts +++ b/clients/client-iot/pagination/ListIndicesPaginator.ts @@ -4,6 +4,9 @@ import { ListIndicesCommand, ListIndicesCommandInput, ListIndicesCommandOutput } import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListIndicesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListIndicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListIndicesCommandInput, diff --git a/clients/client-iot/pagination/ListJobExecutionsForJobPaginator.ts b/clients/client-iot/pagination/ListJobExecutionsForJobPaginator.ts index 9bfde79b00604..df566e56e80b3 100644 --- a/clients/client-iot/pagination/ListJobExecutionsForJobPaginator.ts +++ b/clients/client-iot/pagination/ListJobExecutionsForJobPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListJobExecutionsForJobCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobExecutionsForJobCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListJobExecutionsForJobCommandInput, diff --git a/clients/client-iot/pagination/ListJobExecutionsForThingPaginator.ts b/clients/client-iot/pagination/ListJobExecutionsForThingPaginator.ts index b47115dd690b8..d15a3d88dfb5d 100644 --- a/clients/client-iot/pagination/ListJobExecutionsForThingPaginator.ts +++ b/clients/client-iot/pagination/ListJobExecutionsForThingPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListJobExecutionsForThingCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobExecutionsForThingCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListJobExecutionsForThingCommandInput, diff --git a/clients/client-iot/pagination/ListJobsPaginator.ts b/clients/client-iot/pagination/ListJobsPaginator.ts index 9765fe74e574d..ab44fedb638a6 100644 --- a/clients/client-iot/pagination/ListJobsPaginator.ts +++ b/clients/client-iot/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListJobsCommandInput, diff --git a/clients/client-iot/pagination/ListMitigationActionsPaginator.ts b/clients/client-iot/pagination/ListMitigationActionsPaginator.ts index 527c733c2c77d..e72aefd2e3430 100644 --- a/clients/client-iot/pagination/ListMitigationActionsPaginator.ts +++ b/clients/client-iot/pagination/ListMitigationActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListMitigationActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMitigationActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListMitigationActionsCommandInput, diff --git a/clients/client-iot/pagination/ListOTAUpdatesPaginator.ts b/clients/client-iot/pagination/ListOTAUpdatesPaginator.ts index 4f27973e44cb8..28492a0593c89 100644 --- a/clients/client-iot/pagination/ListOTAUpdatesPaginator.ts +++ b/clients/client-iot/pagination/ListOTAUpdatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListOTAUpdatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOTAUpdatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListOTAUpdatesCommandInput, diff --git a/clients/client-iot/pagination/ListOutgoingCertificatesPaginator.ts b/clients/client-iot/pagination/ListOutgoingCertificatesPaginator.ts index 3e64ccba9981f..090151872663e 100644 --- a/clients/client-iot/pagination/ListOutgoingCertificatesPaginator.ts +++ b/clients/client-iot/pagination/ListOutgoingCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListOutgoingCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOutgoingCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListOutgoingCertificatesCommandInput, diff --git a/clients/client-iot/pagination/ListPoliciesPaginator.ts b/clients/client-iot/pagination/ListPoliciesPaginator.ts index 1604bc303b465..058e8b7be3322 100644 --- a/clients/client-iot/pagination/ListPoliciesPaginator.ts +++ b/clients/client-iot/pagination/ListPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListPoliciesCommandInput, diff --git a/clients/client-iot/pagination/ListPolicyPrincipalsPaginator.ts b/clients/client-iot/pagination/ListPolicyPrincipalsPaginator.ts index 19c7f7b1bac80..c31e7859f54c5 100644 --- a/clients/client-iot/pagination/ListPolicyPrincipalsPaginator.ts +++ b/clients/client-iot/pagination/ListPolicyPrincipalsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListPolicyPrincipalsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPolicyPrincipalsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListPolicyPrincipalsCommandInput, diff --git a/clients/client-iot/pagination/ListPrincipalPoliciesPaginator.ts b/clients/client-iot/pagination/ListPrincipalPoliciesPaginator.ts index ca64b642b6f5f..5eaef3550d9c5 100644 --- a/clients/client-iot/pagination/ListPrincipalPoliciesPaginator.ts +++ b/clients/client-iot/pagination/ListPrincipalPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListPrincipalPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPrincipalPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListPrincipalPoliciesCommandInput, diff --git a/clients/client-iot/pagination/ListPrincipalThingsPaginator.ts b/clients/client-iot/pagination/ListPrincipalThingsPaginator.ts index 65a3a220b7480..3180204acb646 100644 --- a/clients/client-iot/pagination/ListPrincipalThingsPaginator.ts +++ b/clients/client-iot/pagination/ListPrincipalThingsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListPrincipalThingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPrincipalThingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListPrincipalThingsCommandInput, diff --git a/clients/client-iot/pagination/ListProvisioningTemplateVersionsPaginator.ts b/clients/client-iot/pagination/ListProvisioningTemplateVersionsPaginator.ts index 4ed4e791234ec..7d433c87d3b33 100644 --- a/clients/client-iot/pagination/ListProvisioningTemplateVersionsPaginator.ts +++ b/clients/client-iot/pagination/ListProvisioningTemplateVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListProvisioningTemplateVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProvisioningTemplateVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListProvisioningTemplateVersionsCommandInput, diff --git a/clients/client-iot/pagination/ListProvisioningTemplatesPaginator.ts b/clients/client-iot/pagination/ListProvisioningTemplatesPaginator.ts index ccf3980b81509..c9bd242296857 100644 --- a/clients/client-iot/pagination/ListProvisioningTemplatesPaginator.ts +++ b/clients/client-iot/pagination/ListProvisioningTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListProvisioningTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProvisioningTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListProvisioningTemplatesCommandInput, diff --git a/clients/client-iot/pagination/ListRoleAliasesPaginator.ts b/clients/client-iot/pagination/ListRoleAliasesPaginator.ts index a1da01a84a2e7..223fa924de995 100644 --- a/clients/client-iot/pagination/ListRoleAliasesPaginator.ts +++ b/clients/client-iot/pagination/ListRoleAliasesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListRoleAliasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRoleAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListRoleAliasesCommandInput, diff --git a/clients/client-iot/pagination/ListScheduledAuditsPaginator.ts b/clients/client-iot/pagination/ListScheduledAuditsPaginator.ts index 60e2dda407426..4762a4f305b3f 100644 --- a/clients/client-iot/pagination/ListScheduledAuditsPaginator.ts +++ b/clients/client-iot/pagination/ListScheduledAuditsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListScheduledAuditsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListScheduledAuditsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListScheduledAuditsCommandInput, diff --git a/clients/client-iot/pagination/ListSecurityProfilesForTargetPaginator.ts b/clients/client-iot/pagination/ListSecurityProfilesForTargetPaginator.ts index d837815d1232d..ef4406b20df97 100644 --- a/clients/client-iot/pagination/ListSecurityProfilesForTargetPaginator.ts +++ b/clients/client-iot/pagination/ListSecurityProfilesForTargetPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListSecurityProfilesForTargetCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSecurityProfilesForTargetCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListSecurityProfilesForTargetCommandInput, diff --git a/clients/client-iot/pagination/ListSecurityProfilesPaginator.ts b/clients/client-iot/pagination/ListSecurityProfilesPaginator.ts index ed41a45402154..8b33ad07f1b66 100644 --- a/clients/client-iot/pagination/ListSecurityProfilesPaginator.ts +++ b/clients/client-iot/pagination/ListSecurityProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListSecurityProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSecurityProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListSecurityProfilesCommandInput, diff --git a/clients/client-iot/pagination/ListStreamsPaginator.ts b/clients/client-iot/pagination/ListStreamsPaginator.ts index 2f25039707bd3..a38df9b2a9ef6 100644 --- a/clients/client-iot/pagination/ListStreamsPaginator.ts +++ b/clients/client-iot/pagination/ListStreamsPaginator.ts @@ -4,6 +4,9 @@ import { ListStreamsCommand, ListStreamsCommandInput, ListStreamsCommandOutput } import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListStreamsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStreamsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListStreamsCommandInput, diff --git a/clients/client-iot/pagination/ListTagsForResourcePaginator.ts b/clients/client-iot/pagination/ListTagsForResourcePaginator.ts index 5bddbfb489841..1bd7e7d91e55f 100644 --- a/clients/client-iot/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-iot/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListTagsForResourceCommandInput, diff --git a/clients/client-iot/pagination/ListTargetsForPolicyPaginator.ts b/clients/client-iot/pagination/ListTargetsForPolicyPaginator.ts index 19be457d64332..9ad02f4b72098 100644 --- a/clients/client-iot/pagination/ListTargetsForPolicyPaginator.ts +++ b/clients/client-iot/pagination/ListTargetsForPolicyPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListTargetsForPolicyCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTargetsForPolicyCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListTargetsForPolicyCommandInput, diff --git a/clients/client-iot/pagination/ListTargetsForSecurityProfilePaginator.ts b/clients/client-iot/pagination/ListTargetsForSecurityProfilePaginator.ts index 506978f2ff89e..a9ea3ba2ebaf9 100644 --- a/clients/client-iot/pagination/ListTargetsForSecurityProfilePaginator.ts +++ b/clients/client-iot/pagination/ListTargetsForSecurityProfilePaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListTargetsForSecurityProfileCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTargetsForSecurityProfileCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListTargetsForSecurityProfileCommandInput, diff --git a/clients/client-iot/pagination/ListThingGroupsForThingPaginator.ts b/clients/client-iot/pagination/ListThingGroupsForThingPaginator.ts index 32dd5bef4c96f..ac4381a62ef6b 100644 --- a/clients/client-iot/pagination/ListThingGroupsForThingPaginator.ts +++ b/clients/client-iot/pagination/ListThingGroupsForThingPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingGroupsForThingCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingGroupsForThingCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingGroupsForThingCommandInput, diff --git a/clients/client-iot/pagination/ListThingGroupsPaginator.ts b/clients/client-iot/pagination/ListThingGroupsPaginator.ts index 5e65f1175a32c..d0a6badad8b64 100644 --- a/clients/client-iot/pagination/ListThingGroupsPaginator.ts +++ b/clients/client-iot/pagination/ListThingGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingGroupsCommandInput, diff --git a/clients/client-iot/pagination/ListThingPrincipalsPaginator.ts b/clients/client-iot/pagination/ListThingPrincipalsPaginator.ts index 4a093b5283712..2afd7f869fed0 100644 --- a/clients/client-iot/pagination/ListThingPrincipalsPaginator.ts +++ b/clients/client-iot/pagination/ListThingPrincipalsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingPrincipalsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingPrincipalsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingPrincipalsCommandInput, diff --git a/clients/client-iot/pagination/ListThingRegistrationTaskReportsPaginator.ts b/clients/client-iot/pagination/ListThingRegistrationTaskReportsPaginator.ts index 529cd371e44cd..289770fb98364 100644 --- a/clients/client-iot/pagination/ListThingRegistrationTaskReportsPaginator.ts +++ b/clients/client-iot/pagination/ListThingRegistrationTaskReportsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingRegistrationTaskReportsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingRegistrationTaskReportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingRegistrationTaskReportsCommandInput, diff --git a/clients/client-iot/pagination/ListThingRegistrationTasksPaginator.ts b/clients/client-iot/pagination/ListThingRegistrationTasksPaginator.ts index e62bf5664da3d..6eac248c431bb 100644 --- a/clients/client-iot/pagination/ListThingRegistrationTasksPaginator.ts +++ b/clients/client-iot/pagination/ListThingRegistrationTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingRegistrationTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingRegistrationTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingRegistrationTasksCommandInput, diff --git a/clients/client-iot/pagination/ListThingTypesPaginator.ts b/clients/client-iot/pagination/ListThingTypesPaginator.ts index 3d70637fdf80a..4fad7fde66cb0 100644 --- a/clients/client-iot/pagination/ListThingTypesPaginator.ts +++ b/clients/client-iot/pagination/ListThingTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingTypesCommandInput, diff --git a/clients/client-iot/pagination/ListThingsInBillingGroupPaginator.ts b/clients/client-iot/pagination/ListThingsInBillingGroupPaginator.ts index 5add08e0f6695..56cb88d0d87f7 100644 --- a/clients/client-iot/pagination/ListThingsInBillingGroupPaginator.ts +++ b/clients/client-iot/pagination/ListThingsInBillingGroupPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingsInBillingGroupCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingsInBillingGroupCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingsInBillingGroupCommandInput, diff --git a/clients/client-iot/pagination/ListThingsInThingGroupPaginator.ts b/clients/client-iot/pagination/ListThingsInThingGroupPaginator.ts index 94ee4ac276c91..f6859cafb9825 100644 --- a/clients/client-iot/pagination/ListThingsInThingGroupPaginator.ts +++ b/clients/client-iot/pagination/ListThingsInThingGroupPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingsInThingGroupCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingsInThingGroupCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingsInThingGroupCommandInput, diff --git a/clients/client-iot/pagination/ListThingsPaginator.ts b/clients/client-iot/pagination/ListThingsPaginator.ts index da8643d927958..a33157d49073b 100644 --- a/clients/client-iot/pagination/ListThingsPaginator.ts +++ b/clients/client-iot/pagination/ListThingsPaginator.ts @@ -4,6 +4,9 @@ import { ListThingsCommand, ListThingsCommandInput, ListThingsCommandOutput } fr import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListThingsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListThingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListThingsCommandInput, diff --git a/clients/client-iot/pagination/ListTopicRuleDestinationsPaginator.ts b/clients/client-iot/pagination/ListTopicRuleDestinationsPaginator.ts index 5d877d6711194..db798ed7a61dd 100644 --- a/clients/client-iot/pagination/ListTopicRuleDestinationsPaginator.ts +++ b/clients/client-iot/pagination/ListTopicRuleDestinationsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListTopicRuleDestinationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTopicRuleDestinationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListTopicRuleDestinationsCommandInput, diff --git a/clients/client-iot/pagination/ListTopicRulesPaginator.ts b/clients/client-iot/pagination/ListTopicRulesPaginator.ts index 06cac9823d651..f16d9830b30d7 100644 --- a/clients/client-iot/pagination/ListTopicRulesPaginator.ts +++ b/clients/client-iot/pagination/ListTopicRulesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListTopicRulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTopicRulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListTopicRulesCommandInput, diff --git a/clients/client-iot/pagination/ListV2LoggingLevelsPaginator.ts b/clients/client-iot/pagination/ListV2LoggingLevelsPaginator.ts index b353e9cae4375..cbda46a0a523c 100644 --- a/clients/client-iot/pagination/ListV2LoggingLevelsPaginator.ts +++ b/clients/client-iot/pagination/ListV2LoggingLevelsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListV2LoggingLevelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListV2LoggingLevelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListV2LoggingLevelsCommandInput, diff --git a/clients/client-iot/pagination/ListViolationEventsPaginator.ts b/clients/client-iot/pagination/ListViolationEventsPaginator.ts index 10f46cfbe097c..160cea0092923 100644 --- a/clients/client-iot/pagination/ListViolationEventsPaginator.ts +++ b/clients/client-iot/pagination/ListViolationEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTClient, input: ListViolationEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListViolationEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoT, input: ListViolationEventsCommandInput, diff --git a/clients/client-iot/runtimeConfig.browser.ts b/clients/client-iot/runtimeConfig.browser.ts index 7bd83b87b22e7..ea4bebee995c6 100644 --- a/clients/client-iot/runtimeConfig.browser.ts +++ b/clients/client-iot/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iot/runtimeConfig.native.ts b/clients/client-iot/runtimeConfig.native.ts index d3e4fde1adb22..6198932a1074d 100644 --- a/clients/client-iot/runtimeConfig.native.ts +++ b/clients/client-iot/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iot/runtimeConfig.shared.ts b/clients/client-iot/runtimeConfig.shared.ts index dcb32ad643e5c..9fc1c6ec910fe 100644 --- a/clients/client-iot/runtimeConfig.shared.ts +++ b/clients/client-iot/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-05-28", disableHostPrefix: false, diff --git a/clients/client-iot/runtimeConfig.ts b/clients/client-iot/runtimeConfig.ts index 5fa049c676485..a4a6bcd600008 100644 --- a/clients/client-iot/runtimeConfig.ts +++ b/clients/client-iot/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iot/tsconfig.json b/clients/client-iot/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iot/tsconfig.json +++ b/clients/client-iot/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iotanalytics/commands/BatchPutMessageCommand.ts b/clients/client-iotanalytics/commands/BatchPutMessageCommand.ts index c28fb71e0b8e2..755a103d31f07 100644 --- a/clients/client-iotanalytics/commands/BatchPutMessageCommand.ts +++ b/clients/client-iotanalytics/commands/BatchPutMessageCommand.ts @@ -20,6 +20,9 @@ import { export type BatchPutMessageCommandInput = BatchPutMessageRequest; export type BatchPutMessageCommandOutput = BatchPutMessageResponse & __MetadataBearer; +/** + *

Sends messages to a channel.

+ */ export class BatchPutMessageCommand extends $Command< BatchPutMessageCommandInput, BatchPutMessageCommandOutput, @@ -34,6 +37,9 @@ export class BatchPutMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/CancelPipelineReprocessingCommand.ts b/clients/client-iotanalytics/commands/CancelPipelineReprocessingCommand.ts index aa11379b5abe9..2d374fc7a2f61 100644 --- a/clients/client-iotanalytics/commands/CancelPipelineReprocessingCommand.ts +++ b/clients/client-iotanalytics/commands/CancelPipelineReprocessingCommand.ts @@ -20,6 +20,9 @@ import { export type CancelPipelineReprocessingCommandInput = CancelPipelineReprocessingRequest; export type CancelPipelineReprocessingCommandOutput = CancelPipelineReprocessingResponse & __MetadataBearer; +/** + *

Cancels the reprocessing of data through the pipeline.

+ */ export class CancelPipelineReprocessingCommand extends $Command< CancelPipelineReprocessingCommandInput, CancelPipelineReprocessingCommandOutput, @@ -34,6 +37,9 @@ export class CancelPipelineReprocessingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/CreateChannelCommand.ts b/clients/client-iotanalytics/commands/CreateChannelCommand.ts index 890c0a5439a16..e5a2ff9e25e04 100644 --- a/clients/client-iotanalytics/commands/CreateChannelCommand.ts +++ b/clients/client-iotanalytics/commands/CreateChannelCommand.ts @@ -20,6 +20,10 @@ import { export type CreateChannelCommandInput = CreateChannelRequest; export type CreateChannelCommandOutput = CreateChannelResponse & __MetadataBearer; +/** + *

Creates a channel. A channel collects data from an MQTT topic and archives the + * raw, unprocessed messages before publishing the data to a pipeline.

+ */ export class CreateChannelCommand extends $Command< CreateChannelCommandInput, CreateChannelCommandOutput, @@ -34,6 +38,9 @@ export class CreateChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/CreateDatasetCommand.ts b/clients/client-iotanalytics/commands/CreateDatasetCommand.ts index 36e80995e3117..d7e99a3c00080 100644 --- a/clients/client-iotanalytics/commands/CreateDatasetCommand.ts +++ b/clients/client-iotanalytics/commands/CreateDatasetCommand.ts @@ -20,6 +20,13 @@ import { export type CreateDatasetCommandInput = CreateDatasetRequest; export type CreateDatasetCommandOutput = CreateDatasetResponse & __MetadataBearer; +/** + *

Creates a dataset. A dataset stores data retrieved from a data store by applying a + * queryAction (a SQL query) or a containerAction (executing a + * containerized application). This operation creates the skeleton of a dataset. The dataset can + * be populated manually by calling CreateDatasetContent or automatically according + * to a trigger you specify.

+ */ export class CreateDatasetCommand extends $Command< CreateDatasetCommandInput, CreateDatasetCommandOutput, @@ -34,6 +41,9 @@ export class CreateDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/CreateDatasetContentCommand.ts b/clients/client-iotanalytics/commands/CreateDatasetContentCommand.ts index 877c1d34e8c84..13457bd1d3a3c 100644 --- a/clients/client-iotanalytics/commands/CreateDatasetContentCommand.ts +++ b/clients/client-iotanalytics/commands/CreateDatasetContentCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDatasetContentCommandInput = CreateDatasetContentRequest; export type CreateDatasetContentCommandOutput = CreateDatasetContentResponse & __MetadataBearer; +/** + *

Creates the content of a data set by applying a queryAction (a SQL query) + * or a containerAction (executing a containerized application).

+ */ export class CreateDatasetContentCommand extends $Command< CreateDatasetContentCommandInput, CreateDatasetContentCommandOutput, @@ -34,6 +38,9 @@ export class CreateDatasetContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/CreateDatastoreCommand.ts b/clients/client-iotanalytics/commands/CreateDatastoreCommand.ts index af2cf7967aa71..e50a560d7977a 100644 --- a/clients/client-iotanalytics/commands/CreateDatastoreCommand.ts +++ b/clients/client-iotanalytics/commands/CreateDatastoreCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDatastoreCommandInput = CreateDatastoreRequest; export type CreateDatastoreCommandOutput = CreateDatastoreResponse & __MetadataBearer; +/** + *

Creates a data store, which is a repository for messages.

+ */ export class CreateDatastoreCommand extends $Command< CreateDatastoreCommandInput, CreateDatastoreCommandOutput, @@ -34,6 +37,9 @@ export class CreateDatastoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/CreatePipelineCommand.ts b/clients/client-iotanalytics/commands/CreatePipelineCommand.ts index ea9f15b3fe4d5..9840c67160814 100644 --- a/clients/client-iotanalytics/commands/CreatePipelineCommand.ts +++ b/clients/client-iotanalytics/commands/CreatePipelineCommand.ts @@ -20,6 +20,12 @@ import { export type CreatePipelineCommandInput = CreatePipelineRequest; export type CreatePipelineCommandOutput = CreatePipelineResponse & __MetadataBearer; +/** + *

Creates a pipeline. A pipeline consumes messages from a channel and allows + * you to process the messages before storing them in a data store. You must specify both a + * channel and a datastore activity and, optionally, as many + * as 23 additional activities in the pipelineActivities array.

+ */ export class CreatePipelineCommand extends $Command< CreatePipelineCommandInput, CreatePipelineCommandOutput, @@ -34,6 +40,9 @@ export class CreatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DeleteChannelCommand.ts b/clients/client-iotanalytics/commands/DeleteChannelCommand.ts index 971fedc162975..1f766e9898df6 100644 --- a/clients/client-iotanalytics/commands/DeleteChannelCommand.ts +++ b/clients/client-iotanalytics/commands/DeleteChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteChannelCommandInput = DeleteChannelRequest; export type DeleteChannelCommandOutput = __MetadataBearer; +/** + *

Deletes the specified channel.

+ */ export class DeleteChannelCommand extends $Command< DeleteChannelCommandInput, DeleteChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DeleteDatasetCommand.ts b/clients/client-iotanalytics/commands/DeleteDatasetCommand.ts index 296644d249b0f..2e1aef8381e17 100644 --- a/clients/client-iotanalytics/commands/DeleteDatasetCommand.ts +++ b/clients/client-iotanalytics/commands/DeleteDatasetCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDatasetCommandInput = DeleteDatasetRequest; export type DeleteDatasetCommandOutput = __MetadataBearer; +/** + *

Deletes the specified dataset.

+ *

You do not have to delete the content of the dataset before you perform this + * operation.

+ */ export class DeleteDatasetCommand extends $Command< DeleteDatasetCommandInput, DeleteDatasetCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DeleteDatasetContentCommand.ts b/clients/client-iotanalytics/commands/DeleteDatasetContentCommand.ts index d65c8203fda9b..760054b80b0e4 100644 --- a/clients/client-iotanalytics/commands/DeleteDatasetContentCommand.ts +++ b/clients/client-iotanalytics/commands/DeleteDatasetContentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDatasetContentCommandInput = DeleteDatasetContentRequest; export type DeleteDatasetContentCommandOutput = __MetadataBearer; +/** + *

Deletes the content of the specified dataset.

+ */ export class DeleteDatasetContentCommand extends $Command< DeleteDatasetContentCommandInput, DeleteDatasetContentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDatasetContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DeleteDatastoreCommand.ts b/clients/client-iotanalytics/commands/DeleteDatastoreCommand.ts index 4a044dc20eb12..5ec45a6b5d0cf 100644 --- a/clients/client-iotanalytics/commands/DeleteDatastoreCommand.ts +++ b/clients/client-iotanalytics/commands/DeleteDatastoreCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDatastoreCommandInput = DeleteDatastoreRequest; export type DeleteDatastoreCommandOutput = __MetadataBearer; +/** + *

Deletes the specified data store.

+ */ export class DeleteDatastoreCommand extends $Command< DeleteDatastoreCommandInput, DeleteDatastoreCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDatastoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DeletePipelineCommand.ts b/clients/client-iotanalytics/commands/DeletePipelineCommand.ts index 64c184b3e534f..7dfca675f6761 100644 --- a/clients/client-iotanalytics/commands/DeletePipelineCommand.ts +++ b/clients/client-iotanalytics/commands/DeletePipelineCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePipelineCommandInput = DeletePipelineRequest; export type DeletePipelineCommandOutput = __MetadataBearer; +/** + *

Deletes the specified pipeline.

+ */ export class DeletePipelineCommand extends $Command< DeletePipelineCommandInput, DeletePipelineCommandOutput, @@ -34,6 +37,9 @@ export class DeletePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DescribeChannelCommand.ts b/clients/client-iotanalytics/commands/DescribeChannelCommand.ts index bd5b90c109d49..25a946232d597 100644 --- a/clients/client-iotanalytics/commands/DescribeChannelCommand.ts +++ b/clients/client-iotanalytics/commands/DescribeChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeChannelCommandInput = DescribeChannelRequest; export type DescribeChannelCommandOutput = DescribeChannelResponse & __MetadataBearer; +/** + *

Retrieves information about a channel.

+ */ export class DescribeChannelCommand extends $Command< DescribeChannelCommandInput, DescribeChannelCommandOutput, @@ -34,6 +37,9 @@ export class DescribeChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DescribeDatasetCommand.ts b/clients/client-iotanalytics/commands/DescribeDatasetCommand.ts index 4d742d7b0f771..d8226765dde7a 100644 --- a/clients/client-iotanalytics/commands/DescribeDatasetCommand.ts +++ b/clients/client-iotanalytics/commands/DescribeDatasetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDatasetCommandInput = DescribeDatasetRequest; export type DescribeDatasetCommandOutput = DescribeDatasetResponse & __MetadataBearer; +/** + *

Retrieves information about a dataset.

+ */ export class DescribeDatasetCommand extends $Command< DescribeDatasetCommandInput, DescribeDatasetCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DescribeDatastoreCommand.ts b/clients/client-iotanalytics/commands/DescribeDatastoreCommand.ts index 30f9416c83f62..a47aa5a66c442 100644 --- a/clients/client-iotanalytics/commands/DescribeDatastoreCommand.ts +++ b/clients/client-iotanalytics/commands/DescribeDatastoreCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDatastoreCommandInput = DescribeDatastoreRequest; export type DescribeDatastoreCommandOutput = DescribeDatastoreResponse & __MetadataBearer; +/** + *

Retrieves information about a data store.

+ */ export class DescribeDatastoreCommand extends $Command< DescribeDatastoreCommandInput, DescribeDatastoreCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDatastoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DescribeLoggingOptionsCommand.ts b/clients/client-iotanalytics/commands/DescribeLoggingOptionsCommand.ts index 995595e616159..6679e8e6db102 100644 --- a/clients/client-iotanalytics/commands/DescribeLoggingOptionsCommand.ts +++ b/clients/client-iotanalytics/commands/DescribeLoggingOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLoggingOptionsCommandInput = DescribeLoggingOptionsRequest; export type DescribeLoggingOptionsCommandOutput = DescribeLoggingOptionsResponse & __MetadataBearer; +/** + *

Retrieves the current settings of the AWS IoT Analytics logging options.

+ */ export class DescribeLoggingOptionsCommand extends $Command< DescribeLoggingOptionsCommandInput, DescribeLoggingOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/DescribePipelineCommand.ts b/clients/client-iotanalytics/commands/DescribePipelineCommand.ts index 19586f643b37c..b3f8b33a51d52 100644 --- a/clients/client-iotanalytics/commands/DescribePipelineCommand.ts +++ b/clients/client-iotanalytics/commands/DescribePipelineCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePipelineCommandInput = DescribePipelineRequest; export type DescribePipelineCommandOutput = DescribePipelineResponse & __MetadataBearer; +/** + *

Retrieves information about a pipeline.

+ */ export class DescribePipelineCommand extends $Command< DescribePipelineCommandInput, DescribePipelineCommandOutput, @@ -34,6 +37,9 @@ export class DescribePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/GetDatasetContentCommand.ts b/clients/client-iotanalytics/commands/GetDatasetContentCommand.ts index f7bae2f360d62..d846c12390d1d 100644 --- a/clients/client-iotanalytics/commands/GetDatasetContentCommand.ts +++ b/clients/client-iotanalytics/commands/GetDatasetContentCommand.ts @@ -20,6 +20,9 @@ import { export type GetDatasetContentCommandInput = GetDatasetContentRequest; export type GetDatasetContentCommandOutput = GetDatasetContentResponse & __MetadataBearer; +/** + *

Retrieves the contents of a data set as presigned URIs.

+ */ export class GetDatasetContentCommand extends $Command< GetDatasetContentCommandInput, GetDatasetContentCommandOutput, @@ -34,6 +37,9 @@ export class GetDatasetContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/ListChannelsCommand.ts b/clients/client-iotanalytics/commands/ListChannelsCommand.ts index db61078fee340..24ffdec786b54 100644 --- a/clients/client-iotanalytics/commands/ListChannelsCommand.ts +++ b/clients/client-iotanalytics/commands/ListChannelsCommand.ts @@ -20,6 +20,9 @@ import { export type ListChannelsCommandInput = ListChannelsRequest; export type ListChannelsCommandOutput = ListChannelsResponse & __MetadataBearer; +/** + *

Retrieves a list of channels.

+ */ export class ListChannelsCommand extends $Command< ListChannelsCommandInput, ListChannelsCommandOutput, @@ -34,6 +37,9 @@ export class ListChannelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/ListDatasetContentsCommand.ts b/clients/client-iotanalytics/commands/ListDatasetContentsCommand.ts index e298190ac03e7..4f774143aaa4b 100644 --- a/clients/client-iotanalytics/commands/ListDatasetContentsCommand.ts +++ b/clients/client-iotanalytics/commands/ListDatasetContentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDatasetContentsCommandInput = ListDatasetContentsRequest; export type ListDatasetContentsCommandOutput = ListDatasetContentsResponse & __MetadataBearer; +/** + *

Lists information about data set contents that have been created.

+ */ export class ListDatasetContentsCommand extends $Command< ListDatasetContentsCommandInput, ListDatasetContentsCommandOutput, @@ -34,6 +37,9 @@ export class ListDatasetContentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/ListDatasetsCommand.ts b/clients/client-iotanalytics/commands/ListDatasetsCommand.ts index 56f90dbe41951..ed78370a00b78 100644 --- a/clients/client-iotanalytics/commands/ListDatasetsCommand.ts +++ b/clients/client-iotanalytics/commands/ListDatasetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDatasetsCommandInput = ListDatasetsRequest; export type ListDatasetsCommandOutput = ListDatasetsResponse & __MetadataBearer; +/** + *

Retrieves information about data sets.

+ */ export class ListDatasetsCommand extends $Command< ListDatasetsCommandInput, ListDatasetsCommandOutput, @@ -34,6 +37,9 @@ export class ListDatasetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/ListDatastoresCommand.ts b/clients/client-iotanalytics/commands/ListDatastoresCommand.ts index 8a5034e3ff321..ac46d0c8d7339 100644 --- a/clients/client-iotanalytics/commands/ListDatastoresCommand.ts +++ b/clients/client-iotanalytics/commands/ListDatastoresCommand.ts @@ -20,6 +20,9 @@ import { export type ListDatastoresCommandInput = ListDatastoresRequest; export type ListDatastoresCommandOutput = ListDatastoresResponse & __MetadataBearer; +/** + *

Retrieves a list of data stores.

+ */ export class ListDatastoresCommand extends $Command< ListDatastoresCommandInput, ListDatastoresCommandOutput, @@ -34,6 +37,9 @@ export class ListDatastoresCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/ListPipelinesCommand.ts b/clients/client-iotanalytics/commands/ListPipelinesCommand.ts index c24c3540a333e..bb4c635d9cdd4 100644 --- a/clients/client-iotanalytics/commands/ListPipelinesCommand.ts +++ b/clients/client-iotanalytics/commands/ListPipelinesCommand.ts @@ -20,6 +20,9 @@ import { export type ListPipelinesCommandInput = ListPipelinesRequest; export type ListPipelinesCommandOutput = ListPipelinesResponse & __MetadataBearer; +/** + *

Retrieves a list of pipelines.

+ */ export class ListPipelinesCommand extends $Command< ListPipelinesCommandInput, ListPipelinesCommandOutput, @@ -34,6 +37,9 @@ export class ListPipelinesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/ListTagsForResourceCommand.ts b/clients/client-iotanalytics/commands/ListTagsForResourceCommand.ts index 1c451bdeee890..2e8d3dedc40b6 100644 --- a/clients/client-iotanalytics/commands/ListTagsForResourceCommand.ts +++ b/clients/client-iotanalytics/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags (metadata) that you have assigned to the resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/PutLoggingOptionsCommand.ts b/clients/client-iotanalytics/commands/PutLoggingOptionsCommand.ts index e2773c4b5ecc1..f6a97bc6fc33b 100644 --- a/clients/client-iotanalytics/commands/PutLoggingOptionsCommand.ts +++ b/clients/client-iotanalytics/commands/PutLoggingOptionsCommand.ts @@ -20,6 +20,13 @@ import { export type PutLoggingOptionsCommandInput = PutLoggingOptionsRequest; export type PutLoggingOptionsCommandOutput = __MetadataBearer; +/** + *

Sets or updates the AWS IoT Analytics logging options.

+ *

If you update the value of any loggingOptions field, it takes up to one + * minute for the change to take effect. Also, if you change the policy attached to the role you + * specified in the roleArn field (for example, to correct an invalid policy), it + * takes up to five minutes for that change to take effect.

+ */ export class PutLoggingOptionsCommand extends $Command< PutLoggingOptionsCommandInput, PutLoggingOptionsCommandOutput, @@ -34,6 +41,9 @@ export class PutLoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/RunPipelineActivityCommand.ts b/clients/client-iotanalytics/commands/RunPipelineActivityCommand.ts index a001e33ba7727..2b70583497e11 100644 --- a/clients/client-iotanalytics/commands/RunPipelineActivityCommand.ts +++ b/clients/client-iotanalytics/commands/RunPipelineActivityCommand.ts @@ -20,6 +20,9 @@ import { export type RunPipelineActivityCommandInput = RunPipelineActivityRequest; export type RunPipelineActivityCommandOutput = RunPipelineActivityResponse & __MetadataBearer; +/** + *

Simulates the results of running a pipeline activity on a message payload.

+ */ export class RunPipelineActivityCommand extends $Command< RunPipelineActivityCommandInput, RunPipelineActivityCommandOutput, @@ -34,6 +37,9 @@ export class RunPipelineActivityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/SampleChannelDataCommand.ts b/clients/client-iotanalytics/commands/SampleChannelDataCommand.ts index 5b2a3172d1b61..cc1e092a66756 100644 --- a/clients/client-iotanalytics/commands/SampleChannelDataCommand.ts +++ b/clients/client-iotanalytics/commands/SampleChannelDataCommand.ts @@ -20,6 +20,10 @@ import { export type SampleChannelDataCommandInput = SampleChannelDataRequest; export type SampleChannelDataCommandOutput = SampleChannelDataResponse & __MetadataBearer; +/** + *

Retrieves a sample of messages from the specified channel ingested during the specified + * timeframe. Up to 10 messages can be retrieved.

+ */ export class SampleChannelDataCommand extends $Command< SampleChannelDataCommandInput, SampleChannelDataCommandOutput, @@ -34,6 +38,9 @@ export class SampleChannelDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/StartPipelineReprocessingCommand.ts b/clients/client-iotanalytics/commands/StartPipelineReprocessingCommand.ts index 22a9943b4453c..bc82873b6e53d 100644 --- a/clients/client-iotanalytics/commands/StartPipelineReprocessingCommand.ts +++ b/clients/client-iotanalytics/commands/StartPipelineReprocessingCommand.ts @@ -20,6 +20,9 @@ import { export type StartPipelineReprocessingCommandInput = StartPipelineReprocessingRequest; export type StartPipelineReprocessingCommandOutput = StartPipelineReprocessingResponse & __MetadataBearer; +/** + *

Starts the reprocessing of raw message data through the pipeline.

+ */ export class StartPipelineReprocessingCommand extends $Command< StartPipelineReprocessingCommandInput, StartPipelineReprocessingCommandOutput, @@ -34,6 +37,9 @@ export class StartPipelineReprocessingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/TagResourceCommand.ts b/clients/client-iotanalytics/commands/TagResourceCommand.ts index cb77b7ebc75a0..41dc4435dd857 100644 --- a/clients/client-iotanalytics/commands/TagResourceCommand.ts +++ b/clients/client-iotanalytics/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds to or modifies the tags of the given resource. Tags are metadata that can be used + * to manage a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/UntagResourceCommand.ts b/clients/client-iotanalytics/commands/UntagResourceCommand.ts index f5b6e4a871ec3..747b89e59af69 100644 --- a/clients/client-iotanalytics/commands/UntagResourceCommand.ts +++ b/clients/client-iotanalytics/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the given tags (metadata) from the resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/UpdateChannelCommand.ts b/clients/client-iotanalytics/commands/UpdateChannelCommand.ts index 95b668eb87bd6..9aaf199ec5ec1 100644 --- a/clients/client-iotanalytics/commands/UpdateChannelCommand.ts +++ b/clients/client-iotanalytics/commands/UpdateChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateChannelCommandInput = UpdateChannelRequest; export type UpdateChannelCommandOutput = __MetadataBearer; +/** + *

Updates the settings of a channel.

+ */ export class UpdateChannelCommand extends $Command< UpdateChannelCommandInput, UpdateChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/UpdateDatasetCommand.ts b/clients/client-iotanalytics/commands/UpdateDatasetCommand.ts index cfcea80e143eb..943a63cf57074 100644 --- a/clients/client-iotanalytics/commands/UpdateDatasetCommand.ts +++ b/clients/client-iotanalytics/commands/UpdateDatasetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDatasetCommandInput = UpdateDatasetRequest; export type UpdateDatasetCommandOutput = __MetadataBearer; +/** + *

Updates the settings of a data set.

+ */ export class UpdateDatasetCommand extends $Command< UpdateDatasetCommandInput, UpdateDatasetCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/UpdateDatastoreCommand.ts b/clients/client-iotanalytics/commands/UpdateDatastoreCommand.ts index 1862844327028..f22f3911de1c2 100644 --- a/clients/client-iotanalytics/commands/UpdateDatastoreCommand.ts +++ b/clients/client-iotanalytics/commands/UpdateDatastoreCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDatastoreCommandInput = UpdateDatastoreRequest; export type UpdateDatastoreCommandOutput = __MetadataBearer; +/** + *

Updates the settings of a data store.

+ */ export class UpdateDatastoreCommand extends $Command< UpdateDatastoreCommandInput, UpdateDatastoreCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDatastoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/commands/UpdatePipelineCommand.ts b/clients/client-iotanalytics/commands/UpdatePipelineCommand.ts index 6dec4a3ea1fb5..577849d06da5e 100644 --- a/clients/client-iotanalytics/commands/UpdatePipelineCommand.ts +++ b/clients/client-iotanalytics/commands/UpdatePipelineCommand.ts @@ -20,6 +20,11 @@ import { export type UpdatePipelineCommandInput = UpdatePipelineRequest; export type UpdatePipelineCommandOutput = __MetadataBearer; +/** + *

Updates the settings of a pipeline. You must specify both a + * channel and a datastore activity and, optionally, as many + * as 23 additional activities in the pipelineActivities array.

+ */ export class UpdatePipelineCommand extends $Command< UpdatePipelineCommandInput, UpdatePipelineCommandOutput, @@ -34,6 +39,9 @@ export class UpdatePipelineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTAnalyticsClientResolvedConfig, diff --git a/clients/client-iotanalytics/package.json b/clients/client-iotanalytics/package.json index 5f6c17b70195c..1c8ccaa0f02ba 100644 --- a/clients/client-iotanalytics/package.json +++ b/clients/client-iotanalytics/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iotanalytics Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iotanalytics/pagination/ListChannelsPaginator.ts b/clients/client-iotanalytics/pagination/ListChannelsPaginator.ts index 4968471e6ca2f..21159660d6c77 100644 --- a/clients/client-iotanalytics/pagination/ListChannelsPaginator.ts +++ b/clients/client-iotanalytics/pagination/ListChannelsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTAnalyticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTAnalyticsClient, input: ListChannelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListChannelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTAnalytics, input: ListChannelsCommandInput, diff --git a/clients/client-iotanalytics/pagination/ListDatasetContentsPaginator.ts b/clients/client-iotanalytics/pagination/ListDatasetContentsPaginator.ts index 1f76e00b8b542..8425f66bad0dd 100644 --- a/clients/client-iotanalytics/pagination/ListDatasetContentsPaginator.ts +++ b/clients/client-iotanalytics/pagination/ListDatasetContentsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTAnalyticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTAnalyticsClient, input: ListDatasetContentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetContentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTAnalytics, input: ListDatasetContentsCommandInput, diff --git a/clients/client-iotanalytics/pagination/ListDatasetsPaginator.ts b/clients/client-iotanalytics/pagination/ListDatasetsPaginator.ts index 4d24df2fd7e15..8de584c127471 100644 --- a/clients/client-iotanalytics/pagination/ListDatasetsPaginator.ts +++ b/clients/client-iotanalytics/pagination/ListDatasetsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTAnalyticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTAnalyticsClient, input: ListDatasetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTAnalytics, input: ListDatasetsCommandInput, diff --git a/clients/client-iotanalytics/pagination/ListDatastoresPaginator.ts b/clients/client-iotanalytics/pagination/ListDatastoresPaginator.ts index bd847c3516272..709273cd058c2 100644 --- a/clients/client-iotanalytics/pagination/ListDatastoresPaginator.ts +++ b/clients/client-iotanalytics/pagination/ListDatastoresPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTAnalyticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTAnalyticsClient, input: ListDatastoresCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatastoresCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTAnalytics, input: ListDatastoresCommandInput, diff --git a/clients/client-iotanalytics/pagination/ListPipelinesPaginator.ts b/clients/client-iotanalytics/pagination/ListPipelinesPaginator.ts index e6adddacc74ff..1aa130eb049c4 100644 --- a/clients/client-iotanalytics/pagination/ListPipelinesPaginator.ts +++ b/clients/client-iotanalytics/pagination/ListPipelinesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTAnalyticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTAnalyticsClient, input: ListPipelinesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPipelinesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTAnalytics, input: ListPipelinesCommandInput, diff --git a/clients/client-iotanalytics/runtimeConfig.browser.ts b/clients/client-iotanalytics/runtimeConfig.browser.ts index df4abdc568750..f42c960882930 100644 --- a/clients/client-iotanalytics/runtimeConfig.browser.ts +++ b/clients/client-iotanalytics/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTAnalyticsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iotanalytics/runtimeConfig.native.ts b/clients/client-iotanalytics/runtimeConfig.native.ts index 4b6dc24316968..117a38577fedc 100644 --- a/clients/client-iotanalytics/runtimeConfig.native.ts +++ b/clients/client-iotanalytics/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTAnalyticsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iotanalytics/runtimeConfig.shared.ts b/clients/client-iotanalytics/runtimeConfig.shared.ts index c5feb75d01339..dcbd3098f619e 100644 --- a/clients/client-iotanalytics/runtimeConfig.shared.ts +++ b/clients/client-iotanalytics/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-11-27", disableHostPrefix: false, diff --git a/clients/client-iotanalytics/runtimeConfig.ts b/clients/client-iotanalytics/runtimeConfig.ts index fcc4e3ab90eb9..737120b902969 100644 --- a/clients/client-iotanalytics/runtimeConfig.ts +++ b/clients/client-iotanalytics/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTAnalyticsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iotanalytics/tsconfig.json b/clients/client-iotanalytics/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iotanalytics/tsconfig.json +++ b/clients/client-iotanalytics/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iotsecuretunneling/commands/CloseTunnelCommand.ts b/clients/client-iotsecuretunneling/commands/CloseTunnelCommand.ts index 35503ef84132d..cd313b3ece1eb 100644 --- a/clients/client-iotsecuretunneling/commands/CloseTunnelCommand.ts +++ b/clients/client-iotsecuretunneling/commands/CloseTunnelCommand.ts @@ -24,6 +24,11 @@ import { export type CloseTunnelCommandInput = CloseTunnelRequest; export type CloseTunnelCommandOutput = CloseTunnelResponse & __MetadataBearer; +/** + *

Closes a tunnel identified by the unique tunnel id. When a CloseTunnel + * request is received, we close the WebSocket connections between the client and proxy + * server so no data can be transmitted.

+ */ export class CloseTunnelCommand extends $Command< CloseTunnelCommandInput, CloseTunnelCommandOutput, @@ -38,6 +43,9 @@ export class CloseTunnelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSecureTunnelingClientResolvedConfig, diff --git a/clients/client-iotsecuretunneling/commands/DescribeTunnelCommand.ts b/clients/client-iotsecuretunneling/commands/DescribeTunnelCommand.ts index 0f5a04091017f..c80d8474a323e 100644 --- a/clients/client-iotsecuretunneling/commands/DescribeTunnelCommand.ts +++ b/clients/client-iotsecuretunneling/commands/DescribeTunnelCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeTunnelCommandInput = DescribeTunnelRequest; export type DescribeTunnelCommandOutput = DescribeTunnelResponse & __MetadataBearer; +/** + *

Gets information about a tunnel identified by the unique tunnel id.

+ */ export class DescribeTunnelCommand extends $Command< DescribeTunnelCommandInput, DescribeTunnelCommandOutput, @@ -38,6 +41,9 @@ export class DescribeTunnelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSecureTunnelingClientResolvedConfig, diff --git a/clients/client-iotsecuretunneling/commands/ListTagsForResourceCommand.ts b/clients/client-iotsecuretunneling/commands/ListTagsForResourceCommand.ts index 21a73d59063b5..43b3ee1ad5a2b 100644 --- a/clients/client-iotsecuretunneling/commands/ListTagsForResourceCommand.ts +++ b/clients/client-iotsecuretunneling/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags for the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +41,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSecureTunnelingClientResolvedConfig, diff --git a/clients/client-iotsecuretunneling/commands/ListTunnelsCommand.ts b/clients/client-iotsecuretunneling/commands/ListTunnelsCommand.ts index bf5670996ee74..474205cab17e3 100644 --- a/clients/client-iotsecuretunneling/commands/ListTunnelsCommand.ts +++ b/clients/client-iotsecuretunneling/commands/ListTunnelsCommand.ts @@ -24,6 +24,10 @@ import { export type ListTunnelsCommandInput = ListTunnelsRequest; export type ListTunnelsCommandOutput = ListTunnelsResponse & __MetadataBearer; +/** + *

List all tunnels for an AWS account. Tunnels are listed by creation time in + * descending order, newer tunnels will be listed before older tunnels.

+ */ export class ListTunnelsCommand extends $Command< ListTunnelsCommandInput, ListTunnelsCommandOutput, @@ -38,6 +42,9 @@ export class ListTunnelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSecureTunnelingClientResolvedConfig, diff --git a/clients/client-iotsecuretunneling/commands/OpenTunnelCommand.ts b/clients/client-iotsecuretunneling/commands/OpenTunnelCommand.ts index 983557395940b..385c02baea3e6 100644 --- a/clients/client-iotsecuretunneling/commands/OpenTunnelCommand.ts +++ b/clients/client-iotsecuretunneling/commands/OpenTunnelCommand.ts @@ -24,6 +24,10 @@ import { export type OpenTunnelCommandInput = OpenTunnelRequest; export type OpenTunnelCommandOutput = OpenTunnelResponse & __MetadataBearer; +/** + *

Creates a new tunnel, and returns two client access tokens for clients to use to + * connect to the AWS IoT Secure Tunneling proxy server.

+ */ export class OpenTunnelCommand extends $Command< OpenTunnelCommandInput, OpenTunnelCommandOutput, @@ -38,6 +42,9 @@ export class OpenTunnelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSecureTunnelingClientResolvedConfig, diff --git a/clients/client-iotsecuretunneling/commands/TagResourceCommand.ts b/clients/client-iotsecuretunneling/commands/TagResourceCommand.ts index 439885214d6c8..9cfcd3f6ca030 100644 --- a/clients/client-iotsecuretunneling/commands/TagResourceCommand.ts +++ b/clients/client-iotsecuretunneling/commands/TagResourceCommand.ts @@ -24,6 +24,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

A resource tag.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +41,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSecureTunnelingClientResolvedConfig, diff --git a/clients/client-iotsecuretunneling/commands/UntagResourceCommand.ts b/clients/client-iotsecuretunneling/commands/UntagResourceCommand.ts index 7fbf7eb8febec..d6b0ea9cf06e8 100644 --- a/clients/client-iotsecuretunneling/commands/UntagResourceCommand.ts +++ b/clients/client-iotsecuretunneling/commands/UntagResourceCommand.ts @@ -24,6 +24,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +41,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSecureTunnelingClientResolvedConfig, diff --git a/clients/client-iotsecuretunneling/package.json b/clients/client-iotsecuretunneling/package.json index 4c6a7ff27520c..32d5480f1a6d9 100644 --- a/clients/client-iotsecuretunneling/package.json +++ b/clients/client-iotsecuretunneling/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iotsecuretunneling Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iotsecuretunneling/pagination/ListTunnelsPaginator.ts b/clients/client-iotsecuretunneling/pagination/ListTunnelsPaginator.ts index afcec62b575e5..8f87bec05dfdc 100644 --- a/clients/client-iotsecuretunneling/pagination/ListTunnelsPaginator.ts +++ b/clients/client-iotsecuretunneling/pagination/ListTunnelsPaginator.ts @@ -4,6 +4,9 @@ import { ListTunnelsCommand, ListTunnelsCommandInput, ListTunnelsCommandOutput } import { IoTSecureTunnelingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSecureTunnelingClient, input: ListTunnelsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTunnelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSecureTunneling, input: ListTunnelsCommandInput, diff --git a/clients/client-iotsecuretunneling/runtimeConfig.browser.ts b/clients/client-iotsecuretunneling/runtimeConfig.browser.ts index 6b9a5ec61ac62..9ae69ee462fef 100644 --- a/clients/client-iotsecuretunneling/runtimeConfig.browser.ts +++ b/clients/client-iotsecuretunneling/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTSecureTunnelingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iotsecuretunneling/runtimeConfig.native.ts b/clients/client-iotsecuretunneling/runtimeConfig.native.ts index be26f5c2ccb8d..6ebdb592cf139 100644 --- a/clients/client-iotsecuretunneling/runtimeConfig.native.ts +++ b/clients/client-iotsecuretunneling/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTSecureTunnelingClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iotsecuretunneling/runtimeConfig.shared.ts b/clients/client-iotsecuretunneling/runtimeConfig.shared.ts index b669f382502d9..9585dcd10e808 100644 --- a/clients/client-iotsecuretunneling/runtimeConfig.shared.ts +++ b/clients/client-iotsecuretunneling/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-10-05", disableHostPrefix: false, diff --git a/clients/client-iotsecuretunneling/runtimeConfig.ts b/clients/client-iotsecuretunneling/runtimeConfig.ts index 2122b51971771..5c767909f1e2a 100644 --- a/clients/client-iotsecuretunneling/runtimeConfig.ts +++ b/clients/client-iotsecuretunneling/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTSecureTunnelingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iotsecuretunneling/tsconfig.json b/clients/client-iotsecuretunneling/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iotsecuretunneling/tsconfig.json +++ b/clients/client-iotsecuretunneling/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iotsitewise/commands/AssociateAssetsCommand.ts b/clients/client-iotsitewise/commands/AssociateAssetsCommand.ts index 41b77204500de..70097cf52815a 100644 --- a/clients/client-iotsitewise/commands/AssociateAssetsCommand.ts +++ b/clients/client-iotsitewise/commands/AssociateAssetsCommand.ts @@ -20,6 +20,11 @@ import { export type AssociateAssetsCommandInput = AssociateAssetsRequest; export type AssociateAssetsCommandOutput = __MetadataBearer; +/** + *

Associates a child asset with the given parent asset through a hierarchy defined in the + * parent asset's model. For more information, see Associating assets in the + * AWS IoT SiteWise User Guide.

+ */ export class AssociateAssetsCommand extends $Command< AssociateAssetsCommandInput, AssociateAssetsCommandOutput, @@ -34,6 +39,9 @@ export class AssociateAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/BatchAssociateProjectAssetsCommand.ts b/clients/client-iotsitewise/commands/BatchAssociateProjectAssetsCommand.ts index d303a8585833d..55f805d7e2548 100644 --- a/clients/client-iotsitewise/commands/BatchAssociateProjectAssetsCommand.ts +++ b/clients/client-iotsitewise/commands/BatchAssociateProjectAssetsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchAssociateProjectAssetsCommandInput = BatchAssociateProjectAssetsRequest; export type BatchAssociateProjectAssetsCommandOutput = BatchAssociateProjectAssetsResponse & __MetadataBearer; +/** + *

Associates a group (batch) of assets with an AWS IoT SiteWise Monitor project.

+ */ export class BatchAssociateProjectAssetsCommand extends $Command< BatchAssociateProjectAssetsCommandInput, BatchAssociateProjectAssetsCommandOutput, @@ -34,6 +37,9 @@ export class BatchAssociateProjectAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/BatchDisassociateProjectAssetsCommand.ts b/clients/client-iotsitewise/commands/BatchDisassociateProjectAssetsCommand.ts index 21f2cf89a38b3..63a03e3b66091 100644 --- a/clients/client-iotsitewise/commands/BatchDisassociateProjectAssetsCommand.ts +++ b/clients/client-iotsitewise/commands/BatchDisassociateProjectAssetsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDisassociateProjectAssetsCommandInput = BatchDisassociateProjectAssetsRequest; export type BatchDisassociateProjectAssetsCommandOutput = BatchDisassociateProjectAssetsResponse & __MetadataBearer; +/** + *

Disassociates a group (batch) of assets from an AWS IoT SiteWise Monitor project.

+ */ export class BatchDisassociateProjectAssetsCommand extends $Command< BatchDisassociateProjectAssetsCommandInput, BatchDisassociateProjectAssetsCommandOutput, @@ -34,6 +37,9 @@ export class BatchDisassociateProjectAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/BatchPutAssetPropertyValueCommand.ts b/clients/client-iotsitewise/commands/BatchPutAssetPropertyValueCommand.ts index 54f57f59c0769..1894b8cc270dc 100644 --- a/clients/client-iotsitewise/commands/BatchPutAssetPropertyValueCommand.ts +++ b/clients/client-iotsitewise/commands/BatchPutAssetPropertyValueCommand.ts @@ -20,6 +20,33 @@ import { export type BatchPutAssetPropertyValueCommandInput = BatchPutAssetPropertyValueRequest; export type BatchPutAssetPropertyValueCommandOutput = BatchPutAssetPropertyValueResponse & __MetadataBearer; +/** + *

Sends a list of asset property values to AWS IoT SiteWise. Each value is a timestamp-quality-value + * (TQV) data point. For more information, see Ingesting data using the API in the + * AWS IoT SiteWise User Guide.

+ *

To identify an asset property, you must specify one of the following:

+ *
    + *
  • + *

    The assetId and propertyId of an asset property.

    + *
  • + *
  • + *

    A propertyAlias, which is a data stream alias (for example, + * /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

    + *
  • + *
+ * + *

With respect to Unix epoch time, AWS IoT SiteWise accepts only TQVs that have a timestamp of no more + * than 15 minutes in the past and no more than 5 minutes in the future. AWS IoT SiteWise rejects + * timestamps outside of the inclusive range of [-15, +5] minutes and returns a + * TimestampOutOfRangeException error.

+ *

For each asset property, AWS IoT SiteWise overwrites TQVs with duplicate timestamps unless the newer + * TQV has a different quality. For example, if you store a TQV {T1, GOOD, V1}, + * then storing {T1, GOOD, V2} replaces the existing TQV.

+ *
+ *

AWS IoT SiteWise authorizes access to each BatchPutAssetPropertyValue entry individually. + * For more information, see BatchPutAssetPropertyValue authorization in the + * AWS IoT SiteWise User Guide.

+ */ export class BatchPutAssetPropertyValueCommand extends $Command< BatchPutAssetPropertyValueCommandInput, BatchPutAssetPropertyValueCommandOutput, @@ -34,6 +61,9 @@ export class BatchPutAssetPropertyValueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/CreateAccessPolicyCommand.ts b/clients/client-iotsitewise/commands/CreateAccessPolicyCommand.ts index 5bcd852fbf050..f591f77689fc6 100644 --- a/clients/client-iotsitewise/commands/CreateAccessPolicyCommand.ts +++ b/clients/client-iotsitewise/commands/CreateAccessPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type CreateAccessPolicyCommandInput = CreateAccessPolicyRequest; export type CreateAccessPolicyCommandOutput = CreateAccessPolicyResponse & __MetadataBearer; +/** + *

Creates an access policy that grants the specified identity (AWS SSO user, AWS SSO group, or + * IAM user) access to the specified AWS IoT SiteWise Monitor portal or project resource.

+ */ export class CreateAccessPolicyCommand extends $Command< CreateAccessPolicyCommandInput, CreateAccessPolicyCommandOutput, @@ -34,6 +38,9 @@ export class CreateAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/CreateAssetCommand.ts b/clients/client-iotsitewise/commands/CreateAssetCommand.ts index 1efe023cc9389..01bc01a9b4694 100644 --- a/clients/client-iotsitewise/commands/CreateAssetCommand.ts +++ b/clients/client-iotsitewise/commands/CreateAssetCommand.ts @@ -20,6 +20,10 @@ import { export type CreateAssetCommandInput = CreateAssetRequest; export type CreateAssetCommandOutput = CreateAssetResponse & __MetadataBearer; +/** + *

Creates an asset from an existing asset model. For more information, see Creating assets in the + * AWS IoT SiteWise User Guide.

+ */ export class CreateAssetCommand extends $Command< CreateAssetCommandInput, CreateAssetCommandOutput, @@ -34,6 +38,9 @@ export class CreateAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/CreateAssetModelCommand.ts b/clients/client-iotsitewise/commands/CreateAssetModelCommand.ts index d1ec989254f8f..6a84f20547d6e 100644 --- a/clients/client-iotsitewise/commands/CreateAssetModelCommand.ts +++ b/clients/client-iotsitewise/commands/CreateAssetModelCommand.ts @@ -20,6 +20,13 @@ import { export type CreateAssetModelCommandInput = CreateAssetModelRequest; export type CreateAssetModelCommandOutput = CreateAssetModelResponse & __MetadataBearer; +/** + *

Creates an asset model from specified property and hierarchy definitions. You create + * assets from asset models. With asset models, you can easily create assets of the same type + * that have standardized definitions. Each asset created from a model inherits the asset model's + * property and hierarchy definitions. For more information, see Defining asset models in the + * AWS IoT SiteWise User Guide.

+ */ export class CreateAssetModelCommand extends $Command< CreateAssetModelCommandInput, CreateAssetModelCommandOutput, @@ -34,6 +41,9 @@ export class CreateAssetModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/CreateDashboardCommand.ts b/clients/client-iotsitewise/commands/CreateDashboardCommand.ts index 6d69000e47839..68742f6d467b4 100644 --- a/clients/client-iotsitewise/commands/CreateDashboardCommand.ts +++ b/clients/client-iotsitewise/commands/CreateDashboardCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDashboardCommandInput = CreateDashboardRequest; export type CreateDashboardCommandOutput = CreateDashboardResponse & __MetadataBearer; +/** + *

Creates a dashboard in an AWS IoT SiteWise Monitor project.

+ */ export class CreateDashboardCommand extends $Command< CreateDashboardCommandInput, CreateDashboardCommandOutput, @@ -34,6 +37,9 @@ export class CreateDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/CreateGatewayCommand.ts b/clients/client-iotsitewise/commands/CreateGatewayCommand.ts index fee6a3b253595..cec4ab821ea9d 100644 --- a/clients/client-iotsitewise/commands/CreateGatewayCommand.ts +++ b/clients/client-iotsitewise/commands/CreateGatewayCommand.ts @@ -20,6 +20,11 @@ import { export type CreateGatewayCommandInput = CreateGatewayRequest; export type CreateGatewayCommandOutput = CreateGatewayResponse & __MetadataBearer; +/** + *

Creates a gateway, which is a virtual or edge device that delivers industrial data streams + * from local servers to AWS IoT SiteWise. For more information, see Ingesting data using a gateway in the + * AWS IoT SiteWise User Guide.

+ */ export class CreateGatewayCommand extends $Command< CreateGatewayCommandInput, CreateGatewayCommandOutput, @@ -34,6 +39,9 @@ export class CreateGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/CreatePortalCommand.ts b/clients/client-iotsitewise/commands/CreatePortalCommand.ts index 4776a5337b27b..6c0624f5813e3 100644 --- a/clients/client-iotsitewise/commands/CreatePortalCommand.ts +++ b/clients/client-iotsitewise/commands/CreatePortalCommand.ts @@ -20,6 +20,15 @@ import { export type CreatePortalCommandInput = CreatePortalRequest; export type CreatePortalCommandOutput = CreatePortalResponse & __MetadataBearer; +/** + *

Creates a portal, which can contain projects and dashboards. AWS IoT SiteWise Monitor uses AWS SSO or IAM + * to authenticate portal users and manage user permissions.

+ * + *

Before you can sign in to a new portal, you must add at least one identity to that + * portal. For more information, see Adding or removing portal + * administrators in the AWS IoT SiteWise User Guide.

+ *
+ */ export class CreatePortalCommand extends $Command< CreatePortalCommandInput, CreatePortalCommandOutput, @@ -34,6 +43,9 @@ export class CreatePortalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/CreatePresignedPortalUrlCommand.ts b/clients/client-iotsitewise/commands/CreatePresignedPortalUrlCommand.ts index 230c744cca0d9..c01c56920d0d5 100644 --- a/clients/client-iotsitewise/commands/CreatePresignedPortalUrlCommand.ts +++ b/clients/client-iotsitewise/commands/CreatePresignedPortalUrlCommand.ts @@ -20,6 +20,12 @@ import { export type CreatePresignedPortalUrlCommandInput = CreatePresignedPortalUrlRequest; export type CreatePresignedPortalUrlCommandOutput = CreatePresignedPortalUrlResponse & __MetadataBearer; +/** + *

Creates a pre-signed URL to a portal. Use this operation to create URLs to portals that + * use AWS Identity and Access Management (IAM) to authenticate users. An IAM user with access to a portal can call this API + * to get a URL to that portal. The URL contains a session token that lets the IAM user access + * the portal.

+ */ export class CreatePresignedPortalUrlCommand extends $Command< CreatePresignedPortalUrlCommandInput, CreatePresignedPortalUrlCommandOutput, @@ -34,6 +40,9 @@ export class CreatePresignedPortalUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/CreateProjectCommand.ts b/clients/client-iotsitewise/commands/CreateProjectCommand.ts index a5b818997a537..51075430a9902 100644 --- a/clients/client-iotsitewise/commands/CreateProjectCommand.ts +++ b/clients/client-iotsitewise/commands/CreateProjectCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProjectCommandInput = CreateProjectRequest; export type CreateProjectCommandOutput = CreateProjectResponse & __MetadataBearer; +/** + *

Creates a project in the specified portal.

+ */ export class CreateProjectCommand extends $Command< CreateProjectCommandInput, CreateProjectCommandOutput, @@ -34,6 +37,9 @@ export class CreateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DeleteAccessPolicyCommand.ts b/clients/client-iotsitewise/commands/DeleteAccessPolicyCommand.ts index 309221643732f..bae38a9bc3a20 100644 --- a/clients/client-iotsitewise/commands/DeleteAccessPolicyCommand.ts +++ b/clients/client-iotsitewise/commands/DeleteAccessPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteAccessPolicyCommandInput = DeleteAccessPolicyRequest; export type DeleteAccessPolicyCommandOutput = DeleteAccessPolicyResponse & __MetadataBearer; +/** + *

Deletes an access policy that grants the specified identity access to the specified + * AWS IoT SiteWise Monitor resource. You can use this operation to revoke access to an AWS IoT SiteWise Monitor + * resource.

+ */ export class DeleteAccessPolicyCommand extends $Command< DeleteAccessPolicyCommandInput, DeleteAccessPolicyCommandOutput, @@ -34,6 +39,9 @@ export class DeleteAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DeleteAssetCommand.ts b/clients/client-iotsitewise/commands/DeleteAssetCommand.ts index 18bf024b7e900..0b38cfc4c3d3e 100644 --- a/clients/client-iotsitewise/commands/DeleteAssetCommand.ts +++ b/clients/client-iotsitewise/commands/DeleteAssetCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteAssetCommandInput = DeleteAssetRequest; export type DeleteAssetCommandOutput = DeleteAssetResponse & __MetadataBearer; +/** + *

Deletes an asset. This action can't be undone. For more information, see Deleting assets and + * models in the AWS IoT SiteWise User Guide. + *

+ * + *

You can't delete an asset that's associated to another asset. For more information, see + * DisassociateAssets.

+ *
+ */ export class DeleteAssetCommand extends $Command< DeleteAssetCommandInput, DeleteAssetCommandOutput, @@ -34,6 +43,9 @@ export class DeleteAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DeleteAssetModelCommand.ts b/clients/client-iotsitewise/commands/DeleteAssetModelCommand.ts index d38f4e8d15308..510dee3823534 100644 --- a/clients/client-iotsitewise/commands/DeleteAssetModelCommand.ts +++ b/clients/client-iotsitewise/commands/DeleteAssetModelCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteAssetModelCommandInput = DeleteAssetModelRequest; export type DeleteAssetModelCommandOutput = DeleteAssetModelResponse & __MetadataBearer; +/** + *

Deletes an asset model. This action can't be undone. You must delete all assets created + * from an asset model before you can delete the model. Also, you can't delete an asset model if + * a parent asset model exists that contains a property formula expression that depends on the + * asset model that you want to delete. For more information, see Deleting assets and models in the + * AWS IoT SiteWise User Guide.

+ */ export class DeleteAssetModelCommand extends $Command< DeleteAssetModelCommandInput, DeleteAssetModelCommandOutput, @@ -34,6 +41,9 @@ export class DeleteAssetModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DeleteDashboardCommand.ts b/clients/client-iotsitewise/commands/DeleteDashboardCommand.ts index 9817e733e059f..4f857410a9e04 100644 --- a/clients/client-iotsitewise/commands/DeleteDashboardCommand.ts +++ b/clients/client-iotsitewise/commands/DeleteDashboardCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDashboardCommandInput = DeleteDashboardRequest; export type DeleteDashboardCommandOutput = DeleteDashboardResponse & __MetadataBearer; +/** + *

Deletes a dashboard from AWS IoT SiteWise Monitor.

+ */ export class DeleteDashboardCommand extends $Command< DeleteDashboardCommandInput, DeleteDashboardCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DeleteGatewayCommand.ts b/clients/client-iotsitewise/commands/DeleteGatewayCommand.ts index f52a51f209ef4..37efadc09d278 100644 --- a/clients/client-iotsitewise/commands/DeleteGatewayCommand.ts +++ b/clients/client-iotsitewise/commands/DeleteGatewayCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteGatewayCommandInput = DeleteGatewayRequest; export type DeleteGatewayCommandOutput = __MetadataBearer; +/** + *

Deletes a gateway from AWS IoT SiteWise. When you delete a gateway, some of the gateway's files remain + * in your gateway's file system.

+ */ export class DeleteGatewayCommand extends $Command< DeleteGatewayCommandInput, DeleteGatewayCommandOutput, @@ -34,6 +38,9 @@ export class DeleteGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DeletePortalCommand.ts b/clients/client-iotsitewise/commands/DeletePortalCommand.ts index a88e64b6d0e49..861579e065682 100644 --- a/clients/client-iotsitewise/commands/DeletePortalCommand.ts +++ b/clients/client-iotsitewise/commands/DeletePortalCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePortalCommandInput = DeletePortalRequest; export type DeletePortalCommandOutput = DeletePortalResponse & __MetadataBearer; +/** + *

Deletes a portal from AWS IoT SiteWise Monitor.

+ */ export class DeletePortalCommand extends $Command< DeletePortalCommandInput, DeletePortalCommandOutput, @@ -34,6 +37,9 @@ export class DeletePortalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DeleteProjectCommand.ts b/clients/client-iotsitewise/commands/DeleteProjectCommand.ts index 0d0e7ae0c0496..583d9b649484c 100644 --- a/clients/client-iotsitewise/commands/DeleteProjectCommand.ts +++ b/clients/client-iotsitewise/commands/DeleteProjectCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProjectCommandInput = DeleteProjectRequest; export type DeleteProjectCommandOutput = DeleteProjectResponse & __MetadataBearer; +/** + *

Deletes a project from AWS IoT SiteWise Monitor.

+ */ export class DeleteProjectCommand extends $Command< DeleteProjectCommandInput, DeleteProjectCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeAccessPolicyCommand.ts b/clients/client-iotsitewise/commands/DescribeAccessPolicyCommand.ts index 1b3b7eaa218ea..8b49d99189c78 100644 --- a/clients/client-iotsitewise/commands/DescribeAccessPolicyCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeAccessPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAccessPolicyCommandInput = DescribeAccessPolicyRequest; export type DescribeAccessPolicyCommandOutput = DescribeAccessPolicyResponse & __MetadataBearer; +/** + *

Describes an access policy, which specifies an identity's access to an AWS IoT SiteWise Monitor portal or + * project.

+ */ export class DescribeAccessPolicyCommand extends $Command< DescribeAccessPolicyCommandInput, DescribeAccessPolicyCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeAssetCommand.ts b/clients/client-iotsitewise/commands/DescribeAssetCommand.ts index 85231243c68cf..f5506ece98d88 100644 --- a/clients/client-iotsitewise/commands/DescribeAssetCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeAssetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAssetCommandInput = DescribeAssetRequest; export type DescribeAssetCommandOutput = DescribeAssetResponse & __MetadataBearer; +/** + *

Retrieves information about an asset.

+ */ export class DescribeAssetCommand extends $Command< DescribeAssetCommandInput, DescribeAssetCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeAssetModelCommand.ts b/clients/client-iotsitewise/commands/DescribeAssetModelCommand.ts index e14c60259e548..3a345e3f56ef5 100644 --- a/clients/client-iotsitewise/commands/DescribeAssetModelCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeAssetModelCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAssetModelCommandInput = DescribeAssetModelRequest; export type DescribeAssetModelCommandOutput = DescribeAssetModelResponse & __MetadataBearer; +/** + *

Retrieves information about an asset model.

+ */ export class DescribeAssetModelCommand extends $Command< DescribeAssetModelCommandInput, DescribeAssetModelCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAssetModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeAssetPropertyCommand.ts b/clients/client-iotsitewise/commands/DescribeAssetPropertyCommand.ts index 7081a719fd807..7c479ec333a91 100644 --- a/clients/client-iotsitewise/commands/DescribeAssetPropertyCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeAssetPropertyCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeAssetPropertyCommandInput = DescribeAssetPropertyRequest; export type DescribeAssetPropertyCommandOutput = DescribeAssetPropertyResponse & __MetadataBearer; +/** + *

Retrieves information about an asset property.

+ * + *

When you call this operation for an attribute property, this response includes the + * default attribute value that you define in the asset model. If you update the default value + * in the model, this operation's response includes the new default value.

+ *
+ *

This operation doesn't return the value of the asset property. To get the value of an + * asset property, use GetAssetPropertyValue.

+ */ export class DescribeAssetPropertyCommand extends $Command< DescribeAssetPropertyCommandInput, DescribeAssetPropertyCommandOutput, @@ -34,6 +44,9 @@ export class DescribeAssetPropertyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeDashboardCommand.ts b/clients/client-iotsitewise/commands/DescribeDashboardCommand.ts index 1f4ed9a315a8a..c71b3e24e4286 100644 --- a/clients/client-iotsitewise/commands/DescribeDashboardCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeDashboardCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDashboardCommandInput = DescribeDashboardRequest; export type DescribeDashboardCommandOutput = DescribeDashboardResponse & __MetadataBearer; +/** + *

Retrieves information about a dashboard.

+ */ export class DescribeDashboardCommand extends $Command< DescribeDashboardCommandInput, DescribeDashboardCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeGatewayCapabilityConfigurationCommand.ts b/clients/client-iotsitewise/commands/DescribeGatewayCapabilityConfigurationCommand.ts index 98703e586dd9f..19f261f8ddb8b 100644 --- a/clients/client-iotsitewise/commands/DescribeGatewayCapabilityConfigurationCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeGatewayCapabilityConfigurationCommand.ts @@ -24,6 +24,13 @@ export type DescribeGatewayCapabilityConfigurationCommandInput = DescribeGateway export type DescribeGatewayCapabilityConfigurationCommandOutput = DescribeGatewayCapabilityConfigurationResponse & __MetadataBearer; +/** + *

Retrieves information about a gateway capability configuration. + * Each gateway capability defines data sources for a gateway. A capability configuration + * can contain multiple data source configurations. If you define OPC-UA sources for a gateway in + * the AWS IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To + * list all capability configurations for a gateway, use DescribeGateway.

+ */ export class DescribeGatewayCapabilityConfigurationCommand extends $Command< DescribeGatewayCapabilityConfigurationCommandInput, DescribeGatewayCapabilityConfigurationCommandOutput, @@ -38,6 +45,9 @@ export class DescribeGatewayCapabilityConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeGatewayCommand.ts b/clients/client-iotsitewise/commands/DescribeGatewayCommand.ts index 38f2d3bf03fdd..e523a1aa875f9 100644 --- a/clients/client-iotsitewise/commands/DescribeGatewayCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeGatewayCommandInput = DescribeGatewayRequest; export type DescribeGatewayCommandOutput = DescribeGatewayResponse & __MetadataBearer; +/** + *

Retrieves information about a gateway.

+ */ export class DescribeGatewayCommand extends $Command< DescribeGatewayCommandInput, DescribeGatewayCommandOutput, @@ -34,6 +37,9 @@ export class DescribeGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeLoggingOptionsCommand.ts b/clients/client-iotsitewise/commands/DescribeLoggingOptionsCommand.ts index 5fb6ce7f2ca2d..d50e64bd9415e 100644 --- a/clients/client-iotsitewise/commands/DescribeLoggingOptionsCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeLoggingOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLoggingOptionsCommandInput = DescribeLoggingOptionsRequest; export type DescribeLoggingOptionsCommandOutput = DescribeLoggingOptionsResponse & __MetadataBearer; +/** + *

Retrieves the current AWS IoT SiteWise logging options.

+ */ export class DescribeLoggingOptionsCommand extends $Command< DescribeLoggingOptionsCommandInput, DescribeLoggingOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribePortalCommand.ts b/clients/client-iotsitewise/commands/DescribePortalCommand.ts index 54e7876b63c55..5f904760dd03b 100644 --- a/clients/client-iotsitewise/commands/DescribePortalCommand.ts +++ b/clients/client-iotsitewise/commands/DescribePortalCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePortalCommandInput = DescribePortalRequest; export type DescribePortalCommandOutput = DescribePortalResponse & __MetadataBearer; +/** + *

Retrieves information about a portal.

+ */ export class DescribePortalCommand extends $Command< DescribePortalCommandInput, DescribePortalCommandOutput, @@ -34,6 +37,9 @@ export class DescribePortalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DescribeProjectCommand.ts b/clients/client-iotsitewise/commands/DescribeProjectCommand.ts index 7a149b6855b82..62c6868fef8da 100644 --- a/clients/client-iotsitewise/commands/DescribeProjectCommand.ts +++ b/clients/client-iotsitewise/commands/DescribeProjectCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProjectCommandInput = DescribeProjectRequest; export type DescribeProjectCommandOutput = DescribeProjectResponse & __MetadataBearer; +/** + *

Retrieves information about a project.

+ */ export class DescribeProjectCommand extends $Command< DescribeProjectCommandInput, DescribeProjectCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/DisassociateAssetsCommand.ts b/clients/client-iotsitewise/commands/DisassociateAssetsCommand.ts index afb77bfb067cb..4b64c572f04e7 100644 --- a/clients/client-iotsitewise/commands/DisassociateAssetsCommand.ts +++ b/clients/client-iotsitewise/commands/DisassociateAssetsCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateAssetsCommandInput = DisassociateAssetsRequest; export type DisassociateAssetsCommandOutput = __MetadataBearer; +/** + *

Disassociates a child asset from the given parent asset through a hierarchy defined in the + * parent asset's model.

+ */ export class DisassociateAssetsCommand extends $Command< DisassociateAssetsCommandInput, DisassociateAssetsCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/GetAssetPropertyAggregatesCommand.ts b/clients/client-iotsitewise/commands/GetAssetPropertyAggregatesCommand.ts index d7453f0a55e05..dfea9cb4cdf9d 100644 --- a/clients/client-iotsitewise/commands/GetAssetPropertyAggregatesCommand.ts +++ b/clients/client-iotsitewise/commands/GetAssetPropertyAggregatesCommand.ts @@ -20,6 +20,20 @@ import { export type GetAssetPropertyAggregatesCommandInput = GetAssetPropertyAggregatesRequest; export type GetAssetPropertyAggregatesCommandOutput = GetAssetPropertyAggregatesResponse & __MetadataBearer; +/** + *

Gets aggregated values for an asset property. For more information, see Querying + * aggregates in the AWS IoT SiteWise User Guide.

+ *

To identify an asset property, you must specify one of the following:

+ *
    + *
  • + *

    The assetId and propertyId of an asset property.

    + *
  • + *
  • + *

    A propertyAlias, which is a data stream alias (for example, + * /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

    + *
  • + *
+ */ export class GetAssetPropertyAggregatesCommand extends $Command< GetAssetPropertyAggregatesCommandInput, GetAssetPropertyAggregatesCommandOutput, @@ -34,6 +48,9 @@ export class GetAssetPropertyAggregatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/GetAssetPropertyValueCommand.ts b/clients/client-iotsitewise/commands/GetAssetPropertyValueCommand.ts index c6092da2d841f..89f46ca78fb8f 100644 --- a/clients/client-iotsitewise/commands/GetAssetPropertyValueCommand.ts +++ b/clients/client-iotsitewise/commands/GetAssetPropertyValueCommand.ts @@ -20,6 +20,20 @@ import { export type GetAssetPropertyValueCommandInput = GetAssetPropertyValueRequest; export type GetAssetPropertyValueCommandOutput = GetAssetPropertyValueResponse & __MetadataBearer; +/** + *

Gets an asset property's current value. For more information, see Querying + * current values in the AWS IoT SiteWise User Guide.

+ *

To identify an asset property, you must specify one of the following:

+ *
    + *
  • + *

    The assetId and propertyId of an asset property.

    + *
  • + *
  • + *

    A propertyAlias, which is a data stream alias (for example, + * /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

    + *
  • + *
+ */ export class GetAssetPropertyValueCommand extends $Command< GetAssetPropertyValueCommandInput, GetAssetPropertyValueCommandOutput, @@ -34,6 +48,9 @@ export class GetAssetPropertyValueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/GetAssetPropertyValueHistoryCommand.ts b/clients/client-iotsitewise/commands/GetAssetPropertyValueHistoryCommand.ts index 556379a863c37..7ee704bfc57c4 100644 --- a/clients/client-iotsitewise/commands/GetAssetPropertyValueHistoryCommand.ts +++ b/clients/client-iotsitewise/commands/GetAssetPropertyValueHistoryCommand.ts @@ -20,6 +20,20 @@ import { export type GetAssetPropertyValueHistoryCommandInput = GetAssetPropertyValueHistoryRequest; export type GetAssetPropertyValueHistoryCommandOutput = GetAssetPropertyValueHistoryResponse & __MetadataBearer; +/** + *

Gets the history of an asset property's values. For more information, see Querying + * historical values in the AWS IoT SiteWise User Guide.

+ *

To identify an asset property, you must specify one of the following:

+ *
    + *
  • + *

    The assetId and propertyId of an asset property.

    + *
  • + *
  • + *

    A propertyAlias, which is a data stream alias (for example, + * /company/windfarm/3/turbine/7/temperature). To define an asset property's alias, see UpdateAssetProperty.

    + *
  • + *
+ */ export class GetAssetPropertyValueHistoryCommand extends $Command< GetAssetPropertyValueHistoryCommandInput, GetAssetPropertyValueHistoryCommandOutput, @@ -34,6 +48,9 @@ export class GetAssetPropertyValueHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListAccessPoliciesCommand.ts b/clients/client-iotsitewise/commands/ListAccessPoliciesCommand.ts index 18a87245bf992..08ca6627afd1f 100644 --- a/clients/client-iotsitewise/commands/ListAccessPoliciesCommand.ts +++ b/clients/client-iotsitewise/commands/ListAccessPoliciesCommand.ts @@ -20,6 +20,10 @@ import { export type ListAccessPoliciesCommandInput = ListAccessPoliciesRequest; export type ListAccessPoliciesCommandOutput = ListAccessPoliciesResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of access policies for an identity (an AWS SSO user, an AWS SSO + * group, or an IAM user) or an AWS IoT SiteWise Monitor resource (a portal or project).

+ */ export class ListAccessPoliciesCommand extends $Command< ListAccessPoliciesCommandInput, ListAccessPoliciesCommandOutput, @@ -34,6 +38,9 @@ export class ListAccessPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListAssetModelsCommand.ts b/clients/client-iotsitewise/commands/ListAssetModelsCommand.ts index 3888e9de9da4d..efac7135bf10b 100644 --- a/clients/client-iotsitewise/commands/ListAssetModelsCommand.ts +++ b/clients/client-iotsitewise/commands/ListAssetModelsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAssetModelsCommandInput = ListAssetModelsRequest; export type ListAssetModelsCommandOutput = ListAssetModelsResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of summaries of all asset models.

+ */ export class ListAssetModelsCommand extends $Command< ListAssetModelsCommandInput, ListAssetModelsCommandOutput, @@ -34,6 +37,9 @@ export class ListAssetModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListAssetsCommand.ts b/clients/client-iotsitewise/commands/ListAssetsCommand.ts index bfa8b714d3ace..65505a8fd5656 100644 --- a/clients/client-iotsitewise/commands/ListAssetsCommand.ts +++ b/clients/client-iotsitewise/commands/ListAssetsCommand.ts @@ -20,6 +20,21 @@ import { export type ListAssetsCommandInput = ListAssetsRequest; export type ListAssetsCommandOutput = ListAssetsResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of asset summaries.

+ *

You can use this operation to do the following:

+ *
    + *
  • + *

    List assets based on a specific asset model.

    + *
  • + *
  • + *

    List top-level assets.

    + *
  • + *
+ *

You can't use this operation to list all assets. To retrieve summaries for all of your + * assets, use ListAssetModels to get all of your asset model IDs. Then, use ListAssets to get all + * assets for each asset model.

+ */ export class ListAssetsCommand extends $Command< ListAssetsCommandInput, ListAssetsCommandOutput, @@ -34,6 +49,9 @@ export class ListAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListAssociatedAssetsCommand.ts b/clients/client-iotsitewise/commands/ListAssociatedAssetsCommand.ts index 90d17995fcdba..b8920675a4c01 100644 --- a/clients/client-iotsitewise/commands/ListAssociatedAssetsCommand.ts +++ b/clients/client-iotsitewise/commands/ListAssociatedAssetsCommand.ts @@ -20,6 +20,18 @@ import { export type ListAssociatedAssetsCommandInput = ListAssociatedAssetsRequest; export type ListAssociatedAssetsCommandOutput = ListAssociatedAssetsResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of associated assets.

+ *

You can use this operation to do the following:

+ *
    + *
  • + *

    List child assets associated to a parent asset by a hierarchy that you specify.

    + *
  • + *
  • + *

    List an asset's parent asset.

    + *
  • + *
+ */ export class ListAssociatedAssetsCommand extends $Command< ListAssociatedAssetsCommandInput, ListAssociatedAssetsCommandOutput, @@ -34,6 +46,9 @@ export class ListAssociatedAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListDashboardsCommand.ts b/clients/client-iotsitewise/commands/ListDashboardsCommand.ts index 4b00777c378cf..cae04e52d2747 100644 --- a/clients/client-iotsitewise/commands/ListDashboardsCommand.ts +++ b/clients/client-iotsitewise/commands/ListDashboardsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDashboardsCommandInput = ListDashboardsRequest; export type ListDashboardsCommandOutput = ListDashboardsResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of dashboards for an AWS IoT SiteWise Monitor project.

+ */ export class ListDashboardsCommand extends $Command< ListDashboardsCommandInput, ListDashboardsCommandOutput, @@ -34,6 +37,9 @@ export class ListDashboardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListGatewaysCommand.ts b/clients/client-iotsitewise/commands/ListGatewaysCommand.ts index 2ba21531b1d07..d90461b2a7e9a 100644 --- a/clients/client-iotsitewise/commands/ListGatewaysCommand.ts +++ b/clients/client-iotsitewise/commands/ListGatewaysCommand.ts @@ -20,6 +20,9 @@ import { export type ListGatewaysCommandInput = ListGatewaysRequest; export type ListGatewaysCommandOutput = ListGatewaysResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of gateways.

+ */ export class ListGatewaysCommand extends $Command< ListGatewaysCommandInput, ListGatewaysCommandOutput, @@ -34,6 +37,9 @@ export class ListGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListPortalsCommand.ts b/clients/client-iotsitewise/commands/ListPortalsCommand.ts index bdd3cc8e903d9..7fd7e06383b8c 100644 --- a/clients/client-iotsitewise/commands/ListPortalsCommand.ts +++ b/clients/client-iotsitewise/commands/ListPortalsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPortalsCommandInput = ListPortalsRequest; export type ListPortalsCommandOutput = ListPortalsResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of AWS IoT SiteWise Monitor portals.

+ */ export class ListPortalsCommand extends $Command< ListPortalsCommandInput, ListPortalsCommandOutput, @@ -34,6 +37,9 @@ export class ListPortalsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListProjectAssetsCommand.ts b/clients/client-iotsitewise/commands/ListProjectAssetsCommand.ts index 7aca2278e2aa2..a30c3f2b9a0a3 100644 --- a/clients/client-iotsitewise/commands/ListProjectAssetsCommand.ts +++ b/clients/client-iotsitewise/commands/ListProjectAssetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProjectAssetsCommandInput = ListProjectAssetsRequest; export type ListProjectAssetsCommandOutput = ListProjectAssetsResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of assets associated with an AWS IoT SiteWise Monitor project.

+ */ export class ListProjectAssetsCommand extends $Command< ListProjectAssetsCommandInput, ListProjectAssetsCommandOutput, @@ -34,6 +37,9 @@ export class ListProjectAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListProjectsCommand.ts b/clients/client-iotsitewise/commands/ListProjectsCommand.ts index 8539230e1a29f..949eb953a5d70 100644 --- a/clients/client-iotsitewise/commands/ListProjectsCommand.ts +++ b/clients/client-iotsitewise/commands/ListProjectsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProjectsCommandInput = ListProjectsRequest; export type ListProjectsCommandOutput = ListProjectsResponse & __MetadataBearer; +/** + *

Retrieves a paginated list of projects for an AWS IoT SiteWise Monitor portal.

+ */ export class ListProjectsCommand extends $Command< ListProjectsCommandInput, ListProjectsCommandOutput, @@ -34,6 +37,9 @@ export class ListProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/ListTagsForResourceCommand.ts b/clients/client-iotsitewise/commands/ListTagsForResourceCommand.ts index 0c3f8a05f6a1a..327350697c190 100644 --- a/clients/client-iotsitewise/commands/ListTagsForResourceCommand.ts +++ b/clients/client-iotsitewise/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves the list of tags for an AWS IoT SiteWise resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/PutLoggingOptionsCommand.ts b/clients/client-iotsitewise/commands/PutLoggingOptionsCommand.ts index e14014789942d..75e8b14191569 100644 --- a/clients/client-iotsitewise/commands/PutLoggingOptionsCommand.ts +++ b/clients/client-iotsitewise/commands/PutLoggingOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type PutLoggingOptionsCommandInput = PutLoggingOptionsRequest; export type PutLoggingOptionsCommandOutput = PutLoggingOptionsResponse & __MetadataBearer; +/** + *

Sets logging options for AWS IoT SiteWise.

+ */ export class PutLoggingOptionsCommand extends $Command< PutLoggingOptionsCommandInput, PutLoggingOptionsCommandOutput, @@ -34,6 +37,9 @@ export class PutLoggingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/TagResourceCommand.ts b/clients/client-iotsitewise/commands/TagResourceCommand.ts index 1bae0d727ee3f..6ad1d495906e7 100644 --- a/clients/client-iotsitewise/commands/TagResourceCommand.ts +++ b/clients/client-iotsitewise/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds tags to an AWS IoT SiteWise resource. If a tag already exists for the resource, this operation + * updates the tag's value.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UntagResourceCommand.ts b/clients/client-iotsitewise/commands/UntagResourceCommand.ts index dfeed08e8ce87..ae253c64d2871 100644 --- a/clients/client-iotsitewise/commands/UntagResourceCommand.ts +++ b/clients/client-iotsitewise/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag from an AWS IoT SiteWise resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdateAccessPolicyCommand.ts b/clients/client-iotsitewise/commands/UpdateAccessPolicyCommand.ts index fb1973c075863..66df326c90d47 100644 --- a/clients/client-iotsitewise/commands/UpdateAccessPolicyCommand.ts +++ b/clients/client-iotsitewise/commands/UpdateAccessPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateAccessPolicyCommandInput = UpdateAccessPolicyRequest; export type UpdateAccessPolicyCommandOutput = UpdateAccessPolicyResponse & __MetadataBearer; +/** + *

Updates an existing access policy that specifies an identity's access to an AWS IoT SiteWise Monitor + * portal or project resource.

+ */ export class UpdateAccessPolicyCommand extends $Command< UpdateAccessPolicyCommandInput, UpdateAccessPolicyCommandOutput, @@ -34,6 +38,9 @@ export class UpdateAccessPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdateAssetCommand.ts b/clients/client-iotsitewise/commands/UpdateAssetCommand.ts index 54175cfeb0e4a..9d4ef54b7e903 100644 --- a/clients/client-iotsitewise/commands/UpdateAssetCommand.ts +++ b/clients/client-iotsitewise/commands/UpdateAssetCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateAssetCommandInput = UpdateAssetRequest; export type UpdateAssetCommandOutput = UpdateAssetResponse & __MetadataBearer; +/** + *

Updates an asset's name. For more information, see Updating assets and models in the + * AWS IoT SiteWise User Guide.

+ */ export class UpdateAssetCommand extends $Command< UpdateAssetCommandInput, UpdateAssetCommandOutput, @@ -34,6 +38,9 @@ export class UpdateAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdateAssetModelCommand.ts b/clients/client-iotsitewise/commands/UpdateAssetModelCommand.ts index 05147acac6559..67f52b86ec759 100644 --- a/clients/client-iotsitewise/commands/UpdateAssetModelCommand.ts +++ b/clients/client-iotsitewise/commands/UpdateAssetModelCommand.ts @@ -20,6 +20,21 @@ import { export type UpdateAssetModelCommandInput = UpdateAssetModelRequest; export type UpdateAssetModelCommandOutput = UpdateAssetModelResponse & __MetadataBearer; +/** + *

Updates an asset model and all of the assets that were created from the model. Each asset + * created from the model inherits the updated asset model's property and hierarchy definitions. + * For more information, see Updating assets and models in the + * AWS IoT SiteWise User Guide.

+ * + *

This operation overwrites the existing model with the provided model. To avoid deleting + * your asset model's properties or hierarchies, you must include their IDs and definitions in + * the updated asset model payload. For more information, see DescribeAssetModel.

+ *

If you remove a property from an asset model, AWS IoT SiteWise deletes all previous data for that + * property. If you remove a hierarchy definition from an asset model, AWS IoT SiteWise disassociates every + * asset associated with that hierarchy. You can't change the type or data type of an existing + * property.

+ *
+ */ export class UpdateAssetModelCommand extends $Command< UpdateAssetModelCommandInput, UpdateAssetModelCommandOutput, @@ -34,6 +49,9 @@ export class UpdateAssetModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdateAssetPropertyCommand.ts b/clients/client-iotsitewise/commands/UpdateAssetPropertyCommand.ts index 91669abfdfc38..70ec6cfa96c50 100644 --- a/clients/client-iotsitewise/commands/UpdateAssetPropertyCommand.ts +++ b/clients/client-iotsitewise/commands/UpdateAssetPropertyCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateAssetPropertyCommandInput = UpdateAssetPropertyRequest; export type UpdateAssetPropertyCommandOutput = __MetadataBearer; +/** + *

Updates an asset property's alias and notification state.

+ * + *

This operation overwrites the property's existing alias and notification state. To keep + * your existing property's alias or notification state, you must include the existing values + * in the UpdateAssetProperty request. For more information, see DescribeAssetProperty.

+ *
+ */ export class UpdateAssetPropertyCommand extends $Command< UpdateAssetPropertyCommandInput, UpdateAssetPropertyCommandOutput, @@ -34,6 +42,9 @@ export class UpdateAssetPropertyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdateDashboardCommand.ts b/clients/client-iotsitewise/commands/UpdateDashboardCommand.ts index 0330aab15905f..827c3d3c91aae 100644 --- a/clients/client-iotsitewise/commands/UpdateDashboardCommand.ts +++ b/clients/client-iotsitewise/commands/UpdateDashboardCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDashboardCommandInput = UpdateDashboardRequest; export type UpdateDashboardCommandOutput = UpdateDashboardResponse & __MetadataBearer; +/** + *

Updates an AWS IoT SiteWise Monitor dashboard.

+ */ export class UpdateDashboardCommand extends $Command< UpdateDashboardCommandInput, UpdateDashboardCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdateGatewayCapabilityConfigurationCommand.ts b/clients/client-iotsitewise/commands/UpdateGatewayCapabilityConfigurationCommand.ts index 63402c0389e60..0d0b3f5b05b30 100644 --- a/clients/client-iotsitewise/commands/UpdateGatewayCapabilityConfigurationCommand.ts +++ b/clients/client-iotsitewise/commands/UpdateGatewayCapabilityConfigurationCommand.ts @@ -24,6 +24,13 @@ export type UpdateGatewayCapabilityConfigurationCommandInput = UpdateGatewayCapa export type UpdateGatewayCapabilityConfigurationCommandOutput = UpdateGatewayCapabilityConfigurationResponse & __MetadataBearer; +/** + *

Updates a gateway capability configuration or defines a new capability configuration. + * Each gateway capability defines data sources for a gateway. A capability configuration + * can contain multiple data source configurations. If you define OPC-UA sources for a gateway in + * the AWS IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To + * list all capability configurations for a gateway, use DescribeGateway.

+ */ export class UpdateGatewayCapabilityConfigurationCommand extends $Command< UpdateGatewayCapabilityConfigurationCommandInput, UpdateGatewayCapabilityConfigurationCommandOutput, @@ -38,6 +45,9 @@ export class UpdateGatewayCapabilityConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdateGatewayCommand.ts b/clients/client-iotsitewise/commands/UpdateGatewayCommand.ts index c90f2f21cfcdf..31243bd520a60 100644 --- a/clients/client-iotsitewise/commands/UpdateGatewayCommand.ts +++ b/clients/client-iotsitewise/commands/UpdateGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGatewayCommandInput = UpdateGatewayRequest; export type UpdateGatewayCommandOutput = __MetadataBearer; +/** + *

Updates a gateway's name.

+ */ export class UpdateGatewayCommand extends $Command< UpdateGatewayCommandInput, UpdateGatewayCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdatePortalCommand.ts b/clients/client-iotsitewise/commands/UpdatePortalCommand.ts index bc66eb14085c8..210dc4972af17 100644 --- a/clients/client-iotsitewise/commands/UpdatePortalCommand.ts +++ b/clients/client-iotsitewise/commands/UpdatePortalCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePortalCommandInput = UpdatePortalRequest; export type UpdatePortalCommandOutput = UpdatePortalResponse & __MetadataBearer; +/** + *

Updates an AWS IoT SiteWise Monitor portal.

+ */ export class UpdatePortalCommand extends $Command< UpdatePortalCommandInput, UpdatePortalCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePortalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/commands/UpdateProjectCommand.ts b/clients/client-iotsitewise/commands/UpdateProjectCommand.ts index d9fb2cc43f083..4ba89000a2d91 100644 --- a/clients/client-iotsitewise/commands/UpdateProjectCommand.ts +++ b/clients/client-iotsitewise/commands/UpdateProjectCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProjectCommandInput = UpdateProjectRequest; export type UpdateProjectCommandOutput = UpdateProjectResponse & __MetadataBearer; +/** + *

Updates an AWS IoT SiteWise Monitor project.

+ */ export class UpdateProjectCommand extends $Command< UpdateProjectCommandInput, UpdateProjectCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTSiteWiseClientResolvedConfig, diff --git a/clients/client-iotsitewise/package.json b/clients/client-iotsitewise/package.json index c67e2dd3b230a..5080fc46286cb 100644 --- a/clients/client-iotsitewise/package.json +++ b/clients/client-iotsitewise/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iotsitewise Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iotsitewise/pagination/GetAssetPropertyAggregatesPaginator.ts b/clients/client-iotsitewise/pagination/GetAssetPropertyAggregatesPaginator.ts index 282846c1a0f7c..be78483532bf7 100644 --- a/clients/client-iotsitewise/pagination/GetAssetPropertyAggregatesPaginator.ts +++ b/clients/client-iotsitewise/pagination/GetAssetPropertyAggregatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: GetAssetPropertyAggregatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetAssetPropertyAggregatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: GetAssetPropertyAggregatesCommandInput, diff --git a/clients/client-iotsitewise/pagination/GetAssetPropertyValueHistoryPaginator.ts b/clients/client-iotsitewise/pagination/GetAssetPropertyValueHistoryPaginator.ts index 989fb54397161..9ca8fa60658ed 100644 --- a/clients/client-iotsitewise/pagination/GetAssetPropertyValueHistoryPaginator.ts +++ b/clients/client-iotsitewise/pagination/GetAssetPropertyValueHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: GetAssetPropertyValueHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetAssetPropertyValueHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: GetAssetPropertyValueHistoryCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListAccessPoliciesPaginator.ts b/clients/client-iotsitewise/pagination/ListAccessPoliciesPaginator.ts index bd157a65281f2..cae79a1a280fe 100644 --- a/clients/client-iotsitewise/pagination/ListAccessPoliciesPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListAccessPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListAccessPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccessPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListAccessPoliciesCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListAssetModelsPaginator.ts b/clients/client-iotsitewise/pagination/ListAssetModelsPaginator.ts index 36a350b9a1653..82e5eac4a1f51 100644 --- a/clients/client-iotsitewise/pagination/ListAssetModelsPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListAssetModelsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListAssetModelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssetModelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListAssetModelsCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListAssetsPaginator.ts b/clients/client-iotsitewise/pagination/ListAssetsPaginator.ts index 5a4040f39f64d..d7124f885625f 100644 --- a/clients/client-iotsitewise/pagination/ListAssetsPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListAssetsPaginator.ts @@ -4,6 +4,9 @@ import { ListAssetsCommand, ListAssetsCommandInput, ListAssetsCommandOutput } fr import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListAssetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListAssetsCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListAssociatedAssetsPaginator.ts b/clients/client-iotsitewise/pagination/ListAssociatedAssetsPaginator.ts index 7e4efee8f7d88..d8055057105b1 100644 --- a/clients/client-iotsitewise/pagination/ListAssociatedAssetsPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListAssociatedAssetsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListAssociatedAssetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssociatedAssetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListAssociatedAssetsCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListDashboardsPaginator.ts b/clients/client-iotsitewise/pagination/ListDashboardsPaginator.ts index 5e66342facd01..314dd259851c5 100644 --- a/clients/client-iotsitewise/pagination/ListDashboardsPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListDashboardsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListDashboardsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDashboardsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListDashboardsCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListGatewaysPaginator.ts b/clients/client-iotsitewise/pagination/ListGatewaysPaginator.ts index f35a3f8e5e30f..f4eb55d05b2e7 100644 --- a/clients/client-iotsitewise/pagination/ListGatewaysPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListGatewaysCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListPortalsPaginator.ts b/clients/client-iotsitewise/pagination/ListPortalsPaginator.ts index 2552bd1680cbc..888032827c1fa 100644 --- a/clients/client-iotsitewise/pagination/ListPortalsPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListPortalsPaginator.ts @@ -4,6 +4,9 @@ import { ListPortalsCommand, ListPortalsCommandInput, ListPortalsCommandOutput } import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListPortalsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPortalsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListPortalsCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListProjectAssetsPaginator.ts b/clients/client-iotsitewise/pagination/ListProjectAssetsPaginator.ts index 2c46fc9de32bf..ed71870f02b4c 100644 --- a/clients/client-iotsitewise/pagination/ListProjectAssetsPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListProjectAssetsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListProjectAssetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProjectAssetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListProjectAssetsCommandInput, diff --git a/clients/client-iotsitewise/pagination/ListProjectsPaginator.ts b/clients/client-iotsitewise/pagination/ListProjectsPaginator.ts index 870de6b08aca0..dd036870095e9 100644 --- a/clients/client-iotsitewise/pagination/ListProjectsPaginator.ts +++ b/clients/client-iotsitewise/pagination/ListProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTSiteWisePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTSiteWiseClient, input: ListProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTSiteWise, input: ListProjectsCommandInput, diff --git a/clients/client-iotsitewise/runtimeConfig.browser.ts b/clients/client-iotsitewise/runtimeConfig.browser.ts index b5bd0bec97cc8..f9c1454e49d8c 100644 --- a/clients/client-iotsitewise/runtimeConfig.browser.ts +++ b/clients/client-iotsitewise/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTSiteWiseClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iotsitewise/runtimeConfig.native.ts b/clients/client-iotsitewise/runtimeConfig.native.ts index 476f583688683..9a54d295a80e6 100644 --- a/clients/client-iotsitewise/runtimeConfig.native.ts +++ b/clients/client-iotsitewise/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTSiteWiseClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iotsitewise/runtimeConfig.shared.ts b/clients/client-iotsitewise/runtimeConfig.shared.ts index 32ade83af1d52..90b21df9d6d3d 100644 --- a/clients/client-iotsitewise/runtimeConfig.shared.ts +++ b/clients/client-iotsitewise/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-02", disableHostPrefix: false, diff --git a/clients/client-iotsitewise/runtimeConfig.ts b/clients/client-iotsitewise/runtimeConfig.ts index 3f93a328d6654..cfbdefac46253 100644 --- a/clients/client-iotsitewise/runtimeConfig.ts +++ b/clients/client-iotsitewise/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTSiteWiseClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iotsitewise/tsconfig.json b/clients/client-iotsitewise/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iotsitewise/tsconfig.json +++ b/clients/client-iotsitewise/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-iotthingsgraph/commands/AssociateEntityToThingCommand.ts b/clients/client-iotthingsgraph/commands/AssociateEntityToThingCommand.ts index a8abeca433332..9e2091c752f4a 100644 --- a/clients/client-iotthingsgraph/commands/AssociateEntityToThingCommand.ts +++ b/clients/client-iotthingsgraph/commands/AssociateEntityToThingCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateEntityToThingCommandInput = AssociateEntityToThingRequest; export type AssociateEntityToThingCommandOutput = AssociateEntityToThingResponse & __MetadataBearer; +/** + *

Associates a device with a concrete thing that is in the user's registry.

+ *

A thing can be associated with only one device at a time. If you associate a thing with a new device id, its previous association will be removed.

+ */ export class AssociateEntityToThingCommand extends $Command< AssociateEntityToThingCommandInput, AssociateEntityToThingCommandOutput, @@ -34,6 +38,9 @@ export class AssociateEntityToThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/CreateFlowTemplateCommand.ts b/clients/client-iotthingsgraph/commands/CreateFlowTemplateCommand.ts index e33f925191800..9581f93c8f51c 100644 --- a/clients/client-iotthingsgraph/commands/CreateFlowTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/CreateFlowTemplateCommand.ts @@ -20,6 +20,11 @@ import { export type CreateFlowTemplateCommandInput = CreateFlowTemplateRequest; export type CreateFlowTemplateCommandOutput = CreateFlowTemplateResponse & __MetadataBearer; +/** + *

Creates a workflow template. Workflows can be created only in the user's namespace. (The public namespace contains only + * entities.) The workflow can contain only entities in the specified namespace. The workflow is validated against the entities in the + * latest version of the user's namespace unless another namespace version is specified in the request.

+ */ export class CreateFlowTemplateCommand extends $Command< CreateFlowTemplateCommandInput, CreateFlowTemplateCommandOutput, @@ -34,6 +39,9 @@ export class CreateFlowTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/CreateSystemInstanceCommand.ts b/clients/client-iotthingsgraph/commands/CreateSystemInstanceCommand.ts index b020ec03ad940..ec84597c1125f 100644 --- a/clients/client-iotthingsgraph/commands/CreateSystemInstanceCommand.ts +++ b/clients/client-iotthingsgraph/commands/CreateSystemInstanceCommand.ts @@ -20,6 +20,17 @@ import { export type CreateSystemInstanceCommandInput = CreateSystemInstanceRequest; export type CreateSystemInstanceCommandOutput = CreateSystemInstanceResponse & __MetadataBearer; +/** + *

Creates a system instance.

+ *

This action validates the system instance, prepares the deployment-related resources. For Greengrass deployments, it updates the Greengrass group that is + * specified by the greengrassGroupName parameter. It also adds a file to the S3 bucket specified by the s3BucketName parameter. You need to + * call DeploySystemInstance after running this action.

+ *

For Greengrass deployments, since this action modifies and adds resources to a Greengrass group and an S3 bucket on the caller's behalf, the calling identity must have write permissions + * to both the specified Greengrass group and S3 bucket. Otherwise, the call will fail with an authorization error.

+ *

For cloud deployments, this action requires a flowActionsRoleArn value. This is an IAM role + * that has permissions to access AWS services, such as AWS Lambda and AWS IoT, that the flow uses when it executes.

+ *

If the definition document doesn't specify a version of the user's namespace, the latest version will be used by default.

+ */ export class CreateSystemInstanceCommand extends $Command< CreateSystemInstanceCommandInput, CreateSystemInstanceCommandOutput, @@ -34,6 +45,9 @@ export class CreateSystemInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/CreateSystemTemplateCommand.ts b/clients/client-iotthingsgraph/commands/CreateSystemTemplateCommand.ts index 318fa6b70e745..2ca9feb875de7 100644 --- a/clients/client-iotthingsgraph/commands/CreateSystemTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/CreateSystemTemplateCommand.ts @@ -20,6 +20,10 @@ import { export type CreateSystemTemplateCommandInput = CreateSystemTemplateRequest; export type CreateSystemTemplateCommandOutput = CreateSystemTemplateResponse & __MetadataBearer; +/** + *

Creates a system. The system is validated against the entities in the + * latest version of the user's namespace unless another namespace version is specified in the request.

+ */ export class CreateSystemTemplateCommand extends $Command< CreateSystemTemplateCommandInput, CreateSystemTemplateCommandOutput, @@ -34,6 +38,9 @@ export class CreateSystemTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DeleteFlowTemplateCommand.ts b/clients/client-iotthingsgraph/commands/DeleteFlowTemplateCommand.ts index 85ae6f86662ed..fb98d6b130f94 100644 --- a/clients/client-iotthingsgraph/commands/DeleteFlowTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/DeleteFlowTemplateCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteFlowTemplateCommandInput = DeleteFlowTemplateRequest; export type DeleteFlowTemplateCommandOutput = DeleteFlowTemplateResponse & __MetadataBearer; +/** + *

Deletes a workflow. Any new system or deployment that contains this workflow will fail to update or deploy. + * Existing deployments that contain the workflow will continue to run (since they use a snapshot of the workflow taken at the time of deployment).

+ */ export class DeleteFlowTemplateCommand extends $Command< DeleteFlowTemplateCommandInput, DeleteFlowTemplateCommandOutput, @@ -34,6 +38,9 @@ export class DeleteFlowTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DeleteNamespaceCommand.ts b/clients/client-iotthingsgraph/commands/DeleteNamespaceCommand.ts index 945ea9fc6d193..2ef362085acf7 100644 --- a/clients/client-iotthingsgraph/commands/DeleteNamespaceCommand.ts +++ b/clients/client-iotthingsgraph/commands/DeleteNamespaceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNamespaceCommandInput = DeleteNamespaceRequest; export type DeleteNamespaceCommandOutput = DeleteNamespaceResponse & __MetadataBearer; +/** + *

Deletes the specified namespace. This action deletes all of the entities in the namespace. Delete the systems and flows that use entities in the namespace before performing this action.

+ */ export class DeleteNamespaceCommand extends $Command< DeleteNamespaceCommandInput, DeleteNamespaceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DeleteSystemInstanceCommand.ts b/clients/client-iotthingsgraph/commands/DeleteSystemInstanceCommand.ts index e53e6df7bae5e..f7ef131aabd5b 100644 --- a/clients/client-iotthingsgraph/commands/DeleteSystemInstanceCommand.ts +++ b/clients/client-iotthingsgraph/commands/DeleteSystemInstanceCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteSystemInstanceCommandInput = DeleteSystemInstanceRequest; export type DeleteSystemInstanceCommandOutput = DeleteSystemInstanceResponse & __MetadataBearer; +/** + *

Deletes a system instance. + * Only system instances that have never been deployed, or that have been undeployed can be deleted.

+ *

Users can create a new system instance that has the same ID as a deleted system instance.

+ */ export class DeleteSystemInstanceCommand extends $Command< DeleteSystemInstanceCommandInput, DeleteSystemInstanceCommandOutput, @@ -34,6 +39,9 @@ export class DeleteSystemInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DeleteSystemTemplateCommand.ts b/clients/client-iotthingsgraph/commands/DeleteSystemTemplateCommand.ts index 77e1c555838ac..6fc45a2258a49 100644 --- a/clients/client-iotthingsgraph/commands/DeleteSystemTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/DeleteSystemTemplateCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteSystemTemplateCommandInput = DeleteSystemTemplateRequest; export type DeleteSystemTemplateCommandOutput = DeleteSystemTemplateResponse & __MetadataBearer; +/** + *

Deletes a system. New deployments can't contain the system after its deletion. + * Existing deployments that contain the system will continue to work because they use a snapshot of the system that is taken when it is deployed.

+ */ export class DeleteSystemTemplateCommand extends $Command< DeleteSystemTemplateCommandInput, DeleteSystemTemplateCommandOutput, @@ -34,6 +38,9 @@ export class DeleteSystemTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DeploySystemInstanceCommand.ts b/clients/client-iotthingsgraph/commands/DeploySystemInstanceCommand.ts index 253dfdd54c7fd..571db6c4a86a5 100644 --- a/clients/client-iotthingsgraph/commands/DeploySystemInstanceCommand.ts +++ b/clients/client-iotthingsgraph/commands/DeploySystemInstanceCommand.ts @@ -20,6 +20,20 @@ import { export type DeploySystemInstanceCommandInput = DeploySystemInstanceRequest; export type DeploySystemInstanceCommandOutput = DeploySystemInstanceResponse & __MetadataBearer; +/** + *

+ * Greengrass and Cloud Deployments + *

+ *

Deploys the system instance to the target specified in CreateSystemInstance.

+ *

+ * Greengrass Deployments + *

+ *

If the system or any workflows and entities have been updated before this action is called, then the deployment will create a new Amazon Simple Storage Service + * resource file and then deploy it.

+ *

Since this action creates a Greengrass deployment on the caller's behalf, the calling identity must have write permissions + * to the specified Greengrass group. Otherwise, the call will fail with an authorization error.

+ *

For information about the artifacts that get added to your Greengrass core device when you use this API, see AWS IoT Things Graph and AWS IoT Greengrass.

+ */ export class DeploySystemInstanceCommand extends $Command< DeploySystemInstanceCommandInput, DeploySystemInstanceCommandOutput, @@ -34,6 +48,9 @@ export class DeploySystemInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DeprecateFlowTemplateCommand.ts b/clients/client-iotthingsgraph/commands/DeprecateFlowTemplateCommand.ts index 644a736d7050c..82c4a2528079d 100644 --- a/clients/client-iotthingsgraph/commands/DeprecateFlowTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/DeprecateFlowTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeprecateFlowTemplateCommandInput = DeprecateFlowTemplateRequest; export type DeprecateFlowTemplateCommandOutput = DeprecateFlowTemplateResponse & __MetadataBearer; +/** + *

Deprecates the specified workflow. This action marks the workflow for deletion. Deprecated flows can't be deployed, but existing deployments will continue to run.

+ */ export class DeprecateFlowTemplateCommand extends $Command< DeprecateFlowTemplateCommandInput, DeprecateFlowTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeprecateFlowTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DeprecateSystemTemplateCommand.ts b/clients/client-iotthingsgraph/commands/DeprecateSystemTemplateCommand.ts index 457410a639f67..6761bcfb8ae7e 100644 --- a/clients/client-iotthingsgraph/commands/DeprecateSystemTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/DeprecateSystemTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeprecateSystemTemplateCommandInput = DeprecateSystemTemplateRequest; export type DeprecateSystemTemplateCommandOutput = DeprecateSystemTemplateResponse & __MetadataBearer; +/** + *

Deprecates the specified system.

+ */ export class DeprecateSystemTemplateCommand extends $Command< DeprecateSystemTemplateCommandInput, DeprecateSystemTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeprecateSystemTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DescribeNamespaceCommand.ts b/clients/client-iotthingsgraph/commands/DescribeNamespaceCommand.ts index d8892077c1814..1ce434c8b5bcd 100644 --- a/clients/client-iotthingsgraph/commands/DescribeNamespaceCommand.ts +++ b/clients/client-iotthingsgraph/commands/DescribeNamespaceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNamespaceCommandInput = DescribeNamespaceRequest; export type DescribeNamespaceCommandOutput = DescribeNamespaceResponse & __MetadataBearer; +/** + *

Gets the latest version of the user's namespace and the public version that it is tracking.

+ */ export class DescribeNamespaceCommand extends $Command< DescribeNamespaceCommandInput, DescribeNamespaceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/DissociateEntityFromThingCommand.ts b/clients/client-iotthingsgraph/commands/DissociateEntityFromThingCommand.ts index 1fb7ab141dbed..0de1f02a4142f 100644 --- a/clients/client-iotthingsgraph/commands/DissociateEntityFromThingCommand.ts +++ b/clients/client-iotthingsgraph/commands/DissociateEntityFromThingCommand.ts @@ -20,6 +20,10 @@ import { export type DissociateEntityFromThingCommandInput = DissociateEntityFromThingRequest; export type DissociateEntityFromThingCommandOutput = DissociateEntityFromThingResponse & __MetadataBearer; +/** + *

Dissociates a device entity from a concrete thing. The action takes only the type of the entity that you need to dissociate because only + * one entity of a particular type can be associated with a thing.

+ */ export class DissociateEntityFromThingCommand extends $Command< DissociateEntityFromThingCommandInput, DissociateEntityFromThingCommandOutput, @@ -34,6 +38,9 @@ export class DissociateEntityFromThingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/GetEntitiesCommand.ts b/clients/client-iotthingsgraph/commands/GetEntitiesCommand.ts index d3a7d8488b7a0..7b05e8c2c8477 100644 --- a/clients/client-iotthingsgraph/commands/GetEntitiesCommand.ts +++ b/clients/client-iotthingsgraph/commands/GetEntitiesCommand.ts @@ -20,6 +20,40 @@ import { export type GetEntitiesCommandInput = GetEntitiesRequest; export type GetEntitiesCommandOutput = GetEntitiesResponse & __MetadataBearer; +/** + *

Gets definitions of the specified entities. Uses the latest version of the user's namespace by default. This API returns the + * following TDM entities.

+ *
    + *
  • + *

    Properties

    + *
  • + *
  • + *

    States

    + *
  • + *
  • + *

    Events

    + *
  • + *
  • + *

    Actions

    + *
  • + *
  • + *

    Capabilities

    + *
  • + *
  • + *

    Mappings

    + *
  • + *
  • + *

    Devices

    + *
  • + *
  • + *

    Device Models

    + *
  • + *
  • + *

    Services

    + *
  • + *
+ *

This action doesn't return definitions for systems, flows, and deployments.

+ */ export class GetEntitiesCommand extends $Command< GetEntitiesCommandInput, GetEntitiesCommandOutput, @@ -34,6 +68,9 @@ export class GetEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/GetFlowTemplateCommand.ts b/clients/client-iotthingsgraph/commands/GetFlowTemplateCommand.ts index 71b3a52bed2d9..155143e752e6d 100644 --- a/clients/client-iotthingsgraph/commands/GetFlowTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/GetFlowTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetFlowTemplateCommandInput = GetFlowTemplateRequest; export type GetFlowTemplateCommandOutput = GetFlowTemplateResponse & __MetadataBearer; +/** + *

Gets the latest version of the DefinitionDocument and FlowTemplateSummary for the specified workflow.

+ */ export class GetFlowTemplateCommand extends $Command< GetFlowTemplateCommandInput, GetFlowTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetFlowTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/GetFlowTemplateRevisionsCommand.ts b/clients/client-iotthingsgraph/commands/GetFlowTemplateRevisionsCommand.ts index ac8939ba9eb79..3806c1b79bbfc 100644 --- a/clients/client-iotthingsgraph/commands/GetFlowTemplateRevisionsCommand.ts +++ b/clients/client-iotthingsgraph/commands/GetFlowTemplateRevisionsCommand.ts @@ -20,6 +20,10 @@ import { export type GetFlowTemplateRevisionsCommandInput = GetFlowTemplateRevisionsRequest; export type GetFlowTemplateRevisionsCommandOutput = GetFlowTemplateRevisionsResponse & __MetadataBearer; +/** + *

Gets revisions of the specified workflow. Only the last 100 revisions are stored. If the workflow has been deprecated, + * this action will return revisions that occurred before the deprecation. This action won't work for workflows that have been deleted.

+ */ export class GetFlowTemplateRevisionsCommand extends $Command< GetFlowTemplateRevisionsCommandInput, GetFlowTemplateRevisionsCommandOutput, @@ -34,6 +38,9 @@ export class GetFlowTemplateRevisionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/GetNamespaceDeletionStatusCommand.ts b/clients/client-iotthingsgraph/commands/GetNamespaceDeletionStatusCommand.ts index ba1516b21f800..04f97d245d89b 100644 --- a/clients/client-iotthingsgraph/commands/GetNamespaceDeletionStatusCommand.ts +++ b/clients/client-iotthingsgraph/commands/GetNamespaceDeletionStatusCommand.ts @@ -20,6 +20,9 @@ import { export type GetNamespaceDeletionStatusCommandInput = GetNamespaceDeletionStatusRequest; export type GetNamespaceDeletionStatusCommandOutput = GetNamespaceDeletionStatusResponse & __MetadataBearer; +/** + *

Gets the status of a namespace deletion task.

+ */ export class GetNamespaceDeletionStatusCommand extends $Command< GetNamespaceDeletionStatusCommandInput, GetNamespaceDeletionStatusCommandOutput, @@ -34,6 +37,9 @@ export class GetNamespaceDeletionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/GetSystemInstanceCommand.ts b/clients/client-iotthingsgraph/commands/GetSystemInstanceCommand.ts index 1488e1071b796..0fb93f4f4f6c0 100644 --- a/clients/client-iotthingsgraph/commands/GetSystemInstanceCommand.ts +++ b/clients/client-iotthingsgraph/commands/GetSystemInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type GetSystemInstanceCommandInput = GetSystemInstanceRequest; export type GetSystemInstanceCommandOutput = GetSystemInstanceResponse & __MetadataBearer; +/** + *

Gets a system instance.

+ */ export class GetSystemInstanceCommand extends $Command< GetSystemInstanceCommandInput, GetSystemInstanceCommandOutput, @@ -34,6 +37,9 @@ export class GetSystemInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/GetSystemTemplateCommand.ts b/clients/client-iotthingsgraph/commands/GetSystemTemplateCommand.ts index b554839e8d093..43082675258cf 100644 --- a/clients/client-iotthingsgraph/commands/GetSystemTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/GetSystemTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetSystemTemplateCommandInput = GetSystemTemplateRequest; export type GetSystemTemplateCommandOutput = GetSystemTemplateResponse & __MetadataBearer; +/** + *

Gets a system.

+ */ export class GetSystemTemplateCommand extends $Command< GetSystemTemplateCommandInput, GetSystemTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetSystemTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/GetSystemTemplateRevisionsCommand.ts b/clients/client-iotthingsgraph/commands/GetSystemTemplateRevisionsCommand.ts index dac74f00de60d..dc6518d57cf2b 100644 --- a/clients/client-iotthingsgraph/commands/GetSystemTemplateRevisionsCommand.ts +++ b/clients/client-iotthingsgraph/commands/GetSystemTemplateRevisionsCommand.ts @@ -20,6 +20,10 @@ import { export type GetSystemTemplateRevisionsCommandInput = GetSystemTemplateRevisionsRequest; export type GetSystemTemplateRevisionsCommandOutput = GetSystemTemplateRevisionsResponse & __MetadataBearer; +/** + *

Gets revisions made to the specified system template. Only the previous 100 revisions are stored. If the system has been deprecated, this action will return + * the revisions that occurred before its deprecation. This action won't work with systems that have been deleted.

+ */ export class GetSystemTemplateRevisionsCommand extends $Command< GetSystemTemplateRevisionsCommandInput, GetSystemTemplateRevisionsCommandOutput, @@ -34,6 +38,9 @@ export class GetSystemTemplateRevisionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/GetUploadStatusCommand.ts b/clients/client-iotthingsgraph/commands/GetUploadStatusCommand.ts index b8ac6c517f37b..80e75d96a9513 100644 --- a/clients/client-iotthingsgraph/commands/GetUploadStatusCommand.ts +++ b/clients/client-iotthingsgraph/commands/GetUploadStatusCommand.ts @@ -20,6 +20,9 @@ import { export type GetUploadStatusCommandInput = GetUploadStatusRequest; export type GetUploadStatusCommandOutput = GetUploadStatusResponse & __MetadataBearer; +/** + *

Gets the status of the specified upload.

+ */ export class GetUploadStatusCommand extends $Command< GetUploadStatusCommandInput, GetUploadStatusCommandOutput, @@ -34,6 +37,9 @@ export class GetUploadStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/ListFlowExecutionMessagesCommand.ts b/clients/client-iotthingsgraph/commands/ListFlowExecutionMessagesCommand.ts index 02a3966607e9f..f46d932929645 100644 --- a/clients/client-iotthingsgraph/commands/ListFlowExecutionMessagesCommand.ts +++ b/clients/client-iotthingsgraph/commands/ListFlowExecutionMessagesCommand.ts @@ -20,6 +20,9 @@ import { export type ListFlowExecutionMessagesCommandInput = ListFlowExecutionMessagesRequest; export type ListFlowExecutionMessagesCommandOutput = ListFlowExecutionMessagesResponse & __MetadataBearer; +/** + *

Returns a list of objects that contain information about events in a flow execution.

+ */ export class ListFlowExecutionMessagesCommand extends $Command< ListFlowExecutionMessagesCommandInput, ListFlowExecutionMessagesCommandOutput, @@ -34,6 +37,9 @@ export class ListFlowExecutionMessagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/ListTagsForResourceCommand.ts b/clients/client-iotthingsgraph/commands/ListTagsForResourceCommand.ts index 3fff23e67ce15..2c0ddb3929e02 100644 --- a/clients/client-iotthingsgraph/commands/ListTagsForResourceCommand.ts +++ b/clients/client-iotthingsgraph/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists all tags on an AWS IoT Things Graph resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/SearchEntitiesCommand.ts b/clients/client-iotthingsgraph/commands/SearchEntitiesCommand.ts index cef87f086fa31..2edcac01704ec 100644 --- a/clients/client-iotthingsgraph/commands/SearchEntitiesCommand.ts +++ b/clients/client-iotthingsgraph/commands/SearchEntitiesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchEntitiesCommandInput = SearchEntitiesRequest; export type SearchEntitiesCommandOutput = SearchEntitiesResponse & __MetadataBearer; +/** + *

Searches for entities of the specified type. You can search for entities in your namespace and the public namespace that you're tracking.

+ */ export class SearchEntitiesCommand extends $Command< SearchEntitiesCommandInput, SearchEntitiesCommandOutput, @@ -34,6 +37,9 @@ export class SearchEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/SearchFlowExecutionsCommand.ts b/clients/client-iotthingsgraph/commands/SearchFlowExecutionsCommand.ts index ee597b958ffa1..157c68d6eefb0 100644 --- a/clients/client-iotthingsgraph/commands/SearchFlowExecutionsCommand.ts +++ b/clients/client-iotthingsgraph/commands/SearchFlowExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type SearchFlowExecutionsCommandInput = SearchFlowExecutionsRequest; export type SearchFlowExecutionsCommandOutput = SearchFlowExecutionsResponse & __MetadataBearer; +/** + *

Searches for AWS IoT Things Graph workflow execution instances.

+ */ export class SearchFlowExecutionsCommand extends $Command< SearchFlowExecutionsCommandInput, SearchFlowExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class SearchFlowExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/SearchFlowTemplatesCommand.ts b/clients/client-iotthingsgraph/commands/SearchFlowTemplatesCommand.ts index 953d885d7f976..79d7ce75202bb 100644 --- a/clients/client-iotthingsgraph/commands/SearchFlowTemplatesCommand.ts +++ b/clients/client-iotthingsgraph/commands/SearchFlowTemplatesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchFlowTemplatesCommandInput = SearchFlowTemplatesRequest; export type SearchFlowTemplatesCommandOutput = SearchFlowTemplatesResponse & __MetadataBearer; +/** + *

Searches for summary information about workflows.

+ */ export class SearchFlowTemplatesCommand extends $Command< SearchFlowTemplatesCommandInput, SearchFlowTemplatesCommandOutput, @@ -34,6 +37,9 @@ export class SearchFlowTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/SearchSystemInstancesCommand.ts b/clients/client-iotthingsgraph/commands/SearchSystemInstancesCommand.ts index 502167ebbf5bb..44140c4ef999a 100644 --- a/clients/client-iotthingsgraph/commands/SearchSystemInstancesCommand.ts +++ b/clients/client-iotthingsgraph/commands/SearchSystemInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchSystemInstancesCommandInput = SearchSystemInstancesRequest; export type SearchSystemInstancesCommandOutput = SearchSystemInstancesResponse & __MetadataBearer; +/** + *

Searches for system instances in the user's account.

+ */ export class SearchSystemInstancesCommand extends $Command< SearchSystemInstancesCommandInput, SearchSystemInstancesCommandOutput, @@ -34,6 +37,9 @@ export class SearchSystemInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/SearchSystemTemplatesCommand.ts b/clients/client-iotthingsgraph/commands/SearchSystemTemplatesCommand.ts index 6e5693e7d7be2..9dedbebc3e900 100644 --- a/clients/client-iotthingsgraph/commands/SearchSystemTemplatesCommand.ts +++ b/clients/client-iotthingsgraph/commands/SearchSystemTemplatesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchSystemTemplatesCommandInput = SearchSystemTemplatesRequest; export type SearchSystemTemplatesCommandOutput = SearchSystemTemplatesResponse & __MetadataBearer; +/** + *

Searches for summary information about systems in the user's account. You can filter by the ID of a workflow to return only systems that use the specified workflow.

+ */ export class SearchSystemTemplatesCommand extends $Command< SearchSystemTemplatesCommandInput, SearchSystemTemplatesCommandOutput, @@ -34,6 +37,9 @@ export class SearchSystemTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/SearchThingsCommand.ts b/clients/client-iotthingsgraph/commands/SearchThingsCommand.ts index 124dd4d21b433..d20e3d6211b0c 100644 --- a/clients/client-iotthingsgraph/commands/SearchThingsCommand.ts +++ b/clients/client-iotthingsgraph/commands/SearchThingsCommand.ts @@ -20,6 +20,12 @@ import { export type SearchThingsCommandInput = SearchThingsRequest; export type SearchThingsCommandOutput = SearchThingsResponse & __MetadataBearer; +/** + *

Searches for things associated with the specified entity. You can search by both device and device model.

+ *

For example, if two different devices, camera1 and camera2, implement the camera device model, the user can associate thing1 to camera1 and thing2 to camera2. + * SearchThings(camera2) will return only thing2, but SearchThings(camera) will return both thing1 and thing2.

+ *

This action searches for exact matches and doesn't perform partial text matching.

+ */ export class SearchThingsCommand extends $Command< SearchThingsCommandInput, SearchThingsCommandOutput, @@ -34,6 +40,9 @@ export class SearchThingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/TagResourceCommand.ts b/clients/client-iotthingsgraph/commands/TagResourceCommand.ts index c22e699b09639..e28d4ce3228ce 100644 --- a/clients/client-iotthingsgraph/commands/TagResourceCommand.ts +++ b/clients/client-iotthingsgraph/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Creates a tag for the specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/UndeploySystemInstanceCommand.ts b/clients/client-iotthingsgraph/commands/UndeploySystemInstanceCommand.ts index 9aac4fd826584..89ecbce751107 100644 --- a/clients/client-iotthingsgraph/commands/UndeploySystemInstanceCommand.ts +++ b/clients/client-iotthingsgraph/commands/UndeploySystemInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type UndeploySystemInstanceCommandInput = UndeploySystemInstanceRequest; export type UndeploySystemInstanceCommandOutput = UndeploySystemInstanceResponse & __MetadataBearer; +/** + *

Removes a system instance from its target (Cloud or Greengrass).

+ */ export class UndeploySystemInstanceCommand extends $Command< UndeploySystemInstanceCommandInput, UndeploySystemInstanceCommandOutput, @@ -34,6 +37,9 @@ export class UndeploySystemInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/UntagResourceCommand.ts b/clients/client-iotthingsgraph/commands/UntagResourceCommand.ts index ef447bff20203..4617a1fe1b65e 100644 --- a/clients/client-iotthingsgraph/commands/UntagResourceCommand.ts +++ b/clients/client-iotthingsgraph/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag from the specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/UpdateFlowTemplateCommand.ts b/clients/client-iotthingsgraph/commands/UpdateFlowTemplateCommand.ts index deebbe7f4f75e..b0d0b5d710035 100644 --- a/clients/client-iotthingsgraph/commands/UpdateFlowTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/UpdateFlowTemplateCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateFlowTemplateCommandInput = UpdateFlowTemplateRequest; export type UpdateFlowTemplateCommandOutput = UpdateFlowTemplateResponse & __MetadataBearer; +/** + *

Updates the specified workflow. All deployed systems and system instances that use the workflow will see the changes in the flow when it is redeployed. If you don't want this + * behavior, copy the workflow (creating a new workflow with a different ID), and update the copy. The workflow can contain only entities in the specified namespace.

+ */ export class UpdateFlowTemplateCommand extends $Command< UpdateFlowTemplateCommandInput, UpdateFlowTemplateCommandOutput, @@ -34,6 +38,9 @@ export class UpdateFlowTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/UpdateSystemTemplateCommand.ts b/clients/client-iotthingsgraph/commands/UpdateSystemTemplateCommand.ts index 71c9833bed9bc..72c96f7237db9 100644 --- a/clients/client-iotthingsgraph/commands/UpdateSystemTemplateCommand.ts +++ b/clients/client-iotthingsgraph/commands/UpdateSystemTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSystemTemplateCommandInput = UpdateSystemTemplateRequest; export type UpdateSystemTemplateCommandOutput = UpdateSystemTemplateResponse & __MetadataBearer; +/** + *

Updates the specified system. You don't need to run this action after updating a workflow. Any deployment that uses the system will see the changes in the system when it is redeployed.

+ */ export class UpdateSystemTemplateCommand extends $Command< UpdateSystemTemplateCommandInput, UpdateSystemTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSystemTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/commands/UploadEntityDefinitionsCommand.ts b/clients/client-iotthingsgraph/commands/UploadEntityDefinitionsCommand.ts index 2224fe15868ab..c2180aa6160ee 100644 --- a/clients/client-iotthingsgraph/commands/UploadEntityDefinitionsCommand.ts +++ b/clients/client-iotthingsgraph/commands/UploadEntityDefinitionsCommand.ts @@ -20,6 +20,19 @@ import { export type UploadEntityDefinitionsCommandInput = UploadEntityDefinitionsRequest; export type UploadEntityDefinitionsCommandOutput = UploadEntityDefinitionsResponse & __MetadataBearer; +/** + *

Asynchronously uploads one or more entity definitions to the user's namespace. The document parameter is required if + * syncWithPublicNamespace and deleteExistingEntites are false. If the syncWithPublicNamespace parameter is set to + * true, the user's namespace will synchronize with the latest version of the public namespace. If deprecateExistingEntities is set to true, + * all entities in the latest version will be deleted before the new DefinitionDocument is uploaded.

+ *

When a user uploads entity definitions for the first time, the service creates a new namespace for the user. The new namespace tracks the public namespace. Currently users + * can have only one namespace. The namespace version increments whenever a user uploads entity definitions that are backwards-incompatible and whenever a user sets the + * syncWithPublicNamespace parameter or the deprecateExistingEntities parameter to true.

+ *

The IDs for all of the entities should be in URN format. Each entity must be in the user's namespace. Users can't create entities in the public namespace, but entity definitions can refer to entities in the public namespace.

+ *

Valid entities are Device, DeviceModel, Service, Capability, State, Action, Event, Property, + * Mapping, Enum. + *

+ */ export class UploadEntityDefinitionsCommand extends $Command< UploadEntityDefinitionsCommandInput, UploadEntityDefinitionsCommandOutput, @@ -34,6 +47,9 @@ export class UploadEntityDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IoTThingsGraphClientResolvedConfig, diff --git a/clients/client-iotthingsgraph/package.json b/clients/client-iotthingsgraph/package.json index de464ae3577df..3b31b536c387e 100644 --- a/clients/client-iotthingsgraph/package.json +++ b/clients/client-iotthingsgraph/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Iotthingsgraph Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-iotthingsgraph/pagination/GetFlowTemplateRevisionsPaginator.ts b/clients/client-iotthingsgraph/pagination/GetFlowTemplateRevisionsPaginator.ts index f2f892505daef..baf44ddd56014 100644 --- a/clients/client-iotthingsgraph/pagination/GetFlowTemplateRevisionsPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/GetFlowTemplateRevisionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: GetFlowTemplateRevisionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetFlowTemplateRevisionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: GetFlowTemplateRevisionsCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/GetSystemTemplateRevisionsPaginator.ts b/clients/client-iotthingsgraph/pagination/GetSystemTemplateRevisionsPaginator.ts index d545137ded560..af26365259344 100644 --- a/clients/client-iotthingsgraph/pagination/GetSystemTemplateRevisionsPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/GetSystemTemplateRevisionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: GetSystemTemplateRevisionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSystemTemplateRevisionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: GetSystemTemplateRevisionsCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/ListFlowExecutionMessagesPaginator.ts b/clients/client-iotthingsgraph/pagination/ListFlowExecutionMessagesPaginator.ts index a1d795921136b..dc9741f61efe3 100644 --- a/clients/client-iotthingsgraph/pagination/ListFlowExecutionMessagesPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/ListFlowExecutionMessagesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: ListFlowExecutionMessagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFlowExecutionMessagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: ListFlowExecutionMessagesCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/ListTagsForResourcePaginator.ts b/clients/client-iotthingsgraph/pagination/ListTagsForResourcePaginator.ts index 2f7ca7ad8f192..7b158af74fa34 100644 --- a/clients/client-iotthingsgraph/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-iotthingsgraph/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: ListTagsForResourceCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/SearchEntitiesPaginator.ts b/clients/client-iotthingsgraph/pagination/SearchEntitiesPaginator.ts index 3e7ebb2b47117..3fd7ef3583cbd 100644 --- a/clients/client-iotthingsgraph/pagination/SearchEntitiesPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/SearchEntitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: SearchEntitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchEntitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: SearchEntitiesCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/SearchFlowExecutionsPaginator.ts b/clients/client-iotthingsgraph/pagination/SearchFlowExecutionsPaginator.ts index bc1f3fef7f161..c4cffa8f4d6b9 100644 --- a/clients/client-iotthingsgraph/pagination/SearchFlowExecutionsPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/SearchFlowExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: SearchFlowExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchFlowExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: SearchFlowExecutionsCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/SearchFlowTemplatesPaginator.ts b/clients/client-iotthingsgraph/pagination/SearchFlowTemplatesPaginator.ts index bca5530d7d6e1..10a5088ce0eca 100644 --- a/clients/client-iotthingsgraph/pagination/SearchFlowTemplatesPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/SearchFlowTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: SearchFlowTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchFlowTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: SearchFlowTemplatesCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/SearchSystemInstancesPaginator.ts b/clients/client-iotthingsgraph/pagination/SearchSystemInstancesPaginator.ts index 474f121eb29e3..785dc1c12fcee 100644 --- a/clients/client-iotthingsgraph/pagination/SearchSystemInstancesPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/SearchSystemInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: SearchSystemInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchSystemInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: SearchSystemInstancesCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/SearchSystemTemplatesPaginator.ts b/clients/client-iotthingsgraph/pagination/SearchSystemTemplatesPaginator.ts index d9ee91f998eb0..d1cb096b24823 100644 --- a/clients/client-iotthingsgraph/pagination/SearchSystemTemplatesPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/SearchSystemTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: SearchSystemTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchSystemTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: SearchSystemTemplatesCommandInput, diff --git a/clients/client-iotthingsgraph/pagination/SearchThingsPaginator.ts b/clients/client-iotthingsgraph/pagination/SearchThingsPaginator.ts index 44046a2b3a2ca..41af76fbfd893 100644 --- a/clients/client-iotthingsgraph/pagination/SearchThingsPaginator.ts +++ b/clients/client-iotthingsgraph/pagination/SearchThingsPaginator.ts @@ -8,6 +8,9 @@ import { import { IoTThingsGraphPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IoTThingsGraphClient, input: SearchThingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchThingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: IoTThingsGraph, input: SearchThingsCommandInput, diff --git a/clients/client-iotthingsgraph/runtimeConfig.browser.ts b/clients/client-iotthingsgraph/runtimeConfig.browser.ts index 0c356e6409649..37a028500673d 100644 --- a/clients/client-iotthingsgraph/runtimeConfig.browser.ts +++ b/clients/client-iotthingsgraph/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IoTThingsGraphClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-iotthingsgraph/runtimeConfig.native.ts b/clients/client-iotthingsgraph/runtimeConfig.native.ts index 288251972e7d4..07fb9211275fd 100644 --- a/clients/client-iotthingsgraph/runtimeConfig.native.ts +++ b/clients/client-iotthingsgraph/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IoTThingsGraphClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-iotthingsgraph/runtimeConfig.shared.ts b/clients/client-iotthingsgraph/runtimeConfig.shared.ts index 09c8e46afb5b9..d3977c195a5fd 100644 --- a/clients/client-iotthingsgraph/runtimeConfig.shared.ts +++ b/clients/client-iotthingsgraph/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-09-06", disableHostPrefix: false, diff --git a/clients/client-iotthingsgraph/runtimeConfig.ts b/clients/client-iotthingsgraph/runtimeConfig.ts index 8b6a3a8f57b06..228ed6e4fd4b5 100644 --- a/clients/client-iotthingsgraph/runtimeConfig.ts +++ b/clients/client-iotthingsgraph/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IoTThingsGraphClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-iotthingsgraph/tsconfig.json b/clients/client-iotthingsgraph/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-iotthingsgraph/tsconfig.json +++ b/clients/client-iotthingsgraph/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ivs/commands/BatchGetChannelCommand.ts b/clients/client-ivs/commands/BatchGetChannelCommand.ts index 99bc8c0daf007..3f4750ea56cc5 100644 --- a/clients/client-ivs/commands/BatchGetChannelCommand.ts +++ b/clients/client-ivs/commands/BatchGetChannelCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetChannelCommandInput = BatchGetChannelRequest; export type BatchGetChannelCommandOutput = BatchGetChannelResponse & __MetadataBearer; +/** + *

Performs GetChannel on multiple ARNs simultaneously.

+ */ export class BatchGetChannelCommand extends $Command< BatchGetChannelCommandInput, BatchGetChannelCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/BatchGetStreamKeyCommand.ts b/clients/client-ivs/commands/BatchGetStreamKeyCommand.ts index 36e8d5a216681..2b34fd160b777 100644 --- a/clients/client-ivs/commands/BatchGetStreamKeyCommand.ts +++ b/clients/client-ivs/commands/BatchGetStreamKeyCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetStreamKeyCommandInput = BatchGetStreamKeyRequest; export type BatchGetStreamKeyCommandOutput = BatchGetStreamKeyResponse & __MetadataBearer; +/** + *

Performs GetStreamKey on multiple ARNs simultaneously.

+ */ export class BatchGetStreamKeyCommand extends $Command< BatchGetStreamKeyCommandInput, BatchGetStreamKeyCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetStreamKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/CreateChannelCommand.ts b/clients/client-ivs/commands/CreateChannelCommand.ts index e8dd5eb2f92cc..f1cd3bd9a842d 100644 --- a/clients/client-ivs/commands/CreateChannelCommand.ts +++ b/clients/client-ivs/commands/CreateChannelCommand.ts @@ -20,6 +20,9 @@ import { export type CreateChannelCommandInput = CreateChannelRequest; export type CreateChannelCommandOutput = CreateChannelResponse & __MetadataBearer; +/** + *

Creates a new channel and an associated stream key to start streaming.

+ */ export class CreateChannelCommand extends $Command< CreateChannelCommandInput, CreateChannelCommandOutput, @@ -34,6 +37,9 @@ export class CreateChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/CreateStreamKeyCommand.ts b/clients/client-ivs/commands/CreateStreamKeyCommand.ts index 33daa01804bff..170aacb2b46db 100644 --- a/clients/client-ivs/commands/CreateStreamKeyCommand.ts +++ b/clients/client-ivs/commands/CreateStreamKeyCommand.ts @@ -20,6 +20,12 @@ import { export type CreateStreamKeyCommandInput = CreateStreamKeyRequest; export type CreateStreamKeyCommandOutput = CreateStreamKeyResponse & __MetadataBearer; +/** + *

Creates a stream key, used to initiate a stream, for the specified channel ARN.

+ *

Note that CreateChannel creates a stream key. If you subsequently use + * CreateStreamKey on the same channel, it will fail because a stream key already exists and + * there is a limit of 1 stream key per channel. To reset the stream key on a channel, use DeleteStreamKey and then CreateStreamKey.

+ */ export class CreateStreamKeyCommand extends $Command< CreateStreamKeyCommandInput, CreateStreamKeyCommandOutput, @@ -34,6 +40,9 @@ export class CreateStreamKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/DeleteChannelCommand.ts b/clients/client-ivs/commands/DeleteChannelCommand.ts index 79a6ee01567bf..2dc0032af3e02 100644 --- a/clients/client-ivs/commands/DeleteChannelCommand.ts +++ b/clients/client-ivs/commands/DeleteChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteChannelCommandInput = DeleteChannelRequest; export type DeleteChannelCommandOutput = __MetadataBearer; +/** + *

Deletes the specified channel and its associated stream keys.

+ */ export class DeleteChannelCommand extends $Command< DeleteChannelCommandInput, DeleteChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/DeletePlaybackKeyPairCommand.ts b/clients/client-ivs/commands/DeletePlaybackKeyPairCommand.ts index ce4d1f3814e0d..0d2bb3f3efcef 100644 --- a/clients/client-ivs/commands/DeletePlaybackKeyPairCommand.ts +++ b/clients/client-ivs/commands/DeletePlaybackKeyPairCommand.ts @@ -20,6 +20,10 @@ import { export type DeletePlaybackKeyPairCommandInput = DeletePlaybackKeyPairRequest; export type DeletePlaybackKeyPairCommandOutput = DeletePlaybackKeyPairResponse & __MetadataBearer; +/** + *

Deletes a specified authorization key pair. This invalidates future viewer tokens + * generated using the key pair’s privateKey.

+ */ export class DeletePlaybackKeyPairCommand extends $Command< DeletePlaybackKeyPairCommandInput, DeletePlaybackKeyPairCommandOutput, @@ -34,6 +38,9 @@ export class DeletePlaybackKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/DeleteStreamKeyCommand.ts b/clients/client-ivs/commands/DeleteStreamKeyCommand.ts index ca9d02e811633..91657cd390946 100644 --- a/clients/client-ivs/commands/DeleteStreamKeyCommand.ts +++ b/clients/client-ivs/commands/DeleteStreamKeyCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteStreamKeyCommandInput = DeleteStreamKeyRequest; export type DeleteStreamKeyCommandOutput = __MetadataBearer; +/** + *

Deletes the stream key for the specified ARN, so it can no longer be used to + * stream.

+ */ export class DeleteStreamKeyCommand extends $Command< DeleteStreamKeyCommandInput, DeleteStreamKeyCommandOutput, @@ -34,6 +38,9 @@ export class DeleteStreamKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/GetChannelCommand.ts b/clients/client-ivs/commands/GetChannelCommand.ts index 8e22a4b1076ed..bf00d36e12b3e 100644 --- a/clients/client-ivs/commands/GetChannelCommand.ts +++ b/clients/client-ivs/commands/GetChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetChannelCommandInput = GetChannelRequest; export type GetChannelCommandOutput = GetChannelResponse & __MetadataBearer; +/** + *

Gets the channel configuration for the specified channel ARN. See also BatchGetChannel.

+ */ export class GetChannelCommand extends $Command< GetChannelCommandInput, GetChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/GetPlaybackKeyPairCommand.ts b/clients/client-ivs/commands/GetPlaybackKeyPairCommand.ts index 76e29a3ead4ba..38d9d3ba894c8 100644 --- a/clients/client-ivs/commands/GetPlaybackKeyPairCommand.ts +++ b/clients/client-ivs/commands/GetPlaybackKeyPairCommand.ts @@ -20,6 +20,11 @@ import { export type GetPlaybackKeyPairCommandInput = GetPlaybackKeyPairRequest; export type GetPlaybackKeyPairCommandOutput = GetPlaybackKeyPairResponse & __MetadataBearer; +/** + *

Gets a specified playback authorization key pair and returns the arn and + * fingerprint. The privateKey held by the caller can be used to + * generate viewer authorization tokens, to grant viewers access to authorized channels.

+ */ export class GetPlaybackKeyPairCommand extends $Command< GetPlaybackKeyPairCommandInput, GetPlaybackKeyPairCommandOutput, @@ -34,6 +39,9 @@ export class GetPlaybackKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/GetStreamCommand.ts b/clients/client-ivs/commands/GetStreamCommand.ts index e39153603c5f8..a867bf486b1bb 100644 --- a/clients/client-ivs/commands/GetStreamCommand.ts +++ b/clients/client-ivs/commands/GetStreamCommand.ts @@ -20,6 +20,9 @@ import { export type GetStreamCommandInput = GetStreamRequest; export type GetStreamCommandOutput = GetStreamResponse & __MetadataBearer; +/** + *

Gets information about the active (live) stream on a specified channel.

+ */ export class GetStreamCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class GetStreamCommand extends $Command, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/GetStreamKeyCommand.ts b/clients/client-ivs/commands/GetStreamKeyCommand.ts index be26901a876b9..dc6361883c18d 100644 --- a/clients/client-ivs/commands/GetStreamKeyCommand.ts +++ b/clients/client-ivs/commands/GetStreamKeyCommand.ts @@ -20,6 +20,9 @@ import { export type GetStreamKeyCommandInput = GetStreamKeyRequest; export type GetStreamKeyCommandOutput = GetStreamKeyResponse & __MetadataBearer; +/** + *

Gets stream-key information for a specified ARN.

+ */ export class GetStreamKeyCommand extends $Command< GetStreamKeyCommandInput, GetStreamKeyCommandOutput, @@ -34,6 +37,9 @@ export class GetStreamKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/ImportPlaybackKeyPairCommand.ts b/clients/client-ivs/commands/ImportPlaybackKeyPairCommand.ts index 90394a16880d4..4cfa5ab9ac726 100644 --- a/clients/client-ivs/commands/ImportPlaybackKeyPairCommand.ts +++ b/clients/client-ivs/commands/ImportPlaybackKeyPairCommand.ts @@ -20,6 +20,11 @@ import { export type ImportPlaybackKeyPairCommandInput = ImportPlaybackKeyPairRequest; export type ImportPlaybackKeyPairCommandOutput = ImportPlaybackKeyPairResponse & __MetadataBearer; +/** + *

Imports the public portion of a new key pair and returns its arn and + * fingerprint. The privateKey can then be used to generate viewer + * authorization tokens, to grant viewers access to authorized channels.

+ */ export class ImportPlaybackKeyPairCommand extends $Command< ImportPlaybackKeyPairCommandInput, ImportPlaybackKeyPairCommandOutput, @@ -34,6 +39,9 @@ export class ImportPlaybackKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/ListChannelsCommand.ts b/clients/client-ivs/commands/ListChannelsCommand.ts index 27816cd238c7b..44ee8d3d997ec 100644 --- a/clients/client-ivs/commands/ListChannelsCommand.ts +++ b/clients/client-ivs/commands/ListChannelsCommand.ts @@ -20,6 +20,10 @@ import { export type ListChannelsCommandInput = ListChannelsRequest; export type ListChannelsCommandOutput = ListChannelsResponse & __MetadataBearer; +/** + *

Gets summary information about all channels in your account, in the AWS region where the + * API request is processed. This list can be filtered to match a specified string.

+ */ export class ListChannelsCommand extends $Command< ListChannelsCommandInput, ListChannelsCommandOutput, @@ -34,6 +38,9 @@ export class ListChannelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/ListPlaybackKeyPairsCommand.ts b/clients/client-ivs/commands/ListPlaybackKeyPairsCommand.ts index 8a3ce85665249..0d5d62c19947f 100644 --- a/clients/client-ivs/commands/ListPlaybackKeyPairsCommand.ts +++ b/clients/client-ivs/commands/ListPlaybackKeyPairsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPlaybackKeyPairsCommandInput = ListPlaybackKeyPairsRequest; export type ListPlaybackKeyPairsCommandOutput = ListPlaybackKeyPairsResponse & __MetadataBearer; +/** + *

Gets summary information about playback key pairs.

+ */ export class ListPlaybackKeyPairsCommand extends $Command< ListPlaybackKeyPairsCommandInput, ListPlaybackKeyPairsCommandOutput, @@ -34,6 +37,9 @@ export class ListPlaybackKeyPairsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/ListStreamKeysCommand.ts b/clients/client-ivs/commands/ListStreamKeysCommand.ts index 31969aac44a7c..c5722aa918bfd 100644 --- a/clients/client-ivs/commands/ListStreamKeysCommand.ts +++ b/clients/client-ivs/commands/ListStreamKeysCommand.ts @@ -20,6 +20,9 @@ import { export type ListStreamKeysCommandInput = ListStreamKeysRequest; export type ListStreamKeysCommandOutput = ListStreamKeysResponse & __MetadataBearer; +/** + *

Gets summary information about stream keys for the specified channel.

+ */ export class ListStreamKeysCommand extends $Command< ListStreamKeysCommandInput, ListStreamKeysCommandOutput, @@ -34,6 +37,9 @@ export class ListStreamKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/ListStreamsCommand.ts b/clients/client-ivs/commands/ListStreamsCommand.ts index e64e694ebbd2a..40a4ae5394d8b 100644 --- a/clients/client-ivs/commands/ListStreamsCommand.ts +++ b/clients/client-ivs/commands/ListStreamsCommand.ts @@ -20,6 +20,10 @@ import { export type ListStreamsCommandInput = ListStreamsRequest; export type ListStreamsCommandOutput = ListStreamsResponse & __MetadataBearer; +/** + *

Gets summary information about live streams in your account, in the AWS region where the + * API request is processed.

+ */ export class ListStreamsCommand extends $Command< ListStreamsCommandInput, ListStreamsCommandOutput, @@ -34,6 +38,9 @@ export class ListStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/ListTagsForResourceCommand.ts b/clients/client-ivs/commands/ListTagsForResourceCommand.ts index 370fcfe8470b4..fa7dd16d061d7 100644 --- a/clients/client-ivs/commands/ListTagsForResourceCommand.ts +++ b/clients/client-ivs/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Gets information about AWS tags for the specified ARN.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/PutMetadataCommand.ts b/clients/client-ivs/commands/PutMetadataCommand.ts index 81c34a4b299e2..0051df0b1cd7b 100644 --- a/clients/client-ivs/commands/PutMetadataCommand.ts +++ b/clients/client-ivs/commands/PutMetadataCommand.ts @@ -20,6 +20,10 @@ import { export type PutMetadataCommandInput = PutMetadataRequest; export type PutMetadataCommandOutput = __MetadataBearer; +/** + *

Inserts metadata into an RTMPS stream for the specified channel. A maximum of 5 requests + * per second per channel is allowed, each with a maximum 1KB payload.

+ */ export class PutMetadataCommand extends $Command< PutMetadataCommandInput, PutMetadataCommandOutput, @@ -34,6 +38,9 @@ export class PutMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/StopStreamCommand.ts b/clients/client-ivs/commands/StopStreamCommand.ts index abdd4dc1ec1cf..732c9f9d50401 100644 --- a/clients/client-ivs/commands/StopStreamCommand.ts +++ b/clients/client-ivs/commands/StopStreamCommand.ts @@ -20,6 +20,15 @@ import { export type StopStreamCommandInput = StopStreamRequest; export type StopStreamCommandOutput = StopStreamResponse & __MetadataBearer; +/** + *

Disconnects the incoming RTMPS stream for the specified channel. Can be used in conjunction with DeleteStreamKey to + * prevent further streaming to a channel.

+ * + *

Many streaming client-software libraries automatically reconnect a dropped RTMPS + * session, so to stop the stream permanently, you may want to first revoke the + * streamKey attached to the channel.

+ *
+ */ export class StopStreamCommand extends $Command< StopStreamCommandInput, StopStreamCommandOutput, @@ -34,6 +43,9 @@ export class StopStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/TagResourceCommand.ts b/clients/client-ivs/commands/TagResourceCommand.ts index 55d9dccd4e310..287eaed183934 100644 --- a/clients/client-ivs/commands/TagResourceCommand.ts +++ b/clients/client-ivs/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds or updates tags for the AWS resource with the specified ARN.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/UntagResourceCommand.ts b/clients/client-ivs/commands/UntagResourceCommand.ts index 5dcf816865493..c4801608594cf 100644 --- a/clients/client-ivs/commands/UntagResourceCommand.ts +++ b/clients/client-ivs/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes tags from the resource with the specified ARN.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/commands/UpdateChannelCommand.ts b/clients/client-ivs/commands/UpdateChannelCommand.ts index ba0bcdd61342e..b9c9b65a9fc96 100644 --- a/clients/client-ivs/commands/UpdateChannelCommand.ts +++ b/clients/client-ivs/commands/UpdateChannelCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateChannelCommandInput = UpdateChannelRequest; export type UpdateChannelCommandOutput = UpdateChannelResponse & __MetadataBearer; +/** + *

Updates a channel's configuration. This does not affect an ongoing stream of this channel. + * You must stop and restart the stream for the changes to take effect.

+ */ export class UpdateChannelCommand extends $Command< UpdateChannelCommandInput, UpdateChannelCommandOutput, @@ -34,6 +38,9 @@ export class UpdateChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: IvsClientResolvedConfig, diff --git a/clients/client-ivs/package.json b/clients/client-ivs/package.json index 9dce1431bd42b..6709c984b14b1 100644 --- a/clients/client-ivs/package.json +++ b/clients/client-ivs/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ivs Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ivs/pagination/ListChannelsPaginator.ts b/clients/client-ivs/pagination/ListChannelsPaginator.ts index 2362362135074..812ab3d3bde04 100644 --- a/clients/client-ivs/pagination/ListChannelsPaginator.ts +++ b/clients/client-ivs/pagination/ListChannelsPaginator.ts @@ -8,6 +8,9 @@ import { import { IvsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IvsClient, input: ListChannelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListChannelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Ivs, input: ListChannelsCommandInput, diff --git a/clients/client-ivs/pagination/ListPlaybackKeyPairsPaginator.ts b/clients/client-ivs/pagination/ListPlaybackKeyPairsPaginator.ts index 8a0b2a78aebc5..91c7031d37de3 100644 --- a/clients/client-ivs/pagination/ListPlaybackKeyPairsPaginator.ts +++ b/clients/client-ivs/pagination/ListPlaybackKeyPairsPaginator.ts @@ -8,6 +8,9 @@ import { import { IvsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IvsClient, input: ListPlaybackKeyPairsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPlaybackKeyPairsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Ivs, input: ListPlaybackKeyPairsCommandInput, diff --git a/clients/client-ivs/pagination/ListStreamKeysPaginator.ts b/clients/client-ivs/pagination/ListStreamKeysPaginator.ts index 534555e23096c..3c15d6d17b040 100644 --- a/clients/client-ivs/pagination/ListStreamKeysPaginator.ts +++ b/clients/client-ivs/pagination/ListStreamKeysPaginator.ts @@ -8,6 +8,9 @@ import { import { IvsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IvsClient, input: ListStreamKeysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStreamKeysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Ivs, input: ListStreamKeysCommandInput, diff --git a/clients/client-ivs/pagination/ListStreamsPaginator.ts b/clients/client-ivs/pagination/ListStreamsPaginator.ts index d010b1908d2d1..d2cc462239ad4 100644 --- a/clients/client-ivs/pagination/ListStreamsPaginator.ts +++ b/clients/client-ivs/pagination/ListStreamsPaginator.ts @@ -4,6 +4,9 @@ import { ListStreamsCommand, ListStreamsCommandInput, ListStreamsCommandOutput } import { IvsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IvsClient, input: ListStreamsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStreamsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Ivs, input: ListStreamsCommandInput, diff --git a/clients/client-ivs/pagination/ListTagsForResourcePaginator.ts b/clients/client-ivs/pagination/ListTagsForResourcePaginator.ts index 19de930ecbdf9..e0dc9b936f5a7 100644 --- a/clients/client-ivs/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-ivs/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { IvsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: IvsClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Ivs, input: ListTagsForResourceCommandInput, diff --git a/clients/client-ivs/runtimeConfig.browser.ts b/clients/client-ivs/runtimeConfig.browser.ts index 70e66d07961c5..f591e321ba451 100644 --- a/clients/client-ivs/runtimeConfig.browser.ts +++ b/clients/client-ivs/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./IvsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ivs/runtimeConfig.native.ts b/clients/client-ivs/runtimeConfig.native.ts index b09146a8c8731..a3ae4490de2d2 100644 --- a/clients/client-ivs/runtimeConfig.native.ts +++ b/clients/client-ivs/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./IvsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ivs/runtimeConfig.shared.ts b/clients/client-ivs/runtimeConfig.shared.ts index 736afeec1211b..42dc30640f4db 100644 --- a/clients/client-ivs/runtimeConfig.shared.ts +++ b/clients/client-ivs/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-07-14", disableHostPrefix: false, diff --git a/clients/client-ivs/runtimeConfig.ts b/clients/client-ivs/runtimeConfig.ts index cacaf45b7d45f..64682c169a78d 100644 --- a/clients/client-ivs/runtimeConfig.ts +++ b/clients/client-ivs/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./IvsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ivs/tsconfig.json b/clients/client-ivs/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ivs/tsconfig.json +++ b/clients/client-ivs/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kafka/commands/BatchAssociateScramSecretCommand.ts b/clients/client-kafka/commands/BatchAssociateScramSecretCommand.ts index 393a1b6192ffc..20483abb915f4 100644 --- a/clients/client-kafka/commands/BatchAssociateScramSecretCommand.ts +++ b/clients/client-kafka/commands/BatchAssociateScramSecretCommand.ts @@ -20,6 +20,9 @@ import { export type BatchAssociateScramSecretCommandInput = BatchAssociateScramSecretRequest; export type BatchAssociateScramSecretCommandOutput = BatchAssociateScramSecretResponse & __MetadataBearer; +/** + *

Associates one or more Scram Secrets with an Amazon MSK cluster.

+ */ export class BatchAssociateScramSecretCommand extends $Command< BatchAssociateScramSecretCommandInput, BatchAssociateScramSecretCommandOutput, @@ -34,6 +37,9 @@ export class BatchAssociateScramSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/BatchDisassociateScramSecretCommand.ts b/clients/client-kafka/commands/BatchDisassociateScramSecretCommand.ts index 83d938f2f142a..0db85907eaf8c 100644 --- a/clients/client-kafka/commands/BatchDisassociateScramSecretCommand.ts +++ b/clients/client-kafka/commands/BatchDisassociateScramSecretCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDisassociateScramSecretCommandInput = BatchDisassociateScramSecretRequest; export type BatchDisassociateScramSecretCommandOutput = BatchDisassociateScramSecretResponse & __MetadataBearer; +/** + *

Disassociates one or more Scram Secrets from an Amazon MSK cluster.

+ */ export class BatchDisassociateScramSecretCommand extends $Command< BatchDisassociateScramSecretCommandInput, BatchDisassociateScramSecretCommandOutput, @@ -34,6 +37,9 @@ export class BatchDisassociateScramSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/CreateClusterCommand.ts b/clients/client-kafka/commands/CreateClusterCommand.ts index 82222d52fd64c..4563685831744 100644 --- a/clients/client-kafka/commands/CreateClusterCommand.ts +++ b/clients/client-kafka/commands/CreateClusterCommand.ts @@ -20,6 +20,9 @@ import { export type CreateClusterCommandInput = CreateClusterRequest; export type CreateClusterCommandOutput = CreateClusterResponse & __MetadataBearer; +/** + *

Creates a new MSK cluster.

+ */ export class CreateClusterCommand extends $Command< CreateClusterCommandInput, CreateClusterCommandOutput, @@ -34,6 +37,9 @@ export class CreateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/CreateConfigurationCommand.ts b/clients/client-kafka/commands/CreateConfigurationCommand.ts index c1b7e381f55b7..62094e445032c 100644 --- a/clients/client-kafka/commands/CreateConfigurationCommand.ts +++ b/clients/client-kafka/commands/CreateConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateConfigurationCommandInput = CreateConfigurationRequest; export type CreateConfigurationCommandOutput = CreateConfigurationResponse & __MetadataBearer; +/** + *

Creates a new MSK configuration.

+ */ export class CreateConfigurationCommand extends $Command< CreateConfigurationCommandInput, CreateConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class CreateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/DeleteClusterCommand.ts b/clients/client-kafka/commands/DeleteClusterCommand.ts index e569bb1c1cb11..418fd766a14c2 100644 --- a/clients/client-kafka/commands/DeleteClusterCommand.ts +++ b/clients/client-kafka/commands/DeleteClusterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteClusterCommandInput = DeleteClusterRequest; export type DeleteClusterCommandOutput = DeleteClusterResponse & __MetadataBearer; +/** + *

Deletes the MSK cluster specified by the Amazon Resource Name (ARN) in the request.

+ */ export class DeleteClusterCommand extends $Command< DeleteClusterCommandInput, DeleteClusterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/DeleteConfigurationCommand.ts b/clients/client-kafka/commands/DeleteConfigurationCommand.ts index 89aaf50d9ed4f..310ac9ad3631c 100644 --- a/clients/client-kafka/commands/DeleteConfigurationCommand.ts +++ b/clients/client-kafka/commands/DeleteConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteConfigurationCommandInput = DeleteConfigurationRequest; export type DeleteConfigurationCommandOutput = DeleteConfigurationResponse & __MetadataBearer; +/** + *

Deletes an MSK Configuration.

+ */ export class DeleteConfigurationCommand extends $Command< DeleteConfigurationCommandInput, DeleteConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/DescribeClusterCommand.ts b/clients/client-kafka/commands/DescribeClusterCommand.ts index 118dca8cea8db..5bf664631b02c 100644 --- a/clients/client-kafka/commands/DescribeClusterCommand.ts +++ b/clients/client-kafka/commands/DescribeClusterCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClusterCommandInput = DescribeClusterRequest; export type DescribeClusterCommandOutput = DescribeClusterResponse & __MetadataBearer; +/** + *

Returns a description of the MSK cluster whose Amazon Resource Name (ARN) is specified in the request.

+ */ export class DescribeClusterCommand extends $Command< DescribeClusterCommandInput, DescribeClusterCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/DescribeClusterOperationCommand.ts b/clients/client-kafka/commands/DescribeClusterOperationCommand.ts index c8e4c2c4189d1..66789c2bcb122 100644 --- a/clients/client-kafka/commands/DescribeClusterOperationCommand.ts +++ b/clients/client-kafka/commands/DescribeClusterOperationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClusterOperationCommandInput = DescribeClusterOperationRequest; export type DescribeClusterOperationCommandOutput = DescribeClusterOperationResponse & __MetadataBearer; +/** + *

Returns a description of the cluster operation specified by the ARN.

+ */ export class DescribeClusterOperationCommand extends $Command< DescribeClusterOperationCommandInput, DescribeClusterOperationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClusterOperationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/DescribeConfigurationCommand.ts b/clients/client-kafka/commands/DescribeConfigurationCommand.ts index b3260dfd9d5b4..b0e96c1f0c2f1 100644 --- a/clients/client-kafka/commands/DescribeConfigurationCommand.ts +++ b/clients/client-kafka/commands/DescribeConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeConfigurationCommandInput = DescribeConfigurationRequest; export type DescribeConfigurationCommandOutput = DescribeConfigurationResponse & __MetadataBearer; +/** + *

Returns a description of this MSK configuration.

+ */ export class DescribeConfigurationCommand extends $Command< DescribeConfigurationCommandInput, DescribeConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/DescribeConfigurationRevisionCommand.ts b/clients/client-kafka/commands/DescribeConfigurationRevisionCommand.ts index d2dcc8d69c200..accbf41b3261c 100644 --- a/clients/client-kafka/commands/DescribeConfigurationRevisionCommand.ts +++ b/clients/client-kafka/commands/DescribeConfigurationRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeConfigurationRevisionCommandInput = DescribeConfigurationRevisionRequest; export type DescribeConfigurationRevisionCommandOutput = DescribeConfigurationRevisionResponse & __MetadataBearer; +/** + *

Returns a description of this revision of the configuration.

+ */ export class DescribeConfigurationRevisionCommand extends $Command< DescribeConfigurationRevisionCommandInput, DescribeConfigurationRevisionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeConfigurationRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/GetBootstrapBrokersCommand.ts b/clients/client-kafka/commands/GetBootstrapBrokersCommand.ts index 24ee06735a115..21793a54712c3 100644 --- a/clients/client-kafka/commands/GetBootstrapBrokersCommand.ts +++ b/clients/client-kafka/commands/GetBootstrapBrokersCommand.ts @@ -20,6 +20,9 @@ import { export type GetBootstrapBrokersCommandInput = GetBootstrapBrokersRequest; export type GetBootstrapBrokersCommandOutput = GetBootstrapBrokersResponse & __MetadataBearer; +/** + *

A list of brokers that a client application can use to bootstrap.

+ */ export class GetBootstrapBrokersCommand extends $Command< GetBootstrapBrokersCommandInput, GetBootstrapBrokersCommandOutput, @@ -34,6 +37,9 @@ export class GetBootstrapBrokersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/GetCompatibleKafkaVersionsCommand.ts b/clients/client-kafka/commands/GetCompatibleKafkaVersionsCommand.ts index e081644526655..b63cbe00611d7 100644 --- a/clients/client-kafka/commands/GetCompatibleKafkaVersionsCommand.ts +++ b/clients/client-kafka/commands/GetCompatibleKafkaVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetCompatibleKafkaVersionsCommandInput = GetCompatibleKafkaVersionsRequest; export type GetCompatibleKafkaVersionsCommandOutput = GetCompatibleKafkaVersionsResponse & __MetadataBearer; +/** + *

Gets the Apache Kafka versions to which you can update the MSK cluster.

+ */ export class GetCompatibleKafkaVersionsCommand extends $Command< GetCompatibleKafkaVersionsCommandInput, GetCompatibleKafkaVersionsCommandOutput, @@ -34,6 +37,9 @@ export class GetCompatibleKafkaVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/ListClusterOperationsCommand.ts b/clients/client-kafka/commands/ListClusterOperationsCommand.ts index e4845e0773140..c14797f348959 100644 --- a/clients/client-kafka/commands/ListClusterOperationsCommand.ts +++ b/clients/client-kafka/commands/ListClusterOperationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListClusterOperationsCommandInput = ListClusterOperationsRequest; export type ListClusterOperationsCommandOutput = ListClusterOperationsResponse & __MetadataBearer; +/** + *

Returns a list of all the operations that have been performed on the specified MSK cluster.

+ */ export class ListClusterOperationsCommand extends $Command< ListClusterOperationsCommandInput, ListClusterOperationsCommandOutput, @@ -34,6 +37,9 @@ export class ListClusterOperationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/ListClustersCommand.ts b/clients/client-kafka/commands/ListClustersCommand.ts index 7502ff871fb68..11539598a1b68 100644 --- a/clients/client-kafka/commands/ListClustersCommand.ts +++ b/clients/client-kafka/commands/ListClustersCommand.ts @@ -20,6 +20,9 @@ import { export type ListClustersCommandInput = ListClustersRequest; export type ListClustersCommandOutput = ListClustersResponse & __MetadataBearer; +/** + *

Returns a list of all the MSK clusters in the current Region.

+ */ export class ListClustersCommand extends $Command< ListClustersCommandInput, ListClustersCommandOutput, @@ -34,6 +37,9 @@ export class ListClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/ListConfigurationRevisionsCommand.ts b/clients/client-kafka/commands/ListConfigurationRevisionsCommand.ts index dfb5f1d4b5eb9..056b6c8b25f22 100644 --- a/clients/client-kafka/commands/ListConfigurationRevisionsCommand.ts +++ b/clients/client-kafka/commands/ListConfigurationRevisionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListConfigurationRevisionsCommandInput = ListConfigurationRevisionsRequest; export type ListConfigurationRevisionsCommandOutput = ListConfigurationRevisionsResponse & __MetadataBearer; +/** + *

Returns a list of all the MSK configurations in this Region.

+ */ export class ListConfigurationRevisionsCommand extends $Command< ListConfigurationRevisionsCommandInput, ListConfigurationRevisionsCommandOutput, @@ -34,6 +37,9 @@ export class ListConfigurationRevisionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/ListConfigurationsCommand.ts b/clients/client-kafka/commands/ListConfigurationsCommand.ts index 53c5859c33cf1..cc982f9b8a1f9 100644 --- a/clients/client-kafka/commands/ListConfigurationsCommand.ts +++ b/clients/client-kafka/commands/ListConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListConfigurationsCommandInput = ListConfigurationsRequest; export type ListConfigurationsCommandOutput = ListConfigurationsResponse & __MetadataBearer; +/** + *

Returns a list of all the MSK configurations in this Region.

+ */ export class ListConfigurationsCommand extends $Command< ListConfigurationsCommandInput, ListConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class ListConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/ListKafkaVersionsCommand.ts b/clients/client-kafka/commands/ListKafkaVersionsCommand.ts index 2c09584ab766a..10d68fc9a8437 100644 --- a/clients/client-kafka/commands/ListKafkaVersionsCommand.ts +++ b/clients/client-kafka/commands/ListKafkaVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListKafkaVersionsCommandInput = ListKafkaVersionsRequest; export type ListKafkaVersionsCommandOutput = ListKafkaVersionsResponse & __MetadataBearer; +/** + *

Returns a list of Kafka versions.

+ */ export class ListKafkaVersionsCommand extends $Command< ListKafkaVersionsCommandInput, ListKafkaVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListKafkaVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/ListNodesCommand.ts b/clients/client-kafka/commands/ListNodesCommand.ts index 11fbd954930fe..f3253fa0c9abd 100644 --- a/clients/client-kafka/commands/ListNodesCommand.ts +++ b/clients/client-kafka/commands/ListNodesCommand.ts @@ -20,6 +20,9 @@ import { export type ListNodesCommandInput = ListNodesRequest; export type ListNodesCommandOutput = ListNodesResponse & __MetadataBearer; +/** + *

Returns a list of the broker nodes in the cluster.

+ */ export class ListNodesCommand extends $Command< ListNodesCommandInput, ListNodesCommandOutput, @@ -34,6 +37,9 @@ export class ListNodesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/ListScramSecretsCommand.ts b/clients/client-kafka/commands/ListScramSecretsCommand.ts index 89b038f2ee871..66613a12e3270 100644 --- a/clients/client-kafka/commands/ListScramSecretsCommand.ts +++ b/clients/client-kafka/commands/ListScramSecretsCommand.ts @@ -20,6 +20,9 @@ import { export type ListScramSecretsCommandInput = ListScramSecretsRequest; export type ListScramSecretsCommandOutput = ListScramSecretsResponse & __MetadataBearer; +/** + *

Returns a list of the Scram Secrets associated with an Amazon MSK cluster.

+ */ export class ListScramSecretsCommand extends $Command< ListScramSecretsCommandInput, ListScramSecretsCommandOutput, @@ -34,6 +37,9 @@ export class ListScramSecretsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/ListTagsForResourceCommand.ts b/clients/client-kafka/commands/ListTagsForResourceCommand.ts index f9132a6b4c260..21441bbbca8b6 100644 --- a/clients/client-kafka/commands/ListTagsForResourceCommand.ts +++ b/clients/client-kafka/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns a list of the tags associated with the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/RebootBrokerCommand.ts b/clients/client-kafka/commands/RebootBrokerCommand.ts index 2498b1b6e4b8d..c7da4da5ca92d 100644 --- a/clients/client-kafka/commands/RebootBrokerCommand.ts +++ b/clients/client-kafka/commands/RebootBrokerCommand.ts @@ -20,6 +20,9 @@ import { export type RebootBrokerCommandInput = RebootBrokerRequest; export type RebootBrokerCommandOutput = RebootBrokerResponse & __MetadataBearer; +/** + * Reboots brokers. + */ export class RebootBrokerCommand extends $Command< RebootBrokerCommandInput, RebootBrokerCommandOutput, @@ -34,6 +37,9 @@ export class RebootBrokerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/TagResourceCommand.ts b/clients/client-kafka/commands/TagResourceCommand.ts index 16dd2a2f67f4c..f5bcea5a3b657 100644 --- a/clients/client-kafka/commands/TagResourceCommand.ts +++ b/clients/client-kafka/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds tags to the specified MSK resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/UntagResourceCommand.ts b/clients/client-kafka/commands/UntagResourceCommand.ts index 508b3fa018f79..c678126b0f991 100644 --- a/clients/client-kafka/commands/UntagResourceCommand.ts +++ b/clients/client-kafka/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes the tags associated with the keys that are provided in the query.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/UpdateBrokerCountCommand.ts b/clients/client-kafka/commands/UpdateBrokerCountCommand.ts index 822838d359f20..96bd0739d3bcf 100644 --- a/clients/client-kafka/commands/UpdateBrokerCountCommand.ts +++ b/clients/client-kafka/commands/UpdateBrokerCountCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateBrokerCountCommandInput = UpdateBrokerCountRequest; export type UpdateBrokerCountCommandOutput = UpdateBrokerCountResponse & __MetadataBearer; +/** + *

Updates the number of broker nodes in the cluster.

+ */ export class UpdateBrokerCountCommand extends $Command< UpdateBrokerCountCommandInput, UpdateBrokerCountCommandOutput, @@ -34,6 +37,9 @@ export class UpdateBrokerCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/UpdateBrokerStorageCommand.ts b/clients/client-kafka/commands/UpdateBrokerStorageCommand.ts index ad44c4721b5e4..4f934c4f6ebe6 100644 --- a/clients/client-kafka/commands/UpdateBrokerStorageCommand.ts +++ b/clients/client-kafka/commands/UpdateBrokerStorageCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateBrokerStorageCommandInput = UpdateBrokerStorageRequest; export type UpdateBrokerStorageCommandOutput = UpdateBrokerStorageResponse & __MetadataBearer; +/** + *

Updates the EBS storage associated with MSK brokers.

+ */ export class UpdateBrokerStorageCommand extends $Command< UpdateBrokerStorageCommandInput, UpdateBrokerStorageCommandOutput, @@ -34,6 +37,9 @@ export class UpdateBrokerStorageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/UpdateClusterConfigurationCommand.ts b/clients/client-kafka/commands/UpdateClusterConfigurationCommand.ts index ecfecf9019b87..f06ac86fd2b53 100644 --- a/clients/client-kafka/commands/UpdateClusterConfigurationCommand.ts +++ b/clients/client-kafka/commands/UpdateClusterConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateClusterConfigurationCommandInput = UpdateClusterConfigurationRequest; export type UpdateClusterConfigurationCommandOutput = UpdateClusterConfigurationResponse & __MetadataBearer; +/** + *

Updates the cluster with the configuration that is specified in the request body.

+ */ export class UpdateClusterConfigurationCommand extends $Command< UpdateClusterConfigurationCommandInput, UpdateClusterConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateClusterConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/UpdateClusterKafkaVersionCommand.ts b/clients/client-kafka/commands/UpdateClusterKafkaVersionCommand.ts index a434b3a8eb440..b38be237b234d 100644 --- a/clients/client-kafka/commands/UpdateClusterKafkaVersionCommand.ts +++ b/clients/client-kafka/commands/UpdateClusterKafkaVersionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateClusterKafkaVersionCommandInput = UpdateClusterKafkaVersionRequest; export type UpdateClusterKafkaVersionCommandOutput = UpdateClusterKafkaVersionResponse & __MetadataBearer; +/** + *

Updates the Apache Kafka version for the cluster.

+ */ export class UpdateClusterKafkaVersionCommand extends $Command< UpdateClusterKafkaVersionCommandInput, UpdateClusterKafkaVersionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateClusterKafkaVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/UpdateConfigurationCommand.ts b/clients/client-kafka/commands/UpdateConfigurationCommand.ts index f834e50eeb2f9..59102e000579a 100644 --- a/clients/client-kafka/commands/UpdateConfigurationCommand.ts +++ b/clients/client-kafka/commands/UpdateConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConfigurationCommandInput = UpdateConfigurationRequest; export type UpdateConfigurationCommandOutput = UpdateConfigurationResponse & __MetadataBearer; +/** + *

Updates an MSK configuration.

+ */ export class UpdateConfigurationCommand extends $Command< UpdateConfigurationCommandInput, UpdateConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/commands/UpdateMonitoringCommand.ts b/clients/client-kafka/commands/UpdateMonitoringCommand.ts index 60f916b568a59..19b94e764376a 100644 --- a/clients/client-kafka/commands/UpdateMonitoringCommand.ts +++ b/clients/client-kafka/commands/UpdateMonitoringCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMonitoringCommandInput = UpdateMonitoringRequest; export type UpdateMonitoringCommandOutput = UpdateMonitoringResponse & __MetadataBearer; +/** + *

Updates the monitoring settings for the cluster. You can use this operation to specify which Apache Kafka metrics you want Amazon MSK to send to Amazon CloudWatch. You can also specify settings for open monitoring with Prometheus.

+ */ export class UpdateMonitoringCommand extends $Command< UpdateMonitoringCommandInput, UpdateMonitoringCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMonitoringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KafkaClientResolvedConfig, diff --git a/clients/client-kafka/package.json b/clients/client-kafka/package.json index 84c910559defe..b4f3ac303262c 100644 --- a/clients/client-kafka/package.json +++ b/clients/client-kafka/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kafka Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kafka/pagination/ListClusterOperationsPaginator.ts b/clients/client-kafka/pagination/ListClusterOperationsPaginator.ts index cda65913edf95..878844e95d97d 100644 --- a/clients/client-kafka/pagination/ListClusterOperationsPaginator.ts +++ b/clients/client-kafka/pagination/ListClusterOperationsPaginator.ts @@ -8,6 +8,9 @@ import { import { KafkaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KafkaClient, input: ListClusterOperationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListClusterOperationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kafka, input: ListClusterOperationsCommandInput, diff --git a/clients/client-kafka/pagination/ListClustersPaginator.ts b/clients/client-kafka/pagination/ListClustersPaginator.ts index ab58cc12db568..ff72967a6f24f 100644 --- a/clients/client-kafka/pagination/ListClustersPaginator.ts +++ b/clients/client-kafka/pagination/ListClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { KafkaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KafkaClient, input: ListClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kafka, input: ListClustersCommandInput, diff --git a/clients/client-kafka/pagination/ListConfigurationRevisionsPaginator.ts b/clients/client-kafka/pagination/ListConfigurationRevisionsPaginator.ts index d47b95c837cd7..214ce1e2e5062 100644 --- a/clients/client-kafka/pagination/ListConfigurationRevisionsPaginator.ts +++ b/clients/client-kafka/pagination/ListConfigurationRevisionsPaginator.ts @@ -8,6 +8,9 @@ import { import { KafkaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KafkaClient, input: ListConfigurationRevisionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConfigurationRevisionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kafka, input: ListConfigurationRevisionsCommandInput, diff --git a/clients/client-kafka/pagination/ListConfigurationsPaginator.ts b/clients/client-kafka/pagination/ListConfigurationsPaginator.ts index 930546659fff1..8457e93bced13 100644 --- a/clients/client-kafka/pagination/ListConfigurationsPaginator.ts +++ b/clients/client-kafka/pagination/ListConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { KafkaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KafkaClient, input: ListConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kafka, input: ListConfigurationsCommandInput, diff --git a/clients/client-kafka/pagination/ListKafkaVersionsPaginator.ts b/clients/client-kafka/pagination/ListKafkaVersionsPaginator.ts index e898658f43570..008082bf9383e 100644 --- a/clients/client-kafka/pagination/ListKafkaVersionsPaginator.ts +++ b/clients/client-kafka/pagination/ListKafkaVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { KafkaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KafkaClient, input: ListKafkaVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListKafkaVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kafka, input: ListKafkaVersionsCommandInput, diff --git a/clients/client-kafka/pagination/ListNodesPaginator.ts b/clients/client-kafka/pagination/ListNodesPaginator.ts index 94c877b945142..601a7b6565f57 100644 --- a/clients/client-kafka/pagination/ListNodesPaginator.ts +++ b/clients/client-kafka/pagination/ListNodesPaginator.ts @@ -4,6 +4,9 @@ import { ListNodesCommand, ListNodesCommandInput, ListNodesCommandOutput } from import { KafkaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KafkaClient, input: ListNodesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNodesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kafka, input: ListNodesCommandInput, diff --git a/clients/client-kafka/pagination/ListScramSecretsPaginator.ts b/clients/client-kafka/pagination/ListScramSecretsPaginator.ts index cec451e7ebb95..4f2c4ef15fd76 100644 --- a/clients/client-kafka/pagination/ListScramSecretsPaginator.ts +++ b/clients/client-kafka/pagination/ListScramSecretsPaginator.ts @@ -8,6 +8,9 @@ import { import { KafkaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KafkaClient, input: ListScramSecretsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListScramSecretsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kafka, input: ListScramSecretsCommandInput, diff --git a/clients/client-kafka/runtimeConfig.browser.ts b/clients/client-kafka/runtimeConfig.browser.ts index 9fb019335d169..d62e728f6b8d2 100644 --- a/clients/client-kafka/runtimeConfig.browser.ts +++ b/clients/client-kafka/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KafkaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kafka/runtimeConfig.native.ts b/clients/client-kafka/runtimeConfig.native.ts index 4a868118a090d..68f1b5b25b893 100644 --- a/clients/client-kafka/runtimeConfig.native.ts +++ b/clients/client-kafka/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KafkaClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kafka/runtimeConfig.shared.ts b/clients/client-kafka/runtimeConfig.shared.ts index d368a9a19ced3..8876a58472a84 100644 --- a/clients/client-kafka/runtimeConfig.shared.ts +++ b/clients/client-kafka/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-14", disableHostPrefix: false, diff --git a/clients/client-kafka/runtimeConfig.ts b/clients/client-kafka/runtimeConfig.ts index 086c4d0c662c9..98d4c018d4a49 100644 --- a/clients/client-kafka/runtimeConfig.ts +++ b/clients/client-kafka/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KafkaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kafka/tsconfig.json b/clients/client-kafka/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kafka/tsconfig.json +++ b/clients/client-kafka/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kendra/commands/BatchDeleteDocumentCommand.ts b/clients/client-kendra/commands/BatchDeleteDocumentCommand.ts index 28e34dc861c71..91f771a90243f 100644 --- a/clients/client-kendra/commands/BatchDeleteDocumentCommand.ts +++ b/clients/client-kendra/commands/BatchDeleteDocumentCommand.ts @@ -20,6 +20,13 @@ import { export type BatchDeleteDocumentCommandInput = BatchDeleteDocumentRequest; export type BatchDeleteDocumentCommandOutput = BatchDeleteDocumentResponse & __MetadataBearer; +/** + *

Removes one or more documents from an index. The documents must have been added with the + * BatchPutDocument operation.

+ *

The documents are deleted asynchronously. You can see the progress of the deletion by + * using AWS CloudWatch. Any error messages releated to the processing of the batch are sent to + * you CloudWatch log.

+ */ export class BatchDeleteDocumentCommand extends $Command< BatchDeleteDocumentCommandInput, BatchDeleteDocumentCommandOutput, @@ -34,6 +41,9 @@ export class BatchDeleteDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/BatchPutDocumentCommand.ts b/clients/client-kendra/commands/BatchPutDocumentCommand.ts index 33a1aadaa6a42..631e6e18abd4a 100644 --- a/clients/client-kendra/commands/BatchPutDocumentCommand.ts +++ b/clients/client-kendra/commands/BatchPutDocumentCommand.ts @@ -20,6 +20,16 @@ import { export type BatchPutDocumentCommandInput = BatchPutDocumentRequest; export type BatchPutDocumentCommandOutput = BatchPutDocumentResponse & __MetadataBearer; +/** + *

Adds one or more documents to an index.

+ *

The BatchPutDocument operation enables you to ingest inline documents or a + * set of documents stored in an Amazon S3 bucket. Use this operation to ingest your text and + * unstructured text into an index, add custom attributes to the documents, and to attach an + * access control list to the documents added to the index.

+ *

The documents are indexed asynchronously. You can see the progress of the batch using AWS + * CloudWatch. Any error messages related to processing the batch are sent to your AWS CloudWatch + * log.

+ */ export class BatchPutDocumentCommand extends $Command< BatchPutDocumentCommandInput, BatchPutDocumentCommandOutput, @@ -34,6 +44,9 @@ export class BatchPutDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/CreateDataSourceCommand.ts b/clients/client-kendra/commands/CreateDataSourceCommand.ts index 6407a9153b798..86c2398909793 100644 --- a/clients/client-kendra/commands/CreateDataSourceCommand.ts +++ b/clients/client-kendra/commands/CreateDataSourceCommand.ts @@ -20,6 +20,15 @@ import { export type CreateDataSourceCommandInput = CreateDataSourceRequest; export type CreateDataSourceCommandOutput = CreateDataSourceResponse & __MetadataBearer; +/** + *

Creates a data source that you use to with an Amazon Kendra index.

+ *

You specify a name, data source connector type and description for your data source. You + * also specify configuration information such as document metadata (author, source URI, and so + * on) and user context information.

+ *

+ * CreateDataSource is a synchronous operation. The operation returns 200 if the + * data source was successfully created. Otherwise, an exception is raised.

+ */ export class CreateDataSourceCommand extends $Command< CreateDataSourceCommandInput, CreateDataSourceCommandOutput, @@ -34,6 +43,9 @@ export class CreateDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/CreateFaqCommand.ts b/clients/client-kendra/commands/CreateFaqCommand.ts index 1eddd1a90c912..e446b8c27acf8 100644 --- a/clients/client-kendra/commands/CreateFaqCommand.ts +++ b/clients/client-kendra/commands/CreateFaqCommand.ts @@ -17,6 +17,9 @@ import { export type CreateFaqCommandInput = CreateFaqRequest; export type CreateFaqCommandOutput = CreateFaqResponse & __MetadataBearer; +/** + *

Creates an new set of frequently asked question (FAQ) questions and answers.

+ */ export class CreateFaqCommand extends $Command< CreateFaqCommandInput, CreateFaqCommandOutput, @@ -31,6 +34,9 @@ export class CreateFaqCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/CreateIndexCommand.ts b/clients/client-kendra/commands/CreateIndexCommand.ts index 17573d9fdb409..da65c079cba0a 100644 --- a/clients/client-kendra/commands/CreateIndexCommand.ts +++ b/clients/client-kendra/commands/CreateIndexCommand.ts @@ -20,6 +20,14 @@ import { export type CreateIndexCommandInput = CreateIndexRequest; export type CreateIndexCommandOutput = CreateIndexResponse & __MetadataBearer; +/** + *

Creates a new Amazon Kendra index. Index creation is an asynchronous operation. To + * determine if index creation has completed, check the Status field returned from a + * call to . The Status field is set to + * ACTIVE when the index is ready to use.

+ *

Once the index is active you can index your documents using the operation or using one of the supported data sources. + *

+ */ export class CreateIndexCommand extends $Command< CreateIndexCommandInput, CreateIndexCommandOutput, @@ -34,6 +42,9 @@ export class CreateIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/DeleteDataSourceCommand.ts b/clients/client-kendra/commands/DeleteDataSourceCommand.ts index d57554b7a9b2d..661c2e92e37db 100644 --- a/clients/client-kendra/commands/DeleteDataSourceCommand.ts +++ b/clients/client-kendra/commands/DeleteDataSourceCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDataSourceCommandInput = DeleteDataSourceRequest; export type DeleteDataSourceCommandOutput = __MetadataBearer; +/** + *

Deletes an Amazon Kendra data source. An exception is not thrown if the data source is + * already being deleted. While the data source is being deleted, the Status field + * returned by a call to the operation is set to + * DELETING. For more information, see Deleting Data Sources.

+ */ export class DeleteDataSourceCommand extends $Command< DeleteDataSourceCommandInput, DeleteDataSourceCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/DeleteFaqCommand.ts b/clients/client-kendra/commands/DeleteFaqCommand.ts index 111e9729f18f3..b62dad9121af2 100644 --- a/clients/client-kendra/commands/DeleteFaqCommand.ts +++ b/clients/client-kendra/commands/DeleteFaqCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteFaqCommandInput = DeleteFaqRequest; export type DeleteFaqCommandOutput = __MetadataBearer; +/** + *

Removes an FAQ from an index.

+ */ export class DeleteFaqCommand extends $Command< DeleteFaqCommandInput, DeleteFaqCommandOutput, @@ -31,6 +34,9 @@ export class DeleteFaqCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/DeleteIndexCommand.ts b/clients/client-kendra/commands/DeleteIndexCommand.ts index 83f5918976784..e8e96714f3b50 100644 --- a/clients/client-kendra/commands/DeleteIndexCommand.ts +++ b/clients/client-kendra/commands/DeleteIndexCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteIndexCommandInput = DeleteIndexRequest; export type DeleteIndexCommandOutput = __MetadataBearer; +/** + *

Deletes an existing Amazon Kendra index. An exception is not thrown if the index is already + * being deleted. While the index is being deleted, the Status field returned by a + * call to the DescribeIndex operation is set to DELETING.

+ */ export class DeleteIndexCommand extends $Command< DeleteIndexCommandInput, DeleteIndexCommandOutput, @@ -34,6 +39,9 @@ export class DeleteIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/DescribeDataSourceCommand.ts b/clients/client-kendra/commands/DescribeDataSourceCommand.ts index cd1b381af8ebc..36a4e893d7c5a 100644 --- a/clients/client-kendra/commands/DescribeDataSourceCommand.ts +++ b/clients/client-kendra/commands/DescribeDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDataSourceCommandInput = DescribeDataSourceRequest; export type DescribeDataSourceCommandOutput = DescribeDataSourceResponse & __MetadataBearer; +/** + *

Gets information about a Amazon Kendra data source.

+ */ export class DescribeDataSourceCommand extends $Command< DescribeDataSourceCommandInput, DescribeDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/DescribeFaqCommand.ts b/clients/client-kendra/commands/DescribeFaqCommand.ts index 2ca4efc6b278e..3dc459afe9e6c 100644 --- a/clients/client-kendra/commands/DescribeFaqCommand.ts +++ b/clients/client-kendra/commands/DescribeFaqCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFaqCommandInput = DescribeFaqRequest; export type DescribeFaqCommandOutput = DescribeFaqResponse & __MetadataBearer; +/** + *

Gets information about an FAQ list.

+ */ export class DescribeFaqCommand extends $Command< DescribeFaqCommandInput, DescribeFaqCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFaqCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/DescribeIndexCommand.ts b/clients/client-kendra/commands/DescribeIndexCommand.ts index b9cf1393967cd..2dd0ebbbd3d1a 100644 --- a/clients/client-kendra/commands/DescribeIndexCommand.ts +++ b/clients/client-kendra/commands/DescribeIndexCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeIndexCommandInput = DescribeIndexRequest; export type DescribeIndexCommandOutput = DescribeIndexResponse & __MetadataBearer; +/** + *

Describes an existing Amazon Kendra index

+ */ export class DescribeIndexCommand extends $Command< DescribeIndexCommandInput, DescribeIndexCommandOutput, @@ -34,6 +37,9 @@ export class DescribeIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/ListDataSourceSyncJobsCommand.ts b/clients/client-kendra/commands/ListDataSourceSyncJobsCommand.ts index 13a8dec64e8f2..c5783f736d6da 100644 --- a/clients/client-kendra/commands/ListDataSourceSyncJobsCommand.ts +++ b/clients/client-kendra/commands/ListDataSourceSyncJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDataSourceSyncJobsCommandInput = ListDataSourceSyncJobsRequest; export type ListDataSourceSyncJobsCommandOutput = ListDataSourceSyncJobsResponse & __MetadataBearer; +/** + *

Gets statistics about synchronizing Amazon Kendra with a data source.

+ */ export class ListDataSourceSyncJobsCommand extends $Command< ListDataSourceSyncJobsCommandInput, ListDataSourceSyncJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListDataSourceSyncJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/ListDataSourcesCommand.ts b/clients/client-kendra/commands/ListDataSourcesCommand.ts index 08eb7db489fc9..41df00b8a2a19 100644 --- a/clients/client-kendra/commands/ListDataSourcesCommand.ts +++ b/clients/client-kendra/commands/ListDataSourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDataSourcesCommandInput = ListDataSourcesRequest; export type ListDataSourcesCommandOutput = ListDataSourcesResponse & __MetadataBearer; +/** + *

Lists the data sources that you have created.

+ */ export class ListDataSourcesCommand extends $Command< ListDataSourcesCommandInput, ListDataSourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListDataSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/ListFaqsCommand.ts b/clients/client-kendra/commands/ListFaqsCommand.ts index 18ba61ef3595a..ce069f16d371e 100644 --- a/clients/client-kendra/commands/ListFaqsCommand.ts +++ b/clients/client-kendra/commands/ListFaqsCommand.ts @@ -17,6 +17,9 @@ import { export type ListFaqsCommandInput = ListFaqsRequest; export type ListFaqsCommandOutput = ListFaqsResponse & __MetadataBearer; +/** + *

Gets a list of FAQ lists associated with an index.

+ */ export class ListFaqsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class ListFaqsCommand extends $Command, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/ListIndicesCommand.ts b/clients/client-kendra/commands/ListIndicesCommand.ts index 160ffeabc252d..ee177ccc56e5a 100644 --- a/clients/client-kendra/commands/ListIndicesCommand.ts +++ b/clients/client-kendra/commands/ListIndicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListIndicesCommandInput = ListIndicesRequest; export type ListIndicesCommandOutput = ListIndicesResponse & __MetadataBearer; +/** + *

Lists the Amazon Kendra indexes that you have created.

+ */ export class ListIndicesCommand extends $Command< ListIndicesCommandInput, ListIndicesCommandOutput, @@ -34,6 +37,9 @@ export class ListIndicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/ListTagsForResourceCommand.ts b/clients/client-kendra/commands/ListTagsForResourceCommand.ts index 7cb134053de69..2717a75b5c758 100644 --- a/clients/client-kendra/commands/ListTagsForResourceCommand.ts +++ b/clients/client-kendra/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Gets a list of tags associated with a specified resource. Indexes, FAQs, and data sources + * can have tags associated with them.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/QueryCommand.ts b/clients/client-kendra/commands/QueryCommand.ts index 61f912a2fc9cb..132a765883073 100644 --- a/clients/client-kendra/commands/QueryCommand.ts +++ b/clients/client-kendra/commands/QueryCommand.ts @@ -17,6 +17,29 @@ import { export type QueryCommandInput = QueryRequest; export type QueryCommandOutput = QueryResult & __MetadataBearer; +/** + *

Searches an active index. Use this API to search your documents using query. The + * Query operation enables to do faceted search and to filter results based on + * document attributes.

+ *

It also enables you to provide user context that Amazon Kendra uses to enforce document + * access control in the search results.

+ *

Amazon Kendra searches your index for text content and question and answer (FAQ) content. + * By default the response contains three types of results.

+ *
    + *
  • + *

    Relevant passages

    + *
  • + *
  • + *

    Matching FAQs

    + *
  • + *
  • + *

    Relevant documents

    + *
  • + *
+ *

You can specify that the query return only one type of result using the + * QueryResultTypeConfig parameter.

+ *

Each query returns the 100 most relevant results.

+ */ export class QueryCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +50,9 @@ export class QueryCommand extends $Command, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/StartDataSourceSyncJobCommand.ts b/clients/client-kendra/commands/StartDataSourceSyncJobCommand.ts index a10817067cce2..13c318682cb36 100644 --- a/clients/client-kendra/commands/StartDataSourceSyncJobCommand.ts +++ b/clients/client-kendra/commands/StartDataSourceSyncJobCommand.ts @@ -20,6 +20,10 @@ import { export type StartDataSourceSyncJobCommandInput = StartDataSourceSyncJobRequest; export type StartDataSourceSyncJobCommandOutput = StartDataSourceSyncJobResponse & __MetadataBearer; +/** + *

Starts a synchronization job for a data source. If a synchronization job is already in + * progress, Amazon Kendra returns a ResourceInUseException exception.

+ */ export class StartDataSourceSyncJobCommand extends $Command< StartDataSourceSyncJobCommandInput, StartDataSourceSyncJobCommandOutput, @@ -34,6 +38,9 @@ export class StartDataSourceSyncJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/StopDataSourceSyncJobCommand.ts b/clients/client-kendra/commands/StopDataSourceSyncJobCommand.ts index 46a83c0589249..143632a83a120 100644 --- a/clients/client-kendra/commands/StopDataSourceSyncJobCommand.ts +++ b/clients/client-kendra/commands/StopDataSourceSyncJobCommand.ts @@ -20,6 +20,10 @@ import { export type StopDataSourceSyncJobCommandInput = StopDataSourceSyncJobRequest; export type StopDataSourceSyncJobCommandOutput = __MetadataBearer; +/** + *

Stops a running synchronization job. You can't stop a scheduled synchronization + * job.

+ */ export class StopDataSourceSyncJobCommand extends $Command< StopDataSourceSyncJobCommandInput, StopDataSourceSyncJobCommandOutput, @@ -34,6 +38,9 @@ export class StopDataSourceSyncJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/SubmitFeedbackCommand.ts b/clients/client-kendra/commands/SubmitFeedbackCommand.ts index 51bf90f5bd0de..440ca39d76b9a 100644 --- a/clients/client-kendra/commands/SubmitFeedbackCommand.ts +++ b/clients/client-kendra/commands/SubmitFeedbackCommand.ts @@ -20,6 +20,10 @@ import { export type SubmitFeedbackCommandInput = SubmitFeedbackRequest; export type SubmitFeedbackCommandOutput = __MetadataBearer; +/** + *

Enables you to provide feedback to Amazon Kendra to improve the performance + * of the service.

+ */ export class SubmitFeedbackCommand extends $Command< SubmitFeedbackCommandInput, SubmitFeedbackCommandOutput, @@ -34,6 +38,9 @@ export class SubmitFeedbackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/TagResourceCommand.ts b/clients/client-kendra/commands/TagResourceCommand.ts index c2016ebbcb905..24e3eb643678d 100644 --- a/clients/client-kendra/commands/TagResourceCommand.ts +++ b/clients/client-kendra/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds the specified tag to the specified index, FAQ, or data source resource. If the tag + * already exists, the existing value is replaced with the new value.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/UntagResourceCommand.ts b/clients/client-kendra/commands/UntagResourceCommand.ts index 4909eaaaa64d8..5f975881154a3 100644 --- a/clients/client-kendra/commands/UntagResourceCommand.ts +++ b/clients/client-kendra/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag from an index, FAQ, or a data source.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/UpdateDataSourceCommand.ts b/clients/client-kendra/commands/UpdateDataSourceCommand.ts index 8bbd733bce2c0..146f0a598b6b9 100644 --- a/clients/client-kendra/commands/UpdateDataSourceCommand.ts +++ b/clients/client-kendra/commands/UpdateDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDataSourceCommandInput = UpdateDataSourceRequest; export type UpdateDataSourceCommandOutput = __MetadataBearer; +/** + *

Updates an existing Amazon Kendra data source.

+ */ export class UpdateDataSourceCommand extends $Command< UpdateDataSourceCommandInput, UpdateDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/commands/UpdateIndexCommand.ts b/clients/client-kendra/commands/UpdateIndexCommand.ts index b2299525d451b..5508362dd8e79 100644 --- a/clients/client-kendra/commands/UpdateIndexCommand.ts +++ b/clients/client-kendra/commands/UpdateIndexCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateIndexCommandInput = UpdateIndexRequest; export type UpdateIndexCommandOutput = __MetadataBearer; +/** + *

Updates an existing Amazon Kendra index.

+ */ export class UpdateIndexCommand extends $Command< UpdateIndexCommandInput, UpdateIndexCommandOutput, @@ -34,6 +37,9 @@ export class UpdateIndexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KendraClientResolvedConfig, diff --git a/clients/client-kendra/package.json b/clients/client-kendra/package.json index 1ad034e4e6233..34d74bbd33e90 100644 --- a/clients/client-kendra/package.json +++ b/clients/client-kendra/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kendra Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kendra/pagination/ListDataSourceSyncJobsPaginator.ts b/clients/client-kendra/pagination/ListDataSourceSyncJobsPaginator.ts index d4d756318a916..8e9461b5a569a 100644 --- a/clients/client-kendra/pagination/ListDataSourceSyncJobsPaginator.ts +++ b/clients/client-kendra/pagination/ListDataSourceSyncJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { KendraPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KendraClient, input: ListDataSourceSyncJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDataSourceSyncJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kendra, input: ListDataSourceSyncJobsCommandInput, diff --git a/clients/client-kendra/pagination/ListDataSourcesPaginator.ts b/clients/client-kendra/pagination/ListDataSourcesPaginator.ts index 2844ab9f5a4ce..d58bc65dbeb57 100644 --- a/clients/client-kendra/pagination/ListDataSourcesPaginator.ts +++ b/clients/client-kendra/pagination/ListDataSourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { KendraPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KendraClient, input: ListDataSourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDataSourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kendra, input: ListDataSourcesCommandInput, diff --git a/clients/client-kendra/pagination/ListIndicesPaginator.ts b/clients/client-kendra/pagination/ListIndicesPaginator.ts index 0c803f3685cb3..4cec501d16057 100644 --- a/clients/client-kendra/pagination/ListIndicesPaginator.ts +++ b/clients/client-kendra/pagination/ListIndicesPaginator.ts @@ -4,6 +4,9 @@ import { ListIndicesCommand, ListIndicesCommandInput, ListIndicesCommandOutput } import { KendraPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KendraClient, input: ListIndicesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListIndicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kendra, input: ListIndicesCommandInput, diff --git a/clients/client-kendra/runtimeConfig.browser.ts b/clients/client-kendra/runtimeConfig.browser.ts index 9ab4efe87a51a..cc7ef420e7841 100644 --- a/clients/client-kendra/runtimeConfig.browser.ts +++ b/clients/client-kendra/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KendraClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kendra/runtimeConfig.native.ts b/clients/client-kendra/runtimeConfig.native.ts index 9b47aea5cf533..ac61356eb12eb 100644 --- a/clients/client-kendra/runtimeConfig.native.ts +++ b/clients/client-kendra/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KendraClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kendra/runtimeConfig.shared.ts b/clients/client-kendra/runtimeConfig.shared.ts index 1eebaf44ad82a..7dedd69213947 100644 --- a/clients/client-kendra/runtimeConfig.shared.ts +++ b/clients/client-kendra/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-02-03", disableHostPrefix: false, diff --git a/clients/client-kendra/runtimeConfig.ts b/clients/client-kendra/runtimeConfig.ts index c63b107e3383f..599c639044b69 100644 --- a/clients/client-kendra/runtimeConfig.ts +++ b/clients/client-kendra/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KendraClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kendra/tsconfig.json b/clients/client-kendra/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kendra/tsconfig.json +++ b/clients/client-kendra/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kinesis-analytics-v2/commands/AddApplicationCloudWatchLoggingOptionCommand.ts b/clients/client-kinesis-analytics-v2/commands/AddApplicationCloudWatchLoggingOptionCommand.ts index 655bf70b8e1aa..a6ef6947e47e7 100644 --- a/clients/client-kinesis-analytics-v2/commands/AddApplicationCloudWatchLoggingOptionCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/AddApplicationCloudWatchLoggingOptionCommand.ts @@ -28,6 +28,9 @@ export type AddApplicationCloudWatchLoggingOptionCommandInput = AddApplicationCl export type AddApplicationCloudWatchLoggingOptionCommandOutput = AddApplicationCloudWatchLoggingOptionResponse & __MetadataBearer; +/** + *

Adds an Amazon CloudWatch log stream to monitor application configuration errors.

+ */ export class AddApplicationCloudWatchLoggingOptionCommand extends $Command< AddApplicationCloudWatchLoggingOptionCommandInput, AddApplicationCloudWatchLoggingOptionCommandOutput, @@ -42,6 +45,9 @@ export class AddApplicationCloudWatchLoggingOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/AddApplicationInputCommand.ts b/clients/client-kinesis-analytics-v2/commands/AddApplicationInputCommand.ts index 6c95276e063f3..eb126fcce8dc2 100644 --- a/clients/client-kinesis-analytics-v2/commands/AddApplicationInputCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/AddApplicationInputCommand.ts @@ -24,6 +24,18 @@ import { export type AddApplicationInputCommandInput = AddApplicationInputRequest; export type AddApplicationInputCommandOutput = AddApplicationInputResponse & __MetadataBearer; +/** + *

+ * Adds a streaming source to your SQL-based Kinesis Data Analytics application. + *

+ *

You can add a streaming source when you create an application, or you can use this + * operation to add a streaming source after you create an application. For more information, see + * CreateApplication.

+ *

Any configuration update, including adding a streaming source using this operation, + * results in a new version of the application. You can use the DescribeApplication operation + * to find the current application version. + *

+ */ export class AddApplicationInputCommand extends $Command< AddApplicationInputCommandInput, AddApplicationInputCommandOutput, @@ -38,6 +50,9 @@ export class AddApplicationInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/AddApplicationInputProcessingConfigurationCommand.ts b/clients/client-kinesis-analytics-v2/commands/AddApplicationInputProcessingConfigurationCommand.ts index a774b7ddf4b95..541274be89eb3 100644 --- a/clients/client-kinesis-analytics-v2/commands/AddApplicationInputProcessingConfigurationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/AddApplicationInputProcessingConfigurationCommand.ts @@ -28,6 +28,11 @@ export type AddApplicationInputProcessingConfigurationCommandInput = AddApplicat export type AddApplicationInputProcessingConfigurationCommandOutput = AddApplicationInputProcessingConfigurationResponse & __MetadataBearer; +/** + *

Adds an InputProcessingConfiguration to a SQL-based Kinesis Data Analytics application. An input processor pre-processes records + * on the input stream before the + * application's SQL code executes. Currently, the only input processor available is AWS Lambda.

+ */ export class AddApplicationInputProcessingConfigurationCommand extends $Command< AddApplicationInputProcessingConfigurationCommandInput, AddApplicationInputProcessingConfigurationCommandOutput, @@ -42,6 +47,9 @@ export class AddApplicationInputProcessingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/AddApplicationOutputCommand.ts b/clients/client-kinesis-analytics-v2/commands/AddApplicationOutputCommand.ts index 30561f13697db..4150ed42e800a 100644 --- a/clients/client-kinesis-analytics-v2/commands/AddApplicationOutputCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/AddApplicationOutputCommand.ts @@ -24,6 +24,21 @@ import { export type AddApplicationOutputCommandInput = AddApplicationOutputRequest; export type AddApplicationOutputCommandOutput = AddApplicationOutputResponse & __MetadataBearer; +/** + *

Adds an external destination to your SQL-based Kinesis Data Analytics application.

+ *

If you want Kinesis Data Analytics to deliver data from an in-application stream within + * your application to an external destination (such as an Kinesis data stream, a Kinesis Data + * Firehose delivery stream, or an AWS Lambda function), you add the relevant configuration to + * your application using this operation. You can configure one or more outputs for your + * application. Each output configuration maps an in-application stream and an external + * destination.

+ *

You can use one of the output configurations to deliver data from your + * in-application error stream to an external destination so that you can analyze the + * errors.

+ *

Any configuration update, including adding a streaming source using this + * operation, results in a new version of the application. You can use the DescribeApplication operation to find the current application + * version.

+ */ export class AddApplicationOutputCommand extends $Command< AddApplicationOutputCommandInput, AddApplicationOutputCommandOutput, @@ -38,6 +53,9 @@ export class AddApplicationOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/AddApplicationReferenceDataSourceCommand.ts b/clients/client-kinesis-analytics-v2/commands/AddApplicationReferenceDataSourceCommand.ts index 6ca56824b2981..a3a0e12cfa5db 100644 --- a/clients/client-kinesis-analytics-v2/commands/AddApplicationReferenceDataSourceCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/AddApplicationReferenceDataSourceCommand.ts @@ -28,6 +28,14 @@ export type AddApplicationReferenceDataSourceCommandInput = AddApplicationRefere export type AddApplicationReferenceDataSourceCommandOutput = AddApplicationReferenceDataSourceResponse & __MetadataBearer; +/** + *

Adds a reference data source to an existing SQL-based Kinesis Data Analytics application.

+ *

Kinesis Data Analytics reads reference data (that is, an Amazon S3 object) and creates an + * in-application table within your application. In the request, you provide the source (S3 + * bucket name and object key name), name of the in-application table to create, and the + * necessary mapping information that describes how data in an Amazon S3 object maps to columns + * in the resulting in-application table.

+ */ export class AddApplicationReferenceDataSourceCommand extends $Command< AddApplicationReferenceDataSourceCommandInput, AddApplicationReferenceDataSourceCommandOutput, @@ -42,6 +50,9 @@ export class AddApplicationReferenceDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/AddApplicationVpcConfigurationCommand.ts b/clients/client-kinesis-analytics-v2/commands/AddApplicationVpcConfigurationCommand.ts index d73eae9d313a9..54cfd01f6ab07 100644 --- a/clients/client-kinesis-analytics-v2/commands/AddApplicationVpcConfigurationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/AddApplicationVpcConfigurationCommand.ts @@ -24,6 +24,20 @@ import { export type AddApplicationVpcConfigurationCommandInput = AddApplicationVpcConfigurationRequest; export type AddApplicationVpcConfigurationCommandOutput = AddApplicationVpcConfigurationResponse & __MetadataBearer; +/** + *

Adds a Virtual Private Cloud (VPC) configuration to the application. Applications can use VPCs to store + * and access resources securely.

+ *

Note the following about VPC configurations for Kinesis Data Analytics applications:

+ *
    + *
  • + *

    VPC configurations are not supported for SQL applications.

    + *
  • + *
  • + *

    When a VPC is added to a Kinesis Data Analytics application, the application can no longer be accessed from the + * Internet directly. To enable Internet access to the application, add an Internet gateway to your VPC.

    + *
  • + *
+ */ export class AddApplicationVpcConfigurationCommand extends $Command< AddApplicationVpcConfigurationCommandInput, AddApplicationVpcConfigurationCommandOutput, @@ -38,6 +52,9 @@ export class AddApplicationVpcConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/CreateApplicationCommand.ts b/clients/client-kinesis-analytics-v2/commands/CreateApplicationCommand.ts index af52e77be6c7c..1b0a52d60d18f 100644 --- a/clients/client-kinesis-analytics-v2/commands/CreateApplicationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/CreateApplicationCommand.ts @@ -24,6 +24,11 @@ import { export type CreateApplicationCommandInput = CreateApplicationRequest; export type CreateApplicationCommandOutput = CreateApplicationResponse & __MetadataBearer; +/** + *

Creates a Kinesis Data Analytics application. For information about creating a + * Kinesis Data Analytics application, see Creating an + * Application.

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -38,6 +43,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/CreateApplicationSnapshotCommand.ts b/clients/client-kinesis-analytics-v2/commands/CreateApplicationSnapshotCommand.ts index f0fa9257c6d49..354619bdac348 100644 --- a/clients/client-kinesis-analytics-v2/commands/CreateApplicationSnapshotCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/CreateApplicationSnapshotCommand.ts @@ -24,6 +24,9 @@ import { export type CreateApplicationSnapshotCommandInput = CreateApplicationSnapshotRequest; export type CreateApplicationSnapshotCommandOutput = CreateApplicationSnapshotResponse & __MetadataBearer; +/** + *

Creates a snapshot of the application's state data.

+ */ export class CreateApplicationSnapshotCommand extends $Command< CreateApplicationSnapshotCommandInput, CreateApplicationSnapshotCommandOutput, @@ -38,6 +41,9 @@ export class CreateApplicationSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationCloudWatchLoggingOptionCommand.ts b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationCloudWatchLoggingOptionCommand.ts index 48ac6215c39ca..717ed2cf2fcdd 100644 --- a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationCloudWatchLoggingOptionCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationCloudWatchLoggingOptionCommand.ts @@ -28,6 +28,9 @@ export type DeleteApplicationCloudWatchLoggingOptionCommandInput = DeleteApplica export type DeleteApplicationCloudWatchLoggingOptionCommandOutput = DeleteApplicationCloudWatchLoggingOptionResponse & __MetadataBearer; +/** + *

Deletes an Amazon CloudWatch log stream from an Kinesis Data Analytics application.

+ */ export class DeleteApplicationCloudWatchLoggingOptionCommand extends $Command< DeleteApplicationCloudWatchLoggingOptionCommandInput, DeleteApplicationCloudWatchLoggingOptionCommandOutput, @@ -42,6 +45,9 @@ export class DeleteApplicationCloudWatchLoggingOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationCommand.ts b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationCommand.ts index ac775cad3b2eb..e029b345ec687 100644 --- a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteApplicationCommandInput = DeleteApplicationRequest; export type DeleteApplicationCommandOutput = DeleteApplicationResponse & __MetadataBearer; +/** + *

Deletes the specified application. Kinesis Data Analytics halts application execution and deletes the application.

+ */ export class DeleteApplicationCommand extends $Command< DeleteApplicationCommandInput, DeleteApplicationCommandOutput, @@ -38,6 +41,9 @@ export class DeleteApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationInputProcessingConfigurationCommand.ts b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationInputProcessingConfigurationCommand.ts index de7b9014f63f1..7fbeeb6f7e9e2 100644 --- a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationInputProcessingConfigurationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationInputProcessingConfigurationCommand.ts @@ -28,6 +28,9 @@ export type DeleteApplicationInputProcessingConfigurationCommandInput = DeleteAp export type DeleteApplicationInputProcessingConfigurationCommandOutput = DeleteApplicationInputProcessingConfigurationResponse & __MetadataBearer; +/** + *

Deletes an InputProcessingConfiguration from an input.

+ */ export class DeleteApplicationInputProcessingConfigurationCommand extends $Command< DeleteApplicationInputProcessingConfigurationCommandInput, DeleteApplicationInputProcessingConfigurationCommandOutput, @@ -42,6 +45,9 @@ export class DeleteApplicationInputProcessingConfigurationCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationOutputCommand.ts b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationOutputCommand.ts index 1132e684a5cfd..b51be3efbc1b2 100644 --- a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationOutputCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationOutputCommand.ts @@ -24,6 +24,11 @@ import { export type DeleteApplicationOutputCommandInput = DeleteApplicationOutputRequest; export type DeleteApplicationOutputCommandOutput = DeleteApplicationOutputResponse & __MetadataBearer; +/** + *

Deletes the output destination configuration from your SQL-based Kinesis Data Analytics application's configuration. + * Kinesis Data Analytics will no longer write data from + * the corresponding in-application stream to the external output destination.

+ */ export class DeleteApplicationOutputCommand extends $Command< DeleteApplicationOutputCommandInput, DeleteApplicationOutputCommandOutput, @@ -38,6 +43,9 @@ export class DeleteApplicationOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationReferenceDataSourceCommand.ts b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationReferenceDataSourceCommand.ts index 48c9d173538df..baa6c561faabd 100644 --- a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationReferenceDataSourceCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationReferenceDataSourceCommand.ts @@ -28,6 +28,11 @@ export type DeleteApplicationReferenceDataSourceCommandInput = DeleteApplication export type DeleteApplicationReferenceDataSourceCommandOutput = DeleteApplicationReferenceDataSourceResponse & __MetadataBearer; +/** + *

Deletes a reference data source configuration from the specified SQL-based Kinesis Data Analytics application's configuration.

+ *

If the application is running, Kinesis Data Analytics immediately removes the in-application table + * that you created using the AddApplicationReferenceDataSource operation.

+ */ export class DeleteApplicationReferenceDataSourceCommand extends $Command< DeleteApplicationReferenceDataSourceCommandInput, DeleteApplicationReferenceDataSourceCommandOutput, @@ -42,6 +47,9 @@ export class DeleteApplicationReferenceDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationSnapshotCommand.ts b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationSnapshotCommand.ts index edb9441e60427..289a98552deb8 100644 --- a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationSnapshotCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationSnapshotCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteApplicationSnapshotCommandInput = DeleteApplicationSnapshotRequest; export type DeleteApplicationSnapshotCommandOutput = DeleteApplicationSnapshotResponse & __MetadataBearer; +/** + *

Deletes a snapshot of application state.

+ */ export class DeleteApplicationSnapshotCommand extends $Command< DeleteApplicationSnapshotCommandInput, DeleteApplicationSnapshotCommandOutput, @@ -38,6 +41,9 @@ export class DeleteApplicationSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationVpcConfigurationCommand.ts b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationVpcConfigurationCommand.ts index b0ce322629ad3..327af442743a1 100644 --- a/clients/client-kinesis-analytics-v2/commands/DeleteApplicationVpcConfigurationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DeleteApplicationVpcConfigurationCommand.ts @@ -28,6 +28,9 @@ export type DeleteApplicationVpcConfigurationCommandInput = DeleteApplicationVpc export type DeleteApplicationVpcConfigurationCommandOutput = DeleteApplicationVpcConfigurationResponse & __MetadataBearer; +/** + *

Removes a VPC configuration from a Kinesis Data Analytics application.

+ */ export class DeleteApplicationVpcConfigurationCommand extends $Command< DeleteApplicationVpcConfigurationCommandInput, DeleteApplicationVpcConfigurationCommandOutput, @@ -42,6 +45,9 @@ export class DeleteApplicationVpcConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DescribeApplicationCommand.ts b/clients/client-kinesis-analytics-v2/commands/DescribeApplicationCommand.ts index c5e8d7f66d001..4f619046f0546 100644 --- a/clients/client-kinesis-analytics-v2/commands/DescribeApplicationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DescribeApplicationCommand.ts @@ -24,6 +24,11 @@ import { export type DescribeApplicationCommandInput = DescribeApplicationRequest; export type DescribeApplicationCommandOutput = DescribeApplicationResponse & __MetadataBearer; +/** + *

Returns information about a specific Kinesis Data Analytics application.

+ *

If you want to retrieve a list of all applications in your account, + * use the ListApplications operation.

+ */ export class DescribeApplicationCommand extends $Command< DescribeApplicationCommandInput, DescribeApplicationCommandOutput, @@ -38,6 +43,9 @@ export class DescribeApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DescribeApplicationSnapshotCommand.ts b/clients/client-kinesis-analytics-v2/commands/DescribeApplicationSnapshotCommand.ts index 9f7fbb1d087dd..c24873a41714c 100644 --- a/clients/client-kinesis-analytics-v2/commands/DescribeApplicationSnapshotCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DescribeApplicationSnapshotCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeApplicationSnapshotCommandInput = DescribeApplicationSnapshotRequest; export type DescribeApplicationSnapshotCommandOutput = DescribeApplicationSnapshotResponse & __MetadataBearer; +/** + *

Returns information about a snapshot of application state data.

+ */ export class DescribeApplicationSnapshotCommand extends $Command< DescribeApplicationSnapshotCommandInput, DescribeApplicationSnapshotCommandOutput, @@ -38,6 +41,9 @@ export class DescribeApplicationSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/DiscoverInputSchemaCommand.ts b/clients/client-kinesis-analytics-v2/commands/DiscoverInputSchemaCommand.ts index b2849a74f09c9..7a64416117084 100644 --- a/clients/client-kinesis-analytics-v2/commands/DiscoverInputSchemaCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/DiscoverInputSchemaCommand.ts @@ -24,6 +24,15 @@ import { export type DiscoverInputSchemaCommandInput = DiscoverInputSchemaRequest; export type DiscoverInputSchemaCommandOutput = DiscoverInputSchemaResponse & __MetadataBearer; +/** + *

Infers a schema for a SQL-based Kinesis Data Analytics application by evaluating + * sample records on the specified streaming source (Kinesis data stream or Kinesis Data Firehose + * delivery stream) or Amazon S3 object. In the response, the operation returns the inferred + * schema and also the sample records that the operation used to infer the schema.

+ *

You can use the inferred schema when configuring a streaming source for your application. + * When you create an application using the Kinesis Data Analytics console, the console uses this + * operation to infer a schema and show it in the console user interface.

+ */ export class DiscoverInputSchemaCommand extends $Command< DiscoverInputSchemaCommandInput, DiscoverInputSchemaCommandOutput, @@ -38,6 +47,9 @@ export class DiscoverInputSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/ListApplicationSnapshotsCommand.ts b/clients/client-kinesis-analytics-v2/commands/ListApplicationSnapshotsCommand.ts index d454b677bd6dc..42d4365e42997 100644 --- a/clients/client-kinesis-analytics-v2/commands/ListApplicationSnapshotsCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/ListApplicationSnapshotsCommand.ts @@ -24,6 +24,9 @@ import { export type ListApplicationSnapshotsCommandInput = ListApplicationSnapshotsRequest; export type ListApplicationSnapshotsCommandOutput = ListApplicationSnapshotsResponse & __MetadataBearer; +/** + *

Lists information about the current application snapshots.

+ */ export class ListApplicationSnapshotsCommand extends $Command< ListApplicationSnapshotsCommandInput, ListApplicationSnapshotsCommandOutput, @@ -38,6 +41,9 @@ export class ListApplicationSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/ListApplicationsCommand.ts b/clients/client-kinesis-analytics-v2/commands/ListApplicationsCommand.ts index 382d1ba2a86f9..bdb0e484994e8 100644 --- a/clients/client-kinesis-analytics-v2/commands/ListApplicationsCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/ListApplicationsCommand.ts @@ -24,6 +24,13 @@ import { export type ListApplicationsCommandInput = ListApplicationsRequest; export type ListApplicationsCommandOutput = ListApplicationsResponse & __MetadataBearer; +/** + *

Returns a list of Kinesis Data Analytics applications in your account. For each + * application, the response includes the application name, Amazon Resource Name (ARN), and + * status.

+ *

If you want detailed information about a specific application, use + * DescribeApplication.

+ */ export class ListApplicationsCommand extends $Command< ListApplicationsCommandInput, ListApplicationsCommandOutput, @@ -38,6 +45,9 @@ export class ListApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/ListTagsForResourceCommand.ts b/clients/client-kinesis-analytics-v2/commands/ListTagsForResourceCommand.ts index 9249e9a5af88a..3dd20c5bee146 100644 --- a/clients/client-kinesis-analytics-v2/commands/ListTagsForResourceCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves the list of key-value tags assigned to the application. For more information, see + * Using Tagging.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +42,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/StartApplicationCommand.ts b/clients/client-kinesis-analytics-v2/commands/StartApplicationCommand.ts index 263d9e40391fb..52341135a0592 100644 --- a/clients/client-kinesis-analytics-v2/commands/StartApplicationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/StartApplicationCommand.ts @@ -24,6 +24,10 @@ import { export type StartApplicationCommandInput = StartApplicationRequest; export type StartApplicationCommandOutput = StartApplicationResponse & __MetadataBearer; +/** + *

Starts the specified Kinesis Data Analytics application. After creating an application, you must exclusively call this operation to + * start your application.

+ */ export class StartApplicationCommand extends $Command< StartApplicationCommandInput, StartApplicationCommandOutput, @@ -38,6 +42,9 @@ export class StartApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/StopApplicationCommand.ts b/clients/client-kinesis-analytics-v2/commands/StopApplicationCommand.ts index 74c596d2ec9cf..634b76d39e7fb 100644 --- a/clients/client-kinesis-analytics-v2/commands/StopApplicationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/StopApplicationCommand.ts @@ -24,6 +24,12 @@ import { export type StopApplicationCommandInput = StopApplicationRequest; export type StopApplicationCommandOutput = StopApplicationResponse & __MetadataBearer; +/** + *

Stops the application from processing data. You can stop + * an application only if it is in the running state. + * You can use the DescribeApplication operation to find the application state. + *

+ */ export class StopApplicationCommand extends $Command< StopApplicationCommandInput, StopApplicationCommandOutput, @@ -38,6 +44,9 @@ export class StopApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/TagResourceCommand.ts b/clients/client-kinesis-analytics-v2/commands/TagResourceCommand.ts index 709f2f8ff0008..58738182221d9 100644 --- a/clients/client-kinesis-analytics-v2/commands/TagResourceCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/TagResourceCommand.ts @@ -24,6 +24,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds one or more key-value tags to a Kinesis Data Analytics application. Note that the maximum number of application + * tags includes system tags. The maximum number of user-defined application tags is 50. + * For more information, see Using Tagging.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +43,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/UntagResourceCommand.ts b/clients/client-kinesis-analytics-v2/commands/UntagResourceCommand.ts index 433edea761a41..bf2735c7c64da 100644 --- a/clients/client-kinesis-analytics-v2/commands/UntagResourceCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/UntagResourceCommand.ts @@ -24,6 +24,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from a Kinesis Data Analytics application. For more information, see + * Using Tagging.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +42,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/commands/UpdateApplicationCommand.ts b/clients/client-kinesis-analytics-v2/commands/UpdateApplicationCommand.ts index 3e027121a7ec5..f9b4a0c67c379 100644 --- a/clients/client-kinesis-analytics-v2/commands/UpdateApplicationCommand.ts +++ b/clients/client-kinesis-analytics-v2/commands/UpdateApplicationCommand.ts @@ -24,6 +24,17 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationRequest; export type UpdateApplicationCommandOutput = UpdateApplicationResponse & __MetadataBearer; +/** + *

Updates an existing Kinesis Data Analytics application. Using this operation, you + * can update application code, input configuration, and output configuration.

+ *

Kinesis Data Analytics updates the ApplicationVersionId each time you update + * your application.

+ * + *

You cannot update the RuntimeEnvironment of an existing application. If you + * need to update an application's RuntimeEnvironment, you must delete the application + * and create it again.

+ *
+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -38,6 +49,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsV2ClientResolvedConfig, diff --git a/clients/client-kinesis-analytics-v2/package.json b/clients/client-kinesis-analytics-v2/package.json index b031b3a7bc816..4e15774dfd761 100644 --- a/clients/client-kinesis-analytics-v2/package.json +++ b/clients/client-kinesis-analytics-v2/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kinesis Analytics V2 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kinesis-analytics-v2/runtimeConfig.browser.ts b/clients/client-kinesis-analytics-v2/runtimeConfig.browser.ts index 7ac12c73b96b2..3b2022b439ecd 100644 --- a/clients/client-kinesis-analytics-v2/runtimeConfig.browser.ts +++ b/clients/client-kinesis-analytics-v2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KinesisAnalyticsV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kinesis-analytics-v2/runtimeConfig.native.ts b/clients/client-kinesis-analytics-v2/runtimeConfig.native.ts index 7265af426aaa5..606d5e3900cf1 100644 --- a/clients/client-kinesis-analytics-v2/runtimeConfig.native.ts +++ b/clients/client-kinesis-analytics-v2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KinesisAnalyticsV2Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kinesis-analytics-v2/runtimeConfig.shared.ts b/clients/client-kinesis-analytics-v2/runtimeConfig.shared.ts index 95454ae71775b..56fb549fa7aeb 100644 --- a/clients/client-kinesis-analytics-v2/runtimeConfig.shared.ts +++ b/clients/client-kinesis-analytics-v2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-05-23", disableHostPrefix: false, diff --git a/clients/client-kinesis-analytics-v2/runtimeConfig.ts b/clients/client-kinesis-analytics-v2/runtimeConfig.ts index cd5724b4c2fd3..17a51ee82a490 100644 --- a/clients/client-kinesis-analytics-v2/runtimeConfig.ts +++ b/clients/client-kinesis-analytics-v2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KinesisAnalyticsV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kinesis-analytics-v2/tsconfig.json b/clients/client-kinesis-analytics-v2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kinesis-analytics-v2/tsconfig.json +++ b/clients/client-kinesis-analytics-v2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kinesis-analytics/commands/AddApplicationCloudWatchLoggingOptionCommand.ts b/clients/client-kinesis-analytics/commands/AddApplicationCloudWatchLoggingOptionCommand.ts index 1c0561a1b2e31..c4cc00601800c 100644 --- a/clients/client-kinesis-analytics/commands/AddApplicationCloudWatchLoggingOptionCommand.ts +++ b/clients/client-kinesis-analytics/commands/AddApplicationCloudWatchLoggingOptionCommand.ts @@ -24,6 +24,15 @@ export type AddApplicationCloudWatchLoggingOptionCommandInput = AddApplicationCl export type AddApplicationCloudWatchLoggingOptionCommandOutput = AddApplicationCloudWatchLoggingOptionResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Adds a CloudWatch log stream to monitor application configuration errors. For more + * information about using CloudWatch log streams with Amazon Kinesis Analytics + * applications, see Working with Amazon + * CloudWatch Logs.

+ */ export class AddApplicationCloudWatchLoggingOptionCommand extends $Command< AddApplicationCloudWatchLoggingOptionCommandInput, AddApplicationCloudWatchLoggingOptionCommandOutput, @@ -38,6 +47,9 @@ export class AddApplicationCloudWatchLoggingOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/AddApplicationInputCommand.ts b/clients/client-kinesis-analytics/commands/AddApplicationInputCommand.ts index e1bb9f0421308..768c7e955f6b6 100644 --- a/clients/client-kinesis-analytics/commands/AddApplicationInputCommand.ts +++ b/clients/client-kinesis-analytics/commands/AddApplicationInputCommand.ts @@ -20,6 +20,25 @@ import { export type AddApplicationInputCommandInput = AddApplicationInputRequest; export type AddApplicationInputCommandOutput = AddApplicationInputResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

+ * Adds a streaming source to your Amazon Kinesis application. + * For conceptual information, + * see Configuring Application Input. + *

+ *

You can add a streaming source either when you create an application or you can use + * this operation to add a streaming source after you create an application. For more information, see + * CreateApplication.

+ *

Any configuration update, including adding a streaming source using this operation, + * results in a new version of the application. You can use the DescribeApplication operation + * to find the current application version. + *

+ *

This operation requires permissions to perform the + * kinesisanalytics:AddApplicationInput action.

+ */ export class AddApplicationInputCommand extends $Command< AddApplicationInputCommandInput, AddApplicationInputCommandOutput, @@ -34,6 +53,9 @@ export class AddApplicationInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/AddApplicationInputProcessingConfigurationCommand.ts b/clients/client-kinesis-analytics/commands/AddApplicationInputProcessingConfigurationCommand.ts index 6a45eb1867212..74ebea95b1a1d 100644 --- a/clients/client-kinesis-analytics/commands/AddApplicationInputProcessingConfigurationCommand.ts +++ b/clients/client-kinesis-analytics/commands/AddApplicationInputProcessingConfigurationCommand.ts @@ -24,6 +24,14 @@ export type AddApplicationInputProcessingConfigurationCommandInput = AddApplicat export type AddApplicationInputProcessingConfigurationCommandOutput = AddApplicationInputProcessingConfigurationResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Adds an InputProcessingConfiguration to an application. An input processor preprocesses records on the input stream + * before the application's SQL code executes. Currently, the only input processor available is + * AWS Lambda.

+ */ export class AddApplicationInputProcessingConfigurationCommand extends $Command< AddApplicationInputProcessingConfigurationCommandInput, AddApplicationInputProcessingConfigurationCommandOutput, @@ -38,6 +46,9 @@ export class AddApplicationInputProcessingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/AddApplicationOutputCommand.ts b/clients/client-kinesis-analytics/commands/AddApplicationOutputCommand.ts index cbb703b7bab27..0b00f65e324e2 100644 --- a/clients/client-kinesis-analytics/commands/AddApplicationOutputCommand.ts +++ b/clients/client-kinesis-analytics/commands/AddApplicationOutputCommand.ts @@ -20,6 +20,28 @@ import { export type AddApplicationOutputCommandInput = AddApplicationOutputRequest; export type AddApplicationOutputCommandOutput = AddApplicationOutputResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Adds an external destination to your Amazon Kinesis Analytics application.

+ *

If you want Amazon Kinesis Analytics to deliver data from an in-application stream + * within your application to an external destination (such as an Amazon Kinesis stream, an + * Amazon Kinesis Firehose delivery stream, or an AWS Lambda function), you add the + * relevant configuration to your application using this operation. You can configure one + * or more outputs for your application. Each output configuration maps an in-application + * stream and an external destination.

+ *

You can use one of the output configurations to deliver data from your + * in-application error stream to an external destination so that you can analyze the + * errors. For more information, see Understanding Application + * Output (Destination).

+ *

Any configuration update, including adding a streaming source using this + * operation, results in a new version of the application. You can use the DescribeApplication operation to find the current application + * version.

+ *

For the limits on the number of application inputs and outputs + * you can configure, see Limits.

+ *

This operation requires permissions to perform the kinesisanalytics:AddApplicationOutput action.

+ */ export class AddApplicationOutputCommand extends $Command< AddApplicationOutputCommandInput, AddApplicationOutputCommandOutput, @@ -34,6 +56,9 @@ export class AddApplicationOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/AddApplicationReferenceDataSourceCommand.ts b/clients/client-kinesis-analytics/commands/AddApplicationReferenceDataSourceCommand.ts index f496c488ef0d8..68dabab0a650f 100644 --- a/clients/client-kinesis-analytics/commands/AddApplicationReferenceDataSourceCommand.ts +++ b/clients/client-kinesis-analytics/commands/AddApplicationReferenceDataSourceCommand.ts @@ -24,6 +24,22 @@ export type AddApplicationReferenceDataSourceCommandInput = AddApplicationRefere export type AddApplicationReferenceDataSourceCommandOutput = AddApplicationReferenceDataSourceResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Adds a reference data source to an existing application.

+ *

Amazon Kinesis Analytics reads reference data (that is, an Amazon S3 object) and creates an in-application table within your application. In the request, you provide the source (S3 bucket name and object key name), name of the in-application table to create, and the necessary mapping information that describes how data in Amazon S3 object maps to columns in the resulting in-application table.

+ *

+ * For conceptual information, + * see Configuring Application Input. + * For the limits on data sources you can add to your application, see + * Limits. + *

+ *

+ * This operation requires permissions to perform the kinesisanalytics:AddApplicationOutput action. + *

+ */ export class AddApplicationReferenceDataSourceCommand extends $Command< AddApplicationReferenceDataSourceCommandInput, AddApplicationReferenceDataSourceCommandOutput, @@ -38,6 +54,9 @@ export class AddApplicationReferenceDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/CreateApplicationCommand.ts b/clients/client-kinesis-analytics/commands/CreateApplicationCommand.ts index 99c2911380e92..80a04c7afede8 100644 --- a/clients/client-kinesis-analytics/commands/CreateApplicationCommand.ts +++ b/clients/client-kinesis-analytics/commands/CreateApplicationCommand.ts @@ -20,6 +20,35 @@ import { export type CreateApplicationCommandInput = CreateApplicationRequest; export type CreateApplicationCommandOutput = CreateApplicationResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ * + *

+ * Creates an Amazon Kinesis Analytics application. + * You can configure each application with one streaming source as input, + * application code to process the input, and up to + * three destinations where + * you want Amazon Kinesis Analytics to write the output data from your application. + * For an overview, see + * How it Works. + *

+ *

In the input configuration, you map the streaming source to an in-application stream, which you can think of as a constantly updating table. In the mapping, you must provide a schema for the in-application stream and map each data column in the in-application stream to a + * data element in the streaming source.

+ * + *

Your application code is one or more SQL statements that read input data, transform it, and generate output. Your application code can create one or more SQL artifacts like SQL streams or pumps.

+ *

In the output configuration, you can configure the application to write data from in-application streams created in your applications to up to three destinations.

+ *

+ * To read data from your source stream or write data to destination streams, Amazon Kinesis Analytics + * needs your permissions. You grant these permissions by creating IAM roles. This operation requires permissions to perform the + * kinesisanalytics:CreateApplication action. + *

+ *

+ * For introductory exercises to create an Amazon Kinesis Analytics application, see + * Getting Started. + *

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -34,6 +63,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/DeleteApplicationCloudWatchLoggingOptionCommand.ts b/clients/client-kinesis-analytics/commands/DeleteApplicationCloudWatchLoggingOptionCommand.ts index e1a4024cca1ab..d95edc32de82f 100644 --- a/clients/client-kinesis-analytics/commands/DeleteApplicationCloudWatchLoggingOptionCommand.ts +++ b/clients/client-kinesis-analytics/commands/DeleteApplicationCloudWatchLoggingOptionCommand.ts @@ -24,6 +24,14 @@ export type DeleteApplicationCloudWatchLoggingOptionCommandInput = DeleteApplica export type DeleteApplicationCloudWatchLoggingOptionCommandOutput = DeleteApplicationCloudWatchLoggingOptionResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Deletes a CloudWatch log stream from an application. For more information about + * using CloudWatch log streams with Amazon Kinesis Analytics applications, see + * Working with Amazon CloudWatch Logs.

+ */ export class DeleteApplicationCloudWatchLoggingOptionCommand extends $Command< DeleteApplicationCloudWatchLoggingOptionCommandInput, DeleteApplicationCloudWatchLoggingOptionCommandOutput, @@ -38,6 +46,9 @@ export class DeleteApplicationCloudWatchLoggingOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/DeleteApplicationCommand.ts b/clients/client-kinesis-analytics/commands/DeleteApplicationCommand.ts index f629817914ccb..f274799d0b383 100644 --- a/clients/client-kinesis-analytics/commands/DeleteApplicationCommand.ts +++ b/clients/client-kinesis-analytics/commands/DeleteApplicationCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteApplicationCommandInput = DeleteApplicationRequest; export type DeleteApplicationCommandOutput = DeleteApplicationResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Deletes the specified application. Amazon Kinesis Analytics halts application execution and deletes the application, including any application artifacts (such as in-application streams, reference table, and application code).

+ * + *

This operation requires permissions to perform the kinesisanalytics:DeleteApplication action.

+ */ export class DeleteApplicationCommand extends $Command< DeleteApplicationCommandInput, DeleteApplicationCommandOutput, @@ -34,6 +42,9 @@ export class DeleteApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/DeleteApplicationInputProcessingConfigurationCommand.ts b/clients/client-kinesis-analytics/commands/DeleteApplicationInputProcessingConfigurationCommand.ts index 2b969c2ce3197..4da7b1d521ad1 100644 --- a/clients/client-kinesis-analytics/commands/DeleteApplicationInputProcessingConfigurationCommand.ts +++ b/clients/client-kinesis-analytics/commands/DeleteApplicationInputProcessingConfigurationCommand.ts @@ -24,6 +24,12 @@ export type DeleteApplicationInputProcessingConfigurationCommandInput = DeleteAp export type DeleteApplicationInputProcessingConfigurationCommandOutput = DeleteApplicationInputProcessingConfigurationResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Deletes an InputProcessingConfiguration from an input.

+ */ export class DeleteApplicationInputProcessingConfigurationCommand extends $Command< DeleteApplicationInputProcessingConfigurationCommandInput, DeleteApplicationInputProcessingConfigurationCommandOutput, @@ -38,6 +44,9 @@ export class DeleteApplicationInputProcessingConfigurationCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/DeleteApplicationOutputCommand.ts b/clients/client-kinesis-analytics/commands/DeleteApplicationOutputCommand.ts index e84164193be20..02af7eb88502c 100644 --- a/clients/client-kinesis-analytics/commands/DeleteApplicationOutputCommand.ts +++ b/clients/client-kinesis-analytics/commands/DeleteApplicationOutputCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteApplicationOutputCommandInput = DeleteApplicationOutputRequest; export type DeleteApplicationOutputCommandOutput = DeleteApplicationOutputResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Deletes output destination configuration from your application configuration. Amazon Kinesis Analytics will no longer write data from the corresponding in-application stream to the external output destination.

+ *

This operation requires permissions to perform the + * kinesisanalytics:DeleteApplicationOutput action.

+ */ export class DeleteApplicationOutputCommand extends $Command< DeleteApplicationOutputCommandInput, DeleteApplicationOutputCommandOutput, @@ -34,6 +42,9 @@ export class DeleteApplicationOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/DeleteApplicationReferenceDataSourceCommand.ts b/clients/client-kinesis-analytics/commands/DeleteApplicationReferenceDataSourceCommand.ts index 771b203cc093f..b73309b4f02c9 100644 --- a/clients/client-kinesis-analytics/commands/DeleteApplicationReferenceDataSourceCommand.ts +++ b/clients/client-kinesis-analytics/commands/DeleteApplicationReferenceDataSourceCommand.ts @@ -24,6 +24,17 @@ export type DeleteApplicationReferenceDataSourceCommandInput = DeleteApplication export type DeleteApplicationReferenceDataSourceCommandOutput = DeleteApplicationReferenceDataSourceResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Deletes a reference data source configuration from the specified application configuration.

+ *

If the application is running, Amazon Kinesis Analytics immediately removes the in-application table + * that you created using the AddApplicationReferenceDataSource operation.

+ * + *

This operation requires permissions to perform the kinesisanalytics.DeleteApplicationReferenceDataSource + * action.

+ */ export class DeleteApplicationReferenceDataSourceCommand extends $Command< DeleteApplicationReferenceDataSourceCommandInput, DeleteApplicationReferenceDataSourceCommandOutput, @@ -38,6 +49,9 @@ export class DeleteApplicationReferenceDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/DescribeApplicationCommand.ts b/clients/client-kinesis-analytics/commands/DescribeApplicationCommand.ts index 55485101aa31e..d64531aad7226 100644 --- a/clients/client-kinesis-analytics/commands/DescribeApplicationCommand.ts +++ b/clients/client-kinesis-analytics/commands/DescribeApplicationCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeApplicationCommandInput = DescribeApplicationRequest; export type DescribeApplicationCommandOutput = DescribeApplicationResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Returns information about a specific Amazon Kinesis Analytics application.

+ *

If you want to retrieve a list of all applications in your account, + * use the ListApplications operation.

+ *

This operation requires permissions to perform the kinesisanalytics:DescribeApplication + * action. You can use DescribeApplication to get the current application versionId, which you need to call other + * operations such as Update. + *

+ */ export class DescribeApplicationCommand extends $Command< DescribeApplicationCommandInput, DescribeApplicationCommandOutput, @@ -34,6 +46,9 @@ export class DescribeApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/DiscoverInputSchemaCommand.ts b/clients/client-kinesis-analytics/commands/DiscoverInputSchemaCommand.ts index 39f08f9ae9f57..fce5554d775ac 100644 --- a/clients/client-kinesis-analytics/commands/DiscoverInputSchemaCommand.ts +++ b/clients/client-kinesis-analytics/commands/DiscoverInputSchemaCommand.ts @@ -20,6 +20,23 @@ import { export type DiscoverInputSchemaCommandInput = DiscoverInputSchemaRequest; export type DiscoverInputSchemaCommandOutput = DiscoverInputSchemaResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Infers a schema by evaluating sample records on the specified streaming source (Amazon Kinesis stream or Amazon Kinesis Firehose delivery stream) or S3 object. In the response, the operation returns the inferred schema and also the sample records that the operation used to infer the schema.

+ *

+ * You can use the inferred schema when configuring a streaming source + * for your application. For conceptual information, + * see Configuring Application Input. + * Note that when you create an application using the Amazon Kinesis Analytics console, + * the console uses this operation to infer a schema and show it in the console user interface. + *

+ *

+ * This operation requires permissions to perform the + * kinesisanalytics:DiscoverInputSchema action. + *

+ */ export class DiscoverInputSchemaCommand extends $Command< DiscoverInputSchemaCommandInput, DiscoverInputSchemaCommandOutput, @@ -34,6 +51,9 @@ export class DiscoverInputSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/ListApplicationsCommand.ts b/clients/client-kinesis-analytics/commands/ListApplicationsCommand.ts index 35248c57d73ad..91b4ce77ecf06 100644 --- a/clients/client-kinesis-analytics/commands/ListApplicationsCommand.ts +++ b/clients/client-kinesis-analytics/commands/ListApplicationsCommand.ts @@ -20,6 +20,25 @@ import { export type ListApplicationsCommandInput = ListApplicationsRequest; export type ListApplicationsCommandOutput = ListApplicationsResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Returns a list of Amazon Kinesis Analytics applications in your account. + * For each application, the response includes the application name, + * Amazon Resource Name (ARN), and status. + * + * If the response returns the HasMoreApplications value as true, + * you can send another request by adding the + * ExclusiveStartApplicationName in the request body, and + * set the value of this to the last application name from + * the previous response. + *

+ *

If you want detailed information about a specific application, use + * DescribeApplication.

+ *

This operation requires permissions to perform the + * kinesisanalytics:ListApplications action.

+ */ export class ListApplicationsCommand extends $Command< ListApplicationsCommandInput, ListApplicationsCommandOutput, @@ -34,6 +53,9 @@ export class ListApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/ListTagsForResourceCommand.ts b/clients/client-kinesis-analytics/commands/ListTagsForResourceCommand.ts index 75f07008dd4fb..f341bf63ffb09 100644 --- a/clients/client-kinesis-analytics/commands/ListTagsForResourceCommand.ts +++ b/clients/client-kinesis-analytics/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves the list of key-value tags assigned to the application. For more information, see Using Tagging.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/StartApplicationCommand.ts b/clients/client-kinesis-analytics/commands/StartApplicationCommand.ts index d3dcb28369593..9ffe5f73e1f73 100644 --- a/clients/client-kinesis-analytics/commands/StartApplicationCommand.ts +++ b/clients/client-kinesis-analytics/commands/StartApplicationCommand.ts @@ -20,6 +20,20 @@ import { export type StartApplicationCommandInput = StartApplicationRequest; export type StartApplicationCommandOutput = StartApplicationResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Starts the specified Amazon Kinesis Analytics application. After creating an application, you must exclusively call this operation to start your application.

+ *

After the application starts, it begins consuming the input data, processes it, and writes the output to the configured destination.

+ *

+ * The application status must be READY for you to start an application. You can + * get the application status in the console or using the DescribeApplication operation.

+ *

After you start the application, you can stop the application from processing + * the input by calling the StopApplication operation.

+ *

This operation requires permissions to perform the + * kinesisanalytics:StartApplication action.

+ */ export class StartApplicationCommand extends $Command< StartApplicationCommandInput, StartApplicationCommandOutput, @@ -34,6 +48,9 @@ export class StartApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/StopApplicationCommand.ts b/clients/client-kinesis-analytics/commands/StopApplicationCommand.ts index e8f3918d91ce3..3bcb4961a4237 100644 --- a/clients/client-kinesis-analytics/commands/StopApplicationCommand.ts +++ b/clients/client-kinesis-analytics/commands/StopApplicationCommand.ts @@ -20,6 +20,19 @@ import { export type StopApplicationCommandInput = StopApplicationRequest; export type StopApplicationCommandOutput = StopApplicationResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Stops the application from processing input data. You can stop + * an application only if it is in the running state. + * You can use the DescribeApplication operation to find the application state. + * After the application is stopped, + * Amazon Kinesis Analytics stops reading data from the input, the + * application stops processing data, and there is no output written to the destination.

+ *

This operation requires permissions to perform the + * kinesisanalytics:StopApplication action.

+ */ export class StopApplicationCommand extends $Command< StopApplicationCommandInput, StopApplicationCommandOutput, @@ -34,6 +47,9 @@ export class StopApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/TagResourceCommand.ts b/clients/client-kinesis-analytics/commands/TagResourceCommand.ts index edc12a293c0bb..d0014f919f5eb 100644 --- a/clients/client-kinesis-analytics/commands/TagResourceCommand.ts +++ b/clients/client-kinesis-analytics/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds one or more key-value tags to a Kinesis Analytics application. Note that the maximum number of application tags includes system tags. The maximum number of user-defined application tags is 50. + * For more information, see Using Tagging.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/UntagResourceCommand.ts b/clients/client-kinesis-analytics/commands/UntagResourceCommand.ts index 004059d8e47ae..345c9bb58b0ca 100644 --- a/clients/client-kinesis-analytics/commands/UntagResourceCommand.ts +++ b/clients/client-kinesis-analytics/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from a Kinesis Analytics application. For more information, see Using Tagging.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/commands/UpdateApplicationCommand.ts b/clients/client-kinesis-analytics/commands/UpdateApplicationCommand.ts index c96dc4de8cf19..02fb4def86881 100644 --- a/clients/client-kinesis-analytics/commands/UpdateApplicationCommand.ts +++ b/clients/client-kinesis-analytics/commands/UpdateApplicationCommand.ts @@ -20,6 +20,18 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationRequest; export type UpdateApplicationCommandOutput = UpdateApplicationResponse & __MetadataBearer; +/** + * + *

This documentation is for version 1 of the Amazon Kinesis Data Analytics API, which only supports SQL applications. Version 2 of the API supports SQL and Java applications. For more information about version 2, see Amazon Kinesis Data Analytics API V2 Documentation.

+ *
+ *

Updates an existing Amazon Kinesis Analytics application. Using this API, + * you can update application code, input configuration, and + * output configuration.

+ *

Note that Amazon Kinesis Analytics updates the CurrentApplicationVersionId + * each time you update your application.

+ *

This operation requires permission for the + * kinesisanalytics:UpdateApplication action.

+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -34,6 +46,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisAnalyticsClientResolvedConfig, diff --git a/clients/client-kinesis-analytics/package.json b/clients/client-kinesis-analytics/package.json index d68399883fede..569174f7c1f89 100644 --- a/clients/client-kinesis-analytics/package.json +++ b/clients/client-kinesis-analytics/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kinesis Analytics Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kinesis-analytics/runtimeConfig.browser.ts b/clients/client-kinesis-analytics/runtimeConfig.browser.ts index 885551b754eb2..7a45a14fcf62d 100644 --- a/clients/client-kinesis-analytics/runtimeConfig.browser.ts +++ b/clients/client-kinesis-analytics/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KinesisAnalyticsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kinesis-analytics/runtimeConfig.native.ts b/clients/client-kinesis-analytics/runtimeConfig.native.ts index 1f3dfd60a6eb1..0b4967f929ec0 100644 --- a/clients/client-kinesis-analytics/runtimeConfig.native.ts +++ b/clients/client-kinesis-analytics/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KinesisAnalyticsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kinesis-analytics/runtimeConfig.shared.ts b/clients/client-kinesis-analytics/runtimeConfig.shared.ts index 9a905272696fc..afeb32c1ca5af 100644 --- a/clients/client-kinesis-analytics/runtimeConfig.shared.ts +++ b/clients/client-kinesis-analytics/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-08-14", disableHostPrefix: false, diff --git a/clients/client-kinesis-analytics/runtimeConfig.ts b/clients/client-kinesis-analytics/runtimeConfig.ts index 856eded6ae99e..f851dc8599a50 100644 --- a/clients/client-kinesis-analytics/runtimeConfig.ts +++ b/clients/client-kinesis-analytics/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KinesisAnalyticsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kinesis-analytics/tsconfig.json b/clients/client-kinesis-analytics/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kinesis-analytics/tsconfig.json +++ b/clients/client-kinesis-analytics/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kinesis-video-archived-media/commands/GetClipCommand.ts b/clients/client-kinesis-video-archived-media/commands/GetClipCommand.ts index 6ceef641d5454..dda81a7e2727c 100644 --- a/clients/client-kinesis-video-archived-media/commands/GetClipCommand.ts +++ b/clients/client-kinesis-video-archived-media/commands/GetClipCommand.ts @@ -24,6 +24,51 @@ import { export type GetClipCommandInput = GetClipInput; export type GetClipCommandOutput = GetClipOutput & __MetadataBearer; +/** + *

Downloads an MP4 file (clip) containing the archived, on-demand media from the specified video + * stream over the specified time range.

+ *

Both the StreamName and the StreamARN parameters are optional, but you must specify + * either the StreamName or the StreamARN when invoking this API operation.

+ * + *

As a prerequsite to using GetCLip API, you must obtain an endpoint using + * GetDataEndpoint, specifying GET_CLIP for the + * APIName parameter.

+ *

An Amazon Kinesis video stream has the following requirements for providing data + * through MP4:

+ *
    + *
  • + *

    The media must contain h.264 or h.265 encoded video and, optionally, AAC or + * G.711 encoded audio. Specifically, the codec ID of track 1 should be + * V_MPEG/ISO/AVC (for h.264) or V_MPEGH/ISO/HEVC (for H.265). + * Optionally, the codec ID of track 2 should be A_AAC (for AAC) or + * A_MS/ACM (for G.711).

    + *
  • + *
  • + *

    Data retention must be greater than 0.

    + *
  • + *
  • + *

    The video track of each fragment must contain codec private data in the + * Advanced Video Coding (AVC) for H.264 format and HEVC for H.265 format. For more + * information, see MPEG-4 + * specification ISO/IEC 14496-15. For information about adapting + * stream data to a given format, see NAL Adaptation + * Flags.

    + *
  • + *
  • + *

    The audio track (if present) of each fragment must contain codec private data + * in the AAC format (AAC + * specification ISO/IEC 13818-7) or the MS + * Wave format.

    + *
  • + *
+ * + *

You can monitor the amount of outgoing data by monitoring the + * GetClip.OutgoingBytes Amazon CloudWatch metric. For information about + * using CloudWatch to monitor Kinesis Video Streams, see Monitoring + * Kinesis Video Streams. For pricing information, see Amazon Kinesis Video + * Streams Pricing and AWS + * Pricing. Charges for outgoing AWS data apply.

+ */ export class GetClipCommand extends $Command< GetClipCommandInput, GetClipCommandOutput, @@ -38,6 +83,9 @@ export class GetClipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoArchivedMediaClientResolvedConfig, diff --git a/clients/client-kinesis-video-archived-media/commands/GetDASHStreamingSessionURLCommand.ts b/clients/client-kinesis-video-archived-media/commands/GetDASHStreamingSessionURLCommand.ts index 3e0c1174c0ce0..f03b204ae7725 100644 --- a/clients/client-kinesis-video-archived-media/commands/GetDASHStreamingSessionURLCommand.ts +++ b/clients/client-kinesis-video-archived-media/commands/GetDASHStreamingSessionURLCommand.ts @@ -24,6 +24,179 @@ import { export type GetDASHStreamingSessionURLCommandInput = GetDASHStreamingSessionURLInput; export type GetDASHStreamingSessionURLCommandOutput = GetDASHStreamingSessionURLOutput & __MetadataBearer; +/** + *

Retrieves an MPEG Dynamic Adaptive Streaming over HTTP (DASH) URL for the stream. You + * can then open the URL in a media player to view the stream contents.

+ * + *

Both the StreamName and the StreamARN parameters are + * optional, but you must specify either the StreamName or the + * StreamARN when invoking this API operation.

+ *

An Amazon Kinesis video stream has the following requirements for providing data + * through MPEG-DASH:

+ *
    + *
  • + *

    The media must contain h.264 or h.265 encoded video and, optionally, AAC or + * G.711 encoded audio. Specifically, the codec ID of track 1 should be + * V_MPEG/ISO/AVC (for h.264) or V_MPEGH/ISO/HEVC (for H.265). + * Optionally, the codec ID of track 2 should be A_AAC (for AAC) or + * A_MS/ACM (for G.711).

    + *
  • + *
  • + *

    Data retention must be greater than 0.

    + *
  • + *
  • + *

    The video track of each fragment must contain codec private data in the + * Advanced Video Coding (AVC) for H.264 format and HEVC for H.265 format. For more + * information, see MPEG-4 + * specification ISO/IEC 14496-15. For information about adapting + * stream data to a given format, see NAL Adaptation + * Flags.

    + *
  • + *
  • + *

    The audio track (if present) of each fragment must contain codec private data + * in the AAC format (AAC + * specification ISO/IEC 13818-7) or the MS + * Wave format.

    + *
  • + *
+ * + *

The following procedure shows how to use MPEG-DASH with Kinesis Video Streams:

+ *
    + *
  1. + *

    Get an endpoint using GetDataEndpoint, specifying + * GET_DASH_STREAMING_SESSION_URL for the APIName + * parameter.

    + *
  2. + *
  3. + *

    Retrieve the MPEG-DASH URL using GetDASHStreamingSessionURL. + * Kinesis Video Streams creates an MPEG-DASH streaming session to be used for + * accessing content in a stream using the MPEG-DASH protocol. + * GetDASHStreamingSessionURL returns an authenticated URL (that + * includes an encrypted session token) for the session's MPEG-DASH + * manifest (the root resource needed for streaming with + * MPEG-DASH).

    + * + *

    Don't share or store this token where an unauthorized entity could access + * it. The token provides access to the content of the stream. Safeguard the + * token with the same measures that you would use with your AWS + * credentials.

    + *
    + *

    The media that is made available through the manifest consists only of the + * requested stream, time range, and format. No other media data (such as frames + * outside the requested window or alternate bitrates) is made available.

    + *
  4. + *
  5. + *

    Provide the URL (containing the encrypted session token) for the MPEG-DASH + * manifest to a media player that supports the MPEG-DASH protocol. Kinesis Video + * Streams makes the initialization fragment and media fragments available through + * the manifest URL. The initialization fragment contains the codec private data + * for the stream, and other data needed to set up the video or audio decoder and + * renderer. The media fragments contain encoded video frames or encoded audio + * samples.

    + *
  6. + *
  7. + *

    The media player receives the authenticated URL and requests stream metadata + * and media data normally. When the media player requests data, it calls the + * following actions:

    + *
      + *
    • + *

      + * GetDASHManifest: Retrieves an MPEG + * DASH manifest, which contains the metadata for the media that you want + * to playback.

      + *
    • + *
    • + *

      + * GetMP4InitFragment: Retrieves the MP4 + * initialization fragment. The media player typically loads the + * initialization fragment before loading any media fragments. This + * fragment contains the "fytp" and "moov" MP4 + * atoms, and the child atoms that are needed to initialize the media + * player decoder.

      + *

      The initialization fragment does not correspond to a fragment in a + * Kinesis video stream. It contains only the codec private data for the + * stream and respective track, which the media player needs to decode the + * media frames.

      + *
    • + *
    • + *

      + * GetMP4MediaFragment: Retrieves MP4 + * media fragments. These fragments contain the "moof" and + * "mdat" MP4 atoms and their child atoms, containing the + * encoded fragment's media frames and their timestamps.

      + * + *

      After the first media fragment is made available in a streaming + * session, any fragments that don't contain the same codec private + * data cause an error to be returned when those different media + * fragments are loaded. Therefore, the codec private data should not + * change between fragments in a session. This also means that the + * session fails if the fragments in a stream change from having only + * video to having both audio and video.

      + *
      + *

      Data retrieved with this action is billable. See Pricing for details.

      + *
    • + *
    + *
  8. + *
+ * + *

The following restrictions apply to MPEG-DASH sessions:

+ *
    + *
  • + *

    A streaming session URL should not be shared between players. The service + * might throttle a session if multiple media players are sharing it. For + * connection limits, see Kinesis Video + * Streams Limits.

    + *
  • + *
  • + *

    A Kinesis video stream can have a maximum of ten active MPEG-DASH + * streaming sessions. If a new session is created when the maximum number of + * sessions is already active, the oldest (earliest created) session is closed. + * The number of active GetMedia connections on a Kinesis video + * stream does not count against this limit, and the number of active MPEG-DASH + * sessions does not count against the active GetMedia connection + * limit.

    + * + *

    The maximum limits for active HLS and MPEG-DASH streaming sessions are + * independent of each other.

    + *
    + *
  • + *
+ *
+ *

You can monitor the amount of data that the media player consumes by monitoring the + * GetMP4MediaFragment.OutgoingBytes Amazon CloudWatch metric. For + * information about using CloudWatch to monitor Kinesis Video Streams, see Monitoring + * Kinesis Video Streams. For pricing information, see Amazon Kinesis Video + * Streams Pricing and AWS + * Pricing. Charges for both HLS sessions and outgoing AWS data apply.

+ *

For more information about HLS, see HTTP Live Streaming on the + * Apple Developer site.

+ * + * + *

If an error is thrown after invoking a Kinesis Video Streams archived media API, + * in addition to the HTTP status code and the response body, it includes the following + * pieces of information:

+ *
    + *
  • + *

    + * x-amz-ErrorType HTTP header – contains a more specific error + * type in addition to what the HTTP status code provides.

    + *
  • + *
  • + *

    + * x-amz-RequestId HTTP header – if you want to report an issue + * to AWS, the support team can better diagnose the problem if given the + * Request Id.

    + *
  • + *
+ *

Both the HTTP status code and the ErrorType header can be utilized to make + * programmatic decisions about whether errors are retry-able and under what + * conditions, as well as provide information on what actions the client programmer + * might need to take in order to successfully try again.

+ *

For more information, see the Errors section at + * the bottom of this topic, as well as Common Errors. + *

+ *
+ */ export class GetDASHStreamingSessionURLCommand extends $Command< GetDASHStreamingSessionURLCommandInput, GetDASHStreamingSessionURLCommandOutput, @@ -38,6 +211,9 @@ export class GetDASHStreamingSessionURLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoArchivedMediaClientResolvedConfig, diff --git a/clients/client-kinesis-video-archived-media/commands/GetHLSStreamingSessionURLCommand.ts b/clients/client-kinesis-video-archived-media/commands/GetHLSStreamingSessionURLCommand.ts index 37618f9b2fa04..318bcad73b61f 100644 --- a/clients/client-kinesis-video-archived-media/commands/GetHLSStreamingSessionURLCommand.ts +++ b/clients/client-kinesis-video-archived-media/commands/GetHLSStreamingSessionURLCommand.ts @@ -24,6 +24,210 @@ import { export type GetHLSStreamingSessionURLCommandInput = GetHLSStreamingSessionURLInput; export type GetHLSStreamingSessionURLCommandOutput = GetHLSStreamingSessionURLOutput & __MetadataBearer; +/** + *

Retrieves an HTTP Live Streaming (HLS) URL for the stream. You can then open the URL + * in a browser or media player to view the stream contents.

+ *

Both the StreamName and the StreamARN parameters are + * optional, but you must specify either the StreamName or the + * StreamARN when invoking this API operation.

+ *

An Amazon Kinesis video stream has the following requirements for providing data + * through HLS:

+ *
    + *
  • + *

    The media must contain h.264 or h.265 encoded video and, optionally, AAC + * encoded audio. Specifically, the codec ID of track 1 should be + * V_MPEG/ISO/AVC (for h.264) or V_MPEG/ISO/HEVC (for + * h.265). Optionally, the codec ID of track 2 should be A_AAC.

    + *
  • + *
  • + *

    Data retention must be greater than 0.

    + *
  • + *
  • + *

    The video track of each fragment must contain codec private data in the + * Advanced Video Coding (AVC) for H.264 format or HEVC for H.265 format (MPEG-4 specification ISO/IEC + * 14496-15). For information about adapting stream data to a given + * format, see NAL + * Adaptation Flags.

    + *
  • + *
  • + *

    The audio track (if present) of each fragment must contain codec private data + * in the AAC format (AAC + * specification ISO/IEC 13818-7).

    + *
  • + *
+ *

Kinesis Video Streams HLS sessions contain fragments in the fragmented MPEG-4 form + * (also called fMP4 or CMAF) or the MPEG-2 form (also called TS chunks, which the HLS + * specification also supports). For more information about HLS fragment types, see the + * HLS + * specification.

+ *

The following procedure shows how to use HLS with Kinesis Video Streams:

+ *
    + *
  1. + *

    Get an endpoint using GetDataEndpoint, specifying + * GET_HLS_STREAMING_SESSION_URL for the APIName + * parameter.

    + *
  2. + *
  3. + *

    Retrieve the HLS URL using GetHLSStreamingSessionURL. Kinesis + * Video Streams creates an HLS streaming session to be used for accessing content + * in a stream using the HLS protocol. GetHLSStreamingSessionURL + * returns an authenticated URL (that includes an encrypted session token) for the + * session's HLS master playlist (the root resource needed for + * streaming with HLS).

    + * + *

    Don't share or store this token where an unauthorized entity could access + * it. The token provides access to the content of the stream. Safeguard the + * token with the same measures that you would use with your AWS + * credentials.

    + *
    + *

    The media that is made available through the playlist consists only of the + * requested stream, time range, and format. No other media data (such as frames + * outside the requested window or alternate bitrates) is made available.

    + *
  4. + *
  5. + *

    Provide the URL (containing the encrypted session token) for the HLS master + * playlist to a media player that supports the HLS protocol. Kinesis Video Streams + * makes the HLS media playlist, initialization fragment, and media fragments + * available through the master playlist URL. The initialization fragment contains + * the codec private data for the stream, and other data needed to set up the video + * or audio decoder and renderer. The media fragments contain H.264-encoded video + * frames or AAC-encoded audio samples.

    + *
  6. + *
  7. + *

    The media player receives the authenticated URL and requests stream metadata + * and media data normally. When the media player requests data, it calls the + * following actions:

    + *
      + *
    • + *

      + * GetHLSMasterPlaylist: Retrieves an + * HLS master playlist, which contains a URL for the + * GetHLSMediaPlaylist action for each track, and + * additional metadata for the media player, including estimated bitrate + * and resolution.

      + *
    • + *
    • + *

      + * GetHLSMediaPlaylist: Retrieves an HLS + * media playlist, which contains a URL to access the MP4 initialization + * fragment with the GetMP4InitFragment action, and URLs to + * access the MP4 media fragments with the GetMP4MediaFragment + * actions. The HLS media playlist also contains metadata about the stream + * that the player needs to play it, such as whether the + * PlaybackMode is LIVE or + * ON_DEMAND. The HLS media playlist is typically static + * for sessions with a PlaybackType of ON_DEMAND. + * The HLS media playlist is continually updated with new fragments for + * sessions with a PlaybackType of LIVE. There is + * a distinct HLS media playlist for the video track and the audio track + * (if applicable) that contains MP4 media URLs for the specific track. + *

      + *
    • + *
    • + *

      + * GetMP4InitFragment: Retrieves the MP4 + * initialization fragment. The media player typically loads the + * initialization fragment before loading any media fragments. This + * fragment contains the "fytp" and "moov" MP4 + * atoms, and the child atoms that are needed to initialize the media + * player decoder.

      + *

      The initialization fragment does not correspond to a fragment in a + * Kinesis video stream. It contains only the codec private data for the + * stream and respective track, which the media player needs to decode the + * media frames.

      + *
    • + *
    • + *

      + * GetMP4MediaFragment: Retrieves MP4 + * media fragments. These fragments contain the "moof" and + * "mdat" MP4 atoms and their child atoms, containing the + * encoded fragment's media frames and their timestamps.

      + * + *

      After the first media fragment is made available in a streaming + * session, any fragments that don't contain the same codec private + * data cause an error to be returned when those different media + * fragments are loaded. Therefore, the codec private data should not + * change between fragments in a session. This also means that the + * session fails if the fragments in a stream change from having only + * video to having both audio and video.

      + *
      + *

      Data retrieved with this action is billable. See Pricing for details.

      + *
    • + *
    • + *

      + * GetTSFragment: Retrieves MPEG TS + * fragments containing both initialization and media data for all tracks + * in the stream.

      + * + *

      If the ContainerFormat is MPEG_TS, this + * API is used instead of GetMP4InitFragment and + * GetMP4MediaFragment to retrieve stream + * media.

      + *
      + *

      Data retrieved with this action is billable. For more information, see + * Kinesis Video Streams pricing.

      + *
    • + *
    + *
  8. + *
+ * + *

The following restrictions apply to HLS sessions:

+ *
    + *
  • + *

    A streaming session URL should not be shared between players. The service + * might throttle a session if multiple media players are sharing it. For + * connection limits, see Kinesis Video + * Streams Limits.

    + *
  • + *
  • + *

    A Kinesis video stream can have a maximum of ten active HLS streaming + * sessions. If a new session is created when the maximum number of sessions is + * already active, the oldest (earliest created) session is closed. The number + * of active GetMedia connections on a Kinesis video stream does + * not count against this limit, and the number of active HLS sessions does not + * count against the active GetMedia connection limit.

    + * + *

    The maximum limits for active HLS and MPEG-DASH streaming sessions are + * independent of each other.

    + *
    + *
  • + *
+ *
+ *

You can monitor the amount of data that the media player consumes by monitoring the + * GetMP4MediaFragment.OutgoingBytes Amazon CloudWatch metric. For + * information about using CloudWatch to monitor Kinesis Video Streams, see Monitoring + * Kinesis Video Streams. For pricing information, see Amazon Kinesis Video + * Streams Pricing and AWS + * Pricing. Charges for both HLS sessions and outgoing AWS data apply.

+ *

For more information about HLS, see HTTP Live Streaming on the + * Apple Developer site.

+ * + * + *

If an error is thrown after invoking a Kinesis Video Streams archived media API, + * in addition to the HTTP status code and the response body, it includes the following + * pieces of information:

+ *
    + *
  • + *

    + * x-amz-ErrorType HTTP header – contains a more specific error + * type in addition to what the HTTP status code provides.

    + *
  • + *
  • + *

    + * x-amz-RequestId HTTP header – if you want to report an issue + * to AWS, the support team can better diagnose the problem if given the + * Request Id.

    + *
  • + *
+ *

Both the HTTP status code and the ErrorType header can be utilized to make + * programmatic decisions about whether errors are retry-able and under what + * conditions, as well as provide information on what actions the client programmer + * might need to take in order to successfully try again.

+ *

For more information, see the Errors section at + * the bottom of this topic, as well as Common Errors. + *

+ *
+ */ export class GetHLSStreamingSessionURLCommand extends $Command< GetHLSStreamingSessionURLCommandInput, GetHLSStreamingSessionURLCommandOutput, @@ -38,6 +242,9 @@ export class GetHLSStreamingSessionURLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoArchivedMediaClientResolvedConfig, diff --git a/clients/client-kinesis-video-archived-media/commands/GetMediaForFragmentListCommand.ts b/clients/client-kinesis-video-archived-media/commands/GetMediaForFragmentListCommand.ts index 80c344f83c0d9..9511436b6622f 100644 --- a/clients/client-kinesis-video-archived-media/commands/GetMediaForFragmentListCommand.ts +++ b/clients/client-kinesis-video-archived-media/commands/GetMediaForFragmentListCommand.ts @@ -24,6 +24,57 @@ import { export type GetMediaForFragmentListCommandInput = GetMediaForFragmentListInput; export type GetMediaForFragmentListCommandOutput = GetMediaForFragmentListOutput & __MetadataBearer; +/** + *

Gets media for a list of fragments (specified by fragment number) from the archived + * data in an Amazon Kinesis video stream.

+ * + * + *

You must first call the GetDataEndpoint API to get an endpoint. + * Then send the GetMediaForFragmentList requests to this endpoint using + * the --endpoint-url + * parameter.

+ *
+ * + *

The following limits apply when using the GetMediaForFragmentList + * API:

+ *
    + *
  • + *

    A client can call GetMediaForFragmentList up to five times per + * second per stream.

    + *
  • + *
  • + *

    Kinesis Video Streams sends media data at a rate of up to 25 megabytes per + * second (or 200 megabits per second) during a + * GetMediaForFragmentList session.

    + *
  • + *
+ * + * + *

If an error is thrown after invoking a Kinesis Video Streams archived media API, + * in addition to the HTTP status code and the response body, it includes the following + * pieces of information:

+ *
    + *
  • + *

    + * x-amz-ErrorType HTTP header – contains a more specific error + * type in addition to what the HTTP status code provides.

    + *
  • + *
  • + *

    + * x-amz-RequestId HTTP header – if you want to report an issue + * to AWS, the support team can better diagnose the problem if given the + * Request Id.

    + *
  • + *
+ *

Both the HTTP status code and the ErrorType header can be utilized to make + * programmatic decisions about whether errors are retry-able and under what + * conditions, as well as provide information on what actions the client programmer + * might need to take in order to successfully try again.

+ *

For more information, see the Errors section at + * the bottom of this topic, as well as Common Errors. + *

+ *
+ */ export class GetMediaForFragmentListCommand extends $Command< GetMediaForFragmentListCommandInput, GetMediaForFragmentListCommandOutput, @@ -38,6 +89,9 @@ export class GetMediaForFragmentListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoArchivedMediaClientResolvedConfig, diff --git a/clients/client-kinesis-video-archived-media/commands/ListFragmentsCommand.ts b/clients/client-kinesis-video-archived-media/commands/ListFragmentsCommand.ts index 481718e565992..6a3c28f1552a7 100644 --- a/clients/client-kinesis-video-archived-media/commands/ListFragmentsCommand.ts +++ b/clients/client-kinesis-video-archived-media/commands/ListFragmentsCommand.ts @@ -24,6 +24,45 @@ import { export type ListFragmentsCommandInput = ListFragmentsInput; export type ListFragmentsCommandOutput = ListFragmentsOutput & __MetadataBearer; +/** + *

Returns a list of Fragment objects from the specified stream and + * timestamp range within the archived data.

+ *

Listing fragments is eventually consistent. This means that even if the producer + * receives an acknowledgment that a fragment is persisted, the result might not be + * returned immediately from a request to ListFragments. However, results are + * typically available in less than one second.

+ * + *

You must first call the GetDataEndpoint API to get an endpoint. + * Then send the ListFragments requests to this endpoint using the --endpoint-url + * parameter.

+ *
+ * + * + *

If an error is thrown after invoking a Kinesis Video Streams archived media API, + * in addition to the HTTP status code and the response body, it includes the following + * pieces of information:

+ *
    + *
  • + *

    + * x-amz-ErrorType HTTP header – contains a more specific error + * type in addition to what the HTTP status code provides.

    + *
  • + *
  • + *

    + * x-amz-RequestId HTTP header – if you want to report an issue + * to AWS, the support team can better diagnose the problem if given the + * Request Id.

    + *
  • + *
+ *

Both the HTTP status code and the ErrorType header can be utilized to make + * programmatic decisions about whether errors are retry-able and under what + * conditions, as well as provide information on what actions the client programmer + * might need to take in order to successfully try again.

+ *

For more information, see the Errors section at + * the bottom of this topic, as well as Common Errors. + *

+ *
+ */ export class ListFragmentsCommand extends $Command< ListFragmentsCommandInput, ListFragmentsCommandOutput, @@ -38,6 +77,9 @@ export class ListFragmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoArchivedMediaClientResolvedConfig, diff --git a/clients/client-kinesis-video-archived-media/package.json b/clients/client-kinesis-video-archived-media/package.json index 0b3faa34f23f9..c44aabcdce185 100644 --- a/clients/client-kinesis-video-archived-media/package.json +++ b/clients/client-kinesis-video-archived-media/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kinesis Video Archived Media Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kinesis-video-archived-media/runtimeConfig.browser.ts b/clients/client-kinesis-video-archived-media/runtimeConfig.browser.ts index 9a6756fb30732..6ac5ac02ffdfb 100644 --- a/clients/client-kinesis-video-archived-media/runtimeConfig.browser.ts +++ b/clients/client-kinesis-video-archived-media/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KinesisVideoArchivedMediaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kinesis-video-archived-media/runtimeConfig.native.ts b/clients/client-kinesis-video-archived-media/runtimeConfig.native.ts index 24375dce3bc6a..35aab72b2651e 100644 --- a/clients/client-kinesis-video-archived-media/runtimeConfig.native.ts +++ b/clients/client-kinesis-video-archived-media/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KinesisVideoArchivedMediaClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kinesis-video-archived-media/runtimeConfig.shared.ts b/clients/client-kinesis-video-archived-media/runtimeConfig.shared.ts index 4c1a3d28c2dbc..eed5699ec9bee 100644 --- a/clients/client-kinesis-video-archived-media/runtimeConfig.shared.ts +++ b/clients/client-kinesis-video-archived-media/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-09-30", disableHostPrefix: false, diff --git a/clients/client-kinesis-video-archived-media/runtimeConfig.ts b/clients/client-kinesis-video-archived-media/runtimeConfig.ts index db7a20d06fd50..e04c61531cd7c 100644 --- a/clients/client-kinesis-video-archived-media/runtimeConfig.ts +++ b/clients/client-kinesis-video-archived-media/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KinesisVideoArchivedMediaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kinesis-video-archived-media/tsconfig.json b/clients/client-kinesis-video-archived-media/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kinesis-video-archived-media/tsconfig.json +++ b/clients/client-kinesis-video-archived-media/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kinesis-video-media/commands/GetMediaCommand.ts b/clients/client-kinesis-video-media/commands/GetMediaCommand.ts index 55acef491efc2..e68cbf76dca71 100644 --- a/clients/client-kinesis-video-media/commands/GetMediaCommand.ts +++ b/clients/client-kinesis-video-media/commands/GetMediaCommand.ts @@ -24,6 +24,54 @@ import { export type GetMediaCommandInput = GetMediaInput; export type GetMediaCommandOutput = GetMediaOutput & __MetadataBearer; +/** + *

Use this API to retrieve media content from a Kinesis video stream. In the request, + * you identify the stream name or stream Amazon Resource Name (ARN), and the starting chunk. + * Kinesis Video Streams then returns a stream of chunks in order by fragment number.

+ * + *

You must first call the GetDataEndpoint API to get an endpoint. Then + * send the GetMedia requests to this endpoint using the --endpoint-url parameter. + *

+ *
+ *

When you put media data (fragments) on a stream, Kinesis Video Streams stores each + * incoming fragment and related metadata in what is called a "chunk." For more information, see + * PutMedia. The GetMedia API returns a stream of these chunks starting + * from the chunk that you specify in the request.

+ *

The following limits apply when using the GetMedia API:

+ *
    + *
  • + *

    A client can call GetMedia up to five times per second per stream. + *

    + *
  • + *
  • + *

    Kinesis Video Streams sends media data at a rate of up to 25 megabytes per second + * (or 200 megabits per second) during a GetMedia session.

    + *
  • + *
+ * + * + *

If an error is thrown after invoking a Kinesis Video Streams media API, in addition to + * the HTTP status code and the response body, it includes the following pieces of information:

+ *
    + *
  • + *

    + * x-amz-ErrorType HTTP header – contains a more specific error type in + * addition to what the HTTP status code provides.

    + *
  • + *
  • + *

    + * x-amz-RequestId HTTP header – if you want to report an issue to AWS, + * the support team can better diagnose the problem if given the Request Id.

    + *
  • + *
+ *

Both the HTTP status code and the ErrorType header can be utilized to make programmatic + * decisions about whether errors are retry-able and under what conditions, as well as provide + * information on what actions the client programmer might need to take in order to + * successfully try again.

+ *

For more information, see the Errors section at the + * bottom of this topic, as well as Common Errors.

+ *
+ */ export class GetMediaCommand extends $Command< GetMediaCommandInput, GetMediaCommandOutput, @@ -38,6 +86,9 @@ export class GetMediaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoMediaClientResolvedConfig, diff --git a/clients/client-kinesis-video-media/package.json b/clients/client-kinesis-video-media/package.json index 1e36a88d3db3f..27a39ed9b1f72 100644 --- a/clients/client-kinesis-video-media/package.json +++ b/clients/client-kinesis-video-media/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kinesis Video Media Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kinesis-video-media/runtimeConfig.browser.ts b/clients/client-kinesis-video-media/runtimeConfig.browser.ts index 849bc4135abd4..ff05b45309ce8 100644 --- a/clients/client-kinesis-video-media/runtimeConfig.browser.ts +++ b/clients/client-kinesis-video-media/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KinesisVideoMediaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kinesis-video-media/runtimeConfig.native.ts b/clients/client-kinesis-video-media/runtimeConfig.native.ts index 376010b65c0e1..6d03ff5513a6d 100644 --- a/clients/client-kinesis-video-media/runtimeConfig.native.ts +++ b/clients/client-kinesis-video-media/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KinesisVideoMediaClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kinesis-video-media/runtimeConfig.shared.ts b/clients/client-kinesis-video-media/runtimeConfig.shared.ts index 4c1a3d28c2dbc..eed5699ec9bee 100644 --- a/clients/client-kinesis-video-media/runtimeConfig.shared.ts +++ b/clients/client-kinesis-video-media/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-09-30", disableHostPrefix: false, diff --git a/clients/client-kinesis-video-media/runtimeConfig.ts b/clients/client-kinesis-video-media/runtimeConfig.ts index f9cef1383cb94..7c6e92295fae1 100644 --- a/clients/client-kinesis-video-media/runtimeConfig.ts +++ b/clients/client-kinesis-video-media/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KinesisVideoMediaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kinesis-video-media/tsconfig.json b/clients/client-kinesis-video-media/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kinesis-video-media/tsconfig.json +++ b/clients/client-kinesis-video-media/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kinesis-video-signaling/commands/GetIceServerConfigCommand.ts b/clients/client-kinesis-video-signaling/commands/GetIceServerConfigCommand.ts index 3f46e4366a1c7..acc06724d5e9e 100644 --- a/clients/client-kinesis-video-signaling/commands/GetIceServerConfigCommand.ts +++ b/clients/client-kinesis-video-signaling/commands/GetIceServerConfigCommand.ts @@ -24,6 +24,22 @@ import { export type GetIceServerConfigCommandInput = GetIceServerConfigRequest; export type GetIceServerConfigCommandOutput = GetIceServerConfigResponse & __MetadataBearer; +/** + *

Gets the Interactive Connectivity Establishment (ICE) server configuration + * information, including URIs, username, and password which can be used to configure the + * WebRTC connection. The ICE component uses this configuration information to setup the + * WebRTC connection, including authenticating with the Traversal Using Relays around NAT + * (TURN) relay server.

+ *

TURN is a protocol that is used to improve the connectivity of peer-to-peer + * applications. By providing a cloud-based relay service, TURN ensures that a connection + * can be established even when one or more peers are incapable of a direct peer-to-peer + * connection. For more information, see A REST API For + * Access To TURN Services.

+ *

You can invoke this API to establish a fallback mechanism in case either of the peers + * is unable to establish a direct peer-to-peer connection over a signaling channel. You + * must specify either a signaling channel ARN or the client ID in order to invoke this + * API.

+ */ export class GetIceServerConfigCommand extends $Command< GetIceServerConfigCommandInput, GetIceServerConfigCommandOutput, @@ -38,6 +54,9 @@ export class GetIceServerConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoSignalingClientResolvedConfig, diff --git a/clients/client-kinesis-video-signaling/commands/SendAlexaOfferToMasterCommand.ts b/clients/client-kinesis-video-signaling/commands/SendAlexaOfferToMasterCommand.ts index b351d46e33edb..56561f7a3f0bd 100644 --- a/clients/client-kinesis-video-signaling/commands/SendAlexaOfferToMasterCommand.ts +++ b/clients/client-kinesis-video-signaling/commands/SendAlexaOfferToMasterCommand.ts @@ -24,6 +24,14 @@ import { export type SendAlexaOfferToMasterCommandInput = SendAlexaOfferToMasterRequest; export type SendAlexaOfferToMasterCommandOutput = SendAlexaOfferToMasterResponse & __MetadataBearer; +/** + *

This API allows you to connect WebRTC-enabled devices with Alexa display devices. When + * invoked, it sends the Alexa Session Description Protocol (SDP) offer to the master peer. + * The offer is delivered as soon as the master is connected to the specified signaling + * channel. This API returns the SDP answer from the connected master. If the master is not + * connected to the signaling channel, redelivery requests are made until the message + * expires.

+ */ export class SendAlexaOfferToMasterCommand extends $Command< SendAlexaOfferToMasterCommandInput, SendAlexaOfferToMasterCommandOutput, @@ -38,6 +46,9 @@ export class SendAlexaOfferToMasterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoSignalingClientResolvedConfig, diff --git a/clients/client-kinesis-video-signaling/package.json b/clients/client-kinesis-video-signaling/package.json index 6f018fbf65e62..118d2cc6577b5 100644 --- a/clients/client-kinesis-video-signaling/package.json +++ b/clients/client-kinesis-video-signaling/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kinesis Video Signaling Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kinesis-video-signaling/runtimeConfig.browser.ts b/clients/client-kinesis-video-signaling/runtimeConfig.browser.ts index fe097b8558a98..4e9225ba79bfa 100644 --- a/clients/client-kinesis-video-signaling/runtimeConfig.browser.ts +++ b/clients/client-kinesis-video-signaling/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KinesisVideoSignalingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kinesis-video-signaling/runtimeConfig.native.ts b/clients/client-kinesis-video-signaling/runtimeConfig.native.ts index 39f85c8dbcf1f..937f52f01ab19 100644 --- a/clients/client-kinesis-video-signaling/runtimeConfig.native.ts +++ b/clients/client-kinesis-video-signaling/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KinesisVideoSignalingClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kinesis-video-signaling/runtimeConfig.shared.ts b/clients/client-kinesis-video-signaling/runtimeConfig.shared.ts index 127c1ef437224..463ee380000a1 100644 --- a/clients/client-kinesis-video-signaling/runtimeConfig.shared.ts +++ b/clients/client-kinesis-video-signaling/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-04", disableHostPrefix: false, diff --git a/clients/client-kinesis-video-signaling/runtimeConfig.ts b/clients/client-kinesis-video-signaling/runtimeConfig.ts index 0fc1c24207296..1e2930df1e8cb 100644 --- a/clients/client-kinesis-video-signaling/runtimeConfig.ts +++ b/clients/client-kinesis-video-signaling/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KinesisVideoSignalingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kinesis-video-signaling/tsconfig.json b/clients/client-kinesis-video-signaling/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kinesis-video-signaling/tsconfig.json +++ b/clients/client-kinesis-video-signaling/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kinesis-video/commands/CreateSignalingChannelCommand.ts b/clients/client-kinesis-video/commands/CreateSignalingChannelCommand.ts index 11d8959005992..4b549216a1718 100644 --- a/clients/client-kinesis-video/commands/CreateSignalingChannelCommand.ts +++ b/clients/client-kinesis-video/commands/CreateSignalingChannelCommand.ts @@ -20,6 +20,11 @@ import { export type CreateSignalingChannelCommandInput = CreateSignalingChannelInput; export type CreateSignalingChannelCommandOutput = CreateSignalingChannelOutput & __MetadataBearer; +/** + *

Creates a signaling channel.

+ *

+ * CreateSignalingChannel is an asynchronous operation.

+ */ export class CreateSignalingChannelCommand extends $Command< CreateSignalingChannelCommandInput, CreateSignalingChannelCommandOutput, @@ -34,6 +39,9 @@ export class CreateSignalingChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/CreateStreamCommand.ts b/clients/client-kinesis-video/commands/CreateStreamCommand.ts index 76538cbdda3c4..96f87e46f771b 100644 --- a/clients/client-kinesis-video/commands/CreateStreamCommand.ts +++ b/clients/client-kinesis-video/commands/CreateStreamCommand.ts @@ -20,6 +20,17 @@ import { export type CreateStreamCommandInput = CreateStreamInput; export type CreateStreamCommandOutput = CreateStreamOutput & __MetadataBearer; +/** + *

Creates a new Kinesis video stream.

+ * + *

When you create a new stream, Kinesis Video Streams assigns it a version number. + * When you change the stream's metadata, Kinesis Video Streams updates the version.

+ *

+ * CreateStream is an asynchronous operation.

+ *

For information about how the service works, see How it Works.

+ *

You must have permissions for the KinesisVideo:CreateStream + * action.

+ */ export class CreateStreamCommand extends $Command< CreateStreamCommandInput, CreateStreamCommandOutput, @@ -34,6 +45,9 @@ export class CreateStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/DeleteSignalingChannelCommand.ts b/clients/client-kinesis-video/commands/DeleteSignalingChannelCommand.ts index afd546602d6cd..28a267a9f5a14 100644 --- a/clients/client-kinesis-video/commands/DeleteSignalingChannelCommand.ts +++ b/clients/client-kinesis-video/commands/DeleteSignalingChannelCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteSignalingChannelCommandInput = DeleteSignalingChannelInput; export type DeleteSignalingChannelCommandOutput = DeleteSignalingChannelOutput & __MetadataBearer; +/** + *

Deletes a specified signaling channel. DeleteSignalingChannel is an + * asynchronous operation. If you don't specify the channel's current version, the most + * recent version is deleted.

+ */ export class DeleteSignalingChannelCommand extends $Command< DeleteSignalingChannelCommandInput, DeleteSignalingChannelCommandOutput, @@ -34,6 +39,9 @@ export class DeleteSignalingChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/DeleteStreamCommand.ts b/clients/client-kinesis-video/commands/DeleteStreamCommand.ts index 73e3abc45f4ca..16b051ec3b8a6 100644 --- a/clients/client-kinesis-video/commands/DeleteStreamCommand.ts +++ b/clients/client-kinesis-video/commands/DeleteStreamCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteStreamCommandInput = DeleteStreamInput; export type DeleteStreamCommandOutput = DeleteStreamOutput & __MetadataBearer; +/** + *

Deletes a Kinesis video stream and the data contained in the stream.

+ *

This method marks the stream for deletion, and makes the data in the stream + * inaccessible immediately.

+ *

+ *

To ensure that you have the latest version of the stream before deleting it, you + * can specify the stream version. Kinesis Video Streams assigns a version to each stream. + * When you update a stream, Kinesis Video Streams assigns a new version number. To get the + * latest stream version, use the DescribeStream API.

+ *

This operation requires permission for the KinesisVideo:DeleteStream + * action.

+ */ export class DeleteStreamCommand extends $Command< DeleteStreamCommandInput, DeleteStreamCommandOutput, @@ -34,6 +46,9 @@ export class DeleteStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/DescribeSignalingChannelCommand.ts b/clients/client-kinesis-video/commands/DescribeSignalingChannelCommand.ts index 0e081f93a643c..a9de6251b5c39 100644 --- a/clients/client-kinesis-video/commands/DescribeSignalingChannelCommand.ts +++ b/clients/client-kinesis-video/commands/DescribeSignalingChannelCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeSignalingChannelCommandInput = DescribeSignalingChannelInput; export type DescribeSignalingChannelCommandOutput = DescribeSignalingChannelOutput & __MetadataBearer; +/** + *

Returns the most current information about the signaling channel. You must specify + * either the name or the Amazon Resource Name (ARN) of the channel that you want to + * describe.

+ */ export class DescribeSignalingChannelCommand extends $Command< DescribeSignalingChannelCommandInput, DescribeSignalingChannelCommandOutput, @@ -34,6 +39,9 @@ export class DescribeSignalingChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/DescribeStreamCommand.ts b/clients/client-kinesis-video/commands/DescribeStreamCommand.ts index 249e51ff53850..b7c9239a3a0bb 100644 --- a/clients/client-kinesis-video/commands/DescribeStreamCommand.ts +++ b/clients/client-kinesis-video/commands/DescribeStreamCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeStreamCommandInput = DescribeStreamInput; export type DescribeStreamCommandOutput = DescribeStreamOutput & __MetadataBearer; +/** + *

Returns the most current information about the specified stream. You must specify + * either the StreamName or the StreamARN.

+ */ export class DescribeStreamCommand extends $Command< DescribeStreamCommandInput, DescribeStreamCommandOutput, @@ -34,6 +38,9 @@ export class DescribeStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/GetDataEndpointCommand.ts b/clients/client-kinesis-video/commands/GetDataEndpointCommand.ts index 029831017ca29..b14063fac6a01 100644 --- a/clients/client-kinesis-video/commands/GetDataEndpointCommand.ts +++ b/clients/client-kinesis-video/commands/GetDataEndpointCommand.ts @@ -20,6 +20,20 @@ import { export type GetDataEndpointCommandInput = GetDataEndpointInput; export type GetDataEndpointCommandOutput = GetDataEndpointOutput & __MetadataBearer; +/** + *

Gets an endpoint for a specified stream for either reading or writing. Use this + * endpoint in your application to read from the specified stream (using the + * GetMedia or GetMediaForFragmentList operations) or write + * to it (using the PutMedia operation). + *

+ * + *

The returned endpoint does not have the API name appended. The client needs to + * add the API name to the returned endpoint.

+ *
+ * + *

In the request, specify the stream either by StreamName or + * StreamARN.

+ */ export class GetDataEndpointCommand extends $Command< GetDataEndpointCommandInput, GetDataEndpointCommandOutput, @@ -34,6 +48,9 @@ export class GetDataEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/GetSignalingChannelEndpointCommand.ts b/clients/client-kinesis-video/commands/GetSignalingChannelEndpointCommand.ts index 9ec543fec439f..44044c4c3532f 100644 --- a/clients/client-kinesis-video/commands/GetSignalingChannelEndpointCommand.ts +++ b/clients/client-kinesis-video/commands/GetSignalingChannelEndpointCommand.ts @@ -20,6 +20,22 @@ import { export type GetSignalingChannelEndpointCommandInput = GetSignalingChannelEndpointInput; export type GetSignalingChannelEndpointCommandOutput = GetSignalingChannelEndpointOutput & __MetadataBearer; +/** + *

Provides an endpoint for the specified signaling channel to send and receive messages. + * This API uses the SingleMasterChannelEndpointConfiguration input parameter, + * which consists of the Protocols and Role properties.

+ *

+ * Protocols is used to determine the communication mechanism. For example, + * if you specify WSS as the protocol, this API produces a secure websocket + * endpoint. If you specify HTTPS as the protocol, this API generates an HTTPS + * endpoint.

+ *

+ * Role determines the messaging permissions. A MASTER role + * results in this API generating an endpoint that a client can use to communicate with any + * of the viewers on the channel. A VIEWER role results in this API generating + * an endpoint that a client can use to communicate only with a + * MASTER.

+ */ export class GetSignalingChannelEndpointCommand extends $Command< GetSignalingChannelEndpointCommandInput, GetSignalingChannelEndpointCommandOutput, @@ -34,6 +50,9 @@ export class GetSignalingChannelEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/ListSignalingChannelsCommand.ts b/clients/client-kinesis-video/commands/ListSignalingChannelsCommand.ts index 7a5532512d034..e6c6908a8945d 100644 --- a/clients/client-kinesis-video/commands/ListSignalingChannelsCommand.ts +++ b/clients/client-kinesis-video/commands/ListSignalingChannelsCommand.ts @@ -20,6 +20,11 @@ import { export type ListSignalingChannelsCommandInput = ListSignalingChannelsInput; export type ListSignalingChannelsCommandOutput = ListSignalingChannelsOutput & __MetadataBearer; +/** + *

Returns an array of ChannelInfo objects. Each object describes a + * signaling channel. To retrieve only those channels that satisfy a specific condition, you can + * specify a ChannelNameCondition.

+ */ export class ListSignalingChannelsCommand extends $Command< ListSignalingChannelsCommandInput, ListSignalingChannelsCommandOutput, @@ -34,6 +39,9 @@ export class ListSignalingChannelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/ListStreamsCommand.ts b/clients/client-kinesis-video/commands/ListStreamsCommand.ts index 775d1df178a0b..a5ed5cda16fb4 100644 --- a/clients/client-kinesis-video/commands/ListStreamsCommand.ts +++ b/clients/client-kinesis-video/commands/ListStreamsCommand.ts @@ -20,6 +20,11 @@ import { export type ListStreamsCommandInput = ListStreamsInput; export type ListStreamsCommandOutput = ListStreamsOutput & __MetadataBearer; +/** + *

Returns an array of StreamInfo objects. Each object describes a + * stream. To retrieve only streams that satisfy a specific condition, you can specify a + * StreamNameCondition.

+ */ export class ListStreamsCommand extends $Command< ListStreamsCommandInput, ListStreamsCommandOutput, @@ -34,6 +39,9 @@ export class ListStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/ListTagsForResourceCommand.ts b/clients/client-kinesis-video/commands/ListTagsForResourceCommand.ts index ccc622abb5722..94df0b3a24555 100644 --- a/clients/client-kinesis-video/commands/ListTagsForResourceCommand.ts +++ b/clients/client-kinesis-video/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Returns a list of tags associated with the specified signaling channel.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/ListTagsForStreamCommand.ts b/clients/client-kinesis-video/commands/ListTagsForStreamCommand.ts index df4815917370f..25556d1fe0cf8 100644 --- a/clients/client-kinesis-video/commands/ListTagsForStreamCommand.ts +++ b/clients/client-kinesis-video/commands/ListTagsForStreamCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForStreamCommandInput = ListTagsForStreamInput; export type ListTagsForStreamCommandOutput = ListTagsForStreamOutput & __MetadataBearer; +/** + *

Returns a list of tags associated with the specified stream.

+ *

In the request, you must specify either the StreamName or the + * StreamARN.

+ */ export class ListTagsForStreamCommand extends $Command< ListTagsForStreamCommandInput, ListTagsForStreamCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/TagResourceCommand.ts b/clients/client-kinesis-video/commands/TagResourceCommand.ts index 261bcf5884c3f..e57b1d3fac36e 100644 --- a/clients/client-kinesis-video/commands/TagResourceCommand.ts +++ b/clients/client-kinesis-video/commands/TagResourceCommand.ts @@ -20,6 +20,14 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

Adds one or more tags to a signaling channel. A tag is a + * key-value pair (the value is optional) that you can define and assign to AWS resources. + * If you specify a tag that already exists, the tag value is replaced with the value that + * you specify in the request. For more information, see Using Cost Allocation + * Tags in the AWS Billing and Cost Management User + * Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +42,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/TagStreamCommand.ts b/clients/client-kinesis-video/commands/TagStreamCommand.ts index c5268caf8aec8..2d1adf2192710 100644 --- a/clients/client-kinesis-video/commands/TagStreamCommand.ts +++ b/clients/client-kinesis-video/commands/TagStreamCommand.ts @@ -20,6 +20,18 @@ import { export type TagStreamCommandInput = TagStreamInput; export type TagStreamCommandOutput = TagStreamOutput & __MetadataBearer; +/** + *

Adds one or more tags to a stream. A tag is a key-value pair + * (the value is optional) that you can define and assign to AWS resources. If you specify + * a tag that already exists, the tag value is replaced with the value that you specify in + * the request. For more information, see Using Cost Allocation + * Tags in the AWS Billing and Cost Management User Guide.

+ *

You must provide either the StreamName or the + * StreamARN.

+ *

This operation requires permission for the KinesisVideo:TagStream + * action.

+ *

Kinesis video streams support up to 50 tags.

+ */ export class TagStreamCommand extends $Command< TagStreamCommandInput, TagStreamCommandOutput, @@ -34,6 +46,9 @@ export class TagStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/UntagResourceCommand.ts b/clients/client-kinesis-video/commands/UntagResourceCommand.ts index ec6806131001c..f2dba0d3f075b 100644 --- a/clients/client-kinesis-video/commands/UntagResourceCommand.ts +++ b/clients/client-kinesis-video/commands/UntagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Removes one or more tags from a signaling channel. In the request, specify only a tag + * key or keys; don't specify the value. If you specify a tag key that does not exist, it's + * ignored.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/UntagStreamCommand.ts b/clients/client-kinesis-video/commands/UntagStreamCommand.ts index 3c826a83ae828..04fbda1a7f0a0 100644 --- a/clients/client-kinesis-video/commands/UntagStreamCommand.ts +++ b/clients/client-kinesis-video/commands/UntagStreamCommand.ts @@ -20,6 +20,13 @@ import { export type UntagStreamCommandInput = UntagStreamInput; export type UntagStreamCommandOutput = UntagStreamOutput & __MetadataBearer; +/** + *

Removes one or more tags from a stream. In the request, specify only a tag key or + * keys; don't specify the value. If you specify a tag key that does not exist, it's + * ignored.

+ *

In the request, you must provide the StreamName or + * StreamARN.

+ */ export class UntagStreamCommand extends $Command< UntagStreamCommandInput, UntagStreamCommandOutput, @@ -34,6 +41,9 @@ export class UntagStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/UpdateDataRetentionCommand.ts b/clients/client-kinesis-video/commands/UpdateDataRetentionCommand.ts index ca1922d2f90eb..d9038ffe373a0 100644 --- a/clients/client-kinesis-video/commands/UpdateDataRetentionCommand.ts +++ b/clients/client-kinesis-video/commands/UpdateDataRetentionCommand.ts @@ -20,6 +20,35 @@ import { export type UpdateDataRetentionCommandInput = UpdateDataRetentionInput; export type UpdateDataRetentionCommandOutput = UpdateDataRetentionOutput & __MetadataBearer; +/** + *

Increases or decreases the stream's data retention period by the value that you + * specify. To indicate whether you want to increase or decrease the data retention period, + * specify the Operation parameter in the request body. In the request, you + * must specify either the StreamName or the StreamARN.

+ * + *

The retention period that you specify replaces the current value.

+ *
+ * + *

This operation requires permission for the + * KinesisVideo:UpdateDataRetention action.

+ * + *

Changing the data retention period affects the data in the stream as + * follows:

+ *
    + *
  • + *

    If the data retention period is increased, existing data is retained for + * the new retention period. For example, if the data retention period is increased + * from one hour to seven hours, all existing data is retained for seven + * hours.

    + *
  • + *
  • + *

    If the data retention period is decreased, existing data is retained for + * the new retention period. For example, if the data retention period is decreased + * from seven hours to one hour, all existing data is retained for one hour, and + * any data older than one hour is deleted immediately.

    + *
  • + *
+ */ export class UpdateDataRetentionCommand extends $Command< UpdateDataRetentionCommandInput, UpdateDataRetentionCommandOutput, @@ -34,6 +63,9 @@ export class UpdateDataRetentionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/UpdateSignalingChannelCommand.ts b/clients/client-kinesis-video/commands/UpdateSignalingChannelCommand.ts index d5da113464979..a2bfcb64c2625 100644 --- a/clients/client-kinesis-video/commands/UpdateSignalingChannelCommand.ts +++ b/clients/client-kinesis-video/commands/UpdateSignalingChannelCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateSignalingChannelCommandInput = UpdateSignalingChannelInput; export type UpdateSignalingChannelCommandOutput = UpdateSignalingChannelOutput & __MetadataBearer; +/** + *

Updates the existing signaling channel. This is an asynchronous operation and takes + * time to complete.

+ *

If the MessageTtlSeconds value is updated (either increased or reduced), + * it only applies to new messages sent via this channel after it's been updated. Existing + * messages are still expired as per the previous MessageTtlSeconds + * value.

+ */ export class UpdateSignalingChannelCommand extends $Command< UpdateSignalingChannelCommandInput, UpdateSignalingChannelCommandOutput, @@ -34,6 +42,9 @@ export class UpdateSignalingChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/commands/UpdateStreamCommand.ts b/clients/client-kinesis-video/commands/UpdateStreamCommand.ts index 6748b2196fa6c..a0cbe8d839662 100644 --- a/clients/client-kinesis-video/commands/UpdateStreamCommand.ts +++ b/clients/client-kinesis-video/commands/UpdateStreamCommand.ts @@ -20,6 +20,18 @@ import { export type UpdateStreamCommandInput = UpdateStreamInput; export type UpdateStreamCommandOutput = UpdateStreamOutput & __MetadataBearer; +/** + *

Updates stream metadata, such as the device name and media type.

+ *

You must provide the stream name or the Amazon Resource Name (ARN) of the + * stream.

+ *

To make sure that you have the latest version of the stream before updating it, you + * can specify the stream version. Kinesis Video Streams assigns a version to each stream. + * When you update a stream, Kinesis Video Streams assigns a new version number. To get the + * latest stream version, use the DescribeStream API.

+ *

+ * UpdateStream is an asynchronous operation, and takes time to + * complete.

+ */ export class UpdateStreamCommand extends $Command< UpdateStreamCommandInput, UpdateStreamCommandOutput, @@ -34,6 +46,9 @@ export class UpdateStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisVideoClientResolvedConfig, diff --git a/clients/client-kinesis-video/package.json b/clients/client-kinesis-video/package.json index 68309e4b54383..eaaa8adf1f856 100644 --- a/clients/client-kinesis-video/package.json +++ b/clients/client-kinesis-video/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kinesis Video Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kinesis-video/pagination/ListSignalingChannelsPaginator.ts b/clients/client-kinesis-video/pagination/ListSignalingChannelsPaginator.ts index 696fb272af349..6353a88e6e2ab 100644 --- a/clients/client-kinesis-video/pagination/ListSignalingChannelsPaginator.ts +++ b/clients/client-kinesis-video/pagination/ListSignalingChannelsPaginator.ts @@ -8,6 +8,9 @@ import { import { KinesisVideoPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KinesisVideoClient, input: ListSignalingChannelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSignalingChannelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: KinesisVideo, input: ListSignalingChannelsCommandInput, diff --git a/clients/client-kinesis-video/pagination/ListStreamsPaginator.ts b/clients/client-kinesis-video/pagination/ListStreamsPaginator.ts index db668db261e9d..40d6474d11932 100644 --- a/clients/client-kinesis-video/pagination/ListStreamsPaginator.ts +++ b/clients/client-kinesis-video/pagination/ListStreamsPaginator.ts @@ -4,6 +4,9 @@ import { ListStreamsCommand, ListStreamsCommandInput, ListStreamsCommandOutput } import { KinesisVideoPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KinesisVideoClient, input: ListStreamsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStreamsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: KinesisVideo, input: ListStreamsCommandInput, diff --git a/clients/client-kinesis-video/runtimeConfig.browser.ts b/clients/client-kinesis-video/runtimeConfig.browser.ts index e6ca3ec417048..e1544b1f122c5 100644 --- a/clients/client-kinesis-video/runtimeConfig.browser.ts +++ b/clients/client-kinesis-video/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KinesisVideoClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kinesis-video/runtimeConfig.native.ts b/clients/client-kinesis-video/runtimeConfig.native.ts index 49333387240bd..fe63b5e9b2343 100644 --- a/clients/client-kinesis-video/runtimeConfig.native.ts +++ b/clients/client-kinesis-video/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KinesisVideoClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kinesis-video/runtimeConfig.shared.ts b/clients/client-kinesis-video/runtimeConfig.shared.ts index 4c1a3d28c2dbc..eed5699ec9bee 100644 --- a/clients/client-kinesis-video/runtimeConfig.shared.ts +++ b/clients/client-kinesis-video/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-09-30", disableHostPrefix: false, diff --git a/clients/client-kinesis-video/runtimeConfig.ts b/clients/client-kinesis-video/runtimeConfig.ts index 09181b0f4740c..21787e7efa9eb 100644 --- a/clients/client-kinesis-video/runtimeConfig.ts +++ b/clients/client-kinesis-video/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KinesisVideoClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kinesis-video/tsconfig.json b/clients/client-kinesis-video/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kinesis-video/tsconfig.json +++ b/clients/client-kinesis-video/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kinesis/commands/AddTagsToStreamCommand.ts b/clients/client-kinesis/commands/AddTagsToStreamCommand.ts index 9a019c095575c..566a3c10407a3 100644 --- a/clients/client-kinesis/commands/AddTagsToStreamCommand.ts +++ b/clients/client-kinesis/commands/AddTagsToStreamCommand.ts @@ -20,6 +20,17 @@ import { export type AddTagsToStreamCommandInput = AddTagsToStreamInput; export type AddTagsToStreamCommandOutput = __MetadataBearer; +/** + *

Adds or updates tags for the specified Kinesis data stream. Each time you invoke + * this operation, you can specify up to 10 tags. If you want to add more than 10 tags to + * your stream, you can invoke this operation multiple times. In total, each stream can + * have up to 50 tags.

+ *

If tags have already been assigned to the stream, AddTagsToStream + * overwrites any existing tags that correspond to the specified tag keys.

+ *

+ * AddTagsToStream has a limit of five transactions per second per + * account.

+ */ export class AddTagsToStreamCommand extends $Command< AddTagsToStreamCommandInput, AddTagsToStreamCommandOutput, @@ -34,6 +45,9 @@ export class AddTagsToStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/CreateStreamCommand.ts b/clients/client-kinesis/commands/CreateStreamCommand.ts index eee5b7fdf174f..e23a2e4417f89 100644 --- a/clients/client-kinesis/commands/CreateStreamCommand.ts +++ b/clients/client-kinesis/commands/CreateStreamCommand.ts @@ -20,6 +20,49 @@ import { export type CreateStreamCommandInput = CreateStreamInput; export type CreateStreamCommandOutput = __MetadataBearer; +/** + *

Creates a Kinesis data stream. A stream captures and transports data records that + * are continuously emitted from different data sources or producers. + * Scale-out within a stream is explicitly supported by means of shards, which are uniquely + * identified groups of data records in a stream.

+ *

You specify and control the number of shards that a stream is composed of. Each + * shard can support reads up to five transactions per second, up to a maximum data read + * total of 2 MiB per second. Each shard can support writes up to 1,000 records per second, + * up to a maximum data write total of 1 MiB per second. If the amount of data input + * increases or decreases, you can add or remove shards.

+ *

The stream name identifies the stream. The name is scoped to the AWS account used + * by the application. It is also scoped by AWS Region. That is, two streams in two + * different accounts can have the same name, and two streams in the same account, but in + * two different Regions, can have the same name.

+ *

+ * CreateStream is an asynchronous operation. Upon receiving a + * CreateStream request, Kinesis Data Streams immediately returns and sets + * the stream status to CREATING. After the stream is created, Kinesis Data + * Streams sets the stream status to ACTIVE. You should perform read and write + * operations only on an ACTIVE stream.

+ *

You receive a LimitExceededException when making a + * CreateStream request when you try to do one of the following:

+ *
    + *
  • + * + *

    Have more than five streams in the CREATING state at any point + * in time.

    + *
  • + *
  • + * + *

    Create more shards than are authorized for your account.

    + *
  • + *
+ *

For the default shard limit for an AWS account, see Amazon Kinesis Data Streams + * Limits in the Amazon Kinesis Data Streams Developer + * Guide. To increase this limit, contact AWS + * Support.

+ *

You can use DescribeStream to check the stream status, which is + * returned in StreamStatus.

+ *

+ * CreateStream has a limit of five transactions per second per + * account.

+ */ export class CreateStreamCommand extends $Command< CreateStreamCommandInput, CreateStreamCommandOutput, @@ -34,6 +77,9 @@ export class CreateStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/DecreaseStreamRetentionPeriodCommand.ts b/clients/client-kinesis/commands/DecreaseStreamRetentionPeriodCommand.ts index 4f66c2ca914ea..82975900c36da 100644 --- a/clients/client-kinesis/commands/DecreaseStreamRetentionPeriodCommand.ts +++ b/clients/client-kinesis/commands/DecreaseStreamRetentionPeriodCommand.ts @@ -20,6 +20,14 @@ import { export type DecreaseStreamRetentionPeriodCommandInput = DecreaseStreamRetentionPeriodInput; export type DecreaseStreamRetentionPeriodCommandOutput = __MetadataBearer; +/** + *

Decreases the Kinesis data stream's retention period, which is the length of time + * data records are accessible after they are added to the stream. The minimum value of a + * stream's retention period is 24 hours.

+ *

This operation may result in lost data. For example, if the stream's retention + * period is 48 hours and is decreased to 24 hours, any data already in the stream that is + * older than 24 hours is inaccessible.

+ */ export class DecreaseStreamRetentionPeriodCommand extends $Command< DecreaseStreamRetentionPeriodCommandInput, DecreaseStreamRetentionPeriodCommandOutput, @@ -34,6 +42,9 @@ export class DecreaseStreamRetentionPeriodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/DeleteStreamCommand.ts b/clients/client-kinesis/commands/DeleteStreamCommand.ts index a2a20cb62b179..1e1c8e3f0da98 100644 --- a/clients/client-kinesis/commands/DeleteStreamCommand.ts +++ b/clients/client-kinesis/commands/DeleteStreamCommand.ts @@ -20,6 +20,27 @@ import { export type DeleteStreamCommandInput = DeleteStreamInput; export type DeleteStreamCommandOutput = __MetadataBearer; +/** + *

Deletes a Kinesis data stream and all its shards and data. You must shut down any + * applications that are operating on the stream before you delete the stream. If an + * application attempts to operate on a deleted stream, it receives the exception + * ResourceNotFoundException.

+ *

If the stream is in the ACTIVE state, you can delete it. After a + * DeleteStream request, the specified stream is in the + * DELETING state until Kinesis Data Streams completes the + * deletion.

+ *

+ * Note: Kinesis Data Streams might continue to accept + * data read and write operations, such as PutRecord, PutRecords, and GetRecords, on a stream in the + * DELETING state until the stream deletion is complete.

+ *

When you delete a stream, any shards in that stream are also deleted, and any tags + * are dissociated from the stream.

+ *

You can use the DescribeStream operation to check the state of + * the stream, which is returned in StreamStatus.

+ *

+ * DeleteStream has a limit of five transactions per second per + * account.

+ */ export class DeleteStreamCommand extends $Command< DeleteStreamCommandInput, DeleteStreamCommandOutput, @@ -34,6 +55,9 @@ export class DeleteStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/DeregisterStreamConsumerCommand.ts b/clients/client-kinesis/commands/DeregisterStreamConsumerCommand.ts index 5b08a56dd2d60..e10fe8c806452 100644 --- a/clients/client-kinesis/commands/DeregisterStreamConsumerCommand.ts +++ b/clients/client-kinesis/commands/DeregisterStreamConsumerCommand.ts @@ -20,6 +20,16 @@ import { export type DeregisterStreamConsumerCommandInput = DeregisterStreamConsumerInput; export type DeregisterStreamConsumerCommandOutput = __MetadataBearer; +/** + *

To deregister a consumer, provide its ARN. Alternatively, you can provide the ARN of + * the data stream and the name you gave the consumer when you registered it. You may also + * provide all three parameters, as long as they don't conflict with each other. If you + * don't know the name or ARN of the consumer that you want to deregister, you can use the + * ListStreamConsumers operation to get a list of the descriptions of + * all the consumers that are currently registered with a given data stream. The + * description of a consumer contains its name and ARN.

+ *

This operation has a limit of five transactions per second per stream.

+ */ export class DeregisterStreamConsumerCommand extends $Command< DeregisterStreamConsumerCommandInput, DeregisterStreamConsumerCommandOutput, @@ -34,6 +44,9 @@ export class DeregisterStreamConsumerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/DescribeLimitsCommand.ts b/clients/client-kinesis/commands/DescribeLimitsCommand.ts index 7d663e5700c7c..c95706a6527d9 100644 --- a/clients/client-kinesis/commands/DescribeLimitsCommand.ts +++ b/clients/client-kinesis/commands/DescribeLimitsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeLimitsCommandInput = DescribeLimitsInput; export type DescribeLimitsCommandOutput = DescribeLimitsOutput & __MetadataBearer; +/** + *

Describes the shard limits and usage for the account.

+ *

If you update your account limits, the old limits might be returned for a few + * minutes.

+ *

This operation has a limit of one transaction per second per account.

+ */ export class DescribeLimitsCommand extends $Command< DescribeLimitsCommandInput, DescribeLimitsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/DescribeStreamCommand.ts b/clients/client-kinesis/commands/DescribeStreamCommand.ts index 8e134407f3e99..1222cc5fa7c75 100644 --- a/clients/client-kinesis/commands/DescribeStreamCommand.ts +++ b/clients/client-kinesis/commands/DescribeStreamCommand.ts @@ -20,6 +20,25 @@ import { export type DescribeStreamCommandInput = DescribeStreamInput; export type DescribeStreamCommandOutput = DescribeStreamOutput & __MetadataBearer; +/** + *

Describes the specified Kinesis data stream.

+ * + *

The information returned includes the stream name, Amazon Resource Name (ARN), + * creation time, enhanced metric configuration, and shard map. The shard map is an array + * of shard objects. For each shard object, there is the hash key and sequence number + * ranges that the shard spans, and the IDs of any earlier shards that played in a role in + * creating the shard. Every record ingested in the stream is identified by a sequence + * number, which is assigned when the record is put into the stream.

+ * + *

You can limit the number of shards returned by each call. For more information, see + * Retrieving + * Shards from a Stream in the Amazon Kinesis Data Streams Developer + * Guide.

+ *

There are no guarantees about the chronological order shards returned. To process + * shards in chronological order, use the ID of the parent shard to track the lineage to + * the oldest shard.

+ *

This operation has a limit of 10 transactions per second per account.

+ */ export class DescribeStreamCommand extends $Command< DescribeStreamCommandInput, DescribeStreamCommandOutput, @@ -34,6 +53,9 @@ export class DescribeStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/DescribeStreamConsumerCommand.ts b/clients/client-kinesis/commands/DescribeStreamConsumerCommand.ts index 5d5d46a616994..278379e5554a4 100644 --- a/clients/client-kinesis/commands/DescribeStreamConsumerCommand.ts +++ b/clients/client-kinesis/commands/DescribeStreamConsumerCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeStreamConsumerCommandInput = DescribeStreamConsumerInput; export type DescribeStreamConsumerCommandOutput = DescribeStreamConsumerOutput & __MetadataBearer; +/** + *

To get the description of a registered consumer, provide the ARN of the consumer. + * Alternatively, you can provide the ARN of the data stream and the name you gave the + * consumer when you registered it. You may also provide all three parameters, as long as + * they don't conflict with each other. If you don't know the name or ARN of the consumer + * that you want to describe, you can use the ListStreamConsumers + * operation to get a list of the descriptions of all the consumers that are currently + * registered with a given data stream.

+ *

This operation has a limit of 20 transactions per second per stream.

+ */ export class DescribeStreamConsumerCommand extends $Command< DescribeStreamConsumerCommandInput, DescribeStreamConsumerCommandOutput, @@ -34,6 +44,9 @@ export class DescribeStreamConsumerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/DescribeStreamSummaryCommand.ts b/clients/client-kinesis/commands/DescribeStreamSummaryCommand.ts index a91c65325d72a..b9168dfc42eb7 100644 --- a/clients/client-kinesis/commands/DescribeStreamSummaryCommand.ts +++ b/clients/client-kinesis/commands/DescribeStreamSummaryCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeStreamSummaryCommandInput = DescribeStreamSummaryInput; export type DescribeStreamSummaryCommandOutput = DescribeStreamSummaryOutput & __MetadataBearer; +/** + *

Provides a summarized description of the specified Kinesis data stream without the + * shard list.

+ *

The information returned includes the stream name, Amazon Resource Name (ARN), + * status, record retention period, approximate creation time, monitoring, encryption + * details, and open shard count.

+ *

+ * DescribeStreamSummary has a limit of 20 transactions per second + * per account.

+ */ export class DescribeStreamSummaryCommand extends $Command< DescribeStreamSummaryCommandInput, DescribeStreamSummaryCommandOutput, @@ -34,6 +44,9 @@ export class DescribeStreamSummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/DisableEnhancedMonitoringCommand.ts b/clients/client-kinesis/commands/DisableEnhancedMonitoringCommand.ts index f9d184bfe2d0d..505f1f58b5120 100644 --- a/clients/client-kinesis/commands/DisableEnhancedMonitoringCommand.ts +++ b/clients/client-kinesis/commands/DisableEnhancedMonitoringCommand.ts @@ -20,6 +20,9 @@ import { export type DisableEnhancedMonitoringCommandInput = DisableEnhancedMonitoringInput; export type DisableEnhancedMonitoringCommandOutput = EnhancedMonitoringOutput & __MetadataBearer; +/** + *

Disables enhanced monitoring.

+ */ export class DisableEnhancedMonitoringCommand extends $Command< DisableEnhancedMonitoringCommandInput, DisableEnhancedMonitoringCommandOutput, @@ -34,6 +37,9 @@ export class DisableEnhancedMonitoringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/EnableEnhancedMonitoringCommand.ts b/clients/client-kinesis/commands/EnableEnhancedMonitoringCommand.ts index de0f65cd7086d..298c520d21a31 100644 --- a/clients/client-kinesis/commands/EnableEnhancedMonitoringCommand.ts +++ b/clients/client-kinesis/commands/EnableEnhancedMonitoringCommand.ts @@ -20,6 +20,9 @@ import { export type EnableEnhancedMonitoringCommandInput = EnableEnhancedMonitoringInput; export type EnableEnhancedMonitoringCommandOutput = EnhancedMonitoringOutput & __MetadataBearer; +/** + *

Enables enhanced Kinesis data stream monitoring for shard-level metrics.

+ */ export class EnableEnhancedMonitoringCommand extends $Command< EnableEnhancedMonitoringCommandInput, EnableEnhancedMonitoringCommandOutput, @@ -34,6 +37,9 @@ export class EnableEnhancedMonitoringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/GetRecordsCommand.ts b/clients/client-kinesis/commands/GetRecordsCommand.ts index f52c617f41838..5101c2bdc4dda 100644 --- a/clients/client-kinesis/commands/GetRecordsCommand.ts +++ b/clients/client-kinesis/commands/GetRecordsCommand.ts @@ -20,6 +20,55 @@ import { export type GetRecordsCommandInput = GetRecordsInput; export type GetRecordsCommandOutput = GetRecordsOutput & __MetadataBearer; +/** + *

Gets data records from a Kinesis data stream's shard.

+ *

Specify a shard iterator using the ShardIterator parameter. The shard + * iterator specifies the position in the shard from which you want to start reading data + * records sequentially. If there are no records available in the portion of the shard that + * the iterator points to, GetRecords returns an empty list. It might + * take multiple calls to get to a portion of the shard that contains records.

+ *

You can scale by provisioning multiple shards per stream while considering service + * limits (for more information, see Amazon Kinesis Data Streams + * Limits in the Amazon Kinesis Data Streams Developer + * Guide). Your application should have one thread per shard, each reading + * continuously from its stream. To read from a stream continually, call GetRecords in a loop. Use GetShardIterator to get the + * shard iterator to specify in the first GetRecords call. GetRecords returns a new shard iterator in + * NextShardIterator. Specify the shard iterator returned in + * NextShardIterator in subsequent calls to GetRecords. + * If the shard has been closed, the shard iterator can't return more data and GetRecords returns null in NextShardIterator. + * You can terminate the loop when the shard is closed, or when the shard iterator reaches + * the record with the sequence number or other attribute that marks it as the last record + * to process.

+ *

Each data record can be up to 1 MiB in size, and each shard can read up to 2 MiB + * per second. You can ensure that your calls don't exceed the maximum supported size or + * throughput by using the Limit parameter to specify the maximum number of + * records that GetRecords can return. Consider your average record size + * when determining this limit. The maximum number of records that can be returned per call + * is 10,000.

+ * + *

The size of the data returned by GetRecords varies depending on + * the utilization of the shard. The maximum size of data that GetRecords + * can return is 10 MiB. If a call returns this amount of data, subsequent calls made + * within the next 5 seconds throw ProvisionedThroughputExceededException. If + * there is insufficient provisioned throughput on the stream, subsequent calls made within + * the next 1 second throw ProvisionedThroughputExceededException. GetRecords doesn't return any data when it throws an exception. For this + * reason, we recommend that you wait 1 second between calls to GetRecords. However, it's possible that the application will get exceptions for longer than 1 + * second.

+ *

To detect whether the application is falling behind in processing, you can use the + * MillisBehindLatest response attribute. You can also monitor the stream + * using CloudWatch metrics and other mechanisms (see Monitoring in the Amazon + * Kinesis Data Streams Developer Guide).

+ *

Each Amazon Kinesis record includes a value, + * ApproximateArrivalTimestamp, that is set when a stream successfully + * receives and stores a record. This is commonly referred to as a server-side time stamp, + * whereas a client-side time stamp is set when a data producer creates or sends the record + * to a stream (a data producer is any data source putting data records into a stream, for + * example with PutRecords). The time stamp has millisecond precision. + * There are no guarantees about the time stamp accuracy, or that the time stamp is always + * increasing. For example, records in a shard or across a stream might have time stamps + * that are out of order.

+ *

This operation has a limit of five transactions per second per shard.

+ */ export class GetRecordsCommand extends $Command< GetRecordsCommandInput, GetRecordsCommandOutput, @@ -34,6 +83,9 @@ export class GetRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/GetShardIteratorCommand.ts b/clients/client-kinesis/commands/GetShardIteratorCommand.ts index ff7e1c89674de..785a6071cac37 100644 --- a/clients/client-kinesis/commands/GetShardIteratorCommand.ts +++ b/clients/client-kinesis/commands/GetShardIteratorCommand.ts @@ -20,6 +20,42 @@ import { export type GetShardIteratorCommandInput = GetShardIteratorInput; export type GetShardIteratorCommandOutput = GetShardIteratorOutput & __MetadataBearer; +/** + *

Gets an Amazon Kinesis shard iterator. A shard iterator expires 5 minutes after it + * is returned to the requester.

+ *

A shard iterator specifies the shard position from which to start reading data + * records sequentially. The position is specified using the sequence number of a data + * record in a shard. A sequence number is the identifier associated with every record + * ingested in the stream, and is assigned when a record is put into the stream. Each + * stream has one or more shards.

+ *

You must specify the shard iterator type. For example, you can set the + * ShardIteratorType parameter to read exactly from the position denoted + * by a specific sequence number by using the AT_SEQUENCE_NUMBER shard + * iterator type. Alternatively, the parameter can read right after the sequence number by + * using the AFTER_SEQUENCE_NUMBER shard iterator type, using sequence numbers + * returned by earlier calls to PutRecord, PutRecords, + * GetRecords, or DescribeStream. In the request, + * you can specify the shard iterator type AT_TIMESTAMP to read records from + * an arbitrary point in time, TRIM_HORIZON to cause + * ShardIterator to point to the last untrimmed record in the shard in the + * system (the oldest data record in the shard), or LATEST so that you always + * read the most recent data in the shard.

+ *

When you read repeatedly from a stream, use a GetShardIterator + * request to get the first shard iterator for use in your first GetRecords request and for subsequent reads use the shard iterator returned by the GetRecords request in NextShardIterator. A new shard + * iterator is returned by every GetRecords request in + * NextShardIterator, which you use in the ShardIterator + * parameter of the next GetRecords request.

+ *

If a GetShardIterator request is made too often, you receive a + * ProvisionedThroughputExceededException. For more information about + * throughput limits, see GetRecords, and Streams Limits in the + * Amazon Kinesis Data Streams Developer Guide.

+ *

If the shard is closed, GetShardIterator returns a valid iterator + * for the last sequence number of the shard. A shard can be closed as a result of using + * SplitShard or MergeShards.

+ *

+ * GetShardIterator has a limit of five transactions per second per + * account per open shard.

+ */ export class GetShardIteratorCommand extends $Command< GetShardIteratorCommandInput, GetShardIteratorCommandOutput, @@ -34,6 +70,9 @@ export class GetShardIteratorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/IncreaseStreamRetentionPeriodCommand.ts b/clients/client-kinesis/commands/IncreaseStreamRetentionPeriodCommand.ts index e00bac63d2832..0ce1b086cf4f6 100644 --- a/clients/client-kinesis/commands/IncreaseStreamRetentionPeriodCommand.ts +++ b/clients/client-kinesis/commands/IncreaseStreamRetentionPeriodCommand.ts @@ -20,6 +20,17 @@ import { export type IncreaseStreamRetentionPeriodCommandInput = IncreaseStreamRetentionPeriodInput; export type IncreaseStreamRetentionPeriodCommandOutput = __MetadataBearer; +/** + *

Increases the Kinesis data stream's retention period, which is the length of time + * data records are accessible after they are added to the stream. The maximum value of a + * stream's retention period is 168 hours (7 days).

+ *

If you choose a longer stream retention period, this operation increases the time + * period during which records that have not yet expired are accessible. However, it does + * not make previous, expired data (older than the stream's previous retention period) + * accessible after the operation has been called. For example, if a stream's retention + * period is set to 24 hours and is increased to 168 hours, any data that is older than 24 + * hours remains inaccessible to consumer applications.

+ */ export class IncreaseStreamRetentionPeriodCommand extends $Command< IncreaseStreamRetentionPeriodCommandInput, IncreaseStreamRetentionPeriodCommandOutput, @@ -34,6 +45,9 @@ export class IncreaseStreamRetentionPeriodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/ListShardsCommand.ts b/clients/client-kinesis/commands/ListShardsCommand.ts index c2cfd404840d8..19ac7182e16ba 100644 --- a/clients/client-kinesis/commands/ListShardsCommand.ts +++ b/clients/client-kinesis/commands/ListShardsCommand.ts @@ -20,6 +20,17 @@ import { export type ListShardsCommandInput = ListShardsInput; export type ListShardsCommandOutput = ListShardsOutput & __MetadataBearer; +/** + *

Lists the shards in a stream and provides information about each shard. This + * operation has a limit of 100 transactions per second per data stream.

+ * + *

This API is a new operation that is used by the Amazon Kinesis Client Library + * (KCL). If you have a fine-grained IAM policy that only allows specific operations, + * you must update your policy to allow calls to this API. For more information, see + * Controlling Access to Amazon Kinesis Data Streams Resources Using + * IAM.

+ *
+ */ export class ListShardsCommand extends $Command< ListShardsCommandInput, ListShardsCommandOutput, @@ -34,6 +45,9 @@ export class ListShardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/ListStreamConsumersCommand.ts b/clients/client-kinesis/commands/ListStreamConsumersCommand.ts index 1e365b26d36d5..4af00066ae222 100644 --- a/clients/client-kinesis/commands/ListStreamConsumersCommand.ts +++ b/clients/client-kinesis/commands/ListStreamConsumersCommand.ts @@ -20,6 +20,11 @@ import { export type ListStreamConsumersCommandInput = ListStreamConsumersInput; export type ListStreamConsumersCommandOutput = ListStreamConsumersOutput & __MetadataBearer; +/** + *

Lists the consumers registered to receive data from a stream using enhanced fan-out, + * and provides information about each consumer.

+ *

This operation has a limit of 5 transactions per second per stream.

+ */ export class ListStreamConsumersCommand extends $Command< ListStreamConsumersCommandInput, ListStreamConsumersCommandOutput, @@ -34,6 +39,9 @@ export class ListStreamConsumersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/ListStreamsCommand.ts b/clients/client-kinesis/commands/ListStreamsCommand.ts index 5ff243f583ab8..a270e4ab72e7d 100644 --- a/clients/client-kinesis/commands/ListStreamsCommand.ts +++ b/clients/client-kinesis/commands/ListStreamsCommand.ts @@ -20,6 +20,24 @@ import { export type ListStreamsCommandInput = ListStreamsInput; export type ListStreamsCommandOutput = ListStreamsOutput & __MetadataBearer; +/** + *

Lists your Kinesis data streams.

+ *

The number of streams may be too large to return from a single call to + * ListStreams. You can limit the number of returned streams using the + * Limit parameter. If you do not specify a value for the + * Limit parameter, Kinesis Data Streams uses the default limit, which is + * currently 10.

+ *

You can detect if there are more streams available to list by using the + * HasMoreStreams flag from the returned output. If there are more streams + * available, you can request more streams by using the name of the last stream returned by + * the ListStreams request in the ExclusiveStartStreamName + * parameter in a subsequent request to ListStreams. The group of stream names + * returned by the subsequent request is then added to the list. You can continue this + * process until all the stream names have been collected in the list.

+ *

+ * ListStreams has a limit of five transactions per second per + * account.

+ */ export class ListStreamsCommand extends $Command< ListStreamsCommandInput, ListStreamsCommandOutput, @@ -34,6 +52,9 @@ export class ListStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/ListTagsForStreamCommand.ts b/clients/client-kinesis/commands/ListTagsForStreamCommand.ts index ca8ff4376ac8d..7f4cb9145b2c1 100644 --- a/clients/client-kinesis/commands/ListTagsForStreamCommand.ts +++ b/clients/client-kinesis/commands/ListTagsForStreamCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForStreamCommandInput = ListTagsForStreamInput; export type ListTagsForStreamCommandOutput = ListTagsForStreamOutput & __MetadataBearer; +/** + *

Lists the tags for the specified Kinesis data stream. This operation has a limit of + * five transactions per second per account.

+ */ export class ListTagsForStreamCommand extends $Command< ListTagsForStreamCommandInput, ListTagsForStreamCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/MergeShardsCommand.ts b/clients/client-kinesis/commands/MergeShardsCommand.ts index 1929cc18502cc..26313da2c5b37 100644 --- a/clients/client-kinesis/commands/MergeShardsCommand.ts +++ b/clients/client-kinesis/commands/MergeShardsCommand.ts @@ -20,6 +20,44 @@ import { export type MergeShardsCommandInput = MergeShardsInput; export type MergeShardsCommandOutput = __MetadataBearer; +/** + *

Merges two adjacent shards in a Kinesis data stream and combines them into a single + * shard to reduce the stream's capacity to ingest and transport data. Two shards are + * considered adjacent if the union of the hash key ranges for the two shards form a + * contiguous set with no gaps. For example, if you have two shards, one with a hash key + * range of 276...381 and the other with a hash key range of 382...454, then you could + * merge these two shards into a single shard that would have a hash key range of + * 276...454. After the merge, the single child shard receives data for all hash key values + * covered by the two parent shards.

+ *

+ * MergeShards is called when there is a need to reduce the overall capacity + * of a stream because of excess capacity that is not being used. You must specify the + * shard to be merged and the adjacent shard for a stream. For more information about + * merging shards, see Merge Two + * Shards in the Amazon Kinesis Data Streams Developer + * Guide.

+ *

If the stream is in the ACTIVE state, you can call + * MergeShards. If a stream is in the CREATING, + * UPDATING, or DELETING state, MergeShards + * returns a ResourceInUseException. If the specified stream does not exist, + * MergeShards returns a ResourceNotFoundException.

+ *

You can use DescribeStream to check the state of the stream, + * which is returned in StreamStatus.

+ *

+ * MergeShards is an asynchronous operation. Upon receiving a + * MergeShards request, Amazon Kinesis Data Streams immediately returns a + * response and sets the StreamStatus to UPDATING. After the + * operation is completed, Kinesis Data Streams sets the StreamStatus to + * ACTIVE. Read and write operations continue to work while the stream is + * in the UPDATING state.

+ *

You use DescribeStream to determine the shard IDs that are + * specified in the MergeShards request.

+ *

If you try to operate on too many streams in parallel using CreateStream, DeleteStream, MergeShards, + * or SplitShard, you receive a LimitExceededException.

+ *

+ * MergeShards has a limit of five transactions per second per + * account.

+ */ export class MergeShardsCommand extends $Command< MergeShardsCommandInput, MergeShardsCommandOutput, @@ -34,6 +72,9 @@ export class MergeShardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/PutRecordCommand.ts b/clients/client-kinesis/commands/PutRecordCommand.ts index 1573082f19e3d..f43c2d348d2cd 100644 --- a/clients/client-kinesis/commands/PutRecordCommand.ts +++ b/clients/client-kinesis/commands/PutRecordCommand.ts @@ -17,6 +17,44 @@ import { export type PutRecordCommandInput = PutRecordInput; export type PutRecordCommandOutput = PutRecordOutput & __MetadataBearer; +/** + *

Writes a single data record into an Amazon Kinesis data stream. Call + * PutRecord to send data into the stream for real-time ingestion and + * subsequent processing, one record at a time. Each shard can support writes up to 1,000 + * records per second, up to a maximum data write total of 1 MiB per second.

+ *

You must specify the name of the stream that captures, stores, and transports the + * data; a partition key; and the data blob itself.

+ *

The data blob can be any type of data; for example, a segment from a log file, + * geographic/location data, website clickstream data, and so on.

+ *

The partition key is used by Kinesis Data Streams to distribute data across shards. + * Kinesis Data Streams segregates the data records that belong to a stream into multiple + * shards, using the partition key associated with each data record to determine the shard + * to which a given data record belongs.

+ *

Partition keys are Unicode strings, with a maximum length limit of 256 characters + * for each key. An MD5 hash function is used to map partition keys to 128-bit integer + * values and to map associated data records to shards using the hash key ranges of the + * shards. You can override hashing the partition key to determine the shard by explicitly + * specifying a hash value using the ExplicitHashKey parameter. For more + * information, see Adding Data to a Stream in the Amazon Kinesis Data Streams + * Developer Guide.

+ *

+ * PutRecord returns the shard ID of where the data record was placed and the + * sequence number that was assigned to the data record.

+ *

Sequence numbers increase over time and are specific to a shard within a stream, + * not across all shards within a stream. To guarantee strictly increasing ordering, write + * serially to a shard and use the SequenceNumberForOrdering parameter. For + * more information, see Adding Data to a Stream in the Amazon Kinesis Data Streams + * Developer Guide.

+ * + *

After you write a record to a stream, you cannot modify that record or its order + * within the stream.

+ *
+ *

If a PutRecord request cannot be processed because of insufficient + * provisioned throughput on the shard involved in the request, PutRecord + * throws ProvisionedThroughputExceededException.

+ *

By default, data records are accessible for 24 hours from the time that they are + * added to a stream. You can use IncreaseStreamRetentionPeriod or DecreaseStreamRetentionPeriod to modify this retention period.

+ */ export class PutRecordCommand extends $Command< PutRecordCommandInput, PutRecordCommandOutput, @@ -31,6 +69,9 @@ export class PutRecordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/PutRecordsCommand.ts b/clients/client-kinesis/commands/PutRecordsCommand.ts index bea5c2d29b08c..33bfae054ae73 100644 --- a/clients/client-kinesis/commands/PutRecordsCommand.ts +++ b/clients/client-kinesis/commands/PutRecordsCommand.ts @@ -20,6 +20,64 @@ import { export type PutRecordsCommandInput = PutRecordsInput; export type PutRecordsCommandOutput = PutRecordsOutput & __MetadataBearer; +/** + *

Writes multiple data records into a Kinesis data stream in a single call (also + * referred to as a PutRecords request). Use this operation to send data into + * the stream for data ingestion and processing.

+ *

Each PutRecords request can support up to 500 records. Each record in + * the request can be as large as 1 MiB, up to a limit of 5 MiB for the entire request, + * including partition keys. Each shard can support writes up to 1,000 records per second, + * up to a maximum data write total of 1 MiB per second.

+ *

You must specify the name of the stream that captures, stores, and transports the + * data; and an array of request Records, with each record in the array + * requiring a partition key and data blob. The record size limit applies to the total size + * of the partition key and data blob.

+ *

The data blob can be any type of data; for example, a segment from a log file, + * geographic/location data, website clickstream data, and so on.

+ *

The partition key is used by Kinesis Data Streams as input to a hash function that + * maps the partition key and associated data to a specific shard. An MD5 hash function is + * used to map partition keys to 128-bit integer values and to map associated data records + * to shards. As a result of this hashing mechanism, all data records with the same + * partition key map to the same shard within the stream. For more information, see Adding Data to a Stream in the Amazon Kinesis Data Streams + * Developer Guide.

+ *

Each record in the Records array may include an optional parameter, + * ExplicitHashKey, which overrides the partition key to shard mapping. + * This parameter allows a data producer to determine explicitly the shard where the record + * is stored. For more information, see Adding Multiple Records with PutRecords in the Amazon Kinesis + * Data Streams Developer Guide.

+ *

The PutRecords response includes an array of response + * Records. Each record in the response array directly correlates with a + * record in the request array using natural ordering, from the top to the bottom of the + * request and response. The response Records array always includes the same + * number of records as the request array.

+ *

The response Records array includes both successfully and + * unsuccessfully processed records. Kinesis Data Streams attempts to process all records + * in each PutRecords request. A single record failure does not stop the + * processing of subsequent records. As a result, PutRecords doesn't guarantee the ordering + * of records. If you need to read records in the same order they are written to the + * stream, use PutRecord instead of PutRecords, and write to + * the same shard.

+ *

A successfully processed record includes ShardId and + * SequenceNumber values. The ShardId parameter identifies + * the shard in the stream where the record is stored. The SequenceNumber + * parameter is an identifier assigned to the put record, unique to all records in the + * stream.

+ *

An unsuccessfully processed record includes ErrorCode and + * ErrorMessage values. ErrorCode reflects the type of error + * and can be one of the following values: + * ProvisionedThroughputExceededException or InternalFailure. + * ErrorMessage provides more detailed information about the + * ProvisionedThroughputExceededException exception including the account + * ID, stream name, and shard ID of the record that was throttled. For more information + * about partially successful responses, see Adding Multiple Records with PutRecords in the Amazon Kinesis + * Data Streams Developer Guide.

+ * + *

After you write a record to a stream, you cannot modify that record or its order + * within the stream.

+ *
+ *

By default, data records are accessible for 24 hours from the time that they are + * added to a stream. You can use IncreaseStreamRetentionPeriod or DecreaseStreamRetentionPeriod to modify this retention period.

+ */ export class PutRecordsCommand extends $Command< PutRecordsCommandInput, PutRecordsCommandOutput, @@ -34,6 +92,9 @@ export class PutRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/RegisterStreamConsumerCommand.ts b/clients/client-kinesis/commands/RegisterStreamConsumerCommand.ts index e140ecbc2feb6..41e9320c46b2f 100644 --- a/clients/client-kinesis/commands/RegisterStreamConsumerCommand.ts +++ b/clients/client-kinesis/commands/RegisterStreamConsumerCommand.ts @@ -20,6 +20,22 @@ import { export type RegisterStreamConsumerCommandInput = RegisterStreamConsumerInput; export type RegisterStreamConsumerCommandOutput = RegisterStreamConsumerOutput & __MetadataBearer; +/** + *

Registers a consumer with a Kinesis data stream. When you use this operation, the + * consumer you register can then call SubscribeToShard to receive data + * from the stream using enhanced fan-out, at a rate of up to 2 MiB per second for every + * shard you subscribe to. This rate is unaffected by the total number of consumers that + * read from the same stream.

+ *

You can register up to 20 consumers per stream. A given consumer can only be + * registered with one stream at a time.

+ *

For an example of how to use this operations, see Enhanced Fan-Out + * Using the Kinesis Data Streams API.

+ *

The use of this operation has a limit of five transactions per second per account. + * Also, only 5 consumers can be created simultaneously. In other words, you cannot have + * more than 5 consumers in a CREATING status at the same time. Registering a + * 6th consumer while there are 5 in a CREATING status results in a + * LimitExceededException.

+ */ export class RegisterStreamConsumerCommand extends $Command< RegisterStreamConsumerCommandInput, RegisterStreamConsumerCommandOutput, @@ -34,6 +50,9 @@ export class RegisterStreamConsumerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/RemoveTagsFromStreamCommand.ts b/clients/client-kinesis/commands/RemoveTagsFromStreamCommand.ts index c45b53814e665..95873259c4fb6 100644 --- a/clients/client-kinesis/commands/RemoveTagsFromStreamCommand.ts +++ b/clients/client-kinesis/commands/RemoveTagsFromStreamCommand.ts @@ -20,6 +20,14 @@ import { export type RemoveTagsFromStreamCommandInput = RemoveTagsFromStreamInput; export type RemoveTagsFromStreamCommandOutput = __MetadataBearer; +/** + *

Removes tags from the specified Kinesis data stream. Removed tags are deleted and + * cannot be recovered after this operation successfully completes.

+ *

If you specify a tag that does not exist, it is ignored.

+ *

+ * RemoveTagsFromStream has a limit of five transactions per second per + * account.

+ */ export class RemoveTagsFromStreamCommand extends $Command< RemoveTagsFromStreamCommandInput, RemoveTagsFromStreamCommandOutput, @@ -34,6 +42,9 @@ export class RemoveTagsFromStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/SplitShardCommand.ts b/clients/client-kinesis/commands/SplitShardCommand.ts index c15619687d60a..5fad757bd018a 100644 --- a/clients/client-kinesis/commands/SplitShardCommand.ts +++ b/clients/client-kinesis/commands/SplitShardCommand.ts @@ -20,6 +20,50 @@ import { export type SplitShardCommandInput = SplitShardInput; export type SplitShardCommandOutput = __MetadataBearer; +/** + *

Splits a shard into two new shards in the Kinesis data stream, to increase the + * stream's capacity to ingest and transport data. SplitShard is called when + * there is a need to increase the overall capacity of a stream because of an expected + * increase in the volume of data records being ingested.

+ *

You can also use SplitShard when a shard appears to be approaching its + * maximum utilization; for example, the producers sending data into the specific shard are + * suddenly sending more than previously anticipated. You can also call + * SplitShard to increase stream capacity, so that more Kinesis Data + * Streams applications can simultaneously read data from the stream for real-time + * processing.

+ *

You must specify the shard to be split and the new hash key, which is the position + * in the shard where the shard gets split in two. In many cases, the new hash key might be + * the average of the beginning and ending hash key, but it can be any hash key value in + * the range being mapped into the shard. For more information, see Split a + * Shard in the Amazon Kinesis Data Streams Developer + * Guide.

+ *

You can use DescribeStream to determine the shard ID and hash key + * values for the ShardToSplit and NewStartingHashKey parameters + * that are specified in the SplitShard request.

+ *

+ * SplitShard is an asynchronous operation. Upon receiving a + * SplitShard request, Kinesis Data Streams immediately returns a response + * and sets the stream status to UPDATING. After the operation is completed, + * Kinesis Data Streams sets the stream status to ACTIVE. Read and write + * operations continue to work while the stream is in the UPDATING state.

+ *

You can use DescribeStream to check the status of the stream, which is + * returned in StreamStatus. If the stream is in the ACTIVE + * state, you can call SplitShard. If a stream is in CREATING or + * UPDATING or DELETING states, DescribeStream + * returns a ResourceInUseException.

+ *

If the specified stream does not exist, DescribeStream returns a + * ResourceNotFoundException. If you try to create more shards than are + * authorized for your account, you receive a LimitExceededException.

+ *

For the default shard limit for an AWS account, see Kinesis Data Streams + * Limits in the Amazon Kinesis Data Streams Developer + * Guide. To increase this limit, contact AWS + * Support.

+ *

If you try to operate on too many streams simultaneously using CreateStream, DeleteStream, MergeShards, and/or SplitShard, you receive a + * LimitExceededException.

+ *

+ * SplitShard has a limit of five transactions per second per + * account.

+ */ export class SplitShardCommand extends $Command< SplitShardCommandInput, SplitShardCommandOutput, @@ -34,6 +78,9 @@ export class SplitShardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/StartStreamEncryptionCommand.ts b/clients/client-kinesis/commands/StartStreamEncryptionCommand.ts index 2e73c014112e4..cc1377744bc6b 100644 --- a/clients/client-kinesis/commands/StartStreamEncryptionCommand.ts +++ b/clients/client-kinesis/commands/StartStreamEncryptionCommand.ts @@ -20,6 +20,24 @@ import { export type StartStreamEncryptionCommandInput = StartStreamEncryptionInput; export type StartStreamEncryptionCommandOutput = __MetadataBearer; +/** + *

Enables or updates server-side encryption using an AWS KMS key for a specified + * stream.

+ *

Starting encryption is an asynchronous operation. Upon receiving the request, + * Kinesis Data Streams returns immediately and sets the status of the stream to + * UPDATING. After the update is complete, Kinesis Data Streams sets the + * status of the stream back to ACTIVE. Updating or applying encryption + * normally takes a few seconds to complete, but it can take minutes. You can continue to + * read and write data to your stream while its status is UPDATING. Once the + * status of the stream is ACTIVE, encryption begins for records written to + * the stream.

+ *

API Limits: You can successfully apply a new AWS KMS key for server-side encryption + * 25 times in a rolling 24-hour period.

+ *

Note: It can take up to 5 seconds after the stream is in an ACTIVE + * status before all records written to the stream are encrypted. After you enable + * encryption, you can verify that encryption is applied by inspecting the API response + * from PutRecord or PutRecords.

+ */ export class StartStreamEncryptionCommand extends $Command< StartStreamEncryptionCommandInput, StartStreamEncryptionCommandOutput, @@ -34,6 +52,9 @@ export class StartStreamEncryptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/StopStreamEncryptionCommand.ts b/clients/client-kinesis/commands/StopStreamEncryptionCommand.ts index 8f89c664eec23..2bfea9bf2e88d 100644 --- a/clients/client-kinesis/commands/StopStreamEncryptionCommand.ts +++ b/clients/client-kinesis/commands/StopStreamEncryptionCommand.ts @@ -20,6 +20,24 @@ import { export type StopStreamEncryptionCommandInput = StopStreamEncryptionInput; export type StopStreamEncryptionCommandOutput = __MetadataBearer; +/** + *

Disables server-side encryption for a specified stream.

+ *

Stopping encryption is an asynchronous operation. Upon receiving the request, + * Kinesis Data Streams returns immediately and sets the status of the stream to + * UPDATING. After the update is complete, Kinesis Data Streams sets the + * status of the stream back to ACTIVE. Stopping encryption normally takes a + * few seconds to complete, but it can take minutes. You can continue to read and write + * data to your stream while its status is UPDATING. Once the status of the + * stream is ACTIVE, records written to the stream are no longer encrypted by + * Kinesis Data Streams.

+ *

API Limits: You can successfully disable server-side encryption 25 times in a + * rolling 24-hour period.

+ *

Note: It can take up to 5 seconds after the stream is in an ACTIVE + * status before all records written to the stream are no longer subject to encryption. + * After you disabled encryption, you can verify that encryption is not applied by + * inspecting the API response from PutRecord or + * PutRecords.

+ */ export class StopStreamEncryptionCommand extends $Command< StopStreamEncryptionCommandInput, StopStreamEncryptionCommandOutput, @@ -34,6 +52,9 @@ export class StopStreamEncryptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/SubscribeToShardCommand.ts b/clients/client-kinesis/commands/SubscribeToShardCommand.ts index 4742730175b08..a430058e9d586 100644 --- a/clients/client-kinesis/commands/SubscribeToShardCommand.ts +++ b/clients/client-kinesis/commands/SubscribeToShardCommand.ts @@ -21,6 +21,30 @@ import { export type SubscribeToShardCommandInput = SubscribeToShardInput; export type SubscribeToShardCommandOutput = SubscribeToShardOutput & __MetadataBearer; +/** + *

This operation establishes an HTTP/2 connection between the consumer you specify in + * the ConsumerARN parameter and the shard you specify in the + * ShardId parameter. After the connection is successfully established, + * Kinesis Data Streams pushes records from the shard to the consumer over this connection. + * Before you call this operation, call RegisterStreamConsumer to + * register the consumer with Kinesis Data Streams.

+ *

When the SubscribeToShard call succeeds, your consumer starts receiving + * events of type SubscribeToShardEvent over the HTTP/2 connection for up + * to 5 minutes, after which time you need to call SubscribeToShard again to + * renew the subscription if you want to continue to receive records.

+ *

You can make one call to SubscribeToShard per second per registered + * consumer per shard. For example, if you have a 4000 shard stream and two registered + * stream consumers, you can make one SubscribeToShard request per second for + * each combination of shard and registered consumer, allowing you to subscribe both + * consumers to all 4000 shards in one second.

+ *

If you call SubscribeToShard again with the same ConsumerARN + * and ShardId within 5 seconds of a successful call, you'll get a + * ResourceInUseException. If you call SubscribeToShard 5 + * seconds or more after a successful call, the first connection will expire and the second + * call will take over the subscription.

+ *

For an example of how to use this operations, see Enhanced Fan-Out + * Using the Kinesis Data Streams API.

+ */ export class SubscribeToShardCommand extends $Command< SubscribeToShardCommandInput, SubscribeToShardCommandOutput, @@ -35,6 +59,9 @@ export class SubscribeToShardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/commands/UpdateShardCountCommand.ts b/clients/client-kinesis/commands/UpdateShardCountCommand.ts index cc0493187599a..0d67a6867e275 100644 --- a/clients/client-kinesis/commands/UpdateShardCountCommand.ts +++ b/clients/client-kinesis/commands/UpdateShardCountCommand.ts @@ -20,6 +20,52 @@ import { export type UpdateShardCountCommandInput = UpdateShardCountInput; export type UpdateShardCountCommandOutput = UpdateShardCountOutput & __MetadataBearer; +/** + *

Updates the shard count of the specified stream to the specified number of + * shards.

+ *

Updating the shard count is an asynchronous operation. Upon receiving the request, + * Kinesis Data Streams returns immediately and sets the status of the stream to + * UPDATING. After the update is complete, Kinesis Data Streams sets the + * status of the stream back to ACTIVE. Depending on the size of the stream, + * the scaling action could take a few minutes to complete. You can continue to read and + * write data to your stream while its status is UPDATING.

+ *

To update the shard count, Kinesis Data Streams performs splits or merges on + * individual shards. This can cause short-lived shards to be created, in addition to the + * final shards. These short-lived shards count towards your total shard limit for your + * account in the Region.

+ *

When using this operation, we recommend that you specify a target shard count that + * is a multiple of 25% (25%, 50%, 75%, 100%). You can specify any target value within your + * shard limit. However, if you specify a target that isn't a multiple of 25%, the scaling + * action might take longer to complete.

+ *

This operation has the following default limits. By default, you cannot do the + * following:

+ *
    + *
  • + *

    Scale more than ten times per rolling 24-hour period per stream

    + *
  • + *
  • + *

    Scale up to more than double your current shard count for a + * stream

    + *
  • + *
  • + *

    Scale down below half your current shard count for a stream

    + *
  • + *
  • + *

    Scale up to more than 500 shards in a stream

    + *
  • + *
  • + *

    Scale a stream with more than 500 shards down unless the result is less + * than 500 shards

    + *
  • + *
  • + *

    Scale up to more than the shard limit for your account

    + *
  • + *
+ *

For the default limits for an AWS account, see Streams Limits in the + * Amazon Kinesis Data Streams Developer Guide. To request an + * increase in the call rate limit, the shard limit for this API, or your overall shard + * limit, use the limits form.

+ */ export class UpdateShardCountCommand extends $Command< UpdateShardCountCommandInput, UpdateShardCountCommandOutput, @@ -34,6 +80,9 @@ export class UpdateShardCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KinesisClientResolvedConfig, diff --git a/clients/client-kinesis/package.json b/clients/client-kinesis/package.json index 026ea00ec7435..532ad64f0be55 100644 --- a/clients/client-kinesis/package.json +++ b/clients/client-kinesis/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kinesis Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kinesis/pagination/ListStreamConsumersPaginator.ts b/clients/client-kinesis/pagination/ListStreamConsumersPaginator.ts index b5dc0c3338b5f..ed23fc4e39b1f 100644 --- a/clients/client-kinesis/pagination/ListStreamConsumersPaginator.ts +++ b/clients/client-kinesis/pagination/ListStreamConsumersPaginator.ts @@ -8,6 +8,9 @@ import { import { KinesisPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KinesisClient, input: ListStreamConsumersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStreamConsumersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Kinesis, input: ListStreamConsumersCommandInput, diff --git a/clients/client-kinesis/runtimeConfig.browser.ts b/clients/client-kinesis/runtimeConfig.browser.ts index f0a1c67f3ff5e..d893f360847c4 100644 --- a/clients/client-kinesis/runtimeConfig.browser.ts +++ b/clients/client-kinesis/runtimeConfig.browser.ts @@ -13,6 +13,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KinesisClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kinesis/runtimeConfig.native.ts b/clients/client-kinesis/runtimeConfig.native.ts index 8cc35037968d1..2680f5dc28e39 100644 --- a/clients/client-kinesis/runtimeConfig.native.ts +++ b/clients/client-kinesis/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KinesisClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kinesis/runtimeConfig.shared.ts b/clients/client-kinesis/runtimeConfig.shared.ts index 26d8412bba85d..ebf1dfb585e40 100644 --- a/clients/client-kinesis/runtimeConfig.shared.ts +++ b/clients/client-kinesis/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2013-12-02", disableHostPrefix: false, diff --git a/clients/client-kinesis/runtimeConfig.ts b/clients/client-kinesis/runtimeConfig.ts index d18466c1e558e..f08804e57ff80 100644 --- a/clients/client-kinesis/runtimeConfig.ts +++ b/clients/client-kinesis/runtimeConfig.ts @@ -15,6 +15,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KinesisClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kinesis/tsconfig.json b/clients/client-kinesis/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kinesis/tsconfig.json +++ b/clients/client-kinesis/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-kms/commands/CancelKeyDeletionCommand.ts b/clients/client-kms/commands/CancelKeyDeletionCommand.ts index b9028b8a44367..73078624e3ccd 100644 --- a/clients/client-kms/commands/CancelKeyDeletionCommand.ts +++ b/clients/client-kms/commands/CancelKeyDeletionCommand.ts @@ -20,6 +20,16 @@ import { export type CancelKeyDeletionCommandInput = CancelKeyDeletionRequest; export type CancelKeyDeletionCommandOutput = CancelKeyDeletionResponse & __MetadataBearer; +/** + *

Cancels the deletion of a customer master key (CMK). When this operation succeeds, the key + * state of the CMK is Disabled. To enable the CMK, use EnableKey. + * You cannot perform this operation on a CMK in a different AWS account.

+ *

For more information about scheduling and canceling deletion of a CMK, see Deleting Customer Master + * Keys in the AWS Key Management Service Developer Guide.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class CancelKeyDeletionCommand extends $Command< CancelKeyDeletionCommandInput, CancelKeyDeletionCommandOutput, @@ -34,6 +44,9 @@ export class CancelKeyDeletionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ConnectCustomKeyStoreCommand.ts b/clients/client-kms/commands/ConnectCustomKeyStoreCommand.ts index 0cc588d08a8ef..3d4d3ea3c505e 100644 --- a/clients/client-kms/commands/ConnectCustomKeyStoreCommand.ts +++ b/clients/client-kms/commands/ConnectCustomKeyStoreCommand.ts @@ -20,6 +20,35 @@ import { export type ConnectCustomKeyStoreCommandInput = ConnectCustomKeyStoreRequest; export type ConnectCustomKeyStoreCommandOutput = ConnectCustomKeyStoreResponse & __MetadataBearer; +/** + *

Connects or reconnects a custom key store to its associated AWS CloudHSM cluster.

+ *

The custom key store must be connected before you can create customer master keys (CMKs) + * in the key store or use the CMKs it contains. You can disconnect and reconnect a custom key + * store at any time.

+ *

To connect a custom key store, its associated AWS CloudHSM cluster must have at least one active + * HSM. To get the number of active HSMs in a cluster, use the DescribeClusters operation. To add HSMs + * to the cluster, use the CreateHsm operation. Also, the + * kmsuser crypto + * user (CU) must not be logged into the cluster. This prevents AWS KMS from using this + * account to log in.

+ *

The connection process can take an extended amount of time to complete; up to 20 minutes. + * This operation starts the connection process, but it does not wait for it to complete. When it + * succeeds, this operation quickly returns an HTTP 200 response and a JSON object with no + * properties. However, this response does not indicate that the custom key store is connected. + * To get the connection state of the custom key store, use the DescribeCustomKeyStores operation.

+ *

During the connection process, AWS KMS finds the AWS CloudHSM cluster that is associated with the + * custom key store, creates the connection infrastructure, connects to the cluster, logs into + * the AWS CloudHSM client as the kmsuser CU, and rotates its password.

+ *

The ConnectCustomKeyStore operation might fail for various reasons. To find + * the reason, use the DescribeCustomKeyStores operation and see the + * ConnectionErrorCode in the response. For help interpreting the + * ConnectionErrorCode, see CustomKeyStoresListEntry.

+ *

To fix the failure, use the DisconnectCustomKeyStore operation to + * disconnect the custom key store, correct the error, use the UpdateCustomKeyStore operation if necessary, and then use + * ConnectCustomKeyStore again.

+ *

If you are having trouble connecting or disconnecting a custom key store, see Troubleshooting a Custom Key + * Store in the AWS Key Management Service Developer Guide.

+ */ export class ConnectCustomKeyStoreCommand extends $Command< ConnectCustomKeyStoreCommandInput, ConnectCustomKeyStoreCommandOutput, @@ -34,6 +63,9 @@ export class ConnectCustomKeyStoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/CreateAliasCommand.ts b/clients/client-kms/commands/CreateAliasCommand.ts index 37c91b249c457..85bd8ce951376 100644 --- a/clients/client-kms/commands/CreateAliasCommand.ts +++ b/clients/client-kms/commands/CreateAliasCommand.ts @@ -20,6 +20,72 @@ import { export type CreateAliasCommandInput = CreateAliasRequest; export type CreateAliasCommandOutput = __MetadataBearer; +/** + *

Creates a display name for a customer managed customer master key (CMK). You can use an + * alias to identify a CMK in cryptographic operations, such as Encrypt and GenerateDataKey. You can change the CMK associated with the alias at any + * time.

+ *

Aliases are easier to remember than key IDs. They can also help to simplify your + * applications. For example, if you use an alias in your code, you can change the CMK your code + * uses by associating a given alias with a different CMK.

+ *

To run the same code in multiple AWS regions, use an alias in your code, such as + * alias/ApplicationKey. Then, in each AWS Region, create an + * alias/ApplicationKey alias that is associated with a CMK in that Region. When + * you run your code, it uses the alias/ApplicationKey CMK for that AWS Region + * without any Region-specific code.

+ *

This operation does not return a response. To get the alias that you created, use the + * ListAliases operation.

+ * + *

To use aliases successfully, be aware of the following information.

+ *
    + *
  • + *

    Each alias points to only one CMK at a time, although a single CMK can have multiple + * aliases. The alias and its associated CMK must be in the same AWS account and Region. + *

    + *
  • + *
  • + *

    You can associate an alias with any customer managed CMK in the same AWS account and + * Region. However, you do not have permission to associate an alias with an AWS managed + * CMK or an AWS owned CMK.

    + *
  • + *
  • + *

    To change the CMK associated with an alias, use the UpdateAlias + * operation. The current CMK and the new CMK must be the same type (both symmetric or both + * asymmetric) and they must have the same key usage (ENCRYPT_DECRYPT or + * SIGN_VERIFY). This restriction prevents cryptographic errors in code that + * uses aliases.

    + *
  • + *
  • + *

    The alias name must begin with alias/ followed by a + * name, such as alias/ExampleAlias. It can contain only alphanumeric characters, + * forward slashes (/), underscores (_), and dashes (-). The alias name cannot begin with + * alias/aws/. The alias/aws/ prefix is reserved for AWS managed CMKs. + *

    + *
  • + *
  • + *

    The alias name must be unique within an AWS Region. However, you can use the same + * alias name in multiple Regions of the same AWS account. Each instance of the alias is + * associated with a CMK in its Region.

    + *
  • + *
  • + *

    After you create an alias, you cannot change its alias name. However, you can use the + * DeleteAlias operation to delete the alias and then create a new alias + * with the desired name.

    + *
  • + *
  • + *

    You can use an alias name or alias ARN to identify a CMK in AWS KMS cryptographic operations and in the DescribeKey operation. However, you cannot use + * alias names or alias ARNs in API operations that manage CMKs, such as DisableKey or GetKeyPolicy. For information about the + * valid CMK identifiers for each AWS KMS API operation, see the descriptions of the + * KeyId parameter in the API operation documentation.

    + *
  • + *
+ * + *

Because an alias is not a property of a CMK, you can delete and change the aliases of a + * CMK without affecting the CMK. Also, aliases do not appear in the response from the DescribeKey operation. To get the aliases and alias ARNs of CMKs in each AWS + * account and Region, use the ListAliases operation.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class CreateAliasCommand extends $Command< CreateAliasCommandInput, CreateAliasCommandOutput, @@ -34,6 +100,9 @@ export class CreateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/CreateCustomKeyStoreCommand.ts b/clients/client-kms/commands/CreateCustomKeyStoreCommand.ts index 599e87c77dddb..e8bcb3bf64e3b 100644 --- a/clients/client-kms/commands/CreateCustomKeyStoreCommand.ts +++ b/clients/client-kms/commands/CreateCustomKeyStoreCommand.ts @@ -20,6 +20,24 @@ import { export type CreateCustomKeyStoreCommandInput = CreateCustomKeyStoreRequest; export type CreateCustomKeyStoreCommandOutput = CreateCustomKeyStoreResponse & __MetadataBearer; +/** + *

Creates a custom key store that is associated with an AWS CloudHSM cluster that you own and + * manage.

+ *

This operation is part of the Custom Key Store feature feature in AWS KMS, which + * combines the convenience and extensive integration of AWS KMS with the isolation and control of a + * single-tenant key store.

+ *

Before you create the custom key store, you must assemble + * the required elements, including an AWS CloudHSM cluster that fulfills the requirements for a custom + * key store. For details about the required elements, see Assemble the Prerequisites + * in the AWS Key Management Service Developer Guide.

+ *

When the operation completes successfully, it returns the ID of the new custom key store. + * Before you can use your new custom key store, you need to use the ConnectCustomKeyStore operation to connect the new key store to its AWS CloudHSM + * cluster. Even if you are not going to use your custom key store immediately, you might want to + * connect it to verify that all settings are correct and then disconnect it until you are ready + * to use it.

+ *

For help with failures, see Troubleshooting a Custom Key Store in the + * AWS Key Management Service Developer Guide.

+ */ export class CreateCustomKeyStoreCommand extends $Command< CreateCustomKeyStoreCommandInput, CreateCustomKeyStoreCommandOutput, @@ -34,6 +52,9 @@ export class CreateCustomKeyStoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/CreateGrantCommand.ts b/clients/client-kms/commands/CreateGrantCommand.ts index b6997bbda7638..728e31b88ecc8 100644 --- a/clients/client-kms/commands/CreateGrantCommand.ts +++ b/clients/client-kms/commands/CreateGrantCommand.ts @@ -20,6 +20,50 @@ import { export type CreateGrantCommandInput = CreateGrantRequest; export type CreateGrantCommandOutput = CreateGrantResponse & __MetadataBearer; +/** + *

Adds a grant to a customer master key (CMK). The grant allows the grantee principal to use + * the CMK when the conditions specified in the grant are met. When setting permissions, grants + * are an alternative to key policies.

+ *

To create a grant that allows a cryptographic operation only when the request includes a particular + * encryption + * context, use the Constraints parameter. For details, see GrantConstraints.

+ *

You can create grants on symmetric and asymmetric CMKs. However, if the grant allows an + * operation that the CMK does not support, CreateGrant fails with a + * ValidationException.

+ * + *
    + *
  • + *

    Grants for symmetric CMKs cannot allow operations that are not supported for symmetric + * CMKs, including Sign, Verify, and GetPublicKey. (There are limited exceptions to this rule for legacy + * operations, but you should not create a grant for an operation that AWS KMS does not + * support.)

    + *
  • + *
  • + *

    Grants for asymmetric CMKs cannot allow operations that are not supported for + * asymmetric CMKs, including operations that generate data keys or data key pairs, + * or operations related to automatic key rotation, imported key material, or CMKs in custom key + * stores.

    + *
  • + *
  • + *

    Grants for asymmetric CMKs with a KeyUsage of + * ENCRYPT_DECRYPT cannot allow the Sign or Verify operations. Grants for asymmetric CMKs with a KeyUsage + * of SIGN_VERIFY cannot allow the Encrypt or Decrypt operations.

    + *
  • + *
  • + *

    Grants for asymmetric CMKs cannot include an encryption context grant constraint. An + * encryption context is not supported on asymmetric CMKs.

    + *
  • + *
+ *

For information about symmetric and asymmetric CMKs, see Using Symmetric and Asymmetric CMKs in the AWS Key Management Service Developer Guide.

+ *

To perform this operation on a CMK in a different AWS account, specify the key + * ARN in the value of the KeyId parameter. For more information about grants, see Grants in the + * + * AWS Key Management Service Developer Guide + * .

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class CreateGrantCommand extends $Command< CreateGrantCommandInput, CreateGrantCommandOutput, @@ -34,6 +78,9 @@ export class CreateGrantCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/CreateKeyCommand.ts b/clients/client-kms/commands/CreateKeyCommand.ts index 1e670ed94b5e7..65c7836090b86 100644 --- a/clients/client-kms/commands/CreateKeyCommand.ts +++ b/clients/client-kms/commands/CreateKeyCommand.ts @@ -17,6 +17,84 @@ import { export type CreateKeyCommandInput = CreateKeyRequest; export type CreateKeyCommandOutput = CreateKeyResponse & __MetadataBearer; +/** + *

Creates a unique customer managed customer master key (CMK) in your AWS + * account and Region. You cannot use this operation to create a CMK in a different AWS + * account.

+ * + *

You can use the CreateKey operation to create symmetric or asymmetric + * CMKs.

+ *
    + *
  • + *

    + * Symmetric CMKs contain a 256-bit symmetric key that + * never leaves AWS KMS unencrypted. To use the CMK, you must call AWS KMS. You can use a + * symmetric CMK to encrypt and decrypt small amounts of data, but they are typically used to + * generate data + * keys and data + * keys pairs. For details, see GenerateDataKey and + * GenerateDataKeyPair.

    + *
  • + *
  • + *

    + * Asymmetric CMKs can contain an RSA key pair or an + * Elliptic Curve (ECC) key pair. The private key in an asymmetric CMK never leaves AWS KMS + * unencrypted. However, you can use the GetPublicKey operation to download + * the public key so it can be used outside of AWS KMS. CMKs with RSA key pairs can be used to + * encrypt or decrypt data or sign and verify messages (but not both). CMKs with ECC key + * pairs can be used only to sign and verify messages.

    + *
  • + *
+ *

For information about symmetric and asymmetric CMKs, see Using Symmetric and Asymmetric CMKs in the AWS Key Management Service Developer Guide.

+ * + * + *

To create different types of CMKs, use the following guidance:

+ * + *
+ *
Asymmetric CMKs
+ *
+ *

To create an asymmetric CMK, use the CustomerMasterKeySpec parameter to + * specify the type of key material in the CMK. Then, use the KeyUsage + * parameter to determine whether the CMK will be used to encrypt and decrypt or sign and + * verify. You can't change these properties after the CMK is created.

+ *

+ *
+ *
Symmetric CMKs
+ *
+ *

When creating a symmetric CMK, you don't need to specify the + * CustomerMasterKeySpec or KeyUsage parameters. The default + * value for CustomerMasterKeySpec, SYMMETRIC_DEFAULT, and the + * default value for KeyUsage, ENCRYPT_DECRYPT, are the only + * valid values for symmetric CMKs.

+ *

+ *
+ *
Imported Key Material
+ *
+ *

To import your own key material, begin by creating a symmetric CMK with no key + * material. To do this, use the Origin parameter of CreateKey + * with a value of EXTERNAL. Next, use GetParametersForImport operation to get a public key and import token, and use the public key to encrypt + * your key material. Then, use ImportKeyMaterial with your import token + * to import the key material. For step-by-step instructions, see Importing Key Material in the + * AWS Key Management Service Developer Guide + * . You + * cannot import the key material into an asymmetric CMK.

+ *

+ *
+ *
Custom Key Stores
+ *
+ *

To create a symmetric CMK in a custom key store, use the + * CustomKeyStoreId parameter to specify the custom key store. You must also + * use the Origin parameter with a value of AWS_CLOUDHSM. The + * AWS CloudHSM cluster that is associated with the custom key store must have at least two active + * HSMs in different Availability Zones in the AWS Region.

+ *

You cannot create an asymmetric CMK in a custom key store. For information about + * custom key stores in AWS KMS see Using Custom Key Stores in + * the + * AWS Key Management Service Developer Guide + * .

+ *
+ *
+ */ export class CreateKeyCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +105,9 @@ export class CreateKeyCommand extends $Command, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DecryptCommand.ts b/clients/client-kms/commands/DecryptCommand.ts index af014514b5468..17545cc3d8d43 100644 --- a/clients/client-kms/commands/DecryptCommand.ts +++ b/clients/client-kms/commands/DecryptCommand.ts @@ -17,6 +17,59 @@ import { export type DecryptCommandInput = DecryptRequest; export type DecryptCommandOutput = DecryptResponse & __MetadataBearer; +/** + *

Decrypts ciphertext that was encrypted by a AWS KMS customer master key (CMK) using any of + * the following operations:

+ * + *

You can use this operation to decrypt ciphertext that was encrypted under a symmetric or + * asymmetric CMK. When the CMK is asymmetric, you must specify the CMK and the encryption + * algorithm that was used to encrypt the ciphertext. For information about symmetric and asymmetric CMKs, see Using Symmetric and Asymmetric CMKs in the AWS Key Management Service Developer Guide.

+ *

The Decrypt operation also decrypts ciphertext that was encrypted outside of AWS KMS by the + * public key in an AWS KMS asymmetric CMK. However, it cannot decrypt ciphertext produced by other + * libraries, such as the AWS Encryption + * SDK or Amazon S3 client-side encryption. These libraries return a ciphertext format that + * is incompatible with AWS KMS.

+ *

If the ciphertext was encrypted under a symmetric CMK, you do not need to specify the CMK + * or the encryption algorithm. AWS KMS can get this information from metadata that it adds to the + * symmetric ciphertext blob. However, if you prefer, you can specify the KeyId to + * ensure that a particular CMK is used to decrypt the ciphertext. If you specify a different CMK + * than the one used to encrypt the ciphertext, the Decrypt operation fails.

+ *

Whenever possible, use key policies to give users permission to call the Decrypt operation + * on a particular CMK, instead of using IAM policies. Otherwise, you might create an IAM user + * policy that gives the user Decrypt permission on all CMKs. This user could decrypt ciphertext + * that was encrypted by CMKs in other accounts if the key policy for the cross-account CMK + * permits it. If you must use an IAM policy for Decrypt permissions, limit the user + * to particular CMKs or particular trusted accounts.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class DecryptCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +80,9 @@ export class DecryptCommand extends $Command, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DeleteAliasCommand.ts b/clients/client-kms/commands/DeleteAliasCommand.ts index 80c99e174d2c6..6c7e15c93a455 100644 --- a/clients/client-kms/commands/DeleteAliasCommand.ts +++ b/clients/client-kms/commands/DeleteAliasCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteAliasCommandInput = DeleteAliasRequest; export type DeleteAliasCommandOutput = __MetadataBearer; +/** + *

Deletes the specified alias. You cannot perform this operation on an alias in a different AWS account.

+ *

Because an alias is not a property of a CMK, you can delete and change the aliases of a + * CMK without affecting the CMK. Also, aliases do not appear in the response from the DescribeKey operation. To get the aliases of all CMKs, use the ListAliases operation.

+ *

Each CMK can have multiple aliases. To change the alias of a CMK, use DeleteAlias to delete the current alias and CreateAlias to + * create a new alias. To associate an existing alias with a different customer master key (CMK), + * call UpdateAlias.

+ */ export class DeleteAliasCommand extends $Command< DeleteAliasCommandInput, DeleteAliasCommandOutput, @@ -34,6 +42,9 @@ export class DeleteAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DeleteCustomKeyStoreCommand.ts b/clients/client-kms/commands/DeleteCustomKeyStoreCommand.ts index a0bb29344e226..27768518845a0 100644 --- a/clients/client-kms/commands/DeleteCustomKeyStoreCommand.ts +++ b/clients/client-kms/commands/DeleteCustomKeyStoreCommand.ts @@ -20,6 +20,28 @@ import { export type DeleteCustomKeyStoreCommandInput = DeleteCustomKeyStoreRequest; export type DeleteCustomKeyStoreCommandOutput = DeleteCustomKeyStoreResponse & __MetadataBearer; +/** + *

Deletes a custom key store. This operation does not delete the AWS CloudHSM cluster that is + * associated with the custom key store, or affect any users or keys in the cluster.

+ *

The custom key store that you delete cannot contain any AWS KMS customer master keys (CMKs). Before + * deleting the key store, verify that you will never need to use any of the CMKs in the key + * store for any cryptographic operations. Then, use ScheduleKeyDeletion to + * delete the AWS KMS customer master keys (CMKs) from the key store. When the scheduled waiting + * period expires, the ScheduleKeyDeletion operation deletes the CMKs. Then it makes + * a best effort to delete the key material from the associated cluster. However, you might need + * to manually delete the orphaned key + * material from the cluster and its backups.

+ *

After all CMKs are deleted from AWS KMS, use DisconnectCustomKeyStore to + * disconnect the key store from AWS KMS. Then, you can delete the custom key store.

+ *

Instead of deleting the custom key store, consider using DisconnectCustomKeyStore to disconnect it from AWS KMS. While the key store is + * disconnected, you cannot create or use the CMKs in the key store. But, you do not need to + * delete CMKs and you can reconnect a disconnected custom key store at any time.

+ *

If the operation succeeds, it returns a JSON object with no + * properties.

+ *

This operation is part of the Custom Key Store feature feature in AWS KMS, which + * combines the convenience and extensive integration of AWS KMS with the isolation and control of a + * single-tenant key store.

+ */ export class DeleteCustomKeyStoreCommand extends $Command< DeleteCustomKeyStoreCommandInput, DeleteCustomKeyStoreCommandOutput, @@ -34,6 +56,9 @@ export class DeleteCustomKeyStoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DeleteImportedKeyMaterialCommand.ts b/clients/client-kms/commands/DeleteImportedKeyMaterialCommand.ts index 423e3c00e5540..1fd4075c9ba20 100644 --- a/clients/client-kms/commands/DeleteImportedKeyMaterialCommand.ts +++ b/clients/client-kms/commands/DeleteImportedKeyMaterialCommand.ts @@ -20,6 +20,20 @@ import { export type DeleteImportedKeyMaterialCommandInput = DeleteImportedKeyMaterialRequest; export type DeleteImportedKeyMaterialCommandOutput = __MetadataBearer; +/** + *

Deletes key material that you previously imported. This operation makes the specified + * customer master key (CMK) unusable. For more information about importing key material into + * AWS KMS, see Importing Key + * Material in the AWS Key Management Service Developer Guide. You cannot perform this operation on a CMK in a different AWS account.

+ *

When the specified CMK is in the PendingDeletion state, this operation does + * not change the CMK's state. Otherwise, it changes the CMK's state to + * PendingImport.

+ *

After you delete key material, you can use ImportKeyMaterial to reimport + * the same key material into the CMK.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class DeleteImportedKeyMaterialCommand extends $Command< DeleteImportedKeyMaterialCommandInput, DeleteImportedKeyMaterialCommandOutput, @@ -34,6 +48,9 @@ export class DeleteImportedKeyMaterialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DescribeCustomKeyStoresCommand.ts b/clients/client-kms/commands/DescribeCustomKeyStoresCommand.ts index 8598f00108d24..3dd75b90ee9ff 100644 --- a/clients/client-kms/commands/DescribeCustomKeyStoresCommand.ts +++ b/clients/client-kms/commands/DescribeCustomKeyStoresCommand.ts @@ -20,6 +20,28 @@ import { export type DescribeCustomKeyStoresCommandInput = DescribeCustomKeyStoresRequest; export type DescribeCustomKeyStoresCommandOutput = DescribeCustomKeyStoresResponse & __MetadataBearer; +/** + *

Gets information about custom key stores in the account and region.

+ *

This operation is part of the Custom Key Store feature feature in AWS KMS, which + * combines the convenience and extensive integration of AWS KMS with the isolation and control of a + * single-tenant key store.

+ *

By default, this operation returns information about all custom key + * stores in the account and region. To get only information about a particular custom key store, + * use either the CustomKeyStoreName or CustomKeyStoreId parameter (but + * not both).

+ *

To determine whether the custom key store is connected to its AWS CloudHSM cluster, use the + * ConnectionState element in the response. If an attempt to connect the custom + * key store failed, the ConnectionState value is FAILED and the + * ConnectionErrorCode element in the response indicates the cause of the failure. + * For help interpreting the ConnectionErrorCode, see CustomKeyStoresListEntry.

+ *

Custom key stores have a DISCONNECTED connection state if the key store has + * never been connected or you use the DisconnectCustomKeyStore operation to + * disconnect it. If your custom key store state is CONNECTED but you are having + * trouble using it, make sure that its associated AWS CloudHSM cluster is active and contains the + * minimum number of HSMs required for the operation, if any.

+ *

For help repairing your custom key store, see the Troubleshooting Custom Key Stores topic in the + * AWS Key Management Service Developer Guide.

+ */ export class DescribeCustomKeyStoresCommand extends $Command< DescribeCustomKeyStoresCommandInput, DescribeCustomKeyStoresCommandOutput, @@ -34,6 +56,9 @@ export class DescribeCustomKeyStoresCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DescribeKeyCommand.ts b/clients/client-kms/commands/DescribeKeyCommand.ts index 906abeac67765..ccbc693bdc836 100644 --- a/clients/client-kms/commands/DescribeKeyCommand.ts +++ b/clients/client-kms/commands/DescribeKeyCommand.ts @@ -20,6 +20,43 @@ import { export type DescribeKeyCommandInput = DescribeKeyRequest; export type DescribeKeyCommandOutput = DescribeKeyResponse & __MetadataBearer; +/** + *

Provides detailed information about a customer master key (CMK). You can run + * DescribeKey on a customer managed CMK or an AWS managed + * CMK.

+ *

This detailed information includes the key ARN, creation date (and deletion date, if + * applicable), the key state, and the origin and expiration date (if any) of the key material. + * For CMKs in custom key stores, it includes information about the custom key store, such as the + * key store ID and the AWS CloudHSM cluster ID. It includes fields, like KeySpec, that + * help you distinguish symmetric from asymmetric CMKs. It also provides information that is + * particularly important to asymmetric CMKs, such as the key usage (encryption or signing) and + * the encryption algorithms or signing algorithms that the CMK supports.

+ *

+ * DescribeKey does not return the following information:

+ *
    + *
  • + *

    Aliases associated with the CMK. To get this information, use ListAliases.

    + *
  • + *
  • + *

    Whether automatic key rotation is enabled on the CMK. To get this information, use + * GetKeyRotationStatus. Also, some key states prevent a CMK from being + * automatically rotated. For details, see How Automatic Key Rotation + * Works in AWS Key Management Service Developer Guide.

    + *
  • + *
  • + *

    Tags on the CMK. To get this information, use ListResourceTags.

    + *
  • + *
  • + *

    Key policies and grants on the CMK. To get this information, use GetKeyPolicy and ListGrants.

    + *
  • + *
+ *

If you call the DescribeKey operation on a predefined AWS + * alias, that is, an AWS alias with no key ID, AWS KMS creates an AWS managed CMK. + * Then, it associates the alias with the new CMK, and returns the KeyId and + * Arn of the new CMK in the response.

+ *

To perform this operation on a CMK in a different AWS account, specify + * the key ARN or alias ARN in the value of the KeyId parameter.

+ */ export class DescribeKeyCommand extends $Command< DescribeKeyCommandInput, DescribeKeyCommandOutput, @@ -34,6 +71,9 @@ export class DescribeKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DisableKeyCommand.ts b/clients/client-kms/commands/DisableKeyCommand.ts index 015f72979655b..6a55eaa07aa76 100644 --- a/clients/client-kms/commands/DisableKeyCommand.ts +++ b/clients/client-kms/commands/DisableKeyCommand.ts @@ -20,6 +20,17 @@ import { export type DisableKeyCommandInput = DisableKeyRequest; export type DisableKeyCommandOutput = __MetadataBearer; +/** + *

Sets the state of a customer master key (CMK) to disabled, thereby preventing its use for + * cryptographic operations. You cannot perform this operation on a CMK in a different AWS account.

+ *

For more information about how key state affects the use of a CMK, see How Key State Affects the Use of a + * Customer Master Key in the + * AWS Key Management Service Developer Guide + * .

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class DisableKeyCommand extends $Command< DisableKeyCommandInput, DisableKeyCommandOutput, @@ -34,6 +45,9 @@ export class DisableKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DisableKeyRotationCommand.ts b/clients/client-kms/commands/DisableKeyRotationCommand.ts index 96e43122232ee..b96b68fe8253e 100644 --- a/clients/client-kms/commands/DisableKeyRotationCommand.ts +++ b/clients/client-kms/commands/DisableKeyRotationCommand.ts @@ -20,6 +20,15 @@ import { export type DisableKeyRotationCommandInput = DisableKeyRotationRequest; export type DisableKeyRotationCommandOutput = __MetadataBearer; +/** + *

Disables automatic + * rotation of the key material for the specified symmetric customer master key + * (CMK).

+ *

You cannot enable automatic rotation of asymmetric CMKs, CMKs with imported key material, or CMKs in a custom key store. You cannot perform this operation on a CMK in a different AWS account.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class DisableKeyRotationCommand extends $Command< DisableKeyRotationCommandInput, DisableKeyRotationCommandOutput, @@ -34,6 +43,9 @@ export class DisableKeyRotationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/DisconnectCustomKeyStoreCommand.ts b/clients/client-kms/commands/DisconnectCustomKeyStoreCommand.ts index 1e0da287c055e..16f632759791e 100644 --- a/clients/client-kms/commands/DisconnectCustomKeyStoreCommand.ts +++ b/clients/client-kms/commands/DisconnectCustomKeyStoreCommand.ts @@ -20,6 +20,25 @@ import { export type DisconnectCustomKeyStoreCommandInput = DisconnectCustomKeyStoreRequest; export type DisconnectCustomKeyStoreCommandOutput = DisconnectCustomKeyStoreResponse & __MetadataBearer; +/** + *

Disconnects the custom key store from its associated AWS CloudHSM cluster. While a custom key + * store is disconnected, you can manage the custom key store and its customer master keys + * (CMKs), but you cannot create or use CMKs in the custom key store. You can reconnect the + * custom key store at any time.

+ * + *

While a custom key store is disconnected, all attempts to create customer master keys + * (CMKs) in the custom key store or to use existing CMKs in cryptographic operations will + * fail. This action can prevent users from storing and accessing sensitive data.

+ *
+ *

+ *

To find the connection state of a custom key store, use the DescribeCustomKeyStores operation. To reconnect a custom key store, use the + * ConnectCustomKeyStore operation.

+ *

If the operation succeeds, it returns a JSON object with no + * properties.

+ *

This operation is part of the Custom Key Store feature feature in AWS KMS, which + * combines the convenience and extensive integration of AWS KMS with the isolation and control of a + * single-tenant key store.

+ */ export class DisconnectCustomKeyStoreCommand extends $Command< DisconnectCustomKeyStoreCommandInput, DisconnectCustomKeyStoreCommandOutput, @@ -34,6 +53,9 @@ export class DisconnectCustomKeyStoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/EnableKeyCommand.ts b/clients/client-kms/commands/EnableKeyCommand.ts index 086f10d757fa4..7d4ed0d64fbd8 100644 --- a/clients/client-kms/commands/EnableKeyCommand.ts +++ b/clients/client-kms/commands/EnableKeyCommand.ts @@ -17,6 +17,13 @@ import { export type EnableKeyCommandInput = EnableKeyRequest; export type EnableKeyCommandOutput = __MetadataBearer; +/** + *

Sets the key state of a customer master key (CMK) to enabled. This allows you to use the + * CMK for cryptographic operations. You cannot perform this operation on a CMK in a different AWS account.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class EnableKeyCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +34,9 @@ export class EnableKeyCommand extends $Command, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/EnableKeyRotationCommand.ts b/clients/client-kms/commands/EnableKeyRotationCommand.ts index 9def8f8c8d53f..fc7a89f694dfa 100644 --- a/clients/client-kms/commands/EnableKeyRotationCommand.ts +++ b/clients/client-kms/commands/EnableKeyRotationCommand.ts @@ -20,6 +20,15 @@ import { export type EnableKeyRotationCommandInput = EnableKeyRotationRequest; export type EnableKeyRotationCommandOutput = __MetadataBearer; +/** + *

Enables automatic rotation + * of the key material for the specified symmetric customer master key (CMK). + * You cannot perform this operation on a CMK in a different AWS account.

+ *

You cannot enable automatic rotation of asymmetric CMKs, CMKs with imported key material, or CMKs in a custom key store.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class EnableKeyRotationCommand extends $Command< EnableKeyRotationCommandInput, EnableKeyRotationCommandOutput, @@ -34,6 +43,9 @@ export class EnableKeyRotationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/EncryptCommand.ts b/clients/client-kms/commands/EncryptCommand.ts index b77a858f4f681..006b901c30916 100644 --- a/clients/client-kms/commands/EncryptCommand.ts +++ b/clients/client-kms/commands/EncryptCommand.ts @@ -17,6 +17,109 @@ import { export type EncryptCommandInput = EncryptRequest; export type EncryptCommandOutput = EncryptResponse & __MetadataBearer; +/** + *

Encrypts plaintext into ciphertext by using a customer master key (CMK). The + * Encrypt operation has two primary use cases:

+ *
    + *
  • + *

    You can encrypt small amounts of arbitrary data, such as a personal identifier or + * database password, or other sensitive information.

    + *
  • + *
  • + *

    You can use the Encrypt operation to move encrypted data from one AWS + * Region to another. For example, in Region A, generate a data key and use the plaintext key to encrypt + * your data. Then, in Region A, use the Encrypt operation to encrypt the + * plaintext data key under a CMK in Region B. Now, you can move the encrypted data and the + * encrypted data key to Region B. When necessary, you can decrypt the encrypted data key and + * the encrypted data entirely within in Region B.

    + *
  • + *
+ * + *

You don't need to use the Encrypt operation to encrypt a data key. The GenerateDataKey and GenerateDataKeyPair operations return a + * plaintext data key and an encrypted copy of that data key.

+ * + *

When you encrypt data, you must specify a symmetric or asymmetric CMK to use in the + * encryption operation. The CMK must have a KeyUsage value of + * ENCRYPT_DECRYPT. To find the KeyUsage of a CMK, use the DescribeKey operation.

+ * + *

If you use a symmetric CMK, you can use an encryption context to add additional security + * to your encryption operation. If you specify an EncryptionContext when encrypting + * data, you must specify the same encryption context (a case-sensitive exact match) when + * decrypting the data. Otherwise, the request to decrypt fails with an + * InvalidCiphertextException. For more information, see Encryption + * Context in the AWS Key Management Service Developer Guide.

+ *

If you specify an asymmetric CMK, you must also specify the encryption algorithm. The + * algorithm must be compatible with the CMK type.

+ * + *

When you use an asymmetric CMK to encrypt or reencrypt data, be sure to record the CMK and encryption algorithm that you choose. You will be required to provide the same CMK and encryption algorithm when you decrypt the data. If the CMK and algorithm do not match the values used to encrypt the data, the decrypt operation fails.

+ *

You are not required to supply the CMK ID and encryption algorithm when you decrypt with symmetric CMKs because AWS KMS stores this information in the ciphertext blob. AWS KMS cannot store metadata in ciphertext generated with asymmetric keys. The standard format for asymmetric key ciphertext does not include configurable fields.

+ *
+ * + * + *

The maximum size of the data that you can encrypt varies with the type of CMK and the + * encryption algorithm that you choose.

+ *
    + *
  • + *

    Symmetric CMKs

    + *
      + *
    • + *

      + * SYMMETRIC_DEFAULT: 4096 bytes

      + *
    • + *
    + *
  • + *
  • + *

    + * RSA_2048 + *

    + *
      + *
    • + *

      + * RSAES_OAEP_SHA_1: 214 bytes

      + *
    • + *
    • + *

      + * RSAES_OAEP_SHA_256: 190 bytes

      + *
    • + *
    + *
  • + *
  • + *

    + * RSA_3072 + *

    + *
      + *
    • + *

      + * RSAES_OAEP_SHA_1: 342 bytes

      + *
    • + *
    • + *

      + * RSAES_OAEP_SHA_256: 318 bytes

      + *
    • + *
    + *
  • + *
  • + *

    + * RSA_4096 + *

    + *
      + *
    • + *

      + * RSAES_OAEP_SHA_1: 470 bytes

      + *
    • + *
    • + *

      + * RSAES_OAEP_SHA_256: 446 bytes

      + *
    • + *
    + *
  • + *
+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ *

To perform this operation on a CMK in a different AWS account, specify + * the key ARN or alias ARN in the value of the KeyId parameter.

+ */ export class EncryptCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +130,9 @@ export class EncryptCommand extends $Command, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GenerateDataKeyCommand.ts b/clients/client-kms/commands/GenerateDataKeyCommand.ts index 778a18fc3b064..ac44f3a6e7af6 100644 --- a/clients/client-kms/commands/GenerateDataKeyCommand.ts +++ b/clients/client-kms/commands/GenerateDataKeyCommand.ts @@ -20,6 +20,67 @@ import { export type GenerateDataKeyCommandInput = GenerateDataKeyRequest; export type GenerateDataKeyCommandOutput = GenerateDataKeyResponse & __MetadataBearer; +/** + *

Generates a unique symmetric data key for client-side encryption. This operation returns a + * plaintext copy of the data key and a copy that is encrypted under a customer master key (CMK) + * that you specify. You can use the plaintext key to encrypt your data outside of AWS KMS and + * store the encrypted data key with the encrypted data.

+ * + *

+ * GenerateDataKey returns a unique data key for each request. The bytes in the + * plaintext key are not related to the caller or the CMK.

+ * + *

To generate a data key, specify the symmetric CMK that will be used to encrypt the data + * key. You cannot use an asymmetric CMK to generate data keys. To get the type of your CMK, use + * the DescribeKey operation. You must also specify the length of the data key. + * Use either the KeySpec or NumberOfBytes parameters (but not both). + * For 128-bit and 256-bit data keys, use the KeySpec parameter.

+ * + *

To get only an encrypted copy of the data key, use GenerateDataKeyWithoutPlaintext. To generate an asymmetric data key pair, use + * the GenerateDataKeyPair or GenerateDataKeyPairWithoutPlaintext operation. To get a cryptographically secure + * random byte string, use GenerateRandom.

+ * + *

You can use the optional encryption context to add additional security to the encryption + * operation. If you specify an EncryptionContext, you must specify the same + * encryption context (a case-sensitive exact match) when decrypting the encrypted data key. + * Otherwise, the request to decrypt fails with an InvalidCiphertextException. For more information, see Encryption Context in the + * AWS Key Management Service Developer Guide.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ *

+ * How to use your data key + *

+ *

We recommend that you use the following pattern to encrypt data locally in your application. + * You can write your own code or use a client-side encryption library, such as the AWS Encryption SDK, the Amazon DynamoDB Encryption Client, or + * Amazon S3 + * client-side encryption to do these tasks for you.

+ *

To encrypt data outside of AWS KMS:

+ *
    + *
  1. + *

    Use the GenerateDataKey operation to get a data key.

    + *
  2. + *
  3. + *

    Use the plaintext data key (in the Plaintext field of the response) to + * encrypt your data outside of AWS KMS. Then erase the plaintext data key from memory.

    + *
  4. + *
  5. + *

    Store the encrypted data key (in the CiphertextBlob field of the + * response) with the encrypted data.

    + *
  6. + *
+ *

To decrypt data outside of AWS KMS:

+ *
    + *
  1. + *

    Use the Decrypt operation to decrypt the encrypted data key. The + * operation returns a plaintext copy of the data key.

    + *
  2. + *
  3. + *

    Use the plaintext data key to decrypt data outside of AWS KMS, then erase the plaintext + * data key from memory.

    + *
  4. + *
+ */ export class GenerateDataKeyCommand extends $Command< GenerateDataKeyCommandInput, GenerateDataKeyCommandOutput, @@ -34,6 +95,9 @@ export class GenerateDataKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GenerateDataKeyPairCommand.ts b/clients/client-kms/commands/GenerateDataKeyPairCommand.ts index ab1b3e6c53880..2c404a224a990 100644 --- a/clients/client-kms/commands/GenerateDataKeyPairCommand.ts +++ b/clients/client-kms/commands/GenerateDataKeyPairCommand.ts @@ -20,6 +20,42 @@ import { export type GenerateDataKeyPairCommandInput = GenerateDataKeyPairRequest; export type GenerateDataKeyPairCommandOutput = GenerateDataKeyPairResponse & __MetadataBearer; +/** + *

Generates a unique asymmetric data key pair. The GenerateDataKeyPair + * operation returns a plaintext public key, a plaintext private key, and a copy of the private + * key that is encrypted under the symmetric CMK you specify. You can use the data key pair to + * perform asymmetric cryptography outside of AWS KMS.

+ * + *

+ * GenerateDataKeyPair returns a unique data key pair for each request. The + * bytes in the keys are not related to the caller or the CMK that is used to encrypt the private + * key.

+ * + *

You can use the public key that GenerateDataKeyPair returns to encrypt data + * or verify a signature outside of AWS KMS. Then, store the encrypted private key with the data. + * When you are ready to decrypt data or sign a message, you can use the Decrypt operation to decrypt the encrypted private key.

+ * + *

To generate a data key pair, you must specify a symmetric customer master key (CMK) to + * encrypt the private key in a data key pair. You cannot use an asymmetric CMK or a CMK in a + * custom key store. To get the type and origin of your CMK, use the DescribeKey operation.

+ * + *

If you are using the data key pair to encrypt data, or for any operation where you don't + * immediately need a private key, consider using the GenerateDataKeyPairWithoutPlaintext operation. + * GenerateDataKeyPairWithoutPlaintext returns a plaintext public key and an + * encrypted private key, but omits the plaintext private key that you need only to decrypt + * ciphertext or sign a message. Later, when you need to decrypt the data or sign a message, use + * the Decrypt operation to decrypt the encrypted private key in the data key + * pair.

+ * + *

You can use the optional encryption context to add additional security to the encryption + * operation. If you specify an EncryptionContext, you must specify the same + * encryption context (a case-sensitive exact match) when decrypting the encrypted data key. + * Otherwise, the request to decrypt fails with an InvalidCiphertextException. For more information, see Encryption Context in the + * AWS Key Management Service Developer Guide.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class GenerateDataKeyPairCommand extends $Command< GenerateDataKeyPairCommandInput, GenerateDataKeyPairCommandOutput, @@ -34,6 +70,9 @@ export class GenerateDataKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GenerateDataKeyPairWithoutPlaintextCommand.ts b/clients/client-kms/commands/GenerateDataKeyPairWithoutPlaintextCommand.ts index 9222b4e9eaf44..a845d972c59d8 100644 --- a/clients/client-kms/commands/GenerateDataKeyPairWithoutPlaintextCommand.ts +++ b/clients/client-kms/commands/GenerateDataKeyPairWithoutPlaintextCommand.ts @@ -24,6 +24,33 @@ export type GenerateDataKeyPairWithoutPlaintextCommandInput = GenerateDataKeyPai export type GenerateDataKeyPairWithoutPlaintextCommandOutput = GenerateDataKeyPairWithoutPlaintextResponse & __MetadataBearer; +/** + *

Generates a unique asymmetric data key pair. The + * GenerateDataKeyPairWithoutPlaintext operation returns a plaintext public key + * and a copy of the private key that is encrypted under the symmetric CMK you specify. Unlike + * GenerateDataKeyPair, this operation does not return a plaintext private + * key.

+ *

To generate a data key pair, you must specify a symmetric customer master key (CMK) to + * encrypt the private key in the data key pair. You cannot use an asymmetric CMK or a CMK in a + * custom key store. To get the type and origin of your CMK, use the KeySpec field + * in the DescribeKey response.

+ *

You can use the public key that GenerateDataKeyPairWithoutPlaintext returns + * to encrypt data or verify a signature outside of AWS KMS. Then, store the encrypted private key + * with the data. When you are ready to decrypt data or sign a message, you can use the Decrypt operation to decrypt the encrypted private key.

+ *

+ * GenerateDataKeyPairWithoutPlaintext returns a unique data key pair for each + * request. The bytes in the key are not related to the caller or CMK that is used to encrypt the + * private key.

+ * + *

You can use the optional encryption context to add additional security to the encryption + * operation. If you specify an EncryptionContext, you must specify the same + * encryption context (a case-sensitive exact match) when decrypting the encrypted data key. + * Otherwise, the request to decrypt fails with an InvalidCiphertextException. For more information, see Encryption Context in the + * AWS Key Management Service Developer Guide.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class GenerateDataKeyPairWithoutPlaintextCommand extends $Command< GenerateDataKeyPairWithoutPlaintextCommandInput, GenerateDataKeyPairWithoutPlaintextCommandOutput, @@ -38,6 +65,9 @@ export class GenerateDataKeyPairWithoutPlaintextCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GenerateDataKeyWithoutPlaintextCommand.ts b/clients/client-kms/commands/GenerateDataKeyWithoutPlaintextCommand.ts index c02a271c8a887..9294a6e3a6a40 100644 --- a/clients/client-kms/commands/GenerateDataKeyWithoutPlaintextCommand.ts +++ b/clients/client-kms/commands/GenerateDataKeyWithoutPlaintextCommand.ts @@ -20,6 +20,43 @@ import { export type GenerateDataKeyWithoutPlaintextCommandInput = GenerateDataKeyWithoutPlaintextRequest; export type GenerateDataKeyWithoutPlaintextCommandOutput = GenerateDataKeyWithoutPlaintextResponse & __MetadataBearer; +/** + *

Generates a unique symmetric data key. This operation returns a data key that is encrypted + * under a customer master key (CMK) that you specify. To request an asymmetric data key pair, + * use the GenerateDataKeyPair or GenerateDataKeyPairWithoutPlaintext operations.

+ *

+ * GenerateDataKeyWithoutPlaintext is identical to the GenerateDataKey operation except that returns only the encrypted copy of the + * data key. This operation is useful for systems that need to encrypt data at some point, but + * not immediately. When you need to encrypt the data, you call the Decrypt + * operation on the encrypted copy of the key.

+ *

It's also useful in distributed systems with different levels of trust. For example, you + * might store encrypted data in containers. One component of your system creates new containers + * and stores an encrypted data key with each container. Then, a different component puts the + * data into the containers. That component first decrypts the data key, uses the plaintext data + * key to encrypt data, puts the encrypted data into the container, and then destroys the + * plaintext data key. In this system, the component that creates the containers never sees the + * plaintext data key.

+ *

+ * GenerateDataKeyWithoutPlaintext returns a unique data key for each request. + * The bytes in the keys are not related to the caller or CMK that is used to encrypt the private + * key.

+ * + *

To generate a data key, you must specify the symmetric customer master key (CMK) that is + * used to encrypt the data key. You cannot use an asymmetric CMK to generate a data key. To get the type + * of your CMK, use the DescribeKey operation.

+ * + *

If the operation succeeds, you will find the encrypted copy of the data key in the + * CiphertextBlob field.

+ * + *

You can use the optional encryption context to add additional security to the encryption + * operation. If you specify an EncryptionContext, you must specify the same + * encryption context (a case-sensitive exact match) when decrypting the encrypted data key. + * Otherwise, the request to decrypt fails with an InvalidCiphertextException. For more information, see Encryption Context in the + * AWS Key Management Service Developer Guide.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class GenerateDataKeyWithoutPlaintextCommand extends $Command< GenerateDataKeyWithoutPlaintextCommandInput, GenerateDataKeyWithoutPlaintextCommandOutput, @@ -34,6 +71,9 @@ export class GenerateDataKeyWithoutPlaintextCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GenerateRandomCommand.ts b/clients/client-kms/commands/GenerateRandomCommand.ts index 4809b75945bf1..925c060abc75f 100644 --- a/clients/client-kms/commands/GenerateRandomCommand.ts +++ b/clients/client-kms/commands/GenerateRandomCommand.ts @@ -20,6 +20,14 @@ import { export type GenerateRandomCommandInput = GenerateRandomRequest; export type GenerateRandomCommandOutput = GenerateRandomResponse & __MetadataBearer; +/** + *

Returns a random byte string that is cryptographically secure.

+ *

By default, the random byte string is generated in AWS KMS. To generate the byte string in + * the AWS CloudHSM cluster that is associated with a custom key store, specify the custom key store + * ID.

+ *

For more information about entropy and random number generation, see the AWS Key Management Service + * Cryptographic Details whitepaper.

+ */ export class GenerateRandomCommand extends $Command< GenerateRandomCommandInput, GenerateRandomCommandOutput, @@ -34,6 +42,9 @@ export class GenerateRandomCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GetKeyPolicyCommand.ts b/clients/client-kms/commands/GetKeyPolicyCommand.ts index c790bbbeeeacc..e8a31f65f2097 100644 --- a/clients/client-kms/commands/GetKeyPolicyCommand.ts +++ b/clients/client-kms/commands/GetKeyPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type GetKeyPolicyCommandInput = GetKeyPolicyRequest; export type GetKeyPolicyCommandOutput = GetKeyPolicyResponse & __MetadataBearer; +/** + *

Gets a key policy attached to the specified customer master key (CMK). + * You cannot perform this operation on a CMK in a different AWS account.

+ */ export class GetKeyPolicyCommand extends $Command< GetKeyPolicyCommandInput, GetKeyPolicyCommandOutput, @@ -34,6 +38,9 @@ export class GetKeyPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GetKeyRotationStatusCommand.ts b/clients/client-kms/commands/GetKeyRotationStatusCommand.ts index 340f3963a2582..bd873798e3eb4 100644 --- a/clients/client-kms/commands/GetKeyRotationStatusCommand.ts +++ b/clients/client-kms/commands/GetKeyRotationStatusCommand.ts @@ -20,6 +20,27 @@ import { export type GetKeyRotationStatusCommandInput = GetKeyRotationStatusRequest; export type GetKeyRotationStatusCommandOutput = GetKeyRotationStatusResponse & __MetadataBearer; +/** + *

Gets a Boolean value that indicates whether automatic rotation of the key material is + * enabled for the specified customer master key (CMK).

+ *

You cannot enable automatic rotation of asymmetric CMKs, CMKs with imported key material, or CMKs in a custom key store. The key rotation status for these CMKs is always false.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ *
    + *
  • + *

    Disabled: The key rotation status does not change when you disable a CMK. However, + * while the CMK is disabled, AWS KMS does not rotate the backing key.

    + *
  • + *
  • + *

    Pending deletion: While a CMK is pending deletion, its key rotation status is + * false and AWS KMS does not rotate the backing key. If you cancel the + * deletion, the original key rotation status is restored.

    + *
  • + *
+ *

To perform this operation on a CMK in a different AWS account, specify the key + * ARN in the value of the KeyId parameter.

+ */ export class GetKeyRotationStatusCommand extends $Command< GetKeyRotationStatusCommandInput, GetKeyRotationStatusCommandOutput, @@ -34,6 +55,9 @@ export class GetKeyRotationStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GetParametersForImportCommand.ts b/clients/client-kms/commands/GetParametersForImportCommand.ts index c7440969951d7..4dfeffa9593ee 100644 --- a/clients/client-kms/commands/GetParametersForImportCommand.ts +++ b/clients/client-kms/commands/GetParametersForImportCommand.ts @@ -20,6 +20,25 @@ import { export type GetParametersForImportCommandInput = GetParametersForImportRequest; export type GetParametersForImportCommandOutput = GetParametersForImportResponse & __MetadataBearer; +/** + *

Returns the items you need to import key material into a symmetric, customer managed + * customer master key (CMK). For more information about importing key material into AWS KMS, see + * Importing Key + * Material in the AWS Key Management Service Developer Guide.

+ *

This operation returns a public key and an import token. Use the public key to encrypt the + * symmetric key material. Store the import token to send with a subsequent ImportKeyMaterial request.

+ *

You must specify the key ID of the symmetric CMK into which you will import key material. + * This CMK's Origin must be EXTERNAL. You must also specify the + * wrapping algorithm and type of wrapping key (public key) that you will use to encrypt the key + * material. You cannot perform this operation on an asymmetric CMK or on any CMK in a different AWS account.

+ *

To import key material, you must use the public key and import token from the same + * response. These items are valid for 24 hours. The expiration date and time appear in the + * GetParametersForImport response. You cannot use an expired token in an ImportKeyMaterial request. If your key and token expire, send another + * GetParametersForImport request.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class GetParametersForImportCommand extends $Command< GetParametersForImportCommandInput, GetParametersForImportCommandOutput, @@ -34,6 +53,9 @@ export class GetParametersForImportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/GetPublicKeyCommand.ts b/clients/client-kms/commands/GetPublicKeyCommand.ts index 4e16be82b539b..72a100e34c153 100644 --- a/clients/client-kms/commands/GetPublicKeyCommand.ts +++ b/clients/client-kms/commands/GetPublicKeyCommand.ts @@ -20,6 +20,46 @@ import { export type GetPublicKeyCommandInput = GetPublicKeyRequest; export type GetPublicKeyCommandOutput = GetPublicKeyResponse & __MetadataBearer; +/** + *

Returns the public key of an asymmetric CMK. Unlike the private key of a asymmetric CMK, + * which never leaves AWS KMS unencrypted, callers with kms:GetPublicKey permission + * can download the public key of an asymmetric CMK. You can share the public key to allow others + * to encrypt messages and verify signatures outside of AWS KMS. For information about symmetric and asymmetric CMKs, see Using Symmetric and Asymmetric CMKs in the AWS Key Management Service Developer Guide.

+ *

You do not need to download the public key. Instead, you can use the public key within + * AWS KMS by calling the Encrypt, ReEncrypt, or Verify operations with the identifier of an asymmetric CMK. When you use the + * public key within AWS KMS, you benefit from the authentication, authorization, and logging that + * are part of every AWS KMS operation. You also reduce of risk of encrypting data that cannot be + * decrypted. These features are not effective outside of AWS KMS. For details, see Special Considerations + * for Downloading Public Keys.

+ *

To help you use the public key safely outside of AWS KMS, GetPublicKey returns + * important information about the public key in the response, including:

+ * + *
    + *
  • + *

    + * CustomerMasterKeySpec: The type of key material in the public key, such as + * RSA_4096 or ECC_NIST_P521.

    + *
  • + *
  • + *

    + * KeyUsage: Whether the key is used for encryption or signing.

    + *
  • + *
  • + *

    + * EncryptionAlgorithms or SigningAlgorithms: A list of the encryption algorithms or the signing + * algorithms for the key.

    + *
  • + *
+ *

Although AWS KMS cannot enforce these restrictions on external operations, it is crucial + * that you use this information to prevent the public key from being used improperly. For + * example, you can prevent a public signing key from being used encrypt data, or prevent a + * public key from being used with an encryption algorithm that is not supported by AWS KMS. You + * can also avoid errors, such as using the wrong signing algorithm in a verification + * operation.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class GetPublicKeyCommand extends $Command< GetPublicKeyCommandInput, GetPublicKeyCommandOutput, @@ -34,6 +74,9 @@ export class GetPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ImportKeyMaterialCommand.ts b/clients/client-kms/commands/ImportKeyMaterialCommand.ts index 154961ff9f73c..366665872063d 100644 --- a/clients/client-kms/commands/ImportKeyMaterialCommand.ts +++ b/clients/client-kms/commands/ImportKeyMaterialCommand.ts @@ -20,6 +20,53 @@ import { export type ImportKeyMaterialCommandInput = ImportKeyMaterialRequest; export type ImportKeyMaterialCommandOutput = ImportKeyMaterialResponse & __MetadataBearer; +/** + *

Imports key material into an existing symmetric AWS KMS customer master key (CMK) that was + * created without key material. After you successfully import key material into a CMK, you can + * reimport the same key material into that CMK, but you cannot import different key + * material.

+ *

You cannot perform this operation on an asymmetric CMK or on any CMK in a different AWS account. For more information about creating CMKs with no key material and + * then importing key material, see Importing Key Material in the + * AWS Key Management Service Developer Guide.

+ *

Before using this operation, call GetParametersForImport. Its response + * includes a public key and an import token. Use the public key to encrypt the key material. + * Then, submit the import token from the same GetParametersForImport + * response.

+ *

When calling this operation, you must specify the following values:

+ *
    + *
  • + *

    The key ID or key ARN of a CMK with no key material. Its Origin must be + * EXTERNAL.

    + *

    To create a CMK with no key material, call CreateKey and set the + * value of its Origin parameter to EXTERNAL. To get the + * Origin of a CMK, call DescribeKey.)

    + *
  • + *
  • + *

    The encrypted key material. To get the public key to encrypt the key material, call + * GetParametersForImport.

    + *
  • + *
  • + *

    The import token that GetParametersForImport returned. You must use + * a public key and token from the same GetParametersForImport response.

    + *
  • + *
  • + *

    Whether the key material expires and if so, when. If you set an expiration date, AWS KMS + * deletes the key material from the CMK on the specified date, and the CMK becomes unusable. + * To use the CMK again, you must reimport the same key material. The only way to change an + * expiration date is by reimporting the same key material and specifying a new expiration + * date.

    + *
  • + *
+ *

When this operation is successful, the key state of the CMK changes from + * PendingImport to Enabled, and you can use the CMK.

+ *

If this operation fails, use the exception to help determine the problem. If the error is + * related to the key material, the import token, or wrapping key, use GetParametersForImport to get a new public key and import token for the CMK and + * repeat the import procedure. For help, see How To Import Key + * Material in the AWS Key Management Service Developer Guide.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class ImportKeyMaterialCommand extends $Command< ImportKeyMaterialCommandInput, ImportKeyMaterialCommandOutput, @@ -34,6 +81,9 @@ export class ImportKeyMaterialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ListAliasesCommand.ts b/clients/client-kms/commands/ListAliasesCommand.ts index d173981f74247..3f9b430e1739a 100644 --- a/clients/client-kms/commands/ListAliasesCommand.ts +++ b/clients/client-kms/commands/ListAliasesCommand.ts @@ -20,6 +20,22 @@ import { export type ListAliasesCommandInput = ListAliasesRequest; export type ListAliasesCommandOutput = ListAliasesResponse & __MetadataBearer; +/** + *

Gets a list of aliases in the caller's AWS account and region. You cannot list aliases in + * other accounts. For more information about aliases, see CreateAlias.

+ *

By default, the ListAliases command returns all aliases in the account and region. To get + * only the aliases that point to a particular customer master key (CMK), use the + * KeyId parameter.

+ *

The ListAliases response can include aliases that you created and associated + * with your customer managed CMKs, and aliases that AWS created and associated with AWS managed + * CMKs in your account. You can recognize AWS aliases because their names have the format + * aws/, such as aws/dynamodb.

+ *

The response might also include aliases that have no TargetKeyId field. These + * are predefined aliases that AWS has created but has not yet associated with a CMK. Aliases + * that AWS creates in your account, including predefined aliases, do not count against your + * AWS KMS aliases + * quota.

+ */ export class ListAliasesCommand extends $Command< ListAliasesCommandInput, ListAliasesCommandOutput, @@ -34,6 +50,9 @@ export class ListAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ListGrantsCommand.ts b/clients/client-kms/commands/ListGrantsCommand.ts index eac49262a7c85..5e84c3f9321fb 100644 --- a/clients/client-kms/commands/ListGrantsCommand.ts +++ b/clients/client-kms/commands/ListGrantsCommand.ts @@ -20,6 +20,18 @@ import { export type ListGrantsCommandInput = ListGrantsRequest; export type ListGrantsCommandOutput = ListGrantsResponse & __MetadataBearer; +/** + *

Gets a list of all grants for the specified customer master key (CMK).

+ *

To perform this operation on a CMK in a different AWS account, specify the key + * ARN in the value of the KeyId parameter.

+ * + *

The GranteePrincipal field in the ListGrants response usually contains the + * user or role designated as the grantee principal in the grant. However, when the grantee + * principal in the grant is an AWS service, the GranteePrincipal field contains + * the service + * principal, which might represent several different grantee principals.

+ *
+ */ export class ListGrantsCommand extends $Command< ListGrantsCommandInput, ListGrantsCommandOutput, @@ -34,6 +46,9 @@ export class ListGrantsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ListKeyPoliciesCommand.ts b/clients/client-kms/commands/ListKeyPoliciesCommand.ts index b39c9a3d84487..f5ae0ca3218ec 100644 --- a/clients/client-kms/commands/ListKeyPoliciesCommand.ts +++ b/clients/client-kms/commands/ListKeyPoliciesCommand.ts @@ -20,6 +20,12 @@ import { export type ListKeyPoliciesCommandInput = ListKeyPoliciesRequest; export type ListKeyPoliciesCommandOutput = ListKeyPoliciesResponse & __MetadataBearer; +/** + *

Gets the names of the key policies that are attached to a customer master key (CMK). This + * operation is designed to get policy names that you can use in a GetKeyPolicy + * operation. However, the only valid policy name is default. + * You cannot perform this operation on a CMK in a different AWS account.

+ */ export class ListKeyPoliciesCommand extends $Command< ListKeyPoliciesCommandInput, ListKeyPoliciesCommandOutput, @@ -34,6 +40,9 @@ export class ListKeyPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ListKeysCommand.ts b/clients/client-kms/commands/ListKeysCommand.ts index fc4be52806e90..3782d0c1de807 100644 --- a/clients/client-kms/commands/ListKeysCommand.ts +++ b/clients/client-kms/commands/ListKeysCommand.ts @@ -17,6 +17,10 @@ import { export type ListKeysCommandInput = ListKeysRequest; export type ListKeysCommandOutput = ListKeysResponse & __MetadataBearer; +/** + *

Gets a list of all customer master keys (CMKs) in the caller's AWS account and + * Region.

+ */ export class ListKeysCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +31,9 @@ export class ListKeysCommand extends $Command, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ListResourceTagsCommand.ts b/clients/client-kms/commands/ListResourceTagsCommand.ts index d6b8856436273..22eae1c3b9869 100644 --- a/clients/client-kms/commands/ListResourceTagsCommand.ts +++ b/clients/client-kms/commands/ListResourceTagsCommand.ts @@ -20,6 +20,10 @@ import { export type ListResourceTagsCommandInput = ListResourceTagsRequest; export type ListResourceTagsCommandOutput = ListResourceTagsResponse & __MetadataBearer; +/** + *

Returns a list of all tags for the specified customer master key (CMK).

+ *

You cannot perform this operation on a CMK in a different AWS account.

+ */ export class ListResourceTagsCommand extends $Command< ListResourceTagsCommandInput, ListResourceTagsCommandOutput, @@ -34,6 +38,9 @@ export class ListResourceTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ListRetirableGrantsCommand.ts b/clients/client-kms/commands/ListRetirableGrantsCommand.ts index 68ab1375fe034..b27dc50aaa162 100644 --- a/clients/client-kms/commands/ListRetirableGrantsCommand.ts +++ b/clients/client-kms/commands/ListRetirableGrantsCommand.ts @@ -20,6 +20,12 @@ import { export type ListRetirableGrantsCommandInput = ListRetirableGrantsRequest; export type ListRetirableGrantsCommandOutput = ListGrantsResponse & __MetadataBearer; +/** + *

Returns a list of all grants for which the grant's RetiringPrincipal matches + * the one specified.

+ *

A typical use is to list all grants that you are able to retire. To retire a grant, use + * RetireGrant.

+ */ export class ListRetirableGrantsCommand extends $Command< ListRetirableGrantsCommandInput, ListRetirableGrantsCommandOutput, @@ -34,6 +40,9 @@ export class ListRetirableGrantsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/PutKeyPolicyCommand.ts b/clients/client-kms/commands/PutKeyPolicyCommand.ts index f79baf14bba53..e27a4f9195043 100644 --- a/clients/client-kms/commands/PutKeyPolicyCommand.ts +++ b/clients/client-kms/commands/PutKeyPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type PutKeyPolicyCommandInput = PutKeyPolicyRequest; export type PutKeyPolicyCommandOutput = __MetadataBearer; +/** + *

Attaches a key policy to the specified customer master key (CMK). + * You cannot perform this operation on a CMK in a different AWS account.

+ *

For more information about key policies, see Key Policies in the AWS Key Management Service Developer Guide.

+ */ export class PutKeyPolicyCommand extends $Command< PutKeyPolicyCommandInput, PutKeyPolicyCommandOutput, @@ -34,6 +39,9 @@ export class PutKeyPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ReEncryptCommand.ts b/clients/client-kms/commands/ReEncryptCommand.ts index fac3ddaa7da65..b422511b10cdc 100644 --- a/clients/client-kms/commands/ReEncryptCommand.ts +++ b/clients/client-kms/commands/ReEncryptCommand.ts @@ -17,6 +17,67 @@ import { export type ReEncryptCommandInput = ReEncryptRequest; export type ReEncryptCommandOutput = ReEncryptResponse & __MetadataBearer; +/** + *

Decrypts ciphertext and then reencrypts it entirely within AWS KMS. You can use this + * operation to change the customer master key (CMK) under which data is encrypted, such as when + * you manually rotate a + * CMK or change the CMK that protects a ciphertext. You can also use it to reencrypt ciphertext + * under the same CMK, such as to change the encryption context of a ciphertext.

+ *

The ReEncrypt operation can decrypt ciphertext that was encrypted by using an + * AWS KMS CMK in an AWS KMS operation, such as Encrypt or GenerateDataKey. It can also decrypt ciphertext that was encrypted by using the + * public key of an asymmetric CMK outside of AWS KMS. However, it cannot decrypt ciphertext + * produced by other libraries, such as the AWS Encryption SDK or Amazon S3 client-side encryption. + * These libraries return a ciphertext format that is incompatible with AWS KMS.

+ *

When you use the ReEncrypt operation, you need to provide information for the + * decrypt operation and the subsequent encrypt operation.

+ *
    + *
  • + *

    If your ciphertext was encrypted under an asymmetric CMK, you must identify the + * source CMK, that is, the CMK that encrypted the ciphertext. You + * must also supply the encryption algorithm that was used. This information is required to + * decrypt the data.

    + *
  • + *
  • + *

    It is optional, but you can specify a source CMK even when the ciphertext was + * encrypted under a symmetric CMK. This ensures that the ciphertext is decrypted only by + * using a particular CMK. If the CMK that you specify cannot decrypt the ciphertext, the + * ReEncrypt operation fails.

    + *
  • + *
  • + *

    To reencrypt the data, you must specify the destination CMK, that + * is, the CMK that re-encrypts the data after it is decrypted. You can select a symmetric or + * asymmetric CMK. If the destination CMK is an asymmetric CMK, you must also provide the + * encryption algorithm. The algorithm that you choose must be compatible with the + * CMK.

    + * + * + *

    When you use an asymmetric CMK to encrypt or reencrypt data, be sure to record the CMK and encryption algorithm that you choose. You will be required to provide the same CMK and encryption algorithm when you decrypt the data. If the CMK and algorithm do not match the values used to encrypt the data, the decrypt operation fails.

    + *

    You are not required to supply the CMK ID and encryption algorithm when you decrypt with symmetric CMKs because AWS KMS stores this information in the ciphertext blob. AWS KMS cannot store metadata in ciphertext generated with asymmetric keys. The standard format for asymmetric key ciphertext does not include configurable fields.

    + *
    + *
  • + *
+ * + * + *

Unlike other AWS KMS API operations, ReEncrypt callers must have two + * permissions:

+ *
    + *
  • + *

    + * kms:ReEncryptFrom permission on the source CMK

    + *
  • + *
  • + *

    + * kms:ReEncryptTo permission on the destination CMK

    + *
  • + *
+ *

To permit reencryption from or to a CMK, include the "kms:ReEncrypt*" + * permission in your key policy. This permission is + * automatically included in the key policy when you use the console to create a CMK. But you + * must include it manually when you create a CMK programmatically or when you use the PutKeyPolicy operation to set a key policy.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class ReEncryptCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +88,9 @@ export class ReEncryptCommand extends $Command, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/RetireGrantCommand.ts b/clients/client-kms/commands/RetireGrantCommand.ts index fab4c47eaaa60..4f551e204657d 100644 --- a/clients/client-kms/commands/RetireGrantCommand.ts +++ b/clients/client-kms/commands/RetireGrantCommand.ts @@ -20,6 +20,27 @@ import { export type RetireGrantCommandInput = RetireGrantRequest; export type RetireGrantCommandOutput = __MetadataBearer; +/** + *

Retires a grant. To clean up, you can retire a grant when you're done using it. You should + * revoke a grant when you intend to actively deny operations that depend on it. The following + * are permitted to call this API:

+ *
    + *
  • + *

    The AWS account (root user) under which the grant was created

    + *
  • + *
  • + *

    The RetiringPrincipal, if present in the grant

    + *
  • + *
  • + *

    The GranteePrincipal, if RetireGrant is an operation + * specified in the grant

    + *
  • + *
+ *

You must identify the grant to retire by its grant token or by a combination of the grant + * ID and the Amazon Resource Name (ARN) of the customer master key (CMK). A grant token is a + * unique variable-length base64-encoded string. A grant ID is a 64 character unique identifier + * of a grant. The CreateGrant operation returns both.

+ */ export class RetireGrantCommand extends $Command< RetireGrantCommandInput, RetireGrantCommandOutput, @@ -34,6 +55,9 @@ export class RetireGrantCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/RevokeGrantCommand.ts b/clients/client-kms/commands/RevokeGrantCommand.ts index 4c751f21f149c..928d7943a184d 100644 --- a/clients/client-kms/commands/RevokeGrantCommand.ts +++ b/clients/client-kms/commands/RevokeGrantCommand.ts @@ -20,6 +20,12 @@ import { export type RevokeGrantCommandInput = RevokeGrantRequest; export type RevokeGrantCommandOutput = __MetadataBearer; +/** + *

Revokes the specified grant for the specified customer master key (CMK). You can revoke a + * grant to actively deny operations that depend on it.

+ *

To perform this operation on a CMK in a different AWS account, specify the key + * ARN in the value of the KeyId parameter.

+ */ export class RevokeGrantCommand extends $Command< RevokeGrantCommandInput, RevokeGrantCommandOutput, @@ -34,6 +40,9 @@ export class RevokeGrantCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/ScheduleKeyDeletionCommand.ts b/clients/client-kms/commands/ScheduleKeyDeletionCommand.ts index 7e94cffa803f8..80df88e7029d9 100644 --- a/clients/client-kms/commands/ScheduleKeyDeletionCommand.ts +++ b/clients/client-kms/commands/ScheduleKeyDeletionCommand.ts @@ -20,6 +20,30 @@ import { export type ScheduleKeyDeletionCommandInput = ScheduleKeyDeletionRequest; export type ScheduleKeyDeletionCommandOutput = ScheduleKeyDeletionResponse & __MetadataBearer; +/** + *

Schedules the deletion of a customer master key (CMK). You may provide a waiting period, + * specified in days, before deletion occurs. If you do not provide a waiting period, the default + * period of 30 days is used. When this operation is successful, the key state of the CMK changes + * to PendingDeletion. Before the waiting period ends, you can use CancelKeyDeletion to cancel the deletion of the CMK. After the waiting period + * ends, AWS KMS deletes the CMK and all AWS KMS data associated with it, including all aliases that + * refer to it.

+ * + *

Deleting a CMK is a destructive and potentially dangerous operation. When a CMK is + * deleted, all data that was encrypted under the CMK is unrecoverable. To prevent the use of a + * CMK without deleting it, use DisableKey.

+ *
+ *

If you schedule deletion of a CMK from a custom key store, when the waiting period + * expires, ScheduleKeyDeletion deletes the CMK from AWS KMS. Then AWS KMS makes a best + * effort to delete the key material from the associated AWS CloudHSM cluster. However, you might need + * to manually delete the orphaned key + * material from the cluster and its backups.

+ *

You cannot perform this operation on a CMK in a different AWS account.

+ *

For more information about scheduling a CMK for deletion, see Deleting Customer Master Keys in the + * AWS Key Management Service Developer Guide.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class ScheduleKeyDeletionCommand extends $Command< ScheduleKeyDeletionCommandInput, ScheduleKeyDeletionCommandOutput, @@ -34,6 +58,9 @@ export class ScheduleKeyDeletionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/SignCommand.ts b/clients/client-kms/commands/SignCommand.ts index 396586d220309..6cb29d84f640c 100644 --- a/clients/client-kms/commands/SignCommand.ts +++ b/clients/client-kms/commands/SignCommand.ts @@ -17,6 +17,46 @@ import { export type SignCommandInput = SignRequest; export type SignCommandOutput = SignResponse & __MetadataBearer; +/** + *

Creates a digital + * signature for a message or message digest by using the private key in an asymmetric + * CMK. To verify the signature, use the Verify operation, or use the public + * key in the same asymmetric CMK outside of AWS KMS. For information about symmetric and asymmetric CMKs, see Using Symmetric and Asymmetric CMKs in the AWS Key Management Service Developer Guide.

+ *

Digital signatures are generated and verified by using asymmetric key pair, such as an RSA + * or ECC pair that is represented by an asymmetric customer master key (CMK). The key owner (or + * an authorized user) uses their private key to sign a message. Anyone with the public key can + * verify that the message was signed with that particular private key and that the message + * hasn't changed since it was signed.

+ *

To use the Sign operation, provide the following information:

+ *
    + *
  • + *

    Use the KeyId parameter to identify an asymmetric CMK with a + * KeyUsage value of SIGN_VERIFY. To get the + * KeyUsage value of a CMK, use the DescribeKey operation. + * The caller must have kms:Sign permission on the CMK.

    + *
  • + *
  • + *

    Use the Message parameter to specify the message or message digest to + * sign. You can submit messages of up to 4096 bytes. To sign a larger message, generate a + * hash digest of the message, and then provide the hash digest in the Message + * parameter. To indicate whether the message is a full message or a digest, use the + * MessageType parameter.

    + *
  • + *
  • + *

    Choose a signing algorithm that is compatible with the CMK.

    + *
  • + *
+ * + *

When signing a message, be sure to record the CMK and the signing algorithm. This + * information is required to verify the signature.

+ *
+ *

To verify the signature that this operation generates, use the Verify + * operation. Or use the GetPublicKey operation to download the public key and + * then use the public key to verify the signature outside of AWS KMS.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class SignCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +67,9 @@ export class SignCommand extends $Command, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/TagResourceCommand.ts b/clients/client-kms/commands/TagResourceCommand.ts index 31713700bb835..54737596bd762 100644 --- a/clients/client-kms/commands/TagResourceCommand.ts +++ b/clients/client-kms/commands/TagResourceCommand.ts @@ -20,6 +20,18 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds or edits tags for a customer master key (CMK). You cannot perform this operation on a CMK in a different AWS account.

+ *

Each tag consists of a tag key and a tag value. Tag keys and tag values are both required, + * but tag values can be empty (null) strings.

+ *

You can only use a tag key once for each CMK. If you use the tag key again, AWS KMS replaces + * the current tag value with the specified value.

+ *

For information about the rules that apply to tag keys and tag values, see User-Defined Tag Restrictions in the AWS Billing and Cost Management User + * Guide.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +46,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/UntagResourceCommand.ts b/clients/client-kms/commands/UntagResourceCommand.ts index 1db02a5642192..a902473219a2a 100644 --- a/clients/client-kms/commands/UntagResourceCommand.ts +++ b/clients/client-kms/commands/UntagResourceCommand.ts @@ -20,6 +20,15 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes the specified tags from the specified customer master key (CMK). + * You cannot perform this operation on a CMK in a different AWS account.

+ *

To remove a tag, specify the tag key. To change the tag value of an existing tag key, use + * TagResource.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +43,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/UpdateAliasCommand.ts b/clients/client-kms/commands/UpdateAliasCommand.ts index a5f0818aa28f8..736335b435386 100644 --- a/clients/client-kms/commands/UpdateAliasCommand.ts +++ b/clients/client-kms/commands/UpdateAliasCommand.ts @@ -20,6 +20,25 @@ import { export type UpdateAliasCommandInput = UpdateAliasRequest; export type UpdateAliasCommandOutput = __MetadataBearer; +/** + *

Associates an existing AWS KMS alias with a different customer master key (CMK). Each alias + * is associated with only one CMK at a time, although a CMK can have multiple aliases. The alias + * and the CMK must be in the same AWS account and region. You cannot perform this operation on an alias in a different AWS account.

+ *

The current and new CMK must be the same type (both symmetric or both asymmetric), and + * they must have the same key usage (ENCRYPT_DECRYPT or SIGN_VERIFY). + * This restriction prevents errors in code that uses aliases. If you must assign an alias to a + * different type of CMK, use DeleteAlias to delete the old alias and CreateAlias to create a new alias.

+ *

You cannot use UpdateAlias to change an alias name. To change an alias name, + * use DeleteAlias to delete the old alias and CreateAlias to + * create a new alias.

+ *

Because an alias is not a property of a CMK, you can create, update, and delete the + * aliases of a CMK without affecting the CMK. Also, aliases do not appear in the response from + * the DescribeKey operation. To get the aliases of all CMKs in the account, + * use the ListAliases operation.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class UpdateAliasCommand extends $Command< UpdateAliasCommandInput, UpdateAliasCommandOutput, @@ -34,6 +53,9 @@ export class UpdateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/UpdateCustomKeyStoreCommand.ts b/clients/client-kms/commands/UpdateCustomKeyStoreCommand.ts index e217ded0071c1..ff8de63e49a72 100644 --- a/clients/client-kms/commands/UpdateCustomKeyStoreCommand.ts +++ b/clients/client-kms/commands/UpdateCustomKeyStoreCommand.ts @@ -20,6 +20,46 @@ import { export type UpdateCustomKeyStoreCommandInput = UpdateCustomKeyStoreRequest; export type UpdateCustomKeyStoreCommandOutput = UpdateCustomKeyStoreResponse & __MetadataBearer; +/** + *

Changes the properties of a custom key store. Use the CustomKeyStoreId + * parameter to identify the custom key store you want to edit. Use the remaining parameters to + * change the properties of the custom key store.

+ *

You can only update a custom key store that is disconnected. To disconnect the custom key + * store, use DisconnectCustomKeyStore. To reconnect the custom key store after + * the update completes, use ConnectCustomKeyStore. To find the connection + * state of a custom key store, use the DescribeCustomKeyStores + * operation.

+ *

Use the parameters of UpdateCustomKeyStore to edit your keystore + * settings.

+ *
    + *
  • + *

    Use the NewCustomKeyStoreName parameter to change the + * friendly name of the custom key store to the value that you specify.

    + *

    + *
  • + *
  • + *

    Use the KeyStorePassword parameter tell AWS KMS the + * current password of the + * kmsuser crypto + * user (CU) in the associated AWS CloudHSM cluster. You can use this parameter to fix + * connection failures that occur when AWS KMS cannot log into the associated cluster + * because the kmsuser password has changed. This value does not change the + * password in the AWS CloudHSM cluster.

    + *

    + *
  • + *
  • + *

    Use the CloudHsmClusterId parameter to associate the + * custom key store with a different, but related, AWS CloudHSM cluster. You can use this parameter + * to repair a custom key store if its AWS CloudHSM cluster becomes corrupted or is deleted, or when + * you need to create or restore a cluster from a backup.

    + *
  • + *
+ *

If the operation succeeds, it returns a JSON object with no + * properties.

+ *

This operation is part of the Custom Key Store feature feature in AWS KMS, which + * combines the convenience and extensive integration of AWS KMS with the isolation and control of a + * single-tenant key store.

+ */ export class UpdateCustomKeyStoreCommand extends $Command< UpdateCustomKeyStoreCommandInput, UpdateCustomKeyStoreCommandOutput, @@ -34,6 +74,9 @@ export class UpdateCustomKeyStoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/UpdateKeyDescriptionCommand.ts b/clients/client-kms/commands/UpdateKeyDescriptionCommand.ts index b2cd0b58b1e72..26816b5efe728 100644 --- a/clients/client-kms/commands/UpdateKeyDescriptionCommand.ts +++ b/clients/client-kms/commands/UpdateKeyDescriptionCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateKeyDescriptionCommandInput = UpdateKeyDescriptionRequest; export type UpdateKeyDescriptionCommandOutput = __MetadataBearer; +/** + *

Updates the description of a customer master key (CMK). To see the description of a CMK, + * use DescribeKey.

+ *

You cannot perform this operation on a CMK in a different AWS account.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class UpdateKeyDescriptionCommand extends $Command< UpdateKeyDescriptionCommandInput, UpdateKeyDescriptionCommandOutput, @@ -34,6 +42,9 @@ export class UpdateKeyDescriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/commands/VerifyCommand.ts b/clients/client-kms/commands/VerifyCommand.ts index e9434fc282852..f58290324ecef 100644 --- a/clients/client-kms/commands/VerifyCommand.ts +++ b/clients/client-kms/commands/VerifyCommand.ts @@ -17,6 +17,31 @@ import { export type VerifyCommandInput = VerifyRequest; export type VerifyCommandOutput = VerifyResponse & __MetadataBearer; +/** + *

Verifies a digital signature that was generated by the Sign operation.

+ *

+ *

Verification confirms that an authorized user signed the message with the specified CMK + * and signing algorithm, and the message hasn't changed since it was signed. If the signature is + * verified, the value of the SignatureValid field in the response is + * True. If the signature verification fails, the Verify operation + * fails with an KMSInvalidSignatureException exception.

+ *

A digital signature is generated by using the private key in an asymmetric CMK. The + * signature is verified by using the public key in the same asymmetric CMK. + * For information about symmetric and asymmetric CMKs, see Using Symmetric and Asymmetric CMKs in the AWS Key Management Service Developer Guide.

+ *

To verify a digital signature, you can use the Verify operation. Specify the + * same asymmetric CMK, message, and signing algorithm that were used to produce the + * signature.

+ *

You can also verify the digital signature by using the public key of the CMK outside of + * AWS KMS. Use the GetPublicKey operation to download the public key in the + * asymmetric CMK and then use the public key to verify the signature outside of AWS KMS. The + * advantage of using the Verify operation is that it is performed within AWS KMS. As + * a result, it's easy to call, the operation is performed within the FIPS boundary, it is logged + * in AWS CloudTrail, and you can use key policy and IAM policy to determine who is authorized to use + * the CMK to verify signatures.

+ *

The CMK that you use for this operation must be in a compatible key state. For + * details, see How Key State Affects Use + * of a Customer Master Key in the AWS Key Management Service Developer Guide.

+ */ export class VerifyCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +52,9 @@ export class VerifyCommand extends $Command, configuration: KMSClientResolvedConfig, diff --git a/clients/client-kms/package.json b/clients/client-kms/package.json index fcce6a8ca7784..6aa9e7ffcbed9 100644 --- a/clients/client-kms/package.json +++ b/clients/client-kms/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Kms Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-kms/pagination/ListAliasesPaginator.ts b/clients/client-kms/pagination/ListAliasesPaginator.ts index f80a1f56e63de..5a0f23aea7769 100644 --- a/clients/client-kms/pagination/ListAliasesPaginator.ts +++ b/clients/client-kms/pagination/ListAliasesPaginator.ts @@ -4,6 +4,9 @@ import { ListAliasesCommand, ListAliasesCommandInput, ListAliasesCommandOutput } import { KMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KMSClient, input: ListAliasesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: KMS, input: ListAliasesCommandInput, diff --git a/clients/client-kms/pagination/ListGrantsPaginator.ts b/clients/client-kms/pagination/ListGrantsPaginator.ts index 1a8b3fa80ae36..ba8569f349f2c 100644 --- a/clients/client-kms/pagination/ListGrantsPaginator.ts +++ b/clients/client-kms/pagination/ListGrantsPaginator.ts @@ -4,6 +4,9 @@ import { ListGrantsCommand, ListGrantsCommandInput, ListGrantsCommandOutput } fr import { KMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KMSClient, input: ListGrantsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGrantsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: KMS, input: ListGrantsCommandInput, diff --git a/clients/client-kms/pagination/ListKeyPoliciesPaginator.ts b/clients/client-kms/pagination/ListKeyPoliciesPaginator.ts index b4039c5cdd011..b499e17603017 100644 --- a/clients/client-kms/pagination/ListKeyPoliciesPaginator.ts +++ b/clients/client-kms/pagination/ListKeyPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { KMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KMSClient, input: ListKeyPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListKeyPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: KMS, input: ListKeyPoliciesCommandInput, diff --git a/clients/client-kms/pagination/ListKeysPaginator.ts b/clients/client-kms/pagination/ListKeysPaginator.ts index c11b518f00d23..4ef167ae21820 100644 --- a/clients/client-kms/pagination/ListKeysPaginator.ts +++ b/clients/client-kms/pagination/ListKeysPaginator.ts @@ -4,6 +4,9 @@ import { ListKeysCommand, ListKeysCommandInput, ListKeysCommandOutput } from ".. import { KMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: KMSClient, input: ListKeysCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListKeysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: KMS, input: ListKeysCommandInput, diff --git a/clients/client-kms/runtimeConfig.browser.ts b/clients/client-kms/runtimeConfig.browser.ts index 86ec774f8bd6e..c620b26c54dd7 100644 --- a/clients/client-kms/runtimeConfig.browser.ts +++ b/clients/client-kms/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./KMSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-kms/runtimeConfig.native.ts b/clients/client-kms/runtimeConfig.native.ts index ca9f64796f4ec..f589702c79b6b 100644 --- a/clients/client-kms/runtimeConfig.native.ts +++ b/clients/client-kms/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./KMSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-kms/runtimeConfig.shared.ts b/clients/client-kms/runtimeConfig.shared.ts index 30a76fd5b37da..f1381d95b43e7 100644 --- a/clients/client-kms/runtimeConfig.shared.ts +++ b/clients/client-kms/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-11-01", disableHostPrefix: false, diff --git a/clients/client-kms/runtimeConfig.ts b/clients/client-kms/runtimeConfig.ts index 16117ad7b3c69..fa965e1a8bd2d 100644 --- a/clients/client-kms/runtimeConfig.ts +++ b/clients/client-kms/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./KMSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-kms/tsconfig.json b/clients/client-kms/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-kms/tsconfig.json +++ b/clients/client-kms/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-lakeformation/commands/BatchGrantPermissionsCommand.ts b/clients/client-lakeformation/commands/BatchGrantPermissionsCommand.ts index 887d1aa60f4e7..e37002dab620c 100644 --- a/clients/client-lakeformation/commands/BatchGrantPermissionsCommand.ts +++ b/clients/client-lakeformation/commands/BatchGrantPermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGrantPermissionsCommandInput = BatchGrantPermissionsRequest; export type BatchGrantPermissionsCommandOutput = BatchGrantPermissionsResponse & __MetadataBearer; +/** + *

Batch operation to grant permissions to the principal.

+ */ export class BatchGrantPermissionsCommand extends $Command< BatchGrantPermissionsCommandInput, BatchGrantPermissionsCommandOutput, @@ -34,6 +37,9 @@ export class BatchGrantPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/BatchRevokePermissionsCommand.ts b/clients/client-lakeformation/commands/BatchRevokePermissionsCommand.ts index 635f0669765a3..b6fd91f156aea 100644 --- a/clients/client-lakeformation/commands/BatchRevokePermissionsCommand.ts +++ b/clients/client-lakeformation/commands/BatchRevokePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchRevokePermissionsCommandInput = BatchRevokePermissionsRequest; export type BatchRevokePermissionsCommandOutput = BatchRevokePermissionsResponse & __MetadataBearer; +/** + *

Batch operation to revoke permissions from the principal.

+ */ export class BatchRevokePermissionsCommand extends $Command< BatchRevokePermissionsCommandInput, BatchRevokePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class BatchRevokePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/DeregisterResourceCommand.ts b/clients/client-lakeformation/commands/DeregisterResourceCommand.ts index dd26d48d2f2be..8372802acb6aa 100644 --- a/clients/client-lakeformation/commands/DeregisterResourceCommand.ts +++ b/clients/client-lakeformation/commands/DeregisterResourceCommand.ts @@ -20,6 +20,11 @@ import { export type DeregisterResourceCommandInput = DeregisterResourceRequest; export type DeregisterResourceCommandOutput = DeregisterResourceResponse & __MetadataBearer; +/** + *

Deregisters the resource as managed by the Data Catalog.

+ * + *

When you deregister a path, Lake Formation removes the path from the inline policy attached to your service-linked role.

+ */ export class DeregisterResourceCommand extends $Command< DeregisterResourceCommandInput, DeregisterResourceCommandOutput, @@ -34,6 +39,9 @@ export class DeregisterResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/DescribeResourceCommand.ts b/clients/client-lakeformation/commands/DescribeResourceCommand.ts index 831f3df595bf1..04ae9a956b7d2 100644 --- a/clients/client-lakeformation/commands/DescribeResourceCommand.ts +++ b/clients/client-lakeformation/commands/DescribeResourceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeResourceCommandInput = DescribeResourceRequest; export type DescribeResourceCommandOutput = DescribeResourceResponse & __MetadataBearer; +/** + *

Retrieves the current data access role for the given resource registered in AWS Lake Formation.

+ */ export class DescribeResourceCommand extends $Command< DescribeResourceCommandInput, DescribeResourceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/GetDataLakeSettingsCommand.ts b/clients/client-lakeformation/commands/GetDataLakeSettingsCommand.ts index fc79154650867..9f0d1bbdc17b2 100644 --- a/clients/client-lakeformation/commands/GetDataLakeSettingsCommand.ts +++ b/clients/client-lakeformation/commands/GetDataLakeSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetDataLakeSettingsCommandInput = GetDataLakeSettingsRequest; export type GetDataLakeSettingsCommandOutput = GetDataLakeSettingsResponse & __MetadataBearer; +/** + *

Retrieves the list of the data lake administrators of a Lake Formation-managed data lake.

+ */ export class GetDataLakeSettingsCommand extends $Command< GetDataLakeSettingsCommandInput, GetDataLakeSettingsCommandOutput, @@ -34,6 +37,9 @@ export class GetDataLakeSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/GetEffectivePermissionsForPathCommand.ts b/clients/client-lakeformation/commands/GetEffectivePermissionsForPathCommand.ts index 638e2a72814ea..d0ee4de39c659 100644 --- a/clients/client-lakeformation/commands/GetEffectivePermissionsForPathCommand.ts +++ b/clients/client-lakeformation/commands/GetEffectivePermissionsForPathCommand.ts @@ -20,6 +20,10 @@ import { export type GetEffectivePermissionsForPathCommandInput = GetEffectivePermissionsForPathRequest; export type GetEffectivePermissionsForPathCommandOutput = GetEffectivePermissionsForPathResponse & __MetadataBearer; +/** + *

Returns the Lake Formation permissions for a specified table or database resource located + * at a path in Amazon S3. GetEffectivePermissionsForPath will not return databases and tables if the catalog is encrypted.

+ */ export class GetEffectivePermissionsForPathCommand extends $Command< GetEffectivePermissionsForPathCommandInput, GetEffectivePermissionsForPathCommandOutput, @@ -34,6 +38,9 @@ export class GetEffectivePermissionsForPathCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/GrantPermissionsCommand.ts b/clients/client-lakeformation/commands/GrantPermissionsCommand.ts index 5a496e73290cb..671d4b6e4a586 100644 --- a/clients/client-lakeformation/commands/GrantPermissionsCommand.ts +++ b/clients/client-lakeformation/commands/GrantPermissionsCommand.ts @@ -20,6 +20,10 @@ import { export type GrantPermissionsCommandInput = GrantPermissionsRequest; export type GrantPermissionsCommandOutput = GrantPermissionsResponse & __MetadataBearer; +/** + *

Grants permissions to the principal to access metadata in the Data Catalog and data organized in underlying data storage such as Amazon S3.

+ *

For information about permissions, see Security and Access Control to Metadata and Data.

+ */ export class GrantPermissionsCommand extends $Command< GrantPermissionsCommandInput, GrantPermissionsCommandOutput, @@ -34,6 +38,9 @@ export class GrantPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/ListPermissionsCommand.ts b/clients/client-lakeformation/commands/ListPermissionsCommand.ts index b96215b44cc83..a03d06a6a3b1b 100644 --- a/clients/client-lakeformation/commands/ListPermissionsCommand.ts +++ b/clients/client-lakeformation/commands/ListPermissionsCommand.ts @@ -20,6 +20,11 @@ import { export type ListPermissionsCommandInput = ListPermissionsRequest; export type ListPermissionsCommandOutput = ListPermissionsResponse & __MetadataBearer; +/** + *

Returns a list of the principal permissions on the resource, filtered by the permissions of the caller. For example, if you are granted an ALTER permission, you are able to see only the principal permissions for ALTER.

+ *

This operation returns only those permissions that have been explicitly granted.

+ *

For information about permissions, see Security and Access Control to Metadata and Data.

+ */ export class ListPermissionsCommand extends $Command< ListPermissionsCommandInput, ListPermissionsCommandOutput, @@ -34,6 +39,9 @@ export class ListPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/ListResourcesCommand.ts b/clients/client-lakeformation/commands/ListResourcesCommand.ts index 0c3a1cd24cf6d..8e167ea226396 100644 --- a/clients/client-lakeformation/commands/ListResourcesCommand.ts +++ b/clients/client-lakeformation/commands/ListResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourcesCommandInput = ListResourcesRequest; export type ListResourcesCommandOutput = ListResourcesResponse & __MetadataBearer; +/** + *

Lists the resources registered to be managed by the Data Catalog.

+ */ export class ListResourcesCommand extends $Command< ListResourcesCommandInput, ListResourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/PutDataLakeSettingsCommand.ts b/clients/client-lakeformation/commands/PutDataLakeSettingsCommand.ts index 11373530b367e..770be86a67c00 100644 --- a/clients/client-lakeformation/commands/PutDataLakeSettingsCommand.ts +++ b/clients/client-lakeformation/commands/PutDataLakeSettingsCommand.ts @@ -20,6 +20,11 @@ import { export type PutDataLakeSettingsCommandInput = PutDataLakeSettingsRequest; export type PutDataLakeSettingsCommandOutput = PutDataLakeSettingsResponse & __MetadataBearer; +/** + *

Sets the list of data lake administrators who have admin privileges on all resources managed by Lake Formation. For more information on admin privileges, see Granting Lake Formation Permissions.

+ * + *

This API replaces the current list of data lake admins with the new list being passed. To add an admin, fetch the current list and add the new admin to that list and pass that list in this API.

+ */ export class PutDataLakeSettingsCommand extends $Command< PutDataLakeSettingsCommandInput, PutDataLakeSettingsCommandOutput, @@ -34,6 +39,9 @@ export class PutDataLakeSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/RegisterResourceCommand.ts b/clients/client-lakeformation/commands/RegisterResourceCommand.ts index 4777aa8c00ab1..22db14103837a 100644 --- a/clients/client-lakeformation/commands/RegisterResourceCommand.ts +++ b/clients/client-lakeformation/commands/RegisterResourceCommand.ts @@ -20,6 +20,24 @@ import { export type RegisterResourceCommandInput = RegisterResourceRequest; export type RegisterResourceCommandOutput = RegisterResourceResponse & __MetadataBearer; +/** + *

Registers the resource as managed by the Data Catalog.

+ * + *

To add or update data, Lake Formation needs read/write access to the chosen Amazon S3 path. Choose a role that you know has permission to do this, or choose the AWSServiceRoleForLakeFormationDataAccess service-linked role. When you register the first Amazon S3 path, the service-linked role and a new inline policy are created on your behalf. Lake Formation adds the first path to the inline policy and attaches it to the service-linked role. When you register subsequent paths, Lake Formation adds the path to the existing policy.

+ * + *

The following request registers a new location and gives AWS Lake Formation permission to use the service-linked role to access that location.

+ * + *

+ * ResourceArn = arn:aws:s3:::my-bucket + * UseServiceLinkedRole = true + *

+ * + *

If UseServiceLinkedRole is not set to true, you must provide or set the RoleArn:

+ * + *

+ * arn:aws:iam::12345:role/my-data-access-role + *

+ */ export class RegisterResourceCommand extends $Command< RegisterResourceCommandInput, RegisterResourceCommandOutput, @@ -34,6 +52,9 @@ export class RegisterResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/RevokePermissionsCommand.ts b/clients/client-lakeformation/commands/RevokePermissionsCommand.ts index 2ab704528cb03..e83f208fb8d46 100644 --- a/clients/client-lakeformation/commands/RevokePermissionsCommand.ts +++ b/clients/client-lakeformation/commands/RevokePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type RevokePermissionsCommandInput = RevokePermissionsRequest; export type RevokePermissionsCommandOutput = RevokePermissionsResponse & __MetadataBearer; +/** + *

Revokes permissions to the principal to access metadata in the Data Catalog and data organized in underlying data storage such as Amazon S3.

+ */ export class RevokePermissionsCommand extends $Command< RevokePermissionsCommandInput, RevokePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class RevokePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/commands/UpdateResourceCommand.ts b/clients/client-lakeformation/commands/UpdateResourceCommand.ts index 5159e1ed5b7d8..1c40163fc4a32 100644 --- a/clients/client-lakeformation/commands/UpdateResourceCommand.ts +++ b/clients/client-lakeformation/commands/UpdateResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateResourceCommandInput = UpdateResourceRequest; export type UpdateResourceCommandOutput = UpdateResourceResponse & __MetadataBearer; +/** + *

Updates the data access role used for vending access to the given (registered) resource in AWS Lake Formation.

+ */ export class UpdateResourceCommand extends $Command< UpdateResourceCommandInput, UpdateResourceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LakeFormationClientResolvedConfig, diff --git a/clients/client-lakeformation/package.json b/clients/client-lakeformation/package.json index de168cecc1142..f4a941bf3375d 100644 --- a/clients/client-lakeformation/package.json +++ b/clients/client-lakeformation/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Lakeformation Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-lakeformation/pagination/GetEffectivePermissionsForPathPaginator.ts b/clients/client-lakeformation/pagination/GetEffectivePermissionsForPathPaginator.ts index c999897e8ae03..178a9ee88c591 100644 --- a/clients/client-lakeformation/pagination/GetEffectivePermissionsForPathPaginator.ts +++ b/clients/client-lakeformation/pagination/GetEffectivePermissionsForPathPaginator.ts @@ -8,6 +8,9 @@ import { import { LakeFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LakeFormationClient, input: GetEffectivePermissionsForPathCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetEffectivePermissionsForPathCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LakeFormation, input: GetEffectivePermissionsForPathCommandInput, diff --git a/clients/client-lakeformation/pagination/ListPermissionsPaginator.ts b/clients/client-lakeformation/pagination/ListPermissionsPaginator.ts index 123e904f4684f..e781086e7b336 100644 --- a/clients/client-lakeformation/pagination/ListPermissionsPaginator.ts +++ b/clients/client-lakeformation/pagination/ListPermissionsPaginator.ts @@ -8,6 +8,9 @@ import { import { LakeFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LakeFormationClient, input: ListPermissionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPermissionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LakeFormation, input: ListPermissionsCommandInput, diff --git a/clients/client-lakeformation/pagination/ListResourcesPaginator.ts b/clients/client-lakeformation/pagination/ListResourcesPaginator.ts index b043f3118b83e..c0a1f8c3a933d 100644 --- a/clients/client-lakeformation/pagination/ListResourcesPaginator.ts +++ b/clients/client-lakeformation/pagination/ListResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { LakeFormationPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LakeFormationClient, input: ListResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LakeFormation, input: ListResourcesCommandInput, diff --git a/clients/client-lakeformation/runtimeConfig.browser.ts b/clients/client-lakeformation/runtimeConfig.browser.ts index 6ddaabe744d8f..57c6a65fb0b25 100644 --- a/clients/client-lakeformation/runtimeConfig.browser.ts +++ b/clients/client-lakeformation/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./LakeFormationClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-lakeformation/runtimeConfig.native.ts b/clients/client-lakeformation/runtimeConfig.native.ts index 81423d4383fda..0dbe680ce5b43 100644 --- a/clients/client-lakeformation/runtimeConfig.native.ts +++ b/clients/client-lakeformation/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./LakeFormationClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-lakeformation/runtimeConfig.shared.ts b/clients/client-lakeformation/runtimeConfig.shared.ts index 5da347336f5e6..6fd4175bb2e22 100644 --- a/clients/client-lakeformation/runtimeConfig.shared.ts +++ b/clients/client-lakeformation/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-03-31", disableHostPrefix: false, diff --git a/clients/client-lakeformation/runtimeConfig.ts b/clients/client-lakeformation/runtimeConfig.ts index ecdac0232ccd5..dc67071f583df 100644 --- a/clients/client-lakeformation/runtimeConfig.ts +++ b/clients/client-lakeformation/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./LakeFormationClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-lakeformation/tsconfig.json b/clients/client-lakeformation/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-lakeformation/tsconfig.json +++ b/clients/client-lakeformation/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-lambda/commands/AddLayerVersionPermissionCommand.ts b/clients/client-lambda/commands/AddLayerVersionPermissionCommand.ts index 3a2cb709fe0d7..9c054ad9b69fc 100644 --- a/clients/client-lambda/commands/AddLayerVersionPermissionCommand.ts +++ b/clients/client-lambda/commands/AddLayerVersionPermissionCommand.ts @@ -20,6 +20,14 @@ import { export type AddLayerVersionPermissionCommandInput = AddLayerVersionPermissionRequest; export type AddLayerVersionPermissionCommandOutput = AddLayerVersionPermissionResponse & __MetadataBearer; +/** + *

Adds permissions to the resource-based policy of a version of an AWS Lambda + * layer. Use this action to grant layer + * usage permission to other accounts. You can grant permission to a single account, all AWS accounts, or all + * accounts in an organization.

+ *

To revoke permission, call RemoveLayerVersionPermission with the statement ID that you + * specified when you added it.

+ */ export class AddLayerVersionPermissionCommand extends $Command< AddLayerVersionPermissionCommandInput, AddLayerVersionPermissionCommandOutput, @@ -34,6 +42,9 @@ export class AddLayerVersionPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/AddPermissionCommand.ts b/clients/client-lambda/commands/AddPermissionCommand.ts index 7b3ba8b9f7ad1..c17a515bef31c 100644 --- a/clients/client-lambda/commands/AddPermissionCommand.ts +++ b/clients/client-lambda/commands/AddPermissionCommand.ts @@ -20,6 +20,20 @@ import { export type AddPermissionCommandInput = AddPermissionRequest; export type AddPermissionCommandOutput = AddPermissionResponse & __MetadataBearer; +/** + *

Grants an AWS service or another account permission to use a function. You can apply the policy at the + * function level, or specify a qualifier to restrict access to a single version or alias. If you use a qualifier, + * the invoker must use the full Amazon Resource Name (ARN) of that version or alias to invoke the function.

+ * + *

To grant permission to another account, specify the account ID as the Principal. For AWS + * services, the principal is a domain-style identifier defined by the service, like s3.amazonaws.com or + * sns.amazonaws.com. For AWS services, you can also specify the ARN of the associated resource as the + * SourceArn. If you grant permission to a service principal without specifying the source, other + * accounts could potentially configure resources in their account to invoke your Lambda function.

+ * + *

This action adds a statement to a resource-based permissions policy for the function. For more information + * about function policies, see Lambda Function Policies.

+ */ export class AddPermissionCommand extends $Command< AddPermissionCommandInput, AddPermissionCommandOutput, @@ -34,6 +48,9 @@ export class AddPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/CreateAliasCommand.ts b/clients/client-lambda/commands/CreateAliasCommand.ts index 1363bb3d291c5..fa47d24a676f5 100644 --- a/clients/client-lambda/commands/CreateAliasCommand.ts +++ b/clients/client-lambda/commands/CreateAliasCommand.ts @@ -20,6 +20,14 @@ import { export type CreateAliasCommandInput = CreateAliasRequest; export type CreateAliasCommandOutput = AliasConfiguration & __MetadataBearer; +/** + *

Creates an alias for a + * Lambda function version. Use aliases to provide clients with a function identifier that you can update to invoke a + * different version.

+ *

You can also map an alias to split invocation requests between two versions. Use the + * RoutingConfig parameter to specify a second version and the percentage of invocation requests that + * it receives.

+ */ export class CreateAliasCommand extends $Command< CreateAliasCommandInput, CreateAliasCommandOutput, @@ -34,6 +42,9 @@ export class CreateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/CreateEventSourceMappingCommand.ts b/clients/client-lambda/commands/CreateEventSourceMappingCommand.ts index d322937b09df5..beccaf08c33a8 100644 --- a/clients/client-lambda/commands/CreateEventSourceMappingCommand.ts +++ b/clients/client-lambda/commands/CreateEventSourceMappingCommand.ts @@ -20,6 +20,60 @@ import { export type CreateEventSourceMappingCommandInput = CreateEventSourceMappingRequest; export type CreateEventSourceMappingCommandOutput = EventSourceMappingConfiguration & __MetadataBearer; +/** + *

Creates a mapping between an event source and an AWS Lambda function. Lambda reads items from the event source + * and triggers the function.

+ *

For details about each event source type, see the following topics.

+ * + *

The following error handling options are only available for stream sources (DynamoDB and Kinesis):

+ *
    + *
  • + *

    + * BisectBatchOnFunctionError - If the function returns an error, split the batch in two and retry.

    + *
  • + *
  • + *

    + * DestinationConfig - Send discarded records to an Amazon SQS queue or Amazon SNS topic.

    + *
  • + *
  • + *

    + * MaximumRecordAgeInSeconds - Discard records older than the specified age. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires

    + *
  • + *
  • + *

    + * MaximumRetryAttempts - Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires.

    + *
  • + *
  • + *

    + * ParallelizationFactor - Process multiple batches from each shard concurrently.

    + *
  • + *
+ */ export class CreateEventSourceMappingCommand extends $Command< CreateEventSourceMappingCommandInput, CreateEventSourceMappingCommandOutput, @@ -34,6 +88,9 @@ export class CreateEventSourceMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/CreateFunctionCommand.ts b/clients/client-lambda/commands/CreateFunctionCommand.ts index 3b71fe51ba4f0..ee5355edcf3b2 100644 --- a/clients/client-lambda/commands/CreateFunctionCommand.ts +++ b/clients/client-lambda/commands/CreateFunctionCommand.ts @@ -20,6 +20,37 @@ import { export type CreateFunctionCommandInput = CreateFunctionRequest; export type CreateFunctionCommandOutput = FunctionConfiguration & __MetadataBearer; +/** + *

Creates a Lambda function. To create a function, you need a deployment package and an execution role. The + * deployment package contains your function code. The execution role grants the function permission to use AWS + * services, such as Amazon CloudWatch Logs for log streaming and AWS X-Ray for request tracing.

+ * + *

When you create a function, Lambda provisions an instance of the function and its supporting resources. If + * your function connects to a VPC, this process can take a minute or so. During this time, you can't invoke or + * modify the function. The State, StateReason, and StateReasonCode fields in + * the response from GetFunctionConfiguration indicate when the function is ready to invoke. For + * more information, see Function + * States.

+ * + *

A function has an unpublished version, and can have published versions and aliases. The unpublished version + * changes when you update your function's code and configuration. A published version is a snapshot of your function + * code and configuration that can't be changed. An alias is a named resource that maps to a version, and can be + * changed to map to a different version. Use the Publish parameter to create version 1 of + * your function from its initial configuration.

+ * + *

The other parameters let you configure version-specific and function-level settings. You can modify + * version-specific settings later with UpdateFunctionConfiguration. Function-level settings apply + * to both the unpublished and published versions of the function, and include tags (TagResource) + * and per-function concurrency limits (PutFunctionConcurrency).

+ * + *

If another account or an AWS service invokes your function, use AddPermission to grant + * permission by creating a resource-based IAM policy. You can grant permissions at the function level, on a version, + * or on an alias.

+ * + *

To invoke your function directly, use Invoke. To invoke your function in response to events + * in other AWS services, create an event source mapping (CreateEventSourceMapping), or configure a + * function trigger in the other service. For more information, see Invoking Functions.

+ */ export class CreateFunctionCommand extends $Command< CreateFunctionCommandInput, CreateFunctionCommandOutput, @@ -34,6 +65,9 @@ export class CreateFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/DeleteAliasCommand.ts b/clients/client-lambda/commands/DeleteAliasCommand.ts index 7f0db6f986e13..750b34adad837 100644 --- a/clients/client-lambda/commands/DeleteAliasCommand.ts +++ b/clients/client-lambda/commands/DeleteAliasCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAliasCommandInput = DeleteAliasRequest; export type DeleteAliasCommandOutput = __MetadataBearer; +/** + *

Deletes a Lambda function alias.

+ */ export class DeleteAliasCommand extends $Command< DeleteAliasCommandInput, DeleteAliasCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/DeleteEventSourceMappingCommand.ts b/clients/client-lambda/commands/DeleteEventSourceMappingCommand.ts index cd00880f8e1cb..e2e7e356e3606 100644 --- a/clients/client-lambda/commands/DeleteEventSourceMappingCommand.ts +++ b/clients/client-lambda/commands/DeleteEventSourceMappingCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteEventSourceMappingCommandInput = DeleteEventSourceMappingRequest; export type DeleteEventSourceMappingCommandOutput = EventSourceMappingConfiguration & __MetadataBearer; +/** + *

Deletes an event source + * mapping. You can get the identifier of a mapping from the output of ListEventSourceMappings.

+ *

When you delete an event source mapping, it enters a Deleting state and might not be completely + * deleted for several seconds.

+ */ export class DeleteEventSourceMappingCommand extends $Command< DeleteEventSourceMappingCommandInput, DeleteEventSourceMappingCommandOutput, @@ -34,6 +40,9 @@ export class DeleteEventSourceMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/DeleteFunctionCommand.ts b/clients/client-lambda/commands/DeleteFunctionCommand.ts index 6c9f50b66b8a0..d7acecf8f3551 100644 --- a/clients/client-lambda/commands/DeleteFunctionCommand.ts +++ b/clients/client-lambda/commands/DeleteFunctionCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteFunctionCommandInput = DeleteFunctionRequest; export type DeleteFunctionCommandOutput = __MetadataBearer; +/** + *

Deletes a Lambda function. To delete a specific function version, use the Qualifier parameter. + * Otherwise, all versions and aliases are deleted.

+ * + *

To delete Lambda event source mappings that invoke a function, use DeleteEventSourceMapping. + * For AWS services and resources that invoke your function directly, delete the trigger in the service where you + * originally configured it.

+ */ export class DeleteFunctionCommand extends $Command< DeleteFunctionCommandInput, DeleteFunctionCommandOutput, @@ -34,6 +42,9 @@ export class DeleteFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/DeleteFunctionConcurrencyCommand.ts b/clients/client-lambda/commands/DeleteFunctionConcurrencyCommand.ts index 5c3537f1782b7..28abfe1191006 100644 --- a/clients/client-lambda/commands/DeleteFunctionConcurrencyCommand.ts +++ b/clients/client-lambda/commands/DeleteFunctionConcurrencyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFunctionConcurrencyCommandInput = DeleteFunctionConcurrencyRequest; export type DeleteFunctionConcurrencyCommandOutput = __MetadataBearer; +/** + *

Removes a concurrent execution limit from a function.

+ */ export class DeleteFunctionConcurrencyCommand extends $Command< DeleteFunctionConcurrencyCommandInput, DeleteFunctionConcurrencyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFunctionConcurrencyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/DeleteFunctionEventInvokeConfigCommand.ts b/clients/client-lambda/commands/DeleteFunctionEventInvokeConfigCommand.ts index ba1b3ec0af429..0b727027224af 100644 --- a/clients/client-lambda/commands/DeleteFunctionEventInvokeConfigCommand.ts +++ b/clients/client-lambda/commands/DeleteFunctionEventInvokeConfigCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteFunctionEventInvokeConfigCommandInput = DeleteFunctionEventInvokeConfigRequest; export type DeleteFunctionEventInvokeConfigCommandOutput = __MetadataBearer; +/** + *

Deletes the configuration for asynchronous invocation for a function, version, or alias.

+ *

To configure options for asynchronous invocation, use PutFunctionEventInvokeConfig.

+ */ export class DeleteFunctionEventInvokeConfigCommand extends $Command< DeleteFunctionEventInvokeConfigCommandInput, DeleteFunctionEventInvokeConfigCommandOutput, @@ -34,6 +38,9 @@ export class DeleteFunctionEventInvokeConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/DeleteLayerVersionCommand.ts b/clients/client-lambda/commands/DeleteLayerVersionCommand.ts index f6b7859c61591..196b92a3c9c35 100644 --- a/clients/client-lambda/commands/DeleteLayerVersionCommand.ts +++ b/clients/client-lambda/commands/DeleteLayerVersionCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteLayerVersionCommandInput = DeleteLayerVersionRequest; export type DeleteLayerVersionCommandOutput = __MetadataBearer; +/** + *

Deletes a version of an AWS Lambda + * layer. Deleted versions can no longer be viewed or added to functions. To avoid + * breaking functions, a copy of the version remains in Lambda until no functions refer to it.

+ */ export class DeleteLayerVersionCommand extends $Command< DeleteLayerVersionCommandInput, DeleteLayerVersionCommandOutput, @@ -34,6 +39,9 @@ export class DeleteLayerVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/DeleteProvisionedConcurrencyConfigCommand.ts b/clients/client-lambda/commands/DeleteProvisionedConcurrencyConfigCommand.ts index 2f702e2799d4c..5f37dbf8239f2 100644 --- a/clients/client-lambda/commands/DeleteProvisionedConcurrencyConfigCommand.ts +++ b/clients/client-lambda/commands/DeleteProvisionedConcurrencyConfigCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProvisionedConcurrencyConfigCommandInput = DeleteProvisionedConcurrencyConfigRequest; export type DeleteProvisionedConcurrencyConfigCommandOutput = __MetadataBearer; +/** + *

Deletes the provisioned concurrency configuration for a function.

+ */ export class DeleteProvisionedConcurrencyConfigCommand extends $Command< DeleteProvisionedConcurrencyConfigCommandInput, DeleteProvisionedConcurrencyConfigCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProvisionedConcurrencyConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetAccountSettingsCommand.ts b/clients/client-lambda/commands/GetAccountSettingsCommand.ts index 5ce04373b04d9..995b969c56212 100644 --- a/clients/client-lambda/commands/GetAccountSettingsCommand.ts +++ b/clients/client-lambda/commands/GetAccountSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetAccountSettingsCommandInput = GetAccountSettingsRequest; export type GetAccountSettingsCommandOutput = GetAccountSettingsResponse & __MetadataBearer; +/** + *

Retrieves details about your account's limits and usage in an AWS Region.

+ */ export class GetAccountSettingsCommand extends $Command< GetAccountSettingsCommandInput, GetAccountSettingsCommandOutput, @@ -34,6 +37,9 @@ export class GetAccountSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetAliasCommand.ts b/clients/client-lambda/commands/GetAliasCommand.ts index a48e410a5124c..9f54750755cd2 100644 --- a/clients/client-lambda/commands/GetAliasCommand.ts +++ b/clients/client-lambda/commands/GetAliasCommand.ts @@ -20,6 +20,9 @@ import { export type GetAliasCommandInput = GetAliasRequest; export type GetAliasCommandOutput = AliasConfiguration & __MetadataBearer; +/** + *

Returns details about a Lambda function alias.

+ */ export class GetAliasCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class GetAliasCommand extends $Command, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetEventSourceMappingCommand.ts b/clients/client-lambda/commands/GetEventSourceMappingCommand.ts index b57620ecb7a88..793479ae98b18 100644 --- a/clients/client-lambda/commands/GetEventSourceMappingCommand.ts +++ b/clients/client-lambda/commands/GetEventSourceMappingCommand.ts @@ -20,6 +20,10 @@ import { export type GetEventSourceMappingCommandInput = GetEventSourceMappingRequest; export type GetEventSourceMappingCommandOutput = EventSourceMappingConfiguration & __MetadataBearer; +/** + *

Returns details about an event source mapping. You can get the identifier of a mapping from the output of + * ListEventSourceMappings.

+ */ export class GetEventSourceMappingCommand extends $Command< GetEventSourceMappingCommandInput, GetEventSourceMappingCommandOutput, @@ -34,6 +38,9 @@ export class GetEventSourceMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetFunctionCommand.ts b/clients/client-lambda/commands/GetFunctionCommand.ts index 5cb2e3fd54bb2..2c0f7729fef63 100644 --- a/clients/client-lambda/commands/GetFunctionCommand.ts +++ b/clients/client-lambda/commands/GetFunctionCommand.ts @@ -20,6 +20,11 @@ import { export type GetFunctionCommandInput = GetFunctionRequest; export type GetFunctionCommandOutput = GetFunctionResponse & __MetadataBearer; +/** + *

Returns information about the function or function version, with a link to download the deployment package + * that's valid for 10 minutes. If you specify a function version, only details that are specific to that version are + * returned.

+ */ export class GetFunctionCommand extends $Command< GetFunctionCommandInput, GetFunctionCommandOutput, @@ -34,6 +39,9 @@ export class GetFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetFunctionConcurrencyCommand.ts b/clients/client-lambda/commands/GetFunctionConcurrencyCommand.ts index 3b9291f07cab1..eadf1e1668247 100644 --- a/clients/client-lambda/commands/GetFunctionConcurrencyCommand.ts +++ b/clients/client-lambda/commands/GetFunctionConcurrencyCommand.ts @@ -20,6 +20,10 @@ import { export type GetFunctionConcurrencyCommandInput = GetFunctionConcurrencyRequest; export type GetFunctionConcurrencyCommandOutput = GetFunctionConcurrencyResponse & __MetadataBearer; +/** + *

Returns details about the reserved concurrency configuration for a function. To set a concurrency limit for a + * function, use PutFunctionConcurrency.

+ */ export class GetFunctionConcurrencyCommand extends $Command< GetFunctionConcurrencyCommandInput, GetFunctionConcurrencyCommandOutput, @@ -34,6 +38,9 @@ export class GetFunctionConcurrencyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetFunctionConfigurationCommand.ts b/clients/client-lambda/commands/GetFunctionConfigurationCommand.ts index 00dd99545524c..3df3d4a16af4f 100644 --- a/clients/client-lambda/commands/GetFunctionConfigurationCommand.ts +++ b/clients/client-lambda/commands/GetFunctionConfigurationCommand.ts @@ -20,6 +20,11 @@ import { export type GetFunctionConfigurationCommandInput = GetFunctionConfigurationRequest; export type GetFunctionConfigurationCommandOutput = FunctionConfiguration & __MetadataBearer; +/** + *

Returns the version-specific settings of a Lambda function or version. The output includes only options that + * can vary between versions of a function. To modify these settings, use UpdateFunctionConfiguration.

+ *

To get all of a function's details, including function-level settings, use GetFunction.

+ */ export class GetFunctionConfigurationCommand extends $Command< GetFunctionConfigurationCommandInput, GetFunctionConfigurationCommandOutput, @@ -34,6 +39,9 @@ export class GetFunctionConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetFunctionEventInvokeConfigCommand.ts b/clients/client-lambda/commands/GetFunctionEventInvokeConfigCommand.ts index 631c962e1f8ee..0add198597b5f 100644 --- a/clients/client-lambda/commands/GetFunctionEventInvokeConfigCommand.ts +++ b/clients/client-lambda/commands/GetFunctionEventInvokeConfigCommand.ts @@ -20,6 +20,10 @@ import { export type GetFunctionEventInvokeConfigCommandInput = GetFunctionEventInvokeConfigRequest; export type GetFunctionEventInvokeConfigCommandOutput = FunctionEventInvokeConfig & __MetadataBearer; +/** + *

Retrieves the configuration for asynchronous invocation for a function, version, or alias.

+ *

To configure options for asynchronous invocation, use PutFunctionEventInvokeConfig.

+ */ export class GetFunctionEventInvokeConfigCommand extends $Command< GetFunctionEventInvokeConfigCommandInput, GetFunctionEventInvokeConfigCommandOutput, @@ -34,6 +38,9 @@ export class GetFunctionEventInvokeConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetLayerVersionByArnCommand.ts b/clients/client-lambda/commands/GetLayerVersionByArnCommand.ts index ce6e4e8b85f75..4f1a781e5c005 100644 --- a/clients/client-lambda/commands/GetLayerVersionByArnCommand.ts +++ b/clients/client-lambda/commands/GetLayerVersionByArnCommand.ts @@ -20,6 +20,11 @@ import { export type GetLayerVersionByArnCommandInput = GetLayerVersionByArnRequest; export type GetLayerVersionByArnCommandOutput = GetLayerVersionResponse & __MetadataBearer; +/** + *

Returns information about a version of an AWS Lambda + * layer, with a link to download the layer archive + * that's valid for 10 minutes.

+ */ export class GetLayerVersionByArnCommand extends $Command< GetLayerVersionByArnCommandInput, GetLayerVersionByArnCommandOutput, @@ -34,6 +39,9 @@ export class GetLayerVersionByArnCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetLayerVersionCommand.ts b/clients/client-lambda/commands/GetLayerVersionCommand.ts index a85ed8590546a..ca1f61a240612 100644 --- a/clients/client-lambda/commands/GetLayerVersionCommand.ts +++ b/clients/client-lambda/commands/GetLayerVersionCommand.ts @@ -20,6 +20,11 @@ import { export type GetLayerVersionCommandInput = GetLayerVersionRequest; export type GetLayerVersionCommandOutput = GetLayerVersionResponse & __MetadataBearer; +/** + *

Returns information about a version of an AWS Lambda + * layer, with a link to download the layer archive + * that's valid for 10 minutes.

+ */ export class GetLayerVersionCommand extends $Command< GetLayerVersionCommandInput, GetLayerVersionCommandOutput, @@ -34,6 +39,9 @@ export class GetLayerVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetLayerVersionPolicyCommand.ts b/clients/client-lambda/commands/GetLayerVersionPolicyCommand.ts index f134db763d1c9..199fe8f12c02c 100644 --- a/clients/client-lambda/commands/GetLayerVersionPolicyCommand.ts +++ b/clients/client-lambda/commands/GetLayerVersionPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type GetLayerVersionPolicyCommandInput = GetLayerVersionPolicyRequest; export type GetLayerVersionPolicyCommandOutput = GetLayerVersionPolicyResponse & __MetadataBearer; +/** + *

Returns the permission policy for a version of an AWS Lambda + * layer. For more information, see AddLayerVersionPermission.

+ */ export class GetLayerVersionPolicyCommand extends $Command< GetLayerVersionPolicyCommandInput, GetLayerVersionPolicyCommandOutput, @@ -34,6 +38,9 @@ export class GetLayerVersionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetPolicyCommand.ts b/clients/client-lambda/commands/GetPolicyCommand.ts index adf93f968b2e4..5839398443224 100644 --- a/clients/client-lambda/commands/GetPolicyCommand.ts +++ b/clients/client-lambda/commands/GetPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetPolicyCommandInput = GetPolicyRequest; export type GetPolicyCommandOutput = GetPolicyResponse & __MetadataBearer; +/** + *

Returns the resource-based IAM policy for a function, version, or alias.

+ */ export class GetPolicyCommand extends $Command< GetPolicyCommandInput, GetPolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/GetProvisionedConcurrencyConfigCommand.ts b/clients/client-lambda/commands/GetProvisionedConcurrencyConfigCommand.ts index 50b0ffa8a5e5b..3fd6b236a268c 100644 --- a/clients/client-lambda/commands/GetProvisionedConcurrencyConfigCommand.ts +++ b/clients/client-lambda/commands/GetProvisionedConcurrencyConfigCommand.ts @@ -20,6 +20,9 @@ import { export type GetProvisionedConcurrencyConfigCommandInput = GetProvisionedConcurrencyConfigRequest; export type GetProvisionedConcurrencyConfigCommandOutput = GetProvisionedConcurrencyConfigResponse & __MetadataBearer; +/** + *

Retrieves the provisioned concurrency configuration for a function's alias or version.

+ */ export class GetProvisionedConcurrencyConfigCommand extends $Command< GetProvisionedConcurrencyConfigCommandInput, GetProvisionedConcurrencyConfigCommandOutput, @@ -34,6 +37,9 @@ export class GetProvisionedConcurrencyConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/InvokeAsyncCommand.ts b/clients/client-lambda/commands/InvokeAsyncCommand.ts index ffb2699f6dc76..0bb3c458e2a41 100644 --- a/clients/client-lambda/commands/InvokeAsyncCommand.ts +++ b/clients/client-lambda/commands/InvokeAsyncCommand.ts @@ -22,6 +22,12 @@ export type InvokeAsyncCommandInput = Omit & { }; export type InvokeAsyncCommandOutput = InvokeAsyncResponse & __MetadataBearer; +/** + * + *

For asynchronous function invocation, use Invoke.

+ *
+ *

Invokes a function asynchronously.

+ */ export class InvokeAsyncCommand extends $Command< InvokeAsyncCommandInput, InvokeAsyncCommandOutput, @@ -36,6 +42,9 @@ export class InvokeAsyncCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/InvokeCommand.ts b/clients/client-lambda/commands/InvokeCommand.ts index 92d4666faffcb..841a99035529b 100644 --- a/clients/client-lambda/commands/InvokeCommand.ts +++ b/clients/client-lambda/commands/InvokeCommand.ts @@ -17,6 +17,35 @@ import { export type InvokeCommandInput = InvocationRequest; export type InvokeCommandOutput = InvocationResponse & __MetadataBearer; +/** + *

Invokes a Lambda function. You can invoke a function synchronously (and wait for the response), or + * asynchronously. To invoke a function asynchronously, set InvocationType to Event.

+ * + *

For synchronous invocation, + * details about the function response, including errors, are included in the response body and headers. For either + * invocation type, you can find more information in the execution log and trace.

+ * + *

When an error occurs, your function may be invoked multiple times. Retry behavior varies by error type, + * client, event source, and invocation type. For example, if you invoke a function asynchronously and it returns an + * error, Lambda executes the function up to two more times. For more information, see Retry Behavior.

+ * + *

For asynchronous invocation, + * Lambda adds events to a queue before sending them to your function. If your function does not have enough capacity + * to keep up with the queue, events may be lost. Occasionally, your function may receive the same event multiple + * times, even if no error occurs. To retain events that were not processed, configure your function with a dead-letter queue.

+ * + *

The status code in the API response doesn't reflect function errors. Error codes are reserved for errors that + * prevent your function from executing, such as permissions errors, limit errors, or issues with your function's code and configuration. + * For example, Lambda returns TooManyRequestsException if executing the function would cause you to + * exceed a concurrency limit at either the account level (ConcurrentInvocationLimitExceeded) or + * function level (ReservedFunctionConcurrentInvocationLimitExceeded).

+ * + *

For functions with a long timeout, your client might be disconnected during synchronous invocation while it + * waits for a response. Configure your HTTP client, SDK, firewall, proxy, or operating system to allow for long + * connections with timeout or keep-alive settings.

+ * + *

This operation requires permission for the lambda:InvokeFunction action.

+ */ export class InvokeCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +56,9 @@ export class InvokeCommand extends $Command, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListAliasesCommand.ts b/clients/client-lambda/commands/ListAliasesCommand.ts index ce6626819e808..3722e035ff36a 100644 --- a/clients/client-lambda/commands/ListAliasesCommand.ts +++ b/clients/client-lambda/commands/ListAliasesCommand.ts @@ -20,6 +20,10 @@ import { export type ListAliasesCommandInput = ListAliasesRequest; export type ListAliasesCommandOutput = ListAliasesResponse & __MetadataBearer; +/** + *

Returns a list of aliases + * for a Lambda function.

+ */ export class ListAliasesCommand extends $Command< ListAliasesCommandInput, ListAliasesCommandOutput, @@ -34,6 +38,9 @@ export class ListAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListEventSourceMappingsCommand.ts b/clients/client-lambda/commands/ListEventSourceMappingsCommand.ts index 7627312899c81..6397a64e847c3 100644 --- a/clients/client-lambda/commands/ListEventSourceMappingsCommand.ts +++ b/clients/client-lambda/commands/ListEventSourceMappingsCommand.ts @@ -20,6 +20,10 @@ import { export type ListEventSourceMappingsCommandInput = ListEventSourceMappingsRequest; export type ListEventSourceMappingsCommandOutput = ListEventSourceMappingsResponse & __MetadataBearer; +/** + *

Lists event source mappings. Specify an EventSourceArn to only show event source mappings for a + * single event source.

+ */ export class ListEventSourceMappingsCommand extends $Command< ListEventSourceMappingsCommandInput, ListEventSourceMappingsCommandOutput, @@ -34,6 +38,9 @@ export class ListEventSourceMappingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListFunctionEventInvokeConfigsCommand.ts b/clients/client-lambda/commands/ListFunctionEventInvokeConfigsCommand.ts index 523d61011c149..fd9e086dce552 100644 --- a/clients/client-lambda/commands/ListFunctionEventInvokeConfigsCommand.ts +++ b/clients/client-lambda/commands/ListFunctionEventInvokeConfigsCommand.ts @@ -20,6 +20,10 @@ import { export type ListFunctionEventInvokeConfigsCommandInput = ListFunctionEventInvokeConfigsRequest; export type ListFunctionEventInvokeConfigsCommandOutput = ListFunctionEventInvokeConfigsResponse & __MetadataBearer; +/** + *

Retrieves a list of configurations for asynchronous invocation for a function.

+ *

To configure options for asynchronous invocation, use PutFunctionEventInvokeConfig.

+ */ export class ListFunctionEventInvokeConfigsCommand extends $Command< ListFunctionEventInvokeConfigsCommandInput, ListFunctionEventInvokeConfigsCommandOutput, @@ -34,6 +38,9 @@ export class ListFunctionEventInvokeConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListFunctionsCommand.ts b/clients/client-lambda/commands/ListFunctionsCommand.ts index 58dc3c95d54d3..dfc9d62244d90 100644 --- a/clients/client-lambda/commands/ListFunctionsCommand.ts +++ b/clients/client-lambda/commands/ListFunctionsCommand.ts @@ -20,6 +20,12 @@ import { export type ListFunctionsCommandInput = ListFunctionsRequest; export type ListFunctionsCommandOutput = ListFunctionsResponse & __MetadataBearer; +/** + *

Returns a list of Lambda functions, with the version-specific configuration of each. Lambda returns up to 50 + * functions per call.

+ *

Set FunctionVersion to ALL to include all published versions of each function in + * addition to the unpublished version. To get more information about a function or version, use GetFunction.

+ */ export class ListFunctionsCommand extends $Command< ListFunctionsCommandInput, ListFunctionsCommandOutput, @@ -34,6 +40,9 @@ export class ListFunctionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListLayerVersionsCommand.ts b/clients/client-lambda/commands/ListLayerVersionsCommand.ts index 06225443e9ded..e45127d03921f 100644 --- a/clients/client-lambda/commands/ListLayerVersionsCommand.ts +++ b/clients/client-lambda/commands/ListLayerVersionsCommand.ts @@ -20,6 +20,11 @@ import { export type ListLayerVersionsCommandInput = ListLayerVersionsRequest; export type ListLayerVersionsCommandOutput = ListLayerVersionsResponse & __MetadataBearer; +/** + *

Lists the versions of an AWS Lambda + * layer. Versions that have been deleted aren't listed. Specify a runtime identifier to list only + * versions that indicate that they're compatible with that runtime.

+ */ export class ListLayerVersionsCommand extends $Command< ListLayerVersionsCommandInput, ListLayerVersionsCommandOutput, @@ -34,6 +39,9 @@ export class ListLayerVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListLayersCommand.ts b/clients/client-lambda/commands/ListLayersCommand.ts index ea6979c60dc44..1a4f4c11c2d51 100644 --- a/clients/client-lambda/commands/ListLayersCommand.ts +++ b/clients/client-lambda/commands/ListLayersCommand.ts @@ -20,6 +20,11 @@ import { export type ListLayersCommandInput = ListLayersRequest; export type ListLayersCommandOutput = ListLayersResponse & __MetadataBearer; +/** + *

Lists AWS Lambda + * layers and shows information about the latest version of each. Specify a runtime identifier to list only layers + * that indicate that they're compatible with that runtime.

+ */ export class ListLayersCommand extends $Command< ListLayersCommandInput, ListLayersCommandOutput, @@ -34,6 +39,9 @@ export class ListLayersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListProvisionedConcurrencyConfigsCommand.ts b/clients/client-lambda/commands/ListProvisionedConcurrencyConfigsCommand.ts index 9153940647b43..d7fb9d5a17024 100644 --- a/clients/client-lambda/commands/ListProvisionedConcurrencyConfigsCommand.ts +++ b/clients/client-lambda/commands/ListProvisionedConcurrencyConfigsCommand.ts @@ -24,6 +24,9 @@ export type ListProvisionedConcurrencyConfigsCommandInput = ListProvisionedConcu export type ListProvisionedConcurrencyConfigsCommandOutput = ListProvisionedConcurrencyConfigsResponse & __MetadataBearer; +/** + *

Retrieves a list of provisioned concurrency configurations for a function.

+ */ export class ListProvisionedConcurrencyConfigsCommand extends $Command< ListProvisionedConcurrencyConfigsCommandInput, ListProvisionedConcurrencyConfigsCommandOutput, @@ -38,6 +41,9 @@ export class ListProvisionedConcurrencyConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListTagsCommand.ts b/clients/client-lambda/commands/ListTagsCommand.ts index 518289c0c790f..c84b6aa6b841d 100644 --- a/clients/client-lambda/commands/ListTagsCommand.ts +++ b/clients/client-lambda/commands/ListTagsCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResponse & __MetadataBearer; +/** + *

Returns a function's tags. You can + * also view tags with GetFunction.

+ */ export class ListTagsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +34,9 @@ export class ListTagsCommand extends $Command, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/ListVersionsByFunctionCommand.ts b/clients/client-lambda/commands/ListVersionsByFunctionCommand.ts index 9bb352bbd85b8..e1828266c6209 100644 --- a/clients/client-lambda/commands/ListVersionsByFunctionCommand.ts +++ b/clients/client-lambda/commands/ListVersionsByFunctionCommand.ts @@ -20,6 +20,10 @@ import { export type ListVersionsByFunctionCommandInput = ListVersionsByFunctionRequest; export type ListVersionsByFunctionCommandOutput = ListVersionsByFunctionResponse & __MetadataBearer; +/** + *

Returns a list of versions, + * with the version-specific configuration of each. Lambda returns up to 50 versions per call.

+ */ export class ListVersionsByFunctionCommand extends $Command< ListVersionsByFunctionCommandInput, ListVersionsByFunctionCommandOutput, @@ -34,6 +38,9 @@ export class ListVersionsByFunctionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/PublishLayerVersionCommand.ts b/clients/client-lambda/commands/PublishLayerVersionCommand.ts index 4cb2601d059cd..634c96c7d5e8f 100644 --- a/clients/client-lambda/commands/PublishLayerVersionCommand.ts +++ b/clients/client-lambda/commands/PublishLayerVersionCommand.ts @@ -20,6 +20,12 @@ import { export type PublishLayerVersionCommandInput = PublishLayerVersionRequest; export type PublishLayerVersionCommandOutput = PublishLayerVersionResponse & __MetadataBearer; +/** + *

Creates an AWS Lambda + * layer from a ZIP archive. Each time you call PublishLayerVersion with the same + * layer name, a new version is created.

+ *

Add layers to your function with CreateFunction or UpdateFunctionConfiguration.

+ */ export class PublishLayerVersionCommand extends $Command< PublishLayerVersionCommandInput, PublishLayerVersionCommandOutput, @@ -34,6 +40,9 @@ export class PublishLayerVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/PublishVersionCommand.ts b/clients/client-lambda/commands/PublishVersionCommand.ts index 0e9f075a58091..b6dc03d104990 100644 --- a/clients/client-lambda/commands/PublishVersionCommand.ts +++ b/clients/client-lambda/commands/PublishVersionCommand.ts @@ -20,6 +20,17 @@ import { export type PublishVersionCommandInput = PublishVersionRequest; export type PublishVersionCommandOutput = FunctionConfiguration & __MetadataBearer; +/** + *

Creates a version from the + * current code and configuration of a function. Use versions to create a snapshot of your function code and + * configuration that doesn't change.

+ * + *

AWS Lambda doesn't publish a version if the function's configuration and code haven't changed since the last + * version. Use UpdateFunctionCode or UpdateFunctionConfiguration to update the + * function before publishing a version.

+ * + *

Clients can invoke versions directly or with an alias. To create an alias, use CreateAlias.

+ */ export class PublishVersionCommand extends $Command< PublishVersionCommandInput, PublishVersionCommandOutput, @@ -34,6 +45,9 @@ export class PublishVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/PutFunctionConcurrencyCommand.ts b/clients/client-lambda/commands/PutFunctionConcurrencyCommand.ts index a0eb6b3d705c0..02b4aa4cdf207 100644 --- a/clients/client-lambda/commands/PutFunctionConcurrencyCommand.ts +++ b/clients/client-lambda/commands/PutFunctionConcurrencyCommand.ts @@ -20,6 +20,17 @@ import { export type PutFunctionConcurrencyCommandInput = PutFunctionConcurrencyRequest; export type PutFunctionConcurrencyCommandOutput = Concurrency & __MetadataBearer; +/** + *

Sets the maximum number of simultaneous executions for a function, and reserves capacity for that concurrency + * level.

+ *

Concurrency settings apply to the function as a whole, including all published versions and the unpublished + * version. Reserving concurrency both ensures that your function has capacity to process the specified number of + * events simultaneously, and prevents it from scaling beyond that level. Use GetFunction to see + * the current setting for a function.

+ *

Use GetAccountSettings to see your Regional concurrency limit. You can reserve concurrency + * for as many functions as you like, as long as you leave at least 100 simultaneous executions unreserved for + * functions that aren't configured with a per-function limit. For more information, see Managing Concurrency.

+ */ export class PutFunctionConcurrencyCommand extends $Command< PutFunctionConcurrencyCommandInput, PutFunctionConcurrencyCommandOutput, @@ -34,6 +45,9 @@ export class PutFunctionConcurrencyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/PutFunctionEventInvokeConfigCommand.ts b/clients/client-lambda/commands/PutFunctionEventInvokeConfigCommand.ts index 61059a9242ff4..bb90c2dd4f9c4 100644 --- a/clients/client-lambda/commands/PutFunctionEventInvokeConfigCommand.ts +++ b/clients/client-lambda/commands/PutFunctionEventInvokeConfigCommand.ts @@ -20,6 +20,19 @@ import { export type PutFunctionEventInvokeConfigCommandInput = PutFunctionEventInvokeConfigRequest; export type PutFunctionEventInvokeConfigCommandOutput = FunctionEventInvokeConfig & __MetadataBearer; +/** + *

Configures options for asynchronous + * invocation on a function, version, or alias. If a configuration already exists for a function, version, + * or alias, this operation overwrites it. If you exclude any settings, they are removed. To set one option without + * affecting existing settings for other options, use UpdateFunctionEventInvokeConfig.

+ *

By default, Lambda retries an asynchronous invocation twice if the function returns an error. It retains + * events in a queue for up to six hours. When an event fails all processing attempts or stays in the asynchronous + * invocation queue for too long, Lambda discards it. To retain discarded events, configure a dead-letter queue with + * UpdateFunctionConfiguration.

+ *

To send an invocation record to a queue, topic, function, or event bus, specify a destination. You can configure separate destinations for successful invocations (on-success) and events + * that fail all processing attempts (on-failure). You can configure destinations in addition to or instead of a + * dead-letter queue.

+ */ export class PutFunctionEventInvokeConfigCommand extends $Command< PutFunctionEventInvokeConfigCommandInput, PutFunctionEventInvokeConfigCommandOutput, @@ -34,6 +47,9 @@ export class PutFunctionEventInvokeConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/PutProvisionedConcurrencyConfigCommand.ts b/clients/client-lambda/commands/PutProvisionedConcurrencyConfigCommand.ts index f0c651f0f3250..501bfab533912 100644 --- a/clients/client-lambda/commands/PutProvisionedConcurrencyConfigCommand.ts +++ b/clients/client-lambda/commands/PutProvisionedConcurrencyConfigCommand.ts @@ -20,6 +20,9 @@ import { export type PutProvisionedConcurrencyConfigCommandInput = PutProvisionedConcurrencyConfigRequest; export type PutProvisionedConcurrencyConfigCommandOutput = PutProvisionedConcurrencyConfigResponse & __MetadataBearer; +/** + *

Adds a provisioned concurrency configuration to a function's alias or version.

+ */ export class PutProvisionedConcurrencyConfigCommand extends $Command< PutProvisionedConcurrencyConfigCommandInput, PutProvisionedConcurrencyConfigCommandOutput, @@ -34,6 +37,9 @@ export class PutProvisionedConcurrencyConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/RemoveLayerVersionPermissionCommand.ts b/clients/client-lambda/commands/RemoveLayerVersionPermissionCommand.ts index 2cadf4174bbf3..b83df8b910a8c 100644 --- a/clients/client-lambda/commands/RemoveLayerVersionPermissionCommand.ts +++ b/clients/client-lambda/commands/RemoveLayerVersionPermissionCommand.ts @@ -20,6 +20,11 @@ import { export type RemoveLayerVersionPermissionCommandInput = RemoveLayerVersionPermissionRequest; export type RemoveLayerVersionPermissionCommandOutput = __MetadataBearer; +/** + *

Removes a statement from the permissions policy for a version of an AWS Lambda + * layer. For more information, see + * AddLayerVersionPermission.

+ */ export class RemoveLayerVersionPermissionCommand extends $Command< RemoveLayerVersionPermissionCommandInput, RemoveLayerVersionPermissionCommandOutput, @@ -34,6 +39,9 @@ export class RemoveLayerVersionPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/RemovePermissionCommand.ts b/clients/client-lambda/commands/RemovePermissionCommand.ts index 6b8124f3c210e..0e02ad40a7a2f 100644 --- a/clients/client-lambda/commands/RemovePermissionCommand.ts +++ b/clients/client-lambda/commands/RemovePermissionCommand.ts @@ -20,6 +20,10 @@ import { export type RemovePermissionCommandInput = RemovePermissionRequest; export type RemovePermissionCommandOutput = __MetadataBearer; +/** + *

Revokes function-use permission from an AWS service or another account. You can get the ID of the statement + * from the output of GetPolicy.

+ */ export class RemovePermissionCommand extends $Command< RemovePermissionCommandInput, RemovePermissionCommandOutput, @@ -34,6 +38,9 @@ export class RemovePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/TagResourceCommand.ts b/clients/client-lambda/commands/TagResourceCommand.ts index 210483319517a..f696a442ff91a 100644 --- a/clients/client-lambda/commands/TagResourceCommand.ts +++ b/clients/client-lambda/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds tags to a function.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/UntagResourceCommand.ts b/clients/client-lambda/commands/UntagResourceCommand.ts index dbffd8cf76a81..cf151831ca8bc 100644 --- a/clients/client-lambda/commands/UntagResourceCommand.ts +++ b/clients/client-lambda/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes tags from a function.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/UpdateAliasCommand.ts b/clients/client-lambda/commands/UpdateAliasCommand.ts index 33789e8c1a78e..de843816dc565 100644 --- a/clients/client-lambda/commands/UpdateAliasCommand.ts +++ b/clients/client-lambda/commands/UpdateAliasCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAliasCommandInput = UpdateAliasRequest; export type UpdateAliasCommandOutput = AliasConfiguration & __MetadataBearer; +/** + *

Updates the configuration of a Lambda function alias.

+ */ export class UpdateAliasCommand extends $Command< UpdateAliasCommandInput, UpdateAliasCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/UpdateEventSourceMappingCommand.ts b/clients/client-lambda/commands/UpdateEventSourceMappingCommand.ts index 8198608e77ec3..0a3e5af4857e1 100644 --- a/clients/client-lambda/commands/UpdateEventSourceMappingCommand.ts +++ b/clients/client-lambda/commands/UpdateEventSourceMappingCommand.ts @@ -20,6 +20,33 @@ import { export type UpdateEventSourceMappingCommandInput = UpdateEventSourceMappingRequest; export type UpdateEventSourceMappingCommandOutput = EventSourceMappingConfiguration & __MetadataBearer; +/** + *

Updates an event source mapping. You can change the function that AWS Lambda invokes, or pause invocation and + * resume later from the same location.

+ *

The following error handling options are only available for stream sources (DynamoDB and Kinesis):

+ *
    + *
  • + *

    + * BisectBatchOnFunctionError - If the function returns an error, split the batch in two and retry.

    + *
  • + *
  • + *

    + * DestinationConfig - Send discarded records to an Amazon SQS queue or Amazon SNS topic.

    + *
  • + *
  • + *

    + * MaximumRecordAgeInSeconds - Discard records older than the specified age. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires

    + *
  • + *
  • + *

    + * MaximumRetryAttempts - Discard records after the specified number of retries. The default value is infinite (-1). When set to infinite (-1), failed records are retried until the record expires.

    + *
  • + *
  • + *

    + * ParallelizationFactor - Process multiple batches from each shard concurrently.

    + *
  • + *
+ */ export class UpdateEventSourceMappingCommand extends $Command< UpdateEventSourceMappingCommandInput, UpdateEventSourceMappingCommandOutput, @@ -34,6 +61,9 @@ export class UpdateEventSourceMappingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/UpdateFunctionCodeCommand.ts b/clients/client-lambda/commands/UpdateFunctionCodeCommand.ts index ba8722918e015..ca45f6672c308 100644 --- a/clients/client-lambda/commands/UpdateFunctionCodeCommand.ts +++ b/clients/client-lambda/commands/UpdateFunctionCodeCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateFunctionCodeCommandInput = UpdateFunctionCodeRequest; export type UpdateFunctionCodeCommandOutput = FunctionConfiguration & __MetadataBearer; +/** + *

Updates a Lambda function's code.

+ * + *

The function's code is locked when you publish a version. You can't modify the code of a published version, + * only the unpublished version.

+ */ export class UpdateFunctionCodeCommand extends $Command< UpdateFunctionCodeCommandInput, UpdateFunctionCodeCommandOutput, @@ -34,6 +40,9 @@ export class UpdateFunctionCodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/UpdateFunctionConfigurationCommand.ts b/clients/client-lambda/commands/UpdateFunctionConfigurationCommand.ts index 39b3da18773ed..d6427d426bcc3 100644 --- a/clients/client-lambda/commands/UpdateFunctionConfigurationCommand.ts +++ b/clients/client-lambda/commands/UpdateFunctionConfigurationCommand.ts @@ -20,6 +20,23 @@ import { export type UpdateFunctionConfigurationCommandInput = UpdateFunctionConfigurationRequest; export type UpdateFunctionConfigurationCommandOutput = FunctionConfiguration & __MetadataBearer; +/** + *

Modify the version-specific settings of a Lambda function.

+ * + *

When you update a function, Lambda provisions an instance of the function and its supporting resources. If + * your function connects to a VPC, this process can take a minute. During this time, you can't modify the function, + * but you can still invoke it. The LastUpdateStatus, LastUpdateStatusReason, and + * LastUpdateStatusReasonCode fields in the response from GetFunctionConfiguration + * indicate when the update is complete and the function is processing events with the new configuration. For more + * information, see Function + * States.

+ * + *

These settings can vary between versions of a function and are locked when you publish a version. You can't + * modify the configuration of a published version, only the unpublished version.

+ * + *

To configure function concurrency, use PutFunctionConcurrency. To grant invoke permissions + * to an account or AWS service, use AddPermission.

+ */ export class UpdateFunctionConfigurationCommand extends $Command< UpdateFunctionConfigurationCommandInput, UpdateFunctionConfigurationCommandOutput, @@ -34,6 +51,9 @@ export class UpdateFunctionConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/commands/UpdateFunctionEventInvokeConfigCommand.ts b/clients/client-lambda/commands/UpdateFunctionEventInvokeConfigCommand.ts index 54cf336a0bf28..d7b6d9033658a 100644 --- a/clients/client-lambda/commands/UpdateFunctionEventInvokeConfigCommand.ts +++ b/clients/client-lambda/commands/UpdateFunctionEventInvokeConfigCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateFunctionEventInvokeConfigCommandInput = UpdateFunctionEventInvokeConfigRequest; export type UpdateFunctionEventInvokeConfigCommandOutput = FunctionEventInvokeConfig & __MetadataBearer; +/** + *

Updates the configuration for asynchronous invocation for a function, version, or alias.

+ *

To configure options for asynchronous invocation, use PutFunctionEventInvokeConfig.

+ */ export class UpdateFunctionEventInvokeConfigCommand extends $Command< UpdateFunctionEventInvokeConfigCommandInput, UpdateFunctionEventInvokeConfigCommandOutput, @@ -34,6 +38,9 @@ export class UpdateFunctionEventInvokeConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, diff --git a/clients/client-lambda/package.json b/clients/client-lambda/package.json index b977902696bf7..1b8295abc6eef 100644 --- a/clients/client-lambda/package.json +++ b/clients/client-lambda/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Lambda Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-lambda/pagination/ListAliasesPaginator.ts b/clients/client-lambda/pagination/ListAliasesPaginator.ts index 8998b6897f47f..4dd41820a442b 100644 --- a/clients/client-lambda/pagination/ListAliasesPaginator.ts +++ b/clients/client-lambda/pagination/ListAliasesPaginator.ts @@ -4,6 +4,9 @@ import { ListAliasesCommand, ListAliasesCommandInput, ListAliasesCommandOutput } import { LambdaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LambdaClient, input: ListAliasesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Lambda, input: ListAliasesCommandInput, diff --git a/clients/client-lambda/pagination/ListEventSourceMappingsPaginator.ts b/clients/client-lambda/pagination/ListEventSourceMappingsPaginator.ts index e941f7da3e3c9..0dd0392cce61f 100644 --- a/clients/client-lambda/pagination/ListEventSourceMappingsPaginator.ts +++ b/clients/client-lambda/pagination/ListEventSourceMappingsPaginator.ts @@ -8,6 +8,9 @@ import { import { LambdaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LambdaClient, input: ListEventSourceMappingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEventSourceMappingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Lambda, input: ListEventSourceMappingsCommandInput, diff --git a/clients/client-lambda/pagination/ListFunctionEventInvokeConfigsPaginator.ts b/clients/client-lambda/pagination/ListFunctionEventInvokeConfigsPaginator.ts index 67373fff795d2..bab9bb28e17bd 100644 --- a/clients/client-lambda/pagination/ListFunctionEventInvokeConfigsPaginator.ts +++ b/clients/client-lambda/pagination/ListFunctionEventInvokeConfigsPaginator.ts @@ -8,6 +8,9 @@ import { import { LambdaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LambdaClient, input: ListFunctionEventInvokeConfigsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFunctionEventInvokeConfigsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Lambda, input: ListFunctionEventInvokeConfigsCommandInput, diff --git a/clients/client-lambda/pagination/ListFunctionsPaginator.ts b/clients/client-lambda/pagination/ListFunctionsPaginator.ts index 821905f8c92da..6d90978e3b47b 100644 --- a/clients/client-lambda/pagination/ListFunctionsPaginator.ts +++ b/clients/client-lambda/pagination/ListFunctionsPaginator.ts @@ -8,6 +8,9 @@ import { import { LambdaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LambdaClient, input: ListFunctionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFunctionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Lambda, input: ListFunctionsCommandInput, diff --git a/clients/client-lambda/pagination/ListLayerVersionsPaginator.ts b/clients/client-lambda/pagination/ListLayerVersionsPaginator.ts index ee8d0f05555dc..7f2fa369bb63f 100644 --- a/clients/client-lambda/pagination/ListLayerVersionsPaginator.ts +++ b/clients/client-lambda/pagination/ListLayerVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { LambdaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LambdaClient, input: ListLayerVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLayerVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Lambda, input: ListLayerVersionsCommandInput, diff --git a/clients/client-lambda/pagination/ListLayersPaginator.ts b/clients/client-lambda/pagination/ListLayersPaginator.ts index 4792a7f431ca6..1a5aef62fbf6a 100644 --- a/clients/client-lambda/pagination/ListLayersPaginator.ts +++ b/clients/client-lambda/pagination/ListLayersPaginator.ts @@ -4,6 +4,9 @@ import { ListLayersCommand, ListLayersCommandInput, ListLayersCommandOutput } fr import { LambdaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LambdaClient, input: ListLayersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLayersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Lambda, input: ListLayersCommandInput, diff --git a/clients/client-lambda/pagination/ListProvisionedConcurrencyConfigsPaginator.ts b/clients/client-lambda/pagination/ListProvisionedConcurrencyConfigsPaginator.ts index 8db37b9c3e509..72e13b55ab975 100644 --- a/clients/client-lambda/pagination/ListProvisionedConcurrencyConfigsPaginator.ts +++ b/clients/client-lambda/pagination/ListProvisionedConcurrencyConfigsPaginator.ts @@ -8,6 +8,9 @@ import { import { LambdaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LambdaClient, input: ListProvisionedConcurrencyConfigsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProvisionedConcurrencyConfigsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Lambda, input: ListProvisionedConcurrencyConfigsCommandInput, diff --git a/clients/client-lambda/pagination/ListVersionsByFunctionPaginator.ts b/clients/client-lambda/pagination/ListVersionsByFunctionPaginator.ts index af3f9751637c7..ee800fb44329d 100644 --- a/clients/client-lambda/pagination/ListVersionsByFunctionPaginator.ts +++ b/clients/client-lambda/pagination/ListVersionsByFunctionPaginator.ts @@ -8,6 +8,9 @@ import { import { LambdaPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LambdaClient, input: ListVersionsByFunctionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVersionsByFunctionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Lambda, input: ListVersionsByFunctionCommandInput, diff --git a/clients/client-lambda/runtimeConfig.browser.ts b/clients/client-lambda/runtimeConfig.browser.ts index 01e581a80d8dd..24e2c29fb608b 100644 --- a/clients/client-lambda/runtimeConfig.browser.ts +++ b/clients/client-lambda/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./LambdaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-lambda/runtimeConfig.native.ts b/clients/client-lambda/runtimeConfig.native.ts index 05ed336b780be..95427ba54a600 100644 --- a/clients/client-lambda/runtimeConfig.native.ts +++ b/clients/client-lambda/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./LambdaClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-lambda/runtimeConfig.shared.ts b/clients/client-lambda/runtimeConfig.shared.ts index fcac7b594fdaa..50b7af9b8a25d 100644 --- a/clients/client-lambda/runtimeConfig.shared.ts +++ b/clients/client-lambda/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-03-31", disableHostPrefix: false, diff --git a/clients/client-lambda/runtimeConfig.ts b/clients/client-lambda/runtimeConfig.ts index c1afd2d1c55db..57812c2d25f81 100644 --- a/clients/client-lambda/runtimeConfig.ts +++ b/clients/client-lambda/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./LambdaClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-lambda/tsconfig.json b/clients/client-lambda/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-lambda/tsconfig.json +++ b/clients/client-lambda/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-lex-model-building-service/commands/CreateBotVersionCommand.ts b/clients/client-lex-model-building-service/commands/CreateBotVersionCommand.ts index c2995fe08567f..784e7cb413bb4 100644 --- a/clients/client-lex-model-building-service/commands/CreateBotVersionCommand.ts +++ b/clients/client-lex-model-building-service/commands/CreateBotVersionCommand.ts @@ -24,6 +24,20 @@ import { export type CreateBotVersionCommandInput = CreateBotVersionRequest; export type CreateBotVersionCommandOutput = CreateBotVersionResponse & __MetadataBearer; +/** + *

Creates a new version of the bot based on the $LATEST version. If the + * $LATEST version of this resource hasn't changed since you created the last + * version, Amazon Lex doesn't create a new version. It returns the last created version.

+ * + *

You can update only the $LATEST version of the bot. You can't update the + * numbered versions that you create with the CreateBotVersion + * operation.

+ *
+ *

When you create the first version of a bot, Amazon Lex sets the version to 1. Subsequent + * versions increment by 1. For more information, see versioning-intro.

+ *

This operation requires permission for the lex:CreateBotVersion action. + *

+ */ export class CreateBotVersionCommand extends $Command< CreateBotVersionCommandInput, CreateBotVersionCommandOutput, @@ -38,6 +52,9 @@ export class CreateBotVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/CreateIntentVersionCommand.ts b/clients/client-lex-model-building-service/commands/CreateIntentVersionCommand.ts index 802ed9842663b..b5b416eebf6c1 100644 --- a/clients/client-lex-model-building-service/commands/CreateIntentVersionCommand.ts +++ b/clients/client-lex-model-building-service/commands/CreateIntentVersionCommand.ts @@ -24,6 +24,21 @@ import { export type CreateIntentVersionCommandInput = CreateIntentVersionRequest; export type CreateIntentVersionCommandOutput = CreateIntentVersionResponse & __MetadataBearer; +/** + *

Creates a new version of an intent based on the $LATEST version of the + * intent. If the $LATEST version of this intent hasn't changed since you last + * updated it, Amazon Lex doesn't create a new version. It returns the last version you + * created.

+ * + *

You can update only the $LATEST version of the intent. You can't update + * the numbered versions that you create with the CreateIntentVersion + * operation.

+ *
+ *

When you create a version of an intent, Amazon Lex sets the version to 1. Subsequent + * versions increment by 1. For more information, see versioning-intro.

+ *

This operation requires permissions to perform the lex:CreateIntentVersion + * action.

+ */ export class CreateIntentVersionCommand extends $Command< CreateIntentVersionCommandInput, CreateIntentVersionCommandOutput, @@ -38,6 +53,9 @@ export class CreateIntentVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/CreateSlotTypeVersionCommand.ts b/clients/client-lex-model-building-service/commands/CreateSlotTypeVersionCommand.ts index 484b906e2bb3e..fb4f186aee0ca 100644 --- a/clients/client-lex-model-building-service/commands/CreateSlotTypeVersionCommand.ts +++ b/clients/client-lex-model-building-service/commands/CreateSlotTypeVersionCommand.ts @@ -24,6 +24,23 @@ import { export type CreateSlotTypeVersionCommandInput = CreateSlotTypeVersionRequest; export type CreateSlotTypeVersionCommandOutput = CreateSlotTypeVersionResponse & __MetadataBearer; +/** + *

Creates a new version of a slot type based on the $LATEST version of the + * specified slot type. If the $LATEST version of this resource has not changed + * since the last version that you created, Amazon Lex doesn't create a new version. It returns the + * last version that you created.

+ * + *

You can update only the $LATEST version of a slot type. You can't update + * the numbered versions that you create with the CreateSlotTypeVersion + * operation.

+ *
+ * + *

When you create a version of a slot type, Amazon Lex sets the version to 1. Subsequent + * versions increment by 1. For more information, see versioning-intro.

+ * + *

This operation requires permissions for the lex:CreateSlotTypeVersion + * action.

+ */ export class CreateSlotTypeVersionCommand extends $Command< CreateSlotTypeVersionCommandInput, CreateSlotTypeVersionCommandOutput, @@ -38,6 +55,9 @@ export class CreateSlotTypeVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteBotAliasCommand.ts b/clients/client-lex-model-building-service/commands/DeleteBotAliasCommand.ts index dcd2b8307ca44..60b564ba8c91f 100644 --- a/clients/client-lex-model-building-service/commands/DeleteBotAliasCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteBotAliasCommand.ts @@ -24,6 +24,15 @@ import { export type DeleteBotAliasCommandInput = DeleteBotAliasRequest; export type DeleteBotAliasCommandOutput = __MetadataBearer; +/** + *

Deletes an alias for the specified bot.

+ *

You can't delete an alias that is used in the association between a bot and a messaging + * channel. If an alias is used in a channel association, the DeleteBot operation + * returns a ResourceInUseException exception that includes a reference to the + * channel association that refers to the bot. You can remove the reference to the alias by + * deleting the channel association. If you get the same exception again, delete the referring + * association until the DeleteBotAlias operation is successful.

+ */ export class DeleteBotAliasCommand extends $Command< DeleteBotAliasCommandInput, DeleteBotAliasCommandOutput, @@ -38,6 +47,9 @@ export class DeleteBotAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteBotChannelAssociationCommand.ts b/clients/client-lex-model-building-service/commands/DeleteBotChannelAssociationCommand.ts index 32e5a2d0f418c..e6a7eb1654cbb 100644 --- a/clients/client-lex-model-building-service/commands/DeleteBotChannelAssociationCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteBotChannelAssociationCommand.ts @@ -24,6 +24,11 @@ import { export type DeleteBotChannelAssociationCommandInput = DeleteBotChannelAssociationRequest; export type DeleteBotChannelAssociationCommandOutput = __MetadataBearer; +/** + *

Deletes the association between an Amazon Lex bot and a messaging platform.

+ *

This operation requires permission for the lex:DeleteBotChannelAssociation + * action.

+ */ export class DeleteBotChannelAssociationCommand extends $Command< DeleteBotChannelAssociationCommandInput, DeleteBotChannelAssociationCommandOutput, @@ -38,6 +43,9 @@ export class DeleteBotChannelAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteBotCommand.ts b/clients/client-lex-model-building-service/commands/DeleteBotCommand.ts index 447d3b4894d08..d70afb9a02206 100644 --- a/clients/client-lex-model-building-service/commands/DeleteBotCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteBotCommand.ts @@ -24,6 +24,23 @@ import { export type DeleteBotCommandInput = DeleteBotRequest; export type DeleteBotCommandOutput = __MetadataBearer; +/** + *

Deletes all versions of the bot, including the $LATEST version. To delete + * a specific version of the bot, use the DeleteBotVersion operation. The + * DeleteBot operation doesn't immediately remove the bot schema. Instead, it is + * marked for deletion and removed later.

+ *

Amazon Lex stores utterances indefinitely for improving the ability of your bot to respond + * to user inputs. These utterances are not removed when the bot is deleted. To remove the + * utterances, use the DeleteUtterances operation.

+ *

If a bot has an alias, you can't delete it. Instead, the DeleteBot + * operation returns a ResourceInUseException exception that includes a reference to + * the alias that refers to the bot. To remove the reference to the bot, delete the alias. If you + * get the same exception again, delete the referring alias until the DeleteBot + * operation is successful.

+ * + *

This operation requires permissions for the lex:DeleteBot + * action.

+ */ export class DeleteBotCommand extends $Command< DeleteBotCommandInput, DeleteBotCommandOutput, @@ -38,6 +55,9 @@ export class DeleteBotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteBotVersionCommand.ts b/clients/client-lex-model-building-service/commands/DeleteBotVersionCommand.ts index 1a96477a747b6..90878559f1b0e 100644 --- a/clients/client-lex-model-building-service/commands/DeleteBotVersionCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteBotVersionCommand.ts @@ -24,6 +24,11 @@ import { export type DeleteBotVersionCommandInput = DeleteBotVersionRequest; export type DeleteBotVersionCommandOutput = __MetadataBearer; +/** + *

Deletes a specific version of a bot. To delete all versions of a bot, use the DeleteBot operation.

+ *

This operation requires permissions for the lex:DeleteBotVersion + * action.

+ */ export class DeleteBotVersionCommand extends $Command< DeleteBotVersionCommandInput, DeleteBotVersionCommandOutput, @@ -38,6 +43,9 @@ export class DeleteBotVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteIntentCommand.ts b/clients/client-lex-model-building-service/commands/DeleteIntentCommand.ts index b3c2e8d5ca545..1733b1e3b456b 100644 --- a/clients/client-lex-model-building-service/commands/DeleteIntentCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteIntentCommand.ts @@ -24,6 +24,24 @@ import { export type DeleteIntentCommandInput = DeleteIntentRequest; export type DeleteIntentCommandOutput = __MetadataBearer; +/** + *

Deletes all versions of the intent, including the $LATEST version. To + * delete a specific version of the intent, use the DeleteIntentVersion + * operation.

+ *

You can delete a version of an intent only if it is not referenced. To delete an + * intent that is referred to in one or more bots (see how-it-works), you must + * remove those references first.

+ * + *

If you get the ResourceInUseException exception, it provides an example + * reference that shows where the intent is referenced. To remove the reference to the intent, + * either update the bot or delete it. If you get the same exception when you attempt to delete + * the intent again, repeat until the intent has no references and the call to + * DeleteIntent is successful.

+ *
+ * + *

This operation requires permission for the lex:DeleteIntent action. + *

+ */ export class DeleteIntentCommand extends $Command< DeleteIntentCommandInput, DeleteIntentCommandOutput, @@ -38,6 +56,9 @@ export class DeleteIntentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteIntentVersionCommand.ts b/clients/client-lex-model-building-service/commands/DeleteIntentVersionCommand.ts index 5d67466d2c148..5f532e127ee37 100644 --- a/clients/client-lex-model-building-service/commands/DeleteIntentVersionCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteIntentVersionCommand.ts @@ -24,6 +24,12 @@ import { export type DeleteIntentVersionCommandInput = DeleteIntentVersionRequest; export type DeleteIntentVersionCommandOutput = __MetadataBearer; +/** + *

Deletes a specific version of an intent. To delete all versions of a intent, use the + * DeleteIntent operation.

+ *

This operation requires permissions for the lex:DeleteIntentVersion + * action.

+ */ export class DeleteIntentVersionCommand extends $Command< DeleteIntentVersionCommandInput, DeleteIntentVersionCommandOutput, @@ -38,6 +44,9 @@ export class DeleteIntentVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteSlotTypeCommand.ts b/clients/client-lex-model-building-service/commands/DeleteSlotTypeCommand.ts index c47d61f16e16a..5899f339185fc 100644 --- a/clients/client-lex-model-building-service/commands/DeleteSlotTypeCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteSlotTypeCommand.ts @@ -24,6 +24,22 @@ import { export type DeleteSlotTypeCommandInput = DeleteSlotTypeRequest; export type DeleteSlotTypeCommandOutput = __MetadataBearer; +/** + *

Deletes all versions of the slot type, including the $LATEST version. To + * delete a specific version of the slot type, use the DeleteSlotTypeVersion + * operation.

+ *

You can delete a version of a slot type only if it is not referenced. To delete a slot + * type that is referred to in one or more intents, you must remove those references first.

+ * + *

If you get the ResourceInUseException exception, the exception provides + * an example reference that shows the intent where the slot type is referenced. To remove the + * reference to the slot type, either update the intent or delete it. If you get the same + * exception when you attempt to delete the slot type again, repeat until the slot type has no + * references and the DeleteSlotType call is successful.

+ *
+ *

This operation requires permission for the lex:DeleteSlotType + * action.

+ */ export class DeleteSlotTypeCommand extends $Command< DeleteSlotTypeCommandInput, DeleteSlotTypeCommandOutput, @@ -38,6 +54,9 @@ export class DeleteSlotTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteSlotTypeVersionCommand.ts b/clients/client-lex-model-building-service/commands/DeleteSlotTypeVersionCommand.ts index db69486ac9089..4d84ecfb9d690 100644 --- a/clients/client-lex-model-building-service/commands/DeleteSlotTypeVersionCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteSlotTypeVersionCommand.ts @@ -24,6 +24,12 @@ import { export type DeleteSlotTypeVersionCommandInput = DeleteSlotTypeVersionRequest; export type DeleteSlotTypeVersionCommandOutput = __MetadataBearer; +/** + *

Deletes a specific version of a slot type. To delete all versions of a slot type, use + * the DeleteSlotType operation.

+ *

This operation requires permissions for the lex:DeleteSlotTypeVersion + * action.

+ */ export class DeleteSlotTypeVersionCommand extends $Command< DeleteSlotTypeVersionCommandInput, DeleteSlotTypeVersionCommandOutput, @@ -38,6 +44,9 @@ export class DeleteSlotTypeVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/DeleteUtterancesCommand.ts b/clients/client-lex-model-building-service/commands/DeleteUtterancesCommand.ts index 431e70e76251f..5fd2c1724b274 100644 --- a/clients/client-lex-model-building-service/commands/DeleteUtterancesCommand.ts +++ b/clients/client-lex-model-building-service/commands/DeleteUtterancesCommand.ts @@ -24,6 +24,19 @@ import { export type DeleteUtterancesCommandInput = DeleteUtterancesRequest; export type DeleteUtterancesCommandOutput = __MetadataBearer; +/** + *

Deletes stored utterances.

+ *

Amazon Lex stores the utterances that users send to your bot. Utterances are stored for 15 + * days for use with the GetUtterancesView operation, and then stored + * indefinitely for use in improving the ability of your bot to respond to user input.

+ *

Use the DeleteUtterances operation to manually delete stored utterances + * for a specific user. When you use the DeleteUtterances operation, utterances + * stored for improving your bot's ability to respond to user input are deleted immediately. + * Utterances stored for use with the GetUtterancesView operation are deleted after + * 15 days.

+ *

This operation requires permissions for the lex:DeleteUtterances + * action.

+ */ export class DeleteUtterancesCommand extends $Command< DeleteUtterancesCommandInput, DeleteUtterancesCommandOutput, @@ -38,6 +51,9 @@ export class DeleteUtterancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBotAliasCommand.ts b/clients/client-lex-model-building-service/commands/GetBotAliasCommand.ts index b5777011c9272..86066f5a8507c 100644 --- a/clients/client-lex-model-building-service/commands/GetBotAliasCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBotAliasCommand.ts @@ -24,6 +24,12 @@ import { export type GetBotAliasCommandInput = GetBotAliasRequest; export type GetBotAliasCommandOutput = GetBotAliasResponse & __MetadataBearer; +/** + *

Returns information about an Amazon Lex bot alias. For more information about aliases, see + * versioning-aliases.

+ *

This operation requires permissions for the lex:GetBotAlias + * action.

+ */ export class GetBotAliasCommand extends $Command< GetBotAliasCommandInput, GetBotAliasCommandOutput, @@ -38,6 +44,9 @@ export class GetBotAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBotAliasesCommand.ts b/clients/client-lex-model-building-service/commands/GetBotAliasesCommand.ts index 8850156a939a7..7561c9c326b6f 100644 --- a/clients/client-lex-model-building-service/commands/GetBotAliasesCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBotAliasesCommand.ts @@ -24,6 +24,11 @@ import { export type GetBotAliasesCommandInput = GetBotAliasesRequest; export type GetBotAliasesCommandOutput = GetBotAliasesResponse & __MetadataBearer; +/** + *

Returns a list of aliases for a specified Amazon Lex bot.

+ *

This operation requires permissions for the lex:GetBotAliases + * action.

+ */ export class GetBotAliasesCommand extends $Command< GetBotAliasesCommandInput, GetBotAliasesCommandOutput, @@ -38,6 +43,9 @@ export class GetBotAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBotChannelAssociationCommand.ts b/clients/client-lex-model-building-service/commands/GetBotChannelAssociationCommand.ts index 07774acbcbc46..4bbb0edc0ad48 100644 --- a/clients/client-lex-model-building-service/commands/GetBotChannelAssociationCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBotChannelAssociationCommand.ts @@ -24,6 +24,12 @@ import { export type GetBotChannelAssociationCommandInput = GetBotChannelAssociationRequest; export type GetBotChannelAssociationCommandOutput = GetBotChannelAssociationResponse & __MetadataBearer; +/** + *

Returns information about the association between an Amazon Lex bot and a messaging + * platform.

+ *

This operation requires permissions for the lex:GetBotChannelAssociation + * action.

+ */ export class GetBotChannelAssociationCommand extends $Command< GetBotChannelAssociationCommandInput, GetBotChannelAssociationCommandOutput, @@ -38,6 +44,9 @@ export class GetBotChannelAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBotChannelAssociationsCommand.ts b/clients/client-lex-model-building-service/commands/GetBotChannelAssociationsCommand.ts index b3a793496a4e5..80cb29fd32e34 100644 --- a/clients/client-lex-model-building-service/commands/GetBotChannelAssociationsCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBotChannelAssociationsCommand.ts @@ -24,6 +24,11 @@ import { export type GetBotChannelAssociationsCommandInput = GetBotChannelAssociationsRequest; export type GetBotChannelAssociationsCommandOutput = GetBotChannelAssociationsResponse & __MetadataBearer; +/** + *

Returns a list of all of the channels associated with the specified bot.

+ *

The GetBotChannelAssociations operation requires permissions for the + * lex:GetBotChannelAssociations action.

+ */ export class GetBotChannelAssociationsCommand extends $Command< GetBotChannelAssociationsCommandInput, GetBotChannelAssociationsCommandOutput, @@ -38,6 +43,9 @@ export class GetBotChannelAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBotCommand.ts b/clients/client-lex-model-building-service/commands/GetBotCommand.ts index ed496bea5bb41..57d4a70a1e5bb 100644 --- a/clients/client-lex-model-building-service/commands/GetBotCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBotCommand.ts @@ -21,6 +21,11 @@ import { export type GetBotCommandInput = GetBotRequest; export type GetBotCommandOutput = GetBotResponse & __MetadataBearer; +/** + *

Returns metadata information for a specific bot. You must provide the bot name and the + * bot version or alias.

+ *

This operation requires permissions for the lex:GetBot action.

+ */ export class GetBotCommand extends $Command< GetBotCommandInput, GetBotCommandOutput, @@ -35,6 +40,9 @@ export class GetBotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBotVersionsCommand.ts b/clients/client-lex-model-building-service/commands/GetBotVersionsCommand.ts index 3fe3ecbb7084e..ae9475fa9d504 100644 --- a/clients/client-lex-model-building-service/commands/GetBotVersionsCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBotVersionsCommand.ts @@ -24,6 +24,17 @@ import { export type GetBotVersionsCommandInput = GetBotVersionsRequest; export type GetBotVersionsCommandOutput = GetBotVersionsResponse & __MetadataBearer; +/** + *

Gets information about all of the versions of a bot.

+ *

The GetBotVersions operation returns a BotMetadata object for + * each version of a bot. For example, if a bot has three numbered versions, the + * GetBotVersions operation returns four BotMetadata objects in the + * response, one for each numbered version and one for the $LATEST version.

+ *

The GetBotVersions operation always returns at least one version, the + * $LATEST version.

+ *

This operation requires permissions for the lex:GetBotVersions + * action.

+ */ export class GetBotVersionsCommand extends $Command< GetBotVersionsCommandInput, GetBotVersionsCommandOutput, @@ -38,6 +49,9 @@ export class GetBotVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBotsCommand.ts b/clients/client-lex-model-building-service/commands/GetBotsCommand.ts index 4e62c012586a4..446d6722cffad 100644 --- a/clients/client-lex-model-building-service/commands/GetBotsCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBotsCommand.ts @@ -24,6 +24,21 @@ import { export type GetBotsCommandInput = GetBotsRequest; export type GetBotsCommandOutput = GetBotsResponse & __MetadataBearer; +/** + *

Returns bot information as follows:

+ *
    + *
  • + *

    If you provide the nameContains field, the response includes + * information for the $LATEST version of all bots whose name contains the + * specified string.

    + *
  • + *
  • + *

    If you don't specify the nameContains field, the operation returns + * information about the $LATEST version of all of your bots.

    + *
  • + *
+ *

This operation requires permission for the lex:GetBots action.

+ */ export class GetBotsCommand extends $Command< GetBotsCommandInput, GetBotsCommandOutput, @@ -38,6 +53,9 @@ export class GetBotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBuiltinIntentCommand.ts b/clients/client-lex-model-building-service/commands/GetBuiltinIntentCommand.ts index 90937eeb264e1..74d0f413278d4 100644 --- a/clients/client-lex-model-building-service/commands/GetBuiltinIntentCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBuiltinIntentCommand.ts @@ -24,6 +24,11 @@ import { export type GetBuiltinIntentCommandInput = GetBuiltinIntentRequest; export type GetBuiltinIntentCommandOutput = GetBuiltinIntentResponse & __MetadataBearer; +/** + *

Returns information about a built-in intent.

+ *

This operation requires permission for the lex:GetBuiltinIntent + * action.

+ */ export class GetBuiltinIntentCommand extends $Command< GetBuiltinIntentCommandInput, GetBuiltinIntentCommandOutput, @@ -38,6 +43,9 @@ export class GetBuiltinIntentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBuiltinIntentsCommand.ts b/clients/client-lex-model-building-service/commands/GetBuiltinIntentsCommand.ts index 3e2458b926e23..3e72d501536cf 100644 --- a/clients/client-lex-model-building-service/commands/GetBuiltinIntentsCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBuiltinIntentsCommand.ts @@ -24,6 +24,11 @@ import { export type GetBuiltinIntentsCommandInput = GetBuiltinIntentsRequest; export type GetBuiltinIntentsCommandOutput = GetBuiltinIntentsResponse & __MetadataBearer; +/** + *

Gets a list of built-in intents that meet the specified criteria.

+ *

This operation requires permission for the lex:GetBuiltinIntents + * action.

+ */ export class GetBuiltinIntentsCommand extends $Command< GetBuiltinIntentsCommandInput, GetBuiltinIntentsCommandOutput, @@ -38,6 +43,9 @@ export class GetBuiltinIntentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetBuiltinSlotTypesCommand.ts b/clients/client-lex-model-building-service/commands/GetBuiltinSlotTypesCommand.ts index b3ed689d66e1b..cd0ffc3baf286 100644 --- a/clients/client-lex-model-building-service/commands/GetBuiltinSlotTypesCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetBuiltinSlotTypesCommand.ts @@ -24,6 +24,13 @@ import { export type GetBuiltinSlotTypesCommandInput = GetBuiltinSlotTypesRequest; export type GetBuiltinSlotTypesCommandOutput = GetBuiltinSlotTypesResponse & __MetadataBearer; +/** + *

Gets a list of built-in slot types that meet the specified criteria.

+ *

For a list of built-in slot types, see Slot Type Reference in the Alexa Skills Kit.

+ * + *

This operation requires permission for the lex:GetBuiltInSlotTypes + * action.

+ */ export class GetBuiltinSlotTypesCommand extends $Command< GetBuiltinSlotTypesCommandInput, GetBuiltinSlotTypesCommandOutput, @@ -38,6 +45,9 @@ export class GetBuiltinSlotTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetExportCommand.ts b/clients/client-lex-model-building-service/commands/GetExportCommand.ts index 7b952e02e2c44..3e6ccd21eeaac 100644 --- a/clients/client-lex-model-building-service/commands/GetExportCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetExportCommand.ts @@ -24,6 +24,9 @@ import { export type GetExportCommandInput = GetExportRequest; export type GetExportCommandOutput = GetExportResponse & __MetadataBearer; +/** + *

Exports the contents of a Amazon Lex resource in a specified format.

+ */ export class GetExportCommand extends $Command< GetExportCommandInput, GetExportCommandOutput, @@ -38,6 +41,9 @@ export class GetExportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetImportCommand.ts b/clients/client-lex-model-building-service/commands/GetImportCommand.ts index f4223984cfdfc..a354a3e76a242 100644 --- a/clients/client-lex-model-building-service/commands/GetImportCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetImportCommand.ts @@ -24,6 +24,10 @@ import { export type GetImportCommandInput = GetImportRequest; export type GetImportCommandOutput = GetImportResponse & __MetadataBearer; +/** + *

Gets information about an import job started with the StartImport + * operation.

+ */ export class GetImportCommand extends $Command< GetImportCommandInput, GetImportCommandOutput, @@ -38,6 +42,9 @@ export class GetImportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetIntentCommand.ts b/clients/client-lex-model-building-service/commands/GetIntentCommand.ts index 3eb5af0879bcb..f18b7c38a2aed 100644 --- a/clients/client-lex-model-building-service/commands/GetIntentCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetIntentCommand.ts @@ -24,6 +24,12 @@ import { export type GetIntentCommandInput = GetIntentRequest; export type GetIntentCommandOutput = GetIntentResponse & __MetadataBearer; +/** + *

Returns information about an intent. In addition to the intent name, you must specify + * the intent version.

+ *

This operation requires permissions to perform the lex:GetIntent action. + *

+ */ export class GetIntentCommand extends $Command< GetIntentCommandInput, GetIntentCommandOutput, @@ -38,6 +44,9 @@ export class GetIntentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetIntentVersionsCommand.ts b/clients/client-lex-model-building-service/commands/GetIntentVersionsCommand.ts index 8f9e70f234bd0..30cbfe3ebb26d 100644 --- a/clients/client-lex-model-building-service/commands/GetIntentVersionsCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetIntentVersionsCommand.ts @@ -24,6 +24,17 @@ import { export type GetIntentVersionsCommandInput = GetIntentVersionsRequest; export type GetIntentVersionsCommandOutput = GetIntentVersionsResponse & __MetadataBearer; +/** + *

Gets information about all of the versions of an intent.

+ *

The GetIntentVersions operation returns an IntentMetadata + * object for each version of an intent. For example, if an intent has three numbered versions, + * the GetIntentVersions operation returns four IntentMetadata objects + * in the response, one for each numbered version and one for the $LATEST version.

+ *

The GetIntentVersions operation always returns at least one version, the + * $LATEST version.

+ *

This operation requires permissions for the lex:GetIntentVersions + * action.

+ */ export class GetIntentVersionsCommand extends $Command< GetIntentVersionsCommandInput, GetIntentVersionsCommandOutput, @@ -38,6 +49,9 @@ export class GetIntentVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetIntentsCommand.ts b/clients/client-lex-model-building-service/commands/GetIntentsCommand.ts index abdd403fd5965..6a18e832ed94e 100644 --- a/clients/client-lex-model-building-service/commands/GetIntentsCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetIntentsCommand.ts @@ -24,6 +24,21 @@ import { export type GetIntentsCommandInput = GetIntentsRequest; export type GetIntentsCommandOutput = GetIntentsResponse & __MetadataBearer; +/** + *

Returns intent information as follows:

+ *
    + *
  • + *

    If you specify the nameContains field, returns the + * $LATEST version of all intents that contain the specified string.

    + *
  • + *
  • + *

    If you don't specify the nameContains field, returns information + * about the $LATEST version of all intents.

    + *
  • + *
+ *

The operation requires permission for the lex:GetIntents action. + *

+ */ export class GetIntentsCommand extends $Command< GetIntentsCommandInput, GetIntentsCommandOutput, @@ -38,6 +53,9 @@ export class GetIntentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetSlotTypeCommand.ts b/clients/client-lex-model-building-service/commands/GetSlotTypeCommand.ts index e1351d1e78e2b..c38c36f5a678e 100644 --- a/clients/client-lex-model-building-service/commands/GetSlotTypeCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetSlotTypeCommand.ts @@ -24,6 +24,12 @@ import { export type GetSlotTypeCommandInput = GetSlotTypeRequest; export type GetSlotTypeCommandOutput = GetSlotTypeResponse & __MetadataBearer; +/** + *

Returns information about a specific version of a slot type. In addition to specifying + * the slot type name, you must specify the slot type version.

+ *

This operation requires permissions for the lex:GetSlotType + * action.

+ */ export class GetSlotTypeCommand extends $Command< GetSlotTypeCommandInput, GetSlotTypeCommandOutput, @@ -38,6 +44,9 @@ export class GetSlotTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetSlotTypeVersionsCommand.ts b/clients/client-lex-model-building-service/commands/GetSlotTypeVersionsCommand.ts index 7584841d28218..4dd53501b7e44 100644 --- a/clients/client-lex-model-building-service/commands/GetSlotTypeVersionsCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetSlotTypeVersionsCommand.ts @@ -24,6 +24,18 @@ import { export type GetSlotTypeVersionsCommandInput = GetSlotTypeVersionsRequest; export type GetSlotTypeVersionsCommandOutput = GetSlotTypeVersionsResponse & __MetadataBearer; +/** + *

Gets information about all versions of a slot type.

+ *

The GetSlotTypeVersions operation returns a SlotTypeMetadata + * object for each version of a slot type. For example, if a slot type has three numbered + * versions, the GetSlotTypeVersions operation returns four + * SlotTypeMetadata objects in the response, one for each numbered version and one + * for the $LATEST version.

+ *

The GetSlotTypeVersions operation always returns at least one version, the + * $LATEST version.

+ *

This operation requires permissions for the lex:GetSlotTypeVersions + * action.

+ */ export class GetSlotTypeVersionsCommand extends $Command< GetSlotTypeVersionsCommandInput, GetSlotTypeVersionsCommandOutput, @@ -38,6 +50,9 @@ export class GetSlotTypeVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetSlotTypesCommand.ts b/clients/client-lex-model-building-service/commands/GetSlotTypesCommand.ts index 136368df80a46..a4f721943d93b 100644 --- a/clients/client-lex-model-building-service/commands/GetSlotTypesCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetSlotTypesCommand.ts @@ -24,6 +24,22 @@ import { export type GetSlotTypesCommandInput = GetSlotTypesRequest; export type GetSlotTypesCommandOutput = GetSlotTypesResponse & __MetadataBearer; +/** + *

Returns slot type information as follows:

+ *
    + *
  • + *

    If you specify the nameContains field, returns the + * $LATEST version of all slot types that contain the specified + * string.

    + *
  • + *
  • + *

    If you don't specify the nameContains field, returns information + * about the $LATEST version of all slot types.

    + *
  • + *
+ *

The operation requires permission for the lex:GetSlotTypes action. + *

+ */ export class GetSlotTypesCommand extends $Command< GetSlotTypesCommandInput, GetSlotTypesCommandOutput, @@ -38,6 +54,9 @@ export class GetSlotTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/GetUtterancesViewCommand.ts b/clients/client-lex-model-building-service/commands/GetUtterancesViewCommand.ts index 94b0fb9f72eca..6d4d9d07b8141 100644 --- a/clients/client-lex-model-building-service/commands/GetUtterancesViewCommand.ts +++ b/clients/client-lex-model-building-service/commands/GetUtterancesViewCommand.ts @@ -24,6 +24,26 @@ import { export type GetUtterancesViewCommandInput = GetUtterancesViewRequest; export type GetUtterancesViewCommandOutput = GetUtterancesViewResponse & __MetadataBearer; +/** + *

Use the GetUtterancesView operation to get information about the + * utterances that your users have made to your bot. You can use this list to tune the utterances + * that your bot responds to.

+ *

For example, say that you have created a bot to order flowers. After your users have + * used your bot for a while, use the GetUtterancesView operation to see the + * requests that they have made and whether they have been successful. You might find that the + * utterance "I want flowers" is not being recognized. You could add this utterance to the + * OrderFlowers intent so that your bot recognizes that utterance.

+ *

After you publish a new version of a bot, you can get information about the old version + * and the new so that you can compare the performance across the two versions.

+ *

Utterance statistics are generated once a day. Data is available for the last 15 days. + * You can request information for up to 5 versions of your bot in each request. Amazon Lex returns + * the most frequent utterances received by the bot in the last 15 days. The response contains + * information about a maximum of 100 utterances for each version.

+ *

If you set childDirected field to true when you created your bot, or if + * you opted out of participating in improving Amazon Lex, utterances are not available.

+ *

This operation requires permissions for the lex:GetUtterancesView + * action.

+ */ export class GetUtterancesViewCommand extends $Command< GetUtterancesViewCommandInput, GetUtterancesViewCommandOutput, @@ -38,6 +58,9 @@ export class GetUtterancesViewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/ListTagsForResourceCommand.ts b/clients/client-lex-model-building-service/commands/ListTagsForResourceCommand.ts index f9f24373f0017..b8f3e4413ce2a 100644 --- a/clients/client-lex-model-building-service/commands/ListTagsForResourceCommand.ts +++ b/clients/client-lex-model-building-service/commands/ListTagsForResourceCommand.ts @@ -24,6 +24,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Gets a list of tags associated with the specified resource. Only bots, bot aliases, and + * bot channels can have tags associated with them.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -38,6 +42,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/PutBotAliasCommand.ts b/clients/client-lex-model-building-service/commands/PutBotAliasCommand.ts index 3354b753705e7..9cecad2cb1f28 100644 --- a/clients/client-lex-model-building-service/commands/PutBotAliasCommand.ts +++ b/clients/client-lex-model-building-service/commands/PutBotAliasCommand.ts @@ -24,6 +24,13 @@ import { export type PutBotAliasCommandInput = PutBotAliasRequest; export type PutBotAliasCommandOutput = PutBotAliasResponse & __MetadataBearer; +/** + *

Creates an alias for the specified version of the bot or replaces an alias for the + * specified bot. To change the version of the bot that the alias points to, replace the alias. + * For more information about aliases, see versioning-aliases.

+ *

This operation requires permissions for the lex:PutBotAlias action. + *

+ */ export class PutBotAliasCommand extends $Command< PutBotAliasCommandInput, PutBotAliasCommandOutput, @@ -38,6 +45,9 @@ export class PutBotAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/PutBotCommand.ts b/clients/client-lex-model-building-service/commands/PutBotCommand.ts index b6811c37bcbc8..812c9ce07de2d 100644 --- a/clients/client-lex-model-building-service/commands/PutBotCommand.ts +++ b/clients/client-lex-model-building-service/commands/PutBotCommand.ts @@ -21,6 +21,22 @@ import { export type PutBotCommandInput = PutBotRequest; export type PutBotCommandOutput = PutBotResponse & __MetadataBearer; +/** + *

Creates an Amazon Lex conversational bot or replaces an existing bot. When you create or + * update a bot you are only required to specify a name, a locale, and whether the bot is + * directed toward children under age 13. You can use this to add intents later, or to remove + * intents from an existing bot. When you create a bot with the minimum information, the bot is + * created or updated but Amazon Lex returns the response FAILED. You can build + * the bot after you add one or more intents. For more information about Amazon Lex bots, see how-it-works.

+ *

If you specify the name of an existing bot, the fields in the request replace the + * existing values in the $LATEST version of the bot. Amazon Lex removes any fields that + * you don't provide values for in the request, except for the idleTTLInSeconds and + * privacySettings fields, which are set to their default values. If you don't + * specify values for required fields, Amazon Lex throws an exception.

+ * + *

This operation requires permissions for the lex:PutBot action. For more + * information, see security-iam.

+ */ export class PutBotCommand extends $Command< PutBotCommandInput, PutBotCommandOutput, @@ -35,6 +51,9 @@ export class PutBotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/PutIntentCommand.ts b/clients/client-lex-model-building-service/commands/PutIntentCommand.ts index 2a6a108ec71a9..353aac529cbb8 100644 --- a/clients/client-lex-model-building-service/commands/PutIntentCommand.ts +++ b/clients/client-lex-model-building-service/commands/PutIntentCommand.ts @@ -24,6 +24,59 @@ import { export type PutIntentCommandInput = PutIntentRequest; export type PutIntentCommandOutput = PutIntentResponse & __MetadataBearer; +/** + *

Creates an intent or replaces an existing intent.

+ *

To define the interaction between the user and your bot, you use one or more intents. + * For a pizza ordering bot, for example, you would create an OrderPizza intent.

+ *

To create an intent or replace an existing intent, you must provide the + * following:

+ *
    + *
  • + *

    Intent name. For example, OrderPizza.

    + *
  • + *
  • + *

    Sample utterances. For example, "Can I order a pizza, please." and "I want to order + * a pizza."

    + *
  • + *
  • + *

    Information to be gathered. You specify slot types for the information that your + * bot will request from the user. You can specify standard slot types, such as a date or a + * time, or custom slot types such as the size and crust of a pizza.

    + *
  • + *
  • + *

    How the intent will be fulfilled. You can provide a Lambda function or configure + * the intent to return the intent information to the client application. If you use a Lambda + * function, when all of the intent information is available, Amazon Lex invokes your Lambda + * function. If you configure your intent to return the intent information to the client + * application.

    + *
  • + *
+ *

You can specify other optional information in the request, such as:

+ * + *
    + *
  • + *

    A confirmation prompt to ask the user to confirm an intent. For example, "Shall I + * order your pizza?"

    + *
  • + *
  • + *

    A conclusion statement to send to the user after the intent has been fulfilled. For + * example, "I placed your pizza order."

    + *
  • + *
  • + *

    A follow-up prompt that asks the user for additional activity. For example, asking + * "Do you want to order a drink with your pizza?"

    + *
  • + *
+ *

If you specify an existing intent name to update the intent, Amazon Lex replaces the values + * in the $LATEST version of the intent with the values in the request. Amazon Lex + * removes fields that you don't provide in the request. If you don't specify the required + * fields, Amazon Lex throws an exception. When you update the $LATEST version of an + * intent, the status field of any bot that uses the $LATEST version of + * the intent is set to NOT_BUILT.

+ *

For more information, see how-it-works.

+ *

This operation requires permissions for the lex:PutIntent + * action.

+ */ export class PutIntentCommand extends $Command< PutIntentCommandInput, PutIntentCommandOutput, @@ -38,6 +91,9 @@ export class PutIntentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/PutSlotTypeCommand.ts b/clients/client-lex-model-building-service/commands/PutSlotTypeCommand.ts index ec85e321ee820..be6850f9b641c 100644 --- a/clients/client-lex-model-building-service/commands/PutSlotTypeCommand.ts +++ b/clients/client-lex-model-building-service/commands/PutSlotTypeCommand.ts @@ -24,6 +24,21 @@ import { export type PutSlotTypeCommandInput = PutSlotTypeRequest; export type PutSlotTypeCommandOutput = PutSlotTypeResponse & __MetadataBearer; +/** + *

Creates a custom slot type or replaces an existing custom slot type.

+ *

To create a custom slot type, specify a name for the slot type and a set of enumeration + * values, which are the values that a slot of this type can assume. For more information, see + * how-it-works.

+ *

If you specify the name of an existing slot type, the fields in the request replace the + * existing values in the $LATEST version of the slot type. Amazon Lex removes the fields + * that you don't provide in the request. If you don't specify required fields, Amazon Lex throws an + * exception. When you update the $LATEST version of a slot type, if a bot uses the + * $LATEST version of an intent that contains the slot type, the bot's + * status field is set to NOT_BUILT.

+ * + *

This operation requires permissions for the lex:PutSlotType + * action.

+ */ export class PutSlotTypeCommand extends $Command< PutSlotTypeCommandInput, PutSlotTypeCommandOutput, @@ -38,6 +53,9 @@ export class PutSlotTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/StartImportCommand.ts b/clients/client-lex-model-building-service/commands/StartImportCommand.ts index b1482f4045b62..343604e8f5f06 100644 --- a/clients/client-lex-model-building-service/commands/StartImportCommand.ts +++ b/clients/client-lex-model-building-service/commands/StartImportCommand.ts @@ -24,6 +24,9 @@ import { export type StartImportCommandInput = StartImportRequest; export type StartImportCommandOutput = StartImportResponse & __MetadataBearer; +/** + *

Starts a job to import a resource to Amazon Lex.

+ */ export class StartImportCommand extends $Command< StartImportCommandInput, StartImportCommandOutput, @@ -38,6 +41,9 @@ export class StartImportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/TagResourceCommand.ts b/clients/client-lex-model-building-service/commands/TagResourceCommand.ts index 82282a71e69ea..ab342a8aa01a9 100644 --- a/clients/client-lex-model-building-service/commands/TagResourceCommand.ts +++ b/clients/client-lex-model-building-service/commands/TagResourceCommand.ts @@ -24,6 +24,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds the specified tags to the specified resource. If a tag key already exists, the + * existing value is replaced with the new value.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -38,6 +42,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/commands/UntagResourceCommand.ts b/clients/client-lex-model-building-service/commands/UntagResourceCommand.ts index 0fd24722caf4c..f03d2840de4e1 100644 --- a/clients/client-lex-model-building-service/commands/UntagResourceCommand.ts +++ b/clients/client-lex-model-building-service/commands/UntagResourceCommand.ts @@ -24,6 +24,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes tags from a bot, bot alias or bot channel.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -38,6 +41,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexModelBuildingServiceClientResolvedConfig, diff --git a/clients/client-lex-model-building-service/package.json b/clients/client-lex-model-building-service/package.json index 589ab6620b29a..65a907213002d 100644 --- a/clients/client-lex-model-building-service/package.json +++ b/clients/client-lex-model-building-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Lex Model Building Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-lex-model-building-service/pagination/GetBotAliasesPaginator.ts b/clients/client-lex-model-building-service/pagination/GetBotAliasesPaginator.ts index b36e6daffae3f..faf8eb2ab34c2 100644 --- a/clients/client-lex-model-building-service/pagination/GetBotAliasesPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetBotAliasesPaginator.ts @@ -8,6 +8,9 @@ import { import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetBotAliasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetBotAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetBotAliasesCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetBotChannelAssociationsPaginator.ts b/clients/client-lex-model-building-service/pagination/GetBotChannelAssociationsPaginator.ts index 652c24e818c86..ba2427f4ed38b 100644 --- a/clients/client-lex-model-building-service/pagination/GetBotChannelAssociationsPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetBotChannelAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetBotChannelAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetBotChannelAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetBotChannelAssociationsCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetBotVersionsPaginator.ts b/clients/client-lex-model-building-service/pagination/GetBotVersionsPaginator.ts index 8137606787c99..c581131142330 100644 --- a/clients/client-lex-model-building-service/pagination/GetBotVersionsPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetBotVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetBotVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetBotVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetBotVersionsCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetBotsPaginator.ts b/clients/client-lex-model-building-service/pagination/GetBotsPaginator.ts index 4cf175bb71d78..44a3d91b29dfb 100644 --- a/clients/client-lex-model-building-service/pagination/GetBotsPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetBotsPaginator.ts @@ -4,6 +4,9 @@ import { GetBotsCommand, GetBotsCommandInput, GetBotsCommandOutput } from "../co import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetBotsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetBotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetBotsCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetBuiltinIntentsPaginator.ts b/clients/client-lex-model-building-service/pagination/GetBuiltinIntentsPaginator.ts index e324a11f61fca..f925560bacc10 100644 --- a/clients/client-lex-model-building-service/pagination/GetBuiltinIntentsPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetBuiltinIntentsPaginator.ts @@ -8,6 +8,9 @@ import { import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetBuiltinIntentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetBuiltinIntentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetBuiltinIntentsCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetBuiltinSlotTypesPaginator.ts b/clients/client-lex-model-building-service/pagination/GetBuiltinSlotTypesPaginator.ts index 82ebc5ec7ea81..f210257892868 100644 --- a/clients/client-lex-model-building-service/pagination/GetBuiltinSlotTypesPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetBuiltinSlotTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetBuiltinSlotTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetBuiltinSlotTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetBuiltinSlotTypesCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetIntentVersionsPaginator.ts b/clients/client-lex-model-building-service/pagination/GetIntentVersionsPaginator.ts index c03f38e13c670..0661c287d4029 100644 --- a/clients/client-lex-model-building-service/pagination/GetIntentVersionsPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetIntentVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetIntentVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetIntentVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetIntentVersionsCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetIntentsPaginator.ts b/clients/client-lex-model-building-service/pagination/GetIntentsPaginator.ts index 28475557aee64..c654478766ea9 100644 --- a/clients/client-lex-model-building-service/pagination/GetIntentsPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetIntentsPaginator.ts @@ -4,6 +4,9 @@ import { GetIntentsCommand, GetIntentsCommandInput, GetIntentsCommandOutput } fr import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetIntentsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetIntentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetIntentsCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetSlotTypeVersionsPaginator.ts b/clients/client-lex-model-building-service/pagination/GetSlotTypeVersionsPaginator.ts index 3373e605dbbfc..222927c64613e 100644 --- a/clients/client-lex-model-building-service/pagination/GetSlotTypeVersionsPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetSlotTypeVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetSlotTypeVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSlotTypeVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetSlotTypeVersionsCommandInput, diff --git a/clients/client-lex-model-building-service/pagination/GetSlotTypesPaginator.ts b/clients/client-lex-model-building-service/pagination/GetSlotTypesPaginator.ts index 691a5475dda37..9cd97313ae21b 100644 --- a/clients/client-lex-model-building-service/pagination/GetSlotTypesPaginator.ts +++ b/clients/client-lex-model-building-service/pagination/GetSlotTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { LexModelBuildingServicePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: LexModelBuildingServiceClient, input: GetSlotTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSlotTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: LexModelBuildingService, input: GetSlotTypesCommandInput, diff --git a/clients/client-lex-model-building-service/runtimeConfig.browser.ts b/clients/client-lex-model-building-service/runtimeConfig.browser.ts index 5adee3fa87b06..37be0ccdd2b8c 100644 --- a/clients/client-lex-model-building-service/runtimeConfig.browser.ts +++ b/clients/client-lex-model-building-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./LexModelBuildingServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-lex-model-building-service/runtimeConfig.native.ts b/clients/client-lex-model-building-service/runtimeConfig.native.ts index b6228b5277487..efae1a69a053f 100644 --- a/clients/client-lex-model-building-service/runtimeConfig.native.ts +++ b/clients/client-lex-model-building-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./LexModelBuildingServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-lex-model-building-service/runtimeConfig.shared.ts b/clients/client-lex-model-building-service/runtimeConfig.shared.ts index eb1f0d39bb0da..0ba9885620b53 100644 --- a/clients/client-lex-model-building-service/runtimeConfig.shared.ts +++ b/clients/client-lex-model-building-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-04-19", disableHostPrefix: false, diff --git a/clients/client-lex-model-building-service/runtimeConfig.ts b/clients/client-lex-model-building-service/runtimeConfig.ts index 30e635de08335..c06f2589364ad 100644 --- a/clients/client-lex-model-building-service/runtimeConfig.ts +++ b/clients/client-lex-model-building-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./LexModelBuildingServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-lex-model-building-service/tsconfig.json b/clients/client-lex-model-building-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-lex-model-building-service/tsconfig.json +++ b/clients/client-lex-model-building-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-lex-runtime-service/commands/DeleteSessionCommand.ts b/clients/client-lex-runtime-service/commands/DeleteSessionCommand.ts index 4cd8e88fd39bf..1441884430172 100644 --- a/clients/client-lex-runtime-service/commands/DeleteSessionCommand.ts +++ b/clients/client-lex-runtime-service/commands/DeleteSessionCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteSessionCommandInput = DeleteSessionRequest; export type DeleteSessionCommandOutput = DeleteSessionResponse & __MetadataBearer; +/** + *

Removes session information for a specified bot, alias, and user ID.

+ */ export class DeleteSessionCommand extends $Command< DeleteSessionCommandInput, DeleteSessionCommandOutput, @@ -38,6 +41,9 @@ export class DeleteSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexRuntimeServiceClientResolvedConfig, diff --git a/clients/client-lex-runtime-service/commands/GetSessionCommand.ts b/clients/client-lex-runtime-service/commands/GetSessionCommand.ts index 7bb762e3c6b86..fa7b913ba2cdf 100644 --- a/clients/client-lex-runtime-service/commands/GetSessionCommand.ts +++ b/clients/client-lex-runtime-service/commands/GetSessionCommand.ts @@ -24,6 +24,9 @@ import { export type GetSessionCommandInput = GetSessionRequest; export type GetSessionCommandOutput = GetSessionResponse & __MetadataBearer; +/** + *

Returns session information for a specified bot, alias, and user ID.

+ */ export class GetSessionCommand extends $Command< GetSessionCommandInput, GetSessionCommandOutput, @@ -38,6 +41,9 @@ export class GetSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexRuntimeServiceClientResolvedConfig, diff --git a/clients/client-lex-runtime-service/commands/PostContentCommand.ts b/clients/client-lex-runtime-service/commands/PostContentCommand.ts index 615bb96657d2b..37763462ed87a 100644 --- a/clients/client-lex-runtime-service/commands/PostContentCommand.ts +++ b/clients/client-lex-runtime-service/commands/PostContentCommand.ts @@ -26,6 +26,76 @@ export type PostContentCommandInput = Omit & }; export type PostContentCommandOutput = PostContentResponse & __MetadataBearer; +/** + *

Sends user input (text or speech) to Amazon Lex. Clients use this API to send text and audio + * requests to Amazon Lex at runtime. Amazon Lex interprets the user input using the machine learning model + * that it built for the bot.

+ *

The PostContent operation supports audio input at 8kHz and 16kHz. You can use + * 8kHz audio to achieve higher speech recognition accuracy in telephone audio applications.

+ *

In response, Amazon Lex returns the next message to convey to the user. Consider the following + * example messages:

+ *
    + *
  • + *

    For a user input "I would like a pizza," Amazon Lex might return a response with a message + * eliciting slot data (for example, PizzaSize): "What size pizza would you + * like?".

    + *
  • + *
  • + *

    After the user provides all of the pizza order information, Amazon Lex might return a + * response with a message to get user confirmation: "Order the pizza?".

    + *
  • + *
  • + *

    After the user replies "Yes" to the confirmation prompt, Amazon Lex might return a + * conclusion statement: "Thank you, your cheese pizza has been ordered.".

    + *
  • + *
+ *

Not all Amazon Lex messages require a response from the user. For example, conclusion + * statements do not require a response. Some messages require only a yes or no response. In + * addition to the message, Amazon Lex provides additional context about the message in + * the response that you can use to enhance client behavior, such as displaying the appropriate + * client user interface. Consider the following examples:

+ *
    + *
  • + *

    If the message is to elicit slot data, Amazon Lex returns the following context + * information:

    + *
      + *
    • + *

      + * x-amz-lex-dialog-state header set to ElicitSlot + *

      + *
    • + *
    • + *

      + * x-amz-lex-intent-name header set to the intent name in the current + * context

      + *
    • + *
    • + *

      + * x-amz-lex-slot-to-elicit header set to the slot name for which the + * message is eliciting information

      + *
    • + *
    • + *

      + * x-amz-lex-slots header set to a map of slots configured for the intent + * with their current values

      + *
    • + *
    + *
  • + *
  • + *

    If the message is a confirmation prompt, the x-amz-lex-dialog-state + * header is set to Confirmation and the x-amz-lex-slot-to-elicit + * header is omitted.

    + *
  • + *
  • + *

    If the message is a clarification prompt configured for the intent, indicating that + * the user intent is not understood, the x-amz-dialog-state header is set to + * ElicitIntent and the x-amz-slot-to-elicit header is omitted. + *

    + *
  • + *
+ *

In addition, Amazon Lex also returns your application-specific sessionAttributes. + * For more information, see Managing Conversation Context.

+ */ export class PostContentCommand extends $Command< PostContentCommandInput, PostContentCommandOutput, @@ -40,6 +110,9 @@ export class PostContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexRuntimeServiceClientResolvedConfig, diff --git a/clients/client-lex-runtime-service/commands/PostTextCommand.ts b/clients/client-lex-runtime-service/commands/PostTextCommand.ts index 58b032cd978ce..cdc48bc2ca482 100644 --- a/clients/client-lex-runtime-service/commands/PostTextCommand.ts +++ b/clients/client-lex-runtime-service/commands/PostTextCommand.ts @@ -24,6 +24,76 @@ import { export type PostTextCommandInput = PostTextRequest; export type PostTextCommandOutput = PostTextResponse & __MetadataBearer; +/** + *

Sends user input to Amazon Lex. Client applications can use this API to send requests to + * Amazon Lex at runtime. Amazon Lex then interprets the user input using the machine learning model it + * built for the bot.

+ *

In response, Amazon Lex returns the next message to convey to the user an + * optional responseCard to display. Consider the following example messages:

+ *
    + *
  • + *

    For a user input "I would like a pizza", Amazon Lex might return a response with a + * message eliciting slot data (for example, PizzaSize): "What size pizza would you like?" + *

    + *
  • + *
  • + *

    After the user provides all of the pizza order information, Amazon Lex might return a + * response with a message to obtain user confirmation "Proceed with the pizza order?". + *

    + *
  • + *
  • + *

    After the user replies to a confirmation prompt with a "yes", Amazon Lex might return + * a conclusion statement: "Thank you, your cheese pizza has been ordered.".

    + *
  • + *
+ * + *

Not all Amazon Lex messages require a user response. For example, a conclusion statement + * does not require a response. Some messages require only a "yes" or "no" user response. In + * addition to the message, Amazon Lex provides additional context about the message + * in the response that you might use to enhance client behavior, for example, to display the + * appropriate client user interface. These are the slotToElicit, + * dialogState, intentName, and slots fields in the + * response. Consider the following examples:

+ * + *
    + *
  • + *

    If the message is to elicit slot data, Amazon Lex returns the following context + * information:

    + *
      + *
    • + *

      + * dialogState set to ElicitSlot

      + *
    • + *
    • + *

      + * intentName set to the intent name in the current context

      + *
    • + *
    • + *

      + * slotToElicit set to the slot name for which the message is + * eliciting information

      + *
    • + *
    • + *

      + * slots set to a map of slots, configured for the intent, with currently + * known values

      + *
    • + *
    + *
  • + *
  • + *

    If the message is a confirmation prompt, the dialogState is set to + * ConfirmIntent and SlotToElicit is set to null.

    + *
  • + *
  • + *

    If the message is a clarification prompt (configured for the intent) that indicates + * that user intent is not understood, the dialogState is set to ElicitIntent + * and slotToElicit is set to null.

    + *
  • + *
+ * + *

In addition, Amazon Lex also returns your application-specific + * sessionAttributes. For more information, see Managing Conversation Context.

+ */ export class PostTextCommand extends $Command< PostTextCommandInput, PostTextCommandOutput, @@ -38,6 +108,9 @@ export class PostTextCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexRuntimeServiceClientResolvedConfig, diff --git a/clients/client-lex-runtime-service/commands/PutSessionCommand.ts b/clients/client-lex-runtime-service/commands/PutSessionCommand.ts index b3e93e70f15db..73e4df94569b2 100644 --- a/clients/client-lex-runtime-service/commands/PutSessionCommand.ts +++ b/clients/client-lex-runtime-service/commands/PutSessionCommand.ts @@ -24,6 +24,11 @@ import { export type PutSessionCommandInput = PutSessionRequest; export type PutSessionCommandOutput = PutSessionResponse & __MetadataBearer; +/** + *

Creates a new session or modifies an existing session with an Amazon Lex bot. Use this + * operation to enable your application to set the state of the bot.

+ *

For more information, see Managing Sessions.

+ */ export class PutSessionCommand extends $Command< PutSessionCommandInput, PutSessionCommandOutput, @@ -38,6 +43,9 @@ export class PutSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LexRuntimeServiceClientResolvedConfig, diff --git a/clients/client-lex-runtime-service/package.json b/clients/client-lex-runtime-service/package.json index c4816bb30d87d..d715855bab712 100644 --- a/clients/client-lex-runtime-service/package.json +++ b/clients/client-lex-runtime-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Lex Runtime Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-lex-runtime-service/runtimeConfig.browser.ts b/clients/client-lex-runtime-service/runtimeConfig.browser.ts index e1791ae775e5c..b4c57777d8f9c 100644 --- a/clients/client-lex-runtime-service/runtimeConfig.browser.ts +++ b/clients/client-lex-runtime-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./LexRuntimeServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-lex-runtime-service/runtimeConfig.native.ts b/clients/client-lex-runtime-service/runtimeConfig.native.ts index 859318ab44fa1..3d97604d2104d 100644 --- a/clients/client-lex-runtime-service/runtimeConfig.native.ts +++ b/clients/client-lex-runtime-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./LexRuntimeServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-lex-runtime-service/runtimeConfig.shared.ts b/clients/client-lex-runtime-service/runtimeConfig.shared.ts index b506701c6f8c9..5ad8fdbc5f3e4 100644 --- a/clients/client-lex-runtime-service/runtimeConfig.shared.ts +++ b/clients/client-lex-runtime-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-11-28", disableHostPrefix: false, diff --git a/clients/client-lex-runtime-service/runtimeConfig.ts b/clients/client-lex-runtime-service/runtimeConfig.ts index 4153850fec4c1..0a67dee71d61e 100644 --- a/clients/client-lex-runtime-service/runtimeConfig.ts +++ b/clients/client-lex-runtime-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./LexRuntimeServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-lex-runtime-service/tsconfig.json b/clients/client-lex-runtime-service/tsconfig.json index d0a09bf323180..f994bbf7c065f 100644 --- a/clients/client-lex-runtime-service/tsconfig.json +++ b/clients/client-lex-runtime-service/tsconfig.json @@ -17,13 +17,16 @@ "types": ["mocha", "node"] }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-license-manager/commands/CreateLicenseConfigurationCommand.ts b/clients/client-license-manager/commands/CreateLicenseConfigurationCommand.ts index dc43bc267b2f9..d2276b1d7193f 100644 --- a/clients/client-license-manager/commands/CreateLicenseConfigurationCommand.ts +++ b/clients/client-license-manager/commands/CreateLicenseConfigurationCommand.ts @@ -20,6 +20,14 @@ import { export type CreateLicenseConfigurationCommandInput = CreateLicenseConfigurationRequest; export type CreateLicenseConfigurationCommandOutput = CreateLicenseConfigurationResponse & __MetadataBearer; +/** + *

Creates a license configuration.

+ *

A license configuration is an abstraction of a customer license agreement that can be + * consumed and enforced by License Manager. Components include specifications for the license + * type (licensing by instance, socket, CPU, or vCPU), allowed tenancy (shared tenancy, + * Dedicated Instance, Dedicated Host, or all of these), license affinity to host (how long a + * license must be associated with a host), and the number of licenses purchased and used.

+ */ export class CreateLicenseConfigurationCommand extends $Command< CreateLicenseConfigurationCommandInput, CreateLicenseConfigurationCommandOutput, @@ -34,6 +42,9 @@ export class CreateLicenseConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/DeleteLicenseConfigurationCommand.ts b/clients/client-license-manager/commands/DeleteLicenseConfigurationCommand.ts index 63846a5019a3b..f8c6d00e9c9f1 100644 --- a/clients/client-license-manager/commands/DeleteLicenseConfigurationCommand.ts +++ b/clients/client-license-manager/commands/DeleteLicenseConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteLicenseConfigurationCommandInput = DeleteLicenseConfigurationRequest; export type DeleteLicenseConfigurationCommandOutput = DeleteLicenseConfigurationResponse & __MetadataBearer; +/** + *

Deletes the specified license configuration.

+ *

You cannot delete a license configuration that is in use.

+ */ export class DeleteLicenseConfigurationCommand extends $Command< DeleteLicenseConfigurationCommandInput, DeleteLicenseConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class DeleteLicenseConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/GetLicenseConfigurationCommand.ts b/clients/client-license-manager/commands/GetLicenseConfigurationCommand.ts index 23eb6ac087bc5..7a7cdffa4b429 100644 --- a/clients/client-license-manager/commands/GetLicenseConfigurationCommand.ts +++ b/clients/client-license-manager/commands/GetLicenseConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetLicenseConfigurationCommandInput = GetLicenseConfigurationRequest; export type GetLicenseConfigurationCommandOutput = GetLicenseConfigurationResponse & __MetadataBearer; +/** + *

Gets detailed information about the specified license configuration.

+ */ export class GetLicenseConfigurationCommand extends $Command< GetLicenseConfigurationCommandInput, GetLicenseConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetLicenseConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/GetServiceSettingsCommand.ts b/clients/client-license-manager/commands/GetServiceSettingsCommand.ts index 1391534109a34..c12c239689dd6 100644 --- a/clients/client-license-manager/commands/GetServiceSettingsCommand.ts +++ b/clients/client-license-manager/commands/GetServiceSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetServiceSettingsCommandInput = GetServiceSettingsRequest; export type GetServiceSettingsCommandOutput = GetServiceSettingsResponse & __MetadataBearer; +/** + *

Gets the License Manager settings for the current Region.

+ */ export class GetServiceSettingsCommand extends $Command< GetServiceSettingsCommandInput, GetServiceSettingsCommandOutput, @@ -34,6 +37,9 @@ export class GetServiceSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/ListAssociationsForLicenseConfigurationCommand.ts b/clients/client-license-manager/commands/ListAssociationsForLicenseConfigurationCommand.ts index 70544912ef461..3b36074f698ec 100644 --- a/clients/client-license-manager/commands/ListAssociationsForLicenseConfigurationCommand.ts +++ b/clients/client-license-manager/commands/ListAssociationsForLicenseConfigurationCommand.ts @@ -24,6 +24,12 @@ export type ListAssociationsForLicenseConfigurationCommandInput = ListAssociatio export type ListAssociationsForLicenseConfigurationCommandOutput = ListAssociationsForLicenseConfigurationResponse & __MetadataBearer; +/** + *

Lists the resource associations for the specified license configuration.

+ *

Resource associations need not consume licenses from a license configuration. + * For example, an AMI or a stopped instance might not consume a license (depending on + * the license rules).

+ */ export class ListAssociationsForLicenseConfigurationCommand extends $Command< ListAssociationsForLicenseConfigurationCommandInput, ListAssociationsForLicenseConfigurationCommandOutput, @@ -38,6 +44,9 @@ export class ListAssociationsForLicenseConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/ListFailuresForLicenseConfigurationOperationsCommand.ts b/clients/client-license-manager/commands/ListFailuresForLicenseConfigurationOperationsCommand.ts index 530ec119986aa..aebe20cfa4f35 100644 --- a/clients/client-license-manager/commands/ListFailuresForLicenseConfigurationOperationsCommand.ts +++ b/clients/client-license-manager/commands/ListFailuresForLicenseConfigurationOperationsCommand.ts @@ -24,6 +24,9 @@ export type ListFailuresForLicenseConfigurationOperationsCommandInput = ListFail export type ListFailuresForLicenseConfigurationOperationsCommandOutput = ListFailuresForLicenseConfigurationOperationsResponse & __MetadataBearer; +/** + *

Lists the license configuration operations that failed.

+ */ export class ListFailuresForLicenseConfigurationOperationsCommand extends $Command< ListFailuresForLicenseConfigurationOperationsCommandInput, ListFailuresForLicenseConfigurationOperationsCommandOutput, @@ -38,6 +41,9 @@ export class ListFailuresForLicenseConfigurationOperationsCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/ListLicenseConfigurationsCommand.ts b/clients/client-license-manager/commands/ListLicenseConfigurationsCommand.ts index c1bf0900dc074..b118db8dc762c 100644 --- a/clients/client-license-manager/commands/ListLicenseConfigurationsCommand.ts +++ b/clients/client-license-manager/commands/ListLicenseConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListLicenseConfigurationsCommandInput = ListLicenseConfigurationsRequest; export type ListLicenseConfigurationsCommandOutput = ListLicenseConfigurationsResponse & __MetadataBearer; +/** + *

Lists the license configurations for your account.

+ */ export class ListLicenseConfigurationsCommand extends $Command< ListLicenseConfigurationsCommandInput, ListLicenseConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class ListLicenseConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/ListLicenseSpecificationsForResourceCommand.ts b/clients/client-license-manager/commands/ListLicenseSpecificationsForResourceCommand.ts index f5c7bb5387998..728b3ddcc18e6 100644 --- a/clients/client-license-manager/commands/ListLicenseSpecificationsForResourceCommand.ts +++ b/clients/client-license-manager/commands/ListLicenseSpecificationsForResourceCommand.ts @@ -24,6 +24,9 @@ export type ListLicenseSpecificationsForResourceCommandInput = ListLicenseSpecif export type ListLicenseSpecificationsForResourceCommandOutput = ListLicenseSpecificationsForResourceResponse & __MetadataBearer; +/** + *

Describes the license configurations for the specified resource.

+ */ export class ListLicenseSpecificationsForResourceCommand extends $Command< ListLicenseSpecificationsForResourceCommandInput, ListLicenseSpecificationsForResourceCommandOutput, @@ -38,6 +41,9 @@ export class ListLicenseSpecificationsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/ListResourceInventoryCommand.ts b/clients/client-license-manager/commands/ListResourceInventoryCommand.ts index 904710cad7b6d..3953d63f3d516 100644 --- a/clients/client-license-manager/commands/ListResourceInventoryCommand.ts +++ b/clients/client-license-manager/commands/ListResourceInventoryCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourceInventoryCommandInput = ListResourceInventoryRequest; export type ListResourceInventoryCommandOutput = ListResourceInventoryResponse & __MetadataBearer; +/** + *

Lists resources managed using Systems Manager inventory.

+ */ export class ListResourceInventoryCommand extends $Command< ListResourceInventoryCommandInput, ListResourceInventoryCommandOutput, @@ -34,6 +37,9 @@ export class ListResourceInventoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/ListTagsForResourceCommand.ts b/clients/client-license-manager/commands/ListTagsForResourceCommand.ts index 0f130770ffdfe..1fcf5a0f496aa 100644 --- a/clients/client-license-manager/commands/ListTagsForResourceCommand.ts +++ b/clients/client-license-manager/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags for the specified license configuration.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/ListUsageForLicenseConfigurationCommand.ts b/clients/client-license-manager/commands/ListUsageForLicenseConfigurationCommand.ts index 010766445f90a..8305caa4fe88d 100644 --- a/clients/client-license-manager/commands/ListUsageForLicenseConfigurationCommand.ts +++ b/clients/client-license-manager/commands/ListUsageForLicenseConfigurationCommand.ts @@ -20,6 +20,11 @@ import { export type ListUsageForLicenseConfigurationCommandInput = ListUsageForLicenseConfigurationRequest; export type ListUsageForLicenseConfigurationCommandOutput = ListUsageForLicenseConfigurationResponse & __MetadataBearer; +/** + *

Lists all license usage records for a license configuration, displaying license + * consumption details by resource at a selected point in time. Use this action to audit the + * current license consumption for any license inventory and configuration.

+ */ export class ListUsageForLicenseConfigurationCommand extends $Command< ListUsageForLicenseConfigurationCommandInput, ListUsageForLicenseConfigurationCommandOutput, @@ -34,6 +39,9 @@ export class ListUsageForLicenseConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/TagResourceCommand.ts b/clients/client-license-manager/commands/TagResourceCommand.ts index feee63cd2c5e2..b3a9f2cf0040b 100644 --- a/clients/client-license-manager/commands/TagResourceCommand.ts +++ b/clients/client-license-manager/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds the specified tags to the specified license configuration.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/UntagResourceCommand.ts b/clients/client-license-manager/commands/UntagResourceCommand.ts index 702c4471598fb..fbd6aca337e01 100644 --- a/clients/client-license-manager/commands/UntagResourceCommand.ts +++ b/clients/client-license-manager/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the specified tags from the specified license configuration.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/UpdateLicenseConfigurationCommand.ts b/clients/client-license-manager/commands/UpdateLicenseConfigurationCommand.ts index cb041f4347e99..3d8fede9af41a 100644 --- a/clients/client-license-manager/commands/UpdateLicenseConfigurationCommand.ts +++ b/clients/client-license-manager/commands/UpdateLicenseConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateLicenseConfigurationCommandInput = UpdateLicenseConfigurationRequest; export type UpdateLicenseConfigurationCommandOutput = UpdateLicenseConfigurationResponse & __MetadataBearer; +/** + *

Modifies the attributes of an existing license configuration.

+ */ export class UpdateLicenseConfigurationCommand extends $Command< UpdateLicenseConfigurationCommandInput, UpdateLicenseConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateLicenseConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/UpdateLicenseSpecificationsForResourceCommand.ts b/clients/client-license-manager/commands/UpdateLicenseSpecificationsForResourceCommand.ts index 16dd4ff13bd17..86c45074ce523 100644 --- a/clients/client-license-manager/commands/UpdateLicenseSpecificationsForResourceCommand.ts +++ b/clients/client-license-manager/commands/UpdateLicenseSpecificationsForResourceCommand.ts @@ -24,6 +24,12 @@ export type UpdateLicenseSpecificationsForResourceCommandInput = UpdateLicenseSp export type UpdateLicenseSpecificationsForResourceCommandOutput = UpdateLicenseSpecificationsForResourceResponse & __MetadataBearer; +/** + *

Adds or removes the specified license configurations for the specified AWS resource.

+ *

You can update the license specifications of AMIs, instances, and hosts. + * You cannot update the license specifications for launch templates and AWS CloudFormation templates, + * as they send license configurations to the operation that creates the resource.

+ */ export class UpdateLicenseSpecificationsForResourceCommand extends $Command< UpdateLicenseSpecificationsForResourceCommandInput, UpdateLicenseSpecificationsForResourceCommandOutput, @@ -38,6 +44,9 @@ export class UpdateLicenseSpecificationsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/commands/UpdateServiceSettingsCommand.ts b/clients/client-license-manager/commands/UpdateServiceSettingsCommand.ts index ab332f3fe5ca4..1fc0c0fd0e6d2 100644 --- a/clients/client-license-manager/commands/UpdateServiceSettingsCommand.ts +++ b/clients/client-license-manager/commands/UpdateServiceSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateServiceSettingsCommandInput = UpdateServiceSettingsRequest; export type UpdateServiceSettingsCommandOutput = UpdateServiceSettingsResponse & __MetadataBearer; +/** + *

Updates License Manager settings for the current Region.

+ */ export class UpdateServiceSettingsCommand extends $Command< UpdateServiceSettingsCommandInput, UpdateServiceSettingsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateServiceSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LicenseManagerClientResolvedConfig, diff --git a/clients/client-license-manager/package.json b/clients/client-license-manager/package.json index 41e7ffd938c21..4ce065779bfb0 100644 --- a/clients/client-license-manager/package.json +++ b/clients/client-license-manager/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript License Manager Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-license-manager/runtimeConfig.browser.ts b/clients/client-license-manager/runtimeConfig.browser.ts index 4b4a8374a461b..c9a366356ab7f 100644 --- a/clients/client-license-manager/runtimeConfig.browser.ts +++ b/clients/client-license-manager/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./LicenseManagerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-license-manager/runtimeConfig.native.ts b/clients/client-license-manager/runtimeConfig.native.ts index aa2c9b5d7be37..f2d40a1463190 100644 --- a/clients/client-license-manager/runtimeConfig.native.ts +++ b/clients/client-license-manager/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./LicenseManagerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-license-manager/runtimeConfig.shared.ts b/clients/client-license-manager/runtimeConfig.shared.ts index c8e74b39d43ad..63c3efc22e235 100644 --- a/clients/client-license-manager/runtimeConfig.shared.ts +++ b/clients/client-license-manager/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-08-01", disableHostPrefix: false, diff --git a/clients/client-license-manager/runtimeConfig.ts b/clients/client-license-manager/runtimeConfig.ts index d5db72098d921..e0698a2e9427b 100644 --- a/clients/client-license-manager/runtimeConfig.ts +++ b/clients/client-license-manager/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./LicenseManagerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-license-manager/tsconfig.json b/clients/client-license-manager/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-license-manager/tsconfig.json +++ b/clients/client-license-manager/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-lightsail/commands/AllocateStaticIpCommand.ts b/clients/client-lightsail/commands/AllocateStaticIpCommand.ts index f34c4b9f367c2..a8e27c2d46e91 100644 --- a/clients/client-lightsail/commands/AllocateStaticIpCommand.ts +++ b/clients/client-lightsail/commands/AllocateStaticIpCommand.ts @@ -20,6 +20,9 @@ import { export type AllocateStaticIpCommandInput = AllocateStaticIpRequest; export type AllocateStaticIpCommandOutput = AllocateStaticIpResult & __MetadataBearer; +/** + *

Allocates a static IP address.

+ */ export class AllocateStaticIpCommand extends $Command< AllocateStaticIpCommandInput, AllocateStaticIpCommandOutput, @@ -34,6 +37,9 @@ export class AllocateStaticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/AttachCertificateToDistributionCommand.ts b/clients/client-lightsail/commands/AttachCertificateToDistributionCommand.ts index cf8d0b8d83f97..485091a51553e 100644 --- a/clients/client-lightsail/commands/AttachCertificateToDistributionCommand.ts +++ b/clients/client-lightsail/commands/AttachCertificateToDistributionCommand.ts @@ -20,6 +20,20 @@ import { export type AttachCertificateToDistributionCommandInput = AttachCertificateToDistributionRequest; export type AttachCertificateToDistributionCommandOutput = AttachCertificateToDistributionResult & __MetadataBearer; +/** + *

Attaches an SSL/TLS certificate to your Amazon Lightsail content delivery network (CDN) + * distribution.

+ *

After the certificate is attached, your distribution accepts HTTPS traffic for all of the + * domains that are associated with the certificate.

+ *

Use the CreateCertificate action to create a certificate that you can attach + * to your distribution.

+ * + *

Only certificates created in the us-east-1 AWS Region can be attached to + * Lightsail distributions. Lightsail distributions are global resources that can reference + * an origin in any AWS Region, and distribute its content globally. However, all + * distributions are located in the us-east-1 Region.

+ *
+ */ export class AttachCertificateToDistributionCommand extends $Command< AttachCertificateToDistributionCommandInput, AttachCertificateToDistributionCommandOutput, @@ -34,6 +48,9 @@ export class AttachCertificateToDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/AttachDiskCommand.ts b/clients/client-lightsail/commands/AttachDiskCommand.ts index 8e97f95a44f2d..a5e497a5ba3dc 100644 --- a/clients/client-lightsail/commands/AttachDiskCommand.ts +++ b/clients/client-lightsail/commands/AttachDiskCommand.ts @@ -20,6 +20,13 @@ import { export type AttachDiskCommandInput = AttachDiskRequest; export type AttachDiskCommandOutput = AttachDiskResult & __MetadataBearer; +/** + *

Attaches a block storage disk to a running or stopped Lightsail instance and exposes it + * to the instance with the specified disk name.

+ *

The attach disk operation supports tag-based access control via resource tags + * applied to the resource identified by disk name. For more information, see the + * Lightsail Dev Guide.

+ */ export class AttachDiskCommand extends $Command< AttachDiskCommandInput, AttachDiskCommandOutput, @@ -34,6 +41,9 @@ export class AttachDiskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/AttachInstancesToLoadBalancerCommand.ts b/clients/client-lightsail/commands/AttachInstancesToLoadBalancerCommand.ts index 4647935c55aa4..4118638673989 100644 --- a/clients/client-lightsail/commands/AttachInstancesToLoadBalancerCommand.ts +++ b/clients/client-lightsail/commands/AttachInstancesToLoadBalancerCommand.ts @@ -20,6 +20,14 @@ import { export type AttachInstancesToLoadBalancerCommandInput = AttachInstancesToLoadBalancerRequest; export type AttachInstancesToLoadBalancerCommandOutput = AttachInstancesToLoadBalancerResult & __MetadataBearer; +/** + *

Attaches one or more Lightsail instances to a load balancer.

+ *

After some time, the instances are attached to the load balancer and the health check + * status is available.

+ *

The attach instances to load balancer operation supports tag-based access + * control via resource tags applied to the resource identified by load balancer + * name. For more information, see the Lightsail Dev Guide.

+ */ export class AttachInstancesToLoadBalancerCommand extends $Command< AttachInstancesToLoadBalancerCommandInput, AttachInstancesToLoadBalancerCommandOutput, @@ -34,6 +42,9 @@ export class AttachInstancesToLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/AttachLoadBalancerTlsCertificateCommand.ts b/clients/client-lightsail/commands/AttachLoadBalancerTlsCertificateCommand.ts index 339c5ad35a191..8f0e8f19443ce 100644 --- a/clients/client-lightsail/commands/AttachLoadBalancerTlsCertificateCommand.ts +++ b/clients/client-lightsail/commands/AttachLoadBalancerTlsCertificateCommand.ts @@ -20,6 +20,17 @@ import { export type AttachLoadBalancerTlsCertificateCommandInput = AttachLoadBalancerTlsCertificateRequest; export type AttachLoadBalancerTlsCertificateCommandOutput = AttachLoadBalancerTlsCertificateResult & __MetadataBearer; +/** + *

Attaches a Transport Layer Security (TLS) certificate to your load balancer. TLS is just + * an updated, more secure version of Secure Socket Layer (SSL).

+ *

Once you create and validate your certificate, you can attach it to your load balancer. + * You can also use this API to rotate the certificates on your account. Use the + * AttachLoadBalancerTlsCertificate action with the non-attached certificate, and + * it will replace the existing one and become the attached certificate.

+ *

The AttachLoadBalancerTlsCertificate operation supports tag-based access + * control via resource tags applied to the resource identified by load balancer + * name. For more information, see the Lightsail Dev Guide.

+ */ export class AttachLoadBalancerTlsCertificateCommand extends $Command< AttachLoadBalancerTlsCertificateCommandInput, AttachLoadBalancerTlsCertificateCommandOutput, @@ -34,6 +45,9 @@ export class AttachLoadBalancerTlsCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/AttachStaticIpCommand.ts b/clients/client-lightsail/commands/AttachStaticIpCommand.ts index 8abab0dc2b65e..e59927697e6ff 100644 --- a/clients/client-lightsail/commands/AttachStaticIpCommand.ts +++ b/clients/client-lightsail/commands/AttachStaticIpCommand.ts @@ -20,6 +20,9 @@ import { export type AttachStaticIpCommandInput = AttachStaticIpRequest; export type AttachStaticIpCommandOutput = AttachStaticIpResult & __MetadataBearer; +/** + *

Attaches a static IP address to a specific Amazon Lightsail instance.

+ */ export class AttachStaticIpCommand extends $Command< AttachStaticIpCommandInput, AttachStaticIpCommandOutput, @@ -34,6 +37,9 @@ export class AttachStaticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CloseInstancePublicPortsCommand.ts b/clients/client-lightsail/commands/CloseInstancePublicPortsCommand.ts index 744d481910c07..1d1a5b24ab0ff 100644 --- a/clients/client-lightsail/commands/CloseInstancePublicPortsCommand.ts +++ b/clients/client-lightsail/commands/CloseInstancePublicPortsCommand.ts @@ -20,6 +20,12 @@ import { export type CloseInstancePublicPortsCommandInput = CloseInstancePublicPortsRequest; export type CloseInstancePublicPortsCommandOutput = CloseInstancePublicPortsResult & __MetadataBearer; +/** + *

Closes ports for a specific Amazon Lightsail instance.

+ *

The CloseInstancePublicPorts action supports tag-based access control via + * resource tags applied to the resource identified by instanceName. For more + * information, see the Lightsail Dev Guide.

+ */ export class CloseInstancePublicPortsCommand extends $Command< CloseInstancePublicPortsCommandInput, CloseInstancePublicPortsCommandOutput, @@ -34,6 +40,9 @@ export class CloseInstancePublicPortsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CopySnapshotCommand.ts b/clients/client-lightsail/commands/CopySnapshotCommand.ts index 59554304bda34..4486a78c53ac1 100644 --- a/clients/client-lightsail/commands/CopySnapshotCommand.ts +++ b/clients/client-lightsail/commands/CopySnapshotCommand.ts @@ -20,6 +20,19 @@ import { export type CopySnapshotCommandInput = CopySnapshotRequest; export type CopySnapshotCommandOutput = CopySnapshotResult & __MetadataBearer; +/** + *

Copies a manual snapshot of an instance or disk as another manual snapshot, or copies an + * automatic snapshot of an instance or disk as a manual snapshot. This operation can also be + * used to copy a manual or automatic snapshot of an instance or a disk from one AWS Region to + * another in Amazon Lightsail.

+ *

When copying a manual snapshot, be sure to define the source + * region, source snapshot name, and target snapshot name + * parameters.

+ *

When copying an automatic snapshot, be sure to define the + * source region, source resource name, target snapshot + * name, and either the restore date or the use latest restorable + * auto snapshot parameters.

+ */ export class CopySnapshotCommand extends $Command< CopySnapshotCommandInput, CopySnapshotCommandOutput, @@ -34,6 +47,9 @@ export class CopySnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateCertificateCommand.ts b/clients/client-lightsail/commands/CreateCertificateCommand.ts index 86f34468f74a3..1d1e735d9d77d 100644 --- a/clients/client-lightsail/commands/CreateCertificateCommand.ts +++ b/clients/client-lightsail/commands/CreateCertificateCommand.ts @@ -20,6 +20,18 @@ import { export type CreateCertificateCommandInput = CreateCertificateRequest; export type CreateCertificateCommandOutput = CreateCertificateResult & __MetadataBearer; +/** + *

Creates an SSL/TLS certificate for a Amazon Lightsail content delivery network (CDN) + * distribution.

+ *

After the certificate is created, use the AttachCertificateToDistribution + * action to attach the certificate to your distribution.

+ * + *

Only certificates created in the us-east-1 AWS Region can be attached to + * Lightsail distributions. Lightsail distributions are global resources that can reference + * an origin in any AWS Region, and distribute its content globally. However, all + * distributions are located in the us-east-1 Region.

+ *
+ */ export class CreateCertificateCommand extends $Command< CreateCertificateCommandInput, CreateCertificateCommandOutput, @@ -34,6 +46,9 @@ export class CreateCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateCloudFormationStackCommand.ts b/clients/client-lightsail/commands/CreateCloudFormationStackCommand.ts index 14d84103c3d2f..6825c773cd717 100644 --- a/clients/client-lightsail/commands/CreateCloudFormationStackCommand.ts +++ b/clients/client-lightsail/commands/CreateCloudFormationStackCommand.ts @@ -20,6 +20,16 @@ import { export type CreateCloudFormationStackCommandInput = CreateCloudFormationStackRequest; export type CreateCloudFormationStackCommandOutput = CreateCloudFormationStackResult & __MetadataBearer; +/** + *

Creates an AWS CloudFormation stack, which creates a new Amazon EC2 instance from an exported + * Amazon Lightsail snapshot. This operation results in a CloudFormation stack record that can be + * used to track the AWS CloudFormation stack created. Use the get cloud formation stack + * records operation to get a list of the CloudFormation stacks created.

+ * + *

Wait until after your new Amazon EC2 instance is created before running the create + * cloud formation stack operation again with the same export snapshot record.

+ *
+ */ export class CreateCloudFormationStackCommand extends $Command< CreateCloudFormationStackCommandInput, CreateCloudFormationStackCommandOutput, @@ -34,6 +44,9 @@ export class CreateCloudFormationStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateContactMethodCommand.ts b/clients/client-lightsail/commands/CreateContactMethodCommand.ts index 90d5759ad7009..60d518a05841e 100644 --- a/clients/client-lightsail/commands/CreateContactMethodCommand.ts +++ b/clients/client-lightsail/commands/CreateContactMethodCommand.ts @@ -20,6 +20,13 @@ import { export type CreateContactMethodCommandInput = CreateContactMethodRequest; export type CreateContactMethodCommandOutput = CreateContactMethodResult & __MetadataBearer; +/** + *

Creates an email or SMS text message contact method.

+ *

A contact method is used to send you notifications about your Amazon Lightsail resources. + * You can add one email address and one mobile phone number contact method in each AWS Region. + * However, SMS text messaging is not supported in some AWS Regions, and SMS text messages + * cannot be sent to some countries/regions. For more information, see Notifications in Amazon Lightsail.

+ */ export class CreateContactMethodCommand extends $Command< CreateContactMethodCommandInput, CreateContactMethodCommandOutput, @@ -34,6 +41,9 @@ export class CreateContactMethodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateContainerServiceCommand.ts b/clients/client-lightsail/commands/CreateContainerServiceCommand.ts index 43cbf3d2f9de0..86c96766e0ef4 100644 --- a/clients/client-lightsail/commands/CreateContainerServiceCommand.ts +++ b/clients/client-lightsail/commands/CreateContainerServiceCommand.ts @@ -20,6 +20,13 @@ import { export type CreateContainerServiceCommandInput = CreateContainerServiceRequest; export type CreateContainerServiceCommandOutput = CreateContainerServiceResult & __MetadataBearer; +/** + *

Creates an Amazon Lightsail container service.

+ * + *

A Lightsail container service is a compute resource to which you can deploy containers. + * For more information, see Container services in Amazon Lightsail in the Lightsail Dev + * Guide.

+ */ export class CreateContainerServiceCommand extends $Command< CreateContainerServiceCommandInput, CreateContainerServiceCommandOutput, @@ -34,6 +41,9 @@ export class CreateContainerServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateContainerServiceDeploymentCommand.ts b/clients/client-lightsail/commands/CreateContainerServiceDeploymentCommand.ts index cb41db6f677b3..1dfa3488bfe6b 100644 --- a/clients/client-lightsail/commands/CreateContainerServiceDeploymentCommand.ts +++ b/clients/client-lightsail/commands/CreateContainerServiceDeploymentCommand.ts @@ -20,6 +20,19 @@ import { export type CreateContainerServiceDeploymentCommandInput = CreateContainerServiceDeploymentRequest; export type CreateContainerServiceDeploymentCommandOutput = CreateContainerServiceDeploymentResult & __MetadataBearer; +/** + *

Creates a deployment for your Amazon Lightsail container service.

+ * + *

A deployment specifies the containers that will be launched on the container service and + * their settings, such as the ports to open, the environment variables to apply, and the launch + * command to run. It also specifies the container that will serve as the public endpoint of the + * deployment and its settings, such as the HTTP or HTTPS port to use, and the health check + * configuration.

+ * + *

You can deploy containers to your container service using container images from a public + * registry like Docker Hub, or from your local machine. For more information, see Creating container images for your Amazon Lightsail container services in the + * Lightsail Dev Guide.

+ */ export class CreateContainerServiceDeploymentCommand extends $Command< CreateContainerServiceDeploymentCommandInput, CreateContainerServiceDeploymentCommandOutput, @@ -34,6 +47,9 @@ export class CreateContainerServiceDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateContainerServiceRegistryLoginCommand.ts b/clients/client-lightsail/commands/CreateContainerServiceRegistryLoginCommand.ts index 4db79705b0993..58beeb93f62bc 100644 --- a/clients/client-lightsail/commands/CreateContainerServiceRegistryLoginCommand.ts +++ b/clients/client-lightsail/commands/CreateContainerServiceRegistryLoginCommand.ts @@ -24,6 +24,32 @@ export type CreateContainerServiceRegistryLoginCommandInput = CreateContainerSer export type CreateContainerServiceRegistryLoginCommandOutput = CreateContainerServiceRegistryLoginResult & __MetadataBearer; +/** + *

Creates a temporary set of log in credentials that you can use to log in to the Docker + * process on your local machine. After you're logged in, you can use the native Docker commands + * to push your local container images to the container image registry of your Amazon Lightsail + * account so that you can use them with your Lightsail container service. The log in + * credentials expire 12 hours after they are created, at which point you will need to create a + * new set of log in credentials.

+ * + * + *

You can only push container images to the container service registry of your Lightsail + * account. You cannot pull container images perform any other container image management + * actions on the container service registry of your Lightsail account.

+ *
+ * + *

After you push your container images to the container image registry of your Lightsail + * account, use the RegisterContainerImage action to register the pushed images to a + * specific Lightsail container service.

+ * + * + *

This action is not required if you install and use the Lightsail Control + * (lightsailctl) plugin to push container images to your Lightsail container service. For + * more information, see Pushing and + * managing container images on your Amazon Lightsail container services in the + * Lightsail Dev Guide.

+ *
+ */ export class CreateContainerServiceRegistryLoginCommand extends $Command< CreateContainerServiceRegistryLoginCommandInput, CreateContainerServiceRegistryLoginCommandOutput, @@ -38,6 +64,9 @@ export class CreateContainerServiceRegistryLoginCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateDiskCommand.ts b/clients/client-lightsail/commands/CreateDiskCommand.ts index 2367dad67a4f6..b4ff936cda303 100644 --- a/clients/client-lightsail/commands/CreateDiskCommand.ts +++ b/clients/client-lightsail/commands/CreateDiskCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDiskCommandInput = CreateDiskRequest; export type CreateDiskCommandOutput = CreateDiskResult & __MetadataBearer; +/** + *

Creates a block storage disk that can be attached to an Amazon Lightsail instance in the + * same Availability Zone (e.g., us-east-2a).

+ *

The create disk operation supports tag-based access control via request tags. + * For more information, see the Lightsail Dev Guide.

+ */ export class CreateDiskCommand extends $Command< CreateDiskCommandInput, CreateDiskCommandOutput, @@ -34,6 +40,9 @@ export class CreateDiskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateDiskFromSnapshotCommand.ts b/clients/client-lightsail/commands/CreateDiskFromSnapshotCommand.ts index 7a1731dac2136..2df7728ff223c 100644 --- a/clients/client-lightsail/commands/CreateDiskFromSnapshotCommand.ts +++ b/clients/client-lightsail/commands/CreateDiskFromSnapshotCommand.ts @@ -20,6 +20,14 @@ import { export type CreateDiskFromSnapshotCommandInput = CreateDiskFromSnapshotRequest; export type CreateDiskFromSnapshotCommandOutput = CreateDiskFromSnapshotResult & __MetadataBearer; +/** + *

Creates a block storage disk from a manual or automatic snapshot of a disk. The resulting + * disk can be attached to an Amazon Lightsail instance in the same Availability Zone (e.g., + * us-east-2a).

+ *

The create disk from snapshot operation supports tag-based access control via + * request tags and resource tags applied to the resource identified by disk snapshot + * name. For more information, see the Lightsail Dev Guide.

+ */ export class CreateDiskFromSnapshotCommand extends $Command< CreateDiskFromSnapshotCommandInput, CreateDiskFromSnapshotCommandOutput, @@ -34,6 +42,9 @@ export class CreateDiskFromSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateDiskSnapshotCommand.ts b/clients/client-lightsail/commands/CreateDiskSnapshotCommand.ts index 11433cda5573d..5e49d7051a7e0 100644 --- a/clients/client-lightsail/commands/CreateDiskSnapshotCommand.ts +++ b/clients/client-lightsail/commands/CreateDiskSnapshotCommand.ts @@ -20,6 +20,28 @@ import { export type CreateDiskSnapshotCommandInput = CreateDiskSnapshotRequest; export type CreateDiskSnapshotCommandOutput = CreateDiskSnapshotResult & __MetadataBearer; +/** + *

Creates a snapshot of a block storage disk. You can use snapshots for backups, to make + * copies of disks, and to save data before shutting down a Lightsail instance.

+ *

You can take a snapshot of an attached disk that is in use; however, snapshots only + * capture data that has been written to your disk at the time the snapshot command is issued. + * This may exclude any data that has been cached by any applications or the operating system. If + * you can pause any file systems on the disk long enough to take a snapshot, your snapshot + * should be complete. Nevertheless, if you cannot pause all file writes to the disk, you should + * unmount the disk from within the Lightsail instance, issue the create disk snapshot command, + * and then remount the disk to ensure a consistent and complete snapshot. You may remount and + * use your disk while the snapshot status is pending.

+ *

You can also use this operation to create a snapshot of an instance's system volume. You + * might want to do this, for example, to recover data from the system volume of a botched + * instance or to create a backup of the system volume like you would for a block storage disk. + * To create a snapshot of a system volume, just define the instance name parameter + * when issuing the snapshot command, and a snapshot of the defined instance's system volume will + * be created. After the snapshot is available, you can create a block storage disk from the + * snapshot and attach it to a running instance to access the data on the disk.

+ * + *

The create disk snapshot operation supports tag-based access control via + * request tags. For more information, see the Lightsail Dev Guide.

+ */ export class CreateDiskSnapshotCommand extends $Command< CreateDiskSnapshotCommandInput, CreateDiskSnapshotCommandOutput, @@ -34,6 +56,9 @@ export class CreateDiskSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateDistributionCommand.ts b/clients/client-lightsail/commands/CreateDistributionCommand.ts index cf6132c9fe40e..d3d00abbf3866 100644 --- a/clients/client-lightsail/commands/CreateDistributionCommand.ts +++ b/clients/client-lightsail/commands/CreateDistributionCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDistributionCommandInput = CreateDistributionRequest; export type CreateDistributionCommandOutput = CreateDistributionResult & __MetadataBearer; +/** + *

Creates an Amazon Lightsail content delivery network (CDN) distribution.

+ *

A distribution is a globally distributed network of caching servers that improve the + * performance of your website or web application hosted on a Lightsail instance. For more + * information, see Content delivery networks in Amazon Lightsail.

+ */ export class CreateDistributionCommand extends $Command< CreateDistributionCommandInput, CreateDistributionCommandOutput, @@ -34,6 +40,9 @@ export class CreateDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateDomainCommand.ts b/clients/client-lightsail/commands/CreateDomainCommand.ts index 89f9cc1c3d1b2..1d198a7c9ad62 100644 --- a/clients/client-lightsail/commands/CreateDomainCommand.ts +++ b/clients/client-lightsail/commands/CreateDomainCommand.ts @@ -20,6 +20,11 @@ import { export type CreateDomainCommandInput = CreateDomainRequest; export type CreateDomainCommandOutput = CreateDomainResult & __MetadataBearer; +/** + *

Creates a domain resource for the specified domain (e.g., example.com).

+ *

The create domain operation supports tag-based access control via request + * tags. For more information, see the Lightsail Dev Guide.

+ */ export class CreateDomainCommand extends $Command< CreateDomainCommandInput, CreateDomainCommandOutput, @@ -34,6 +39,9 @@ export class CreateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateDomainEntryCommand.ts b/clients/client-lightsail/commands/CreateDomainEntryCommand.ts index 3caffbaaea0ae..a2c3fd542b0b7 100644 --- a/clients/client-lightsail/commands/CreateDomainEntryCommand.ts +++ b/clients/client-lightsail/commands/CreateDomainEntryCommand.ts @@ -20,6 +20,17 @@ import { export type CreateDomainEntryCommandInput = CreateDomainEntryRequest; export type CreateDomainEntryCommandOutput = CreateDomainEntryResult & __MetadataBearer; +/** + *

Creates one of the following domain name system (DNS) records in a domain DNS zone: + * Address (A), canonical name (CNAME), mail exchanger (MX), name server (NS), start of authority + * (SOA), service locator (SRV), or text (TXT).

+ * + * + * + *

The create domain entry operation supports tag-based access control via + * resource tags applied to the resource identified by domain name. For more + * information, see the Lightsail Dev Guide.

+ */ export class CreateDomainEntryCommand extends $Command< CreateDomainEntryCommandInput, CreateDomainEntryCommandOutput, @@ -34,6 +45,9 @@ export class CreateDomainEntryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateInstanceSnapshotCommand.ts b/clients/client-lightsail/commands/CreateInstanceSnapshotCommand.ts index e0089bb90e20f..e57685e967545 100644 --- a/clients/client-lightsail/commands/CreateInstanceSnapshotCommand.ts +++ b/clients/client-lightsail/commands/CreateInstanceSnapshotCommand.ts @@ -20,6 +20,12 @@ import { export type CreateInstanceSnapshotCommandInput = CreateInstanceSnapshotRequest; export type CreateInstanceSnapshotCommandOutput = CreateInstanceSnapshotResult & __MetadataBearer; +/** + *

Creates a snapshot of a specific virtual private server, or instance. + * You can use a snapshot to create a new instance that is based on that snapshot.

+ *

The create instance snapshot operation supports tag-based access control via + * request tags. For more information, see the Lightsail Dev Guide.

+ */ export class CreateInstanceSnapshotCommand extends $Command< CreateInstanceSnapshotCommandInput, CreateInstanceSnapshotCommandOutput, @@ -34,6 +40,9 @@ export class CreateInstanceSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateInstancesCommand.ts b/clients/client-lightsail/commands/CreateInstancesCommand.ts index b1a799e1f3193..2d4f6ecc903ce 100644 --- a/clients/client-lightsail/commands/CreateInstancesCommand.ts +++ b/clients/client-lightsail/commands/CreateInstancesCommand.ts @@ -20,6 +20,11 @@ import { export type CreateInstancesCommandInput = CreateInstancesRequest; export type CreateInstancesCommandOutput = CreateInstancesResult & __MetadataBearer; +/** + *

Creates one or more Amazon Lightsail instances.

+ *

The create instances operation supports tag-based access control via request + * tags. For more information, see the Lightsail Dev Guide.

+ */ export class CreateInstancesCommand extends $Command< CreateInstancesCommandInput, CreateInstancesCommandOutput, @@ -34,6 +39,9 @@ export class CreateInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateInstancesFromSnapshotCommand.ts b/clients/client-lightsail/commands/CreateInstancesFromSnapshotCommand.ts index fa85f02c5b849..d822142f1fd06 100644 --- a/clients/client-lightsail/commands/CreateInstancesFromSnapshotCommand.ts +++ b/clients/client-lightsail/commands/CreateInstancesFromSnapshotCommand.ts @@ -20,6 +20,13 @@ import { export type CreateInstancesFromSnapshotCommandInput = CreateInstancesFromSnapshotRequest; export type CreateInstancesFromSnapshotCommandOutput = CreateInstancesFromSnapshotResult & __MetadataBearer; +/** + *

Creates one or more new instances from a manual or automatic snapshot of an + * instance.

+ *

The create instances from snapshot operation supports tag-based access + * control via request tags and resource tags applied to the resource identified by + * instance snapshot name. For more information, see the Lightsail Dev Guide.

+ */ export class CreateInstancesFromSnapshotCommand extends $Command< CreateInstancesFromSnapshotCommandInput, CreateInstancesFromSnapshotCommandOutput, @@ -34,6 +41,9 @@ export class CreateInstancesFromSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateKeyPairCommand.ts b/clients/client-lightsail/commands/CreateKeyPairCommand.ts index 880f34885d3d4..08848a562f9be 100644 --- a/clients/client-lightsail/commands/CreateKeyPairCommand.ts +++ b/clients/client-lightsail/commands/CreateKeyPairCommand.ts @@ -20,6 +20,11 @@ import { export type CreateKeyPairCommandInput = CreateKeyPairRequest; export type CreateKeyPairCommandOutput = CreateKeyPairResult & __MetadataBearer; +/** + *

Creates an SSH key pair.

+ *

The create key pair operation supports tag-based access control via request + * tags. For more information, see the Lightsail Dev Guide.

+ */ export class CreateKeyPairCommand extends $Command< CreateKeyPairCommandInput, CreateKeyPairCommandOutput, @@ -34,6 +39,9 @@ export class CreateKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateLoadBalancerCommand.ts b/clients/client-lightsail/commands/CreateLoadBalancerCommand.ts index 11eb91b2947fa..3569a26dad25d 100644 --- a/clients/client-lightsail/commands/CreateLoadBalancerCommand.ts +++ b/clients/client-lightsail/commands/CreateLoadBalancerCommand.ts @@ -20,6 +20,16 @@ import { export type CreateLoadBalancerCommandInput = CreateLoadBalancerRequest; export type CreateLoadBalancerCommandOutput = CreateLoadBalancerResult & __MetadataBearer; +/** + *

Creates a Lightsail load balancer. To learn more about deciding whether to load balance + * your application, see Configure your Lightsail instances for load balancing. You can create up to 5 + * load balancers per AWS Region in your account.

+ *

When you create a load balancer, you can specify a unique name and port settings. To + * change additional load balancer settings, use the UpdateLoadBalancerAttribute + * operation.

+ *

The create load balancer operation supports tag-based access control via + * request tags. For more information, see the Lightsail Dev Guide.

+ */ export class CreateLoadBalancerCommand extends $Command< CreateLoadBalancerCommandInput, CreateLoadBalancerCommandOutput, @@ -34,6 +44,9 @@ export class CreateLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateLoadBalancerTlsCertificateCommand.ts b/clients/client-lightsail/commands/CreateLoadBalancerTlsCertificateCommand.ts index 64e38aa880547..1945cc8052ac3 100644 --- a/clients/client-lightsail/commands/CreateLoadBalancerTlsCertificateCommand.ts +++ b/clients/client-lightsail/commands/CreateLoadBalancerTlsCertificateCommand.ts @@ -20,6 +20,13 @@ import { export type CreateLoadBalancerTlsCertificateCommandInput = CreateLoadBalancerTlsCertificateRequest; export type CreateLoadBalancerTlsCertificateCommandOutput = CreateLoadBalancerTlsCertificateResult & __MetadataBearer; +/** + *

Creates a Lightsail load balancer TLS certificate.

+ *

TLS is just an updated, more secure version of Secure Socket Layer (SSL).

+ *

The CreateLoadBalancerTlsCertificate operation supports tag-based access + * control via resource tags applied to the resource identified by load balancer + * name. For more information, see the Lightsail Dev Guide.

+ */ export class CreateLoadBalancerTlsCertificateCommand extends $Command< CreateLoadBalancerTlsCertificateCommandInput, CreateLoadBalancerTlsCertificateCommandOutput, @@ -34,6 +41,9 @@ export class CreateLoadBalancerTlsCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateRelationalDatabaseCommand.ts b/clients/client-lightsail/commands/CreateRelationalDatabaseCommand.ts index 0874a1523b8e7..1d63d1199dbbc 100644 --- a/clients/client-lightsail/commands/CreateRelationalDatabaseCommand.ts +++ b/clients/client-lightsail/commands/CreateRelationalDatabaseCommand.ts @@ -20,6 +20,11 @@ import { export type CreateRelationalDatabaseCommandInput = CreateRelationalDatabaseRequest; export type CreateRelationalDatabaseCommandOutput = CreateRelationalDatabaseResult & __MetadataBearer; +/** + *

Creates a new database in Amazon Lightsail.

+ *

The create relational database operation supports tag-based access control + * via request tags. For more information, see the Lightsail Dev Guide.

+ */ export class CreateRelationalDatabaseCommand extends $Command< CreateRelationalDatabaseCommandInput, CreateRelationalDatabaseCommandOutput, @@ -34,6 +39,9 @@ export class CreateRelationalDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateRelationalDatabaseFromSnapshotCommand.ts b/clients/client-lightsail/commands/CreateRelationalDatabaseFromSnapshotCommand.ts index bf88fbfb16569..575f473b334b2 100644 --- a/clients/client-lightsail/commands/CreateRelationalDatabaseFromSnapshotCommand.ts +++ b/clients/client-lightsail/commands/CreateRelationalDatabaseFromSnapshotCommand.ts @@ -24,6 +24,15 @@ export type CreateRelationalDatabaseFromSnapshotCommandInput = CreateRelationalD export type CreateRelationalDatabaseFromSnapshotCommandOutput = CreateRelationalDatabaseFromSnapshotResult & __MetadataBearer; +/** + *

Creates a new database from an existing database snapshot in Amazon Lightsail.

+ *

You can create a new database from a snapshot in if something goes wrong with your + * original database, or to change it to a different plan, such as a high availability or + * standard plan.

+ *

The create relational database from snapshot operation supports tag-based + * access control via request tags and resource tags applied to the resource identified by + * relationalDatabaseSnapshotName. For more information, see the Lightsail Dev Guide.

+ */ export class CreateRelationalDatabaseFromSnapshotCommand extends $Command< CreateRelationalDatabaseFromSnapshotCommandInput, CreateRelationalDatabaseFromSnapshotCommandOutput, @@ -38,6 +47,9 @@ export class CreateRelationalDatabaseFromSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/CreateRelationalDatabaseSnapshotCommand.ts b/clients/client-lightsail/commands/CreateRelationalDatabaseSnapshotCommand.ts index 157f0bfdc1a42..95d0c345a7550 100644 --- a/clients/client-lightsail/commands/CreateRelationalDatabaseSnapshotCommand.ts +++ b/clients/client-lightsail/commands/CreateRelationalDatabaseSnapshotCommand.ts @@ -20,6 +20,12 @@ import { export type CreateRelationalDatabaseSnapshotCommandInput = CreateRelationalDatabaseSnapshotRequest; export type CreateRelationalDatabaseSnapshotCommandOutput = CreateRelationalDatabaseSnapshotResult & __MetadataBearer; +/** + *

Creates a snapshot of your database in Amazon Lightsail. You can use snapshots for backups, + * to make copies of a database, and to save data before deleting a database.

+ *

The create relational database snapshot operation supports tag-based access + * control via request tags. For more information, see the Lightsail Dev Guide.

+ */ export class CreateRelationalDatabaseSnapshotCommand extends $Command< CreateRelationalDatabaseSnapshotCommandInput, CreateRelationalDatabaseSnapshotCommandOutput, @@ -34,6 +40,9 @@ export class CreateRelationalDatabaseSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteAlarmCommand.ts b/clients/client-lightsail/commands/DeleteAlarmCommand.ts index 7fa8e7ba6cf66..fcdf75b89578b 100644 --- a/clients/client-lightsail/commands/DeleteAlarmCommand.ts +++ b/clients/client-lightsail/commands/DeleteAlarmCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteAlarmCommandInput = DeleteAlarmRequest; export type DeleteAlarmCommandOutput = DeleteAlarmResult & __MetadataBearer; +/** + *

Deletes an alarm.

+ *

An alarm is used to monitor a single metric for one of your resources. When a metric + * condition is met, the alarm can notify you by email, SMS text message, and a banner displayed + * on the Amazon Lightsail console. For more information, see Alarms + * in Amazon Lightsail.

+ */ export class DeleteAlarmCommand extends $Command< DeleteAlarmCommandInput, DeleteAlarmCommandOutput, @@ -34,6 +41,9 @@ export class DeleteAlarmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteAutoSnapshotCommand.ts b/clients/client-lightsail/commands/DeleteAutoSnapshotCommand.ts index af6cd812d0b9e..48c9e088799cd 100644 --- a/clients/client-lightsail/commands/DeleteAutoSnapshotCommand.ts +++ b/clients/client-lightsail/commands/DeleteAutoSnapshotCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAutoSnapshotCommandInput = DeleteAutoSnapshotRequest; export type DeleteAutoSnapshotCommandOutput = DeleteAutoSnapshotResult & __MetadataBearer; +/** + *

Deletes an automatic snapshot of an instance or disk. For more information, see the Lightsail Dev Guide.

+ */ export class DeleteAutoSnapshotCommand extends $Command< DeleteAutoSnapshotCommandInput, DeleteAutoSnapshotCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAutoSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteCertificateCommand.ts b/clients/client-lightsail/commands/DeleteCertificateCommand.ts index 8afdeff5854ec..6da0c612347aa 100644 --- a/clients/client-lightsail/commands/DeleteCertificateCommand.ts +++ b/clients/client-lightsail/commands/DeleteCertificateCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteCertificateCommandInput = DeleteCertificateRequest; export type DeleteCertificateCommandOutput = DeleteCertificateResult & __MetadataBearer; +/** + *

Deletes an SSL/TLS certificate for your Amazon Lightsail content delivery network (CDN) + * distribution.

+ *

Certificates that are currently attached to a distribution cannot be deleted. Use the + * DetachCertificateFromDistribution action to detach a certificate from a + * distribution.

+ */ export class DeleteCertificateCommand extends $Command< DeleteCertificateCommandInput, DeleteCertificateCommandOutput, @@ -34,6 +41,9 @@ export class DeleteCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteContactMethodCommand.ts b/clients/client-lightsail/commands/DeleteContactMethodCommand.ts index 901229bf0bdf3..e8235b22488f4 100644 --- a/clients/client-lightsail/commands/DeleteContactMethodCommand.ts +++ b/clients/client-lightsail/commands/DeleteContactMethodCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteContactMethodCommandInput = DeleteContactMethodRequest; export type DeleteContactMethodCommandOutput = DeleteContactMethodResult & __MetadataBearer; +/** + *

Deletes a contact method.

+ *

A contact method is used to send you notifications about your Amazon Lightsail resources. + * You can add one email address and one mobile phone number contact method in each AWS Region. + * However, SMS text messaging is not supported in some AWS Regions, and SMS text messages + * cannot be sent to some countries/regions. For more information, see Notifications in Amazon Lightsail.

+ */ export class DeleteContactMethodCommand extends $Command< DeleteContactMethodCommandInput, DeleteContactMethodCommandOutput, @@ -34,6 +41,9 @@ export class DeleteContactMethodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteContainerImageCommand.ts b/clients/client-lightsail/commands/DeleteContainerImageCommand.ts index 59c7692de3db1..d3a7a7494b4f1 100644 --- a/clients/client-lightsail/commands/DeleteContainerImageCommand.ts +++ b/clients/client-lightsail/commands/DeleteContainerImageCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteContainerImageCommandInput = DeleteContainerImageRequest; export type DeleteContainerImageCommandOutput = DeleteContainerImageResult & __MetadataBearer; +/** + *

Deletes a container image that is registered to your Amazon Lightsail container + * service.

+ */ export class DeleteContainerImageCommand extends $Command< DeleteContainerImageCommandInput, DeleteContainerImageCommandOutput, @@ -34,6 +38,9 @@ export class DeleteContainerImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteContainerServiceCommand.ts b/clients/client-lightsail/commands/DeleteContainerServiceCommand.ts index 73a3887c8b3ed..2013a8cf4212b 100644 --- a/clients/client-lightsail/commands/DeleteContainerServiceCommand.ts +++ b/clients/client-lightsail/commands/DeleteContainerServiceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteContainerServiceCommandInput = DeleteContainerServiceRequest; export type DeleteContainerServiceCommandOutput = DeleteContainerServiceResult & __MetadataBearer; +/** + *

Deletes your Amazon Lightsail container service.

+ */ export class DeleteContainerServiceCommand extends $Command< DeleteContainerServiceCommandInput, DeleteContainerServiceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteContainerServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteDiskCommand.ts b/clients/client-lightsail/commands/DeleteDiskCommand.ts index f6b28134d1f1f..661caad3e08e2 100644 --- a/clients/client-lightsail/commands/DeleteDiskCommand.ts +++ b/clients/client-lightsail/commands/DeleteDiskCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteDiskCommandInput = DeleteDiskRequest; export type DeleteDiskCommandOutput = DeleteDiskResult & __MetadataBearer; +/** + *

Deletes the specified block storage disk. The disk must be in the available + * state (not attached to a Lightsail instance).

+ * + *

The disk may remain in the deleting state for several minutes.

+ *
+ *

The delete disk operation supports tag-based access control via resource tags + * applied to the resource identified by disk name. For more information, see the + * Lightsail Dev Guide.

+ */ export class DeleteDiskCommand extends $Command< DeleteDiskCommandInput, DeleteDiskCommandOutput, @@ -34,6 +44,9 @@ export class DeleteDiskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteDiskSnapshotCommand.ts b/clients/client-lightsail/commands/DeleteDiskSnapshotCommand.ts index c34f2f8634442..b8b3e75607873 100644 --- a/clients/client-lightsail/commands/DeleteDiskSnapshotCommand.ts +++ b/clients/client-lightsail/commands/DeleteDiskSnapshotCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteDiskSnapshotCommandInput = DeleteDiskSnapshotRequest; export type DeleteDiskSnapshotCommandOutput = DeleteDiskSnapshotResult & __MetadataBearer; +/** + *

Deletes the specified disk snapshot.

+ *

When you make periodic snapshots of a disk, the snapshots are incremental, and only the + * blocks on the device that have changed since your last snapshot are saved in the new snapshot. + * When you delete a snapshot, only the data not needed for any other snapshot is removed. So + * regardless of which prior snapshots have been deleted, all active snapshots will have access + * to all the information needed to restore the disk.

+ *

The delete disk snapshot operation supports tag-based access control via + * resource tags applied to the resource identified by disk snapshot name. For more + * information, see the Lightsail Dev Guide.

+ */ export class DeleteDiskSnapshotCommand extends $Command< DeleteDiskSnapshotCommandInput, DeleteDiskSnapshotCommandOutput, @@ -34,6 +45,9 @@ export class DeleteDiskSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteDistributionCommand.ts b/clients/client-lightsail/commands/DeleteDistributionCommand.ts index 831db8a919cc0..e18f6144ccd4f 100644 --- a/clients/client-lightsail/commands/DeleteDistributionCommand.ts +++ b/clients/client-lightsail/commands/DeleteDistributionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDistributionCommandInput = DeleteDistributionRequest; export type DeleteDistributionCommandOutput = DeleteDistributionResult & __MetadataBearer; +/** + *

Deletes your Amazon Lightsail content delivery network (CDN) distribution.

+ */ export class DeleteDistributionCommand extends $Command< DeleteDistributionCommandInput, DeleteDistributionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteDomainCommand.ts b/clients/client-lightsail/commands/DeleteDomainCommand.ts index 2ff920087c489..90cd4bbe5336c 100644 --- a/clients/client-lightsail/commands/DeleteDomainCommand.ts +++ b/clients/client-lightsail/commands/DeleteDomainCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDomainCommandInput = DeleteDomainRequest; export type DeleteDomainCommandOutput = DeleteDomainResult & __MetadataBearer; +/** + *

Deletes the specified domain recordset and all of its domain records.

+ *

The delete domain operation supports tag-based access control via resource + * tags applied to the resource identified by domain name. For more information, see + * the Lightsail Dev Guide.

+ */ export class DeleteDomainCommand extends $Command< DeleteDomainCommandInput, DeleteDomainCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteDomainEntryCommand.ts b/clients/client-lightsail/commands/DeleteDomainEntryCommand.ts index d26244b93d7ee..2a78c0a6b5015 100644 --- a/clients/client-lightsail/commands/DeleteDomainEntryCommand.ts +++ b/clients/client-lightsail/commands/DeleteDomainEntryCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDomainEntryCommandInput = DeleteDomainEntryRequest; export type DeleteDomainEntryCommandOutput = DeleteDomainEntryResult & __MetadataBearer; +/** + *

Deletes a specific domain entry.

+ *

The delete domain entry operation supports tag-based access control via + * resource tags applied to the resource identified by domain name. For more + * information, see the Lightsail Dev Guide.

+ */ export class DeleteDomainEntryCommand extends $Command< DeleteDomainEntryCommandInput, DeleteDomainEntryCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDomainEntryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteInstanceCommand.ts b/clients/client-lightsail/commands/DeleteInstanceCommand.ts index 5668c09548412..5f7198df98556 100644 --- a/clients/client-lightsail/commands/DeleteInstanceCommand.ts +++ b/clients/client-lightsail/commands/DeleteInstanceCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteInstanceCommandInput = DeleteInstanceRequest; export type DeleteInstanceCommandOutput = DeleteInstanceResult & __MetadataBearer; +/** + *

Deletes an Amazon Lightsail instance.

+ *

The delete instance operation supports tag-based access control via resource + * tags applied to the resource identified by instance name. For more information, + * see the Lightsail Dev Guide.

+ */ export class DeleteInstanceCommand extends $Command< DeleteInstanceCommandInput, DeleteInstanceCommandOutput, @@ -34,6 +40,9 @@ export class DeleteInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteInstanceSnapshotCommand.ts b/clients/client-lightsail/commands/DeleteInstanceSnapshotCommand.ts index fe04901be3698..217864b3bfecc 100644 --- a/clients/client-lightsail/commands/DeleteInstanceSnapshotCommand.ts +++ b/clients/client-lightsail/commands/DeleteInstanceSnapshotCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteInstanceSnapshotCommandInput = DeleteInstanceSnapshotRequest; export type DeleteInstanceSnapshotCommandOutput = DeleteInstanceSnapshotResult & __MetadataBearer; +/** + *

Deletes a specific snapshot of a virtual private server (or + * instance).

+ *

The delete instance snapshot operation supports tag-based access control via + * resource tags applied to the resource identified by instance snapshot name. For + * more information, see the Lightsail Dev Guide.

+ */ export class DeleteInstanceSnapshotCommand extends $Command< DeleteInstanceSnapshotCommandInput, DeleteInstanceSnapshotCommandOutput, @@ -34,6 +41,9 @@ export class DeleteInstanceSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteKeyPairCommand.ts b/clients/client-lightsail/commands/DeleteKeyPairCommand.ts index bd024c3248d0e..11c9be2a522e1 100644 --- a/clients/client-lightsail/commands/DeleteKeyPairCommand.ts +++ b/clients/client-lightsail/commands/DeleteKeyPairCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteKeyPairCommandInput = DeleteKeyPairRequest; export type DeleteKeyPairCommandOutput = DeleteKeyPairResult & __MetadataBearer; +/** + *

Deletes a specific SSH key pair.

+ *

The delete key pair operation supports tag-based access control via resource + * tags applied to the resource identified by key pair name. For more information, + * see the Lightsail Dev Guide.

+ */ export class DeleteKeyPairCommand extends $Command< DeleteKeyPairCommandInput, DeleteKeyPairCommandOutput, @@ -34,6 +40,9 @@ export class DeleteKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteKnownHostKeysCommand.ts b/clients/client-lightsail/commands/DeleteKnownHostKeysCommand.ts index 7725993869e1d..269610c742d4a 100644 --- a/clients/client-lightsail/commands/DeleteKnownHostKeysCommand.ts +++ b/clients/client-lightsail/commands/DeleteKnownHostKeysCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteKnownHostKeysCommandInput = DeleteKnownHostKeysRequest; export type DeleteKnownHostKeysCommandOutput = DeleteKnownHostKeysResult & __MetadataBearer; +/** + *

Deletes the known host key or certificate used by the Amazon Lightsail browser-based SSH or + * RDP clients to authenticate an instance. This operation enables the Lightsail browser-based + * SSH or RDP clients to connect to the instance after a host key mismatch.

+ * + *

Perform this operation only if you were expecting the host key or certificate mismatch + * or if you are familiar with the new host key or certificate on the instance. For more + * information, see Troubleshooting connection issues when using the Amazon Lightsail browser-based SSH or RDP + * client.

+ *
+ */ export class DeleteKnownHostKeysCommand extends $Command< DeleteKnownHostKeysCommandInput, DeleteKnownHostKeysCommandOutput, @@ -34,6 +45,9 @@ export class DeleteKnownHostKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteLoadBalancerCommand.ts b/clients/client-lightsail/commands/DeleteLoadBalancerCommand.ts index 0f27852d92f31..804b37c2aed1b 100644 --- a/clients/client-lightsail/commands/DeleteLoadBalancerCommand.ts +++ b/clients/client-lightsail/commands/DeleteLoadBalancerCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteLoadBalancerCommandInput = DeleteLoadBalancerRequest; export type DeleteLoadBalancerCommandOutput = DeleteLoadBalancerResult & __MetadataBearer; +/** + *

Deletes a Lightsail load balancer and all its associated SSL/TLS certificates. Once the + * load balancer is deleted, you will need to create a new load balancer, create a new + * certificate, and verify domain ownership again.

+ *

The delete load balancer operation supports tag-based access control via + * resource tags applied to the resource identified by load balancer name. For more + * information, see the Lightsail Dev Guide.

+ */ export class DeleteLoadBalancerCommand extends $Command< DeleteLoadBalancerCommandInput, DeleteLoadBalancerCommandOutput, @@ -34,6 +42,9 @@ export class DeleteLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteLoadBalancerTlsCertificateCommand.ts b/clients/client-lightsail/commands/DeleteLoadBalancerTlsCertificateCommand.ts index f6b3865439312..0b648c74b3e00 100644 --- a/clients/client-lightsail/commands/DeleteLoadBalancerTlsCertificateCommand.ts +++ b/clients/client-lightsail/commands/DeleteLoadBalancerTlsCertificateCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteLoadBalancerTlsCertificateCommandInput = DeleteLoadBalancerTlsCertificateRequest; export type DeleteLoadBalancerTlsCertificateCommandOutput = DeleteLoadBalancerTlsCertificateResult & __MetadataBearer; +/** + *

Deletes an SSL/TLS certificate associated with a Lightsail load balancer.

+ *

The DeleteLoadBalancerTlsCertificate operation supports tag-based access + * control via resource tags applied to the resource identified by load balancer + * name. For more information, see the Lightsail Dev Guide.

+ */ export class DeleteLoadBalancerTlsCertificateCommand extends $Command< DeleteLoadBalancerTlsCertificateCommandInput, DeleteLoadBalancerTlsCertificateCommandOutput, @@ -34,6 +40,9 @@ export class DeleteLoadBalancerTlsCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteRelationalDatabaseCommand.ts b/clients/client-lightsail/commands/DeleteRelationalDatabaseCommand.ts index 27af76c7741b9..528e56cc09743 100644 --- a/clients/client-lightsail/commands/DeleteRelationalDatabaseCommand.ts +++ b/clients/client-lightsail/commands/DeleteRelationalDatabaseCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteRelationalDatabaseCommandInput = DeleteRelationalDatabaseRequest; export type DeleteRelationalDatabaseCommandOutput = DeleteRelationalDatabaseResult & __MetadataBearer; +/** + *

Deletes a database in Amazon Lightsail.

+ *

The delete relational database operation supports tag-based access control + * via resource tags applied to the resource identified by relationalDatabaseName. For more + * information, see the Lightsail Dev Guide.

+ */ export class DeleteRelationalDatabaseCommand extends $Command< DeleteRelationalDatabaseCommandInput, DeleteRelationalDatabaseCommandOutput, @@ -34,6 +40,9 @@ export class DeleteRelationalDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DeleteRelationalDatabaseSnapshotCommand.ts b/clients/client-lightsail/commands/DeleteRelationalDatabaseSnapshotCommand.ts index 639ab990021e7..2825720a47ded 100644 --- a/clients/client-lightsail/commands/DeleteRelationalDatabaseSnapshotCommand.ts +++ b/clients/client-lightsail/commands/DeleteRelationalDatabaseSnapshotCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteRelationalDatabaseSnapshotCommandInput = DeleteRelationalDatabaseSnapshotRequest; export type DeleteRelationalDatabaseSnapshotCommandOutput = DeleteRelationalDatabaseSnapshotResult & __MetadataBearer; +/** + *

Deletes a database snapshot in Amazon Lightsail.

+ *

The delete relational database snapshot operation supports tag-based access + * control via resource tags applied to the resource identified by relationalDatabaseName. For + * more information, see the Lightsail Dev Guide.

+ */ export class DeleteRelationalDatabaseSnapshotCommand extends $Command< DeleteRelationalDatabaseSnapshotCommandInput, DeleteRelationalDatabaseSnapshotCommandOutput, @@ -34,6 +40,9 @@ export class DeleteRelationalDatabaseSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DetachCertificateFromDistributionCommand.ts b/clients/client-lightsail/commands/DetachCertificateFromDistributionCommand.ts index 020fd9d37f640..d83b9a340424f 100644 --- a/clients/client-lightsail/commands/DetachCertificateFromDistributionCommand.ts +++ b/clients/client-lightsail/commands/DetachCertificateFromDistributionCommand.ts @@ -20,6 +20,12 @@ import { export type DetachCertificateFromDistributionCommandInput = DetachCertificateFromDistributionRequest; export type DetachCertificateFromDistributionCommandOutput = DetachCertificateFromDistributionResult & __MetadataBearer; +/** + *

Detaches an SSL/TLS certificate from your Amazon Lightsail content delivery network (CDN) + * distribution.

+ *

After the certificate is detached, your distribution stops accepting traffic for all of + * the domains that are associated with the certificate.

+ */ export class DetachCertificateFromDistributionCommand extends $Command< DetachCertificateFromDistributionCommandInput, DetachCertificateFromDistributionCommandOutput, @@ -34,6 +40,9 @@ export class DetachCertificateFromDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DetachDiskCommand.ts b/clients/client-lightsail/commands/DetachDiskCommand.ts index b74a53334e54d..954da086aecb4 100644 --- a/clients/client-lightsail/commands/DetachDiskCommand.ts +++ b/clients/client-lightsail/commands/DetachDiskCommand.ts @@ -20,6 +20,14 @@ import { export type DetachDiskCommandInput = DetachDiskRequest; export type DetachDiskCommandOutput = DetachDiskResult & __MetadataBearer; +/** + *

Detaches a stopped block storage disk from a Lightsail instance. Make sure to unmount + * any file systems on the device within your operating system before stopping the instance and + * detaching the disk.

+ *

The detach disk operation supports tag-based access control via resource tags + * applied to the resource identified by disk name. For more information, see the + * Lightsail Dev Guide.

+ */ export class DetachDiskCommand extends $Command< DetachDiskCommandInput, DetachDiskCommandOutput, @@ -34,6 +42,9 @@ export class DetachDiskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DetachInstancesFromLoadBalancerCommand.ts b/clients/client-lightsail/commands/DetachInstancesFromLoadBalancerCommand.ts index 462c968b8ad3e..241ed72721bfe 100644 --- a/clients/client-lightsail/commands/DetachInstancesFromLoadBalancerCommand.ts +++ b/clients/client-lightsail/commands/DetachInstancesFromLoadBalancerCommand.ts @@ -20,6 +20,14 @@ import { export type DetachInstancesFromLoadBalancerCommandInput = DetachInstancesFromLoadBalancerRequest; export type DetachInstancesFromLoadBalancerCommandOutput = DetachInstancesFromLoadBalancerResult & __MetadataBearer; +/** + *

Detaches the specified instances from a Lightsail load balancer.

+ *

This operation waits until the instances are no longer needed before they are detached + * from the load balancer.

+ *

The detach instances from load balancer operation supports tag-based access + * control via resource tags applied to the resource identified by load balancer + * name. For more information, see the Lightsail Dev Guide.

+ */ export class DetachInstancesFromLoadBalancerCommand extends $Command< DetachInstancesFromLoadBalancerCommandInput, DetachInstancesFromLoadBalancerCommandOutput, @@ -34,6 +42,9 @@ export class DetachInstancesFromLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DetachStaticIpCommand.ts b/clients/client-lightsail/commands/DetachStaticIpCommand.ts index ae98972dea702..9d512b8df9490 100644 --- a/clients/client-lightsail/commands/DetachStaticIpCommand.ts +++ b/clients/client-lightsail/commands/DetachStaticIpCommand.ts @@ -20,6 +20,9 @@ import { export type DetachStaticIpCommandInput = DetachStaticIpRequest; export type DetachStaticIpCommandOutput = DetachStaticIpResult & __MetadataBearer; +/** + *

Detaches a static IP from the Amazon Lightsail instance to which it is attached.

+ */ export class DetachStaticIpCommand extends $Command< DetachStaticIpCommandInput, DetachStaticIpCommandOutput, @@ -34,6 +37,9 @@ export class DetachStaticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DisableAddOnCommand.ts b/clients/client-lightsail/commands/DisableAddOnCommand.ts index a20be51e3b10d..716ee6024ef8c 100644 --- a/clients/client-lightsail/commands/DisableAddOnCommand.ts +++ b/clients/client-lightsail/commands/DisableAddOnCommand.ts @@ -20,6 +20,9 @@ import { export type DisableAddOnCommandInput = DisableAddOnRequest; export type DisableAddOnCommandOutput = DisableAddOnResult & __MetadataBearer; +/** + *

Disables an add-on for an Amazon Lightsail resource. For more information, see the Lightsail Dev Guide.

+ */ export class DisableAddOnCommand extends $Command< DisableAddOnCommandInput, DisableAddOnCommandOutput, @@ -34,6 +37,9 @@ export class DisableAddOnCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/DownloadDefaultKeyPairCommand.ts b/clients/client-lightsail/commands/DownloadDefaultKeyPairCommand.ts index 0042c371e3a2f..29a733225f3ba 100644 --- a/clients/client-lightsail/commands/DownloadDefaultKeyPairCommand.ts +++ b/clients/client-lightsail/commands/DownloadDefaultKeyPairCommand.ts @@ -20,6 +20,9 @@ import { export type DownloadDefaultKeyPairCommandInput = DownloadDefaultKeyPairRequest; export type DownloadDefaultKeyPairCommandOutput = DownloadDefaultKeyPairResult & __MetadataBearer; +/** + *

Downloads the default SSH key pair from the user's account.

+ */ export class DownloadDefaultKeyPairCommand extends $Command< DownloadDefaultKeyPairCommandInput, DownloadDefaultKeyPairCommandOutput, @@ -34,6 +37,9 @@ export class DownloadDefaultKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/EnableAddOnCommand.ts b/clients/client-lightsail/commands/EnableAddOnCommand.ts index 8be1dfa6d779b..ddc420b33ff7c 100644 --- a/clients/client-lightsail/commands/EnableAddOnCommand.ts +++ b/clients/client-lightsail/commands/EnableAddOnCommand.ts @@ -20,6 +20,10 @@ import { export type EnableAddOnCommandInput = EnableAddOnRequest; export type EnableAddOnCommandOutput = EnableAddOnResult & __MetadataBearer; +/** + *

Enables or modifies an add-on for an Amazon Lightsail resource. For more information, see + * the Lightsail Dev Guide.

+ */ export class EnableAddOnCommand extends $Command< EnableAddOnCommandInput, EnableAddOnCommandOutput, @@ -34,6 +38,9 @@ export class EnableAddOnCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/ExportSnapshotCommand.ts b/clients/client-lightsail/commands/ExportSnapshotCommand.ts index 2d4ab2b1d6216..d449c234f3bc9 100644 --- a/clients/client-lightsail/commands/ExportSnapshotCommand.ts +++ b/clients/client-lightsail/commands/ExportSnapshotCommand.ts @@ -20,6 +20,23 @@ import { export type ExportSnapshotCommandInput = ExportSnapshotRequest; export type ExportSnapshotCommandOutput = ExportSnapshotResult & __MetadataBearer; +/** + *

Exports an Amazon Lightsail instance or block storage disk snapshot to Amazon Elastic Compute Cloud (Amazon EC2). + * This operation results in an export snapshot record that can be used with the create + * cloud formation stack operation to create new Amazon EC2 instances.

+ *

Exported instance snapshots appear in Amazon EC2 as Amazon Machine Images (AMIs), and the + * instance system disk appears as an Amazon Elastic Block Store (Amazon EBS) volume. Exported disk snapshots appear in + * Amazon EC2 as Amazon EBS volumes. Snapshots are exported to the same Amazon Web Services Region in Amazon EC2 as the + * source Lightsail snapshot.

+ *

+ *

The export snapshot operation supports tag-based access control via resource + * tags applied to the resource identified by source snapshot name. For more + * information, see the Lightsail Dev Guide.

+ * + *

Use the get instance snapshots or get disk snapshots + * operations to get a list of snapshots that you can export to Amazon EC2.

+ *
+ */ export class ExportSnapshotCommand extends $Command< ExportSnapshotCommandInput, ExportSnapshotCommandOutput, @@ -34,6 +51,9 @@ export class ExportSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetActiveNamesCommand.ts b/clients/client-lightsail/commands/GetActiveNamesCommand.ts index 39b1374aba7e3..fe041cbecfa12 100644 --- a/clients/client-lightsail/commands/GetActiveNamesCommand.ts +++ b/clients/client-lightsail/commands/GetActiveNamesCommand.ts @@ -20,6 +20,9 @@ import { export type GetActiveNamesCommandInput = GetActiveNamesRequest; export type GetActiveNamesCommandOutput = GetActiveNamesResult & __MetadataBearer; +/** + *

Returns the names of all active (not deleted) resources.

+ */ export class GetActiveNamesCommand extends $Command< GetActiveNamesCommandInput, GetActiveNamesCommandOutput, @@ -34,6 +37,9 @@ export class GetActiveNamesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetAlarmsCommand.ts b/clients/client-lightsail/commands/GetAlarmsCommand.ts index c1166551a6047..e9b3825e1daf5 100644 --- a/clients/client-lightsail/commands/GetAlarmsCommand.ts +++ b/clients/client-lightsail/commands/GetAlarmsCommand.ts @@ -17,6 +17,15 @@ import { export type GetAlarmsCommandInput = GetAlarmsRequest; export type GetAlarmsCommandOutput = GetAlarmsResult & __MetadataBearer; +/** + *

Returns information about the configured alarms. Specify an alarm name in your request to + * return information about a specific alarm, or specify a monitored resource name to return + * information about all alarms for a specific resource.

+ *

An alarm is used to monitor a single metric for one of your resources. When a metric + * condition is met, the alarm can notify you by email, SMS text message, and a banner displayed + * on the Amazon Lightsail console. For more information, see Alarms + * in Amazon Lightsail.

+ */ export class GetAlarmsCommand extends $Command< GetAlarmsCommandInput, GetAlarmsCommandOutput, @@ -31,6 +40,9 @@ export class GetAlarmsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetAutoSnapshotsCommand.ts b/clients/client-lightsail/commands/GetAutoSnapshotsCommand.ts index ea708b8da8e01..d970f810d27e9 100644 --- a/clients/client-lightsail/commands/GetAutoSnapshotsCommand.ts +++ b/clients/client-lightsail/commands/GetAutoSnapshotsCommand.ts @@ -20,6 +20,10 @@ import { export type GetAutoSnapshotsCommandInput = GetAutoSnapshotsRequest; export type GetAutoSnapshotsCommandOutput = GetAutoSnapshotsResult & __MetadataBearer; +/** + *

Returns the available automatic snapshots for an instance or disk. For more information, + * see the Lightsail Dev Guide.

+ */ export class GetAutoSnapshotsCommand extends $Command< GetAutoSnapshotsCommandInput, GetAutoSnapshotsCommandOutput, @@ -34,6 +38,9 @@ export class GetAutoSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetBlueprintsCommand.ts b/clients/client-lightsail/commands/GetBlueprintsCommand.ts index b60de53cc9099..4ba897f8f368d 100644 --- a/clients/client-lightsail/commands/GetBlueprintsCommand.ts +++ b/clients/client-lightsail/commands/GetBlueprintsCommand.ts @@ -20,6 +20,18 @@ import { export type GetBlueprintsCommandInput = GetBlueprintsRequest; export type GetBlueprintsCommandOutput = GetBlueprintsResult & __MetadataBearer; +/** + *

Returns the list of available instance images, or blueprints. You can + * use a blueprint to create a new instance already running a specific operating system, as well + * as a preinstalled app or development stack. The software each instance is running depends on + * the blueprint image you choose.

+ * + *

Use active blueprints when creating new instances. Inactive blueprints are listed to + * support customers with existing instances and are not necessarily available to create new + * instances. Blueprints are marked inactive when they become outdated due to operating system + * updates or new application releases.

+ *
+ */ export class GetBlueprintsCommand extends $Command< GetBlueprintsCommandInput, GetBlueprintsCommandOutput, @@ -34,6 +46,9 @@ export class GetBlueprintsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetBundlesCommand.ts b/clients/client-lightsail/commands/GetBundlesCommand.ts index ab40108a9e163..7df2998f910f8 100644 --- a/clients/client-lightsail/commands/GetBundlesCommand.ts +++ b/clients/client-lightsail/commands/GetBundlesCommand.ts @@ -20,6 +20,10 @@ import { export type GetBundlesCommandInput = GetBundlesRequest; export type GetBundlesCommandOutput = GetBundlesResult & __MetadataBearer; +/** + *

Returns the list of bundles that are available for purchase. A bundle describes the specs + * for your virtual private server (or instance).

+ */ export class GetBundlesCommand extends $Command< GetBundlesCommandInput, GetBundlesCommandOutput, @@ -34,6 +38,9 @@ export class GetBundlesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetCertificatesCommand.ts b/clients/client-lightsail/commands/GetCertificatesCommand.ts index 8b0bf02a6b9e8..e8859c23c070b 100644 --- a/clients/client-lightsail/commands/GetCertificatesCommand.ts +++ b/clients/client-lightsail/commands/GetCertificatesCommand.ts @@ -20,6 +20,14 @@ import { export type GetCertificatesCommandInput = GetCertificatesRequest; export type GetCertificatesCommandOutput = GetCertificatesResult & __MetadataBearer; +/** + *

Returns information about one or more Amazon Lightsail SSL/TLS certificates.

+ * + *

To get a summary of a certificate, ommit includeCertificateDetails from + * your request. The response will include only the certificate Amazon Resource Name (ARN), + * certificate name, domain name, and tags.

+ *
+ */ export class GetCertificatesCommand extends $Command< GetCertificatesCommandInput, GetCertificatesCommandOutput, @@ -34,6 +42,9 @@ export class GetCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetCloudFormationStackRecordsCommand.ts b/clients/client-lightsail/commands/GetCloudFormationStackRecordsCommand.ts index 4a6e05586185b..21fcb83308ed8 100644 --- a/clients/client-lightsail/commands/GetCloudFormationStackRecordsCommand.ts +++ b/clients/client-lightsail/commands/GetCloudFormationStackRecordsCommand.ts @@ -20,6 +20,12 @@ import { export type GetCloudFormationStackRecordsCommandInput = GetCloudFormationStackRecordsRequest; export type GetCloudFormationStackRecordsCommandOutput = GetCloudFormationStackRecordsResult & __MetadataBearer; +/** + *

Returns the CloudFormation stack record created as a result of the create cloud + * formation stack operation.

+ *

An AWS CloudFormation stack is used to create a new Amazon EC2 instance from an exported Lightsail + * snapshot.

+ */ export class GetCloudFormationStackRecordsCommand extends $Command< GetCloudFormationStackRecordsCommandInput, GetCloudFormationStackRecordsCommandOutput, @@ -34,6 +40,9 @@ export class GetCloudFormationStackRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetContactMethodsCommand.ts b/clients/client-lightsail/commands/GetContactMethodsCommand.ts index b666b5759a997..345fb09a27deb 100644 --- a/clients/client-lightsail/commands/GetContactMethodsCommand.ts +++ b/clients/client-lightsail/commands/GetContactMethodsCommand.ts @@ -20,6 +20,14 @@ import { export type GetContactMethodsCommandInput = GetContactMethodsRequest; export type GetContactMethodsCommandOutput = GetContactMethodsResult & __MetadataBearer; +/** + *

Returns information about the configured contact methods. Specify a protocol in your + * request to return information about a specific contact method.

+ *

A contact method is used to send you notifications about your Amazon Lightsail resources. + * You can add one email address and one mobile phone number contact method in each AWS Region. + * However, SMS text messaging is not supported in some AWS Regions, and SMS text messages + * cannot be sent to some countries/regions. For more information, see Notifications in Amazon Lightsail.

+ */ export class GetContactMethodsCommand extends $Command< GetContactMethodsCommandInput, GetContactMethodsCommandOutput, @@ -34,6 +42,9 @@ export class GetContactMethodsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetContainerAPIMetadataCommand.ts b/clients/client-lightsail/commands/GetContainerAPIMetadataCommand.ts index ed97d18c4fb29..b36f33512dd8b 100644 --- a/clients/client-lightsail/commands/GetContainerAPIMetadataCommand.ts +++ b/clients/client-lightsail/commands/GetContainerAPIMetadataCommand.ts @@ -20,6 +20,10 @@ import { export type GetContainerAPIMetadataCommandInput = GetContainerAPIMetadataRequest; export type GetContainerAPIMetadataCommandOutput = GetContainerAPIMetadataResult & __MetadataBearer; +/** + *

Returns information about Amazon Lightsail containers, such as the current version of the + * Lightsail Control (lightsailctl) plugin.

+ */ export class GetContainerAPIMetadataCommand extends $Command< GetContainerAPIMetadataCommandInput, GetContainerAPIMetadataCommandOutput, @@ -34,6 +38,9 @@ export class GetContainerAPIMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetContainerImagesCommand.ts b/clients/client-lightsail/commands/GetContainerImagesCommand.ts index 6f8c87caa04e2..369365f129211 100644 --- a/clients/client-lightsail/commands/GetContainerImagesCommand.ts +++ b/clients/client-lightsail/commands/GetContainerImagesCommand.ts @@ -20,6 +20,16 @@ import { export type GetContainerImagesCommandInput = GetContainerImagesRequest; export type GetContainerImagesCommandOutput = GetContainerImagesResult & __MetadataBearer; +/** + *

Returns the container images that are registered to your Amazon Lightsail container + * service.

+ * + * + *

If you created a deployment on your Lightsail container service that uses container + * images from a public registry like Docker Hub, those images are not returned as part of this + * action. Those images are not registered to your Lightsail container service.

+ *
+ */ export class GetContainerImagesCommand extends $Command< GetContainerImagesCommandInput, GetContainerImagesCommandOutput, @@ -34,6 +44,9 @@ export class GetContainerImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetContainerLogCommand.ts b/clients/client-lightsail/commands/GetContainerLogCommand.ts index a55530af5a4c4..36daf404efa02 100644 --- a/clients/client-lightsail/commands/GetContainerLogCommand.ts +++ b/clients/client-lightsail/commands/GetContainerLogCommand.ts @@ -20,6 +20,19 @@ import { export type GetContainerLogCommandInput = GetContainerLogRequest; export type GetContainerLogCommandOutput = GetContainerLogResult & __MetadataBearer; +/** + *

Returns the log events of a container of your Amazon Lightsail container service.

+ * + *

If your container service has more than one node (i.e., a scale greater than 1), then the + * log events that are returned for the specified container are merged from all nodes on your + * container service.

+ * + * + *

Container logs are retained for a certain amount of time. For more information, see + * Amazon Lightsail + * endpoints and quotas in the AWS General Reference.

+ *
+ */ export class GetContainerLogCommand extends $Command< GetContainerLogCommandInput, GetContainerLogCommandOutput, @@ -34,6 +47,9 @@ export class GetContainerLogCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetContainerServiceDeploymentsCommand.ts b/clients/client-lightsail/commands/GetContainerServiceDeploymentsCommand.ts index 6aef43c094a4f..008240b4bc054 100644 --- a/clients/client-lightsail/commands/GetContainerServiceDeploymentsCommand.ts +++ b/clients/client-lightsail/commands/GetContainerServiceDeploymentsCommand.ts @@ -20,6 +20,21 @@ import { export type GetContainerServiceDeploymentsCommandInput = GetContainerServiceDeploymentsRequest; export type GetContainerServiceDeploymentsCommandOutput = GetContainerServiceDeploymentsResult & __MetadataBearer; +/** + *

Returns the deployments for your Amazon Lightsail container service

+ * + *

A deployment specifies the settings, such as the ports and launch command, of containers + * that are deployed to your container service.

+ * + *

The deployments are ordered by version in ascending order. The newest version is listed at + * the top of the response.

+ * + * + *

A set number of deployments are kept before the oldest one is replaced with the newest + * one. For more information, see Amazon Lightsail + * endpoints and quotas in the AWS General Reference.

+ *
+ */ export class GetContainerServiceDeploymentsCommand extends $Command< GetContainerServiceDeploymentsCommandInput, GetContainerServiceDeploymentsCommandOutput, @@ -34,6 +49,9 @@ export class GetContainerServiceDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetContainerServiceMetricDataCommand.ts b/clients/client-lightsail/commands/GetContainerServiceMetricDataCommand.ts index fbdca53955c51..2847c90a9e799 100644 --- a/clients/client-lightsail/commands/GetContainerServiceMetricDataCommand.ts +++ b/clients/client-lightsail/commands/GetContainerServiceMetricDataCommand.ts @@ -20,6 +20,13 @@ import { export type GetContainerServiceMetricDataCommandInput = GetContainerServiceMetricDataRequest; export type GetContainerServiceMetricDataCommandOutput = GetContainerServiceMetricDataResult & __MetadataBearer; +/** + *

Returns the data points of a specific metric of your Amazon Lightsail container + * service.

+ * + *

Metrics report the utilization of your resources. Monitor and collect metric data + * regularly to maintain the reliability, availability, and performance of your resources.

+ */ export class GetContainerServiceMetricDataCommand extends $Command< GetContainerServiceMetricDataCommandInput, GetContainerServiceMetricDataCommandOutput, @@ -34,6 +41,9 @@ export class GetContainerServiceMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetContainerServicePowersCommand.ts b/clients/client-lightsail/commands/GetContainerServicePowersCommand.ts index 2acb13665b2d6..fb7a2eab5d496 100644 --- a/clients/client-lightsail/commands/GetContainerServicePowersCommand.ts +++ b/clients/client-lightsail/commands/GetContainerServicePowersCommand.ts @@ -20,6 +20,13 @@ import { export type GetContainerServicePowersCommandInput = GetContainerServicePowersRequest; export type GetContainerServicePowersCommandOutput = GetContainerServicePowersResult & __MetadataBearer; +/** + *

Returns the list of powers that can be specified for your Amazon Lightsail container + * services.

+ * + *

The power specifies the amount of memory, the number of vCPUs, and the base price of the + * container service.

+ */ export class GetContainerServicePowersCommand extends $Command< GetContainerServicePowersCommandInput, GetContainerServicePowersCommandOutput, @@ -34,6 +41,9 @@ export class GetContainerServicePowersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetContainerServicesCommand.ts b/clients/client-lightsail/commands/GetContainerServicesCommand.ts index 3a555915dd23b..d699e6936e967 100644 --- a/clients/client-lightsail/commands/GetContainerServicesCommand.ts +++ b/clients/client-lightsail/commands/GetContainerServicesCommand.ts @@ -20,6 +20,9 @@ import { export type GetContainerServicesCommandInput = GetContainerServicesRequest; export type GetContainerServicesCommandOutput = ContainerServicesListResult & __MetadataBearer; +/** + *

Returns information about one or more of your Amazon Lightsail container services.

+ */ export class GetContainerServicesCommand extends $Command< GetContainerServicesCommandInput, GetContainerServicesCommandOutput, @@ -34,6 +37,9 @@ export class GetContainerServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDiskCommand.ts b/clients/client-lightsail/commands/GetDiskCommand.ts index 6a6afa9f07524..e1a2c083c0b8c 100644 --- a/clients/client-lightsail/commands/GetDiskCommand.ts +++ b/clients/client-lightsail/commands/GetDiskCommand.ts @@ -17,6 +17,9 @@ import { export type GetDiskCommandInput = GetDiskRequest; export type GetDiskCommandOutput = GetDiskResult & __MetadataBearer; +/** + *

Returns information about a specific block storage disk.

+ */ export class GetDiskCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetDiskCommand extends $Command, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDiskSnapshotCommand.ts b/clients/client-lightsail/commands/GetDiskSnapshotCommand.ts index af0264d52af5d..d5241714d8932 100644 --- a/clients/client-lightsail/commands/GetDiskSnapshotCommand.ts +++ b/clients/client-lightsail/commands/GetDiskSnapshotCommand.ts @@ -20,6 +20,9 @@ import { export type GetDiskSnapshotCommandInput = GetDiskSnapshotRequest; export type GetDiskSnapshotCommandOutput = GetDiskSnapshotResult & __MetadataBearer; +/** + *

Returns information about a specific block storage disk snapshot.

+ */ export class GetDiskSnapshotCommand extends $Command< GetDiskSnapshotCommandInput, GetDiskSnapshotCommandOutput, @@ -34,6 +37,9 @@ export class GetDiskSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDiskSnapshotsCommand.ts b/clients/client-lightsail/commands/GetDiskSnapshotsCommand.ts index 51bc8f012868e..f2fe081e4c63e 100644 --- a/clients/client-lightsail/commands/GetDiskSnapshotsCommand.ts +++ b/clients/client-lightsail/commands/GetDiskSnapshotsCommand.ts @@ -20,6 +20,10 @@ import { export type GetDiskSnapshotsCommandInput = GetDiskSnapshotsRequest; export type GetDiskSnapshotsCommandOutput = GetDiskSnapshotsResult & __MetadataBearer; +/** + *

Returns information about all block storage disk snapshots in your AWS account and + * region.

+ */ export class GetDiskSnapshotsCommand extends $Command< GetDiskSnapshotsCommandInput, GetDiskSnapshotsCommandOutput, @@ -34,6 +38,9 @@ export class GetDiskSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDisksCommand.ts b/clients/client-lightsail/commands/GetDisksCommand.ts index 0a71a2d58f758..47169ac2df9a6 100644 --- a/clients/client-lightsail/commands/GetDisksCommand.ts +++ b/clients/client-lightsail/commands/GetDisksCommand.ts @@ -17,6 +17,9 @@ import { export type GetDisksCommandInput = GetDisksRequest; export type GetDisksCommandOutput = GetDisksResult & __MetadataBearer; +/** + *

Returns information about all block storage disks in your AWS account and region.

+ */ export class GetDisksCommand extends $Command< GetDisksCommandInput, GetDisksCommandOutput, @@ -31,6 +34,9 @@ export class GetDisksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDistributionBundlesCommand.ts b/clients/client-lightsail/commands/GetDistributionBundlesCommand.ts index ca6378cdac897..0794da4fd5349 100644 --- a/clients/client-lightsail/commands/GetDistributionBundlesCommand.ts +++ b/clients/client-lightsail/commands/GetDistributionBundlesCommand.ts @@ -20,6 +20,12 @@ import { export type GetDistributionBundlesCommandInput = GetDistributionBundlesRequest; export type GetDistributionBundlesCommandOutput = GetDistributionBundlesResult & __MetadataBearer; +/** + *

Returns the list bundles that can be applied to you Amazon Lightsail content delivery + * network (CDN) distributions.

+ *

A distribution bundle specifies the monthly network transfer quota and monthly cost of + * your dsitribution.

+ */ export class GetDistributionBundlesCommand extends $Command< GetDistributionBundlesCommandInput, GetDistributionBundlesCommandOutput, @@ -34,6 +40,9 @@ export class GetDistributionBundlesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDistributionLatestCacheResetCommand.ts b/clients/client-lightsail/commands/GetDistributionLatestCacheResetCommand.ts index 98d62331b945c..c64bebdb5830b 100644 --- a/clients/client-lightsail/commands/GetDistributionLatestCacheResetCommand.ts +++ b/clients/client-lightsail/commands/GetDistributionLatestCacheResetCommand.ts @@ -20,6 +20,10 @@ import { export type GetDistributionLatestCacheResetCommandInput = GetDistributionLatestCacheResetRequest; export type GetDistributionLatestCacheResetCommandOutput = GetDistributionLatestCacheResetResult & __MetadataBearer; +/** + *

Returns the timestamp and status of the last cache reset of a specific Amazon Lightsail + * content delivery network (CDN) distribution.

+ */ export class GetDistributionLatestCacheResetCommand extends $Command< GetDistributionLatestCacheResetCommandInput, GetDistributionLatestCacheResetCommandOutput, @@ -34,6 +38,9 @@ export class GetDistributionLatestCacheResetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDistributionMetricDataCommand.ts b/clients/client-lightsail/commands/GetDistributionMetricDataCommand.ts index 6cc2659933f35..8488a85d1abba 100644 --- a/clients/client-lightsail/commands/GetDistributionMetricDataCommand.ts +++ b/clients/client-lightsail/commands/GetDistributionMetricDataCommand.ts @@ -20,6 +20,13 @@ import { export type GetDistributionMetricDataCommandInput = GetDistributionMetricDataRequest; export type GetDistributionMetricDataCommandOutput = GetDistributionMetricDataResult & __MetadataBearer; +/** + *

Returns the data points of a specific metric for an Amazon Lightsail content delivery + * network (CDN) distribution.

+ *

Metrics report the utilization of your resources, and the error counts generated by them. + * Monitor and collect metric data regularly to maintain the reliability, availability, and + * performance of your resources.

+ */ export class GetDistributionMetricDataCommand extends $Command< GetDistributionMetricDataCommandInput, GetDistributionMetricDataCommandOutput, @@ -34,6 +41,9 @@ export class GetDistributionMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDistributionsCommand.ts b/clients/client-lightsail/commands/GetDistributionsCommand.ts index 70677c8e03211..f0783f8eaa582 100644 --- a/clients/client-lightsail/commands/GetDistributionsCommand.ts +++ b/clients/client-lightsail/commands/GetDistributionsCommand.ts @@ -20,6 +20,10 @@ import { export type GetDistributionsCommandInput = GetDistributionsRequest; export type GetDistributionsCommandOutput = GetDistributionsResult & __MetadataBearer; +/** + *

Returns information about one or more of your Amazon Lightsail content delivery network + * (CDN) distributions.

+ */ export class GetDistributionsCommand extends $Command< GetDistributionsCommandInput, GetDistributionsCommandOutput, @@ -34,6 +38,9 @@ export class GetDistributionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDomainCommand.ts b/clients/client-lightsail/commands/GetDomainCommand.ts index 53835fb705b9b..edce1cc21eb34 100644 --- a/clients/client-lightsail/commands/GetDomainCommand.ts +++ b/clients/client-lightsail/commands/GetDomainCommand.ts @@ -17,6 +17,9 @@ import { export type GetDomainCommandInput = GetDomainRequest; export type GetDomainCommandOutput = GetDomainResult & __MetadataBearer; +/** + *

Returns information about a specific domain recordset.

+ */ export class GetDomainCommand extends $Command< GetDomainCommandInput, GetDomainCommandOutput, @@ -31,6 +34,9 @@ export class GetDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetDomainsCommand.ts b/clients/client-lightsail/commands/GetDomainsCommand.ts index d037f998745d8..01262d2d256d1 100644 --- a/clients/client-lightsail/commands/GetDomainsCommand.ts +++ b/clients/client-lightsail/commands/GetDomainsCommand.ts @@ -20,6 +20,9 @@ import { export type GetDomainsCommandInput = GetDomainsRequest; export type GetDomainsCommandOutput = GetDomainsResult & __MetadataBearer; +/** + *

Returns a list of all domains in the user's account.

+ */ export class GetDomainsCommand extends $Command< GetDomainsCommandInput, GetDomainsCommandOutput, @@ -34,6 +37,9 @@ export class GetDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetExportSnapshotRecordsCommand.ts b/clients/client-lightsail/commands/GetExportSnapshotRecordsCommand.ts index dd240c41c619b..25ca3811ae4c3 100644 --- a/clients/client-lightsail/commands/GetExportSnapshotRecordsCommand.ts +++ b/clients/client-lightsail/commands/GetExportSnapshotRecordsCommand.ts @@ -20,6 +20,12 @@ import { export type GetExportSnapshotRecordsCommandInput = GetExportSnapshotRecordsRequest; export type GetExportSnapshotRecordsCommandOutput = GetExportSnapshotRecordsResult & __MetadataBearer; +/** + *

Returns the export snapshot record created as a result of the export snapshot + * operation.

+ *

An export snapshot record can be used to create a new Amazon EC2 instance and its related + * resources with the create cloud formation stack operation.

+ */ export class GetExportSnapshotRecordsCommand extends $Command< GetExportSnapshotRecordsCommandInput, GetExportSnapshotRecordsCommandOutput, @@ -34,6 +40,9 @@ export class GetExportSnapshotRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetInstanceAccessDetailsCommand.ts b/clients/client-lightsail/commands/GetInstanceAccessDetailsCommand.ts index 85e70c6c90134..82b81700184da 100644 --- a/clients/client-lightsail/commands/GetInstanceAccessDetailsCommand.ts +++ b/clients/client-lightsail/commands/GetInstanceAccessDetailsCommand.ts @@ -20,6 +20,13 @@ import { export type GetInstanceAccessDetailsCommandInput = GetInstanceAccessDetailsRequest; export type GetInstanceAccessDetailsCommandOutput = GetInstanceAccessDetailsResult & __MetadataBearer; +/** + *

Returns temporary SSH keys you can use to connect to a specific virtual private server, or + * instance.

+ *

The get instance access details operation supports tag-based access control + * via resource tags applied to the resource identified by instance name. For more + * information, see the Lightsail Dev Guide.

+ */ export class GetInstanceAccessDetailsCommand extends $Command< GetInstanceAccessDetailsCommandInput, GetInstanceAccessDetailsCommandOutput, @@ -34,6 +41,9 @@ export class GetInstanceAccessDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetInstanceCommand.ts b/clients/client-lightsail/commands/GetInstanceCommand.ts index 5330db59f09f1..02c9065220fae 100644 --- a/clients/client-lightsail/commands/GetInstanceCommand.ts +++ b/clients/client-lightsail/commands/GetInstanceCommand.ts @@ -20,6 +20,10 @@ import { export type GetInstanceCommandInput = GetInstanceRequest; export type GetInstanceCommandOutput = GetInstanceResult & __MetadataBearer; +/** + *

Returns information about a specific Amazon Lightsail instance, which is a virtual private + * server.

+ */ export class GetInstanceCommand extends $Command< GetInstanceCommandInput, GetInstanceCommandOutput, @@ -34,6 +38,9 @@ export class GetInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetInstanceMetricDataCommand.ts b/clients/client-lightsail/commands/GetInstanceMetricDataCommand.ts index 9d7360670671f..e4bda682d566d 100644 --- a/clients/client-lightsail/commands/GetInstanceMetricDataCommand.ts +++ b/clients/client-lightsail/commands/GetInstanceMetricDataCommand.ts @@ -20,6 +20,13 @@ import { export type GetInstanceMetricDataCommandInput = GetInstanceMetricDataRequest; export type GetInstanceMetricDataCommandOutput = GetInstanceMetricDataResult & __MetadataBearer; +/** + *

Returns the data points for the specified Amazon Lightsail instance metric, given an + * instance name.

+ *

Metrics report the utilization of your resources, and the error counts generated by them. + * Monitor and collect metric data regularly to maintain the reliability, availability, and + * performance of your resources.

+ */ export class GetInstanceMetricDataCommand extends $Command< GetInstanceMetricDataCommandInput, GetInstanceMetricDataCommandOutput, @@ -34,6 +41,9 @@ export class GetInstanceMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetInstancePortStatesCommand.ts b/clients/client-lightsail/commands/GetInstancePortStatesCommand.ts index 4d80016c9abf8..0032a8644e255 100644 --- a/clients/client-lightsail/commands/GetInstancePortStatesCommand.ts +++ b/clients/client-lightsail/commands/GetInstancePortStatesCommand.ts @@ -20,6 +20,10 @@ import { export type GetInstancePortStatesCommandInput = GetInstancePortStatesRequest; export type GetInstancePortStatesCommandOutput = GetInstancePortStatesResult & __MetadataBearer; +/** + *

Returns the firewall port states for a specific Amazon Lightsail instance, the IP addresses + * allowed to connect to the instance through the ports, and the protocol.

+ */ export class GetInstancePortStatesCommand extends $Command< GetInstancePortStatesCommandInput, GetInstancePortStatesCommandOutput, @@ -34,6 +38,9 @@ export class GetInstancePortStatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetInstanceSnapshotCommand.ts b/clients/client-lightsail/commands/GetInstanceSnapshotCommand.ts index 2abca7a22b6d5..9bca4fc32d967 100644 --- a/clients/client-lightsail/commands/GetInstanceSnapshotCommand.ts +++ b/clients/client-lightsail/commands/GetInstanceSnapshotCommand.ts @@ -20,6 +20,9 @@ import { export type GetInstanceSnapshotCommandInput = GetInstanceSnapshotRequest; export type GetInstanceSnapshotCommandOutput = GetInstanceSnapshotResult & __MetadataBearer; +/** + *

Returns information about a specific instance snapshot.

+ */ export class GetInstanceSnapshotCommand extends $Command< GetInstanceSnapshotCommandInput, GetInstanceSnapshotCommandOutput, @@ -34,6 +37,9 @@ export class GetInstanceSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetInstanceSnapshotsCommand.ts b/clients/client-lightsail/commands/GetInstanceSnapshotsCommand.ts index 7ebd00fbbfb41..bad2ca7f69485 100644 --- a/clients/client-lightsail/commands/GetInstanceSnapshotsCommand.ts +++ b/clients/client-lightsail/commands/GetInstanceSnapshotsCommand.ts @@ -20,6 +20,9 @@ import { export type GetInstanceSnapshotsCommandInput = GetInstanceSnapshotsRequest; export type GetInstanceSnapshotsCommandOutput = GetInstanceSnapshotsResult & __MetadataBearer; +/** + *

Returns all instance snapshots for the user's account.

+ */ export class GetInstanceSnapshotsCommand extends $Command< GetInstanceSnapshotsCommandInput, GetInstanceSnapshotsCommandOutput, @@ -34,6 +37,9 @@ export class GetInstanceSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetInstanceStateCommand.ts b/clients/client-lightsail/commands/GetInstanceStateCommand.ts index 965ee2df8e211..c938597a11af0 100644 --- a/clients/client-lightsail/commands/GetInstanceStateCommand.ts +++ b/clients/client-lightsail/commands/GetInstanceStateCommand.ts @@ -20,6 +20,9 @@ import { export type GetInstanceStateCommandInput = GetInstanceStateRequest; export type GetInstanceStateCommandOutput = GetInstanceStateResult & __MetadataBearer; +/** + *

Returns the state of a specific instance. Works on one instance at a time.

+ */ export class GetInstanceStateCommand extends $Command< GetInstanceStateCommandInput, GetInstanceStateCommandOutput, @@ -34,6 +37,9 @@ export class GetInstanceStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetInstancesCommand.ts b/clients/client-lightsail/commands/GetInstancesCommand.ts index 4497fb8ee5251..a3297fd9745a5 100644 --- a/clients/client-lightsail/commands/GetInstancesCommand.ts +++ b/clients/client-lightsail/commands/GetInstancesCommand.ts @@ -20,6 +20,10 @@ import { export type GetInstancesCommandInput = GetInstancesRequest; export type GetInstancesCommandOutput = GetInstancesResult & __MetadataBearer; +/** + *

Returns information about all Amazon Lightsail virtual private servers, or + * instances.

+ */ export class GetInstancesCommand extends $Command< GetInstancesCommandInput, GetInstancesCommandOutput, @@ -34,6 +38,9 @@ export class GetInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetKeyPairCommand.ts b/clients/client-lightsail/commands/GetKeyPairCommand.ts index a0f5089110573..035f9d03f73d1 100644 --- a/clients/client-lightsail/commands/GetKeyPairCommand.ts +++ b/clients/client-lightsail/commands/GetKeyPairCommand.ts @@ -20,6 +20,9 @@ import { export type GetKeyPairCommandInput = GetKeyPairRequest; export type GetKeyPairCommandOutput = GetKeyPairResult & __MetadataBearer; +/** + *

Returns information about a specific key pair.

+ */ export class GetKeyPairCommand extends $Command< GetKeyPairCommandInput, GetKeyPairCommandOutput, @@ -34,6 +37,9 @@ export class GetKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetKeyPairsCommand.ts b/clients/client-lightsail/commands/GetKeyPairsCommand.ts index 52ad1fda8cb46..9fd95b1e875ce 100644 --- a/clients/client-lightsail/commands/GetKeyPairsCommand.ts +++ b/clients/client-lightsail/commands/GetKeyPairsCommand.ts @@ -21,6 +21,9 @@ import { export type GetKeyPairsCommandInput = GetKeyPairsRequest; export type GetKeyPairsCommandOutput = GetKeyPairsResult & __MetadataBearer; +/** + *

Returns information about all key pairs in the user's account.

+ */ export class GetKeyPairsCommand extends $Command< GetKeyPairsCommandInput, GetKeyPairsCommandOutput, @@ -35,6 +38,9 @@ export class GetKeyPairsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetLoadBalancerCommand.ts b/clients/client-lightsail/commands/GetLoadBalancerCommand.ts index 7f0d8a0f394e7..6c5c0d6880436 100644 --- a/clients/client-lightsail/commands/GetLoadBalancerCommand.ts +++ b/clients/client-lightsail/commands/GetLoadBalancerCommand.ts @@ -20,6 +20,9 @@ import { export type GetLoadBalancerCommandInput = GetLoadBalancerRequest; export type GetLoadBalancerCommandOutput = GetLoadBalancerResult & __MetadataBearer; +/** + *

Returns information about the specified Lightsail load balancer.

+ */ export class GetLoadBalancerCommand extends $Command< GetLoadBalancerCommandInput, GetLoadBalancerCommandOutput, @@ -34,6 +37,9 @@ export class GetLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetLoadBalancerMetricDataCommand.ts b/clients/client-lightsail/commands/GetLoadBalancerMetricDataCommand.ts index dfb6637196c65..4930b8bf7dbf0 100644 --- a/clients/client-lightsail/commands/GetLoadBalancerMetricDataCommand.ts +++ b/clients/client-lightsail/commands/GetLoadBalancerMetricDataCommand.ts @@ -20,6 +20,12 @@ import { export type GetLoadBalancerMetricDataCommandInput = GetLoadBalancerMetricDataRequest; export type GetLoadBalancerMetricDataCommandOutput = GetLoadBalancerMetricDataResult & __MetadataBearer; +/** + *

Returns information about health metrics for your Lightsail load balancer.

+ *

Metrics report the utilization of your resources, and the error counts generated by them. + * Monitor and collect metric data regularly to maintain the reliability, availability, and + * performance of your resources.

+ */ export class GetLoadBalancerMetricDataCommand extends $Command< GetLoadBalancerMetricDataCommandInput, GetLoadBalancerMetricDataCommandOutput, @@ -34,6 +40,9 @@ export class GetLoadBalancerMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetLoadBalancerTlsCertificatesCommand.ts b/clients/client-lightsail/commands/GetLoadBalancerTlsCertificatesCommand.ts index cdce8a669243a..5c63dfc0ecb4c 100644 --- a/clients/client-lightsail/commands/GetLoadBalancerTlsCertificatesCommand.ts +++ b/clients/client-lightsail/commands/GetLoadBalancerTlsCertificatesCommand.ts @@ -20,6 +20,13 @@ import { export type GetLoadBalancerTlsCertificatesCommandInput = GetLoadBalancerTlsCertificatesRequest; export type GetLoadBalancerTlsCertificatesCommandOutput = GetLoadBalancerTlsCertificatesResult & __MetadataBearer; +/** + *

Returns information about the TLS certificates that are associated with the specified + * Lightsail load balancer.

+ *

TLS is just an updated, more secure version of Secure Socket Layer (SSL).

+ *

You can have a maximum of 2 certificates associated with a Lightsail load balancer. One + * is active and the other is inactive.

+ */ export class GetLoadBalancerTlsCertificatesCommand extends $Command< GetLoadBalancerTlsCertificatesCommandInput, GetLoadBalancerTlsCertificatesCommandOutput, @@ -34,6 +41,9 @@ export class GetLoadBalancerTlsCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetLoadBalancersCommand.ts b/clients/client-lightsail/commands/GetLoadBalancersCommand.ts index 8906bef6da16c..bc0f474e0cb9c 100644 --- a/clients/client-lightsail/commands/GetLoadBalancersCommand.ts +++ b/clients/client-lightsail/commands/GetLoadBalancersCommand.ts @@ -20,6 +20,9 @@ import { export type GetLoadBalancersCommandInput = GetLoadBalancersRequest; export type GetLoadBalancersCommandOutput = GetLoadBalancersResult & __MetadataBearer; +/** + *

Returns information about all load balancers in an account.

+ */ export class GetLoadBalancersCommand extends $Command< GetLoadBalancersCommandInput, GetLoadBalancersCommandOutput, @@ -34,6 +37,9 @@ export class GetLoadBalancersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetOperationCommand.ts b/clients/client-lightsail/commands/GetOperationCommand.ts index d23129f97b1b5..c6077f9dca2e0 100644 --- a/clients/client-lightsail/commands/GetOperationCommand.ts +++ b/clients/client-lightsail/commands/GetOperationCommand.ts @@ -20,6 +20,10 @@ import { export type GetOperationCommandInput = GetOperationRequest; export type GetOperationCommandOutput = GetOperationResult & __MetadataBearer; +/** + *

Returns information about a specific operation. Operations include events such as when you + * create an instance, allocate a static IP, attach a static IP, and so on.

+ */ export class GetOperationCommand extends $Command< GetOperationCommandInput, GetOperationCommandOutput, @@ -34,6 +38,9 @@ export class GetOperationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetOperationsCommand.ts b/clients/client-lightsail/commands/GetOperationsCommand.ts index 064093d2c0034..80fce93b174f8 100644 --- a/clients/client-lightsail/commands/GetOperationsCommand.ts +++ b/clients/client-lightsail/commands/GetOperationsCommand.ts @@ -20,6 +20,12 @@ import { export type GetOperationsCommandInput = GetOperationsRequest; export type GetOperationsCommandOutput = GetOperationsResult & __MetadataBearer; +/** + *

Returns information about all operations.

+ *

Results are returned from oldest to newest, up to a maximum of 200. Results can be paged + * by making each subsequent call to GetOperations use the maximum (last) + * statusChangedAt value from the previous request.

+ */ export class GetOperationsCommand extends $Command< GetOperationsCommandInput, GetOperationsCommandOutput, @@ -34,6 +40,9 @@ export class GetOperationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetOperationsForResourceCommand.ts b/clients/client-lightsail/commands/GetOperationsForResourceCommand.ts index 71ca782fefdf0..2883b1193b856 100644 --- a/clients/client-lightsail/commands/GetOperationsForResourceCommand.ts +++ b/clients/client-lightsail/commands/GetOperationsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type GetOperationsForResourceCommandInput = GetOperationsForResourceRequest; export type GetOperationsForResourceCommandOutput = GetOperationsForResourceResult & __MetadataBearer; +/** + *

Gets operations for a specific resource (e.g., an instance or a static IP).

+ */ export class GetOperationsForResourceCommand extends $Command< GetOperationsForResourceCommandInput, GetOperationsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class GetOperationsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRegionsCommand.ts b/clients/client-lightsail/commands/GetRegionsCommand.ts index 431b07348fd67..3c7a8d9cfd0e6 100644 --- a/clients/client-lightsail/commands/GetRegionsCommand.ts +++ b/clients/client-lightsail/commands/GetRegionsCommand.ts @@ -20,6 +20,11 @@ import { export type GetRegionsCommandInput = GetRegionsRequest; export type GetRegionsCommandOutput = GetRegionsResult & __MetadataBearer; +/** + *

Returns a list of all valid regions for Amazon Lightsail. Use the include + * availability zones parameter to also return the Availability Zones in a + * region.

+ */ export class GetRegionsCommand extends $Command< GetRegionsCommandInput, GetRegionsCommandOutput, @@ -34,6 +39,9 @@ export class GetRegionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseBlueprintsCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseBlueprintsCommand.ts index 5ad141db7eb0b..6ef628ab306aa 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseBlueprintsCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseBlueprintsCommand.ts @@ -20,6 +20,12 @@ import { export type GetRelationalDatabaseBlueprintsCommandInput = GetRelationalDatabaseBlueprintsRequest; export type GetRelationalDatabaseBlueprintsCommandOutput = GetRelationalDatabaseBlueprintsResult & __MetadataBearer; +/** + *

Returns a list of available database blueprints in Amazon Lightsail. A blueprint describes + * the major engine version of a database.

+ *

You can use a blueprint ID to create a new database that runs a specific database + * engine.

+ */ export class GetRelationalDatabaseBlueprintsCommand extends $Command< GetRelationalDatabaseBlueprintsCommandInput, GetRelationalDatabaseBlueprintsCommandOutput, @@ -34,6 +40,9 @@ export class GetRelationalDatabaseBlueprintsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseBundlesCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseBundlesCommand.ts index a6bd4718dd927..12f0a66db5bb6 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseBundlesCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseBundlesCommand.ts @@ -20,6 +20,12 @@ import { export type GetRelationalDatabaseBundlesCommandInput = GetRelationalDatabaseBundlesRequest; export type GetRelationalDatabaseBundlesCommandOutput = GetRelationalDatabaseBundlesResult & __MetadataBearer; +/** + *

Returns the list of bundles that are available in Amazon Lightsail. A bundle describes the + * performance specifications for a database.

+ *

You can use a bundle ID to create a new database with explicit performance + * specifications.

+ */ export class GetRelationalDatabaseBundlesCommand extends $Command< GetRelationalDatabaseBundlesCommandInput, GetRelationalDatabaseBundlesCommandOutput, @@ -34,6 +40,9 @@ export class GetRelationalDatabaseBundlesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseCommand.ts index 5bc950e47378a..ed187537824f2 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseCommand.ts @@ -20,6 +20,9 @@ import { export type GetRelationalDatabaseCommandInput = GetRelationalDatabaseRequest; export type GetRelationalDatabaseCommandOutput = GetRelationalDatabaseResult & __MetadataBearer; +/** + *

Returns information about a specific database in Amazon Lightsail.

+ */ export class GetRelationalDatabaseCommand extends $Command< GetRelationalDatabaseCommandInput, GetRelationalDatabaseCommandOutput, @@ -34,6 +37,9 @@ export class GetRelationalDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseEventsCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseEventsCommand.ts index 4b06757fb4f87..fe03609c31187 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseEventsCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseEventsCommand.ts @@ -20,6 +20,9 @@ import { export type GetRelationalDatabaseEventsCommandInput = GetRelationalDatabaseEventsRequest; export type GetRelationalDatabaseEventsCommandOutput = GetRelationalDatabaseEventsResult & __MetadataBearer; +/** + *

Returns a list of events for a specific database in Amazon Lightsail.

+ */ export class GetRelationalDatabaseEventsCommand extends $Command< GetRelationalDatabaseEventsCommandInput, GetRelationalDatabaseEventsCommandOutput, @@ -34,6 +37,9 @@ export class GetRelationalDatabaseEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseLogEventsCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseLogEventsCommand.ts index 300fee312073c..f7baee8ef494c 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseLogEventsCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseLogEventsCommand.ts @@ -20,6 +20,9 @@ import { export type GetRelationalDatabaseLogEventsCommandInput = GetRelationalDatabaseLogEventsRequest; export type GetRelationalDatabaseLogEventsCommandOutput = GetRelationalDatabaseLogEventsResult & __MetadataBearer; +/** + *

Returns a list of log events for a database in Amazon Lightsail.

+ */ export class GetRelationalDatabaseLogEventsCommand extends $Command< GetRelationalDatabaseLogEventsCommandInput, GetRelationalDatabaseLogEventsCommandOutput, @@ -34,6 +37,9 @@ export class GetRelationalDatabaseLogEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseLogStreamsCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseLogStreamsCommand.ts index 5c9d830dedfa1..0495ddba19738 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseLogStreamsCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseLogStreamsCommand.ts @@ -20,6 +20,9 @@ import { export type GetRelationalDatabaseLogStreamsCommandInput = GetRelationalDatabaseLogStreamsRequest; export type GetRelationalDatabaseLogStreamsCommandOutput = GetRelationalDatabaseLogStreamsResult & __MetadataBearer; +/** + *

Returns a list of available log streams for a specific database in Amazon Lightsail.

+ */ export class GetRelationalDatabaseLogStreamsCommand extends $Command< GetRelationalDatabaseLogStreamsCommandInput, GetRelationalDatabaseLogStreamsCommandOutput, @@ -34,6 +37,9 @@ export class GetRelationalDatabaseLogStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseMasterUserPasswordCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseMasterUserPasswordCommand.ts index 04a77193962b9..ff9a8b5611b4d 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseMasterUserPasswordCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseMasterUserPasswordCommand.ts @@ -24,6 +24,13 @@ export type GetRelationalDatabaseMasterUserPasswordCommandInput = GetRelationalD export type GetRelationalDatabaseMasterUserPasswordCommandOutput = GetRelationalDatabaseMasterUserPasswordResult & __MetadataBearer; +/** + *

Returns the current, previous, or pending versions of the master user password for a + * Lightsail database.

+ *

The GetRelationalDatabaseMasterUserPassword operation supports tag-based + * access control via resource tags applied to the resource identified by + * relationalDatabaseName.

+ */ export class GetRelationalDatabaseMasterUserPasswordCommand extends $Command< GetRelationalDatabaseMasterUserPasswordCommandInput, GetRelationalDatabaseMasterUserPasswordCommandOutput, @@ -38,6 +45,9 @@ export class GetRelationalDatabaseMasterUserPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseMetricDataCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseMetricDataCommand.ts index 015d05762959c..0b229a25d62a5 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseMetricDataCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseMetricDataCommand.ts @@ -20,6 +20,12 @@ import { export type GetRelationalDatabaseMetricDataCommandInput = GetRelationalDatabaseMetricDataRequest; export type GetRelationalDatabaseMetricDataCommandOutput = GetRelationalDatabaseMetricDataResult & __MetadataBearer; +/** + *

Returns the data points of the specified metric for a database in Amazon Lightsail.

+ *

Metrics report the utilization of your resources, and the error counts generated by them. + * Monitor and collect metric data regularly to maintain the reliability, availability, and + * performance of your resources.

+ */ export class GetRelationalDatabaseMetricDataCommand extends $Command< GetRelationalDatabaseMetricDataCommandInput, GetRelationalDatabaseMetricDataCommandOutput, @@ -34,6 +40,9 @@ export class GetRelationalDatabaseMetricDataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseParametersCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseParametersCommand.ts index 12ab632aeffde..57c4dc58813a5 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseParametersCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseParametersCommand.ts @@ -20,6 +20,13 @@ import { export type GetRelationalDatabaseParametersCommandInput = GetRelationalDatabaseParametersRequest; export type GetRelationalDatabaseParametersCommandOutput = GetRelationalDatabaseParametersResult & __MetadataBearer; +/** + *

Returns all of the runtime parameters offered by the underlying database software, or + * engine, for a specific database in Amazon Lightsail.

+ *

In addition to the parameter names and values, this operation returns other information + * about each parameter. This information includes whether changes require a reboot, whether the + * parameter is modifiable, the allowed values, and the data types.

+ */ export class GetRelationalDatabaseParametersCommand extends $Command< GetRelationalDatabaseParametersCommandInput, GetRelationalDatabaseParametersCommandOutput, @@ -34,6 +41,9 @@ export class GetRelationalDatabaseParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseSnapshotCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseSnapshotCommand.ts index 0a1d029b5f584..285178baa15f1 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseSnapshotCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseSnapshotCommand.ts @@ -20,6 +20,9 @@ import { export type GetRelationalDatabaseSnapshotCommandInput = GetRelationalDatabaseSnapshotRequest; export type GetRelationalDatabaseSnapshotCommandOutput = GetRelationalDatabaseSnapshotResult & __MetadataBearer; +/** + *

Returns information about a specific database snapshot in Amazon Lightsail.

+ */ export class GetRelationalDatabaseSnapshotCommand extends $Command< GetRelationalDatabaseSnapshotCommandInput, GetRelationalDatabaseSnapshotCommandOutput, @@ -34,6 +37,9 @@ export class GetRelationalDatabaseSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabaseSnapshotsCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabaseSnapshotsCommand.ts index 63cbc80f64cde..fe85f90ce0226 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabaseSnapshotsCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabaseSnapshotsCommand.ts @@ -20,6 +20,9 @@ import { export type GetRelationalDatabaseSnapshotsCommandInput = GetRelationalDatabaseSnapshotsRequest; export type GetRelationalDatabaseSnapshotsCommandOutput = GetRelationalDatabaseSnapshotsResult & __MetadataBearer; +/** + *

Returns information about all of your database snapshots in Amazon Lightsail.

+ */ export class GetRelationalDatabaseSnapshotsCommand extends $Command< GetRelationalDatabaseSnapshotsCommandInput, GetRelationalDatabaseSnapshotsCommandOutput, @@ -34,6 +37,9 @@ export class GetRelationalDatabaseSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetRelationalDatabasesCommand.ts b/clients/client-lightsail/commands/GetRelationalDatabasesCommand.ts index 5ff29aadadb25..a5ff55de5f756 100644 --- a/clients/client-lightsail/commands/GetRelationalDatabasesCommand.ts +++ b/clients/client-lightsail/commands/GetRelationalDatabasesCommand.ts @@ -20,6 +20,9 @@ import { export type GetRelationalDatabasesCommandInput = GetRelationalDatabasesRequest; export type GetRelationalDatabasesCommandOutput = GetRelationalDatabasesResult & __MetadataBearer; +/** + *

Returns information about all of your databases in Amazon Lightsail.

+ */ export class GetRelationalDatabasesCommand extends $Command< GetRelationalDatabasesCommandInput, GetRelationalDatabasesCommandOutput, @@ -34,6 +37,9 @@ export class GetRelationalDatabasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetStaticIpCommand.ts b/clients/client-lightsail/commands/GetStaticIpCommand.ts index ffa7dcb711b57..7b8fd98f1453a 100644 --- a/clients/client-lightsail/commands/GetStaticIpCommand.ts +++ b/clients/client-lightsail/commands/GetStaticIpCommand.ts @@ -20,6 +20,9 @@ import { export type GetStaticIpCommandInput = GetStaticIpRequest; export type GetStaticIpCommandOutput = GetStaticIpResult & __MetadataBearer; +/** + *

Returns information about a specific static IP.

+ */ export class GetStaticIpCommand extends $Command< GetStaticIpCommandInput, GetStaticIpCommandOutput, @@ -34,6 +37,9 @@ export class GetStaticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/GetStaticIpsCommand.ts b/clients/client-lightsail/commands/GetStaticIpsCommand.ts index cb29c9b59e0c2..d00c0ae66e4f5 100644 --- a/clients/client-lightsail/commands/GetStaticIpsCommand.ts +++ b/clients/client-lightsail/commands/GetStaticIpsCommand.ts @@ -20,6 +20,9 @@ import { export type GetStaticIpsCommandInput = GetStaticIpsRequest; export type GetStaticIpsCommandOutput = GetStaticIpsResult & __MetadataBearer; +/** + *

Returns information about all static IPs in the user's account.

+ */ export class GetStaticIpsCommand extends $Command< GetStaticIpsCommandInput, GetStaticIpsCommandOutput, @@ -34,6 +37,9 @@ export class GetStaticIpsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/ImportKeyPairCommand.ts b/clients/client-lightsail/commands/ImportKeyPairCommand.ts index 5809616beea8e..f5e5576fc5942 100644 --- a/clients/client-lightsail/commands/ImportKeyPairCommand.ts +++ b/clients/client-lightsail/commands/ImportKeyPairCommand.ts @@ -20,6 +20,9 @@ import { export type ImportKeyPairCommandInput = ImportKeyPairRequest; export type ImportKeyPairCommandOutput = ImportKeyPairResult & __MetadataBearer; +/** + *

Imports a public SSH key from a specific key pair.

+ */ export class ImportKeyPairCommand extends $Command< ImportKeyPairCommandInput, ImportKeyPairCommandOutput, @@ -34,6 +37,9 @@ export class ImportKeyPairCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/IsVpcPeeredCommand.ts b/clients/client-lightsail/commands/IsVpcPeeredCommand.ts index 40ae0d3482d25..535949e2fa92f 100644 --- a/clients/client-lightsail/commands/IsVpcPeeredCommand.ts +++ b/clients/client-lightsail/commands/IsVpcPeeredCommand.ts @@ -20,6 +20,9 @@ import { export type IsVpcPeeredCommandInput = IsVpcPeeredRequest; export type IsVpcPeeredCommandOutput = IsVpcPeeredResult & __MetadataBearer; +/** + *

Returns a Boolean value indicating whether your Lightsail VPC is peered.

+ */ export class IsVpcPeeredCommand extends $Command< IsVpcPeeredCommandInput, IsVpcPeeredCommandOutput, @@ -34,6 +37,9 @@ export class IsVpcPeeredCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/OpenInstancePublicPortsCommand.ts b/clients/client-lightsail/commands/OpenInstancePublicPortsCommand.ts index 6981d8177766d..9b480b82d1474 100644 --- a/clients/client-lightsail/commands/OpenInstancePublicPortsCommand.ts +++ b/clients/client-lightsail/commands/OpenInstancePublicPortsCommand.ts @@ -20,6 +20,13 @@ import { export type OpenInstancePublicPortsCommandInput = OpenInstancePublicPortsRequest; export type OpenInstancePublicPortsCommandOutput = OpenInstancePublicPortsResult & __MetadataBearer; +/** + *

Opens ports for a specific Amazon Lightsail instance, and specifies the IP addresses + * allowed to connect to the instance through the ports, and the protocol.

+ *

The OpenInstancePublicPorts action supports tag-based access control via + * resource tags applied to the resource identified by instanceName. For more + * information, see the Lightsail Dev Guide.

+ */ export class OpenInstancePublicPortsCommand extends $Command< OpenInstancePublicPortsCommandInput, OpenInstancePublicPortsCommandOutput, @@ -34,6 +41,9 @@ export class OpenInstancePublicPortsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/PeerVpcCommand.ts b/clients/client-lightsail/commands/PeerVpcCommand.ts index 8f1e6a4290d05..8c7288d3ca9d3 100644 --- a/clients/client-lightsail/commands/PeerVpcCommand.ts +++ b/clients/client-lightsail/commands/PeerVpcCommand.ts @@ -17,6 +17,9 @@ import { export type PeerVpcCommandInput = PeerVpcRequest; export type PeerVpcCommandOutput = PeerVpcResult & __MetadataBearer; +/** + *

Tries to peer the Lightsail VPC with the user's default VPC.

+ */ export class PeerVpcCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class PeerVpcCommand extends $Command, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/PutAlarmCommand.ts b/clients/client-lightsail/commands/PutAlarmCommand.ts index cb04c2701efd2..5e2de11ad8f34 100644 --- a/clients/client-lightsail/commands/PutAlarmCommand.ts +++ b/clients/client-lightsail/commands/PutAlarmCommand.ts @@ -17,6 +17,19 @@ import { export type PutAlarmCommandInput = PutAlarmRequest; export type PutAlarmCommandOutput = PutAlarmResult & __MetadataBearer; +/** + *

Creates or updates an alarm, and associates it with the specified metric.

+ *

An alarm is used to monitor a single metric for one of your resources. When a metric + * condition is met, the alarm can notify you by email, SMS text message, and a banner displayed + * on the Amazon Lightsail console. For more information, see Alarms + * in Amazon Lightsail.

+ *

When this action creates an alarm, the alarm state is immediately set to + * INSUFFICIENT_DATA. The alarm is then evaluated and its state is set + * appropriately. Any actions associated with the new state are then executed.

+ *

When you update an existing alarm, its state is left unchanged, but the update completely + * overwrites the previous configuration of the alarm. The alarm is then evaluated with the + * updated configuration.

+ */ export class PutAlarmCommand extends $Command< PutAlarmCommandInput, PutAlarmCommandOutput, @@ -31,6 +44,9 @@ export class PutAlarmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/PutInstancePublicPortsCommand.ts b/clients/client-lightsail/commands/PutInstancePublicPortsCommand.ts index ef6a06607e834..fc9ee089c4e30 100644 --- a/clients/client-lightsail/commands/PutInstancePublicPortsCommand.ts +++ b/clients/client-lightsail/commands/PutInstancePublicPortsCommand.ts @@ -20,6 +20,17 @@ import { export type PutInstancePublicPortsCommandInput = PutInstancePublicPortsRequest; export type PutInstancePublicPortsCommandOutput = PutInstancePublicPortsResult & __MetadataBearer; +/** + *

Opens ports for a specific Amazon Lightsail instance, and specifies the IP addresses + * allowed to connect to the instance through the ports, and the protocol. This action also + * closes all currently open ports that are not included in the request. Include all of the ports + * and the protocols you want to open in your PutInstancePublicPortsrequest. Or use + * the OpenInstancePublicPorts action to open ports without closing currently open + * ports.

+ *

The PutInstancePublicPorts action supports tag-based access control via + * resource tags applied to the resource identified by instanceName. For more + * information, see the Lightsail Dev Guide.

+ */ export class PutInstancePublicPortsCommand extends $Command< PutInstancePublicPortsCommandInput, PutInstancePublicPortsCommandOutput, @@ -34,6 +45,9 @@ export class PutInstancePublicPortsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/RebootInstanceCommand.ts b/clients/client-lightsail/commands/RebootInstanceCommand.ts index 605b7d47d8388..44a83db141b48 100644 --- a/clients/client-lightsail/commands/RebootInstanceCommand.ts +++ b/clients/client-lightsail/commands/RebootInstanceCommand.ts @@ -20,6 +20,12 @@ import { export type RebootInstanceCommandInput = RebootInstanceRequest; export type RebootInstanceCommandOutput = RebootInstanceResult & __MetadataBearer; +/** + *

Restarts a specific instance.

+ *

The reboot instance operation supports tag-based access control via resource + * tags applied to the resource identified by instance name. For more information, + * see the Lightsail Dev Guide.

+ */ export class RebootInstanceCommand extends $Command< RebootInstanceCommandInput, RebootInstanceCommandOutput, @@ -34,6 +40,9 @@ export class RebootInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/RebootRelationalDatabaseCommand.ts b/clients/client-lightsail/commands/RebootRelationalDatabaseCommand.ts index e5d8dfd9b8031..2079188058589 100644 --- a/clients/client-lightsail/commands/RebootRelationalDatabaseCommand.ts +++ b/clients/client-lightsail/commands/RebootRelationalDatabaseCommand.ts @@ -20,6 +20,12 @@ import { export type RebootRelationalDatabaseCommandInput = RebootRelationalDatabaseRequest; export type RebootRelationalDatabaseCommandOutput = RebootRelationalDatabaseResult & __MetadataBearer; +/** + *

Restarts a specific database in Amazon Lightsail.

+ *

The reboot relational database operation supports tag-based access control + * via resource tags applied to the resource identified by relationalDatabaseName. For more + * information, see the Lightsail Dev Guide.

+ */ export class RebootRelationalDatabaseCommand extends $Command< RebootRelationalDatabaseCommandInput, RebootRelationalDatabaseCommandOutput, @@ -34,6 +40,9 @@ export class RebootRelationalDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/RegisterContainerImageCommand.ts b/clients/client-lightsail/commands/RegisterContainerImageCommand.ts index f0cacfdb8756e..13b954518d64d 100644 --- a/clients/client-lightsail/commands/RegisterContainerImageCommand.ts +++ b/clients/client-lightsail/commands/RegisterContainerImageCommand.ts @@ -20,6 +20,17 @@ import { export type RegisterContainerImageCommandInput = RegisterContainerImageRequest; export type RegisterContainerImageCommandOutput = RegisterContainerImageResult & __MetadataBearer; +/** + *

Registers a container image to your Amazon Lightsail container service.

+ * + * + *

This action is not required if you install and use the Lightsail Control + * (lightsailctl) plugin to push container images to your Lightsail container service. For + * more information, see Pushing and + * managing container images on your Amazon Lightsail container services in the + * Lightsail Dev Guide.

+ *
+ */ export class RegisterContainerImageCommand extends $Command< RegisterContainerImageCommandInput, RegisterContainerImageCommandOutput, @@ -34,6 +45,9 @@ export class RegisterContainerImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/ReleaseStaticIpCommand.ts b/clients/client-lightsail/commands/ReleaseStaticIpCommand.ts index 025306625a55e..44a202ec4351d 100644 --- a/clients/client-lightsail/commands/ReleaseStaticIpCommand.ts +++ b/clients/client-lightsail/commands/ReleaseStaticIpCommand.ts @@ -20,6 +20,9 @@ import { export type ReleaseStaticIpCommandInput = ReleaseStaticIpRequest; export type ReleaseStaticIpCommandOutput = ReleaseStaticIpResult & __MetadataBearer; +/** + *

Deletes a specific static IP from your account.

+ */ export class ReleaseStaticIpCommand extends $Command< ReleaseStaticIpCommandInput, ReleaseStaticIpCommandOutput, @@ -34,6 +37,9 @@ export class ReleaseStaticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/ResetDistributionCacheCommand.ts b/clients/client-lightsail/commands/ResetDistributionCacheCommand.ts index 7116f31e2fff4..e56688c5a34cd 100644 --- a/clients/client-lightsail/commands/ResetDistributionCacheCommand.ts +++ b/clients/client-lightsail/commands/ResetDistributionCacheCommand.ts @@ -20,6 +20,12 @@ import { export type ResetDistributionCacheCommandInput = ResetDistributionCacheRequest; export type ResetDistributionCacheCommandOutput = ResetDistributionCacheResult & __MetadataBearer; +/** + *

Deletes currently cached content from your Amazon Lightsail content delivery network (CDN) + * distribution.

+ *

After resetting the cache, the next time a content request is made, your distribution + * pulls, serves, and caches it from the origin.

+ */ export class ResetDistributionCacheCommand extends $Command< ResetDistributionCacheCommandInput, ResetDistributionCacheCommandOutput, @@ -34,6 +40,9 @@ export class ResetDistributionCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/SendContactMethodVerificationCommand.ts b/clients/client-lightsail/commands/SendContactMethodVerificationCommand.ts index 5dd55654a1c2c..dcd417dc736cd 100644 --- a/clients/client-lightsail/commands/SendContactMethodVerificationCommand.ts +++ b/clients/client-lightsail/commands/SendContactMethodVerificationCommand.ts @@ -20,6 +20,21 @@ import { export type SendContactMethodVerificationCommandInput = SendContactMethodVerificationRequest; export type SendContactMethodVerificationCommandOutput = SendContactMethodVerificationResult & __MetadataBearer; +/** + *

Sends a verification request to an email contact method to ensure it's owned by the + * requester. SMS contact methods don't need to be verified.

+ *

A contact method is used to send you notifications about your Amazon Lightsail resources. + * You can add one email address and one mobile phone number contact method in each AWS Region. + * However, SMS text messaging is not supported in some AWS Regions, and SMS text messages + * cannot be sent to some countries/regions. For more information, see Notifications in Amazon Lightsail.

+ *

A verification request is sent to the contact method when you initially create it. Use + * this action to send another verification request if a previous verification request was + * deleted, or has expired.

+ * + *

Notifications are not sent to an email contact method until after it is verified, and + * confirmed as valid.

+ *
+ */ export class SendContactMethodVerificationCommand extends $Command< SendContactMethodVerificationCommandInput, SendContactMethodVerificationCommandOutput, @@ -34,6 +49,9 @@ export class SendContactMethodVerificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/StartInstanceCommand.ts b/clients/client-lightsail/commands/StartInstanceCommand.ts index 2be70c8c0ff74..aa9f19c405eb6 100644 --- a/clients/client-lightsail/commands/StartInstanceCommand.ts +++ b/clients/client-lightsail/commands/StartInstanceCommand.ts @@ -20,6 +20,18 @@ import { export type StartInstanceCommandInput = StartInstanceRequest; export type StartInstanceCommandOutput = StartInstanceResult & __MetadataBearer; +/** + *

Starts a specific Amazon Lightsail instance from a stopped state. To restart an instance, + * use the reboot instance operation.

+ * + *

When you start a stopped instance, Lightsail assigns a new public IP address to the + * instance. To use the same IP address after stopping and starting an instance, create a + * static IP address and attach it to the instance. For more information, see the Lightsail Dev Guide.

+ *
+ *

The start instance operation supports tag-based access control via resource + * tags applied to the resource identified by instance name. For more information, + * see the Lightsail Dev Guide.

+ */ export class StartInstanceCommand extends $Command< StartInstanceCommandInput, StartInstanceCommandOutput, @@ -34,6 +46,9 @@ export class StartInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/StartRelationalDatabaseCommand.ts b/clients/client-lightsail/commands/StartRelationalDatabaseCommand.ts index 953d5c4f9b2de..d1556eed0b6bf 100644 --- a/clients/client-lightsail/commands/StartRelationalDatabaseCommand.ts +++ b/clients/client-lightsail/commands/StartRelationalDatabaseCommand.ts @@ -20,6 +20,13 @@ import { export type StartRelationalDatabaseCommandInput = StartRelationalDatabaseRequest; export type StartRelationalDatabaseCommandOutput = StartRelationalDatabaseResult & __MetadataBearer; +/** + *

Starts a specific database from a stopped state in Amazon Lightsail. To restart a database, + * use the reboot relational database operation.

+ *

The start relational database operation supports tag-based access control via + * resource tags applied to the resource identified by relationalDatabaseName. For more + * information, see the Lightsail Dev Guide.

+ */ export class StartRelationalDatabaseCommand extends $Command< StartRelationalDatabaseCommandInput, StartRelationalDatabaseCommandOutput, @@ -34,6 +41,9 @@ export class StartRelationalDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/StopInstanceCommand.ts b/clients/client-lightsail/commands/StopInstanceCommand.ts index 3a84bed29c7e6..38ad643abaefe 100644 --- a/clients/client-lightsail/commands/StopInstanceCommand.ts +++ b/clients/client-lightsail/commands/StopInstanceCommand.ts @@ -20,6 +20,17 @@ import { export type StopInstanceCommandInput = StopInstanceRequest; export type StopInstanceCommandOutput = StopInstanceResult & __MetadataBearer; +/** + *

Stops a specific Amazon Lightsail instance that is currently running.

+ * + *

When you start a stopped instance, Lightsail assigns a new public IP address to the + * instance. To use the same IP address after stopping and starting an instance, create a + * static IP address and attach it to the instance. For more information, see the Lightsail Dev Guide.

+ *
+ *

The stop instance operation supports tag-based access control via resource + * tags applied to the resource identified by instance name. For more information, + * see the Lightsail Dev Guide.

+ */ export class StopInstanceCommand extends $Command< StopInstanceCommandInput, StopInstanceCommandOutput, @@ -34,6 +45,9 @@ export class StopInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/StopRelationalDatabaseCommand.ts b/clients/client-lightsail/commands/StopRelationalDatabaseCommand.ts index 429df8a0bb786..8ced248a12c87 100644 --- a/clients/client-lightsail/commands/StopRelationalDatabaseCommand.ts +++ b/clients/client-lightsail/commands/StopRelationalDatabaseCommand.ts @@ -20,6 +20,12 @@ import { export type StopRelationalDatabaseCommandInput = StopRelationalDatabaseRequest; export type StopRelationalDatabaseCommandOutput = StopRelationalDatabaseResult & __MetadataBearer; +/** + *

Stops a specific database that is currently running in Amazon Lightsail.

+ *

The stop relational database operation supports tag-based access control via + * resource tags applied to the resource identified by relationalDatabaseName. For more + * information, see the Lightsail Dev Guide.

+ */ export class StopRelationalDatabaseCommand extends $Command< StopRelationalDatabaseCommandInput, StopRelationalDatabaseCommandOutput, @@ -34,6 +40,9 @@ export class StopRelationalDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/TagResourceCommand.ts b/clients/client-lightsail/commands/TagResourceCommand.ts index a51692e714fdd..8f7bc1db7d46c 100644 --- a/clients/client-lightsail/commands/TagResourceCommand.ts +++ b/clients/client-lightsail/commands/TagResourceCommand.ts @@ -20,6 +20,15 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResult & __MetadataBearer; +/** + *

Adds one or more tags to the specified Amazon Lightsail resource. Each resource can have a + * maximum of 50 tags. Each tag consists of a key and an optional value. Tag keys must be unique + * per resource. For more information about tags, see the Lightsail + * Dev Guide.

+ *

The tag resource operation supports tag-based access control via request tags + * and resource tags applied to the resource identified by resource name. For more + * information, see the Lightsail Dev Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +43,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/TestAlarmCommand.ts b/clients/client-lightsail/commands/TestAlarmCommand.ts index aeacaa8cb4bb9..011068b43bc0e 100644 --- a/clients/client-lightsail/commands/TestAlarmCommand.ts +++ b/clients/client-lightsail/commands/TestAlarmCommand.ts @@ -17,6 +17,16 @@ import { export type TestAlarmCommandInput = TestAlarmRequest; export type TestAlarmCommandOutput = TestAlarmResult & __MetadataBearer; +/** + *

Tests an alarm by displaying a banner on the Amazon Lightsail console. If a notification + * trigger is configured for the specified alarm, the test also sends a notification to the + * notification protocol (Email and/or SMS) configured for the + * alarm.

+ *

An alarm is used to monitor a single metric for one of your resources. When a metric + * condition is met, the alarm can notify you by email, SMS text message, and a banner displayed + * on the Amazon Lightsail console. For more information, see Alarms + * in Amazon Lightsail.

+ */ export class TestAlarmCommand extends $Command< TestAlarmCommandInput, TestAlarmCommandOutput, @@ -31,6 +41,9 @@ export class TestAlarmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UnpeerVpcCommand.ts b/clients/client-lightsail/commands/UnpeerVpcCommand.ts index 861687924d30f..088fd1a04f810 100644 --- a/clients/client-lightsail/commands/UnpeerVpcCommand.ts +++ b/clients/client-lightsail/commands/UnpeerVpcCommand.ts @@ -17,6 +17,9 @@ import { export type UnpeerVpcCommandInput = UnpeerVpcRequest; export type UnpeerVpcCommandOutput = UnpeerVpcResult & __MetadataBearer; +/** + *

Attempts to unpeer the Lightsail VPC from the user's default VPC.

+ */ export class UnpeerVpcCommand extends $Command< UnpeerVpcCommandInput, UnpeerVpcCommandOutput, @@ -31,6 +34,9 @@ export class UnpeerVpcCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UntagResourceCommand.ts b/clients/client-lightsail/commands/UntagResourceCommand.ts index 3b0055fafaaed..8f5d5903469fa 100644 --- a/clients/client-lightsail/commands/UntagResourceCommand.ts +++ b/clients/client-lightsail/commands/UntagResourceCommand.ts @@ -20,6 +20,13 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResult & __MetadataBearer; +/** + *

Deletes the specified set of tag keys and their values from the specified Amazon Lightsail + * resource.

+ *

The untag resource operation supports tag-based access control via request + * tags and resource tags applied to the resource identified by resource name. For + * more information, see the Lightsail Dev Guide.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +41,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UpdateContainerServiceCommand.ts b/clients/client-lightsail/commands/UpdateContainerServiceCommand.ts index 8067ec3245f3b..30381ce9b4a43 100644 --- a/clients/client-lightsail/commands/UpdateContainerServiceCommand.ts +++ b/clients/client-lightsail/commands/UpdateContainerServiceCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateContainerServiceCommandInput = UpdateContainerServiceRequest; export type UpdateContainerServiceCommandOutput = UpdateContainerServiceResult & __MetadataBearer; +/** + *

Updates the configuration of your Amazon Lightsail container service, such as its power, + * scale, and public domain names.

+ */ export class UpdateContainerServiceCommand extends $Command< UpdateContainerServiceCommandInput, UpdateContainerServiceCommandOutput, @@ -34,6 +38,9 @@ export class UpdateContainerServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UpdateDistributionBundleCommand.ts b/clients/client-lightsail/commands/UpdateDistributionBundleCommand.ts index faeac0f45737a..44d98d3e74c9c 100644 --- a/clients/client-lightsail/commands/UpdateDistributionBundleCommand.ts +++ b/clients/client-lightsail/commands/UpdateDistributionBundleCommand.ts @@ -20,6 +20,18 @@ import { export type UpdateDistributionBundleCommandInput = UpdateDistributionBundleRequest; export type UpdateDistributionBundleCommandOutput = UpdateDistributionBundleResult & __MetadataBearer; +/** + *

Updates the bundle of your Amazon Lightsail content delivery network (CDN) + * distribution.

+ *

A distribution bundle specifies the monthly network transfer quota and monthly cost of + * your dsitribution.

+ *

Update your distribution's bundle if your distribution is going over its monthly network + * transfer quota and is incurring an overage fee.

+ *

You can update your distribution's bundle only one time within your monthly AWS billing + * cycle. To determine if you can update your distribution's bundle, use the + * GetDistributions action. The ableToUpdateBundle parameter in the + * result will indicate whether you can currently update your distribution's bundle.

+ */ export class UpdateDistributionBundleCommand extends $Command< UpdateDistributionBundleCommandInput, UpdateDistributionBundleCommandOutput, @@ -34,6 +46,9 @@ export class UpdateDistributionBundleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UpdateDistributionCommand.ts b/clients/client-lightsail/commands/UpdateDistributionCommand.ts index c57bfe50c09ea..fec0f58d97665 100644 --- a/clients/client-lightsail/commands/UpdateDistributionCommand.ts +++ b/clients/client-lightsail/commands/UpdateDistributionCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDistributionCommandInput = UpdateDistributionRequest; export type UpdateDistributionCommandOutput = UpdateDistributionResult & __MetadataBearer; +/** + *

Updates an existing Amazon Lightsail content delivery network (CDN) distribution.

+ *

Use this action to update the configuration of your existing distribution

+ */ export class UpdateDistributionCommand extends $Command< UpdateDistributionCommandInput, UpdateDistributionCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDistributionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UpdateDomainEntryCommand.ts b/clients/client-lightsail/commands/UpdateDomainEntryCommand.ts index a827ad7264444..9c58abb6f7285 100644 --- a/clients/client-lightsail/commands/UpdateDomainEntryCommand.ts +++ b/clients/client-lightsail/commands/UpdateDomainEntryCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateDomainEntryCommandInput = UpdateDomainEntryRequest; export type UpdateDomainEntryCommandOutput = UpdateDomainEntryResult & __MetadataBearer; +/** + *

Updates a domain recordset after it is created.

+ *

The update domain entry operation supports tag-based access control via + * resource tags applied to the resource identified by domain name. For more + * information, see the Lightsail Dev Guide.

+ */ export class UpdateDomainEntryCommand extends $Command< UpdateDomainEntryCommandInput, UpdateDomainEntryCommandOutput, @@ -34,6 +40,9 @@ export class UpdateDomainEntryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UpdateLoadBalancerAttributeCommand.ts b/clients/client-lightsail/commands/UpdateLoadBalancerAttributeCommand.ts index 51f8b4daafffb..d4b6f83157649 100644 --- a/clients/client-lightsail/commands/UpdateLoadBalancerAttributeCommand.ts +++ b/clients/client-lightsail/commands/UpdateLoadBalancerAttributeCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateLoadBalancerAttributeCommandInput = UpdateLoadBalancerAttributeRequest; export type UpdateLoadBalancerAttributeCommandOutput = UpdateLoadBalancerAttributeResult & __MetadataBearer; +/** + *

Updates the specified attribute for a load balancer. You can only update one attribute at + * a time.

+ *

The update load balancer attribute operation supports tag-based access + * control via resource tags applied to the resource identified by load balancer + * name. For more information, see the Lightsail Dev Guide.

+ */ export class UpdateLoadBalancerAttributeCommand extends $Command< UpdateLoadBalancerAttributeCommandInput, UpdateLoadBalancerAttributeCommandOutput, @@ -34,6 +41,9 @@ export class UpdateLoadBalancerAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UpdateRelationalDatabaseCommand.ts b/clients/client-lightsail/commands/UpdateRelationalDatabaseCommand.ts index 5f7b9e35a3076..2d95141ea9c8c 100644 --- a/clients/client-lightsail/commands/UpdateRelationalDatabaseCommand.ts +++ b/clients/client-lightsail/commands/UpdateRelationalDatabaseCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateRelationalDatabaseCommandInput = UpdateRelationalDatabaseRequest; export type UpdateRelationalDatabaseCommandOutput = UpdateRelationalDatabaseResult & __MetadataBearer; +/** + *

Allows the update of one or more attributes of a database in Amazon Lightsail.

+ *

Updates are applied immediately, or in cases where the updates could result in an outage, + * are applied during the database's predefined maintenance window.

+ *

The update relational database operation supports tag-based access control + * via resource tags applied to the resource identified by relationalDatabaseName. For more + * information, see the Lightsail Dev Guide.

+ */ export class UpdateRelationalDatabaseCommand extends $Command< UpdateRelationalDatabaseCommandInput, UpdateRelationalDatabaseCommandOutput, @@ -34,6 +42,9 @@ export class UpdateRelationalDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/commands/UpdateRelationalDatabaseParametersCommand.ts b/clients/client-lightsail/commands/UpdateRelationalDatabaseParametersCommand.ts index 22d69211dbddc..38224249089fd 100644 --- a/clients/client-lightsail/commands/UpdateRelationalDatabaseParametersCommand.ts +++ b/clients/client-lightsail/commands/UpdateRelationalDatabaseParametersCommand.ts @@ -24,6 +24,18 @@ export type UpdateRelationalDatabaseParametersCommandInput = UpdateRelationalDat export type UpdateRelationalDatabaseParametersCommandOutput = UpdateRelationalDatabaseParametersResult & __MetadataBearer; +/** + *

Allows the update of one or more parameters of a database in Amazon Lightsail.

+ *

Parameter updates don't cause outages; therefore, their application is not subject to the + * preferred maintenance window. However, there are two ways in which parameter updates are + * applied: dynamic or pending-reboot. Parameters marked with a + * dynamic apply type are applied immediately. Parameters marked with a + * pending-reboot apply type are applied only after the database is rebooted using + * the reboot relational database operation.

+ *

The update relational database parameters operation supports tag-based access + * control via resource tags applied to the resource identified by relationalDatabaseName. For + * more information, see the Lightsail Dev Guide.

+ */ export class UpdateRelationalDatabaseParametersCommand extends $Command< UpdateRelationalDatabaseParametersCommandInput, UpdateRelationalDatabaseParametersCommandOutput, @@ -38,6 +50,9 @@ export class UpdateRelationalDatabaseParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: LightsailClientResolvedConfig, diff --git a/clients/client-lightsail/package.json b/clients/client-lightsail/package.json index 7420152b9d5dc..5f884adb30e01 100644 --- a/clients/client-lightsail/package.json +++ b/clients/client-lightsail/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Lightsail Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-lightsail/runtimeConfig.browser.ts b/clients/client-lightsail/runtimeConfig.browser.ts index 1d41b8f0cb042..33dbde3bf2089 100644 --- a/clients/client-lightsail/runtimeConfig.browser.ts +++ b/clients/client-lightsail/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./LightsailClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-lightsail/runtimeConfig.native.ts b/clients/client-lightsail/runtimeConfig.native.ts index 49e406dadb854..5868249ab557f 100644 --- a/clients/client-lightsail/runtimeConfig.native.ts +++ b/clients/client-lightsail/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./LightsailClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-lightsail/runtimeConfig.shared.ts b/clients/client-lightsail/runtimeConfig.shared.ts index c8c6981119992..ab08bacbdf313 100644 --- a/clients/client-lightsail/runtimeConfig.shared.ts +++ b/clients/client-lightsail/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-11-28", disableHostPrefix: false, diff --git a/clients/client-lightsail/runtimeConfig.ts b/clients/client-lightsail/runtimeConfig.ts index 5a7131b09b60d..fec6ffebc3c9c 100644 --- a/clients/client-lightsail/runtimeConfig.ts +++ b/clients/client-lightsail/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./LightsailClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-lightsail/tsconfig.json b/clients/client-lightsail/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-lightsail/tsconfig.json +++ b/clients/client-lightsail/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-machine-learning/commands/AddTagsCommand.ts b/clients/client-machine-learning/commands/AddTagsCommand.ts index 9ddebdc272363..c458401e16624 100644 --- a/clients/client-machine-learning/commands/AddTagsCommand.ts +++ b/clients/client-machine-learning/commands/AddTagsCommand.ts @@ -17,6 +17,11 @@ import { export type AddTagsCommandInput = AddTagsInput; export type AddTagsCommandOutput = AddTagsOutput & __MetadataBearer; +/** + *

Adds one or more tags to an object, up to a limit of 10. Each tag consists of a key + * and an optional value. If you add a tag using a key that is already associated with the ML object, + * AddTags updates the tag's value.

+ */ export class AddTagsCommand extends $Command< AddTagsCommandInput, AddTagsCommandOutput, @@ -31,6 +36,9 @@ export class AddTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/CreateBatchPredictionCommand.ts b/clients/client-machine-learning/commands/CreateBatchPredictionCommand.ts index 4672d3081a4d4..b66f672bd7dc8 100644 --- a/clients/client-machine-learning/commands/CreateBatchPredictionCommand.ts +++ b/clients/client-machine-learning/commands/CreateBatchPredictionCommand.ts @@ -20,6 +20,20 @@ import { export type CreateBatchPredictionCommandInput = CreateBatchPredictionInput; export type CreateBatchPredictionCommandOutput = CreateBatchPredictionOutput & __MetadataBearer; +/** + *

Generates predictions for a group of observations. The observations to process exist in one or more data files referenced + * by a DataSource. This operation creates a new BatchPrediction, and uses an MLModel and the data + * files referenced by the DataSource as information sources. + *

+ * + *

+ * CreateBatchPrediction is an asynchronous operation. In response to CreateBatchPrediction, + * Amazon Machine Learning (Amazon ML) immediately returns and sets the BatchPrediction status to PENDING. + * After the BatchPrediction completes, Amazon ML sets the status to COMPLETED. + *

+ *

You can poll for status updates by using the GetBatchPrediction operation and checking the Status parameter of the result. After the COMPLETED status appears, + * the results are available in the location specified by the OutputUri parameter.

+ */ export class CreateBatchPredictionCommand extends $Command< CreateBatchPredictionCommandInput, CreateBatchPredictionCommandOutput, @@ -34,6 +48,9 @@ export class CreateBatchPredictionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/CreateDataSourceFromRDSCommand.ts b/clients/client-machine-learning/commands/CreateDataSourceFromRDSCommand.ts index dda7361634b93..02fc3621487ba 100644 --- a/clients/client-machine-learning/commands/CreateDataSourceFromRDSCommand.ts +++ b/clients/client-machine-learning/commands/CreateDataSourceFromRDSCommand.ts @@ -20,6 +20,20 @@ import { export type CreateDataSourceFromRDSCommandInput = CreateDataSourceFromRDSInput; export type CreateDataSourceFromRDSCommandOutput = CreateDataSourceFromRDSOutput & __MetadataBearer; +/** + *

Creates a DataSource object from an Amazon Relational Database Service (Amazon RDS). A DataSource references data that can be used to perform CreateMLModel, CreateEvaluation, or CreateBatchPrediction operations.

+ * + *

+ * CreateDataSourceFromRDS is an asynchronous operation. In response to CreateDataSourceFromRDS, + * Amazon Machine Learning (Amazon ML) immediately returns and sets the DataSource status to PENDING. + * After the DataSource is created and ready for use, Amazon ML sets the Status parameter to COMPLETED. + * DataSource in the COMPLETED or PENDING state can + * be used only to perform >CreateMLModel>, CreateEvaluation, or CreateBatchPrediction operations. + *

+ *

+ * If Amazon ML cannot accept the input source, it sets the Status parameter to FAILED and includes an error message in the Message attribute of the GetDataSource operation response. + *

+ */ export class CreateDataSourceFromRDSCommand extends $Command< CreateDataSourceFromRDSCommandInput, CreateDataSourceFromRDSCommandOutput, @@ -34,6 +48,9 @@ export class CreateDataSourceFromRDSCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/CreateDataSourceFromRedshiftCommand.ts b/clients/client-machine-learning/commands/CreateDataSourceFromRedshiftCommand.ts index 3bf1eda510277..80057e9c24d0c 100644 --- a/clients/client-machine-learning/commands/CreateDataSourceFromRedshiftCommand.ts +++ b/clients/client-machine-learning/commands/CreateDataSourceFromRedshiftCommand.ts @@ -20,6 +20,41 @@ import { export type CreateDataSourceFromRedshiftCommandInput = CreateDataSourceFromRedshiftInput; export type CreateDataSourceFromRedshiftCommandOutput = CreateDataSourceFromRedshiftOutput & __MetadataBearer; +/** + *

Creates a DataSource from a database hosted on an Amazon Redshift cluster. A + * DataSource references data that can be used to perform either CreateMLModel, CreateEvaluation, or CreateBatchPrediction + * operations.

+ * + *

+ * CreateDataSourceFromRedshift is an asynchronous operation. In response to CreateDataSourceFromRedshift, Amazon Machine Learning (Amazon ML) immediately returns and sets the DataSource status to PENDING. + * After the DataSource is created and ready for use, Amazon ML sets the Status parameter to COMPLETED. + * DataSource in COMPLETED or PENDING states can be + * used to perform only CreateMLModel, CreateEvaluation, or CreateBatchPrediction operations. + *

+ * + *

+ * If Amazon ML can't accept the input source, it sets the Status parameter to FAILED and includes an error message in the Message + * attribute of the GetDataSource operation response. + *

+ * + *

The observations should be contained in the database hosted on an Amazon Redshift cluster + * and should be specified by a SelectSqlQuery query. Amazon ML executes an + * Unload command in Amazon Redshift to transfer the result set of + * the SelectSqlQuery query to S3StagingLocation.

+ * + *

After the DataSource has been created, it's ready for use in evaluations and + * batch predictions. If you plan to use the DataSource to train an + * MLModel, the DataSource also requires a recipe. A recipe + * describes how each input variable will be used in training an MLModel. Will + * the variable be included or excluded from training? Will the variable be manipulated; + * for example, will it be combined with another variable or will it be split apart into + * word combinations? The recipe provides answers to these questions.

+ *

You can't change an existing datasource, but you can copy and modify the settings from an + * existing Amazon Redshift datasource to create a new datasource. To do so, call + * GetDataSource for an existing datasource and copy the values to a + * CreateDataSource call. Change the settings that you want to change and + * make sure that all required fields have the appropriate values.

+ */ export class CreateDataSourceFromRedshiftCommand extends $Command< CreateDataSourceFromRedshiftCommandInput, CreateDataSourceFromRedshiftCommandOutput, @@ -34,6 +69,9 @@ export class CreateDataSourceFromRedshiftCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/CreateDataSourceFromS3Command.ts b/clients/client-machine-learning/commands/CreateDataSourceFromS3Command.ts index 92524a9a43dab..1f78dc4fe1b2c 100644 --- a/clients/client-machine-learning/commands/CreateDataSourceFromS3Command.ts +++ b/clients/client-machine-learning/commands/CreateDataSourceFromS3Command.ts @@ -20,6 +20,39 @@ import { export type CreateDataSourceFromS3CommandInput = CreateDataSourceFromS3Input; export type CreateDataSourceFromS3CommandOutput = CreateDataSourceFromS3Output & __MetadataBearer; +/** + *

Creates a DataSource object. A DataSource references data that + * can be used to perform CreateMLModel, CreateEvaluation, or + * CreateBatchPrediction operations.

+ * + *

+ * CreateDataSourceFromS3 is an asynchronous operation. In response to + * CreateDataSourceFromS3, Amazon Machine Learning (Amazon ML) immediately + * returns and sets the DataSource status to PENDING. After the + * DataSource has been created and is ready for use, Amazon ML sets the + * Status parameter to COMPLETED. DataSource in + * the COMPLETED or PENDING state can be used to perform only + * CreateMLModel, CreateEvaluation or + * CreateBatchPrediction operations.

+ * + *

If Amazon ML can't accept the input source, it sets the Status parameter to + * FAILED and includes an error message in the Message + * attribute of the GetDataSource operation response.

+ * + *

The observation data used in a DataSource should be ready to use; that is, + * it should have a consistent structure, and missing data values should be kept to a + * minimum. The observation data must reside in one or more .csv files in an Amazon Simple + * Storage Service (Amazon S3) location, along with a schema that describes the data items + * by name and type. The same schema must be used for all of the data files referenced by + * the DataSource.

+ *

After the DataSource has been created, it's ready to use in evaluations and + * batch predictions. If you plan to use the DataSource to train an + * MLModel, the DataSource also needs a recipe. A recipe + * describes how each input variable will be used in training an MLModel. Will + * the variable be included or excluded from training? Will the variable be manipulated; + * for example, will it be combined with another variable or will it be split apart into + * word combinations? The recipe provides answers to these questions.

+ */ export class CreateDataSourceFromS3Command extends $Command< CreateDataSourceFromS3CommandInput, CreateDataSourceFromS3CommandOutput, @@ -34,6 +67,9 @@ export class CreateDataSourceFromS3Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/CreateEvaluationCommand.ts b/clients/client-machine-learning/commands/CreateEvaluationCommand.ts index df19d480c9378..afc0109a07545 100644 --- a/clients/client-machine-learning/commands/CreateEvaluationCommand.ts +++ b/clients/client-machine-learning/commands/CreateEvaluationCommand.ts @@ -20,6 +20,20 @@ import { export type CreateEvaluationCommandInput = CreateEvaluationInput; export type CreateEvaluationCommandOutput = CreateEvaluationOutput & __MetadataBearer; +/** + *

Creates a new Evaluation of an MLModel. An MLModel is evaluated on a set of observations associated to a DataSource. Like a DataSource + * for an MLModel, the DataSource for an Evaluation contains values for the Target Variable. The Evaluation compares the predicted result for each observation to the actual outcome and provides a + * summary so that you know how effective the MLModel functions on the test + * data. Evaluation generates a relevant performance metric, such as BinaryAUC, RegressionRMSE or MulticlassAvgFScore based on the corresponding MLModelType: BINARY, REGRESSION or MULTICLASS. + * + *

+ *

+ * CreateEvaluation is an asynchronous operation. In response to CreateEvaluation, Amazon Machine Learning (Amazon ML) immediately + * returns and sets the evaluation status to PENDING. After the Evaluation is created and ready for use, + * Amazon ML sets the status to COMPLETED. + *

+ *

You can use the GetEvaluation operation to check progress of the evaluation during the creation operation.

+ */ export class CreateEvaluationCommand extends $Command< CreateEvaluationCommandInput, CreateEvaluationCommandOutput, @@ -34,6 +48,9 @@ export class CreateEvaluationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/CreateMLModelCommand.ts b/clients/client-machine-learning/commands/CreateMLModelCommand.ts index e2580081847af..09b7d8134c7e7 100644 --- a/clients/client-machine-learning/commands/CreateMLModelCommand.ts +++ b/clients/client-machine-learning/commands/CreateMLModelCommand.ts @@ -20,6 +20,28 @@ import { export type CreateMLModelCommandInput = CreateMLModelInput; export type CreateMLModelCommandOutput = CreateMLModelOutput & __MetadataBearer; +/** + *

Creates a new MLModel using the DataSource and the recipe as + * information sources.

+ *

An MLModel is nearly immutable. Users can update only the + * MLModelName and the ScoreThreshold in an + * MLModel without creating a new MLModel.

+ *

+ * CreateMLModel is an asynchronous operation. In response to + * CreateMLModel, Amazon Machine Learning (Amazon ML) immediately returns + * and sets the MLModel status to PENDING. After the + * MLModel has been created and ready is for use, Amazon ML sets the + * status to COMPLETED.

+ *

You can use the GetMLModel operation to check the progress of the + * MLModel during the creation operation.

+ * + *

+ * CreateMLModel requires a DataSource with computed statistics, + * which can be created by setting ComputeStatistics to true in + * CreateDataSourceFromRDS, CreateDataSourceFromS3, or + * CreateDataSourceFromRedshift operations. + *

+ */ export class CreateMLModelCommand extends $Command< CreateMLModelCommandInput, CreateMLModelCommandOutput, @@ -34,6 +56,9 @@ export class CreateMLModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/CreateRealtimeEndpointCommand.ts b/clients/client-machine-learning/commands/CreateRealtimeEndpointCommand.ts index fcd29c0c4158a..d3f3b52b90cae 100644 --- a/clients/client-machine-learning/commands/CreateRealtimeEndpointCommand.ts +++ b/clients/client-machine-learning/commands/CreateRealtimeEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRealtimeEndpointCommandInput = CreateRealtimeEndpointInput; export type CreateRealtimeEndpointCommandOutput = CreateRealtimeEndpointOutput & __MetadataBearer; +/** + *

Creates a real-time endpoint for the MLModel. The endpoint contains the URI of the MLModel; that is, the location to send real-time prediction requests for the specified MLModel.

+ */ export class CreateRealtimeEndpointCommand extends $Command< CreateRealtimeEndpointCommandInput, CreateRealtimeEndpointCommandOutput, @@ -34,6 +37,9 @@ export class CreateRealtimeEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DeleteBatchPredictionCommand.ts b/clients/client-machine-learning/commands/DeleteBatchPredictionCommand.ts index 864aff20b44be..def01a7734151 100644 --- a/clients/client-machine-learning/commands/DeleteBatchPredictionCommand.ts +++ b/clients/client-machine-learning/commands/DeleteBatchPredictionCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteBatchPredictionCommandInput = DeleteBatchPredictionInput; export type DeleteBatchPredictionCommandOutput = DeleteBatchPredictionOutput & __MetadataBearer; +/** + *

Assigns the DELETED status to a BatchPrediction, rendering it unusable.

+ *

After using the DeleteBatchPrediction operation, you can use the GetBatchPrediction + * operation to verify that the status of the BatchPrediction changed to DELETED.

+ * + *

+ * Caution: The result of the DeleteBatchPrediction operation is irreversible.

+ */ export class DeleteBatchPredictionCommand extends $Command< DeleteBatchPredictionCommandInput, DeleteBatchPredictionCommandOutput, @@ -34,6 +42,9 @@ export class DeleteBatchPredictionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DeleteDataSourceCommand.ts b/clients/client-machine-learning/commands/DeleteDataSourceCommand.ts index 0b13abfa02559..0a5bfd1b1004c 100644 --- a/clients/client-machine-learning/commands/DeleteDataSourceCommand.ts +++ b/clients/client-machine-learning/commands/DeleteDataSourceCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDataSourceCommandInput = DeleteDataSourceInput; export type DeleteDataSourceCommandOutput = DeleteDataSourceOutput & __MetadataBearer; +/** + *

Assigns the DELETED status to a DataSource, rendering it unusable.

+ *

After using the DeleteDataSource operation, you can use the GetDataSource operation to verify that the status of the DataSource changed to DELETED.

+ *

+ * Caution: The results of the DeleteDataSource operation are irreversible.

+ */ export class DeleteDataSourceCommand extends $Command< DeleteDataSourceCommandInput, DeleteDataSourceCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DeleteEvaluationCommand.ts b/clients/client-machine-learning/commands/DeleteEvaluationCommand.ts index 44a8fec7d77be..8d2c33e68c09f 100644 --- a/clients/client-machine-learning/commands/DeleteEvaluationCommand.ts +++ b/clients/client-machine-learning/commands/DeleteEvaluationCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteEvaluationCommandInput = DeleteEvaluationInput; export type DeleteEvaluationCommandOutput = DeleteEvaluationOutput & __MetadataBearer; +/** + *

Assigns the DELETED status to an Evaluation, rendering it unusable.

+ * + *

After invoking the DeleteEvaluation operation, you can use the + * GetEvaluation operation to verify that the status of the Evaluation changed to DELETED.

+ *

+ * Caution: The results of the DeleteEvaluation operation are irreversible.

+ */ export class DeleteEvaluationCommand extends $Command< DeleteEvaluationCommandInput, DeleteEvaluationCommandOutput, @@ -34,6 +42,9 @@ export class DeleteEvaluationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DeleteMLModelCommand.ts b/clients/client-machine-learning/commands/DeleteMLModelCommand.ts index d196ce7be0eb5..aa9fb9f57ed3a 100644 --- a/clients/client-machine-learning/commands/DeleteMLModelCommand.ts +++ b/clients/client-machine-learning/commands/DeleteMLModelCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteMLModelCommandInput = DeleteMLModelInput; export type DeleteMLModelCommandOutput = DeleteMLModelOutput & __MetadataBearer; +/** + *

Assigns the DELETED status to an MLModel, rendering it unusable.

+ *

After using the DeleteMLModel operation, you can use the + * GetMLModel operation to verify that the status of the MLModel changed to DELETED.

+ * + *

+ * Caution: The result of the DeleteMLModel operation is irreversible.

+ */ export class DeleteMLModelCommand extends $Command< DeleteMLModelCommandInput, DeleteMLModelCommandOutput, @@ -34,6 +42,9 @@ export class DeleteMLModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DeleteRealtimeEndpointCommand.ts b/clients/client-machine-learning/commands/DeleteRealtimeEndpointCommand.ts index 1304abccc5e2d..607968d90fe59 100644 --- a/clients/client-machine-learning/commands/DeleteRealtimeEndpointCommand.ts +++ b/clients/client-machine-learning/commands/DeleteRealtimeEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRealtimeEndpointCommandInput = DeleteRealtimeEndpointInput; export type DeleteRealtimeEndpointCommandOutput = DeleteRealtimeEndpointOutput & __MetadataBearer; +/** + *

Deletes a real time endpoint of an MLModel.

+ */ export class DeleteRealtimeEndpointCommand extends $Command< DeleteRealtimeEndpointCommandInput, DeleteRealtimeEndpointCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRealtimeEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DeleteTagsCommand.ts b/clients/client-machine-learning/commands/DeleteTagsCommand.ts index 97d2442cc05f6..9f216abcc7bf0 100644 --- a/clients/client-machine-learning/commands/DeleteTagsCommand.ts +++ b/clients/client-machine-learning/commands/DeleteTagsCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTagsCommandInput = DeleteTagsInput; export type DeleteTagsCommandOutput = DeleteTagsOutput & __MetadataBearer; +/** + *

Deletes the specified tags associated with an ML object. After this operation is complete, you can't recover deleted tags.

+ *

If you specify a tag that doesn't exist, Amazon ML ignores it.

+ */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DescribeBatchPredictionsCommand.ts b/clients/client-machine-learning/commands/DescribeBatchPredictionsCommand.ts index cb49251fb5c56..9c0386a35deff 100644 --- a/clients/client-machine-learning/commands/DescribeBatchPredictionsCommand.ts +++ b/clients/client-machine-learning/commands/DescribeBatchPredictionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBatchPredictionsCommandInput = DescribeBatchPredictionsInput; export type DescribeBatchPredictionsCommandOutput = DescribeBatchPredictionsOutput & __MetadataBearer; +/** + *

Returns a list of BatchPrediction operations that match the search criteria in the request.

+ */ export class DescribeBatchPredictionsCommand extends $Command< DescribeBatchPredictionsCommandInput, DescribeBatchPredictionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBatchPredictionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DescribeDataSourcesCommand.ts b/clients/client-machine-learning/commands/DescribeDataSourcesCommand.ts index 8d0f3bef08c7b..8ee3632277b6d 100644 --- a/clients/client-machine-learning/commands/DescribeDataSourcesCommand.ts +++ b/clients/client-machine-learning/commands/DescribeDataSourcesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDataSourcesCommandInput = DescribeDataSourcesInput; export type DescribeDataSourcesCommandOutput = DescribeDataSourcesOutput & __MetadataBearer; +/** + *

Returns a list of DataSource that match the search criteria in the request.

+ */ export class DescribeDataSourcesCommand extends $Command< DescribeDataSourcesCommandInput, DescribeDataSourcesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDataSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DescribeEvaluationsCommand.ts b/clients/client-machine-learning/commands/DescribeEvaluationsCommand.ts index 59e02c594583d..0b9ac7814400c 100644 --- a/clients/client-machine-learning/commands/DescribeEvaluationsCommand.ts +++ b/clients/client-machine-learning/commands/DescribeEvaluationsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEvaluationsCommandInput = DescribeEvaluationsInput; export type DescribeEvaluationsCommandOutput = DescribeEvaluationsOutput & __MetadataBearer; +/** + *

Returns a list of DescribeEvaluations that match the search criteria in the request.

+ */ export class DescribeEvaluationsCommand extends $Command< DescribeEvaluationsCommandInput, DescribeEvaluationsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEvaluationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DescribeMLModelsCommand.ts b/clients/client-machine-learning/commands/DescribeMLModelsCommand.ts index 362679d7b9e18..81b78df74e3a2 100644 --- a/clients/client-machine-learning/commands/DescribeMLModelsCommand.ts +++ b/clients/client-machine-learning/commands/DescribeMLModelsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMLModelsCommandInput = DescribeMLModelsInput; export type DescribeMLModelsCommandOutput = DescribeMLModelsOutput & __MetadataBearer; +/** + *

Returns a list of MLModel that match the search criteria in the request.

+ */ export class DescribeMLModelsCommand extends $Command< DescribeMLModelsCommandInput, DescribeMLModelsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMLModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/DescribeTagsCommand.ts b/clients/client-machine-learning/commands/DescribeTagsCommand.ts index 64ea247c90f36..5dfd82f5baaf5 100644 --- a/clients/client-machine-learning/commands/DescribeTagsCommand.ts +++ b/clients/client-machine-learning/commands/DescribeTagsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTagsCommandInput = DescribeTagsInput; export type DescribeTagsCommandOutput = DescribeTagsOutput & __MetadataBearer; +/** + *

Describes one or more of the tags for your Amazon ML object.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/GetBatchPredictionCommand.ts b/clients/client-machine-learning/commands/GetBatchPredictionCommand.ts index 6ea9c0f14af2a..e8fa2e30d13d1 100644 --- a/clients/client-machine-learning/commands/GetBatchPredictionCommand.ts +++ b/clients/client-machine-learning/commands/GetBatchPredictionCommand.ts @@ -20,6 +20,10 @@ import { export type GetBatchPredictionCommandInput = GetBatchPredictionInput; export type GetBatchPredictionCommandOutput = GetBatchPredictionOutput & __MetadataBearer; +/** + *

Returns a BatchPrediction that includes detailed metadata, status, and data file information for a + * Batch Prediction request.

+ */ export class GetBatchPredictionCommand extends $Command< GetBatchPredictionCommandInput, GetBatchPredictionCommandOutput, @@ -34,6 +38,9 @@ export class GetBatchPredictionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/GetDataSourceCommand.ts b/clients/client-machine-learning/commands/GetDataSourceCommand.ts index e6576b47f4605..268361ea8d424 100644 --- a/clients/client-machine-learning/commands/GetDataSourceCommand.ts +++ b/clients/client-machine-learning/commands/GetDataSourceCommand.ts @@ -20,6 +20,12 @@ import { export type GetDataSourceCommandInput = GetDataSourceInput; export type GetDataSourceCommandOutput = GetDataSourceOutput & __MetadataBearer; +/** + *

Returns a DataSource that includes metadata and data file information, as well as the current status of the DataSource.

+ *

+ * GetDataSource provides results in normal or verbose format. The verbose format + * adds the schema description and the list of files pointed to by the DataSource to the normal format.

+ */ export class GetDataSourceCommand extends $Command< GetDataSourceCommandInput, GetDataSourceCommandOutput, @@ -34,6 +40,9 @@ export class GetDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/GetEvaluationCommand.ts b/clients/client-machine-learning/commands/GetEvaluationCommand.ts index 1c5b4f705d2db..a1c76f1295e3b 100644 --- a/clients/client-machine-learning/commands/GetEvaluationCommand.ts +++ b/clients/client-machine-learning/commands/GetEvaluationCommand.ts @@ -20,6 +20,9 @@ import { export type GetEvaluationCommandInput = GetEvaluationInput; export type GetEvaluationCommandOutput = GetEvaluationOutput & __MetadataBearer; +/** + *

Returns an Evaluation that includes metadata as well as the current status of the Evaluation.

+ */ export class GetEvaluationCommand extends $Command< GetEvaluationCommandInput, GetEvaluationCommandOutput, @@ -34,6 +37,9 @@ export class GetEvaluationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/GetMLModelCommand.ts b/clients/client-machine-learning/commands/GetMLModelCommand.ts index b7572a8095302..898a0d628f395 100644 --- a/clients/client-machine-learning/commands/GetMLModelCommand.ts +++ b/clients/client-machine-learning/commands/GetMLModelCommand.ts @@ -20,6 +20,11 @@ import { export type GetMLModelCommandInput = GetMLModelInput; export type GetMLModelCommandOutput = GetMLModelOutput & __MetadataBearer; +/** + *

Returns an MLModel that includes detailed metadata, data source information, and the current status of the MLModel.

+ *

+ * GetMLModel provides results in normal or verbose format.

+ */ export class GetMLModelCommand extends $Command< GetMLModelCommandInput, GetMLModelCommandOutput, @@ -34,6 +39,9 @@ export class GetMLModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/PredictCommand.ts b/clients/client-machine-learning/commands/PredictCommand.ts index 95c65627b0401..b69ee3fa135aa 100644 --- a/clients/client-machine-learning/commands/PredictCommand.ts +++ b/clients/client-machine-learning/commands/PredictCommand.ts @@ -18,6 +18,12 @@ import { export type PredictCommandInput = PredictInput; export type PredictCommandOutput = PredictOutput & __MetadataBearer; +/** + *

Generates a prediction for the observation using the specified ML Model.

+ *

+ * Note: Not all response parameters will be populated. Whether a + * response parameter is populated depends on the type of model requested.

+ */ export class PredictCommand extends $Command< PredictCommandInput, PredictCommandOutput, @@ -32,6 +38,9 @@ export class PredictCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/UpdateBatchPredictionCommand.ts b/clients/client-machine-learning/commands/UpdateBatchPredictionCommand.ts index 5f2c9e3bc2969..b758df5297252 100644 --- a/clients/client-machine-learning/commands/UpdateBatchPredictionCommand.ts +++ b/clients/client-machine-learning/commands/UpdateBatchPredictionCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateBatchPredictionCommandInput = UpdateBatchPredictionInput; export type UpdateBatchPredictionCommandOutput = UpdateBatchPredictionOutput & __MetadataBearer; +/** + *

Updates the BatchPredictionName of a BatchPrediction.

+ *

You can use the GetBatchPrediction operation to view the contents of the updated data element.

+ */ export class UpdateBatchPredictionCommand extends $Command< UpdateBatchPredictionCommandInput, UpdateBatchPredictionCommandOutput, @@ -34,6 +38,9 @@ export class UpdateBatchPredictionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/UpdateDataSourceCommand.ts b/clients/client-machine-learning/commands/UpdateDataSourceCommand.ts index 6297169a07c94..ea43aa3a587f1 100644 --- a/clients/client-machine-learning/commands/UpdateDataSourceCommand.ts +++ b/clients/client-machine-learning/commands/UpdateDataSourceCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDataSourceCommandInput = UpdateDataSourceInput; export type UpdateDataSourceCommandOutput = UpdateDataSourceOutput & __MetadataBearer; +/** + *

Updates the DataSourceName of a DataSource.

+ *

You can use the GetDataSource operation to view the contents of the updated data element.

+ */ export class UpdateDataSourceCommand extends $Command< UpdateDataSourceCommandInput, UpdateDataSourceCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/UpdateEvaluationCommand.ts b/clients/client-machine-learning/commands/UpdateEvaluationCommand.ts index 1aac05eb413c8..6df768d012a46 100644 --- a/clients/client-machine-learning/commands/UpdateEvaluationCommand.ts +++ b/clients/client-machine-learning/commands/UpdateEvaluationCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateEvaluationCommandInput = UpdateEvaluationInput; export type UpdateEvaluationCommandOutput = UpdateEvaluationOutput & __MetadataBearer; +/** + *

Updates the EvaluationName of an Evaluation.

+ *

You can use the GetEvaluation operation to view the contents of the updated data element.

+ */ export class UpdateEvaluationCommand extends $Command< UpdateEvaluationCommandInput, UpdateEvaluationCommandOutput, @@ -34,6 +38,9 @@ export class UpdateEvaluationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/commands/UpdateMLModelCommand.ts b/clients/client-machine-learning/commands/UpdateMLModelCommand.ts index 2f4f4efecb222..3a59931a0576d 100644 --- a/clients/client-machine-learning/commands/UpdateMLModelCommand.ts +++ b/clients/client-machine-learning/commands/UpdateMLModelCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateMLModelCommandInput = UpdateMLModelInput; export type UpdateMLModelCommandOutput = UpdateMLModelOutput & __MetadataBearer; +/** + *

Updates the MLModelName and the ScoreThreshold of an MLModel.

+ *

You can use the GetMLModel operation to view the contents of the updated data element.

+ */ export class UpdateMLModelCommand extends $Command< UpdateMLModelCommandInput, UpdateMLModelCommandOutput, @@ -34,6 +38,9 @@ export class UpdateMLModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MachineLearningClientResolvedConfig, diff --git a/clients/client-machine-learning/package.json b/clients/client-machine-learning/package.json index 1b21eb3dd119c..480f9a7e5b9e8 100644 --- a/clients/client-machine-learning/package.json +++ b/clients/client-machine-learning/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Machine Learning Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-machine-learning/pagination/DescribeBatchPredictionsPaginator.ts b/clients/client-machine-learning/pagination/DescribeBatchPredictionsPaginator.ts index 590de82949b7d..4e1d6655e0358 100644 --- a/clients/client-machine-learning/pagination/DescribeBatchPredictionsPaginator.ts +++ b/clients/client-machine-learning/pagination/DescribeBatchPredictionsPaginator.ts @@ -8,6 +8,9 @@ import { import { MachineLearningPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MachineLearningClient, input: DescribeBatchPredictionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBatchPredictionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MachineLearning, input: DescribeBatchPredictionsCommandInput, diff --git a/clients/client-machine-learning/pagination/DescribeDataSourcesPaginator.ts b/clients/client-machine-learning/pagination/DescribeDataSourcesPaginator.ts index 090c9bf49bf7f..f0fabaa8adbcd 100644 --- a/clients/client-machine-learning/pagination/DescribeDataSourcesPaginator.ts +++ b/clients/client-machine-learning/pagination/DescribeDataSourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { MachineLearningPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MachineLearningClient, input: DescribeDataSourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDataSourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MachineLearning, input: DescribeDataSourcesCommandInput, diff --git a/clients/client-machine-learning/pagination/DescribeEvaluationsPaginator.ts b/clients/client-machine-learning/pagination/DescribeEvaluationsPaginator.ts index dd41e10753510..9caac7aa63af0 100644 --- a/clients/client-machine-learning/pagination/DescribeEvaluationsPaginator.ts +++ b/clients/client-machine-learning/pagination/DescribeEvaluationsPaginator.ts @@ -8,6 +8,9 @@ import { import { MachineLearningPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MachineLearningClient, input: DescribeEvaluationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEvaluationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MachineLearning, input: DescribeEvaluationsCommandInput, diff --git a/clients/client-machine-learning/pagination/DescribeMLModelsPaginator.ts b/clients/client-machine-learning/pagination/DescribeMLModelsPaginator.ts index 4d0364eb0d017..e8a327e60c015 100644 --- a/clients/client-machine-learning/pagination/DescribeMLModelsPaginator.ts +++ b/clients/client-machine-learning/pagination/DescribeMLModelsPaginator.ts @@ -8,6 +8,9 @@ import { import { MachineLearningPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MachineLearningClient, input: DescribeMLModelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMLModelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MachineLearning, input: DescribeMLModelsCommandInput, diff --git a/clients/client-machine-learning/runtimeConfig.browser.ts b/clients/client-machine-learning/runtimeConfig.browser.ts index 4bd88dab5d547..969c6b9aed15c 100644 --- a/clients/client-machine-learning/runtimeConfig.browser.ts +++ b/clients/client-machine-learning/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MachineLearningClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-machine-learning/runtimeConfig.native.ts b/clients/client-machine-learning/runtimeConfig.native.ts index e801f7c1ce23b..6f46fd040c75f 100644 --- a/clients/client-machine-learning/runtimeConfig.native.ts +++ b/clients/client-machine-learning/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MachineLearningClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-machine-learning/runtimeConfig.shared.ts b/clients/client-machine-learning/runtimeConfig.shared.ts index 9438dcc823824..7b99ad1118ab2 100644 --- a/clients/client-machine-learning/runtimeConfig.shared.ts +++ b/clients/client-machine-learning/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-12-12", disableHostPrefix: false, diff --git a/clients/client-machine-learning/runtimeConfig.ts b/clients/client-machine-learning/runtimeConfig.ts index 551681668ae41..04050d943d6c2 100644 --- a/clients/client-machine-learning/runtimeConfig.ts +++ b/clients/client-machine-learning/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MachineLearningClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-machine-learning/tsconfig.json b/clients/client-machine-learning/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-machine-learning/tsconfig.json +++ b/clients/client-machine-learning/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-macie/commands/AssociateMemberAccountCommand.ts b/clients/client-macie/commands/AssociateMemberAccountCommand.ts index e8d06254e18fb..cd1a7da04eaee 100644 --- a/clients/client-macie/commands/AssociateMemberAccountCommand.ts +++ b/clients/client-macie/commands/AssociateMemberAccountCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateMemberAccountCommandInput = AssociateMemberAccountRequest; export type AssociateMemberAccountCommandOutput = __MetadataBearer; +/** + *

Associates a specified AWS account with Amazon Macie Classic as a member + * account.

+ */ export class AssociateMemberAccountCommand extends $Command< AssociateMemberAccountCommandInput, AssociateMemberAccountCommandOutput, @@ -34,6 +38,9 @@ export class AssociateMemberAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MacieClientResolvedConfig, diff --git a/clients/client-macie/commands/AssociateS3ResourcesCommand.ts b/clients/client-macie/commands/AssociateS3ResourcesCommand.ts index 5a601d912734c..8ec36045adb0a 100644 --- a/clients/client-macie/commands/AssociateS3ResourcesCommand.ts +++ b/clients/client-macie/commands/AssociateS3ResourcesCommand.ts @@ -20,6 +20,13 @@ import { export type AssociateS3ResourcesCommandInput = AssociateS3ResourcesRequest; export type AssociateS3ResourcesCommandOutput = AssociateS3ResourcesResult & __MetadataBearer; +/** + *

Associates specified S3 resources with Amazon Macie Classic for monitoring and data + * classification. If memberAccountId isn't specified, the action associates specified S3 + * resources with Macie Classic for the current master account. If memberAccountId is specified, + * the action associates specified S3 resources with Macie Classic for the specified member + * account.

+ */ export class AssociateS3ResourcesCommand extends $Command< AssociateS3ResourcesCommandInput, AssociateS3ResourcesCommandOutput, @@ -34,6 +41,9 @@ export class AssociateS3ResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MacieClientResolvedConfig, diff --git a/clients/client-macie/commands/DisassociateMemberAccountCommand.ts b/clients/client-macie/commands/DisassociateMemberAccountCommand.ts index 14dfec92d72ce..7f553e4e91925 100644 --- a/clients/client-macie/commands/DisassociateMemberAccountCommand.ts +++ b/clients/client-macie/commands/DisassociateMemberAccountCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateMemberAccountCommandInput = DisassociateMemberAccountRequest; export type DisassociateMemberAccountCommandOutput = __MetadataBearer; +/** + *

Removes the specified member account from Amazon Macie Classic.

+ */ export class DisassociateMemberAccountCommand extends $Command< DisassociateMemberAccountCommandInput, DisassociateMemberAccountCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateMemberAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MacieClientResolvedConfig, diff --git a/clients/client-macie/commands/DisassociateS3ResourcesCommand.ts b/clients/client-macie/commands/DisassociateS3ResourcesCommand.ts index bdac22fa8e7cc..b3df6807b321b 100644 --- a/clients/client-macie/commands/DisassociateS3ResourcesCommand.ts +++ b/clients/client-macie/commands/DisassociateS3ResourcesCommand.ts @@ -20,6 +20,12 @@ import { export type DisassociateS3ResourcesCommandInput = DisassociateS3ResourcesRequest; export type DisassociateS3ResourcesCommandOutput = DisassociateS3ResourcesResult & __MetadataBearer; +/** + *

Removes specified S3 resources from being monitored by Amazon Macie Classic. If + * memberAccountId isn't specified, the action removes specified S3 resources from Macie Classic + * for the current master account. If memberAccountId is specified, the action removes specified + * S3 resources from Macie Classic for the specified member account.

+ */ export class DisassociateS3ResourcesCommand extends $Command< DisassociateS3ResourcesCommandInput, DisassociateS3ResourcesCommandOutput, @@ -34,6 +40,9 @@ export class DisassociateS3ResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MacieClientResolvedConfig, diff --git a/clients/client-macie/commands/ListMemberAccountsCommand.ts b/clients/client-macie/commands/ListMemberAccountsCommand.ts index 305528b0ae5f1..6810e5a821242 100644 --- a/clients/client-macie/commands/ListMemberAccountsCommand.ts +++ b/clients/client-macie/commands/ListMemberAccountsCommand.ts @@ -20,6 +20,10 @@ import { export type ListMemberAccountsCommandInput = ListMemberAccountsRequest; export type ListMemberAccountsCommandOutput = ListMemberAccountsResult & __MetadataBearer; +/** + *

Lists all Amazon Macie Classic member accounts for the current Amazon Macie Classic + * master account.

+ */ export class ListMemberAccountsCommand extends $Command< ListMemberAccountsCommandInput, ListMemberAccountsCommandOutput, @@ -34,6 +38,9 @@ export class ListMemberAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MacieClientResolvedConfig, diff --git a/clients/client-macie/commands/ListS3ResourcesCommand.ts b/clients/client-macie/commands/ListS3ResourcesCommand.ts index 0e04e67581656..5cc7e9607d987 100644 --- a/clients/client-macie/commands/ListS3ResourcesCommand.ts +++ b/clients/client-macie/commands/ListS3ResourcesCommand.ts @@ -20,6 +20,12 @@ import { export type ListS3ResourcesCommandInput = ListS3ResourcesRequest; export type ListS3ResourcesCommandOutput = ListS3ResourcesResult & __MetadataBearer; +/** + *

Lists all the S3 resources associated with Amazon Macie Classic. If memberAccountId + * isn't specified, the action lists the S3 resources associated with Amazon Macie Classic for + * the current master account. If memberAccountId is specified, the action lists the S3 resources + * associated with Amazon Macie Classic for the specified member account.

+ */ export class ListS3ResourcesCommand extends $Command< ListS3ResourcesCommandInput, ListS3ResourcesCommandOutput, @@ -34,6 +40,9 @@ export class ListS3ResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MacieClientResolvedConfig, diff --git a/clients/client-macie/commands/UpdateS3ResourcesCommand.ts b/clients/client-macie/commands/UpdateS3ResourcesCommand.ts index 8454c9b3ae99c..97e653e1c2f45 100644 --- a/clients/client-macie/commands/UpdateS3ResourcesCommand.ts +++ b/clients/client-macie/commands/UpdateS3ResourcesCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateS3ResourcesCommandInput = UpdateS3ResourcesRequest; export type UpdateS3ResourcesCommandOutput = UpdateS3ResourcesResult & __MetadataBearer; +/** + *

Updates the classification types for the specified S3 resources. If memberAccountId + * isn't specified, the action updates the classification types of the S3 resources associated + * with Amazon Macie Classic for the current master account. If memberAccountId is specified, the + * action updates the classification types of the S3 resources associated with Amazon Macie + * Classic for the specified member account.

+ */ export class UpdateS3ResourcesCommand extends $Command< UpdateS3ResourcesCommandInput, UpdateS3ResourcesCommandOutput, @@ -34,6 +41,9 @@ export class UpdateS3ResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MacieClientResolvedConfig, diff --git a/clients/client-macie/package.json b/clients/client-macie/package.json index 2a32ecaa36c84..3aaa70df456e5 100644 --- a/clients/client-macie/package.json +++ b/clients/client-macie/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Macie Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-macie/pagination/ListMemberAccountsPaginator.ts b/clients/client-macie/pagination/ListMemberAccountsPaginator.ts index cd0ede4bf0faa..c1faa30f37dbb 100644 --- a/clients/client-macie/pagination/ListMemberAccountsPaginator.ts +++ b/clients/client-macie/pagination/ListMemberAccountsPaginator.ts @@ -8,6 +8,9 @@ import { import { MaciePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MacieClient, input: ListMemberAccountsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMemberAccountsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie, input: ListMemberAccountsCommandInput, diff --git a/clients/client-macie/pagination/ListS3ResourcesPaginator.ts b/clients/client-macie/pagination/ListS3ResourcesPaginator.ts index 37ba452e1e437..7d11f049d8a3f 100644 --- a/clients/client-macie/pagination/ListS3ResourcesPaginator.ts +++ b/clients/client-macie/pagination/ListS3ResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { MaciePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MacieClient, input: ListS3ResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListS3ResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie, input: ListS3ResourcesCommandInput, diff --git a/clients/client-macie/runtimeConfig.browser.ts b/clients/client-macie/runtimeConfig.browser.ts index c2407ddd85d6f..4626efad63dc7 100644 --- a/clients/client-macie/runtimeConfig.browser.ts +++ b/clients/client-macie/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MacieClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-macie/runtimeConfig.native.ts b/clients/client-macie/runtimeConfig.native.ts index bad46b05f8f62..7177195219a5e 100644 --- a/clients/client-macie/runtimeConfig.native.ts +++ b/clients/client-macie/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MacieClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-macie/runtimeConfig.shared.ts b/clients/client-macie/runtimeConfig.shared.ts index 635e02e053775..3313835e98d9b 100644 --- a/clients/client-macie/runtimeConfig.shared.ts +++ b/clients/client-macie/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-12-19", disableHostPrefix: false, diff --git a/clients/client-macie/runtimeConfig.ts b/clients/client-macie/runtimeConfig.ts index 084f9b9130855..54ae38186ed7b 100644 --- a/clients/client-macie/runtimeConfig.ts +++ b/clients/client-macie/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MacieClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-macie/tsconfig.json b/clients/client-macie/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-macie/tsconfig.json +++ b/clients/client-macie/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-macie2/commands/AcceptInvitationCommand.ts b/clients/client-macie2/commands/AcceptInvitationCommand.ts index 03d13a262bffc..92062208fb351 100644 --- a/clients/client-macie2/commands/AcceptInvitationCommand.ts +++ b/clients/client-macie2/commands/AcceptInvitationCommand.ts @@ -20,6 +20,9 @@ import { export type AcceptInvitationCommandInput = AcceptInvitationRequest; export type AcceptInvitationCommandOutput = AcceptInvitationResponse & __MetadataBearer; +/** + *

Accepts an Amazon Macie membership invitation that was received from a specific account.

+ */ export class AcceptInvitationCommand extends $Command< AcceptInvitationCommandInput, AcceptInvitationCommandOutput, @@ -34,6 +37,9 @@ export class AcceptInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/BatchGetCustomDataIdentifiersCommand.ts b/clients/client-macie2/commands/BatchGetCustomDataIdentifiersCommand.ts index fe4f47b035674..10a11452fcaf3 100644 --- a/clients/client-macie2/commands/BatchGetCustomDataIdentifiersCommand.ts +++ b/clients/client-macie2/commands/BatchGetCustomDataIdentifiersCommand.ts @@ -20,6 +20,9 @@ import { export type BatchGetCustomDataIdentifiersCommandInput = BatchGetCustomDataIdentifiersRequest; export type BatchGetCustomDataIdentifiersCommandOutput = BatchGetCustomDataIdentifiersResponse & __MetadataBearer; +/** + *

Retrieves information about one or more custom data identifiers.

+ */ export class BatchGetCustomDataIdentifiersCommand extends $Command< BatchGetCustomDataIdentifiersCommandInput, BatchGetCustomDataIdentifiersCommandOutput, @@ -34,6 +37,9 @@ export class BatchGetCustomDataIdentifiersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/CreateClassificationJobCommand.ts b/clients/client-macie2/commands/CreateClassificationJobCommand.ts index e238a2db72983..a4c63a782afbe 100644 --- a/clients/client-macie2/commands/CreateClassificationJobCommand.ts +++ b/clients/client-macie2/commands/CreateClassificationJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateClassificationJobCommandInput = CreateClassificationJobRequest; export type CreateClassificationJobCommandOutput = CreateClassificationJobResponse & __MetadataBearer; +/** + *

Creates and defines the settings for a classification job.

+ */ export class CreateClassificationJobCommand extends $Command< CreateClassificationJobCommandInput, CreateClassificationJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateClassificationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/CreateCustomDataIdentifierCommand.ts b/clients/client-macie2/commands/CreateCustomDataIdentifierCommand.ts index 3110a50f0fa64..ee7fa1aadcbd2 100644 --- a/clients/client-macie2/commands/CreateCustomDataIdentifierCommand.ts +++ b/clients/client-macie2/commands/CreateCustomDataIdentifierCommand.ts @@ -20,6 +20,9 @@ import { export type CreateCustomDataIdentifierCommandInput = CreateCustomDataIdentifierRequest; export type CreateCustomDataIdentifierCommandOutput = CreateCustomDataIdentifierResponse & __MetadataBearer; +/** + *

Creates and defines the criteria and other settings for a custom data identifier.

+ */ export class CreateCustomDataIdentifierCommand extends $Command< CreateCustomDataIdentifierCommandInput, CreateCustomDataIdentifierCommandOutput, @@ -34,6 +37,9 @@ export class CreateCustomDataIdentifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/CreateFindingsFilterCommand.ts b/clients/client-macie2/commands/CreateFindingsFilterCommand.ts index 4cd1ff3a890c8..c05df333deeec 100644 --- a/clients/client-macie2/commands/CreateFindingsFilterCommand.ts +++ b/clients/client-macie2/commands/CreateFindingsFilterCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFindingsFilterCommandInput = CreateFindingsFilterRequest; export type CreateFindingsFilterCommandOutput = CreateFindingsFilterResponse & __MetadataBearer; +/** + *

Creates and defines the criteria and other settings for a findings filter.

+ */ export class CreateFindingsFilterCommand extends $Command< CreateFindingsFilterCommandInput, CreateFindingsFilterCommandOutput, @@ -34,6 +37,9 @@ export class CreateFindingsFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/CreateInvitationsCommand.ts b/clients/client-macie2/commands/CreateInvitationsCommand.ts index a8762acbda167..320444872ef21 100644 --- a/clients/client-macie2/commands/CreateInvitationsCommand.ts +++ b/clients/client-macie2/commands/CreateInvitationsCommand.ts @@ -20,6 +20,9 @@ import { export type CreateInvitationsCommandInput = CreateInvitationsRequest; export type CreateInvitationsCommandOutput = CreateInvitationsResponse & __MetadataBearer; +/** + *

Sends an Amazon Macie membership invitation to one or more accounts.

+ */ export class CreateInvitationsCommand extends $Command< CreateInvitationsCommandInput, CreateInvitationsCommandOutput, @@ -34,6 +37,9 @@ export class CreateInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/CreateMemberCommand.ts b/clients/client-macie2/commands/CreateMemberCommand.ts index 3c0c3a6b5a7e9..24aafac94864c 100644 --- a/clients/client-macie2/commands/CreateMemberCommand.ts +++ b/clients/client-macie2/commands/CreateMemberCommand.ts @@ -20,6 +20,9 @@ import { export type CreateMemberCommandInput = CreateMemberRequest; export type CreateMemberCommandOutput = CreateMemberResponse & __MetadataBearer; +/** + *

Associates an account with an Amazon Macie master account.

+ */ export class CreateMemberCommand extends $Command< CreateMemberCommandInput, CreateMemberCommandOutput, @@ -34,6 +37,9 @@ export class CreateMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/CreateSampleFindingsCommand.ts b/clients/client-macie2/commands/CreateSampleFindingsCommand.ts index a87e73ee8c61a..f3ac51986d776 100644 --- a/clients/client-macie2/commands/CreateSampleFindingsCommand.ts +++ b/clients/client-macie2/commands/CreateSampleFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSampleFindingsCommandInput = CreateSampleFindingsRequest; export type CreateSampleFindingsCommandOutput = CreateSampleFindingsResponse & __MetadataBearer; +/** + *

Creates sample findings.

+ */ export class CreateSampleFindingsCommand extends $Command< CreateSampleFindingsCommandInput, CreateSampleFindingsCommandOutput, @@ -34,6 +37,9 @@ export class CreateSampleFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DeclineInvitationsCommand.ts b/clients/client-macie2/commands/DeclineInvitationsCommand.ts index 5730c704b98d3..d344c8f463213 100644 --- a/clients/client-macie2/commands/DeclineInvitationsCommand.ts +++ b/clients/client-macie2/commands/DeclineInvitationsCommand.ts @@ -20,6 +20,9 @@ import { export type DeclineInvitationsCommandInput = DeclineInvitationsRequest; export type DeclineInvitationsCommandOutput = DeclineInvitationsResponse & __MetadataBearer; +/** + *

Declines Amazon Macie membership invitations that were received from specific accounts.

+ */ export class DeclineInvitationsCommand extends $Command< DeclineInvitationsCommandInput, DeclineInvitationsCommandOutput, @@ -34,6 +37,9 @@ export class DeclineInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DeleteCustomDataIdentifierCommand.ts b/clients/client-macie2/commands/DeleteCustomDataIdentifierCommand.ts index 893beeff57dc9..7f1cc9d37946b 100644 --- a/clients/client-macie2/commands/DeleteCustomDataIdentifierCommand.ts +++ b/clients/client-macie2/commands/DeleteCustomDataIdentifierCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCustomDataIdentifierCommandInput = DeleteCustomDataIdentifierRequest; export type DeleteCustomDataIdentifierCommandOutput = DeleteCustomDataIdentifierResponse & __MetadataBearer; +/** + *

Soft deletes a custom data identifier.

+ */ export class DeleteCustomDataIdentifierCommand extends $Command< DeleteCustomDataIdentifierCommandInput, DeleteCustomDataIdentifierCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCustomDataIdentifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DeleteFindingsFilterCommand.ts b/clients/client-macie2/commands/DeleteFindingsFilterCommand.ts index f2853cd2cdcfb..a729a4d62d92e 100644 --- a/clients/client-macie2/commands/DeleteFindingsFilterCommand.ts +++ b/clients/client-macie2/commands/DeleteFindingsFilterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFindingsFilterCommandInput = DeleteFindingsFilterRequest; export type DeleteFindingsFilterCommandOutput = DeleteFindingsFilterResponse & __MetadataBearer; +/** + *

Deletes a findings filter.

+ */ export class DeleteFindingsFilterCommand extends $Command< DeleteFindingsFilterCommandInput, DeleteFindingsFilterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFindingsFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DeleteInvitationsCommand.ts b/clients/client-macie2/commands/DeleteInvitationsCommand.ts index 298b5bb37a1c2..25d3fd0790315 100644 --- a/clients/client-macie2/commands/DeleteInvitationsCommand.ts +++ b/clients/client-macie2/commands/DeleteInvitationsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteInvitationsCommandInput = DeleteInvitationsRequest; export type DeleteInvitationsCommandOutput = DeleteInvitationsResponse & __MetadataBearer; +/** + *

Deletes Amazon Macie membership invitations that were received from specific accounts.

+ */ export class DeleteInvitationsCommand extends $Command< DeleteInvitationsCommandInput, DeleteInvitationsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DeleteMemberCommand.ts b/clients/client-macie2/commands/DeleteMemberCommand.ts index 672f1945d13dc..95cf8efe0dfda 100644 --- a/clients/client-macie2/commands/DeleteMemberCommand.ts +++ b/clients/client-macie2/commands/DeleteMemberCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMemberCommandInput = DeleteMemberRequest; export type DeleteMemberCommandOutput = DeleteMemberResponse & __MetadataBearer; +/** + *

Deletes the association between an Amazon Macie master account and an account.

+ */ export class DeleteMemberCommand extends $Command< DeleteMemberCommandInput, DeleteMemberCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DescribeBucketsCommand.ts b/clients/client-macie2/commands/DescribeBucketsCommand.ts index 3eee5322a4e9c..015ad97885c55 100644 --- a/clients/client-macie2/commands/DescribeBucketsCommand.ts +++ b/clients/client-macie2/commands/DescribeBucketsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBucketsCommandInput = DescribeBucketsRequest; export type DescribeBucketsCommandOutput = DescribeBucketsResponse & __MetadataBearer; +/** + *

Retrieves (queries) statistical data and other information about one or more S3 buckets that Amazon Macie monitors and analyzes.

+ */ export class DescribeBucketsCommand extends $Command< DescribeBucketsCommandInput, DescribeBucketsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBucketsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DescribeClassificationJobCommand.ts b/clients/client-macie2/commands/DescribeClassificationJobCommand.ts index 0f5bcf43fd1f0..d84841c51e7e7 100644 --- a/clients/client-macie2/commands/DescribeClassificationJobCommand.ts +++ b/clients/client-macie2/commands/DescribeClassificationJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClassificationJobCommandInput = DescribeClassificationJobRequest; export type DescribeClassificationJobCommandOutput = DescribeClassificationJobResponse & __MetadataBearer; +/** + *

Retrieves the status and settings for a classification job.

+ */ export class DescribeClassificationJobCommand extends $Command< DescribeClassificationJobCommandInput, DescribeClassificationJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClassificationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DescribeOrganizationConfigurationCommand.ts b/clients/client-macie2/commands/DescribeOrganizationConfigurationCommand.ts index aaedba551fb5d..16976c48e1bfb 100644 --- a/clients/client-macie2/commands/DescribeOrganizationConfigurationCommand.ts +++ b/clients/client-macie2/commands/DescribeOrganizationConfigurationCommand.ts @@ -24,6 +24,9 @@ export type DescribeOrganizationConfigurationCommandInput = DescribeOrganization export type DescribeOrganizationConfigurationCommandOutput = DescribeOrganizationConfigurationResponse & __MetadataBearer; +/** + *

Retrieves the Amazon Macie configuration settings for an AWS organization.

+ */ export class DescribeOrganizationConfigurationCommand extends $Command< DescribeOrganizationConfigurationCommandInput, DescribeOrganizationConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class DescribeOrganizationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DisableMacieCommand.ts b/clients/client-macie2/commands/DisableMacieCommand.ts index ea62b3cfc3136..cb2f0cd08b98a 100644 --- a/clients/client-macie2/commands/DisableMacieCommand.ts +++ b/clients/client-macie2/commands/DisableMacieCommand.ts @@ -20,6 +20,9 @@ import { export type DisableMacieCommandInput = DisableMacieRequest; export type DisableMacieCommandOutput = DisableMacieResponse & __MetadataBearer; +/** + *

Disables an Amazon Macie account and deletes Macie resources for the account.

+ */ export class DisableMacieCommand extends $Command< DisableMacieCommandInput, DisableMacieCommandOutput, @@ -34,6 +37,9 @@ export class DisableMacieCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DisableOrganizationAdminAccountCommand.ts b/clients/client-macie2/commands/DisableOrganizationAdminAccountCommand.ts index a16d2d6716479..360b3e83a5a22 100644 --- a/clients/client-macie2/commands/DisableOrganizationAdminAccountCommand.ts +++ b/clients/client-macie2/commands/DisableOrganizationAdminAccountCommand.ts @@ -20,6 +20,9 @@ import { export type DisableOrganizationAdminAccountCommandInput = DisableOrganizationAdminAccountRequest; export type DisableOrganizationAdminAccountCommandOutput = DisableOrganizationAdminAccountResponse & __MetadataBearer; +/** + *

Disables an account as the delegated Amazon Macie administrator account for an AWS organization.

+ */ export class DisableOrganizationAdminAccountCommand extends $Command< DisableOrganizationAdminAccountCommandInput, DisableOrganizationAdminAccountCommandOutput, @@ -34,6 +37,9 @@ export class DisableOrganizationAdminAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DisassociateFromMasterAccountCommand.ts b/clients/client-macie2/commands/DisassociateFromMasterAccountCommand.ts index 4fda76e0d8f6a..185c974cb44c9 100644 --- a/clients/client-macie2/commands/DisassociateFromMasterAccountCommand.ts +++ b/clients/client-macie2/commands/DisassociateFromMasterAccountCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateFromMasterAccountCommandInput = DisassociateFromMasterAccountRequest; export type DisassociateFromMasterAccountCommandOutput = DisassociateFromMasterAccountResponse & __MetadataBearer; +/** + *

Disassociates a member account from its Amazon Macie master account.

+ */ export class DisassociateFromMasterAccountCommand extends $Command< DisassociateFromMasterAccountCommandInput, DisassociateFromMasterAccountCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateFromMasterAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/DisassociateMemberCommand.ts b/clients/client-macie2/commands/DisassociateMemberCommand.ts index b644dcb4c99b9..e772b7584bbd9 100644 --- a/clients/client-macie2/commands/DisassociateMemberCommand.ts +++ b/clients/client-macie2/commands/DisassociateMemberCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateMemberCommandInput = DisassociateMemberRequest; export type DisassociateMemberCommandOutput = DisassociateMemberResponse & __MetadataBearer; +/** + *

Disassociates an Amazon Macie master account from a member account.

+ */ export class DisassociateMemberCommand extends $Command< DisassociateMemberCommandInput, DisassociateMemberCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/EnableMacieCommand.ts b/clients/client-macie2/commands/EnableMacieCommand.ts index 160b0ba009247..c985ecd16fa69 100644 --- a/clients/client-macie2/commands/EnableMacieCommand.ts +++ b/clients/client-macie2/commands/EnableMacieCommand.ts @@ -20,6 +20,9 @@ import { export type EnableMacieCommandInput = EnableMacieRequest; export type EnableMacieCommandOutput = EnableMacieResponse & __MetadataBearer; +/** + *

Enables Amazon Macie and specifies the configuration settings for a Macie account.

+ */ export class EnableMacieCommand extends $Command< EnableMacieCommandInput, EnableMacieCommandOutput, @@ -34,6 +37,9 @@ export class EnableMacieCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/EnableOrganizationAdminAccountCommand.ts b/clients/client-macie2/commands/EnableOrganizationAdminAccountCommand.ts index 6fe6c0f0ebd5f..0a2517eed3a18 100644 --- a/clients/client-macie2/commands/EnableOrganizationAdminAccountCommand.ts +++ b/clients/client-macie2/commands/EnableOrganizationAdminAccountCommand.ts @@ -20,6 +20,9 @@ import { export type EnableOrganizationAdminAccountCommandInput = EnableOrganizationAdminAccountRequest; export type EnableOrganizationAdminAccountCommandOutput = EnableOrganizationAdminAccountResponse & __MetadataBearer; +/** + *

Designates an account as the delegated Amazon Macie administrator account for an AWS organization.

+ */ export class EnableOrganizationAdminAccountCommand extends $Command< EnableOrganizationAdminAccountCommandInput, EnableOrganizationAdminAccountCommandOutput, @@ -34,6 +37,9 @@ export class EnableOrganizationAdminAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetBucketStatisticsCommand.ts b/clients/client-macie2/commands/GetBucketStatisticsCommand.ts index e959fad1c0daa..8bd510c223caa 100644 --- a/clients/client-macie2/commands/GetBucketStatisticsCommand.ts +++ b/clients/client-macie2/commands/GetBucketStatisticsCommand.ts @@ -20,6 +20,9 @@ import { export type GetBucketStatisticsCommandInput = GetBucketStatisticsRequest; export type GetBucketStatisticsCommandOutput = GetBucketStatisticsResponse & __MetadataBearer; +/** + *

Retrieves (queries) aggregated statistical data for all the S3 buckets that Amazon Macie monitors and analyzes.

+ */ export class GetBucketStatisticsCommand extends $Command< GetBucketStatisticsCommandInput, GetBucketStatisticsCommandOutput, @@ -34,6 +37,9 @@ export class GetBucketStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetClassificationExportConfigurationCommand.ts b/clients/client-macie2/commands/GetClassificationExportConfigurationCommand.ts index c25c756eea7f6..28502cf81b234 100644 --- a/clients/client-macie2/commands/GetClassificationExportConfigurationCommand.ts +++ b/clients/client-macie2/commands/GetClassificationExportConfigurationCommand.ts @@ -24,6 +24,9 @@ export type GetClassificationExportConfigurationCommandInput = GetClassification export type GetClassificationExportConfigurationCommandOutput = GetClassificationExportConfigurationResponse & __MetadataBearer; +/** + *

Retrieves the configuration settings for storing data classification results.

+ */ export class GetClassificationExportConfigurationCommand extends $Command< GetClassificationExportConfigurationCommandInput, GetClassificationExportConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class GetClassificationExportConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetCustomDataIdentifierCommand.ts b/clients/client-macie2/commands/GetCustomDataIdentifierCommand.ts index 88482fd111713..2ee5b2362255c 100644 --- a/clients/client-macie2/commands/GetCustomDataIdentifierCommand.ts +++ b/clients/client-macie2/commands/GetCustomDataIdentifierCommand.ts @@ -20,6 +20,9 @@ import { export type GetCustomDataIdentifierCommandInput = GetCustomDataIdentifierRequest; export type GetCustomDataIdentifierCommandOutput = GetCustomDataIdentifierResponse & __MetadataBearer; +/** + *

Retrieves the criteria and other settings for a custom data identifier.

+ */ export class GetCustomDataIdentifierCommand extends $Command< GetCustomDataIdentifierCommandInput, GetCustomDataIdentifierCommandOutput, @@ -34,6 +37,9 @@ export class GetCustomDataIdentifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetFindingStatisticsCommand.ts b/clients/client-macie2/commands/GetFindingStatisticsCommand.ts index 4c6c035365726..c91e9eeddb53c 100644 --- a/clients/client-macie2/commands/GetFindingStatisticsCommand.ts +++ b/clients/client-macie2/commands/GetFindingStatisticsCommand.ts @@ -20,6 +20,9 @@ import { export type GetFindingStatisticsCommandInput = GetFindingStatisticsRequest; export type GetFindingStatisticsCommandOutput = GetFindingStatisticsResponse & __MetadataBearer; +/** + *

Retrieves (queries) aggregated statistical data about findings.

+ */ export class GetFindingStatisticsCommand extends $Command< GetFindingStatisticsCommandInput, GetFindingStatisticsCommandOutput, @@ -34,6 +37,9 @@ export class GetFindingStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetFindingsCommand.ts b/clients/client-macie2/commands/GetFindingsCommand.ts index 1b6d9d4d5c0e6..718c2fa6a7411 100644 --- a/clients/client-macie2/commands/GetFindingsCommand.ts +++ b/clients/client-macie2/commands/GetFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetFindingsCommandInput = GetFindingsRequest; export type GetFindingsCommandOutput = GetFindingsResponse & __MetadataBearer; +/** + *

Retrieves the details of one or more findings.

+ */ export class GetFindingsCommand extends $Command< GetFindingsCommandInput, GetFindingsCommandOutput, @@ -34,6 +37,9 @@ export class GetFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetFindingsFilterCommand.ts b/clients/client-macie2/commands/GetFindingsFilterCommand.ts index 30d1530344572..0541a74f51c44 100644 --- a/clients/client-macie2/commands/GetFindingsFilterCommand.ts +++ b/clients/client-macie2/commands/GetFindingsFilterCommand.ts @@ -20,6 +20,9 @@ import { export type GetFindingsFilterCommandInput = GetFindingsFilterRequest; export type GetFindingsFilterCommandOutput = GetFindingsFilterResponse & __MetadataBearer; +/** + *

Retrieves the criteria and other settings for a findings filter.

+ */ export class GetFindingsFilterCommand extends $Command< GetFindingsFilterCommandInput, GetFindingsFilterCommandOutput, @@ -34,6 +37,9 @@ export class GetFindingsFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetInvitationsCountCommand.ts b/clients/client-macie2/commands/GetInvitationsCountCommand.ts index 87a04b86ec04b..cbc89097559ee 100644 --- a/clients/client-macie2/commands/GetInvitationsCountCommand.ts +++ b/clients/client-macie2/commands/GetInvitationsCountCommand.ts @@ -20,6 +20,9 @@ import { export type GetInvitationsCountCommandInput = GetInvitationsCountRequest; export type GetInvitationsCountCommandOutput = GetInvitationsCountResponse & __MetadataBearer; +/** + *

Retrieves the count of Amazon Macie membership invitations that were received by an account.

+ */ export class GetInvitationsCountCommand extends $Command< GetInvitationsCountCommandInput, GetInvitationsCountCommandOutput, @@ -34,6 +37,9 @@ export class GetInvitationsCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetMacieSessionCommand.ts b/clients/client-macie2/commands/GetMacieSessionCommand.ts index 96db363143ce6..fcb633503a4a7 100644 --- a/clients/client-macie2/commands/GetMacieSessionCommand.ts +++ b/clients/client-macie2/commands/GetMacieSessionCommand.ts @@ -20,6 +20,9 @@ import { export type GetMacieSessionCommandInput = GetMacieSessionRequest; export type GetMacieSessionCommandOutput = GetMacieSessionResponse & __MetadataBearer; +/** + *

Retrieves the current status and configuration settings for an Amazon Macie account.

+ */ export class GetMacieSessionCommand extends $Command< GetMacieSessionCommandInput, GetMacieSessionCommandOutput, @@ -34,6 +37,9 @@ export class GetMacieSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetMasterAccountCommand.ts b/clients/client-macie2/commands/GetMasterAccountCommand.ts index e09d89b935efa..ca8d30546606f 100644 --- a/clients/client-macie2/commands/GetMasterAccountCommand.ts +++ b/clients/client-macie2/commands/GetMasterAccountCommand.ts @@ -20,6 +20,9 @@ import { export type GetMasterAccountCommandInput = GetMasterAccountRequest; export type GetMasterAccountCommandOutput = GetMasterAccountResponse & __MetadataBearer; +/** + *

Retrieves information about the Amazon Macie master account for an account.

+ */ export class GetMasterAccountCommand extends $Command< GetMasterAccountCommandInput, GetMasterAccountCommandOutput, @@ -34,6 +37,9 @@ export class GetMasterAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetMemberCommand.ts b/clients/client-macie2/commands/GetMemberCommand.ts index 883fe509a969f..d771be25f9c05 100644 --- a/clients/client-macie2/commands/GetMemberCommand.ts +++ b/clients/client-macie2/commands/GetMemberCommand.ts @@ -20,6 +20,9 @@ import { export type GetMemberCommandInput = GetMemberRequest; export type GetMemberCommandOutput = GetMemberResponse & __MetadataBearer; +/** + *

Retrieves information about a member account that's associated with an Amazon Macie master account.

+ */ export class GetMemberCommand extends $Command< GetMemberCommandInput, GetMemberCommandOutput, @@ -34,6 +37,9 @@ export class GetMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetUsageStatisticsCommand.ts b/clients/client-macie2/commands/GetUsageStatisticsCommand.ts index 5f7ef9b5aca7e..01bbb2f726d9d 100644 --- a/clients/client-macie2/commands/GetUsageStatisticsCommand.ts +++ b/clients/client-macie2/commands/GetUsageStatisticsCommand.ts @@ -20,6 +20,9 @@ import { export type GetUsageStatisticsCommandInput = GetUsageStatisticsRequest; export type GetUsageStatisticsCommandOutput = GetUsageStatisticsResponse & __MetadataBearer; +/** + *

Retrieves (queries) quotas and aggregated usage data for one or more accounts.

+ */ export class GetUsageStatisticsCommand extends $Command< GetUsageStatisticsCommandInput, GetUsageStatisticsCommandOutput, @@ -34,6 +37,9 @@ export class GetUsageStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/GetUsageTotalsCommand.ts b/clients/client-macie2/commands/GetUsageTotalsCommand.ts index 7edf872c770ac..494469e898512 100644 --- a/clients/client-macie2/commands/GetUsageTotalsCommand.ts +++ b/clients/client-macie2/commands/GetUsageTotalsCommand.ts @@ -20,6 +20,9 @@ import { export type GetUsageTotalsCommandInput = GetUsageTotalsRequest; export type GetUsageTotalsCommandOutput = GetUsageTotalsResponse & __MetadataBearer; +/** + *

Retrieves (queries) aggregated usage data for an account.

+ */ export class GetUsageTotalsCommand extends $Command< GetUsageTotalsCommandInput, GetUsageTotalsCommandOutput, @@ -34,6 +37,9 @@ export class GetUsageTotalsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/ListClassificationJobsCommand.ts b/clients/client-macie2/commands/ListClassificationJobsCommand.ts index 0e51749b4b9a3..09e075d278ad4 100644 --- a/clients/client-macie2/commands/ListClassificationJobsCommand.ts +++ b/clients/client-macie2/commands/ListClassificationJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListClassificationJobsCommandInput = ListClassificationJobsRequest; export type ListClassificationJobsCommandOutput = ListClassificationJobsResponse & __MetadataBearer; +/** + *

Retrieves a subset of information about one or more classification jobs.

+ */ export class ListClassificationJobsCommand extends $Command< ListClassificationJobsCommandInput, ListClassificationJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListClassificationJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/ListCustomDataIdentifiersCommand.ts b/clients/client-macie2/commands/ListCustomDataIdentifiersCommand.ts index ef42c52aa9493..11115cb28e4be 100644 --- a/clients/client-macie2/commands/ListCustomDataIdentifiersCommand.ts +++ b/clients/client-macie2/commands/ListCustomDataIdentifiersCommand.ts @@ -20,6 +20,9 @@ import { export type ListCustomDataIdentifiersCommandInput = ListCustomDataIdentifiersRequest; export type ListCustomDataIdentifiersCommandOutput = ListCustomDataIdentifiersResponse & __MetadataBearer; +/** + *

Retrieves a subset of information about all the custom data identifiers for an account.

+ */ export class ListCustomDataIdentifiersCommand extends $Command< ListCustomDataIdentifiersCommandInput, ListCustomDataIdentifiersCommandOutput, @@ -34,6 +37,9 @@ export class ListCustomDataIdentifiersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/ListFindingsCommand.ts b/clients/client-macie2/commands/ListFindingsCommand.ts index caa3b793a6735..5884adcbed8c6 100644 --- a/clients/client-macie2/commands/ListFindingsCommand.ts +++ b/clients/client-macie2/commands/ListFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFindingsCommandInput = ListFindingsRequest; export type ListFindingsCommandOutput = ListFindingsResponse & __MetadataBearer; +/** + *

Retrieves a subset of information about one or more findings.

+ */ export class ListFindingsCommand extends $Command< ListFindingsCommandInput, ListFindingsCommandOutput, @@ -34,6 +37,9 @@ export class ListFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/ListFindingsFiltersCommand.ts b/clients/client-macie2/commands/ListFindingsFiltersCommand.ts index df759ee12fd87..48ae6fa6990a2 100644 --- a/clients/client-macie2/commands/ListFindingsFiltersCommand.ts +++ b/clients/client-macie2/commands/ListFindingsFiltersCommand.ts @@ -20,6 +20,9 @@ import { export type ListFindingsFiltersCommandInput = ListFindingsFiltersRequest; export type ListFindingsFiltersCommandOutput = ListFindingsFiltersResponse & __MetadataBearer; +/** + *

Retrieves a subset of information about all the findings filters for an account.

+ */ export class ListFindingsFiltersCommand extends $Command< ListFindingsFiltersCommandInput, ListFindingsFiltersCommandOutput, @@ -34,6 +37,9 @@ export class ListFindingsFiltersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/ListInvitationsCommand.ts b/clients/client-macie2/commands/ListInvitationsCommand.ts index 6a3da306f57f0..6d4280f9f476d 100644 --- a/clients/client-macie2/commands/ListInvitationsCommand.ts +++ b/clients/client-macie2/commands/ListInvitationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListInvitationsCommandInput = ListInvitationsRequest; export type ListInvitationsCommandOutput = ListInvitationsResponse & __MetadataBearer; +/** + *

Retrieves information about all the Amazon Macie membership invitations that were received by an account.

+ */ export class ListInvitationsCommand extends $Command< ListInvitationsCommandInput, ListInvitationsCommandOutput, @@ -34,6 +37,9 @@ export class ListInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/ListMembersCommand.ts b/clients/client-macie2/commands/ListMembersCommand.ts index 40e1ce0076391..f17297f02f5be 100644 --- a/clients/client-macie2/commands/ListMembersCommand.ts +++ b/clients/client-macie2/commands/ListMembersCommand.ts @@ -20,6 +20,9 @@ import { export type ListMembersCommandInput = ListMembersRequest; export type ListMembersCommandOutput = ListMembersResponse & __MetadataBearer; +/** + *

Retrieves information about the accounts that are associated with an Amazon Macie master account.

+ */ export class ListMembersCommand extends $Command< ListMembersCommandInput, ListMembersCommandOutput, @@ -34,6 +37,9 @@ export class ListMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/ListOrganizationAdminAccountsCommand.ts b/clients/client-macie2/commands/ListOrganizationAdminAccountsCommand.ts index 13fb5107c7f30..ab5d3910d9869 100644 --- a/clients/client-macie2/commands/ListOrganizationAdminAccountsCommand.ts +++ b/clients/client-macie2/commands/ListOrganizationAdminAccountsCommand.ts @@ -20,6 +20,9 @@ import { export type ListOrganizationAdminAccountsCommandInput = ListOrganizationAdminAccountsRequest; export type ListOrganizationAdminAccountsCommandOutput = ListOrganizationAdminAccountsResponse & __MetadataBearer; +/** + *

Retrieves information about the delegated Amazon Macie administrator account for an AWS organization.

+ */ export class ListOrganizationAdminAccountsCommand extends $Command< ListOrganizationAdminAccountsCommandInput, ListOrganizationAdminAccountsCommandOutput, @@ -34,6 +37,9 @@ export class ListOrganizationAdminAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/ListTagsForResourceCommand.ts b/clients/client-macie2/commands/ListTagsForResourceCommand.ts index cb170ebb93432..2c37da743cbf6 100644 --- a/clients/client-macie2/commands/ListTagsForResourceCommand.ts +++ b/clients/client-macie2/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves the tags (keys and values) that are associated with a classification job, custom data identifier, findings filter, or member account.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/PutClassificationExportConfigurationCommand.ts b/clients/client-macie2/commands/PutClassificationExportConfigurationCommand.ts index 309b612db50b2..0f828d445531a 100644 --- a/clients/client-macie2/commands/PutClassificationExportConfigurationCommand.ts +++ b/clients/client-macie2/commands/PutClassificationExportConfigurationCommand.ts @@ -24,6 +24,9 @@ export type PutClassificationExportConfigurationCommandInput = PutClassification export type PutClassificationExportConfigurationCommandOutput = PutClassificationExportConfigurationResponse & __MetadataBearer; +/** + *

Creates or updates the configuration settings for storing data classification results.

+ */ export class PutClassificationExportConfigurationCommand extends $Command< PutClassificationExportConfigurationCommandInput, PutClassificationExportConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class PutClassificationExportConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/TagResourceCommand.ts b/clients/client-macie2/commands/TagResourceCommand.ts index fb0342f34c4d6..bef350691a3a7 100644 --- a/clients/client-macie2/commands/TagResourceCommand.ts +++ b/clients/client-macie2/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds or updates one or more tags (keys and values) that are associated with a classification job, custom data identifier, findings filter, or member account.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/TestCustomDataIdentifierCommand.ts b/clients/client-macie2/commands/TestCustomDataIdentifierCommand.ts index e0d6d2f8db3d5..e9dc851afd4ae 100644 --- a/clients/client-macie2/commands/TestCustomDataIdentifierCommand.ts +++ b/clients/client-macie2/commands/TestCustomDataIdentifierCommand.ts @@ -20,6 +20,9 @@ import { export type TestCustomDataIdentifierCommandInput = TestCustomDataIdentifierRequest; export type TestCustomDataIdentifierCommandOutput = TestCustomDataIdentifierResponse & __MetadataBearer; +/** + *

Tests a custom data identifier.

+ */ export class TestCustomDataIdentifierCommand extends $Command< TestCustomDataIdentifierCommandInput, TestCustomDataIdentifierCommandOutput, @@ -34,6 +37,9 @@ export class TestCustomDataIdentifierCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/UntagResourceCommand.ts b/clients/client-macie2/commands/UntagResourceCommand.ts index f3d6d3774fbea..caf0516d45302 100644 --- a/clients/client-macie2/commands/UntagResourceCommand.ts +++ b/clients/client-macie2/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags (keys and values) from a classification job, custom data identifier, findings filter, or member account.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/UpdateClassificationJobCommand.ts b/clients/client-macie2/commands/UpdateClassificationJobCommand.ts index 8a7f501eb4e4b..b569dedf0d6b4 100644 --- a/clients/client-macie2/commands/UpdateClassificationJobCommand.ts +++ b/clients/client-macie2/commands/UpdateClassificationJobCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateClassificationJobCommandInput = UpdateClassificationJobRequest; export type UpdateClassificationJobCommandOutput = UpdateClassificationJobResponse & __MetadataBearer; +/** + *

Changes the status of a classification job.

+ */ export class UpdateClassificationJobCommand extends $Command< UpdateClassificationJobCommandInput, UpdateClassificationJobCommandOutput, @@ -34,6 +37,9 @@ export class UpdateClassificationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/UpdateFindingsFilterCommand.ts b/clients/client-macie2/commands/UpdateFindingsFilterCommand.ts index 0672769e1868e..87f586ffed54e 100644 --- a/clients/client-macie2/commands/UpdateFindingsFilterCommand.ts +++ b/clients/client-macie2/commands/UpdateFindingsFilterCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFindingsFilterCommandInput = UpdateFindingsFilterRequest; export type UpdateFindingsFilterCommandOutput = UpdateFindingsFilterResponse & __MetadataBearer; +/** + *

Updates the criteria and other settings for a findings filter.

+ */ export class UpdateFindingsFilterCommand extends $Command< UpdateFindingsFilterCommandInput, UpdateFindingsFilterCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFindingsFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/UpdateMacieSessionCommand.ts b/clients/client-macie2/commands/UpdateMacieSessionCommand.ts index 41d804333d624..658bd75c54d7d 100644 --- a/clients/client-macie2/commands/UpdateMacieSessionCommand.ts +++ b/clients/client-macie2/commands/UpdateMacieSessionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMacieSessionCommandInput = UpdateMacieSessionRequest; export type UpdateMacieSessionCommandOutput = UpdateMacieSessionResponse & __MetadataBearer; +/** + *

Suspends or re-enables an Amazon Macie account, or updates the configuration settings for a Macie account.

+ */ export class UpdateMacieSessionCommand extends $Command< UpdateMacieSessionCommandInput, UpdateMacieSessionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMacieSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/UpdateMemberSessionCommand.ts b/clients/client-macie2/commands/UpdateMemberSessionCommand.ts index ef17e8515ee23..cc1e056abd5ab 100644 --- a/clients/client-macie2/commands/UpdateMemberSessionCommand.ts +++ b/clients/client-macie2/commands/UpdateMemberSessionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMemberSessionCommandInput = UpdateMemberSessionRequest; export type UpdateMemberSessionCommandOutput = UpdateMemberSessionResponse & __MetadataBearer; +/** + *

Enables an Amazon Macie master account to suspend or re-enable a member account.

+ */ export class UpdateMemberSessionCommand extends $Command< UpdateMemberSessionCommandInput, UpdateMemberSessionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMemberSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/commands/UpdateOrganizationConfigurationCommand.ts b/clients/client-macie2/commands/UpdateOrganizationConfigurationCommand.ts index 7eda2083b94c7..6065daefb7a70 100644 --- a/clients/client-macie2/commands/UpdateOrganizationConfigurationCommand.ts +++ b/clients/client-macie2/commands/UpdateOrganizationConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateOrganizationConfigurationCommandInput = UpdateOrganizationConfigurationRequest; export type UpdateOrganizationConfigurationCommandOutput = UpdateOrganizationConfigurationResponse & __MetadataBearer; +/** + *

Updates the Amazon Macie configuration settings for an AWS organization.

+ */ export class UpdateOrganizationConfigurationCommand extends $Command< UpdateOrganizationConfigurationCommandInput, UpdateOrganizationConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateOrganizationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Macie2ClientResolvedConfig, diff --git a/clients/client-macie2/package.json b/clients/client-macie2/package.json index b26fef6caf242..d50b0ca0e7647 100644 --- a/clients/client-macie2/package.json +++ b/clients/client-macie2/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Macie2 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-macie2/pagination/DescribeBucketsPaginator.ts b/clients/client-macie2/pagination/DescribeBucketsPaginator.ts index e746bb9c22417..aaa0a5cb479b5 100644 --- a/clients/client-macie2/pagination/DescribeBucketsPaginator.ts +++ b/clients/client-macie2/pagination/DescribeBucketsPaginator.ts @@ -8,6 +8,9 @@ import { import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: DescribeBucketsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBucketsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: DescribeBucketsCommandInput, diff --git a/clients/client-macie2/pagination/GetUsageStatisticsPaginator.ts b/clients/client-macie2/pagination/GetUsageStatisticsPaginator.ts index 8eeb098ed5a0b..a03db5370083b 100644 --- a/clients/client-macie2/pagination/GetUsageStatisticsPaginator.ts +++ b/clients/client-macie2/pagination/GetUsageStatisticsPaginator.ts @@ -8,6 +8,9 @@ import { import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: GetUsageStatisticsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetUsageStatisticsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: GetUsageStatisticsCommandInput, diff --git a/clients/client-macie2/pagination/ListClassificationJobsPaginator.ts b/clients/client-macie2/pagination/ListClassificationJobsPaginator.ts index 96afb461182b5..c26ade581a8e0 100644 --- a/clients/client-macie2/pagination/ListClassificationJobsPaginator.ts +++ b/clients/client-macie2/pagination/ListClassificationJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: ListClassificationJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListClassificationJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: ListClassificationJobsCommandInput, diff --git a/clients/client-macie2/pagination/ListCustomDataIdentifiersPaginator.ts b/clients/client-macie2/pagination/ListCustomDataIdentifiersPaginator.ts index e81e69d0e1ba6..9974355f5d42a 100644 --- a/clients/client-macie2/pagination/ListCustomDataIdentifiersPaginator.ts +++ b/clients/client-macie2/pagination/ListCustomDataIdentifiersPaginator.ts @@ -8,6 +8,9 @@ import { import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: ListCustomDataIdentifiersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCustomDataIdentifiersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: ListCustomDataIdentifiersCommandInput, diff --git a/clients/client-macie2/pagination/ListFindingsFiltersPaginator.ts b/clients/client-macie2/pagination/ListFindingsFiltersPaginator.ts index e3a8f6de417ab..d1f0d6b8e400c 100644 --- a/clients/client-macie2/pagination/ListFindingsFiltersPaginator.ts +++ b/clients/client-macie2/pagination/ListFindingsFiltersPaginator.ts @@ -8,6 +8,9 @@ import { import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: ListFindingsFiltersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFindingsFiltersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: ListFindingsFiltersCommandInput, diff --git a/clients/client-macie2/pagination/ListFindingsPaginator.ts b/clients/client-macie2/pagination/ListFindingsPaginator.ts index 1e45f3ccfd6a5..01c94f7ba7a6c 100644 --- a/clients/client-macie2/pagination/ListFindingsPaginator.ts +++ b/clients/client-macie2/pagination/ListFindingsPaginator.ts @@ -8,6 +8,9 @@ import { import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: ListFindingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFindingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: ListFindingsCommandInput, diff --git a/clients/client-macie2/pagination/ListInvitationsPaginator.ts b/clients/client-macie2/pagination/ListInvitationsPaginator.ts index b9e4b2cae8559..c02ec9f3a5389 100644 --- a/clients/client-macie2/pagination/ListInvitationsPaginator.ts +++ b/clients/client-macie2/pagination/ListInvitationsPaginator.ts @@ -8,6 +8,9 @@ import { import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: ListInvitationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInvitationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: ListInvitationsCommandInput, diff --git a/clients/client-macie2/pagination/ListMembersPaginator.ts b/clients/client-macie2/pagination/ListMembersPaginator.ts index 7c4f0a4d0a2aa..c472cb85a95c4 100644 --- a/clients/client-macie2/pagination/ListMembersPaginator.ts +++ b/clients/client-macie2/pagination/ListMembersPaginator.ts @@ -4,6 +4,9 @@ import { ListMembersCommand, ListMembersCommandInput, ListMembersCommandOutput } import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: ListMembersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMembersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: ListMembersCommandInput, diff --git a/clients/client-macie2/pagination/ListOrganizationAdminAccountsPaginator.ts b/clients/client-macie2/pagination/ListOrganizationAdminAccountsPaginator.ts index 38d905dddbbc3..deb0b8c4c05e5 100644 --- a/clients/client-macie2/pagination/ListOrganizationAdminAccountsPaginator.ts +++ b/clients/client-macie2/pagination/ListOrganizationAdminAccountsPaginator.ts @@ -8,6 +8,9 @@ import { import { Macie2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Macie2Client, input: ListOrganizationAdminAccountsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOrganizationAdminAccountsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Macie2, input: ListOrganizationAdminAccountsCommandInput, diff --git a/clients/client-macie2/runtimeConfig.browser.ts b/clients/client-macie2/runtimeConfig.browser.ts index 6cf11e49772fb..8ec85366ed855 100644 --- a/clients/client-macie2/runtimeConfig.browser.ts +++ b/clients/client-macie2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./Macie2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-macie2/runtimeConfig.native.ts b/clients/client-macie2/runtimeConfig.native.ts index 573b9be4da90e..c947e3b96a933 100644 --- a/clients/client-macie2/runtimeConfig.native.ts +++ b/clients/client-macie2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./Macie2Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-macie2/runtimeConfig.shared.ts b/clients/client-macie2/runtimeConfig.shared.ts index 0ff20b13869aa..97a003d434fa2 100644 --- a/clients/client-macie2/runtimeConfig.shared.ts +++ b/clients/client-macie2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-01-01", disableHostPrefix: false, diff --git a/clients/client-macie2/runtimeConfig.ts b/clients/client-macie2/runtimeConfig.ts index b42a3576a15e8..372f10f8bbf18 100644 --- a/clients/client-macie2/runtimeConfig.ts +++ b/clients/client-macie2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./Macie2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-macie2/tsconfig.json b/clients/client-macie2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-macie2/tsconfig.json +++ b/clients/client-macie2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-managedblockchain/commands/CreateMemberCommand.ts b/clients/client-managedblockchain/commands/CreateMemberCommand.ts index 548232da87f9a..abd114f3a1502 100644 --- a/clients/client-managedblockchain/commands/CreateMemberCommand.ts +++ b/clients/client-managedblockchain/commands/CreateMemberCommand.ts @@ -24,6 +24,9 @@ import { export type CreateMemberCommandInput = CreateMemberInput; export type CreateMemberCommandOutput = CreateMemberOutput & __MetadataBearer; +/** + *

Creates a member within a Managed Blockchain network.

+ */ export class CreateMemberCommand extends $Command< CreateMemberCommandInput, CreateMemberCommandOutput, @@ -38,6 +41,9 @@ export class CreateMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/CreateNetworkCommand.ts b/clients/client-managedblockchain/commands/CreateNetworkCommand.ts index 59a1a28a4233c..2371f61b20453 100644 --- a/clients/client-managedblockchain/commands/CreateNetworkCommand.ts +++ b/clients/client-managedblockchain/commands/CreateNetworkCommand.ts @@ -24,6 +24,9 @@ import { export type CreateNetworkCommandInput = CreateNetworkInput; export type CreateNetworkCommandOutput = CreateNetworkOutput & __MetadataBearer; +/** + *

Creates a new blockchain network using Amazon Managed Blockchain.

+ */ export class CreateNetworkCommand extends $Command< CreateNetworkCommandInput, CreateNetworkCommandOutput, @@ -38,6 +41,9 @@ export class CreateNetworkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/CreateNodeCommand.ts b/clients/client-managedblockchain/commands/CreateNodeCommand.ts index 8748caf85e195..d4d67997f3e92 100644 --- a/clients/client-managedblockchain/commands/CreateNodeCommand.ts +++ b/clients/client-managedblockchain/commands/CreateNodeCommand.ts @@ -24,6 +24,9 @@ import { export type CreateNodeCommandInput = CreateNodeInput; export type CreateNodeCommandOutput = CreateNodeOutput & __MetadataBearer; +/** + *

Creates a peer node in a member.

+ */ export class CreateNodeCommand extends $Command< CreateNodeCommandInput, CreateNodeCommandOutput, @@ -38,6 +41,9 @@ export class CreateNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/CreateProposalCommand.ts b/clients/client-managedblockchain/commands/CreateProposalCommand.ts index 60fad014a6af5..646ca3ba7454a 100644 --- a/clients/client-managedblockchain/commands/CreateProposalCommand.ts +++ b/clients/client-managedblockchain/commands/CreateProposalCommand.ts @@ -24,6 +24,9 @@ import { export type CreateProposalCommandInput = CreateProposalInput; export type CreateProposalCommandOutput = CreateProposalOutput & __MetadataBearer; +/** + *

Creates a proposal for a change to the network that other members of the network can vote on, for example, a proposal to add a new member to the network. Any member can create a proposal.

+ */ export class CreateProposalCommand extends $Command< CreateProposalCommandInput, CreateProposalCommandOutput, @@ -38,6 +41,9 @@ export class CreateProposalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/DeleteMemberCommand.ts b/clients/client-managedblockchain/commands/DeleteMemberCommand.ts index af1e467852222..a7035609635b9 100644 --- a/clients/client-managedblockchain/commands/DeleteMemberCommand.ts +++ b/clients/client-managedblockchain/commands/DeleteMemberCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteMemberCommandInput = DeleteMemberInput; export type DeleteMemberCommandOutput = DeleteMemberOutput & __MetadataBearer; +/** + *

Deletes a member. Deleting a member removes the member and all associated resources from the network. DeleteMember can only be called for a specified MemberId if the principal performing the action is associated with the AWS account that owns the member. In all other cases, the DeleteMember action is carried out as the result of an approved proposal to remove a member. If MemberId is the last member in a network specified by the last AWS account, the network is deleted also.

+ */ export class DeleteMemberCommand extends $Command< DeleteMemberCommandInput, DeleteMemberCommandOutput, @@ -38,6 +41,9 @@ export class DeleteMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/DeleteNodeCommand.ts b/clients/client-managedblockchain/commands/DeleteNodeCommand.ts index ef81d17462465..771a14807a9e7 100644 --- a/clients/client-managedblockchain/commands/DeleteNodeCommand.ts +++ b/clients/client-managedblockchain/commands/DeleteNodeCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteNodeCommandInput = DeleteNodeInput; export type DeleteNodeCommandOutput = DeleteNodeOutput & __MetadataBearer; +/** + *

Deletes a peer node from a member that your AWS account owns. All data on the node is lost and cannot be recovered.

+ */ export class DeleteNodeCommand extends $Command< DeleteNodeCommandInput, DeleteNodeCommandOutput, @@ -38,6 +41,9 @@ export class DeleteNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/GetMemberCommand.ts b/clients/client-managedblockchain/commands/GetMemberCommand.ts index 97f60ad7004a3..5d72f23a57a74 100644 --- a/clients/client-managedblockchain/commands/GetMemberCommand.ts +++ b/clients/client-managedblockchain/commands/GetMemberCommand.ts @@ -24,6 +24,9 @@ import { export type GetMemberCommandInput = GetMemberInput; export type GetMemberCommandOutput = GetMemberOutput & __MetadataBearer; +/** + *

Returns detailed information about a member.

+ */ export class GetMemberCommand extends $Command< GetMemberCommandInput, GetMemberCommandOutput, @@ -38,6 +41,9 @@ export class GetMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/GetNetworkCommand.ts b/clients/client-managedblockchain/commands/GetNetworkCommand.ts index 6f1bcf2594262..3b1adfcfb07cb 100644 --- a/clients/client-managedblockchain/commands/GetNetworkCommand.ts +++ b/clients/client-managedblockchain/commands/GetNetworkCommand.ts @@ -24,6 +24,9 @@ import { export type GetNetworkCommandInput = GetNetworkInput; export type GetNetworkCommandOutput = GetNetworkOutput & __MetadataBearer; +/** + *

Returns detailed information about a network.

+ */ export class GetNetworkCommand extends $Command< GetNetworkCommandInput, GetNetworkCommandOutput, @@ -38,6 +41,9 @@ export class GetNetworkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/GetNodeCommand.ts b/clients/client-managedblockchain/commands/GetNodeCommand.ts index d49a4b407c641..03c2814067cea 100644 --- a/clients/client-managedblockchain/commands/GetNodeCommand.ts +++ b/clients/client-managedblockchain/commands/GetNodeCommand.ts @@ -24,6 +24,9 @@ import { export type GetNodeCommandInput = GetNodeInput; export type GetNodeCommandOutput = GetNodeOutput & __MetadataBearer; +/** + *

Returns detailed information about a peer node.

+ */ export class GetNodeCommand extends $Command< GetNodeCommandInput, GetNodeCommandOutput, @@ -38,6 +41,9 @@ export class GetNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/GetProposalCommand.ts b/clients/client-managedblockchain/commands/GetProposalCommand.ts index 2a99140c516ea..d22371f841a4f 100644 --- a/clients/client-managedblockchain/commands/GetProposalCommand.ts +++ b/clients/client-managedblockchain/commands/GetProposalCommand.ts @@ -24,6 +24,9 @@ import { export type GetProposalCommandInput = GetProposalInput; export type GetProposalCommandOutput = GetProposalOutput & __MetadataBearer; +/** + *

Returns detailed information about a proposal.

+ */ export class GetProposalCommand extends $Command< GetProposalCommandInput, GetProposalCommandOutput, @@ -38,6 +41,9 @@ export class GetProposalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/ListInvitationsCommand.ts b/clients/client-managedblockchain/commands/ListInvitationsCommand.ts index 725063e4ea37b..18719db5eb368 100644 --- a/clients/client-managedblockchain/commands/ListInvitationsCommand.ts +++ b/clients/client-managedblockchain/commands/ListInvitationsCommand.ts @@ -24,6 +24,9 @@ import { export type ListInvitationsCommandInput = ListInvitationsInput; export type ListInvitationsCommandOutput = ListInvitationsOutput & __MetadataBearer; +/** + *

Returns a listing of all invitations for the current AWS account.

+ */ export class ListInvitationsCommand extends $Command< ListInvitationsCommandInput, ListInvitationsCommandOutput, @@ -38,6 +41,9 @@ export class ListInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/ListMembersCommand.ts b/clients/client-managedblockchain/commands/ListMembersCommand.ts index debdca5669b2d..f2bc8d6bb29f4 100644 --- a/clients/client-managedblockchain/commands/ListMembersCommand.ts +++ b/clients/client-managedblockchain/commands/ListMembersCommand.ts @@ -24,6 +24,9 @@ import { export type ListMembersCommandInput = ListMembersInput; export type ListMembersCommandOutput = ListMembersOutput & __MetadataBearer; +/** + *

Returns a listing of the members in a network and properties of their configurations.

+ */ export class ListMembersCommand extends $Command< ListMembersCommandInput, ListMembersCommandOutput, @@ -38,6 +41,9 @@ export class ListMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/ListNetworksCommand.ts b/clients/client-managedblockchain/commands/ListNetworksCommand.ts index 332d0f81504a3..6613f450d9e9f 100644 --- a/clients/client-managedblockchain/commands/ListNetworksCommand.ts +++ b/clients/client-managedblockchain/commands/ListNetworksCommand.ts @@ -24,6 +24,9 @@ import { export type ListNetworksCommandInput = ListNetworksInput; export type ListNetworksCommandOutput = ListNetworksOutput & __MetadataBearer; +/** + *

Returns information about the networks in which the current AWS account has members.

+ */ export class ListNetworksCommand extends $Command< ListNetworksCommandInput, ListNetworksCommandOutput, @@ -38,6 +41,9 @@ export class ListNetworksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/ListNodesCommand.ts b/clients/client-managedblockchain/commands/ListNodesCommand.ts index 8981986a9adfe..d3771b0a9efe9 100644 --- a/clients/client-managedblockchain/commands/ListNodesCommand.ts +++ b/clients/client-managedblockchain/commands/ListNodesCommand.ts @@ -24,6 +24,9 @@ import { export type ListNodesCommandInput = ListNodesInput; export type ListNodesCommandOutput = ListNodesOutput & __MetadataBearer; +/** + *

Returns information about the nodes within a network.

+ */ export class ListNodesCommand extends $Command< ListNodesCommandInput, ListNodesCommandOutput, @@ -38,6 +41,9 @@ export class ListNodesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/ListProposalVotesCommand.ts b/clients/client-managedblockchain/commands/ListProposalVotesCommand.ts index d17cd8badfc09..95b00df1e183c 100644 --- a/clients/client-managedblockchain/commands/ListProposalVotesCommand.ts +++ b/clients/client-managedblockchain/commands/ListProposalVotesCommand.ts @@ -24,6 +24,9 @@ import { export type ListProposalVotesCommandInput = ListProposalVotesInput; export type ListProposalVotesCommandOutput = ListProposalVotesOutput & __MetadataBearer; +/** + *

Returns the listing of votes for a specified proposal, including the value of each vote and the unique identifier of the member that cast the vote.

+ */ export class ListProposalVotesCommand extends $Command< ListProposalVotesCommandInput, ListProposalVotesCommandOutput, @@ -38,6 +41,9 @@ export class ListProposalVotesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/ListProposalsCommand.ts b/clients/client-managedblockchain/commands/ListProposalsCommand.ts index 21ba0651a6fb2..84ebc0a64b014 100644 --- a/clients/client-managedblockchain/commands/ListProposalsCommand.ts +++ b/clients/client-managedblockchain/commands/ListProposalsCommand.ts @@ -24,6 +24,9 @@ import { export type ListProposalsCommandInput = ListProposalsInput; export type ListProposalsCommandOutput = ListProposalsOutput & __MetadataBearer; +/** + *

Returns a listing of proposals for the network.

+ */ export class ListProposalsCommand extends $Command< ListProposalsCommandInput, ListProposalsCommandOutput, @@ -38,6 +41,9 @@ export class ListProposalsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/RejectInvitationCommand.ts b/clients/client-managedblockchain/commands/RejectInvitationCommand.ts index 76ed9909059a2..42a954285c37f 100644 --- a/clients/client-managedblockchain/commands/RejectInvitationCommand.ts +++ b/clients/client-managedblockchain/commands/RejectInvitationCommand.ts @@ -24,6 +24,9 @@ import { export type RejectInvitationCommandInput = RejectInvitationInput; export type RejectInvitationCommandOutput = RejectInvitationOutput & __MetadataBearer; +/** + *

Rejects an invitation to join a network. This action can be called by a principal in an AWS account that has received an invitation to create a member and join a network.

+ */ export class RejectInvitationCommand extends $Command< RejectInvitationCommandInput, RejectInvitationCommandOutput, @@ -38,6 +41,9 @@ export class RejectInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/UpdateMemberCommand.ts b/clients/client-managedblockchain/commands/UpdateMemberCommand.ts index 86ef8a95b207a..34996c345106c 100644 --- a/clients/client-managedblockchain/commands/UpdateMemberCommand.ts +++ b/clients/client-managedblockchain/commands/UpdateMemberCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateMemberCommandInput = UpdateMemberInput; export type UpdateMemberCommandOutput = UpdateMemberOutput & __MetadataBearer; +/** + *

Updates a member configuration with new parameters.

+ */ export class UpdateMemberCommand extends $Command< UpdateMemberCommandInput, UpdateMemberCommandOutput, @@ -38,6 +41,9 @@ export class UpdateMemberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/UpdateNodeCommand.ts b/clients/client-managedblockchain/commands/UpdateNodeCommand.ts index 2b2c17a09078c..795c37ce33542 100644 --- a/clients/client-managedblockchain/commands/UpdateNodeCommand.ts +++ b/clients/client-managedblockchain/commands/UpdateNodeCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateNodeCommandInput = UpdateNodeInput; export type UpdateNodeCommandOutput = UpdateNodeOutput & __MetadataBearer; +/** + *

Updates a node configuration with new parameters.

+ */ export class UpdateNodeCommand extends $Command< UpdateNodeCommandInput, UpdateNodeCommandOutput, @@ -38,6 +41,9 @@ export class UpdateNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/commands/VoteOnProposalCommand.ts b/clients/client-managedblockchain/commands/VoteOnProposalCommand.ts index 63f65d3de606b..222f4e7fe49f1 100644 --- a/clients/client-managedblockchain/commands/VoteOnProposalCommand.ts +++ b/clients/client-managedblockchain/commands/VoteOnProposalCommand.ts @@ -24,6 +24,9 @@ import { export type VoteOnProposalCommandInput = VoteOnProposalInput; export type VoteOnProposalCommandOutput = VoteOnProposalOutput & __MetadataBearer; +/** + *

Casts a vote for a specified ProposalId on behalf of a member. The member to vote as, specified by VoterMemberId, must be in the same AWS account as the principal that calls the action.

+ */ export class VoteOnProposalCommand extends $Command< VoteOnProposalCommandInput, VoteOnProposalCommandOutput, @@ -38,6 +41,9 @@ export class VoteOnProposalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ManagedBlockchainClientResolvedConfig, diff --git a/clients/client-managedblockchain/package.json b/clients/client-managedblockchain/package.json index f40f5e0872a24..dd5601c3e45a8 100644 --- a/clients/client-managedblockchain/package.json +++ b/clients/client-managedblockchain/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Managedblockchain Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-managedblockchain/pagination/ListInvitationsPaginator.ts b/clients/client-managedblockchain/pagination/ListInvitationsPaginator.ts index fb0b8f4f730d8..73a100f9f0b1c 100644 --- a/clients/client-managedblockchain/pagination/ListInvitationsPaginator.ts +++ b/clients/client-managedblockchain/pagination/ListInvitationsPaginator.ts @@ -8,6 +8,9 @@ import { import { ManagedBlockchainPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ManagedBlockchainClient, input: ListInvitationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInvitationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ManagedBlockchain, input: ListInvitationsCommandInput, diff --git a/clients/client-managedblockchain/pagination/ListMembersPaginator.ts b/clients/client-managedblockchain/pagination/ListMembersPaginator.ts index 81e6f60e0cfe2..2f6f9c68f4226 100644 --- a/clients/client-managedblockchain/pagination/ListMembersPaginator.ts +++ b/clients/client-managedblockchain/pagination/ListMembersPaginator.ts @@ -4,6 +4,9 @@ import { ListMembersCommand, ListMembersCommandInput, ListMembersCommandOutput } import { ManagedBlockchainPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ManagedBlockchainClient, input: ListMembersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMembersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ManagedBlockchain, input: ListMembersCommandInput, diff --git a/clients/client-managedblockchain/pagination/ListNetworksPaginator.ts b/clients/client-managedblockchain/pagination/ListNetworksPaginator.ts index d0c3148fbbb0b..c6d7ad46d496f 100644 --- a/clients/client-managedblockchain/pagination/ListNetworksPaginator.ts +++ b/clients/client-managedblockchain/pagination/ListNetworksPaginator.ts @@ -8,6 +8,9 @@ import { import { ManagedBlockchainPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ManagedBlockchainClient, input: ListNetworksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNetworksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ManagedBlockchain, input: ListNetworksCommandInput, diff --git a/clients/client-managedblockchain/pagination/ListNodesPaginator.ts b/clients/client-managedblockchain/pagination/ListNodesPaginator.ts index 90839c9e53f41..2dc7afa9cd0cd 100644 --- a/clients/client-managedblockchain/pagination/ListNodesPaginator.ts +++ b/clients/client-managedblockchain/pagination/ListNodesPaginator.ts @@ -4,6 +4,9 @@ import { ListNodesCommand, ListNodesCommandInput, ListNodesCommandOutput } from import { ManagedBlockchainPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ManagedBlockchainClient, input: ListNodesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNodesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ManagedBlockchain, input: ListNodesCommandInput, diff --git a/clients/client-managedblockchain/pagination/ListProposalVotesPaginator.ts b/clients/client-managedblockchain/pagination/ListProposalVotesPaginator.ts index 57d489f465178..fa39229acebad 100644 --- a/clients/client-managedblockchain/pagination/ListProposalVotesPaginator.ts +++ b/clients/client-managedblockchain/pagination/ListProposalVotesPaginator.ts @@ -8,6 +8,9 @@ import { import { ManagedBlockchainPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ManagedBlockchainClient, input: ListProposalVotesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProposalVotesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ManagedBlockchain, input: ListProposalVotesCommandInput, diff --git a/clients/client-managedblockchain/pagination/ListProposalsPaginator.ts b/clients/client-managedblockchain/pagination/ListProposalsPaginator.ts index 9ba99928340de..c583ce75f9db8 100644 --- a/clients/client-managedblockchain/pagination/ListProposalsPaginator.ts +++ b/clients/client-managedblockchain/pagination/ListProposalsPaginator.ts @@ -8,6 +8,9 @@ import { import { ManagedBlockchainPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ManagedBlockchainClient, input: ListProposalsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProposalsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ManagedBlockchain, input: ListProposalsCommandInput, diff --git a/clients/client-managedblockchain/runtimeConfig.browser.ts b/clients/client-managedblockchain/runtimeConfig.browser.ts index 14c007b549375..27f60580e81a1 100644 --- a/clients/client-managedblockchain/runtimeConfig.browser.ts +++ b/clients/client-managedblockchain/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ManagedBlockchainClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-managedblockchain/runtimeConfig.native.ts b/clients/client-managedblockchain/runtimeConfig.native.ts index 5ac8da891a472..958e3de5d4848 100644 --- a/clients/client-managedblockchain/runtimeConfig.native.ts +++ b/clients/client-managedblockchain/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ManagedBlockchainClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-managedblockchain/runtimeConfig.shared.ts b/clients/client-managedblockchain/runtimeConfig.shared.ts index 66661f328c91c..97bb1a97e83db 100644 --- a/clients/client-managedblockchain/runtimeConfig.shared.ts +++ b/clients/client-managedblockchain/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-09-24", disableHostPrefix: false, diff --git a/clients/client-managedblockchain/runtimeConfig.ts b/clients/client-managedblockchain/runtimeConfig.ts index 672e1ad73e28a..6be200e1d018f 100644 --- a/clients/client-managedblockchain/runtimeConfig.ts +++ b/clients/client-managedblockchain/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ManagedBlockchainClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-managedblockchain/tsconfig.json b/clients/client-managedblockchain/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-managedblockchain/tsconfig.json +++ b/clients/client-managedblockchain/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-marketplace-catalog/commands/CancelChangeSetCommand.ts b/clients/client-marketplace-catalog/commands/CancelChangeSetCommand.ts index a8e2d064860d4..1a455b7d41dce 100644 --- a/clients/client-marketplace-catalog/commands/CancelChangeSetCommand.ts +++ b/clients/client-marketplace-catalog/commands/CancelChangeSetCommand.ts @@ -24,6 +24,12 @@ import { export type CancelChangeSetCommandInput = CancelChangeSetRequest; export type CancelChangeSetCommandOutput = CancelChangeSetResponse & __MetadataBearer; +/** + *

Used to cancel an open change request. Must be sent before the status of the request + * changes to APPLYING, the final stage of completing your change request. You + * can describe a change during the 60-day request history retention period for API + * calls.

+ */ export class CancelChangeSetCommand extends $Command< CancelChangeSetCommandInput, CancelChangeSetCommandOutput, @@ -38,6 +44,9 @@ export class CancelChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceCatalogClientResolvedConfig, diff --git a/clients/client-marketplace-catalog/commands/DescribeChangeSetCommand.ts b/clients/client-marketplace-catalog/commands/DescribeChangeSetCommand.ts index 5fbab1825dd4e..b452b2076d9b1 100644 --- a/clients/client-marketplace-catalog/commands/DescribeChangeSetCommand.ts +++ b/clients/client-marketplace-catalog/commands/DescribeChangeSetCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeChangeSetCommandInput = DescribeChangeSetRequest; export type DescribeChangeSetCommandOutput = DescribeChangeSetResponse & __MetadataBearer; +/** + *

Provides information about a given change set.

+ */ export class DescribeChangeSetCommand extends $Command< DescribeChangeSetCommandInput, DescribeChangeSetCommandOutput, @@ -38,6 +41,9 @@ export class DescribeChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceCatalogClientResolvedConfig, diff --git a/clients/client-marketplace-catalog/commands/DescribeEntityCommand.ts b/clients/client-marketplace-catalog/commands/DescribeEntityCommand.ts index 17e595a124f3f..f2529e75ad566 100644 --- a/clients/client-marketplace-catalog/commands/DescribeEntityCommand.ts +++ b/clients/client-marketplace-catalog/commands/DescribeEntityCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeEntityCommandInput = DescribeEntityRequest; export type DescribeEntityCommandOutput = DescribeEntityResponse & __MetadataBearer; +/** + *

Returns the metadata and content of the entity.

+ */ export class DescribeEntityCommand extends $Command< DescribeEntityCommandInput, DescribeEntityCommandOutput, @@ -38,6 +41,9 @@ export class DescribeEntityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceCatalogClientResolvedConfig, diff --git a/clients/client-marketplace-catalog/commands/ListChangeSetsCommand.ts b/clients/client-marketplace-catalog/commands/ListChangeSetsCommand.ts index e343c19720bbb..98f1632d2f732 100644 --- a/clients/client-marketplace-catalog/commands/ListChangeSetsCommand.ts +++ b/clients/client-marketplace-catalog/commands/ListChangeSetsCommand.ts @@ -24,6 +24,15 @@ import { export type ListChangeSetsCommandInput = ListChangeSetsRequest; export type ListChangeSetsCommandOutput = ListChangeSetsResponse & __MetadataBearer; +/** + *

Returns the list of change sets owned by the account being used to make the call. You + * can filter this list by providing any combination of entityId, + * ChangeSetName, and status. If you provide more than one filter, the API + * operation applies a logical AND between the filters.

+ * + *

You can describe a change during the 60-day request history retention period for API + * calls.

+ */ export class ListChangeSetsCommand extends $Command< ListChangeSetsCommandInput, ListChangeSetsCommandOutput, @@ -38,6 +47,9 @@ export class ListChangeSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceCatalogClientResolvedConfig, diff --git a/clients/client-marketplace-catalog/commands/ListEntitiesCommand.ts b/clients/client-marketplace-catalog/commands/ListEntitiesCommand.ts index cf05f0f97dfd7..e7c56faf0e70f 100644 --- a/clients/client-marketplace-catalog/commands/ListEntitiesCommand.ts +++ b/clients/client-marketplace-catalog/commands/ListEntitiesCommand.ts @@ -24,6 +24,9 @@ import { export type ListEntitiesCommandInput = ListEntitiesRequest; export type ListEntitiesCommandOutput = ListEntitiesResponse & __MetadataBearer; +/** + *

Provides the list of entities of a given type.

+ */ export class ListEntitiesCommand extends $Command< ListEntitiesCommandInput, ListEntitiesCommandOutput, @@ -38,6 +41,9 @@ export class ListEntitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceCatalogClientResolvedConfig, diff --git a/clients/client-marketplace-catalog/commands/StartChangeSetCommand.ts b/clients/client-marketplace-catalog/commands/StartChangeSetCommand.ts index 80fdf42a93b4e..c9d64ca59c7e0 100644 --- a/clients/client-marketplace-catalog/commands/StartChangeSetCommand.ts +++ b/clients/client-marketplace-catalog/commands/StartChangeSetCommand.ts @@ -24,6 +24,19 @@ import { export type StartChangeSetCommandInput = StartChangeSetRequest; export type StartChangeSetCommandOutput = StartChangeSetResponse & __MetadataBearer; +/** + *

This operation allows you to request changes for your entities. Within a single + * ChangeSet, you cannot start the same change type against the same entity multiple times. + * Additionally, when a ChangeSet is running, all the entities targeted by the different + * changes are locked until the ChangeSet has completed (either succeeded, cancelled, or failed). If + * you try to start a ChangeSet containing a change against an entity that is already + * locked, you will receive a ResourceInUseException.

+ * + * + *

For example, you cannot start the ChangeSet described in the example below because it contains two changes to execute the same change + * type (AddRevisions) against the same entity + * (entity-id@1).

+ */ export class StartChangeSetCommand extends $Command< StartChangeSetCommandInput, StartChangeSetCommandOutput, @@ -38,6 +51,9 @@ export class StartChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceCatalogClientResolvedConfig, diff --git a/clients/client-marketplace-catalog/package.json b/clients/client-marketplace-catalog/package.json index 10b5840d2cacc..54316594e41ae 100644 --- a/clients/client-marketplace-catalog/package.json +++ b/clients/client-marketplace-catalog/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Marketplace Catalog Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-marketplace-catalog/pagination/ListChangeSetsPaginator.ts b/clients/client-marketplace-catalog/pagination/ListChangeSetsPaginator.ts index b701677535199..6b2332e5c0832 100644 --- a/clients/client-marketplace-catalog/pagination/ListChangeSetsPaginator.ts +++ b/clients/client-marketplace-catalog/pagination/ListChangeSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { MarketplaceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MarketplaceCatalogClient, input: ListChangeSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListChangeSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MarketplaceCatalog, input: ListChangeSetsCommandInput, diff --git a/clients/client-marketplace-catalog/pagination/ListEntitiesPaginator.ts b/clients/client-marketplace-catalog/pagination/ListEntitiesPaginator.ts index 99fc2f839bda9..72619bce12a47 100644 --- a/clients/client-marketplace-catalog/pagination/ListEntitiesPaginator.ts +++ b/clients/client-marketplace-catalog/pagination/ListEntitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { MarketplaceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MarketplaceCatalogClient, input: ListEntitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEntitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MarketplaceCatalog, input: ListEntitiesCommandInput, diff --git a/clients/client-marketplace-catalog/runtimeConfig.browser.ts b/clients/client-marketplace-catalog/runtimeConfig.browser.ts index d9ae242be5380..65de4399932cb 100644 --- a/clients/client-marketplace-catalog/runtimeConfig.browser.ts +++ b/clients/client-marketplace-catalog/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MarketplaceCatalogClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-marketplace-catalog/runtimeConfig.native.ts b/clients/client-marketplace-catalog/runtimeConfig.native.ts index 706777c7ebf91..db977ea40f232 100644 --- a/clients/client-marketplace-catalog/runtimeConfig.native.ts +++ b/clients/client-marketplace-catalog/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MarketplaceCatalogClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-marketplace-catalog/runtimeConfig.shared.ts b/clients/client-marketplace-catalog/runtimeConfig.shared.ts index d2b73d56b3681..cc54af7d995dd 100644 --- a/clients/client-marketplace-catalog/runtimeConfig.shared.ts +++ b/clients/client-marketplace-catalog/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-09-17", disableHostPrefix: false, diff --git a/clients/client-marketplace-catalog/runtimeConfig.ts b/clients/client-marketplace-catalog/runtimeConfig.ts index f26283d4bcc96..b04154ca820e8 100644 --- a/clients/client-marketplace-catalog/runtimeConfig.ts +++ b/clients/client-marketplace-catalog/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MarketplaceCatalogClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-marketplace-catalog/tsconfig.json b/clients/client-marketplace-catalog/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-marketplace-catalog/tsconfig.json +++ b/clients/client-marketplace-catalog/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-marketplace-commerce-analytics/commands/GenerateDataSetCommand.ts b/clients/client-marketplace-commerce-analytics/commands/GenerateDataSetCommand.ts index 4ad0bb69685e0..a9429757c7d7e 100644 --- a/clients/client-marketplace-commerce-analytics/commands/GenerateDataSetCommand.ts +++ b/clients/client-marketplace-commerce-analytics/commands/GenerateDataSetCommand.ts @@ -24,6 +24,16 @@ import { export type GenerateDataSetCommandInput = GenerateDataSetRequest; export type GenerateDataSetCommandOutput = GenerateDataSetResult & __MetadataBearer; +/** + * Given a data set type and data set publication date, asynchronously publishes the requested data set to the specified + * S3 bucket and notifies the specified SNS topic once the data is available. Returns a unique request identifier that + * can be used to correlate requests with notifications from the SNS topic. + * Data sets will be published in comma-separated values (CSV) format with the file name {data_set_type}_YYYY-MM-DD.csv. + * If a file with the same name already exists (e.g. if the same data set is requested twice), the original file will + * be overwritten by the new file. + * Requires a Role with an attached permissions policy providing Allow permissions for the following actions: + * s3:PutObject, s3:GetBucketLocation, sns:GetTopicAttributes, sns:Publish, iam:GetRolePolicy. + */ export class GenerateDataSetCommand extends $Command< GenerateDataSetCommandInput, GenerateDataSetCommandOutput, @@ -38,6 +48,9 @@ export class GenerateDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceCommerceAnalyticsClientResolvedConfig, diff --git a/clients/client-marketplace-commerce-analytics/commands/StartSupportDataExportCommand.ts b/clients/client-marketplace-commerce-analytics/commands/StartSupportDataExportCommand.ts index 3b8dc517fe676..559079686d71a 100644 --- a/clients/client-marketplace-commerce-analytics/commands/StartSupportDataExportCommand.ts +++ b/clients/client-marketplace-commerce-analytics/commands/StartSupportDataExportCommand.ts @@ -24,6 +24,16 @@ import { export type StartSupportDataExportCommandInput = StartSupportDataExportRequest; export type StartSupportDataExportCommandOutput = StartSupportDataExportResult & __MetadataBearer; +/** + * Given a data set type and a from date, asynchronously publishes the requested customer support data + * to the specified S3 bucket and notifies the specified SNS topic once the data is available. Returns a unique request + * identifier that can be used to correlate requests with notifications from the SNS topic. + * Data sets will be published in comma-separated values (CSV) format with the file name {data_set_type}_YYYY-MM-DD'T'HH-mm-ss'Z'.csv. + * If a file with the same name already exists (e.g. if the same data set is requested twice), the original file will + * be overwritten by the new file. + * Requires a Role with an attached permissions policy providing Allow permissions for the following actions: + * s3:PutObject, s3:GetBucketLocation, sns:GetTopicAttributes, sns:Publish, iam:GetRolePolicy. + */ export class StartSupportDataExportCommand extends $Command< StartSupportDataExportCommandInput, StartSupportDataExportCommandOutput, @@ -38,6 +48,9 @@ export class StartSupportDataExportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceCommerceAnalyticsClientResolvedConfig, diff --git a/clients/client-marketplace-commerce-analytics/package.json b/clients/client-marketplace-commerce-analytics/package.json index 3ef8e06f100dd..8642dd710ff30 100644 --- a/clients/client-marketplace-commerce-analytics/package.json +++ b/clients/client-marketplace-commerce-analytics/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Marketplace Commerce Analytics Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-marketplace-commerce-analytics/runtimeConfig.browser.ts b/clients/client-marketplace-commerce-analytics/runtimeConfig.browser.ts index 89f1b74a5515c..8794166301f35 100644 --- a/clients/client-marketplace-commerce-analytics/runtimeConfig.browser.ts +++ b/clients/client-marketplace-commerce-analytics/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MarketplaceCommerceAnalyticsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-marketplace-commerce-analytics/runtimeConfig.native.ts b/clients/client-marketplace-commerce-analytics/runtimeConfig.native.ts index 684c55819736e..5521199facf30 100644 --- a/clients/client-marketplace-commerce-analytics/runtimeConfig.native.ts +++ b/clients/client-marketplace-commerce-analytics/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MarketplaceCommerceAnalyticsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-marketplace-commerce-analytics/runtimeConfig.shared.ts b/clients/client-marketplace-commerce-analytics/runtimeConfig.shared.ts index 065b98d24a27d..886d91d2980ab 100644 --- a/clients/client-marketplace-commerce-analytics/runtimeConfig.shared.ts +++ b/clients/client-marketplace-commerce-analytics/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-07-01", disableHostPrefix: false, diff --git a/clients/client-marketplace-commerce-analytics/runtimeConfig.ts b/clients/client-marketplace-commerce-analytics/runtimeConfig.ts index 9aa1eefde5084..b53b4bb6ccd71 100644 --- a/clients/client-marketplace-commerce-analytics/runtimeConfig.ts +++ b/clients/client-marketplace-commerce-analytics/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MarketplaceCommerceAnalyticsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-marketplace-commerce-analytics/tsconfig.json b/clients/client-marketplace-commerce-analytics/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-marketplace-commerce-analytics/tsconfig.json +++ b/clients/client-marketplace-commerce-analytics/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-marketplace-entitlement-service/commands/GetEntitlementsCommand.ts b/clients/client-marketplace-entitlement-service/commands/GetEntitlementsCommand.ts index 5cbf5f14a9d45..895dda7861ca7 100644 --- a/clients/client-marketplace-entitlement-service/commands/GetEntitlementsCommand.ts +++ b/clients/client-marketplace-entitlement-service/commands/GetEntitlementsCommand.ts @@ -24,6 +24,10 @@ import { export type GetEntitlementsCommandInput = GetEntitlementsRequest; export type GetEntitlementsCommandOutput = GetEntitlementsResult & __MetadataBearer; +/** + *

GetEntitlements retrieves entitlement values for a given product. The results can be + * filtered based on customer identifier or product dimensions.

+ */ export class GetEntitlementsCommand extends $Command< GetEntitlementsCommandInput, GetEntitlementsCommandOutput, @@ -38,6 +42,9 @@ export class GetEntitlementsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceEntitlementServiceClientResolvedConfig, diff --git a/clients/client-marketplace-entitlement-service/package.json b/clients/client-marketplace-entitlement-service/package.json index 63700078d07ea..2096c613a4bbf 100644 --- a/clients/client-marketplace-entitlement-service/package.json +++ b/clients/client-marketplace-entitlement-service/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Marketplace Entitlement Service Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-marketplace-entitlement-service/runtimeConfig.browser.ts b/clients/client-marketplace-entitlement-service/runtimeConfig.browser.ts index 41697437bbb0e..b7fcc7fd8ed86 100644 --- a/clients/client-marketplace-entitlement-service/runtimeConfig.browser.ts +++ b/clients/client-marketplace-entitlement-service/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MarketplaceEntitlementServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-marketplace-entitlement-service/runtimeConfig.native.ts b/clients/client-marketplace-entitlement-service/runtimeConfig.native.ts index 0a07a4229ae85..cf94a1d6e5a46 100644 --- a/clients/client-marketplace-entitlement-service/runtimeConfig.native.ts +++ b/clients/client-marketplace-entitlement-service/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MarketplaceEntitlementServiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-marketplace-entitlement-service/runtimeConfig.shared.ts b/clients/client-marketplace-entitlement-service/runtimeConfig.shared.ts index 3ee113ec50338..05f6cd4d22976 100644 --- a/clients/client-marketplace-entitlement-service/runtimeConfig.shared.ts +++ b/clients/client-marketplace-entitlement-service/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-01-11", disableHostPrefix: false, diff --git a/clients/client-marketplace-entitlement-service/runtimeConfig.ts b/clients/client-marketplace-entitlement-service/runtimeConfig.ts index 5597c7db45b9a..9cea2f8517bec 100644 --- a/clients/client-marketplace-entitlement-service/runtimeConfig.ts +++ b/clients/client-marketplace-entitlement-service/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MarketplaceEntitlementServiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-marketplace-entitlement-service/tsconfig.json b/clients/client-marketplace-entitlement-service/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-marketplace-entitlement-service/tsconfig.json +++ b/clients/client-marketplace-entitlement-service/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-marketplace-metering/commands/BatchMeterUsageCommand.ts b/clients/client-marketplace-metering/commands/BatchMeterUsageCommand.ts index e468544671585..b4dc73859e5fc 100644 --- a/clients/client-marketplace-metering/commands/BatchMeterUsageCommand.ts +++ b/clients/client-marketplace-metering/commands/BatchMeterUsageCommand.ts @@ -24,6 +24,19 @@ import { export type BatchMeterUsageCommandInput = BatchMeterUsageRequest; export type BatchMeterUsageCommandOutput = BatchMeterUsageResult & __MetadataBearer; +/** + *

BatchMeterUsage is called from a SaaS application listed on the AWS Marketplace to + * post metering records for a set of customers.

+ *

For identical requests, the API is idempotent; requests can be retried with the + * same records or a subset of the input records.

+ *

Every request to BatchMeterUsage is for one product. If you need to meter usage for + * multiple products, you must make multiple calls to BatchMeterUsage.

+ *

BatchMeterUsage can process up to 25 UsageRecords at a time.

+ *

A UsageRecord can optionally include multiple usage allocations, to provide customers + * with usagedata split into buckets by tags that you define (or allow the customer to + * define).

+ *

BatchMeterUsage requests must be less than 1MB in size.

+ */ export class BatchMeterUsageCommand extends $Command< BatchMeterUsageCommandInput, BatchMeterUsageCommandOutput, @@ -38,6 +51,9 @@ export class BatchMeterUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceMeteringClientResolvedConfig, diff --git a/clients/client-marketplace-metering/commands/MeterUsageCommand.ts b/clients/client-marketplace-metering/commands/MeterUsageCommand.ts index bb1dd3bbdb0f0..de80bf47bee60 100644 --- a/clients/client-marketplace-metering/commands/MeterUsageCommand.ts +++ b/clients/client-marketplace-metering/commands/MeterUsageCommand.ts @@ -24,6 +24,15 @@ import { export type MeterUsageCommandInput = MeterUsageRequest; export type MeterUsageCommandOutput = MeterUsageResult & __MetadataBearer; +/** + *

API to emit metering records. For identical requests, the API is idempotent. It + * simply returns the metering record ID.

+ *

MeterUsage is authenticated on the buyer's AWS account using credentials from the + * EC2 instance, ECS task, or EKS pod.

+ *

MeterUsage can optionally include multiple usage allocations, to provide customers + * with usage data split into buckets by tags that you define (or allow the customer to + * define).

+ */ export class MeterUsageCommand extends $Command< MeterUsageCommandInput, MeterUsageCommandOutput, @@ -38,6 +47,9 @@ export class MeterUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceMeteringClientResolvedConfig, diff --git a/clients/client-marketplace-metering/commands/RegisterUsageCommand.ts b/clients/client-marketplace-metering/commands/RegisterUsageCommand.ts index 8bd56b125bb3e..a03a81500d9f6 100644 --- a/clients/client-marketplace-metering/commands/RegisterUsageCommand.ts +++ b/clients/client-marketplace-metering/commands/RegisterUsageCommand.ts @@ -24,6 +24,47 @@ import { export type RegisterUsageCommandInput = RegisterUsageRequest; export type RegisterUsageCommandOutput = RegisterUsageResult & __MetadataBearer; +/** + *

Paid container software products sold through AWS Marketplace must integrate with + * the AWS Marketplace Metering Service and call the RegisterUsage operation for software + * entitlement and metering. Free and BYOL products for Amazon ECS or Amazon EKS aren't + * required to call RegisterUsage, but you may choose to do so if you would like to receive + * usage data in your seller reports. The sections below explain the behavior of + * RegisterUsage. RegisterUsage performs two primary functions: metering and + * entitlement.

+ * + *
    + *
  • + *

    + * Entitlement: RegisterUsage allows you to verify that the + * customer running your paid software is subscribed to your product on AWS + * Marketplace, enabling you to guard against unauthorized use. Your container + * image that integrates with RegisterUsage is only required to guard against + * unauthorized use at container startup, as such a + * CustomerNotSubscribedException/PlatformNotSupportedException will only be thrown + * on the initial call to RegisterUsage. Subsequent calls from the same Amazon ECS + * task instance (e.g. task-id) or Amazon EKS pod will not throw a + * CustomerNotSubscribedException, even if the customer unsubscribes while the + * Amazon ECS task or Amazon EKS pod is still running.

    + *
  • + *
  • + *

    + * Metering: RegisterUsage meters software use per ECS task, + * per hour, or per pod for Amazon EKS with usage prorated to the second. A minimum + * of 1 minute of usage applies to tasks that are short lived. For example, if a + * customer has a 10 node Amazon ECS or Amazon EKS cluster and a service configured + * as a Daemon Set, then Amazon ECS or Amazon EKS will launch a task on all 10 + * cluster nodes and the customer will be charged: (10 * hourly_rate). Metering for + * software use is automatically handled by the AWS Marketplace Metering Control + * Plane -- your software is not required to perform any metering specific actions, + * other than call RegisterUsage once for metering of software use to commence. The + * AWS Marketplace Metering Control Plane will also continue to bill customers for + * running ECS tasks and Amazon EKS pods, regardless of the customers subscription + * state, removing the need for your software to perform entitlement checks at + * runtime.

    + *
  • + *
+ */ export class RegisterUsageCommand extends $Command< RegisterUsageCommandInput, RegisterUsageCommandOutput, @@ -38,6 +79,9 @@ export class RegisterUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceMeteringClientResolvedConfig, diff --git a/clients/client-marketplace-metering/commands/ResolveCustomerCommand.ts b/clients/client-marketplace-metering/commands/ResolveCustomerCommand.ts index ce264a59c9eee..43c95768b8fc1 100644 --- a/clients/client-marketplace-metering/commands/ResolveCustomerCommand.ts +++ b/clients/client-marketplace-metering/commands/ResolveCustomerCommand.ts @@ -24,6 +24,12 @@ import { export type ResolveCustomerCommandInput = ResolveCustomerRequest; export type ResolveCustomerCommandOutput = ResolveCustomerResult & __MetadataBearer; +/** + *

ResolveCustomer is called by a SaaS application during the registration process. + * When a buyer visits your website during the registration process, the buyer submits a + * registration token through their browser. The registration token is resolved through + * this API to obtain a CustomerIdentifier and product code.

+ */ export class ResolveCustomerCommand extends $Command< ResolveCustomerCommandInput, ResolveCustomerCommandOutput, @@ -38,6 +44,9 @@ export class ResolveCustomerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MarketplaceMeteringClientResolvedConfig, diff --git a/clients/client-marketplace-metering/package.json b/clients/client-marketplace-metering/package.json index 9f995219ae328..c5fdc3c23905f 100644 --- a/clients/client-marketplace-metering/package.json +++ b/clients/client-marketplace-metering/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Marketplace Metering Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-marketplace-metering/runtimeConfig.browser.ts b/clients/client-marketplace-metering/runtimeConfig.browser.ts index eeb6f19c6c4ef..4ce090897742b 100644 --- a/clients/client-marketplace-metering/runtimeConfig.browser.ts +++ b/clients/client-marketplace-metering/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MarketplaceMeteringClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-marketplace-metering/runtimeConfig.native.ts b/clients/client-marketplace-metering/runtimeConfig.native.ts index 6a32bac06cc2e..e42dc36ff62f0 100644 --- a/clients/client-marketplace-metering/runtimeConfig.native.ts +++ b/clients/client-marketplace-metering/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MarketplaceMeteringClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-marketplace-metering/runtimeConfig.shared.ts b/clients/client-marketplace-metering/runtimeConfig.shared.ts index a1f2df6244810..8487c167630ed 100644 --- a/clients/client-marketplace-metering/runtimeConfig.shared.ts +++ b/clients/client-marketplace-metering/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-01-14", disableHostPrefix: false, diff --git a/clients/client-marketplace-metering/runtimeConfig.ts b/clients/client-marketplace-metering/runtimeConfig.ts index 1503dafad2d20..88c43d3d14a2f 100644 --- a/clients/client-marketplace-metering/runtimeConfig.ts +++ b/clients/client-marketplace-metering/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MarketplaceMeteringClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-marketplace-metering/tsconfig.json b/clients/client-marketplace-metering/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-marketplace-metering/tsconfig.json +++ b/clients/client-marketplace-metering/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mediaconnect/commands/AddFlowOutputsCommand.ts b/clients/client-mediaconnect/commands/AddFlowOutputsCommand.ts index 1ff9ec39139db..c5b604ae1d247 100644 --- a/clients/client-mediaconnect/commands/AddFlowOutputsCommand.ts +++ b/clients/client-mediaconnect/commands/AddFlowOutputsCommand.ts @@ -20,6 +20,9 @@ import { export type AddFlowOutputsCommandInput = AddFlowOutputsRequest; export type AddFlowOutputsCommandOutput = AddFlowOutputsResponse & __MetadataBearer; +/** + * Adds outputs to an existing flow. You can create up to 50 outputs per flow. + */ export class AddFlowOutputsCommand extends $Command< AddFlowOutputsCommandInput, AddFlowOutputsCommandOutput, @@ -34,6 +37,9 @@ export class AddFlowOutputsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/AddFlowSourcesCommand.ts b/clients/client-mediaconnect/commands/AddFlowSourcesCommand.ts index ad813ab0663ae..34ac9d06ad2ec 100644 --- a/clients/client-mediaconnect/commands/AddFlowSourcesCommand.ts +++ b/clients/client-mediaconnect/commands/AddFlowSourcesCommand.ts @@ -20,6 +20,9 @@ import { export type AddFlowSourcesCommandInput = AddFlowSourcesRequest; export type AddFlowSourcesCommandOutput = AddFlowSourcesResponse & __MetadataBearer; +/** + * Adds Sources to flow + */ export class AddFlowSourcesCommand extends $Command< AddFlowSourcesCommandInput, AddFlowSourcesCommandOutput, @@ -34,6 +37,9 @@ export class AddFlowSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/AddFlowVpcInterfacesCommand.ts b/clients/client-mediaconnect/commands/AddFlowVpcInterfacesCommand.ts index 5445e06922f5a..daa937985ef12 100644 --- a/clients/client-mediaconnect/commands/AddFlowVpcInterfacesCommand.ts +++ b/clients/client-mediaconnect/commands/AddFlowVpcInterfacesCommand.ts @@ -20,6 +20,9 @@ import { export type AddFlowVpcInterfacesCommandInput = AddFlowVpcInterfacesRequest; export type AddFlowVpcInterfacesCommandOutput = AddFlowVpcInterfacesResponse & __MetadataBearer; +/** + * Adds VPC interfaces to flow + */ export class AddFlowVpcInterfacesCommand extends $Command< AddFlowVpcInterfacesCommandInput, AddFlowVpcInterfacesCommandOutput, @@ -34,6 +37,9 @@ export class AddFlowVpcInterfacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/CreateFlowCommand.ts b/clients/client-mediaconnect/commands/CreateFlowCommand.ts index a3821251745cc..b1be0351e0134 100644 --- a/clients/client-mediaconnect/commands/CreateFlowCommand.ts +++ b/clients/client-mediaconnect/commands/CreateFlowCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFlowCommandInput = CreateFlowRequest; export type CreateFlowCommandOutput = CreateFlowResponse & __MetadataBearer; +/** + * Creates a new flow. The request must include one source. The request optionally can include outputs (up to 50) and entitlements (up to 50). + */ export class CreateFlowCommand extends $Command< CreateFlowCommandInput, CreateFlowCommandOutput, @@ -34,6 +37,9 @@ export class CreateFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/DeleteFlowCommand.ts b/clients/client-mediaconnect/commands/DeleteFlowCommand.ts index a1d68943db509..0150be1be85d6 100644 --- a/clients/client-mediaconnect/commands/DeleteFlowCommand.ts +++ b/clients/client-mediaconnect/commands/DeleteFlowCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFlowCommandInput = DeleteFlowRequest; export type DeleteFlowCommandOutput = DeleteFlowResponse & __MetadataBearer; +/** + * Deletes a flow. Before you can delete a flow, you must stop the flow. + */ export class DeleteFlowCommand extends $Command< DeleteFlowCommandInput, DeleteFlowCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/DescribeFlowCommand.ts b/clients/client-mediaconnect/commands/DescribeFlowCommand.ts index 1c42ac3e8b19c..3de954680f066 100644 --- a/clients/client-mediaconnect/commands/DescribeFlowCommand.ts +++ b/clients/client-mediaconnect/commands/DescribeFlowCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFlowCommandInput = DescribeFlowRequest; export type DescribeFlowCommandOutput = DescribeFlowResponse & __MetadataBearer; +/** + * Displays the details of a flow. The response includes the flow ARN, name, and Availability Zone, as well as details about the source, outputs, and entitlements. + */ export class DescribeFlowCommand extends $Command< DescribeFlowCommandInput, DescribeFlowCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/DescribeOfferingCommand.ts b/clients/client-mediaconnect/commands/DescribeOfferingCommand.ts index 99021b9515015..cc077cafdda22 100644 --- a/clients/client-mediaconnect/commands/DescribeOfferingCommand.ts +++ b/clients/client-mediaconnect/commands/DescribeOfferingCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOfferingCommandInput = DescribeOfferingRequest; export type DescribeOfferingCommandOutput = DescribeOfferingResponse & __MetadataBearer; +/** + * Displays the details of an offering. The response includes the offering description, duration, outbound bandwidth, price, and Amazon Resource Name (ARN). + */ export class DescribeOfferingCommand extends $Command< DescribeOfferingCommandInput, DescribeOfferingCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/DescribeReservationCommand.ts b/clients/client-mediaconnect/commands/DescribeReservationCommand.ts index f2b58e46a9fa4..6432ebe5a6eca 100644 --- a/clients/client-mediaconnect/commands/DescribeReservationCommand.ts +++ b/clients/client-mediaconnect/commands/DescribeReservationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeReservationCommandInput = DescribeReservationRequest; export type DescribeReservationCommandOutput = DescribeReservationResponse & __MetadataBearer; +/** + * Displays the details of a reservation. The response includes the reservation name, state, start date and time, and the details of the offering that make up the rest of the reservation (such as price, duration, and outbound bandwidth). + */ export class DescribeReservationCommand extends $Command< DescribeReservationCommandInput, DescribeReservationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/GrantFlowEntitlementsCommand.ts b/clients/client-mediaconnect/commands/GrantFlowEntitlementsCommand.ts index e4637ec96f59f..0d052d22f6e4c 100644 --- a/clients/client-mediaconnect/commands/GrantFlowEntitlementsCommand.ts +++ b/clients/client-mediaconnect/commands/GrantFlowEntitlementsCommand.ts @@ -20,6 +20,9 @@ import { export type GrantFlowEntitlementsCommandInput = GrantFlowEntitlementsRequest; export type GrantFlowEntitlementsCommandOutput = GrantFlowEntitlementsResponse & __MetadataBearer; +/** + * Grants entitlements to an existing flow. + */ export class GrantFlowEntitlementsCommand extends $Command< GrantFlowEntitlementsCommandInput, GrantFlowEntitlementsCommandOutput, @@ -34,6 +37,9 @@ export class GrantFlowEntitlementsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/ListEntitlementsCommand.ts b/clients/client-mediaconnect/commands/ListEntitlementsCommand.ts index df79d3c92ec86..1edaf23cd13bf 100644 --- a/clients/client-mediaconnect/commands/ListEntitlementsCommand.ts +++ b/clients/client-mediaconnect/commands/ListEntitlementsCommand.ts @@ -20,6 +20,9 @@ import { export type ListEntitlementsCommandInput = ListEntitlementsRequest; export type ListEntitlementsCommandOutput = ListEntitlementsResponse & __MetadataBearer; +/** + * Displays a list of all entitlements that have been granted to this account. This request returns 20 results per page. + */ export class ListEntitlementsCommand extends $Command< ListEntitlementsCommandInput, ListEntitlementsCommandOutput, @@ -34,6 +37,9 @@ export class ListEntitlementsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/ListFlowsCommand.ts b/clients/client-mediaconnect/commands/ListFlowsCommand.ts index b77c0bdf903ab..0dff63f5ddd39 100644 --- a/clients/client-mediaconnect/commands/ListFlowsCommand.ts +++ b/clients/client-mediaconnect/commands/ListFlowsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFlowsCommandInput = ListFlowsRequest; export type ListFlowsCommandOutput = ListFlowsResponse & __MetadataBearer; +/** + * Displays a list of flows that are associated with this account. This request returns a paginated result. + */ export class ListFlowsCommand extends $Command< ListFlowsCommandInput, ListFlowsCommandOutput, @@ -34,6 +37,9 @@ export class ListFlowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/ListOfferingsCommand.ts b/clients/client-mediaconnect/commands/ListOfferingsCommand.ts index bc32b36d8aec3..d5a945954311f 100644 --- a/clients/client-mediaconnect/commands/ListOfferingsCommand.ts +++ b/clients/client-mediaconnect/commands/ListOfferingsCommand.ts @@ -20,6 +20,9 @@ import { export type ListOfferingsCommandInput = ListOfferingsRequest; export type ListOfferingsCommandOutput = ListOfferingsResponse & __MetadataBearer; +/** + * Displays a list of all offerings that are available to this account in the current AWS Region. If you have an active reservation (which means you've purchased an offering that has already started and hasn't expired yet), your account isn't eligible for other offerings. + */ export class ListOfferingsCommand extends $Command< ListOfferingsCommandInput, ListOfferingsCommandOutput, @@ -34,6 +37,9 @@ export class ListOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/ListReservationsCommand.ts b/clients/client-mediaconnect/commands/ListReservationsCommand.ts index 2e695fbd209ad..e4076ec049f07 100644 --- a/clients/client-mediaconnect/commands/ListReservationsCommand.ts +++ b/clients/client-mediaconnect/commands/ListReservationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListReservationsCommandInput = ListReservationsRequest; export type ListReservationsCommandOutput = ListReservationsResponse & __MetadataBearer; +/** + * Displays a list of all reservations that have been purchased by this account in the current AWS Region. This list includes all reservations in all states (such as active and expired). + */ export class ListReservationsCommand extends $Command< ListReservationsCommandInput, ListReservationsCommandOutput, @@ -34,6 +37,9 @@ export class ListReservationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/ListTagsForResourceCommand.ts b/clients/client-mediaconnect/commands/ListTagsForResourceCommand.ts index 2614493b8ce42..f23e26f8af95e 100644 --- a/clients/client-mediaconnect/commands/ListTagsForResourceCommand.ts +++ b/clients/client-mediaconnect/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + * List all tags on an AWS Elemental MediaConnect resource + */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/PurchaseOfferingCommand.ts b/clients/client-mediaconnect/commands/PurchaseOfferingCommand.ts index 72a752e138b2f..33a9f564fba10 100644 --- a/clients/client-mediaconnect/commands/PurchaseOfferingCommand.ts +++ b/clients/client-mediaconnect/commands/PurchaseOfferingCommand.ts @@ -20,6 +20,9 @@ import { export type PurchaseOfferingCommandInput = PurchaseOfferingRequest; export type PurchaseOfferingCommandOutput = PurchaseOfferingResponse & __MetadataBearer; +/** + * Submits a request to purchase an offering. If you already have an active reservation, you can't purchase another offering. + */ export class PurchaseOfferingCommand extends $Command< PurchaseOfferingCommandInput, PurchaseOfferingCommandOutput, @@ -34,6 +37,9 @@ export class PurchaseOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/RemoveFlowOutputCommand.ts b/clients/client-mediaconnect/commands/RemoveFlowOutputCommand.ts index 0ef1d2bc8b08c..1491d395f01e6 100644 --- a/clients/client-mediaconnect/commands/RemoveFlowOutputCommand.ts +++ b/clients/client-mediaconnect/commands/RemoveFlowOutputCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveFlowOutputCommandInput = RemoveFlowOutputRequest; export type RemoveFlowOutputCommandOutput = RemoveFlowOutputResponse & __MetadataBearer; +/** + * Removes an output from an existing flow. This request can be made only on an output that does not have an entitlement associated with it. If the output has an entitlement, you must revoke the entitlement instead. When an entitlement is revoked from a flow, the service automatically removes the associated output. + */ export class RemoveFlowOutputCommand extends $Command< RemoveFlowOutputCommandInput, RemoveFlowOutputCommandOutput, @@ -34,6 +37,9 @@ export class RemoveFlowOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/RemoveFlowSourceCommand.ts b/clients/client-mediaconnect/commands/RemoveFlowSourceCommand.ts index 4394da631af59..edb362141d75a 100644 --- a/clients/client-mediaconnect/commands/RemoveFlowSourceCommand.ts +++ b/clients/client-mediaconnect/commands/RemoveFlowSourceCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveFlowSourceCommandInput = RemoveFlowSourceRequest; export type RemoveFlowSourceCommandOutput = RemoveFlowSourceResponse & __MetadataBearer; +/** + * Removes a source from an existing flow. This request can be made only if there is more than one source on the flow. + */ export class RemoveFlowSourceCommand extends $Command< RemoveFlowSourceCommandInput, RemoveFlowSourceCommandOutput, @@ -34,6 +37,9 @@ export class RemoveFlowSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/RemoveFlowVpcInterfaceCommand.ts b/clients/client-mediaconnect/commands/RemoveFlowVpcInterfaceCommand.ts index d59756244b67f..28641e26ef56f 100644 --- a/clients/client-mediaconnect/commands/RemoveFlowVpcInterfaceCommand.ts +++ b/clients/client-mediaconnect/commands/RemoveFlowVpcInterfaceCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveFlowVpcInterfaceCommandInput = RemoveFlowVpcInterfaceRequest; export type RemoveFlowVpcInterfaceCommandOutput = RemoveFlowVpcInterfaceResponse & __MetadataBearer; +/** + * Removes a VPC Interface from an existing flow. This request can be made only on a VPC interface that does not have a Source or Output associated with it. If the VPC interface is referenced by a Source or Output, you must first delete or update the Source or Output to no longer reference the VPC interface. + */ export class RemoveFlowVpcInterfaceCommand extends $Command< RemoveFlowVpcInterfaceCommandInput, RemoveFlowVpcInterfaceCommandOutput, @@ -34,6 +37,9 @@ export class RemoveFlowVpcInterfaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/RevokeFlowEntitlementCommand.ts b/clients/client-mediaconnect/commands/RevokeFlowEntitlementCommand.ts index 57d6e60f75e26..98abf22659147 100644 --- a/clients/client-mediaconnect/commands/RevokeFlowEntitlementCommand.ts +++ b/clients/client-mediaconnect/commands/RevokeFlowEntitlementCommand.ts @@ -20,6 +20,9 @@ import { export type RevokeFlowEntitlementCommandInput = RevokeFlowEntitlementRequest; export type RevokeFlowEntitlementCommandOutput = RevokeFlowEntitlementResponse & __MetadataBearer; +/** + * Revokes an entitlement from a flow. Once an entitlement is revoked, the content becomes unavailable to the subscriber and the associated output is removed. + */ export class RevokeFlowEntitlementCommand extends $Command< RevokeFlowEntitlementCommandInput, RevokeFlowEntitlementCommandOutput, @@ -34,6 +37,9 @@ export class RevokeFlowEntitlementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/StartFlowCommand.ts b/clients/client-mediaconnect/commands/StartFlowCommand.ts index 131e39444e43d..e15a3caa69434 100644 --- a/clients/client-mediaconnect/commands/StartFlowCommand.ts +++ b/clients/client-mediaconnect/commands/StartFlowCommand.ts @@ -20,6 +20,9 @@ import { export type StartFlowCommandInput = StartFlowRequest; export type StartFlowCommandOutput = StartFlowResponse & __MetadataBearer; +/** + * Starts a flow. + */ export class StartFlowCommand extends $Command< StartFlowCommandInput, StartFlowCommandOutput, @@ -34,6 +37,9 @@ export class StartFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/StopFlowCommand.ts b/clients/client-mediaconnect/commands/StopFlowCommand.ts index c021fad5311ec..cd3fd3dcfe242 100644 --- a/clients/client-mediaconnect/commands/StopFlowCommand.ts +++ b/clients/client-mediaconnect/commands/StopFlowCommand.ts @@ -20,6 +20,9 @@ import { export type StopFlowCommandInput = StopFlowRequest; export type StopFlowCommandOutput = StopFlowResponse & __MetadataBearer; +/** + * Stops a flow. + */ export class StopFlowCommand extends $Command< StopFlowCommandInput, StopFlowCommandOutput, @@ -34,6 +37,9 @@ export class StopFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/TagResourceCommand.ts b/clients/client-mediaconnect/commands/TagResourceCommand.ts index afd62461399a4..7be2b54b236d6 100644 --- a/clients/client-mediaconnect/commands/TagResourceCommand.ts +++ b/clients/client-mediaconnect/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + * Associates the specified tags to a resource with the specified resourceArn. If existing tags on a resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags associated with that resource are deleted as well. + */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/UntagResourceCommand.ts b/clients/client-mediaconnect/commands/UntagResourceCommand.ts index 4341752f6b081..ff713a1ed1bb8 100644 --- a/clients/client-mediaconnect/commands/UntagResourceCommand.ts +++ b/clients/client-mediaconnect/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + * Deletes specified tags from a resource. + */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/UpdateFlowCommand.ts b/clients/client-mediaconnect/commands/UpdateFlowCommand.ts index 18453dec5abfe..14e3254f764bf 100644 --- a/clients/client-mediaconnect/commands/UpdateFlowCommand.ts +++ b/clients/client-mediaconnect/commands/UpdateFlowCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFlowCommandInput = UpdateFlowRequest; export type UpdateFlowCommandOutput = UpdateFlowResponse & __MetadataBearer; +/** + * Updates flow + */ export class UpdateFlowCommand extends $Command< UpdateFlowCommandInput, UpdateFlowCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFlowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/UpdateFlowEntitlementCommand.ts b/clients/client-mediaconnect/commands/UpdateFlowEntitlementCommand.ts index e999e980192df..ca2dd9a879d58 100644 --- a/clients/client-mediaconnect/commands/UpdateFlowEntitlementCommand.ts +++ b/clients/client-mediaconnect/commands/UpdateFlowEntitlementCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFlowEntitlementCommandInput = UpdateFlowEntitlementRequest; export type UpdateFlowEntitlementCommandOutput = UpdateFlowEntitlementResponse & __MetadataBearer; +/** + * You can change an entitlement's description, subscribers, and encryption. If you change the subscribers, the service will remove the outputs that are are used by the subscribers that are removed. + */ export class UpdateFlowEntitlementCommand extends $Command< UpdateFlowEntitlementCommandInput, UpdateFlowEntitlementCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFlowEntitlementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/UpdateFlowOutputCommand.ts b/clients/client-mediaconnect/commands/UpdateFlowOutputCommand.ts index 28efa22907bb7..c5d074eee0c9b 100644 --- a/clients/client-mediaconnect/commands/UpdateFlowOutputCommand.ts +++ b/clients/client-mediaconnect/commands/UpdateFlowOutputCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFlowOutputCommandInput = UpdateFlowOutputRequest; export type UpdateFlowOutputCommandOutput = UpdateFlowOutputResponse & __MetadataBearer; +/** + * Updates an existing flow output. + */ export class UpdateFlowOutputCommand extends $Command< UpdateFlowOutputCommandInput, UpdateFlowOutputCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFlowOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/commands/UpdateFlowSourceCommand.ts b/clients/client-mediaconnect/commands/UpdateFlowSourceCommand.ts index b38f02472c9d3..f7b1944e5d6ee 100644 --- a/clients/client-mediaconnect/commands/UpdateFlowSourceCommand.ts +++ b/clients/client-mediaconnect/commands/UpdateFlowSourceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFlowSourceCommandInput = UpdateFlowSourceRequest; export type UpdateFlowSourceCommandOutput = UpdateFlowSourceResponse & __MetadataBearer; +/** + * Updates the source of a flow. + */ export class UpdateFlowSourceCommand extends $Command< UpdateFlowSourceCommandInput, UpdateFlowSourceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFlowSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConnectClientResolvedConfig, diff --git a/clients/client-mediaconnect/package.json b/clients/client-mediaconnect/package.json index 2b12948313405..d5ab1048f8c41 100644 --- a/clients/client-mediaconnect/package.json +++ b/clients/client-mediaconnect/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mediaconnect Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mediaconnect/pagination/ListEntitlementsPaginator.ts b/clients/client-mediaconnect/pagination/ListEntitlementsPaginator.ts index c4787e203aba8..5c4207d79bc6b 100644 --- a/clients/client-mediaconnect/pagination/ListEntitlementsPaginator.ts +++ b/clients/client-mediaconnect/pagination/ListEntitlementsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConnectClient, input: ListEntitlementsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEntitlementsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConnect, input: ListEntitlementsCommandInput, diff --git a/clients/client-mediaconnect/pagination/ListFlowsPaginator.ts b/clients/client-mediaconnect/pagination/ListFlowsPaginator.ts index 5603aab2dc2f7..92e1fe14b35f3 100644 --- a/clients/client-mediaconnect/pagination/ListFlowsPaginator.ts +++ b/clients/client-mediaconnect/pagination/ListFlowsPaginator.ts @@ -4,6 +4,9 @@ import { ListFlowsCommand, ListFlowsCommandInput, ListFlowsCommandOutput } from import { MediaConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConnectClient, input: ListFlowsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFlowsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConnect, input: ListFlowsCommandInput, diff --git a/clients/client-mediaconnect/pagination/ListOfferingsPaginator.ts b/clients/client-mediaconnect/pagination/ListOfferingsPaginator.ts index 4fbea82dcd94d..855c37b9da000 100644 --- a/clients/client-mediaconnect/pagination/ListOfferingsPaginator.ts +++ b/clients/client-mediaconnect/pagination/ListOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConnectClient, input: ListOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConnect, input: ListOfferingsCommandInput, diff --git a/clients/client-mediaconnect/pagination/ListReservationsPaginator.ts b/clients/client-mediaconnect/pagination/ListReservationsPaginator.ts index 65577b05e06fc..f60300d839a3f 100644 --- a/clients/client-mediaconnect/pagination/ListReservationsPaginator.ts +++ b/clients/client-mediaconnect/pagination/ListReservationsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaConnectPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConnectClient, input: ListReservationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListReservationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConnect, input: ListReservationsCommandInput, diff --git a/clients/client-mediaconnect/runtimeConfig.browser.ts b/clients/client-mediaconnect/runtimeConfig.browser.ts index dfbb6197d3785..2c23d579d8f6f 100644 --- a/clients/client-mediaconnect/runtimeConfig.browser.ts +++ b/clients/client-mediaconnect/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MediaConnectClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mediaconnect/runtimeConfig.native.ts b/clients/client-mediaconnect/runtimeConfig.native.ts index d62c06c514bb7..5d0e362bb3e9b 100644 --- a/clients/client-mediaconnect/runtimeConfig.native.ts +++ b/clients/client-mediaconnect/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MediaConnectClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mediaconnect/runtimeConfig.shared.ts b/clients/client-mediaconnect/runtimeConfig.shared.ts index ebfef8e7c16b8..a8de79218f678 100644 --- a/clients/client-mediaconnect/runtimeConfig.shared.ts +++ b/clients/client-mediaconnect/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-14", disableHostPrefix: false, diff --git a/clients/client-mediaconnect/runtimeConfig.ts b/clients/client-mediaconnect/runtimeConfig.ts index dd3915ee9e1c4..50ee9f024cd24 100644 --- a/clients/client-mediaconnect/runtimeConfig.ts +++ b/clients/client-mediaconnect/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MediaConnectClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mediaconnect/tsconfig.json b/clients/client-mediaconnect/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mediaconnect/tsconfig.json +++ b/clients/client-mediaconnect/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mediaconvert/commands/AssociateCertificateCommand.ts b/clients/client-mediaconvert/commands/AssociateCertificateCommand.ts index 5ef4b3384708a..cbcccb5037e6f 100644 --- a/clients/client-mediaconvert/commands/AssociateCertificateCommand.ts +++ b/clients/client-mediaconvert/commands/AssociateCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateCertificateCommandInput = AssociateCertificateRequest; export type AssociateCertificateCommandOutput = AssociateCertificateResponse & __MetadataBearer; +/** + * Associates an AWS Certificate Manager (ACM) Amazon Resource Name (ARN) with AWS Elemental MediaConvert. + */ export class AssociateCertificateCommand extends $Command< AssociateCertificateCommandInput, AssociateCertificateCommandOutput, @@ -34,6 +37,9 @@ export class AssociateCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/CancelJobCommand.ts b/clients/client-mediaconvert/commands/CancelJobCommand.ts index 1e127239683f6..f461d714e8f71 100644 --- a/clients/client-mediaconvert/commands/CancelJobCommand.ts +++ b/clients/client-mediaconvert/commands/CancelJobCommand.ts @@ -20,6 +20,9 @@ import { export type CancelJobCommandInput = CancelJobRequest; export type CancelJobCommandOutput = CancelJobResponse & __MetadataBearer; +/** + * Permanently cancel a job. Once you have canceled a job, you can't start it again. + */ export class CancelJobCommand extends $Command< CancelJobCommandInput, CancelJobCommandOutput, @@ -34,6 +37,9 @@ export class CancelJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/CreateJobCommand.ts b/clients/client-mediaconvert/commands/CreateJobCommand.ts index 96ef2fea19262..1b1a3abd5134d 100644 --- a/clients/client-mediaconvert/commands/CreateJobCommand.ts +++ b/clients/client-mediaconvert/commands/CreateJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateJobCommandInput = CreateJobRequest; export type CreateJobCommandOutput = CreateJobResponse & __MetadataBearer; +/** + * Create a new transcoding job. For information about jobs and job settings, see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html + */ export class CreateJobCommand extends $Command< CreateJobCommandInput, CreateJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/CreateJobTemplateCommand.ts b/clients/client-mediaconvert/commands/CreateJobTemplateCommand.ts index f9c88bb39d7fa..c12fd51d23388 100644 --- a/clients/client-mediaconvert/commands/CreateJobTemplateCommand.ts +++ b/clients/client-mediaconvert/commands/CreateJobTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type CreateJobTemplateCommandInput = CreateJobTemplateRequest; export type CreateJobTemplateCommandOutput = CreateJobTemplateResponse & __MetadataBearer; +/** + * Create a new job template. For information about job templates see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html + */ export class CreateJobTemplateCommand extends $Command< CreateJobTemplateCommandInput, CreateJobTemplateCommandOutput, @@ -34,6 +37,9 @@ export class CreateJobTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/CreatePresetCommand.ts b/clients/client-mediaconvert/commands/CreatePresetCommand.ts index 573b6a05614a0..b2c6873d825e5 100644 --- a/clients/client-mediaconvert/commands/CreatePresetCommand.ts +++ b/clients/client-mediaconvert/commands/CreatePresetCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePresetCommandInput = CreatePresetRequest; export type CreatePresetCommandOutput = CreatePresetResponse & __MetadataBearer; +/** + * Create a new preset. For information about job templates see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html + */ export class CreatePresetCommand extends $Command< CreatePresetCommandInput, CreatePresetCommandOutput, @@ -34,6 +37,9 @@ export class CreatePresetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/CreateQueueCommand.ts b/clients/client-mediaconvert/commands/CreateQueueCommand.ts index 07f6c696981d4..ad9456c19dc04 100644 --- a/clients/client-mediaconvert/commands/CreateQueueCommand.ts +++ b/clients/client-mediaconvert/commands/CreateQueueCommand.ts @@ -20,6 +20,9 @@ import { export type CreateQueueCommandInput = CreateQueueRequest; export type CreateQueueCommandOutput = CreateQueueResponse & __MetadataBearer; +/** + * Create a new transcoding queue. For information about queues, see Working With Queues in the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html + */ export class CreateQueueCommand extends $Command< CreateQueueCommandInput, CreateQueueCommandOutput, @@ -34,6 +37,9 @@ export class CreateQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/DeleteJobTemplateCommand.ts b/clients/client-mediaconvert/commands/DeleteJobTemplateCommand.ts index 7fc115f20b25f..9d88f675d285f 100644 --- a/clients/client-mediaconvert/commands/DeleteJobTemplateCommand.ts +++ b/clients/client-mediaconvert/commands/DeleteJobTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteJobTemplateCommandInput = DeleteJobTemplateRequest; export type DeleteJobTemplateCommandOutput = DeleteJobTemplateResponse & __MetadataBearer; +/** + * Permanently delete a job template you have created. + */ export class DeleteJobTemplateCommand extends $Command< DeleteJobTemplateCommandInput, DeleteJobTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteJobTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/DeletePresetCommand.ts b/clients/client-mediaconvert/commands/DeletePresetCommand.ts index f808fb94929eb..ec134f96233f6 100644 --- a/clients/client-mediaconvert/commands/DeletePresetCommand.ts +++ b/clients/client-mediaconvert/commands/DeletePresetCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePresetCommandInput = DeletePresetRequest; export type DeletePresetCommandOutput = DeletePresetResponse & __MetadataBearer; +/** + * Permanently delete a preset you have created. + */ export class DeletePresetCommand extends $Command< DeletePresetCommandInput, DeletePresetCommandOutput, @@ -34,6 +37,9 @@ export class DeletePresetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/DeleteQueueCommand.ts b/clients/client-mediaconvert/commands/DeleteQueueCommand.ts index 122da2c6d271f..ae92032786be7 100644 --- a/clients/client-mediaconvert/commands/DeleteQueueCommand.ts +++ b/clients/client-mediaconvert/commands/DeleteQueueCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteQueueCommandInput = DeleteQueueRequest; export type DeleteQueueCommandOutput = DeleteQueueResponse & __MetadataBearer; +/** + * Permanently delete a queue you have created. + */ export class DeleteQueueCommand extends $Command< DeleteQueueCommandInput, DeleteQueueCommandOutput, @@ -34,6 +37,9 @@ export class DeleteQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/DescribeEndpointsCommand.ts b/clients/client-mediaconvert/commands/DescribeEndpointsCommand.ts index 21763fc967f07..afd1849936084 100644 --- a/clients/client-mediaconvert/commands/DescribeEndpointsCommand.ts +++ b/clients/client-mediaconvert/commands/DescribeEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEndpointsCommandInput = DescribeEndpointsRequest; export type DescribeEndpointsCommandOutput = DescribeEndpointsResponse & __MetadataBearer; +/** + * Send an request with an empty body to the regional API endpoint to get your account API endpoint. + */ export class DescribeEndpointsCommand extends $Command< DescribeEndpointsCommandInput, DescribeEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/DisassociateCertificateCommand.ts b/clients/client-mediaconvert/commands/DisassociateCertificateCommand.ts index e74ca009a16f3..a321230fd2feb 100644 --- a/clients/client-mediaconvert/commands/DisassociateCertificateCommand.ts +++ b/clients/client-mediaconvert/commands/DisassociateCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateCertificateCommandInput = DisassociateCertificateRequest; export type DisassociateCertificateCommandOutput = DisassociateCertificateResponse & __MetadataBearer; +/** + * Removes an association between the Amazon Resource Name (ARN) of an AWS Certificate Manager (ACM) certificate and an AWS Elemental MediaConvert resource. + */ export class DisassociateCertificateCommand extends $Command< DisassociateCertificateCommandInput, DisassociateCertificateCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/GetJobCommand.ts b/clients/client-mediaconvert/commands/GetJobCommand.ts index bcc7f591c5e00..9b63e02e288e1 100644 --- a/clients/client-mediaconvert/commands/GetJobCommand.ts +++ b/clients/client-mediaconvert/commands/GetJobCommand.ts @@ -17,6 +17,9 @@ import { export type GetJobCommandInput = GetJobRequest; export type GetJobCommandOutput = GetJobResponse & __MetadataBearer; +/** + * Retrieve the JSON for a specific completed transcoding job. + */ export class GetJobCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetJobCommand extends $Command, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/GetJobTemplateCommand.ts b/clients/client-mediaconvert/commands/GetJobTemplateCommand.ts index 27aa047e8b7f2..2b25fec696eea 100644 --- a/clients/client-mediaconvert/commands/GetJobTemplateCommand.ts +++ b/clients/client-mediaconvert/commands/GetJobTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetJobTemplateCommandInput = GetJobTemplateRequest; export type GetJobTemplateCommandOutput = GetJobTemplateResponse & __MetadataBearer; +/** + * Retrieve the JSON for a specific job template. + */ export class GetJobTemplateCommand extends $Command< GetJobTemplateCommandInput, GetJobTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetJobTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/GetPresetCommand.ts b/clients/client-mediaconvert/commands/GetPresetCommand.ts index cf36541353a45..2c211ceca526e 100644 --- a/clients/client-mediaconvert/commands/GetPresetCommand.ts +++ b/clients/client-mediaconvert/commands/GetPresetCommand.ts @@ -20,6 +20,9 @@ import { export type GetPresetCommandInput = GetPresetRequest; export type GetPresetCommandOutput = GetPresetResponse & __MetadataBearer; +/** + * Retrieve the JSON for a specific preset. + */ export class GetPresetCommand extends $Command< GetPresetCommandInput, GetPresetCommandOutput, @@ -34,6 +37,9 @@ export class GetPresetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/GetQueueCommand.ts b/clients/client-mediaconvert/commands/GetQueueCommand.ts index 893d954ae2591..37836415142c0 100644 --- a/clients/client-mediaconvert/commands/GetQueueCommand.ts +++ b/clients/client-mediaconvert/commands/GetQueueCommand.ts @@ -20,6 +20,9 @@ import { export type GetQueueCommandInput = GetQueueRequest; export type GetQueueCommandOutput = GetQueueResponse & __MetadataBearer; +/** + * Retrieve the JSON for a specific queue. + */ export class GetQueueCommand extends $Command< GetQueueCommandInput, GetQueueCommandOutput, @@ -34,6 +37,9 @@ export class GetQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/ListJobTemplatesCommand.ts b/clients/client-mediaconvert/commands/ListJobTemplatesCommand.ts index 1a3e76c69f47b..1821046861324 100644 --- a/clients/client-mediaconvert/commands/ListJobTemplatesCommand.ts +++ b/clients/client-mediaconvert/commands/ListJobTemplatesCommand.ts @@ -20,6 +20,9 @@ import { export type ListJobTemplatesCommandInput = ListJobTemplatesRequest; export type ListJobTemplatesCommandOutput = ListJobTemplatesResponse & __MetadataBearer; +/** + * Retrieve a JSON array of up to twenty of your job templates. This will return the templates themselves, not just a list of them. To retrieve the next twenty templates, use the nextToken string returned with the array + */ export class ListJobTemplatesCommand extends $Command< ListJobTemplatesCommandInput, ListJobTemplatesCommandOutput, @@ -34,6 +37,9 @@ export class ListJobTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/ListJobsCommand.ts b/clients/client-mediaconvert/commands/ListJobsCommand.ts index ccdad69a3d2e8..b675b2177d09e 100644 --- a/clients/client-mediaconvert/commands/ListJobsCommand.ts +++ b/clients/client-mediaconvert/commands/ListJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResponse & __MetadataBearer; +/** + * Retrieve a JSON array of up to twenty of your most recently created jobs. This array includes in-process, completed, and errored jobs. This will return the jobs themselves, not just a list of the jobs. To retrieve the twenty next most recent jobs, use the nextToken string returned with the array. + */ export class ListJobsCommand extends $Command< ListJobsCommandInput, ListJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/ListPresetsCommand.ts b/clients/client-mediaconvert/commands/ListPresetsCommand.ts index 271dcc3732879..8fd78f34ef434 100644 --- a/clients/client-mediaconvert/commands/ListPresetsCommand.ts +++ b/clients/client-mediaconvert/commands/ListPresetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPresetsCommandInput = ListPresetsRequest; export type ListPresetsCommandOutput = ListPresetsResponse & __MetadataBearer; +/** + * Retrieve a JSON array of up to twenty of your presets. This will return the presets themselves, not just a list of them. To retrieve the next twenty presets, use the nextToken string returned with the array. + */ export class ListPresetsCommand extends $Command< ListPresetsCommandInput, ListPresetsCommandOutput, @@ -34,6 +37,9 @@ export class ListPresetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/ListQueuesCommand.ts b/clients/client-mediaconvert/commands/ListQueuesCommand.ts index dd69561bcb657..ae3c258890916 100644 --- a/clients/client-mediaconvert/commands/ListQueuesCommand.ts +++ b/clients/client-mediaconvert/commands/ListQueuesCommand.ts @@ -20,6 +20,9 @@ import { export type ListQueuesCommandInput = ListQueuesRequest; export type ListQueuesCommandOutput = ListQueuesResponse & __MetadataBearer; +/** + * Retrieve a JSON array of up to twenty of your queues. This will return the queues themselves, not just a list of them. To retrieve the next twenty queues, use the nextToken string returned with the array. + */ export class ListQueuesCommand extends $Command< ListQueuesCommandInput, ListQueuesCommandOutput, @@ -34,6 +37,9 @@ export class ListQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/ListTagsForResourceCommand.ts b/clients/client-mediaconvert/commands/ListTagsForResourceCommand.ts index 5a8ff15f5af9d..9aa7568906565 100644 --- a/clients/client-mediaconvert/commands/ListTagsForResourceCommand.ts +++ b/clients/client-mediaconvert/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + * Retrieve the tags for a MediaConvert resource. + */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/TagResourceCommand.ts b/clients/client-mediaconvert/commands/TagResourceCommand.ts index 3e09146a9a74b..13c14202977fd 100644 --- a/clients/client-mediaconvert/commands/TagResourceCommand.ts +++ b/clients/client-mediaconvert/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + * Add tags to a MediaConvert queue, preset, or job template. For information about tagging, see the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-resources.html + */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/UntagResourceCommand.ts b/clients/client-mediaconvert/commands/UntagResourceCommand.ts index 90cf14753d21a..a7281ed2d4062 100644 --- a/clients/client-mediaconvert/commands/UntagResourceCommand.ts +++ b/clients/client-mediaconvert/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + * Remove tags from a MediaConvert queue, preset, or job template. For information about tagging, see the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-resources.html + */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/UpdateJobTemplateCommand.ts b/clients/client-mediaconvert/commands/UpdateJobTemplateCommand.ts index 9b0f16ddf0ba5..3f27f56fe8880 100644 --- a/clients/client-mediaconvert/commands/UpdateJobTemplateCommand.ts +++ b/clients/client-mediaconvert/commands/UpdateJobTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateJobTemplateCommandInput = UpdateJobTemplateRequest; export type UpdateJobTemplateCommandOutput = UpdateJobTemplateResponse & __MetadataBearer; +/** + * Modify one of your existing job templates. + */ export class UpdateJobTemplateCommand extends $Command< UpdateJobTemplateCommandInput, UpdateJobTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateJobTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/UpdatePresetCommand.ts b/clients/client-mediaconvert/commands/UpdatePresetCommand.ts index 9ca357c45a3ec..2d2641bd3fa52 100644 --- a/clients/client-mediaconvert/commands/UpdatePresetCommand.ts +++ b/clients/client-mediaconvert/commands/UpdatePresetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePresetCommandInput = UpdatePresetRequest; export type UpdatePresetCommandOutput = UpdatePresetResponse & __MetadataBearer; +/** + * Modify one of your existing presets. + */ export class UpdatePresetCommand extends $Command< UpdatePresetCommandInput, UpdatePresetCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePresetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/commands/UpdateQueueCommand.ts b/clients/client-mediaconvert/commands/UpdateQueueCommand.ts index 318e620055f99..5d14ee7889efd 100644 --- a/clients/client-mediaconvert/commands/UpdateQueueCommand.ts +++ b/clients/client-mediaconvert/commands/UpdateQueueCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateQueueCommandInput = UpdateQueueRequest; export type UpdateQueueCommandOutput = UpdateQueueResponse & __MetadataBearer; +/** + * Modify one of your existing queues. + */ export class UpdateQueueCommand extends $Command< UpdateQueueCommandInput, UpdateQueueCommandOutput, @@ -34,6 +37,9 @@ export class UpdateQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaConvertClientResolvedConfig, diff --git a/clients/client-mediaconvert/package.json b/clients/client-mediaconvert/package.json index 96d65d255f9bc..c3d635085594f 100644 --- a/clients/client-mediaconvert/package.json +++ b/clients/client-mediaconvert/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mediaconvert Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mediaconvert/pagination/DescribeEndpointsPaginator.ts b/clients/client-mediaconvert/pagination/DescribeEndpointsPaginator.ts index 76128b2144ae8..1f75222c9ed6f 100644 --- a/clients/client-mediaconvert/pagination/DescribeEndpointsPaginator.ts +++ b/clients/client-mediaconvert/pagination/DescribeEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaConvertPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConvertClient, input: DescribeEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConvert, input: DescribeEndpointsCommandInput, diff --git a/clients/client-mediaconvert/pagination/ListJobTemplatesPaginator.ts b/clients/client-mediaconvert/pagination/ListJobTemplatesPaginator.ts index 5977be4218dba..af7ac962549f3 100644 --- a/clients/client-mediaconvert/pagination/ListJobTemplatesPaginator.ts +++ b/clients/client-mediaconvert/pagination/ListJobTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaConvertPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConvertClient, input: ListJobTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConvert, input: ListJobTemplatesCommandInput, diff --git a/clients/client-mediaconvert/pagination/ListJobsPaginator.ts b/clients/client-mediaconvert/pagination/ListJobsPaginator.ts index 73011b1b0c79c..67bc21f0d496e 100644 --- a/clients/client-mediaconvert/pagination/ListJobsPaginator.ts +++ b/clients/client-mediaconvert/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { MediaConvertPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConvertClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConvert, input: ListJobsCommandInput, diff --git a/clients/client-mediaconvert/pagination/ListPresetsPaginator.ts b/clients/client-mediaconvert/pagination/ListPresetsPaginator.ts index 1e499ec5dd719..2f68dfc0f8cd8 100644 --- a/clients/client-mediaconvert/pagination/ListPresetsPaginator.ts +++ b/clients/client-mediaconvert/pagination/ListPresetsPaginator.ts @@ -4,6 +4,9 @@ import { ListPresetsCommand, ListPresetsCommandInput, ListPresetsCommandOutput } import { MediaConvertPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConvertClient, input: ListPresetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPresetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConvert, input: ListPresetsCommandInput, diff --git a/clients/client-mediaconvert/pagination/ListQueuesPaginator.ts b/clients/client-mediaconvert/pagination/ListQueuesPaginator.ts index b63a8158c2ead..ecbd0a8d848bd 100644 --- a/clients/client-mediaconvert/pagination/ListQueuesPaginator.ts +++ b/clients/client-mediaconvert/pagination/ListQueuesPaginator.ts @@ -4,6 +4,9 @@ import { ListQueuesCommand, ListQueuesCommandInput, ListQueuesCommandOutput } fr import { MediaConvertPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaConvertClient, input: ListQueuesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListQueuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaConvert, input: ListQueuesCommandInput, diff --git a/clients/client-mediaconvert/runtimeConfig.browser.ts b/clients/client-mediaconvert/runtimeConfig.browser.ts index 853061919e884..ce4cf5f2e763e 100644 --- a/clients/client-mediaconvert/runtimeConfig.browser.ts +++ b/clients/client-mediaconvert/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MediaConvertClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mediaconvert/runtimeConfig.native.ts b/clients/client-mediaconvert/runtimeConfig.native.ts index 43dc67dbac26c..9f886f7722f6c 100644 --- a/clients/client-mediaconvert/runtimeConfig.native.ts +++ b/clients/client-mediaconvert/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MediaConvertClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mediaconvert/runtimeConfig.shared.ts b/clients/client-mediaconvert/runtimeConfig.shared.ts index ded3169d66ccd..2bf766a894958 100644 --- a/clients/client-mediaconvert/runtimeConfig.shared.ts +++ b/clients/client-mediaconvert/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-08-29", disableHostPrefix: false, diff --git a/clients/client-mediaconvert/runtimeConfig.ts b/clients/client-mediaconvert/runtimeConfig.ts index 5fe648366d6b5..c51e53d7ae3f2 100644 --- a/clients/client-mediaconvert/runtimeConfig.ts +++ b/clients/client-mediaconvert/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MediaConvertClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mediaconvert/tsconfig.json b/clients/client-mediaconvert/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mediaconvert/tsconfig.json +++ b/clients/client-mediaconvert/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-medialive/commands/AcceptInputDeviceTransferCommand.ts b/clients/client-medialive/commands/AcceptInputDeviceTransferCommand.ts index 961f59bd9e9ea..b4935cf5d38ab 100644 --- a/clients/client-medialive/commands/AcceptInputDeviceTransferCommand.ts +++ b/clients/client-medialive/commands/AcceptInputDeviceTransferCommand.ts @@ -20,6 +20,9 @@ import { export type AcceptInputDeviceTransferCommandInput = AcceptInputDeviceTransferRequest; export type AcceptInputDeviceTransferCommandOutput = AcceptInputDeviceTransferResponse & __MetadataBearer; +/** + * Accept an incoming input device transfer. The ownership of the device will transfer to your AWS account. + */ export class AcceptInputDeviceTransferCommand extends $Command< AcceptInputDeviceTransferCommandInput, AcceptInputDeviceTransferCommandOutput, @@ -34,6 +37,9 @@ export class AcceptInputDeviceTransferCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/BatchDeleteCommand.ts b/clients/client-medialive/commands/BatchDeleteCommand.ts index ca0ac391b267a..ddab4e2b00f54 100644 --- a/clients/client-medialive/commands/BatchDeleteCommand.ts +++ b/clients/client-medialive/commands/BatchDeleteCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeleteCommandInput = BatchDeleteRequest; export type BatchDeleteCommandOutput = BatchDeleteResponse & __MetadataBearer; +/** + * Starts delete of resources. + */ export class BatchDeleteCommand extends $Command< BatchDeleteCommandInput, BatchDeleteCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeleteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/BatchStartCommand.ts b/clients/client-medialive/commands/BatchStartCommand.ts index 4ec7d72962a20..4da15e035337c 100644 --- a/clients/client-medialive/commands/BatchStartCommand.ts +++ b/clients/client-medialive/commands/BatchStartCommand.ts @@ -20,6 +20,9 @@ import { export type BatchStartCommandInput = BatchStartRequest; export type BatchStartCommandOutput = BatchStartResponse & __MetadataBearer; +/** + * Starts existing resources + */ export class BatchStartCommand extends $Command< BatchStartCommandInput, BatchStartCommandOutput, @@ -34,6 +37,9 @@ export class BatchStartCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/BatchStopCommand.ts b/clients/client-medialive/commands/BatchStopCommand.ts index a788ee3bffd90..0d962645fae34 100644 --- a/clients/client-medialive/commands/BatchStopCommand.ts +++ b/clients/client-medialive/commands/BatchStopCommand.ts @@ -20,6 +20,9 @@ import { export type BatchStopCommandInput = BatchStopRequest; export type BatchStopCommandOutput = BatchStopResponse & __MetadataBearer; +/** + * Stops running resources + */ export class BatchStopCommand extends $Command< BatchStopCommandInput, BatchStopCommandOutput, @@ -34,6 +37,9 @@ export class BatchStopCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/BatchUpdateScheduleCommand.ts b/clients/client-medialive/commands/BatchUpdateScheduleCommand.ts index af2589b690b2c..386915995c886 100644 --- a/clients/client-medialive/commands/BatchUpdateScheduleCommand.ts +++ b/clients/client-medialive/commands/BatchUpdateScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type BatchUpdateScheduleCommandInput = BatchUpdateScheduleRequest; export type BatchUpdateScheduleCommandOutput = BatchUpdateScheduleResponse & __MetadataBearer; +/** + * Update a channel schedule + */ export class BatchUpdateScheduleCommand extends $Command< BatchUpdateScheduleCommandInput, BatchUpdateScheduleCommandOutput, @@ -34,6 +37,9 @@ export class BatchUpdateScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/CancelInputDeviceTransferCommand.ts b/clients/client-medialive/commands/CancelInputDeviceTransferCommand.ts index 65fc1bfb2bc0c..2523a685e5fc0 100644 --- a/clients/client-medialive/commands/CancelInputDeviceTransferCommand.ts +++ b/clients/client-medialive/commands/CancelInputDeviceTransferCommand.ts @@ -20,6 +20,9 @@ import { export type CancelInputDeviceTransferCommandInput = CancelInputDeviceTransferRequest; export type CancelInputDeviceTransferCommandOutput = CancelInputDeviceTransferResponse & __MetadataBearer; +/** + * Cancel an input device transfer that you have requested. + */ export class CancelInputDeviceTransferCommand extends $Command< CancelInputDeviceTransferCommandInput, CancelInputDeviceTransferCommandOutput, @@ -34,6 +37,9 @@ export class CancelInputDeviceTransferCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/CreateChannelCommand.ts b/clients/client-medialive/commands/CreateChannelCommand.ts index b887d5b567c0a..9c34fd8d0d2d1 100644 --- a/clients/client-medialive/commands/CreateChannelCommand.ts +++ b/clients/client-medialive/commands/CreateChannelCommand.ts @@ -20,6 +20,9 @@ import { export type CreateChannelCommandInput = CreateChannelRequest; export type CreateChannelCommandOutput = CreateChannelResponse & __MetadataBearer; +/** + * Creates a new channel + */ export class CreateChannelCommand extends $Command< CreateChannelCommandInput, CreateChannelCommandOutput, @@ -34,6 +37,9 @@ export class CreateChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/CreateInputCommand.ts b/clients/client-medialive/commands/CreateInputCommand.ts index ef1c7dee82f75..50216b277ca85 100644 --- a/clients/client-medialive/commands/CreateInputCommand.ts +++ b/clients/client-medialive/commands/CreateInputCommand.ts @@ -20,6 +20,9 @@ import { export type CreateInputCommandInput = CreateInputRequest; export type CreateInputCommandOutput = CreateInputResponse & __MetadataBearer; +/** + * Create an input + */ export class CreateInputCommand extends $Command< CreateInputCommandInput, CreateInputCommandOutput, @@ -34,6 +37,9 @@ export class CreateInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/CreateInputSecurityGroupCommand.ts b/clients/client-medialive/commands/CreateInputSecurityGroupCommand.ts index ac6aedcada2e3..77bdde879171d 100644 --- a/clients/client-medialive/commands/CreateInputSecurityGroupCommand.ts +++ b/clients/client-medialive/commands/CreateInputSecurityGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateInputSecurityGroupCommandInput = CreateInputSecurityGroupRequest; export type CreateInputSecurityGroupCommandOutput = CreateInputSecurityGroupResponse & __MetadataBearer; +/** + * Creates a Input Security Group + */ export class CreateInputSecurityGroupCommand extends $Command< CreateInputSecurityGroupCommandInput, CreateInputSecurityGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateInputSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/CreateMultiplexCommand.ts b/clients/client-medialive/commands/CreateMultiplexCommand.ts index 2ba6c57553ac4..c64294913c4fd 100644 --- a/clients/client-medialive/commands/CreateMultiplexCommand.ts +++ b/clients/client-medialive/commands/CreateMultiplexCommand.ts @@ -20,6 +20,9 @@ import { export type CreateMultiplexCommandInput = CreateMultiplexRequest; export type CreateMultiplexCommandOutput = CreateMultiplexResponse & __MetadataBearer; +/** + * Create a new multiplex. + */ export class CreateMultiplexCommand extends $Command< CreateMultiplexCommandInput, CreateMultiplexCommandOutput, @@ -34,6 +37,9 @@ export class CreateMultiplexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/CreateMultiplexProgramCommand.ts b/clients/client-medialive/commands/CreateMultiplexProgramCommand.ts index c661799131196..3b2ed168cfd6a 100644 --- a/clients/client-medialive/commands/CreateMultiplexProgramCommand.ts +++ b/clients/client-medialive/commands/CreateMultiplexProgramCommand.ts @@ -20,6 +20,9 @@ import { export type CreateMultiplexProgramCommandInput = CreateMultiplexProgramRequest; export type CreateMultiplexProgramCommandOutput = CreateMultiplexProgramResponse & __MetadataBearer; +/** + * Create a new program in the multiplex. + */ export class CreateMultiplexProgramCommand extends $Command< CreateMultiplexProgramCommandInput, CreateMultiplexProgramCommandOutput, @@ -34,6 +37,9 @@ export class CreateMultiplexProgramCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/CreateTagsCommand.ts b/clients/client-medialive/commands/CreateTagsCommand.ts index 51cd7f5e1249b..94c05ef910892 100644 --- a/clients/client-medialive/commands/CreateTagsCommand.ts +++ b/clients/client-medialive/commands/CreateTagsCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTagsCommandInput = CreateTagsRequest; export type CreateTagsCommandOutput = __MetadataBearer; +/** + * Create tags for a resource + */ export class CreateTagsCommand extends $Command< CreateTagsCommandInput, CreateTagsCommandOutput, @@ -34,6 +37,9 @@ export class CreateTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DeleteChannelCommand.ts b/clients/client-medialive/commands/DeleteChannelCommand.ts index e3596e5e0d1fc..be62ed18ae656 100644 --- a/clients/client-medialive/commands/DeleteChannelCommand.ts +++ b/clients/client-medialive/commands/DeleteChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteChannelCommandInput = DeleteChannelRequest; export type DeleteChannelCommandOutput = DeleteChannelResponse & __MetadataBearer; +/** + * Starts deletion of channel. The associated outputs are also deleted. + */ export class DeleteChannelCommand extends $Command< DeleteChannelCommandInput, DeleteChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DeleteInputCommand.ts b/clients/client-medialive/commands/DeleteInputCommand.ts index 7085745de2fb6..d11420055e2ff 100644 --- a/clients/client-medialive/commands/DeleteInputCommand.ts +++ b/clients/client-medialive/commands/DeleteInputCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteInputCommandInput = DeleteInputRequest; export type DeleteInputCommandOutput = DeleteInputResponse & __MetadataBearer; +/** + * Deletes the input end point + */ export class DeleteInputCommand extends $Command< DeleteInputCommandInput, DeleteInputCommandOutput, @@ -34,6 +37,9 @@ export class DeleteInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DeleteInputSecurityGroupCommand.ts b/clients/client-medialive/commands/DeleteInputSecurityGroupCommand.ts index 0d3c8cc287b48..4a244df07045b 100644 --- a/clients/client-medialive/commands/DeleteInputSecurityGroupCommand.ts +++ b/clients/client-medialive/commands/DeleteInputSecurityGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteInputSecurityGroupCommandInput = DeleteInputSecurityGroupRequest; export type DeleteInputSecurityGroupCommandOutput = DeleteInputSecurityGroupResponse & __MetadataBearer; +/** + * Deletes an Input Security Group + */ export class DeleteInputSecurityGroupCommand extends $Command< DeleteInputSecurityGroupCommandInput, DeleteInputSecurityGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteInputSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DeleteMultiplexCommand.ts b/clients/client-medialive/commands/DeleteMultiplexCommand.ts index 21bf6fc9fe057..a4630439e5b37 100644 --- a/clients/client-medialive/commands/DeleteMultiplexCommand.ts +++ b/clients/client-medialive/commands/DeleteMultiplexCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMultiplexCommandInput = DeleteMultiplexRequest; export type DeleteMultiplexCommandOutput = DeleteMultiplexResponse & __MetadataBearer; +/** + * Delete a multiplex. The multiplex must be idle. + */ export class DeleteMultiplexCommand extends $Command< DeleteMultiplexCommandInput, DeleteMultiplexCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMultiplexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DeleteMultiplexProgramCommand.ts b/clients/client-medialive/commands/DeleteMultiplexProgramCommand.ts index dc25999e40c02..568b187cef8d5 100644 --- a/clients/client-medialive/commands/DeleteMultiplexProgramCommand.ts +++ b/clients/client-medialive/commands/DeleteMultiplexProgramCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMultiplexProgramCommandInput = DeleteMultiplexProgramRequest; export type DeleteMultiplexProgramCommandOutput = DeleteMultiplexProgramResponse & __MetadataBearer; +/** + * Delete a program from a multiplex. + */ export class DeleteMultiplexProgramCommand extends $Command< DeleteMultiplexProgramCommandInput, DeleteMultiplexProgramCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMultiplexProgramCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DeleteReservationCommand.ts b/clients/client-medialive/commands/DeleteReservationCommand.ts index ae50e4fecb0e8..dce20354eaa57 100644 --- a/clients/client-medialive/commands/DeleteReservationCommand.ts +++ b/clients/client-medialive/commands/DeleteReservationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteReservationCommandInput = DeleteReservationRequest; export type DeleteReservationCommandOutput = DeleteReservationResponse & __MetadataBearer; +/** + * Delete an expired reservation. + */ export class DeleteReservationCommand extends $Command< DeleteReservationCommandInput, DeleteReservationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DeleteScheduleCommand.ts b/clients/client-medialive/commands/DeleteScheduleCommand.ts index a58ce9848ae7a..ebe1be6d0ade6 100644 --- a/clients/client-medialive/commands/DeleteScheduleCommand.ts +++ b/clients/client-medialive/commands/DeleteScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteScheduleCommandInput = DeleteScheduleRequest; export type DeleteScheduleCommandOutput = DeleteScheduleResponse & __MetadataBearer; +/** + * Delete all schedule actions on a channel. + */ export class DeleteScheduleCommand extends $Command< DeleteScheduleCommandInput, DeleteScheduleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DeleteTagsCommand.ts b/clients/client-medialive/commands/DeleteTagsCommand.ts index 1ea7c3fea01d1..3b3676f57b2d5 100644 --- a/clients/client-medialive/commands/DeleteTagsCommand.ts +++ b/clients/client-medialive/commands/DeleteTagsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTagsCommandInput = DeleteTagsRequest; export type DeleteTagsCommandOutput = __MetadataBearer; +/** + * Removes tags for a resource + */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeChannelCommand.ts b/clients/client-medialive/commands/DescribeChannelCommand.ts index 5fbd06539f365..00ed11eab4b63 100644 --- a/clients/client-medialive/commands/DescribeChannelCommand.ts +++ b/clients/client-medialive/commands/DescribeChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeChannelCommandInput = DescribeChannelRequest; export type DescribeChannelCommandOutput = DescribeChannelResponse & __MetadataBearer; +/** + * Gets details about a channel + */ export class DescribeChannelCommand extends $Command< DescribeChannelCommandInput, DescribeChannelCommandOutput, @@ -34,6 +37,9 @@ export class DescribeChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeInputCommand.ts b/clients/client-medialive/commands/DescribeInputCommand.ts index a4c0fbdcfe5f8..837ebffc8b4c9 100644 --- a/clients/client-medialive/commands/DescribeInputCommand.ts +++ b/clients/client-medialive/commands/DescribeInputCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInputCommandInput = DescribeInputRequest; export type DescribeInputCommandOutput = DescribeInputResponse & __MetadataBearer; +/** + * Produces details about an input + */ export class DescribeInputCommand extends $Command< DescribeInputCommandInput, DescribeInputCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeInputDeviceCommand.ts b/clients/client-medialive/commands/DescribeInputDeviceCommand.ts index 6b1931a7cf660..1eb7e07db555b 100644 --- a/clients/client-medialive/commands/DescribeInputDeviceCommand.ts +++ b/clients/client-medialive/commands/DescribeInputDeviceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInputDeviceCommandInput = DescribeInputDeviceRequest; export type DescribeInputDeviceCommandOutput = DescribeInputDeviceResponse & __MetadataBearer; +/** + * Gets the details for the input device + */ export class DescribeInputDeviceCommand extends $Command< DescribeInputDeviceCommandInput, DescribeInputDeviceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInputDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeInputDeviceThumbnailCommand.ts b/clients/client-medialive/commands/DescribeInputDeviceThumbnailCommand.ts index 40b4fa2a8d845..e3e3d00415f51 100644 --- a/clients/client-medialive/commands/DescribeInputDeviceThumbnailCommand.ts +++ b/clients/client-medialive/commands/DescribeInputDeviceThumbnailCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInputDeviceThumbnailCommandInput = DescribeInputDeviceThumbnailRequest; export type DescribeInputDeviceThumbnailCommandOutput = DescribeInputDeviceThumbnailResponse & __MetadataBearer; +/** + * Get the latest thumbnail data for the input device. + */ export class DescribeInputDeviceThumbnailCommand extends $Command< DescribeInputDeviceThumbnailCommandInput, DescribeInputDeviceThumbnailCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInputDeviceThumbnailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeInputSecurityGroupCommand.ts b/clients/client-medialive/commands/DescribeInputSecurityGroupCommand.ts index 99249a474e089..ef4953eba69e2 100644 --- a/clients/client-medialive/commands/DescribeInputSecurityGroupCommand.ts +++ b/clients/client-medialive/commands/DescribeInputSecurityGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInputSecurityGroupCommandInput = DescribeInputSecurityGroupRequest; export type DescribeInputSecurityGroupCommandOutput = DescribeInputSecurityGroupResponse & __MetadataBearer; +/** + * Produces a summary of an Input Security Group + */ export class DescribeInputSecurityGroupCommand extends $Command< DescribeInputSecurityGroupCommandInput, DescribeInputSecurityGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInputSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeMultiplexCommand.ts b/clients/client-medialive/commands/DescribeMultiplexCommand.ts index f768e6d7e39dc..e7c1656a4ac40 100644 --- a/clients/client-medialive/commands/DescribeMultiplexCommand.ts +++ b/clients/client-medialive/commands/DescribeMultiplexCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMultiplexCommandInput = DescribeMultiplexRequest; export type DescribeMultiplexCommandOutput = DescribeMultiplexResponse & __MetadataBearer; +/** + * Gets details about a multiplex. + */ export class DescribeMultiplexCommand extends $Command< DescribeMultiplexCommandInput, DescribeMultiplexCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMultiplexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeMultiplexProgramCommand.ts b/clients/client-medialive/commands/DescribeMultiplexProgramCommand.ts index 44bbe1d7860cf..19db5e9b2baf4 100644 --- a/clients/client-medialive/commands/DescribeMultiplexProgramCommand.ts +++ b/clients/client-medialive/commands/DescribeMultiplexProgramCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMultiplexProgramCommandInput = DescribeMultiplexProgramRequest; export type DescribeMultiplexProgramCommandOutput = DescribeMultiplexProgramResponse & __MetadataBearer; +/** + * Get the details for a program in a multiplex. + */ export class DescribeMultiplexProgramCommand extends $Command< DescribeMultiplexProgramCommandInput, DescribeMultiplexProgramCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMultiplexProgramCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeOfferingCommand.ts b/clients/client-medialive/commands/DescribeOfferingCommand.ts index f66506fd6b9a6..b8b22ef7237c7 100644 --- a/clients/client-medialive/commands/DescribeOfferingCommand.ts +++ b/clients/client-medialive/commands/DescribeOfferingCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOfferingCommandInput = DescribeOfferingRequest; export type DescribeOfferingCommandOutput = DescribeOfferingResponse & __MetadataBearer; +/** + * Get details for an offering. + */ export class DescribeOfferingCommand extends $Command< DescribeOfferingCommandInput, DescribeOfferingCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeReservationCommand.ts b/clients/client-medialive/commands/DescribeReservationCommand.ts index 20a4201ab0d82..9cef6c1ed573b 100644 --- a/clients/client-medialive/commands/DescribeReservationCommand.ts +++ b/clients/client-medialive/commands/DescribeReservationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeReservationCommandInput = DescribeReservationRequest; export type DescribeReservationCommandOutput = DescribeReservationResponse & __MetadataBearer; +/** + * Get details for a reservation. + */ export class DescribeReservationCommand extends $Command< DescribeReservationCommandInput, DescribeReservationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/DescribeScheduleCommand.ts b/clients/client-medialive/commands/DescribeScheduleCommand.ts index 86f0e2fbf70c9..1c8cb1000a81d 100644 --- a/clients/client-medialive/commands/DescribeScheduleCommand.ts +++ b/clients/client-medialive/commands/DescribeScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeScheduleCommandInput = DescribeScheduleRequest; export type DescribeScheduleCommandOutput = DescribeScheduleResponse & __MetadataBearer; +/** + * Get a channel schedule + */ export class DescribeScheduleCommand extends $Command< DescribeScheduleCommandInput, DescribeScheduleCommandOutput, @@ -34,6 +37,9 @@ export class DescribeScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListChannelsCommand.ts b/clients/client-medialive/commands/ListChannelsCommand.ts index 01ed849d17ba1..206c497c24237 100644 --- a/clients/client-medialive/commands/ListChannelsCommand.ts +++ b/clients/client-medialive/commands/ListChannelsCommand.ts @@ -20,6 +20,9 @@ import { export type ListChannelsCommandInput = ListChannelsRequest; export type ListChannelsCommandOutput = ListChannelsResponse & __MetadataBearer; +/** + * Produces list of channels that have been created + */ export class ListChannelsCommand extends $Command< ListChannelsCommandInput, ListChannelsCommandOutput, @@ -34,6 +37,9 @@ export class ListChannelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListInputDeviceTransfersCommand.ts b/clients/client-medialive/commands/ListInputDeviceTransfersCommand.ts index be16937fedf8c..dec93db34955f 100644 --- a/clients/client-medialive/commands/ListInputDeviceTransfersCommand.ts +++ b/clients/client-medialive/commands/ListInputDeviceTransfersCommand.ts @@ -20,6 +20,9 @@ import { export type ListInputDeviceTransfersCommandInput = ListInputDeviceTransfersRequest; export type ListInputDeviceTransfersCommandOutput = ListInputDeviceTransfersResponse & __MetadataBearer; +/** + * List input devices that are currently being transferred. List input devices that you are transferring from your AWS account or input devices that another AWS account is transferring to you. + */ export class ListInputDeviceTransfersCommand extends $Command< ListInputDeviceTransfersCommandInput, ListInputDeviceTransfersCommandOutput, @@ -34,6 +37,9 @@ export class ListInputDeviceTransfersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListInputDevicesCommand.ts b/clients/client-medialive/commands/ListInputDevicesCommand.ts index b14678669ca66..6d3772f471e79 100644 --- a/clients/client-medialive/commands/ListInputDevicesCommand.ts +++ b/clients/client-medialive/commands/ListInputDevicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListInputDevicesCommandInput = ListInputDevicesRequest; export type ListInputDevicesCommandOutput = ListInputDevicesResponse & __MetadataBearer; +/** + * List input devices + */ export class ListInputDevicesCommand extends $Command< ListInputDevicesCommandInput, ListInputDevicesCommandOutput, @@ -34,6 +37,9 @@ export class ListInputDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListInputSecurityGroupsCommand.ts b/clients/client-medialive/commands/ListInputSecurityGroupsCommand.ts index ee2b6d06a9849..8e697921b93eb 100644 --- a/clients/client-medialive/commands/ListInputSecurityGroupsCommand.ts +++ b/clients/client-medialive/commands/ListInputSecurityGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListInputSecurityGroupsCommandInput = ListInputSecurityGroupsRequest; export type ListInputSecurityGroupsCommandOutput = ListInputSecurityGroupsResponse & __MetadataBearer; +/** + * Produces a list of Input Security Groups for an account + */ export class ListInputSecurityGroupsCommand extends $Command< ListInputSecurityGroupsCommandInput, ListInputSecurityGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListInputSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListInputsCommand.ts b/clients/client-medialive/commands/ListInputsCommand.ts index f83cb580000a1..d4fb1b1f9191b 100644 --- a/clients/client-medialive/commands/ListInputsCommand.ts +++ b/clients/client-medialive/commands/ListInputsCommand.ts @@ -20,6 +20,9 @@ import { export type ListInputsCommandInput = ListInputsRequest; export type ListInputsCommandOutput = ListInputsResponse & __MetadataBearer; +/** + * Produces list of inputs that have been created + */ export class ListInputsCommand extends $Command< ListInputsCommandInput, ListInputsCommandOutput, @@ -34,6 +37,9 @@ export class ListInputsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListMultiplexProgramsCommand.ts b/clients/client-medialive/commands/ListMultiplexProgramsCommand.ts index 2bcf04d1bf6bd..46a35968fd6c6 100644 --- a/clients/client-medialive/commands/ListMultiplexProgramsCommand.ts +++ b/clients/client-medialive/commands/ListMultiplexProgramsCommand.ts @@ -20,6 +20,9 @@ import { export type ListMultiplexProgramsCommandInput = ListMultiplexProgramsRequest; export type ListMultiplexProgramsCommandOutput = ListMultiplexProgramsResponse & __MetadataBearer; +/** + * List the programs that currently exist for a specific multiplex. + */ export class ListMultiplexProgramsCommand extends $Command< ListMultiplexProgramsCommandInput, ListMultiplexProgramsCommandOutput, @@ -34,6 +37,9 @@ export class ListMultiplexProgramsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListMultiplexesCommand.ts b/clients/client-medialive/commands/ListMultiplexesCommand.ts index e3e484807d484..79d9be1931f3c 100644 --- a/clients/client-medialive/commands/ListMultiplexesCommand.ts +++ b/clients/client-medialive/commands/ListMultiplexesCommand.ts @@ -20,6 +20,9 @@ import { export type ListMultiplexesCommandInput = ListMultiplexesRequest; export type ListMultiplexesCommandOutput = ListMultiplexesResponse & __MetadataBearer; +/** + * Retrieve a list of the existing multiplexes. + */ export class ListMultiplexesCommand extends $Command< ListMultiplexesCommandInput, ListMultiplexesCommandOutput, @@ -34,6 +37,9 @@ export class ListMultiplexesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListOfferingsCommand.ts b/clients/client-medialive/commands/ListOfferingsCommand.ts index 33945cf74f0a8..55affcababe1e 100644 --- a/clients/client-medialive/commands/ListOfferingsCommand.ts +++ b/clients/client-medialive/commands/ListOfferingsCommand.ts @@ -20,6 +20,9 @@ import { export type ListOfferingsCommandInput = ListOfferingsRequest; export type ListOfferingsCommandOutput = ListOfferingsResponse & __MetadataBearer; +/** + * List offerings available for purchase. + */ export class ListOfferingsCommand extends $Command< ListOfferingsCommandInput, ListOfferingsCommandOutput, @@ -34,6 +37,9 @@ export class ListOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListReservationsCommand.ts b/clients/client-medialive/commands/ListReservationsCommand.ts index 78046c32334c9..1037b65b4252c 100644 --- a/clients/client-medialive/commands/ListReservationsCommand.ts +++ b/clients/client-medialive/commands/ListReservationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListReservationsCommandInput = ListReservationsRequest; export type ListReservationsCommandOutput = ListReservationsResponse & __MetadataBearer; +/** + * List purchased reservations. + */ export class ListReservationsCommand extends $Command< ListReservationsCommandInput, ListReservationsCommandOutput, @@ -34,6 +37,9 @@ export class ListReservationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/ListTagsForResourceCommand.ts b/clients/client-medialive/commands/ListTagsForResourceCommand.ts index e5a256594e767..8501b6342a782 100644 --- a/clients/client-medialive/commands/ListTagsForResourceCommand.ts +++ b/clients/client-medialive/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + * Produces list of tags that have been created for a resource + */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/PurchaseOfferingCommand.ts b/clients/client-medialive/commands/PurchaseOfferingCommand.ts index ca18ad4171690..110810f7344a2 100644 --- a/clients/client-medialive/commands/PurchaseOfferingCommand.ts +++ b/clients/client-medialive/commands/PurchaseOfferingCommand.ts @@ -20,6 +20,9 @@ import { export type PurchaseOfferingCommandInput = PurchaseOfferingRequest; export type PurchaseOfferingCommandOutput = PurchaseOfferingResponse & __MetadataBearer; +/** + * Purchase an offering and create a reservation. + */ export class PurchaseOfferingCommand extends $Command< PurchaseOfferingCommandInput, PurchaseOfferingCommandOutput, @@ -34,6 +37,9 @@ export class PurchaseOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/RejectInputDeviceTransferCommand.ts b/clients/client-medialive/commands/RejectInputDeviceTransferCommand.ts index 7387cf8e61c73..3998bd99223c3 100644 --- a/clients/client-medialive/commands/RejectInputDeviceTransferCommand.ts +++ b/clients/client-medialive/commands/RejectInputDeviceTransferCommand.ts @@ -20,6 +20,9 @@ import { export type RejectInputDeviceTransferCommandInput = RejectInputDeviceTransferRequest; export type RejectInputDeviceTransferCommandOutput = RejectInputDeviceTransferResponse & __MetadataBearer; +/** + * Reject the transfer of the specified input device to your AWS account. + */ export class RejectInputDeviceTransferCommand extends $Command< RejectInputDeviceTransferCommandInput, RejectInputDeviceTransferCommandOutput, @@ -34,6 +37,9 @@ export class RejectInputDeviceTransferCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/StartChannelCommand.ts b/clients/client-medialive/commands/StartChannelCommand.ts index be385c32f5126..72556a3dcd8a4 100644 --- a/clients/client-medialive/commands/StartChannelCommand.ts +++ b/clients/client-medialive/commands/StartChannelCommand.ts @@ -20,6 +20,9 @@ import { export type StartChannelCommandInput = StartChannelRequest; export type StartChannelCommandOutput = StartChannelResponse & __MetadataBearer; +/** + * Starts an existing channel + */ export class StartChannelCommand extends $Command< StartChannelCommandInput, StartChannelCommandOutput, @@ -34,6 +37,9 @@ export class StartChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/StartMultiplexCommand.ts b/clients/client-medialive/commands/StartMultiplexCommand.ts index 814661c1b4333..e034ff1beb21f 100644 --- a/clients/client-medialive/commands/StartMultiplexCommand.ts +++ b/clients/client-medialive/commands/StartMultiplexCommand.ts @@ -20,6 +20,9 @@ import { export type StartMultiplexCommandInput = StartMultiplexRequest; export type StartMultiplexCommandOutput = StartMultiplexResponse & __MetadataBearer; +/** + * Start (run) the multiplex. Starting the multiplex does not start the channels. You must explicitly start each channel. + */ export class StartMultiplexCommand extends $Command< StartMultiplexCommandInput, StartMultiplexCommandOutput, @@ -34,6 +37,9 @@ export class StartMultiplexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/StopChannelCommand.ts b/clients/client-medialive/commands/StopChannelCommand.ts index e4fcb92c7bf4e..bfabdfbf93ae4 100644 --- a/clients/client-medialive/commands/StopChannelCommand.ts +++ b/clients/client-medialive/commands/StopChannelCommand.ts @@ -20,6 +20,9 @@ import { export type StopChannelCommandInput = StopChannelRequest; export type StopChannelCommandOutput = StopChannelResponse & __MetadataBearer; +/** + * Stops a running channel + */ export class StopChannelCommand extends $Command< StopChannelCommandInput, StopChannelCommandOutput, @@ -34,6 +37,9 @@ export class StopChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/StopMultiplexCommand.ts b/clients/client-medialive/commands/StopMultiplexCommand.ts index dca81d5aebd37..c9676528fad23 100644 --- a/clients/client-medialive/commands/StopMultiplexCommand.ts +++ b/clients/client-medialive/commands/StopMultiplexCommand.ts @@ -20,6 +20,9 @@ import { export type StopMultiplexCommandInput = StopMultiplexRequest; export type StopMultiplexCommandOutput = StopMultiplexResponse & __MetadataBearer; +/** + * Stops a running multiplex. If the multiplex isn't running, this action has no effect. + */ export class StopMultiplexCommand extends $Command< StopMultiplexCommandInput, StopMultiplexCommandOutput, @@ -34,6 +37,9 @@ export class StopMultiplexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/TransferInputDeviceCommand.ts b/clients/client-medialive/commands/TransferInputDeviceCommand.ts index aedb5282428a9..a04b19b056ef3 100644 --- a/clients/client-medialive/commands/TransferInputDeviceCommand.ts +++ b/clients/client-medialive/commands/TransferInputDeviceCommand.ts @@ -20,6 +20,9 @@ import { export type TransferInputDeviceCommandInput = TransferInputDeviceRequest; export type TransferInputDeviceCommandOutput = TransferInputDeviceResponse & __MetadataBearer; +/** + * Start an input device transfer to another AWS account. After you make the request, the other account must accept or reject the transfer. + */ export class TransferInputDeviceCommand extends $Command< TransferInputDeviceCommandInput, TransferInputDeviceCommandOutput, @@ -34,6 +37,9 @@ export class TransferInputDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/UpdateChannelClassCommand.ts b/clients/client-medialive/commands/UpdateChannelClassCommand.ts index a72bc31289add..a8208dda5429e 100644 --- a/clients/client-medialive/commands/UpdateChannelClassCommand.ts +++ b/clients/client-medialive/commands/UpdateChannelClassCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateChannelClassCommandInput = UpdateChannelClassRequest; export type UpdateChannelClassCommandOutput = UpdateChannelClassResponse & __MetadataBearer; +/** + * Changes the class of the channel. + */ export class UpdateChannelClassCommand extends $Command< UpdateChannelClassCommandInput, UpdateChannelClassCommandOutput, @@ -34,6 +37,9 @@ export class UpdateChannelClassCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/UpdateChannelCommand.ts b/clients/client-medialive/commands/UpdateChannelCommand.ts index c27a17d7c4ad1..e27dd008d6060 100644 --- a/clients/client-medialive/commands/UpdateChannelCommand.ts +++ b/clients/client-medialive/commands/UpdateChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateChannelCommandInput = UpdateChannelRequest; export type UpdateChannelCommandOutput = UpdateChannelResponse & __MetadataBearer; +/** + * Updates a channel. + */ export class UpdateChannelCommand extends $Command< UpdateChannelCommandInput, UpdateChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/UpdateInputCommand.ts b/clients/client-medialive/commands/UpdateInputCommand.ts index 1a8495b73b65e..1d38ce799c5bd 100644 --- a/clients/client-medialive/commands/UpdateInputCommand.ts +++ b/clients/client-medialive/commands/UpdateInputCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateInputCommandInput = UpdateInputRequest; export type UpdateInputCommandOutput = UpdateInputResponse & __MetadataBearer; +/** + * Updates an input. + */ export class UpdateInputCommand extends $Command< UpdateInputCommandInput, UpdateInputCommandOutput, @@ -34,6 +37,9 @@ export class UpdateInputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/UpdateInputDeviceCommand.ts b/clients/client-medialive/commands/UpdateInputDeviceCommand.ts index 80212ea4b459c..3ffa7c278e9be 100644 --- a/clients/client-medialive/commands/UpdateInputDeviceCommand.ts +++ b/clients/client-medialive/commands/UpdateInputDeviceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateInputDeviceCommandInput = UpdateInputDeviceRequest; export type UpdateInputDeviceCommandOutput = UpdateInputDeviceResponse & __MetadataBearer; +/** + * Updates the parameters for the input device. + */ export class UpdateInputDeviceCommand extends $Command< UpdateInputDeviceCommandInput, UpdateInputDeviceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateInputDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/UpdateInputSecurityGroupCommand.ts b/clients/client-medialive/commands/UpdateInputSecurityGroupCommand.ts index 2c5c5b2bb2c64..06217bd408e43 100644 --- a/clients/client-medialive/commands/UpdateInputSecurityGroupCommand.ts +++ b/clients/client-medialive/commands/UpdateInputSecurityGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateInputSecurityGroupCommandInput = UpdateInputSecurityGroupRequest; export type UpdateInputSecurityGroupCommandOutput = UpdateInputSecurityGroupResponse & __MetadataBearer; +/** + * Update an Input Security Group's Whilelists. + */ export class UpdateInputSecurityGroupCommand extends $Command< UpdateInputSecurityGroupCommandInput, UpdateInputSecurityGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateInputSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/UpdateMultiplexCommand.ts b/clients/client-medialive/commands/UpdateMultiplexCommand.ts index 37c451694dd92..c0a8808952f13 100644 --- a/clients/client-medialive/commands/UpdateMultiplexCommand.ts +++ b/clients/client-medialive/commands/UpdateMultiplexCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMultiplexCommandInput = UpdateMultiplexRequest; export type UpdateMultiplexCommandOutput = UpdateMultiplexResponse & __MetadataBearer; +/** + * Updates a multiplex. + */ export class UpdateMultiplexCommand extends $Command< UpdateMultiplexCommandInput, UpdateMultiplexCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMultiplexCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/UpdateMultiplexProgramCommand.ts b/clients/client-medialive/commands/UpdateMultiplexProgramCommand.ts index a80207bf36b4c..089b8fd8a7f5d 100644 --- a/clients/client-medialive/commands/UpdateMultiplexProgramCommand.ts +++ b/clients/client-medialive/commands/UpdateMultiplexProgramCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMultiplexProgramCommandInput = UpdateMultiplexProgramRequest; export type UpdateMultiplexProgramCommandOutput = UpdateMultiplexProgramResponse & __MetadataBearer; +/** + * Update a program in a multiplex. + */ export class UpdateMultiplexProgramCommand extends $Command< UpdateMultiplexProgramCommandInput, UpdateMultiplexProgramCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMultiplexProgramCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/commands/UpdateReservationCommand.ts b/clients/client-medialive/commands/UpdateReservationCommand.ts index b1370e41e0ba4..2f1a7618723cd 100644 --- a/clients/client-medialive/commands/UpdateReservationCommand.ts +++ b/clients/client-medialive/commands/UpdateReservationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateReservationCommandInput = UpdateReservationRequest; export type UpdateReservationCommandOutput = UpdateReservationResponse & __MetadataBearer; +/** + * Update reservation. + */ export class UpdateReservationCommand extends $Command< UpdateReservationCommandInput, UpdateReservationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateReservationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaLiveClientResolvedConfig, diff --git a/clients/client-medialive/package.json b/clients/client-medialive/package.json index 9d929159a0382..4b29fe7aae181 100644 --- a/clients/client-medialive/package.json +++ b/clients/client-medialive/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Medialive Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-medialive/pagination/DescribeSchedulePaginator.ts b/clients/client-medialive/pagination/DescribeSchedulePaginator.ts index 25e4ca4c0022e..5634e4c9c3be4 100644 --- a/clients/client-medialive/pagination/DescribeSchedulePaginator.ts +++ b/clients/client-medialive/pagination/DescribeSchedulePaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: DescribeScheduleCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScheduleCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: DescribeScheduleCommandInput, diff --git a/clients/client-medialive/pagination/ListChannelsPaginator.ts b/clients/client-medialive/pagination/ListChannelsPaginator.ts index dc4e1a324413a..8e7f6e49d0aca 100644 --- a/clients/client-medialive/pagination/ListChannelsPaginator.ts +++ b/clients/client-medialive/pagination/ListChannelsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListChannelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListChannelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListChannelsCommandInput, diff --git a/clients/client-medialive/pagination/ListInputDeviceTransfersPaginator.ts b/clients/client-medialive/pagination/ListInputDeviceTransfersPaginator.ts index 71b47fa7abec0..083a60c64b8de 100644 --- a/clients/client-medialive/pagination/ListInputDeviceTransfersPaginator.ts +++ b/clients/client-medialive/pagination/ListInputDeviceTransfersPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListInputDeviceTransfersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInputDeviceTransfersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListInputDeviceTransfersCommandInput, diff --git a/clients/client-medialive/pagination/ListInputDevicesPaginator.ts b/clients/client-medialive/pagination/ListInputDevicesPaginator.ts index c156fb8144773..5dcd536705101 100644 --- a/clients/client-medialive/pagination/ListInputDevicesPaginator.ts +++ b/clients/client-medialive/pagination/ListInputDevicesPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListInputDevicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInputDevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListInputDevicesCommandInput, diff --git a/clients/client-medialive/pagination/ListInputSecurityGroupsPaginator.ts b/clients/client-medialive/pagination/ListInputSecurityGroupsPaginator.ts index 0ede0dbdfe0fa..cfc86f7ad077e 100644 --- a/clients/client-medialive/pagination/ListInputSecurityGroupsPaginator.ts +++ b/clients/client-medialive/pagination/ListInputSecurityGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListInputSecurityGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInputSecurityGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListInputSecurityGroupsCommandInput, diff --git a/clients/client-medialive/pagination/ListInputsPaginator.ts b/clients/client-medialive/pagination/ListInputsPaginator.ts index 1dfd716033acf..f2deea9f314de 100644 --- a/clients/client-medialive/pagination/ListInputsPaginator.ts +++ b/clients/client-medialive/pagination/ListInputsPaginator.ts @@ -4,6 +4,9 @@ import { ListInputsCommand, ListInputsCommandInput, ListInputsCommandOutput } fr import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListInputsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInputsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListInputsCommandInput, diff --git a/clients/client-medialive/pagination/ListMultiplexProgramsPaginator.ts b/clients/client-medialive/pagination/ListMultiplexProgramsPaginator.ts index 6d50fcc75ea60..bed5f8ca64b6f 100644 --- a/clients/client-medialive/pagination/ListMultiplexProgramsPaginator.ts +++ b/clients/client-medialive/pagination/ListMultiplexProgramsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListMultiplexProgramsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMultiplexProgramsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListMultiplexProgramsCommandInput, diff --git a/clients/client-medialive/pagination/ListMultiplexesPaginator.ts b/clients/client-medialive/pagination/ListMultiplexesPaginator.ts index 7ef04abbb9711..22c362d6df97a 100644 --- a/clients/client-medialive/pagination/ListMultiplexesPaginator.ts +++ b/clients/client-medialive/pagination/ListMultiplexesPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListMultiplexesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMultiplexesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListMultiplexesCommandInput, diff --git a/clients/client-medialive/pagination/ListOfferingsPaginator.ts b/clients/client-medialive/pagination/ListOfferingsPaginator.ts index 64e5fa53b5552..40bc5296d92c9 100644 --- a/clients/client-medialive/pagination/ListOfferingsPaginator.ts +++ b/clients/client-medialive/pagination/ListOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListOfferingsCommandInput, diff --git a/clients/client-medialive/pagination/ListReservationsPaginator.ts b/clients/client-medialive/pagination/ListReservationsPaginator.ts index cbdcd970c9607..bcc49ab8a6fa4 100644 --- a/clients/client-medialive/pagination/ListReservationsPaginator.ts +++ b/clients/client-medialive/pagination/ListReservationsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaLivePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaLiveClient, input: ListReservationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListReservationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaLive, input: ListReservationsCommandInput, diff --git a/clients/client-medialive/runtimeConfig.browser.ts b/clients/client-medialive/runtimeConfig.browser.ts index 946e66856ba59..201998727295c 100644 --- a/clients/client-medialive/runtimeConfig.browser.ts +++ b/clients/client-medialive/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MediaLiveClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-medialive/runtimeConfig.native.ts b/clients/client-medialive/runtimeConfig.native.ts index c348c012780d9..978431e867c87 100644 --- a/clients/client-medialive/runtimeConfig.native.ts +++ b/clients/client-medialive/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MediaLiveClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-medialive/runtimeConfig.shared.ts b/clients/client-medialive/runtimeConfig.shared.ts index d8b24dda2b3b0..17b8a20a3c735 100644 --- a/clients/client-medialive/runtimeConfig.shared.ts +++ b/clients/client-medialive/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-14", disableHostPrefix: false, diff --git a/clients/client-medialive/runtimeConfig.ts b/clients/client-medialive/runtimeConfig.ts index 0fc6d27b2839a..b395e847f6568 100644 --- a/clients/client-medialive/runtimeConfig.ts +++ b/clients/client-medialive/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MediaLiveClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-medialive/tsconfig.json b/clients/client-medialive/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-medialive/tsconfig.json +++ b/clients/client-medialive/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mediapackage-vod/commands/CreateAssetCommand.ts b/clients/client-mediapackage-vod/commands/CreateAssetCommand.ts index 603e48709ee9d..6a920f6c283b0 100644 --- a/clients/client-mediapackage-vod/commands/CreateAssetCommand.ts +++ b/clients/client-mediapackage-vod/commands/CreateAssetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAssetCommandInput = CreateAssetRequest; export type CreateAssetCommandOutput = CreateAssetResponse & __MetadataBearer; +/** + * Creates a new MediaPackage VOD Asset resource. + */ export class CreateAssetCommand extends $Command< CreateAssetCommandInput, CreateAssetCommandOutput, @@ -34,6 +37,9 @@ export class CreateAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/CreatePackagingConfigurationCommand.ts b/clients/client-mediapackage-vod/commands/CreatePackagingConfigurationCommand.ts index c38b0efb55e74..4e136a88db5e2 100644 --- a/clients/client-mediapackage-vod/commands/CreatePackagingConfigurationCommand.ts +++ b/clients/client-mediapackage-vod/commands/CreatePackagingConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePackagingConfigurationCommandInput = CreatePackagingConfigurationRequest; export type CreatePackagingConfigurationCommandOutput = CreatePackagingConfigurationResponse & __MetadataBearer; +/** + * Creates a new MediaPackage VOD PackagingConfiguration resource. + */ export class CreatePackagingConfigurationCommand extends $Command< CreatePackagingConfigurationCommandInput, CreatePackagingConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class CreatePackagingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/CreatePackagingGroupCommand.ts b/clients/client-mediapackage-vod/commands/CreatePackagingGroupCommand.ts index 9140bfeea5d4d..61beecde81091 100644 --- a/clients/client-mediapackage-vod/commands/CreatePackagingGroupCommand.ts +++ b/clients/client-mediapackage-vod/commands/CreatePackagingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePackagingGroupCommandInput = CreatePackagingGroupRequest; export type CreatePackagingGroupCommandOutput = CreatePackagingGroupResponse & __MetadataBearer; +/** + * Creates a new MediaPackage VOD PackagingGroup resource. + */ export class CreatePackagingGroupCommand extends $Command< CreatePackagingGroupCommandInput, CreatePackagingGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreatePackagingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/DeleteAssetCommand.ts b/clients/client-mediapackage-vod/commands/DeleteAssetCommand.ts index 73e9cacedaba3..9d53cb111c594 100644 --- a/clients/client-mediapackage-vod/commands/DeleteAssetCommand.ts +++ b/clients/client-mediapackage-vod/commands/DeleteAssetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAssetCommandInput = DeleteAssetRequest; export type DeleteAssetCommandOutput = DeleteAssetResponse & __MetadataBearer; +/** + * Deletes an existing MediaPackage VOD Asset resource. + */ export class DeleteAssetCommand extends $Command< DeleteAssetCommandInput, DeleteAssetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/DeletePackagingConfigurationCommand.ts b/clients/client-mediapackage-vod/commands/DeletePackagingConfigurationCommand.ts index 23ebed93aa6e4..b707737464859 100644 --- a/clients/client-mediapackage-vod/commands/DeletePackagingConfigurationCommand.ts +++ b/clients/client-mediapackage-vod/commands/DeletePackagingConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePackagingConfigurationCommandInput = DeletePackagingConfigurationRequest; export type DeletePackagingConfigurationCommandOutput = DeletePackagingConfigurationResponse & __MetadataBearer; +/** + * Deletes a MediaPackage VOD PackagingConfiguration resource. + */ export class DeletePackagingConfigurationCommand extends $Command< DeletePackagingConfigurationCommandInput, DeletePackagingConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeletePackagingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/DeletePackagingGroupCommand.ts b/clients/client-mediapackage-vod/commands/DeletePackagingGroupCommand.ts index 15154784bb1a7..5460b63630962 100644 --- a/clients/client-mediapackage-vod/commands/DeletePackagingGroupCommand.ts +++ b/clients/client-mediapackage-vod/commands/DeletePackagingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePackagingGroupCommandInput = DeletePackagingGroupRequest; export type DeletePackagingGroupCommandOutput = DeletePackagingGroupResponse & __MetadataBearer; +/** + * Deletes a MediaPackage VOD PackagingGroup resource. + */ export class DeletePackagingGroupCommand extends $Command< DeletePackagingGroupCommandInput, DeletePackagingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeletePackagingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/DescribeAssetCommand.ts b/clients/client-mediapackage-vod/commands/DescribeAssetCommand.ts index 6a3ee1795c7e5..286195e523f90 100644 --- a/clients/client-mediapackage-vod/commands/DescribeAssetCommand.ts +++ b/clients/client-mediapackage-vod/commands/DescribeAssetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAssetCommandInput = DescribeAssetRequest; export type DescribeAssetCommandOutput = DescribeAssetResponse & __MetadataBearer; +/** + * Returns a description of a MediaPackage VOD Asset resource. + */ export class DescribeAssetCommand extends $Command< DescribeAssetCommandInput, DescribeAssetCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAssetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/DescribePackagingConfigurationCommand.ts b/clients/client-mediapackage-vod/commands/DescribePackagingConfigurationCommand.ts index f591b7191b2bf..ff67887ac7a47 100644 --- a/clients/client-mediapackage-vod/commands/DescribePackagingConfigurationCommand.ts +++ b/clients/client-mediapackage-vod/commands/DescribePackagingConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePackagingConfigurationCommandInput = DescribePackagingConfigurationRequest; export type DescribePackagingConfigurationCommandOutput = DescribePackagingConfigurationResponse & __MetadataBearer; +/** + * Returns a description of a MediaPackage VOD PackagingConfiguration resource. + */ export class DescribePackagingConfigurationCommand extends $Command< DescribePackagingConfigurationCommandInput, DescribePackagingConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DescribePackagingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/DescribePackagingGroupCommand.ts b/clients/client-mediapackage-vod/commands/DescribePackagingGroupCommand.ts index 32d892a5c1e3f..9ea0f7b3174bf 100644 --- a/clients/client-mediapackage-vod/commands/DescribePackagingGroupCommand.ts +++ b/clients/client-mediapackage-vod/commands/DescribePackagingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePackagingGroupCommandInput = DescribePackagingGroupRequest; export type DescribePackagingGroupCommandOutput = DescribePackagingGroupResponse & __MetadataBearer; +/** + * Returns a description of a MediaPackage VOD PackagingGroup resource. + */ export class DescribePackagingGroupCommand extends $Command< DescribePackagingGroupCommandInput, DescribePackagingGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribePackagingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/ListAssetsCommand.ts b/clients/client-mediapackage-vod/commands/ListAssetsCommand.ts index 2b89fd9eb679c..ca1f069c2b30b 100644 --- a/clients/client-mediapackage-vod/commands/ListAssetsCommand.ts +++ b/clients/client-mediapackage-vod/commands/ListAssetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAssetsCommandInput = ListAssetsRequest; export type ListAssetsCommandOutput = ListAssetsResponse & __MetadataBearer; +/** + * Returns a collection of MediaPackage VOD Asset resources. + */ export class ListAssetsCommand extends $Command< ListAssetsCommandInput, ListAssetsCommandOutput, @@ -34,6 +37,9 @@ export class ListAssetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/ListPackagingConfigurationsCommand.ts b/clients/client-mediapackage-vod/commands/ListPackagingConfigurationsCommand.ts index c5446c5e31fbc..6aeff5098f9df 100644 --- a/clients/client-mediapackage-vod/commands/ListPackagingConfigurationsCommand.ts +++ b/clients/client-mediapackage-vod/commands/ListPackagingConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPackagingConfigurationsCommandInput = ListPackagingConfigurationsRequest; export type ListPackagingConfigurationsCommandOutput = ListPackagingConfigurationsResponse & __MetadataBearer; +/** + * Returns a collection of MediaPackage VOD PackagingConfiguration resources. + */ export class ListPackagingConfigurationsCommand extends $Command< ListPackagingConfigurationsCommandInput, ListPackagingConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class ListPackagingConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/ListPackagingGroupsCommand.ts b/clients/client-mediapackage-vod/commands/ListPackagingGroupsCommand.ts index 92acd0dbd46d3..63c8e283f8bd3 100644 --- a/clients/client-mediapackage-vod/commands/ListPackagingGroupsCommand.ts +++ b/clients/client-mediapackage-vod/commands/ListPackagingGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPackagingGroupsCommandInput = ListPackagingGroupsRequest; export type ListPackagingGroupsCommandOutput = ListPackagingGroupsResponse & __MetadataBearer; +/** + * Returns a collection of MediaPackage VOD PackagingGroup resources. + */ export class ListPackagingGroupsCommand extends $Command< ListPackagingGroupsCommandInput, ListPackagingGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListPackagingGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/ListTagsForResourceCommand.ts b/clients/client-mediapackage-vod/commands/ListTagsForResourceCommand.ts index 92b59619c3288..98644d9e2a61d 100644 --- a/clients/client-mediapackage-vod/commands/ListTagsForResourceCommand.ts +++ b/clients/client-mediapackage-vod/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + * Returns a list of the tags assigned to the specified resource. + */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/TagResourceCommand.ts b/clients/client-mediapackage-vod/commands/TagResourceCommand.ts index 09e34d164e29b..1aad10564bed1 100644 --- a/clients/client-mediapackage-vod/commands/TagResourceCommand.ts +++ b/clients/client-mediapackage-vod/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + * Adds tags to the specified resource. You can specify one or more tags to add. + */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/UntagResourceCommand.ts b/clients/client-mediapackage-vod/commands/UntagResourceCommand.ts index 06e819181622c..8e6cd0ca12447 100644 --- a/clients/client-mediapackage-vod/commands/UntagResourceCommand.ts +++ b/clients/client-mediapackage-vod/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + * Removes tags from the specified resource. You can specify one or more tags to remove. + */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/commands/UpdatePackagingGroupCommand.ts b/clients/client-mediapackage-vod/commands/UpdatePackagingGroupCommand.ts index 4d06031e5456f..79bbbb141b665 100644 --- a/clients/client-mediapackage-vod/commands/UpdatePackagingGroupCommand.ts +++ b/clients/client-mediapackage-vod/commands/UpdatePackagingGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePackagingGroupCommandInput = UpdatePackagingGroupRequest; export type UpdatePackagingGroupCommandOutput = UpdatePackagingGroupResponse & __MetadataBearer; +/** + * Updates a specific packaging group. You can't change the id attribute or any other system-generated attributes. + */ export class UpdatePackagingGroupCommand extends $Command< UpdatePackagingGroupCommandInput, UpdatePackagingGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePackagingGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageVodClientResolvedConfig, diff --git a/clients/client-mediapackage-vod/package.json b/clients/client-mediapackage-vod/package.json index 02287dd2bccff..04931cc52c3f7 100644 --- a/clients/client-mediapackage-vod/package.json +++ b/clients/client-mediapackage-vod/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mediapackage Vod Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mediapackage-vod/pagination/ListAssetsPaginator.ts b/clients/client-mediapackage-vod/pagination/ListAssetsPaginator.ts index f55de1b9048dc..264c6a18c6ee0 100644 --- a/clients/client-mediapackage-vod/pagination/ListAssetsPaginator.ts +++ b/clients/client-mediapackage-vod/pagination/ListAssetsPaginator.ts @@ -4,6 +4,9 @@ import { ListAssetsCommand, ListAssetsCommandInput, ListAssetsCommandOutput } fr import { MediaPackageVodPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaPackageVodClient, input: ListAssetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaPackageVod, input: ListAssetsCommandInput, diff --git a/clients/client-mediapackage-vod/pagination/ListPackagingConfigurationsPaginator.ts b/clients/client-mediapackage-vod/pagination/ListPackagingConfigurationsPaginator.ts index 1434a817a7fab..b11072c5f03b3 100644 --- a/clients/client-mediapackage-vod/pagination/ListPackagingConfigurationsPaginator.ts +++ b/clients/client-mediapackage-vod/pagination/ListPackagingConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaPackageVodPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaPackageVodClient, input: ListPackagingConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPackagingConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaPackageVod, input: ListPackagingConfigurationsCommandInput, diff --git a/clients/client-mediapackage-vod/pagination/ListPackagingGroupsPaginator.ts b/clients/client-mediapackage-vod/pagination/ListPackagingGroupsPaginator.ts index 3eeb11c18d125..4feb0236fdd93 100644 --- a/clients/client-mediapackage-vod/pagination/ListPackagingGroupsPaginator.ts +++ b/clients/client-mediapackage-vod/pagination/ListPackagingGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaPackageVodPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaPackageVodClient, input: ListPackagingGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPackagingGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaPackageVod, input: ListPackagingGroupsCommandInput, diff --git a/clients/client-mediapackage-vod/runtimeConfig.browser.ts b/clients/client-mediapackage-vod/runtimeConfig.browser.ts index f13e36aefb7bb..710ba4149a24b 100644 --- a/clients/client-mediapackage-vod/runtimeConfig.browser.ts +++ b/clients/client-mediapackage-vod/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MediaPackageVodClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mediapackage-vod/runtimeConfig.native.ts b/clients/client-mediapackage-vod/runtimeConfig.native.ts index 026721e956264..2fb54a3a1bfa0 100644 --- a/clients/client-mediapackage-vod/runtimeConfig.native.ts +++ b/clients/client-mediapackage-vod/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MediaPackageVodClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mediapackage-vod/runtimeConfig.shared.ts b/clients/client-mediapackage-vod/runtimeConfig.shared.ts index e897eca5e5bb3..f964dddf63564 100644 --- a/clients/client-mediapackage-vod/runtimeConfig.shared.ts +++ b/clients/client-mediapackage-vod/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-07", disableHostPrefix: false, diff --git a/clients/client-mediapackage-vod/runtimeConfig.ts b/clients/client-mediapackage-vod/runtimeConfig.ts index 8b51278b7f504..7dfcfc1ccc970 100644 --- a/clients/client-mediapackage-vod/runtimeConfig.ts +++ b/clients/client-mediapackage-vod/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MediaPackageVodClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mediapackage-vod/tsconfig.json b/clients/client-mediapackage-vod/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mediapackage-vod/tsconfig.json +++ b/clients/client-mediapackage-vod/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mediapackage/commands/ConfigureLogsCommand.ts b/clients/client-mediapackage/commands/ConfigureLogsCommand.ts index f4cda07a30612..3fe56789c7c95 100644 --- a/clients/client-mediapackage/commands/ConfigureLogsCommand.ts +++ b/clients/client-mediapackage/commands/ConfigureLogsCommand.ts @@ -20,6 +20,9 @@ import { export type ConfigureLogsCommandInput = ConfigureLogsRequest; export type ConfigureLogsCommandOutput = ConfigureLogsResponse & __MetadataBearer; +/** + * Changes the Channel's properities to configure log subscription + */ export class ConfigureLogsCommand extends $Command< ConfigureLogsCommandInput, ConfigureLogsCommandOutput, @@ -34,6 +37,9 @@ export class ConfigureLogsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/CreateChannelCommand.ts b/clients/client-mediapackage/commands/CreateChannelCommand.ts index f75818d485f13..25ac8fc05d70e 100644 --- a/clients/client-mediapackage/commands/CreateChannelCommand.ts +++ b/clients/client-mediapackage/commands/CreateChannelCommand.ts @@ -20,6 +20,9 @@ import { export type CreateChannelCommandInput = CreateChannelRequest; export type CreateChannelCommandOutput = CreateChannelResponse & __MetadataBearer; +/** + * Creates a new Channel. + */ export class CreateChannelCommand extends $Command< CreateChannelCommandInput, CreateChannelCommandOutput, @@ -34,6 +37,9 @@ export class CreateChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/CreateHarvestJobCommand.ts b/clients/client-mediapackage/commands/CreateHarvestJobCommand.ts index 9ab24aaa30a0f..fc815d2a5ec43 100644 --- a/clients/client-mediapackage/commands/CreateHarvestJobCommand.ts +++ b/clients/client-mediapackage/commands/CreateHarvestJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateHarvestJobCommandInput = CreateHarvestJobRequest; export type CreateHarvestJobCommandOutput = CreateHarvestJobResponse & __MetadataBearer; +/** + * Creates a new HarvestJob record. + */ export class CreateHarvestJobCommand extends $Command< CreateHarvestJobCommandInput, CreateHarvestJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateHarvestJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/CreateOriginEndpointCommand.ts b/clients/client-mediapackage/commands/CreateOriginEndpointCommand.ts index 62ac6e1b88f1c..464bb89f5722c 100644 --- a/clients/client-mediapackage/commands/CreateOriginEndpointCommand.ts +++ b/clients/client-mediapackage/commands/CreateOriginEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type CreateOriginEndpointCommandInput = CreateOriginEndpointRequest; export type CreateOriginEndpointCommandOutput = CreateOriginEndpointResponse & __MetadataBearer; +/** + * Creates a new OriginEndpoint record. + */ export class CreateOriginEndpointCommand extends $Command< CreateOriginEndpointCommandInput, CreateOriginEndpointCommandOutput, @@ -34,6 +37,9 @@ export class CreateOriginEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/DeleteChannelCommand.ts b/clients/client-mediapackage/commands/DeleteChannelCommand.ts index 2ff0b9b83179e..34edb564d60c4 100644 --- a/clients/client-mediapackage/commands/DeleteChannelCommand.ts +++ b/clients/client-mediapackage/commands/DeleteChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteChannelCommandInput = DeleteChannelRequest; export type DeleteChannelCommandOutput = DeleteChannelResponse & __MetadataBearer; +/** + * Deletes an existing Channel. + */ export class DeleteChannelCommand extends $Command< DeleteChannelCommandInput, DeleteChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/DeleteOriginEndpointCommand.ts b/clients/client-mediapackage/commands/DeleteOriginEndpointCommand.ts index ba138609c69f4..e3899a3260521 100644 --- a/clients/client-mediapackage/commands/DeleteOriginEndpointCommand.ts +++ b/clients/client-mediapackage/commands/DeleteOriginEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteOriginEndpointCommandInput = DeleteOriginEndpointRequest; export type DeleteOriginEndpointCommandOutput = DeleteOriginEndpointResponse & __MetadataBearer; +/** + * Deletes an existing OriginEndpoint. + */ export class DeleteOriginEndpointCommand extends $Command< DeleteOriginEndpointCommandInput, DeleteOriginEndpointCommandOutput, @@ -34,6 +37,9 @@ export class DeleteOriginEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/DescribeChannelCommand.ts b/clients/client-mediapackage/commands/DescribeChannelCommand.ts index 286af8674ead4..7744993c58c8d 100644 --- a/clients/client-mediapackage/commands/DescribeChannelCommand.ts +++ b/clients/client-mediapackage/commands/DescribeChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeChannelCommandInput = DescribeChannelRequest; export type DescribeChannelCommandOutput = DescribeChannelResponse & __MetadataBearer; +/** + * Gets details about a Channel. + */ export class DescribeChannelCommand extends $Command< DescribeChannelCommandInput, DescribeChannelCommandOutput, @@ -34,6 +37,9 @@ export class DescribeChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/DescribeHarvestJobCommand.ts b/clients/client-mediapackage/commands/DescribeHarvestJobCommand.ts index fe9b804fb7fdf..9275165de3f86 100644 --- a/clients/client-mediapackage/commands/DescribeHarvestJobCommand.ts +++ b/clients/client-mediapackage/commands/DescribeHarvestJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeHarvestJobCommandInput = DescribeHarvestJobRequest; export type DescribeHarvestJobCommandOutput = DescribeHarvestJobResponse & __MetadataBearer; +/** + * Gets details about an existing HarvestJob. + */ export class DescribeHarvestJobCommand extends $Command< DescribeHarvestJobCommandInput, DescribeHarvestJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeHarvestJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/DescribeOriginEndpointCommand.ts b/clients/client-mediapackage/commands/DescribeOriginEndpointCommand.ts index 4701e73c62605..fa164ebe4b55c 100644 --- a/clients/client-mediapackage/commands/DescribeOriginEndpointCommand.ts +++ b/clients/client-mediapackage/commands/DescribeOriginEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOriginEndpointCommandInput = DescribeOriginEndpointRequest; export type DescribeOriginEndpointCommandOutput = DescribeOriginEndpointResponse & __MetadataBearer; +/** + * Gets details about an existing OriginEndpoint. + */ export class DescribeOriginEndpointCommand extends $Command< DescribeOriginEndpointCommandInput, DescribeOriginEndpointCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOriginEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/ListChannelsCommand.ts b/clients/client-mediapackage/commands/ListChannelsCommand.ts index a773a24a0d346..d7de6a1ca98db 100644 --- a/clients/client-mediapackage/commands/ListChannelsCommand.ts +++ b/clients/client-mediapackage/commands/ListChannelsCommand.ts @@ -20,6 +20,9 @@ import { export type ListChannelsCommandInput = ListChannelsRequest; export type ListChannelsCommandOutput = ListChannelsResponse & __MetadataBearer; +/** + * Returns a collection of Channels. + */ export class ListChannelsCommand extends $Command< ListChannelsCommandInput, ListChannelsCommandOutput, @@ -34,6 +37,9 @@ export class ListChannelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/ListHarvestJobsCommand.ts b/clients/client-mediapackage/commands/ListHarvestJobsCommand.ts index 932a71cbfb3e7..78ebf180b6ac9 100644 --- a/clients/client-mediapackage/commands/ListHarvestJobsCommand.ts +++ b/clients/client-mediapackage/commands/ListHarvestJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListHarvestJobsCommandInput = ListHarvestJobsRequest; export type ListHarvestJobsCommandOutput = ListHarvestJobsResponse & __MetadataBearer; +/** + * Returns a collection of HarvestJob records. + */ export class ListHarvestJobsCommand extends $Command< ListHarvestJobsCommandInput, ListHarvestJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListHarvestJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/ListOriginEndpointsCommand.ts b/clients/client-mediapackage/commands/ListOriginEndpointsCommand.ts index 1d30ba97ccaf7..bde816976d901 100644 --- a/clients/client-mediapackage/commands/ListOriginEndpointsCommand.ts +++ b/clients/client-mediapackage/commands/ListOriginEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type ListOriginEndpointsCommandInput = ListOriginEndpointsRequest; export type ListOriginEndpointsCommandOutput = ListOriginEndpointsResponse & __MetadataBearer; +/** + * Returns a collection of OriginEndpoint records. + */ export class ListOriginEndpointsCommand extends $Command< ListOriginEndpointsCommandInput, ListOriginEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class ListOriginEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/ListTagsForResourceCommand.ts b/clients/client-mediapackage/commands/ListTagsForResourceCommand.ts index 58566575abd20..a18d84ee9fc2f 100644 --- a/clients/client-mediapackage/commands/ListTagsForResourceCommand.ts +++ b/clients/client-mediapackage/commands/ListTagsForResourceCommand.ts @@ -34,6 +34,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/RotateChannelCredentialsCommand.ts b/clients/client-mediapackage/commands/RotateChannelCredentialsCommand.ts index 4c27c09d05978..47182642cba6d 100644 --- a/clients/client-mediapackage/commands/RotateChannelCredentialsCommand.ts +++ b/clients/client-mediapackage/commands/RotateChannelCredentialsCommand.ts @@ -20,6 +20,9 @@ import { export type RotateChannelCredentialsCommandInput = RotateChannelCredentialsRequest; export type RotateChannelCredentialsCommandOutput = RotateChannelCredentialsResponse & __MetadataBearer; +/** + * Changes the Channel's first IngestEndpoint's username and password. WARNING - This API is deprecated. Please use RotateIngestEndpointCredentials instead + */ export class RotateChannelCredentialsCommand extends $Command< RotateChannelCredentialsCommandInput, RotateChannelCredentialsCommandOutput, @@ -34,6 +37,9 @@ export class RotateChannelCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/RotateIngestEndpointCredentialsCommand.ts b/clients/client-mediapackage/commands/RotateIngestEndpointCredentialsCommand.ts index ec43aa3b1f5d6..65dcd760cd2a8 100644 --- a/clients/client-mediapackage/commands/RotateIngestEndpointCredentialsCommand.ts +++ b/clients/client-mediapackage/commands/RotateIngestEndpointCredentialsCommand.ts @@ -20,6 +20,9 @@ import { export type RotateIngestEndpointCredentialsCommandInput = RotateIngestEndpointCredentialsRequest; export type RotateIngestEndpointCredentialsCommandOutput = RotateIngestEndpointCredentialsResponse & __MetadataBearer; +/** + * Rotate the IngestEndpoint's username and password, as specified by the IngestEndpoint's id. + */ export class RotateIngestEndpointCredentialsCommand extends $Command< RotateIngestEndpointCredentialsCommandInput, RotateIngestEndpointCredentialsCommandOutput, @@ -34,6 +37,9 @@ export class RotateIngestEndpointCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/TagResourceCommand.ts b/clients/client-mediapackage/commands/TagResourceCommand.ts index 1e9c54d3b609c..7fe895df37e98 100644 --- a/clients/client-mediapackage/commands/TagResourceCommand.ts +++ b/clients/client-mediapackage/commands/TagResourceCommand.ts @@ -34,6 +34,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/UntagResourceCommand.ts b/clients/client-mediapackage/commands/UntagResourceCommand.ts index 898715d4907d7..1ddc4c607785d 100644 --- a/clients/client-mediapackage/commands/UntagResourceCommand.ts +++ b/clients/client-mediapackage/commands/UntagResourceCommand.ts @@ -34,6 +34,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/UpdateChannelCommand.ts b/clients/client-mediapackage/commands/UpdateChannelCommand.ts index 0b2bc6d0db6a5..96ece7206d03f 100644 --- a/clients/client-mediapackage/commands/UpdateChannelCommand.ts +++ b/clients/client-mediapackage/commands/UpdateChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateChannelCommandInput = UpdateChannelRequest; export type UpdateChannelCommandOutput = UpdateChannelResponse & __MetadataBearer; +/** + * Updates an existing Channel. + */ export class UpdateChannelCommand extends $Command< UpdateChannelCommandInput, UpdateChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/commands/UpdateOriginEndpointCommand.ts b/clients/client-mediapackage/commands/UpdateOriginEndpointCommand.ts index c55a33aff3820..5fcd61f8db6a0 100644 --- a/clients/client-mediapackage/commands/UpdateOriginEndpointCommand.ts +++ b/clients/client-mediapackage/commands/UpdateOriginEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateOriginEndpointCommandInput = UpdateOriginEndpointRequest; export type UpdateOriginEndpointCommandOutput = UpdateOriginEndpointResponse & __MetadataBearer; +/** + * Updates an existing OriginEndpoint. + */ export class UpdateOriginEndpointCommand extends $Command< UpdateOriginEndpointCommandInput, UpdateOriginEndpointCommandOutput, @@ -34,6 +37,9 @@ export class UpdateOriginEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaPackageClientResolvedConfig, diff --git a/clients/client-mediapackage/package.json b/clients/client-mediapackage/package.json index 3ed1737c79200..a4e9b896e31f9 100644 --- a/clients/client-mediapackage/package.json +++ b/clients/client-mediapackage/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mediapackage Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mediapackage/pagination/ListChannelsPaginator.ts b/clients/client-mediapackage/pagination/ListChannelsPaginator.ts index 099590fbaec2f..f932dae3cb58b 100644 --- a/clients/client-mediapackage/pagination/ListChannelsPaginator.ts +++ b/clients/client-mediapackage/pagination/ListChannelsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaPackagePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaPackageClient, input: ListChannelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListChannelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaPackage, input: ListChannelsCommandInput, diff --git a/clients/client-mediapackage/pagination/ListHarvestJobsPaginator.ts b/clients/client-mediapackage/pagination/ListHarvestJobsPaginator.ts index c43d71011a568..983a423e4c96b 100644 --- a/clients/client-mediapackage/pagination/ListHarvestJobsPaginator.ts +++ b/clients/client-mediapackage/pagination/ListHarvestJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaPackagePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaPackageClient, input: ListHarvestJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHarvestJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaPackage, input: ListHarvestJobsCommandInput, diff --git a/clients/client-mediapackage/pagination/ListOriginEndpointsPaginator.ts b/clients/client-mediapackage/pagination/ListOriginEndpointsPaginator.ts index 8db72ddb18815..c78744b907a19 100644 --- a/clients/client-mediapackage/pagination/ListOriginEndpointsPaginator.ts +++ b/clients/client-mediapackage/pagination/ListOriginEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaPackagePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaPackageClient, input: ListOriginEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOriginEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaPackage, input: ListOriginEndpointsCommandInput, diff --git a/clients/client-mediapackage/runtimeConfig.browser.ts b/clients/client-mediapackage/runtimeConfig.browser.ts index 24c17753eabfb..f63a407304698 100644 --- a/clients/client-mediapackage/runtimeConfig.browser.ts +++ b/clients/client-mediapackage/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MediaPackageClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mediapackage/runtimeConfig.native.ts b/clients/client-mediapackage/runtimeConfig.native.ts index bb4055279f5ea..a554726da5a5f 100644 --- a/clients/client-mediapackage/runtimeConfig.native.ts +++ b/clients/client-mediapackage/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MediaPackageClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mediapackage/runtimeConfig.shared.ts b/clients/client-mediapackage/runtimeConfig.shared.ts index b2dd866f9b28e..61fd919e3aed2 100644 --- a/clients/client-mediapackage/runtimeConfig.shared.ts +++ b/clients/client-mediapackage/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-12", disableHostPrefix: false, diff --git a/clients/client-mediapackage/runtimeConfig.ts b/clients/client-mediapackage/runtimeConfig.ts index c7c003c37e3b4..faed062b5b34e 100644 --- a/clients/client-mediapackage/runtimeConfig.ts +++ b/clients/client-mediapackage/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MediaPackageClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mediapackage/tsconfig.json b/clients/client-mediapackage/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mediapackage/tsconfig.json +++ b/clients/client-mediapackage/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mediastore-data/commands/DeleteObjectCommand.ts b/clients/client-mediastore-data/commands/DeleteObjectCommand.ts index 18d04e2d15b73..cafd998a5c5fe 100644 --- a/clients/client-mediastore-data/commands/DeleteObjectCommand.ts +++ b/clients/client-mediastore-data/commands/DeleteObjectCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteObjectCommandInput = DeleteObjectRequest; export type DeleteObjectCommandOutput = DeleteObjectResponse & __MetadataBearer; +/** + *

Deletes an object at the specified path.

+ */ export class DeleteObjectCommand extends $Command< DeleteObjectCommandInput, DeleteObjectCommandOutput, @@ -34,6 +37,9 @@ export class DeleteObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreDataClientResolvedConfig, diff --git a/clients/client-mediastore-data/commands/DescribeObjectCommand.ts b/clients/client-mediastore-data/commands/DescribeObjectCommand.ts index 2b059d04c45fb..225658356eb3b 100644 --- a/clients/client-mediastore-data/commands/DescribeObjectCommand.ts +++ b/clients/client-mediastore-data/commands/DescribeObjectCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeObjectCommandInput = DescribeObjectRequest; export type DescribeObjectCommandOutput = DescribeObjectResponse & __MetadataBearer; +/** + *

Gets the headers for an object at the specified path.

+ */ export class DescribeObjectCommand extends $Command< DescribeObjectCommandInput, DescribeObjectCommandOutput, @@ -34,6 +37,9 @@ export class DescribeObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreDataClientResolvedConfig, diff --git a/clients/client-mediastore-data/commands/GetObjectCommand.ts b/clients/client-mediastore-data/commands/GetObjectCommand.ts index f665e80693b86..af408de22c8bd 100644 --- a/clients/client-mediastore-data/commands/GetObjectCommand.ts +++ b/clients/client-mediastore-data/commands/GetObjectCommand.ts @@ -20,6 +20,9 @@ import { export type GetObjectCommandInput = GetObjectRequest; export type GetObjectCommandOutput = GetObjectResponse & __MetadataBearer; +/** + *

Downloads the object at the specified path.

+ */ export class GetObjectCommand extends $Command< GetObjectCommandInput, GetObjectCommandOutput, @@ -34,6 +37,9 @@ export class GetObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreDataClientResolvedConfig, diff --git a/clients/client-mediastore-data/commands/ListItemsCommand.ts b/clients/client-mediastore-data/commands/ListItemsCommand.ts index 842f9c805d465..6bfc79cf98276 100644 --- a/clients/client-mediastore-data/commands/ListItemsCommand.ts +++ b/clients/client-mediastore-data/commands/ListItemsCommand.ts @@ -20,6 +20,10 @@ import { export type ListItemsCommandInput = ListItemsRequest; export type ListItemsCommandOutput = ListItemsResponse & __MetadataBearer; +/** + *

Provides a list of metadata entries about folders and objects in the specified + * folder.

+ */ export class ListItemsCommand extends $Command< ListItemsCommandInput, ListItemsCommandOutput, @@ -34,6 +38,9 @@ export class ListItemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreDataClientResolvedConfig, diff --git a/clients/client-mediastore-data/commands/PutObjectCommand.ts b/clients/client-mediastore-data/commands/PutObjectCommand.ts index 51d61292a8783..7ff5ac437b87a 100644 --- a/clients/client-mediastore-data/commands/PutObjectCommand.ts +++ b/clients/client-mediastore-data/commands/PutObjectCommand.ts @@ -22,6 +22,9 @@ export type PutObjectCommandInput = Omit & { }; export type PutObjectCommandOutput = PutObjectResponse & __MetadataBearer; +/** + *

Uploads an object to the specified path. Object sizes are limited to 25 MB.

+ */ export class PutObjectCommand extends $Command< PutObjectCommandInput, PutObjectCommandOutput, @@ -36,6 +39,9 @@ export class PutObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreDataClientResolvedConfig, diff --git a/clients/client-mediastore-data/package.json b/clients/client-mediastore-data/package.json index 1112b3b65326d..ee75689bf017b 100644 --- a/clients/client-mediastore-data/package.json +++ b/clients/client-mediastore-data/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mediastore Data Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mediastore-data/runtimeConfig.browser.ts b/clients/client-mediastore-data/runtimeConfig.browser.ts index c0e8454d5c81b..8e3adcb02d0ca 100644 --- a/clients/client-mediastore-data/runtimeConfig.browser.ts +++ b/clients/client-mediastore-data/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MediaStoreDataClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mediastore-data/runtimeConfig.native.ts b/clients/client-mediastore-data/runtimeConfig.native.ts index 107803441f287..f4fa4b4a5c531 100644 --- a/clients/client-mediastore-data/runtimeConfig.native.ts +++ b/clients/client-mediastore-data/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MediaStoreDataClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mediastore-data/runtimeConfig.shared.ts b/clients/client-mediastore-data/runtimeConfig.shared.ts index f0faacde948ee..c2397ab26a013 100644 --- a/clients/client-mediastore-data/runtimeConfig.shared.ts +++ b/clients/client-mediastore-data/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-09-01", disableHostPrefix: false, diff --git a/clients/client-mediastore-data/runtimeConfig.ts b/clients/client-mediastore-data/runtimeConfig.ts index 0d25e769f60ab..dc70773617c5b 100644 --- a/clients/client-mediastore-data/runtimeConfig.ts +++ b/clients/client-mediastore-data/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MediaStoreDataClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mediastore-data/tsconfig.json b/clients/client-mediastore-data/tsconfig.json index ae340a4f0a793..96029ca0ce876 100644 --- a/clients/client-mediastore-data/tsconfig.json +++ b/clients/client-mediastore-data/tsconfig.json @@ -17,13 +17,16 @@ "types": ["mocha"] }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mediastore/commands/CreateContainerCommand.ts b/clients/client-mediastore/commands/CreateContainerCommand.ts index 19d479f37c5be..632c2cc231794 100644 --- a/clients/client-mediastore/commands/CreateContainerCommand.ts +++ b/clients/client-mediastore/commands/CreateContainerCommand.ts @@ -20,6 +20,10 @@ import { export type CreateContainerCommandInput = CreateContainerInput; export type CreateContainerCommandOutput = CreateContainerOutput & __MetadataBearer; +/** + *

Creates a storage container to hold objects. A container is similar to a bucket in + * the Amazon S3 service.

+ */ export class CreateContainerCommand extends $Command< CreateContainerCommandInput, CreateContainerCommandOutput, @@ -34,6 +38,9 @@ export class CreateContainerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/DeleteContainerCommand.ts b/clients/client-mediastore/commands/DeleteContainerCommand.ts index 32f30423254e3..51265472e30e4 100644 --- a/clients/client-mediastore/commands/DeleteContainerCommand.ts +++ b/clients/client-mediastore/commands/DeleteContainerCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteContainerCommandInput = DeleteContainerInput; export type DeleteContainerCommandOutput = DeleteContainerOutput & __MetadataBearer; +/** + *

Deletes the specified container. Before you make a DeleteContainer + * request, delete any objects in the container or in any folders in the container. You can + * delete only empty containers.

+ */ export class DeleteContainerCommand extends $Command< DeleteContainerCommandInput, DeleteContainerCommandOutput, @@ -34,6 +39,9 @@ export class DeleteContainerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/DeleteContainerPolicyCommand.ts b/clients/client-mediastore/commands/DeleteContainerPolicyCommand.ts index 34dc04586e0f8..1de829a5b5a26 100644 --- a/clients/client-mediastore/commands/DeleteContainerPolicyCommand.ts +++ b/clients/client-mediastore/commands/DeleteContainerPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteContainerPolicyCommandInput = DeleteContainerPolicyInput; export type DeleteContainerPolicyCommandOutput = DeleteContainerPolicyOutput & __MetadataBearer; +/** + *

Deletes the access policy that is associated with the specified container.

+ */ export class DeleteContainerPolicyCommand extends $Command< DeleteContainerPolicyCommandInput, DeleteContainerPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteContainerPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/DeleteCorsPolicyCommand.ts b/clients/client-mediastore/commands/DeleteCorsPolicyCommand.ts index 56d7719dff5cf..a3d17c0639832 100644 --- a/clients/client-mediastore/commands/DeleteCorsPolicyCommand.ts +++ b/clients/client-mediastore/commands/DeleteCorsPolicyCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteCorsPolicyCommandInput = DeleteCorsPolicyInput; export type DeleteCorsPolicyCommandOutput = DeleteCorsPolicyOutput & __MetadataBearer; +/** + *

Deletes the cross-origin resource sharing (CORS) configuration information that is + * set for the container.

+ *

To use this operation, you must have permission to perform the + * MediaStore:DeleteCorsPolicy action. The container owner has this permission + * by default and can grant this permission to others.

+ */ export class DeleteCorsPolicyCommand extends $Command< DeleteCorsPolicyCommandInput, DeleteCorsPolicyCommandOutput, @@ -34,6 +41,9 @@ export class DeleteCorsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/DeleteLifecyclePolicyCommand.ts b/clients/client-mediastore/commands/DeleteLifecyclePolicyCommand.ts index e7c5ac544a292..ae44054b20467 100644 --- a/clients/client-mediastore/commands/DeleteLifecyclePolicyCommand.ts +++ b/clients/client-mediastore/commands/DeleteLifecyclePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLifecyclePolicyCommandInput = DeleteLifecyclePolicyInput; export type DeleteLifecyclePolicyCommandOutput = DeleteLifecyclePolicyOutput & __MetadataBearer; +/** + *

Removes an object lifecycle policy from a container. It takes up to 20 minutes for the change to take effect.

+ */ export class DeleteLifecyclePolicyCommand extends $Command< DeleteLifecyclePolicyCommandInput, DeleteLifecyclePolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/DeleteMetricPolicyCommand.ts b/clients/client-mediastore/commands/DeleteMetricPolicyCommand.ts index 9708a2a2115a1..339359c18e515 100644 --- a/clients/client-mediastore/commands/DeleteMetricPolicyCommand.ts +++ b/clients/client-mediastore/commands/DeleteMetricPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMetricPolicyCommandInput = DeleteMetricPolicyInput; export type DeleteMetricPolicyCommandOutput = DeleteMetricPolicyOutput & __MetadataBearer; +/** + *

Deletes the metric policy that is associated with the specified container. If there is no metric policy associated with the container, MediaStore doesn't send metrics to CloudWatch.

+ */ export class DeleteMetricPolicyCommand extends $Command< DeleteMetricPolicyCommandInput, DeleteMetricPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMetricPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/DescribeContainerCommand.ts b/clients/client-mediastore/commands/DescribeContainerCommand.ts index 75d4c540c52fb..1f850f5f60d52 100644 --- a/clients/client-mediastore/commands/DescribeContainerCommand.ts +++ b/clients/client-mediastore/commands/DescribeContainerCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeContainerCommandInput = DescribeContainerInput; export type DescribeContainerCommandOutput = DescribeContainerOutput & __MetadataBearer; +/** + *

Retrieves the properties of the requested container. This request is commonly used to + * retrieve the endpoint of a container. An endpoint is a value assigned by the service when a + * new container is created. A container's endpoint does not change after it has been + * assigned. The DescribeContainer request returns a single + * Container object based on ContainerName. To return all + * Container objects that are associated with a specified AWS account, use + * ListContainers.

+ */ export class DescribeContainerCommand extends $Command< DescribeContainerCommandInput, DescribeContainerCommandOutput, @@ -34,6 +43,9 @@ export class DescribeContainerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/GetContainerPolicyCommand.ts b/clients/client-mediastore/commands/GetContainerPolicyCommand.ts index 951c1855e33a3..d70344372184f 100644 --- a/clients/client-mediastore/commands/GetContainerPolicyCommand.ts +++ b/clients/client-mediastore/commands/GetContainerPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type GetContainerPolicyCommandInput = GetContainerPolicyInput; export type GetContainerPolicyCommandOutput = GetContainerPolicyOutput & __MetadataBearer; +/** + *

Retrieves the access policy for the specified container. For information about the + * data that is included in an access policy, see the AWS Identity and Access Management User + * Guide.

+ */ export class GetContainerPolicyCommand extends $Command< GetContainerPolicyCommandInput, GetContainerPolicyCommandOutput, @@ -34,6 +39,9 @@ export class GetContainerPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/GetCorsPolicyCommand.ts b/clients/client-mediastore/commands/GetCorsPolicyCommand.ts index 0458647db9697..2393d1a1a386e 100644 --- a/clients/client-mediastore/commands/GetCorsPolicyCommand.ts +++ b/clients/client-mediastore/commands/GetCorsPolicyCommand.ts @@ -20,6 +20,13 @@ import { export type GetCorsPolicyCommandInput = GetCorsPolicyInput; export type GetCorsPolicyCommandOutput = GetCorsPolicyOutput & __MetadataBearer; +/** + *

Returns the cross-origin resource sharing (CORS) configuration information that is + * set for the container.

+ *

To use this operation, you must have permission to perform the + * MediaStore:GetCorsPolicy action. By default, the container owner has this + * permission and can grant it to others.

+ */ export class GetCorsPolicyCommand extends $Command< GetCorsPolicyCommandInput, GetCorsPolicyCommandOutput, @@ -34,6 +41,9 @@ export class GetCorsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/GetLifecyclePolicyCommand.ts b/clients/client-mediastore/commands/GetLifecyclePolicyCommand.ts index 0251b1a496daa..b39ecfb1fd038 100644 --- a/clients/client-mediastore/commands/GetLifecyclePolicyCommand.ts +++ b/clients/client-mediastore/commands/GetLifecyclePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetLifecyclePolicyCommandInput = GetLifecyclePolicyInput; export type GetLifecyclePolicyCommandOutput = GetLifecyclePolicyOutput & __MetadataBearer; +/** + *

Retrieves the object lifecycle policy that is assigned to a container.

+ */ export class GetLifecyclePolicyCommand extends $Command< GetLifecyclePolicyCommandInput, GetLifecyclePolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/GetMetricPolicyCommand.ts b/clients/client-mediastore/commands/GetMetricPolicyCommand.ts index 8ce70e8b40a0d..4bf40453612b8 100644 --- a/clients/client-mediastore/commands/GetMetricPolicyCommand.ts +++ b/clients/client-mediastore/commands/GetMetricPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetMetricPolicyCommandInput = GetMetricPolicyInput; export type GetMetricPolicyCommandOutput = GetMetricPolicyOutput & __MetadataBearer; +/** + *

Returns the metric policy for the specified container.

+ */ export class GetMetricPolicyCommand extends $Command< GetMetricPolicyCommandInput, GetMetricPolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetMetricPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/ListContainersCommand.ts b/clients/client-mediastore/commands/ListContainersCommand.ts index 5c4fd81629f1a..92c28765f52e3 100644 --- a/clients/client-mediastore/commands/ListContainersCommand.ts +++ b/clients/client-mediastore/commands/ListContainersCommand.ts @@ -20,6 +20,17 @@ import { export type ListContainersCommandInput = ListContainersInput; export type ListContainersCommandOutput = ListContainersOutput & __MetadataBearer; +/** + *

Lists the properties of all containers in AWS Elemental MediaStore.

+ *

You can query to receive all the containers in one response. Or you can include the + * MaxResults parameter to receive a limited number of containers in each + * response. In this case, the response includes a token. To get the next set of containers, + * send the command again, this time with the NextToken parameter (with the + * returned token as its value). The next set of responses appears, with a token if there are + * still more containers to receive.

+ *

See also DescribeContainer, which gets the properties of one + * container.

+ */ export class ListContainersCommand extends $Command< ListContainersCommandInput, ListContainersCommandOutput, @@ -34,6 +45,9 @@ export class ListContainersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/ListTagsForResourceCommand.ts b/clients/client-mediastore/commands/ListTagsForResourceCommand.ts index 2632d3a70d20a..eef300e32a45a 100644 --- a/clients/client-mediastore/commands/ListTagsForResourceCommand.ts +++ b/clients/client-mediastore/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Returns a list of the tags assigned to the specified container.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/PutContainerPolicyCommand.ts b/clients/client-mediastore/commands/PutContainerPolicyCommand.ts index dde511d0f814a..3f8df694dab96 100644 --- a/clients/client-mediastore/commands/PutContainerPolicyCommand.ts +++ b/clients/client-mediastore/commands/PutContainerPolicyCommand.ts @@ -20,6 +20,15 @@ import { export type PutContainerPolicyCommandInput = PutContainerPolicyInput; export type PutContainerPolicyCommandOutput = PutContainerPolicyOutput & __MetadataBearer; +/** + *

Creates an access policy for the specified container to restrict the users and + * clients that can access it. For information about the data that is included in an access + * policy, see the AWS Identity and + * Access Management User Guide.

+ *

For this release of the REST API, you can create only one policy for a container. If + * you enter PutContainerPolicy twice, the second command modifies the existing + * policy.

+ */ export class PutContainerPolicyCommand extends $Command< PutContainerPolicyCommandInput, PutContainerPolicyCommandOutput, @@ -34,6 +43,9 @@ export class PutContainerPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/PutCorsPolicyCommand.ts b/clients/client-mediastore/commands/PutCorsPolicyCommand.ts index 330eafbc0685b..b54effb810616 100644 --- a/clients/client-mediastore/commands/PutCorsPolicyCommand.ts +++ b/clients/client-mediastore/commands/PutCorsPolicyCommand.ts @@ -20,6 +20,19 @@ import { export type PutCorsPolicyCommandInput = PutCorsPolicyInput; export type PutCorsPolicyCommandOutput = PutCorsPolicyOutput & __MetadataBearer; +/** + *

Sets the cross-origin resource sharing (CORS) configuration on a container so that + * the container can service cross-origin requests. For example, you might want to enable a + * request whose origin is http://www.example.com to access your AWS Elemental MediaStore + * container at my.example.container.com by using the browser's XMLHttpRequest + * capability.

+ *

To enable CORS on a container, you attach a CORS policy to the container. In the CORS + * policy, you configure rules that identify origins and the HTTP methods that can be executed + * on your container. The policy can contain up to 398,000 characters. You can add up to 100 + * rules to a CORS policy. If more than one rule applies, the service uses the first + * applicable rule listed.

+ *

To learn more about CORS, see Cross-Origin Resource Sharing (CORS) in AWS Elemental MediaStore.

+ */ export class PutCorsPolicyCommand extends $Command< PutCorsPolicyCommandInput, PutCorsPolicyCommandOutput, @@ -34,6 +47,9 @@ export class PutCorsPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/PutLifecyclePolicyCommand.ts b/clients/client-mediastore/commands/PutLifecyclePolicyCommand.ts index b54935f5dd169..c6c3861d45e55 100644 --- a/clients/client-mediastore/commands/PutLifecyclePolicyCommand.ts +++ b/clients/client-mediastore/commands/PutLifecyclePolicyCommand.ts @@ -20,6 +20,10 @@ import { export type PutLifecyclePolicyCommandInput = PutLifecyclePolicyInput; export type PutLifecyclePolicyCommandOutput = PutLifecyclePolicyOutput & __MetadataBearer; +/** + *

Writes an object lifecycle policy to a container. If the container already has an object lifecycle policy, the service replaces the existing policy with the new policy. It takes up to 20 minutes for the change to take effect.

+ *

For information about how to construct an object lifecycle policy, see Components of an Object Lifecycle Policy.

+ */ export class PutLifecyclePolicyCommand extends $Command< PutLifecyclePolicyCommandInput, PutLifecyclePolicyCommandOutput, @@ -34,6 +38,9 @@ export class PutLifecyclePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/PutMetricPolicyCommand.ts b/clients/client-mediastore/commands/PutMetricPolicyCommand.ts index cf350c7b4a0fc..410a5ec506e82 100644 --- a/clients/client-mediastore/commands/PutMetricPolicyCommand.ts +++ b/clients/client-mediastore/commands/PutMetricPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type PutMetricPolicyCommandInput = PutMetricPolicyInput; export type PutMetricPolicyCommandOutput = PutMetricPolicyOutput & __MetadataBearer; +/** + *

The metric policy that you want to add to the container. A metric policy allows AWS Elemental MediaStore to send metrics to Amazon CloudWatch. It takes up to 20 minutes for the new policy to take effect.

+ */ export class PutMetricPolicyCommand extends $Command< PutMetricPolicyCommandInput, PutMetricPolicyCommandOutput, @@ -34,6 +37,9 @@ export class PutMetricPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/StartAccessLoggingCommand.ts b/clients/client-mediastore/commands/StartAccessLoggingCommand.ts index 00c3a6483e9b9..8cf0b303eae0d 100644 --- a/clients/client-mediastore/commands/StartAccessLoggingCommand.ts +++ b/clients/client-mediastore/commands/StartAccessLoggingCommand.ts @@ -20,6 +20,9 @@ import { export type StartAccessLoggingCommandInput = StartAccessLoggingInput; export type StartAccessLoggingCommandOutput = StartAccessLoggingOutput & __MetadataBearer; +/** + *

Starts access logging on the specified container. When you enable access logging on a container, MediaStore delivers access logs for objects stored in that container to Amazon CloudWatch Logs.

+ */ export class StartAccessLoggingCommand extends $Command< StartAccessLoggingCommandInput, StartAccessLoggingCommandOutput, @@ -34,6 +37,9 @@ export class StartAccessLoggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/StopAccessLoggingCommand.ts b/clients/client-mediastore/commands/StopAccessLoggingCommand.ts index bbc4eeee65a7c..6dbe606a50abb 100644 --- a/clients/client-mediastore/commands/StopAccessLoggingCommand.ts +++ b/clients/client-mediastore/commands/StopAccessLoggingCommand.ts @@ -20,6 +20,9 @@ import { export type StopAccessLoggingCommandInput = StopAccessLoggingInput; export type StopAccessLoggingCommandOutput = StopAccessLoggingOutput & __MetadataBearer; +/** + *

Stops access logging on the specified container. When you stop access logging on a container, MediaStore stops sending access logs to Amazon CloudWatch Logs. These access logs are not saved and are not retrievable.

+ */ export class StopAccessLoggingCommand extends $Command< StopAccessLoggingCommandInput, StopAccessLoggingCommandOutput, @@ -34,6 +37,9 @@ export class StopAccessLoggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/TagResourceCommand.ts b/clients/client-mediastore/commands/TagResourceCommand.ts index 0c4f78e4ab87e..16ba443dc9367 100644 --- a/clients/client-mediastore/commands/TagResourceCommand.ts +++ b/clients/client-mediastore/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

Adds tags to the specified AWS Elemental MediaStore container. Tags are key:value pairs that you can associate with AWS resources. For example, the + * tag key might be "customer" and the tag value might be "companyA." You can specify one or more tags to add to each container. You can add up to 50 + * tags to each container. For more information about tagging, including naming and usage conventions, see Tagging Resources in MediaStore.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/commands/UntagResourceCommand.ts b/clients/client-mediastore/commands/UntagResourceCommand.ts index c4534a20e4aa8..3a4018d07d886 100644 --- a/clients/client-mediastore/commands/UntagResourceCommand.ts +++ b/clients/client-mediastore/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Removes tags from the specified container. You can specify one or more tags to remove.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaStoreClientResolvedConfig, diff --git a/clients/client-mediastore/package.json b/clients/client-mediastore/package.json index 66aa17e518874..0ec63cc540767 100644 --- a/clients/client-mediastore/package.json +++ b/clients/client-mediastore/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mediastore Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mediastore/pagination/ListContainersPaginator.ts b/clients/client-mediastore/pagination/ListContainersPaginator.ts index 57ebe195f2617..a0e3a11b9a814 100644 --- a/clients/client-mediastore/pagination/ListContainersPaginator.ts +++ b/clients/client-mediastore/pagination/ListContainersPaginator.ts @@ -8,6 +8,9 @@ import { import { MediaStorePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MediaStoreClient, input: ListContainersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListContainersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MediaStore, input: ListContainersCommandInput, diff --git a/clients/client-mediastore/runtimeConfig.browser.ts b/clients/client-mediastore/runtimeConfig.browser.ts index 6de511985d8a2..b1f8afbe04b6d 100644 --- a/clients/client-mediastore/runtimeConfig.browser.ts +++ b/clients/client-mediastore/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MediaStoreClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mediastore/runtimeConfig.native.ts b/clients/client-mediastore/runtimeConfig.native.ts index ff2f050b5ad64..35ed4f0e88ff2 100644 --- a/clients/client-mediastore/runtimeConfig.native.ts +++ b/clients/client-mediastore/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MediaStoreClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mediastore/runtimeConfig.shared.ts b/clients/client-mediastore/runtimeConfig.shared.ts index f0faacde948ee..c2397ab26a013 100644 --- a/clients/client-mediastore/runtimeConfig.shared.ts +++ b/clients/client-mediastore/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-09-01", disableHostPrefix: false, diff --git a/clients/client-mediastore/runtimeConfig.ts b/clients/client-mediastore/runtimeConfig.ts index dd394e5a1964d..c1ed36b0e902b 100644 --- a/clients/client-mediastore/runtimeConfig.ts +++ b/clients/client-mediastore/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MediaStoreClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mediastore/tsconfig.json b/clients/client-mediastore/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mediastore/tsconfig.json +++ b/clients/client-mediastore/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mediatailor/commands/DeletePlaybackConfigurationCommand.ts b/clients/client-mediatailor/commands/DeletePlaybackConfigurationCommand.ts index fbe1bb9137a8d..4573289454195 100644 --- a/clients/client-mediatailor/commands/DeletePlaybackConfigurationCommand.ts +++ b/clients/client-mediatailor/commands/DeletePlaybackConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePlaybackConfigurationCommandInput = DeletePlaybackConfigurationRequest; export type DeletePlaybackConfigurationCommandOutput = DeletePlaybackConfigurationResponse & __MetadataBearer; +/** + *

Deletes the playback configuration for the specified name.

+ */ export class DeletePlaybackConfigurationCommand extends $Command< DeletePlaybackConfigurationCommandInput, DeletePlaybackConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeletePlaybackConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaTailorClientResolvedConfig, diff --git a/clients/client-mediatailor/commands/GetPlaybackConfigurationCommand.ts b/clients/client-mediatailor/commands/GetPlaybackConfigurationCommand.ts index 718380ff73f55..614fae7390994 100644 --- a/clients/client-mediatailor/commands/GetPlaybackConfigurationCommand.ts +++ b/clients/client-mediatailor/commands/GetPlaybackConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetPlaybackConfigurationCommandInput = GetPlaybackConfigurationRequest; export type GetPlaybackConfigurationCommandOutput = GetPlaybackConfigurationResponse & __MetadataBearer; +/** + *

Returns the playback configuration for the specified name.

+ */ export class GetPlaybackConfigurationCommand extends $Command< GetPlaybackConfigurationCommandInput, GetPlaybackConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetPlaybackConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaTailorClientResolvedConfig, diff --git a/clients/client-mediatailor/commands/ListPlaybackConfigurationsCommand.ts b/clients/client-mediatailor/commands/ListPlaybackConfigurationsCommand.ts index 8c932afbfcfd2..5e4f954e0bdb4 100644 --- a/clients/client-mediatailor/commands/ListPlaybackConfigurationsCommand.ts +++ b/clients/client-mediatailor/commands/ListPlaybackConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPlaybackConfigurationsCommandInput = ListPlaybackConfigurationsRequest; export type ListPlaybackConfigurationsCommandOutput = ListPlaybackConfigurationsResponse & __MetadataBearer; +/** + *

Returns a list of the playback configurations defined in AWS Elemental MediaTailor. You can specify a maximum number of configurations to return at a time. The default maximum is 50. Results are returned in pagefuls. If MediaTailor has more configurations than the specified maximum, it provides parameters in the response that you can use to retrieve the next pageful.

+ */ export class ListPlaybackConfigurationsCommand extends $Command< ListPlaybackConfigurationsCommandInput, ListPlaybackConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class ListPlaybackConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaTailorClientResolvedConfig, diff --git a/clients/client-mediatailor/commands/ListTagsForResourceCommand.ts b/clients/client-mediatailor/commands/ListTagsForResourceCommand.ts index b668e2d3d6d59..6096d770f7009 100644 --- a/clients/client-mediatailor/commands/ListTagsForResourceCommand.ts +++ b/clients/client-mediatailor/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns a list of the tags assigned to the specified playback configuration resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaTailorClientResolvedConfig, diff --git a/clients/client-mediatailor/commands/PutPlaybackConfigurationCommand.ts b/clients/client-mediatailor/commands/PutPlaybackConfigurationCommand.ts index c7852542e6634..d2e4f60dfb093 100644 --- a/clients/client-mediatailor/commands/PutPlaybackConfigurationCommand.ts +++ b/clients/client-mediatailor/commands/PutPlaybackConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type PutPlaybackConfigurationCommandInput = PutPlaybackConfigurationRequest; export type PutPlaybackConfigurationCommandOutput = PutPlaybackConfigurationResponse & __MetadataBearer; +/** + *

Adds a new playback configuration to AWS Elemental MediaTailor.

+ */ export class PutPlaybackConfigurationCommand extends $Command< PutPlaybackConfigurationCommandInput, PutPlaybackConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class PutPlaybackConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaTailorClientResolvedConfig, diff --git a/clients/client-mediatailor/commands/TagResourceCommand.ts b/clients/client-mediatailor/commands/TagResourceCommand.ts index 875b50a4312f2..afaa19d296919 100644 --- a/clients/client-mediatailor/commands/TagResourceCommand.ts +++ b/clients/client-mediatailor/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds tags to the specified playback configuration resource. You can specify one or more tags to add.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaTailorClientResolvedConfig, diff --git a/clients/client-mediatailor/commands/UntagResourceCommand.ts b/clients/client-mediatailor/commands/UntagResourceCommand.ts index f8634a4a166ef..90b604911559a 100644 --- a/clients/client-mediatailor/commands/UntagResourceCommand.ts +++ b/clients/client-mediatailor/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes tags from the specified playback configuration resource. You can specify one or more tags to remove.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MediaTailorClientResolvedConfig, diff --git a/clients/client-mediatailor/package.json b/clients/client-mediatailor/package.json index 4700f30d7a095..05a0945c10cc3 100644 --- a/clients/client-mediatailor/package.json +++ b/clients/client-mediatailor/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mediatailor Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mediatailor/runtimeConfig.browser.ts b/clients/client-mediatailor/runtimeConfig.browser.ts index 07d04f5d24284..38f65ca914128 100644 --- a/clients/client-mediatailor/runtimeConfig.browser.ts +++ b/clients/client-mediatailor/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MediaTailorClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mediatailor/runtimeConfig.native.ts b/clients/client-mediatailor/runtimeConfig.native.ts index 703b2844e3237..21f532e35a469 100644 --- a/clients/client-mediatailor/runtimeConfig.native.ts +++ b/clients/client-mediatailor/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MediaTailorClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mediatailor/runtimeConfig.shared.ts b/clients/client-mediatailor/runtimeConfig.shared.ts index ff784a85b1bdd..cb07f1ce627e3 100644 --- a/clients/client-mediatailor/runtimeConfig.shared.ts +++ b/clients/client-mediatailor/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-04-23", disableHostPrefix: false, diff --git a/clients/client-mediatailor/runtimeConfig.ts b/clients/client-mediatailor/runtimeConfig.ts index 446d1c8ae72c0..cf2ac30a12ed7 100644 --- a/clients/client-mediatailor/runtimeConfig.ts +++ b/clients/client-mediatailor/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MediaTailorClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mediatailor/tsconfig.json b/clients/client-mediatailor/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mediatailor/tsconfig.json +++ b/clients/client-mediatailor/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-migration-hub/commands/AssociateCreatedArtifactCommand.ts b/clients/client-migration-hub/commands/AssociateCreatedArtifactCommand.ts index 4f017a45cd942..8fe2bdcbcea81 100644 --- a/clients/client-migration-hub/commands/AssociateCreatedArtifactCommand.ts +++ b/clients/client-migration-hub/commands/AssociateCreatedArtifactCommand.ts @@ -20,6 +20,26 @@ import { export type AssociateCreatedArtifactCommandInput = AssociateCreatedArtifactRequest; export type AssociateCreatedArtifactCommandOutput = AssociateCreatedArtifactResult & __MetadataBearer; +/** + *

Associates a created artifact of an AWS cloud resource, the target receiving the + * migration, with the migration task performed by a migration tool. This API has the + * following traits:

+ *
    + *
  • + *

    Migration tools can call the AssociateCreatedArtifact operation to + * indicate which AWS artifact is associated with a migration task.

    + *
  • + *
  • + *

    The created artifact name must be provided in ARN (Amazon Resource Name) format + * which will contain information about type and region; for example: + * arn:aws:ec2:us-east-1:488216288981:image/ami-6d0ba87b.

    + *
  • + *
  • + *

    Examples of the AWS resource behind the created artifact are, AMI's, EC2 instance, + * or DMS endpoint, etc.

    + *
  • + *
+ */ export class AssociateCreatedArtifactCommand extends $Command< AssociateCreatedArtifactCommandInput, AssociateCreatedArtifactCommandOutput, @@ -34,6 +54,9 @@ export class AssociateCreatedArtifactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/AssociateDiscoveredResourceCommand.ts b/clients/client-migration-hub/commands/AssociateDiscoveredResourceCommand.ts index eb6316e12a4d7..658c0dab9ce05 100644 --- a/clients/client-migration-hub/commands/AssociateDiscoveredResourceCommand.ts +++ b/clients/client-migration-hub/commands/AssociateDiscoveredResourceCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateDiscoveredResourceCommandInput = AssociateDiscoveredResourceRequest; export type AssociateDiscoveredResourceCommandOutput = AssociateDiscoveredResourceResult & __MetadataBearer; +/** + *

Associates a discovered resource ID from Application Discovery Service with a migration + * task.

+ */ export class AssociateDiscoveredResourceCommand extends $Command< AssociateDiscoveredResourceCommandInput, AssociateDiscoveredResourceCommandOutput, @@ -34,6 +38,9 @@ export class AssociateDiscoveredResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/CreateProgressUpdateStreamCommand.ts b/clients/client-migration-hub/commands/CreateProgressUpdateStreamCommand.ts index 124691f9c68f1..1b614358f5845 100644 --- a/clients/client-migration-hub/commands/CreateProgressUpdateStreamCommand.ts +++ b/clients/client-migration-hub/commands/CreateProgressUpdateStreamCommand.ts @@ -20,6 +20,13 @@ import { export type CreateProgressUpdateStreamCommandInput = CreateProgressUpdateStreamRequest; export type CreateProgressUpdateStreamCommandOutput = CreateProgressUpdateStreamResult & __MetadataBearer; +/** + *

Creates a progress update stream which is an AWS resource used for access control as + * well as a namespace for migration task names that is implicitly linked to your AWS account. + * It must uniquely identify the migration tool as it is used for all updates made by the + * tool; however, it does not need to be unique for each AWS account because it is scoped to + * the AWS account.

+ */ export class CreateProgressUpdateStreamCommand extends $Command< CreateProgressUpdateStreamCommandInput, CreateProgressUpdateStreamCommandOutput, @@ -34,6 +41,9 @@ export class CreateProgressUpdateStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/DeleteProgressUpdateStreamCommand.ts b/clients/client-migration-hub/commands/DeleteProgressUpdateStreamCommand.ts index 9d2cc5bb4c8ee..5995d9de67f1c 100644 --- a/clients/client-migration-hub/commands/DeleteProgressUpdateStreamCommand.ts +++ b/clients/client-migration-hub/commands/DeleteProgressUpdateStreamCommand.ts @@ -20,6 +20,39 @@ import { export type DeleteProgressUpdateStreamCommandInput = DeleteProgressUpdateStreamRequest; export type DeleteProgressUpdateStreamCommandOutput = DeleteProgressUpdateStreamResult & __MetadataBearer; +/** + *

Deletes a progress update stream, including all of its tasks, which was previously + * created as an AWS resource used for access control. This API has the following + * traits:

+ *
    + *
  • + *

    The only parameter needed for DeleteProgressUpdateStream is the + * stream name (same as a CreateProgressUpdateStream call).

    + *
  • + *
  • + *

    The call will return, and a background process will asynchronously delete the + * stream and all of its resources (tasks, associated resources, resource attributes, + * created artifacts).

    + *
  • + *
  • + *

    If the stream takes time to be deleted, it might still show up on a + * ListProgressUpdateStreams call.

    + *
  • + *
  • + *

    + * CreateProgressUpdateStream, ImportMigrationTask, + * NotifyMigrationTaskState, and all Associate[*] APIs related to the + * tasks belonging to the stream will throw "InvalidInputException" if the stream of the + * same name is in the process of being deleted.

    + *
  • + *
  • + *

    Once the stream and all of its resources are deleted, + * CreateProgressUpdateStream for a stream of the same name will + * succeed, and that stream will be an entirely new logical resource (without any + * resources associated with the old stream).

    + *
  • + *
+ */ export class DeleteProgressUpdateStreamCommand extends $Command< DeleteProgressUpdateStreamCommandInput, DeleteProgressUpdateStreamCommandOutput, @@ -34,6 +67,9 @@ export class DeleteProgressUpdateStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/DescribeApplicationStateCommand.ts b/clients/client-migration-hub/commands/DescribeApplicationStateCommand.ts index f1a16f0636e5e..7e0ff704a100d 100644 --- a/clients/client-migration-hub/commands/DescribeApplicationStateCommand.ts +++ b/clients/client-migration-hub/commands/DescribeApplicationStateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeApplicationStateCommandInput = DescribeApplicationStateRequest; export type DescribeApplicationStateCommandOutput = DescribeApplicationStateResult & __MetadataBearer; +/** + *

Gets the migration status of an application.

+ */ export class DescribeApplicationStateCommand extends $Command< DescribeApplicationStateCommandInput, DescribeApplicationStateCommandOutput, @@ -34,6 +37,9 @@ export class DescribeApplicationStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/DescribeMigrationTaskCommand.ts b/clients/client-migration-hub/commands/DescribeMigrationTaskCommand.ts index 4dacef439ffb1..5fb6c3245e734 100644 --- a/clients/client-migration-hub/commands/DescribeMigrationTaskCommand.ts +++ b/clients/client-migration-hub/commands/DescribeMigrationTaskCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMigrationTaskCommandInput = DescribeMigrationTaskRequest; export type DescribeMigrationTaskCommandOutput = DescribeMigrationTaskResult & __MetadataBearer; +/** + *

Retrieves a list of all attributes associated with a specific migration task.

+ */ export class DescribeMigrationTaskCommand extends $Command< DescribeMigrationTaskCommandInput, DescribeMigrationTaskCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMigrationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/DisassociateCreatedArtifactCommand.ts b/clients/client-migration-hub/commands/DisassociateCreatedArtifactCommand.ts index 9946245969b99..9454be5769a4b 100644 --- a/clients/client-migration-hub/commands/DisassociateCreatedArtifactCommand.ts +++ b/clients/client-migration-hub/commands/DisassociateCreatedArtifactCommand.ts @@ -20,6 +20,25 @@ import { export type DisassociateCreatedArtifactCommandInput = DisassociateCreatedArtifactRequest; export type DisassociateCreatedArtifactCommandOutput = DisassociateCreatedArtifactResult & __MetadataBearer; +/** + *

Disassociates a created artifact of an AWS resource with a migration task performed by a + * migration tool that was previously associated. This API has the following traits:

+ *
    + *
  • + *

    A migration user can call the DisassociateCreatedArtifacts operation + * to disassociate a created AWS Artifact from a migration task.

    + *
  • + *
  • + *

    The created artifact name must be provided in ARN (Amazon Resource Name) format + * which will contain information about type and region; for example: + * arn:aws:ec2:us-east-1:488216288981:image/ami-6d0ba87b.

    + *
  • + *
  • + *

    Examples of the AWS resource behind the created artifact are, AMI's, EC2 instance, + * or RDS instance, etc.

    + *
  • + *
+ */ export class DisassociateCreatedArtifactCommand extends $Command< DisassociateCreatedArtifactCommandInput, DisassociateCreatedArtifactCommandOutput, @@ -34,6 +53,9 @@ export class DisassociateCreatedArtifactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/DisassociateDiscoveredResourceCommand.ts b/clients/client-migration-hub/commands/DisassociateDiscoveredResourceCommand.ts index 115cef799a814..bb458231294e5 100644 --- a/clients/client-migration-hub/commands/DisassociateDiscoveredResourceCommand.ts +++ b/clients/client-migration-hub/commands/DisassociateDiscoveredResourceCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateDiscoveredResourceCommandInput = DisassociateDiscoveredResourceRequest; export type DisassociateDiscoveredResourceCommandOutput = DisassociateDiscoveredResourceResult & __MetadataBearer; +/** + *

Disassociate an Application Discovery Service discovered resource from a migration + * task.

+ */ export class DisassociateDiscoveredResourceCommand extends $Command< DisassociateDiscoveredResourceCommandInput, DisassociateDiscoveredResourceCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateDiscoveredResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/ImportMigrationTaskCommand.ts b/clients/client-migration-hub/commands/ImportMigrationTaskCommand.ts index a0007843e321e..c6e56bab59943 100644 --- a/clients/client-migration-hub/commands/ImportMigrationTaskCommand.ts +++ b/clients/client-migration-hub/commands/ImportMigrationTaskCommand.ts @@ -20,6 +20,12 @@ import { export type ImportMigrationTaskCommandInput = ImportMigrationTaskRequest; export type ImportMigrationTaskCommandOutput = ImportMigrationTaskResult & __MetadataBearer; +/** + *

Registers a new migration task which represents a server, database, etc., being migrated + * to AWS by a migration tool.

+ *

This API is a prerequisite to calling the NotifyMigrationTaskState API as + * the migration tool must first register the migration task with Migration Hub.

+ */ export class ImportMigrationTaskCommand extends $Command< ImportMigrationTaskCommandInput, ImportMigrationTaskCommandOutput, @@ -34,6 +40,9 @@ export class ImportMigrationTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/ListApplicationStatesCommand.ts b/clients/client-migration-hub/commands/ListApplicationStatesCommand.ts index bf3929c067bfb..db3673e9ba363 100644 --- a/clients/client-migration-hub/commands/ListApplicationStatesCommand.ts +++ b/clients/client-migration-hub/commands/ListApplicationStatesCommand.ts @@ -20,6 +20,11 @@ import { export type ListApplicationStatesCommandInput = ListApplicationStatesRequest; export type ListApplicationStatesCommandOutput = ListApplicationStatesResult & __MetadataBearer; +/** + *

Lists all the migration statuses for your applications. If you use the optional + * ApplicationIds parameter, only the migration statuses for those + * applications will be returned.

+ */ export class ListApplicationStatesCommand extends $Command< ListApplicationStatesCommandInput, ListApplicationStatesCommandOutput, @@ -34,6 +39,9 @@ export class ListApplicationStatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/ListCreatedArtifactsCommand.ts b/clients/client-migration-hub/commands/ListCreatedArtifactsCommand.ts index 66783b559a6be..ad54c6731fe8c 100644 --- a/clients/client-migration-hub/commands/ListCreatedArtifactsCommand.ts +++ b/clients/client-migration-hub/commands/ListCreatedArtifactsCommand.ts @@ -20,6 +20,23 @@ import { export type ListCreatedArtifactsCommandInput = ListCreatedArtifactsRequest; export type ListCreatedArtifactsCommandOutput = ListCreatedArtifactsResult & __MetadataBearer; +/** + *

Lists the created artifacts attached to a given migration task in an update stream. This + * API has the following traits:

+ *
    + *
  • + *

    Gets the list of the created artifacts while + * migration is taking place.

    + *
  • + *
  • + *

    Shows the artifacts created by the migration tool that was associated by the + * AssociateCreatedArtifact API.

    + *
  • + *
  • + *

    Lists created artifacts in a paginated interface.

    + *
  • + *
+ */ export class ListCreatedArtifactsCommand extends $Command< ListCreatedArtifactsCommandInput, ListCreatedArtifactsCommandOutput, @@ -34,6 +51,9 @@ export class ListCreatedArtifactsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/ListDiscoveredResourcesCommand.ts b/clients/client-migration-hub/commands/ListDiscoveredResourcesCommand.ts index 0aefc143f30aa..9fe5126bc178a 100644 --- a/clients/client-migration-hub/commands/ListDiscoveredResourcesCommand.ts +++ b/clients/client-migration-hub/commands/ListDiscoveredResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDiscoveredResourcesCommandInput = ListDiscoveredResourcesRequest; export type ListDiscoveredResourcesCommandOutput = ListDiscoveredResourcesResult & __MetadataBearer; +/** + *

Lists discovered resources associated with the given MigrationTask.

+ */ export class ListDiscoveredResourcesCommand extends $Command< ListDiscoveredResourcesCommandInput, ListDiscoveredResourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListDiscoveredResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/ListMigrationTasksCommand.ts b/clients/client-migration-hub/commands/ListMigrationTasksCommand.ts index ff5aa95a5af26..2d799de7c8a89 100644 --- a/clients/client-migration-hub/commands/ListMigrationTasksCommand.ts +++ b/clients/client-migration-hub/commands/ListMigrationTasksCommand.ts @@ -20,6 +20,22 @@ import { export type ListMigrationTasksCommandInput = ListMigrationTasksRequest; export type ListMigrationTasksCommandOutput = ListMigrationTasksResult & __MetadataBearer; +/** + *

Lists all, or filtered by resource name, migration tasks associated with the user + * account making this call. This API has the following traits:

+ *
    + *
  • + *

    Can show a summary list of the most recent migration tasks.

    + *
  • + *
  • + *

    Can show a summary list of migration tasks associated with a given discovered + * resource.

    + *
  • + *
  • + *

    Lists migration tasks in a paginated interface.

    + *
  • + *
+ */ export class ListMigrationTasksCommand extends $Command< ListMigrationTasksCommandInput, ListMigrationTasksCommandOutput, @@ -34,6 +50,9 @@ export class ListMigrationTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/ListProgressUpdateStreamsCommand.ts b/clients/client-migration-hub/commands/ListProgressUpdateStreamsCommand.ts index 5c1d41bb89dea..5b6907871496d 100644 --- a/clients/client-migration-hub/commands/ListProgressUpdateStreamsCommand.ts +++ b/clients/client-migration-hub/commands/ListProgressUpdateStreamsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProgressUpdateStreamsCommandInput = ListProgressUpdateStreamsRequest; export type ListProgressUpdateStreamsCommandOutput = ListProgressUpdateStreamsResult & __MetadataBearer; +/** + *

Lists progress update streams associated with the user account making this call.

+ */ export class ListProgressUpdateStreamsCommand extends $Command< ListProgressUpdateStreamsCommandInput, ListProgressUpdateStreamsCommandOutput, @@ -34,6 +37,9 @@ export class ListProgressUpdateStreamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/NotifyApplicationStateCommand.ts b/clients/client-migration-hub/commands/NotifyApplicationStateCommand.ts index 1d54443d5fb2e..0a608f616981d 100644 --- a/clients/client-migration-hub/commands/NotifyApplicationStateCommand.ts +++ b/clients/client-migration-hub/commands/NotifyApplicationStateCommand.ts @@ -20,6 +20,12 @@ import { export type NotifyApplicationStateCommandInput = NotifyApplicationStateRequest; export type NotifyApplicationStateCommandOutput = NotifyApplicationStateResult & __MetadataBearer; +/** + *

Sets the migration state of an application. For a given application identified by the + * value passed to ApplicationId, its status is set or updated by passing one of + * three values to Status: NOT_STARTED | IN_PROGRESS | + * COMPLETED.

+ */ export class NotifyApplicationStateCommand extends $Command< NotifyApplicationStateCommandInput, NotifyApplicationStateCommandOutput, @@ -34,6 +40,9 @@ export class NotifyApplicationStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/NotifyMigrationTaskStateCommand.ts b/clients/client-migration-hub/commands/NotifyMigrationTaskStateCommand.ts index da539055d9dc4..eaf25dce66a83 100644 --- a/clients/client-migration-hub/commands/NotifyMigrationTaskStateCommand.ts +++ b/clients/client-migration-hub/commands/NotifyMigrationTaskStateCommand.ts @@ -20,6 +20,26 @@ import { export type NotifyMigrationTaskStateCommandInput = NotifyMigrationTaskStateRequest; export type NotifyMigrationTaskStateCommandOutput = NotifyMigrationTaskStateResult & __MetadataBearer; +/** + *

Notifies Migration Hub of the current status, progress, or other detail regarding a + * migration task. This API has the following traits:

+ *
    + *
  • + *

    Migration tools will call the NotifyMigrationTaskState API to share + * the latest progress and status.

    + *
  • + *
  • + *

    + * MigrationTaskName is used for addressing updates to the correct + * target.

    + *
  • + *
  • + *

    + * ProgressUpdateStream is used for access control and to provide a + * namespace for each migration tool.

    + *
  • + *
+ */ export class NotifyMigrationTaskStateCommand extends $Command< NotifyMigrationTaskStateCommandInput, NotifyMigrationTaskStateCommandOutput, @@ -34,6 +54,9 @@ export class NotifyMigrationTaskStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/commands/PutResourceAttributesCommand.ts b/clients/client-migration-hub/commands/PutResourceAttributesCommand.ts index d411ebe9ac34e..effa9a827d7ff 100644 --- a/clients/client-migration-hub/commands/PutResourceAttributesCommand.ts +++ b/clients/client-migration-hub/commands/PutResourceAttributesCommand.ts @@ -20,6 +20,34 @@ import { export type PutResourceAttributesCommandInput = PutResourceAttributesRequest; export type PutResourceAttributesCommandOutput = PutResourceAttributesResult & __MetadataBearer; +/** + *

Provides identifying details of the resource being migrated so that it can be associated + * in the Application Discovery Service repository. This association occurs asynchronously + * after PutResourceAttributes returns.

+ * + *
    + *
  • + *

    Keep in mind that subsequent calls to PutResourceAttributes will override + * previously stored attributes. For example, if it is first called with a MAC + * address, but later, it is desired to add an IP address, it + * will then be required to call it with both the IP and MAC + * addresses to prevent overriding the MAC address.

    + *
  • + *
  • + *

    Note the instructions regarding the special use case of the + * ResourceAttributeList + * parameter when specifying any + * "VM" related value.

    + *
  • + *
+ *
+ * + * + *

Because this is an asynchronous call, it will always return 200, whether an + * association occurs or not. To confirm if an association was found based on the provided + * details, call ListDiscoveredResources.

+ *
+ */ export class PutResourceAttributesCommand extends $Command< PutResourceAttributesCommandInput, PutResourceAttributesCommandOutput, @@ -34,6 +62,9 @@ export class PutResourceAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubClientResolvedConfig, diff --git a/clients/client-migration-hub/package.json b/clients/client-migration-hub/package.json index 0c0f300ea7a3e..471d0dc93fa5d 100644 --- a/clients/client-migration-hub/package.json +++ b/clients/client-migration-hub/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Migration Hub Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-migration-hub/pagination/ListApplicationStatesPaginator.ts b/clients/client-migration-hub/pagination/ListApplicationStatesPaginator.ts index 78cee8f746baa..f1f07a96e7bdd 100644 --- a/clients/client-migration-hub/pagination/ListApplicationStatesPaginator.ts +++ b/clients/client-migration-hub/pagination/ListApplicationStatesPaginator.ts @@ -8,6 +8,9 @@ import { import { MigrationHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MigrationHubClient, input: ListApplicationStatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationStatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MigrationHub, input: ListApplicationStatesCommandInput, diff --git a/clients/client-migration-hub/pagination/ListCreatedArtifactsPaginator.ts b/clients/client-migration-hub/pagination/ListCreatedArtifactsPaginator.ts index 2712b3b954e62..5a9c01d1bd81e 100644 --- a/clients/client-migration-hub/pagination/ListCreatedArtifactsPaginator.ts +++ b/clients/client-migration-hub/pagination/ListCreatedArtifactsPaginator.ts @@ -8,6 +8,9 @@ import { import { MigrationHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MigrationHubClient, input: ListCreatedArtifactsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCreatedArtifactsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MigrationHub, input: ListCreatedArtifactsCommandInput, diff --git a/clients/client-migration-hub/pagination/ListDiscoveredResourcesPaginator.ts b/clients/client-migration-hub/pagination/ListDiscoveredResourcesPaginator.ts index 9d7b2e4b278fc..caa7f544083e0 100644 --- a/clients/client-migration-hub/pagination/ListDiscoveredResourcesPaginator.ts +++ b/clients/client-migration-hub/pagination/ListDiscoveredResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { MigrationHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MigrationHubClient, input: ListDiscoveredResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDiscoveredResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MigrationHub, input: ListDiscoveredResourcesCommandInput, diff --git a/clients/client-migration-hub/pagination/ListMigrationTasksPaginator.ts b/clients/client-migration-hub/pagination/ListMigrationTasksPaginator.ts index 1556cc0bf0cc0..18790dc0c250f 100644 --- a/clients/client-migration-hub/pagination/ListMigrationTasksPaginator.ts +++ b/clients/client-migration-hub/pagination/ListMigrationTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { MigrationHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MigrationHubClient, input: ListMigrationTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMigrationTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MigrationHub, input: ListMigrationTasksCommandInput, diff --git a/clients/client-migration-hub/pagination/ListProgressUpdateStreamsPaginator.ts b/clients/client-migration-hub/pagination/ListProgressUpdateStreamsPaginator.ts index 51c095797df76..dd5c2de623e52 100644 --- a/clients/client-migration-hub/pagination/ListProgressUpdateStreamsPaginator.ts +++ b/clients/client-migration-hub/pagination/ListProgressUpdateStreamsPaginator.ts @@ -8,6 +8,9 @@ import { import { MigrationHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MigrationHubClient, input: ListProgressUpdateStreamsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProgressUpdateStreamsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MigrationHub, input: ListProgressUpdateStreamsCommandInput, diff --git a/clients/client-migration-hub/runtimeConfig.browser.ts b/clients/client-migration-hub/runtimeConfig.browser.ts index f8a8d77f9e55f..3a5217e69614a 100644 --- a/clients/client-migration-hub/runtimeConfig.browser.ts +++ b/clients/client-migration-hub/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MigrationHubClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-migration-hub/runtimeConfig.native.ts b/clients/client-migration-hub/runtimeConfig.native.ts index 87dbbaddbbd0a..3e31aa7543c65 100644 --- a/clients/client-migration-hub/runtimeConfig.native.ts +++ b/clients/client-migration-hub/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MigrationHubClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-migration-hub/runtimeConfig.shared.ts b/clients/client-migration-hub/runtimeConfig.shared.ts index 793a62b83d04f..35ca96a9121b5 100644 --- a/clients/client-migration-hub/runtimeConfig.shared.ts +++ b/clients/client-migration-hub/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-05-31", disableHostPrefix: false, diff --git a/clients/client-migration-hub/runtimeConfig.ts b/clients/client-migration-hub/runtimeConfig.ts index ab814a9dbd907..7e49564037194 100644 --- a/clients/client-migration-hub/runtimeConfig.ts +++ b/clients/client-migration-hub/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MigrationHubClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-migration-hub/tsconfig.json b/clients/client-migration-hub/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-migration-hub/tsconfig.json +++ b/clients/client-migration-hub/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-migrationhub-config/commands/CreateHomeRegionControlCommand.ts b/clients/client-migrationhub-config/commands/CreateHomeRegionControlCommand.ts index a6476742c54ce..e27a86c95eb17 100644 --- a/clients/client-migrationhub-config/commands/CreateHomeRegionControlCommand.ts +++ b/clients/client-migrationhub-config/commands/CreateHomeRegionControlCommand.ts @@ -24,6 +24,9 @@ import { export type CreateHomeRegionControlCommandInput = CreateHomeRegionControlRequest; export type CreateHomeRegionControlCommandOutput = CreateHomeRegionControlResult & __MetadataBearer; +/** + *

This API sets up the home region for the calling account only.

+ */ export class CreateHomeRegionControlCommand extends $Command< CreateHomeRegionControlCommandInput, CreateHomeRegionControlCommandOutput, @@ -38,6 +41,9 @@ export class CreateHomeRegionControlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubConfigClientResolvedConfig, diff --git a/clients/client-migrationhub-config/commands/DescribeHomeRegionControlsCommand.ts b/clients/client-migrationhub-config/commands/DescribeHomeRegionControlsCommand.ts index 9e975194de85e..aa695fa9143ec 100644 --- a/clients/client-migrationhub-config/commands/DescribeHomeRegionControlsCommand.ts +++ b/clients/client-migrationhub-config/commands/DescribeHomeRegionControlsCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeHomeRegionControlsCommandInput = DescribeHomeRegionControlsRequest; export type DescribeHomeRegionControlsCommandOutput = DescribeHomeRegionControlsResult & __MetadataBearer; +/** + *

This API permits filtering on the ControlId and HomeRegion + * fields.

+ */ export class DescribeHomeRegionControlsCommand extends $Command< DescribeHomeRegionControlsCommandInput, DescribeHomeRegionControlsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeHomeRegionControlsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubConfigClientResolvedConfig, diff --git a/clients/client-migrationhub-config/commands/GetHomeRegionCommand.ts b/clients/client-migrationhub-config/commands/GetHomeRegionCommand.ts index dcce2cf5f92ee..47a761bc5c18e 100644 --- a/clients/client-migrationhub-config/commands/GetHomeRegionCommand.ts +++ b/clients/client-migrationhub-config/commands/GetHomeRegionCommand.ts @@ -24,6 +24,13 @@ import { export type GetHomeRegionCommandInput = GetHomeRegionRequest; export type GetHomeRegionCommandOutput = GetHomeRegionResult & __MetadataBearer; +/** + *

Returns the calling account’s home region, if configured. This API is used by other AWS + * services to determine the regional endpoint for calling AWS Application Discovery Service and + * Migration Hub. You must call GetHomeRegion at least once before you call any + * other AWS Application Discovery Service and AWS Migration Hub APIs, to obtain the account's + * Migration Hub home region.

+ */ export class GetHomeRegionCommand extends $Command< GetHomeRegionCommandInput, GetHomeRegionCommandOutput, @@ -38,6 +45,9 @@ export class GetHomeRegionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MigrationHubConfigClientResolvedConfig, diff --git a/clients/client-migrationhub-config/package.json b/clients/client-migrationhub-config/package.json index 1f5a208bb2f6e..b9c6607310882 100644 --- a/clients/client-migrationhub-config/package.json +++ b/clients/client-migrationhub-config/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Migrationhub Config Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-migrationhub-config/pagination/DescribeHomeRegionControlsPaginator.ts b/clients/client-migrationhub-config/pagination/DescribeHomeRegionControlsPaginator.ts index 90dbbd801698c..b27671dc9f578 100644 --- a/clients/client-migrationhub-config/pagination/DescribeHomeRegionControlsPaginator.ts +++ b/clients/client-migrationhub-config/pagination/DescribeHomeRegionControlsPaginator.ts @@ -8,6 +8,9 @@ import { import { MigrationHubConfigPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MigrationHubConfigClient, input: DescribeHomeRegionControlsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeHomeRegionControlsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MigrationHubConfig, input: DescribeHomeRegionControlsCommandInput, diff --git a/clients/client-migrationhub-config/runtimeConfig.browser.ts b/clients/client-migrationhub-config/runtimeConfig.browser.ts index fa1f135fd9ffb..1bf2bb8049418 100644 --- a/clients/client-migrationhub-config/runtimeConfig.browser.ts +++ b/clients/client-migrationhub-config/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MigrationHubConfigClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-migrationhub-config/runtimeConfig.native.ts b/clients/client-migrationhub-config/runtimeConfig.native.ts index 88785eb0e25cb..8d1f21b78e315 100644 --- a/clients/client-migrationhub-config/runtimeConfig.native.ts +++ b/clients/client-migrationhub-config/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MigrationHubConfigClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-migrationhub-config/runtimeConfig.shared.ts b/clients/client-migrationhub-config/runtimeConfig.shared.ts index c1c8fbcb3e4d0..56851c14bae2d 100644 --- a/clients/client-migrationhub-config/runtimeConfig.shared.ts +++ b/clients/client-migrationhub-config/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-06-30", disableHostPrefix: false, diff --git a/clients/client-migrationhub-config/runtimeConfig.ts b/clients/client-migrationhub-config/runtimeConfig.ts index 47f4c8a43bdd1..39dbea53eda8d 100644 --- a/clients/client-migrationhub-config/runtimeConfig.ts +++ b/clients/client-migrationhub-config/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MigrationHubConfigClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-migrationhub-config/tsconfig.json b/clients/client-migrationhub-config/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-migrationhub-config/tsconfig.json +++ b/clients/client-migrationhub-config/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mobile/commands/CreateProjectCommand.ts b/clients/client-mobile/commands/CreateProjectCommand.ts index 8f0cd5a61609a..a9f24ed802494 100644 --- a/clients/client-mobile/commands/CreateProjectCommand.ts +++ b/clients/client-mobile/commands/CreateProjectCommand.ts @@ -20,6 +20,11 @@ import { export type CreateProjectCommandInput = CreateProjectRequest; export type CreateProjectCommandOutput = CreateProjectResult & __MetadataBearer; +/** + *

+ * Creates an AWS Mobile Hub project. + *

+ */ export class CreateProjectCommand extends $Command< CreateProjectCommandInput, CreateProjectCommandOutput, @@ -34,6 +39,9 @@ export class CreateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/commands/DeleteProjectCommand.ts b/clients/client-mobile/commands/DeleteProjectCommand.ts index 56f0ba1068c0b..cd08c94162f7f 100644 --- a/clients/client-mobile/commands/DeleteProjectCommand.ts +++ b/clients/client-mobile/commands/DeleteProjectCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteProjectCommandInput = DeleteProjectRequest; export type DeleteProjectCommandOutput = DeleteProjectResult & __MetadataBearer; +/** + *

+ * Delets a project in AWS Mobile Hub. + *

+ */ export class DeleteProjectCommand extends $Command< DeleteProjectCommandInput, DeleteProjectCommandOutput, @@ -34,6 +39,9 @@ export class DeleteProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/commands/DescribeBundleCommand.ts b/clients/client-mobile/commands/DescribeBundleCommand.ts index dd3b4c2de9d1c..57c0359f23591 100644 --- a/clients/client-mobile/commands/DescribeBundleCommand.ts +++ b/clients/client-mobile/commands/DescribeBundleCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeBundleCommandInput = DescribeBundleRequest; export type DescribeBundleCommandOutput = DescribeBundleResult & __MetadataBearer; +/** + *

+ * Get the bundle details for the requested bundle id. + *

+ */ export class DescribeBundleCommand extends $Command< DescribeBundleCommandInput, DescribeBundleCommandOutput, @@ -34,6 +39,9 @@ export class DescribeBundleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/commands/DescribeProjectCommand.ts b/clients/client-mobile/commands/DescribeProjectCommand.ts index c3be1b2f99fe3..199c81b0f7aa9 100644 --- a/clients/client-mobile/commands/DescribeProjectCommand.ts +++ b/clients/client-mobile/commands/DescribeProjectCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeProjectCommandInput = DescribeProjectRequest; export type DescribeProjectCommandOutput = DescribeProjectResult & __MetadataBearer; +/** + *

+ * Gets details about a project in AWS Mobile Hub. + *

+ */ export class DescribeProjectCommand extends $Command< DescribeProjectCommandInput, DescribeProjectCommandOutput, @@ -34,6 +39,9 @@ export class DescribeProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/commands/ExportBundleCommand.ts b/clients/client-mobile/commands/ExportBundleCommand.ts index a224fd1060b6b..b46f7f146814e 100644 --- a/clients/client-mobile/commands/ExportBundleCommand.ts +++ b/clients/client-mobile/commands/ExportBundleCommand.ts @@ -20,6 +20,12 @@ import { export type ExportBundleCommandInput = ExportBundleRequest; export type ExportBundleCommandOutput = ExportBundleResult & __MetadataBearer; +/** + *

+ * Generates customized software development kit (SDK) and or tool packages + * used to integrate mobile web or mobile app clients with backend AWS resources. + *

+ */ export class ExportBundleCommand extends $Command< ExportBundleCommandInput, ExportBundleCommandOutput, @@ -34,6 +40,9 @@ export class ExportBundleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/commands/ExportProjectCommand.ts b/clients/client-mobile/commands/ExportProjectCommand.ts index 43eb3254a4dcf..5b31ce910d118 100644 --- a/clients/client-mobile/commands/ExportProjectCommand.ts +++ b/clients/client-mobile/commands/ExportProjectCommand.ts @@ -20,6 +20,13 @@ import { export type ExportProjectCommandInput = ExportProjectRequest; export type ExportProjectCommandOutput = ExportProjectResult & __MetadataBearer; +/** + *

+ * Exports project configuration to a snapshot which can be downloaded and shared. + * Note that mobile app push credentials are encrypted in exported projects, so they + * can only be shared successfully within the same AWS account. + *

+ */ export class ExportProjectCommand extends $Command< ExportProjectCommandInput, ExportProjectCommandOutput, @@ -34,6 +41,9 @@ export class ExportProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/commands/ListBundlesCommand.ts b/clients/client-mobile/commands/ListBundlesCommand.ts index 9c9c42e257afd..c31d36e5158c5 100644 --- a/clients/client-mobile/commands/ListBundlesCommand.ts +++ b/clients/client-mobile/commands/ListBundlesCommand.ts @@ -20,6 +20,11 @@ import { export type ListBundlesCommandInput = ListBundlesRequest; export type ListBundlesCommandOutput = ListBundlesResult & __MetadataBearer; +/** + *

+ * List all available bundles. + *

+ */ export class ListBundlesCommand extends $Command< ListBundlesCommandInput, ListBundlesCommandOutput, @@ -34,6 +39,9 @@ export class ListBundlesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/commands/ListProjectsCommand.ts b/clients/client-mobile/commands/ListProjectsCommand.ts index 53571b44f236f..c164057f33057 100644 --- a/clients/client-mobile/commands/ListProjectsCommand.ts +++ b/clients/client-mobile/commands/ListProjectsCommand.ts @@ -20,6 +20,11 @@ import { export type ListProjectsCommandInput = ListProjectsRequest; export type ListProjectsCommandOutput = ListProjectsResult & __MetadataBearer; +/** + *

+ * Lists projects in AWS Mobile Hub. + *

+ */ export class ListProjectsCommand extends $Command< ListProjectsCommandInput, ListProjectsCommandOutput, @@ -34,6 +39,9 @@ export class ListProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/commands/UpdateProjectCommand.ts b/clients/client-mobile/commands/UpdateProjectCommand.ts index 74a821f391d40..5473928d4cbdf 100644 --- a/clients/client-mobile/commands/UpdateProjectCommand.ts +++ b/clients/client-mobile/commands/UpdateProjectCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateProjectCommandInput = UpdateProjectRequest; export type UpdateProjectCommandOutput = UpdateProjectResult & __MetadataBearer; +/** + *

+ * Update an existing project. + *

+ */ export class UpdateProjectCommand extends $Command< UpdateProjectCommandInput, UpdateProjectCommandOutput, @@ -34,6 +39,9 @@ export class UpdateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MobileClientResolvedConfig, diff --git a/clients/client-mobile/package.json b/clients/client-mobile/package.json index f57e99d69071e..9fbba50f909ef 100644 --- a/clients/client-mobile/package.json +++ b/clients/client-mobile/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mobile Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mobile/pagination/ListBundlesPaginator.ts b/clients/client-mobile/pagination/ListBundlesPaginator.ts index 59fd0cd4358e6..f716889b2af2e 100644 --- a/clients/client-mobile/pagination/ListBundlesPaginator.ts +++ b/clients/client-mobile/pagination/ListBundlesPaginator.ts @@ -4,6 +4,9 @@ import { ListBundlesCommand, ListBundlesCommandInput, ListBundlesCommandOutput } import { MobilePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MobileClient, input: ListBundlesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBundlesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Mobile, input: ListBundlesCommandInput, diff --git a/clients/client-mobile/pagination/ListProjectsPaginator.ts b/clients/client-mobile/pagination/ListProjectsPaginator.ts index 5a00b8b165695..e5f7a8f598398 100644 --- a/clients/client-mobile/pagination/ListProjectsPaginator.ts +++ b/clients/client-mobile/pagination/ListProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { MobilePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MobileClient, input: ListProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Mobile, input: ListProjectsCommandInput, diff --git a/clients/client-mobile/runtimeConfig.browser.ts b/clients/client-mobile/runtimeConfig.browser.ts index 7048c4ff868b8..710ee79907078 100644 --- a/clients/client-mobile/runtimeConfig.browser.ts +++ b/clients/client-mobile/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MobileClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mobile/runtimeConfig.native.ts b/clients/client-mobile/runtimeConfig.native.ts index 1c9d95f492aca..84ba34ab5324d 100644 --- a/clients/client-mobile/runtimeConfig.native.ts +++ b/clients/client-mobile/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MobileClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mobile/runtimeConfig.shared.ts b/clients/client-mobile/runtimeConfig.shared.ts index ef1cf0be042c9..94f4f8047ed0f 100644 --- a/clients/client-mobile/runtimeConfig.shared.ts +++ b/clients/client-mobile/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-01", disableHostPrefix: false, diff --git a/clients/client-mobile/runtimeConfig.ts b/clients/client-mobile/runtimeConfig.ts index f52d1df850acd..3c4665f0c5f7c 100644 --- a/clients/client-mobile/runtimeConfig.ts +++ b/clients/client-mobile/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MobileClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mobile/tsconfig.json b/clients/client-mobile/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mobile/tsconfig.json +++ b/clients/client-mobile/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mq/commands/CreateBrokerCommand.ts b/clients/client-mq/commands/CreateBrokerCommand.ts index 9d1349dcb588f..f574c657860ab 100644 --- a/clients/client-mq/commands/CreateBrokerCommand.ts +++ b/clients/client-mq/commands/CreateBrokerCommand.ts @@ -20,6 +20,9 @@ import { export type CreateBrokerCommandInput = CreateBrokerRequest; export type CreateBrokerCommandOutput = CreateBrokerResponse & __MetadataBearer; +/** + * Creates a broker. Note: This API is asynchronous. + */ export class CreateBrokerCommand extends $Command< CreateBrokerCommandInput, CreateBrokerCommandOutput, @@ -34,6 +37,9 @@ export class CreateBrokerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/CreateConfigurationCommand.ts b/clients/client-mq/commands/CreateConfigurationCommand.ts index d8ce9e28cf121..3310175b8a1ec 100644 --- a/clients/client-mq/commands/CreateConfigurationCommand.ts +++ b/clients/client-mq/commands/CreateConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateConfigurationCommandInput = CreateConfigurationRequest; export type CreateConfigurationCommandOutput = CreateConfigurationResponse & __MetadataBearer; +/** + * Creates a new configuration for the specified configuration name. Amazon MQ uses the default configuration (the engine type and version). + */ export class CreateConfigurationCommand extends $Command< CreateConfigurationCommandInput, CreateConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class CreateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/CreateTagsCommand.ts b/clients/client-mq/commands/CreateTagsCommand.ts index 93eacccddc908..46f60019445fa 100644 --- a/clients/client-mq/commands/CreateTagsCommand.ts +++ b/clients/client-mq/commands/CreateTagsCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTagsCommandInput = CreateTagsRequest; export type CreateTagsCommandOutput = __MetadataBearer; +/** + * Add a tag to a resource. + */ export class CreateTagsCommand extends $Command< CreateTagsCommandInput, CreateTagsCommandOutput, @@ -34,6 +37,9 @@ export class CreateTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/CreateUserCommand.ts b/clients/client-mq/commands/CreateUserCommand.ts index 5404b669869ee..b7f98ddce26a2 100644 --- a/clients/client-mq/commands/CreateUserCommand.ts +++ b/clients/client-mq/commands/CreateUserCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResponse & __MetadataBearer; +/** + * Creates an ActiveMQ user. + */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -34,6 +37,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DeleteBrokerCommand.ts b/clients/client-mq/commands/DeleteBrokerCommand.ts index db8a7a5cb4b12..9518ad593c3c6 100644 --- a/clients/client-mq/commands/DeleteBrokerCommand.ts +++ b/clients/client-mq/commands/DeleteBrokerCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBrokerCommandInput = DeleteBrokerRequest; export type DeleteBrokerCommandOutput = DeleteBrokerResponse & __MetadataBearer; +/** + * Deletes a broker. Note: This API is asynchronous. + */ export class DeleteBrokerCommand extends $Command< DeleteBrokerCommandInput, DeleteBrokerCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBrokerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DeleteTagsCommand.ts b/clients/client-mq/commands/DeleteTagsCommand.ts index 24975be4f4ba2..37c8661e1e89a 100644 --- a/clients/client-mq/commands/DeleteTagsCommand.ts +++ b/clients/client-mq/commands/DeleteTagsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTagsCommandInput = DeleteTagsRequest; export type DeleteTagsCommandOutput = __MetadataBearer; +/** + * Removes a tag from a resource. + */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DeleteUserCommand.ts b/clients/client-mq/commands/DeleteUserCommand.ts index 4091e49019921..33942ab226533 100644 --- a/clients/client-mq/commands/DeleteUserCommand.ts +++ b/clients/client-mq/commands/DeleteUserCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = DeleteUserResponse & __MetadataBearer; +/** + * Deletes an ActiveMQ user. + */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DescribeBrokerCommand.ts b/clients/client-mq/commands/DescribeBrokerCommand.ts index 9edc6fce04644..b34923c5bb36b 100644 --- a/clients/client-mq/commands/DescribeBrokerCommand.ts +++ b/clients/client-mq/commands/DescribeBrokerCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBrokerCommandInput = DescribeBrokerRequest; export type DescribeBrokerCommandOutput = DescribeBrokerResponse & __MetadataBearer; +/** + * Returns information about the specified broker. + */ export class DescribeBrokerCommand extends $Command< DescribeBrokerCommandInput, DescribeBrokerCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBrokerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DescribeBrokerEngineTypesCommand.ts b/clients/client-mq/commands/DescribeBrokerEngineTypesCommand.ts index d86eb60302d3e..794d30d69826d 100644 --- a/clients/client-mq/commands/DescribeBrokerEngineTypesCommand.ts +++ b/clients/client-mq/commands/DescribeBrokerEngineTypesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBrokerEngineTypesCommandInput = DescribeBrokerEngineTypesRequest; export type DescribeBrokerEngineTypesCommandOutput = DescribeBrokerEngineTypesResponse & __MetadataBearer; +/** + * Describe available engine types and versions. + */ export class DescribeBrokerEngineTypesCommand extends $Command< DescribeBrokerEngineTypesCommandInput, DescribeBrokerEngineTypesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBrokerEngineTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DescribeBrokerInstanceOptionsCommand.ts b/clients/client-mq/commands/DescribeBrokerInstanceOptionsCommand.ts index 28c75960a4bb6..5bcd35d39e922 100644 --- a/clients/client-mq/commands/DescribeBrokerInstanceOptionsCommand.ts +++ b/clients/client-mq/commands/DescribeBrokerInstanceOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeBrokerInstanceOptionsCommandInput = DescribeBrokerInstanceOptionsRequest; export type DescribeBrokerInstanceOptionsCommandOutput = DescribeBrokerInstanceOptionsResponse & __MetadataBearer; +/** + * Describe available broker instance options. + */ export class DescribeBrokerInstanceOptionsCommand extends $Command< DescribeBrokerInstanceOptionsCommandInput, DescribeBrokerInstanceOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeBrokerInstanceOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DescribeConfigurationCommand.ts b/clients/client-mq/commands/DescribeConfigurationCommand.ts index 30dac116864d5..6e562ebed10a1 100644 --- a/clients/client-mq/commands/DescribeConfigurationCommand.ts +++ b/clients/client-mq/commands/DescribeConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeConfigurationCommandInput = DescribeConfigurationRequest; export type DescribeConfigurationCommandOutput = DescribeConfigurationResponse & __MetadataBearer; +/** + * Returns information about the specified configuration. + */ export class DescribeConfigurationCommand extends $Command< DescribeConfigurationCommandInput, DescribeConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DescribeConfigurationRevisionCommand.ts b/clients/client-mq/commands/DescribeConfigurationRevisionCommand.ts index 07a411f6eecb2..c0236c1878098 100644 --- a/clients/client-mq/commands/DescribeConfigurationRevisionCommand.ts +++ b/clients/client-mq/commands/DescribeConfigurationRevisionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeConfigurationRevisionCommandInput = DescribeConfigurationRevisionRequest; export type DescribeConfigurationRevisionCommandOutput = DescribeConfigurationRevisionResponse & __MetadataBearer; +/** + * Returns the specified configuration revision for the specified configuration. + */ export class DescribeConfigurationRevisionCommand extends $Command< DescribeConfigurationRevisionCommandInput, DescribeConfigurationRevisionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeConfigurationRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/DescribeUserCommand.ts b/clients/client-mq/commands/DescribeUserCommand.ts index ecf7164a572f5..835ed518324b3 100644 --- a/clients/client-mq/commands/DescribeUserCommand.ts +++ b/clients/client-mq/commands/DescribeUserCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserCommandInput = DescribeUserRequest; export type DescribeUserCommandOutput = DescribeUserResponse & __MetadataBearer; +/** + * Returns information about an ActiveMQ user. + */ export class DescribeUserCommand extends $Command< DescribeUserCommandInput, DescribeUserCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/ListBrokersCommand.ts b/clients/client-mq/commands/ListBrokersCommand.ts index 4766d2fea4d44..798832db8210f 100644 --- a/clients/client-mq/commands/ListBrokersCommand.ts +++ b/clients/client-mq/commands/ListBrokersCommand.ts @@ -20,6 +20,9 @@ import { export type ListBrokersCommandInput = ListBrokersRequest; export type ListBrokersCommandOutput = ListBrokersResponse & __MetadataBearer; +/** + * Returns a list of all brokers. + */ export class ListBrokersCommand extends $Command< ListBrokersCommandInput, ListBrokersCommandOutput, @@ -34,6 +37,9 @@ export class ListBrokersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/ListConfigurationRevisionsCommand.ts b/clients/client-mq/commands/ListConfigurationRevisionsCommand.ts index bf0f73e4e4d9a..ab33a50f89529 100644 --- a/clients/client-mq/commands/ListConfigurationRevisionsCommand.ts +++ b/clients/client-mq/commands/ListConfigurationRevisionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListConfigurationRevisionsCommandInput = ListConfigurationRevisionsRequest; export type ListConfigurationRevisionsCommandOutput = ListConfigurationRevisionsResponse & __MetadataBearer; +/** + * Returns a list of all revisions for the specified configuration. + */ export class ListConfigurationRevisionsCommand extends $Command< ListConfigurationRevisionsCommandInput, ListConfigurationRevisionsCommandOutput, @@ -34,6 +37,9 @@ export class ListConfigurationRevisionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/ListConfigurationsCommand.ts b/clients/client-mq/commands/ListConfigurationsCommand.ts index 9c51168dfaee6..bb3777e290b02 100644 --- a/clients/client-mq/commands/ListConfigurationsCommand.ts +++ b/clients/client-mq/commands/ListConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListConfigurationsCommandInput = ListConfigurationsRequest; export type ListConfigurationsCommandOutput = ListConfigurationsResponse & __MetadataBearer; +/** + * Returns a list of all configurations. + */ export class ListConfigurationsCommand extends $Command< ListConfigurationsCommandInput, ListConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class ListConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/ListTagsCommand.ts b/clients/client-mq/commands/ListTagsCommand.ts index 1023bcaab212e..58f496223956c 100644 --- a/clients/client-mq/commands/ListTagsCommand.ts +++ b/clients/client-mq/commands/ListTagsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResponse & __MetadataBearer; +/** + * Lists tags for a resource. + */ export class ListTagsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class ListTagsCommand extends $Command, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/ListUsersCommand.ts b/clients/client-mq/commands/ListUsersCommand.ts index e51fb0e69dc7f..c28e8ac84bcc6 100644 --- a/clients/client-mq/commands/ListUsersCommand.ts +++ b/clients/client-mq/commands/ListUsersCommand.ts @@ -20,6 +20,9 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + * Returns a list of all ActiveMQ users. + */ export class ListUsersCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class ListUsersCommand extends $Command, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/RebootBrokerCommand.ts b/clients/client-mq/commands/RebootBrokerCommand.ts index 290ddd56928de..e07e84fbd68d6 100644 --- a/clients/client-mq/commands/RebootBrokerCommand.ts +++ b/clients/client-mq/commands/RebootBrokerCommand.ts @@ -20,6 +20,9 @@ import { export type RebootBrokerCommandInput = RebootBrokerRequest; export type RebootBrokerCommandOutput = RebootBrokerResponse & __MetadataBearer; +/** + * Reboots a broker. Note: This API is asynchronous. + */ export class RebootBrokerCommand extends $Command< RebootBrokerCommandInput, RebootBrokerCommandOutput, @@ -34,6 +37,9 @@ export class RebootBrokerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/UpdateBrokerCommand.ts b/clients/client-mq/commands/UpdateBrokerCommand.ts index 9817ab8d77fcf..6c4be32644406 100644 --- a/clients/client-mq/commands/UpdateBrokerCommand.ts +++ b/clients/client-mq/commands/UpdateBrokerCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateBrokerCommandInput = UpdateBrokerRequest; export type UpdateBrokerCommandOutput = UpdateBrokerResponse & __MetadataBearer; +/** + * Adds a pending configuration change to a broker. + */ export class UpdateBrokerCommand extends $Command< UpdateBrokerCommandInput, UpdateBrokerCommandOutput, @@ -34,6 +37,9 @@ export class UpdateBrokerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/UpdateConfigurationCommand.ts b/clients/client-mq/commands/UpdateConfigurationCommand.ts index 68a6b6f87c714..ce1e324f43564 100644 --- a/clients/client-mq/commands/UpdateConfigurationCommand.ts +++ b/clients/client-mq/commands/UpdateConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConfigurationCommandInput = UpdateConfigurationRequest; export type UpdateConfigurationCommandOutput = UpdateConfigurationResponse & __MetadataBearer; +/** + * Updates the specified configuration. + */ export class UpdateConfigurationCommand extends $Command< UpdateConfigurationCommandInput, UpdateConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/commands/UpdateUserCommand.ts b/clients/client-mq/commands/UpdateUserCommand.ts index 023380a10ebea..5f5e4e50121cd 100644 --- a/clients/client-mq/commands/UpdateUserCommand.ts +++ b/clients/client-mq/commands/UpdateUserCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserCommandInput = UpdateUserRequest; export type UpdateUserCommandOutput = UpdateUserResponse & __MetadataBearer; +/** + * Updates the information for an ActiveMQ user. + */ export class UpdateUserCommand extends $Command< UpdateUserCommandInput, UpdateUserCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MqClientResolvedConfig, diff --git a/clients/client-mq/package.json b/clients/client-mq/package.json index a96f4dfe7bb5b..ec2d2b49c5ed4 100644 --- a/clients/client-mq/package.json +++ b/clients/client-mq/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mq Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mq/pagination/ListBrokersPaginator.ts b/clients/client-mq/pagination/ListBrokersPaginator.ts index a1c3cb47754b7..4fae13ef4a82e 100644 --- a/clients/client-mq/pagination/ListBrokersPaginator.ts +++ b/clients/client-mq/pagination/ListBrokersPaginator.ts @@ -4,6 +4,9 @@ import { ListBrokersCommand, ListBrokersCommandInput, ListBrokersCommandOutput } import { MqPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MqClient, input: ListBrokersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBrokersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Mq, input: ListBrokersCommandInput, diff --git a/clients/client-mq/runtimeConfig.browser.ts b/clients/client-mq/runtimeConfig.browser.ts index b88e762e87890..d189266cd8337 100644 --- a/clients/client-mq/runtimeConfig.browser.ts +++ b/clients/client-mq/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MqClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mq/runtimeConfig.native.ts b/clients/client-mq/runtimeConfig.native.ts index 3e9d397df76c4..0c06fe3b99b33 100644 --- a/clients/client-mq/runtimeConfig.native.ts +++ b/clients/client-mq/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MqClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mq/runtimeConfig.shared.ts b/clients/client-mq/runtimeConfig.shared.ts index 5d5c77a05bd16..de0d6cf01c194 100644 --- a/clients/client-mq/runtimeConfig.shared.ts +++ b/clients/client-mq/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-11-27", disableHostPrefix: false, diff --git a/clients/client-mq/runtimeConfig.ts b/clients/client-mq/runtimeConfig.ts index e5508f71bdbdb..65927b97b4e73 100644 --- a/clients/client-mq/runtimeConfig.ts +++ b/clients/client-mq/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MqClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mq/tsconfig.json b/clients/client-mq/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mq/tsconfig.json +++ b/clients/client-mq/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-mturk/commands/AcceptQualificationRequestCommand.ts b/clients/client-mturk/commands/AcceptQualificationRequestCommand.ts index b86847ea111ca..8bdc8f4f96e4f 100644 --- a/clients/client-mturk/commands/AcceptQualificationRequestCommand.ts +++ b/clients/client-mturk/commands/AcceptQualificationRequestCommand.ts @@ -20,6 +20,18 @@ import { export type AcceptQualificationRequestCommandInput = AcceptQualificationRequestRequest; export type AcceptQualificationRequestCommandOutput = AcceptQualificationRequestResponse & __MetadataBearer; +/** + *

+ * The AcceptQualificationRequest operation approves a Worker's request for a Qualification. + *

+ *

+ * Only the owner of the Qualification type can grant a Qualification request for that type. + *

+ *

+ * A successful request for the AcceptQualificationRequest operation + * returns with no errors and an empty body. + *

+ */ export class AcceptQualificationRequestCommand extends $Command< AcceptQualificationRequestCommandInput, AcceptQualificationRequestCommandOutput, @@ -34,6 +46,9 @@ export class AcceptQualificationRequestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ApproveAssignmentCommand.ts b/clients/client-mturk/commands/ApproveAssignmentCommand.ts index 20edb7ccdc8ca..ea8a152270434 100644 --- a/clients/client-mturk/commands/ApproveAssignmentCommand.ts +++ b/clients/client-mturk/commands/ApproveAssignmentCommand.ts @@ -20,6 +20,38 @@ import { export type ApproveAssignmentCommandInput = ApproveAssignmentRequest; export type ApproveAssignmentCommandOutput = ApproveAssignmentResponse & __MetadataBearer; +/** + *

+ * The ApproveAssignment operation approves the results of a completed assignment. + *

+ *

+ * Approving an assignment initiates two payments from the Requester's Amazon.com account + *

+ *
    + *
  • + *

    + * The Worker who submitted the results is paid the reward specified in the HIT. + *

    + *
  • + *
  • + *

    + * Amazon Mechanical Turk fees are debited. + *

    + *
  • + *
+ *

+ * If the Requester's account does not have adequate funds for these payments, + * the call to ApproveAssignment returns an exception, and the approval is not processed. + * You can include an optional feedback message with the approval, + * which the Worker can see in the Status section of the web site. + *

+ *

+ * You can also call this operation for assignments that were previous rejected + * and approve them by explicitly overriding the previous rejection. + * This only works on rejected assignments that were submitted within the previous 30 days + * and only if the assignment's related HIT has not been deleted. + *

+ */ export class ApproveAssignmentCommand extends $Command< ApproveAssignmentCommandInput, ApproveAssignmentCommandOutput, @@ -34,6 +66,9 @@ export class ApproveAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/AssociateQualificationWithWorkerCommand.ts b/clients/client-mturk/commands/AssociateQualificationWithWorkerCommand.ts index 2cd3a404ac1d6..7213512759637 100644 --- a/clients/client-mturk/commands/AssociateQualificationWithWorkerCommand.ts +++ b/clients/client-mturk/commands/AssociateQualificationWithWorkerCommand.ts @@ -20,6 +20,29 @@ import { export type AssociateQualificationWithWorkerCommandInput = AssociateQualificationWithWorkerRequest; export type AssociateQualificationWithWorkerCommandOutput = AssociateQualificationWithWorkerResponse & __MetadataBearer; +/** + *

+ * The AssociateQualificationWithWorker operation gives a Worker a + * Qualification. AssociateQualificationWithWorker does not require that the Worker + * submit a Qualification request. It gives the Qualification directly to the Worker. + *

+ * + *

+ * You can only assign a Qualification of a Qualification type that you created (using + * the CreateQualificationType operation). + *

+ * + * + *

+ * Note: AssociateQualificationWithWorker does not affect any pending Qualification + * requests for the Qualification by the Worker. If you assign a Qualification to a + * Worker, then later grant a Qualification request made by the Worker, the granting of + * the request may modify the Qualification score. To resolve a pending Qualification + * request without affecting the Qualification the Worker already has, reject the + * request with the RejectQualificationRequest operation. + *

+ *
+ */ export class AssociateQualificationWithWorkerCommand extends $Command< AssociateQualificationWithWorkerCommandInput, AssociateQualificationWithWorkerCommandOutput, @@ -34,6 +57,9 @@ export class AssociateQualificationWithWorkerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/CreateAdditionalAssignmentsForHITCommand.ts b/clients/client-mturk/commands/CreateAdditionalAssignmentsForHITCommand.ts index ea928e82d09e1..efd0c1b2ff8d2 100644 --- a/clients/client-mturk/commands/CreateAdditionalAssignmentsForHITCommand.ts +++ b/clients/client-mturk/commands/CreateAdditionalAssignmentsForHITCommand.ts @@ -24,6 +24,31 @@ export type CreateAdditionalAssignmentsForHITCommandInput = CreateAdditionalAssi export type CreateAdditionalAssignmentsForHITCommandOutput = CreateAdditionalAssignmentsForHITResponse & __MetadataBearer; +/** + *

+ * The + * CreateAdditionalAssignmentsForHIT + * operation increases the maximum number of assignments of an existing HIT. + *

+ *

+ * To extend the maximum number of assignments, specify the number of additional assignments.

+ * + *
    + *
  • + *

    HITs created with fewer than 10 assignments cannot be extended to have 10 or more assignments. Attempting to add assignments in a way that brings the total number of assignments for a HIT from fewer than 10 assignments to 10 or more + * assignments will result in an + * AWS.MechanicalTurk.InvalidMaximumAssignmentsIncrease + * exception.

    + *
  • + *
  • + *

    HITs that were created before July 22, 2015 cannot be extended. Attempting to extend HITs that were created before July 22, 2015 will result in an + * AWS.MechanicalTurk.HITTooOldForExtension + * exception. + *

    + *
  • + *
+ *
+ */ export class CreateAdditionalAssignmentsForHITCommand extends $Command< CreateAdditionalAssignmentsForHITCommandInput, CreateAdditionalAssignmentsForHITCommandOutput, @@ -38,6 +63,9 @@ export class CreateAdditionalAssignmentsForHITCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/CreateHITCommand.ts b/clients/client-mturk/commands/CreateHITCommand.ts index e8cb70ecf8817..038fcece62185 100644 --- a/clients/client-mturk/commands/CreateHITCommand.ts +++ b/clients/client-mturk/commands/CreateHITCommand.ts @@ -17,6 +17,25 @@ import { export type CreateHITCommandInput = CreateHITRequest; export type CreateHITCommandOutput = CreateHITResponse & __MetadataBearer; +/** + *

The CreateHIT operation creates a new Human Intelligence Task (HIT). + * The new HIT is made available for Workers to find and accept on the Amazon Mechanical + * Turk website.

+ *

+ * This operation allows you to specify a new HIT by passing in values for the properties of the HIT, such as its title, reward amount and number of assignments. When you pass these values to CreateHIT, a new HIT is created for you, with a new HITTypeID. The HITTypeID can be used to create additional HITs in the future without needing to specify common parameters such as the title, description and reward amount each time.

+ *

An alternative way to create HITs is to first generate a HITTypeID using the CreateHITType operation and then call the CreateHITWithHITType operation. This is the recommended best practice for Requesters who are creating large numbers of HITs. + *

+ * + *

CreateHIT also supports several ways to provide question data: by providing a value + * for the Question parameter that fully specifies the contents of the HIT, or by providing + * a HitLayoutId and associated HitLayoutParameters. + *

+ * + * + *

If a HIT is created with 10 or more maximum assignments, there is an additional fee. For more information, see + * Amazon Mechanical Turk Pricing.

+ *
+ */ export class CreateHITCommand extends $Command< CreateHITCommandInput, CreateHITCommandOutput, @@ -31,6 +50,9 @@ export class CreateHITCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/CreateHITTypeCommand.ts b/clients/client-mturk/commands/CreateHITTypeCommand.ts index 3c2179839de22..60ddac4dd475b 100644 --- a/clients/client-mturk/commands/CreateHITTypeCommand.ts +++ b/clients/client-mturk/commands/CreateHITTypeCommand.ts @@ -20,6 +20,14 @@ import { export type CreateHITTypeCommandInput = CreateHITTypeRequest; export type CreateHITTypeCommandOutput = CreateHITTypeResponse & __MetadataBearer; +/** + *

+ * The CreateHITType operation creates a new HIT type. This operation + * allows you to define a standard set of HIT properties to use when creating HITs. + * If you register a HIT type with values that match an existing HIT type, the HIT type + * ID of the existing type will be returned. + *

+ */ export class CreateHITTypeCommand extends $Command< CreateHITTypeCommandInput, CreateHITTypeCommandOutput, @@ -34,6 +42,9 @@ export class CreateHITTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/CreateHITWithHITTypeCommand.ts b/clients/client-mturk/commands/CreateHITWithHITTypeCommand.ts index 8c10e25cef5f8..d73556ac51051 100644 --- a/clients/client-mturk/commands/CreateHITWithHITTypeCommand.ts +++ b/clients/client-mturk/commands/CreateHITWithHITTypeCommand.ts @@ -20,6 +20,26 @@ import { export type CreateHITWithHITTypeCommandInput = CreateHITWithHITTypeRequest; export type CreateHITWithHITTypeCommandOutput = CreateHITWithHITTypeResponse & __MetadataBearer; +/** + *

+ * The CreateHITWithHITType operation creates a new Human Intelligence Task (HIT) + * using an existing HITTypeID generated by the CreateHITType operation. + *

+ *

+ * This is an alternative way to create HITs from the CreateHIT operation. + * This is the recommended best practice for Requesters who are creating large numbers of HITs. + *

+ *

CreateHITWithHITType also supports several ways to provide question data: + * by providing a value for the Question parameter that fully specifies the contents of the HIT, + * or by providing a HitLayoutId and associated HitLayoutParameters. + *

+ * + *

+ * If a HIT is created with 10 or more maximum assignments, there is an additional fee. + * For more information, see Amazon Mechanical Turk Pricing. + *

+ *
+ */ export class CreateHITWithHITTypeCommand extends $Command< CreateHITWithHITTypeCommandInput, CreateHITWithHITTypeCommandOutput, @@ -34,6 +54,9 @@ export class CreateHITWithHITTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/CreateQualificationTypeCommand.ts b/clients/client-mturk/commands/CreateQualificationTypeCommand.ts index 89444352048b0..0cf32aaad5607 100644 --- a/clients/client-mturk/commands/CreateQualificationTypeCommand.ts +++ b/clients/client-mturk/commands/CreateQualificationTypeCommand.ts @@ -20,6 +20,15 @@ import { export type CreateQualificationTypeCommandInput = CreateQualificationTypeRequest; export type CreateQualificationTypeCommandOutput = CreateQualificationTypeResponse & __MetadataBearer; +/** + *

+ * The + * CreateQualificationType + * operation creates a new Qualification type, which is represented by a + * QualificationType + * data structure. + *

+ */ export class CreateQualificationTypeCommand extends $Command< CreateQualificationTypeCommandInput, CreateQualificationTypeCommandOutput, @@ -34,6 +43,9 @@ export class CreateQualificationTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/CreateWorkerBlockCommand.ts b/clients/client-mturk/commands/CreateWorkerBlockCommand.ts index 7512474f77579..25a475bca6ab6 100644 --- a/clients/client-mturk/commands/CreateWorkerBlockCommand.ts +++ b/clients/client-mturk/commands/CreateWorkerBlockCommand.ts @@ -20,6 +20,9 @@ import { export type CreateWorkerBlockCommandInput = CreateWorkerBlockRequest; export type CreateWorkerBlockCommandOutput = CreateWorkerBlockResponse & __MetadataBearer; +/** + *

The CreateWorkerBlock operation allows you to prevent a Worker from working on your HITs. For example, you can block a Worker who is producing poor quality work. You can block up to 100,000 Workers.

+ */ export class CreateWorkerBlockCommand extends $Command< CreateWorkerBlockCommandInput, CreateWorkerBlockCommandOutput, @@ -34,6 +37,9 @@ export class CreateWorkerBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/DeleteHITCommand.ts b/clients/client-mturk/commands/DeleteHITCommand.ts index 86ab0e4ea7075..8d775c3d3fd37 100644 --- a/clients/client-mturk/commands/DeleteHITCommand.ts +++ b/clients/client-mturk/commands/DeleteHITCommand.ts @@ -17,6 +17,44 @@ import { export type DeleteHITCommandInput = DeleteHITRequest; export type DeleteHITCommandOutput = DeleteHITResponse & __MetadataBearer; +/** + *

+ * The DeleteHIT operation is used to delete HIT that is no longer needed. + * Only the Requester who created the HIT can delete it. + *

+ *

+ * You can only dispose of HITs that are in the Reviewable state, + * with all of their submitted assignments already either approved or rejected. + * If you call the DeleteHIT operation on a HIT that is not in the Reviewable state + * (for example, that has not expired, or still has active assignments), + * or on a HIT that is Reviewable but without all of its submitted assignments + * already approved or rejected, the service will return an error. + *

+ * + *
    + *
  • + *

    + * HITs are automatically disposed of after 120 days. + *

    + *
  • + *
  • + *

    + * After you dispose of a HIT, you can no longer approve the HIT's rejected assignments. + *

    + *
  • + *
  • + *

    + * Disposed HITs are not returned in results for the ListHITs operation. + *

    + *
  • + *
  • + *

    + * Disposing HITs can improve the performance of operations such as ListReviewableHITs and ListHITs. + *

    + *
  • + *
+ *
+ */ export class DeleteHITCommand extends $Command< DeleteHITCommandInput, DeleteHITCommandOutput, @@ -31,6 +69,9 @@ export class DeleteHITCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/DeleteQualificationTypeCommand.ts b/clients/client-mturk/commands/DeleteQualificationTypeCommand.ts index f0396a48df820..9dcc39993e08c 100644 --- a/clients/client-mturk/commands/DeleteQualificationTypeCommand.ts +++ b/clients/client-mturk/commands/DeleteQualificationTypeCommand.ts @@ -20,6 +20,27 @@ import { export type DeleteQualificationTypeCommandInput = DeleteQualificationTypeRequest; export type DeleteQualificationTypeCommandOutput = DeleteQualificationTypeResponse & __MetadataBearer; +/** + *

+ * The + * DeleteQualificationType + * deletes a Qualification type and deletes any HIT types that are + * associated with the Qualification type. + *

+ *

This operation does not revoke Qualifications already assigned + * to Workers because the Qualifications might be needed for active HITs. + * If there are any pending requests for the Qualification type, Amazon + * Mechanical Turk rejects those requests. After you delete a + * Qualification type, you can no longer use it to create HITs or HIT + * types.

+ * + *

DeleteQualificationType must wait for all the HITs that use + * the deleted Qualification type to be deleted before completing. It + * may take up to 48 hours before DeleteQualificationType completes and + * the unique name of the Qualification type is available for reuse with + * CreateQualificationType.

+ *
+ */ export class DeleteQualificationTypeCommand extends $Command< DeleteQualificationTypeCommandInput, DeleteQualificationTypeCommandOutput, @@ -34,6 +55,9 @@ export class DeleteQualificationTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/DeleteWorkerBlockCommand.ts b/clients/client-mturk/commands/DeleteWorkerBlockCommand.ts index 3b45ba3ad09a4..5c8fa73f038cf 100644 --- a/clients/client-mturk/commands/DeleteWorkerBlockCommand.ts +++ b/clients/client-mturk/commands/DeleteWorkerBlockCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteWorkerBlockCommandInput = DeleteWorkerBlockRequest; export type DeleteWorkerBlockCommandOutput = DeleteWorkerBlockResponse & __MetadataBearer; +/** + *

The DeleteWorkerBlock operation allows you to reinstate a blocked Worker to work on your HITs. This operation reverses the effects of the CreateWorkerBlock operation. You need the Worker ID to use this operation. If the Worker ID is missing or invalid, this operation fails and returns the message “WorkerId is invalid.” If the specified Worker is not blocked, this operation returns successfully.

+ */ export class DeleteWorkerBlockCommand extends $Command< DeleteWorkerBlockCommandInput, DeleteWorkerBlockCommandOutput, @@ -34,6 +37,9 @@ export class DeleteWorkerBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/DisassociateQualificationFromWorkerCommand.ts b/clients/client-mturk/commands/DisassociateQualificationFromWorkerCommand.ts index 8097f3cd68681..75dd5a66462b0 100644 --- a/clients/client-mturk/commands/DisassociateQualificationFromWorkerCommand.ts +++ b/clients/client-mturk/commands/DisassociateQualificationFromWorkerCommand.ts @@ -24,6 +24,16 @@ export type DisassociateQualificationFromWorkerCommandInput = DisassociateQualif export type DisassociateQualificationFromWorkerCommandOutput = DisassociateQualificationFromWorkerResponse & __MetadataBearer; +/** + *

+ * The DisassociateQualificationFromWorker + * revokes a previously granted Qualification from a user. + *

+ *

+ * You can provide a text message explaining why the Qualification was + * revoked. The user who had the Qualification can see this message. + *

+ */ export class DisassociateQualificationFromWorkerCommand extends $Command< DisassociateQualificationFromWorkerCommandInput, DisassociateQualificationFromWorkerCommandOutput, @@ -38,6 +48,9 @@ export class DisassociateQualificationFromWorkerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/GetAccountBalanceCommand.ts b/clients/client-mturk/commands/GetAccountBalanceCommand.ts index f9a0d0bd378ef..490c50e553751 100644 --- a/clients/client-mturk/commands/GetAccountBalanceCommand.ts +++ b/clients/client-mturk/commands/GetAccountBalanceCommand.ts @@ -20,6 +20,9 @@ import { export type GetAccountBalanceCommandInput = GetAccountBalanceRequest; export type GetAccountBalanceCommandOutput = GetAccountBalanceResponse & __MetadataBearer; +/** + *

The GetAccountBalance operation retrieves the amount of money in your Amazon Mechanical Turk account.

+ */ export class GetAccountBalanceCommand extends $Command< GetAccountBalanceCommandInput, GetAccountBalanceCommandOutput, @@ -34,6 +37,9 @@ export class GetAccountBalanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/GetAssignmentCommand.ts b/clients/client-mturk/commands/GetAssignmentCommand.ts index e7479c0e3f8cd..468e16838a79e 100644 --- a/clients/client-mturk/commands/GetAssignmentCommand.ts +++ b/clients/client-mturk/commands/GetAssignmentCommand.ts @@ -20,6 +20,11 @@ import { export type GetAssignmentCommandInput = GetAssignmentRequest; export type GetAssignmentCommandOutput = GetAssignmentResponse & __MetadataBearer; +/** + *

+ * The GetAssignment operation retrieves the details of the specified Assignment. + *

+ */ export class GetAssignmentCommand extends $Command< GetAssignmentCommandInput, GetAssignmentCommandOutput, @@ -34,6 +39,9 @@ export class GetAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/GetFileUploadURLCommand.ts b/clients/client-mturk/commands/GetFileUploadURLCommand.ts index 3309fe9f75868..c920453123ab1 100644 --- a/clients/client-mturk/commands/GetFileUploadURLCommand.ts +++ b/clients/client-mturk/commands/GetFileUploadURLCommand.ts @@ -20,6 +20,26 @@ import { export type GetFileUploadURLCommandInput = GetFileUploadURLRequest; export type GetFileUploadURLCommandOutput = GetFileUploadURLResponse & __MetadataBearer; +/** + *

+ * The + * GetFileUploadURL + * operation generates and returns a temporary URL. You use the + * temporary URL to retrieve a file uploaded by a Worker as an answer to + * a FileUploadAnswer question for a HIT. The temporary URL is generated + * the instant the GetFileUploadURL operation is called, and is valid + * for 60 seconds. You can get a temporary file upload URL any time + * until the HIT is disposed. After the HIT is disposed, any uploaded + * files are deleted, and cannot be retrieved. + * + * Pending Deprecation on December 12, 2017. The Answer Specification + * structure will no longer support the FileUploadAnswer + * element to be used for the QuestionForm data structure. + * Instead, we recommend that Requesters who want to create HITs asking + * Workers to upload files to use Amazon S3. + * + *

+ */ export class GetFileUploadURLCommand extends $Command< GetFileUploadURLCommandInput, GetFileUploadURLCommandOutput, @@ -34,6 +54,9 @@ export class GetFileUploadURLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/GetHITCommand.ts b/clients/client-mturk/commands/GetHITCommand.ts index 5f62b3eac4913..9f4037ef39468 100644 --- a/clients/client-mturk/commands/GetHITCommand.ts +++ b/clients/client-mturk/commands/GetHITCommand.ts @@ -17,6 +17,11 @@ import { export type GetHITCommandInput = GetHITRequest; export type GetHITCommandOutput = GetHITResponse & __MetadataBearer; +/** + *

+ * The GetHIT operation retrieves the details of the specified HIT. + *

+ */ export class GetHITCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +32,9 @@ export class GetHITCommand extends $Command, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/GetQualificationScoreCommand.ts b/clients/client-mturk/commands/GetQualificationScoreCommand.ts index e51bd30e8e292..18ee40825b89d 100644 --- a/clients/client-mturk/commands/GetQualificationScoreCommand.ts +++ b/clients/client-mturk/commands/GetQualificationScoreCommand.ts @@ -20,6 +20,22 @@ import { export type GetQualificationScoreCommandInput = GetQualificationScoreRequest; export type GetQualificationScoreCommandOutput = GetQualificationScoreResponse & __MetadataBearer; +/** + *

+ * The + * GetQualificationScore + * operation returns the value of a Worker's Qualification for a given + * Qualification type. + *

+ *

+ * To get a Worker's Qualification, you must know the Worker's ID. The + * Worker's ID is included in the assignment data returned by the + * ListAssignmentsForHIT + * operation. + *

+ *

Only the owner of a Qualification type can query the value of + * a Worker's Qualification of that type.

+ */ export class GetQualificationScoreCommand extends $Command< GetQualificationScoreCommandInput, GetQualificationScoreCommandOutput, @@ -34,6 +50,9 @@ export class GetQualificationScoreCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/GetQualificationTypeCommand.ts b/clients/client-mturk/commands/GetQualificationTypeCommand.ts index b98068b71b348..8429d8293260a 100644 --- a/clients/client-mturk/commands/GetQualificationTypeCommand.ts +++ b/clients/client-mturk/commands/GetQualificationTypeCommand.ts @@ -20,6 +20,11 @@ import { export type GetQualificationTypeCommandInput = GetQualificationTypeRequest; export type GetQualificationTypeCommandOutput = GetQualificationTypeResponse & __MetadataBearer; +/** + *

+ * The GetQualificationTypeoperation retrieves information about a Qualification type using its ID. + *

+ */ export class GetQualificationTypeCommand extends $Command< GetQualificationTypeCommandInput, GetQualificationTypeCommandOutput, @@ -34,6 +39,9 @@ export class GetQualificationTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListAssignmentsForHITCommand.ts b/clients/client-mturk/commands/ListAssignmentsForHITCommand.ts index 2c11b6fe9c5b7..3c92a75ad530e 100644 --- a/clients/client-mturk/commands/ListAssignmentsForHITCommand.ts +++ b/clients/client-mturk/commands/ListAssignmentsForHITCommand.ts @@ -20,6 +20,35 @@ import { export type ListAssignmentsForHITCommandInput = ListAssignmentsForHITRequest; export type ListAssignmentsForHITCommandOutput = ListAssignmentsForHITResponse & __MetadataBearer; +/** + *

+ * The + * ListAssignmentsForHIT + * operation retrieves completed assignments for a HIT. You can use this + * operation to retrieve the results for a HIT. + *

+ *

You can get assignments for a HIT at any time, even if the + * HIT is not yet Reviewable. If a HIT requested multiple assignments, + * and has received some results but has not yet become Reviewable, you + * can still retrieve the partial results with this operation. + *

+ *

Use the AssignmentStatus parameter to control which set of + * assignments for a HIT are returned. The ListAssignmentsForHIT + * operation + * can return submitted assignments awaiting approval, or it can return + * assignments that have already been approved or rejected. You can set + * AssignmentStatus=Approved,Rejected to get assignments that have + * already been approved and rejected together in one result set. + *

+ *

Only the Requester who created the HIT can retrieve the + * assignments for that HIT. + *

+ *

Results are sorted and divided into numbered pages and the + * operation returns a single page of results. You can use the + * parameters + * of the operation to control sorting and pagination. + *

+ */ export class ListAssignmentsForHITCommand extends $Command< ListAssignmentsForHITCommandInput, ListAssignmentsForHITCommandOutput, @@ -34,6 +63,9 @@ export class ListAssignmentsForHITCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListBonusPaymentsCommand.ts b/clients/client-mturk/commands/ListBonusPaymentsCommand.ts index c74e7bddef618..50d8835a9f462 100644 --- a/clients/client-mturk/commands/ListBonusPaymentsCommand.ts +++ b/clients/client-mturk/commands/ListBonusPaymentsCommand.ts @@ -20,6 +20,14 @@ import { export type ListBonusPaymentsCommandInput = ListBonusPaymentsRequest; export type ListBonusPaymentsCommandOutput = ListBonusPaymentsResponse & __MetadataBearer; +/** + *

+ * The + * ListBonusPayments + * operation retrieves the amounts of bonuses you have paid to Workers + * for a given HIT or assignment. + *

+ */ export class ListBonusPaymentsCommand extends $Command< ListBonusPaymentsCommandInput, ListBonusPaymentsCommandOutput, @@ -34,6 +42,9 @@ export class ListBonusPaymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListHITsCommand.ts b/clients/client-mturk/commands/ListHITsCommand.ts index 0f3efc3ece3d3..982d040e17ff6 100644 --- a/clients/client-mturk/commands/ListHITsCommand.ts +++ b/clients/client-mturk/commands/ListHITsCommand.ts @@ -17,6 +17,15 @@ import { export type ListHITsCommandInput = ListHITsRequest; export type ListHITsCommandOutput = ListHITsResponse & __MetadataBearer; +/** + *

+ * The + * ListHITs + * operation returns all of a Requester's HITs. The operation returns + * HITs of any status, except for HITs that have been deleted of with + * the DeleteHIT operation or that have been auto-deleted. + *

+ */ export class ListHITsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +36,9 @@ export class ListHITsCommand extends $Command, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListHITsForQualificationTypeCommand.ts b/clients/client-mturk/commands/ListHITsForQualificationTypeCommand.ts index 4f820f2023eea..a94e191cda905 100644 --- a/clients/client-mturk/commands/ListHITsForQualificationTypeCommand.ts +++ b/clients/client-mturk/commands/ListHITsForQualificationTypeCommand.ts @@ -20,6 +20,14 @@ import { export type ListHITsForQualificationTypeCommandInput = ListHITsForQualificationTypeRequest; export type ListHITsForQualificationTypeCommandOutput = ListHITsForQualificationTypeResponse & __MetadataBearer; +/** + *

+ * The ListHITsForQualificationType operation returns the HITs that use + * the given Qualification type for a Qualification requirement. + * The operation returns HITs of any status, except for HITs that have been deleted + * with the DeleteHIT operation or that have been auto-deleted. + *

+ */ export class ListHITsForQualificationTypeCommand extends $Command< ListHITsForQualificationTypeCommandInput, ListHITsForQualificationTypeCommandOutput, @@ -34,6 +42,9 @@ export class ListHITsForQualificationTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListQualificationRequestsCommand.ts b/clients/client-mturk/commands/ListQualificationRequestsCommand.ts index 6c52850eea8a8..356e36a87d665 100644 --- a/clients/client-mturk/commands/ListQualificationRequestsCommand.ts +++ b/clients/client-mturk/commands/ListQualificationRequestsCommand.ts @@ -20,6 +20,16 @@ import { export type ListQualificationRequestsCommandInput = ListQualificationRequestsRequest; export type ListQualificationRequestsCommandOutput = ListQualificationRequestsResponse & __MetadataBearer; +/** + *

+ * The + * ListQualificationRequests + * operation retrieves requests for Qualifications of a particular + * Qualification type. The owner of the Qualification type calls this + * operation to poll for pending requests, and accepts them using the + * AcceptQualification operation. + *

+ */ export class ListQualificationRequestsCommand extends $Command< ListQualificationRequestsCommandInput, ListQualificationRequestsCommandOutput, @@ -34,6 +44,9 @@ export class ListQualificationRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListQualificationTypesCommand.ts b/clients/client-mturk/commands/ListQualificationTypesCommand.ts index 2cae6509e9106..26213ac71396f 100644 --- a/clients/client-mturk/commands/ListQualificationTypesCommand.ts +++ b/clients/client-mturk/commands/ListQualificationTypesCommand.ts @@ -20,6 +20,14 @@ import { export type ListQualificationTypesCommandInput = ListQualificationTypesRequest; export type ListQualificationTypesCommandOutput = ListQualificationTypesResponse & __MetadataBearer; +/** + *

+ * The + * ListQualificationTypes + * operation returns a list of Qualification types, filtered by + * an optional search term. + *

+ */ export class ListQualificationTypesCommand extends $Command< ListQualificationTypesCommandInput, ListQualificationTypesCommandOutput, @@ -34,6 +42,9 @@ export class ListQualificationTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListReviewPolicyResultsForHITCommand.ts b/clients/client-mturk/commands/ListReviewPolicyResultsForHITCommand.ts index 7a3351ef65ded..b52165acbe46c 100644 --- a/clients/client-mturk/commands/ListReviewPolicyResultsForHITCommand.ts +++ b/clients/client-mturk/commands/ListReviewPolicyResultsForHITCommand.ts @@ -20,6 +20,15 @@ import { export type ListReviewPolicyResultsForHITCommandInput = ListReviewPolicyResultsForHITRequest; export type ListReviewPolicyResultsForHITCommandOutput = ListReviewPolicyResultsForHITResponse & __MetadataBearer; +/** + *

+ * The ListReviewPolicyResultsForHIT operation retrieves the computed results + * and the actions taken in the course of executing your Review Policies for a given HIT. + * For information about how to specify Review Policies when you call CreateHIT, + * see Review Policies. The ListReviewPolicyResultsForHIT operation can return results for both + * Assignment-level and HIT-level review results. + *

+ */ export class ListReviewPolicyResultsForHITCommand extends $Command< ListReviewPolicyResultsForHITCommandInput, ListReviewPolicyResultsForHITCommandOutput, @@ -34,6 +43,9 @@ export class ListReviewPolicyResultsForHITCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListReviewableHITsCommand.ts b/clients/client-mturk/commands/ListReviewableHITsCommand.ts index 01cb77517a33e..44d61e480f0b3 100644 --- a/clients/client-mturk/commands/ListReviewableHITsCommand.ts +++ b/clients/client-mturk/commands/ListReviewableHITsCommand.ts @@ -20,6 +20,12 @@ import { export type ListReviewableHITsCommandInput = ListReviewableHITsRequest; export type ListReviewableHITsCommandOutput = ListReviewableHITsResponse & __MetadataBearer; +/** + *

+ * The ListReviewableHITs operation retrieves the HITs with Status equal to + * Reviewable or Status equal to Reviewing that belong to the Requester calling the operation. + *

+ */ export class ListReviewableHITsCommand extends $Command< ListReviewableHITsCommandInput, ListReviewableHITsCommandOutput, @@ -34,6 +40,9 @@ export class ListReviewableHITsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListWorkerBlocksCommand.ts b/clients/client-mturk/commands/ListWorkerBlocksCommand.ts index 1f67dd0438039..2f2d1af483851 100644 --- a/clients/client-mturk/commands/ListWorkerBlocksCommand.ts +++ b/clients/client-mturk/commands/ListWorkerBlocksCommand.ts @@ -20,6 +20,9 @@ import { export type ListWorkerBlocksCommandInput = ListWorkerBlocksRequest; export type ListWorkerBlocksCommandOutput = ListWorkerBlocksResponse & __MetadataBearer; +/** + *

The ListWorkersBlocks operation retrieves a list of Workers who are blocked from working on your HITs.

+ */ export class ListWorkerBlocksCommand extends $Command< ListWorkerBlocksCommandInput, ListWorkerBlocksCommandOutput, @@ -34,6 +37,9 @@ export class ListWorkerBlocksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/ListWorkersWithQualificationTypeCommand.ts b/clients/client-mturk/commands/ListWorkersWithQualificationTypeCommand.ts index 449e6837f9e3c..b958af4c0fb27 100644 --- a/clients/client-mturk/commands/ListWorkersWithQualificationTypeCommand.ts +++ b/clients/client-mturk/commands/ListWorkersWithQualificationTypeCommand.ts @@ -20,6 +20,12 @@ import { export type ListWorkersWithQualificationTypeCommandInput = ListWorkersWithQualificationTypeRequest; export type ListWorkersWithQualificationTypeCommandOutput = ListWorkersWithQualificationTypeResponse & __MetadataBearer; +/** + *

+ * The ListWorkersWithQualificationType operation returns all of the Workers + * that have been associated with a given Qualification type. + *

+ */ export class ListWorkersWithQualificationTypeCommand extends $Command< ListWorkersWithQualificationTypeCommandInput, ListWorkersWithQualificationTypeCommandOutput, @@ -34,6 +40,9 @@ export class ListWorkersWithQualificationTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/NotifyWorkersCommand.ts b/clients/client-mturk/commands/NotifyWorkersCommand.ts index 56f84724fef1b..d57ec1271f4df 100644 --- a/clients/client-mturk/commands/NotifyWorkersCommand.ts +++ b/clients/client-mturk/commands/NotifyWorkersCommand.ts @@ -20,6 +20,18 @@ import { export type NotifyWorkersCommandInput = NotifyWorkersRequest; export type NotifyWorkersCommandOutput = NotifyWorkersResponse & __MetadataBearer; +/** + *

+ * The + * NotifyWorkers + * operation sends an email to one or more Workers that you specify with + * the Worker ID. You can specify up to 100 Worker IDs to send the same + * message with a single call to the NotifyWorkers operation. The + * NotifyWorkers operation will send a notification email to a Worker + * only if you have previously approved or rejected work from the + * Worker. + *

+ */ export class NotifyWorkersCommand extends $Command< NotifyWorkersCommandInput, NotifyWorkersCommandOutput, @@ -34,6 +46,9 @@ export class NotifyWorkersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/RejectAssignmentCommand.ts b/clients/client-mturk/commands/RejectAssignmentCommand.ts index 1344b5591cc2f..1169db4ff10dd 100644 --- a/clients/client-mturk/commands/RejectAssignmentCommand.ts +++ b/clients/client-mturk/commands/RejectAssignmentCommand.ts @@ -20,6 +20,21 @@ import { export type RejectAssignmentCommandInput = RejectAssignmentRequest; export type RejectAssignmentCommandOutput = RejectAssignmentResponse & __MetadataBearer; +/** + *

+ * The RejectAssignment operation rejects the results of a completed assignment. + *

+ *

+ * You can include an optional feedback message with the rejection, + * which the Worker can see in the Status section of the web site. + * When you include a feedback message with the rejection, + * it helps the Worker understand why the assignment was rejected, + * and can improve the quality of the results the Worker submits in the future. + *

+ *

+ * Only the Requester who created the HIT can reject an assignment for the HIT. + *

+ */ export class RejectAssignmentCommand extends $Command< RejectAssignmentCommandInput, RejectAssignmentCommandOutput, @@ -34,6 +49,9 @@ export class RejectAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/RejectQualificationRequestCommand.ts b/clients/client-mturk/commands/RejectQualificationRequestCommand.ts index b8d4b4af00265..978c65590f37a 100644 --- a/clients/client-mturk/commands/RejectQualificationRequestCommand.ts +++ b/clients/client-mturk/commands/RejectQualificationRequestCommand.ts @@ -20,6 +20,15 @@ import { export type RejectQualificationRequestCommandInput = RejectQualificationRequestRequest; export type RejectQualificationRequestCommandOutput = RejectQualificationRequestResponse & __MetadataBearer; +/** + *

+ * The + * RejectQualificationRequest + * operation rejects a user's request for a Qualification. + *

+ *

You can provide a text message explaining why the request was + * rejected. The Worker who made the request can see this message.

+ */ export class RejectQualificationRequestCommand extends $Command< RejectQualificationRequestCommandInput, RejectQualificationRequestCommandOutput, @@ -34,6 +43,9 @@ export class RejectQualificationRequestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/SendBonusCommand.ts b/clients/client-mturk/commands/SendBonusCommand.ts index 583d09ddbe819..6a593be278c76 100644 --- a/clients/client-mturk/commands/SendBonusCommand.ts +++ b/clients/client-mturk/commands/SendBonusCommand.ts @@ -17,6 +17,22 @@ import { export type SendBonusCommandInput = SendBonusRequest; export type SendBonusCommandOutput = SendBonusResponse & __MetadataBearer; +/** + *

+ * The + * SendBonus + * operation issues a payment of money from your account to a Worker. + * This payment happens separately from the reward you pay to the Worker + * when you approve the Worker's assignment. The SendBonus operation + * requires the Worker's ID and the assignment ID as parameters to + * initiate payment of the bonus. You must include a message that + * explains the reason for the bonus payment, as the Worker may not be + * expecting the payment. Amazon Mechanical Turk collects a fee for + * bonus payments, similar to the HIT listing fee. This operation fails + * if your account does not have enough funds to pay for both the bonus + * and the fees. + *

+ */ export class SendBonusCommand extends $Command< SendBonusCommandInput, SendBonusCommandOutput, @@ -31,6 +47,9 @@ export class SendBonusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/SendTestEventNotificationCommand.ts b/clients/client-mturk/commands/SendTestEventNotificationCommand.ts index 0d8f135128178..7774ac5ee9e6f 100644 --- a/clients/client-mturk/commands/SendTestEventNotificationCommand.ts +++ b/clients/client-mturk/commands/SendTestEventNotificationCommand.ts @@ -20,6 +20,15 @@ import { export type SendTestEventNotificationCommandInput = SendTestEventNotificationRequest; export type SendTestEventNotificationCommandOutput = SendTestEventNotificationResponse & __MetadataBearer; +/** + *

+ * The SendTestEventNotification operation causes Amazon Mechanical Turk to send + * a notification message as if a HIT event occurred, according to the provided + * notification specification. This allows you to test notifications without + * setting up notifications for a real HIT type and trying to trigger them using the website. + * When you call this operation, the service attempts to send the test notification immediately. + *

+ */ export class SendTestEventNotificationCommand extends $Command< SendTestEventNotificationCommandInput, SendTestEventNotificationCommandOutput, @@ -34,6 +43,9 @@ export class SendTestEventNotificationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/UpdateExpirationForHITCommand.ts b/clients/client-mturk/commands/UpdateExpirationForHITCommand.ts index f88d46d18f1bc..025f327c86129 100644 --- a/clients/client-mturk/commands/UpdateExpirationForHITCommand.ts +++ b/clients/client-mturk/commands/UpdateExpirationForHITCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateExpirationForHITCommandInput = UpdateExpirationForHITRequest; export type UpdateExpirationForHITCommandOutput = UpdateExpirationForHITResponse & __MetadataBearer; +/** + *

+ * The UpdateExpirationForHIT operation allows you update the expiration time of a HIT. + * If you update it to a time in the past, the HIT will be immediately expired. + *

+ */ export class UpdateExpirationForHITCommand extends $Command< UpdateExpirationForHITCommandInput, UpdateExpirationForHITCommandOutput, @@ -34,6 +40,9 @@ export class UpdateExpirationForHITCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/UpdateHITReviewStatusCommand.ts b/clients/client-mturk/commands/UpdateHITReviewStatusCommand.ts index 328e510104200..d0ee0f1993db6 100644 --- a/clients/client-mturk/commands/UpdateHITReviewStatusCommand.ts +++ b/clients/client-mturk/commands/UpdateHITReviewStatusCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateHITReviewStatusCommandInput = UpdateHITReviewStatusRequest; export type UpdateHITReviewStatusCommandOutput = UpdateHITReviewStatusResponse & __MetadataBearer; +/** + *

+ * The UpdateHITReviewStatus operation updates the status of a HIT. + * If the status is Reviewable, this operation can update the status to Reviewing, + * or it can revert a Reviewing HIT back to the Reviewable status. + *

+ */ export class UpdateHITReviewStatusCommand extends $Command< UpdateHITReviewStatusCommandInput, UpdateHITReviewStatusCommandOutput, @@ -34,6 +41,9 @@ export class UpdateHITReviewStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/UpdateHITTypeOfHITCommand.ts b/clients/client-mturk/commands/UpdateHITTypeOfHITCommand.ts index f91727283e15b..b50f287e6e0e8 100644 --- a/clients/client-mturk/commands/UpdateHITTypeOfHITCommand.ts +++ b/clients/client-mturk/commands/UpdateHITTypeOfHITCommand.ts @@ -20,6 +20,16 @@ import { export type UpdateHITTypeOfHITCommandInput = UpdateHITTypeOfHITRequest; export type UpdateHITTypeOfHITCommandOutput = UpdateHITTypeOfHITResponse & __MetadataBearer; +/** + *

+ * The + * UpdateHITTypeOfHIT + * operation allows you to change the HITType properties of a HIT. This + * operation disassociates the HIT from its old HITType properties and + * associates it with the new HITType properties. The HIT takes on the + * properties of the new HITType in place of the old ones. + *

+ */ export class UpdateHITTypeOfHITCommand extends $Command< UpdateHITTypeOfHITCommandInput, UpdateHITTypeOfHITCommandOutput, @@ -34,6 +44,9 @@ export class UpdateHITTypeOfHITCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/UpdateNotificationSettingsCommand.ts b/clients/client-mturk/commands/UpdateNotificationSettingsCommand.ts index a00f05f56c813..39d74c5466099 100644 --- a/clients/client-mturk/commands/UpdateNotificationSettingsCommand.ts +++ b/clients/client-mturk/commands/UpdateNotificationSettingsCommand.ts @@ -20,6 +20,20 @@ import { export type UpdateNotificationSettingsCommandInput = UpdateNotificationSettingsRequest; export type UpdateNotificationSettingsCommandOutput = UpdateNotificationSettingsResponse & __MetadataBearer; +/** + *

+ * The UpdateNotificationSettings operation creates, updates, + * disables or re-enables notifications for a HIT type. + * If you call the UpdateNotificationSettings operation for a HIT type that already has a + * notification specification, the operation replaces the old specification with a new one. + * You can call the UpdateNotificationSettings operation to enable or disable notifications + * for the HIT type, without having to modify the notification specification itself by providing + * updates to the Active status without specifying a new notification specification. + * To change the Active status of a HIT type's notifications, + * the HIT type must already have a notification specification, + * or one must be provided in the same call to UpdateNotificationSettings. + *

+ */ export class UpdateNotificationSettingsCommand extends $Command< UpdateNotificationSettingsCommandInput, UpdateNotificationSettingsCommandOutput, @@ -34,6 +48,9 @@ export class UpdateNotificationSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/commands/UpdateQualificationTypeCommand.ts b/clients/client-mturk/commands/UpdateQualificationTypeCommand.ts index 4161e1a2307c6..8fc9dc69a56f2 100644 --- a/clients/client-mturk/commands/UpdateQualificationTypeCommand.ts +++ b/clients/client-mturk/commands/UpdateQualificationTypeCommand.ts @@ -20,6 +20,41 @@ import { export type UpdateQualificationTypeCommandInput = UpdateQualificationTypeRequest; export type UpdateQualificationTypeCommandOutput = UpdateQualificationTypeResponse & __MetadataBearer; +/** + *

+ * The + * UpdateQualificationType + * operation modifies the attributes of an existing Qualification type, + * which is represented by a QualificationType data structure. Only the + * owner of a Qualification type can modify its attributes. + *

+ *

Most attributes of a Qualification type can be changed after + * the type has been created. However, the Name and Keywords fields + * cannot be modified. The RetryDelayInSeconds parameter can be modified + * or added to change the delay or to enable retries, but + * RetryDelayInSeconds cannot be used to disable retries.

+ *

You can use this operation to update the test for a + * Qualification type. The test is updated based on the values specified + * for the Test, TestDurationInSeconds and AnswerKey parameters. All + * three parameters specify the updated test. If you are updating the + * test for a type, you must specify the Test and TestDurationInSeconds + * parameters. The AnswerKey parameter is optional; omitting it specifies + * that the updated test does not have an answer key.

+ *

If you omit the Test parameter, the test for the + * Qualification type is unchanged. There is no way to remove a test from + * a Qualification type that has one. If the type already has a test, you + * cannot update it to be AutoGranted. If the Qualification type does not + * have a test and one is provided by an update, the type will henceforth + * have a test.

+ *

If you want to update the test duration or answer key for an + * existing test without changing the questions, you must specify a Test + * parameter with the original questions, along with the updated values.

+ *

If you provide an updated Test but no AnswerKey, the new test + * will not have an answer key. Requests for such Qualifications must be + * granted manually.

+ *

You can also update the AutoGranted and AutoGrantedValue + * attributes of the Qualification type.

+ */ export class UpdateQualificationTypeCommand extends $Command< UpdateQualificationTypeCommandInput, UpdateQualificationTypeCommandOutput, @@ -34,6 +69,9 @@ export class UpdateQualificationTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: MTurkClientResolvedConfig, diff --git a/clients/client-mturk/package.json b/clients/client-mturk/package.json index ae3189d11e8a3..bba32bc5a3d3c 100644 --- a/clients/client-mturk/package.json +++ b/clients/client-mturk/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Mturk Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-mturk/pagination/ListAssignmentsForHITPaginator.ts b/clients/client-mturk/pagination/ListAssignmentsForHITPaginator.ts index ab3a5f2b3868a..f6c41b4d405b0 100644 --- a/clients/client-mturk/pagination/ListAssignmentsForHITPaginator.ts +++ b/clients/client-mturk/pagination/ListAssignmentsForHITPaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListAssignmentsForHITCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssignmentsForHITCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListAssignmentsForHITCommandInput, diff --git a/clients/client-mturk/pagination/ListBonusPaymentsPaginator.ts b/clients/client-mturk/pagination/ListBonusPaymentsPaginator.ts index adb7cafa15bd9..9d9ab0a43826d 100644 --- a/clients/client-mturk/pagination/ListBonusPaymentsPaginator.ts +++ b/clients/client-mturk/pagination/ListBonusPaymentsPaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListBonusPaymentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBonusPaymentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListBonusPaymentsCommandInput, diff --git a/clients/client-mturk/pagination/ListHITsForQualificationTypePaginator.ts b/clients/client-mturk/pagination/ListHITsForQualificationTypePaginator.ts index e45eb974718a2..23fc55d3da28b 100644 --- a/clients/client-mturk/pagination/ListHITsForQualificationTypePaginator.ts +++ b/clients/client-mturk/pagination/ListHITsForQualificationTypePaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListHITsForQualificationTypeCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHITsForQualificationTypeCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListHITsForQualificationTypeCommandInput, diff --git a/clients/client-mturk/pagination/ListHITsPaginator.ts b/clients/client-mturk/pagination/ListHITsPaginator.ts index 03f4a42a5cd5d..ee3ef796f3599 100644 --- a/clients/client-mturk/pagination/ListHITsPaginator.ts +++ b/clients/client-mturk/pagination/ListHITsPaginator.ts @@ -4,6 +4,9 @@ import { ListHITsCommand, ListHITsCommandInput, ListHITsCommandOutput } from ".. import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListHITsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHITsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListHITsCommandInput, diff --git a/clients/client-mturk/pagination/ListQualificationRequestsPaginator.ts b/clients/client-mturk/pagination/ListQualificationRequestsPaginator.ts index 540644fd816d9..4a926f5a5064c 100644 --- a/clients/client-mturk/pagination/ListQualificationRequestsPaginator.ts +++ b/clients/client-mturk/pagination/ListQualificationRequestsPaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListQualificationRequestsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListQualificationRequestsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListQualificationRequestsCommandInput, diff --git a/clients/client-mturk/pagination/ListQualificationTypesPaginator.ts b/clients/client-mturk/pagination/ListQualificationTypesPaginator.ts index f44525687f58f..dfdd15fc2e845 100644 --- a/clients/client-mturk/pagination/ListQualificationTypesPaginator.ts +++ b/clients/client-mturk/pagination/ListQualificationTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListQualificationTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListQualificationTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListQualificationTypesCommandInput, diff --git a/clients/client-mturk/pagination/ListReviewPolicyResultsForHITPaginator.ts b/clients/client-mturk/pagination/ListReviewPolicyResultsForHITPaginator.ts index dde8f6735303f..7176ffa1fd85e 100644 --- a/clients/client-mturk/pagination/ListReviewPolicyResultsForHITPaginator.ts +++ b/clients/client-mturk/pagination/ListReviewPolicyResultsForHITPaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListReviewPolicyResultsForHITCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListReviewPolicyResultsForHITCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListReviewPolicyResultsForHITCommandInput, diff --git a/clients/client-mturk/pagination/ListReviewableHITsPaginator.ts b/clients/client-mturk/pagination/ListReviewableHITsPaginator.ts index f60c54a3d7eaf..96582430749a1 100644 --- a/clients/client-mturk/pagination/ListReviewableHITsPaginator.ts +++ b/clients/client-mturk/pagination/ListReviewableHITsPaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListReviewableHITsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListReviewableHITsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListReviewableHITsCommandInput, diff --git a/clients/client-mturk/pagination/ListWorkerBlocksPaginator.ts b/clients/client-mturk/pagination/ListWorkerBlocksPaginator.ts index 69dc00903a445..854592dc69369 100644 --- a/clients/client-mturk/pagination/ListWorkerBlocksPaginator.ts +++ b/clients/client-mturk/pagination/ListWorkerBlocksPaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListWorkerBlocksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorkerBlocksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListWorkerBlocksCommandInput, diff --git a/clients/client-mturk/pagination/ListWorkersWithQualificationTypePaginator.ts b/clients/client-mturk/pagination/ListWorkersWithQualificationTypePaginator.ts index cf3accb6a1c8a..f462242421f64 100644 --- a/clients/client-mturk/pagination/ListWorkersWithQualificationTypePaginator.ts +++ b/clients/client-mturk/pagination/ListWorkersWithQualificationTypePaginator.ts @@ -8,6 +8,9 @@ import { import { MTurkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: MTurkClient, input: ListWorkersWithQualificationTypeCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorkersWithQualificationTypeCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: MTurk, input: ListWorkersWithQualificationTypeCommandInput, diff --git a/clients/client-mturk/runtimeConfig.browser.ts b/clients/client-mturk/runtimeConfig.browser.ts index d51f5bc6d101a..9b01147f5bc47 100644 --- a/clients/client-mturk/runtimeConfig.browser.ts +++ b/clients/client-mturk/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./MTurkClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-mturk/runtimeConfig.native.ts b/clients/client-mturk/runtimeConfig.native.ts index bcce85e76e5b0..687ba097dc707 100644 --- a/clients/client-mturk/runtimeConfig.native.ts +++ b/clients/client-mturk/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./MTurkClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-mturk/runtimeConfig.shared.ts b/clients/client-mturk/runtimeConfig.shared.ts index 88071f83bc55d..de6972339c4be 100644 --- a/clients/client-mturk/runtimeConfig.shared.ts +++ b/clients/client-mturk/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-01-17", disableHostPrefix: false, diff --git a/clients/client-mturk/runtimeConfig.ts b/clients/client-mturk/runtimeConfig.ts index 533dd545f7930..7d468769805bc 100644 --- a/clients/client-mturk/runtimeConfig.ts +++ b/clients/client-mturk/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./MTurkClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-mturk/tsconfig.json b/clients/client-mturk/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-mturk/tsconfig.json +++ b/clients/client-mturk/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-neptune/commands/AddRoleToDBClusterCommand.ts b/clients/client-neptune/commands/AddRoleToDBClusterCommand.ts index 4109a4b41f16c..35640bb373eae 100644 --- a/clients/client-neptune/commands/AddRoleToDBClusterCommand.ts +++ b/clients/client-neptune/commands/AddRoleToDBClusterCommand.ts @@ -20,6 +20,10 @@ import { export type AddRoleToDBClusterCommandInput = AddRoleToDBClusterMessage; export type AddRoleToDBClusterCommandOutput = __MetadataBearer; +/** + *

Associates an Identity and Access Management (IAM) role from an + * Neptune DB cluster.

+ */ export class AddRoleToDBClusterCommand extends $Command< AddRoleToDBClusterCommandInput, AddRoleToDBClusterCommandOutput, @@ -34,6 +38,9 @@ export class AddRoleToDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/AddSourceIdentifierToSubscriptionCommand.ts b/clients/client-neptune/commands/AddSourceIdentifierToSubscriptionCommand.ts index 2a85f6076d9ec..62676818283c4 100644 --- a/clients/client-neptune/commands/AddSourceIdentifierToSubscriptionCommand.ts +++ b/clients/client-neptune/commands/AddSourceIdentifierToSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type AddSourceIdentifierToSubscriptionCommandInput = AddSourceIdentifierToSubscriptionMessage; export type AddSourceIdentifierToSubscriptionCommandOutput = AddSourceIdentifierToSubscriptionResult & __MetadataBearer; +/** + *

Adds a source identifier to an existing event notification subscription.

+ */ export class AddSourceIdentifierToSubscriptionCommand extends $Command< AddSourceIdentifierToSubscriptionCommandInput, AddSourceIdentifierToSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class AddSourceIdentifierToSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/AddTagsToResourceCommand.ts b/clients/client-neptune/commands/AddTagsToResourceCommand.ts index 41d10e9e62054..22a92b15fc539 100644 --- a/clients/client-neptune/commands/AddTagsToResourceCommand.ts +++ b/clients/client-neptune/commands/AddTagsToResourceCommand.ts @@ -20,6 +20,11 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceMessage; export type AddTagsToResourceCommandOutput = __MetadataBearer; +/** + *

Adds metadata tags to an Amazon Neptune resource. These tags can also be used with cost + * allocation reporting to track cost associated with Amazon Neptune resources, or used in a + * Condition statement in an IAM policy for Amazon Neptune.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -34,6 +39,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ApplyPendingMaintenanceActionCommand.ts b/clients/client-neptune/commands/ApplyPendingMaintenanceActionCommand.ts index 1900e42642409..b465352f5e445 100644 --- a/clients/client-neptune/commands/ApplyPendingMaintenanceActionCommand.ts +++ b/clients/client-neptune/commands/ApplyPendingMaintenanceActionCommand.ts @@ -20,6 +20,9 @@ import { export type ApplyPendingMaintenanceActionCommandInput = ApplyPendingMaintenanceActionMessage; export type ApplyPendingMaintenanceActionCommandOutput = ApplyPendingMaintenanceActionResult & __MetadataBearer; +/** + *

Applies a pending maintenance action to a resource (for example, to a DB instance).

+ */ export class ApplyPendingMaintenanceActionCommand extends $Command< ApplyPendingMaintenanceActionCommandInput, ApplyPendingMaintenanceActionCommandOutput, @@ -34,6 +37,9 @@ export class ApplyPendingMaintenanceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CopyDBClusterParameterGroupCommand.ts b/clients/client-neptune/commands/CopyDBClusterParameterGroupCommand.ts index 38ef110b6af5d..9a0372ad64ac2 100644 --- a/clients/client-neptune/commands/CopyDBClusterParameterGroupCommand.ts +++ b/clients/client-neptune/commands/CopyDBClusterParameterGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CopyDBClusterParameterGroupCommandInput = CopyDBClusterParameterGroupMessage; export type CopyDBClusterParameterGroupCommandOutput = CopyDBClusterParameterGroupResult & __MetadataBearer; +/** + *

Copies the specified DB cluster parameter group.

+ */ export class CopyDBClusterParameterGroupCommand extends $Command< CopyDBClusterParameterGroupCommandInput, CopyDBClusterParameterGroupCommandOutput, @@ -34,6 +37,9 @@ export class CopyDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CopyDBClusterSnapshotCommand.ts b/clients/client-neptune/commands/CopyDBClusterSnapshotCommand.ts index 0b0fd0f7ef620..2dec3b40ec092 100644 --- a/clients/client-neptune/commands/CopyDBClusterSnapshotCommand.ts +++ b/clients/client-neptune/commands/CopyDBClusterSnapshotCommand.ts @@ -20,6 +20,12 @@ import { export type CopyDBClusterSnapshotCommandInput = CopyDBClusterSnapshotMessage; export type CopyDBClusterSnapshotCommandOutput = CopyDBClusterSnapshotResult & __MetadataBearer; +/** + *

Copies a snapshot of a DB cluster.

+ *

To copy a DB cluster snapshot from a shared manual DB cluster snapshot, + * SourceDBClusterSnapshotIdentifier must be the Amazon Resource Name (ARN) of the + * shared DB cluster snapshot.

+ */ export class CopyDBClusterSnapshotCommand extends $Command< CopyDBClusterSnapshotCommandInput, CopyDBClusterSnapshotCommandOutput, @@ -34,6 +40,9 @@ export class CopyDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CopyDBParameterGroupCommand.ts b/clients/client-neptune/commands/CopyDBParameterGroupCommand.ts index 3f86c2964d7cc..b9056e956b1cc 100644 --- a/clients/client-neptune/commands/CopyDBParameterGroupCommand.ts +++ b/clients/client-neptune/commands/CopyDBParameterGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CopyDBParameterGroupCommandInput = CopyDBParameterGroupMessage; export type CopyDBParameterGroupCommandOutput = CopyDBParameterGroupResult & __MetadataBearer; +/** + *

Copies the specified DB parameter group.

+ */ export class CopyDBParameterGroupCommand extends $Command< CopyDBParameterGroupCommandInput, CopyDBParameterGroupCommandOutput, @@ -34,6 +37,9 @@ export class CopyDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CreateDBClusterCommand.ts b/clients/client-neptune/commands/CreateDBClusterCommand.ts index 5442e3a0df09d..9bc5cb90bbb0e 100644 --- a/clients/client-neptune/commands/CreateDBClusterCommand.ts +++ b/clients/client-neptune/commands/CreateDBClusterCommand.ts @@ -20,6 +20,15 @@ import { export type CreateDBClusterCommandInput = CreateDBClusterMessage; export type CreateDBClusterCommandOutput = CreateDBClusterResult & __MetadataBearer; +/** + *

Creates a new Amazon Neptune DB cluster.

+ *

You can use the ReplicationSourceIdentifier parameter to create the DB + * cluster as a Read Replica of another DB cluster or Amazon Neptune DB instance.

+ *

Note that when you create a new cluster using CreateDBCluster directly, + * deletion protection is disabled by default (when you create a new production cluster in + * the console, deletion protection is enabled by default). You can only delete a DB + * cluster if its DeletionProtection field is set to false.

+ */ export class CreateDBClusterCommand extends $Command< CreateDBClusterCommandInput, CreateDBClusterCommandOutput, @@ -34,6 +43,9 @@ export class CreateDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CreateDBClusterEndpointCommand.ts b/clients/client-neptune/commands/CreateDBClusterEndpointCommand.ts index 4703e0418c8d7..14849b01169af 100644 --- a/clients/client-neptune/commands/CreateDBClusterEndpointCommand.ts +++ b/clients/client-neptune/commands/CreateDBClusterEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBClusterEndpointCommandInput = CreateDBClusterEndpointMessage; export type CreateDBClusterEndpointCommandOutput = CreateDBClusterEndpointOutput & __MetadataBearer; +/** + *

Creates a new custom endpoint and associates it with an Amazon Neptune DB cluster.

+ */ export class CreateDBClusterEndpointCommand extends $Command< CreateDBClusterEndpointCommandInput, CreateDBClusterEndpointCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBClusterEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CreateDBClusterParameterGroupCommand.ts b/clients/client-neptune/commands/CreateDBClusterParameterGroupCommand.ts index 5b241c223af7b..260d0775d5acc 100644 --- a/clients/client-neptune/commands/CreateDBClusterParameterGroupCommand.ts +++ b/clients/client-neptune/commands/CreateDBClusterParameterGroupCommand.ts @@ -20,6 +20,33 @@ import { export type CreateDBClusterParameterGroupCommandInput = CreateDBClusterParameterGroupMessage; export type CreateDBClusterParameterGroupCommandOutput = CreateDBClusterParameterGroupResult & __MetadataBearer; +/** + *

Creates a new DB cluster parameter group.

+ *

Parameters in a DB cluster parameter group apply to all of the instances in a DB + * cluster.

+ *

A DB cluster parameter group is initially created with the default + * parameters for the database engine used by instances in the DB cluster. + * To provide custom values for any of the parameters, you must modify the + * group after creating it using ModifyDBClusterParameterGroup. + * Once you've created a DB cluster parameter group, you need to associate it + * with your DB cluster using ModifyDBCluster. + * When you associate a new DB cluster parameter group with a running DB cluster, + * you need to reboot the DB instances in the DB cluster without failover for the + * new DB cluster parameter group and associated settings to take effect.

+ * + *

After you create a DB cluster parameter group, you should wait at least + * 5 minutes before creating your first DB cluster that uses that DB cluster + * parameter group as the default parameter group. This allows Amazon Neptune + * to fully complete the create action before the DB cluster parameter group + * is used as the default for a new DB cluster. This is especially important for + * parameters that are critical when creating the default database for a DB + * cluster, such as the character set for the default database defined by the + * character_set_database parameter. You can use the Parameter + * Groups option of the Amazon Neptune + * console or the DescribeDBClusterParameters + * command to verify that your DB cluster parameter group has been created or modified.

+ *
+ */ export class CreateDBClusterParameterGroupCommand extends $Command< CreateDBClusterParameterGroupCommandInput, CreateDBClusterParameterGroupCommandOutput, @@ -34,6 +61,9 @@ export class CreateDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CreateDBClusterSnapshotCommand.ts b/clients/client-neptune/commands/CreateDBClusterSnapshotCommand.ts index 919e1ceff846f..3cb275075e368 100644 --- a/clients/client-neptune/commands/CreateDBClusterSnapshotCommand.ts +++ b/clients/client-neptune/commands/CreateDBClusterSnapshotCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBClusterSnapshotCommandInput = CreateDBClusterSnapshotMessage; export type CreateDBClusterSnapshotCommandOutput = CreateDBClusterSnapshotResult & __MetadataBearer; +/** + *

Creates a snapshot of a DB cluster.

+ */ export class CreateDBClusterSnapshotCommand extends $Command< CreateDBClusterSnapshotCommandInput, CreateDBClusterSnapshotCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CreateDBInstanceCommand.ts b/clients/client-neptune/commands/CreateDBInstanceCommand.ts index 154d1dab3194f..f8c3d45df7ef7 100644 --- a/clients/client-neptune/commands/CreateDBInstanceCommand.ts +++ b/clients/client-neptune/commands/CreateDBInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBInstanceCommandInput = CreateDBInstanceMessage; export type CreateDBInstanceCommandOutput = CreateDBInstanceResult & __MetadataBearer; +/** + *

Creates a new DB instance.

+ */ export class CreateDBInstanceCommand extends $Command< CreateDBInstanceCommandInput, CreateDBInstanceCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CreateDBParameterGroupCommand.ts b/clients/client-neptune/commands/CreateDBParameterGroupCommand.ts index a0e84fdb9dac1..ab1d239d00ae2 100644 --- a/clients/client-neptune/commands/CreateDBParameterGroupCommand.ts +++ b/clients/client-neptune/commands/CreateDBParameterGroupCommand.ts @@ -20,6 +20,30 @@ import { export type CreateDBParameterGroupCommandInput = CreateDBParameterGroupMessage; export type CreateDBParameterGroupCommandOutput = CreateDBParameterGroupResult & __MetadataBearer; +/** + *

Creates a new DB parameter group.

+ * + *

A DB parameter group is initially created with the default parameters for the database + * engine used by the DB instance. To provide custom values for any of the parameters, you must + * modify the group after creating it using ModifyDBParameterGroup. Once + * you've created a DB parameter group, you need to associate it with your DB instance using + * ModifyDBInstance. When you associate a new DB parameter group with a + * running DB instance, you need to reboot the DB instance without failover for the new DB + * parameter group and associated settings to take effect.

+ * + * + *

After you create a DB parameter group, you should wait at least 5 minutes before + * creating your first DB instance that uses that DB parameter group as the default parameter + * group. This allows Amazon Neptune to fully complete the create action before the parameter + * group is used as the default for a new DB instance. This is especially important for + * parameters that are critical when creating the default database for a DB instance, such as + * the character set for the default database defined by the + * character_set_database parameter. You can use the Parameter + * Groups option of the Amazon Neptune console or the + * DescribeDBParameters command to verify that your DB parameter group has + * been created or modified.

+ *
+ */ export class CreateDBParameterGroupCommand extends $Command< CreateDBParameterGroupCommandInput, CreateDBParameterGroupCommandOutput, @@ -34,6 +58,9 @@ export class CreateDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CreateDBSubnetGroupCommand.ts b/clients/client-neptune/commands/CreateDBSubnetGroupCommand.ts index 717493488d37a..6971649fd6482 100644 --- a/clients/client-neptune/commands/CreateDBSubnetGroupCommand.ts +++ b/clients/client-neptune/commands/CreateDBSubnetGroupCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDBSubnetGroupCommandInput = CreateDBSubnetGroupMessage; export type CreateDBSubnetGroupCommandOutput = CreateDBSubnetGroupResult & __MetadataBearer; +/** + *

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at + * least two AZs in the AWS Region.

+ */ export class CreateDBSubnetGroupCommand extends $Command< CreateDBSubnetGroupCommandInput, CreateDBSubnetGroupCommandOutput, @@ -34,6 +38,9 @@ export class CreateDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/CreateEventSubscriptionCommand.ts b/clients/client-neptune/commands/CreateEventSubscriptionCommand.ts index 98011ca74db4b..68404a69d3766 100644 --- a/clients/client-neptune/commands/CreateEventSubscriptionCommand.ts +++ b/clients/client-neptune/commands/CreateEventSubscriptionCommand.ts @@ -20,6 +20,23 @@ import { export type CreateEventSubscriptionCommandInput = CreateEventSubscriptionMessage; export type CreateEventSubscriptionCommandOutput = CreateEventSubscriptionResult & __MetadataBearer; +/** + *

Creates an event notification subscription. This action requires a topic ARN (Amazon + * Resource Name) created by either the Neptune console, the SNS console, or the SNS API. To + * obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the topic. The + * ARN is displayed in the SNS console.

+ *

You can specify the type of source (SourceType) you want to be notified of, provide a list + * of Neptune sources (SourceIds) that triggers the events, and provide a list of event + * categories (EventCategories) for events you want to be notified of. For example, you can + * specify SourceType = db-instance, SourceIds = mydbinstance1, mydbinstance2 and EventCategories + * = Availability, Backup.

+ *

If you specify both the SourceType and SourceIds, such as SourceType = db-instance and + * SourceIdentifier = myDBInstance1, you are notified of all the db-instance events for the + * specified source. If you specify a SourceType but do not specify a SourceIdentifier, you + * receive notice of the events for that source type for all your Neptune sources. If you do not + * specify either the SourceType nor the SourceIdentifier, you are notified of events generated + * from all Neptune sources belonging to your customer account.

+ */ export class CreateEventSubscriptionCommand extends $Command< CreateEventSubscriptionCommandInput, CreateEventSubscriptionCommandOutput, @@ -34,6 +51,9 @@ export class CreateEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DeleteDBClusterCommand.ts b/clients/client-neptune/commands/DeleteDBClusterCommand.ts index a42abf79b07b4..dbda1165be3a4 100644 --- a/clients/client-neptune/commands/DeleteDBClusterCommand.ts +++ b/clients/client-neptune/commands/DeleteDBClusterCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteDBClusterCommandInput = DeleteDBClusterMessage; export type DeleteDBClusterCommandOutput = DeleteDBClusterResult & __MetadataBearer; +/** + *

The DeleteDBCluster action deletes a previously provisioned DB cluster. When you delete a + * DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. + * Manual DB cluster snapshots of the specified DB cluster are not deleted.

+ * + *

Note that the DB Cluster cannot be deleted if deletion protection is enabled. To + * delete it, you must first set its DeletionProtection field to + * False.

+ */ export class DeleteDBClusterCommand extends $Command< DeleteDBClusterCommandInput, DeleteDBClusterCommandOutput, @@ -34,6 +43,9 @@ export class DeleteDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DeleteDBClusterEndpointCommand.ts b/clients/client-neptune/commands/DeleteDBClusterEndpointCommand.ts index 42cd1b4bb66f0..d5321e9441b69 100644 --- a/clients/client-neptune/commands/DeleteDBClusterEndpointCommand.ts +++ b/clients/client-neptune/commands/DeleteDBClusterEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDBClusterEndpointCommandInput = DeleteDBClusterEndpointMessage; export type DeleteDBClusterEndpointCommandOutput = DeleteDBClusterEndpointOutput & __MetadataBearer; +/** + *

Deletes a custom endpoint and removes it from an Amazon Neptune DB cluster.

+ */ export class DeleteDBClusterEndpointCommand extends $Command< DeleteDBClusterEndpointCommandInput, DeleteDBClusterEndpointCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDBClusterEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DeleteDBClusterParameterGroupCommand.ts b/clients/client-neptune/commands/DeleteDBClusterParameterGroupCommand.ts index 2621ab73a36a9..b81c435dac122 100644 --- a/clients/client-neptune/commands/DeleteDBClusterParameterGroupCommand.ts +++ b/clients/client-neptune/commands/DeleteDBClusterParameterGroupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDBClusterParameterGroupCommandInput = DeleteDBClusterParameterGroupMessage; export type DeleteDBClusterParameterGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a specified DB cluster parameter group. The DB cluster parameter group to be + * deleted can't be associated with any DB clusters.

+ */ export class DeleteDBClusterParameterGroupCommand extends $Command< DeleteDBClusterParameterGroupCommandInput, DeleteDBClusterParameterGroupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DeleteDBClusterSnapshotCommand.ts b/clients/client-neptune/commands/DeleteDBClusterSnapshotCommand.ts index fa5fda5ac87cc..38cf21c2fe034 100644 --- a/clients/client-neptune/commands/DeleteDBClusterSnapshotCommand.ts +++ b/clients/client-neptune/commands/DeleteDBClusterSnapshotCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteDBClusterSnapshotCommandInput = DeleteDBClusterSnapshotMessage; export type DeleteDBClusterSnapshotCommandOutput = DeleteDBClusterSnapshotResult & __MetadataBearer; +/** + *

Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is + * terminated.

+ * + *

The DB cluster snapshot must be in the available state to be + * deleted.

+ *
+ */ export class DeleteDBClusterSnapshotCommand extends $Command< DeleteDBClusterSnapshotCommandInput, DeleteDBClusterSnapshotCommandOutput, @@ -34,6 +42,9 @@ export class DeleteDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DeleteDBInstanceCommand.ts b/clients/client-neptune/commands/DeleteDBInstanceCommand.ts index a293d77b58ef2..f7b28cf606410 100644 --- a/clients/client-neptune/commands/DeleteDBInstanceCommand.ts +++ b/clients/client-neptune/commands/DeleteDBInstanceCommand.ts @@ -20,6 +20,22 @@ import { export type DeleteDBInstanceCommandInput = DeleteDBInstanceMessage; export type DeleteDBInstanceCommandOutput = DeleteDBInstanceResult & __MetadataBearer; +/** + *

The DeleteDBInstance action deletes a previously provisioned DB instance. When you delete + * a DB instance, all automated backups for that instance are deleted and can't be recovered. + * Manual DB snapshots of the DB instance to be deleted by DeleteDBInstance are not + * deleted.

+ *

If you request a final DB snapshot the status of the Amazon Neptune DB instance is + * deleting until the DB snapshot is created. The API action + * DescribeDBInstance is used to monitor the status of this operation. The action + * can't be canceled or reverted once submitted.

+ *

Note that when a DB instance is in a failure state and has a status of + * failed, incompatible-restore, or incompatible-network, + * you can only delete it when the SkipFinalSnapshot parameter is set to + * true.

+ *

You can't delete a DB instance if it is the only instance in the DB cluster, or + * if it has deletion protection enabled.

+ */ export class DeleteDBInstanceCommand extends $Command< DeleteDBInstanceCommandInput, DeleteDBInstanceCommandOutput, @@ -34,6 +50,9 @@ export class DeleteDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DeleteDBParameterGroupCommand.ts b/clients/client-neptune/commands/DeleteDBParameterGroupCommand.ts index 382f39d5746a7..8632a5d880e58 100644 --- a/clients/client-neptune/commands/DeleteDBParameterGroupCommand.ts +++ b/clients/client-neptune/commands/DeleteDBParameterGroupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDBParameterGroupCommandInput = DeleteDBParameterGroupMessage; export type DeleteDBParameterGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a specified DBParameterGroup. The DBParameterGroup to be deleted can't be + * associated with any DB instances.

+ */ export class DeleteDBParameterGroupCommand extends $Command< DeleteDBParameterGroupCommandInput, DeleteDBParameterGroupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DeleteDBSubnetGroupCommand.ts b/clients/client-neptune/commands/DeleteDBSubnetGroupCommand.ts index d148e6cbaf7fa..eb17581cbe127 100644 --- a/clients/client-neptune/commands/DeleteDBSubnetGroupCommand.ts +++ b/clients/client-neptune/commands/DeleteDBSubnetGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDBSubnetGroupCommandInput = DeleteDBSubnetGroupMessage; export type DeleteDBSubnetGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a DB subnet group.

+ * + *

The specified database subnet group must not be associated with any DB instances.

+ *
+ */ export class DeleteDBSubnetGroupCommand extends $Command< DeleteDBSubnetGroupCommandInput, DeleteDBSubnetGroupCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DeleteEventSubscriptionCommand.ts b/clients/client-neptune/commands/DeleteEventSubscriptionCommand.ts index f4036bc8b818e..c1d5a9e58d7c0 100644 --- a/clients/client-neptune/commands/DeleteEventSubscriptionCommand.ts +++ b/clients/client-neptune/commands/DeleteEventSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEventSubscriptionCommandInput = DeleteEventSubscriptionMessage; export type DeleteEventSubscriptionCommandOutput = DeleteEventSubscriptionResult & __MetadataBearer; +/** + *

Deletes an event notification subscription.

+ */ export class DeleteEventSubscriptionCommand extends $Command< DeleteEventSubscriptionCommandInput, DeleteEventSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBClusterEndpointsCommand.ts b/clients/client-neptune/commands/DescribeDBClusterEndpointsCommand.ts index 167579304e7b1..0c162e2e93edc 100644 --- a/clients/client-neptune/commands/DescribeDBClusterEndpointsCommand.ts +++ b/clients/client-neptune/commands/DescribeDBClusterEndpointsCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeDBClusterEndpointsCommandInput = DescribeDBClusterEndpointsMessage; export type DescribeDBClusterEndpointsCommandOutput = DBClusterEndpointMessage & __MetadataBearer; +/** + *

Returns information about endpoints for an Amazon Neptune DB cluster.

+ * + *

This operation can also return information for Amazon RDS clusters + * and Amazon DocDB clusters.

+ *
+ */ export class DescribeDBClusterEndpointsCommand extends $Command< DescribeDBClusterEndpointsCommandInput, DescribeDBClusterEndpointsCommandOutput, @@ -34,6 +41,9 @@ export class DescribeDBClusterEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBClusterParameterGroupsCommand.ts b/clients/client-neptune/commands/DescribeDBClusterParameterGroupsCommand.ts index 2f4eb433bc353..06c1b4ed38f66 100644 --- a/clients/client-neptune/commands/DescribeDBClusterParameterGroupsCommand.ts +++ b/clients/client-neptune/commands/DescribeDBClusterParameterGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDBClusterParameterGroupsCommandInput = DescribeDBClusterParameterGroupsMessage; export type DescribeDBClusterParameterGroupsCommandOutput = DBClusterParameterGroupsMessage & __MetadataBearer; +/** + *

Returns a list of DBClusterParameterGroup descriptions. If a + * DBClusterParameterGroupName parameter is specified, the list will contain only + * the description of the specified DB cluster parameter group.

+ */ export class DescribeDBClusterParameterGroupsCommand extends $Command< DescribeDBClusterParameterGroupsCommandInput, DescribeDBClusterParameterGroupsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDBClusterParameterGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBClusterParametersCommand.ts b/clients/client-neptune/commands/DescribeDBClusterParametersCommand.ts index c480e52fb3f1e..171e79c4a75dd 100644 --- a/clients/client-neptune/commands/DescribeDBClusterParametersCommand.ts +++ b/clients/client-neptune/commands/DescribeDBClusterParametersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBClusterParametersCommandInput = DescribeDBClusterParametersMessage; export type DescribeDBClusterParametersCommandOutput = DBClusterParameterGroupDetails & __MetadataBearer; +/** + *

Returns the detailed parameter list for a particular DB cluster parameter group.

+ */ export class DescribeDBClusterParametersCommand extends $Command< DescribeDBClusterParametersCommandInput, DescribeDBClusterParametersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBClusterParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBClusterSnapshotAttributesCommand.ts b/clients/client-neptune/commands/DescribeDBClusterSnapshotAttributesCommand.ts index 5dc901d5156d3..8e7b5f7df9c78 100644 --- a/clients/client-neptune/commands/DescribeDBClusterSnapshotAttributesCommand.ts +++ b/clients/client-neptune/commands/DescribeDBClusterSnapshotAttributesCommand.ts @@ -24,6 +24,18 @@ export type DescribeDBClusterSnapshotAttributesCommandInput = DescribeDBClusterS export type DescribeDBClusterSnapshotAttributesCommandOutput = DescribeDBClusterSnapshotAttributesResult & __MetadataBearer; +/** + *

Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster + * snapshot.

+ *

When sharing snapshots with other AWS accounts, + * DescribeDBClusterSnapshotAttributes returns the restore attribute + * and a list of IDs for the AWS accounts that are authorized to copy or restore the manual DB + * cluster snapshot. If all is included in the list of values for the + * restore attribute, then the manual DB cluster snapshot is public and can be + * copied or restored by all AWS accounts.

+ *

To add or remove access for an AWS account to copy or restore a manual DB cluster + * snapshot, or to make the manual DB cluster snapshot public or private, use the ModifyDBClusterSnapshotAttribute API action.

+ */ export class DescribeDBClusterSnapshotAttributesCommand extends $Command< DescribeDBClusterSnapshotAttributesCommandInput, DescribeDBClusterSnapshotAttributesCommandOutput, @@ -38,6 +50,9 @@ export class DescribeDBClusterSnapshotAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBClusterSnapshotsCommand.ts b/clients/client-neptune/commands/DescribeDBClusterSnapshotsCommand.ts index 5c89004446bb4..8ea2b11aca4e1 100644 --- a/clients/client-neptune/commands/DescribeDBClusterSnapshotsCommand.ts +++ b/clients/client-neptune/commands/DescribeDBClusterSnapshotsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDBClusterSnapshotsCommandInput = DescribeDBClusterSnapshotsMessage; export type DescribeDBClusterSnapshotsCommandOutput = DBClusterSnapshotMessage & __MetadataBearer; +/** + *

Returns information about DB cluster snapshots. This API action supports + * pagination.

+ */ export class DescribeDBClusterSnapshotsCommand extends $Command< DescribeDBClusterSnapshotsCommandInput, DescribeDBClusterSnapshotsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDBClusterSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBClustersCommand.ts b/clients/client-neptune/commands/DescribeDBClustersCommand.ts index df1102cf3f195..b4fa7ddcc647c 100644 --- a/clients/client-neptune/commands/DescribeDBClustersCommand.ts +++ b/clients/client-neptune/commands/DescribeDBClustersCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeDBClustersCommandInput = DescribeDBClustersMessage; export type DescribeDBClustersCommandOutput = DBClusterMessage & __MetadataBearer; +/** + *

Returns information about provisioned DB clusters, and supports + * pagination.

+ * + * + *

This operation can also return information for Amazon RDS clusters + * and Amazon DocDB clusters.

+ *
+ */ export class DescribeDBClustersCommand extends $Command< DescribeDBClustersCommandInput, DescribeDBClustersCommandOutput, @@ -34,6 +43,9 @@ export class DescribeDBClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBEngineVersionsCommand.ts b/clients/client-neptune/commands/DescribeDBEngineVersionsCommand.ts index 9da188077bed5..00ed1f3ace837 100644 --- a/clients/client-neptune/commands/DescribeDBEngineVersionsCommand.ts +++ b/clients/client-neptune/commands/DescribeDBEngineVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBEngineVersionsCommandInput = DescribeDBEngineVersionsMessage; export type DescribeDBEngineVersionsCommandOutput = DBEngineVersionMessage & __MetadataBearer; +/** + *

Returns a list of the available DB engines.

+ */ export class DescribeDBEngineVersionsCommand extends $Command< DescribeDBEngineVersionsCommandInput, DescribeDBEngineVersionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBEngineVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBInstancesCommand.ts b/clients/client-neptune/commands/DescribeDBInstancesCommand.ts index 4320440fa6afd..a503041d0fbc8 100644 --- a/clients/client-neptune/commands/DescribeDBInstancesCommand.ts +++ b/clients/client-neptune/commands/DescribeDBInstancesCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeDBInstancesCommandInput = DescribeDBInstancesMessage; export type DescribeDBInstancesCommandOutput = DBInstanceMessage & __MetadataBearer; +/** + *

Returns information about provisioned instances, and supports pagination.

+ * + * + *

This operation can also return information for Amazon RDS instances + * and Amazon DocDB instances.

+ *
+ */ export class DescribeDBInstancesCommand extends $Command< DescribeDBInstancesCommandInput, DescribeDBInstancesCommandOutput, @@ -34,6 +42,9 @@ export class DescribeDBInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBParameterGroupsCommand.ts b/clients/client-neptune/commands/DescribeDBParameterGroupsCommand.ts index 5a9e32728b42d..27f2c36a6096e 100644 --- a/clients/client-neptune/commands/DescribeDBParameterGroupsCommand.ts +++ b/clients/client-neptune/commands/DescribeDBParameterGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDBParameterGroupsCommandInput = DescribeDBParameterGroupsMessage; export type DescribeDBParameterGroupsCommandOutput = DBParameterGroupsMessage & __MetadataBearer; +/** + *

Returns a list of DBParameterGroup descriptions. If a + * DBParameterGroupName is specified, the list will contain only the description of + * the specified DB parameter group.

+ */ export class DescribeDBParameterGroupsCommand extends $Command< DescribeDBParameterGroupsCommandInput, DescribeDBParameterGroupsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDBParameterGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBParametersCommand.ts b/clients/client-neptune/commands/DescribeDBParametersCommand.ts index bc458e2d28990..d18f145bb8178 100644 --- a/clients/client-neptune/commands/DescribeDBParametersCommand.ts +++ b/clients/client-neptune/commands/DescribeDBParametersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBParametersCommandInput = DescribeDBParametersMessage; export type DescribeDBParametersCommandOutput = DBParameterGroupDetails & __MetadataBearer; +/** + *

Returns the detailed parameter list for a particular DB parameter group.

+ */ export class DescribeDBParametersCommand extends $Command< DescribeDBParametersCommandInput, DescribeDBParametersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeDBSubnetGroupsCommand.ts b/clients/client-neptune/commands/DescribeDBSubnetGroupsCommand.ts index 13aa6d2af1fc5..43aaffc6e9f12 100644 --- a/clients/client-neptune/commands/DescribeDBSubnetGroupsCommand.ts +++ b/clients/client-neptune/commands/DescribeDBSubnetGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDBSubnetGroupsCommandInput = DescribeDBSubnetGroupsMessage; export type DescribeDBSubnetGroupsCommandOutput = DBSubnetGroupMessage & __MetadataBearer; +/** + *

Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the + * list will contain only the descriptions of the specified DBSubnetGroup.

+ *

For an overview of CIDR ranges, go to the Wikipedia Tutorial.

+ */ export class DescribeDBSubnetGroupsCommand extends $Command< DescribeDBSubnetGroupsCommandInput, DescribeDBSubnetGroupsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDBSubnetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeEngineDefaultClusterParametersCommand.ts b/clients/client-neptune/commands/DescribeEngineDefaultClusterParametersCommand.ts index 21b90b477045c..337aa9df121b0 100644 --- a/clients/client-neptune/commands/DescribeEngineDefaultClusterParametersCommand.ts +++ b/clients/client-neptune/commands/DescribeEngineDefaultClusterParametersCommand.ts @@ -24,6 +24,10 @@ export type DescribeEngineDefaultClusterParametersCommandInput = DescribeEngineD export type DescribeEngineDefaultClusterParametersCommandOutput = DescribeEngineDefaultClusterParametersResult & __MetadataBearer; +/** + *

Returns the default engine and system parameter information for the cluster database + * engine.

+ */ export class DescribeEngineDefaultClusterParametersCommand extends $Command< DescribeEngineDefaultClusterParametersCommandInput, DescribeEngineDefaultClusterParametersCommandOutput, @@ -38,6 +42,9 @@ export class DescribeEngineDefaultClusterParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeEngineDefaultParametersCommand.ts b/clients/client-neptune/commands/DescribeEngineDefaultParametersCommand.ts index e3574ede40407..6188df1aca068 100644 --- a/clients/client-neptune/commands/DescribeEngineDefaultParametersCommand.ts +++ b/clients/client-neptune/commands/DescribeEngineDefaultParametersCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEngineDefaultParametersCommandInput = DescribeEngineDefaultParametersMessage; export type DescribeEngineDefaultParametersCommandOutput = DescribeEngineDefaultParametersResult & __MetadataBearer; +/** + *

Returns the default engine and system parameter information for the specified database + * engine.

+ */ export class DescribeEngineDefaultParametersCommand extends $Command< DescribeEngineDefaultParametersCommandInput, DescribeEngineDefaultParametersCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEngineDefaultParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeEventCategoriesCommand.ts b/clients/client-neptune/commands/DescribeEventCategoriesCommand.ts index d038737d929a6..08b77ddb3bd6b 100644 --- a/clients/client-neptune/commands/DescribeEventCategoriesCommand.ts +++ b/clients/client-neptune/commands/DescribeEventCategoriesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEventCategoriesCommandInput = DescribeEventCategoriesMessage; export type DescribeEventCategoriesCommandOutput = EventCategoriesMessage & __MetadataBearer; +/** + *

Displays a list of categories for all event source types, or, if specified, for a + * specified source type.

+ */ export class DescribeEventCategoriesCommand extends $Command< DescribeEventCategoriesCommandInput, DescribeEventCategoriesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEventCategoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeEventSubscriptionsCommand.ts b/clients/client-neptune/commands/DescribeEventSubscriptionsCommand.ts index d03dcd4e7ecd2..f4b532c01a953 100644 --- a/clients/client-neptune/commands/DescribeEventSubscriptionsCommand.ts +++ b/clients/client-neptune/commands/DescribeEventSubscriptionsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeEventSubscriptionsCommandInput = DescribeEventSubscriptionsMessage; export type DescribeEventSubscriptionsCommandOutput = EventSubscriptionsMessage & __MetadataBearer; +/** + *

Lists all the subscription descriptions for a customer account. The description for a + * subscription includes SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, + * CreationTime, and Status.

+ *

If you specify a SubscriptionName, lists the description for that subscription.

+ */ export class DescribeEventSubscriptionsCommand extends $Command< DescribeEventSubscriptionsCommandInput, DescribeEventSubscriptionsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeEventSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeEventsCommand.ts b/clients/client-neptune/commands/DescribeEventsCommand.ts index 022838611468e..cbb40b6090fff 100644 --- a/clients/client-neptune/commands/DescribeEventsCommand.ts +++ b/clients/client-neptune/commands/DescribeEventsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeEventsCommandInput = DescribeEventsMessage; export type DescribeEventsCommandOutput = EventsMessage & __MetadataBearer; +/** + *

Returns events related to DB instances, DB security groups, DB snapshots, and DB parameter + * groups for the past 14 days. Events specific to a particular DB instance, DB security group, + * database snapshot, or DB parameter group can be obtained by providing the name as a parameter. + * By default, the past hour of events are returned.

+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeOrderableDBInstanceOptionsCommand.ts b/clients/client-neptune/commands/DescribeOrderableDBInstanceOptionsCommand.ts index 44b5c2cd900cd..d00241ccaec32 100644 --- a/clients/client-neptune/commands/DescribeOrderableDBInstanceOptionsCommand.ts +++ b/clients/client-neptune/commands/DescribeOrderableDBInstanceOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOrderableDBInstanceOptionsCommandInput = DescribeOrderableDBInstanceOptionsMessage; export type DescribeOrderableDBInstanceOptionsCommandOutput = OrderableDBInstanceOptionsMessage & __MetadataBearer; +/** + *

Returns a list of orderable DB instance options for the specified engine.

+ */ export class DescribeOrderableDBInstanceOptionsCommand extends $Command< DescribeOrderableDBInstanceOptionsCommandInput, DescribeOrderableDBInstanceOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOrderableDBInstanceOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribePendingMaintenanceActionsCommand.ts b/clients/client-neptune/commands/DescribePendingMaintenanceActionsCommand.ts index d6147948f12da..dde15fbd52ea9 100644 --- a/clients/client-neptune/commands/DescribePendingMaintenanceActionsCommand.ts +++ b/clients/client-neptune/commands/DescribePendingMaintenanceActionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribePendingMaintenanceActionsCommandInput = DescribePendingMaintenanceActionsMessage; export type DescribePendingMaintenanceActionsCommandOutput = PendingMaintenanceActionsMessage & __MetadataBearer; +/** + *

Returns a list of resources (for example, DB instances) that have at least one pending + * maintenance action.

+ */ export class DescribePendingMaintenanceActionsCommand extends $Command< DescribePendingMaintenanceActionsCommandInput, DescribePendingMaintenanceActionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribePendingMaintenanceActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/DescribeValidDBInstanceModificationsCommand.ts b/clients/client-neptune/commands/DescribeValidDBInstanceModificationsCommand.ts index 9a6759b00991d..d9fa6601b46d1 100644 --- a/clients/client-neptune/commands/DescribeValidDBInstanceModificationsCommand.ts +++ b/clients/client-neptune/commands/DescribeValidDBInstanceModificationsCommand.ts @@ -24,6 +24,11 @@ export type DescribeValidDBInstanceModificationsCommandInput = DescribeValidDBIn export type DescribeValidDBInstanceModificationsCommandOutput = DescribeValidDBInstanceModificationsResult & __MetadataBearer; +/** + *

You can call DescribeValidDBInstanceModifications + * to learn what modifications you can make to your DB instance. You can use this + * information when you call ModifyDBInstance.

+ */ export class DescribeValidDBInstanceModificationsCommand extends $Command< DescribeValidDBInstanceModificationsCommandInput, DescribeValidDBInstanceModificationsCommandOutput, @@ -38,6 +43,9 @@ export class DescribeValidDBInstanceModificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/FailoverDBClusterCommand.ts b/clients/client-neptune/commands/FailoverDBClusterCommand.ts index af2486695c4d5..adff8531fea97 100644 --- a/clients/client-neptune/commands/FailoverDBClusterCommand.ts +++ b/clients/client-neptune/commands/FailoverDBClusterCommand.ts @@ -20,6 +20,16 @@ import { export type FailoverDBClusterCommandInput = FailoverDBClusterMessage; export type FailoverDBClusterCommandOutput = FailoverDBClusterResult & __MetadataBearer; +/** + *

Forces a failover for a DB cluster.

+ *

A failover for a DB cluster promotes one of the Read Replicas (read-only instances) in the + * DB cluster to be the primary instance (the cluster writer).

+ *

Amazon Neptune will automatically fail over to a Read Replica, if one exists, when the + * primary instance fails. You can force a failover when you want to simulate a failure of a + * primary instance for testing. Because each instance in a DB cluster has its own endpoint + * address, you will need to clean up and re-establish any existing connections that use those + * endpoint addresses when the failover is complete.

+ */ export class FailoverDBClusterCommand extends $Command< FailoverDBClusterCommandInput, FailoverDBClusterCommandOutput, @@ -34,6 +44,9 @@ export class FailoverDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ListTagsForResourceCommand.ts b/clients/client-neptune/commands/ListTagsForResourceCommand.ts index f59e5489e059b..d4157b7aeee52 100644 --- a/clients/client-neptune/commands/ListTagsForResourceCommand.ts +++ b/clients/client-neptune/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceMessage; export type ListTagsForResourceCommandOutput = TagListMessage & __MetadataBearer; +/** + *

Lists all tags on an Amazon Neptune resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ModifyDBClusterCommand.ts b/clients/client-neptune/commands/ModifyDBClusterCommand.ts index 36a054714ac32..5db988dc48e67 100644 --- a/clients/client-neptune/commands/ModifyDBClusterCommand.ts +++ b/clients/client-neptune/commands/ModifyDBClusterCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyDBClusterCommandInput = ModifyDBClusterMessage; export type ModifyDBClusterCommandOutput = ModifyDBClusterResult & __MetadataBearer; +/** + *

Modify a setting for a DB cluster. You can change one or more database configuration + * parameters by specifying these parameters and the new values in the request.

+ */ export class ModifyDBClusterCommand extends $Command< ModifyDBClusterCommandInput, ModifyDBClusterCommandOutput, @@ -34,6 +38,9 @@ export class ModifyDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ModifyDBClusterEndpointCommand.ts b/clients/client-neptune/commands/ModifyDBClusterEndpointCommand.ts index c1c192afe87ba..694f72eef719b 100644 --- a/clients/client-neptune/commands/ModifyDBClusterEndpointCommand.ts +++ b/clients/client-neptune/commands/ModifyDBClusterEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyDBClusterEndpointCommandInput = ModifyDBClusterEndpointMessage; export type ModifyDBClusterEndpointCommandOutput = ModifyDBClusterEndpointOutput & __MetadataBearer; +/** + *

Modifies the properties of an endpoint in an Amazon Neptune DB cluster.

+ */ export class ModifyDBClusterEndpointCommand extends $Command< ModifyDBClusterEndpointCommandInput, ModifyDBClusterEndpointCommandOutput, @@ -34,6 +37,9 @@ export class ModifyDBClusterEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ModifyDBClusterParameterGroupCommand.ts b/clients/client-neptune/commands/ModifyDBClusterParameterGroupCommand.ts index a7f8da8b2b8f6..d3c05bcbdd4fa 100644 --- a/clients/client-neptune/commands/ModifyDBClusterParameterGroupCommand.ts +++ b/clients/client-neptune/commands/ModifyDBClusterParameterGroupCommand.ts @@ -20,6 +20,29 @@ import { export type ModifyDBClusterParameterGroupCommandInput = ModifyDBClusterParameterGroupMessage; export type ModifyDBClusterParameterGroupCommandOutput = DBClusterParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a DB cluster parameter group. To modify more than one + * parameter, submit a list of the following: ParameterName, + * ParameterValue, and ApplyMethod. A maximum of 20 parameters can be + * modified in a single request.

+ * + * + *

Changes to dynamic parameters are applied immediately. Changes to static parameters + * require a reboot without failover to the DB cluster associated with the parameter group + * before the change can take effect.

+ *
+ * + *

After you create a DB cluster parameter group, you should wait at least 5 minutes before + * creating your first DB cluster that uses that DB cluster parameter group as the default + * parameter group. This allows Amazon Neptune to fully complete the create action before the + * parameter group is used as the default for a new DB cluster. This is especially important + * for parameters that are critical when creating the default database for a DB cluster, such + * as the character set for the default database defined by the + * character_set_database parameter. You can use the Parameter + * Groups option of the Amazon Neptune console or the DescribeDBClusterParameters command to verify that your DB cluster parameter + * group has been created or modified.

+ *
+ */ export class ModifyDBClusterParameterGroupCommand extends $Command< ModifyDBClusterParameterGroupCommandInput, ModifyDBClusterParameterGroupCommandOutput, @@ -34,6 +57,9 @@ export class ModifyDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ModifyDBClusterSnapshotAttributeCommand.ts b/clients/client-neptune/commands/ModifyDBClusterSnapshotAttributeCommand.ts index 431018adf41b7..c7dbf68c028fe 100644 --- a/clients/client-neptune/commands/ModifyDBClusterSnapshotAttributeCommand.ts +++ b/clients/client-neptune/commands/ModifyDBClusterSnapshotAttributeCommand.ts @@ -20,6 +20,22 @@ import { export type ModifyDBClusterSnapshotAttributeCommandInput = ModifyDBClusterSnapshotAttributeMessage; export type ModifyDBClusterSnapshotAttributeCommandOutput = ModifyDBClusterSnapshotAttributeResult & __MetadataBearer; +/** + *

Adds an attribute and values to, or removes an attribute and values from, a manual DB + * cluster snapshot.

+ *

To share a manual DB cluster snapshot with other AWS accounts, specify + * restore as the AttributeName and use the ValuesToAdd + * parameter to add a list of IDs of the AWS accounts that are authorized to restore the manual + * DB cluster snapshot. Use the value all to make the manual DB cluster snapshot + * public, which means that it can be copied or restored by all AWS accounts. Do not add the + * all value for any manual DB cluster snapshots that contain private information + * that you don't want available to all AWS accounts. If a manual DB cluster snapshot is + * encrypted, it can be shared, but only by specifying a list of authorized AWS account IDs for + * the ValuesToAdd parameter. You can't use all as a value for that + * parameter in this case.

+ *

To view which AWS accounts have access to copy or restore a manual DB cluster snapshot, or + * whether a manual DB cluster snapshot public or private, use the DescribeDBClusterSnapshotAttributes API action.

+ */ export class ModifyDBClusterSnapshotAttributeCommand extends $Command< ModifyDBClusterSnapshotAttributeCommandInput, ModifyDBClusterSnapshotAttributeCommandOutput, @@ -34,6 +50,9 @@ export class ModifyDBClusterSnapshotAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ModifyDBInstanceCommand.ts b/clients/client-neptune/commands/ModifyDBInstanceCommand.ts index 8b04192dddebf..4eb6b12b2c8f7 100644 --- a/clients/client-neptune/commands/ModifyDBInstanceCommand.ts +++ b/clients/client-neptune/commands/ModifyDBInstanceCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyDBInstanceCommandInput = ModifyDBInstanceMessage; export type ModifyDBInstanceCommandOutput = ModifyDBInstanceResult & __MetadataBearer; +/** + *

Modifies settings for a DB instance. You can change one or more database configuration + * parameters by specifying these parameters and the new values in the request. To learn what + * modifications you can make to your DB instance, call DescribeValidDBInstanceModifications before you call ModifyDBInstance.

+ */ export class ModifyDBInstanceCommand extends $Command< ModifyDBInstanceCommandInput, ModifyDBInstanceCommandOutput, @@ -34,6 +39,9 @@ export class ModifyDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ModifyDBParameterGroupCommand.ts b/clients/client-neptune/commands/ModifyDBParameterGroupCommand.ts index 5772e10d0eb63..2d272e81dc9c1 100644 --- a/clients/client-neptune/commands/ModifyDBParameterGroupCommand.ts +++ b/clients/client-neptune/commands/ModifyDBParameterGroupCommand.ts @@ -20,6 +20,28 @@ import { export type ModifyDBParameterGroupCommandInput = ModifyDBParameterGroupMessage; export type ModifyDBParameterGroupCommandOutput = DBParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a DB parameter group. To modify more than one parameter, + * submit a list of the following: ParameterName, ParameterValue, and + * ApplyMethod. A maximum of 20 parameters can be modified in a single request.

+ * + *

Changes to dynamic parameters are applied immediately. Changes to static parameters + * require a reboot without failover to the DB instance associated with the parameter group + * before the change can take effect.

+ *
+ * + *

After you modify a DB parameter group, you should wait at least 5 minutes before + * creating your first DB instance that uses that DB parameter group as the default parameter + * group. This allows Amazon Neptune to fully complete the modify action before the parameter + * group is used as the default for a new DB instance. This is especially important for + * parameters that are critical when creating the default database for a DB instance, such as + * the character set for the default database defined by the + * character_set_database parameter. You can use the Parameter + * Groups option of the Amazon Neptune console or the + * DescribeDBParameters command to verify that your DB parameter group has + * been created or modified.

+ *
+ */ export class ModifyDBParameterGroupCommand extends $Command< ModifyDBParameterGroupCommandInput, ModifyDBParameterGroupCommandOutput, @@ -34,6 +56,9 @@ export class ModifyDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ModifyDBSubnetGroupCommand.ts b/clients/client-neptune/commands/ModifyDBSubnetGroupCommand.ts index bfe3e457556ec..3da2c39d52ec2 100644 --- a/clients/client-neptune/commands/ModifyDBSubnetGroupCommand.ts +++ b/clients/client-neptune/commands/ModifyDBSubnetGroupCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyDBSubnetGroupCommandInput = ModifyDBSubnetGroupMessage; export type ModifyDBSubnetGroupCommandOutput = ModifyDBSubnetGroupResult & __MetadataBearer; +/** + *

Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in + * at least two AZs in the AWS Region.

+ */ export class ModifyDBSubnetGroupCommand extends $Command< ModifyDBSubnetGroupCommandInput, ModifyDBSubnetGroupCommandOutput, @@ -34,6 +38,9 @@ export class ModifyDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ModifyEventSubscriptionCommand.ts b/clients/client-neptune/commands/ModifyEventSubscriptionCommand.ts index dfef4a1715561..c6d9a3d614fa8 100644 --- a/clients/client-neptune/commands/ModifyEventSubscriptionCommand.ts +++ b/clients/client-neptune/commands/ModifyEventSubscriptionCommand.ts @@ -20,6 +20,13 @@ import { export type ModifyEventSubscriptionCommandInput = ModifyEventSubscriptionMessage; export type ModifyEventSubscriptionCommandOutput = ModifyEventSubscriptionResult & __MetadataBearer; +/** + *

Modifies an existing event notification subscription. Note that you can't modify the + * source identifiers using this call; to change source identifiers for a subscription, use the + * AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.

+ *

You can see a list of the event categories for a given SourceType + * by using the DescribeEventCategories action.

+ */ export class ModifyEventSubscriptionCommand extends $Command< ModifyEventSubscriptionCommandInput, ModifyEventSubscriptionCommandOutput, @@ -34,6 +41,9 @@ export class ModifyEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/PromoteReadReplicaDBClusterCommand.ts b/clients/client-neptune/commands/PromoteReadReplicaDBClusterCommand.ts index 49f4e5f18382e..afdaf635a6c15 100644 --- a/clients/client-neptune/commands/PromoteReadReplicaDBClusterCommand.ts +++ b/clients/client-neptune/commands/PromoteReadReplicaDBClusterCommand.ts @@ -20,6 +20,9 @@ import { export type PromoteReadReplicaDBClusterCommandInput = PromoteReadReplicaDBClusterMessage; export type PromoteReadReplicaDBClusterCommandOutput = PromoteReadReplicaDBClusterResult & __MetadataBearer; +/** + *

Not supported.

+ */ export class PromoteReadReplicaDBClusterCommand extends $Command< PromoteReadReplicaDBClusterCommandInput, PromoteReadReplicaDBClusterCommandOutput, @@ -34,6 +37,9 @@ export class PromoteReadReplicaDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/RebootDBInstanceCommand.ts b/clients/client-neptune/commands/RebootDBInstanceCommand.ts index bef237eaafffe..f0e8785aa5d87 100644 --- a/clients/client-neptune/commands/RebootDBInstanceCommand.ts +++ b/clients/client-neptune/commands/RebootDBInstanceCommand.ts @@ -20,6 +20,13 @@ import { export type RebootDBInstanceCommandInput = RebootDBInstanceMessage; export type RebootDBInstanceCommandOutput = RebootDBInstanceResult & __MetadataBearer; +/** + *

You might need to reboot your DB instance, usually for maintenance reasons. For example, + * if you make certain modifications, or if you change the DB parameter group associated with the + * DB instance, you must reboot the instance for the changes to take effect.

+ *

Rebooting a DB instance restarts the database engine service. Rebooting a DB instance + * results in a momentary outage, during which the DB instance status is set to rebooting.

+ */ export class RebootDBInstanceCommand extends $Command< RebootDBInstanceCommandInput, RebootDBInstanceCommandOutput, @@ -34,6 +41,9 @@ export class RebootDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/RemoveRoleFromDBClusterCommand.ts b/clients/client-neptune/commands/RemoveRoleFromDBClusterCommand.ts index 5542316348f8c..0e8c5601ff293 100644 --- a/clients/client-neptune/commands/RemoveRoleFromDBClusterCommand.ts +++ b/clients/client-neptune/commands/RemoveRoleFromDBClusterCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveRoleFromDBClusterCommandInput = RemoveRoleFromDBClusterMessage; export type RemoveRoleFromDBClusterCommandOutput = __MetadataBearer; +/** + *

Disassociates an Identity and Access Management (IAM) role from a DB cluster.

+ */ export class RemoveRoleFromDBClusterCommand extends $Command< RemoveRoleFromDBClusterCommandInput, RemoveRoleFromDBClusterCommandOutput, @@ -34,6 +37,9 @@ export class RemoveRoleFromDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/RemoveSourceIdentifierFromSubscriptionCommand.ts b/clients/client-neptune/commands/RemoveSourceIdentifierFromSubscriptionCommand.ts index b4c9471528244..c28f9bf877d25 100644 --- a/clients/client-neptune/commands/RemoveSourceIdentifierFromSubscriptionCommand.ts +++ b/clients/client-neptune/commands/RemoveSourceIdentifierFromSubscriptionCommand.ts @@ -24,6 +24,9 @@ export type RemoveSourceIdentifierFromSubscriptionCommandInput = RemoveSourceIde export type RemoveSourceIdentifierFromSubscriptionCommandOutput = RemoveSourceIdentifierFromSubscriptionResult & __MetadataBearer; +/** + *

Removes a source identifier from an existing event notification subscription.

+ */ export class RemoveSourceIdentifierFromSubscriptionCommand extends $Command< RemoveSourceIdentifierFromSubscriptionCommandInput, RemoveSourceIdentifierFromSubscriptionCommandOutput, @@ -38,6 +41,9 @@ export class RemoveSourceIdentifierFromSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/RemoveTagsFromResourceCommand.ts b/clients/client-neptune/commands/RemoveTagsFromResourceCommand.ts index e7da50c664832..1be4a7bca4963 100644 --- a/clients/client-neptune/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-neptune/commands/RemoveTagsFromResourceCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceMessage; export type RemoveTagsFromResourceCommandOutput = __MetadataBearer; +/** + *

Removes metadata tags from an Amazon Neptune resource.

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -34,6 +37,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ResetDBClusterParameterGroupCommand.ts b/clients/client-neptune/commands/ResetDBClusterParameterGroupCommand.ts index c160383faff2b..2b23b479c83f4 100644 --- a/clients/client-neptune/commands/ResetDBClusterParameterGroupCommand.ts +++ b/clients/client-neptune/commands/ResetDBClusterParameterGroupCommand.ts @@ -20,6 +20,16 @@ import { export type ResetDBClusterParameterGroupCommandInput = ResetDBClusterParameterGroupMessage; export type ResetDBClusterParameterGroupCommandOutput = DBClusterParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a DB cluster parameter group to the default value. To reset + * specific parameters submit a list of the following: ParameterName and + * ApplyMethod. To reset the entire DB cluster parameter group, specify the + * DBClusterParameterGroupName and ResetAllParameters parameters.

+ *

When resetting the entire group, dynamic parameters are updated immediately and static + * parameters are set to pending-reboot to take effect on the next DB instance + * restart or RebootDBInstance request. You must call RebootDBInstance for every DB instance in your DB cluster + * that you want the updated static parameter to apply to.

+ */ export class ResetDBClusterParameterGroupCommand extends $Command< ResetDBClusterParameterGroupCommandInput, ResetDBClusterParameterGroupCommandOutput, @@ -34,6 +44,9 @@ export class ResetDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/ResetDBParameterGroupCommand.ts b/clients/client-neptune/commands/ResetDBParameterGroupCommand.ts index dfd590669de57..038631ca3517d 100644 --- a/clients/client-neptune/commands/ResetDBParameterGroupCommand.ts +++ b/clients/client-neptune/commands/ResetDBParameterGroupCommand.ts @@ -20,6 +20,15 @@ import { export type ResetDBParameterGroupCommandInput = ResetDBParameterGroupMessage; export type ResetDBParameterGroupCommandOutput = DBParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a DB parameter group to the engine/system default value. To + * reset specific parameters, provide a list of the following: ParameterName and + * ApplyMethod. To reset the entire DB parameter group, specify the + * DBParameterGroup name and ResetAllParameters parameters. When + * resetting the entire group, dynamic parameters are updated immediately and static parameters + * are set to pending-reboot to take effect on the next DB instance restart or + * RebootDBInstance request.

+ */ export class ResetDBParameterGroupCommand extends $Command< ResetDBParameterGroupCommandInput, ResetDBParameterGroupCommandOutput, @@ -34,6 +43,9 @@ export class ResetDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/RestoreDBClusterFromSnapshotCommand.ts b/clients/client-neptune/commands/RestoreDBClusterFromSnapshotCommand.ts index fccf46e88269e..af99c39889f68 100644 --- a/clients/client-neptune/commands/RestoreDBClusterFromSnapshotCommand.ts +++ b/clients/client-neptune/commands/RestoreDBClusterFromSnapshotCommand.ts @@ -20,6 +20,14 @@ import { export type RestoreDBClusterFromSnapshotCommandInput = RestoreDBClusterFromSnapshotMessage; export type RestoreDBClusterFromSnapshotCommandOutput = RestoreDBClusterFromSnapshotResult & __MetadataBearer; +/** + *

Creates a new DB cluster from a DB snapshot or DB cluster snapshot.

+ *

If a DB snapshot is specified, the target DB cluster is created from the source DB + * snapshot with a default configuration and default security group.

+ *

If a DB cluster snapshot is specified, the target DB cluster is created from the source DB + * cluster restore point with the same configuration as the original source DB cluster, except + * that the new DB cluster is created with the default security group.

+ */ export class RestoreDBClusterFromSnapshotCommand extends $Command< RestoreDBClusterFromSnapshotCommandInput, RestoreDBClusterFromSnapshotCommandOutput, @@ -34,6 +42,9 @@ export class RestoreDBClusterFromSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/RestoreDBClusterToPointInTimeCommand.ts b/clients/client-neptune/commands/RestoreDBClusterToPointInTimeCommand.ts index 5b5e03260ffd7..ba769a17572e7 100644 --- a/clients/client-neptune/commands/RestoreDBClusterToPointInTimeCommand.ts +++ b/clients/client-neptune/commands/RestoreDBClusterToPointInTimeCommand.ts @@ -20,6 +20,21 @@ import { export type RestoreDBClusterToPointInTimeCommandInput = RestoreDBClusterToPointInTimeMessage; export type RestoreDBClusterToPointInTimeCommandOutput = RestoreDBClusterToPointInTimeResult & __MetadataBearer; +/** + *

Restores a DB cluster to an arbitrary point in time. Users can restore to any point in + * time before LatestRestorableTime for up to BackupRetentionPeriod + * days. The target DB cluster is created from the source DB cluster with the same configuration + * as the original DB cluster, except that the new DB cluster is created with the default DB + * security group.

+ * + *

This action only restores the DB cluster, not the DB instances for that DB cluster. You + * must invoke the CreateDBInstance action to create DB instances for the + * restored DB cluster, specifying the identifier of the restored DB cluster in + * DBClusterIdentifier. You can create DB instances only after the + * RestoreDBClusterToPointInTime action has completed and the DB cluster is + * available.

+ *
+ */ export class RestoreDBClusterToPointInTimeCommand extends $Command< RestoreDBClusterToPointInTimeCommandInput, RestoreDBClusterToPointInTimeCommandOutput, @@ -34,6 +49,9 @@ export class RestoreDBClusterToPointInTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/StartDBClusterCommand.ts b/clients/client-neptune/commands/StartDBClusterCommand.ts index 477a103c1439b..93435337878cb 100644 --- a/clients/client-neptune/commands/StartDBClusterCommand.ts +++ b/clients/client-neptune/commands/StartDBClusterCommand.ts @@ -20,6 +20,10 @@ import { export type StartDBClusterCommandInput = StartDBClusterMessage; export type StartDBClusterCommandOutput = StartDBClusterResult & __MetadataBearer; +/** + *

Starts an Amazon Neptune DB cluster that was stopped using the AWS + * console, the AWS CLI stop-db-cluster command, or the StopDBCluster API.

+ */ export class StartDBClusterCommand extends $Command< StartDBClusterCommandInput, StartDBClusterCommandOutput, @@ -34,6 +38,9 @@ export class StartDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/commands/StopDBClusterCommand.ts b/clients/client-neptune/commands/StopDBClusterCommand.ts index 5e16deb25cad1..4892395b287eb 100644 --- a/clients/client-neptune/commands/StopDBClusterCommand.ts +++ b/clients/client-neptune/commands/StopDBClusterCommand.ts @@ -20,6 +20,14 @@ import { export type StopDBClusterCommandInput = StopDBClusterMessage; export type StopDBClusterCommandOutput = StopDBClusterResult & __MetadataBearer; +/** + *

Stops an Amazon Neptune DB cluster. When you stop a DB cluster, Neptune + * retains the DB cluster's metadata, including its endpoints and DB parameter + * groups.

+ * + *

Neptune also retains the transaction logs so you can do a point-in-time + * restore if necessary.

+ */ export class StopDBClusterCommand extends $Command< StopDBClusterCommandInput, StopDBClusterCommandOutput, @@ -34,6 +42,9 @@ export class StopDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NeptuneClientResolvedConfig, diff --git a/clients/client-neptune/package.json b/clients/client-neptune/package.json index ba9bec0e1611a..36b71da2d82d1 100644 --- a/clients/client-neptune/package.json +++ b/clients/client-neptune/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Neptune Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-neptune/pagination/DescribeDBClusterEndpointsPaginator.ts b/clients/client-neptune/pagination/DescribeDBClusterEndpointsPaginator.ts index 380c527a16507..a93f9264ab845 100644 --- a/clients/client-neptune/pagination/DescribeDBClusterEndpointsPaginator.ts +++ b/clients/client-neptune/pagination/DescribeDBClusterEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeDBClusterEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeDBClusterEndpointsCommandInput, diff --git a/clients/client-neptune/pagination/DescribeDBEngineVersionsPaginator.ts b/clients/client-neptune/pagination/DescribeDBEngineVersionsPaginator.ts index cff444eb59560..2661b6ae3e91c 100644 --- a/clients/client-neptune/pagination/DescribeDBEngineVersionsPaginator.ts +++ b/clients/client-neptune/pagination/DescribeDBEngineVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeDBEngineVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBEngineVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeDBEngineVersionsCommandInput, diff --git a/clients/client-neptune/pagination/DescribeDBInstancesPaginator.ts b/clients/client-neptune/pagination/DescribeDBInstancesPaginator.ts index 7937015ac0164..a77a8d9017515 100644 --- a/clients/client-neptune/pagination/DescribeDBInstancesPaginator.ts +++ b/clients/client-neptune/pagination/DescribeDBInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeDBInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeDBInstancesCommandInput, diff --git a/clients/client-neptune/pagination/DescribeDBParameterGroupsPaginator.ts b/clients/client-neptune/pagination/DescribeDBParameterGroupsPaginator.ts index 787f1bb0d882e..f2423d8d6b234 100644 --- a/clients/client-neptune/pagination/DescribeDBParameterGroupsPaginator.ts +++ b/clients/client-neptune/pagination/DescribeDBParameterGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeDBParameterGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBParameterGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeDBParameterGroupsCommandInput, diff --git a/clients/client-neptune/pagination/DescribeDBParametersPaginator.ts b/clients/client-neptune/pagination/DescribeDBParametersPaginator.ts index 16ed2fa963ffa..3a5d98724169a 100644 --- a/clients/client-neptune/pagination/DescribeDBParametersPaginator.ts +++ b/clients/client-neptune/pagination/DescribeDBParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeDBParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeDBParametersCommandInput, diff --git a/clients/client-neptune/pagination/DescribeDBSubnetGroupsPaginator.ts b/clients/client-neptune/pagination/DescribeDBSubnetGroupsPaginator.ts index 9b9e2173c3772..940df19d1fdb8 100644 --- a/clients/client-neptune/pagination/DescribeDBSubnetGroupsPaginator.ts +++ b/clients/client-neptune/pagination/DescribeDBSubnetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeDBSubnetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBSubnetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeDBSubnetGroupsCommandInput, diff --git a/clients/client-neptune/pagination/DescribeEngineDefaultParametersPaginator.ts b/clients/client-neptune/pagination/DescribeEngineDefaultParametersPaginator.ts index 400d4c9cd7b93..9ae381864f7c7 100644 --- a/clients/client-neptune/pagination/DescribeEngineDefaultParametersPaginator.ts +++ b/clients/client-neptune/pagination/DescribeEngineDefaultParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeEngineDefaultParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEngineDefaultParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeEngineDefaultParametersCommandInput, diff --git a/clients/client-neptune/pagination/DescribeEventSubscriptionsPaginator.ts b/clients/client-neptune/pagination/DescribeEventSubscriptionsPaginator.ts index 35d2c21ab5c46..999340fca8684 100644 --- a/clients/client-neptune/pagination/DescribeEventSubscriptionsPaginator.ts +++ b/clients/client-neptune/pagination/DescribeEventSubscriptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeEventSubscriptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventSubscriptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeEventSubscriptionsCommandInput, diff --git a/clients/client-neptune/pagination/DescribeEventsPaginator.ts b/clients/client-neptune/pagination/DescribeEventsPaginator.ts index e6668d425d89a..84003b0607c60 100644 --- a/clients/client-neptune/pagination/DescribeEventsPaginator.ts +++ b/clients/client-neptune/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeEventsCommandInput, diff --git a/clients/client-neptune/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts b/clients/client-neptune/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts index d1b1615914a4b..00c577e60e60d 100644 --- a/clients/client-neptune/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts +++ b/clients/client-neptune/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { NeptunePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NeptuneClient, input: DescribeOrderableDBInstanceOptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOrderableDBInstanceOptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Neptune, input: DescribeOrderableDBInstanceOptionsCommandInput, diff --git a/clients/client-neptune/runtimeConfig.browser.ts b/clients/client-neptune/runtimeConfig.browser.ts index e48f141a3d33e..38fd55f960d5f 100644 --- a/clients/client-neptune/runtimeConfig.browser.ts +++ b/clients/client-neptune/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./NeptuneClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-neptune/runtimeConfig.native.ts b/clients/client-neptune/runtimeConfig.native.ts index 55d63281db246..2b8c9ce733206 100644 --- a/clients/client-neptune/runtimeConfig.native.ts +++ b/clients/client-neptune/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./NeptuneClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-neptune/runtimeConfig.shared.ts b/clients/client-neptune/runtimeConfig.shared.ts index 6c5afd6f19a75..7331c29e5ee1a 100644 --- a/clients/client-neptune/runtimeConfig.shared.ts +++ b/clients/client-neptune/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-10-31", disableHostPrefix: false, diff --git a/clients/client-neptune/runtimeConfig.ts b/clients/client-neptune/runtimeConfig.ts index 4cc82501e5858..a339deeb1e6d8 100644 --- a/clients/client-neptune/runtimeConfig.ts +++ b/clients/client-neptune/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./NeptuneClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-neptune/tsconfig.json b/clients/client-neptune/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-neptune/tsconfig.json +++ b/clients/client-neptune/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-network-firewall/commands/AssociateFirewallPolicyCommand.ts b/clients/client-network-firewall/commands/AssociateFirewallPolicyCommand.ts index d4da7c712dc81..ed0689dfab5a0 100644 --- a/clients/client-network-firewall/commands/AssociateFirewallPolicyCommand.ts +++ b/clients/client-network-firewall/commands/AssociateFirewallPolicyCommand.ts @@ -20,6 +20,13 @@ import { export type AssociateFirewallPolicyCommandInput = AssociateFirewallPolicyRequest; export type AssociateFirewallPolicyCommandOutput = AssociateFirewallPolicyResponse & __MetadataBearer; +/** + *

Associates a FirewallPolicy to a Firewall.

+ *

A firewall policy defines how to monitor and manage your VPC network traffic, using a + * collection of inspection rule groups and other settings. Each firewall requires one + * firewall policy association, and you can use the same firewall policy for multiple + * firewalls.

+ */ export class AssociateFirewallPolicyCommand extends $Command< AssociateFirewallPolicyCommandInput, AssociateFirewallPolicyCommandOutput, @@ -34,6 +41,9 @@ export class AssociateFirewallPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/AssociateSubnetsCommand.ts b/clients/client-network-firewall/commands/AssociateSubnetsCommand.ts index 90ca118e1340d..7de4df51ee375 100644 --- a/clients/client-network-firewall/commands/AssociateSubnetsCommand.ts +++ b/clients/client-network-firewall/commands/AssociateSubnetsCommand.ts @@ -20,6 +20,14 @@ import { export type AssociateSubnetsCommandInput = AssociateSubnetsRequest; export type AssociateSubnetsCommandOutput = AssociateSubnetsResponse & __MetadataBearer; +/** + *

Associates the specified subnets in the Amazon VPC to the firewall. You can specify one + * subnet for each of the Availability Zones that the VPC spans.

+ *

This request creates an AWS Network Firewall firewall endpoint in each of the subnets. To + * enable the firewall's protections, you must also modify the VPC's route tables for each + * subnet's Availability Zone, to redirect the traffic that's coming into and going out of the + * zone through the firewall endpoint.

+ */ export class AssociateSubnetsCommand extends $Command< AssociateSubnetsCommandInput, AssociateSubnetsCommandOutput, @@ -34,6 +42,9 @@ export class AssociateSubnetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/CreateFirewallCommand.ts b/clients/client-network-firewall/commands/CreateFirewallCommand.ts index ab918c8278ae0..07d40fe3d8464 100644 --- a/clients/client-network-firewall/commands/CreateFirewallCommand.ts +++ b/clients/client-network-firewall/commands/CreateFirewallCommand.ts @@ -20,6 +20,15 @@ import { export type CreateFirewallCommandInput = CreateFirewallRequest; export type CreateFirewallCommandOutput = CreateFirewallResponse & __MetadataBearer; +/** + *

Creates an AWS Network Firewall Firewall and accompanying FirewallStatus for a VPC.

+ *

The firewall defines the configuration settings for an AWS Network Firewall firewall. The settings that you can define at creation include the firewall policy, the subnets in your VPC to use for the firewall endpoints, and any tags that are attached to the firewall AWS resource.

+ *

After you create a firewall, you can provide additional settings, like the logging configuration.

+ *

To update the settings for a firewall, you use the operations that apply to the settings + * themselves, for example UpdateLoggingConfiguration, AssociateSubnets, and UpdateFirewallDeleteProtection.

+ *

To manage a firewall's tags, use the standard AWS resource tagging operations, ListTagsForResource, TagResource, and UntagResource.

+ *

To retrieve information about firewalls, use ListFirewalls and DescribeFirewall.

+ */ export class CreateFirewallCommand extends $Command< CreateFirewallCommandInput, CreateFirewallCommandOutput, @@ -34,6 +43,9 @@ export class CreateFirewallCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/CreateFirewallPolicyCommand.ts b/clients/client-network-firewall/commands/CreateFirewallPolicyCommand.ts index b3f9e9fa05218..4f73723288cd9 100644 --- a/clients/client-network-firewall/commands/CreateFirewallPolicyCommand.ts +++ b/clients/client-network-firewall/commands/CreateFirewallPolicyCommand.ts @@ -20,6 +20,12 @@ import { export type CreateFirewallPolicyCommandInput = CreateFirewallPolicyRequest; export type CreateFirewallPolicyCommandOutput = CreateFirewallPolicyResponse & __MetadataBearer; +/** + *

Creates the firewall policy for the firewall according to the specifications.

+ *

An AWS Network Firewall firewall policy defines the behavior of a firewall, in a collection of + * stateless and stateful rule groups and other settings. You can use one firewall policy for + * multiple firewalls.

+ */ export class CreateFirewallPolicyCommand extends $Command< CreateFirewallPolicyCommandInput, CreateFirewallPolicyCommandOutput, @@ -34,6 +40,9 @@ export class CreateFirewallPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/CreateRuleGroupCommand.ts b/clients/client-network-firewall/commands/CreateRuleGroupCommand.ts index b1d8942300f70..6385194a84d47 100644 --- a/clients/client-network-firewall/commands/CreateRuleGroupCommand.ts +++ b/clients/client-network-firewall/commands/CreateRuleGroupCommand.ts @@ -20,6 +20,12 @@ import { export type CreateRuleGroupCommandInput = CreateRuleGroupRequest; export type CreateRuleGroupCommandOutput = CreateRuleGroupResponse & __MetadataBearer; +/** + *

Creates the specified stateless or stateful rule group, which includes the rules for + * network traffic inspection, a capacity setting, and tags.

+ *

You provide your rule group specification in your request using either + * RuleGroup or Rules.

+ */ export class CreateRuleGroupCommand extends $Command< CreateRuleGroupCommandInput, CreateRuleGroupCommandOutput, @@ -34,6 +40,9 @@ export class CreateRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DeleteFirewallCommand.ts b/clients/client-network-firewall/commands/DeleteFirewallCommand.ts index 668c6bde52486..92697fd220317 100644 --- a/clients/client-network-firewall/commands/DeleteFirewallCommand.ts +++ b/clients/client-network-firewall/commands/DeleteFirewallCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteFirewallCommandInput = DeleteFirewallRequest; export type DeleteFirewallCommandOutput = DeleteFirewallResponse & __MetadataBearer; +/** + *

Deletes the specified Firewall and its FirewallStatus. This operation requires the firewall's DeleteProtection flag to be + * FALSE. You can't revert this operation.

+ *

You can check whether a firewall is + * in use by reviewing the route tables for the Availability Zones where you have + * firewall subnet mappings. Retrieve the subnet mappings by calling DescribeFirewall. + * You define and update the route tables through Amazon VPC. As needed, update the route tables for the + * zones to remove the firewall endpoints. When the route tables no longer use the firewall endpoints, + * you can remove the firewall safely.

+ *

To delete a firewall, remove the delete protection if you need to using UpdateFirewallDeleteProtection, + * then delete the firewall by calling DeleteFirewall.

+ */ export class DeleteFirewallCommand extends $Command< DeleteFirewallCommandInput, DeleteFirewallCommandOutput, @@ -34,6 +46,9 @@ export class DeleteFirewallCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DeleteFirewallPolicyCommand.ts b/clients/client-network-firewall/commands/DeleteFirewallPolicyCommand.ts index 67e092e59fa6f..1759ca14cf6c8 100644 --- a/clients/client-network-firewall/commands/DeleteFirewallPolicyCommand.ts +++ b/clients/client-network-firewall/commands/DeleteFirewallPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFirewallPolicyCommandInput = DeleteFirewallPolicyRequest; export type DeleteFirewallPolicyCommandOutput = DeleteFirewallPolicyResponse & __MetadataBearer; +/** + *

Deletes the specified FirewallPolicy.

+ */ export class DeleteFirewallPolicyCommand extends $Command< DeleteFirewallPolicyCommandInput, DeleteFirewallPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFirewallPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DeleteResourcePolicyCommand.ts b/clients/client-network-firewall/commands/DeleteResourcePolicyCommand.ts index 4c2b6fba9c73b..f1e964b0add9d 100644 --- a/clients/client-network-firewall/commands/DeleteResourcePolicyCommand.ts +++ b/clients/client-network-firewall/commands/DeleteResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourcePolicyCommandInput = DeleteResourcePolicyRequest; export type DeleteResourcePolicyCommandOutput = DeleteResourcePolicyResponse & __MetadataBearer; +/** + *

Deletes a resource policy that you created in a PutResourcePolicy request.

+ */ export class DeleteResourcePolicyCommand extends $Command< DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DeleteRuleGroupCommand.ts b/clients/client-network-firewall/commands/DeleteRuleGroupCommand.ts index 5b4c13de93feb..feaeeff6a734e 100644 --- a/clients/client-network-firewall/commands/DeleteRuleGroupCommand.ts +++ b/clients/client-network-firewall/commands/DeleteRuleGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRuleGroupCommandInput = DeleteRuleGroupRequest; export type DeleteRuleGroupCommandOutput = DeleteRuleGroupResponse & __MetadataBearer; +/** + *

Deletes the specified RuleGroup.

+ */ export class DeleteRuleGroupCommand extends $Command< DeleteRuleGroupCommandInput, DeleteRuleGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DescribeFirewallCommand.ts b/clients/client-network-firewall/commands/DescribeFirewallCommand.ts index 4afa3c06ea8d8..21626452698b2 100644 --- a/clients/client-network-firewall/commands/DescribeFirewallCommand.ts +++ b/clients/client-network-firewall/commands/DescribeFirewallCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFirewallCommandInput = DescribeFirewallRequest; export type DescribeFirewallCommandOutput = DescribeFirewallResponse & __MetadataBearer; +/** + *

Returns the data objects for the specified firewall.

+ */ export class DescribeFirewallCommand extends $Command< DescribeFirewallCommandInput, DescribeFirewallCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFirewallCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DescribeFirewallPolicyCommand.ts b/clients/client-network-firewall/commands/DescribeFirewallPolicyCommand.ts index 4aa0389ebd4ad..1a820b38bb364 100644 --- a/clients/client-network-firewall/commands/DescribeFirewallPolicyCommand.ts +++ b/clients/client-network-firewall/commands/DescribeFirewallPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFirewallPolicyCommandInput = DescribeFirewallPolicyRequest; export type DescribeFirewallPolicyCommandOutput = DescribeFirewallPolicyResponse & __MetadataBearer; +/** + *

Returns the data objects for the specified firewall policy.

+ */ export class DescribeFirewallPolicyCommand extends $Command< DescribeFirewallPolicyCommandInput, DescribeFirewallPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFirewallPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DescribeLoggingConfigurationCommand.ts b/clients/client-network-firewall/commands/DescribeLoggingConfigurationCommand.ts index f8e3572de06da..e65a1f254a0b8 100644 --- a/clients/client-network-firewall/commands/DescribeLoggingConfigurationCommand.ts +++ b/clients/client-network-firewall/commands/DescribeLoggingConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLoggingConfigurationCommandInput = DescribeLoggingConfigurationRequest; export type DescribeLoggingConfigurationCommandOutput = DescribeLoggingConfigurationResponse & __MetadataBearer; +/** + *

Returns the logging configuration for the specified firewall.

+ */ export class DescribeLoggingConfigurationCommand extends $Command< DescribeLoggingConfigurationCommandInput, DescribeLoggingConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DescribeResourcePolicyCommand.ts b/clients/client-network-firewall/commands/DescribeResourcePolicyCommand.ts index 3283b88fe0c45..2672ec0c61d7b 100644 --- a/clients/client-network-firewall/commands/DescribeResourcePolicyCommand.ts +++ b/clients/client-network-firewall/commands/DescribeResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeResourcePolicyCommandInput = DescribeResourcePolicyRequest; export type DescribeResourcePolicyCommandOutput = DescribeResourcePolicyResponse & __MetadataBearer; +/** + *

Retrieves a resource policy that you created in a PutResourcePolicy request.

+ */ export class DescribeResourcePolicyCommand extends $Command< DescribeResourcePolicyCommandInput, DescribeResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class DescribeResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DescribeRuleGroupCommand.ts b/clients/client-network-firewall/commands/DescribeRuleGroupCommand.ts index 0e263661079ac..77fc617d686e9 100644 --- a/clients/client-network-firewall/commands/DescribeRuleGroupCommand.ts +++ b/clients/client-network-firewall/commands/DescribeRuleGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRuleGroupCommandInput = DescribeRuleGroupRequest; export type DescribeRuleGroupCommandOutput = DescribeRuleGroupResponse & __MetadataBearer; +/** + *

Returns the data objects for the specified rule group.

+ */ export class DescribeRuleGroupCommand extends $Command< DescribeRuleGroupCommandInput, DescribeRuleGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/DisassociateSubnetsCommand.ts b/clients/client-network-firewall/commands/DisassociateSubnetsCommand.ts index deb80fd683bb2..9781e6e5bbf67 100644 --- a/clients/client-network-firewall/commands/DisassociateSubnetsCommand.ts +++ b/clients/client-network-firewall/commands/DisassociateSubnetsCommand.ts @@ -20,6 +20,12 @@ import { export type DisassociateSubnetsCommandInput = DisassociateSubnetsRequest; export type DisassociateSubnetsCommandOutput = DisassociateSubnetsResponse & __MetadataBearer; +/** + *

Removes the specified subnet associations from the firewall. This removes the + * firewall endpoints from the subnets and removes any network filtering protections that the endpoints + * were providing. + *

+ */ export class DisassociateSubnetsCommand extends $Command< DisassociateSubnetsCommandInput, DisassociateSubnetsCommandOutput, @@ -34,6 +40,9 @@ export class DisassociateSubnetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/ListFirewallPoliciesCommand.ts b/clients/client-network-firewall/commands/ListFirewallPoliciesCommand.ts index aec4129ee60b5..f5dd0f3352c61 100644 --- a/clients/client-network-firewall/commands/ListFirewallPoliciesCommand.ts +++ b/clients/client-network-firewall/commands/ListFirewallPoliciesCommand.ts @@ -20,6 +20,11 @@ import { export type ListFirewallPoliciesCommandInput = ListFirewallPoliciesRequest; export type ListFirewallPoliciesCommandOutput = ListFirewallPoliciesResponse & __MetadataBearer; +/** + *

Retrieves the metadata for the firewall policies that you have defined. Depending on + * your setting for max results and the number of firewall policies, a single call might not + * return the full list.

+ */ export class ListFirewallPoliciesCommand extends $Command< ListFirewallPoliciesCommandInput, ListFirewallPoliciesCommandOutput, @@ -34,6 +39,9 @@ export class ListFirewallPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/ListFirewallsCommand.ts b/clients/client-network-firewall/commands/ListFirewallsCommand.ts index e1a1cd1ce44ec..80ce9ae3d0e73 100644 --- a/clients/client-network-firewall/commands/ListFirewallsCommand.ts +++ b/clients/client-network-firewall/commands/ListFirewallsCommand.ts @@ -20,6 +20,12 @@ import { export type ListFirewallsCommandInput = ListFirewallsRequest; export type ListFirewallsCommandOutput = ListFirewallsResponse & __MetadataBearer; +/** + *

Retrieves the metadata for the firewalls that you have defined. If you provide VPC + * identifiers in your request, this returns only the firewalls for those VPCs.

+ *

Depending on your setting for max results and the number of firewalls, a single call + * might not return the full list.

+ */ export class ListFirewallsCommand extends $Command< ListFirewallsCommandInput, ListFirewallsCommandOutput, @@ -34,6 +40,9 @@ export class ListFirewallsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/ListRuleGroupsCommand.ts b/clients/client-network-firewall/commands/ListRuleGroupsCommand.ts index 999faa81e9056..2647f107bbaf1 100644 --- a/clients/client-network-firewall/commands/ListRuleGroupsCommand.ts +++ b/clients/client-network-firewall/commands/ListRuleGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type ListRuleGroupsCommandInput = ListRuleGroupsRequest; export type ListRuleGroupsCommandOutput = ListRuleGroupsResponse & __MetadataBearer; +/** + *

Retrieves the metadata for the rule groups that you have defined. Depending on your + * setting for max results and the number of rule groups, a single call might not return the + * full list.

+ */ export class ListRuleGroupsCommand extends $Command< ListRuleGroupsCommandInput, ListRuleGroupsCommandOutput, @@ -34,6 +39,9 @@ export class ListRuleGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/ListTagsForResourceCommand.ts b/clients/client-network-firewall/commands/ListTagsForResourceCommand.ts index cb1f0206cd432..89d3dbb251956 100644 --- a/clients/client-network-firewall/commands/ListTagsForResourceCommand.ts +++ b/clients/client-network-firewall/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,15 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves the tags associated with the specified resource. Tags are key:value pairs that + * you can use to categorize and manage your resources, for purposes like billing. For + * example, you might set the tag key to "customer" and the value to the customer name or ID. + * You can specify one or more tags to add to each AWS resource, up to 50 tags for a + * resource.

+ *

You can tag the AWS resources that you manage through AWS Network Firewall: firewalls, firewall + * policies, and rule groups.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +43,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/PutResourcePolicyCommand.ts b/clients/client-network-firewall/commands/PutResourcePolicyCommand.ts index 9a9cfa70ddeb5..39158b2a3d158 100644 --- a/clients/client-network-firewall/commands/PutResourcePolicyCommand.ts +++ b/clients/client-network-firewall/commands/PutResourcePolicyCommand.ts @@ -20,6 +20,23 @@ import { export type PutResourcePolicyCommandInput = PutResourcePolicyRequest; export type PutResourcePolicyCommandOutput = PutResourcePolicyResponse & __MetadataBearer; +/** + *

Creates or updates an AWS Identity and Access Management policy for your rule group or firewall policy. Use this to share rule groups and firewall policies between accounts. This operation works in conjunction with the AWS Resource Access Manager (RAM) service + * to manage resource sharing for Network Firewall.

+ *

Use this operation to create or update a resource policy for your rule group or firewall policy. In the policy, you specify the accounts that you want to share the resource with and the operations that you want the accounts to be able to perform.

+ *

When you add an account in the resource policy, you then run the following Resource Access Manager (RAM) operations to access and accept the shared rule group or firewall policy.

+ * + *

For additional information about resource sharing using RAM, see AWS Resource Access Manager User Guide.

+ */ export class PutResourcePolicyCommand extends $Command< PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput, @@ -34,6 +51,9 @@ export class PutResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/TagResourceCommand.ts b/clients/client-network-firewall/commands/TagResourceCommand.ts index 37202512106da..099629b165399 100644 --- a/clients/client-network-firewall/commands/TagResourceCommand.ts +++ b/clients/client-network-firewall/commands/TagResourceCommand.ts @@ -20,6 +20,14 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds the specified tags to the specified resource. Tags are key:value pairs that you can + * use to categorize and manage your resources, for purposes like billing. For example, you + * might set the tag key to "customer" and the value to the customer name or ID. You can + * specify one or more tags to add to each AWS resource, up to 50 tags for a resource.

+ *

You can tag the AWS resources that you manage through AWS Network Firewall: firewalls, firewall + * policies, and rule groups.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +42,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/UntagResourceCommand.ts b/clients/client-network-firewall/commands/UntagResourceCommand.ts index 03989419ff778..1f41d2881a757 100644 --- a/clients/client-network-firewall/commands/UntagResourceCommand.ts +++ b/clients/client-network-firewall/commands/UntagResourceCommand.ts @@ -20,6 +20,15 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the tags with the specified keys from the specified resource. Tags are key:value + * pairs that you can use to categorize and manage your resources, for purposes like billing. + * For example, you might set the tag key to "customer" and the value to the customer name or + * ID. You can specify one or more tags to add to each AWS resource, up to 50 tags for a + * resource.

+ *

You can manage tags for the AWS resources that you manage through AWS Network Firewall: + * firewalls, firewall policies, and rule groups.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +43,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/UpdateFirewallDeleteProtectionCommand.ts b/clients/client-network-firewall/commands/UpdateFirewallDeleteProtectionCommand.ts index 08b2a8e0d3bc0..eacced17cbd26 100644 --- a/clients/client-network-firewall/commands/UpdateFirewallDeleteProtectionCommand.ts +++ b/clients/client-network-firewall/commands/UpdateFirewallDeleteProtectionCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateFirewallDeleteProtectionCommandInput = UpdateFirewallDeleteProtectionRequest; export type UpdateFirewallDeleteProtectionCommandOutput = UpdateFirewallDeleteProtectionResponse & __MetadataBearer; +/** + *

Modifies the flag, DeleteProtection, which indicates whether it is possible + * to delete the firewall. If the flag is set to TRUE, the firewall is protected + * against deletion. This setting helps protect against accidentally deleting a firewall + * that's in use.

+ */ export class UpdateFirewallDeleteProtectionCommand extends $Command< UpdateFirewallDeleteProtectionCommandInput, UpdateFirewallDeleteProtectionCommandOutput, @@ -34,6 +40,9 @@ export class UpdateFirewallDeleteProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/UpdateFirewallDescriptionCommand.ts b/clients/client-network-firewall/commands/UpdateFirewallDescriptionCommand.ts index cd2817808e972..ebafb08587677 100644 --- a/clients/client-network-firewall/commands/UpdateFirewallDescriptionCommand.ts +++ b/clients/client-network-firewall/commands/UpdateFirewallDescriptionCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateFirewallDescriptionCommandInput = UpdateFirewallDescriptionRequest; export type UpdateFirewallDescriptionCommandOutput = UpdateFirewallDescriptionResponse & __MetadataBearer; +/** + *

Modifies the description for the specified firewall. Use the description to help you + * identify the firewall when you're working with it.

+ */ export class UpdateFirewallDescriptionCommand extends $Command< UpdateFirewallDescriptionCommandInput, UpdateFirewallDescriptionCommandOutput, @@ -34,6 +38,9 @@ export class UpdateFirewallDescriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/UpdateFirewallPolicyChangeProtectionCommand.ts b/clients/client-network-firewall/commands/UpdateFirewallPolicyChangeProtectionCommand.ts index 6826dfc505e27..cdf03d6dc49b9 100644 --- a/clients/client-network-firewall/commands/UpdateFirewallPolicyChangeProtectionCommand.ts +++ b/clients/client-network-firewall/commands/UpdateFirewallPolicyChangeProtectionCommand.ts @@ -24,6 +24,9 @@ export type UpdateFirewallPolicyChangeProtectionCommandInput = UpdateFirewallPol export type UpdateFirewallPolicyChangeProtectionCommandOutput = UpdateFirewallPolicyChangeProtectionResponse & __MetadataBearer; +/** + *

+ */ export class UpdateFirewallPolicyChangeProtectionCommand extends $Command< UpdateFirewallPolicyChangeProtectionCommandInput, UpdateFirewallPolicyChangeProtectionCommandOutput, @@ -38,6 +41,9 @@ export class UpdateFirewallPolicyChangeProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/UpdateFirewallPolicyCommand.ts b/clients/client-network-firewall/commands/UpdateFirewallPolicyCommand.ts index 15f7e0a462a0e..6056d70c6966a 100644 --- a/clients/client-network-firewall/commands/UpdateFirewallPolicyCommand.ts +++ b/clients/client-network-firewall/commands/UpdateFirewallPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFirewallPolicyCommandInput = UpdateFirewallPolicyRequest; export type UpdateFirewallPolicyCommandOutput = UpdateFirewallPolicyResponse & __MetadataBearer; +/** + *

Updates the properties of the specified firewall policy.

+ */ export class UpdateFirewallPolicyCommand extends $Command< UpdateFirewallPolicyCommandInput, UpdateFirewallPolicyCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFirewallPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/UpdateLoggingConfigurationCommand.ts b/clients/client-network-firewall/commands/UpdateLoggingConfigurationCommand.ts index b2fea1bed4a13..4adae1c40d025 100644 --- a/clients/client-network-firewall/commands/UpdateLoggingConfigurationCommand.ts +++ b/clients/client-network-firewall/commands/UpdateLoggingConfigurationCommand.ts @@ -20,6 +20,34 @@ import { export type UpdateLoggingConfigurationCommandInput = UpdateLoggingConfigurationRequest; export type UpdateLoggingConfigurationCommandOutput = UpdateLoggingConfigurationResponse & __MetadataBearer; +/** + *

Sets the logging configuration for the specified firewall.

+ *

To change the logging configuration, retrieve the LoggingConfiguration by calling DescribeLoggingConfiguration, then change it and provide + * the modified object to this update call. You must change the logging configuration one + * LogDestinationConfig at a time inside the retrieved LoggingConfiguration object.

+ *

You can perform only one of the following actions in any call to + * UpdateLoggingConfiguration:

+ *
    + *
  • + *

    Create a new log destination object by adding a single + * LogDestinationConfig array element to + * LogDestinationConfigs.

    + *
  • + *
  • + *

    Delete a log destination object by removing a single + * LogDestinationConfig array element from + * LogDestinationConfigs.

    + *
  • + *
  • + *

    Change the LogDestination setting in a single + * LogDestinationConfig array element.

    + *
  • + *
+ *

You can't change the LogDestinationType or LogType in a + * LogDestinationConfig. To change these settings, delete the existing + * LogDestinationConfig object and create a new one, using two separate calls + * to this update operation.

+ */ export class UpdateLoggingConfigurationCommand extends $Command< UpdateLoggingConfigurationCommandInput, UpdateLoggingConfigurationCommandOutput, @@ -34,6 +62,9 @@ export class UpdateLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/UpdateRuleGroupCommand.ts b/clients/client-network-firewall/commands/UpdateRuleGroupCommand.ts index 87bc89d52a5a9..100064edae264 100644 --- a/clients/client-network-firewall/commands/UpdateRuleGroupCommand.ts +++ b/clients/client-network-firewall/commands/UpdateRuleGroupCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateRuleGroupCommandInput = UpdateRuleGroupRequest; export type UpdateRuleGroupCommandOutput = UpdateRuleGroupResponse & __MetadataBearer; +/** + *

Updates the rule settings for the specified rule group. You use a rule group by + * reference in one or more firewall policies. When you modify a rule group, you modify all + * firewall policies that use the rule group.

+ *

To update a rule group, first call DescribeRuleGroup to retrieve the + * current RuleGroup object, update the object as needed, and then provide + * the updated object to this call.

+ */ export class UpdateRuleGroupCommand extends $Command< UpdateRuleGroupCommandInput, UpdateRuleGroupCommandOutput, @@ -34,6 +42,9 @@ export class UpdateRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/commands/UpdateSubnetChangeProtectionCommand.ts b/clients/client-network-firewall/commands/UpdateSubnetChangeProtectionCommand.ts index e1f4d577b7ccd..eb66a545cdf71 100644 --- a/clients/client-network-firewall/commands/UpdateSubnetChangeProtectionCommand.ts +++ b/clients/client-network-firewall/commands/UpdateSubnetChangeProtectionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSubnetChangeProtectionCommandInput = UpdateSubnetChangeProtectionRequest; export type UpdateSubnetChangeProtectionCommandOutput = UpdateSubnetChangeProtectionResponse & __MetadataBearer; +/** + *

+ */ export class UpdateSubnetChangeProtectionCommand extends $Command< UpdateSubnetChangeProtectionCommandInput, UpdateSubnetChangeProtectionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSubnetChangeProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkFirewallClientResolvedConfig, diff --git a/clients/client-network-firewall/package.json b/clients/client-network-firewall/package.json index fa1acf1f46ada..f6ae0e87eba62 100644 --- a/clients/client-network-firewall/package.json +++ b/clients/client-network-firewall/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Network Firewall Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-network-firewall/pagination/ListFirewallPoliciesPaginator.ts b/clients/client-network-firewall/pagination/ListFirewallPoliciesPaginator.ts index 98ae7e0788a19..b74b4a1e3befb 100644 --- a/clients/client-network-firewall/pagination/ListFirewallPoliciesPaginator.ts +++ b/clients/client-network-firewall/pagination/ListFirewallPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { NetworkFirewallPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkFirewallClient, input: ListFirewallPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFirewallPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkFirewall, input: ListFirewallPoliciesCommandInput, diff --git a/clients/client-network-firewall/pagination/ListFirewallsPaginator.ts b/clients/client-network-firewall/pagination/ListFirewallsPaginator.ts index c2d5b30df1768..5bfaf509f7188 100644 --- a/clients/client-network-firewall/pagination/ListFirewallsPaginator.ts +++ b/clients/client-network-firewall/pagination/ListFirewallsPaginator.ts @@ -8,6 +8,9 @@ import { import { NetworkFirewallPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkFirewallClient, input: ListFirewallsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFirewallsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkFirewall, input: ListFirewallsCommandInput, diff --git a/clients/client-network-firewall/pagination/ListRuleGroupsPaginator.ts b/clients/client-network-firewall/pagination/ListRuleGroupsPaginator.ts index fc4869a75efbf..db653f4b2a6c5 100644 --- a/clients/client-network-firewall/pagination/ListRuleGroupsPaginator.ts +++ b/clients/client-network-firewall/pagination/ListRuleGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { NetworkFirewallPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkFirewallClient, input: ListRuleGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRuleGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkFirewall, input: ListRuleGroupsCommandInput, diff --git a/clients/client-network-firewall/pagination/ListTagsForResourcePaginator.ts b/clients/client-network-firewall/pagination/ListTagsForResourcePaginator.ts index aff4bf4e7bea9..a7469c0427ed7 100644 --- a/clients/client-network-firewall/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-network-firewall/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { NetworkFirewallPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkFirewallClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkFirewall, input: ListTagsForResourceCommandInput, diff --git a/clients/client-network-firewall/runtimeConfig.browser.ts b/clients/client-network-firewall/runtimeConfig.browser.ts index 838e3672833c0..aab700e45e125 100644 --- a/clients/client-network-firewall/runtimeConfig.browser.ts +++ b/clients/client-network-firewall/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./NetworkFirewallClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-network-firewall/runtimeConfig.native.ts b/clients/client-network-firewall/runtimeConfig.native.ts index 35386ba65cb8b..9080a99499d2b 100644 --- a/clients/client-network-firewall/runtimeConfig.native.ts +++ b/clients/client-network-firewall/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./NetworkFirewallClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-network-firewall/runtimeConfig.shared.ts b/clients/client-network-firewall/runtimeConfig.shared.ts index 5806c1f9ffbd0..9f9f88e080c3c 100644 --- a/clients/client-network-firewall/runtimeConfig.shared.ts +++ b/clients/client-network-firewall/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-11-12", disableHostPrefix: false, diff --git a/clients/client-network-firewall/runtimeConfig.ts b/clients/client-network-firewall/runtimeConfig.ts index 8662d08223e63..e4bd0276e1fc3 100644 --- a/clients/client-network-firewall/runtimeConfig.ts +++ b/clients/client-network-firewall/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./NetworkFirewallClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-network-firewall/tsconfig.json b/clients/client-network-firewall/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-network-firewall/tsconfig.json +++ b/clients/client-network-firewall/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-networkmanager/commands/AssociateCustomerGatewayCommand.ts b/clients/client-networkmanager/commands/AssociateCustomerGatewayCommand.ts index d259fe84cb475..59f091c3e2784 100644 --- a/clients/client-networkmanager/commands/AssociateCustomerGatewayCommand.ts +++ b/clients/client-networkmanager/commands/AssociateCustomerGatewayCommand.ts @@ -20,6 +20,17 @@ import { export type AssociateCustomerGatewayCommandInput = AssociateCustomerGatewayRequest; export type AssociateCustomerGatewayCommandOutput = AssociateCustomerGatewayResponse & __MetadataBearer; +/** + *

Associates a customer gateway with a device and optionally, with a link. If you + * specify a link, it must be associated with the specified device.

+ *

You can only associate customer gateways that are connected to a VPN attachment on a + * transit gateway. The transit gateway must be registered in your global network. When + * you register a transit gateway, customer gateways that are connected to the transit + * gateway are automatically included in the global network. To list customer gateways + * that are connected to a transit gateway, use the DescribeVpnConnections EC2 API and filter by + * transit-gateway-id.

+ *

You cannot associate a customer gateway with more than one device and link.

+ */ export class AssociateCustomerGatewayCommand extends $Command< AssociateCustomerGatewayCommandInput, AssociateCustomerGatewayCommandOutput, @@ -34,6 +45,9 @@ export class AssociateCustomerGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/AssociateLinkCommand.ts b/clients/client-networkmanager/commands/AssociateLinkCommand.ts index 152dc103fab9e..e7edf29fdbc0f 100644 --- a/clients/client-networkmanager/commands/AssociateLinkCommand.ts +++ b/clients/client-networkmanager/commands/AssociateLinkCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateLinkCommandInput = AssociateLinkRequest; export type AssociateLinkCommandOutput = AssociateLinkResponse & __MetadataBearer; +/** + *

Associates a link to a device. A device can be associated to multiple links and a link can be associated to multiple devices. The device and link must be in the same global network and the same site.

+ */ export class AssociateLinkCommand extends $Command< AssociateLinkCommandInput, AssociateLinkCommandOutput, @@ -34,6 +37,9 @@ export class AssociateLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/CreateDeviceCommand.ts b/clients/client-networkmanager/commands/CreateDeviceCommand.ts index 6c8b4d9473b48..982d098b62232 100644 --- a/clients/client-networkmanager/commands/CreateDeviceCommand.ts +++ b/clients/client-networkmanager/commands/CreateDeviceCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDeviceCommandInput = CreateDeviceRequest; export type CreateDeviceCommandOutput = CreateDeviceResponse & __MetadataBearer; +/** + *

Creates a new device in a global network. If you specify both a site ID and a + * location, the location of the site is used for visualization in the Network Manager console.

+ */ export class CreateDeviceCommand extends $Command< CreateDeviceCommandInput, CreateDeviceCommandOutput, @@ -34,6 +38,9 @@ export class CreateDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/CreateGlobalNetworkCommand.ts b/clients/client-networkmanager/commands/CreateGlobalNetworkCommand.ts index c0df3ab7e9646..bb0a3ffcad46a 100644 --- a/clients/client-networkmanager/commands/CreateGlobalNetworkCommand.ts +++ b/clients/client-networkmanager/commands/CreateGlobalNetworkCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGlobalNetworkCommandInput = CreateGlobalNetworkRequest; export type CreateGlobalNetworkCommandOutput = CreateGlobalNetworkResponse & __MetadataBearer; +/** + *

Creates a new, empty global network.

+ */ export class CreateGlobalNetworkCommand extends $Command< CreateGlobalNetworkCommandInput, CreateGlobalNetworkCommandOutput, @@ -34,6 +37,9 @@ export class CreateGlobalNetworkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/CreateLinkCommand.ts b/clients/client-networkmanager/commands/CreateLinkCommand.ts index 8b908168920ed..fcb6ac5b6ce70 100644 --- a/clients/client-networkmanager/commands/CreateLinkCommand.ts +++ b/clients/client-networkmanager/commands/CreateLinkCommand.ts @@ -20,6 +20,9 @@ import { export type CreateLinkCommandInput = CreateLinkRequest; export type CreateLinkCommandOutput = CreateLinkResponse & __MetadataBearer; +/** + *

Creates a new link for a specified site.

+ */ export class CreateLinkCommand extends $Command< CreateLinkCommandInput, CreateLinkCommandOutput, @@ -34,6 +37,9 @@ export class CreateLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/CreateSiteCommand.ts b/clients/client-networkmanager/commands/CreateSiteCommand.ts index 83ffa53cf1c52..658480fd3da3d 100644 --- a/clients/client-networkmanager/commands/CreateSiteCommand.ts +++ b/clients/client-networkmanager/commands/CreateSiteCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSiteCommandInput = CreateSiteRequest; export type CreateSiteCommandOutput = CreateSiteResponse & __MetadataBearer; +/** + *

Creates a new site in a global network.

+ */ export class CreateSiteCommand extends $Command< CreateSiteCommandInput, CreateSiteCommandOutput, @@ -34,6 +37,9 @@ export class CreateSiteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/DeleteDeviceCommand.ts b/clients/client-networkmanager/commands/DeleteDeviceCommand.ts index 2adc2ce2524d9..582fc8613e952 100644 --- a/clients/client-networkmanager/commands/DeleteDeviceCommand.ts +++ b/clients/client-networkmanager/commands/DeleteDeviceCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDeviceCommandInput = DeleteDeviceRequest; export type DeleteDeviceCommandOutput = DeleteDeviceResponse & __MetadataBearer; +/** + *

Deletes an existing device. You must first disassociate the device from any links and + * customer gateways.

+ */ export class DeleteDeviceCommand extends $Command< DeleteDeviceCommandInput, DeleteDeviceCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/DeleteGlobalNetworkCommand.ts b/clients/client-networkmanager/commands/DeleteGlobalNetworkCommand.ts index 9498c7da75e93..3b7cdce81843d 100644 --- a/clients/client-networkmanager/commands/DeleteGlobalNetworkCommand.ts +++ b/clients/client-networkmanager/commands/DeleteGlobalNetworkCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteGlobalNetworkCommandInput = DeleteGlobalNetworkRequest; export type DeleteGlobalNetworkCommandOutput = DeleteGlobalNetworkResponse & __MetadataBearer; +/** + *

Deletes an existing global network. You must first delete all global network objects + * (devices, links, and sites) and deregister all transit gateways.

+ */ export class DeleteGlobalNetworkCommand extends $Command< DeleteGlobalNetworkCommandInput, DeleteGlobalNetworkCommandOutput, @@ -34,6 +38,9 @@ export class DeleteGlobalNetworkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/DeleteLinkCommand.ts b/clients/client-networkmanager/commands/DeleteLinkCommand.ts index 00e05daa47002..d4c90667f8612 100644 --- a/clients/client-networkmanager/commands/DeleteLinkCommand.ts +++ b/clients/client-networkmanager/commands/DeleteLinkCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteLinkCommandInput = DeleteLinkRequest; export type DeleteLinkCommandOutput = DeleteLinkResponse & __MetadataBearer; +/** + *

Deletes an existing link. You must first disassociate the link from any devices and + * customer gateways.

+ */ export class DeleteLinkCommand extends $Command< DeleteLinkCommandInput, DeleteLinkCommandOutput, @@ -34,6 +38,9 @@ export class DeleteLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/DeleteSiteCommand.ts b/clients/client-networkmanager/commands/DeleteSiteCommand.ts index de381680d6115..97f94c5521f3d 100644 --- a/clients/client-networkmanager/commands/DeleteSiteCommand.ts +++ b/clients/client-networkmanager/commands/DeleteSiteCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSiteCommandInput = DeleteSiteRequest; export type DeleteSiteCommandOutput = DeleteSiteResponse & __MetadataBearer; +/** + *

Deletes an existing site. The site cannot be associated with any device or link.

+ */ export class DeleteSiteCommand extends $Command< DeleteSiteCommandInput, DeleteSiteCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSiteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/DeregisterTransitGatewayCommand.ts b/clients/client-networkmanager/commands/DeregisterTransitGatewayCommand.ts index 65613876239ee..ee7074e100790 100644 --- a/clients/client-networkmanager/commands/DeregisterTransitGatewayCommand.ts +++ b/clients/client-networkmanager/commands/DeregisterTransitGatewayCommand.ts @@ -20,6 +20,10 @@ import { export type DeregisterTransitGatewayCommandInput = DeregisterTransitGatewayRequest; export type DeregisterTransitGatewayCommandOutput = DeregisterTransitGatewayResponse & __MetadataBearer; +/** + *

Deregisters a transit gateway from your global network. This action does not delete + * your transit gateway, or modify any of its attachments. This action removes any customer gateway associations.

+ */ export class DeregisterTransitGatewayCommand extends $Command< DeregisterTransitGatewayCommandInput, DeregisterTransitGatewayCommandOutput, @@ -34,6 +38,9 @@ export class DeregisterTransitGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/DescribeGlobalNetworksCommand.ts b/clients/client-networkmanager/commands/DescribeGlobalNetworksCommand.ts index 0582dd6636d12..471ec1c6749b4 100644 --- a/clients/client-networkmanager/commands/DescribeGlobalNetworksCommand.ts +++ b/clients/client-networkmanager/commands/DescribeGlobalNetworksCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeGlobalNetworksCommandInput = DescribeGlobalNetworksRequest; export type DescribeGlobalNetworksCommandOutput = DescribeGlobalNetworksResponse & __MetadataBearer; +/** + *

Describes one or more global networks. By default, all global networks are + * described. To describe the objects in your global network, you must use the appropriate + * Get* action. For example, to list the transit gateways in your global + * network, use GetTransitGatewayRegistrations.

+ */ export class DescribeGlobalNetworksCommand extends $Command< DescribeGlobalNetworksCommandInput, DescribeGlobalNetworksCommandOutput, @@ -34,6 +40,9 @@ export class DescribeGlobalNetworksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/DisassociateCustomerGatewayCommand.ts b/clients/client-networkmanager/commands/DisassociateCustomerGatewayCommand.ts index 0e54bda9fbf9e..7878af69bfff4 100644 --- a/clients/client-networkmanager/commands/DisassociateCustomerGatewayCommand.ts +++ b/clients/client-networkmanager/commands/DisassociateCustomerGatewayCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateCustomerGatewayCommandInput = DisassociateCustomerGatewayRequest; export type DisassociateCustomerGatewayCommandOutput = DisassociateCustomerGatewayResponse & __MetadataBearer; +/** + *

Disassociates a customer gateway from a device and a link.

+ */ export class DisassociateCustomerGatewayCommand extends $Command< DisassociateCustomerGatewayCommandInput, DisassociateCustomerGatewayCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateCustomerGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/DisassociateLinkCommand.ts b/clients/client-networkmanager/commands/DisassociateLinkCommand.ts index 946795a37083b..0c7832112b53f 100644 --- a/clients/client-networkmanager/commands/DisassociateLinkCommand.ts +++ b/clients/client-networkmanager/commands/DisassociateLinkCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateLinkCommandInput = DisassociateLinkRequest; export type DisassociateLinkCommandOutput = DisassociateLinkResponse & __MetadataBearer; +/** + *

Disassociates an existing device from a link. You must first disassociate any customer + * gateways that are associated with the link.

+ */ export class DisassociateLinkCommand extends $Command< DisassociateLinkCommandInput, DisassociateLinkCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/GetCustomerGatewayAssociationsCommand.ts b/clients/client-networkmanager/commands/GetCustomerGatewayAssociationsCommand.ts index 59da33f6ec7c9..3e969bf258216 100644 --- a/clients/client-networkmanager/commands/GetCustomerGatewayAssociationsCommand.ts +++ b/clients/client-networkmanager/commands/GetCustomerGatewayAssociationsCommand.ts @@ -20,6 +20,10 @@ import { export type GetCustomerGatewayAssociationsCommandInput = GetCustomerGatewayAssociationsRequest; export type GetCustomerGatewayAssociationsCommandOutput = GetCustomerGatewayAssociationsResponse & __MetadataBearer; +/** + *

Gets the association information for customer gateways that are associated with + * devices and links in your global network.

+ */ export class GetCustomerGatewayAssociationsCommand extends $Command< GetCustomerGatewayAssociationsCommandInput, GetCustomerGatewayAssociationsCommandOutput, @@ -34,6 +38,9 @@ export class GetCustomerGatewayAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/GetDevicesCommand.ts b/clients/client-networkmanager/commands/GetDevicesCommand.ts index f12037812a637..ab167fd85015e 100644 --- a/clients/client-networkmanager/commands/GetDevicesCommand.ts +++ b/clients/client-networkmanager/commands/GetDevicesCommand.ts @@ -20,6 +20,9 @@ import { export type GetDevicesCommandInput = GetDevicesRequest; export type GetDevicesCommandOutput = GetDevicesResponse & __MetadataBearer; +/** + *

Gets information about one or more of your devices in a global network.

+ */ export class GetDevicesCommand extends $Command< GetDevicesCommandInput, GetDevicesCommandOutput, @@ -34,6 +37,9 @@ export class GetDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/GetLinkAssociationsCommand.ts b/clients/client-networkmanager/commands/GetLinkAssociationsCommand.ts index 9362bf2fa1670..55f90eb189f20 100644 --- a/clients/client-networkmanager/commands/GetLinkAssociationsCommand.ts +++ b/clients/client-networkmanager/commands/GetLinkAssociationsCommand.ts @@ -20,6 +20,10 @@ import { export type GetLinkAssociationsCommandInput = GetLinkAssociationsRequest; export type GetLinkAssociationsCommandOutput = GetLinkAssociationsResponse & __MetadataBearer; +/** + *

Gets the link associations for a device or a link. Either the device ID or the link ID + * must be specified.

+ */ export class GetLinkAssociationsCommand extends $Command< GetLinkAssociationsCommandInput, GetLinkAssociationsCommandOutput, @@ -34,6 +38,9 @@ export class GetLinkAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/GetLinksCommand.ts b/clients/client-networkmanager/commands/GetLinksCommand.ts index 3fe213593f595..e9cf3f40fc84e 100644 --- a/clients/client-networkmanager/commands/GetLinksCommand.ts +++ b/clients/client-networkmanager/commands/GetLinksCommand.ts @@ -20,6 +20,10 @@ import { export type GetLinksCommandInput = GetLinksRequest; export type GetLinksCommandOutput = GetLinksResponse & __MetadataBearer; +/** + *

Gets information about one or more links in a specified global network.

+ *

If you specify the site ID, you cannot specify the type or provider in the same request. You can specify the type and provider in the same request.

+ */ export class GetLinksCommand extends $Command< GetLinksCommandInput, GetLinksCommandOutput, @@ -34,6 +38,9 @@ export class GetLinksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/GetSitesCommand.ts b/clients/client-networkmanager/commands/GetSitesCommand.ts index 15630d6e2fcf6..8be5aa27366cb 100644 --- a/clients/client-networkmanager/commands/GetSitesCommand.ts +++ b/clients/client-networkmanager/commands/GetSitesCommand.ts @@ -20,6 +20,9 @@ import { export type GetSitesCommandInput = GetSitesRequest; export type GetSitesCommandOutput = GetSitesResponse & __MetadataBearer; +/** + *

Gets information about one or more of your sites in a global network.

+ */ export class GetSitesCommand extends $Command< GetSitesCommandInput, GetSitesCommandOutput, @@ -34,6 +37,9 @@ export class GetSitesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/GetTransitGatewayRegistrationsCommand.ts b/clients/client-networkmanager/commands/GetTransitGatewayRegistrationsCommand.ts index f4ab0daa1e09b..52a1828307c07 100644 --- a/clients/client-networkmanager/commands/GetTransitGatewayRegistrationsCommand.ts +++ b/clients/client-networkmanager/commands/GetTransitGatewayRegistrationsCommand.ts @@ -20,6 +20,10 @@ import { export type GetTransitGatewayRegistrationsCommandInput = GetTransitGatewayRegistrationsRequest; export type GetTransitGatewayRegistrationsCommandOutput = GetTransitGatewayRegistrationsResponse & __MetadataBearer; +/** + *

Gets information about the transit gateway registrations in a specified + * global network.

+ */ export class GetTransitGatewayRegistrationsCommand extends $Command< GetTransitGatewayRegistrationsCommandInput, GetTransitGatewayRegistrationsCommandOutput, @@ -34,6 +38,9 @@ export class GetTransitGatewayRegistrationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/ListTagsForResourceCommand.ts b/clients/client-networkmanager/commands/ListTagsForResourceCommand.ts index bdf9491d9f25e..6acdd98aee357 100644 --- a/clients/client-networkmanager/commands/ListTagsForResourceCommand.ts +++ b/clients/client-networkmanager/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags for a specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/RegisterTransitGatewayCommand.ts b/clients/client-networkmanager/commands/RegisterTransitGatewayCommand.ts index a26ecef71e6cb..578d81ffe98f4 100644 --- a/clients/client-networkmanager/commands/RegisterTransitGatewayCommand.ts +++ b/clients/client-networkmanager/commands/RegisterTransitGatewayCommand.ts @@ -20,6 +20,11 @@ import { export type RegisterTransitGatewayCommandInput = RegisterTransitGatewayRequest; export type RegisterTransitGatewayCommandOutput = RegisterTransitGatewayResponse & __MetadataBearer; +/** + *

Registers a transit gateway in your global network. The transit gateway can be in any + * AWS Region, but it must be owned by the same AWS account that owns the global network. + * You cannot register a transit gateway in more than one global network.

+ */ export class RegisterTransitGatewayCommand extends $Command< RegisterTransitGatewayCommandInput, RegisterTransitGatewayCommandOutput, @@ -34,6 +39,9 @@ export class RegisterTransitGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/TagResourceCommand.ts b/clients/client-networkmanager/commands/TagResourceCommand.ts index be76dcaddefd9..af5b9d743cea6 100644 --- a/clients/client-networkmanager/commands/TagResourceCommand.ts +++ b/clients/client-networkmanager/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Tags a specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/UntagResourceCommand.ts b/clients/client-networkmanager/commands/UntagResourceCommand.ts index b27959e7e5a50..1650855848bdc 100644 --- a/clients/client-networkmanager/commands/UntagResourceCommand.ts +++ b/clients/client-networkmanager/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes tags from a specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/UpdateDeviceCommand.ts b/clients/client-networkmanager/commands/UpdateDeviceCommand.ts index 72476fdd2e6d2..2eb420bb243eb 100644 --- a/clients/client-networkmanager/commands/UpdateDeviceCommand.ts +++ b/clients/client-networkmanager/commands/UpdateDeviceCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDeviceCommandInput = UpdateDeviceRequest; export type UpdateDeviceCommandOutput = UpdateDeviceResponse & __MetadataBearer; +/** + *

Updates the details for an existing device. To remove information for any of the + * parameters, specify an empty string.

+ */ export class UpdateDeviceCommand extends $Command< UpdateDeviceCommandInput, UpdateDeviceCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/UpdateGlobalNetworkCommand.ts b/clients/client-networkmanager/commands/UpdateGlobalNetworkCommand.ts index e0fb7a5219af8..ae86cc0d9e940 100644 --- a/clients/client-networkmanager/commands/UpdateGlobalNetworkCommand.ts +++ b/clients/client-networkmanager/commands/UpdateGlobalNetworkCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateGlobalNetworkCommandInput = UpdateGlobalNetworkRequest; export type UpdateGlobalNetworkCommandOutput = UpdateGlobalNetworkResponse & __MetadataBearer; +/** + *

Updates an existing global network. To remove information for any of the parameters, + * specify an empty string.

+ */ export class UpdateGlobalNetworkCommand extends $Command< UpdateGlobalNetworkCommandInput, UpdateGlobalNetworkCommandOutput, @@ -34,6 +38,9 @@ export class UpdateGlobalNetworkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/UpdateLinkCommand.ts b/clients/client-networkmanager/commands/UpdateLinkCommand.ts index 7aadd6097c518..6bfa96fe303c3 100644 --- a/clients/client-networkmanager/commands/UpdateLinkCommand.ts +++ b/clients/client-networkmanager/commands/UpdateLinkCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateLinkCommandInput = UpdateLinkRequest; export type UpdateLinkCommandOutput = UpdateLinkResponse & __MetadataBearer; +/** + *

Updates the details for an existing link. To remove information for any of the + * parameters, specify an empty string.

+ */ export class UpdateLinkCommand extends $Command< UpdateLinkCommandInput, UpdateLinkCommandOutput, @@ -34,6 +38,9 @@ export class UpdateLinkCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/commands/UpdateSiteCommand.ts b/clients/client-networkmanager/commands/UpdateSiteCommand.ts index 545deb50b39bf..e9bdad8e049ff 100644 --- a/clients/client-networkmanager/commands/UpdateSiteCommand.ts +++ b/clients/client-networkmanager/commands/UpdateSiteCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateSiteCommandInput = UpdateSiteRequest; export type UpdateSiteCommandOutput = UpdateSiteResponse & __MetadataBearer; +/** + *

Updates the information for an existing site. To remove information for any of the + * parameters, specify an empty string.

+ */ export class UpdateSiteCommand extends $Command< UpdateSiteCommandInput, UpdateSiteCommandOutput, @@ -34,6 +38,9 @@ export class UpdateSiteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: NetworkManagerClientResolvedConfig, diff --git a/clients/client-networkmanager/package.json b/clients/client-networkmanager/package.json index 090908d8d9d25..61c96fda98bb4 100644 --- a/clients/client-networkmanager/package.json +++ b/clients/client-networkmanager/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Networkmanager Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-networkmanager/pagination/DescribeGlobalNetworksPaginator.ts b/clients/client-networkmanager/pagination/DescribeGlobalNetworksPaginator.ts index df5bd2d64b99d..34767197ff16a 100644 --- a/clients/client-networkmanager/pagination/DescribeGlobalNetworksPaginator.ts +++ b/clients/client-networkmanager/pagination/DescribeGlobalNetworksPaginator.ts @@ -8,6 +8,9 @@ import { import { NetworkManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkManagerClient, input: DescribeGlobalNetworksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeGlobalNetworksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkManager, input: DescribeGlobalNetworksCommandInput, diff --git a/clients/client-networkmanager/pagination/GetCustomerGatewayAssociationsPaginator.ts b/clients/client-networkmanager/pagination/GetCustomerGatewayAssociationsPaginator.ts index b9c230722cbb5..0bb1322944fae 100644 --- a/clients/client-networkmanager/pagination/GetCustomerGatewayAssociationsPaginator.ts +++ b/clients/client-networkmanager/pagination/GetCustomerGatewayAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { NetworkManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkManagerClient, input: GetCustomerGatewayAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCustomerGatewayAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkManager, input: GetCustomerGatewayAssociationsCommandInput, diff --git a/clients/client-networkmanager/pagination/GetDevicesPaginator.ts b/clients/client-networkmanager/pagination/GetDevicesPaginator.ts index e53b2e56c415f..7bda52c627398 100644 --- a/clients/client-networkmanager/pagination/GetDevicesPaginator.ts +++ b/clients/client-networkmanager/pagination/GetDevicesPaginator.ts @@ -4,6 +4,9 @@ import { GetDevicesCommand, GetDevicesCommandInput, GetDevicesCommandOutput } fr import { NetworkManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkManagerClient, input: GetDevicesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkManager, input: GetDevicesCommandInput, diff --git a/clients/client-networkmanager/pagination/GetLinkAssociationsPaginator.ts b/clients/client-networkmanager/pagination/GetLinkAssociationsPaginator.ts index 4ac2b39b1ced8..ac222fa34bcda 100644 --- a/clients/client-networkmanager/pagination/GetLinkAssociationsPaginator.ts +++ b/clients/client-networkmanager/pagination/GetLinkAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { NetworkManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkManagerClient, input: GetLinkAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetLinkAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkManager, input: GetLinkAssociationsCommandInput, diff --git a/clients/client-networkmanager/pagination/GetLinksPaginator.ts b/clients/client-networkmanager/pagination/GetLinksPaginator.ts index 5d7e4ed3a7ecb..c1f461efbb9e5 100644 --- a/clients/client-networkmanager/pagination/GetLinksPaginator.ts +++ b/clients/client-networkmanager/pagination/GetLinksPaginator.ts @@ -4,6 +4,9 @@ import { GetLinksCommand, GetLinksCommandInput, GetLinksCommandOutput } from ".. import { NetworkManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkManagerClient, input: GetLinksCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetLinksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkManager, input: GetLinksCommandInput, diff --git a/clients/client-networkmanager/pagination/GetSitesPaginator.ts b/clients/client-networkmanager/pagination/GetSitesPaginator.ts index 9cab92055753d..a277a1ba9f716 100644 --- a/clients/client-networkmanager/pagination/GetSitesPaginator.ts +++ b/clients/client-networkmanager/pagination/GetSitesPaginator.ts @@ -4,6 +4,9 @@ import { GetSitesCommand, GetSitesCommandInput, GetSitesCommandOutput } from ".. import { NetworkManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkManagerClient, input: GetSitesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSitesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkManager, input: GetSitesCommandInput, diff --git a/clients/client-networkmanager/pagination/GetTransitGatewayRegistrationsPaginator.ts b/clients/client-networkmanager/pagination/GetTransitGatewayRegistrationsPaginator.ts index 63e741c6b7b15..4ab525309e361 100644 --- a/clients/client-networkmanager/pagination/GetTransitGatewayRegistrationsPaginator.ts +++ b/clients/client-networkmanager/pagination/GetTransitGatewayRegistrationsPaginator.ts @@ -8,6 +8,9 @@ import { import { NetworkManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: NetworkManagerClient, input: GetTransitGatewayRegistrationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTransitGatewayRegistrationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: NetworkManager, input: GetTransitGatewayRegistrationsCommandInput, diff --git a/clients/client-networkmanager/runtimeConfig.browser.ts b/clients/client-networkmanager/runtimeConfig.browser.ts index c9cf0e89c085d..7c40edd99f5ea 100644 --- a/clients/client-networkmanager/runtimeConfig.browser.ts +++ b/clients/client-networkmanager/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./NetworkManagerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-networkmanager/runtimeConfig.native.ts b/clients/client-networkmanager/runtimeConfig.native.ts index 0654ce94f8d5b..2dad3f50694e3 100644 --- a/clients/client-networkmanager/runtimeConfig.native.ts +++ b/clients/client-networkmanager/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./NetworkManagerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-networkmanager/runtimeConfig.shared.ts b/clients/client-networkmanager/runtimeConfig.shared.ts index 9281cc0752e5c..0e4590b57a35f 100644 --- a/clients/client-networkmanager/runtimeConfig.shared.ts +++ b/clients/client-networkmanager/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-07-05", disableHostPrefix: false, diff --git a/clients/client-networkmanager/runtimeConfig.ts b/clients/client-networkmanager/runtimeConfig.ts index 05f89252cafc5..e0b69d70634fd 100644 --- a/clients/client-networkmanager/runtimeConfig.ts +++ b/clients/client-networkmanager/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./NetworkManagerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-networkmanager/tsconfig.json b/clients/client-networkmanager/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-networkmanager/tsconfig.json +++ b/clients/client-networkmanager/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-opsworks/commands/AssignInstanceCommand.ts b/clients/client-opsworks/commands/AssignInstanceCommand.ts index 6b10b7be75368..d9888ba23c790 100644 --- a/clients/client-opsworks/commands/AssignInstanceCommand.ts +++ b/clients/client-opsworks/commands/AssignInstanceCommand.ts @@ -20,6 +20,26 @@ import { export type AssignInstanceCommandInput = AssignInstanceRequest; export type AssignInstanceCommandOutput = __MetadataBearer; +/** + *

Assign a registered instance to a layer.

+ *
    + *
  • + *

    You can assign registered on-premises instances to any layer type.

    + *
  • + *
  • + *

    You can assign registered Amazon EC2 instances only to custom layers.

    + *
  • + *
  • + *

    You cannot use this action with instances that were created with AWS OpsWorks Stacks.

    + *
  • + *
+ *

+ * Required Permissions: To use this action, an AWS Identity and Access Management + * (IAM) user must have a Manage permissions + * level for the stack or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class AssignInstanceCommand extends $Command< AssignInstanceCommandInput, AssignInstanceCommandOutput, @@ -34,6 +54,9 @@ export class AssignInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/AssignVolumeCommand.ts b/clients/client-opsworks/commands/AssignVolumeCommand.ts index a45b255f267c1..ce7aa1cbd57d2 100644 --- a/clients/client-opsworks/commands/AssignVolumeCommand.ts +++ b/clients/client-opsworks/commands/AssignVolumeCommand.ts @@ -20,6 +20,17 @@ import { export type AssignVolumeCommandInput = AssignVolumeRequest; export type AssignVolumeCommandOutput = __MetadataBearer; +/** + *

Assigns one of the stack's registered Amazon EBS volumes to a specified instance. The volume must + * first be registered with the stack by calling RegisterVolume. After you register the + * volume, you must call UpdateVolume to specify a mount point before calling + * AssignVolume. For more information, see Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class AssignVolumeCommand extends $Command< AssignVolumeCommandInput, AssignVolumeCommandOutput, @@ -34,6 +45,9 @@ export class AssignVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/AssociateElasticIpCommand.ts b/clients/client-opsworks/commands/AssociateElasticIpCommand.ts index 481986c885daf..602baea1ab1c5 100644 --- a/clients/client-opsworks/commands/AssociateElasticIpCommand.ts +++ b/clients/client-opsworks/commands/AssociateElasticIpCommand.ts @@ -20,6 +20,17 @@ import { export type AssociateElasticIpCommandInput = AssociateElasticIpRequest; export type AssociateElasticIpCommandOutput = __MetadataBearer; +/** + *

Associates one of the stack's registered Elastic IP addresses with a specified instance. The + * address must first be registered with the stack by calling RegisterElasticIp. For more + * information, see Resource + * Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class AssociateElasticIpCommand extends $Command< AssociateElasticIpCommandInput, AssociateElasticIpCommandOutput, @@ -34,6 +45,9 @@ export class AssociateElasticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/AttachElasticLoadBalancerCommand.ts b/clients/client-opsworks/commands/AttachElasticLoadBalancerCommand.ts index fe5d207cec4b8..4076aa37b43f7 100644 --- a/clients/client-opsworks/commands/AttachElasticLoadBalancerCommand.ts +++ b/clients/client-opsworks/commands/AttachElasticLoadBalancerCommand.ts @@ -20,6 +20,22 @@ import { export type AttachElasticLoadBalancerCommandInput = AttachElasticLoadBalancerRequest; export type AttachElasticLoadBalancerCommandOutput = __MetadataBearer; +/** + *

Attaches an Elastic Load Balancing load balancer to a specified layer. AWS OpsWorks Stacks does not support + * Application Load Balancer. You can only use Classic Load Balancer with AWS OpsWorks Stacks. + * For more information, see Elastic Load + * Balancing.

+ * + *

You must create the Elastic Load Balancing instance separately, by using the Elastic Load Balancing console, API, or CLI. For + * more information, see Elastic + * Load Balancing Developer Guide.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class AttachElasticLoadBalancerCommand extends $Command< AttachElasticLoadBalancerCommandInput, AttachElasticLoadBalancerCommandOutput, @@ -34,6 +50,9 @@ export class AttachElasticLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/CloneStackCommand.ts b/clients/client-opsworks/commands/CloneStackCommand.ts index 686d95ecc1ae3..3354f3237247a 100644 --- a/clients/client-opsworks/commands/CloneStackCommand.ts +++ b/clients/client-opsworks/commands/CloneStackCommand.ts @@ -20,6 +20,14 @@ import { export type CloneStackCommandInput = CloneStackRequest; export type CloneStackCommandOutput = CloneStackResult & __MetadataBearer; +/** + *

Creates a clone of a specified stack. For more information, see Clone a + * Stack. By default, all parameters are set to the values used by the parent stack.

+ *

+ * Required Permissions: To use this action, an IAM user must have an attached policy + * that explicitly grants permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class CloneStackCommand extends $Command< CloneStackCommandInput, CloneStackCommandOutput, @@ -34,6 +42,9 @@ export class CloneStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/CreateAppCommand.ts b/clients/client-opsworks/commands/CreateAppCommand.ts index 4e9e5a2664813..e8d0e87ca8a0a 100644 --- a/clients/client-opsworks/commands/CreateAppCommand.ts +++ b/clients/client-opsworks/commands/CreateAppCommand.ts @@ -17,6 +17,15 @@ import { export type CreateAppCommandInput = CreateAppRequest; export type CreateAppCommandOutput = CreateAppResult & __MetadataBearer; +/** + *

Creates an app for a specified stack. For more information, see Creating + * Apps.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class CreateAppCommand extends $Command< CreateAppCommandInput, CreateAppCommandOutput, @@ -31,6 +40,9 @@ export class CreateAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/CreateDeploymentCommand.ts b/clients/client-opsworks/commands/CreateDeploymentCommand.ts index be76af14202e0..f2677466080a0 100644 --- a/clients/client-opsworks/commands/CreateDeploymentCommand.ts +++ b/clients/client-opsworks/commands/CreateDeploymentCommand.ts @@ -20,6 +20,15 @@ import { export type CreateDeploymentCommandInput = CreateDeploymentRequest; export type CreateDeploymentCommandOutput = CreateDeploymentResult & __MetadataBearer; +/** + *

Runs deployment or stack commands. For more information, see Deploying + * Apps and Run Stack Commands.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Deploy or Manage + * permissions level for the stack, or an attached policy that explicitly grants permissions. For + * more information on user permissions, see Managing User + * Permissions.

+ */ export class CreateDeploymentCommand extends $Command< CreateDeploymentCommandInput, CreateDeploymentCommandOutput, @@ -34,6 +43,9 @@ export class CreateDeploymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/CreateInstanceCommand.ts b/clients/client-opsworks/commands/CreateInstanceCommand.ts index f4b21c94f9c7a..455f43b5d170b 100644 --- a/clients/client-opsworks/commands/CreateInstanceCommand.ts +++ b/clients/client-opsworks/commands/CreateInstanceCommand.ts @@ -20,6 +20,15 @@ import { export type CreateInstanceCommandInput = CreateInstanceRequest; export type CreateInstanceCommandOutput = CreateInstanceResult & __MetadataBearer; +/** + *

Creates an instance in a specified stack. For more information, see Adding an + * Instance to a Layer.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class CreateInstanceCommand extends $Command< CreateInstanceCommandInput, CreateInstanceCommandOutput, @@ -34,6 +43,9 @@ export class CreateInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/CreateLayerCommand.ts b/clients/client-opsworks/commands/CreateLayerCommand.ts index cb35986305a44..fb71ca10008a4 100644 --- a/clients/client-opsworks/commands/CreateLayerCommand.ts +++ b/clients/client-opsworks/commands/CreateLayerCommand.ts @@ -20,6 +20,22 @@ import { export type CreateLayerCommandInput = CreateLayerRequest; export type CreateLayerCommandOutput = CreateLayerResult & __MetadataBearer; +/** + *

Creates a layer. For more information, see How to + * Create a Layer.

+ * + *

You should use CreateLayer for noncustom layer types such as PHP App Server only if the stack + * does not have an existing layer of that type. A stack can have at most one instance of each + * noncustom layer; if you attempt to create a second instance, CreateLayer fails. A + * stack can have an arbitrary number of custom layers, so you can call CreateLayer as + * many times as you like for that layer type.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class CreateLayerCommand extends $Command< CreateLayerCommandInput, CreateLayerCommandOutput, @@ -34,6 +50,9 @@ export class CreateLayerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/CreateStackCommand.ts b/clients/client-opsworks/commands/CreateStackCommand.ts index e1fc332db4395..6586cdc59ffab 100644 --- a/clients/client-opsworks/commands/CreateStackCommand.ts +++ b/clients/client-opsworks/commands/CreateStackCommand.ts @@ -20,6 +20,14 @@ import { export type CreateStackCommandInput = CreateStackRequest; export type CreateStackCommandOutput = CreateStackResult & __MetadataBearer; +/** + *

Creates a new stack. For more information, see Create a New + * Stack.

+ *

+ * Required Permissions: To use this action, an IAM user must have an attached policy + * that explicitly grants permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class CreateStackCommand extends $Command< CreateStackCommandInput, CreateStackCommandOutput, @@ -34,6 +42,9 @@ export class CreateStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/CreateUserProfileCommand.ts b/clients/client-opsworks/commands/CreateUserProfileCommand.ts index 675a0f2675a27..371f2cb2eb498 100644 --- a/clients/client-opsworks/commands/CreateUserProfileCommand.ts +++ b/clients/client-opsworks/commands/CreateUserProfileCommand.ts @@ -20,6 +20,13 @@ import { export type CreateUserProfileCommandInput = CreateUserProfileRequest; export type CreateUserProfileCommandOutput = CreateUserProfileResult & __MetadataBearer; +/** + *

Creates a new user profile.

+ *

+ * Required Permissions: To use this action, an IAM user must have an attached policy + * that explicitly grants permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class CreateUserProfileCommand extends $Command< CreateUserProfileCommandInput, CreateUserProfileCommandOutput, @@ -34,6 +41,9 @@ export class CreateUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeleteAppCommand.ts b/clients/client-opsworks/commands/DeleteAppCommand.ts index f0fec29f6aad1..2c4d7ed1df4b6 100644 --- a/clients/client-opsworks/commands/DeleteAppCommand.ts +++ b/clients/client-opsworks/commands/DeleteAppCommand.ts @@ -17,6 +17,14 @@ import { export type DeleteAppCommandInput = DeleteAppRequest; export type DeleteAppCommandOutput = __MetadataBearer; +/** + *

Deletes a specified app.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DeleteAppCommand extends $Command< DeleteAppCommandInput, DeleteAppCommandOutput, @@ -31,6 +39,9 @@ export class DeleteAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeleteInstanceCommand.ts b/clients/client-opsworks/commands/DeleteInstanceCommand.ts index ea975e42cf0ba..e65832beccd51 100644 --- a/clients/client-opsworks/commands/DeleteInstanceCommand.ts +++ b/clients/client-opsworks/commands/DeleteInstanceCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteInstanceCommandInput = DeleteInstanceRequest; export type DeleteInstanceCommandOutput = __MetadataBearer; +/** + *

Deletes a specified instance, which terminates the associated Amazon EC2 instance. You must stop an instance before you can delete it.

+ *

For more information, see Deleting + * Instances.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DeleteInstanceCommand extends $Command< DeleteInstanceCommandInput, DeleteInstanceCommandOutput, @@ -34,6 +44,9 @@ export class DeleteInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeleteLayerCommand.ts b/clients/client-opsworks/commands/DeleteLayerCommand.ts index 02d90bff4ce40..151dace688fb8 100644 --- a/clients/client-opsworks/commands/DeleteLayerCommand.ts +++ b/clients/client-opsworks/commands/DeleteLayerCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteLayerCommandInput = DeleteLayerRequest; export type DeleteLayerCommandOutput = __MetadataBearer; +/** + *

Deletes a specified layer. You must first stop and then delete all associated instances or + * unassign registered instances. For more information, see How to + * Delete a Layer.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DeleteLayerCommand extends $Command< DeleteLayerCommandInput, DeleteLayerCommandOutput, @@ -34,6 +44,9 @@ export class DeleteLayerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeleteStackCommand.ts b/clients/client-opsworks/commands/DeleteStackCommand.ts index 2cb29b00ff7ac..41bc73058742c 100644 --- a/clients/client-opsworks/commands/DeleteStackCommand.ts +++ b/clients/client-opsworks/commands/DeleteStackCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteStackCommandInput = DeleteStackRequest; export type DeleteStackCommandOutput = __MetadataBearer; +/** + *

Deletes a specified stack. You must first delete all instances, layers, and apps or + * deregister registered instances. For more information, see Shut Down a + * Stack.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DeleteStackCommand extends $Command< DeleteStackCommandInput, DeleteStackCommandOutput, @@ -34,6 +44,9 @@ export class DeleteStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeleteUserProfileCommand.ts b/clients/client-opsworks/commands/DeleteUserProfileCommand.ts index 42d70e3a33433..3c1f53e9cf938 100644 --- a/clients/client-opsworks/commands/DeleteUserProfileCommand.ts +++ b/clients/client-opsworks/commands/DeleteUserProfileCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteUserProfileCommandInput = DeleteUserProfileRequest; export type DeleteUserProfileCommandOutput = __MetadataBearer; +/** + *

Deletes a user profile.

+ *

+ * Required Permissions: To use this action, an IAM user must have an attached policy + * that explicitly grants permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DeleteUserProfileCommand extends $Command< DeleteUserProfileCommandInput, DeleteUserProfileCommandOutput, @@ -34,6 +41,9 @@ export class DeleteUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeregisterEcsClusterCommand.ts b/clients/client-opsworks/commands/DeregisterEcsClusterCommand.ts index cd323a29d762d..01020394bc688 100644 --- a/clients/client-opsworks/commands/DeregisterEcsClusterCommand.ts +++ b/clients/client-opsworks/commands/DeregisterEcsClusterCommand.ts @@ -20,6 +20,17 @@ import { export type DeregisterEcsClusterCommandInput = DeregisterEcsClusterRequest; export type DeregisterEcsClusterCommandOutput = __MetadataBearer; +/** + *

Deregisters a specified Amazon ECS cluster from a stack. + * For more information, see + * + * Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack or an attached policy that explicitly grants permissions. For more + * information on user permissions, see + * https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html.

+ */ export class DeregisterEcsClusterCommand extends $Command< DeregisterEcsClusterCommandInput, DeregisterEcsClusterCommandOutput, @@ -34,6 +45,9 @@ export class DeregisterEcsClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeregisterElasticIpCommand.ts b/clients/client-opsworks/commands/DeregisterElasticIpCommand.ts index 7398373233f20..57b34ecc85d74 100644 --- a/clients/client-opsworks/commands/DeregisterElasticIpCommand.ts +++ b/clients/client-opsworks/commands/DeregisterElasticIpCommand.ts @@ -20,6 +20,15 @@ import { export type DeregisterElasticIpCommandInput = DeregisterElasticIpRequest; export type DeregisterElasticIpCommandOutput = __MetadataBearer; +/** + *

Deregisters a specified Elastic IP address. The address can then be registered by another + * stack. For more information, see Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DeregisterElasticIpCommand extends $Command< DeregisterElasticIpCommandInput, DeregisterElasticIpCommandOutput, @@ -34,6 +43,9 @@ export class DeregisterElasticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeregisterInstanceCommand.ts b/clients/client-opsworks/commands/DeregisterInstanceCommand.ts index 37d9988410ff3..fe18ccebdbc3f 100644 --- a/clients/client-opsworks/commands/DeregisterInstanceCommand.ts +++ b/clients/client-opsworks/commands/DeregisterInstanceCommand.ts @@ -20,6 +20,16 @@ import { export type DeregisterInstanceCommandInput = DeregisterInstanceRequest; export type DeregisterInstanceCommandOutput = __MetadataBearer; +/** + *

Deregister a registered Amazon EC2 or on-premises instance. This action removes the + * instance from the stack and returns it to your control. This action cannot be used with + * instances that were created with AWS OpsWorks Stacks.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DeregisterInstanceCommand extends $Command< DeregisterInstanceCommandInput, DeregisterInstanceCommandOutput, @@ -34,6 +44,9 @@ export class DeregisterInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeregisterRdsDbInstanceCommand.ts b/clients/client-opsworks/commands/DeregisterRdsDbInstanceCommand.ts index 9b385afd8c746..9acb49a66460c 100644 --- a/clients/client-opsworks/commands/DeregisterRdsDbInstanceCommand.ts +++ b/clients/client-opsworks/commands/DeregisterRdsDbInstanceCommand.ts @@ -20,6 +20,14 @@ import { export type DeregisterRdsDbInstanceCommandInput = DeregisterRdsDbInstanceRequest; export type DeregisterRdsDbInstanceCommandOutput = __MetadataBearer; +/** + *

Deregisters an Amazon RDS instance.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DeregisterRdsDbInstanceCommand extends $Command< DeregisterRdsDbInstanceCommandInput, DeregisterRdsDbInstanceCommandOutput, @@ -34,6 +42,9 @@ export class DeregisterRdsDbInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DeregisterVolumeCommand.ts b/clients/client-opsworks/commands/DeregisterVolumeCommand.ts index bb8ee60e20c4d..654e975f13b05 100644 --- a/clients/client-opsworks/commands/DeregisterVolumeCommand.ts +++ b/clients/client-opsworks/commands/DeregisterVolumeCommand.ts @@ -20,6 +20,16 @@ import { export type DeregisterVolumeCommandInput = DeregisterVolumeRequest; export type DeregisterVolumeCommandOutput = __MetadataBearer; +/** + *

Deregisters an Amazon EBS volume. The volume can then be registered by another stack. For more + * information, see Resource + * Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DeregisterVolumeCommand extends $Command< DeregisterVolumeCommandInput, DeregisterVolumeCommandOutput, @@ -34,6 +44,9 @@ export class DeregisterVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeAgentVersionsCommand.ts b/clients/client-opsworks/commands/DescribeAgentVersionsCommand.ts index 5fbf5fe8dc6f4..53cf82a2c5cb8 100644 --- a/clients/client-opsworks/commands/DescribeAgentVersionsCommand.ts +++ b/clients/client-opsworks/commands/DescribeAgentVersionsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAgentVersionsCommandInput = DescribeAgentVersionsRequest; export type DescribeAgentVersionsCommandOutput = DescribeAgentVersionsResult & __MetadataBearer; +/** + *

Describes the available AWS OpsWorks Stacks agent versions. You must specify a stack ID or a + * configuration manager. DescribeAgentVersions returns a list of available + * agent versions for the specified stack or configuration manager.

+ */ export class DescribeAgentVersionsCommand extends $Command< DescribeAgentVersionsCommandInput, DescribeAgentVersionsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAgentVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeAppsCommand.ts b/clients/client-opsworks/commands/DescribeAppsCommand.ts index aa6dcf278bdbb..c5609ef6432a9 100644 --- a/clients/client-opsworks/commands/DescribeAppsCommand.ts +++ b/clients/client-opsworks/commands/DescribeAppsCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeAppsCommandInput = DescribeAppsRequest; export type DescribeAppsCommandOutput = DescribeAppsResult & __MetadataBearer; +/** + *

Requests a description of a specified set of apps.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeAppsCommand extends $Command< DescribeAppsCommandInput, DescribeAppsCommandOutput, @@ -34,6 +45,9 @@ export class DescribeAppsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeCommandsCommand.ts b/clients/client-opsworks/commands/DescribeCommandsCommand.ts index 15f47303cdf0e..11a4153d67935 100644 --- a/clients/client-opsworks/commands/DescribeCommandsCommand.ts +++ b/clients/client-opsworks/commands/DescribeCommandsCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeCommandsCommandInput = DescribeCommandsRequest; export type DescribeCommandsCommandOutput = DescribeCommandsResult & __MetadataBearer; +/** + *

Describes the results of specified commands.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeCommandsCommand extends $Command< DescribeCommandsCommandInput, DescribeCommandsCommandOutput, @@ -34,6 +45,9 @@ export class DescribeCommandsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeDeploymentsCommand.ts b/clients/client-opsworks/commands/DescribeDeploymentsCommand.ts index 3d89f3fe1883f..555e4fb106f8b 100644 --- a/clients/client-opsworks/commands/DescribeDeploymentsCommand.ts +++ b/clients/client-opsworks/commands/DescribeDeploymentsCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeDeploymentsCommandInput = DescribeDeploymentsRequest; export type DescribeDeploymentsCommandOutput = DescribeDeploymentsResult & __MetadataBearer; +/** + *

Requests a description of a specified set of deployments.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeDeploymentsCommand extends $Command< DescribeDeploymentsCommandInput, DescribeDeploymentsCommandOutput, @@ -34,6 +45,9 @@ export class DescribeDeploymentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeEcsClustersCommand.ts b/clients/client-opsworks/commands/DescribeEcsClustersCommand.ts index 3c4afea572b2d..95a89f5187401 100644 --- a/clients/client-opsworks/commands/DescribeEcsClustersCommand.ts +++ b/clients/client-opsworks/commands/DescribeEcsClustersCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeEcsClustersCommandInput = DescribeEcsClustersRequest; export type DescribeEcsClustersCommandOutput = DescribeEcsClustersResult & __MetadataBearer; +/** + *

Describes Amazon ECS clusters that are registered with a stack. If you specify only a stack ID, + * you can use the MaxResults and NextToken parameters to paginate the + * response. However, AWS OpsWorks Stacks currently supports only one cluster per layer, so the result + * set has a maximum of one element.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack or an attached policy that explicitly grants + * permission. For more information about user permissions, see Managing User + * Permissions.

+ *

This call accepts only one resource-identifying parameter.

+ */ export class DescribeEcsClustersCommand extends $Command< DescribeEcsClustersCommandInput, DescribeEcsClustersCommandOutput, @@ -34,6 +46,9 @@ export class DescribeEcsClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeElasticIpsCommand.ts b/clients/client-opsworks/commands/DescribeElasticIpsCommand.ts index bf016684741c6..8eddc3322d935 100644 --- a/clients/client-opsworks/commands/DescribeElasticIpsCommand.ts +++ b/clients/client-opsworks/commands/DescribeElasticIpsCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeElasticIpsCommandInput = DescribeElasticIpsRequest; export type DescribeElasticIpsCommandOutput = DescribeElasticIpsResult & __MetadataBearer; +/** + *

Describes Elastic IP addresses.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeElasticIpsCommand extends $Command< DescribeElasticIpsCommandInput, DescribeElasticIpsCommandOutput, @@ -34,6 +45,9 @@ export class DescribeElasticIpsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeElasticLoadBalancersCommand.ts b/clients/client-opsworks/commands/DescribeElasticLoadBalancersCommand.ts index c04d3a334a2b4..22f60a5d4ce39 100644 --- a/clients/client-opsworks/commands/DescribeElasticLoadBalancersCommand.ts +++ b/clients/client-opsworks/commands/DescribeElasticLoadBalancersCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeElasticLoadBalancersCommandInput = DescribeElasticLoadBalancersRequest; export type DescribeElasticLoadBalancersCommandOutput = DescribeElasticLoadBalancersResult & __MetadataBearer; +/** + *

Describes a stack's Elastic Load Balancing instances.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeElasticLoadBalancersCommand extends $Command< DescribeElasticLoadBalancersCommandInput, DescribeElasticLoadBalancersCommandOutput, @@ -34,6 +45,9 @@ export class DescribeElasticLoadBalancersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeInstancesCommand.ts b/clients/client-opsworks/commands/DescribeInstancesCommand.ts index a25667792c1dd..c9cebd3b18e45 100644 --- a/clients/client-opsworks/commands/DescribeInstancesCommand.ts +++ b/clients/client-opsworks/commands/DescribeInstancesCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeInstancesCommandInput = DescribeInstancesRequest; export type DescribeInstancesCommandOutput = DescribeInstancesResult & __MetadataBearer; +/** + *

Requests a description of a set of instances.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeInstancesCommand extends $Command< DescribeInstancesCommandInput, DescribeInstancesCommandOutput, @@ -34,6 +45,9 @@ export class DescribeInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeLayersCommand.ts b/clients/client-opsworks/commands/DescribeLayersCommand.ts index 1d7ed24a51b39..2ada9a802f026 100644 --- a/clients/client-opsworks/commands/DescribeLayersCommand.ts +++ b/clients/client-opsworks/commands/DescribeLayersCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeLayersCommandInput = DescribeLayersRequest; export type DescribeLayersCommandOutput = DescribeLayersResult & __MetadataBearer; +/** + *

Requests a description of one or more layers in a specified stack.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeLayersCommand extends $Command< DescribeLayersCommandInput, DescribeLayersCommandOutput, @@ -34,6 +45,9 @@ export class DescribeLayersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeLoadBasedAutoScalingCommand.ts b/clients/client-opsworks/commands/DescribeLoadBasedAutoScalingCommand.ts index c76e19508d8e4..dd64e7fa9b1d3 100644 --- a/clients/client-opsworks/commands/DescribeLoadBasedAutoScalingCommand.ts +++ b/clients/client-opsworks/commands/DescribeLoadBasedAutoScalingCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeLoadBasedAutoScalingCommandInput = DescribeLoadBasedAutoScalingRequest; export type DescribeLoadBasedAutoScalingCommandOutput = DescribeLoadBasedAutoScalingResult & __MetadataBearer; +/** + *

Describes load-based auto scaling configurations for specified layers.

+ * + *

You must specify at least one of the parameters.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeLoadBasedAutoScalingCommand extends $Command< DescribeLoadBasedAutoScalingCommandInput, DescribeLoadBasedAutoScalingCommandOutput, @@ -34,6 +45,9 @@ export class DescribeLoadBasedAutoScalingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeMyUserProfileCommand.ts b/clients/client-opsworks/commands/DescribeMyUserProfileCommand.ts index 10096d7e98aad..540ae2a118e22 100644 --- a/clients/client-opsworks/commands/DescribeMyUserProfileCommand.ts +++ b/clients/client-opsworks/commands/DescribeMyUserProfileCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeMyUserProfileCommandInput = {}; export type DescribeMyUserProfileCommandOutput = DescribeMyUserProfileResult & __MetadataBearer; +/** + *

Describes a user's SSH information.

+ *

+ * Required Permissions: To use this action, an IAM user must have self-management + * enabled or an attached policy that explicitly grants permissions. For more information about user + * permissions, see Managing User + * Permissions.

+ */ export class DescribeMyUserProfileCommand extends $Command< DescribeMyUserProfileCommandInput, DescribeMyUserProfileCommandOutput, @@ -34,6 +42,9 @@ export class DescribeMyUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeOperatingSystemsCommand.ts b/clients/client-opsworks/commands/DescribeOperatingSystemsCommand.ts index 4a2b49dea72b7..abc0f7750af74 100644 --- a/clients/client-opsworks/commands/DescribeOperatingSystemsCommand.ts +++ b/clients/client-opsworks/commands/DescribeOperatingSystemsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOperatingSystemsCommandInput = {}; export type DescribeOperatingSystemsCommandOutput = DescribeOperatingSystemsResponse & __MetadataBearer; +/** + *

Describes the operating systems that are supported by AWS OpsWorks Stacks.

+ */ export class DescribeOperatingSystemsCommand extends $Command< DescribeOperatingSystemsCommandInput, DescribeOperatingSystemsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOperatingSystemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribePermissionsCommand.ts b/clients/client-opsworks/commands/DescribePermissionsCommand.ts index 2bca4f2f5896c..0c27b8cb68904 100644 --- a/clients/client-opsworks/commands/DescribePermissionsCommand.ts +++ b/clients/client-opsworks/commands/DescribePermissionsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribePermissionsCommandInput = DescribePermissionsRequest; export type DescribePermissionsCommandOutput = DescribePermissionsResult & __MetadataBearer; +/** + *

Describes the permissions for a specified stack.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DescribePermissionsCommand extends $Command< DescribePermissionsCommandInput, DescribePermissionsCommandOutput, @@ -34,6 +42,9 @@ export class DescribePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeRaidArraysCommand.ts b/clients/client-opsworks/commands/DescribeRaidArraysCommand.ts index aae6482e3b216..cf4b3f86a99a1 100644 --- a/clients/client-opsworks/commands/DescribeRaidArraysCommand.ts +++ b/clients/client-opsworks/commands/DescribeRaidArraysCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeRaidArraysCommandInput = DescribeRaidArraysRequest; export type DescribeRaidArraysCommandOutput = DescribeRaidArraysResult & __MetadataBearer; +/** + *

Describe an instance's RAID arrays.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeRaidArraysCommand extends $Command< DescribeRaidArraysCommandInput, DescribeRaidArraysCommandOutput, @@ -34,6 +45,9 @@ export class DescribeRaidArraysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeRdsDbInstancesCommand.ts b/clients/client-opsworks/commands/DescribeRdsDbInstancesCommand.ts index 6e88841e63a14..08a75b4965990 100644 --- a/clients/client-opsworks/commands/DescribeRdsDbInstancesCommand.ts +++ b/clients/client-opsworks/commands/DescribeRdsDbInstancesCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeRdsDbInstancesCommandInput = DescribeRdsDbInstancesRequest; export type DescribeRdsDbInstancesCommandOutput = DescribeRdsDbInstancesResult & __MetadataBearer; +/** + *

Describes Amazon RDS instances.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ *

This call accepts only one resource-identifying parameter.

+ */ export class DescribeRdsDbInstancesCommand extends $Command< DescribeRdsDbInstancesCommandInput, DescribeRdsDbInstancesCommandOutput, @@ -34,6 +43,9 @@ export class DescribeRdsDbInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeServiceErrorsCommand.ts b/clients/client-opsworks/commands/DescribeServiceErrorsCommand.ts index 93b1ad4dc8841..9e67a1d8871fe 100644 --- a/clients/client-opsworks/commands/DescribeServiceErrorsCommand.ts +++ b/clients/client-opsworks/commands/DescribeServiceErrorsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeServiceErrorsCommandInput = DescribeServiceErrorsRequest; export type DescribeServiceErrorsCommandOutput = DescribeServiceErrorsResult & __MetadataBearer; +/** + *

Describes AWS OpsWorks Stacks service errors.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ *

This call accepts only one resource-identifying parameter.

+ */ export class DescribeServiceErrorsCommand extends $Command< DescribeServiceErrorsCommandInput, DescribeServiceErrorsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeServiceErrorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeStackProvisioningParametersCommand.ts b/clients/client-opsworks/commands/DescribeStackProvisioningParametersCommand.ts index a19e9aa1294b5..0a9a2b94f9067 100644 --- a/clients/client-opsworks/commands/DescribeStackProvisioningParametersCommand.ts +++ b/clients/client-opsworks/commands/DescribeStackProvisioningParametersCommand.ts @@ -24,6 +24,14 @@ export type DescribeStackProvisioningParametersCommandInput = DescribeStackProvi export type DescribeStackProvisioningParametersCommandOutput = DescribeStackProvisioningParametersResult & __MetadataBearer; +/** + *

Requests a description of a stack's provisioning parameters.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeStackProvisioningParametersCommand extends $Command< DescribeStackProvisioningParametersCommandInput, DescribeStackProvisioningParametersCommandOutput, @@ -38,6 +46,9 @@ export class DescribeStackProvisioningParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeStackSummaryCommand.ts b/clients/client-opsworks/commands/DescribeStackSummaryCommand.ts index 313b8888fed9d..90bbdde69d994 100644 --- a/clients/client-opsworks/commands/DescribeStackSummaryCommand.ts +++ b/clients/client-opsworks/commands/DescribeStackSummaryCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeStackSummaryCommandInput = DescribeStackSummaryRequest; export type DescribeStackSummaryCommandOutput = DescribeStackSummaryResult & __MetadataBearer; +/** + *

Describes the number of layers and apps in a specified stack, and the number of instances in + * each state, such as running_setup or online.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeStackSummaryCommand extends $Command< DescribeStackSummaryCommandInput, DescribeStackSummaryCommandOutput, @@ -34,6 +43,9 @@ export class DescribeStackSummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeStacksCommand.ts b/clients/client-opsworks/commands/DescribeStacksCommand.ts index 8571665934de7..c76bd47c0016f 100644 --- a/clients/client-opsworks/commands/DescribeStacksCommand.ts +++ b/clients/client-opsworks/commands/DescribeStacksCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeStacksCommandInput = DescribeStacksRequest; export type DescribeStacksCommandOutput = DescribeStacksResult & __MetadataBearer; +/** + *

Requests a description of one or more stacks.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeStacksCommand extends $Command< DescribeStacksCommandInput, DescribeStacksCommandOutput, @@ -34,6 +42,9 @@ export class DescribeStacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeTimeBasedAutoScalingCommand.ts b/clients/client-opsworks/commands/DescribeTimeBasedAutoScalingCommand.ts index cc6ba9c8954b1..83a40ffc9cb60 100644 --- a/clients/client-opsworks/commands/DescribeTimeBasedAutoScalingCommand.ts +++ b/clients/client-opsworks/commands/DescribeTimeBasedAutoScalingCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeTimeBasedAutoScalingCommandInput = DescribeTimeBasedAutoScalingRequest; export type DescribeTimeBasedAutoScalingCommandOutput = DescribeTimeBasedAutoScalingResult & __MetadataBearer; +/** + *

Describes time-based auto scaling configurations for specified instances.

+ * + *

You must specify at least one of the parameters.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeTimeBasedAutoScalingCommand extends $Command< DescribeTimeBasedAutoScalingCommandInput, DescribeTimeBasedAutoScalingCommandOutput, @@ -34,6 +45,9 @@ export class DescribeTimeBasedAutoScalingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeUserProfilesCommand.ts b/clients/client-opsworks/commands/DescribeUserProfilesCommand.ts index 419b204542aac..166750f3e5ebd 100644 --- a/clients/client-opsworks/commands/DescribeUserProfilesCommand.ts +++ b/clients/client-opsworks/commands/DescribeUserProfilesCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeUserProfilesCommandInput = DescribeUserProfilesRequest; export type DescribeUserProfilesCommandOutput = DescribeUserProfilesResult & __MetadataBearer; +/** + *

Describe specified users.

+ *

+ * Required Permissions: To use this action, an IAM user must have an attached policy + * that explicitly grants permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeUserProfilesCommand extends $Command< DescribeUserProfilesCommandInput, DescribeUserProfilesCommandOutput, @@ -34,6 +41,9 @@ export class DescribeUserProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DescribeVolumesCommand.ts b/clients/client-opsworks/commands/DescribeVolumesCommand.ts index cce6fdb06d297..39472a86c2952 100644 --- a/clients/client-opsworks/commands/DescribeVolumesCommand.ts +++ b/clients/client-opsworks/commands/DescribeVolumesCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeVolumesCommandInput = DescribeVolumesRequest; export type DescribeVolumesCommandOutput = DescribeVolumesResult & __MetadataBearer; +/** + *

Describes an instance's Amazon EBS volumes.

+ * + *

This call accepts only one resource-identifying parameter.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Show, Deploy, or + * Manage permissions level for the stack, or an attached policy that explicitly grants + * permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class DescribeVolumesCommand extends $Command< DescribeVolumesCommandInput, DescribeVolumesCommandOutput, @@ -34,6 +45,9 @@ export class DescribeVolumesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DetachElasticLoadBalancerCommand.ts b/clients/client-opsworks/commands/DetachElasticLoadBalancerCommand.ts index 24266e518fa7d..c8e6ca52dcf9b 100644 --- a/clients/client-opsworks/commands/DetachElasticLoadBalancerCommand.ts +++ b/clients/client-opsworks/commands/DetachElasticLoadBalancerCommand.ts @@ -20,6 +20,14 @@ import { export type DetachElasticLoadBalancerCommandInput = DetachElasticLoadBalancerRequest; export type DetachElasticLoadBalancerCommandOutput = __MetadataBearer; +/** + *

Detaches a specified Elastic Load Balancing instance from its layer.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DetachElasticLoadBalancerCommand extends $Command< DetachElasticLoadBalancerCommandInput, DetachElasticLoadBalancerCommandOutput, @@ -34,6 +42,9 @@ export class DetachElasticLoadBalancerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/DisassociateElasticIpCommand.ts b/clients/client-opsworks/commands/DisassociateElasticIpCommand.ts index 30c900b408ef1..e584c0db8ba50 100644 --- a/clients/client-opsworks/commands/DisassociateElasticIpCommand.ts +++ b/clients/client-opsworks/commands/DisassociateElasticIpCommand.ts @@ -20,6 +20,15 @@ import { export type DisassociateElasticIpCommandInput = DisassociateElasticIpRequest; export type DisassociateElasticIpCommandOutput = __MetadataBearer; +/** + *

Disassociates an Elastic IP address from its instance. The address remains registered with + * the stack. For more information, see Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class DisassociateElasticIpCommand extends $Command< DisassociateElasticIpCommandInput, DisassociateElasticIpCommandOutput, @@ -34,6 +43,9 @@ export class DisassociateElasticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/GetHostnameSuggestionCommand.ts b/clients/client-opsworks/commands/GetHostnameSuggestionCommand.ts index 860533caff4ec..7d8b5a1e0a814 100644 --- a/clients/client-opsworks/commands/GetHostnameSuggestionCommand.ts +++ b/clients/client-opsworks/commands/GetHostnameSuggestionCommand.ts @@ -20,6 +20,14 @@ import { export type GetHostnameSuggestionCommandInput = GetHostnameSuggestionRequest; export type GetHostnameSuggestionCommandOutput = GetHostnameSuggestionResult & __MetadataBearer; +/** + *

Gets a generated host name for the specified layer, based on the current host name theme.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class GetHostnameSuggestionCommand extends $Command< GetHostnameSuggestionCommandInput, GetHostnameSuggestionCommandOutput, @@ -34,6 +42,9 @@ export class GetHostnameSuggestionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/GrantAccessCommand.ts b/clients/client-opsworks/commands/GrantAccessCommand.ts index eb249170dbab6..01378192b43bb 100644 --- a/clients/client-opsworks/commands/GrantAccessCommand.ts +++ b/clients/client-opsworks/commands/GrantAccessCommand.ts @@ -20,6 +20,12 @@ import { export type GrantAccessCommandInput = GrantAccessRequest; export type GrantAccessCommandOutput = GrantAccessResult & __MetadataBearer; +/** + * + *

This action can be used only with Windows stacks.

+ *
+ *

Grants RDP access to a Windows instance for a specified time period.

+ */ export class GrantAccessCommand extends $Command< GrantAccessCommandInput, GrantAccessCommandOutput, @@ -34,6 +40,9 @@ export class GrantAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/ListTagsCommand.ts b/clients/client-opsworks/commands/ListTagsCommand.ts index eabeef393dd86..4f33ae0711350 100644 --- a/clients/client-opsworks/commands/ListTagsCommand.ts +++ b/clients/client-opsworks/commands/ListTagsCommand.ts @@ -17,6 +17,9 @@ import { export type ListTagsCommandInput = ListTagsRequest; export type ListTagsCommandOutput = ListTagsResult & __MetadataBearer; +/** + *

Returns a list of tags that are applied to the specified stack or layer.

+ */ export class ListTagsCommand extends $Command< ListTagsCommandInput, ListTagsCommandOutput, @@ -31,6 +34,9 @@ export class ListTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/RebootInstanceCommand.ts b/clients/client-opsworks/commands/RebootInstanceCommand.ts index f82a247bf55c6..f3d927b6eadda 100644 --- a/clients/client-opsworks/commands/RebootInstanceCommand.ts +++ b/clients/client-opsworks/commands/RebootInstanceCommand.ts @@ -20,6 +20,15 @@ import { export type RebootInstanceCommandInput = RebootInstanceRequest; export type RebootInstanceCommandOutput = __MetadataBearer; +/** + *

Reboots a specified instance. For more information, see Starting, + * Stopping, and Rebooting Instances.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class RebootInstanceCommand extends $Command< RebootInstanceCommandInput, RebootInstanceCommandOutput, @@ -34,6 +43,9 @@ export class RebootInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/RegisterEcsClusterCommand.ts b/clients/client-opsworks/commands/RegisterEcsClusterCommand.ts index e51c4a186d8f7..7bd5be12da329 100644 --- a/clients/client-opsworks/commands/RegisterEcsClusterCommand.ts +++ b/clients/client-opsworks/commands/RegisterEcsClusterCommand.ts @@ -20,6 +20,19 @@ import { export type RegisterEcsClusterCommandInput = RegisterEcsClusterRequest; export type RegisterEcsClusterCommandOutput = RegisterEcsClusterResult & __MetadataBearer; +/** + *

Registers a specified Amazon ECS cluster with a stack. You can register only one + * cluster with a stack. A cluster can be registered with only one stack. + * For more information, see + * + * Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack or an attached policy that explicitly grants permissions. For more + * information on user permissions, see + * + * Managing User Permissions.

+ */ export class RegisterEcsClusterCommand extends $Command< RegisterEcsClusterCommandInput, RegisterEcsClusterCommandOutput, @@ -34,6 +47,9 @@ export class RegisterEcsClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/RegisterElasticIpCommand.ts b/clients/client-opsworks/commands/RegisterElasticIpCommand.ts index f4b858e743641..1020f968c17dc 100644 --- a/clients/client-opsworks/commands/RegisterElasticIpCommand.ts +++ b/clients/client-opsworks/commands/RegisterElasticIpCommand.ts @@ -20,6 +20,16 @@ import { export type RegisterElasticIpCommandInput = RegisterElasticIpRequest; export type RegisterElasticIpCommandOutput = RegisterElasticIpResult & __MetadataBearer; +/** + *

Registers an Elastic IP address with a specified stack. An address can be registered with + * only one stack at a time. If the address is already registered, you must first deregister it + * by calling DeregisterElasticIp. For more information, see Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class RegisterElasticIpCommand extends $Command< RegisterElasticIpCommandInput, RegisterElasticIpCommandOutput, @@ -34,6 +44,9 @@ export class RegisterElasticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/RegisterInstanceCommand.ts b/clients/client-opsworks/commands/RegisterInstanceCommand.ts index 0b706f6e8c377..374768237f666 100644 --- a/clients/client-opsworks/commands/RegisterInstanceCommand.ts +++ b/clients/client-opsworks/commands/RegisterInstanceCommand.ts @@ -20,6 +20,27 @@ import { export type RegisterInstanceCommandInput = RegisterInstanceRequest; export type RegisterInstanceCommandOutput = RegisterInstanceResult & __MetadataBearer; +/** + *

Registers instances that were created outside of AWS OpsWorks Stacks with a specified stack.

+ * + *

We do not recommend using this action to register instances. The complete registration + * operation includes two tasks: installing the AWS OpsWorks Stacks agent on the instance, and registering + * the instance with the stack. RegisterInstance handles only the second step. You + * should instead use the AWS CLI register command, which performs the entire + * registration operation. For more information, + * see + * Registering an Instance with an AWS OpsWorks Stacks Stack.

+ *
+ *

Registered instances have the same requirements as instances that are created by using the CreateInstance API. + * For example, registered instances must be running a supported Linux-based operating system, and they must have a supported instance + * type. For more information about requirements for instances that you want to register, see + * Preparing the Instance.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class RegisterInstanceCommand extends $Command< RegisterInstanceCommandInput, RegisterInstanceCommandOutput, @@ -34,6 +55,9 @@ export class RegisterInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/RegisterRdsDbInstanceCommand.ts b/clients/client-opsworks/commands/RegisterRdsDbInstanceCommand.ts index dfec76b4ebf10..6d135ed9b1b1f 100644 --- a/clients/client-opsworks/commands/RegisterRdsDbInstanceCommand.ts +++ b/clients/client-opsworks/commands/RegisterRdsDbInstanceCommand.ts @@ -20,6 +20,14 @@ import { export type RegisterRdsDbInstanceCommandInput = RegisterRdsDbInstanceRequest; export type RegisterRdsDbInstanceCommandOutput = __MetadataBearer; +/** + *

Registers an Amazon RDS instance with a stack.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class RegisterRdsDbInstanceCommand extends $Command< RegisterRdsDbInstanceCommandInput, RegisterRdsDbInstanceCommandOutput, @@ -34,6 +42,9 @@ export class RegisterRdsDbInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/RegisterVolumeCommand.ts b/clients/client-opsworks/commands/RegisterVolumeCommand.ts index f613b9832e131..69fbe6c10a79c 100644 --- a/clients/client-opsworks/commands/RegisterVolumeCommand.ts +++ b/clients/client-opsworks/commands/RegisterVolumeCommand.ts @@ -20,6 +20,16 @@ import { export type RegisterVolumeCommandInput = RegisterVolumeRequest; export type RegisterVolumeCommandOutput = RegisterVolumeResult & __MetadataBearer; +/** + *

Registers an Amazon EBS volume with a specified stack. A volume can be registered with only one + * stack at a time. If the volume is already registered, you must first deregister it by calling + * DeregisterVolume. For more information, see Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class RegisterVolumeCommand extends $Command< RegisterVolumeCommandInput, RegisterVolumeCommandOutput, @@ -34,6 +44,9 @@ export class RegisterVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/SetLoadBasedAutoScalingCommand.ts b/clients/client-opsworks/commands/SetLoadBasedAutoScalingCommand.ts index 69328bd7e43c3..cdfb28ddaef76 100644 --- a/clients/client-opsworks/commands/SetLoadBasedAutoScalingCommand.ts +++ b/clients/client-opsworks/commands/SetLoadBasedAutoScalingCommand.ts @@ -20,6 +20,19 @@ import { export type SetLoadBasedAutoScalingCommandInput = SetLoadBasedAutoScalingRequest; export type SetLoadBasedAutoScalingCommandOutput = __MetadataBearer; +/** + *

Specify the load-based auto scaling configuration for a specified layer. For more + * information, see Managing + * Load with Time-based and Load-based Instances.

+ * + *

To use load-based auto scaling, you must create a set of load-based auto scaling instances. Load-based auto scaling operates only on the instances from that set, so you must ensure that you have created enough instances to handle the maximum anticipated load.

+ *
+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class SetLoadBasedAutoScalingCommand extends $Command< SetLoadBasedAutoScalingCommandInput, SetLoadBasedAutoScalingCommandOutput, @@ -34,6 +47,9 @@ export class SetLoadBasedAutoScalingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/SetPermissionCommand.ts b/clients/client-opsworks/commands/SetPermissionCommand.ts index f770b8cfbe7a4..d326377fcdc95 100644 --- a/clients/client-opsworks/commands/SetPermissionCommand.ts +++ b/clients/client-opsworks/commands/SetPermissionCommand.ts @@ -20,6 +20,15 @@ import { export type SetPermissionCommandInput = SetPermissionRequest; export type SetPermissionCommandOutput = __MetadataBearer; +/** + *

Specifies a user's permissions. For more information, see Security and + * Permissions.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class SetPermissionCommand extends $Command< SetPermissionCommandInput, SetPermissionCommandOutput, @@ -34,6 +43,9 @@ export class SetPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/SetTimeBasedAutoScalingCommand.ts b/clients/client-opsworks/commands/SetTimeBasedAutoScalingCommand.ts index 34a9f26e5c84b..47d6728ae94e0 100644 --- a/clients/client-opsworks/commands/SetTimeBasedAutoScalingCommand.ts +++ b/clients/client-opsworks/commands/SetTimeBasedAutoScalingCommand.ts @@ -20,6 +20,16 @@ import { export type SetTimeBasedAutoScalingCommandInput = SetTimeBasedAutoScalingRequest; export type SetTimeBasedAutoScalingCommandOutput = __MetadataBearer; +/** + *

Specify the time-based auto scaling configuration for a specified instance. For more + * information, see Managing + * Load with Time-based and Load-based Instances.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class SetTimeBasedAutoScalingCommand extends $Command< SetTimeBasedAutoScalingCommandInput, SetTimeBasedAutoScalingCommandOutput, @@ -34,6 +44,9 @@ export class SetTimeBasedAutoScalingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/StartInstanceCommand.ts b/clients/client-opsworks/commands/StartInstanceCommand.ts index a674f4934f9c0..fe225d45e6774 100644 --- a/clients/client-opsworks/commands/StartInstanceCommand.ts +++ b/clients/client-opsworks/commands/StartInstanceCommand.ts @@ -20,6 +20,15 @@ import { export type StartInstanceCommandInput = StartInstanceRequest; export type StartInstanceCommandOutput = __MetadataBearer; +/** + *

Starts a specified instance. For more information, see Starting, + * Stopping, and Rebooting Instances.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class StartInstanceCommand extends $Command< StartInstanceCommandInput, StartInstanceCommandOutput, @@ -34,6 +43,9 @@ export class StartInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/StartStackCommand.ts b/clients/client-opsworks/commands/StartStackCommand.ts index c4a8889443819..fdf5c45ca0725 100644 --- a/clients/client-opsworks/commands/StartStackCommand.ts +++ b/clients/client-opsworks/commands/StartStackCommand.ts @@ -20,6 +20,14 @@ import { export type StartStackCommandInput = StartStackRequest; export type StartStackCommandOutput = __MetadataBearer; +/** + *

Starts a stack's instances.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class StartStackCommand extends $Command< StartStackCommandInput, StartStackCommandOutput, @@ -34,6 +42,9 @@ export class StartStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/StopInstanceCommand.ts b/clients/client-opsworks/commands/StopInstanceCommand.ts index d6542378ee301..a092286342fec 100644 --- a/clients/client-opsworks/commands/StopInstanceCommand.ts +++ b/clients/client-opsworks/commands/StopInstanceCommand.ts @@ -20,6 +20,17 @@ import { export type StopInstanceCommandInput = StopInstanceRequest; export type StopInstanceCommandOutput = __MetadataBearer; +/** + *

Stops a specified instance. When you stop a standard instance, the data disappears and must + * be reinstalled when you restart the instance. You can stop an Amazon EBS-backed instance without + * losing data. For more information, see Starting, + * Stopping, and Rebooting Instances.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class StopInstanceCommand extends $Command< StopInstanceCommandInput, StopInstanceCommandOutput, @@ -34,6 +45,9 @@ export class StopInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/StopStackCommand.ts b/clients/client-opsworks/commands/StopStackCommand.ts index 2c2f52ceb5568..f40f9ee006c26 100644 --- a/clients/client-opsworks/commands/StopStackCommand.ts +++ b/clients/client-opsworks/commands/StopStackCommand.ts @@ -17,6 +17,14 @@ import { export type StopStackCommandInput = StopStackRequest; export type StopStackCommandOutput = __MetadataBearer; +/** + *

Stops a specified stack.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class StopStackCommand extends $Command< StopStackCommandInput, StopStackCommandOutput, @@ -31,6 +39,9 @@ export class StopStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/TagResourceCommand.ts b/clients/client-opsworks/commands/TagResourceCommand.ts index 624d932067910..4fe3885cdd25d 100644 --- a/clients/client-opsworks/commands/TagResourceCommand.ts +++ b/clients/client-opsworks/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Apply cost-allocation tags to a specified stack or layer in AWS OpsWorks Stacks. For more information about how tagging works, see Tags in the AWS OpsWorks User Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UnassignInstanceCommand.ts b/clients/client-opsworks/commands/UnassignInstanceCommand.ts index 1e68b3a6d3044..a5fcef04c2f3e 100644 --- a/clients/client-opsworks/commands/UnassignInstanceCommand.ts +++ b/clients/client-opsworks/commands/UnassignInstanceCommand.ts @@ -20,6 +20,17 @@ import { export type UnassignInstanceCommandInput = UnassignInstanceRequest; export type UnassignInstanceCommandOutput = __MetadataBearer; +/** + *

Unassigns a registered instance from all layers that are using the instance. + * The instance remains in the stack as an unassigned instance, and can be assigned to + * another layer as needed. You cannot use this action with instances that were created + * with AWS OpsWorks Stacks.

+ *

+ * Required Permissions: To use this action, an IAM user must + * have a Manage permissions level for the stack or an attached policy that explicitly + * grants permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class UnassignInstanceCommand extends $Command< UnassignInstanceCommandInput, UnassignInstanceCommandOutput, @@ -34,6 +45,9 @@ export class UnassignInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UnassignVolumeCommand.ts b/clients/client-opsworks/commands/UnassignVolumeCommand.ts index af944841db8c3..f646da815da2b 100644 --- a/clients/client-opsworks/commands/UnassignVolumeCommand.ts +++ b/clients/client-opsworks/commands/UnassignVolumeCommand.ts @@ -20,6 +20,16 @@ import { export type UnassignVolumeCommandInput = UnassignVolumeRequest; export type UnassignVolumeCommandOutput = __MetadataBearer; +/** + *

Unassigns an assigned Amazon EBS volume. The volume remains registered with the stack. For more + * information, see Resource + * Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class UnassignVolumeCommand extends $Command< UnassignVolumeCommandInput, UnassignVolumeCommandOutput, @@ -34,6 +44,9 @@ export class UnassignVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UntagResourceCommand.ts b/clients/client-opsworks/commands/UntagResourceCommand.ts index 9006266834618..c60b763e281b3 100644 --- a/clients/client-opsworks/commands/UntagResourceCommand.ts +++ b/clients/client-opsworks/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes tags from a specified stack or layer.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateAppCommand.ts b/clients/client-opsworks/commands/UpdateAppCommand.ts index bacaab49f31a1..0e0117dd69b99 100644 --- a/clients/client-opsworks/commands/UpdateAppCommand.ts +++ b/clients/client-opsworks/commands/UpdateAppCommand.ts @@ -17,6 +17,14 @@ import { export type UpdateAppCommandInput = UpdateAppRequest; export type UpdateAppCommandOutput = __MetadataBearer; +/** + *

Updates a specified app.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Deploy or Manage + * permissions level for the stack, or an attached policy that explicitly grants permissions. For + * more information on user permissions, see Managing User + * Permissions.

+ */ export class UpdateAppCommand extends $Command< UpdateAppCommandInput, UpdateAppCommandOutput, @@ -31,6 +39,9 @@ export class UpdateAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateElasticIpCommand.ts b/clients/client-opsworks/commands/UpdateElasticIpCommand.ts index 3f68e697ce20e..a391a197f1fa7 100644 --- a/clients/client-opsworks/commands/UpdateElasticIpCommand.ts +++ b/clients/client-opsworks/commands/UpdateElasticIpCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateElasticIpCommandInput = UpdateElasticIpRequest; export type UpdateElasticIpCommandOutput = __MetadataBearer; +/** + *

Updates a registered Elastic IP address's name. For more information, see Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class UpdateElasticIpCommand extends $Command< UpdateElasticIpCommandInput, UpdateElasticIpCommandOutput, @@ -34,6 +42,9 @@ export class UpdateElasticIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateInstanceCommand.ts b/clients/client-opsworks/commands/UpdateInstanceCommand.ts index 905c3072d0e3e..c51587b9efcae 100644 --- a/clients/client-opsworks/commands/UpdateInstanceCommand.ts +++ b/clients/client-opsworks/commands/UpdateInstanceCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateInstanceCommandInput = UpdateInstanceRequest; export type UpdateInstanceCommandOutput = __MetadataBearer; +/** + *

Updates a specified instance.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class UpdateInstanceCommand extends $Command< UpdateInstanceCommandInput, UpdateInstanceCommandOutput, @@ -34,6 +42,9 @@ export class UpdateInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateLayerCommand.ts b/clients/client-opsworks/commands/UpdateLayerCommand.ts index 003172a0a9be8..8723005bc69d7 100644 --- a/clients/client-opsworks/commands/UpdateLayerCommand.ts +++ b/clients/client-opsworks/commands/UpdateLayerCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateLayerCommandInput = UpdateLayerRequest; export type UpdateLayerCommandOutput = __MetadataBearer; +/** + *

Updates a specified layer.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class UpdateLayerCommand extends $Command< UpdateLayerCommandInput, UpdateLayerCommandOutput, @@ -34,6 +42,9 @@ export class UpdateLayerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateMyUserProfileCommand.ts b/clients/client-opsworks/commands/UpdateMyUserProfileCommand.ts index 4743ec6c06e85..bd60b71cf25a8 100644 --- a/clients/client-opsworks/commands/UpdateMyUserProfileCommand.ts +++ b/clients/client-opsworks/commands/UpdateMyUserProfileCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateMyUserProfileCommandInput = UpdateMyUserProfileRequest; export type UpdateMyUserProfileCommandOutput = __MetadataBearer; +/** + *

Updates a user's SSH public key.

+ *

+ * Required Permissions: To use this action, an IAM user must have self-management + * enabled or an attached policy that explicitly grants permissions. For more information about user + * permissions, see Managing User + * Permissions.

+ */ export class UpdateMyUserProfileCommand extends $Command< UpdateMyUserProfileCommandInput, UpdateMyUserProfileCommandOutput, @@ -34,6 +42,9 @@ export class UpdateMyUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateRdsDbInstanceCommand.ts b/clients/client-opsworks/commands/UpdateRdsDbInstanceCommand.ts index 4d1521dab23c7..f13eb9363eb1f 100644 --- a/clients/client-opsworks/commands/UpdateRdsDbInstanceCommand.ts +++ b/clients/client-opsworks/commands/UpdateRdsDbInstanceCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateRdsDbInstanceCommandInput = UpdateRdsDbInstanceRequest; export type UpdateRdsDbInstanceCommandOutput = __MetadataBearer; +/** + *

Updates an Amazon RDS instance.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class UpdateRdsDbInstanceCommand extends $Command< UpdateRdsDbInstanceCommandInput, UpdateRdsDbInstanceCommandOutput, @@ -34,6 +42,9 @@ export class UpdateRdsDbInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateStackCommand.ts b/clients/client-opsworks/commands/UpdateStackCommand.ts index 30fa76eedfd07..6e456064dbbf1 100644 --- a/clients/client-opsworks/commands/UpdateStackCommand.ts +++ b/clients/client-opsworks/commands/UpdateStackCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateStackCommandInput = UpdateStackRequest; export type UpdateStackCommandOutput = __MetadataBearer; +/** + *

Updates a specified stack.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class UpdateStackCommand extends $Command< UpdateStackCommandInput, UpdateStackCommandOutput, @@ -34,6 +42,9 @@ export class UpdateStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateUserProfileCommand.ts b/clients/client-opsworks/commands/UpdateUserProfileCommand.ts index d5de4f5df192f..783d02b7c1ee3 100644 --- a/clients/client-opsworks/commands/UpdateUserProfileCommand.ts +++ b/clients/client-opsworks/commands/UpdateUserProfileCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateUserProfileCommandInput = UpdateUserProfileRequest; export type UpdateUserProfileCommandOutput = __MetadataBearer; +/** + *

Updates a specified user profile.

+ *

+ * Required Permissions: To use this action, an IAM user must have an attached policy + * that explicitly grants permissions. For more information about user permissions, see Managing User + * Permissions.

+ */ export class UpdateUserProfileCommand extends $Command< UpdateUserProfileCommandInput, UpdateUserProfileCommandOutput, @@ -34,6 +41,9 @@ export class UpdateUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/commands/UpdateVolumeCommand.ts b/clients/client-opsworks/commands/UpdateVolumeCommand.ts index 1c23ce718c7a4..d453dc16b017b 100644 --- a/clients/client-opsworks/commands/UpdateVolumeCommand.ts +++ b/clients/client-opsworks/commands/UpdateVolumeCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateVolumeCommandInput = UpdateVolumeRequest; export type UpdateVolumeCommandOutput = __MetadataBearer; +/** + *

Updates an Amazon EBS volume's name or mount point. For more information, see Resource Management.

+ *

+ * Required Permissions: To use this action, an IAM user must have a Manage permissions + * level for the stack, or an attached policy that explicitly grants permissions. For more + * information on user permissions, see Managing User + * Permissions.

+ */ export class UpdateVolumeCommand extends $Command< UpdateVolumeCommandInput, UpdateVolumeCommandOutput, @@ -34,6 +42,9 @@ export class UpdateVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksClientResolvedConfig, diff --git a/clients/client-opsworks/package.json b/clients/client-opsworks/package.json index 76005c00ad809..b71467aaccb79 100644 --- a/clients/client-opsworks/package.json +++ b/clients/client-opsworks/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Opsworks Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-opsworks/pagination/DescribeEcsClustersPaginator.ts b/clients/client-opsworks/pagination/DescribeEcsClustersPaginator.ts index 289f735f3b57d..d53a4f997cb20 100644 --- a/clients/client-opsworks/pagination/DescribeEcsClustersPaginator.ts +++ b/clients/client-opsworks/pagination/DescribeEcsClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { OpsWorksPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OpsWorksClient, input: DescribeEcsClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEcsClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: OpsWorks, input: DescribeEcsClustersCommandInput, diff --git a/clients/client-opsworks/runtimeConfig.browser.ts b/clients/client-opsworks/runtimeConfig.browser.ts index 547d742828b55..1fe71ee1bf4a5 100644 --- a/clients/client-opsworks/runtimeConfig.browser.ts +++ b/clients/client-opsworks/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./OpsWorksClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-opsworks/runtimeConfig.native.ts b/clients/client-opsworks/runtimeConfig.native.ts index 5fd70c3a11e5c..190be7c51134f 100644 --- a/clients/client-opsworks/runtimeConfig.native.ts +++ b/clients/client-opsworks/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./OpsWorksClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-opsworks/runtimeConfig.shared.ts b/clients/client-opsworks/runtimeConfig.shared.ts index febb050b1d334..d24703b790231 100644 --- a/clients/client-opsworks/runtimeConfig.shared.ts +++ b/clients/client-opsworks/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2013-02-18", disableHostPrefix: false, diff --git a/clients/client-opsworks/runtimeConfig.ts b/clients/client-opsworks/runtimeConfig.ts index e9d5966d1ab9a..83dd8c28207a9 100644 --- a/clients/client-opsworks/runtimeConfig.ts +++ b/clients/client-opsworks/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./OpsWorksClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-opsworks/tsconfig.json b/clients/client-opsworks/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-opsworks/tsconfig.json +++ b/clients/client-opsworks/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-opsworkscm/commands/AssociateNodeCommand.ts b/clients/client-opsworkscm/commands/AssociateNodeCommand.ts index 61d0c8cf865e8..acb1202c2da20 100644 --- a/clients/client-opsworkscm/commands/AssociateNodeCommand.ts +++ b/clients/client-opsworkscm/commands/AssociateNodeCommand.ts @@ -20,6 +20,25 @@ import { export type AssociateNodeCommandInput = AssociateNodeRequest; export type AssociateNodeCommandOutput = AssociateNodeResponse & __MetadataBearer; +/** + *

Associates a new node with the server. For more information about how to disassociate a node, see DisassociateNode.

+ *

+ * On a Chef server: This command is an alternative to knife bootstrap.

+ *

+ * Example (Chef): aws opsworks-cm associate-node --server-name MyServer --node-name MyManagedNode --engine-attributes "Name=CHEF_ORGANIZATION,Value=default" "Name=CHEF_NODE_PUBLIC_KEY,Value=public-key-pem" + *

+ *

+ * On a Puppet server, this command is an alternative to the puppet cert sign command that signs a Puppet node CSR. + *

+ *

+ * Example (Puppet): aws opsworks-cm associate-node --server-name MyServer --node-name MyManagedNode --engine-attributes "Name=PUPPET_NODE_CSR,Value=csr-pem" + *

+ *

+ * A node can can only be associated with servers that are in a HEALTHY state. Otherwise, an InvalidStateException is thrown. + * A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid. + * The AssociateNode API call can be integrated into Auto Scaling configurations, AWS Cloudformation templates, or the user data of a server's instance. + *

+ */ export class AssociateNodeCommand extends $Command< AssociateNodeCommandInput, AssociateNodeCommandOutput, @@ -34,6 +53,9 @@ export class AssociateNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/CreateBackupCommand.ts b/clients/client-opsworkscm/commands/CreateBackupCommand.ts index 99503fcb008ac..26db6c7ea75a0 100644 --- a/clients/client-opsworkscm/commands/CreateBackupCommand.ts +++ b/clients/client-opsworkscm/commands/CreateBackupCommand.ts @@ -20,6 +20,26 @@ import { export type CreateBackupCommandInput = CreateBackupRequest; export type CreateBackupCommandOutput = CreateBackupResponse & __MetadataBearer; +/** + *

+ * Creates an application-level backup of a server. While the + * server is in the BACKING_UP state, the server cannot be + * changed, and no additional backup can be created. + *

+ *

+ * Backups can be created for servers in RUNNING, HEALTHY, and UNHEALTHY states. By default, you can create a maximum of 50 + * manual backups. + *

+ *

+ * This operation is asynchronous. + *

+ *

+ * A LimitExceededException is thrown when the maximum number of manual backups is reached. + * An InvalidStateException is thrown when the server is not in any of the following states: RUNNING, HEALTHY, or UNHEALTHY. + * A ResourceNotFoundException is thrown when the server is not found. + * A ValidationException is thrown when parameters of the request are not valid. + *

+ */ export class CreateBackupCommand extends $Command< CreateBackupCommandInput, CreateBackupCommandOutput, @@ -34,6 +54,9 @@ export class CreateBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/CreateServerCommand.ts b/clients/client-opsworkscm/commands/CreateServerCommand.ts index 7497b3cc67b08..e3eebdbb1c956 100644 --- a/clients/client-opsworkscm/commands/CreateServerCommand.ts +++ b/clients/client-opsworkscm/commands/CreateServerCommand.ts @@ -20,6 +20,36 @@ import { export type CreateServerCommandInput = CreateServerRequest; export type CreateServerCommandOutput = CreateServerResponse & __MetadataBearer; +/** + *

+ * Creates and immedately starts a new server. The server is ready to use when it is in the HEALTHY state. By default, you can create a maximum of 10 servers. + *

+ *

+ * This operation is asynchronous. + *

+ *

+ * A LimitExceededException is thrown when you have created the maximum number of servers (10). A ResourceAlreadyExistsException + * is thrown when a server with the same name already exists in the account. A ResourceNotFoundException is thrown when you + * specify a backup ID that is not valid or is for a backup that does not exist. A ValidationException is thrown when parameters + * of the request are not valid. + *

+ *

+ * If you do not specify a security group by adding the SecurityGroupIds parameter, AWS OpsWorks creates a new security group. + *

+ *

+ * Chef Automate: The default security group opens the Chef server to the world on TCP port 443. If a KeyName is present, AWS OpsWorks enables SSH access. SSH is also open to the world on TCP port 22. + *

+ *

+ * Puppet Enterprise: The default security group opens TCP ports 22, 443, 4433, 8140, 8142, 8143, and 8170. If a KeyName is present, AWS OpsWorks enables SSH access. SSH is also open to the world on TCP port 22. + *

+ *

By default, your server is accessible from any IP address. We + * recommend that you update your security group rules to allow + * access from known IP addresses and address ranges only. To edit security group rules, open Security Groups + * in the navigation pane of the EC2 management console. + *

+ *

To specify your own domain for a server, and provide your own self-signed or CA-signed certificate and private key, specify values for CustomDomain, + * CustomCertificate, and CustomPrivateKey.

+ */ export class CreateServerCommand extends $Command< CreateServerCommandInput, CreateServerCommandOutput, @@ -34,6 +64,9 @@ export class CreateServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/DeleteBackupCommand.ts b/clients/client-opsworkscm/commands/DeleteBackupCommand.ts index 41a069df0c190..9e77defe3214b 100644 --- a/clients/client-opsworkscm/commands/DeleteBackupCommand.ts +++ b/clients/client-opsworkscm/commands/DeleteBackupCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteBackupCommandInput = DeleteBackupRequest; export type DeleteBackupCommandOutput = DeleteBackupResponse & __MetadataBearer; +/** + *

+ * Deletes a backup. You can delete both manual and automated backups. This operation is asynchronous. + *

+ *

+ * An InvalidStateException is thrown when a backup deletion is already in progress. + * A ResourceNotFoundException is thrown when the backup does not exist. + * A ValidationException is thrown when parameters of the request are not valid. + *

+ */ export class DeleteBackupCommand extends $Command< DeleteBackupCommandInput, DeleteBackupCommandOutput, @@ -34,6 +44,9 @@ export class DeleteBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/DeleteServerCommand.ts b/clients/client-opsworkscm/commands/DeleteServerCommand.ts index dfbcea9e33287..b5c23c3a7b7f3 100644 --- a/clients/client-opsworkscm/commands/DeleteServerCommand.ts +++ b/clients/client-opsworkscm/commands/DeleteServerCommand.ts @@ -20,6 +20,24 @@ import { export type DeleteServerCommandInput = DeleteServerRequest; export type DeleteServerCommandOutput = DeleteServerResponse & __MetadataBearer; +/** + *

+ * Deletes the server and the underlying AWS CloudFormation stacks + * (including the server's EC2 instance). When you run this command, the server state is updated + * to DELETING. After the server is deleted, it is no longer returned by + * DescribeServer requests. If the AWS CloudFormation stack cannot be deleted, the server cannot be deleted. + *

+ *

+ * This operation is asynchronous. + *

+ *

+ * An InvalidStateException is thrown when a server deletion is already in progress. + * A ResourceNotFoundException is thrown when the server does not exist. + * A ValidationException is raised when parameters of the request are not valid. + *

+ *

+ *

+ */ export class DeleteServerCommand extends $Command< DeleteServerCommandInput, DeleteServerCommandOutput, @@ -34,6 +52,9 @@ export class DeleteServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/DescribeAccountAttributesCommand.ts b/clients/client-opsworkscm/commands/DescribeAccountAttributesCommand.ts index ea1c01ea71077..7e071ebc2ec6c 100644 --- a/clients/client-opsworkscm/commands/DescribeAccountAttributesCommand.ts +++ b/clients/client-opsworkscm/commands/DescribeAccountAttributesCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeAccountAttributesCommandInput = DescribeAccountAttributesRequest; export type DescribeAccountAttributesCommandOutput = DescribeAccountAttributesResponse & __MetadataBearer; +/** + *

+ * Describes your OpsWorks-CM account attributes. + *

+ *

+ * This operation is synchronous. + *

+ */ export class DescribeAccountAttributesCommand extends $Command< DescribeAccountAttributesCommandInput, DescribeAccountAttributesCommandOutput, @@ -34,6 +42,9 @@ export class DescribeAccountAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/DescribeBackupsCommand.ts b/clients/client-opsworkscm/commands/DescribeBackupsCommand.ts index c3d38e5e00220..899673333dc9a 100644 --- a/clients/client-opsworkscm/commands/DescribeBackupsCommand.ts +++ b/clients/client-opsworkscm/commands/DescribeBackupsCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeBackupsCommandInput = DescribeBackupsRequest; export type DescribeBackupsCommandOutput = DescribeBackupsResponse & __MetadataBearer; +/** + *

+ * Describes backups. The results are ordered by time, with newest backups first. + * If you do not specify a BackupId or ServerName, the command returns all backups. + *

+ *

+ * This operation is synchronous. + *

+ *

+ * A ResourceNotFoundException is thrown when the backup does not exist. + * A ValidationException is raised when parameters of the request are not valid. + *

+ */ export class DescribeBackupsCommand extends $Command< DescribeBackupsCommandInput, DescribeBackupsCommandOutput, @@ -34,6 +47,9 @@ export class DescribeBackupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/DescribeEventsCommand.ts b/clients/client-opsworkscm/commands/DescribeEventsCommand.ts index ae1168b161837..c4fd7ea635c0d 100644 --- a/clients/client-opsworkscm/commands/DescribeEventsCommand.ts +++ b/clients/client-opsworkscm/commands/DescribeEventsCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeEventsCommandInput = DescribeEventsRequest; export type DescribeEventsCommandOutput = DescribeEventsResponse & __MetadataBearer; +/** + *

+ * Describes events for a specified server. Results are ordered by time, with newest events first. + *

+ *

+ * This operation is synchronous. + *

+ *

+ * A ResourceNotFoundException is thrown when the server does not exist. + * A ValidationException is raised when parameters of the request are not valid. + *

+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +46,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/DescribeNodeAssociationStatusCommand.ts b/clients/client-opsworkscm/commands/DescribeNodeAssociationStatusCommand.ts index a1efce1b2f6d1..46355e650b65e 100644 --- a/clients/client-opsworkscm/commands/DescribeNodeAssociationStatusCommand.ts +++ b/clients/client-opsworkscm/commands/DescribeNodeAssociationStatusCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeNodeAssociationStatusCommandInput = DescribeNodeAssociationStatusRequest; export type DescribeNodeAssociationStatusCommandOutput = DescribeNodeAssociationStatusResponse & __MetadataBearer; +/** + *

+ * Returns the current status of an existing association or disassociation request. + *

+ *

+ * A ResourceNotFoundException is thrown when no recent association or disassociation request with the specified token is found, + * or when the server does not exist. A ValidationException is raised when parameters of the request are not valid. + *

+ */ export class DescribeNodeAssociationStatusCommand extends $Command< DescribeNodeAssociationStatusCommandInput, DescribeNodeAssociationStatusCommandOutput, @@ -34,6 +43,9 @@ export class DescribeNodeAssociationStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/DescribeServersCommand.ts b/clients/client-opsworkscm/commands/DescribeServersCommand.ts index 17fb4b55a4a54..e38c0b19dbdbc 100644 --- a/clients/client-opsworkscm/commands/DescribeServersCommand.ts +++ b/clients/client-opsworkscm/commands/DescribeServersCommand.ts @@ -20,6 +20,20 @@ import { export type DescribeServersCommandInput = DescribeServersRequest; export type DescribeServersCommandOutput = DescribeServersResponse & __MetadataBearer; +/** + *

+ * Lists all configuration management servers that are identified with your account. + * Only the stored results from Amazon DynamoDB + * are returned. AWS OpsWorks CM does not query other services. + *

+ *

+ * This operation is synchronous. + *

+ *

+ * A ResourceNotFoundException is thrown when the server does not exist. + * A ValidationException is raised when parameters of the request are not valid. + *

+ */ export class DescribeServersCommand extends $Command< DescribeServersCommandInput, DescribeServersCommandOutput, @@ -34,6 +48,9 @@ export class DescribeServersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/DisassociateNodeCommand.ts b/clients/client-opsworkscm/commands/DisassociateNodeCommand.ts index 51b59c635e3d6..57fa5f043b8c4 100644 --- a/clients/client-opsworkscm/commands/DisassociateNodeCommand.ts +++ b/clients/client-opsworkscm/commands/DisassociateNodeCommand.ts @@ -20,6 +20,16 @@ import { export type DisassociateNodeCommandInput = DisassociateNodeRequest; export type DisassociateNodeCommandOutput = DisassociateNodeResponse & __MetadataBearer; +/** + *

+ * Disassociates a node from an AWS OpsWorks CM server, and removes the node from the server's managed nodes. After a node is disassociated, + * the node key pair is no longer valid for accessing the configuration manager's API. For more information about how to associate a node, see AssociateNode. + *

+ *

A node can can only be disassociated from a server that is in a HEALTHY state. Otherwise, an InvalidStateException is thrown. + * A ResourceNotFoundException is thrown when the server does not exist. + * A ValidationException is raised when parameters of the request are not valid. + *

+ */ export class DisassociateNodeCommand extends $Command< DisassociateNodeCommandInput, DisassociateNodeCommandOutput, @@ -34,6 +44,9 @@ export class DisassociateNodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/ExportServerEngineAttributeCommand.ts b/clients/client-opsworkscm/commands/ExportServerEngineAttributeCommand.ts index bb77789fcb3ef..0e0ae304c4f6d 100644 --- a/clients/client-opsworkscm/commands/ExportServerEngineAttributeCommand.ts +++ b/clients/client-opsworkscm/commands/ExportServerEngineAttributeCommand.ts @@ -20,6 +20,20 @@ import { export type ExportServerEngineAttributeCommandInput = ExportServerEngineAttributeRequest; export type ExportServerEngineAttributeCommandOutput = ExportServerEngineAttributeResponse & __MetadataBearer; +/** + *

+ * Exports a specified server engine attribute as a base64-encoded string. For example, you can export user data that you can use in EC2 to associate nodes with a server. + *

+ *

+ * This operation is synchronous. + *

+ *

+ * A ValidationException is raised when parameters of the request are not valid. + * A ResourceNotFoundException is thrown when the server does not exist. + * An InvalidStateException is thrown when the server is in any of the following states: CREATING, TERMINATED, + * FAILED or DELETING. + *

+ */ export class ExportServerEngineAttributeCommand extends $Command< ExportServerEngineAttributeCommandInput, ExportServerEngineAttributeCommandOutput, @@ -34,6 +48,9 @@ export class ExportServerEngineAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/ListTagsForResourceCommand.ts b/clients/client-opsworkscm/commands/ListTagsForResourceCommand.ts index b0bfc80537c2d..0ab6edd2ae039 100644 --- a/clients/client-opsworkscm/commands/ListTagsForResourceCommand.ts +++ b/clients/client-opsworkscm/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns a list of tags that are applied to the specified AWS OpsWorks for Chef Automate or + * AWS OpsWorks for Puppet Enterprise servers or backups.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/RestoreServerCommand.ts b/clients/client-opsworkscm/commands/RestoreServerCommand.ts index b0c4afce1b250..a629abeea91ae 100644 --- a/clients/client-opsworkscm/commands/RestoreServerCommand.ts +++ b/clients/client-opsworkscm/commands/RestoreServerCommand.ts @@ -20,6 +20,23 @@ import { export type RestoreServerCommandInput = RestoreServerRequest; export type RestoreServerCommandOutput = RestoreServerResponse & __MetadataBearer; +/** + *

+ * Restores a backup to a server that is in a CONNECTION_LOST, HEALTHY, RUNNING, UNHEALTHY, or TERMINATED state. + * When you run RestoreServer, the server's EC2 instance is deleted, and a new EC2 instance is configured. RestoreServer maintains + * the existing server endpoint, so configuration management of the server's client devices (nodes) should continue to work. + *

+ *

Restoring from a backup is performed by creating a new EC2 instance. If restoration is successful, and the server is in a HEALTHY state, + * AWS OpsWorks CM switches traffic over to the new instance. After restoration is finished, the old EC2 instance is maintained in a + * Running or Stopped state, but is eventually terminated.

+ *

+ * This operation is asynchronous. + *

+ *

+ * An InvalidStateException is thrown when the server is not in a valid state. A ResourceNotFoundException is thrown + * when the server does not exist. A ValidationException is raised when parameters of the request are not valid. + *

+ */ export class RestoreServerCommand extends $Command< RestoreServerCommandInput, RestoreServerCommandOutput, @@ -34,6 +51,9 @@ export class RestoreServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/StartMaintenanceCommand.ts b/clients/client-opsworkscm/commands/StartMaintenanceCommand.ts index 5dd7e235bf571..a69d404ef21d0 100644 --- a/clients/client-opsworkscm/commands/StartMaintenanceCommand.ts +++ b/clients/client-opsworkscm/commands/StartMaintenanceCommand.ts @@ -20,6 +20,16 @@ import { export type StartMaintenanceCommandInput = StartMaintenanceRequest; export type StartMaintenanceCommandOutput = StartMaintenanceResponse & __MetadataBearer; +/** + *

+ * Manually starts server maintenance. This command can be useful if an earlier maintenance attempt failed, and the underlying + * cause of maintenance failure has been resolved. The server is in an UNDER_MAINTENANCE state while maintenance is in progress. + *

+ *

+ * Maintenance can only be started on servers in HEALTHY and UNHEALTHY states. Otherwise, an InvalidStateException is thrown. + * A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid. + *

+ */ export class StartMaintenanceCommand extends $Command< StartMaintenanceCommandInput, StartMaintenanceCommandOutput, @@ -34,6 +44,9 @@ export class StartMaintenanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/TagResourceCommand.ts b/clients/client-opsworkscm/commands/TagResourceCommand.ts index 2812ed13748eb..1a043b18e4e22 100644 --- a/clients/client-opsworkscm/commands/TagResourceCommand.ts +++ b/clients/client-opsworkscm/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Applies tags to an AWS OpsWorks for Chef Automate or AWS OpsWorks for Puppet Enterprise server, or to server backups.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/UntagResourceCommand.ts b/clients/client-opsworkscm/commands/UntagResourceCommand.ts index 1b5dee70b98d2..0f6d28563ea24 100644 --- a/clients/client-opsworkscm/commands/UntagResourceCommand.ts +++ b/clients/client-opsworkscm/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes specified tags from an AWS OpsWorks-CM server or backup.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/UpdateServerCommand.ts b/clients/client-opsworkscm/commands/UpdateServerCommand.ts index 6eb1642eec5f2..f72411faf8fc5 100644 --- a/clients/client-opsworkscm/commands/UpdateServerCommand.ts +++ b/clients/client-opsworkscm/commands/UpdateServerCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateServerCommandInput = UpdateServerRequest; export type UpdateServerCommandOutput = UpdateServerResponse & __MetadataBearer; +/** + *

+ * Updates settings for a server. + *

+ *

+ * This operation is synchronous. + *

+ */ export class UpdateServerCommand extends $Command< UpdateServerCommandInput, UpdateServerCommandOutput, @@ -34,6 +42,9 @@ export class UpdateServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/commands/UpdateServerEngineAttributesCommand.ts b/clients/client-opsworkscm/commands/UpdateServerEngineAttributesCommand.ts index c75c0587c9939..0433b286081be 100644 --- a/clients/client-opsworkscm/commands/UpdateServerEngineAttributesCommand.ts +++ b/clients/client-opsworkscm/commands/UpdateServerEngineAttributesCommand.ts @@ -20,6 +20,22 @@ import { export type UpdateServerEngineAttributesCommandInput = UpdateServerEngineAttributesRequest; export type UpdateServerEngineAttributesCommandOutput = UpdateServerEngineAttributesResponse & __MetadataBearer; +/** + *

+ * Updates engine-specific attributes on a specified server. The server + * enters the MODIFYING state when this operation + * is in progress. Only one update can occur at a time. + * You can use this command to reset a Chef server's public key (CHEF_PIVOTAL_KEY) or a Puppet server's + * admin password (PUPPET_ADMIN_PASSWORD). + *

+ *

+ * This operation is asynchronous. + *

+ *

+ * This operation can only be called for servers in HEALTHY or UNHEALTHY states. Otherwise, an InvalidStateException is raised. + * A ResourceNotFoundException is thrown when the server does not exist. A ValidationException is raised when parameters of the request are not valid. + *

+ */ export class UpdateServerEngineAttributesCommand extends $Command< UpdateServerEngineAttributesCommandInput, UpdateServerEngineAttributesCommandOutput, @@ -34,6 +50,9 @@ export class UpdateServerEngineAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OpsWorksCMClientResolvedConfig, diff --git a/clients/client-opsworkscm/package.json b/clients/client-opsworkscm/package.json index a64dea7c3e547..c589f06609064 100644 --- a/clients/client-opsworkscm/package.json +++ b/clients/client-opsworkscm/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Opsworkscm Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-opsworkscm/pagination/DescribeBackupsPaginator.ts b/clients/client-opsworkscm/pagination/DescribeBackupsPaginator.ts index 8c7ee9a246fe0..b8c149798ee0b 100644 --- a/clients/client-opsworkscm/pagination/DescribeBackupsPaginator.ts +++ b/clients/client-opsworkscm/pagination/DescribeBackupsPaginator.ts @@ -8,6 +8,9 @@ import { import { OpsWorksCMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OpsWorksCMClient, input: DescribeBackupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeBackupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: OpsWorksCM, input: DescribeBackupsCommandInput, diff --git a/clients/client-opsworkscm/pagination/DescribeEventsPaginator.ts b/clients/client-opsworkscm/pagination/DescribeEventsPaginator.ts index 7ac75fb513916..7067a3adc40ff 100644 --- a/clients/client-opsworkscm/pagination/DescribeEventsPaginator.ts +++ b/clients/client-opsworkscm/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { OpsWorksCMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OpsWorksCMClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: OpsWorksCM, input: DescribeEventsCommandInput, diff --git a/clients/client-opsworkscm/pagination/DescribeServersPaginator.ts b/clients/client-opsworkscm/pagination/DescribeServersPaginator.ts index ac2d936411120..dd49604cfddc0 100644 --- a/clients/client-opsworkscm/pagination/DescribeServersPaginator.ts +++ b/clients/client-opsworkscm/pagination/DescribeServersPaginator.ts @@ -8,6 +8,9 @@ import { import { OpsWorksCMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OpsWorksCMClient, input: DescribeServersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeServersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: OpsWorksCM, input: DescribeServersCommandInput, diff --git a/clients/client-opsworkscm/pagination/ListTagsForResourcePaginator.ts b/clients/client-opsworkscm/pagination/ListTagsForResourcePaginator.ts index bad0d4e2c779d..c284779f62b3a 100644 --- a/clients/client-opsworkscm/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-opsworkscm/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { OpsWorksCMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OpsWorksCMClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: OpsWorksCM, input: ListTagsForResourceCommandInput, diff --git a/clients/client-opsworkscm/runtimeConfig.browser.ts b/clients/client-opsworkscm/runtimeConfig.browser.ts index 1eeadc12ee16f..461049f98e5bb 100644 --- a/clients/client-opsworkscm/runtimeConfig.browser.ts +++ b/clients/client-opsworkscm/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./OpsWorksCMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-opsworkscm/runtimeConfig.native.ts b/clients/client-opsworkscm/runtimeConfig.native.ts index 4877381292203..46c8df4111135 100644 --- a/clients/client-opsworkscm/runtimeConfig.native.ts +++ b/clients/client-opsworkscm/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./OpsWorksCMClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-opsworkscm/runtimeConfig.shared.ts b/clients/client-opsworkscm/runtimeConfig.shared.ts index b6e4c70a113d6..b9b38eae429ad 100644 --- a/clients/client-opsworkscm/runtimeConfig.shared.ts +++ b/clients/client-opsworkscm/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-11-01", disableHostPrefix: false, diff --git a/clients/client-opsworkscm/runtimeConfig.ts b/clients/client-opsworkscm/runtimeConfig.ts index a6007d853f79b..05574e57fe014 100644 --- a/clients/client-opsworkscm/runtimeConfig.ts +++ b/clients/client-opsworkscm/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./OpsWorksCMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-opsworkscm/tsconfig.json b/clients/client-opsworkscm/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-opsworkscm/tsconfig.json +++ b/clients/client-opsworkscm/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-organizations/commands/AcceptHandshakeCommand.ts b/clients/client-organizations/commands/AcceptHandshakeCommand.ts index c2cdfad457cd8..0c8f90e7cb89c 100644 --- a/clients/client-organizations/commands/AcceptHandshakeCommand.ts +++ b/clients/client-organizations/commands/AcceptHandshakeCommand.ts @@ -20,6 +20,38 @@ import { export type AcceptHandshakeCommandInput = AcceptHandshakeRequest; export type AcceptHandshakeCommandOutput = AcceptHandshakeResponse & __MetadataBearer; +/** + *

Sends a response to the originator of a handshake agreeing to the action proposed by + * the handshake request.

+ *

This operation can be called only by the following principals when they also have the + * relevant IAM permissions:

+ *
    + *
  • + *

    + * Invitation to join or Approve all features request handshakes: only a principal from + * the member account.

    + *

    The user who calls the API for an invitation to join must have the + * organizations:AcceptHandshake permission. If you enabled all + * features in the organization, the user must also have the + * iam:CreateServiceLinkedRole permission so that AWS Organizations can + * create the required service-linked role named AWSServiceRoleForOrganizations. For + * more information, see AWS Organizations and Service-Linked Roles in the + * AWS Organizations User Guide.

    + *
  • + *
  • + *

    + * Enable all features final confirmation + * handshake: only a principal from the management account.

    + *

    For more information about invitations, see Inviting an AWS Account to Join Your Organization in the + * AWS Organizations User Guide. For more information about requests to + * enable all features in the organization, see Enabling All Features in Your Organization in + * the AWS Organizations User Guide. + *

    + *
  • + *
+ *

After you accept a handshake, it continues to appear in the results of relevant APIs + * for only 30 days. After that, it's deleted.

+ */ export class AcceptHandshakeCommand extends $Command< AcceptHandshakeCommandInput, AcceptHandshakeCommandOutput, @@ -34,6 +66,9 @@ export class AcceptHandshakeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/AttachPolicyCommand.ts b/clients/client-organizations/commands/AttachPolicyCommand.ts index 29fded66d3176..13a7da80fa993 100644 --- a/clients/client-organizations/commands/AttachPolicyCommand.ts +++ b/clients/client-organizations/commands/AttachPolicyCommand.ts @@ -20,6 +20,34 @@ import { export type AttachPolicyCommandInput = AttachPolicyRequest; export type AttachPolicyCommandOutput = __MetadataBearer; +/** + *

Attaches a policy to a root, an organizational unit (OU), or an individual account. + * How the policy affects accounts depends on the type of policy. Refer to the + * AWS Organizations User Guide for information about each policy type:

+ * + *

This operation can be called only from the organization's management account.

+ */ export class AttachPolicyCommand extends $Command< AttachPolicyCommandInput, AttachPolicyCommandOutput, @@ -34,6 +62,9 @@ export class AttachPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/CancelHandshakeCommand.ts b/clients/client-organizations/commands/CancelHandshakeCommand.ts index 757ac4484e100..4ed462b011b86 100644 --- a/clients/client-organizations/commands/CancelHandshakeCommand.ts +++ b/clients/client-organizations/commands/CancelHandshakeCommand.ts @@ -20,6 +20,14 @@ import { export type CancelHandshakeCommandInput = CancelHandshakeRequest; export type CancelHandshakeCommandOutput = CancelHandshakeResponse & __MetadataBearer; +/** + *

Cancels a handshake. Canceling a handshake sets the handshake state to + * CANCELED.

+ *

This operation can be called only from the account that originated the handshake. The recipient of the handshake can't cancel it, but can use DeclineHandshake instead. After a handshake is canceled, the recipient + * can no longer respond to that handshake.

+ *

After you cancel a handshake, it continues to appear in the results of relevant APIs + * for only 30 days. After that, it's deleted.

+ */ export class CancelHandshakeCommand extends $Command< CancelHandshakeCommandInput, CancelHandshakeCommandOutput, @@ -34,6 +42,9 @@ export class CancelHandshakeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/CreateAccountCommand.ts b/clients/client-organizations/commands/CreateAccountCommand.ts index 0b1a9ddaa0de9..adc8796a30940 100644 --- a/clients/client-organizations/commands/CreateAccountCommand.ts +++ b/clients/client-organizations/commands/CreateAccountCommand.ts @@ -20,6 +20,86 @@ import { export type CreateAccountCommandInput = CreateAccountRequest; export type CreateAccountCommandOutput = CreateAccountResponse & __MetadataBearer; +/** + *

Creates an AWS account that is automatically a member of the organization whose + * credentials made the request. This is an asynchronous request that AWS performs in the + * background. Because CreateAccount operates asynchronously, it can return a + * successful completion message even though account initialization might still be in + * progress. You might need to wait a few minutes before you can successfully access the + * account. To check the status of the request, do one of the following:

+ *
    + *
  • + *

    Use the Id member of the CreateAccountStatus + * response element from this operation to provide as a parameter to the DescribeCreateAccountStatus operation.

    + *
  • + *
  • + *

    Check the AWS CloudTrail log for the CreateAccountResult event. For + * information on using AWS CloudTrail with AWS Organizations, see Monitoring the Activity in Your + * Organization in the AWS Organizations User Guide. + *

    + *
  • + *
+ *

The user who calls the API to create an account must have the + * organizations:CreateAccount permission. If you enabled all features in + * the organization, AWS Organizations creates the required service-linked role named + * AWSServiceRoleForOrganizations. For more information, see AWS Organizations and Service-Linked Roles in the + * AWS Organizations User Guide.

+ *

If the request includes tags, then the requester must have the + * organizations:TagResource permission.

+ *

AWS Organizations preconfigures the new member account with a role (named + * OrganizationAccountAccessRole by default) that grants users in the + * management account administrator permissions in the new member account. Principals in the + * management account can assume the role. AWS Organizations clones the company name and address + * information for the new account from the organization's management account.

+ *

This operation can be called only from the organization's management account.

+ *

For more information about creating accounts, see Creating + * an AWS Account in Your Organization in the + * AWS Organizations User Guide. + *

+ * + *
    + *
  • + *

    When you create an account in an organization using the AWS Organizations console, + * API, or CLI commands, the information required for the account to operate as + * a standalone account, such as a payment method and signing the end user + * license agreement (EULA) is not automatically + * collected. If you must remove an account from your organization later, you + * can do so only after you provide the missing information. Follow the steps + * at To leave an organization as a member account in the + * AWS Organizations User Guide.

    + *
  • + *
  • + *

    If you get an exception that indicates that you exceeded your account + * limits for the organization, contact AWS Support.

    + *
  • + *
  • + *

    If you get an exception that indicates that the operation failed because + * your organization is still initializing, wait one hour and then try again. + * If the error persists, contact AWS + * Support.

    + *
  • + *
  • + *

    Using CreateAccount to create multiple temporary accounts + * isn't recommended. You can only close an account from the Billing and Cost + * Management Console, and you must be signed in as the root user. For + * information on the requirements and process for closing an account, see + * Closing an + * AWS Account in the + * AWS Organizations User Guide.

    + *
  • + *
+ *
+ * + *

When you create a member account with this operation, you can choose whether to + * create the account with the IAM User and Role Access to + * Billing Information switch enabled. If you enable it, IAM users and + * roles that have appropriate permissions can view billing information for the + * account. If you disable it, only the account root user can access billing + * information. For information about how to disable this switch for an account, see + * Granting + * Access to Your Billing Information and Tools.

+ *
+ */ export class CreateAccountCommand extends $Command< CreateAccountCommandInput, CreateAccountCommandOutput, @@ -34,6 +114,9 @@ export class CreateAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/CreateGovCloudAccountCommand.ts b/clients/client-organizations/commands/CreateGovCloudAccountCommand.ts index fb787fef54964..6634da2dde087 100644 --- a/clients/client-organizations/commands/CreateGovCloudAccountCommand.ts +++ b/clients/client-organizations/commands/CreateGovCloudAccountCommand.ts @@ -20,6 +20,141 @@ import { export type CreateGovCloudAccountCommandInput = CreateGovCloudAccountRequest; export type CreateGovCloudAccountCommandOutput = CreateGovCloudAccountResponse & __MetadataBearer; +/** + *

This action is available if all of the following are true:

+ *
    + *
  • + *

    You're authorized to create accounts in the AWS GovCloud (US) Region. For + * more information on the AWS GovCloud (US) Region, see the + * AWS GovCloud User Guide. + *

    + *
  • + *
  • + *

    You already have an account in the AWS GovCloud (US) Region that is paired + * with a management account of an organization in the commercial Region.

    + *
  • + *
  • + *

    You call this action from the management account of your organization in the + * commercial Region.

    + *
  • + *
  • + *

    You have the organizations:CreateGovCloudAccount permission. + *

    + *
  • + *
+ *

AWS Organizations automatically creates the required service-linked role named + * AWSServiceRoleForOrganizations. For more information, see AWS Organizations and Service-Linked Roles in the + * AWS Organizations User Guide. + *

+ *

AWS automatically enables AWS CloudTrail for AWS GovCloud (US) accounts, but you should also + * do the following:

+ *
    + *
  • + *

    Verify that AWS CloudTrail is enabled to store logs.

    + *
  • + *
  • + *

    Create an S3 bucket for AWS CloudTrail log storage.

    + *

    For more information, see Verifying AWS CloudTrail Is + * Enabled in the AWS GovCloud User Guide. + *

    + *
  • + *
+ *

If the request includes tags, then the requester must have the + * organizations:TagResource permission. The tags are attached to the + * commercial account associated with the GovCloud account, rather than the GovCloud + * account itself. To add tags to the GovCloud account, call the TagResource operation in the GovCloud Region after the new GovCloud + * account exists.

+ *

You call this action from the management account of your organization in the commercial + * Region to create a standalone AWS account in the AWS GovCloud (US) Region. After the + * account is created, the management account of an organization in the AWS GovCloud (US) + * Region can invite it to that organization. For more information on inviting standalone + * accounts in the AWS GovCloud (US) to join an organization, see AWS Organizations in the + * AWS GovCloud User Guide. + *

+ *

Calling CreateGovCloudAccount is an asynchronous request that AWS + * performs in the background. Because CreateGovCloudAccount operates + * asynchronously, it can return a successful completion message even though account + * initialization might still be in progress. You might need to wait a few minutes before + * you can successfully access the account. To check the status of the request, do one of + * the following:

+ *
    + *
  • + *

    Use the OperationId response element from this operation to + * provide as a parameter to the DescribeCreateAccountStatus + * operation.

    + *
  • + *
  • + *

    Check the AWS CloudTrail log for the CreateAccountResult event. For + * information on using AWS CloudTrail with Organizations, see Monitoring the Activity in Your + * Organization in the AWS Organizations User Guide. + *

    + *
  • + *
+ *

+ *

When you call the CreateGovCloudAccount action, you create two accounts: + * a standalone account in the AWS GovCloud (US) Region and an associated account in the + * commercial Region for billing and support purposes. The account in the commercial Region + * is automatically a member of the organization whose credentials made the request. Both + * accounts are associated with the same email address.

+ *

A role is created in the new account in the commercial Region that allows the + * management account in the organization in the commercial Region to assume it. An AWS + * GovCloud (US) account is then created and associated with the commercial account that + * you just created. A role is also created in the new AWS GovCloud (US) account that can + * be assumed by the AWS GovCloud (US) account that is associated with the + * management account of the commercial organization. For more information and to view a + * diagram that explains how account access works, see AWS Organizations in the + * AWS GovCloud User Guide. + *

+ * + * + *

For more information about creating accounts, see Creating + * an AWS Account in Your Organization in the + * AWS Organizations User Guide. + *

+ * + *
    + *
  • + *

    When you create an account in an organization using the AWS Organizations console, + * API, or CLI commands, the information required for the account to operate as + * a standalone account is not automatically collected. + * This includes a payment method and signing the end user license agreement + * (EULA). If you must remove an account from your organization later, you can + * do so only after you provide the missing information. Follow the steps at + * To leave an organization as a member account in the + * AWS Organizations User Guide. + *

    + *
  • + *
  • + *

    If you get an exception that indicates that you exceeded your account + * limits for the organization, contact AWS Support.

    + *
  • + *
  • + *

    If you get an exception that indicates that the operation failed because + * your organization is still initializing, wait one hour and then try again. + * If the error persists, contact AWS + * Support.

    + *
  • + *
  • + *

    Using CreateGovCloudAccount to create multiple temporary + * accounts isn't recommended. You can only close an account from the AWS + * Billing and Cost Management console, and you must be signed in as the root + * user. For information on the requirements and process for closing an + * account, see Closing an AWS Account in the + * AWS Organizations User Guide.

    + *
  • + *
+ *
+ * + *

When you create a member account with this operation, you can choose whether to + * create the account with the IAM User and Role Access to + * Billing Information switch enabled. If you enable it, IAM users and + * roles that have appropriate permissions can view billing information for the + * account. If you disable it, only the account root user can access billing + * information. For information about how to disable this switch for an account, see + * Granting + * Access to Your Billing Information and Tools.

+ *
+ */ export class CreateGovCloudAccountCommand extends $Command< CreateGovCloudAccountCommandInput, CreateGovCloudAccountCommandOutput, @@ -34,6 +169,9 @@ export class CreateGovCloudAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/CreateOrganizationCommand.ts b/clients/client-organizations/commands/CreateOrganizationCommand.ts index 406ef16c8ac27..8748b0bcad553 100644 --- a/clients/client-organizations/commands/CreateOrganizationCommand.ts +++ b/clients/client-organizations/commands/CreateOrganizationCommand.ts @@ -20,6 +20,19 @@ import { export type CreateOrganizationCommandInput = CreateOrganizationRequest; export type CreateOrganizationCommandOutput = CreateOrganizationResponse & __MetadataBearer; +/** + *

Creates an AWS organization. The account whose user is calling the + * CreateOrganization operation automatically becomes the management account of the new organization.

+ *

This operation must be called using credentials from the account that is to become the + * new organization's management account. The principal must also have the relevant IAM + * permissions.

+ *

By default (or if you set the FeatureSet parameter to ALL), + * the new organization is created with all features enabled and service control policies + * automatically enabled in the root. If you instead choose to create the organization + * supporting only the consolidated billing features by setting the FeatureSet + * parameter to CONSOLIDATED_BILLING", no policy types are enabled by default, + * and you can't use organization policies

+ */ export class CreateOrganizationCommand extends $Command< CreateOrganizationCommandInput, CreateOrganizationCommandOutput, @@ -34,6 +47,9 @@ export class CreateOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/CreateOrganizationalUnitCommand.ts b/clients/client-organizations/commands/CreateOrganizationalUnitCommand.ts index 70f694ead9b16..73a1b4697191a 100644 --- a/clients/client-organizations/commands/CreateOrganizationalUnitCommand.ts +++ b/clients/client-organizations/commands/CreateOrganizationalUnitCommand.ts @@ -20,6 +20,19 @@ import { export type CreateOrganizationalUnitCommandInput = CreateOrganizationalUnitRequest; export type CreateOrganizationalUnitCommandOutput = CreateOrganizationalUnitResponse & __MetadataBearer; +/** + *

Creates an organizational unit (OU) within a root or parent OU. An OU is a container + * for accounts that enables you to organize your accounts to apply policies according to + * your business requirements. The number of levels deep that you can nest OUs is dependent + * upon the policy types enabled for that root. For service control policies, the limit is + * five.

+ *

For more information about OUs, see Managing Organizational Units in the + * AWS Organizations User Guide. + *

+ *

If the request includes tags, then the requester must have the + * organizations:TagResource permission.

+ *

This operation can be called only from the organization's management account.

+ */ export class CreateOrganizationalUnitCommand extends $Command< CreateOrganizationalUnitCommandInput, CreateOrganizationalUnitCommandOutput, @@ -34,6 +47,9 @@ export class CreateOrganizationalUnitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/CreatePolicyCommand.ts b/clients/client-organizations/commands/CreatePolicyCommand.ts index 41e54027a1089..129e54083173d 100644 --- a/clients/client-organizations/commands/CreatePolicyCommand.ts +++ b/clients/client-organizations/commands/CreatePolicyCommand.ts @@ -20,6 +20,15 @@ import { export type CreatePolicyCommandInput = CreatePolicyRequest; export type CreatePolicyCommandOutput = CreatePolicyResponse & __MetadataBearer; +/** + *

Creates a policy of a specified type that you can attach to a root, an organizational + * unit (OU), or an individual AWS account.

+ *

For more information about policies and their use, see Managing + * Organization Policies.

+ *

If the request includes tags, then the requester must have the + * organizations:TagResource permission.

+ *

This operation can be called only from the organization's management account.

+ */ export class CreatePolicyCommand extends $Command< CreatePolicyCommandInput, CreatePolicyCommandOutput, @@ -34,6 +43,9 @@ export class CreatePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DeclineHandshakeCommand.ts b/clients/client-organizations/commands/DeclineHandshakeCommand.ts index 7cb841d319128..8c3b0811853ae 100644 --- a/clients/client-organizations/commands/DeclineHandshakeCommand.ts +++ b/clients/client-organizations/commands/DeclineHandshakeCommand.ts @@ -20,6 +20,15 @@ import { export type DeclineHandshakeCommandInput = DeclineHandshakeRequest; export type DeclineHandshakeCommandOutput = DeclineHandshakeResponse & __MetadataBearer; +/** + *

Declines a handshake request. This sets the handshake state to DECLINED + * and effectively deactivates the request.

+ *

This operation can be called only from the account that received the handshake. The originator of the handshake can use CancelHandshake + * instead. The originator can't reactivate a declined request, but can reinitiate the + * process with a new handshake request.

+ *

After you decline a handshake, it continues to appear in the results of relevant APIs + * for only 30 days. After that, it's deleted.

+ */ export class DeclineHandshakeCommand extends $Command< DeclineHandshakeCommandInput, DeclineHandshakeCommandOutput, @@ -34,6 +43,9 @@ export class DeclineHandshakeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DeleteOrganizationCommand.ts b/clients/client-organizations/commands/DeleteOrganizationCommand.ts index d912619a189c1..68810d261caa7 100644 --- a/clients/client-organizations/commands/DeleteOrganizationCommand.ts +++ b/clients/client-organizations/commands/DeleteOrganizationCommand.ts @@ -19,6 +19,10 @@ import { export type DeleteOrganizationCommandInput = {}; export type DeleteOrganizationCommandOutput = __MetadataBearer; +/** + *

Deletes the organization. You can delete an organization only by using credentials + * from the management account. The organization must be empty of member accounts.

+ */ export class DeleteOrganizationCommand extends $Command< DeleteOrganizationCommandInput, DeleteOrganizationCommandOutput, @@ -33,6 +37,9 @@ export class DeleteOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DeleteOrganizationalUnitCommand.ts b/clients/client-organizations/commands/DeleteOrganizationalUnitCommand.ts index efc1e05c9c573..6325188c084a8 100644 --- a/clients/client-organizations/commands/DeleteOrganizationalUnitCommand.ts +++ b/clients/client-organizations/commands/DeleteOrganizationalUnitCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteOrganizationalUnitCommandInput = DeleteOrganizationalUnitRequest; export type DeleteOrganizationalUnitCommandOutput = __MetadataBearer; +/** + *

Deletes an organizational unit (OU) from a root or another OU. You must first remove + * all accounts and child OUs from the OU that you want to delete.

+ *

This operation can be called only from the organization's management account.

+ */ export class DeleteOrganizationalUnitCommand extends $Command< DeleteOrganizationalUnitCommandInput, DeleteOrganizationalUnitCommandOutput, @@ -34,6 +39,9 @@ export class DeleteOrganizationalUnitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DeletePolicyCommand.ts b/clients/client-organizations/commands/DeletePolicyCommand.ts index da000fe17c6d0..a6b3184f78aa9 100644 --- a/clients/client-organizations/commands/DeletePolicyCommand.ts +++ b/clients/client-organizations/commands/DeletePolicyCommand.ts @@ -20,6 +20,12 @@ import { export type DeletePolicyCommandInput = DeletePolicyRequest; export type DeletePolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the specified policy from your organization. Before you perform this + * operation, you must first detach the policy from all organizational units (OUs), roots, + * and accounts.

+ *

This operation can be called only from the organization's management account.

+ */ export class DeletePolicyCommand extends $Command< DeletePolicyCommandInput, DeletePolicyCommandOutput, @@ -34,6 +40,9 @@ export class DeletePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DeregisterDelegatedAdministratorCommand.ts b/clients/client-organizations/commands/DeregisterDelegatedAdministratorCommand.ts index 8babd4e559e20..2ec3715028080 100644 --- a/clients/client-organizations/commands/DeregisterDelegatedAdministratorCommand.ts +++ b/clients/client-organizations/commands/DeregisterDelegatedAdministratorCommand.ts @@ -20,6 +20,22 @@ import { export type DeregisterDelegatedAdministratorCommandInput = DeregisterDelegatedAdministratorRequest; export type DeregisterDelegatedAdministratorCommandOutput = __MetadataBearer; +/** + *

Removes the specified member AWS account as a delegated administrator for the + * specified AWS service.

+ * + *

Deregistering a delegated administrator can have unintended impacts on the + * functionality of the enabled AWS service. See the documentation for the enabled + * service before you deregister a delegated administrator so that you understand any + * potential impacts.

+ *
+ *

You can run this action only for AWS services that support this + * feature. For a current list of services that support it, see the column Supports + * Delegated Administrator in the table at AWS Services that you can use with + * AWS Organizations in the AWS Organizations User Guide. + *

+ *

This operation can be called only from the organization's management account.

+ */ export class DeregisterDelegatedAdministratorCommand extends $Command< DeregisterDelegatedAdministratorCommandInput, DeregisterDelegatedAdministratorCommandOutput, @@ -34,6 +50,9 @@ export class DeregisterDelegatedAdministratorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DescribeAccountCommand.ts b/clients/client-organizations/commands/DescribeAccountCommand.ts index f10b63842cd90..9fdefa97875d3 100644 --- a/clients/client-organizations/commands/DescribeAccountCommand.ts +++ b/clients/client-organizations/commands/DescribeAccountCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAccountCommandInput = DescribeAccountRequest; export type DescribeAccountCommandOutput = DescribeAccountResponse & __MetadataBearer; +/** + *

Retrieves AWS Organizations-related information about the specified account.

+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class DescribeAccountCommand extends $Command< DescribeAccountCommandInput, DescribeAccountCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DescribeCreateAccountStatusCommand.ts b/clients/client-organizations/commands/DescribeCreateAccountStatusCommand.ts index 5e52168bcb0ee..3c5250203cbb0 100644 --- a/clients/client-organizations/commands/DescribeCreateAccountStatusCommand.ts +++ b/clients/client-organizations/commands/DescribeCreateAccountStatusCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeCreateAccountStatusCommandInput = DescribeCreateAccountStatusRequest; export type DescribeCreateAccountStatusCommandOutput = DescribeCreateAccountStatusResponse & __MetadataBearer; +/** + *

Retrieves the current status of an asynchronous request to create an account.

+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class DescribeCreateAccountStatusCommand extends $Command< DescribeCreateAccountStatusCommandInput, DescribeCreateAccountStatusCommandOutput, @@ -34,6 +39,9 @@ export class DescribeCreateAccountStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DescribeEffectivePolicyCommand.ts b/clients/client-organizations/commands/DescribeEffectivePolicyCommand.ts index ee1957422f8e4..ac604c0a7340e 100644 --- a/clients/client-organizations/commands/DescribeEffectivePolicyCommand.ts +++ b/clients/client-organizations/commands/DescribeEffectivePolicyCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeEffectivePolicyCommandInput = DescribeEffectivePolicyRequest; export type DescribeEffectivePolicyCommandOutput = DescribeEffectivePolicyResponse & __MetadataBearer; +/** + *

Returns the contents of the effective policy for specified policy type and account. + * The effective policy is the aggregation of any policies of the specified type that the + * account inherits, plus any policy of that type that is directly attached to the + * account.

+ *

This operation applies only to policy types other than service + * control policies (SCPs).

+ *

For more information about policy inheritance, see How Policy Inheritance + * Works in the AWS Organizations User Guide.

+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class DescribeEffectivePolicyCommand extends $Command< DescribeEffectivePolicyCommandInput, DescribeEffectivePolicyCommandOutput, @@ -34,6 +46,9 @@ export class DescribeEffectivePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DescribeHandshakeCommand.ts b/clients/client-organizations/commands/DescribeHandshakeCommand.ts index 6e5e89ad66947..e03b301c039eb 100644 --- a/clients/client-organizations/commands/DescribeHandshakeCommand.ts +++ b/clients/client-organizations/commands/DescribeHandshakeCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeHandshakeCommandInput = DescribeHandshakeRequest; export type DescribeHandshakeCommandOutput = DescribeHandshakeResponse & __MetadataBearer; +/** + *

Retrieves information about a previously requested handshake. The handshake ID comes + * from the response to the original InviteAccountToOrganization + * operation that generated the handshake.

+ *

You can access handshakes that are ACCEPTED, DECLINED, or + * CANCELED for only 30 days after they change to that state. They're then + * deleted and no longer accessible.

+ *

This operation can be called from any account in the organization.

+ */ export class DescribeHandshakeCommand extends $Command< DescribeHandshakeCommandInput, DescribeHandshakeCommandOutput, @@ -34,6 +43,9 @@ export class DescribeHandshakeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DescribeOrganizationCommand.ts b/clients/client-organizations/commands/DescribeOrganizationCommand.ts index 661eb357c5b1c..04a9081472718 100644 --- a/clients/client-organizations/commands/DescribeOrganizationCommand.ts +++ b/clients/client-organizations/commands/DescribeOrganizationCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeOrganizationCommandInput = {}; export type DescribeOrganizationCommandOutput = DescribeOrganizationResponse & __MetadataBearer; +/** + *

Retrieves information about the organization that the user's account belongs + * to.

+ *

This operation can be called from any account in the organization.

+ * + *

Even if a policy type is shown as available in the organization, you can disable + * it separately at the root level with DisablePolicyType. Use ListRoots to see the status of policy types for a specified + * root.

+ *
+ */ export class DescribeOrganizationCommand extends $Command< DescribeOrganizationCommandInput, DescribeOrganizationCommandOutput, @@ -34,6 +44,9 @@ export class DescribeOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DescribeOrganizationalUnitCommand.ts b/clients/client-organizations/commands/DescribeOrganizationalUnitCommand.ts index a7029424d9ad1..fd70946e27215 100644 --- a/clients/client-organizations/commands/DescribeOrganizationalUnitCommand.ts +++ b/clients/client-organizations/commands/DescribeOrganizationalUnitCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeOrganizationalUnitCommandInput = DescribeOrganizationalUnitRequest; export type DescribeOrganizationalUnitCommandOutput = DescribeOrganizationalUnitResponse & __MetadataBearer; +/** + *

Retrieves information about an organizational unit (OU).

+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class DescribeOrganizationalUnitCommand extends $Command< DescribeOrganizationalUnitCommandInput, DescribeOrganizationalUnitCommandOutput, @@ -34,6 +39,9 @@ export class DescribeOrganizationalUnitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DescribePolicyCommand.ts b/clients/client-organizations/commands/DescribePolicyCommand.ts index 307eb72b12ea0..0aee575c212b9 100644 --- a/clients/client-organizations/commands/DescribePolicyCommand.ts +++ b/clients/client-organizations/commands/DescribePolicyCommand.ts @@ -20,6 +20,11 @@ import { export type DescribePolicyCommandInput = DescribePolicyRequest; export type DescribePolicyCommandOutput = DescribePolicyResponse & __MetadataBearer; +/** + *

Retrieves information about a policy.

+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class DescribePolicyCommand extends $Command< DescribePolicyCommandInput, DescribePolicyCommandOutput, @@ -34,6 +39,9 @@ export class DescribePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DetachPolicyCommand.ts b/clients/client-organizations/commands/DetachPolicyCommand.ts index 6fe556d4125fb..98192e29f6722 100644 --- a/clients/client-organizations/commands/DetachPolicyCommand.ts +++ b/clients/client-organizations/commands/DetachPolicyCommand.ts @@ -20,6 +20,23 @@ import { export type DetachPolicyCommandInput = DetachPolicyRequest; export type DetachPolicyCommandOutput = __MetadataBearer; +/** + *

Detaches a policy from a target root, organizational unit (OU), or account.

+ * + *

If the policy being detached is a service control policy (SCP), the changes to + * permissions for AWS Identity and Access Management (IAM) users and roles in affected accounts are + * immediate.

+ *
+ *

Every root, OU, and account must have at least one SCP attached. If you want to + * replace the default FullAWSAccess policy with an SCP that limits the + * permissions that can be delegated, you must attach the replacement SCP before you can + * remove the default SCP. This is the authorization strategy of an "allow list". If you instead attach a second SCP and + * leave the FullAWSAccess SCP still attached, and specify "Effect": + * "Deny" in the second SCP to override the "Effect": "Allow" in + * the FullAWSAccess policy (or any other attached SCP), you're using the + * authorization strategy of a "deny list".

+ *

This operation can be called only from the organization's management account.

+ */ export class DetachPolicyCommand extends $Command< DetachPolicyCommandInput, DetachPolicyCommandOutput, @@ -34,6 +51,9 @@ export class DetachPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DisableAWSServiceAccessCommand.ts b/clients/client-organizations/commands/DisableAWSServiceAccessCommand.ts index 0f42423623bd6..81d0089f5d745 100644 --- a/clients/client-organizations/commands/DisableAWSServiceAccessCommand.ts +++ b/clients/client-organizations/commands/DisableAWSServiceAccessCommand.ts @@ -20,6 +20,33 @@ import { export type DisableAWSServiceAccessCommandInput = DisableAWSServiceAccessRequest; export type DisableAWSServiceAccessCommandOutput = __MetadataBearer; +/** + *

Disables the integration of an AWS service (the service that is specified by + * ServicePrincipal) with AWS Organizations. When you disable integration, the + * specified service no longer can create a service-linked role in + * new accounts in your organization. This means the service can't + * perform operations on your behalf on any new accounts in your organization. The service + * can still perform operations in older accounts until the service completes its clean-up + * from AWS Organizations.

+ *

+ * + *

We recommend that you disable integration between AWS Organizations and the specified AWS + * service by using the console or commands that are provided by the specified service. + * Doing so ensures that the other service is aware that it can clean up any resources + * that are required only for the integration. How the service cleans up its resources + * in the organization's accounts depends on that service. For more information, see + * the documentation for the other AWS service.

+ *
+ *

After you perform the DisableAWSServiceAccess operation, the specified + * service can no longer perform operations in your organization's accounts unless the + * operations are explicitly permitted by the IAM policies that are attached to your + * roles.

+ *

For more information about integrating other services with AWS Organizations, including the + * list of services that work with Organizations, see Integrating AWS Organizations with Other + * AWS Services in the AWS Organizations User Guide. + *

+ *

This operation can be called only from the organization's management account.

+ */ export class DisableAWSServiceAccessCommand extends $Command< DisableAWSServiceAccessCommandInput, DisableAWSServiceAccessCommandOutput, @@ -34,6 +61,9 @@ export class DisableAWSServiceAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/DisablePolicyTypeCommand.ts b/clients/client-organizations/commands/DisablePolicyTypeCommand.ts index 27881b60d3b9a..64e2854eba27e 100644 --- a/clients/client-organizations/commands/DisablePolicyTypeCommand.ts +++ b/clients/client-organizations/commands/DisablePolicyTypeCommand.ts @@ -20,6 +20,19 @@ import { export type DisablePolicyTypeCommandInput = DisablePolicyTypeRequest; export type DisablePolicyTypeCommandOutput = DisablePolicyTypeResponse & __MetadataBearer; +/** + *

Disables an organizational policy type in a root. A policy of a certain type can be + * attached to entities in a root only if that type is enabled in the root. After you + * perform this operation, you no longer can attach policies of the specified type to that + * root or to any organizational unit (OU) or account in that root. You can undo this by + * using the EnablePolicyType operation.

+ *

This is an asynchronous request that AWS performs in the background. If you disable + * a policy type for a root, it still appears enabled for the organization if all features are enabled for the organization. AWS recommends that you + * first use ListRoots to see the status of policy types for a specified + * root, and then use this operation.

+ *

This operation can be called only from the organization's management account.

+ *

To view the status of available policy types in the organization, use DescribeOrganization.

+ */ export class DisablePolicyTypeCommand extends $Command< DisablePolicyTypeCommandInput, DisablePolicyTypeCommandOutput, @@ -34,6 +47,9 @@ export class DisablePolicyTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/EnableAWSServiceAccessCommand.ts b/clients/client-organizations/commands/EnableAWSServiceAccessCommand.ts index 2c8a93fc24301..f65a16161b400 100644 --- a/clients/client-organizations/commands/EnableAWSServiceAccessCommand.ts +++ b/clients/client-organizations/commands/EnableAWSServiceAccessCommand.ts @@ -20,6 +20,27 @@ import { export type EnableAWSServiceAccessCommandInput = EnableAWSServiceAccessRequest; export type EnableAWSServiceAccessCommandOutput = __MetadataBearer; +/** + *

Enables the integration of an AWS service (the service that is specified by + * ServicePrincipal) with AWS Organizations. When you enable integration, you allow + * the specified service to create a service-linked role in + * all the accounts in your organization. This allows the service to perform operations on + * your behalf in your organization and its accounts.

+ * + *

We recommend that you enable integration between AWS Organizations and the specified AWS + * service by using the console or commands that are provided by the specified service. + * Doing so ensures that the service is aware that it can create the resources that are + * required for the integration. How the service creates those resources in the + * organization's accounts depends on that service. For more information, see the + * documentation for the other AWS service.

+ *
+ *

For more information about enabling services to integrate with AWS Organizations, see Integrating AWS Organizations with Other + * AWS Services in the AWS Organizations User Guide. + *

+ *

This operation can be called only from the organization's management account and only + * if the organization has enabled all + * features.

+ */ export class EnableAWSServiceAccessCommand extends $Command< EnableAWSServiceAccessCommandInput, EnableAWSServiceAccessCommandOutput, @@ -34,6 +55,9 @@ export class EnableAWSServiceAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/EnableAllFeaturesCommand.ts b/clients/client-organizations/commands/EnableAllFeaturesCommand.ts index c5822a9617ac3..0295f0af7c14a 100644 --- a/clients/client-organizations/commands/EnableAllFeaturesCommand.ts +++ b/clients/client-organizations/commands/EnableAllFeaturesCommand.ts @@ -20,6 +20,34 @@ import { export type EnableAllFeaturesCommandInput = EnableAllFeaturesRequest; export type EnableAllFeaturesCommandOutput = EnableAllFeaturesResponse & __MetadataBearer; +/** + *

Enables all features in an organization. This enables the use of organization policies + * that can restrict the services and actions that can be called in each account. Until you + * enable all features, you have access only to consolidated billing, and you can't use any + * of the advanced account administration features that AWS Organizations supports. For more + * information, see Enabling All Features in Your Organization in the + * AWS Organizations User Guide. + *

+ * + *

This operation is required only for organizations that were created explicitly + * with only the consolidated billing features enabled. Calling this operation sends a + * handshake to every invited account in the organization. The feature set change can + * be finalized and the additional features enabled only after all administrators in + * the invited accounts approve the change by accepting the handshake.

+ *
+ *

After you enable all features, you can separately enable or disable individual policy + * types in a root using EnablePolicyType and DisablePolicyType. To see the status of policy types in a root, use + * ListRoots.

+ *

After all invited member accounts accept the handshake, you finalize the feature set + * change by accepting the handshake that contains "Action": + * "ENABLE_ALL_FEATURES". This completes the change.

+ *

After you enable all features in your organization, the management account in the + * organization can apply policies on all member accounts. These policies can restrict what + * users and even administrators in those accounts can do. The management account can apply + * policies that prevent accounts from leaving the organization. Ensure that your account + * administrators are aware of this.

+ *

This operation can be called only from the organization's management account.

+ */ export class EnableAllFeaturesCommand extends $Command< EnableAllFeaturesCommandInput, EnableAllFeaturesCommandOutput, @@ -34,6 +62,9 @@ export class EnableAllFeaturesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/EnablePolicyTypeCommand.ts b/clients/client-organizations/commands/EnablePolicyTypeCommand.ts index 5bebaa5584c30..7353da7ce95c1 100644 --- a/clients/client-organizations/commands/EnablePolicyTypeCommand.ts +++ b/clients/client-organizations/commands/EnablePolicyTypeCommand.ts @@ -20,6 +20,19 @@ import { export type EnablePolicyTypeCommandInput = EnablePolicyTypeRequest; export type EnablePolicyTypeCommandOutput = EnablePolicyTypeResponse & __MetadataBearer; +/** + *

Enables a policy type in a root. After you enable a policy type in a root, you can + * attach policies of that type to the root, any organizational unit (OU), or account in + * that root. You can undo this by using the DisablePolicyType + * operation.

+ *

This is an asynchronous request that AWS performs in the background. AWS + * recommends that you first use ListRoots to see the status of policy + * types for a specified root, and then use this operation.

+ *

This operation can be called only from the organization's management account.

+ *

You can enable a policy type in a root only if that policy type is available in the + * organization. To view the status of available policy types in the organization, use + * DescribeOrganization.

+ */ export class EnablePolicyTypeCommand extends $Command< EnablePolicyTypeCommandInput, EnablePolicyTypeCommandOutput, @@ -34,6 +47,9 @@ export class EnablePolicyTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/InviteAccountToOrganizationCommand.ts b/clients/client-organizations/commands/InviteAccountToOrganizationCommand.ts index 2fc632ab90af3..c4bbd01860415 100644 --- a/clients/client-organizations/commands/InviteAccountToOrganizationCommand.ts +++ b/clients/client-organizations/commands/InviteAccountToOrganizationCommand.ts @@ -20,6 +20,34 @@ import { export type InviteAccountToOrganizationCommandInput = InviteAccountToOrganizationRequest; export type InviteAccountToOrganizationCommandOutput = InviteAccountToOrganizationResponse & __MetadataBearer; +/** + *

Sends an invitation to another account to join your organization as a member account. + * AWS Organizations sends email on your behalf to the email address that is associated with the + * other account's owner. The invitation is implemented as a Handshake + * whose details are in the response.

+ * + *
    + *
  • + *

    You can invite AWS accounts only from the same seller as the + * management account. For example, if your organization's management account was + * created by Amazon Internet Services Pvt. Ltd (AISPL), an AWS seller in + * India, you can invite only other AISPL accounts to your organization. You + * can't combine accounts from AISPL and AWS or from any other AWS seller. + * For more information, see Consolidated + * Billing in India.

    + *
  • + *
  • + *

    If you receive an exception that indicates that you exceeded your account + * limits for the organization or that the operation failed because your + * organization is still initializing, wait one hour and then try again. If the + * error persists after an hour, contact AWS Support.

    + *
  • + *
+ *
+ *

If the request includes tags, then the requester must have the + * organizations:TagResource permission.

+ *

This operation can be called only from the organization's management account.

+ */ export class InviteAccountToOrganizationCommand extends $Command< InviteAccountToOrganizationCommandInput, InviteAccountToOrganizationCommandOutput, @@ -34,6 +62,9 @@ export class InviteAccountToOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/LeaveOrganizationCommand.ts b/clients/client-organizations/commands/LeaveOrganizationCommand.ts index 72c72a8f81dc4..c01074c8b86d7 100644 --- a/clients/client-organizations/commands/LeaveOrganizationCommand.ts +++ b/clients/client-organizations/commands/LeaveOrganizationCommand.ts @@ -19,6 +19,61 @@ import { export type LeaveOrganizationCommandInput = {}; export type LeaveOrganizationCommandOutput = __MetadataBearer; +/** + *

Removes a member account from its parent organization. This version of the operation + * is performed by the account that wants to leave. To remove a member account as a user in + * the management account, use RemoveAccountFromOrganization + * instead.

+ *

This operation can be called only from a member account in the organization.

+ * + *
    + *
  • + *

    The management account in an organization with all features enabled can set + * service control policies (SCPs) that can restrict what administrators of + * member accounts can do. This includes preventing them from successfully + * calling LeaveOrganization and leaving the organization.

    + *
  • + *
  • + *

    You can leave an organization as a member account only if the account is + * configured with the information required to operate as a standalone account. + * When you create an account in an organization using the AWS Organizations console, + * API, or CLI commands, the information required of standalone accounts is + * not automatically collected. For each account that + * you want to make standalone, you must perform the following steps. If any of + * the steps are already completed for this account, that step doesn't + * appear.

    + *
      + *
    • + *

      Choose a support plan

      + *
    • + *
    • + *

      Provide and verify the required contact information

      + *
    • + *
    • + *

      Provide a current payment method

      + *
    • + *
    + *

    AWS uses the payment method to charge for any billable (not free tier) + * AWS activity that occurs while the account isn't attached to an + * organization. Follow the steps at To leave an organization when all required account information has not + * yet been provided in the + * AWS Organizations User Guide. + *

    + *
  • + *
  • + *

    You can leave an organization only after you enable IAM user access to + * billing in your account. For more information, see Activating Access to the Billing and Cost Management Console in + * the AWS Billing and Cost Management User Guide. + *

    + *
  • + *
  • + *

    After the account leaves the organization, all tags that were attached to + * the account object in the organization are deleted. AWS accounts outside + * of an organization do not support tags.

    + *
  • + *
+ *
+ */ export class LeaveOrganizationCommand extends $Command< LeaveOrganizationCommandInput, LeaveOrganizationCommandOutput, @@ -33,6 +88,9 @@ export class LeaveOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListAWSServiceAccessForOrganizationCommand.ts b/clients/client-organizations/commands/ListAWSServiceAccessForOrganizationCommand.ts index f69f906eb8b00..749de73339744 100644 --- a/clients/client-organizations/commands/ListAWSServiceAccessForOrganizationCommand.ts +++ b/clients/client-organizations/commands/ListAWSServiceAccessForOrganizationCommand.ts @@ -24,6 +24,17 @@ export type ListAWSServiceAccessForOrganizationCommandInput = ListAWSServiceAcce export type ListAWSServiceAccessForOrganizationCommandOutput = ListAWSServiceAccessForOrganizationResponse & __MetadataBearer; +/** + *

Returns a list of the AWS services that you enabled to integrate with your + * organization. After a service on this list creates the resources that it requires for + * the integration, it can perform operations on your organization and its accounts.

+ *

For more information about integrating other services with AWS Organizations, including the + * list of services that currently work with Organizations, see Integrating AWS Organizations with Other + * AWS Services in the AWS Organizations User Guide. + *

+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListAWSServiceAccessForOrganizationCommand extends $Command< ListAWSServiceAccessForOrganizationCommandInput, ListAWSServiceAccessForOrganizationCommandOutput, @@ -38,6 +49,9 @@ export class ListAWSServiceAccessForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListAccountsCommand.ts b/clients/client-organizations/commands/ListAccountsCommand.ts index 3b23c33f56a05..d99faaa5a1aa2 100644 --- a/clients/client-organizations/commands/ListAccountsCommand.ts +++ b/clients/client-organizations/commands/ListAccountsCommand.ts @@ -20,6 +20,20 @@ import { export type ListAccountsCommandInput = ListAccountsRequest; export type ListAccountsCommandOutput = ListAccountsResponse & __MetadataBearer; +/** + *

Lists all the accounts in the organization. To request only the accounts in a + * specified root or organizational unit (OU), use the ListAccountsForParent operation instead.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListAccountsCommand extends $Command< ListAccountsCommandInput, ListAccountsCommandOutput, @@ -34,6 +48,9 @@ export class ListAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListAccountsForParentCommand.ts b/clients/client-organizations/commands/ListAccountsForParentCommand.ts index 89e794a8df4d2..e27ac4e28dde7 100644 --- a/clients/client-organizations/commands/ListAccountsForParentCommand.ts +++ b/clients/client-organizations/commands/ListAccountsForParentCommand.ts @@ -20,6 +20,23 @@ import { export type ListAccountsForParentCommandInput = ListAccountsForParentRequest; export type ListAccountsForParentCommandOutput = ListAccountsForParentResponse & __MetadataBearer; +/** + *

Lists the accounts in an organization that are contained by the specified target root + * or organizational unit (OU). If you specify the root, you get a list of all the accounts + * that aren't in any OU. If you specify an OU, you get a list of all the accounts in only + * that OU and not in any child OUs. To get a list of all accounts in the organization, use + * the ListAccounts operation.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListAccountsForParentCommand extends $Command< ListAccountsForParentCommandInput, ListAccountsForParentCommandOutput, @@ -34,6 +51,9 @@ export class ListAccountsForParentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListChildrenCommand.ts b/clients/client-organizations/commands/ListChildrenCommand.ts index 8ed0a547556ea..852deef4d6669 100644 --- a/clients/client-organizations/commands/ListChildrenCommand.ts +++ b/clients/client-organizations/commands/ListChildrenCommand.ts @@ -20,6 +20,21 @@ import { export type ListChildrenCommandInput = ListChildrenRequest; export type ListChildrenCommandOutput = ListChildrenResponse & __MetadataBearer; +/** + *

Lists all of the organizational units (OUs) or accounts that are contained in the + * specified parent OU or root. This operation, along with ListParents + * enables you to traverse the tree structure that makes up this root.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListChildrenCommand extends $Command< ListChildrenCommandInput, ListChildrenCommandOutput, @@ -34,6 +49,9 @@ export class ListChildrenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListCreateAccountStatusCommand.ts b/clients/client-organizations/commands/ListCreateAccountStatusCommand.ts index 9126ca555bbdb..994b7c2929a73 100644 --- a/clients/client-organizations/commands/ListCreateAccountStatusCommand.ts +++ b/clients/client-organizations/commands/ListCreateAccountStatusCommand.ts @@ -20,6 +20,20 @@ import { export type ListCreateAccountStatusCommandInput = ListCreateAccountStatusRequest; export type ListCreateAccountStatusCommandOutput = ListCreateAccountStatusResponse & __MetadataBearer; +/** + *

Lists the account creation requests that match the specified status that is currently + * being tracked for the organization.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListCreateAccountStatusCommand extends $Command< ListCreateAccountStatusCommandInput, ListCreateAccountStatusCommandOutput, @@ -34,6 +48,9 @@ export class ListCreateAccountStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListDelegatedAdministratorsCommand.ts b/clients/client-organizations/commands/ListDelegatedAdministratorsCommand.ts index 5fed6acdd6c7f..06c87c0b08b45 100644 --- a/clients/client-organizations/commands/ListDelegatedAdministratorsCommand.ts +++ b/clients/client-organizations/commands/ListDelegatedAdministratorsCommand.ts @@ -20,6 +20,12 @@ import { export type ListDelegatedAdministratorsCommandInput = ListDelegatedAdministratorsRequest; export type ListDelegatedAdministratorsCommandOutput = ListDelegatedAdministratorsResponse & __MetadataBearer; +/** + *

Lists the AWS accounts that are designated as delegated administrators in this + * organization.

+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListDelegatedAdministratorsCommand extends $Command< ListDelegatedAdministratorsCommandInput, ListDelegatedAdministratorsCommandOutput, @@ -34,6 +40,9 @@ export class ListDelegatedAdministratorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListDelegatedServicesForAccountCommand.ts b/clients/client-organizations/commands/ListDelegatedServicesForAccountCommand.ts index 075fa3c85fba2..7ed11bdaada55 100644 --- a/clients/client-organizations/commands/ListDelegatedServicesForAccountCommand.ts +++ b/clients/client-organizations/commands/ListDelegatedServicesForAccountCommand.ts @@ -20,6 +20,12 @@ import { export type ListDelegatedServicesForAccountCommandInput = ListDelegatedServicesForAccountRequest; export type ListDelegatedServicesForAccountCommandOutput = ListDelegatedServicesForAccountResponse & __MetadataBearer; +/** + *

List the AWS services for which the specified account is a delegated + * administrator.

+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListDelegatedServicesForAccountCommand extends $Command< ListDelegatedServicesForAccountCommandInput, ListDelegatedServicesForAccountCommandOutput, @@ -34,6 +40,9 @@ export class ListDelegatedServicesForAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListHandshakesForAccountCommand.ts b/clients/client-organizations/commands/ListHandshakesForAccountCommand.ts index 43dacab16162b..1e8465ad42533 100644 --- a/clients/client-organizations/commands/ListHandshakesForAccountCommand.ts +++ b/clients/client-organizations/commands/ListHandshakesForAccountCommand.ts @@ -20,6 +20,22 @@ import { export type ListHandshakesForAccountCommandInput = ListHandshakesForAccountRequest; export type ListHandshakesForAccountCommandOutput = ListHandshakesForAccountResponse & __MetadataBearer; +/** + *

Lists the current handshakes that are associated with the account of the requesting + * user.

+ *

Handshakes that are ACCEPTED, DECLINED, or + * CANCELED appear in the results of this API for only 30 days after + * changing to that state. After that, they're deleted and no longer accessible.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called from any account in the organization.

+ */ export class ListHandshakesForAccountCommand extends $Command< ListHandshakesForAccountCommandInput, ListHandshakesForAccountCommandOutput, @@ -34,6 +50,9 @@ export class ListHandshakesForAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListHandshakesForOrganizationCommand.ts b/clients/client-organizations/commands/ListHandshakesForOrganizationCommand.ts index 68606bfc5970c..270cd3fb3db51 100644 --- a/clients/client-organizations/commands/ListHandshakesForOrganizationCommand.ts +++ b/clients/client-organizations/commands/ListHandshakesForOrganizationCommand.ts @@ -20,6 +20,25 @@ import { export type ListHandshakesForOrganizationCommandInput = ListHandshakesForOrganizationRequest; export type ListHandshakesForOrganizationCommandOutput = ListHandshakesForOrganizationResponse & __MetadataBearer; +/** + *

Lists the handshakes that are associated with the organization that the requesting + * user is part of. The ListHandshakesForOrganization operation returns a list + * of handshake structures. Each structure contains details and status about a + * handshake.

+ *

Handshakes that are ACCEPTED, DECLINED, or + * CANCELED appear in the results of this API for only 30 days after + * changing to that state. After that, they're deleted and no longer accessible.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListHandshakesForOrganizationCommand extends $Command< ListHandshakesForOrganizationCommandInput, ListHandshakesForOrganizationCommandOutput, @@ -34,6 +53,9 @@ export class ListHandshakesForOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListOrganizationalUnitsForParentCommand.ts b/clients/client-organizations/commands/ListOrganizationalUnitsForParentCommand.ts index aec64b3849a98..44c9606b5d59a 100644 --- a/clients/client-organizations/commands/ListOrganizationalUnitsForParentCommand.ts +++ b/clients/client-organizations/commands/ListOrganizationalUnitsForParentCommand.ts @@ -20,6 +20,19 @@ import { export type ListOrganizationalUnitsForParentCommandInput = ListOrganizationalUnitsForParentRequest; export type ListOrganizationalUnitsForParentCommandOutput = ListOrganizationalUnitsForParentResponse & __MetadataBearer; +/** + *

Lists the organizational units (OUs) in a parent organizational unit or root.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListOrganizationalUnitsForParentCommand extends $Command< ListOrganizationalUnitsForParentCommandInput, ListOrganizationalUnitsForParentCommandOutput, @@ -34,6 +47,9 @@ export class ListOrganizationalUnitsForParentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListParentsCommand.ts b/clients/client-organizations/commands/ListParentsCommand.ts index 287e44700e3aa..90b1f644ebf66 100644 --- a/clients/client-organizations/commands/ListParentsCommand.ts +++ b/clients/client-organizations/commands/ListParentsCommand.ts @@ -20,6 +20,24 @@ import { export type ListParentsCommandInput = ListParentsRequest; export type ListParentsCommandOutput = ListParentsResponse & __MetadataBearer; +/** + *

Lists the root or organizational units (OUs) that serve as the immediate parent of the + * specified child OU or account. This operation, along with ListChildren + * enables you to traverse the tree structure that makes up this root.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ * + *

In the current release, a child can have only a single parent.

+ *
+ */ export class ListParentsCommand extends $Command< ListParentsCommandInput, ListParentsCommandOutput, @@ -34,6 +52,9 @@ export class ListParentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListPoliciesCommand.ts b/clients/client-organizations/commands/ListPoliciesCommand.ts index 1c7d0721a1289..f5346076a9712 100644 --- a/clients/client-organizations/commands/ListPoliciesCommand.ts +++ b/clients/client-organizations/commands/ListPoliciesCommand.ts @@ -20,6 +20,19 @@ import { export type ListPoliciesCommandInput = ListPoliciesRequest; export type ListPoliciesCommandOutput = ListPoliciesResponse & __MetadataBearer; +/** + *

Retrieves the list of all policies in an organization of a specified type.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListPoliciesCommand extends $Command< ListPoliciesCommandInput, ListPoliciesCommandOutput, @@ -34,6 +47,9 @@ export class ListPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListPoliciesForTargetCommand.ts b/clients/client-organizations/commands/ListPoliciesForTargetCommand.ts index 165a22dd3cbe8..7754acc85a2b2 100644 --- a/clients/client-organizations/commands/ListPoliciesForTargetCommand.ts +++ b/clients/client-organizations/commands/ListPoliciesForTargetCommand.ts @@ -20,6 +20,21 @@ import { export type ListPoliciesForTargetCommandInput = ListPoliciesForTargetRequest; export type ListPoliciesForTargetCommandOutput = ListPoliciesForTargetResponse & __MetadataBearer; +/** + *

Lists the policies that are directly attached to the specified target root, + * organizational unit (OU), or account. You must specify the policy type that you want + * included in the returned list.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListPoliciesForTargetCommand extends $Command< ListPoliciesForTargetCommandInput, ListPoliciesForTargetCommandOutput, @@ -34,6 +49,9 @@ export class ListPoliciesForTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListRootsCommand.ts b/clients/client-organizations/commands/ListRootsCommand.ts index 0c57bd61f2064..d11409831e6f2 100644 --- a/clients/client-organizations/commands/ListRootsCommand.ts +++ b/clients/client-organizations/commands/ListRootsCommand.ts @@ -17,6 +17,26 @@ import { export type ListRootsCommandInput = ListRootsRequest; export type ListRootsCommandOutput = ListRootsResponse & __MetadataBearer; +/** + *

Lists the roots that are defined in the current organization.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ * + *

Policy types can be enabled and disabled in roots. This is distinct from whether + * they're available in the organization. When you enable all features, you make policy + * types available for use in that organization. Individual policy types can then be + * enabled and disabled in a root. To see the availability of a policy type in an + * organization, use DescribeOrganization.

+ *
+ */ export class ListRootsCommand extends $Command< ListRootsCommandInput, ListRootsCommandOutput, @@ -31,6 +51,9 @@ export class ListRootsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListTagsForResourceCommand.ts b/clients/client-organizations/commands/ListTagsForResourceCommand.ts index 3dcdbcf24bb1f..a9cca568c4bbc 100644 --- a/clients/client-organizations/commands/ListTagsForResourceCommand.ts +++ b/clients/client-organizations/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,26 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists tags that are attached to the specified resource.

+ *

You can attach tags to the following resources in AWS Organizations.

+ *
    + *
  • + *

    AWS account

    + *
  • + *
  • + *

    Organization root

    + *
  • + *
  • + *

    Organizational unit (OU)

    + *
  • + *
  • + *

    Policy (any type)

    + *
  • + *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +54,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/ListTargetsForPolicyCommand.ts b/clients/client-organizations/commands/ListTargetsForPolicyCommand.ts index 034d54da1f608..d7f5edd6f1b1c 100644 --- a/clients/client-organizations/commands/ListTargetsForPolicyCommand.ts +++ b/clients/client-organizations/commands/ListTargetsForPolicyCommand.ts @@ -20,6 +20,20 @@ import { export type ListTargetsForPolicyCommandInput = ListTargetsForPolicyRequest; export type ListTargetsForPolicyCommandOutput = ListTargetsForPolicyResponse & __MetadataBearer; +/** + *

Lists all the roots, organizational units (OUs), and accounts that the specified + * policy is attached to.

+ * + *

Always check the NextToken response parameter + * for a null value when calling a List* operation. These operations can + * occasionally return an empty set of results even when there are more results available. The + * NextToken response parameter value is null + * only + * when there are no more results to display.

+ *
+ *

This operation can be called only from the organization's + * management account or by a member account that is a delegated administrator for an AWS service.

+ */ export class ListTargetsForPolicyCommand extends $Command< ListTargetsForPolicyCommandInput, ListTargetsForPolicyCommandOutput, @@ -34,6 +48,9 @@ export class ListTargetsForPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/MoveAccountCommand.ts b/clients/client-organizations/commands/MoveAccountCommand.ts index 9c360d5ad12b5..97e5f7df58127 100644 --- a/clients/client-organizations/commands/MoveAccountCommand.ts +++ b/clients/client-organizations/commands/MoveAccountCommand.ts @@ -20,6 +20,11 @@ import { export type MoveAccountCommandInput = MoveAccountRequest; export type MoveAccountCommandOutput = __MetadataBearer; +/** + *

Moves an account from its current source parent root or organizational unit (OU) to + * the specified destination parent root or OU.

+ *

This operation can be called only from the organization's management account.

+ */ export class MoveAccountCommand extends $Command< MoveAccountCommandInput, MoveAccountCommandOutput, @@ -34,6 +39,9 @@ export class MoveAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/RegisterDelegatedAdministratorCommand.ts b/clients/client-organizations/commands/RegisterDelegatedAdministratorCommand.ts index 868ca90ad7c8b..683b780ebe6f1 100644 --- a/clients/client-organizations/commands/RegisterDelegatedAdministratorCommand.ts +++ b/clients/client-organizations/commands/RegisterDelegatedAdministratorCommand.ts @@ -20,6 +20,17 @@ import { export type RegisterDelegatedAdministratorCommandInput = RegisterDelegatedAdministratorRequest; export type RegisterDelegatedAdministratorCommandOutput = __MetadataBearer; +/** + *

Enables the specified member account to administer the Organizations features of the specified + * AWS service. It grants read-only access to AWS Organizations service data. The account still + * requires IAM permissions to access and administer the AWS service.

+ *

You can run this action only for AWS services that support this + * feature. For a current list of services that support it, see the column Supports + * Delegated Administrator in the table at AWS Services that you can use with + * AWS Organizations in the AWS Organizations User Guide. + *

+ *

This operation can be called only from the organization's management account.

+ */ export class RegisterDelegatedAdministratorCommand extends $Command< RegisterDelegatedAdministratorCommandInput, RegisterDelegatedAdministratorCommandOutput, @@ -34,6 +45,9 @@ export class RegisterDelegatedAdministratorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/RemoveAccountFromOrganizationCommand.ts b/clients/client-organizations/commands/RemoveAccountFromOrganizationCommand.ts index b9574f451fc14..43b1e0ba5d701 100644 --- a/clients/client-organizations/commands/RemoveAccountFromOrganizationCommand.ts +++ b/clients/client-organizations/commands/RemoveAccountFromOrganizationCommand.ts @@ -20,6 +20,39 @@ import { export type RemoveAccountFromOrganizationCommandInput = RemoveAccountFromOrganizationRequest; export type RemoveAccountFromOrganizationCommandOutput = __MetadataBearer; +/** + *

Removes the specified account from the organization.

+ *

The removed account becomes a standalone account that isn't a member of any + * organization. It's no longer subject to any policies and is responsible for its own bill + * payments. The organization's management account is no longer charged for any expenses + * accrued by the member account after it's removed from the organization.

+ *

This operation can be called only from the organization's management account. Member accounts can remove themselves with LeaveOrganization instead.

+ * + *
    + *
  • + *

    You can remove an account from your organization only if the account is + * configured with the information required to operate as a standalone account. + * When you create an account in an organization using the AWS Organizations console, + * API, or CLI commands, the information required of standalone accounts is + * not automatically collected. For an account that + * you want to make standalone, you must choose a support plan, provide and + * verify the required contact information, and provide a current payment + * method. AWS uses the payment method to charge for any billable (not free + * tier) AWS activity that occurs while the account isn't attached to an + * organization. To remove an account that doesn't yet have this information, + * you must sign in as the member account and follow the steps at To leave an organization when all required account information has not + * yet been provided in the + * AWS Organizations User Guide. + *

    + *
  • + *
  • + *

    After the account leaves the organization, all tags that were attached to + * the account object in the organization are deleted. AWS accounts outside + * of an organization do not support tags.

    + *
  • + *
+ *
+ */ export class RemoveAccountFromOrganizationCommand extends $Command< RemoveAccountFromOrganizationCommandInput, RemoveAccountFromOrganizationCommandOutput, @@ -34,6 +67,9 @@ export class RemoveAccountFromOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/TagResourceCommand.ts b/clients/client-organizations/commands/TagResourceCommand.ts index 2c3412498dce7..1ff0d2d7a32c8 100644 --- a/clients/client-organizations/commands/TagResourceCommand.ts +++ b/clients/client-organizations/commands/TagResourceCommand.ts @@ -20,6 +20,25 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds one or more tags to the specified resource.

+ *

Currently, you can attach tags to the following resources in AWS Organizations.

+ *
    + *
  • + *

    AWS account

    + *
  • + *
  • + *

    Organization root

    + *
  • + *
  • + *

    Organizational unit (OU)

    + *
  • + *
  • + *

    Policy (any type)

    + *
  • + *
+ *

This operation can be called only from the organization's management account.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +53,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/UntagResourceCommand.ts b/clients/client-organizations/commands/UntagResourceCommand.ts index 8bbde52be82f3..0ee25eb81f2cd 100644 --- a/clients/client-organizations/commands/UntagResourceCommand.ts +++ b/clients/client-organizations/commands/UntagResourceCommand.ts @@ -20,6 +20,25 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes any tags with the specified keys from the specified resource.

+ *

You can attach tags to the following resources in AWS Organizations.

+ *
    + *
  • + *

    AWS account

    + *
  • + *
  • + *

    Organization root

    + *
  • + *
  • + *

    Organizational unit (OU)

    + *
  • + *
  • + *

    Policy (any type)

    + *
  • + *
+ *

This operation can be called only from the organization's management account.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +53,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/UpdateOrganizationalUnitCommand.ts b/clients/client-organizations/commands/UpdateOrganizationalUnitCommand.ts index fda5f34600989..2a43088d9407f 100644 --- a/clients/client-organizations/commands/UpdateOrganizationalUnitCommand.ts +++ b/clients/client-organizations/commands/UpdateOrganizationalUnitCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateOrganizationalUnitCommandInput = UpdateOrganizationalUnitRequest; export type UpdateOrganizationalUnitCommandOutput = UpdateOrganizationalUnitResponse & __MetadataBearer; +/** + *

Renames the specified organizational unit (OU). The ID and ARN don't change. The child + * OUs and accounts remain in place, and any attached policies of the OU remain + * attached.

+ *

This operation can be called only from the organization's management account.

+ */ export class UpdateOrganizationalUnitCommand extends $Command< UpdateOrganizationalUnitCommandInput, UpdateOrganizationalUnitCommandOutput, @@ -34,6 +40,9 @@ export class UpdateOrganizationalUnitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/commands/UpdatePolicyCommand.ts b/clients/client-organizations/commands/UpdatePolicyCommand.ts index f69a302c655c4..696839a632256 100644 --- a/clients/client-organizations/commands/UpdatePolicyCommand.ts +++ b/clients/client-organizations/commands/UpdatePolicyCommand.ts @@ -20,6 +20,12 @@ import { export type UpdatePolicyCommandInput = UpdatePolicyRequest; export type UpdatePolicyCommandOutput = UpdatePolicyResponse & __MetadataBearer; +/** + *

Updates an existing policy with a new name, description, or content. If you don't + * supply any parameter, that value remains unchanged. You can't change a policy's + * type.

+ *

This operation can be called only from the organization's management account.

+ */ export class UpdatePolicyCommand extends $Command< UpdatePolicyCommandInput, UpdatePolicyCommandOutput, @@ -34,6 +40,9 @@ export class UpdatePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OrganizationsClientResolvedConfig, diff --git a/clients/client-organizations/package.json b/clients/client-organizations/package.json index fe7742682febd..06ea6a7b458c4 100644 --- a/clients/client-organizations/package.json +++ b/clients/client-organizations/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Organizations Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-organizations/pagination/ListAWSServiceAccessForOrganizationPaginator.ts b/clients/client-organizations/pagination/ListAWSServiceAccessForOrganizationPaginator.ts index 307a293397453..07f78235ebb84 100644 --- a/clients/client-organizations/pagination/ListAWSServiceAccessForOrganizationPaginator.ts +++ b/clients/client-organizations/pagination/ListAWSServiceAccessForOrganizationPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListAWSServiceAccessForOrganizationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAWSServiceAccessForOrganizationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListAWSServiceAccessForOrganizationCommandInput, diff --git a/clients/client-organizations/pagination/ListAccountsForParentPaginator.ts b/clients/client-organizations/pagination/ListAccountsForParentPaginator.ts index 0f4fea3b0875f..6fd68d9003b0c 100644 --- a/clients/client-organizations/pagination/ListAccountsForParentPaginator.ts +++ b/clients/client-organizations/pagination/ListAccountsForParentPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListAccountsForParentCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountsForParentCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListAccountsForParentCommandInput, diff --git a/clients/client-organizations/pagination/ListAccountsPaginator.ts b/clients/client-organizations/pagination/ListAccountsPaginator.ts index f32ff9a74ee2c..0a69074c8502a 100644 --- a/clients/client-organizations/pagination/ListAccountsPaginator.ts +++ b/clients/client-organizations/pagination/ListAccountsPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListAccountsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListAccountsCommandInput, diff --git a/clients/client-organizations/pagination/ListChildrenPaginator.ts b/clients/client-organizations/pagination/ListChildrenPaginator.ts index 6ab67f8a0665b..7b97703399996 100644 --- a/clients/client-organizations/pagination/ListChildrenPaginator.ts +++ b/clients/client-organizations/pagination/ListChildrenPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListChildrenCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListChildrenCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListChildrenCommandInput, diff --git a/clients/client-organizations/pagination/ListCreateAccountStatusPaginator.ts b/clients/client-organizations/pagination/ListCreateAccountStatusPaginator.ts index 5479e0d7894c4..270d4596e315c 100644 --- a/clients/client-organizations/pagination/ListCreateAccountStatusPaginator.ts +++ b/clients/client-organizations/pagination/ListCreateAccountStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListCreateAccountStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCreateAccountStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListCreateAccountStatusCommandInput, diff --git a/clients/client-organizations/pagination/ListDelegatedAdministratorsPaginator.ts b/clients/client-organizations/pagination/ListDelegatedAdministratorsPaginator.ts index cf1f9f1755f43..577f89498f607 100644 --- a/clients/client-organizations/pagination/ListDelegatedAdministratorsPaginator.ts +++ b/clients/client-organizations/pagination/ListDelegatedAdministratorsPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListDelegatedAdministratorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDelegatedAdministratorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListDelegatedAdministratorsCommandInput, diff --git a/clients/client-organizations/pagination/ListDelegatedServicesForAccountPaginator.ts b/clients/client-organizations/pagination/ListDelegatedServicesForAccountPaginator.ts index f0c0a30a9a71a..70590084a7744 100644 --- a/clients/client-organizations/pagination/ListDelegatedServicesForAccountPaginator.ts +++ b/clients/client-organizations/pagination/ListDelegatedServicesForAccountPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListDelegatedServicesForAccountCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDelegatedServicesForAccountCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListDelegatedServicesForAccountCommandInput, diff --git a/clients/client-organizations/pagination/ListHandshakesForAccountPaginator.ts b/clients/client-organizations/pagination/ListHandshakesForAccountPaginator.ts index 5f07186ea2bf1..e1e3b07daa2dd 100644 --- a/clients/client-organizations/pagination/ListHandshakesForAccountPaginator.ts +++ b/clients/client-organizations/pagination/ListHandshakesForAccountPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListHandshakesForAccountCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHandshakesForAccountCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListHandshakesForAccountCommandInput, diff --git a/clients/client-organizations/pagination/ListHandshakesForOrganizationPaginator.ts b/clients/client-organizations/pagination/ListHandshakesForOrganizationPaginator.ts index 7371a5003478d..32e087f15fab0 100644 --- a/clients/client-organizations/pagination/ListHandshakesForOrganizationPaginator.ts +++ b/clients/client-organizations/pagination/ListHandshakesForOrganizationPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListHandshakesForOrganizationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHandshakesForOrganizationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListHandshakesForOrganizationCommandInput, diff --git a/clients/client-organizations/pagination/ListOrganizationalUnitsForParentPaginator.ts b/clients/client-organizations/pagination/ListOrganizationalUnitsForParentPaginator.ts index ae4a6ede99767..80ad3632113b6 100644 --- a/clients/client-organizations/pagination/ListOrganizationalUnitsForParentPaginator.ts +++ b/clients/client-organizations/pagination/ListOrganizationalUnitsForParentPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListOrganizationalUnitsForParentCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOrganizationalUnitsForParentCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListOrganizationalUnitsForParentCommandInput, diff --git a/clients/client-organizations/pagination/ListParentsPaginator.ts b/clients/client-organizations/pagination/ListParentsPaginator.ts index 873b726436386..8b162aeab4d0d 100644 --- a/clients/client-organizations/pagination/ListParentsPaginator.ts +++ b/clients/client-organizations/pagination/ListParentsPaginator.ts @@ -4,6 +4,9 @@ import { ListParentsCommand, ListParentsCommandInput, ListParentsCommandOutput } import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListParentsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListParentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListParentsCommandInput, diff --git a/clients/client-organizations/pagination/ListPoliciesForTargetPaginator.ts b/clients/client-organizations/pagination/ListPoliciesForTargetPaginator.ts index 9e46dc21e51b7..aa31bf29fbd04 100644 --- a/clients/client-organizations/pagination/ListPoliciesForTargetPaginator.ts +++ b/clients/client-organizations/pagination/ListPoliciesForTargetPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListPoliciesForTargetCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPoliciesForTargetCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListPoliciesForTargetCommandInput, diff --git a/clients/client-organizations/pagination/ListPoliciesPaginator.ts b/clients/client-organizations/pagination/ListPoliciesPaginator.ts index 2a8b0ed118de6..210a6fee92af9 100644 --- a/clients/client-organizations/pagination/ListPoliciesPaginator.ts +++ b/clients/client-organizations/pagination/ListPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListPoliciesCommandInput, diff --git a/clients/client-organizations/pagination/ListRootsPaginator.ts b/clients/client-organizations/pagination/ListRootsPaginator.ts index 0ef8f4e8cd177..c92c162de0a1a 100644 --- a/clients/client-organizations/pagination/ListRootsPaginator.ts +++ b/clients/client-organizations/pagination/ListRootsPaginator.ts @@ -4,6 +4,9 @@ import { ListRootsCommand, ListRootsCommandInput, ListRootsCommandOutput } from import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListRootsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRootsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListRootsCommandInput, diff --git a/clients/client-organizations/pagination/ListTagsForResourcePaginator.ts b/clients/client-organizations/pagination/ListTagsForResourcePaginator.ts index 5555cf7fbaf55..4607c14dc7a39 100644 --- a/clients/client-organizations/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-organizations/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListTagsForResourceCommandInput, diff --git a/clients/client-organizations/pagination/ListTargetsForPolicyPaginator.ts b/clients/client-organizations/pagination/ListTargetsForPolicyPaginator.ts index f75221bcfbe1a..183c84fdef6e7 100644 --- a/clients/client-organizations/pagination/ListTargetsForPolicyPaginator.ts +++ b/clients/client-organizations/pagination/ListTargetsForPolicyPaginator.ts @@ -8,6 +8,9 @@ import { import { OrganizationsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OrganizationsClient, input: ListTargetsForPolicyCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTargetsForPolicyCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Organizations, input: ListTargetsForPolicyCommandInput, diff --git a/clients/client-organizations/runtimeConfig.browser.ts b/clients/client-organizations/runtimeConfig.browser.ts index 56160bac1a6e2..b20663f3fbd8b 100644 --- a/clients/client-organizations/runtimeConfig.browser.ts +++ b/clients/client-organizations/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./OrganizationsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-organizations/runtimeConfig.native.ts b/clients/client-organizations/runtimeConfig.native.ts index 874b8269abec9..7f114f369b56b 100644 --- a/clients/client-organizations/runtimeConfig.native.ts +++ b/clients/client-organizations/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./OrganizationsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-organizations/runtimeConfig.shared.ts b/clients/client-organizations/runtimeConfig.shared.ts index 499a37f7749b5..19cd902aaace6 100644 --- a/clients/client-organizations/runtimeConfig.shared.ts +++ b/clients/client-organizations/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-11-28", disableHostPrefix: false, diff --git a/clients/client-organizations/runtimeConfig.ts b/clients/client-organizations/runtimeConfig.ts index 786bb039368cd..4ef2f0fadf825 100644 --- a/clients/client-organizations/runtimeConfig.ts +++ b/clients/client-organizations/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./OrganizationsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-organizations/tsconfig.json b/clients/client-organizations/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-organizations/tsconfig.json +++ b/clients/client-organizations/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-outposts/commands/CreateOutpostCommand.ts b/clients/client-outposts/commands/CreateOutpostCommand.ts index 0ab52c6b63530..876b13dc8b858 100644 --- a/clients/client-outposts/commands/CreateOutpostCommand.ts +++ b/clients/client-outposts/commands/CreateOutpostCommand.ts @@ -20,6 +20,9 @@ import { export type CreateOutpostCommandInput = CreateOutpostInput; export type CreateOutpostCommandOutput = CreateOutpostOutput & __MetadataBearer; +/** + *

Creates an Outpost.

+ */ export class CreateOutpostCommand extends $Command< CreateOutpostCommandInput, CreateOutpostCommandOutput, @@ -34,6 +37,9 @@ export class CreateOutpostCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OutpostsClientResolvedConfig, diff --git a/clients/client-outposts/commands/DeleteOutpostCommand.ts b/clients/client-outposts/commands/DeleteOutpostCommand.ts index dc66176bc6b78..2778dc3f07b2a 100644 --- a/clients/client-outposts/commands/DeleteOutpostCommand.ts +++ b/clients/client-outposts/commands/DeleteOutpostCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteOutpostCommandInput = DeleteOutpostInput; export type DeleteOutpostCommandOutput = DeleteOutpostOutput & __MetadataBearer; +/** + *

Deletes the Outpost.

+ */ export class DeleteOutpostCommand extends $Command< DeleteOutpostCommandInput, DeleteOutpostCommandOutput, @@ -34,6 +37,9 @@ export class DeleteOutpostCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OutpostsClientResolvedConfig, diff --git a/clients/client-outposts/commands/DeleteSiteCommand.ts b/clients/client-outposts/commands/DeleteSiteCommand.ts index 4185f53867206..c15054c05b863 100644 --- a/clients/client-outposts/commands/DeleteSiteCommand.ts +++ b/clients/client-outposts/commands/DeleteSiteCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSiteCommandInput = DeleteSiteInput; export type DeleteSiteCommandOutput = DeleteSiteOutput & __MetadataBearer; +/** + *

Deletes the site.

+ */ export class DeleteSiteCommand extends $Command< DeleteSiteCommandInput, DeleteSiteCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSiteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OutpostsClientResolvedConfig, diff --git a/clients/client-outposts/commands/GetOutpostCommand.ts b/clients/client-outposts/commands/GetOutpostCommand.ts index 1df87e1040337..f1ed57d1aed12 100644 --- a/clients/client-outposts/commands/GetOutpostCommand.ts +++ b/clients/client-outposts/commands/GetOutpostCommand.ts @@ -20,6 +20,9 @@ import { export type GetOutpostCommandInput = GetOutpostInput; export type GetOutpostCommandOutput = GetOutpostOutput & __MetadataBearer; +/** + *

Gets information about the specified Outpost.

+ */ export class GetOutpostCommand extends $Command< GetOutpostCommandInput, GetOutpostCommandOutput, @@ -34,6 +37,9 @@ export class GetOutpostCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OutpostsClientResolvedConfig, diff --git a/clients/client-outposts/commands/GetOutpostInstanceTypesCommand.ts b/clients/client-outposts/commands/GetOutpostInstanceTypesCommand.ts index f55d23d658abe..f587c2430a8f2 100644 --- a/clients/client-outposts/commands/GetOutpostInstanceTypesCommand.ts +++ b/clients/client-outposts/commands/GetOutpostInstanceTypesCommand.ts @@ -20,6 +20,9 @@ import { export type GetOutpostInstanceTypesCommandInput = GetOutpostInstanceTypesInput; export type GetOutpostInstanceTypesCommandOutput = GetOutpostInstanceTypesOutput & __MetadataBearer; +/** + *

Lists the instance types for the specified Outpost.

+ */ export class GetOutpostInstanceTypesCommand extends $Command< GetOutpostInstanceTypesCommandInput, GetOutpostInstanceTypesCommandOutput, @@ -34,6 +37,9 @@ export class GetOutpostInstanceTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OutpostsClientResolvedConfig, diff --git a/clients/client-outposts/commands/ListOutpostsCommand.ts b/clients/client-outposts/commands/ListOutpostsCommand.ts index 7ae261638aaab..d80cfe62a7923 100644 --- a/clients/client-outposts/commands/ListOutpostsCommand.ts +++ b/clients/client-outposts/commands/ListOutpostsCommand.ts @@ -20,6 +20,9 @@ import { export type ListOutpostsCommandInput = ListOutpostsInput; export type ListOutpostsCommandOutput = ListOutpostsOutput & __MetadataBearer; +/** + *

List the Outposts for your AWS account.

+ */ export class ListOutpostsCommand extends $Command< ListOutpostsCommandInput, ListOutpostsCommandOutput, @@ -34,6 +37,9 @@ export class ListOutpostsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OutpostsClientResolvedConfig, diff --git a/clients/client-outposts/commands/ListSitesCommand.ts b/clients/client-outposts/commands/ListSitesCommand.ts index d8dddc08c11a7..da19e9f4162ad 100644 --- a/clients/client-outposts/commands/ListSitesCommand.ts +++ b/clients/client-outposts/commands/ListSitesCommand.ts @@ -20,6 +20,9 @@ import { export type ListSitesCommandInput = ListSitesInput; export type ListSitesCommandOutput = ListSitesOutput & __MetadataBearer; +/** + *

Lists the sites for the specified AWS account.

+ */ export class ListSitesCommand extends $Command< ListSitesCommandInput, ListSitesCommandOutput, @@ -34,6 +37,9 @@ export class ListSitesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: OutpostsClientResolvedConfig, diff --git a/clients/client-outposts/package.json b/clients/client-outposts/package.json index 52bae9c6740de..30d5c496c95a5 100644 --- a/clients/client-outposts/package.json +++ b/clients/client-outposts/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Outposts Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-outposts/pagination/ListOutpostsPaginator.ts b/clients/client-outposts/pagination/ListOutpostsPaginator.ts index 78fe705ff3623..019f77b7a176b 100644 --- a/clients/client-outposts/pagination/ListOutpostsPaginator.ts +++ b/clients/client-outposts/pagination/ListOutpostsPaginator.ts @@ -8,6 +8,9 @@ import { import { OutpostsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OutpostsClient, input: ListOutpostsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOutpostsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Outposts, input: ListOutpostsCommandInput, diff --git a/clients/client-outposts/pagination/ListSitesPaginator.ts b/clients/client-outposts/pagination/ListSitesPaginator.ts index e862b04997718..6d795aff84793 100644 --- a/clients/client-outposts/pagination/ListSitesPaginator.ts +++ b/clients/client-outposts/pagination/ListSitesPaginator.ts @@ -4,6 +4,9 @@ import { ListSitesCommand, ListSitesCommandInput, ListSitesCommandOutput } from import { OutpostsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: OutpostsClient, input: ListSitesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSitesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Outposts, input: ListSitesCommandInput, diff --git a/clients/client-outposts/runtimeConfig.browser.ts b/clients/client-outposts/runtimeConfig.browser.ts index d7ac4eb39c000..0cd3011c4ce58 100644 --- a/clients/client-outposts/runtimeConfig.browser.ts +++ b/clients/client-outposts/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./OutpostsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-outposts/runtimeConfig.native.ts b/clients/client-outposts/runtimeConfig.native.ts index 5dea1de7b680c..0438b4ad69bde 100644 --- a/clients/client-outposts/runtimeConfig.native.ts +++ b/clients/client-outposts/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./OutpostsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-outposts/runtimeConfig.shared.ts b/clients/client-outposts/runtimeConfig.shared.ts index cfee9b0041aca..df54583e84b78 100644 --- a/clients/client-outposts/runtimeConfig.shared.ts +++ b/clients/client-outposts/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-03", disableHostPrefix: false, diff --git a/clients/client-outposts/runtimeConfig.ts b/clients/client-outposts/runtimeConfig.ts index ccb5b2fc27f1d..4365b133e0d40 100644 --- a/clients/client-outposts/runtimeConfig.ts +++ b/clients/client-outposts/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./OutpostsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-outposts/tsconfig.json b/clients/client-outposts/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-outposts/tsconfig.json +++ b/clients/client-outposts/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-personalize-events/commands/PutEventsCommand.ts b/clients/client-personalize-events/commands/PutEventsCommand.ts index 70dfdef715cb5..1494ccf67134a 100644 --- a/clients/client-personalize-events/commands/PutEventsCommand.ts +++ b/clients/client-personalize-events/commands/PutEventsCommand.ts @@ -24,6 +24,9 @@ import { export type PutEventsCommandInput = PutEventsRequest; export type PutEventsCommandOutput = __MetadataBearer; +/** + *

Records user interaction event data. For more information see event-record-api.

+ */ export class PutEventsCommand extends $Command< PutEventsCommandInput, PutEventsCommandOutput, @@ -38,6 +41,9 @@ export class PutEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeEventsClientResolvedConfig, diff --git a/clients/client-personalize-events/commands/PutItemsCommand.ts b/clients/client-personalize-events/commands/PutItemsCommand.ts index 728eedae14569..e33eeab980989 100644 --- a/clients/client-personalize-events/commands/PutItemsCommand.ts +++ b/clients/client-personalize-events/commands/PutItemsCommand.ts @@ -24,6 +24,10 @@ import { export type PutItemsCommandInput = PutItemsRequest; export type PutItemsCommandOutput = __MetadataBearer; +/** + *

Adds one or more items to an Items dataset. For more information see + * importing-items.

+ */ export class PutItemsCommand extends $Command< PutItemsCommandInput, PutItemsCommandOutput, @@ -38,6 +42,9 @@ export class PutItemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeEventsClientResolvedConfig, diff --git a/clients/client-personalize-events/commands/PutUsersCommand.ts b/clients/client-personalize-events/commands/PutUsersCommand.ts index a90d01317e7e4..7e87694bb3da9 100644 --- a/clients/client-personalize-events/commands/PutUsersCommand.ts +++ b/clients/client-personalize-events/commands/PutUsersCommand.ts @@ -24,6 +24,10 @@ import { export type PutUsersCommandInput = PutUsersRequest; export type PutUsersCommandOutput = __MetadataBearer; +/** + *

Adds one or more users to a Users dataset. For more information see + * importing-users.

+ */ export class PutUsersCommand extends $Command< PutUsersCommandInput, PutUsersCommandOutput, @@ -38,6 +42,9 @@ export class PutUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeEventsClientResolvedConfig, diff --git a/clients/client-personalize-events/package.json b/clients/client-personalize-events/package.json index 4db4db9a8a477..8cdf0958b8849 100644 --- a/clients/client-personalize-events/package.json +++ b/clients/client-personalize-events/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Personalize Events Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-personalize-events/runtimeConfig.browser.ts b/clients/client-personalize-events/runtimeConfig.browser.ts index ed2f28916a9bd..07f545d39b0a0 100644 --- a/clients/client-personalize-events/runtimeConfig.browser.ts +++ b/clients/client-personalize-events/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PersonalizeEventsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-personalize-events/runtimeConfig.native.ts b/clients/client-personalize-events/runtimeConfig.native.ts index 610f23361d7f1..4014e952d21dc 100644 --- a/clients/client-personalize-events/runtimeConfig.native.ts +++ b/clients/client-personalize-events/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PersonalizeEventsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-personalize-events/runtimeConfig.shared.ts b/clients/client-personalize-events/runtimeConfig.shared.ts index 9697b3dd46779..4f56bb11622a3 100644 --- a/clients/client-personalize-events/runtimeConfig.shared.ts +++ b/clients/client-personalize-events/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-03-22", disableHostPrefix: false, diff --git a/clients/client-personalize-events/runtimeConfig.ts b/clients/client-personalize-events/runtimeConfig.ts index 2ce9f569eecc4..8b8938c4b931a 100644 --- a/clients/client-personalize-events/runtimeConfig.ts +++ b/clients/client-personalize-events/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PersonalizeEventsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-personalize-events/tsconfig.json b/clients/client-personalize-events/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-personalize-events/tsconfig.json +++ b/clients/client-personalize-events/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-personalize-runtime/commands/GetPersonalizedRankingCommand.ts b/clients/client-personalize-runtime/commands/GetPersonalizedRankingCommand.ts index 8cea9250e7a92..5b146b590bc29 100644 --- a/clients/client-personalize-runtime/commands/GetPersonalizedRankingCommand.ts +++ b/clients/client-personalize-runtime/commands/GetPersonalizedRankingCommand.ts @@ -24,6 +24,14 @@ import { export type GetPersonalizedRankingCommandInput = GetPersonalizedRankingRequest; export type GetPersonalizedRankingCommandOutput = GetPersonalizedRankingResponse & __MetadataBearer; +/** + *

Re-ranks a list of recommended items for the given user. The first item in the list is + * deemed the most likely item to be of interest to the user.

+ * + *

The solution backing the campaign must have been created using a recipe of type + * PERSONALIZED_RANKING.

+ *
+ */ export class GetPersonalizedRankingCommand extends $Command< GetPersonalizedRankingCommandInput, GetPersonalizedRankingCommandOutput, @@ -38,6 +46,9 @@ export class GetPersonalizedRankingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeRuntimeClientResolvedConfig, diff --git a/clients/client-personalize-runtime/commands/GetRecommendationsCommand.ts b/clients/client-personalize-runtime/commands/GetRecommendationsCommand.ts index 9cff6b753d1a1..b20c3986fdd57 100644 --- a/clients/client-personalize-runtime/commands/GetRecommendationsCommand.ts +++ b/clients/client-personalize-runtime/commands/GetRecommendationsCommand.ts @@ -24,6 +24,23 @@ import { export type GetRecommendationsCommandInput = GetRecommendationsRequest; export type GetRecommendationsCommandOutput = GetRecommendationsResponse & __MetadataBearer; +/** + *

Returns a list of recommended items. The required input depends on the recipe type used to + * create the solution backing the campaign, as follows:

+ *
    + *
  • + *

    RELATED_ITEMS - itemId required, userId not used

    + *
  • + *
  • + *

    USER_PERSONALIZATION - itemId optional, userId + * required

    + *
  • + *
+ * + *

Campaigns that are backed by a solution created using a recipe of type + * PERSONALIZED_RANKING use the API.

+ *
+ */ export class GetRecommendationsCommand extends $Command< GetRecommendationsCommandInput, GetRecommendationsCommandOutput, @@ -38,6 +55,9 @@ export class GetRecommendationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeRuntimeClientResolvedConfig, diff --git a/clients/client-personalize-runtime/package.json b/clients/client-personalize-runtime/package.json index b928228da076d..bf6cdf34a3c10 100644 --- a/clients/client-personalize-runtime/package.json +++ b/clients/client-personalize-runtime/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Personalize Runtime Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-personalize-runtime/runtimeConfig.browser.ts b/clients/client-personalize-runtime/runtimeConfig.browser.ts index 58b8cb0cdc14c..bdcadd20efdad 100644 --- a/clients/client-personalize-runtime/runtimeConfig.browser.ts +++ b/clients/client-personalize-runtime/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PersonalizeRuntimeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-personalize-runtime/runtimeConfig.native.ts b/clients/client-personalize-runtime/runtimeConfig.native.ts index fccaf53d9fd1a..ce7f23fe94f37 100644 --- a/clients/client-personalize-runtime/runtimeConfig.native.ts +++ b/clients/client-personalize-runtime/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PersonalizeRuntimeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-personalize-runtime/runtimeConfig.shared.ts b/clients/client-personalize-runtime/runtimeConfig.shared.ts index 8f36460e42a6b..bc6479c212447 100644 --- a/clients/client-personalize-runtime/runtimeConfig.shared.ts +++ b/clients/client-personalize-runtime/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-05-22", disableHostPrefix: false, diff --git a/clients/client-personalize-runtime/runtimeConfig.ts b/clients/client-personalize-runtime/runtimeConfig.ts index 52eac31985b87..30d5025f9e3d2 100644 --- a/clients/client-personalize-runtime/runtimeConfig.ts +++ b/clients/client-personalize-runtime/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PersonalizeRuntimeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-personalize-runtime/tsconfig.json b/clients/client-personalize-runtime/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-personalize-runtime/tsconfig.json +++ b/clients/client-personalize-runtime/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-personalize/commands/CreateBatchInferenceJobCommand.ts b/clients/client-personalize/commands/CreateBatchInferenceJobCommand.ts index 190d847ba43b1..8040ac45164ec 100644 --- a/clients/client-personalize/commands/CreateBatchInferenceJobCommand.ts +++ b/clients/client-personalize/commands/CreateBatchInferenceJobCommand.ts @@ -20,6 +20,10 @@ import { export type CreateBatchInferenceJobCommandInput = CreateBatchInferenceJobRequest; export type CreateBatchInferenceJobCommandOutput = CreateBatchInferenceJobResponse & __MetadataBearer; +/** + *

Creates a batch inference job. The operation can handle up to 50 million records and the + * input file must be in JSON format. For more information, see recommendations-batch.

+ */ export class CreateBatchInferenceJobCommand extends $Command< CreateBatchInferenceJobCommandInput, CreateBatchInferenceJobCommandOutput, @@ -34,6 +38,9 @@ export class CreateBatchInferenceJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateCampaignCommand.ts b/clients/client-personalize/commands/CreateCampaignCommand.ts index f2543e46c5b80..0a7df13730bff 100644 --- a/clients/client-personalize/commands/CreateCampaignCommand.ts +++ b/clients/client-personalize/commands/CreateCampaignCommand.ts @@ -20,6 +20,72 @@ import { export type CreateCampaignCommandInput = CreateCampaignRequest; export type CreateCampaignCommandOutput = CreateCampaignResponse & __MetadataBearer; +/** + *

Creates a campaign by deploying a solution version. When a client calls the + * GetRecommendations + * and + * GetPersonalizedRanking + * APIs, a campaign is specified in the request.

+ * + *

+ * Minimum Provisioned TPS and Auto-Scaling + *

+ *

A transaction is a single GetRecommendations or + * GetPersonalizedRanking call. Transactions per second (TPS) is the throughput + * and unit of billing for Amazon Personalize. The minimum provisioned TPS + * (minProvisionedTPS) specifies the baseline throughput provisioned by + * Amazon Personalize, and thus, the minimum billing charge. If your TPS increases beyond + * minProvisionedTPS, Amazon Personalize auto-scales the provisioned capacity up and down, + * but never below minProvisionedTPS, to maintain a 70% utilization. + * There's a short time delay while the capacity is increased that might cause loss of + * transactions. It's recommended to start with a low minProvisionedTPS, track + * your usage using Amazon CloudWatch metrics, and then increase the minProvisionedTPS + * as necessary.

+ * + *

+ * Status + *

+ *

A campaign can be in one of the following states:

+ *
    + *
  • + *

    CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

    + *
  • + *
  • + *

    DELETE PENDING > DELETE IN_PROGRESS

    + *
  • + *
+ *

To get the campaign status, call DescribeCampaign.

+ * + *

Wait until the status of the campaign + * is ACTIVE before asking the campaign for recommendations.

+ *
+ * + *

+ * Related APIs + *

+ * + */ export class CreateCampaignCommand extends $Command< CreateCampaignCommandInput, CreateCampaignCommandOutput, @@ -34,6 +100,9 @@ export class CreateCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateDatasetCommand.ts b/clients/client-personalize/commands/CreateDatasetCommand.ts index 33f46ec7d20a3..f78b3a93ab31a 100644 --- a/clients/client-personalize/commands/CreateDatasetCommand.ts +++ b/clients/client-personalize/commands/CreateDatasetCommand.ts @@ -20,6 +20,59 @@ import { export type CreateDatasetCommandInput = CreateDatasetRequest; export type CreateDatasetCommandOutput = CreateDatasetResponse & __MetadataBearer; +/** + *

Creates an empty dataset and adds it to the specified dataset group. Use CreateDatasetImportJob to import your training data to a dataset.

+ *

There are three types of datasets:

+ *
    + *
  • + *

    Interactions

    + *
  • + *
  • + *

    Items

    + *
  • + *
  • + *

    Users

    + *
  • + *
+ *

Each dataset type has an associated schema with required field types. Only the + * Interactions dataset is required in order to train a model (also referred to as + * creating a solution).

+ *

A dataset can be in one of the following states:

+ *
    + *
  • + *

    CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

    + *
  • + *
  • + *

    DELETE PENDING > DELETE IN_PROGRESS

    + *
  • + *
+ *

To get the status of the dataset, call DescribeDataset.

+ *

+ * Related APIs + *

+ * + */ export class CreateDatasetCommand extends $Command< CreateDatasetCommandInput, CreateDatasetCommandOutput, @@ -34,6 +87,9 @@ export class CreateDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateDatasetGroupCommand.ts b/clients/client-personalize/commands/CreateDatasetGroupCommand.ts index 5483efd3a41e2..dccd860588251 100644 --- a/clients/client-personalize/commands/CreateDatasetGroupCommand.ts +++ b/clients/client-personalize/commands/CreateDatasetGroupCommand.ts @@ -20,6 +20,84 @@ import { export type CreateDatasetGroupCommandInput = CreateDatasetGroupRequest; export type CreateDatasetGroupCommandOutput = CreateDatasetGroupResponse & __MetadataBearer; +/** + *

Creates an empty dataset group. A dataset group contains related datasets that supply data + * for training a model. A dataset group can contain at most three datasets, one for each type of + * dataset:

+ *
    + *
  • + *

    Interactions

    + *
  • + *
  • + *

    Items

    + *
  • + *
  • + *

    Users

    + *
  • + *
+ *

To train a model (create a solution), a dataset group that contains an + * Interactions dataset is required. Call CreateDataset to add a + * dataset to the group.

+ *

A dataset group can be in one of the following states:

+ *
    + *
  • + *

    CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

    + *
  • + *
  • + *

    DELETE PENDING

    + *
  • + *
+ *

To get the status of the dataset group, call DescribeDatasetGroup. If + * the status shows as CREATE FAILED, the response includes a failureReason key, + * which describes why the creation failed.

+ * + *

You must wait until the status of the dataset group is ACTIVE + * before adding a dataset to the group.

+ *
+ *

You can specify an AWS Key Management Service (KMS) key to encrypt the datasets in the group. If you + * specify a KMS key, you must also include an AWS Identity and Access Management (IAM) role that has permission to + * access the key.

+ *

+ * APIs that require a dataset group ARN in the request + *

+ * + *

+ * Related APIs + *

+ * + */ export class CreateDatasetGroupCommand extends $Command< CreateDatasetGroupCommandInput, CreateDatasetGroupCommandOutput, @@ -34,6 +112,9 @@ export class CreateDatasetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateDatasetImportJobCommand.ts b/clients/client-personalize/commands/CreateDatasetImportJobCommand.ts index 7cbf2d0d56104..5f45814117c3f 100644 --- a/clients/client-personalize/commands/CreateDatasetImportJobCommand.ts +++ b/clients/client-personalize/commands/CreateDatasetImportJobCommand.ts @@ -20,6 +20,48 @@ import { export type CreateDatasetImportJobCommandInput = CreateDatasetImportJobRequest; export type CreateDatasetImportJobCommandOutput = CreateDatasetImportJobResponse & __MetadataBearer; +/** + *

Creates a job that imports training data from your data source (an Amazon S3 bucket) to an + * Amazon Personalize dataset. To allow Amazon Personalize to import the training data, you must specify an + * AWS Identity and Access Management (IAM) role that has permission to read from the data source, as Amazon Personalize makes a + * copy of your data and processes it in an internal AWS system.

+ * + *

The dataset import job replaces any previous data in the dataset.

+ *
+ *

+ * Status + *

+ *

A dataset import job can be in one of the following states:

+ *
    + *
  • + *

    CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

    + *
  • + *
+ *

To get the status of the import job, call DescribeDatasetImportJob, + * providing the Amazon Resource Name (ARN) of the dataset import job. The dataset import is + * complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response + * includes a failureReason key, which describes why the job failed.

+ * + *

Importing takes time. You must wait until the status shows as ACTIVE before training a + * model using the dataset.

+ *
+ * + *

+ * Related APIs + *

+ * + */ export class CreateDatasetImportJobCommand extends $Command< CreateDatasetImportJobCommandInput, CreateDatasetImportJobCommandOutput, @@ -34,6 +76,9 @@ export class CreateDatasetImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateEventTrackerCommand.ts b/clients/client-personalize/commands/CreateEventTrackerCommand.ts index 34ed9b9f9b417..24f64c839b3bc 100644 --- a/clients/client-personalize/commands/CreateEventTrackerCommand.ts +++ b/clients/client-personalize/commands/CreateEventTrackerCommand.ts @@ -20,6 +20,56 @@ import { export type CreateEventTrackerCommandInput = CreateEventTrackerRequest; export type CreateEventTrackerCommandOutput = CreateEventTrackerResponse & __MetadataBearer; +/** + *

Creates an event tracker that you use when sending event data to the specified dataset + * group using the + * PutEvents API.

+ *

When Amazon Personalize creates an event tracker, it also + * creates an event-interactions dataset in the dataset group associated + * with the event tracker. + * The event-interactions dataset stores the event data from the PutEvents call. + * The contents of this dataset are not available to the user.

+ * + *

Only one event tracker can be associated with a dataset group. You will get + * an error if you call CreateEventTracker using the same dataset group as an + * existing event tracker.

+ *
+ *

When you send event data you include your tracking ID. The tracking ID identifies + * the customer and authorizes the customer to send the data.

+ *

The event tracker can be in one of the following states:

+ *
    + *
  • + *

    CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

    + *
  • + *
  • + *

    DELETE PENDING > DELETE IN_PROGRESS

    + *
  • + *
+ *

To get the status of the event tracker, call DescribeEventTracker.

+ * + *

The event tracker must be in the ACTIVE state before using the tracking ID.

+ *
+ *

+ * Related APIs + *

+ * + */ export class CreateEventTrackerCommand extends $Command< CreateEventTrackerCommandInput, CreateEventTrackerCommandOutput, @@ -34,6 +84,9 @@ export class CreateEventTrackerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateFilterCommand.ts b/clients/client-personalize/commands/CreateFilterCommand.ts index 719b4dfd09cf8..6bb884fee44e7 100644 --- a/clients/client-personalize/commands/CreateFilterCommand.ts +++ b/clients/client-personalize/commands/CreateFilterCommand.ts @@ -20,6 +20,10 @@ import { export type CreateFilterCommandInput = CreateFilterRequest; export type CreateFilterCommandOutput = CreateFilterResponse & __MetadataBearer; +/** + *

Creates a recommendation filter. For more information, see Using + * Filters with Amazon Personalize.

+ */ export class CreateFilterCommand extends $Command< CreateFilterCommandInput, CreateFilterCommandOutput, @@ -34,6 +38,9 @@ export class CreateFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateSchemaCommand.ts b/clients/client-personalize/commands/CreateSchemaCommand.ts index 43eabfeba5cc8..f15783507a494 100644 --- a/clients/client-personalize/commands/CreateSchemaCommand.ts +++ b/clients/client-personalize/commands/CreateSchemaCommand.ts @@ -20,6 +20,34 @@ import { export type CreateSchemaCommandInput = CreateSchemaRequest; export type CreateSchemaCommandOutput = CreateSchemaResponse & __MetadataBearer; +/** + *

Creates an Amazon Personalize schema from the specified schema string. The schema you create + * must be in Avro JSON format.

+ *

Amazon Personalize recognizes three schema variants. Each schema is associated with a dataset + * type and has a set of required field and keywords. + * You specify a schema when you call CreateDataset.

+ * + *

+ * Related APIs + *

+ * + */ export class CreateSchemaCommand extends $Command< CreateSchemaCommandInput, CreateSchemaCommandOutput, @@ -34,6 +62,9 @@ export class CreateSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateSolutionCommand.ts b/clients/client-personalize/commands/CreateSolutionCommand.ts index 6d9511fb96cd4..2a738265cb352 100644 --- a/clients/client-personalize/commands/CreateSolutionCommand.ts +++ b/clients/client-personalize/commands/CreateSolutionCommand.ts @@ -20,6 +20,77 @@ import { export type CreateSolutionCommandInput = CreateSolutionRequest; export type CreateSolutionCommandOutput = CreateSolutionResponse & __MetadataBearer; +/** + *

Creates the configuration for training a model. A trained model is known as + * a solution. After the configuration is created, you train the model (create a solution) + * by calling the CreateSolutionVersion operation. Every time you call + * CreateSolutionVersion, a new version of the solution is created.

+ *

After creating a solution version, you check its accuracy by calling + * GetSolutionMetrics. When you are satisfied with the version, you + * deploy it using CreateCampaign. The campaign provides recommendations + * to a client through the + * GetRecommendations API.

+ *

To train a model, Amazon Personalize requires training data and a recipe. The training data + * comes from the dataset group that you provide in the request. A recipe specifies + * the training algorithm and a feature transformation. You can specify one of the predefined + * recipes provided by Amazon Personalize. Alternatively, you can specify + * performAutoML and Amazon Personalize will analyze your data and select the + * optimum USER_PERSONALIZATION recipe for you.

+ *

+ * Status + *

+ *

A solution can be in one of the following states:

+ *
    + *
  • + *

    CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

    + *
  • + *
  • + *

    DELETE PENDING > DELETE IN_PROGRESS

    + *
  • + *
+ *

To get the status of the solution, call DescribeSolution. Wait + * until the status shows as ACTIVE before calling CreateSolutionVersion.

+ * + * + * + *

+ * Related APIs + *

+ * + * + */ export class CreateSolutionCommand extends $Command< CreateSolutionCommandInput, CreateSolutionCommandOutput, @@ -34,6 +105,9 @@ export class CreateSolutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/CreateSolutionVersionCommand.ts b/clients/client-personalize/commands/CreateSolutionVersionCommand.ts index 1dda808589d29..6d55e9e448bb4 100644 --- a/clients/client-personalize/commands/CreateSolutionVersionCommand.ts +++ b/clients/client-personalize/commands/CreateSolutionVersionCommand.ts @@ -20,6 +20,61 @@ import { export type CreateSolutionVersionCommandInput = CreateSolutionVersionRequest; export type CreateSolutionVersionCommandOutput = CreateSolutionVersionResponse & __MetadataBearer; +/** + *

Trains or retrains an active solution. A solution is created using the CreateSolution operation and must be in the ACTIVE state before calling + * CreateSolutionVersion. A new version of the solution is created every time you + * call this operation.

+ *

+ * Status + *

+ *

A solution version can be in one of the following states:

+ *
    + *
  • + *

    CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

    + *
  • + *
+ *

To get the status of the version, call DescribeSolutionVersion. Wait + * until the status shows as ACTIVE before calling CreateCampaign.

+ *

If the status shows as CREATE FAILED, the response includes a failureReason + * key, which describes why the job failed.

+ *

+ * Related APIs + *

+ * + * + */ export class CreateSolutionVersionCommand extends $Command< CreateSolutionVersionCommandInput, CreateSolutionVersionCommandOutput, @@ -34,6 +89,9 @@ export class CreateSolutionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DeleteCampaignCommand.ts b/clients/client-personalize/commands/DeleteCampaignCommand.ts index 37aab50c807ec..4fad017fe91d7 100644 --- a/clients/client-personalize/commands/DeleteCampaignCommand.ts +++ b/clients/client-personalize/commands/DeleteCampaignCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteCampaignCommandInput = DeleteCampaignRequest; export type DeleteCampaignCommandOutput = __MetadataBearer; +/** + *

Removes a campaign by deleting the solution deployment. The solution that + * the campaign is based on is not deleted and can be redeployed when needed. A deleted campaign can no + * longer be specified in a + * GetRecommendations + * request. + * For more information on campaigns, see CreateCampaign.

+ */ export class DeleteCampaignCommand extends $Command< DeleteCampaignCommandInput, DeleteCampaignCommandOutput, @@ -34,6 +42,9 @@ export class DeleteCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DeleteDatasetCommand.ts b/clients/client-personalize/commands/DeleteDatasetCommand.ts index d3bfb0bc5542d..04c0fbdc6ac60 100644 --- a/clients/client-personalize/commands/DeleteDatasetCommand.ts +++ b/clients/client-personalize/commands/DeleteDatasetCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteDatasetCommandInput = DeleteDatasetRequest; export type DeleteDatasetCommandOutput = __MetadataBearer; +/** + *

Deletes a dataset. You can't delete a dataset if an associated + * DatasetImportJob or SolutionVersion is in the CREATE PENDING or IN + * PROGRESS state. For more information on datasets, see CreateDataset.

+ */ export class DeleteDatasetCommand extends $Command< DeleteDatasetCommandInput, DeleteDatasetCommandOutput, @@ -34,6 +39,9 @@ export class DeleteDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DeleteDatasetGroupCommand.ts b/clients/client-personalize/commands/DeleteDatasetGroupCommand.ts index 4d506a4908fc1..65f77032962c9 100644 --- a/clients/client-personalize/commands/DeleteDatasetGroupCommand.ts +++ b/clients/client-personalize/commands/DeleteDatasetGroupCommand.ts @@ -20,6 +20,21 @@ import { export type DeleteDatasetGroupCommandInput = DeleteDatasetGroupRequest; export type DeleteDatasetGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a dataset group. Before you delete a dataset group, you must delete the + * following:

+ *
    + *
  • + *

    All associated event trackers.

    + *
  • + *
  • + *

    All associated solutions.

    + *
  • + *
  • + *

    All datasets in the dataset group.

    + *
  • + *
+ */ export class DeleteDatasetGroupCommand extends $Command< DeleteDatasetGroupCommandInput, DeleteDatasetGroupCommandOutput, @@ -34,6 +49,9 @@ export class DeleteDatasetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DeleteEventTrackerCommand.ts b/clients/client-personalize/commands/DeleteEventTrackerCommand.ts index 7519da5e314f8..8e7393b5c1f57 100644 --- a/clients/client-personalize/commands/DeleteEventTrackerCommand.ts +++ b/clients/client-personalize/commands/DeleteEventTrackerCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteEventTrackerCommandInput = DeleteEventTrackerRequest; export type DeleteEventTrackerCommandOutput = __MetadataBearer; +/** + *

Deletes the event tracker. Does not delete the event-interactions dataset from + * the associated dataset group. For more + * information on event trackers, see CreateEventTracker.

+ */ export class DeleteEventTrackerCommand extends $Command< DeleteEventTrackerCommandInput, DeleteEventTrackerCommandOutput, @@ -34,6 +39,9 @@ export class DeleteEventTrackerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DeleteFilterCommand.ts b/clients/client-personalize/commands/DeleteFilterCommand.ts index 86f546eb53ebe..e8aa2db72e8f5 100644 --- a/clients/client-personalize/commands/DeleteFilterCommand.ts +++ b/clients/client-personalize/commands/DeleteFilterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFilterCommandInput = DeleteFilterRequest; export type DeleteFilterCommandOutput = __MetadataBearer; +/** + *

Deletes a filter.

+ */ export class DeleteFilterCommand extends $Command< DeleteFilterCommandInput, DeleteFilterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DeleteSchemaCommand.ts b/clients/client-personalize/commands/DeleteSchemaCommand.ts index 12f740648d762..4bb048aa66145 100644 --- a/clients/client-personalize/commands/DeleteSchemaCommand.ts +++ b/clients/client-personalize/commands/DeleteSchemaCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteSchemaCommandInput = DeleteSchemaRequest; export type DeleteSchemaCommandOutput = __MetadataBearer; +/** + *

Deletes a schema. Before deleting a schema, you must delete all + * datasets referencing the schema. For more information on schemas, see + * CreateSchema.

+ */ export class DeleteSchemaCommand extends $Command< DeleteSchemaCommandInput, DeleteSchemaCommandOutput, @@ -34,6 +39,9 @@ export class DeleteSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DeleteSolutionCommand.ts b/clients/client-personalize/commands/DeleteSolutionCommand.ts index ddf11f1d3f153..be8e4a5ea9beb 100644 --- a/clients/client-personalize/commands/DeleteSolutionCommand.ts +++ b/clients/client-personalize/commands/DeleteSolutionCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteSolutionCommandInput = DeleteSolutionRequest; export type DeleteSolutionCommandOutput = __MetadataBearer; +/** + *

Deletes all versions of a solution and the Solution object itself. + * Before deleting a solution, you must delete all campaigns based on + * the solution. To determine what campaigns are using the solution, call + * ListCampaigns and supply the Amazon Resource Name (ARN) of the solution. + * You can't delete a solution if an associated SolutionVersion is in the + * CREATE PENDING or IN PROGRESS state. + * For more information on solutions, see CreateSolution.

+ */ export class DeleteSolutionCommand extends $Command< DeleteSolutionCommandInput, DeleteSolutionCommandOutput, @@ -34,6 +43,9 @@ export class DeleteSolutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeAlgorithmCommand.ts b/clients/client-personalize/commands/DescribeAlgorithmCommand.ts index d42c733c4e6bb..00d8d075828b8 100644 --- a/clients/client-personalize/commands/DescribeAlgorithmCommand.ts +++ b/clients/client-personalize/commands/DescribeAlgorithmCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAlgorithmCommandInput = DescribeAlgorithmRequest; export type DescribeAlgorithmCommandOutput = DescribeAlgorithmResponse & __MetadataBearer; +/** + *

Describes the given algorithm.

+ */ export class DescribeAlgorithmCommand extends $Command< DescribeAlgorithmCommandInput, DescribeAlgorithmCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAlgorithmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeBatchInferenceJobCommand.ts b/clients/client-personalize/commands/DescribeBatchInferenceJobCommand.ts index a3a8229a333f7..1a470dd3c67b9 100644 --- a/clients/client-personalize/commands/DescribeBatchInferenceJobCommand.ts +++ b/clients/client-personalize/commands/DescribeBatchInferenceJobCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeBatchInferenceJobCommandInput = DescribeBatchInferenceJobRequest; export type DescribeBatchInferenceJobCommandOutput = DescribeBatchInferenceJobResponse & __MetadataBearer; +/** + *

Gets the properties of a batch inference job including name, Amazon Resource Name (ARN), + * status, input and output configurations, and the ARN of the solution version used to generate + * the recommendations.

+ */ export class DescribeBatchInferenceJobCommand extends $Command< DescribeBatchInferenceJobCommandInput, DescribeBatchInferenceJobCommandOutput, @@ -34,6 +39,9 @@ export class DescribeBatchInferenceJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeCampaignCommand.ts b/clients/client-personalize/commands/DescribeCampaignCommand.ts index 2bee0e1f5c5a5..28484799a65dc 100644 --- a/clients/client-personalize/commands/DescribeCampaignCommand.ts +++ b/clients/client-personalize/commands/DescribeCampaignCommand.ts @@ -20,6 +20,21 @@ import { export type DescribeCampaignCommandInput = DescribeCampaignRequest; export type DescribeCampaignCommandOutput = DescribeCampaignResponse & __MetadataBearer; +/** + *

Describes the given campaign, including its status.

+ *

A campaign can be in one of the following states:

+ *
    + *
  • + *

    CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

    + *
  • + *
  • + *

    DELETE PENDING > DELETE IN_PROGRESS

    + *
  • + *
+ *

When the status is CREATE FAILED, the response includes the + * failureReason key, which describes why.

+ *

For more information on campaigns, see CreateCampaign.

+ */ export class DescribeCampaignCommand extends $Command< DescribeCampaignCommandInput, DescribeCampaignCommandOutput, @@ -34,6 +49,9 @@ export class DescribeCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeDatasetCommand.ts b/clients/client-personalize/commands/DescribeDatasetCommand.ts index 8e482bba6ddaa..92f72081fb0be 100644 --- a/clients/client-personalize/commands/DescribeDatasetCommand.ts +++ b/clients/client-personalize/commands/DescribeDatasetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDatasetCommandInput = DescribeDatasetRequest; export type DescribeDatasetCommandOutput = DescribeDatasetResponse & __MetadataBearer; +/** + *

Describes the given dataset. For more information on datasets, see CreateDataset.

+ */ export class DescribeDatasetCommand extends $Command< DescribeDatasetCommandInput, DescribeDatasetCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDatasetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeDatasetGroupCommand.ts b/clients/client-personalize/commands/DescribeDatasetGroupCommand.ts index 6600c17699e2e..084806a778238 100644 --- a/clients/client-personalize/commands/DescribeDatasetGroupCommand.ts +++ b/clients/client-personalize/commands/DescribeDatasetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDatasetGroupCommandInput = DescribeDatasetGroupRequest; export type DescribeDatasetGroupCommandOutput = DescribeDatasetGroupResponse & __MetadataBearer; +/** + *

Describes the given dataset group. For more information on dataset groups, see CreateDatasetGroup.

+ */ export class DescribeDatasetGroupCommand extends $Command< DescribeDatasetGroupCommandInput, DescribeDatasetGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDatasetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeDatasetImportJobCommand.ts b/clients/client-personalize/commands/DescribeDatasetImportJobCommand.ts index 74c2a889d80a1..183f0c1bc4157 100644 --- a/clients/client-personalize/commands/DescribeDatasetImportJobCommand.ts +++ b/clients/client-personalize/commands/DescribeDatasetImportJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDatasetImportJobCommandInput = DescribeDatasetImportJobRequest; export type DescribeDatasetImportJobCommandOutput = DescribeDatasetImportJobResponse & __MetadataBearer; +/** + *

Describes the dataset import job created by CreateDatasetImportJob, + * including the import job status.

+ */ export class DescribeDatasetImportJobCommand extends $Command< DescribeDatasetImportJobCommandInput, DescribeDatasetImportJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDatasetImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeEventTrackerCommand.ts b/clients/client-personalize/commands/DescribeEventTrackerCommand.ts index fa3d3b5115970..92d44523a5587 100644 --- a/clients/client-personalize/commands/DescribeEventTrackerCommand.ts +++ b/clients/client-personalize/commands/DescribeEventTrackerCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeEventTrackerCommandInput = DescribeEventTrackerRequest; export type DescribeEventTrackerCommandOutput = DescribeEventTrackerResponse & __MetadataBearer; +/** + *

Describes an event tracker. The response includes the trackingId and + * status of the event tracker. + * For more information on event trackers, see CreateEventTracker.

+ */ export class DescribeEventTrackerCommand extends $Command< DescribeEventTrackerCommandInput, DescribeEventTrackerCommandOutput, @@ -34,6 +39,9 @@ export class DescribeEventTrackerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeFeatureTransformationCommand.ts b/clients/client-personalize/commands/DescribeFeatureTransformationCommand.ts index 2bb8c6cbf6a50..810ddd7da653f 100644 --- a/clients/client-personalize/commands/DescribeFeatureTransformationCommand.ts +++ b/clients/client-personalize/commands/DescribeFeatureTransformationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFeatureTransformationCommandInput = DescribeFeatureTransformationRequest; export type DescribeFeatureTransformationCommandOutput = DescribeFeatureTransformationResponse & __MetadataBearer; +/** + *

Describes the given feature transformation.

+ */ export class DescribeFeatureTransformationCommand extends $Command< DescribeFeatureTransformationCommandInput, DescribeFeatureTransformationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFeatureTransformationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeFilterCommand.ts b/clients/client-personalize/commands/DescribeFilterCommand.ts index 97c4bdb26909f..30f643e35f2eb 100644 --- a/clients/client-personalize/commands/DescribeFilterCommand.ts +++ b/clients/client-personalize/commands/DescribeFilterCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFilterCommandInput = DescribeFilterRequest; export type DescribeFilterCommandOutput = DescribeFilterResponse & __MetadataBearer; +/** + *

Describes a filter's properties.

+ */ export class DescribeFilterCommand extends $Command< DescribeFilterCommandInput, DescribeFilterCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeRecipeCommand.ts b/clients/client-personalize/commands/DescribeRecipeCommand.ts index 2335cf659e27b..575a150a435f0 100644 --- a/clients/client-personalize/commands/DescribeRecipeCommand.ts +++ b/clients/client-personalize/commands/DescribeRecipeCommand.ts @@ -20,6 +20,27 @@ import { export type DescribeRecipeCommandInput = DescribeRecipeRequest; export type DescribeRecipeCommandOutput = DescribeRecipeResponse & __MetadataBearer; +/** + *

Describes a recipe.

+ *

A recipe contains three items:

+ *
    + *
  • + *

    An algorithm that trains a model.

    + *
  • + *
  • + *

    Hyperparameters that govern the training.

    + *
  • + *
  • + *

    Feature transformation information for modifying the input data before training.

    + *
  • + *
+ *

Amazon Personalize provides a set of predefined recipes. You specify a recipe when you create a + * solution with the CreateSolution API. + * CreateSolution trains a model by using the algorithm + * in the specified recipe and a training dataset. The solution, when deployed as a campaign, + * can provide recommendations using the + * GetRecommendations API.

+ */ export class DescribeRecipeCommand extends $Command< DescribeRecipeCommandInput, DescribeRecipeCommandOutput, @@ -34,6 +55,9 @@ export class DescribeRecipeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeSchemaCommand.ts b/clients/client-personalize/commands/DescribeSchemaCommand.ts index 472fdc2df7b0a..9406ae0e2dbe8 100644 --- a/clients/client-personalize/commands/DescribeSchemaCommand.ts +++ b/clients/client-personalize/commands/DescribeSchemaCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSchemaCommandInput = DescribeSchemaRequest; export type DescribeSchemaCommandOutput = DescribeSchemaResponse & __MetadataBearer; +/** + *

Describes a schema. For more information on schemas, see + * CreateSchema.

+ */ export class DescribeSchemaCommand extends $Command< DescribeSchemaCommandInput, DescribeSchemaCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeSolutionCommand.ts b/clients/client-personalize/commands/DescribeSolutionCommand.ts index 4234135ea2b00..8cdbea0e2cfc2 100644 --- a/clients/client-personalize/commands/DescribeSolutionCommand.ts +++ b/clients/client-personalize/commands/DescribeSolutionCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSolutionCommandInput = DescribeSolutionRequest; export type DescribeSolutionCommandOutput = DescribeSolutionResponse & __MetadataBearer; +/** + *

Describes a solution. + * For more information on solutions, see CreateSolution.

+ */ export class DescribeSolutionCommand extends $Command< DescribeSolutionCommandInput, DescribeSolutionCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSolutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/DescribeSolutionVersionCommand.ts b/clients/client-personalize/commands/DescribeSolutionVersionCommand.ts index aa86ef9f6f753..0008e0e4ebacb 100644 --- a/clients/client-personalize/commands/DescribeSolutionVersionCommand.ts +++ b/clients/client-personalize/commands/DescribeSolutionVersionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSolutionVersionCommandInput = DescribeSolutionVersionRequest; export type DescribeSolutionVersionCommandOutput = DescribeSolutionVersionResponse & __MetadataBearer; +/** + *

Describes a specific version of a solution. For more information on solutions, see CreateSolution.

+ */ export class DescribeSolutionVersionCommand extends $Command< DescribeSolutionVersionCommandInput, DescribeSolutionVersionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSolutionVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/GetSolutionMetricsCommand.ts b/clients/client-personalize/commands/GetSolutionMetricsCommand.ts index c509e1cbd4a77..ba2bd09466cb9 100644 --- a/clients/client-personalize/commands/GetSolutionMetricsCommand.ts +++ b/clients/client-personalize/commands/GetSolutionMetricsCommand.ts @@ -20,6 +20,9 @@ import { export type GetSolutionMetricsCommandInput = GetSolutionMetricsRequest; export type GetSolutionMetricsCommandOutput = GetSolutionMetricsResponse & __MetadataBearer; +/** + *

Gets the metrics for the specified solution version.

+ */ export class GetSolutionMetricsCommand extends $Command< GetSolutionMetricsCommandInput, GetSolutionMetricsCommandOutput, @@ -34,6 +37,9 @@ export class GetSolutionMetricsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListBatchInferenceJobsCommand.ts b/clients/client-personalize/commands/ListBatchInferenceJobsCommand.ts index 1dd43f0278ee3..811972625daae 100644 --- a/clients/client-personalize/commands/ListBatchInferenceJobsCommand.ts +++ b/clients/client-personalize/commands/ListBatchInferenceJobsCommand.ts @@ -20,6 +20,10 @@ import { export type ListBatchInferenceJobsCommandInput = ListBatchInferenceJobsRequest; export type ListBatchInferenceJobsCommandOutput = ListBatchInferenceJobsResponse & __MetadataBearer; +/** + *

Gets a list of the batch inference jobs that have been performed off of a solution + * version.

+ */ export class ListBatchInferenceJobsCommand extends $Command< ListBatchInferenceJobsCommandInput, ListBatchInferenceJobsCommandOutput, @@ -34,6 +38,9 @@ export class ListBatchInferenceJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListCampaignsCommand.ts b/clients/client-personalize/commands/ListCampaignsCommand.ts index 2a5d55cc06baf..22f44806d99c4 100644 --- a/clients/client-personalize/commands/ListCampaignsCommand.ts +++ b/clients/client-personalize/commands/ListCampaignsCommand.ts @@ -20,6 +20,12 @@ import { export type ListCampaignsCommandInput = ListCampaignsRequest; export type ListCampaignsCommandOutput = ListCampaignsResponse & __MetadataBearer; +/** + *

Returns a list of campaigns that use the given solution. + * When a solution is not specified, all the campaigns associated with the account are listed. + * The response provides the properties for each campaign, including the Amazon Resource Name (ARN). + * For more information on campaigns, see CreateCampaign.

+ */ export class ListCampaignsCommand extends $Command< ListCampaignsCommandInput, ListCampaignsCommandOutput, @@ -34,6 +40,9 @@ export class ListCampaignsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListDatasetGroupsCommand.ts b/clients/client-personalize/commands/ListDatasetGroupsCommand.ts index 8d8423a47b884..126e9c5495a23 100644 --- a/clients/client-personalize/commands/ListDatasetGroupsCommand.ts +++ b/clients/client-personalize/commands/ListDatasetGroupsCommand.ts @@ -20,6 +20,11 @@ import { export type ListDatasetGroupsCommandInput = ListDatasetGroupsRequest; export type ListDatasetGroupsCommandOutput = ListDatasetGroupsResponse & __MetadataBearer; +/** + *

Returns a list of dataset groups. The response provides the properties for each dataset + * group, including the Amazon Resource Name (ARN). For more information on dataset groups, see + * CreateDatasetGroup.

+ */ export class ListDatasetGroupsCommand extends $Command< ListDatasetGroupsCommandInput, ListDatasetGroupsCommandOutput, @@ -34,6 +39,9 @@ export class ListDatasetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListDatasetImportJobsCommand.ts b/clients/client-personalize/commands/ListDatasetImportJobsCommand.ts index 59a7f3c2213e0..200e950708f63 100644 --- a/clients/client-personalize/commands/ListDatasetImportJobsCommand.ts +++ b/clients/client-personalize/commands/ListDatasetImportJobsCommand.ts @@ -20,6 +20,13 @@ import { export type ListDatasetImportJobsCommandInput = ListDatasetImportJobsRequest; export type ListDatasetImportJobsCommandOutput = ListDatasetImportJobsResponse & __MetadataBearer; +/** + *

Returns a list of dataset import jobs that use the given dataset. When a dataset is not + * specified, all the dataset import jobs associated with the account are listed. The response + * provides the properties for each dataset import job, including the Amazon Resource Name (ARN). + * For more information on dataset import jobs, see CreateDatasetImportJob. For + * more information on datasets, see CreateDataset.

+ */ export class ListDatasetImportJobsCommand extends $Command< ListDatasetImportJobsCommandInput, ListDatasetImportJobsCommandOutput, @@ -34,6 +41,9 @@ export class ListDatasetImportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListDatasetsCommand.ts b/clients/client-personalize/commands/ListDatasetsCommand.ts index 15c2a9d0333e1..1df64ce14e050 100644 --- a/clients/client-personalize/commands/ListDatasetsCommand.ts +++ b/clients/client-personalize/commands/ListDatasetsCommand.ts @@ -20,6 +20,11 @@ import { export type ListDatasetsCommandInput = ListDatasetsRequest; export type ListDatasetsCommandOutput = ListDatasetsResponse & __MetadataBearer; +/** + *

Returns the list of datasets contained in the given dataset group. The response provides + * the properties for each dataset, including the Amazon Resource Name (ARN). For more + * information on datasets, see CreateDataset.

+ */ export class ListDatasetsCommand extends $Command< ListDatasetsCommandInput, ListDatasetsCommandOutput, @@ -34,6 +39,9 @@ export class ListDatasetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListEventTrackersCommand.ts b/clients/client-personalize/commands/ListEventTrackersCommand.ts index 6fa176672153f..96e9adb874983 100644 --- a/clients/client-personalize/commands/ListEventTrackersCommand.ts +++ b/clients/client-personalize/commands/ListEventTrackersCommand.ts @@ -20,6 +20,12 @@ import { export type ListEventTrackersCommandInput = ListEventTrackersRequest; export type ListEventTrackersCommandOutput = ListEventTrackersResponse & __MetadataBearer; +/** + *

Returns the list of event trackers associated with the account. + * The response provides the properties for each event tracker, including the Amazon Resource + * Name (ARN) and tracking ID. For more + * information on event trackers, see CreateEventTracker.

+ */ export class ListEventTrackersCommand extends $Command< ListEventTrackersCommandInput, ListEventTrackersCommandOutput, @@ -34,6 +40,9 @@ export class ListEventTrackersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListFiltersCommand.ts b/clients/client-personalize/commands/ListFiltersCommand.ts index 668c7a3faec4e..00a8b06389dac 100644 --- a/clients/client-personalize/commands/ListFiltersCommand.ts +++ b/clients/client-personalize/commands/ListFiltersCommand.ts @@ -20,6 +20,9 @@ import { export type ListFiltersCommandInput = ListFiltersRequest; export type ListFiltersCommandOutput = ListFiltersResponse & __MetadataBearer; +/** + *

Lists all filters that belong to a given dataset group.

+ */ export class ListFiltersCommand extends $Command< ListFiltersCommandInput, ListFiltersCommandOutput, @@ -34,6 +37,9 @@ export class ListFiltersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListRecipesCommand.ts b/clients/client-personalize/commands/ListRecipesCommand.ts index 40db2e8af206a..8014affb7a020 100644 --- a/clients/client-personalize/commands/ListRecipesCommand.ts +++ b/clients/client-personalize/commands/ListRecipesCommand.ts @@ -20,6 +20,10 @@ import { export type ListRecipesCommandInput = ListRecipesRequest; export type ListRecipesCommandOutput = ListRecipesResponse & __MetadataBearer; +/** + *

Returns a list of available recipes. The response provides the properties + * for each recipe, including the recipe's Amazon Resource Name (ARN).

+ */ export class ListRecipesCommand extends $Command< ListRecipesCommandInput, ListRecipesCommandOutput, @@ -34,6 +38,9 @@ export class ListRecipesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListSchemasCommand.ts b/clients/client-personalize/commands/ListSchemasCommand.ts index e06173eddc198..0f9a5bfb83ba1 100644 --- a/clients/client-personalize/commands/ListSchemasCommand.ts +++ b/clients/client-personalize/commands/ListSchemasCommand.ts @@ -20,6 +20,11 @@ import { export type ListSchemasCommandInput = ListSchemasRequest; export type ListSchemasCommandOutput = ListSchemasResponse & __MetadataBearer; +/** + *

Returns the list of schemas associated with the account. The response provides the + * properties for each schema, including the Amazon Resource Name (ARN). + * For more information on schemas, see CreateSchema.

+ */ export class ListSchemasCommand extends $Command< ListSchemasCommandInput, ListSchemasCommandOutput, @@ -34,6 +39,9 @@ export class ListSchemasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListSolutionVersionsCommand.ts b/clients/client-personalize/commands/ListSolutionVersionsCommand.ts index 17887319aebbb..af94f371d7a6e 100644 --- a/clients/client-personalize/commands/ListSolutionVersionsCommand.ts +++ b/clients/client-personalize/commands/ListSolutionVersionsCommand.ts @@ -20,6 +20,12 @@ import { export type ListSolutionVersionsCommandInput = ListSolutionVersionsRequest; export type ListSolutionVersionsCommandOutput = ListSolutionVersionsResponse & __MetadataBearer; +/** + *

Returns a list of solution versions for the given solution. When a solution is not + * specified, all the solution versions associated with the account are listed. The response + * provides the properties for each solution version, including the Amazon Resource Name (ARN). + * For more information on solutions, see CreateSolution.

+ */ export class ListSolutionVersionsCommand extends $Command< ListSolutionVersionsCommandInput, ListSolutionVersionsCommandOutput, @@ -34,6 +40,9 @@ export class ListSolutionVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/ListSolutionsCommand.ts b/clients/client-personalize/commands/ListSolutionsCommand.ts index 848b0061b0622..69b45bf05e9f8 100644 --- a/clients/client-personalize/commands/ListSolutionsCommand.ts +++ b/clients/client-personalize/commands/ListSolutionsCommand.ts @@ -20,6 +20,12 @@ import { export type ListSolutionsCommandInput = ListSolutionsRequest; export type ListSolutionsCommandOutput = ListSolutionsResponse & __MetadataBearer; +/** + *

Returns a list of solutions that use the given dataset group. + * When a dataset group is not specified, all the solutions associated with the account are listed. + * The response provides the properties for each solution, including the Amazon Resource Name (ARN). + * For more information on solutions, see CreateSolution.

+ */ export class ListSolutionsCommand extends $Command< ListSolutionsCommandInput, ListSolutionsCommandOutput, @@ -34,6 +40,9 @@ export class ListSolutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/commands/UpdateCampaignCommand.ts b/clients/client-personalize/commands/UpdateCampaignCommand.ts index dbdb32ca0166e..fbc50ff87362f 100644 --- a/clients/client-personalize/commands/UpdateCampaignCommand.ts +++ b/clients/client-personalize/commands/UpdateCampaignCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateCampaignCommandInput = UpdateCampaignRequest; export type UpdateCampaignCommandOutput = UpdateCampaignResponse & __MetadataBearer; +/** + *

Updates a campaign by either deploying a new solution or changing the value of the + * campaign's minProvisionedTPS parameter.

+ *

To update a campaign, the campaign status must be ACTIVE or CREATE FAILED. + * Check the campaign status using the DescribeCampaign API.

+ * + *

You must wait until the status of the + * updated campaign is ACTIVE before asking the campaign for recommendations.

+ *
+ *

For more information on campaigns, see CreateCampaign.

+ */ export class UpdateCampaignCommand extends $Command< UpdateCampaignCommandInput, UpdateCampaignCommandOutput, @@ -34,6 +45,9 @@ export class UpdateCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PersonalizeClientResolvedConfig, diff --git a/clients/client-personalize/package.json b/clients/client-personalize/package.json index 9accf8e5a0b1a..ec38a25fc53e0 100644 --- a/clients/client-personalize/package.json +++ b/clients/client-personalize/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Personalize Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-personalize/pagination/ListBatchInferenceJobsPaginator.ts b/clients/client-personalize/pagination/ListBatchInferenceJobsPaginator.ts index 6b1ca752ebb63..1da68513295af 100644 --- a/clients/client-personalize/pagination/ListBatchInferenceJobsPaginator.ts +++ b/clients/client-personalize/pagination/ListBatchInferenceJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListBatchInferenceJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBatchInferenceJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListBatchInferenceJobsCommandInput, diff --git a/clients/client-personalize/pagination/ListCampaignsPaginator.ts b/clients/client-personalize/pagination/ListCampaignsPaginator.ts index 4e74d235e8248..14b6188e4f07d 100644 --- a/clients/client-personalize/pagination/ListCampaignsPaginator.ts +++ b/clients/client-personalize/pagination/ListCampaignsPaginator.ts @@ -8,6 +8,9 @@ import { import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListCampaignsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCampaignsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListCampaignsCommandInput, diff --git a/clients/client-personalize/pagination/ListDatasetGroupsPaginator.ts b/clients/client-personalize/pagination/ListDatasetGroupsPaginator.ts index 0f8ea20067a1d..91df9e042a78c 100644 --- a/clients/client-personalize/pagination/ListDatasetGroupsPaginator.ts +++ b/clients/client-personalize/pagination/ListDatasetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListDatasetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListDatasetGroupsCommandInput, diff --git a/clients/client-personalize/pagination/ListDatasetImportJobsPaginator.ts b/clients/client-personalize/pagination/ListDatasetImportJobsPaginator.ts index e4916a7f4c119..774aa17a1d586 100644 --- a/clients/client-personalize/pagination/ListDatasetImportJobsPaginator.ts +++ b/clients/client-personalize/pagination/ListDatasetImportJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListDatasetImportJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetImportJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListDatasetImportJobsCommandInput, diff --git a/clients/client-personalize/pagination/ListDatasetsPaginator.ts b/clients/client-personalize/pagination/ListDatasetsPaginator.ts index 4e35ad563b29c..63db7fec9024b 100644 --- a/clients/client-personalize/pagination/ListDatasetsPaginator.ts +++ b/clients/client-personalize/pagination/ListDatasetsPaginator.ts @@ -8,6 +8,9 @@ import { import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListDatasetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatasetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListDatasetsCommandInput, diff --git a/clients/client-personalize/pagination/ListEventTrackersPaginator.ts b/clients/client-personalize/pagination/ListEventTrackersPaginator.ts index 9e244e1f333f2..2911244770fd0 100644 --- a/clients/client-personalize/pagination/ListEventTrackersPaginator.ts +++ b/clients/client-personalize/pagination/ListEventTrackersPaginator.ts @@ -8,6 +8,9 @@ import { import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListEventTrackersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEventTrackersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListEventTrackersCommandInput, diff --git a/clients/client-personalize/pagination/ListRecipesPaginator.ts b/clients/client-personalize/pagination/ListRecipesPaginator.ts index 42bdf08885369..3604761f4fded 100644 --- a/clients/client-personalize/pagination/ListRecipesPaginator.ts +++ b/clients/client-personalize/pagination/ListRecipesPaginator.ts @@ -4,6 +4,9 @@ import { ListRecipesCommand, ListRecipesCommandInput, ListRecipesCommandOutput } import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListRecipesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRecipesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListRecipesCommandInput, diff --git a/clients/client-personalize/pagination/ListSchemasPaginator.ts b/clients/client-personalize/pagination/ListSchemasPaginator.ts index 051047019cbc5..d8af56e9437dd 100644 --- a/clients/client-personalize/pagination/ListSchemasPaginator.ts +++ b/clients/client-personalize/pagination/ListSchemasPaginator.ts @@ -4,6 +4,9 @@ import { ListSchemasCommand, ListSchemasCommandInput, ListSchemasCommandOutput } import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListSchemasCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSchemasCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListSchemasCommandInput, diff --git a/clients/client-personalize/pagination/ListSolutionVersionsPaginator.ts b/clients/client-personalize/pagination/ListSolutionVersionsPaginator.ts index dc3a2db22cbf1..1f1d2e60e8c4e 100644 --- a/clients/client-personalize/pagination/ListSolutionVersionsPaginator.ts +++ b/clients/client-personalize/pagination/ListSolutionVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListSolutionVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSolutionVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListSolutionVersionsCommandInput, diff --git a/clients/client-personalize/pagination/ListSolutionsPaginator.ts b/clients/client-personalize/pagination/ListSolutionsPaginator.ts index 03c9a84471202..12507aa4e9909 100644 --- a/clients/client-personalize/pagination/ListSolutionsPaginator.ts +++ b/clients/client-personalize/pagination/ListSolutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { PersonalizePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PersonalizeClient, input: ListSolutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSolutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Personalize, input: ListSolutionsCommandInput, diff --git a/clients/client-personalize/runtimeConfig.browser.ts b/clients/client-personalize/runtimeConfig.browser.ts index db6a871da9cb7..ca912482eb641 100644 --- a/clients/client-personalize/runtimeConfig.browser.ts +++ b/clients/client-personalize/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PersonalizeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-personalize/runtimeConfig.native.ts b/clients/client-personalize/runtimeConfig.native.ts index 02aeb004a8b7f..21b3daa6c979c 100644 --- a/clients/client-personalize/runtimeConfig.native.ts +++ b/clients/client-personalize/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PersonalizeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-personalize/runtimeConfig.shared.ts b/clients/client-personalize/runtimeConfig.shared.ts index 8f36460e42a6b..bc6479c212447 100644 --- a/clients/client-personalize/runtimeConfig.shared.ts +++ b/clients/client-personalize/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-05-22", disableHostPrefix: false, diff --git a/clients/client-personalize/runtimeConfig.ts b/clients/client-personalize/runtimeConfig.ts index 252db2d7fab2c..842195f9f8917 100644 --- a/clients/client-personalize/runtimeConfig.ts +++ b/clients/client-personalize/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PersonalizeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-personalize/tsconfig.json b/clients/client-personalize/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-personalize/tsconfig.json +++ b/clients/client-personalize/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-pi/commands/DescribeDimensionKeysCommand.ts b/clients/client-pi/commands/DescribeDimensionKeysCommand.ts index 29d4bd6131d7f..c3ed7b70315d4 100644 --- a/clients/client-pi/commands/DescribeDimensionKeysCommand.ts +++ b/clients/client-pi/commands/DescribeDimensionKeysCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDimensionKeysCommandInput = DescribeDimensionKeysRequest; export type DescribeDimensionKeysCommandOutput = DescribeDimensionKeysResponse & __MetadataBearer; +/** + *

For a specific time period, retrieve the top N dimension keys for a + * metric.

+ */ export class DescribeDimensionKeysCommand extends $Command< DescribeDimensionKeysCommandInput, DescribeDimensionKeysCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDimensionKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PIClientResolvedConfig, diff --git a/clients/client-pi/commands/GetResourceMetricsCommand.ts b/clients/client-pi/commands/GetResourceMetricsCommand.ts index 759300f0cb619..fd5d108af7c0d 100644 --- a/clients/client-pi/commands/GetResourceMetricsCommand.ts +++ b/clients/client-pi/commands/GetResourceMetricsCommand.ts @@ -20,6 +20,11 @@ import { export type GetResourceMetricsCommandInput = GetResourceMetricsRequest; export type GetResourceMetricsCommandOutput = GetResourceMetricsResponse & __MetadataBearer; +/** + *

Retrieve Performance Insights metrics for a set of data sources, over a time period. You can provide + * specific dimension groups and dimensions, and provide aggregation and filtering criteria for + * each group.

+ */ export class GetResourceMetricsCommand extends $Command< GetResourceMetricsCommandInput, GetResourceMetricsCommandOutput, @@ -34,6 +39,9 @@ export class GetResourceMetricsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PIClientResolvedConfig, diff --git a/clients/client-pi/package.json b/clients/client-pi/package.json index f54c004258b4d..8b37ac39734f9 100644 --- a/clients/client-pi/package.json +++ b/clients/client-pi/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Pi Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-pi/runtimeConfig.browser.ts b/clients/client-pi/runtimeConfig.browser.ts index 871f031f33fb9..cd28bf3be0c2f 100644 --- a/clients/client-pi/runtimeConfig.browser.ts +++ b/clients/client-pi/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PIClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-pi/runtimeConfig.native.ts b/clients/client-pi/runtimeConfig.native.ts index 573e9cd7bed0a..a21490f338d42 100644 --- a/clients/client-pi/runtimeConfig.native.ts +++ b/clients/client-pi/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PIClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-pi/runtimeConfig.shared.ts b/clients/client-pi/runtimeConfig.shared.ts index 826724b4c491a..231fe51daa3c3 100644 --- a/clients/client-pi/runtimeConfig.shared.ts +++ b/clients/client-pi/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-02-27", disableHostPrefix: false, diff --git a/clients/client-pi/runtimeConfig.ts b/clients/client-pi/runtimeConfig.ts index 5b77a2dbe9449..d6c06c872fd5d 100644 --- a/clients/client-pi/runtimeConfig.ts +++ b/clients/client-pi/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PIClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-pi/tsconfig.json b/clients/client-pi/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-pi/tsconfig.json +++ b/clients/client-pi/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-pinpoint-email/commands/CreateConfigurationSetCommand.ts b/clients/client-pinpoint-email/commands/CreateConfigurationSetCommand.ts index b96d951ed4258..14f28af63c467 100644 --- a/clients/client-pinpoint-email/commands/CreateConfigurationSetCommand.ts +++ b/clients/client-pinpoint-email/commands/CreateConfigurationSetCommand.ts @@ -20,6 +20,13 @@ import { export type CreateConfigurationSetCommandInput = CreateConfigurationSetRequest; export type CreateConfigurationSetCommandOutput = CreateConfigurationSetResponse & __MetadataBearer; +/** + *

Create a configuration set. Configuration sets are groups of + * rules that you can apply to the emails you send using Amazon Pinpoint. You apply a configuration + * set to an email by including a reference to the configuration set in the headers of the + * email. When you apply a configuration set to an email, all of the rules in that + * configuration set are applied to the email.

+ */ export class CreateConfigurationSetCommand extends $Command< CreateConfigurationSetCommandInput, CreateConfigurationSetCommandOutput, @@ -34,6 +41,9 @@ export class CreateConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/CreateConfigurationSetEventDestinationCommand.ts b/clients/client-pinpoint-email/commands/CreateConfigurationSetEventDestinationCommand.ts index 2b9e1b2ce4b11..fc5865f5ec696 100644 --- a/clients/client-pinpoint-email/commands/CreateConfigurationSetEventDestinationCommand.ts +++ b/clients/client-pinpoint-email/commands/CreateConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,15 @@ export type CreateConfigurationSetEventDestinationCommandInput = CreateConfigura export type CreateConfigurationSetEventDestinationCommandOutput = CreateConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Create an event destination. In Amazon Pinpoint, events include message + * sends, deliveries, opens, clicks, bounces, and complaints. Event + * destinations are places that you can send information about these events + * to. For example, you can send event data to Amazon SNS to receive notifications when you + * receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term + * storage.

+ *

A single configuration set can include more than one event destination.

+ */ export class CreateConfigurationSetEventDestinationCommand extends $Command< CreateConfigurationSetEventDestinationCommandInput, CreateConfigurationSetEventDestinationCommandOutput, @@ -38,6 +47,9 @@ export class CreateConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/CreateDedicatedIpPoolCommand.ts b/clients/client-pinpoint-email/commands/CreateDedicatedIpPoolCommand.ts index 8339a8b7d74cb..9c532b9443265 100644 --- a/clients/client-pinpoint-email/commands/CreateDedicatedIpPoolCommand.ts +++ b/clients/client-pinpoint-email/commands/CreateDedicatedIpPoolCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDedicatedIpPoolCommandInput = CreateDedicatedIpPoolRequest; export type CreateDedicatedIpPoolCommandOutput = CreateDedicatedIpPoolResponse & __MetadataBearer; +/** + *

Create a new pool of dedicated IP addresses. A pool can include one or more dedicated + * IP addresses that are associated with your Amazon Pinpoint account. You can associate a pool with + * a configuration set. When you send an email that uses that configuration set, Amazon Pinpoint + * sends it using only the IP addresses in the associated pool.

+ */ export class CreateDedicatedIpPoolCommand extends $Command< CreateDedicatedIpPoolCommandInput, CreateDedicatedIpPoolCommandOutput, @@ -34,6 +40,9 @@ export class CreateDedicatedIpPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/CreateDeliverabilityTestReportCommand.ts b/clients/client-pinpoint-email/commands/CreateDeliverabilityTestReportCommand.ts index adb62a84f5e52..30c759b172079 100644 --- a/clients/client-pinpoint-email/commands/CreateDeliverabilityTestReportCommand.ts +++ b/clients/client-pinpoint-email/commands/CreateDeliverabilityTestReportCommand.ts @@ -20,6 +20,15 @@ import { export type CreateDeliverabilityTestReportCommandInput = CreateDeliverabilityTestReportRequest; export type CreateDeliverabilityTestReportCommandOutput = CreateDeliverabilityTestReportResponse & __MetadataBearer; +/** + *

Create a new predictive inbox placement test. Predictive inbox placement tests can help you predict how your messages will be handled + * by various email providers around the world. When you perform a predictive inbox placement test, you provide a + * sample message that contains the content that you plan to send to your customers. Amazon Pinpoint + * then sends that message to special email addresses spread across several major email + * providers. After about 24 hours, the test is complete, and you can use the + * GetDeliverabilityTestReport operation to view the results of the + * test.

+ */ export class CreateDeliverabilityTestReportCommand extends $Command< CreateDeliverabilityTestReportCommandInput, CreateDeliverabilityTestReportCommandOutput, @@ -34,6 +43,9 @@ export class CreateDeliverabilityTestReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/CreateEmailIdentityCommand.ts b/clients/client-pinpoint-email/commands/CreateEmailIdentityCommand.ts index d5c419ab03552..652979641c93e 100644 --- a/clients/client-pinpoint-email/commands/CreateEmailIdentityCommand.ts +++ b/clients/client-pinpoint-email/commands/CreateEmailIdentityCommand.ts @@ -20,6 +20,22 @@ import { export type CreateEmailIdentityCommandInput = CreateEmailIdentityRequest; export type CreateEmailIdentityCommandOutput = CreateEmailIdentityResponse & __MetadataBearer; +/** + *

Verifies an email identity for use with Amazon Pinpoint. In Amazon Pinpoint, an identity is an email + * address or domain that you use when you send email. Before you can use an identity to + * send email with Amazon Pinpoint, you first have to verify it. By verifying an address, you + * demonstrate that you're the owner of the address, and that you've given Amazon Pinpoint permission + * to send email from the address.

+ *

When you verify an email address, Amazon Pinpoint sends an email to the address. Your email + * address is verified as soon as you follow the link in the verification email. + * + *

+ *

When you verify a domain, this operation provides a set of DKIM tokens, which you can + * convert into CNAME tokens. You add these CNAME tokens to the DNS configuration for your + * domain. Your domain is verified when Amazon Pinpoint detects these records in the DNS + * configuration for your domain. It usually takes around 72 hours to complete the domain + * verification process.

+ */ export class CreateEmailIdentityCommand extends $Command< CreateEmailIdentityCommandInput, CreateEmailIdentityCommandOutput, @@ -34,6 +50,9 @@ export class CreateEmailIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/DeleteConfigurationSetCommand.ts b/clients/client-pinpoint-email/commands/DeleteConfigurationSetCommand.ts index b83edc861e822..7d6417cc43e0f 100644 --- a/clients/client-pinpoint-email/commands/DeleteConfigurationSetCommand.ts +++ b/clients/client-pinpoint-email/commands/DeleteConfigurationSetCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteConfigurationSetCommandInput = DeleteConfigurationSetRequest; export type DeleteConfigurationSetCommandOutput = DeleteConfigurationSetResponse & __MetadataBearer; +/** + *

Delete an existing configuration set.

+ *

In Amazon Pinpoint, configuration sets are groups of rules that you can + * apply to the emails you send. You apply a configuration set to an email by including a + * reference to the configuration set in the headers of the email. When you apply a + * configuration set to an email, all of the rules in that configuration set are applied to + * the email.

+ */ export class DeleteConfigurationSetCommand extends $Command< DeleteConfigurationSetCommandInput, DeleteConfigurationSetCommandOutput, @@ -34,6 +42,9 @@ export class DeleteConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/DeleteConfigurationSetEventDestinationCommand.ts b/clients/client-pinpoint-email/commands/DeleteConfigurationSetEventDestinationCommand.ts index a9ba09df99493..e4111ff28f289 100644 --- a/clients/client-pinpoint-email/commands/DeleteConfigurationSetEventDestinationCommand.ts +++ b/clients/client-pinpoint-email/commands/DeleteConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,14 @@ export type DeleteConfigurationSetEventDestinationCommandInput = DeleteConfigura export type DeleteConfigurationSetEventDestinationCommandOutput = DeleteConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Delete an event destination.

+ *

In Amazon Pinpoint, events include message sends, deliveries, opens, + * clicks, bounces, and complaints. Event destinations are places that + * you can send information about these events to. For example, you can send event data to + * Amazon SNS to receive notifications when you receive bounces or complaints, or you can use + * Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term storage.

+ */ export class DeleteConfigurationSetEventDestinationCommand extends $Command< DeleteConfigurationSetEventDestinationCommandInput, DeleteConfigurationSetEventDestinationCommandOutput, @@ -38,6 +46,9 @@ export class DeleteConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/DeleteDedicatedIpPoolCommand.ts b/clients/client-pinpoint-email/commands/DeleteDedicatedIpPoolCommand.ts index 8ff597450e2cb..3fcd9ec423031 100644 --- a/clients/client-pinpoint-email/commands/DeleteDedicatedIpPoolCommand.ts +++ b/clients/client-pinpoint-email/commands/DeleteDedicatedIpPoolCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDedicatedIpPoolCommandInput = DeleteDedicatedIpPoolRequest; export type DeleteDedicatedIpPoolCommandOutput = DeleteDedicatedIpPoolResponse & __MetadataBearer; +/** + *

Delete a dedicated IP pool.

+ */ export class DeleteDedicatedIpPoolCommand extends $Command< DeleteDedicatedIpPoolCommandInput, DeleteDedicatedIpPoolCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDedicatedIpPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/DeleteEmailIdentityCommand.ts b/clients/client-pinpoint-email/commands/DeleteEmailIdentityCommand.ts index cb9622c068376..4bca89ffca8a3 100644 --- a/clients/client-pinpoint-email/commands/DeleteEmailIdentityCommand.ts +++ b/clients/client-pinpoint-email/commands/DeleteEmailIdentityCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteEmailIdentityCommandInput = DeleteEmailIdentityRequest; export type DeleteEmailIdentityCommandOutput = DeleteEmailIdentityResponse & __MetadataBearer; +/** + *

Deletes an email identity that you previously verified for use with Amazon Pinpoint. An identity + * can be either an email address or a domain name.

+ */ export class DeleteEmailIdentityCommand extends $Command< DeleteEmailIdentityCommandInput, DeleteEmailIdentityCommandOutput, @@ -34,6 +38,9 @@ export class DeleteEmailIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetAccountCommand.ts b/clients/client-pinpoint-email/commands/GetAccountCommand.ts index 9741e7a6aaba0..442e514b35f62 100644 --- a/clients/client-pinpoint-email/commands/GetAccountCommand.ts +++ b/clients/client-pinpoint-email/commands/GetAccountCommand.ts @@ -20,6 +20,10 @@ import { export type GetAccountCommandInput = GetAccountRequest; export type GetAccountCommandOutput = GetAccountResponse & __MetadataBearer; +/** + *

Obtain information about the email-sending status and capabilities of your Amazon Pinpoint + * account in the current AWS Region.

+ */ export class GetAccountCommand extends $Command< GetAccountCommandInput, GetAccountCommandOutput, @@ -34,6 +38,9 @@ export class GetAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetBlacklistReportsCommand.ts b/clients/client-pinpoint-email/commands/GetBlacklistReportsCommand.ts index 3a269c10a8556..3f7c3a79c4f92 100644 --- a/clients/client-pinpoint-email/commands/GetBlacklistReportsCommand.ts +++ b/clients/client-pinpoint-email/commands/GetBlacklistReportsCommand.ts @@ -20,6 +20,9 @@ import { export type GetBlacklistReportsCommandInput = GetBlacklistReportsRequest; export type GetBlacklistReportsCommandOutput = GetBlacklistReportsResponse & __MetadataBearer; +/** + *

Retrieve a list of the blacklists that your dedicated IP addresses appear on.

+ */ export class GetBlacklistReportsCommand extends $Command< GetBlacklistReportsCommandInput, GetBlacklistReportsCommandOutput, @@ -34,6 +37,9 @@ export class GetBlacklistReportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetConfigurationSetCommand.ts b/clients/client-pinpoint-email/commands/GetConfigurationSetCommand.ts index 539e5d3729f18..45c240b847bd1 100644 --- a/clients/client-pinpoint-email/commands/GetConfigurationSetCommand.ts +++ b/clients/client-pinpoint-email/commands/GetConfigurationSetCommand.ts @@ -20,6 +20,16 @@ import { export type GetConfigurationSetCommandInput = GetConfigurationSetRequest; export type GetConfigurationSetCommandOutput = GetConfigurationSetResponse & __MetadataBearer; +/** + *

Get information about an existing configuration set, including the dedicated IP pool + * that it's associated with, whether or not it's enabled for sending email, and + * more.

+ *

In Amazon Pinpoint, configuration sets are groups of rules that you can + * apply to the emails you send. You apply a configuration set to an email by including a + * reference to the configuration set in the headers of the email. When you apply a + * configuration set to an email, all of the rules in that configuration set are applied to + * the email.

+ */ export class GetConfigurationSetCommand extends $Command< GetConfigurationSetCommandInput, GetConfigurationSetCommandOutput, @@ -34,6 +44,9 @@ export class GetConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetConfigurationSetEventDestinationsCommand.ts b/clients/client-pinpoint-email/commands/GetConfigurationSetEventDestinationsCommand.ts index 06b3e500b9de0..c89654a2fa5fe 100644 --- a/clients/client-pinpoint-email/commands/GetConfigurationSetEventDestinationsCommand.ts +++ b/clients/client-pinpoint-email/commands/GetConfigurationSetEventDestinationsCommand.ts @@ -24,6 +24,15 @@ export type GetConfigurationSetEventDestinationsCommandInput = GetConfigurationS export type GetConfigurationSetEventDestinationsCommandOutput = GetConfigurationSetEventDestinationsResponse & __MetadataBearer; +/** + *

Retrieve a list of event destinations that are associated with a configuration + * set.

+ *

In Amazon Pinpoint, events include message sends, deliveries, opens, + * clicks, bounces, and complaints. Event destinations are places that + * you can send information about these events to. For example, you can send event data to + * Amazon SNS to receive notifications when you receive bounces or complaints, or you can use + * Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term storage.

+ */ export class GetConfigurationSetEventDestinationsCommand extends $Command< GetConfigurationSetEventDestinationsCommandInput, GetConfigurationSetEventDestinationsCommandOutput, @@ -38,6 +47,9 @@ export class GetConfigurationSetEventDestinationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetDedicatedIpCommand.ts b/clients/client-pinpoint-email/commands/GetDedicatedIpCommand.ts index 568cb21d83553..f12ef7fc033ba 100644 --- a/clients/client-pinpoint-email/commands/GetDedicatedIpCommand.ts +++ b/clients/client-pinpoint-email/commands/GetDedicatedIpCommand.ts @@ -20,6 +20,11 @@ import { export type GetDedicatedIpCommandInput = GetDedicatedIpRequest; export type GetDedicatedIpCommandOutput = GetDedicatedIpResponse & __MetadataBearer; +/** + *

Get information about a dedicated IP address, including the name of the dedicated IP + * pool that it's associated with, as well information about the automatic warm-up process + * for the address.

+ */ export class GetDedicatedIpCommand extends $Command< GetDedicatedIpCommandInput, GetDedicatedIpCommandOutput, @@ -34,6 +39,9 @@ export class GetDedicatedIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetDedicatedIpsCommand.ts b/clients/client-pinpoint-email/commands/GetDedicatedIpsCommand.ts index 741105f91fd90..9dd21289951c5 100644 --- a/clients/client-pinpoint-email/commands/GetDedicatedIpsCommand.ts +++ b/clients/client-pinpoint-email/commands/GetDedicatedIpsCommand.ts @@ -20,6 +20,10 @@ import { export type GetDedicatedIpsCommandInput = GetDedicatedIpsRequest; export type GetDedicatedIpsCommandOutput = GetDedicatedIpsResponse & __MetadataBearer; +/** + *

List the dedicated IP addresses that are associated with your Amazon Pinpoint + * account.

+ */ export class GetDedicatedIpsCommand extends $Command< GetDedicatedIpsCommandInput, GetDedicatedIpsCommandOutput, @@ -34,6 +38,9 @@ export class GetDedicatedIpsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetDeliverabilityDashboardOptionsCommand.ts b/clients/client-pinpoint-email/commands/GetDeliverabilityDashboardOptionsCommand.ts index 8ee392dcee173..eda4620ac7c34 100644 --- a/clients/client-pinpoint-email/commands/GetDeliverabilityDashboardOptionsCommand.ts +++ b/clients/client-pinpoint-email/commands/GetDeliverabilityDashboardOptionsCommand.ts @@ -24,6 +24,15 @@ export type GetDeliverabilityDashboardOptionsCommandInput = GetDeliverabilityDas export type GetDeliverabilityDashboardOptionsCommandOutput = GetDeliverabilityDashboardOptionsResponse & __MetadataBearer; +/** + *

Retrieve information about the status of the Deliverability dashboard for your Amazon Pinpoint account. + * When the Deliverability dashboard is enabled, you gain access to reputation, deliverability, and + * other metrics for the domains that you use to send email using Amazon Pinpoint. You also gain the + * ability to perform predictive inbox placement tests.

+ *

When you use the Deliverability dashboard, you pay a monthly subscription charge, in addition + * to any other fees that you accrue by using Amazon Pinpoint. For more information about the + * features and cost of a Deliverability dashboard subscription, see Amazon Pinpoint Pricing.

+ */ export class GetDeliverabilityDashboardOptionsCommand extends $Command< GetDeliverabilityDashboardOptionsCommandInput, GetDeliverabilityDashboardOptionsCommandOutput, @@ -38,6 +47,9 @@ export class GetDeliverabilityDashboardOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetDeliverabilityTestReportCommand.ts b/clients/client-pinpoint-email/commands/GetDeliverabilityTestReportCommand.ts index 0d44df9c2398c..cb4821c285c28 100644 --- a/clients/client-pinpoint-email/commands/GetDeliverabilityTestReportCommand.ts +++ b/clients/client-pinpoint-email/commands/GetDeliverabilityTestReportCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeliverabilityTestReportCommandInput = GetDeliverabilityTestReportRequest; export type GetDeliverabilityTestReportCommandOutput = GetDeliverabilityTestReportResponse & __MetadataBearer; +/** + *

Retrieve the results of a predictive inbox placement test.

+ */ export class GetDeliverabilityTestReportCommand extends $Command< GetDeliverabilityTestReportCommandInput, GetDeliverabilityTestReportCommandOutput, @@ -34,6 +37,9 @@ export class GetDeliverabilityTestReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetDomainDeliverabilityCampaignCommand.ts b/clients/client-pinpoint-email/commands/GetDomainDeliverabilityCampaignCommand.ts index 839937405d47f..0171d028768ed 100644 --- a/clients/client-pinpoint-email/commands/GetDomainDeliverabilityCampaignCommand.ts +++ b/clients/client-pinpoint-email/commands/GetDomainDeliverabilityCampaignCommand.ts @@ -20,6 +20,12 @@ import { export type GetDomainDeliverabilityCampaignCommandInput = GetDomainDeliverabilityCampaignRequest; export type GetDomainDeliverabilityCampaignCommandOutput = GetDomainDeliverabilityCampaignResponse & __MetadataBearer; +/** + *

Retrieve all the deliverability data for a specific campaign. This data is available + * for a campaign only if the campaign sent email by using a domain that the + * Deliverability dashboard is enabled for (PutDeliverabilityDashboardOption + * operation).

+ */ export class GetDomainDeliverabilityCampaignCommand extends $Command< GetDomainDeliverabilityCampaignCommandInput, GetDomainDeliverabilityCampaignCommandOutput, @@ -34,6 +40,9 @@ export class GetDomainDeliverabilityCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetDomainStatisticsReportCommand.ts b/clients/client-pinpoint-email/commands/GetDomainStatisticsReportCommand.ts index 36bb277a2e12f..c185bc009edcf 100644 --- a/clients/client-pinpoint-email/commands/GetDomainStatisticsReportCommand.ts +++ b/clients/client-pinpoint-email/commands/GetDomainStatisticsReportCommand.ts @@ -20,6 +20,10 @@ import { export type GetDomainStatisticsReportCommandInput = GetDomainStatisticsReportRequest; export type GetDomainStatisticsReportCommandOutput = GetDomainStatisticsReportResponse & __MetadataBearer; +/** + *

Retrieve inbox placement and engagement rates for the domains that you use to send + * email.

+ */ export class GetDomainStatisticsReportCommand extends $Command< GetDomainStatisticsReportCommandInput, GetDomainStatisticsReportCommandOutput, @@ -34,6 +38,9 @@ export class GetDomainStatisticsReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/GetEmailIdentityCommand.ts b/clients/client-pinpoint-email/commands/GetEmailIdentityCommand.ts index 77038c145bd7f..a46d5718c5f57 100644 --- a/clients/client-pinpoint-email/commands/GetEmailIdentityCommand.ts +++ b/clients/client-pinpoint-email/commands/GetEmailIdentityCommand.ts @@ -20,6 +20,11 @@ import { export type GetEmailIdentityCommandInput = GetEmailIdentityRequest; export type GetEmailIdentityCommandOutput = GetEmailIdentityResponse & __MetadataBearer; +/** + *

Provides information about a specific identity associated with your Amazon Pinpoint account, + * including the identity's verification status, its DKIM authentication status, and its + * custom Mail-From settings.

+ */ export class GetEmailIdentityCommand extends $Command< GetEmailIdentityCommandInput, GetEmailIdentityCommandOutput, @@ -34,6 +39,9 @@ export class GetEmailIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/ListConfigurationSetsCommand.ts b/clients/client-pinpoint-email/commands/ListConfigurationSetsCommand.ts index e0129db9b2b94..e3b57386ab9a1 100644 --- a/clients/client-pinpoint-email/commands/ListConfigurationSetsCommand.ts +++ b/clients/client-pinpoint-email/commands/ListConfigurationSetsCommand.ts @@ -20,6 +20,15 @@ import { export type ListConfigurationSetsCommandInput = ListConfigurationSetsRequest; export type ListConfigurationSetsCommandOutput = ListConfigurationSetsResponse & __MetadataBearer; +/** + *

List all of the configuration sets associated with your Amazon Pinpoint account in the current + * region.

+ *

In Amazon Pinpoint, configuration sets are groups of rules that you can + * apply to the emails you send. You apply a configuration set to an email by including a + * reference to the configuration set in the headers of the email. When you apply a + * configuration set to an email, all of the rules in that configuration set are applied to + * the email.

+ */ export class ListConfigurationSetsCommand extends $Command< ListConfigurationSetsCommandInput, ListConfigurationSetsCommandOutput, @@ -34,6 +43,9 @@ export class ListConfigurationSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/ListDedicatedIpPoolsCommand.ts b/clients/client-pinpoint-email/commands/ListDedicatedIpPoolsCommand.ts index 13bf94ca1fe13..efa02281a34e0 100644 --- a/clients/client-pinpoint-email/commands/ListDedicatedIpPoolsCommand.ts +++ b/clients/client-pinpoint-email/commands/ListDedicatedIpPoolsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDedicatedIpPoolsCommandInput = ListDedicatedIpPoolsRequest; export type ListDedicatedIpPoolsCommandOutput = ListDedicatedIpPoolsResponse & __MetadataBearer; +/** + *

List all of the dedicated IP pools that exist in your Amazon Pinpoint account in the current + * AWS Region.

+ */ export class ListDedicatedIpPoolsCommand extends $Command< ListDedicatedIpPoolsCommandInput, ListDedicatedIpPoolsCommandOutput, @@ -34,6 +38,9 @@ export class ListDedicatedIpPoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/ListDeliverabilityTestReportsCommand.ts b/clients/client-pinpoint-email/commands/ListDeliverabilityTestReportsCommand.ts index 260e9e6a16f14..eb4507745eed8 100644 --- a/clients/client-pinpoint-email/commands/ListDeliverabilityTestReportsCommand.ts +++ b/clients/client-pinpoint-email/commands/ListDeliverabilityTestReportsCommand.ts @@ -20,6 +20,11 @@ import { export type ListDeliverabilityTestReportsCommandInput = ListDeliverabilityTestReportsRequest; export type ListDeliverabilityTestReportsCommandOutput = ListDeliverabilityTestReportsResponse & __MetadataBearer; +/** + *

Show a list of the predictive inbox placement tests that you've performed, regardless of their statuses. For + * predictive inbox placement tests that are complete, you can use the GetDeliverabilityTestReport + * operation to view the results.

+ */ export class ListDeliverabilityTestReportsCommand extends $Command< ListDeliverabilityTestReportsCommandInput, ListDeliverabilityTestReportsCommandOutput, @@ -34,6 +39,9 @@ export class ListDeliverabilityTestReportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/ListDomainDeliverabilityCampaignsCommand.ts b/clients/client-pinpoint-email/commands/ListDomainDeliverabilityCampaignsCommand.ts index 7549f08c2fbfd..1c0c8973df130 100644 --- a/clients/client-pinpoint-email/commands/ListDomainDeliverabilityCampaignsCommand.ts +++ b/clients/client-pinpoint-email/commands/ListDomainDeliverabilityCampaignsCommand.ts @@ -24,6 +24,12 @@ export type ListDomainDeliverabilityCampaignsCommandInput = ListDomainDeliverabi export type ListDomainDeliverabilityCampaignsCommandOutput = ListDomainDeliverabilityCampaignsResponse & __MetadataBearer; +/** + *

Retrieve deliverability data for all the campaigns that used a specific domain to send + * email during a specified time range. This data is available for a domain only if you + * enabled the Deliverability dashboard (PutDeliverabilityDashboardOption operation) + * for the domain.

+ */ export class ListDomainDeliverabilityCampaignsCommand extends $Command< ListDomainDeliverabilityCampaignsCommandInput, ListDomainDeliverabilityCampaignsCommandOutput, @@ -38,6 +44,9 @@ export class ListDomainDeliverabilityCampaignsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/ListEmailIdentitiesCommand.ts b/clients/client-pinpoint-email/commands/ListEmailIdentitiesCommand.ts index ebd77995a572f..fcb5a2d29f6f0 100644 --- a/clients/client-pinpoint-email/commands/ListEmailIdentitiesCommand.ts +++ b/clients/client-pinpoint-email/commands/ListEmailIdentitiesCommand.ts @@ -20,6 +20,11 @@ import { export type ListEmailIdentitiesCommandInput = ListEmailIdentitiesRequest; export type ListEmailIdentitiesCommandOutput = ListEmailIdentitiesResponse & __MetadataBearer; +/** + *

Returns a list of all of the email identities that are associated with your Amazon Pinpoint + * account. An identity can be either an email address or a domain. This operation returns + * identities that are verified as well as those that aren't.

+ */ export class ListEmailIdentitiesCommand extends $Command< ListEmailIdentitiesCommandInput, ListEmailIdentitiesCommandOutput, @@ -34,6 +39,9 @@ export class ListEmailIdentitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/ListTagsForResourceCommand.ts b/clients/client-pinpoint-email/commands/ListTagsForResourceCommand.ts index 7b6b37ab28e76..c4168564734f9 100644 --- a/clients/client-pinpoint-email/commands/ListTagsForResourceCommand.ts +++ b/clients/client-pinpoint-email/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,14 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieve a list of the tags (keys and values) that are associated with a specified + * resource. A tag is a label that you optionally define and associate + * with a resource in Amazon Pinpoint. Each tag consists of a required tag + * key and an optional associated tag value. A tag key + * is a general label that acts as a category for more specific tag values. A tag value + * acts as a descriptor within a tag key.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +42,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutAccountDedicatedIpWarmupAttributesCommand.ts b/clients/client-pinpoint-email/commands/PutAccountDedicatedIpWarmupAttributesCommand.ts index eef79311d8163..71b2353a52154 100644 --- a/clients/client-pinpoint-email/commands/PutAccountDedicatedIpWarmupAttributesCommand.ts +++ b/clients/client-pinpoint-email/commands/PutAccountDedicatedIpWarmupAttributesCommand.ts @@ -24,6 +24,9 @@ export type PutAccountDedicatedIpWarmupAttributesCommandInput = PutAccountDedica export type PutAccountDedicatedIpWarmupAttributesCommandOutput = PutAccountDedicatedIpWarmupAttributesResponse & __MetadataBearer; +/** + *

Enable or disable the automatic warm-up feature for dedicated IP addresses.

+ */ export class PutAccountDedicatedIpWarmupAttributesCommand extends $Command< PutAccountDedicatedIpWarmupAttributesCommandInput, PutAccountDedicatedIpWarmupAttributesCommandOutput, @@ -38,6 +41,9 @@ export class PutAccountDedicatedIpWarmupAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutAccountSendingAttributesCommand.ts b/clients/client-pinpoint-email/commands/PutAccountSendingAttributesCommand.ts index 52bb05df5cd9e..dc7b4ecb20220 100644 --- a/clients/client-pinpoint-email/commands/PutAccountSendingAttributesCommand.ts +++ b/clients/client-pinpoint-email/commands/PutAccountSendingAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type PutAccountSendingAttributesCommandInput = PutAccountSendingAttributesRequest; export type PutAccountSendingAttributesCommandOutput = PutAccountSendingAttributesResponse & __MetadataBearer; +/** + *

Enable or disable the ability of your account to send email.

+ */ export class PutAccountSendingAttributesCommand extends $Command< PutAccountSendingAttributesCommandInput, PutAccountSendingAttributesCommandOutput, @@ -34,6 +37,9 @@ export class PutAccountSendingAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutConfigurationSetDeliveryOptionsCommand.ts b/clients/client-pinpoint-email/commands/PutConfigurationSetDeliveryOptionsCommand.ts index 8a179411ba6bc..d4634274c866d 100644 --- a/clients/client-pinpoint-email/commands/PutConfigurationSetDeliveryOptionsCommand.ts +++ b/clients/client-pinpoint-email/commands/PutConfigurationSetDeliveryOptionsCommand.ts @@ -24,6 +24,10 @@ export type PutConfigurationSetDeliveryOptionsCommandInput = PutConfigurationSet export type PutConfigurationSetDeliveryOptionsCommandOutput = PutConfigurationSetDeliveryOptionsResponse & __MetadataBearer; +/** + *

Associate a configuration set with a dedicated IP pool. You can use dedicated IP pools + * to create groups of dedicated IP addresses for sending specific types of email.

+ */ export class PutConfigurationSetDeliveryOptionsCommand extends $Command< PutConfigurationSetDeliveryOptionsCommandInput, PutConfigurationSetDeliveryOptionsCommandOutput, @@ -38,6 +42,9 @@ export class PutConfigurationSetDeliveryOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutConfigurationSetReputationOptionsCommand.ts b/clients/client-pinpoint-email/commands/PutConfigurationSetReputationOptionsCommand.ts index d55ffa4b9a677..6e39af53e5294 100644 --- a/clients/client-pinpoint-email/commands/PutConfigurationSetReputationOptionsCommand.ts +++ b/clients/client-pinpoint-email/commands/PutConfigurationSetReputationOptionsCommand.ts @@ -24,6 +24,10 @@ export type PutConfigurationSetReputationOptionsCommandInput = PutConfigurationS export type PutConfigurationSetReputationOptionsCommandOutput = PutConfigurationSetReputationOptionsResponse & __MetadataBearer; +/** + *

Enable or disable collection of reputation metrics for emails that you send using a + * particular configuration set in a specific AWS Region.

+ */ export class PutConfigurationSetReputationOptionsCommand extends $Command< PutConfigurationSetReputationOptionsCommandInput, PutConfigurationSetReputationOptionsCommandOutput, @@ -38,6 +42,9 @@ export class PutConfigurationSetReputationOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutConfigurationSetSendingOptionsCommand.ts b/clients/client-pinpoint-email/commands/PutConfigurationSetSendingOptionsCommand.ts index ce0c9331e03c7..2e9dfbbe2fe6f 100644 --- a/clients/client-pinpoint-email/commands/PutConfigurationSetSendingOptionsCommand.ts +++ b/clients/client-pinpoint-email/commands/PutConfigurationSetSendingOptionsCommand.ts @@ -24,6 +24,10 @@ export type PutConfigurationSetSendingOptionsCommandInput = PutConfigurationSetS export type PutConfigurationSetSendingOptionsCommandOutput = PutConfigurationSetSendingOptionsResponse & __MetadataBearer; +/** + *

Enable or disable email sending for messages that use a particular configuration set + * in a specific AWS Region.

+ */ export class PutConfigurationSetSendingOptionsCommand extends $Command< PutConfigurationSetSendingOptionsCommandInput, PutConfigurationSetSendingOptionsCommandOutput, @@ -38,6 +42,9 @@ export class PutConfigurationSetSendingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutConfigurationSetTrackingOptionsCommand.ts b/clients/client-pinpoint-email/commands/PutConfigurationSetTrackingOptionsCommand.ts index 9a19583e59cf9..4210427b4bf92 100644 --- a/clients/client-pinpoint-email/commands/PutConfigurationSetTrackingOptionsCommand.ts +++ b/clients/client-pinpoint-email/commands/PutConfigurationSetTrackingOptionsCommand.ts @@ -24,6 +24,10 @@ export type PutConfigurationSetTrackingOptionsCommandInput = PutConfigurationSet export type PutConfigurationSetTrackingOptionsCommandOutput = PutConfigurationSetTrackingOptionsResponse & __MetadataBearer; +/** + *

Specify a custom domain to use for open and click tracking elements in email that you + * send using Amazon Pinpoint.

+ */ export class PutConfigurationSetTrackingOptionsCommand extends $Command< PutConfigurationSetTrackingOptionsCommandInput, PutConfigurationSetTrackingOptionsCommandOutput, @@ -38,6 +42,9 @@ export class PutConfigurationSetTrackingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutDedicatedIpInPoolCommand.ts b/clients/client-pinpoint-email/commands/PutDedicatedIpInPoolCommand.ts index 93e47b08019ef..8836475641efc 100644 --- a/clients/client-pinpoint-email/commands/PutDedicatedIpInPoolCommand.ts +++ b/clients/client-pinpoint-email/commands/PutDedicatedIpInPoolCommand.ts @@ -20,6 +20,18 @@ import { export type PutDedicatedIpInPoolCommandInput = PutDedicatedIpInPoolRequest; export type PutDedicatedIpInPoolCommandOutput = PutDedicatedIpInPoolResponse & __MetadataBearer; +/** + *

Move a dedicated IP address to an existing dedicated IP pool.

+ * + *

The dedicated IP address that you specify must already exist, and must be + * associated with your Amazon Pinpoint account. + * + *

+ *

The dedicated IP pool you specify must already exist. You can create a new pool by + * using the CreateDedicatedIpPool operation.

+ * + *
+ */ export class PutDedicatedIpInPoolCommand extends $Command< PutDedicatedIpInPoolCommandInput, PutDedicatedIpInPoolCommandOutput, @@ -34,6 +46,9 @@ export class PutDedicatedIpInPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutDedicatedIpWarmupAttributesCommand.ts b/clients/client-pinpoint-email/commands/PutDedicatedIpWarmupAttributesCommand.ts index 158a1f2e26657..e48dbbaea9859 100644 --- a/clients/client-pinpoint-email/commands/PutDedicatedIpWarmupAttributesCommand.ts +++ b/clients/client-pinpoint-email/commands/PutDedicatedIpWarmupAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type PutDedicatedIpWarmupAttributesCommandInput = PutDedicatedIpWarmupAttributesRequest; export type PutDedicatedIpWarmupAttributesCommandOutput = PutDedicatedIpWarmupAttributesResponse & __MetadataBearer; +/** + *

+ */ export class PutDedicatedIpWarmupAttributesCommand extends $Command< PutDedicatedIpWarmupAttributesCommandInput, PutDedicatedIpWarmupAttributesCommandOutput, @@ -34,6 +37,9 @@ export class PutDedicatedIpWarmupAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutDeliverabilityDashboardOptionCommand.ts b/clients/client-pinpoint-email/commands/PutDeliverabilityDashboardOptionCommand.ts index dd7f8a5d5ac04..3f8fc67fe47aa 100644 --- a/clients/client-pinpoint-email/commands/PutDeliverabilityDashboardOptionCommand.ts +++ b/clients/client-pinpoint-email/commands/PutDeliverabilityDashboardOptionCommand.ts @@ -20,6 +20,15 @@ import { export type PutDeliverabilityDashboardOptionCommandInput = PutDeliverabilityDashboardOptionRequest; export type PutDeliverabilityDashboardOptionCommandOutput = PutDeliverabilityDashboardOptionResponse & __MetadataBearer; +/** + *

Enable or disable the Deliverability dashboard for your Amazon Pinpoint account. When you enable the + * Deliverability dashboard, you gain access to reputation, deliverability, and other metrics for + * the domains that you use to send email using Amazon Pinpoint. You also gain the ability to perform + * predictive inbox placement tests.

+ *

When you use the Deliverability dashboard, you pay a monthly subscription charge, in addition + * to any other fees that you accrue by using Amazon Pinpoint. For more information about the + * features and cost of a Deliverability dashboard subscription, see Amazon Pinpoint Pricing.

+ */ export class PutDeliverabilityDashboardOptionCommand extends $Command< PutDeliverabilityDashboardOptionCommandInput, PutDeliverabilityDashboardOptionCommandOutput, @@ -34,6 +43,9 @@ export class PutDeliverabilityDashboardOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutEmailIdentityDkimAttributesCommand.ts b/clients/client-pinpoint-email/commands/PutEmailIdentityDkimAttributesCommand.ts index ecdf6531027b5..4b37ef0db8f5e 100644 --- a/clients/client-pinpoint-email/commands/PutEmailIdentityDkimAttributesCommand.ts +++ b/clients/client-pinpoint-email/commands/PutEmailIdentityDkimAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type PutEmailIdentityDkimAttributesCommandInput = PutEmailIdentityDkimAttributesRequest; export type PutEmailIdentityDkimAttributesCommandOutput = PutEmailIdentityDkimAttributesResponse & __MetadataBearer; +/** + *

Used to enable or disable DKIM authentication for an email identity.

+ */ export class PutEmailIdentityDkimAttributesCommand extends $Command< PutEmailIdentityDkimAttributesCommandInput, PutEmailIdentityDkimAttributesCommandOutput, @@ -34,6 +37,9 @@ export class PutEmailIdentityDkimAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutEmailIdentityFeedbackAttributesCommand.ts b/clients/client-pinpoint-email/commands/PutEmailIdentityFeedbackAttributesCommand.ts index a2eb158e8c714..a287b6a3d2b87 100644 --- a/clients/client-pinpoint-email/commands/PutEmailIdentityFeedbackAttributesCommand.ts +++ b/clients/client-pinpoint-email/commands/PutEmailIdentityFeedbackAttributesCommand.ts @@ -24,6 +24,19 @@ export type PutEmailIdentityFeedbackAttributesCommandInput = PutEmailIdentityFee export type PutEmailIdentityFeedbackAttributesCommandOutput = PutEmailIdentityFeedbackAttributesResponse & __MetadataBearer; +/** + *

Used to enable or disable feedback forwarding for an identity. This setting determines + * what happens when an identity is used to send an email that results in a bounce or + * complaint event.

+ *

When you enable feedback forwarding, Amazon Pinpoint sends you email notifications when bounce + * or complaint events occur. Amazon Pinpoint sends this notification to the address that you + * specified in the Return-Path header of the original email.

+ *

When you disable feedback forwarding, Amazon Pinpoint sends notifications through other + * mechanisms, such as by notifying an Amazon SNS topic. You're required to have a method of + * tracking bounces and complaints. If you haven't set up another mechanism for receiving + * bounce or complaint notifications, Amazon Pinpoint sends an email notification when these events + * occur (even if this setting is disabled).

+ */ export class PutEmailIdentityFeedbackAttributesCommand extends $Command< PutEmailIdentityFeedbackAttributesCommandInput, PutEmailIdentityFeedbackAttributesCommandOutput, @@ -38,6 +51,9 @@ export class PutEmailIdentityFeedbackAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/PutEmailIdentityMailFromAttributesCommand.ts b/clients/client-pinpoint-email/commands/PutEmailIdentityMailFromAttributesCommand.ts index 1d35c0caa82bc..d5d6e4222acde 100644 --- a/clients/client-pinpoint-email/commands/PutEmailIdentityMailFromAttributesCommand.ts +++ b/clients/client-pinpoint-email/commands/PutEmailIdentityMailFromAttributesCommand.ts @@ -24,6 +24,10 @@ export type PutEmailIdentityMailFromAttributesCommandInput = PutEmailIdentityMai export type PutEmailIdentityMailFromAttributesCommandOutput = PutEmailIdentityMailFromAttributesResponse & __MetadataBearer; +/** + *

Used to enable or disable the custom Mail-From domain configuration for an email + * identity.

+ */ export class PutEmailIdentityMailFromAttributesCommand extends $Command< PutEmailIdentityMailFromAttributesCommandInput, PutEmailIdentityMailFromAttributesCommandOutput, @@ -38,6 +42,9 @@ export class PutEmailIdentityMailFromAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/SendEmailCommand.ts b/clients/client-pinpoint-email/commands/SendEmailCommand.ts index 21c2be42d13ee..f50e0003942d8 100644 --- a/clients/client-pinpoint-email/commands/SendEmailCommand.ts +++ b/clients/client-pinpoint-email/commands/SendEmailCommand.ts @@ -20,6 +20,26 @@ import { export type SendEmailCommandInput = SendEmailRequest; export type SendEmailCommandOutput = SendEmailResponse & __MetadataBearer; +/** + *

Sends an email message. You can use the Amazon Pinpoint Email API to send two types of + * messages:

+ *
    + *
  • + *

    + * Simple – A standard email message. When + * you create this type of message, you specify the sender, the recipient, and the + * message body, and Amazon Pinpoint assembles the message for you.

    + *
  • + *
  • + *

    + * Raw – A raw, MIME-formatted email + * message. When you send this type of email, you have to specify all of the + * message headers, as well as the message body. You can use this message type to + * send messages that contain attachments. The message that you specify has to be a + * valid MIME message.

    + *
  • + *
+ */ export class SendEmailCommand extends $Command< SendEmailCommandInput, SendEmailCommandOutput, @@ -34,6 +54,9 @@ export class SendEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/TagResourceCommand.ts b/clients/client-pinpoint-email/commands/TagResourceCommand.ts index 7ee93068c2f2f..b6c387b72e06a 100644 --- a/clients/client-pinpoint-email/commands/TagResourceCommand.ts +++ b/clients/client-pinpoint-email/commands/TagResourceCommand.ts @@ -20,6 +20,17 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Add one or more tags (keys and values) to a specified resource. A + * tag is a label that you optionally define and associate with a + * resource in Amazon Pinpoint. Tags can help you categorize and manage resources in different ways, + * such as by purpose, owner, environment, or other criteria. A resource can have as many + * as 50 tags.

+ *

Each tag consists of a required tag key and an + * associated tag value, both of which you define. A tag key is a + * general label that acts as a category for more specific tag values. A tag value acts as + * a descriptor within a tag key.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +45,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/UntagResourceCommand.ts b/clients/client-pinpoint-email/commands/UntagResourceCommand.ts index d9cea560217b8..64f9ca0e367a0 100644 --- a/clients/client-pinpoint-email/commands/UntagResourceCommand.ts +++ b/clients/client-pinpoint-email/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Remove one or more tags (keys and values) from a specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/commands/UpdateConfigurationSetEventDestinationCommand.ts b/clients/client-pinpoint-email/commands/UpdateConfigurationSetEventDestinationCommand.ts index 35c0f32738af8..d5e1cc8feb0df 100644 --- a/clients/client-pinpoint-email/commands/UpdateConfigurationSetEventDestinationCommand.ts +++ b/clients/client-pinpoint-email/commands/UpdateConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,14 @@ export type UpdateConfigurationSetEventDestinationCommandInput = UpdateConfigura export type UpdateConfigurationSetEventDestinationCommandOutput = UpdateConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Update the configuration of an event destination for a configuration set.

+ *

In Amazon Pinpoint, events include message sends, deliveries, opens, + * clicks, bounces, and complaints. Event destinations are places that + * you can send information about these events to. For example, you can send event data to + * Amazon SNS to receive notifications when you receive bounces or complaints, or you can use + * Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term storage.

+ */ export class UpdateConfigurationSetEventDestinationCommand extends $Command< UpdateConfigurationSetEventDestinationCommandInput, UpdateConfigurationSetEventDestinationCommandOutput, @@ -38,6 +46,9 @@ export class UpdateConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointEmailClientResolvedConfig, diff --git a/clients/client-pinpoint-email/package.json b/clients/client-pinpoint-email/package.json index afcf8b6be3375..6b1845b7f0d16 100644 --- a/clients/client-pinpoint-email/package.json +++ b/clients/client-pinpoint-email/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Pinpoint Email Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-pinpoint-email/pagination/GetDedicatedIpsPaginator.ts b/clients/client-pinpoint-email/pagination/GetDedicatedIpsPaginator.ts index 232444ccda438..47fc75a11574e 100644 --- a/clients/client-pinpoint-email/pagination/GetDedicatedIpsPaginator.ts +++ b/clients/client-pinpoint-email/pagination/GetDedicatedIpsPaginator.ts @@ -8,6 +8,9 @@ import { import { PinpointEmailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PinpointEmailClient, input: GetDedicatedIpsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDedicatedIpsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: PinpointEmail, input: GetDedicatedIpsCommandInput, diff --git a/clients/client-pinpoint-email/pagination/ListConfigurationSetsPaginator.ts b/clients/client-pinpoint-email/pagination/ListConfigurationSetsPaginator.ts index 29b76338cba20..5549bd1ea58b1 100644 --- a/clients/client-pinpoint-email/pagination/ListConfigurationSetsPaginator.ts +++ b/clients/client-pinpoint-email/pagination/ListConfigurationSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { PinpointEmailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PinpointEmailClient, input: ListConfigurationSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConfigurationSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: PinpointEmail, input: ListConfigurationSetsCommandInput, diff --git a/clients/client-pinpoint-email/pagination/ListDedicatedIpPoolsPaginator.ts b/clients/client-pinpoint-email/pagination/ListDedicatedIpPoolsPaginator.ts index 5f875f4166a61..3405d3c7ebf4b 100644 --- a/clients/client-pinpoint-email/pagination/ListDedicatedIpPoolsPaginator.ts +++ b/clients/client-pinpoint-email/pagination/ListDedicatedIpPoolsPaginator.ts @@ -8,6 +8,9 @@ import { import { PinpointEmailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PinpointEmailClient, input: ListDedicatedIpPoolsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDedicatedIpPoolsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: PinpointEmail, input: ListDedicatedIpPoolsCommandInput, diff --git a/clients/client-pinpoint-email/pagination/ListDeliverabilityTestReportsPaginator.ts b/clients/client-pinpoint-email/pagination/ListDeliverabilityTestReportsPaginator.ts index 07e165d8f7591..0526cc2dc77f8 100644 --- a/clients/client-pinpoint-email/pagination/ListDeliverabilityTestReportsPaginator.ts +++ b/clients/client-pinpoint-email/pagination/ListDeliverabilityTestReportsPaginator.ts @@ -8,6 +8,9 @@ import { import { PinpointEmailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PinpointEmailClient, input: ListDeliverabilityTestReportsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeliverabilityTestReportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: PinpointEmail, input: ListDeliverabilityTestReportsCommandInput, diff --git a/clients/client-pinpoint-email/pagination/ListDomainDeliverabilityCampaignsPaginator.ts b/clients/client-pinpoint-email/pagination/ListDomainDeliverabilityCampaignsPaginator.ts index 49c88b3e2899b..fc113459a809a 100644 --- a/clients/client-pinpoint-email/pagination/ListDomainDeliverabilityCampaignsPaginator.ts +++ b/clients/client-pinpoint-email/pagination/ListDomainDeliverabilityCampaignsPaginator.ts @@ -8,6 +8,9 @@ import { import { PinpointEmailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PinpointEmailClient, input: ListDomainDeliverabilityCampaignsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainDeliverabilityCampaignsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: PinpointEmail, input: ListDomainDeliverabilityCampaignsCommandInput, diff --git a/clients/client-pinpoint-email/pagination/ListEmailIdentitiesPaginator.ts b/clients/client-pinpoint-email/pagination/ListEmailIdentitiesPaginator.ts index 7420bea12f5ff..2bd9f2c5a71cd 100644 --- a/clients/client-pinpoint-email/pagination/ListEmailIdentitiesPaginator.ts +++ b/clients/client-pinpoint-email/pagination/ListEmailIdentitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { PinpointEmailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PinpointEmailClient, input: ListEmailIdentitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEmailIdentitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: PinpointEmail, input: ListEmailIdentitiesCommandInput, diff --git a/clients/client-pinpoint-email/runtimeConfig.browser.ts b/clients/client-pinpoint-email/runtimeConfig.browser.ts index 8ad4602e5c779..2e29acd7f825b 100644 --- a/clients/client-pinpoint-email/runtimeConfig.browser.ts +++ b/clients/client-pinpoint-email/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PinpointEmailClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-pinpoint-email/runtimeConfig.native.ts b/clients/client-pinpoint-email/runtimeConfig.native.ts index 347f34a825d1f..1b92604d7e02e 100644 --- a/clients/client-pinpoint-email/runtimeConfig.native.ts +++ b/clients/client-pinpoint-email/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PinpointEmailClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-pinpoint-email/runtimeConfig.shared.ts b/clients/client-pinpoint-email/runtimeConfig.shared.ts index 8078cd0abc09a..17d6613f24e5f 100644 --- a/clients/client-pinpoint-email/runtimeConfig.shared.ts +++ b/clients/client-pinpoint-email/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-07-26", disableHostPrefix: false, diff --git a/clients/client-pinpoint-email/runtimeConfig.ts b/clients/client-pinpoint-email/runtimeConfig.ts index 046cbb12c1329..c977404112dea 100644 --- a/clients/client-pinpoint-email/runtimeConfig.ts +++ b/clients/client-pinpoint-email/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PinpointEmailClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-pinpoint-email/tsconfig.json b/clients/client-pinpoint-email/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-pinpoint-email/tsconfig.json +++ b/clients/client-pinpoint-email/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-pinpoint-sms-voice/commands/CreateConfigurationSetCommand.ts b/clients/client-pinpoint-sms-voice/commands/CreateConfigurationSetCommand.ts index 06f818fffd027..20c4aa0f6b089 100644 --- a/clients/client-pinpoint-sms-voice/commands/CreateConfigurationSetCommand.ts +++ b/clients/client-pinpoint-sms-voice/commands/CreateConfigurationSetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateConfigurationSetCommandInput = CreateConfigurationSetRequest; export type CreateConfigurationSetCommandOutput = CreateConfigurationSetResponse & __MetadataBearer; +/** + * Create a new configuration set. After you create the configuration set, you can add one or more event destinations to it. + */ export class CreateConfigurationSetCommand extends $Command< CreateConfigurationSetCommandInput, CreateConfigurationSetCommandOutput, @@ -34,6 +37,9 @@ export class CreateConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointSMSVoiceClientResolvedConfig, diff --git a/clients/client-pinpoint-sms-voice/commands/CreateConfigurationSetEventDestinationCommand.ts b/clients/client-pinpoint-sms-voice/commands/CreateConfigurationSetEventDestinationCommand.ts index d8c236c1e5bbc..74b3f5668bf89 100644 --- a/clients/client-pinpoint-sms-voice/commands/CreateConfigurationSetEventDestinationCommand.ts +++ b/clients/client-pinpoint-sms-voice/commands/CreateConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,9 @@ export type CreateConfigurationSetEventDestinationCommandInput = CreateConfigura export type CreateConfigurationSetEventDestinationCommandOutput = CreateConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + * Create a new event destination in a configuration set. + */ export class CreateConfigurationSetEventDestinationCommand extends $Command< CreateConfigurationSetEventDestinationCommandInput, CreateConfigurationSetEventDestinationCommandOutput, @@ -38,6 +41,9 @@ export class CreateConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointSMSVoiceClientResolvedConfig, diff --git a/clients/client-pinpoint-sms-voice/commands/DeleteConfigurationSetCommand.ts b/clients/client-pinpoint-sms-voice/commands/DeleteConfigurationSetCommand.ts index fde9ec5580c82..443a52159ee2c 100644 --- a/clients/client-pinpoint-sms-voice/commands/DeleteConfigurationSetCommand.ts +++ b/clients/client-pinpoint-sms-voice/commands/DeleteConfigurationSetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteConfigurationSetCommandInput = DeleteConfigurationSetRequest; export type DeleteConfigurationSetCommandOutput = DeleteConfigurationSetResponse & __MetadataBearer; +/** + * Deletes an existing configuration set. + */ export class DeleteConfigurationSetCommand extends $Command< DeleteConfigurationSetCommandInput, DeleteConfigurationSetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointSMSVoiceClientResolvedConfig, diff --git a/clients/client-pinpoint-sms-voice/commands/DeleteConfigurationSetEventDestinationCommand.ts b/clients/client-pinpoint-sms-voice/commands/DeleteConfigurationSetEventDestinationCommand.ts index 38cd504751280..b2b12118e3ed5 100644 --- a/clients/client-pinpoint-sms-voice/commands/DeleteConfigurationSetEventDestinationCommand.ts +++ b/clients/client-pinpoint-sms-voice/commands/DeleteConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,9 @@ export type DeleteConfigurationSetEventDestinationCommandInput = DeleteConfigura export type DeleteConfigurationSetEventDestinationCommandOutput = DeleteConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + * Deletes an event destination in a configuration set. + */ export class DeleteConfigurationSetEventDestinationCommand extends $Command< DeleteConfigurationSetEventDestinationCommandInput, DeleteConfigurationSetEventDestinationCommandOutput, @@ -38,6 +41,9 @@ export class DeleteConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointSMSVoiceClientResolvedConfig, diff --git a/clients/client-pinpoint-sms-voice/commands/GetConfigurationSetEventDestinationsCommand.ts b/clients/client-pinpoint-sms-voice/commands/GetConfigurationSetEventDestinationsCommand.ts index c6115514d4da0..083cc1a301eff 100644 --- a/clients/client-pinpoint-sms-voice/commands/GetConfigurationSetEventDestinationsCommand.ts +++ b/clients/client-pinpoint-sms-voice/commands/GetConfigurationSetEventDestinationsCommand.ts @@ -24,6 +24,9 @@ export type GetConfigurationSetEventDestinationsCommandInput = GetConfigurationS export type GetConfigurationSetEventDestinationsCommandOutput = GetConfigurationSetEventDestinationsResponse & __MetadataBearer; +/** + * Obtain information about an event destination, including the types of events it reports, the Amazon Resource Name (ARN) of the destination, and the name of the event destination. + */ export class GetConfigurationSetEventDestinationsCommand extends $Command< GetConfigurationSetEventDestinationsCommandInput, GetConfigurationSetEventDestinationsCommandOutput, @@ -38,6 +41,9 @@ export class GetConfigurationSetEventDestinationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointSMSVoiceClientResolvedConfig, diff --git a/clients/client-pinpoint-sms-voice/commands/ListConfigurationSetsCommand.ts b/clients/client-pinpoint-sms-voice/commands/ListConfigurationSetsCommand.ts index 2504d37773af9..90b70d1020324 100644 --- a/clients/client-pinpoint-sms-voice/commands/ListConfigurationSetsCommand.ts +++ b/clients/client-pinpoint-sms-voice/commands/ListConfigurationSetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListConfigurationSetsCommandInput = ListConfigurationSetsRequest; export type ListConfigurationSetsCommandOutput = ListConfigurationSetsResponse & __MetadataBearer; +/** + * List all of the configuration sets associated with your Amazon Pinpoint account in the current region. + */ export class ListConfigurationSetsCommand extends $Command< ListConfigurationSetsCommandInput, ListConfigurationSetsCommandOutput, @@ -34,6 +37,9 @@ export class ListConfigurationSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointSMSVoiceClientResolvedConfig, diff --git a/clients/client-pinpoint-sms-voice/commands/SendVoiceMessageCommand.ts b/clients/client-pinpoint-sms-voice/commands/SendVoiceMessageCommand.ts index 5277ba12392c0..cc8277a657838 100644 --- a/clients/client-pinpoint-sms-voice/commands/SendVoiceMessageCommand.ts +++ b/clients/client-pinpoint-sms-voice/commands/SendVoiceMessageCommand.ts @@ -20,6 +20,9 @@ import { export type SendVoiceMessageCommandInput = SendVoiceMessageRequest; export type SendVoiceMessageCommandOutput = SendVoiceMessageResponse & __MetadataBearer; +/** + * Create a new voice message and send it to a recipient's phone number. + */ export class SendVoiceMessageCommand extends $Command< SendVoiceMessageCommandInput, SendVoiceMessageCommandOutput, @@ -34,6 +37,9 @@ export class SendVoiceMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointSMSVoiceClientResolvedConfig, diff --git a/clients/client-pinpoint-sms-voice/commands/UpdateConfigurationSetEventDestinationCommand.ts b/clients/client-pinpoint-sms-voice/commands/UpdateConfigurationSetEventDestinationCommand.ts index ffff42cf63140..0c216db73d2a0 100644 --- a/clients/client-pinpoint-sms-voice/commands/UpdateConfigurationSetEventDestinationCommand.ts +++ b/clients/client-pinpoint-sms-voice/commands/UpdateConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,9 @@ export type UpdateConfigurationSetEventDestinationCommandInput = UpdateConfigura export type UpdateConfigurationSetEventDestinationCommandOutput = UpdateConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + * Update an event destination in a configuration set. An event destination is a location that you publish information about your voice calls to. For example, you can log an event to an Amazon CloudWatch destination when a call fails. + */ export class UpdateConfigurationSetEventDestinationCommand extends $Command< UpdateConfigurationSetEventDestinationCommandInput, UpdateConfigurationSetEventDestinationCommandOutput, @@ -38,6 +41,9 @@ export class UpdateConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointSMSVoiceClientResolvedConfig, diff --git a/clients/client-pinpoint-sms-voice/package.json b/clients/client-pinpoint-sms-voice/package.json index 1711758035e47..a32aa7368c5fd 100644 --- a/clients/client-pinpoint-sms-voice/package.json +++ b/clients/client-pinpoint-sms-voice/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Pinpoint Sms Voice Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-pinpoint-sms-voice/runtimeConfig.browser.ts b/clients/client-pinpoint-sms-voice/runtimeConfig.browser.ts index fefa9f610cfc9..ba52a34f0806f 100644 --- a/clients/client-pinpoint-sms-voice/runtimeConfig.browser.ts +++ b/clients/client-pinpoint-sms-voice/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PinpointSMSVoiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-pinpoint-sms-voice/runtimeConfig.native.ts b/clients/client-pinpoint-sms-voice/runtimeConfig.native.ts index c02e2668a6b23..31636ad78ceec 100644 --- a/clients/client-pinpoint-sms-voice/runtimeConfig.native.ts +++ b/clients/client-pinpoint-sms-voice/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PinpointSMSVoiceClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-pinpoint-sms-voice/runtimeConfig.shared.ts b/clients/client-pinpoint-sms-voice/runtimeConfig.shared.ts index 7f7f2980cdc3d..a60641586a20b 100644 --- a/clients/client-pinpoint-sms-voice/runtimeConfig.shared.ts +++ b/clients/client-pinpoint-sms-voice/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-09-05", disableHostPrefix: false, diff --git a/clients/client-pinpoint-sms-voice/runtimeConfig.ts b/clients/client-pinpoint-sms-voice/runtimeConfig.ts index 96489c37ad070..9ba47ed1ffb74 100644 --- a/clients/client-pinpoint-sms-voice/runtimeConfig.ts +++ b/clients/client-pinpoint-sms-voice/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PinpointSMSVoiceClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-pinpoint-sms-voice/tsconfig.json b/clients/client-pinpoint-sms-voice/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-pinpoint-sms-voice/tsconfig.json +++ b/clients/client-pinpoint-sms-voice/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-pinpoint/commands/CreateAppCommand.ts b/clients/client-pinpoint/commands/CreateAppCommand.ts index f86c661b2ef90..e9ab454eaa8ce 100644 --- a/clients/client-pinpoint/commands/CreateAppCommand.ts +++ b/clients/client-pinpoint/commands/CreateAppCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAppCommandInput = CreateAppRequest; export type CreateAppCommandOutput = CreateAppResponse & __MetadataBearer; +/** + *

Creates an application.

+ */ export class CreateAppCommand extends $Command< CreateAppCommandInput, CreateAppCommandOutput, @@ -34,6 +37,9 @@ export class CreateAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateCampaignCommand.ts b/clients/client-pinpoint/commands/CreateCampaignCommand.ts index e3e97b318ab48..0f0959af49f54 100644 --- a/clients/client-pinpoint/commands/CreateCampaignCommand.ts +++ b/clients/client-pinpoint/commands/CreateCampaignCommand.ts @@ -20,6 +20,9 @@ import { export type CreateCampaignCommandInput = CreateCampaignRequest; export type CreateCampaignCommandOutput = CreateCampaignResponse & __MetadataBearer; +/** + *

Creates a new campaign for an application or updates the settings of an existing campaign for an application.

+ */ export class CreateCampaignCommand extends $Command< CreateCampaignCommandInput, CreateCampaignCommandOutput, @@ -34,6 +37,9 @@ export class CreateCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateEmailTemplateCommand.ts b/clients/client-pinpoint/commands/CreateEmailTemplateCommand.ts index 3b9297a1ec670..3ee79697bc7e4 100644 --- a/clients/client-pinpoint/commands/CreateEmailTemplateCommand.ts +++ b/clients/client-pinpoint/commands/CreateEmailTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type CreateEmailTemplateCommandInput = CreateEmailTemplateRequest; export type CreateEmailTemplateCommandOutput = CreateEmailTemplateResponse & __MetadataBearer; +/** + *

Creates a message template for messages that are sent through the email channel.

+ */ export class CreateEmailTemplateCommand extends $Command< CreateEmailTemplateCommandInput, CreateEmailTemplateCommandOutput, @@ -34,6 +37,9 @@ export class CreateEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateExportJobCommand.ts b/clients/client-pinpoint/commands/CreateExportJobCommand.ts index 7fbbeccfe3828..ad9b74df5b651 100644 --- a/clients/client-pinpoint/commands/CreateExportJobCommand.ts +++ b/clients/client-pinpoint/commands/CreateExportJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateExportJobCommandInput = CreateExportJobRequest; export type CreateExportJobCommandOutput = CreateExportJobResponse & __MetadataBearer; +/** + *

Creates an export job for an application.

+ */ export class CreateExportJobCommand extends $Command< CreateExportJobCommandInput, CreateExportJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateImportJobCommand.ts b/clients/client-pinpoint/commands/CreateImportJobCommand.ts index c6d7ee598c9ee..853b891576f20 100644 --- a/clients/client-pinpoint/commands/CreateImportJobCommand.ts +++ b/clients/client-pinpoint/commands/CreateImportJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateImportJobCommandInput = CreateImportJobRequest; export type CreateImportJobCommandOutput = CreateImportJobResponse & __MetadataBearer; +/** + *

Creates an import job for an application.

+ */ export class CreateImportJobCommand extends $Command< CreateImportJobCommandInput, CreateImportJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateJourneyCommand.ts b/clients/client-pinpoint/commands/CreateJourneyCommand.ts index 0079c3ed19421..fcf332eeeb47c 100644 --- a/clients/client-pinpoint/commands/CreateJourneyCommand.ts +++ b/clients/client-pinpoint/commands/CreateJourneyCommand.ts @@ -20,6 +20,9 @@ import { export type CreateJourneyCommandInput = CreateJourneyRequest; export type CreateJourneyCommandOutput = CreateJourneyResponse & __MetadataBearer; +/** + *

Creates a journey for an application.

+ */ export class CreateJourneyCommand extends $Command< CreateJourneyCommandInput, CreateJourneyCommandOutput, @@ -34,6 +37,9 @@ export class CreateJourneyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreatePushTemplateCommand.ts b/clients/client-pinpoint/commands/CreatePushTemplateCommand.ts index 3e2549693cfe7..055a1ec8f4980 100644 --- a/clients/client-pinpoint/commands/CreatePushTemplateCommand.ts +++ b/clients/client-pinpoint/commands/CreatePushTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type CreatePushTemplateCommandInput = CreatePushTemplateRequest; export type CreatePushTemplateCommandOutput = CreatePushTemplateResponse & __MetadataBearer; +/** + *

Creates a message template for messages that are sent through a push notification channel.

+ */ export class CreatePushTemplateCommand extends $Command< CreatePushTemplateCommandInput, CreatePushTemplateCommandOutput, @@ -34,6 +37,9 @@ export class CreatePushTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateRecommenderConfigurationCommand.ts b/clients/client-pinpoint/commands/CreateRecommenderConfigurationCommand.ts index e6c2f2cfaabd4..d5219d29addeb 100644 --- a/clients/client-pinpoint/commands/CreateRecommenderConfigurationCommand.ts +++ b/clients/client-pinpoint/commands/CreateRecommenderConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRecommenderConfigurationCommandInput = CreateRecommenderConfigurationRequest; export type CreateRecommenderConfigurationCommandOutput = CreateRecommenderConfigurationResponse & __MetadataBearer; +/** + *

Creates an Amazon Pinpoint configuration for a recommender model.

+ */ export class CreateRecommenderConfigurationCommand extends $Command< CreateRecommenderConfigurationCommandInput, CreateRecommenderConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class CreateRecommenderConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateSegmentCommand.ts b/clients/client-pinpoint/commands/CreateSegmentCommand.ts index e32d45ccac916..2e68e08a9e721 100644 --- a/clients/client-pinpoint/commands/CreateSegmentCommand.ts +++ b/clients/client-pinpoint/commands/CreateSegmentCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSegmentCommandInput = CreateSegmentRequest; export type CreateSegmentCommandOutput = CreateSegmentResponse & __MetadataBearer; +/** + *

Creates a new segment for an application or updates the configuration, dimension, and other settings for an existing segment that's associated with an application.

+ */ export class CreateSegmentCommand extends $Command< CreateSegmentCommandInput, CreateSegmentCommandOutput, @@ -34,6 +37,9 @@ export class CreateSegmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateSmsTemplateCommand.ts b/clients/client-pinpoint/commands/CreateSmsTemplateCommand.ts index c90309529b51c..a83dfc01ecbb8 100644 --- a/clients/client-pinpoint/commands/CreateSmsTemplateCommand.ts +++ b/clients/client-pinpoint/commands/CreateSmsTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSmsTemplateCommandInput = CreateSmsTemplateRequest; export type CreateSmsTemplateCommandOutput = CreateSmsTemplateResponse & __MetadataBearer; +/** + *

Creates a message template for messages that are sent through the SMS channel.

+ */ export class CreateSmsTemplateCommand extends $Command< CreateSmsTemplateCommandInput, CreateSmsTemplateCommandOutput, @@ -34,6 +37,9 @@ export class CreateSmsTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/CreateVoiceTemplateCommand.ts b/clients/client-pinpoint/commands/CreateVoiceTemplateCommand.ts index 0a8987ecd5d4b..063db3e838c48 100644 --- a/clients/client-pinpoint/commands/CreateVoiceTemplateCommand.ts +++ b/clients/client-pinpoint/commands/CreateVoiceTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type CreateVoiceTemplateCommandInput = CreateVoiceTemplateRequest; export type CreateVoiceTemplateCommandOutput = CreateVoiceTemplateResponse & __MetadataBearer; +/** + *

Creates a message template for messages that are sent through the voice channel.

+ */ export class CreateVoiceTemplateCommand extends $Command< CreateVoiceTemplateCommandInput, CreateVoiceTemplateCommandOutput, @@ -34,6 +37,9 @@ export class CreateVoiceTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteAdmChannelCommand.ts b/clients/client-pinpoint/commands/DeleteAdmChannelCommand.ts index dcb2e38efcb3b..3a854babad82f 100644 --- a/clients/client-pinpoint/commands/DeleteAdmChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteAdmChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAdmChannelCommandInput = DeleteAdmChannelRequest; export type DeleteAdmChannelCommandOutput = DeleteAdmChannelResponse & __MetadataBearer; +/** + *

Disables the ADM channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteAdmChannelCommand extends $Command< DeleteAdmChannelCommandInput, DeleteAdmChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAdmChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteApnsChannelCommand.ts b/clients/client-pinpoint/commands/DeleteApnsChannelCommand.ts index 712633fb0861f..831710cb7f516 100644 --- a/clients/client-pinpoint/commands/DeleteApnsChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteApnsChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApnsChannelCommandInput = DeleteApnsChannelRequest; export type DeleteApnsChannelCommandOutput = DeleteApnsChannelResponse & __MetadataBearer; +/** + *

Disables the APNs channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteApnsChannelCommand extends $Command< DeleteApnsChannelCommandInput, DeleteApnsChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApnsChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteApnsSandboxChannelCommand.ts b/clients/client-pinpoint/commands/DeleteApnsSandboxChannelCommand.ts index 84445fbf7d16e..d014c29cdc049 100644 --- a/clients/client-pinpoint/commands/DeleteApnsSandboxChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteApnsSandboxChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApnsSandboxChannelCommandInput = DeleteApnsSandboxChannelRequest; export type DeleteApnsSandboxChannelCommandOutput = DeleteApnsSandboxChannelResponse & __MetadataBearer; +/** + *

Disables the APNs sandbox channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteApnsSandboxChannelCommand extends $Command< DeleteApnsSandboxChannelCommandInput, DeleteApnsSandboxChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApnsSandboxChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteApnsVoipChannelCommand.ts b/clients/client-pinpoint/commands/DeleteApnsVoipChannelCommand.ts index 847a719e4f639..0dd7abad571e9 100644 --- a/clients/client-pinpoint/commands/DeleteApnsVoipChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteApnsVoipChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApnsVoipChannelCommandInput = DeleteApnsVoipChannelRequest; export type DeleteApnsVoipChannelCommandOutput = DeleteApnsVoipChannelResponse & __MetadataBearer; +/** + *

Disables the APNs VoIP channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteApnsVoipChannelCommand extends $Command< DeleteApnsVoipChannelCommandInput, DeleteApnsVoipChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApnsVoipChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteApnsVoipSandboxChannelCommand.ts b/clients/client-pinpoint/commands/DeleteApnsVoipSandboxChannelCommand.ts index a24f2dc6506fb..71f46e003c2b8 100644 --- a/clients/client-pinpoint/commands/DeleteApnsVoipSandboxChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteApnsVoipSandboxChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteApnsVoipSandboxChannelCommandInput = DeleteApnsVoipSandboxChannelRequest; export type DeleteApnsVoipSandboxChannelCommandOutput = DeleteApnsVoipSandboxChannelResponse & __MetadataBearer; +/** + *

Disables the APNs VoIP sandbox channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteApnsVoipSandboxChannelCommand extends $Command< DeleteApnsVoipSandboxChannelCommandInput, DeleteApnsVoipSandboxChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteApnsVoipSandboxChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteAppCommand.ts b/clients/client-pinpoint/commands/DeleteAppCommand.ts index 8a42c62ac7867..0e1264419bace 100644 --- a/clients/client-pinpoint/commands/DeleteAppCommand.ts +++ b/clients/client-pinpoint/commands/DeleteAppCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAppCommandInput = DeleteAppRequest; export type DeleteAppCommandOutput = DeleteAppResponse & __MetadataBearer; +/** + *

Deletes an application.

+ */ export class DeleteAppCommand extends $Command< DeleteAppCommandInput, DeleteAppCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteBaiduChannelCommand.ts b/clients/client-pinpoint/commands/DeleteBaiduChannelCommand.ts index fded1d236484a..66c9951210a13 100644 --- a/clients/client-pinpoint/commands/DeleteBaiduChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteBaiduChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteBaiduChannelCommandInput = DeleteBaiduChannelRequest; export type DeleteBaiduChannelCommandOutput = DeleteBaiduChannelResponse & __MetadataBearer; +/** + *

Disables the Baidu channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteBaiduChannelCommand extends $Command< DeleteBaiduChannelCommandInput, DeleteBaiduChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteBaiduChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteCampaignCommand.ts b/clients/client-pinpoint/commands/DeleteCampaignCommand.ts index 32974f0bf203f..976cfd12c9f1a 100644 --- a/clients/client-pinpoint/commands/DeleteCampaignCommand.ts +++ b/clients/client-pinpoint/commands/DeleteCampaignCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCampaignCommandInput = DeleteCampaignRequest; export type DeleteCampaignCommandOutput = DeleteCampaignResponse & __MetadataBearer; +/** + *

Deletes a campaign from an application.

+ */ export class DeleteCampaignCommand extends $Command< DeleteCampaignCommandInput, DeleteCampaignCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteEmailChannelCommand.ts b/clients/client-pinpoint/commands/DeleteEmailChannelCommand.ts index 951237308bac8..a11a6100f6b71 100644 --- a/clients/client-pinpoint/commands/DeleteEmailChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteEmailChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEmailChannelCommandInput = DeleteEmailChannelRequest; export type DeleteEmailChannelCommandOutput = DeleteEmailChannelResponse & __MetadataBearer; +/** + *

Disables the email channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteEmailChannelCommand extends $Command< DeleteEmailChannelCommandInput, DeleteEmailChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEmailChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteEmailTemplateCommand.ts b/clients/client-pinpoint/commands/DeleteEmailTemplateCommand.ts index 3590a97395f3e..073f0c997e454 100644 --- a/clients/client-pinpoint/commands/DeleteEmailTemplateCommand.ts +++ b/clients/client-pinpoint/commands/DeleteEmailTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEmailTemplateCommandInput = DeleteEmailTemplateRequest; export type DeleteEmailTemplateCommandOutput = DeleteEmailTemplateResponse & __MetadataBearer; +/** + *

Deletes a message template for messages that were sent through the email channel.

+ */ export class DeleteEmailTemplateCommand extends $Command< DeleteEmailTemplateCommandInput, DeleteEmailTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteEndpointCommand.ts b/clients/client-pinpoint/commands/DeleteEndpointCommand.ts index e8089838315c8..8703b7e8a9522 100644 --- a/clients/client-pinpoint/commands/DeleteEndpointCommand.ts +++ b/clients/client-pinpoint/commands/DeleteEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEndpointCommandInput = DeleteEndpointRequest; export type DeleteEndpointCommandOutput = DeleteEndpointResponse & __MetadataBearer; +/** + *

Deletes an endpoint from an application.

+ */ export class DeleteEndpointCommand extends $Command< DeleteEndpointCommandInput, DeleteEndpointCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteEventStreamCommand.ts b/clients/client-pinpoint/commands/DeleteEventStreamCommand.ts index 2b42b57220ce3..f08a5f0761a12 100644 --- a/clients/client-pinpoint/commands/DeleteEventStreamCommand.ts +++ b/clients/client-pinpoint/commands/DeleteEventStreamCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEventStreamCommandInput = DeleteEventStreamRequest; export type DeleteEventStreamCommandOutput = DeleteEventStreamResponse & __MetadataBearer; +/** + *

Deletes the event stream for an application.

+ */ export class DeleteEventStreamCommand extends $Command< DeleteEventStreamCommandInput, DeleteEventStreamCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEventStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteGcmChannelCommand.ts b/clients/client-pinpoint/commands/DeleteGcmChannelCommand.ts index 057a18433fd1b..854d8472ccce0 100644 --- a/clients/client-pinpoint/commands/DeleteGcmChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteGcmChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGcmChannelCommandInput = DeleteGcmChannelRequest; export type DeleteGcmChannelCommandOutput = DeleteGcmChannelResponse & __MetadataBearer; +/** + *

Disables the GCM channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteGcmChannelCommand extends $Command< DeleteGcmChannelCommandInput, DeleteGcmChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGcmChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteJourneyCommand.ts b/clients/client-pinpoint/commands/DeleteJourneyCommand.ts index 2ceeab58dcb48..89681f8fc4544 100644 --- a/clients/client-pinpoint/commands/DeleteJourneyCommand.ts +++ b/clients/client-pinpoint/commands/DeleteJourneyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteJourneyCommandInput = DeleteJourneyRequest; export type DeleteJourneyCommandOutput = DeleteJourneyResponse & __MetadataBearer; +/** + *

Deletes a journey from an application.

+ */ export class DeleteJourneyCommand extends $Command< DeleteJourneyCommandInput, DeleteJourneyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteJourneyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeletePushTemplateCommand.ts b/clients/client-pinpoint/commands/DeletePushTemplateCommand.ts index 23c0bb27c5d2c..401788da2f1d8 100644 --- a/clients/client-pinpoint/commands/DeletePushTemplateCommand.ts +++ b/clients/client-pinpoint/commands/DeletePushTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePushTemplateCommandInput = DeletePushTemplateRequest; export type DeletePushTemplateCommandOutput = DeletePushTemplateResponse & __MetadataBearer; +/** + *

Deletes a message template for messages that were sent through a push notification channel.

+ */ export class DeletePushTemplateCommand extends $Command< DeletePushTemplateCommandInput, DeletePushTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeletePushTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteRecommenderConfigurationCommand.ts b/clients/client-pinpoint/commands/DeleteRecommenderConfigurationCommand.ts index baa827a70e2a8..f84cec0353cf8 100644 --- a/clients/client-pinpoint/commands/DeleteRecommenderConfigurationCommand.ts +++ b/clients/client-pinpoint/commands/DeleteRecommenderConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRecommenderConfigurationCommandInput = DeleteRecommenderConfigurationRequest; export type DeleteRecommenderConfigurationCommandOutput = DeleteRecommenderConfigurationResponse & __MetadataBearer; +/** + *

Deletes an Amazon Pinpoint configuration for a recommender model.

+ */ export class DeleteRecommenderConfigurationCommand extends $Command< DeleteRecommenderConfigurationCommandInput, DeleteRecommenderConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRecommenderConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteSegmentCommand.ts b/clients/client-pinpoint/commands/DeleteSegmentCommand.ts index 67a3e5e7aea31..2157a50636b87 100644 --- a/clients/client-pinpoint/commands/DeleteSegmentCommand.ts +++ b/clients/client-pinpoint/commands/DeleteSegmentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSegmentCommandInput = DeleteSegmentRequest; export type DeleteSegmentCommandOutput = DeleteSegmentResponse & __MetadataBearer; +/** + *

Deletes a segment from an application.

+ */ export class DeleteSegmentCommand extends $Command< DeleteSegmentCommandInput, DeleteSegmentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSegmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteSmsChannelCommand.ts b/clients/client-pinpoint/commands/DeleteSmsChannelCommand.ts index ed06f793210a1..89895bc02193a 100644 --- a/clients/client-pinpoint/commands/DeleteSmsChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteSmsChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSmsChannelCommandInput = DeleteSmsChannelRequest; export type DeleteSmsChannelCommandOutput = DeleteSmsChannelResponse & __MetadataBearer; +/** + *

Disables the SMS channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteSmsChannelCommand extends $Command< DeleteSmsChannelCommandInput, DeleteSmsChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSmsChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteSmsTemplateCommand.ts b/clients/client-pinpoint/commands/DeleteSmsTemplateCommand.ts index 82c8eb09ff290..47bcf301374dc 100644 --- a/clients/client-pinpoint/commands/DeleteSmsTemplateCommand.ts +++ b/clients/client-pinpoint/commands/DeleteSmsTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSmsTemplateCommandInput = DeleteSmsTemplateRequest; export type DeleteSmsTemplateCommandOutput = DeleteSmsTemplateResponse & __MetadataBearer; +/** + *

Deletes a message template for messages that were sent through the SMS channel.

+ */ export class DeleteSmsTemplateCommand extends $Command< DeleteSmsTemplateCommandInput, DeleteSmsTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSmsTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteUserEndpointsCommand.ts b/clients/client-pinpoint/commands/DeleteUserEndpointsCommand.ts index 85305ff338f66..f2b660c27603a 100644 --- a/clients/client-pinpoint/commands/DeleteUserEndpointsCommand.ts +++ b/clients/client-pinpoint/commands/DeleteUserEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserEndpointsCommandInput = DeleteUserEndpointsRequest; export type DeleteUserEndpointsCommandOutput = DeleteUserEndpointsResponse & __MetadataBearer; +/** + *

Deletes all the endpoints that are associated with a specific user ID.

+ */ export class DeleteUserEndpointsCommand extends $Command< DeleteUserEndpointsCommandInput, DeleteUserEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteVoiceChannelCommand.ts b/clients/client-pinpoint/commands/DeleteVoiceChannelCommand.ts index 2d5d48f8913d5..d74b9afae8b74 100644 --- a/clients/client-pinpoint/commands/DeleteVoiceChannelCommand.ts +++ b/clients/client-pinpoint/commands/DeleteVoiceChannelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVoiceChannelCommandInput = DeleteVoiceChannelRequest; export type DeleteVoiceChannelCommandOutput = DeleteVoiceChannelResponse & __MetadataBearer; +/** + *

Disables the voice channel for an application and deletes any existing settings for the channel.

+ */ export class DeleteVoiceChannelCommand extends $Command< DeleteVoiceChannelCommandInput, DeleteVoiceChannelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVoiceChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/DeleteVoiceTemplateCommand.ts b/clients/client-pinpoint/commands/DeleteVoiceTemplateCommand.ts index 946a60e991c6d..c96569d510cfb 100644 --- a/clients/client-pinpoint/commands/DeleteVoiceTemplateCommand.ts +++ b/clients/client-pinpoint/commands/DeleteVoiceTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVoiceTemplateCommandInput = DeleteVoiceTemplateRequest; export type DeleteVoiceTemplateCommandOutput = DeleteVoiceTemplateResponse & __MetadataBearer; +/** + *

Deletes a message template for messages that were sent through the voice channel.

+ */ export class DeleteVoiceTemplateCommand extends $Command< DeleteVoiceTemplateCommandInput, DeleteVoiceTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVoiceTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetAdmChannelCommand.ts b/clients/client-pinpoint/commands/GetAdmChannelCommand.ts index 588e649b35194..03ad914ba2a06 100644 --- a/clients/client-pinpoint/commands/GetAdmChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetAdmChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetAdmChannelCommandInput = GetAdmChannelRequest; export type GetAdmChannelCommandOutput = GetAdmChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the ADM channel for an application.

+ */ export class GetAdmChannelCommand extends $Command< GetAdmChannelCommandInput, GetAdmChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetAdmChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetApnsChannelCommand.ts b/clients/client-pinpoint/commands/GetApnsChannelCommand.ts index 56317e5f0bd40..f54dea22911ae 100644 --- a/clients/client-pinpoint/commands/GetApnsChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetApnsChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetApnsChannelCommandInput = GetApnsChannelRequest; export type GetApnsChannelCommandOutput = GetApnsChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the APNs channel for an application.

+ */ export class GetApnsChannelCommand extends $Command< GetApnsChannelCommandInput, GetApnsChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetApnsChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetApnsSandboxChannelCommand.ts b/clients/client-pinpoint/commands/GetApnsSandboxChannelCommand.ts index e6b45b99472e6..4133c14d9966f 100644 --- a/clients/client-pinpoint/commands/GetApnsSandboxChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetApnsSandboxChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetApnsSandboxChannelCommandInput = GetApnsSandboxChannelRequest; export type GetApnsSandboxChannelCommandOutput = GetApnsSandboxChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the APNs sandbox channel for an application.

+ */ export class GetApnsSandboxChannelCommand extends $Command< GetApnsSandboxChannelCommandInput, GetApnsSandboxChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetApnsSandboxChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetApnsVoipChannelCommand.ts b/clients/client-pinpoint/commands/GetApnsVoipChannelCommand.ts index 6f9984ae75d02..a5ec09b9dd62c 100644 --- a/clients/client-pinpoint/commands/GetApnsVoipChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetApnsVoipChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetApnsVoipChannelCommandInput = GetApnsVoipChannelRequest; export type GetApnsVoipChannelCommandOutput = GetApnsVoipChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the APNs VoIP channel for an application.

+ */ export class GetApnsVoipChannelCommand extends $Command< GetApnsVoipChannelCommandInput, GetApnsVoipChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetApnsVoipChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetApnsVoipSandboxChannelCommand.ts b/clients/client-pinpoint/commands/GetApnsVoipSandboxChannelCommand.ts index 7b8c798c5f350..599ef498a09de 100644 --- a/clients/client-pinpoint/commands/GetApnsVoipSandboxChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetApnsVoipSandboxChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetApnsVoipSandboxChannelCommandInput = GetApnsVoipSandboxChannelRequest; export type GetApnsVoipSandboxChannelCommandOutput = GetApnsVoipSandboxChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the APNs VoIP sandbox channel for an application.

+ */ export class GetApnsVoipSandboxChannelCommand extends $Command< GetApnsVoipSandboxChannelCommandInput, GetApnsVoipSandboxChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetApnsVoipSandboxChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetAppCommand.ts b/clients/client-pinpoint/commands/GetAppCommand.ts index 13e67e6f61839..a3d3c1ed6b85b 100644 --- a/clients/client-pinpoint/commands/GetAppCommand.ts +++ b/clients/client-pinpoint/commands/GetAppCommand.ts @@ -17,6 +17,9 @@ import { export type GetAppCommandInput = GetAppRequest; export type GetAppCommandOutput = GetAppResponse & __MetadataBearer; +/** + *

Retrieves information about an application.

+ */ export class GetAppCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetAppCommand extends $Command, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetApplicationDateRangeKpiCommand.ts b/clients/client-pinpoint/commands/GetApplicationDateRangeKpiCommand.ts index 31bee8db8a3ff..bf77a8439b71f 100644 --- a/clients/client-pinpoint/commands/GetApplicationDateRangeKpiCommand.ts +++ b/clients/client-pinpoint/commands/GetApplicationDateRangeKpiCommand.ts @@ -20,6 +20,9 @@ import { export type GetApplicationDateRangeKpiCommandInput = GetApplicationDateRangeKpiRequest; export type GetApplicationDateRangeKpiCommandOutput = GetApplicationDateRangeKpiResponse & __MetadataBearer; +/** + *

Retrieves (queries) pre-aggregated data for a standard metric that applies to an application.

+ */ export class GetApplicationDateRangeKpiCommand extends $Command< GetApplicationDateRangeKpiCommandInput, GetApplicationDateRangeKpiCommandOutput, @@ -34,6 +37,9 @@ export class GetApplicationDateRangeKpiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetApplicationSettingsCommand.ts b/clients/client-pinpoint/commands/GetApplicationSettingsCommand.ts index c734210e72e5a..de4e739c5e4fa 100644 --- a/clients/client-pinpoint/commands/GetApplicationSettingsCommand.ts +++ b/clients/client-pinpoint/commands/GetApplicationSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetApplicationSettingsCommandInput = GetApplicationSettingsRequest; export type GetApplicationSettingsCommandOutput = GetApplicationSettingsResponse & __MetadataBearer; +/** + *

Retrieves information about the settings for an application.

+ */ export class GetApplicationSettingsCommand extends $Command< GetApplicationSettingsCommandInput, GetApplicationSettingsCommandOutput, @@ -34,6 +37,9 @@ export class GetApplicationSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetAppsCommand.ts b/clients/client-pinpoint/commands/GetAppsCommand.ts index 36d83904db3f9..46fa81da5373e 100644 --- a/clients/client-pinpoint/commands/GetAppsCommand.ts +++ b/clients/client-pinpoint/commands/GetAppsCommand.ts @@ -20,6 +20,9 @@ import { export type GetAppsCommandInput = GetAppsRequest; export type GetAppsCommandOutput = GetAppsResponse & __MetadataBearer; +/** + *

Retrieves information about all the applications that are associated with your Amazon Pinpoint account.

+ */ export class GetAppsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class GetAppsCommand extends $Command, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetBaiduChannelCommand.ts b/clients/client-pinpoint/commands/GetBaiduChannelCommand.ts index 90a6793cecb08..fa43e277617bf 100644 --- a/clients/client-pinpoint/commands/GetBaiduChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetBaiduChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetBaiduChannelCommandInput = GetBaiduChannelRequest; export type GetBaiduChannelCommandOutput = GetBaiduChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the Baidu channel for an application.

+ */ export class GetBaiduChannelCommand extends $Command< GetBaiduChannelCommandInput, GetBaiduChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetBaiduChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetCampaignActivitiesCommand.ts b/clients/client-pinpoint/commands/GetCampaignActivitiesCommand.ts index 930296f4b4604..0df5cbfe43873 100644 --- a/clients/client-pinpoint/commands/GetCampaignActivitiesCommand.ts +++ b/clients/client-pinpoint/commands/GetCampaignActivitiesCommand.ts @@ -20,6 +20,9 @@ import { export type GetCampaignActivitiesCommandInput = GetCampaignActivitiesRequest; export type GetCampaignActivitiesCommandOutput = GetCampaignActivitiesResponse & __MetadataBearer; +/** + *

Retrieves information about all the activities for a campaign.

+ */ export class GetCampaignActivitiesCommand extends $Command< GetCampaignActivitiesCommandInput, GetCampaignActivitiesCommandOutput, @@ -34,6 +37,9 @@ export class GetCampaignActivitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetCampaignCommand.ts b/clients/client-pinpoint/commands/GetCampaignCommand.ts index c869042046f99..190bb6d958238 100644 --- a/clients/client-pinpoint/commands/GetCampaignCommand.ts +++ b/clients/client-pinpoint/commands/GetCampaignCommand.ts @@ -20,6 +20,9 @@ import { export type GetCampaignCommandInput = GetCampaignRequest; export type GetCampaignCommandOutput = GetCampaignResponse & __MetadataBearer; +/** + *

Retrieves information about the status, configuration, and other settings for a campaign.

+ */ export class GetCampaignCommand extends $Command< GetCampaignCommandInput, GetCampaignCommandOutput, @@ -34,6 +37,9 @@ export class GetCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetCampaignDateRangeKpiCommand.ts b/clients/client-pinpoint/commands/GetCampaignDateRangeKpiCommand.ts index f316eac8a9ee3..8d9899825dd92 100644 --- a/clients/client-pinpoint/commands/GetCampaignDateRangeKpiCommand.ts +++ b/clients/client-pinpoint/commands/GetCampaignDateRangeKpiCommand.ts @@ -20,6 +20,9 @@ import { export type GetCampaignDateRangeKpiCommandInput = GetCampaignDateRangeKpiRequest; export type GetCampaignDateRangeKpiCommandOutput = GetCampaignDateRangeKpiResponse & __MetadataBearer; +/** + *

Retrieves (queries) pre-aggregated data for a standard metric that applies to a campaign.

+ */ export class GetCampaignDateRangeKpiCommand extends $Command< GetCampaignDateRangeKpiCommandInput, GetCampaignDateRangeKpiCommandOutput, @@ -34,6 +37,9 @@ export class GetCampaignDateRangeKpiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetCampaignVersionCommand.ts b/clients/client-pinpoint/commands/GetCampaignVersionCommand.ts index 72f3d51f56097..a19514127dd53 100644 --- a/clients/client-pinpoint/commands/GetCampaignVersionCommand.ts +++ b/clients/client-pinpoint/commands/GetCampaignVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetCampaignVersionCommandInput = GetCampaignVersionRequest; export type GetCampaignVersionCommandOutput = GetCampaignVersionResponse & __MetadataBearer; +/** + *

Retrieves information about the status, configuration, and other settings for a specific version of a campaign.

+ */ export class GetCampaignVersionCommand extends $Command< GetCampaignVersionCommandInput, GetCampaignVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetCampaignVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetCampaignVersionsCommand.ts b/clients/client-pinpoint/commands/GetCampaignVersionsCommand.ts index 0919004dd66d0..cfab307ed6f01 100644 --- a/clients/client-pinpoint/commands/GetCampaignVersionsCommand.ts +++ b/clients/client-pinpoint/commands/GetCampaignVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetCampaignVersionsCommandInput = GetCampaignVersionsRequest; export type GetCampaignVersionsCommandOutput = GetCampaignVersionsResponse & __MetadataBearer; +/** + *

Retrieves information about the status, configuration, and other settings for all versions of a campaign.

+ */ export class GetCampaignVersionsCommand extends $Command< GetCampaignVersionsCommandInput, GetCampaignVersionsCommandOutput, @@ -34,6 +37,9 @@ export class GetCampaignVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetCampaignsCommand.ts b/clients/client-pinpoint/commands/GetCampaignsCommand.ts index 65d6da439798d..806fb3089777c 100644 --- a/clients/client-pinpoint/commands/GetCampaignsCommand.ts +++ b/clients/client-pinpoint/commands/GetCampaignsCommand.ts @@ -20,6 +20,9 @@ import { export type GetCampaignsCommandInput = GetCampaignsRequest; export type GetCampaignsCommandOutput = GetCampaignsResponse & __MetadataBearer; +/** + *

Retrieves information about the status, configuration, and other settings for all the campaigns that are associated with an application.

+ */ export class GetCampaignsCommand extends $Command< GetCampaignsCommandInput, GetCampaignsCommandOutput, @@ -34,6 +37,9 @@ export class GetCampaignsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetChannelsCommand.ts b/clients/client-pinpoint/commands/GetChannelsCommand.ts index 122b37b9a8c3f..5343c55aa3c5e 100644 --- a/clients/client-pinpoint/commands/GetChannelsCommand.ts +++ b/clients/client-pinpoint/commands/GetChannelsCommand.ts @@ -20,6 +20,9 @@ import { export type GetChannelsCommandInput = GetChannelsRequest; export type GetChannelsCommandOutput = GetChannelsResponse & __MetadataBearer; +/** + *

Retrieves information about the history and status of each channel for an application.

+ */ export class GetChannelsCommand extends $Command< GetChannelsCommandInput, GetChannelsCommandOutput, @@ -34,6 +37,9 @@ export class GetChannelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetEmailChannelCommand.ts b/clients/client-pinpoint/commands/GetEmailChannelCommand.ts index 95709bb2da80a..0bd7d5aecb835 100644 --- a/clients/client-pinpoint/commands/GetEmailChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetEmailChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetEmailChannelCommandInput = GetEmailChannelRequest; export type GetEmailChannelCommandOutput = GetEmailChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the email channel for an application.

+ */ export class GetEmailChannelCommand extends $Command< GetEmailChannelCommandInput, GetEmailChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetEmailChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetEmailTemplateCommand.ts b/clients/client-pinpoint/commands/GetEmailTemplateCommand.ts index cc46f11db039b..8e9e7f06b8f06 100644 --- a/clients/client-pinpoint/commands/GetEmailTemplateCommand.ts +++ b/clients/client-pinpoint/commands/GetEmailTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetEmailTemplateCommandInput = GetEmailTemplateRequest; export type GetEmailTemplateCommandOutput = GetEmailTemplateResponse & __MetadataBearer; +/** + *

Retrieves the content and settings of a message template for messages that are sent through the email channel.

+ */ export class GetEmailTemplateCommand extends $Command< GetEmailTemplateCommandInput, GetEmailTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetEndpointCommand.ts b/clients/client-pinpoint/commands/GetEndpointCommand.ts index e91b5194df054..1a9d9fa2cc80b 100644 --- a/clients/client-pinpoint/commands/GetEndpointCommand.ts +++ b/clients/client-pinpoint/commands/GetEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type GetEndpointCommandInput = GetEndpointRequest; export type GetEndpointCommandOutput = GetEndpointResponse & __MetadataBearer; +/** + *

Retrieves information about the settings and attributes of a specific endpoint for an application.

+ */ export class GetEndpointCommand extends $Command< GetEndpointCommandInput, GetEndpointCommandOutput, @@ -34,6 +37,9 @@ export class GetEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetEventStreamCommand.ts b/clients/client-pinpoint/commands/GetEventStreamCommand.ts index a2a049469c5cb..e657e8eaca427 100644 --- a/clients/client-pinpoint/commands/GetEventStreamCommand.ts +++ b/clients/client-pinpoint/commands/GetEventStreamCommand.ts @@ -20,6 +20,9 @@ import { export type GetEventStreamCommandInput = GetEventStreamRequest; export type GetEventStreamCommandOutput = GetEventStreamResponse & __MetadataBearer; +/** + *

Retrieves information about the event stream settings for an application.

+ */ export class GetEventStreamCommand extends $Command< GetEventStreamCommandInput, GetEventStreamCommandOutput, @@ -34,6 +37,9 @@ export class GetEventStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetExportJobCommand.ts b/clients/client-pinpoint/commands/GetExportJobCommand.ts index 79043591eb52f..5204fc2a9216d 100644 --- a/clients/client-pinpoint/commands/GetExportJobCommand.ts +++ b/clients/client-pinpoint/commands/GetExportJobCommand.ts @@ -20,6 +20,9 @@ import { export type GetExportJobCommandInput = GetExportJobRequest; export type GetExportJobCommandOutput = GetExportJobResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of a specific export job for an application.

+ */ export class GetExportJobCommand extends $Command< GetExportJobCommandInput, GetExportJobCommandOutput, @@ -34,6 +37,9 @@ export class GetExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetExportJobsCommand.ts b/clients/client-pinpoint/commands/GetExportJobsCommand.ts index 0c13761588f17..e4ff34ea75b5d 100644 --- a/clients/client-pinpoint/commands/GetExportJobsCommand.ts +++ b/clients/client-pinpoint/commands/GetExportJobsCommand.ts @@ -20,6 +20,9 @@ import { export type GetExportJobsCommandInput = GetExportJobsRequest; export type GetExportJobsCommandOutput = GetExportJobsResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of all the export jobs for an application.

+ */ export class GetExportJobsCommand extends $Command< GetExportJobsCommandInput, GetExportJobsCommandOutput, @@ -34,6 +37,9 @@ export class GetExportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetGcmChannelCommand.ts b/clients/client-pinpoint/commands/GetGcmChannelCommand.ts index 575c3a51cd703..cf4dde0b698e4 100644 --- a/clients/client-pinpoint/commands/GetGcmChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetGcmChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetGcmChannelCommandInput = GetGcmChannelRequest; export type GetGcmChannelCommandOutput = GetGcmChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the GCM channel for an application.

+ */ export class GetGcmChannelCommand extends $Command< GetGcmChannelCommandInput, GetGcmChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetGcmChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetImportJobCommand.ts b/clients/client-pinpoint/commands/GetImportJobCommand.ts index a5ab80789015f..1a108ac108db6 100644 --- a/clients/client-pinpoint/commands/GetImportJobCommand.ts +++ b/clients/client-pinpoint/commands/GetImportJobCommand.ts @@ -20,6 +20,9 @@ import { export type GetImportJobCommandInput = GetImportJobRequest; export type GetImportJobCommandOutput = GetImportJobResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of a specific import job for an application.

+ */ export class GetImportJobCommand extends $Command< GetImportJobCommandInput, GetImportJobCommandOutput, @@ -34,6 +37,9 @@ export class GetImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetImportJobsCommand.ts b/clients/client-pinpoint/commands/GetImportJobsCommand.ts index e8b1d1f77805b..0ecd74824c7d6 100644 --- a/clients/client-pinpoint/commands/GetImportJobsCommand.ts +++ b/clients/client-pinpoint/commands/GetImportJobsCommand.ts @@ -20,6 +20,9 @@ import { export type GetImportJobsCommandInput = GetImportJobsRequest; export type GetImportJobsCommandOutput = GetImportJobsResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of all the import jobs for an application.

+ */ export class GetImportJobsCommand extends $Command< GetImportJobsCommandInput, GetImportJobsCommandOutput, @@ -34,6 +37,9 @@ export class GetImportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetJourneyCommand.ts b/clients/client-pinpoint/commands/GetJourneyCommand.ts index 07a5198dcb535..02f11113ebe62 100644 --- a/clients/client-pinpoint/commands/GetJourneyCommand.ts +++ b/clients/client-pinpoint/commands/GetJourneyCommand.ts @@ -20,6 +20,9 @@ import { export type GetJourneyCommandInput = GetJourneyRequest; export type GetJourneyCommandOutput = GetJourneyResponse & __MetadataBearer; +/** + *

Retrieves information about the status, configuration, and other settings for a journey.

+ */ export class GetJourneyCommand extends $Command< GetJourneyCommandInput, GetJourneyCommandOutput, @@ -34,6 +37,9 @@ export class GetJourneyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetJourneyDateRangeKpiCommand.ts b/clients/client-pinpoint/commands/GetJourneyDateRangeKpiCommand.ts index b92b374c79cf4..b0b7282290a1b 100644 --- a/clients/client-pinpoint/commands/GetJourneyDateRangeKpiCommand.ts +++ b/clients/client-pinpoint/commands/GetJourneyDateRangeKpiCommand.ts @@ -20,6 +20,9 @@ import { export type GetJourneyDateRangeKpiCommandInput = GetJourneyDateRangeKpiRequest; export type GetJourneyDateRangeKpiCommandOutput = GetJourneyDateRangeKpiResponse & __MetadataBearer; +/** + *

Retrieves (queries) pre-aggregated data for a standard engagement metric that applies to a journey.

+ */ export class GetJourneyDateRangeKpiCommand extends $Command< GetJourneyDateRangeKpiCommandInput, GetJourneyDateRangeKpiCommandOutput, @@ -34,6 +37,9 @@ export class GetJourneyDateRangeKpiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetJourneyExecutionActivityMetricsCommand.ts b/clients/client-pinpoint/commands/GetJourneyExecutionActivityMetricsCommand.ts index 23b7fd54d2c8b..c2217237f94cc 100644 --- a/clients/client-pinpoint/commands/GetJourneyExecutionActivityMetricsCommand.ts +++ b/clients/client-pinpoint/commands/GetJourneyExecutionActivityMetricsCommand.ts @@ -24,6 +24,9 @@ export type GetJourneyExecutionActivityMetricsCommandInput = GetJourneyExecution export type GetJourneyExecutionActivityMetricsCommandOutput = GetJourneyExecutionActivityMetricsResponse & __MetadataBearer; +/** + *

Retrieves (queries) pre-aggregated data for a standard execution metric that applies to a journey activity.

+ */ export class GetJourneyExecutionActivityMetricsCommand extends $Command< GetJourneyExecutionActivityMetricsCommandInput, GetJourneyExecutionActivityMetricsCommandOutput, @@ -38,6 +41,9 @@ export class GetJourneyExecutionActivityMetricsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetJourneyExecutionMetricsCommand.ts b/clients/client-pinpoint/commands/GetJourneyExecutionMetricsCommand.ts index 77865ee7993ed..733e4975ef36b 100644 --- a/clients/client-pinpoint/commands/GetJourneyExecutionMetricsCommand.ts +++ b/clients/client-pinpoint/commands/GetJourneyExecutionMetricsCommand.ts @@ -20,6 +20,9 @@ import { export type GetJourneyExecutionMetricsCommandInput = GetJourneyExecutionMetricsRequest; export type GetJourneyExecutionMetricsCommandOutput = GetJourneyExecutionMetricsResponse & __MetadataBearer; +/** + *

Retrieves (queries) pre-aggregated data for a standard execution metric that applies to a journey.

+ */ export class GetJourneyExecutionMetricsCommand extends $Command< GetJourneyExecutionMetricsCommandInput, GetJourneyExecutionMetricsCommandOutput, @@ -34,6 +37,9 @@ export class GetJourneyExecutionMetricsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetPushTemplateCommand.ts b/clients/client-pinpoint/commands/GetPushTemplateCommand.ts index 750062e1a8760..2160e3826f167 100644 --- a/clients/client-pinpoint/commands/GetPushTemplateCommand.ts +++ b/clients/client-pinpoint/commands/GetPushTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetPushTemplateCommandInput = GetPushTemplateRequest; export type GetPushTemplateCommandOutput = GetPushTemplateResponse & __MetadataBearer; +/** + *

Retrieves the content and settings of a message template for messages that are sent through a push notification channel.

+ */ export class GetPushTemplateCommand extends $Command< GetPushTemplateCommandInput, GetPushTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetPushTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetRecommenderConfigurationCommand.ts b/clients/client-pinpoint/commands/GetRecommenderConfigurationCommand.ts index 394fd73b9e731..5b49f28a3c82b 100644 --- a/clients/client-pinpoint/commands/GetRecommenderConfigurationCommand.ts +++ b/clients/client-pinpoint/commands/GetRecommenderConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetRecommenderConfigurationCommandInput = GetRecommenderConfigurationRequest; export type GetRecommenderConfigurationCommandOutput = GetRecommenderConfigurationResponse & __MetadataBearer; +/** + *

Retrieves information about an Amazon Pinpoint configuration for a recommender model.

+ */ export class GetRecommenderConfigurationCommand extends $Command< GetRecommenderConfigurationCommandInput, GetRecommenderConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetRecommenderConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetRecommenderConfigurationsCommand.ts b/clients/client-pinpoint/commands/GetRecommenderConfigurationsCommand.ts index 186f9eec9f3f7..bfb497cb81651 100644 --- a/clients/client-pinpoint/commands/GetRecommenderConfigurationsCommand.ts +++ b/clients/client-pinpoint/commands/GetRecommenderConfigurationsCommand.ts @@ -20,6 +20,9 @@ import { export type GetRecommenderConfigurationsCommandInput = GetRecommenderConfigurationsRequest; export type GetRecommenderConfigurationsCommandOutput = GetRecommenderConfigurationsResponse & __MetadataBearer; +/** + *

Retrieves information about all the recommender model configurations that are associated with your Amazon Pinpoint account.

+ */ export class GetRecommenderConfigurationsCommand extends $Command< GetRecommenderConfigurationsCommandInput, GetRecommenderConfigurationsCommandOutput, @@ -34,6 +37,9 @@ export class GetRecommenderConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetSegmentCommand.ts b/clients/client-pinpoint/commands/GetSegmentCommand.ts index 3a15961bd1e46..9af4137900908 100644 --- a/clients/client-pinpoint/commands/GetSegmentCommand.ts +++ b/clients/client-pinpoint/commands/GetSegmentCommand.ts @@ -20,6 +20,9 @@ import { export type GetSegmentCommandInput = GetSegmentRequest; export type GetSegmentCommandOutput = GetSegmentResponse & __MetadataBearer; +/** + *

Retrieves information about the configuration, dimension, and other settings for a specific segment that's associated with an application.

+ */ export class GetSegmentCommand extends $Command< GetSegmentCommandInput, GetSegmentCommandOutput, @@ -34,6 +37,9 @@ export class GetSegmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetSegmentExportJobsCommand.ts b/clients/client-pinpoint/commands/GetSegmentExportJobsCommand.ts index d03e039991ab0..ad17dee781b0e 100644 --- a/clients/client-pinpoint/commands/GetSegmentExportJobsCommand.ts +++ b/clients/client-pinpoint/commands/GetSegmentExportJobsCommand.ts @@ -20,6 +20,9 @@ import { export type GetSegmentExportJobsCommandInput = GetSegmentExportJobsRequest; export type GetSegmentExportJobsCommandOutput = GetSegmentExportJobsResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the export jobs for a segment.

+ */ export class GetSegmentExportJobsCommand extends $Command< GetSegmentExportJobsCommandInput, GetSegmentExportJobsCommandOutput, @@ -34,6 +37,9 @@ export class GetSegmentExportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetSegmentImportJobsCommand.ts b/clients/client-pinpoint/commands/GetSegmentImportJobsCommand.ts index d9d4645a22995..33711450599d6 100644 --- a/clients/client-pinpoint/commands/GetSegmentImportJobsCommand.ts +++ b/clients/client-pinpoint/commands/GetSegmentImportJobsCommand.ts @@ -20,6 +20,9 @@ import { export type GetSegmentImportJobsCommandInput = GetSegmentImportJobsRequest; export type GetSegmentImportJobsCommandOutput = GetSegmentImportJobsResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the import jobs for a segment.

+ */ export class GetSegmentImportJobsCommand extends $Command< GetSegmentImportJobsCommandInput, GetSegmentImportJobsCommandOutput, @@ -34,6 +37,9 @@ export class GetSegmentImportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetSegmentVersionCommand.ts b/clients/client-pinpoint/commands/GetSegmentVersionCommand.ts index 274d1772781ba..e724ba05fa175 100644 --- a/clients/client-pinpoint/commands/GetSegmentVersionCommand.ts +++ b/clients/client-pinpoint/commands/GetSegmentVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetSegmentVersionCommandInput = GetSegmentVersionRequest; export type GetSegmentVersionCommandOutput = GetSegmentVersionResponse & __MetadataBearer; +/** + *

Retrieves information about the configuration, dimension, and other settings for a specific version of a segment that's associated with an application.

+ */ export class GetSegmentVersionCommand extends $Command< GetSegmentVersionCommandInput, GetSegmentVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetSegmentVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetSegmentVersionsCommand.ts b/clients/client-pinpoint/commands/GetSegmentVersionsCommand.ts index 87bf640de1220..d321576e5f8e4 100644 --- a/clients/client-pinpoint/commands/GetSegmentVersionsCommand.ts +++ b/clients/client-pinpoint/commands/GetSegmentVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetSegmentVersionsCommandInput = GetSegmentVersionsRequest; export type GetSegmentVersionsCommandOutput = GetSegmentVersionsResponse & __MetadataBearer; +/** + *

Retrieves information about the configuration, dimension, and other settings for all the versions of a specific segment that's associated with an application.

+ */ export class GetSegmentVersionsCommand extends $Command< GetSegmentVersionsCommandInput, GetSegmentVersionsCommandOutput, @@ -34,6 +37,9 @@ export class GetSegmentVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetSegmentsCommand.ts b/clients/client-pinpoint/commands/GetSegmentsCommand.ts index eb688b1b719bd..76538088f82cd 100644 --- a/clients/client-pinpoint/commands/GetSegmentsCommand.ts +++ b/clients/client-pinpoint/commands/GetSegmentsCommand.ts @@ -20,6 +20,9 @@ import { export type GetSegmentsCommandInput = GetSegmentsRequest; export type GetSegmentsCommandOutput = GetSegmentsResponse & __MetadataBearer; +/** + *

Retrieves information about the configuration, dimension, and other settings for all the segments that are associated with an application.

+ */ export class GetSegmentsCommand extends $Command< GetSegmentsCommandInput, GetSegmentsCommandOutput, @@ -34,6 +37,9 @@ export class GetSegmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetSmsChannelCommand.ts b/clients/client-pinpoint/commands/GetSmsChannelCommand.ts index beae15ae01597..e2afbafc86327 100644 --- a/clients/client-pinpoint/commands/GetSmsChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetSmsChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetSmsChannelCommandInput = GetSmsChannelRequest; export type GetSmsChannelCommandOutput = GetSmsChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the SMS channel for an application.

+ */ export class GetSmsChannelCommand extends $Command< GetSmsChannelCommandInput, GetSmsChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetSmsChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetSmsTemplateCommand.ts b/clients/client-pinpoint/commands/GetSmsTemplateCommand.ts index d559c51e65ba1..34c98c19f6a6f 100644 --- a/clients/client-pinpoint/commands/GetSmsTemplateCommand.ts +++ b/clients/client-pinpoint/commands/GetSmsTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetSmsTemplateCommandInput = GetSmsTemplateRequest; export type GetSmsTemplateCommandOutput = GetSmsTemplateResponse & __MetadataBearer; +/** + *

Retrieves the content and settings of a message template for messages that are sent through the SMS channel.

+ */ export class GetSmsTemplateCommand extends $Command< GetSmsTemplateCommandInput, GetSmsTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetSmsTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetUserEndpointsCommand.ts b/clients/client-pinpoint/commands/GetUserEndpointsCommand.ts index 5ba2addd971d6..c9e060c446fde 100644 --- a/clients/client-pinpoint/commands/GetUserEndpointsCommand.ts +++ b/clients/client-pinpoint/commands/GetUserEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type GetUserEndpointsCommandInput = GetUserEndpointsRequest; export type GetUserEndpointsCommandOutput = GetUserEndpointsResponse & __MetadataBearer; +/** + *

Retrieves information about all the endpoints that are associated with a specific user ID.

+ */ export class GetUserEndpointsCommand extends $Command< GetUserEndpointsCommandInput, GetUserEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class GetUserEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetVoiceChannelCommand.ts b/clients/client-pinpoint/commands/GetVoiceChannelCommand.ts index 1f70b0f696200..f23c1229af05b 100644 --- a/clients/client-pinpoint/commands/GetVoiceChannelCommand.ts +++ b/clients/client-pinpoint/commands/GetVoiceChannelCommand.ts @@ -20,6 +20,9 @@ import { export type GetVoiceChannelCommandInput = GetVoiceChannelRequest; export type GetVoiceChannelCommandOutput = GetVoiceChannelResponse & __MetadataBearer; +/** + *

Retrieves information about the status and settings of the voice channel for an application.

+ */ export class GetVoiceChannelCommand extends $Command< GetVoiceChannelCommandInput, GetVoiceChannelCommandOutput, @@ -34,6 +37,9 @@ export class GetVoiceChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/GetVoiceTemplateCommand.ts b/clients/client-pinpoint/commands/GetVoiceTemplateCommand.ts index 841fc700728de..0db19e4f40f68 100644 --- a/clients/client-pinpoint/commands/GetVoiceTemplateCommand.ts +++ b/clients/client-pinpoint/commands/GetVoiceTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type GetVoiceTemplateCommandInput = GetVoiceTemplateRequest; export type GetVoiceTemplateCommandOutput = GetVoiceTemplateResponse & __MetadataBearer; +/** + *

Retrieves the content and settings of a message template for messages that are sent through the voice channel.

+ */ export class GetVoiceTemplateCommand extends $Command< GetVoiceTemplateCommandInput, GetVoiceTemplateCommandOutput, @@ -34,6 +37,9 @@ export class GetVoiceTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/ListJourneysCommand.ts b/clients/client-pinpoint/commands/ListJourneysCommand.ts index e3603d57901c1..e40a15976c75a 100644 --- a/clients/client-pinpoint/commands/ListJourneysCommand.ts +++ b/clients/client-pinpoint/commands/ListJourneysCommand.ts @@ -20,6 +20,9 @@ import { export type ListJourneysCommandInput = ListJourneysRequest; export type ListJourneysCommandOutput = ListJourneysResponse & __MetadataBearer; +/** + *

Retrieves information about the status, configuration, and other settings for all the journeys that are associated with an application.

+ */ export class ListJourneysCommand extends $Command< ListJourneysCommandInput, ListJourneysCommandOutput, @@ -34,6 +37,9 @@ export class ListJourneysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/ListTagsForResourceCommand.ts b/clients/client-pinpoint/commands/ListTagsForResourceCommand.ts index 9b23e85af9485..12cdd9c4dd324 100644 --- a/clients/client-pinpoint/commands/ListTagsForResourceCommand.ts +++ b/clients/client-pinpoint/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves all the tags (keys and values) that are associated with an application, campaign, message template, or segment.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/ListTemplateVersionsCommand.ts b/clients/client-pinpoint/commands/ListTemplateVersionsCommand.ts index efddad27e240e..4c0df56de3796 100644 --- a/clients/client-pinpoint/commands/ListTemplateVersionsCommand.ts +++ b/clients/client-pinpoint/commands/ListTemplateVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTemplateVersionsCommandInput = ListTemplateVersionsRequest; export type ListTemplateVersionsCommandOutput = ListTemplateVersionsResponse & __MetadataBearer; +/** + *

Retrieves information about all the versions of a specific message template.

+ */ export class ListTemplateVersionsCommand extends $Command< ListTemplateVersionsCommandInput, ListTemplateVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListTemplateVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/ListTemplatesCommand.ts b/clients/client-pinpoint/commands/ListTemplatesCommand.ts index 31d53a3f59c28..53bc09e69c463 100644 --- a/clients/client-pinpoint/commands/ListTemplatesCommand.ts +++ b/clients/client-pinpoint/commands/ListTemplatesCommand.ts @@ -20,6 +20,9 @@ import { export type ListTemplatesCommandInput = ListTemplatesRequest; export type ListTemplatesCommandOutput = ListTemplatesResponse & __MetadataBearer; +/** + *

Retrieves information about all the message templates that are associated with your Amazon Pinpoint account.

+ */ export class ListTemplatesCommand extends $Command< ListTemplatesCommandInput, ListTemplatesCommandOutput, @@ -34,6 +37,9 @@ export class ListTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/PhoneNumberValidateCommand.ts b/clients/client-pinpoint/commands/PhoneNumberValidateCommand.ts index 3579f1da28517..aeedfec213c75 100644 --- a/clients/client-pinpoint/commands/PhoneNumberValidateCommand.ts +++ b/clients/client-pinpoint/commands/PhoneNumberValidateCommand.ts @@ -20,6 +20,9 @@ import { export type PhoneNumberValidateCommandInput = PhoneNumberValidateRequest; export type PhoneNumberValidateCommandOutput = PhoneNumberValidateResponse & __MetadataBearer; +/** + *

Retrieves information about a phone number.

+ */ export class PhoneNumberValidateCommand extends $Command< PhoneNumberValidateCommandInput, PhoneNumberValidateCommandOutput, @@ -34,6 +37,9 @@ export class PhoneNumberValidateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/PutEventStreamCommand.ts b/clients/client-pinpoint/commands/PutEventStreamCommand.ts index a3514055355e7..a822e58638ef1 100644 --- a/clients/client-pinpoint/commands/PutEventStreamCommand.ts +++ b/clients/client-pinpoint/commands/PutEventStreamCommand.ts @@ -20,6 +20,9 @@ import { export type PutEventStreamCommandInput = PutEventStreamRequest; export type PutEventStreamCommandOutput = PutEventStreamResponse & __MetadataBearer; +/** + *

Creates a new event stream for an application or updates the settings of an existing event stream for an application.

+ */ export class PutEventStreamCommand extends $Command< PutEventStreamCommandInput, PutEventStreamCommandOutput, @@ -34,6 +37,9 @@ export class PutEventStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/PutEventsCommand.ts b/clients/client-pinpoint/commands/PutEventsCommand.ts index 4644fdaa8595b..b9032620bd51d 100644 --- a/clients/client-pinpoint/commands/PutEventsCommand.ts +++ b/clients/client-pinpoint/commands/PutEventsCommand.ts @@ -20,6 +20,9 @@ import { export type PutEventsCommandInput = PutEventsRequest; export type PutEventsCommandOutput = PutEventsResponse & __MetadataBearer; +/** + *

Creates a new event to record for endpoints, or creates or updates endpoint data that existing events are associated with.

+ */ export class PutEventsCommand extends $Command< PutEventsCommandInput, PutEventsCommandOutput, @@ -34,6 +37,9 @@ export class PutEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/RemoveAttributesCommand.ts b/clients/client-pinpoint/commands/RemoveAttributesCommand.ts index 30250976d3860..61ca9d6866a41 100644 --- a/clients/client-pinpoint/commands/RemoveAttributesCommand.ts +++ b/clients/client-pinpoint/commands/RemoveAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveAttributesCommandInput = RemoveAttributesRequest; export type RemoveAttributesCommandOutput = RemoveAttributesResponse & __MetadataBearer; +/** + *

Removes one or more attributes, of the same attribute type, from all the endpoints that are associated with an application.

+ */ export class RemoveAttributesCommand extends $Command< RemoveAttributesCommandInput, RemoveAttributesCommandOutput, @@ -34,6 +37,9 @@ export class RemoveAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/SendMessagesCommand.ts b/clients/client-pinpoint/commands/SendMessagesCommand.ts index b2d4a8bbbc4b0..c6c8c04a4ff62 100644 --- a/clients/client-pinpoint/commands/SendMessagesCommand.ts +++ b/clients/client-pinpoint/commands/SendMessagesCommand.ts @@ -20,6 +20,9 @@ import { export type SendMessagesCommandInput = SendMessagesRequest; export type SendMessagesCommandOutput = SendMessagesResponse & __MetadataBearer; +/** + *

Creates and sends a direct message.

+ */ export class SendMessagesCommand extends $Command< SendMessagesCommandInput, SendMessagesCommandOutput, @@ -34,6 +37,9 @@ export class SendMessagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/SendUsersMessagesCommand.ts b/clients/client-pinpoint/commands/SendUsersMessagesCommand.ts index 0c52f3857fbc0..54b1cb01ca567 100644 --- a/clients/client-pinpoint/commands/SendUsersMessagesCommand.ts +++ b/clients/client-pinpoint/commands/SendUsersMessagesCommand.ts @@ -20,6 +20,9 @@ import { export type SendUsersMessagesCommandInput = SendUsersMessagesRequest; export type SendUsersMessagesCommandOutput = SendUsersMessagesResponse & __MetadataBearer; +/** + *

Creates and sends a message to a list of users.

+ */ export class SendUsersMessagesCommand extends $Command< SendUsersMessagesCommandInput, SendUsersMessagesCommandOutput, @@ -34,6 +37,9 @@ export class SendUsersMessagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/TagResourceCommand.ts b/clients/client-pinpoint/commands/TagResourceCommand.ts index 65f034382c767..00dae71b7e619 100644 --- a/clients/client-pinpoint/commands/TagResourceCommand.ts +++ b/clients/client-pinpoint/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Adds one or more tags (keys and values) to an application, campaign, message template, or segment.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UntagResourceCommand.ts b/clients/client-pinpoint/commands/UntagResourceCommand.ts index 8f02f45d0a7c7..fdd000fd7cd9f 100644 --- a/clients/client-pinpoint/commands/UntagResourceCommand.ts +++ b/clients/client-pinpoint/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes one or more tags (keys and values) from an application, campaign, message template, or segment.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateAdmChannelCommand.ts b/clients/client-pinpoint/commands/UpdateAdmChannelCommand.ts index 0ef9a488852f5..a16ed8a39f71f 100644 --- a/clients/client-pinpoint/commands/UpdateAdmChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateAdmChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAdmChannelCommandInput = UpdateAdmChannelRequest; export type UpdateAdmChannelCommandOutput = UpdateAdmChannelResponse & __MetadataBearer; +/** + *

Enables the ADM channel for an application or updates the status and settings of the ADM channel for an application.

+ */ export class UpdateAdmChannelCommand extends $Command< UpdateAdmChannelCommandInput, UpdateAdmChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAdmChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateApnsChannelCommand.ts b/clients/client-pinpoint/commands/UpdateApnsChannelCommand.ts index 835ea26aa153b..a912c25a76f62 100644 --- a/clients/client-pinpoint/commands/UpdateApnsChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateApnsChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApnsChannelCommandInput = UpdateApnsChannelRequest; export type UpdateApnsChannelCommandOutput = UpdateApnsChannelResponse & __MetadataBearer; +/** + *

Enables the APNs channel for an application or updates the status and settings of the APNs channel for an application.

+ */ export class UpdateApnsChannelCommand extends $Command< UpdateApnsChannelCommandInput, UpdateApnsChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApnsChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateApnsSandboxChannelCommand.ts b/clients/client-pinpoint/commands/UpdateApnsSandboxChannelCommand.ts index a0e041b940254..9e15a7d9ab7f7 100644 --- a/clients/client-pinpoint/commands/UpdateApnsSandboxChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateApnsSandboxChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApnsSandboxChannelCommandInput = UpdateApnsSandboxChannelRequest; export type UpdateApnsSandboxChannelCommandOutput = UpdateApnsSandboxChannelResponse & __MetadataBearer; +/** + *

Enables the APNs sandbox channel for an application or updates the status and settings of the APNs sandbox channel for an application.

+ */ export class UpdateApnsSandboxChannelCommand extends $Command< UpdateApnsSandboxChannelCommandInput, UpdateApnsSandboxChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApnsSandboxChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateApnsVoipChannelCommand.ts b/clients/client-pinpoint/commands/UpdateApnsVoipChannelCommand.ts index 86cdb98476ce4..8973e56f61d41 100644 --- a/clients/client-pinpoint/commands/UpdateApnsVoipChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateApnsVoipChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApnsVoipChannelCommandInput = UpdateApnsVoipChannelRequest; export type UpdateApnsVoipChannelCommandOutput = UpdateApnsVoipChannelResponse & __MetadataBearer; +/** + *

Enables the APNs VoIP channel for an application or updates the status and settings of the APNs VoIP channel for an application.

+ */ export class UpdateApnsVoipChannelCommand extends $Command< UpdateApnsVoipChannelCommandInput, UpdateApnsVoipChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApnsVoipChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateApnsVoipSandboxChannelCommand.ts b/clients/client-pinpoint/commands/UpdateApnsVoipSandboxChannelCommand.ts index 7fc61c790b12e..87c7df6b16f13 100644 --- a/clients/client-pinpoint/commands/UpdateApnsVoipSandboxChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateApnsVoipSandboxChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApnsVoipSandboxChannelCommandInput = UpdateApnsVoipSandboxChannelRequest; export type UpdateApnsVoipSandboxChannelCommandOutput = UpdateApnsVoipSandboxChannelResponse & __MetadataBearer; +/** + *

Enables the APNs VoIP sandbox channel for an application or updates the status and settings of the APNs VoIP sandbox channel for an application.

+ */ export class UpdateApnsVoipSandboxChannelCommand extends $Command< UpdateApnsVoipSandboxChannelCommandInput, UpdateApnsVoipSandboxChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApnsVoipSandboxChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateApplicationSettingsCommand.ts b/clients/client-pinpoint/commands/UpdateApplicationSettingsCommand.ts index f08c233633e3b..56df82ff0b5ab 100644 --- a/clients/client-pinpoint/commands/UpdateApplicationSettingsCommand.ts +++ b/clients/client-pinpoint/commands/UpdateApplicationSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateApplicationSettingsCommandInput = UpdateApplicationSettingsRequest; export type UpdateApplicationSettingsCommandOutput = UpdateApplicationSettingsResponse & __MetadataBearer; +/** + *

Updates the settings for an application.

+ */ export class UpdateApplicationSettingsCommand extends $Command< UpdateApplicationSettingsCommandInput, UpdateApplicationSettingsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateApplicationSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateBaiduChannelCommand.ts b/clients/client-pinpoint/commands/UpdateBaiduChannelCommand.ts index 182e8e94247d0..d21ea8c4ea6a5 100644 --- a/clients/client-pinpoint/commands/UpdateBaiduChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateBaiduChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateBaiduChannelCommandInput = UpdateBaiduChannelRequest; export type UpdateBaiduChannelCommandOutput = UpdateBaiduChannelResponse & __MetadataBearer; +/** + *

Enables the Baidu channel for an application or updates the status and settings of the Baidu channel for an application.

+ */ export class UpdateBaiduChannelCommand extends $Command< UpdateBaiduChannelCommandInput, UpdateBaiduChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateBaiduChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateCampaignCommand.ts b/clients/client-pinpoint/commands/UpdateCampaignCommand.ts index 44ead0976c1b6..dbbba097b3ef9 100644 --- a/clients/client-pinpoint/commands/UpdateCampaignCommand.ts +++ b/clients/client-pinpoint/commands/UpdateCampaignCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateCampaignCommandInput = UpdateCampaignRequest; export type UpdateCampaignCommandOutput = UpdateCampaignResponse & __MetadataBearer; +/** + *

Updates the configuration and other settings for a campaign.

+ */ export class UpdateCampaignCommand extends $Command< UpdateCampaignCommandInput, UpdateCampaignCommandOutput, @@ -34,6 +37,9 @@ export class UpdateCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateEmailChannelCommand.ts b/clients/client-pinpoint/commands/UpdateEmailChannelCommand.ts index ed3f195bfd297..d8c7291949f98 100644 --- a/clients/client-pinpoint/commands/UpdateEmailChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateEmailChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEmailChannelCommandInput = UpdateEmailChannelRequest; export type UpdateEmailChannelCommandOutput = UpdateEmailChannelResponse & __MetadataBearer; +/** + *

Enables the email channel for an application or updates the status and settings of the email channel for an application.

+ */ export class UpdateEmailChannelCommand extends $Command< UpdateEmailChannelCommandInput, UpdateEmailChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEmailChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateEmailTemplateCommand.ts b/clients/client-pinpoint/commands/UpdateEmailTemplateCommand.ts index 6fc769f7c5e88..7b9dc2bf6d4a2 100644 --- a/clients/client-pinpoint/commands/UpdateEmailTemplateCommand.ts +++ b/clients/client-pinpoint/commands/UpdateEmailTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEmailTemplateCommandInput = UpdateEmailTemplateRequest; export type UpdateEmailTemplateCommandOutput = UpdateEmailTemplateResponse & __MetadataBearer; +/** + *

Updates an existing message template for messages that are sent through the email channel.

+ */ export class UpdateEmailTemplateCommand extends $Command< UpdateEmailTemplateCommandInput, UpdateEmailTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateEndpointCommand.ts b/clients/client-pinpoint/commands/UpdateEndpointCommand.ts index bb8948c6e16a9..7801191d5fdd4 100644 --- a/clients/client-pinpoint/commands/UpdateEndpointCommand.ts +++ b/clients/client-pinpoint/commands/UpdateEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEndpointCommandInput = UpdateEndpointRequest; export type UpdateEndpointCommandOutput = UpdateEndpointResponse & __MetadataBearer; +/** + *

Creates a new endpoint for an application or updates the settings and attributes of an existing endpoint for an application. You can also use this operation to define custom attributes for an endpoint. If an update includes one or more values for a custom attribute, Amazon Pinpoint replaces (overwrites) any existing values with the new values.

+ */ export class UpdateEndpointCommand extends $Command< UpdateEndpointCommandInput, UpdateEndpointCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateEndpointsBatchCommand.ts b/clients/client-pinpoint/commands/UpdateEndpointsBatchCommand.ts index 2870ae8917f33..221781a856b29 100644 --- a/clients/client-pinpoint/commands/UpdateEndpointsBatchCommand.ts +++ b/clients/client-pinpoint/commands/UpdateEndpointsBatchCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEndpointsBatchCommandInput = UpdateEndpointsBatchRequest; export type UpdateEndpointsBatchCommandOutput = UpdateEndpointsBatchResponse & __MetadataBearer; +/** + *

Creates a new batch of endpoints for an application or updates the settings and attributes of a batch of existing endpoints for an application. You can also use this operation to define custom attributes for a batch of endpoints. If an update includes one or more values for a custom attribute, Amazon Pinpoint replaces (overwrites) any existing values with the new values.

+ */ export class UpdateEndpointsBatchCommand extends $Command< UpdateEndpointsBatchCommandInput, UpdateEndpointsBatchCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEndpointsBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateGcmChannelCommand.ts b/clients/client-pinpoint/commands/UpdateGcmChannelCommand.ts index 8325e3690a228..92231be0bca69 100644 --- a/clients/client-pinpoint/commands/UpdateGcmChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateGcmChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGcmChannelCommandInput = UpdateGcmChannelRequest; export type UpdateGcmChannelCommandOutput = UpdateGcmChannelResponse & __MetadataBearer; +/** + *

Enables the GCM channel for an application or updates the status and settings of the GCM channel for an application.

+ */ export class UpdateGcmChannelCommand extends $Command< UpdateGcmChannelCommandInput, UpdateGcmChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGcmChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateJourneyCommand.ts b/clients/client-pinpoint/commands/UpdateJourneyCommand.ts index 879d682315bb8..31b9b33815647 100644 --- a/clients/client-pinpoint/commands/UpdateJourneyCommand.ts +++ b/clients/client-pinpoint/commands/UpdateJourneyCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateJourneyCommandInput = UpdateJourneyRequest; export type UpdateJourneyCommandOutput = UpdateJourneyResponse & __MetadataBearer; +/** + *

Updates the configuration and other settings for a journey.

+ */ export class UpdateJourneyCommand extends $Command< UpdateJourneyCommandInput, UpdateJourneyCommandOutput, @@ -34,6 +37,9 @@ export class UpdateJourneyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateJourneyStateCommand.ts b/clients/client-pinpoint/commands/UpdateJourneyStateCommand.ts index 848542d620c7d..2dc87263609c2 100644 --- a/clients/client-pinpoint/commands/UpdateJourneyStateCommand.ts +++ b/clients/client-pinpoint/commands/UpdateJourneyStateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateJourneyStateCommandInput = UpdateJourneyStateRequest; export type UpdateJourneyStateCommandOutput = UpdateJourneyStateResponse & __MetadataBearer; +/** + *

Cancels (stops) an active journey.

+ */ export class UpdateJourneyStateCommand extends $Command< UpdateJourneyStateCommandInput, UpdateJourneyStateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateJourneyStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdatePushTemplateCommand.ts b/clients/client-pinpoint/commands/UpdatePushTemplateCommand.ts index a39246fe5274f..f7bb5af4dec7f 100644 --- a/clients/client-pinpoint/commands/UpdatePushTemplateCommand.ts +++ b/clients/client-pinpoint/commands/UpdatePushTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePushTemplateCommandInput = UpdatePushTemplateRequest; export type UpdatePushTemplateCommandOutput = UpdatePushTemplateResponse & __MetadataBearer; +/** + *

Updates an existing message template for messages that are sent through a push notification channel.

+ */ export class UpdatePushTemplateCommand extends $Command< UpdatePushTemplateCommandInput, UpdatePushTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePushTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateRecommenderConfigurationCommand.ts b/clients/client-pinpoint/commands/UpdateRecommenderConfigurationCommand.ts index bb46dea5d73cd..99a650a05f4e8 100644 --- a/clients/client-pinpoint/commands/UpdateRecommenderConfigurationCommand.ts +++ b/clients/client-pinpoint/commands/UpdateRecommenderConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRecommenderConfigurationCommandInput = UpdateRecommenderConfigurationRequest; export type UpdateRecommenderConfigurationCommandOutput = UpdateRecommenderConfigurationResponse & __MetadataBearer; +/** + *

Updates an Amazon Pinpoint configuration for a recommender model.

+ */ export class UpdateRecommenderConfigurationCommand extends $Command< UpdateRecommenderConfigurationCommandInput, UpdateRecommenderConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRecommenderConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateSegmentCommand.ts b/clients/client-pinpoint/commands/UpdateSegmentCommand.ts index f9c69dae4e7f0..0907dd6dc081f 100644 --- a/clients/client-pinpoint/commands/UpdateSegmentCommand.ts +++ b/clients/client-pinpoint/commands/UpdateSegmentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSegmentCommandInput = UpdateSegmentRequest; export type UpdateSegmentCommandOutput = UpdateSegmentResponse & __MetadataBearer; +/** + *

Creates a new segment for an application or updates the configuration, dimension, and other settings for an existing segment that's associated with an application.

+ */ export class UpdateSegmentCommand extends $Command< UpdateSegmentCommandInput, UpdateSegmentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSegmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateSmsChannelCommand.ts b/clients/client-pinpoint/commands/UpdateSmsChannelCommand.ts index f2c8d2e42f4ca..146995ad5ae00 100644 --- a/clients/client-pinpoint/commands/UpdateSmsChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateSmsChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSmsChannelCommandInput = UpdateSmsChannelRequest; export type UpdateSmsChannelCommandOutput = UpdateSmsChannelResponse & __MetadataBearer; +/** + *

Enables the SMS channel for an application or updates the status and settings of the SMS channel for an application.

+ */ export class UpdateSmsChannelCommand extends $Command< UpdateSmsChannelCommandInput, UpdateSmsChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSmsChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateSmsTemplateCommand.ts b/clients/client-pinpoint/commands/UpdateSmsTemplateCommand.ts index 32d12d0007c12..1a49ee6c72e1a 100644 --- a/clients/client-pinpoint/commands/UpdateSmsTemplateCommand.ts +++ b/clients/client-pinpoint/commands/UpdateSmsTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSmsTemplateCommandInput = UpdateSmsTemplateRequest; export type UpdateSmsTemplateCommandOutput = UpdateSmsTemplateResponse & __MetadataBearer; +/** + *

Updates an existing message template for messages that are sent through the SMS channel.

+ */ export class UpdateSmsTemplateCommand extends $Command< UpdateSmsTemplateCommandInput, UpdateSmsTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSmsTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateTemplateActiveVersionCommand.ts b/clients/client-pinpoint/commands/UpdateTemplateActiveVersionCommand.ts index 5b83f6a6b6239..a800a5a4af68e 100644 --- a/clients/client-pinpoint/commands/UpdateTemplateActiveVersionCommand.ts +++ b/clients/client-pinpoint/commands/UpdateTemplateActiveVersionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTemplateActiveVersionCommandInput = UpdateTemplateActiveVersionRequest; export type UpdateTemplateActiveVersionCommandOutput = UpdateTemplateActiveVersionResponse & __MetadataBearer; +/** + *

Changes the status of a specific version of a message template to active.

+ */ export class UpdateTemplateActiveVersionCommand extends $Command< UpdateTemplateActiveVersionCommandInput, UpdateTemplateActiveVersionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTemplateActiveVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateVoiceChannelCommand.ts b/clients/client-pinpoint/commands/UpdateVoiceChannelCommand.ts index 8c0a6ee2707ff..c94646236cb7d 100644 --- a/clients/client-pinpoint/commands/UpdateVoiceChannelCommand.ts +++ b/clients/client-pinpoint/commands/UpdateVoiceChannelCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVoiceChannelCommandInput = UpdateVoiceChannelRequest; export type UpdateVoiceChannelCommandOutput = UpdateVoiceChannelResponse & __MetadataBearer; +/** + *

Enables the voice channel for an application or updates the status and settings of the voice channel for an application.

+ */ export class UpdateVoiceChannelCommand extends $Command< UpdateVoiceChannelCommandInput, UpdateVoiceChannelCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVoiceChannelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/commands/UpdateVoiceTemplateCommand.ts b/clients/client-pinpoint/commands/UpdateVoiceTemplateCommand.ts index b3c2c23a3173c..d2a495e260ac4 100644 --- a/clients/client-pinpoint/commands/UpdateVoiceTemplateCommand.ts +++ b/clients/client-pinpoint/commands/UpdateVoiceTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVoiceTemplateCommandInput = UpdateVoiceTemplateRequest; export type UpdateVoiceTemplateCommandOutput = UpdateVoiceTemplateResponse & __MetadataBearer; +/** + *

Updates an existing message template for messages that are sent through the voice channel.

+ */ export class UpdateVoiceTemplateCommand extends $Command< UpdateVoiceTemplateCommandInput, UpdateVoiceTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVoiceTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PinpointClientResolvedConfig, diff --git a/clients/client-pinpoint/package.json b/clients/client-pinpoint/package.json index b1c6f5ba35a52..24ec3a0f7acd2 100644 --- a/clients/client-pinpoint/package.json +++ b/clients/client-pinpoint/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Pinpoint Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-pinpoint/runtimeConfig.browser.ts b/clients/client-pinpoint/runtimeConfig.browser.ts index 7cf2eb6e8beea..05efcd6b80a4d 100644 --- a/clients/client-pinpoint/runtimeConfig.browser.ts +++ b/clients/client-pinpoint/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PinpointClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-pinpoint/runtimeConfig.native.ts b/clients/client-pinpoint/runtimeConfig.native.ts index ba38c1277c0c6..023c17306d023 100644 --- a/clients/client-pinpoint/runtimeConfig.native.ts +++ b/clients/client-pinpoint/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PinpointClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-pinpoint/runtimeConfig.shared.ts b/clients/client-pinpoint/runtimeConfig.shared.ts index d5fe5db8d41e1..849332a270393 100644 --- a/clients/client-pinpoint/runtimeConfig.shared.ts +++ b/clients/client-pinpoint/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-12-01", disableHostPrefix: false, diff --git a/clients/client-pinpoint/runtimeConfig.ts b/clients/client-pinpoint/runtimeConfig.ts index f0df8677f68ed..3163da034d73f 100644 --- a/clients/client-pinpoint/runtimeConfig.ts +++ b/clients/client-pinpoint/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PinpointClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-pinpoint/tsconfig.json b/clients/client-pinpoint/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-pinpoint/tsconfig.json +++ b/clients/client-pinpoint/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-polly/commands/DeleteLexiconCommand.ts b/clients/client-polly/commands/DeleteLexiconCommand.ts index 51bb46828ba83..65bb6c35ccf06 100644 --- a/clients/client-polly/commands/DeleteLexiconCommand.ts +++ b/clients/client-polly/commands/DeleteLexiconCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteLexiconCommandInput = DeleteLexiconInput; export type DeleteLexiconCommandOutput = DeleteLexiconOutput & __MetadataBearer; +/** + *

Deletes the specified pronunciation lexicon stored in an AWS Region. A lexicon which + * has been deleted is not available for speech synthesis, nor is it possible to retrieve it + * using either the GetLexicon or ListLexicon APIs.

+ *

For more information, see Managing + * Lexicons.

+ */ export class DeleteLexiconCommand extends $Command< DeleteLexiconCommandInput, DeleteLexiconCommandOutput, @@ -34,6 +41,9 @@ export class DeleteLexiconCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/commands/DescribeVoicesCommand.ts b/clients/client-polly/commands/DescribeVoicesCommand.ts index 8ccf0332a15da..09e6ce9ae100c 100644 --- a/clients/client-polly/commands/DescribeVoicesCommand.ts +++ b/clients/client-polly/commands/DescribeVoicesCommand.ts @@ -20,6 +20,25 @@ import { export type DescribeVoicesCommandInput = DescribeVoicesInput; export type DescribeVoicesCommandOutput = DescribeVoicesOutput & __MetadataBearer; +/** + *

Returns the list of voices that are available for use when requesting speech synthesis. + * Each voice speaks a specified language, is either male or female, and is identified by an ID, + * which is the ASCII version of the voice name.

+ * + *

When synthesizing speech ( SynthesizeSpeech ), you provide the voice ID + * for the voice you want from the list of voices returned by + * DescribeVoices.

+ * + *

For example, you want your news reader application to read news in a specific language, + * but giving a user the option to choose the voice. Using the DescribeVoices + * operation you can provide the user with a list of available voices to select from.

+ * + *

You can optionally specify a language code to filter the available voices. For + * example, if you specify en-US, the operation returns a list of all available US + * English voices.

+ *

This operation requires permissions to perform the polly:DescribeVoices + * action.

+ */ export class DescribeVoicesCommand extends $Command< DescribeVoicesCommandInput, DescribeVoicesCommandOutput, @@ -34,6 +53,9 @@ export class DescribeVoicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/commands/GetLexiconCommand.ts b/clients/client-polly/commands/GetLexiconCommand.ts index a104bc51988bd..47aa762e46718 100644 --- a/clients/client-polly/commands/GetLexiconCommand.ts +++ b/clients/client-polly/commands/GetLexiconCommand.ts @@ -20,6 +20,11 @@ import { export type GetLexiconCommandInput = GetLexiconInput; export type GetLexiconCommandOutput = GetLexiconOutput & __MetadataBearer; +/** + *

Returns the content of the specified pronunciation lexicon stored in an AWS Region. For + * more information, see Managing + * Lexicons.

+ */ export class GetLexiconCommand extends $Command< GetLexiconCommandInput, GetLexiconCommandOutput, @@ -34,6 +39,9 @@ export class GetLexiconCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/commands/GetSpeechSynthesisTaskCommand.ts b/clients/client-polly/commands/GetSpeechSynthesisTaskCommand.ts index da588a1bfe255..0c5e1665708e6 100644 --- a/clients/client-polly/commands/GetSpeechSynthesisTaskCommand.ts +++ b/clients/client-polly/commands/GetSpeechSynthesisTaskCommand.ts @@ -20,6 +20,11 @@ import { export type GetSpeechSynthesisTaskCommandInput = GetSpeechSynthesisTaskInput; export type GetSpeechSynthesisTaskCommandOutput = GetSpeechSynthesisTaskOutput & __MetadataBearer; +/** + *

Retrieves a specific SpeechSynthesisTask object based on its TaskID. This object contains + * information about the given speech synthesis task, including the status of the task, and a + * link to the S3 bucket containing the output of the task.

+ */ export class GetSpeechSynthesisTaskCommand extends $Command< GetSpeechSynthesisTaskCommandInput, GetSpeechSynthesisTaskCommandOutput, @@ -34,6 +39,9 @@ export class GetSpeechSynthesisTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/commands/ListLexiconsCommand.ts b/clients/client-polly/commands/ListLexiconsCommand.ts index 5062cf971d0c5..28926ab406a42 100644 --- a/clients/client-polly/commands/ListLexiconsCommand.ts +++ b/clients/client-polly/commands/ListLexiconsCommand.ts @@ -20,6 +20,11 @@ import { export type ListLexiconsCommandInput = ListLexiconsInput; export type ListLexiconsCommandOutput = ListLexiconsOutput & __MetadataBearer; +/** + *

Returns a list of pronunciation lexicons stored in an AWS Region. For more information, + * see Managing + * Lexicons.

+ */ export class ListLexiconsCommand extends $Command< ListLexiconsCommandInput, ListLexiconsCommandOutput, @@ -34,6 +39,9 @@ export class ListLexiconsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/commands/ListSpeechSynthesisTasksCommand.ts b/clients/client-polly/commands/ListSpeechSynthesisTasksCommand.ts index ff3fb2e42c58a..e023fc04f8f42 100644 --- a/clients/client-polly/commands/ListSpeechSynthesisTasksCommand.ts +++ b/clients/client-polly/commands/ListSpeechSynthesisTasksCommand.ts @@ -20,6 +20,11 @@ import { export type ListSpeechSynthesisTasksCommandInput = ListSpeechSynthesisTasksInput; export type ListSpeechSynthesisTasksCommandOutput = ListSpeechSynthesisTasksOutput & __MetadataBearer; +/** + *

Returns a list of SpeechSynthesisTask objects ordered by their creation date. This + * operation can filter the tasks by their status, for example, allowing users to list only tasks + * that are completed.

+ */ export class ListSpeechSynthesisTasksCommand extends $Command< ListSpeechSynthesisTasksCommandInput, ListSpeechSynthesisTasksCommandOutput, @@ -34,6 +39,9 @@ export class ListSpeechSynthesisTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/commands/PutLexiconCommand.ts b/clients/client-polly/commands/PutLexiconCommand.ts index c7905bed4240a..3ed2d295d77b3 100644 --- a/clients/client-polly/commands/PutLexiconCommand.ts +++ b/clients/client-polly/commands/PutLexiconCommand.ts @@ -20,6 +20,14 @@ import { export type PutLexiconCommandInput = PutLexiconInput; export type PutLexiconCommandOutput = PutLexiconOutput & __MetadataBearer; +/** + *

Stores a pronunciation lexicon in an AWS Region. If a lexicon with the same name + * already exists in the region, it is overwritten by the new lexicon. Lexicon operations have + * eventual consistency, therefore, it might take some time before the lexicon is available to + * the SynthesizeSpeech operation.

+ *

For more information, see Managing + * Lexicons.

+ */ export class PutLexiconCommand extends $Command< PutLexiconCommandInput, PutLexiconCommandOutput, @@ -34,6 +42,9 @@ export class PutLexiconCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/commands/StartSpeechSynthesisTaskCommand.ts b/clients/client-polly/commands/StartSpeechSynthesisTaskCommand.ts index 6a99ac75db6ee..db6a465810250 100644 --- a/clients/client-polly/commands/StartSpeechSynthesisTaskCommand.ts +++ b/clients/client-polly/commands/StartSpeechSynthesisTaskCommand.ts @@ -20,6 +20,14 @@ import { export type StartSpeechSynthesisTaskCommandInput = StartSpeechSynthesisTaskInput; export type StartSpeechSynthesisTaskCommandOutput = StartSpeechSynthesisTaskOutput & __MetadataBearer; +/** + *

Allows the creation of an asynchronous synthesis task, by starting a new + * SpeechSynthesisTask. This operation requires all the standard information + * needed for speech synthesis, plus the name of an Amazon S3 bucket for the service to store the + * output of the synthesis task and two optional parameters (OutputS3KeyPrefix and SnsTopicArn). + * Once the synthesis task is created, this operation will return a SpeechSynthesisTask object, + * which will include an identifier of this task as well as the current status.

+ */ export class StartSpeechSynthesisTaskCommand extends $Command< StartSpeechSynthesisTaskCommandInput, StartSpeechSynthesisTaskCommandOutput, @@ -34,6 +42,9 @@ export class StartSpeechSynthesisTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/commands/SynthesizeSpeechCommand.ts b/clients/client-polly/commands/SynthesizeSpeechCommand.ts index 6b85905ff8425..27b07153cae75 100644 --- a/clients/client-polly/commands/SynthesizeSpeechCommand.ts +++ b/clients/client-polly/commands/SynthesizeSpeechCommand.ts @@ -20,6 +20,13 @@ import { export type SynthesizeSpeechCommandInput = SynthesizeSpeechInput; export type SynthesizeSpeechCommandOutput = SynthesizeSpeechOutput & __MetadataBearer; +/** + *

Synthesizes UTF-8 input, plain text or SSML, to a stream of bytes. SSML input must be + * valid, well-formed SSML. Some alphabets might not be available with all the voices (for + * example, Cyrillic might not be read at all by English voices) unless phoneme mapping is used. + * For more information, see How it + * Works.

+ */ export class SynthesizeSpeechCommand extends $Command< SynthesizeSpeechCommandInput, SynthesizeSpeechCommandOutput, @@ -34,6 +41,9 @@ export class SynthesizeSpeechCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PollyClientResolvedConfig, diff --git a/clients/client-polly/package.json b/clients/client-polly/package.json index 47e01ee3f5095..46b1d40f4e853 100644 --- a/clients/client-polly/package.json +++ b/clients/client-polly/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Polly Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-polly/pagination/ListSpeechSynthesisTasksPaginator.ts b/clients/client-polly/pagination/ListSpeechSynthesisTasksPaginator.ts index 2c7c7d086ecfe..9fd682ae00152 100644 --- a/clients/client-polly/pagination/ListSpeechSynthesisTasksPaginator.ts +++ b/clients/client-polly/pagination/ListSpeechSynthesisTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { PollyPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PollyClient, input: ListSpeechSynthesisTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSpeechSynthesisTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Polly, input: ListSpeechSynthesisTasksCommandInput, diff --git a/clients/client-polly/runtimeConfig.browser.ts b/clients/client-polly/runtimeConfig.browser.ts index dd044c6588450..0e00aef263d6f 100644 --- a/clients/client-polly/runtimeConfig.browser.ts +++ b/clients/client-polly/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PollyClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-polly/runtimeConfig.native.ts b/clients/client-polly/runtimeConfig.native.ts index 1cc6444e7035e..d4c46a6faab60 100644 --- a/clients/client-polly/runtimeConfig.native.ts +++ b/clients/client-polly/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PollyClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-polly/runtimeConfig.shared.ts b/clients/client-polly/runtimeConfig.shared.ts index fdd50623a35ae..3f25a8c85bbc4 100644 --- a/clients/client-polly/runtimeConfig.shared.ts +++ b/clients/client-polly/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-06-10", disableHostPrefix: false, diff --git a/clients/client-polly/runtimeConfig.ts b/clients/client-polly/runtimeConfig.ts index 1b4d474172c22..ee8ac98008364 100644 --- a/clients/client-polly/runtimeConfig.ts +++ b/clients/client-polly/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PollyClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-polly/tsconfig.json b/clients/client-polly/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-polly/tsconfig.json +++ b/clients/client-polly/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-pricing/commands/DescribeServicesCommand.ts b/clients/client-pricing/commands/DescribeServicesCommand.ts index 150e050e603ec..9c8ae2d6d326b 100644 --- a/clients/client-pricing/commands/DescribeServicesCommand.ts +++ b/clients/client-pricing/commands/DescribeServicesCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeServicesCommandInput = DescribeServicesRequest; export type DescribeServicesCommandOutput = DescribeServicesResponse & __MetadataBearer; +/** + *

Returns the metadata for one service or a list of the metadata for all services. Use + * this without a service code to get the service codes for all services. + * Use it with a service code, such as AmazonEC2, to get information specific to + * that service, such as the attribute + * names available for that service. For example, some of the attribute names available for EC2 are + * volumeType, maxIopsVolume, operation, + * locationType, and instanceCapacity10xlarge.

+ */ export class DescribeServicesCommand extends $Command< DescribeServicesCommandInput, DescribeServicesCommandOutput, @@ -34,6 +43,9 @@ export class DescribeServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PricingClientResolvedConfig, diff --git a/clients/client-pricing/commands/GetAttributeValuesCommand.ts b/clients/client-pricing/commands/GetAttributeValuesCommand.ts index 4dbefdaf4a8fc..c0c465f5d2f25 100644 --- a/clients/client-pricing/commands/GetAttributeValuesCommand.ts +++ b/clients/client-pricing/commands/GetAttributeValuesCommand.ts @@ -20,6 +20,12 @@ import { export type GetAttributeValuesCommandInput = GetAttributeValuesRequest; export type GetAttributeValuesCommandOutput = GetAttributeValuesResponse & __MetadataBearer; +/** + *

Returns a list of attribute values. Attibutes are similar to the details + * in a Price List API offer file. For a list of available attributes, see + * Offer File Definitions + * in the AWS Billing and Cost Management User Guide.

+ */ export class GetAttributeValuesCommand extends $Command< GetAttributeValuesCommandInput, GetAttributeValuesCommandOutput, @@ -34,6 +40,9 @@ export class GetAttributeValuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PricingClientResolvedConfig, diff --git a/clients/client-pricing/commands/GetProductsCommand.ts b/clients/client-pricing/commands/GetProductsCommand.ts index d829a74d774b1..868ec86fdd632 100644 --- a/clients/client-pricing/commands/GetProductsCommand.ts +++ b/clients/client-pricing/commands/GetProductsCommand.ts @@ -20,6 +20,9 @@ import { export type GetProductsCommandInput = GetProductsRequest; export type GetProductsCommandOutput = GetProductsResponse & __MetadataBearer; +/** + *

Returns a list of all products that match the filter criteria.

+ */ export class GetProductsCommand extends $Command< GetProductsCommandInput, GetProductsCommandOutput, @@ -34,6 +37,9 @@ export class GetProductsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: PricingClientResolvedConfig, diff --git a/clients/client-pricing/package.json b/clients/client-pricing/package.json index 5874d967de221..6956a15e3eec4 100644 --- a/clients/client-pricing/package.json +++ b/clients/client-pricing/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Pricing Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-pricing/pagination/DescribeServicesPaginator.ts b/clients/client-pricing/pagination/DescribeServicesPaginator.ts index 1b221269574a9..c36f04d9d5446 100644 --- a/clients/client-pricing/pagination/DescribeServicesPaginator.ts +++ b/clients/client-pricing/pagination/DescribeServicesPaginator.ts @@ -8,6 +8,9 @@ import { import { PricingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PricingClient, input: DescribeServicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeServicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Pricing, input: DescribeServicesCommandInput, diff --git a/clients/client-pricing/pagination/GetAttributeValuesPaginator.ts b/clients/client-pricing/pagination/GetAttributeValuesPaginator.ts index 9a749a801688d..2372a9c2433b9 100644 --- a/clients/client-pricing/pagination/GetAttributeValuesPaginator.ts +++ b/clients/client-pricing/pagination/GetAttributeValuesPaginator.ts @@ -8,6 +8,9 @@ import { import { PricingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PricingClient, input: GetAttributeValuesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetAttributeValuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Pricing, input: GetAttributeValuesCommandInput, diff --git a/clients/client-pricing/pagination/GetProductsPaginator.ts b/clients/client-pricing/pagination/GetProductsPaginator.ts index af5e8b85dae80..30f8b03263908 100644 --- a/clients/client-pricing/pagination/GetProductsPaginator.ts +++ b/clients/client-pricing/pagination/GetProductsPaginator.ts @@ -4,6 +4,9 @@ import { GetProductsCommand, GetProductsCommandInput, GetProductsCommandOutput } import { PricingPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: PricingClient, input: GetProductsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetProductsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Pricing, input: GetProductsCommandInput, diff --git a/clients/client-pricing/runtimeConfig.browser.ts b/clients/client-pricing/runtimeConfig.browser.ts index ae607cdf79b5e..a7f73cfb0ad3d 100644 --- a/clients/client-pricing/runtimeConfig.browser.ts +++ b/clients/client-pricing/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./PricingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-pricing/runtimeConfig.native.ts b/clients/client-pricing/runtimeConfig.native.ts index 0b6fe82563ea6..b503eccafd0f8 100644 --- a/clients/client-pricing/runtimeConfig.native.ts +++ b/clients/client-pricing/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./PricingClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-pricing/runtimeConfig.shared.ts b/clients/client-pricing/runtimeConfig.shared.ts index 4368c6a702db4..cb821399ad8c2 100644 --- a/clients/client-pricing/runtimeConfig.shared.ts +++ b/clients/client-pricing/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-15", disableHostPrefix: false, diff --git a/clients/client-pricing/runtimeConfig.ts b/clients/client-pricing/runtimeConfig.ts index fac0cdf4ca4cf..a4ee6b5f39256 100644 --- a/clients/client-pricing/runtimeConfig.ts +++ b/clients/client-pricing/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./PricingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-pricing/tsconfig.json b/clients/client-pricing/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-pricing/tsconfig.json +++ b/clients/client-pricing/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-qldb-session/commands/SendCommandCommand.ts b/clients/client-qldb-session/commands/SendCommandCommand.ts index 676674743c781..07ad633b19fca 100644 --- a/clients/client-qldb-session/commands/SendCommandCommand.ts +++ b/clients/client-qldb-session/commands/SendCommandCommand.ts @@ -20,6 +20,29 @@ import { export type SendCommandCommandInput = SendCommandRequest; export type SendCommandCommandOutput = SendCommandResult & __MetadataBearer; +/** + *

Sends a command to an Amazon QLDB ledger.

+ * + *

Instead of interacting directly with this API, we recommend that you use the + * Amazon QLDB Driver or the QLDB Shell to execute data transactions on a ledger.

+ *
    + *
  • + *

    If you are working with an AWS SDK, use the QLDB Driver. The driver provides + * a high-level abstraction layer above this qldbsession data plane and + * manages SendCommand API calls for you. For information and a list of + * supported programming languages, see Getting started + * with the driver in the Amazon QLDB Developer + * Guide.

    + *
  • + *
  • + *

    If you are working with the AWS Command Line Interface (AWS CLI), use the + * QLDB Shell. The shell is a command line interface that uses the QLDB Driver to + * interact with a ledger. For information, see Accessing Amazon QLDB using the + * QLDB Shell.

    + *
  • + *
+ *
+ */ export class SendCommandCommand extends $Command< SendCommandCommandInput, SendCommandCommandOutput, @@ -34,6 +57,9 @@ export class SendCommandCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBSessionClientResolvedConfig, diff --git a/clients/client-qldb-session/package.json b/clients/client-qldb-session/package.json index e9cdb8f46b948..baa7c01a019c9 100644 --- a/clients/client-qldb-session/package.json +++ b/clients/client-qldb-session/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Qldb Session Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-qldb-session/runtimeConfig.browser.ts b/clients/client-qldb-session/runtimeConfig.browser.ts index f3173b4fb4202..c844c968aebc8 100644 --- a/clients/client-qldb-session/runtimeConfig.browser.ts +++ b/clients/client-qldb-session/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./QLDBSessionClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-qldb-session/runtimeConfig.native.ts b/clients/client-qldb-session/runtimeConfig.native.ts index 3dc3286f057cf..57fef29777303 100644 --- a/clients/client-qldb-session/runtimeConfig.native.ts +++ b/clients/client-qldb-session/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./QLDBSessionClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-qldb-session/runtimeConfig.shared.ts b/clients/client-qldb-session/runtimeConfig.shared.ts index 7bc5e69e3eb7a..e762f5e551b38 100644 --- a/clients/client-qldb-session/runtimeConfig.shared.ts +++ b/clients/client-qldb-session/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-07-11", disableHostPrefix: false, diff --git a/clients/client-qldb-session/runtimeConfig.ts b/clients/client-qldb-session/runtimeConfig.ts index 5194d6d9b37b1..34d88d8c6aae9 100644 --- a/clients/client-qldb-session/runtimeConfig.ts +++ b/clients/client-qldb-session/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./QLDBSessionClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-qldb-session/tsconfig.json b/clients/client-qldb-session/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-qldb-session/tsconfig.json +++ b/clients/client-qldb-session/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-qldb/commands/CancelJournalKinesisStreamCommand.ts b/clients/client-qldb/commands/CancelJournalKinesisStreamCommand.ts index aa1a3c7afb23d..52661e72d32ae 100644 --- a/clients/client-qldb/commands/CancelJournalKinesisStreamCommand.ts +++ b/clients/client-qldb/commands/CancelJournalKinesisStreamCommand.ts @@ -20,6 +20,13 @@ import { export type CancelJournalKinesisStreamCommandInput = CancelJournalKinesisStreamRequest; export type CancelJournalKinesisStreamCommandOutput = CancelJournalKinesisStreamResponse & __MetadataBearer; +/** + *

Ends a given Amazon QLDB journal stream. Before a stream can be canceled, its current + * status must be ACTIVE.

+ *

You can't restart a stream after you cancel it. Canceled QLDB stream resources are + * subject to a 7-day retention period, so they are automatically deleted after this limit + * expires.

+ */ export class CancelJournalKinesisStreamCommand extends $Command< CancelJournalKinesisStreamCommandInput, CancelJournalKinesisStreamCommandOutput, @@ -34,6 +41,9 @@ export class CancelJournalKinesisStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/CreateLedgerCommand.ts b/clients/client-qldb/commands/CreateLedgerCommand.ts index b0bb48cb451a8..e30f183e5e9ac 100644 --- a/clients/client-qldb/commands/CreateLedgerCommand.ts +++ b/clients/client-qldb/commands/CreateLedgerCommand.ts @@ -20,6 +20,9 @@ import { export type CreateLedgerCommandInput = CreateLedgerRequest; export type CreateLedgerCommandOutput = CreateLedgerResponse & __MetadataBearer; +/** + *

Creates a new ledger in your AWS account.

+ */ export class CreateLedgerCommand extends $Command< CreateLedgerCommandInput, CreateLedgerCommandOutput, @@ -34,6 +37,9 @@ export class CreateLedgerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/DeleteLedgerCommand.ts b/clients/client-qldb/commands/DeleteLedgerCommand.ts index 9e677023cbd91..9ff6ab7b07d63 100644 --- a/clients/client-qldb/commands/DeleteLedgerCommand.ts +++ b/clients/client-qldb/commands/DeleteLedgerCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteLedgerCommandInput = DeleteLedgerRequest; export type DeleteLedgerCommandOutput = __MetadataBearer; +/** + *

Deletes a ledger and all of its contents. This action is irreversible.

+ *

If deletion protection is enabled, you must first disable it before you can delete the + * ledger using the QLDB API or the AWS Command Line Interface (AWS CLI). You can disable it by calling the + * UpdateLedger operation to set the flag to false. The QLDB + * console disables deletion protection for you when you use it to delete a ledger.

+ */ export class DeleteLedgerCommand extends $Command< DeleteLedgerCommandInput, DeleteLedgerCommandOutput, @@ -34,6 +41,9 @@ export class DeleteLedgerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/DescribeJournalKinesisStreamCommand.ts b/clients/client-qldb/commands/DescribeJournalKinesisStreamCommand.ts index e1324ae6a174a..359260e6b60c0 100644 --- a/clients/client-qldb/commands/DescribeJournalKinesisStreamCommand.ts +++ b/clients/client-qldb/commands/DescribeJournalKinesisStreamCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeJournalKinesisStreamCommandInput = DescribeJournalKinesisStreamRequest; export type DescribeJournalKinesisStreamCommandOutput = DescribeJournalKinesisStreamResponse & __MetadataBearer; +/** + *

Returns detailed information about a given Amazon QLDB journal stream. The output + * includes the Amazon Resource Name (ARN), stream name, current status, creation time, and + * the parameters of your original stream creation request.

+ */ export class DescribeJournalKinesisStreamCommand extends $Command< DescribeJournalKinesisStreamCommandInput, DescribeJournalKinesisStreamCommandOutput, @@ -34,6 +39,9 @@ export class DescribeJournalKinesisStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/DescribeJournalS3ExportCommand.ts b/clients/client-qldb/commands/DescribeJournalS3ExportCommand.ts index 0bb1a231df1be..35853027b867d 100644 --- a/clients/client-qldb/commands/DescribeJournalS3ExportCommand.ts +++ b/clients/client-qldb/commands/DescribeJournalS3ExportCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeJournalS3ExportCommandInput = DescribeJournalS3ExportRequest; export type DescribeJournalS3ExportCommandOutput = DescribeJournalS3ExportResponse & __MetadataBearer; +/** + *

Returns information about a journal export job, including the ledger name, export ID, + * when it was created, current status, and its start and end time export parameters.

+ *

This action does not return any expired export jobs. For more information, see Export Job Expiration in the Amazon QLDB Developer + * Guide.

+ *

If the export job with the given ExportId doesn't exist, then throws + * ResourceNotFoundException.

+ *

If the ledger with the given Name doesn't exist, then throws + * ResourceNotFoundException.

+ */ export class DescribeJournalS3ExportCommand extends $Command< DescribeJournalS3ExportCommandInput, DescribeJournalS3ExportCommandOutput, @@ -34,6 +44,9 @@ export class DescribeJournalS3ExportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/DescribeLedgerCommand.ts b/clients/client-qldb/commands/DescribeLedgerCommand.ts index 8a2c0b22f749e..62e2b3650fdae 100644 --- a/clients/client-qldb/commands/DescribeLedgerCommand.ts +++ b/clients/client-qldb/commands/DescribeLedgerCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLedgerCommandInput = DescribeLedgerRequest; export type DescribeLedgerCommandOutput = DescribeLedgerResponse & __MetadataBearer; +/** + *

Returns information about a ledger, including its state and when it was created.

+ */ export class DescribeLedgerCommand extends $Command< DescribeLedgerCommandInput, DescribeLedgerCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLedgerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/ExportJournalToS3Command.ts b/clients/client-qldb/commands/ExportJournalToS3Command.ts index 19108bdec923b..4526241b78887 100644 --- a/clients/client-qldb/commands/ExportJournalToS3Command.ts +++ b/clients/client-qldb/commands/ExportJournalToS3Command.ts @@ -20,6 +20,16 @@ import { export type ExportJournalToS3CommandInput = ExportJournalToS3Request; export type ExportJournalToS3CommandOutput = ExportJournalToS3Response & __MetadataBearer; +/** + *

Exports journal contents within a date and time range from a ledger into a specified + * Amazon Simple Storage Service (Amazon S3) bucket. The data is written as files in Amazon Ion format.

+ *

If the ledger with the given Name doesn't exist, then throws + * ResourceNotFoundException.

+ *

If the ledger with the given Name is in CREATING status, then + * throws ResourcePreconditionNotMetException.

+ *

You can initiate up to two concurrent journal export requests for each ledger. Beyond + * this limit, journal export requests throw LimitExceededException.

+ */ export class ExportJournalToS3Command extends $Command< ExportJournalToS3CommandInput, ExportJournalToS3CommandOutput, @@ -34,6 +44,9 @@ export class ExportJournalToS3Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/GetBlockCommand.ts b/clients/client-qldb/commands/GetBlockCommand.ts index 680e297298ce0..7d3994c4fcaf9 100644 --- a/clients/client-qldb/commands/GetBlockCommand.ts +++ b/clients/client-qldb/commands/GetBlockCommand.ts @@ -20,6 +20,18 @@ import { export type GetBlockCommandInput = GetBlockRequest; export type GetBlockCommandOutput = GetBlockResponse & __MetadataBearer; +/** + *

Returns a block object at a specified address in a journal. Also returns a proof of the + * specified block for verification if DigestTipAddress is provided.

+ *

For information about the data contents in a block, see Journal contents in the + * Amazon QLDB Developer Guide.

+ *

If the specified ledger doesn't exist or is in DELETING status, then throws + * ResourceNotFoundException.

+ *

If the specified ledger is in CREATING status, then throws + * ResourcePreconditionNotMetException.

+ *

If no block exists with the specified address, then throws + * InvalidParameterException.

+ */ export class GetBlockCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +42,9 @@ export class GetBlockCommand extends $Command, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/GetDigestCommand.ts b/clients/client-qldb/commands/GetDigestCommand.ts index 56f6ea5c5153d..8ec06b688a0c5 100644 --- a/clients/client-qldb/commands/GetDigestCommand.ts +++ b/clients/client-qldb/commands/GetDigestCommand.ts @@ -20,6 +20,10 @@ import { export type GetDigestCommandInput = GetDigestRequest; export type GetDigestCommandOutput = GetDigestResponse & __MetadataBearer; +/** + *

Returns the digest of a ledger at the latest committed block in the journal. The + * response includes a 256-bit hash value and a block address.

+ */ export class GetDigestCommand extends $Command< GetDigestCommandInput, GetDigestCommandOutput, @@ -34,6 +38,9 @@ export class GetDigestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/GetRevisionCommand.ts b/clients/client-qldb/commands/GetRevisionCommand.ts index 55f5006de88e5..7b7006f542a68 100644 --- a/clients/client-qldb/commands/GetRevisionCommand.ts +++ b/clients/client-qldb/commands/GetRevisionCommand.ts @@ -20,6 +20,11 @@ import { export type GetRevisionCommandInput = GetRevisionRequest; export type GetRevisionCommandOutput = GetRevisionResponse & __MetadataBearer; +/** + *

Returns a revision data object for a specified document ID and block address. Also + * returns a proof of the specified revision for verification if DigestTipAddress + * is provided.

+ */ export class GetRevisionCommand extends $Command< GetRevisionCommandInput, GetRevisionCommandOutput, @@ -34,6 +39,9 @@ export class GetRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/ListJournalKinesisStreamsForLedgerCommand.ts b/clients/client-qldb/commands/ListJournalKinesisStreamsForLedgerCommand.ts index 5634a773c7a21..cdf3d8eec9c0a 100644 --- a/clients/client-qldb/commands/ListJournalKinesisStreamsForLedgerCommand.ts +++ b/clients/client-qldb/commands/ListJournalKinesisStreamsForLedgerCommand.ts @@ -24,6 +24,14 @@ export type ListJournalKinesisStreamsForLedgerCommandInput = ListJournalKinesisS export type ListJournalKinesisStreamsForLedgerCommandOutput = ListJournalKinesisStreamsForLedgerResponse & __MetadataBearer; +/** + *

Returns an array of all Amazon QLDB journal stream descriptors for a given ledger. The + * output of each stream descriptor includes the same details that are returned by + * DescribeJournalKinesisStream.

+ *

This action returns a maximum of MaxResults items. It is paginated so that + * you can retrieve all the items by calling ListJournalKinesisStreamsForLedger + * multiple times.

+ */ export class ListJournalKinesisStreamsForLedgerCommand extends $Command< ListJournalKinesisStreamsForLedgerCommandInput, ListJournalKinesisStreamsForLedgerCommandOutput, @@ -38,6 +46,9 @@ export class ListJournalKinesisStreamsForLedgerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/ListJournalS3ExportsCommand.ts b/clients/client-qldb/commands/ListJournalS3ExportsCommand.ts index bd96639e01213..cfb41cd048842 100644 --- a/clients/client-qldb/commands/ListJournalS3ExportsCommand.ts +++ b/clients/client-qldb/commands/ListJournalS3ExportsCommand.ts @@ -20,6 +20,15 @@ import { export type ListJournalS3ExportsCommandInput = ListJournalS3ExportsRequest; export type ListJournalS3ExportsCommandOutput = ListJournalS3ExportsResponse & __MetadataBearer; +/** + *

Returns an array of journal export job descriptions for all ledgers that are associated + * with the current AWS account and Region.

+ *

This action returns a maximum of MaxResults items, and is paginated so that + * you can retrieve all the items by calling ListJournalS3Exports multiple + * times.

+ *

This action does not return any expired export jobs. For more information, see Export Job Expiration in the Amazon QLDB Developer + * Guide.

+ */ export class ListJournalS3ExportsCommand extends $Command< ListJournalS3ExportsCommandInput, ListJournalS3ExportsCommandOutput, @@ -34,6 +43,9 @@ export class ListJournalS3ExportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/ListJournalS3ExportsForLedgerCommand.ts b/clients/client-qldb/commands/ListJournalS3ExportsForLedgerCommand.ts index e92cc4b838bb0..07997aa6d1989 100644 --- a/clients/client-qldb/commands/ListJournalS3ExportsForLedgerCommand.ts +++ b/clients/client-qldb/commands/ListJournalS3ExportsForLedgerCommand.ts @@ -20,6 +20,14 @@ import { export type ListJournalS3ExportsForLedgerCommandInput = ListJournalS3ExportsForLedgerRequest; export type ListJournalS3ExportsForLedgerCommandOutput = ListJournalS3ExportsForLedgerResponse & __MetadataBearer; +/** + *

Returns an array of journal export job descriptions for a specified ledger.

+ *

This action returns a maximum of MaxResults items, and is paginated so that + * you can retrieve all the items by calling ListJournalS3ExportsForLedger + * multiple times.

+ *

This action does not return any expired export jobs. For more information, see Export Job Expiration in the Amazon QLDB Developer + * Guide.

+ */ export class ListJournalS3ExportsForLedgerCommand extends $Command< ListJournalS3ExportsForLedgerCommandInput, ListJournalS3ExportsForLedgerCommandOutput, @@ -34,6 +42,9 @@ export class ListJournalS3ExportsForLedgerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/ListLedgersCommand.ts b/clients/client-qldb/commands/ListLedgersCommand.ts index 9e7ec79e5b2b1..058d59eaeb89d 100644 --- a/clients/client-qldb/commands/ListLedgersCommand.ts +++ b/clients/client-qldb/commands/ListLedgersCommand.ts @@ -20,6 +20,12 @@ import { export type ListLedgersCommandInput = ListLedgersRequest; export type ListLedgersCommandOutput = ListLedgersResponse & __MetadataBearer; +/** + *

Returns an array of ledger summaries that are associated with the current AWS account + * and Region.

+ *

This action returns a maximum of 100 items and is paginated so that you can + * retrieve all the items by calling ListLedgers multiple times.

+ */ export class ListLedgersCommand extends $Command< ListLedgersCommandInput, ListLedgersCommandOutput, @@ -34,6 +40,9 @@ export class ListLedgersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/ListTagsForResourceCommand.ts b/clients/client-qldb/commands/ListTagsForResourceCommand.ts index 2a2f8568ff3e2..c34e0b9f8314f 100644 --- a/clients/client-qldb/commands/ListTagsForResourceCommand.ts +++ b/clients/client-qldb/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns all tags for a specified Amazon QLDB resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/StreamJournalToKinesisCommand.ts b/clients/client-qldb/commands/StreamJournalToKinesisCommand.ts index 7c711ceaef67f..1a21a65385798 100644 --- a/clients/client-qldb/commands/StreamJournalToKinesisCommand.ts +++ b/clients/client-qldb/commands/StreamJournalToKinesisCommand.ts @@ -20,6 +20,11 @@ import { export type StreamJournalToKinesisCommandInput = StreamJournalToKinesisRequest; export type StreamJournalToKinesisCommandOutput = StreamJournalToKinesisResponse & __MetadataBearer; +/** + *

Creates a journal stream for a given Amazon QLDB ledger. The stream captures every + * document revision that is committed to the ledger's journal and delivers the data to a + * specified Amazon Kinesis Data Streams resource.

+ */ export class StreamJournalToKinesisCommand extends $Command< StreamJournalToKinesisCommandInput, StreamJournalToKinesisCommandOutput, @@ -34,6 +39,9 @@ export class StreamJournalToKinesisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/TagResourceCommand.ts b/clients/client-qldb/commands/TagResourceCommand.ts index 42fc7f4bdf928..eb323c4b0db25 100644 --- a/clients/client-qldb/commands/TagResourceCommand.ts +++ b/clients/client-qldb/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds one or more tags to a specified Amazon QLDB resource.

+ *

A resource can have up to 50 tags. If you try to create more than 50 tags for a + * resource, your request fails and returns an error.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/UntagResourceCommand.ts b/clients/client-qldb/commands/UntagResourceCommand.ts index 595cd45d80910..795cceec8521a 100644 --- a/clients/client-qldb/commands/UntagResourceCommand.ts +++ b/clients/client-qldb/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from a specified Amazon QLDB resource. You can specify up to 50 + * tag keys to remove.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/commands/UpdateLedgerCommand.ts b/clients/client-qldb/commands/UpdateLedgerCommand.ts index 45c91504f9d7d..8b25dc59146ce 100644 --- a/clients/client-qldb/commands/UpdateLedgerCommand.ts +++ b/clients/client-qldb/commands/UpdateLedgerCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateLedgerCommandInput = UpdateLedgerRequest; export type UpdateLedgerCommandOutput = UpdateLedgerResponse & __MetadataBearer; +/** + *

Updates properties on a ledger.

+ */ export class UpdateLedgerCommand extends $Command< UpdateLedgerCommandInput, UpdateLedgerCommandOutput, @@ -34,6 +37,9 @@ export class UpdateLedgerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QLDBClientResolvedConfig, diff --git a/clients/client-qldb/package.json b/clients/client-qldb/package.json index ed21f0339904d..a5fb30ae13075 100644 --- a/clients/client-qldb/package.json +++ b/clients/client-qldb/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Qldb Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-qldb/pagination/ListJournalKinesisStreamsForLedgerPaginator.ts b/clients/client-qldb/pagination/ListJournalKinesisStreamsForLedgerPaginator.ts index b088f977db096..e9b74ef380035 100644 --- a/clients/client-qldb/pagination/ListJournalKinesisStreamsForLedgerPaginator.ts +++ b/clients/client-qldb/pagination/ListJournalKinesisStreamsForLedgerPaginator.ts @@ -8,6 +8,9 @@ import { import { QLDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QLDBClient, input: ListJournalKinesisStreamsForLedgerCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJournalKinesisStreamsForLedgerCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QLDB, input: ListJournalKinesisStreamsForLedgerCommandInput, diff --git a/clients/client-qldb/pagination/ListJournalS3ExportsForLedgerPaginator.ts b/clients/client-qldb/pagination/ListJournalS3ExportsForLedgerPaginator.ts index 57c549fbd0a29..eaca13589b07c 100644 --- a/clients/client-qldb/pagination/ListJournalS3ExportsForLedgerPaginator.ts +++ b/clients/client-qldb/pagination/ListJournalS3ExportsForLedgerPaginator.ts @@ -8,6 +8,9 @@ import { import { QLDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QLDBClient, input: ListJournalS3ExportsForLedgerCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJournalS3ExportsForLedgerCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QLDB, input: ListJournalS3ExportsForLedgerCommandInput, diff --git a/clients/client-qldb/pagination/ListJournalS3ExportsPaginator.ts b/clients/client-qldb/pagination/ListJournalS3ExportsPaginator.ts index f7f30ef0ad8dd..c20d6cfdafbeb 100644 --- a/clients/client-qldb/pagination/ListJournalS3ExportsPaginator.ts +++ b/clients/client-qldb/pagination/ListJournalS3ExportsPaginator.ts @@ -8,6 +8,9 @@ import { import { QLDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QLDBClient, input: ListJournalS3ExportsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJournalS3ExportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QLDB, input: ListJournalS3ExportsCommandInput, diff --git a/clients/client-qldb/pagination/ListLedgersPaginator.ts b/clients/client-qldb/pagination/ListLedgersPaginator.ts index c126eeed12228..6e9e1370004a4 100644 --- a/clients/client-qldb/pagination/ListLedgersPaginator.ts +++ b/clients/client-qldb/pagination/ListLedgersPaginator.ts @@ -4,6 +4,9 @@ import { ListLedgersCommand, ListLedgersCommandInput, ListLedgersCommandOutput } import { QLDBPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QLDBClient, input: ListLedgersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLedgersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QLDB, input: ListLedgersCommandInput, diff --git a/clients/client-qldb/runtimeConfig.browser.ts b/clients/client-qldb/runtimeConfig.browser.ts index 8d34be5c82ba5..5c93dcfe1bbec 100644 --- a/clients/client-qldb/runtimeConfig.browser.ts +++ b/clients/client-qldb/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./QLDBClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-qldb/runtimeConfig.native.ts b/clients/client-qldb/runtimeConfig.native.ts index 0ca3ca82d98d3..bd8912906853a 100644 --- a/clients/client-qldb/runtimeConfig.native.ts +++ b/clients/client-qldb/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./QLDBClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-qldb/runtimeConfig.shared.ts b/clients/client-qldb/runtimeConfig.shared.ts index 59999679bc607..6d94c9a8715d6 100644 --- a/clients/client-qldb/runtimeConfig.shared.ts +++ b/clients/client-qldb/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-01-02", disableHostPrefix: false, diff --git a/clients/client-qldb/runtimeConfig.ts b/clients/client-qldb/runtimeConfig.ts index 6eb637130487a..7a236f0e51cb6 100644 --- a/clients/client-qldb/runtimeConfig.ts +++ b/clients/client-qldb/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./QLDBClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-qldb/tsconfig.json b/clients/client-qldb/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-qldb/tsconfig.json +++ b/clients/client-qldb/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-quicksight/commands/CancelIngestionCommand.ts b/clients/client-quicksight/commands/CancelIngestionCommand.ts index baab908d6bc93..c3fef97a8c51b 100644 --- a/clients/client-quicksight/commands/CancelIngestionCommand.ts +++ b/clients/client-quicksight/commands/CancelIngestionCommand.ts @@ -20,6 +20,9 @@ import { export type CancelIngestionCommandInput = CancelIngestionRequest; export type CancelIngestionCommandOutput = CancelIngestionResponse & __MetadataBearer; +/** + *

Cancels an ongoing ingestion of data into SPICE.

+ */ export class CancelIngestionCommand extends $Command< CancelIngestionCommandInput, CancelIngestionCommandOutput, @@ -34,6 +37,9 @@ export class CancelIngestionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateAccountCustomizationCommand.ts b/clients/client-quicksight/commands/CreateAccountCustomizationCommand.ts index 52282dc2b4ed8..219e71974575e 100644 --- a/clients/client-quicksight/commands/CreateAccountCustomizationCommand.ts +++ b/clients/client-quicksight/commands/CreateAccountCustomizationCommand.ts @@ -20,6 +20,30 @@ import { export type CreateAccountCustomizationCommandInput = CreateAccountCustomizationRequest; export type CreateAccountCustomizationCommandOutput = CreateAccountCustomizationResponse & __MetadataBearer; +/** + *

Creates Amazon QuickSight customizations the current AWS Region. Currently, you can + * add a custom default theme by using the CreateAccountCustomization or + * UpdateAccountCustomization API operation. To further customize + * QuickSight by removing QuickSight sample assets and videos for all new users, see Customizing QuickSight in the Amazon QuickSight User + * Guide. + *

+ *

You can create customizations for your AWS account or, if you specify a namespace, for + * a QuickSight namespace instead. Customizations that apply to a namespace always override + * customizations that apply to an AWS account. To find out which customizations apply, use + * the DescribeAccountCustomization API operation.

+ *

Before you use the CreateAccountCustomization API operation to add a theme + * as the namespace default, make sure that you first share the theme with the namespace. + * If you don't share it with the namespace, the theme isn't visible to your users + * even if you make it the default theme. + * To check if the theme is shared, view the current permissions by using the + * + * DescribeThemePermissions + * API operation. + * To share the theme, grant permissions by using the + * + * UpdateThemePermissions + * API operation.

+ */ export class CreateAccountCustomizationCommand extends $Command< CreateAccountCustomizationCommandInput, CreateAccountCustomizationCommandOutput, @@ -34,6 +58,9 @@ export class CreateAccountCustomizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateAnalysisCommand.ts b/clients/client-quicksight/commands/CreateAnalysisCommand.ts index 39c2be06fb49f..9f0add803f9ef 100644 --- a/clients/client-quicksight/commands/CreateAnalysisCommand.ts +++ b/clients/client-quicksight/commands/CreateAnalysisCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAnalysisCommandInput = CreateAnalysisRequest; export type CreateAnalysisCommandOutput = CreateAnalysisResponse & __MetadataBearer; +/** + *

Creates an analysis in Amazon QuickSight.

+ */ export class CreateAnalysisCommand extends $Command< CreateAnalysisCommandInput, CreateAnalysisCommandOutput, @@ -34,6 +37,9 @@ export class CreateAnalysisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateDashboardCommand.ts b/clients/client-quicksight/commands/CreateDashboardCommand.ts index e4fb528f41962..dae09b42df877 100644 --- a/clients/client-quicksight/commands/CreateDashboardCommand.ts +++ b/clients/client-quicksight/commands/CreateDashboardCommand.ts @@ -20,6 +20,15 @@ import { export type CreateDashboardCommandInput = CreateDashboardRequest; export type CreateDashboardCommandOutput = CreateDashboardResponse & __MetadataBearer; +/** + *

Creates a dashboard from a template. To first create a template, see the + * CreateTemplate + * API operation.

+ *

A dashboard is an entity in QuickSight that identifies QuickSight reports, created + * from analyses. You can share QuickSight dashboards. With the right permissions, you can + * create scheduled email reports from them. If you have the correct permissions, you can + * create a dashboard from a template that exists in a different AWS account.

+ */ export class CreateDashboardCommand extends $Command< CreateDashboardCommandInput, CreateDashboardCommandOutput, @@ -34,6 +43,9 @@ export class CreateDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateDataSetCommand.ts b/clients/client-quicksight/commands/CreateDataSetCommand.ts index 944a84e095054..1ba3ede3be264 100644 --- a/clients/client-quicksight/commands/CreateDataSetCommand.ts +++ b/clients/client-quicksight/commands/CreateDataSetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDataSetCommandInput = CreateDataSetRequest; export type CreateDataSetCommandOutput = CreateDataSetResponse & __MetadataBearer; +/** + *

Creates a dataset.

+ */ export class CreateDataSetCommand extends $Command< CreateDataSetCommandInput, CreateDataSetCommandOutput, @@ -34,6 +37,9 @@ export class CreateDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateDataSourceCommand.ts b/clients/client-quicksight/commands/CreateDataSourceCommand.ts index 6980a5c0fdbfb..a26adb3482b8e 100644 --- a/clients/client-quicksight/commands/CreateDataSourceCommand.ts +++ b/clients/client-quicksight/commands/CreateDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDataSourceCommandInput = CreateDataSourceRequest; export type CreateDataSourceCommandOutput = CreateDataSourceResponse & __MetadataBearer; +/** + *

Creates a data source.

+ */ export class CreateDataSourceCommand extends $Command< CreateDataSourceCommandInput, CreateDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class CreateDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateGroupCommand.ts b/clients/client-quicksight/commands/CreateGroupCommand.ts index 391b998cc9ca0..a290a14633c41 100644 --- a/clients/client-quicksight/commands/CreateGroupCommand.ts +++ b/clients/client-quicksight/commands/CreateGroupCommand.ts @@ -20,6 +20,13 @@ import { export type CreateGroupCommandInput = CreateGroupRequest; export type CreateGroupCommandOutput = CreateGroupResponse & __MetadataBearer; +/** + *

Creates an Amazon QuickSight group.

+ *

The permissions resource is + * arn:aws:quicksight:us-east-1::group/default/ + * .

+ *

The response is a group object.

+ */ export class CreateGroupCommand extends $Command< CreateGroupCommandInput, CreateGroupCommandOutput, @@ -34,6 +41,9 @@ export class CreateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateGroupMembershipCommand.ts b/clients/client-quicksight/commands/CreateGroupMembershipCommand.ts index f99fc50b3908d..2625760cfe3f6 100644 --- a/clients/client-quicksight/commands/CreateGroupMembershipCommand.ts +++ b/clients/client-quicksight/commands/CreateGroupMembershipCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGroupMembershipCommandInput = CreateGroupMembershipRequest; export type CreateGroupMembershipCommandOutput = CreateGroupMembershipResponse & __MetadataBearer; +/** + *

Adds an Amazon QuickSight user to an Amazon QuickSight group.

+ */ export class CreateGroupMembershipCommand extends $Command< CreateGroupMembershipCommandInput, CreateGroupMembershipCommandOutput, @@ -34,6 +37,9 @@ export class CreateGroupMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateIAMPolicyAssignmentCommand.ts b/clients/client-quicksight/commands/CreateIAMPolicyAssignmentCommand.ts index ad82cce59c940..5e0dd038cdf0c 100644 --- a/clients/client-quicksight/commands/CreateIAMPolicyAssignmentCommand.ts +++ b/clients/client-quicksight/commands/CreateIAMPolicyAssignmentCommand.ts @@ -20,6 +20,12 @@ import { export type CreateIAMPolicyAssignmentCommandInput = CreateIAMPolicyAssignmentRequest; export type CreateIAMPolicyAssignmentCommandOutput = CreateIAMPolicyAssignmentResponse & __MetadataBearer; +/** + *

Creates an assignment with one specified IAM policy, identified by its Amazon Resource Name + * (ARN). This policy assignment is attached to the specified groups or users of Amazon QuickSight. + * Assignment names are unique per AWS account. To avoid overwriting rules in other namespaces, + * use assignment names that are unique.

+ */ export class CreateIAMPolicyAssignmentCommand extends $Command< CreateIAMPolicyAssignmentCommandInput, CreateIAMPolicyAssignmentCommandOutput, @@ -34,6 +40,9 @@ export class CreateIAMPolicyAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateIngestionCommand.ts b/clients/client-quicksight/commands/CreateIngestionCommand.ts index 621bbfb41a1cf..7cac862db1c4e 100644 --- a/clients/client-quicksight/commands/CreateIngestionCommand.ts +++ b/clients/client-quicksight/commands/CreateIngestionCommand.ts @@ -20,6 +20,13 @@ import { export type CreateIngestionCommandInput = CreateIngestionRequest; export type CreateIngestionCommandOutput = CreateIngestionResponse & __MetadataBearer; +/** + *

Creates and starts a new SPICE ingestion on a dataset

+ * + *

Any ingestions operating on tagged datasets inherit the same tags automatically for use in + * access control. For an example, see How do I create an IAM policy to control access to Amazon EC2 resources using + * tags? in the AWS Knowledge Center. Tags are visible on the tagged dataset, but not on the ingestion resource.

+ */ export class CreateIngestionCommand extends $Command< CreateIngestionCommandInput, CreateIngestionCommandOutput, @@ -34,6 +41,9 @@ export class CreateIngestionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateNamespaceCommand.ts b/clients/client-quicksight/commands/CreateNamespaceCommand.ts index 0527d09e7717d..3fac2d284d86f 100644 --- a/clients/client-quicksight/commands/CreateNamespaceCommand.ts +++ b/clients/client-quicksight/commands/CreateNamespaceCommand.ts @@ -20,6 +20,16 @@ import { export type CreateNamespaceCommandInput = CreateNamespaceRequest; export type CreateNamespaceCommandOutput = CreateNamespaceResponse & __MetadataBearer; +/** + *

(Enterprise edition only) Creates a new namespace for you to use with Amazon QuickSight.

+ *

A namespace allows you to isolate the QuickSight users and groups that are registered + * for that namespace. Users that access the namespace can share assets only with other + * users or groups in the same namespace. They can't see users and groups in other + * namespaces. You can create a namespace after your AWS account is subscribed to + * QuickSight. The namespace must be unique within the AWS account. By default, there is a + * limit of 100 namespaces per AWS account. To increase your limit, create a ticket with + * AWS Support.

+ */ export class CreateNamespaceCommand extends $Command< CreateNamespaceCommandInput, CreateNamespaceCommandOutput, @@ -34,6 +44,9 @@ export class CreateNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateTemplateAliasCommand.ts b/clients/client-quicksight/commands/CreateTemplateAliasCommand.ts index d66b52e1a60a2..d995daee39552 100644 --- a/clients/client-quicksight/commands/CreateTemplateAliasCommand.ts +++ b/clients/client-quicksight/commands/CreateTemplateAliasCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTemplateAliasCommandInput = CreateTemplateAliasRequest; export type CreateTemplateAliasCommandOutput = CreateTemplateAliasResponse & __MetadataBearer; +/** + *

Creates a template alias for a template.

+ */ export class CreateTemplateAliasCommand extends $Command< CreateTemplateAliasCommandInput, CreateTemplateAliasCommandOutput, @@ -34,6 +37,9 @@ export class CreateTemplateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateTemplateCommand.ts b/clients/client-quicksight/commands/CreateTemplateCommand.ts index 460b9d556feb6..7355a664d5636 100644 --- a/clients/client-quicksight/commands/CreateTemplateCommand.ts +++ b/clients/client-quicksight/commands/CreateTemplateCommand.ts @@ -20,6 +20,16 @@ import { export type CreateTemplateCommandInput = CreateTemplateRequest; export type CreateTemplateCommandOutput = CreateTemplateResponse & __MetadataBearer; +/** + *

Creates a template from an existing QuickSight analysis or template. You can use the resulting + * template to create a dashboard.

+ *

A template is an entity in QuickSight that encapsulates the metadata + * required to create an analysis and that you can use to create s dashboard. A template adds + * a layer of abstraction by using placeholders to replace the dataset associated with the + * analysis. You can use templates to create dashboards by replacing dataset placeholders + * with datasets that follow the same schema that was used to create the source analysis + * and template.

+ */ export class CreateTemplateCommand extends $Command< CreateTemplateCommandInput, CreateTemplateCommandOutput, @@ -34,6 +44,9 @@ export class CreateTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateThemeAliasCommand.ts b/clients/client-quicksight/commands/CreateThemeAliasCommand.ts index cdb87ee9dee41..62fe508dee0bb 100644 --- a/clients/client-quicksight/commands/CreateThemeAliasCommand.ts +++ b/clients/client-quicksight/commands/CreateThemeAliasCommand.ts @@ -20,6 +20,9 @@ import { export type CreateThemeAliasCommandInput = CreateThemeAliasRequest; export type CreateThemeAliasCommandOutput = CreateThemeAliasResponse & __MetadataBearer; +/** + *

Creates a theme alias for a theme.

+ */ export class CreateThemeAliasCommand extends $Command< CreateThemeAliasCommandInput, CreateThemeAliasCommandOutput, @@ -34,6 +37,9 @@ export class CreateThemeAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/CreateThemeCommand.ts b/clients/client-quicksight/commands/CreateThemeCommand.ts index 4ffe7e2a0bd17..004387da1eddc 100644 --- a/clients/client-quicksight/commands/CreateThemeCommand.ts +++ b/clients/client-quicksight/commands/CreateThemeCommand.ts @@ -20,6 +20,12 @@ import { export type CreateThemeCommandInput = CreateThemeRequest; export type CreateThemeCommandOutput = CreateThemeResponse & __MetadataBearer; +/** + *

Creates a theme.

+ *

A theme is set of configuration options for color and layout. + * Themes apply to analyses and dashboards. For more information, see Using + * Themes in Amazon QuickSight in the Amazon QuickSight User Guide.

+ */ export class CreateThemeCommand extends $Command< CreateThemeCommandInput, CreateThemeCommandOutput, @@ -34,6 +40,9 @@ export class CreateThemeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteAccountCustomizationCommand.ts b/clients/client-quicksight/commands/DeleteAccountCustomizationCommand.ts index 4e7f383298490..425ef31759623 100644 --- a/clients/client-quicksight/commands/DeleteAccountCustomizationCommand.ts +++ b/clients/client-quicksight/commands/DeleteAccountCustomizationCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAccountCustomizationCommandInput = DeleteAccountCustomizationRequest; export type DeleteAccountCustomizationCommandOutput = DeleteAccountCustomizationResponse & __MetadataBearer; +/** + *

Deletes all Amazon QuickSight customizations in this AWS Region for the specified AWS + * account and QuickSight namespace.

+ */ export class DeleteAccountCustomizationCommand extends $Command< DeleteAccountCustomizationCommandInput, DeleteAccountCustomizationCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAccountCustomizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteAnalysisCommand.ts b/clients/client-quicksight/commands/DeleteAnalysisCommand.ts index 335d53ef169c5..7e56359d65f34 100644 --- a/clients/client-quicksight/commands/DeleteAnalysisCommand.ts +++ b/clients/client-quicksight/commands/DeleteAnalysisCommand.ts @@ -20,6 +20,20 @@ import { export type DeleteAnalysisCommandInput = DeleteAnalysisRequest; export type DeleteAnalysisCommandOutput = DeleteAnalysisResponse & __MetadataBearer; +/** + *

Deletes an analysis from Amazon QuickSight. You can optionally include a recovery window during + * which you can restore the analysis. If you don't specify a recovery window value, the + * operation defaults to 30 days. QuickSight attaches a DeletionTime stamp to + * the response that specifies the end of the recovery window. At the end of the recovery + * window, QuickSight deletes the analysis permanently.

+ *

At any time before recovery window ends, you can use the RestoreAnalysis + * API operation to remove the DeletionTime stamp and cancel the deletion of + * the analysis. The analysis remains visible in the API until it's deleted, so you can + * describe it but you can't make a template from it.

+ *

An analysis that's scheduled for deletion isn't accessible in the QuickSight console. + * To access it in the console, restore it. Deleting an analysis doesn't delete the + * dashboards that you publish from it.

+ */ export class DeleteAnalysisCommand extends $Command< DeleteAnalysisCommandInput, DeleteAnalysisCommandOutput, @@ -34,6 +48,9 @@ export class DeleteAnalysisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteDashboardCommand.ts b/clients/client-quicksight/commands/DeleteDashboardCommand.ts index d3fa84dd2fb90..f6475a6ebbff8 100644 --- a/clients/client-quicksight/commands/DeleteDashboardCommand.ts +++ b/clients/client-quicksight/commands/DeleteDashboardCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDashboardCommandInput = DeleteDashboardRequest; export type DeleteDashboardCommandOutput = DeleteDashboardResponse & __MetadataBearer; +/** + *

Deletes a dashboard.

+ */ export class DeleteDashboardCommand extends $Command< DeleteDashboardCommandInput, DeleteDashboardCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteDataSetCommand.ts b/clients/client-quicksight/commands/DeleteDataSetCommand.ts index a7f5db63709bb..d51732fa9be57 100644 --- a/clients/client-quicksight/commands/DeleteDataSetCommand.ts +++ b/clients/client-quicksight/commands/DeleteDataSetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDataSetCommandInput = DeleteDataSetRequest; export type DeleteDataSetCommandOutput = DeleteDataSetResponse & __MetadataBearer; +/** + *

Deletes a dataset.

+ */ export class DeleteDataSetCommand extends $Command< DeleteDataSetCommandInput, DeleteDataSetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteDataSourceCommand.ts b/clients/client-quicksight/commands/DeleteDataSourceCommand.ts index 68881cce9f613..e07ddae373b73 100644 --- a/clients/client-quicksight/commands/DeleteDataSourceCommand.ts +++ b/clients/client-quicksight/commands/DeleteDataSourceCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDataSourceCommandInput = DeleteDataSourceRequest; export type DeleteDataSourceCommandOutput = DeleteDataSourceResponse & __MetadataBearer; +/** + *

Deletes the data source permanently. This operation breaks + * all the datasets that reference the deleted data source.

+ */ export class DeleteDataSourceCommand extends $Command< DeleteDataSourceCommandInput, DeleteDataSourceCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteGroupCommand.ts b/clients/client-quicksight/commands/DeleteGroupCommand.ts index 1c845c889693f..804491c5fb7f7 100644 --- a/clients/client-quicksight/commands/DeleteGroupCommand.ts +++ b/clients/client-quicksight/commands/DeleteGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGroupCommandInput = DeleteGroupRequest; export type DeleteGroupCommandOutput = DeleteGroupResponse & __MetadataBearer; +/** + *

Removes a user group from Amazon QuickSight.

+ */ export class DeleteGroupCommand extends $Command< DeleteGroupCommandInput, DeleteGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteGroupMembershipCommand.ts b/clients/client-quicksight/commands/DeleteGroupMembershipCommand.ts index 4fb269d615ad2..2b15ef914fbad 100644 --- a/clients/client-quicksight/commands/DeleteGroupMembershipCommand.ts +++ b/clients/client-quicksight/commands/DeleteGroupMembershipCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGroupMembershipCommandInput = DeleteGroupMembershipRequest; export type DeleteGroupMembershipCommandOutput = DeleteGroupMembershipResponse & __MetadataBearer; +/** + *

Removes a user from a group so that the user is no longer a member of the group.

+ */ export class DeleteGroupMembershipCommand extends $Command< DeleteGroupMembershipCommandInput, DeleteGroupMembershipCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGroupMembershipCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteIAMPolicyAssignmentCommand.ts b/clients/client-quicksight/commands/DeleteIAMPolicyAssignmentCommand.ts index 05fd3b171b78e..e942e5bfc8923 100644 --- a/clients/client-quicksight/commands/DeleteIAMPolicyAssignmentCommand.ts +++ b/clients/client-quicksight/commands/DeleteIAMPolicyAssignmentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteIAMPolicyAssignmentCommandInput = DeleteIAMPolicyAssignmentRequest; export type DeleteIAMPolicyAssignmentCommandOutput = DeleteIAMPolicyAssignmentResponse & __MetadataBearer; +/** + *

Deletes an existing IAM policy assignment.

+ */ export class DeleteIAMPolicyAssignmentCommand extends $Command< DeleteIAMPolicyAssignmentCommandInput, DeleteIAMPolicyAssignmentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteIAMPolicyAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteNamespaceCommand.ts b/clients/client-quicksight/commands/DeleteNamespaceCommand.ts index c2f85f0f84a36..29fe92a66f4a2 100644 --- a/clients/client-quicksight/commands/DeleteNamespaceCommand.ts +++ b/clients/client-quicksight/commands/DeleteNamespaceCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteNamespaceCommandInput = DeleteNamespaceRequest; export type DeleteNamespaceCommandOutput = DeleteNamespaceResponse & __MetadataBearer; +/** + *

Deletes a namespace and the users and groups that are associated with the namespace. + * This is an asynchronous process. Assets including dashboards, analyses, datasets and data sources are not + * deleted. To delete these assets, you use the API operations for the relevant asset.

+ */ export class DeleteNamespaceCommand extends $Command< DeleteNamespaceCommandInput, DeleteNamespaceCommandOutput, @@ -34,6 +39,9 @@ export class DeleteNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteTemplateAliasCommand.ts b/clients/client-quicksight/commands/DeleteTemplateAliasCommand.ts index 81cc35b69d110..2d8a3e8251dec 100644 --- a/clients/client-quicksight/commands/DeleteTemplateAliasCommand.ts +++ b/clients/client-quicksight/commands/DeleteTemplateAliasCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTemplateAliasCommandInput = DeleteTemplateAliasRequest; export type DeleteTemplateAliasCommandOutput = DeleteTemplateAliasResponse & __MetadataBearer; +/** + *

Deletes the item that the specified template alias points to. If you provide a specific + * alias, you delete the version of the template that the alias points to.

+ */ export class DeleteTemplateAliasCommand extends $Command< DeleteTemplateAliasCommandInput, DeleteTemplateAliasCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTemplateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteTemplateCommand.ts b/clients/client-quicksight/commands/DeleteTemplateCommand.ts index cd4caccac5629..00eb33ba72803 100644 --- a/clients/client-quicksight/commands/DeleteTemplateCommand.ts +++ b/clients/client-quicksight/commands/DeleteTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTemplateCommandInput = DeleteTemplateRequest; export type DeleteTemplateCommandOutput = DeleteTemplateResponse & __MetadataBearer; +/** + *

Deletes a template.

+ */ export class DeleteTemplateCommand extends $Command< DeleteTemplateCommandInput, DeleteTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteThemeAliasCommand.ts b/clients/client-quicksight/commands/DeleteThemeAliasCommand.ts index 19cf932c06a05..bda1d3e3cbfbe 100644 --- a/clients/client-quicksight/commands/DeleteThemeAliasCommand.ts +++ b/clients/client-quicksight/commands/DeleteThemeAliasCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteThemeAliasCommandInput = DeleteThemeAliasRequest; export type DeleteThemeAliasCommandOutput = DeleteThemeAliasResponse & __MetadataBearer; +/** + *

Deletes the version of the theme that the specified theme alias points to. + * If you provide a specific alias, you delete the version of the theme + * that the alias points to.

+ */ export class DeleteThemeAliasCommand extends $Command< DeleteThemeAliasCommandInput, DeleteThemeAliasCommandOutput, @@ -34,6 +39,9 @@ export class DeleteThemeAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteThemeCommand.ts b/clients/client-quicksight/commands/DeleteThemeCommand.ts index 1a8b9d4b24606..10ce91d55939c 100644 --- a/clients/client-quicksight/commands/DeleteThemeCommand.ts +++ b/clients/client-quicksight/commands/DeleteThemeCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteThemeCommandInput = DeleteThemeRequest; export type DeleteThemeCommandOutput = DeleteThemeResponse & __MetadataBearer; +/** + *

Deletes a theme.

+ */ export class DeleteThemeCommand extends $Command< DeleteThemeCommandInput, DeleteThemeCommandOutput, @@ -34,6 +37,9 @@ export class DeleteThemeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteUserByPrincipalIdCommand.ts b/clients/client-quicksight/commands/DeleteUserByPrincipalIdCommand.ts index 62995cac52828..b07ba08df266c 100644 --- a/clients/client-quicksight/commands/DeleteUserByPrincipalIdCommand.ts +++ b/clients/client-quicksight/commands/DeleteUserByPrincipalIdCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserByPrincipalIdCommandInput = DeleteUserByPrincipalIdRequest; export type DeleteUserByPrincipalIdCommandOutput = DeleteUserByPrincipalIdResponse & __MetadataBearer; +/** + *

Deletes a user identified by its principal ID.

+ */ export class DeleteUserByPrincipalIdCommand extends $Command< DeleteUserByPrincipalIdCommandInput, DeleteUserByPrincipalIdCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserByPrincipalIdCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DeleteUserCommand.ts b/clients/client-quicksight/commands/DeleteUserCommand.ts index 479a0fcc942ba..2aa03fb9d2039 100644 --- a/clients/client-quicksight/commands/DeleteUserCommand.ts +++ b/clients/client-quicksight/commands/DeleteUserCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = DeleteUserResponse & __MetadataBearer; +/** + *

Deletes the Amazon QuickSight user that is associated with the identity of the AWS + * Identity and Access Management (IAM) user or role that's making the call. The IAM user + * isn't deleted as a result of this call.

+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -34,6 +39,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeAccountCustomizationCommand.ts b/clients/client-quicksight/commands/DescribeAccountCustomizationCommand.ts index 6b6d212dfdbb0..4c01e2b11c5e5 100644 --- a/clients/client-quicksight/commands/DescribeAccountCustomizationCommand.ts +++ b/clients/client-quicksight/commands/DescribeAccountCustomizationCommand.ts @@ -20,6 +20,65 @@ import { export type DescribeAccountCustomizationCommandInput = DescribeAccountCustomizationRequest; export type DescribeAccountCustomizationCommandOutput = DescribeAccountCustomizationResponse & __MetadataBearer; +/** + *

Describes the customizations associated with the provided AWS account and Amazon + * QuickSight namespace in an AWS Region. The QuickSight console evaluates which + * customizations to apply by running this API operation with the Resolved flag + * included.

+ *

To determine what customizations display when you run this command, it can help to + * visualize the relationship of the entities involved.

+ *
    + *
  • + *

    + * AWS Account - The AWS account exists at the top of the hierarchy. + * It has the potential to use all of the AWS Regions and AWS Services. When you + * subscribe to QuickSight, you choose one AWS Region to use as your home Region. + * That's where your free SPICE capacity is located. You can use QuickSight in any + * supported AWS Region.

    + *
  • + *
  • + *

    + * AWS Region - In each AWS Region where you sign in to QuickSight + * at least once, QuickSight acts as a separate instance of the same service. If + * you have a user directory, it resides in us-east-1, which is the US East (N. + * Virginia). Generally speaking, these users have access to QuickSight in any AWS + * Region, unless they are constrained to a namespace.

    + *

    To run the command in a different AWS Region, you change your Region settings. + * If you're using the AWS CLI, you can use one of the following options:

    + * + *
  • + *
  • + *

    + * Namespace - A QuickSight namespace is a partition that contains + * users and assets (data sources, datasets, dashboards, and so on). To access + * assets that are in a specific namespace, users and groups must also be part of + * the same namespace. People who share a namespace are completely isolated from + * users and assets in other namespaces, even if they are in the same AWS account + * and AWS Region.

    + *
  • + *
  • + *

    + * Applied customizations - Within an AWS Region, a set of + * QuickSight customizations can apply to an AWS account or to a namespace. + * Settings that you apply to a namespace override settings that you apply to an + * AWS account. All settings are isolated to a single AWS Region. To apply them in + * other AWS Regions, run the CreateAccountCustomization command in + * each AWS Region where you want to apply the same customizations.

    + *
  • + *
+ */ export class DescribeAccountCustomizationCommand extends $Command< DescribeAccountCustomizationCommandInput, DescribeAccountCustomizationCommandOutput, @@ -34,6 +93,9 @@ export class DescribeAccountCustomizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeAccountSettingsCommand.ts b/clients/client-quicksight/commands/DescribeAccountSettingsCommand.ts index 03d1ca7b698ae..e98d97abf77fd 100644 --- a/clients/client-quicksight/commands/DescribeAccountSettingsCommand.ts +++ b/clients/client-quicksight/commands/DescribeAccountSettingsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAccountSettingsCommandInput = DescribeAccountSettingsRequest; export type DescribeAccountSettingsCommandOutput = DescribeAccountSettingsResponse & __MetadataBearer; +/** + *

Describes the settings that were used when your QuickSight subscription was first + * created in this AWS account.

+ */ export class DescribeAccountSettingsCommand extends $Command< DescribeAccountSettingsCommandInput, DescribeAccountSettingsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAccountSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeAnalysisCommand.ts b/clients/client-quicksight/commands/DescribeAnalysisCommand.ts index 4ac4036244a5d..6cbfdb54d11ce 100644 --- a/clients/client-quicksight/commands/DescribeAnalysisCommand.ts +++ b/clients/client-quicksight/commands/DescribeAnalysisCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAnalysisCommandInput = DescribeAnalysisRequest; export type DescribeAnalysisCommandOutput = DescribeAnalysisResponse & __MetadataBearer; +/** + *

Provides a summary of the metadata for an analysis.

+ */ export class DescribeAnalysisCommand extends $Command< DescribeAnalysisCommandInput, DescribeAnalysisCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAnalysisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeAnalysisPermissionsCommand.ts b/clients/client-quicksight/commands/DescribeAnalysisPermissionsCommand.ts index 13abe4e6bffa0..459eb3f09a9cb 100644 --- a/clients/client-quicksight/commands/DescribeAnalysisPermissionsCommand.ts +++ b/clients/client-quicksight/commands/DescribeAnalysisPermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAnalysisPermissionsCommandInput = DescribeAnalysisPermissionsRequest; export type DescribeAnalysisPermissionsCommandOutput = DescribeAnalysisPermissionsResponse & __MetadataBearer; +/** + *

Provides the read and write permissions for an analysis.

+ */ export class DescribeAnalysisPermissionsCommand extends $Command< DescribeAnalysisPermissionsCommandInput, DescribeAnalysisPermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAnalysisPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeDashboardCommand.ts b/clients/client-quicksight/commands/DescribeDashboardCommand.ts index dd7441796af75..6630c75ad9fbd 100644 --- a/clients/client-quicksight/commands/DescribeDashboardCommand.ts +++ b/clients/client-quicksight/commands/DescribeDashboardCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDashboardCommandInput = DescribeDashboardRequest; export type DescribeDashboardCommandOutput = DescribeDashboardResponse & __MetadataBearer; +/** + *

Provides a summary for a dashboard.

+ */ export class DescribeDashboardCommand extends $Command< DescribeDashboardCommandInput, DescribeDashboardCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeDashboardPermissionsCommand.ts b/clients/client-quicksight/commands/DescribeDashboardPermissionsCommand.ts index 455e8f51773d0..ba71dbd61bb9b 100644 --- a/clients/client-quicksight/commands/DescribeDashboardPermissionsCommand.ts +++ b/clients/client-quicksight/commands/DescribeDashboardPermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDashboardPermissionsCommandInput = DescribeDashboardPermissionsRequest; export type DescribeDashboardPermissionsCommandOutput = DescribeDashboardPermissionsResponse & __MetadataBearer; +/** + *

Describes read and write permissions for a dashboard.

+ */ export class DescribeDashboardPermissionsCommand extends $Command< DescribeDashboardPermissionsCommandInput, DescribeDashboardPermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDashboardPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeDataSetCommand.ts b/clients/client-quicksight/commands/DescribeDataSetCommand.ts index ded042e6e8f44..21788e09bdf89 100644 --- a/clients/client-quicksight/commands/DescribeDataSetCommand.ts +++ b/clients/client-quicksight/commands/DescribeDataSetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDataSetCommandInput = DescribeDataSetRequest; export type DescribeDataSetCommandOutput = DescribeDataSetResponse & __MetadataBearer; +/** + *

Describes a dataset.

+ */ export class DescribeDataSetCommand extends $Command< DescribeDataSetCommandInput, DescribeDataSetCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeDataSetPermissionsCommand.ts b/clients/client-quicksight/commands/DescribeDataSetPermissionsCommand.ts index fcd24284ccb8d..33b9c3f145fdd 100644 --- a/clients/client-quicksight/commands/DescribeDataSetPermissionsCommand.ts +++ b/clients/client-quicksight/commands/DescribeDataSetPermissionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDataSetPermissionsCommandInput = DescribeDataSetPermissionsRequest; export type DescribeDataSetPermissionsCommandOutput = DescribeDataSetPermissionsResponse & __MetadataBearer; +/** + *

Describes the permissions on a dataset.

+ *

The permissions resource is arn:aws:quicksight:region:aws-account-id:dataset/data-set-id.

+ */ export class DescribeDataSetPermissionsCommand extends $Command< DescribeDataSetPermissionsCommandInput, DescribeDataSetPermissionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDataSetPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeDataSourceCommand.ts b/clients/client-quicksight/commands/DescribeDataSourceCommand.ts index 290bafc2c9165..514f61d4b4316 100644 --- a/clients/client-quicksight/commands/DescribeDataSourceCommand.ts +++ b/clients/client-quicksight/commands/DescribeDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDataSourceCommandInput = DescribeDataSourceRequest; export type DescribeDataSourceCommandOutput = DescribeDataSourceResponse & __MetadataBearer; +/** + *

Describes a data source.

+ */ export class DescribeDataSourceCommand extends $Command< DescribeDataSourceCommandInput, DescribeDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeDataSourcePermissionsCommand.ts b/clients/client-quicksight/commands/DescribeDataSourcePermissionsCommand.ts index bf8d9727831c5..98ea1d1c9e4e4 100644 --- a/clients/client-quicksight/commands/DescribeDataSourcePermissionsCommand.ts +++ b/clients/client-quicksight/commands/DescribeDataSourcePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDataSourcePermissionsCommandInput = DescribeDataSourcePermissionsRequest; export type DescribeDataSourcePermissionsCommandOutput = DescribeDataSourcePermissionsResponse & __MetadataBearer; +/** + *

Describes the resource permissions for a data source.

+ */ export class DescribeDataSourcePermissionsCommand extends $Command< DescribeDataSourcePermissionsCommandInput, DescribeDataSourcePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDataSourcePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeGroupCommand.ts b/clients/client-quicksight/commands/DescribeGroupCommand.ts index 785e7128bc3d3..13ff1f2b74f4a 100644 --- a/clients/client-quicksight/commands/DescribeGroupCommand.ts +++ b/clients/client-quicksight/commands/DescribeGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeGroupCommandInput = DescribeGroupRequest; export type DescribeGroupCommandOutput = DescribeGroupResponse & __MetadataBearer; +/** + *

Returns an Amazon QuickSight group's description and Amazon Resource Name (ARN).

+ */ export class DescribeGroupCommand extends $Command< DescribeGroupCommandInput, DescribeGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeIAMPolicyAssignmentCommand.ts b/clients/client-quicksight/commands/DescribeIAMPolicyAssignmentCommand.ts index 538a42e699a08..a513178cbf84d 100644 --- a/clients/client-quicksight/commands/DescribeIAMPolicyAssignmentCommand.ts +++ b/clients/client-quicksight/commands/DescribeIAMPolicyAssignmentCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeIAMPolicyAssignmentCommandInput = DescribeIAMPolicyAssignmentRequest; export type DescribeIAMPolicyAssignmentCommandOutput = DescribeIAMPolicyAssignmentResponse & __MetadataBearer; +/** + *

Describes an existing IAM policy assignment, as specified by the assignment name.

+ */ export class DescribeIAMPolicyAssignmentCommand extends $Command< DescribeIAMPolicyAssignmentCommandInput, DescribeIAMPolicyAssignmentCommandOutput, @@ -34,6 +37,9 @@ export class DescribeIAMPolicyAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeIngestionCommand.ts b/clients/client-quicksight/commands/DescribeIngestionCommand.ts index 291d1f6b7a422..b0ac2c5356b5f 100644 --- a/clients/client-quicksight/commands/DescribeIngestionCommand.ts +++ b/clients/client-quicksight/commands/DescribeIngestionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeIngestionCommandInput = DescribeIngestionRequest; export type DescribeIngestionCommandOutput = DescribeIngestionResponse & __MetadataBearer; +/** + *

Describes a SPICE ingestion.

+ */ export class DescribeIngestionCommand extends $Command< DescribeIngestionCommandInput, DescribeIngestionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeIngestionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeNamespaceCommand.ts b/clients/client-quicksight/commands/DescribeNamespaceCommand.ts index 71b3f21cad49e..34a0d3643a7cd 100644 --- a/clients/client-quicksight/commands/DescribeNamespaceCommand.ts +++ b/clients/client-quicksight/commands/DescribeNamespaceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNamespaceCommandInput = DescribeNamespaceRequest; export type DescribeNamespaceCommandOutput = DescribeNamespaceResponse & __MetadataBearer; +/** + *

Describes the current namespace.

+ */ export class DescribeNamespaceCommand extends $Command< DescribeNamespaceCommandInput, DescribeNamespaceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeTemplateAliasCommand.ts b/clients/client-quicksight/commands/DescribeTemplateAliasCommand.ts index 87e83ca96c8ec..06cee098eb2f4 100644 --- a/clients/client-quicksight/commands/DescribeTemplateAliasCommand.ts +++ b/clients/client-quicksight/commands/DescribeTemplateAliasCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTemplateAliasCommandInput = DescribeTemplateAliasRequest; export type DescribeTemplateAliasCommandOutput = DescribeTemplateAliasResponse & __MetadataBearer; +/** + *

Describes the template alias for a template.

+ */ export class DescribeTemplateAliasCommand extends $Command< DescribeTemplateAliasCommandInput, DescribeTemplateAliasCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTemplateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeTemplateCommand.ts b/clients/client-quicksight/commands/DescribeTemplateCommand.ts index 3233cecf16da5..25ccac3648365 100644 --- a/clients/client-quicksight/commands/DescribeTemplateCommand.ts +++ b/clients/client-quicksight/commands/DescribeTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTemplateCommandInput = DescribeTemplateRequest; export type DescribeTemplateCommandOutput = DescribeTemplateResponse & __MetadataBearer; +/** + *

Describes a template's metadata.

+ */ export class DescribeTemplateCommand extends $Command< DescribeTemplateCommandInput, DescribeTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeTemplatePermissionsCommand.ts b/clients/client-quicksight/commands/DescribeTemplatePermissionsCommand.ts index cf1dbbd1d4e94..596745c183e99 100644 --- a/clients/client-quicksight/commands/DescribeTemplatePermissionsCommand.ts +++ b/clients/client-quicksight/commands/DescribeTemplatePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTemplatePermissionsCommandInput = DescribeTemplatePermissionsRequest; export type DescribeTemplatePermissionsCommandOutput = DescribeTemplatePermissionsResponse & __MetadataBearer; +/** + *

Describes read and write permissions on a template.

+ */ export class DescribeTemplatePermissionsCommand extends $Command< DescribeTemplatePermissionsCommandInput, DescribeTemplatePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTemplatePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeThemeAliasCommand.ts b/clients/client-quicksight/commands/DescribeThemeAliasCommand.ts index 267b9ae78f9db..1601179406dd4 100644 --- a/clients/client-quicksight/commands/DescribeThemeAliasCommand.ts +++ b/clients/client-quicksight/commands/DescribeThemeAliasCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeThemeAliasCommandInput = DescribeThemeAliasRequest; export type DescribeThemeAliasCommandOutput = DescribeThemeAliasResponse & __MetadataBearer; +/** + *

Describes the alias for a theme.

+ */ export class DescribeThemeAliasCommand extends $Command< DescribeThemeAliasCommandInput, DescribeThemeAliasCommandOutput, @@ -34,6 +37,9 @@ export class DescribeThemeAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeThemeCommand.ts b/clients/client-quicksight/commands/DescribeThemeCommand.ts index 2c7f70cde1690..05cb2eb0fbb79 100644 --- a/clients/client-quicksight/commands/DescribeThemeCommand.ts +++ b/clients/client-quicksight/commands/DescribeThemeCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeThemeCommandInput = DescribeThemeRequest; export type DescribeThemeCommandOutput = DescribeThemeResponse & __MetadataBearer; +/** + *

Describes a theme.

+ */ export class DescribeThemeCommand extends $Command< DescribeThemeCommandInput, DescribeThemeCommandOutput, @@ -34,6 +37,9 @@ export class DescribeThemeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeThemePermissionsCommand.ts b/clients/client-quicksight/commands/DescribeThemePermissionsCommand.ts index 5424bc7b27ed4..4b40fa9011de9 100644 --- a/clients/client-quicksight/commands/DescribeThemePermissionsCommand.ts +++ b/clients/client-quicksight/commands/DescribeThemePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeThemePermissionsCommandInput = DescribeThemePermissionsRequest; export type DescribeThemePermissionsCommandOutput = DescribeThemePermissionsResponse & __MetadataBearer; +/** + *

Describes the read and write permissions for a theme.

+ */ export class DescribeThemePermissionsCommand extends $Command< DescribeThemePermissionsCommandInput, DescribeThemePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeThemePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/DescribeUserCommand.ts b/clients/client-quicksight/commands/DescribeUserCommand.ts index 132babbf48c3d..9786e6cc09873 100644 --- a/clients/client-quicksight/commands/DescribeUserCommand.ts +++ b/clients/client-quicksight/commands/DescribeUserCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserCommandInput = DescribeUserRequest; export type DescribeUserCommandOutput = DescribeUserResponse & __MetadataBearer; +/** + *

Returns information about a user, given the user name.

+ */ export class DescribeUserCommand extends $Command< DescribeUserCommandInput, DescribeUserCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/GetDashboardEmbedUrlCommand.ts b/clients/client-quicksight/commands/GetDashboardEmbedUrlCommand.ts index e66cb6c20d749..ca6e7bd7dd662 100644 --- a/clients/client-quicksight/commands/GetDashboardEmbedUrlCommand.ts +++ b/clients/client-quicksight/commands/GetDashboardEmbedUrlCommand.ts @@ -20,6 +20,31 @@ import { export type GetDashboardEmbedUrlCommandInput = GetDashboardEmbedUrlRequest; export type GetDashboardEmbedUrlCommandOutput = GetDashboardEmbedUrlResponse & __MetadataBearer; +/** + *

Generates a session URL and authorization code that you can use to embed an Amazon + * QuickSight read-only dashboard in your web server code. Before you use this command, + * make sure that you have configured the dashboards and permissions.

+ *

Currently, you can use GetDashboardEmbedURL only from the server, not + * from the user's browser. The following rules apply to the combination of URL and + * authorization code:

+ *
    + *
  • + *

    They must be used together.

    + *
  • + *
  • + *

    They can be used one time only.

    + *
  • + *
  • + *

    They are valid for 5 minutes after you run this command.

    + *
  • + *
  • + *

    The resulting user session is valid for 10 hours.

    + *
  • + *
+ *

For more information, see Embedding Amazon QuickSight in the Amazon QuickSight User + * Guide + * .

+ */ export class GetDashboardEmbedUrlCommand extends $Command< GetDashboardEmbedUrlCommandInput, GetDashboardEmbedUrlCommandOutput, @@ -34,6 +59,9 @@ export class GetDashboardEmbedUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/GetSessionEmbedUrlCommand.ts b/clients/client-quicksight/commands/GetSessionEmbedUrlCommand.ts index 98b8e856afe80..f9d01ef024c01 100644 --- a/clients/client-quicksight/commands/GetSessionEmbedUrlCommand.ts +++ b/clients/client-quicksight/commands/GetSessionEmbedUrlCommand.ts @@ -20,6 +20,33 @@ import { export type GetSessionEmbedUrlCommandInput = GetSessionEmbedUrlRequest; export type GetSessionEmbedUrlCommandOutput = GetSessionEmbedUrlResponse & __MetadataBearer; +/** + *

Generates a session URL and authorization code that you can use to embed the Amazon + * QuickSight console in your web server code. Use GetSessionEmbedUrl where + * you want to provide an authoring portal that allows users to create data sources, + * datasets, analyses, and dashboards. The users who access an embedded QuickSight console + * need belong to the author or admin security cohort. If you want to restrict permissions + * to some of these features, add a custom permissions profile to the user with the + * + * UpdateUser + * API operation. Use + * RegisterUser + * API operation to add a new user with a custom permission profile attached. For more + * information, see the following sections in the Amazon QuickSight User + * Guide:

+ * + */ export class GetSessionEmbedUrlCommand extends $Command< GetSessionEmbedUrlCommandInput, GetSessionEmbedUrlCommandOutput, @@ -34,6 +61,9 @@ export class GetSessionEmbedUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListAnalysesCommand.ts b/clients/client-quicksight/commands/ListAnalysesCommand.ts index 282811795f76b..5a8b5596c93df 100644 --- a/clients/client-quicksight/commands/ListAnalysesCommand.ts +++ b/clients/client-quicksight/commands/ListAnalysesCommand.ts @@ -20,6 +20,9 @@ import { export type ListAnalysesCommandInput = ListAnalysesRequest; export type ListAnalysesCommandOutput = ListAnalysesResponse & __MetadataBearer; +/** + *

Lists Amazon QuickSight analyses that exist in the specified AWS account.

+ */ export class ListAnalysesCommand extends $Command< ListAnalysesCommandInput, ListAnalysesCommandOutput, @@ -34,6 +37,9 @@ export class ListAnalysesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListDashboardVersionsCommand.ts b/clients/client-quicksight/commands/ListDashboardVersionsCommand.ts index 3332a3ff711af..36d88264ae77f 100644 --- a/clients/client-quicksight/commands/ListDashboardVersionsCommand.ts +++ b/clients/client-quicksight/commands/ListDashboardVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDashboardVersionsCommandInput = ListDashboardVersionsRequest; export type ListDashboardVersionsCommandOutput = ListDashboardVersionsResponse & __MetadataBearer; +/** + *

Lists all the versions of the dashboards in the QuickSight subscription.

+ */ export class ListDashboardVersionsCommand extends $Command< ListDashboardVersionsCommandInput, ListDashboardVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListDashboardVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListDashboardsCommand.ts b/clients/client-quicksight/commands/ListDashboardsCommand.ts index 22e72d697275a..87184b0e39ec5 100644 --- a/clients/client-quicksight/commands/ListDashboardsCommand.ts +++ b/clients/client-quicksight/commands/ListDashboardsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDashboardsCommandInput = ListDashboardsRequest; export type ListDashboardsCommandOutput = ListDashboardsResponse & __MetadataBearer; +/** + *

Lists dashboards in an AWS account.

+ */ export class ListDashboardsCommand extends $Command< ListDashboardsCommandInput, ListDashboardsCommandOutput, @@ -34,6 +37,9 @@ export class ListDashboardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListDataSetsCommand.ts b/clients/client-quicksight/commands/ListDataSetsCommand.ts index 3e633e97c7cdc..ed418f705f48c 100644 --- a/clients/client-quicksight/commands/ListDataSetsCommand.ts +++ b/clients/client-quicksight/commands/ListDataSetsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDataSetsCommandInput = ListDataSetsRequest; export type ListDataSetsCommandOutput = ListDataSetsResponse & __MetadataBearer; +/** + *

Lists all of the datasets belonging to the current AWS account in an AWS Region.

+ *

The permissions resource is arn:aws:quicksight:region:aws-account-id:dataset/*.

+ */ export class ListDataSetsCommand extends $Command< ListDataSetsCommandInput, ListDataSetsCommandOutput, @@ -34,6 +38,9 @@ export class ListDataSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListDataSourcesCommand.ts b/clients/client-quicksight/commands/ListDataSourcesCommand.ts index 91f40d60b70b4..a7901032f20a7 100644 --- a/clients/client-quicksight/commands/ListDataSourcesCommand.ts +++ b/clients/client-quicksight/commands/ListDataSourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDataSourcesCommandInput = ListDataSourcesRequest; export type ListDataSourcesCommandOutput = ListDataSourcesResponse & __MetadataBearer; +/** + *

Lists data sources in current AWS Region that belong to this AWS account.

+ */ export class ListDataSourcesCommand extends $Command< ListDataSourcesCommandInput, ListDataSourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListDataSourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListGroupMembershipsCommand.ts b/clients/client-quicksight/commands/ListGroupMembershipsCommand.ts index 41f7b6a0574e0..1933ace9d7037 100644 --- a/clients/client-quicksight/commands/ListGroupMembershipsCommand.ts +++ b/clients/client-quicksight/commands/ListGroupMembershipsCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroupMembershipsCommandInput = ListGroupMembershipsRequest; export type ListGroupMembershipsCommandOutput = ListGroupMembershipsResponse & __MetadataBearer; +/** + *

Lists member users in a group.

+ */ export class ListGroupMembershipsCommand extends $Command< ListGroupMembershipsCommandInput, ListGroupMembershipsCommandOutput, @@ -34,6 +37,9 @@ export class ListGroupMembershipsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListGroupsCommand.ts b/clients/client-quicksight/commands/ListGroupsCommand.ts index 4d3fe6df22230..732100faf5987 100644 --- a/clients/client-quicksight/commands/ListGroupsCommand.ts +++ b/clients/client-quicksight/commands/ListGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroupsCommandInput = ListGroupsRequest; export type ListGroupsCommandOutput = ListGroupsResponse & __MetadataBearer; +/** + *

Lists all user groups in Amazon QuickSight.

+ */ export class ListGroupsCommand extends $Command< ListGroupsCommandInput, ListGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListIAMPolicyAssignmentsCommand.ts b/clients/client-quicksight/commands/ListIAMPolicyAssignmentsCommand.ts index 2111f4ea68dd4..8e4b159e3700b 100644 --- a/clients/client-quicksight/commands/ListIAMPolicyAssignmentsCommand.ts +++ b/clients/client-quicksight/commands/ListIAMPolicyAssignmentsCommand.ts @@ -20,6 +20,9 @@ import { export type ListIAMPolicyAssignmentsCommandInput = ListIAMPolicyAssignmentsRequest; export type ListIAMPolicyAssignmentsCommandOutput = ListIAMPolicyAssignmentsResponse & __MetadataBearer; +/** + *

Lists IAM policy assignments in the current Amazon QuickSight account.

+ */ export class ListIAMPolicyAssignmentsCommand extends $Command< ListIAMPolicyAssignmentsCommandInput, ListIAMPolicyAssignmentsCommandOutput, @@ -34,6 +37,9 @@ export class ListIAMPolicyAssignmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListIAMPolicyAssignmentsForUserCommand.ts b/clients/client-quicksight/commands/ListIAMPolicyAssignmentsForUserCommand.ts index 4f4568ec41635..0e439bc94c3dc 100644 --- a/clients/client-quicksight/commands/ListIAMPolicyAssignmentsForUserCommand.ts +++ b/clients/client-quicksight/commands/ListIAMPolicyAssignmentsForUserCommand.ts @@ -20,6 +20,11 @@ import { export type ListIAMPolicyAssignmentsForUserCommandInput = ListIAMPolicyAssignmentsForUserRequest; export type ListIAMPolicyAssignmentsForUserCommandOutput = ListIAMPolicyAssignmentsForUserResponse & __MetadataBearer; +/** + *

Lists all the IAM policy assignments, including the Amazon Resource Names (ARNs) for the IAM + * policies assigned to the specified user and group or groups that the user belongs + * to.

+ */ export class ListIAMPolicyAssignmentsForUserCommand extends $Command< ListIAMPolicyAssignmentsForUserCommandInput, ListIAMPolicyAssignmentsForUserCommandOutput, @@ -34,6 +39,9 @@ export class ListIAMPolicyAssignmentsForUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListIngestionsCommand.ts b/clients/client-quicksight/commands/ListIngestionsCommand.ts index cd9c582ec8af5..d46f12b325e3a 100644 --- a/clients/client-quicksight/commands/ListIngestionsCommand.ts +++ b/clients/client-quicksight/commands/ListIngestionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListIngestionsCommandInput = ListIngestionsRequest; export type ListIngestionsCommandOutput = ListIngestionsResponse & __MetadataBearer; +/** + *

Lists the history of SPICE ingestions for a dataset.

+ */ export class ListIngestionsCommand extends $Command< ListIngestionsCommandInput, ListIngestionsCommandOutput, @@ -34,6 +37,9 @@ export class ListIngestionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListNamespacesCommand.ts b/clients/client-quicksight/commands/ListNamespacesCommand.ts index 2ee150d64c05d..ba4333da33f40 100644 --- a/clients/client-quicksight/commands/ListNamespacesCommand.ts +++ b/clients/client-quicksight/commands/ListNamespacesCommand.ts @@ -20,6 +20,9 @@ import { export type ListNamespacesCommandInput = ListNamespacesRequest; export type ListNamespacesCommandOutput = ListNamespacesResponse & __MetadataBearer; +/** + *

Lists the namespaces for the specified AWS account.

+ */ export class ListNamespacesCommand extends $Command< ListNamespacesCommandInput, ListNamespacesCommandOutput, @@ -34,6 +37,9 @@ export class ListNamespacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListTagsForResourceCommand.ts b/clients/client-quicksight/commands/ListTagsForResourceCommand.ts index 0a204bf929ca4..df886314c7fd4 100644 --- a/clients/client-quicksight/commands/ListTagsForResourceCommand.ts +++ b/clients/client-quicksight/commands/ListTagsForResourceCommand.ts @@ -21,6 +21,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags assigned to a resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -35,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListTemplateAliasesCommand.ts b/clients/client-quicksight/commands/ListTemplateAliasesCommand.ts index 162496232b8e7..cfc5b26f5dc27 100644 --- a/clients/client-quicksight/commands/ListTemplateAliasesCommand.ts +++ b/clients/client-quicksight/commands/ListTemplateAliasesCommand.ts @@ -20,6 +20,9 @@ import { export type ListTemplateAliasesCommandInput = ListTemplateAliasesRequest; export type ListTemplateAliasesCommandOutput = ListTemplateAliasesResponse & __MetadataBearer; +/** + *

Lists all the aliases of a template.

+ */ export class ListTemplateAliasesCommand extends $Command< ListTemplateAliasesCommandInput, ListTemplateAliasesCommandOutput, @@ -34,6 +37,9 @@ export class ListTemplateAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListTemplateVersionsCommand.ts b/clients/client-quicksight/commands/ListTemplateVersionsCommand.ts index aae6d9d3e6370..76adae3448fc2 100644 --- a/clients/client-quicksight/commands/ListTemplateVersionsCommand.ts +++ b/clients/client-quicksight/commands/ListTemplateVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTemplateVersionsCommandInput = ListTemplateVersionsRequest; export type ListTemplateVersionsCommandOutput = ListTemplateVersionsResponse & __MetadataBearer; +/** + *

Lists all the versions of the templates in the current Amazon QuickSight account.

+ */ export class ListTemplateVersionsCommand extends $Command< ListTemplateVersionsCommandInput, ListTemplateVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListTemplateVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListTemplatesCommand.ts b/clients/client-quicksight/commands/ListTemplatesCommand.ts index d7c82d030adc9..55880460baaa9 100644 --- a/clients/client-quicksight/commands/ListTemplatesCommand.ts +++ b/clients/client-quicksight/commands/ListTemplatesCommand.ts @@ -20,6 +20,9 @@ import { export type ListTemplatesCommandInput = ListTemplatesRequest; export type ListTemplatesCommandOutput = ListTemplatesResponse & __MetadataBearer; +/** + *

Lists all the templates in the current Amazon QuickSight account.

+ */ export class ListTemplatesCommand extends $Command< ListTemplatesCommandInput, ListTemplatesCommandOutput, @@ -34,6 +37,9 @@ export class ListTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListThemeAliasesCommand.ts b/clients/client-quicksight/commands/ListThemeAliasesCommand.ts index 5ae92a3acb76c..1395dd7ce5d11 100644 --- a/clients/client-quicksight/commands/ListThemeAliasesCommand.ts +++ b/clients/client-quicksight/commands/ListThemeAliasesCommand.ts @@ -20,6 +20,9 @@ import { export type ListThemeAliasesCommandInput = ListThemeAliasesRequest; export type ListThemeAliasesCommandOutput = ListThemeAliasesResponse & __MetadataBearer; +/** + *

Lists all the aliases of a theme.

+ */ export class ListThemeAliasesCommand extends $Command< ListThemeAliasesCommandInput, ListThemeAliasesCommandOutput, @@ -34,6 +37,9 @@ export class ListThemeAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListThemeVersionsCommand.ts b/clients/client-quicksight/commands/ListThemeVersionsCommand.ts index bb6750bdf2000..ee0c7a62b551b 100644 --- a/clients/client-quicksight/commands/ListThemeVersionsCommand.ts +++ b/clients/client-quicksight/commands/ListThemeVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListThemeVersionsCommandInput = ListThemeVersionsRequest; export type ListThemeVersionsCommandOutput = ListThemeVersionsResponse & __MetadataBearer; +/** + *

Lists all the versions of the themes in the current AWS account.

+ */ export class ListThemeVersionsCommand extends $Command< ListThemeVersionsCommandInput, ListThemeVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListThemeVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListThemesCommand.ts b/clients/client-quicksight/commands/ListThemesCommand.ts index 6cb279d574bff..24695fa3c1478 100644 --- a/clients/client-quicksight/commands/ListThemesCommand.ts +++ b/clients/client-quicksight/commands/ListThemesCommand.ts @@ -20,6 +20,9 @@ import { export type ListThemesCommandInput = ListThemesRequest; export type ListThemesCommandOutput = ListThemesResponse & __MetadataBearer; +/** + *

Lists all the themes in the current AWS account.

+ */ export class ListThemesCommand extends $Command< ListThemesCommandInput, ListThemesCommandOutput, @@ -34,6 +37,9 @@ export class ListThemesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListUserGroupsCommand.ts b/clients/client-quicksight/commands/ListUserGroupsCommand.ts index 76a67f25fe10a..03008d87f26a5 100644 --- a/clients/client-quicksight/commands/ListUserGroupsCommand.ts +++ b/clients/client-quicksight/commands/ListUserGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListUserGroupsCommandInput = ListUserGroupsRequest; export type ListUserGroupsCommandOutput = ListUserGroupsResponse & __MetadataBearer; +/** + *

Lists the Amazon QuickSight groups that an Amazon QuickSight user is a member of.

+ */ export class ListUserGroupsCommand extends $Command< ListUserGroupsCommandInput, ListUserGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListUserGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/ListUsersCommand.ts b/clients/client-quicksight/commands/ListUsersCommand.ts index 7979323f4d00a..0ad26811d5eeb 100644 --- a/clients/client-quicksight/commands/ListUsersCommand.ts +++ b/clients/client-quicksight/commands/ListUsersCommand.ts @@ -20,6 +20,9 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + *

Returns a list of all of the Amazon QuickSight users belonging to this account.

+ */ export class ListUsersCommand extends $Command< ListUsersCommandInput, ListUsersCommandOutput, @@ -34,6 +37,9 @@ export class ListUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/RegisterUserCommand.ts b/clients/client-quicksight/commands/RegisterUserCommand.ts index b1c77115ba27d..1a8db6cb2182f 100644 --- a/clients/client-quicksight/commands/RegisterUserCommand.ts +++ b/clients/client-quicksight/commands/RegisterUserCommand.ts @@ -20,6 +20,10 @@ import { export type RegisterUserCommandInput = RegisterUserRequest; export type RegisterUserCommandOutput = RegisterUserResponse & __MetadataBearer; +/** + *

Creates an Amazon QuickSight user, whose identity is associated with the AWS Identity + * and Access Management (IAM) identity or role specified in the request.

+ */ export class RegisterUserCommand extends $Command< RegisterUserCommandInput, RegisterUserCommandOutput, @@ -34,6 +38,9 @@ export class RegisterUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/RestoreAnalysisCommand.ts b/clients/client-quicksight/commands/RestoreAnalysisCommand.ts index cf4b71627774c..5b4d9c9cdf8db 100644 --- a/clients/client-quicksight/commands/RestoreAnalysisCommand.ts +++ b/clients/client-quicksight/commands/RestoreAnalysisCommand.ts @@ -20,6 +20,9 @@ import { export type RestoreAnalysisCommandInput = RestoreAnalysisRequest; export type RestoreAnalysisCommandOutput = RestoreAnalysisResponse & __MetadataBearer; +/** + *

Restores an analysis.

+ */ export class RestoreAnalysisCommand extends $Command< RestoreAnalysisCommandInput, RestoreAnalysisCommandOutput, @@ -34,6 +37,9 @@ export class RestoreAnalysisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/SearchAnalysesCommand.ts b/clients/client-quicksight/commands/SearchAnalysesCommand.ts index 97666fa012ce7..8b57536bcee82 100644 --- a/clients/client-quicksight/commands/SearchAnalysesCommand.ts +++ b/clients/client-quicksight/commands/SearchAnalysesCommand.ts @@ -20,6 +20,9 @@ import { export type SearchAnalysesCommandInput = SearchAnalysesRequest; export type SearchAnalysesCommandOutput = SearchAnalysesResponse & __MetadataBearer; +/** + *

Searches for analyses that belong to the user specified in the filter.

+ */ export class SearchAnalysesCommand extends $Command< SearchAnalysesCommandInput, SearchAnalysesCommandOutput, @@ -34,6 +37,9 @@ export class SearchAnalysesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/SearchDashboardsCommand.ts b/clients/client-quicksight/commands/SearchDashboardsCommand.ts index ca5e55d2d81fa..0e883719c6954 100644 --- a/clients/client-quicksight/commands/SearchDashboardsCommand.ts +++ b/clients/client-quicksight/commands/SearchDashboardsCommand.ts @@ -20,6 +20,9 @@ import { export type SearchDashboardsCommandInput = SearchDashboardsRequest; export type SearchDashboardsCommandOutput = SearchDashboardsResponse & __MetadataBearer; +/** + *

Searches for dashboards that belong to a user.

+ */ export class SearchDashboardsCommand extends $Command< SearchDashboardsCommandInput, SearchDashboardsCommandOutput, @@ -34,6 +37,9 @@ export class SearchDashboardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/TagResourceCommand.ts b/clients/client-quicksight/commands/TagResourceCommand.ts index e036c191707e5..549e83046c97f 100644 --- a/clients/client-quicksight/commands/TagResourceCommand.ts +++ b/clients/client-quicksight/commands/TagResourceCommand.ts @@ -20,6 +20,30 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Assigns one or more tags (key-value pairs) to the specified QuickSight resource.

+ *

Tags can help you organize and categorize your resources. You can also use them to + * scope user permissions, by granting a user permission to access or change only resources + * with certain tag values. You can use the TagResource operation with a + * resource that already has tags. If you specify a new tag key for the resource, this tag + * is appended to the list of tags associated with the resource. If you specify a tag key + * that is already associated with the resource, the new tag value that you specify + * replaces the previous value for that tag.

+ *

You can associate as many as 50 tags with a resource. QuickSight supports tagging on data + * set, data source, dashboard, and template.

+ *

Tagging for QuickSight works in a similar way to tagging for other AWS services, except for + * the following:

+ *
    + *
  • + *

    You can't use tags to track AWS costs for QuickSight. This restriction is because QuickSight + * costs are based on users and SPICE capacity, which aren't taggable + * resources.

    + *
  • + *
  • + *

    QuickSight doesn't currently support the Tag Editor for AWS Resource Groups.

    + *
  • + *
+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +58,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UntagResourceCommand.ts b/clients/client-quicksight/commands/UntagResourceCommand.ts index d3edd69eb3144..a8d597d4a0218 100644 --- a/clients/client-quicksight/commands/UntagResourceCommand.ts +++ b/clients/client-quicksight/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes a tag or tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateAccountCustomizationCommand.ts b/clients/client-quicksight/commands/UpdateAccountCustomizationCommand.ts index a13a44681ee01..e883170a7d1bd 100644 --- a/clients/client-quicksight/commands/UpdateAccountCustomizationCommand.ts +++ b/clients/client-quicksight/commands/UpdateAccountCustomizationCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateAccountCustomizationCommandInput = UpdateAccountCustomizationRequest; export type UpdateAccountCustomizationCommandOutput = UpdateAccountCustomizationResponse & __MetadataBearer; +/** + *

Updates Amazon QuickSight customizations the current AWS Region. Currently, the only + * customization you can use is a theme.

+ *

You can use customizations for your AWS account or, if you specify a namespace, for a + * QuickSight namespace instead. Customizations that apply to a namespace override + * customizations that apply to an AWS account. To find out which customizations apply, use + * the DescribeAccountCustomization API operation.

+ */ export class UpdateAccountCustomizationCommand extends $Command< UpdateAccountCustomizationCommandInput, UpdateAccountCustomizationCommandOutput, @@ -34,6 +42,9 @@ export class UpdateAccountCustomizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateAccountSettingsCommand.ts b/clients/client-quicksight/commands/UpdateAccountSettingsCommand.ts index ba8d8cb938faa..6bbe97635f0a8 100644 --- a/clients/client-quicksight/commands/UpdateAccountSettingsCommand.ts +++ b/clients/client-quicksight/commands/UpdateAccountSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAccountSettingsCommandInput = UpdateAccountSettingsRequest; export type UpdateAccountSettingsCommandOutput = UpdateAccountSettingsResponse & __MetadataBearer; +/** + *

Updates the Amazon QuickSight settings in your AWS account.

+ */ export class UpdateAccountSettingsCommand extends $Command< UpdateAccountSettingsCommandInput, UpdateAccountSettingsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAccountSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateAnalysisCommand.ts b/clients/client-quicksight/commands/UpdateAnalysisCommand.ts index 81c3905a984ba..119e7ab2f783a 100644 --- a/clients/client-quicksight/commands/UpdateAnalysisCommand.ts +++ b/clients/client-quicksight/commands/UpdateAnalysisCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAnalysisCommandInput = UpdateAnalysisRequest; export type UpdateAnalysisCommandOutput = UpdateAnalysisResponse & __MetadataBearer; +/** + *

Updates an analysis in Amazon QuickSight

+ */ export class UpdateAnalysisCommand extends $Command< UpdateAnalysisCommandInput, UpdateAnalysisCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAnalysisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateAnalysisPermissionsCommand.ts b/clients/client-quicksight/commands/UpdateAnalysisPermissionsCommand.ts index 493f525fa971a..8f2eb6a49ff62 100644 --- a/clients/client-quicksight/commands/UpdateAnalysisPermissionsCommand.ts +++ b/clients/client-quicksight/commands/UpdateAnalysisPermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAnalysisPermissionsCommandInput = UpdateAnalysisPermissionsRequest; export type UpdateAnalysisPermissionsCommandOutput = UpdateAnalysisPermissionsResponse & __MetadataBearer; +/** + *

Updates the read and write permissions for an analysis.

+ */ export class UpdateAnalysisPermissionsCommand extends $Command< UpdateAnalysisPermissionsCommandInput, UpdateAnalysisPermissionsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAnalysisPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateDashboardCommand.ts b/clients/client-quicksight/commands/UpdateDashboardCommand.ts index 6bc6d2aaf3129..a7e4df89afab9 100644 --- a/clients/client-quicksight/commands/UpdateDashboardCommand.ts +++ b/clients/client-quicksight/commands/UpdateDashboardCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDashboardCommandInput = UpdateDashboardRequest; export type UpdateDashboardCommandOutput = UpdateDashboardResponse & __MetadataBearer; +/** + *

Updates a dashboard in an AWS account.

+ */ export class UpdateDashboardCommand extends $Command< UpdateDashboardCommandInput, UpdateDashboardCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDashboardCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateDashboardPermissionsCommand.ts b/clients/client-quicksight/commands/UpdateDashboardPermissionsCommand.ts index 3d87f394e3e19..52d7dd8600dba 100644 --- a/clients/client-quicksight/commands/UpdateDashboardPermissionsCommand.ts +++ b/clients/client-quicksight/commands/UpdateDashboardPermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDashboardPermissionsCommandInput = UpdateDashboardPermissionsRequest; export type UpdateDashboardPermissionsCommandOutput = UpdateDashboardPermissionsResponse & __MetadataBearer; +/** + *

Updates read and write permissions on a dashboard.

+ */ export class UpdateDashboardPermissionsCommand extends $Command< UpdateDashboardPermissionsCommandInput, UpdateDashboardPermissionsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDashboardPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateDashboardPublishedVersionCommand.ts b/clients/client-quicksight/commands/UpdateDashboardPublishedVersionCommand.ts index f38b962f40338..972340f88096e 100644 --- a/clients/client-quicksight/commands/UpdateDashboardPublishedVersionCommand.ts +++ b/clients/client-quicksight/commands/UpdateDashboardPublishedVersionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDashboardPublishedVersionCommandInput = UpdateDashboardPublishedVersionRequest; export type UpdateDashboardPublishedVersionCommandOutput = UpdateDashboardPublishedVersionResponse & __MetadataBearer; +/** + *

Updates the published version of a dashboard.

+ */ export class UpdateDashboardPublishedVersionCommand extends $Command< UpdateDashboardPublishedVersionCommandInput, UpdateDashboardPublishedVersionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDashboardPublishedVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateDataSetCommand.ts b/clients/client-quicksight/commands/UpdateDataSetCommand.ts index f5968feab174c..c4c2eaeeb2c02 100644 --- a/clients/client-quicksight/commands/UpdateDataSetCommand.ts +++ b/clients/client-quicksight/commands/UpdateDataSetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDataSetCommandInput = UpdateDataSetRequest; export type UpdateDataSetCommandOutput = UpdateDataSetResponse & __MetadataBearer; +/** + *

Updates a dataset.

+ */ export class UpdateDataSetCommand extends $Command< UpdateDataSetCommandInput, UpdateDataSetCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDataSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateDataSetPermissionsCommand.ts b/clients/client-quicksight/commands/UpdateDataSetPermissionsCommand.ts index 31c5f6871b304..dc737b286b7fc 100644 --- a/clients/client-quicksight/commands/UpdateDataSetPermissionsCommand.ts +++ b/clients/client-quicksight/commands/UpdateDataSetPermissionsCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDataSetPermissionsCommandInput = UpdateDataSetPermissionsRequest; export type UpdateDataSetPermissionsCommandOutput = UpdateDataSetPermissionsResponse & __MetadataBearer; +/** + *

Updates the permissions on a dataset.

+ *

The permissions resource is arn:aws:quicksight:region:aws-account-id:dataset/data-set-id.

+ */ export class UpdateDataSetPermissionsCommand extends $Command< UpdateDataSetPermissionsCommandInput, UpdateDataSetPermissionsCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDataSetPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateDataSourceCommand.ts b/clients/client-quicksight/commands/UpdateDataSourceCommand.ts index 48348f6aa8869..02313a52501cb 100644 --- a/clients/client-quicksight/commands/UpdateDataSourceCommand.ts +++ b/clients/client-quicksight/commands/UpdateDataSourceCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDataSourceCommandInput = UpdateDataSourceRequest; export type UpdateDataSourceCommandOutput = UpdateDataSourceResponse & __MetadataBearer; +/** + *

Updates a data source.

+ */ export class UpdateDataSourceCommand extends $Command< UpdateDataSourceCommandInput, UpdateDataSourceCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDataSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateDataSourcePermissionsCommand.ts b/clients/client-quicksight/commands/UpdateDataSourcePermissionsCommand.ts index 31f0ecc3cebfa..6a36daf40a194 100644 --- a/clients/client-quicksight/commands/UpdateDataSourcePermissionsCommand.ts +++ b/clients/client-quicksight/commands/UpdateDataSourcePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDataSourcePermissionsCommandInput = UpdateDataSourcePermissionsRequest; export type UpdateDataSourcePermissionsCommandOutput = UpdateDataSourcePermissionsResponse & __MetadataBearer; +/** + *

Updates the permissions to a data source.

+ */ export class UpdateDataSourcePermissionsCommand extends $Command< UpdateDataSourcePermissionsCommandInput, UpdateDataSourcePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDataSourcePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateGroupCommand.ts b/clients/client-quicksight/commands/UpdateGroupCommand.ts index 5ba5c9fcf4157..b25160cf3e39a 100644 --- a/clients/client-quicksight/commands/UpdateGroupCommand.ts +++ b/clients/client-quicksight/commands/UpdateGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGroupCommandInput = UpdateGroupRequest; export type UpdateGroupCommandOutput = UpdateGroupResponse & __MetadataBearer; +/** + *

Changes a group description.

+ */ export class UpdateGroupCommand extends $Command< UpdateGroupCommandInput, UpdateGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateIAMPolicyAssignmentCommand.ts b/clients/client-quicksight/commands/UpdateIAMPolicyAssignmentCommand.ts index b8f0df86219e4..70a9a58ab7591 100644 --- a/clients/client-quicksight/commands/UpdateIAMPolicyAssignmentCommand.ts +++ b/clients/client-quicksight/commands/UpdateIAMPolicyAssignmentCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateIAMPolicyAssignmentCommandInput = UpdateIAMPolicyAssignmentRequest; export type UpdateIAMPolicyAssignmentCommandOutput = UpdateIAMPolicyAssignmentResponse & __MetadataBearer; +/** + *

Updates an existing IAM policy assignment. This operation updates only the optional + * parameter or parameters that are specified in the request. + * This overwrites all of the users included in Identities. + *

+ */ export class UpdateIAMPolicyAssignmentCommand extends $Command< UpdateIAMPolicyAssignmentCommandInput, UpdateIAMPolicyAssignmentCommandOutput, @@ -34,6 +40,9 @@ export class UpdateIAMPolicyAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateTemplateAliasCommand.ts b/clients/client-quicksight/commands/UpdateTemplateAliasCommand.ts index 2d89ffd45e8c5..92f64a3cc6da9 100644 --- a/clients/client-quicksight/commands/UpdateTemplateAliasCommand.ts +++ b/clients/client-quicksight/commands/UpdateTemplateAliasCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTemplateAliasCommandInput = UpdateTemplateAliasRequest; export type UpdateTemplateAliasCommandOutput = UpdateTemplateAliasResponse & __MetadataBearer; +/** + *

Updates the template alias of a template.

+ */ export class UpdateTemplateAliasCommand extends $Command< UpdateTemplateAliasCommandInput, UpdateTemplateAliasCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTemplateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateTemplateCommand.ts b/clients/client-quicksight/commands/UpdateTemplateCommand.ts index 93b071f5ea094..a71c90e417a4b 100644 --- a/clients/client-quicksight/commands/UpdateTemplateCommand.ts +++ b/clients/client-quicksight/commands/UpdateTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTemplateCommandInput = UpdateTemplateRequest; export type UpdateTemplateCommandOutput = UpdateTemplateResponse & __MetadataBearer; +/** + *

Updates a template from an existing Amazon QuickSight analysis or another template.

+ */ export class UpdateTemplateCommand extends $Command< UpdateTemplateCommandInput, UpdateTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateTemplatePermissionsCommand.ts b/clients/client-quicksight/commands/UpdateTemplatePermissionsCommand.ts index ffeebe0bb0235..01ec16c5979cb 100644 --- a/clients/client-quicksight/commands/UpdateTemplatePermissionsCommand.ts +++ b/clients/client-quicksight/commands/UpdateTemplatePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTemplatePermissionsCommandInput = UpdateTemplatePermissionsRequest; export type UpdateTemplatePermissionsCommandOutput = UpdateTemplatePermissionsResponse & __MetadataBearer; +/** + *

Updates the resource permissions for a template.

+ */ export class UpdateTemplatePermissionsCommand extends $Command< UpdateTemplatePermissionsCommandInput, UpdateTemplatePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTemplatePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateThemeAliasCommand.ts b/clients/client-quicksight/commands/UpdateThemeAliasCommand.ts index 739c7a6f599ea..55d51dcceb448 100644 --- a/clients/client-quicksight/commands/UpdateThemeAliasCommand.ts +++ b/clients/client-quicksight/commands/UpdateThemeAliasCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateThemeAliasCommandInput = UpdateThemeAliasRequest; export type UpdateThemeAliasCommandOutput = UpdateThemeAliasResponse & __MetadataBearer; +/** + *

Updates an alias of a theme.

+ */ export class UpdateThemeAliasCommand extends $Command< UpdateThemeAliasCommandInput, UpdateThemeAliasCommandOutput, @@ -34,6 +37,9 @@ export class UpdateThemeAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateThemeCommand.ts b/clients/client-quicksight/commands/UpdateThemeCommand.ts index 54da57a8464bd..ae3cd2e3f6fb2 100644 --- a/clients/client-quicksight/commands/UpdateThemeCommand.ts +++ b/clients/client-quicksight/commands/UpdateThemeCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateThemeCommandInput = UpdateThemeRequest; export type UpdateThemeCommandOutput = UpdateThemeResponse & __MetadataBearer; +/** + *

Updates a theme.

+ */ export class UpdateThemeCommand extends $Command< UpdateThemeCommandInput, UpdateThemeCommandOutput, @@ -34,6 +37,9 @@ export class UpdateThemeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateThemePermissionsCommand.ts b/clients/client-quicksight/commands/UpdateThemePermissionsCommand.ts index 8bd1fc54e2161..04fad4a57bf67 100644 --- a/clients/client-quicksight/commands/UpdateThemePermissionsCommand.ts +++ b/clients/client-quicksight/commands/UpdateThemePermissionsCommand.ts @@ -20,6 +20,102 @@ import { export type UpdateThemePermissionsCommandInput = UpdateThemePermissionsRequest; export type UpdateThemePermissionsCommandOutput = UpdateThemePermissionsResponse & __MetadataBearer; +/** + *

Updates the resource permissions for a theme. Permissions apply to the action to grant or + * revoke permissions on, for example "quicksight:DescribeTheme".

+ *

Theme permissions apply in groupings. Valid groupings include the following for the three + * levels of permissions, which are user, owner, or no permissions:

+ *
    + *
  • + *

    User

    + *
      + *
    • + *

      + * "quicksight:DescribeTheme" + *

      + *
    • + *
    • + *

      + * "quicksight:DescribeThemeAlias" + *

      + *
    • + *
    • + *

      + * "quicksight:ListThemeAliases" + *

      + *
    • + *
    • + *

      + * "quicksight:ListThemeVersions" + *

      + *
    • + *
    + *
  • + *
  • + *

    Owner

    + *
      + *
    • + *

      + * "quicksight:DescribeTheme" + *

      + *
    • + *
    • + *

      + * "quicksight:DescribeThemeAlias" + *

      + *
    • + *
    • + *

      + * "quicksight:ListThemeAliases" + *

      + *
    • + *
    • + *

      + * "quicksight:ListThemeVersions" + *

      + *
    • + *
    • + *

      + * "quicksight:DeleteTheme" + *

      + *
    • + *
    • + *

      + * "quicksight:UpdateTheme" + *

      + *
    • + *
    • + *

      + * "quicksight:CreateThemeAlias" + *

      + *
    • + *
    • + *

      + * "quicksight:DeleteThemeAlias" + *

      + *
    • + *
    • + *

      + * "quicksight:UpdateThemeAlias" + *

      + *
    • + *
    • + *

      + * "quicksight:UpdateThemePermissions" + *

      + *
    • + *
    • + *

      + * "quicksight:DescribeThemePermissions" + *

      + *
    • + *
    + *
  • + *
  • + *

    To specify no permissions, omit the permissions list.

    + *
  • + *
+ */ export class UpdateThemePermissionsCommand extends $Command< UpdateThemePermissionsCommandInput, UpdateThemePermissionsCommandOutput, @@ -34,6 +130,9 @@ export class UpdateThemePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/commands/UpdateUserCommand.ts b/clients/client-quicksight/commands/UpdateUserCommand.ts index 887ffb7bb04aa..bd37262be157e 100644 --- a/clients/client-quicksight/commands/UpdateUserCommand.ts +++ b/clients/client-quicksight/commands/UpdateUserCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserCommandInput = UpdateUserRequest; export type UpdateUserCommandOutput = UpdateUserResponse & __MetadataBearer; +/** + *

Updates an Amazon QuickSight user.

+ */ export class UpdateUserCommand extends $Command< UpdateUserCommandInput, UpdateUserCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QuickSightClientResolvedConfig, diff --git a/clients/client-quicksight/package.json b/clients/client-quicksight/package.json index 019056f1d7ab5..314b631a4610b 100644 --- a/clients/client-quicksight/package.json +++ b/clients/client-quicksight/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Quicksight Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-quicksight/pagination/ListAnalysesPaginator.ts b/clients/client-quicksight/pagination/ListAnalysesPaginator.ts index af779a71a60ae..0c9ac70e42570 100644 --- a/clients/client-quicksight/pagination/ListAnalysesPaginator.ts +++ b/clients/client-quicksight/pagination/ListAnalysesPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListAnalysesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAnalysesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListAnalysesCommandInput, diff --git a/clients/client-quicksight/pagination/ListDashboardVersionsPaginator.ts b/clients/client-quicksight/pagination/ListDashboardVersionsPaginator.ts index 67d5f94139acd..72a7f7d3c82c5 100644 --- a/clients/client-quicksight/pagination/ListDashboardVersionsPaginator.ts +++ b/clients/client-quicksight/pagination/ListDashboardVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListDashboardVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDashboardVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListDashboardVersionsCommandInput, diff --git a/clients/client-quicksight/pagination/ListDashboardsPaginator.ts b/clients/client-quicksight/pagination/ListDashboardsPaginator.ts index f17a352d2b84a..1605b56be9e3c 100644 --- a/clients/client-quicksight/pagination/ListDashboardsPaginator.ts +++ b/clients/client-quicksight/pagination/ListDashboardsPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListDashboardsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDashboardsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListDashboardsCommandInput, diff --git a/clients/client-quicksight/pagination/ListDataSetsPaginator.ts b/clients/client-quicksight/pagination/ListDataSetsPaginator.ts index 5702b95673fa2..443dd1d077b69 100644 --- a/clients/client-quicksight/pagination/ListDataSetsPaginator.ts +++ b/clients/client-quicksight/pagination/ListDataSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListDataSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDataSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListDataSetsCommandInput, diff --git a/clients/client-quicksight/pagination/ListDataSourcesPaginator.ts b/clients/client-quicksight/pagination/ListDataSourcesPaginator.ts index aa9d1cb71dc7d..466e6d4cf76db 100644 --- a/clients/client-quicksight/pagination/ListDataSourcesPaginator.ts +++ b/clients/client-quicksight/pagination/ListDataSourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListDataSourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDataSourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListDataSourcesCommandInput, diff --git a/clients/client-quicksight/pagination/ListIngestionsPaginator.ts b/clients/client-quicksight/pagination/ListIngestionsPaginator.ts index a5a4b4cb030bf..dcd4134556797 100644 --- a/clients/client-quicksight/pagination/ListIngestionsPaginator.ts +++ b/clients/client-quicksight/pagination/ListIngestionsPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListIngestionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListIngestionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListIngestionsCommandInput, diff --git a/clients/client-quicksight/pagination/ListNamespacesPaginator.ts b/clients/client-quicksight/pagination/ListNamespacesPaginator.ts index 36b68c0376fa3..c1f50dcb8f52f 100644 --- a/clients/client-quicksight/pagination/ListNamespacesPaginator.ts +++ b/clients/client-quicksight/pagination/ListNamespacesPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListNamespacesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNamespacesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListNamespacesCommandInput, diff --git a/clients/client-quicksight/pagination/ListTemplateAliasesPaginator.ts b/clients/client-quicksight/pagination/ListTemplateAliasesPaginator.ts index 34e06f1ea33fe..6f94867f38ac1 100644 --- a/clients/client-quicksight/pagination/ListTemplateAliasesPaginator.ts +++ b/clients/client-quicksight/pagination/ListTemplateAliasesPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListTemplateAliasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTemplateAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListTemplateAliasesCommandInput, diff --git a/clients/client-quicksight/pagination/ListTemplateVersionsPaginator.ts b/clients/client-quicksight/pagination/ListTemplateVersionsPaginator.ts index 4054e5fbc9120..dd87cbed6aa12 100644 --- a/clients/client-quicksight/pagination/ListTemplateVersionsPaginator.ts +++ b/clients/client-quicksight/pagination/ListTemplateVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListTemplateVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTemplateVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListTemplateVersionsCommandInput, diff --git a/clients/client-quicksight/pagination/ListTemplatesPaginator.ts b/clients/client-quicksight/pagination/ListTemplatesPaginator.ts index 064af4daf3d13..6ec5aaa1a1c75 100644 --- a/clients/client-quicksight/pagination/ListTemplatesPaginator.ts +++ b/clients/client-quicksight/pagination/ListTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: ListTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: ListTemplatesCommandInput, diff --git a/clients/client-quicksight/pagination/SearchAnalysesPaginator.ts b/clients/client-quicksight/pagination/SearchAnalysesPaginator.ts index 6833b4ebfae8b..5da43c59eb95b 100644 --- a/clients/client-quicksight/pagination/SearchAnalysesPaginator.ts +++ b/clients/client-quicksight/pagination/SearchAnalysesPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: SearchAnalysesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchAnalysesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: SearchAnalysesCommandInput, diff --git a/clients/client-quicksight/pagination/SearchDashboardsPaginator.ts b/clients/client-quicksight/pagination/SearchDashboardsPaginator.ts index 2aa7cbf8c4b65..9c19f9c3ce67f 100644 --- a/clients/client-quicksight/pagination/SearchDashboardsPaginator.ts +++ b/clients/client-quicksight/pagination/SearchDashboardsPaginator.ts @@ -8,6 +8,9 @@ import { import { QuickSightPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: QuickSightClient, input: SearchDashboardsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchDashboardsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: QuickSight, input: SearchDashboardsCommandInput, diff --git a/clients/client-quicksight/runtimeConfig.browser.ts b/clients/client-quicksight/runtimeConfig.browser.ts index fb23f52935c83..5ab4997759e91 100644 --- a/clients/client-quicksight/runtimeConfig.browser.ts +++ b/clients/client-quicksight/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./QuickSightClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-quicksight/runtimeConfig.native.ts b/clients/client-quicksight/runtimeConfig.native.ts index 8839b31773661..4a75770c25026 100644 --- a/clients/client-quicksight/runtimeConfig.native.ts +++ b/clients/client-quicksight/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./QuickSightClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-quicksight/runtimeConfig.shared.ts b/clients/client-quicksight/runtimeConfig.shared.ts index 89816918d6b8b..fa6717e9354e7 100644 --- a/clients/client-quicksight/runtimeConfig.shared.ts +++ b/clients/client-quicksight/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-04-01", disableHostPrefix: false, diff --git a/clients/client-quicksight/runtimeConfig.ts b/clients/client-quicksight/runtimeConfig.ts index ee070c0ddb2e5..79d6ad23426bb 100644 --- a/clients/client-quicksight/runtimeConfig.ts +++ b/clients/client-quicksight/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./QuickSightClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-quicksight/tsconfig.json b/clients/client-quicksight/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-quicksight/tsconfig.json +++ b/clients/client-quicksight/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ram/commands/AcceptResourceShareInvitationCommand.ts b/clients/client-ram/commands/AcceptResourceShareInvitationCommand.ts index 1a9d62b7b282f..5877543d0ada1 100644 --- a/clients/client-ram/commands/AcceptResourceShareInvitationCommand.ts +++ b/clients/client-ram/commands/AcceptResourceShareInvitationCommand.ts @@ -20,6 +20,9 @@ import { export type AcceptResourceShareInvitationCommandInput = AcceptResourceShareInvitationRequest; export type AcceptResourceShareInvitationCommandOutput = AcceptResourceShareInvitationResponse & __MetadataBearer; +/** + *

Accepts an invitation to a resource share from another AWS account.

+ */ export class AcceptResourceShareInvitationCommand extends $Command< AcceptResourceShareInvitationCommandInput, AcceptResourceShareInvitationCommandOutput, @@ -34,6 +37,9 @@ export class AcceptResourceShareInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/AssociateResourceShareCommand.ts b/clients/client-ram/commands/AssociateResourceShareCommand.ts index cf7b589a4c71e..6554d08db5bfd 100644 --- a/clients/client-ram/commands/AssociateResourceShareCommand.ts +++ b/clients/client-ram/commands/AssociateResourceShareCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateResourceShareCommandInput = AssociateResourceShareRequest; export type AssociateResourceShareCommandOutput = AssociateResourceShareResponse & __MetadataBearer; +/** + *

Associates the specified resource share with the specified principals and resources.

+ */ export class AssociateResourceShareCommand extends $Command< AssociateResourceShareCommandInput, AssociateResourceShareCommandOutput, @@ -34,6 +37,9 @@ export class AssociateResourceShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/AssociateResourceSharePermissionCommand.ts b/clients/client-ram/commands/AssociateResourceSharePermissionCommand.ts index dc889c0febf88..7404312c80538 100644 --- a/clients/client-ram/commands/AssociateResourceSharePermissionCommand.ts +++ b/clients/client-ram/commands/AssociateResourceSharePermissionCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateResourceSharePermissionCommandInput = AssociateResourceSharePermissionRequest; export type AssociateResourceSharePermissionCommandOutput = AssociateResourceSharePermissionResponse & __MetadataBearer; +/** + *

Associates a permission with a resource share.

+ */ export class AssociateResourceSharePermissionCommand extends $Command< AssociateResourceSharePermissionCommandInput, AssociateResourceSharePermissionCommandOutput, @@ -34,6 +37,9 @@ export class AssociateResourceSharePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/CreateResourceShareCommand.ts b/clients/client-ram/commands/CreateResourceShareCommand.ts index 5d65ca7502b27..b96d604a411fe 100644 --- a/clients/client-ram/commands/CreateResourceShareCommand.ts +++ b/clients/client-ram/commands/CreateResourceShareCommand.ts @@ -20,6 +20,9 @@ import { export type CreateResourceShareCommandInput = CreateResourceShareRequest; export type CreateResourceShareCommandOutput = CreateResourceShareResponse & __MetadataBearer; +/** + *

Creates a resource share.

+ */ export class CreateResourceShareCommand extends $Command< CreateResourceShareCommandInput, CreateResourceShareCommandOutput, @@ -34,6 +37,9 @@ export class CreateResourceShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/DeleteResourceShareCommand.ts b/clients/client-ram/commands/DeleteResourceShareCommand.ts index 9d9b230eebf1b..b620613dc9a9e 100644 --- a/clients/client-ram/commands/DeleteResourceShareCommand.ts +++ b/clients/client-ram/commands/DeleteResourceShareCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourceShareCommandInput = DeleteResourceShareRequest; export type DeleteResourceShareCommandOutput = DeleteResourceShareResponse & __MetadataBearer; +/** + *

Deletes the specified resource share.

+ */ export class DeleteResourceShareCommand extends $Command< DeleteResourceShareCommandInput, DeleteResourceShareCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourceShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/DisassociateResourceShareCommand.ts b/clients/client-ram/commands/DisassociateResourceShareCommand.ts index 52968abed4aea..f43153a263e39 100644 --- a/clients/client-ram/commands/DisassociateResourceShareCommand.ts +++ b/clients/client-ram/commands/DisassociateResourceShareCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateResourceShareCommandInput = DisassociateResourceShareRequest; export type DisassociateResourceShareCommandOutput = DisassociateResourceShareResponse & __MetadataBearer; +/** + *

Disassociates the specified principals or resources from the specified resource share.

+ */ export class DisassociateResourceShareCommand extends $Command< DisassociateResourceShareCommandInput, DisassociateResourceShareCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateResourceShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/DisassociateResourceSharePermissionCommand.ts b/clients/client-ram/commands/DisassociateResourceSharePermissionCommand.ts index c698b9565b72a..b087ebdc701d4 100644 --- a/clients/client-ram/commands/DisassociateResourceSharePermissionCommand.ts +++ b/clients/client-ram/commands/DisassociateResourceSharePermissionCommand.ts @@ -24,6 +24,9 @@ export type DisassociateResourceSharePermissionCommandInput = DisassociateResour export type DisassociateResourceSharePermissionCommandOutput = DisassociateResourceSharePermissionResponse & __MetadataBearer; +/** + *

Disassociates an AWS RAM permission from a resource share.

+ */ export class DisassociateResourceSharePermissionCommand extends $Command< DisassociateResourceSharePermissionCommandInput, DisassociateResourceSharePermissionCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateResourceSharePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/EnableSharingWithAwsOrganizationCommand.ts b/clients/client-ram/commands/EnableSharingWithAwsOrganizationCommand.ts index 9d0a0672ea7e5..ed6829a672ba4 100644 --- a/clients/client-ram/commands/EnableSharingWithAwsOrganizationCommand.ts +++ b/clients/client-ram/commands/EnableSharingWithAwsOrganizationCommand.ts @@ -20,6 +20,10 @@ import { export type EnableSharingWithAwsOrganizationCommandInput = EnableSharingWithAwsOrganizationRequest; export type EnableSharingWithAwsOrganizationCommandOutput = EnableSharingWithAwsOrganizationResponse & __MetadataBearer; +/** + *

Enables resource sharing within your AWS Organization.

+ *

The caller must be the master account for the AWS Organization.

+ */ export class EnableSharingWithAwsOrganizationCommand extends $Command< EnableSharingWithAwsOrganizationCommandInput, EnableSharingWithAwsOrganizationCommandOutput, @@ -34,6 +38,9 @@ export class EnableSharingWithAwsOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/GetPermissionCommand.ts b/clients/client-ram/commands/GetPermissionCommand.ts index 79a0862ef247f..b7cfabba41ddc 100644 --- a/clients/client-ram/commands/GetPermissionCommand.ts +++ b/clients/client-ram/commands/GetPermissionCommand.ts @@ -20,6 +20,9 @@ import { export type GetPermissionCommandInput = GetPermissionRequest; export type GetPermissionCommandOutput = GetPermissionResponse & __MetadataBearer; +/** + *

Gets the contents of an AWS RAM permission in JSON format.

+ */ export class GetPermissionCommand extends $Command< GetPermissionCommandInput, GetPermissionCommandOutput, @@ -34,6 +37,9 @@ export class GetPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/GetResourcePoliciesCommand.ts b/clients/client-ram/commands/GetResourcePoliciesCommand.ts index 666b7e673b782..224d013b713d1 100644 --- a/clients/client-ram/commands/GetResourcePoliciesCommand.ts +++ b/clients/client-ram/commands/GetResourcePoliciesCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourcePoliciesCommandInput = GetResourcePoliciesRequest; export type GetResourcePoliciesCommandOutput = GetResourcePoliciesResponse & __MetadataBearer; +/** + *

Gets the policies for the specified resources that you own and have shared.

+ */ export class GetResourcePoliciesCommand extends $Command< GetResourcePoliciesCommandInput, GetResourcePoliciesCommandOutput, @@ -34,6 +37,9 @@ export class GetResourcePoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/GetResourceShareAssociationsCommand.ts b/clients/client-ram/commands/GetResourceShareAssociationsCommand.ts index f5ae21a51229c..6d26e732ad80d 100644 --- a/clients/client-ram/commands/GetResourceShareAssociationsCommand.ts +++ b/clients/client-ram/commands/GetResourceShareAssociationsCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourceShareAssociationsCommandInput = GetResourceShareAssociationsRequest; export type GetResourceShareAssociationsCommandOutput = GetResourceShareAssociationsResponse & __MetadataBearer; +/** + *

Gets the resources or principals for the resource shares that you own.

+ */ export class GetResourceShareAssociationsCommand extends $Command< GetResourceShareAssociationsCommandInput, GetResourceShareAssociationsCommandOutput, @@ -34,6 +37,9 @@ export class GetResourceShareAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/GetResourceShareInvitationsCommand.ts b/clients/client-ram/commands/GetResourceShareInvitationsCommand.ts index 89d5353cfb5de..c3ac1ccfa4709 100644 --- a/clients/client-ram/commands/GetResourceShareInvitationsCommand.ts +++ b/clients/client-ram/commands/GetResourceShareInvitationsCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourceShareInvitationsCommandInput = GetResourceShareInvitationsRequest; export type GetResourceShareInvitationsCommandOutput = GetResourceShareInvitationsResponse & __MetadataBearer; +/** + *

Gets the invitations for resource sharing that you've received.

+ */ export class GetResourceShareInvitationsCommand extends $Command< GetResourceShareInvitationsCommandInput, GetResourceShareInvitationsCommandOutput, @@ -34,6 +37,9 @@ export class GetResourceShareInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/GetResourceSharesCommand.ts b/clients/client-ram/commands/GetResourceSharesCommand.ts index c07e24f9a0301..1af0b10870166 100644 --- a/clients/client-ram/commands/GetResourceSharesCommand.ts +++ b/clients/client-ram/commands/GetResourceSharesCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourceSharesCommandInput = GetResourceSharesRequest; export type GetResourceSharesCommandOutput = GetResourceSharesResponse & __MetadataBearer; +/** + *

Gets the resource shares that you own or the resource shares that are shared with you.

+ */ export class GetResourceSharesCommand extends $Command< GetResourceSharesCommandInput, GetResourceSharesCommandOutput, @@ -34,6 +37,9 @@ export class GetResourceSharesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/ListPendingInvitationResourcesCommand.ts b/clients/client-ram/commands/ListPendingInvitationResourcesCommand.ts index 1c40bfe037255..a5ca2ddcc3f64 100644 --- a/clients/client-ram/commands/ListPendingInvitationResourcesCommand.ts +++ b/clients/client-ram/commands/ListPendingInvitationResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListPendingInvitationResourcesCommandInput = ListPendingInvitationResourcesRequest; export type ListPendingInvitationResourcesCommandOutput = ListPendingInvitationResourcesResponse & __MetadataBearer; +/** + *

Lists the resources in a resource share that is shared with you but that the invitation is still pending for.

+ */ export class ListPendingInvitationResourcesCommand extends $Command< ListPendingInvitationResourcesCommandInput, ListPendingInvitationResourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListPendingInvitationResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/ListPermissionsCommand.ts b/clients/client-ram/commands/ListPermissionsCommand.ts index 22724aae2e8f5..dfb1e136669c2 100644 --- a/clients/client-ram/commands/ListPermissionsCommand.ts +++ b/clients/client-ram/commands/ListPermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPermissionsCommandInput = ListPermissionsRequest; export type ListPermissionsCommandOutput = ListPermissionsResponse & __MetadataBearer; +/** + *

Lists the AWS RAM permissions.

+ */ export class ListPermissionsCommand extends $Command< ListPermissionsCommandInput, ListPermissionsCommandOutput, @@ -34,6 +37,9 @@ export class ListPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/ListPrincipalsCommand.ts b/clients/client-ram/commands/ListPrincipalsCommand.ts index 846d8c59e4865..6d83fda5be74c 100644 --- a/clients/client-ram/commands/ListPrincipalsCommand.ts +++ b/clients/client-ram/commands/ListPrincipalsCommand.ts @@ -20,6 +20,10 @@ import { export type ListPrincipalsCommandInput = ListPrincipalsRequest; export type ListPrincipalsCommandOutput = ListPrincipalsResponse & __MetadataBearer; +/** + *

Lists the principals that you have shared resources with or that have shared resources + * with you.

+ */ export class ListPrincipalsCommand extends $Command< ListPrincipalsCommandInput, ListPrincipalsCommandOutput, @@ -34,6 +38,9 @@ export class ListPrincipalsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/ListResourceSharePermissionsCommand.ts b/clients/client-ram/commands/ListResourceSharePermissionsCommand.ts index ae9b4e0c95b3b..9958831138c27 100644 --- a/clients/client-ram/commands/ListResourceSharePermissionsCommand.ts +++ b/clients/client-ram/commands/ListResourceSharePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourceSharePermissionsCommandInput = ListResourceSharePermissionsRequest; export type ListResourceSharePermissionsCommandOutput = ListResourceSharePermissionsResponse & __MetadataBearer; +/** + *

Lists the AWS RAM permissions that are associated with a resource share.

+ */ export class ListResourceSharePermissionsCommand extends $Command< ListResourceSharePermissionsCommandInput, ListResourceSharePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class ListResourceSharePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/ListResourceTypesCommand.ts b/clients/client-ram/commands/ListResourceTypesCommand.ts index 2213c536d74b8..350aecf604276 100644 --- a/clients/client-ram/commands/ListResourceTypesCommand.ts +++ b/clients/client-ram/commands/ListResourceTypesCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourceTypesCommandInput = ListResourceTypesRequest; export type ListResourceTypesCommandOutput = ListResourceTypesResponse & __MetadataBearer; +/** + *

Lists the shareable resource types supported by AWS RAM.

+ */ export class ListResourceTypesCommand extends $Command< ListResourceTypesCommandInput, ListResourceTypesCommandOutput, @@ -34,6 +37,9 @@ export class ListResourceTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/ListResourcesCommand.ts b/clients/client-ram/commands/ListResourcesCommand.ts index 0c931aef2c39c..16c5c963a3d9f 100644 --- a/clients/client-ram/commands/ListResourcesCommand.ts +++ b/clients/client-ram/commands/ListResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourcesCommandInput = ListResourcesRequest; export type ListResourcesCommandOutput = ListResourcesResponse & __MetadataBearer; +/** + *

Lists the resources that you added to a resource shares or the resources that are shared with you.

+ */ export class ListResourcesCommand extends $Command< ListResourcesCommandInput, ListResourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/PromoteResourceShareCreatedFromPolicyCommand.ts b/clients/client-ram/commands/PromoteResourceShareCreatedFromPolicyCommand.ts index 3eb2d059c9791..b0fb44156ad1d 100644 --- a/clients/client-ram/commands/PromoteResourceShareCreatedFromPolicyCommand.ts +++ b/clients/client-ram/commands/PromoteResourceShareCreatedFromPolicyCommand.ts @@ -24,6 +24,21 @@ export type PromoteResourceShareCreatedFromPolicyCommandInput = PromoteResourceS export type PromoteResourceShareCreatedFromPolicyCommandOutput = PromoteResourceShareCreatedFromPolicyResponse & __MetadataBearer; +/** + *

Resource shares that were created by attaching a policy to a resource are visible only to + * the resource share owner, and the resource share cannot be modified in AWS RAM.

+ * + *

Use this API action to promote the resource share. When you promote the resource share, + * it becomes:

+ *
    + *
  • + *

    Visible to all principals that it is shared with.

    + *
  • + *
  • + *

    Modifiable in AWS RAM.

    + *
  • + *
+ */ export class PromoteResourceShareCreatedFromPolicyCommand extends $Command< PromoteResourceShareCreatedFromPolicyCommandInput, PromoteResourceShareCreatedFromPolicyCommandOutput, @@ -38,6 +53,9 @@ export class PromoteResourceShareCreatedFromPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/RejectResourceShareInvitationCommand.ts b/clients/client-ram/commands/RejectResourceShareInvitationCommand.ts index fa488bb765b8f..ee2009d47719f 100644 --- a/clients/client-ram/commands/RejectResourceShareInvitationCommand.ts +++ b/clients/client-ram/commands/RejectResourceShareInvitationCommand.ts @@ -20,6 +20,9 @@ import { export type RejectResourceShareInvitationCommandInput = RejectResourceShareInvitationRequest; export type RejectResourceShareInvitationCommandOutput = RejectResourceShareInvitationResponse & __MetadataBearer; +/** + *

Rejects an invitation to a resource share from another AWS account.

+ */ export class RejectResourceShareInvitationCommand extends $Command< RejectResourceShareInvitationCommandInput, RejectResourceShareInvitationCommandOutput, @@ -34,6 +37,9 @@ export class RejectResourceShareInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/TagResourceCommand.ts b/clients/client-ram/commands/TagResourceCommand.ts index 7797e47e5c30f..1037bf946c152 100644 --- a/clients/client-ram/commands/TagResourceCommand.ts +++ b/clients/client-ram/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds the specified tags to the specified resource share that you own.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/UntagResourceCommand.ts b/clients/client-ram/commands/UntagResourceCommand.ts index ea019b447a9d8..97142601763c2 100644 --- a/clients/client-ram/commands/UntagResourceCommand.ts +++ b/clients/client-ram/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the specified tags from the specified resource share that you own.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/commands/UpdateResourceShareCommand.ts b/clients/client-ram/commands/UpdateResourceShareCommand.ts index 725f40ac99b73..b1b525471e45e 100644 --- a/clients/client-ram/commands/UpdateResourceShareCommand.ts +++ b/clients/client-ram/commands/UpdateResourceShareCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateResourceShareCommandInput = UpdateResourceShareRequest; export type UpdateResourceShareCommandOutput = UpdateResourceShareResponse & __MetadataBearer; +/** + *

Updates the specified resource share that you own.

+ */ export class UpdateResourceShareCommand extends $Command< UpdateResourceShareCommandInput, UpdateResourceShareCommandOutput, @@ -34,6 +37,9 @@ export class UpdateResourceShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RAMClientResolvedConfig, diff --git a/clients/client-ram/package.json b/clients/client-ram/package.json index 41848695d9ee6..787875f29423c 100644 --- a/clients/client-ram/package.json +++ b/clients/client-ram/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ram Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ram/pagination/GetResourcePoliciesPaginator.ts b/clients/client-ram/pagination/GetResourcePoliciesPaginator.ts index 1841ff63ee460..6e06be98cf638 100644 --- a/clients/client-ram/pagination/GetResourcePoliciesPaginator.ts +++ b/clients/client-ram/pagination/GetResourcePoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { RAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RAMClient, input: GetResourcePoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetResourcePoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RAM, input: GetResourcePoliciesCommandInput, diff --git a/clients/client-ram/pagination/GetResourceShareAssociationsPaginator.ts b/clients/client-ram/pagination/GetResourceShareAssociationsPaginator.ts index 77b1d6581a2e4..118ca99182b60 100644 --- a/clients/client-ram/pagination/GetResourceShareAssociationsPaginator.ts +++ b/clients/client-ram/pagination/GetResourceShareAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { RAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RAMClient, input: GetResourceShareAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetResourceShareAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RAM, input: GetResourceShareAssociationsCommandInput, diff --git a/clients/client-ram/pagination/GetResourceShareInvitationsPaginator.ts b/clients/client-ram/pagination/GetResourceShareInvitationsPaginator.ts index 32ddae13fe7b3..aa35919e1136b 100644 --- a/clients/client-ram/pagination/GetResourceShareInvitationsPaginator.ts +++ b/clients/client-ram/pagination/GetResourceShareInvitationsPaginator.ts @@ -8,6 +8,9 @@ import { import { RAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RAMClient, input: GetResourceShareInvitationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetResourceShareInvitationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RAM, input: GetResourceShareInvitationsCommandInput, diff --git a/clients/client-ram/pagination/GetResourceSharesPaginator.ts b/clients/client-ram/pagination/GetResourceSharesPaginator.ts index 118e97c41e6b8..77ea3c64a6b2d 100644 --- a/clients/client-ram/pagination/GetResourceSharesPaginator.ts +++ b/clients/client-ram/pagination/GetResourceSharesPaginator.ts @@ -8,6 +8,9 @@ import { import { RAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RAMClient, input: GetResourceSharesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetResourceSharesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RAM, input: GetResourceSharesCommandInput, diff --git a/clients/client-ram/pagination/ListPendingInvitationResourcesPaginator.ts b/clients/client-ram/pagination/ListPendingInvitationResourcesPaginator.ts index ee4a87ee5b510..c7d757db79564 100644 --- a/clients/client-ram/pagination/ListPendingInvitationResourcesPaginator.ts +++ b/clients/client-ram/pagination/ListPendingInvitationResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { RAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RAMClient, input: ListPendingInvitationResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPendingInvitationResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RAM, input: ListPendingInvitationResourcesCommandInput, diff --git a/clients/client-ram/pagination/ListPrincipalsPaginator.ts b/clients/client-ram/pagination/ListPrincipalsPaginator.ts index 3ed636d94681e..36b27dda5152e 100644 --- a/clients/client-ram/pagination/ListPrincipalsPaginator.ts +++ b/clients/client-ram/pagination/ListPrincipalsPaginator.ts @@ -8,6 +8,9 @@ import { import { RAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RAMClient, input: ListPrincipalsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPrincipalsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RAM, input: ListPrincipalsCommandInput, diff --git a/clients/client-ram/pagination/ListResourcesPaginator.ts b/clients/client-ram/pagination/ListResourcesPaginator.ts index ddd5375dc8659..5f6bcc316c162 100644 --- a/clients/client-ram/pagination/ListResourcesPaginator.ts +++ b/clients/client-ram/pagination/ListResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { RAMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RAMClient, input: ListResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RAM, input: ListResourcesCommandInput, diff --git a/clients/client-ram/runtimeConfig.browser.ts b/clients/client-ram/runtimeConfig.browser.ts index e7af0bdfdca56..7f8946d1f9fdd 100644 --- a/clients/client-ram/runtimeConfig.browser.ts +++ b/clients/client-ram/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RAMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ram/runtimeConfig.native.ts b/clients/client-ram/runtimeConfig.native.ts index 03b77e80fd6d6..0055d86d41c38 100644 --- a/clients/client-ram/runtimeConfig.native.ts +++ b/clients/client-ram/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RAMClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ram/runtimeConfig.shared.ts b/clients/client-ram/runtimeConfig.shared.ts index 8504b7e0dc287..ca4ffd62998f4 100644 --- a/clients/client-ram/runtimeConfig.shared.ts +++ b/clients/client-ram/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-01-04", disableHostPrefix: false, diff --git a/clients/client-ram/runtimeConfig.ts b/clients/client-ram/runtimeConfig.ts index 8bbb38291a016..cf2e668214a20 100644 --- a/clients/client-ram/runtimeConfig.ts +++ b/clients/client-ram/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RAMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ram/tsconfig.json b/clients/client-ram/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ram/tsconfig.json +++ b/clients/client-ram/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-rds-data/commands/BatchExecuteStatementCommand.ts b/clients/client-rds-data/commands/BatchExecuteStatementCommand.ts index b1dbf63ca276c..331da1f371efc 100644 --- a/clients/client-rds-data/commands/BatchExecuteStatementCommand.ts +++ b/clients/client-rds-data/commands/BatchExecuteStatementCommand.ts @@ -20,6 +20,17 @@ import { export type BatchExecuteStatementCommandInput = BatchExecuteStatementRequest; export type BatchExecuteStatementCommandOutput = BatchExecuteStatementResponse & __MetadataBearer; +/** + *

Runs a batch SQL statement over an array of data.

+ *

You can run bulk update and insert operations for multiple records using a DML + * statement with different parameter sets. Bulk operations can provide a significant + * performance improvement over individual insert and update operations.

+ * + *

If a call isn't part of a transaction because it doesn't include the + * transactionID parameter, changes that result from the call are + * committed automatically.

+ *
+ */ export class BatchExecuteStatementCommand extends $Command< BatchExecuteStatementCommandInput, BatchExecuteStatementCommandOutput, @@ -34,6 +45,9 @@ export class BatchExecuteStatementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSDataClientResolvedConfig, diff --git a/clients/client-rds-data/commands/BeginTransactionCommand.ts b/clients/client-rds-data/commands/BeginTransactionCommand.ts index 195d331c56270..2ccd176a404e4 100644 --- a/clients/client-rds-data/commands/BeginTransactionCommand.ts +++ b/clients/client-rds-data/commands/BeginTransactionCommand.ts @@ -20,6 +20,20 @@ import { export type BeginTransactionCommandInput = BeginTransactionRequest; export type BeginTransactionCommandOutput = BeginTransactionResponse & __MetadataBearer; +/** + *

Starts a SQL transaction.

+ * + * + *

A transaction can run for a maximum of 24 hours. A transaction is terminated and + * rolled back automatically after 24 hours.

+ *

A transaction times out if no calls use its transaction ID in three minutes. + * If a transaction times out before it's committed, it's rolled back + * automatically.

+ *

DDL statements inside a transaction cause an implicit commit. We recommend + * that you run each DDL statement in a separate ExecuteStatement call with + * continueAfterTimeout enabled.

+ *
+ */ export class BeginTransactionCommand extends $Command< BeginTransactionCommandInput, BeginTransactionCommandOutput, @@ -34,6 +48,9 @@ export class BeginTransactionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSDataClientResolvedConfig, diff --git a/clients/client-rds-data/commands/CommitTransactionCommand.ts b/clients/client-rds-data/commands/CommitTransactionCommand.ts index 6706672ff3a58..5d91071c420b7 100644 --- a/clients/client-rds-data/commands/CommitTransactionCommand.ts +++ b/clients/client-rds-data/commands/CommitTransactionCommand.ts @@ -20,6 +20,10 @@ import { export type CommitTransactionCommandInput = CommitTransactionRequest; export type CommitTransactionCommandOutput = CommitTransactionResponse & __MetadataBearer; +/** + *

Ends a SQL transaction started with the BeginTransaction operation and + * commits the changes.

+ */ export class CommitTransactionCommand extends $Command< CommitTransactionCommandInput, CommitTransactionCommandOutput, @@ -34,6 +38,9 @@ export class CommitTransactionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSDataClientResolvedConfig, diff --git a/clients/client-rds-data/commands/ExecuteSqlCommand.ts b/clients/client-rds-data/commands/ExecuteSqlCommand.ts index 97c00e09f3988..369e50ee3d690 100644 --- a/clients/client-rds-data/commands/ExecuteSqlCommand.ts +++ b/clients/client-rds-data/commands/ExecuteSqlCommand.ts @@ -20,6 +20,13 @@ import { export type ExecuteSqlCommandInput = ExecuteSqlRequest; export type ExecuteSqlCommandOutput = ExecuteSqlResponse & __MetadataBearer; +/** + *

Runs one or more SQL statements.

+ * + *

This operation is deprecated. Use the BatchExecuteStatement or + * ExecuteStatement operation.

+ *
+ */ export class ExecuteSqlCommand extends $Command< ExecuteSqlCommandInput, ExecuteSqlCommandOutput, @@ -34,6 +41,9 @@ export class ExecuteSqlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSDataClientResolvedConfig, diff --git a/clients/client-rds-data/commands/ExecuteStatementCommand.ts b/clients/client-rds-data/commands/ExecuteStatementCommand.ts index 6b716736b1306..318f46472c393 100644 --- a/clients/client-rds-data/commands/ExecuteStatementCommand.ts +++ b/clients/client-rds-data/commands/ExecuteStatementCommand.ts @@ -20,6 +20,15 @@ import { export type ExecuteStatementCommandInput = ExecuteStatementRequest; export type ExecuteStatementCommandOutput = ExecuteStatementResponse & __MetadataBearer; +/** + *

Runs a SQL statement against a database.

+ * + *

If a call isn't part of a transaction because it doesn't include the + * transactionID parameter, changes that result from the call are + * committed automatically.

+ *
+ *

The response size limit is 1 MB. If the call returns more than 1 MB of response data, the call is terminated.

+ */ export class ExecuteStatementCommand extends $Command< ExecuteStatementCommandInput, ExecuteStatementCommandOutput, @@ -34,6 +43,9 @@ export class ExecuteStatementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSDataClientResolvedConfig, diff --git a/clients/client-rds-data/commands/RollbackTransactionCommand.ts b/clients/client-rds-data/commands/RollbackTransactionCommand.ts index 317df66062edb..0b1a8872b86d7 100644 --- a/clients/client-rds-data/commands/RollbackTransactionCommand.ts +++ b/clients/client-rds-data/commands/RollbackTransactionCommand.ts @@ -20,6 +20,9 @@ import { export type RollbackTransactionCommandInput = RollbackTransactionRequest; export type RollbackTransactionCommandOutput = RollbackTransactionResponse & __MetadataBearer; +/** + *

Performs a rollback of a transaction. Rolling back a transaction cancels its changes.

+ */ export class RollbackTransactionCommand extends $Command< RollbackTransactionCommandInput, RollbackTransactionCommandOutput, @@ -34,6 +37,9 @@ export class RollbackTransactionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSDataClientResolvedConfig, diff --git a/clients/client-rds-data/package.json b/clients/client-rds-data/package.json index 3d341d8b00f96..7ad235639df21 100644 --- a/clients/client-rds-data/package.json +++ b/clients/client-rds-data/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Rds Data Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-rds-data/runtimeConfig.browser.ts b/clients/client-rds-data/runtimeConfig.browser.ts index e456ddeb3f256..5a05fca0dd694 100644 --- a/clients/client-rds-data/runtimeConfig.browser.ts +++ b/clients/client-rds-data/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RDSDataClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-rds-data/runtimeConfig.native.ts b/clients/client-rds-data/runtimeConfig.native.ts index 2d936259b13aa..10e0bc1347bed 100644 --- a/clients/client-rds-data/runtimeConfig.native.ts +++ b/clients/client-rds-data/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RDSDataClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-rds-data/runtimeConfig.shared.ts b/clients/client-rds-data/runtimeConfig.shared.ts index 1567dcfedc28c..b94ae56d37d4b 100644 --- a/clients/client-rds-data/runtimeConfig.shared.ts +++ b/clients/client-rds-data/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-08-01", disableHostPrefix: false, diff --git a/clients/client-rds-data/runtimeConfig.ts b/clients/client-rds-data/runtimeConfig.ts index 00d2b8aa2a016..cd98eb24aa516 100644 --- a/clients/client-rds-data/runtimeConfig.ts +++ b/clients/client-rds-data/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RDSDataClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-rds-data/tsconfig.json b/clients/client-rds-data/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-rds-data/tsconfig.json +++ b/clients/client-rds-data/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-rds/commands/AddRoleToDBClusterCommand.ts b/clients/client-rds/commands/AddRoleToDBClusterCommand.ts index 0d6097940cd50..a9e8b962542c2 100644 --- a/clients/client-rds/commands/AddRoleToDBClusterCommand.ts +++ b/clients/client-rds/commands/AddRoleToDBClusterCommand.ts @@ -20,6 +20,14 @@ import { export type AddRoleToDBClusterCommandInput = AddRoleToDBClusterMessage; export type AddRoleToDBClusterCommandOutput = __MetadataBearer; +/** + *

Associates an Identity and Access Management (IAM) role from an Amazon Aurora DB cluster. + * For more information, see Authorizing Amazon Aurora MySQL + * to Access Other AWS Services on Your Behalf in the Amazon Aurora User Guide.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class AddRoleToDBClusterCommand extends $Command< AddRoleToDBClusterCommandInput, AddRoleToDBClusterCommandOutput, @@ -34,6 +42,9 @@ export class AddRoleToDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/AddRoleToDBInstanceCommand.ts b/clients/client-rds/commands/AddRoleToDBInstanceCommand.ts index a6662ed06394b..6515505a310bf 100644 --- a/clients/client-rds/commands/AddRoleToDBInstanceCommand.ts +++ b/clients/client-rds/commands/AddRoleToDBInstanceCommand.ts @@ -20,6 +20,12 @@ import { export type AddRoleToDBInstanceCommandInput = AddRoleToDBInstanceMessage; export type AddRoleToDBInstanceCommandOutput = __MetadataBearer; +/** + *

Associates an AWS Identity and Access Management (IAM) role with a DB instance.

+ * + *

To add a role to a DB instance, the status of the DB instance must be available.

+ *
+ */ export class AddRoleToDBInstanceCommand extends $Command< AddRoleToDBInstanceCommandInput, AddRoleToDBInstanceCommandOutput, @@ -34,6 +40,9 @@ export class AddRoleToDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/AddSourceIdentifierToSubscriptionCommand.ts b/clients/client-rds/commands/AddSourceIdentifierToSubscriptionCommand.ts index dcaed9c0d5dba..1ba860ad8ade6 100644 --- a/clients/client-rds/commands/AddSourceIdentifierToSubscriptionCommand.ts +++ b/clients/client-rds/commands/AddSourceIdentifierToSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type AddSourceIdentifierToSubscriptionCommandInput = AddSourceIdentifierToSubscriptionMessage; export type AddSourceIdentifierToSubscriptionCommandOutput = AddSourceIdentifierToSubscriptionResult & __MetadataBearer; +/** + *

Adds a source identifier to an existing RDS event notification subscription.

+ */ export class AddSourceIdentifierToSubscriptionCommand extends $Command< AddSourceIdentifierToSubscriptionCommandInput, AddSourceIdentifierToSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class AddSourceIdentifierToSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/AddTagsToResourceCommand.ts b/clients/client-rds/commands/AddTagsToResourceCommand.ts index 1bae0aeef7769..3cb3b9ad614a0 100644 --- a/clients/client-rds/commands/AddTagsToResourceCommand.ts +++ b/clients/client-rds/commands/AddTagsToResourceCommand.ts @@ -20,6 +20,11 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceMessage; export type AddTagsToResourceCommandOutput = __MetadataBearer; +/** + *

Adds metadata tags to an Amazon RDS resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon RDS resources, or used in a Condition statement in an IAM policy for Amazon RDS.

+ *

For an overview on tagging Amazon RDS resources, + * see Tagging Amazon RDS Resources.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -34,6 +39,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ApplyPendingMaintenanceActionCommand.ts b/clients/client-rds/commands/ApplyPendingMaintenanceActionCommand.ts index 73bef7c5b6d37..aa52489b130c3 100644 --- a/clients/client-rds/commands/ApplyPendingMaintenanceActionCommand.ts +++ b/clients/client-rds/commands/ApplyPendingMaintenanceActionCommand.ts @@ -20,6 +20,9 @@ import { export type ApplyPendingMaintenanceActionCommandInput = ApplyPendingMaintenanceActionMessage; export type ApplyPendingMaintenanceActionCommandOutput = ApplyPendingMaintenanceActionResult & __MetadataBearer; +/** + *

Applies a pending maintenance action to a resource (for example, to a DB instance).

+ */ export class ApplyPendingMaintenanceActionCommand extends $Command< ApplyPendingMaintenanceActionCommandInput, ApplyPendingMaintenanceActionCommandOutput, @@ -34,6 +37,9 @@ export class ApplyPendingMaintenanceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/AuthorizeDBSecurityGroupIngressCommand.ts b/clients/client-rds/commands/AuthorizeDBSecurityGroupIngressCommand.ts index f3f8f4d47161c..8de23aaa520a7 100644 --- a/clients/client-rds/commands/AuthorizeDBSecurityGroupIngressCommand.ts +++ b/clients/client-rds/commands/AuthorizeDBSecurityGroupIngressCommand.ts @@ -20,6 +20,20 @@ import { export type AuthorizeDBSecurityGroupIngressCommandInput = AuthorizeDBSecurityGroupIngressMessage; export type AuthorizeDBSecurityGroupIngressCommandOutput = AuthorizeDBSecurityGroupIngressResult & __MetadataBearer; +/** + *

Enables ingress to a DBSecurityGroup using one of two forms of authorization. First, EC2 or VPC security + * groups can be added to the DBSecurityGroup if the application using the database is running on EC2 or VPC + * instances. Second, IP ranges are available if the application accessing your database is running on the Internet. + * Required parameters for this API are one of CIDR range, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId + * and either EC2SecurityGroupName or EC2SecurityGroupId for non-VPC).

+ * + *

You can't authorize ingress from an EC2 security group in one AWS Region to an Amazon RDS DB instance in + * another. You can't authorize ingress from a VPC security group in one VPC to an Amazon RDS DB instance in another.

+ *
+ *

For an overview of CIDR ranges, go to the + * Wikipedia Tutorial. + *

+ */ export class AuthorizeDBSecurityGroupIngressCommand extends $Command< AuthorizeDBSecurityGroupIngressCommandInput, AuthorizeDBSecurityGroupIngressCommandOutput, @@ -34,6 +48,9 @@ export class AuthorizeDBSecurityGroupIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/BacktrackDBClusterCommand.ts b/clients/client-rds/commands/BacktrackDBClusterCommand.ts index f0496484bcfce..d8d50a1f0fadc 100644 --- a/clients/client-rds/commands/BacktrackDBClusterCommand.ts +++ b/clients/client-rds/commands/BacktrackDBClusterCommand.ts @@ -20,6 +20,17 @@ import { export type BacktrackDBClusterCommandInput = BacktrackDBClusterMessage; export type BacktrackDBClusterCommandOutput = DBClusterBacktrack & __MetadataBearer; +/** + *

Backtracks a DB cluster to a specific time, without creating a new DB cluster.

+ *

For more information on backtracking, see + * + * Backtracking an Aurora DB Cluster in the + * Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora MySQL DB clusters.

+ *
+ */ export class BacktrackDBClusterCommand extends $Command< BacktrackDBClusterCommandInput, BacktrackDBClusterCommandOutput, @@ -34,6 +45,9 @@ export class BacktrackDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CancelExportTaskCommand.ts b/clients/client-rds/commands/CancelExportTaskCommand.ts index 14844ddd38d70..c19431b5e54e9 100644 --- a/clients/client-rds/commands/CancelExportTaskCommand.ts +++ b/clients/client-rds/commands/CancelExportTaskCommand.ts @@ -20,6 +20,11 @@ import { export type CancelExportTaskCommandInput = CancelExportTaskMessage; export type CancelExportTaskCommandOutput = ExportTask & __MetadataBearer; +/** + *

Cancels an export task in progress that is exporting a snapshot to Amazon S3. + * Any data that has already been written to the S3 bucket isn't removed. + *

+ */ export class CancelExportTaskCommand extends $Command< CancelExportTaskCommandInput, CancelExportTaskCommandOutput, @@ -34,6 +39,9 @@ export class CancelExportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CopyDBClusterParameterGroupCommand.ts b/clients/client-rds/commands/CopyDBClusterParameterGroupCommand.ts index 9118ad3b7eb61..8db4781e1710b 100644 --- a/clients/client-rds/commands/CopyDBClusterParameterGroupCommand.ts +++ b/clients/client-rds/commands/CopyDBClusterParameterGroupCommand.ts @@ -20,6 +20,12 @@ import { export type CopyDBClusterParameterGroupCommandInput = CopyDBClusterParameterGroupMessage; export type CopyDBClusterParameterGroupCommandOutput = CopyDBClusterParameterGroupResult & __MetadataBearer; +/** + *

Copies the specified DB cluster parameter group.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class CopyDBClusterParameterGroupCommand extends $Command< CopyDBClusterParameterGroupCommandInput, CopyDBClusterParameterGroupCommandOutput, @@ -34,6 +40,9 @@ export class CopyDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CopyDBClusterSnapshotCommand.ts b/clients/client-rds/commands/CopyDBClusterSnapshotCommand.ts index 76755063c890b..9b1cf4d340635 100644 --- a/clients/client-rds/commands/CopyDBClusterSnapshotCommand.ts +++ b/clients/client-rds/commands/CopyDBClusterSnapshotCommand.ts @@ -21,6 +21,83 @@ import { export type CopyDBClusterSnapshotCommandInput = CopyDBClusterSnapshotMessage; export type CopyDBClusterSnapshotCommandOutput = CopyDBClusterSnapshotResult & __MetadataBearer; +/** + *

Copies a snapshot of a DB cluster.

+ *

To copy a DB cluster snapshot from a shared manual DB cluster snapshot, SourceDBClusterSnapshotIdentifier + * must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.

+ * + *

You can copy an encrypted DB cluster snapshot from another AWS Region. In that case, the AWS Region where you call the CopyDBClusterSnapshot action + * is the destination AWS Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another AWS Region, + * you must provide the following values:

+ * + *
    + *
  • + *

    + * KmsKeyId - The AWS Key Management System (AWS KMS) key identifier for the key to use to + * encrypt the copy of the DB cluster snapshot in the destination AWS Region.

    + *
  • + *
  • + *

    + * PreSignedUrl - A URL that contains a Signature Version 4 signed request for the + * CopyDBClusterSnapshot action to be called in the source AWS Region where the DB cluster snapshot is copied from. + * The pre-signed URL must be a valid request for the CopyDBClusterSnapshot API action that can be executed in the + * source AWS Region that contains the encrypted DB cluster snapshot to be copied.

    + *

    The pre-signed URL request must contain the following parameter values:

    + *
      + *
    • + *

      + * KmsKeyId - The KMS key identifier for the key to use to encrypt the copy of the DB + * cluster snapshot in the destination AWS Region. This is the same identifier for both the CopyDBClusterSnapshot + * action that is called in the destination AWS Region, and the action contained in the pre-signed URL.

      + *
    • + *
    • + *

      + * DestinationRegion - The name of the AWS Region that the DB cluster snapshot is to be created in.

      + *
    • + *
    • + *

      + * SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster + * snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source AWS Region. For example, + * if you are copying an encrypted DB cluster snapshot from the us-west-2 AWS Region, then your SourceDBClusterSnapshotIdentifier + * looks like the following example: arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115.

      + *
    • + *
    + *

    To learn how to generate a Signature Version 4 signed request, see + * + * + * Authenticating Requests: Using Query Parameters (AWS Signature Version 4) and + * + * Signature Version 4 Signing Process.

    + * + *

    If you are using an AWS SDK tool or the AWS CLI, you can specify SourceRegion (or --source-region for the AWS CLI) + * instead of specifying PreSignedUrl manually. Specifying SourceRegion autogenerates a pre-signed URL that is a valid + * request for the operation that can be executed in the source AWS Region.

    + *
    + *
  • + *
  • + *

    + * TargetDBClusterSnapshotIdentifier - The identifier for the new copy of the DB cluster snapshot in the destination AWS Region.

    + *
  • + *
  • + *

    + * SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. + * This identifier must be in the ARN format for the source AWS Region and is the same value as the SourceDBClusterSnapshotIdentifier in the pre-signed URL.

    + *
  • + *
+ *

To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified + * by TargetDBClusterSnapshotIdentifier while that DB cluster snapshot is in "copying" status.

+ *

For more information on copying encrypted DB cluster snapshots from one AWS Region to another, see + * + * Copying a Snapshot in the Amazon Aurora User Guide. + *

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class CopyDBClusterSnapshotCommand extends $Command< CopyDBClusterSnapshotCommandInput, CopyDBClusterSnapshotCommandOutput, @@ -35,6 +112,9 @@ export class CopyDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CopyDBParameterGroupCommand.ts b/clients/client-rds/commands/CopyDBParameterGroupCommand.ts index ad97bc662d7b5..5dc9b5fda1c2a 100644 --- a/clients/client-rds/commands/CopyDBParameterGroupCommand.ts +++ b/clients/client-rds/commands/CopyDBParameterGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CopyDBParameterGroupCommandInput = CopyDBParameterGroupMessage; export type CopyDBParameterGroupCommandOutput = CopyDBParameterGroupResult & __MetadataBearer; +/** + *

Copies the specified DB parameter group.

+ */ export class CopyDBParameterGroupCommand extends $Command< CopyDBParameterGroupCommandInput, CopyDBParameterGroupCommandOutput, @@ -34,6 +37,9 @@ export class CopyDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CopyDBSnapshotCommand.ts b/clients/client-rds/commands/CopyDBSnapshotCommand.ts index 33a19bebc40fe..9f1616c85bdbb 100644 --- a/clients/client-rds/commands/CopyDBSnapshotCommand.ts +++ b/clients/client-rds/commands/CopyDBSnapshotCommand.ts @@ -21,6 +21,17 @@ import { export type CopyDBSnapshotCommandInput = CopyDBSnapshotMessage; export type CopyDBSnapshotCommandOutput = CopyDBSnapshotResult & __MetadataBearer; +/** + *

Copies the specified DB snapshot. The source DB snapshot must be in the available state.

+ * + *

You can copy a snapshot from one AWS Region to another. In that case, the AWS Region + * where you call the CopyDBSnapshot action is the destination AWS Region for the + * DB snapshot copy.

+ * + *

For more information about copying snapshots, see + * Copying a DB Snapshot in the Amazon RDS User Guide. + *

+ */ export class CopyDBSnapshotCommand extends $Command< CopyDBSnapshotCommandInput, CopyDBSnapshotCommandOutput, @@ -35,6 +46,9 @@ export class CopyDBSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CopyOptionGroupCommand.ts b/clients/client-rds/commands/CopyOptionGroupCommand.ts index 086d4235bec73..eda28904e38b9 100644 --- a/clients/client-rds/commands/CopyOptionGroupCommand.ts +++ b/clients/client-rds/commands/CopyOptionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CopyOptionGroupCommandInput = CopyOptionGroupMessage; export type CopyOptionGroupCommandOutput = CopyOptionGroupResult & __MetadataBearer; +/** + *

Copies the specified option group.

+ */ export class CopyOptionGroupCommand extends $Command< CopyOptionGroupCommandInput, CopyOptionGroupCommandOutput, @@ -34,6 +37,9 @@ export class CopyOptionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateCustomAvailabilityZoneCommand.ts b/clients/client-rds/commands/CreateCustomAvailabilityZoneCommand.ts index 5af3a0c765fc4..78b8e8e674467 100644 --- a/clients/client-rds/commands/CreateCustomAvailabilityZoneCommand.ts +++ b/clients/client-rds/commands/CreateCustomAvailabilityZoneCommand.ts @@ -20,6 +20,15 @@ import { export type CreateCustomAvailabilityZoneCommandInput = CreateCustomAvailabilityZoneMessage; export type CreateCustomAvailabilityZoneCommandOutput = CreateCustomAvailabilityZoneResult & __MetadataBearer; +/** + *

Creates a custom Availability Zone (AZ).

+ *

A custom AZ is an on-premises AZ that is integrated with a VMware vSphere cluster.

+ *

For more information about RDS on VMware, see the + * + * RDS on VMware User Guide. + * + *

+ */ export class CreateCustomAvailabilityZoneCommand extends $Command< CreateCustomAvailabilityZoneCommandInput, CreateCustomAvailabilityZoneCommandOutput, @@ -34,6 +43,9 @@ export class CreateCustomAvailabilityZoneCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBClusterCommand.ts b/clients/client-rds/commands/CreateDBClusterCommand.ts index d507f88878316..76c3db3d84d9d 100644 --- a/clients/client-rds/commands/CreateDBClusterCommand.ts +++ b/clients/client-rds/commands/CreateDBClusterCommand.ts @@ -21,6 +21,22 @@ import { export type CreateDBClusterCommandInput = CreateDBClusterMessage; export type CreateDBClusterCommandOutput = CreateDBClusterResult & __MetadataBearer; +/** + *

Creates a new Amazon Aurora DB cluster.

+ *

You can use the ReplicationSourceIdentifier parameter to create the DB + * cluster as a read replica of another DB cluster or Amazon RDS MySQL DB instance. For + * cross-region replication where the DB cluster identified by + * ReplicationSourceIdentifier is encrypted, you must also specify the + * PreSignedUrl parameter.

+ * + *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class CreateDBClusterCommand extends $Command< CreateDBClusterCommandInput, CreateDBClusterCommandOutput, @@ -35,6 +51,9 @@ export class CreateDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBClusterEndpointCommand.ts b/clients/client-rds/commands/CreateDBClusterEndpointCommand.ts index db9695b47bcd8..258071e364d28 100644 --- a/clients/client-rds/commands/CreateDBClusterEndpointCommand.ts +++ b/clients/client-rds/commands/CreateDBClusterEndpointCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDBClusterEndpointCommandInput = CreateDBClusterEndpointMessage; export type CreateDBClusterEndpointCommandOutput = DBClusterEndpoint & __MetadataBearer; +/** + *

Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class CreateDBClusterEndpointCommand extends $Command< CreateDBClusterEndpointCommandInput, CreateDBClusterEndpointCommandOutput, @@ -34,6 +40,9 @@ export class CreateDBClusterEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBClusterParameterGroupCommand.ts b/clients/client-rds/commands/CreateDBClusterParameterGroupCommand.ts index 93e6c161af526..8d0e000638961 100644 --- a/clients/client-rds/commands/CreateDBClusterParameterGroupCommand.ts +++ b/clients/client-rds/commands/CreateDBClusterParameterGroupCommand.ts @@ -20,6 +20,40 @@ import { export type CreateDBClusterParameterGroupCommandInput = CreateDBClusterParameterGroupMessage; export type CreateDBClusterParameterGroupCommandOutput = CreateDBClusterParameterGroupResult & __MetadataBearer; +/** + *

Creates a new DB cluster parameter group.

+ *

Parameters in a DB cluster parameter group apply to all of the instances in a DB cluster.

+ *

+ * A DB cluster parameter group is initially created with the default parameters for the + * database engine used by instances in the DB cluster. To provide custom values for any of the + * parameters, you must modify the group after creating it using + * ModifyDBClusterParameterGroup. Once you've created a DB cluster parameter group, you need to + * associate it with your DB cluster using ModifyDBCluster. When you associate + * a new DB cluster parameter group with a running DB cluster, you need to reboot the DB + * instances in the DB cluster without failover for the new DB cluster parameter group and + * associated settings to take effect. + *

+ * + *

After you create a DB cluster parameter group, you should wait at least 5 minutes + * before creating your first DB cluster + * that uses that DB cluster parameter group as the default parameter + * group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter + * group is used as the default for a new DB cluster. This is especially important for parameters + * that are critical when creating the default database for a DB cluster, such as the character set + * for the default database defined by the character_set_database parameter. You can use the + * Parameter Groups option of the Amazon RDS console or the + * DescribeDBClusterParameters action to verify + * that your DB cluster parameter group has been created or modified.

+ *
+ * + *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class CreateDBClusterParameterGroupCommand extends $Command< CreateDBClusterParameterGroupCommandInput, CreateDBClusterParameterGroupCommandOutput, @@ -34,6 +68,9 @@ export class CreateDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBClusterSnapshotCommand.ts b/clients/client-rds/commands/CreateDBClusterSnapshotCommand.ts index 22e84f2ed578d..be79577d0979a 100644 --- a/clients/client-rds/commands/CreateDBClusterSnapshotCommand.ts +++ b/clients/client-rds/commands/CreateDBClusterSnapshotCommand.ts @@ -20,6 +20,15 @@ import { export type CreateDBClusterSnapshotCommandInput = CreateDBClusterSnapshotMessage; export type CreateDBClusterSnapshotCommandOutput = CreateDBClusterSnapshotResult & __MetadataBearer; +/** + *

Creates a snapshot of a DB cluster. For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class CreateDBClusterSnapshotCommand extends $Command< CreateDBClusterSnapshotCommandInput, CreateDBClusterSnapshotCommandOutput, @@ -34,6 +43,9 @@ export class CreateDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBInstanceCommand.ts b/clients/client-rds/commands/CreateDBInstanceCommand.ts index 9a504f7061607..ee60726ccfb9e 100644 --- a/clients/client-rds/commands/CreateDBInstanceCommand.ts +++ b/clients/client-rds/commands/CreateDBInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBInstanceCommandInput = CreateDBInstanceMessage; export type CreateDBInstanceCommandOutput = CreateDBInstanceResult & __MetadataBearer; +/** + *

Creates a new DB instance.

+ */ export class CreateDBInstanceCommand extends $Command< CreateDBInstanceCommandInput, CreateDBInstanceCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBInstanceReadReplicaCommand.ts b/clients/client-rds/commands/CreateDBInstanceReadReplicaCommand.ts index 470a9d6335db6..7be784146112a 100644 --- a/clients/client-rds/commands/CreateDBInstanceReadReplicaCommand.ts +++ b/clients/client-rds/commands/CreateDBInstanceReadReplicaCommand.ts @@ -21,6 +21,24 @@ import { export type CreateDBInstanceReadReplicaCommandInput = CreateDBInstanceReadReplicaMessage; export type CreateDBInstanceReadReplicaCommandOutput = CreateDBInstanceReadReplicaResult & __MetadataBearer; +/** + *

Creates a new DB instance that acts as a read replica for an existing source DB + * instance. You can create a read replica for a DB instance running MySQL, MariaDB, + * Oracle, PostgreSQL, or SQL Server. For more information, see Working with Read + * Replicas in the Amazon RDS User Guide.

+ * + *

Amazon Aurora doesn't support this action. Call the CreateDBInstance + * action to create a DB instance for an Aurora DB cluster.

+ * + *

All read replica DB instances are created with backups disabled. All other DB + * instance attributes (including DB security groups and DB parameter groups) are inherited + * from the source DB instance, except as specified.

+ * + * + *

Your source DB instance must have backup retention enabled. + *

+ *
+ */ export class CreateDBInstanceReadReplicaCommand extends $Command< CreateDBInstanceReadReplicaCommandInput, CreateDBInstanceReadReplicaCommandOutput, @@ -35,6 +53,9 @@ export class CreateDBInstanceReadReplicaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBParameterGroupCommand.ts b/clients/client-rds/commands/CreateDBParameterGroupCommand.ts index 1e8fd6230d4e8..2c90fa477217f 100644 --- a/clients/client-rds/commands/CreateDBParameterGroupCommand.ts +++ b/clients/client-rds/commands/CreateDBParameterGroupCommand.ts @@ -20,6 +20,29 @@ import { export type CreateDBParameterGroupCommandInput = CreateDBParameterGroupMessage; export type CreateDBParameterGroupCommandOutput = CreateDBParameterGroupResult & __MetadataBearer; +/** + *

Creates a new DB parameter group.

+ *

+ * A DB parameter group is initially created with the default parameters for the + * database engine used by the DB instance. To provide custom values for any of the + * parameters, you must modify the group after creating it using + * ModifyDBParameterGroup. Once you've created a DB parameter group, you need to + * associate it with your DB instance using ModifyDBInstance. When you associate + * a new DB parameter group with a running DB instance, you need to reboot the DB + * instance without failover for the new DB parameter group and associated settings to take effect. + *

+ * + *

After you create a DB parameter group, you should wait at least 5 minutes + * before creating your first DB instance that uses that DB parameter group as the default parameter + * group. This allows Amazon RDS to fully complete the create action before the parameter + * group is used as the default for a new DB instance. This is especially important for parameters + * that are critical when creating the default database for a DB instance, such as the character set + * for the default database defined by the character_set_database parameter. You can use the + * Parameter Groups option of the Amazon RDS console or the + * DescribeDBParameters command to verify + * that your DB parameter group has been created or modified.

+ *
+ */ export class CreateDBParameterGroupCommand extends $Command< CreateDBParameterGroupCommandInput, CreateDBParameterGroupCommandOutput, @@ -34,6 +57,9 @@ export class CreateDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBProxyCommand.ts b/clients/client-rds/commands/CreateDBProxyCommand.ts index 2ea95a8d0cf75..37c0749bb15f0 100644 --- a/clients/client-rds/commands/CreateDBProxyCommand.ts +++ b/clients/client-rds/commands/CreateDBProxyCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBProxyCommandInput = CreateDBProxyRequest; export type CreateDBProxyCommandOutput = CreateDBProxyResponse & __MetadataBearer; +/** + *

Creates a new DB proxy.

+ */ export class CreateDBProxyCommand extends $Command< CreateDBProxyCommandInput, CreateDBProxyCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBProxyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBSecurityGroupCommand.ts b/clients/client-rds/commands/CreateDBSecurityGroupCommand.ts index 5519d152685d8..696a101798325 100644 --- a/clients/client-rds/commands/CreateDBSecurityGroupCommand.ts +++ b/clients/client-rds/commands/CreateDBSecurityGroupCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDBSecurityGroupCommandInput = CreateDBSecurityGroupMessage; export type CreateDBSecurityGroupCommandOutput = CreateDBSecurityGroupResult & __MetadataBearer; +/** + *

Creates a new DB security group. DB security groups control access to a DB instance.

+ * + *

A DB security group controls access to EC2-Classic DB instances that are not in a VPC.

+ *
+ */ export class CreateDBSecurityGroupCommand extends $Command< CreateDBSecurityGroupCommandInput, CreateDBSecurityGroupCommandOutput, @@ -34,6 +40,9 @@ export class CreateDBSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBSnapshotCommand.ts b/clients/client-rds/commands/CreateDBSnapshotCommand.ts index 5cb82730153bd..008076e577596 100644 --- a/clients/client-rds/commands/CreateDBSnapshotCommand.ts +++ b/clients/client-rds/commands/CreateDBSnapshotCommand.ts @@ -20,6 +20,10 @@ import { export type CreateDBSnapshotCommandInput = CreateDBSnapshotMessage; export type CreateDBSnapshotCommandOutput = CreateDBSnapshotResult & __MetadataBearer; +/** + *

Creates a snapshot of a DB instance. The source DB instance must be in the available or + * storage-optimizationstate.

+ */ export class CreateDBSnapshotCommand extends $Command< CreateDBSnapshotCommandInput, CreateDBSnapshotCommandOutput, @@ -34,6 +38,9 @@ export class CreateDBSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateDBSubnetGroupCommand.ts b/clients/client-rds/commands/CreateDBSubnetGroupCommand.ts index b0646d5caa66b..77187c73d049f 100644 --- a/clients/client-rds/commands/CreateDBSubnetGroupCommand.ts +++ b/clients/client-rds/commands/CreateDBSubnetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDBSubnetGroupCommandInput = CreateDBSubnetGroupMessage; export type CreateDBSubnetGroupCommandOutput = CreateDBSubnetGroupResult & __MetadataBearer; +/** + *

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

+ */ export class CreateDBSubnetGroupCommand extends $Command< CreateDBSubnetGroupCommandInput, CreateDBSubnetGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateEventSubscriptionCommand.ts b/clients/client-rds/commands/CreateEventSubscriptionCommand.ts index 2b455b3ec568f..50115f5b770b6 100644 --- a/clients/client-rds/commands/CreateEventSubscriptionCommand.ts +++ b/clients/client-rds/commands/CreateEventSubscriptionCommand.ts @@ -20,6 +20,31 @@ import { export type CreateEventSubscriptionCommandInput = CreateEventSubscriptionMessage; export type CreateEventSubscriptionCommandOutput = CreateEventSubscriptionResult & __MetadataBearer; +/** + *

Creates an RDS event notification subscription. This action requires a topic Amazon + * Resource Name (ARN) created by either the RDS console, the SNS console, or the SNS API. + * To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the + * topic. The ARN is displayed in the SNS console.

+ *

You can specify the type of source (SourceType) that you want to be + * notified of and provide a list of RDS sources (SourceIds) that triggers the + * events. You can also provide a list of event categories (EventCategories) + * for events that you want to be notified of. For example, you can specify + * SourceType = db-instance, SourceIds = + * mydbinstance1, mydbinstance2 and + * EventCategories = Availability, + * Backup.

+ * + *

If you specify both the SourceType and SourceIds, such as SourceType = db-instance + * and SourceIdentifier = myDBInstance1, you are notified of all the db-instance events for + * the specified source. If you specify a SourceType but do not specify a SourceIdentifier, + * you receive notice of the events for that source type for all your RDS sources. If you + * don't specify either the SourceType or the SourceIdentifier, you are notified of events + * generated from all RDS sources belonging to your customer account.

+ * + *

RDS event notification is only available for unencrypted SNS topics. If you specify an + * encrypted SNS topic, event notifications aren't sent for the topic.

+ *
+ */ export class CreateEventSubscriptionCommand extends $Command< CreateEventSubscriptionCommandInput, CreateEventSubscriptionCommandOutput, @@ -34,6 +59,9 @@ export class CreateEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateGlobalClusterCommand.ts b/clients/client-rds/commands/CreateGlobalClusterCommand.ts index 95ab1391cd8c6..25a065cdabf0c 100644 --- a/clients/client-rds/commands/CreateGlobalClusterCommand.ts +++ b/clients/client-rds/commands/CreateGlobalClusterCommand.ts @@ -20,6 +20,25 @@ import { export type CreateGlobalClusterCommandInput = CreateGlobalClusterMessage; export type CreateGlobalClusterCommandOutput = CreateGlobalClusterResult & __MetadataBearer; +/** + *

+ * Creates an Aurora global database + * spread across multiple AWS Regions. The global database + * contains a single primary cluster with read-write capability, + * and a read-only secondary cluster that receives + * data from the primary cluster through high-speed replication + * performed by the Aurora storage subsystem. + *

+ *

+ * You can create a global database that is initially empty, and then + * add a primary cluster and a secondary cluster to it. + * Or you can specify an existing Aurora cluster during the create operation, + * and this cluster becomes the primary cluster of the global database. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class CreateGlobalClusterCommand extends $Command< CreateGlobalClusterCommandInput, CreateGlobalClusterCommandOutput, @@ -34,6 +53,9 @@ export class CreateGlobalClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/CreateOptionGroupCommand.ts b/clients/client-rds/commands/CreateOptionGroupCommand.ts index da72affa15268..b7921f360fb06 100644 --- a/clients/client-rds/commands/CreateOptionGroupCommand.ts +++ b/clients/client-rds/commands/CreateOptionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateOptionGroupCommandInput = CreateOptionGroupMessage; export type CreateOptionGroupCommandOutput = CreateOptionGroupResult & __MetadataBearer; +/** + *

Creates a new option group. You can create up to 20 option groups.

+ */ export class CreateOptionGroupCommand extends $Command< CreateOptionGroupCommandInput, CreateOptionGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateOptionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteCustomAvailabilityZoneCommand.ts b/clients/client-rds/commands/DeleteCustomAvailabilityZoneCommand.ts index e60103122f623..62fa7d30c5977 100644 --- a/clients/client-rds/commands/DeleteCustomAvailabilityZoneCommand.ts +++ b/clients/client-rds/commands/DeleteCustomAvailabilityZoneCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteCustomAvailabilityZoneCommandInput = DeleteCustomAvailabilityZoneMessage; export type DeleteCustomAvailabilityZoneCommandOutput = DeleteCustomAvailabilityZoneResult & __MetadataBearer; +/** + *

Deletes a custom Availability Zone (AZ).

+ *

A custom AZ is an on-premises AZ that is integrated with a VMware vSphere cluster.

+ *

For more information about RDS on VMware, see the + * + * RDS on VMware User Guide. + * + *

+ */ export class DeleteCustomAvailabilityZoneCommand extends $Command< DeleteCustomAvailabilityZoneCommandInput, DeleteCustomAvailabilityZoneCommandOutput, @@ -34,6 +43,9 @@ export class DeleteCustomAvailabilityZoneCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBClusterCommand.ts b/clients/client-rds/commands/DeleteDBClusterCommand.ts index dec22afade748..1e65345aab5d3 100644 --- a/clients/client-rds/commands/DeleteDBClusterCommand.ts +++ b/clients/client-rds/commands/DeleteDBClusterCommand.ts @@ -20,6 +20,19 @@ import { export type DeleteDBClusterCommandInput = DeleteDBClusterMessage; export type DeleteDBClusterCommandOutput = DeleteDBClusterResult & __MetadataBearer; +/** + *

The DeleteDBCluster action deletes a previously provisioned DB cluster. + * When you delete a DB cluster, all automated backups for that DB cluster are deleted and can't be recovered. + * Manual DB cluster snapshots of the specified DB cluster are not deleted.

+ *

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DeleteDBClusterCommand extends $Command< DeleteDBClusterCommandInput, DeleteDBClusterCommandOutput, @@ -34,6 +47,9 @@ export class DeleteDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBClusterEndpointCommand.ts b/clients/client-rds/commands/DeleteDBClusterEndpointCommand.ts index 06df1348de300..81b5d8c2aceb1 100644 --- a/clients/client-rds/commands/DeleteDBClusterEndpointCommand.ts +++ b/clients/client-rds/commands/DeleteDBClusterEndpointCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDBClusterEndpointCommandInput = DeleteDBClusterEndpointMessage; export type DeleteDBClusterEndpointCommandOutput = DBClusterEndpoint & __MetadataBearer; +/** + *

Deletes a custom endpoint and removes it from an Amazon Aurora DB cluster.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DeleteDBClusterEndpointCommand extends $Command< DeleteDBClusterEndpointCommandInput, DeleteDBClusterEndpointCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDBClusterEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBClusterParameterGroupCommand.ts b/clients/client-rds/commands/DeleteDBClusterParameterGroupCommand.ts index f5beb642131cb..05ab5322b1f91 100644 --- a/clients/client-rds/commands/DeleteDBClusterParameterGroupCommand.ts +++ b/clients/client-rds/commands/DeleteDBClusterParameterGroupCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteDBClusterParameterGroupCommandInput = DeleteDBClusterParameterGroupMessage; export type DeleteDBClusterParameterGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a specified DB cluster parameter group. The DB cluster parameter group to be deleted can't be associated with any DB clusters.

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DeleteDBClusterParameterGroupCommand extends $Command< DeleteDBClusterParameterGroupCommandInput, DeleteDBClusterParameterGroupCommandOutput, @@ -34,6 +44,9 @@ export class DeleteDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBClusterSnapshotCommand.ts b/clients/client-rds/commands/DeleteDBClusterSnapshotCommand.ts index 6458a543776a0..19803b2971f66 100644 --- a/clients/client-rds/commands/DeleteDBClusterSnapshotCommand.ts +++ b/clients/client-rds/commands/DeleteDBClusterSnapshotCommand.ts @@ -20,6 +20,20 @@ import { export type DeleteDBClusterSnapshotCommandInput = DeleteDBClusterSnapshotMessage; export type DeleteDBClusterSnapshotCommandOutput = DeleteDBClusterSnapshotResult & __MetadataBearer; +/** + *

Deletes a DB cluster snapshot. If the snapshot is being copied, the copy operation is terminated.

+ * + *

The DB cluster snapshot must be in the available state to be + * deleted.

+ *
+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DeleteDBClusterSnapshotCommand extends $Command< DeleteDBClusterSnapshotCommandInput, DeleteDBClusterSnapshotCommandOutput, @@ -34,6 +48,9 @@ export class DeleteDBClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBInstanceAutomatedBackupCommand.ts b/clients/client-rds/commands/DeleteDBInstanceAutomatedBackupCommand.ts index 22204e4d9a5f2..e1de4f08baf67 100644 --- a/clients/client-rds/commands/DeleteDBInstanceAutomatedBackupCommand.ts +++ b/clients/client-rds/commands/DeleteDBInstanceAutomatedBackupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDBInstanceAutomatedBackupCommandInput = DeleteDBInstanceAutomatedBackupMessage; export type DeleteDBInstanceAutomatedBackupCommandOutput = DeleteDBInstanceAutomatedBackupResult & __MetadataBearer; +/** + *

Deletes automated backups based on the source instance's DbiResourceId + * value or the restorable instance's resource ID.

+ */ export class DeleteDBInstanceAutomatedBackupCommand extends $Command< DeleteDBInstanceAutomatedBackupCommandInput, DeleteDBInstanceAutomatedBackupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDBInstanceAutomatedBackupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBInstanceCommand.ts b/clients/client-rds/commands/DeleteDBInstanceCommand.ts index d7dab2af8719d..0c30c164b0e45 100644 --- a/clients/client-rds/commands/DeleteDBInstanceCommand.ts +++ b/clients/client-rds/commands/DeleteDBInstanceCommand.ts @@ -20,6 +20,34 @@ import { export type DeleteDBInstanceCommandInput = DeleteDBInstanceMessage; export type DeleteDBInstanceCommandOutput = DeleteDBInstanceResult & __MetadataBearer; +/** + *

The DeleteDBInstance action deletes a previously provisioned DB instance. + * When you delete a DB instance, all automated backups for that instance are deleted and can't be recovered. + * Manual DB snapshots of the DB instance to be deleted by DeleteDBInstance are not deleted.

+ *

+ * If you request a final DB snapshot + * the status of the Amazon RDS DB instance is deleting until the DB snapshot is created. The API action DescribeDBInstance + * is used to monitor the status of this operation. The action can't be canceled or reverted once submitted. + *

+ *

When a DB instance is in a failure state and has a status of failed, incompatible-restore, + * or incompatible-network, you can only delete it when you skip creation of the final snapshot with the SkipFinalSnapshot parameter.

+ * + *

If the specified DB instance is part of an Amazon Aurora DB cluster, you can't delete the DB instance if both of the following + * conditions are true:

+ *
    + *
  • + *

    The DB cluster is a read replica of another Amazon Aurora DB cluster.

    + *
  • + *
  • + *

    The DB instance is the only instance in the DB cluster.

    + *
  • + *
+ *

To delete a DB instance in this case, first call the + * PromoteReadReplicaDBCluster API action to promote the DB cluster so + * it's no longer a read replica. After the promotion completes, then call the + * DeleteDBInstance API action to delete the final instance in the DB + * cluster.

+ */ export class DeleteDBInstanceCommand extends $Command< DeleteDBInstanceCommandInput, DeleteDBInstanceCommandOutput, @@ -34,6 +62,9 @@ export class DeleteDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBParameterGroupCommand.ts b/clients/client-rds/commands/DeleteDBParameterGroupCommand.ts index cc66d2fcef883..e134a3114f2cc 100644 --- a/clients/client-rds/commands/DeleteDBParameterGroupCommand.ts +++ b/clients/client-rds/commands/DeleteDBParameterGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDBParameterGroupCommandInput = DeleteDBParameterGroupMessage; export type DeleteDBParameterGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a specified DB parameter group. The DB parameter group to be deleted can't be associated with any DB instances.

+ */ export class DeleteDBParameterGroupCommand extends $Command< DeleteDBParameterGroupCommandInput, DeleteDBParameterGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBProxyCommand.ts b/clients/client-rds/commands/DeleteDBProxyCommand.ts index 2130fa37aad87..bc8101ee1c1b1 100644 --- a/clients/client-rds/commands/DeleteDBProxyCommand.ts +++ b/clients/client-rds/commands/DeleteDBProxyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDBProxyCommandInput = DeleteDBProxyRequest; export type DeleteDBProxyCommandOutput = DeleteDBProxyResponse & __MetadataBearer; +/** + *

Deletes an existing proxy.

+ */ export class DeleteDBProxyCommand extends $Command< DeleteDBProxyCommandInput, DeleteDBProxyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDBProxyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBSecurityGroupCommand.ts b/clients/client-rds/commands/DeleteDBSecurityGroupCommand.ts index 31cb3b2836b99..4deccab96cbbb 100644 --- a/clients/client-rds/commands/DeleteDBSecurityGroupCommand.ts +++ b/clients/client-rds/commands/DeleteDBSecurityGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDBSecurityGroupCommandInput = DeleteDBSecurityGroupMessage; export type DeleteDBSecurityGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a DB security group.

+ * + *

The specified DB security group must not be associated with any DB instances.

+ *
+ */ export class DeleteDBSecurityGroupCommand extends $Command< DeleteDBSecurityGroupCommandInput, DeleteDBSecurityGroupCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDBSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBSnapshotCommand.ts b/clients/client-rds/commands/DeleteDBSnapshotCommand.ts index f8bd763b64327..691a7b9a0975c 100644 --- a/clients/client-rds/commands/DeleteDBSnapshotCommand.ts +++ b/clients/client-rds/commands/DeleteDBSnapshotCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteDBSnapshotCommandInput = DeleteDBSnapshotMessage; export type DeleteDBSnapshotCommandOutput = DeleteDBSnapshotResult & __MetadataBearer; +/** + *

Deletes a DB snapshot. If the snapshot is being copied, the copy operation is + * terminated.

+ * + *

The DB snapshot must be in the available state to be deleted.

+ *
+ */ export class DeleteDBSnapshotCommand extends $Command< DeleteDBSnapshotCommandInput, DeleteDBSnapshotCommandOutput, @@ -34,6 +41,9 @@ export class DeleteDBSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteDBSubnetGroupCommand.ts b/clients/client-rds/commands/DeleteDBSubnetGroupCommand.ts index 8ae3e089b2e79..3d8dadba35b82 100644 --- a/clients/client-rds/commands/DeleteDBSubnetGroupCommand.ts +++ b/clients/client-rds/commands/DeleteDBSubnetGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteDBSubnetGroupCommandInput = DeleteDBSubnetGroupMessage; export type DeleteDBSubnetGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a DB subnet group.

+ * + *

The specified database subnet group must not be associated with any DB instances.

+ *
+ */ export class DeleteDBSubnetGroupCommand extends $Command< DeleteDBSubnetGroupCommandInput, DeleteDBSubnetGroupCommandOutput, @@ -34,6 +40,9 @@ export class DeleteDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteEventSubscriptionCommand.ts b/clients/client-rds/commands/DeleteEventSubscriptionCommand.ts index b73199ca8f4af..083f501feceaf 100644 --- a/clients/client-rds/commands/DeleteEventSubscriptionCommand.ts +++ b/clients/client-rds/commands/DeleteEventSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEventSubscriptionCommandInput = DeleteEventSubscriptionMessage; export type DeleteEventSubscriptionCommandOutput = DeleteEventSubscriptionResult & __MetadataBearer; +/** + *

Deletes an RDS event notification subscription.

+ */ export class DeleteEventSubscriptionCommand extends $Command< DeleteEventSubscriptionCommandInput, DeleteEventSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteGlobalClusterCommand.ts b/clients/client-rds/commands/DeleteGlobalClusterCommand.ts index 8480d2803eed2..ad97eb0225ad1 100644 --- a/clients/client-rds/commands/DeleteGlobalClusterCommand.ts +++ b/clients/client-rds/commands/DeleteGlobalClusterCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteGlobalClusterCommandInput = DeleteGlobalClusterMessage; export type DeleteGlobalClusterCommandOutput = DeleteGlobalClusterResult & __MetadataBearer; +/** + *

+ * Deletes a global database cluster. The primary and secondary clusters must already be detached or + * destroyed first. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DeleteGlobalClusterCommand extends $Command< DeleteGlobalClusterCommandInput, DeleteGlobalClusterCommandOutput, @@ -34,6 +43,9 @@ export class DeleteGlobalClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteInstallationMediaCommand.ts b/clients/client-rds/commands/DeleteInstallationMediaCommand.ts index 0c3ca0fb46caa..06e862d2ab9fa 100644 --- a/clients/client-rds/commands/DeleteInstallationMediaCommand.ts +++ b/clients/client-rds/commands/DeleteInstallationMediaCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteInstallationMediaCommandInput = DeleteInstallationMediaMessage; export type DeleteInstallationMediaCommandOutput = InstallationMedia & __MetadataBearer; +/** + *

Deletes the installation medium for a DB engine that requires an on-premises customer provided license, + * such as Microsoft SQL Server.

+ */ export class DeleteInstallationMediaCommand extends $Command< DeleteInstallationMediaCommandInput, DeleteInstallationMediaCommandOutput, @@ -34,6 +38,9 @@ export class DeleteInstallationMediaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeleteOptionGroupCommand.ts b/clients/client-rds/commands/DeleteOptionGroupCommand.ts index 9893ac6f884ac..bf4d9b7a961be 100644 --- a/clients/client-rds/commands/DeleteOptionGroupCommand.ts +++ b/clients/client-rds/commands/DeleteOptionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteOptionGroupCommandInput = DeleteOptionGroupMessage; export type DeleteOptionGroupCommandOutput = __MetadataBearer; +/** + *

Deletes an existing option group.

+ */ export class DeleteOptionGroupCommand extends $Command< DeleteOptionGroupCommandInput, DeleteOptionGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteOptionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DeregisterDBProxyTargetsCommand.ts b/clients/client-rds/commands/DeregisterDBProxyTargetsCommand.ts index 6e7a532323684..ae837810c41c1 100644 --- a/clients/client-rds/commands/DeregisterDBProxyTargetsCommand.ts +++ b/clients/client-rds/commands/DeregisterDBProxyTargetsCommand.ts @@ -20,6 +20,9 @@ import { export type DeregisterDBProxyTargetsCommandInput = DeregisterDBProxyTargetsRequest; export type DeregisterDBProxyTargetsCommandOutput = DeregisterDBProxyTargetsResponse & __MetadataBearer; +/** + *

Remove the association between one or more DBProxyTarget data structures and a DBProxyTargetGroup.

+ */ export class DeregisterDBProxyTargetsCommand extends $Command< DeregisterDBProxyTargetsCommandInput, DeregisterDBProxyTargetsCommandOutput, @@ -34,6 +37,9 @@ export class DeregisterDBProxyTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeAccountAttributesCommand.ts b/clients/client-rds/commands/DescribeAccountAttributesCommand.ts index befa607d9e5e5..c3039991bfcb9 100644 --- a/clients/client-rds/commands/DescribeAccountAttributesCommand.ts +++ b/clients/client-rds/commands/DescribeAccountAttributesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAccountAttributesCommandInput = DescribeAccountAttributesMessage; export type DescribeAccountAttributesCommandOutput = AccountAttributesMessage & __MetadataBearer; +/** + *

Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.

+ *

This command doesn't take any parameters.

+ */ export class DescribeAccountAttributesCommand extends $Command< DescribeAccountAttributesCommandInput, DescribeAccountAttributesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAccountAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeCertificatesCommand.ts b/clients/client-rds/commands/DescribeCertificatesCommand.ts index fbeba0a6f24ad..f99b7c4eb818e 100644 --- a/clients/client-rds/commands/DescribeCertificatesCommand.ts +++ b/clients/client-rds/commands/DescribeCertificatesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCertificatesCommandInput = DescribeCertificatesMessage; export type DescribeCertificatesCommandOutput = CertificateMessage & __MetadataBearer; +/** + *

Lists the set of CA certificates provided by Amazon RDS for this AWS account.

+ */ export class DescribeCertificatesCommand extends $Command< DescribeCertificatesCommandInput, DescribeCertificatesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeCustomAvailabilityZonesCommand.ts b/clients/client-rds/commands/DescribeCustomAvailabilityZonesCommand.ts index f747956891441..3834f76c5618c 100644 --- a/clients/client-rds/commands/DescribeCustomAvailabilityZonesCommand.ts +++ b/clients/client-rds/commands/DescribeCustomAvailabilityZonesCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeCustomAvailabilityZonesCommandInput = DescribeCustomAvailabilityZonesMessage; export type DescribeCustomAvailabilityZonesCommandOutput = CustomAvailabilityZoneMessage & __MetadataBearer; +/** + *

Returns information about custom Availability Zones (AZs).

+ *

A custom AZ is an on-premises AZ that is integrated with a VMware vSphere cluster.

+ *

For more information about RDS on VMware, see the + * + * RDS on VMware User Guide. + * + *

+ */ export class DescribeCustomAvailabilityZonesCommand extends $Command< DescribeCustomAvailabilityZonesCommandInput, DescribeCustomAvailabilityZonesCommandOutput, @@ -34,6 +43,9 @@ export class DescribeCustomAvailabilityZonesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBClusterBacktracksCommand.ts b/clients/client-rds/commands/DescribeDBClusterBacktracksCommand.ts index a9582e4db743e..95336b11b74cb 100644 --- a/clients/client-rds/commands/DescribeDBClusterBacktracksCommand.ts +++ b/clients/client-rds/commands/DescribeDBClusterBacktracksCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeDBClusterBacktracksCommandInput = DescribeDBClusterBacktracksMessage; export type DescribeDBClusterBacktracksCommandOutput = DBClusterBacktrackMessage & __MetadataBearer; +/** + *

Returns information about backtracks for a DB cluster.

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora MySQL DB clusters.

+ *
+ */ export class DescribeDBClusterBacktracksCommand extends $Command< DescribeDBClusterBacktracksCommandInput, DescribeDBClusterBacktracksCommandOutput, @@ -34,6 +44,9 @@ export class DescribeDBClusterBacktracksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBClusterEndpointsCommand.ts b/clients/client-rds/commands/DescribeDBClusterEndpointsCommand.ts index 17d51131c19f4..3b2ed728a9588 100644 --- a/clients/client-rds/commands/DescribeDBClusterEndpointsCommand.ts +++ b/clients/client-rds/commands/DescribeDBClusterEndpointsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeDBClusterEndpointsCommandInput = DescribeDBClusterEndpointsMessage; export type DescribeDBClusterEndpointsCommandOutput = DBClusterEndpointMessage & __MetadataBearer; +/** + *

Returns information about endpoints for an Amazon Aurora DB cluster.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DescribeDBClusterEndpointsCommand extends $Command< DescribeDBClusterEndpointsCommandInput, DescribeDBClusterEndpointsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeDBClusterEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBClusterParameterGroupsCommand.ts b/clients/client-rds/commands/DescribeDBClusterParameterGroupsCommand.ts index c3598a30bcbf5..03e3188cbb3e1 100644 --- a/clients/client-rds/commands/DescribeDBClusterParameterGroupsCommand.ts +++ b/clients/client-rds/commands/DescribeDBClusterParameterGroupsCommand.ts @@ -20,6 +20,20 @@ import { export type DescribeDBClusterParameterGroupsCommandInput = DescribeDBClusterParameterGroupsMessage; export type DescribeDBClusterParameterGroupsCommandOutput = DBClusterParameterGroupsMessage & __MetadataBearer; +/** + *

+ * Returns a list of DBClusterParameterGroup descriptions. If a + * DBClusterParameterGroupName parameter is specified, + * the list will contain only the description of the specified DB cluster parameter group. + *

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DescribeDBClusterParameterGroupsCommand extends $Command< DescribeDBClusterParameterGroupsCommandInput, DescribeDBClusterParameterGroupsCommandOutput, @@ -34,6 +48,9 @@ export class DescribeDBClusterParameterGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBClusterParametersCommand.ts b/clients/client-rds/commands/DescribeDBClusterParametersCommand.ts index 07286ff56f14e..f192b104a47bc 100644 --- a/clients/client-rds/commands/DescribeDBClusterParametersCommand.ts +++ b/clients/client-rds/commands/DescribeDBClusterParametersCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeDBClusterParametersCommandInput = DescribeDBClusterParametersMessage; export type DescribeDBClusterParametersCommandOutput = DBClusterParameterGroupDetails & __MetadataBearer; +/** + *

Returns the detailed parameter list for a particular DB cluster parameter group.

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DescribeDBClusterParametersCommand extends $Command< DescribeDBClusterParametersCommandInput, DescribeDBClusterParametersCommandOutput, @@ -34,6 +44,9 @@ export class DescribeDBClusterParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBClusterSnapshotAttributesCommand.ts b/clients/client-rds/commands/DescribeDBClusterSnapshotAttributesCommand.ts index 55e09f3efb24a..107ab4645ab25 100644 --- a/clients/client-rds/commands/DescribeDBClusterSnapshotAttributesCommand.ts +++ b/clients/client-rds/commands/DescribeDBClusterSnapshotAttributesCommand.ts @@ -24,6 +24,19 @@ export type DescribeDBClusterSnapshotAttributesCommandInput = DescribeDBClusterS export type DescribeDBClusterSnapshotAttributesCommandOutput = DescribeDBClusterSnapshotAttributesResult & __MetadataBearer; +/** + *

Returns a list of DB cluster snapshot attribute names and values for a manual DB cluster snapshot.

+ *

When sharing snapshots with other AWS accounts, DescribeDBClusterSnapshotAttributes + * returns the restore attribute and a list of IDs for the AWS accounts that are + * authorized to copy or restore the manual DB cluster snapshot. If all is included in the list of + * values for the restore attribute, then the manual DB cluster snapshot is public and + * can be copied or restored by all AWS accounts.

+ *

To add or remove access for an AWS account to copy or restore a manual DB cluster snapshot, or to make the + * manual DB cluster snapshot public or private, use the ModifyDBClusterSnapshotAttribute API action.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DescribeDBClusterSnapshotAttributesCommand extends $Command< DescribeDBClusterSnapshotAttributesCommandInput, DescribeDBClusterSnapshotAttributesCommandOutput, @@ -38,6 +51,9 @@ export class DescribeDBClusterSnapshotAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBClusterSnapshotsCommand.ts b/clients/client-rds/commands/DescribeDBClusterSnapshotsCommand.ts index f612b50b096ee..cd9a9c8536603 100644 --- a/clients/client-rds/commands/DescribeDBClusterSnapshotsCommand.ts +++ b/clients/client-rds/commands/DescribeDBClusterSnapshotsCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeDBClusterSnapshotsCommandInput = DescribeDBClusterSnapshotsMessage; export type DescribeDBClusterSnapshotsCommandOutput = DBClusterSnapshotMessage & __MetadataBearer; +/** + *

Returns information about DB cluster snapshots. This API action supports pagination.

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DescribeDBClusterSnapshotsCommand extends $Command< DescribeDBClusterSnapshotsCommandInput, DescribeDBClusterSnapshotsCommandOutput, @@ -34,6 +44,9 @@ export class DescribeDBClusterSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBClustersCommand.ts b/clients/client-rds/commands/DescribeDBClustersCommand.ts index a305d24b5aa8b..82e9b8f81bce1 100644 --- a/clients/client-rds/commands/DescribeDBClustersCommand.ts +++ b/clients/client-rds/commands/DescribeDBClustersCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeDBClustersCommandInput = DescribeDBClustersMessage; export type DescribeDBClustersCommandOutput = DBClusterMessage & __MetadataBearer; +/** + *

Returns information about provisioned Aurora DB clusters. This API supports pagination.

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.

+ *
+ */ export class DescribeDBClustersCommand extends $Command< DescribeDBClustersCommandInput, DescribeDBClustersCommandOutput, @@ -34,6 +44,9 @@ export class DescribeDBClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBEngineVersionsCommand.ts b/clients/client-rds/commands/DescribeDBEngineVersionsCommand.ts index 99efde5279a11..e3a58d3cecf72 100644 --- a/clients/client-rds/commands/DescribeDBEngineVersionsCommand.ts +++ b/clients/client-rds/commands/DescribeDBEngineVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBEngineVersionsCommandInput = DescribeDBEngineVersionsMessage; export type DescribeDBEngineVersionsCommandOutput = DBEngineVersionMessage & __MetadataBearer; +/** + *

Returns a list of the available DB engines.

+ */ export class DescribeDBEngineVersionsCommand extends $Command< DescribeDBEngineVersionsCommandInput, DescribeDBEngineVersionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBEngineVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBInstanceAutomatedBackupsCommand.ts b/clients/client-rds/commands/DescribeDBInstanceAutomatedBackupsCommand.ts index 3179e9fed67f7..4678a01db2cea 100644 --- a/clients/client-rds/commands/DescribeDBInstanceAutomatedBackupsCommand.ts +++ b/clients/client-rds/commands/DescribeDBInstanceAutomatedBackupsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeDBInstanceAutomatedBackupsCommandInput = DescribeDBInstanceAutomatedBackupsMessage; export type DescribeDBInstanceAutomatedBackupsCommandOutput = DBInstanceAutomatedBackupMessage & __MetadataBearer; +/** + *

Displays backups for both current and deleted + * instances. For example, use this operation to + * find details about automated backups for previously deleted instances. Current instances + * with retention periods greater than zero (0) are returned for both the + * DescribeDBInstanceAutomatedBackups and + * DescribeDBInstances operations.

+ *

All parameters are optional.

+ */ export class DescribeDBInstanceAutomatedBackupsCommand extends $Command< DescribeDBInstanceAutomatedBackupsCommandInput, DescribeDBInstanceAutomatedBackupsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeDBInstanceAutomatedBackupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBInstancesCommand.ts b/clients/client-rds/commands/DescribeDBInstancesCommand.ts index 30b980aeb3bb3..08ba0453bcafc 100644 --- a/clients/client-rds/commands/DescribeDBInstancesCommand.ts +++ b/clients/client-rds/commands/DescribeDBInstancesCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeDBInstancesCommandInput = DescribeDBInstancesMessage; export type DescribeDBInstancesCommandOutput = DBInstanceMessage & __MetadataBearer; +/** + *

Returns information about provisioned RDS instances. This API supports pagination.

+ * + *

This operation can also return information for Amazon Neptune DB instances and Amazon DocumentDB instances.

+ *
+ */ export class DescribeDBInstancesCommand extends $Command< DescribeDBInstancesCommandInput, DescribeDBInstancesCommandOutput, @@ -34,6 +40,9 @@ export class DescribeDBInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBLogFilesCommand.ts b/clients/client-rds/commands/DescribeDBLogFilesCommand.ts index 1ff852117a855..710e9a46c958e 100644 --- a/clients/client-rds/commands/DescribeDBLogFilesCommand.ts +++ b/clients/client-rds/commands/DescribeDBLogFilesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBLogFilesCommandInput = DescribeDBLogFilesMessage; export type DescribeDBLogFilesCommandOutput = DescribeDBLogFilesResponse & __MetadataBearer; +/** + *

Returns a list of DB log files for the DB instance.

+ */ export class DescribeDBLogFilesCommand extends $Command< DescribeDBLogFilesCommandInput, DescribeDBLogFilesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBLogFilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBParameterGroupsCommand.ts b/clients/client-rds/commands/DescribeDBParameterGroupsCommand.ts index 7690edc7d1eee..c2f158638326f 100644 --- a/clients/client-rds/commands/DescribeDBParameterGroupsCommand.ts +++ b/clients/client-rds/commands/DescribeDBParameterGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeDBParameterGroupsCommandInput = DescribeDBParameterGroupsMessage; export type DescribeDBParameterGroupsCommandOutput = DBParameterGroupsMessage & __MetadataBearer; +/** + *

+ * Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified, + * the list will contain only the description of the specified DB parameter group. + *

+ */ export class DescribeDBParameterGroupsCommand extends $Command< DescribeDBParameterGroupsCommandInput, DescribeDBParameterGroupsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeDBParameterGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBParametersCommand.ts b/clients/client-rds/commands/DescribeDBParametersCommand.ts index d4c1c7ac60d45..ee2d2595b0ce9 100644 --- a/clients/client-rds/commands/DescribeDBParametersCommand.ts +++ b/clients/client-rds/commands/DescribeDBParametersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBParametersCommandInput = DescribeDBParametersMessage; export type DescribeDBParametersCommandOutput = DBParameterGroupDetails & __MetadataBearer; +/** + *

Returns the detailed parameter list for a particular DB parameter group.

+ */ export class DescribeDBParametersCommand extends $Command< DescribeDBParametersCommandInput, DescribeDBParametersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBProxiesCommand.ts b/clients/client-rds/commands/DescribeDBProxiesCommand.ts index 16362c5cfbab1..31e35d25765f2 100644 --- a/clients/client-rds/commands/DescribeDBProxiesCommand.ts +++ b/clients/client-rds/commands/DescribeDBProxiesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBProxiesCommandInput = DescribeDBProxiesRequest; export type DescribeDBProxiesCommandOutput = DescribeDBProxiesResponse & __MetadataBearer; +/** + *

Returns information about DB proxies.

+ */ export class DescribeDBProxiesCommand extends $Command< DescribeDBProxiesCommandInput, DescribeDBProxiesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBProxiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBProxyTargetGroupsCommand.ts b/clients/client-rds/commands/DescribeDBProxyTargetGroupsCommand.ts index ef7b12898d550..2e7939c16eb1c 100644 --- a/clients/client-rds/commands/DescribeDBProxyTargetGroupsCommand.ts +++ b/clients/client-rds/commands/DescribeDBProxyTargetGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBProxyTargetGroupsCommandInput = DescribeDBProxyTargetGroupsRequest; export type DescribeDBProxyTargetGroupsCommandOutput = DescribeDBProxyTargetGroupsResponse & __MetadataBearer; +/** + *

Returns information about DB proxy target groups, represented by DBProxyTargetGroup data structures.

+ */ export class DescribeDBProxyTargetGroupsCommand extends $Command< DescribeDBProxyTargetGroupsCommandInput, DescribeDBProxyTargetGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBProxyTargetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBProxyTargetsCommand.ts b/clients/client-rds/commands/DescribeDBProxyTargetsCommand.ts index 2c97b6f625de5..ec435249a7f5c 100644 --- a/clients/client-rds/commands/DescribeDBProxyTargetsCommand.ts +++ b/clients/client-rds/commands/DescribeDBProxyTargetsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBProxyTargetsCommandInput = DescribeDBProxyTargetsRequest; export type DescribeDBProxyTargetsCommandOutput = DescribeDBProxyTargetsResponse & __MetadataBearer; +/** + *

Returns information about DBProxyTarget objects. This API supports pagination.

+ */ export class DescribeDBProxyTargetsCommand extends $Command< DescribeDBProxyTargetsCommandInput, DescribeDBProxyTargetsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBProxyTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBSecurityGroupsCommand.ts b/clients/client-rds/commands/DescribeDBSecurityGroupsCommand.ts index 30c7ef7af5a10..4c856579cec09 100644 --- a/clients/client-rds/commands/DescribeDBSecurityGroupsCommand.ts +++ b/clients/client-rds/commands/DescribeDBSecurityGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeDBSecurityGroupsCommandInput = DescribeDBSecurityGroupsMessage; export type DescribeDBSecurityGroupsCommandOutput = DBSecurityGroupMessage & __MetadataBearer; +/** + *

+ * Returns a list of DBSecurityGroup descriptions. If a DBSecurityGroupName is specified, + * the list will contain only the descriptions of the specified DB security group. + *

+ */ export class DescribeDBSecurityGroupsCommand extends $Command< DescribeDBSecurityGroupsCommandInput, DescribeDBSecurityGroupsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeDBSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBSnapshotAttributesCommand.ts b/clients/client-rds/commands/DescribeDBSnapshotAttributesCommand.ts index 88610079cf29a..8fe33fdab1fe6 100644 --- a/clients/client-rds/commands/DescribeDBSnapshotAttributesCommand.ts +++ b/clients/client-rds/commands/DescribeDBSnapshotAttributesCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeDBSnapshotAttributesCommandInput = DescribeDBSnapshotAttributesMessage; export type DescribeDBSnapshotAttributesCommandOutput = DescribeDBSnapshotAttributesResult & __MetadataBearer; +/** + *

Returns a list of DB snapshot attribute names and values for a manual DB snapshot.

+ *

When sharing snapshots with other AWS accounts, DescribeDBSnapshotAttributes + * returns the restore attribute and a list of IDs for the AWS accounts that are + * authorized to copy or restore the manual DB snapshot. If all is included in the list of + * values for the restore attribute, then the manual DB snapshot is public and + * can be copied or restored by all AWS accounts.

+ *

To add or remove access for an AWS account to copy or restore a manual DB snapshot, or to make the + * manual DB snapshot public or private, use the ModifyDBSnapshotAttribute API action.

+ */ export class DescribeDBSnapshotAttributesCommand extends $Command< DescribeDBSnapshotAttributesCommandInput, DescribeDBSnapshotAttributesCommandOutput, @@ -34,6 +44,9 @@ export class DescribeDBSnapshotAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBSnapshotsCommand.ts b/clients/client-rds/commands/DescribeDBSnapshotsCommand.ts index 7699bb4394633..35ff368e97408 100644 --- a/clients/client-rds/commands/DescribeDBSnapshotsCommand.ts +++ b/clients/client-rds/commands/DescribeDBSnapshotsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDBSnapshotsCommandInput = DescribeDBSnapshotsMessage; export type DescribeDBSnapshotsCommandOutput = DBSnapshotMessage & __MetadataBearer; +/** + *

Returns information about DB snapshots. This API action supports pagination.

+ */ export class DescribeDBSnapshotsCommand extends $Command< DescribeDBSnapshotsCommandInput, DescribeDBSnapshotsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDBSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeDBSubnetGroupsCommand.ts b/clients/client-rds/commands/DescribeDBSubnetGroupsCommand.ts index 921e4792cc90f..eaa8ce5741670 100644 --- a/clients/client-rds/commands/DescribeDBSubnetGroupsCommand.ts +++ b/clients/client-rds/commands/DescribeDBSubnetGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeDBSubnetGroupsCommandInput = DescribeDBSubnetGroupsMessage; export type DescribeDBSubnetGroupsCommandOutput = DBSubnetGroupMessage & __MetadataBearer; +/** + *

Returns a list of DBSubnetGroup descriptions. If a DBSubnetGroupName is specified, the list will contain only the descriptions of the specified DBSubnetGroup.

+ *

For an overview of CIDR ranges, go to the + * Wikipedia Tutorial. + *

+ */ export class DescribeDBSubnetGroupsCommand extends $Command< DescribeDBSubnetGroupsCommandInput, DescribeDBSubnetGroupsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeDBSubnetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeEngineDefaultClusterParametersCommand.ts b/clients/client-rds/commands/DescribeEngineDefaultClusterParametersCommand.ts index ce03d9697c085..ed9f1cdfb02e6 100644 --- a/clients/client-rds/commands/DescribeEngineDefaultClusterParametersCommand.ts +++ b/clients/client-rds/commands/DescribeEngineDefaultClusterParametersCommand.ts @@ -24,6 +24,13 @@ export type DescribeEngineDefaultClusterParametersCommandInput = DescribeEngineD export type DescribeEngineDefaultClusterParametersCommandOutput = DescribeEngineDefaultClusterParametersResult & __MetadataBearer; +/** + *

Returns the default engine and system parameter information for the cluster database engine.

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ */ export class DescribeEngineDefaultClusterParametersCommand extends $Command< DescribeEngineDefaultClusterParametersCommandInput, DescribeEngineDefaultClusterParametersCommandOutput, @@ -38,6 +45,9 @@ export class DescribeEngineDefaultClusterParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeEngineDefaultParametersCommand.ts b/clients/client-rds/commands/DescribeEngineDefaultParametersCommand.ts index 5cd3816d3609c..37c4a023b1919 100644 --- a/clients/client-rds/commands/DescribeEngineDefaultParametersCommand.ts +++ b/clients/client-rds/commands/DescribeEngineDefaultParametersCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEngineDefaultParametersCommandInput = DescribeEngineDefaultParametersMessage; export type DescribeEngineDefaultParametersCommandOutput = DescribeEngineDefaultParametersResult & __MetadataBearer; +/** + *

Returns the default engine and system parameter information for the specified database engine.

+ */ export class DescribeEngineDefaultParametersCommand extends $Command< DescribeEngineDefaultParametersCommandInput, DescribeEngineDefaultParametersCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEngineDefaultParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeEventCategoriesCommand.ts b/clients/client-rds/commands/DescribeEventCategoriesCommand.ts index edf7ffe8be9b2..9236b9a53adb3 100644 --- a/clients/client-rds/commands/DescribeEventCategoriesCommand.ts +++ b/clients/client-rds/commands/DescribeEventCategoriesCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeEventCategoriesCommandInput = DescribeEventCategoriesMessage; export type DescribeEventCategoriesCommandOutput = EventCategoriesMessage & __MetadataBearer; +/** + *

Displays a list of categories for all event source types, or, if specified, for a specified source type. + * You can see a list of the event categories and source types + * in + * Events in the Amazon RDS User Guide. + *

+ */ export class DescribeEventCategoriesCommand extends $Command< DescribeEventCategoriesCommandInput, DescribeEventCategoriesCommandOutput, @@ -34,6 +41,9 @@ export class DescribeEventCategoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeEventSubscriptionsCommand.ts b/clients/client-rds/commands/DescribeEventSubscriptionsCommand.ts index 551d4fde965a1..60f8e90c3b72d 100644 --- a/clients/client-rds/commands/DescribeEventSubscriptionsCommand.ts +++ b/clients/client-rds/commands/DescribeEventSubscriptionsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeEventSubscriptionsCommandInput = DescribeEventSubscriptionsMessage; export type DescribeEventSubscriptionsCommandOutput = EventSubscriptionsMessage & __MetadataBearer; +/** + *

Lists all the subscription descriptions for a customer account. The description for a subscription includes + * SubscriptionName, SNSTopicARN, CustomerID, SourceType, SourceID, CreationTime, and Status.

+ *

If you specify a SubscriptionName, lists the description for that subscription.

+ */ export class DescribeEventSubscriptionsCommand extends $Command< DescribeEventSubscriptionsCommandInput, DescribeEventSubscriptionsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeEventSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeEventsCommand.ts b/clients/client-rds/commands/DescribeEventsCommand.ts index ee57868f777ad..f918a5f92e772 100644 --- a/clients/client-rds/commands/DescribeEventsCommand.ts +++ b/clients/client-rds/commands/DescribeEventsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeEventsCommandInput = DescribeEventsMessage; export type DescribeEventsCommandOutput = EventsMessage & __MetadataBearer; +/** + *

Returns events related to DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, and DB cluster snapshots for the past 14 days. + * Events specific to a particular DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, and DB cluster snapshots group can be + * obtained by providing the name as a parameter.

+ * + *

By default, the past hour of events are returned.

+ *
+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeExportTasksCommand.ts b/clients/client-rds/commands/DescribeExportTasksCommand.ts index 48926fbfbc55a..395c6e63bd445 100644 --- a/clients/client-rds/commands/DescribeExportTasksCommand.ts +++ b/clients/client-rds/commands/DescribeExportTasksCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeExportTasksCommandInput = DescribeExportTasksMessage; export type DescribeExportTasksCommandOutput = ExportTasksMessage & __MetadataBearer; +/** + *

Returns information about a snapshot export to Amazon S3. This API operation supports + * pagination.

+ */ export class DescribeExportTasksCommand extends $Command< DescribeExportTasksCommandInput, DescribeExportTasksCommandOutput, @@ -34,6 +38,9 @@ export class DescribeExportTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeGlobalClustersCommand.ts b/clients/client-rds/commands/DescribeGlobalClustersCommand.ts index 9a5d94fd30e41..6696d3617de13 100644 --- a/clients/client-rds/commands/DescribeGlobalClustersCommand.ts +++ b/clients/client-rds/commands/DescribeGlobalClustersCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeGlobalClustersCommandInput = DescribeGlobalClustersMessage; export type DescribeGlobalClustersCommandOutput = GlobalClustersMessage & __MetadataBearer; +/** + *

+ * Returns information about Aurora global database clusters. This API supports pagination. + *

+ *

+ * For more information on Amazon Aurora, see What Is Amazon Aurora? in the + * Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class DescribeGlobalClustersCommand extends $Command< DescribeGlobalClustersCommandInput, DescribeGlobalClustersCommandOutput, @@ -34,6 +46,9 @@ export class DescribeGlobalClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeInstallationMediaCommand.ts b/clients/client-rds/commands/DescribeInstallationMediaCommand.ts index 865b52b347713..cf50131b76346 100644 --- a/clients/client-rds/commands/DescribeInstallationMediaCommand.ts +++ b/clients/client-rds/commands/DescribeInstallationMediaCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeInstallationMediaCommandInput = DescribeInstallationMediaMessage; export type DescribeInstallationMediaCommandOutput = InstallationMediaMessage & __MetadataBearer; +/** + *

Describes the available installation media for a DB engine that requires an + * on-premises customer provided license, such as Microsoft SQL Server.

+ */ export class DescribeInstallationMediaCommand extends $Command< DescribeInstallationMediaCommandInput, DescribeInstallationMediaCommandOutput, @@ -34,6 +38,9 @@ export class DescribeInstallationMediaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeOptionGroupOptionsCommand.ts b/clients/client-rds/commands/DescribeOptionGroupOptionsCommand.ts index 303a48aff6aae..73e78329a2ac9 100644 --- a/clients/client-rds/commands/DescribeOptionGroupOptionsCommand.ts +++ b/clients/client-rds/commands/DescribeOptionGroupOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOptionGroupOptionsCommandInput = DescribeOptionGroupOptionsMessage; export type DescribeOptionGroupOptionsCommandOutput = OptionGroupOptionsMessage & __MetadataBearer; +/** + *

Describes all available options.

+ */ export class DescribeOptionGroupOptionsCommand extends $Command< DescribeOptionGroupOptionsCommandInput, DescribeOptionGroupOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOptionGroupOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeOptionGroupsCommand.ts b/clients/client-rds/commands/DescribeOptionGroupsCommand.ts index eefda17acb797..038d45cc1d92d 100644 --- a/clients/client-rds/commands/DescribeOptionGroupsCommand.ts +++ b/clients/client-rds/commands/DescribeOptionGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOptionGroupsCommandInput = DescribeOptionGroupsMessage; export type DescribeOptionGroupsCommandOutput = OptionGroups & __MetadataBearer; +/** + *

Describes the available option groups.

+ */ export class DescribeOptionGroupsCommand extends $Command< DescribeOptionGroupsCommandInput, DescribeOptionGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOptionGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeOrderableDBInstanceOptionsCommand.ts b/clients/client-rds/commands/DescribeOrderableDBInstanceOptionsCommand.ts index 8111d6081d28a..d3ef7397df371 100644 --- a/clients/client-rds/commands/DescribeOrderableDBInstanceOptionsCommand.ts +++ b/clients/client-rds/commands/DescribeOrderableDBInstanceOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeOrderableDBInstanceOptionsCommandInput = DescribeOrderableDBInstanceOptionsMessage; export type DescribeOrderableDBInstanceOptionsCommandOutput = OrderableDBInstanceOptionsMessage & __MetadataBearer; +/** + *

Returns a list of orderable DB instance options for the specified engine.

+ */ export class DescribeOrderableDBInstanceOptionsCommand extends $Command< DescribeOrderableDBInstanceOptionsCommandInput, DescribeOrderableDBInstanceOptionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeOrderableDBInstanceOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribePendingMaintenanceActionsCommand.ts b/clients/client-rds/commands/DescribePendingMaintenanceActionsCommand.ts index e5a09bf09c6c0..6d2e3bf8dfa3a 100644 --- a/clients/client-rds/commands/DescribePendingMaintenanceActionsCommand.ts +++ b/clients/client-rds/commands/DescribePendingMaintenanceActionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePendingMaintenanceActionsCommandInput = DescribePendingMaintenanceActionsMessage; export type DescribePendingMaintenanceActionsCommandOutput = PendingMaintenanceActionsMessage & __MetadataBearer; +/** + *

Returns a list of resources (for example, DB instances) that have at least one pending maintenance action.

+ */ export class DescribePendingMaintenanceActionsCommand extends $Command< DescribePendingMaintenanceActionsCommandInput, DescribePendingMaintenanceActionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribePendingMaintenanceActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeReservedDBInstancesCommand.ts b/clients/client-rds/commands/DescribeReservedDBInstancesCommand.ts index faf3f17b9b6ad..6fbf0f3c018e5 100644 --- a/clients/client-rds/commands/DescribeReservedDBInstancesCommand.ts +++ b/clients/client-rds/commands/DescribeReservedDBInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeReservedDBInstancesCommandInput = DescribeReservedDBInstancesMessage; export type DescribeReservedDBInstancesCommandOutput = ReservedDBInstanceMessage & __MetadataBearer; +/** + *

Returns information about reserved DB instances for this account, or about a specified reserved DB instance.

+ */ export class DescribeReservedDBInstancesCommand extends $Command< DescribeReservedDBInstancesCommandInput, DescribeReservedDBInstancesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeReservedDBInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeReservedDBInstancesOfferingsCommand.ts b/clients/client-rds/commands/DescribeReservedDBInstancesOfferingsCommand.ts index 4547bd83e9824..adc988fae74a6 100644 --- a/clients/client-rds/commands/DescribeReservedDBInstancesOfferingsCommand.ts +++ b/clients/client-rds/commands/DescribeReservedDBInstancesOfferingsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeReservedDBInstancesOfferingsCommandInput = DescribeReservedDBInstancesOfferingsMessage; export type DescribeReservedDBInstancesOfferingsCommandOutput = ReservedDBInstancesOfferingMessage & __MetadataBearer; +/** + *

Lists available reserved DB instance offerings.

+ */ export class DescribeReservedDBInstancesOfferingsCommand extends $Command< DescribeReservedDBInstancesOfferingsCommandInput, DescribeReservedDBInstancesOfferingsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeReservedDBInstancesOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeSourceRegionsCommand.ts b/clients/client-rds/commands/DescribeSourceRegionsCommand.ts index 27177793f31b6..6df7fc350ce9a 100644 --- a/clients/client-rds/commands/DescribeSourceRegionsCommand.ts +++ b/clients/client-rds/commands/DescribeSourceRegionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSourceRegionsCommandInput = DescribeSourceRegionsMessage; export type DescribeSourceRegionsCommandOutput = SourceRegionMessage & __MetadataBearer; +/** + *

Returns a list of the source AWS Regions where the current AWS Region can create a + * read replica or copy a DB snapshot from. This API action supports pagination.

+ */ export class DescribeSourceRegionsCommand extends $Command< DescribeSourceRegionsCommandInput, DescribeSourceRegionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSourceRegionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DescribeValidDBInstanceModificationsCommand.ts b/clients/client-rds/commands/DescribeValidDBInstanceModificationsCommand.ts index e400e34b7e117..c89d78a952ac1 100644 --- a/clients/client-rds/commands/DescribeValidDBInstanceModificationsCommand.ts +++ b/clients/client-rds/commands/DescribeValidDBInstanceModificationsCommand.ts @@ -24,6 +24,13 @@ export type DescribeValidDBInstanceModificationsCommandInput = DescribeValidDBIn export type DescribeValidDBInstanceModificationsCommandOutput = DescribeValidDBInstanceModificationsResult & __MetadataBearer; +/** + *

You can call DescribeValidDBInstanceModifications + * to learn what modifications you can make to your DB instance. + * You can use this information when you call + * ModifyDBInstance. + *

+ */ export class DescribeValidDBInstanceModificationsCommand extends $Command< DescribeValidDBInstanceModificationsCommandInput, DescribeValidDBInstanceModificationsCommandOutput, @@ -38,6 +45,9 @@ export class DescribeValidDBInstanceModificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/DownloadDBLogFilePortionCommand.ts b/clients/client-rds/commands/DownloadDBLogFilePortionCommand.ts index c4af7fd3e0416..66c11acf0fe02 100644 --- a/clients/client-rds/commands/DownloadDBLogFilePortionCommand.ts +++ b/clients/client-rds/commands/DownloadDBLogFilePortionCommand.ts @@ -20,6 +20,9 @@ import { export type DownloadDBLogFilePortionCommandInput = DownloadDBLogFilePortionMessage; export type DownloadDBLogFilePortionCommandOutput = DownloadDBLogFilePortionDetails & __MetadataBearer; +/** + *

Downloads all or a portion of the specified log file, up to 1 MB in size.

+ */ export class DownloadDBLogFilePortionCommand extends $Command< DownloadDBLogFilePortionCommandInput, DownloadDBLogFilePortionCommandOutput, @@ -34,6 +37,9 @@ export class DownloadDBLogFilePortionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/FailoverDBClusterCommand.ts b/clients/client-rds/commands/FailoverDBClusterCommand.ts index 07372b23a602d..a8274686f393f 100644 --- a/clients/client-rds/commands/FailoverDBClusterCommand.ts +++ b/clients/client-rds/commands/FailoverDBClusterCommand.ts @@ -20,6 +20,22 @@ import { export type FailoverDBClusterCommandInput = FailoverDBClusterMessage; export type FailoverDBClusterCommandOutput = FailoverDBClusterResult & __MetadataBearer; +/** + *

Forces a failover for a DB cluster.

+ *

A failover for a DB cluster promotes one of the Aurora Replicas (read-only instances) + * in the DB cluster to be the primary instance (the cluster writer).

+ *

Amazon Aurora will automatically fail over to an Aurora Replica, if one exists, + * when the primary instance fails. You can force a failover when you want to simulate a failure of a primary instance for testing. + * Because each instance in a DB cluster has its own endpoint address, you will need to clean up and re-establish any existing + * connections that use those endpoint addresses when the failover is complete.

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class FailoverDBClusterCommand extends $Command< FailoverDBClusterCommandInput, FailoverDBClusterCommandOutput, @@ -34,6 +50,9 @@ export class FailoverDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ImportInstallationMediaCommand.ts b/clients/client-rds/commands/ImportInstallationMediaCommand.ts index fe09fd0bd40a7..3d39a14a9b4e5 100644 --- a/clients/client-rds/commands/ImportInstallationMediaCommand.ts +++ b/clients/client-rds/commands/ImportInstallationMediaCommand.ts @@ -21,6 +21,10 @@ import { export type ImportInstallationMediaCommandInput = ImportInstallationMediaMessage; export type ImportInstallationMediaCommandOutput = InstallationMedia & __MetadataBearer; +/** + *

Imports the installation media for a DB engine that requires an on-premises + * customer provided license, such as SQL Server.

+ */ export class ImportInstallationMediaCommand extends $Command< ImportInstallationMediaCommandInput, ImportInstallationMediaCommandOutput, @@ -35,6 +39,9 @@ export class ImportInstallationMediaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ListTagsForResourceCommand.ts b/clients/client-rds/commands/ListTagsForResourceCommand.ts index 68ae3d5b94aa9..23e747c4372cc 100644 --- a/clients/client-rds/commands/ListTagsForResourceCommand.ts +++ b/clients/client-rds/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,12 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceMessage; export type ListTagsForResourceCommandOutput = TagListMessage & __MetadataBearer; +/** + *

Lists all tags on an Amazon RDS resource.

+ *

For an overview on tagging an Amazon RDS resource, + * see Tagging Amazon RDS Resources + * in the Amazon RDS User Guide.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +40,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyCertificatesCommand.ts b/clients/client-rds/commands/ModifyCertificatesCommand.ts index 08542b436ef62..20269b2eefa93 100644 --- a/clients/client-rds/commands/ModifyCertificatesCommand.ts +++ b/clients/client-rds/commands/ModifyCertificatesCommand.ts @@ -20,6 +20,33 @@ import { export type ModifyCertificatesCommandInput = ModifyCertificatesMessage; export type ModifyCertificatesCommandOutput = ModifyCertificatesResult & __MetadataBearer; +/** + *

Override the system-default Secure Sockets Layer/Transport Layer Security (SSL/TLS) + * certificate for Amazon RDS for new DB instances temporarily, or remove the override.

+ *

By using this operation, you can specify an RDS-approved SSL/TLS certificate for new DB + * instances that is different from the default certificate provided by RDS. You can also + * use this operation to remove the override, so that new DB instances use the default + * certificate provided by RDS.

+ *

You might need to override the default certificate in the following situations:

+ *
    + *
  • + *

    You already migrated your applications to support the latest certificate authority (CA) certificate, but the new CA certificate is not yet + * the RDS default CA certificate for the specified AWS Region.

    + *
  • + *
  • + *

    RDS has already moved to a new default CA certificate for the specified AWS + * Region, but you are still in the process of supporting the new CA certificate. + * In this case, you temporarily need additional time to finish your application + * changes.

    + *
  • + *
+ *

For more information about rotating your SSL/TLS certificate for RDS DB engines, see + * + * Rotating Your SSL/TLS Certificate in the Amazon RDS User Guide.

+ *

For more information about rotating your SSL/TLS certificate for Aurora DB engines, see + * + * Rotating Your SSL/TLS Certificate in the Amazon Aurora User Guide.

+ */ export class ModifyCertificatesCommand extends $Command< ModifyCertificatesCommandInput, ModifyCertificatesCommandOutput, @@ -34,6 +61,9 @@ export class ModifyCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyCurrentDBClusterCapacityCommand.ts b/clients/client-rds/commands/ModifyCurrentDBClusterCapacityCommand.ts index 2802965b3796c..56213675c5d38 100644 --- a/clients/client-rds/commands/ModifyCurrentDBClusterCapacityCommand.ts +++ b/clients/client-rds/commands/ModifyCurrentDBClusterCapacityCommand.ts @@ -20,6 +20,26 @@ import { export type ModifyCurrentDBClusterCapacityCommandInput = ModifyCurrentDBClusterCapacityMessage; export type ModifyCurrentDBClusterCapacityCommandOutput = DBClusterCapacityInfo & __MetadataBearer; +/** + *

Set the capacity of an Aurora Serverless DB cluster to a specific value.

+ *

Aurora Serverless scales seamlessly based on the workload on the DB cluster. In some cases, the capacity might not scale + * fast enough to meet a sudden change in workload, such as a large number of new transactions. Call ModifyCurrentDBClusterCapacity + * to set the capacity explicitly.

+ *

After this call sets the DB cluster capacity, Aurora Serverless can automatically scale + * the DB cluster based on the cooldown period for scaling up and the cooldown period + * for scaling down.

+ *

For more information about Aurora Serverless, see Using Amazon Aurora Serverless in the + * Amazon Aurora User Guide.

+ * + *

If you call ModifyCurrentDBClusterCapacity with the default TimeoutAction, connections that + * prevent Aurora Serverless from finding a scaling point might be dropped. For more information about scaling points, + * see + * Autoscaling for Aurora Serverless in the Amazon Aurora User Guide.

+ *
+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class ModifyCurrentDBClusterCapacityCommand extends $Command< ModifyCurrentDBClusterCapacityCommandInput, ModifyCurrentDBClusterCapacityCommandOutput, @@ -34,6 +54,9 @@ export class ModifyCurrentDBClusterCapacityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBClusterCommand.ts b/clients/client-rds/commands/ModifyDBClusterCommand.ts index be9cace815f34..87bc8b3e5d8bb 100644 --- a/clients/client-rds/commands/ModifyDBClusterCommand.ts +++ b/clients/client-rds/commands/ModifyDBClusterCommand.ts @@ -20,6 +20,18 @@ import { export type ModifyDBClusterCommandInput = ModifyDBClusterMessage; export type ModifyDBClusterCommandOutput = ModifyDBClusterResult & __MetadataBearer; +/** + *

Modify a setting for an Amazon Aurora DB cluster. + * You can change one + * or more database configuration parameters by specifying these parameters and the new values in the + * request. For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class ModifyDBClusterCommand extends $Command< ModifyDBClusterCommandInput, ModifyDBClusterCommandOutput, @@ -34,6 +46,9 @@ export class ModifyDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBClusterEndpointCommand.ts b/clients/client-rds/commands/ModifyDBClusterEndpointCommand.ts index 5b698f3e9adf7..4a24465a8e494 100644 --- a/clients/client-rds/commands/ModifyDBClusterEndpointCommand.ts +++ b/clients/client-rds/commands/ModifyDBClusterEndpointCommand.ts @@ -21,6 +21,12 @@ import { export type ModifyDBClusterEndpointCommandInput = ModifyDBClusterEndpointMessage; export type ModifyDBClusterEndpointCommandOutput = DBClusterEndpoint & __MetadataBearer; +/** + *

Modifies the properties of an endpoint in an Amazon Aurora DB cluster.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class ModifyDBClusterEndpointCommand extends $Command< ModifyDBClusterEndpointCommandInput, ModifyDBClusterEndpointCommandOutput, @@ -35,6 +41,9 @@ export class ModifyDBClusterEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBClusterParameterGroupCommand.ts b/clients/client-rds/commands/ModifyDBClusterParameterGroupCommand.ts index 2b8189e94f6b8..75030fc311263 100644 --- a/clients/client-rds/commands/ModifyDBClusterParameterGroupCommand.ts +++ b/clients/client-rds/commands/ModifyDBClusterParameterGroupCommand.ts @@ -20,6 +20,39 @@ import { export type ModifyDBClusterParameterGroupCommandInput = ModifyDBClusterParameterGroupMessage; export type ModifyDBClusterParameterGroupCommandOutput = DBClusterParameterGroupNameMessage & __MetadataBearer; +/** + *

+ * Modifies the parameters of a DB cluster parameter group. To modify more than one parameter, + * submit a list of the following: ParameterName, ParameterValue, + * and ApplyMethod. A maximum of 20 + * parameters can be modified in a single request. + *

+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB cluster associated with the parameter group before the change can take effect.

+ *
+ * + *

After you create a DB cluster parameter group, you should wait at least 5 minutes + * before creating your first DB cluster that uses that DB cluster parameter group as the default parameter + * group. This allows Amazon RDS to fully complete the create action before the parameter + * group is used as the default for a new DB cluster. This is especially important for parameters + * that are critical when creating the default database for a DB cluster, such as the character set + * for the default database defined by the character_set_database parameter. You can use the + * Parameter Groups option of the Amazon RDS console or the + * DescribeDBClusterParameters action to verify + * that your DB cluster parameter group has been created or modified.

+ *

If the modified DB cluster parameter group is used by an Aurora Serverless cluster, Aurora + * applies the update immediately. The cluster restart might interrupt your workload. In that case, + * your application must reopen any connections and retry any transactions that were active + * when the parameter changes took effect.

+ *
+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class ModifyDBClusterParameterGroupCommand extends $Command< ModifyDBClusterParameterGroupCommandInput, ModifyDBClusterParameterGroupCommandOutput, @@ -34,6 +67,9 @@ export class ModifyDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBClusterSnapshotAttributeCommand.ts b/clients/client-rds/commands/ModifyDBClusterSnapshotAttributeCommand.ts index c329fe6da1b45..0851a61ec2727 100644 --- a/clients/client-rds/commands/ModifyDBClusterSnapshotAttributeCommand.ts +++ b/clients/client-rds/commands/ModifyDBClusterSnapshotAttributeCommand.ts @@ -20,6 +20,30 @@ import { export type ModifyDBClusterSnapshotAttributeCommandInput = ModifyDBClusterSnapshotAttributeMessage; export type ModifyDBClusterSnapshotAttributeCommandOutput = ModifyDBClusterSnapshotAttributeResult & __MetadataBearer; +/** + *

Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.

+ *

To share a manual DB cluster snapshot with other AWS accounts, specify + * restore as the AttributeName and use the + * ValuesToAdd parameter to add a list of IDs of the AWS accounts that are + * authorized to restore the manual DB cluster snapshot. Use the value all to + * make the manual DB cluster snapshot public, which means that it can be copied or + * restored by all AWS accounts.

+ * + *

Don't add the all value for any manual DB cluster snapshots + * that contain private information that you don't want available to all AWS + * accounts.

+ *
+ *

If a manual DB cluster snapshot is encrypted, it can be shared, but only by + * specifying a list of authorized AWS account IDs for the ValuesToAdd + * parameter. You can't use all as a value for that parameter in this + * case.

+ *

To view which AWS accounts have access to copy or restore a manual DB cluster + * snapshot, or whether a manual DB cluster snapshot is public or private, use the DescribeDBClusterSnapshotAttributes API action. The accounts are + * returned as values for the restore attribute.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class ModifyDBClusterSnapshotAttributeCommand extends $Command< ModifyDBClusterSnapshotAttributeCommandInput, ModifyDBClusterSnapshotAttributeCommandOutput, @@ -34,6 +58,9 @@ export class ModifyDBClusterSnapshotAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBInstanceCommand.ts b/clients/client-rds/commands/ModifyDBInstanceCommand.ts index a527c0ef2be8c..08ae79e4c45e8 100644 --- a/clients/client-rds/commands/ModifyDBInstanceCommand.ts +++ b/clients/client-rds/commands/ModifyDBInstanceCommand.ts @@ -20,6 +20,14 @@ import { export type ModifyDBInstanceCommandInput = ModifyDBInstanceMessage; export type ModifyDBInstanceCommandOutput = ModifyDBInstanceResult & __MetadataBearer; +/** + *

Modifies settings for a DB instance. + * You can change one or more database configuration parameters by specifying these parameters and the new values in the request. + * To learn what modifications you can make to your DB instance, + * call DescribeValidDBInstanceModifications + * before you call ModifyDBInstance. + *

+ */ export class ModifyDBInstanceCommand extends $Command< ModifyDBInstanceCommandInput, ModifyDBInstanceCommandOutput, @@ -34,6 +42,9 @@ export class ModifyDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBParameterGroupCommand.ts b/clients/client-rds/commands/ModifyDBParameterGroupCommand.ts index 04ae4a941dd83..c726f79e99efc 100644 --- a/clients/client-rds/commands/ModifyDBParameterGroupCommand.ts +++ b/clients/client-rds/commands/ModifyDBParameterGroupCommand.ts @@ -20,6 +20,28 @@ import { export type ModifyDBParameterGroupCommandInput = ModifyDBParameterGroupMessage; export type ModifyDBParameterGroupCommandOutput = DBParameterGroupNameMessage & __MetadataBearer; +/** + *

+ * Modifies the parameters of a DB parameter group. To modify more than one parameter, + * submit a list of the following: ParameterName, ParameterValue, and + * ApplyMethod. A maximum of 20 + * parameters can be modified in a single request. + *

+ * + *

Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB instance associated with the parameter group before the change can take effect.

+ *
+ * + *

After you modify a DB parameter group, you should wait at least 5 minutes + * before creating your first DB instance that uses that DB parameter group as the default parameter + * group. This allows Amazon RDS to fully complete the modify action before the parameter + * group is used as the default for a new DB instance. This is especially important for parameters + * that are critical when creating the default database for a DB instance, such as the character set + * for the default database defined by the character_set_database parameter. You can use the + * Parameter Groups option of the Amazon RDS console or the + * DescribeDBParameters command to verify + * that your DB parameter group has been created or modified.

+ *
+ */ export class ModifyDBParameterGroupCommand extends $Command< ModifyDBParameterGroupCommandInput, ModifyDBParameterGroupCommandOutput, @@ -34,6 +56,9 @@ export class ModifyDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBProxyCommand.ts b/clients/client-rds/commands/ModifyDBProxyCommand.ts index 6a3c50a66d7ad..8e6e3f4066f81 100644 --- a/clients/client-rds/commands/ModifyDBProxyCommand.ts +++ b/clients/client-rds/commands/ModifyDBProxyCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyDBProxyCommandInput = ModifyDBProxyRequest; export type ModifyDBProxyCommandOutput = ModifyDBProxyResponse & __MetadataBearer; +/** + *

Changes the settings for an existing DB proxy.

+ */ export class ModifyDBProxyCommand extends $Command< ModifyDBProxyCommandInput, ModifyDBProxyCommandOutput, @@ -34,6 +37,9 @@ export class ModifyDBProxyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBProxyTargetGroupCommand.ts b/clients/client-rds/commands/ModifyDBProxyTargetGroupCommand.ts index f8d825b451386..b171c5de47dc6 100644 --- a/clients/client-rds/commands/ModifyDBProxyTargetGroupCommand.ts +++ b/clients/client-rds/commands/ModifyDBProxyTargetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyDBProxyTargetGroupCommandInput = ModifyDBProxyTargetGroupRequest; export type ModifyDBProxyTargetGroupCommandOutput = ModifyDBProxyTargetGroupResponse & __MetadataBearer; +/** + *

Modifies the properties of a DBProxyTargetGroup.

+ */ export class ModifyDBProxyTargetGroupCommand extends $Command< ModifyDBProxyTargetGroupCommandInput, ModifyDBProxyTargetGroupCommandOutput, @@ -34,6 +37,9 @@ export class ModifyDBProxyTargetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBSnapshotAttributeCommand.ts b/clients/client-rds/commands/ModifyDBSnapshotAttributeCommand.ts index 241145ba6ad16..5cfdefaf67fbd 100644 --- a/clients/client-rds/commands/ModifyDBSnapshotAttributeCommand.ts +++ b/clients/client-rds/commands/ModifyDBSnapshotAttributeCommand.ts @@ -20,6 +20,25 @@ import { export type ModifyDBSnapshotAttributeCommandInput = ModifyDBSnapshotAttributeMessage; export type ModifyDBSnapshotAttributeCommandOutput = ModifyDBSnapshotAttributeResult & __MetadataBearer; +/** + *

Adds an attribute and values to, or removes an attribute and values from, a manual DB snapshot.

+ *

To share a manual DB snapshot with other AWS accounts, specify restore + * as the AttributeName and use the ValuesToAdd parameter to add + * a list of IDs of the AWS accounts that are authorized to restore the manual DB snapshot. + * Uses the value all to make the manual DB snapshot public, which means it + * can be copied or restored by all AWS accounts.

+ * + *

Don't add the all value for any manual DB snapshots that + * contain private information that you don't want available to all AWS + * accounts.

+ *
+ *

If the manual DB snapshot is encrypted, it can be shared, but only by specifying a + * list of authorized AWS account IDs for the ValuesToAdd parameter. You + * can't use all as a value for that parameter in this case.

+ *

To view which AWS accounts have access to copy or restore a manual DB snapshot, or + * whether a manual DB snapshot public or private, use the DescribeDBSnapshotAttributes API action. The accounts are returned as + * values for the restore attribute.

+ */ export class ModifyDBSnapshotAttributeCommand extends $Command< ModifyDBSnapshotAttributeCommandInput, ModifyDBSnapshotAttributeCommandOutput, @@ -34,6 +53,9 @@ export class ModifyDBSnapshotAttributeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBSnapshotCommand.ts b/clients/client-rds/commands/ModifyDBSnapshotCommand.ts index ce5b3fc4aecab..f509913d9dbea 100644 --- a/clients/client-rds/commands/ModifyDBSnapshotCommand.ts +++ b/clients/client-rds/commands/ModifyDBSnapshotCommand.ts @@ -20,6 +20,15 @@ import { export type ModifyDBSnapshotCommandInput = ModifyDBSnapshotMessage; export type ModifyDBSnapshotCommandOutput = ModifyDBSnapshotResult & __MetadataBearer; +/** + *

Updates a manual DB snapshot with a new engine version. The snapshot can be encrypted + * or unencrypted, but not shared or public. + * + *

+ * + *

Amazon RDS supports upgrading DB snapshots for MySQL, Oracle, and PostgreSQL. + *

+ */ export class ModifyDBSnapshotCommand extends $Command< ModifyDBSnapshotCommandInput, ModifyDBSnapshotCommandOutput, @@ -34,6 +43,9 @@ export class ModifyDBSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyDBSubnetGroupCommand.ts b/clients/client-rds/commands/ModifyDBSubnetGroupCommand.ts index 5f6e7c8996842..6515e2d1dc4ea 100644 --- a/clients/client-rds/commands/ModifyDBSubnetGroupCommand.ts +++ b/clients/client-rds/commands/ModifyDBSubnetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyDBSubnetGroupCommandInput = ModifyDBSubnetGroupMessage; export type ModifyDBSubnetGroupCommandOutput = ModifyDBSubnetGroupResult & __MetadataBearer; +/** + *

Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

+ */ export class ModifyDBSubnetGroupCommand extends $Command< ModifyDBSubnetGroupCommandInput, ModifyDBSubnetGroupCommandOutput, @@ -34,6 +37,9 @@ export class ModifyDBSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyEventSubscriptionCommand.ts b/clients/client-rds/commands/ModifyEventSubscriptionCommand.ts index b1936f7a6549f..1e46111d313fd 100644 --- a/clients/client-rds/commands/ModifyEventSubscriptionCommand.ts +++ b/clients/client-rds/commands/ModifyEventSubscriptionCommand.ts @@ -20,6 +20,13 @@ import { export type ModifyEventSubscriptionCommandInput = ModifyEventSubscriptionMessage; export type ModifyEventSubscriptionCommandOutput = ModifyEventSubscriptionResult & __MetadataBearer; +/** + *

Modifies an existing RDS event notification subscription. You can't modify the source identifiers using this call. To change + * source identifiers for a subscription, use the AddSourceIdentifierToSubscription and RemoveSourceIdentifierFromSubscription calls.

+ *

You can see a list of the event categories for a given source type (SourceType) + * in Events in the Amazon RDS User Guide + * or by using the DescribeEventCategories operation.

+ */ export class ModifyEventSubscriptionCommand extends $Command< ModifyEventSubscriptionCommandInput, ModifyEventSubscriptionCommandOutput, @@ -34,6 +41,9 @@ export class ModifyEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyGlobalClusterCommand.ts b/clients/client-rds/commands/ModifyGlobalClusterCommand.ts index 30b3b0c961e21..869c274349f8c 100644 --- a/clients/client-rds/commands/ModifyGlobalClusterCommand.ts +++ b/clients/client-rds/commands/ModifyGlobalClusterCommand.ts @@ -20,6 +20,17 @@ import { export type ModifyGlobalClusterCommandInput = ModifyGlobalClusterMessage; export type ModifyGlobalClusterCommandOutput = ModifyGlobalClusterResult & __MetadataBearer; +/** + *

+ * Modify a setting for an Amazon Aurora global cluster. You can change one or more database configuration + * parameters by specifying these parameters and the new values in the request. For more information on + * Amazon Aurora, see What Is Amazon Aurora? in the + * Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class ModifyGlobalClusterCommand extends $Command< ModifyGlobalClusterCommandInput, ModifyGlobalClusterCommandOutput, @@ -34,6 +45,9 @@ export class ModifyGlobalClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ModifyOptionGroupCommand.ts b/clients/client-rds/commands/ModifyOptionGroupCommand.ts index 86f41eb221ef7..dbb253712f2c3 100644 --- a/clients/client-rds/commands/ModifyOptionGroupCommand.ts +++ b/clients/client-rds/commands/ModifyOptionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyOptionGroupCommandInput = ModifyOptionGroupMessage; export type ModifyOptionGroupCommandOutput = ModifyOptionGroupResult & __MetadataBearer; +/** + *

Modifies an existing option group.

+ */ export class ModifyOptionGroupCommand extends $Command< ModifyOptionGroupCommandInput, ModifyOptionGroupCommandOutput, @@ -34,6 +37,9 @@ export class ModifyOptionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/PromoteReadReplicaCommand.ts b/clients/client-rds/commands/PromoteReadReplicaCommand.ts index e0ce4989b320f..eef235e622abb 100644 --- a/clients/client-rds/commands/PromoteReadReplicaCommand.ts +++ b/clients/client-rds/commands/PromoteReadReplicaCommand.ts @@ -20,6 +20,27 @@ import { export type PromoteReadReplicaCommandInput = PromoteReadReplicaMessage; export type PromoteReadReplicaCommandOutput = PromoteReadReplicaResult & __MetadataBearer; +/** + *

Promotes a read replica DB instance to a standalone DB instance.

+ * + *
    + *
  • + *

    Backup duration is a function of the amount of changes to the database since the previous + * backup. If you plan to promote a read replica to a standalone instance, we + * recommend that you enable backups and complete at least one backup prior to + * promotion. In addition, a read replica cannot be promoted to a standalone + * instance when it is in the backing-up status. If you have + * enabled backups on your read replica, configure the automated backup window + * so that daily backups do not interfere with read replica + * promotion.

    + *
  • + *
  • + *

    This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.

    + *
  • + *
+ * + *
+ */ export class PromoteReadReplicaCommand extends $Command< PromoteReadReplicaCommandInput, PromoteReadReplicaCommandOutput, @@ -34,6 +55,9 @@ export class PromoteReadReplicaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/PromoteReadReplicaDBClusterCommand.ts b/clients/client-rds/commands/PromoteReadReplicaDBClusterCommand.ts index fab10f73f019d..241a25a510fcb 100644 --- a/clients/client-rds/commands/PromoteReadReplicaDBClusterCommand.ts +++ b/clients/client-rds/commands/PromoteReadReplicaDBClusterCommand.ts @@ -20,6 +20,12 @@ import { export type PromoteReadReplicaDBClusterCommandInput = PromoteReadReplicaDBClusterMessage; export type PromoteReadReplicaDBClusterCommandOutput = PromoteReadReplicaDBClusterResult & __MetadataBearer; +/** + *

Promotes a read replica DB cluster to a standalone DB cluster.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class PromoteReadReplicaDBClusterCommand extends $Command< PromoteReadReplicaDBClusterCommandInput, PromoteReadReplicaDBClusterCommandOutput, @@ -34,6 +40,9 @@ export class PromoteReadReplicaDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/PurchaseReservedDBInstancesOfferingCommand.ts b/clients/client-rds/commands/PurchaseReservedDBInstancesOfferingCommand.ts index d40d3911cb0ce..4371765ea9394 100644 --- a/clients/client-rds/commands/PurchaseReservedDBInstancesOfferingCommand.ts +++ b/clients/client-rds/commands/PurchaseReservedDBInstancesOfferingCommand.ts @@ -24,6 +24,9 @@ export type PurchaseReservedDBInstancesOfferingCommandInput = PurchaseReservedDB export type PurchaseReservedDBInstancesOfferingCommandOutput = PurchaseReservedDBInstancesOfferingResult & __MetadataBearer; +/** + *

Purchases a reserved DB instance offering.

+ */ export class PurchaseReservedDBInstancesOfferingCommand extends $Command< PurchaseReservedDBInstancesOfferingCommandInput, PurchaseReservedDBInstancesOfferingCommandOutput, @@ -38,6 +41,9 @@ export class PurchaseReservedDBInstancesOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RebootDBInstanceCommand.ts b/clients/client-rds/commands/RebootDBInstanceCommand.ts index 4750a83c299d9..4e132cda57c06 100644 --- a/clients/client-rds/commands/RebootDBInstanceCommand.ts +++ b/clients/client-rds/commands/RebootDBInstanceCommand.ts @@ -20,6 +20,20 @@ import { export type RebootDBInstanceCommandInput = RebootDBInstanceMessage; export type RebootDBInstanceCommandOutput = RebootDBInstanceResult & __MetadataBearer; +/** + *

You might need to reboot your DB instance, usually for maintenance reasons. + * For example, if you make certain modifications, + * or if you change the DB parameter group associated with the DB instance, + * you must reboot the instance for the changes to take effect. + *

+ * + *

Rebooting a DB instance restarts the database engine service. + * Rebooting a DB instance results in a momentary outage, during which the DB instance status is set to rebooting. + *

+ * + *

For more information about rebooting, see Rebooting a DB Instance in the Amazon RDS User Guide. + *

+ */ export class RebootDBInstanceCommand extends $Command< RebootDBInstanceCommandInput, RebootDBInstanceCommandOutput, @@ -34,6 +48,9 @@ export class RebootDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RegisterDBProxyTargetsCommand.ts b/clients/client-rds/commands/RegisterDBProxyTargetsCommand.ts index 9842e0630b97e..5b7b0fad21eda 100644 --- a/clients/client-rds/commands/RegisterDBProxyTargetsCommand.ts +++ b/clients/client-rds/commands/RegisterDBProxyTargetsCommand.ts @@ -20,6 +20,9 @@ import { export type RegisterDBProxyTargetsCommandInput = RegisterDBProxyTargetsRequest; export type RegisterDBProxyTargetsCommandOutput = RegisterDBProxyTargetsResponse & __MetadataBearer; +/** + *

Associate one or more DBProxyTarget data structures with a DBProxyTargetGroup.

+ */ export class RegisterDBProxyTargetsCommand extends $Command< RegisterDBProxyTargetsCommandInput, RegisterDBProxyTargetsCommandOutput, @@ -34,6 +37,9 @@ export class RegisterDBProxyTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RemoveFromGlobalClusterCommand.ts b/clients/client-rds/commands/RemoveFromGlobalClusterCommand.ts index ed909d6a8ac0b..e3f4e78e7a06f 100644 --- a/clients/client-rds/commands/RemoveFromGlobalClusterCommand.ts +++ b/clients/client-rds/commands/RemoveFromGlobalClusterCommand.ts @@ -20,6 +20,16 @@ import { export type RemoveFromGlobalClusterCommandInput = RemoveFromGlobalClusterMessage; export type RemoveFromGlobalClusterCommandOutput = RemoveFromGlobalClusterResult & __MetadataBearer; +/** + *

+ * Detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster becomes a + * standalone cluster with read-write capability instead of being read-only and receiving data from a + * primary cluster in a different region. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class RemoveFromGlobalClusterCommand extends $Command< RemoveFromGlobalClusterCommandInput, RemoveFromGlobalClusterCommandOutput, @@ -34,6 +44,9 @@ export class RemoveFromGlobalClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RemoveRoleFromDBClusterCommand.ts b/clients/client-rds/commands/RemoveRoleFromDBClusterCommand.ts index 03c4286305928..2928903864911 100644 --- a/clients/client-rds/commands/RemoveRoleFromDBClusterCommand.ts +++ b/clients/client-rds/commands/RemoveRoleFromDBClusterCommand.ts @@ -20,6 +20,14 @@ import { export type RemoveRoleFromDBClusterCommandInput = RemoveRoleFromDBClusterMessage; export type RemoveRoleFromDBClusterCommandOutput = __MetadataBearer; +/** + *

Disassociates an AWS Identity and Access Management (IAM) role from an Amazon Aurora DB cluster. + * For more information, see Authorizing Amazon Aurora MySQL + * to Access Other AWS Services on Your Behalf in the Amazon Aurora User Guide.

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class RemoveRoleFromDBClusterCommand extends $Command< RemoveRoleFromDBClusterCommandInput, RemoveRoleFromDBClusterCommandOutput, @@ -34,6 +42,9 @@ export class RemoveRoleFromDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RemoveRoleFromDBInstanceCommand.ts b/clients/client-rds/commands/RemoveRoleFromDBInstanceCommand.ts index fa4e3864b0dd1..a81ae9e212232 100644 --- a/clients/client-rds/commands/RemoveRoleFromDBInstanceCommand.ts +++ b/clients/client-rds/commands/RemoveRoleFromDBInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveRoleFromDBInstanceCommandInput = RemoveRoleFromDBInstanceMessage; export type RemoveRoleFromDBInstanceCommandOutput = __MetadataBearer; +/** + *

Disassociates an AWS Identity and Access Management (IAM) role from a DB instance.

+ */ export class RemoveRoleFromDBInstanceCommand extends $Command< RemoveRoleFromDBInstanceCommandInput, RemoveRoleFromDBInstanceCommandOutput, @@ -34,6 +37,9 @@ export class RemoveRoleFromDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RemoveSourceIdentifierFromSubscriptionCommand.ts b/clients/client-rds/commands/RemoveSourceIdentifierFromSubscriptionCommand.ts index 33313a52d7d35..d55a13d047860 100644 --- a/clients/client-rds/commands/RemoveSourceIdentifierFromSubscriptionCommand.ts +++ b/clients/client-rds/commands/RemoveSourceIdentifierFromSubscriptionCommand.ts @@ -24,6 +24,9 @@ export type RemoveSourceIdentifierFromSubscriptionCommandInput = RemoveSourceIde export type RemoveSourceIdentifierFromSubscriptionCommandOutput = RemoveSourceIdentifierFromSubscriptionResult & __MetadataBearer; +/** + *

Removes a source identifier from an existing RDS event notification subscription.

+ */ export class RemoveSourceIdentifierFromSubscriptionCommand extends $Command< RemoveSourceIdentifierFromSubscriptionCommandInput, RemoveSourceIdentifierFromSubscriptionCommandOutput, @@ -38,6 +41,9 @@ export class RemoveSourceIdentifierFromSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RemoveTagsFromResourceCommand.ts b/clients/client-rds/commands/RemoveTagsFromResourceCommand.ts index efb71b7c761c8..b07db800c8b15 100644 --- a/clients/client-rds/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-rds/commands/RemoveTagsFromResourceCommand.ts @@ -20,6 +20,13 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceMessage; export type RemoveTagsFromResourceCommandOutput = __MetadataBearer; +/** + *

Removes metadata tags from an Amazon RDS resource.

+ *

For an overview on tagging an Amazon RDS resource, + * see Tagging Amazon RDS Resources + * in the Amazon RDS User Guide. + *

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -34,6 +41,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ResetDBClusterParameterGroupCommand.ts b/clients/client-rds/commands/ResetDBClusterParameterGroupCommand.ts index 5c609e2b97560..daa90dbd0e57a 100644 --- a/clients/client-rds/commands/ResetDBClusterParameterGroupCommand.ts +++ b/clients/client-rds/commands/ResetDBClusterParameterGroupCommand.ts @@ -20,6 +20,28 @@ import { export type ResetDBClusterParameterGroupCommandInput = ResetDBClusterParameterGroupMessage; export type ResetDBClusterParameterGroupCommandOutput = DBClusterParameterGroupNameMessage & __MetadataBearer; +/** + *

+ * Modifies the parameters of a DB cluster parameter group to the default value. To + * reset specific parameters submit a list of the following: ParameterName + * and ApplyMethod. To reset the + * entire DB cluster parameter group, specify the DBClusterParameterGroupName + * and ResetAllParameters parameters. + *

+ *

+ * When resetting the entire group, dynamic parameters are updated immediately and static parameters + * are set to pending-reboot to take effect on the next DB instance restart + * or RebootDBInstance request. You must call RebootDBInstance for every + * DB instance in your DB cluster that you want the updated static parameter to apply to.

+ * + *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class ResetDBClusterParameterGroupCommand extends $Command< ResetDBClusterParameterGroupCommandInput, ResetDBClusterParameterGroupCommandOutput, @@ -34,6 +56,9 @@ export class ResetDBClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/ResetDBParameterGroupCommand.ts b/clients/client-rds/commands/ResetDBParameterGroupCommand.ts index 901924a656ebc..1d015d3786b25 100644 --- a/clients/client-rds/commands/ResetDBParameterGroupCommand.ts +++ b/clients/client-rds/commands/ResetDBParameterGroupCommand.ts @@ -20,6 +20,16 @@ import { export type ResetDBParameterGroupCommandInput = ResetDBParameterGroupMessage; export type ResetDBParameterGroupCommandOutput = DBParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a DB parameter group to the engine/system default value. + * To reset specific parameters, provide a list of the following: + * ParameterName and ApplyMethod. To reset the entire DB + * parameter group, specify the DBParameterGroup name and + * ResetAllParameters parameters. When resetting the entire group, dynamic + * parameters are updated immediately and static parameters are set to + * pending-reboot to take effect on the next DB instance restart or + * RebootDBInstance request.

+ */ export class ResetDBParameterGroupCommand extends $Command< ResetDBParameterGroupCommandInput, ResetDBParameterGroupCommandOutput, @@ -34,6 +44,9 @@ export class ResetDBParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RestoreDBClusterFromS3Command.ts b/clients/client-rds/commands/RestoreDBClusterFromS3Command.ts index c05a051d40d0b..dc4cdba360c95 100644 --- a/clients/client-rds/commands/RestoreDBClusterFromS3Command.ts +++ b/clients/client-rds/commands/RestoreDBClusterFromS3Command.ts @@ -20,6 +20,28 @@ import { export type RestoreDBClusterFromS3CommandInput = RestoreDBClusterFromS3Message; export type RestoreDBClusterFromS3CommandOutput = RestoreDBClusterFromS3Result & __MetadataBearer; +/** + *

Creates an Amazon Aurora DB cluster from MySQL data stored in an Amazon S3 bucket. + * Amazon RDS must be authorized to access the Amazon S3 bucket and the data must be + * created using the Percona XtraBackup utility as described in Migrating Data from MySQL by Using an Amazon S3 Bucket in the + * Amazon Aurora User Guide.

+ * + *

This action only restores the DB cluster, not the DB instances for that DB + * cluster. You must invoke the CreateDBInstance action to create DB + * instances for the restored DB cluster, specifying the identifier of the restored DB + * cluster in DBClusterIdentifier. You can create DB instances only after + * the RestoreDBClusterFromS3 action has completed and the DB + * cluster is available.

+ *
+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters. The source DB engine must be + * MySQL.

+ *
+ */ export class RestoreDBClusterFromS3Command extends $Command< RestoreDBClusterFromS3CommandInput, RestoreDBClusterFromS3CommandOutput, @@ -34,6 +56,9 @@ export class RestoreDBClusterFromS3Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RestoreDBClusterFromSnapshotCommand.ts b/clients/client-rds/commands/RestoreDBClusterFromSnapshotCommand.ts index a27e6bb7ca761..7e4e081aa0350 100644 --- a/clients/client-rds/commands/RestoreDBClusterFromSnapshotCommand.ts +++ b/clients/client-rds/commands/RestoreDBClusterFromSnapshotCommand.ts @@ -20,6 +20,28 @@ import { export type RestoreDBClusterFromSnapshotCommandInput = RestoreDBClusterFromSnapshotMessage; export type RestoreDBClusterFromSnapshotCommandOutput = RestoreDBClusterFromSnapshotResult & __MetadataBearer; +/** + *

Creates a new DB cluster from a DB snapshot or DB cluster snapshot. This action + * only applies to Aurora DB clusters.

+ *

The target DB cluster is created from the source snapshot with a default + * configuration. If you don't specify a security group, the new DB cluster is + * associated with the default security group.

+ * + *

This action only restores the DB cluster, not the DB instances for that DB + * cluster. You must invoke the CreateDBInstance action to create DB + * instances for the restored DB cluster, specifying the identifier of the restored DB + * cluster in DBClusterIdentifier. You can create DB instances only after + * the RestoreDBClusterFromSnapshot action has completed and the DB + * cluster is available.

+ *
+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class RestoreDBClusterFromSnapshotCommand extends $Command< RestoreDBClusterFromSnapshotCommandInput, RestoreDBClusterFromSnapshotCommandOutput, @@ -34,6 +56,9 @@ export class RestoreDBClusterFromSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RestoreDBClusterToPointInTimeCommand.ts b/clients/client-rds/commands/RestoreDBClusterToPointInTimeCommand.ts index 047b286806a7c..e274de2ab8df4 100644 --- a/clients/client-rds/commands/RestoreDBClusterToPointInTimeCommand.ts +++ b/clients/client-rds/commands/RestoreDBClusterToPointInTimeCommand.ts @@ -20,6 +20,28 @@ import { export type RestoreDBClusterToPointInTimeCommandInput = RestoreDBClusterToPointInTimeMessage; export type RestoreDBClusterToPointInTimeCommandOutput = RestoreDBClusterToPointInTimeResult & __MetadataBearer; +/** + *

Restores a DB cluster to an arbitrary point in time. Users can restore to any point + * in time before LatestRestorableTime for up to + * BackupRetentionPeriod days. The target DB cluster is created from the + * source DB cluster with the same configuration as the original DB cluster, except that + * the new DB cluster is created with the default DB security group.

+ * + *

This action only restores the DB cluster, not the DB instances for that DB + * cluster. You must invoke the CreateDBInstance action to create DB + * instances for the restored DB cluster, specifying the identifier of the restored DB + * cluster in DBClusterIdentifier. You can create DB instances only after + * the RestoreDBClusterToPointInTime action has completed and the DB + * cluster is available.

+ *
+ *

For more information on Amazon Aurora, see + * + * What Is Amazon Aurora? in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class RestoreDBClusterToPointInTimeCommand extends $Command< RestoreDBClusterToPointInTimeCommandInput, RestoreDBClusterToPointInTimeCommandOutput, @@ -34,6 +56,9 @@ export class RestoreDBClusterToPointInTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RestoreDBInstanceFromDBSnapshotCommand.ts b/clients/client-rds/commands/RestoreDBInstanceFromDBSnapshotCommand.ts index ad5347dd188fa..7d67269b976bd 100644 --- a/clients/client-rds/commands/RestoreDBInstanceFromDBSnapshotCommand.ts +++ b/clients/client-rds/commands/RestoreDBInstanceFromDBSnapshotCommand.ts @@ -20,6 +20,15 @@ import { export type RestoreDBInstanceFromDBSnapshotCommandInput = RestoreDBInstanceFromDBSnapshotMessage; export type RestoreDBInstanceFromDBSnapshotCommandOutput = RestoreDBInstanceFromDBSnapshotResult & __MetadataBearer; +/** + *

Creates a new DB instance from a DB snapshot. The target database is created from the source database restore point with the most of original configuration with the default security group and the default DB parameter group. By default, the new DB instance is created as a single-AZ deployment except when the instance is a SQL Server instance that has an option group that is associated with mirroring; in this case, the instance becomes a mirrored AZ deployment and not a single-AZ deployment.

+ *

If your intent is to replace your original DB instance with the new, restored DB instance, then rename your original DB instance before you call the RestoreDBInstanceFromDBSnapshot action. RDS doesn't allow two DB instances with the same name. Once you have renamed your original DB instance with a different identifier, then you can pass the original name of the DB instance as the DBInstanceIdentifier in the call to the RestoreDBInstanceFromDBSnapshot action. The result is that you will replace the original DB instance with the DB instance created from the snapshot.

+ *

If you are restoring from a shared manual DB snapshot, the DBSnapshotIdentifier + * must be the ARN of the shared DB snapshot.

+ * + *

This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use RestoreDBClusterFromSnapshot.

+ *
+ */ export class RestoreDBInstanceFromDBSnapshotCommand extends $Command< RestoreDBInstanceFromDBSnapshotCommandInput, RestoreDBInstanceFromDBSnapshotCommandOutput, @@ -34,6 +43,9 @@ export class RestoreDBInstanceFromDBSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RestoreDBInstanceFromS3Command.ts b/clients/client-rds/commands/RestoreDBInstanceFromS3Command.ts index 1dfb9e8095ac9..63b45d38ae4cb 100644 --- a/clients/client-rds/commands/RestoreDBInstanceFromS3Command.ts +++ b/clients/client-rds/commands/RestoreDBInstanceFromS3Command.ts @@ -20,6 +20,16 @@ import { export type RestoreDBInstanceFromS3CommandInput = RestoreDBInstanceFromS3Message; export type RestoreDBInstanceFromS3CommandOutput = RestoreDBInstanceFromS3Result & __MetadataBearer; +/** + *

Amazon Relational Database Service (Amazon RDS) + * supports importing MySQL databases by using backup files. + * You can create a backup of your on-premises database, + * store it on Amazon Simple Storage Service (Amazon S3), + * and then restore the backup file onto a new Amazon RDS DB instance running MySQL. + * For more information, see Importing Data into an Amazon RDS MySQL DB Instance + * in the Amazon RDS User Guide. + *

+ */ export class RestoreDBInstanceFromS3Command extends $Command< RestoreDBInstanceFromS3CommandInput, RestoreDBInstanceFromS3CommandOutput, @@ -34,6 +44,9 @@ export class RestoreDBInstanceFromS3Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RestoreDBInstanceToPointInTimeCommand.ts b/clients/client-rds/commands/RestoreDBInstanceToPointInTimeCommand.ts index 5892393367dcb..a070e6ad575cc 100644 --- a/clients/client-rds/commands/RestoreDBInstanceToPointInTimeCommand.ts +++ b/clients/client-rds/commands/RestoreDBInstanceToPointInTimeCommand.ts @@ -20,6 +20,18 @@ import { export type RestoreDBInstanceToPointInTimeCommandInput = RestoreDBInstanceToPointInTimeMessage; export type RestoreDBInstanceToPointInTimeCommandOutput = RestoreDBInstanceToPointInTimeResult & __MetadataBearer; +/** + *

Restores a DB instance to an arbitrary point in time. You can restore to any point in time before the time identified by the LatestRestorableTime property. You can restore to a point up to the number of days specified by the BackupRetentionPeriod property.

+ *

The target database is created with most of the original configuration, but in a + * system-selected Availability Zone, with the default security group, the default subnet + * group, and the default DB parameter group. By default, the new DB instance is created as + * a single-AZ deployment except when the instance is a SQL Server instance that has an + * option group that is associated with mirroring; in this case, the instance becomes a + * mirrored deployment and not a single-AZ deployment.

+ * + *

This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use RestoreDBClusterToPointInTime.

+ *
+ */ export class RestoreDBInstanceToPointInTimeCommand extends $Command< RestoreDBInstanceToPointInTimeCommandInput, RestoreDBInstanceToPointInTimeCommandOutput, @@ -34,6 +46,9 @@ export class RestoreDBInstanceToPointInTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/RevokeDBSecurityGroupIngressCommand.ts b/clients/client-rds/commands/RevokeDBSecurityGroupIngressCommand.ts index 65b2eb3f07907..caede8973a587 100644 --- a/clients/client-rds/commands/RevokeDBSecurityGroupIngressCommand.ts +++ b/clients/client-rds/commands/RevokeDBSecurityGroupIngressCommand.ts @@ -20,6 +20,9 @@ import { export type RevokeDBSecurityGroupIngressCommandInput = RevokeDBSecurityGroupIngressMessage; export type RevokeDBSecurityGroupIngressCommandOutput = RevokeDBSecurityGroupIngressResult & __MetadataBearer; +/** + *

Revokes ingress from a DBSecurityGroup for previously authorized IP ranges or EC2 or VPC Security Groups. Required parameters for this API are one of CIDRIP, EC2SecurityGroupId for VPC, or (EC2SecurityGroupOwnerId and either EC2SecurityGroupName or EC2SecurityGroupId).

+ */ export class RevokeDBSecurityGroupIngressCommand extends $Command< RevokeDBSecurityGroupIngressCommandInput, RevokeDBSecurityGroupIngressCommandOutput, @@ -34,6 +37,9 @@ export class RevokeDBSecurityGroupIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/StartActivityStreamCommand.ts b/clients/client-rds/commands/StartActivityStreamCommand.ts index 93ddaa88a5bb7..cd6a20a902913 100644 --- a/clients/client-rds/commands/StartActivityStreamCommand.ts +++ b/clients/client-rds/commands/StartActivityStreamCommand.ts @@ -20,6 +20,11 @@ import { export type StartActivityStreamCommandInput = StartActivityStreamRequest; export type StartActivityStreamCommandOutput = StartActivityStreamResponse & __MetadataBearer; +/** + *

Starts a database activity stream to monitor activity on the database. + * For more information, see Database Activity Streams + * in the Amazon Aurora User Guide.

+ */ export class StartActivityStreamCommand extends $Command< StartActivityStreamCommandInput, StartActivityStreamCommandOutput, @@ -34,6 +39,9 @@ export class StartActivityStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/StartDBClusterCommand.ts b/clients/client-rds/commands/StartDBClusterCommand.ts index e32a834caa144..50065e89d2e59 100644 --- a/clients/client-rds/commands/StartDBClusterCommand.ts +++ b/clients/client-rds/commands/StartDBClusterCommand.ts @@ -20,6 +20,18 @@ import { export type StartDBClusterCommandInput = StartDBClusterMessage; export type StartDBClusterCommandOutput = StartDBClusterResult & __MetadataBearer; +/** + *

Starts an Amazon Aurora DB cluster that was stopped using the AWS console, the stop-db-cluster + * AWS CLI command, or the StopDBCluster action.

+ * + *

For more information, see + * + * Stopping and Starting an Aurora Cluster in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class StartDBClusterCommand extends $Command< StartDBClusterCommandInput, StartDBClusterCommandOutput, @@ -34,6 +46,9 @@ export class StartDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/StartDBInstanceCommand.ts b/clients/client-rds/commands/StartDBInstanceCommand.ts index cdc2425a12ca7..cc688ea7d281b 100644 --- a/clients/client-rds/commands/StartDBInstanceCommand.ts +++ b/clients/client-rds/commands/StartDBInstanceCommand.ts @@ -20,6 +20,24 @@ import { export type StartDBInstanceCommandInput = StartDBInstanceMessage; export type StartDBInstanceCommandOutput = StartDBInstanceResult & __MetadataBearer; +/** + *

+ * Starts an Amazon RDS DB instance that was stopped using the AWS console, the stop-db-instance AWS CLI command, or the StopDBInstance action. + *

+ * + *

For more information, see + * + * Starting an Amazon RDS DB instance That Was Previously Stopped in the + * Amazon RDS User Guide. + *

+ * + * + *

+ * This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. + * For Aurora DB clusters, use StartDBCluster instead. + *

+ *
+ */ export class StartDBInstanceCommand extends $Command< StartDBInstanceCommandInput, StartDBInstanceCommandOutput, @@ -34,6 +52,9 @@ export class StartDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/StartExportTaskCommand.ts b/clients/client-rds/commands/StartExportTaskCommand.ts index d1a62a419ef6f..00dcdc0835470 100644 --- a/clients/client-rds/commands/StartExportTaskCommand.ts +++ b/clients/client-rds/commands/StartExportTaskCommand.ts @@ -21,6 +21,11 @@ import { export type StartExportTaskCommandInput = StartExportTaskMessage; export type StartExportTaskCommandOutput = ExportTask & __MetadataBearer; +/** + *

Starts an export of a snapshot to Amazon S3. + * The provided IAM role must have access to the S3 bucket. + *

+ */ export class StartExportTaskCommand extends $Command< StartExportTaskCommandInput, StartExportTaskCommandOutput, @@ -35,6 +40,9 @@ export class StartExportTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/StopActivityStreamCommand.ts b/clients/client-rds/commands/StopActivityStreamCommand.ts index 5deaba3ae86b4..916bed1351e3d 100644 --- a/clients/client-rds/commands/StopActivityStreamCommand.ts +++ b/clients/client-rds/commands/StopActivityStreamCommand.ts @@ -20,6 +20,13 @@ import { export type StopActivityStreamCommandInput = StopActivityStreamRequest; export type StopActivityStreamCommandOutput = StopActivityStreamResponse & __MetadataBearer; +/** + *

Stops a database activity stream that was started using the AWS console, + * the start-activity-stream AWS CLI command, or the StartActivityStream action.

+ *

For more information, see + * Database Activity Streams + * in the Amazon Aurora User Guide.

+ */ export class StopActivityStreamCommand extends $Command< StopActivityStreamCommandInput, StopActivityStreamCommandOutput, @@ -34,6 +41,9 @@ export class StopActivityStreamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/StopDBClusterCommand.ts b/clients/client-rds/commands/StopDBClusterCommand.ts index 629b27f778ddc..d53654c12fccb 100644 --- a/clients/client-rds/commands/StopDBClusterCommand.ts +++ b/clients/client-rds/commands/StopDBClusterCommand.ts @@ -20,6 +20,21 @@ import { export type StopDBClusterCommandInput = StopDBClusterMessage; export type StopDBClusterCommandOutput = StopDBClusterResult & __MetadataBearer; +/** + *

+ * Stops an Amazon Aurora DB cluster. When you stop a DB cluster, Aurora retains the DB cluster's + * metadata, including its endpoints and DB parameter groups. Aurora also + * retains the transaction logs so you can do a point-in-time restore if necessary. + *

+ * + *

For more information, see + * + * Stopping and Starting an Aurora Cluster in the Amazon Aurora User Guide. + *

+ * + *

This action only applies to Aurora DB clusters.

+ *
+ */ export class StopDBClusterCommand extends $Command< StopDBClusterCommandInput, StopDBClusterCommandOutput, @@ -34,6 +49,9 @@ export class StopDBClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/commands/StopDBInstanceCommand.ts b/clients/client-rds/commands/StopDBInstanceCommand.ts index 0646f7f7cfdb7..bcf54927edac3 100644 --- a/clients/client-rds/commands/StopDBInstanceCommand.ts +++ b/clients/client-rds/commands/StopDBInstanceCommand.ts @@ -20,6 +20,26 @@ import { export type StopDBInstanceCommandInput = StopDBInstanceMessage; export type StopDBInstanceCommandOutput = StopDBInstanceResult & __MetadataBearer; +/** + *

+ * Stops an Amazon RDS DB instance. When you stop a DB instance, Amazon RDS retains the DB instance's metadata, including its endpoint, + * DB parameter group, and option group membership. Amazon RDS also retains the transaction logs so you can do a point-in-time restore if + * necessary. + *

+ * + *

For more information, see + * + * Stopping an Amazon RDS DB Instance Temporarily in the + * Amazon RDS User Guide. + *

+ * + * + *

+ * This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. + * For Aurora clusters, use StopDBCluster instead. + *

+ *
+ */ export class StopDBInstanceCommand extends $Command< StopDBInstanceCommandInput, StopDBInstanceCommandOutput, @@ -34,6 +54,9 @@ export class StopDBInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RDSClientResolvedConfig, diff --git a/clients/client-rds/package.json b/clients/client-rds/package.json index 351faaa7b6d4b..9effdc2def827 100644 --- a/clients/client-rds/package.json +++ b/clients/client-rds/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Rds Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-rds/pagination/DescribeCertificatesPaginator.ts b/clients/client-rds/pagination/DescribeCertificatesPaginator.ts index 786112b161fb8..dca499498a4f4 100644 --- a/clients/client-rds/pagination/DescribeCertificatesPaginator.ts +++ b/clients/client-rds/pagination/DescribeCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeCertificatesCommandInput, diff --git a/clients/client-rds/pagination/DescribeCustomAvailabilityZonesPaginator.ts b/clients/client-rds/pagination/DescribeCustomAvailabilityZonesPaginator.ts index 289c0773a01be..b1957528fde5c 100644 --- a/clients/client-rds/pagination/DescribeCustomAvailabilityZonesPaginator.ts +++ b/clients/client-rds/pagination/DescribeCustomAvailabilityZonesPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeCustomAvailabilityZonesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCustomAvailabilityZonesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeCustomAvailabilityZonesCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBClusterBacktracksPaginator.ts b/clients/client-rds/pagination/DescribeDBClusterBacktracksPaginator.ts index 574d7ed109264..94a6263c74349 100644 --- a/clients/client-rds/pagination/DescribeDBClusterBacktracksPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBClusterBacktracksPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBClusterBacktracksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterBacktracksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBClusterBacktracksCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBClusterEndpointsPaginator.ts b/clients/client-rds/pagination/DescribeDBClusterEndpointsPaginator.ts index fa50105dd9a41..a025e39e7e99d 100644 --- a/clients/client-rds/pagination/DescribeDBClusterEndpointsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBClusterEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBClusterEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBClusterEndpointsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBClusterParameterGroupsPaginator.ts b/clients/client-rds/pagination/DescribeDBClusterParameterGroupsPaginator.ts index 578276a9c2db4..6ca3d11d2d012 100644 --- a/clients/client-rds/pagination/DescribeDBClusterParameterGroupsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBClusterParameterGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBClusterParameterGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterParameterGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBClusterParameterGroupsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBClusterParametersPaginator.ts b/clients/client-rds/pagination/DescribeDBClusterParametersPaginator.ts index 8684cacefa4e3..67b1f65377fda 100644 --- a/clients/client-rds/pagination/DescribeDBClusterParametersPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBClusterParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBClusterParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBClusterParametersCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBClusterSnapshotsPaginator.ts b/clients/client-rds/pagination/DescribeDBClusterSnapshotsPaginator.ts index aa58ac8336c98..278d6d109c47e 100644 --- a/clients/client-rds/pagination/DescribeDBClusterSnapshotsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBClusterSnapshotsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBClusterSnapshotsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClusterSnapshotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBClusterSnapshotsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBClustersPaginator.ts b/clients/client-rds/pagination/DescribeDBClustersPaginator.ts index fff44f5a8f74b..b28d14bd39926 100644 --- a/clients/client-rds/pagination/DescribeDBClustersPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBClustersCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBEngineVersionsPaginator.ts b/clients/client-rds/pagination/DescribeDBEngineVersionsPaginator.ts index 272a286eab91d..1c2fd976b4fb8 100644 --- a/clients/client-rds/pagination/DescribeDBEngineVersionsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBEngineVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBEngineVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBEngineVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBEngineVersionsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBInstanceAutomatedBackupsPaginator.ts b/clients/client-rds/pagination/DescribeDBInstanceAutomatedBackupsPaginator.ts index 8809175b1c1cd..b00f80755316c 100644 --- a/clients/client-rds/pagination/DescribeDBInstanceAutomatedBackupsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBInstanceAutomatedBackupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBInstanceAutomatedBackupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBInstanceAutomatedBackupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBInstanceAutomatedBackupsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBInstancesPaginator.ts b/clients/client-rds/pagination/DescribeDBInstancesPaginator.ts index 4339d28a003d5..2a4e4a688d7f9 100644 --- a/clients/client-rds/pagination/DescribeDBInstancesPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBInstancesCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBLogFilesPaginator.ts b/clients/client-rds/pagination/DescribeDBLogFilesPaginator.ts index 1a58f852dbcaa..e16e069dcf8e4 100644 --- a/clients/client-rds/pagination/DescribeDBLogFilesPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBLogFilesPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBLogFilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBLogFilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBLogFilesCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBParameterGroupsPaginator.ts b/clients/client-rds/pagination/DescribeDBParameterGroupsPaginator.ts index 175f2c894f7f7..fbc25d41cb7e2 100644 --- a/clients/client-rds/pagination/DescribeDBParameterGroupsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBParameterGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBParameterGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBParameterGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBParameterGroupsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBParametersPaginator.ts b/clients/client-rds/pagination/DescribeDBParametersPaginator.ts index 271e79aaac813..a7910ed4ac127 100644 --- a/clients/client-rds/pagination/DescribeDBParametersPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBParametersCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBProxiesPaginator.ts b/clients/client-rds/pagination/DescribeDBProxiesPaginator.ts index 025b8c8e2068e..1d33e82267250 100644 --- a/clients/client-rds/pagination/DescribeDBProxiesPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBProxiesPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBProxiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBProxiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBProxiesCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBProxyTargetGroupsPaginator.ts b/clients/client-rds/pagination/DescribeDBProxyTargetGroupsPaginator.ts index 298dfa6cdf9fb..459e0eca05b48 100644 --- a/clients/client-rds/pagination/DescribeDBProxyTargetGroupsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBProxyTargetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBProxyTargetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBProxyTargetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBProxyTargetGroupsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBProxyTargetsPaginator.ts b/clients/client-rds/pagination/DescribeDBProxyTargetsPaginator.ts index 9052ae7d3471f..0a13521f3b760 100644 --- a/clients/client-rds/pagination/DescribeDBProxyTargetsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBProxyTargetsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBProxyTargetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBProxyTargetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBProxyTargetsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBSecurityGroupsPaginator.ts b/clients/client-rds/pagination/DescribeDBSecurityGroupsPaginator.ts index ef573d3bc7c21..4650e95b887f7 100644 --- a/clients/client-rds/pagination/DescribeDBSecurityGroupsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBSecurityGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBSecurityGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBSecurityGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBSecurityGroupsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBSnapshotsPaginator.ts b/clients/client-rds/pagination/DescribeDBSnapshotsPaginator.ts index 1f3c70387ddd8..ffbb2e92a3ab9 100644 --- a/clients/client-rds/pagination/DescribeDBSnapshotsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBSnapshotsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBSnapshotsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBSnapshotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBSnapshotsCommandInput, diff --git a/clients/client-rds/pagination/DescribeDBSubnetGroupsPaginator.ts b/clients/client-rds/pagination/DescribeDBSubnetGroupsPaginator.ts index 1630556259368..3f5830b598fe9 100644 --- a/clients/client-rds/pagination/DescribeDBSubnetGroupsPaginator.ts +++ b/clients/client-rds/pagination/DescribeDBSubnetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeDBSubnetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDBSubnetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeDBSubnetGroupsCommandInput, diff --git a/clients/client-rds/pagination/DescribeEngineDefaultParametersPaginator.ts b/clients/client-rds/pagination/DescribeEngineDefaultParametersPaginator.ts index 3497030e400fc..d93dc3eff9d98 100644 --- a/clients/client-rds/pagination/DescribeEngineDefaultParametersPaginator.ts +++ b/clients/client-rds/pagination/DescribeEngineDefaultParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeEngineDefaultParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEngineDefaultParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeEngineDefaultParametersCommandInput, diff --git a/clients/client-rds/pagination/DescribeEventSubscriptionsPaginator.ts b/clients/client-rds/pagination/DescribeEventSubscriptionsPaginator.ts index 75547f7693774..0794ebb1a39a9 100644 --- a/clients/client-rds/pagination/DescribeEventSubscriptionsPaginator.ts +++ b/clients/client-rds/pagination/DescribeEventSubscriptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeEventSubscriptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventSubscriptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeEventSubscriptionsCommandInput, diff --git a/clients/client-rds/pagination/DescribeEventsPaginator.ts b/clients/client-rds/pagination/DescribeEventsPaginator.ts index 54d543d320697..99d57bf8dbb40 100644 --- a/clients/client-rds/pagination/DescribeEventsPaginator.ts +++ b/clients/client-rds/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeEventsCommandInput, diff --git a/clients/client-rds/pagination/DescribeExportTasksPaginator.ts b/clients/client-rds/pagination/DescribeExportTasksPaginator.ts index 16fdd7c7c7b28..43a26dd266d32 100644 --- a/clients/client-rds/pagination/DescribeExportTasksPaginator.ts +++ b/clients/client-rds/pagination/DescribeExportTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeExportTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeExportTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeExportTasksCommandInput, diff --git a/clients/client-rds/pagination/DescribeGlobalClustersPaginator.ts b/clients/client-rds/pagination/DescribeGlobalClustersPaginator.ts index a5a0061424537..ec14dd26f8f1f 100644 --- a/clients/client-rds/pagination/DescribeGlobalClustersPaginator.ts +++ b/clients/client-rds/pagination/DescribeGlobalClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeGlobalClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeGlobalClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeGlobalClustersCommandInput, diff --git a/clients/client-rds/pagination/DescribeInstallationMediaPaginator.ts b/clients/client-rds/pagination/DescribeInstallationMediaPaginator.ts index 731e315199d97..e1df7078f5ec2 100644 --- a/clients/client-rds/pagination/DescribeInstallationMediaPaginator.ts +++ b/clients/client-rds/pagination/DescribeInstallationMediaPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeInstallationMediaCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstallationMediaCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeInstallationMediaCommandInput, diff --git a/clients/client-rds/pagination/DescribeOptionGroupOptionsPaginator.ts b/clients/client-rds/pagination/DescribeOptionGroupOptionsPaginator.ts index 4dc08e1035295..76668f962fba2 100644 --- a/clients/client-rds/pagination/DescribeOptionGroupOptionsPaginator.ts +++ b/clients/client-rds/pagination/DescribeOptionGroupOptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeOptionGroupOptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOptionGroupOptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeOptionGroupOptionsCommandInput, diff --git a/clients/client-rds/pagination/DescribeOptionGroupsPaginator.ts b/clients/client-rds/pagination/DescribeOptionGroupsPaginator.ts index a8908734f143d..fc847ec434e13 100644 --- a/clients/client-rds/pagination/DescribeOptionGroupsPaginator.ts +++ b/clients/client-rds/pagination/DescribeOptionGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeOptionGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOptionGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeOptionGroupsCommandInput, diff --git a/clients/client-rds/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts b/clients/client-rds/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts index c06684d89e9f2..10cfc73b8e909 100644 --- a/clients/client-rds/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts +++ b/clients/client-rds/pagination/DescribeOrderableDBInstanceOptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeOrderableDBInstanceOptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOrderableDBInstanceOptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeOrderableDBInstanceOptionsCommandInput, diff --git a/clients/client-rds/pagination/DescribePendingMaintenanceActionsPaginator.ts b/clients/client-rds/pagination/DescribePendingMaintenanceActionsPaginator.ts index 8be0b6ead6543..7e6ffae79feb0 100644 --- a/clients/client-rds/pagination/DescribePendingMaintenanceActionsPaginator.ts +++ b/clients/client-rds/pagination/DescribePendingMaintenanceActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribePendingMaintenanceActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePendingMaintenanceActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribePendingMaintenanceActionsCommandInput, diff --git a/clients/client-rds/pagination/DescribeReservedDBInstancesOfferingsPaginator.ts b/clients/client-rds/pagination/DescribeReservedDBInstancesOfferingsPaginator.ts index 058cd95864cf5..128cfa037e356 100644 --- a/clients/client-rds/pagination/DescribeReservedDBInstancesOfferingsPaginator.ts +++ b/clients/client-rds/pagination/DescribeReservedDBInstancesOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeReservedDBInstancesOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedDBInstancesOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeReservedDBInstancesOfferingsCommandInput, diff --git a/clients/client-rds/pagination/DescribeReservedDBInstancesPaginator.ts b/clients/client-rds/pagination/DescribeReservedDBInstancesPaginator.ts index 3c6f671899f5b..a54f3e3cfcabf 100644 --- a/clients/client-rds/pagination/DescribeReservedDBInstancesPaginator.ts +++ b/clients/client-rds/pagination/DescribeReservedDBInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeReservedDBInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedDBInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeReservedDBInstancesCommandInput, diff --git a/clients/client-rds/pagination/DescribeSourceRegionsPaginator.ts b/clients/client-rds/pagination/DescribeSourceRegionsPaginator.ts index b3ca76013df99..c519b6e4def26 100644 --- a/clients/client-rds/pagination/DescribeSourceRegionsPaginator.ts +++ b/clients/client-rds/pagination/DescribeSourceRegionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DescribeSourceRegionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSourceRegionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DescribeSourceRegionsCommandInput, diff --git a/clients/client-rds/pagination/DownloadDBLogFilePortionPaginator.ts b/clients/client-rds/pagination/DownloadDBLogFilePortionPaginator.ts index 1ebb3463e02a0..b248e5c5559f4 100644 --- a/clients/client-rds/pagination/DownloadDBLogFilePortionPaginator.ts +++ b/clients/client-rds/pagination/DownloadDBLogFilePortionPaginator.ts @@ -8,6 +8,9 @@ import { import { RDSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RDSClient, input: DownloadDBLogFilePortionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DownloadDBLogFilePortionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RDS, input: DownloadDBLogFilePortionCommandInput, diff --git a/clients/client-rds/runtimeConfig.browser.ts b/clients/client-rds/runtimeConfig.browser.ts index 04ca17297b270..679718f18fda9 100644 --- a/clients/client-rds/runtimeConfig.browser.ts +++ b/clients/client-rds/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RDSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-rds/runtimeConfig.native.ts b/clients/client-rds/runtimeConfig.native.ts index 84b1608e508f5..df367c874d586 100644 --- a/clients/client-rds/runtimeConfig.native.ts +++ b/clients/client-rds/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RDSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-rds/runtimeConfig.shared.ts b/clients/client-rds/runtimeConfig.shared.ts index 6c5afd6f19a75..7331c29e5ee1a 100644 --- a/clients/client-rds/runtimeConfig.shared.ts +++ b/clients/client-rds/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-10-31", disableHostPrefix: false, diff --git a/clients/client-rds/runtimeConfig.ts b/clients/client-rds/runtimeConfig.ts index 8b85e7e3a7100..de3407d0c2ab7 100644 --- a/clients/client-rds/runtimeConfig.ts +++ b/clients/client-rds/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RDSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-rds/tsconfig.json b/clients/client-rds/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-rds/tsconfig.json +++ b/clients/client-rds/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-redshift-data/commands/CancelStatementCommand.ts b/clients/client-redshift-data/commands/CancelStatementCommand.ts index 7ba9d01781201..48afeedd9767a 100644 --- a/clients/client-redshift-data/commands/CancelStatementCommand.ts +++ b/clients/client-redshift-data/commands/CancelStatementCommand.ts @@ -20,6 +20,9 @@ import { export type CancelStatementCommandInput = CancelStatementRequest; export type CancelStatementCommandOutput = CancelStatementResponse & __MetadataBearer; +/** + *

Cancels a running query. To be canceled, a query must be running.

+ */ export class CancelStatementCommand extends $Command< CancelStatementCommandInput, CancelStatementCommandOutput, @@ -34,6 +37,9 @@ export class CancelStatementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/commands/DescribeStatementCommand.ts b/clients/client-redshift-data/commands/DescribeStatementCommand.ts index cf735c42182a0..40f57a0a26206 100644 --- a/clients/client-redshift-data/commands/DescribeStatementCommand.ts +++ b/clients/client-redshift-data/commands/DescribeStatementCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeStatementCommandInput = DescribeStatementRequest; export type DescribeStatementCommandOutput = DescribeStatementResponse & __MetadataBearer; +/** + *

Describes the details about a specific instance when a query was run by the Amazon Redshift Data API. The information + * includes when the query started, when it finished, the query status, the number of rows returned, and the SQL + * statement.

+ */ export class DescribeStatementCommand extends $Command< DescribeStatementCommandInput, DescribeStatementCommandOutput, @@ -34,6 +39,9 @@ export class DescribeStatementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/commands/DescribeTableCommand.ts b/clients/client-redshift-data/commands/DescribeTableCommand.ts index 18689fd804986..84a08f5199754 100644 --- a/clients/client-redshift-data/commands/DescribeTableCommand.ts +++ b/clients/client-redshift-data/commands/DescribeTableCommand.ts @@ -20,6 +20,24 @@ import { export type DescribeTableCommandInput = DescribeTableRequest; export type DescribeTableCommandOutput = DescribeTableResponse & __MetadataBearer; +/** + *

Describes the detailed information about a table from metadata in the cluster. The + * information includes its columns. + * A token is returned to page through the column list. + * Depending on the authorization method, use one of the + * following combinations of request parameters:

+ *
    + *
  • + *

    AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the secret and the + * cluster identifier that matches the cluster in the secret.

    + *
  • + *
  • + *

    Temporary credentials - specify the cluster identifier, the database name, and the database + * user name. Permission to call the redshift:GetClusterCredentials operation is + * required to use this method.

    + *
  • + *
+ */ export class DescribeTableCommand extends $Command< DescribeTableCommandInput, DescribeTableCommandOutput, @@ -34,6 +52,9 @@ export class DescribeTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/commands/ExecuteStatementCommand.ts b/clients/client-redshift-data/commands/ExecuteStatementCommand.ts index 5fa3f3d520c60..324c76d87fbf7 100644 --- a/clients/client-redshift-data/commands/ExecuteStatementCommand.ts +++ b/clients/client-redshift-data/commands/ExecuteStatementCommand.ts @@ -20,6 +20,23 @@ import { export type ExecuteStatementCommandInput = ExecuteStatementInput; export type ExecuteStatementCommandOutput = ExecuteStatementOutput & __MetadataBearer; +/** + *

Runs an SQL statement, which can be data manipulation language (DML) or data definition + * language (DDL). This statement must be a single SQL statement. + * Depending on the authorization + * method, use one of the following combinations of request parameters:

+ *
    + *
  • + *

    AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the secret and the + * cluster identifier that matches the cluster in the secret.

    + *
  • + *
  • + *

    Temporary credentials - specify the cluster identifier, the database name, and the + * database user name. Permission to call the redshift:GetClusterCredentials + * operation is required to use this method.

    + *
  • + *
+ */ export class ExecuteStatementCommand extends $Command< ExecuteStatementCommandInput, ExecuteStatementCommandOutput, @@ -34,6 +51,9 @@ export class ExecuteStatementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/commands/GetStatementResultCommand.ts b/clients/client-redshift-data/commands/GetStatementResultCommand.ts index ab84bef210d2e..fc9d6d6e53bbc 100644 --- a/clients/client-redshift-data/commands/GetStatementResultCommand.ts +++ b/clients/client-redshift-data/commands/GetStatementResultCommand.ts @@ -20,6 +20,10 @@ import { export type GetStatementResultCommandInput = GetStatementResultRequest; export type GetStatementResultCommandOutput = GetStatementResultResponse & __MetadataBearer; +/** + *

Fetches the temporarily cached result of an SQL statement. + * A token is returned to page through the statement results.

+ */ export class GetStatementResultCommand extends $Command< GetStatementResultCommandInput, GetStatementResultCommandOutput, @@ -34,6 +38,9 @@ export class GetStatementResultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/commands/ListDatabasesCommand.ts b/clients/client-redshift-data/commands/ListDatabasesCommand.ts index 87cf4ff7a568c..dd26fd30dddb1 100644 --- a/clients/client-redshift-data/commands/ListDatabasesCommand.ts +++ b/clients/client-redshift-data/commands/ListDatabasesCommand.ts @@ -20,6 +20,23 @@ import { export type ListDatabasesCommandInput = ListDatabasesRequest; export type ListDatabasesCommandOutput = ListDatabasesResponse & __MetadataBearer; +/** + *

List the databases in a cluster. + * A token is returned to page through the database list. + * Depending on the authorization method, use one of the + * following combinations of request parameters:

+ *
    + *
  • + *

    AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the secret and the + * cluster identifier that matches the cluster in the secret.

    + *
  • + *
  • + *

    Temporary credentials - specify the cluster identifier, the database name, and the + * database user name. Permission to call the redshift:GetClusterCredentials + * operation is required to use this method.

    + *
  • + *
+ */ export class ListDatabasesCommand extends $Command< ListDatabasesCommandInput, ListDatabasesCommandOutput, @@ -34,6 +51,9 @@ export class ListDatabasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/commands/ListSchemasCommand.ts b/clients/client-redshift-data/commands/ListSchemasCommand.ts index 6e3ca02641d11..43d54a75d07bd 100644 --- a/clients/client-redshift-data/commands/ListSchemasCommand.ts +++ b/clients/client-redshift-data/commands/ListSchemasCommand.ts @@ -20,6 +20,23 @@ import { export type ListSchemasCommandInput = ListSchemasRequest; export type ListSchemasCommandOutput = ListSchemasResponse & __MetadataBearer; +/** + *

Lists the schemas in a database. + * A token is returned to page through the schema list. + * Depending on the authorization method, use one of the + * following combinations of request parameters:

+ *
    + *
  • + *

    AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the secret and the + * cluster identifier that matches the cluster in the secret.

    + *
  • + *
  • + *

    Temporary credentials - specify the cluster identifier, the database name, and the + * database user name. Permission to call the redshift:GetClusterCredentials + * operation is required to use this method.

    + *
  • + *
+ */ export class ListSchemasCommand extends $Command< ListSchemasCommandInput, ListSchemasCommandOutput, @@ -34,6 +51,9 @@ export class ListSchemasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/commands/ListStatementsCommand.ts b/clients/client-redshift-data/commands/ListStatementsCommand.ts index 9f4faeb58450e..f7fb98203f96b 100644 --- a/clients/client-redshift-data/commands/ListStatementsCommand.ts +++ b/clients/client-redshift-data/commands/ListStatementsCommand.ts @@ -20,6 +20,10 @@ import { export type ListStatementsCommandInput = ListStatementsRequest; export type ListStatementsCommandOutput = ListStatementsResponse & __MetadataBearer; +/** + *

List of SQL statements. By default, only finished statements are shown. + * A token is returned to page through the statement list.

+ */ export class ListStatementsCommand extends $Command< ListStatementsCommandInput, ListStatementsCommandOutput, @@ -34,6 +38,9 @@ export class ListStatementsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/commands/ListTablesCommand.ts b/clients/client-redshift-data/commands/ListTablesCommand.ts index cbe92bb3e31af..e55b29b517f32 100644 --- a/clients/client-redshift-data/commands/ListTablesCommand.ts +++ b/clients/client-redshift-data/commands/ListTablesCommand.ts @@ -20,6 +20,24 @@ import { export type ListTablesCommandInput = ListTablesRequest; export type ListTablesCommandOutput = ListTablesResponse & __MetadataBearer; +/** + *

List the tables in a database. If neither SchemaPattern nor TablePattern are specified, then + * all tables in the database are returned. + * A token is returned to page through the table list. + * Depending on the authorization method, use one of the + * following combinations of request parameters:

+ *
    + *
  • + *

    AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the secret and the + * cluster identifier that matches the cluster in the secret.

    + *
  • + *
  • + *

    Temporary credentials - specify the cluster identifier, the database name, and the + * database user name. Permission to call the redshift:GetClusterCredentials + * operation is required to use this method.

    + *
  • + *
+ */ export class ListTablesCommand extends $Command< ListTablesCommandInput, ListTablesCommandOutput, @@ -34,6 +52,9 @@ export class ListTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftDataClientResolvedConfig, diff --git a/clients/client-redshift-data/package.json b/clients/client-redshift-data/package.json index 131e9f5ba0cff..b6d2bc75bb6bb 100644 --- a/clients/client-redshift-data/package.json +++ b/clients/client-redshift-data/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Redshift Data Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-redshift-data/pagination/DescribeTablePaginator.ts b/clients/client-redshift-data/pagination/DescribeTablePaginator.ts index bc75510bfabde..8b2f53beb400b 100644 --- a/clients/client-redshift-data/pagination/DescribeTablePaginator.ts +++ b/clients/client-redshift-data/pagination/DescribeTablePaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftDataPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftDataClient, input: DescribeTableCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTableCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RedshiftData, input: DescribeTableCommandInput, diff --git a/clients/client-redshift-data/pagination/GetStatementResultPaginator.ts b/clients/client-redshift-data/pagination/GetStatementResultPaginator.ts index 60de07a6d9a70..c68babc6221b6 100644 --- a/clients/client-redshift-data/pagination/GetStatementResultPaginator.ts +++ b/clients/client-redshift-data/pagination/GetStatementResultPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftDataPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftDataClient, input: GetStatementResultCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetStatementResultCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RedshiftData, input: GetStatementResultCommandInput, diff --git a/clients/client-redshift-data/pagination/ListDatabasesPaginator.ts b/clients/client-redshift-data/pagination/ListDatabasesPaginator.ts index 457d6d75d50e3..8d2a3f2ed73aa 100644 --- a/clients/client-redshift-data/pagination/ListDatabasesPaginator.ts +++ b/clients/client-redshift-data/pagination/ListDatabasesPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftDataPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftDataClient, input: ListDatabasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatabasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RedshiftData, input: ListDatabasesCommandInput, diff --git a/clients/client-redshift-data/pagination/ListSchemasPaginator.ts b/clients/client-redshift-data/pagination/ListSchemasPaginator.ts index fcf2d9e0e57d2..c112361ddb0eb 100644 --- a/clients/client-redshift-data/pagination/ListSchemasPaginator.ts +++ b/clients/client-redshift-data/pagination/ListSchemasPaginator.ts @@ -4,6 +4,9 @@ import { ListSchemasCommand, ListSchemasCommandInput, ListSchemasCommandOutput } import { RedshiftDataPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftDataClient, input: ListSchemasCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSchemasCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RedshiftData, input: ListSchemasCommandInput, diff --git a/clients/client-redshift-data/pagination/ListStatementsPaginator.ts b/clients/client-redshift-data/pagination/ListStatementsPaginator.ts index 50a98b8e1c795..56a84282fe5a0 100644 --- a/clients/client-redshift-data/pagination/ListStatementsPaginator.ts +++ b/clients/client-redshift-data/pagination/ListStatementsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftDataPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftDataClient, input: ListStatementsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStatementsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RedshiftData, input: ListStatementsCommandInput, diff --git a/clients/client-redshift-data/pagination/ListTablesPaginator.ts b/clients/client-redshift-data/pagination/ListTablesPaginator.ts index f484329c1343d..122b8c79de914 100644 --- a/clients/client-redshift-data/pagination/ListTablesPaginator.ts +++ b/clients/client-redshift-data/pagination/ListTablesPaginator.ts @@ -4,6 +4,9 @@ import { ListTablesCommand, ListTablesCommandInput, ListTablesCommandOutput } fr import { RedshiftDataPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftDataClient, input: ListTablesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RedshiftData, input: ListTablesCommandInput, diff --git a/clients/client-redshift-data/runtimeConfig.browser.ts b/clients/client-redshift-data/runtimeConfig.browser.ts index 267563ead143e..f85265d7f4d78 100644 --- a/clients/client-redshift-data/runtimeConfig.browser.ts +++ b/clients/client-redshift-data/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RedshiftDataClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-redshift-data/runtimeConfig.native.ts b/clients/client-redshift-data/runtimeConfig.native.ts index 88e1bde7a2f88..c2681c976a1c4 100644 --- a/clients/client-redshift-data/runtimeConfig.native.ts +++ b/clients/client-redshift-data/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RedshiftDataClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-redshift-data/runtimeConfig.shared.ts b/clients/client-redshift-data/runtimeConfig.shared.ts index 121692426b9f7..f8165b986e58f 100644 --- a/clients/client-redshift-data/runtimeConfig.shared.ts +++ b/clients/client-redshift-data/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-20", disableHostPrefix: false, diff --git a/clients/client-redshift-data/runtimeConfig.ts b/clients/client-redshift-data/runtimeConfig.ts index 03821cfbcae41..bcb0acc43dbe4 100644 --- a/clients/client-redshift-data/runtimeConfig.ts +++ b/clients/client-redshift-data/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RedshiftDataClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-redshift-data/tsconfig.json b/clients/client-redshift-data/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-redshift-data/tsconfig.json +++ b/clients/client-redshift-data/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-redshift/commands/AcceptReservedNodeExchangeCommand.ts b/clients/client-redshift/commands/AcceptReservedNodeExchangeCommand.ts index 0098cb7fc7cc7..f616729d5d099 100644 --- a/clients/client-redshift/commands/AcceptReservedNodeExchangeCommand.ts +++ b/clients/client-redshift/commands/AcceptReservedNodeExchangeCommand.ts @@ -20,6 +20,11 @@ import { export type AcceptReservedNodeExchangeCommandInput = AcceptReservedNodeExchangeInputMessage; export type AcceptReservedNodeExchangeCommandOutput = AcceptReservedNodeExchangeOutputMessage & __MetadataBearer; +/** + *

Exchanges a DC1 Reserved Node for a DC2 Reserved Node with no changes to the + * configuration (term, payment type, or number of nodes) and no additional costs. + *

+ */ export class AcceptReservedNodeExchangeCommand extends $Command< AcceptReservedNodeExchangeCommandInput, AcceptReservedNodeExchangeCommandOutput, @@ -34,6 +39,9 @@ export class AcceptReservedNodeExchangeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/AuthorizeClusterSecurityGroupIngressCommand.ts b/clients/client-redshift/commands/AuthorizeClusterSecurityGroupIngressCommand.ts index c36901282013f..3364768c20171 100644 --- a/clients/client-redshift/commands/AuthorizeClusterSecurityGroupIngressCommand.ts +++ b/clients/client-redshift/commands/AuthorizeClusterSecurityGroupIngressCommand.ts @@ -24,6 +24,24 @@ export type AuthorizeClusterSecurityGroupIngressCommandInput = AuthorizeClusterS export type AuthorizeClusterSecurityGroupIngressCommandOutput = AuthorizeClusterSecurityGroupIngressResult & __MetadataBearer; +/** + *

Adds an inbound (ingress) rule to an Amazon Redshift security group. Depending on whether + * the application accessing your cluster is running on the Internet or an Amazon EC2 + * instance, you can authorize inbound access to either a Classless Interdomain Routing + * (CIDR)/Internet Protocol (IP) range or to an Amazon EC2 security group. You can add as + * many as 20 ingress rules to an Amazon Redshift security group.

+ *

If you authorize access to an Amazon EC2 security group, specify + * EC2SecurityGroupName and + * EC2SecurityGroupOwnerId. The Amazon EC2 security group and + * Amazon Redshift cluster must be in the same AWS Region.

+ *

If you authorize access to a CIDR/IP address range, specify + * CIDRIP. For an overview of CIDR blocks, see the Wikipedia + * article on Classless Inter-Domain Routing.

+ *

You must also associate the security group with a cluster so that clients running + * on these IP addresses or the EC2 instance are authorized to connect to the cluster. For + * information about managing security groups, go to Working with Security + * Groups in the Amazon Redshift Cluster Management Guide.

+ */ export class AuthorizeClusterSecurityGroupIngressCommand extends $Command< AuthorizeClusterSecurityGroupIngressCommandInput, AuthorizeClusterSecurityGroupIngressCommandOutput, @@ -38,6 +56,9 @@ export class AuthorizeClusterSecurityGroupIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/AuthorizeSnapshotAccessCommand.ts b/clients/client-redshift/commands/AuthorizeSnapshotAccessCommand.ts index 14e4db8168f63..1281e912d7999 100644 --- a/clients/client-redshift/commands/AuthorizeSnapshotAccessCommand.ts +++ b/clients/client-redshift/commands/AuthorizeSnapshotAccessCommand.ts @@ -20,6 +20,14 @@ import { export type AuthorizeSnapshotAccessCommandInput = AuthorizeSnapshotAccessMessage; export type AuthorizeSnapshotAccessCommandOutput = AuthorizeSnapshotAccessResult & __MetadataBearer; +/** + *

Authorizes the specified AWS customer account to restore the specified + * snapshot.

+ *

+ * For more information about working with snapshots, go to + * Amazon Redshift Snapshots + * in the Amazon Redshift Cluster Management Guide.

+ */ export class AuthorizeSnapshotAccessCommand extends $Command< AuthorizeSnapshotAccessCommandInput, AuthorizeSnapshotAccessCommandOutput, @@ -34,6 +42,9 @@ export class AuthorizeSnapshotAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/BatchDeleteClusterSnapshotsCommand.ts b/clients/client-redshift/commands/BatchDeleteClusterSnapshotsCommand.ts index 18a1efdde0cc5..2b2e8c71350ce 100644 --- a/clients/client-redshift/commands/BatchDeleteClusterSnapshotsCommand.ts +++ b/clients/client-redshift/commands/BatchDeleteClusterSnapshotsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeleteClusterSnapshotsCommandInput = BatchDeleteClusterSnapshotsRequest; export type BatchDeleteClusterSnapshotsCommandOutput = BatchDeleteClusterSnapshotsResult & __MetadataBearer; +/** + *

Deletes a set of cluster snapshots.

+ */ export class BatchDeleteClusterSnapshotsCommand extends $Command< BatchDeleteClusterSnapshotsCommandInput, BatchDeleteClusterSnapshotsCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeleteClusterSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/BatchModifyClusterSnapshotsCommand.ts b/clients/client-redshift/commands/BatchModifyClusterSnapshotsCommand.ts index 6ab4d78bbce7e..60c88d35b9052 100644 --- a/clients/client-redshift/commands/BatchModifyClusterSnapshotsCommand.ts +++ b/clients/client-redshift/commands/BatchModifyClusterSnapshotsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchModifyClusterSnapshotsCommandInput = BatchModifyClusterSnapshotsMessage; export type BatchModifyClusterSnapshotsCommandOutput = BatchModifyClusterSnapshotsOutputMessage & __MetadataBearer; +/** + *

Modifies the settings for a set of cluster snapshots.

+ */ export class BatchModifyClusterSnapshotsCommand extends $Command< BatchModifyClusterSnapshotsCommandInput, BatchModifyClusterSnapshotsCommandOutput, @@ -34,6 +37,9 @@ export class BatchModifyClusterSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CancelResizeCommand.ts b/clients/client-redshift/commands/CancelResizeCommand.ts index ec5f6f5082911..661a3633ee8ce 100644 --- a/clients/client-redshift/commands/CancelResizeCommand.ts +++ b/clients/client-redshift/commands/CancelResizeCommand.ts @@ -17,6 +17,9 @@ import { export type CancelResizeCommandInput = CancelResizeMessage; export type CancelResizeCommandOutput = ResizeProgressMessage & __MetadataBearer; +/** + *

Cancels a resize operation for a cluster.

+ */ export class CancelResizeCommand extends $Command< CancelResizeCommandInput, CancelResizeCommandOutput, @@ -31,6 +34,9 @@ export class CancelResizeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CopyClusterSnapshotCommand.ts b/clients/client-redshift/commands/CopyClusterSnapshotCommand.ts index 693e5c91e3ecf..2e4a5c0f4ee05 100644 --- a/clients/client-redshift/commands/CopyClusterSnapshotCommand.ts +++ b/clients/client-redshift/commands/CopyClusterSnapshotCommand.ts @@ -20,6 +20,20 @@ import { export type CopyClusterSnapshotCommandInput = CopyClusterSnapshotMessage; export type CopyClusterSnapshotCommandOutput = CopyClusterSnapshotResult & __MetadataBearer; +/** + *

Copies the specified automated cluster snapshot to a new manual cluster snapshot. + * The source must be an automated snapshot and it must be in the available + * state.

+ *

When you delete a cluster, Amazon Redshift deletes any automated snapshots of the + * cluster. Also, when the retention period of the snapshot expires, Amazon Redshift + * automatically deletes it. If you want to keep an automated snapshot for a longer period, + * you can make a manual copy of the snapshot. Manual snapshots are retained until you + * delete them.

+ *

+ * For more information about working with snapshots, go to + * Amazon Redshift Snapshots + * in the Amazon Redshift Cluster Management Guide.

+ */ export class CopyClusterSnapshotCommand extends $Command< CopyClusterSnapshotCommandInput, CopyClusterSnapshotCommandOutput, @@ -34,6 +48,9 @@ export class CopyClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateClusterCommand.ts b/clients/client-redshift/commands/CreateClusterCommand.ts index 333bdbc35e58e..cd0337398a47d 100644 --- a/clients/client-redshift/commands/CreateClusterCommand.ts +++ b/clients/client-redshift/commands/CreateClusterCommand.ts @@ -20,6 +20,15 @@ import { export type CreateClusterCommandInput = CreateClusterMessage; export type CreateClusterCommandOutput = CreateClusterResult & __MetadataBearer; +/** + *

Creates a new cluster with the specified parameters.

+ *

To create a cluster in Virtual Private Cloud (VPC), you must provide a cluster + * subnet group name. The cluster subnet group identifies the subnets of your VPC that + * Amazon Redshift uses when creating the cluster. + * For more information about managing clusters, go to + * Amazon Redshift Clusters + * in the Amazon Redshift Cluster Management Guide.

+ */ export class CreateClusterCommand extends $Command< CreateClusterCommandInput, CreateClusterCommandOutput, @@ -34,6 +43,9 @@ export class CreateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateClusterParameterGroupCommand.ts b/clients/client-redshift/commands/CreateClusterParameterGroupCommand.ts index 9030d20df65a7..6fc64fb521454 100644 --- a/clients/client-redshift/commands/CreateClusterParameterGroupCommand.ts +++ b/clients/client-redshift/commands/CreateClusterParameterGroupCommand.ts @@ -20,6 +20,17 @@ import { export type CreateClusterParameterGroupCommandInput = CreateClusterParameterGroupMessage; export type CreateClusterParameterGroupCommandOutput = CreateClusterParameterGroupResult & __MetadataBearer; +/** + *

Creates an Amazon Redshift parameter group.

+ *

Creating parameter groups is independent of creating clusters. You can associate a + * cluster with a parameter group when you create the cluster. You can also associate an + * existing cluster with a parameter group after the cluster is created by using ModifyCluster.

+ *

Parameters in the parameter group define specific behavior that applies to the + * databases you create on the cluster. + * For more information about parameters and parameter groups, go to + * Amazon Redshift Parameter Groups + * in the Amazon Redshift Cluster Management Guide.

+ */ export class CreateClusterParameterGroupCommand extends $Command< CreateClusterParameterGroupCommandInput, CreateClusterParameterGroupCommandOutput, @@ -34,6 +45,9 @@ export class CreateClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateClusterSecurityGroupCommand.ts b/clients/client-redshift/commands/CreateClusterSecurityGroupCommand.ts index 6ad2296a43c43..5b1a8c39ed3d4 100644 --- a/clients/client-redshift/commands/CreateClusterSecurityGroupCommand.ts +++ b/clients/client-redshift/commands/CreateClusterSecurityGroupCommand.ts @@ -20,6 +20,14 @@ import { export type CreateClusterSecurityGroupCommandInput = CreateClusterSecurityGroupMessage; export type CreateClusterSecurityGroupCommandOutput = CreateClusterSecurityGroupResult & __MetadataBearer; +/** + *

Creates a new Amazon Redshift security group. You use security groups to control access + * to non-VPC clusters.

+ *

+ * For information about managing security groups, go to + * Amazon Redshift Cluster Security Groups in the + * Amazon Redshift Cluster Management Guide.

+ */ export class CreateClusterSecurityGroupCommand extends $Command< CreateClusterSecurityGroupCommandInput, CreateClusterSecurityGroupCommandOutput, @@ -34,6 +42,9 @@ export class CreateClusterSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateClusterSnapshotCommand.ts b/clients/client-redshift/commands/CreateClusterSnapshotCommand.ts index 9f85bd34b7c9b..fc9065a9b48a9 100644 --- a/clients/client-redshift/commands/CreateClusterSnapshotCommand.ts +++ b/clients/client-redshift/commands/CreateClusterSnapshotCommand.ts @@ -20,6 +20,14 @@ import { export type CreateClusterSnapshotCommandInput = CreateClusterSnapshotMessage; export type CreateClusterSnapshotCommandOutput = CreateClusterSnapshotResult & __MetadataBearer; +/** + *

Creates a manual snapshot of the specified cluster. The cluster must be in the + * available state.

+ *

+ * For more information about working with snapshots, go to + * Amazon Redshift Snapshots + * in the Amazon Redshift Cluster Management Guide.

+ */ export class CreateClusterSnapshotCommand extends $Command< CreateClusterSnapshotCommandInput, CreateClusterSnapshotCommandOutput, @@ -34,6 +42,9 @@ export class CreateClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateClusterSubnetGroupCommand.ts b/clients/client-redshift/commands/CreateClusterSubnetGroupCommand.ts index f162aaff840ca..b733b54432d20 100644 --- a/clients/client-redshift/commands/CreateClusterSubnetGroupCommand.ts +++ b/clients/client-redshift/commands/CreateClusterSubnetGroupCommand.ts @@ -20,6 +20,15 @@ import { export type CreateClusterSubnetGroupCommandInput = CreateClusterSubnetGroupMessage; export type CreateClusterSubnetGroupCommandOutput = CreateClusterSubnetGroupResult & __MetadataBearer; +/** + *

Creates a new Amazon Redshift subnet group. You must provide a list of one or more + * subnets in your existing Amazon Virtual Private Cloud (Amazon VPC) when creating + * Amazon Redshift subnet group.

+ *

+ * For information about subnet groups, go to + * Amazon Redshift Cluster Subnet Groups in the + * Amazon Redshift Cluster Management Guide.

+ */ export class CreateClusterSubnetGroupCommand extends $Command< CreateClusterSubnetGroupCommandInput, CreateClusterSubnetGroupCommandOutput, @@ -34,6 +43,9 @@ export class CreateClusterSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateEventSubscriptionCommand.ts b/clients/client-redshift/commands/CreateEventSubscriptionCommand.ts index e05c85473eb65..6243fc587b795 100644 --- a/clients/client-redshift/commands/CreateEventSubscriptionCommand.ts +++ b/clients/client-redshift/commands/CreateEventSubscriptionCommand.ts @@ -20,6 +20,26 @@ import { export type CreateEventSubscriptionCommandInput = CreateEventSubscriptionMessage; export type CreateEventSubscriptionCommandOutput = CreateEventSubscriptionResult & __MetadataBearer; +/** + *

Creates an Amazon Redshift event notification subscription. This action requires an ARN + * (Amazon Resource Name) of an Amazon SNS topic created by either the Amazon Redshift console, + * the Amazon SNS console, or the Amazon SNS API. To obtain an ARN with Amazon SNS, you + * must create a topic in Amazon SNS and subscribe to the topic. The ARN is displayed in + * the SNS console.

+ *

You can specify the source type, and lists of Amazon Redshift source IDs, event + * categories, and event severities. Notifications will be sent for all events you want + * that match those criteria. For example, you can specify source type = cluster, source ID + * = my-cluster-1 and mycluster2, event categories = Availability, Backup, and severity = + * ERROR. The subscription will only send notifications for those ERROR events in the + * Availability and Backup categories for the specified clusters.

+ *

If you specify both the source type and source IDs, such as source type = cluster + * and source identifier = my-cluster-1, notifications will be sent for all the cluster + * events for my-cluster-1. If you specify a source type but do not specify a source + * identifier, you will receive notice of the events for the objects of that type in your + * AWS account. If you do not specify either the SourceType nor the SourceIdentifier, you + * will be notified of events generated from all Amazon Redshift sources belonging to your AWS + * account. You must specify a source type if you specify a source ID.

+ */ export class CreateEventSubscriptionCommand extends $Command< CreateEventSubscriptionCommandInput, CreateEventSubscriptionCommandOutput, @@ -34,6 +54,9 @@ export class CreateEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateHsmClientCertificateCommand.ts b/clients/client-redshift/commands/CreateHsmClientCertificateCommand.ts index 6ab66d22b6f81..da8f7826b9eff 100644 --- a/clients/client-redshift/commands/CreateHsmClientCertificateCommand.ts +++ b/clients/client-redshift/commands/CreateHsmClientCertificateCommand.ts @@ -20,6 +20,16 @@ import { export type CreateHsmClientCertificateCommandInput = CreateHsmClientCertificateMessage; export type CreateHsmClientCertificateCommandOutput = CreateHsmClientCertificateResult & __MetadataBearer; +/** + *

Creates an HSM client certificate that an Amazon Redshift cluster will use to connect to + * the client's HSM in order to store and retrieve the keys used to encrypt the cluster + * databases.

+ *

The command returns a public key, which you must store in the HSM. In addition to + * creating the HSM certificate, you must create an Amazon Redshift HSM configuration that + * provides a cluster the information needed to store and use encryption keys in the HSM. + * For more information, go to Hardware Security Modules + * in the Amazon Redshift Cluster Management Guide.

+ */ export class CreateHsmClientCertificateCommand extends $Command< CreateHsmClientCertificateCommandInput, CreateHsmClientCertificateCommandOutput, @@ -34,6 +44,9 @@ export class CreateHsmClientCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateHsmConfigurationCommand.ts b/clients/client-redshift/commands/CreateHsmConfigurationCommand.ts index 07958763b9c35..8604b848c9298 100644 --- a/clients/client-redshift/commands/CreateHsmConfigurationCommand.ts +++ b/clients/client-redshift/commands/CreateHsmConfigurationCommand.ts @@ -20,6 +20,15 @@ import { export type CreateHsmConfigurationCommandInput = CreateHsmConfigurationMessage; export type CreateHsmConfigurationCommandOutput = CreateHsmConfigurationResult & __MetadataBearer; +/** + *

Creates an HSM configuration that contains the information required by an Amazon Redshift + * cluster to store and use database encryption keys in a Hardware Security Module (HSM). + * After creating the HSM configuration, you can specify it as a parameter when creating a + * cluster. The cluster will then store its encryption keys in the HSM.

+ *

In addition to creating an HSM configuration, you must also create an HSM client + * certificate. For more information, go to Hardware Security Modules + * in the Amazon Redshift Cluster Management Guide.

+ */ export class CreateHsmConfigurationCommand extends $Command< CreateHsmConfigurationCommandInput, CreateHsmConfigurationCommandOutput, @@ -34,6 +43,9 @@ export class CreateHsmConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateScheduledActionCommand.ts b/clients/client-redshift/commands/CreateScheduledActionCommand.ts index 382652ff1d39a..892ad0aac3e75 100644 --- a/clients/client-redshift/commands/CreateScheduledActionCommand.ts +++ b/clients/client-redshift/commands/CreateScheduledActionCommand.ts @@ -20,6 +20,11 @@ import { export type CreateScheduledActionCommandInput = CreateScheduledActionMessage; export type CreateScheduledActionCommandOutput = ScheduledAction & __MetadataBearer; +/** + *

Creates a scheduled action. A scheduled action contains a schedule and an Amazon Redshift API action. + * For example, you can create a schedule of when to run the ResizeCluster API operation. + *

+ */ export class CreateScheduledActionCommand extends $Command< CreateScheduledActionCommandInput, CreateScheduledActionCommandOutput, @@ -34,6 +39,9 @@ export class CreateScheduledActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateSnapshotCopyGrantCommand.ts b/clients/client-redshift/commands/CreateSnapshotCopyGrantCommand.ts index 431bead70b5f2..7051605136f11 100644 --- a/clients/client-redshift/commands/CreateSnapshotCopyGrantCommand.ts +++ b/clients/client-redshift/commands/CreateSnapshotCopyGrantCommand.ts @@ -20,6 +20,16 @@ import { export type CreateSnapshotCopyGrantCommandInput = CreateSnapshotCopyGrantMessage; export type CreateSnapshotCopyGrantCommandOutput = CreateSnapshotCopyGrantResult & __MetadataBearer; +/** + *

Creates a snapshot copy grant that permits Amazon Redshift to use a customer master key + * (CMK) from AWS Key Management Service (AWS KMS) to encrypt copied snapshots in a + * destination region.

+ *

+ * For more information about managing snapshot copy grants, go to + * Amazon Redshift Database Encryption + * in the Amazon Redshift Cluster Management Guide. + *

+ */ export class CreateSnapshotCopyGrantCommand extends $Command< CreateSnapshotCopyGrantCommandInput, CreateSnapshotCopyGrantCommandOutput, @@ -34,6 +44,9 @@ export class CreateSnapshotCopyGrantCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateSnapshotScheduleCommand.ts b/clients/client-redshift/commands/CreateSnapshotScheduleCommand.ts index 5ad3c099d6ee6..49292461f8614 100644 --- a/clients/client-redshift/commands/CreateSnapshotScheduleCommand.ts +++ b/clients/client-redshift/commands/CreateSnapshotScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSnapshotScheduleCommandInput = CreateSnapshotScheduleMessage; export type CreateSnapshotScheduleCommandOutput = SnapshotSchedule & __MetadataBearer; +/** + *

Create a snapshot schedule that can be associated to a cluster and which overrides the default system backup schedule.

+ */ export class CreateSnapshotScheduleCommand extends $Command< CreateSnapshotScheduleCommandInput, CreateSnapshotScheduleCommandOutput, @@ -34,6 +37,9 @@ export class CreateSnapshotScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateTagsCommand.ts b/clients/client-redshift/commands/CreateTagsCommand.ts index 3ed2cb3cba9d4..8f155d783f4c3 100644 --- a/clients/client-redshift/commands/CreateTagsCommand.ts +++ b/clients/client-redshift/commands/CreateTagsCommand.ts @@ -17,6 +17,13 @@ import { export type CreateTagsCommandInput = CreateTagsMessage; export type CreateTagsCommandOutput = __MetadataBearer; +/** + *

Adds tags to a cluster.

+ *

A resource can have up to 50 tags. If you try to create more than 50 tags for a + * resource, you will receive an error and the attempt will fail.

+ *

If you specify a key that already exists for the resource, the value for that key + * will be updated with the new value.

+ */ export class CreateTagsCommand extends $Command< CreateTagsCommandInput, CreateTagsCommandOutput, @@ -31,6 +38,9 @@ export class CreateTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/CreateUsageLimitCommand.ts b/clients/client-redshift/commands/CreateUsageLimitCommand.ts index 6c1903d6cda42..44a7f6202fe64 100644 --- a/clients/client-redshift/commands/CreateUsageLimitCommand.ts +++ b/clients/client-redshift/commands/CreateUsageLimitCommand.ts @@ -20,6 +20,10 @@ import { export type CreateUsageLimitCommandInput = CreateUsageLimitMessage; export type CreateUsageLimitCommandOutput = UsageLimit & __MetadataBearer; +/** + *

Creates a usage limit for a specified Amazon Redshift feature on a cluster. + * The usage limit is identified by the returned usage limit identifier.

+ */ export class CreateUsageLimitCommand extends $Command< CreateUsageLimitCommandInput, CreateUsageLimitCommandOutput, @@ -34,6 +38,9 @@ export class CreateUsageLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteClusterCommand.ts b/clients/client-redshift/commands/DeleteClusterCommand.ts index 0ee0255555db1..434d059301f76 100644 --- a/clients/client-redshift/commands/DeleteClusterCommand.ts +++ b/clients/client-redshift/commands/DeleteClusterCommand.ts @@ -20,6 +20,24 @@ import { export type DeleteClusterCommandInput = DeleteClusterMessage; export type DeleteClusterCommandOutput = DeleteClusterResult & __MetadataBearer; +/** + *

Deletes a previously provisioned cluster without its final snapshot being created. A successful response from the web + * service indicates that the request was received correctly. Use DescribeClusters to monitor the status of the deletion. The delete + * operation cannot be canceled or reverted once submitted. + * For more information about managing clusters, go to + * Amazon Redshift Clusters + * in the Amazon Redshift Cluster Management Guide.

+ *

If you want to shut down the cluster and retain it for future use, set + * SkipFinalClusterSnapshot to false and specify a + * name for FinalClusterSnapshotIdentifier. You can later restore this + * snapshot to resume using the cluster. If a final cluster snapshot is requested, the + * status of the cluster will be "final-snapshot" while the snapshot is being taken, then + * it's "deleting" once Amazon Redshift begins deleting the cluster.

+ *

+ * For more information about managing clusters, go to + * Amazon Redshift Clusters + * in the Amazon Redshift Cluster Management Guide.

+ */ export class DeleteClusterCommand extends $Command< DeleteClusterCommandInput, DeleteClusterCommandOutput, @@ -34,6 +52,9 @@ export class DeleteClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteClusterParameterGroupCommand.ts b/clients/client-redshift/commands/DeleteClusterParameterGroupCommand.ts index 3711040ef4d51..4be50fd70c48a 100644 --- a/clients/client-redshift/commands/DeleteClusterParameterGroupCommand.ts +++ b/clients/client-redshift/commands/DeleteClusterParameterGroupCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteClusterParameterGroupCommandInput = DeleteClusterParameterGroupMessage; export type DeleteClusterParameterGroupCommandOutput = __MetadataBearer; +/** + *

Deletes a specified Amazon Redshift parameter group.

+ * + *

You cannot delete a parameter group if it is associated with a + * cluster.

+ *
+ */ export class DeleteClusterParameterGroupCommand extends $Command< DeleteClusterParameterGroupCommandInput, DeleteClusterParameterGroupCommandOutput, @@ -34,6 +41,9 @@ export class DeleteClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteClusterSecurityGroupCommand.ts b/clients/client-redshift/commands/DeleteClusterSecurityGroupCommand.ts index dc0c3498403e3..0cc6444ceca94 100644 --- a/clients/client-redshift/commands/DeleteClusterSecurityGroupCommand.ts +++ b/clients/client-redshift/commands/DeleteClusterSecurityGroupCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteClusterSecurityGroupCommandInput = DeleteClusterSecurityGroupMessage; export type DeleteClusterSecurityGroupCommandOutput = __MetadataBearer; +/** + *

Deletes an Amazon Redshift security group.

+ * + *

You cannot delete a security group that is associated with any clusters. You + * cannot delete the default security group.

+ *
+ *

+ * For information about managing security groups, go to + * Amazon Redshift Cluster Security Groups in the + * Amazon Redshift Cluster Management Guide.

+ */ export class DeleteClusterSecurityGroupCommand extends $Command< DeleteClusterSecurityGroupCommandInput, DeleteClusterSecurityGroupCommandOutput, @@ -34,6 +45,9 @@ export class DeleteClusterSecurityGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteClusterSnapshotCommand.ts b/clients/client-redshift/commands/DeleteClusterSnapshotCommand.ts index 498b711234d08..e086461102813 100644 --- a/clients/client-redshift/commands/DeleteClusterSnapshotCommand.ts +++ b/clients/client-redshift/commands/DeleteClusterSnapshotCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteClusterSnapshotCommandInput = DeleteClusterSnapshotMessage; export type DeleteClusterSnapshotCommandOutput = DeleteClusterSnapshotResult & __MetadataBearer; +/** + *

Deletes the specified manual snapshot. The snapshot must be in the + * available state, with no other users authorized to access the snapshot.

+ *

Unlike automated snapshots, manual snapshots are retained even after you delete + * your cluster. Amazon Redshift does not delete your manual snapshots. You must delete manual + * snapshot explicitly to avoid getting charged. If other accounts are authorized to access + * the snapshot, you must revoke all of the authorizations before you can delete the + * snapshot.

+ */ export class DeleteClusterSnapshotCommand extends $Command< DeleteClusterSnapshotCommandInput, DeleteClusterSnapshotCommandOutput, @@ -34,6 +43,9 @@ export class DeleteClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteClusterSubnetGroupCommand.ts b/clients/client-redshift/commands/DeleteClusterSubnetGroupCommand.ts index a7dcedee29ec7..2cea177005d31 100644 --- a/clients/client-redshift/commands/DeleteClusterSubnetGroupCommand.ts +++ b/clients/client-redshift/commands/DeleteClusterSubnetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteClusterSubnetGroupCommandInput = DeleteClusterSubnetGroupMessage; export type DeleteClusterSubnetGroupCommandOutput = __MetadataBearer; +/** + *

Deletes the specified cluster subnet group.

+ */ export class DeleteClusterSubnetGroupCommand extends $Command< DeleteClusterSubnetGroupCommandInput, DeleteClusterSubnetGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteClusterSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteEventSubscriptionCommand.ts b/clients/client-redshift/commands/DeleteEventSubscriptionCommand.ts index 9115e6b51346e..9e1bb232cc413 100644 --- a/clients/client-redshift/commands/DeleteEventSubscriptionCommand.ts +++ b/clients/client-redshift/commands/DeleteEventSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteEventSubscriptionCommandInput = DeleteEventSubscriptionMessage; export type DeleteEventSubscriptionCommandOutput = __MetadataBearer; +/** + *

Deletes an Amazon Redshift event notification subscription.

+ */ export class DeleteEventSubscriptionCommand extends $Command< DeleteEventSubscriptionCommandInput, DeleteEventSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteHsmClientCertificateCommand.ts b/clients/client-redshift/commands/DeleteHsmClientCertificateCommand.ts index 000c002283368..98507c529c86a 100644 --- a/clients/client-redshift/commands/DeleteHsmClientCertificateCommand.ts +++ b/clients/client-redshift/commands/DeleteHsmClientCertificateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteHsmClientCertificateCommandInput = DeleteHsmClientCertificateMessage; export type DeleteHsmClientCertificateCommandOutput = __MetadataBearer; +/** + *

Deletes the specified HSM client certificate.

+ */ export class DeleteHsmClientCertificateCommand extends $Command< DeleteHsmClientCertificateCommandInput, DeleteHsmClientCertificateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteHsmClientCertificateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteHsmConfigurationCommand.ts b/clients/client-redshift/commands/DeleteHsmConfigurationCommand.ts index 6990a49924db4..d3c23cce255df 100644 --- a/clients/client-redshift/commands/DeleteHsmConfigurationCommand.ts +++ b/clients/client-redshift/commands/DeleteHsmConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteHsmConfigurationCommandInput = DeleteHsmConfigurationMessage; export type DeleteHsmConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the specified Amazon Redshift HSM configuration.

+ */ export class DeleteHsmConfigurationCommand extends $Command< DeleteHsmConfigurationCommandInput, DeleteHsmConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteHsmConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteScheduledActionCommand.ts b/clients/client-redshift/commands/DeleteScheduledActionCommand.ts index fd35d740157f5..df9050e543327 100644 --- a/clients/client-redshift/commands/DeleteScheduledActionCommand.ts +++ b/clients/client-redshift/commands/DeleteScheduledActionCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteScheduledActionCommandInput = DeleteScheduledActionMessage; export type DeleteScheduledActionCommandOutput = __MetadataBearer; +/** + *

Deletes a scheduled action. + *

+ */ export class DeleteScheduledActionCommand extends $Command< DeleteScheduledActionCommandInput, DeleteScheduledActionCommandOutput, @@ -34,6 +38,9 @@ export class DeleteScheduledActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteSnapshotCopyGrantCommand.ts b/clients/client-redshift/commands/DeleteSnapshotCopyGrantCommand.ts index 08c7c442683fc..33ea5da421f17 100644 --- a/clients/client-redshift/commands/DeleteSnapshotCopyGrantCommand.ts +++ b/clients/client-redshift/commands/DeleteSnapshotCopyGrantCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSnapshotCopyGrantCommandInput = DeleteSnapshotCopyGrantMessage; export type DeleteSnapshotCopyGrantCommandOutput = __MetadataBearer; +/** + *

Deletes the specified snapshot copy grant.

+ */ export class DeleteSnapshotCopyGrantCommand extends $Command< DeleteSnapshotCopyGrantCommandInput, DeleteSnapshotCopyGrantCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSnapshotCopyGrantCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteSnapshotScheduleCommand.ts b/clients/client-redshift/commands/DeleteSnapshotScheduleCommand.ts index 46b9ccf7493e1..3f0211dddfa5f 100644 --- a/clients/client-redshift/commands/DeleteSnapshotScheduleCommand.ts +++ b/clients/client-redshift/commands/DeleteSnapshotScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSnapshotScheduleCommandInput = DeleteSnapshotScheduleMessage; export type DeleteSnapshotScheduleCommandOutput = __MetadataBearer; +/** + *

Deletes a snapshot schedule.

+ */ export class DeleteSnapshotScheduleCommand extends $Command< DeleteSnapshotScheduleCommandInput, DeleteSnapshotScheduleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSnapshotScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteTagsCommand.ts b/clients/client-redshift/commands/DeleteTagsCommand.ts index 851283cd3f4d1..904eadf23a313 100644 --- a/clients/client-redshift/commands/DeleteTagsCommand.ts +++ b/clients/client-redshift/commands/DeleteTagsCommand.ts @@ -17,6 +17,10 @@ import { export type DeleteTagsCommandInput = DeleteTagsMessage; export type DeleteTagsCommandOutput = __MetadataBearer; +/** + *

Deletes tags from a resource. You must provide the ARN of the resource + * from which you want to delete the tag or tags.

+ */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -31,6 +35,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DeleteUsageLimitCommand.ts b/clients/client-redshift/commands/DeleteUsageLimitCommand.ts index ca78384d0b851..c55e062162fe3 100644 --- a/clients/client-redshift/commands/DeleteUsageLimitCommand.ts +++ b/clients/client-redshift/commands/DeleteUsageLimitCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUsageLimitCommandInput = DeleteUsageLimitMessage; export type DeleteUsageLimitCommandOutput = __MetadataBearer; +/** + *

Deletes a usage limit from a cluster.

+ */ export class DeleteUsageLimitCommand extends $Command< DeleteUsageLimitCommandInput, DeleteUsageLimitCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUsageLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeAccountAttributesCommand.ts b/clients/client-redshift/commands/DescribeAccountAttributesCommand.ts index c7a82f7758af7..47227996a7595 100644 --- a/clients/client-redshift/commands/DescribeAccountAttributesCommand.ts +++ b/clients/client-redshift/commands/DescribeAccountAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAccountAttributesCommandInput = DescribeAccountAttributesMessage; export type DescribeAccountAttributesCommandOutput = AccountAttributeList & __MetadataBearer; +/** + *

Returns a list of attributes attached to an account

+ */ export class DescribeAccountAttributesCommand extends $Command< DescribeAccountAttributesCommandInput, DescribeAccountAttributesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAccountAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClusterDbRevisionsCommand.ts b/clients/client-redshift/commands/DescribeClusterDbRevisionsCommand.ts index f3bf9ed715551..bc42a95feef13 100644 --- a/clients/client-redshift/commands/DescribeClusterDbRevisionsCommand.ts +++ b/clients/client-redshift/commands/DescribeClusterDbRevisionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClusterDbRevisionsCommandInput = DescribeClusterDbRevisionsMessage; export type DescribeClusterDbRevisionsCommandOutput = ClusterDbRevisionsMessage & __MetadataBearer; +/** + *

Returns an array of ClusterDbRevision objects.

+ */ export class DescribeClusterDbRevisionsCommand extends $Command< DescribeClusterDbRevisionsCommandInput, DescribeClusterDbRevisionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClusterDbRevisionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClusterParameterGroupsCommand.ts b/clients/client-redshift/commands/DescribeClusterParameterGroupsCommand.ts index 571162d6bdfdf..c1ee0a7fa79eb 100644 --- a/clients/client-redshift/commands/DescribeClusterParameterGroupsCommand.ts +++ b/clients/client-redshift/commands/DescribeClusterParameterGroupsCommand.ts @@ -20,6 +20,25 @@ import { export type DescribeClusterParameterGroupsCommandInput = DescribeClusterParameterGroupsMessage; export type DescribeClusterParameterGroupsCommandOutput = ClusterParameterGroupsMessage & __MetadataBearer; +/** + *

Returns a list of Amazon Redshift parameter groups, including parameter groups you + * created and the default parameter group. For each parameter group, the response includes + * the parameter group name, description, and parameter group family name. You can + * optionally specify a name to retrieve the description of a specific parameter + * group.

+ *

+ * For more information about parameters and parameter groups, go to + * Amazon Redshift Parameter Groups + * in the Amazon Redshift Cluster Management Guide.

+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all parameter groups that match any combination of the specified keys and values. For + * example, if you have owner and environment for tag keys, and + * admin and test for tag values, all parameter groups that + * have any combination of those values are returned.

+ *

If both tag keys and values are omitted from the request, parameter groups are + * returned regardless of whether they have tag keys or values associated with + * them.

+ */ export class DescribeClusterParameterGroupsCommand extends $Command< DescribeClusterParameterGroupsCommandInput, DescribeClusterParameterGroupsCommandOutput, @@ -34,6 +53,9 @@ export class DescribeClusterParameterGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClusterParametersCommand.ts b/clients/client-redshift/commands/DescribeClusterParametersCommand.ts index a0073bebb729c..7a178ffa9d848 100644 --- a/clients/client-redshift/commands/DescribeClusterParametersCommand.ts +++ b/clients/client-redshift/commands/DescribeClusterParametersCommand.ts @@ -20,6 +20,20 @@ import { export type DescribeClusterParametersCommandInput = DescribeClusterParametersMessage; export type DescribeClusterParametersCommandOutput = ClusterParameterGroupDetails & __MetadataBearer; +/** + *

Returns a detailed list of parameters contained within the specified Amazon Redshift + * parameter group. For each parameter the response includes information such as parameter + * name, description, data type, value, whether the parameter value is modifiable, and so + * on.

+ *

You can specify source filter to retrieve parameters of only + * specific type. For example, to retrieve parameters that were modified by a user action + * such as from ModifyClusterParameterGroup, you can specify + * source equal to user.

+ *

+ * For more information about parameters and parameter groups, go to + * Amazon Redshift Parameter Groups + * in the Amazon Redshift Cluster Management Guide.

+ */ export class DescribeClusterParametersCommand extends $Command< DescribeClusterParametersCommandInput, DescribeClusterParametersCommandOutput, @@ -34,6 +48,9 @@ export class DescribeClusterParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClusterSecurityGroupsCommand.ts b/clients/client-redshift/commands/DescribeClusterSecurityGroupsCommand.ts index 1ce8127623b6a..e0232ddc4e504 100644 --- a/clients/client-redshift/commands/DescribeClusterSecurityGroupsCommand.ts +++ b/clients/client-redshift/commands/DescribeClusterSecurityGroupsCommand.ts @@ -20,6 +20,23 @@ import { export type DescribeClusterSecurityGroupsCommandInput = DescribeClusterSecurityGroupsMessage; export type DescribeClusterSecurityGroupsCommandOutput = ClusterSecurityGroupMessage & __MetadataBearer; +/** + *

Returns information about Amazon Redshift security groups. If the name of a security + * group is specified, the response will contain only information about only that security + * group.

+ *

+ * For information about managing security groups, go to + * Amazon Redshift Cluster Security Groups in the + * Amazon Redshift Cluster Management Guide.

+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all security groups that match any combination of the specified keys and values. For + * example, if you have owner and environment for tag keys, and + * admin and test for tag values, all security groups that + * have any combination of those values are returned.

+ *

If both tag keys and values are omitted from the request, security groups are + * returned regardless of whether they have tag keys or values associated with + * them.

+ */ export class DescribeClusterSecurityGroupsCommand extends $Command< DescribeClusterSecurityGroupsCommandInput, DescribeClusterSecurityGroupsCommandOutput, @@ -34,6 +51,9 @@ export class DescribeClusterSecurityGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClusterSnapshotsCommand.ts b/clients/client-redshift/commands/DescribeClusterSnapshotsCommand.ts index df32bb160562c..13ff34c8ecb8b 100644 --- a/clients/client-redshift/commands/DescribeClusterSnapshotsCommand.ts +++ b/clients/client-redshift/commands/DescribeClusterSnapshotsCommand.ts @@ -20,6 +20,21 @@ import { export type DescribeClusterSnapshotsCommandInput = DescribeClusterSnapshotsMessage; export type DescribeClusterSnapshotsCommandOutput = SnapshotMessage & __MetadataBearer; +/** + *

Returns one or more snapshot objects, which contain metadata about your cluster + * snapshots. By default, this operation returns information about all snapshots of all + * clusters that are owned by you AWS customer account. No information is returned for + * snapshots owned by inactive AWS customer accounts.

+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all snapshots that match any combination of the specified keys and values. For example, + * if you have owner and environment for tag keys, and + * admin and test for tag values, all snapshots that have any + * combination of those values are returned. Only snapshots that you own are returned in + * the response; shared snapshots are not returned with the tag key and tag value request + * parameters.

+ *

If both tag keys and values are omitted from the request, snapshots are returned + * regardless of whether they have tag keys or values associated with them.

+ */ export class DescribeClusterSnapshotsCommand extends $Command< DescribeClusterSnapshotsCommandInput, DescribeClusterSnapshotsCommandOutput, @@ -34,6 +49,9 @@ export class DescribeClusterSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClusterSubnetGroupsCommand.ts b/clients/client-redshift/commands/DescribeClusterSubnetGroupsCommand.ts index 7592a18ab772f..65589ce8fd5cc 100644 --- a/clients/client-redshift/commands/DescribeClusterSubnetGroupsCommand.ts +++ b/clients/client-redshift/commands/DescribeClusterSubnetGroupsCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeClusterSubnetGroupsCommandInput = DescribeClusterSubnetGroupsMessage; export type DescribeClusterSubnetGroupsCommandOutput = ClusterSubnetGroupMessage & __MetadataBearer; +/** + *

Returns one or more cluster subnet group objects, which contain metadata about your + * cluster subnet groups. By default, this operation returns information about all cluster + * subnet groups that are defined in you AWS account.

+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all subnet groups that match any combination of the specified keys and values. For + * example, if you have owner and environment for tag keys, and + * admin and test for tag values, all subnet groups that have + * any combination of those values are returned.

+ *

If both tag keys and values are omitted from the request, subnet groups are + * returned regardless of whether they have tag keys or values associated with + * them.

+ */ export class DescribeClusterSubnetGroupsCommand extends $Command< DescribeClusterSubnetGroupsCommandInput, DescribeClusterSubnetGroupsCommandOutput, @@ -34,6 +47,9 @@ export class DescribeClusterSubnetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClusterTracksCommand.ts b/clients/client-redshift/commands/DescribeClusterTracksCommand.ts index 5c27b371a8119..351b5ec488c93 100644 --- a/clients/client-redshift/commands/DescribeClusterTracksCommand.ts +++ b/clients/client-redshift/commands/DescribeClusterTracksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClusterTracksCommandInput = DescribeClusterTracksMessage; export type DescribeClusterTracksCommandOutput = TrackListMessage & __MetadataBearer; +/** + *

Returns a list of all the available maintenance tracks.

+ */ export class DescribeClusterTracksCommand extends $Command< DescribeClusterTracksCommandInput, DescribeClusterTracksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClusterTracksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClusterVersionsCommand.ts b/clients/client-redshift/commands/DescribeClusterVersionsCommand.ts index f75c8740eb912..2361210d74b24 100644 --- a/clients/client-redshift/commands/DescribeClusterVersionsCommand.ts +++ b/clients/client-redshift/commands/DescribeClusterVersionsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeClusterVersionsCommandInput = DescribeClusterVersionsMessage; export type DescribeClusterVersionsCommandOutput = ClusterVersionsMessage & __MetadataBearer; +/** + *

Returns descriptions of the available Amazon Redshift cluster versions. You can call this + * operation even before creating any clusters to learn more about the Amazon Redshift versions. + * + * For more information about managing clusters, go to + * Amazon Redshift Clusters + * in the Amazon Redshift Cluster Management Guide.

+ */ export class DescribeClusterVersionsCommand extends $Command< DescribeClusterVersionsCommandInput, DescribeClusterVersionsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeClusterVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeClustersCommand.ts b/clients/client-redshift/commands/DescribeClustersCommand.ts index 34f44e083d686..7945c560deb88 100644 --- a/clients/client-redshift/commands/DescribeClustersCommand.ts +++ b/clients/client-redshift/commands/DescribeClustersCommand.ts @@ -20,6 +20,21 @@ import { export type DescribeClustersCommandInput = DescribeClustersMessage; export type DescribeClustersCommandOutput = ClustersMessage & __MetadataBearer; +/** + *

Returns properties of provisioned clusters including general cluster properties, + * cluster database properties, maintenance and backup properties, and security and access + * properties. This operation supports pagination. + * For more information about managing clusters, go to + * Amazon Redshift Clusters + * in the Amazon Redshift Cluster Management Guide.

+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all clusters that match any combination of the specified keys and values. For example, + * if you have owner and environment for tag keys, and + * admin and test for tag values, all clusters that have any + * combination of those values are returned.

+ *

If both tag keys and values are omitted from the request, clusters are returned + * regardless of whether they have tag keys or values associated with them.

+ */ export class DescribeClustersCommand extends $Command< DescribeClustersCommandInput, DescribeClustersCommandOutput, @@ -34,6 +49,9 @@ export class DescribeClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeDefaultClusterParametersCommand.ts b/clients/client-redshift/commands/DescribeDefaultClusterParametersCommand.ts index 0b954e3b708b4..0e4b95a99ca31 100644 --- a/clients/client-redshift/commands/DescribeDefaultClusterParametersCommand.ts +++ b/clients/client-redshift/commands/DescribeDefaultClusterParametersCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeDefaultClusterParametersCommandInput = DescribeDefaultClusterParametersMessage; export type DescribeDefaultClusterParametersCommandOutput = DescribeDefaultClusterParametersResult & __MetadataBearer; +/** + *

Returns a list of parameter settings for the specified parameter group + * family.

+ *

+ * For more information about parameters and parameter groups, go to + * Amazon Redshift Parameter Groups + * in the Amazon Redshift Cluster Management Guide.

+ */ export class DescribeDefaultClusterParametersCommand extends $Command< DescribeDefaultClusterParametersCommandInput, DescribeDefaultClusterParametersCommandOutput, @@ -34,6 +42,9 @@ export class DescribeDefaultClusterParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeEventCategoriesCommand.ts b/clients/client-redshift/commands/DescribeEventCategoriesCommand.ts index ba2a0746d419e..9cda163c706de 100644 --- a/clients/client-redshift/commands/DescribeEventCategoriesCommand.ts +++ b/clients/client-redshift/commands/DescribeEventCategoriesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeEventCategoriesCommandInput = DescribeEventCategoriesMessage; export type DescribeEventCategoriesCommandOutput = EventCategoriesMessage & __MetadataBearer; +/** + *

Displays a list of event categories for all event source types, or for a specified + * source type. For a list of the event categories and source types, go to Amazon Redshift Event + * Notifications.

+ */ export class DescribeEventCategoriesCommand extends $Command< DescribeEventCategoriesCommandInput, DescribeEventCategoriesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeEventCategoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeEventSubscriptionsCommand.ts b/clients/client-redshift/commands/DescribeEventSubscriptionsCommand.ts index b3526facd4e6f..49d61f03d111c 100644 --- a/clients/client-redshift/commands/DescribeEventSubscriptionsCommand.ts +++ b/clients/client-redshift/commands/DescribeEventSubscriptionsCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeEventSubscriptionsCommandInput = DescribeEventSubscriptionsMessage; export type DescribeEventSubscriptionsCommandOutput = EventSubscriptionsMessage & __MetadataBearer; +/** + *

Lists descriptions of all the Amazon Redshift event notification subscriptions for a + * customer account. If you specify a subscription name, lists the description for that + * subscription.

+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all event notification subscriptions that match any combination of the specified keys + * and values. For example, if you have owner and environment for + * tag keys, and admin and test for tag values, all subscriptions + * that have any combination of those values are returned.

+ *

If both tag keys and values are omitted from the request, subscriptions are + * returned regardless of whether they have tag keys or values associated with + * them.

+ */ export class DescribeEventSubscriptionsCommand extends $Command< DescribeEventSubscriptionsCommandInput, DescribeEventSubscriptionsCommandOutput, @@ -34,6 +47,9 @@ export class DescribeEventSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeEventsCommand.ts b/clients/client-redshift/commands/DescribeEventsCommand.ts index 3a8e2d587cc3d..09f786ce7bd16 100644 --- a/clients/client-redshift/commands/DescribeEventsCommand.ts +++ b/clients/client-redshift/commands/DescribeEventsCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeEventsCommandInput = DescribeEventsMessage; export type DescribeEventsCommandOutput = EventsMessage & __MetadataBearer; +/** + *

Returns events related to clusters, security groups, snapshots, and parameter + * groups for the past 14 days. Events specific to a particular cluster, security group, + * snapshot or parameter group can be obtained by providing the name as a parameter. By + * default, the past hour of events are returned.

+ */ export class DescribeEventsCommand extends $Command< DescribeEventsCommandInput, DescribeEventsCommandOutput, @@ -34,6 +40,9 @@ export class DescribeEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeHsmClientCertificatesCommand.ts b/clients/client-redshift/commands/DescribeHsmClientCertificatesCommand.ts index 8fa0b47d86b09..9b6663e9a7ff6 100644 --- a/clients/client-redshift/commands/DescribeHsmClientCertificatesCommand.ts +++ b/clients/client-redshift/commands/DescribeHsmClientCertificatesCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeHsmClientCertificatesCommandInput = DescribeHsmClientCertificatesMessage; export type DescribeHsmClientCertificatesCommandOutput = HsmClientCertificateMessage & __MetadataBearer; +/** + *

Returns information about the specified HSM client certificate. If no certificate + * ID is specified, returns information about all the HSM certificates owned by your AWS + * customer account.

+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all HSM client certificates that match any combination of the specified keys and values. + * For example, if you have owner and environment for tag keys, + * and admin and test for tag values, all HSM client certificates + * that have any combination of those values are returned.

+ *

If both tag keys and values are omitted from the request, HSM client certificates + * are returned regardless of whether they have tag keys or values associated with + * them.

+ */ export class DescribeHsmClientCertificatesCommand extends $Command< DescribeHsmClientCertificatesCommandInput, DescribeHsmClientCertificatesCommandOutput, @@ -34,6 +47,9 @@ export class DescribeHsmClientCertificatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeHsmConfigurationsCommand.ts b/clients/client-redshift/commands/DescribeHsmConfigurationsCommand.ts index 989d34b155e38..43d843c2f41c2 100644 --- a/clients/client-redshift/commands/DescribeHsmConfigurationsCommand.ts +++ b/clients/client-redshift/commands/DescribeHsmConfigurationsCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeHsmConfigurationsCommandInput = DescribeHsmConfigurationsMessage; export type DescribeHsmConfigurationsCommandOutput = HsmConfigurationMessage & __MetadataBearer; +/** + *

Returns information about the specified Amazon Redshift HSM configuration. If no + * configuration ID is specified, returns information about all the HSM configurations + * owned by your AWS customer account.

+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all HSM connections that match any combination of the specified keys and values. For + * example, if you have owner and environment for tag keys, and + * admin and test for tag values, all HSM connections that + * have any combination of those values are returned.

+ *

If both tag keys and values are omitted from the request, HSM connections are + * returned regardless of whether they have tag keys or values associated with + * them.

+ */ export class DescribeHsmConfigurationsCommand extends $Command< DescribeHsmConfigurationsCommandInput, DescribeHsmConfigurationsCommandOutput, @@ -34,6 +47,9 @@ export class DescribeHsmConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeLoggingStatusCommand.ts b/clients/client-redshift/commands/DescribeLoggingStatusCommand.ts index 0114a51042d3e..3b79788137871 100644 --- a/clients/client-redshift/commands/DescribeLoggingStatusCommand.ts +++ b/clients/client-redshift/commands/DescribeLoggingStatusCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeLoggingStatusCommandInput = DescribeLoggingStatusMessage; export type DescribeLoggingStatusCommandOutput = LoggingStatus & __MetadataBearer; +/** + *

Describes whether information, such as queries and connection attempts, is being + * logged for the specified Amazon Redshift cluster.

+ */ export class DescribeLoggingStatusCommand extends $Command< DescribeLoggingStatusCommandInput, DescribeLoggingStatusCommandOutput, @@ -34,6 +38,9 @@ export class DescribeLoggingStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeNodeConfigurationOptionsCommand.ts b/clients/client-redshift/commands/DescribeNodeConfigurationOptionsCommand.ts index 83d1e41da182f..2b03ccb08703b 100644 --- a/clients/client-redshift/commands/DescribeNodeConfigurationOptionsCommand.ts +++ b/clients/client-redshift/commands/DescribeNodeConfigurationOptionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeNodeConfigurationOptionsCommandInput = DescribeNodeConfigurationOptionsMessage; export type DescribeNodeConfigurationOptionsCommandOutput = NodeConfigurationOptionsMessage & __MetadataBearer; +/** + *

Returns properties of possible node configurations such as node type, number of nodes, and + * disk usage for the specified action type.

+ */ export class DescribeNodeConfigurationOptionsCommand extends $Command< DescribeNodeConfigurationOptionsCommandInput, DescribeNodeConfigurationOptionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeNodeConfigurationOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeOrderableClusterOptionsCommand.ts b/clients/client-redshift/commands/DescribeOrderableClusterOptionsCommand.ts index 0c52dfd0990a3..2ba7ce0b380ca 100644 --- a/clients/client-redshift/commands/DescribeOrderableClusterOptionsCommand.ts +++ b/clients/client-redshift/commands/DescribeOrderableClusterOptionsCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeOrderableClusterOptionsCommandInput = DescribeOrderableClusterOptionsMessage; export type DescribeOrderableClusterOptionsCommandOutput = OrderableClusterOptionsMessage & __MetadataBearer; +/** + *

Returns a list of orderable cluster options. Before you create a new cluster you + * can use this operation to find what options are available, such as the EC2 Availability + * Zones (AZ) in the specific AWS Region that you can specify, and the node types you can + * request. The node types differ by available storage, memory, CPU and price. With the + * cost involved you might want to obtain a list of cluster options in the specific region + * and specify values when creating a cluster. + * For more information about managing clusters, go to + * Amazon Redshift Clusters + * in the Amazon Redshift Cluster Management Guide.

+ */ export class DescribeOrderableClusterOptionsCommand extends $Command< DescribeOrderableClusterOptionsCommandInput, DescribeOrderableClusterOptionsCommandOutput, @@ -34,6 +45,9 @@ export class DescribeOrderableClusterOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeReservedNodeOfferingsCommand.ts b/clients/client-redshift/commands/DescribeReservedNodeOfferingsCommand.ts index 2c3eb3aec5f7a..271ac1825edbb 100644 --- a/clients/client-redshift/commands/DescribeReservedNodeOfferingsCommand.ts +++ b/clients/client-redshift/commands/DescribeReservedNodeOfferingsCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeReservedNodeOfferingsCommandInput = DescribeReservedNodeOfferingsMessage; export type DescribeReservedNodeOfferingsCommandOutput = ReservedNodeOfferingsMessage & __MetadataBearer; +/** + *

Returns a list of the available reserved node offerings by Amazon Redshift with their + * descriptions including the node type, the fixed and recurring costs of reserving the + * node and duration the node will be reserved for you. These descriptions help you + * determine which reserve node offering you want to purchase. You then use the unique + * offering ID in you call to PurchaseReservedNodeOffering to reserve one + * or more nodes for your Amazon Redshift cluster.

+ *

+ * For more information about reserved node offerings, go to + * Purchasing Reserved Nodes + * in the Amazon Redshift Cluster Management Guide.

+ */ export class DescribeReservedNodeOfferingsCommand extends $Command< DescribeReservedNodeOfferingsCommandInput, DescribeReservedNodeOfferingsCommandOutput, @@ -34,6 +46,9 @@ export class DescribeReservedNodeOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeReservedNodesCommand.ts b/clients/client-redshift/commands/DescribeReservedNodesCommand.ts index 1dcddb539e400..16a8b739bdf29 100644 --- a/clients/client-redshift/commands/DescribeReservedNodesCommand.ts +++ b/clients/client-redshift/commands/DescribeReservedNodesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeReservedNodesCommandInput = DescribeReservedNodesMessage; export type DescribeReservedNodesCommandOutput = ReservedNodesMessage & __MetadataBearer; +/** + *

Returns the descriptions of the reserved nodes.

+ */ export class DescribeReservedNodesCommand extends $Command< DescribeReservedNodesCommandInput, DescribeReservedNodesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeReservedNodesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeResizeCommand.ts b/clients/client-redshift/commands/DescribeResizeCommand.ts index 8659865e40c79..f1365b910dbb5 100644 --- a/clients/client-redshift/commands/DescribeResizeCommand.ts +++ b/clients/client-redshift/commands/DescribeResizeCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeResizeCommandInput = DescribeResizeMessage; export type DescribeResizeCommandOutput = ResizeProgressMessage & __MetadataBearer; +/** + *

Returns information about the last resize operation for the specified cluster. If + * no resize operation has ever been initiated for the specified cluster, a HTTP + * 404 error is returned. If a resize operation was initiated and completed, the + * status of the resize remains as SUCCEEDED until the next resize.

+ *

A resize operation can be requested using ModifyCluster and + * specifying a different number or type of nodes for the cluster.

+ */ export class DescribeResizeCommand extends $Command< DescribeResizeCommandInput, DescribeResizeCommandOutput, @@ -34,6 +42,9 @@ export class DescribeResizeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeScheduledActionsCommand.ts b/clients/client-redshift/commands/DescribeScheduledActionsCommand.ts index c8d7fefc4dc7a..1f54cd12b8b75 100644 --- a/clients/client-redshift/commands/DescribeScheduledActionsCommand.ts +++ b/clients/client-redshift/commands/DescribeScheduledActionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeScheduledActionsCommandInput = DescribeScheduledActionsMessage; export type DescribeScheduledActionsCommandOutput = ScheduledActionsMessage & __MetadataBearer; +/** + *

Describes properties of scheduled actions. + *

+ */ export class DescribeScheduledActionsCommand extends $Command< DescribeScheduledActionsCommandInput, DescribeScheduledActionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeScheduledActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeSnapshotCopyGrantsCommand.ts b/clients/client-redshift/commands/DescribeSnapshotCopyGrantsCommand.ts index 6f46322259787..a80452272ca56 100644 --- a/clients/client-redshift/commands/DescribeSnapshotCopyGrantsCommand.ts +++ b/clients/client-redshift/commands/DescribeSnapshotCopyGrantsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeSnapshotCopyGrantsCommandInput = DescribeSnapshotCopyGrantsMessage; export type DescribeSnapshotCopyGrantsCommandOutput = SnapshotCopyGrantMessage & __MetadataBearer; +/** + *

Returns a list of snapshot copy grants owned by the AWS account in the destination + * region.

+ *

+ * For more information about managing snapshot copy grants, go to + * Amazon Redshift Database Encryption + * in the Amazon Redshift Cluster Management Guide. + *

+ */ export class DescribeSnapshotCopyGrantsCommand extends $Command< DescribeSnapshotCopyGrantsCommandInput, DescribeSnapshotCopyGrantsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeSnapshotCopyGrantsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeSnapshotSchedulesCommand.ts b/clients/client-redshift/commands/DescribeSnapshotSchedulesCommand.ts index b5551c0c9c60e..93de9b44cff2b 100644 --- a/clients/client-redshift/commands/DescribeSnapshotSchedulesCommand.ts +++ b/clients/client-redshift/commands/DescribeSnapshotSchedulesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSnapshotSchedulesCommandInput = DescribeSnapshotSchedulesMessage; export type DescribeSnapshotSchedulesCommandOutput = DescribeSnapshotSchedulesOutputMessage & __MetadataBearer; +/** + *

Returns a list of snapshot schedules.

+ */ export class DescribeSnapshotSchedulesCommand extends $Command< DescribeSnapshotSchedulesCommandInput, DescribeSnapshotSchedulesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSnapshotSchedulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeStorageCommand.ts b/clients/client-redshift/commands/DescribeStorageCommand.ts index 05d1729715624..4546434cfa497 100644 --- a/clients/client-redshift/commands/DescribeStorageCommand.ts +++ b/clients/client-redshift/commands/DescribeStorageCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeStorageCommandInput = {}; export type DescribeStorageCommandOutput = CustomerStorageMessage & __MetadataBearer; +/** + *

Returns account level backups storage size and provisional storage.

+ */ export class DescribeStorageCommand extends $Command< DescribeStorageCommandInput, DescribeStorageCommandOutput, @@ -34,6 +37,9 @@ export class DescribeStorageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeTableRestoreStatusCommand.ts b/clients/client-redshift/commands/DescribeTableRestoreStatusCommand.ts index 85751e8e23493..49648e8c6b505 100644 --- a/clients/client-redshift/commands/DescribeTableRestoreStatusCommand.ts +++ b/clients/client-redshift/commands/DescribeTableRestoreStatusCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeTableRestoreStatusCommandInput = DescribeTableRestoreStatusMessage; export type DescribeTableRestoreStatusCommandOutput = TableRestoreStatusMessage & __MetadataBearer; +/** + *

Lists the status of one or more table restore requests made using the RestoreTableFromClusterSnapshot API action. If you don't specify a value + * for the TableRestoreRequestId parameter, then + * DescribeTableRestoreStatus returns the status of all table restore + * requests ordered by the date and time of the request in ascending order. Otherwise + * DescribeTableRestoreStatus returns the status of the table specified by + * TableRestoreRequestId.

+ */ export class DescribeTableRestoreStatusCommand extends $Command< DescribeTableRestoreStatusCommandInput, DescribeTableRestoreStatusCommandOutput, @@ -34,6 +42,9 @@ export class DescribeTableRestoreStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeTagsCommand.ts b/clients/client-redshift/commands/DescribeTagsCommand.ts index e77257a5ec1eb..624c7a2de3b13 100644 --- a/clients/client-redshift/commands/DescribeTagsCommand.ts +++ b/clients/client-redshift/commands/DescribeTagsCommand.ts @@ -17,6 +17,33 @@ import { export type DescribeTagsCommandInput = DescribeTagsMessage; export type DescribeTagsCommandOutput = TaggedResourceListMessage & __MetadataBearer; +/** + *

Returns a list of tags. You can return tags from a specific resource by specifying + * an ARN, or you can return all tags for a given type of resource, such as clusters, + * snapshots, and so on.

+ *

The following are limitations for DescribeTags:

+ *
    + *
  • + *

    You cannot specify an ARN and a resource-type value together in the same + * request.

    + *
  • + *
  • + *

    You cannot use the MaxRecords and Marker + * parameters together with the ARN parameter.

    + *
  • + *
  • + *

    The MaxRecords parameter can be a range from 10 to 50 results + * to return in a request.

    + *
  • + *
+ *

If you specify both tag keys and tag values in the same request, Amazon Redshift returns + * all resources that match any combination of the specified keys and values. For example, + * if you have owner and environment for tag keys, and + * admin and test for tag values, all resources that have any + * combination of those values are returned.

+ *

If both tag keys and values are omitted from the request, resources are returned + * regardless of whether they have tag keys or values associated with them.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -31,6 +58,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DescribeUsageLimitsCommand.ts b/clients/client-redshift/commands/DescribeUsageLimitsCommand.ts index f1d0017b50c0a..e84527e8f6d5c 100644 --- a/clients/client-redshift/commands/DescribeUsageLimitsCommand.ts +++ b/clients/client-redshift/commands/DescribeUsageLimitsCommand.ts @@ -20,6 +20,28 @@ import { export type DescribeUsageLimitsCommandInput = DescribeUsageLimitsMessage; export type DescribeUsageLimitsCommandOutput = UsageLimitList & __MetadataBearer; +/** + *

Shows usage limits on a cluster. + * Results are filtered based on the combination of input usage limit identifier, cluster identifier, and feature type parameters:

+ *
    + *
  • + *

    If usage limit identifier, cluster identifier, and feature type are not provided, + * then all usage limit objects for the current account in the current region are returned.

    + *
  • + *
  • + *

    If usage limit identifier is provided, + * then the corresponding usage limit object is returned.

    + *
  • + *
  • + *

    If cluster identifier is provided, + * then all usage limit objects for the specified cluster are returned.

    + *
  • + *
  • + *

    If cluster identifier and feature type are provided, + * then all usage limit objects for the combination of cluster and feature are returned.

    + *
  • + *
+ */ export class DescribeUsageLimitsCommand extends $Command< DescribeUsageLimitsCommandInput, DescribeUsageLimitsCommandOutput, @@ -34,6 +56,9 @@ export class DescribeUsageLimitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DisableLoggingCommand.ts b/clients/client-redshift/commands/DisableLoggingCommand.ts index 64de9d7709dce..ea1299969e460 100644 --- a/clients/client-redshift/commands/DisableLoggingCommand.ts +++ b/clients/client-redshift/commands/DisableLoggingCommand.ts @@ -20,6 +20,10 @@ import { export type DisableLoggingCommandInput = DisableLoggingMessage; export type DisableLoggingCommandOutput = LoggingStatus & __MetadataBearer; +/** + *

Stops logging information, such as queries and connection attempts, for the + * specified Amazon Redshift cluster.

+ */ export class DisableLoggingCommand extends $Command< DisableLoggingCommandInput, DisableLoggingCommandOutput, @@ -34,6 +38,9 @@ export class DisableLoggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/DisableSnapshotCopyCommand.ts b/clients/client-redshift/commands/DisableSnapshotCopyCommand.ts index 0b3a8149df518..10443326d021d 100644 --- a/clients/client-redshift/commands/DisableSnapshotCopyCommand.ts +++ b/clients/client-redshift/commands/DisableSnapshotCopyCommand.ts @@ -20,6 +20,13 @@ import { export type DisableSnapshotCopyCommandInput = DisableSnapshotCopyMessage; export type DisableSnapshotCopyCommandOutput = DisableSnapshotCopyResult & __MetadataBearer; +/** + *

Disables the automatic copying of snapshots from one region to another region for a + * specified cluster.

+ *

If your cluster and its snapshots are encrypted using a customer master key (CMK) + * from AWS KMS, use DeleteSnapshotCopyGrant to delete the grant that + * grants Amazon Redshift permission to the CMK in the destination region.

+ */ export class DisableSnapshotCopyCommand extends $Command< DisableSnapshotCopyCommandInput, DisableSnapshotCopyCommandOutput, @@ -34,6 +41,9 @@ export class DisableSnapshotCopyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/EnableLoggingCommand.ts b/clients/client-redshift/commands/EnableLoggingCommand.ts index 92a7cee85e47f..129b2d432fdb4 100644 --- a/clients/client-redshift/commands/EnableLoggingCommand.ts +++ b/clients/client-redshift/commands/EnableLoggingCommand.ts @@ -20,6 +20,10 @@ import { export type EnableLoggingCommandInput = EnableLoggingMessage; export type EnableLoggingCommandOutput = LoggingStatus & __MetadataBearer; +/** + *

Starts logging information, such as queries and connection attempts, for the + * specified Amazon Redshift cluster.

+ */ export class EnableLoggingCommand extends $Command< EnableLoggingCommandInput, EnableLoggingCommandOutput, @@ -34,6 +38,9 @@ export class EnableLoggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/EnableSnapshotCopyCommand.ts b/clients/client-redshift/commands/EnableSnapshotCopyCommand.ts index b561266d114b4..b9fd48afe436f 100644 --- a/clients/client-redshift/commands/EnableSnapshotCopyCommand.ts +++ b/clients/client-redshift/commands/EnableSnapshotCopyCommand.ts @@ -20,6 +20,10 @@ import { export type EnableSnapshotCopyCommandInput = EnableSnapshotCopyMessage; export type EnableSnapshotCopyCommandOutput = EnableSnapshotCopyResult & __MetadataBearer; +/** + *

Enables the automatic copy of snapshots from one region to another region for a + * specified cluster.

+ */ export class EnableSnapshotCopyCommand extends $Command< EnableSnapshotCopyCommandInput, EnableSnapshotCopyCommandOutput, @@ -34,6 +38,9 @@ export class EnableSnapshotCopyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/GetClusterCredentialsCommand.ts b/clients/client-redshift/commands/GetClusterCredentialsCommand.ts index dde5031ca7a4c..e9c615b161c6e 100644 --- a/clients/client-redshift/commands/GetClusterCredentialsCommand.ts +++ b/clients/client-redshift/commands/GetClusterCredentialsCommand.ts @@ -20,6 +20,29 @@ import { export type GetClusterCredentialsCommandInput = GetClusterCredentialsMessage; export type GetClusterCredentialsCommandOutput = ClusterCredentials & __MetadataBearer; +/** + *

Returns a database user name and temporary password with temporary authorization to + * log on to an Amazon Redshift database. The action returns the database user name + * prefixed with IAM: if AutoCreate is False or + * IAMA: if AutoCreate is True. You can + * optionally specify one or more database user groups that the user will join at log on. + * By default, the temporary credentials expire in 900 seconds. You can optionally specify + * a duration between 900 seconds (15 minutes) and 3600 seconds (60 minutes). For more + * information, see Using IAM Authentication + * to Generate Database User Credentials in the Amazon Redshift Cluster Management Guide.

+ *

The AWS Identity and Access Management (IAM)user or role that executes + * GetClusterCredentials must have an IAM policy attached that allows access to all + * necessary actions and resources. For more information about permissions, see Resource Policies for GetClusterCredentials in the + * Amazon Redshift Cluster Management Guide.

+ *

If the DbGroups parameter is specified, the IAM policy must allow the + * redshift:JoinGroup action with access to the listed + * dbgroups.

+ *

In addition, if the AutoCreate parameter is set to True, + * then the policy must include the redshift:CreateClusterUser + * privilege.

+ *

If the DbName parameter is specified, the IAM policy must allow access + * to the resource dbname for the specified database name.

+ */ export class GetClusterCredentialsCommand extends $Command< GetClusterCredentialsCommandInput, GetClusterCredentialsCommandOutput, @@ -34,6 +57,9 @@ export class GetClusterCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/GetReservedNodeExchangeOfferingsCommand.ts b/clients/client-redshift/commands/GetReservedNodeExchangeOfferingsCommand.ts index f53647f1bd117..26c2450240653 100644 --- a/clients/client-redshift/commands/GetReservedNodeExchangeOfferingsCommand.ts +++ b/clients/client-redshift/commands/GetReservedNodeExchangeOfferingsCommand.ts @@ -24,6 +24,10 @@ export type GetReservedNodeExchangeOfferingsCommandInput = GetReservedNodeExchan export type GetReservedNodeExchangeOfferingsCommandOutput = GetReservedNodeExchangeOfferingsOutputMessage & __MetadataBearer; +/** + *

Returns an array of DC2 ReservedNodeOfferings that matches the payment type, term, + * and usage price of the given DC1 reserved node.

+ */ export class GetReservedNodeExchangeOfferingsCommand extends $Command< GetReservedNodeExchangeOfferingsCommandInput, GetReservedNodeExchangeOfferingsCommandOutput, @@ -38,6 +42,9 @@ export class GetReservedNodeExchangeOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyClusterCommand.ts b/clients/client-redshift/commands/ModifyClusterCommand.ts index a2fd00f443d4a..51bec1658dadb 100644 --- a/clients/client-redshift/commands/ModifyClusterCommand.ts +++ b/clients/client-redshift/commands/ModifyClusterCommand.ts @@ -20,6 +20,17 @@ import { export type ModifyClusterCommandInput = ModifyClusterMessage; export type ModifyClusterCommandOutput = ModifyClusterResult & __MetadataBearer; +/** + *

Modifies the settings for a cluster.

+ *

You can also change node type and the number of nodes to scale up or down the + * cluster. When resizing a cluster, you must specify both the number of nodes and the node + * type even if one of the parameters does not change.

+ *

You can add another security or + * parameter group, or change the master user password. Resetting a cluster password or modifying the security groups associated with a cluster do not need a reboot. However, modifying a parameter group requires a reboot for parameters to take effect. + * For more information about managing clusters, go to + * Amazon Redshift Clusters + * in the Amazon Redshift Cluster Management Guide.

+ */ export class ModifyClusterCommand extends $Command< ModifyClusterCommandInput, ModifyClusterCommandOutput, @@ -34,6 +45,9 @@ export class ModifyClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyClusterDbRevisionCommand.ts b/clients/client-redshift/commands/ModifyClusterDbRevisionCommand.ts index 75834cc7cdcc0..4fc73bd92ee50 100644 --- a/clients/client-redshift/commands/ModifyClusterDbRevisionCommand.ts +++ b/clients/client-redshift/commands/ModifyClusterDbRevisionCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyClusterDbRevisionCommandInput = ModifyClusterDbRevisionMessage; export type ModifyClusterDbRevisionCommandOutput = ModifyClusterDbRevisionResult & __MetadataBearer; +/** + *

Modifies the database revision of a cluster. The database revision is a unique + * revision of the database running in a cluster.

+ */ export class ModifyClusterDbRevisionCommand extends $Command< ModifyClusterDbRevisionCommandInput, ModifyClusterDbRevisionCommandOutput, @@ -34,6 +38,9 @@ export class ModifyClusterDbRevisionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyClusterIamRolesCommand.ts b/clients/client-redshift/commands/ModifyClusterIamRolesCommand.ts index 3497832b8df34..89ecb900aad20 100644 --- a/clients/client-redshift/commands/ModifyClusterIamRolesCommand.ts +++ b/clients/client-redshift/commands/ModifyClusterIamRolesCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyClusterIamRolesCommandInput = ModifyClusterIamRolesMessage; export type ModifyClusterIamRolesCommandOutput = ModifyClusterIamRolesResult & __MetadataBearer; +/** + *

Modifies the list of AWS Identity and Access Management (IAM) roles that can be + * used by the cluster to access other AWS services.

+ *

A cluster can have up to 10 IAM roles associated at any time.

+ */ export class ModifyClusterIamRolesCommand extends $Command< ModifyClusterIamRolesCommandInput, ModifyClusterIamRolesCommandOutput, @@ -34,6 +39,9 @@ export class ModifyClusterIamRolesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyClusterMaintenanceCommand.ts b/clients/client-redshift/commands/ModifyClusterMaintenanceCommand.ts index ed79524dbc2e6..45de11f36b737 100644 --- a/clients/client-redshift/commands/ModifyClusterMaintenanceCommand.ts +++ b/clients/client-redshift/commands/ModifyClusterMaintenanceCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyClusterMaintenanceCommandInput = ModifyClusterMaintenanceMessage; export type ModifyClusterMaintenanceCommandOutput = ModifyClusterMaintenanceResult & __MetadataBearer; +/** + *

Modifies the maintenance settings of a cluster.

+ */ export class ModifyClusterMaintenanceCommand extends $Command< ModifyClusterMaintenanceCommandInput, ModifyClusterMaintenanceCommandOutput, @@ -34,6 +37,9 @@ export class ModifyClusterMaintenanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyClusterParameterGroupCommand.ts b/clients/client-redshift/commands/ModifyClusterParameterGroupCommand.ts index f3c6561af6637..1c58da236d5fe 100644 --- a/clients/client-redshift/commands/ModifyClusterParameterGroupCommand.ts +++ b/clients/client-redshift/commands/ModifyClusterParameterGroupCommand.ts @@ -21,6 +21,13 @@ import { export type ModifyClusterParameterGroupCommandInput = ModifyClusterParameterGroupMessage; export type ModifyClusterParameterGroupCommandOutput = ClusterParameterGroupNameMessage & __MetadataBearer; +/** + *

Modifies the parameters of a parameter group.

+ *

+ * For more information about parameters and parameter groups, go to + * Amazon Redshift Parameter Groups + * in the Amazon Redshift Cluster Management Guide.

+ */ export class ModifyClusterParameterGroupCommand extends $Command< ModifyClusterParameterGroupCommandInput, ModifyClusterParameterGroupCommandOutput, @@ -35,6 +42,9 @@ export class ModifyClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyClusterSnapshotCommand.ts b/clients/client-redshift/commands/ModifyClusterSnapshotCommand.ts index 16d9e1e6ea3dd..29b218ca6222a 100644 --- a/clients/client-redshift/commands/ModifyClusterSnapshotCommand.ts +++ b/clients/client-redshift/commands/ModifyClusterSnapshotCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyClusterSnapshotCommandInput = ModifyClusterSnapshotMessage; export type ModifyClusterSnapshotCommandOutput = ModifyClusterSnapshotResult & __MetadataBearer; +/** + *

Modifies the settings for a snapshot.

+ *

This exanmple modifies the manual retention period setting for a cluster snapshot.

+ */ export class ModifyClusterSnapshotCommand extends $Command< ModifyClusterSnapshotCommandInput, ModifyClusterSnapshotCommandOutput, @@ -34,6 +38,9 @@ export class ModifyClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyClusterSnapshotScheduleCommand.ts b/clients/client-redshift/commands/ModifyClusterSnapshotScheduleCommand.ts index cc03e4b9b44a3..ca591b15ab3f3 100644 --- a/clients/client-redshift/commands/ModifyClusterSnapshotScheduleCommand.ts +++ b/clients/client-redshift/commands/ModifyClusterSnapshotScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyClusterSnapshotScheduleCommandInput = ModifyClusterSnapshotScheduleMessage; export type ModifyClusterSnapshotScheduleCommandOutput = __MetadataBearer; +/** + *

Modifies a snapshot schedule for a cluster.

+ */ export class ModifyClusterSnapshotScheduleCommand extends $Command< ModifyClusterSnapshotScheduleCommandInput, ModifyClusterSnapshotScheduleCommandOutput, @@ -34,6 +37,9 @@ export class ModifyClusterSnapshotScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyClusterSubnetGroupCommand.ts b/clients/client-redshift/commands/ModifyClusterSubnetGroupCommand.ts index 57f3668204597..5bfca3cb0bb26 100644 --- a/clients/client-redshift/commands/ModifyClusterSubnetGroupCommand.ts +++ b/clients/client-redshift/commands/ModifyClusterSubnetGroupCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyClusterSubnetGroupCommandInput = ModifyClusterSubnetGroupMessage; export type ModifyClusterSubnetGroupCommandOutput = ModifyClusterSubnetGroupResult & __MetadataBearer; +/** + *

Modifies a cluster subnet group to include the specified list of VPC subnets. The + * operation replaces the existing list of subnets with the new list of subnets.

+ */ export class ModifyClusterSubnetGroupCommand extends $Command< ModifyClusterSubnetGroupCommandInput, ModifyClusterSubnetGroupCommandOutput, @@ -34,6 +38,9 @@ export class ModifyClusterSubnetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyEventSubscriptionCommand.ts b/clients/client-redshift/commands/ModifyEventSubscriptionCommand.ts index 5999c89dc5cf3..eb9d4058b9680 100644 --- a/clients/client-redshift/commands/ModifyEventSubscriptionCommand.ts +++ b/clients/client-redshift/commands/ModifyEventSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyEventSubscriptionCommandInput = ModifyEventSubscriptionMessage; export type ModifyEventSubscriptionCommandOutput = ModifyEventSubscriptionResult & __MetadataBearer; +/** + *

Modifies an existing Amazon Redshift event notification subscription.

+ */ export class ModifyEventSubscriptionCommand extends $Command< ModifyEventSubscriptionCommandInput, ModifyEventSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class ModifyEventSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyScheduledActionCommand.ts b/clients/client-redshift/commands/ModifyScheduledActionCommand.ts index c750c2f88087e..18a55ad8f0d90 100644 --- a/clients/client-redshift/commands/ModifyScheduledActionCommand.ts +++ b/clients/client-redshift/commands/ModifyScheduledActionCommand.ts @@ -21,6 +21,10 @@ import { export type ModifyScheduledActionCommandInput = ModifyScheduledActionMessage; export type ModifyScheduledActionCommandOutput = ScheduledAction & __MetadataBearer; +/** + *

Modifies a scheduled action. + *

+ */ export class ModifyScheduledActionCommand extends $Command< ModifyScheduledActionCommandInput, ModifyScheduledActionCommandOutput, @@ -35,6 +39,9 @@ export class ModifyScheduledActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifySnapshotCopyRetentionPeriodCommand.ts b/clients/client-redshift/commands/ModifySnapshotCopyRetentionPeriodCommand.ts index f2b993090329e..a69c3dc90e48a 100644 --- a/clients/client-redshift/commands/ModifySnapshotCopyRetentionPeriodCommand.ts +++ b/clients/client-redshift/commands/ModifySnapshotCopyRetentionPeriodCommand.ts @@ -20,6 +20,15 @@ import { export type ModifySnapshotCopyRetentionPeriodCommandInput = ModifySnapshotCopyRetentionPeriodMessage; export type ModifySnapshotCopyRetentionPeriodCommandOutput = ModifySnapshotCopyRetentionPeriodResult & __MetadataBearer; +/** + *

Modifies the number of days to retain snapshots in the destination AWS Region after + * they are copied from the source AWS Region. By default, this operation only changes the + * retention period of copied automated snapshots. The retention periods for both new and + * existing copied automated snapshots are updated with the new retention period. You can + * set the manual option to change only the retention periods of copied manual snapshots. + * If you set this option, only newly copied manual snapshots have the new retention + * period.

+ */ export class ModifySnapshotCopyRetentionPeriodCommand extends $Command< ModifySnapshotCopyRetentionPeriodCommandInput, ModifySnapshotCopyRetentionPeriodCommandOutput, @@ -34,6 +43,9 @@ export class ModifySnapshotCopyRetentionPeriodCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifySnapshotScheduleCommand.ts b/clients/client-redshift/commands/ModifySnapshotScheduleCommand.ts index 4a5315d00b107..4773432ee6537 100644 --- a/clients/client-redshift/commands/ModifySnapshotScheduleCommand.ts +++ b/clients/client-redshift/commands/ModifySnapshotScheduleCommand.ts @@ -21,6 +21,10 @@ import { export type ModifySnapshotScheduleCommandInput = ModifySnapshotScheduleMessage; export type ModifySnapshotScheduleCommandOutput = SnapshotSchedule & __MetadataBearer; +/** + *

Modifies a snapshot schedule. Any schedule associated with a cluster is modified + * asynchronously.

+ */ export class ModifySnapshotScheduleCommand extends $Command< ModifySnapshotScheduleCommandInput, ModifySnapshotScheduleCommandOutput, @@ -35,6 +39,9 @@ export class ModifySnapshotScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ModifyUsageLimitCommand.ts b/clients/client-redshift/commands/ModifyUsageLimitCommand.ts index 4bb91ed938bcb..7c84481c5843b 100644 --- a/clients/client-redshift/commands/ModifyUsageLimitCommand.ts +++ b/clients/client-redshift/commands/ModifyUsageLimitCommand.ts @@ -21,6 +21,10 @@ import { export type ModifyUsageLimitCommandInput = ModifyUsageLimitMessage; export type ModifyUsageLimitCommandOutput = UsageLimit & __MetadataBearer; +/** + *

Modifies a usage limit in a cluster. + * You can't modify the feature type or period of a usage limit.

+ */ export class ModifyUsageLimitCommand extends $Command< ModifyUsageLimitCommandInput, ModifyUsageLimitCommandOutput, @@ -35,6 +39,9 @@ export class ModifyUsageLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/PauseClusterCommand.ts b/clients/client-redshift/commands/PauseClusterCommand.ts index 38d17aaf2a4c5..2f028de3e0eae 100644 --- a/clients/client-redshift/commands/PauseClusterCommand.ts +++ b/clients/client-redshift/commands/PauseClusterCommand.ts @@ -18,6 +18,9 @@ import { export type PauseClusterCommandInput = PauseClusterMessage; export type PauseClusterCommandOutput = PauseClusterResult & __MetadataBearer; +/** + *

Pauses a cluster.

+ */ export class PauseClusterCommand extends $Command< PauseClusterCommandInput, PauseClusterCommandOutput, @@ -32,6 +35,9 @@ export class PauseClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/PurchaseReservedNodeOfferingCommand.ts b/clients/client-redshift/commands/PurchaseReservedNodeOfferingCommand.ts index 02fe1b35ce4e1..ac376406ff28b 100644 --- a/clients/client-redshift/commands/PurchaseReservedNodeOfferingCommand.ts +++ b/clients/client-redshift/commands/PurchaseReservedNodeOfferingCommand.ts @@ -20,6 +20,17 @@ import { export type PurchaseReservedNodeOfferingCommandInput = PurchaseReservedNodeOfferingMessage; export type PurchaseReservedNodeOfferingCommandOutput = PurchaseReservedNodeOfferingResult & __MetadataBearer; +/** + *

Allows you to purchase reserved nodes. Amazon Redshift offers a predefined set of + * reserved node offerings. You can purchase one or more of the offerings. You can call the + * DescribeReservedNodeOfferings API to obtain the available reserved + * node offerings. You can call this API by providing a specific reserved node offering and + * the number of nodes you want to reserve.

+ *

+ * For more information about reserved node offerings, go to + * Purchasing Reserved Nodes + * in the Amazon Redshift Cluster Management Guide.

+ */ export class PurchaseReservedNodeOfferingCommand extends $Command< PurchaseReservedNodeOfferingCommandInput, PurchaseReservedNodeOfferingCommandOutput, @@ -34,6 +45,9 @@ export class PurchaseReservedNodeOfferingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/RebootClusterCommand.ts b/clients/client-redshift/commands/RebootClusterCommand.ts index f887c7419e3af..0b2605f81e9c1 100644 --- a/clients/client-redshift/commands/RebootClusterCommand.ts +++ b/clients/client-redshift/commands/RebootClusterCommand.ts @@ -20,6 +20,16 @@ import { export type RebootClusterCommandInput = RebootClusterMessage; export type RebootClusterCommandOutput = RebootClusterResult & __MetadataBearer; +/** + *

Reboots a cluster. This action is taken as soon as possible. It results in a + * momentary outage to the cluster, during which the cluster status is set to + * rebooting. A cluster event is created when the reboot is completed. Any + * pending cluster modifications (see ModifyCluster) are applied at this + * reboot. + * For more information about managing clusters, go to + * Amazon Redshift Clusters + * in the Amazon Redshift Cluster Management Guide.

+ */ export class RebootClusterCommand extends $Command< RebootClusterCommandInput, RebootClusterCommandOutput, @@ -34,6 +44,9 @@ export class RebootClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ResetClusterParameterGroupCommand.ts b/clients/client-redshift/commands/ResetClusterParameterGroupCommand.ts index a0bf987b8a818..2259f6d2ff9b0 100644 --- a/clients/client-redshift/commands/ResetClusterParameterGroupCommand.ts +++ b/clients/client-redshift/commands/ResetClusterParameterGroupCommand.ts @@ -21,6 +21,12 @@ import { export type ResetClusterParameterGroupCommandInput = ResetClusterParameterGroupMessage; export type ResetClusterParameterGroupCommandOutput = ClusterParameterGroupNameMessage & __MetadataBearer; +/** + *

Sets one or more parameters of the specified parameter group to their default + * values and sets the source values of the parameters to "engine-default". To reset the + * entire parameter group specify the ResetAllParameters parameter. + * For parameter changes to take effect you must reboot any associated clusters.

+ */ export class ResetClusterParameterGroupCommand extends $Command< ResetClusterParameterGroupCommandInput, ResetClusterParameterGroupCommandOutput, @@ -35,6 +41,9 @@ export class ResetClusterParameterGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ResizeClusterCommand.ts b/clients/client-redshift/commands/ResizeClusterCommand.ts index 3377558ed0fed..26177f8d97892 100644 --- a/clients/client-redshift/commands/ResizeClusterCommand.ts +++ b/clients/client-redshift/commands/ResizeClusterCommand.ts @@ -21,6 +21,48 @@ import { export type ResizeClusterCommandInput = ResizeClusterMessage; export type ResizeClusterCommandOutput = ResizeClusterResult & __MetadataBearer; +/** + *

Changes the size of the cluster. You can change the cluster's type, or change the + * number or type of nodes. The default behavior is to use the elastic resize method. With + * an elastic resize, your cluster is available for read and write operations more quickly + * than with the classic resize method.

+ *

Elastic resize operations have the following restrictions:

+ *
    + *
  • + *

    You can only resize clusters of the following types:

    + *
      + *
    • + *

      dc1.large (if your cluster is in a VPC)

      + *
    • + *
    • + *

      dc1.8xlarge (if your cluster is in a VPC)

      + *
    • + *
    • + *

      dc2.large

      + *
    • + *
    • + *

      dc2.8xlarge

      + *
    • + *
    • + *

      ds2.xlarge

      + *
    • + *
    • + *

      ds2.8xlarge

      + *
    • + *
    • + *

      ra3.4xlarge

      + *
    • + *
    • + *

      ra3.16xlarge

      + *
    • + *
    + *
  • + *
  • + *

    The type of nodes that you add must match the node type for the + * cluster.

    + *
  • + *
+ */ export class ResizeClusterCommand extends $Command< ResizeClusterCommandInput, ResizeClusterCommandOutput, @@ -35,6 +77,9 @@ export class ResizeClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/RestoreFromClusterSnapshotCommand.ts b/clients/client-redshift/commands/RestoreFromClusterSnapshotCommand.ts index 4b59a08ff0b4c..886fdedfc7455 100644 --- a/clients/client-redshift/commands/RestoreFromClusterSnapshotCommand.ts +++ b/clients/client-redshift/commands/RestoreFromClusterSnapshotCommand.ts @@ -20,6 +20,20 @@ import { export type RestoreFromClusterSnapshotCommandInput = RestoreFromClusterSnapshotMessage; export type RestoreFromClusterSnapshotCommandOutput = RestoreFromClusterSnapshotResult & __MetadataBearer; +/** + *

Creates a new cluster from a snapshot. By default, Amazon Redshift creates the resulting + * cluster with the same configuration as the original cluster from which the snapshot was + * created, except that the new cluster is created with the default cluster security and + * parameter groups. After Amazon Redshift creates the cluster, you can use the ModifyCluster API to associate a different security group and different + * parameter group with the restored cluster. If you are using a DS node type, you can also + * choose to change to another DS node type of the same size during restore.

+ *

If you restore a cluster into a VPC, you must provide a cluster subnet group where + * you want the cluster restored.

+ *

+ * For more information about working with snapshots, go to + * Amazon Redshift Snapshots + * in the Amazon Redshift Cluster Management Guide.

+ */ export class RestoreFromClusterSnapshotCommand extends $Command< RestoreFromClusterSnapshotCommandInput, RestoreFromClusterSnapshotCommandOutput, @@ -34,6 +48,9 @@ export class RestoreFromClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/RestoreTableFromClusterSnapshotCommand.ts b/clients/client-redshift/commands/RestoreTableFromClusterSnapshotCommand.ts index d79dac5b12c3b..1562afc83ebe5 100644 --- a/clients/client-redshift/commands/RestoreTableFromClusterSnapshotCommand.ts +++ b/clients/client-redshift/commands/RestoreTableFromClusterSnapshotCommand.ts @@ -20,6 +20,20 @@ import { export type RestoreTableFromClusterSnapshotCommandInput = RestoreTableFromClusterSnapshotMessage; export type RestoreTableFromClusterSnapshotCommandOutput = RestoreTableFromClusterSnapshotResult & __MetadataBearer; +/** + *

Creates a new table from a table in an Amazon Redshift cluster snapshot. You must + * create the new table within the Amazon Redshift cluster that the snapshot was taken + * from.

+ *

You cannot use RestoreTableFromClusterSnapshot to restore a table with + * the same name as an existing table in an Amazon Redshift cluster. That is, you cannot + * overwrite an existing table in a cluster with a restored table. If you want to replace + * your original table with a new, restored table, then rename or drop your original table + * before you call RestoreTableFromClusterSnapshot. When you have renamed your + * original table, then you can pass the original name of the table as the + * NewTableName parameter value in the call to + * RestoreTableFromClusterSnapshot. This way, you can replace the original + * table with the table created from the snapshot.

+ */ export class RestoreTableFromClusterSnapshotCommand extends $Command< RestoreTableFromClusterSnapshotCommandInput, RestoreTableFromClusterSnapshotCommandOutput, @@ -34,6 +48,9 @@ export class RestoreTableFromClusterSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/ResumeClusterCommand.ts b/clients/client-redshift/commands/ResumeClusterCommand.ts index ec5656903bde7..06b1989eb2dd2 100644 --- a/clients/client-redshift/commands/ResumeClusterCommand.ts +++ b/clients/client-redshift/commands/ResumeClusterCommand.ts @@ -21,6 +21,9 @@ import { export type ResumeClusterCommandInput = ResumeClusterMessage; export type ResumeClusterCommandOutput = ResumeClusterResult & __MetadataBearer; +/** + *

Resumes a paused cluster.

+ */ export class ResumeClusterCommand extends $Command< ResumeClusterCommandInput, ResumeClusterCommandOutput, @@ -35,6 +38,9 @@ export class ResumeClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/RevokeClusterSecurityGroupIngressCommand.ts b/clients/client-redshift/commands/RevokeClusterSecurityGroupIngressCommand.ts index b3f26f072a345..b2c6447fdad53 100644 --- a/clients/client-redshift/commands/RevokeClusterSecurityGroupIngressCommand.ts +++ b/clients/client-redshift/commands/RevokeClusterSecurityGroupIngressCommand.ts @@ -20,6 +20,13 @@ import { export type RevokeClusterSecurityGroupIngressCommandInput = RevokeClusterSecurityGroupIngressMessage; export type RevokeClusterSecurityGroupIngressCommandOutput = RevokeClusterSecurityGroupIngressResult & __MetadataBearer; +/** + *

Revokes an ingress rule in an Amazon Redshift security group for a previously authorized + * IP range or Amazon EC2 security group. To add an ingress rule, see AuthorizeClusterSecurityGroupIngress. + * For information about managing security groups, go to + * Amazon Redshift Cluster Security Groups in the + * Amazon Redshift Cluster Management Guide.

+ */ export class RevokeClusterSecurityGroupIngressCommand extends $Command< RevokeClusterSecurityGroupIngressCommandInput, RevokeClusterSecurityGroupIngressCommandOutput, @@ -34,6 +41,9 @@ export class RevokeClusterSecurityGroupIngressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/RevokeSnapshotAccessCommand.ts b/clients/client-redshift/commands/RevokeSnapshotAccessCommand.ts index f561fd1f0c1b1..da4c5620e295c 100644 --- a/clients/client-redshift/commands/RevokeSnapshotAccessCommand.ts +++ b/clients/client-redshift/commands/RevokeSnapshotAccessCommand.ts @@ -20,6 +20,15 @@ import { export type RevokeSnapshotAccessCommandInput = RevokeSnapshotAccessMessage; export type RevokeSnapshotAccessCommandOutput = RevokeSnapshotAccessResult & __MetadataBearer; +/** + *

Removes the ability of the specified AWS customer account to restore the specified + * snapshot. If the account is currently restoring the snapshot, the restore will run to + * completion.

+ *

+ * For more information about working with snapshots, go to + * Amazon Redshift Snapshots + * in the Amazon Redshift Cluster Management Guide.

+ */ export class RevokeSnapshotAccessCommand extends $Command< RevokeSnapshotAccessCommandInput, RevokeSnapshotAccessCommandOutput, @@ -34,6 +43,9 @@ export class RevokeSnapshotAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/commands/RotateEncryptionKeyCommand.ts b/clients/client-redshift/commands/RotateEncryptionKeyCommand.ts index d424004ae32fe..f60daba71c477 100644 --- a/clients/client-redshift/commands/RotateEncryptionKeyCommand.ts +++ b/clients/client-redshift/commands/RotateEncryptionKeyCommand.ts @@ -20,6 +20,9 @@ import { export type RotateEncryptionKeyCommandInput = RotateEncryptionKeyMessage; export type RotateEncryptionKeyCommandOutput = RotateEncryptionKeyResult & __MetadataBearer; +/** + *

Rotates the encryption keys for a cluster.

+ */ export class RotateEncryptionKeyCommand extends $Command< RotateEncryptionKeyCommandInput, RotateEncryptionKeyCommandOutput, @@ -34,6 +37,9 @@ export class RotateEncryptionKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RedshiftClientResolvedConfig, diff --git a/clients/client-redshift/package.json b/clients/client-redshift/package.json index 024edda5c92a6..c0a678bc9c2ef 100644 --- a/clients/client-redshift/package.json +++ b/clients/client-redshift/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Redshift Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-redshift/pagination/DescribeClusterParameterGroupsPaginator.ts b/clients/client-redshift/pagination/DescribeClusterParameterGroupsPaginator.ts index 280091f655179..b11e80e08ec89 100644 --- a/clients/client-redshift/pagination/DescribeClusterParameterGroupsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeClusterParameterGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeClusterParameterGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClusterParameterGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeClusterParameterGroupsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeClusterParametersPaginator.ts b/clients/client-redshift/pagination/DescribeClusterParametersPaginator.ts index 87b74b2bc71e4..b70fc294a84ba 100644 --- a/clients/client-redshift/pagination/DescribeClusterParametersPaginator.ts +++ b/clients/client-redshift/pagination/DescribeClusterParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeClusterParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClusterParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeClusterParametersCommandInput, diff --git a/clients/client-redshift/pagination/DescribeClusterSecurityGroupsPaginator.ts b/clients/client-redshift/pagination/DescribeClusterSecurityGroupsPaginator.ts index 44a9942613f2e..4016c8d63efdf 100644 --- a/clients/client-redshift/pagination/DescribeClusterSecurityGroupsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeClusterSecurityGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeClusterSecurityGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClusterSecurityGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeClusterSecurityGroupsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeClusterSnapshotsPaginator.ts b/clients/client-redshift/pagination/DescribeClusterSnapshotsPaginator.ts index 499369c437d08..82183aa976be3 100644 --- a/clients/client-redshift/pagination/DescribeClusterSnapshotsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeClusterSnapshotsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeClusterSnapshotsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClusterSnapshotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeClusterSnapshotsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeClusterSubnetGroupsPaginator.ts b/clients/client-redshift/pagination/DescribeClusterSubnetGroupsPaginator.ts index b1f327f4fde2e..24e85d8040412 100644 --- a/clients/client-redshift/pagination/DescribeClusterSubnetGroupsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeClusterSubnetGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeClusterSubnetGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClusterSubnetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeClusterSubnetGroupsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeClusterVersionsPaginator.ts b/clients/client-redshift/pagination/DescribeClusterVersionsPaginator.ts index 4c05d20a4060e..c707d156e7190 100644 --- a/clients/client-redshift/pagination/DescribeClusterVersionsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeClusterVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeClusterVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClusterVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeClusterVersionsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeClustersPaginator.ts b/clients/client-redshift/pagination/DescribeClustersPaginator.ts index 25604300cf31b..2a77e3318b665 100644 --- a/clients/client-redshift/pagination/DescribeClustersPaginator.ts +++ b/clients/client-redshift/pagination/DescribeClustersPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeClustersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeClustersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeClustersCommandInput, diff --git a/clients/client-redshift/pagination/DescribeDefaultClusterParametersPaginator.ts b/clients/client-redshift/pagination/DescribeDefaultClusterParametersPaginator.ts index 8042953c0409a..3374680538c9e 100644 --- a/clients/client-redshift/pagination/DescribeDefaultClusterParametersPaginator.ts +++ b/clients/client-redshift/pagination/DescribeDefaultClusterParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeDefaultClusterParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDefaultClusterParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeDefaultClusterParametersCommandInput, diff --git a/clients/client-redshift/pagination/DescribeEventSubscriptionsPaginator.ts b/clients/client-redshift/pagination/DescribeEventSubscriptionsPaginator.ts index a6538d2bcece4..b0438f3d2bf27 100644 --- a/clients/client-redshift/pagination/DescribeEventSubscriptionsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeEventSubscriptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeEventSubscriptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventSubscriptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeEventSubscriptionsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeEventsPaginator.ts b/clients/client-redshift/pagination/DescribeEventsPaginator.ts index 61368238764dc..40c4ad498e310 100644 --- a/clients/client-redshift/pagination/DescribeEventsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeEventsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeHsmClientCertificatesPaginator.ts b/clients/client-redshift/pagination/DescribeHsmClientCertificatesPaginator.ts index 397b659feb0d1..3082d728c7646 100644 --- a/clients/client-redshift/pagination/DescribeHsmClientCertificatesPaginator.ts +++ b/clients/client-redshift/pagination/DescribeHsmClientCertificatesPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeHsmClientCertificatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeHsmClientCertificatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeHsmClientCertificatesCommandInput, diff --git a/clients/client-redshift/pagination/DescribeHsmConfigurationsPaginator.ts b/clients/client-redshift/pagination/DescribeHsmConfigurationsPaginator.ts index 7e3a15d90a9bc..e65e0e1e827d4 100644 --- a/clients/client-redshift/pagination/DescribeHsmConfigurationsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeHsmConfigurationsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeHsmConfigurationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeHsmConfigurationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeHsmConfigurationsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeNodeConfigurationOptionsPaginator.ts b/clients/client-redshift/pagination/DescribeNodeConfigurationOptionsPaginator.ts index 778b0f6591b85..b526e827a8edb 100644 --- a/clients/client-redshift/pagination/DescribeNodeConfigurationOptionsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeNodeConfigurationOptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeNodeConfigurationOptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeNodeConfigurationOptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeNodeConfigurationOptionsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeOrderableClusterOptionsPaginator.ts b/clients/client-redshift/pagination/DescribeOrderableClusterOptionsPaginator.ts index fddf088dfe7a7..9680ef9c7a8b5 100644 --- a/clients/client-redshift/pagination/DescribeOrderableClusterOptionsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeOrderableClusterOptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeOrderableClusterOptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOrderableClusterOptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeOrderableClusterOptionsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeReservedNodeOfferingsPaginator.ts b/clients/client-redshift/pagination/DescribeReservedNodeOfferingsPaginator.ts index 1b6985a66e79d..20c187bd63d2a 100644 --- a/clients/client-redshift/pagination/DescribeReservedNodeOfferingsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeReservedNodeOfferingsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeReservedNodeOfferingsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedNodeOfferingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeReservedNodeOfferingsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeReservedNodesPaginator.ts b/clients/client-redshift/pagination/DescribeReservedNodesPaginator.ts index fb4bbf955d9e4..b77da7d730419 100644 --- a/clients/client-redshift/pagination/DescribeReservedNodesPaginator.ts +++ b/clients/client-redshift/pagination/DescribeReservedNodesPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeReservedNodesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeReservedNodesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeReservedNodesCommandInput, diff --git a/clients/client-redshift/pagination/DescribeScheduledActionsPaginator.ts b/clients/client-redshift/pagination/DescribeScheduledActionsPaginator.ts index 332acbc3adba1..3b22a9df6c538 100644 --- a/clients/client-redshift/pagination/DescribeScheduledActionsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeScheduledActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeScheduledActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeScheduledActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeScheduledActionsCommandInput, diff --git a/clients/client-redshift/pagination/DescribeUsageLimitsPaginator.ts b/clients/client-redshift/pagination/DescribeUsageLimitsPaginator.ts index f72f63b867f8a..8882c44a58831 100644 --- a/clients/client-redshift/pagination/DescribeUsageLimitsPaginator.ts +++ b/clients/client-redshift/pagination/DescribeUsageLimitsPaginator.ts @@ -8,6 +8,9 @@ import { import { RedshiftPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RedshiftClient, input: DescribeUsageLimitsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeUsageLimitsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Redshift, input: DescribeUsageLimitsCommandInput, diff --git a/clients/client-redshift/runtimeConfig.browser.ts b/clients/client-redshift/runtimeConfig.browser.ts index ee81ad30657be..e70b6fb000a10 100644 --- a/clients/client-redshift/runtimeConfig.browser.ts +++ b/clients/client-redshift/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RedshiftClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-redshift/runtimeConfig.native.ts b/clients/client-redshift/runtimeConfig.native.ts index 6883010b71bc3..3e750a39c9faa 100644 --- a/clients/client-redshift/runtimeConfig.native.ts +++ b/clients/client-redshift/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RedshiftClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-redshift/runtimeConfig.shared.ts b/clients/client-redshift/runtimeConfig.shared.ts index 21c50ad0c5d0a..96291a05806e8 100644 --- a/clients/client-redshift/runtimeConfig.shared.ts +++ b/clients/client-redshift/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-12-01", disableHostPrefix: false, diff --git a/clients/client-redshift/runtimeConfig.ts b/clients/client-redshift/runtimeConfig.ts index 07c4fba886b73..39398cc997b6d 100644 --- a/clients/client-redshift/runtimeConfig.ts +++ b/clients/client-redshift/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RedshiftClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-redshift/tsconfig.json b/clients/client-redshift/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-redshift/tsconfig.json +++ b/clients/client-redshift/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-rekognition/commands/CompareFacesCommand.ts b/clients/client-rekognition/commands/CompareFacesCommand.ts index 4b4847952f9f5..71f286fd8918d 100644 --- a/clients/client-rekognition/commands/CompareFacesCommand.ts +++ b/clients/client-rekognition/commands/CompareFacesCommand.ts @@ -20,6 +20,60 @@ import { export type CompareFacesCommandInput = CompareFacesRequest; export type CompareFacesCommandOutput = CompareFacesResponse & __MetadataBearer; +/** + *

Compares a face in the source input image with + * each of the 100 largest faces detected in the target input image. + *

+ * + *

If the source image contains multiple faces, the service detects the largest face + * and compares it with each face detected in the target image.

+ *
+ * + * + *

You pass the input and target images either as base64-encoded image bytes or as + * references to images in an Amazon S3 bucket. If you use the + * AWS + * CLI to call Amazon Rekognition operations, passing image bytes isn't + * supported. The image must be formatted as a PNG or JPEG file.

+ *

In response, the operation returns an array of face matches ordered by similarity score + * in descending order. For each face match, the response provides a bounding box of the face, + * facial landmarks, pose details (pitch, role, and yaw), quality (brightness and sharpness), and + * confidence value (indicating the level of confidence that the bounding box contains a face). + * The response also provides a similarity score, which indicates how closely the faces match.

+ * + * + *

By default, only faces with a similarity score of greater than or equal to 80% are + * returned in the response. You can change this value by specifying the + * SimilarityThreshold parameter.

+ *
+ * + *

+ * CompareFaces also returns an array of faces that don't match the source image. + * For each face, it returns a bounding box, confidence value, landmarks, pose details, and quality. + * The response also returns information about the face in the source image, including the bounding box + * of the face and confidence value.

+ * + *

The QualityFilter input parameter allows you to filter out detected faces + * that don’t meet a required quality bar. The quality bar is based on a + * variety of common use cases. Use QualityFilter to set the quality bar + * by specifying LOW, MEDIUM, or HIGH. + * If you do not want to filter detected faces, specify NONE. The default value is NONE.

+ * + *

If the image doesn't contain Exif metadata, CompareFaces returns orientation information for the + * source and target images. Use these values to display the images with the correct image orientation.

+ *

If no faces are detected in the source or target images, CompareFaces returns an + * InvalidParameterException error.

+ * + * + * + *

This is a stateless API operation. That is, data returned by this operation doesn't persist.

+ *
+ * + * + *

For an example, see Comparing Faces in Images in the Amazon Rekognition Developer Guide.

+ *

This operation requires permissions to perform the rekognition:CompareFaces + * action.

+ */ export class CompareFacesCommand extends $Command< CompareFacesCommandInput, CompareFacesCommandOutput, @@ -34,6 +88,9 @@ export class CompareFacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/CreateCollectionCommand.ts b/clients/client-rekognition/commands/CreateCollectionCommand.ts index 4d7e3170b0dfc..d4cfdb274fa37 100644 --- a/clients/client-rekognition/commands/CreateCollectionCommand.ts +++ b/clients/client-rekognition/commands/CreateCollectionCommand.ts @@ -20,6 +20,21 @@ import { export type CreateCollectionCommandInput = CreateCollectionRequest; export type CreateCollectionCommandOutput = CreateCollectionResponse & __MetadataBearer; +/** + *

Creates a collection in an AWS Region. You can add faces to the collection using the + * IndexFaces operation.

+ *

For example, you might create collections, one for each of your application users. A + * user can then index faces using the IndexFaces operation and persist results in a + * specific collection. Then, a user can search the collection for faces in the user-specific + * container.

+ *

When you create a collection, it is associated with the latest version of the face model version.

+ * + *

Collection names are case-sensitive.

+ *
+ * + *

This operation requires permissions to perform the + * rekognition:CreateCollection action.

+ */ export class CreateCollectionCommand extends $Command< CreateCollectionCommandInput, CreateCollectionCommandOutput, @@ -34,6 +49,9 @@ export class CreateCollectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/CreateProjectCommand.ts b/clients/client-rekognition/commands/CreateProjectCommand.ts index d6258e8ce4b50..abf13ef3974f4 100644 --- a/clients/client-rekognition/commands/CreateProjectCommand.ts +++ b/clients/client-rekognition/commands/CreateProjectCommand.ts @@ -20,6 +20,11 @@ import { export type CreateProjectCommandInput = CreateProjectRequest; export type CreateProjectCommandOutput = CreateProjectResponse & __MetadataBearer; +/** + *

Creates a new Amazon Rekognition Custom Labels project. A project is a logical grouping of resources (images, Labels, models) + * and operations (training, evaluation and detection).

+ *

This operation requires permissions to perform the rekognition:CreateProject action.

+ */ export class CreateProjectCommand extends $Command< CreateProjectCommandInput, CreateProjectCommandOutput, @@ -34,6 +39,9 @@ export class CreateProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/CreateProjectVersionCommand.ts b/clients/client-rekognition/commands/CreateProjectVersionCommand.ts index add9aff708e85..8c52c72af0d70 100644 --- a/clients/client-rekognition/commands/CreateProjectVersionCommand.ts +++ b/clients/client-rekognition/commands/CreateProjectVersionCommand.ts @@ -20,6 +20,20 @@ import { export type CreateProjectVersionCommandInput = CreateProjectVersionRequest; export type CreateProjectVersionCommandOutput = CreateProjectVersionResponse & __MetadataBearer; +/** + *

Creates a new version of a model and begins training. + * Models are managed as part of an Amazon Rekognition Custom Labels project. You can specify + * one training dataset and one testing dataset. The response from CreateProjectVersion + * is an Amazon Resource Name (ARN) for the version of the model.

+ *

Training takes a while to complete. You can get the current status by calling + * DescribeProjectVersions.

+ *

Once training has successfully completed, call DescribeProjectVersions to + * get the training results and evaluate the model. + *

+ *

After evaluating the model, you start the model + * by calling StartProjectVersion.

+ *

This operation requires permissions to perform the rekognition:CreateProjectVersion action.

+ */ export class CreateProjectVersionCommand extends $Command< CreateProjectVersionCommandInput, CreateProjectVersionCommandOutput, @@ -34,6 +48,9 @@ export class CreateProjectVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/CreateStreamProcessorCommand.ts b/clients/client-rekognition/commands/CreateStreamProcessorCommand.ts index 1001abdd18ede..f69f691cad057 100644 --- a/clients/client-rekognition/commands/CreateStreamProcessorCommand.ts +++ b/clients/client-rekognition/commands/CreateStreamProcessorCommand.ts @@ -20,6 +20,17 @@ import { export type CreateStreamProcessorCommandInput = CreateStreamProcessorRequest; export type CreateStreamProcessorCommandOutput = CreateStreamProcessorResponse & __MetadataBearer; +/** + *

Creates an Amazon Rekognition stream processor that you can use to detect and recognize faces in a streaming video.

+ *

Amazon Rekognition Video is a consumer of live video from Amazon Kinesis Video Streams. Amazon Rekognition Video sends analysis results to Amazon Kinesis Data Streams.

+ *

You provide as input a Kinesis video stream (Input) and a Kinesis data stream (Output) stream. You also specify the + * face recognition criteria in Settings. For example, the collection containing faces that you want to recognize. + * Use Name to assign an identifier for the stream processor. You use Name + * to manage the stream processor. For example, you can start processing the source video by calling StartStreamProcessor with + * the Name field.

+ *

After you have finished analyzing a streaming video, use StopStreamProcessor to + * stop processing. You can delete the stream processor by calling DeleteStreamProcessor.

+ */ export class CreateStreamProcessorCommand extends $Command< CreateStreamProcessorCommandInput, CreateStreamProcessorCommandOutput, @@ -34,6 +45,9 @@ export class CreateStreamProcessorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DeleteCollectionCommand.ts b/clients/client-rekognition/commands/DeleteCollectionCommand.ts index bc80988e2e243..35e4f7c95f215 100644 --- a/clients/client-rekognition/commands/DeleteCollectionCommand.ts +++ b/clients/client-rekognition/commands/DeleteCollectionCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteCollectionCommandInput = DeleteCollectionRequest; export type DeleteCollectionCommandOutput = DeleteCollectionResponse & __MetadataBearer; +/** + *

Deletes the specified collection. Note that this operation + * removes all faces in the collection. For an example, see delete-collection-procedure.

+ * + *

This operation requires permissions to perform the + * rekognition:DeleteCollection action.

+ */ export class DeleteCollectionCommand extends $Command< DeleteCollectionCommandInput, DeleteCollectionCommandOutput, @@ -34,6 +41,9 @@ export class DeleteCollectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DeleteFacesCommand.ts b/clients/client-rekognition/commands/DeleteFacesCommand.ts index 8f983ce37873f..2ba123c1d202e 100644 --- a/clients/client-rekognition/commands/DeleteFacesCommand.ts +++ b/clients/client-rekognition/commands/DeleteFacesCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteFacesCommandInput = DeleteFacesRequest; export type DeleteFacesCommandOutput = DeleteFacesResponse & __MetadataBearer; +/** + *

Deletes faces from a collection. You specify a collection ID and an array of face IDs + * to remove from the collection.

+ *

This operation requires permissions to perform the rekognition:DeleteFaces + * action.

+ */ export class DeleteFacesCommand extends $Command< DeleteFacesCommandInput, DeleteFacesCommandOutput, @@ -34,6 +40,9 @@ export class DeleteFacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DeleteProjectCommand.ts b/clients/client-rekognition/commands/DeleteProjectCommand.ts index 7b7346a553ac0..4a40c1867e6d7 100644 --- a/clients/client-rekognition/commands/DeleteProjectCommand.ts +++ b/clients/client-rekognition/commands/DeleteProjectCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteProjectCommandInput = DeleteProjectRequest; export type DeleteProjectCommandOutput = DeleteProjectResponse & __MetadataBearer; +/** + *

Deletes an Amazon Rekognition Custom Labels project. To delete a project you must first delete all models associated + * with the project. To delete a model, see DeleteProjectVersion.

+ *

This operation requires permissions to perform the + * rekognition:DeleteProject action.

+ */ export class DeleteProjectCommand extends $Command< DeleteProjectCommandInput, DeleteProjectCommandOutput, @@ -34,6 +40,9 @@ export class DeleteProjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DeleteProjectVersionCommand.ts b/clients/client-rekognition/commands/DeleteProjectVersionCommand.ts index 921c6f5ec7ff6..60be0cef913ab 100644 --- a/clients/client-rekognition/commands/DeleteProjectVersionCommand.ts +++ b/clients/client-rekognition/commands/DeleteProjectVersionCommand.ts @@ -20,6 +20,16 @@ import { export type DeleteProjectVersionCommandInput = DeleteProjectVersionRequest; export type DeleteProjectVersionCommandOutput = DeleteProjectVersionResponse & __MetadataBearer; +/** + *

Deletes an Amazon Rekognition Custom Labels model.

+ *

You can't delete a model if it is running or if it is training. + * To check the status of a model, use the Status field returned + * from DescribeProjectVersions. + * To stop a running model call StopProjectVersion. If the model + * is training, wait until it finishes.

+ *

This operation requires permissions to perform the + * rekognition:DeleteProjectVersion action.

+ */ export class DeleteProjectVersionCommand extends $Command< DeleteProjectVersionCommandInput, DeleteProjectVersionCommandOutput, @@ -34,6 +44,9 @@ export class DeleteProjectVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DeleteStreamProcessorCommand.ts b/clients/client-rekognition/commands/DeleteStreamProcessorCommand.ts index cc5478672e3db..c5909cb24d38f 100644 --- a/clients/client-rekognition/commands/DeleteStreamProcessorCommand.ts +++ b/clients/client-rekognition/commands/DeleteStreamProcessorCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteStreamProcessorCommandInput = DeleteStreamProcessorRequest; export type DeleteStreamProcessorCommandOutput = DeleteStreamProcessorResponse & __MetadataBearer; +/** + *

Deletes the stream processor identified by Name. You assign the value for Name when you create the stream processor with + * CreateStreamProcessor. You might not be able to use the same name for a stream processor for a few seconds after calling DeleteStreamProcessor.

+ */ export class DeleteStreamProcessorCommand extends $Command< DeleteStreamProcessorCommandInput, DeleteStreamProcessorCommandOutput, @@ -34,6 +38,9 @@ export class DeleteStreamProcessorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DescribeCollectionCommand.ts b/clients/client-rekognition/commands/DescribeCollectionCommand.ts index d11025fa91950..8130dbd02381c 100644 --- a/clients/client-rekognition/commands/DescribeCollectionCommand.ts +++ b/clients/client-rekognition/commands/DescribeCollectionCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeCollectionCommandInput = DescribeCollectionRequest; export type DescribeCollectionCommandOutput = DescribeCollectionResponse & __MetadataBearer; +/** + *

Describes the specified collection. You can use DescribeCollection to get + * information, such as the number of faces indexed into a collection and the version of the + * model used by the collection for face detection.

+ * + *

For more information, see Describing a Collection in the + * Amazon Rekognition Developer Guide.

+ */ export class DescribeCollectionCommand extends $Command< DescribeCollectionCommandInput, DescribeCollectionCommandOutput, @@ -34,6 +42,9 @@ export class DescribeCollectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DescribeProjectVersionsCommand.ts b/clients/client-rekognition/commands/DescribeProjectVersionsCommand.ts index 074a0996c6606..81da8446bb723 100644 --- a/clients/client-rekognition/commands/DescribeProjectVersionsCommand.ts +++ b/clients/client-rekognition/commands/DescribeProjectVersionsCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeProjectVersionsCommandInput = DescribeProjectVersionsRequest; export type DescribeProjectVersionsCommandOutput = DescribeProjectVersionsResponse & __MetadataBearer; +/** + *

Lists and describes the models in an Amazon Rekognition Custom Labels project. You + * can specify up to 10 model versions in ProjectVersionArns. If + * you don't specify a value, descriptions for all models are returned.

+ *

This operation requires permissions to perform the rekognition:DescribeProjectVersions + * action.

+ */ export class DescribeProjectVersionsCommand extends $Command< DescribeProjectVersionsCommandInput, DescribeProjectVersionsCommandOutput, @@ -34,6 +41,9 @@ export class DescribeProjectVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DescribeProjectsCommand.ts b/clients/client-rekognition/commands/DescribeProjectsCommand.ts index f2b2e5943d564..fef2455557163 100644 --- a/clients/client-rekognition/commands/DescribeProjectsCommand.ts +++ b/clients/client-rekognition/commands/DescribeProjectsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeProjectsCommandInput = DescribeProjectsRequest; export type DescribeProjectsCommandOutput = DescribeProjectsResponse & __MetadataBearer; +/** + *

Lists and gets information about your Amazon Rekognition Custom Labels projects.

+ *

This operation requires permissions to perform the rekognition:DescribeProjects action.

+ */ export class DescribeProjectsCommand extends $Command< DescribeProjectsCommandInput, DescribeProjectsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeProjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DescribeStreamProcessorCommand.ts b/clients/client-rekognition/commands/DescribeStreamProcessorCommand.ts index 4106aae1e8ec6..c8d37e773a936 100644 --- a/clients/client-rekognition/commands/DescribeStreamProcessorCommand.ts +++ b/clients/client-rekognition/commands/DescribeStreamProcessorCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeStreamProcessorCommandInput = DescribeStreamProcessorRequest; export type DescribeStreamProcessorCommandOutput = DescribeStreamProcessorResponse & __MetadataBearer; +/** + *

Provides information about a stream processor created by CreateStreamProcessor. You can get information about the input and output streams, the input parameters for the face recognition being performed, + * and the current status of the stream processor.

+ */ export class DescribeStreamProcessorCommand extends $Command< DescribeStreamProcessorCommandInput, DescribeStreamProcessorCommandOutput, @@ -34,6 +38,9 @@ export class DescribeStreamProcessorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DetectCustomLabelsCommand.ts b/clients/client-rekognition/commands/DetectCustomLabelsCommand.ts index a554d9de8969d..8b5cf2dc55db0 100644 --- a/clients/client-rekognition/commands/DetectCustomLabelsCommand.ts +++ b/clients/client-rekognition/commands/DetectCustomLabelsCommand.ts @@ -20,6 +20,34 @@ import { export type DetectCustomLabelsCommandInput = DetectCustomLabelsRequest; export type DetectCustomLabelsCommandOutput = DetectCustomLabelsResponse & __MetadataBearer; +/** + *

Detects custom labels in a supplied image by using an Amazon Rekognition Custom Labels model.

+ *

You specify which version of a model version to use by using the ProjectVersionArn input + * parameter.

+ *

You pass the input image as base64-encoded image bytes or as a reference to an image in + * an Amazon S3 bucket. If you use the AWS CLI to call Amazon Rekognition operations, passing + * image bytes is not supported. The image must be either a PNG or JPEG formatted file.

+ *

For each object that the model version detects on an image, the API returns a + * (CustomLabel) object in an array (CustomLabels). + * Each CustomLabel object provides the label name (Name), the level + * of confidence that the image contains the object (Confidence), and + * object location information, if it exists, for the label on the image (Geometry).

+ *

During training model calculates a threshold value that determines + * if a prediction for a label is true. By default, DetectCustomLabels doesn't + * return labels whose confidence value is below the model's calculated threshold value. To filter + * labels that are returned, specify a value for MinConfidence that is higher than the + * model's calculated threshold. You can get the model's calculated threshold from the model's + * training results shown in the Amazon Rekognition Custom Labels console. + * To get all labels, regardless of confidence, specify a MinConfidence + * value of 0.

+ *

You can also add the MaxResults parameter + * to limit the number of labels returned.

+ * + *

This is a stateless API operation. That is, the operation does not persist any + * data.

+ *

This operation requires permissions to perform the + * rekognition:DetectCustomLabels action.

+ */ export class DetectCustomLabelsCommand extends $Command< DetectCustomLabelsCommandInput, DetectCustomLabelsCommandOutput, @@ -34,6 +62,9 @@ export class DetectCustomLabelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DetectFacesCommand.ts b/clients/client-rekognition/commands/DetectFacesCommand.ts index a6521ec5f9c23..504db0ffd7957 100644 --- a/clients/client-rekognition/commands/DetectFacesCommand.ts +++ b/clients/client-rekognition/commands/DetectFacesCommand.ts @@ -20,6 +20,31 @@ import { export type DetectFacesCommandInput = DetectFacesRequest; export type DetectFacesCommandOutput = DetectFacesResponse & __MetadataBearer; +/** + *

Detects faces within an image that is provided as input.

+ * + *

+ * DetectFaces detects the 100 largest faces in the image. For each face + * detected, the operation returns face details. These details include a bounding box of the + * face, a confidence value (that the bounding box contains a face), and a fixed set of + * attributes such as facial landmarks (for example, coordinates of eye and mouth), + * presence of beard, sunglasses, and so on.

+ *

The face-detection algorithm is most effective on frontal faces. For non-frontal or + * obscured faces, the algorithm might not detect the faces or might detect faces with lower + * confidence.

+ *

You pass the input image either as base64-encoded image bytes or as a reference to an + * image in an Amazon S3 bucket. If you use the AWS CLI + * to call Amazon Rekognition operations, passing image bytes is not + * supported. The image must be either a PNG or JPEG formatted file.

+ * + * + *

This is a stateless API operation. That is, the operation does not persist any + * data.

+ *
+ * + *

This operation requires permissions to perform the + * rekognition:DetectFaces action.

+ */ export class DetectFacesCommand extends $Command< DetectFacesCommandInput, DetectFacesCommandOutput, @@ -34,6 +59,9 @@ export class DetectFacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DetectLabelsCommand.ts b/clients/client-rekognition/commands/DetectLabelsCommand.ts index 3e6f799c086b2..4fea85fa603d4 100644 --- a/clients/client-rekognition/commands/DetectLabelsCommand.ts +++ b/clients/client-rekognition/commands/DetectLabelsCommand.ts @@ -20,6 +20,82 @@ import { export type DetectLabelsCommandInput = DetectLabelsRequest; export type DetectLabelsCommandOutput = DetectLabelsResponse & __MetadataBearer; +/** + *

Detects instances of real-world entities within an image (JPEG or PNG) + * provided as input. This includes objects like flower, tree, and table; events like + * wedding, graduation, and birthday party; and concepts like landscape, evening, and nature. + *

+ * + *

For an example, see Analyzing Images Stored in an Amazon S3 Bucket in the Amazon Rekognition Developer Guide.

+ * + * + *

+ * DetectLabels does not support the detection of activities. However, activity detection + * is supported for label detection in videos. For more information, see StartLabelDetection in the Amazon Rekognition Developer Guide.

+ *
+ * + *

You pass the input image as base64-encoded image bytes or as a reference to an image in + * an Amazon S3 bucket. If you use the + * AWS + * CLI to call Amazon Rekognition operations, passing image bytes is not + * supported. The image must be either a PNG or JPEG formatted file.

+ *

For each object, scene, and concept the API returns one or more labels. Each label + * provides the object name, and the level of confidence that the image contains the object. For + * example, suppose the input image has a lighthouse, the sea, and a rock. The response includes + * all three labels, one for each object.

+ * + *

+ * {Name: lighthouse, Confidence: 98.4629} + *

+ *

+ * {Name: rock,Confidence: 79.2097} + *

+ *

+ * {Name: sea,Confidence: 75.061} + *

+ *

In the preceding example, the operation returns one label for each of the three + * objects. The operation can also return multiple labels for the same object in the image. For + * example, if the input image shows a flower (for example, a tulip), the operation might return + * the following three labels.

+ *

+ * {Name: flower,Confidence: 99.0562} + *

+ *

+ * {Name: plant,Confidence: 99.0562} + *

+ *

+ * {Name: tulip,Confidence: 99.0562} + *

+ * + *

In this example, the detection algorithm more precisely identifies the flower as a + * tulip.

+ *

In response, the API returns an array of labels. In addition, the response also + * includes the orientation correction. Optionally, you can specify MinConfidence to + * control the confidence threshold for the labels returned. The default is 55%. You can also add + * the MaxLabels parameter to limit the number of labels returned.

+ * + *

If the object detected is a person, the operation doesn't provide the same facial + * details that the DetectFaces operation provides.

+ *
+ *

+ * DetectLabels returns bounding boxes for instances of common object labels in an array of + * Instance objects. An Instance object contains a + * BoundingBox object, for the location of the label on the image. It also includes + * the confidence by which the bounding box was detected.

+ *

+ * DetectLabels also returns a hierarchical taxonomy of detected labels. For example, + * a detected car might be assigned the label car. The label car + * has two parent labels: Vehicle (its parent) and Transportation (its + * grandparent). + * The response returns the entire list of ancestors for a label. Each ancestor is a unique label in the response. + * In the previous example, Car, Vehicle, and Transportation + * are returned as unique labels in the response. + *

+ *

This is a stateless API operation. That is, the operation does not persist any + * data.

+ *

This operation requires permissions to perform the + * rekognition:DetectLabels action.

+ */ export class DetectLabelsCommand extends $Command< DetectLabelsCommandInput, DetectLabelsCommandOutput, @@ -34,6 +110,9 @@ export class DetectLabelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DetectModerationLabelsCommand.ts b/clients/client-rekognition/commands/DetectModerationLabelsCommand.ts index 5238d93b864ed..5c44e7a6dd13f 100644 --- a/clients/client-rekognition/commands/DetectModerationLabelsCommand.ts +++ b/clients/client-rekognition/commands/DetectModerationLabelsCommand.ts @@ -20,6 +20,22 @@ import { export type DetectModerationLabelsCommandInput = DetectModerationLabelsRequest; export type DetectModerationLabelsCommandOutput = DetectModerationLabelsResponse & __MetadataBearer; +/** + *

Detects unsafe content in a specified JPEG or PNG format image. + * Use DetectModerationLabels to moderate images depending on your requirements. + * For example, you might want to filter images that contain nudity, but not images containing + * suggestive content.

+ *

To filter images, use the labels returned by DetectModerationLabels + * to determine which types of content are appropriate.

+ * + *

For information about moderation labels, + * see Detecting Unsafe Content in the Amazon Rekognition Developer Guide.

+ *

You pass the input image either as base64-encoded image bytes or as a reference to an + * image in an Amazon S3 bucket. If you use the + * AWS + * CLI to call Amazon Rekognition operations, passing image bytes is not + * supported. The image must be either a PNG or JPEG formatted file.

+ */ export class DetectModerationLabelsCommand extends $Command< DetectModerationLabelsCommandInput, DetectModerationLabelsCommandOutput, @@ -34,6 +50,9 @@ export class DetectModerationLabelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DetectProtectiveEquipmentCommand.ts b/clients/client-rekognition/commands/DetectProtectiveEquipmentCommand.ts index 047d5e647a8ae..5aa9a36433d3d 100644 --- a/clients/client-rekognition/commands/DetectProtectiveEquipmentCommand.ts +++ b/clients/client-rekognition/commands/DetectProtectiveEquipmentCommand.ts @@ -20,6 +20,48 @@ import { export type DetectProtectiveEquipmentCommandInput = DetectProtectiveEquipmentRequest; export type DetectProtectiveEquipmentCommandOutput = DetectProtectiveEquipmentResponse & __MetadataBearer; +/** + *

Detects Personal Protective Equipment (PPE) worn by people detected in an image. Amazon Rekognition can detect the + * following types of PPE.

+ *
    + *
  • + *

    Face cover

    + *
  • + *
  • + *

    Hand cover

    + *
  • + *
  • + *

    Head cover

    + *
  • + *
+ * + *

You pass the input image as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. + * The image must be either a PNG or JPG formatted file.

+ * + *

+ * DetectProtectiveEquipment detects PPE worn by up to 15 persons detected in an image.

+ *

For each person detected in the image the API returns an array of body parts (face, head, left-hand, right-hand). + * For each body part, an array of detected items of PPE is returned, including an indicator of whether or not the PPE + * covers the body part. The API returns the confidence it has in each detection + * (person, PPE, body part and body part coverage). It also returns a bounding box (BoundingBox) for each detected + * person and each detected item of PPE.

+ *

You can optionally request a summary of detected PPE items with the SummarizationAttributes input parameter. + * The summary provides the following information.

+ *
    + *
  • + *

    The persons detected as wearing all of the types of PPE that you specify.

    + *
  • + *
  • + *

    The persons detected as not wearing all of the types PPE that you specify.

    + *
  • + *
  • + *

    The persons detected where PPE adornment could not be determined.

    + *
  • + *
+ *

This is a stateless API operation. That is, the operation does not persist any data.

+ * + *

This operation requires permissions to perform the rekognition:DetectProtectiveEquipment action.

+ */ export class DetectProtectiveEquipmentCommand extends $Command< DetectProtectiveEquipmentCommandInput, DetectProtectiveEquipmentCommandOutput, @@ -34,6 +76,9 @@ export class DetectProtectiveEquipmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/DetectTextCommand.ts b/clients/client-rekognition/commands/DetectTextCommand.ts index 47126699090ff..39982e78b8962 100644 --- a/clients/client-rekognition/commands/DetectTextCommand.ts +++ b/clients/client-rekognition/commands/DetectTextCommand.ts @@ -20,6 +20,30 @@ import { export type DetectTextCommandInput = DetectTextRequest; export type DetectTextCommandOutput = DetectTextResponse & __MetadataBearer; +/** + *

Detects text in the input image and converts it into machine-readable text.

+ *

Pass the input image as base64-encoded image bytes or as a reference to an image in an + * Amazon S3 bucket. If you use the AWS CLI to call Amazon Rekognition operations, you must pass it as a + * reference to an image in an Amazon S3 bucket. For the AWS CLI, passing image bytes is not + * supported. The image must be either a .png or .jpeg formatted file.

+ *

The DetectText operation returns text in an array of TextDetection elements, TextDetections. Each + * TextDetection element provides information about a single word or line of text + * that was detected in the image.

+ *

A word is one or more ISO basic latin script characters that are not separated by spaces. + * DetectText can detect up to 50 words in an image.

+ *

A line is a string of equally spaced words. A line isn't necessarily a complete + * sentence. For example, a driver's license number is detected as a line. A line ends when there + * is no aligned text after it. Also, a line ends when there is a large gap between words, + * relative to the length of the words. This means, depending on the gap between words, Amazon Rekognition + * may detect multiple lines in text aligned in the same direction. Periods don't represent the + * end of a line. If a sentence spans multiple lines, the DetectText operation + * returns multiple lines.

+ *

To determine whether a TextDetection element is a line of text or a word, + * use the TextDetection object Type field.

+ *

To be detected, text must be within +/- 90 degrees orientation of the horizontal axis.

+ * + *

For more information, see DetectText in the Amazon Rekognition Developer Guide.

+ */ export class DetectTextCommand extends $Command< DetectTextCommandInput, DetectTextCommandOutput, @@ -34,6 +58,9 @@ export class DetectTextCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetCelebrityInfoCommand.ts b/clients/client-rekognition/commands/GetCelebrityInfoCommand.ts index ba7d93c9b347d..aecc245874ed9 100644 --- a/clients/client-rekognition/commands/GetCelebrityInfoCommand.ts +++ b/clients/client-rekognition/commands/GetCelebrityInfoCommand.ts @@ -20,6 +20,16 @@ import { export type GetCelebrityInfoCommandInput = GetCelebrityInfoRequest; export type GetCelebrityInfoCommandOutput = GetCelebrityInfoResponse & __MetadataBearer; +/** + *

Gets the name and additional information about a celebrity based on his or her + * Amazon Rekognition ID. The additional information is returned as an array of URLs. If there is no + * additional information about the celebrity, this list is empty.

+ * + *

For more information, see Recognizing Celebrities in an Image in + * the Amazon Rekognition Developer Guide.

+ *

This operation requires permissions to perform the + * rekognition:GetCelebrityInfo action.

+ */ export class GetCelebrityInfoCommand extends $Command< GetCelebrityInfoCommandInput, GetCelebrityInfoCommandOutput, @@ -34,6 +44,9 @@ export class GetCelebrityInfoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetCelebrityRecognitionCommand.ts b/clients/client-rekognition/commands/GetCelebrityRecognitionCommand.ts index 35dfd364a2ed6..a9050e7668b35 100644 --- a/clients/client-rekognition/commands/GetCelebrityRecognitionCommand.ts +++ b/clients/client-rekognition/commands/GetCelebrityRecognitionCommand.ts @@ -20,6 +20,45 @@ import { export type GetCelebrityRecognitionCommandInput = GetCelebrityRecognitionRequest; export type GetCelebrityRecognitionCommandOutput = GetCelebrityRecognitionResponse & __MetadataBearer; +/** + *

Gets the celebrity recognition results for a Amazon Rekognition Video analysis started by + * StartCelebrityRecognition.

+ *

Celebrity recognition in a video is an asynchronous operation. Analysis is started by a call + * to StartCelebrityRecognition which returns a job identifier (JobId). + * When the celebrity recognition operation finishes, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service + * topic registered in the initial call to StartCelebrityRecognition. + * To get the results of the celebrity recognition analysis, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetCelebrityDetection and pass the job identifier + * (JobId) from the initial call to StartCelebrityDetection.

+ * + *

For more information, see Working With Stored Videos in the Amazon Rekognition Developer Guide.

+ *

+ * GetCelebrityRecognition returns detected celebrities and the time(s) they are detected in an array + * (Celebrities) of CelebrityRecognition + * + * objects. Each CelebrityRecognition contains information about the celebrity in a CelebrityDetail + * object and the time, Timestamp, the celebrity was detected. + *

+ * + * + *

+ * GetCelebrityRecognition only returns the default + * facial attributes (BoundingBox, Confidence, + * Landmarks, Pose, and Quality). The other facial attributes listed + * in the Face object of the following response syntax are not returned. For more information, + * see FaceDetail in the Amazon Rekognition Developer Guide.

+ *
+ *

By default, the Celebrities array is sorted by time (milliseconds from the start of the video). + * You can also sort the array by celebrity by specifying the value ID in the SortBy input parameter.

+ *

The CelebrityDetail object includes the celebrity identifer and additional information urls. If you don't store + * the additional information urls, you can get them later by calling GetCelebrityInfo with the celebrity identifer.

+ *

No information is returned for faces not recognized as celebrities.

+ *

Use MaxResults parameter to limit the number of labels returned. If there are more results than + * specified in MaxResults, the value of NextToken in the operation response contains a + * pagination token for getting the next set of results. To get the next page of results, call GetCelebrityDetection + * and populate the NextToken request parameter with the token + * value returned from the previous call to GetCelebrityRecognition.

+ */ export class GetCelebrityRecognitionCommand extends $Command< GetCelebrityRecognitionCommandInput, GetCelebrityRecognitionCommandOutput, @@ -34,6 +73,9 @@ export class GetCelebrityRecognitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetContentModerationCommand.ts b/clients/client-rekognition/commands/GetContentModerationCommand.ts index 7f170860784a3..96fda0b862246 100644 --- a/clients/client-rekognition/commands/GetContentModerationCommand.ts +++ b/clients/client-rekognition/commands/GetContentModerationCommand.ts @@ -20,6 +20,37 @@ import { export type GetContentModerationCommandInput = GetContentModerationRequest; export type GetContentModerationCommandOutput = GetContentModerationResponse & __MetadataBearer; +/** + *

Gets the unsafe content analysis results for a Amazon Rekognition Video analysis started by + * StartContentModeration.

+ * + *

Unsafe content analysis of a video is an asynchronous operation. You start analysis by calling + * StartContentModeration which returns a job identifier (JobId). + * When analysis finishes, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service + * topic registered in the initial call to StartContentModeration. + * To get the results of the unsafe content analysis, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetContentModeration and pass the job identifier + * (JobId) from the initial call to StartContentModeration.

+ * + *

For more information, see Working with Stored Videos in the + * Amazon Rekognition Devlopers Guide.

+ *

+ * GetContentModeration returns detected unsafe content labels, + * and the time they are detected, in an array, ModerationLabels, of + * ContentModerationDetection objects. + *

+ *

By default, the moderated labels are returned sorted by time, in milliseconds from the start of the + * video. You can also sort them by moderated label by specifying NAME for the SortBy + * input parameter.

+ *

Since video analysis can return a large number of results, use the MaxResults parameter to limit + * the number of labels returned in a single call to GetContentModeration. If there are more results than + * specified in MaxResults, the value of NextToken in the operation response contains a + * pagination token for getting the next set of results. To get the next page of results, call GetContentModeration + * and populate the NextToken request parameter with the value of NextToken + * returned from the previous call to GetContentModeration.

+ * + *

For more information, see Detecting Unsafe Content in the Amazon Rekognition Developer Guide.

+ */ export class GetContentModerationCommand extends $Command< GetContentModerationCommandInput, GetContentModerationCommandOutput, @@ -34,6 +65,9 @@ export class GetContentModerationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetFaceDetectionCommand.ts b/clients/client-rekognition/commands/GetFaceDetectionCommand.ts index 3905f401715eb..5a1e9d438f5de 100644 --- a/clients/client-rekognition/commands/GetFaceDetectionCommand.ts +++ b/clients/client-rekognition/commands/GetFaceDetectionCommand.ts @@ -20,6 +20,21 @@ import { export type GetFaceDetectionCommandInput = GetFaceDetectionRequest; export type GetFaceDetectionCommandOutput = GetFaceDetectionResponse & __MetadataBearer; +/** + *

Gets face detection results for a Amazon Rekognition Video analysis started by StartFaceDetection.

+ *

Face detection with Amazon Rekognition Video is an asynchronous operation. You start face detection by calling StartFaceDetection + * which returns a job identifier (JobId). When the face detection operation finishes, Amazon Rekognition Video publishes a completion status to + * the Amazon Simple Notification Service topic registered in the initial call to StartFaceDetection. To get the results + * of the face detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. + * If so, call GetFaceDetection and pass the job identifier + * (JobId) from the initial call to StartFaceDetection.

+ *

+ * GetFaceDetection returns an array of detected faces (Faces) sorted by the time the faces were detected.

+ *

Use MaxResults parameter to limit the number of labels returned. If there are more results than + * specified in MaxResults, the value of NextToken in the operation response contains a pagination token for getting the next set + * of results. To get the next page of results, call GetFaceDetection and populate the NextToken request parameter with the token + * value returned from the previous call to GetFaceDetection.

+ */ export class GetFaceDetectionCommand extends $Command< GetFaceDetectionCommandInput, GetFaceDetectionCommandOutput, @@ -34,6 +49,9 @@ export class GetFaceDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetFaceSearchCommand.ts b/clients/client-rekognition/commands/GetFaceSearchCommand.ts index d90bb026b6cc7..1035d9c17d93d 100644 --- a/clients/client-rekognition/commands/GetFaceSearchCommand.ts +++ b/clients/client-rekognition/commands/GetFaceSearchCommand.ts @@ -20,6 +20,40 @@ import { export type GetFaceSearchCommandInput = GetFaceSearchRequest; export type GetFaceSearchCommandOutput = GetFaceSearchResponse & __MetadataBearer; +/** + *

Gets the face search results for Amazon Rekognition Video face search started by + * StartFaceSearch. The search returns faces in a collection that match the faces + * of persons detected in a video. It also includes the time(s) that faces are matched in the video.

+ *

Face search in a video is an asynchronous operation. You start face search by calling + * to StartFaceSearch which returns a job identifier (JobId). + * When the search operation finishes, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service + * topic registered in the initial call to StartFaceSearch. + * To get the search results, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetFaceSearch and pass the job identifier + * (JobId) from the initial call to StartFaceSearch.

+ * + *

For more information, see Searching Faces in a Collection in the + * Amazon Rekognition Developer Guide.

+ *

The search results are retured in an array, Persons, of + * PersonMatch objects. EachPersonMatch element contains + * details about the matching faces in the input collection, person information (facial attributes, + * bounding boxes, and person identifer) + * for the matched person, and the time the person was matched in the video.

+ * + * + *

+ * GetFaceSearch only returns the default + * facial attributes (BoundingBox, Confidence, + * Landmarks, Pose, and Quality). The other facial attributes listed + * in the Face object of the following response syntax are not returned. For more information, + * see FaceDetail in the Amazon Rekognition Developer Guide.

+ *
+ * + *

By default, the Persons array is sorted by the time, in milliseconds from the + * start of the video, persons are matched. + * You can also sort by persons by specifying INDEX for the SORTBY input + * parameter.

+ */ export class GetFaceSearchCommand extends $Command< GetFaceSearchCommandInput, GetFaceSearchCommandOutput, @@ -34,6 +68,9 @@ export class GetFaceSearchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetLabelDetectionCommand.ts b/clients/client-rekognition/commands/GetLabelDetectionCommand.ts index ae60ae847db81..9821eabec5588 100644 --- a/clients/client-rekognition/commands/GetLabelDetectionCommand.ts +++ b/clients/client-rekognition/commands/GetLabelDetectionCommand.ts @@ -20,6 +20,29 @@ import { export type GetLabelDetectionCommandInput = GetLabelDetectionRequest; export type GetLabelDetectionCommandOutput = GetLabelDetectionResponse & __MetadataBearer; +/** + *

Gets the label detection results of a Amazon Rekognition Video analysis started by StartLabelDetection.

+ * + *

The label detection operation is started by a call to StartLabelDetection + * which returns a job identifier (JobId). When the label detection operation finishes, Amazon Rekognition publishes a completion status to + * the Amazon Simple Notification Service topic registered in the initial call to StartlabelDetection. To get the results + * of the label detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. + * If so, call GetLabelDetection and pass the job identifier + * (JobId) from the initial call to StartLabelDetection.

+ *

+ * GetLabelDetection returns an array of detected labels (Labels) sorted by the time + * the labels were detected. You can also sort by the label name by specifying NAME for the + * SortBy input parameter.

+ *

The labels returned include the label name, the percentage confidence in the accuracy of the detected label, + * and the time the label was detected in the video.

+ *

The returned labels also include bounding box information for common objects, a + * hierarchical taxonomy of detected labels, and the version of the label model used for detection.

+ * + *

Use MaxResults parameter to limit the number of labels returned. If there are more results than + * specified in MaxResults, the value of NextToken in the operation response contains a pagination token for getting the next set + * of results. To get the next page of results, call GetlabelDetection and populate the NextToken request parameter with the token + * value returned from the previous call to GetLabelDetection.

+ */ export class GetLabelDetectionCommand extends $Command< GetLabelDetectionCommandInput, GetLabelDetectionCommandOutput, @@ -34,6 +57,9 @@ export class GetLabelDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetPersonTrackingCommand.ts b/clients/client-rekognition/commands/GetPersonTrackingCommand.ts index f870c87c11d81..d25c84161955a 100644 --- a/clients/client-rekognition/commands/GetPersonTrackingCommand.ts +++ b/clients/client-rekognition/commands/GetPersonTrackingCommand.ts @@ -20,6 +20,38 @@ import { export type GetPersonTrackingCommandInput = GetPersonTrackingRequest; export type GetPersonTrackingCommandOutput = GetPersonTrackingResponse & __MetadataBearer; +/** + *

Gets the path tracking results of a Amazon Rekognition Video analysis started by StartPersonTracking.

+ * + *

The person path tracking operation is started by a call to StartPersonTracking + * which returns a job identifier (JobId). When the operation finishes, Amazon Rekognition Video publishes a completion status to + * the Amazon Simple Notification Service topic registered in the initial call to StartPersonTracking.

+ *

To get the results of the person path tracking operation, first check + * that the status value published to the Amazon SNS topic is SUCCEEDED. + * If so, call GetPersonTracking and pass the job identifier + * (JobId) from the initial call to StartPersonTracking.

+ *

+ * GetPersonTracking returns an array, Persons, of tracked persons and the time(s) their + * paths were tracked in the video.

+ * + *

+ * GetPersonTracking only returns the default + * facial attributes (BoundingBox, Confidence, + * Landmarks, Pose, and Quality). The other facial attributes listed + * in the Face object of the following response syntax are not returned.

+ * + *

For more information, see FaceDetail in the Amazon Rekognition Developer Guide.

+ *
+ * + * + *

By default, the array is sorted by the time(s) a person's path is tracked in the video. + * You can sort by tracked persons by specifying INDEX for the SortBy input parameter.

+ * + *

Use the MaxResults parameter to limit the number of items returned. If there are more results than + * specified in MaxResults, the value of NextToken in the operation response contains a pagination token for getting the next set + * of results. To get the next page of results, call GetPersonTracking and populate the NextToken request parameter with the token + * value returned from the previous call to GetPersonTracking.

+ */ export class GetPersonTrackingCommand extends $Command< GetPersonTrackingCommandInput, GetPersonTrackingCommandOutput, @@ -34,6 +66,9 @@ export class GetPersonTrackingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetSegmentDetectionCommand.ts b/clients/client-rekognition/commands/GetSegmentDetectionCommand.ts index e6fce65e20539..ec4a277a43ec0 100644 --- a/clients/client-rekognition/commands/GetSegmentDetectionCommand.ts +++ b/clients/client-rekognition/commands/GetSegmentDetectionCommand.ts @@ -20,6 +20,31 @@ import { export type GetSegmentDetectionCommandInput = GetSegmentDetectionRequest; export type GetSegmentDetectionCommandOutput = GetSegmentDetectionResponse & __MetadataBearer; +/** + *

Gets the segment detection results of a Amazon Rekognition Video analysis started by StartSegmentDetection.

+ *

Segment detection with Amazon Rekognition Video is an asynchronous operation. You start segment detection by + * calling StartSegmentDetection which returns a job identifier (JobId). + * When the segment detection operation finishes, Amazon Rekognition publishes a completion status to the Amazon Simple Notification Service + * topic registered in the initial call to StartSegmentDetection. To get the results + * of the segment detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. + * if so, call GetSegmentDetection and pass the job identifier (JobId) from the initial call + * of StartSegmentDetection.

+ *

+ * GetSegmentDetection returns detected segments in an array (Segments) + * of SegmentDetection objects. Segments is sorted by the segment types + * specified in the SegmentTypes input parameter of StartSegmentDetection. + * Each element of the array includes the detected segment, the precentage confidence in the acuracy + * of the detected segment, the type of the segment, and the frame in which the segment was detected.

+ *

Use SelectedSegmentTypes to find out the type of segment detection requested in the + * call to StartSegmentDetection.

+ *

Use the MaxResults parameter to limit the number of segment detections returned. If there are more results than + * specified in MaxResults, the value of NextToken in the operation response contains + * a pagination token for getting the next set of results. To get the next page of results, call GetSegmentDetection + * and populate the NextToken request parameter with the token value returned from the previous + * call to GetSegmentDetection.

+ * + *

For more information, see Detecting Video Segments in Stored Video in the Amazon Rekognition Developer Guide.

+ */ export class GetSegmentDetectionCommand extends $Command< GetSegmentDetectionCommandInput, GetSegmentDetectionCommandOutput, @@ -34,6 +59,9 @@ export class GetSegmentDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/GetTextDetectionCommand.ts b/clients/client-rekognition/commands/GetTextDetectionCommand.ts index 721628f70bc27..9ab53dd6d6b44 100644 --- a/clients/client-rekognition/commands/GetTextDetectionCommand.ts +++ b/clients/client-rekognition/commands/GetTextDetectionCommand.ts @@ -20,6 +20,27 @@ import { export type GetTextDetectionCommandInput = GetTextDetectionRequest; export type GetTextDetectionCommandOutput = GetTextDetectionResponse & __MetadataBearer; +/** + *

Gets the text detection results of a Amazon Rekognition Video analysis started by StartTextDetection.

+ *

Text detection with Amazon Rekognition Video is an asynchronous operation. You start text detection by + * calling StartTextDetection which returns a job identifier (JobId) + * When the text detection operation finishes, Amazon Rekognition publishes a completion status to the Amazon Simple Notification Service + * topic registered in the initial call to StartTextDetection. To get the results + * of the text detection operation, first check that the status value published to the Amazon SNS topic is SUCCEEDED. + * if so, call GetTextDetection and pass the job identifier (JobId) from the initial call + * of StartLabelDetection.

+ *

+ * GetTextDetection returns an array of detected text (TextDetections) sorted by + * the time the text was detected, up to 50 words per frame of video.

+ *

Each element of the array includes the detected text, the precentage confidence in the acuracy + * of the detected text, the time the text was detected, bounding box information for where the text + * was located, and unique identifiers for words and their lines.

+ *

Use MaxResults parameter to limit the number of text detections returned. If there are more results than + * specified in MaxResults, the value of NextToken in the operation response contains + * a pagination token for getting the next set of results. To get the next page of results, call GetTextDetection + * and populate the NextToken request parameter with the token value returned from the previous + * call to GetTextDetection.

+ */ export class GetTextDetectionCommand extends $Command< GetTextDetectionCommandInput, GetTextDetectionCommandOutput, @@ -34,6 +55,9 @@ export class GetTextDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/IndexFacesCommand.ts b/clients/client-rekognition/commands/IndexFacesCommand.ts index 374fed53d4c93..5dd83a218e978 100644 --- a/clients/client-rekognition/commands/IndexFacesCommand.ts +++ b/clients/client-rekognition/commands/IndexFacesCommand.ts @@ -20,6 +20,108 @@ import { export type IndexFacesCommandInput = IndexFacesRequest; export type IndexFacesCommandOutput = IndexFacesResponse & __MetadataBearer; +/** + *

Detects faces in the input image and adds them to the specified collection.

+ *

Amazon Rekognition doesn't save the actual faces that are detected. Instead, the underlying + * detection algorithm first detects the faces in the input image. For each face, the algorithm + * extracts facial features into a feature vector, and stores it in the backend database. + * Amazon Rekognition uses feature vectors when it performs face match and search operations using the + * SearchFaces and SearchFacesByImage + * operations.

+ * + *

For more information, see Adding Faces to a Collection in the Amazon Rekognition + * Developer Guide.

+ *

To get the number of faces in a collection, call DescribeCollection.

+ * + *

If you're using version 1.0 of the face detection model, IndexFaces + * indexes the 15 largest faces in the input image. Later versions of the face detection model + * index the 100 largest faces in the input image.

+ *

If you're using version 4 or later of the face model, image orientation information + * is not returned in the OrientationCorrection field.

+ *

To determine which version of the model you're using, call DescribeCollection + * and supply the collection ID. You can also get the model version from the value of FaceModelVersion in the response + * from IndexFaces + *

+ * + *

For more information, see Model Versioning in the Amazon Rekognition Developer + * Guide.

+ *

If you provide the optional ExternalImageId for the input image you + * provided, Amazon Rekognition associates this ID with all faces that it detects. When you call the ListFaces operation, the response returns the external ID. You can use this + * external image ID to create a client-side index to associate the faces with each image. You + * can then use the index to find all faces in an image.

+ *

You can specify the maximum number of faces to index with the MaxFaces input + * parameter. This is useful when you want to index the largest faces in an image and don't want to index + * smaller faces, such as those belonging to people standing in the background.

+ *

The QualityFilter input parameter allows you to filter out detected faces + * that don’t meet a required quality bar. The quality bar is based on a + * variety of common use cases. By default, IndexFaces chooses the quality bar that's + * used to filter faces. You can also explicitly choose + * the quality bar. Use QualityFilter, to set the quality bar + * by specifying LOW, MEDIUM, or HIGH. + * If you do not want to filter detected faces, specify NONE.

+ * + *

To use quality filtering, you need a collection associated with version 3 of the + * face model or higher. To get the version of the face model associated with a collection, call + * DescribeCollection.

+ *
+ *

Information about faces detected in an image, but not indexed, is returned in an array of + * UnindexedFace objects, UnindexedFaces. Faces aren't + * indexed for reasons such as:

+ *
    + *
  • + *

    The number of faces detected exceeds the value of the MaxFaces request + * parameter.

    + *
  • + *
  • + *

    The face is too small compared to the image dimensions.

    + *
  • + *
  • + *

    The face is too blurry.

    + *
  • + *
  • + *

    The image is too dark.

    + *
  • + *
  • + *

    The face has an extreme pose.

    + *
  • + *
  • + *

    The face doesn’t have enough detail to be suitable for face search.

    + *
  • + *
+ *

In response, the IndexFaces operation returns an array of metadata for + * all detected faces, FaceRecords. This includes:

+ *
    + *
  • + *

    The bounding box, BoundingBox, of the detected face.

    + *
  • + *
  • + *

    A confidence value, Confidence, which indicates the confidence that the + * bounding box contains a face.

    + *
  • + *
  • + *

    A face ID, FaceId, assigned by the service for each face that's detected + * and stored.

    + *
  • + *
  • + *

    An image ID, ImageId, assigned by the service for the input image.

    + *
  • + *
+ *

If you request all facial attributes (by using the detectionAttributes + * parameter), Amazon Rekognition returns detailed facial attributes, such as facial landmarks (for + * example, location of eye and mouth) and other facial attributes. If you provide + * the same image, specify the same collection, and use the same external ID in the + * IndexFaces operation, Amazon Rekognition doesn't save duplicate face metadata.

+ * + * + *

+ * + * + *

The input image is passed either as base64-encoded image bytes, or as a reference to an + * image in an Amazon S3 bucket. If you use the AWS CLI to call Amazon Rekognition operations, + * passing image bytes isn't supported. The image must be formatted as a PNG or JPEG file.

+ *

This operation requires permissions to perform the rekognition:IndexFaces + * action.

+ */ export class IndexFacesCommand extends $Command< IndexFacesCommandInput, IndexFacesCommandOutput, @@ -34,6 +136,9 @@ export class IndexFacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/ListCollectionsCommand.ts b/clients/client-rekognition/commands/ListCollectionsCommand.ts index 21d0844936137..bedb802e9f42d 100644 --- a/clients/client-rekognition/commands/ListCollectionsCommand.ts +++ b/clients/client-rekognition/commands/ListCollectionsCommand.ts @@ -20,6 +20,14 @@ import { export type ListCollectionsCommandInput = ListCollectionsRequest; export type ListCollectionsCommandOutput = ListCollectionsResponse & __MetadataBearer; +/** + *

Returns list of collection IDs in your account. + * If the result is truncated, the response also provides a NextToken + * that you can use in the subsequent request to fetch the next set of collection IDs.

+ * + *

For an example, see Listing Collections in the Amazon Rekognition Developer Guide.

+ *

This operation requires permissions to perform the rekognition:ListCollections action.

+ */ export class ListCollectionsCommand extends $Command< ListCollectionsCommandInput, ListCollectionsCommandOutput, @@ -34,6 +42,9 @@ export class ListCollectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/ListFacesCommand.ts b/clients/client-rekognition/commands/ListFacesCommand.ts index b15576a0937b4..abd2e8303aa34 100644 --- a/clients/client-rekognition/commands/ListFacesCommand.ts +++ b/clients/client-rekognition/commands/ListFacesCommand.ts @@ -17,6 +17,16 @@ import { export type ListFacesCommandInput = ListFacesRequest; export type ListFacesCommandOutput = ListFacesResponse & __MetadataBearer; +/** + *

Returns metadata for faces in the specified collection. + * This metadata includes information such as the bounding box coordinates, the confidence + * (that the bounding box contains a face), and face ID. For an example, see Listing Faces in a Collection + * in the Amazon Rekognition Developer Guide.

+ * + * + *

This operation requires permissions to perform the + * rekognition:ListFaces action.

+ */ export class ListFacesCommand extends $Command< ListFacesCommandInput, ListFacesCommandOutput, @@ -31,6 +41,9 @@ export class ListFacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/ListStreamProcessorsCommand.ts b/clients/client-rekognition/commands/ListStreamProcessorsCommand.ts index 8e2dc52130b46..85384a954700b 100644 --- a/clients/client-rekognition/commands/ListStreamProcessorsCommand.ts +++ b/clients/client-rekognition/commands/ListStreamProcessorsCommand.ts @@ -20,6 +20,9 @@ import { export type ListStreamProcessorsCommandInput = ListStreamProcessorsRequest; export type ListStreamProcessorsCommandOutput = ListStreamProcessorsResponse & __MetadataBearer; +/** + *

Gets a list of stream processors that you have created with CreateStreamProcessor.

+ */ export class ListStreamProcessorsCommand extends $Command< ListStreamProcessorsCommandInput, ListStreamProcessorsCommandOutput, @@ -34,6 +37,9 @@ export class ListStreamProcessorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/RecognizeCelebritiesCommand.ts b/clients/client-rekognition/commands/RecognizeCelebritiesCommand.ts index b7c68810acbae..810c879ff8efb 100644 --- a/clients/client-rekognition/commands/RecognizeCelebritiesCommand.ts +++ b/clients/client-rekognition/commands/RecognizeCelebritiesCommand.ts @@ -20,6 +20,39 @@ import { export type RecognizeCelebritiesCommandInput = RecognizeCelebritiesRequest; export type RecognizeCelebritiesCommandOutput = RecognizeCelebritiesResponse & __MetadataBearer; +/** + *

Returns an array of celebrities recognized in the input image. For more information, see Recognizing Celebrities + * in the Amazon Rekognition Developer Guide.

+ *

+ * RecognizeCelebrities returns the 64 largest faces in the image. It lists + * recognized celebrities in the CelebrityFaces array and unrecognized faces in the + * UnrecognizedFaces array. RecognizeCelebrities doesn't return + * celebrities whose faces aren't among the largest 64 faces in the image.

+ * + *

For each celebrity recognized, RecognizeCelebrities returns a + * Celebrity object. The Celebrity object contains the celebrity + * name, ID, URL links to additional information, match confidence, and a + * ComparedFace object that you can use to locate the celebrity's face on the + * image.

+ *

Amazon Rekognition doesn't retain information about which images a celebrity has been recognized + * in. Your application must store this information and use the Celebrity ID + * property as a unique identifier for the celebrity. If you don't store the celebrity name or + * additional information URLs returned by RecognizeCelebrities, you will need the + * ID to identify the celebrity in a call to the GetCelebrityInfo + * operation.

+ *

You pass the input image either as base64-encoded image bytes or as a reference to an + * image in an Amazon S3 bucket. If you use the + * AWS + * CLI to call Amazon Rekognition operations, passing image bytes is not + * supported. The image must be either a PNG or JPEG formatted file.

+ * + * + * + * + *

For an example, see Recognizing Celebrities in an Image in the Amazon Rekognition Developer Guide.

+ *

This operation requires permissions to perform the + * rekognition:RecognizeCelebrities operation.

+ */ export class RecognizeCelebritiesCommand extends $Command< RecognizeCelebritiesCommandInput, RecognizeCelebritiesCommandOutput, @@ -34,6 +67,9 @@ export class RecognizeCelebritiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/SearchFacesByImageCommand.ts b/clients/client-rekognition/commands/SearchFacesByImageCommand.ts index 80c54a5530370..071382e3af6f8 100644 --- a/clients/client-rekognition/commands/SearchFacesByImageCommand.ts +++ b/clients/client-rekognition/commands/SearchFacesByImageCommand.ts @@ -20,6 +20,53 @@ import { export type SearchFacesByImageCommandInput = SearchFacesByImageRequest; export type SearchFacesByImageCommandOutput = SearchFacesByImageResponse & __MetadataBearer; +/** + *

For a given input image, first detects the largest face in the image, and then searches + * the specified collection for matching faces. The operation compares the features of the input + * face with faces in the specified collection.

+ * + *

To search for all faces in an input image, you might first call the IndexFaces operation, and then use the face IDs returned in subsequent + * calls to the SearchFaces operation.

+ *

You can also call the DetectFaces operation and use the bounding boxes + * in the response to make face crops, which then you can pass in to the + * SearchFacesByImage operation.

+ *
+ * + *

You pass the input image either as base64-encoded image bytes or as a reference to an + * image in an Amazon S3 bucket. If you use the + * AWS + * CLI to call Amazon Rekognition operations, passing image bytes is not + * supported. The image must be either a PNG or JPEG formatted file.

+ *

+ * The response returns an array of faces that match, ordered by similarity score with the + * highest similarity first. More specifically, it is an + * array of metadata for each face match found. Along with the metadata, the response also + * includes a similarity indicating how similar the face is + * to the input face. + * + * In the response, the operation also returns the bounding + * box (and a confidence level that the bounding box contains a face) of the face that Amazon Rekognition + * used for the input image. + *

+ * + *

For an example, Searching for a Face Using an Image in the Amazon Rekognition Developer Guide.

+ * + *

The QualityFilter input parameter allows you to filter out detected faces + * that don’t meet a required quality bar. The quality bar is based on a + * variety of common use cases. + * Use QualityFilter to set the quality bar for + * filtering by specifying LOW, MEDIUM, or HIGH. + * If you do not want to filter detected faces, specify NONE. The default + * value is NONE.

+ * + *

To use quality filtering, you need a collection associated with version 3 of the + * face model or higher. To get the version of the face model associated with a collection, call + * DescribeCollection.

+ *
+ * + *

This operation requires permissions to perform the rekognition:SearchFacesByImage + * action.

+ */ export class SearchFacesByImageCommand extends $Command< SearchFacesByImageCommandInput, SearchFacesByImageCommandOutput, @@ -34,6 +81,9 @@ export class SearchFacesByImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/SearchFacesCommand.ts b/clients/client-rekognition/commands/SearchFacesCommand.ts index a018b48ae7775..e3034baf25fe5 100644 --- a/clients/client-rekognition/commands/SearchFacesCommand.ts +++ b/clients/client-rekognition/commands/SearchFacesCommand.ts @@ -20,6 +20,29 @@ import { export type SearchFacesCommandInput = SearchFacesRequest; export type SearchFacesCommandOutput = SearchFacesResponse & __MetadataBearer; +/** + *

For a given input face ID, searches for matching faces in the collection the face + * belongs to. You get a face ID when you add a face to the collection using the IndexFaces operation. The operation compares the features of the input face with + * faces in the specified collection.

+ * + *

You can also search faces without indexing faces by using the + * SearchFacesByImage operation.

+ *
+ * + *

+ * The operation response returns + * an array of faces that match, ordered by similarity score with the highest + * similarity first. More specifically, it is an + * array of metadata for each face match that is found. Along with the metadata, the response also + * includes a confidence value for each face match, indicating the confidence + * that the specific face matches the input face. + *

+ * + *

For an example, see Searching for a Face Using Its Face ID in the Amazon Rekognition Developer Guide.

+ * + *

This operation requires permissions to perform the rekognition:SearchFaces + * action.

+ */ export class SearchFacesCommand extends $Command< SearchFacesCommandInput, SearchFacesCommandOutput, @@ -34,6 +57,9 @@ export class SearchFacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartCelebrityRecognitionCommand.ts b/clients/client-rekognition/commands/StartCelebrityRecognitionCommand.ts index a2a964923774f..edb50dd551fbe 100644 --- a/clients/client-rekognition/commands/StartCelebrityRecognitionCommand.ts +++ b/clients/client-rekognition/commands/StartCelebrityRecognitionCommand.ts @@ -20,6 +20,20 @@ import { export type StartCelebrityRecognitionCommandInput = StartCelebrityRecognitionRequest; export type StartCelebrityRecognitionCommandOutput = StartCelebrityRecognitionResponse & __MetadataBearer; +/** + *

Starts asynchronous recognition of celebrities in a stored video.

+ *

Amazon Rekognition Video can detect celebrities in a video must be stored in an Amazon S3 bucket. Use Video to specify the bucket name + * and the filename of the video. + * StartCelebrityRecognition + * returns a job identifier (JobId) which you use to get the results of the analysis. + * When celebrity recognition analysis is finished, Amazon Rekognition Video publishes a completion status + * to the Amazon Simple Notification Service topic that you specify in NotificationChannel. + * To get the results of the celebrity recognition analysis, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetCelebrityRecognition and pass the job identifier + * (JobId) from the initial call to StartCelebrityRecognition.

+ * + *

For more information, see Recognizing Celebrities in the Amazon Rekognition Developer Guide.

+ */ export class StartCelebrityRecognitionCommand extends $Command< StartCelebrityRecognitionCommandInput, StartCelebrityRecognitionCommandOutput, @@ -34,6 +48,9 @@ export class StartCelebrityRecognitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartContentModerationCommand.ts b/clients/client-rekognition/commands/StartContentModerationCommand.ts index c3490403c3238..fb59571b173b0 100644 --- a/clients/client-rekognition/commands/StartContentModerationCommand.ts +++ b/clients/client-rekognition/commands/StartContentModerationCommand.ts @@ -20,6 +20,19 @@ import { export type StartContentModerationCommandInput = StartContentModerationRequest; export type StartContentModerationCommandOutput = StartContentModerationResponse & __MetadataBearer; +/** + *

Starts asynchronous detection of unsafe content in a stored video.

+ *

Amazon Rekognition Video can moderate content in a video stored in an Amazon S3 bucket. Use Video to specify the bucket name + * and the filename of the video. StartContentModeration + * returns a job identifier (JobId) which you use to get the results of the analysis. + * When unsafe content analysis is finished, Amazon Rekognition Video publishes a completion status + * to the Amazon Simple Notification Service topic that you specify in NotificationChannel.

+ *

To get the results of the unsafe content analysis, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetContentModeration and pass the job identifier + * (JobId) from the initial call to StartContentModeration.

+ * + *

For more information, see Detecting Unsafe Content in the Amazon Rekognition Developer Guide.

+ */ export class StartContentModerationCommand extends $Command< StartContentModerationCommandInput, StartContentModerationCommandOutput, @@ -34,6 +47,9 @@ export class StartContentModerationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartFaceDetectionCommand.ts b/clients/client-rekognition/commands/StartFaceDetectionCommand.ts index f35f333904ac4..bf0e0e0235f32 100644 --- a/clients/client-rekognition/commands/StartFaceDetectionCommand.ts +++ b/clients/client-rekognition/commands/StartFaceDetectionCommand.ts @@ -20,6 +20,21 @@ import { export type StartFaceDetectionCommandInput = StartFaceDetectionRequest; export type StartFaceDetectionCommandOutput = StartFaceDetectionResponse & __MetadataBearer; +/** + *

Starts asynchronous detection of faces in a stored video.

+ *

Amazon Rekognition Video can detect faces in a video stored in an Amazon S3 bucket. + * Use Video to specify the bucket name and the filename of the video. + * StartFaceDetection returns a job identifier (JobId) that you + * use to get the results of the operation. + * When face detection is finished, Amazon Rekognition Video publishes a completion status + * to the Amazon Simple Notification Service topic that you specify in NotificationChannel. + * To get the results of the face detection operation, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetFaceDetection and pass the job identifier + * (JobId) from the initial call to StartFaceDetection.

+ * + *

For more information, see Detecting Faces in a Stored Video in the + * Amazon Rekognition Developer Guide.

+ */ export class StartFaceDetectionCommand extends $Command< StartFaceDetectionCommandInput, StartFaceDetectionCommandOutput, @@ -34,6 +49,9 @@ export class StartFaceDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartFaceSearchCommand.ts b/clients/client-rekognition/commands/StartFaceSearchCommand.ts index 491091d86d5f0..dae3b3283d149 100644 --- a/clients/client-rekognition/commands/StartFaceSearchCommand.ts +++ b/clients/client-rekognition/commands/StartFaceSearchCommand.ts @@ -20,6 +20,18 @@ import { export type StartFaceSearchCommandInput = StartFaceSearchRequest; export type StartFaceSearchCommandOutput = StartFaceSearchResponse & __MetadataBearer; +/** + *

Starts the asynchronous search for faces in a collection that match the faces of persons detected in a stored video.

+ *

The video must be stored in an Amazon S3 bucket. Use Video to specify the bucket name + * and the filename of the video. StartFaceSearch + * returns a job identifier (JobId) which you use to get the search results once the search has completed. + * When searching is finished, Amazon Rekognition Video publishes a completion status + * to the Amazon Simple Notification Service topic that you specify in NotificationChannel. + * To get the search results, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetFaceSearch and pass the job identifier + * (JobId) from the initial call to StartFaceSearch. For more information, see + * procedure-person-search-videos.

+ */ export class StartFaceSearchCommand extends $Command< StartFaceSearchCommandInput, StartFaceSearchCommandOutput, @@ -34,6 +46,9 @@ export class StartFaceSearchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartLabelDetectionCommand.ts b/clients/client-rekognition/commands/StartLabelDetectionCommand.ts index 992c387bb022c..8c4c9bcc1284d 100644 --- a/clients/client-rekognition/commands/StartLabelDetectionCommand.ts +++ b/clients/client-rekognition/commands/StartLabelDetectionCommand.ts @@ -20,6 +20,23 @@ import { export type StartLabelDetectionCommandInput = StartLabelDetectionRequest; export type StartLabelDetectionCommandOutput = StartLabelDetectionResponse & __MetadataBearer; +/** + *

Starts asynchronous detection of labels in a stored video.

+ *

Amazon Rekognition Video can detect labels in a video. Labels are instances of real-world entities. + * This includes objects like flower, tree, and table; events like + * wedding, graduation, and birthday party; concepts like landscape, evening, and nature; and activities + * like a person getting out of a car or a person skiing.

+ * + *

The video must be stored in an Amazon S3 bucket. Use Video to specify the bucket name + * and the filename of the video. + * StartLabelDetection returns a job identifier (JobId) which you use to get the + * results of the operation. When label detection is finished, Amazon Rekognition Video publishes a completion status + * to the Amazon Simple Notification Service topic that you specify in NotificationChannel.

+ *

To get the results of the label detection operation, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetLabelDetection and pass the job identifier + * (JobId) from the initial call to StartLabelDetection.

+ *

+ */ export class StartLabelDetectionCommand extends $Command< StartLabelDetectionCommandInput, StartLabelDetectionCommandOutput, @@ -34,6 +51,9 @@ export class StartLabelDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartPersonTrackingCommand.ts b/clients/client-rekognition/commands/StartPersonTrackingCommand.ts index 68ac2a3ce2731..e26e4a322413b 100644 --- a/clients/client-rekognition/commands/StartPersonTrackingCommand.ts +++ b/clients/client-rekognition/commands/StartPersonTrackingCommand.ts @@ -20,6 +20,17 @@ import { export type StartPersonTrackingCommandInput = StartPersonTrackingRequest; export type StartPersonTrackingCommandOutput = StartPersonTrackingResponse & __MetadataBearer; +/** + *

Starts the asynchronous tracking of a person's path in a stored video.

+ *

Amazon Rekognition Video can track the path of people in a video stored in an Amazon S3 bucket. Use Video to specify the bucket name + * and the filename of the video. StartPersonTracking + * returns a job identifier (JobId) which you use to get the results of the operation. + * When label detection is finished, Amazon Rekognition publishes a completion status + * to the Amazon Simple Notification Service topic that you specify in NotificationChannel.

+ *

To get the results of the person detection operation, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. If so, call GetPersonTracking and pass the job identifier + * (JobId) from the initial call to StartPersonTracking.

+ */ export class StartPersonTrackingCommand extends $Command< StartPersonTrackingCommandInput, StartPersonTrackingCommandOutput, @@ -34,6 +45,9 @@ export class StartPersonTrackingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartProjectVersionCommand.ts b/clients/client-rekognition/commands/StartProjectVersionCommand.ts index 451357e97aaf7..58a46ccfe9675 100644 --- a/clients/client-rekognition/commands/StartProjectVersionCommand.ts +++ b/clients/client-rekognition/commands/StartProjectVersionCommand.ts @@ -20,6 +20,18 @@ import { export type StartProjectVersionCommandInput = StartProjectVersionRequest; export type StartProjectVersionCommandOutput = StartProjectVersionResponse & __MetadataBearer; +/** + *

Starts the running of the version of a model. Starting a model takes a while + * to complete. To check the current state of the model, use DescribeProjectVersions.

+ *

Once the model is running, you can detect custom labels in new images by calling + * DetectCustomLabels.

+ * + *

You are charged for the amount of time that the model is running. To stop a running + * model, call StopProjectVersion.

+ *
+ *

This operation requires permissions to perform the + * rekognition:StartProjectVersion action.

+ */ export class StartProjectVersionCommand extends $Command< StartProjectVersionCommandInput, StartProjectVersionCommandOutput, @@ -34,6 +46,9 @@ export class StartProjectVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartSegmentDetectionCommand.ts b/clients/client-rekognition/commands/StartSegmentDetectionCommand.ts index 1457c2bb540f4..7d343fb7a114d 100644 --- a/clients/client-rekognition/commands/StartSegmentDetectionCommand.ts +++ b/clients/client-rekognition/commands/StartSegmentDetectionCommand.ts @@ -20,6 +20,24 @@ import { export type StartSegmentDetectionCommandInput = StartSegmentDetectionRequest; export type StartSegmentDetectionCommandOutput = StartSegmentDetectionResponse & __MetadataBearer; +/** + *

Starts asynchronous detection of segment detection in a stored video.

+ *

Amazon Rekognition Video can detect segments in a video stored in an Amazon S3 bucket. Use Video to specify the bucket name and + * the filename of the video. StartSegmentDetection returns a job identifier (JobId) which you use to get + * the results of the operation. When segment detection is finished, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic + * that you specify in NotificationChannel.

+ *

You can use the Filters (StartSegmentDetectionFilters) + * input parameter to specify the minimum detection confidence returned in the response. + * Within Filters, use ShotFilter (StartShotDetectionFilter) + * to filter detected shots. Use TechnicalCueFilter (StartTechnicalCueDetectionFilter) + * to filter technical cues.

+ *

To get the results of the segment detection operation, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. if so, call GetSegmentDetection and pass the job identifier (JobId) + * from the initial call to StartSegmentDetection.

+ * + * + *

For more information, see Detecting Video Segments in Stored Video in the Amazon Rekognition Developer Guide.

+ */ export class StartSegmentDetectionCommand extends $Command< StartSegmentDetectionCommandInput, StartSegmentDetectionCommandOutput, @@ -34,6 +52,9 @@ export class StartSegmentDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartStreamProcessorCommand.ts b/clients/client-rekognition/commands/StartStreamProcessorCommand.ts index f39305a15fa9a..df728a0e55178 100644 --- a/clients/client-rekognition/commands/StartStreamProcessorCommand.ts +++ b/clients/client-rekognition/commands/StartStreamProcessorCommand.ts @@ -20,6 +20,11 @@ import { export type StartStreamProcessorCommandInput = StartStreamProcessorRequest; export type StartStreamProcessorCommandOutput = StartStreamProcessorResponse & __MetadataBearer; +/** + *

Starts processing a stream processor. You create a stream processor by calling CreateStreamProcessor. + * To tell StartStreamProcessor which stream processor to start, use the value of the Name field specified in the call to + * CreateStreamProcessor.

+ */ export class StartStreamProcessorCommand extends $Command< StartStreamProcessorCommandInput, StartStreamProcessorCommandOutput, @@ -34,6 +39,9 @@ export class StartStreamProcessorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StartTextDetectionCommand.ts b/clients/client-rekognition/commands/StartTextDetectionCommand.ts index 2b76c38aee2c1..dfa11c8dba335 100644 --- a/clients/client-rekognition/commands/StartTextDetectionCommand.ts +++ b/clients/client-rekognition/commands/StartTextDetectionCommand.ts @@ -20,6 +20,16 @@ import { export type StartTextDetectionCommandInput = StartTextDetectionRequest; export type StartTextDetectionCommandOutput = StartTextDetectionResponse & __MetadataBearer; +/** + *

Starts asynchronous detection of text in a stored video.

+ *

Amazon Rekognition Video can detect text in a video stored in an Amazon S3 bucket. Use Video to specify the bucket name and + * the filename of the video. StartTextDetection returns a job identifier (JobId) which you use to get + * the results of the operation. When text detection is finished, Amazon Rekognition Video publishes a completion status to the Amazon Simple Notification Service topic + * that you specify in NotificationChannel.

+ *

To get the results of the text detection operation, first check that the status value published to the Amazon SNS + * topic is SUCCEEDED. if so, call GetTextDetection and pass the job identifier (JobId) + * from the initial call to StartTextDetection.

+ */ export class StartTextDetectionCommand extends $Command< StartTextDetectionCommandInput, StartTextDetectionCommandOutput, @@ -34,6 +44,9 @@ export class StartTextDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StopProjectVersionCommand.ts b/clients/client-rekognition/commands/StopProjectVersionCommand.ts index 61f20116c43ba..50c7511d8f3cd 100644 --- a/clients/client-rekognition/commands/StopProjectVersionCommand.ts +++ b/clients/client-rekognition/commands/StopProjectVersionCommand.ts @@ -20,6 +20,10 @@ import { export type StopProjectVersionCommandInput = StopProjectVersionRequest; export type StopProjectVersionCommandOutput = StopProjectVersionResponse & __MetadataBearer; +/** + *

Stops a running model. The operation might take a while to complete. To + * check the current status, call DescribeProjectVersions.

+ */ export class StopProjectVersionCommand extends $Command< StopProjectVersionCommandInput, StopProjectVersionCommandOutput, @@ -34,6 +38,9 @@ export class StopProjectVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/commands/StopStreamProcessorCommand.ts b/clients/client-rekognition/commands/StopStreamProcessorCommand.ts index b911208c2cd7f..bed2c4fff392e 100644 --- a/clients/client-rekognition/commands/StopStreamProcessorCommand.ts +++ b/clients/client-rekognition/commands/StopStreamProcessorCommand.ts @@ -20,6 +20,9 @@ import { export type StopStreamProcessorCommandInput = StopStreamProcessorRequest; export type StopStreamProcessorCommandOutput = StopStreamProcessorResponse & __MetadataBearer; +/** + *

Stops a running stream processor that was created by CreateStreamProcessor.

+ */ export class StopStreamProcessorCommand extends $Command< StopStreamProcessorCommandInput, StopStreamProcessorCommandOutput, @@ -34,6 +37,9 @@ export class StopStreamProcessorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RekognitionClientResolvedConfig, diff --git a/clients/client-rekognition/package.json b/clients/client-rekognition/package.json index 04c563177ab75..87d54e81e4f88 100644 --- a/clients/client-rekognition/package.json +++ b/clients/client-rekognition/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Rekognition Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-rekognition/pagination/DescribeProjectVersionsPaginator.ts b/clients/client-rekognition/pagination/DescribeProjectVersionsPaginator.ts index 3fff5f0f94c6c..9b7a0c77e0729 100644 --- a/clients/client-rekognition/pagination/DescribeProjectVersionsPaginator.ts +++ b/clients/client-rekognition/pagination/DescribeProjectVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: DescribeProjectVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeProjectVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: DescribeProjectVersionsCommandInput, diff --git a/clients/client-rekognition/pagination/DescribeProjectsPaginator.ts b/clients/client-rekognition/pagination/DescribeProjectsPaginator.ts index 5fcd298c8c20c..51300e9f04139 100644 --- a/clients/client-rekognition/pagination/DescribeProjectsPaginator.ts +++ b/clients/client-rekognition/pagination/DescribeProjectsPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: DescribeProjectsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeProjectsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: DescribeProjectsCommandInput, diff --git a/clients/client-rekognition/pagination/GetCelebrityRecognitionPaginator.ts b/clients/client-rekognition/pagination/GetCelebrityRecognitionPaginator.ts index 0f5e00fd5fc3f..57863d4d051a9 100644 --- a/clients/client-rekognition/pagination/GetCelebrityRecognitionPaginator.ts +++ b/clients/client-rekognition/pagination/GetCelebrityRecognitionPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: GetCelebrityRecognitionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCelebrityRecognitionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: GetCelebrityRecognitionCommandInput, diff --git a/clients/client-rekognition/pagination/GetContentModerationPaginator.ts b/clients/client-rekognition/pagination/GetContentModerationPaginator.ts index ca94d51e11eed..9b7c0f3742c7b 100644 --- a/clients/client-rekognition/pagination/GetContentModerationPaginator.ts +++ b/clients/client-rekognition/pagination/GetContentModerationPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: GetContentModerationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetContentModerationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: GetContentModerationCommandInput, diff --git a/clients/client-rekognition/pagination/GetFaceDetectionPaginator.ts b/clients/client-rekognition/pagination/GetFaceDetectionPaginator.ts index c24196734e33b..3c369cea55462 100644 --- a/clients/client-rekognition/pagination/GetFaceDetectionPaginator.ts +++ b/clients/client-rekognition/pagination/GetFaceDetectionPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: GetFaceDetectionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetFaceDetectionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: GetFaceDetectionCommandInput, diff --git a/clients/client-rekognition/pagination/GetFaceSearchPaginator.ts b/clients/client-rekognition/pagination/GetFaceSearchPaginator.ts index c02461bfcfc47..47cf084fc4ce3 100644 --- a/clients/client-rekognition/pagination/GetFaceSearchPaginator.ts +++ b/clients/client-rekognition/pagination/GetFaceSearchPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: GetFaceSearchCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetFaceSearchCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: GetFaceSearchCommandInput, diff --git a/clients/client-rekognition/pagination/GetLabelDetectionPaginator.ts b/clients/client-rekognition/pagination/GetLabelDetectionPaginator.ts index 0f918fcf9e75a..a0c170ddb4a2b 100644 --- a/clients/client-rekognition/pagination/GetLabelDetectionPaginator.ts +++ b/clients/client-rekognition/pagination/GetLabelDetectionPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: GetLabelDetectionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetLabelDetectionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: GetLabelDetectionCommandInput, diff --git a/clients/client-rekognition/pagination/GetPersonTrackingPaginator.ts b/clients/client-rekognition/pagination/GetPersonTrackingPaginator.ts index 59d6d100bd16e..55e806d80225d 100644 --- a/clients/client-rekognition/pagination/GetPersonTrackingPaginator.ts +++ b/clients/client-rekognition/pagination/GetPersonTrackingPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: GetPersonTrackingCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetPersonTrackingCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: GetPersonTrackingCommandInput, diff --git a/clients/client-rekognition/pagination/GetSegmentDetectionPaginator.ts b/clients/client-rekognition/pagination/GetSegmentDetectionPaginator.ts index ddee823e8031c..e6dda0fcef780 100644 --- a/clients/client-rekognition/pagination/GetSegmentDetectionPaginator.ts +++ b/clients/client-rekognition/pagination/GetSegmentDetectionPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: GetSegmentDetectionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSegmentDetectionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: GetSegmentDetectionCommandInput, diff --git a/clients/client-rekognition/pagination/GetTextDetectionPaginator.ts b/clients/client-rekognition/pagination/GetTextDetectionPaginator.ts index ff5d6b3da5d3c..2733f44de34a2 100644 --- a/clients/client-rekognition/pagination/GetTextDetectionPaginator.ts +++ b/clients/client-rekognition/pagination/GetTextDetectionPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: GetTextDetectionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTextDetectionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: GetTextDetectionCommandInput, diff --git a/clients/client-rekognition/pagination/ListCollectionsPaginator.ts b/clients/client-rekognition/pagination/ListCollectionsPaginator.ts index 3b9ae1f1ba68b..391d49d1eddd9 100644 --- a/clients/client-rekognition/pagination/ListCollectionsPaginator.ts +++ b/clients/client-rekognition/pagination/ListCollectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: ListCollectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCollectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: ListCollectionsCommandInput, diff --git a/clients/client-rekognition/pagination/ListFacesPaginator.ts b/clients/client-rekognition/pagination/ListFacesPaginator.ts index 6dac3ee248cbd..0d673e9a2d7fc 100644 --- a/clients/client-rekognition/pagination/ListFacesPaginator.ts +++ b/clients/client-rekognition/pagination/ListFacesPaginator.ts @@ -4,6 +4,9 @@ import { ListFacesCommand, ListFacesCommandInput, ListFacesCommandOutput } from import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: ListFacesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFacesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: ListFacesCommandInput, diff --git a/clients/client-rekognition/pagination/ListStreamProcessorsPaginator.ts b/clients/client-rekognition/pagination/ListStreamProcessorsPaginator.ts index 90fe83d69e042..d9884106b926e 100644 --- a/clients/client-rekognition/pagination/ListStreamProcessorsPaginator.ts +++ b/clients/client-rekognition/pagination/ListStreamProcessorsPaginator.ts @@ -8,6 +8,9 @@ import { import { RekognitionPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RekognitionClient, input: ListStreamProcessorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStreamProcessorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Rekognition, input: ListStreamProcessorsCommandInput, diff --git a/clients/client-rekognition/runtimeConfig.browser.ts b/clients/client-rekognition/runtimeConfig.browser.ts index 42ae9620a983b..05abfada08ea4 100644 --- a/clients/client-rekognition/runtimeConfig.browser.ts +++ b/clients/client-rekognition/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RekognitionClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-rekognition/runtimeConfig.native.ts b/clients/client-rekognition/runtimeConfig.native.ts index 2ba1f6f0b3d00..25394ac24fc4f 100644 --- a/clients/client-rekognition/runtimeConfig.native.ts +++ b/clients/client-rekognition/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RekognitionClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-rekognition/runtimeConfig.shared.ts b/clients/client-rekognition/runtimeConfig.shared.ts index 17eda09712560..5244752ee80c9 100644 --- a/clients/client-rekognition/runtimeConfig.shared.ts +++ b/clients/client-rekognition/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-06-27", disableHostPrefix: false, diff --git a/clients/client-rekognition/runtimeConfig.ts b/clients/client-rekognition/runtimeConfig.ts index a6870baa74a7f..02b01ecc142b3 100644 --- a/clients/client-rekognition/runtimeConfig.ts +++ b/clients/client-rekognition/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RekognitionClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-rekognition/tsconfig.json b/clients/client-rekognition/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-rekognition/tsconfig.json +++ b/clients/client-rekognition/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-resource-groups-tagging-api/commands/DescribeReportCreationCommand.ts b/clients/client-resource-groups-tagging-api/commands/DescribeReportCreationCommand.ts index 1c0dcd457da33..4417d344a2aa1 100644 --- a/clients/client-resource-groups-tagging-api/commands/DescribeReportCreationCommand.ts +++ b/clients/client-resource-groups-tagging-api/commands/DescribeReportCreationCommand.ts @@ -24,6 +24,10 @@ import { export type DescribeReportCreationCommandInput = DescribeReportCreationInput; export type DescribeReportCreationCommandOutput = DescribeReportCreationOutput & __MetadataBearer; +/** + *

Describes the status of the StartReportCreation operation.

+ *

You can call this operation only from the organization's master account and from the us-east-1 Region.

+ */ export class DescribeReportCreationCommand extends $Command< DescribeReportCreationCommandInput, DescribeReportCreationCommandOutput, @@ -38,6 +42,9 @@ export class DescribeReportCreationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsTaggingAPIClientResolvedConfig, diff --git a/clients/client-resource-groups-tagging-api/commands/GetComplianceSummaryCommand.ts b/clients/client-resource-groups-tagging-api/commands/GetComplianceSummaryCommand.ts index 0255420cb7e4f..117c739ae3eea 100644 --- a/clients/client-resource-groups-tagging-api/commands/GetComplianceSummaryCommand.ts +++ b/clients/client-resource-groups-tagging-api/commands/GetComplianceSummaryCommand.ts @@ -24,6 +24,14 @@ import { export type GetComplianceSummaryCommandInput = GetComplianceSummaryInput; export type GetComplianceSummaryCommandOutput = GetComplianceSummaryOutput & __MetadataBearer; +/** + *

Returns a table that shows counts of resources that are noncompliant with their tag + * policies.

+ *

For more information on tag policies, see Tag Policies in + * the AWS Organizations User Guide. + *

+ *

You can call this operation only from the organization's master account and from the us-east-1 Region.

+ */ export class GetComplianceSummaryCommand extends $Command< GetComplianceSummaryCommandInput, GetComplianceSummaryCommandOutput, @@ -38,6 +46,9 @@ export class GetComplianceSummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsTaggingAPIClientResolvedConfig, diff --git a/clients/client-resource-groups-tagging-api/commands/GetResourcesCommand.ts b/clients/client-resource-groups-tagging-api/commands/GetResourcesCommand.ts index 0716148aeeace..20e81921b1ce0 100644 --- a/clients/client-resource-groups-tagging-api/commands/GetResourcesCommand.ts +++ b/clients/client-resource-groups-tagging-api/commands/GetResourcesCommand.ts @@ -24,6 +24,33 @@ import { export type GetResourcesCommandInput = GetResourcesInput; export type GetResourcesCommandOutput = GetResourcesOutput & __MetadataBearer; +/** + *

Returns all the tagged or previously tagged resources that are located in the + * specified Region for the AWS account.

+ *

Depending on what information you want returned, you can also specify the + * following:

+ *
    + *
  • + *

    + * Filters that specify what tags and resource types you + * want returned. The response includes all tags that are associated with the + * requested resources.

    + *
  • + *
  • + *

    Information about compliance with the account's effective tag policy. For more + * information on tag policies, see Tag + * Policies in the AWS Organizations User Guide. + *

    + *
  • + *
+ * + *

You can check the PaginationToken response parameter to determine if + * a query is complete. Queries occasionally return fewer results on a page than + * allowed. The PaginationToken response parameter value is + * null + * only when there are no more results to display.

+ *
+ */ export class GetResourcesCommand extends $Command< GetResourcesCommandInput, GetResourcesCommandOutput, @@ -38,6 +65,9 @@ export class GetResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsTaggingAPIClientResolvedConfig, diff --git a/clients/client-resource-groups-tagging-api/commands/GetTagKeysCommand.ts b/clients/client-resource-groups-tagging-api/commands/GetTagKeysCommand.ts index 31b363c42428d..d1231a789dabd 100644 --- a/clients/client-resource-groups-tagging-api/commands/GetTagKeysCommand.ts +++ b/clients/client-resource-groups-tagging-api/commands/GetTagKeysCommand.ts @@ -24,6 +24,9 @@ import { export type GetTagKeysCommandInput = GetTagKeysInput; export type GetTagKeysCommandOutput = GetTagKeysOutput & __MetadataBearer; +/** + *

Returns all tag keys in the specified Region for the AWS account.

+ */ export class GetTagKeysCommand extends $Command< GetTagKeysCommandInput, GetTagKeysCommandOutput, @@ -38,6 +41,9 @@ export class GetTagKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsTaggingAPIClientResolvedConfig, diff --git a/clients/client-resource-groups-tagging-api/commands/GetTagValuesCommand.ts b/clients/client-resource-groups-tagging-api/commands/GetTagValuesCommand.ts index b6a0d24355552..a6327dd41afd9 100644 --- a/clients/client-resource-groups-tagging-api/commands/GetTagValuesCommand.ts +++ b/clients/client-resource-groups-tagging-api/commands/GetTagValuesCommand.ts @@ -24,6 +24,10 @@ import { export type GetTagValuesCommandInput = GetTagValuesInput; export type GetTagValuesCommandOutput = GetTagValuesOutput & __MetadataBearer; +/** + *

Returns all tag values for the specified key in the specified Region for the AWS + * account.

+ */ export class GetTagValuesCommand extends $Command< GetTagValuesCommandInput, GetTagValuesCommandOutput, @@ -38,6 +42,9 @@ export class GetTagValuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsTaggingAPIClientResolvedConfig, diff --git a/clients/client-resource-groups-tagging-api/commands/StartReportCreationCommand.ts b/clients/client-resource-groups-tagging-api/commands/StartReportCreationCommand.ts index 346504c9ffefe..89120be16dcd2 100644 --- a/clients/client-resource-groups-tagging-api/commands/StartReportCreationCommand.ts +++ b/clients/client-resource-groups-tagging-api/commands/StartReportCreationCommand.ts @@ -24,6 +24,16 @@ import { export type StartReportCreationCommandInput = StartReportCreationInput; export type StartReportCreationCommandOutput = StartReportCreationOutput & __MetadataBearer; +/** + *

Generates a report that lists all tagged resources in accounts across your + * organization and tells whether each resource is compliant with the effective tag policy. + * Compliance data is refreshed daily.

+ *

The generated report is saved to the following location:

+ *

+ * s3://example-bucket/AwsTagPolicies/o-exampleorgid/YYYY-MM-ddTHH:mm:ssZ/report.csv + *

+ *

You can call this operation only from the organization's master account and from the us-east-1 Region.

+ */ export class StartReportCreationCommand extends $Command< StartReportCreationCommandInput, StartReportCreationCommandOutput, @@ -38,6 +48,9 @@ export class StartReportCreationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsTaggingAPIClientResolvedConfig, diff --git a/clients/client-resource-groups-tagging-api/commands/TagResourcesCommand.ts b/clients/client-resource-groups-tagging-api/commands/TagResourcesCommand.ts index dff7a6669449d..307785a26a9fa 100644 --- a/clients/client-resource-groups-tagging-api/commands/TagResourcesCommand.ts +++ b/clients/client-resource-groups-tagging-api/commands/TagResourcesCommand.ts @@ -24,6 +24,36 @@ import { export type TagResourcesCommandInput = TagResourcesInput; export type TagResourcesCommandOutput = TagResourcesOutput & __MetadataBearer; +/** + *

Applies one or more tags to the specified resources. Note the following:

+ *
    + *
  • + *

    Not all resources can have tags. For a list of services that support tagging, + * see this list.

    + *
  • + *
  • + *

    Each resource can have up to 50 tags. For other limits, see Tag Naming and Usage + * Conventions in the AWS General + * Reference. + *

    + *
  • + *
  • + *

    You can only tag resources that are located in the specified Region for the + * AWS account.

    + *
  • + *
  • + *

    To add tags to a resource, you need the necessary permissions for the service + * that the resource belongs to as well as permissions for adding tags. For more + * information, see this list.

    + *
  • + *
+ * + *

Do not store personally identifiable information (PII) or other confidential or + * sensitive information in tags. We use tags to provide you with billing and + * administration services. Tags are not intended to be used for private or sensitive + * data.

+ *
+ */ export class TagResourcesCommand extends $Command< TagResourcesCommandInput, TagResourcesCommandOutput, @@ -38,6 +68,9 @@ export class TagResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsTaggingAPIClientResolvedConfig, diff --git a/clients/client-resource-groups-tagging-api/commands/UntagResourcesCommand.ts b/clients/client-resource-groups-tagging-api/commands/UntagResourcesCommand.ts index b09eefc04fed0..d56df0a79eecc 100644 --- a/clients/client-resource-groups-tagging-api/commands/UntagResourcesCommand.ts +++ b/clients/client-resource-groups-tagging-api/commands/UntagResourcesCommand.ts @@ -24,6 +24,23 @@ import { export type UntagResourcesCommandInput = UntagResourcesInput; export type UntagResourcesCommandOutput = UntagResourcesOutput & __MetadataBearer; +/** + *

Removes the specified tags from the specified resources. When you specify a tag key, + * the action removes both that key and its associated value. The operation succeeds even + * if you attempt to remove tags from a resource that were already removed. Note the + * following:

+ *
    + *
  • + *

    To remove tags from a resource, you need the necessary permissions for the + * service that the resource belongs to as well as permissions for removing tags. + * For more information, see this list.

    + *
  • + *
  • + *

    You can only tag resources that are located in the specified Region for the + * AWS account.

    + *
  • + *
+ */ export class UntagResourcesCommand extends $Command< UntagResourcesCommandInput, UntagResourcesCommandOutput, @@ -38,6 +55,9 @@ export class UntagResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsTaggingAPIClientResolvedConfig, diff --git a/clients/client-resource-groups-tagging-api/package.json b/clients/client-resource-groups-tagging-api/package.json index 718217c92b940..ff7a29fe54574 100644 --- a/clients/client-resource-groups-tagging-api/package.json +++ b/clients/client-resource-groups-tagging-api/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Resource Groups Tagging Api Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-resource-groups-tagging-api/pagination/GetComplianceSummaryPaginator.ts b/clients/client-resource-groups-tagging-api/pagination/GetComplianceSummaryPaginator.ts index d943a50160fac..cf3d4ceec7b9c 100644 --- a/clients/client-resource-groups-tagging-api/pagination/GetComplianceSummaryPaginator.ts +++ b/clients/client-resource-groups-tagging-api/pagination/GetComplianceSummaryPaginator.ts @@ -8,6 +8,9 @@ import { import { ResourceGroupsTaggingAPIPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ResourceGroupsTaggingAPIClient, input: GetComplianceSummaryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetComplianceSummaryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ResourceGroupsTaggingAPI, input: GetComplianceSummaryCommandInput, diff --git a/clients/client-resource-groups-tagging-api/pagination/GetResourcesPaginator.ts b/clients/client-resource-groups-tagging-api/pagination/GetResourcesPaginator.ts index dbe6dd05edf66..cd6a2fec13ae1 100644 --- a/clients/client-resource-groups-tagging-api/pagination/GetResourcesPaginator.ts +++ b/clients/client-resource-groups-tagging-api/pagination/GetResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { ResourceGroupsTaggingAPIPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ResourceGroupsTaggingAPIClient, input: GetResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ResourceGroupsTaggingAPI, input: GetResourcesCommandInput, diff --git a/clients/client-resource-groups-tagging-api/pagination/GetTagKeysPaginator.ts b/clients/client-resource-groups-tagging-api/pagination/GetTagKeysPaginator.ts index db5e8d7c422d7..2345e141f228b 100644 --- a/clients/client-resource-groups-tagging-api/pagination/GetTagKeysPaginator.ts +++ b/clients/client-resource-groups-tagging-api/pagination/GetTagKeysPaginator.ts @@ -4,6 +4,9 @@ import { GetTagKeysCommand, GetTagKeysCommandInput, GetTagKeysCommandOutput } fr import { ResourceGroupsTaggingAPIPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ResourceGroupsTaggingAPIClient, input: GetTagKeysCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTagKeysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ResourceGroupsTaggingAPI, input: GetTagKeysCommandInput, diff --git a/clients/client-resource-groups-tagging-api/pagination/GetTagValuesPaginator.ts b/clients/client-resource-groups-tagging-api/pagination/GetTagValuesPaginator.ts index f28d35a156e6d..066e19e2710f6 100644 --- a/clients/client-resource-groups-tagging-api/pagination/GetTagValuesPaginator.ts +++ b/clients/client-resource-groups-tagging-api/pagination/GetTagValuesPaginator.ts @@ -8,6 +8,9 @@ import { import { ResourceGroupsTaggingAPIPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ResourceGroupsTaggingAPIClient, input: GetTagValuesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTagValuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ResourceGroupsTaggingAPI, input: GetTagValuesCommandInput, diff --git a/clients/client-resource-groups-tagging-api/runtimeConfig.browser.ts b/clients/client-resource-groups-tagging-api/runtimeConfig.browser.ts index f0e5786d24814..84a253efcd85f 100644 --- a/clients/client-resource-groups-tagging-api/runtimeConfig.browser.ts +++ b/clients/client-resource-groups-tagging-api/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ResourceGroupsTaggingAPIClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-resource-groups-tagging-api/runtimeConfig.native.ts b/clients/client-resource-groups-tagging-api/runtimeConfig.native.ts index 516ccfe7427bd..48a22bdedd23f 100644 --- a/clients/client-resource-groups-tagging-api/runtimeConfig.native.ts +++ b/clients/client-resource-groups-tagging-api/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ResourceGroupsTaggingAPIClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-resource-groups-tagging-api/runtimeConfig.shared.ts b/clients/client-resource-groups-tagging-api/runtimeConfig.shared.ts index 2870b0d6d0553..7ad941902fd07 100644 --- a/clients/client-resource-groups-tagging-api/runtimeConfig.shared.ts +++ b/clients/client-resource-groups-tagging-api/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-01-26", disableHostPrefix: false, diff --git a/clients/client-resource-groups-tagging-api/runtimeConfig.ts b/clients/client-resource-groups-tagging-api/runtimeConfig.ts index af1cabd7e3b77..53d23d89f3d7d 100644 --- a/clients/client-resource-groups-tagging-api/runtimeConfig.ts +++ b/clients/client-resource-groups-tagging-api/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ResourceGroupsTaggingAPIClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-resource-groups-tagging-api/tsconfig.json b/clients/client-resource-groups-tagging-api/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-resource-groups-tagging-api/tsconfig.json +++ b/clients/client-resource-groups-tagging-api/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-resource-groups/commands/CreateGroupCommand.ts b/clients/client-resource-groups/commands/CreateGroupCommand.ts index ccac8812015f0..94987004c2ba4 100644 --- a/clients/client-resource-groups/commands/CreateGroupCommand.ts +++ b/clients/client-resource-groups/commands/CreateGroupCommand.ts @@ -20,6 +20,10 @@ import { export type CreateGroupCommandInput = CreateGroupInput; export type CreateGroupCommandOutput = CreateGroupOutput & __MetadataBearer; +/** + *

Creates a resource group with the specified name and description. You can optionally + * include a resource query, or a service configuration.

+ */ export class CreateGroupCommand extends $Command< CreateGroupCommandInput, CreateGroupCommandOutput, @@ -34,6 +38,9 @@ export class CreateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/DeleteGroupCommand.ts b/clients/client-resource-groups/commands/DeleteGroupCommand.ts index 887ab3d7a0479..2fd06472c4d4b 100644 --- a/clients/client-resource-groups/commands/DeleteGroupCommand.ts +++ b/clients/client-resource-groups/commands/DeleteGroupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteGroupCommandInput = DeleteGroupInput; export type DeleteGroupCommandOutput = DeleteGroupOutput & __MetadataBearer; +/** + *

Deletes the specified resource group. Deleting a resource group does not delete any + * resources that are members of the group; it only deletes the group structure.

+ */ export class DeleteGroupCommand extends $Command< DeleteGroupCommandInput, DeleteGroupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/GetGroupCommand.ts b/clients/client-resource-groups/commands/GetGroupCommand.ts index 3a1d01a20f7b5..8e7c972f8fadc 100644 --- a/clients/client-resource-groups/commands/GetGroupCommand.ts +++ b/clients/client-resource-groups/commands/GetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupCommandInput = GetGroupInput; export type GetGroupCommandOutput = GetGroupOutput & __MetadataBearer; +/** + *

Returns information about a specified resource group.

+ */ export class GetGroupCommand extends $Command< GetGroupCommandInput, GetGroupCommandOutput, @@ -34,6 +37,9 @@ export class GetGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/GetGroupConfigurationCommand.ts b/clients/client-resource-groups/commands/GetGroupConfigurationCommand.ts index c5d589b5698e2..8a04303b013fd 100644 --- a/clients/client-resource-groups/commands/GetGroupConfigurationCommand.ts +++ b/clients/client-resource-groups/commands/GetGroupConfigurationCommand.ts @@ -20,6 +20,18 @@ import { export type GetGroupConfigurationCommandInput = GetGroupConfigurationInput; export type GetGroupConfigurationCommandOutput = GetGroupConfigurationOutput & __MetadataBearer; +/** + *

Returns the service configuration associated with the specified resource group. AWS + * Resource Groups supports configurations for the following resource group types:

+ * + */ export class GetGroupConfigurationCommand extends $Command< GetGroupConfigurationCommandInput, GetGroupConfigurationCommandOutput, @@ -34,6 +46,9 @@ export class GetGroupConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/GetGroupQueryCommand.ts b/clients/client-resource-groups/commands/GetGroupQueryCommand.ts index ed6da5f2e3751..8571d575540f2 100644 --- a/clients/client-resource-groups/commands/GetGroupQueryCommand.ts +++ b/clients/client-resource-groups/commands/GetGroupQueryCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupQueryCommandInput = GetGroupQueryInput; export type GetGroupQueryCommandOutput = GetGroupQueryOutput & __MetadataBearer; +/** + *

Retrieves the resource query associated with the specified resource group.

+ */ export class GetGroupQueryCommand extends $Command< GetGroupQueryCommandInput, GetGroupQueryCommandOutput, @@ -34,6 +37,9 @@ export class GetGroupQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/GetTagsCommand.ts b/clients/client-resource-groups/commands/GetTagsCommand.ts index aacb4e393fb8c..4025ec41e0154 100644 --- a/clients/client-resource-groups/commands/GetTagsCommand.ts +++ b/clients/client-resource-groups/commands/GetTagsCommand.ts @@ -20,6 +20,10 @@ import { export type GetTagsCommandInput = GetTagsInput; export type GetTagsCommandOutput = GetTagsOutput & __MetadataBearer; +/** + *

Returns a list of tags that are associated with a resource group, specified by an + * ARN.

+ */ export class GetTagsCommand extends $Command< GetTagsCommandInput, GetTagsCommandOutput, @@ -34,6 +38,9 @@ export class GetTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/GroupResourcesCommand.ts b/clients/client-resource-groups/commands/GroupResourcesCommand.ts index ec0b727218bac..2ce5021b5fd81 100644 --- a/clients/client-resource-groups/commands/GroupResourcesCommand.ts +++ b/clients/client-resource-groups/commands/GroupResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type GroupResourcesCommandInput = GroupResourcesInput; export type GroupResourcesCommandOutput = GroupResourcesOutput & __MetadataBearer; +/** + *

Adds the specified resources to the specified group.

+ */ export class GroupResourcesCommand extends $Command< GroupResourcesCommandInput, GroupResourcesCommandOutput, @@ -34,6 +37,9 @@ export class GroupResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/ListGroupResourcesCommand.ts b/clients/client-resource-groups/commands/ListGroupResourcesCommand.ts index 11edf1fe31730..495aef0febcbf 100644 --- a/clients/client-resource-groups/commands/ListGroupResourcesCommand.ts +++ b/clients/client-resource-groups/commands/ListGroupResourcesCommand.ts @@ -20,6 +20,10 @@ import { export type ListGroupResourcesCommandInput = ListGroupResourcesInput; export type ListGroupResourcesCommandOutput = ListGroupResourcesOutput & __MetadataBearer; +/** + *

Returns a list of ARNs of the resources that are members of a specified resource + * group.

+ */ export class ListGroupResourcesCommand extends $Command< ListGroupResourcesCommandInput, ListGroupResourcesCommandOutput, @@ -34,6 +38,9 @@ export class ListGroupResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/ListGroupsCommand.ts b/clients/client-resource-groups/commands/ListGroupsCommand.ts index ce848d5d5036a..c78337a158b42 100644 --- a/clients/client-resource-groups/commands/ListGroupsCommand.ts +++ b/clients/client-resource-groups/commands/ListGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroupsCommandInput = ListGroupsInput; export type ListGroupsCommandOutput = ListGroupsOutput & __MetadataBearer; +/** + *

Returns a list of existing resource groups in your account.

+ */ export class ListGroupsCommand extends $Command< ListGroupsCommandInput, ListGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/SearchResourcesCommand.ts b/clients/client-resource-groups/commands/SearchResourcesCommand.ts index bde75ad27cde9..a996fdaededdd 100644 --- a/clients/client-resource-groups/commands/SearchResourcesCommand.ts +++ b/clients/client-resource-groups/commands/SearchResourcesCommand.ts @@ -20,6 +20,11 @@ import { export type SearchResourcesCommandInput = SearchResourcesInput; export type SearchResourcesCommandOutput = SearchResourcesOutput & __MetadataBearer; +/** + *

Returns a list of AWS resource identifiers that matches the specified query. The + * query uses the same format as a resource query in a CreateGroup or UpdateGroupQuery + * operation.

+ */ export class SearchResourcesCommand extends $Command< SearchResourcesCommandInput, SearchResourcesCommandOutput, @@ -34,6 +39,9 @@ export class SearchResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/TagCommand.ts b/clients/client-resource-groups/commands/TagCommand.ts index 2be293738448a..aeb5b1e068633 100644 --- a/clients/client-resource-groups/commands/TagCommand.ts +++ b/clients/client-resource-groups/commands/TagCommand.ts @@ -17,6 +17,16 @@ import { export type TagCommandInput = TagInput; export type TagCommandOutput = TagOutput & __MetadataBearer; +/** + *

Adds tags to a resource group with the specified ARN. Existing tags on a resource + * group are not changed if they are not specified in the request parameters.

+ * + *

Do not store personally identifiable information (PII) or other confidential or + * sensitive information in tags. We use tags to provide you with billing and + * administration services. Tags are not intended to be used for private or sensitive + * data.

+ *
+ */ export class TagCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +37,9 @@ export class TagCommand extends $Command, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/UngroupResourcesCommand.ts b/clients/client-resource-groups/commands/UngroupResourcesCommand.ts index 5622c9bc496ea..2c987c575e1f2 100644 --- a/clients/client-resource-groups/commands/UngroupResourcesCommand.ts +++ b/clients/client-resource-groups/commands/UngroupResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type UngroupResourcesCommandInput = UngroupResourcesInput; export type UngroupResourcesCommandOutput = UngroupResourcesOutput & __MetadataBearer; +/** + *

Removes the specified resources from the specified group.

+ */ export class UngroupResourcesCommand extends $Command< UngroupResourcesCommandInput, UngroupResourcesCommandOutput, @@ -34,6 +37,9 @@ export class UngroupResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/UntagCommand.ts b/clients/client-resource-groups/commands/UntagCommand.ts index 8a66cf5d1c21f..583e6f4de790b 100644 --- a/clients/client-resource-groups/commands/UntagCommand.ts +++ b/clients/client-resource-groups/commands/UntagCommand.ts @@ -17,6 +17,9 @@ import { export type UntagCommandInput = UntagInput; export type UntagCommandOutput = UntagOutput & __MetadataBearer; +/** + *

Deletes tags from a specified resource group.

+ */ export class UntagCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class UntagCommand extends $Command, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/UpdateGroupCommand.ts b/clients/client-resource-groups/commands/UpdateGroupCommand.ts index 65a2a51912ef1..daee4befd94e6 100644 --- a/clients/client-resource-groups/commands/UpdateGroupCommand.ts +++ b/clients/client-resource-groups/commands/UpdateGroupCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateGroupCommandInput = UpdateGroupInput; export type UpdateGroupCommandOutput = UpdateGroupOutput & __MetadataBearer; +/** + *

Updates the description for an existing group. You cannot update the name of a + * resource group.

+ */ export class UpdateGroupCommand extends $Command< UpdateGroupCommandInput, UpdateGroupCommandOutput, @@ -34,6 +38,9 @@ export class UpdateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/commands/UpdateGroupQueryCommand.ts b/clients/client-resource-groups/commands/UpdateGroupQueryCommand.ts index 13158679d7a9c..2a34f3a6d80aa 100644 --- a/clients/client-resource-groups/commands/UpdateGroupQueryCommand.ts +++ b/clients/client-resource-groups/commands/UpdateGroupQueryCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGroupQueryCommandInput = UpdateGroupQueryInput; export type UpdateGroupQueryCommandOutput = UpdateGroupQueryOutput & __MetadataBearer; +/** + *

Updates the resource query of a group.

+ */ export class UpdateGroupQueryCommand extends $Command< UpdateGroupQueryCommandInput, UpdateGroupQueryCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGroupQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ResourceGroupsClientResolvedConfig, diff --git a/clients/client-resource-groups/package.json b/clients/client-resource-groups/package.json index 5d85f0075adc2..f6b3589315dae 100644 --- a/clients/client-resource-groups/package.json +++ b/clients/client-resource-groups/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Resource Groups Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-resource-groups/pagination/ListGroupResourcesPaginator.ts b/clients/client-resource-groups/pagination/ListGroupResourcesPaginator.ts index 143b8a4895654..d8586f85f9276 100644 --- a/clients/client-resource-groups/pagination/ListGroupResourcesPaginator.ts +++ b/clients/client-resource-groups/pagination/ListGroupResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { ResourceGroupsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ResourceGroupsClient, input: ListGroupResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ResourceGroups, input: ListGroupResourcesCommandInput, diff --git a/clients/client-resource-groups/pagination/ListGroupsPaginator.ts b/clients/client-resource-groups/pagination/ListGroupsPaginator.ts index 646d8b30698e9..03762cb86b39e 100644 --- a/clients/client-resource-groups/pagination/ListGroupsPaginator.ts +++ b/clients/client-resource-groups/pagination/ListGroupsPaginator.ts @@ -4,6 +4,9 @@ import { ListGroupsCommand, ListGroupsCommandInput, ListGroupsCommandOutput } fr import { ResourceGroupsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ResourceGroupsClient, input: ListGroupsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ResourceGroups, input: ListGroupsCommandInput, diff --git a/clients/client-resource-groups/pagination/SearchResourcesPaginator.ts b/clients/client-resource-groups/pagination/SearchResourcesPaginator.ts index 31209dd6af835..320d4c77ba82e 100644 --- a/clients/client-resource-groups/pagination/SearchResourcesPaginator.ts +++ b/clients/client-resource-groups/pagination/SearchResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { ResourceGroupsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ResourceGroupsClient, input: SearchResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ResourceGroups, input: SearchResourcesCommandInput, diff --git a/clients/client-resource-groups/runtimeConfig.browser.ts b/clients/client-resource-groups/runtimeConfig.browser.ts index c8a641a511946..5b5da46362caf 100644 --- a/clients/client-resource-groups/runtimeConfig.browser.ts +++ b/clients/client-resource-groups/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ResourceGroupsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-resource-groups/runtimeConfig.native.ts b/clients/client-resource-groups/runtimeConfig.native.ts index 410c930eb8aeb..2becb0f1bae9a 100644 --- a/clients/client-resource-groups/runtimeConfig.native.ts +++ b/clients/client-resource-groups/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ResourceGroupsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-resource-groups/runtimeConfig.shared.ts b/clients/client-resource-groups/runtimeConfig.shared.ts index 29134ce453848..4b80bae7bfd01 100644 --- a/clients/client-resource-groups/runtimeConfig.shared.ts +++ b/clients/client-resource-groups/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-11-27", disableHostPrefix: false, diff --git a/clients/client-resource-groups/runtimeConfig.ts b/clients/client-resource-groups/runtimeConfig.ts index 5e0ebd30479af..566747c107bd1 100644 --- a/clients/client-resource-groups/runtimeConfig.ts +++ b/clients/client-resource-groups/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ResourceGroupsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-resource-groups/tsconfig.json b/clients/client-resource-groups/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-resource-groups/tsconfig.json +++ b/clients/client-resource-groups/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-robomaker/commands/BatchDeleteWorldsCommand.ts b/clients/client-robomaker/commands/BatchDeleteWorldsCommand.ts index e3c2dfb04938e..3f550284b9932 100644 --- a/clients/client-robomaker/commands/BatchDeleteWorldsCommand.ts +++ b/clients/client-robomaker/commands/BatchDeleteWorldsCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDeleteWorldsCommandInput = BatchDeleteWorldsRequest; export type BatchDeleteWorldsCommandOutput = BatchDeleteWorldsResponse & __MetadataBearer; +/** + *

Deletes one or more worlds in a batch operation.

+ */ export class BatchDeleteWorldsCommand extends $Command< BatchDeleteWorldsCommandInput, BatchDeleteWorldsCommandOutput, @@ -34,6 +37,9 @@ export class BatchDeleteWorldsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/BatchDescribeSimulationJobCommand.ts b/clients/client-robomaker/commands/BatchDescribeSimulationJobCommand.ts index 4516049a8cfb8..25885ed491be8 100644 --- a/clients/client-robomaker/commands/BatchDescribeSimulationJobCommand.ts +++ b/clients/client-robomaker/commands/BatchDescribeSimulationJobCommand.ts @@ -20,6 +20,9 @@ import { export type BatchDescribeSimulationJobCommandInput = BatchDescribeSimulationJobRequest; export type BatchDescribeSimulationJobCommandOutput = BatchDescribeSimulationJobResponse & __MetadataBearer; +/** + *

Describes one or more simulation jobs.

+ */ export class BatchDescribeSimulationJobCommand extends $Command< BatchDescribeSimulationJobCommandInput, BatchDescribeSimulationJobCommandOutput, @@ -34,6 +37,9 @@ export class BatchDescribeSimulationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CancelDeploymentJobCommand.ts b/clients/client-robomaker/commands/CancelDeploymentJobCommand.ts index 86159ee70dacf..000fe96e34bfb 100644 --- a/clients/client-robomaker/commands/CancelDeploymentJobCommand.ts +++ b/clients/client-robomaker/commands/CancelDeploymentJobCommand.ts @@ -20,6 +20,9 @@ import { export type CancelDeploymentJobCommandInput = CancelDeploymentJobRequest; export type CancelDeploymentJobCommandOutput = CancelDeploymentJobResponse & __MetadataBearer; +/** + *

Cancels the specified deployment job.

+ */ export class CancelDeploymentJobCommand extends $Command< CancelDeploymentJobCommandInput, CancelDeploymentJobCommandOutput, @@ -34,6 +37,9 @@ export class CancelDeploymentJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CancelSimulationJobBatchCommand.ts b/clients/client-robomaker/commands/CancelSimulationJobBatchCommand.ts index dbaed6a44ae2f..537f87d41b28d 100644 --- a/clients/client-robomaker/commands/CancelSimulationJobBatchCommand.ts +++ b/clients/client-robomaker/commands/CancelSimulationJobBatchCommand.ts @@ -20,6 +20,12 @@ import { export type CancelSimulationJobBatchCommandInput = CancelSimulationJobBatchRequest; export type CancelSimulationJobBatchCommandOutput = CancelSimulationJobBatchResponse & __MetadataBearer; +/** + *

Cancels a simulation job batch. When you cancel a simulation job batch, + * you are also cancelling all of the active simulation jobs created as part of + * the batch. + *

+ */ export class CancelSimulationJobBatchCommand extends $Command< CancelSimulationJobBatchCommandInput, CancelSimulationJobBatchCommandOutput, @@ -34,6 +40,9 @@ export class CancelSimulationJobBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CancelSimulationJobCommand.ts b/clients/client-robomaker/commands/CancelSimulationJobCommand.ts index 0f135ddfda976..a6671f97b6a7f 100644 --- a/clients/client-robomaker/commands/CancelSimulationJobCommand.ts +++ b/clients/client-robomaker/commands/CancelSimulationJobCommand.ts @@ -20,6 +20,9 @@ import { export type CancelSimulationJobCommandInput = CancelSimulationJobRequest; export type CancelSimulationJobCommandOutput = CancelSimulationJobResponse & __MetadataBearer; +/** + *

Cancels the specified simulation job.

+ */ export class CancelSimulationJobCommand extends $Command< CancelSimulationJobCommandInput, CancelSimulationJobCommandOutput, @@ -34,6 +37,9 @@ export class CancelSimulationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CancelWorldExportJobCommand.ts b/clients/client-robomaker/commands/CancelWorldExportJobCommand.ts index b5a6438dcb9c6..48a7aeb084e54 100644 --- a/clients/client-robomaker/commands/CancelWorldExportJobCommand.ts +++ b/clients/client-robomaker/commands/CancelWorldExportJobCommand.ts @@ -20,6 +20,9 @@ import { export type CancelWorldExportJobCommandInput = CancelWorldExportJobRequest; export type CancelWorldExportJobCommandOutput = CancelWorldExportJobResponse & __MetadataBearer; +/** + *

Cancels the specified export job.

+ */ export class CancelWorldExportJobCommand extends $Command< CancelWorldExportJobCommandInput, CancelWorldExportJobCommandOutput, @@ -34,6 +37,9 @@ export class CancelWorldExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CancelWorldGenerationJobCommand.ts b/clients/client-robomaker/commands/CancelWorldGenerationJobCommand.ts index 1e8fae58b3fae..db45b7c79cfa4 100644 --- a/clients/client-robomaker/commands/CancelWorldGenerationJobCommand.ts +++ b/clients/client-robomaker/commands/CancelWorldGenerationJobCommand.ts @@ -20,6 +20,9 @@ import { export type CancelWorldGenerationJobCommandInput = CancelWorldGenerationJobRequest; export type CancelWorldGenerationJobCommandOutput = CancelWorldGenerationJobResponse & __MetadataBearer; +/** + *

Cancels the specified world generator job.

+ */ export class CancelWorldGenerationJobCommand extends $Command< CancelWorldGenerationJobCommandInput, CancelWorldGenerationJobCommandOutput, @@ -34,6 +37,9 @@ export class CancelWorldGenerationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateDeploymentJobCommand.ts b/clients/client-robomaker/commands/CreateDeploymentJobCommand.ts index a3f33f15f667c..1933f1dcab751 100644 --- a/clients/client-robomaker/commands/CreateDeploymentJobCommand.ts +++ b/clients/client-robomaker/commands/CreateDeploymentJobCommand.ts @@ -20,6 +20,17 @@ import { export type CreateDeploymentJobCommandInput = CreateDeploymentJobRequest; export type CreateDeploymentJobCommandOutput = CreateDeploymentJobResponse & __MetadataBearer; +/** + *

Deploys a specific version of a robot application to robots in a fleet.

+ *

The robot application must have a numbered applicationVersion + * for consistency reasons. To create a new version, use CreateRobotApplicationVersion + * or see Creating a Robot Application Version. + *

+ * + *

After 90 days, deployment jobs expire and will be deleted. They will no longer be accessible. + *

+ *
+ */ export class CreateDeploymentJobCommand extends $Command< CreateDeploymentJobCommandInput, CreateDeploymentJobCommandOutput, @@ -34,6 +45,9 @@ export class CreateDeploymentJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateFleetCommand.ts b/clients/client-robomaker/commands/CreateFleetCommand.ts index 44b5b193f094b..aa317f9674d37 100644 --- a/clients/client-robomaker/commands/CreateFleetCommand.ts +++ b/clients/client-robomaker/commands/CreateFleetCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFleetCommandInput = CreateFleetRequest; export type CreateFleetCommandOutput = CreateFleetResponse & __MetadataBearer; +/** + *

Creates a fleet, a logical group of robots running the same robot application.

+ */ export class CreateFleetCommand extends $Command< CreateFleetCommandInput, CreateFleetCommandOutput, @@ -34,6 +37,9 @@ export class CreateFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateRobotApplicationCommand.ts b/clients/client-robomaker/commands/CreateRobotApplicationCommand.ts index ebb4a1dbb1dcc..2c99a76aa662b 100644 --- a/clients/client-robomaker/commands/CreateRobotApplicationCommand.ts +++ b/clients/client-robomaker/commands/CreateRobotApplicationCommand.ts @@ -20,6 +20,10 @@ import { export type CreateRobotApplicationCommandInput = CreateRobotApplicationRequest; export type CreateRobotApplicationCommandOutput = CreateRobotApplicationResponse & __MetadataBearer; +/** + *

Creates a robot application. + *

+ */ export class CreateRobotApplicationCommand extends $Command< CreateRobotApplicationCommandInput, CreateRobotApplicationCommandOutput, @@ -34,6 +38,9 @@ export class CreateRobotApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateRobotApplicationVersionCommand.ts b/clients/client-robomaker/commands/CreateRobotApplicationVersionCommand.ts index 0a065016a1366..40c6a1d503f22 100644 --- a/clients/client-robomaker/commands/CreateRobotApplicationVersionCommand.ts +++ b/clients/client-robomaker/commands/CreateRobotApplicationVersionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRobotApplicationVersionCommandInput = CreateRobotApplicationVersionRequest; export type CreateRobotApplicationVersionCommandOutput = CreateRobotApplicationVersionResponse & __MetadataBearer; +/** + *

Creates a version of a robot application.

+ */ export class CreateRobotApplicationVersionCommand extends $Command< CreateRobotApplicationVersionCommandInput, CreateRobotApplicationVersionCommandOutput, @@ -34,6 +37,9 @@ export class CreateRobotApplicationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateRobotCommand.ts b/clients/client-robomaker/commands/CreateRobotCommand.ts index 1e3e060f71976..f4a1c82a3f648 100644 --- a/clients/client-robomaker/commands/CreateRobotCommand.ts +++ b/clients/client-robomaker/commands/CreateRobotCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRobotCommandInput = CreateRobotRequest; export type CreateRobotCommandOutput = CreateRobotResponse & __MetadataBearer; +/** + *

Creates a robot.

+ */ export class CreateRobotCommand extends $Command< CreateRobotCommandInput, CreateRobotCommandOutput, @@ -34,6 +37,9 @@ export class CreateRobotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateSimulationApplicationCommand.ts b/clients/client-robomaker/commands/CreateSimulationApplicationCommand.ts index 44dd2bf690ab5..2027a08f573cd 100644 --- a/clients/client-robomaker/commands/CreateSimulationApplicationCommand.ts +++ b/clients/client-robomaker/commands/CreateSimulationApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSimulationApplicationCommandInput = CreateSimulationApplicationRequest; export type CreateSimulationApplicationCommandOutput = CreateSimulationApplicationResponse & __MetadataBearer; +/** + *

Creates a simulation application.

+ */ export class CreateSimulationApplicationCommand extends $Command< CreateSimulationApplicationCommandInput, CreateSimulationApplicationCommandOutput, @@ -34,6 +37,9 @@ export class CreateSimulationApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateSimulationApplicationVersionCommand.ts b/clients/client-robomaker/commands/CreateSimulationApplicationVersionCommand.ts index ca607bb5c9301..afbc59849452e 100644 --- a/clients/client-robomaker/commands/CreateSimulationApplicationVersionCommand.ts +++ b/clients/client-robomaker/commands/CreateSimulationApplicationVersionCommand.ts @@ -24,6 +24,9 @@ export type CreateSimulationApplicationVersionCommandInput = CreateSimulationApp export type CreateSimulationApplicationVersionCommandOutput = CreateSimulationApplicationVersionResponse & __MetadataBearer; +/** + *

Creates a simulation application with a specific revision id.

+ */ export class CreateSimulationApplicationVersionCommand extends $Command< CreateSimulationApplicationVersionCommandInput, CreateSimulationApplicationVersionCommandOutput, @@ -38,6 +41,9 @@ export class CreateSimulationApplicationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateSimulationJobCommand.ts b/clients/client-robomaker/commands/CreateSimulationJobCommand.ts index 14e038e176c38..d0374a62a6891 100644 --- a/clients/client-robomaker/commands/CreateSimulationJobCommand.ts +++ b/clients/client-robomaker/commands/CreateSimulationJobCommand.ts @@ -20,6 +20,13 @@ import { export type CreateSimulationJobCommandInput = CreateSimulationJobRequest; export type CreateSimulationJobCommandOutput = CreateSimulationJobResponse & __MetadataBearer; +/** + *

Creates a simulation job.

+ * + *

After 90 days, simulation jobs expire and will be deleted. They will no longer be accessible. + *

+ *
+ */ export class CreateSimulationJobCommand extends $Command< CreateSimulationJobCommandInput, CreateSimulationJobCommandOutput, @@ -34,6 +41,9 @@ export class CreateSimulationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateWorldExportJobCommand.ts b/clients/client-robomaker/commands/CreateWorldExportJobCommand.ts index cf2d3b6f08dcb..5ce6a57373b14 100644 --- a/clients/client-robomaker/commands/CreateWorldExportJobCommand.ts +++ b/clients/client-robomaker/commands/CreateWorldExportJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateWorldExportJobCommandInput = CreateWorldExportJobRequest; export type CreateWorldExportJobCommandOutput = CreateWorldExportJobResponse & __MetadataBearer; +/** + *

Creates a world export job.

+ */ export class CreateWorldExportJobCommand extends $Command< CreateWorldExportJobCommandInput, CreateWorldExportJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateWorldExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateWorldGenerationJobCommand.ts b/clients/client-robomaker/commands/CreateWorldGenerationJobCommand.ts index 730cff007f73a..6ea91842ada59 100644 --- a/clients/client-robomaker/commands/CreateWorldGenerationJobCommand.ts +++ b/clients/client-robomaker/commands/CreateWorldGenerationJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateWorldGenerationJobCommandInput = CreateWorldGenerationJobRequest; export type CreateWorldGenerationJobCommandOutput = CreateWorldGenerationJobResponse & __MetadataBearer; +/** + *

Creates worlds using the specified template.

+ */ export class CreateWorldGenerationJobCommand extends $Command< CreateWorldGenerationJobCommandInput, CreateWorldGenerationJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateWorldGenerationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/CreateWorldTemplateCommand.ts b/clients/client-robomaker/commands/CreateWorldTemplateCommand.ts index 305e96db78825..b82827f75c9f6 100644 --- a/clients/client-robomaker/commands/CreateWorldTemplateCommand.ts +++ b/clients/client-robomaker/commands/CreateWorldTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type CreateWorldTemplateCommandInput = CreateWorldTemplateRequest; export type CreateWorldTemplateCommandOutput = CreateWorldTemplateResponse & __MetadataBearer; +/** + *

Creates a world template.

+ */ export class CreateWorldTemplateCommand extends $Command< CreateWorldTemplateCommandInput, CreateWorldTemplateCommandOutput, @@ -34,6 +37,9 @@ export class CreateWorldTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DeleteFleetCommand.ts b/clients/client-robomaker/commands/DeleteFleetCommand.ts index 48f746aafcccd..a116035c313f1 100644 --- a/clients/client-robomaker/commands/DeleteFleetCommand.ts +++ b/clients/client-robomaker/commands/DeleteFleetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFleetCommandInput = DeleteFleetRequest; export type DeleteFleetCommandOutput = DeleteFleetResponse & __MetadataBearer; +/** + *

Deletes a fleet.

+ */ export class DeleteFleetCommand extends $Command< DeleteFleetCommandInput, DeleteFleetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DeleteRobotApplicationCommand.ts b/clients/client-robomaker/commands/DeleteRobotApplicationCommand.ts index 5b5482ef4653f..d41fc1b572def 100644 --- a/clients/client-robomaker/commands/DeleteRobotApplicationCommand.ts +++ b/clients/client-robomaker/commands/DeleteRobotApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRobotApplicationCommandInput = DeleteRobotApplicationRequest; export type DeleteRobotApplicationCommandOutput = DeleteRobotApplicationResponse & __MetadataBearer; +/** + *

Deletes a robot application.

+ */ export class DeleteRobotApplicationCommand extends $Command< DeleteRobotApplicationCommandInput, DeleteRobotApplicationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRobotApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DeleteRobotCommand.ts b/clients/client-robomaker/commands/DeleteRobotCommand.ts index 629288ae259bf..d5830ca4d8dde 100644 --- a/clients/client-robomaker/commands/DeleteRobotCommand.ts +++ b/clients/client-robomaker/commands/DeleteRobotCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRobotCommandInput = DeleteRobotRequest; export type DeleteRobotCommandOutput = DeleteRobotResponse & __MetadataBearer; +/** + *

Deletes a robot.

+ */ export class DeleteRobotCommand extends $Command< DeleteRobotCommandInput, DeleteRobotCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRobotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DeleteSimulationApplicationCommand.ts b/clients/client-robomaker/commands/DeleteSimulationApplicationCommand.ts index dcc1cb1142b5f..cdff322b3b7e7 100644 --- a/clients/client-robomaker/commands/DeleteSimulationApplicationCommand.ts +++ b/clients/client-robomaker/commands/DeleteSimulationApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSimulationApplicationCommandInput = DeleteSimulationApplicationRequest; export type DeleteSimulationApplicationCommandOutput = DeleteSimulationApplicationResponse & __MetadataBearer; +/** + *

Deletes a simulation application.

+ */ export class DeleteSimulationApplicationCommand extends $Command< DeleteSimulationApplicationCommandInput, DeleteSimulationApplicationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSimulationApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DeleteWorldTemplateCommand.ts b/clients/client-robomaker/commands/DeleteWorldTemplateCommand.ts index c2138fc2305c7..fe22fe9c19527 100644 --- a/clients/client-robomaker/commands/DeleteWorldTemplateCommand.ts +++ b/clients/client-robomaker/commands/DeleteWorldTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteWorldTemplateCommandInput = DeleteWorldTemplateRequest; export type DeleteWorldTemplateCommandOutput = DeleteWorldTemplateResponse & __MetadataBearer; +/** + *

Deletes a world template.

+ */ export class DeleteWorldTemplateCommand extends $Command< DeleteWorldTemplateCommandInput, DeleteWorldTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DeleteWorldTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DeregisterRobotCommand.ts b/clients/client-robomaker/commands/DeregisterRobotCommand.ts index 7df4b8a5459d3..008f14654cf49 100644 --- a/clients/client-robomaker/commands/DeregisterRobotCommand.ts +++ b/clients/client-robomaker/commands/DeregisterRobotCommand.ts @@ -20,6 +20,9 @@ import { export type DeregisterRobotCommandInput = DeregisterRobotRequest; export type DeregisterRobotCommandOutput = DeregisterRobotResponse & __MetadataBearer; +/** + *

Deregisters a robot.

+ */ export class DeregisterRobotCommand extends $Command< DeregisterRobotCommandInput, DeregisterRobotCommandOutput, @@ -34,6 +37,9 @@ export class DeregisterRobotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeDeploymentJobCommand.ts b/clients/client-robomaker/commands/DescribeDeploymentJobCommand.ts index 9b6d053c6c054..d0fa05cfc47b2 100644 --- a/clients/client-robomaker/commands/DescribeDeploymentJobCommand.ts +++ b/clients/client-robomaker/commands/DescribeDeploymentJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDeploymentJobCommandInput = DescribeDeploymentJobRequest; export type DescribeDeploymentJobCommandOutput = DescribeDeploymentJobResponse & __MetadataBearer; +/** + *

Describes a deployment job.

+ */ export class DescribeDeploymentJobCommand extends $Command< DescribeDeploymentJobCommandInput, DescribeDeploymentJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDeploymentJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeFleetCommand.ts b/clients/client-robomaker/commands/DescribeFleetCommand.ts index 97bfc74d2e034..1a1357fcc8bd7 100644 --- a/clients/client-robomaker/commands/DescribeFleetCommand.ts +++ b/clients/client-robomaker/commands/DescribeFleetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFleetCommandInput = DescribeFleetRequest; export type DescribeFleetCommandOutput = DescribeFleetResponse & __MetadataBearer; +/** + *

Describes a fleet.

+ */ export class DescribeFleetCommand extends $Command< DescribeFleetCommandInput, DescribeFleetCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeRobotApplicationCommand.ts b/clients/client-robomaker/commands/DescribeRobotApplicationCommand.ts index 481b6e442cca2..d3ccd222adb59 100644 --- a/clients/client-robomaker/commands/DescribeRobotApplicationCommand.ts +++ b/clients/client-robomaker/commands/DescribeRobotApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRobotApplicationCommandInput = DescribeRobotApplicationRequest; export type DescribeRobotApplicationCommandOutput = DescribeRobotApplicationResponse & __MetadataBearer; +/** + *

Describes a robot application.

+ */ export class DescribeRobotApplicationCommand extends $Command< DescribeRobotApplicationCommandInput, DescribeRobotApplicationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRobotApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeRobotCommand.ts b/clients/client-robomaker/commands/DescribeRobotCommand.ts index 233c711dd0259..913e023473a3a 100644 --- a/clients/client-robomaker/commands/DescribeRobotCommand.ts +++ b/clients/client-robomaker/commands/DescribeRobotCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRobotCommandInput = DescribeRobotRequest; export type DescribeRobotCommandOutput = DescribeRobotResponse & __MetadataBearer; +/** + *

Describes a robot.

+ */ export class DescribeRobotCommand extends $Command< DescribeRobotCommandInput, DescribeRobotCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRobotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeSimulationApplicationCommand.ts b/clients/client-robomaker/commands/DescribeSimulationApplicationCommand.ts index ba3342041235c..08d3456f4f8cd 100644 --- a/clients/client-robomaker/commands/DescribeSimulationApplicationCommand.ts +++ b/clients/client-robomaker/commands/DescribeSimulationApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSimulationApplicationCommandInput = DescribeSimulationApplicationRequest; export type DescribeSimulationApplicationCommandOutput = DescribeSimulationApplicationResponse & __MetadataBearer; +/** + *

Describes a simulation application.

+ */ export class DescribeSimulationApplicationCommand extends $Command< DescribeSimulationApplicationCommandInput, DescribeSimulationApplicationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSimulationApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeSimulationJobBatchCommand.ts b/clients/client-robomaker/commands/DescribeSimulationJobBatchCommand.ts index b85d24ecd732d..2a88fb879366b 100644 --- a/clients/client-robomaker/commands/DescribeSimulationJobBatchCommand.ts +++ b/clients/client-robomaker/commands/DescribeSimulationJobBatchCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSimulationJobBatchCommandInput = DescribeSimulationJobBatchRequest; export type DescribeSimulationJobBatchCommandOutput = DescribeSimulationJobBatchResponse & __MetadataBearer; +/** + *

Describes a simulation job batch.

+ */ export class DescribeSimulationJobBatchCommand extends $Command< DescribeSimulationJobBatchCommandInput, DescribeSimulationJobBatchCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSimulationJobBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeSimulationJobCommand.ts b/clients/client-robomaker/commands/DescribeSimulationJobCommand.ts index 0da9bb2f98ae9..4b8155144d592 100644 --- a/clients/client-robomaker/commands/DescribeSimulationJobCommand.ts +++ b/clients/client-robomaker/commands/DescribeSimulationJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSimulationJobCommandInput = DescribeSimulationJobRequest; export type DescribeSimulationJobCommandOutput = DescribeSimulationJobResponse & __MetadataBearer; +/** + *

Describes a simulation job.

+ */ export class DescribeSimulationJobCommand extends $Command< DescribeSimulationJobCommandInput, DescribeSimulationJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSimulationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeWorldCommand.ts b/clients/client-robomaker/commands/DescribeWorldCommand.ts index e2a2fe8682880..fbc28c579ae45 100644 --- a/clients/client-robomaker/commands/DescribeWorldCommand.ts +++ b/clients/client-robomaker/commands/DescribeWorldCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeWorldCommandInput = DescribeWorldRequest; export type DescribeWorldCommandOutput = DescribeWorldResponse & __MetadataBearer; +/** + *

Describes a world.

+ */ export class DescribeWorldCommand extends $Command< DescribeWorldCommandInput, DescribeWorldCommandOutput, @@ -34,6 +37,9 @@ export class DescribeWorldCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeWorldExportJobCommand.ts b/clients/client-robomaker/commands/DescribeWorldExportJobCommand.ts index 2e8c449ecaa52..a4ef688ce0cc8 100644 --- a/clients/client-robomaker/commands/DescribeWorldExportJobCommand.ts +++ b/clients/client-robomaker/commands/DescribeWorldExportJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeWorldExportJobCommandInput = DescribeWorldExportJobRequest; export type DescribeWorldExportJobCommandOutput = DescribeWorldExportJobResponse & __MetadataBearer; +/** + *

Describes a world export job.

+ */ export class DescribeWorldExportJobCommand extends $Command< DescribeWorldExportJobCommandInput, DescribeWorldExportJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeWorldExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeWorldGenerationJobCommand.ts b/clients/client-robomaker/commands/DescribeWorldGenerationJobCommand.ts index a622fa1e5b226..a66ed8892169f 100644 --- a/clients/client-robomaker/commands/DescribeWorldGenerationJobCommand.ts +++ b/clients/client-robomaker/commands/DescribeWorldGenerationJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeWorldGenerationJobCommandInput = DescribeWorldGenerationJobRequest; export type DescribeWorldGenerationJobCommandOutput = DescribeWorldGenerationJobResponse & __MetadataBearer; +/** + *

Describes a world generation job.

+ */ export class DescribeWorldGenerationJobCommand extends $Command< DescribeWorldGenerationJobCommandInput, DescribeWorldGenerationJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeWorldGenerationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/DescribeWorldTemplateCommand.ts b/clients/client-robomaker/commands/DescribeWorldTemplateCommand.ts index 39d0435c7a7dc..5d158b5741f6c 100644 --- a/clients/client-robomaker/commands/DescribeWorldTemplateCommand.ts +++ b/clients/client-robomaker/commands/DescribeWorldTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeWorldTemplateCommandInput = DescribeWorldTemplateRequest; export type DescribeWorldTemplateCommandOutput = DescribeWorldTemplateResponse & __MetadataBearer; +/** + *

Describes a world template.

+ */ export class DescribeWorldTemplateCommand extends $Command< DescribeWorldTemplateCommandInput, DescribeWorldTemplateCommandOutput, @@ -34,6 +37,9 @@ export class DescribeWorldTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/GetWorldTemplateBodyCommand.ts b/clients/client-robomaker/commands/GetWorldTemplateBodyCommand.ts index 17623189ae18f..8550c6c928c5d 100644 --- a/clients/client-robomaker/commands/GetWorldTemplateBodyCommand.ts +++ b/clients/client-robomaker/commands/GetWorldTemplateBodyCommand.ts @@ -20,6 +20,9 @@ import { export type GetWorldTemplateBodyCommandInput = GetWorldTemplateBodyRequest; export type GetWorldTemplateBodyCommandOutput = GetWorldTemplateBodyResponse & __MetadataBearer; +/** + *

Gets the world template body.

+ */ export class GetWorldTemplateBodyCommand extends $Command< GetWorldTemplateBodyCommandInput, GetWorldTemplateBodyCommandOutput, @@ -34,6 +37,9 @@ export class GetWorldTemplateBodyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListDeploymentJobsCommand.ts b/clients/client-robomaker/commands/ListDeploymentJobsCommand.ts index f7ba5f71a5720..55214bf3117d3 100644 --- a/clients/client-robomaker/commands/ListDeploymentJobsCommand.ts +++ b/clients/client-robomaker/commands/ListDeploymentJobsCommand.ts @@ -20,6 +20,11 @@ import { export type ListDeploymentJobsCommandInput = ListDeploymentJobsRequest; export type ListDeploymentJobsCommandOutput = ListDeploymentJobsResponse & __MetadataBearer; +/** + *

Returns a list of deployment jobs for a fleet. You can optionally provide filters to retrieve + * specific deployment jobs. + *

+ */ export class ListDeploymentJobsCommand extends $Command< ListDeploymentJobsCommandInput, ListDeploymentJobsCommandOutput, @@ -34,6 +39,9 @@ export class ListDeploymentJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListFleetsCommand.ts b/clients/client-robomaker/commands/ListFleetsCommand.ts index 4af4f1ccd02ca..56965c8e21674 100644 --- a/clients/client-robomaker/commands/ListFleetsCommand.ts +++ b/clients/client-robomaker/commands/ListFleetsCommand.ts @@ -20,6 +20,10 @@ import { export type ListFleetsCommandInput = ListFleetsRequest; export type ListFleetsCommandOutput = ListFleetsResponse & __MetadataBearer; +/** + *

Returns a list of fleets. You can optionally provide filters to retrieve + * specific fleets.

+ */ export class ListFleetsCommand extends $Command< ListFleetsCommandInput, ListFleetsCommandOutput, @@ -34,6 +38,9 @@ export class ListFleetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListRobotApplicationsCommand.ts b/clients/client-robomaker/commands/ListRobotApplicationsCommand.ts index bb5ba9559a493..b3f1799465a6e 100644 --- a/clients/client-robomaker/commands/ListRobotApplicationsCommand.ts +++ b/clients/client-robomaker/commands/ListRobotApplicationsCommand.ts @@ -20,6 +20,10 @@ import { export type ListRobotApplicationsCommandInput = ListRobotApplicationsRequest; export type ListRobotApplicationsCommandOutput = ListRobotApplicationsResponse & __MetadataBearer; +/** + *

Returns a list of robot application. You can optionally provide filters to retrieve + * specific robot applications.

+ */ export class ListRobotApplicationsCommand extends $Command< ListRobotApplicationsCommandInput, ListRobotApplicationsCommandOutput, @@ -34,6 +38,9 @@ export class ListRobotApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListRobotsCommand.ts b/clients/client-robomaker/commands/ListRobotsCommand.ts index a2d9c8837279c..0a051f3dc8976 100644 --- a/clients/client-robomaker/commands/ListRobotsCommand.ts +++ b/clients/client-robomaker/commands/ListRobotsCommand.ts @@ -20,6 +20,10 @@ import { export type ListRobotsCommandInput = ListRobotsRequest; export type ListRobotsCommandOutput = ListRobotsResponse & __MetadataBearer; +/** + *

Returns a list of robots. You can optionally provide filters to retrieve + * specific robots.

+ */ export class ListRobotsCommand extends $Command< ListRobotsCommandInput, ListRobotsCommandOutput, @@ -34,6 +38,9 @@ export class ListRobotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListSimulationApplicationsCommand.ts b/clients/client-robomaker/commands/ListSimulationApplicationsCommand.ts index 2830f884d0208..136df434d5da4 100644 --- a/clients/client-robomaker/commands/ListSimulationApplicationsCommand.ts +++ b/clients/client-robomaker/commands/ListSimulationApplicationsCommand.ts @@ -20,6 +20,10 @@ import { export type ListSimulationApplicationsCommandInput = ListSimulationApplicationsRequest; export type ListSimulationApplicationsCommandOutput = ListSimulationApplicationsResponse & __MetadataBearer; +/** + *

Returns a list of simulation applications. You can optionally provide filters to retrieve + * specific simulation applications.

+ */ export class ListSimulationApplicationsCommand extends $Command< ListSimulationApplicationsCommandInput, ListSimulationApplicationsCommandOutput, @@ -34,6 +38,9 @@ export class ListSimulationApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListSimulationJobBatchesCommand.ts b/clients/client-robomaker/commands/ListSimulationJobBatchesCommand.ts index 6a88107a7154a..59cbc08dd599f 100644 --- a/clients/client-robomaker/commands/ListSimulationJobBatchesCommand.ts +++ b/clients/client-robomaker/commands/ListSimulationJobBatchesCommand.ts @@ -20,6 +20,11 @@ import { export type ListSimulationJobBatchesCommandInput = ListSimulationJobBatchesRequest; export type ListSimulationJobBatchesCommandOutput = ListSimulationJobBatchesResponse & __MetadataBearer; +/** + *

Returns a list simulation job batches. You can optionally provide filters to retrieve + * specific simulation batch jobs. + *

+ */ export class ListSimulationJobBatchesCommand extends $Command< ListSimulationJobBatchesCommandInput, ListSimulationJobBatchesCommandOutput, @@ -34,6 +39,9 @@ export class ListSimulationJobBatchesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListSimulationJobsCommand.ts b/clients/client-robomaker/commands/ListSimulationJobsCommand.ts index 4d0c541b4dbd5..ee1ea85126e43 100644 --- a/clients/client-robomaker/commands/ListSimulationJobsCommand.ts +++ b/clients/client-robomaker/commands/ListSimulationJobsCommand.ts @@ -20,6 +20,10 @@ import { export type ListSimulationJobsCommandInput = ListSimulationJobsRequest; export type ListSimulationJobsCommandOutput = ListSimulationJobsResponse & __MetadataBearer; +/** + *

Returns a list of simulation jobs. You can optionally provide filters to retrieve + * specific simulation jobs.

+ */ export class ListSimulationJobsCommand extends $Command< ListSimulationJobsCommandInput, ListSimulationJobsCommandOutput, @@ -34,6 +38,9 @@ export class ListSimulationJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListTagsForResourceCommand.ts b/clients/client-robomaker/commands/ListTagsForResourceCommand.ts index 17717471f2c00..10f29ce509904 100644 --- a/clients/client-robomaker/commands/ListTagsForResourceCommand.ts +++ b/clients/client-robomaker/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists all tags on a AWS RoboMaker resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListWorldExportJobsCommand.ts b/clients/client-robomaker/commands/ListWorldExportJobsCommand.ts index 1bce7a16699e1..61586bf25ee0d 100644 --- a/clients/client-robomaker/commands/ListWorldExportJobsCommand.ts +++ b/clients/client-robomaker/commands/ListWorldExportJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListWorldExportJobsCommandInput = ListWorldExportJobsRequest; export type ListWorldExportJobsCommandOutput = ListWorldExportJobsResponse & __MetadataBearer; +/** + *

Lists world export jobs.

+ */ export class ListWorldExportJobsCommand extends $Command< ListWorldExportJobsCommandInput, ListWorldExportJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListWorldExportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListWorldGenerationJobsCommand.ts b/clients/client-robomaker/commands/ListWorldGenerationJobsCommand.ts index 3fb9c6f6dec2e..acd418a7dc319 100644 --- a/clients/client-robomaker/commands/ListWorldGenerationJobsCommand.ts +++ b/clients/client-robomaker/commands/ListWorldGenerationJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListWorldGenerationJobsCommandInput = ListWorldGenerationJobsRequest; export type ListWorldGenerationJobsCommandOutput = ListWorldGenerationJobsResponse & __MetadataBearer; +/** + *

Lists world generator jobs.

+ */ export class ListWorldGenerationJobsCommand extends $Command< ListWorldGenerationJobsCommandInput, ListWorldGenerationJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListWorldGenerationJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListWorldTemplatesCommand.ts b/clients/client-robomaker/commands/ListWorldTemplatesCommand.ts index 757d6056bdc26..43b843c471ece 100644 --- a/clients/client-robomaker/commands/ListWorldTemplatesCommand.ts +++ b/clients/client-robomaker/commands/ListWorldTemplatesCommand.ts @@ -20,6 +20,9 @@ import { export type ListWorldTemplatesCommandInput = ListWorldTemplatesRequest; export type ListWorldTemplatesCommandOutput = ListWorldTemplatesResponse & __MetadataBearer; +/** + *

Lists world templates.

+ */ export class ListWorldTemplatesCommand extends $Command< ListWorldTemplatesCommandInput, ListWorldTemplatesCommandOutput, @@ -34,6 +37,9 @@ export class ListWorldTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/ListWorldsCommand.ts b/clients/client-robomaker/commands/ListWorldsCommand.ts index d8fad6fbf7669..ba0bf280a4f19 100644 --- a/clients/client-robomaker/commands/ListWorldsCommand.ts +++ b/clients/client-robomaker/commands/ListWorldsCommand.ts @@ -20,6 +20,9 @@ import { export type ListWorldsCommandInput = ListWorldsRequest; export type ListWorldsCommandOutput = ListWorldsResponse & __MetadataBearer; +/** + *

Lists worlds.

+ */ export class ListWorldsCommand extends $Command< ListWorldsCommandInput, ListWorldsCommandOutput, @@ -34,6 +37,9 @@ export class ListWorldsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/RegisterRobotCommand.ts b/clients/client-robomaker/commands/RegisterRobotCommand.ts index 05a1ffeb6013c..8ff12bc17fb00 100644 --- a/clients/client-robomaker/commands/RegisterRobotCommand.ts +++ b/clients/client-robomaker/commands/RegisterRobotCommand.ts @@ -20,6 +20,9 @@ import { export type RegisterRobotCommandInput = RegisterRobotRequest; export type RegisterRobotCommandOutput = RegisterRobotResponse & __MetadataBearer; +/** + *

Registers a robot with a fleet.

+ */ export class RegisterRobotCommand extends $Command< RegisterRobotCommandInput, RegisterRobotCommandOutput, @@ -34,6 +37,9 @@ export class RegisterRobotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/RestartSimulationJobCommand.ts b/clients/client-robomaker/commands/RestartSimulationJobCommand.ts index 4941f002a7871..0bdcf00c68167 100644 --- a/clients/client-robomaker/commands/RestartSimulationJobCommand.ts +++ b/clients/client-robomaker/commands/RestartSimulationJobCommand.ts @@ -20,6 +20,9 @@ import { export type RestartSimulationJobCommandInput = RestartSimulationJobRequest; export type RestartSimulationJobCommandOutput = RestartSimulationJobResponse & __MetadataBearer; +/** + *

Restarts a running simulation job.

+ */ export class RestartSimulationJobCommand extends $Command< RestartSimulationJobCommandInput, RestartSimulationJobCommandOutput, @@ -34,6 +37,9 @@ export class RestartSimulationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/StartSimulationJobBatchCommand.ts b/clients/client-robomaker/commands/StartSimulationJobBatchCommand.ts index 4a8bc90b9c53f..09396434ed88a 100644 --- a/clients/client-robomaker/commands/StartSimulationJobBatchCommand.ts +++ b/clients/client-robomaker/commands/StartSimulationJobBatchCommand.ts @@ -20,6 +20,10 @@ import { export type StartSimulationJobBatchCommandInput = StartSimulationJobBatchRequest; export type StartSimulationJobBatchCommandOutput = StartSimulationJobBatchResponse & __MetadataBearer; +/** + *

Starts a new simulation job batch. The batch is defined using one or more SimulationJobRequest objects. + *

+ */ export class StartSimulationJobBatchCommand extends $Command< StartSimulationJobBatchCommandInput, StartSimulationJobBatchCommandOutput, @@ -34,6 +38,9 @@ export class StartSimulationJobBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/SyncDeploymentJobCommand.ts b/clients/client-robomaker/commands/SyncDeploymentJobCommand.ts index 3f53cecc1c7ef..398f8c6794e8f 100644 --- a/clients/client-robomaker/commands/SyncDeploymentJobCommand.ts +++ b/clients/client-robomaker/commands/SyncDeploymentJobCommand.ts @@ -20,6 +20,9 @@ import { export type SyncDeploymentJobCommandInput = SyncDeploymentJobRequest; export type SyncDeploymentJobCommandOutput = SyncDeploymentJobResponse & __MetadataBearer; +/** + *

Syncrhonizes robots in a fleet to the latest deployment. This is helpful if robots were added after a deployment.

+ */ export class SyncDeploymentJobCommand extends $Command< SyncDeploymentJobCommandInput, SyncDeploymentJobCommandOutput, @@ -34,6 +37,9 @@ export class SyncDeploymentJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/TagResourceCommand.ts b/clients/client-robomaker/commands/TagResourceCommand.ts index 12093509ab3c7..d2e276696c03f 100644 --- a/clients/client-robomaker/commands/TagResourceCommand.ts +++ b/clients/client-robomaker/commands/TagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds or edits tags for a AWS RoboMaker resource.

+ *

Each tag consists of a tag key and a tag value. Tag keys and tag values are both required, but tag values can be empty strings.

+ *

For information about the rules that apply to tag keys and tag values, see User-Defined Tag Restrictions in the AWS Billing and Cost Management User Guide.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +39,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/UntagResourceCommand.ts b/clients/client-robomaker/commands/UntagResourceCommand.ts index 8b967d7ceb0be..7da658fd56647 100644 --- a/clients/client-robomaker/commands/UntagResourceCommand.ts +++ b/clients/client-robomaker/commands/UntagResourceCommand.ts @@ -20,6 +20,14 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the specified tags from the specified AWS RoboMaker resource.

+ *

To remove a tag, specify the tag key. To change the tag value of an existing tag key, use + * + * TagResource + * . + *

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +42,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/UpdateRobotApplicationCommand.ts b/clients/client-robomaker/commands/UpdateRobotApplicationCommand.ts index d6b77c73747a5..e83f8177ac820 100644 --- a/clients/client-robomaker/commands/UpdateRobotApplicationCommand.ts +++ b/clients/client-robomaker/commands/UpdateRobotApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRobotApplicationCommandInput = UpdateRobotApplicationRequest; export type UpdateRobotApplicationCommandOutput = UpdateRobotApplicationResponse & __MetadataBearer; +/** + *

Updates a robot application.

+ */ export class UpdateRobotApplicationCommand extends $Command< UpdateRobotApplicationCommandInput, UpdateRobotApplicationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRobotApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/UpdateSimulationApplicationCommand.ts b/clients/client-robomaker/commands/UpdateSimulationApplicationCommand.ts index 7a018d4ae0203..2a8d733b87212 100644 --- a/clients/client-robomaker/commands/UpdateSimulationApplicationCommand.ts +++ b/clients/client-robomaker/commands/UpdateSimulationApplicationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSimulationApplicationCommandInput = UpdateSimulationApplicationRequest; export type UpdateSimulationApplicationCommandOutput = UpdateSimulationApplicationResponse & __MetadataBearer; +/** + *

Updates a simulation application.

+ */ export class UpdateSimulationApplicationCommand extends $Command< UpdateSimulationApplicationCommandInput, UpdateSimulationApplicationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSimulationApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/commands/UpdateWorldTemplateCommand.ts b/clients/client-robomaker/commands/UpdateWorldTemplateCommand.ts index 0a100456d6431..a55ed7c4ab800 100644 --- a/clients/client-robomaker/commands/UpdateWorldTemplateCommand.ts +++ b/clients/client-robomaker/commands/UpdateWorldTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateWorldTemplateCommandInput = UpdateWorldTemplateRequest; export type UpdateWorldTemplateCommandOutput = UpdateWorldTemplateResponse & __MetadataBearer; +/** + *

Updates a world template.

+ */ export class UpdateWorldTemplateCommand extends $Command< UpdateWorldTemplateCommandInput, UpdateWorldTemplateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateWorldTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RoboMakerClientResolvedConfig, diff --git a/clients/client-robomaker/package.json b/clients/client-robomaker/package.json index deac0f69b7a68..e5c302cd938e0 100644 --- a/clients/client-robomaker/package.json +++ b/clients/client-robomaker/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Robomaker Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-robomaker/pagination/ListDeploymentJobsPaginator.ts b/clients/client-robomaker/pagination/ListDeploymentJobsPaginator.ts index e2c4a9c32cd26..efe877a5a1878 100644 --- a/clients/client-robomaker/pagination/ListDeploymentJobsPaginator.ts +++ b/clients/client-robomaker/pagination/ListDeploymentJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListDeploymentJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeploymentJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListDeploymentJobsCommandInput, diff --git a/clients/client-robomaker/pagination/ListFleetsPaginator.ts b/clients/client-robomaker/pagination/ListFleetsPaginator.ts index e60cffb3b89bd..a0ae99879ed57 100644 --- a/clients/client-robomaker/pagination/ListFleetsPaginator.ts +++ b/clients/client-robomaker/pagination/ListFleetsPaginator.ts @@ -4,6 +4,9 @@ import { ListFleetsCommand, ListFleetsCommandInput, ListFleetsCommandOutput } fr import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListFleetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFleetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListFleetsCommandInput, diff --git a/clients/client-robomaker/pagination/ListRobotApplicationsPaginator.ts b/clients/client-robomaker/pagination/ListRobotApplicationsPaginator.ts index f924bece62c3a..271e179d4f481 100644 --- a/clients/client-robomaker/pagination/ListRobotApplicationsPaginator.ts +++ b/clients/client-robomaker/pagination/ListRobotApplicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListRobotApplicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRobotApplicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListRobotApplicationsCommandInput, diff --git a/clients/client-robomaker/pagination/ListRobotsPaginator.ts b/clients/client-robomaker/pagination/ListRobotsPaginator.ts index 95bef38172c47..13f1a21e9087c 100644 --- a/clients/client-robomaker/pagination/ListRobotsPaginator.ts +++ b/clients/client-robomaker/pagination/ListRobotsPaginator.ts @@ -4,6 +4,9 @@ import { ListRobotsCommand, ListRobotsCommandInput, ListRobotsCommandOutput } fr import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListRobotsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRobotsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListRobotsCommandInput, diff --git a/clients/client-robomaker/pagination/ListSimulationApplicationsPaginator.ts b/clients/client-robomaker/pagination/ListSimulationApplicationsPaginator.ts index 4f0515397eb6a..3dcf4241d2f8f 100644 --- a/clients/client-robomaker/pagination/ListSimulationApplicationsPaginator.ts +++ b/clients/client-robomaker/pagination/ListSimulationApplicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListSimulationApplicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSimulationApplicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListSimulationApplicationsCommandInput, diff --git a/clients/client-robomaker/pagination/ListSimulationJobBatchesPaginator.ts b/clients/client-robomaker/pagination/ListSimulationJobBatchesPaginator.ts index 0a663f383fafb..b88a7c07fd42f 100644 --- a/clients/client-robomaker/pagination/ListSimulationJobBatchesPaginator.ts +++ b/clients/client-robomaker/pagination/ListSimulationJobBatchesPaginator.ts @@ -8,6 +8,9 @@ import { import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListSimulationJobBatchesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSimulationJobBatchesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListSimulationJobBatchesCommandInput, diff --git a/clients/client-robomaker/pagination/ListSimulationJobsPaginator.ts b/clients/client-robomaker/pagination/ListSimulationJobsPaginator.ts index 000957db2be48..150ea2c72147d 100644 --- a/clients/client-robomaker/pagination/ListSimulationJobsPaginator.ts +++ b/clients/client-robomaker/pagination/ListSimulationJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListSimulationJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSimulationJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListSimulationJobsCommandInput, diff --git a/clients/client-robomaker/pagination/ListWorldExportJobsPaginator.ts b/clients/client-robomaker/pagination/ListWorldExportJobsPaginator.ts index 4d4f5ce77269d..27a977e24c1c3 100644 --- a/clients/client-robomaker/pagination/ListWorldExportJobsPaginator.ts +++ b/clients/client-robomaker/pagination/ListWorldExportJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListWorldExportJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorldExportJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListWorldExportJobsCommandInput, diff --git a/clients/client-robomaker/pagination/ListWorldGenerationJobsPaginator.ts b/clients/client-robomaker/pagination/ListWorldGenerationJobsPaginator.ts index 439281656c5e2..3389e45952df4 100644 --- a/clients/client-robomaker/pagination/ListWorldGenerationJobsPaginator.ts +++ b/clients/client-robomaker/pagination/ListWorldGenerationJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListWorldGenerationJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorldGenerationJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListWorldGenerationJobsCommandInput, diff --git a/clients/client-robomaker/pagination/ListWorldTemplatesPaginator.ts b/clients/client-robomaker/pagination/ListWorldTemplatesPaginator.ts index c47ef635b7b14..2d7cfe8173025 100644 --- a/clients/client-robomaker/pagination/ListWorldTemplatesPaginator.ts +++ b/clients/client-robomaker/pagination/ListWorldTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListWorldTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorldTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListWorldTemplatesCommandInput, diff --git a/clients/client-robomaker/pagination/ListWorldsPaginator.ts b/clients/client-robomaker/pagination/ListWorldsPaginator.ts index b2c8fc90d4ddb..b32462fd99bb2 100644 --- a/clients/client-robomaker/pagination/ListWorldsPaginator.ts +++ b/clients/client-robomaker/pagination/ListWorldsPaginator.ts @@ -4,6 +4,9 @@ import { ListWorldsCommand, ListWorldsCommandInput, ListWorldsCommandOutput } fr import { RoboMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: RoboMakerClient, input: ListWorldsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorldsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: RoboMaker, input: ListWorldsCommandInput, diff --git a/clients/client-robomaker/runtimeConfig.browser.ts b/clients/client-robomaker/runtimeConfig.browser.ts index 4f79ed5481dc7..7cca2425823fe 100644 --- a/clients/client-robomaker/runtimeConfig.browser.ts +++ b/clients/client-robomaker/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RoboMakerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-robomaker/runtimeConfig.native.ts b/clients/client-robomaker/runtimeConfig.native.ts index 811908f7a2a71..a97e86f8b06de 100644 --- a/clients/client-robomaker/runtimeConfig.native.ts +++ b/clients/client-robomaker/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RoboMakerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-robomaker/runtimeConfig.shared.ts b/clients/client-robomaker/runtimeConfig.shared.ts index 63ba7e18410da..c017b41b94529 100644 --- a/clients/client-robomaker/runtimeConfig.shared.ts +++ b/clients/client-robomaker/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-06-29", disableHostPrefix: false, diff --git a/clients/client-robomaker/runtimeConfig.ts b/clients/client-robomaker/runtimeConfig.ts index b4da0b907c8b3..6ad9fb078aa48 100644 --- a/clients/client-robomaker/runtimeConfig.ts +++ b/clients/client-robomaker/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RoboMakerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-robomaker/tsconfig.json b/clients/client-robomaker/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-robomaker/tsconfig.json +++ b/clients/client-robomaker/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-route-53-domains/commands/AcceptDomainTransferFromAnotherAwsAccountCommand.ts b/clients/client-route-53-domains/commands/AcceptDomainTransferFromAnotherAwsAccountCommand.ts index 5d6905e8c348a..97a2da1883219 100644 --- a/clients/client-route-53-domains/commands/AcceptDomainTransferFromAnotherAwsAccountCommand.ts +++ b/clients/client-route-53-domains/commands/AcceptDomainTransferFromAnotherAwsAccountCommand.ts @@ -24,6 +24,19 @@ export type AcceptDomainTransferFromAnotherAwsAccountCommandInput = AcceptDomain export type AcceptDomainTransferFromAnotherAwsAccountCommandOutput = AcceptDomainTransferFromAnotherAwsAccountResponse & __MetadataBearer; +/** + *

Accepts the transfer of a domain from another AWS account to the current AWS account. You initiate a transfer between AWS accounts using + * TransferDomainToAnotherAwsAccount. + *

+ * + *

Use either + * ListOperations or + * GetOperationDetail + * to determine whether the operation succeeded. + * GetOperationDetail + * provides additional information, for example, Domain Transfer from Aws Account 111122223333 has been cancelled. + *

+ */ export class AcceptDomainTransferFromAnotherAwsAccountCommand extends $Command< AcceptDomainTransferFromAnotherAwsAccountCommandInput, AcceptDomainTransferFromAnotherAwsAccountCommandOutput, @@ -38,6 +51,9 @@ export class AcceptDomainTransferFromAnotherAwsAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/CancelDomainTransferToAnotherAwsAccountCommand.ts b/clients/client-route-53-domains/commands/CancelDomainTransferToAnotherAwsAccountCommand.ts index 3245e5319d71d..a9ffe424e1eaa 100644 --- a/clients/client-route-53-domains/commands/CancelDomainTransferToAnotherAwsAccountCommand.ts +++ b/clients/client-route-53-domains/commands/CancelDomainTransferToAnotherAwsAccountCommand.ts @@ -24,6 +24,24 @@ export type CancelDomainTransferToAnotherAwsAccountCommandInput = CancelDomainTr export type CancelDomainTransferToAnotherAwsAccountCommandOutput = CancelDomainTransferToAnotherAwsAccountResponse & __MetadataBearer; +/** + *

Cancels the transfer of a domain from the current AWS account to another AWS account. You initiate a transfer between AWS accounts using + * TransferDomainToAnotherAwsAccount. + *

+ * + * + *

You must cancel the transfer before the other AWS account accepts the transfer using + * AcceptDomainTransferFromAnotherAwsAccount.

+ *
+ * + *

Use either + * ListOperations or + * GetOperationDetail + * to determine whether the operation succeeded. + * GetOperationDetail + * provides additional information, for example, Domain Transfer from Aws Account 111122223333 has been cancelled. + *

+ */ export class CancelDomainTransferToAnotherAwsAccountCommand extends $Command< CancelDomainTransferToAnotherAwsAccountCommandInput, CancelDomainTransferToAnotherAwsAccountCommandOutput, @@ -38,6 +56,9 @@ export class CancelDomainTransferToAnotherAwsAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/CheckDomainAvailabilityCommand.ts b/clients/client-route-53-domains/commands/CheckDomainAvailabilityCommand.ts index e53bc63341d61..f86cf36c10d36 100644 --- a/clients/client-route-53-domains/commands/CheckDomainAvailabilityCommand.ts +++ b/clients/client-route-53-domains/commands/CheckDomainAvailabilityCommand.ts @@ -20,6 +20,10 @@ import { export type CheckDomainAvailabilityCommandInput = CheckDomainAvailabilityRequest; export type CheckDomainAvailabilityCommandOutput = CheckDomainAvailabilityResponse & __MetadataBearer; +/** + *

This operation checks the availability of one domain name. Note that if the availability status of a domain is pending, you must + * submit another request to determine the availability of the domain name.

+ */ export class CheckDomainAvailabilityCommand extends $Command< CheckDomainAvailabilityCommandInput, CheckDomainAvailabilityCommandOutput, @@ -34,6 +38,9 @@ export class CheckDomainAvailabilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/CheckDomainTransferabilityCommand.ts b/clients/client-route-53-domains/commands/CheckDomainTransferabilityCommand.ts index 653679cfd9a4b..eaa3a5416fad2 100644 --- a/clients/client-route-53-domains/commands/CheckDomainTransferabilityCommand.ts +++ b/clients/client-route-53-domains/commands/CheckDomainTransferabilityCommand.ts @@ -20,6 +20,9 @@ import { export type CheckDomainTransferabilityCommandInput = CheckDomainTransferabilityRequest; export type CheckDomainTransferabilityCommandOutput = CheckDomainTransferabilityResponse & __MetadataBearer; +/** + *

Checks whether a domain name can be transferred to Amazon Route 53.

+ */ export class CheckDomainTransferabilityCommand extends $Command< CheckDomainTransferabilityCommandInput, CheckDomainTransferabilityCommandOutput, @@ -34,6 +37,9 @@ export class CheckDomainTransferabilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/DeleteTagsForDomainCommand.ts b/clients/client-route-53-domains/commands/DeleteTagsForDomainCommand.ts index bfb6a7bd522d7..8e9cb8f415ee2 100644 --- a/clients/client-route-53-domains/commands/DeleteTagsForDomainCommand.ts +++ b/clients/client-route-53-domains/commands/DeleteTagsForDomainCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTagsForDomainCommandInput = DeleteTagsForDomainRequest; export type DeleteTagsForDomainCommandOutput = DeleteTagsForDomainResponse & __MetadataBearer; +/** + *

This operation deletes the specified tags for a domain.

+ *

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

+ */ export class DeleteTagsForDomainCommand extends $Command< DeleteTagsForDomainCommandInput, DeleteTagsForDomainCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTagsForDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/DisableDomainAutoRenewCommand.ts b/clients/client-route-53-domains/commands/DisableDomainAutoRenewCommand.ts index 9299100f5555a..29112d678d927 100644 --- a/clients/client-route-53-domains/commands/DisableDomainAutoRenewCommand.ts +++ b/clients/client-route-53-domains/commands/DisableDomainAutoRenewCommand.ts @@ -20,6 +20,9 @@ import { export type DisableDomainAutoRenewCommandInput = DisableDomainAutoRenewRequest; export type DisableDomainAutoRenewCommandOutput = DisableDomainAutoRenewResponse & __MetadataBearer; +/** + *

This operation disables automatic renewal of domain registration for the specified domain.

+ */ export class DisableDomainAutoRenewCommand extends $Command< DisableDomainAutoRenewCommandInput, DisableDomainAutoRenewCommandOutput, @@ -34,6 +37,9 @@ export class DisableDomainAutoRenewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/DisableDomainTransferLockCommand.ts b/clients/client-route-53-domains/commands/DisableDomainTransferLockCommand.ts index 93befb0ce82f7..e745bfbe999be 100644 --- a/clients/client-route-53-domains/commands/DisableDomainTransferLockCommand.ts +++ b/clients/client-route-53-domains/commands/DisableDomainTransferLockCommand.ts @@ -20,6 +20,14 @@ import { export type DisableDomainTransferLockCommandInput = DisableDomainTransferLockRequest; export type DisableDomainTransferLockCommandOutput = DisableDomainTransferLockResponse & __MetadataBearer; +/** + *

This operation removes the transfer lock on the domain (specifically the + * clientTransferProhibited status) to allow domain transfers. We recommend + * you refrain from performing this action unless you intend to transfer the domain to a + * different registrar. Successful submission returns an operation ID that you can use to track + * the progress and completion of the action. If the request is not completed successfully, the + * domain registrant will be notified by email.

+ */ export class DisableDomainTransferLockCommand extends $Command< DisableDomainTransferLockCommandInput, DisableDomainTransferLockCommandOutput, @@ -34,6 +42,9 @@ export class DisableDomainTransferLockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/EnableDomainAutoRenewCommand.ts b/clients/client-route-53-domains/commands/EnableDomainAutoRenewCommand.ts index d8c3984a3d711..bed98e16eb25a 100644 --- a/clients/client-route-53-domains/commands/EnableDomainAutoRenewCommand.ts +++ b/clients/client-route-53-domains/commands/EnableDomainAutoRenewCommand.ts @@ -20,6 +20,14 @@ import { export type EnableDomainAutoRenewCommandInput = EnableDomainAutoRenewRequest; export type EnableDomainAutoRenewCommandOutput = EnableDomainAutoRenewResponse & __MetadataBearer; +/** + *

This operation configures Amazon Route 53 to automatically renew the specified domain before the domain registration expires. + * The cost of renewing your domain registration is billed to your AWS account.

+ *

The period during which you can renew a domain name varies by TLD. For a list of TLDs and their renewal policies, see + * Domains That You Can Register with Amazon Route 53 + * in the Amazon Route 53 Developer Guide. Route 53 requires that you renew before the end of the renewal period + * so we can complete processing before the deadline.

+ */ export class EnableDomainAutoRenewCommand extends $Command< EnableDomainAutoRenewCommandInput, EnableDomainAutoRenewCommandOutput, @@ -34,6 +42,9 @@ export class EnableDomainAutoRenewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/EnableDomainTransferLockCommand.ts b/clients/client-route-53-domains/commands/EnableDomainTransferLockCommand.ts index 8e87bc3d52f0b..7e71f3d2fa393 100644 --- a/clients/client-route-53-domains/commands/EnableDomainTransferLockCommand.ts +++ b/clients/client-route-53-domains/commands/EnableDomainTransferLockCommand.ts @@ -20,6 +20,11 @@ import { export type EnableDomainTransferLockCommandInput = EnableDomainTransferLockRequest; export type EnableDomainTransferLockCommandOutput = EnableDomainTransferLockResponse & __MetadataBearer; +/** + *

This operation sets the transfer lock on the domain (specifically the clientTransferProhibited status) + * to prevent domain transfers. Successful submission returns an operation ID that you can use to track the progress and + * completion of the action. If the request is not completed successfully, the domain registrant will be notified by email.

+ */ export class EnableDomainTransferLockCommand extends $Command< EnableDomainTransferLockCommandInput, EnableDomainTransferLockCommandOutput, @@ -34,6 +39,9 @@ export class EnableDomainTransferLockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/GetContactReachabilityStatusCommand.ts b/clients/client-route-53-domains/commands/GetContactReachabilityStatusCommand.ts index a862add891f97..75828857e469b 100644 --- a/clients/client-route-53-domains/commands/GetContactReachabilityStatusCommand.ts +++ b/clients/client-route-53-domains/commands/GetContactReachabilityStatusCommand.ts @@ -20,6 +20,11 @@ import { export type GetContactReachabilityStatusCommandInput = GetContactReachabilityStatusRequest; export type GetContactReachabilityStatusCommandOutput = GetContactReachabilityStatusResponse & __MetadataBearer; +/** + *

For operations that require confirmation that the email address for the registrant contact is valid, + * such as registering a new domain, this operation returns information about whether the registrant contact has responded.

+ *

If you want us to resend the email, use the ResendContactReachabilityEmail operation.

+ */ export class GetContactReachabilityStatusCommand extends $Command< GetContactReachabilityStatusCommandInput, GetContactReachabilityStatusCommandOutput, @@ -34,6 +39,9 @@ export class GetContactReachabilityStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/GetDomainDetailCommand.ts b/clients/client-route-53-domains/commands/GetDomainDetailCommand.ts index 105338b4ff5f1..46db2dde138cd 100644 --- a/clients/client-route-53-domains/commands/GetDomainDetailCommand.ts +++ b/clients/client-route-53-domains/commands/GetDomainDetailCommand.ts @@ -20,6 +20,10 @@ import { export type GetDomainDetailCommandInput = GetDomainDetailRequest; export type GetDomainDetailCommandOutput = GetDomainDetailResponse & __MetadataBearer; +/** + *

This operation returns detailed information about a specified domain that is associated with the current AWS account. + * Contact information for the domain is also returned as part of the output.

+ */ export class GetDomainDetailCommand extends $Command< GetDomainDetailCommandInput, GetDomainDetailCommandOutput, @@ -34,6 +38,9 @@ export class GetDomainDetailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/GetDomainSuggestionsCommand.ts b/clients/client-route-53-domains/commands/GetDomainSuggestionsCommand.ts index 624b6295b2024..a818042d3acbf 100644 --- a/clients/client-route-53-domains/commands/GetDomainSuggestionsCommand.ts +++ b/clients/client-route-53-domains/commands/GetDomainSuggestionsCommand.ts @@ -20,6 +20,9 @@ import { export type GetDomainSuggestionsCommandInput = GetDomainSuggestionsRequest; export type GetDomainSuggestionsCommandOutput = GetDomainSuggestionsResponse & __MetadataBearer; +/** + *

The GetDomainSuggestions operation returns a list of suggested domain names.

+ */ export class GetDomainSuggestionsCommand extends $Command< GetDomainSuggestionsCommandInput, GetDomainSuggestionsCommandOutput, @@ -34,6 +37,9 @@ export class GetDomainSuggestionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/GetOperationDetailCommand.ts b/clients/client-route-53-domains/commands/GetOperationDetailCommand.ts index f28998f9db0db..7d0298687b96f 100644 --- a/clients/client-route-53-domains/commands/GetOperationDetailCommand.ts +++ b/clients/client-route-53-domains/commands/GetOperationDetailCommand.ts @@ -20,6 +20,9 @@ import { export type GetOperationDetailCommandInput = GetOperationDetailRequest; export type GetOperationDetailCommandOutput = GetOperationDetailResponse & __MetadataBearer; +/** + *

This operation returns the current status of an operation that is not completed.

+ */ export class GetOperationDetailCommand extends $Command< GetOperationDetailCommandInput, GetOperationDetailCommandOutput, @@ -34,6 +37,9 @@ export class GetOperationDetailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/ListDomainsCommand.ts b/clients/client-route-53-domains/commands/ListDomainsCommand.ts index cbb8a8528e8b1..b9fe47ba75d1a 100644 --- a/clients/client-route-53-domains/commands/ListDomainsCommand.ts +++ b/clients/client-route-53-domains/commands/ListDomainsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDomainsCommandInput = ListDomainsRequest; export type ListDomainsCommandOutput = ListDomainsResponse & __MetadataBearer; +/** + *

This operation returns all the domain names registered with Amazon Route 53 for the current AWS account.

+ */ export class ListDomainsCommand extends $Command< ListDomainsCommandInput, ListDomainsCommandOutput, @@ -34,6 +37,9 @@ export class ListDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/ListOperationsCommand.ts b/clients/client-route-53-domains/commands/ListOperationsCommand.ts index e541593ed1b40..06ae668842955 100644 --- a/clients/client-route-53-domains/commands/ListOperationsCommand.ts +++ b/clients/client-route-53-domains/commands/ListOperationsCommand.ts @@ -20,6 +20,10 @@ import { export type ListOperationsCommandInput = ListOperationsRequest; export type ListOperationsCommandOutput = ListOperationsResponse & __MetadataBearer; +/** + *

Returns information about all of the operations that return an operation ID and that have ever been + * performed on domains that were registered by the current account.

+ */ export class ListOperationsCommand extends $Command< ListOperationsCommandInput, ListOperationsCommandOutput, @@ -34,6 +38,9 @@ export class ListOperationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/ListTagsForDomainCommand.ts b/clients/client-route-53-domains/commands/ListTagsForDomainCommand.ts index 8252f5b4ae70b..ede0ee27157ae 100644 --- a/clients/client-route-53-domains/commands/ListTagsForDomainCommand.ts +++ b/clients/client-route-53-domains/commands/ListTagsForDomainCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForDomainCommandInput = ListTagsForDomainRequest; export type ListTagsForDomainCommandOutput = ListTagsForDomainResponse & __MetadataBearer; +/** + *

This operation returns all of the tags that are associated with the specified domain.

+ *

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

+ */ export class ListTagsForDomainCommand extends $Command< ListTagsForDomainCommandInput, ListTagsForDomainCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/RegisterDomainCommand.ts b/clients/client-route-53-domains/commands/RegisterDomainCommand.ts index 69ab6d0d99d62..a269837136a06 100644 --- a/clients/client-route-53-domains/commands/RegisterDomainCommand.ts +++ b/clients/client-route-53-domains/commands/RegisterDomainCommand.ts @@ -20,6 +20,34 @@ import { export type RegisterDomainCommandInput = RegisterDomainRequest; export type RegisterDomainCommandOutput = RegisterDomainResponse & __MetadataBearer; +/** + *

This operation registers a domain. Domains are registered either by Amazon Registrar (for .com, .net, and .org domains) or by + * our registrar associate, Gandi (for all other domains). For some top-level domains (TLDs), this operation requires extra parameters.

+ *

When you register a domain, Amazon Route 53 does the following:

+ *
    + *
  • + *

    Creates a Route 53 hosted zone that has the same name as the domain. Route 53 assigns four name servers + * to your hosted zone and automatically updates your domain registration with the names of these name servers.

    + *
  • + *
  • + *

    Enables autorenew, so your domain registration will renew automatically each year. We'll notify you + * in advance of the renewal date so you can choose whether to renew the registration.

    + *
  • + *
  • + *

    Optionally enables privacy protection, so WHOIS queries return contact information either for Amazon Registrar + * (for .com, .net, and .org domains) or for our registrar associate, Gandi (for all other TLDs). If you don't enable privacy + * protection, WHOIS queries return the information that you entered for the registrant, admin, and tech contacts.

    + *
  • + *
  • + *

    If registration is successful, returns an operation ID that you can use to track the progress and + * completion of the action. If the request is not completed successfully, the domain registrant is notified by email.

    + *
  • + *
  • + *

    Charges your AWS account an amount based on the top-level domain. For more information, see + * Amazon Route 53 Pricing.

    + *
  • + *
+ */ export class RegisterDomainCommand extends $Command< RegisterDomainCommandInput, RegisterDomainCommandOutput, @@ -34,6 +62,9 @@ export class RegisterDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/RejectDomainTransferFromAnotherAwsAccountCommand.ts b/clients/client-route-53-domains/commands/RejectDomainTransferFromAnotherAwsAccountCommand.ts index 887cb4e7b463f..59bb0dff90f4a 100644 --- a/clients/client-route-53-domains/commands/RejectDomainTransferFromAnotherAwsAccountCommand.ts +++ b/clients/client-route-53-domains/commands/RejectDomainTransferFromAnotherAwsAccountCommand.ts @@ -24,6 +24,19 @@ export type RejectDomainTransferFromAnotherAwsAccountCommandInput = RejectDomain export type RejectDomainTransferFromAnotherAwsAccountCommandOutput = RejectDomainTransferFromAnotherAwsAccountResponse & __MetadataBearer; +/** + *

Rejects the transfer of a domain from another AWS account to the current AWS account. You initiate a transfer between AWS accounts using + * TransferDomainToAnotherAwsAccount. + *

+ * + *

Use either + * ListOperations or + * GetOperationDetail + * to determine whether the operation succeeded. + * GetOperationDetail + * provides additional information, for example, Domain Transfer from Aws Account 111122223333 has been cancelled. + *

+ */ export class RejectDomainTransferFromAnotherAwsAccountCommand extends $Command< RejectDomainTransferFromAnotherAwsAccountCommandInput, RejectDomainTransferFromAnotherAwsAccountCommandOutput, @@ -38,6 +51,9 @@ export class RejectDomainTransferFromAnotherAwsAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/RenewDomainCommand.ts b/clients/client-route-53-domains/commands/RenewDomainCommand.ts index 0232ed1059b28..35612059d3372 100644 --- a/clients/client-route-53-domains/commands/RenewDomainCommand.ts +++ b/clients/client-route-53-domains/commands/RenewDomainCommand.ts @@ -20,6 +20,13 @@ import { export type RenewDomainCommandInput = RenewDomainRequest; export type RenewDomainCommandOutput = RenewDomainResponse & __MetadataBearer; +/** + *

This operation renews a domain for the specified number of years. The cost of renewing your domain is billed to your AWS account.

+ *

We recommend that you renew your domain several weeks before the expiration date. Some TLD registries delete domains before the + * expiration date if you haven't renewed far enough in advance. For more information about renewing domain registration, see + * Renewing Registration for a Domain + * in the Amazon Route 53 Developer Guide.

+ */ export class RenewDomainCommand extends $Command< RenewDomainCommandInput, RenewDomainCommandOutput, @@ -34,6 +41,9 @@ export class RenewDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/ResendContactReachabilityEmailCommand.ts b/clients/client-route-53-domains/commands/ResendContactReachabilityEmailCommand.ts index b390925b69e91..b50aebf8f4fbb 100644 --- a/clients/client-route-53-domains/commands/ResendContactReachabilityEmailCommand.ts +++ b/clients/client-route-53-domains/commands/ResendContactReachabilityEmailCommand.ts @@ -20,6 +20,10 @@ import { export type ResendContactReachabilityEmailCommandInput = ResendContactReachabilityEmailRequest; export type ResendContactReachabilityEmailCommandOutput = ResendContactReachabilityEmailResponse & __MetadataBearer; +/** + *

For operations that require confirmation that the email address for the registrant contact is valid, + * such as registering a new domain, this operation resends the confirmation email to the current email address for the registrant contact.

+ */ export class ResendContactReachabilityEmailCommand extends $Command< ResendContactReachabilityEmailCommandInput, ResendContactReachabilityEmailCommandOutput, @@ -34,6 +38,9 @@ export class ResendContactReachabilityEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/RetrieveDomainAuthCodeCommand.ts b/clients/client-route-53-domains/commands/RetrieveDomainAuthCodeCommand.ts index 5b5487eb4bd85..ec0c1798d1ff3 100644 --- a/clients/client-route-53-domains/commands/RetrieveDomainAuthCodeCommand.ts +++ b/clients/client-route-53-domains/commands/RetrieveDomainAuthCodeCommand.ts @@ -20,6 +20,9 @@ import { export type RetrieveDomainAuthCodeCommandInput = RetrieveDomainAuthCodeRequest; export type RetrieveDomainAuthCodeCommandOutput = RetrieveDomainAuthCodeResponse & __MetadataBearer; +/** + *

This operation returns the AuthCode for the domain. To transfer a domain to another registrar, you provide this value to the new registrar.

+ */ export class RetrieveDomainAuthCodeCommand extends $Command< RetrieveDomainAuthCodeCommandInput, RetrieveDomainAuthCodeCommandOutput, @@ -34,6 +37,9 @@ export class RetrieveDomainAuthCodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/TransferDomainCommand.ts b/clients/client-route-53-domains/commands/TransferDomainCommand.ts index dfc37ba85ee4e..e58f69f31d094 100644 --- a/clients/client-route-53-domains/commands/TransferDomainCommand.ts +++ b/clients/client-route-53-domains/commands/TransferDomainCommand.ts @@ -20,6 +20,42 @@ import { export type TransferDomainCommandInput = TransferDomainRequest; export type TransferDomainCommandOutput = TransferDomainResponse & __MetadataBearer; +/** + *

Transfers a domain from another registrar to Amazon Route 53. When the transfer is complete, the domain is registered either with + * Amazon Registrar (for .com, .net, and .org domains) or with our registrar associate, Gandi (for all other TLDs).

+ *

For more information about transferring domains, see the following topics:

+ * + *

If the registrar for your domain is also the DNS service provider for the domain, we highly recommend that you + * transfer your DNS service to Route 53 or to another DNS service provider before you transfer your registration. Some registrars + * provide free DNS service when you purchase a domain registration. When you transfer the registration, the previous registrar + * will not renew your domain registration and could end your DNS service at any time.

+ * + * + *

If the registrar for your domain is also the DNS service provider for the domain and you don't + * transfer DNS service to another provider, your website, email, and the web applications associated with the domain + * might become unavailable.

+ *
+ * + *

If the transfer is successful, this method returns an operation ID that you can use to track the progress and + * completion of the action. If the transfer doesn't complete successfully, the domain registrant will be notified by email.

+ */ export class TransferDomainCommand extends $Command< TransferDomainCommandInput, TransferDomainCommandOutput, @@ -34,6 +70,9 @@ export class TransferDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/TransferDomainToAnotherAwsAccountCommand.ts b/clients/client-route-53-domains/commands/TransferDomainToAnotherAwsAccountCommand.ts index caae77bc779c9..9648f4dd3ef62 100644 --- a/clients/client-route-53-domains/commands/TransferDomainToAnotherAwsAccountCommand.ts +++ b/clients/client-route-53-domains/commands/TransferDomainToAnotherAwsAccountCommand.ts @@ -24,6 +24,43 @@ export type TransferDomainToAnotherAwsAccountCommandInput = TransferDomainToAnot export type TransferDomainToAnotherAwsAccountCommandOutput = TransferDomainToAnotherAwsAccountResponse & __MetadataBearer; +/** + *

Transfers a domain from the current AWS account to another AWS account. Note the following:

+ * + * + * + *

When you transfer a domain from one AWS account to another, Route 53 doesn't transfer the hosted zone that is associated + * with the domain. DNS resolution isn't affected if the domain and the hosted zone are owned by separate accounts, + * so transferring the hosted zone is optional. For information about transferring the hosted zone to another AWS account, see + * Migrating a Hosted Zone to a + * Different AWS Account in the Amazon Route 53 Developer Guide.

+ *
+ * + *

Use either + * ListOperations or + * GetOperationDetail + * to determine whether the operation succeeded. + * GetOperationDetail + * provides additional information, for example, Domain Transfer from Aws Account 111122223333 has been cancelled. + *

+ */ export class TransferDomainToAnotherAwsAccountCommand extends $Command< TransferDomainToAnotherAwsAccountCommandInput, TransferDomainToAnotherAwsAccountCommandOutput, @@ -38,6 +75,9 @@ export class TransferDomainToAnotherAwsAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/UpdateDomainContactCommand.ts b/clients/client-route-53-domains/commands/UpdateDomainContactCommand.ts index 2540cfe52f935..b57a87bda3755 100644 --- a/clients/client-route-53-domains/commands/UpdateDomainContactCommand.ts +++ b/clients/client-route-53-domains/commands/UpdateDomainContactCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateDomainContactCommandInput = UpdateDomainContactRequest; export type UpdateDomainContactCommandOutput = UpdateDomainContactResponse & __MetadataBearer; +/** + *

This operation updates the contact information for a particular domain. You must specify information for at least one contact: + * registrant, administrator, or technical.

+ *

If the update is successful, this method returns an operation ID that you can use to track the progress and completion of the action. + * If the request is not completed successfully, the domain registrant will be notified by email.

+ */ export class UpdateDomainContactCommand extends $Command< UpdateDomainContactCommandInput, UpdateDomainContactCommandOutput, @@ -34,6 +40,9 @@ export class UpdateDomainContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/UpdateDomainContactPrivacyCommand.ts b/clients/client-route-53-domains/commands/UpdateDomainContactPrivacyCommand.ts index 0ef1b2f48cebd..d6a533fe6aecc 100644 --- a/clients/client-route-53-domains/commands/UpdateDomainContactPrivacyCommand.ts +++ b/clients/client-route-53-domains/commands/UpdateDomainContactPrivacyCommand.ts @@ -20,6 +20,23 @@ import { export type UpdateDomainContactPrivacyCommandInput = UpdateDomainContactPrivacyRequest; export type UpdateDomainContactPrivacyCommandOutput = UpdateDomainContactPrivacyResponse & __MetadataBearer; +/** + *

This operation updates the specified domain contact's privacy setting. When privacy protection is enabled, + * contact information such as email address is replaced either with contact information for Amazon Registrar (for .com, .net, and .org + * domains) or with contact information for our registrar associate, Gandi.

+ *

This operation affects only the contact information for the specified contact type (registrant, administrator, or tech). + * If the request succeeds, Amazon Route 53 returns an operation ID that you can use with + * GetOperationDetail + * to track the progress and completion of the action. If the request doesn't complete successfully, the domain registrant will be notified by email.

+ * + *

By disabling the privacy service via API, you consent to the publication of the contact information provided for this domain + * via the public WHOIS database. You certify that you are the registrant of this domain name and have the authority to make this decision. + * You may withdraw your consent at any time by enabling privacy protection using either UpdateDomainContactPrivacy or the + * Route 53 console. Enabling privacy protection removes the contact information provided for this domain from the WHOIS database. + * For more information on our privacy practices, see + * https://aws.amazon.com/privacy/.

+ *
+ */ export class UpdateDomainContactPrivacyCommand extends $Command< UpdateDomainContactPrivacyCommandInput, UpdateDomainContactPrivacyCommandOutput, @@ -34,6 +51,9 @@ export class UpdateDomainContactPrivacyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/UpdateDomainNameserversCommand.ts b/clients/client-route-53-domains/commands/UpdateDomainNameserversCommand.ts index 7628bdbcc0c4c..b5e86fc4b7dc5 100644 --- a/clients/client-route-53-domains/commands/UpdateDomainNameserversCommand.ts +++ b/clients/client-route-53-domains/commands/UpdateDomainNameserversCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateDomainNameserversCommandInput = UpdateDomainNameserversRequest; export type UpdateDomainNameserversCommandOutput = UpdateDomainNameserversResponse & __MetadataBearer; +/** + *

This operation replaces the current set of name servers for the domain with the specified set of name servers. + * If you use Amazon Route 53 as your DNS service, specify the four name servers in the delegation set for the hosted zone for the domain.

+ *

If successful, this operation returns an operation ID that you can use to track the progress and completion of the action. + * If the request is not completed successfully, the domain registrant will be notified by email.

+ */ export class UpdateDomainNameserversCommand extends $Command< UpdateDomainNameserversCommandInput, UpdateDomainNameserversCommandOutput, @@ -34,6 +40,9 @@ export class UpdateDomainNameserversCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/UpdateTagsForDomainCommand.ts b/clients/client-route-53-domains/commands/UpdateTagsForDomainCommand.ts index 7dd0bc4b98643..a581d18d80f22 100644 --- a/clients/client-route-53-domains/commands/UpdateTagsForDomainCommand.ts +++ b/clients/client-route-53-domains/commands/UpdateTagsForDomainCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateTagsForDomainCommandInput = UpdateTagsForDomainRequest; export type UpdateTagsForDomainCommandOutput = UpdateTagsForDomainResponse & __MetadataBearer; +/** + *

This operation adds or updates tags for a specified domain.

+ *

All tag operations are eventually consistent; subsequent operations might not immediately represent all issued operations.

+ */ export class UpdateTagsForDomainCommand extends $Command< UpdateTagsForDomainCommandInput, UpdateTagsForDomainCommandOutput, @@ -34,6 +38,9 @@ export class UpdateTagsForDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/commands/ViewBillingCommand.ts b/clients/client-route-53-domains/commands/ViewBillingCommand.ts index 40ce4a23d7930..009d16e5768d8 100644 --- a/clients/client-route-53-domains/commands/ViewBillingCommand.ts +++ b/clients/client-route-53-domains/commands/ViewBillingCommand.ts @@ -20,6 +20,9 @@ import { export type ViewBillingCommandInput = ViewBillingRequest; export type ViewBillingCommandOutput = ViewBillingResponse & __MetadataBearer; +/** + *

Returns all the domain-related billing records for the current AWS account for a specified period

+ */ export class ViewBillingCommand extends $Command< ViewBillingCommandInput, ViewBillingCommandOutput, @@ -34,6 +37,9 @@ export class ViewBillingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53DomainsClientResolvedConfig, diff --git a/clients/client-route-53-domains/package.json b/clients/client-route-53-domains/package.json index 6de6ce127874e..039e98a63661b 100644 --- a/clients/client-route-53-domains/package.json +++ b/clients/client-route-53-domains/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Route 53 Domains Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-route-53-domains/pagination/ListDomainsPaginator.ts b/clients/client-route-53-domains/pagination/ListDomainsPaginator.ts index d874567f16e2e..02c5de8467db4 100644 --- a/clients/client-route-53-domains/pagination/ListDomainsPaginator.ts +++ b/clients/client-route-53-domains/pagination/ListDomainsPaginator.ts @@ -4,6 +4,9 @@ import { ListDomainsCommand, ListDomainsCommandInput, ListDomainsCommandOutput } import { Route53DomainsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53DomainsClient, input: ListDomainsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Domains, input: ListDomainsCommandInput, diff --git a/clients/client-route-53-domains/pagination/ListOperationsPaginator.ts b/clients/client-route-53-domains/pagination/ListOperationsPaginator.ts index c56f0e149238f..a05558bc71e3f 100644 --- a/clients/client-route-53-domains/pagination/ListOperationsPaginator.ts +++ b/clients/client-route-53-domains/pagination/ListOperationsPaginator.ts @@ -8,6 +8,9 @@ import { import { Route53DomainsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53DomainsClient, input: ListOperationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOperationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Domains, input: ListOperationsCommandInput, diff --git a/clients/client-route-53-domains/runtimeConfig.browser.ts b/clients/client-route-53-domains/runtimeConfig.browser.ts index 5ee07a507e84b..2d2650784ac6b 100644 --- a/clients/client-route-53-domains/runtimeConfig.browser.ts +++ b/clients/client-route-53-domains/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./Route53DomainsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-route-53-domains/runtimeConfig.native.ts b/clients/client-route-53-domains/runtimeConfig.native.ts index 3c986489bbcf3..cec0f17700e7d 100644 --- a/clients/client-route-53-domains/runtimeConfig.native.ts +++ b/clients/client-route-53-domains/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./Route53DomainsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-route-53-domains/runtimeConfig.shared.ts b/clients/client-route-53-domains/runtimeConfig.shared.ts index 6fb1a44e5665c..824f01fd3cc10 100644 --- a/clients/client-route-53-domains/runtimeConfig.shared.ts +++ b/clients/client-route-53-domains/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-05-15", disableHostPrefix: false, diff --git a/clients/client-route-53-domains/runtimeConfig.ts b/clients/client-route-53-domains/runtimeConfig.ts index 8d847bddd495b..aff6ba976d8b7 100644 --- a/clients/client-route-53-domains/runtimeConfig.ts +++ b/clients/client-route-53-domains/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./Route53DomainsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-route-53-domains/tsconfig.json b/clients/client-route-53-domains/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-route-53-domains/tsconfig.json +++ b/clients/client-route-53-domains/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-route-53/commands/AssociateVPCWithHostedZoneCommand.ts b/clients/client-route-53/commands/AssociateVPCWithHostedZoneCommand.ts index c38138a597ad5..caac9cc262ec6 100644 --- a/clients/client-route-53/commands/AssociateVPCWithHostedZoneCommand.ts +++ b/clients/client-route-53/commands/AssociateVPCWithHostedZoneCommand.ts @@ -21,6 +21,19 @@ import { export type AssociateVPCWithHostedZoneCommandInput = AssociateVPCWithHostedZoneRequest; export type AssociateVPCWithHostedZoneCommandOutput = AssociateVPCWithHostedZoneResponse & __MetadataBearer; +/** + *

Associates an Amazon VPC with a private hosted zone.

+ * + *

To perform the association, the VPC and the private hosted zone must already exist. + * You can't convert a public hosted zone into a private hosted zone.

+ *
+ * + *

If you want to associate a VPC that was created by using one AWS account with a private hosted zone that was created + * by using a different account, the AWS account that created the private hosted zone must first submit a + * CreateVPCAssociationAuthorization request. Then the account that created the VPC must submit an + * AssociateVPCWithHostedZone request.

+ *
+ */ export class AssociateVPCWithHostedZoneCommand extends $Command< AssociateVPCWithHostedZoneCommandInput, AssociateVPCWithHostedZoneCommandOutput, @@ -35,6 +48,9 @@ export class AssociateVPCWithHostedZoneCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ChangeResourceRecordSetsCommand.ts b/clients/client-route-53/commands/ChangeResourceRecordSetsCommand.ts index 930ee0c24c2bc..457fa52613e85 100644 --- a/clients/client-route-53/commands/ChangeResourceRecordSetsCommand.ts +++ b/clients/client-route-53/commands/ChangeResourceRecordSetsCommand.ts @@ -21,6 +21,90 @@ import { export type ChangeResourceRecordSetsCommandInput = ChangeResourceRecordSetsRequest; export type ChangeResourceRecordSetsCommandOutput = ChangeResourceRecordSetsResponse & __MetadataBearer; +/** + *

Creates, changes, or deletes a resource record set, which contains authoritative DNS information for a specified + * domain name or subdomain name. For example, you can use ChangeResourceRecordSets to create a resource record set that + * routes traffic for test.example.com to a web server that has an IP address of 192.0.2.44.

+ * + *

+ * Deleting Resource Record Sets + *

+ *

To delete a resource record set, you must specify all the same values that you specified when you created it.

+ * + *

+ * Change Batches and Transactional Changes + *

+ *

The request body must include a document with a ChangeResourceRecordSetsRequest element. + * The request body contains a list of change items, known as a change batch. Change batches are considered transactional changes. + * Route 53 validates the changes in the request and then either makes all or none of the changes in the change batch request. + * This ensures that DNS routing isn't adversely affected by partial changes to the resource record sets in a hosted zone.

+ *

For example, suppose a change batch request contains two changes: it deletes the CNAME resource record set for www.example.com and + * creates an alias resource record set for www.example.com. If validation for both records succeeds, Route 53 deletes the first resource record set and + * creates the second resource record set in a single operation. If validation for either the DELETE or the CREATE action fails, + * then the request is canceled, and the original CNAME record continues to exist.

+ * + *

If you try to delete the same resource record set more than once in a single change batch, Route 53 returns an InvalidChangeBatch error.

+ *
+ * + *

+ * Traffic Flow + *

+ *

To create resource record sets for complex routing configurations, use either the traffic flow visual editor in the + * Route 53 console or the API actions for traffic policies and traffic policy instances. Save the configuration as a traffic policy, + * then associate the traffic policy with one or more domain names (such as example.com) or subdomain names (such as www.example.com), + * in the same hosted zone or in multiple hosted zones. You can roll back the updates if the new configuration isn't performing + * as expected. For more information, see Using Traffic Flow to Route DNS Traffic + * in the Amazon Route 53 Developer Guide.

+ * + *

+ * Create, Delete, and Upsert + *

+ *

Use ChangeResourceRecordsSetsRequest to perform the following actions:

+ *
    + *
  • + *

    + * CREATE: Creates a resource record set that has the specified values.

    + *
  • + *
  • + *

    + * DELETE: Deletes an existing resource record set that has the specified values.

    + *
  • + *
  • + *

    + * UPSERT: If a resource record set does not already exist, AWS creates it. + * If a resource set does exist, Route 53 updates it with the values in the request.

    + *
  • + *
+ * + *

+ * Syntaxes for Creating, Updating, and Deleting Resource Record Sets + *

+ *

The syntax for a request depends on the type of resource record set that you want to create, delete, or update, such as + * weighted, alias, or failover. The XML elements in your request must appear in the order listed in the syntax.

+ * + * + *

For an example for each type of resource record set, see "Examples."

+ * + * + *

Don't refer to the syntax in the "Parameter Syntax" section, which includes all of the elements for every kind of + * resource record set that you can create, delete, or update by using ChangeResourceRecordSets.

+ * + *

+ * Change Propagation to Route 53 DNS Servers + *

+ *

When you submit a ChangeResourceRecordSets request, Route 53 propagates your changes to all of the + * Route 53 authoritative DNS servers. While your changes are propagating, GetChange returns a status of + * PENDING. When propagation is complete, GetChange returns a status of INSYNC. + * Changes generally propagate to all Route 53 name servers within 60 seconds. For more information, see + * GetChange.

+ * + *

+ * Limits on ChangeResourceRecordSets Requests + *

+ *

For information about the limits on a ChangeResourceRecordSets request, see + * Limits in the + * Amazon Route 53 Developer Guide.

+ */ export class ChangeResourceRecordSetsCommand extends $Command< ChangeResourceRecordSetsCommandInput, ChangeResourceRecordSetsCommandOutput, @@ -35,6 +119,9 @@ export class ChangeResourceRecordSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ChangeTagsForResourceCommand.ts b/clients/client-route-53/commands/ChangeTagsForResourceCommand.ts index db2ef9c43984f..f08b1a9627644 100644 --- a/clients/client-route-53/commands/ChangeTagsForResourceCommand.ts +++ b/clients/client-route-53/commands/ChangeTagsForResourceCommand.ts @@ -20,6 +20,12 @@ import { export type ChangeTagsForResourceCommandInput = ChangeTagsForResourceRequest; export type ChangeTagsForResourceCommandOutput = ChangeTagsForResourceResponse & __MetadataBearer; +/** + *

Adds, edits, or deletes tags for a health check or a hosted zone.

+ *

For information about using tags for cost allocation, see + * Using Cost Allocation Tags + * in the AWS Billing and Cost Management User Guide.

+ */ export class ChangeTagsForResourceCommand extends $Command< ChangeTagsForResourceCommandInput, ChangeTagsForResourceCommandOutput, @@ -34,6 +40,9 @@ export class ChangeTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/CreateHealthCheckCommand.ts b/clients/client-route-53/commands/CreateHealthCheckCommand.ts index f2d2db660f59a..22538eb61ff2c 100644 --- a/clients/client-route-53/commands/CreateHealthCheckCommand.ts +++ b/clients/client-route-53/commands/CreateHealthCheckCommand.ts @@ -20,6 +20,42 @@ import { export type CreateHealthCheckCommandInput = CreateHealthCheckRequest; export type CreateHealthCheckCommandOutput = CreateHealthCheckResponse & __MetadataBearer; +/** + *

Creates a new health check.

+ *

For information about adding health checks to resource record sets, see + * HealthCheckId + * in + * ChangeResourceRecordSets.

+ * + *

+ * ELB Load Balancers + *

+ *

If you're registering EC2 instances with an Elastic Load Balancing (ELB) load balancer, do not create Amazon Route 53 health checks for the + * EC2 instances. When you register an EC2 instance with a load balancer, you configure settings for an ELB health check, which performs a + * similar function to a Route 53 health check.

+ * + *

+ * Private Hosted Zones + *

+ *

You can associate health checks with failover resource record sets in a private hosted zone. Note the following:

+ *
    + *
  • + *

    Route 53 health checkers are outside the VPC. To check the health of an endpoint within a VPC by IP address, you must + * assign a public IP address to the instance in the VPC.

    + *
  • + *
  • + *

    You can configure a health checker to check the health of an external resource that the instance relies on, such as a + * database server.

    + *
  • + *
  • + *

    You can create a CloudWatch metric, associate an alarm with the metric, and then create a health check that is based on the + * state of the alarm. For example, you might create a CloudWatch metric that checks the status of the Amazon EC2 StatusCheckFailed metric, + * add an alarm to the metric, and then create a health check that is based on the state of the alarm. For information about creating + * CloudWatch metrics and alarms by using the CloudWatch console, see the + * Amazon CloudWatch User Guide.

    + *
  • + *
+ */ export class CreateHealthCheckCommand extends $Command< CreateHealthCheckCommandInput, CreateHealthCheckCommandOutput, @@ -34,6 +70,9 @@ export class CreateHealthCheckCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/CreateHostedZoneCommand.ts b/clients/client-route-53/commands/CreateHostedZoneCommand.ts index 1f053f1c16243..b85ce87aff0cc 100644 --- a/clients/client-route-53/commands/CreateHostedZoneCommand.ts +++ b/clients/client-route-53/commands/CreateHostedZoneCommand.ts @@ -21,6 +21,40 @@ import { export type CreateHostedZoneCommandInput = CreateHostedZoneRequest; export type CreateHostedZoneCommandOutput = CreateHostedZoneResponse & __MetadataBearer; +/** + *

Creates a new public or private hosted zone. You create records in a public hosted zone to define how you want to route traffic + * on the internet for a domain, such as example.com, and its subdomains (apex.example.com, acme.example.com). You create records in a + * private hosted zone to define how you want to route traffic for a domain and its subdomains within one or more + * Amazon Virtual Private Clouds (Amazon VPCs).

+ * + *

You can't convert a public hosted zone to a private hosted zone or vice versa. Instead, you must create a new hosted zone + * with the same name and create new resource record sets.

+ *
+ *

For more information about charges for hosted zones, see Amazon Route 53 Pricing.

+ *

Note the following:

+ *
    + *
  • + *

    You can't create a hosted zone for a top-level domain (TLD) such as .com.

    + *
  • + *
  • + *

    For public hosted zones, Route 53 automatically creates a default SOA record and four NS records for the zone. + * For more information about SOA and NS records, see + * NS and SOA Records that Route 53 Creates for a Hosted Zone in the + * Amazon Route 53 Developer Guide.

    + *

    If you want to use the same name servers for multiple public hosted zones, you can optionally associate a reusable delegation set + * with the hosted zone. See the DelegationSetId element.

    + *
  • + *
  • + *

    If your domain is registered with a registrar other than Route 53, you must update the name servers with your registrar to make + * Route 53 the DNS service for the domain. For more information, see + * Migrating DNS Service for an Existing Domain to Amazon Route 53 in the + * Amazon Route 53 Developer Guide.

    + *
  • + *
+ *

When you submit a CreateHostedZone request, the initial status of the hosted zone is PENDING. + * For public hosted zones, this means that the NS and SOA records are not yet available on all Route 53 DNS servers. When the + * NS and SOA records are available, the status of the zone changes to INSYNC.

+ */ export class CreateHostedZoneCommand extends $Command< CreateHostedZoneCommandInput, CreateHostedZoneCommandOutput, @@ -35,6 +69,9 @@ export class CreateHostedZoneCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/CreateQueryLoggingConfigCommand.ts b/clients/client-route-53/commands/CreateQueryLoggingConfigCommand.ts index 0cee204cf1d79..db3160afde39e 100644 --- a/clients/client-route-53/commands/CreateQueryLoggingConfigCommand.ts +++ b/clients/client-route-53/commands/CreateQueryLoggingConfigCommand.ts @@ -21,6 +21,125 @@ import { export type CreateQueryLoggingConfigCommandInput = CreateQueryLoggingConfigRequest; export type CreateQueryLoggingConfigCommandOutput = CreateQueryLoggingConfigResponse & __MetadataBearer; +/** + *

Creates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 begins to publish + * log data to an Amazon CloudWatch Logs log group.

+ *

DNS query logs contain information about the queries that Route 53 receives for a specified public hosted zone, such as the following:

+ *
    + *
  • + *

    Route 53 edge location that responded to the DNS query

    + *
  • + *
  • + *

    Domain or subdomain that was requested

    + *
  • + *
  • + *

    DNS record type, such as A or AAAA

    + *
  • + *
  • + *

    DNS response code, such as NoError or ServFail + *

    + *
  • + *
+ * + *
+ *
Log Group and Resource Policy
+ *
+ *

Before you create a query logging configuration, perform the following operations.

+ * + *

If you create a query logging configuration using the Route 53 console, Route 53 performs these operations automatically.

+ *
+ *
    + *
  1. + *

    Create a CloudWatch Logs log group, and make note of the ARN, which you specify when you create a + * query logging configuration. Note the following:

    + *
      + *
    • + *

      You must create the log group in the us-east-1 region.

      + *
    • + *
    • + *

      You must use the same AWS account to create the log group and the hosted zone that you want to + * configure query logging for.

      + *
    • + *
    • + *

      When you create log groups for query logging, we recommend that you use a consistent prefix, for example:

      + *

      + * /aws/route53/hosted zone name + * + *

      + *

      In the next step, you'll create a resource policy, which controls access to one or more log groups and the associated + * AWS resources, such as Route 53 hosted zones. There's a limit on the number of resource policies that you can create, so + * we recommend that you use a consistent prefix so you can use the same resource policy for all the log groups that you create + * for query logging.

      + *
    • + *
    + *
  2. + *
  3. + *

    Create a CloudWatch Logs resource policy, and give it the permissions that Route 53 needs to create log streams and to + * send query logs to log streams. For the value of Resource, specify the ARN for the log group that you created + * in the previous step. To use the same resource policy for all the CloudWatch Logs log groups that you created for query logging configurations, + * replace the hosted zone name with *, for example:

    + *

    + * arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/* + *

    + * + *

    You can't use the CloudWatch console to create or edit a resource policy. You must use the CloudWatch API, one of the AWS SDKs, + * or the AWS CLI.

    + *
    + *
  4. + *
+ *
+ *
Log Streams and Edge Locations
+ *
+ *

When Route 53 finishes creating the configuration for DNS query logging, it does the following:

+ *
    + *
  • + *

    Creates a log stream for an edge location the first time that the edge location responds to DNS queries for the + * specified hosted zone. That log stream is used to log all queries that Route 53 responds to for that edge location.

    + *
  • + *
  • + *

    Begins to send query logs to the applicable log stream.

    + *
  • + *
+ *

The name of each log stream is in the following format:

+ *

+ * + * hosted zone ID/edge location code + * + *

+ *

The edge location code is a three-letter code and an arbitrarily assigned number, for example, DFW3. The three-letter code + * typically corresponds with the International Air Transport Association airport code for an airport near the edge location. + * (These abbreviations might change in the future.) For a list of edge locations, see "The Route 53 Global Network" on the + * Route 53 Product Details page.

+ *
+ *
Queries That Are Logged
+ *
+ *

Query logs contain only the queries that DNS resolvers forward to Route 53. If a DNS resolver has already cached + * the response to a query (such as the IP address for a load balancer for example.com), the resolver will continue to return + * the cached response. It doesn't forward another query to Route 53 until the TTL for the corresponding resource record set expires. + * Depending on how many DNS queries are submitted for a resource record set, and depending on the TTL for that resource record set, + * query logs might contain information about only one query out of every several thousand queries that are submitted to DNS. + * For more information about how DNS works, see + * Routing Internet Traffic to Your Website or Web Application + * in the Amazon Route 53 Developer Guide.

+ *
+ *
Log File Format
+ *
+ *

For a list of the values in each query log and the format of each value, see + * Logging DNS Queries in the + * Amazon Route 53 Developer Guide.

+ *
+ *
Pricing
+ *
+ *

For information about charges for query logs, see + * Amazon CloudWatch Pricing.

+ *
+ *
How to Stop Logging
+ *
+ *

If you want Route 53 to stop sending query logs to CloudWatch Logs, delete the query logging configuration. For more information, see + * DeleteQueryLoggingConfig.

+ *
+ *
+ */ export class CreateQueryLoggingConfigCommand extends $Command< CreateQueryLoggingConfigCommandInput, CreateQueryLoggingConfigCommandOutput, @@ -35,6 +154,9 @@ export class CreateQueryLoggingConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/CreateReusableDelegationSetCommand.ts b/clients/client-route-53/commands/CreateReusableDelegationSetCommand.ts index 82566b7742b31..8e07a31e157ce 100644 --- a/clients/client-route-53/commands/CreateReusableDelegationSetCommand.ts +++ b/clients/client-route-53/commands/CreateReusableDelegationSetCommand.ts @@ -21,6 +21,59 @@ import { export type CreateReusableDelegationSetCommandInput = CreateReusableDelegationSetRequest; export type CreateReusableDelegationSetCommandOutput = CreateReusableDelegationSetResponse & __MetadataBearer; +/** + *

Creates a delegation set (a group of four name servers) that can be reused by multiple hosted zones that were created by + * the same AWS account.

+ *

You can also create a reusable delegation set that uses the four name servers that are associated + * with an existing hosted zone. Specify the hosted zone ID in the CreateReusableDelegationSet request.

+ * + *

You can't associate a reusable delegation set with a private hosted zone.

+ *
+ *

For information about using a reusable delegation set to configure white label name servers, see + * Configuring White Label Name Servers.

+ * + *

The process for migrating existing hosted zones to use a reusable delegation set is comparable to the process for + * configuring white label name servers. You need to perform the following steps:

+ *
    + *
  1. + *

    Create a reusable delegation set.

    + *
  2. + *
  3. + *

    Recreate hosted zones, and reduce the TTL to 60 seconds or less.

    + *
  4. + *
  5. + *

    Recreate resource record sets in the new hosted zones.

    + *
  6. + *
  7. + *

    Change the registrar's name servers to use the name servers for the new hosted zones.

    + *
  8. + *
  9. + *

    Monitor traffic for the website or application.

    + *
  10. + *
  11. + *

    Change TTLs back to their original values.

    + *
  12. + *
+ * + *

If you want to migrate existing hosted zones to use a reusable delegation set, the existing hosted zones can't use + * any of the name servers that are assigned to the reusable delegation set. If one or more hosted zones do use one or more + * name servers that are assigned to the reusable delegation set, you can do one of the following:

+ *
    + *
  • + *

    For small numbers of hosted zones—up to a few hundred—it's relatively easy to create + * reusable delegation sets until you get one that has four name servers that don't overlap with any of the name servers + * in your hosted zones.

    + *
  • + *
  • + *

    For larger numbers of hosted zones, the easiest solution is to use more than one reusable delegation set.

    + *
  • + *
  • + *

    For larger numbers of hosted zones, you can also migrate hosted zones that have overlapping name servers + * to hosted zones that don't have overlapping name servers, then migrate the hosted zones again to use the + * reusable delegation set.

    + *
  • + *
+ */ export class CreateReusableDelegationSetCommand extends $Command< CreateReusableDelegationSetCommandInput, CreateReusableDelegationSetCommandOutput, @@ -35,6 +88,9 @@ export class CreateReusableDelegationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/CreateTrafficPolicyCommand.ts b/clients/client-route-53/commands/CreateTrafficPolicyCommand.ts index 3c4ef143c6b05..13a9bfa7911af 100644 --- a/clients/client-route-53/commands/CreateTrafficPolicyCommand.ts +++ b/clients/client-route-53/commands/CreateTrafficPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type CreateTrafficPolicyCommandInput = CreateTrafficPolicyRequest; export type CreateTrafficPolicyCommandOutput = CreateTrafficPolicyResponse & __MetadataBearer; +/** + *

Creates a traffic policy, which you use to create multiple DNS resource record sets for one domain name (such as example.com) or + * one subdomain name (such as www.example.com).

+ */ export class CreateTrafficPolicyCommand extends $Command< CreateTrafficPolicyCommandInput, CreateTrafficPolicyCommandOutput, @@ -34,6 +38,9 @@ export class CreateTrafficPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/CreateTrafficPolicyInstanceCommand.ts b/clients/client-route-53/commands/CreateTrafficPolicyInstanceCommand.ts index 890b437f20600..5fc73ae5ebd36 100644 --- a/clients/client-route-53/commands/CreateTrafficPolicyInstanceCommand.ts +++ b/clients/client-route-53/commands/CreateTrafficPolicyInstanceCommand.ts @@ -21,6 +21,12 @@ import { export type CreateTrafficPolicyInstanceCommandInput = CreateTrafficPolicyInstanceRequest; export type CreateTrafficPolicyInstanceCommandOutput = CreateTrafficPolicyInstanceResponse & __MetadataBearer; +/** + *

Creates resource record sets in a specified hosted zone based on the settings in a specified traffic policy version. + * In addition, CreateTrafficPolicyInstance associates the resource record sets with a specified domain name (such as example.com) or + * subdomain name (such as www.example.com). Amazon Route 53 responds to DNS queries for the domain or subdomain name by using the resource record sets + * that CreateTrafficPolicyInstance created.

+ */ export class CreateTrafficPolicyInstanceCommand extends $Command< CreateTrafficPolicyInstanceCommandInput, CreateTrafficPolicyInstanceCommandOutput, @@ -35,6 +41,9 @@ export class CreateTrafficPolicyInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/CreateTrafficPolicyVersionCommand.ts b/clients/client-route-53/commands/CreateTrafficPolicyVersionCommand.ts index 0bffe40d57dc9..5c0b4ab1ae1a3 100644 --- a/clients/client-route-53/commands/CreateTrafficPolicyVersionCommand.ts +++ b/clients/client-route-53/commands/CreateTrafficPolicyVersionCommand.ts @@ -21,6 +21,13 @@ import { export type CreateTrafficPolicyVersionCommandInput = CreateTrafficPolicyVersionRequest; export type CreateTrafficPolicyVersionCommandOutput = CreateTrafficPolicyVersionResponse & __MetadataBearer; +/** + *

Creates a new version of an existing traffic policy. When you create a new version of a traffic policy, you specify the ID of the + * traffic policy that you want to update and a JSON-formatted document that describes the new version. You use traffic policies to create + * multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com). You can + * create a maximum of 1000 versions of a traffic policy. If you reach the limit and need to create another version, you'll need to start a new + * traffic policy.

+ */ export class CreateTrafficPolicyVersionCommand extends $Command< CreateTrafficPolicyVersionCommandInput, CreateTrafficPolicyVersionCommandOutput, @@ -35,6 +42,9 @@ export class CreateTrafficPolicyVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/CreateVPCAssociationAuthorizationCommand.ts b/clients/client-route-53/commands/CreateVPCAssociationAuthorizationCommand.ts index 8e7522c374f3f..36cf29e06f4d1 100644 --- a/clients/client-route-53/commands/CreateVPCAssociationAuthorizationCommand.ts +++ b/clients/client-route-53/commands/CreateVPCAssociationAuthorizationCommand.ts @@ -25,6 +25,17 @@ export type CreateVPCAssociationAuthorizationCommandInput = CreateVPCAssociation export type CreateVPCAssociationAuthorizationCommandOutput = CreateVPCAssociationAuthorizationResponse & __MetadataBearer; +/** + *

Authorizes the AWS account that created a specified VPC to submit an AssociateVPCWithHostedZone + * request to associate the VPC with a specified hosted zone that was created by a different account. + * To submit a CreateVPCAssociationAuthorization request, you must use the account that created the + * hosted zone. After you authorize the association, use the account that created the VPC to submit an + * AssociateVPCWithHostedZone request.

+ * + *

If you want to associate multiple VPCs that you created by using one account with a hosted zone + * that you created by using a different account, you must submit one authorization request for each VPC.

+ *
+ */ export class CreateVPCAssociationAuthorizationCommand extends $Command< CreateVPCAssociationAuthorizationCommandInput, CreateVPCAssociationAuthorizationCommandOutput, @@ -39,6 +50,9 @@ export class CreateVPCAssociationAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/DeleteHealthCheckCommand.ts b/clients/client-route-53/commands/DeleteHealthCheckCommand.ts index 62f673d610031..67ff77f7d6f54 100644 --- a/clients/client-route-53/commands/DeleteHealthCheckCommand.ts +++ b/clients/client-route-53/commands/DeleteHealthCheckCommand.ts @@ -20,6 +20,22 @@ import { export type DeleteHealthCheckCommandInput = DeleteHealthCheckRequest; export type DeleteHealthCheckCommandOutput = DeleteHealthCheckResponse & __MetadataBearer; +/** + *

Deletes a health check.

+ * + *

Amazon Route 53 does not prevent you from deleting a health check even if the health check is associated with one or more + * resource record sets. If you delete a health check and you don't update the associated resource record sets, the future status + * of the health check can't be predicted and may change. This will affect the routing of DNS queries for your DNS failover + * configuration. For more information, see + * Replacing and Deleting Health Checks + * in the Amazon Route 53 Developer Guide.

+ *
+ * + *

If you're using AWS Cloud Map and you configured Cloud Map to create a Route 53 health check when you register an instance, + * you can't use the Route 53 DeleteHealthCheck command to delete the health check. The health check is deleted + * automatically when you deregister the instance; there can be a delay of several hours before the health check is deleted + * from Route 53.

+ */ export class DeleteHealthCheckCommand extends $Command< DeleteHealthCheckCommandInput, DeleteHealthCheckCommandOutput, @@ -34,6 +50,9 @@ export class DeleteHealthCheckCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/DeleteHostedZoneCommand.ts b/clients/client-route-53/commands/DeleteHostedZoneCommand.ts index a71995b020dfb..35210e2e096b2 100644 --- a/clients/client-route-53/commands/DeleteHostedZoneCommand.ts +++ b/clients/client-route-53/commands/DeleteHostedZoneCommand.ts @@ -21,6 +21,47 @@ import { export type DeleteHostedZoneCommandInput = DeleteHostedZoneRequest; export type DeleteHostedZoneCommandOutput = DeleteHostedZoneResponse & __MetadataBearer; +/** + *

Deletes a hosted zone.

+ * + *

If the hosted zone was created by another service, such as AWS Cloud Map, see + * Deleting + * Public Hosted Zones That Were Created by Another Service in the Amazon Route 53 Developer Guide for information about how to delete it. + * (The process is the same for public and private hosted zones that were created by another service.)

+ * + *

If you want to keep your domain registration but you want to stop routing internet traffic to your website or web application, + * we recommend that you delete resource record sets in the hosted zone instead of deleting the hosted zone.

+ * + * + *

If you delete a hosted zone, you can't undelete it. You must create a new hosted zone and update the name servers for your + * domain registration, which can require up to 48 hours to take effect. (If you delegated responsibility for a subdomain to a hosted zone + * and you delete the child hosted zone, you must update the name servers in the parent hosted zone.) In addition, if you delete a hosted zone, + * someone could hijack the domain and route traffic to their own resources using your domain name.

+ *
+ * + *

If you want to avoid the monthly charge for the hosted zone, you can transfer DNS service for the domain to a free DNS service. + * When you transfer DNS service, you have to update the name servers for the domain registration. If the domain is registered with Route 53, + * see UpdateDomainNameservers + * for information about how to replace Route 53 name servers with name servers for the new DNS service. If the domain is registered with + * another registrar, use the method provided by the registrar to update name servers for the domain registration. For more information, + * perform an internet search on "free DNS service."

+ * + *

You can delete a hosted zone only if it contains only the default SOA record and NS resource record sets. + * If the hosted zone contains other resource record sets, you must delete them before you can delete the hosted zone. + * If you try to delete a hosted zone that contains other resource record sets, the request fails, and Route 53 returns a + * HostedZoneNotEmpty error. For information about deleting records from your hosted zone, see + * ChangeResourceRecordSets.

+ *

To verify that the hosted zone has been deleted, do one of the following:

+ *
    + *
  • + *

    Use the GetHostedZone action to request information about the hosted zone.

    + *
  • + *
  • + *

    Use the ListHostedZones action to get a list of the hosted zones associated with the current + * AWS account.

    + *
  • + *
+ */ export class DeleteHostedZoneCommand extends $Command< DeleteHostedZoneCommandInput, DeleteHostedZoneCommandOutput, @@ -35,6 +76,9 @@ export class DeleteHostedZoneCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/DeleteQueryLoggingConfigCommand.ts b/clients/client-route-53/commands/DeleteQueryLoggingConfigCommand.ts index 63b17668d00c4..6c8a11db41363 100644 --- a/clients/client-route-53/commands/DeleteQueryLoggingConfigCommand.ts +++ b/clients/client-route-53/commands/DeleteQueryLoggingConfigCommand.ts @@ -21,6 +21,13 @@ import { export type DeleteQueryLoggingConfigCommandInput = DeleteQueryLoggingConfigRequest; export type DeleteQueryLoggingConfigCommandOutput = DeleteQueryLoggingConfigResponse & __MetadataBearer; +/** + *

Deletes a configuration for DNS query logging. If you delete a configuration, Amazon Route 53 stops sending query logs to CloudWatch Logs. + * Route 53 doesn't delete any logs that are already in CloudWatch Logs.

+ * + *

For more information about DNS query logs, see + * CreateQueryLoggingConfig.

+ */ export class DeleteQueryLoggingConfigCommand extends $Command< DeleteQueryLoggingConfigCommandInput, DeleteQueryLoggingConfigCommandOutput, @@ -35,6 +42,9 @@ export class DeleteQueryLoggingConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/DeleteReusableDelegationSetCommand.ts b/clients/client-route-53/commands/DeleteReusableDelegationSetCommand.ts index 6db10adb1bf81..22a32f240b756 100644 --- a/clients/client-route-53/commands/DeleteReusableDelegationSetCommand.ts +++ b/clients/client-route-53/commands/DeleteReusableDelegationSetCommand.ts @@ -21,6 +21,15 @@ import { export type DeleteReusableDelegationSetCommandInput = DeleteReusableDelegationSetRequest; export type DeleteReusableDelegationSetCommandOutput = DeleteReusableDelegationSetResponse & __MetadataBearer; +/** + *

Deletes a reusable delegation set.

+ * + *

You can delete a reusable delegation set only if it isn't associated with any hosted zones.

+ *
+ *

To verify that the reusable delegation set is not associated with any hosted zones, submit a + * GetReusableDelegationSet + * request and specify the ID of the reusable delegation set that you want to delete.

+ */ export class DeleteReusableDelegationSetCommand extends $Command< DeleteReusableDelegationSetCommandInput, DeleteReusableDelegationSetCommandOutput, @@ -35,6 +44,9 @@ export class DeleteReusableDelegationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/DeleteTrafficPolicyCommand.ts b/clients/client-route-53/commands/DeleteTrafficPolicyCommand.ts index 97a3a80c4279b..2ce3c4e4fae10 100644 --- a/clients/client-route-53/commands/DeleteTrafficPolicyCommand.ts +++ b/clients/client-route-53/commands/DeleteTrafficPolicyCommand.ts @@ -21,6 +21,23 @@ import { export type DeleteTrafficPolicyCommandInput = DeleteTrafficPolicyRequest; export type DeleteTrafficPolicyCommandOutput = DeleteTrafficPolicyResponse & __MetadataBearer; +/** + *

Deletes a traffic policy.

+ *

When you delete a traffic policy, Route 53 sets a flag on the policy to indicate that it has been deleted. However, Route 53 never fully deletes + * the traffic policy. Note the following:

+ *
    + *
  • + *

    Deleted traffic policies aren't listed if you run ListTrafficPolicies.

    + *
  • + *
  • + *

    There's no way to get a list of deleted policies.

    + *
  • + *
  • + *

    If you retain the ID of the policy, you can get information about the policy, including the traffic policy document, by running + * GetTrafficPolicy.

    + *
  • + *
+ */ export class DeleteTrafficPolicyCommand extends $Command< DeleteTrafficPolicyCommandInput, DeleteTrafficPolicyCommandOutput, @@ -35,6 +52,9 @@ export class DeleteTrafficPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/DeleteTrafficPolicyInstanceCommand.ts b/clients/client-route-53/commands/DeleteTrafficPolicyInstanceCommand.ts index 5a7f0936d6e62..b66c14ba42151 100644 --- a/clients/client-route-53/commands/DeleteTrafficPolicyInstanceCommand.ts +++ b/clients/client-route-53/commands/DeleteTrafficPolicyInstanceCommand.ts @@ -21,6 +21,12 @@ import { export type DeleteTrafficPolicyInstanceCommandInput = DeleteTrafficPolicyInstanceRequest; export type DeleteTrafficPolicyInstanceCommandOutput = DeleteTrafficPolicyInstanceResponse & __MetadataBearer; +/** + *

Deletes a traffic policy instance and all of the resource record sets that Amazon Route 53 created when you created the instance.

+ * + *

In the Route 53 console, traffic policy instances are known as policy records.

+ *
+ */ export class DeleteTrafficPolicyInstanceCommand extends $Command< DeleteTrafficPolicyInstanceCommandInput, DeleteTrafficPolicyInstanceCommandOutput, @@ -35,6 +41,9 @@ export class DeleteTrafficPolicyInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/DeleteVPCAssociationAuthorizationCommand.ts b/clients/client-route-53/commands/DeleteVPCAssociationAuthorizationCommand.ts index 98d76ca84165a..0d26055d7360f 100644 --- a/clients/client-route-53/commands/DeleteVPCAssociationAuthorizationCommand.ts +++ b/clients/client-route-53/commands/DeleteVPCAssociationAuthorizationCommand.ts @@ -25,6 +25,17 @@ export type DeleteVPCAssociationAuthorizationCommandInput = DeleteVPCAssociation export type DeleteVPCAssociationAuthorizationCommandOutput = DeleteVPCAssociationAuthorizationResponse & __MetadataBearer; +/** + *

Removes authorization to submit an AssociateVPCWithHostedZone request to associate a specified VPC + * with a hosted zone that was created by a different account. You must use the account that created the hosted zone + * to submit a DeleteVPCAssociationAuthorization request.

+ * + *

Sending this request only prevents the AWS account that created the VPC from associating the VPC + * with the Amazon Route 53 hosted zone in the future. If the VPC is already associated with the hosted zone, + * DeleteVPCAssociationAuthorization won't disassociate the VPC from the hosted zone. + * If you want to delete an existing association, use DisassociateVPCFromHostedZone.

+ *
+ */ export class DeleteVPCAssociationAuthorizationCommand extends $Command< DeleteVPCAssociationAuthorizationCommandInput, DeleteVPCAssociationAuthorizationCommandOutput, @@ -39,6 +50,9 @@ export class DeleteVPCAssociationAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/DisassociateVPCFromHostedZoneCommand.ts b/clients/client-route-53/commands/DisassociateVPCFromHostedZoneCommand.ts index 14df3d6e1307b..76c74e201574a 100644 --- a/clients/client-route-53/commands/DisassociateVPCFromHostedZoneCommand.ts +++ b/clients/client-route-53/commands/DisassociateVPCFromHostedZoneCommand.ts @@ -21,6 +21,29 @@ import { export type DisassociateVPCFromHostedZoneCommandInput = DisassociateVPCFromHostedZoneRequest; export type DisassociateVPCFromHostedZoneCommandOutput = DisassociateVPCFromHostedZoneResponse & __MetadataBearer; +/** + *

Disassociates an Amazon Virtual Private Cloud (Amazon VPC) from an Amazon Route 53 private hosted zone. Note the following:

+ *
    + *
  • + *

    You can't disassociate the last Amazon VPC from a private hosted zone.

    + *
  • + *
  • + *

    You can't convert a private hosted zone into a public hosted zone.

    + *
  • + *
  • + *

    You can submit a DisassociateVPCFromHostedZone request using either the account + * that created the hosted zone or the account that created the Amazon VPC.

    + *
  • + *
  • + *

    Some services, such as AWS Cloud Map and Amazon Elastic File System (Amazon EFS) automatically create hosted zones and associate + * VPCs with the hosted zones. A service can create a hosted zone using your account or using its own account. + * You can disassociate a VPC from a hosted zone only if the service created the hosted zone using your account.

    + *

    When you run DisassociateVPCFromHostedZone, + * if the hosted zone has a value for OwningAccount, you can use DisassociateVPCFromHostedZone. + * If the hosted zone has a value for OwningService, you can't use DisassociateVPCFromHostedZone.

    + *
  • + *
+ */ export class DisassociateVPCFromHostedZoneCommand extends $Command< DisassociateVPCFromHostedZoneCommandInput, DisassociateVPCFromHostedZoneCommandOutput, @@ -35,6 +58,9 @@ export class DisassociateVPCFromHostedZoneCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetAccountLimitCommand.ts b/clients/client-route-53/commands/GetAccountLimitCommand.ts index 197e44edb8fc4..f35e7e71e524f 100644 --- a/clients/client-route-53/commands/GetAccountLimitCommand.ts +++ b/clients/client-route-53/commands/GetAccountLimitCommand.ts @@ -20,6 +20,18 @@ import { export type GetAccountLimitCommandInput = GetAccountLimitRequest; export type GetAccountLimitCommandOutput = GetAccountLimitResponse & __MetadataBearer; +/** + *

Gets the specified limit for the current account, for example, the maximum number of health checks that you + * can create using the account.

+ *

For the default limit, see Limits + * in the Amazon Route 53 Developer Guide. To request a higher limit, + * open a case.

+ * + *

You can also view account limits in AWS Trusted Advisor. Sign in to the AWS Management Console and open the Trusted Advisor console at + * https://console.aws.amazon.com/trustedadvisor/. Then choose + * Service limits in the navigation pane.

+ *
+ */ export class GetAccountLimitCommand extends $Command< GetAccountLimitCommandInput, GetAccountLimitCommandOutput, @@ -34,6 +46,9 @@ export class GetAccountLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetChangeCommand.ts b/clients/client-route-53/commands/GetChangeCommand.ts index 1ade63658aee8..c08a1285dd5f3 100644 --- a/clients/client-route-53/commands/GetChangeCommand.ts +++ b/clients/client-route-53/commands/GetChangeCommand.ts @@ -18,6 +18,21 @@ import { export type GetChangeCommandInput = GetChangeRequest; export type GetChangeCommandOutput = GetChangeResponse & __MetadataBearer; +/** + *

Returns the current status of a change batch request. The status is one of the + * following values:

+ *
    + *
  • + *

    + * PENDING indicates that the changes in this request have not propagated to all Amazon Route 53 DNS servers. + * This is the initial status of all change batch requests.

    + *
  • + *
  • + *

    + * INSYNC indicates that the changes have propagated to all Route 53 DNS servers.

    + *
  • + *
+ */ export class GetChangeCommand extends $Command< GetChangeCommandInput, GetChangeCommandOutput, @@ -32,6 +47,9 @@ export class GetChangeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetCheckerIpRangesCommand.ts b/clients/client-route-53/commands/GetCheckerIpRangesCommand.ts index 31a667569faff..87d4041fe9e50 100644 --- a/clients/client-route-53/commands/GetCheckerIpRangesCommand.ts +++ b/clients/client-route-53/commands/GetCheckerIpRangesCommand.ts @@ -20,6 +20,15 @@ import { export type GetCheckerIpRangesCommandInput = GetCheckerIpRangesRequest; export type GetCheckerIpRangesCommandOutput = GetCheckerIpRangesResponse & __MetadataBearer; +/** + * + *

+ * GetCheckerIpRanges still works, but we recommend that you download + * ip-ranges.json, which includes IP address ranges for all AWS services. For more information, see + * IP Address Ranges of Amazon Route 53 Servers + * in the Amazon Route 53 Developer Guide.

+ *
+ */ export class GetCheckerIpRangesCommand extends $Command< GetCheckerIpRangesCommandInput, GetCheckerIpRangesCommandOutput, @@ -34,6 +43,9 @@ export class GetCheckerIpRangesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetGeoLocationCommand.ts b/clients/client-route-53/commands/GetGeoLocationCommand.ts index 973219280fd3a..ef7041ee9880b 100644 --- a/clients/client-route-53/commands/GetGeoLocationCommand.ts +++ b/clients/client-route-53/commands/GetGeoLocationCommand.ts @@ -20,6 +20,28 @@ import { export type GetGeoLocationCommandInput = GetGeoLocationRequest; export type GetGeoLocationCommandOutput = GetGeoLocationResponse & __MetadataBearer; +/** + *

Gets information about whether a specified geographic location is supported for Amazon Route 53 geolocation + * resource record sets.

+ * + *

Use the following syntax to determine whether a continent is supported for geolocation:

+ *

+ * GET /2013-04-01/geolocation?continentcode=two-letter abbreviation for a continent + * + *

+ * + *

Use the following syntax to determine whether a country is supported for geolocation:

+ *

+ * GET /2013-04-01/geolocation?countrycode=two-character country code + * + *

+ * + *

Use the following syntax to determine whether a subdivision of a country is supported for geolocation:

+ *

+ * GET /2013-04-01/geolocation?countrycode=two-character country code&subdivisioncode=subdivision code + * + *

+ */ export class GetGeoLocationCommand extends $Command< GetGeoLocationCommandInput, GetGeoLocationCommandOutput, @@ -34,6 +56,9 @@ export class GetGeoLocationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetHealthCheckCommand.ts b/clients/client-route-53/commands/GetHealthCheckCommand.ts index bf331f1680d65..ae5ac1b5865bb 100644 --- a/clients/client-route-53/commands/GetHealthCheckCommand.ts +++ b/clients/client-route-53/commands/GetHealthCheckCommand.ts @@ -20,6 +20,9 @@ import { export type GetHealthCheckCommandInput = GetHealthCheckRequest; export type GetHealthCheckCommandOutput = GetHealthCheckResponse & __MetadataBearer; +/** + *

Gets information about a specified health check.

+ */ export class GetHealthCheckCommand extends $Command< GetHealthCheckCommandInput, GetHealthCheckCommandOutput, @@ -34,6 +37,9 @@ export class GetHealthCheckCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetHealthCheckCountCommand.ts b/clients/client-route-53/commands/GetHealthCheckCountCommand.ts index 8831e1963b62c..63b3e127f9adf 100644 --- a/clients/client-route-53/commands/GetHealthCheckCountCommand.ts +++ b/clients/client-route-53/commands/GetHealthCheckCountCommand.ts @@ -20,6 +20,9 @@ import { export type GetHealthCheckCountCommandInput = GetHealthCheckCountRequest; export type GetHealthCheckCountCommandOutput = GetHealthCheckCountResponse & __MetadataBearer; +/** + *

Retrieves the number of health checks that are associated with the current AWS account.

+ */ export class GetHealthCheckCountCommand extends $Command< GetHealthCheckCountCommandInput, GetHealthCheckCountCommandOutput, @@ -34,6 +37,9 @@ export class GetHealthCheckCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetHealthCheckLastFailureReasonCommand.ts b/clients/client-route-53/commands/GetHealthCheckLastFailureReasonCommand.ts index 7d95018733367..964d4d8420eb9 100644 --- a/clients/client-route-53/commands/GetHealthCheckLastFailureReasonCommand.ts +++ b/clients/client-route-53/commands/GetHealthCheckLastFailureReasonCommand.ts @@ -20,6 +20,9 @@ import { export type GetHealthCheckLastFailureReasonCommandInput = GetHealthCheckLastFailureReasonRequest; export type GetHealthCheckLastFailureReasonCommandOutput = GetHealthCheckLastFailureReasonResponse & __MetadataBearer; +/** + *

Gets the reason that a specified health check failed most recently.

+ */ export class GetHealthCheckLastFailureReasonCommand extends $Command< GetHealthCheckLastFailureReasonCommandInput, GetHealthCheckLastFailureReasonCommandOutput, @@ -34,6 +37,9 @@ export class GetHealthCheckLastFailureReasonCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetHealthCheckStatusCommand.ts b/clients/client-route-53/commands/GetHealthCheckStatusCommand.ts index 39d0098455638..26434d8e18a99 100644 --- a/clients/client-route-53/commands/GetHealthCheckStatusCommand.ts +++ b/clients/client-route-53/commands/GetHealthCheckStatusCommand.ts @@ -20,6 +20,9 @@ import { export type GetHealthCheckStatusCommandInput = GetHealthCheckStatusRequest; export type GetHealthCheckStatusCommandOutput = GetHealthCheckStatusResponse & __MetadataBearer; +/** + *

Gets status of a specified health check.

+ */ export class GetHealthCheckStatusCommand extends $Command< GetHealthCheckStatusCommandInput, GetHealthCheckStatusCommandOutput, @@ -34,6 +37,9 @@ export class GetHealthCheckStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetHostedZoneCommand.ts b/clients/client-route-53/commands/GetHostedZoneCommand.ts index fd35c31c64c92..fd29023d0e8b3 100644 --- a/clients/client-route-53/commands/GetHostedZoneCommand.ts +++ b/clients/client-route-53/commands/GetHostedZoneCommand.ts @@ -21,6 +21,9 @@ import { export type GetHostedZoneCommandInput = GetHostedZoneRequest; export type GetHostedZoneCommandOutput = GetHostedZoneResponse & __MetadataBearer; +/** + *

Gets information about a specified hosted zone including the four name servers assigned to the hosted zone.

+ */ export class GetHostedZoneCommand extends $Command< GetHostedZoneCommandInput, GetHostedZoneCommandOutput, @@ -35,6 +38,9 @@ export class GetHostedZoneCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetHostedZoneCountCommand.ts b/clients/client-route-53/commands/GetHostedZoneCountCommand.ts index a80e7db043f5e..4db7c73b1461f 100644 --- a/clients/client-route-53/commands/GetHostedZoneCountCommand.ts +++ b/clients/client-route-53/commands/GetHostedZoneCountCommand.ts @@ -20,6 +20,9 @@ import { export type GetHostedZoneCountCommandInput = GetHostedZoneCountRequest; export type GetHostedZoneCountCommandOutput = GetHostedZoneCountResponse & __MetadataBearer; +/** + *

Retrieves the number of hosted zones that are associated with the current AWS account.

+ */ export class GetHostedZoneCountCommand extends $Command< GetHostedZoneCountCommandInput, GetHostedZoneCountCommandOutput, @@ -34,6 +37,9 @@ export class GetHostedZoneCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetHostedZoneLimitCommand.ts b/clients/client-route-53/commands/GetHostedZoneLimitCommand.ts index 92c41396ab6c6..a516d7dc5a6a5 100644 --- a/clients/client-route-53/commands/GetHostedZoneLimitCommand.ts +++ b/clients/client-route-53/commands/GetHostedZoneLimitCommand.ts @@ -21,6 +21,13 @@ import { export type GetHostedZoneLimitCommandInput = GetHostedZoneLimitRequest; export type GetHostedZoneLimitCommandOutput = GetHostedZoneLimitResponse & __MetadataBearer; +/** + *

Gets the specified limit for a specified hosted zone, for example, the maximum number of records that you + * can create in the hosted zone.

+ *

For the default limit, see Limits + * in the Amazon Route 53 Developer Guide. To request a higher limit, + * open a case.

+ */ export class GetHostedZoneLimitCommand extends $Command< GetHostedZoneLimitCommandInput, GetHostedZoneLimitCommandOutput, @@ -35,6 +42,9 @@ export class GetHostedZoneLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetQueryLoggingConfigCommand.ts b/clients/client-route-53/commands/GetQueryLoggingConfigCommand.ts index ae40f20bf79e3..b3dfbb1efb92c 100644 --- a/clients/client-route-53/commands/GetQueryLoggingConfigCommand.ts +++ b/clients/client-route-53/commands/GetQueryLoggingConfigCommand.ts @@ -21,6 +21,14 @@ import { export type GetQueryLoggingConfigCommandInput = GetQueryLoggingConfigRequest; export type GetQueryLoggingConfigCommandOutput = GetQueryLoggingConfigResponse & __MetadataBearer; +/** + *

Gets information about a specified configuration for DNS query logging.

+ * + *

For more information about DNS query logs, see + * CreateQueryLoggingConfig + * and + * Logging DNS Queries.

+ */ export class GetQueryLoggingConfigCommand extends $Command< GetQueryLoggingConfigCommandInput, GetQueryLoggingConfigCommandOutput, @@ -35,6 +43,9 @@ export class GetQueryLoggingConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetReusableDelegationSetCommand.ts b/clients/client-route-53/commands/GetReusableDelegationSetCommand.ts index 6b1e5ead173fd..9a9eba8dfa2ae 100644 --- a/clients/client-route-53/commands/GetReusableDelegationSetCommand.ts +++ b/clients/client-route-53/commands/GetReusableDelegationSetCommand.ts @@ -21,6 +21,10 @@ import { export type GetReusableDelegationSetCommandInput = GetReusableDelegationSetRequest; export type GetReusableDelegationSetCommandOutput = GetReusableDelegationSetResponse & __MetadataBearer; +/** + *

Retrieves information about a specified reusable delegation set, including the four name servers that are assigned + * to the delegation set.

+ */ export class GetReusableDelegationSetCommand extends $Command< GetReusableDelegationSetCommandInput, GetReusableDelegationSetCommandOutput, @@ -35,6 +39,9 @@ export class GetReusableDelegationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetReusableDelegationSetLimitCommand.ts b/clients/client-route-53/commands/GetReusableDelegationSetLimitCommand.ts index 59efdb38d20f8..3050b6c68f2a8 100644 --- a/clients/client-route-53/commands/GetReusableDelegationSetLimitCommand.ts +++ b/clients/client-route-53/commands/GetReusableDelegationSetLimitCommand.ts @@ -21,6 +21,12 @@ import { export type GetReusableDelegationSetLimitCommandInput = GetReusableDelegationSetLimitRequest; export type GetReusableDelegationSetLimitCommandOutput = GetReusableDelegationSetLimitResponse & __MetadataBearer; +/** + *

Gets the maximum number of hosted zones that you can associate with the specified reusable delegation set.

+ *

For the default limit, see Limits + * in the Amazon Route 53 Developer Guide. To request a higher limit, + * open a case.

+ */ export class GetReusableDelegationSetLimitCommand extends $Command< GetReusableDelegationSetLimitCommandInput, GetReusableDelegationSetLimitCommandOutput, @@ -35,6 +41,9 @@ export class GetReusableDelegationSetLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetTrafficPolicyCommand.ts b/clients/client-route-53/commands/GetTrafficPolicyCommand.ts index b4c61728c8b0d..933a6a700b0f3 100644 --- a/clients/client-route-53/commands/GetTrafficPolicyCommand.ts +++ b/clients/client-route-53/commands/GetTrafficPolicyCommand.ts @@ -21,6 +21,12 @@ import { export type GetTrafficPolicyCommandInput = GetTrafficPolicyRequest; export type GetTrafficPolicyCommandOutput = GetTrafficPolicyResponse & __MetadataBearer; +/** + *

Gets information about a specific traffic policy version.

+ *

For information about how of deleting a traffic policy affects the response from GetTrafficPolicy, see + * DeleteTrafficPolicy. + *

+ */ export class GetTrafficPolicyCommand extends $Command< GetTrafficPolicyCommandInput, GetTrafficPolicyCommandOutput, @@ -35,6 +41,9 @@ export class GetTrafficPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetTrafficPolicyInstanceCommand.ts b/clients/client-route-53/commands/GetTrafficPolicyInstanceCommand.ts index 32f60825f2431..582ab41c43989 100644 --- a/clients/client-route-53/commands/GetTrafficPolicyInstanceCommand.ts +++ b/clients/client-route-53/commands/GetTrafficPolicyInstanceCommand.ts @@ -21,6 +21,17 @@ import { export type GetTrafficPolicyInstanceCommandInput = GetTrafficPolicyInstanceRequest; export type GetTrafficPolicyInstanceCommandOutput = GetTrafficPolicyInstanceResponse & __MetadataBearer; +/** + *

Gets information about a specified traffic policy instance.

+ * + *

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, + * there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For + * more information, see the State response element.

+ *
+ * + *

In the Route 53 console, traffic policy instances are known as policy records.

+ *
+ */ export class GetTrafficPolicyInstanceCommand extends $Command< GetTrafficPolicyInstanceCommandInput, GetTrafficPolicyInstanceCommandOutput, @@ -35,6 +46,9 @@ export class GetTrafficPolicyInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/GetTrafficPolicyInstanceCountCommand.ts b/clients/client-route-53/commands/GetTrafficPolicyInstanceCountCommand.ts index d825660793a26..7313bcf6ee1d6 100644 --- a/clients/client-route-53/commands/GetTrafficPolicyInstanceCountCommand.ts +++ b/clients/client-route-53/commands/GetTrafficPolicyInstanceCountCommand.ts @@ -20,6 +20,9 @@ import { export type GetTrafficPolicyInstanceCountCommandInput = GetTrafficPolicyInstanceCountRequest; export type GetTrafficPolicyInstanceCountCommandOutput = GetTrafficPolicyInstanceCountResponse & __MetadataBearer; +/** + *

Gets the number of traffic policy instances that are associated with the current AWS account.

+ */ export class GetTrafficPolicyInstanceCountCommand extends $Command< GetTrafficPolicyInstanceCountCommandInput, GetTrafficPolicyInstanceCountCommandOutput, @@ -34,6 +37,9 @@ export class GetTrafficPolicyInstanceCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListGeoLocationsCommand.ts b/clients/client-route-53/commands/ListGeoLocationsCommand.ts index 7a6c6d8fd11c3..e41b909898bad 100644 --- a/clients/client-route-53/commands/ListGeoLocationsCommand.ts +++ b/clients/client-route-53/commands/ListGeoLocationsCommand.ts @@ -20,6 +20,13 @@ import { export type ListGeoLocationsCommandInput = ListGeoLocationsRequest; export type ListGeoLocationsCommandOutput = ListGeoLocationsResponse & __MetadataBearer; +/** + *

Retrieves a list of supported geographic locations.

+ *

Countries are listed first, and continents are listed last. If Amazon Route 53 supports subdivisions for a country (for example, states or provinces), + * the subdivisions for that country are listed in alphabetical order immediately after the corresponding country.

+ *

For a list of supported geolocation codes, see the + * GeoLocation data type.

+ */ export class ListGeoLocationsCommand extends $Command< ListGeoLocationsCommandInput, ListGeoLocationsCommandOutput, @@ -34,6 +41,9 @@ export class ListGeoLocationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListHealthChecksCommand.ts b/clients/client-route-53/commands/ListHealthChecksCommand.ts index c4ee05dd71478..f79ffbb6e6e1c 100644 --- a/clients/client-route-53/commands/ListHealthChecksCommand.ts +++ b/clients/client-route-53/commands/ListHealthChecksCommand.ts @@ -20,6 +20,9 @@ import { export type ListHealthChecksCommandInput = ListHealthChecksRequest; export type ListHealthChecksCommandOutput = ListHealthChecksResponse & __MetadataBearer; +/** + *

Retrieve a list of the health checks that are associated with the current AWS account.

+ */ export class ListHealthChecksCommand extends $Command< ListHealthChecksCommandInput, ListHealthChecksCommandOutput, @@ -34,6 +37,9 @@ export class ListHealthChecksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListHostedZonesByNameCommand.ts b/clients/client-route-53/commands/ListHostedZonesByNameCommand.ts index 96f7303307f40..96bee9f68860c 100644 --- a/clients/client-route-53/commands/ListHostedZonesByNameCommand.ts +++ b/clients/client-route-53/commands/ListHostedZonesByNameCommand.ts @@ -21,6 +21,53 @@ import { export type ListHostedZonesByNameCommandInput = ListHostedZonesByNameRequest; export type ListHostedZonesByNameCommandOutput = ListHostedZonesByNameResponse & __MetadataBearer; +/** + *

Retrieves a list of your hosted zones in lexicographic order. The response includes a HostedZones child element + * for each hosted zone created by the current AWS account.

+ *

+ * ListHostedZonesByName sorts hosted zones by name with the labels reversed. For example:

+ * + *

+ * com.example.www. + *

+ * + *

Note the trailing dot, which can change the sort order in some circumstances.

+ *

If the domain name includes escape characters or Punycode, ListHostedZonesByName alphabetizes the domain name + * using the escaped or Punycoded value, which is the format that Amazon Route 53 saves in its database. For example, to create a hosted zone + * for exämple.com, you specify ex\344mple.com for the domain name. ListHostedZonesByName alphabetizes it as:

+ * + *

+ * com.ex\344mple. + *

+ * + *

The labels are reversed and alphabetized using the escaped value. For more information about valid domain name formats, + * including internationalized domain names, see DNS Domain Name Format in the + * Amazon Route 53 Developer Guide.

+ *

Route 53 returns up to 100 items in each response. If you have a lot of hosted zones, use the MaxItems parameter to list + * them in groups of up to 100. The response includes values that help navigate from one group of MaxItems hosted zones to the next:

+ *
    + *
  • + *

    The DNSName and HostedZoneId elements in the response contain the values, if any, specified for the + * dnsname and hostedzoneid parameters in the request that produced the current response.

    + *
  • + *
  • + *

    The MaxItems element in the response contains the value, if any, that you specified for the maxitems + * parameter in the request that produced the current response.

    + *
  • + *
  • + *

    If the value of IsTruncated in the response is true, there are more hosted zones associated with the + * current AWS account.

    + *

    If IsTruncated is false, this response includes the last hosted zone that is associated with the current account. + * The NextDNSName element and NextHostedZoneId elements are omitted from the response.

    + *
  • + *
  • + *

    The NextDNSName and NextHostedZoneId elements in the response contain the domain name and the + * hosted zone ID of the next hosted zone that is associated with the current AWS account. If you want to list more hosted zones, + * make another call to ListHostedZonesByName, and specify the value of NextDNSName and + * NextHostedZoneId in the dnsname and hostedzoneid parameters, respectively.

    + *
  • + *
+ */ export class ListHostedZonesByNameCommand extends $Command< ListHostedZonesByNameCommandInput, ListHostedZonesByNameCommandOutput, @@ -35,6 +82,9 @@ export class ListHostedZonesByNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListHostedZonesByVPCCommand.ts b/clients/client-route-53/commands/ListHostedZonesByVPCCommand.ts index b180ac7d4e039..b49050bcc7626 100644 --- a/clients/client-route-53/commands/ListHostedZonesByVPCCommand.ts +++ b/clients/client-route-53/commands/ListHostedZonesByVPCCommand.ts @@ -20,6 +20,21 @@ import { export type ListHostedZonesByVPCCommandInput = ListHostedZonesByVPCRequest; export type ListHostedZonesByVPCCommandOutput = ListHostedZonesByVPCResponse & __MetadataBearer; +/** + *

Lists all the private hosted zones that a specified VPC is associated with, regardless of which AWS account or AWS service owns the + * hosted zones. The HostedZoneOwner structure in the response contains one of the following values:

+ *
    + *
  • + *

    An OwningAccount element, which contains the account number of either the current AWS account or + * another AWS account. Some services, such as AWS Cloud Map, create hosted zones using the current account.

    + *
  • + *
  • + *

    An OwningService element, which identifies the AWS service that created and owns the hosted zone. + * For example, if a hosted zone was created by Amazon Elastic File System (Amazon EFS), the value of Owner is + * efs.amazonaws.com.

    + *
  • + *
+ */ export class ListHostedZonesByVPCCommand extends $Command< ListHostedZonesByVPCCommandInput, ListHostedZonesByVPCCommandOutput, @@ -34,6 +49,9 @@ export class ListHostedZonesByVPCCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListHostedZonesCommand.ts b/clients/client-route-53/commands/ListHostedZonesCommand.ts index 58eb2f96ced5b..c2780bb324f7e 100644 --- a/clients/client-route-53/commands/ListHostedZonesCommand.ts +++ b/clients/client-route-53/commands/ListHostedZonesCommand.ts @@ -21,6 +21,12 @@ import { export type ListHostedZonesCommandInput = ListHostedZonesRequest; export type ListHostedZonesCommandOutput = ListHostedZonesResponse & __MetadataBearer; +/** + *

Retrieves a list of the public and private hosted zones that are associated with the current AWS account. The response + * includes a HostedZones child element for each hosted zone.

+ *

Amazon Route 53 returns a maximum of 100 items in each response. If you have a lot of hosted zones, you can use the + * maxitems parameter to list them in groups of up to 100.

+ */ export class ListHostedZonesCommand extends $Command< ListHostedZonesCommandInput, ListHostedZonesCommandOutput, @@ -35,6 +41,9 @@ export class ListHostedZonesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListQueryLoggingConfigsCommand.ts b/clients/client-route-53/commands/ListQueryLoggingConfigsCommand.ts index 61919e6947c0b..b30b0aa4494d1 100644 --- a/clients/client-route-53/commands/ListQueryLoggingConfigsCommand.ts +++ b/clients/client-route-53/commands/ListQueryLoggingConfigsCommand.ts @@ -21,6 +21,16 @@ import { export type ListQueryLoggingConfigsCommandInput = ListQueryLoggingConfigsRequest; export type ListQueryLoggingConfigsCommandOutput = ListQueryLoggingConfigsResponse & __MetadataBearer; +/** + *

Lists the configurations for DNS query logging that are associated with the current AWS account or the configuration + * that is associated with a specified hosted zone.

+ * + *

For more information about DNS query logs, see + * CreateQueryLoggingConfig. + * Additional information, including the format of DNS query logs, appears in + * Logging DNS Queries + * in the Amazon Route 53 Developer Guide.

+ */ export class ListQueryLoggingConfigsCommand extends $Command< ListQueryLoggingConfigsCommandInput, ListQueryLoggingConfigsCommandOutput, @@ -35,6 +45,9 @@ export class ListQueryLoggingConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListResourceRecordSetsCommand.ts b/clients/client-route-53/commands/ListResourceRecordSetsCommand.ts index 155e5c32b057b..b8f38c280f85c 100644 --- a/clients/client-route-53/commands/ListResourceRecordSetsCommand.ts +++ b/clients/client-route-53/commands/ListResourceRecordSetsCommand.ts @@ -21,6 +21,72 @@ import { export type ListResourceRecordSetsCommandInput = ListResourceRecordSetsRequest; export type ListResourceRecordSetsCommandOutput = ListResourceRecordSetsResponse & __MetadataBearer; +/** + *

Lists the resource record sets in a specified hosted zone.

+ *

+ * ListResourceRecordSets returns up to 100 resource record sets at a time in ASCII order, + * beginning at a position specified by the name and type elements.

+ * + *

+ * Sort order + *

+ *

+ * ListResourceRecordSets sorts results first by DNS name with the labels reversed, for example:

+ *

+ * com.example.www. + *

+ *

Note the trailing dot, which can change the sort order when the record name contains characters that appear before + * . (decimal 46) in the ASCII table. These characters include the following: ! " # $ % & ' ( ) * + , - + *

+ *

When multiple records have the same DNS name, ListResourceRecordSets sorts results by the record type.

+ * + *

+ * Specifying where to start listing records + *

+ *

You can use the name and type elements to specify the resource record set that the list begins with:

+ *
+ *
If you do not specify Name or Type
+ *
+ *

The results begin with the first resource record set that the hosted zone contains.

+ *
+ *
If you specify Name but not Type
+ *
+ *

The results begin with the first resource record set in the list whose name is greater than or equal to + * Name.

+ *
+ *
If you specify Type but not Name
+ *
+ *

Amazon Route 53 returns the InvalidInput error.

+ *
+ *
If you specify both Name and Type
+ *
+ *

The results begin with the first resource record set in the list whose name is greater than or equal to + * Name, and whose type is greater than or equal to Type.

+ *
+ *
+ * + *

+ * Resource record sets that are PENDING + *

+ *

This action returns the most current version of the records. This includes records that are PENDING, + * and that are not yet available on all Route 53 DNS servers.

+ * + *

+ * Changing resource record sets + *

+ *

To ensure that you get an accurate listing of the resource record sets for a hosted zone at a point in time, + * do not submit a ChangeResourceRecordSets request while you're paging through the results of a + * ListResourceRecordSets request. If you do, some pages may display results without the latest changes + * while other pages display results with the latest changes.

+ * + *

+ * Displaying the next page of results + *

+ *

If a ListResourceRecordSets command returns more than one page of results, the value of IsTruncated + * is true. To display the next page of results, get the values of NextRecordName, NextRecordType, + * and NextRecordIdentifier (if any) from the response. Then submit another ListResourceRecordSets request, and + * specify those values for StartRecordName, StartRecordType, and StartRecordIdentifier.

+ */ export class ListResourceRecordSetsCommand extends $Command< ListResourceRecordSetsCommandInput, ListResourceRecordSetsCommandOutput, @@ -35,6 +101,9 @@ export class ListResourceRecordSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListReusableDelegationSetsCommand.ts b/clients/client-route-53/commands/ListReusableDelegationSetsCommand.ts index fa85a41d651fc..eafc71bd647e8 100644 --- a/clients/client-route-53/commands/ListReusableDelegationSetsCommand.ts +++ b/clients/client-route-53/commands/ListReusableDelegationSetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListReusableDelegationSetsCommandInput = ListReusableDelegationSetsRequest; export type ListReusableDelegationSetsCommandOutput = ListReusableDelegationSetsResponse & __MetadataBearer; +/** + *

Retrieves a list of the reusable delegation sets that are associated with the current AWS account.

+ */ export class ListReusableDelegationSetsCommand extends $Command< ListReusableDelegationSetsCommandInput, ListReusableDelegationSetsCommandOutput, @@ -34,6 +37,9 @@ export class ListReusableDelegationSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListTagsForResourceCommand.ts b/clients/client-route-53/commands/ListTagsForResourceCommand.ts index 97722ab75ac08..5df9ecf6a70fd 100644 --- a/clients/client-route-53/commands/ListTagsForResourceCommand.ts +++ b/clients/client-route-53/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,12 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists tags for one health check or hosted zone.

+ *

For information about using tags for cost allocation, see + * Using Cost Allocation Tags + * in the AWS Billing and Cost Management User Guide.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +40,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListTagsForResourcesCommand.ts b/clients/client-route-53/commands/ListTagsForResourcesCommand.ts index 4e4a5d4f0ad19..8b1d826e65454 100644 --- a/clients/client-route-53/commands/ListTagsForResourcesCommand.ts +++ b/clients/client-route-53/commands/ListTagsForResourcesCommand.ts @@ -20,6 +20,12 @@ import { export type ListTagsForResourcesCommandInput = ListTagsForResourcesRequest; export type ListTagsForResourcesCommandOutput = ListTagsForResourcesResponse & __MetadataBearer; +/** + *

Lists tags for up to 10 health checks or hosted zones.

+ *

For information about using tags for cost allocation, see + * Using Cost Allocation Tags + * in the AWS Billing and Cost Management User Guide.

+ */ export class ListTagsForResourcesCommand extends $Command< ListTagsForResourcesCommandInput, ListTagsForResourcesCommandOutput, @@ -34,6 +40,9 @@ export class ListTagsForResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListTrafficPoliciesCommand.ts b/clients/client-route-53/commands/ListTrafficPoliciesCommand.ts index 6e64ed9e9ecca..0b904abd0eab3 100644 --- a/clients/client-route-53/commands/ListTrafficPoliciesCommand.ts +++ b/clients/client-route-53/commands/ListTrafficPoliciesCommand.ts @@ -20,6 +20,15 @@ import { export type ListTrafficPoliciesCommandInput = ListTrafficPoliciesRequest; export type ListTrafficPoliciesCommandOutput = ListTrafficPoliciesResponse & __MetadataBearer; +/** + *

Gets information about the latest version for every traffic policy that is associated with the current AWS account. + * Policies are listed in the order that they were created in.

+ * + *

For information about how of deleting a traffic policy affects the response from ListTrafficPolicies, see + * DeleteTrafficPolicy. + * + *

+ */ export class ListTrafficPoliciesCommand extends $Command< ListTrafficPoliciesCommandInput, ListTrafficPoliciesCommandOutput, @@ -34,6 +43,9 @@ export class ListTrafficPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListTrafficPolicyInstancesByHostedZoneCommand.ts b/clients/client-route-53/commands/ListTrafficPolicyInstancesByHostedZoneCommand.ts index 719144c0c7cad..91c9b5dd2d0ef 100644 --- a/clients/client-route-53/commands/ListTrafficPolicyInstancesByHostedZoneCommand.ts +++ b/clients/client-route-53/commands/ListTrafficPolicyInstancesByHostedZoneCommand.ts @@ -25,6 +25,16 @@ export type ListTrafficPolicyInstancesByHostedZoneCommandInput = ListTrafficPoli export type ListTrafficPolicyInstancesByHostedZoneCommandOutput = ListTrafficPolicyInstancesByHostedZoneResponse & __MetadataBearer; +/** + *

Gets information about the traffic policy instances that you created in a specified hosted zone.

+ * + *

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, there's a + * brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For more information, + * see the State response element.

+ *
+ *

Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the + * MaxItems parameter to list them in groups of up to 100.

+ */ export class ListTrafficPolicyInstancesByHostedZoneCommand extends $Command< ListTrafficPolicyInstancesByHostedZoneCommandInput, ListTrafficPolicyInstancesByHostedZoneCommandOutput, @@ -39,6 +49,9 @@ export class ListTrafficPolicyInstancesByHostedZoneCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListTrafficPolicyInstancesByPolicyCommand.ts b/clients/client-route-53/commands/ListTrafficPolicyInstancesByPolicyCommand.ts index 2923caf036d07..0512a6532e8f8 100644 --- a/clients/client-route-53/commands/ListTrafficPolicyInstancesByPolicyCommand.ts +++ b/clients/client-route-53/commands/ListTrafficPolicyInstancesByPolicyCommand.ts @@ -24,6 +24,16 @@ export type ListTrafficPolicyInstancesByPolicyCommandInput = ListTrafficPolicyIn export type ListTrafficPolicyInstancesByPolicyCommandOutput = ListTrafficPolicyInstancesByPolicyResponse & __MetadataBearer; +/** + *

Gets information about the traffic policy instances that you created by using a specify traffic policy version.

+ * + *

After you submit a CreateTrafficPolicyInstance or an UpdateTrafficPolicyInstance request, + * there's a brief delay while Amazon Route 53 creates the resource record sets that are specified in the traffic policy definition. For + * more information, see the State response element.

+ *
+ *

Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the + * MaxItems parameter to list them in groups of up to 100.

+ */ export class ListTrafficPolicyInstancesByPolicyCommand extends $Command< ListTrafficPolicyInstancesByPolicyCommandInput, ListTrafficPolicyInstancesByPolicyCommandOutput, @@ -38,6 +48,9 @@ export class ListTrafficPolicyInstancesByPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListTrafficPolicyInstancesCommand.ts b/clients/client-route-53/commands/ListTrafficPolicyInstancesCommand.ts index 602944f33dc4a..c1aa655eb6e8a 100644 --- a/clients/client-route-53/commands/ListTrafficPolicyInstancesCommand.ts +++ b/clients/client-route-53/commands/ListTrafficPolicyInstancesCommand.ts @@ -20,6 +20,15 @@ import { export type ListTrafficPolicyInstancesCommandInput = ListTrafficPolicyInstancesRequest; export type ListTrafficPolicyInstancesCommandOutput = ListTrafficPolicyInstancesResponse & __MetadataBearer; +/** + *

Gets information about the traffic policy instances that you created by using the current AWS account.

+ * + *

After you submit an UpdateTrafficPolicyInstance request, there's a brief delay while Amazon Route 53 creates the + * resource record sets that are specified in the traffic policy definition. For more information, see the State response element.

+ *
+ *

Route 53 returns a maximum of 100 items in each response. If you have a lot of traffic policy instances, you can use the + * MaxItems parameter to list them in groups of up to 100.

+ */ export class ListTrafficPolicyInstancesCommand extends $Command< ListTrafficPolicyInstancesCommandInput, ListTrafficPolicyInstancesCommandOutput, @@ -34,6 +43,9 @@ export class ListTrafficPolicyInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListTrafficPolicyVersionsCommand.ts b/clients/client-route-53/commands/ListTrafficPolicyVersionsCommand.ts index c17f6486c58e7..4d4e78d0b4829 100644 --- a/clients/client-route-53/commands/ListTrafficPolicyVersionsCommand.ts +++ b/clients/client-route-53/commands/ListTrafficPolicyVersionsCommand.ts @@ -21,6 +21,10 @@ import { export type ListTrafficPolicyVersionsCommandInput = ListTrafficPolicyVersionsRequest; export type ListTrafficPolicyVersionsCommandOutput = ListTrafficPolicyVersionsResponse & __MetadataBearer; +/** + *

Gets information about all of the versions for a specified traffic policy.

+ *

Traffic policy versions are listed in numerical order by VersionNumber.

+ */ export class ListTrafficPolicyVersionsCommand extends $Command< ListTrafficPolicyVersionsCommandInput, ListTrafficPolicyVersionsCommandOutput, @@ -35,6 +39,9 @@ export class ListTrafficPolicyVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/ListVPCAssociationAuthorizationsCommand.ts b/clients/client-route-53/commands/ListVPCAssociationAuthorizationsCommand.ts index 47f8b485adc65..b2df1fa8eb000 100644 --- a/clients/client-route-53/commands/ListVPCAssociationAuthorizationsCommand.ts +++ b/clients/client-route-53/commands/ListVPCAssociationAuthorizationsCommand.ts @@ -21,6 +21,12 @@ import { export type ListVPCAssociationAuthorizationsCommandInput = ListVPCAssociationAuthorizationsRequest; export type ListVPCAssociationAuthorizationsCommandOutput = ListVPCAssociationAuthorizationsResponse & __MetadataBearer; +/** + *

Gets a list of the VPCs that were created by other accounts and that can be associated with a + * specified hosted zone because you've submitted one or more CreateVPCAssociationAuthorization requests.

+ *

The response includes a VPCs element with a VPC child element for each VPC + * that can be associated with the hosted zone.

+ */ export class ListVPCAssociationAuthorizationsCommand extends $Command< ListVPCAssociationAuthorizationsCommandInput, ListVPCAssociationAuthorizationsCommandOutput, @@ -35,6 +41,9 @@ export class ListVPCAssociationAuthorizationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/TestDNSAnswerCommand.ts b/clients/client-route-53/commands/TestDNSAnswerCommand.ts index 7f25221124808..47a12083ca4fe 100644 --- a/clients/client-route-53/commands/TestDNSAnswerCommand.ts +++ b/clients/client-route-53/commands/TestDNSAnswerCommand.ts @@ -21,6 +21,10 @@ import { export type TestDNSAnswerCommandInput = TestDNSAnswerRequest; export type TestDNSAnswerCommandOutput = TestDNSAnswerResponse & __MetadataBearer; +/** + *

Gets the value that Amazon Route 53 returns in response to a DNS request for a specified record name and type. You can optionally specify + * the IP address of a DNS resolver, an EDNS0 client subnet IP address, and a subnet mask.

+ */ export class TestDNSAnswerCommand extends $Command< TestDNSAnswerCommandInput, TestDNSAnswerCommandOutput, @@ -35,6 +39,9 @@ export class TestDNSAnswerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/UpdateHealthCheckCommand.ts b/clients/client-route-53/commands/UpdateHealthCheckCommand.ts index 81e47b1754eab..1e494b04f8930 100644 --- a/clients/client-route-53/commands/UpdateHealthCheckCommand.ts +++ b/clients/client-route-53/commands/UpdateHealthCheckCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateHealthCheckCommandInput = UpdateHealthCheckRequest; export type UpdateHealthCheckCommandOutput = UpdateHealthCheckResponse & __MetadataBearer; +/** + *

Updates an existing health check. Note that some values can't be updated.

+ *

For more information about updating health checks, see + * Creating, Updating, and Deleting Health Checks + * in the Amazon Route 53 Developer Guide.

+ */ export class UpdateHealthCheckCommand extends $Command< UpdateHealthCheckCommandInput, UpdateHealthCheckCommandOutput, @@ -34,6 +40,9 @@ export class UpdateHealthCheckCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/UpdateHostedZoneCommentCommand.ts b/clients/client-route-53/commands/UpdateHostedZoneCommentCommand.ts index 10809ada482f2..f242095915236 100644 --- a/clients/client-route-53/commands/UpdateHostedZoneCommentCommand.ts +++ b/clients/client-route-53/commands/UpdateHostedZoneCommentCommand.ts @@ -21,6 +21,9 @@ import { export type UpdateHostedZoneCommentCommandInput = UpdateHostedZoneCommentRequest; export type UpdateHostedZoneCommentCommandOutput = UpdateHostedZoneCommentResponse & __MetadataBearer; +/** + *

Updates the comment for a specified hosted zone.

+ */ export class UpdateHostedZoneCommentCommand extends $Command< UpdateHostedZoneCommentCommandInput, UpdateHostedZoneCommentCommandOutput, @@ -35,6 +38,9 @@ export class UpdateHostedZoneCommentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/UpdateTrafficPolicyCommentCommand.ts b/clients/client-route-53/commands/UpdateTrafficPolicyCommentCommand.ts index 6b4af21483751..ac1e8a1df92c1 100644 --- a/clients/client-route-53/commands/UpdateTrafficPolicyCommentCommand.ts +++ b/clients/client-route-53/commands/UpdateTrafficPolicyCommentCommand.ts @@ -21,6 +21,9 @@ import { export type UpdateTrafficPolicyCommentCommandInput = UpdateTrafficPolicyCommentRequest; export type UpdateTrafficPolicyCommentCommandOutput = UpdateTrafficPolicyCommentResponse & __MetadataBearer; +/** + *

Updates the comment for a specified traffic policy version.

+ */ export class UpdateTrafficPolicyCommentCommand extends $Command< UpdateTrafficPolicyCommentCommandInput, UpdateTrafficPolicyCommentCommandOutput, @@ -35,6 +38,9 @@ export class UpdateTrafficPolicyCommentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/commands/UpdateTrafficPolicyInstanceCommand.ts b/clients/client-route-53/commands/UpdateTrafficPolicyInstanceCommand.ts index 4467e1a19722b..03c3739586005 100644 --- a/clients/client-route-53/commands/UpdateTrafficPolicyInstanceCommand.ts +++ b/clients/client-route-53/commands/UpdateTrafficPolicyInstanceCommand.ts @@ -21,6 +21,24 @@ import { export type UpdateTrafficPolicyInstanceCommandInput = UpdateTrafficPolicyInstanceRequest; export type UpdateTrafficPolicyInstanceCommandOutput = UpdateTrafficPolicyInstanceResponse & __MetadataBearer; +/** + *

Updates the resource record sets in a specified hosted zone that were created based on the settings in a specified traffic policy version.

+ *

When you update a traffic policy instance, Amazon Route 53 continues to respond to DNS queries for the root resource record set name + * (such as example.com) while it replaces one group of resource record sets with another. Route 53 performs the following operations:

+ *
    + *
  1. + *

    Route 53 creates a new group of resource record sets based on the specified traffic policy. This is true regardless of how significant + * the differences are between the existing resource record sets and the new resource record sets.

    + *
  2. + *
  3. + *

    When all of the new resource record sets have been created, Route 53 starts to respond to DNS queries for the root resource record set name + * (such as example.com) by using the new resource record sets.

    + *
  4. + *
  5. + *

    Route 53 deletes the old group of resource record sets that are associated with the root resource record set name.

    + *
  6. + *
+ */ export class UpdateTrafficPolicyInstanceCommand extends $Command< UpdateTrafficPolicyInstanceCommandInput, UpdateTrafficPolicyInstanceCommandOutput, @@ -35,6 +53,9 @@ export class UpdateTrafficPolicyInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ClientResolvedConfig, diff --git a/clients/client-route-53/package.json b/clients/client-route-53/package.json index 5090f963de6fb..edc5d0ca51226 100644 --- a/clients/client-route-53/package.json +++ b/clients/client-route-53/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Route 53 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-route-53/runtimeConfig.browser.ts b/clients/client-route-53/runtimeConfig.browser.ts index 02144f567a14d..d5f89996fd9c2 100644 --- a/clients/client-route-53/runtimeConfig.browser.ts +++ b/clients/client-route-53/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./Route53Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-route-53/runtimeConfig.native.ts b/clients/client-route-53/runtimeConfig.native.ts index b223a503eccfa..5ae542c98f1a3 100644 --- a/clients/client-route-53/runtimeConfig.native.ts +++ b/clients/client-route-53/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./Route53Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-route-53/runtimeConfig.shared.ts b/clients/client-route-53/runtimeConfig.shared.ts index 057f083cb3a1f..c7dfe20c8c37f 100644 --- a/clients/client-route-53/runtimeConfig.shared.ts +++ b/clients/client-route-53/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2013-04-01", disableHostPrefix: false, diff --git a/clients/client-route-53/runtimeConfig.ts b/clients/client-route-53/runtimeConfig.ts index 30fd694651fc3..1d788bdb042a4 100644 --- a/clients/client-route-53/runtimeConfig.ts +++ b/clients/client-route-53/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./Route53Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-route-53/tsconfig.json b/clients/client-route-53/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-route-53/tsconfig.json +++ b/clients/client-route-53/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-route53resolver/commands/AssociateResolverEndpointIpAddressCommand.ts b/clients/client-route53resolver/commands/AssociateResolverEndpointIpAddressCommand.ts index 2e96b7e68de2c..e5f0896494167 100644 --- a/clients/client-route53resolver/commands/AssociateResolverEndpointIpAddressCommand.ts +++ b/clients/client-route53resolver/commands/AssociateResolverEndpointIpAddressCommand.ts @@ -24,6 +24,13 @@ export type AssociateResolverEndpointIpAddressCommandInput = AssociateResolverEn export type AssociateResolverEndpointIpAddressCommandOutput = AssociateResolverEndpointIpAddressResponse & __MetadataBearer; +/** + *

Adds IP addresses to an inbound or an outbound Resolver endpoint. If you want to add more than one IP address, + * submit one AssociateResolverEndpointIpAddress request for each IP address.

+ *

To remove an IP address from an endpoint, see + * DisassociateResolverEndpointIpAddress. + *

+ */ export class AssociateResolverEndpointIpAddressCommand extends $Command< AssociateResolverEndpointIpAddressCommandInput, AssociateResolverEndpointIpAddressCommandOutput, @@ -38,6 +45,9 @@ export class AssociateResolverEndpointIpAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/AssociateResolverQueryLogConfigCommand.ts b/clients/client-route53resolver/commands/AssociateResolverQueryLogConfigCommand.ts index 136a39955c4ad..b13a64c564fb9 100644 --- a/clients/client-route53resolver/commands/AssociateResolverQueryLogConfigCommand.ts +++ b/clients/client-route53resolver/commands/AssociateResolverQueryLogConfigCommand.ts @@ -20,6 +20,19 @@ import { export type AssociateResolverQueryLogConfigCommandInput = AssociateResolverQueryLogConfigRequest; export type AssociateResolverQueryLogConfigCommandOutput = AssociateResolverQueryLogConfigResponse & __MetadataBearer; +/** + *

Associates an Amazon VPC with a specified query logging configuration. Route 53 Resolver logs DNS queries that originate in all of the Amazon VPCs + * that are associated with a specified query logging configuration. To associate more than one VPC with a configuration, submit one AssociateResolverQueryLogConfig + * request for each VPC.

+ * + * + *

The VPCs that you associate with a query logging configuration must be in the same Region as the configuration.

+ *
+ * + *

To remove a VPC from a query logging configuration, see + * DisassociateResolverQueryLogConfig. + *

+ */ export class AssociateResolverQueryLogConfigCommand extends $Command< AssociateResolverQueryLogConfigCommandInput, AssociateResolverQueryLogConfigCommandOutput, @@ -34,6 +47,9 @@ export class AssociateResolverQueryLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/AssociateResolverRuleCommand.ts b/clients/client-route53resolver/commands/AssociateResolverRuleCommand.ts index 3201874f5bece..ad348b63ffa44 100644 --- a/clients/client-route53resolver/commands/AssociateResolverRuleCommand.ts +++ b/clients/client-route53resolver/commands/AssociateResolverRuleCommand.ts @@ -20,6 +20,12 @@ import { export type AssociateResolverRuleCommandInput = AssociateResolverRuleRequest; export type AssociateResolverRuleCommandOutput = AssociateResolverRuleResponse & __MetadataBearer; +/** + *

Associates a Resolver rule with a VPC. When you associate a rule with a VPC, Resolver forwards all DNS queries + * for the domain name that is specified in the rule and that originate in the VPC. The queries are forwarded to the + * IP addresses for the DNS resolvers that are specified in the rule. For more information about rules, see + * CreateResolverRule.

+ */ export class AssociateResolverRuleCommand extends $Command< AssociateResolverRuleCommandInput, AssociateResolverRuleCommandOutput, @@ -34,6 +40,9 @@ export class AssociateResolverRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/CreateResolverEndpointCommand.ts b/clients/client-route53resolver/commands/CreateResolverEndpointCommand.ts index bd8e03931cf8f..3fe1f707c3157 100644 --- a/clients/client-route53resolver/commands/CreateResolverEndpointCommand.ts +++ b/clients/client-route53resolver/commands/CreateResolverEndpointCommand.ts @@ -20,6 +20,19 @@ import { export type CreateResolverEndpointCommandInput = CreateResolverEndpointRequest; export type CreateResolverEndpointCommandOutput = CreateResolverEndpointResponse & __MetadataBearer; +/** + *

Creates a Resolver endpoint. There are two types of Resolver endpoints, inbound and outbound:

+ *
    + *
  • + *

    An inbound Resolver endpoint forwards DNS queries to the DNS service for a VPC + * from your network.

    + *
  • + *
  • + *

    An outbound Resolver endpoint forwards DNS queries from the DNS service for a VPC + * to your network.

    + *
  • + *
+ */ export class CreateResolverEndpointCommand extends $Command< CreateResolverEndpointCommandInput, CreateResolverEndpointCommandOutput, @@ -34,6 +47,9 @@ export class CreateResolverEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/CreateResolverQueryLogConfigCommand.ts b/clients/client-route53resolver/commands/CreateResolverQueryLogConfigCommand.ts index a684e77aa342d..bfcaf7d87a851 100644 --- a/clients/client-route53resolver/commands/CreateResolverQueryLogConfigCommand.ts +++ b/clients/client-route53resolver/commands/CreateResolverQueryLogConfigCommand.ts @@ -20,6 +20,17 @@ import { export type CreateResolverQueryLogConfigCommandInput = CreateResolverQueryLogConfigRequest; export type CreateResolverQueryLogConfigCommandOutput = CreateResolverQueryLogConfigResponse & __MetadataBearer; +/** + *

Creates a Resolver query logging configuration, which defines where you want Resolver to save DNS query logs that originate in your VPCs. + * Resolver can log queries only for VPCs that are in the same Region as the query logging configuration.

+ * + *

To specify which VPCs you want to log queries for, you use AssociateResolverQueryLogConfig. For more information, see + * AssociateResolverQueryLogConfig.

+ * + *

You can optionally use AWS Resource Access Manager (AWS RAM) to share a query logging configuration with other AWS accounts. The other accounts + * can then associate VPCs with the configuration. The query logs that Resolver creates for a configuration include all DNS queries that originate in all + * VPCs that are associated with the configuration.

+ */ export class CreateResolverQueryLogConfigCommand extends $Command< CreateResolverQueryLogConfigCommandInput, CreateResolverQueryLogConfigCommandOutput, @@ -34,6 +45,9 @@ export class CreateResolverQueryLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/CreateResolverRuleCommand.ts b/clients/client-route53resolver/commands/CreateResolverRuleCommand.ts index 021757767c9e8..cc45897852b34 100644 --- a/clients/client-route53resolver/commands/CreateResolverRuleCommand.ts +++ b/clients/client-route53resolver/commands/CreateResolverRuleCommand.ts @@ -20,6 +20,10 @@ import { export type CreateResolverRuleCommandInput = CreateResolverRuleRequest; export type CreateResolverRuleCommandOutput = CreateResolverRuleResponse & __MetadataBearer; +/** + *

For DNS queries that originate in your VPCs, specifies which Resolver endpoint the queries pass through, + * one domain name that you want to forward to your network, and the IP addresses of the DNS resolvers in your network.

+ */ export class CreateResolverRuleCommand extends $Command< CreateResolverRuleCommandInput, CreateResolverRuleCommandOutput, @@ -34,6 +38,9 @@ export class CreateResolverRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/DeleteResolverEndpointCommand.ts b/clients/client-route53resolver/commands/DeleteResolverEndpointCommand.ts index 41ec6981aaba7..59a834e27da37 100644 --- a/clients/client-route53resolver/commands/DeleteResolverEndpointCommand.ts +++ b/clients/client-route53resolver/commands/DeleteResolverEndpointCommand.ts @@ -20,6 +20,21 @@ import { export type DeleteResolverEndpointCommandInput = DeleteResolverEndpointRequest; export type DeleteResolverEndpointCommandOutput = DeleteResolverEndpointResponse & __MetadataBearer; +/** + *

Deletes a Resolver endpoint. The effect of deleting a Resolver endpoint depends on whether it's an inbound or an outbound + * Resolver endpoint:

+ *
    + *
  • + *

    + * Inbound: DNS queries from your network are no longer routed + * to the DNS service for the specified VPC.

    + *
  • + *
  • + *

    + * Outbound: DNS queries from a VPC are no longer routed to your network.

    + *
  • + *
+ */ export class DeleteResolverEndpointCommand extends $Command< DeleteResolverEndpointCommandInput, DeleteResolverEndpointCommandOutput, @@ -34,6 +49,9 @@ export class DeleteResolverEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/DeleteResolverQueryLogConfigCommand.ts b/clients/client-route53resolver/commands/DeleteResolverQueryLogConfigCommand.ts index 11b29a4c86f5a..2c3ac72dd587c 100644 --- a/clients/client-route53resolver/commands/DeleteResolverQueryLogConfigCommand.ts +++ b/clients/client-route53resolver/commands/DeleteResolverQueryLogConfigCommand.ts @@ -20,6 +20,19 @@ import { export type DeleteResolverQueryLogConfigCommandInput = DeleteResolverQueryLogConfigRequest; export type DeleteResolverQueryLogConfigCommandOutput = DeleteResolverQueryLogConfigResponse & __MetadataBearer; +/** + *

Deletes a query logging configuration. When you delete a configuration, Resolver stops logging DNS queries for all of the Amazon VPCs that are + * associated with the configuration. This also applies if the query logging configuration is shared with other AWS accounts, and + * the other accounts have associated VPCs with the shared configuration.

+ * + *

Before you can delete a query logging configuration, you must first disassociate all VPCs from the configuration. See + * DisassociateResolverQueryLogConfig.

+ * + *

If you used Resource Access Manager (RAM) to share a query logging configuration with other accounts, you must stop sharing + * the configuration before you can delete a configuration. The accounts that you shared the configuration with can first disassociate VPCs + * that they associated with the configuration, but that's not necessary. If you stop sharing the configuration, those VPCs are automatically + * disassociated from the configuration.

+ */ export class DeleteResolverQueryLogConfigCommand extends $Command< DeleteResolverQueryLogConfigCommandInput, DeleteResolverQueryLogConfigCommandOutput, @@ -34,6 +47,9 @@ export class DeleteResolverQueryLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/DeleteResolverRuleCommand.ts b/clients/client-route53resolver/commands/DeleteResolverRuleCommand.ts index 006388aeefe91..6bb148ad1f4ba 100644 --- a/clients/client-route53resolver/commands/DeleteResolverRuleCommand.ts +++ b/clients/client-route53resolver/commands/DeleteResolverRuleCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteResolverRuleCommandInput = DeleteResolverRuleRequest; export type DeleteResolverRuleCommandOutput = DeleteResolverRuleResponse & __MetadataBearer; +/** + *

Deletes a Resolver rule. Before you can delete a Resolver rule, you must disassociate it from all the VPCs that you + * associated the Resolver rule with. For more information, see + * DisassociateResolverRule.

+ */ export class DeleteResolverRuleCommand extends $Command< DeleteResolverRuleCommandInput, DeleteResolverRuleCommandOutput, @@ -34,6 +39,9 @@ export class DeleteResolverRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/DisassociateResolverEndpointIpAddressCommand.ts b/clients/client-route53resolver/commands/DisassociateResolverEndpointIpAddressCommand.ts index 954a3160949d9..a40e399ffa650 100644 --- a/clients/client-route53resolver/commands/DisassociateResolverEndpointIpAddressCommand.ts +++ b/clients/client-route53resolver/commands/DisassociateResolverEndpointIpAddressCommand.ts @@ -24,6 +24,13 @@ export type DisassociateResolverEndpointIpAddressCommandInput = DisassociateReso export type DisassociateResolverEndpointIpAddressCommandOutput = DisassociateResolverEndpointIpAddressResponse & __MetadataBearer; +/** + *

Removes IP addresses from an inbound or an outbound Resolver endpoint. If you want to remove more than one IP address, + * submit one DisassociateResolverEndpointIpAddress request for each IP address.

+ *

To add an IP address to an endpoint, see + * AssociateResolverEndpointIpAddress. + *

+ */ export class DisassociateResolverEndpointIpAddressCommand extends $Command< DisassociateResolverEndpointIpAddressCommandInput, DisassociateResolverEndpointIpAddressCommandOutput, @@ -38,6 +45,9 @@ export class DisassociateResolverEndpointIpAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/DisassociateResolverQueryLogConfigCommand.ts b/clients/client-route53resolver/commands/DisassociateResolverQueryLogConfigCommand.ts index 223e3e7f84fad..1f3451939e0f1 100644 --- a/clients/client-route53resolver/commands/DisassociateResolverQueryLogConfigCommand.ts +++ b/clients/client-route53resolver/commands/DisassociateResolverQueryLogConfigCommand.ts @@ -24,6 +24,23 @@ export type DisassociateResolverQueryLogConfigCommandInput = DisassociateResolve export type DisassociateResolverQueryLogConfigCommandOutput = DisassociateResolverQueryLogConfigResponse & __MetadataBearer; +/** + *

Disassociates a VPC from a query logging configuration.

+ * + * + *

Before you can delete a query logging configuration, you must first disassociate all VPCs from the configuration. If you used + * Resource Access Manager (RAM) to share a query logging configuration with other accounts, VPCs can be disassociated from the configuration + * in the following ways:

+ *
    + *
  • + *

    The accounts that you shared the configuration with can disassociate VPCs from the configuration.

    + *
  • + *
  • + *

    You can stop sharing the configuration.

    + *
  • + *
+ *
+ */ export class DisassociateResolverQueryLogConfigCommand extends $Command< DisassociateResolverQueryLogConfigCommandInput, DisassociateResolverQueryLogConfigCommandOutput, @@ -38,6 +55,9 @@ export class DisassociateResolverQueryLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/DisassociateResolverRuleCommand.ts b/clients/client-route53resolver/commands/DisassociateResolverRuleCommand.ts index f038e555cf725..52f6bb16600d3 100644 --- a/clients/client-route53resolver/commands/DisassociateResolverRuleCommand.ts +++ b/clients/client-route53resolver/commands/DisassociateResolverRuleCommand.ts @@ -20,6 +20,13 @@ import { export type DisassociateResolverRuleCommandInput = DisassociateResolverRuleRequest; export type DisassociateResolverRuleCommandOutput = DisassociateResolverRuleResponse & __MetadataBearer; +/** + *

Removes the association between a specified Resolver rule and a specified VPC.

+ * + *

If you disassociate a Resolver rule from a VPC, Resolver stops forwarding DNS queries for the + * domain name that you specified in the Resolver rule.

+ *
+ */ export class DisassociateResolverRuleCommand extends $Command< DisassociateResolverRuleCommandInput, DisassociateResolverRuleCommandOutput, @@ -34,6 +41,9 @@ export class DisassociateResolverRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/GetResolverEndpointCommand.ts b/clients/client-route53resolver/commands/GetResolverEndpointCommand.ts index a848c7c2ba5ac..eb4482c0d0803 100644 --- a/clients/client-route53resolver/commands/GetResolverEndpointCommand.ts +++ b/clients/client-route53resolver/commands/GetResolverEndpointCommand.ts @@ -20,6 +20,10 @@ import { export type GetResolverEndpointCommandInput = GetResolverEndpointRequest; export type GetResolverEndpointCommandOutput = GetResolverEndpointResponse & __MetadataBearer; +/** + *

Gets information about a specified Resolver endpoint, such as whether it's an inbound or an outbound Resolver endpoint, and the + * current status of the endpoint.

+ */ export class GetResolverEndpointCommand extends $Command< GetResolverEndpointCommandInput, GetResolverEndpointCommandOutput, @@ -34,6 +38,9 @@ export class GetResolverEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/GetResolverQueryLogConfigAssociationCommand.ts b/clients/client-route53resolver/commands/GetResolverQueryLogConfigAssociationCommand.ts index a1ff6cceda254..eefac260c9426 100644 --- a/clients/client-route53resolver/commands/GetResolverQueryLogConfigAssociationCommand.ts +++ b/clients/client-route53resolver/commands/GetResolverQueryLogConfigAssociationCommand.ts @@ -24,6 +24,10 @@ export type GetResolverQueryLogConfigAssociationCommandInput = GetResolverQueryL export type GetResolverQueryLogConfigAssociationCommandOutput = GetResolverQueryLogConfigAssociationResponse & __MetadataBearer; +/** + *

Gets information about a specified association between a Resolver query logging configuration and an Amazon VPC. When you associate a VPC + * with a query logging configuration, Resolver logs DNS queries that originate in that VPC.

+ */ export class GetResolverQueryLogConfigAssociationCommand extends $Command< GetResolverQueryLogConfigAssociationCommandInput, GetResolverQueryLogConfigAssociationCommandOutput, @@ -38,6 +42,9 @@ export class GetResolverQueryLogConfigAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/GetResolverQueryLogConfigCommand.ts b/clients/client-route53resolver/commands/GetResolverQueryLogConfigCommand.ts index a7262b58ebf0b..534575d4b45da 100644 --- a/clients/client-route53resolver/commands/GetResolverQueryLogConfigCommand.ts +++ b/clients/client-route53resolver/commands/GetResolverQueryLogConfigCommand.ts @@ -20,6 +20,10 @@ import { export type GetResolverQueryLogConfigCommandInput = GetResolverQueryLogConfigRequest; export type GetResolverQueryLogConfigCommandOutput = GetResolverQueryLogConfigResponse & __MetadataBearer; +/** + *

Gets information about a specified Resolver query logging configuration, such as the number of VPCs that the configuration + * is logging queries for and the location that logs are sent to.

+ */ export class GetResolverQueryLogConfigCommand extends $Command< GetResolverQueryLogConfigCommandInput, GetResolverQueryLogConfigCommandOutput, @@ -34,6 +38,9 @@ export class GetResolverQueryLogConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/GetResolverQueryLogConfigPolicyCommand.ts b/clients/client-route53resolver/commands/GetResolverQueryLogConfigPolicyCommand.ts index e7561624808d2..ffe9393694f1c 100644 --- a/clients/client-route53resolver/commands/GetResolverQueryLogConfigPolicyCommand.ts +++ b/clients/client-route53resolver/commands/GetResolverQueryLogConfigPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type GetResolverQueryLogConfigPolicyCommandInput = GetResolverQueryLogConfigPolicyRequest; export type GetResolverQueryLogConfigPolicyCommandOutput = GetResolverQueryLogConfigPolicyResponse & __MetadataBearer; +/** + *

Gets information about a query logging policy. A query logging policy specifies the Resolver query logging + * operations and resources that you want to allow another AWS account to be able to use.

+ */ export class GetResolverQueryLogConfigPolicyCommand extends $Command< GetResolverQueryLogConfigPolicyCommandInput, GetResolverQueryLogConfigPolicyCommandOutput, @@ -34,6 +38,9 @@ export class GetResolverQueryLogConfigPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/GetResolverRuleAssociationCommand.ts b/clients/client-route53resolver/commands/GetResolverRuleAssociationCommand.ts index 974b8bb4db5a5..f44154fd4b568 100644 --- a/clients/client-route53resolver/commands/GetResolverRuleAssociationCommand.ts +++ b/clients/client-route53resolver/commands/GetResolverRuleAssociationCommand.ts @@ -20,6 +20,10 @@ import { export type GetResolverRuleAssociationCommandInput = GetResolverRuleAssociationRequest; export type GetResolverRuleAssociationCommandOutput = GetResolverRuleAssociationResponse & __MetadataBearer; +/** + *

Gets information about an association between a specified Resolver rule and a VPC. You associate a Resolver rule and a VPC using + * AssociateResolverRule.

+ */ export class GetResolverRuleAssociationCommand extends $Command< GetResolverRuleAssociationCommandInput, GetResolverRuleAssociationCommandOutput, @@ -34,6 +38,9 @@ export class GetResolverRuleAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/GetResolverRuleCommand.ts b/clients/client-route53resolver/commands/GetResolverRuleCommand.ts index 2ea4d52dc27a4..f83f1605b9ce0 100644 --- a/clients/client-route53resolver/commands/GetResolverRuleCommand.ts +++ b/clients/client-route53resolver/commands/GetResolverRuleCommand.ts @@ -20,6 +20,10 @@ import { export type GetResolverRuleCommandInput = GetResolverRuleRequest; export type GetResolverRuleCommandOutput = GetResolverRuleResponse & __MetadataBearer; +/** + *

Gets information about a specified Resolver rule, such as the domain name that the rule forwards DNS queries for and the ID of the + * outbound Resolver endpoint that the rule is associated with.

+ */ export class GetResolverRuleCommand extends $Command< GetResolverRuleCommandInput, GetResolverRuleCommandOutput, @@ -34,6 +38,9 @@ export class GetResolverRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/GetResolverRulePolicyCommand.ts b/clients/client-route53resolver/commands/GetResolverRulePolicyCommand.ts index 1960a3c1faf39..e851890b5edf7 100644 --- a/clients/client-route53resolver/commands/GetResolverRulePolicyCommand.ts +++ b/clients/client-route53resolver/commands/GetResolverRulePolicyCommand.ts @@ -20,6 +20,10 @@ import { export type GetResolverRulePolicyCommandInput = GetResolverRulePolicyRequest; export type GetResolverRulePolicyCommandOutput = GetResolverRulePolicyResponse & __MetadataBearer; +/** + *

Gets information about a Resolver rule policy. A Resolver rule policy specifies the Resolver operations and resources + * that you want to allow another AWS account to be able to use.

+ */ export class GetResolverRulePolicyCommand extends $Command< GetResolverRulePolicyCommandInput, GetResolverRulePolicyCommandOutput, @@ -34,6 +38,9 @@ export class GetResolverRulePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/ListResolverEndpointIpAddressesCommand.ts b/clients/client-route53resolver/commands/ListResolverEndpointIpAddressesCommand.ts index b0dd13771d9a3..c21204235d671 100644 --- a/clients/client-route53resolver/commands/ListResolverEndpointIpAddressesCommand.ts +++ b/clients/client-route53resolver/commands/ListResolverEndpointIpAddressesCommand.ts @@ -20,6 +20,9 @@ import { export type ListResolverEndpointIpAddressesCommandInput = ListResolverEndpointIpAddressesRequest; export type ListResolverEndpointIpAddressesCommandOutput = ListResolverEndpointIpAddressesResponse & __MetadataBearer; +/** + *

Gets the IP addresses for a specified Resolver endpoint.

+ */ export class ListResolverEndpointIpAddressesCommand extends $Command< ListResolverEndpointIpAddressesCommandInput, ListResolverEndpointIpAddressesCommandOutput, @@ -34,6 +37,9 @@ export class ListResolverEndpointIpAddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/ListResolverEndpointsCommand.ts b/clients/client-route53resolver/commands/ListResolverEndpointsCommand.ts index e5541e6c48a11..c28c53e361c2e 100644 --- a/clients/client-route53resolver/commands/ListResolverEndpointsCommand.ts +++ b/clients/client-route53resolver/commands/ListResolverEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type ListResolverEndpointsCommandInput = ListResolverEndpointsRequest; export type ListResolverEndpointsCommandOutput = ListResolverEndpointsResponse & __MetadataBearer; +/** + *

Lists all the Resolver endpoints that were created using the current AWS account.

+ */ export class ListResolverEndpointsCommand extends $Command< ListResolverEndpointsCommandInput, ListResolverEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class ListResolverEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/ListResolverQueryLogConfigAssociationsCommand.ts b/clients/client-route53resolver/commands/ListResolverQueryLogConfigAssociationsCommand.ts index 3dfbff04cdd4b..5105b68e3ea65 100644 --- a/clients/client-route53resolver/commands/ListResolverQueryLogConfigAssociationsCommand.ts +++ b/clients/client-route53resolver/commands/ListResolverQueryLogConfigAssociationsCommand.ts @@ -24,6 +24,9 @@ export type ListResolverQueryLogConfigAssociationsCommandInput = ListResolverQue export type ListResolverQueryLogConfigAssociationsCommandOutput = ListResolverQueryLogConfigAssociationsResponse & __MetadataBearer; +/** + *

Lists information about associations between Amazon VPCs and query logging configurations.

+ */ export class ListResolverQueryLogConfigAssociationsCommand extends $Command< ListResolverQueryLogConfigAssociationsCommandInput, ListResolverQueryLogConfigAssociationsCommandOutput, @@ -38,6 +41,9 @@ export class ListResolverQueryLogConfigAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/ListResolverQueryLogConfigsCommand.ts b/clients/client-route53resolver/commands/ListResolverQueryLogConfigsCommand.ts index 8eab1fb134f06..1aa4eefefef4e 100644 --- a/clients/client-route53resolver/commands/ListResolverQueryLogConfigsCommand.ts +++ b/clients/client-route53resolver/commands/ListResolverQueryLogConfigsCommand.ts @@ -20,6 +20,10 @@ import { export type ListResolverQueryLogConfigsCommandInput = ListResolverQueryLogConfigsRequest; export type ListResolverQueryLogConfigsCommandOutput = ListResolverQueryLogConfigsResponse & __MetadataBearer; +/** + *

Lists information about the specified query logging configurations. Each configuration defines where you want Resolver to save + * DNS query logs and specifies the VPCs that you want to log queries for.

+ */ export class ListResolverQueryLogConfigsCommand extends $Command< ListResolverQueryLogConfigsCommandInput, ListResolverQueryLogConfigsCommandOutput, @@ -34,6 +38,9 @@ export class ListResolverQueryLogConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/ListResolverRuleAssociationsCommand.ts b/clients/client-route53resolver/commands/ListResolverRuleAssociationsCommand.ts index e7cd00c1bdc81..7cc9a26ad0317 100644 --- a/clients/client-route53resolver/commands/ListResolverRuleAssociationsCommand.ts +++ b/clients/client-route53resolver/commands/ListResolverRuleAssociationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListResolverRuleAssociationsCommandInput = ListResolverRuleAssociationsRequest; export type ListResolverRuleAssociationsCommandOutput = ListResolverRuleAssociationsResponse & __MetadataBearer; +/** + *

Lists the associations that were created between Resolver rules and VPCs using the current AWS account.

+ */ export class ListResolverRuleAssociationsCommand extends $Command< ListResolverRuleAssociationsCommandInput, ListResolverRuleAssociationsCommandOutput, @@ -34,6 +37,9 @@ export class ListResolverRuleAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/ListResolverRulesCommand.ts b/clients/client-route53resolver/commands/ListResolverRulesCommand.ts index 811622899463c..588adc6726710 100644 --- a/clients/client-route53resolver/commands/ListResolverRulesCommand.ts +++ b/clients/client-route53resolver/commands/ListResolverRulesCommand.ts @@ -20,6 +20,9 @@ import { export type ListResolverRulesCommandInput = ListResolverRulesRequest; export type ListResolverRulesCommandOutput = ListResolverRulesResponse & __MetadataBearer; +/** + *

Lists the Resolver rules that were created using the current AWS account.

+ */ export class ListResolverRulesCommand extends $Command< ListResolverRulesCommandInput, ListResolverRulesCommandOutput, @@ -34,6 +37,9 @@ export class ListResolverRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/ListTagsForResourceCommand.ts b/clients/client-route53resolver/commands/ListTagsForResourceCommand.ts index db8e75c908581..b0b42336de812 100644 --- a/clients/client-route53resolver/commands/ListTagsForResourceCommand.ts +++ b/clients/client-route53resolver/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags that you associated with the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/PutResolverQueryLogConfigPolicyCommand.ts b/clients/client-route53resolver/commands/PutResolverQueryLogConfigPolicyCommand.ts index 3fe7f52facc4b..f92b4ecea38f7 100644 --- a/clients/client-route53resolver/commands/PutResolverQueryLogConfigPolicyCommand.ts +++ b/clients/client-route53resolver/commands/PutResolverQueryLogConfigPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type PutResolverQueryLogConfigPolicyCommandInput = PutResolverQueryLogConfigPolicyRequest; export type PutResolverQueryLogConfigPolicyCommandOutput = PutResolverQueryLogConfigPolicyResponse & __MetadataBearer; +/** + *

Specifies an AWS account that you want to share a query logging configuration with, the query logging configuration that you want to share, + * and the operations that you want the account to be able to perform on the configuration.

+ */ export class PutResolverQueryLogConfigPolicyCommand extends $Command< PutResolverQueryLogConfigPolicyCommandInput, PutResolverQueryLogConfigPolicyCommandOutput, @@ -34,6 +38,9 @@ export class PutResolverQueryLogConfigPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/PutResolverRulePolicyCommand.ts b/clients/client-route53resolver/commands/PutResolverRulePolicyCommand.ts index 335390d554ae8..592f6b729e5b0 100644 --- a/clients/client-route53resolver/commands/PutResolverRulePolicyCommand.ts +++ b/clients/client-route53resolver/commands/PutResolverRulePolicyCommand.ts @@ -20,6 +20,10 @@ import { export type PutResolverRulePolicyCommandInput = PutResolverRulePolicyRequest; export type PutResolverRulePolicyCommandOutput = PutResolverRulePolicyResponse & __MetadataBearer; +/** + *

Specifies an AWS account that you want to share rules with, the Resolver rules that you want to share, and the operations that you want + * the account to be able to perform on those rules.

+ */ export class PutResolverRulePolicyCommand extends $Command< PutResolverRulePolicyCommandInput, PutResolverRulePolicyCommandOutput, @@ -34,6 +38,9 @@ export class PutResolverRulePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/TagResourceCommand.ts b/clients/client-route53resolver/commands/TagResourceCommand.ts index b466c386ea1d3..2aecabc59c681 100644 --- a/clients/client-route53resolver/commands/TagResourceCommand.ts +++ b/clients/client-route53resolver/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds one or more tags to a specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/UntagResourceCommand.ts b/clients/client-route53resolver/commands/UntagResourceCommand.ts index 7f8034702878e..f242f2e92c6ed 100644 --- a/clients/client-route53resolver/commands/UntagResourceCommand.ts +++ b/clients/client-route53resolver/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from a specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/UpdateResolverEndpointCommand.ts b/clients/client-route53resolver/commands/UpdateResolverEndpointCommand.ts index 614a60364dc95..2a5df985a5d09 100644 --- a/clients/client-route53resolver/commands/UpdateResolverEndpointCommand.ts +++ b/clients/client-route53resolver/commands/UpdateResolverEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateResolverEndpointCommandInput = UpdateResolverEndpointRequest; export type UpdateResolverEndpointCommandOutput = UpdateResolverEndpointResponse & __MetadataBearer; +/** + *

Updates the name of an inbound or an outbound Resolver endpoint.

+ */ export class UpdateResolverEndpointCommand extends $Command< UpdateResolverEndpointCommandInput, UpdateResolverEndpointCommandOutput, @@ -34,6 +37,9 @@ export class UpdateResolverEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/commands/UpdateResolverRuleCommand.ts b/clients/client-route53resolver/commands/UpdateResolverRuleCommand.ts index d0276147fbb02..cd9c14d6b8e03 100644 --- a/clients/client-route53resolver/commands/UpdateResolverRuleCommand.ts +++ b/clients/client-route53resolver/commands/UpdateResolverRuleCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateResolverRuleCommandInput = UpdateResolverRuleRequest; export type UpdateResolverRuleCommandOutput = UpdateResolverRuleResponse & __MetadataBearer; +/** + *

Updates settings for a specified Resolver rule. ResolverRuleId is required, and all other parameters are optional. + * If you don't specify a parameter, it retains its current value.

+ */ export class UpdateResolverRuleCommand extends $Command< UpdateResolverRuleCommandInput, UpdateResolverRuleCommandOutput, @@ -34,6 +38,9 @@ export class UpdateResolverRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: Route53ResolverClientResolvedConfig, diff --git a/clients/client-route53resolver/package.json b/clients/client-route53resolver/package.json index 5ffe68e40d359..c5c7ce8ef79d7 100644 --- a/clients/client-route53resolver/package.json +++ b/clients/client-route53resolver/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Route53resolver Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-route53resolver/pagination/ListResolverEndpointIpAddressesPaginator.ts b/clients/client-route53resolver/pagination/ListResolverEndpointIpAddressesPaginator.ts index a8cc2f948f3c1..3d4587d9cd1e5 100644 --- a/clients/client-route53resolver/pagination/ListResolverEndpointIpAddressesPaginator.ts +++ b/clients/client-route53resolver/pagination/ListResolverEndpointIpAddressesPaginator.ts @@ -8,6 +8,9 @@ import { import { Route53ResolverPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53ResolverClient, input: ListResolverEndpointIpAddressesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResolverEndpointIpAddressesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Resolver, input: ListResolverEndpointIpAddressesCommandInput, diff --git a/clients/client-route53resolver/pagination/ListResolverEndpointsPaginator.ts b/clients/client-route53resolver/pagination/ListResolverEndpointsPaginator.ts index 1f881d1cbfe22..215607417862f 100644 --- a/clients/client-route53resolver/pagination/ListResolverEndpointsPaginator.ts +++ b/clients/client-route53resolver/pagination/ListResolverEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { Route53ResolverPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53ResolverClient, input: ListResolverEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResolverEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Resolver, input: ListResolverEndpointsCommandInput, diff --git a/clients/client-route53resolver/pagination/ListResolverQueryLogConfigAssociationsPaginator.ts b/clients/client-route53resolver/pagination/ListResolverQueryLogConfigAssociationsPaginator.ts index 617aaed37a09f..282caf3111067 100644 --- a/clients/client-route53resolver/pagination/ListResolverQueryLogConfigAssociationsPaginator.ts +++ b/clients/client-route53resolver/pagination/ListResolverQueryLogConfigAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { Route53ResolverPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53ResolverClient, input: ListResolverQueryLogConfigAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResolverQueryLogConfigAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Resolver, input: ListResolverQueryLogConfigAssociationsCommandInput, diff --git a/clients/client-route53resolver/pagination/ListResolverQueryLogConfigsPaginator.ts b/clients/client-route53resolver/pagination/ListResolverQueryLogConfigsPaginator.ts index 6d498e5111306..44bea47f2f8a4 100644 --- a/clients/client-route53resolver/pagination/ListResolverQueryLogConfigsPaginator.ts +++ b/clients/client-route53resolver/pagination/ListResolverQueryLogConfigsPaginator.ts @@ -8,6 +8,9 @@ import { import { Route53ResolverPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53ResolverClient, input: ListResolverQueryLogConfigsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResolverQueryLogConfigsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Resolver, input: ListResolverQueryLogConfigsCommandInput, diff --git a/clients/client-route53resolver/pagination/ListResolverRuleAssociationsPaginator.ts b/clients/client-route53resolver/pagination/ListResolverRuleAssociationsPaginator.ts index 0c14313928e86..62044fb9d7fc1 100644 --- a/clients/client-route53resolver/pagination/ListResolverRuleAssociationsPaginator.ts +++ b/clients/client-route53resolver/pagination/ListResolverRuleAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { Route53ResolverPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53ResolverClient, input: ListResolverRuleAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResolverRuleAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Resolver, input: ListResolverRuleAssociationsCommandInput, diff --git a/clients/client-route53resolver/pagination/ListResolverRulesPaginator.ts b/clients/client-route53resolver/pagination/ListResolverRulesPaginator.ts index fa67216f154e3..9dd761489e7cf 100644 --- a/clients/client-route53resolver/pagination/ListResolverRulesPaginator.ts +++ b/clients/client-route53resolver/pagination/ListResolverRulesPaginator.ts @@ -8,6 +8,9 @@ import { import { Route53ResolverPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53ResolverClient, input: ListResolverRulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResolverRulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Resolver, input: ListResolverRulesCommandInput, diff --git a/clients/client-route53resolver/pagination/ListTagsForResourcePaginator.ts b/clients/client-route53resolver/pagination/ListTagsForResourcePaginator.ts index 44818b2a0e12d..b94216909f7d9 100644 --- a/clients/client-route53resolver/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-route53resolver/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { Route53ResolverPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: Route53ResolverClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Route53Resolver, input: ListTagsForResourceCommandInput, diff --git a/clients/client-route53resolver/runtimeConfig.browser.ts b/clients/client-route53resolver/runtimeConfig.browser.ts index 7bfac9f79a3f2..6bb5a50738af6 100644 --- a/clients/client-route53resolver/runtimeConfig.browser.ts +++ b/clients/client-route53resolver/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./Route53ResolverClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-route53resolver/runtimeConfig.native.ts b/clients/client-route53resolver/runtimeConfig.native.ts index a0434f5b087b5..8cf96cc7ad429 100644 --- a/clients/client-route53resolver/runtimeConfig.native.ts +++ b/clients/client-route53resolver/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./Route53ResolverClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-route53resolver/runtimeConfig.shared.ts b/clients/client-route53resolver/runtimeConfig.shared.ts index cb5a2f32a7711..9d558dbcfb04d 100644 --- a/clients/client-route53resolver/runtimeConfig.shared.ts +++ b/clients/client-route53resolver/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-04-01", disableHostPrefix: false, diff --git a/clients/client-route53resolver/runtimeConfig.ts b/clients/client-route53resolver/runtimeConfig.ts index f889c9241c6e5..8f905b163c681 100644 --- a/clients/client-route53resolver/runtimeConfig.ts +++ b/clients/client-route53resolver/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./Route53ResolverClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-route53resolver/tsconfig.json b/clients/client-route53resolver/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-route53resolver/tsconfig.json +++ b/clients/client-route53resolver/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-s3-control/commands/CreateAccessPointCommand.ts b/clients/client-s3-control/commands/CreateAccessPointCommand.ts index 51f14a4355d36..988942aaa3ae6 100644 --- a/clients/client-s3-control/commands/CreateAccessPointCommand.ts +++ b/clients/client-s3-control/commands/CreateAccessPointCommand.ts @@ -21,6 +21,52 @@ import { export type CreateAccessPointCommandInput = CreateAccessPointRequest; export type CreateAccessPointCommandOutput = CreateAccessPointResult & __MetadataBearer; +/** + *

Creates an access point and associates it with the specified bucket. For more information, see + * Managing Data Access with Amazon S3 Access + * Points in the Amazon Simple Storage Service Developer Guide.

+ *

+ *

+ * Using this action with Amazon S3 on Outposts + *

+ *

This action:

+ *
    + *
  • + *

    Requires a virtual private cloud (VPC) configuration as S3 on Outposts only supports VPC style access points.

    + *
  • + *
  • + *

    Does not support ACL on S3 on Outposts buckets.

    + *
  • + *
  • + *

    Does not support Public Access on S3 on Outposts buckets.

    + *
  • + *
  • + *

    Does not support object lock for S3 on Outposts buckets.

    + *
  • + *
+ *

For more information, see + * Using Amazon S3 on Outposts in the Amazon Simple Storage Service Developer Guide .

+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ *

+ *

The following actions are related to CreateAccessPoint:

+ * + */ export class CreateAccessPointCommand extends $Command< CreateAccessPointCommandInput, CreateAccessPointCommandOutput, @@ -35,6 +81,9 @@ export class CreateAccessPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/CreateBucketCommand.ts b/clients/client-s3-control/commands/CreateBucketCommand.ts index 53ed26d8d6fc3..df5767637ce3e 100644 --- a/clients/client-s3-control/commands/CreateBucketCommand.ts +++ b/clients/client-s3-control/commands/CreateBucketCommand.ts @@ -21,6 +21,63 @@ import { export type CreateBucketCommandInput = CreateBucketRequest; export type CreateBucketCommandOutput = CreateBucketResult & __MetadataBearer; +/** + * + *

This API operation creates an Amazon S3 on Outposts bucket. To create an S3 bucket, see Create Bucket in the Amazon Simple Storage Service API. + *

+ *
+ *

Creates a new Outposts bucket. By creating the bucket, you become the bucket owner. To create an Outposts bucket, you must have S3 on Outposts. + * For more information, see Using Amazon S3 on Outposts in Amazon Simple Storage Service Developer Guide.

+ *

Not every string is an acceptable bucket name. For information on bucket naming restrictions, see Working with Amazon S3 Buckets.

+ * + *

S3 on Outposts buckets do not support

+ *
    + *
  • + *

    ACLs. Instead, configure access point policies to manage + * access to buckets.

    + *
  • + *
  • + *

    Public access.

    + *
  • + *
  • + *

    Object Lock

    + *
  • + *
  • + *

    Bucket Location constraint

    + *
  • + *
+ *

For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts + * endpoint hostname prefix and x-amz-outpost-id in your API request, see the Examples section.

+ * + *

The following actions are related to CreateBucket for Amazon S3 on Outposts:

+ * + */ export class CreateBucketCommand extends $Command< CreateBucketCommandInput, CreateBucketCommandOutput, @@ -35,6 +92,9 @@ export class CreateBucketCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/CreateJobCommand.ts b/clients/client-s3-control/commands/CreateJobCommand.ts index d39ff67c40df6..35f6c5d681c12 100644 --- a/clients/client-s3-control/commands/CreateJobCommand.ts +++ b/clients/client-s3-control/commands/CreateJobCommand.ts @@ -18,6 +18,37 @@ import { export type CreateJobCommandInput = CreateJobRequest; export type CreateJobCommandOutput = CreateJobResult & __MetadataBearer; +/** + *

S3 Batch Operations performs large-scale Batch Operations on Amazon S3 objects. Batch Operations can run a + * single operation or action on lists of Amazon S3 objects that you specify. For more information, + * see S3 Batch Operations in the + * Amazon Simple Storage Service Developer Guide.

+ *

This operation creates an S3 Batch Operations job.

+ *

+ *

Related actions include:

+ * + */ export class CreateJobCommand extends $Command< CreateJobCommandInput, CreateJobCommandOutput, @@ -32,6 +63,9 @@ export class CreateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteAccessPointCommand.ts b/clients/client-s3-control/commands/DeleteAccessPointCommand.ts index 1c45c84d52fc4..4f5d572804cc0 100644 --- a/clients/client-s3-control/commands/DeleteAccessPointCommand.ts +++ b/clients/client-s3-control/commands/DeleteAccessPointCommand.ts @@ -21,6 +21,29 @@ import { export type DeleteAccessPointCommandInput = DeleteAccessPointRequest; export type DeleteAccessPointCommandOutput = __MetadataBearer; +/** + *

Deletes the specified access point.

+ * + *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ *

The following actions are related to DeleteAccessPoint:

+ * + */ export class DeleteAccessPointCommand extends $Command< DeleteAccessPointCommandInput, DeleteAccessPointCommandOutput, @@ -35,6 +58,9 @@ export class DeleteAccessPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteAccessPointPolicyCommand.ts b/clients/client-s3-control/commands/DeleteAccessPointPolicyCommand.ts index 12e8a1c70f632..94bd9f07468b2 100644 --- a/clients/client-s3-control/commands/DeleteAccessPointPolicyCommand.ts +++ b/clients/client-s3-control/commands/DeleteAccessPointPolicyCommand.ts @@ -21,6 +21,24 @@ import { export type DeleteAccessPointPolicyCommandInput = DeleteAccessPointPolicyRequest; export type DeleteAccessPointPolicyCommandOutput = __MetadataBearer; +/** + *

Deletes the access point policy for the specified access point.

+ *

+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ *

The following actions are related to DeleteAccessPointPolicy:

+ * + */ export class DeleteAccessPointPolicyCommand extends $Command< DeleteAccessPointPolicyCommandInput, DeleteAccessPointPolicyCommandOutput, @@ -35,6 +53,9 @@ export class DeleteAccessPointPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteBucketCommand.ts b/clients/client-s3-control/commands/DeleteBucketCommand.ts index 01d073824597a..24b87b67d1e06 100644 --- a/clients/client-s3-control/commands/DeleteBucketCommand.ts +++ b/clients/client-s3-control/commands/DeleteBucketCommand.ts @@ -21,6 +21,37 @@ import { export type DeleteBucketCommandInput = DeleteBucketRequest; export type DeleteBucketCommandOutput = __MetadataBearer; +/** + * + *

This API operation deletes an Amazon S3 on Outposts bucket. To delete an S3 bucket, + * see DeleteBucket in the Amazon Simple Storage Service API. + *

+ *
+ *

Deletes the Amazon S3 on Outposts bucket. All objects (including all object versions and delete markers) in the + * bucket must be deleted before the bucket itself can be deleted. + * For more information, see Using Amazon S3 on Outposts in Amazon Simple Storage Service Developer Guide.

+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ *

+ * Related Resources + *

+ * + */ export class DeleteBucketCommand extends $Command< DeleteBucketCommandInput, DeleteBucketCommandOutput, @@ -35,6 +66,9 @@ export class DeleteBucketCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteBucketLifecycleConfigurationCommand.ts b/clients/client-s3-control/commands/DeleteBucketLifecycleConfigurationCommand.ts index 47f743a5c171d..546bc71525162 100644 --- a/clients/client-s3-control/commands/DeleteBucketLifecycleConfigurationCommand.ts +++ b/clients/client-s3-control/commands/DeleteBucketLifecycleConfigurationCommand.ts @@ -21,6 +21,38 @@ import { export type DeleteBucketLifecycleConfigurationCommandInput = DeleteBucketLifecycleConfigurationRequest; export type DeleteBucketLifecycleConfigurationCommandOutput = __MetadataBearer; +/** + * + *

This API action deletes an Amazon S3 on Outposts bucket's lifecycle configuration. To delete an + * S3 bucket's lifecycle configuration, see DeleteBucketLifecycle in the Amazon Simple Storage Service API. + *

+ *
+ *

Deletes the lifecycle configuration from the specified Outposts bucket. Amazon S3 on Outposts removes all the lifecycle configuration + * rules in the lifecycle subresource associated with the bucket. Your objects never expire, and Amazon S3 on Outposts no longer automatically + * deletes any objects on the basis of rules contained in the deleted lifecycle configuration. + * For more information, see Using Amazon S3 on Outposts in Amazon Simple Storage Service Developer Guide.

+ *

To use this operation, you must have permission to perform the + * s3-outposts:DeleteLifecycleConfiguration action. By default, the bucket + * owner has this permission and the Outposts bucket owner can grant this permission to + * others.

+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + *

For more information about object expiration, see + * Elements to Describe Lifecycle Actions.

+ *

Related actions include:

+ * + */ export class DeleteBucketLifecycleConfigurationCommand extends $Command< DeleteBucketLifecycleConfigurationCommandInput, DeleteBucketLifecycleConfigurationCommandOutput, @@ -35,6 +67,9 @@ export class DeleteBucketLifecycleConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteBucketPolicyCommand.ts b/clients/client-s3-control/commands/DeleteBucketPolicyCommand.ts index 344da16cb4a7f..ff1c04dd2142b 100644 --- a/clients/client-s3-control/commands/DeleteBucketPolicyCommand.ts +++ b/clients/client-s3-control/commands/DeleteBucketPolicyCommand.ts @@ -21,6 +21,50 @@ import { export type DeleteBucketPolicyCommandInput = DeleteBucketPolicyRequest; export type DeleteBucketPolicyCommandOutput = __MetadataBearer; +/** + * + *

This API operation deletes an Amazon S3 on Outposts bucket policy. To delete an + * S3 bucket policy, see DeleteBucketPolicy in the Amazon Simple Storage Service API. + *

+ *
+ *

This implementation of the DELETE operation uses the policy subresource to delete the + * policy of a specified Amazon S3 on Outposts bucket. If you are using an identity other than the + * root user of the AWS account that owns the bucket, the calling identity must have the + * s3-outposts:DeleteBucketPolicy permissions on the specified Outposts bucket + * and belong to the bucket owner's account to use this operation. For more information, see + * Using Amazon S3 on Outposts in + * Amazon Simple Storage Service Developer Guide.

+ * + *

If you don't have DeleteBucketPolicy permissions, Amazon S3 returns a + * 403 Access Denied error. If you have the correct permissions, but you're + * not using an identity that belongs to the bucket owner's account, Amazon S3 returns a + * 405 Method Not Allowed error.

+ * + * + * + *

As a security precaution, the root user of the AWS account that owns a bucket can always use this operation, + * even if the policy explicitly denies the root user the ability to perform this action.

+ *
+ * + *

For more information about bucket policies, see Using Bucket Policies and User + * Policies.

+ * + *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + *

The following actions are related to DeleteBucketPolicy:

+ * + */ export class DeleteBucketPolicyCommand extends $Command< DeleteBucketPolicyCommandInput, DeleteBucketPolicyCommandOutput, @@ -35,6 +79,9 @@ export class DeleteBucketPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteBucketTaggingCommand.ts b/clients/client-s3-control/commands/DeleteBucketTaggingCommand.ts index 4db9b87d13197..10115e6b310f8 100644 --- a/clients/client-s3-control/commands/DeleteBucketTaggingCommand.ts +++ b/clients/client-s3-control/commands/DeleteBucketTaggingCommand.ts @@ -21,6 +21,35 @@ import { export type DeleteBucketTaggingCommandInput = DeleteBucketTaggingRequest; export type DeleteBucketTaggingCommandOutput = __MetadataBearer; +/** + * + *

This operation deletes an Amazon S3 on Outposts bucket's tags. To delete an + * S3 bucket tags, see DeleteBucketTagging in the Amazon Simple Storage Service API. + *

+ *
+ *

Deletes the tags from the Outposts bucket. For more information, see Using Amazon S3 on Outposts in + * Amazon Simple Storage Service Developer Guide.

+ * + *

To use this operation, you must have permission to perform the PutBucketTagging action. + * By default, the bucket owner has this permission and can grant this permission to others. + *

+ * + *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + *

The following actions are related to DeleteBucketTagging:

+ * + */ export class DeleteBucketTaggingCommand extends $Command< DeleteBucketTaggingCommandInput, DeleteBucketTaggingCommandOutput, @@ -35,6 +64,9 @@ export class DeleteBucketTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteJobTaggingCommand.ts b/clients/client-s3-control/commands/DeleteJobTaggingCommand.ts index 88369c8e4b55a..46ca3909752e1 100644 --- a/clients/client-s3-control/commands/DeleteJobTaggingCommand.ts +++ b/clients/client-s3-control/commands/DeleteJobTaggingCommand.ts @@ -21,6 +21,31 @@ import { export type DeleteJobTaggingCommandInput = DeleteJobTaggingRequest; export type DeleteJobTaggingCommandOutput = DeleteJobTaggingResult & __MetadataBearer; +/** + *

Removes the entire tag set from the specified S3 Batch Operations job. To use this operation, + * you must have permission to perform the s3:DeleteJobTagging action. For more + * information, see Controlling access and labeling jobs using tags in the + * Amazon Simple Storage Service Developer Guide.

+ *

+ *

Related actions include:

+ * + */ export class DeleteJobTaggingCommand extends $Command< DeleteJobTaggingCommandInput, DeleteJobTaggingCommandOutput, @@ -35,6 +60,9 @@ export class DeleteJobTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeletePublicAccessBlockCommand.ts b/clients/client-s3-control/commands/DeletePublicAccessBlockCommand.ts index e776017c7006b..baf9fe42e2b90 100644 --- a/clients/client-s3-control/commands/DeletePublicAccessBlockCommand.ts +++ b/clients/client-s3-control/commands/DeletePublicAccessBlockCommand.ts @@ -21,6 +21,24 @@ import { export type DeletePublicAccessBlockCommandInput = DeletePublicAccessBlockRequest; export type DeletePublicAccessBlockCommandOutput = __MetadataBearer; +/** + *

Removes the PublicAccessBlock configuration for an AWS account. For more + * information, see Using Amazon S3 block + * public access.

+ *

Related actions include:

+ * + */ export class DeletePublicAccessBlockCommand extends $Command< DeletePublicAccessBlockCommandInput, DeletePublicAccessBlockCommandOutput, @@ -35,6 +53,9 @@ export class DeletePublicAccessBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteStorageLensConfigurationCommand.ts b/clients/client-s3-control/commands/DeleteStorageLensConfigurationCommand.ts index 696df372454ef..163ef61127673 100644 --- a/clients/client-s3-control/commands/DeleteStorageLensConfigurationCommand.ts +++ b/clients/client-s3-control/commands/DeleteStorageLensConfigurationCommand.ts @@ -21,6 +21,17 @@ import { export type DeleteStorageLensConfigurationCommandInput = DeleteStorageLensConfigurationRequest; export type DeleteStorageLensConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see + * Working with Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ * + *

To use this action, + * you must have permission to perform the s3:DeleteStorageLensConfiguration action. For more + * information, see Setting permissions to use Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ *
+ */ export class DeleteStorageLensConfigurationCommand extends $Command< DeleteStorageLensConfigurationCommandInput, DeleteStorageLensConfigurationCommandOutput, @@ -35,6 +46,9 @@ export class DeleteStorageLensConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DeleteStorageLensConfigurationTaggingCommand.ts b/clients/client-s3-control/commands/DeleteStorageLensConfigurationTaggingCommand.ts index 59a0e28d4d207..e1a2d9119556f 100644 --- a/clients/client-s3-control/commands/DeleteStorageLensConfigurationTaggingCommand.ts +++ b/clients/client-s3-control/commands/DeleteStorageLensConfigurationTaggingCommand.ts @@ -25,6 +25,17 @@ export type DeleteStorageLensConfigurationTaggingCommandInput = DeleteStorageLen export type DeleteStorageLensConfigurationTaggingCommandOutput = DeleteStorageLensConfigurationTaggingResult & __MetadataBearer; +/** + *

Deletes the Amazon S3 Storage Lens configuration tags. For more information about S3 Storage Lens, see + * Working with Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ * + *

To use this action, + * you must have permission to perform the s3:DeleteStorageLensConfigurationTagging action. For more + * information, see Setting permissions to use Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ *
+ */ export class DeleteStorageLensConfigurationTaggingCommand extends $Command< DeleteStorageLensConfigurationTaggingCommandInput, DeleteStorageLensConfigurationTaggingCommandOutput, @@ -39,6 +50,9 @@ export class DeleteStorageLensConfigurationTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/DescribeJobCommand.ts b/clients/client-s3-control/commands/DescribeJobCommand.ts index 0b3acb7575afa..2e01cd7e6c5a5 100644 --- a/clients/client-s3-control/commands/DescribeJobCommand.ts +++ b/clients/client-s3-control/commands/DescribeJobCommand.ts @@ -21,6 +21,35 @@ import { export type DescribeJobCommandInput = DescribeJobRequest; export type DescribeJobCommandOutput = DescribeJobResult & __MetadataBearer; +/** + *

Retrieves the configuration parameters and status for a Batch Operations job. For more + * information, see S3 Batch Operations in + * the Amazon Simple Storage Service Developer Guide.

+ *

+ *

Related actions include:

+ * + */ export class DescribeJobCommand extends $Command< DescribeJobCommandInput, DescribeJobCommandOutput, @@ -35,6 +64,9 @@ export class DescribeJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetAccessPointCommand.ts b/clients/client-s3-control/commands/GetAccessPointCommand.ts index efa0b99f1218d..1facd20be1d0a 100644 --- a/clients/client-s3-control/commands/GetAccessPointCommand.ts +++ b/clients/client-s3-control/commands/GetAccessPointCommand.ts @@ -21,6 +21,30 @@ import { export type GetAccessPointCommandInput = GetAccessPointRequest; export type GetAccessPointCommandOutput = GetAccessPointResult & __MetadataBearer; +/** + *

Returns configuration information about the specified access point.

+ *

+ * + *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ *

The following actions are related to GetAccessPoint:

+ * + */ export class GetAccessPointCommand extends $Command< GetAccessPointCommandInput, GetAccessPointCommandOutput, @@ -35,6 +59,9 @@ export class GetAccessPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetAccessPointPolicyCommand.ts b/clients/client-s3-control/commands/GetAccessPointPolicyCommand.ts index 859d4425a2b73..23735be901a86 100644 --- a/clients/client-s3-control/commands/GetAccessPointPolicyCommand.ts +++ b/clients/client-s3-control/commands/GetAccessPointPolicyCommand.ts @@ -21,6 +21,22 @@ import { export type GetAccessPointPolicyCommandInput = GetAccessPointPolicyRequest; export type GetAccessPointPolicyCommandOutput = GetAccessPointPolicyResult & __MetadataBearer; +/** + *

Returns the access point policy associated with the specified access point.

+ *

The following actions are related to GetAccessPointPolicy:

+ * + */ export class GetAccessPointPolicyCommand extends $Command< GetAccessPointPolicyCommandInput, GetAccessPointPolicyCommandOutput, @@ -35,6 +51,9 @@ export class GetAccessPointPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetAccessPointPolicyStatusCommand.ts b/clients/client-s3-control/commands/GetAccessPointPolicyStatusCommand.ts index 38a2361660827..7b22e43014607 100644 --- a/clients/client-s3-control/commands/GetAccessPointPolicyStatusCommand.ts +++ b/clients/client-s3-control/commands/GetAccessPointPolicyStatusCommand.ts @@ -21,6 +21,9 @@ import { export type GetAccessPointPolicyStatusCommandInput = GetAccessPointPolicyStatusRequest; export type GetAccessPointPolicyStatusCommandOutput = GetAccessPointPolicyStatusResult & __MetadataBearer; +/** + *

Indicates whether the specified access point currently has a policy that allows public access. For more information about public access through access points, see Managing Data Access with Amazon S3 Access Points in the Amazon Simple Storage Service Developer Guide.

+ */ export class GetAccessPointPolicyStatusCommand extends $Command< GetAccessPointPolicyStatusCommandInput, GetAccessPointPolicyStatusCommandOutput, @@ -35,6 +38,9 @@ export class GetAccessPointPolicyStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetBucketCommand.ts b/clients/client-s3-control/commands/GetBucketCommand.ts index 7b870b2fd2851..9d54ebd0bb8fd 100644 --- a/clients/client-s3-control/commands/GetBucketCommand.ts +++ b/clients/client-s3-control/commands/GetBucketCommand.ts @@ -18,6 +18,36 @@ import { export type GetBucketCommandInput = GetBucketRequest; export type GetBucketCommandOutput = GetBucketResult & __MetadataBearer; +/** + *

Gets an Amazon S3 on Outposts bucket. For more information, see + * Using Amazon S3 on Outposts in the Amazon Simple Storage Service Developer Guide.

+ *

If you are using an identity other than the root user of the AWS account that owns the bucket, the calling identity + * must have the s3-outposts:GetBucket permissions on the specified bucket and belong to the bucket owner's account + * in order to use this operation. Only users from Outposts bucket owner account with the right permissions can perform actions on an Outposts bucket. + *

+ *

+ * If you don't have s3-outposts:GetBucket permissions or you're not using an identity that belongs to the bucket owner's + * account, Amazon S3 returns a 403 Access Denied error.

+ *

The following actions are related to GetBucket for Amazon S3 on Outposts:

+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + */ export class GetBucketCommand extends $Command< GetBucketCommandInput, GetBucketCommandOutput, @@ -32,6 +62,9 @@ export class GetBucketCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetBucketLifecycleConfigurationCommand.ts b/clients/client-s3-control/commands/GetBucketLifecycleConfigurationCommand.ts index aab28e348c045..3729e330053c3 100644 --- a/clients/client-s3-control/commands/GetBucketLifecycleConfigurationCommand.ts +++ b/clients/client-s3-control/commands/GetBucketLifecycleConfigurationCommand.ts @@ -21,6 +21,59 @@ import { export type GetBucketLifecycleConfigurationCommandInput = GetBucketLifecycleConfigurationRequest; export type GetBucketLifecycleConfigurationCommandOutput = GetBucketLifecycleConfigurationResult & __MetadataBearer; +/** + * + *

This operation gets an Amazon S3 on Outposts bucket's lifecycle configuration. To get an + * S3 bucket's lifecycle configuration, see GetBucketLifecycleConfiguration in the Amazon Simple Storage Service API. + *

+ *
+ *

Returns the lifecycle configuration information set on the Outposts bucket. For more + * information, see Using Amazon S3 on Outposts and for + * information about lifecycle configuration, see Object Lifecycle Management in + * Amazon Simple Storage Service Developer Guide.

+ * + *

To use this operation, you must have permission to perform the s3-outposts:GetLifecycleConfiguration action. + * The Outposts bucket owner has this permission, by default. The bucket owner can grant this permission to others. For more + * information about permissions, see + * Permissions + * Related to Bucket Subresource Operations and Managing Access + * Permissions to Your Amazon S3 Resources.

+ * + *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + *

+ * GetBucketLifecycleConfiguration has the following special error:

+ *
    + *
  • + *

    Error code: NoSuchLifecycleConfiguration + *

    + *
      + *
    • + *

      Description: The lifecycle configuration does not exist.

      + *
    • + *
    • + *

      HTTP Status Code: 404 Not Found

      + *
    • + *
    • + *

      SOAP Fault Code Prefix: Client

      + *
    • + *
    + *
  • + *
+ *

The following actions are related to GetBucketLifecycleConfiguration:

+ * + */ export class GetBucketLifecycleConfigurationCommand extends $Command< GetBucketLifecycleConfigurationCommandInput, GetBucketLifecycleConfigurationCommandOutput, @@ -35,6 +88,9 @@ export class GetBucketLifecycleConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetBucketPolicyCommand.ts b/clients/client-s3-control/commands/GetBucketPolicyCommand.ts index e05ec753e393d..9b93b43564b70 100644 --- a/clients/client-s3-control/commands/GetBucketPolicyCommand.ts +++ b/clients/client-s3-control/commands/GetBucketPolicyCommand.ts @@ -21,6 +21,49 @@ import { export type GetBucketPolicyCommandInput = GetBucketPolicyRequest; export type GetBucketPolicyCommandOutput = GetBucketPolicyResult & __MetadataBearer; +/** + * + *

This action gets a bucket policy for an Amazon S3 on Outposts bucket. To get a policy for an S3 + * bucket, see GetBucketPolicy in the + * Amazon Simple Storage Service API.

+ *
+ *

Returns the policy of a specified Outposts bucket. For more information, see Using Amazon S3 on Outposts in the + * Amazon Simple Storage Service Developer Guide.

+ *

If you are using an identity other than the root user of the AWS account that owns the bucket, the calling identity + * must have the GetBucketPolicy permissions on the specified bucket and belong to the bucket owner's account in order to use this operation.

+ * + *

Only users from Outposts bucket owner account with the right permissions can perform actions on an Outposts bucket. + * If you don't have s3-outposts:GetBucketPolicy permissions or you're not using an identity that belongs to the bucket owner's + * account, Amazon S3 returns a 403 Access Denied error.

+ * + * + *

As a security precaution, the root user of the AWS account that owns a bucket can always use this operation, even if the policy + * explicitly denies the root user the ability to perform this action.

+ *
+ * + *

For more information about bucket policies, see Using Bucket Policies and User Policies.

+ * + *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + *

The following actions are related to GetBucketPolicy:

+ * + */ export class GetBucketPolicyCommand extends $Command< GetBucketPolicyCommandInput, GetBucketPolicyCommandOutput, @@ -35,6 +78,9 @@ export class GetBucketPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetBucketTaggingCommand.ts b/clients/client-s3-control/commands/GetBucketTaggingCommand.ts index 2e2667244f4d3..c7a7da5bb0979 100644 --- a/clients/client-s3-control/commands/GetBucketTaggingCommand.ts +++ b/clients/client-s3-control/commands/GetBucketTaggingCommand.ts @@ -21,6 +21,47 @@ import { export type GetBucketTaggingCommandInput = GetBucketTaggingRequest; export type GetBucketTaggingCommandOutput = GetBucketTaggingResult & __MetadataBearer; +/** + * + *

This operation gets an Amazon S3 on Outposts bucket's tags. To get an + * S3 bucket tags, see GetBucketTagging in the Amazon Simple Storage Service API. + *

+ *
+ *

Returns the tag set associated with the Outposts bucket. For more information, see + * Using Amazon S3 on Outposts in the + * Amazon Simple Storage Service Developer Guide.

+ *

To use this operation, you must have permission to perform the GetBucketTagging action. + * By default, the bucket owner has this permission and can grant this permission to others.

+ * + *

+ * GetBucketTagging has the following special error:

+ *
    + *
  • + *

    Error code: NoSuchTagSetError + *

    + *
      + *
    • + *

      Description: There is no tag set associated with the bucket.

      + *
    • + *
    + *
  • + *
+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + *

The following actions are related to GetBucketTagging:

+ * + */ export class GetBucketTaggingCommand extends $Command< GetBucketTaggingCommandInput, GetBucketTaggingCommandOutput, @@ -35,6 +76,9 @@ export class GetBucketTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetJobTaggingCommand.ts b/clients/client-s3-control/commands/GetJobTaggingCommand.ts index d643264c6da9c..f6dc4f5f35df1 100644 --- a/clients/client-s3-control/commands/GetJobTaggingCommand.ts +++ b/clients/client-s3-control/commands/GetJobTaggingCommand.ts @@ -21,6 +21,32 @@ import { export type GetJobTaggingCommandInput = GetJobTaggingRequest; export type GetJobTaggingCommandOutput = GetJobTaggingResult & __MetadataBearer; +/** + *

Returns the tags on an S3 Batch Operations job. To use this operation, you must have + * permission to perform the s3:GetJobTagging action. For more information, see + * Controlling + * access and labeling jobs using tags in the + * Amazon Simple Storage Service Developer Guide.

+ *

+ *

Related actions include:

+ * + */ export class GetJobTaggingCommand extends $Command< GetJobTaggingCommandInput, GetJobTaggingCommandOutput, @@ -35,6 +61,9 @@ export class GetJobTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetPublicAccessBlockCommand.ts b/clients/client-s3-control/commands/GetPublicAccessBlockCommand.ts index 3dff673100234..5597461d841fc 100644 --- a/clients/client-s3-control/commands/GetPublicAccessBlockCommand.ts +++ b/clients/client-s3-control/commands/GetPublicAccessBlockCommand.ts @@ -21,6 +21,24 @@ import { export type GetPublicAccessBlockCommandInput = GetPublicAccessBlockRequest; export type GetPublicAccessBlockCommandOutput = GetPublicAccessBlockOutput & __MetadataBearer; +/** + *

Retrieves the PublicAccessBlock configuration for an AWS account. For more + * information, see Using Amazon S3 block + * public access.

+ *

Related actions include:

+ * + */ export class GetPublicAccessBlockCommand extends $Command< GetPublicAccessBlockCommandInput, GetPublicAccessBlockCommandOutput, @@ -35,6 +53,9 @@ export class GetPublicAccessBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetStorageLensConfigurationCommand.ts b/clients/client-s3-control/commands/GetStorageLensConfigurationCommand.ts index 452a57041ae15..d8aefce45ab0c 100644 --- a/clients/client-s3-control/commands/GetStorageLensConfigurationCommand.ts +++ b/clients/client-s3-control/commands/GetStorageLensConfigurationCommand.ts @@ -21,6 +21,17 @@ import { export type GetStorageLensConfigurationCommandInput = GetStorageLensConfigurationRequest; export type GetStorageLensConfigurationCommandOutput = GetStorageLensConfigurationResult & __MetadataBearer; +/** + *

Gets the Amazon S3 Storage Lens configuration. For more information, see + * Working with Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ * + *

To use this action, + * you must have permission to perform the s3:GetStorageLensConfiguration action. For more + * information, see Setting permissions to use Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ *
+ */ export class GetStorageLensConfigurationCommand extends $Command< GetStorageLensConfigurationCommandInput, GetStorageLensConfigurationCommandOutput, @@ -35,6 +46,9 @@ export class GetStorageLensConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/GetStorageLensConfigurationTaggingCommand.ts b/clients/client-s3-control/commands/GetStorageLensConfigurationTaggingCommand.ts index 4f2cdb5b2b043..a393637a57b80 100644 --- a/clients/client-s3-control/commands/GetStorageLensConfigurationTaggingCommand.ts +++ b/clients/client-s3-control/commands/GetStorageLensConfigurationTaggingCommand.ts @@ -25,6 +25,17 @@ export type GetStorageLensConfigurationTaggingCommandInput = GetStorageLensConfi export type GetStorageLensConfigurationTaggingCommandOutput = GetStorageLensConfigurationTaggingResult & __MetadataBearer; +/** + *

Gets the tags of Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see + * Working with Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ * + *

To use this action, + * you must have permission to perform the s3:GetStorageLensConfigurationTagging action. For more + * information, see Setting permissions to use Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ *
+ */ export class GetStorageLensConfigurationTaggingCommand extends $Command< GetStorageLensConfigurationTaggingCommandInput, GetStorageLensConfigurationTaggingCommandOutput, @@ -39,6 +50,9 @@ export class GetStorageLensConfigurationTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/ListAccessPointsCommand.ts b/clients/client-s3-control/commands/ListAccessPointsCommand.ts index 32c78514f7eab..39351367456f0 100644 --- a/clients/client-s3-control/commands/ListAccessPointsCommand.ts +++ b/clients/client-s3-control/commands/ListAccessPointsCommand.ts @@ -21,6 +21,33 @@ import { export type ListAccessPointsCommandInput = ListAccessPointsRequest; export type ListAccessPointsCommandOutput = ListAccessPointsResult & __MetadataBearer; +/** + *

Returns a list of the access points currently associated with the specified bucket. You + * can retrieve up to 1000 access points per call. If the specified bucket has more than 1,000 + * access points (or the number specified in maxResults, whichever is less), the + * response will include a continuation token that you can use to list the additional access + * points.

+ *

+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ *

The following actions are related to ListAccessPoints:

+ * + */ export class ListAccessPointsCommand extends $Command< ListAccessPointsCommandInput, ListAccessPointsCommandOutput, @@ -35,6 +62,9 @@ export class ListAccessPointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/ListJobsCommand.ts b/clients/client-s3-control/commands/ListJobsCommand.ts index 0dbb5ba2236e1..c40a255b72cfa 100644 --- a/clients/client-s3-control/commands/ListJobsCommand.ts +++ b/clients/client-s3-control/commands/ListJobsCommand.ts @@ -18,6 +18,35 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResult & __MetadataBearer; +/** + *

Lists current S3 Batch Operations jobs and jobs that have ended within the last 30 days for + * the AWS account making the request. For more information, see S3 Batch Operations in the + * Amazon Simple Storage Service Developer Guide.

+ *

Related actions include:

+ *

+ * + */ export class ListJobsCommand extends $Command< ListJobsCommandInput, ListJobsCommandOutput, @@ -32,6 +61,9 @@ export class ListJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/ListRegionalBucketsCommand.ts b/clients/client-s3-control/commands/ListRegionalBucketsCommand.ts index 46e95a8e35c17..808755f8aaf72 100644 --- a/clients/client-s3-control/commands/ListRegionalBucketsCommand.ts +++ b/clients/client-s3-control/commands/ListRegionalBucketsCommand.ts @@ -21,6 +21,13 @@ import { export type ListRegionalBucketsCommandInput = ListRegionalBucketsRequest; export type ListRegionalBucketsCommandOutput = ListRegionalBucketsResult & __MetadataBearer; +/** + *

Returns a list of all Outposts buckets in an Outpost that are owned by the authenticated + * sender of the request. For more information, see Using Amazon S3 on Outposts in the + * Amazon Simple Storage Service Developer Guide.

+ *

For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts + * endpoint hostname prefix and x-amz-outpost-id in your request, see the Examples section.

+ */ export class ListRegionalBucketsCommand extends $Command< ListRegionalBucketsCommandInput, ListRegionalBucketsCommandOutput, @@ -35,6 +42,9 @@ export class ListRegionalBucketsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/ListStorageLensConfigurationsCommand.ts b/clients/client-s3-control/commands/ListStorageLensConfigurationsCommand.ts index f5076eb8c42b7..ddb9ac572bc44 100644 --- a/clients/client-s3-control/commands/ListStorageLensConfigurationsCommand.ts +++ b/clients/client-s3-control/commands/ListStorageLensConfigurationsCommand.ts @@ -21,6 +21,17 @@ import { export type ListStorageLensConfigurationsCommandInput = ListStorageLensConfigurationsRequest; export type ListStorageLensConfigurationsCommandOutput = ListStorageLensConfigurationsResult & __MetadataBearer; +/** + *

Gets a list of Amazon S3 Storage Lens configurations. For more information about S3 Storage Lens, see + * Working with Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ * + *

To use this action, + * you must have permission to perform the s3:ListStorageLensConfigurations action. For more + * information, see Setting permissions to use Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ *
+ */ export class ListStorageLensConfigurationsCommand extends $Command< ListStorageLensConfigurationsCommandInput, ListStorageLensConfigurationsCommandOutput, @@ -35,6 +46,9 @@ export class ListStorageLensConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/PutAccessPointPolicyCommand.ts b/clients/client-s3-control/commands/PutAccessPointPolicyCommand.ts index 635801160c548..7d0f6903a18f3 100644 --- a/clients/client-s3-control/commands/PutAccessPointPolicyCommand.ts +++ b/clients/client-s3-control/commands/PutAccessPointPolicyCommand.ts @@ -21,6 +21,25 @@ import { export type PutAccessPointPolicyCommandInput = PutAccessPointPolicyRequest; export type PutAccessPointPolicyCommandOutput = __MetadataBearer; +/** + *

Associates an access policy with the specified access point. Each access point can have only one policy, so a request made to this API + * replaces any existing policy associated with the specified access point.

+ *

+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ *

The following actions are related to PutAccessPointPolicy:

+ * + */ export class PutAccessPointPolicyCommand extends $Command< PutAccessPointPolicyCommandInput, PutAccessPointPolicyCommandOutput, @@ -35,6 +54,9 @@ export class PutAccessPointPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/PutBucketLifecycleConfigurationCommand.ts b/clients/client-s3-control/commands/PutBucketLifecycleConfigurationCommand.ts index c8188e1ee16a5..cda1ad15d8e58 100644 --- a/clients/client-s3-control/commands/PutBucketLifecycleConfigurationCommand.ts +++ b/clients/client-s3-control/commands/PutBucketLifecycleConfigurationCommand.ts @@ -21,6 +21,31 @@ import { export type PutBucketLifecycleConfigurationCommandInput = PutBucketLifecycleConfigurationRequest; export type PutBucketLifecycleConfigurationCommandOutput = __MetadataBearer; +/** + * + *

This action puts a lifecycle configuration to an Amazon S3 on Outposts bucket. To put a lifecycle configuration to an S3 bucket, + * see PutBucketLifecycleConfiguration in the Amazon Simple Storage Service API. + *

+ *
+ *

Creates a new lifecycle configuration for the Outposts bucket or replaces an existing + * lifecycle configuration. Outposts buckets only support lifecycle configurations that delete/expire objects + * after a certain period of time and abort incomplete multipart uploads. For more information, see Managing Lifecycle Permissions for Amazon S3 on Outposts.

+ *

+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ *

The following actions are related to PutBucketLifecycleConfiguration:

+ * + */ export class PutBucketLifecycleConfigurationCommand extends $Command< PutBucketLifecycleConfigurationCommandInput, PutBucketLifecycleConfigurationCommandOutput, @@ -35,6 +60,9 @@ export class PutBucketLifecycleConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/PutBucketPolicyCommand.ts b/clients/client-s3-control/commands/PutBucketPolicyCommand.ts index 86de099774bbf..c18b6b2f1b463 100644 --- a/clients/client-s3-control/commands/PutBucketPolicyCommand.ts +++ b/clients/client-s3-control/commands/PutBucketPolicyCommand.ts @@ -21,6 +21,47 @@ import { export type PutBucketPolicyCommandInput = PutBucketPolicyRequest; export type PutBucketPolicyCommandOutput = __MetadataBearer; +/** + * + *

This action puts a bucket policy to an Amazon S3 on Outposts bucket. To put a policy on an S3 bucket, + * see PutBucketPolicy in the Amazon Simple Storage Service API. + *

+ *
+ *

Applies an Amazon S3 bucket policy to an Outposts bucket. For more information, see Using Amazon S3 on Outposts in the + * Amazon Simple Storage Service Developer Guide.

+ *

If you are using an identity other than the root user of the AWS account that owns the + * Outposts bucket, the calling identity must have the PutBucketPolicy + * permissions on the specified Outposts bucket and belong to the bucket owner's account in + * order to use this operation.

+ * + *

If you don't have PutBucketPolicy permissions, Amazon S3 returns a 403 Access Denied error. If you have the correct permissions, + * but you're not using an identity that belongs to the bucket owner's account, Amazon S3 returns a 405 Method Not Allowed error.

+ * + * + *

As a security precaution, the root user of the AWS account that owns a bucket can always use this operation, even if the policy + * explicitly denies the root user the ability to perform this action. + *

+ *
+ * + * + *

For more information about bucket policies, see Using Bucket Policies and User Policies.

+ * + *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + *

The following actions are related to PutBucketPolicy:

+ * + */ export class PutBucketPolicyCommand extends $Command< PutBucketPolicyCommandInput, PutBucketPolicyCommandOutput, @@ -35,6 +76,9 @@ export class PutBucketPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/PutBucketTaggingCommand.ts b/clients/client-s3-control/commands/PutBucketTaggingCommand.ts index 7a3cb2a1e4fba..ec16e8bab080e 100644 --- a/clients/client-s3-control/commands/PutBucketTaggingCommand.ts +++ b/clients/client-s3-control/commands/PutBucketTaggingCommand.ts @@ -21,6 +21,91 @@ import { export type PutBucketTaggingCommandInput = PutBucketTaggingRequest; export type PutBucketTaggingCommandOutput = __MetadataBearer; +/** + * + *

This action puts tags on an Amazon S3 on Outposts bucket. To put tags on an S3 bucket, see + * PutBucketTagging in the Amazon Simple Storage Service API.

+ *
+ *

Sets the tags for an Outposts bucket. For more information, see Using Amazon S3 on Outposts in the + * Amazon Simple Storage Service Developer Guide.

+ *

Use tags to organize your AWS bill to reflect your own cost structure. To do this, sign up to get your + * AWS account bill with tag key values included. Then, to see the cost of combined resources, organize your + * billing information according to resources with the same tag key values. For example, you can tag several + * resources with a specific application name, and then organize your billing information to see the total cost + * of that application across several services. For more information, see + * Cost Allocation and Tagging.

+ * + * + *

Within a bucket, if you add a tag that has the same key as an existing tag, the new value overwrites + * the old value. For more information, see Using Cost Allocation in Amazon S3 + * Bucket Tags.

+ *
+ *

To use this operation, you must have permissions to perform the + * s3-outposts:PutBucketTagging action. The Outposts bucket owner has this + * permission by default and can grant this permission to others. For more information about + * permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

+ * PutBucketTagging has the following special errors:

+ *
    + *
  • + *

    Error code: InvalidTagError + *

    + * + *
  • + *
  • + *

    Error code: MalformedXMLError + *

    + *
      + *
    • + *

      Description: The XML provided does not match the schema.

      + *
    • + *
    + *
  • + *
  • + *

    Error code: OperationAbortedError + *

    + *
      + *
    • + *

      Description: A conflicting conditional operation is currently in progress against this + * resource. Try again.

      + *
    • + *
    + *
  • + *
  • + *

    Error code: InternalError + *

    + *
      + *
    • + *

      Description: The service was unable to apply the provided tag to the bucket.

      + *
    • + *
    + *
  • + *
+ *

All Amazon S3 on Outposts REST API requests for this action require an additional parameter of x-amz-outpost-id to be passed with the request and an S3 on Outposts endpoint hostname prefix instead of s3-control. For an example of the request syntax for Amazon S3 on Outposts that uses the S3 on Outposts endpoint hostname prefix and the x-amz-outpost-id derived using the access point ARN, see the Examples section.

+ * + *

The following actions are related to PutBucketTagging:

+ * + */ export class PutBucketTaggingCommand extends $Command< PutBucketTaggingCommandInput, PutBucketTaggingCommandOutput, @@ -35,6 +120,9 @@ export class PutBucketTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/PutJobTaggingCommand.ts b/clients/client-s3-control/commands/PutJobTaggingCommand.ts index 8a87d119b4c41..074bc8f611939 100644 --- a/clients/client-s3-control/commands/PutJobTaggingCommand.ts +++ b/clients/client-s3-control/commands/PutJobTaggingCommand.ts @@ -21,6 +21,72 @@ import { export type PutJobTaggingCommandInput = PutJobTaggingRequest; export type PutJobTaggingCommandOutput = PutJobTaggingResult & __MetadataBearer; +/** + *

Sets the supplied tag-set on an S3 Batch Operations job.

+ *

A tag is a key-value pair. You can associate S3 Batch Operations tags with any job by sending + * a PUT request against the tagging subresource that is associated with the job. To modify + * the existing tag set, you can either replace the existing tag set entirely, or make changes + * within the existing tag set by retrieving the existing tag set using GetJobTagging, modify that tag set, and use this action to replace the + * tag set with the one you modified. For more information, see Controlling access and + * labeling jobs using tags in the Amazon Simple Storage Service Developer Guide.

+ *

+ * + *
    + *
  • + *

    If you send this request with an empty tag set, Amazon S3 deletes the existing tag set on the + * Batch Operations job. If you use this method, you are charged for a Tier 1 Request + * (PUT). For more information, see Amazon S3 + * pricing.

    + *
  • + *
  • + *

    For deleting existing tags for your Batch Operations job, a DeleteJobTagging + * request is preferred because it achieves the same result without incurring + * charges.

    + *
  • + *
  • + *

    A few things to consider about using tags:

    + *
      + *
    • + *

      Amazon S3 limits the maximum number of tags to 50 tags per job.

      + *
    • + *
    • + *

      You can associate up to 50 tags with a job as long as they have unique tag keys.

      + *
    • + *
    • + *

      A tag key can be up to 128 Unicode characters in length, and tag values can be up to 256 Unicode characters in length.

      + *
    • + *
    • + *

      The key and values are case sensitive.

      + *
    • + *
    • + *

      For tagging-related restrictions related to characters and encodings, see User-Defined Tag Restrictions in the AWS Billing and + * Cost Management User Guide.

      + *
    • + *
    + *
  • + *
+ *
+ *

+ *

To use this operation, you must have permission to perform the s3:PutJobTagging action.

+ *

Related actions include:

+ * + */ export class PutJobTaggingCommand extends $Command< PutJobTaggingCommandInput, PutJobTaggingCommandOutput, @@ -35,6 +101,9 @@ export class PutJobTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/PutPublicAccessBlockCommand.ts b/clients/client-s3-control/commands/PutPublicAccessBlockCommand.ts index 4fab8a6061b09..4c02427e980d6 100644 --- a/clients/client-s3-control/commands/PutPublicAccessBlockCommand.ts +++ b/clients/client-s3-control/commands/PutPublicAccessBlockCommand.ts @@ -21,6 +21,24 @@ import { export type PutPublicAccessBlockCommandInput = PutPublicAccessBlockRequest; export type PutPublicAccessBlockCommandOutput = __MetadataBearer; +/** + *

Creates or modifies the PublicAccessBlock configuration for an AWS account. For + * more information, see Using Amazon S3 block + * public access.

+ *

Related actions include:

+ * + */ export class PutPublicAccessBlockCommand extends $Command< PutPublicAccessBlockCommandInput, PutPublicAccessBlockCommandOutput, @@ -35,6 +53,9 @@ export class PutPublicAccessBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/PutStorageLensConfigurationCommand.ts b/clients/client-s3-control/commands/PutStorageLensConfigurationCommand.ts index a61543e0cfcb5..8f876f44aa2dc 100644 --- a/clients/client-s3-control/commands/PutStorageLensConfigurationCommand.ts +++ b/clients/client-s3-control/commands/PutStorageLensConfigurationCommand.ts @@ -21,6 +21,16 @@ import { export type PutStorageLensConfigurationCommandInput = PutStorageLensConfigurationRequest; export type PutStorageLensConfigurationCommandOutput = __MetadataBearer; +/** + *

Puts an Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see Working with + * Amazon S3 Storage Lens in the Amazon Simple Storage Service Developer Guide.

+ * + *

To use this action, + * you must have permission to perform the s3:PutStorageLensConfiguration action. For more + * information, see Setting permissions to use Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ *
+ */ export class PutStorageLensConfigurationCommand extends $Command< PutStorageLensConfigurationCommandInput, PutStorageLensConfigurationCommandOutput, @@ -35,6 +45,9 @@ export class PutStorageLensConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/PutStorageLensConfigurationTaggingCommand.ts b/clients/client-s3-control/commands/PutStorageLensConfigurationTaggingCommand.ts index d4662eb734caf..8f2c594f0836f 100644 --- a/clients/client-s3-control/commands/PutStorageLensConfigurationTaggingCommand.ts +++ b/clients/client-s3-control/commands/PutStorageLensConfigurationTaggingCommand.ts @@ -25,6 +25,17 @@ export type PutStorageLensConfigurationTaggingCommandInput = PutStorageLensConfi export type PutStorageLensConfigurationTaggingCommandOutput = PutStorageLensConfigurationTaggingResult & __MetadataBearer; +/** + *

Put or replace tags on an existing Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see + * Working with Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ * + *

To use this action, + * you must have permission to perform the s3:PutStorageLensConfigurationTagging action. For more + * information, see Setting permissions to use Amazon S3 Storage Lens in the + * Amazon Simple Storage Service Developer Guide.

+ *
+ */ export class PutStorageLensConfigurationTaggingCommand extends $Command< PutStorageLensConfigurationTaggingCommandInput, PutStorageLensConfigurationTaggingCommandOutput, @@ -39,6 +50,9 @@ export class PutStorageLensConfigurationTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/UpdateJobPriorityCommand.ts b/clients/client-s3-control/commands/UpdateJobPriorityCommand.ts index a85b49f516d9b..e8d5652e05971 100644 --- a/clients/client-s3-control/commands/UpdateJobPriorityCommand.ts +++ b/clients/client-s3-control/commands/UpdateJobPriorityCommand.ts @@ -21,6 +21,34 @@ import { export type UpdateJobPriorityCommandInput = UpdateJobPriorityRequest; export type UpdateJobPriorityCommandOutput = UpdateJobPriorityResult & __MetadataBearer; +/** + *

Updates an existing S3 Batch Operations job's priority. For more information, see S3 Batch Operations in the + * Amazon Simple Storage Service Developer Guide.

+ *

+ *

Related actions include:

+ * + */ export class UpdateJobPriorityCommand extends $Command< UpdateJobPriorityCommandInput, UpdateJobPriorityCommandOutput, @@ -35,6 +63,9 @@ export class UpdateJobPriorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/commands/UpdateJobStatusCommand.ts b/clients/client-s3-control/commands/UpdateJobStatusCommand.ts index ec32dcfec2f2e..256f0a3a996d0 100644 --- a/clients/client-s3-control/commands/UpdateJobStatusCommand.ts +++ b/clients/client-s3-control/commands/UpdateJobStatusCommand.ts @@ -21,6 +21,35 @@ import { export type UpdateJobStatusCommandInput = UpdateJobStatusRequest; export type UpdateJobStatusCommandOutput = UpdateJobStatusResult & __MetadataBearer; +/** + *

Updates the status for the specified job. Use this operation to confirm that you want to + * run a job or to cancel an existing job. For more information, see S3 Batch Operations in the + * Amazon Simple Storage Service Developer Guide.

+ *

+ *

Related actions include:

+ * + */ export class UpdateJobStatusCommand extends $Command< UpdateJobStatusCommandInput, UpdateJobStatusCommandOutput, @@ -35,6 +64,9 @@ export class UpdateJobStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ControlClientResolvedConfig, diff --git a/clients/client-s3-control/package.json b/clients/client-s3-control/package.json index a8358833578fa..e7e6ae4826553 100644 --- a/clients/client-s3-control/package.json +++ b/clients/client-s3-control/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript S3 Control Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -70,7 +70,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-s3-control/pagination/ListAccessPointsPaginator.ts b/clients/client-s3-control/pagination/ListAccessPointsPaginator.ts index bfe51726754b2..901e636ce3a68 100644 --- a/clients/client-s3-control/pagination/ListAccessPointsPaginator.ts +++ b/clients/client-s3-control/pagination/ListAccessPointsPaginator.ts @@ -8,6 +8,9 @@ import { import { S3ControlPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: S3ControlClient, input: ListAccessPointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccessPointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: S3Control, input: ListAccessPointsCommandInput, diff --git a/clients/client-s3-control/pagination/ListJobsPaginator.ts b/clients/client-s3-control/pagination/ListJobsPaginator.ts index 7081a5192fb8e..3c606e721fe86 100644 --- a/clients/client-s3-control/pagination/ListJobsPaginator.ts +++ b/clients/client-s3-control/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { S3ControlPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: S3ControlClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: S3Control, input: ListJobsCommandInput, diff --git a/clients/client-s3-control/pagination/ListRegionalBucketsPaginator.ts b/clients/client-s3-control/pagination/ListRegionalBucketsPaginator.ts index 1b34497fd7e89..ad6badb32faf9 100644 --- a/clients/client-s3-control/pagination/ListRegionalBucketsPaginator.ts +++ b/clients/client-s3-control/pagination/ListRegionalBucketsPaginator.ts @@ -8,6 +8,9 @@ import { import { S3ControlPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: S3ControlClient, input: ListRegionalBucketsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRegionalBucketsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: S3Control, input: ListRegionalBucketsCommandInput, diff --git a/clients/client-s3-control/runtimeConfig.browser.ts b/clients/client-s3-control/runtimeConfig.browser.ts index db82a2c4c0de3..ba38eb375ffbf 100644 --- a/clients/client-s3-control/runtimeConfig.browser.ts +++ b/clients/client-s3-control/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./S3ControlClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-s3-control/runtimeConfig.native.ts b/clients/client-s3-control/runtimeConfig.native.ts index cfd1d7fc47b2a..d80b766e2815e 100644 --- a/clients/client-s3-control/runtimeConfig.native.ts +++ b/clients/client-s3-control/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./S3ControlClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-s3-control/runtimeConfig.shared.ts b/clients/client-s3-control/runtimeConfig.shared.ts index 92701a118e1a9..6567db954bb1a 100644 --- a/clients/client-s3-control/runtimeConfig.shared.ts +++ b/clients/client-s3-control/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-08-20", disableHostPrefix: false, diff --git a/clients/client-s3-control/runtimeConfig.ts b/clients/client-s3-control/runtimeConfig.ts index f4906a0f8599f..efc104aee1f11 100644 --- a/clients/client-s3-control/runtimeConfig.ts +++ b/clients/client-s3-control/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./S3ControlClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-s3-control/tsconfig.json b/clients/client-s3-control/tsconfig.json index d0a09bf323180..f994bbf7c065f 100644 --- a/clients/client-s3-control/tsconfig.json +++ b/clients/client-s3-control/tsconfig.json @@ -17,13 +17,16 @@ "types": ["mocha", "node"] }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-s3/commands/AbortMultipartUploadCommand.ts b/clients/client-s3/commands/AbortMultipartUploadCommand.ts index 49b1ef90493e0..2d377af2a185f 100644 --- a/clients/client-s3/commands/AbortMultipartUploadCommand.ts +++ b/clients/client-s3/commands/AbortMultipartUploadCommand.ts @@ -21,6 +21,47 @@ import { export type AbortMultipartUploadCommandInput = AbortMultipartUploadRequest; export type AbortMultipartUploadCommandOutput = AbortMultipartUploadOutput & __MetadataBearer; +/** + *

This operation aborts a multipart upload. After a multipart upload is aborted, no + * additional parts can be uploaded using that upload ID. The storage consumed by any + * previously uploaded parts will be freed. However, if any part uploads are currently in + * progress, those part uploads might or might not succeed. As a result, it might be necessary + * to abort a given multipart upload multiple times in order to completely free all storage + * consumed by all parts.

+ *

To verify that all parts have been removed, so you don't get charged for the part + * storage, you should call the ListParts operation and ensure that + * the parts list is empty.

+ *

For information about permissions required to use the multipart upload API, see Multipart Upload API and + * Permissions.

+ *

The following operations are related to AbortMultipartUpload:

+ * + */ export class AbortMultipartUploadCommand extends $Command< AbortMultipartUploadCommandInput, AbortMultipartUploadCommandOutput, @@ -35,6 +76,9 @@ export class AbortMultipartUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/CompleteMultipartUploadCommand.ts b/clients/client-s3/commands/CompleteMultipartUploadCommand.ts index da076a9b91f70..e7be94e252152 100644 --- a/clients/client-s3/commands/CompleteMultipartUploadCommand.ts +++ b/clients/client-s3/commands/CompleteMultipartUploadCommand.ts @@ -22,6 +22,118 @@ import { export type CompleteMultipartUploadCommandInput = CompleteMultipartUploadRequest; export type CompleteMultipartUploadCommandOutput = CompleteMultipartUploadOutput & __MetadataBearer; +/** + *

Completes a multipart upload by assembling previously uploaded parts.

+ *

You first initiate the multipart upload and then upload all parts using the UploadPart + * operation. After successfully uploading all relevant parts of an upload, you call this + * operation to complete the upload. Upon receiving this request, Amazon S3 concatenates all + * the parts in ascending order by part number to create a new object. In the Complete + * Multipart Upload request, you must provide the parts list. You must ensure that the parts + * list is complete. This operation concatenates the parts that you provide in the list. For + * each part in the list, you must provide the part number and the ETag value, + * returned after that part was uploaded.

+ *

Processing of a Complete Multipart Upload request could take several minutes to + * complete. After Amazon S3 begins processing the request, it sends an HTTP response header that + * specifies a 200 OK response. While processing is in progress, Amazon S3 periodically sends white + * space characters to keep the connection from timing out. Because a request could fail after + * the initial 200 OK response has been sent, it is important that you check the response body + * to determine whether the request succeeded.

+ *

Note that if CompleteMultipartUpload fails, applications should be prepared + * to retry the failed requests. For more information, see Amazon S3 Error Best Practices.

+ *

For more information about multipart uploads, see Uploading Objects Using Multipart + * Upload.

+ *

For information about permissions required to use the multipart upload API, see Multipart Upload API and + * Permissions.

+ * + * + *

+ * CompleteMultipartUpload has the following special errors:

+ *
    + *
  • + *

    Error code: EntityTooSmall + *

    + *
      + *
    • + *

      Description: Your proposed upload is smaller than the minimum allowed object + * size. Each part must be at least 5 MB in size, except the last part.

      + *
    • + *
    • + *

      400 Bad Request

      + *
    • + *
    + *
  • + *
  • + *

    Error code: InvalidPart + *

    + *
      + *
    • + *

      Description: One or more of the specified parts could not be found. The part + * might not have been uploaded, or the specified entity tag might not have + * matched the part's entity tag.

      + *
    • + *
    • + *

      400 Bad Request

      + *
    • + *
    + *
  • + *
  • + *

    Error code: InvalidPartOrder + *

    + *
      + *
    • + *

      Description: The list of parts was not in ascending order. The parts list + * must be specified in order by part number.

      + *
    • + *
    • + *

      400 Bad Request

      + *
    • + *
    + *
  • + *
  • + *

    Error code: NoSuchUpload + *

    + *
      + *
    • + *

      Description: The specified multipart upload does not exist. The upload ID + * might be invalid, or the multipart upload might have been aborted or + * completed.

      + *
    • + *
    • + *

      404 Not Found

      + *
    • + *
    + *
  • + *
+ * + *

The following operations are related to CompleteMultipartUpload:

+ * + */ export class CompleteMultipartUploadCommand extends $Command< CompleteMultipartUploadCommandInput, CompleteMultipartUploadCommandOutput, @@ -36,6 +148,9 @@ export class CompleteMultipartUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/CopyObjectCommand.ts b/clients/client-s3/commands/CopyObjectCommand.ts index a3a3fbd942c62..78e2e9c84e975 100644 --- a/clients/client-s3/commands/CopyObjectCommand.ts +++ b/clients/client-s3/commands/CopyObjectCommand.ts @@ -23,6 +23,181 @@ import { export type CopyObjectCommandInput = CopyObjectRequest; export type CopyObjectCommandOutput = CopyObjectOutput & __MetadataBearer; +/** + *

Creates a copy of an object that is already stored in Amazon S3.

+ * + *

You can store individual objects of up to 5 TB in Amazon S3. You create a copy of your + * object up to 5 GB in size in a single atomic operation using this API. However, to copy + * an object greater than 5 GB, you must use the multipart upload Upload Part - Copy API. + * For more information, see Copy Object Using the REST Multipart Upload API.

+ *
+ *

All copy requests must be authenticated. Additionally, you must have + * read access to the source object and write + * access to the destination bucket. For more information, see REST Authentication. Both the Region + * that you want to copy the object from and the Region that you want to copy the object to + * must be enabled for your account.

+ *

A copy request might return an error when Amazon S3 receives the copy request or while Amazon S3 + * is copying the files. If the error occurs before the copy operation starts, you receive a + * standard Amazon S3 error. If the error occurs during the copy operation, the error response is + * embedded in the 200 OK response. This means that a 200 OK + * response can contain either a success or an error. Design your application to parse the + * contents of the response and handle it appropriately.

+ *

If the copy is successful, you receive a response with information about the copied + * object.

+ * + *

If the request is an HTTP 1.1 request, the response is chunk encoded. If it were not, + * it would not contain the content-length, and you would need to read the entire + * body.

+ *
+ *

The copy request charge is based on the storage class and Region that you specify for + * the destination object. For pricing information, see Amazon S3 pricing.

+ * + *

Amazon S3 transfer acceleration does not support cross-Region copies. If you request a + * cross-Region copy using a transfer acceleration endpoint, you get a 400 Bad + * Request error. For more information, see Transfer Acceleration.

+ *
+ *

+ * Metadata + *

+ *

When copying an object, you can preserve all metadata (default) or specify new metadata. + * However, the ACL is not preserved and is set to private for the user making the request. To + * override the default ACL setting, specify a new ACL when generating a copy request. For + * more information, see Using ACLs.

+ *

To specify whether you want the object metadata copied from the source object or + * replaced with metadata provided in the request, you can optionally add the + * x-amz-metadata-directive header. When you grant permissions, you can use + * the s3:x-amz-metadata-directive condition key to enforce certain metadata + * behavior when objects are uploaded. For more information, see Specifying Conditions in a + * Policy in the Amazon S3 Developer Guide. For a complete list of + * Amazon S3-specific condition keys, see Actions, Resources, and Condition Keys for + * Amazon S3.

+ *

+ * + * x-amz-copy-source-if Headers + *

+ *

To only copy an object under certain conditions, such as whether the Etag + * matches or whether the object was modified before or after a specified date, use the + * following request parameters:

+ *
    + *
  • + *

    + * x-amz-copy-source-if-match + *

    + *
  • + *
  • + *

    + * x-amz-copy-source-if-none-match + *

    + *
  • + *
  • + *

    + * x-amz-copy-source-if-unmodified-since + *

    + *
  • + *
  • + *

    + * x-amz-copy-source-if-modified-since + *

    + *
  • + *
+ *

If both the x-amz-copy-source-if-match and + * x-amz-copy-source-if-unmodified-since headers are present in the request + * and evaluate as follows, Amazon S3 returns 200 OK and copies the data:

+ *
    + *
  • + *

    + * x-amz-copy-source-if-match condition evaluates to true

    + *
  • + *
  • + *

    + * x-amz-copy-source-if-unmodified-since condition evaluates to + * false

    + *
  • + *
+ * + *

If both the x-amz-copy-source-if-none-match and + * x-amz-copy-source-if-modified-since headers are present in the request and + * evaluate as follows, Amazon S3 returns the 412 Precondition Failed response + * code:

+ *
    + *
  • + *

    + * x-amz-copy-source-if-none-match condition evaluates to false

    + *
  • + *
  • + *

    + * x-amz-copy-source-if-modified-since condition evaluates to + * true

    + *
  • + *
+ * + * + *

All headers with the x-amz- prefix, including + * x-amz-copy-source, must be signed.

+ *
+ *

+ * Encryption + *

+ *

The source object that you are copying can be encrypted or unencrypted. The source + * object can be encrypted with server-side encryption using AWS managed encryption keys + * (SSE-S3 or SSE-KMS) or by using a customer-provided encryption key. With server-side + * encryption, Amazon S3 encrypts your data as it writes it to disks in its data centers and + * decrypts the data when you access it.

+ *

You can optionally use the appropriate encryption-related headers to request server-side + * encryption for the target object. You have the option to provide your own encryption key or + * use SSE-S3 or SSE-KMS, regardless of the form of server-side encryption that was used to + * encrypt the source object. You can even request encryption if the source object was not + * encrypted. For more information about server-side encryption, see Using + * Server-Side Encryption.

+ *

+ * Access Control List (ACL)-Specific Request + * Headers + *

+ *

When copying an object, you can optionally use headers to grant ACL-based permissions. + * By default, all objects are private. Only the owner has full access control. When adding a + * new object, you can grant permissions to individual AWS accounts or to predefined groups + * defined by Amazon S3. These permissions are then added to the ACL on the object. For more + * information, see Access Control List (ACL) Overview and Managing ACLs Using the REST + * API.

+ * + *

+ * Storage Class Options + *

+ *

You can use the CopyObject operation to change the storage class of an + * object that is already stored in Amazon S3 using the StorageClass parameter. For + * more information, see Storage + * Classes in the Amazon S3 Service Developer Guide.

+ *

+ * Versioning + *

+ *

By default, x-amz-copy-source identifies the current version of an object + * to copy. If the current version is a delete marker, Amazon S3 behaves as if the object was + * deleted. To copy a different version, use the versionId subresource.

+ *

If you enable versioning on the target bucket, Amazon S3 generates a unique version ID for + * the object being copied. This version ID is different from the version ID of the source + * object. Amazon S3 returns the version ID of the copied object in the + * x-amz-version-id response header in the response.

+ *

If you do not enable versioning or suspend it on the target bucket, the version ID that + * Amazon S3 generates is always null.

+ *

If the source object's storage class is GLACIER, you must restore a copy of this object + * before you can use it as a source object for the copy operation. For more information, see + * RestoreObject.

+ *

The following operations are related to CopyObject:

+ * + *

For more information, see Copying + * Objects.

+ */ export class CopyObjectCommand extends $Command< CopyObjectCommandInput, CopyObjectCommandOutput, @@ -37,6 +212,9 @@ export class CopyObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/CreateBucketCommand.ts b/clients/client-s3/commands/CreateBucketCommand.ts index 67a18e6bc6757..8f5902faee4c5 100644 --- a/clients/client-s3/commands/CreateBucketCommand.ts +++ b/clients/client-s3/commands/CreateBucketCommand.ts @@ -21,6 +21,120 @@ import { export type CreateBucketCommandInput = CreateBucketRequest; export type CreateBucketCommandOutput = CreateBucketOutput & __MetadataBearer; +/** + *

Creates a new S3 bucket. To create a bucket, you must register with Amazon S3 and have a + * valid AWS Access Key ID to authenticate requests. Anonymous requests are never allowed to + * create buckets. By creating the bucket, you become the bucket owner.

+ *

Not every string is an acceptable bucket name. For information about bucket naming + * restrictions, see Working with Amazon S3 + * buckets.

+ *

If you want to create an Amazon S3 on Outposts bucket, see Create Bucket.

+ *

By default, the bucket is created in the US East (N. Virginia) Region. You can + * optionally specify a Region in the request body. You might choose a Region to optimize + * latency, minimize costs, or address regulatory requirements. For example, if you reside in + * Europe, you will probably find it advantageous to create buckets in the Europe (Ireland) + * Region. For more information, see Accessing a + * bucket.

+ * + *

If you send your create bucket request to the s3.amazonaws.com endpoint, + * the request goes to the us-east-1 Region. Accordingly, the signature calculations in + * Signature Version 4 must use us-east-1 as the Region, even if the location constraint in + * the request specifies another Region where the bucket is to be created. If you create a + * bucket in a Region other than US East (N. Virginia), your application must be able to + * handle 307 redirect. For more information, see Virtual hosting of buckets.

+ *
+ *

When creating a bucket using this operation, you can optionally specify the accounts or + * groups that should be granted specific permissions on the bucket. There are two ways to + * grant the appropriate permissions using the request headers.

+ *
    + *
  • + *

    Specify a canned ACL using the x-amz-acl request header. Amazon S3 + * supports a set of predefined ACLs, known as canned ACLs. Each + * canned ACL has a predefined set of grantees and permissions. For more information, + * see Canned ACL.

    + *
  • + *
  • + *

    Specify access permissions explicitly using the x-amz-grant-read, + * x-amz-grant-write, x-amz-grant-read-acp, + * x-amz-grant-write-acp, and x-amz-grant-full-control + * headers. These headers map to the set of permissions Amazon S3 supports in an ACL. For + * more information, see Access control list + * (ACL) overview.

    + *

    You specify each grantee as a type=value pair, where the type is one of the + * following:

    + *
      + *
    • + *

      + * id – if the value specified is the canonical user ID of an AWS + * account

      + *
    • + *
    • + *

      + * uri – if you are granting permissions to a predefined + * group

      + *
    • + *
    • + *

      + * emailAddress – if the value specified is the email address of + * an AWS account

      + * + *

      Using email addresses to specify a grantee is only supported in the following AWS Regions:

      + *
        + *
      • + *

        US East (N. Virginia)

        + *
      • + *
      • + *

        US West (N. California)

        + *
      • + *
      • + *

        US West (Oregon)

        + *
      • + *
      • + *

        Asia Pacific (Singapore)

        + *
      • + *
      • + *

        Asia Pacific (Sydney)

        + *
      • + *
      • + *

        Asia Pacific (Tokyo)

        + *
      • + *
      • + *

        Europe (Ireland)

        + *
      • + *
      • + *

        South America (São Paulo)

        + *
      • + *
      + *

      For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints in the AWS General Reference.

      + *
      + *
    • + *
    + *

    For example, the following x-amz-grant-read header grants the AWS accounts identified by account IDs permissions to read object data and its metadata:

    + *

    + * x-amz-grant-read: id="11112222333", id="444455556666" + *

    + *
  • + *
+ * + *

You can use either a canned ACL or specify access permissions explicitly. You cannot + * do both.

+ *
+ * + * + *

The following operations are related to CreateBucket:

+ * + */ export class CreateBucketCommand extends $Command< CreateBucketCommandInput, CreateBucketCommandOutput, @@ -35,6 +149,9 @@ export class CreateBucketCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/CreateMultipartUploadCommand.ts b/clients/client-s3/commands/CreateMultipartUploadCommand.ts index b6d4abbc980eb..5f8b6a8d6660a 100644 --- a/clients/client-s3/commands/CreateMultipartUploadCommand.ts +++ b/clients/client-s3/commands/CreateMultipartUploadCommand.ts @@ -22,6 +22,270 @@ import { export type CreateMultipartUploadCommandInput = CreateMultipartUploadRequest; export type CreateMultipartUploadCommandOutput = CreateMultipartUploadOutput & __MetadataBearer; +/** + *

This operation initiates a multipart upload and returns an upload ID. This upload ID is + * used to associate all of the parts in the specific multipart upload. You specify this + * upload ID in each of your subsequent upload part requests (see UploadPart). You also include this + * upload ID in the final request to either complete or abort the multipart upload + * request.

+ * + *

For more information about multipart uploads, see Multipart Upload Overview.

+ * + *

If you have configured a lifecycle rule to abort incomplete multipart uploads, the + * upload must complete within the number of days specified in the bucket lifecycle + * configuration. Otherwise, the incomplete multipart upload becomes eligible for an abort + * operation and Amazon S3 aborts the multipart upload. For more information, see Aborting + * Incomplete Multipart Uploads Using a Bucket Lifecycle Policy.

+ * + *

For information about the permissions required to use the multipart upload API, see + * Multipart Upload API and + * Permissions.

+ * + *

For request signing, multipart upload is just a series of regular requests. You initiate + * a multipart upload, send one or more requests to upload parts, and then complete the + * multipart upload process. You sign each request individually. There is nothing special + * about signing multipart upload requests. For more information about signing, see Authenticating + * Requests (AWS Signature Version 4).

+ * + * + *

After you initiate a multipart upload and upload one or more parts, to stop being + * charged for storing the uploaded parts, you must either complete or abort the multipart + * upload. Amazon S3 frees up the space used to store the parts and stop charging you for + * storing them only after you either complete or abort a multipart upload.

+ *
+ * + *

You can optionally request server-side encryption. For server-side encryption, Amazon S3 + * encrypts your data as it writes it to disks in its data centers and decrypts it when you + * access it. You can provide your own encryption key, or use AWS Key Management Service (AWS + * KMS) customer master keys (CMKs) or Amazon S3-managed encryption keys. If you choose to provide + * your own encryption key, the request headers you provide in UploadPart and UploadPartCopy requests must match the headers you used in the request to + * initiate the upload by using CreateMultipartUpload.

+ *

To perform a multipart upload with encryption using an AWS KMS CMK, the requester must + * have permission to the kms:Encrypt, kms:Decrypt, + * kms:ReEncrypt*, kms:GenerateDataKey*, and + * kms:DescribeKey actions on the key. These permissions are required because + * Amazon S3 must decrypt and read data from the encrypted file parts before it completes the + * multipart upload.

+ * + *

If your AWS Identity and Access Management (IAM) user or role is in the same AWS account + * as the AWS KMS CMK, then you must have these permissions on the key policy. If your IAM + * user or role belongs to a different account than the key, then you must have the + * permissions on both the key policy and your IAM user or role.

+ * + * + *

For more information, see Protecting + * Data Using Server-Side Encryption.

+ * + *
+ *
Access Permissions
+ *
+ *

When copying an object, you can optionally specify the accounts or groups that + * should be granted specific permissions on the new object. There are two ways to + * grant the permissions using the request headers:

+ *
    + *
  • + *

    Specify a canned ACL with the x-amz-acl request header. For + * more information, see Canned ACL.

    + *
  • + *
  • + *

    Specify access permissions explicitly with the + * x-amz-grant-read, x-amz-grant-read-acp, + * x-amz-grant-write-acp, and + * x-amz-grant-full-control headers. These parameters map to + * the set of permissions that Amazon S3 supports in an ACL. For more information, + * see Access Control List (ACL) + * Overview.

    + *
  • + *
+ *

You can use either a canned ACL or specify access permissions explicitly. You + * cannot do both.

+ *
+ *
Server-Side- Encryption-Specific Request Headers
+ *
+ *

You can optionally tell Amazon S3 to encrypt data at rest using server-side + * encryption. Server-side encryption is for data encryption at rest. Amazon S3 encrypts + * your data as it writes it to disks in its data centers and decrypts it when you + * access it. The option you use depends on whether you want to use AWS managed + * encryption keys or provide your own encryption key.

+ *
    + *
  • + *

    Use encryption keys managed by Amazon S3 or customer master keys (CMKs) stored + * in AWS Key Management Service (AWS KMS) – If you want AWS to manage the keys + * used to encrypt data, specify the following headers in the request.

    + *
      + *
    • + *

      x-amz-server-side-encryption

      + *
    • + *
    • + *

      x-amz-server-side-encryption-aws-kms-key-id

      + *
    • + *
    • + *

      x-amz-server-side-encryption-context

      + *
    • + *
    + * + *

    If you specify x-amz-server-side-encryption:aws:kms, but + * don't provide x-amz-server-side-encryption-aws-kms-key-id, + * Amazon S3 uses the AWS managed CMK in AWS KMS to protect the data.

    + *
    + * + *

    All GET and PUT requests for an object protected by AWS KMS fail if + * you don't make them with SSL or by using SigV4.

    + *
    + *

    For more information about server-side encryption with CMKs stored in AWS + * KMS (SSE-KMS), see Protecting Data Using Server-Side Encryption with CMKs stored in AWS + * KMS.

    + *
  • + *
  • + *

    Use customer-provided encryption keys – If you want to manage your own + * encryption keys, provide all the following headers in the request.

    + *
      + *
    • + *

      x-amz-server-side-encryption-customer-algorithm

      + *
    • + *
    • + *

      x-amz-server-side-encryption-customer-key

      + *
    • + *
    • + *

      x-amz-server-side-encryption-customer-key-MD5

      + *
    • + *
    + *

    For more information about server-side encryption with CMKs stored in AWS + * KMS (SSE-KMS), see Protecting Data Using Server-Side Encryption with CMKs stored in AWS + * KMS.

    + *
  • + *
+ *
+ *
Access-Control-List (ACL)-Specific Request Headers
+ *
+ *

You also can use the following access control–related headers with this + * operation. By default, all objects are private. Only the owner has full access + * control. When adding a new object, you can grant permissions to individual AWS + * accounts or to predefined groups defined by Amazon S3. These permissions are then added + * to the access control list (ACL) on the object. For more information, see Using ACLs. With this + * operation, you can grant access permissions using one of the following two + * methods:

+ *
    + *
  • + *

    Specify a canned ACL (x-amz-acl) — Amazon S3 supports a set of + * predefined ACLs, known as canned ACLs. Each canned ACL + * has a predefined set of grantees and permissions. For more information, see + * Canned + * ACL.

    + *
  • + *
  • + *

    Specify access permissions explicitly — To explicitly grant access + * permissions to specific AWS accounts or groups, use the following headers. + * Each header maps to specific permissions that Amazon S3 supports in an ACL. For + * more information, see Access + * Control List (ACL) Overview. In the header, you specify a list of + * grantees who get the specific permission. To grant permissions explicitly, + * use:

    + *
      + *
    • + *

      x-amz-grant-read

      + *
    • + *
    • + *

      x-amz-grant-write

      + *
    • + *
    • + *

      x-amz-grant-read-acp

      + *
    • + *
    • + *

      x-amz-grant-write-acp

      + *
    • + *
    • + *

      x-amz-grant-full-control

      + *
    • + *
    + *

    You specify each grantee as a type=value pair, where the type is one of + * the following:

    + *
      + *
    • + *

      + * id – if the value specified is the canonical user ID + * of an AWS account

      + *
    • + *
    • + *

      + * uri – if you are granting permissions to a predefined + * group

      + *
    • + *
    • + *

      + * emailAddress – if the value specified is the email + * address of an AWS account

      + * + *

      Using email addresses to specify a grantee is only supported in the following AWS Regions:

      + *
        + *
      • + *

        US East (N. Virginia)

        + *
      • + *
      • + *

        US West (N. California)

        + *
      • + *
      • + *

        US West (Oregon)

        + *
      • + *
      • + *

        Asia Pacific (Singapore)

        + *
      • + *
      • + *

        Asia Pacific (Sydney)

        + *
      • + *
      • + *

        Asia Pacific (Tokyo)

        + *
      • + *
      • + *

        Europe (Ireland)

        + *
      • + *
      • + *

        South America (São Paulo)

        + *
      • + *
      + *

      For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints in the AWS General Reference.

      + *
      + *
    • + *
    + *

    For example, the following x-amz-grant-read header grants the AWS accounts identified by account IDs permissions to read object data and its metadata:

    + *

    + * x-amz-grant-read: id="11112222333", id="444455556666" + *

    + *
  • + *
+ * + *
+ *
+ * + *

The following operations are related to CreateMultipartUpload:

+ * + */ export class CreateMultipartUploadCommand extends $Command< CreateMultipartUploadCommandInput, CreateMultipartUploadCommandOutput, @@ -36,6 +300,9 @@ export class CreateMultipartUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketAnalyticsConfigurationCommand.ts b/clients/client-s3/commands/DeleteBucketAnalyticsConfigurationCommand.ts index 6cc6afb4d66ee..1e84e749c77c6 100644 --- a/clients/client-s3/commands/DeleteBucketAnalyticsConfigurationCommand.ts +++ b/clients/client-s3/commands/DeleteBucketAnalyticsConfigurationCommand.ts @@ -21,6 +21,38 @@ import { export type DeleteBucketAnalyticsConfigurationCommandInput = DeleteBucketAnalyticsConfigurationRequest; export type DeleteBucketAnalyticsConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes an analytics configuration for the bucket (specified by the analytics + * configuration ID).

+ *

To use this operation, you must have permissions to perform the + * s3:PutAnalyticsConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

For information about the Amazon S3 analytics feature, see Amazon S3 Analytics – Storage Class + * Analysis.

+ * + *

The following operations are related to + * DeleteBucketAnalyticsConfiguration:

+ * + */ export class DeleteBucketAnalyticsConfigurationCommand extends $Command< DeleteBucketAnalyticsConfigurationCommandInput, DeleteBucketAnalyticsConfigurationCommandOutput, @@ -35,6 +67,9 @@ export class DeleteBucketAnalyticsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketCommand.ts b/clients/client-s3/commands/DeleteBucketCommand.ts index 30f8065f1220f..366f703df56e8 100644 --- a/clients/client-s3/commands/DeleteBucketCommand.ts +++ b/clients/client-s3/commands/DeleteBucketCommand.ts @@ -20,6 +20,26 @@ import { export type DeleteBucketCommandInput = DeleteBucketRequest; export type DeleteBucketCommandOutput = __MetadataBearer; +/** + *

Deletes the S3 bucket. All objects (including all object versions and delete markers) in + * the bucket must be deleted before the bucket itself can be deleted.

+ * + *

+ * Related Resources + *

+ * + */ export class DeleteBucketCommand extends $Command< DeleteBucketCommandInput, DeleteBucketCommandOutput, @@ -34,6 +54,9 @@ export class DeleteBucketCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketCorsCommand.ts b/clients/client-s3/commands/DeleteBucketCorsCommand.ts index 3035755adb7ba..e96e6a3e489b8 100644 --- a/clients/client-s3/commands/DeleteBucketCorsCommand.ts +++ b/clients/client-s3/commands/DeleteBucketCorsCommand.ts @@ -21,6 +21,30 @@ import { export type DeleteBucketCorsCommandInput = DeleteBucketCorsRequest; export type DeleteBucketCorsCommandOutput = __MetadataBearer; +/** + *

Deletes the cors configuration information set for the bucket.

+ *

To use this operation, you must have permission to perform the + * s3:PutBucketCORS action. The bucket owner has this permission by default + * and can grant this permission to others.

+ *

For information about cors, see Enabling + * Cross-Origin Resource Sharing in the Amazon Simple Storage Service Developer Guide.

+ * + *

+ * Related Resources: + *

+ * + */ export class DeleteBucketCorsCommand extends $Command< DeleteBucketCorsCommandInput, DeleteBucketCorsCommandOutput, @@ -35,6 +59,9 @@ export class DeleteBucketCorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketEncryptionCommand.ts b/clients/client-s3/commands/DeleteBucketEncryptionCommand.ts index 6f9958c75ecca..db542fa75ebf0 100644 --- a/clients/client-s3/commands/DeleteBucketEncryptionCommand.ts +++ b/clients/client-s3/commands/DeleteBucketEncryptionCommand.ts @@ -21,6 +21,32 @@ import { export type DeleteBucketEncryptionCommandInput = DeleteBucketEncryptionRequest; export type DeleteBucketEncryptionCommandOutput = __MetadataBearer; +/** + *

This implementation of the DELETE operation removes default encryption from the bucket. + * For information about the Amazon S3 default encryption feature, see Amazon S3 Default Bucket Encryption in the + * Amazon Simple Storage Service Developer Guide.

+ *

To use this operation, you must have permissions to perform the + * s3:PutEncryptionConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to your Amazon S3 + * Resources in the Amazon Simple Storage Service Developer Guide.

+ * + *

+ * Related Resources + *

+ * + */ export class DeleteBucketEncryptionCommand extends $Command< DeleteBucketEncryptionCommandInput, DeleteBucketEncryptionCommandOutput, @@ -35,6 +61,9 @@ export class DeleteBucketEncryptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketIntelligentTieringConfigurationCommand.ts b/clients/client-s3/commands/DeleteBucketIntelligentTieringConfigurationCommand.ts index 900a4431ba1c9..f1a2787c5658e 100644 --- a/clients/client-s3/commands/DeleteBucketIntelligentTieringConfigurationCommand.ts +++ b/clients/client-s3/commands/DeleteBucketIntelligentTieringConfigurationCommand.ts @@ -21,6 +21,31 @@ import { export type DeleteBucketIntelligentTieringConfigurationCommandInput = DeleteBucketIntelligentTieringConfigurationRequest; export type DeleteBucketIntelligentTieringConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes the S3 Intelligent-Tiering configuration from the specified bucket.

+ *

The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without additional operational overhead. S3 Intelligent-Tiering delivers automatic cost savings by moving data between access tiers, when access patterns change.

+ *

The S3 Intelligent-Tiering storage class is suitable for objects larger than 128 KB that you plan to store for at least 30 days. If the size of an object is less than 128 KB, it is not eligible for auto-tiering. Smaller objects can be stored, but they are always charged at the frequent access tier rates in the S3 Intelligent-Tiering storage class.

+ *

If you delete an object before the end of the 30-day minimum storage duration period, you are charged for 30 days. For more information, see Storage class for automatically optimizing frequently and infrequently accessed objects.

+ *

Operations related to + * DeleteBucketIntelligentTieringConfiguration include:

+ * + */ export class DeleteBucketIntelligentTieringConfigurationCommand extends $Command< DeleteBucketIntelligentTieringConfigurationCommandInput, DeleteBucketIntelligentTieringConfigurationCommandOutput, @@ -35,6 +60,9 @@ export class DeleteBucketIntelligentTieringConfigurationCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketInventoryConfigurationCommand.ts b/clients/client-s3/commands/DeleteBucketInventoryConfigurationCommand.ts index 0249abd451256..3477f66d9034c 100644 --- a/clients/client-s3/commands/DeleteBucketInventoryConfigurationCommand.ts +++ b/clients/client-s3/commands/DeleteBucketInventoryConfigurationCommand.ts @@ -21,6 +21,34 @@ import { export type DeleteBucketInventoryConfigurationCommandInput = DeleteBucketInventoryConfigurationRequest; export type DeleteBucketInventoryConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes an inventory configuration (identified by the inventory ID) from the + * bucket.

+ *

To use this operation, you must have permissions to perform the + * s3:PutInventoryConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ *

For information about the Amazon S3 inventory feature, see Amazon S3 Inventory.

+ *

Operations related to DeleteBucketInventoryConfiguration include:

+ * + */ export class DeleteBucketInventoryConfigurationCommand extends $Command< DeleteBucketInventoryConfigurationCommandInput, DeleteBucketInventoryConfigurationCommandOutput, @@ -35,6 +63,9 @@ export class DeleteBucketInventoryConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketLifecycleCommand.ts b/clients/client-s3/commands/DeleteBucketLifecycleCommand.ts index dcbb1a4926805..90a0a6283bbdf 100644 --- a/clients/client-s3/commands/DeleteBucketLifecycleCommand.ts +++ b/clients/client-s3/commands/DeleteBucketLifecycleCommand.ts @@ -21,6 +21,34 @@ import { export type DeleteBucketLifecycleCommandInput = DeleteBucketLifecycleRequest; export type DeleteBucketLifecycleCommandOutput = __MetadataBearer; +/** + *

Deletes the lifecycle configuration from the specified bucket. Amazon S3 removes all the + * lifecycle configuration rules in the lifecycle subresource associated with the bucket. Your + * objects never expire, and Amazon S3 no longer automatically deletes any objects on the basis of + * rules contained in the deleted lifecycle configuration.

+ *

To use this operation, you must have permission to perform the + * s3:PutLifecycleConfiguration action. By default, the bucket owner has this + * permission and the bucket owner can grant this permission to others.

+ * + *

There is usually some time lag before lifecycle configuration deletion is fully + * propagated to all the Amazon S3 systems.

+ * + *

For more information about the object expiration, see Elements to + * Describe Lifecycle Actions.

+ *

Related actions include:

+ * + */ export class DeleteBucketLifecycleCommand extends $Command< DeleteBucketLifecycleCommandInput, DeleteBucketLifecycleCommandOutput, @@ -35,6 +63,9 @@ export class DeleteBucketLifecycleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketMetricsConfigurationCommand.ts b/clients/client-s3/commands/DeleteBucketMetricsConfigurationCommand.ts index 3154d7b6b8962..f7a3b3cb011ef 100644 --- a/clients/client-s3/commands/DeleteBucketMetricsConfigurationCommand.ts +++ b/clients/client-s3/commands/DeleteBucketMetricsConfigurationCommand.ts @@ -21,6 +21,44 @@ import { export type DeleteBucketMetricsConfigurationCommandInput = DeleteBucketMetricsConfigurationRequest; export type DeleteBucketMetricsConfigurationCommandOutput = __MetadataBearer; +/** + *

Deletes a metrics configuration for the Amazon CloudWatch request metrics (specified by the + * metrics configuration ID) from the bucket. Note that this doesn't include the daily storage + * metrics.

+ * + *

To use this operation, you must have permissions to perform the + * s3:PutMetricsConfiguration action. The bucket owner has this permission by + * default. The bucket owner can grant this permission to others. For more information about + * permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

For information about CloudWatch request metrics for Amazon S3, see Monitoring Metrics with Amazon CloudWatch.

+ *

The following operations are related to + * DeleteBucketMetricsConfiguration:

+ * + */ export class DeleteBucketMetricsConfigurationCommand extends $Command< DeleteBucketMetricsConfigurationCommandInput, DeleteBucketMetricsConfigurationCommandOutput, @@ -35,6 +73,9 @@ export class DeleteBucketMetricsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketOwnershipControlsCommand.ts b/clients/client-s3/commands/DeleteBucketOwnershipControlsCommand.ts index 28ae52b46a52d..79ec15017b623 100644 --- a/clients/client-s3/commands/DeleteBucketOwnershipControlsCommand.ts +++ b/clients/client-s3/commands/DeleteBucketOwnershipControlsCommand.ts @@ -21,6 +21,27 @@ import { export type DeleteBucketOwnershipControlsCommandInput = DeleteBucketOwnershipControlsRequest; export type DeleteBucketOwnershipControlsCommandOutput = __MetadataBearer; +/** + *

Removes OwnershipControls for an Amazon S3 bucket. To use this operation, you + * must have the s3:PutBucketOwnershipControls permission. For more information + * about Amazon S3 permissions, see Specifying + * Permissions in a Policy.

+ *

For information about Amazon S3 Object Ownership, see Using Object Ownership.

+ *

The following operations are related to + * DeleteBucketOwnershipControls:

+ * + */ export class DeleteBucketOwnershipControlsCommand extends $Command< DeleteBucketOwnershipControlsCommandInput, DeleteBucketOwnershipControlsCommandOutput, @@ -35,6 +56,9 @@ export class DeleteBucketOwnershipControlsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketPolicyCommand.ts b/clients/client-s3/commands/DeleteBucketPolicyCommand.ts index 54d4cedf1edaa..ef3d2786711b6 100644 --- a/clients/client-s3/commands/DeleteBucketPolicyCommand.ts +++ b/clients/client-s3/commands/DeleteBucketPolicyCommand.ts @@ -21,6 +21,44 @@ import { export type DeleteBucketPolicyCommandInput = DeleteBucketPolicyRequest; export type DeleteBucketPolicyCommandOutput = __MetadataBearer; +/** + *

This implementation of the DELETE operation uses the policy subresource to delete the + * policy of a specified bucket. If you are using an identity other than the root user of the + * AWS account that owns the bucket, the calling identity must have the + * DeleteBucketPolicy permissions on the specified bucket and belong to the + * bucket owner's account to use this operation.

+ * + *

If you don't have DeleteBucketPolicy permissions, Amazon S3 returns a 403 + * Access Denied error. If you have the correct permissions, but you're not using an + * identity that belongs to the bucket owner's account, Amazon S3 returns a 405 Method Not + * Allowed error.

+ * + * + * + *

As a security precaution, the root user of the AWS account that owns a bucket can + * always use this operation, even if the policy explicitly denies the root user the + * ability to perform this action.

+ *
+ * + * + * + *

For more information about bucket policies, see Using Bucket Policies and + * UserPolicies.

+ *

The following operations are related to DeleteBucketPolicy + *

+ * + */ export class DeleteBucketPolicyCommand extends $Command< DeleteBucketPolicyCommandInput, DeleteBucketPolicyCommandOutput, @@ -35,6 +73,9 @@ export class DeleteBucketPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketReplicationCommand.ts b/clients/client-s3/commands/DeleteBucketReplicationCommand.ts index c929f55d8e903..3a4d4889c1ed9 100644 --- a/clients/client-s3/commands/DeleteBucketReplicationCommand.ts +++ b/clients/client-s3/commands/DeleteBucketReplicationCommand.ts @@ -21,6 +21,35 @@ import { export type DeleteBucketReplicationCommandInput = DeleteBucketReplicationRequest; export type DeleteBucketReplicationCommandOutput = __MetadataBearer; +/** + *

Deletes the replication configuration from the bucket.

+ *

To use this operation, you must have permissions to perform the + * s3:PutReplicationConfiguration action. The bucket owner has these + * permissions by default and can grant it to others. For more information about permissions, + * see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

It can take a while for the deletion of a replication configuration to fully + * propagate.

+ *
+ * + *

For information about replication configuration, see Replication in the Amazon S3 Developer + * Guide.

+ * + *

The following operations are related to DeleteBucketReplication:

+ * + */ export class DeleteBucketReplicationCommand extends $Command< DeleteBucketReplicationCommandInput, DeleteBucketReplicationCommandOutput, @@ -35,6 +64,9 @@ export class DeleteBucketReplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketTaggingCommand.ts b/clients/client-s3/commands/DeleteBucketTaggingCommand.ts index 00e88f94de7e7..cb1b92ae30409 100644 --- a/clients/client-s3/commands/DeleteBucketTaggingCommand.ts +++ b/clients/client-s3/commands/DeleteBucketTaggingCommand.ts @@ -21,6 +21,26 @@ import { export type DeleteBucketTaggingCommandInput = DeleteBucketTaggingRequest; export type DeleteBucketTaggingCommandOutput = __MetadataBearer; +/** + *

Deletes the tags from the bucket.

+ * + *

To use this operation, you must have permission to perform the + * s3:PutBucketTagging action. By default, the bucket owner has this + * permission and can grant this permission to others.

+ *

The following operations are related to DeleteBucketTagging:

+ * + */ export class DeleteBucketTaggingCommand extends $Command< DeleteBucketTaggingCommandInput, DeleteBucketTaggingCommandOutput, @@ -35,6 +55,9 @@ export class DeleteBucketTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteBucketWebsiteCommand.ts b/clients/client-s3/commands/DeleteBucketWebsiteCommand.ts index 96fa7651f56d0..f3ffb56b1b7d9 100644 --- a/clients/client-s3/commands/DeleteBucketWebsiteCommand.ts +++ b/clients/client-s3/commands/DeleteBucketWebsiteCommand.ts @@ -21,6 +21,35 @@ import { export type DeleteBucketWebsiteCommandInput = DeleteBucketWebsiteRequest; export type DeleteBucketWebsiteCommandOutput = __MetadataBearer; +/** + *

This operation removes the website configuration for a bucket. Amazon S3 returns a 200 + * OK response upon successfully deleting a website configuration on the specified + * bucket. You will get a 200 OK response if the website configuration you are + * trying to delete does not exist on the bucket. Amazon S3 returns a 404 response if + * the bucket specified in the request does not exist.

+ * + *

This DELETE operation requires the S3:DeleteBucketWebsite permission. By + * default, only the bucket owner can delete the website configuration attached to a bucket. + * However, bucket owners can grant other users permission to delete the website configuration + * by writing a bucket policy granting them the S3:DeleteBucketWebsite + * permission.

+ * + *

For more information about hosting websites, see Hosting Websites on Amazon S3.

+ * + *

The following operations are related to DeleteBucketWebsite:

+ * + */ export class DeleteBucketWebsiteCommand extends $Command< DeleteBucketWebsiteCommandInput, DeleteBucketWebsiteCommandOutput, @@ -35,6 +64,9 @@ export class DeleteBucketWebsiteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteObjectCommand.ts b/clients/client-s3/commands/DeleteObjectCommand.ts index 93a0bf5d086fc..d8cff13b13a0e 100644 --- a/clients/client-s3/commands/DeleteObjectCommand.ts +++ b/clients/client-s3/commands/DeleteObjectCommand.ts @@ -21,6 +21,39 @@ import { export type DeleteObjectCommandInput = DeleteObjectRequest; export type DeleteObjectCommandOutput = DeleteObjectOutput & __MetadataBearer; +/** + *

Removes the null version (if there is one) of an object and inserts a delete marker, + * which becomes the latest version of the object. If there isn't a null version, Amazon S3 does + * not remove any objects.

+ * + *

To remove a specific version, you must be the bucket owner and you must use the version + * Id subresource. Using this subresource permanently deletes the version. If the object + * deleted is a delete marker, Amazon S3 sets the response header, + * x-amz-delete-marker, to true.

+ * + *

If the object you want to delete is in a bucket where the bucket versioning + * configuration is MFA Delete enabled, you must include the x-amz-mfa request + * header in the DELETE versionId request. Requests that include + * x-amz-mfa must use HTTPS.

+ * + *

For more information about MFA Delete, see Using MFA Delete. To see sample requests that use versioning, see Sample Request.

+ * + *

You can delete objects by explicitly calling the DELETE Object API or configure its + * lifecycle (PutBucketLifecycle) to + * enable Amazon S3 to remove them for you. If you want to block users or accounts from removing or + * deleting objects from your bucket, you must deny them the s3:DeleteObject, + * s3:DeleteObjectVersion, and s3:PutLifeCycleConfiguration + * actions.

+ * + *

The following operation is related to DeleteObject:

+ * + */ export class DeleteObjectCommand extends $Command< DeleteObjectCommandInput, DeleteObjectCommandOutput, @@ -35,6 +68,9 @@ export class DeleteObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteObjectTaggingCommand.ts b/clients/client-s3/commands/DeleteObjectTaggingCommand.ts index 7f558c24da9ff..847964f63e6a5 100644 --- a/clients/client-s3/commands/DeleteObjectTaggingCommand.ts +++ b/clients/client-s3/commands/DeleteObjectTaggingCommand.ts @@ -21,6 +21,33 @@ import { export type DeleteObjectTaggingCommandInput = DeleteObjectTaggingRequest; export type DeleteObjectTaggingCommandOutput = DeleteObjectTaggingOutput & __MetadataBearer; +/** + *

Removes the entire tag set from the specified object. For more information about + * managing object tags, see Object + * Tagging.

+ * + *

To use this operation, you must have permission to perform the + * s3:DeleteObjectTagging action.

+ * + *

To delete tags of a specific object version, add the versionId query + * parameter in the request. You will need permission for the + * s3:DeleteObjectVersionTagging action.

+ * + *

The following operations are related to + * DeleteBucketMetricsConfiguration:

+ * + */ export class DeleteObjectTaggingCommand extends $Command< DeleteObjectTaggingCommandInput, DeleteObjectTaggingCommandOutput, @@ -35,6 +62,9 @@ export class DeleteObjectTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeleteObjectsCommand.ts b/clients/client-s3/commands/DeleteObjectsCommand.ts index 98b79291882fe..21297289e2ba0 100644 --- a/clients/client-s3/commands/DeleteObjectsCommand.ts +++ b/clients/client-s3/commands/DeleteObjectsCommand.ts @@ -22,6 +22,65 @@ import { export type DeleteObjectsCommandInput = DeleteObjectsRequest; export type DeleteObjectsCommandOutput = DeleteObjectsOutput & __MetadataBearer; +/** + *

This operation enables you to delete multiple objects from a bucket using a single HTTP + * request. If you know the object keys that you want to delete, then this operation provides + * a suitable alternative to sending individual delete requests, reducing per-request + * overhead.

+ * + *

The request contains a list of up to 1000 keys that you want to delete. In the XML, you + * provide the object key names, and optionally, version IDs if you want to delete a specific + * version of the object from a versioning-enabled bucket. For each key, Amazon S3 performs a + * delete operation and returns the result of that delete, success, or failure, in the + * response. Note that if the object specified in the request is not found, Amazon S3 returns the + * result as deleted.

+ * + *

The operation supports two modes for the response: verbose and quiet. By default, the + * operation uses verbose mode in which the response includes the result of deletion of each + * key in your request. In quiet mode the response includes only keys where the delete + * operation encountered an error. For a successful deletion, the operation does not return + * any information about the delete in the response body.

+ * + *

When performing this operation on an MFA Delete enabled bucket, that attempts to delete + * any versioned objects, you must include an MFA token. If you do not provide one, the entire + * request will fail, even if there are non-versioned objects you are trying to delete. If you + * provide an invalid token, whether there are versioned keys in the request or not, the + * entire Multi-Object Delete request will fail. For information about MFA Delete, see MFA + * Delete.

+ * + *

Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon + * S3 uses the header value to ensure that your request body has not been altered in + * transit.

+ * + *

The following operations are related to DeleteObjects:

+ * + */ export class DeleteObjectsCommand extends $Command< DeleteObjectsCommandInput, DeleteObjectsCommandOutput, @@ -36,6 +95,9 @@ export class DeleteObjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/DeletePublicAccessBlockCommand.ts b/clients/client-s3/commands/DeletePublicAccessBlockCommand.ts index c27df501ad442..3595b45b61d12 100644 --- a/clients/client-s3/commands/DeletePublicAccessBlockCommand.ts +++ b/clients/client-s3/commands/DeletePublicAccessBlockCommand.ts @@ -21,6 +21,37 @@ import { export type DeletePublicAccessBlockCommandInput = DeletePublicAccessBlockRequest; export type DeletePublicAccessBlockCommandOutput = __MetadataBearer; +/** + *

Removes the PublicAccessBlock configuration for an Amazon S3 bucket. To use this + * operation, you must have the s3:PutBucketPublicAccessBlock permission. For + * more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

The following operations are related to DeletePublicAccessBlock:

+ * + */ export class DeletePublicAccessBlockCommand extends $Command< DeletePublicAccessBlockCommandInput, DeletePublicAccessBlockCommandOutput, @@ -35,6 +66,9 @@ export class DeletePublicAccessBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketAccelerateConfigurationCommand.ts b/clients/client-s3/commands/GetBucketAccelerateConfigurationCommand.ts index 9deca511b05b0..eac24e0baa935 100644 --- a/clients/client-s3/commands/GetBucketAccelerateConfigurationCommand.ts +++ b/clients/client-s3/commands/GetBucketAccelerateConfigurationCommand.ts @@ -21,6 +21,35 @@ import { export type GetBucketAccelerateConfigurationCommandInput = GetBucketAccelerateConfigurationRequest; export type GetBucketAccelerateConfigurationCommandOutput = GetBucketAccelerateConfigurationOutput & __MetadataBearer; +/** + *

This implementation of the GET operation uses the accelerate subresource to + * return the Transfer Acceleration state of a bucket, which is either Enabled or + * Suspended. Amazon S3 Transfer Acceleration is a bucket-level feature that + * enables you to perform faster data transfers to and from Amazon S3.

+ *

To use this operation, you must have permission to perform the + * s3:GetAccelerateConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to your Amazon S3 + * Resources in the Amazon Simple Storage Service Developer Guide.

+ *

You set the Transfer Acceleration state of an existing bucket to Enabled or + * Suspended by using the PutBucketAccelerateConfiguration operation.

+ *

A GET accelerate request does not return a state value for a bucket that + * has no transfer acceleration state. A bucket has no Transfer Acceleration state if a state + * has never been set on the bucket.

+ * + *

For more information about transfer acceleration, see Transfer Acceleration in the + * Amazon Simple Storage Service Developer Guide.

+ *

+ * Related Resources + *

+ * + */ export class GetBucketAccelerateConfigurationCommand extends $Command< GetBucketAccelerateConfigurationCommandInput, GetBucketAccelerateConfigurationCommandOutput, @@ -35,6 +64,9 @@ export class GetBucketAccelerateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketAclCommand.ts b/clients/client-s3/commands/GetBucketAclCommand.ts index 98cea561df98f..770fa33442046 100644 --- a/clients/client-s3/commands/GetBucketAclCommand.ts +++ b/clients/client-s3/commands/GetBucketAclCommand.ts @@ -21,6 +21,24 @@ import { export type GetBucketAclCommandInput = GetBucketAclRequest; export type GetBucketAclCommandOutput = GetBucketAclOutput & __MetadataBearer; +/** + *

This implementation of the GET operation uses the acl + * subresource to return the access control list (ACL) of a bucket. To use GET to + * return the ACL of the bucket, you must have READ_ACP access to the bucket. If + * READ_ACP permission is granted to the anonymous user, you can return the + * ACL of the bucket without using an authorization header.

+ * + *

+ * Related Resources + *

+ * + */ export class GetBucketAclCommand extends $Command< GetBucketAclCommandInput, GetBucketAclCommandOutput, @@ -35,6 +53,9 @@ export class GetBucketAclCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketAnalyticsConfigurationCommand.ts b/clients/client-s3/commands/GetBucketAnalyticsConfigurationCommand.ts index c0301d87db0a3..4b5d03269304a 100644 --- a/clients/client-s3/commands/GetBucketAnalyticsConfigurationCommand.ts +++ b/clients/client-s3/commands/GetBucketAnalyticsConfigurationCommand.ts @@ -21,6 +21,38 @@ import { export type GetBucketAnalyticsConfigurationCommandInput = GetBucketAnalyticsConfigurationRequest; export type GetBucketAnalyticsConfigurationCommandOutput = GetBucketAnalyticsConfigurationOutput & __MetadataBearer; +/** + *

This implementation of the GET operation returns an analytics configuration (identified + * by the analytics configuration ID) from the bucket.

+ *

To use this operation, you must have permissions to perform the + * s3:GetAnalyticsConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources in the Amazon Simple Storage Service Developer Guide.

+ *

For information about Amazon S3 analytics feature, see Amazon S3 Analytics – Storage Class + * Analysis in the Amazon Simple Storage Service Developer Guide.

+ * + *

+ * Related Resources + *

+ * + */ export class GetBucketAnalyticsConfigurationCommand extends $Command< GetBucketAnalyticsConfigurationCommandInput, GetBucketAnalyticsConfigurationCommandOutput, @@ -35,6 +67,9 @@ export class GetBucketAnalyticsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketCorsCommand.ts b/clients/client-s3/commands/GetBucketCorsCommand.ts index dba091c7871c2..afee6f78a7dd8 100644 --- a/clients/client-s3/commands/GetBucketCorsCommand.ts +++ b/clients/client-s3/commands/GetBucketCorsCommand.ts @@ -21,6 +21,29 @@ import { export type GetBucketCorsCommandInput = GetBucketCorsRequest; export type GetBucketCorsCommandOutput = GetBucketCorsOutput & __MetadataBearer; +/** + *

Returns the cors configuration information set for the bucket.

+ * + *

To use this operation, you must have permission to perform the s3:GetBucketCORS action. + * By default, the bucket owner has this permission and can grant it to others.

+ * + *

For more information about cors, see Enabling + * Cross-Origin Resource Sharing.

+ * + *

The following operations are related to GetBucketCors:

+ * + */ export class GetBucketCorsCommand extends $Command< GetBucketCorsCommandInput, GetBucketCorsCommandOutput, @@ -35,6 +58,9 @@ export class GetBucketCorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketEncryptionCommand.ts b/clients/client-s3/commands/GetBucketEncryptionCommand.ts index 4982b161672a4..7e8a78643b954 100644 --- a/clients/client-s3/commands/GetBucketEncryptionCommand.ts +++ b/clients/client-s3/commands/GetBucketEncryptionCommand.ts @@ -21,6 +21,29 @@ import { export type GetBucketEncryptionCommandInput = GetBucketEncryptionRequest; export type GetBucketEncryptionCommandOutput = GetBucketEncryptionOutput & __MetadataBearer; +/** + *

Returns the default encryption configuration for an Amazon S3 bucket. For information about + * the Amazon S3 default encryption feature, see Amazon S3 Default Bucket Encryption.

+ * + *

To use this operation, you must have permission to perform the + * s3:GetEncryptionConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ *

The following operations are related to GetBucketEncryption:

+ * + */ export class GetBucketEncryptionCommand extends $Command< GetBucketEncryptionCommandInput, GetBucketEncryptionCommandOutput, @@ -35,6 +58,9 @@ export class GetBucketEncryptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketIntelligentTieringConfigurationCommand.ts b/clients/client-s3/commands/GetBucketIntelligentTieringConfigurationCommand.ts index 785c213ac97a7..08887ccc7fa83 100644 --- a/clients/client-s3/commands/GetBucketIntelligentTieringConfigurationCommand.ts +++ b/clients/client-s3/commands/GetBucketIntelligentTieringConfigurationCommand.ts @@ -25,6 +25,31 @@ export type GetBucketIntelligentTieringConfigurationCommandInput = GetBucketInte export type GetBucketIntelligentTieringConfigurationCommandOutput = GetBucketIntelligentTieringConfigurationOutput & __MetadataBearer; +/** + *

Gets the S3 Intelligent-Tiering configuration from the specified bucket.

+ *

The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without additional operational overhead. S3 Intelligent-Tiering delivers automatic cost savings by moving data between access tiers, when access patterns change.

+ *

The S3 Intelligent-Tiering storage class is suitable for objects larger than 128 KB that you plan to store for at least 30 days. If the size of an object is less than 128 KB, it is not eligible for auto-tiering. Smaller objects can be stored, but they are always charged at the frequent access tier rates in the S3 Intelligent-Tiering storage class.

+ *

If you delete an object before the end of the 30-day minimum storage duration period, you are charged for 30 days. For more information, see Storage class for automatically optimizing frequently and infrequently accessed objects.

+ *

Operations related to + * GetBucketIntelligentTieringConfiguration include:

+ * + */ export class GetBucketIntelligentTieringConfigurationCommand extends $Command< GetBucketIntelligentTieringConfigurationCommandInput, GetBucketIntelligentTieringConfigurationCommandOutput, @@ -39,6 +64,9 @@ export class GetBucketIntelligentTieringConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketInventoryConfigurationCommand.ts b/clients/client-s3/commands/GetBucketInventoryConfigurationCommand.ts index eb76954b896ec..3ade46c02d5dd 100644 --- a/clients/client-s3/commands/GetBucketInventoryConfigurationCommand.ts +++ b/clients/client-s3/commands/GetBucketInventoryConfigurationCommand.ts @@ -21,6 +21,38 @@ import { export type GetBucketInventoryConfigurationCommandInput = GetBucketInventoryConfigurationRequest; export type GetBucketInventoryConfigurationCommandOutput = GetBucketInventoryConfigurationOutput & __MetadataBearer; +/** + *

Returns an inventory configuration (identified by the inventory configuration ID) from + * the bucket.

+ * + *

To use this operation, you must have permissions to perform the + * s3:GetInventoryConfiguration action. The bucket owner has this permission + * by default and can grant this permission to others. For more information about permissions, + * see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

For information about the Amazon S3 inventory feature, see Amazon S3 Inventory.

+ * + *

The following operations are related to + * GetBucketInventoryConfiguration:

+ * + */ export class GetBucketInventoryConfigurationCommand extends $Command< GetBucketInventoryConfigurationCommandInput, GetBucketInventoryConfigurationCommandOutput, @@ -35,6 +67,9 @@ export class GetBucketInventoryConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketLifecycleConfigurationCommand.ts b/clients/client-s3/commands/GetBucketLifecycleConfigurationCommand.ts index 113967ac07573..dddd97d3803b5 100644 --- a/clients/client-s3/commands/GetBucketLifecycleConfigurationCommand.ts +++ b/clients/client-s3/commands/GetBucketLifecycleConfigurationCommand.ts @@ -21,6 +21,64 @@ import { export type GetBucketLifecycleConfigurationCommandInput = GetBucketLifecycleConfigurationRequest; export type GetBucketLifecycleConfigurationCommandOutput = GetBucketLifecycleConfigurationOutput & __MetadataBearer; +/** + * + *

Bucket lifecycle configuration now supports specifying a lifecycle rule using an + * object key name prefix, one or more object tags, or a combination of both. Accordingly, + * this section describes the latest API. The response describes the new filter element + * that you can use to specify a filter to select a subset of objects to which the rule + * applies. If you are using a previous version of the lifecycle configuration, it still + * works. For the earlier API description, see GetBucketLifecycle.

+ *
+ *

Returns the lifecycle configuration information set on the bucket. For information about + * lifecycle configuration, see Object + * Lifecycle Management.

+ * + *

To use this operation, you must have permission to perform the + * s3:GetLifecycleConfiguration action. The bucket owner has this permission, + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

+ * GetBucketLifecycleConfiguration has the following special error:

+ *
    + *
  • + *

    Error code: NoSuchLifecycleConfiguration + *

    + *
      + *
    • + *

      Description: The lifecycle configuration does not exist.

      + *
    • + *
    • + *

      HTTP Status Code: 404 Not Found

      + *
    • + *
    • + *

      SOAP Fault Code Prefix: Client

      + *
    • + *
    + *
  • + *
+ *

The following operations are related to + * GetBucketLifecycleConfiguration:

+ * + */ export class GetBucketLifecycleConfigurationCommand extends $Command< GetBucketLifecycleConfigurationCommandInput, GetBucketLifecycleConfigurationCommandOutput, @@ -35,6 +93,9 @@ export class GetBucketLifecycleConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketLocationCommand.ts b/clients/client-s3/commands/GetBucketLocationCommand.ts index 64af4195c54f8..94359175c7972 100644 --- a/clients/client-s3/commands/GetBucketLocationCommand.ts +++ b/clients/client-s3/commands/GetBucketLocationCommand.ts @@ -21,6 +21,27 @@ import { export type GetBucketLocationCommandInput = GetBucketLocationRequest; export type GetBucketLocationCommandOutput = GetBucketLocationOutput & __MetadataBearer; +/** + *

Returns the Region the bucket resides in. You set the bucket's Region using the + * LocationConstraint request parameter in a CreateBucket + * request. For more information, see CreateBucket.

+ * + *

To use this implementation of the operation, you must be the bucket owner.

+ * + *

The following operations are related to GetBucketLocation:

+ * + */ export class GetBucketLocationCommand extends $Command< GetBucketLocationCommandInput, GetBucketLocationCommandOutput, @@ -35,6 +56,9 @@ export class GetBucketLocationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketLoggingCommand.ts b/clients/client-s3/commands/GetBucketLoggingCommand.ts index 2f3b43f954998..2cac0f5a3013f 100644 --- a/clients/client-s3/commands/GetBucketLoggingCommand.ts +++ b/clients/client-s3/commands/GetBucketLoggingCommand.ts @@ -21,6 +21,24 @@ import { export type GetBucketLoggingCommandInput = GetBucketLoggingRequest; export type GetBucketLoggingCommandOutput = GetBucketLoggingOutput & __MetadataBearer; +/** + *

Returns the logging status of a bucket and the permissions users have to view and modify + * that status. To use GET, you must be the bucket owner.

+ * + *

The following operations are related to GetBucketLogging:

+ * + */ export class GetBucketLoggingCommand extends $Command< GetBucketLoggingCommandInput, GetBucketLoggingCommandOutput, @@ -35,6 +53,9 @@ export class GetBucketLoggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketMetricsConfigurationCommand.ts b/clients/client-s3/commands/GetBucketMetricsConfigurationCommand.ts index 07995cca5dd71..96657fd229f25 100644 --- a/clients/client-s3/commands/GetBucketMetricsConfigurationCommand.ts +++ b/clients/client-s3/commands/GetBucketMetricsConfigurationCommand.ts @@ -21,6 +21,45 @@ import { export type GetBucketMetricsConfigurationCommandInput = GetBucketMetricsConfigurationRequest; export type GetBucketMetricsConfigurationCommandOutput = GetBucketMetricsConfigurationOutput & __MetadataBearer; +/** + *

Gets a metrics configuration (specified by the metrics configuration ID) from the + * bucket. Note that this doesn't include the daily storage metrics.

+ * + *

To use this operation, you must have permissions to perform the + * s3:GetMetricsConfiguration action. The bucket owner has this permission by + * default. The bucket owner can grant this permission to others. For more information about + * permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

For information about CloudWatch request metrics for Amazon S3, see Monitoring Metrics with Amazon + * CloudWatch.

+ * + *

The following operations are related to + * GetBucketMetricsConfiguration:

+ * + */ export class GetBucketMetricsConfigurationCommand extends $Command< GetBucketMetricsConfigurationCommandInput, GetBucketMetricsConfigurationCommandOutput, @@ -35,6 +74,9 @@ export class GetBucketMetricsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketNotificationConfigurationCommand.ts b/clients/client-s3/commands/GetBucketNotificationConfigurationCommand.ts index 96f4245410348..1bc18b5a98914 100644 --- a/clients/client-s3/commands/GetBucketNotificationConfigurationCommand.ts +++ b/clients/client-s3/commands/GetBucketNotificationConfigurationCommand.ts @@ -21,6 +21,29 @@ import { export type GetBucketNotificationConfigurationCommandInput = GetBucketNotificationConfigurationRequest; export type GetBucketNotificationConfigurationCommandOutput = NotificationConfiguration & __MetadataBearer; +/** + *

Returns the notification configuration of a bucket.

+ *

If notifications are not enabled on the bucket, the operation returns an empty + * NotificationConfiguration element.

+ * + *

By default, you must be the bucket owner to read the notification configuration of a + * bucket. However, the bucket owner can use a bucket policy to grant permission to other + * users to read this configuration with the s3:GetBucketNotification + * permission.

+ * + *

For more information about setting and reading the notification configuration on a + * bucket, see Setting Up Notification of + * Bucket Events. For more information about bucket policies, see Using Bucket Policies.

+ * + *

The following operation is related to GetBucketNotification:

+ * + */ export class GetBucketNotificationConfigurationCommand extends $Command< GetBucketNotificationConfigurationCommandInput, GetBucketNotificationConfigurationCommandOutput, @@ -35,6 +58,9 @@ export class GetBucketNotificationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketOwnershipControlsCommand.ts b/clients/client-s3/commands/GetBucketOwnershipControlsCommand.ts index fa4914aef9f0e..bc606520837e9 100644 --- a/clients/client-s3/commands/GetBucketOwnershipControlsCommand.ts +++ b/clients/client-s3/commands/GetBucketOwnershipControlsCommand.ts @@ -21,6 +21,26 @@ import { export type GetBucketOwnershipControlsCommandInput = GetBucketOwnershipControlsRequest; export type GetBucketOwnershipControlsCommandOutput = GetBucketOwnershipControlsOutput & __MetadataBearer; +/** + *

Retrieves OwnershipControls for an Amazon S3 bucket. To use this operation, you + * must have the s3:GetBucketOwnershipControls permission. For more information + * about Amazon S3 permissions, see Specifying + * Permissions in a Policy.

+ *

For information about Amazon S3 Object Ownership, see Using Object Ownership.

+ *

The following operations are related to GetBucketOwnershipControls:

+ * + */ export class GetBucketOwnershipControlsCommand extends $Command< GetBucketOwnershipControlsCommandInput, GetBucketOwnershipControlsCommandOutput, @@ -35,6 +55,9 @@ export class GetBucketOwnershipControlsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketPolicyCommand.ts b/clients/client-s3/commands/GetBucketPolicyCommand.ts index 3c5828a38a430..3844ec1c756f5 100644 --- a/clients/client-s3/commands/GetBucketPolicyCommand.ts +++ b/clients/client-s3/commands/GetBucketPolicyCommand.ts @@ -21,6 +21,35 @@ import { export type GetBucketPolicyCommandInput = GetBucketPolicyRequest; export type GetBucketPolicyCommandOutput = GetBucketPolicyOutput & __MetadataBearer; +/** + *

Returns the policy of a specified bucket. If you are using an identity other than the + * root user of the AWS account that owns the bucket, the calling identity must have the + * GetBucketPolicy permissions on the specified bucket and belong to the + * bucket owner's account in order to use this operation.

+ * + *

If you don't have GetBucketPolicy permissions, Amazon S3 returns a 403 + * Access Denied error. If you have the correct permissions, but you're not using an + * identity that belongs to the bucket owner's account, Amazon S3 returns a 405 Method Not + * Allowed error.

+ * + * + *

As a security precaution, the root user of the AWS account that owns a bucket can + * always use this operation, even if the policy explicitly denies the root user the + * ability to perform this action.

+ *
+ * + *

For more information about bucket policies, see Using Bucket Policies and User + * Policies.

+ * + *

The following operation is related to GetBucketPolicy:

+ * + */ export class GetBucketPolicyCommand extends $Command< GetBucketPolicyCommandInput, GetBucketPolicyCommandOutput, @@ -35,6 +64,9 @@ export class GetBucketPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketPolicyStatusCommand.ts b/clients/client-s3/commands/GetBucketPolicyStatusCommand.ts index 4984ae305b1ef..3c150c48cbddf 100644 --- a/clients/client-s3/commands/GetBucketPolicyStatusCommand.ts +++ b/clients/client-s3/commands/GetBucketPolicyStatusCommand.ts @@ -21,6 +21,39 @@ import { export type GetBucketPolicyStatusCommandInput = GetBucketPolicyStatusRequest; export type GetBucketPolicyStatusCommandOutput = GetBucketPolicyStatusOutput & __MetadataBearer; +/** + *

Retrieves the policy status for an Amazon S3 bucket, indicating whether the bucket is public. + * In order to use this operation, you must have the s3:GetBucketPolicyStatus + * permission. For more information about Amazon S3 permissions, see Specifying Permissions in a + * Policy.

+ * + *

For more information about when Amazon S3 considers a bucket public, see The Meaning of "Public".

+ * + *

The following operations are related to GetBucketPolicyStatus:

+ * + */ export class GetBucketPolicyStatusCommand extends $Command< GetBucketPolicyStatusCommandInput, GetBucketPolicyStatusCommandOutput, @@ -35,6 +68,9 @@ export class GetBucketPolicyStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketReplicationCommand.ts b/clients/client-s3/commands/GetBucketReplicationCommand.ts index 274a7a422c694..c5ba7de5113c4 100644 --- a/clients/client-s3/commands/GetBucketReplicationCommand.ts +++ b/clients/client-s3/commands/GetBucketReplicationCommand.ts @@ -21,6 +21,43 @@ import { export type GetBucketReplicationCommandInput = GetBucketReplicationRequest; export type GetBucketReplicationCommandOutput = GetBucketReplicationOutput & __MetadataBearer; +/** + *

Returns the replication configuration of a bucket.

+ * + *

It can take a while to propagate the put or delete a replication configuration to + * all Amazon S3 systems. Therefore, a get request soon after put or delete can return a wrong + * result.

+ *
+ *

For information about replication configuration, see Replication in the + * Amazon Simple Storage Service Developer Guide.

+ * + *

This operation requires permissions for the s3:GetReplicationConfiguration + * action. For more information about permissions, see Using Bucket Policies and User + * Policies.

+ * + *

If you include the Filter element in a replication configuration, you must + * also include the DeleteMarkerReplication and Priority elements. + * The response also returns those elements.

+ * + *

For information about GetBucketReplication errors, see List of + * replication-related error codes + *

+ * + * + *

The following operations are related to GetBucketReplication:

+ * + */ export class GetBucketReplicationCommand extends $Command< GetBucketReplicationCommandInput, GetBucketReplicationCommandOutput, @@ -35,6 +72,9 @@ export class GetBucketReplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketRequestPaymentCommand.ts b/clients/client-s3/commands/GetBucketRequestPaymentCommand.ts index e9596707493f0..c3155dbeab875 100644 --- a/clients/client-s3/commands/GetBucketRequestPaymentCommand.ts +++ b/clients/client-s3/commands/GetBucketRequestPaymentCommand.ts @@ -21,6 +21,19 @@ import { export type GetBucketRequestPaymentCommandInput = GetBucketRequestPaymentRequest; export type GetBucketRequestPaymentCommandOutput = GetBucketRequestPaymentOutput & __MetadataBearer; +/** + *

Returns the request payment configuration of a bucket. To use this version of the + * operation, you must be the bucket owner. For more information, see Requester Pays Buckets.

+ * + *

The following operations are related to GetBucketRequestPayment:

+ * + */ export class GetBucketRequestPaymentCommand extends $Command< GetBucketRequestPaymentCommandInput, GetBucketRequestPaymentCommandOutput, @@ -35,6 +48,9 @@ export class GetBucketRequestPaymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketTaggingCommand.ts b/clients/client-s3/commands/GetBucketTaggingCommand.ts index 0a0a775e53a77..a89102ff6792c 100644 --- a/clients/client-s3/commands/GetBucketTaggingCommand.ts +++ b/clients/client-s3/commands/GetBucketTaggingCommand.ts @@ -21,6 +21,40 @@ import { export type GetBucketTaggingCommandInput = GetBucketTaggingRequest; export type GetBucketTaggingCommandOutput = GetBucketTaggingOutput & __MetadataBearer; +/** + *

Returns the tag set associated with the bucket.

+ *

To use this operation, you must have permission to perform the + * s3:GetBucketTagging action. By default, the bucket owner has this + * permission and can grant this permission to others.

+ * + *

+ * GetBucketTagging has the following special error:

+ *
    + *
  • + *

    Error code: NoSuchTagSetError + *

    + *
      + *
    • + *

      Description: There is no tag set associated with the bucket.

      + *
    • + *
    + *
  • + *
+ * + *

The following operations are related to GetBucketTagging:

+ * + */ export class GetBucketTaggingCommand extends $Command< GetBucketTaggingCommandInput, GetBucketTaggingCommandOutput, @@ -35,6 +69,9 @@ export class GetBucketTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketVersioningCommand.ts b/clients/client-s3/commands/GetBucketVersioningCommand.ts index 8b362234466bb..2df1a60f92ea3 100644 --- a/clients/client-s3/commands/GetBucketVersioningCommand.ts +++ b/clients/client-s3/commands/GetBucketVersioningCommand.ts @@ -21,6 +21,33 @@ import { export type GetBucketVersioningCommandInput = GetBucketVersioningRequest; export type GetBucketVersioningCommandOutput = GetBucketVersioningOutput & __MetadataBearer; +/** + *

Returns the versioning state of a bucket.

+ *

To retrieve the versioning state of a bucket, you must be the bucket owner.

+ * + *

This implementation also returns the MFA Delete status of the versioning state. If the + * MFA Delete status is enabled, the bucket owner must use an authentication + * device to change the versioning state of the bucket.

+ * + *

The following operations are related to GetBucketVersioning:

+ * + */ export class GetBucketVersioningCommand extends $Command< GetBucketVersioningCommandInput, GetBucketVersioningCommandOutput, @@ -35,6 +62,9 @@ export class GetBucketVersioningCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetBucketWebsiteCommand.ts b/clients/client-s3/commands/GetBucketWebsiteCommand.ts index 9b0e0ed8cb05d..963ab3e6d1803 100644 --- a/clients/client-s3/commands/GetBucketWebsiteCommand.ts +++ b/clients/client-s3/commands/GetBucketWebsiteCommand.ts @@ -21,6 +21,29 @@ import { export type GetBucketWebsiteCommandInput = GetBucketWebsiteRequest; export type GetBucketWebsiteCommandOutput = GetBucketWebsiteOutput & __MetadataBearer; +/** + *

Returns the website configuration for a bucket. To host website on Amazon S3, you can + * configure a bucket as website by adding a website configuration. For more information about + * hosting websites, see Hosting Websites on + * Amazon S3.

+ *

This GET operation requires the S3:GetBucketWebsite permission. By default, + * only the bucket owner can read the bucket website configuration. However, bucket owners can + * allow other users to read the website configuration by writing a bucket policy granting + * them the S3:GetBucketWebsite permission.

+ *

The following operations are related to DeleteBucketWebsite:

+ * + */ export class GetBucketWebsiteCommand extends $Command< GetBucketWebsiteCommandInput, GetBucketWebsiteCommandOutput, @@ -35,6 +58,9 @@ export class GetBucketWebsiteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetObjectAclCommand.ts b/clients/client-s3/commands/GetObjectAclCommand.ts index ffae969b5a645..d9177a5f6464e 100644 --- a/clients/client-s3/commands/GetObjectAclCommand.ts +++ b/clients/client-s3/commands/GetObjectAclCommand.ts @@ -21,6 +21,35 @@ import { export type GetObjectAclCommandInput = GetObjectAclRequest; export type GetObjectAclCommandOutput = GetObjectAclOutput & __MetadataBearer; +/** + *

Returns the access control list (ACL) of an object. To use this operation, you must have + * READ_ACP access to the object.

+ *

This action is not supported by Amazon S3 on Outposts.

+ *

+ * Versioning + *

+ *

By default, GET returns ACL information about the current version of an object. To + * return ACL information about a different version, use the versionId subresource.

+ * + *

The following operations are related to GetObjectAcl:

+ * + */ export class GetObjectAclCommand extends $Command< GetObjectAclCommandInput, GetObjectAclCommandOutput, @@ -35,6 +64,9 @@ export class GetObjectAclCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetObjectCommand.ts b/clients/client-s3/commands/GetObjectCommand.ts index b5b95039e881d..020dcd691b462 100644 --- a/clients/client-s3/commands/GetObjectCommand.ts +++ b/clients/client-s3/commands/GetObjectCommand.ts @@ -19,6 +19,181 @@ import { export type GetObjectCommandInput = GetObjectRequest; export type GetObjectCommandOutput = GetObjectOutput & __MetadataBearer; +/** + *

Retrieves objects from Amazon S3. To use GET, you must have READ + * access to the object. If you grant READ access to the anonymous user, you can + * return the object without using an authorization header.

+ * + *

An Amazon S3 bucket has no directory hierarchy such as you would find in a typical computer + * file system. You can, however, create a logical hierarchy by using object key names that + * imply a folder structure. For example, instead of naming an object sample.jpg, + * you can name it photos/2006/February/sample.jpg.

+ * + *

To get an object from such a logical hierarchy, specify the full key name for the object + * in the GET operation. For a virtual hosted-style request example, if you have + * the object photos/2006/February/sample.jpg, specify the resource as + * /photos/2006/February/sample.jpg. For a path-style request example, if you + * have the object photos/2006/February/sample.jpg in the bucket named + * examplebucket, specify the resource as + * /examplebucket/photos/2006/February/sample.jpg. For more information about + * request types, see HTTP Host Header Bucket Specification.

+ * + *

To distribute large files to many people, you can save bandwidth costs by using + * BitTorrent. For more information, see Amazon S3 + * Torrent. For more information about returning the ACL of an object, see GetObjectAcl.

+ * + *

If the object you are retrieving is stored in the S3 Glacier, S3 Glacier Deep Archive, + * S3 Intelligent-Tiering Archive, or S3 Intelligent-Tiering Deep Archive storage classes, before you can retrieve + * the object you must first restore a copy using RestoreObject. Otherwise, this + * operation returns an InvalidObjectStateError error. For information about + * restoring archived objects, see Restoring + * Archived Objects.

+ * + *

Encryption request headers, like x-amz-server-side-encryption, should not + * be sent for GET requests if your object uses server-side encryption with CMKs stored in AWS + * KMS (SSE-KMS) or server-side encryption with Amazon S3–managed encryption keys (SSE-S3). If your + * object does use these types of keys, you’ll get an HTTP 400 BadRequest error.

+ *

If you encrypt an object by using server-side encryption with customer-provided + * encryption keys (SSE-C) when you store the object in Amazon S3, then when you GET the object, + * you must use the following headers:

+ *
    + *
  • + *

    x-amz-server-side-encryption-customer-algorithm

    + *
  • + *
  • + *

    x-amz-server-side-encryption-customer-key

    + *
  • + *
  • + *

    x-amz-server-side-encryption-customer-key-MD5

    + *
  • + *
+ *

For more information about SSE-C, see Server-Side Encryption (Using + * Customer-Provided Encryption Keys).

+ * + *

Assuming you have permission to read object tags (permission for the + * s3:GetObjectVersionTagging action), the response also returns the + * x-amz-tagging-count header that provides the count of number of tags + * associated with the object. You can use GetObjectTagging to retrieve + * the tag set associated with an object.

+ * + *

+ * Permissions + *

+ *

You need the s3:GetObject permission for this operation. For more + * information, see Specifying Permissions + * in a Policy. If the object you request does not exist, the error Amazon S3 returns + * depends on whether you also have the s3:ListBucket permission.

+ *
    + *
  • + *

    If you have the s3:ListBucket permission on the bucket, Amazon S3 will + * return an HTTP status code 404 ("no such key") error.

    + *
  • + *
  • + *

    If you don’t have the s3:ListBucket permission, Amazon S3 will return an + * HTTP status code 403 ("access denied") error.

    + *
  • + *
+ * + * + *

+ * Versioning + *

+ *

By default, the GET operation returns the current version of an object. To return a + * different version, use the versionId subresource.

+ * + * + *

If the current version of the object is a delete marker, Amazon S3 behaves as if the + * object was deleted and includes x-amz-delete-marker: true in the + * response.

+ *
+ * + * + *

For more information about versioning, see PutBucketVersioning.

+ * + *

+ * Overriding Response Header Values + *

+ *

There are times when you want to override certain response header values in a GET + * response. For example, you might override the Content-Disposition response header value in + * your GET request.

+ * + *

You can override values for a set of response headers using the following query + * parameters. These response header values are sent only on a successful request, that is, + * when status code 200 OK is returned. The set of headers you can override using these + * parameters is a subset of the headers that Amazon S3 accepts when you create an object. The + * response headers that you can override for the GET response are Content-Type, + * Content-Language, Expires, Cache-Control, + * Content-Disposition, and Content-Encoding. To override these + * header values in the GET response, you use the following request parameters.

+ * + * + *

You must sign the request, either using an Authorization header or a presigned URL, + * when using these parameters. They cannot be used with an unsigned (anonymous) + * request.

+ *
+ *
    + *
  • + *

    + * response-content-type + *

    + *
  • + *
  • + *

    + * response-content-language + *

    + *
  • + *
  • + *

    + * response-expires + *

    + *
  • + *
  • + *

    + * response-cache-control + *

    + *
  • + *
  • + *

    + * response-content-disposition + *

    + *
  • + *
  • + *

    + * response-content-encoding + *

    + *
  • + *
+ * + *

+ * Additional Considerations about Request Headers + *

+ * + *

If both of the If-Match and If-Unmodified-Since headers are + * present in the request as follows: If-Match condition evaluates to + * true, and; If-Unmodified-Since condition evaluates to + * false; then, S3 returns 200 OK and the data requested.

+ * + *

If both of the If-None-Match and If-Modified-Since headers are + * present in the request as follows: If-None-Match condition evaluates to + * false, and; If-Modified-Since condition evaluates to + * true; then, S3 returns 304 Not Modified response code.

+ * + *

For more information about conditional requests, see RFC 7232.

+ * + *

The following operations are related to GetObject:

+ * + */ export class GetObjectCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -29,6 +204,9 @@ export class GetObjectCommand extends $Command, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetObjectLegalHoldCommand.ts b/clients/client-s3/commands/GetObjectLegalHoldCommand.ts index 379e7bdd0bb03..090c55c2344a9 100644 --- a/clients/client-s3/commands/GetObjectLegalHoldCommand.ts +++ b/clients/client-s3/commands/GetObjectLegalHoldCommand.ts @@ -21,6 +21,10 @@ import { export type GetObjectLegalHoldCommandInput = GetObjectLegalHoldRequest; export type GetObjectLegalHoldCommandOutput = GetObjectLegalHoldOutput & __MetadataBearer; +/** + *

Gets an object's current Legal Hold status. For more information, see Locking Objects.

+ *

This action is not supported by Amazon S3 on Outposts.

+ */ export class GetObjectLegalHoldCommand extends $Command< GetObjectLegalHoldCommandInput, GetObjectLegalHoldCommandOutput, @@ -35,6 +39,9 @@ export class GetObjectLegalHoldCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetObjectLockConfigurationCommand.ts b/clients/client-s3/commands/GetObjectLockConfigurationCommand.ts index 056148b5169fa..d0ecc863b7fab 100644 --- a/clients/client-s3/commands/GetObjectLockConfigurationCommand.ts +++ b/clients/client-s3/commands/GetObjectLockConfigurationCommand.ts @@ -21,6 +21,12 @@ import { export type GetObjectLockConfigurationCommandInput = GetObjectLockConfigurationRequest; export type GetObjectLockConfigurationCommandOutput = GetObjectLockConfigurationOutput & __MetadataBearer; +/** + *

Gets the Object Lock configuration for a bucket. The rule specified in the Object Lock + * configuration will be applied by default to every new object placed in the specified + * bucket. For more information, see Locking + * Objects.

+ */ export class GetObjectLockConfigurationCommand extends $Command< GetObjectLockConfigurationCommandInput, GetObjectLockConfigurationCommandOutput, @@ -35,6 +41,9 @@ export class GetObjectLockConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetObjectRetentionCommand.ts b/clients/client-s3/commands/GetObjectRetentionCommand.ts index b36b0d57d4bae..345be0f9863ef 100644 --- a/clients/client-s3/commands/GetObjectRetentionCommand.ts +++ b/clients/client-s3/commands/GetObjectRetentionCommand.ts @@ -21,6 +21,10 @@ import { export type GetObjectRetentionCommandInput = GetObjectRetentionRequest; export type GetObjectRetentionCommandOutput = GetObjectRetentionOutput & __MetadataBearer; +/** + *

Retrieves an object's retention settings. For more information, see Locking Objects.

+ *

This action is not supported by Amazon S3 on Outposts.

+ */ export class GetObjectRetentionCommand extends $Command< GetObjectRetentionCommandInput, GetObjectRetentionCommandOutput, @@ -35,6 +39,9 @@ export class GetObjectRetentionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetObjectTaggingCommand.ts b/clients/client-s3/commands/GetObjectTaggingCommand.ts index af1d75e65ea0e..2237f76777a81 100644 --- a/clients/client-s3/commands/GetObjectTaggingCommand.ts +++ b/clients/client-s3/commands/GetObjectTaggingCommand.ts @@ -21,6 +21,31 @@ import { export type GetObjectTaggingCommandInput = GetObjectTaggingRequest; export type GetObjectTaggingCommandOutput = GetObjectTaggingOutput & __MetadataBearer; +/** + *

Returns the tag-set of an object. You send the GET request against the tagging + * subresource associated with the object.

+ * + *

To use this operation, you must have permission to perform the + * s3:GetObjectTagging action. By default, the GET operation returns + * information about current version of an object. For a versioned bucket, you can have + * multiple versions of an object in your bucket. To retrieve tags of any other version, use + * the versionId query parameter. You also need permission for the + * s3:GetObjectVersionTagging action.

+ * + *

By default, the bucket owner has this permission and can grant this permission to + * others.

+ * + *

For information about the Amazon S3 object tagging feature, see Object Tagging.

+ * + *

The following operation is related to GetObjectTagging:

+ * + */ export class GetObjectTaggingCommand extends $Command< GetObjectTaggingCommandInput, GetObjectTaggingCommandOutput, @@ -35,6 +60,9 @@ export class GetObjectTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetObjectTorrentCommand.ts b/clients/client-s3/commands/GetObjectTorrentCommand.ts index 5d5868aae57dc..a33d6bd3c3a50 100644 --- a/clients/client-s3/commands/GetObjectTorrentCommand.ts +++ b/clients/client-s3/commands/GetObjectTorrentCommand.ts @@ -21,6 +21,25 @@ import { export type GetObjectTorrentCommandInput = GetObjectTorrentRequest; export type GetObjectTorrentCommandOutput = GetObjectTorrentOutput & __MetadataBearer; +/** + *

Returns torrent files from a bucket. BitTorrent can save you bandwidth when you're + * distributing large files. For more information about BitTorrent, see Using BitTorrent with Amazon S3.

+ * + *

You can get torrent only for objects that are less than 5 GB in size, and that are + * not encrypted using server-side encryption with a customer-provided encryption + * key.

+ *
+ *

To use GET, you must have READ access to the object.

+ *

This action is not supported by Amazon S3 on Outposts.

+ *

The following operation is related to GetObjectTorrent:

+ * + */ export class GetObjectTorrentCommand extends $Command< GetObjectTorrentCommandInput, GetObjectTorrentCommandOutput, @@ -35,6 +54,9 @@ export class GetObjectTorrentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/GetPublicAccessBlockCommand.ts b/clients/client-s3/commands/GetPublicAccessBlockCommand.ts index 7d0a0c0a99fa9..c80287e41ef73 100644 --- a/clients/client-s3/commands/GetPublicAccessBlockCommand.ts +++ b/clients/client-s3/commands/GetPublicAccessBlockCommand.ts @@ -21,6 +21,48 @@ import { export type GetPublicAccessBlockCommandInput = GetPublicAccessBlockRequest; export type GetPublicAccessBlockCommandOutput = GetPublicAccessBlockOutput & __MetadataBearer; +/** + *

Retrieves the PublicAccessBlock configuration for an Amazon S3 bucket. To use + * this operation, you must have the s3:GetBucketPublicAccessBlock permission. + * For more information about Amazon S3 permissions, see Specifying Permissions in a + * Policy.

+ * + * + *

When Amazon S3 evaluates the PublicAccessBlock configuration for a bucket or + * an object, it checks the PublicAccessBlock configuration for both the + * bucket (or the bucket that contains the object) and the bucket owner's account. If the + * PublicAccessBlock settings are different between the bucket and the + * account, Amazon S3 uses the most restrictive combination of the bucket-level and + * account-level settings.

+ *
+ * + *

For more information about when Amazon S3 considers a bucket or an object public, see The Meaning of "Public".

+ * + *

The following operations are related to GetPublicAccessBlock:

+ * + */ export class GetPublicAccessBlockCommand extends $Command< GetPublicAccessBlockCommandInput, GetPublicAccessBlockCommandOutput, @@ -35,6 +77,9 @@ export class GetPublicAccessBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/HeadBucketCommand.ts b/clients/client-s3/commands/HeadBucketCommand.ts index 4cebcb618c63e..f524b6e7d44b7 100644 --- a/clients/client-s3/commands/HeadBucketCommand.ts +++ b/clients/client-s3/commands/HeadBucketCommand.ts @@ -21,6 +21,17 @@ import { export type HeadBucketCommandInput = HeadBucketRequest; export type HeadBucketCommandOutput = __MetadataBearer; +/** + *

This operation is useful to determine if a bucket exists and you have permission to + * access it. The operation returns a 200 OK if the bucket exists and you have + * permission to access it. Otherwise, the operation might return responses such as 404 + * Not Found and 403 Forbidden.

+ * + *

To use this operation, you must have permissions to perform the + * s3:ListBucket action. The bucket owner has this permission by default and + * can grant this permission to others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ */ export class HeadBucketCommand extends $Command< HeadBucketCommandInput, HeadBucketCommandOutput, @@ -35,6 +46,9 @@ export class HeadBucketCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/HeadObjectCommand.ts b/clients/client-s3/commands/HeadObjectCommand.ts index c47817407cd57..e8cd26bd6cd77 100644 --- a/clients/client-s3/commands/HeadObjectCommand.ts +++ b/clients/client-s3/commands/HeadObjectCommand.ts @@ -22,6 +22,115 @@ import { export type HeadObjectCommandInput = HeadObjectRequest; export type HeadObjectCommandOutput = HeadObjectOutput & __MetadataBearer; +/** + *

The HEAD operation retrieves metadata from an object without returning the object + * itself. This operation is useful if you're only interested in an object's metadata. To use + * HEAD, you must have READ access to the object.

+ * + *

A HEAD request has the same options as a GET operation on an + * object. The response is identical to the GET response except that there is no + * response body.

+ * + *

If you encrypt an object by using server-side encryption with customer-provided + * encryption keys (SSE-C) when you store the object in Amazon S3, then when you retrieve the + * metadata from the object, you must use the following headers:

+ *
    + *
  • + *

    x-amz-server-side-encryption-customer-algorithm

    + *
  • + *
  • + *

    x-amz-server-side-encryption-customer-key

    + *
  • + *
  • + *

    x-amz-server-side-encryption-customer-key-MD5

    + *
  • + *
+ *

For more information about SSE-C, see Server-Side Encryption (Using + * Customer-Provided Encryption Keys).

+ * + *

Encryption request headers, like x-amz-server-side-encryption, should + * not be sent for GET requests if your object uses server-side encryption with CMKs stored + * in AWS KMS (SSE-KMS) or server-side encryption with Amazon S3–managed encryption keys + * (SSE-S3). If your object does use these types of keys, you’ll get an HTTP 400 BadRequest + * error.

+ *
+ * + * + * + * + * + * + * + *

Request headers are limited to 8 KB in size. For more information, see Common Request + * Headers.

+ *

Consider the following when using request headers:

+ *
    + *
  • + *

    Consideration 1 – If both of the If-Match and + * If-Unmodified-Since headers are present in the request as + * follows:

    + *
      + *
    • + *

      + * If-Match condition evaluates to true, and;

      + *
    • + *
    • + *

      + * If-Unmodified-Since condition evaluates to + * false;

      + *
    • + *
    + *

    Then Amazon S3 returns 200 OK and the data requested.

    + *
  • + *
  • + *

    Consideration 2 – If both of the If-None-Match and + * If-Modified-Since headers are present in the request as + * follows:

    + *
      + *
    • + *

      + * If-None-Match condition evaluates to false, + * and;

      + *
    • + *
    • + *

      + * If-Modified-Since condition evaluates to + * true;

      + *
    • + *
    + *

    Then Amazon S3 returns the 304 Not Modified response code.

    + *
  • + *
+ * + *

For more information about conditional requests, see RFC 7232.

+ * + *

+ * Permissions + *

+ *

You need the s3:GetObject permission for this operation. For more + * information, see Specifying Permissions + * in a Policy. If the object you request does not exist, the error Amazon S3 returns + * depends on whether you also have the s3:ListBucket permission.

+ *
    + *
  • + *

    If you have the s3:ListBucket permission on the bucket, Amazon S3 returns + * an HTTP status code 404 ("no such key") error.

    + *
  • + *
  • + *

    If you don’t have the s3:ListBucket permission, Amazon S3 returns an HTTP + * status code 403 ("access denied") error.

    + *
  • + *
+ * + *

The following operation is related to HeadObject:

+ * + */ export class HeadObjectCommand extends $Command< HeadObjectCommandInput, HeadObjectCommandOutput, @@ -36,6 +145,9 @@ export class HeadObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListBucketAnalyticsConfigurationsCommand.ts b/clients/client-s3/commands/ListBucketAnalyticsConfigurationsCommand.ts index b330ee1c2f64a..1428c48a60cf7 100644 --- a/clients/client-s3/commands/ListBucketAnalyticsConfigurationsCommand.ts +++ b/clients/client-s3/commands/ListBucketAnalyticsConfigurationsCommand.ts @@ -21,6 +21,48 @@ import { export type ListBucketAnalyticsConfigurationsCommandInput = ListBucketAnalyticsConfigurationsRequest; export type ListBucketAnalyticsConfigurationsCommandOutput = ListBucketAnalyticsConfigurationsOutput & __MetadataBearer; +/** + *

Lists the analytics configurations for the bucket. You can have up to 1,000 analytics + * configurations per bucket.

+ * + *

This operation supports list pagination and does not return more than 100 configurations + * at a time. You should always check the IsTruncated element in the response. If + * there are no more configurations to list, IsTruncated is set to false. If + * there are more configurations to list, IsTruncated is set to true, and there + * will be a value in NextContinuationToken. You use the + * NextContinuationToken value to continue the pagination of the list by + * passing the value in continuation-token in the request to GET the next + * page.

+ * + *

To use this operation, you must have permissions to perform the + * s3:GetAnalyticsConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

For information about Amazon S3 analytics feature, see Amazon S3 Analytics – Storage Class + * Analysis.

+ * + *

The following operations are related to + * ListBucketAnalyticsConfigurations:

+ * + */ export class ListBucketAnalyticsConfigurationsCommand extends $Command< ListBucketAnalyticsConfigurationsCommandInput, ListBucketAnalyticsConfigurationsCommandOutput, @@ -35,6 +77,9 @@ export class ListBucketAnalyticsConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListBucketIntelligentTieringConfigurationsCommand.ts b/clients/client-s3/commands/ListBucketIntelligentTieringConfigurationsCommand.ts index f7c0a1ab3572e..a0a069d5fd4f5 100644 --- a/clients/client-s3/commands/ListBucketIntelligentTieringConfigurationsCommand.ts +++ b/clients/client-s3/commands/ListBucketIntelligentTieringConfigurationsCommand.ts @@ -25,6 +25,31 @@ export type ListBucketIntelligentTieringConfigurationsCommandInput = ListBucketI export type ListBucketIntelligentTieringConfigurationsCommandOutput = ListBucketIntelligentTieringConfigurationsOutput & __MetadataBearer; +/** + *

Lists the S3 Intelligent-Tiering configuration from the specified bucket.

+ *

The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without additional operational overhead. S3 Intelligent-Tiering delivers automatic cost savings by moving data between access tiers, when access patterns change.

+ *

The S3 Intelligent-Tiering storage class is suitable for objects larger than 128 KB that you plan to store for at least 30 days. If the size of an object is less than 128 KB, it is not eligible for auto-tiering. Smaller objects can be stored, but they are always charged at the frequent access tier rates in the S3 Intelligent-Tiering storage class.

+ *

If you delete an object before the end of the 30-day minimum storage duration period, you are charged for 30 days. For more information, see Storage class for automatically optimizing frequently and infrequently accessed objects.

+ *

Operations related to + * ListBucketIntelligentTieringConfigurations include:

+ * + */ export class ListBucketIntelligentTieringConfigurationsCommand extends $Command< ListBucketIntelligentTieringConfigurationsCommandInput, ListBucketIntelligentTieringConfigurationsCommandOutput, @@ -39,6 +64,9 @@ export class ListBucketIntelligentTieringConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListBucketInventoryConfigurationsCommand.ts b/clients/client-s3/commands/ListBucketInventoryConfigurationsCommand.ts index 05838bc54b344..db794cbd1ddb6 100644 --- a/clients/client-s3/commands/ListBucketInventoryConfigurationsCommand.ts +++ b/clients/client-s3/commands/ListBucketInventoryConfigurationsCommand.ts @@ -21,6 +21,47 @@ import { export type ListBucketInventoryConfigurationsCommandInput = ListBucketInventoryConfigurationsRequest; export type ListBucketInventoryConfigurationsCommandOutput = ListBucketInventoryConfigurationsOutput & __MetadataBearer; +/** + *

Returns a list of inventory configurations for the bucket. You can have up to 1,000 + * analytics configurations per bucket.

+ * + *

This operation supports list pagination and does not return more than 100 configurations + * at a time. Always check the IsTruncated element in the response. If there are + * no more configurations to list, IsTruncated is set to false. If there are more + * configurations to list, IsTruncated is set to true, and there is a value in + * NextContinuationToken. You use the NextContinuationToken value + * to continue the pagination of the list by passing the value in continuation-token in the + * request to GET the next page.

+ * + *

To use this operation, you must have permissions to perform the + * s3:GetInventoryConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

For information about the Amazon S3 inventory feature, see Amazon S3 Inventory + *

+ * + *

The following operations are related to + * ListBucketInventoryConfigurations:

+ * + */ export class ListBucketInventoryConfigurationsCommand extends $Command< ListBucketInventoryConfigurationsCommandInput, ListBucketInventoryConfigurationsCommandOutput, @@ -35,6 +76,9 @@ export class ListBucketInventoryConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListBucketMetricsConfigurationsCommand.ts b/clients/client-s3/commands/ListBucketMetricsConfigurationsCommand.ts index 508b40147b7e8..bf94f5c7b294e 100644 --- a/clients/client-s3/commands/ListBucketMetricsConfigurationsCommand.ts +++ b/clients/client-s3/commands/ListBucketMetricsConfigurationsCommand.ts @@ -21,6 +21,49 @@ import { export type ListBucketMetricsConfigurationsCommandInput = ListBucketMetricsConfigurationsRequest; export type ListBucketMetricsConfigurationsCommandOutput = ListBucketMetricsConfigurationsOutput & __MetadataBearer; +/** + *

Lists the metrics configurations for the bucket. The metrics configurations are only for + * the request metrics of the bucket and do not provide information on daily storage metrics. + * You can have up to 1,000 configurations per bucket.

+ * + *

This operation supports list pagination and does not return more than 100 configurations + * at a time. Always check the IsTruncated element in the response. If there are + * no more configurations to list, IsTruncated is set to false. If there are more + * configurations to list, IsTruncated is set to true, and there is a value in + * NextContinuationToken. You use the NextContinuationToken value + * to continue the pagination of the list by passing the value in + * continuation-token in the request to GET the next page.

+ * + *

To use this operation, you must have permissions to perform the + * s3:GetMetricsConfiguration action. The bucket owner has this permission by + * default. The bucket owner can grant this permission to others. For more information about + * permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

For more information about metrics configurations and CloudWatch request metrics, see + * Monitoring Metrics with Amazon + * CloudWatch.

+ * + *

The following operations are related to + * ListBucketMetricsConfigurations:

+ * + */ export class ListBucketMetricsConfigurationsCommand extends $Command< ListBucketMetricsConfigurationsCommandInput, ListBucketMetricsConfigurationsCommandOutput, @@ -35,6 +78,9 @@ export class ListBucketMetricsConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListBucketsCommand.ts b/clients/client-s3/commands/ListBucketsCommand.ts index 0e2f4ea2a5e13..528b542fe984c 100644 --- a/clients/client-s3/commands/ListBucketsCommand.ts +++ b/clients/client-s3/commands/ListBucketsCommand.ts @@ -20,6 +20,9 @@ import { export type ListBucketsCommandInput = {}; export type ListBucketsCommandOutput = ListBucketsOutput & __MetadataBearer; +/** + *

Returns a list of all buckets owned by the authenticated sender of the request.

+ */ export class ListBucketsCommand extends $Command< ListBucketsCommandInput, ListBucketsCommandOutput, @@ -34,6 +37,9 @@ export class ListBucketsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListMultipartUploadsCommand.ts b/clients/client-s3/commands/ListMultipartUploadsCommand.ts index 89a6cbb792097..6c48531698e62 100644 --- a/clients/client-s3/commands/ListMultipartUploadsCommand.ts +++ b/clients/client-s3/commands/ListMultipartUploadsCommand.ts @@ -21,6 +21,59 @@ import { export type ListMultipartUploadsCommandInput = ListMultipartUploadsRequest; export type ListMultipartUploadsCommandOutput = ListMultipartUploadsOutput & __MetadataBearer; +/** + *

This operation lists in-progress multipart uploads. An in-progress multipart upload is a + * multipart upload that has been initiated using the Initiate Multipart Upload request, but + * has not yet been completed or aborted.

+ * + *

This operation returns at most 1,000 multipart uploads in the response. 1,000 multipart + * uploads is the maximum number of uploads a response can include, which is also the default + * value. You can further limit the number of uploads in a response by specifying the + * max-uploads parameter in the response. If additional multipart uploads + * satisfy the list criteria, the response will contain an IsTruncated element + * with the value true. To list the additional multipart uploads, use the + * key-marker and upload-id-marker request parameters.

+ * + *

In the response, the uploads are sorted by key. If your application has initiated more + * than one multipart upload using the same object key, then uploads in the response are first + * sorted by key. Additionally, uploads are sorted in ascending order within each key by the + * upload initiation time.

+ * + *

For more information on multipart uploads, see Uploading Objects Using Multipart + * Upload.

+ * + *

For information on permissions required to use the multipart upload API, see Multipart Upload API and + * Permissions.

+ * + *

The following operations are related to ListMultipartUploads:

+ * + */ export class ListMultipartUploadsCommand extends $Command< ListMultipartUploadsCommandInput, ListMultipartUploadsCommandOutput, @@ -35,6 +88,9 @@ export class ListMultipartUploadsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListObjectVersionsCommand.ts b/clients/client-s3/commands/ListObjectVersionsCommand.ts index 1c18ca83d1b38..2daae3cef5401 100644 --- a/clients/client-s3/commands/ListObjectVersionsCommand.ts +++ b/clients/client-s3/commands/ListObjectVersionsCommand.ts @@ -21,6 +21,41 @@ import { export type ListObjectVersionsCommandInput = ListObjectVersionsRequest; export type ListObjectVersionsCommandOutput = ListObjectVersionsOutput & __MetadataBearer; +/** + *

Returns metadata about all versions of the objects in a bucket. You can also use request + * parameters as selection criteria to return metadata about a subset of all the object + * versions.

+ * + *

A 200 OK response can contain valid or invalid XML. Make sure to design your + * application to parse the contents of the response and handle it appropriately.

+ *
+ *

To use this operation, you must have READ access to the bucket.

+ *

This action is not supported by Amazon S3 on Outposts.

+ *

The following operations are related to + * ListObjectVersions:

+ * + */ export class ListObjectVersionsCommand extends $Command< ListObjectVersionsCommandInput, ListObjectVersionsCommandOutput, @@ -35,6 +70,9 @@ export class ListObjectVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListObjectsCommand.ts b/clients/client-s3/commands/ListObjectsCommand.ts index 0e45def72dfdf..d13d91a484897 100644 --- a/clients/client-s3/commands/ListObjectsCommand.ts +++ b/clients/client-s3/commands/ListObjectsCommand.ts @@ -21,6 +21,46 @@ import { export type ListObjectsCommandInput = ListObjectsRequest; export type ListObjectsCommandOutput = ListObjectsOutput & __MetadataBearer; +/** + *

Returns some or all (up to 1,000) of the objects in a bucket. You can use the request + * parameters as selection criteria to return a subset of the objects in a bucket. A 200 OK + * response can contain valid or invalid XML. Be sure to design your application to parse the + * contents of the response and handle it appropriately.

+ * + *

This API has been revised. We recommend that you use the newer version, ListObjectsV2, when developing applications. For backward compatibility, + * Amazon S3 continues to support ListObjects.

+ *
+ * + * + *

The following operations are related to ListObjects:

+ * + */ export class ListObjectsCommand extends $Command< ListObjectsCommandInput, ListObjectsCommandOutput, @@ -35,6 +75,9 @@ export class ListObjectsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListObjectsV2Command.ts b/clients/client-s3/commands/ListObjectsV2Command.ts index 48721790153f7..c522d299dc6bd 100644 --- a/clients/client-s3/commands/ListObjectsV2Command.ts +++ b/clients/client-s3/commands/ListObjectsV2Command.ts @@ -21,6 +21,46 @@ import { export type ListObjectsV2CommandInput = ListObjectsV2Request; export type ListObjectsV2CommandOutput = ListObjectsV2Output & __MetadataBearer; +/** + *

Returns some or all (up to 1,000) of the objects in a bucket. You can use the request + * parameters as selection criteria to return a subset of the objects in a bucket. A 200 + * OK response can contain valid or invalid XML. Make sure to design your + * application to parse the contents of the response and handle it appropriately.

+ * + *

To use this operation, you must have READ access to the bucket.

+ * + *

To use this operation in an AWS Identity and Access Management (IAM) policy, you must + * have permissions to perform the s3:ListBucket action. The bucket owner has + * this permission by default and can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

This section describes the latest revision of the API. We recommend that you use this + * revised API for application development. For backward compatibility, Amazon S3 continues to + * support the prior version of this API, ListObjects.

+ *
+ * + *

To get a list of your buckets, see ListBuckets.

+ * + *

The following operations are related to ListObjectsV2:

+ * + */ export class ListObjectsV2Command extends $Command< ListObjectsV2CommandInput, ListObjectsV2CommandOutput, @@ -35,6 +75,9 @@ export class ListObjectsV2Command extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/ListPartsCommand.ts b/clients/client-s3/commands/ListPartsCommand.ts index f26cf1ea7c219..adf1087509072 100644 --- a/clients/client-s3/commands/ListPartsCommand.ts +++ b/clients/client-s3/commands/ListPartsCommand.ts @@ -18,6 +18,53 @@ import { export type ListPartsCommandInput = ListPartsRequest; export type ListPartsCommandOutput = ListPartsOutput & __MetadataBearer; +/** + *

Lists the parts that have been uploaded for a specific multipart upload. This operation + * must include the upload ID, which you obtain by sending the initiate multipart upload + * request (see CreateMultipartUpload). + * This request returns a maximum of 1,000 uploaded parts. The default number of parts + * returned is 1,000 parts. You can restrict the number of parts returned by specifying the + * max-parts request parameter. If your multipart upload consists of more than + * 1,000 parts, the response returns an IsTruncated field with the value of true, + * and a NextPartNumberMarker element. In subsequent ListParts + * requests you can include the part-number-marker query string parameter and set its value to + * the NextPartNumberMarker field value from the previous response.

+ * + *

For more information on multipart uploads, see Uploading Objects Using Multipart + * Upload.

+ * + *

For information on permissions required to use the multipart upload API, see Multipart Upload API and + * Permissions.

+ * + *

The following operations are related to ListParts:

+ * + */ export class ListPartsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -28,6 +75,9 @@ export class ListPartsCommand extends $Command, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketAccelerateConfigurationCommand.ts b/clients/client-s3/commands/PutBucketAccelerateConfigurationCommand.ts index 7fe6c8d03e015..5c4d7dfaf8b66 100644 --- a/clients/client-s3/commands/PutBucketAccelerateConfigurationCommand.ts +++ b/clients/client-s3/commands/PutBucketAccelerateConfigurationCommand.ts @@ -21,6 +21,54 @@ import { export type PutBucketAccelerateConfigurationCommandInput = PutBucketAccelerateConfigurationRequest; export type PutBucketAccelerateConfigurationCommandOutput = __MetadataBearer; +/** + *

Sets the accelerate configuration of an existing bucket. Amazon S3 Transfer Acceleration is a + * bucket-level feature that enables you to perform faster data transfers to Amazon S3.

+ * + *

To use this operation, you must have permission to perform the + * s3:PutAccelerateConfiguration action. The bucket owner has this permission by default. The + * bucket owner can grant this permission to others. For more information about permissions, + * see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

The Transfer Acceleration state of a bucket can be set to one of the following two + * values:

+ *
    + *
  • + *

    Enabled – Enables accelerated data transfers to the bucket.

    + *
  • + *
  • + *

    Suspended – Disables accelerated data transfers to the bucket.

    + *
  • + *
+ * + * + *

The GetBucketAccelerateConfiguration operation returns the transfer acceleration + * state of a bucket.

+ * + *

After setting the Transfer Acceleration state of a bucket to Enabled, it might take up + * to thirty minutes before the data transfer rates to the bucket increase.

+ * + *

The name of the bucket used for Transfer Acceleration must be DNS-compliant and must + * not contain periods (".").

+ * + *

For more information about transfer acceleration, see Transfer Acceleration.

+ * + *

The following operations are related to + * PutBucketAccelerateConfiguration:

+ * + */ export class PutBucketAccelerateConfigurationCommand extends $Command< PutBucketAccelerateConfigurationCommandInput, PutBucketAccelerateConfigurationCommandOutput, @@ -35,6 +83,9 @@ export class PutBucketAccelerateConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketAclCommand.ts b/clients/client-s3/commands/PutBucketAclCommand.ts index 360ca7b970f40..12c688c3b3929 100644 --- a/clients/client-s3/commands/PutBucketAclCommand.ts +++ b/clients/client-s3/commands/PutBucketAclCommand.ts @@ -21,6 +21,199 @@ import { export type PutBucketAclCommandInput = PutBucketAclRequest; export type PutBucketAclCommandOutput = __MetadataBearer; +/** + *

Sets the permissions on an existing bucket using access control lists (ACL). For more + * information, see Using ACLs. To set + * the ACL of a bucket, you must have WRITE_ACP permission.

+ * + *

You can use one of the following two ways to set a bucket's permissions:

+ *
    + *
  • + *

    Specify the ACL in the request body

    + *
  • + *
  • + *

    Specify permissions using request headers

    + *
  • + *
+ * + * + *

You cannot specify access permission using both the body and the request + * headers.

+ *
+ * + *

Depending on your application needs, you may choose to set the ACL on a bucket using + * either the request body or the headers. For example, if you have an existing application + * that updates a bucket ACL using the request body, then you can continue to use that + * approach.

+ * + * + *

+ * Access Permissions + *

+ *

You can set access permissions using one of the following methods:

+ *
    + *
  • + *

    Specify a canned ACL with the x-amz-acl request header. Amazon S3 supports + * a set of predefined ACLs, known as canned ACLs. Each canned ACL + * has a predefined set of grantees and permissions. Specify the canned ACL name as the + * value of x-amz-acl. If you use this header, you cannot use other access + * control-specific headers in your request. For more information, see Canned ACL.

    + *
  • + *
  • + *

    Specify access permissions explicitly with the x-amz-grant-read, + * x-amz-grant-read-acp, x-amz-grant-write-acp, and + * x-amz-grant-full-control headers. When using these headers, you + * specify explicit access permissions and grantees (AWS accounts or Amazon S3 groups) who + * will receive the permission. If you use these ACL-specific headers, you cannot use + * the x-amz-acl header to set a canned ACL. These parameters map to the + * set of permissions that Amazon S3 supports in an ACL. For more information, see Access Control List (ACL) + * Overview.

    + *

    You specify each grantee as a type=value pair, where the type is one of the + * following:

    + *
      + *
    • + *

      + * id – if the value specified is the canonical user ID of an AWS + * account

      + *
    • + *
    • + *

      + * uri – if you are granting permissions to a predefined + * group

      + *
    • + *
    • + *

      + * emailAddress – if the value specified is the email address of + * an AWS account

      + * + *

      Using email addresses to specify a grantee is only supported in the following AWS Regions:

      + *
        + *
      • + *

        US East (N. Virginia)

        + *
      • + *
      • + *

        US West (N. California)

        + *
      • + *
      • + *

        US West (Oregon)

        + *
      • + *
      • + *

        Asia Pacific (Singapore)

        + *
      • + *
      • + *

        Asia Pacific (Sydney)

        + *
      • + *
      • + *

        Asia Pacific (Tokyo)

        + *
      • + *
      • + *

        Europe (Ireland)

        + *
      • + *
      • + *

        South America (São Paulo)

        + *
      • + *
      + *

      For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints in the AWS General Reference.

      + *
      + *
    • + *
    + *

    For example, the following x-amz-grant-write header grants create, + * overwrite, and delete objects permission to LogDelivery group predefined by Amazon S3 and + * two AWS accounts identified by their email addresses.

    + *

    + * x-amz-grant-write: uri="http://acs.amazonaws.com/groups/s3/LogDelivery", + * id="111122223333", id="555566667777" + *

    + * + *
  • + *
+ *

You can use either a canned ACL or specify access permissions explicitly. You cannot do + * both.

+ *

+ * Grantee Values + *

+ *

You can specify the person (grantee) to whom you're assigning access rights (using + * request elements) in the following ways:

+ *
    + *
  • + *

    By the person's ID:

    + *

    + * <>ID<><>GranteesEmail<> + * + *

    + *

    DisplayName is optional and ignored in the request

    + *
  • + *
  • + *

    By URI:

    + *

    + * <>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<> + *

    + *
  • + *
  • + *

    By Email address:

    + *

    + * <>Grantees@email.com<>lt;/Grantee> + *

    + *

    The grantee is resolved to the CanonicalUser and, in a response to a GET Object + * acl request, appears as the CanonicalUser.

    + * + *

    Using email addresses to specify a grantee is only supported in the following AWS Regions:

    + *
      + *
    • + *

      US East (N. Virginia)

      + *
    • + *
    • + *

      US West (N. California)

      + *
    • + *
    • + *

      US West (Oregon)

      + *
    • + *
    • + *

      Asia Pacific (Singapore)

      + *
    • + *
    • + *

      Asia Pacific (Sydney)

      + *
    • + *
    • + *

      Asia Pacific (Tokyo)

      + *
    • + *
    • + *

      Europe (Ireland)

      + *
    • + *
    • + *

      South America (São Paulo)

      + *
    • + *
    + *

    For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints in the AWS General Reference.

    + *
    + *
  • + *
+ * + * + *

+ * Related Resources + *

+ * + */ export class PutBucketAclCommand extends $Command< PutBucketAclCommandInput, PutBucketAclCommandOutput, @@ -35,6 +228,9 @@ export class PutBucketAclCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketAnalyticsConfigurationCommand.ts b/clients/client-s3/commands/PutBucketAnalyticsConfigurationCommand.ts index e565f8a1b0270..d9b72adec76a0 100644 --- a/clients/client-s3/commands/PutBucketAnalyticsConfigurationCommand.ts +++ b/clients/client-s3/commands/PutBucketAnalyticsConfigurationCommand.ts @@ -21,6 +21,124 @@ import { export type PutBucketAnalyticsConfigurationCommandInput = PutBucketAnalyticsConfigurationRequest; export type PutBucketAnalyticsConfigurationCommandOutput = __MetadataBearer; +/** + *

Sets an analytics configuration for the bucket (specified by the analytics configuration + * ID). You can have up to 1,000 analytics configurations per bucket.

+ * + *

You can choose to have storage class analysis export analysis reports sent to a + * comma-separated values (CSV) flat file. See the DataExport request element. + * Reports are updated daily and are based on the object filters that you configure. When + * selecting data export, you specify a destination bucket and an optional destination prefix + * where the file is written. You can export the data to a destination bucket in a different + * account. However, the destination bucket must be in the same Region as the bucket that you + * are making the PUT analytics configuration to. For more information, see Amazon S3 Analytics – Storage Class + * Analysis.

+ * + * + *

You must create a bucket policy on the destination bucket where the exported file is + * written to grant permissions to Amazon S3 to write objects to the bucket. For an example + * policy, see Granting Permissions for Amazon S3 Inventory and Storage Class Analysis.

+ *
+ * + *

To use this operation, you must have permissions to perform the + * s3:PutAnalyticsConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + * + *

+ * Special Errors + *

+ *
    + *
  • + *
      + *
    • + *

      + * HTTP Error: HTTP 400 Bad Request + *

      + *
    • + *
    • + *

      + * Code: InvalidArgument + *

      + *
    • + *
    • + *

      + * Cause: Invalid argument. + *

      + *
    • + *
    + *
  • + *
  • + *
      + *
    • + *

      + * HTTP Error: HTTP 400 Bad Request + *

      + *
    • + *
    • + *

      + * Code: TooManyConfigurations + *

      + *
    • + *
    • + *

      + * Cause: You are attempting to create a new configuration but have + * already reached the 1,000-configuration limit. + *

      + *
    • + *
    + *
  • + *
  • + *
      + *
    • + *

      + * HTTP Error: HTTP 403 Forbidden + *

      + *
    • + *
    • + *

      + * Code: AccessDenied + *

      + *
    • + *
    • + *

      + * Cause: You are not the owner of the specified bucket, or you do + * not have the s3:PutAnalyticsConfiguration bucket permission to set the + * configuration on the bucket. + *

      + *
    • + *
    + *
  • + *
+ * + * + * + * + * + * + *

+ * Related Resources + *

+ * + */ export class PutBucketAnalyticsConfigurationCommand extends $Command< PutBucketAnalyticsConfigurationCommandInput, PutBucketAnalyticsConfigurationCommandOutput, @@ -35,6 +153,9 @@ export class PutBucketAnalyticsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketCorsCommand.ts b/clients/client-s3/commands/PutBucketCorsCommand.ts index adf18622ba219..0176ce0a4e70d 100644 --- a/clients/client-s3/commands/PutBucketCorsCommand.ts +++ b/clients/client-s3/commands/PutBucketCorsCommand.ts @@ -22,6 +22,65 @@ import { export type PutBucketCorsCommandInput = PutBucketCorsRequest; export type PutBucketCorsCommandOutput = __MetadataBearer; +/** + *

Sets the cors configuration for your bucket. If the configuration exists, + * Amazon S3 replaces it.

+ *

To use this operation, you must be allowed to perform the s3:PutBucketCORS + * action. By default, the bucket owner has this permission and can grant it to others.

+ *

You set this configuration on a bucket so that the bucket can service cross-origin + * requests. For example, you might want to enable a request whose origin is + * http://www.example.com to access your Amazon S3 bucket at + * my.example.bucket.com by using the browser's XMLHttpRequest + * capability.

+ *

To enable cross-origin resource sharing (CORS) on a bucket, you add the + * cors subresource to the bucket. The cors subresource is an XML + * document in which you configure rules that identify origins and the HTTP methods that can + * be executed on your bucket. The document is limited to 64 KB in size.

+ *

When Amazon S3 receives a cross-origin request (or a pre-flight OPTIONS request) against a + * bucket, it evaluates the cors configuration on the bucket and uses the first + * CORSRule rule that matches the incoming browser request to enable a + * cross-origin request. For a rule to match, the following conditions must be met:

+ *
    + *
  • + *

    The request's Origin header must match AllowedOrigin + * elements.

    + *
  • + *
  • + *

    The request method (for example, GET, PUT, HEAD, and so on) or the + * Access-Control-Request-Method header in case of a pre-flight + * OPTIONS request must be one of the AllowedMethod + * elements.

    + *
  • + *
  • + *

    Every header specified in the Access-Control-Request-Headers request + * header of a pre-flight request must match an AllowedHeader element. + *

    + *
  • + *
+ *

For more information about CORS, go to Enabling + * Cross-Origin Resource Sharing in the Amazon Simple Storage Service Developer Guide.

+ * + *

+ * Related Resources + *

+ * + */ export class PutBucketCorsCommand extends $Command< PutBucketCorsCommandInput, PutBucketCorsCommandOutput, @@ -36,6 +95,9 @@ export class PutBucketCorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketEncryptionCommand.ts b/clients/client-s3/commands/PutBucketEncryptionCommand.ts index 89d6f56268e9c..e82b890158abc 100644 --- a/clients/client-s3/commands/PutBucketEncryptionCommand.ts +++ b/clients/client-s3/commands/PutBucketEncryptionCommand.ts @@ -21,6 +21,40 @@ import { export type PutBucketEncryptionCommandInput = PutBucketEncryptionRequest; export type PutBucketEncryptionCommandOutput = __MetadataBearer; +/** + *

This implementation of the PUT operation uses the encryption + * subresource to set the default encryption state of an existing bucket.

+ *

This implementation of the PUT operation sets default encryption for a + * bucket using server-side encryption with Amazon S3-managed keys SSE-S3 or AWS KMS customer + * master keys (CMKs) (SSE-KMS). For information about the Amazon S3 default encryption feature, + * see Amazon S3 Default Bucket + * Encryption.

+ * + *

This operation requires AWS Signature Version 4. For more information, see Authenticating Requests (AWS Signature + * Version 4).

+ *
+ *

To use this operation, you must have permissions to perform the + * s3:PutEncryptionConfiguration action. The bucket owner has this permission + * by default. The bucket owner can grant this permission to others. For more information + * about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources in the Amazon Simple Storage Service Developer Guide.

+ * + *

+ * Related Resources + *

+ * + */ export class PutBucketEncryptionCommand extends $Command< PutBucketEncryptionCommandInput, PutBucketEncryptionCommandOutput, @@ -35,6 +69,9 @@ export class PutBucketEncryptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketIntelligentTieringConfigurationCommand.ts b/clients/client-s3/commands/PutBucketIntelligentTieringConfigurationCommand.ts index 1045d9a4a1380..f85e086c01fa7 100644 --- a/clients/client-s3/commands/PutBucketIntelligentTieringConfigurationCommand.ts +++ b/clients/client-s3/commands/PutBucketIntelligentTieringConfigurationCommand.ts @@ -21,6 +21,31 @@ import { export type PutBucketIntelligentTieringConfigurationCommandInput = PutBucketIntelligentTieringConfigurationRequest; export type PutBucketIntelligentTieringConfigurationCommandOutput = __MetadataBearer; +/** + *

Puts a S3 Intelligent-Tiering configuration to the specified bucket.

+ *

The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without additional operational overhead. S3 Intelligent-Tiering delivers automatic cost savings by moving data between access tiers, when access patterns change.

+ *

The S3 Intelligent-Tiering storage class is suitable for objects larger than 128 KB that you plan to store for at least 30 days. If the size of an object is less than 128 KB, it is not eligible for auto-tiering. Smaller objects can be stored, but they are always charged at the frequent access tier rates in the S3 Intelligent-Tiering storage class.

+ *

If you delete an object before the end of the 30-day minimum storage duration period, you are charged for 30 days. For more information, see Storage class for automatically optimizing frequently and infrequently accessed objects.

+ *

Operations related to + * PutBucketIntelligentTieringConfiguration include:

+ * + */ export class PutBucketIntelligentTieringConfigurationCommand extends $Command< PutBucketIntelligentTieringConfigurationCommandInput, PutBucketIntelligentTieringConfigurationCommandOutput, @@ -35,6 +60,9 @@ export class PutBucketIntelligentTieringConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketInventoryConfigurationCommand.ts b/clients/client-s3/commands/PutBucketInventoryConfigurationCommand.ts index 39200fc73d6f3..a92b9af915a13 100644 --- a/clients/client-s3/commands/PutBucketInventoryConfigurationCommand.ts +++ b/clients/client-s3/commands/PutBucketInventoryConfigurationCommand.ts @@ -21,6 +21,109 @@ import { export type PutBucketInventoryConfigurationCommandInput = PutBucketInventoryConfigurationRequest; export type PutBucketInventoryConfigurationCommandOutput = __MetadataBearer; +/** + *

This implementation of the PUT operation adds an inventory configuration + * (identified by the inventory ID) to the bucket. You can have up to 1,000 inventory + * configurations per bucket.

+ *

Amazon S3 inventory generates inventories of the objects in the bucket on a daily or weekly + * basis, and the results are published to a flat file. The bucket that is inventoried is + * called the source bucket, and the bucket where the inventory flat file + * is stored is called the destination bucket. The + * destination bucket must be in the same AWS Region as the + * source bucket.

+ *

When you configure an inventory for a source bucket, you specify + * the destination bucket where you want the inventory to be stored, and + * whether to generate the inventory daily or weekly. You can also configure what object + * metadata to include and whether to inventory all object versions or only current versions. + * For more information, see Amazon S3 + * Inventory in the Amazon Simple Storage Service Developer Guide.

+ * + *

You must create a bucket policy on the destination bucket to + * grant permissions to Amazon S3 to write objects to the bucket in the defined location. For an + * example policy, see + * Granting Permissions for Amazon S3 Inventory and Storage Class Analysis.

+ *
+ *

To use this operation, you must have permissions to perform the + * s3:PutInventoryConfiguration action. The bucket owner has this permission + * by default and can grant this permission to others. For more information about permissions, + * see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources in the Amazon Simple Storage Service Developer Guide.

+ * + *

+ * Special Errors + *

+ *
    + *
  • + *

    + * HTTP 400 Bad Request Error + *

    + *
      + *
    • + *

      + * Code: InvalidArgument

      + *
    • + *
    • + *

      + * Cause: Invalid Argument

      + *
    • + *
    + *
  • + *
  • + *

    + * HTTP 400 Bad Request Error + *

    + *
      + *
    • + *

      + * Code: TooManyConfigurations

      + *
    • + *
    • + *

      + * Cause: You are attempting to create a new configuration + * but have already reached the 1,000-configuration limit.

      + *
    • + *
    + *
  • + *
  • + *

    + * HTTP 403 Forbidden Error + *

    + *
      + *
    • + *

      + * Code: AccessDenied

      + *
    • + *
    • + *

      + * Cause: You are not the owner of the specified bucket, + * or you do not have the s3:PutInventoryConfiguration bucket + * permission to set the configuration on the bucket.

      + *
    • + *
    + *
  • + *
+ * + *

+ * Related Resources + *

+ * + */ export class PutBucketInventoryConfigurationCommand extends $Command< PutBucketInventoryConfigurationCommandInput, PutBucketInventoryConfigurationCommandOutput, @@ -35,6 +138,9 @@ export class PutBucketInventoryConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketLifecycleConfigurationCommand.ts b/clients/client-s3/commands/PutBucketLifecycleConfigurationCommand.ts index 751e8f601441e..f4d4066b660b5 100644 --- a/clients/client-s3/commands/PutBucketLifecycleConfigurationCommand.ts +++ b/clients/client-s3/commands/PutBucketLifecycleConfigurationCommand.ts @@ -22,6 +22,101 @@ import { export type PutBucketLifecycleConfigurationCommandInput = PutBucketLifecycleConfigurationRequest; export type PutBucketLifecycleConfigurationCommandOutput = __MetadataBearer; +/** + *

Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle + * configuration. For information about lifecycle configuration, see Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + * + *

Bucket lifecycle configuration now supports specifying a lifecycle rule using an + * object key name prefix, one or more object tags, or a combination of both. Accordingly, + * this section describes the latest API. The previous version of the API supported + * filtering based only on an object key name prefix, which is supported for backward + * compatibility. For the related API description, see PutBucketLifecycle.

+ *
+ * + * + *

+ * Rules + *

+ *

You specify the lifecycle configuration in your request body. The lifecycle + * configuration is specified as XML consisting of one or more rules. Each rule consists of + * the following:

+ * + *
    + *
  • + *

    Filter identifying a subset of objects to which the rule applies. The filter can + * be based on a key name prefix, object tags, or a combination of both.

    + *
  • + *
  • + *

    Status whether the rule is in effect.

    + *
  • + *
  • + *

    One or more lifecycle transition and expiration actions that you want Amazon S3 to + * perform on the objects identified by the filter. If the state of your bucket is + * versioning-enabled or versioning-suspended, you can have many versions of the same + * object (one current version and zero or more noncurrent versions). Amazon S3 provides + * predefined actions that you can specify for current and noncurrent object + * versions.

    + *
  • + *
+ * + *

For more information, see Object + * Lifecycle Management and Lifecycle Configuration Elements.

+ * + * + *

+ * Permissions + *

+ * + * + *

By default, all Amazon S3 resources are private, including buckets, objects, and related + * subresources (for example, lifecycle configuration and website configuration). Only the + * resource owner (that is, the AWS account that created it) can access the resource. The + * resource owner can optionally grant access permissions to others by writing an access + * policy. For this operation, a user must get the s3:PutLifecycleConfiguration + * permission.

+ * + *

You can also explicitly deny permissions. Explicit deny also supersedes any other + * permissions. If you want to block users or accounts from removing or deleting objects from + * your bucket, you must deny them permissions for the following actions:

+ * + *
    + *
  • + *

    s3:DeleteObject

    + *
  • + *
  • + *

    s3:DeleteObjectVersion

    + *
  • + *
  • + *

    s3:PutLifecycleConfiguration

    + *
  • + *
+ * + * + *

For more information about permissions, see Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

The following are related to PutBucketLifecycleConfiguration:

+ * + */ export class PutBucketLifecycleConfigurationCommand extends $Command< PutBucketLifecycleConfigurationCommandInput, PutBucketLifecycleConfigurationCommandOutput, @@ -36,6 +131,9 @@ export class PutBucketLifecycleConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketLoggingCommand.ts b/clients/client-s3/commands/PutBucketLoggingCommand.ts index eb05e378ccaa5..4dc10d3ad64b2 100644 --- a/clients/client-s3/commands/PutBucketLoggingCommand.ts +++ b/clients/client-s3/commands/PutBucketLoggingCommand.ts @@ -21,6 +21,88 @@ import { export type PutBucketLoggingCommandInput = PutBucketLoggingRequest; export type PutBucketLoggingCommandOutput = __MetadataBearer; +/** + *

Set the logging parameters for a bucket and to specify permissions for who can view and + * modify the logging parameters. All logs are saved to buckets in the same AWS Region as the + * source bucket. To set the logging status of a bucket, you must be the bucket owner.

+ * + *

The bucket owner is automatically granted FULL_CONTROL to all logs. You use the + * Grantee request element to grant access to other people. The + * Permissions request element specifies the kind of access the grantee has to + * the logs.

+ * + *

+ * Grantee Values + *

+ *

You can specify the person (grantee) to whom you're assigning access rights (using + * request elements) in the following ways:

+ * + *
    + *
  • + *

    By the person's ID:

    + *

    + * <>ID<><>GranteesEmail<> + * + *

    + *

    DisplayName is optional and ignored in the request.

    + *
  • + *
  • + *

    By Email address:

    + *

    + * <>Grantees@email.com<> + *

    + *

    The grantee is resolved to the CanonicalUser and, in a response to a GET Object + * acl request, appears as the CanonicalUser.

    + *
  • + *
  • + *

    By URI:

    + *

    + * <>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<> + *

    + *
  • + *
+ * + * + *

To enable logging, you use LoggingEnabled and its children request elements. To disable + * logging, you use an empty BucketLoggingStatus request element:

+ * + *

+ * + *

+ * + *

For more information about server access logging, see Server Access Logging.

+ * + *

For more information about creating a bucket, see CreateBucket. For more + * information about returning the logging status of a bucket, see GetBucketLogging.

+ * + *

The following operations are related to PutBucketLogging:

+ * + */ export class PutBucketLoggingCommand extends $Command< PutBucketLoggingCommandInput, PutBucketLoggingCommandOutput, @@ -35,6 +117,9 @@ export class PutBucketLoggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketMetricsConfigurationCommand.ts b/clients/client-s3/commands/PutBucketMetricsConfigurationCommand.ts index 5baab5cd70aca..c48335b8a9e48 100644 --- a/clients/client-s3/commands/PutBucketMetricsConfigurationCommand.ts +++ b/clients/client-s3/commands/PutBucketMetricsConfigurationCommand.ts @@ -21,6 +21,64 @@ import { export type PutBucketMetricsConfigurationCommandInput = PutBucketMetricsConfigurationRequest; export type PutBucketMetricsConfigurationCommandOutput = __MetadataBearer; +/** + *

Sets a metrics configuration (specified by the metrics configuration ID) for the bucket. + * You can have up to 1,000 metrics configurations per bucket. If you're updating an existing + * metrics configuration, note that this is a full replacement of the existing metrics + * configuration. If you don't include the elements you want to keep, they are erased.

+ * + *

To use this operation, you must have permissions to perform the + * s3:PutMetricsConfiguration action. The bucket owner has this permission by + * default. The bucket owner can grant this permission to others. For more information about + * permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

For information about CloudWatch request metrics for Amazon S3, see Monitoring Metrics with Amazon + * CloudWatch.

+ * + *

The following operations are related to + * PutBucketMetricsConfiguration:

+ * + * + * + * + * + * + * + *

+ * GetBucketLifecycle has the following special error:

+ *
    + *
  • + *

    Error code: TooManyConfigurations + *

    + *
      + *
    • + *

      Description: You are attempting to create a new configuration but have + * already reached the 1,000-configuration limit.

      + *
    • + *
    • + *

      HTTP Status Code: HTTP 400 Bad Request

      + *
    • + *
    + *
  • + *
+ */ export class PutBucketMetricsConfigurationCommand extends $Command< PutBucketMetricsConfigurationCommandInput, PutBucketMetricsConfigurationCommandOutput, @@ -35,6 +93,9 @@ export class PutBucketMetricsConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketNotificationConfigurationCommand.ts b/clients/client-s3/commands/PutBucketNotificationConfigurationCommand.ts index c9f84974d0614..e23aea7184de8 100644 --- a/clients/client-s3/commands/PutBucketNotificationConfigurationCommand.ts +++ b/clients/client-s3/commands/PutBucketNotificationConfigurationCommand.ts @@ -21,6 +21,70 @@ import { export type PutBucketNotificationConfigurationCommandInput = PutBucketNotificationConfigurationRequest; export type PutBucketNotificationConfigurationCommandOutput = __MetadataBearer; +/** + *

Enables notifications of specified events for a bucket. For more information about event + * notifications, see Configuring Event + * Notifications.

+ * + *

Using this API, you can replace an existing notification configuration. The + * configuration is an XML file that defines the event types that you want Amazon S3 to publish and + * the destination where you want Amazon S3 to publish an event notification when it detects an + * event of the specified type.

+ * + *

By default, your bucket has no event notifications configured. That is, the notification + * configuration will be an empty NotificationConfiguration.

+ * + *

+ * + *

+ *

+ * + *

+ *

This operation replaces the existing notification configuration with the configuration + * you include in the request body.

+ * + *

After Amazon S3 receives this request, it first verifies that any Amazon Simple Notification + * Service (Amazon SNS) or Amazon Simple Queue Service (Amazon SQS) destination exists, and + * that the bucket owner has permission to publish to it by sending a test notification. In + * the case of AWS Lambda destinations, Amazon S3 verifies that the Lambda function permissions + * grant Amazon S3 permission to invoke the function from the Amazon S3 bucket. For more information, + * see Configuring Notifications for Amazon S3 + * Events.

+ * + *

You can disable notifications by adding the empty NotificationConfiguration + * element.

+ * + *

By default, only the bucket owner can configure notifications on a bucket. However, + * bucket owners can use a bucket policy to grant permission to other users to set this + * configuration with s3:PutBucketNotification permission.

+ * + * + *

The PUT notification is an atomic operation. For example, suppose your notification + * configuration includes SNS topic, SQS queue, and Lambda function configurations. When + * you send a PUT request with this configuration, Amazon S3 sends test messages to your SNS + * topic. If the message fails, the entire PUT operation will fail, and Amazon S3 will not add + * the configuration to your bucket.

+ *
+ * + *

+ * Responses + *

+ *

If the configuration in the request body includes only one + * TopicConfiguration specifying only the + * s3:ReducedRedundancyLostObject event type, the response will also include + * the x-amz-sns-test-message-id header containing the message ID of the test + * notification sent to the topic.

+ * + *

The following operation is related to + * PutBucketNotificationConfiguration:

+ * + */ export class PutBucketNotificationConfigurationCommand extends $Command< PutBucketNotificationConfigurationCommandInput, PutBucketNotificationConfigurationCommandOutput, @@ -35,6 +99,9 @@ export class PutBucketNotificationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketOwnershipControlsCommand.ts b/clients/client-s3/commands/PutBucketOwnershipControlsCommand.ts index 540d588812a7b..670f115d8e305 100644 --- a/clients/client-s3/commands/PutBucketOwnershipControlsCommand.ts +++ b/clients/client-s3/commands/PutBucketOwnershipControlsCommand.ts @@ -21,6 +21,25 @@ import { export type PutBucketOwnershipControlsCommandInput = PutBucketOwnershipControlsRequest; export type PutBucketOwnershipControlsCommandOutput = __MetadataBearer; +/** + *

Creates or modifies OwnershipControls for an Amazon S3 bucket. To use this + * operation, you must have the s3:PutBucketOwnershipControls permission. For + * more information about Amazon S3 permissions, see Specifying Permissions in a Policy.

+ *

For information about Amazon S3 Object Ownership, see Using Object Ownership.

+ *

The following operations are related to PutBucketOwnershipControls:

+ * + */ export class PutBucketOwnershipControlsCommand extends $Command< PutBucketOwnershipControlsCommandInput, PutBucketOwnershipControlsCommandOutput, @@ -35,6 +54,9 @@ export class PutBucketOwnershipControlsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketPolicyCommand.ts b/clients/client-s3/commands/PutBucketPolicyCommand.ts index c7f3478b8f76d..527358a326323 100644 --- a/clients/client-s3/commands/PutBucketPolicyCommand.ts +++ b/clients/client-s3/commands/PutBucketPolicyCommand.ts @@ -22,6 +22,41 @@ import { export type PutBucketPolicyCommandInput = PutBucketPolicyRequest; export type PutBucketPolicyCommandOutput = __MetadataBearer; +/** + *

Applies an Amazon S3 bucket policy to an Amazon S3 bucket. If you are using an identity other than + * the root user of the AWS account that owns the bucket, the calling identity must have the + * PutBucketPolicy permissions on the specified bucket and belong to the + * bucket owner's account in order to use this operation.

+ * + *

If you don't have PutBucketPolicy permissions, Amazon S3 returns a 403 + * Access Denied error. If you have the correct permissions, but you're not using an + * identity that belongs to the bucket owner's account, Amazon S3 returns a 405 Method Not + * Allowed error.

+ * + * + *

As a security precaution, the root user of the AWS account that owns a bucket can + * always use this operation, even if the policy explicitly denies the root user the + * ability to perform this action.

+ *
+ * + * + *

For more information about bucket policies, see Using Bucket Policies and User + * Policies.

+ * + *

The following operations are related to PutBucketPolicy:

+ * + */ export class PutBucketPolicyCommand extends $Command< PutBucketPolicyCommandInput, PutBucketPolicyCommandOutput, @@ -36,6 +71,9 @@ export class PutBucketPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketReplicationCommand.ts b/clients/client-s3/commands/PutBucketReplicationCommand.ts index 56cdf094f86ce..2d9dc47c29986 100644 --- a/clients/client-s3/commands/PutBucketReplicationCommand.ts +++ b/clients/client-s3/commands/PutBucketReplicationCommand.ts @@ -22,6 +22,76 @@ import { export type PutBucketReplicationCommandInput = PutBucketReplicationRequest; export type PutBucketReplicationCommandOutput = __MetadataBearer; +/** + *

Creates a replication configuration or replaces an existing one. For more information, + * see Replication in the Amazon S3 Developer Guide.

+ * + *

To perform this operation, the user or role performing the operation must have the + * iam:PassRole permission.

+ *
+ *

Specify the replication configuration in the request body. In the replication + * configuration, you provide the name of the destination bucket where you want Amazon S3 to + * replicate objects, the IAM role that Amazon S3 can assume to replicate objects on your behalf, + * and other relevant information.

+ * + * + *

A replication configuration must include at least one rule, and can contain a maximum of + * 1,000. Each rule identifies a subset of objects to replicate by filtering the objects in + * the source bucket. To choose additional subsets of objects to replicate, add a rule for + * each subset. All rules must specify the same destination bucket.

+ * + *

To specify a subset of the objects in the source bucket to apply a replication rule to, + * add the Filter element as a child of the Rule element. You can filter objects based on an + * object key prefix, one or more object tags, or both. When you add the Filter element in the + * configuration, you must also add the following elements: + * DeleteMarkerReplication, Status, and + * Priority.

+ * + *

The latest version of the replication configuration XML is V2. XML V2 replication + * configurations are those that contain the Filter element for rules, and + * rules that specify S3 Replication Time Control (S3 RTC). In XML V2 replication configurations, Amazon S3 doesn't + * replicate delete markers. Therefore, you must set the + * DeleteMarkerReplication element to Disabled. For backward + * compatibility, Amazon S3 continues to support the XML V1 replication configuration.

+ *
+ *

For information about enabling versioning on a bucket, see Using Versioning.

+ * + *

By default, a resource owner, in this case the AWS account that created the bucket, can + * perform this operation. The resource owner can also grant others permissions to perform the + * operation. For more information about permissions, see Specifying Permissions in a Policy + * and Managing Access Permissions to Your + * Amazon S3 Resources.

+ * + *

+ * Handling Replication of Encrypted Objects + *

+ *

By default, Amazon S3 doesn't replicate objects that are stored at rest using server-side + * encryption with CMKs stored in AWS KMS. To replicate AWS KMS-encrypted objects, add the + * following: SourceSelectionCriteria, SseKmsEncryptedObjects, + * Status, EncryptionConfiguration, and + * ReplicaKmsKeyID. For information about replication configuration, see + * Replicating Objects + * Created with SSE Using CMKs stored in AWS KMS.

+ * + *

For information on PutBucketReplication errors, see List of + * replication-related error codes + *

+ * + * + *

The following operations are related to PutBucketReplication:

+ * + */ export class PutBucketReplicationCommand extends $Command< PutBucketReplicationCommandInput, PutBucketReplicationCommandOutput, @@ -36,6 +106,9 @@ export class PutBucketReplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketRequestPaymentCommand.ts b/clients/client-s3/commands/PutBucketRequestPaymentCommand.ts index 251d92f7f2904..2643feac67de0 100644 --- a/clients/client-s3/commands/PutBucketRequestPaymentCommand.ts +++ b/clients/client-s3/commands/PutBucketRequestPaymentCommand.ts @@ -21,6 +21,27 @@ import { export type PutBucketRequestPaymentCommandInput = PutBucketRequestPaymentRequest; export type PutBucketRequestPaymentCommandOutput = __MetadataBearer; +/** + *

Sets the request payment configuration for a bucket. By default, the bucket owner pays + * for downloads from the bucket. This configuration parameter enables the bucket owner (only) + * to specify that the person requesting the download will be charged for the download. For + * more information, see Requester Pays + * Buckets.

+ * + *

The following operations are related to PutBucketRequestPayment:

+ * + */ export class PutBucketRequestPaymentCommand extends $Command< PutBucketRequestPaymentCommandInput, PutBucketRequestPaymentCommandOutput, @@ -35,6 +56,9 @@ export class PutBucketRequestPaymentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketTaggingCommand.ts b/clients/client-s3/commands/PutBucketTaggingCommand.ts index a1fc21829e15c..29b453134c2f6 100644 --- a/clients/client-s3/commands/PutBucketTaggingCommand.ts +++ b/clients/client-s3/commands/PutBucketTaggingCommand.ts @@ -22,6 +22,86 @@ import { export type PutBucketTaggingCommandInput = PutBucketTaggingRequest; export type PutBucketTaggingCommandOutput = __MetadataBearer; +/** + *

Sets the tags for a bucket.

+ *

Use tags to organize your AWS bill to reflect your own cost structure. To do this, sign + * up to get your AWS account bill with tag key values included. Then, to see the cost of + * combined resources, organize your billing information according to resources with the same + * tag key values. For example, you can tag several resources with a specific application + * name, and then organize your billing information to see the total cost of that application + * across several services. For more information, see Cost Allocation + * and Tagging.

+ * + * + *

Within a bucket, if you add a tag that has the same key as an existing tag, the new + * value overwrites the old value. For more information, see Using Cost Allocation in Amazon S3 Bucket + * Tags.

+ *
+ *

To use this operation, you must have permissions to perform the + * s3:PutBucketTagging action. The bucket owner has this permission by default + * and can grant this permission to others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources.

+ * + *

+ * PutBucketTagging has the following special errors:

+ *
    + *
  • + *

    Error code: InvalidTagError + *

    + * + *
  • + *
  • + *

    Error code: MalformedXMLError + *

    + *
      + *
    • + *

      Description: The XML provided does not match the schema.

      + *
    • + *
    + *
  • + *
  • + *

    Error code: OperationAbortedError + *

    + *
      + *
    • + *

      Description: A conflicting conditional operation is currently in progress + * against this resource. Please try again.

      + *
    • + *
    + *
  • + *
  • + *

    Error code: InternalError + *

    + *
      + *
    • + *

      Description: The service was unable to apply the provided tag to the + * bucket.

      + *
    • + *
    + *
  • + *
+ * + * + *

The following operations are related to PutBucketTagging:

+ * + */ export class PutBucketTaggingCommand extends $Command< PutBucketTaggingCommandInput, PutBucketTaggingCommandOutput, @@ -36,6 +116,9 @@ export class PutBucketTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketVersioningCommand.ts b/clients/client-s3/commands/PutBucketVersioningCommand.ts index 4fbe79c7123fa..fdb9a58ccbd45 100644 --- a/clients/client-s3/commands/PutBucketVersioningCommand.ts +++ b/clients/client-s3/commands/PutBucketVersioningCommand.ts @@ -21,6 +21,57 @@ import { export type PutBucketVersioningCommandInput = PutBucketVersioningRequest; export type PutBucketVersioningCommandOutput = __MetadataBearer; +/** + *

Sets the versioning state of an existing bucket. To set the versioning state, you must + * be the bucket owner.

+ *

You can set the versioning state with one of the following values:

+ * + *

+ * Enabled—Enables versioning for the objects in the + * bucket. All objects added to the bucket receive a unique version ID.

+ * + *

+ * Suspended—Disables versioning for the objects in the + * bucket. All objects added to the bucket receive the version ID null.

+ * + *

If the versioning state has never been set on a bucket, it has no versioning state; a + * GetBucketVersioning request does not return a versioning state value.

+ * + *

If the bucket owner enables MFA Delete in the bucket versioning configuration, the + * bucket owner must include the x-amz-mfa request header and the + * Status and the MfaDelete request elements in a request to set + * the versioning state of the bucket.

+ * + * + *

If you have an object expiration lifecycle policy in your non-versioned bucket and + * you want to maintain the same permanent delete behavior when you enable versioning, you + * must add a noncurrent expiration policy. The noncurrent expiration lifecycle policy will + * manage the deletes of the noncurrent object versions in the version-enabled bucket. (A + * version-enabled bucket maintains one current and zero or more noncurrent object + * versions.) For more information, see Lifecycle and Versioning.

+ *
+ * + *

+ * Related Resources + *

+ * + */ export class PutBucketVersioningCommand extends $Command< PutBucketVersioningCommandInput, PutBucketVersioningCommandOutput, @@ -35,6 +86,9 @@ export class PutBucketVersioningCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutBucketWebsiteCommand.ts b/clients/client-s3/commands/PutBucketWebsiteCommand.ts index 3824f79171e1a..b4503629b08da 100644 --- a/clients/client-s3/commands/PutBucketWebsiteCommand.ts +++ b/clients/client-s3/commands/PutBucketWebsiteCommand.ts @@ -21,6 +21,134 @@ import { export type PutBucketWebsiteCommandInput = PutBucketWebsiteRequest; export type PutBucketWebsiteCommandOutput = __MetadataBearer; +/** + *

Sets the configuration of the website that is specified in the website + * subresource. To configure a bucket as a website, you can add this subresource on the bucket + * with website configuration information such as the file name of the index document and any + * redirect rules. For more information, see Hosting Websites on Amazon S3.

+ * + *

This PUT operation requires the S3:PutBucketWebsite permission. By default, + * only the bucket owner can configure the website attached to a bucket; however, bucket + * owners can allow other users to set the website configuration by writing a bucket policy + * that grants them the S3:PutBucketWebsite permission.

+ * + *

To redirect all website requests sent to the bucket's website endpoint, you add a + * website configuration with the following elements. Because all requests are sent to another + * website, you don't need to provide index document name for the bucket.

+ *
    + *
  • + *

    + * WebsiteConfiguration + *

    + *
  • + *
  • + *

    + * RedirectAllRequestsTo + *

    + *
  • + *
  • + *

    + * HostName + *

    + *
  • + *
  • + *

    + * Protocol + *

    + *
  • + *
+ * + *

If you want granular control over redirects, you can use the following elements to add + * routing rules that describe conditions for redirecting requests and information about the + * redirect destination. In this case, the website configuration must provide an index + * document for the bucket, because some requests might not be redirected.

+ *
    + *
  • + *

    + * WebsiteConfiguration + *

    + *
  • + *
  • + *

    + * IndexDocument + *

    + *
  • + *
  • + *

    + * Suffix + *

    + *
  • + *
  • + *

    + * ErrorDocument + *

    + *
  • + *
  • + *

    + * Key + *

    + *
  • + *
  • + *

    + * RoutingRules + *

    + *
  • + *
  • + *

    + * RoutingRule + *

    + *
  • + *
  • + *

    + * Condition + *

    + *
  • + *
  • + *

    + * HttpErrorCodeReturnedEquals + *

    + *
  • + *
  • + *

    + * KeyPrefixEquals + *

    + *
  • + *
  • + *

    + * Redirect + *

    + *
  • + *
  • + *

    + * Protocol + *

    + *
  • + *
  • + *

    + * HostName + *

    + *
  • + *
  • + *

    + * ReplaceKeyPrefixWith + *

    + *
  • + *
  • + *

    + * ReplaceKeyWith + *

    + *
  • + *
  • + *

    + * HttpRedirectCode + *

    + *
  • + *
+ * + *

Amazon S3 has a limitation of 50 routing rules per website configuration. If you require more + * than 50 routing rules, you can use object redirect. For more information, see Configuring an + * Object Redirect in the Amazon Simple Storage Service Developer Guide.

+ */ export class PutBucketWebsiteCommand extends $Command< PutBucketWebsiteCommandInput, PutBucketWebsiteCommandOutput, @@ -35,6 +163,9 @@ export class PutBucketWebsiteCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutObjectAclCommand.ts b/clients/client-s3/commands/PutObjectAclCommand.ts index ced2a2f050983..cee72f3f17bb3 100644 --- a/clients/client-s3/commands/PutObjectAclCommand.ts +++ b/clients/client-s3/commands/PutObjectAclCommand.ts @@ -21,6 +21,187 @@ import { export type PutObjectAclCommandInput = PutObjectAclRequest; export type PutObjectAclCommandOutput = PutObjectAclOutput & __MetadataBearer; +/** + *

Uses the acl subresource to set the access control list (ACL) permissions + * for a new or existing object in an S3 bucket. You must have WRITE_ACP + * permission to set the ACL of an object. For more information, see What + * permissions can I grant? in the Amazon Simple Storage Service Developer Guide.

+ *

This action is not supported by Amazon S3 on Outposts.

+ *

Depending on your application needs, you can choose to set + * the ACL on an object using either the request body or the headers. For example, if you have + * an existing application that updates a bucket ACL using the request body, you can continue + * to use that approach. For more information, see Access Control List (ACL) Overview in the Amazon S3 Developer + * Guide.

+ * + * + * + *

+ * Access Permissions + *

+ *

You can set access permissions using one of the following methods:

+ *
    + *
  • + *

    Specify a canned ACL with the x-amz-acl request header. Amazon S3 supports + * a set of predefined ACLs, known as canned ACLs. Each canned ACL has a predefined set + * of grantees and permissions. Specify the canned ACL name as the value of + * x-amz-acl. If you use this header, you cannot use other access + * control-specific headers in your request. For more information, see Canned ACL.

    + *
  • + *
  • + *

    Specify access permissions explicitly with the x-amz-grant-read, + * x-amz-grant-read-acp, x-amz-grant-write-acp, and + * x-amz-grant-full-control headers. When using these headers, you + * specify explicit access permissions and grantees (AWS accounts or Amazon S3 groups) who + * will receive the permission. If you use these ACL-specific headers, you cannot use + * x-amz-acl header to set a canned ACL. These parameters map to the set + * of permissions that Amazon S3 supports in an ACL. For more information, see Access Control List (ACL) + * Overview.

    + * + *

    You specify each grantee as a type=value pair, where the type is one of the + * following:

    + *
      + *
    • + *

      + * id – if the value specified is the canonical user ID of an AWS + * account

      + *
    • + *
    • + *

      + * uri – if you are granting permissions to a predefined + * group

      + *
    • + *
    • + *

      + * emailAddress – if the value specified is the email address of + * an AWS account

      + * + *

      Using email addresses to specify a grantee is only supported in the following AWS Regions:

      + *
        + *
      • + *

        US East (N. Virginia)

        + *
      • + *
      • + *

        US West (N. California)

        + *
      • + *
      • + *

        US West (Oregon)

        + *
      • + *
      • + *

        Asia Pacific (Singapore)

        + *
      • + *
      • + *

        Asia Pacific (Sydney)

        + *
      • + *
      • + *

        Asia Pacific (Tokyo)

        + *
      • + *
      • + *

        Europe (Ireland)

        + *
      • + *
      • + *

        South America (São Paulo)

        + *
      • + *
      + *

      For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints in the AWS General Reference.

      + *
      + *
    • + *
    + *

    For example, the following x-amz-grant-read header grants list + * objects permission to the two AWS accounts identified by their email + * addresses.

    + *

    + * x-amz-grant-read: emailAddress="xyz@amazon.com", + * emailAddress="abc@amazon.com" + *

    + * + *
  • + *
+ *

You can use either a canned ACL or specify access permissions explicitly. You cannot do + * both.

+ *

+ * Grantee Values + *

+ *

You can specify the person (grantee) to whom you're assigning access rights (using + * request elements) in the following ways:

+ *
    + *
  • + *

    By the person's ID:

    + *

    + * <>ID<><>GranteesEmail<> + * + *

    + *

    DisplayName is optional and ignored in the request.

    + *
  • + *
  • + *

    By URI:

    + *

    + * <>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<> + *

    + *
  • + *
  • + *

    By Email address:

    + *

    + * <>Grantees@email.com<>lt;/Grantee> + *

    + *

    The grantee is resolved to the CanonicalUser and, in a response to a GET Object + * acl request, appears as the CanonicalUser.

    + * + *

    Using email addresses to specify a grantee is only supported in the following AWS Regions:

    + *
      + *
    • + *

      US East (N. Virginia)

      + *
    • + *
    • + *

      US West (N. California)

      + *
    • + *
    • + *

      US West (Oregon)

      + *
    • + *
    • + *

      Asia Pacific (Singapore)

      + *
    • + *
    • + *

      Asia Pacific (Sydney)

      + *
    • + *
    • + *

      Asia Pacific (Tokyo)

      + *
    • + *
    • + *

      Europe (Ireland)

      + *
    • + *
    • + *

      South America (São Paulo)

      + *
    • + *
    + *

    For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints in the AWS General Reference.

    + *
    + *
  • + *
+ *

+ * Versioning + *

+ *

The ACL of an object is set at the object version level. By default, PUT sets the ACL of + * the current version of an object. To set the ACL of a different version, use the + * versionId subresource.

+ *

+ * Related Resources + *

+ * + */ export class PutObjectAclCommand extends $Command< PutObjectAclCommandInput, PutObjectAclCommandOutput, @@ -35,6 +216,9 @@ export class PutObjectAclCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutObjectCommand.ts b/clients/client-s3/commands/PutObjectCommand.ts index 99532f8fba57e..e8378fb268816 100644 --- a/clients/client-s3/commands/PutObjectCommand.ts +++ b/clients/client-s3/commands/PutObjectCommand.ts @@ -21,6 +21,89 @@ export type PutObjectCommandInput = Omit & { }; export type PutObjectCommandOutput = PutObjectOutput & __MetadataBearer; +/** + *

Adds an object to a bucket. You must have WRITE permissions on a bucket to add an object + * to it.

+ * + * + *

Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the + * entire object to the bucket.

+ * + *

Amazon S3 is a distributed system. If it receives multiple write requests for the same object + * simultaneously, it overwrites all but the last object written. Amazon S3 does not provide object + * locking; if you need this, make sure to build it into your application layer or use + * versioning instead.

+ * + *

To ensure that data is not corrupted traversing the network, use the + * Content-MD5 header. When you use this header, Amazon S3 checks the object + * against the provided MD5 value and, if they do not match, returns an error. Additionally, + * you can calculate the MD5 while putting an object to Amazon S3 and compare the returned ETag to + * the calculated MD5 value.

+ * + *

The Content-MD5 header is required for any request to upload an object + * with a retention period configured using Amazon S3 Object Lock. For more information about + * Amazon S3 Object Lock, see Amazon S3 Object Lock Overview + * in the Amazon Simple Storage Service Developer Guide.

+ *
+ * + * + *

+ * Server-side Encryption + *

+ *

You can optionally request server-side encryption. With server-side encryption, Amazon S3 + * encrypts your data as it writes it to disks in its data centers and decrypts the data when + * you access it. You have the option to provide your own encryption key or use AWS managed + * encryption keys. For more information, see Using Server-Side + * Encryption.

+ *

+ * Access Control List (ACL)-Specific Request + * Headers + *

+ *

You can use headers to grant ACL- based permissions. By default, all objects are + * private. Only the owner has full access control. When adding a new object, you can grant + * permissions to individual AWS accounts or to predefined groups defined by Amazon S3. These + * permissions are then added to the ACL on the object. For more information, see Access Control List + * (ACL) Overview and Managing ACLs Using the REST + * API.

+ * + *

+ * Storage Class Options + *

+ *

By default, Amazon S3 uses the STANDARD Storage Class to store newly created objects. The + * STANDARD storage class provides high durability and high availability. Depending on + * performance needs, you can specify a different Storage Class. Amazon S3 on Outposts only uses + * the OUTPOSTS Storage Class. For more information, see Storage Classes in the Amazon S3 + * Service Developer Guide.

+ * + * + *

+ * Versioning + *

+ *

If you enable versioning for a bucket, Amazon S3 automatically generates a unique version ID + * for the object being stored. Amazon S3 returns this ID in the response. When you enable + * versioning for a bucket, if Amazon S3 receives multiple write requests for the same object + * simultaneously, it stores all of the objects.

+ *

For more information about versioning, see Adding Objects to + * Versioning Enabled Buckets. For information about returning the versioning state + * of a bucket, see GetBucketVersioning.

+ * + * + *

+ * Related Resources + *

+ * + */ export class PutObjectCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -31,6 +114,9 @@ export class PutObjectCommand extends $Command, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutObjectLegalHoldCommand.ts b/clients/client-s3/commands/PutObjectLegalHoldCommand.ts index 0601bc7e75ff1..09911b381a91b 100644 --- a/clients/client-s3/commands/PutObjectLegalHoldCommand.ts +++ b/clients/client-s3/commands/PutObjectLegalHoldCommand.ts @@ -21,6 +21,20 @@ import { export type PutObjectLegalHoldCommandInput = PutObjectLegalHoldRequest; export type PutObjectLegalHoldCommandOutput = PutObjectLegalHoldOutput & __MetadataBearer; +/** + *

Applies a Legal Hold configuration to the specified object.

+ *

This action is not supported by Amazon S3 on Outposts.

+ *

+ * Related Resources + *

+ * + */ export class PutObjectLegalHoldCommand extends $Command< PutObjectLegalHoldCommandInput, PutObjectLegalHoldCommandOutput, @@ -35,6 +49,9 @@ export class PutObjectLegalHoldCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutObjectLockConfigurationCommand.ts b/clients/client-s3/commands/PutObjectLockConfigurationCommand.ts index aab6e8b35f791..54611617263f4 100644 --- a/clients/client-s3/commands/PutObjectLockConfigurationCommand.ts +++ b/clients/client-s3/commands/PutObjectLockConfigurationCommand.ts @@ -21,6 +21,27 @@ import { export type PutObjectLockConfigurationCommandInput = PutObjectLockConfigurationRequest; export type PutObjectLockConfigurationCommandOutput = PutObjectLockConfigurationOutput & __MetadataBearer; +/** + *

Places an Object Lock configuration on the specified bucket. The rule specified in the + * Object Lock configuration will be applied by default to every new object placed in the + * specified bucket.

+ * + *

+ * DefaultRetention requires either Days or Years. You can't specify both + * at the same time.

+ *
+ *

+ * Related Resources + *

+ * + */ export class PutObjectLockConfigurationCommand extends $Command< PutObjectLockConfigurationCommandInput, PutObjectLockConfigurationCommandOutput, @@ -35,6 +56,9 @@ export class PutObjectLockConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutObjectRetentionCommand.ts b/clients/client-s3/commands/PutObjectRetentionCommand.ts index 6416911aadbe0..1a9647b0bc564 100644 --- a/clients/client-s3/commands/PutObjectRetentionCommand.ts +++ b/clients/client-s3/commands/PutObjectRetentionCommand.ts @@ -21,6 +21,20 @@ import { export type PutObjectRetentionCommandInput = PutObjectRetentionRequest; export type PutObjectRetentionCommandOutput = PutObjectRetentionOutput & __MetadataBearer; +/** + *

Places an Object Retention configuration on an object.

+ *

This action is not supported by Amazon S3 on Outposts.

+ *

+ * Related Resources + *

+ * + */ export class PutObjectRetentionCommand extends $Command< PutObjectRetentionCommandInput, PutObjectRetentionCommandOutput, @@ -35,6 +49,9 @@ export class PutObjectRetentionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutObjectTaggingCommand.ts b/clients/client-s3/commands/PutObjectTaggingCommand.ts index 2bc9cafc39214..dad265abee90b 100644 --- a/clients/client-s3/commands/PutObjectTaggingCommand.ts +++ b/clients/client-s3/commands/PutObjectTaggingCommand.ts @@ -21,6 +21,107 @@ import { export type PutObjectTaggingCommandInput = PutObjectTaggingRequest; export type PutObjectTaggingCommandOutput = PutObjectTaggingOutput & __MetadataBearer; +/** + *

Sets the supplied tag-set to an object that already exists in a bucket.

+ *

A tag is a key-value pair. You can associate tags with an object by sending a PUT + * request against the tagging subresource that is associated with the object. You can + * retrieve tags by sending a GET request. For more information, see GetObjectTagging.

+ * + *

For tagging-related restrictions related to characters and encodings, see Tag + * Restrictions. Note that Amazon S3 limits the maximum number of tags to 10 tags per + * object.

+ * + *

To use this operation, you must have permission to perform the + * s3:PutObjectTagging action. By default, the bucket owner has this + * permission and can grant this permission to others.

+ * + *

To put tags of any other version, use the versionId query parameter. You + * also need permission for the s3:PutObjectVersionTagging action.

+ * + *

For information about the Amazon S3 object tagging feature, see Object Tagging.

+ * + * + *

+ * Special Errors + *

+ *
    + *
  • + *
      + *
    • + *

      + * Code: InvalidTagError + *

      + *
    • + *
    • + *

      + * Cause: The tag provided was not a valid tag. This error can occur + * if the tag did not pass input validation. For more information, see Object Tagging. + *

      + *
    • + *
    + *
  • + *
  • + *
      + *
    • + *

      + * Code: MalformedXMLError + *

      + *
    • + *
    • + *

      + * Cause: The XML provided does not match the schema. + *

      + *
    • + *
    + *
  • + *
  • + *
      + *
    • + *

      + * Code: OperationAbortedError + *

      + *
    • + *
    • + *

      + * Cause: A conflicting conditional operation is currently in + * progress against this resource. Please try again. + *

      + *
    • + *
    + *
  • + *
  • + *
      + *
    • + *

      + * Code: InternalError + *

      + *
    • + *
    • + *

      + * Cause: The service was unable to apply the provided tag to the + * object. + *

      + *
    • + *
    + *
  • + *
+ * + * + * + * + * + * + *

+ * Related Resources + *

+ * + */ export class PutObjectTaggingCommand extends $Command< PutObjectTaggingCommandInput, PutObjectTaggingCommandOutput, @@ -35,6 +136,9 @@ export class PutObjectTaggingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/PutPublicAccessBlockCommand.ts b/clients/client-s3/commands/PutPublicAccessBlockCommand.ts index 67e9ca9ee2b27..afb808a96621a 100644 --- a/clients/client-s3/commands/PutPublicAccessBlockCommand.ts +++ b/clients/client-s3/commands/PutPublicAccessBlockCommand.ts @@ -21,6 +21,53 @@ import { export type PutPublicAccessBlockCommandInput = PutPublicAccessBlockRequest; export type PutPublicAccessBlockCommandOutput = __MetadataBearer; +/** + *

Creates or modifies the PublicAccessBlock configuration for an Amazon S3 bucket. + * To use this operation, you must have the s3:PutBucketPublicAccessBlock + * permission. For more information about Amazon S3 permissions, see Specifying Permissions in a + * Policy.

+ * + * + *

When Amazon S3 evaluates the PublicAccessBlock configuration for a bucket or + * an object, it checks the PublicAccessBlock configuration for both the + * bucket (or the bucket that contains the object) and the bucket owner's account. If the + * PublicAccessBlock configurations are different between the bucket and + * the account, Amazon S3 uses the most restrictive combination of the bucket-level and + * account-level settings.

+ *
+ * + * + *

For more information about when Amazon S3 considers a bucket or an object public, see The Meaning of "Public".

+ * + * + * + *

+ * Related Resources + *

+ * + */ export class PutPublicAccessBlockCommand extends $Command< PutPublicAccessBlockCommandInput, PutPublicAccessBlockCommandOutput, @@ -35,6 +82,9 @@ export class PutPublicAccessBlockCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/RestoreObjectCommand.ts b/clients/client-s3/commands/RestoreObjectCommand.ts index 8411455e3daa9..d4e430dc8c57f 100644 --- a/clients/client-s3/commands/RestoreObjectCommand.ts +++ b/clients/client-s3/commands/RestoreObjectCommand.ts @@ -22,6 +22,299 @@ import { export type RestoreObjectCommandInput = RestoreObjectRequest; export type RestoreObjectCommandOutput = RestoreObjectOutput & __MetadataBearer; +/** + *

Restores an archived copy of an object back into Amazon S3

+ *

This action is not supported by Amazon S3 on Outposts.

+ *

This action performs the following types of requests:

+ *
    + *
  • + *

    + * select - Perform a select query on an archived object

    + *
  • + *
  • + *

    + * restore an archive - Restore an archived object

    + *
  • + *
+ *

To use this operation, you must have permissions to perform the + * s3:RestoreObject action. The bucket owner has this permission by default + * and can grant this permission to others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 + * Resources in the Amazon Simple Storage Service Developer Guide.

+ *

+ * Querying Archives with Select Requests + *

+ *

You use a select type of request to perform SQL queries on archived objects. The + * archived objects that are being queried by the select request must be formatted as + * uncompressed comma-separated values (CSV) files. You can run queries and custom analytics + * on your archived data without having to restore your data to a hotter Amazon S3 tier. For an + * overview about select requests, see Querying Archived Objects in the Amazon Simple Storage Service Developer Guide.

+ *

When making a select request, do the following:

+ *
    + *
  • + *

    Define an output location for the select query's output. This must be an Amazon S3 + * bucket in the same AWS Region as the bucket that contains the archive object that is + * being queried. The AWS account that initiates the job must have permissions to write + * to the S3 bucket. You can specify the storage class and encryption for the output + * objects stored in the bucket. For more information about output, see Querying Archived Objects + * in the Amazon Simple Storage Service Developer Guide.

    + *

    For more information about the S3 structure in the request body, see + * the following:

    + * + *
  • + *
  • + *

    Define the SQL expression for the SELECT type of restoration for your + * query in the request body's SelectParameters structure. You can use + * expressions like the following examples.

    + *
      + *
    • + *

      The following expression returns all records from the specified + * object.

      + *

      + * SELECT * FROM Object + *

      + *
    • + *
    • + *

      Assuming that you are not using any headers for data stored in the object, + * you can specify columns with positional headers.

      + *

      + * SELECT s._1, s._2 FROM Object s WHERE s._3 > 100 + *

      + *
    • + *
    • + *

      If you have headers and you set the fileHeaderInfo in the + * CSV structure in the request body to USE, you can + * specify headers in the query. (If you set the fileHeaderInfo field + * to IGNORE, the first row is skipped for the query.) You cannot mix + * ordinal positions with header column names.

      + *

      + * SELECT s.Id, s.FirstName, s.SSN FROM S3Object s + *

      + *
    • + *
    + *
  • + *
+ *

For more information about using SQL with S3 Glacier Select restore, see SQL Reference for Amazon S3 Select and + * S3 Glacier Select in the Amazon Simple Storage Service Developer Guide.

+ *

When making a select request, you can also do the following:

+ *
    + *
  • + *

    To expedite your queries, specify the Expedited tier. For more + * information about tiers, see "Restoring Archives," later in this topic.

    + *
  • + *
  • + *

    Specify details about the data serialization format of both the input object that + * is being queried and the serialization of the CSV-encoded query results.

    + *
  • + *
+ *

The following are additional important facts about the select feature:

+ *
    + *
  • + *

    The output results are new Amazon S3 objects. Unlike archive retrievals, they are + * stored until explicitly deleted-manually or through a lifecycle policy.

    + *
  • + *
  • + *

    You can issue more than one select request on the same Amazon S3 object. Amazon S3 doesn't + * deduplicate requests, so avoid issuing duplicate requests.

    + *
  • + *
  • + *

    Amazon S3 accepts a select request even if the object has already been restored. A + * select request doesn’t return error response 409.

    + *
  • + *
+ *

+ * Restoring Archives + *

+ *

Objects that you archive to the S3 Glacier, + * S3 Glacier Deep Archive, S3 Intelligent-Tiering Archive, or S3 Intelligent-Tiering Deep Archive storage + * classes are not accessible in real time. For objects in Archive Access tier or + * Deep Archive Access tier you must first initiate a restore request, and then wait until the object + * is moved into the Frequent Access tier. For objects in S3 Glacier or + * S3 Glacier Deep Archive you must first initiate a restore request, and then wait + * until a temporary copy of the object is available. To access an archived object, you must + * restore the object for the duration (number of days) that you specify.

+ *

To restore a specific object version, you can provide a version ID. If you don't provide + * a version ID, Amazon S3 restores the current version.

+ *

When restoring an archived object (or using a select request), you can specify one of + * the following data access tier options in the Tier element of the request + * body:

+ *
    + *
  • + *

    + * + * Expedited + * - Expedited retrievals + * allow you to quickly access your data stored in the S3 Glacier or + * S3 Intelligent-Tiering Archive storage class when occasional urgent requests for a subset of + * archives are required. For all but the largest archived objects (250 MB+), data + * accessed using Expedited retrievals is typically made available within 1–5 minutes. + * Provisioned capacity ensures that retrieval capacity for Expedited retrievals is + * available when you need it. Expedited retrievals and provisioned capacity are not + * available for objects stored in the S3 Glacier Deep Archive or + * S3 Intelligent-Tiering Deep Archive storage class.

    + *
  • + *
  • + *

    + * + * Standard + * - Standard retrievals allow + * you to access any of your archived objects within several hours. This is the default + * option for retrieval requests that do not specify the retrieval option. Standard + * retrievals typically finish within 3–5 hours for objects stored in the + * S3 Glacier or S3 Intelligent-Tiering Archive storage class. They typically + * finish within 12 hours for objects stored in the S3 Glacier Deep Archive or + * S3 Intelligent-Tiering Deep Archive storage class. Standard retrievals are free for objects stored + * in S3 Intelligent-Tiering.

    + *
  • + *
  • + *

    + * + * Bulk + * - Bulk retrievals are the + * lowest-cost retrieval option in S3 Glacier, enabling you to retrieve large amounts, + * even petabytes, of data inexpensively. Bulk retrievals typically finish within 5–12 + * hours for objects stored in the S3 Glacier or S3 Intelligent-Tiering Archive + * storage class. They typically finish within 48 hours for objects stored in the + * S3 Glacier Deep Archive or S3 Intelligent-Tiering Deep Archive storage class. Bulk + * retrievals are free for objects stored in S3 Intelligent-Tiering.

    + *
  • + *
+ *

For more information about archive retrieval options and provisioned capacity for + * Expedited data access, see Restoring Archived Objects in the Amazon Simple Storage Service Developer Guide.

+ *

You can use Amazon S3 restore speed upgrade to change the restore speed to a faster speed + * while it is in progress. For more information, see + * Upgrading the speed of an in-progress restore in the + * Amazon Simple Storage Service Developer Guide.

+ *

To get the status of object restoration, you can send a HEAD request. + * Operations return the x-amz-restore header, which provides information about + * the restoration status, in the response. You can use Amazon S3 event notifications to notify you + * when a restore is initiated or completed. For more information, see Configuring Amazon S3 Event Notifications in + * the Amazon Simple Storage Service Developer Guide.

+ *

After restoring an archived object, you can update the restoration period by reissuing + * the request with a new period. Amazon S3 updates the restoration period relative to the current + * time and charges only for the request-there are no data transfer charges. You cannot + * update the restoration period when Amazon S3 is actively processing your current restore request + * for the object.

+ *

If your bucket has a lifecycle configuration with a rule that includes an expiration + * action, the object expiration overrides the life span that you specify in a restore + * request. For example, if you restore an object copy for 10 days, but the object is + * scheduled to expire in 3 days, Amazon S3 deletes the object in 3 days. For more information + * about lifecycle configuration, see PutBucketLifecycleConfiguration and Object Lifecycle Management in + * Amazon Simple Storage Service Developer Guide.

+ *

+ * Responses + *

+ *

A successful operation returns either the 200 OK or 202 + * Accepted status code.

+ *
    + *
  • + *

    If the object is not previously restored, then Amazon S3 returns 202 + * Accepted in the response.

    + *
  • + *
  • + *

    If the object is previously restored, Amazon S3 returns 200 OK in the + * response.

    + *
  • + *
+ *

+ * Special Errors + *

+ *
    + *
  • + *
      + *
    • + *

      + * Code: RestoreAlreadyInProgress + *

      + *
    • + *
    • + *

      + * Cause: Object restore is already in progress. (This error does not + * apply to SELECT type requests.) + *

      + *
    • + *
    • + *

      + * HTTP Status Code: 409 Conflict + *

      + *
    • + *
    • + *

      + * SOAP Fault Code Prefix: Client + *

      + *
    • + *
    + *
  • + *
  • + *
      + *
    • + *

      + * Code: GlacierExpeditedRetrievalNotAvailable + *

      + *
    • + *
    • + *

      + * Cause: expedited retrievals are currently not available. Try again + * later. (Returned if there is insufficient capacity to process the Expedited + * request. This error applies only to Expedited retrievals and not to + * S3 Standard or Bulk retrievals.) + *

      + *
    • + *
    • + *

      + * HTTP Status Code: 503 + *

      + *
    • + *
    • + *

      + * SOAP Fault Code Prefix: N/A + *

      + *
    • + *
    + *
  • + *
+ * + *

+ * Related Resources + *

+ * + */ export class RestoreObjectCommand extends $Command< RestoreObjectCommandInput, RestoreObjectCommandOutput, @@ -36,6 +329,9 @@ export class RestoreObjectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/SelectObjectContentCommand.ts b/clients/client-s3/commands/SelectObjectContentCommand.ts index 108c86fad48a6..b0da0e2156ec9 100644 --- a/clients/client-s3/commands/SelectObjectContentCommand.ts +++ b/clients/client-s3/commands/SelectObjectContentCommand.ts @@ -23,6 +23,126 @@ import { export type SelectObjectContentCommandInput = SelectObjectContentRequest; export type SelectObjectContentCommandOutput = SelectObjectContentOutput & __MetadataBearer; +/** + *

This operation filters the contents of an Amazon S3 object based on a simple structured query + * language (SQL) statement. In the request, along with the SQL expression, you must also + * specify a data serialization format (JSON, CSV, or Apache Parquet) of the object. Amazon S3 uses + * this format to parse object data into records, and returns only records that match the + * specified SQL expression. You must also specify the data serialization format for the + * response.

+ *

This action is not supported by Amazon S3 on Outposts.

+ *

For more information about Amazon S3 Select, + * see Selecting Content from + * Objects in the Amazon Simple Storage Service Developer Guide.

+ *

For more information about using SQL with Amazon S3 Select, see SQL Reference for Amazon S3 Select + * and S3 Glacier Select in the Amazon Simple Storage Service Developer Guide.

+ *

+ *

+ * Permissions + *

+ *

You must have s3:GetObject permission for this operation. Amazon S3 Select does + * not support anonymous access. For more information about permissions, see Specifying Permissions in a Policy + * in the Amazon Simple Storage Service Developer Guide.

+ *

+ *

+ * Object Data Formats + *

+ *

You can use Amazon S3 Select to query objects that have the following format + * properties:

+ *
    + *
  • + *

    + * CSV, JSON, and Parquet - Objects must be in CSV, JSON, or + * Parquet format.

    + *
  • + *
  • + *

    + * UTF-8 - UTF-8 is the only encoding type Amazon S3 Select + * supports.

    + *
  • + *
  • + *

    + * GZIP or BZIP2 - CSV and JSON files can be compressed using + * GZIP or BZIP2. GZIP and BZIP2 are the only compression formats that Amazon S3 Select + * supports for CSV and JSON files. Amazon S3 Select supports columnar compression for + * Parquet using GZIP or Snappy. Amazon S3 Select does not support whole-object compression + * for Parquet objects.

    + *
  • + *
  • + *

    + * Server-side encryption - Amazon S3 Select supports querying + * objects that are protected with server-side encryption.

    + *

    For objects that are encrypted with customer-provided encryption keys (SSE-C), you + * must use HTTPS, and you must use the headers that are documented in the GetObject. For more information about SSE-C, see Server-Side Encryption + * (Using Customer-Provided Encryption Keys) in the + * Amazon Simple Storage Service Developer Guide.

    + *

    For objects that are encrypted with Amazon S3 managed encryption keys (SSE-S3) and + * customer master keys (CMKs) stored in AWS Key Management Service (SSE-KMS), + * server-side encryption is handled transparently, so you don't need to specify + * anything. For more information about server-side encryption, including SSE-S3 and + * SSE-KMS, see Protecting Data Using + * Server-Side Encryption in the Amazon Simple Storage Service Developer Guide.

    + *
  • + *
+ * + *

+ * Working with the Response Body + *

+ *

Given the response size is unknown, Amazon S3 Select streams the response as a series of + * messages and includes a Transfer-Encoding header with chunked as + * its value in the response. For more information, see Appendix: SelectObjectContent + * Response + * .

+ * + *

+ *

+ * GetObject Support + *

+ *

The SelectObjectContent operation does not support the following + * GetObject functionality. For more information, see GetObject.

+ *
    + *
  • + *

    + * Range: Although you can specify a scan range for an Amazon S3 Select request + * (see SelectObjectContentRequest - ScanRange in the request parameters), + * you cannot specify the range of bytes of an object to return.

    + *
  • + *
  • + *

    GLACIER, DEEP_ARCHIVE and REDUCED_REDUNDANCY storage classes: You cannot specify + * the GLACIER, DEEP_ARCHIVE, or REDUCED_REDUNDANCY storage classes. For + * more information, about storage classes see Storage Classes + * in the Amazon Simple Storage Service Developer Guide.

    + *
  • + *
+ *

+ *

+ * Special Errors + *

+ * + *

For a list of special errors for this operation, see List of + * SELECT Object Content Error Codes + *

+ *

+ * Related Resources + *

+ * + */ export class SelectObjectContentCommand extends $Command< SelectObjectContentCommandInput, SelectObjectContentCommandOutput, @@ -37,6 +157,9 @@ export class SelectObjectContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/UploadPartCommand.ts b/clients/client-s3/commands/UploadPartCommand.ts index ec7395b7fe7e2..72ed71c43172a 100644 --- a/clients/client-s3/commands/UploadPartCommand.ts +++ b/clients/client-s3/commands/UploadPartCommand.ts @@ -24,6 +24,146 @@ export type UploadPartCommandInput = Omit & { }; export type UploadPartCommandOutput = UploadPartOutput & __MetadataBearer; +/** + *

Uploads a part in a multipart upload.

+ * + *

In this operation, you provide part data in your request. However, you have an option + * to specify your existing Amazon S3 object as a data source for the part you are uploading. To + * upload a part from an existing object, you use the UploadPartCopy operation. + *

+ *
+ * + *

You must initiate a multipart upload (see CreateMultipartUpload) + * before you can upload any part. In response to your initiate request, Amazon S3 returns an + * upload ID, a unique identifier, that you must include in your upload part request.

+ *

Part numbers can be any number from 1 to 10,000, inclusive. A part number uniquely + * identifies a part and also defines its position within the object being created. If you + * upload a new part using the same part number that was used with a previous part, the + * previously uploaded part is overwritten. Each part must be at least 5 MB in size, except + * the last part. There is no size limit on the last part of your multipart upload.

+ *

To ensure that data is not corrupted when traversing the network, specify the + * Content-MD5 header in the upload part request. Amazon S3 checks the part data + * against the provided MD5 value. If they do not match, Amazon S3 returns an error.

+ * + *

If the upload request is signed with Signature Version 4, then AWS S3 uses the + * x-amz-content-sha256 header as a checksum instead of + * Content-MD5. For more information see Authenticating Requests: Using the Authorization Header (AWS Signature Version + * 4).

+ * + * + * + *

+ * Note: After you initiate multipart upload and upload + * one or more parts, you must either complete or abort multipart upload in order to stop + * getting charged for storage of the uploaded parts. Only after you either complete or abort + * multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts + * storage.

+ * + *

For more information on multipart uploads, go to Multipart Upload Overview in the + * Amazon Simple Storage Service Developer Guide .

+ *

For information on the permissions required to use the multipart upload API, go to + * Multipart Upload API and + * Permissions in the Amazon Simple Storage Service Developer Guide.

+ * + *

You can optionally request server-side encryption where Amazon S3 encrypts your data as it + * writes it to disks in its data centers and decrypts it for you when you access it. You have + * the option of providing your own encryption key, or you can use the AWS managed encryption + * keys. If you choose to provide your own encryption key, the request headers you provide in + * the request must match the headers you used in the request to initiate the upload by using + * CreateMultipartUpload. For more information, go to Using Server-Side Encryption in + * the Amazon Simple Storage Service Developer Guide.

+ * + *

Server-side encryption is supported by the S3 Multipart Upload actions. Unless you are + * using a customer-provided encryption key, you don't need to specify the encryption + * parameters in each UploadPart request. Instead, you only need to specify the server-side + * encryption parameters in the initial Initiate Multipart request. For more information, see + * CreateMultipartUpload.

+ * + *

If you requested server-side encryption using a customer-provided encryption key in your + * initiate multipart upload request, you must provide identical encryption information in + * each part upload using the following headers.

+ * + * + *
    + *
  • + *

    x-amz-server-side-encryption-customer-algorithm

    + *
  • + *
  • + *

    x-amz-server-side-encryption-customer-key

    + *
  • + *
  • + *

    x-amz-server-side-encryption-customer-key-MD5

    + *
  • + *
+ * + *

+ * Special Errors + *

+ *
    + *
  • + *
      + *
    • + *

      + * Code: NoSuchUpload + *

      + *
    • + *
    • + *

      + * Cause: The specified multipart upload does not exist. The upload + * ID might be invalid, or the multipart upload might have been aborted or + * completed. + *

      + *
    • + *
    • + *

      + * HTTP Status Code: 404 Not Found + *

      + *
    • + *
    • + *

      + * SOAP Fault Code Prefix: Client + *

      + *
    • + *
    + *
  • + *
+ * + * + * + * + * + * + *

+ * Related Resources + *

+ * + */ export class UploadPartCommand extends $Command< UploadPartCommandInput, UploadPartCommandOutput, @@ -38,6 +178,9 @@ export class UploadPartCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/commands/UploadPartCopyCommand.ts b/clients/client-s3/commands/UploadPartCopyCommand.ts index 1af8107b9a0ff..9d7c0705f650c 100644 --- a/clients/client-s3/commands/UploadPartCopyCommand.ts +++ b/clients/client-s3/commands/UploadPartCopyCommand.ts @@ -23,6 +23,187 @@ import { export type UploadPartCopyCommandInput = UploadPartCopyRequest; export type UploadPartCopyCommandOutput = UploadPartCopyOutput & __MetadataBearer; +/** + *

Uploads a part by copying data from an existing object as data source. You specify the + * data source by adding the request header x-amz-copy-source in your request and + * a byte range by adding the request header x-amz-copy-source-range in your + * request.

+ *

The minimum allowable part size for a multipart upload is 5 MB. For more information + * about multipart upload limits, go to Quick + * Facts in the Amazon Simple Storage Service Developer Guide.

+ * + *

Instead of using an existing object as part data, you might use the UploadPart + * operation and provide data in your request.

+ *
+ * + *

You must initiate a multipart upload before you can upload any part. In response to your + * initiate request. Amazon S3 returns a unique identifier, the upload ID, that you must include in + * your upload part request.

+ *

For more information about using the UploadPartCopy operation, see the + * following:

+ * + *
    + *
  • + *

    For conceptual information about multipart uploads, see Uploading Objects Using Multipart + * Upload in the Amazon Simple Storage Service Developer Guide.

    + *
  • + *
  • + *

    For information about permissions required to use the multipart upload API, see + * Multipart Upload API and + * Permissions in the Amazon Simple Storage Service Developer Guide.

    + *
  • + *
  • + *

    For information about copying objects using a single atomic operation vs. the + * multipart upload, see Operations on + * Objects in the Amazon Simple Storage Service Developer Guide.

    + *
  • + *
  • + *

    For information about using server-side encryption with customer-provided + * encryption keys with the UploadPartCopy operation, see CopyObject and UploadPart.

    + *
  • + *
+ *

Note the following additional considerations about the request headers + * x-amz-copy-source-if-match, x-amz-copy-source-if-none-match, + * x-amz-copy-source-if-unmodified-since, and + * x-amz-copy-source-if-modified-since:

+ *

+ *
    + *
  • + *

    + * Consideration 1 - If both of the + * x-amz-copy-source-if-match and + * x-amz-copy-source-if-unmodified-since headers are present in the + * request as follows:

    + *

    + * x-amz-copy-source-if-match condition evaluates to true, + * and;

    + *

    + * x-amz-copy-source-if-unmodified-since condition evaluates to + * false;

    + *

    Amazon S3 returns 200 OK and copies the data. + *

    + * + *
  • + *
  • + *

    + * Consideration 2 - If both of the + * x-amz-copy-source-if-none-match and + * x-amz-copy-source-if-modified-since headers are present in the + * request as follows:

    + *

    + * x-amz-copy-source-if-none-match condition evaluates to + * false, and;

    + *

    + * x-amz-copy-source-if-modified-since condition evaluates to + * true;

    + *

    Amazon S3 returns 412 Precondition Failed response code. + *

    + *
  • + *
+ *

+ * Versioning + *

+ *

If your bucket has versioning enabled, you could have multiple versions of the same + * object. By default, x-amz-copy-source identifies the current version of the + * object to copy. If the current version is a delete marker and you don't specify a versionId + * in the x-amz-copy-source, Amazon S3 returns a 404 error, because the object does + * not exist. If you specify versionId in the x-amz-copy-source and the versionId + * is a delete marker, Amazon S3 returns an HTTP 400 error, because you are not allowed to specify + * a delete marker as a version for the x-amz-copy-source.

+ *

You can optionally specify a specific version of the source object to copy by adding the + * versionId subresource as shown in the following example:

+ *

+ * x-amz-copy-source: /bucket/object?versionId=version id + *

+ * + *

+ * Special Errors + *

+ *
    + *
  • + *
      + *
    • + *

      + * Code: NoSuchUpload + *

      + *
    • + *
    • + *

      + * Cause: The specified multipart upload does not exist. The upload + * ID might be invalid, or the multipart upload might have been aborted or + * completed. + *

      + *
    • + *
    • + *

      + * HTTP Status Code: 404 Not Found + *

      + *
    • + *
    + *
  • + *
  • + *
      + *
    • + *

      + * Code: InvalidRequest + *

      + *
    • + *
    • + *

      + * Cause: The specified copy source is not supported as a byte-range + * copy source. + *

      + *
    • + *
    • + *

      + * HTTP Status Code: 400 Bad Request + *

      + *
    • + *
    + *
  • + *
+ * + * + * + * + * + * + *

+ * Related Resources + *

+ * + */ export class UploadPartCopyCommand extends $Command< UploadPartCopyCommandInput, UploadPartCopyCommandOutput, @@ -37,6 +218,9 @@ export class UploadPartCopyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3ClientResolvedConfig, diff --git a/clients/client-s3/package.json b/clients/client-s3/package.json index 3458d348d96c0..452cfa3d3060b 100644 --- a/clients/client-s3/package.json +++ b/clients/client-s3/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript S3 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -81,7 +81,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-s3/pagination/ListObjectsV2Paginator.ts b/clients/client-s3/pagination/ListObjectsV2Paginator.ts index e7d3c74474954..a4a6d12412fc2 100644 --- a/clients/client-s3/pagination/ListObjectsV2Paginator.ts +++ b/clients/client-s3/pagination/ListObjectsV2Paginator.ts @@ -8,6 +8,9 @@ import { import { S3PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: S3Client, input: ListObjectsV2CommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListObjectsV2Command(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: S3, input: ListObjectsV2CommandInput, diff --git a/clients/client-s3/pagination/ListPartsPaginator.ts b/clients/client-s3/pagination/ListPartsPaginator.ts index 369120f78b8ff..b0dcc87fdacab 100644 --- a/clients/client-s3/pagination/ListPartsPaginator.ts +++ b/clients/client-s3/pagination/ListPartsPaginator.ts @@ -4,6 +4,9 @@ import { ListPartsCommand, ListPartsCommandInput, ListPartsCommandOutput } from import { S3PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: S3Client, input: ListPartsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPartsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: S3, input: ListPartsCommandInput, diff --git a/clients/client-s3/runtimeConfig.browser.ts b/clients/client-s3/runtimeConfig.browser.ts index ec4a50bb39137..a83be0bef37aa 100644 --- a/clients/client-s3/runtimeConfig.browser.ts +++ b/clients/client-s3/runtimeConfig.browser.ts @@ -15,6 +15,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./S3Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-s3/runtimeConfig.native.ts b/clients/client-s3/runtimeConfig.native.ts index b943f8f5a50b4..4011cbdb3c47a 100644 --- a/clients/client-s3/runtimeConfig.native.ts +++ b/clients/client-s3/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./S3Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-s3/runtimeConfig.shared.ts b/clients/client-s3/runtimeConfig.shared.ts index 646eb82e4b602..60424a24579e6 100644 --- a/clients/client-s3/runtimeConfig.shared.ts +++ b/clients/client-s3/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2006-03-01", disableHostPrefix: false, diff --git a/clients/client-s3/runtimeConfig.ts b/clients/client-s3/runtimeConfig.ts index 2ed18c296361f..50a05de926d4c 100644 --- a/clients/client-s3/runtimeConfig.ts +++ b/clients/client-s3/runtimeConfig.ts @@ -18,6 +18,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./S3Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-s3/tsconfig.json b/clients/client-s3/tsconfig.json index d0a09bf323180..f994bbf7c065f 100644 --- a/clients/client-s3/tsconfig.json +++ b/clients/client-s3/tsconfig.json @@ -17,13 +17,16 @@ "types": ["mocha", "node"] }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-s3outposts/commands/CreateEndpointCommand.ts b/clients/client-s3outposts/commands/CreateEndpointCommand.ts index 536044fd7a8ca..550374f2e9c46 100644 --- a/clients/client-s3outposts/commands/CreateEndpointCommand.ts +++ b/clients/client-s3outposts/commands/CreateEndpointCommand.ts @@ -20,6 +20,26 @@ import { export type CreateEndpointCommandInput = CreateEndpointRequest; export type CreateEndpointCommandOutput = CreateEndpointResult & __MetadataBearer; +/** + *

S3 on Outposts access points simplify managing data access at scale for shared datasets + * in Amazon S3 on Outposts. S3 on Outposts uses endpoints to connect to Outposts buckets so that you can perform + * actions within your virtual private cloud (VPC).

+ *

This action creates an endpoint and associates it with the specified Outpost.

+ *

+ *

Related actions include:

+ * + */ export class CreateEndpointCommand extends $Command< CreateEndpointCommandInput, CreateEndpointCommandOutput, @@ -34,6 +54,9 @@ export class CreateEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3OutpostsClientResolvedConfig, diff --git a/clients/client-s3outposts/commands/DeleteEndpointCommand.ts b/clients/client-s3outposts/commands/DeleteEndpointCommand.ts index e2d0b9afda5a9..401fbad20a906 100644 --- a/clients/client-s3outposts/commands/DeleteEndpointCommand.ts +++ b/clients/client-s3outposts/commands/DeleteEndpointCommand.ts @@ -20,6 +20,27 @@ import { export type DeleteEndpointCommandInput = DeleteEndpointRequest; export type DeleteEndpointCommandOutput = __MetadataBearer; +/** + *

S3 on Outposts access points simplify managing data access at scale for shared datasets + * in Amazon S3 on Outposts. S3 on Outposts uses endpoints to connect to Outposts buckets so that you can perform + * actions within your virtual private cloud (VPC).

+ *

This action deletes an endpoint. + *

+ *

+ *

Related actions include:

+ * + */ export class DeleteEndpointCommand extends $Command< DeleteEndpointCommandInput, DeleteEndpointCommandOutput, @@ -34,6 +55,9 @@ export class DeleteEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3OutpostsClientResolvedConfig, diff --git a/clients/client-s3outposts/commands/ListEndpointsCommand.ts b/clients/client-s3outposts/commands/ListEndpointsCommand.ts index 40fc2723dba8c..ec6a5c66d1969 100644 --- a/clients/client-s3outposts/commands/ListEndpointsCommand.ts +++ b/clients/client-s3outposts/commands/ListEndpointsCommand.ts @@ -20,6 +20,27 @@ import { export type ListEndpointsCommandInput = ListEndpointsRequest; export type ListEndpointsCommandOutput = ListEndpointsResult & __MetadataBearer; +/** + *

S3 on Outposts access points simplify managing data access at scale for shared datasets + * in Amazon S3 on Outposts. S3 on Outposts uses endpoints to connect to Outposts buckets so that you can perform + * actions within your virtual private cloud (VPC).

+ *

This action lists endpoints associated with the Outpost. + *

+ *

+ *

Related actions include:

+ * + */ export class ListEndpointsCommand extends $Command< ListEndpointsCommandInput, ListEndpointsCommandOutput, @@ -34,6 +55,9 @@ export class ListEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: S3OutpostsClientResolvedConfig, diff --git a/clients/client-s3outposts/package.json b/clients/client-s3outposts/package.json index 8986d6fec15d9..dbf701ffa108f 100644 --- a/clients/client-s3outposts/package.json +++ b/clients/client-s3outposts/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript S3outposts Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-s3outposts/pagination/ListEndpointsPaginator.ts b/clients/client-s3outposts/pagination/ListEndpointsPaginator.ts index 9c760b385eba3..74aa83eec5c68 100644 --- a/clients/client-s3outposts/pagination/ListEndpointsPaginator.ts +++ b/clients/client-s3outposts/pagination/ListEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { S3OutpostsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: S3OutpostsClient, input: ListEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: S3Outposts, input: ListEndpointsCommandInput, diff --git a/clients/client-s3outposts/runtimeConfig.browser.ts b/clients/client-s3outposts/runtimeConfig.browser.ts index f60cf4b99d826..b217d530eaeab 100644 --- a/clients/client-s3outposts/runtimeConfig.browser.ts +++ b/clients/client-s3outposts/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./S3OutpostsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-s3outposts/runtimeConfig.native.ts b/clients/client-s3outposts/runtimeConfig.native.ts index a38e72d20c538..0a755860d14d7 100644 --- a/clients/client-s3outposts/runtimeConfig.native.ts +++ b/clients/client-s3outposts/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./S3OutpostsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-s3outposts/runtimeConfig.shared.ts b/clients/client-s3outposts/runtimeConfig.shared.ts index 61a44647201b3..84d98a6a3fec2 100644 --- a/clients/client-s3outposts/runtimeConfig.shared.ts +++ b/clients/client-s3outposts/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-25", disableHostPrefix: false, diff --git a/clients/client-s3outposts/runtimeConfig.ts b/clients/client-s3outposts/runtimeConfig.ts index db800421f0d54..d739f7bd78d2a 100644 --- a/clients/client-s3outposts/runtimeConfig.ts +++ b/clients/client-s3outposts/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./S3OutpostsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-s3outposts/tsconfig.json b/clients/client-s3outposts/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-s3outposts/tsconfig.json +++ b/clients/client-s3outposts/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sagemaker-a2i-runtime/commands/DeleteHumanLoopCommand.ts b/clients/client-sagemaker-a2i-runtime/commands/DeleteHumanLoopCommand.ts index 528b7846b659d..7d9d44a0a2041 100644 --- a/clients/client-sagemaker-a2i-runtime/commands/DeleteHumanLoopCommand.ts +++ b/clients/client-sagemaker-a2i-runtime/commands/DeleteHumanLoopCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteHumanLoopCommandInput = DeleteHumanLoopRequest; export type DeleteHumanLoopCommandOutput = DeleteHumanLoopResponse & __MetadataBearer; +/** + *

Deletes the specified human loop for a flow definition.

+ */ export class DeleteHumanLoopCommand extends $Command< DeleteHumanLoopCommandInput, DeleteHumanLoopCommandOutput, @@ -38,6 +41,9 @@ export class DeleteHumanLoopCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerA2IRuntimeClientResolvedConfig, diff --git a/clients/client-sagemaker-a2i-runtime/commands/DescribeHumanLoopCommand.ts b/clients/client-sagemaker-a2i-runtime/commands/DescribeHumanLoopCommand.ts index 0e7348493ba42..4e00aed2b59ab 100644 --- a/clients/client-sagemaker-a2i-runtime/commands/DescribeHumanLoopCommand.ts +++ b/clients/client-sagemaker-a2i-runtime/commands/DescribeHumanLoopCommand.ts @@ -24,6 +24,9 @@ import { export type DescribeHumanLoopCommandInput = DescribeHumanLoopRequest; export type DescribeHumanLoopCommandOutput = DescribeHumanLoopResponse & __MetadataBearer; +/** + *

Returns information about the specified human loop.

+ */ export class DescribeHumanLoopCommand extends $Command< DescribeHumanLoopCommandInput, DescribeHumanLoopCommandOutput, @@ -38,6 +41,9 @@ export class DescribeHumanLoopCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerA2IRuntimeClientResolvedConfig, diff --git a/clients/client-sagemaker-a2i-runtime/commands/ListHumanLoopsCommand.ts b/clients/client-sagemaker-a2i-runtime/commands/ListHumanLoopsCommand.ts index b842fbc92c397..c97e3b0d0bce1 100644 --- a/clients/client-sagemaker-a2i-runtime/commands/ListHumanLoopsCommand.ts +++ b/clients/client-sagemaker-a2i-runtime/commands/ListHumanLoopsCommand.ts @@ -24,6 +24,9 @@ import { export type ListHumanLoopsCommandInput = ListHumanLoopsRequest; export type ListHumanLoopsCommandOutput = ListHumanLoopsResponse & __MetadataBearer; +/** + *

Returns information about human loops, given the specified parameters. If a human loop was deleted, it will not be included.

+ */ export class ListHumanLoopsCommand extends $Command< ListHumanLoopsCommandInput, ListHumanLoopsCommandOutput, @@ -38,6 +41,9 @@ export class ListHumanLoopsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerA2IRuntimeClientResolvedConfig, diff --git a/clients/client-sagemaker-a2i-runtime/commands/StartHumanLoopCommand.ts b/clients/client-sagemaker-a2i-runtime/commands/StartHumanLoopCommand.ts index d09f741304570..1d85fe7e863e4 100644 --- a/clients/client-sagemaker-a2i-runtime/commands/StartHumanLoopCommand.ts +++ b/clients/client-sagemaker-a2i-runtime/commands/StartHumanLoopCommand.ts @@ -24,6 +24,9 @@ import { export type StartHumanLoopCommandInput = StartHumanLoopRequest; export type StartHumanLoopCommandOutput = StartHumanLoopResponse & __MetadataBearer; +/** + *

Starts a human loop, provided that at least one activation condition is met.

+ */ export class StartHumanLoopCommand extends $Command< StartHumanLoopCommandInput, StartHumanLoopCommandOutput, @@ -38,6 +41,9 @@ export class StartHumanLoopCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerA2IRuntimeClientResolvedConfig, diff --git a/clients/client-sagemaker-a2i-runtime/commands/StopHumanLoopCommand.ts b/clients/client-sagemaker-a2i-runtime/commands/StopHumanLoopCommand.ts index 9ba9faf0c77b1..aa896e27a54c8 100644 --- a/clients/client-sagemaker-a2i-runtime/commands/StopHumanLoopCommand.ts +++ b/clients/client-sagemaker-a2i-runtime/commands/StopHumanLoopCommand.ts @@ -24,6 +24,9 @@ import { export type StopHumanLoopCommandInput = StopHumanLoopRequest; export type StopHumanLoopCommandOutput = StopHumanLoopResponse & __MetadataBearer; +/** + *

Stops the specified human loop.

+ */ export class StopHumanLoopCommand extends $Command< StopHumanLoopCommandInput, StopHumanLoopCommandOutput, @@ -38,6 +41,9 @@ export class StopHumanLoopCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerA2IRuntimeClientResolvedConfig, diff --git a/clients/client-sagemaker-a2i-runtime/package.json b/clients/client-sagemaker-a2i-runtime/package.json index 3764f44111ecf..7a8f90b1a8baf 100644 --- a/clients/client-sagemaker-a2i-runtime/package.json +++ b/clients/client-sagemaker-a2i-runtime/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sagemaker A2i Runtime Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sagemaker-a2i-runtime/pagination/ListHumanLoopsPaginator.ts b/clients/client-sagemaker-a2i-runtime/pagination/ListHumanLoopsPaginator.ts index bdec48fe68eb8..8058cd05cc6d5 100644 --- a/clients/client-sagemaker-a2i-runtime/pagination/ListHumanLoopsPaginator.ts +++ b/clients/client-sagemaker-a2i-runtime/pagination/ListHumanLoopsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerA2IRuntimePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerA2IRuntimeClient, input: ListHumanLoopsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHumanLoopsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMakerA2IRuntime, input: ListHumanLoopsCommandInput, diff --git a/clients/client-sagemaker-a2i-runtime/runtimeConfig.browser.ts b/clients/client-sagemaker-a2i-runtime/runtimeConfig.browser.ts index 2c3e12c8c0d19..23050f3ab0a3c 100644 --- a/clients/client-sagemaker-a2i-runtime/runtimeConfig.browser.ts +++ b/clients/client-sagemaker-a2i-runtime/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SageMakerA2IRuntimeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sagemaker-a2i-runtime/runtimeConfig.native.ts b/clients/client-sagemaker-a2i-runtime/runtimeConfig.native.ts index 3454b06413415..49248f418db66 100644 --- a/clients/client-sagemaker-a2i-runtime/runtimeConfig.native.ts +++ b/clients/client-sagemaker-a2i-runtime/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SageMakerA2IRuntimeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sagemaker-a2i-runtime/runtimeConfig.shared.ts b/clients/client-sagemaker-a2i-runtime/runtimeConfig.shared.ts index b000a17f3feba..635613f9b7f4c 100644 --- a/clients/client-sagemaker-a2i-runtime/runtimeConfig.shared.ts +++ b/clients/client-sagemaker-a2i-runtime/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-11-07", disableHostPrefix: false, diff --git a/clients/client-sagemaker-a2i-runtime/runtimeConfig.ts b/clients/client-sagemaker-a2i-runtime/runtimeConfig.ts index 2858debfdc653..6df54fcbdcf69 100644 --- a/clients/client-sagemaker-a2i-runtime/runtimeConfig.ts +++ b/clients/client-sagemaker-a2i-runtime/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SageMakerA2IRuntimeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sagemaker-a2i-runtime/tsconfig.json b/clients/client-sagemaker-a2i-runtime/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sagemaker-a2i-runtime/tsconfig.json +++ b/clients/client-sagemaker-a2i-runtime/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sagemaker-runtime/commands/InvokeEndpointCommand.ts b/clients/client-sagemaker-runtime/commands/InvokeEndpointCommand.ts index 4928dfa6e5cb5..a085f1a46ec31 100644 --- a/clients/client-sagemaker-runtime/commands/InvokeEndpointCommand.ts +++ b/clients/client-sagemaker-runtime/commands/InvokeEndpointCommand.ts @@ -20,6 +20,27 @@ import { export type InvokeEndpointCommandInput = InvokeEndpointInput; export type InvokeEndpointCommandOutput = InvokeEndpointOutput & __MetadataBearer; +/** + *

After you deploy a model into production using Amazon SageMaker hosting services, your + * client applications use this API to get inferences from the model hosted at the + * specified endpoint.

+ *

For an overview of Amazon SageMaker, see How It Works.

+ *

Amazon SageMaker strips all POST headers except those supported by the API. Amazon SageMaker might add + * additional headers. You should not rely on the behavior of headers outside those + * enumerated in the request syntax.

+ *

Calls to InvokeEndpoint are authenticated by using AWS Signature Version + * 4. For information, see Authenticating Requests (AWS Signature Version 4) in the Amazon S3 API + * Reference.

+ *

A customer's model containers must respond to requests within 60 seconds. The model + * itself can have a maximum processing time of 60 seconds before responding to the + * /invocations. If your model is going to take 50-60 seconds of processing time, the SDK + * socket timeout should be set to be 70 seconds.

+ * + *

Endpoints are scoped to an individual account, and are not public. The URL does + * not contain the account ID, but Amazon SageMaker determines the account ID from the + * authentication token that is supplied by the caller.

+ *
+ */ export class InvokeEndpointCommand extends $Command< InvokeEndpointCommandInput, InvokeEndpointCommandOutput, @@ -34,6 +55,9 @@ export class InvokeEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerRuntimeClientResolvedConfig, diff --git a/clients/client-sagemaker-runtime/package.json b/clients/client-sagemaker-runtime/package.json index fbd90bc4e86c7..c79b3eef36188 100644 --- a/clients/client-sagemaker-runtime/package.json +++ b/clients/client-sagemaker-runtime/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sagemaker Runtime Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sagemaker-runtime/runtimeConfig.browser.ts b/clients/client-sagemaker-runtime/runtimeConfig.browser.ts index 9d73c4f3b71d4..1e315907d27d1 100644 --- a/clients/client-sagemaker-runtime/runtimeConfig.browser.ts +++ b/clients/client-sagemaker-runtime/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SageMakerRuntimeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sagemaker-runtime/runtimeConfig.native.ts b/clients/client-sagemaker-runtime/runtimeConfig.native.ts index 3e0f2918b166c..2261c4f642faa 100644 --- a/clients/client-sagemaker-runtime/runtimeConfig.native.ts +++ b/clients/client-sagemaker-runtime/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SageMakerRuntimeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sagemaker-runtime/runtimeConfig.shared.ts b/clients/client-sagemaker-runtime/runtimeConfig.shared.ts index d4638d4daefc4..d5b73967bdb7b 100644 --- a/clients/client-sagemaker-runtime/runtimeConfig.shared.ts +++ b/clients/client-sagemaker-runtime/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-05-13", disableHostPrefix: false, diff --git a/clients/client-sagemaker-runtime/runtimeConfig.ts b/clients/client-sagemaker-runtime/runtimeConfig.ts index 7108d4c0c99bc..66eeb877f6c0f 100644 --- a/clients/client-sagemaker-runtime/runtimeConfig.ts +++ b/clients/client-sagemaker-runtime/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SageMakerRuntimeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sagemaker-runtime/tsconfig.json b/clients/client-sagemaker-runtime/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sagemaker-runtime/tsconfig.json +++ b/clients/client-sagemaker-runtime/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sagemaker/commands/AddTagsCommand.ts b/clients/client-sagemaker/commands/AddTagsCommand.ts index 07e948ec39694..3f81f523f8e0e 100644 --- a/clients/client-sagemaker/commands/AddTagsCommand.ts +++ b/clients/client-sagemaker/commands/AddTagsCommand.ts @@ -17,6 +17,25 @@ import { export type AddTagsCommandInput = AddTagsInput; export type AddTagsCommandOutput = AddTagsOutput & __MetadataBearer; +/** + *

Adds or overwrites one or more tags for the specified Amazon SageMaker resource. You can add + * tags to notebook instances, training jobs, hyperparameter tuning jobs, batch transform + * jobs, models, labeling jobs, work teams, endpoint configurations, and + * endpoints.

+ *

Each tag consists of a key and an optional value. Tag keys must be unique per + * resource. For more information about tags, see For more information, see AWS + * Tagging Strategies.

+ * + *

Tags that you add to a hyperparameter tuning job by calling this API are also + * added to any training jobs that the hyperparameter tuning job launches after you + * call this API, but not to training jobs that the hyperparameter tuning job launched + * before you called this API. To make sure that the tags associated with a + * hyperparameter tuning job are also added to all training jobs that the + * hyperparameter tuning job launches, add the tags when you first create the tuning + * job by specifying them in the Tags parameter of CreateHyperParameterTuningJob + *

+ *
+ */ export class AddTagsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +46,9 @@ export class AddTagsCommand extends $Command, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/AssociateTrialComponentCommand.ts b/clients/client-sagemaker/commands/AssociateTrialComponentCommand.ts index 515865884a842..2e5407d238d2c 100644 --- a/clients/client-sagemaker/commands/AssociateTrialComponentCommand.ts +++ b/clients/client-sagemaker/commands/AssociateTrialComponentCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateTrialComponentCommandInput = AssociateTrialComponentRequest; export type AssociateTrialComponentCommandOutput = AssociateTrialComponentResponse & __MetadataBearer; +/** + *

Associates a trial component with a trial. A trial component can be associated with + * multiple trials. To disassociate a trial component from a trial, call the DisassociateTrialComponent API.

+ */ export class AssociateTrialComponentCommand extends $Command< AssociateTrialComponentCommandInput, AssociateTrialComponentCommandOutput, @@ -34,6 +38,9 @@ export class AssociateTrialComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateAlgorithmCommand.ts b/clients/client-sagemaker/commands/CreateAlgorithmCommand.ts index 958eb2140d152..04acafe8b94d1 100644 --- a/clients/client-sagemaker/commands/CreateAlgorithmCommand.ts +++ b/clients/client-sagemaker/commands/CreateAlgorithmCommand.ts @@ -20,6 +20,10 @@ import { export type CreateAlgorithmCommandInput = CreateAlgorithmInput; export type CreateAlgorithmCommandOutput = CreateAlgorithmOutput & __MetadataBearer; +/** + *

Create a machine learning algorithm that you can use in Amazon SageMaker and list in the AWS + * Marketplace.

+ */ export class CreateAlgorithmCommand extends $Command< CreateAlgorithmCommandInput, CreateAlgorithmCommandOutput, @@ -34,6 +38,9 @@ export class CreateAlgorithmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateAppCommand.ts b/clients/client-sagemaker/commands/CreateAppCommand.ts index 2fc3a9c743c71..a501f97725dae 100644 --- a/clients/client-sagemaker/commands/CreateAppCommand.ts +++ b/clients/client-sagemaker/commands/CreateAppCommand.ts @@ -17,6 +17,14 @@ import { export type CreateAppCommandInput = CreateAppRequest; export type CreateAppCommandOutput = CreateAppResponse & __MetadataBearer; +/** + *

Creates a running App for the specified UserProfile. Supported Apps are JupyterServer + * + * and KernelGateway. This operation is automatically invoked by Amazon SageMaker Studio + * upon access to the associated Domain, and when new kernel configurations are selected by the user. + * + * A user may have multiple Apps active simultaneously.

+ */ export class CreateAppCommand extends $Command< CreateAppCommandInput, CreateAppCommandOutput, @@ -31,6 +39,9 @@ export class CreateAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateAppImageConfigCommand.ts b/clients/client-sagemaker/commands/CreateAppImageConfigCommand.ts index 1bd68a5b69031..37134035f3c02 100644 --- a/clients/client-sagemaker/commands/CreateAppImageConfigCommand.ts +++ b/clients/client-sagemaker/commands/CreateAppImageConfigCommand.ts @@ -20,6 +20,11 @@ import { export type CreateAppImageConfigCommandInput = CreateAppImageConfigRequest; export type CreateAppImageConfigCommandOutput = CreateAppImageConfigResponse & __MetadataBearer; +/** + *

Creates a configuration for running a SageMaker image as a KernelGateway app. The + * configuration specifies the Amazon Elastic File System (EFS) storage volume on the image, and a list of the + * kernels in the image.

+ */ export class CreateAppImageConfigCommand extends $Command< CreateAppImageConfigCommandInput, CreateAppImageConfigCommandOutput, @@ -34,6 +39,9 @@ export class CreateAppImageConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateAutoMLJobCommand.ts b/clients/client-sagemaker/commands/CreateAutoMLJobCommand.ts index f8748dc1c112f..091288916a824 100644 --- a/clients/client-sagemaker/commands/CreateAutoMLJobCommand.ts +++ b/clients/client-sagemaker/commands/CreateAutoMLJobCommand.ts @@ -20,6 +20,14 @@ import { export type CreateAutoMLJobCommandInput = CreateAutoMLJobRequest; export type CreateAutoMLJobCommandOutput = CreateAutoMLJobResponse & __MetadataBearer; +/** + *

Creates an Autopilot job.

+ *

Find the best performing model after you run an Autopilot job by calling . Deploy that model by following the steps described in + * Step 6.1: + * Deploy the Model to Amazon SageMaker Hosting Services.

+ *

For information about how to use Autopilot, see Automate Model + * Development with Amazon SageMaker Autopilot.

+ */ export class CreateAutoMLJobCommand extends $Command< CreateAutoMLJobCommandInput, CreateAutoMLJobCommandOutput, @@ -34,6 +42,9 @@ export class CreateAutoMLJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateCodeRepositoryCommand.ts b/clients/client-sagemaker/commands/CreateCodeRepositoryCommand.ts index cfcd564f57efd..c053205e7650f 100644 --- a/clients/client-sagemaker/commands/CreateCodeRepositoryCommand.ts +++ b/clients/client-sagemaker/commands/CreateCodeRepositoryCommand.ts @@ -20,6 +20,15 @@ import { export type CreateCodeRepositoryCommandInput = CreateCodeRepositoryInput; export type CreateCodeRepositoryCommandOutput = CreateCodeRepositoryOutput & __MetadataBearer; +/** + *

Creates a Git repository as a resource in your Amazon SageMaker account. You can associate the + * repository with notebook instances so that you can use Git source control for the + * notebooks you create. The Git repository is a resource in your Amazon SageMaker account, so it can + * be associated with more than one notebook instance, and it persists independently from + * the lifecycle of any notebook instances it is associated with.

+ *

The repository can be hosted either in AWS CodeCommit or in any + * other Git repository.

+ */ export class CreateCodeRepositoryCommand extends $Command< CreateCodeRepositoryCommandInput, CreateCodeRepositoryCommandOutput, @@ -34,6 +43,9 @@ export class CreateCodeRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateCompilationJobCommand.ts b/clients/client-sagemaker/commands/CreateCompilationJobCommand.ts index 5318376f36859..0e617f879a450 100644 --- a/clients/client-sagemaker/commands/CreateCompilationJobCommand.ts +++ b/clients/client-sagemaker/commands/CreateCompilationJobCommand.ts @@ -20,6 +20,40 @@ import { export type CreateCompilationJobCommandInput = CreateCompilationJobRequest; export type CreateCompilationJobCommandOutput = CreateCompilationJobResponse & __MetadataBearer; +/** + *

Starts a model compilation job. After the model has been compiled, Amazon SageMaker saves the + * resulting model artifacts to an Amazon Simple Storage Service (Amazon S3) bucket that you specify.

+ *

If + * you choose to host your model using Amazon SageMaker hosting services, you can use the resulting + * model artifacts as part of the model. You can also use the artifacts with + * AWS + * IoT Greengrass. In that case, deploy them as an ML + * resource.

+ *

In the request body, you provide the following:

+ *
    + *
  • + *

    A name for the compilation job

    + *
  • + *
  • + *

    Information about the input model artifacts

    + *
  • + *
  • + *

    The output location for the compiled model and the device (target) that the + * model runs on

    + *
  • + *
  • + *

    The Amazon Resource Name (ARN) of the IAM role that Amazon SageMaker assumes to perform + * the model compilation job.

    + *
  • + *
+ *

You can also provide a Tag to track the model compilation job's resource + * use and costs. The response body contains the + * CompilationJobArn + * for the compiled job.

+ *

To stop a model compilation job, use StopCompilationJob. To get + * information about a particular model compilation job, use DescribeCompilationJob. To get information about multiple model + * compilation jobs, use ListCompilationJobs.

+ */ export class CreateCompilationJobCommand extends $Command< CreateCompilationJobCommandInput, CreateCompilationJobCommandOutput, @@ -34,6 +68,9 @@ export class CreateCompilationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateDomainCommand.ts b/clients/client-sagemaker/commands/CreateDomainCommand.ts index 8a8c3e51f83bf..68dbadfa93469 100644 --- a/clients/client-sagemaker/commands/CreateDomainCommand.ts +++ b/clients/client-sagemaker/commands/CreateDomainCommand.ts @@ -20,6 +20,41 @@ import { export type CreateDomainCommandInput = CreateDomainRequest; export type CreateDomainCommandOutput = CreateDomainResponse & __MetadataBearer; +/** + *

Creates a Domain used by Amazon SageMaker Studio. A domain consists of an associated + * Amazon Elastic File System (EFS) volume, a list of authorized users, and a variety of security, application, + * policy, and Amazon Virtual Private Cloud (VPC) configurations. An AWS account is limited to one domain per region. + * Users within a domain can share notebook files and other artifacts with each other.

+ *

When a domain is created, an EFS volume is created for use by all of the users within the + * domain. Each user receives a private home directory within the EFS volume for notebooks, + * Git repositories, and data files.

+ *

+ * VPC configuration + *

+ *

All SageMaker Studio traffic between the domain and the EFS volume is through the specified + * VPC and subnets. For other Studio traffic, you can specify the AppNetworkAccessType + * parameter. AppNetworkAccessType corresponds to the network access type that you + * choose when you onboard to Studio. The following options are available:

+ *
    + *
  • + *

    + * PublicInternetOnly - Non-EFS traffic goes through a VPC managed by + * Amazon SageMaker, which allows internet access. This is the default value.

    + *
  • + *
  • + *

    + * VpcOnly - All Studio traffic is through the specified VPC and subnets. + * Internet access is disabled by default. To allow internet access, you must specify a + * NAT gateway.

    + *

    When internet access is disabled, you won't be able to run a Studio notebook or to + * train or host models unless your VPC has an interface endpoint to the SageMaker API and runtime + * or a NAT gateway and your security groups allow outbound connections.

    + *
  • + *
+ *

For more information, see + * Connect + * SageMaker Studio Notebooks to Resources in a VPC.

+ */ export class CreateDomainCommand extends $Command< CreateDomainCommandInput, CreateDomainCommandOutput, @@ -34,6 +69,9 @@ export class CreateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateEndpointCommand.ts b/clients/client-sagemaker/commands/CreateEndpointCommand.ts index fa0c2f6354f0a..1ce5d23e4df25 100644 --- a/clients/client-sagemaker/commands/CreateEndpointCommand.ts +++ b/clients/client-sagemaker/commands/CreateEndpointCommand.ts @@ -20,6 +20,85 @@ import { export type CreateEndpointCommandInput = CreateEndpointInput; export type CreateEndpointCommandOutput = CreateEndpointOutput & __MetadataBearer; +/** + *

Creates an endpoint using the endpoint configuration specified in the request. Amazon SageMaker + * uses the endpoint to provision resources and deploy models. You create the endpoint + * configuration with the CreateEndpointConfig API.

+ *

Use this API to deploy models using Amazon SageMaker hosting services.

+ *

For an example that calls this method when deploying a model to Amazon SageMaker hosting services, + * see Deploy the + * Model to Amazon SageMaker Hosting Services (AWS SDK for Python (Boto + * 3)). + *

+ * + *

You must not delete an EndpointConfig that is in use by an endpoint + * that is live or while the UpdateEndpoint or CreateEndpoint + * operations are being performed on the endpoint. To update an endpoint, you must + * create a new EndpointConfig.

+ *
+ *

The endpoint name must be unique within an AWS Region in your AWS account.

+ *

When it receives the request, Amazon SageMaker creates the endpoint, launches the resources (ML + * compute instances), and deploys the model(s) on them.

+ * + * + *

When you call CreateEndpoint, a load call is made to DynamoDB to + * verify that your endpoint configuration exists. When you read data from a DynamoDB + * table supporting + * Eventually Consistent Reads + * , the response might not + * reflect the results of a recently completed write operation. The response might + * include some stale data. If the dependent entities are not yet in DynamoDB, this + * causes a validation error. If you repeat your read request after a short time, the + * response should return the latest data. So retry logic is recommended to handle + * these possible issues. We also recommend that customers call DescribeEndpointConfig before calling CreateEndpoint to minimize the potential impact of a DynamoDB eventually consistent read.

+ *
+ *

When Amazon SageMaker receives the request, it sets the endpoint status to + * Creating. After it creates the endpoint, it sets the status to + * InService. Amazon SageMaker can then process incoming requests for inferences. To + * check the status of an endpoint, use the DescribeEndpoint + * API.

+ *

If any of the models hosted at this endpoint get model data from an Amazon S3 location, + * Amazon SageMaker uses AWS Security Token Service to download model artifacts from the S3 path you + * provided. AWS STS is activated in your IAM user account by default. If you previously + * deactivated AWS STS for a region, you need to reactivate AWS STS for that region. For + * more information, see Activating and + * Deactivating AWS STS in an AWS Region in the AWS Identity and Access Management User + * Guide.

+ * + *

+ * To add the IAM role policies for using this API operation, + * go to the IAM console, and + * choose Roles in the left navigation pane. Search the IAM role that you want to grant access to use + * the CreateEndpoint and CreateEndpointConfig API operations, add the following policies to the role. + *

+ *
    + *
  • + *

    Option 1: For a full Amazon SageMaker access, search and attach the AmazonSageMakerFullAccess policy.

    + *
  • + *
  • + *

    Option 2: For granting a limited access to an IAM role, + * paste the following Action elements manually into the JSON file of the IAM role:

    + *

    + * "Action": ["sagemaker:CreateEndpoint", "sagemaker:CreateEndpointConfig"] + *

    + *

    + * "Resource": [ + *

    + *

    + * "arn:aws:sagemaker:region:account-id:endpoint/endpointName" + *

    + *

    + * "arn:aws:sagemaker:region:account-id:endpoint-config/endpointConfigName" + *

    + *

    + * ] + *

    + *

    For more information, see Amazon SageMaker API Permissions: Actions, Permissions, and Resources Reference.

    + *
  • + *
+ * + *
+ */ export class CreateEndpointCommand extends $Command< CreateEndpointCommandInput, CreateEndpointCommandOutput, @@ -34,6 +113,9 @@ export class CreateEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateEndpointConfigCommand.ts b/clients/client-sagemaker/commands/CreateEndpointConfigCommand.ts index 082324267c8cd..1ba3d68ad7ea1 100644 --- a/clients/client-sagemaker/commands/CreateEndpointConfigCommand.ts +++ b/clients/client-sagemaker/commands/CreateEndpointConfigCommand.ts @@ -20,6 +20,42 @@ import { export type CreateEndpointConfigCommandInput = CreateEndpointConfigInput; export type CreateEndpointConfigCommandOutput = CreateEndpointConfigOutput & __MetadataBearer; +/** + *

Creates an endpoint configuration that Amazon SageMaker hosting services uses to deploy models. In + * the configuration, you identify one or more models, created using the + * CreateModel API, to deploy and the resources that you want Amazon SageMaker to + * provision. Then you call the CreateEndpoint API.

+ * + *

Use this API if you want to use Amazon SageMaker hosting services to deploy models into + * production.

+ *
+ *

In the request, you define a ProductionVariant, for each model that you + * want to deploy. Each ProductionVariant parameter also describes the + * resources that you want Amazon SageMaker to provision. This includes the number and type of ML + * compute instances to deploy.

+ *

If you are hosting multiple models, you also assign a VariantWeight to + * specify how much traffic you want to allocate to each model. For example, suppose that + * you want to host two models, A and B, and you assign traffic weight 2 for model A and 1 + * for model B. Amazon SageMaker distributes two-thirds of the traffic to Model A, and one-third to + * model B.

+ *

For an example that calls this method when deploying a model to Amazon SageMaker hosting services, + * see Deploy the + * Model to Amazon SageMaker Hosting Services (AWS SDK for Python (Boto + * 3)). + *

+ * + *

When you call CreateEndpoint, a load call is made to DynamoDB to + * verify that your endpoint configuration exists. When you read data from a DynamoDB + * table supporting + * Eventually Consistent Reads + * , the response might not + * reflect the results of a recently completed write operation. The response might + * include some stale data. If the dependent entities are not yet in DynamoDB, this + * causes a validation error. If you repeat your read request after a short time, the + * response should return the latest data. So retry logic is recommended to handle + * these possible issues. We also recommend that customers call DescribeEndpointConfig before calling CreateEndpoint to minimize the potential impact of a DynamoDB eventually consistent read.

+ *
+ */ export class CreateEndpointConfigCommand extends $Command< CreateEndpointConfigCommandInput, CreateEndpointConfigCommandOutput, @@ -34,6 +70,9 @@ export class CreateEndpointConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateExperimentCommand.ts b/clients/client-sagemaker/commands/CreateExperimentCommand.ts index 47ab7c030d540..0fe9e78acd392 100644 --- a/clients/client-sagemaker/commands/CreateExperimentCommand.ts +++ b/clients/client-sagemaker/commands/CreateExperimentCommand.ts @@ -20,6 +20,25 @@ import { export type CreateExperimentCommandInput = CreateExperimentRequest; export type CreateExperimentCommandOutput = CreateExperimentResponse & __MetadataBearer; +/** + *

Creates an SageMaker experiment. An experiment is a collection of + * trials that are observed, compared and evaluated as a group. A trial is + * a set of steps, called trial components, that produce a machine learning + * model.

+ *

The goal of an experiment is to determine the components that produce the best model. + * Multiple trials are performed, each one isolating and measuring the impact of a change to one + * or more inputs, while keeping the remaining inputs constant.

+ *

When you use Amazon SageMaker Studio or the Amazon SageMaker Python SDK, all experiments, trials, and trial + * components are automatically tracked, logged, and indexed. When you use the AWS SDK for Python (Boto), you + * must use the logging APIs provided by the SDK.

+ *

You can add tags to experiments, trials, trial components and then use the Search API to search for the tags.

+ *

To add a description to an experiment, specify the optional Description + * parameter. To add a description later, or to change the description, call the UpdateExperiment API.

+ *

To get a list of all your experiments, call the ListExperiments API. To + * view an experiment's properties, call the DescribeExperiment API. To get a + * list of all the trials associated with an experiment, call the ListTrials + * API. To create a trial call the CreateTrial API.

+ */ export class CreateExperimentCommand extends $Command< CreateExperimentCommandInput, CreateExperimentCommandOutput, @@ -34,6 +53,9 @@ export class CreateExperimentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateFlowDefinitionCommand.ts b/clients/client-sagemaker/commands/CreateFlowDefinitionCommand.ts index d99323fc7bcc0..2702c0d9669fb 100644 --- a/clients/client-sagemaker/commands/CreateFlowDefinitionCommand.ts +++ b/clients/client-sagemaker/commands/CreateFlowDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFlowDefinitionCommandInput = CreateFlowDefinitionRequest; export type CreateFlowDefinitionCommandOutput = CreateFlowDefinitionResponse & __MetadataBearer; +/** + *

Creates a flow definition.

+ */ export class CreateFlowDefinitionCommand extends $Command< CreateFlowDefinitionCommandInput, CreateFlowDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class CreateFlowDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateHumanTaskUiCommand.ts b/clients/client-sagemaker/commands/CreateHumanTaskUiCommand.ts index c4017c78b27ea..b48b51ebc497e 100644 --- a/clients/client-sagemaker/commands/CreateHumanTaskUiCommand.ts +++ b/clients/client-sagemaker/commands/CreateHumanTaskUiCommand.ts @@ -20,6 +20,9 @@ import { export type CreateHumanTaskUiCommandInput = CreateHumanTaskUiRequest; export type CreateHumanTaskUiCommandOutput = CreateHumanTaskUiResponse & __MetadataBearer; +/** + *

Defines the settings you will use for the human review workflow user interface. Reviewers will see a three-panel interface with an instruction area, the item to review, and an input area.

+ */ export class CreateHumanTaskUiCommand extends $Command< CreateHumanTaskUiCommandInput, CreateHumanTaskUiCommandOutput, @@ -34,6 +37,9 @@ export class CreateHumanTaskUiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateHyperParameterTuningJobCommand.ts b/clients/client-sagemaker/commands/CreateHyperParameterTuningJobCommand.ts index 210985a6d920e..0d25eb4df197b 100644 --- a/clients/client-sagemaker/commands/CreateHyperParameterTuningJobCommand.ts +++ b/clients/client-sagemaker/commands/CreateHyperParameterTuningJobCommand.ts @@ -20,6 +20,13 @@ import { export type CreateHyperParameterTuningJobCommandInput = CreateHyperParameterTuningJobRequest; export type CreateHyperParameterTuningJobCommandOutput = CreateHyperParameterTuningJobResponse & __MetadataBearer; +/** + *

Starts a hyperparameter tuning job. A hyperparameter tuning job finds the best version + * of a model by running many training jobs on your dataset using the algorithm you choose + * and values for hyperparameters within ranges that you specify. It then chooses the + * hyperparameter values that result in a model that performs the best, as measured by an + * objective metric that you choose.

+ */ export class CreateHyperParameterTuningJobCommand extends $Command< CreateHyperParameterTuningJobCommandInput, CreateHyperParameterTuningJobCommandOutput, @@ -34,6 +41,9 @@ export class CreateHyperParameterTuningJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateImageCommand.ts b/clients/client-sagemaker/commands/CreateImageCommand.ts index 45176c97d37ff..99b1827da92b4 100644 --- a/clients/client-sagemaker/commands/CreateImageCommand.ts +++ b/clients/client-sagemaker/commands/CreateImageCommand.ts @@ -20,6 +20,11 @@ import { export type CreateImageCommandInput = CreateImageRequest; export type CreateImageCommandOutput = CreateImageResponse & __MetadataBearer; +/** + *

Creates a custom SageMaker image. A SageMaker image is a set of image versions. Each image + * version represents a container image stored in Amazon Container Registry (ECR). For more information, see + * Bring your own SageMaker image.

+ */ export class CreateImageCommand extends $Command< CreateImageCommandInput, CreateImageCommandOutput, @@ -34,6 +39,9 @@ export class CreateImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateImageVersionCommand.ts b/clients/client-sagemaker/commands/CreateImageVersionCommand.ts index 92436bd39b245..3d36c0a43dd52 100644 --- a/clients/client-sagemaker/commands/CreateImageVersionCommand.ts +++ b/clients/client-sagemaker/commands/CreateImageVersionCommand.ts @@ -20,6 +20,10 @@ import { export type CreateImageVersionCommandInput = CreateImageVersionRequest; export type CreateImageVersionCommandOutput = CreateImageVersionResponse & __MetadataBearer; +/** + *

Creates a version of the SageMaker image specified by ImageName. The version + * represents the Amazon Container Registry (ECR) container image specified by BaseImage.

+ */ export class CreateImageVersionCommand extends $Command< CreateImageVersionCommandInput, CreateImageVersionCommandOutput, @@ -34,6 +38,9 @@ export class CreateImageVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateLabelingJobCommand.ts b/clients/client-sagemaker/commands/CreateLabelingJobCommand.ts index 819bfad806af3..629a8b2a67725 100644 --- a/clients/client-sagemaker/commands/CreateLabelingJobCommand.ts +++ b/clients/client-sagemaker/commands/CreateLabelingJobCommand.ts @@ -20,6 +20,37 @@ import { export type CreateLabelingJobCommandInput = CreateLabelingJobRequest; export type CreateLabelingJobCommandOutput = CreateLabelingJobResponse & __MetadataBearer; +/** + *

Creates a job that uses workers to label the data objects in your input dataset. You + * can use the labeled data to train machine learning models.

+ *

You can select your workforce from one of three providers:

+ *
    + *
  • + *

    A private workforce that you create. It can include employees, contractors, + * and outside experts. Use a private workforce when want the data to stay within + * your organization or when a specific set of skills is required.

    + *
  • + *
  • + *

    One or more vendors that you select from the AWS Marketplace. Vendors provide + * expertise in specific areas.

    + *
  • + *
  • + *

    The Amazon Mechanical Turk workforce. This is the largest workforce, but it + * should only be used for public data or data that has been stripped of any + * personally identifiable information.

    + *
  • + *
+ *

You can also use automated data labeling to reduce the number of + * data objects that need to be labeled by a human. Automated data labeling uses + * active learning to determine if a data object can be labeled by + * machine or if it needs to be sent to a human worker. For more information, see Using + * Automated Data Labeling.

+ *

The data objects to be labeled are contained in an Amazon S3 bucket. You create a + * manifest file that describes the location of each object. For + * more information, see Using Input and Output Data.

+ *

The output can be used as the manifest file for another labeling job or as training + * data for your machine learning models.

+ */ export class CreateLabelingJobCommand extends $Command< CreateLabelingJobCommandInput, CreateLabelingJobCommandOutput, @@ -34,6 +65,9 @@ export class CreateLabelingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateModelCommand.ts b/clients/client-sagemaker/commands/CreateModelCommand.ts index 653cb1ce7a1fe..343a23b3fbd66 100644 --- a/clients/client-sagemaker/commands/CreateModelCommand.ts +++ b/clients/client-sagemaker/commands/CreateModelCommand.ts @@ -20,6 +20,34 @@ import { export type CreateModelCommandInput = CreateModelInput; export type CreateModelCommandOutput = CreateModelOutput & __MetadataBearer; +/** + *

Creates a model in Amazon SageMaker. In the request, you name the model and describe a primary + * container. For the primary container, + * you specify the Docker image that contains inference code, artifacts (from prior + * training), and a custom environment map that the inference code uses when you deploy the + * model for predictions.

+ *

Use this API to create a model if you want to use Amazon SageMaker hosting services or run a batch + * transform job.

+ *

To host your model, you create an endpoint configuration with the + * CreateEndpointConfig API, and then create an endpoint with the + * CreateEndpoint API. Amazon SageMaker then deploys all of the containers that you + * defined for the model in the hosting environment.

+ *

For an example that calls this method when deploying a model to Amazon SageMaker hosting services, + * see Deploy the + * Model to Amazon SageMaker Hosting Services (AWS SDK for Python (Boto + * 3)). + *

+ *

To run a batch transform using your model, you start a job with the + * CreateTransformJob API. Amazon SageMaker uses your model and your dataset to get + * inferences which are then saved to a specified S3 location.

+ *

In the CreateModel request, you must define a container with the + * PrimaryContainer parameter.

+ *

In the request, you also provide an IAM role that Amazon SageMaker can assume to access model + * artifacts and docker image for deployment on ML compute hosting instances or for batch + * transform jobs. In addition, you also use the IAM role to manage permissions the + * inference code needs. For example, if the inference code access any other AWS resources, + * you grant necessary permissions via this role.

+ */ export class CreateModelCommand extends $Command< CreateModelCommandInput, CreateModelCommandOutput, @@ -34,6 +62,9 @@ export class CreateModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateModelPackageCommand.ts b/clients/client-sagemaker/commands/CreateModelPackageCommand.ts index a55f32fed290f..cf43770661466 100644 --- a/clients/client-sagemaker/commands/CreateModelPackageCommand.ts +++ b/clients/client-sagemaker/commands/CreateModelPackageCommand.ts @@ -20,6 +20,16 @@ import { export type CreateModelPackageCommandInput = CreateModelPackageInput; export type CreateModelPackageCommandOutput = CreateModelPackageOutput & __MetadataBearer; +/** + *

Creates a model package that you can use to create Amazon SageMaker models or list on AWS + * Marketplace. Buyers can subscribe to model packages listed on AWS Marketplace to create + * models in Amazon SageMaker.

+ *

To create a model package by specifying a Docker container that contains your + * inference code and the Amazon S3 location of your model artifacts, provide values for + * InferenceSpecification. To create a model from an algorithm resource + * that you created or subscribed to in AWS Marketplace, provide a value for + * SourceAlgorithmSpecification.

+ */ export class CreateModelPackageCommand extends $Command< CreateModelPackageCommandInput, CreateModelPackageCommandOutput, @@ -34,6 +44,9 @@ export class CreateModelPackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateMonitoringScheduleCommand.ts b/clients/client-sagemaker/commands/CreateMonitoringScheduleCommand.ts index a895383c4d18e..de2ed9ef52178 100644 --- a/clients/client-sagemaker/commands/CreateMonitoringScheduleCommand.ts +++ b/clients/client-sagemaker/commands/CreateMonitoringScheduleCommand.ts @@ -20,6 +20,10 @@ import { export type CreateMonitoringScheduleCommandInput = CreateMonitoringScheduleRequest; export type CreateMonitoringScheduleCommandOutput = CreateMonitoringScheduleResponse & __MetadataBearer; +/** + *

Creates a schedule that regularly starts Amazon SageMaker Processing Jobs to monitor the data + * captured for an Amazon SageMaker Endoint.

+ */ export class CreateMonitoringScheduleCommand extends $Command< CreateMonitoringScheduleCommandInput, CreateMonitoringScheduleCommandOutput, @@ -34,6 +38,9 @@ export class CreateMonitoringScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateNotebookInstanceCommand.ts b/clients/client-sagemaker/commands/CreateNotebookInstanceCommand.ts index f33a6ac66e62b..e2bc6879494a3 100644 --- a/clients/client-sagemaker/commands/CreateNotebookInstanceCommand.ts +++ b/clients/client-sagemaker/commands/CreateNotebookInstanceCommand.ts @@ -20,6 +20,45 @@ import { export type CreateNotebookInstanceCommandInput = CreateNotebookInstanceInput; export type CreateNotebookInstanceCommandOutput = CreateNotebookInstanceOutput & __MetadataBearer; +/** + *

Creates an Amazon SageMaker notebook instance. A notebook instance is a machine learning (ML) + * compute instance running on a Jupyter notebook.

+ *

In a CreateNotebookInstance request, specify the type of ML compute + * instance that you want to run. Amazon SageMaker launches the instance, installs common libraries + * that you can use to explore datasets for model training, and attaches an ML storage + * volume to the notebook instance.

+ *

Amazon SageMaker also provides a set of example notebooks. Each notebook demonstrates how to + * use Amazon SageMaker with a specific algorithm or with a machine learning framework.

+ *

After receiving the request, Amazon SageMaker does the following:

+ *
    + *
  1. + *

    Creates a network interface in the Amazon SageMaker VPC.

    + *
  2. + *
  3. + *

    (Option) If you specified SubnetId, Amazon SageMaker creates a network + * interface in your own VPC, which is inferred from the subnet ID that you provide + * in the input. When creating this network interface, Amazon SageMaker attaches the security + * group that you specified in the request to the network interface that it creates + * in your VPC.

    + * + *
  4. + *
  5. + *

    Launches an EC2 instance of the type specified in the request in the Amazon SageMaker + * VPC. If you specified SubnetId of your VPC, Amazon SageMaker specifies both + * network interfaces when launching this instance. This enables inbound traffic + * from your own VPC to the notebook instance, assuming that the security groups + * allow it.

    + *
  6. + *
+ * + *

After creating the notebook instance, Amazon SageMaker returns its Amazon Resource Name (ARN). + * You can't change the name of a notebook instance after you create it.

+ *

After Amazon SageMaker creates the notebook instance, you can connect to the Jupyter server and + * work in Jupyter notebooks. For example, you can write code to explore a dataset that you + * can use for model training, train a model, host models by creating Amazon SageMaker endpoints, and + * validate hosted models.

+ *

For more information, see How It Works.

+ */ export class CreateNotebookInstanceCommand extends $Command< CreateNotebookInstanceCommandInput, CreateNotebookInstanceCommandOutput, @@ -34,6 +73,9 @@ export class CreateNotebookInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateNotebookInstanceLifecycleConfigCommand.ts b/clients/client-sagemaker/commands/CreateNotebookInstanceLifecycleConfigCommand.ts index 5239a301b2960..8a7bb080b88d1 100644 --- a/clients/client-sagemaker/commands/CreateNotebookInstanceLifecycleConfigCommand.ts +++ b/clients/client-sagemaker/commands/CreateNotebookInstanceLifecycleConfigCommand.ts @@ -24,6 +24,22 @@ export type CreateNotebookInstanceLifecycleConfigCommandInput = CreateNotebookIn export type CreateNotebookInstanceLifecycleConfigCommandOutput = CreateNotebookInstanceLifecycleConfigOutput & __MetadataBearer; +/** + *

Creates a lifecycle configuration that you can associate with a notebook instance. A + * lifecycle configuration is a collection of shell scripts that + * run when you create or start a notebook instance.

+ *

Each lifecycle configuration script has a limit of 16384 characters.

+ *

The value of the $PATH environment variable that is available to both + * scripts is /sbin:bin:/usr/sbin:/usr/bin.

+ *

View CloudWatch Logs for notebook instance lifecycle configurations in log group + * /aws/sagemaker/NotebookInstances in log stream + * [notebook-instance-name]/[LifecycleConfigHook].

+ *

Lifecycle configuration scripts cannot run for longer than 5 minutes. If a script runs + * for longer than 5 minutes, it fails and the notebook instance is not created or + * started.

+ *

For information about notebook instance lifestyle configurations, see Step + * 2.1: (Optional) Customize a Notebook Instance.

+ */ export class CreateNotebookInstanceLifecycleConfigCommand extends $Command< CreateNotebookInstanceLifecycleConfigCommandInput, CreateNotebookInstanceLifecycleConfigCommandOutput, @@ -38,6 +54,9 @@ export class CreateNotebookInstanceLifecycleConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreatePresignedDomainUrlCommand.ts b/clients/client-sagemaker/commands/CreatePresignedDomainUrlCommand.ts index 9724523a4be40..cdcd3cfd35f43 100644 --- a/clients/client-sagemaker/commands/CreatePresignedDomainUrlCommand.ts +++ b/clients/client-sagemaker/commands/CreatePresignedDomainUrlCommand.ts @@ -20,6 +20,18 @@ import { export type CreatePresignedDomainUrlCommandInput = CreatePresignedDomainUrlRequest; export type CreatePresignedDomainUrlCommandOutput = CreatePresignedDomainUrlResponse & __MetadataBearer; +/** + *

Creates a URL for a specified UserProfile in a Domain. When accessed in a web browser, + * the user will be automatically signed in to Amazon SageMaker Studio, and granted access to all of + * the Apps and files associated with the Domain's Amazon Elastic File System (EFS) volume. + * This operation can only be called when the authentication mode equals IAM. + *

+ * + *

The URL that you get from a call to CreatePresignedDomainUrl is valid + * only for 5 minutes. If you try to use the URL after the 5-minute limit expires, you + * are directed to the AWS console sign-in page.

+ *
+ */ export class CreatePresignedDomainUrlCommand extends $Command< CreatePresignedDomainUrlCommandInput, CreatePresignedDomainUrlCommandOutput, @@ -34,6 +46,9 @@ export class CreatePresignedDomainUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreatePresignedNotebookInstanceUrlCommand.ts b/clients/client-sagemaker/commands/CreatePresignedNotebookInstanceUrlCommand.ts index 8e9d46fa9dedd..e35dd7abacaea 100644 --- a/clients/client-sagemaker/commands/CreatePresignedNotebookInstanceUrlCommand.ts +++ b/clients/client-sagemaker/commands/CreatePresignedNotebookInstanceUrlCommand.ts @@ -21,6 +21,26 @@ export type CreatePresignedNotebookInstanceUrlCommandInput = CreatePresignedNote export type CreatePresignedNotebookInstanceUrlCommandOutput = CreatePresignedNotebookInstanceUrlOutput & __MetadataBearer; +/** + *

Returns a URL that you can use to connect to the Jupyter server from a notebook + * instance. In the Amazon SageMaker console, when you choose Open next to a notebook + * instance, Amazon SageMaker opens a new tab showing the Jupyter server home page from the notebook + * instance. The console uses this API to get the URL and show the page.

+ *

The IAM role or user used to call this API defines the permissions to access the + * notebook instance. Once the presigned URL is created, no additional permission is + * required to access this URL. IAM authorization policies for this API are also enforced + * for every HTTP request and WebSocket frame that attempts to connect to the notebook + * instance.

+ *

You can restrict access to this API and to the URL that it returns to a list of IP + * addresses that you specify. Use the NotIpAddress condition operator and the + * aws:SourceIP condition context key to specify the list of IP addresses + * that you want to have access to the notebook instance. For more information, see Limit Access to a Notebook Instance by IP Address.

+ * + *

The URL that you get from a call to CreatePresignedNotebookInstanceUrl is valid only for 5 minutes. If + * you try to use the URL after the 5-minute limit expires, you are directed to the + * AWS console sign-in page.

+ *
+ */ export class CreatePresignedNotebookInstanceUrlCommand extends $Command< CreatePresignedNotebookInstanceUrlCommandInput, CreatePresignedNotebookInstanceUrlCommandOutput, @@ -35,6 +55,9 @@ export class CreatePresignedNotebookInstanceUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateProcessingJobCommand.ts b/clients/client-sagemaker/commands/CreateProcessingJobCommand.ts index 82a8d09f38459..d7368be1b6eea 100644 --- a/clients/client-sagemaker/commands/CreateProcessingJobCommand.ts +++ b/clients/client-sagemaker/commands/CreateProcessingJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProcessingJobCommandInput = CreateProcessingJobRequest; export type CreateProcessingJobCommandOutput = CreateProcessingJobResponse & __MetadataBearer; +/** + *

Creates a processing job.

+ */ export class CreateProcessingJobCommand extends $Command< CreateProcessingJobCommandInput, CreateProcessingJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateProcessingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateTrainingJobCommand.ts b/clients/client-sagemaker/commands/CreateTrainingJobCommand.ts index b6c55071a99a2..f79e29503d462 100644 --- a/clients/client-sagemaker/commands/CreateTrainingJobCommand.ts +++ b/clients/client-sagemaker/commands/CreateTrainingJobCommand.ts @@ -20,6 +20,73 @@ import { export type CreateTrainingJobCommandInput = CreateTrainingJobRequest; export type CreateTrainingJobCommandOutput = CreateTrainingJobResponse & __MetadataBearer; +/** + *

Starts a model training job. After training completes, Amazon SageMaker saves the resulting + * model artifacts to an Amazon S3 location that you specify.

+ *

If you choose to host your model using Amazon SageMaker hosting services, you can use the + * resulting model artifacts as part of the model. You can also use the artifacts in a + * machine learning service other than Amazon SageMaker, provided that you know how to use them for + * inferences. + * + *

+ *

In the request body, you provide the following:

+ *
    + *
  • + *

    + * AlgorithmSpecification - Identifies the training algorithm to + * use. + *

    + *
  • + *
  • + *

    + * HyperParameters - Specify these algorithm-specific parameters to + * enable the estimation of model parameters during training. Hyperparameters can + * be tuned to optimize this learning process. For a list of hyperparameters for + * each training algorithm provided by Amazon SageMaker, see Algorithms.

    + *
  • + *
  • + *

    + * InputDataConfig - Describes the training dataset and the Amazon S3, + * EFS, or FSx location where it is stored.

    + *
  • + *
  • + *

    + * OutputDataConfig - Identifies the Amazon S3 bucket where you want + * Amazon SageMaker to save the results of model training.

    + *

    + *
  • + *
  • + *

    + * ResourceConfig - Identifies the resources, ML compute + * instances, and ML storage volumes to deploy for model training. In distributed + * training, you specify more than one instance.

    + * + *
  • + *
  • + *

    + * EnableManagedSpotTraining - Optimize the cost of training machine + * learning models by up to 80% by using Amazon EC2 Spot instances. For more + * information, see Managed Spot + * Training.

    + *
  • + *
  • + *

    + * RoleARN - The Amazon Resource Number (ARN) that Amazon SageMaker assumes + * to perform tasks on your behalf during model training. + * + * You must grant this role the necessary permissions so that Amazon SageMaker can successfully + * complete model training.

    + *
  • + *
  • + *

    + * StoppingCondition - To help cap training costs, use + * MaxRuntimeInSeconds to set a time limit for training. Use + * MaxWaitTimeInSeconds to specify how long you are willing to + * wait for a managed spot training job to complete.

    + *
  • + *
+ *

For more information about Amazon SageMaker, see How It Works.

+ */ export class CreateTrainingJobCommand extends $Command< CreateTrainingJobCommandInput, CreateTrainingJobCommandOutput, @@ -34,6 +101,9 @@ export class CreateTrainingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateTransformJobCommand.ts b/clients/client-sagemaker/commands/CreateTransformJobCommand.ts index a10078675b5ef..498949e41ad76 100644 --- a/clients/client-sagemaker/commands/CreateTransformJobCommand.ts +++ b/clients/client-sagemaker/commands/CreateTransformJobCommand.ts @@ -20,6 +20,43 @@ import { export type CreateTransformJobCommandInput = CreateTransformJobRequest; export type CreateTransformJobCommandOutput = CreateTransformJobResponse & __MetadataBearer; +/** + *

Starts a transform job. A transform job uses a trained model to get inferences on a + * dataset and saves these results to an Amazon S3 location that you specify.

+ *

To perform batch transformations, you create a transform job and use the data that you + * have readily available.

+ *

In the request body, you provide the following:

+ *
    + *
  • + *

    + * TransformJobName - Identifies the transform job. The name must be + * unique within an AWS Region in an AWS account.

    + *
  • + *
  • + *

    + * ModelName - Identifies the model to use. ModelName + * must be the name of an existing Amazon SageMaker model in the same AWS Region and AWS + * account. For information on creating a model, see CreateModel.

    + *
  • + *
  • + *

    + * TransformInput - Describes the dataset to be transformed and the + * Amazon S3 location where it is stored.

    + *
  • + *
  • + *

    + * TransformOutput - Identifies the Amazon S3 location where you want + * Amazon SageMaker to save the results from the transform job.

    + *
  • + *
  • + *

    + * TransformResources - Identifies the ML compute instances for the + * transform job.

    + *
  • + *
+ *

For more information about how batch transformation works, see Batch + * Transform.

+ */ export class CreateTransformJobCommand extends $Command< CreateTransformJobCommandInput, CreateTransformJobCommandOutput, @@ -34,6 +71,9 @@ export class CreateTransformJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateTrialCommand.ts b/clients/client-sagemaker/commands/CreateTrialCommand.ts index 5d6d9f7158db1..d7f9c9c0dc3f5 100644 --- a/clients/client-sagemaker/commands/CreateTrialCommand.ts +++ b/clients/client-sagemaker/commands/CreateTrialCommand.ts @@ -20,6 +20,19 @@ import { export type CreateTrialCommandInput = CreateTrialRequest; export type CreateTrialCommandOutput = CreateTrialResponse & __MetadataBearer; +/** + *

Creates an Amazon SageMaker trial. A trial is a set of steps called + * trial components that produce a machine learning model. A trial is part + * of a single Amazon SageMaker experiment.

+ *

When you use Amazon SageMaker Studio or the Amazon SageMaker Python SDK, all experiments, trials, and trial + * components are automatically tracked, logged, and indexed. When you use the AWS SDK for Python (Boto), you + * must use the logging APIs provided by the SDK.

+ *

You can add tags to a trial and then use the Search API to search for + * the tags.

+ *

To get a list of all your trials, call the ListTrials API. To view a + * trial's properties, call the DescribeTrial API. To create a trial component, + * call the CreateTrialComponent API.

+ */ export class CreateTrialCommand extends $Command< CreateTrialCommandInput, CreateTrialCommandOutput, @@ -34,6 +47,9 @@ export class CreateTrialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateTrialComponentCommand.ts b/clients/client-sagemaker/commands/CreateTrialComponentCommand.ts index 1ae73868dd4bf..598252490895f 100644 --- a/clients/client-sagemaker/commands/CreateTrialComponentCommand.ts +++ b/clients/client-sagemaker/commands/CreateTrialComponentCommand.ts @@ -20,6 +20,25 @@ import { export type CreateTrialComponentCommandInput = CreateTrialComponentRequest; export type CreateTrialComponentCommandOutput = CreateTrialComponentResponse & __MetadataBearer; +/** + *

Creates a trial component, which is a stage of a machine learning + * trial. A trial is composed of one or more trial components. A trial + * component can be used in multiple trials.

+ *

Trial components include pre-processing jobs, training jobs, and batch transform + * jobs.

+ *

When you use Amazon SageMaker Studio or the Amazon SageMaker Python SDK, all experiments, trials, and trial + * components are automatically tracked, logged, and indexed. When you use the AWS SDK for Python (Boto), you + * must use the logging APIs provided by the SDK.

+ *

You can add tags to a trial component and then use the Search API to + * search for the tags.

+ * + *

+ * CreateTrialComponent can only be invoked from within an Amazon SageMaker managed + * environment. This includes Amazon SageMaker training jobs, processing jobs, transform jobs, and Amazon SageMaker + * notebooks. A call to CreateTrialComponent from outside one of these + * environments results in an error.

+ *
+ */ export class CreateTrialComponentCommand extends $Command< CreateTrialComponentCommandInput, CreateTrialComponentCommandOutput, @@ -34,6 +53,9 @@ export class CreateTrialComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateUserProfileCommand.ts b/clients/client-sagemaker/commands/CreateUserProfileCommand.ts index 9a64eb4ca39bc..a648a18383199 100644 --- a/clients/client-sagemaker/commands/CreateUserProfileCommand.ts +++ b/clients/client-sagemaker/commands/CreateUserProfileCommand.ts @@ -20,6 +20,15 @@ import { export type CreateUserProfileCommandInput = CreateUserProfileRequest; export type CreateUserProfileCommandOutput = CreateUserProfileResponse & __MetadataBearer; +/** + *

Creates a user profile. A user profile represents a single user within a domain, and is + * the main way to reference a "person" for the purposes of sharing, reporting, and other + * user-oriented features. This entity is created when a user onboards to Amazon SageMaker Studio. If an + * administrator invites a person by email or imports them from SSO, a user profile is + * automatically created. A user profile is the primary holder of settings for an individual + * user and has a reference to the user's private Amazon Elastic File System (EFS) home directory. + *

+ */ export class CreateUserProfileCommand extends $Command< CreateUserProfileCommandInput, CreateUserProfileCommandOutput, @@ -34,6 +43,9 @@ export class CreateUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateWorkforceCommand.ts b/clients/client-sagemaker/commands/CreateWorkforceCommand.ts index 6cadc00f52e7f..b2c128158554a 100644 --- a/clients/client-sagemaker/commands/CreateWorkforceCommand.ts +++ b/clients/client-sagemaker/commands/CreateWorkforceCommand.ts @@ -20,6 +20,29 @@ import { export type CreateWorkforceCommandInput = CreateWorkforceRequest; export type CreateWorkforceCommandOutput = CreateWorkforceResponse & __MetadataBearer; +/** + *

Use this operation to create a workforce. This operation will return an error + * if a workforce already exists in the AWS Region that you specify. You can only + * create one workforce in each AWS Region per AWS account.

+ * + *

If you want to create a new workforce in an AWS Region where + * a workforce already exists, use the API + * operation to delete the existing workforce and then use CreateWorkforce + * to create a new workforce.

+ * + *

To create a private workforce using Amazon Cognito, you must specify a Cognito user pool + * in CognitoConfig. + * You can also create an Amazon Cognito workforce using the Amazon SageMaker console. + * For more information, see + * + * Create a Private Workforce (Amazon Cognito).

+ * + *

To create a private workforce using your own OIDC Identity Provider (IdP), specify your IdP + * configuration in OidcConfig. Your OIDC IdP must support groups + * because groups are used by Ground Truth and Amazon A2I to create work teams. + * For more information, see + * Create a Private Workforce (OIDC IdP).

+ */ export class CreateWorkforceCommand extends $Command< CreateWorkforceCommandInput, CreateWorkforceCommandOutput, @@ -34,6 +57,9 @@ export class CreateWorkforceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/CreateWorkteamCommand.ts b/clients/client-sagemaker/commands/CreateWorkteamCommand.ts index b50b2dfa56c24..2ac2ee4ee769d 100644 --- a/clients/client-sagemaker/commands/CreateWorkteamCommand.ts +++ b/clients/client-sagemaker/commands/CreateWorkteamCommand.ts @@ -20,6 +20,12 @@ import { export type CreateWorkteamCommandInput = CreateWorkteamRequest; export type CreateWorkteamCommandOutput = CreateWorkteamResponse & __MetadataBearer; +/** + *

Creates a new work team for labeling your data. A work team is defined by one or more + * Amazon Cognito user pools. You must first create the user pools before you can create a work + * team.

+ *

You cannot create more than 25 work teams in an account and region.

+ */ export class CreateWorkteamCommand extends $Command< CreateWorkteamCommandInput, CreateWorkteamCommandOutput, @@ -34,6 +40,9 @@ export class CreateWorkteamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteAlgorithmCommand.ts b/clients/client-sagemaker/commands/DeleteAlgorithmCommand.ts index e068f93318567..48dbc402084e6 100644 --- a/clients/client-sagemaker/commands/DeleteAlgorithmCommand.ts +++ b/clients/client-sagemaker/commands/DeleteAlgorithmCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAlgorithmCommandInput = DeleteAlgorithmInput; export type DeleteAlgorithmCommandOutput = __MetadataBearer; +/** + *

Removes the specified algorithm from your account.

+ */ export class DeleteAlgorithmCommand extends $Command< DeleteAlgorithmCommandInput, DeleteAlgorithmCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAlgorithmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteAppCommand.ts b/clients/client-sagemaker/commands/DeleteAppCommand.ts index 2da26ec768d44..6aa8ebaa4b154 100644 --- a/clients/client-sagemaker/commands/DeleteAppCommand.ts +++ b/clients/client-sagemaker/commands/DeleteAppCommand.ts @@ -17,6 +17,9 @@ import { export type DeleteAppCommandInput = DeleteAppRequest; export type DeleteAppCommandOutput = __MetadataBearer; +/** + *

Used to stop and delete an app.

+ */ export class DeleteAppCommand extends $Command< DeleteAppCommandInput, DeleteAppCommandOutput, @@ -31,6 +34,9 @@ export class DeleteAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteAppImageConfigCommand.ts b/clients/client-sagemaker/commands/DeleteAppImageConfigCommand.ts index e2f12e90d4efa..e2d23be2f8bb7 100644 --- a/clients/client-sagemaker/commands/DeleteAppImageConfigCommand.ts +++ b/clients/client-sagemaker/commands/DeleteAppImageConfigCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAppImageConfigCommandInput = DeleteAppImageConfigRequest; export type DeleteAppImageConfigCommandOutput = __MetadataBearer; +/** + *

Deletes an AppImageConfig.

+ */ export class DeleteAppImageConfigCommand extends $Command< DeleteAppImageConfigCommandInput, DeleteAppImageConfigCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAppImageConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteCodeRepositoryCommand.ts b/clients/client-sagemaker/commands/DeleteCodeRepositoryCommand.ts index 96860ddae53b4..2699123ab77f0 100644 --- a/clients/client-sagemaker/commands/DeleteCodeRepositoryCommand.ts +++ b/clients/client-sagemaker/commands/DeleteCodeRepositoryCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCodeRepositoryCommandInput = DeleteCodeRepositoryInput; export type DeleteCodeRepositoryCommandOutput = __MetadataBearer; +/** + *

Deletes the specified Git repository from your account.

+ */ export class DeleteCodeRepositoryCommand extends $Command< DeleteCodeRepositoryCommandInput, DeleteCodeRepositoryCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCodeRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteDomainCommand.ts b/clients/client-sagemaker/commands/DeleteDomainCommand.ts index 07799cbddf45e..75ebea4ee49d0 100644 --- a/clients/client-sagemaker/commands/DeleteDomainCommand.ts +++ b/clients/client-sagemaker/commands/DeleteDomainCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteDomainCommandInput = DeleteDomainRequest; export type DeleteDomainCommandOutput = __MetadataBearer; +/** + *

Used to delete a domain. + * If you onboarded with IAM mode, you will need to delete your domain to onboard again using SSO. + * Use with caution. All of the members of the domain will lose access to their EFS volume, + * including data, notebooks, and other artifacts. + *

+ */ export class DeleteDomainCommand extends $Command< DeleteDomainCommandInput, DeleteDomainCommandOutput, @@ -34,6 +41,9 @@ export class DeleteDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteEndpointCommand.ts b/clients/client-sagemaker/commands/DeleteEndpointCommand.ts index aba0628b537cb..64a2ffe24e68f 100644 --- a/clients/client-sagemaker/commands/DeleteEndpointCommand.ts +++ b/clients/client-sagemaker/commands/DeleteEndpointCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteEndpointCommandInput = DeleteEndpointInput; export type DeleteEndpointCommandOutput = __MetadataBearer; +/** + *

Deletes an endpoint. Amazon SageMaker frees up all of the resources that were deployed when the + * endpoint was created.

+ *

Amazon SageMaker retires any custom KMS key grants associated with the endpoint, meaning you don't + * need to use the RevokeGrant API call.

+ */ export class DeleteEndpointCommand extends $Command< DeleteEndpointCommandInput, DeleteEndpointCommandOutput, @@ -34,6 +40,9 @@ export class DeleteEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteEndpointConfigCommand.ts b/clients/client-sagemaker/commands/DeleteEndpointConfigCommand.ts index a8ba4cc76a2c2..464ccf74f2eeb 100644 --- a/clients/client-sagemaker/commands/DeleteEndpointConfigCommand.ts +++ b/clients/client-sagemaker/commands/DeleteEndpointConfigCommand.ts @@ -20,6 +20,17 @@ import { export type DeleteEndpointConfigCommandInput = DeleteEndpointConfigInput; export type DeleteEndpointConfigCommandOutput = __MetadataBearer; +/** + *

Deletes an endpoint configuration. The DeleteEndpointConfig API + * deletes only the specified configuration. It does not delete endpoints created using the + * configuration.

+ *

You must not delete an EndpointConfig in use by an endpoint that is + * live or while the UpdateEndpoint or CreateEndpoint operations + * are being performed on the endpoint. If you delete the EndpointConfig of an + * endpoint that is active or being created or updated you may lose visibility into the + * instance type the endpoint is using. The endpoint must be deleted in order to stop + * incurring charges.

+ */ export class DeleteEndpointConfigCommand extends $Command< DeleteEndpointConfigCommandInput, DeleteEndpointConfigCommandOutput, @@ -34,6 +45,9 @@ export class DeleteEndpointConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteExperimentCommand.ts b/clients/client-sagemaker/commands/DeleteExperimentCommand.ts index f8a2776629286..0f86e91ce0517 100644 --- a/clients/client-sagemaker/commands/DeleteExperimentCommand.ts +++ b/clients/client-sagemaker/commands/DeleteExperimentCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteExperimentCommandInput = DeleteExperimentRequest; export type DeleteExperimentCommandOutput = DeleteExperimentResponse & __MetadataBearer; +/** + *

Deletes an Amazon SageMaker experiment. All trials associated with the experiment must be deleted + * first. Use the ListTrials API to get a list of the trials associated with + * the experiment.

+ */ export class DeleteExperimentCommand extends $Command< DeleteExperimentCommandInput, DeleteExperimentCommandOutput, @@ -34,6 +39,9 @@ export class DeleteExperimentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteFlowDefinitionCommand.ts b/clients/client-sagemaker/commands/DeleteFlowDefinitionCommand.ts index d5d4e07619efb..2526cc8079654 100644 --- a/clients/client-sagemaker/commands/DeleteFlowDefinitionCommand.ts +++ b/clients/client-sagemaker/commands/DeleteFlowDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFlowDefinitionCommandInput = DeleteFlowDefinitionRequest; export type DeleteFlowDefinitionCommandOutput = DeleteFlowDefinitionResponse & __MetadataBearer; +/** + *

Deletes the specified flow definition.

+ */ export class DeleteFlowDefinitionCommand extends $Command< DeleteFlowDefinitionCommandInput, DeleteFlowDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFlowDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteHumanTaskUiCommand.ts b/clients/client-sagemaker/commands/DeleteHumanTaskUiCommand.ts index e3717e36e0432..da2206febdef8 100644 --- a/clients/client-sagemaker/commands/DeleteHumanTaskUiCommand.ts +++ b/clients/client-sagemaker/commands/DeleteHumanTaskUiCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteHumanTaskUiCommandInput = DeleteHumanTaskUiRequest; export type DeleteHumanTaskUiCommandOutput = DeleteHumanTaskUiResponse & __MetadataBearer; +/** + *

Use this operation to delete a human task user interface (worker task template).

+ *

+ * To see a list of human task user interfaces + * (work task templates) in your account, use . + * When you delete a worker task template, it no longer appears when you call ListHumanTaskUis.

+ */ export class DeleteHumanTaskUiCommand extends $Command< DeleteHumanTaskUiCommandInput, DeleteHumanTaskUiCommandOutput, @@ -34,6 +41,9 @@ export class DeleteHumanTaskUiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteImageCommand.ts b/clients/client-sagemaker/commands/DeleteImageCommand.ts index efe2f6347df57..715f7e8a4af2a 100644 --- a/clients/client-sagemaker/commands/DeleteImageCommand.ts +++ b/clients/client-sagemaker/commands/DeleteImageCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteImageCommandInput = DeleteImageRequest; export type DeleteImageCommandOutput = DeleteImageResponse & __MetadataBearer; +/** + *

Deletes a SageMaker image and all versions of the image. The container images aren't + * deleted.

+ */ export class DeleteImageCommand extends $Command< DeleteImageCommandInput, DeleteImageCommandOutput, @@ -34,6 +38,9 @@ export class DeleteImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteImageVersionCommand.ts b/clients/client-sagemaker/commands/DeleteImageVersionCommand.ts index b380ccc41553c..7160ae9796f5c 100644 --- a/clients/client-sagemaker/commands/DeleteImageVersionCommand.ts +++ b/clients/client-sagemaker/commands/DeleteImageVersionCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteImageVersionCommandInput = DeleteImageVersionRequest; export type DeleteImageVersionCommandOutput = DeleteImageVersionResponse & __MetadataBearer; +/** + *

Deletes a version of a SageMaker image. The container image the version represents isn't + * deleted.

+ */ export class DeleteImageVersionCommand extends $Command< DeleteImageVersionCommandInput, DeleteImageVersionCommandOutput, @@ -34,6 +38,9 @@ export class DeleteImageVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteModelCommand.ts b/clients/client-sagemaker/commands/DeleteModelCommand.ts index eaa4946cf70d3..2d52fa9eadc05 100644 --- a/clients/client-sagemaker/commands/DeleteModelCommand.ts +++ b/clients/client-sagemaker/commands/DeleteModelCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteModelCommandInput = DeleteModelInput; export type DeleteModelCommandOutput = __MetadataBearer; +/** + *

Deletes a model. The DeleteModel API deletes only the model entry that + * was created in Amazon SageMaker when you called the CreateModel API. It does not + * delete model artifacts, inference code, or the IAM role that you specified when + * creating the model.

+ */ export class DeleteModelCommand extends $Command< DeleteModelCommandInput, DeleteModelCommandOutput, @@ -34,6 +40,9 @@ export class DeleteModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteModelPackageCommand.ts b/clients/client-sagemaker/commands/DeleteModelPackageCommand.ts index ffa18b5d6a2d7..6b8288e0e1e4e 100644 --- a/clients/client-sagemaker/commands/DeleteModelPackageCommand.ts +++ b/clients/client-sagemaker/commands/DeleteModelPackageCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteModelPackageCommandInput = DeleteModelPackageInput; export type DeleteModelPackageCommandOutput = __MetadataBearer; +/** + *

Deletes a model package.

+ *

A model package is used to create Amazon SageMaker models or list on AWS Marketplace. Buyers can + * subscribe to model packages listed on AWS Marketplace to create models in Amazon SageMaker.

+ */ export class DeleteModelPackageCommand extends $Command< DeleteModelPackageCommandInput, DeleteModelPackageCommandOutput, @@ -34,6 +39,9 @@ export class DeleteModelPackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteMonitoringScheduleCommand.ts b/clients/client-sagemaker/commands/DeleteMonitoringScheduleCommand.ts index 3182e9d19bdc1..935843b94fcda 100644 --- a/clients/client-sagemaker/commands/DeleteMonitoringScheduleCommand.ts +++ b/clients/client-sagemaker/commands/DeleteMonitoringScheduleCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteMonitoringScheduleCommandInput = DeleteMonitoringScheduleRequest; export type DeleteMonitoringScheduleCommandOutput = __MetadataBearer; +/** + *

Deletes a monitoring schedule. Also stops the schedule had not already been stopped. + * This does not delete the job execution history of the monitoring schedule.

+ */ export class DeleteMonitoringScheduleCommand extends $Command< DeleteMonitoringScheduleCommandInput, DeleteMonitoringScheduleCommandOutput, @@ -34,6 +38,9 @@ export class DeleteMonitoringScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteNotebookInstanceCommand.ts b/clients/client-sagemaker/commands/DeleteNotebookInstanceCommand.ts index d8c30eba9ebdb..33a9011548c3d 100644 --- a/clients/client-sagemaker/commands/DeleteNotebookInstanceCommand.ts +++ b/clients/client-sagemaker/commands/DeleteNotebookInstanceCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteNotebookInstanceCommandInput = DeleteNotebookInstanceInput; export type DeleteNotebookInstanceCommandOutput = __MetadataBearer; +/** + *

Deletes an Amazon SageMaker notebook instance. Before you can delete a notebook instance, you + * must call the StopNotebookInstance API.

+ * + *

When you delete a notebook instance, you lose all of your data. Amazon SageMaker removes + * the ML compute instance, and deletes the ML storage volume and the network interface + * associated with the notebook instance.

+ *
+ */ export class DeleteNotebookInstanceCommand extends $Command< DeleteNotebookInstanceCommandInput, DeleteNotebookInstanceCommandOutput, @@ -34,6 +43,9 @@ export class DeleteNotebookInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteNotebookInstanceLifecycleConfigCommand.ts b/clients/client-sagemaker/commands/DeleteNotebookInstanceLifecycleConfigCommand.ts index a377be010f135..2df679a4ec055 100644 --- a/clients/client-sagemaker/commands/DeleteNotebookInstanceLifecycleConfigCommand.ts +++ b/clients/client-sagemaker/commands/DeleteNotebookInstanceLifecycleConfigCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNotebookInstanceLifecycleConfigCommandInput = DeleteNotebookInstanceLifecycleConfigInput; export type DeleteNotebookInstanceLifecycleConfigCommandOutput = __MetadataBearer; +/** + *

Deletes a notebook instance lifecycle configuration.

+ */ export class DeleteNotebookInstanceLifecycleConfigCommand extends $Command< DeleteNotebookInstanceLifecycleConfigCommandInput, DeleteNotebookInstanceLifecycleConfigCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNotebookInstanceLifecycleConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteTagsCommand.ts b/clients/client-sagemaker/commands/DeleteTagsCommand.ts index a2b32b84df60c..ad60f2f0ec5b1 100644 --- a/clients/client-sagemaker/commands/DeleteTagsCommand.ts +++ b/clients/client-sagemaker/commands/DeleteTagsCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteTagsCommandInput = DeleteTagsInput; export type DeleteTagsCommandOutput = DeleteTagsOutput & __MetadataBearer; +/** + *

Deletes the specified tags from an Amazon SageMaker resource.

+ *

To list a resource's tags, use the ListTags API.

+ * + *

When you call this API to delete tags from a hyperparameter tuning job, the + * deleted tags are not removed from training jobs that the hyperparameter tuning job + * launched before you called this API.

+ *
+ */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -34,6 +43,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteTrialCommand.ts b/clients/client-sagemaker/commands/DeleteTrialCommand.ts index ae660ef9353b1..204baff084d58 100644 --- a/clients/client-sagemaker/commands/DeleteTrialCommand.ts +++ b/clients/client-sagemaker/commands/DeleteTrialCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteTrialCommandInput = DeleteTrialRequest; export type DeleteTrialCommandOutput = DeleteTrialResponse & __MetadataBearer; +/** + *

Deletes the specified trial. All trial components that make up the trial must be deleted + * first. Use the DescribeTrialComponent API to get the list of trial + * components.

+ */ export class DeleteTrialCommand extends $Command< DeleteTrialCommandInput, DeleteTrialCommandOutput, @@ -34,6 +39,9 @@ export class DeleteTrialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteTrialComponentCommand.ts b/clients/client-sagemaker/commands/DeleteTrialComponentCommand.ts index 4e3e946727611..18b2d01050cbc 100644 --- a/clients/client-sagemaker/commands/DeleteTrialComponentCommand.ts +++ b/clients/client-sagemaker/commands/DeleteTrialComponentCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteTrialComponentCommandInput = DeleteTrialComponentRequest; export type DeleteTrialComponentCommandOutput = DeleteTrialComponentResponse & __MetadataBearer; +/** + *

Deletes the specified trial component. A trial component must be disassociated from all + * trials before the trial component can be deleted. To disassociate a trial component from a + * trial, call the DisassociateTrialComponent API.

+ */ export class DeleteTrialComponentCommand extends $Command< DeleteTrialComponentCommandInput, DeleteTrialComponentCommandOutput, @@ -34,6 +39,9 @@ export class DeleteTrialComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteUserProfileCommand.ts b/clients/client-sagemaker/commands/DeleteUserProfileCommand.ts index 1588c6929c0c0..9be967be78fa6 100644 --- a/clients/client-sagemaker/commands/DeleteUserProfileCommand.ts +++ b/clients/client-sagemaker/commands/DeleteUserProfileCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteUserProfileCommandInput = DeleteUserProfileRequest; export type DeleteUserProfileCommandOutput = __MetadataBearer; +/** + *

Deletes a user profile. When a user profile is deleted, the user loses access to their EFS + * volume, including data, notebooks, and other artifacts.

+ */ export class DeleteUserProfileCommand extends $Command< DeleteUserProfileCommandInput, DeleteUserProfileCommandOutput, @@ -34,6 +38,9 @@ export class DeleteUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteWorkforceCommand.ts b/clients/client-sagemaker/commands/DeleteWorkforceCommand.ts index 9492fd5ec0e6a..2a9181088065a 100644 --- a/clients/client-sagemaker/commands/DeleteWorkforceCommand.ts +++ b/clients/client-sagemaker/commands/DeleteWorkforceCommand.ts @@ -20,6 +20,21 @@ import { export type DeleteWorkforceCommandInput = DeleteWorkforceRequest; export type DeleteWorkforceCommandOutput = DeleteWorkforceResponse & __MetadataBearer; +/** + *

Use this operation to delete a workforce.

+ * + *

If you want to create a new workforce in an AWS Region where + * a workforce already exists, use this operation to delete the + * existing workforce and then use + * to create a new workforce.

+ * + *

If a private workforce contains one or more work teams, you must use + * the + * operation to delete all work teams before you delete the workforce. + * If you try to delete a workforce that contains one or more work teams, + * you will recieve a ResourceInUse error.

+ *
+ */ export class DeleteWorkforceCommand extends $Command< DeleteWorkforceCommandInput, DeleteWorkforceCommandOutput, @@ -34,6 +49,9 @@ export class DeleteWorkforceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DeleteWorkteamCommand.ts b/clients/client-sagemaker/commands/DeleteWorkteamCommand.ts index 8845f3f1b33df..3b3c04cb6344b 100644 --- a/clients/client-sagemaker/commands/DeleteWorkteamCommand.ts +++ b/clients/client-sagemaker/commands/DeleteWorkteamCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteWorkteamCommandInput = DeleteWorkteamRequest; export type DeleteWorkteamCommandOutput = DeleteWorkteamResponse & __MetadataBearer; +/** + *

Deletes an existing work team. This operation can't be undone.

+ */ export class DeleteWorkteamCommand extends $Command< DeleteWorkteamCommandInput, DeleteWorkteamCommandOutput, @@ -34,6 +37,9 @@ export class DeleteWorkteamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeAlgorithmCommand.ts b/clients/client-sagemaker/commands/DescribeAlgorithmCommand.ts index 0f65820833d4c..5e7cfe7a5280d 100644 --- a/clients/client-sagemaker/commands/DescribeAlgorithmCommand.ts +++ b/clients/client-sagemaker/commands/DescribeAlgorithmCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAlgorithmCommandInput = DescribeAlgorithmInput; export type DescribeAlgorithmCommandOutput = DescribeAlgorithmOutput & __MetadataBearer; +/** + *

Returns a description of the specified algorithm that is in your account.

+ */ export class DescribeAlgorithmCommand extends $Command< DescribeAlgorithmCommandInput, DescribeAlgorithmCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAlgorithmCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeAppCommand.ts b/clients/client-sagemaker/commands/DescribeAppCommand.ts index c75f6b5703a99..c5809da02e148 100644 --- a/clients/client-sagemaker/commands/DescribeAppCommand.ts +++ b/clients/client-sagemaker/commands/DescribeAppCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAppCommandInput = DescribeAppRequest; export type DescribeAppCommandOutput = DescribeAppResponse & __MetadataBearer; +/** + *

Describes the app.

+ */ export class DescribeAppCommand extends $Command< DescribeAppCommandInput, DescribeAppCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeAppImageConfigCommand.ts b/clients/client-sagemaker/commands/DescribeAppImageConfigCommand.ts index ea1529b70fcca..9817090954169 100644 --- a/clients/client-sagemaker/commands/DescribeAppImageConfigCommand.ts +++ b/clients/client-sagemaker/commands/DescribeAppImageConfigCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAppImageConfigCommandInput = DescribeAppImageConfigRequest; export type DescribeAppImageConfigCommandOutput = DescribeAppImageConfigResponse & __MetadataBearer; +/** + *

Describes an AppImageConfig.

+ */ export class DescribeAppImageConfigCommand extends $Command< DescribeAppImageConfigCommandInput, DescribeAppImageConfigCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAppImageConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeAutoMLJobCommand.ts b/clients/client-sagemaker/commands/DescribeAutoMLJobCommand.ts index cfaf590a1511a..9cb45b6a8a7f1 100644 --- a/clients/client-sagemaker/commands/DescribeAutoMLJobCommand.ts +++ b/clients/client-sagemaker/commands/DescribeAutoMLJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAutoMLJobCommandInput = DescribeAutoMLJobRequest; export type DescribeAutoMLJobCommandOutput = DescribeAutoMLJobResponse & __MetadataBearer; +/** + *

Returns information about an Amazon SageMaker job.

+ */ export class DescribeAutoMLJobCommand extends $Command< DescribeAutoMLJobCommandInput, DescribeAutoMLJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAutoMLJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeCodeRepositoryCommand.ts b/clients/client-sagemaker/commands/DescribeCodeRepositoryCommand.ts index 2a4eb40efddd4..9b5908bd98f8b 100644 --- a/clients/client-sagemaker/commands/DescribeCodeRepositoryCommand.ts +++ b/clients/client-sagemaker/commands/DescribeCodeRepositoryCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCodeRepositoryCommandInput = DescribeCodeRepositoryInput; export type DescribeCodeRepositoryCommandOutput = DescribeCodeRepositoryOutput & __MetadataBearer; +/** + *

Gets details about the specified Git repository.

+ */ export class DescribeCodeRepositoryCommand extends $Command< DescribeCodeRepositoryCommandInput, DescribeCodeRepositoryCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCodeRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeCompilationJobCommand.ts b/clients/client-sagemaker/commands/DescribeCompilationJobCommand.ts index d7285614ef35d..2128241af34cd 100644 --- a/clients/client-sagemaker/commands/DescribeCompilationJobCommand.ts +++ b/clients/client-sagemaker/commands/DescribeCompilationJobCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeCompilationJobCommandInput = DescribeCompilationJobRequest; export type DescribeCompilationJobCommandOutput = DescribeCompilationJobResponse & __MetadataBearer; +/** + *

Returns information about a model compilation job.

+ *

To create a model compilation job, use CreateCompilationJob. To get + * information about multiple model compilation jobs, use ListCompilationJobs.

+ */ export class DescribeCompilationJobCommand extends $Command< DescribeCompilationJobCommandInput, DescribeCompilationJobCommandOutput, @@ -34,6 +39,9 @@ export class DescribeCompilationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeDomainCommand.ts b/clients/client-sagemaker/commands/DescribeDomainCommand.ts index d0e237b91a545..f77873dc0ba3b 100644 --- a/clients/client-sagemaker/commands/DescribeDomainCommand.ts +++ b/clients/client-sagemaker/commands/DescribeDomainCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDomainCommandInput = DescribeDomainRequest; export type DescribeDomainCommandOutput = DescribeDomainResponse & __MetadataBearer; +/** + *

The description of the domain.

+ */ export class DescribeDomainCommand extends $Command< DescribeDomainCommandInput, DescribeDomainCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeEndpointCommand.ts b/clients/client-sagemaker/commands/DescribeEndpointCommand.ts index 4e51c6159faba..884201fc3e4a1 100644 --- a/clients/client-sagemaker/commands/DescribeEndpointCommand.ts +++ b/clients/client-sagemaker/commands/DescribeEndpointCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEndpointCommandInput = DescribeEndpointInput; export type DescribeEndpointCommandOutput = DescribeEndpointOutput & __MetadataBearer; +/** + *

Returns the description of an endpoint.

+ */ export class DescribeEndpointCommand extends $Command< DescribeEndpointCommandInput, DescribeEndpointCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeEndpointConfigCommand.ts b/clients/client-sagemaker/commands/DescribeEndpointConfigCommand.ts index ba91d87fff141..e5642d6a0c460 100644 --- a/clients/client-sagemaker/commands/DescribeEndpointConfigCommand.ts +++ b/clients/client-sagemaker/commands/DescribeEndpointConfigCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeEndpointConfigCommandInput = DescribeEndpointConfigInput; export type DescribeEndpointConfigCommandOutput = DescribeEndpointConfigOutput & __MetadataBearer; +/** + *

Returns the description of an endpoint configuration created using the + * CreateEndpointConfig API.

+ */ export class DescribeEndpointConfigCommand extends $Command< DescribeEndpointConfigCommandInput, DescribeEndpointConfigCommandOutput, @@ -34,6 +38,9 @@ export class DescribeEndpointConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeExperimentCommand.ts b/clients/client-sagemaker/commands/DescribeExperimentCommand.ts index 82fbce960e7a3..72b5e467f1889 100644 --- a/clients/client-sagemaker/commands/DescribeExperimentCommand.ts +++ b/clients/client-sagemaker/commands/DescribeExperimentCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeExperimentCommandInput = DescribeExperimentRequest; export type DescribeExperimentCommandOutput = DescribeExperimentResponse & __MetadataBearer; +/** + *

Provides a list of an experiment's properties.

+ */ export class DescribeExperimentCommand extends $Command< DescribeExperimentCommandInput, DescribeExperimentCommandOutput, @@ -34,6 +37,9 @@ export class DescribeExperimentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeFlowDefinitionCommand.ts b/clients/client-sagemaker/commands/DescribeFlowDefinitionCommand.ts index 537db654775c6..132f6ab3a2ee1 100644 --- a/clients/client-sagemaker/commands/DescribeFlowDefinitionCommand.ts +++ b/clients/client-sagemaker/commands/DescribeFlowDefinitionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeFlowDefinitionCommandInput = DescribeFlowDefinitionRequest; export type DescribeFlowDefinitionCommandOutput = DescribeFlowDefinitionResponse & __MetadataBearer; +/** + *

Returns information about the specified flow definition.

+ */ export class DescribeFlowDefinitionCommand extends $Command< DescribeFlowDefinitionCommandInput, DescribeFlowDefinitionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeFlowDefinitionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeHumanTaskUiCommand.ts b/clients/client-sagemaker/commands/DescribeHumanTaskUiCommand.ts index 6eb4d9122ae32..2999cf50014f3 100644 --- a/clients/client-sagemaker/commands/DescribeHumanTaskUiCommand.ts +++ b/clients/client-sagemaker/commands/DescribeHumanTaskUiCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeHumanTaskUiCommandInput = DescribeHumanTaskUiRequest; export type DescribeHumanTaskUiCommandOutput = DescribeHumanTaskUiResponse & __MetadataBearer; +/** + *

Returns information about the requested human task user interface (worker task template).

+ */ export class DescribeHumanTaskUiCommand extends $Command< DescribeHumanTaskUiCommandInput, DescribeHumanTaskUiCommandOutput, @@ -34,6 +37,9 @@ export class DescribeHumanTaskUiCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeHyperParameterTuningJobCommand.ts b/clients/client-sagemaker/commands/DescribeHyperParameterTuningJobCommand.ts index 737e0e1c72827..4aaa609c54b15 100644 --- a/clients/client-sagemaker/commands/DescribeHyperParameterTuningJobCommand.ts +++ b/clients/client-sagemaker/commands/DescribeHyperParameterTuningJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeHyperParameterTuningJobCommandInput = DescribeHyperParameterTuningJobRequest; export type DescribeHyperParameterTuningJobCommandOutput = DescribeHyperParameterTuningJobResponse & __MetadataBearer; +/** + *

Gets + * a description of a hyperparameter tuning job.

+ */ export class DescribeHyperParameterTuningJobCommand extends $Command< DescribeHyperParameterTuningJobCommandInput, DescribeHyperParameterTuningJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeHyperParameterTuningJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeImageCommand.ts b/clients/client-sagemaker/commands/DescribeImageCommand.ts index 66fe9b753f0b9..b0ed0e1784d74 100644 --- a/clients/client-sagemaker/commands/DescribeImageCommand.ts +++ b/clients/client-sagemaker/commands/DescribeImageCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImageCommandInput = DescribeImageRequest; export type DescribeImageCommandOutput = DescribeImageResponse & __MetadataBearer; +/** + *

Describes a SageMaker image.

+ */ export class DescribeImageCommand extends $Command< DescribeImageCommandInput, DescribeImageCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeImageVersionCommand.ts b/clients/client-sagemaker/commands/DescribeImageVersionCommand.ts index beb59533dc8b9..236bbcbb8fbcd 100644 --- a/clients/client-sagemaker/commands/DescribeImageVersionCommand.ts +++ b/clients/client-sagemaker/commands/DescribeImageVersionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeImageVersionCommandInput = DescribeImageVersionRequest; export type DescribeImageVersionCommandOutput = DescribeImageVersionResponse & __MetadataBearer; +/** + *

Describes a version of a SageMaker image.

+ */ export class DescribeImageVersionCommand extends $Command< DescribeImageVersionCommandInput, DescribeImageVersionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeImageVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeLabelingJobCommand.ts b/clients/client-sagemaker/commands/DescribeLabelingJobCommand.ts index 652e37c8dcdaa..e63e170f69215 100644 --- a/clients/client-sagemaker/commands/DescribeLabelingJobCommand.ts +++ b/clients/client-sagemaker/commands/DescribeLabelingJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeLabelingJobCommandInput = DescribeLabelingJobRequest; export type DescribeLabelingJobCommandOutput = DescribeLabelingJobResponse & __MetadataBearer; +/** + *

Gets information about a labeling job.

+ */ export class DescribeLabelingJobCommand extends $Command< DescribeLabelingJobCommandInput, DescribeLabelingJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeLabelingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeModelCommand.ts b/clients/client-sagemaker/commands/DescribeModelCommand.ts index b74561815716e..bdcba7a7b2957 100644 --- a/clients/client-sagemaker/commands/DescribeModelCommand.ts +++ b/clients/client-sagemaker/commands/DescribeModelCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeModelCommandInput = DescribeModelInput; export type DescribeModelCommandOutput = DescribeModelOutput & __MetadataBearer; +/** + *

Describes a model that you created using the CreateModel + * API.

+ */ export class DescribeModelCommand extends $Command< DescribeModelCommandInput, DescribeModelCommandOutput, @@ -34,6 +38,9 @@ export class DescribeModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeModelPackageCommand.ts b/clients/client-sagemaker/commands/DescribeModelPackageCommand.ts index 5c1e7b3af914d..1882c9321a3cf 100644 --- a/clients/client-sagemaker/commands/DescribeModelPackageCommand.ts +++ b/clients/client-sagemaker/commands/DescribeModelPackageCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeModelPackageCommandInput = DescribeModelPackageInput; export type DescribeModelPackageCommandOutput = DescribeModelPackageOutput & __MetadataBearer; +/** + *

Returns a description of the specified model package, which is used to create Amazon SageMaker + * models or list them on AWS Marketplace.

+ *

To create models in Amazon SageMaker, buyers can subscribe to model packages listed on AWS + * Marketplace.

+ */ export class DescribeModelPackageCommand extends $Command< DescribeModelPackageCommandInput, DescribeModelPackageCommandOutput, @@ -34,6 +40,9 @@ export class DescribeModelPackageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeMonitoringScheduleCommand.ts b/clients/client-sagemaker/commands/DescribeMonitoringScheduleCommand.ts index e98d88c35c368..d6f6d92daf202 100644 --- a/clients/client-sagemaker/commands/DescribeMonitoringScheduleCommand.ts +++ b/clients/client-sagemaker/commands/DescribeMonitoringScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMonitoringScheduleCommandInput = DescribeMonitoringScheduleRequest; export type DescribeMonitoringScheduleCommandOutput = DescribeMonitoringScheduleResponse & __MetadataBearer; +/** + *

Describes the schedule for a monitoring job.

+ */ export class DescribeMonitoringScheduleCommand extends $Command< DescribeMonitoringScheduleCommandInput, DescribeMonitoringScheduleCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMonitoringScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeNotebookInstanceCommand.ts b/clients/client-sagemaker/commands/DescribeNotebookInstanceCommand.ts index bd1aeac2edbe8..464f883fb5139 100644 --- a/clients/client-sagemaker/commands/DescribeNotebookInstanceCommand.ts +++ b/clients/client-sagemaker/commands/DescribeNotebookInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeNotebookInstanceCommandInput = DescribeNotebookInstanceInput; export type DescribeNotebookInstanceCommandOutput = DescribeNotebookInstanceOutput & __MetadataBearer; +/** + *

Returns information about a notebook instance.

+ */ export class DescribeNotebookInstanceCommand extends $Command< DescribeNotebookInstanceCommandInput, DescribeNotebookInstanceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeNotebookInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeNotebookInstanceLifecycleConfigCommand.ts b/clients/client-sagemaker/commands/DescribeNotebookInstanceLifecycleConfigCommand.ts index 1bd9d27485617..020e49863d597 100644 --- a/clients/client-sagemaker/commands/DescribeNotebookInstanceLifecycleConfigCommand.ts +++ b/clients/client-sagemaker/commands/DescribeNotebookInstanceLifecycleConfigCommand.ts @@ -24,6 +24,11 @@ export type DescribeNotebookInstanceLifecycleConfigCommandInput = DescribeNotebo export type DescribeNotebookInstanceLifecycleConfigCommandOutput = DescribeNotebookInstanceLifecycleConfigOutput & __MetadataBearer; +/** + *

Returns a description of a notebook instance lifecycle configuration.

+ *

For information about notebook instance lifestyle configurations, see Step + * 2.1: (Optional) Customize a Notebook Instance.

+ */ export class DescribeNotebookInstanceLifecycleConfigCommand extends $Command< DescribeNotebookInstanceLifecycleConfigCommandInput, DescribeNotebookInstanceLifecycleConfigCommandOutput, @@ -38,6 +43,9 @@ export class DescribeNotebookInstanceLifecycleConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeProcessingJobCommand.ts b/clients/client-sagemaker/commands/DescribeProcessingJobCommand.ts index 4222fd9818d8f..b67592a0b46d4 100644 --- a/clients/client-sagemaker/commands/DescribeProcessingJobCommand.ts +++ b/clients/client-sagemaker/commands/DescribeProcessingJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProcessingJobCommandInput = DescribeProcessingJobRequest; export type DescribeProcessingJobCommandOutput = DescribeProcessingJobResponse & __MetadataBearer; +/** + *

Returns a description of a processing job.

+ */ export class DescribeProcessingJobCommand extends $Command< DescribeProcessingJobCommandInput, DescribeProcessingJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProcessingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeSubscribedWorkteamCommand.ts b/clients/client-sagemaker/commands/DescribeSubscribedWorkteamCommand.ts index 158969f6ef63e..69bd754050308 100644 --- a/clients/client-sagemaker/commands/DescribeSubscribedWorkteamCommand.ts +++ b/clients/client-sagemaker/commands/DescribeSubscribedWorkteamCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSubscribedWorkteamCommandInput = DescribeSubscribedWorkteamRequest; export type DescribeSubscribedWorkteamCommandOutput = DescribeSubscribedWorkteamResponse & __MetadataBearer; +/** + *

Gets information about a work team provided by a vendor. It returns details about the + * subscription with a vendor in the AWS Marketplace.

+ */ export class DescribeSubscribedWorkteamCommand extends $Command< DescribeSubscribedWorkteamCommandInput, DescribeSubscribedWorkteamCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSubscribedWorkteamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeTrainingJobCommand.ts b/clients/client-sagemaker/commands/DescribeTrainingJobCommand.ts index 9fe25a6987531..e36b92d0be112 100644 --- a/clients/client-sagemaker/commands/DescribeTrainingJobCommand.ts +++ b/clients/client-sagemaker/commands/DescribeTrainingJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTrainingJobCommandInput = DescribeTrainingJobRequest; export type DescribeTrainingJobCommandOutput = DescribeTrainingJobResponse & __MetadataBearer; +/** + *

Returns information about a training job.

+ */ export class DescribeTrainingJobCommand extends $Command< DescribeTrainingJobCommandInput, DescribeTrainingJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTrainingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeTransformJobCommand.ts b/clients/client-sagemaker/commands/DescribeTransformJobCommand.ts index e281a3183cd30..697e7f0431cc9 100644 --- a/clients/client-sagemaker/commands/DescribeTransformJobCommand.ts +++ b/clients/client-sagemaker/commands/DescribeTransformJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTransformJobCommandInput = DescribeTransformJobRequest; export type DescribeTransformJobCommandOutput = DescribeTransformJobResponse & __MetadataBearer; +/** + *

Returns information about a transform job.

+ */ export class DescribeTransformJobCommand extends $Command< DescribeTransformJobCommandInput, DescribeTransformJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTransformJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeTrialCommand.ts b/clients/client-sagemaker/commands/DescribeTrialCommand.ts index 995133ad412ed..dddd5497df23c 100644 --- a/clients/client-sagemaker/commands/DescribeTrialCommand.ts +++ b/clients/client-sagemaker/commands/DescribeTrialCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTrialCommandInput = DescribeTrialRequest; export type DescribeTrialCommandOutput = DescribeTrialResponse & __MetadataBearer; +/** + *

Provides a list of a trial's properties.

+ */ export class DescribeTrialCommand extends $Command< DescribeTrialCommandInput, DescribeTrialCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTrialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeTrialComponentCommand.ts b/clients/client-sagemaker/commands/DescribeTrialComponentCommand.ts index d8f2a2b1306a9..0a75cd55f5643 100644 --- a/clients/client-sagemaker/commands/DescribeTrialComponentCommand.ts +++ b/clients/client-sagemaker/commands/DescribeTrialComponentCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTrialComponentCommandInput = DescribeTrialComponentRequest; export type DescribeTrialComponentCommandOutput = DescribeTrialComponentResponse & __MetadataBearer; +/** + *

Provides a list of a trials component's properties.

+ */ export class DescribeTrialComponentCommand extends $Command< DescribeTrialComponentCommandInput, DescribeTrialComponentCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTrialComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeUserProfileCommand.ts b/clients/client-sagemaker/commands/DescribeUserProfileCommand.ts index 69bd556a15c21..051de3c44bfa6 100644 --- a/clients/client-sagemaker/commands/DescribeUserProfileCommand.ts +++ b/clients/client-sagemaker/commands/DescribeUserProfileCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserProfileCommandInput = DescribeUserProfileRequest; export type DescribeUserProfileCommandOutput = DescribeUserProfileResponse & __MetadataBearer; +/** + *

Describes a user profile. For more information, see CreateUserProfile.

+ */ export class DescribeUserProfileCommand extends $Command< DescribeUserProfileCommandInput, DescribeUserProfileCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeWorkforceCommand.ts b/clients/client-sagemaker/commands/DescribeWorkforceCommand.ts index 168ace40849d6..32c06fee1095c 100644 --- a/clients/client-sagemaker/commands/DescribeWorkforceCommand.ts +++ b/clients/client-sagemaker/commands/DescribeWorkforceCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeWorkforceCommandInput = DescribeWorkforceRequest; export type DescribeWorkforceCommandOutput = DescribeWorkforceResponse & __MetadataBearer; +/** + *

Lists private workforce information, including workforce name, Amazon Resource Name + * (ARN), and, if applicable, allowed IP address ranges (CIDRs). Allowable IP address + * ranges are the IP addresses that workers can use to access tasks.

+ * + *

This operation applies only to private workforces.

+ *
+ */ export class DescribeWorkforceCommand extends $Command< DescribeWorkforceCommandInput, DescribeWorkforceCommandOutput, @@ -34,6 +42,9 @@ export class DescribeWorkforceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DescribeWorkteamCommand.ts b/clients/client-sagemaker/commands/DescribeWorkteamCommand.ts index 8a809a4b6ef5e..6172cfecee8c0 100644 --- a/clients/client-sagemaker/commands/DescribeWorkteamCommand.ts +++ b/clients/client-sagemaker/commands/DescribeWorkteamCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeWorkteamCommandInput = DescribeWorkteamRequest; export type DescribeWorkteamCommandOutput = DescribeWorkteamResponse & __MetadataBearer; +/** + *

Gets information about a specific work team. You can see information such as the + * create date, the last updated date, membership information, and the work team's Amazon + * Resource Name (ARN).

+ */ export class DescribeWorkteamCommand extends $Command< DescribeWorkteamCommandInput, DescribeWorkteamCommandOutput, @@ -34,6 +39,9 @@ export class DescribeWorkteamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/DisassociateTrialComponentCommand.ts b/clients/client-sagemaker/commands/DisassociateTrialComponentCommand.ts index 78fc512f2f332..489c2beebb4d4 100644 --- a/clients/client-sagemaker/commands/DisassociateTrialComponentCommand.ts +++ b/clients/client-sagemaker/commands/DisassociateTrialComponentCommand.ts @@ -20,6 +20,14 @@ import { export type DisassociateTrialComponentCommandInput = DisassociateTrialComponentRequest; export type DisassociateTrialComponentCommandOutput = DisassociateTrialComponentResponse & __MetadataBearer; +/** + *

Disassociates a trial component from a trial. This doesn't effect other trials the + * component is associated with. Before you can delete a component, you must disassociate the + * component from all trials it is associated with. To associate a trial component with a trial, + * call the AssociateTrialComponent API.

+ *

To get a list of the trials a component is associated with, use the Search API. Specify ExperimentTrialComponent for the Resource parameter. + * The list appears in the response under Results.TrialComponent.Parents.

+ */ export class DisassociateTrialComponentCommand extends $Command< DisassociateTrialComponentCommandInput, DisassociateTrialComponentCommandOutput, @@ -34,6 +42,9 @@ export class DisassociateTrialComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/GetSearchSuggestionsCommand.ts b/clients/client-sagemaker/commands/GetSearchSuggestionsCommand.ts index a6ab002c1c07f..cf1d4609d30c6 100644 --- a/clients/client-sagemaker/commands/GetSearchSuggestionsCommand.ts +++ b/clients/client-sagemaker/commands/GetSearchSuggestionsCommand.ts @@ -20,6 +20,12 @@ import { export type GetSearchSuggestionsCommandInput = GetSearchSuggestionsRequest; export type GetSearchSuggestionsCommandOutput = GetSearchSuggestionsResponse & __MetadataBearer; +/** + *

An auto-complete API for the search functionality in the Amazon SageMaker console. It returns + * suggestions of possible matches for the property name to use in Search + * queries. Provides suggestions for HyperParameters, Tags, and + * Metrics.

+ */ export class GetSearchSuggestionsCommand extends $Command< GetSearchSuggestionsCommandInput, GetSearchSuggestionsCommandOutput, @@ -34,6 +40,9 @@ export class GetSearchSuggestionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListAlgorithmsCommand.ts b/clients/client-sagemaker/commands/ListAlgorithmsCommand.ts index 2b7b65a722ccd..1dec38f389095 100644 --- a/clients/client-sagemaker/commands/ListAlgorithmsCommand.ts +++ b/clients/client-sagemaker/commands/ListAlgorithmsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAlgorithmsCommandInput = ListAlgorithmsInput; export type ListAlgorithmsCommandOutput = ListAlgorithmsOutput & __MetadataBearer; +/** + *

Lists the machine learning algorithms that have been created.

+ */ export class ListAlgorithmsCommand extends $Command< ListAlgorithmsCommandInput, ListAlgorithmsCommandOutput, @@ -34,6 +37,9 @@ export class ListAlgorithmsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListAppImageConfigsCommand.ts b/clients/client-sagemaker/commands/ListAppImageConfigsCommand.ts index 81f02040d618a..ea5d3e93df6ad 100644 --- a/clients/client-sagemaker/commands/ListAppImageConfigsCommand.ts +++ b/clients/client-sagemaker/commands/ListAppImageConfigsCommand.ts @@ -20,6 +20,11 @@ import { export type ListAppImageConfigsCommandInput = ListAppImageConfigsRequest; export type ListAppImageConfigsCommandOutput = ListAppImageConfigsResponse & __MetadataBearer; +/** + *

Lists the AppImageConfigs in your account and their properties. The list can be + * filtered by creation time or modified time, and whether the AppImageConfig name contains + * a specified string.

+ */ export class ListAppImageConfigsCommand extends $Command< ListAppImageConfigsCommandInput, ListAppImageConfigsCommandOutput, @@ -34,6 +39,9 @@ export class ListAppImageConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListAppsCommand.ts b/clients/client-sagemaker/commands/ListAppsCommand.ts index 7df06243230ea..569e78daee422 100644 --- a/clients/client-sagemaker/commands/ListAppsCommand.ts +++ b/clients/client-sagemaker/commands/ListAppsCommand.ts @@ -17,6 +17,9 @@ import { export type ListAppsCommandInput = ListAppsRequest; export type ListAppsCommandOutput = ListAppsResponse & __MetadataBearer; +/** + *

Lists apps.

+ */ export class ListAppsCommand extends $Command< ListAppsCommandInput, ListAppsCommandOutput, @@ -31,6 +34,9 @@ export class ListAppsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListAutoMLJobsCommand.ts b/clients/client-sagemaker/commands/ListAutoMLJobsCommand.ts index c1fa4ed1f49e8..2807f8196c719 100644 --- a/clients/client-sagemaker/commands/ListAutoMLJobsCommand.ts +++ b/clients/client-sagemaker/commands/ListAutoMLJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAutoMLJobsCommandInput = ListAutoMLJobsRequest; export type ListAutoMLJobsCommandOutput = ListAutoMLJobsResponse & __MetadataBearer; +/** + *

Request a list of jobs.

+ */ export class ListAutoMLJobsCommand extends $Command< ListAutoMLJobsCommandInput, ListAutoMLJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListAutoMLJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListCandidatesForAutoMLJobCommand.ts b/clients/client-sagemaker/commands/ListCandidatesForAutoMLJobCommand.ts index 66e1698d527d6..9923ee42cdce7 100644 --- a/clients/client-sagemaker/commands/ListCandidatesForAutoMLJobCommand.ts +++ b/clients/client-sagemaker/commands/ListCandidatesForAutoMLJobCommand.ts @@ -20,6 +20,9 @@ import { export type ListCandidatesForAutoMLJobCommandInput = ListCandidatesForAutoMLJobRequest; export type ListCandidatesForAutoMLJobCommandOutput = ListCandidatesForAutoMLJobResponse & __MetadataBearer; +/** + *

List the Candidates created for the job.

+ */ export class ListCandidatesForAutoMLJobCommand extends $Command< ListCandidatesForAutoMLJobCommandInput, ListCandidatesForAutoMLJobCommandOutput, @@ -34,6 +37,9 @@ export class ListCandidatesForAutoMLJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListCodeRepositoriesCommand.ts b/clients/client-sagemaker/commands/ListCodeRepositoriesCommand.ts index e54a867f16b1d..2581282e208be 100644 --- a/clients/client-sagemaker/commands/ListCodeRepositoriesCommand.ts +++ b/clients/client-sagemaker/commands/ListCodeRepositoriesCommand.ts @@ -20,6 +20,9 @@ import { export type ListCodeRepositoriesCommandInput = ListCodeRepositoriesInput; export type ListCodeRepositoriesCommandOutput = ListCodeRepositoriesOutput & __MetadataBearer; +/** + *

Gets a list of the Git repositories in your account.

+ */ export class ListCodeRepositoriesCommand extends $Command< ListCodeRepositoriesCommandInput, ListCodeRepositoriesCommandOutput, @@ -34,6 +37,9 @@ export class ListCodeRepositoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListCompilationJobsCommand.ts b/clients/client-sagemaker/commands/ListCompilationJobsCommand.ts index c71f317ee76da..60300f22da601 100644 --- a/clients/client-sagemaker/commands/ListCompilationJobsCommand.ts +++ b/clients/client-sagemaker/commands/ListCompilationJobsCommand.ts @@ -20,6 +20,11 @@ import { export type ListCompilationJobsCommandInput = ListCompilationJobsRequest; export type ListCompilationJobsCommandOutput = ListCompilationJobsResponse & __MetadataBearer; +/** + *

Lists model compilation jobs that satisfy various filters.

+ *

To create a model compilation job, use CreateCompilationJob. To get + * information about a particular model compilation job you have created, use DescribeCompilationJob.

+ */ export class ListCompilationJobsCommand extends $Command< ListCompilationJobsCommandInput, ListCompilationJobsCommandOutput, @@ -34,6 +39,9 @@ export class ListCompilationJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListDomainsCommand.ts b/clients/client-sagemaker/commands/ListDomainsCommand.ts index cc6c3d375c4b1..6fde955edd04f 100644 --- a/clients/client-sagemaker/commands/ListDomainsCommand.ts +++ b/clients/client-sagemaker/commands/ListDomainsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDomainsCommandInput = ListDomainsRequest; export type ListDomainsCommandOutput = ListDomainsResponse & __MetadataBearer; +/** + *

Lists the domains.

+ */ export class ListDomainsCommand extends $Command< ListDomainsCommandInput, ListDomainsCommandOutput, @@ -34,6 +37,9 @@ export class ListDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListEndpointConfigsCommand.ts b/clients/client-sagemaker/commands/ListEndpointConfigsCommand.ts index 99aeae31a4bec..38a27faeb1bae 100644 --- a/clients/client-sagemaker/commands/ListEndpointConfigsCommand.ts +++ b/clients/client-sagemaker/commands/ListEndpointConfigsCommand.ts @@ -20,6 +20,9 @@ import { export type ListEndpointConfigsCommandInput = ListEndpointConfigsInput; export type ListEndpointConfigsCommandOutput = ListEndpointConfigsOutput & __MetadataBearer; +/** + *

Lists endpoint configurations.

+ */ export class ListEndpointConfigsCommand extends $Command< ListEndpointConfigsCommandInput, ListEndpointConfigsCommandOutput, @@ -34,6 +37,9 @@ export class ListEndpointConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListEndpointsCommand.ts b/clients/client-sagemaker/commands/ListEndpointsCommand.ts index 09fdca2ed2640..84b7100602bb2 100644 --- a/clients/client-sagemaker/commands/ListEndpointsCommand.ts +++ b/clients/client-sagemaker/commands/ListEndpointsCommand.ts @@ -20,6 +20,9 @@ import { export type ListEndpointsCommandInput = ListEndpointsInput; export type ListEndpointsCommandOutput = ListEndpointsOutput & __MetadataBearer; +/** + *

Lists endpoints.

+ */ export class ListEndpointsCommand extends $Command< ListEndpointsCommandInput, ListEndpointsCommandOutput, @@ -34,6 +37,9 @@ export class ListEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListExperimentsCommand.ts b/clients/client-sagemaker/commands/ListExperimentsCommand.ts index 09c3c24db1468..9460582e0a6fa 100644 --- a/clients/client-sagemaker/commands/ListExperimentsCommand.ts +++ b/clients/client-sagemaker/commands/ListExperimentsCommand.ts @@ -20,6 +20,11 @@ import { export type ListExperimentsCommandInput = ListExperimentsRequest; export type ListExperimentsCommandOutput = ListExperimentsResponse & __MetadataBearer; +/** + *

Lists all the experiments in your account. The list can be filtered to show only + * experiments that were created in a specific time range. The list can be sorted by experiment + * name or creation time.

+ */ export class ListExperimentsCommand extends $Command< ListExperimentsCommandInput, ListExperimentsCommandOutput, @@ -34,6 +39,9 @@ export class ListExperimentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListFlowDefinitionsCommand.ts b/clients/client-sagemaker/commands/ListFlowDefinitionsCommand.ts index fdec91788d37b..a73e5ae7e79f1 100644 --- a/clients/client-sagemaker/commands/ListFlowDefinitionsCommand.ts +++ b/clients/client-sagemaker/commands/ListFlowDefinitionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFlowDefinitionsCommandInput = ListFlowDefinitionsRequest; export type ListFlowDefinitionsCommandOutput = ListFlowDefinitionsResponse & __MetadataBearer; +/** + *

Returns information about the flow definitions in your account.

+ */ export class ListFlowDefinitionsCommand extends $Command< ListFlowDefinitionsCommandInput, ListFlowDefinitionsCommandOutput, @@ -34,6 +37,9 @@ export class ListFlowDefinitionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListHumanTaskUisCommand.ts b/clients/client-sagemaker/commands/ListHumanTaskUisCommand.ts index 7c7152a204317..d48eb1207f782 100644 --- a/clients/client-sagemaker/commands/ListHumanTaskUisCommand.ts +++ b/clients/client-sagemaker/commands/ListHumanTaskUisCommand.ts @@ -20,6 +20,9 @@ import { export type ListHumanTaskUisCommandInput = ListHumanTaskUisRequest; export type ListHumanTaskUisCommandOutput = ListHumanTaskUisResponse & __MetadataBearer; +/** + *

Returns information about the human task user interfaces in your account.

+ */ export class ListHumanTaskUisCommand extends $Command< ListHumanTaskUisCommandInput, ListHumanTaskUisCommandOutput, @@ -34,6 +37,9 @@ export class ListHumanTaskUisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListHyperParameterTuningJobsCommand.ts b/clients/client-sagemaker/commands/ListHyperParameterTuningJobsCommand.ts index afffc68949ad3..e01fb417a64ed 100644 --- a/clients/client-sagemaker/commands/ListHyperParameterTuningJobsCommand.ts +++ b/clients/client-sagemaker/commands/ListHyperParameterTuningJobsCommand.ts @@ -20,6 +20,11 @@ import { export type ListHyperParameterTuningJobsCommandInput = ListHyperParameterTuningJobsRequest; export type ListHyperParameterTuningJobsCommandOutput = ListHyperParameterTuningJobsResponse & __MetadataBearer; +/** + *

Gets a list of HyperParameterTuningJobSummary objects that + * describe + * the hyperparameter tuning jobs launched in your account.

+ */ export class ListHyperParameterTuningJobsCommand extends $Command< ListHyperParameterTuningJobsCommandInput, ListHyperParameterTuningJobsCommandOutput, @@ -34,6 +39,9 @@ export class ListHyperParameterTuningJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListImageVersionsCommand.ts b/clients/client-sagemaker/commands/ListImageVersionsCommand.ts index 8964a7e154199..63f392144732b 100644 --- a/clients/client-sagemaker/commands/ListImageVersionsCommand.ts +++ b/clients/client-sagemaker/commands/ListImageVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListImageVersionsCommandInput = ListImageVersionsRequest; export type ListImageVersionsCommandOutput = ListImageVersionsResponse & __MetadataBearer; +/** + *

Lists the versions of a specified image and their properties. The list can be filtered + * by creation time or modified time.

+ */ export class ListImageVersionsCommand extends $Command< ListImageVersionsCommandInput, ListImageVersionsCommandOutput, @@ -34,6 +38,9 @@ export class ListImageVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListImagesCommand.ts b/clients/client-sagemaker/commands/ListImagesCommand.ts index a154da1a74591..0a7cd8a37f292 100644 --- a/clients/client-sagemaker/commands/ListImagesCommand.ts +++ b/clients/client-sagemaker/commands/ListImagesCommand.ts @@ -20,6 +20,10 @@ import { export type ListImagesCommandInput = ListImagesRequest; export type ListImagesCommandOutput = ListImagesResponse & __MetadataBearer; +/** + *

Lists the images in your account and their properties. The list can be filtered by + * creation time or modified time, and whether the image name contains a specified string.

+ */ export class ListImagesCommand extends $Command< ListImagesCommandInput, ListImagesCommandOutput, @@ -34,6 +38,9 @@ export class ListImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListLabelingJobsCommand.ts b/clients/client-sagemaker/commands/ListLabelingJobsCommand.ts index f3e7723f63135..1ffa30e9954f2 100644 --- a/clients/client-sagemaker/commands/ListLabelingJobsCommand.ts +++ b/clients/client-sagemaker/commands/ListLabelingJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListLabelingJobsCommandInput = ListLabelingJobsRequest; export type ListLabelingJobsCommandOutput = ListLabelingJobsResponse & __MetadataBearer; +/** + *

Gets a list of labeling jobs.

+ */ export class ListLabelingJobsCommand extends $Command< ListLabelingJobsCommandInput, ListLabelingJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListLabelingJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListLabelingJobsForWorkteamCommand.ts b/clients/client-sagemaker/commands/ListLabelingJobsForWorkteamCommand.ts index 6419525d52d6d..7cf0d4928b1bd 100644 --- a/clients/client-sagemaker/commands/ListLabelingJobsForWorkteamCommand.ts +++ b/clients/client-sagemaker/commands/ListLabelingJobsForWorkteamCommand.ts @@ -20,6 +20,9 @@ import { export type ListLabelingJobsForWorkteamCommandInput = ListLabelingJobsForWorkteamRequest; export type ListLabelingJobsForWorkteamCommandOutput = ListLabelingJobsForWorkteamResponse & __MetadataBearer; +/** + *

Gets a list of labeling jobs assigned to a specified work team.

+ */ export class ListLabelingJobsForWorkteamCommand extends $Command< ListLabelingJobsForWorkteamCommandInput, ListLabelingJobsForWorkteamCommandOutput, @@ -34,6 +37,9 @@ export class ListLabelingJobsForWorkteamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListModelPackagesCommand.ts b/clients/client-sagemaker/commands/ListModelPackagesCommand.ts index e30697689b048..56fa062b077e5 100644 --- a/clients/client-sagemaker/commands/ListModelPackagesCommand.ts +++ b/clients/client-sagemaker/commands/ListModelPackagesCommand.ts @@ -20,6 +20,9 @@ import { export type ListModelPackagesCommandInput = ListModelPackagesInput; export type ListModelPackagesCommandOutput = ListModelPackagesOutput & __MetadataBearer; +/** + *

Lists the model packages that have been created.

+ */ export class ListModelPackagesCommand extends $Command< ListModelPackagesCommandInput, ListModelPackagesCommandOutput, @@ -34,6 +37,9 @@ export class ListModelPackagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListModelsCommand.ts b/clients/client-sagemaker/commands/ListModelsCommand.ts index f7427749b9654..2f7e9dee64aa7 100644 --- a/clients/client-sagemaker/commands/ListModelsCommand.ts +++ b/clients/client-sagemaker/commands/ListModelsCommand.ts @@ -20,6 +20,9 @@ import { export type ListModelsCommandInput = ListModelsInput; export type ListModelsCommandOutput = ListModelsOutput & __MetadataBearer; +/** + *

Lists models created with the CreateModel API.

+ */ export class ListModelsCommand extends $Command< ListModelsCommandInput, ListModelsCommandOutput, @@ -34,6 +37,9 @@ export class ListModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListMonitoringExecutionsCommand.ts b/clients/client-sagemaker/commands/ListMonitoringExecutionsCommand.ts index e2f386f8dc61c..76ffe7f0ef14b 100644 --- a/clients/client-sagemaker/commands/ListMonitoringExecutionsCommand.ts +++ b/clients/client-sagemaker/commands/ListMonitoringExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListMonitoringExecutionsCommandInput = ListMonitoringExecutionsRequest; export type ListMonitoringExecutionsCommandOutput = ListMonitoringExecutionsResponse & __MetadataBearer; +/** + *

Returns list of all monitoring job executions.

+ */ export class ListMonitoringExecutionsCommand extends $Command< ListMonitoringExecutionsCommandInput, ListMonitoringExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class ListMonitoringExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListMonitoringSchedulesCommand.ts b/clients/client-sagemaker/commands/ListMonitoringSchedulesCommand.ts index 2065078bdaa79..07cbd1979696f 100644 --- a/clients/client-sagemaker/commands/ListMonitoringSchedulesCommand.ts +++ b/clients/client-sagemaker/commands/ListMonitoringSchedulesCommand.ts @@ -20,6 +20,9 @@ import { export type ListMonitoringSchedulesCommandInput = ListMonitoringSchedulesRequest; export type ListMonitoringSchedulesCommandOutput = ListMonitoringSchedulesResponse & __MetadataBearer; +/** + *

Returns list of all monitoring schedules.

+ */ export class ListMonitoringSchedulesCommand extends $Command< ListMonitoringSchedulesCommandInput, ListMonitoringSchedulesCommandOutput, @@ -34,6 +37,9 @@ export class ListMonitoringSchedulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListNotebookInstanceLifecycleConfigsCommand.ts b/clients/client-sagemaker/commands/ListNotebookInstanceLifecycleConfigsCommand.ts index 9d4aabc3b9647..79e4213211950 100644 --- a/clients/client-sagemaker/commands/ListNotebookInstanceLifecycleConfigsCommand.ts +++ b/clients/client-sagemaker/commands/ListNotebookInstanceLifecycleConfigsCommand.ts @@ -24,6 +24,9 @@ export type ListNotebookInstanceLifecycleConfigsCommandInput = ListNotebookInsta export type ListNotebookInstanceLifecycleConfigsCommandOutput = ListNotebookInstanceLifecycleConfigsOutput & __MetadataBearer; +/** + *

Lists notebook instance lifestyle configurations created with the CreateNotebookInstanceLifecycleConfig API.

+ */ export class ListNotebookInstanceLifecycleConfigsCommand extends $Command< ListNotebookInstanceLifecycleConfigsCommandInput, ListNotebookInstanceLifecycleConfigsCommandOutput, @@ -38,6 +41,9 @@ export class ListNotebookInstanceLifecycleConfigsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListNotebookInstancesCommand.ts b/clients/client-sagemaker/commands/ListNotebookInstancesCommand.ts index 595743f9bd9ba..bbadd6dbba0f5 100644 --- a/clients/client-sagemaker/commands/ListNotebookInstancesCommand.ts +++ b/clients/client-sagemaker/commands/ListNotebookInstancesCommand.ts @@ -20,6 +20,10 @@ import { export type ListNotebookInstancesCommandInput = ListNotebookInstancesInput; export type ListNotebookInstancesCommandOutput = ListNotebookInstancesOutput & __MetadataBearer; +/** + *

Returns a list of the Amazon SageMaker notebook instances in the requester's account in an AWS + * Region.

+ */ export class ListNotebookInstancesCommand extends $Command< ListNotebookInstancesCommandInput, ListNotebookInstancesCommandOutput, @@ -34,6 +38,9 @@ export class ListNotebookInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListProcessingJobsCommand.ts b/clients/client-sagemaker/commands/ListProcessingJobsCommand.ts index 0d7d753b7a191..5b2fd527a025d 100644 --- a/clients/client-sagemaker/commands/ListProcessingJobsCommand.ts +++ b/clients/client-sagemaker/commands/ListProcessingJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProcessingJobsCommandInput = ListProcessingJobsRequest; export type ListProcessingJobsCommandOutput = ListProcessingJobsResponse & __MetadataBearer; +/** + *

Lists processing jobs that satisfy various filters.

+ */ export class ListProcessingJobsCommand extends $Command< ListProcessingJobsCommandInput, ListProcessingJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListProcessingJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListSubscribedWorkteamsCommand.ts b/clients/client-sagemaker/commands/ListSubscribedWorkteamsCommand.ts index bae9888fe8be2..486060d3e8ca4 100644 --- a/clients/client-sagemaker/commands/ListSubscribedWorkteamsCommand.ts +++ b/clients/client-sagemaker/commands/ListSubscribedWorkteamsCommand.ts @@ -20,6 +20,11 @@ import { export type ListSubscribedWorkteamsCommandInput = ListSubscribedWorkteamsRequest; export type ListSubscribedWorkteamsCommandOutput = ListSubscribedWorkteamsResponse & __MetadataBearer; +/** + *

Gets a list of the work teams that you are subscribed to in the AWS Marketplace. The + * list may be empty if no work team satisfies the filter specified in the + * NameContains parameter.

+ */ export class ListSubscribedWorkteamsCommand extends $Command< ListSubscribedWorkteamsCommandInput, ListSubscribedWorkteamsCommandOutput, @@ -34,6 +39,9 @@ export class ListSubscribedWorkteamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListTagsCommand.ts b/clients/client-sagemaker/commands/ListTagsCommand.ts index c0568584b66db..0d09ba9e32fc9 100644 --- a/clients/client-sagemaker/commands/ListTagsCommand.ts +++ b/clients/client-sagemaker/commands/ListTagsCommand.ts @@ -17,6 +17,9 @@ import { export type ListTagsCommandInput = ListTagsInput; export type ListTagsCommandOutput = ListTagsOutput & __MetadataBearer; +/** + *

Returns the tags for the specified Amazon SageMaker resource.

+ */ export class ListTagsCommand extends $Command< ListTagsCommandInput, ListTagsCommandOutput, @@ -31,6 +34,9 @@ export class ListTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListTrainingJobsCommand.ts b/clients/client-sagemaker/commands/ListTrainingJobsCommand.ts index b94e7c64931bc..e5dfc67c15077 100644 --- a/clients/client-sagemaker/commands/ListTrainingJobsCommand.ts +++ b/clients/client-sagemaker/commands/ListTrainingJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTrainingJobsCommandInput = ListTrainingJobsRequest; export type ListTrainingJobsCommandOutput = ListTrainingJobsResponse & __MetadataBearer; +/** + *

Lists training jobs.

+ */ export class ListTrainingJobsCommand extends $Command< ListTrainingJobsCommandInput, ListTrainingJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListTrainingJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListTrainingJobsForHyperParameterTuningJobCommand.ts b/clients/client-sagemaker/commands/ListTrainingJobsForHyperParameterTuningJobCommand.ts index c626ec53832b1..3b8fd10007e2b 100644 --- a/clients/client-sagemaker/commands/ListTrainingJobsForHyperParameterTuningJobCommand.ts +++ b/clients/client-sagemaker/commands/ListTrainingJobsForHyperParameterTuningJobCommand.ts @@ -24,6 +24,10 @@ export type ListTrainingJobsForHyperParameterTuningJobCommandInput = ListTrainin export type ListTrainingJobsForHyperParameterTuningJobCommandOutput = ListTrainingJobsForHyperParameterTuningJobResponse & __MetadataBearer; +/** + *

Gets a list of TrainingJobSummary objects that describe the training + * jobs that a hyperparameter tuning job launched.

+ */ export class ListTrainingJobsForHyperParameterTuningJobCommand extends $Command< ListTrainingJobsForHyperParameterTuningJobCommandInput, ListTrainingJobsForHyperParameterTuningJobCommandOutput, @@ -38,6 +42,9 @@ export class ListTrainingJobsForHyperParameterTuningJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListTransformJobsCommand.ts b/clients/client-sagemaker/commands/ListTransformJobsCommand.ts index df4325afa3d4c..9c78927a4e636 100644 --- a/clients/client-sagemaker/commands/ListTransformJobsCommand.ts +++ b/clients/client-sagemaker/commands/ListTransformJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTransformJobsCommandInput = ListTransformJobsRequest; export type ListTransformJobsCommandOutput = ListTransformJobsResponse & __MetadataBearer; +/** + *

Lists transform jobs.

+ */ export class ListTransformJobsCommand extends $Command< ListTransformJobsCommandInput, ListTransformJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListTransformJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListTrialComponentsCommand.ts b/clients/client-sagemaker/commands/ListTrialComponentsCommand.ts index 47c3b90132664..d17d7ab2e570c 100644 --- a/clients/client-sagemaker/commands/ListTrialComponentsCommand.ts +++ b/clients/client-sagemaker/commands/ListTrialComponentsCommand.ts @@ -20,6 +20,28 @@ import { export type ListTrialComponentsCommandInput = ListTrialComponentsRequest; export type ListTrialComponentsCommandOutput = ListTrialComponentsResponse & __MetadataBearer; +/** + *

Lists the trial components in your account. You can sort the list by trial component name + * or creation time. You can filter the list to show only components that were created in a + * specific time range. You can also filter on one of the following:

+ *
    + *
  • + *

    + * ExperimentName + *

    + *
  • + *
  • + *

    + * SourceArn + *

    + *
  • + *
  • + *

    + * TrialName + *

    + *
  • + *
+ */ export class ListTrialComponentsCommand extends $Command< ListTrialComponentsCommandInput, ListTrialComponentsCommandOutput, @@ -34,6 +56,9 @@ export class ListTrialComponentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListTrialsCommand.ts b/clients/client-sagemaker/commands/ListTrialsCommand.ts index 8575d62cd99c3..bf490174efbfb 100644 --- a/clients/client-sagemaker/commands/ListTrialsCommand.ts +++ b/clients/client-sagemaker/commands/ListTrialsCommand.ts @@ -20,6 +20,13 @@ import { export type ListTrialsCommandInput = ListTrialsRequest; export type ListTrialsCommandOutput = ListTrialsResponse & __MetadataBearer; +/** + *

Lists the trials in your account. Specify an experiment name to limit the list to the + * trials that are part of that experiment. Specify a trial component name to limit the list to + * the trials that associated with that trial component. The list can be filtered to show only + * trials that were created in a specific time range. The list can be sorted by trial name or + * creation time.

+ */ export class ListTrialsCommand extends $Command< ListTrialsCommandInput, ListTrialsCommandOutput, @@ -34,6 +41,9 @@ export class ListTrialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListUserProfilesCommand.ts b/clients/client-sagemaker/commands/ListUserProfilesCommand.ts index af81ed34d179e..94e8c349133d4 100644 --- a/clients/client-sagemaker/commands/ListUserProfilesCommand.ts +++ b/clients/client-sagemaker/commands/ListUserProfilesCommand.ts @@ -20,6 +20,9 @@ import { export type ListUserProfilesCommandInput = ListUserProfilesRequest; export type ListUserProfilesCommandOutput = ListUserProfilesResponse & __MetadataBearer; +/** + *

Lists user profiles.

+ */ export class ListUserProfilesCommand extends $Command< ListUserProfilesCommandInput, ListUserProfilesCommandOutput, @@ -34,6 +37,9 @@ export class ListUserProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListWorkforcesCommand.ts b/clients/client-sagemaker/commands/ListWorkforcesCommand.ts index e5dc92bc73439..8620b50a54c74 100644 --- a/clients/client-sagemaker/commands/ListWorkforcesCommand.ts +++ b/clients/client-sagemaker/commands/ListWorkforcesCommand.ts @@ -20,6 +20,10 @@ import { export type ListWorkforcesCommandInput = ListWorkforcesRequest; export type ListWorkforcesCommandOutput = ListWorkforcesResponse & __MetadataBearer; +/** + *

Use this operation to list all private and vendor workforces in an AWS Region. Note that you can only + * have one private workforce per AWS Region.

+ */ export class ListWorkforcesCommand extends $Command< ListWorkforcesCommandInput, ListWorkforcesCommandOutput, @@ -34,6 +38,9 @@ export class ListWorkforcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/ListWorkteamsCommand.ts b/clients/client-sagemaker/commands/ListWorkteamsCommand.ts index 1cadb6d9970e9..2741a900c7efb 100644 --- a/clients/client-sagemaker/commands/ListWorkteamsCommand.ts +++ b/clients/client-sagemaker/commands/ListWorkteamsCommand.ts @@ -20,6 +20,11 @@ import { export type ListWorkteamsCommandInput = ListWorkteamsRequest; export type ListWorkteamsCommandOutput = ListWorkteamsResponse & __MetadataBearer; +/** + *

Gets a list of private work teams that you have defined in a region. The list may be empty if + * no work team satisfies the filter specified in the NameContains + * parameter.

+ */ export class ListWorkteamsCommand extends $Command< ListWorkteamsCommandInput, ListWorkteamsCommandOutput, @@ -34,6 +39,9 @@ export class ListWorkteamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/RenderUiTemplateCommand.ts b/clients/client-sagemaker/commands/RenderUiTemplateCommand.ts index b53c4590b6317..4b4de5975bdda 100644 --- a/clients/client-sagemaker/commands/RenderUiTemplateCommand.ts +++ b/clients/client-sagemaker/commands/RenderUiTemplateCommand.ts @@ -20,6 +20,9 @@ import { export type RenderUiTemplateCommandInput = RenderUiTemplateRequest; export type RenderUiTemplateCommandOutput = RenderUiTemplateResponse & __MetadataBearer; +/** + *

Renders the UI template so that you can preview the worker's experience.

+ */ export class RenderUiTemplateCommand extends $Command< RenderUiTemplateCommandInput, RenderUiTemplateCommandOutput, @@ -34,6 +37,9 @@ export class RenderUiTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/SearchCommand.ts b/clients/client-sagemaker/commands/SearchCommand.ts index c3834ea828709..971be9d9b0ab7 100644 --- a/clients/client-sagemaker/commands/SearchCommand.ts +++ b/clients/client-sagemaker/commands/SearchCommand.ts @@ -18,6 +18,13 @@ import { export type SearchCommandInput = SearchRequest; export type SearchCommandOutput = SearchResponse & __MetadataBearer; +/** + *

Finds Amazon SageMaker resources that match a search query. Matching resources are returned + * as a list of SearchRecord objects in the response. You can sort the search + * results by any resource property in a ascending or descending order.

+ *

You can query against the following value types: numeric, text, Boolean, and + * timestamp.

+ */ export class SearchCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -28,6 +35,9 @@ export class SearchCommand extends $Command, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StartMonitoringScheduleCommand.ts b/clients/client-sagemaker/commands/StartMonitoringScheduleCommand.ts index c942ee67ca4f3..935b4dbca576c 100644 --- a/clients/client-sagemaker/commands/StartMonitoringScheduleCommand.ts +++ b/clients/client-sagemaker/commands/StartMonitoringScheduleCommand.ts @@ -20,6 +20,12 @@ import { export type StartMonitoringScheduleCommandInput = StartMonitoringScheduleRequest; export type StartMonitoringScheduleCommandOutput = __MetadataBearer; +/** + *

Starts a previously stopped monitoring schedule.

+ * + *

New monitoring schedules are immediately started after creation.

+ *
+ */ export class StartMonitoringScheduleCommand extends $Command< StartMonitoringScheduleCommandInput, StartMonitoringScheduleCommandOutput, @@ -34,6 +40,9 @@ export class StartMonitoringScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StartNotebookInstanceCommand.ts b/clients/client-sagemaker/commands/StartNotebookInstanceCommand.ts index 754a279150794..3b78ec4cda3ca 100644 --- a/clients/client-sagemaker/commands/StartNotebookInstanceCommand.ts +++ b/clients/client-sagemaker/commands/StartNotebookInstanceCommand.ts @@ -20,6 +20,12 @@ import { export type StartNotebookInstanceCommandInput = StartNotebookInstanceInput; export type StartNotebookInstanceCommandOutput = __MetadataBearer; +/** + *

Launches an ML compute instance with the latest version of the libraries and + * attaches your ML storage volume. After configuring the notebook instance, Amazon SageMaker sets the + * notebook instance status to InService. A notebook instance's status must be + * InService before you can connect to your Jupyter notebook.

+ */ export class StartNotebookInstanceCommand extends $Command< StartNotebookInstanceCommandInput, StartNotebookInstanceCommandOutput, @@ -34,6 +40,9 @@ export class StartNotebookInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopAutoMLJobCommand.ts b/clients/client-sagemaker/commands/StopAutoMLJobCommand.ts index bb0ecd3665bcf..186337bb737f1 100644 --- a/clients/client-sagemaker/commands/StopAutoMLJobCommand.ts +++ b/clients/client-sagemaker/commands/StopAutoMLJobCommand.ts @@ -20,6 +20,9 @@ import { export type StopAutoMLJobCommandInput = StopAutoMLJobRequest; export type StopAutoMLJobCommandOutput = __MetadataBearer; +/** + *

A method for forcing the termination of a running job.

+ */ export class StopAutoMLJobCommand extends $Command< StopAutoMLJobCommandInput, StopAutoMLJobCommandOutput, @@ -34,6 +37,9 @@ export class StopAutoMLJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopCompilationJobCommand.ts b/clients/client-sagemaker/commands/StopCompilationJobCommand.ts index 2b4a00c587ae6..7c6ce80ac644d 100644 --- a/clients/client-sagemaker/commands/StopCompilationJobCommand.ts +++ b/clients/client-sagemaker/commands/StopCompilationJobCommand.ts @@ -20,6 +20,14 @@ import { export type StopCompilationJobCommandInput = StopCompilationJobRequest; export type StopCompilationJobCommandOutput = __MetadataBearer; +/** + *

Stops a model compilation job.

+ *

To stop a job, Amazon SageMaker sends the algorithm the SIGTERM signal. This gracefully shuts the + * job down. If the job hasn't stopped, it sends the SIGKILL signal.

+ *

When it receives a StopCompilationJob request, Amazon SageMaker changes the CompilationJobSummary$CompilationJobStatus of the job to + * Stopping. After Amazon SageMaker stops the job, it sets the CompilationJobSummary$CompilationJobStatus to Stopped. + *

+ */ export class StopCompilationJobCommand extends $Command< StopCompilationJobCommandInput, StopCompilationJobCommandOutput, @@ -34,6 +42,9 @@ export class StopCompilationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopHyperParameterTuningJobCommand.ts b/clients/client-sagemaker/commands/StopHyperParameterTuningJobCommand.ts index b134a9fa4be3a..b9378b32120aa 100644 --- a/clients/client-sagemaker/commands/StopHyperParameterTuningJobCommand.ts +++ b/clients/client-sagemaker/commands/StopHyperParameterTuningJobCommand.ts @@ -20,6 +20,15 @@ import { export type StopHyperParameterTuningJobCommandInput = StopHyperParameterTuningJobRequest; export type StopHyperParameterTuningJobCommandOutput = __MetadataBearer; +/** + *

Stops a running hyperparameter tuning job and all running training jobs that the + * tuning job launched.

+ *

All model artifacts output from the training jobs are stored in Amazon Simple Storage Service (Amazon S3). All + * data that the training jobs write to Amazon CloudWatch Logs are still available in CloudWatch. After the + * tuning job moves to the Stopped state, it releases all + * reserved + * resources for the tuning job.

+ */ export class StopHyperParameterTuningJobCommand extends $Command< StopHyperParameterTuningJobCommandInput, StopHyperParameterTuningJobCommandOutput, @@ -34,6 +43,9 @@ export class StopHyperParameterTuningJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopLabelingJobCommand.ts b/clients/client-sagemaker/commands/StopLabelingJobCommand.ts index 0fe6be15b4f13..c57383fd380c5 100644 --- a/clients/client-sagemaker/commands/StopLabelingJobCommand.ts +++ b/clients/client-sagemaker/commands/StopLabelingJobCommand.ts @@ -20,6 +20,10 @@ import { export type StopLabelingJobCommandInput = StopLabelingJobRequest; export type StopLabelingJobCommandOutput = __MetadataBearer; +/** + *

Stops a running labeling job. A job that is stopped cannot be restarted. Any results + * obtained before the job is stopped are placed in the Amazon S3 output bucket.

+ */ export class StopLabelingJobCommand extends $Command< StopLabelingJobCommandInput, StopLabelingJobCommandOutput, @@ -34,6 +38,9 @@ export class StopLabelingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopMonitoringScheduleCommand.ts b/clients/client-sagemaker/commands/StopMonitoringScheduleCommand.ts index 1ca7073d6ed34..c058f902d4931 100644 --- a/clients/client-sagemaker/commands/StopMonitoringScheduleCommand.ts +++ b/clients/client-sagemaker/commands/StopMonitoringScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type StopMonitoringScheduleCommandInput = StopMonitoringScheduleRequest; export type StopMonitoringScheduleCommandOutput = __MetadataBearer; +/** + *

Stops a previously started monitoring schedule.

+ */ export class StopMonitoringScheduleCommand extends $Command< StopMonitoringScheduleCommandInput, StopMonitoringScheduleCommandOutput, @@ -34,6 +37,9 @@ export class StopMonitoringScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopNotebookInstanceCommand.ts b/clients/client-sagemaker/commands/StopNotebookInstanceCommand.ts index cc5b3ab098a9b..39fa9b1719214 100644 --- a/clients/client-sagemaker/commands/StopNotebookInstanceCommand.ts +++ b/clients/client-sagemaker/commands/StopNotebookInstanceCommand.ts @@ -20,6 +20,17 @@ import { export type StopNotebookInstanceCommandInput = StopNotebookInstanceInput; export type StopNotebookInstanceCommandOutput = __MetadataBearer; +/** + *

Terminates the ML compute instance. Before terminating the instance, Amazon SageMaker + * disconnects the ML storage volume from it. Amazon SageMaker preserves the ML storage volume. Amazon SageMaker + * stops charging you for the ML compute instance when you call + * StopNotebookInstance.

+ *

To access data on the ML storage volume for a notebook instance that has been + * terminated, call the StartNotebookInstance API. + * StartNotebookInstance launches another ML compute instance, configures + * it, and attaches the preserved ML storage volume so you can continue your work. + *

+ */ export class StopNotebookInstanceCommand extends $Command< StopNotebookInstanceCommandInput, StopNotebookInstanceCommandOutput, @@ -34,6 +45,9 @@ export class StopNotebookInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopProcessingJobCommand.ts b/clients/client-sagemaker/commands/StopProcessingJobCommand.ts index 956fddcf97ce2..4955ad679857d 100644 --- a/clients/client-sagemaker/commands/StopProcessingJobCommand.ts +++ b/clients/client-sagemaker/commands/StopProcessingJobCommand.ts @@ -20,6 +20,9 @@ import { export type StopProcessingJobCommandInput = StopProcessingJobRequest; export type StopProcessingJobCommandOutput = __MetadataBearer; +/** + *

Stops a processing job.

+ */ export class StopProcessingJobCommand extends $Command< StopProcessingJobCommandInput, StopProcessingJobCommandOutput, @@ -34,6 +37,9 @@ export class StopProcessingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopTrainingJobCommand.ts b/clients/client-sagemaker/commands/StopTrainingJobCommand.ts index b9f307716657a..81c91abe6b808 100644 --- a/clients/client-sagemaker/commands/StopTrainingJobCommand.ts +++ b/clients/client-sagemaker/commands/StopTrainingJobCommand.ts @@ -20,6 +20,15 @@ import { export type StopTrainingJobCommandInput = StopTrainingJobRequest; export type StopTrainingJobCommandOutput = __MetadataBearer; +/** + *

Stops a training job. To stop a job, Amazon SageMaker sends the algorithm the + * SIGTERM signal, which delays job termination for 120 seconds. + * Algorithms might use this 120-second window to save the model artifacts, so the results + * of the training is not lost.

+ *

When it receives a StopTrainingJob request, Amazon SageMaker changes the status of + * the job to Stopping. After Amazon SageMaker stops the job, it sets the status to + * Stopped.

+ */ export class StopTrainingJobCommand extends $Command< StopTrainingJobCommandInput, StopTrainingJobCommandOutput, @@ -34,6 +43,9 @@ export class StopTrainingJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/StopTransformJobCommand.ts b/clients/client-sagemaker/commands/StopTransformJobCommand.ts index a35eefd08fff9..1f2e3d7f51bdb 100644 --- a/clients/client-sagemaker/commands/StopTransformJobCommand.ts +++ b/clients/client-sagemaker/commands/StopTransformJobCommand.ts @@ -20,6 +20,14 @@ import { export type StopTransformJobCommandInput = StopTransformJobRequest; export type StopTransformJobCommandOutput = __MetadataBearer; +/** + *

Stops a transform job.

+ *

When Amazon SageMaker receives a StopTransformJob request, the status of the job + * changes to Stopping. After Amazon SageMaker + * stops + * the job, the status is set to Stopped. When you stop a transform job before + * it is completed, Amazon SageMaker doesn't store the job's output in Amazon S3.

+ */ export class StopTransformJobCommand extends $Command< StopTransformJobCommandInput, StopTransformJobCommandOutput, @@ -34,6 +42,9 @@ export class StopTransformJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateAppImageConfigCommand.ts b/clients/client-sagemaker/commands/UpdateAppImageConfigCommand.ts index f52cee430cb1d..0ff758ba91121 100644 --- a/clients/client-sagemaker/commands/UpdateAppImageConfigCommand.ts +++ b/clients/client-sagemaker/commands/UpdateAppImageConfigCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAppImageConfigCommandInput = UpdateAppImageConfigRequest; export type UpdateAppImageConfigCommandOutput = UpdateAppImageConfigResponse & __MetadataBearer; +/** + *

Updates the properties of an AppImageConfig.

+ */ export class UpdateAppImageConfigCommand extends $Command< UpdateAppImageConfigCommandInput, UpdateAppImageConfigCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAppImageConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateCodeRepositoryCommand.ts b/clients/client-sagemaker/commands/UpdateCodeRepositoryCommand.ts index 4f59da13dcc48..7c4909a1f7558 100644 --- a/clients/client-sagemaker/commands/UpdateCodeRepositoryCommand.ts +++ b/clients/client-sagemaker/commands/UpdateCodeRepositoryCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateCodeRepositoryCommandInput = UpdateCodeRepositoryInput; export type UpdateCodeRepositoryCommandOutput = UpdateCodeRepositoryOutput & __MetadataBearer; +/** + *

Updates the specified Git repository with the specified values.

+ */ export class UpdateCodeRepositoryCommand extends $Command< UpdateCodeRepositoryCommandInput, UpdateCodeRepositoryCommandOutput, @@ -34,6 +37,9 @@ export class UpdateCodeRepositoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateDomainCommand.ts b/clients/client-sagemaker/commands/UpdateDomainCommand.ts index 29bd66e384b04..1148560b972ca 100644 --- a/clients/client-sagemaker/commands/UpdateDomainCommand.ts +++ b/clients/client-sagemaker/commands/UpdateDomainCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDomainCommandInput = UpdateDomainRequest; export type UpdateDomainCommandOutput = UpdateDomainResponse & __MetadataBearer; +/** + *

Updates the default settings for new user profiles in the domain.

+ */ export class UpdateDomainCommand extends $Command< UpdateDomainCommandInput, UpdateDomainCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateEndpointCommand.ts b/clients/client-sagemaker/commands/UpdateEndpointCommand.ts index 52f922aaa85fd..89e3356a0c4f6 100644 --- a/clients/client-sagemaker/commands/UpdateEndpointCommand.ts +++ b/clients/client-sagemaker/commands/UpdateEndpointCommand.ts @@ -20,6 +20,25 @@ import { export type UpdateEndpointCommandInput = UpdateEndpointInput; export type UpdateEndpointCommandOutput = UpdateEndpointOutput & __MetadataBearer; +/** + *

Deploys the new EndpointConfig specified in the request, switches to + * using newly created endpoint, and then deletes resources provisioned for the endpoint + * using the previous EndpointConfig (there is no availability loss).

+ *

When Amazon SageMaker receives the request, it sets the endpoint status to + * Updating. After updating the endpoint, it sets the status to + * InService. To check the status of an endpoint, use the DescribeEndpoint API. + * + *

+ * + *

You must not delete an EndpointConfig in use by an endpoint that is + * live or while the UpdateEndpoint or CreateEndpoint + * operations are being performed on the endpoint. To update an endpoint, you must + * create a new EndpointConfig.

+ *

If you delete the EndpointConfig of an endpoint that is active or + * being created or updated you may lose visibility into the instance type the endpoint + * is using. The endpoint must be deleted in order to stop incurring charges.

+ *
+ */ export class UpdateEndpointCommand extends $Command< UpdateEndpointCommandInput, UpdateEndpointCommandOutput, @@ -34,6 +53,9 @@ export class UpdateEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateEndpointWeightsAndCapacitiesCommand.ts b/clients/client-sagemaker/commands/UpdateEndpointWeightsAndCapacitiesCommand.ts index 8ab4b41fe0fbb..2122b34cebae5 100644 --- a/clients/client-sagemaker/commands/UpdateEndpointWeightsAndCapacitiesCommand.ts +++ b/clients/client-sagemaker/commands/UpdateEndpointWeightsAndCapacitiesCommand.ts @@ -21,6 +21,13 @@ export type UpdateEndpointWeightsAndCapacitiesCommandInput = UpdateEndpointWeigh export type UpdateEndpointWeightsAndCapacitiesCommandOutput = UpdateEndpointWeightsAndCapacitiesOutput & __MetadataBearer; +/** + *

Updates variant weight of one or more variants associated with an existing + * endpoint, or capacity of one variant associated with an existing endpoint. When it + * receives the request, Amazon SageMaker sets the endpoint status to Updating. After + * updating the endpoint, it sets the status to InService. To check the status + * of an endpoint, use the DescribeEndpoint API.

+ */ export class UpdateEndpointWeightsAndCapacitiesCommand extends $Command< UpdateEndpointWeightsAndCapacitiesCommandInput, UpdateEndpointWeightsAndCapacitiesCommandOutput, @@ -35,6 +42,9 @@ export class UpdateEndpointWeightsAndCapacitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateExperimentCommand.ts b/clients/client-sagemaker/commands/UpdateExperimentCommand.ts index fba6e9c5ed30b..2cc884e41cec5 100644 --- a/clients/client-sagemaker/commands/UpdateExperimentCommand.ts +++ b/clients/client-sagemaker/commands/UpdateExperimentCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateExperimentCommandInput = UpdateExperimentRequest; export type UpdateExperimentCommandOutput = UpdateExperimentResponse & __MetadataBearer; +/** + *

Adds, updates, or removes the description of an experiment. Updates the display name of an + * experiment.

+ */ export class UpdateExperimentCommand extends $Command< UpdateExperimentCommandInput, UpdateExperimentCommandOutput, @@ -34,6 +38,9 @@ export class UpdateExperimentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateImageCommand.ts b/clients/client-sagemaker/commands/UpdateImageCommand.ts index f941f95f06c8e..6b7ddb8512e7a 100644 --- a/clients/client-sagemaker/commands/UpdateImageCommand.ts +++ b/clients/client-sagemaker/commands/UpdateImageCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateImageCommandInput = UpdateImageRequest; export type UpdateImageCommandOutput = UpdateImageResponse & __MetadataBearer; +/** + *

Updates the properties of a SageMaker image. To change the image's tags, use the + * AddTags and DeleteTags APIs.

+ */ export class UpdateImageCommand extends $Command< UpdateImageCommandInput, UpdateImageCommandOutput, @@ -34,6 +38,9 @@ export class UpdateImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateMonitoringScheduleCommand.ts b/clients/client-sagemaker/commands/UpdateMonitoringScheduleCommand.ts index 8c779c18f0c9c..f0f5cc1579258 100644 --- a/clients/client-sagemaker/commands/UpdateMonitoringScheduleCommand.ts +++ b/clients/client-sagemaker/commands/UpdateMonitoringScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateMonitoringScheduleCommandInput = UpdateMonitoringScheduleRequest; export type UpdateMonitoringScheduleCommandOutput = UpdateMonitoringScheduleResponse & __MetadataBearer; +/** + *

Updates a previously created schedule.

+ */ export class UpdateMonitoringScheduleCommand extends $Command< UpdateMonitoringScheduleCommandInput, UpdateMonitoringScheduleCommandOutput, @@ -34,6 +37,9 @@ export class UpdateMonitoringScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateNotebookInstanceCommand.ts b/clients/client-sagemaker/commands/UpdateNotebookInstanceCommand.ts index f51ace2923a89..88595619aa8bc 100644 --- a/clients/client-sagemaker/commands/UpdateNotebookInstanceCommand.ts +++ b/clients/client-sagemaker/commands/UpdateNotebookInstanceCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateNotebookInstanceCommandInput = UpdateNotebookInstanceInput; export type UpdateNotebookInstanceCommandOutput = UpdateNotebookInstanceOutput & __MetadataBearer; +/** + *

Updates a notebook instance. NotebookInstance updates include upgrading or + * downgrading the ML compute instance used for your notebook instance to accommodate + * changes in your workload requirements.

+ */ export class UpdateNotebookInstanceCommand extends $Command< UpdateNotebookInstanceCommandInput, UpdateNotebookInstanceCommandOutput, @@ -34,6 +39,9 @@ export class UpdateNotebookInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateNotebookInstanceLifecycleConfigCommand.ts b/clients/client-sagemaker/commands/UpdateNotebookInstanceLifecycleConfigCommand.ts index a5c74ea7132d5..c6051baa196b3 100644 --- a/clients/client-sagemaker/commands/UpdateNotebookInstanceLifecycleConfigCommand.ts +++ b/clients/client-sagemaker/commands/UpdateNotebookInstanceLifecycleConfigCommand.ts @@ -24,6 +24,9 @@ export type UpdateNotebookInstanceLifecycleConfigCommandInput = UpdateNotebookIn export type UpdateNotebookInstanceLifecycleConfigCommandOutput = UpdateNotebookInstanceLifecycleConfigOutput & __MetadataBearer; +/** + *

Updates a notebook instance lifecycle configuration created with the CreateNotebookInstanceLifecycleConfig API.

+ */ export class UpdateNotebookInstanceLifecycleConfigCommand extends $Command< UpdateNotebookInstanceLifecycleConfigCommandInput, UpdateNotebookInstanceLifecycleConfigCommandOutput, @@ -38,6 +41,9 @@ export class UpdateNotebookInstanceLifecycleConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateTrialCommand.ts b/clients/client-sagemaker/commands/UpdateTrialCommand.ts index 65fc8e75b4f02..81337b4385681 100644 --- a/clients/client-sagemaker/commands/UpdateTrialCommand.ts +++ b/clients/client-sagemaker/commands/UpdateTrialCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTrialCommandInput = UpdateTrialRequest; export type UpdateTrialCommandOutput = UpdateTrialResponse & __MetadataBearer; +/** + *

Updates the display name of a trial.

+ */ export class UpdateTrialCommand extends $Command< UpdateTrialCommandInput, UpdateTrialCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTrialCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateTrialComponentCommand.ts b/clients/client-sagemaker/commands/UpdateTrialComponentCommand.ts index 91f74a156b9b2..d7c0b1fdbc8f5 100644 --- a/clients/client-sagemaker/commands/UpdateTrialComponentCommand.ts +++ b/clients/client-sagemaker/commands/UpdateTrialComponentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTrialComponentCommandInput = UpdateTrialComponentRequest; export type UpdateTrialComponentCommandOutput = UpdateTrialComponentResponse & __MetadataBearer; +/** + *

Updates one or more properties of a trial component.

+ */ export class UpdateTrialComponentCommand extends $Command< UpdateTrialComponentCommandInput, UpdateTrialComponentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTrialComponentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateUserProfileCommand.ts b/clients/client-sagemaker/commands/UpdateUserProfileCommand.ts index 8626b73c894a5..eb3a25f534dd9 100644 --- a/clients/client-sagemaker/commands/UpdateUserProfileCommand.ts +++ b/clients/client-sagemaker/commands/UpdateUserProfileCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateUserProfileCommandInput = UpdateUserProfileRequest; export type UpdateUserProfileCommandOutput = UpdateUserProfileResponse & __MetadataBearer; +/** + *

Updates a user profile.

+ */ export class UpdateUserProfileCommand extends $Command< UpdateUserProfileCommandInput, UpdateUserProfileCommandOutput, @@ -34,6 +37,9 @@ export class UpdateUserProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateWorkforceCommand.ts b/clients/client-sagemaker/commands/UpdateWorkforceCommand.ts index b55d6671d00d9..64c71793fb380 100644 --- a/clients/client-sagemaker/commands/UpdateWorkforceCommand.ts +++ b/clients/client-sagemaker/commands/UpdateWorkforceCommand.ts @@ -20,6 +20,30 @@ import { export type UpdateWorkforceCommandInput = UpdateWorkforceRequest; export type UpdateWorkforceCommandOutput = UpdateWorkforceResponse & __MetadataBearer; +/** + *

Use this operation to update your workforce. You can use this operation to + * require that workers use specific IP addresses to work on tasks + * and to update your OpenID Connect (OIDC) Identity Provider (IdP) workforce configuration.

+ * + *

Use SourceIpConfig to restrict worker access to tasks to a specific range of IP addresses. + * You specify allowed IP addresses by creating a list of up to ten CIDRs. + * By default, a workforce isn't restricted to specific IP addresses. If you specify a + * range of IP addresses, workers who attempt to access tasks using any IP address outside + * the specified range are denied and get a Not Found error message on + * the worker portal.

+ *

Use OidcConfig to update the configuration of a workforce created using + * your own OIDC IdP.

+ * + *

You can only update your OIDC IdP configuration when there are no work teams + * associated with your workforce. You can delete work teams using the operation.

+ *
+ *

After restricting access to a range of IP addresses or updating your OIDC IdP configuration with this operation, you + * can view details about your update workforce using the + * operation.

+ * + *

This operation only applies to private workforces.

+ *
+ */ export class UpdateWorkforceCommand extends $Command< UpdateWorkforceCommandInput, UpdateWorkforceCommandOutput, @@ -34,6 +58,9 @@ export class UpdateWorkforceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/commands/UpdateWorkteamCommand.ts b/clients/client-sagemaker/commands/UpdateWorkteamCommand.ts index 421062f6be28e..6bb04a28995da 100644 --- a/clients/client-sagemaker/commands/UpdateWorkteamCommand.ts +++ b/clients/client-sagemaker/commands/UpdateWorkteamCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateWorkteamCommandInput = UpdateWorkteamRequest; export type UpdateWorkteamCommandOutput = UpdateWorkteamResponse & __MetadataBearer; +/** + *

Updates an existing work team with new member definitions or description.

+ */ export class UpdateWorkteamCommand extends $Command< UpdateWorkteamCommandInput, UpdateWorkteamCommandOutput, @@ -34,6 +37,9 @@ export class UpdateWorkteamCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SageMakerClientResolvedConfig, diff --git a/clients/client-sagemaker/package.json b/clients/client-sagemaker/package.json index 2264ae15ed6de..66d471056066a 100644 --- a/clients/client-sagemaker/package.json +++ b/clients/client-sagemaker/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sagemaker Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sagemaker/pagination/ListAlgorithmsPaginator.ts b/clients/client-sagemaker/pagination/ListAlgorithmsPaginator.ts index 89c53579617de..2493bbdfdd9c6 100644 --- a/clients/client-sagemaker/pagination/ListAlgorithmsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListAlgorithmsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListAlgorithmsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAlgorithmsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListAlgorithmsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListAppsPaginator.ts b/clients/client-sagemaker/pagination/ListAppsPaginator.ts index ed9d5c0c6e3d5..3c02e812b2a27 100644 --- a/clients/client-sagemaker/pagination/ListAppsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListAppsPaginator.ts @@ -4,6 +4,9 @@ import { ListAppsCommand, ListAppsCommandInput, ListAppsCommandOutput } from ".. import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListAppsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAppsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListAppsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListAutoMLJobsPaginator.ts b/clients/client-sagemaker/pagination/ListAutoMLJobsPaginator.ts index 3ccd379686c76..6e854cd5fe5ff 100644 --- a/clients/client-sagemaker/pagination/ListAutoMLJobsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListAutoMLJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListAutoMLJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAutoMLJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListAutoMLJobsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListCandidatesForAutoMLJobPaginator.ts b/clients/client-sagemaker/pagination/ListCandidatesForAutoMLJobPaginator.ts index 0f2ff6e7b8ff6..d5339391c5e08 100644 --- a/clients/client-sagemaker/pagination/ListCandidatesForAutoMLJobPaginator.ts +++ b/clients/client-sagemaker/pagination/ListCandidatesForAutoMLJobPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListCandidatesForAutoMLJobCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCandidatesForAutoMLJobCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListCandidatesForAutoMLJobCommandInput, diff --git a/clients/client-sagemaker/pagination/ListCodeRepositoriesPaginator.ts b/clients/client-sagemaker/pagination/ListCodeRepositoriesPaginator.ts index c2e1aff395af5..efb76562978a4 100644 --- a/clients/client-sagemaker/pagination/ListCodeRepositoriesPaginator.ts +++ b/clients/client-sagemaker/pagination/ListCodeRepositoriesPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListCodeRepositoriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCodeRepositoriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListCodeRepositoriesCommandInput, diff --git a/clients/client-sagemaker/pagination/ListCompilationJobsPaginator.ts b/clients/client-sagemaker/pagination/ListCompilationJobsPaginator.ts index e92424875e68f..4957e94b1dd7f 100644 --- a/clients/client-sagemaker/pagination/ListCompilationJobsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListCompilationJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListCompilationJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCompilationJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListCompilationJobsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListDomainsPaginator.ts b/clients/client-sagemaker/pagination/ListDomainsPaginator.ts index 47acfb7f7a863..ff533700bcba1 100644 --- a/clients/client-sagemaker/pagination/ListDomainsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListDomainsPaginator.ts @@ -4,6 +4,9 @@ import { ListDomainsCommand, ListDomainsCommandInput, ListDomainsCommandOutput } import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListDomainsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListDomainsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListEndpointConfigsPaginator.ts b/clients/client-sagemaker/pagination/ListEndpointConfigsPaginator.ts index 9f6066aa3af63..cb59bea0e2d99 100644 --- a/clients/client-sagemaker/pagination/ListEndpointConfigsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListEndpointConfigsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListEndpointConfigsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEndpointConfigsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListEndpointConfigsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListEndpointsPaginator.ts b/clients/client-sagemaker/pagination/ListEndpointsPaginator.ts index d2802752a0b4e..8b7141b2f04cf 100644 --- a/clients/client-sagemaker/pagination/ListEndpointsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListEndpointsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListEndpointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEndpointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListEndpointsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListExperimentsPaginator.ts b/clients/client-sagemaker/pagination/ListExperimentsPaginator.ts index e308f0954fc1d..14ecfecd89c3e 100644 --- a/clients/client-sagemaker/pagination/ListExperimentsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListExperimentsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListExperimentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListExperimentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListExperimentsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListFlowDefinitionsPaginator.ts b/clients/client-sagemaker/pagination/ListFlowDefinitionsPaginator.ts index 66b02abd6a055..bb6a394ea29cc 100644 --- a/clients/client-sagemaker/pagination/ListFlowDefinitionsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListFlowDefinitionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListFlowDefinitionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFlowDefinitionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListFlowDefinitionsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListHumanTaskUisPaginator.ts b/clients/client-sagemaker/pagination/ListHumanTaskUisPaginator.ts index ec890f0e1afbf..eeefc9f23f62e 100644 --- a/clients/client-sagemaker/pagination/ListHumanTaskUisPaginator.ts +++ b/clients/client-sagemaker/pagination/ListHumanTaskUisPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListHumanTaskUisCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHumanTaskUisCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListHumanTaskUisCommandInput, diff --git a/clients/client-sagemaker/pagination/ListHyperParameterTuningJobsPaginator.ts b/clients/client-sagemaker/pagination/ListHyperParameterTuningJobsPaginator.ts index 7d5786c1b6aef..c3607a1c54cc8 100644 --- a/clients/client-sagemaker/pagination/ListHyperParameterTuningJobsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListHyperParameterTuningJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListHyperParameterTuningJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListHyperParameterTuningJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListHyperParameterTuningJobsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListImageVersionsPaginator.ts b/clients/client-sagemaker/pagination/ListImageVersionsPaginator.ts index 006505254fea6..a7306086c89bc 100644 --- a/clients/client-sagemaker/pagination/ListImageVersionsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListImageVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListImageVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImageVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListImageVersionsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListImagesPaginator.ts b/clients/client-sagemaker/pagination/ListImagesPaginator.ts index 66bd6a797607f..cda46a777c91d 100644 --- a/clients/client-sagemaker/pagination/ListImagesPaginator.ts +++ b/clients/client-sagemaker/pagination/ListImagesPaginator.ts @@ -4,6 +4,9 @@ import { ListImagesCommand, ListImagesCommandInput, ListImagesCommandOutput } fr import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListImagesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListImagesCommandInput, diff --git a/clients/client-sagemaker/pagination/ListLabelingJobsForWorkteamPaginator.ts b/clients/client-sagemaker/pagination/ListLabelingJobsForWorkteamPaginator.ts index cbbf653ca9e84..445a110d1856e 100644 --- a/clients/client-sagemaker/pagination/ListLabelingJobsForWorkteamPaginator.ts +++ b/clients/client-sagemaker/pagination/ListLabelingJobsForWorkteamPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListLabelingJobsForWorkteamCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLabelingJobsForWorkteamCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListLabelingJobsForWorkteamCommandInput, diff --git a/clients/client-sagemaker/pagination/ListLabelingJobsPaginator.ts b/clients/client-sagemaker/pagination/ListLabelingJobsPaginator.ts index ffc27652e02d6..15c014999c68b 100644 --- a/clients/client-sagemaker/pagination/ListLabelingJobsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListLabelingJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListLabelingJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLabelingJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListLabelingJobsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListModelPackagesPaginator.ts b/clients/client-sagemaker/pagination/ListModelPackagesPaginator.ts index 78190193eca76..9c64b4d62cbbc 100644 --- a/clients/client-sagemaker/pagination/ListModelPackagesPaginator.ts +++ b/clients/client-sagemaker/pagination/ListModelPackagesPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListModelPackagesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListModelPackagesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListModelPackagesCommandInput, diff --git a/clients/client-sagemaker/pagination/ListModelsPaginator.ts b/clients/client-sagemaker/pagination/ListModelsPaginator.ts index c3e47e632f98e..8380f0f20a16a 100644 --- a/clients/client-sagemaker/pagination/ListModelsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListModelsPaginator.ts @@ -4,6 +4,9 @@ import { ListModelsCommand, ListModelsCommandInput, ListModelsCommandOutput } fr import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListModelsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListModelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListModelsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListMonitoringExecutionsPaginator.ts b/clients/client-sagemaker/pagination/ListMonitoringExecutionsPaginator.ts index a96a59364849a..a5fae2c8706b3 100644 --- a/clients/client-sagemaker/pagination/ListMonitoringExecutionsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListMonitoringExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListMonitoringExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMonitoringExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListMonitoringExecutionsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListMonitoringSchedulesPaginator.ts b/clients/client-sagemaker/pagination/ListMonitoringSchedulesPaginator.ts index dc6d1db8f2ba4..4f99d69fb6002 100644 --- a/clients/client-sagemaker/pagination/ListMonitoringSchedulesPaginator.ts +++ b/clients/client-sagemaker/pagination/ListMonitoringSchedulesPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListMonitoringSchedulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMonitoringSchedulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListMonitoringSchedulesCommandInput, diff --git a/clients/client-sagemaker/pagination/ListNotebookInstanceLifecycleConfigsPaginator.ts b/clients/client-sagemaker/pagination/ListNotebookInstanceLifecycleConfigsPaginator.ts index 0a7fcff48f091..b1eb402673e9d 100644 --- a/clients/client-sagemaker/pagination/ListNotebookInstanceLifecycleConfigsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListNotebookInstanceLifecycleConfigsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListNotebookInstanceLifecycleConfigsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNotebookInstanceLifecycleConfigsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListNotebookInstanceLifecycleConfigsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListNotebookInstancesPaginator.ts b/clients/client-sagemaker/pagination/ListNotebookInstancesPaginator.ts index a6bcddf42e51a..ee513ba173ab1 100644 --- a/clients/client-sagemaker/pagination/ListNotebookInstancesPaginator.ts +++ b/clients/client-sagemaker/pagination/ListNotebookInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListNotebookInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNotebookInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListNotebookInstancesCommandInput, diff --git a/clients/client-sagemaker/pagination/ListProcessingJobsPaginator.ts b/clients/client-sagemaker/pagination/ListProcessingJobsPaginator.ts index 283f7ca547657..c817f11948c83 100644 --- a/clients/client-sagemaker/pagination/ListProcessingJobsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListProcessingJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListProcessingJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProcessingJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListProcessingJobsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListSubscribedWorkteamsPaginator.ts b/clients/client-sagemaker/pagination/ListSubscribedWorkteamsPaginator.ts index 19bb38962a9cf..d8ac833d4f921 100644 --- a/clients/client-sagemaker/pagination/ListSubscribedWorkteamsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListSubscribedWorkteamsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListSubscribedWorkteamsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSubscribedWorkteamsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListSubscribedWorkteamsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListTagsPaginator.ts b/clients/client-sagemaker/pagination/ListTagsPaginator.ts index 7c252c86e1bfa..04a235ee6595f 100644 --- a/clients/client-sagemaker/pagination/ListTagsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListTagsPaginator.ts @@ -4,6 +4,9 @@ import { ListTagsCommand, ListTagsCommandInput, ListTagsCommandOutput } from ".. import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListTagsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListTagsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListTrainingJobsForHyperParameterTuningJobPaginator.ts b/clients/client-sagemaker/pagination/ListTrainingJobsForHyperParameterTuningJobPaginator.ts index 46e4f4a6a77a1..a039fa7bdfbed 100644 --- a/clients/client-sagemaker/pagination/ListTrainingJobsForHyperParameterTuningJobPaginator.ts +++ b/clients/client-sagemaker/pagination/ListTrainingJobsForHyperParameterTuningJobPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListTrainingJobsForHyperParameterTuningJobCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTrainingJobsForHyperParameterTuningJobCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListTrainingJobsForHyperParameterTuningJobCommandInput, diff --git a/clients/client-sagemaker/pagination/ListTrainingJobsPaginator.ts b/clients/client-sagemaker/pagination/ListTrainingJobsPaginator.ts index 773f80dbbed26..a0af067f1fad5 100644 --- a/clients/client-sagemaker/pagination/ListTrainingJobsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListTrainingJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListTrainingJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTrainingJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListTrainingJobsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListTransformJobsPaginator.ts b/clients/client-sagemaker/pagination/ListTransformJobsPaginator.ts index 708dc00e3488b..161d3ed34c7d7 100644 --- a/clients/client-sagemaker/pagination/ListTransformJobsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListTransformJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListTransformJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTransformJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListTransformJobsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListTrialComponentsPaginator.ts b/clients/client-sagemaker/pagination/ListTrialComponentsPaginator.ts index 787f026bc972d..5ec3db1a07b34 100644 --- a/clients/client-sagemaker/pagination/ListTrialComponentsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListTrialComponentsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListTrialComponentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTrialComponentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListTrialComponentsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListTrialsPaginator.ts b/clients/client-sagemaker/pagination/ListTrialsPaginator.ts index b65c71f8e5c8e..2e15e20c510ad 100644 --- a/clients/client-sagemaker/pagination/ListTrialsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListTrialsPaginator.ts @@ -4,6 +4,9 @@ import { ListTrialsCommand, ListTrialsCommandInput, ListTrialsCommandOutput } fr import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListTrialsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTrialsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListTrialsCommandInput, diff --git a/clients/client-sagemaker/pagination/ListUserProfilesPaginator.ts b/clients/client-sagemaker/pagination/ListUserProfilesPaginator.ts index 20294c9c34a87..84ac2d9084134 100644 --- a/clients/client-sagemaker/pagination/ListUserProfilesPaginator.ts +++ b/clients/client-sagemaker/pagination/ListUserProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListUserProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUserProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListUserProfilesCommandInput, diff --git a/clients/client-sagemaker/pagination/ListWorkforcesPaginator.ts b/clients/client-sagemaker/pagination/ListWorkforcesPaginator.ts index 620a2e2434f2f..112cf53008261 100644 --- a/clients/client-sagemaker/pagination/ListWorkforcesPaginator.ts +++ b/clients/client-sagemaker/pagination/ListWorkforcesPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListWorkforcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorkforcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListWorkforcesCommandInput, diff --git a/clients/client-sagemaker/pagination/ListWorkteamsPaginator.ts b/clients/client-sagemaker/pagination/ListWorkteamsPaginator.ts index 59020bf6700ec..305bd525432d3 100644 --- a/clients/client-sagemaker/pagination/ListWorkteamsPaginator.ts +++ b/clients/client-sagemaker/pagination/ListWorkteamsPaginator.ts @@ -8,6 +8,9 @@ import { import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: ListWorkteamsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorkteamsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: ListWorkteamsCommandInput, diff --git a/clients/client-sagemaker/pagination/SearchPaginator.ts b/clients/client-sagemaker/pagination/SearchPaginator.ts index d6d0a922a56f2..ef8414ce9cee7 100644 --- a/clients/client-sagemaker/pagination/SearchPaginator.ts +++ b/clients/client-sagemaker/pagination/SearchPaginator.ts @@ -4,6 +4,9 @@ import { SearchCommand, SearchCommandInput, SearchCommandOutput } from "../comma import { SageMakerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SageMakerClient, input: SearchCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SageMaker, input: SearchCommandInput, diff --git a/clients/client-sagemaker/runtimeConfig.browser.ts b/clients/client-sagemaker/runtimeConfig.browser.ts index d8a6ae8c8d04e..ca258cb71532b 100644 --- a/clients/client-sagemaker/runtimeConfig.browser.ts +++ b/clients/client-sagemaker/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SageMakerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sagemaker/runtimeConfig.native.ts b/clients/client-sagemaker/runtimeConfig.native.ts index accd17355f4e4..6dfb2f325c43c 100644 --- a/clients/client-sagemaker/runtimeConfig.native.ts +++ b/clients/client-sagemaker/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SageMakerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sagemaker/runtimeConfig.shared.ts b/clients/client-sagemaker/runtimeConfig.shared.ts index debffe7fcf603..a1ddeeb738313 100644 --- a/clients/client-sagemaker/runtimeConfig.shared.ts +++ b/clients/client-sagemaker/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-24", disableHostPrefix: false, diff --git a/clients/client-sagemaker/runtimeConfig.ts b/clients/client-sagemaker/runtimeConfig.ts index da9d9b993c122..7f42cb25dea1a 100644 --- a/clients/client-sagemaker/runtimeConfig.ts +++ b/clients/client-sagemaker/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SageMakerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sagemaker/tsconfig.json b/clients/client-sagemaker/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sagemaker/tsconfig.json +++ b/clients/client-sagemaker/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-savingsplans/commands/CreateSavingsPlanCommand.ts b/clients/client-savingsplans/commands/CreateSavingsPlanCommand.ts index b43aae8639808..c7459e22be167 100644 --- a/clients/client-savingsplans/commands/CreateSavingsPlanCommand.ts +++ b/clients/client-savingsplans/commands/CreateSavingsPlanCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSavingsPlanCommandInput = CreateSavingsPlanRequest; export type CreateSavingsPlanCommandOutput = CreateSavingsPlanResponse & __MetadataBearer; +/** + *

Creates a Savings Plan.

+ */ export class CreateSavingsPlanCommand extends $Command< CreateSavingsPlanCommandInput, CreateSavingsPlanCommandOutput, @@ -34,6 +37,9 @@ export class CreateSavingsPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/commands/DeleteQueuedSavingsPlanCommand.ts b/clients/client-savingsplans/commands/DeleteQueuedSavingsPlanCommand.ts index a695e91400d14..00810bea6de96 100644 --- a/clients/client-savingsplans/commands/DeleteQueuedSavingsPlanCommand.ts +++ b/clients/client-savingsplans/commands/DeleteQueuedSavingsPlanCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteQueuedSavingsPlanCommandInput = DeleteQueuedSavingsPlanRequest; export type DeleteQueuedSavingsPlanCommandOutput = DeleteQueuedSavingsPlanResponse & __MetadataBearer; +/** + *

Deletes the queued purchase for the specified Savings Plan.

+ */ export class DeleteQueuedSavingsPlanCommand extends $Command< DeleteQueuedSavingsPlanCommandInput, DeleteQueuedSavingsPlanCommandOutput, @@ -34,6 +37,9 @@ export class DeleteQueuedSavingsPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/commands/DescribeSavingsPlanRatesCommand.ts b/clients/client-savingsplans/commands/DescribeSavingsPlanRatesCommand.ts index 04a969b1b1815..ee889cc8c72c2 100644 --- a/clients/client-savingsplans/commands/DescribeSavingsPlanRatesCommand.ts +++ b/clients/client-savingsplans/commands/DescribeSavingsPlanRatesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSavingsPlanRatesCommandInput = DescribeSavingsPlanRatesRequest; export type DescribeSavingsPlanRatesCommandOutput = DescribeSavingsPlanRatesResponse & __MetadataBearer; +/** + *

Describes the specified Savings Plans rates.

+ */ export class DescribeSavingsPlanRatesCommand extends $Command< DescribeSavingsPlanRatesCommandInput, DescribeSavingsPlanRatesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSavingsPlanRatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/commands/DescribeSavingsPlansCommand.ts b/clients/client-savingsplans/commands/DescribeSavingsPlansCommand.ts index 519c8db76d293..231e7d1ab6380 100644 --- a/clients/client-savingsplans/commands/DescribeSavingsPlansCommand.ts +++ b/clients/client-savingsplans/commands/DescribeSavingsPlansCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSavingsPlansCommandInput = DescribeSavingsPlansRequest; export type DescribeSavingsPlansCommandOutput = DescribeSavingsPlansResponse & __MetadataBearer; +/** + *

Describes the specified Savings Plans.

+ */ export class DescribeSavingsPlansCommand extends $Command< DescribeSavingsPlansCommandInput, DescribeSavingsPlansCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSavingsPlansCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/commands/DescribeSavingsPlansOfferingRatesCommand.ts b/clients/client-savingsplans/commands/DescribeSavingsPlansOfferingRatesCommand.ts index 64f5d98bf1fe7..a40911762a619 100644 --- a/clients/client-savingsplans/commands/DescribeSavingsPlansOfferingRatesCommand.ts +++ b/clients/client-savingsplans/commands/DescribeSavingsPlansOfferingRatesCommand.ts @@ -24,6 +24,9 @@ export type DescribeSavingsPlansOfferingRatesCommandInput = DescribeSavingsPlans export type DescribeSavingsPlansOfferingRatesCommandOutput = DescribeSavingsPlansOfferingRatesResponse & __MetadataBearer; +/** + *

Describes the specified Savings Plans offering rates.

+ */ export class DescribeSavingsPlansOfferingRatesCommand extends $Command< DescribeSavingsPlansOfferingRatesCommandInput, DescribeSavingsPlansOfferingRatesCommandOutput, @@ -38,6 +41,9 @@ export class DescribeSavingsPlansOfferingRatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/commands/DescribeSavingsPlansOfferingsCommand.ts b/clients/client-savingsplans/commands/DescribeSavingsPlansOfferingsCommand.ts index ee59fe3a080e0..3fac1410883f0 100644 --- a/clients/client-savingsplans/commands/DescribeSavingsPlansOfferingsCommand.ts +++ b/clients/client-savingsplans/commands/DescribeSavingsPlansOfferingsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSavingsPlansOfferingsCommandInput = DescribeSavingsPlansOfferingsRequest; export type DescribeSavingsPlansOfferingsCommandOutput = DescribeSavingsPlansOfferingsResponse & __MetadataBearer; +/** + *

Describes the specified Savings Plans offerings.

+ */ export class DescribeSavingsPlansOfferingsCommand extends $Command< DescribeSavingsPlansOfferingsCommandInput, DescribeSavingsPlansOfferingsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSavingsPlansOfferingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/commands/ListTagsForResourceCommand.ts b/clients/client-savingsplans/commands/ListTagsForResourceCommand.ts index aaf41539f3abd..68464e06b4697 100644 --- a/clients/client-savingsplans/commands/ListTagsForResourceCommand.ts +++ b/clients/client-savingsplans/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags for the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/commands/TagResourceCommand.ts b/clients/client-savingsplans/commands/TagResourceCommand.ts index f35d867414339..c5a5741726dd6 100644 --- a/clients/client-savingsplans/commands/TagResourceCommand.ts +++ b/clients/client-savingsplans/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds the specified tags to the specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/commands/UntagResourceCommand.ts b/clients/client-savingsplans/commands/UntagResourceCommand.ts index 6c73d9367e10f..2b45fcf16baa4 100644 --- a/clients/client-savingsplans/commands/UntagResourceCommand.ts +++ b/clients/client-savingsplans/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes the specified tags from the specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SavingsplansClientResolvedConfig, diff --git a/clients/client-savingsplans/package.json b/clients/client-savingsplans/package.json index d8032278b4ada..53ef55dd14396 100644 --- a/clients/client-savingsplans/package.json +++ b/clients/client-savingsplans/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Savingsplans Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-savingsplans/runtimeConfig.browser.ts b/clients/client-savingsplans/runtimeConfig.browser.ts index 065e5839c5407..8c1562f09c12e 100644 --- a/clients/client-savingsplans/runtimeConfig.browser.ts +++ b/clients/client-savingsplans/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SavingsplansClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-savingsplans/runtimeConfig.native.ts b/clients/client-savingsplans/runtimeConfig.native.ts index 89889c3c4493c..43fd9d4d9fc51 100644 --- a/clients/client-savingsplans/runtimeConfig.native.ts +++ b/clients/client-savingsplans/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SavingsplansClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-savingsplans/runtimeConfig.shared.ts b/clients/client-savingsplans/runtimeConfig.shared.ts index 0f56a5c931a9a..159cfde35d7e6 100644 --- a/clients/client-savingsplans/runtimeConfig.shared.ts +++ b/clients/client-savingsplans/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-06-28", disableHostPrefix: false, diff --git a/clients/client-savingsplans/runtimeConfig.ts b/clients/client-savingsplans/runtimeConfig.ts index 93016a34935a9..06130fe386e90 100644 --- a/clients/client-savingsplans/runtimeConfig.ts +++ b/clients/client-savingsplans/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SavingsplansClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-savingsplans/tsconfig.json b/clients/client-savingsplans/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-savingsplans/tsconfig.json +++ b/clients/client-savingsplans/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-schemas/commands/CreateDiscovererCommand.ts b/clients/client-schemas/commands/CreateDiscovererCommand.ts index 7fd00cdbff877..3ce07c1abd92b 100644 --- a/clients/client-schemas/commands/CreateDiscovererCommand.ts +++ b/clients/client-schemas/commands/CreateDiscovererCommand.ts @@ -20,6 +20,9 @@ import { export type CreateDiscovererCommandInput = CreateDiscovererRequest; export type CreateDiscovererCommandOutput = CreateDiscovererResponse & __MetadataBearer; +/** + *

Creates a discoverer.

+ */ export class CreateDiscovererCommand extends $Command< CreateDiscovererCommandInput, CreateDiscovererCommandOutput, @@ -34,6 +37,9 @@ export class CreateDiscovererCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/CreateRegistryCommand.ts b/clients/client-schemas/commands/CreateRegistryCommand.ts index 112efbb11f24d..942ed758b8451 100644 --- a/clients/client-schemas/commands/CreateRegistryCommand.ts +++ b/clients/client-schemas/commands/CreateRegistryCommand.ts @@ -20,6 +20,9 @@ import { export type CreateRegistryCommandInput = CreateRegistryRequest; export type CreateRegistryCommandOutput = CreateRegistryResponse & __MetadataBearer; +/** + *

Creates a registry.

+ */ export class CreateRegistryCommand extends $Command< CreateRegistryCommandInput, CreateRegistryCommandOutput, @@ -34,6 +37,9 @@ export class CreateRegistryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/CreateSchemaCommand.ts b/clients/client-schemas/commands/CreateSchemaCommand.ts index 4ec0815bfcb79..4637c75f0ce43 100644 --- a/clients/client-schemas/commands/CreateSchemaCommand.ts +++ b/clients/client-schemas/commands/CreateSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type CreateSchemaCommandInput = CreateSchemaRequest; export type CreateSchemaCommandOutput = CreateSchemaResponse & __MetadataBearer; +/** + *

Creates a schema definition.

Inactive schemas will be deleted after two years.

+ */ export class CreateSchemaCommand extends $Command< CreateSchemaCommandInput, CreateSchemaCommandOutput, @@ -34,6 +37,9 @@ export class CreateSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DeleteDiscovererCommand.ts b/clients/client-schemas/commands/DeleteDiscovererCommand.ts index e87819cdaf165..960582e784f51 100644 --- a/clients/client-schemas/commands/DeleteDiscovererCommand.ts +++ b/clients/client-schemas/commands/DeleteDiscovererCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDiscovererCommandInput = DeleteDiscovererRequest; export type DeleteDiscovererCommandOutput = __MetadataBearer; +/** + *

Deletes a discoverer.

+ */ export class DeleteDiscovererCommand extends $Command< DeleteDiscovererCommandInput, DeleteDiscovererCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDiscovererCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DeleteRegistryCommand.ts b/clients/client-schemas/commands/DeleteRegistryCommand.ts index b34f70a5d9297..88c7e732eba76 100644 --- a/clients/client-schemas/commands/DeleteRegistryCommand.ts +++ b/clients/client-schemas/commands/DeleteRegistryCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRegistryCommandInput = DeleteRegistryRequest; export type DeleteRegistryCommandOutput = __MetadataBearer; +/** + *

Deletes a Registry.

+ */ export class DeleteRegistryCommand extends $Command< DeleteRegistryCommandInput, DeleteRegistryCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRegistryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DeleteResourcePolicyCommand.ts b/clients/client-schemas/commands/DeleteResourcePolicyCommand.ts index bed14fda698c8..4cab599c26f88 100644 --- a/clients/client-schemas/commands/DeleteResourcePolicyCommand.ts +++ b/clients/client-schemas/commands/DeleteResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourcePolicyCommandInput = DeleteResourcePolicyRequest; export type DeleteResourcePolicyCommandOutput = __MetadataBearer; +/** + *

Delete the resource-based policy attached to the specified registry.

+ */ export class DeleteResourcePolicyCommand extends $Command< DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DeleteSchemaCommand.ts b/clients/client-schemas/commands/DeleteSchemaCommand.ts index 76b55f92084d0..f3b09cf652406 100644 --- a/clients/client-schemas/commands/DeleteSchemaCommand.ts +++ b/clients/client-schemas/commands/DeleteSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSchemaCommandInput = DeleteSchemaRequest; export type DeleteSchemaCommandOutput = __MetadataBearer; +/** + *

Delete a schema definition.

+ */ export class DeleteSchemaCommand extends $Command< DeleteSchemaCommandInput, DeleteSchemaCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DeleteSchemaVersionCommand.ts b/clients/client-schemas/commands/DeleteSchemaVersionCommand.ts index 59db2152e4314..994175e39044e 100644 --- a/clients/client-schemas/commands/DeleteSchemaVersionCommand.ts +++ b/clients/client-schemas/commands/DeleteSchemaVersionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSchemaVersionCommandInput = DeleteSchemaVersionRequest; export type DeleteSchemaVersionCommandOutput = __MetadataBearer; +/** + *

Delete the schema version definition

+ */ export class DeleteSchemaVersionCommand extends $Command< DeleteSchemaVersionCommandInput, DeleteSchemaVersionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSchemaVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DescribeCodeBindingCommand.ts b/clients/client-schemas/commands/DescribeCodeBindingCommand.ts index fc4695e534011..c3f780e2f139a 100644 --- a/clients/client-schemas/commands/DescribeCodeBindingCommand.ts +++ b/clients/client-schemas/commands/DescribeCodeBindingCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCodeBindingCommandInput = DescribeCodeBindingRequest; export type DescribeCodeBindingCommandOutput = DescribeCodeBindingResponse & __MetadataBearer; +/** + *

Describe the code binding URI.

+ */ export class DescribeCodeBindingCommand extends $Command< DescribeCodeBindingCommandInput, DescribeCodeBindingCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCodeBindingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DescribeDiscovererCommand.ts b/clients/client-schemas/commands/DescribeDiscovererCommand.ts index e92d032be71dd..2175dec023d70 100644 --- a/clients/client-schemas/commands/DescribeDiscovererCommand.ts +++ b/clients/client-schemas/commands/DescribeDiscovererCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDiscovererCommandInput = DescribeDiscovererRequest; export type DescribeDiscovererCommandOutput = DescribeDiscovererResponse & __MetadataBearer; +/** + *

Describes the discoverer.

+ */ export class DescribeDiscovererCommand extends $Command< DescribeDiscovererCommandInput, DescribeDiscovererCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDiscovererCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DescribeRegistryCommand.ts b/clients/client-schemas/commands/DescribeRegistryCommand.ts index 305e983e5c681..61541713e397b 100644 --- a/clients/client-schemas/commands/DescribeRegistryCommand.ts +++ b/clients/client-schemas/commands/DescribeRegistryCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeRegistryCommandInput = DescribeRegistryRequest; export type DescribeRegistryCommandOutput = DescribeRegistryResponse & __MetadataBearer; +/** + *

Describes the registry.

+ */ export class DescribeRegistryCommand extends $Command< DescribeRegistryCommandInput, DescribeRegistryCommandOutput, @@ -34,6 +37,9 @@ export class DescribeRegistryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/DescribeSchemaCommand.ts b/clients/client-schemas/commands/DescribeSchemaCommand.ts index 18c7359ec8aea..18c96183a42fd 100644 --- a/clients/client-schemas/commands/DescribeSchemaCommand.ts +++ b/clients/client-schemas/commands/DescribeSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSchemaCommandInput = DescribeSchemaRequest; export type DescribeSchemaCommandOutput = DescribeSchemaResponse & __MetadataBearer; +/** + *

Retrieve the schema definition.

+ */ export class DescribeSchemaCommand extends $Command< DescribeSchemaCommandInput, DescribeSchemaCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/ExportSchemaCommand.ts b/clients/client-schemas/commands/ExportSchemaCommand.ts index 7dfac7d6bcf53..3858e61ce8113 100644 --- a/clients/client-schemas/commands/ExportSchemaCommand.ts +++ b/clients/client-schemas/commands/ExportSchemaCommand.ts @@ -34,6 +34,9 @@ export class ExportSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/GetCodeBindingSourceCommand.ts b/clients/client-schemas/commands/GetCodeBindingSourceCommand.ts index 96c4feb16ffcf..68acc23a33ab5 100644 --- a/clients/client-schemas/commands/GetCodeBindingSourceCommand.ts +++ b/clients/client-schemas/commands/GetCodeBindingSourceCommand.ts @@ -20,6 +20,9 @@ import { export type GetCodeBindingSourceCommandInput = GetCodeBindingSourceRequest; export type GetCodeBindingSourceCommandOutput = GetCodeBindingSourceResponse & __MetadataBearer; +/** + *

Get the code binding source URI.

+ */ export class GetCodeBindingSourceCommand extends $Command< GetCodeBindingSourceCommandInput, GetCodeBindingSourceCommandOutput, @@ -34,6 +37,9 @@ export class GetCodeBindingSourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/GetDiscoveredSchemaCommand.ts b/clients/client-schemas/commands/GetDiscoveredSchemaCommand.ts index 9ed05697f1ac3..8a3930f3e8934 100644 --- a/clients/client-schemas/commands/GetDiscoveredSchemaCommand.ts +++ b/clients/client-schemas/commands/GetDiscoveredSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type GetDiscoveredSchemaCommandInput = GetDiscoveredSchemaRequest; export type GetDiscoveredSchemaCommandOutput = GetDiscoveredSchemaResponse & __MetadataBearer; +/** + *

Get the discovered schema that was generated based on sampled events.

+ */ export class GetDiscoveredSchemaCommand extends $Command< GetDiscoveredSchemaCommandInput, GetDiscoveredSchemaCommandOutput, @@ -34,6 +37,9 @@ export class GetDiscoveredSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/GetResourcePolicyCommand.ts b/clients/client-schemas/commands/GetResourcePolicyCommand.ts index e78371e7d5168..dbe6b772bd05e 100644 --- a/clients/client-schemas/commands/GetResourcePolicyCommand.ts +++ b/clients/client-schemas/commands/GetResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetResourcePolicyCommandInput = GetResourcePolicyRequest; export type GetResourcePolicyCommandOutput = GetResourcePolicyResponse & __MetadataBearer; +/** + *

Retrieves the resource-based policy attached to a given registry.

+ */ export class GetResourcePolicyCommand extends $Command< GetResourcePolicyCommandInput, GetResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/ListDiscoverersCommand.ts b/clients/client-schemas/commands/ListDiscoverersCommand.ts index 9519519f96655..ed97566030ba7 100644 --- a/clients/client-schemas/commands/ListDiscoverersCommand.ts +++ b/clients/client-schemas/commands/ListDiscoverersCommand.ts @@ -20,6 +20,9 @@ import { export type ListDiscoverersCommandInput = ListDiscoverersRequest; export type ListDiscoverersCommandOutput = ListDiscoverersResponse & __MetadataBearer; +/** + *

List the discoverers.

+ */ export class ListDiscoverersCommand extends $Command< ListDiscoverersCommandInput, ListDiscoverersCommandOutput, @@ -34,6 +37,9 @@ export class ListDiscoverersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/ListRegistriesCommand.ts b/clients/client-schemas/commands/ListRegistriesCommand.ts index 2883650ca1da8..051cd585d5394 100644 --- a/clients/client-schemas/commands/ListRegistriesCommand.ts +++ b/clients/client-schemas/commands/ListRegistriesCommand.ts @@ -20,6 +20,9 @@ import { export type ListRegistriesCommandInput = ListRegistriesRequest; export type ListRegistriesCommandOutput = ListRegistriesResponse & __MetadataBearer; +/** + *

List the registries.

+ */ export class ListRegistriesCommand extends $Command< ListRegistriesCommandInput, ListRegistriesCommandOutput, @@ -34,6 +37,9 @@ export class ListRegistriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/ListSchemaVersionsCommand.ts b/clients/client-schemas/commands/ListSchemaVersionsCommand.ts index 76d7066a67879..6bcbcc74845d1 100644 --- a/clients/client-schemas/commands/ListSchemaVersionsCommand.ts +++ b/clients/client-schemas/commands/ListSchemaVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListSchemaVersionsCommandInput = ListSchemaVersionsRequest; export type ListSchemaVersionsCommandOutput = ListSchemaVersionsResponse & __MetadataBearer; +/** + *

Provides a list of the schema versions and related information.

+ */ export class ListSchemaVersionsCommand extends $Command< ListSchemaVersionsCommandInput, ListSchemaVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListSchemaVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/ListSchemasCommand.ts b/clients/client-schemas/commands/ListSchemasCommand.ts index 947eff690461c..c8a4bda941e91 100644 --- a/clients/client-schemas/commands/ListSchemasCommand.ts +++ b/clients/client-schemas/commands/ListSchemasCommand.ts @@ -20,6 +20,9 @@ import { export type ListSchemasCommandInput = ListSchemasRequest; export type ListSchemasCommandOutput = ListSchemasResponse & __MetadataBearer; +/** + *

List the schemas.

+ */ export class ListSchemasCommand extends $Command< ListSchemasCommandInput, ListSchemasCommandOutput, @@ -34,6 +37,9 @@ export class ListSchemasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/ListTagsForResourceCommand.ts b/clients/client-schemas/commands/ListTagsForResourceCommand.ts index eae647bfeaa2f..8d707b29c2eea 100644 --- a/clients/client-schemas/commands/ListTagsForResourceCommand.ts +++ b/clients/client-schemas/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Get tags for resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/PutCodeBindingCommand.ts b/clients/client-schemas/commands/PutCodeBindingCommand.ts index 9466bac0c546f..5cf1b9d7d4385 100644 --- a/clients/client-schemas/commands/PutCodeBindingCommand.ts +++ b/clients/client-schemas/commands/PutCodeBindingCommand.ts @@ -20,6 +20,9 @@ import { export type PutCodeBindingCommandInput = PutCodeBindingRequest; export type PutCodeBindingCommandOutput = PutCodeBindingResponse & __MetadataBearer; +/** + *

Put code binding URI

+ */ export class PutCodeBindingCommand extends $Command< PutCodeBindingCommandInput, PutCodeBindingCommandOutput, @@ -34,6 +37,9 @@ export class PutCodeBindingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/PutResourcePolicyCommand.ts b/clients/client-schemas/commands/PutResourcePolicyCommand.ts index abe2833d1468c..8b76ff6958b4b 100644 --- a/clients/client-schemas/commands/PutResourcePolicyCommand.ts +++ b/clients/client-schemas/commands/PutResourcePolicyCommand.ts @@ -20,6 +20,9 @@ import { export type PutResourcePolicyCommandInput = PutResourcePolicyRequest; export type PutResourcePolicyCommandOutput = PutResourcePolicyResponse & __MetadataBearer; +/** + *

The name of the policy.

+ */ export class PutResourcePolicyCommand extends $Command< PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput, @@ -34,6 +37,9 @@ export class PutResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/SearchSchemasCommand.ts b/clients/client-schemas/commands/SearchSchemasCommand.ts index 7529d77960ac8..ef7feed1c780a 100644 --- a/clients/client-schemas/commands/SearchSchemasCommand.ts +++ b/clients/client-schemas/commands/SearchSchemasCommand.ts @@ -20,6 +20,9 @@ import { export type SearchSchemasCommandInput = SearchSchemasRequest; export type SearchSchemasCommandOutput = SearchSchemasResponse & __MetadataBearer; +/** + *

Search the schemas

+ */ export class SearchSchemasCommand extends $Command< SearchSchemasCommandInput, SearchSchemasCommandOutput, @@ -34,6 +37,9 @@ export class SearchSchemasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/StartDiscovererCommand.ts b/clients/client-schemas/commands/StartDiscovererCommand.ts index ae219089b291b..28c833e2639d3 100644 --- a/clients/client-schemas/commands/StartDiscovererCommand.ts +++ b/clients/client-schemas/commands/StartDiscovererCommand.ts @@ -20,6 +20,9 @@ import { export type StartDiscovererCommandInput = StartDiscovererRequest; export type StartDiscovererCommandOutput = StartDiscovererResponse & __MetadataBearer; +/** + *

Starts the discoverer

+ */ export class StartDiscovererCommand extends $Command< StartDiscovererCommandInput, StartDiscovererCommandOutput, @@ -34,6 +37,9 @@ export class StartDiscovererCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/StopDiscovererCommand.ts b/clients/client-schemas/commands/StopDiscovererCommand.ts index a303f4c19748a..8adb456911c79 100644 --- a/clients/client-schemas/commands/StopDiscovererCommand.ts +++ b/clients/client-schemas/commands/StopDiscovererCommand.ts @@ -20,6 +20,9 @@ import { export type StopDiscovererCommandInput = StopDiscovererRequest; export type StopDiscovererCommandOutput = StopDiscovererResponse & __MetadataBearer; +/** + *

Stops the discoverer

+ */ export class StopDiscovererCommand extends $Command< StopDiscovererCommandInput, StopDiscovererCommandOutput, @@ -34,6 +37,9 @@ export class StopDiscovererCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/TagResourceCommand.ts b/clients/client-schemas/commands/TagResourceCommand.ts index 9b2496c7a11a2..b1de06a4dcb62 100644 --- a/clients/client-schemas/commands/TagResourceCommand.ts +++ b/clients/client-schemas/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Add tags to a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/UntagResourceCommand.ts b/clients/client-schemas/commands/UntagResourceCommand.ts index 7ced57aec22aa..6ecce289e669d 100644 --- a/clients/client-schemas/commands/UntagResourceCommand.ts +++ b/clients/client-schemas/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/UpdateDiscovererCommand.ts b/clients/client-schemas/commands/UpdateDiscovererCommand.ts index 806a15b421427..4529b032ffbe8 100644 --- a/clients/client-schemas/commands/UpdateDiscovererCommand.ts +++ b/clients/client-schemas/commands/UpdateDiscovererCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDiscovererCommandInput = UpdateDiscovererRequest; export type UpdateDiscovererCommandOutput = UpdateDiscovererResponse & __MetadataBearer; +/** + *

Updates the discoverer

+ */ export class UpdateDiscovererCommand extends $Command< UpdateDiscovererCommandInput, UpdateDiscovererCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDiscovererCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/UpdateRegistryCommand.ts b/clients/client-schemas/commands/UpdateRegistryCommand.ts index 0b86c47ffb176..61626dc687a2a 100644 --- a/clients/client-schemas/commands/UpdateRegistryCommand.ts +++ b/clients/client-schemas/commands/UpdateRegistryCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateRegistryCommandInput = UpdateRegistryRequest; export type UpdateRegistryCommandOutput = UpdateRegistryResponse & __MetadataBearer; +/** + *

Updates a registry.

+ */ export class UpdateRegistryCommand extends $Command< UpdateRegistryCommandInput, UpdateRegistryCommandOutput, @@ -34,6 +37,9 @@ export class UpdateRegistryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/commands/UpdateSchemaCommand.ts b/clients/client-schemas/commands/UpdateSchemaCommand.ts index b9bafef41f55a..754689854b0d4 100644 --- a/clients/client-schemas/commands/UpdateSchemaCommand.ts +++ b/clients/client-schemas/commands/UpdateSchemaCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSchemaCommandInput = UpdateSchemaRequest; export type UpdateSchemaCommandOutput = UpdateSchemaResponse & __MetadataBearer; +/** + *

Updates the schema definition

Inactive schemas will be deleted after two years.

+ */ export class UpdateSchemaCommand extends $Command< UpdateSchemaCommandInput, UpdateSchemaCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SchemasClientResolvedConfig, diff --git a/clients/client-schemas/package.json b/clients/client-schemas/package.json index 3e02b77a49f32..97f3e17d248b3 100644 --- a/clients/client-schemas/package.json +++ b/clients/client-schemas/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Schemas Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-schemas/pagination/ListDiscoverersPaginator.ts b/clients/client-schemas/pagination/ListDiscoverersPaginator.ts index 443de53075aa7..d64d3a0560211 100644 --- a/clients/client-schemas/pagination/ListDiscoverersPaginator.ts +++ b/clients/client-schemas/pagination/ListDiscoverersPaginator.ts @@ -8,6 +8,9 @@ import { import { SchemasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SchemasClient, input: ListDiscoverersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDiscoverersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Schemas, input: ListDiscoverersCommandInput, diff --git a/clients/client-schemas/pagination/ListRegistriesPaginator.ts b/clients/client-schemas/pagination/ListRegistriesPaginator.ts index 828e1eeb77b94..b235b88834bc5 100644 --- a/clients/client-schemas/pagination/ListRegistriesPaginator.ts +++ b/clients/client-schemas/pagination/ListRegistriesPaginator.ts @@ -8,6 +8,9 @@ import { import { SchemasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SchemasClient, input: ListRegistriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRegistriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Schemas, input: ListRegistriesCommandInput, diff --git a/clients/client-schemas/pagination/ListSchemaVersionsPaginator.ts b/clients/client-schemas/pagination/ListSchemaVersionsPaginator.ts index 320ff59dd7151..daf079b85a54f 100644 --- a/clients/client-schemas/pagination/ListSchemaVersionsPaginator.ts +++ b/clients/client-schemas/pagination/ListSchemaVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SchemasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SchemasClient, input: ListSchemaVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSchemaVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Schemas, input: ListSchemaVersionsCommandInput, diff --git a/clients/client-schemas/pagination/ListSchemasPaginator.ts b/clients/client-schemas/pagination/ListSchemasPaginator.ts index dc5335cbf40fe..361c5e2fe59ec 100644 --- a/clients/client-schemas/pagination/ListSchemasPaginator.ts +++ b/clients/client-schemas/pagination/ListSchemasPaginator.ts @@ -4,6 +4,9 @@ import { ListSchemasCommand, ListSchemasCommandInput, ListSchemasCommandOutput } import { SchemasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SchemasClient, input: ListSchemasCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSchemasCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Schemas, input: ListSchemasCommandInput, diff --git a/clients/client-schemas/pagination/SearchSchemasPaginator.ts b/clients/client-schemas/pagination/SearchSchemasPaginator.ts index ddfd1b91cc7c5..5465f2a9f53d5 100644 --- a/clients/client-schemas/pagination/SearchSchemasPaginator.ts +++ b/clients/client-schemas/pagination/SearchSchemasPaginator.ts @@ -8,6 +8,9 @@ import { import { SchemasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SchemasClient, input: SearchSchemasCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchSchemasCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Schemas, input: SearchSchemasCommandInput, diff --git a/clients/client-schemas/runtimeConfig.browser.ts b/clients/client-schemas/runtimeConfig.browser.ts index e6a9f17209557..fb305ffb4bab6 100644 --- a/clients/client-schemas/runtimeConfig.browser.ts +++ b/clients/client-schemas/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SchemasClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-schemas/runtimeConfig.native.ts b/clients/client-schemas/runtimeConfig.native.ts index 805721103396b..6ec04bfab8deb 100644 --- a/clients/client-schemas/runtimeConfig.native.ts +++ b/clients/client-schemas/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SchemasClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-schemas/runtimeConfig.shared.ts b/clients/client-schemas/runtimeConfig.shared.ts index 61ab75c4fe151..c7c9f23e941b4 100644 --- a/clients/client-schemas/runtimeConfig.shared.ts +++ b/clients/client-schemas/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-02", disableHostPrefix: false, diff --git a/clients/client-schemas/runtimeConfig.ts b/clients/client-schemas/runtimeConfig.ts index 54ddfe59586f9..f553aec4d19bd 100644 --- a/clients/client-schemas/runtimeConfig.ts +++ b/clients/client-schemas/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SchemasClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-schemas/tsconfig.json b/clients/client-schemas/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-schemas/tsconfig.json +++ b/clients/client-schemas/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-secrets-manager/commands/CancelRotateSecretCommand.ts b/clients/client-secrets-manager/commands/CancelRotateSecretCommand.ts index 2f7a35f202584..8e9c5b490d1f8 100644 --- a/clients/client-secrets-manager/commands/CancelRotateSecretCommand.ts +++ b/clients/client-secrets-manager/commands/CancelRotateSecretCommand.ts @@ -20,6 +20,61 @@ import { export type CancelRotateSecretCommandInput = CancelRotateSecretRequest; export type CancelRotateSecretCommandOutput = CancelRotateSecretResponse & __MetadataBearer; +/** + *

Disables automatic scheduled rotation and cancels the rotation of a secret if currently in + * progress.

+ *

To re-enable scheduled rotation, call RotateSecret with + * AutomaticallyRotateAfterDays set to a value greater than 0. This immediately + * rotates your secret and then enables the automatic schedule.

+ * + *

If you cancel a rotation while in progress, it can leave the VersionStage + * labels in an unexpected state. Depending on the step of the rotation in progress, you might + * need to remove the staging label AWSPENDING from the partially created version, specified + * by the VersionId response value. You should also evaluate the partially rotated + * new version to see if it should be deleted, which you can do by removing all staging labels + * from the new version VersionStage field.

+ *
+ *

To successfully start a rotation, the staging label AWSPENDING must be in one of the + * following states:

+ *
    + *
  • + *

    Not attached to any version at all

    + *
  • + *
  • + *

    Attached to the same version as the staging label AWSCURRENT + *

    + *
  • + *
+ *

If the staging label AWSPENDING attached to a different version than the version with + * AWSCURRENT then the attempt to rotate fails.

+ * + *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:CancelRotateSecret

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To configure rotation for a secret or to manually trigger a rotation, use RotateSecret.

    + *
  • + *
  • + *

    To get the rotation configuration details for a secret, use DescribeSecret.

    + *
  • + *
  • + *

    To list all of the currently available secrets, use ListSecrets.

    + *
  • + *
  • + *

    To list all of the versions currently associated with a secret, use ListSecretVersionIds.

    + *
  • + *
+ */ export class CancelRotateSecretCommand extends $Command< CancelRotateSecretCommandInput, CancelRotateSecretCommandOutput, @@ -34,6 +89,9 @@ export class CancelRotateSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/CreateSecretCommand.ts b/clients/client-secrets-manager/commands/CreateSecretCommand.ts index 5265574bcf723..bc401f489c139 100644 --- a/clients/client-secrets-manager/commands/CreateSecretCommand.ts +++ b/clients/client-secrets-manager/commands/CreateSecretCommand.ts @@ -20,6 +20,96 @@ import { export type CreateSecretCommandInput = CreateSecretRequest; export type CreateSecretCommandOutput = CreateSecretResponse & __MetadataBearer; +/** + *

Creates a new secret. A secret in Secrets Manager consists of both the protected secret data and the + * important information needed to manage the secret.

+ *

Secrets Manager stores the encrypted secret data in one of a collection of "versions" + * associated with the secret. Each version contains a copy of the encrypted secret data. Each + * version is associated with one or more "staging labels" that identify where the version is in + * the rotation cycle. The SecretVersionsToStages field of the secret contains the + * mapping of staging labels to the active versions of the secret. Versions without a staging + * label are considered deprecated and not included in the list.

+ *

You provide the secret data to be encrypted by putting text in either the + * SecretString parameter or binary data in the SecretBinary + * parameter, but not both. If you include SecretString or SecretBinary + * then Secrets Manager also creates an initial secret version and automatically attaches the staging + * label AWSCURRENT to the new version.

+ * + *
    + *
  • + *

    If you call an operation to encrypt or decrypt the SecretString + * or SecretBinary for a secret in the same account as the calling user and that + * secret doesn't specify a AWS KMS encryption key, Secrets Manager uses the account's default + * AWS managed customer master key (CMK) with the alias aws/secretsmanager. If this key + * doesn't already exist in your account then Secrets Manager creates it for you automatically. All + * users and roles in the same AWS account automatically have access to use the default CMK. + * Note that if an Secrets Manager API call results in AWS creating the account's + * AWS-managed CMK, it can result in a one-time significant delay in returning the + * result.

    + *
  • + *
  • + *

    If the secret resides in a different AWS account from the credentials calling an API that + * requires encryption or decryption of the secret value then you must create and use a custom + * AWS KMS CMK because you can't access the default CMK for the account using credentials + * from a different AWS account. Store the ARN of the CMK in the secret when you create the + * secret or when you update it by including it in the KMSKeyId. If you call an + * API that must encrypt or decrypt SecretString or SecretBinary + * using credentials from a different account then the AWS KMS key policy must grant cross-account + * access to that other account's user or role for both the kms:GenerateDataKey and + * kms:Decrypt operations.

    + *
  • + *
+ *
+ *

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:CreateSecret

    + *
  • + *
  • + *

    kms:GenerateDataKey - needed only if you use a customer-managed AWS KMS key to encrypt + * the secret. You do not need this permission to use the account default AWS managed CMK + * for Secrets Manager.

    + *
  • + *
  • + *

    kms:Decrypt - needed only if you use a customer-managed AWS KMS key to encrypt the + * secret. You do not need this permission to use the account default AWS managed CMK for + * Secrets Manager.

    + *
  • + *
  • + *

    secretsmanager:TagResource - needed only if you include the Tags + * parameter.

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To delete a secret, use DeleteSecret.

    + *
  • + *
  • + *

    To modify an existing secret, use UpdateSecret.

    + *
  • + *
  • + *

    To create a new version of a secret, use PutSecretValue.

    + *
  • + *
  • + *

    To retrieve the encrypted secure string and secure binary values, use GetSecretValue.

    + *
  • + *
  • + *

    To retrieve all other details for a secret, use DescribeSecret. This + * does not include the encrypted secure string and secure binary values.

    + *
  • + *
  • + *

    To retrieve the list of secret versions associated with the current secret, use DescribeSecret and examine the SecretVersionsToStages response + * value.

    + *
  • + *
+ */ export class CreateSecretCommand extends $Command< CreateSecretCommandInput, CreateSecretCommandOutput, @@ -34,6 +124,9 @@ export class CreateSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/DeleteResourcePolicyCommand.ts b/clients/client-secrets-manager/commands/DeleteResourcePolicyCommand.ts index 90a55256a0e24..1c8cc9f895638 100644 --- a/clients/client-secrets-manager/commands/DeleteResourcePolicyCommand.ts +++ b/clients/client-secrets-manager/commands/DeleteResourcePolicyCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteResourcePolicyCommandInput = DeleteResourcePolicyRequest; export type DeleteResourcePolicyCommandOutput = DeleteResourcePolicyResponse & __MetadataBearer; +/** + *

Deletes the resource-based permission policy attached to the secret.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:DeleteResourcePolicy

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To attach a resource policy to a secret, use PutResourcePolicy.

    + *
  • + *
  • + *

    To retrieve the current resource-based policy that's attached to a secret, use GetResourcePolicy.

    + *
  • + *
  • + *

    To list all of the currently available secrets, use ListSecrets.

    + *
  • + *
+ */ export class DeleteResourcePolicyCommand extends $Command< DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput, @@ -34,6 +60,9 @@ export class DeleteResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/DeleteSecretCommand.ts b/clients/client-secrets-manager/commands/DeleteSecretCommand.ts index 5e15d955d23f2..df1467f7d8906 100644 --- a/clients/client-secrets-manager/commands/DeleteSecretCommand.ts +++ b/clients/client-secrets-manager/commands/DeleteSecretCommand.ts @@ -20,6 +20,54 @@ import { export type DeleteSecretCommandInput = DeleteSecretRequest; export type DeleteSecretCommandOutput = DeleteSecretResponse & __MetadataBearer; +/** + *

Deletes an entire secret and all of its versions. You can optionally include a recovery + * window during which you can restore the secret. If you don't specify a recovery window value, + * the operation defaults to 30 days. Secrets Manager attaches a DeletionDate stamp to + * the secret that specifies the end of the recovery window. At the end of the recovery window, + * Secrets Manager deletes the secret permanently.

+ *

At any time before recovery window ends, you can use RestoreSecret to + * remove the DeletionDate and cancel the deletion of the secret.

+ *

You cannot access the encrypted secret information in any secret that is scheduled for + * deletion. If you need to access that information, you must cancel the deletion with RestoreSecret and then retrieve the information.

+ * + *
    + *
  • + *

    There is no explicit operation to delete a version of a secret. Instead, remove all + * staging labels from the VersionStage field of a version. That marks the + * version as deprecated and allows Secrets Manager to delete it as needed. Versions that do not have + * any staging labels do not show up in ListSecretVersionIds unless you + * specify IncludeDeprecated.

    + *
  • + *
  • + *

    The permanent secret deletion at the end of the waiting period is performed as a + * background task with low priority. There is no guarantee of a specific time after the + * recovery window for the actual delete operation to occur.

    + *
  • + *
+ *
+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:DeleteSecret

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To create a secret, use CreateSecret.

    + *
  • + *
  • + *

    To cancel deletion of a version of a secret before the recovery window has expired, + * use RestoreSecret.

    + *
  • + *
+ */ export class DeleteSecretCommand extends $Command< DeleteSecretCommandInput, DeleteSecretCommandOutput, @@ -34,6 +82,9 @@ export class DeleteSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/DescribeSecretCommand.ts b/clients/client-secrets-manager/commands/DescribeSecretCommand.ts index 6087d2574ad41..b98ddb04b2708 100644 --- a/clients/client-secrets-manager/commands/DescribeSecretCommand.ts +++ b/clients/client-secrets-manager/commands/DescribeSecretCommand.ts @@ -20,6 +20,36 @@ import { export type DescribeSecretCommandInput = DescribeSecretRequest; export type DescribeSecretCommandOutput = DescribeSecretResponse & __MetadataBearer; +/** + *

Retrieves the details of a secret. It does not include the encrypted fields. Secrets + * Manager only returns fields populated with a value in the response.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:DescribeSecret

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To create a secret, use CreateSecret.

    + *
  • + *
  • + *

    To modify a secret, use UpdateSecret.

    + *
  • + *
  • + *

    To retrieve the encrypted secret information in a version of the secret, use GetSecretValue.

    + *
  • + *
  • + *

    To list all of the secrets in the AWS account, use ListSecrets.

    + *
  • + *
+ */ export class DescribeSecretCommand extends $Command< DescribeSecretCommandInput, DescribeSecretCommandOutput, @@ -34,6 +64,9 @@ export class DescribeSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/GetRandomPasswordCommand.ts b/clients/client-secrets-manager/commands/GetRandomPasswordCommand.ts index 68a156a53e62d..e16b40ef82fb5 100644 --- a/clients/client-secrets-manager/commands/GetRandomPasswordCommand.ts +++ b/clients/client-secrets-manager/commands/GetRandomPasswordCommand.ts @@ -20,6 +20,21 @@ import { export type GetRandomPasswordCommandInput = GetRandomPasswordRequest; export type GetRandomPasswordCommandOutput = GetRandomPasswordResponse & __MetadataBearer; +/** + *

Generates a random password of the specified complexity. This operation is intended for + * use in the Lambda rotation function. Per best practice, we recommend that you specify the + * maximum length and include every character type that the system you are generating a password + * for can support.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:GetRandomPassword

    + *
  • + *
+ */ export class GetRandomPasswordCommand extends $Command< GetRandomPasswordCommandInput, GetRandomPasswordCommandOutput, @@ -34,6 +49,9 @@ export class GetRandomPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/GetResourcePolicyCommand.ts b/clients/client-secrets-manager/commands/GetResourcePolicyCommand.ts index dbb4c06d6dedf..714143bff9b41 100644 --- a/clients/client-secrets-manager/commands/GetResourcePolicyCommand.ts +++ b/clients/client-secrets-manager/commands/GetResourcePolicyCommand.ts @@ -20,6 +20,35 @@ import { export type GetResourcePolicyCommandInput = GetResourcePolicyRequest; export type GetResourcePolicyCommandOutput = GetResourcePolicyResponse & __MetadataBearer; +/** + *

Retrieves the JSON text of the resource-based policy document attached to the + * specified secret. The JSON request string input and response output displays formatted code + * with white space and line breaks for better readability. Submit your input as a single line + * JSON string.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:GetResourcePolicy

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To attach a resource policy to a secret, use PutResourcePolicy.

    + *
  • + *
  • + *

    To delete the resource-based policy attached to a secret, use DeleteResourcePolicy.

    + *
  • + *
  • + *

    To list all of the currently available secrets, use ListSecrets.

    + *
  • + *
+ */ export class GetResourcePolicyCommand extends $Command< GetResourcePolicyCommandInput, GetResourcePolicyCommandOutput, @@ -34,6 +63,9 @@ export class GetResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/GetSecretValueCommand.ts b/clients/client-secrets-manager/commands/GetSecretValueCommand.ts index 94ee38881981f..3e2508d24ab32 100644 --- a/clients/client-secrets-manager/commands/GetSecretValueCommand.ts +++ b/clients/client-secrets-manager/commands/GetSecretValueCommand.ts @@ -20,6 +20,36 @@ import { export type GetSecretValueCommandInput = GetSecretValueRequest; export type GetSecretValueCommandOutput = GetSecretValueResponse & __MetadataBearer; +/** + *

Retrieves the contents of the encrypted fields SecretString or + * SecretBinary from the specified version of a secret, whichever contains + * content.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:GetSecretValue

    + *
  • + *
  • + *

    kms:Decrypt - required only if you use a customer-managed AWS KMS key to encrypt the + * secret. You do not need this permission to use the account's default AWS managed CMK for + * Secrets Manager.

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To create a new version of the secret with different encrypted information, use PutSecretValue.

    + *
  • + *
  • + *

    To retrieve the non-encrypted details for the secret, use DescribeSecret.

    + *
  • + *
+ */ export class GetSecretValueCommand extends $Command< GetSecretValueCommandInput, GetSecretValueCommandOutput, @@ -34,6 +64,9 @@ export class GetSecretValueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/ListSecretVersionIdsCommand.ts b/clients/client-secrets-manager/commands/ListSecretVersionIdsCommand.ts index 75d71ce5ee95d..68cc4eb4c14ca 100644 --- a/clients/client-secrets-manager/commands/ListSecretVersionIdsCommand.ts +++ b/clients/client-secrets-manager/commands/ListSecretVersionIdsCommand.ts @@ -20,6 +20,37 @@ import { export type ListSecretVersionIdsCommandInput = ListSecretVersionIdsRequest; export type ListSecretVersionIdsCommandOutput = ListSecretVersionIdsResponse & __MetadataBearer; +/** + *

Lists all of the versions attached to the specified secret. The output does not include + * the SecretString or SecretBinary fields. By default, the list + * includes only versions that have at least one staging label in VersionStage + * attached.

+ * + *

Always check the NextToken response parameter + * when calling any of the List* operations. These operations can occasionally return + * an empty or shorter than expected list of results even when there more results become available. + * When this happens, the NextToken response parameter contains a value to pass to the + * next call to the same API to request the next part of the list.

+ *
+ *

+ * Minimum + * permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:ListSecretVersionIds

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To list the secrets in an account, use ListSecrets.

    + *
  • + *
+ */ export class ListSecretVersionIdsCommand extends $Command< ListSecretVersionIdsCommandInput, ListSecretVersionIdsCommandOutput, @@ -34,6 +65,9 @@ export class ListSecretVersionIdsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/ListSecretsCommand.ts b/clients/client-secrets-manager/commands/ListSecretsCommand.ts index de9774f573c48..97021632f1263 100644 --- a/clients/client-secrets-manager/commands/ListSecretsCommand.ts +++ b/clients/client-secrets-manager/commands/ListSecretsCommand.ts @@ -20,6 +20,38 @@ import { export type ListSecretsCommandInput = ListSecretsRequest; export type ListSecretsCommandOutput = ListSecretsResponse & __MetadataBearer; +/** + *

Lists all of the secrets that are stored by Secrets Manager in the AWS account. To list the + * versions currently stored for a specific secret, use ListSecretVersionIds. + * The encrypted fields SecretString and SecretBinary are not included + * in the output. To get that information, call the GetSecretValue + * operation.

+ * + *

Always check the NextToken response parameter + * when calling any of the List* operations. These operations can occasionally return + * an empty or shorter than expected list of results even when there more results become available. + * When this happens, the NextToken response parameter contains a value to pass to the + * next call to the same API to request the next part of the list.

+ *
+ *

+ * Minimum + * permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:ListSecrets

    + *
  • + *
+ *

+ * Related operations + *

+ * + */ export class ListSecretsCommand extends $Command< ListSecretsCommandInput, ListSecretsCommandOutput, @@ -34,6 +66,9 @@ export class ListSecretsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/PutResourcePolicyCommand.ts b/clients/client-secrets-manager/commands/PutResourcePolicyCommand.ts index eacac17d825c7..4f5dd29b5ecc8 100644 --- a/clients/client-secrets-manager/commands/PutResourcePolicyCommand.ts +++ b/clients/client-secrets-manager/commands/PutResourcePolicyCommand.ts @@ -20,6 +20,40 @@ import { export type PutResourcePolicyCommandInput = PutResourcePolicyRequest; export type PutResourcePolicyCommandOutput = PutResourcePolicyResponse & __MetadataBearer; +/** + *

Attaches the contents of the specified resource-based permission policy to a secret. A + * resource-based policy is optional. Alternatively, you can use IAM identity-based policies + * that specify the secret's Amazon Resource Name (ARN) in the policy statement's + * Resources element. You can also use a combination of both identity-based and + * resource-based policies. The affected users and roles receive the permissions that are + * permitted by all of the relevant policies. For more information, see Using Resource-Based + * Policies for AWS Secrets Manager. For the complete description of the AWS policy syntax and + * grammar, see IAM JSON + * Policy Reference in the IAM User Guide.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:PutResourcePolicy

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To retrieve the resource policy attached to a secret, use GetResourcePolicy.

    + *
  • + *
  • + *

    To delete the resource-based policy that's attached to a secret, use DeleteResourcePolicy.

    + *
  • + *
  • + *

    To list all of the currently available secrets, use ListSecrets.

    + *
  • + *
+ */ export class PutResourcePolicyCommand extends $Command< PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput, @@ -34,6 +68,9 @@ export class PutResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/PutSecretValueCommand.ts b/clients/client-secrets-manager/commands/PutSecretValueCommand.ts index 1a07b48f427bd..c9dd5ada6fe50 100644 --- a/clients/client-secrets-manager/commands/PutSecretValueCommand.ts +++ b/clients/client-secrets-manager/commands/PutSecretValueCommand.ts @@ -20,6 +20,98 @@ import { export type PutSecretValueCommandInput = PutSecretValueRequest; export type PutSecretValueCommandOutput = PutSecretValueResponse & __MetadataBearer; +/** + *

Stores a new encrypted secret value in the specified secret. To do this, the operation + * creates a new version and attaches it to the secret. The version can contain a new + * SecretString value or a new SecretBinary value. You can also + * specify the staging labels that are initially attached to the new version.

+ * + *

The Secrets Manager console uses only the SecretString field. To add binary data to a + * secret with the SecretBinary field you must use the AWS CLI or one of the + * AWS SDKs.

+ *
+ *
    + *
  • + *

    If this operation creates the first version for the secret then Secrets Manager + * automatically attaches the staging label AWSCURRENT to the new version.

    + *
  • + *
  • + *

    If another version of this secret already exists, then this operation does not + * automatically move any staging labels other than those that you explicitly specify in the + * VersionStages parameter.

    + *
  • + *
  • + *

    If this operation moves the staging label AWSCURRENT from another version to this + * version (because you included it in the StagingLabels parameter) then + * Secrets Manager also automatically moves the staging label AWSPREVIOUS to the version that + * AWSCURRENT was removed from.

    + *
  • + *
  • + *

    This operation is idempotent. If a version with a VersionId with the same + * value as the ClientRequestToken parameter already exists and you specify the + * same secret data, the operation succeeds but does nothing. However, if the secret data is + * different, then the operation fails because you cannot modify an existing version; you can + * only create new ones.

    + *
  • + *
+ * + *
    + *
  • + *

    If you call an operation to encrypt or decrypt the SecretString + * or SecretBinary for a secret in the same account as the calling user and that + * secret doesn't specify a AWS KMS encryption key, Secrets Manager uses the account's default + * AWS managed customer master key (CMK) with the alias aws/secretsmanager. If this key + * doesn't already exist in your account then Secrets Manager creates it for you automatically. All + * users and roles in the same AWS account automatically have access to use the default CMK. + * Note that if an Secrets Manager API call results in AWS creating the account's + * AWS-managed CMK, it can result in a one-time significant delay in returning the + * result.

    + *
  • + *
  • + *

    If the secret resides in a different AWS account from the credentials calling an API that + * requires encryption or decryption of the secret value then you must create and use a custom + * AWS KMS CMK because you can't access the default CMK for the account using credentials + * from a different AWS account. Store the ARN of the CMK in the secret when you create the + * secret or when you update it by including it in the KMSKeyId. If you call an + * API that must encrypt or decrypt SecretString or SecretBinary + * using credentials from a different account then the AWS KMS key policy must grant cross-account + * access to that other account's user or role for both the kms:GenerateDataKey and + * kms:Decrypt operations.

    + *
  • + *
+ *
+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:PutSecretValue

    + *
  • + *
  • + *

    kms:GenerateDataKey - needed only if you use a customer-managed AWS KMS key to encrypt + * the secret. You do not need this permission to use the account's default AWS managed CMK + * for Secrets Manager.

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To retrieve the encrypted value you store in the version of a secret, use GetSecretValue.

    + *
  • + *
  • + *

    To create a secret, use CreateSecret.

    + *
  • + *
  • + *

    To get the details for a secret, use DescribeSecret.

    + *
  • + *
  • + *

    To list the versions attached to a secret, use ListSecretVersionIds.

    + *
  • + *
+ */ export class PutSecretValueCommand extends $Command< PutSecretValueCommandInput, PutSecretValueCommandOutput, @@ -34,6 +126,9 @@ export class PutSecretValueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/RestoreSecretCommand.ts b/clients/client-secrets-manager/commands/RestoreSecretCommand.ts index f3404ee1139c0..1349534eadc75 100644 --- a/clients/client-secrets-manager/commands/RestoreSecretCommand.ts +++ b/clients/client-secrets-manager/commands/RestoreSecretCommand.ts @@ -20,6 +20,27 @@ import { export type RestoreSecretCommandInput = RestoreSecretRequest; export type RestoreSecretCommandOutput = RestoreSecretResponse & __MetadataBearer; +/** + *

Cancels the scheduled deletion of a secret by removing the DeletedDate time + * stamp. This makes the secret accessible to query once again.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:RestoreSecret

    + *
  • + *
+ *

+ * Related operations + *

+ * + */ export class RestoreSecretCommand extends $Command< RestoreSecretCommandInput, RestoreSecretCommandOutput, @@ -34,6 +55,9 @@ export class RestoreSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/RotateSecretCommand.ts b/clients/client-secrets-manager/commands/RotateSecretCommand.ts index ccf02fcc6ecd1..a06fd75921c14 100644 --- a/clients/client-secrets-manager/commands/RotateSecretCommand.ts +++ b/clients/client-secrets-manager/commands/RotateSecretCommand.ts @@ -20,6 +20,70 @@ import { export type RotateSecretCommandInput = RotateSecretRequest; export type RotateSecretCommandOutput = RotateSecretResponse & __MetadataBearer; +/** + *

Configures and starts the asynchronous process of rotating this secret. If you include the + * configuration parameters, the operation sets those values for the secret and then immediately + * starts a rotation. If you do not include the configuration parameters, the operation starts a + * rotation with the values already stored in the secret. After the rotation completes, the + * protected service and its clients all use the new version of the secret.

+ *

This required configuration information includes the ARN of an AWS Lambda function and + * the time between scheduled rotations. The Lambda rotation function creates a new version of + * the secret and creates or updates the credentials on the protected service to match. After + * testing the new credentials, the function marks the new secret with the staging label + * AWSCURRENT so that your clients all immediately begin to use the new version. For more + * information about rotating secrets and how to configure a Lambda function to rotate the + * secrets for your protected service, see Rotating Secrets in AWS Secrets Manager in the + * AWS Secrets Manager User Guide.

+ *

Secrets Manager schedules the next rotation when the previous + * one completes. Secrets Manager schedules the date by adding the rotation interval (number of days) to the + * actual date of the last rotation. The service chooses the hour within that 24-hour date window + * randomly. The minute is also chosen somewhat randomly, but weighted towards the top of the hour + * and influenced by a variety of factors that help distribute load.

+ *

The + * rotation function must end with the versions of the secret in one of two states:

+ *
    + *
  • + *

    The AWSPENDING and AWSCURRENT staging labels are attached to the same version of + * the secret, or

    + *
  • + *
  • + *

    The AWSPENDING staging label is not attached to any version of the secret.

    + *
  • + *
+ *

If the AWSPENDING staging label is present but not attached to the same version as + * AWSCURRENT then any later invocation of RotateSecret assumes that a previous + * rotation request is still in progress and returns an error.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:RotateSecret

    + *
  • + *
  • + *

    lambda:InvokeFunction (on the function specified in the secret's metadata)

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To list the secrets in your account, use ListSecrets.

    + *
  • + *
  • + *

    To get the details for a version of a secret, use DescribeSecret.

    + *
  • + *
  • + *

    To create a new version of a secret, use CreateSecret.

    + *
  • + *
  • + *

    To attach staging labels to or remove staging labels from a version of a secret, use + * UpdateSecretVersionStage.

    + *
  • + *
+ */ export class RotateSecretCommand extends $Command< RotateSecretCommandInput, RotateSecretCommandOutput, @@ -34,6 +98,9 @@ export class RotateSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/TagResourceCommand.ts b/clients/client-secrets-manager/commands/TagResourceCommand.ts index 3094bc295029e..d1f4bb9249c3b 100644 --- a/clients/client-secrets-manager/commands/TagResourceCommand.ts +++ b/clients/client-secrets-manager/commands/TagResourceCommand.ts @@ -20,6 +20,64 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Attaches one or more tags, each consisting of a key name and a value, to the specified + * secret. Tags are part of the secret's overall metadata, and are not associated with any + * specific version of the secret. This operation only appends tags to the existing list of tags. + * To remove tags, you must use UntagResource.

+ *

The following basic restrictions apply to tags:

+ *
    + *
  • + *

    Maximum number of tags per secret—50

    + *
  • + *
  • + *

    Maximum key length—127 Unicode characters in UTF-8

    + *
  • + *
  • + *

    Maximum value length—255 Unicode characters in UTF-8

    + *
  • + *
  • + *

    Tag keys and values are case sensitive.

    + *
  • + *
  • + *

    Do not use the aws: prefix in your tag names or values because AWS reserves it + * for AWS use. You can't edit or delete tag names or values with this + * prefix. Tags with this prefix do not count against your tags per secret limit.

    + *
  • + *
  • + *

    If you use your tagging schema across multiple services and resources, + * remember other services might have restrictions on allowed characters. Generally + * allowed characters: letters, spaces, and numbers representable in UTF-8, plus the + * following special characters: + - = . _ : / @.

    + *
  • + *
+ * + *

If you use tags as part of your security strategy, then adding or removing a tag can + * change permissions. If successfully completing this operation would result in you losing + * your permissions for this secret, then the operation is blocked and returns an Access Denied + * error.

+ *
+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:TagResource

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To remove one or more tags from the collection attached to a secret, use UntagResource.

    + *
  • + *
  • + *

    To view the list of tags attached to a secret, use DescribeSecret.

    + *
  • + *
+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +92,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/UntagResourceCommand.ts b/clients/client-secrets-manager/commands/UntagResourceCommand.ts index 0eb955a54f235..44886d139d353 100644 --- a/clients/client-secrets-manager/commands/UntagResourceCommand.ts +++ b/clients/client-secrets-manager/commands/UntagResourceCommand.ts @@ -20,6 +20,37 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Removes one or more tags from the specified secret.

+ *

This operation is idempotent. If a requested tag is not attached to the secret, no error + * is returned and the secret metadata is unchanged.

+ * + *

If you use tags as part of your security strategy, then removing a tag can change + * permissions. If successfully completing this operation would result in you losing your + * permissions for this secret, then the operation is blocked and returns an Access Denied + * error.

+ *
+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:UntagResource

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To add one or more tags to the collection attached to a secret, use TagResource.

    + *
  • + *
  • + *

    To view the list of tags attached to a secret, use DescribeSecret.

    + *
  • + *
+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +65,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/UpdateSecretCommand.ts b/clients/client-secrets-manager/commands/UpdateSecretCommand.ts index 759350d02ea09..26e25050e5bab 100644 --- a/clients/client-secrets-manager/commands/UpdateSecretCommand.ts +++ b/clients/client-secrets-manager/commands/UpdateSecretCommand.ts @@ -20,6 +20,93 @@ import { export type UpdateSecretCommandInput = UpdateSecretRequest; export type UpdateSecretCommandOutput = UpdateSecretResponse & __MetadataBearer; +/** + *

Modifies many of the details of the specified secret. If you include a + * ClientRequestToken and either + * SecretString or SecretBinary then it also creates a new version + * attached to the secret.

+ *

To modify the rotation configuration of a secret, use RotateSecret + * instead.

+ * + *

The Secrets Manager console uses only the SecretString parameter and therefore limits + * you to encrypting and storing only a text string. To encrypt and store binary data as part + * of the version of a secret, you must use either the AWS CLI or one of the AWS + * SDKs.

+ *
+ *
    + *
  • + *

    If a version with a VersionId with the same value as the + * ClientRequestToken parameter already exists, the operation results in an + * error. You cannot modify an existing version, you can only create a new version.

    + *
  • + *
  • + *

    If you include SecretString or SecretBinary to create a new + * secret version, Secrets Manager automatically attaches the staging label AWSCURRENT to the new + * version.

    + *
  • + *
+ * + *
    + *
  • + *

    If you call an operation to encrypt or decrypt the SecretString + * or SecretBinary for a secret in the same account as the calling user and that + * secret doesn't specify a AWS KMS encryption key, Secrets Manager uses the account's default + * AWS managed customer master key (CMK) with the alias aws/secretsmanager. If this key + * doesn't already exist in your account then Secrets Manager creates it for you automatically. All + * users and roles in the same AWS account automatically have access to use the default CMK. + * Note that if an Secrets Manager API call results in AWS creating the account's + * AWS-managed CMK, it can result in a one-time significant delay in returning the + * result.

    + *
  • + *
  • + *

    If the secret resides in a different AWS account from the credentials calling an API that + * requires encryption or decryption of the secret value then you must create and use a custom + * AWS KMS CMK because you can't access the default CMK for the account using credentials + * from a different AWS account. Store the ARN of the CMK in the secret when you create the + * secret or when you update it by including it in the KMSKeyId. If you call an + * API that must encrypt or decrypt SecretString or SecretBinary + * using credentials from a different account then the AWS KMS key policy must grant cross-account + * access to that other account's user or role for both the kms:GenerateDataKey and + * kms:Decrypt operations.

    + *
  • + *
+ *
+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:UpdateSecret

    + *
  • + *
  • + *

    kms:GenerateDataKey - needed only if you use a custom AWS KMS key to encrypt the secret. + * You do not need this permission to use the account's AWS managed CMK for + * Secrets Manager.

    + *
  • + *
  • + *

    kms:Decrypt - needed only if you use a custom AWS KMS key to encrypt the secret. You do + * not need this permission to use the account's AWS managed CMK for Secrets Manager.

    + *
  • + *
+ *

+ * Related operations + *

+ * + */ export class UpdateSecretCommand extends $Command< UpdateSecretCommandInput, UpdateSecretCommandOutput, @@ -34,6 +121,9 @@ export class UpdateSecretCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/UpdateSecretVersionStageCommand.ts b/clients/client-secrets-manager/commands/UpdateSecretVersionStageCommand.ts index a56fdcfcdfacc..6495623d0a265 100644 --- a/clients/client-secrets-manager/commands/UpdateSecretVersionStageCommand.ts +++ b/clients/client-secrets-manager/commands/UpdateSecretVersionStageCommand.ts @@ -20,6 +20,45 @@ import { export type UpdateSecretVersionStageCommandInput = UpdateSecretVersionStageRequest; export type UpdateSecretVersionStageCommandOutput = UpdateSecretVersionStageResponse & __MetadataBearer; +/** + *

Modifies the staging labels attached to a version of a secret. Staging labels are used to + * track a version as it progresses through the secret rotation process. You can attach a staging + * label to only one version of a secret at a time. If a staging label to be added is already + * attached to another version, then it is moved--removed from the other version first and + * then attached to this one. For more information about staging labels, see Staging + * Labels in the AWS Secrets Manager User Guide.

+ *

The staging labels that you specify in the VersionStage parameter are added + * to the existing list of staging labels--they don't replace it.

+ *

You can move the AWSCURRENT staging label to this version by including it in this + * call.

+ * + *

Whenever you move AWSCURRENT, Secrets Manager automatically moves the label AWSPREVIOUS + * to the version that AWSCURRENT was removed from.

+ *
+ *

If this action results in the last label being removed from a version, then the version is + * considered to be 'deprecated' and can be deleted by Secrets Manager.

+ *

+ * Minimum permissions + *

+ *

To run this command, you must have the following permissions:

+ *
    + *
  • + *

    secretsmanager:UpdateSecretVersionStage

    + *
  • + *
+ *

+ * Related operations + *

+ *
    + *
  • + *

    To get the list of staging labels that are currently associated with a version of a + * secret, use + * DescribeSecret + * and examine the + * SecretVersionsToStages response value.

    + *
  • + *
+ */ export class UpdateSecretVersionStageCommand extends $Command< UpdateSecretVersionStageCommandInput, UpdateSecretVersionStageCommandOutput, @@ -34,6 +73,9 @@ export class UpdateSecretVersionStageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/commands/ValidateResourcePolicyCommand.ts b/clients/client-secrets-manager/commands/ValidateResourcePolicyCommand.ts index 1fd2cc04f10a3..42dde22d49754 100644 --- a/clients/client-secrets-manager/commands/ValidateResourcePolicyCommand.ts +++ b/clients/client-secrets-manager/commands/ValidateResourcePolicyCommand.ts @@ -20,6 +20,13 @@ import { export type ValidateResourcePolicyCommandInput = ValidateResourcePolicyRequest; export type ValidateResourcePolicyCommandOutput = ValidateResourcePolicyResponse & __MetadataBearer; +/** + *

Validates the JSON text of the resource-based policy document attached to the + * specified secret. The JSON request string input and response output displays formatted code + * with white space and line breaks for better readability. Submit your input as a single line + * JSON string. A resource-based + * policy is optional.

+ */ export class ValidateResourcePolicyCommand extends $Command< ValidateResourcePolicyCommandInput, ValidateResourcePolicyCommandOutput, @@ -34,6 +41,9 @@ export class ValidateResourcePolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecretsManagerClientResolvedConfig, diff --git a/clients/client-secrets-manager/package.json b/clients/client-secrets-manager/package.json index 1f91802e45d71..cac8367d7303e 100644 --- a/clients/client-secrets-manager/package.json +++ b/clients/client-secrets-manager/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Secrets Manager Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-secrets-manager/pagination/ListSecretVersionIdsPaginator.ts b/clients/client-secrets-manager/pagination/ListSecretVersionIdsPaginator.ts index 48d6274f27215..2850084aec87e 100644 --- a/clients/client-secrets-manager/pagination/ListSecretVersionIdsPaginator.ts +++ b/clients/client-secrets-manager/pagination/ListSecretVersionIdsPaginator.ts @@ -8,6 +8,9 @@ import { import { SecretsManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecretsManagerClient, input: ListSecretVersionIdsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSecretVersionIdsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecretsManager, input: ListSecretVersionIdsCommandInput, diff --git a/clients/client-secrets-manager/pagination/ListSecretsPaginator.ts b/clients/client-secrets-manager/pagination/ListSecretsPaginator.ts index 09483c1c9563c..2ab3133f39380 100644 --- a/clients/client-secrets-manager/pagination/ListSecretsPaginator.ts +++ b/clients/client-secrets-manager/pagination/ListSecretsPaginator.ts @@ -4,6 +4,9 @@ import { ListSecretsCommand, ListSecretsCommandInput, ListSecretsCommandOutput } import { SecretsManagerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecretsManagerClient, input: ListSecretsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSecretsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecretsManager, input: ListSecretsCommandInput, diff --git a/clients/client-secrets-manager/runtimeConfig.browser.ts b/clients/client-secrets-manager/runtimeConfig.browser.ts index f41415a1aacb7..140e64cc15a6a 100644 --- a/clients/client-secrets-manager/runtimeConfig.browser.ts +++ b/clients/client-secrets-manager/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SecretsManagerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-secrets-manager/runtimeConfig.native.ts b/clients/client-secrets-manager/runtimeConfig.native.ts index 058c90a326273..657c775b8f3f7 100644 --- a/clients/client-secrets-manager/runtimeConfig.native.ts +++ b/clients/client-secrets-manager/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SecretsManagerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-secrets-manager/runtimeConfig.shared.ts b/clients/client-secrets-manager/runtimeConfig.shared.ts index 04b23e8d0a1fe..fe9b3c5f217d8 100644 --- a/clients/client-secrets-manager/runtimeConfig.shared.ts +++ b/clients/client-secrets-manager/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-17", disableHostPrefix: false, diff --git a/clients/client-secrets-manager/runtimeConfig.ts b/clients/client-secrets-manager/runtimeConfig.ts index f6745d87be74b..8f54fe76eb283 100644 --- a/clients/client-secrets-manager/runtimeConfig.ts +++ b/clients/client-secrets-manager/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SecretsManagerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-secrets-manager/tsconfig.json b/clients/client-secrets-manager/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-secrets-manager/tsconfig.json +++ b/clients/client-secrets-manager/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-securityhub/commands/AcceptInvitationCommand.ts b/clients/client-securityhub/commands/AcceptInvitationCommand.ts index ee181d3142c47..a31712a11a4a8 100644 --- a/clients/client-securityhub/commands/AcceptInvitationCommand.ts +++ b/clients/client-securityhub/commands/AcceptInvitationCommand.ts @@ -20,6 +20,12 @@ import { export type AcceptInvitationCommandInput = AcceptInvitationRequest; export type AcceptInvitationCommandOutput = AcceptInvitationResponse & __MetadataBearer; +/** + *

Accepts the invitation to be a member account and be monitored by the Security Hub master + * account that the invitation was sent from.

+ *

When the member account accepts the invitation, permission is granted to the master + * account to view findings generated in the member account.

+ */ export class AcceptInvitationCommand extends $Command< AcceptInvitationCommandInput, AcceptInvitationCommandOutput, @@ -34,6 +40,9 @@ export class AcceptInvitationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/BatchDisableStandardsCommand.ts b/clients/client-securityhub/commands/BatchDisableStandardsCommand.ts index 1ef1bc6010d1f..dc242970a36bb 100644 --- a/clients/client-securityhub/commands/BatchDisableStandardsCommand.ts +++ b/clients/client-securityhub/commands/BatchDisableStandardsCommand.ts @@ -20,6 +20,12 @@ import { export type BatchDisableStandardsCommandInput = BatchDisableStandardsRequest; export type BatchDisableStandardsCommandOutput = BatchDisableStandardsResponse & __MetadataBearer; +/** + *

Disables the standards specified by the provided + * StandardsSubscriptionArns.

+ *

For more information, see Security Standards section of the AWS Security Hub User + * Guide.

+ */ export class BatchDisableStandardsCommand extends $Command< BatchDisableStandardsCommandInput, BatchDisableStandardsCommandOutput, @@ -34,6 +40,9 @@ export class BatchDisableStandardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/BatchEnableStandardsCommand.ts b/clients/client-securityhub/commands/BatchEnableStandardsCommand.ts index 8b39e493c3050..7c316f8042d9a 100644 --- a/clients/client-securityhub/commands/BatchEnableStandardsCommand.ts +++ b/clients/client-securityhub/commands/BatchEnableStandardsCommand.ts @@ -20,6 +20,15 @@ import { export type BatchEnableStandardsCommandInput = BatchEnableStandardsRequest; export type BatchEnableStandardsCommandOutput = BatchEnableStandardsResponse & __MetadataBearer; +/** + *

Enables the standards specified by the provided StandardsArn. To obtain the + * ARN for a standard, use the + * DescribeStandards + * + * operation.

+ *

For more information, see the Security Standards + * section of the AWS Security Hub User Guide.

+ */ export class BatchEnableStandardsCommand extends $Command< BatchEnableStandardsCommandInput, BatchEnableStandardsCommandOutput, @@ -34,6 +43,9 @@ export class BatchEnableStandardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/BatchImportFindingsCommand.ts b/clients/client-securityhub/commands/BatchImportFindingsCommand.ts index 2eb593db00d10..3455c5d2437ba 100644 --- a/clients/client-securityhub/commands/BatchImportFindingsCommand.ts +++ b/clients/client-securityhub/commands/BatchImportFindingsCommand.ts @@ -20,6 +20,63 @@ import { export type BatchImportFindingsCommandInput = BatchImportFindingsRequest; export type BatchImportFindingsCommandOutput = BatchImportFindingsResponse & __MetadataBearer; +/** + *

Imports security findings generated from an integrated third-party product into Security Hub. + * This action is requested by the integrated product to import its findings into + * Security Hub.

+ *

The maximum allowed size for a finding is 240 Kb. An error is returned for any finding + * larger than 240 Kb.

+ *

After a finding is created, BatchImportFindings cannot be used to update + * the following finding fields and objects, which Security Hub customers use to manage their + * investigation workflow.

+ *
    + *
  • + *

    + * Confidence + *

    + *
  • + *
  • + *

    + * Criticality + *

    + *
  • + *
  • + *

    + * Note + *

    + *
  • + *
  • + *

    + * RelatedFindings + *

    + *
  • + *
  • + *

    + * Severity + *

    + *
  • + *
  • + *

    + * Types + *

    + *
  • + *
  • + *

    + * UserDefinedFields + *

    + *
  • + *
  • + *

    + * VerificationState + *

    + *
  • + *
  • + *

    + * Workflow + *

    + *
  • + *
+ */ export class BatchImportFindingsCommand extends $Command< BatchImportFindingsCommandInput, BatchImportFindingsCommandOutput, @@ -34,6 +91,9 @@ export class BatchImportFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/BatchUpdateFindingsCommand.ts b/clients/client-securityhub/commands/BatchUpdateFindingsCommand.ts index e56379f2beb52..0e012cc06263f 100644 --- a/clients/client-securityhub/commands/BatchUpdateFindingsCommand.ts +++ b/clients/client-securityhub/commands/BatchUpdateFindingsCommand.ts @@ -20,6 +20,67 @@ import { export type BatchUpdateFindingsCommandInput = BatchUpdateFindingsRequest; export type BatchUpdateFindingsCommandOutput = BatchUpdateFindingsResponse & __MetadataBearer; +/** + *

Used by Security Hub customers to update information about their investigation into a finding. + * Requested by master accounts or member accounts. Master accounts can update findings for + * their account and their member accounts. Member accounts can update findings for their + * account.

+ *

Updates from BatchUpdateFindings do not affect the value of + * UpdatedAt for a finding.

+ *

Master and member accounts can use BatchUpdateFindings to update the + * following finding fields and objects.

+ *
    + *
  • + *

    + * Confidence + *

    + *
  • + *
  • + *

    + * Criticality + *

    + *
  • + *
  • + *

    + * Note + *

    + *
  • + *
  • + *

    + * RelatedFindings + *

    + *
  • + *
  • + *

    + * Severity + *

    + *
  • + *
  • + *

    + * Types + *

    + *
  • + *
  • + *

    + * UserDefinedFields + *

    + *
  • + *
  • + *

    + * VerificationState + *

    + *
  • + *
  • + *

    + * Workflow + *

    + *
  • + *
+ *

You can configure IAM policies to restrict access to fields and field values. For + * example, you might not want member accounts to be able to suppress findings or change the + * finding severity. See Configuring access to BatchUpdateFindings in the + * AWS Security Hub User Guide.

+ */ export class BatchUpdateFindingsCommand extends $Command< BatchUpdateFindingsCommandInput, BatchUpdateFindingsCommandOutput, @@ -34,6 +95,9 @@ export class BatchUpdateFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/CreateActionTargetCommand.ts b/clients/client-securityhub/commands/CreateActionTargetCommand.ts index 6562dfaf9f956..0030df0010f92 100644 --- a/clients/client-securityhub/commands/CreateActionTargetCommand.ts +++ b/clients/client-securityhub/commands/CreateActionTargetCommand.ts @@ -20,6 +20,11 @@ import { export type CreateActionTargetCommandInput = CreateActionTargetRequest; export type CreateActionTargetCommandOutput = CreateActionTargetResponse & __MetadataBearer; +/** + *

Creates a custom action target in Security Hub.

+ *

You can use custom actions on findings and insights in Security Hub to trigger target actions + * in Amazon CloudWatch Events.

+ */ export class CreateActionTargetCommand extends $Command< CreateActionTargetCommandInput, CreateActionTargetCommandOutput, @@ -34,6 +39,9 @@ export class CreateActionTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/CreateInsightCommand.ts b/clients/client-securityhub/commands/CreateInsightCommand.ts index 9122f3bd49226..8e48c4330adcf 100644 --- a/clients/client-securityhub/commands/CreateInsightCommand.ts +++ b/clients/client-securityhub/commands/CreateInsightCommand.ts @@ -20,6 +20,12 @@ import { export type CreateInsightCommandInput = CreateInsightRequest; export type CreateInsightCommandOutput = CreateInsightResponse & __MetadataBearer; +/** + *

Creates a custom insight in Security Hub. An insight is a consolidation of findings that relate + * to a security issue that requires attention or remediation.

+ *

To group the related findings in the insight, use the + * GroupByAttribute.

+ */ export class CreateInsightCommand extends $Command< CreateInsightCommandInput, CreateInsightCommandOutput, @@ -34,6 +40,9 @@ export class CreateInsightCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/CreateMembersCommand.ts b/clients/client-securityhub/commands/CreateMembersCommand.ts index 6e8c0fc0a961a..8eaae5e825cf8 100644 --- a/clients/client-securityhub/commands/CreateMembersCommand.ts +++ b/clients/client-securityhub/commands/CreateMembersCommand.ts @@ -20,6 +20,28 @@ import { export type CreateMembersCommandInput = CreateMembersRequest; export type CreateMembersCommandOutput = CreateMembersResponse & __MetadataBearer; +/** + *

Creates a member association in Security Hub between the specified accounts and the account + * used to make the request, which is the master account. To successfully create a member, you + * must use this action from an account that already has Security Hub enabled. To enable Security Hub, you + * can use the + * EnableSecurityHub + * operation.

+ *

After you use CreateMembers to create member account associations in Security Hub, + * you must use the + * InviteMembers + * operation to invite the + * accounts to enable Security Hub and become member accounts in Security Hub.

+ *

If the account owner accepts the invitation, the account becomes a member account in + * Security Hub. A permissions policy is added that permits the master account to view the findings + * generated in the member account. When Security Hub is enabled in the invited account, findings + * start to be sent to both the member and master accounts.

+ *

To remove the association between the master and member accounts, use the + * DisassociateFromMasterAccount + * or + * DisassociateMembers + * operation.

+ */ export class CreateMembersCommand extends $Command< CreateMembersCommandInput, CreateMembersCommandOutput, @@ -34,6 +56,9 @@ export class CreateMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DeclineInvitationsCommand.ts b/clients/client-securityhub/commands/DeclineInvitationsCommand.ts index 3369a0542e731..63dadb5feb9b7 100644 --- a/clients/client-securityhub/commands/DeclineInvitationsCommand.ts +++ b/clients/client-securityhub/commands/DeclineInvitationsCommand.ts @@ -20,6 +20,9 @@ import { export type DeclineInvitationsCommandInput = DeclineInvitationsRequest; export type DeclineInvitationsCommandOutput = DeclineInvitationsResponse & __MetadataBearer; +/** + *

Declines invitations to become a member account.

+ */ export class DeclineInvitationsCommand extends $Command< DeclineInvitationsCommandInput, DeclineInvitationsCommandOutput, @@ -34,6 +37,9 @@ export class DeclineInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DeleteActionTargetCommand.ts b/clients/client-securityhub/commands/DeleteActionTargetCommand.ts index 6bfe466faaf28..3951c2a75e852 100644 --- a/clients/client-securityhub/commands/DeleteActionTargetCommand.ts +++ b/clients/client-securityhub/commands/DeleteActionTargetCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteActionTargetCommandInput = DeleteActionTargetRequest; export type DeleteActionTargetCommandOutput = DeleteActionTargetResponse & __MetadataBearer; +/** + *

Deletes a custom action target from Security Hub.

+ *

Deleting a custom action target does not affect any findings or insights that were + * already sent to Amazon CloudWatch Events using the custom action.

+ */ export class DeleteActionTargetCommand extends $Command< DeleteActionTargetCommandInput, DeleteActionTargetCommandOutput, @@ -34,6 +39,9 @@ export class DeleteActionTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DeleteInsightCommand.ts b/clients/client-securityhub/commands/DeleteInsightCommand.ts index ec67d3244723d..b2a38c8a2100b 100644 --- a/clients/client-securityhub/commands/DeleteInsightCommand.ts +++ b/clients/client-securityhub/commands/DeleteInsightCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteInsightCommandInput = DeleteInsightRequest; export type DeleteInsightCommandOutput = DeleteInsightResponse & __MetadataBearer; +/** + *

Deletes the insight specified by the InsightArn.

+ */ export class DeleteInsightCommand extends $Command< DeleteInsightCommandInput, DeleteInsightCommandOutput, @@ -34,6 +37,9 @@ export class DeleteInsightCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DeleteInvitationsCommand.ts b/clients/client-securityhub/commands/DeleteInvitationsCommand.ts index d49a28387c9f5..b1b35f8bec6fb 100644 --- a/clients/client-securityhub/commands/DeleteInvitationsCommand.ts +++ b/clients/client-securityhub/commands/DeleteInvitationsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteInvitationsCommandInput = DeleteInvitationsRequest; export type DeleteInvitationsCommandOutput = DeleteInvitationsResponse & __MetadataBearer; +/** + *

Deletes invitations received by the AWS account to become a member account.

+ */ export class DeleteInvitationsCommand extends $Command< DeleteInvitationsCommandInput, DeleteInvitationsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DeleteMembersCommand.ts b/clients/client-securityhub/commands/DeleteMembersCommand.ts index ac80aedcba00a..0025c33d0f0cb 100644 --- a/clients/client-securityhub/commands/DeleteMembersCommand.ts +++ b/clients/client-securityhub/commands/DeleteMembersCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMembersCommandInput = DeleteMembersRequest; export type DeleteMembersCommandOutput = DeleteMembersResponse & __MetadataBearer; +/** + *

Deletes the specified member accounts from Security Hub.

+ */ export class DeleteMembersCommand extends $Command< DeleteMembersCommandInput, DeleteMembersCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DescribeActionTargetsCommand.ts b/clients/client-securityhub/commands/DescribeActionTargetsCommand.ts index 87a6b3828a5eb..a7f224e47673e 100644 --- a/clients/client-securityhub/commands/DescribeActionTargetsCommand.ts +++ b/clients/client-securityhub/commands/DescribeActionTargetsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeActionTargetsCommandInput = DescribeActionTargetsRequest; export type DescribeActionTargetsCommandOutput = DescribeActionTargetsResponse & __MetadataBearer; +/** + *

Returns a list of the custom action targets in Security Hub in your account.

+ */ export class DescribeActionTargetsCommand extends $Command< DescribeActionTargetsCommandInput, DescribeActionTargetsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeActionTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DescribeHubCommand.ts b/clients/client-securityhub/commands/DescribeHubCommand.ts index 5f5a6cf771bcd..8dd804cf54e41 100644 --- a/clients/client-securityhub/commands/DescribeHubCommand.ts +++ b/clients/client-securityhub/commands/DescribeHubCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeHubCommandInput = DescribeHubRequest; export type DescribeHubCommandOutput = DescribeHubResponse & __MetadataBearer; +/** + *

Returns details about the Hub resource in your account, including the + * HubArn and the time when you enabled Security Hub.

+ */ export class DescribeHubCommand extends $Command< DescribeHubCommandInput, DescribeHubCommandOutput, @@ -34,6 +38,9 @@ export class DescribeHubCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DescribeProductsCommand.ts b/clients/client-securityhub/commands/DescribeProductsCommand.ts index c3088f2905b94..b5cb9f54cd84a 100644 --- a/clients/client-securityhub/commands/DescribeProductsCommand.ts +++ b/clients/client-securityhub/commands/DescribeProductsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeProductsCommandInput = DescribeProductsRequest; export type DescribeProductsCommandOutput = DescribeProductsResponse & __MetadataBearer; +/** + *

Returns information about the available products that you can subscribe to and integrate + * with Security Hub in order to consolidate findings.

+ */ export class DescribeProductsCommand extends $Command< DescribeProductsCommandInput, DescribeProductsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeProductsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DescribeStandardsCommand.ts b/clients/client-securityhub/commands/DescribeStandardsCommand.ts index 7e239e36dad1d..d30a5f181cf10 100644 --- a/clients/client-securityhub/commands/DescribeStandardsCommand.ts +++ b/clients/client-securityhub/commands/DescribeStandardsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeStandardsCommandInput = DescribeStandardsRequest; export type DescribeStandardsCommandOutput = DescribeStandardsResponse & __MetadataBearer; +/** + *

Returns a list of the available standards in Security Hub.

+ *

For each standard, the results include the standard ARN, the name, and a description.

+ */ export class DescribeStandardsCommand extends $Command< DescribeStandardsCommandInput, DescribeStandardsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeStandardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DescribeStandardsControlsCommand.ts b/clients/client-securityhub/commands/DescribeStandardsControlsCommand.ts index f2cab3af2bdbb..79cf8df3efd9a 100644 --- a/clients/client-securityhub/commands/DescribeStandardsControlsCommand.ts +++ b/clients/client-securityhub/commands/DescribeStandardsControlsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeStandardsControlsCommandInput = DescribeStandardsControlsRequest; export type DescribeStandardsControlsCommandOutput = DescribeStandardsControlsResponse & __MetadataBearer; +/** + *

Returns a list of security standards controls.

+ *

For each control, the results include information about whether it is currently enabled, + * the severity, and a link to remediation information.

+ */ export class DescribeStandardsControlsCommand extends $Command< DescribeStandardsControlsCommandInput, DescribeStandardsControlsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeStandardsControlsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DisableImportFindingsForProductCommand.ts b/clients/client-securityhub/commands/DisableImportFindingsForProductCommand.ts index 6c4c7f1501e06..5ac1a91d890e3 100644 --- a/clients/client-securityhub/commands/DisableImportFindingsForProductCommand.ts +++ b/clients/client-securityhub/commands/DisableImportFindingsForProductCommand.ts @@ -20,6 +20,10 @@ import { export type DisableImportFindingsForProductCommandInput = DisableImportFindingsForProductRequest; export type DisableImportFindingsForProductCommandOutput = DisableImportFindingsForProductResponse & __MetadataBearer; +/** + *

Disables the integration of the specified product with Security Hub. After the integration is + * disabled, findings from that product are no longer sent to Security Hub.

+ */ export class DisableImportFindingsForProductCommand extends $Command< DisableImportFindingsForProductCommandInput, DisableImportFindingsForProductCommandOutput, @@ -34,6 +38,9 @@ export class DisableImportFindingsForProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DisableSecurityHubCommand.ts b/clients/client-securityhub/commands/DisableSecurityHubCommand.ts index 2efdd578ffe20..4acd4f676c90e 100644 --- a/clients/client-securityhub/commands/DisableSecurityHubCommand.ts +++ b/clients/client-securityhub/commands/DisableSecurityHubCommand.ts @@ -20,6 +20,17 @@ import { export type DisableSecurityHubCommandInput = DisableSecurityHubRequest; export type DisableSecurityHubCommandOutput = DisableSecurityHubResponse & __MetadataBearer; +/** + *

Disables Security Hub in your account only in the current Region. To disable Security Hub in all + * Regions, you must submit one request per Region where you have enabled Security Hub.

+ *

When you disable Security Hub for a master account, it doesn't disable Security Hub for any associated + * member accounts.

+ *

When you disable Security Hub, your existing findings and insights and any Security Hub configuration + * settings are deleted after 90 days and cannot be recovered. Any standards that were enabled + * are disabled, and your master and member account associations are removed.

+ *

If you want to save your existing findings, you must export them before you disable + * Security Hub.

+ */ export class DisableSecurityHubCommand extends $Command< DisableSecurityHubCommandInput, DisableSecurityHubCommandOutput, @@ -34,6 +45,9 @@ export class DisableSecurityHubCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DisassociateFromMasterAccountCommand.ts b/clients/client-securityhub/commands/DisassociateFromMasterAccountCommand.ts index b7c709a1a6e2b..0123ae2453c2c 100644 --- a/clients/client-securityhub/commands/DisassociateFromMasterAccountCommand.ts +++ b/clients/client-securityhub/commands/DisassociateFromMasterAccountCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateFromMasterAccountCommandInput = DisassociateFromMasterAccountRequest; export type DisassociateFromMasterAccountCommandOutput = DisassociateFromMasterAccountResponse & __MetadataBearer; +/** + *

Disassociates the current Security Hub member account from the associated master + * account.

+ */ export class DisassociateFromMasterAccountCommand extends $Command< DisassociateFromMasterAccountCommandInput, DisassociateFromMasterAccountCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateFromMasterAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/DisassociateMembersCommand.ts b/clients/client-securityhub/commands/DisassociateMembersCommand.ts index f7ad85743642d..7f6b6a6d46b74 100644 --- a/clients/client-securityhub/commands/DisassociateMembersCommand.ts +++ b/clients/client-securityhub/commands/DisassociateMembersCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateMembersCommandInput = DisassociateMembersRequest; export type DisassociateMembersCommandOutput = DisassociateMembersResponse & __MetadataBearer; +/** + *

Disassociates the specified member accounts from the associated master account.

+ */ export class DisassociateMembersCommand extends $Command< DisassociateMembersCommandInput, DisassociateMembersCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/EnableImportFindingsForProductCommand.ts b/clients/client-securityhub/commands/EnableImportFindingsForProductCommand.ts index d4498306cb75e..7792618343fb5 100644 --- a/clients/client-securityhub/commands/EnableImportFindingsForProductCommand.ts +++ b/clients/client-securityhub/commands/EnableImportFindingsForProductCommand.ts @@ -20,6 +20,12 @@ import { export type EnableImportFindingsForProductCommandInput = EnableImportFindingsForProductRequest; export type EnableImportFindingsForProductCommandOutput = EnableImportFindingsForProductResponse & __MetadataBearer; +/** + *

Enables the integration of a partner product with Security Hub. Integrated products send + * findings to Security Hub.

+ *

When you enable a product integration, a permissions policy that grants permission for + * the product to send findings to Security Hub is applied.

+ */ export class EnableImportFindingsForProductCommand extends $Command< EnableImportFindingsForProductCommandInput, EnableImportFindingsForProductCommandOutput, @@ -34,6 +40,9 @@ export class EnableImportFindingsForProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/EnableSecurityHubCommand.ts b/clients/client-securityhub/commands/EnableSecurityHubCommand.ts index 091e1a312441f..f9e088b4339c3 100644 --- a/clients/client-securityhub/commands/EnableSecurityHubCommand.ts +++ b/clients/client-securityhub/commands/EnableSecurityHubCommand.ts @@ -20,6 +20,33 @@ import { export type EnableSecurityHubCommandInput = EnableSecurityHubRequest; export type EnableSecurityHubCommandOutput = EnableSecurityHubResponse & __MetadataBearer; +/** + *

Enables Security Hub for your account in the current Region or the Region you specify in the + * request.

+ *

When you enable Security Hub, you grant to Security Hub the permissions necessary to gather findings + * from other services that are integrated with Security Hub.

+ *

When you use the EnableSecurityHub operation to enable Security Hub, you also + * automatically enable the following standards.

+ *
    + *
  • + *

    CIS AWS Foundations

    + *
  • + *
  • + *

    AWS Foundational Security Best Practices

    + *
  • + *
+ *

You do not enable the Payment Card Industry Data Security Standard (PCI DSS) standard.

+ *

To not enable the automatically enabled standards, set + * EnableDefaultStandards to false.

+ *

After you enable Security Hub, to enable a standard, use the + * BatchEnableStandards + * operation. To disable a standard, use the + * + * BatchDisableStandards + * operation.

+ *

To learn more, see Setting Up + * AWS Security Hub in the AWS Security Hub User Guide.

+ */ export class EnableSecurityHubCommand extends $Command< EnableSecurityHubCommandInput, EnableSecurityHubCommandOutput, @@ -34,6 +61,9 @@ export class EnableSecurityHubCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/GetEnabledStandardsCommand.ts b/clients/client-securityhub/commands/GetEnabledStandardsCommand.ts index 0196adc736430..9b36e39a5ed0f 100644 --- a/clients/client-securityhub/commands/GetEnabledStandardsCommand.ts +++ b/clients/client-securityhub/commands/GetEnabledStandardsCommand.ts @@ -20,6 +20,9 @@ import { export type GetEnabledStandardsCommandInput = GetEnabledStandardsRequest; export type GetEnabledStandardsCommandOutput = GetEnabledStandardsResponse & __MetadataBearer; +/** + *

Returns a list of the standards that are currently enabled.

+ */ export class GetEnabledStandardsCommand extends $Command< GetEnabledStandardsCommandInput, GetEnabledStandardsCommandOutput, @@ -34,6 +37,9 @@ export class GetEnabledStandardsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/GetFindingsCommand.ts b/clients/client-securityhub/commands/GetFindingsCommand.ts index 9ec243f081bc1..286bc1bd26b42 100644 --- a/clients/client-securityhub/commands/GetFindingsCommand.ts +++ b/clients/client-securityhub/commands/GetFindingsCommand.ts @@ -20,6 +20,9 @@ import { export type GetFindingsCommandInput = GetFindingsRequest; export type GetFindingsCommandOutput = GetFindingsResponse & __MetadataBearer; +/** + *

Returns a list of findings that match the specified criteria.

+ */ export class GetFindingsCommand extends $Command< GetFindingsCommandInput, GetFindingsCommandOutput, @@ -34,6 +37,9 @@ export class GetFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/GetInsightResultsCommand.ts b/clients/client-securityhub/commands/GetInsightResultsCommand.ts index ec693e23f3eaa..17415f08081ba 100644 --- a/clients/client-securityhub/commands/GetInsightResultsCommand.ts +++ b/clients/client-securityhub/commands/GetInsightResultsCommand.ts @@ -20,6 +20,9 @@ import { export type GetInsightResultsCommandInput = GetInsightResultsRequest; export type GetInsightResultsCommandOutput = GetInsightResultsResponse & __MetadataBearer; +/** + *

Lists the results of the Security Hub insight specified by the insight ARN.

+ */ export class GetInsightResultsCommand extends $Command< GetInsightResultsCommandInput, GetInsightResultsCommandOutput, @@ -34,6 +37,9 @@ export class GetInsightResultsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/GetInsightsCommand.ts b/clients/client-securityhub/commands/GetInsightsCommand.ts index c5ca58d40b038..ddc9c67a85501 100644 --- a/clients/client-securityhub/commands/GetInsightsCommand.ts +++ b/clients/client-securityhub/commands/GetInsightsCommand.ts @@ -20,6 +20,9 @@ import { export type GetInsightsCommandInput = GetInsightsRequest; export type GetInsightsCommandOutput = GetInsightsResponse & __MetadataBearer; +/** + *

Lists and describes insights for the specified insight ARNs.

+ */ export class GetInsightsCommand extends $Command< GetInsightsCommandInput, GetInsightsCommandOutput, @@ -34,6 +37,9 @@ export class GetInsightsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/GetInvitationsCountCommand.ts b/clients/client-securityhub/commands/GetInvitationsCountCommand.ts index 66fda67027f67..40bf1707cf097 100644 --- a/clients/client-securityhub/commands/GetInvitationsCountCommand.ts +++ b/clients/client-securityhub/commands/GetInvitationsCountCommand.ts @@ -20,6 +20,10 @@ import { export type GetInvitationsCountCommandInput = GetInvitationsCountRequest; export type GetInvitationsCountCommandOutput = GetInvitationsCountResponse & __MetadataBearer; +/** + *

Returns the count of all Security Hub membership invitations that were sent to the + * current member account, not including the currently accepted invitation.

+ */ export class GetInvitationsCountCommand extends $Command< GetInvitationsCountCommandInput, GetInvitationsCountCommandOutput, @@ -34,6 +38,9 @@ export class GetInvitationsCountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/GetMasterAccountCommand.ts b/clients/client-securityhub/commands/GetMasterAccountCommand.ts index e58913ced9b19..f5e2525b6a91c 100644 --- a/clients/client-securityhub/commands/GetMasterAccountCommand.ts +++ b/clients/client-securityhub/commands/GetMasterAccountCommand.ts @@ -20,6 +20,9 @@ import { export type GetMasterAccountCommandInput = GetMasterAccountRequest; export type GetMasterAccountCommandOutput = GetMasterAccountResponse & __MetadataBearer; +/** + *

Provides the details for the Security Hub master account for the current member account.

+ */ export class GetMasterAccountCommand extends $Command< GetMasterAccountCommandInput, GetMasterAccountCommandOutput, @@ -34,6 +37,9 @@ export class GetMasterAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/GetMembersCommand.ts b/clients/client-securityhub/commands/GetMembersCommand.ts index 933223a870037..b3fcedeb850be 100644 --- a/clients/client-securityhub/commands/GetMembersCommand.ts +++ b/clients/client-securityhub/commands/GetMembersCommand.ts @@ -20,6 +20,9 @@ import { export type GetMembersCommandInput = GetMembersRequest; export type GetMembersCommandOutput = GetMembersResponse & __MetadataBearer; +/** + *

Returns the details for the Security Hub member accounts for the specified account IDs.

+ */ export class GetMembersCommand extends $Command< GetMembersCommandInput, GetMembersCommandOutput, @@ -34,6 +37,9 @@ export class GetMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/InviteMembersCommand.ts b/clients/client-securityhub/commands/InviteMembersCommand.ts index f635f3c2495a5..9e17fd4cd90cb 100644 --- a/clients/client-securityhub/commands/InviteMembersCommand.ts +++ b/clients/client-securityhub/commands/InviteMembersCommand.ts @@ -20,6 +20,15 @@ import { export type InviteMembersCommandInput = InviteMembersRequest; export type InviteMembersCommandOutput = InviteMembersResponse & __MetadataBearer; +/** + *

Invites other AWS accounts to become member accounts for the Security Hub master account that + * the invitation is sent from.

+ *

Before you can use this action to invite a member, you must first use the + * CreateMembers + * action to create the member account in Security Hub.

+ *

When the account owner accepts the invitation to become a member account and enables + * Security Hub, the master account can view the findings generated from the member account.

+ */ export class InviteMembersCommand extends $Command< InviteMembersCommandInput, InviteMembersCommandOutput, @@ -34,6 +43,9 @@ export class InviteMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/ListEnabledProductsForImportCommand.ts b/clients/client-securityhub/commands/ListEnabledProductsForImportCommand.ts index fc54a253c45e4..180e306b98466 100644 --- a/clients/client-securityhub/commands/ListEnabledProductsForImportCommand.ts +++ b/clients/client-securityhub/commands/ListEnabledProductsForImportCommand.ts @@ -20,6 +20,10 @@ import { export type ListEnabledProductsForImportCommandInput = ListEnabledProductsForImportRequest; export type ListEnabledProductsForImportCommandOutput = ListEnabledProductsForImportResponse & __MetadataBearer; +/** + *

Lists all findings-generating solutions (products) that you are subscribed to receive + * findings from in Security Hub.

+ */ export class ListEnabledProductsForImportCommand extends $Command< ListEnabledProductsForImportCommandInput, ListEnabledProductsForImportCommandOutput, @@ -34,6 +38,9 @@ export class ListEnabledProductsForImportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/ListInvitationsCommand.ts b/clients/client-securityhub/commands/ListInvitationsCommand.ts index a469fe51706cb..e2f93f621f811 100644 --- a/clients/client-securityhub/commands/ListInvitationsCommand.ts +++ b/clients/client-securityhub/commands/ListInvitationsCommand.ts @@ -20,6 +20,10 @@ import { export type ListInvitationsCommandInput = ListInvitationsRequest; export type ListInvitationsCommandOutput = ListInvitationsResponse & __MetadataBearer; +/** + *

Lists all Security Hub membership invitations that were sent to the current AWS account. + *

+ */ export class ListInvitationsCommand extends $Command< ListInvitationsCommandInput, ListInvitationsCommandOutput, @@ -34,6 +38,9 @@ export class ListInvitationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/ListMembersCommand.ts b/clients/client-securityhub/commands/ListMembersCommand.ts index d459229318617..3da9cdf81a75e 100644 --- a/clients/client-securityhub/commands/ListMembersCommand.ts +++ b/clients/client-securityhub/commands/ListMembersCommand.ts @@ -20,6 +20,10 @@ import { export type ListMembersCommandInput = ListMembersRequest; export type ListMembersCommandOutput = ListMembersResponse & __MetadataBearer; +/** + *

Lists details about all member accounts for the current Security Hub master + * account.

+ */ export class ListMembersCommand extends $Command< ListMembersCommandInput, ListMembersCommandOutput, @@ -34,6 +38,9 @@ export class ListMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/ListTagsForResourceCommand.ts b/clients/client-securityhub/commands/ListTagsForResourceCommand.ts index 5cfc24eff1414..e833793203acd 100644 --- a/clients/client-securityhub/commands/ListTagsForResourceCommand.ts +++ b/clients/client-securityhub/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns a list of tags associated with a resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/TagResourceCommand.ts b/clients/client-securityhub/commands/TagResourceCommand.ts index 0fe792e4afc65..b35f51f8eb809 100644 --- a/clients/client-securityhub/commands/TagResourceCommand.ts +++ b/clients/client-securityhub/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds one or more tags to a resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/UntagResourceCommand.ts b/clients/client-securityhub/commands/UntagResourceCommand.ts index 36452d85eceb0..293d2db07aa75 100644 --- a/clients/client-securityhub/commands/UntagResourceCommand.ts +++ b/clients/client-securityhub/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from a resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/UpdateActionTargetCommand.ts b/clients/client-securityhub/commands/UpdateActionTargetCommand.ts index f3d6c90329233..c2bcc68dcc0a2 100644 --- a/clients/client-securityhub/commands/UpdateActionTargetCommand.ts +++ b/clients/client-securityhub/commands/UpdateActionTargetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateActionTargetCommandInput = UpdateActionTargetRequest; export type UpdateActionTargetCommandOutput = UpdateActionTargetResponse & __MetadataBearer; +/** + *

Updates the name and description of a custom action target in Security Hub.

+ */ export class UpdateActionTargetCommand extends $Command< UpdateActionTargetCommandInput, UpdateActionTargetCommandOutput, @@ -34,6 +37,9 @@ export class UpdateActionTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/UpdateFindingsCommand.ts b/clients/client-securityhub/commands/UpdateFindingsCommand.ts index f6fd95dd0c86e..9a4e32e9d3f73 100644 --- a/clients/client-securityhub/commands/UpdateFindingsCommand.ts +++ b/clients/client-securityhub/commands/UpdateFindingsCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateFindingsCommandInput = UpdateFindingsRequest; export type UpdateFindingsCommandOutput = UpdateFindingsResponse & __MetadataBearer; +/** + *

+ * UpdateFindings is deprecated. Instead of UpdateFindings, use + * BatchUpdateFindings.

+ *

Updates the Note and RecordState of the Security Hub-aggregated + * findings that the filter attributes specify. Any member account that can view the finding + * also sees the update to the finding.

+ */ export class UpdateFindingsCommand extends $Command< UpdateFindingsCommandInput, UpdateFindingsCommandOutput, @@ -34,6 +42,9 @@ export class UpdateFindingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/UpdateInsightCommand.ts b/clients/client-securityhub/commands/UpdateInsightCommand.ts index aa19eae022a27..fc233beea4e3f 100644 --- a/clients/client-securityhub/commands/UpdateInsightCommand.ts +++ b/clients/client-securityhub/commands/UpdateInsightCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateInsightCommandInput = UpdateInsightRequest; export type UpdateInsightCommandOutput = UpdateInsightResponse & __MetadataBearer; +/** + *

Updates the Security Hub insight identified by the specified insight ARN.

+ */ export class UpdateInsightCommand extends $Command< UpdateInsightCommandInput, UpdateInsightCommandOutput, @@ -34,6 +37,9 @@ export class UpdateInsightCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/UpdateSecurityHubConfigurationCommand.ts b/clients/client-securityhub/commands/UpdateSecurityHubConfigurationCommand.ts index 3dbe4e7d011e7..b478f731b2b86 100644 --- a/clients/client-securityhub/commands/UpdateSecurityHubConfigurationCommand.ts +++ b/clients/client-securityhub/commands/UpdateSecurityHubConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSecurityHubConfigurationCommandInput = UpdateSecurityHubConfigurationRequest; export type UpdateSecurityHubConfigurationCommandOutput = UpdateSecurityHubConfigurationResponse & __MetadataBearer; +/** + *

Updates configuration options for Security Hub.

+ */ export class UpdateSecurityHubConfigurationCommand extends $Command< UpdateSecurityHubConfigurationCommandInput, UpdateSecurityHubConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSecurityHubConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/commands/UpdateStandardsControlCommand.ts b/clients/client-securityhub/commands/UpdateStandardsControlCommand.ts index 774ddd4e72158..3bba639a24014 100644 --- a/clients/client-securityhub/commands/UpdateStandardsControlCommand.ts +++ b/clients/client-securityhub/commands/UpdateStandardsControlCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateStandardsControlCommandInput = UpdateStandardsControlRequest; export type UpdateStandardsControlCommandOutput = UpdateStandardsControlResponse & __MetadataBearer; +/** + *

Used to control whether an individual security standard control is enabled or + * disabled.

+ */ export class UpdateStandardsControlCommand extends $Command< UpdateStandardsControlCommandInput, UpdateStandardsControlCommandOutput, @@ -34,6 +38,9 @@ export class UpdateStandardsControlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SecurityHubClientResolvedConfig, diff --git a/clients/client-securityhub/package.json b/clients/client-securityhub/package.json index f83bcfba2d510..33e4527f67db4 100644 --- a/clients/client-securityhub/package.json +++ b/clients/client-securityhub/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Securityhub Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-securityhub/pagination/DescribeActionTargetsPaginator.ts b/clients/client-securityhub/pagination/DescribeActionTargetsPaginator.ts index e629621a4c3dd..c3a429bd27bc2 100644 --- a/clients/client-securityhub/pagination/DescribeActionTargetsPaginator.ts +++ b/clients/client-securityhub/pagination/DescribeActionTargetsPaginator.ts @@ -8,6 +8,9 @@ import { import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: DescribeActionTargetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeActionTargetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: DescribeActionTargetsCommandInput, diff --git a/clients/client-securityhub/pagination/DescribeProductsPaginator.ts b/clients/client-securityhub/pagination/DescribeProductsPaginator.ts index 9ab588a1547f5..5a8416ee10585 100644 --- a/clients/client-securityhub/pagination/DescribeProductsPaginator.ts +++ b/clients/client-securityhub/pagination/DescribeProductsPaginator.ts @@ -8,6 +8,9 @@ import { import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: DescribeProductsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeProductsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: DescribeProductsCommandInput, diff --git a/clients/client-securityhub/pagination/DescribeStandardsControlsPaginator.ts b/clients/client-securityhub/pagination/DescribeStandardsControlsPaginator.ts index 52fed37961ac1..2ccd20a9349b1 100644 --- a/clients/client-securityhub/pagination/DescribeStandardsControlsPaginator.ts +++ b/clients/client-securityhub/pagination/DescribeStandardsControlsPaginator.ts @@ -8,6 +8,9 @@ import { import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: DescribeStandardsControlsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeStandardsControlsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: DescribeStandardsControlsCommandInput, diff --git a/clients/client-securityhub/pagination/DescribeStandardsPaginator.ts b/clients/client-securityhub/pagination/DescribeStandardsPaginator.ts index 7b8efcd416c7f..d2487d5ec869f 100644 --- a/clients/client-securityhub/pagination/DescribeStandardsPaginator.ts +++ b/clients/client-securityhub/pagination/DescribeStandardsPaginator.ts @@ -8,6 +8,9 @@ import { import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: DescribeStandardsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeStandardsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: DescribeStandardsCommandInput, diff --git a/clients/client-securityhub/pagination/GetEnabledStandardsPaginator.ts b/clients/client-securityhub/pagination/GetEnabledStandardsPaginator.ts index 2f5098a84701a..ff5618965d417 100644 --- a/clients/client-securityhub/pagination/GetEnabledStandardsPaginator.ts +++ b/clients/client-securityhub/pagination/GetEnabledStandardsPaginator.ts @@ -8,6 +8,9 @@ import { import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: GetEnabledStandardsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetEnabledStandardsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: GetEnabledStandardsCommandInput, diff --git a/clients/client-securityhub/pagination/GetFindingsPaginator.ts b/clients/client-securityhub/pagination/GetFindingsPaginator.ts index f6327a1989b8e..a3395321681b6 100644 --- a/clients/client-securityhub/pagination/GetFindingsPaginator.ts +++ b/clients/client-securityhub/pagination/GetFindingsPaginator.ts @@ -4,6 +4,9 @@ import { GetFindingsCommand, GetFindingsCommandInput, GetFindingsCommandOutput } import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: GetFindingsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetFindingsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: GetFindingsCommandInput, diff --git a/clients/client-securityhub/pagination/GetInsightsPaginator.ts b/clients/client-securityhub/pagination/GetInsightsPaginator.ts index 7a8852abf1630..6ffc177300ca9 100644 --- a/clients/client-securityhub/pagination/GetInsightsPaginator.ts +++ b/clients/client-securityhub/pagination/GetInsightsPaginator.ts @@ -4,6 +4,9 @@ import { GetInsightsCommand, GetInsightsCommandInput, GetInsightsCommandOutput } import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: GetInsightsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetInsightsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: GetInsightsCommandInput, diff --git a/clients/client-securityhub/pagination/ListEnabledProductsForImportPaginator.ts b/clients/client-securityhub/pagination/ListEnabledProductsForImportPaginator.ts index 24756409a7983..b38b57c216e30 100644 --- a/clients/client-securityhub/pagination/ListEnabledProductsForImportPaginator.ts +++ b/clients/client-securityhub/pagination/ListEnabledProductsForImportPaginator.ts @@ -8,6 +8,9 @@ import { import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: ListEnabledProductsForImportCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEnabledProductsForImportCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: ListEnabledProductsForImportCommandInput, diff --git a/clients/client-securityhub/pagination/ListInvitationsPaginator.ts b/clients/client-securityhub/pagination/ListInvitationsPaginator.ts index a05ab2607ab4d..cde6a69b00433 100644 --- a/clients/client-securityhub/pagination/ListInvitationsPaginator.ts +++ b/clients/client-securityhub/pagination/ListInvitationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: ListInvitationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInvitationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: ListInvitationsCommandInput, diff --git a/clients/client-securityhub/pagination/ListMembersPaginator.ts b/clients/client-securityhub/pagination/ListMembersPaginator.ts index d958f54b20f55..e05b725a1d87c 100644 --- a/clients/client-securityhub/pagination/ListMembersPaginator.ts +++ b/clients/client-securityhub/pagination/ListMembersPaginator.ts @@ -4,6 +4,9 @@ import { ListMembersCommand, ListMembersCommandInput, ListMembersCommandOutput } import { SecurityHubPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SecurityHubClient, input: ListMembersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMembersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SecurityHub, input: ListMembersCommandInput, diff --git a/clients/client-securityhub/runtimeConfig.browser.ts b/clients/client-securityhub/runtimeConfig.browser.ts index 47f5765cda4cd..dfddc4902541f 100644 --- a/clients/client-securityhub/runtimeConfig.browser.ts +++ b/clients/client-securityhub/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SecurityHubClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-securityhub/runtimeConfig.native.ts b/clients/client-securityhub/runtimeConfig.native.ts index 77126a91a7ed0..3521fd7b35c73 100644 --- a/clients/client-securityhub/runtimeConfig.native.ts +++ b/clients/client-securityhub/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SecurityHubClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-securityhub/runtimeConfig.shared.ts b/clients/client-securityhub/runtimeConfig.shared.ts index 94770aa02f4a9..43d746254bcfd 100644 --- a/clients/client-securityhub/runtimeConfig.shared.ts +++ b/clients/client-securityhub/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-10-26", disableHostPrefix: false, diff --git a/clients/client-securityhub/runtimeConfig.ts b/clients/client-securityhub/runtimeConfig.ts index bba7d4583c6d6..ae21fc35654d0 100644 --- a/clients/client-securityhub/runtimeConfig.ts +++ b/clients/client-securityhub/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SecurityHubClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-securityhub/tsconfig.json b/clients/client-securityhub/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-securityhub/tsconfig.json +++ b/clients/client-securityhub/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-serverlessapplicationrepository/commands/CreateApplicationCommand.ts b/clients/client-serverlessapplicationrepository/commands/CreateApplicationCommand.ts index 7c50a4e65c30c..8be18705b1689 100644 --- a/clients/client-serverlessapplicationrepository/commands/CreateApplicationCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/CreateApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type CreateApplicationCommandInput = CreateApplicationRequest; export type CreateApplicationCommandOutput = CreateApplicationResponse & __MetadataBearer; +/** + *

Creates an application, optionally including an AWS SAM file to create the first application version in the same call.

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -38,6 +41,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/CreateApplicationVersionCommand.ts b/clients/client-serverlessapplicationrepository/commands/CreateApplicationVersionCommand.ts index 3cb4b0c05daae..070db6ae4c13a 100644 --- a/clients/client-serverlessapplicationrepository/commands/CreateApplicationVersionCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/CreateApplicationVersionCommand.ts @@ -24,6 +24,9 @@ import { export type CreateApplicationVersionCommandInput = CreateApplicationVersionRequest; export type CreateApplicationVersionCommandOutput = CreateApplicationVersionResponse & __MetadataBearer; +/** + *

Creates an application version.

+ */ export class CreateApplicationVersionCommand extends $Command< CreateApplicationVersionCommandInput, CreateApplicationVersionCommandOutput, @@ -38,6 +41,9 @@ export class CreateApplicationVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/CreateCloudFormationChangeSetCommand.ts b/clients/client-serverlessapplicationrepository/commands/CreateCloudFormationChangeSetCommand.ts index 68baefbb2a13d..24f64d999af75 100644 --- a/clients/client-serverlessapplicationrepository/commands/CreateCloudFormationChangeSetCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/CreateCloudFormationChangeSetCommand.ts @@ -24,6 +24,9 @@ import { export type CreateCloudFormationChangeSetCommandInput = CreateCloudFormationChangeSetRequest; export type CreateCloudFormationChangeSetCommandOutput = CreateCloudFormationChangeSetResponse & __MetadataBearer; +/** + *

Creates an AWS CloudFormation change set for the given application.

+ */ export class CreateCloudFormationChangeSetCommand extends $Command< CreateCloudFormationChangeSetCommandInput, CreateCloudFormationChangeSetCommandOutput, @@ -38,6 +41,9 @@ export class CreateCloudFormationChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/CreateCloudFormationTemplateCommand.ts b/clients/client-serverlessapplicationrepository/commands/CreateCloudFormationTemplateCommand.ts index b4ad55e020c38..24534e25d65da 100644 --- a/clients/client-serverlessapplicationrepository/commands/CreateCloudFormationTemplateCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/CreateCloudFormationTemplateCommand.ts @@ -24,6 +24,9 @@ import { export type CreateCloudFormationTemplateCommandInput = CreateCloudFormationTemplateRequest; export type CreateCloudFormationTemplateCommandOutput = CreateCloudFormationTemplateResponse & __MetadataBearer; +/** + *

Creates an AWS CloudFormation template.

+ */ export class CreateCloudFormationTemplateCommand extends $Command< CreateCloudFormationTemplateCommandInput, CreateCloudFormationTemplateCommandOutput, @@ -38,6 +41,9 @@ export class CreateCloudFormationTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/DeleteApplicationCommand.ts b/clients/client-serverlessapplicationrepository/commands/DeleteApplicationCommand.ts index fc5a9ad119e84..5f31d29fbf90c 100644 --- a/clients/client-serverlessapplicationrepository/commands/DeleteApplicationCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/DeleteApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteApplicationCommandInput = DeleteApplicationRequest; export type DeleteApplicationCommandOutput = __MetadataBearer; +/** + *

Deletes the specified application.

+ */ export class DeleteApplicationCommand extends $Command< DeleteApplicationCommandInput, DeleteApplicationCommandOutput, @@ -38,6 +41,9 @@ export class DeleteApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/GetApplicationCommand.ts b/clients/client-serverlessapplicationrepository/commands/GetApplicationCommand.ts index 216f80f527100..3b4cfc8dcbbdc 100644 --- a/clients/client-serverlessapplicationrepository/commands/GetApplicationCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/GetApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type GetApplicationCommandInput = GetApplicationRequest; export type GetApplicationCommandOutput = GetApplicationResponse & __MetadataBearer; +/** + *

Gets the specified application.

+ */ export class GetApplicationCommand extends $Command< GetApplicationCommandInput, GetApplicationCommandOutput, @@ -38,6 +41,9 @@ export class GetApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/GetApplicationPolicyCommand.ts b/clients/client-serverlessapplicationrepository/commands/GetApplicationPolicyCommand.ts index bb2855956ec9c..0a71fe5923d33 100644 --- a/clients/client-serverlessapplicationrepository/commands/GetApplicationPolicyCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/GetApplicationPolicyCommand.ts @@ -24,6 +24,9 @@ import { export type GetApplicationPolicyCommandInput = GetApplicationPolicyRequest; export type GetApplicationPolicyCommandOutput = GetApplicationPolicyResponse & __MetadataBearer; +/** + *

Retrieves the policy for the application.

+ */ export class GetApplicationPolicyCommand extends $Command< GetApplicationPolicyCommandInput, GetApplicationPolicyCommandOutput, @@ -38,6 +41,9 @@ export class GetApplicationPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/GetCloudFormationTemplateCommand.ts b/clients/client-serverlessapplicationrepository/commands/GetCloudFormationTemplateCommand.ts index e00a77a296731..6b71029e19a45 100644 --- a/clients/client-serverlessapplicationrepository/commands/GetCloudFormationTemplateCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/GetCloudFormationTemplateCommand.ts @@ -24,6 +24,9 @@ import { export type GetCloudFormationTemplateCommandInput = GetCloudFormationTemplateRequest; export type GetCloudFormationTemplateCommandOutput = GetCloudFormationTemplateResponse & __MetadataBearer; +/** + *

Gets the specified AWS CloudFormation template.

+ */ export class GetCloudFormationTemplateCommand extends $Command< GetCloudFormationTemplateCommandInput, GetCloudFormationTemplateCommandOutput, @@ -38,6 +41,9 @@ export class GetCloudFormationTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/ListApplicationDependenciesCommand.ts b/clients/client-serverlessapplicationrepository/commands/ListApplicationDependenciesCommand.ts index 10bd1ddc85e8e..48b0f1ffdb2bc 100644 --- a/clients/client-serverlessapplicationrepository/commands/ListApplicationDependenciesCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/ListApplicationDependenciesCommand.ts @@ -24,6 +24,9 @@ import { export type ListApplicationDependenciesCommandInput = ListApplicationDependenciesRequest; export type ListApplicationDependenciesCommandOutput = ListApplicationDependenciesResponse & __MetadataBearer; +/** + *

Retrieves the list of applications nested in the containing application.

+ */ export class ListApplicationDependenciesCommand extends $Command< ListApplicationDependenciesCommandInput, ListApplicationDependenciesCommandOutput, @@ -38,6 +41,9 @@ export class ListApplicationDependenciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/ListApplicationVersionsCommand.ts b/clients/client-serverlessapplicationrepository/commands/ListApplicationVersionsCommand.ts index 5bb1a2b497bd1..22ad792ed300c 100644 --- a/clients/client-serverlessapplicationrepository/commands/ListApplicationVersionsCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/ListApplicationVersionsCommand.ts @@ -24,6 +24,9 @@ import { export type ListApplicationVersionsCommandInput = ListApplicationVersionsRequest; export type ListApplicationVersionsCommandOutput = ListApplicationVersionsResponse & __MetadataBearer; +/** + *

Lists versions for the specified application.

+ */ export class ListApplicationVersionsCommand extends $Command< ListApplicationVersionsCommandInput, ListApplicationVersionsCommandOutput, @@ -38,6 +41,9 @@ export class ListApplicationVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/ListApplicationsCommand.ts b/clients/client-serverlessapplicationrepository/commands/ListApplicationsCommand.ts index ad56a21b0f161..cd3e62fe754fb 100644 --- a/clients/client-serverlessapplicationrepository/commands/ListApplicationsCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/ListApplicationsCommand.ts @@ -24,6 +24,9 @@ import { export type ListApplicationsCommandInput = ListApplicationsRequest; export type ListApplicationsCommandOutput = ListApplicationsResponse & __MetadataBearer; +/** + *

Lists applications owned by the requester.

+ */ export class ListApplicationsCommand extends $Command< ListApplicationsCommandInput, ListApplicationsCommandOutput, @@ -38,6 +41,9 @@ export class ListApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/PutApplicationPolicyCommand.ts b/clients/client-serverlessapplicationrepository/commands/PutApplicationPolicyCommand.ts index c98e4d8a85588..2dcfbba9ce4a3 100644 --- a/clients/client-serverlessapplicationrepository/commands/PutApplicationPolicyCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/PutApplicationPolicyCommand.ts @@ -24,6 +24,12 @@ import { export type PutApplicationPolicyCommandInput = PutApplicationPolicyRequest; export type PutApplicationPolicyCommandOutput = PutApplicationPolicyResponse & __MetadataBearer; +/** + *

Sets the permission policy for an application. For the list of actions supported for this operation, see + * Application + * Permissions + * .

+ */ export class PutApplicationPolicyCommand extends $Command< PutApplicationPolicyCommandInput, PutApplicationPolicyCommandOutput, @@ -38,6 +44,9 @@ export class PutApplicationPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/UnshareApplicationCommand.ts b/clients/client-serverlessapplicationrepository/commands/UnshareApplicationCommand.ts index d782e8836abc1..545080461e2f0 100644 --- a/clients/client-serverlessapplicationrepository/commands/UnshareApplicationCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/UnshareApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type UnshareApplicationCommandInput = UnshareApplicationRequest; export type UnshareApplicationCommandOutput = __MetadataBearer; +/** + *

Unshares an application from an AWS Organization.

This operation can be called only from the organization's master account.

+ */ export class UnshareApplicationCommand extends $Command< UnshareApplicationCommandInput, UnshareApplicationCommandOutput, @@ -38,6 +41,9 @@ export class UnshareApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/commands/UpdateApplicationCommand.ts b/clients/client-serverlessapplicationrepository/commands/UpdateApplicationCommand.ts index 440db532d43af..a89ad3219fd65 100644 --- a/clients/client-serverlessapplicationrepository/commands/UpdateApplicationCommand.ts +++ b/clients/client-serverlessapplicationrepository/commands/UpdateApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationRequest; export type UpdateApplicationCommandOutput = UpdateApplicationResponse & __MetadataBearer; +/** + *

Updates the specified application.

+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -38,6 +41,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServerlessApplicationRepositoryClientResolvedConfig, diff --git a/clients/client-serverlessapplicationrepository/package.json b/clients/client-serverlessapplicationrepository/package.json index 17a511b13d7a9..0e475774504cf 100644 --- a/clients/client-serverlessapplicationrepository/package.json +++ b/clients/client-serverlessapplicationrepository/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Serverlessapplicationrepository Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-serverlessapplicationrepository/pagination/ListApplicationDependenciesPaginator.ts b/clients/client-serverlessapplicationrepository/pagination/ListApplicationDependenciesPaginator.ts index 0d70bcd22eb18..4128f3054ecd6 100644 --- a/clients/client-serverlessapplicationrepository/pagination/ListApplicationDependenciesPaginator.ts +++ b/clients/client-serverlessapplicationrepository/pagination/ListApplicationDependenciesPaginator.ts @@ -8,6 +8,9 @@ import { import { ServerlessApplicationRepositoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServerlessApplicationRepositoryClient, input: ListApplicationDependenciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationDependenciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServerlessApplicationRepository, input: ListApplicationDependenciesCommandInput, diff --git a/clients/client-serverlessapplicationrepository/pagination/ListApplicationVersionsPaginator.ts b/clients/client-serverlessapplicationrepository/pagination/ListApplicationVersionsPaginator.ts index 6868b9517b10c..955b174dc2d99 100644 --- a/clients/client-serverlessapplicationrepository/pagination/ListApplicationVersionsPaginator.ts +++ b/clients/client-serverlessapplicationrepository/pagination/ListApplicationVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServerlessApplicationRepositoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServerlessApplicationRepositoryClient, input: ListApplicationVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServerlessApplicationRepository, input: ListApplicationVersionsCommandInput, diff --git a/clients/client-serverlessapplicationrepository/pagination/ListApplicationsPaginator.ts b/clients/client-serverlessapplicationrepository/pagination/ListApplicationsPaginator.ts index 7bf289f36c565..f367f5f008015 100644 --- a/clients/client-serverlessapplicationrepository/pagination/ListApplicationsPaginator.ts +++ b/clients/client-serverlessapplicationrepository/pagination/ListApplicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServerlessApplicationRepositoryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServerlessApplicationRepositoryClient, input: ListApplicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServerlessApplicationRepository, input: ListApplicationsCommandInput, diff --git a/clients/client-serverlessapplicationrepository/runtimeConfig.browser.ts b/clients/client-serverlessapplicationrepository/runtimeConfig.browser.ts index 9ead8cabd5577..bc00c2e884e7b 100644 --- a/clients/client-serverlessapplicationrepository/runtimeConfig.browser.ts +++ b/clients/client-serverlessapplicationrepository/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ServerlessApplicationRepositoryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-serverlessapplicationrepository/runtimeConfig.native.ts b/clients/client-serverlessapplicationrepository/runtimeConfig.native.ts index 5c5cd5730d440..cf2754a217ee9 100644 --- a/clients/client-serverlessapplicationrepository/runtimeConfig.native.ts +++ b/clients/client-serverlessapplicationrepository/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ServerlessApplicationRepositoryClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-serverlessapplicationrepository/runtimeConfig.shared.ts b/clients/client-serverlessapplicationrepository/runtimeConfig.shared.ts index c955a513c269c..9a8357e178747 100644 --- a/clients/client-serverlessapplicationrepository/runtimeConfig.shared.ts +++ b/clients/client-serverlessapplicationrepository/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-09-08", disableHostPrefix: false, diff --git a/clients/client-serverlessapplicationrepository/runtimeConfig.ts b/clients/client-serverlessapplicationrepository/runtimeConfig.ts index 6fc4d311d4028..ca18348b4e876 100644 --- a/clients/client-serverlessapplicationrepository/runtimeConfig.ts +++ b/clients/client-serverlessapplicationrepository/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ServerlessApplicationRepositoryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-serverlessapplicationrepository/tsconfig.json b/clients/client-serverlessapplicationrepository/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-serverlessapplicationrepository/tsconfig.json +++ b/clients/client-serverlessapplicationrepository/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-service-catalog-appregistry/commands/AssociateAttributeGroupCommand.ts b/clients/client-service-catalog-appregistry/commands/AssociateAttributeGroupCommand.ts index 1b13b955979a7..620a6d4e7c1f2 100644 --- a/clients/client-service-catalog-appregistry/commands/AssociateAttributeGroupCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/AssociateAttributeGroupCommand.ts @@ -24,6 +24,9 @@ import { export type AssociateAttributeGroupCommandInput = AssociateAttributeGroupRequest; export type AssociateAttributeGroupCommandOutput = AssociateAttributeGroupResponse & __MetadataBearer; +/** + *

Associates an attribute group with an application to augment the application's metadata with the group's attributes. This way applications can be described with user-defined details which are machine-readable (e.g. for third-party integrations).

+ */ export class AssociateAttributeGroupCommand extends $Command< AssociateAttributeGroupCommandInput, AssociateAttributeGroupCommandOutput, @@ -38,6 +41,9 @@ export class AssociateAttributeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/AssociateResourceCommand.ts b/clients/client-service-catalog-appregistry/commands/AssociateResourceCommand.ts index 9988d60cd7707..fc22a996998de 100644 --- a/clients/client-service-catalog-appregistry/commands/AssociateResourceCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/AssociateResourceCommand.ts @@ -24,6 +24,9 @@ import { export type AssociateResourceCommandInput = AssociateResourceRequest; export type AssociateResourceCommandOutput = AssociateResourceResponse & __MetadataBearer; +/** + *

Associates a resource with an application. Both the resource and the application can be specified either by ID or name.

+ */ export class AssociateResourceCommand extends $Command< AssociateResourceCommandInput, AssociateResourceCommandOutput, @@ -38,6 +41,9 @@ export class AssociateResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/CreateApplicationCommand.ts b/clients/client-service-catalog-appregistry/commands/CreateApplicationCommand.ts index 69f37d676b958..dd6ea931ff83f 100644 --- a/clients/client-service-catalog-appregistry/commands/CreateApplicationCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/CreateApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type CreateApplicationCommandInput = CreateApplicationRequest; export type CreateApplicationCommandOutput = CreateApplicationResponse & __MetadataBearer; +/** + *

Creates a new application that is the top-level node in a hierarchy of related cloud resource abstractions.

+ */ export class CreateApplicationCommand extends $Command< CreateApplicationCommandInput, CreateApplicationCommandOutput, @@ -38,6 +41,9 @@ export class CreateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/CreateAttributeGroupCommand.ts b/clients/client-service-catalog-appregistry/commands/CreateAttributeGroupCommand.ts index 58e495d57d6db..1993ffe91c3d7 100644 --- a/clients/client-service-catalog-appregistry/commands/CreateAttributeGroupCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/CreateAttributeGroupCommand.ts @@ -24,6 +24,9 @@ import { export type CreateAttributeGroupCommandInput = CreateAttributeGroupRequest; export type CreateAttributeGroupCommandOutput = CreateAttributeGroupResponse & __MetadataBearer; +/** + *

Creates a new attribute group as a container for user-defined attributes. This approach enables users to have full control over their cloud application's metadata in a rich machine-readable format to facilitate integration with automated workflows and third-party tools.

+ */ export class CreateAttributeGroupCommand extends $Command< CreateAttributeGroupCommandInput, CreateAttributeGroupCommandOutput, @@ -38,6 +41,9 @@ export class CreateAttributeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/DeleteApplicationCommand.ts b/clients/client-service-catalog-appregistry/commands/DeleteApplicationCommand.ts index fefcb729338fa..481236fbfb83c 100644 --- a/clients/client-service-catalog-appregistry/commands/DeleteApplicationCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/DeleteApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteApplicationCommandInput = DeleteApplicationRequest; export type DeleteApplicationCommandOutput = DeleteApplicationResponse & __MetadataBearer; +/** + *

Delete an application, specified either by its application ID or name.

+ */ export class DeleteApplicationCommand extends $Command< DeleteApplicationCommandInput, DeleteApplicationCommandOutput, @@ -38,6 +41,9 @@ export class DeleteApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/DeleteAttributeGroupCommand.ts b/clients/client-service-catalog-appregistry/commands/DeleteAttributeGroupCommand.ts index bd87f68303309..a301c04eb3b62 100644 --- a/clients/client-service-catalog-appregistry/commands/DeleteAttributeGroupCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/DeleteAttributeGroupCommand.ts @@ -24,6 +24,9 @@ import { export type DeleteAttributeGroupCommandInput = DeleteAttributeGroupRequest; export type DeleteAttributeGroupCommandOutput = DeleteAttributeGroupResponse & __MetadataBearer; +/** + *

Deletes an attribute group, specified either by its attribute group ID or name.

+ */ export class DeleteAttributeGroupCommand extends $Command< DeleteAttributeGroupCommandInput, DeleteAttributeGroupCommandOutput, @@ -38,6 +41,9 @@ export class DeleteAttributeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/DisassociateAttributeGroupCommand.ts b/clients/client-service-catalog-appregistry/commands/DisassociateAttributeGroupCommand.ts index eed0d8af15211..ba92b086e99ac 100644 --- a/clients/client-service-catalog-appregistry/commands/DisassociateAttributeGroupCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/DisassociateAttributeGroupCommand.ts @@ -24,6 +24,9 @@ import { export type DisassociateAttributeGroupCommandInput = DisassociateAttributeGroupRequest; export type DisassociateAttributeGroupCommandOutput = DisassociateAttributeGroupResponse & __MetadataBearer; +/** + *

Disassociates an attribute group from an application to remove the extra attributes contained in the attribute group from the application's metadata. This operation reverts AssociateAttributeGroup.

+ */ export class DisassociateAttributeGroupCommand extends $Command< DisassociateAttributeGroupCommandInput, DisassociateAttributeGroupCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateAttributeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/DisassociateResourceCommand.ts b/clients/client-service-catalog-appregistry/commands/DisassociateResourceCommand.ts index cef7257e2b6e4..7f65af80fa4f7 100644 --- a/clients/client-service-catalog-appregistry/commands/DisassociateResourceCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/DisassociateResourceCommand.ts @@ -24,6 +24,9 @@ import { export type DisassociateResourceCommandInput = DisassociateResourceRequest; export type DisassociateResourceCommandOutput = DisassociateResourceResponse & __MetadataBearer; +/** + *

Disassociates a resource from application. Both the resource and the application can be specified either by ID or name.

+ */ export class DisassociateResourceCommand extends $Command< DisassociateResourceCommandInput, DisassociateResourceCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/GetApplicationCommand.ts b/clients/client-service-catalog-appregistry/commands/GetApplicationCommand.ts index 59506211df113..4ff097b0fe3c5 100644 --- a/clients/client-service-catalog-appregistry/commands/GetApplicationCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/GetApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type GetApplicationCommandInput = GetApplicationRequest; export type GetApplicationCommandOutput = GetApplicationResponse & __MetadataBearer; +/** + *

Retrieves metadata information about one of your applications. The application can be specified either by its unique ID or by its name (which is unique within one account in one region at a given point in time). Specify by ID in automated workflows if you want to make sure that the exact same application is returned or a ResourceNotFoundException is thrown, avoiding the ABA addressing problem.

+ */ export class GetApplicationCommand extends $Command< GetApplicationCommandInput, GetApplicationCommandOutput, @@ -38,6 +41,9 @@ export class GetApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/GetAttributeGroupCommand.ts b/clients/client-service-catalog-appregistry/commands/GetAttributeGroupCommand.ts index df8c6f1924bce..3c2960e8ce5c6 100644 --- a/clients/client-service-catalog-appregistry/commands/GetAttributeGroupCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/GetAttributeGroupCommand.ts @@ -24,6 +24,9 @@ import { export type GetAttributeGroupCommandInput = GetAttributeGroupRequest; export type GetAttributeGroupCommandOutput = GetAttributeGroupResponse & __MetadataBearer; +/** + *

Retrieves an attribute group, either by its name or its ID.

+ */ export class GetAttributeGroupCommand extends $Command< GetAttributeGroupCommandInput, GetAttributeGroupCommandOutput, @@ -38,6 +41,9 @@ export class GetAttributeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/ListApplicationsCommand.ts b/clients/client-service-catalog-appregistry/commands/ListApplicationsCommand.ts index ccda2bae63250..944026376bf3e 100644 --- a/clients/client-service-catalog-appregistry/commands/ListApplicationsCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/ListApplicationsCommand.ts @@ -24,6 +24,9 @@ import { export type ListApplicationsCommandInput = ListApplicationsRequest; export type ListApplicationsCommandOutput = ListApplicationsResponse & __MetadataBearer; +/** + *

Retrieves a list of all of your applications. Results are paginated.

+ */ export class ListApplicationsCommand extends $Command< ListApplicationsCommandInput, ListApplicationsCommandOutput, @@ -38,6 +41,9 @@ export class ListApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/ListAssociatedAttributeGroupsCommand.ts b/clients/client-service-catalog-appregistry/commands/ListAssociatedAttributeGroupsCommand.ts index f4203ec729b7b..3c842db635a2e 100644 --- a/clients/client-service-catalog-appregistry/commands/ListAssociatedAttributeGroupsCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/ListAssociatedAttributeGroupsCommand.ts @@ -24,6 +24,9 @@ import { export type ListAssociatedAttributeGroupsCommandInput = ListAssociatedAttributeGroupsRequest; export type ListAssociatedAttributeGroupsCommandOutput = ListAssociatedAttributeGroupsResponse & __MetadataBearer; +/** + *

Lists all attribute groups that are associated with specified application. Results are paginated.

+ */ export class ListAssociatedAttributeGroupsCommand extends $Command< ListAssociatedAttributeGroupsCommandInput, ListAssociatedAttributeGroupsCommandOutput, @@ -38,6 +41,9 @@ export class ListAssociatedAttributeGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/ListAssociatedResourcesCommand.ts b/clients/client-service-catalog-appregistry/commands/ListAssociatedResourcesCommand.ts index 8ba1c433705d2..8054f9ce96d8c 100644 --- a/clients/client-service-catalog-appregistry/commands/ListAssociatedResourcesCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/ListAssociatedResourcesCommand.ts @@ -24,6 +24,9 @@ import { export type ListAssociatedResourcesCommandInput = ListAssociatedResourcesRequest; export type ListAssociatedResourcesCommandOutput = ListAssociatedResourcesResponse & __MetadataBearer; +/** + *

Lists all resources that are associated with specified application. Results are paginated.

+ */ export class ListAssociatedResourcesCommand extends $Command< ListAssociatedResourcesCommandInput, ListAssociatedResourcesCommandOutput, @@ -38,6 +41,9 @@ export class ListAssociatedResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/ListAttributeGroupsCommand.ts b/clients/client-service-catalog-appregistry/commands/ListAttributeGroupsCommand.ts index 82051ef3d356a..5bb2cb7aad1e8 100644 --- a/clients/client-service-catalog-appregistry/commands/ListAttributeGroupsCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/ListAttributeGroupsCommand.ts @@ -24,6 +24,9 @@ import { export type ListAttributeGroupsCommandInput = ListAttributeGroupsRequest; export type ListAttributeGroupsCommandOutput = ListAttributeGroupsResponse & __MetadataBearer; +/** + *

Lists all attribute groups which you have access to. Results are paginated.

+ */ export class ListAttributeGroupsCommand extends $Command< ListAttributeGroupsCommandInput, ListAttributeGroupsCommandOutput, @@ -38,6 +41,9 @@ export class ListAttributeGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/UpdateApplicationCommand.ts b/clients/client-service-catalog-appregistry/commands/UpdateApplicationCommand.ts index ccbb27f54d07d..152b48e99be08 100644 --- a/clients/client-service-catalog-appregistry/commands/UpdateApplicationCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/UpdateApplicationCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateApplicationCommandInput = UpdateApplicationRequest; export type UpdateApplicationCommandOutput = UpdateApplicationResponse & __MetadataBearer; +/** + *

Updates an existing application with new attributes.

+ */ export class UpdateApplicationCommand extends $Command< UpdateApplicationCommandInput, UpdateApplicationCommandOutput, @@ -38,6 +41,9 @@ export class UpdateApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/commands/UpdateAttributeGroupCommand.ts b/clients/client-service-catalog-appregistry/commands/UpdateAttributeGroupCommand.ts index 4b40dab4b006a..90a751239d5ee 100644 --- a/clients/client-service-catalog-appregistry/commands/UpdateAttributeGroupCommand.ts +++ b/clients/client-service-catalog-appregistry/commands/UpdateAttributeGroupCommand.ts @@ -24,6 +24,9 @@ import { export type UpdateAttributeGroupCommandInput = UpdateAttributeGroupRequest; export type UpdateAttributeGroupCommandOutput = UpdateAttributeGroupResponse & __MetadataBearer; +/** + *

Updates an existing attribute group with new details.

+ */ export class UpdateAttributeGroupCommand extends $Command< UpdateAttributeGroupCommandInput, UpdateAttributeGroupCommandOutput, @@ -38,6 +41,9 @@ export class UpdateAttributeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogAppRegistryClientResolvedConfig, diff --git a/clients/client-service-catalog-appregistry/package.json b/clients/client-service-catalog-appregistry/package.json index ef9a2f6bca24c..048d747a2f65d 100644 --- a/clients/client-service-catalog-appregistry/package.json +++ b/clients/client-service-catalog-appregistry/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Service Catalog Appregistry Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-service-catalog-appregistry/pagination/ListApplicationsPaginator.ts b/clients/client-service-catalog-appregistry/pagination/ListApplicationsPaginator.ts index 958f05d9bcb59..b6b1c1b9c57b6 100644 --- a/clients/client-service-catalog-appregistry/pagination/ListApplicationsPaginator.ts +++ b/clients/client-service-catalog-appregistry/pagination/ListApplicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogAppRegistryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogAppRegistryClient, input: ListApplicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListApplicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalogAppRegistry, input: ListApplicationsCommandInput, diff --git a/clients/client-service-catalog-appregistry/pagination/ListAssociatedAttributeGroupsPaginator.ts b/clients/client-service-catalog-appregistry/pagination/ListAssociatedAttributeGroupsPaginator.ts index 92398b3aeb1f3..38b867ffb2852 100644 --- a/clients/client-service-catalog-appregistry/pagination/ListAssociatedAttributeGroupsPaginator.ts +++ b/clients/client-service-catalog-appregistry/pagination/ListAssociatedAttributeGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogAppRegistryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogAppRegistryClient, input: ListAssociatedAttributeGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssociatedAttributeGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalogAppRegistry, input: ListAssociatedAttributeGroupsCommandInput, diff --git a/clients/client-service-catalog-appregistry/pagination/ListAssociatedResourcesPaginator.ts b/clients/client-service-catalog-appregistry/pagination/ListAssociatedResourcesPaginator.ts index e215d7ae971fd..544763ad255f8 100644 --- a/clients/client-service-catalog-appregistry/pagination/ListAssociatedResourcesPaginator.ts +++ b/clients/client-service-catalog-appregistry/pagination/ListAssociatedResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogAppRegistryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogAppRegistryClient, input: ListAssociatedResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssociatedResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalogAppRegistry, input: ListAssociatedResourcesCommandInput, diff --git a/clients/client-service-catalog-appregistry/pagination/ListAttributeGroupsPaginator.ts b/clients/client-service-catalog-appregistry/pagination/ListAttributeGroupsPaginator.ts index 4090029d882a6..8fb900d22157f 100644 --- a/clients/client-service-catalog-appregistry/pagination/ListAttributeGroupsPaginator.ts +++ b/clients/client-service-catalog-appregistry/pagination/ListAttributeGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogAppRegistryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogAppRegistryClient, input: ListAttributeGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttributeGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalogAppRegistry, input: ListAttributeGroupsCommandInput, diff --git a/clients/client-service-catalog-appregistry/runtimeConfig.browser.ts b/clients/client-service-catalog-appregistry/runtimeConfig.browser.ts index b7fa43d9b4051..f319628115533 100644 --- a/clients/client-service-catalog-appregistry/runtimeConfig.browser.ts +++ b/clients/client-service-catalog-appregistry/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ServiceCatalogAppRegistryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-service-catalog-appregistry/runtimeConfig.native.ts b/clients/client-service-catalog-appregistry/runtimeConfig.native.ts index 3450d900c5a05..ee600010499f3 100644 --- a/clients/client-service-catalog-appregistry/runtimeConfig.native.ts +++ b/clients/client-service-catalog-appregistry/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ServiceCatalogAppRegistryClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-service-catalog-appregistry/runtimeConfig.shared.ts b/clients/client-service-catalog-appregistry/runtimeConfig.shared.ts index 5b8ee8cc46e53..e157efe58b752 100644 --- a/clients/client-service-catalog-appregistry/runtimeConfig.shared.ts +++ b/clients/client-service-catalog-appregistry/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-06-24", disableHostPrefix: false, diff --git a/clients/client-service-catalog-appregistry/runtimeConfig.ts b/clients/client-service-catalog-appregistry/runtimeConfig.ts index eb621700c4f40..78c8f1cd32c71 100644 --- a/clients/client-service-catalog-appregistry/runtimeConfig.ts +++ b/clients/client-service-catalog-appregistry/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ServiceCatalogAppRegistryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-service-catalog-appregistry/tsconfig.json b/clients/client-service-catalog-appregistry/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-service-catalog-appregistry/tsconfig.json +++ b/clients/client-service-catalog-appregistry/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-service-catalog/commands/AcceptPortfolioShareCommand.ts b/clients/client-service-catalog/commands/AcceptPortfolioShareCommand.ts index ce09809964a3c..12b21ddaa9cb4 100644 --- a/clients/client-service-catalog/commands/AcceptPortfolioShareCommand.ts +++ b/clients/client-service-catalog/commands/AcceptPortfolioShareCommand.ts @@ -20,6 +20,9 @@ import { export type AcceptPortfolioShareCommandInput = AcceptPortfolioShareInput; export type AcceptPortfolioShareCommandOutput = AcceptPortfolioShareOutput & __MetadataBearer; +/** + *

Accepts an offer to share the specified portfolio.

+ */ export class AcceptPortfolioShareCommand extends $Command< AcceptPortfolioShareCommandInput, AcceptPortfolioShareCommandOutput, @@ -34,6 +37,9 @@ export class AcceptPortfolioShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/AssociateBudgetWithResourceCommand.ts b/clients/client-service-catalog/commands/AssociateBudgetWithResourceCommand.ts index 800ebd99b4e20..425d79176a903 100644 --- a/clients/client-service-catalog/commands/AssociateBudgetWithResourceCommand.ts +++ b/clients/client-service-catalog/commands/AssociateBudgetWithResourceCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateBudgetWithResourceCommandInput = AssociateBudgetWithResourceInput; export type AssociateBudgetWithResourceCommandOutput = AssociateBudgetWithResourceOutput & __MetadataBearer; +/** + *

Associates the specified budget with the specified resource.

+ */ export class AssociateBudgetWithResourceCommand extends $Command< AssociateBudgetWithResourceCommandInput, AssociateBudgetWithResourceCommandOutput, @@ -34,6 +37,9 @@ export class AssociateBudgetWithResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/AssociatePrincipalWithPortfolioCommand.ts b/clients/client-service-catalog/commands/AssociatePrincipalWithPortfolioCommand.ts index 0bcb942cb37da..9669b2440762a 100644 --- a/clients/client-service-catalog/commands/AssociatePrincipalWithPortfolioCommand.ts +++ b/clients/client-service-catalog/commands/AssociatePrincipalWithPortfolioCommand.ts @@ -20,6 +20,9 @@ import { export type AssociatePrincipalWithPortfolioCommandInput = AssociatePrincipalWithPortfolioInput; export type AssociatePrincipalWithPortfolioCommandOutput = AssociatePrincipalWithPortfolioOutput & __MetadataBearer; +/** + *

Associates the specified principal ARN with the specified portfolio.

+ */ export class AssociatePrincipalWithPortfolioCommand extends $Command< AssociatePrincipalWithPortfolioCommandInput, AssociatePrincipalWithPortfolioCommandOutput, @@ -34,6 +37,9 @@ export class AssociatePrincipalWithPortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/AssociateProductWithPortfolioCommand.ts b/clients/client-service-catalog/commands/AssociateProductWithPortfolioCommand.ts index 7daeab4220a81..fc2ece96f8e21 100644 --- a/clients/client-service-catalog/commands/AssociateProductWithPortfolioCommand.ts +++ b/clients/client-service-catalog/commands/AssociateProductWithPortfolioCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateProductWithPortfolioCommandInput = AssociateProductWithPortfolioInput; export type AssociateProductWithPortfolioCommandOutput = AssociateProductWithPortfolioOutput & __MetadataBearer; +/** + *

Associates the specified product with the specified portfolio.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class AssociateProductWithPortfolioCommand extends $Command< AssociateProductWithPortfolioCommandInput, AssociateProductWithPortfolioCommandOutput, @@ -34,6 +38,9 @@ export class AssociateProductWithPortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/AssociateServiceActionWithProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/AssociateServiceActionWithProvisioningArtifactCommand.ts index 3ad80c53264ed..64e46c10128a7 100644 --- a/clients/client-service-catalog/commands/AssociateServiceActionWithProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/AssociateServiceActionWithProvisioningArtifactCommand.ts @@ -24,6 +24,9 @@ export type AssociateServiceActionWithProvisioningArtifactCommandInput = Associa export type AssociateServiceActionWithProvisioningArtifactCommandOutput = AssociateServiceActionWithProvisioningArtifactOutput & __MetadataBearer; +/** + *

Associates a self-service action with a provisioning artifact.

+ */ export class AssociateServiceActionWithProvisioningArtifactCommand extends $Command< AssociateServiceActionWithProvisioningArtifactCommandInput, AssociateServiceActionWithProvisioningArtifactCommandOutput, @@ -38,6 +41,9 @@ export class AssociateServiceActionWithProvisioningArtifactCommand extends $Comm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/AssociateTagOptionWithResourceCommand.ts b/clients/client-service-catalog/commands/AssociateTagOptionWithResourceCommand.ts index 49fc430aa851c..469c4b950684a 100644 --- a/clients/client-service-catalog/commands/AssociateTagOptionWithResourceCommand.ts +++ b/clients/client-service-catalog/commands/AssociateTagOptionWithResourceCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateTagOptionWithResourceCommandInput = AssociateTagOptionWithResourceInput; export type AssociateTagOptionWithResourceCommandOutput = AssociateTagOptionWithResourceOutput & __MetadataBearer; +/** + *

Associate the specified TagOption with the specified portfolio or product.

+ */ export class AssociateTagOptionWithResourceCommand extends $Command< AssociateTagOptionWithResourceCommandInput, AssociateTagOptionWithResourceCommandOutput, @@ -34,6 +37,9 @@ export class AssociateTagOptionWithResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/BatchAssociateServiceActionWithProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/BatchAssociateServiceActionWithProvisioningArtifactCommand.ts index dbbc0a9b5d6e2..ba32afd368b66 100644 --- a/clients/client-service-catalog/commands/BatchAssociateServiceActionWithProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/BatchAssociateServiceActionWithProvisioningArtifactCommand.ts @@ -24,6 +24,9 @@ export type BatchAssociateServiceActionWithProvisioningArtifactCommandInput = Ba export type BatchAssociateServiceActionWithProvisioningArtifactCommandOutput = BatchAssociateServiceActionWithProvisioningArtifactOutput & __MetadataBearer; +/** + *

Associates multiple self-service actions with provisioning artifacts.

+ */ export class BatchAssociateServiceActionWithProvisioningArtifactCommand extends $Command< BatchAssociateServiceActionWithProvisioningArtifactCommandInput, BatchAssociateServiceActionWithProvisioningArtifactCommandOutput, @@ -38,6 +41,9 @@ export class BatchAssociateServiceActionWithProvisioningArtifactCommand extends // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/BatchDisassociateServiceActionFromProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/BatchDisassociateServiceActionFromProvisioningArtifactCommand.ts index 11e292a55d58a..83ea750e6b5bb 100644 --- a/clients/client-service-catalog/commands/BatchDisassociateServiceActionFromProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/BatchDisassociateServiceActionFromProvisioningArtifactCommand.ts @@ -24,6 +24,9 @@ export type BatchDisassociateServiceActionFromProvisioningArtifactCommandInput = export type BatchDisassociateServiceActionFromProvisioningArtifactCommandOutput = BatchDisassociateServiceActionFromProvisioningArtifactOutput & __MetadataBearer; +/** + *

Disassociates a batch of self-service actions from the specified provisioning artifact.

+ */ export class BatchDisassociateServiceActionFromProvisioningArtifactCommand extends $Command< BatchDisassociateServiceActionFromProvisioningArtifactCommandInput, BatchDisassociateServiceActionFromProvisioningArtifactCommandOutput, @@ -38,6 +41,9 @@ export class BatchDisassociateServiceActionFromProvisioningArtifactCommand exten // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CopyProductCommand.ts b/clients/client-service-catalog/commands/CopyProductCommand.ts index 11fad2f6ec7de..389b77c893935 100644 --- a/clients/client-service-catalog/commands/CopyProductCommand.ts +++ b/clients/client-service-catalog/commands/CopyProductCommand.ts @@ -20,6 +20,13 @@ import { export type CopyProductCommandInput = CopyProductInput; export type CopyProductCommandOutput = CopyProductOutput & __MetadataBearer; +/** + *

Copies the specified source product to the specified target product or a new product.

+ *

You can copy a product to the same account or another account. + * You can copy a product to the same region or another region.

+ *

This operation is performed asynchronously. To track the progress of the + * operation, use DescribeCopyProductStatus.

+ */ export class CopyProductCommand extends $Command< CopyProductCommandInput, CopyProductCommandOutput, @@ -34,6 +41,9 @@ export class CopyProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CreateConstraintCommand.ts b/clients/client-service-catalog/commands/CreateConstraintCommand.ts index 46a231eb0778a..22cd9eb72d784 100644 --- a/clients/client-service-catalog/commands/CreateConstraintCommand.ts +++ b/clients/client-service-catalog/commands/CreateConstraintCommand.ts @@ -20,6 +20,10 @@ import { export type CreateConstraintCommandInput = CreateConstraintInput; export type CreateConstraintCommandOutput = CreateConstraintOutput & __MetadataBearer; +/** + *

Creates a constraint.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class CreateConstraintCommand extends $Command< CreateConstraintCommandInput, CreateConstraintCommandOutput, @@ -34,6 +38,9 @@ export class CreateConstraintCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CreatePortfolioCommand.ts b/clients/client-service-catalog/commands/CreatePortfolioCommand.ts index b968e14c954b9..d6a1c81eb1d61 100644 --- a/clients/client-service-catalog/commands/CreatePortfolioCommand.ts +++ b/clients/client-service-catalog/commands/CreatePortfolioCommand.ts @@ -20,6 +20,10 @@ import { export type CreatePortfolioCommandInput = CreatePortfolioInput; export type CreatePortfolioCommandOutput = CreatePortfolioOutput & __MetadataBearer; +/** + *

Creates a portfolio.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class CreatePortfolioCommand extends $Command< CreatePortfolioCommandInput, CreatePortfolioCommandOutput, @@ -34,6 +38,9 @@ export class CreatePortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CreatePortfolioShareCommand.ts b/clients/client-service-catalog/commands/CreatePortfolioShareCommand.ts index d058d57e02b09..edcb655c5bb9a 100644 --- a/clients/client-service-catalog/commands/CreatePortfolioShareCommand.ts +++ b/clients/client-service-catalog/commands/CreatePortfolioShareCommand.ts @@ -20,6 +20,16 @@ import { export type CreatePortfolioShareCommandInput = CreatePortfolioShareInput; export type CreatePortfolioShareCommandOutput = CreatePortfolioShareOutput & __MetadataBearer; +/** + *

Shares the specified portfolio with the specified account or organization node. + * Shares to an organization node can only be created by the management account of an + * organization or by a delegated administrator. You can share portfolios to an organization, + * an organizational unit, or a specific account.

+ *

Note that if a delegated admin is de-registered, they can no longer create portfolio shares.

+ *

+ * AWSOrganizationsAccess must be enabled in order to create a portfolio share to an organization node.

+ *

You can't share a shared resource. This includes portfolios that contain a shared product.

+ */ export class CreatePortfolioShareCommand extends $Command< CreatePortfolioShareCommandInput, CreatePortfolioShareCommandOutput, @@ -34,6 +44,9 @@ export class CreatePortfolioShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CreateProductCommand.ts b/clients/client-service-catalog/commands/CreateProductCommand.ts index f268d2c3bb6b5..19895a388cc75 100644 --- a/clients/client-service-catalog/commands/CreateProductCommand.ts +++ b/clients/client-service-catalog/commands/CreateProductCommand.ts @@ -20,6 +20,10 @@ import { export type CreateProductCommandInput = CreateProductInput; export type CreateProductCommandOutput = CreateProductOutput & __MetadataBearer; +/** + *

Creates a product.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class CreateProductCommand extends $Command< CreateProductCommandInput, CreateProductCommandOutput, @@ -34,6 +38,9 @@ export class CreateProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CreateProvisionedProductPlanCommand.ts b/clients/client-service-catalog/commands/CreateProvisionedProductPlanCommand.ts index a1a29bc7cb5e5..065f7e482e25f 100644 --- a/clients/client-service-catalog/commands/CreateProvisionedProductPlanCommand.ts +++ b/clients/client-service-catalog/commands/CreateProvisionedProductPlanCommand.ts @@ -20,6 +20,15 @@ import { export type CreateProvisionedProductPlanCommandInput = CreateProvisionedProductPlanInput; export type CreateProvisionedProductPlanCommandOutput = CreateProvisionedProductPlanOutput & __MetadataBearer; +/** + *

Creates a plan. A plan includes the list of resources to be + * created (when provisioning a new product) or modified (when updating a provisioned product) + * when the plan is executed.

+ *

You can create one plan per provisioned product. To create a plan for an existing + * provisioned product, the product status must be AVAILBLE or TAINTED.

+ *

To view the resource changes in the change set, use DescribeProvisionedProductPlan. + * To create or modify the provisioned product, use ExecuteProvisionedProductPlan.

+ */ export class CreateProvisionedProductPlanCommand extends $Command< CreateProvisionedProductPlanCommandInput, CreateProvisionedProductPlanCommandOutput, @@ -34,6 +43,9 @@ export class CreateProvisionedProductPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CreateProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/CreateProvisioningArtifactCommand.ts index 8f2d5fea1b55f..b7f9ada04b6a7 100644 --- a/clients/client-service-catalog/commands/CreateProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/CreateProvisioningArtifactCommand.ts @@ -20,6 +20,10 @@ import { export type CreateProvisioningArtifactCommandInput = CreateProvisioningArtifactInput; export type CreateProvisioningArtifactCommandOutput = CreateProvisioningArtifactOutput & __MetadataBearer; +/** + *

Creates a provisioning artifact (also known as a version) for the specified product.

+ *

You cannot create a provisioning artifact for a product that was shared with you.

+ */ export class CreateProvisioningArtifactCommand extends $Command< CreateProvisioningArtifactCommandInput, CreateProvisioningArtifactCommandOutput, @@ -34,6 +38,9 @@ export class CreateProvisioningArtifactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CreateServiceActionCommand.ts b/clients/client-service-catalog/commands/CreateServiceActionCommand.ts index 57a387fd2f169..20eb8d82ed51a 100644 --- a/clients/client-service-catalog/commands/CreateServiceActionCommand.ts +++ b/clients/client-service-catalog/commands/CreateServiceActionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateServiceActionCommandInput = CreateServiceActionInput; export type CreateServiceActionCommandOutput = CreateServiceActionOutput & __MetadataBearer; +/** + *

Creates a self-service action.

+ */ export class CreateServiceActionCommand extends $Command< CreateServiceActionCommandInput, CreateServiceActionCommandOutput, @@ -34,6 +37,9 @@ export class CreateServiceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/CreateTagOptionCommand.ts b/clients/client-service-catalog/commands/CreateTagOptionCommand.ts index 859ecf840a673..783c72ae55df8 100644 --- a/clients/client-service-catalog/commands/CreateTagOptionCommand.ts +++ b/clients/client-service-catalog/commands/CreateTagOptionCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTagOptionCommandInput = CreateTagOptionInput; export type CreateTagOptionCommandOutput = CreateTagOptionOutput & __MetadataBearer; +/** + *

Creates a TagOption.

+ */ export class CreateTagOptionCommand extends $Command< CreateTagOptionCommandInput, CreateTagOptionCommandOutput, @@ -34,6 +37,9 @@ export class CreateTagOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DeleteConstraintCommand.ts b/clients/client-service-catalog/commands/DeleteConstraintCommand.ts index 04fd5394b472e..177ef7fac888a 100644 --- a/clients/client-service-catalog/commands/DeleteConstraintCommand.ts +++ b/clients/client-service-catalog/commands/DeleteConstraintCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteConstraintCommandInput = DeleteConstraintInput; export type DeleteConstraintCommandOutput = DeleteConstraintOutput & __MetadataBearer; +/** + *

Deletes the specified constraint.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class DeleteConstraintCommand extends $Command< DeleteConstraintCommandInput, DeleteConstraintCommandOutput, @@ -34,6 +38,9 @@ export class DeleteConstraintCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DeletePortfolioCommand.ts b/clients/client-service-catalog/commands/DeletePortfolioCommand.ts index 8e703bc90bba1..38456a7b0997d 100644 --- a/clients/client-service-catalog/commands/DeletePortfolioCommand.ts +++ b/clients/client-service-catalog/commands/DeletePortfolioCommand.ts @@ -20,6 +20,12 @@ import { export type DeletePortfolioCommandInput = DeletePortfolioInput; export type DeletePortfolioCommandOutput = DeletePortfolioOutput & __MetadataBearer; +/** + *

Deletes the specified portfolio.

+ *

You cannot delete a portfolio if it was shared with you or if it has associated + * products, users, constraints, or shared accounts.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class DeletePortfolioCommand extends $Command< DeletePortfolioCommandInput, DeletePortfolioCommandOutput, @@ -34,6 +40,9 @@ export class DeletePortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DeletePortfolioShareCommand.ts b/clients/client-service-catalog/commands/DeletePortfolioShareCommand.ts index 4561fc1f94537..42ad7a6941a8a 100644 --- a/clients/client-service-catalog/commands/DeletePortfolioShareCommand.ts +++ b/clients/client-service-catalog/commands/DeletePortfolioShareCommand.ts @@ -20,6 +20,12 @@ import { export type DeletePortfolioShareCommandInput = DeletePortfolioShareInput; export type DeletePortfolioShareCommandOutput = DeletePortfolioShareOutput & __MetadataBearer; +/** + *

Stops sharing the specified portfolio with the specified account or organization + * node. Shares to an organization node can only be deleted by the management account of an + * organization or by a delegated administrator.

+ *

Note that if a delegated admin is de-registered, portfolio shares created from that account are removed.

+ */ export class DeletePortfolioShareCommand extends $Command< DeletePortfolioShareCommandInput, DeletePortfolioShareCommandOutput, @@ -34,6 +40,9 @@ export class DeletePortfolioShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DeleteProductCommand.ts b/clients/client-service-catalog/commands/DeleteProductCommand.ts index 37d19a6fc049b..6cacfa1acaf18 100644 --- a/clients/client-service-catalog/commands/DeleteProductCommand.ts +++ b/clients/client-service-catalog/commands/DeleteProductCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteProductCommandInput = DeleteProductInput; export type DeleteProductCommandOutput = DeleteProductOutput & __MetadataBearer; +/** + *

Deletes the specified product.

+ *

You cannot delete a product if it was shared with you or is associated with a portfolio.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class DeleteProductCommand extends $Command< DeleteProductCommandInput, DeleteProductCommandOutput, @@ -34,6 +39,9 @@ export class DeleteProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DeleteProvisionedProductPlanCommand.ts b/clients/client-service-catalog/commands/DeleteProvisionedProductPlanCommand.ts index 2a1c1c24a4611..3b98def7ef7ab 100644 --- a/clients/client-service-catalog/commands/DeleteProvisionedProductPlanCommand.ts +++ b/clients/client-service-catalog/commands/DeleteProvisionedProductPlanCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProvisionedProductPlanCommandInput = DeleteProvisionedProductPlanInput; export type DeleteProvisionedProductPlanCommandOutput = DeleteProvisionedProductPlanOutput & __MetadataBearer; +/** + *

Deletes the specified plan.

+ */ export class DeleteProvisionedProductPlanCommand extends $Command< DeleteProvisionedProductPlanCommandInput, DeleteProvisionedProductPlanCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProvisionedProductPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DeleteProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/DeleteProvisioningArtifactCommand.ts index dc3832b825c57..b64e125af4d17 100644 --- a/clients/client-service-catalog/commands/DeleteProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/DeleteProvisioningArtifactCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteProvisioningArtifactCommandInput = DeleteProvisioningArtifactInput; export type DeleteProvisioningArtifactCommandOutput = DeleteProvisioningArtifactOutput & __MetadataBearer; +/** + *

Deletes the specified provisioning artifact (also known as a version) for the specified product.

+ *

You cannot delete a provisioning artifact associated with a product that was shared with you. + * You cannot delete the last provisioning artifact for a product, because a product must have at + * least one provisioning artifact.

+ */ export class DeleteProvisioningArtifactCommand extends $Command< DeleteProvisioningArtifactCommandInput, DeleteProvisioningArtifactCommandOutput, @@ -34,6 +40,9 @@ export class DeleteProvisioningArtifactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DeleteServiceActionCommand.ts b/clients/client-service-catalog/commands/DeleteServiceActionCommand.ts index a540091e44f1f..655939c9bf768 100644 --- a/clients/client-service-catalog/commands/DeleteServiceActionCommand.ts +++ b/clients/client-service-catalog/commands/DeleteServiceActionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteServiceActionCommandInput = DeleteServiceActionInput; export type DeleteServiceActionCommandOutput = DeleteServiceActionOutput & __MetadataBearer; +/** + *

Deletes a self-service action.

+ */ export class DeleteServiceActionCommand extends $Command< DeleteServiceActionCommandInput, DeleteServiceActionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteServiceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DeleteTagOptionCommand.ts b/clients/client-service-catalog/commands/DeleteTagOptionCommand.ts index 6c018eabdb599..c1bcfc3deeba8 100644 --- a/clients/client-service-catalog/commands/DeleteTagOptionCommand.ts +++ b/clients/client-service-catalog/commands/DeleteTagOptionCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTagOptionCommandInput = DeleteTagOptionInput; export type DeleteTagOptionCommandOutput = DeleteTagOptionOutput & __MetadataBearer; +/** + *

Deletes the specified TagOption.

+ *

You cannot delete a TagOption if it is associated with a product or portfolio.

+ */ export class DeleteTagOptionCommand extends $Command< DeleteTagOptionCommandInput, DeleteTagOptionCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTagOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeConstraintCommand.ts b/clients/client-service-catalog/commands/DescribeConstraintCommand.ts index 4b53b26ff2a93..4870a70d6993e 100644 --- a/clients/client-service-catalog/commands/DescribeConstraintCommand.ts +++ b/clients/client-service-catalog/commands/DescribeConstraintCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeConstraintCommandInput = DescribeConstraintInput; export type DescribeConstraintCommandOutput = DescribeConstraintOutput & __MetadataBearer; +/** + *

Gets information about the specified constraint.

+ */ export class DescribeConstraintCommand extends $Command< DescribeConstraintCommandInput, DescribeConstraintCommandOutput, @@ -34,6 +37,9 @@ export class DescribeConstraintCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeCopyProductStatusCommand.ts b/clients/client-service-catalog/commands/DescribeCopyProductStatusCommand.ts index ddc34fbf371c8..da3fbae67bcee 100644 --- a/clients/client-service-catalog/commands/DescribeCopyProductStatusCommand.ts +++ b/clients/client-service-catalog/commands/DescribeCopyProductStatusCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCopyProductStatusCommandInput = DescribeCopyProductStatusInput; export type DescribeCopyProductStatusCommandOutput = DescribeCopyProductStatusOutput & __MetadataBearer; +/** + *

Gets the status of the specified copy product operation.

+ */ export class DescribeCopyProductStatusCommand extends $Command< DescribeCopyProductStatusCommandInput, DescribeCopyProductStatusCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCopyProductStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribePortfolioCommand.ts b/clients/client-service-catalog/commands/DescribePortfolioCommand.ts index 72fb05b08dccc..bb09de16e60e4 100644 --- a/clients/client-service-catalog/commands/DescribePortfolioCommand.ts +++ b/clients/client-service-catalog/commands/DescribePortfolioCommand.ts @@ -20,6 +20,10 @@ import { export type DescribePortfolioCommandInput = DescribePortfolioInput; export type DescribePortfolioCommandOutput = DescribePortfolioOutput & __MetadataBearer; +/** + *

Gets information about the specified portfolio.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class DescribePortfolioCommand extends $Command< DescribePortfolioCommandInput, DescribePortfolioCommandOutput, @@ -34,6 +38,9 @@ export class DescribePortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribePortfolioShareStatusCommand.ts b/clients/client-service-catalog/commands/DescribePortfolioShareStatusCommand.ts index cbcbdac5b5bb4..fe9b80095d250 100644 --- a/clients/client-service-catalog/commands/DescribePortfolioShareStatusCommand.ts +++ b/clients/client-service-catalog/commands/DescribePortfolioShareStatusCommand.ts @@ -20,6 +20,10 @@ import { export type DescribePortfolioShareStatusCommandInput = DescribePortfolioShareStatusInput; export type DescribePortfolioShareStatusCommandOutput = DescribePortfolioShareStatusOutput & __MetadataBearer; +/** + *

Gets the status of the specified portfolio share operation. This API can only be called + * by the management account in the organization or by a delegated admin.

+ */ export class DescribePortfolioShareStatusCommand extends $Command< DescribePortfolioShareStatusCommandInput, DescribePortfolioShareStatusCommandOutput, @@ -34,6 +38,9 @@ export class DescribePortfolioShareStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeProductAsAdminCommand.ts b/clients/client-service-catalog/commands/DescribeProductAsAdminCommand.ts index 40a884f77e314..bc929af996b7d 100644 --- a/clients/client-service-catalog/commands/DescribeProductAsAdminCommand.ts +++ b/clients/client-service-catalog/commands/DescribeProductAsAdminCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProductAsAdminCommandInput = DescribeProductAsAdminInput; export type DescribeProductAsAdminCommandOutput = DescribeProductAsAdminOutput & __MetadataBearer; +/** + *

Gets information about the specified product. This operation is run with administrator access.

+ */ export class DescribeProductAsAdminCommand extends $Command< DescribeProductAsAdminCommandInput, DescribeProductAsAdminCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProductAsAdminCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeProductCommand.ts b/clients/client-service-catalog/commands/DescribeProductCommand.ts index 891ce3d3a0279..dbb399c8f9d9f 100644 --- a/clients/client-service-catalog/commands/DescribeProductCommand.ts +++ b/clients/client-service-catalog/commands/DescribeProductCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProductCommandInput = DescribeProductInput; export type DescribeProductCommandOutput = DescribeProductOutput & __MetadataBearer; +/** + *

Gets information about the specified product.

+ */ export class DescribeProductCommand extends $Command< DescribeProductCommandInput, DescribeProductCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeProductViewCommand.ts b/clients/client-service-catalog/commands/DescribeProductViewCommand.ts index 24889c1106df1..7c58e0dc5ad77 100644 --- a/clients/client-service-catalog/commands/DescribeProductViewCommand.ts +++ b/clients/client-service-catalog/commands/DescribeProductViewCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProductViewCommandInput = DescribeProductViewInput; export type DescribeProductViewCommandOutput = DescribeProductViewOutput & __MetadataBearer; +/** + *

Gets information about the specified product.

+ */ export class DescribeProductViewCommand extends $Command< DescribeProductViewCommandInput, DescribeProductViewCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProductViewCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeProvisionedProductCommand.ts b/clients/client-service-catalog/commands/DescribeProvisionedProductCommand.ts index 2532957fa03b1..26eff09594f84 100644 --- a/clients/client-service-catalog/commands/DescribeProvisionedProductCommand.ts +++ b/clients/client-service-catalog/commands/DescribeProvisionedProductCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProvisionedProductCommandInput = DescribeProvisionedProductInput; export type DescribeProvisionedProductCommandOutput = DescribeProvisionedProductOutput & __MetadataBearer; +/** + *

Gets information about the specified provisioned product.

+ */ export class DescribeProvisionedProductCommand extends $Command< DescribeProvisionedProductCommandInput, DescribeProvisionedProductCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProvisionedProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeProvisionedProductPlanCommand.ts b/clients/client-service-catalog/commands/DescribeProvisionedProductPlanCommand.ts index 1b8f62d2cf3a0..5234020a9c97d 100644 --- a/clients/client-service-catalog/commands/DescribeProvisionedProductPlanCommand.ts +++ b/clients/client-service-catalog/commands/DescribeProvisionedProductPlanCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProvisionedProductPlanCommandInput = DescribeProvisionedProductPlanInput; export type DescribeProvisionedProductPlanCommandOutput = DescribeProvisionedProductPlanOutput & __MetadataBearer; +/** + *

Gets information about the resource changes for the specified plan.

+ */ export class DescribeProvisionedProductPlanCommand extends $Command< DescribeProvisionedProductPlanCommandInput, DescribeProvisionedProductPlanCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProvisionedProductPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/DescribeProvisioningArtifactCommand.ts index ec91986ab1ca1..320f62106e152 100644 --- a/clients/client-service-catalog/commands/DescribeProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/DescribeProvisioningArtifactCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProvisioningArtifactCommandInput = DescribeProvisioningArtifactInput; export type DescribeProvisioningArtifactCommandOutput = DescribeProvisioningArtifactOutput & __MetadataBearer; +/** + *

Gets information about the specified provisioning artifact (also known as a version) for the specified product.

+ */ export class DescribeProvisioningArtifactCommand extends $Command< DescribeProvisioningArtifactCommandInput, DescribeProvisioningArtifactCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProvisioningArtifactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeProvisioningParametersCommand.ts b/clients/client-service-catalog/commands/DescribeProvisioningParametersCommand.ts index a1092c8c09989..b78249bc8090d 100644 --- a/clients/client-service-catalog/commands/DescribeProvisioningParametersCommand.ts +++ b/clients/client-service-catalog/commands/DescribeProvisioningParametersCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeProvisioningParametersCommandInput = DescribeProvisioningParametersInput; export type DescribeProvisioningParametersCommandOutput = DescribeProvisioningParametersOutput & __MetadataBearer; +/** + *

Gets information about the configuration required to provision the specified product using + * the specified provisioning artifact.

+ *

If the output contains a TagOption key with an empty list of values, there is a + * TagOption conflict for that key. The end user cannot take action to fix the conflict, and + * launch is not blocked. In subsequent calls to ProvisionProduct, + * do not include conflicted TagOption keys as tags, or this causes the error + * "Parameter validation failed: Missing required parameter in Tags[N]:Value". + * Tag the provisioned product with the value sc-tagoption-conflict-portfolioId-productId.

+ */ export class DescribeProvisioningParametersCommand extends $Command< DescribeProvisioningParametersCommandInput, DescribeProvisioningParametersCommandOutput, @@ -34,6 +44,9 @@ export class DescribeProvisioningParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeRecordCommand.ts b/clients/client-service-catalog/commands/DescribeRecordCommand.ts index 218e0621424c8..9af12aa38b3da 100644 --- a/clients/client-service-catalog/commands/DescribeRecordCommand.ts +++ b/clients/client-service-catalog/commands/DescribeRecordCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeRecordCommandInput = DescribeRecordInput; export type DescribeRecordCommandOutput = DescribeRecordOutput & __MetadataBearer; +/** + *

Gets information about the specified request operation.

+ *

Use this operation after calling a request operation (for example, ProvisionProduct, + * TerminateProvisionedProduct, or UpdateProvisionedProduct). + *

+ * + *

If a provisioned product was transferred to a new owner using UpdateProvisionedProductProperties, the new owner + * will be able to describe all past records for that product. The previous owner will no longer be able to describe the records, but will be able to + * use ListRecordHistory to see the product's history from when he was the owner.

+ *
+ */ export class DescribeRecordCommand extends $Command< DescribeRecordCommandInput, DescribeRecordCommandOutput, @@ -34,6 +45,9 @@ export class DescribeRecordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeServiceActionCommand.ts b/clients/client-service-catalog/commands/DescribeServiceActionCommand.ts index 228538ef1f3b1..53b69a5586c29 100644 --- a/clients/client-service-catalog/commands/DescribeServiceActionCommand.ts +++ b/clients/client-service-catalog/commands/DescribeServiceActionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeServiceActionCommandInput = DescribeServiceActionInput; export type DescribeServiceActionCommandOutput = DescribeServiceActionOutput & __MetadataBearer; +/** + *

Describes a self-service action.

+ */ export class DescribeServiceActionCommand extends $Command< DescribeServiceActionCommandInput, DescribeServiceActionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeServiceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeServiceActionExecutionParametersCommand.ts b/clients/client-service-catalog/commands/DescribeServiceActionExecutionParametersCommand.ts index bcaf293ad040f..7834487972811 100644 --- a/clients/client-service-catalog/commands/DescribeServiceActionExecutionParametersCommand.ts +++ b/clients/client-service-catalog/commands/DescribeServiceActionExecutionParametersCommand.ts @@ -24,6 +24,9 @@ export type DescribeServiceActionExecutionParametersCommandInput = DescribeServi export type DescribeServiceActionExecutionParametersCommandOutput = DescribeServiceActionExecutionParametersOutput & __MetadataBearer; +/** + *

Finds the default parameters for a specific self-service action on a specific provisioned product and returns a map of the results to the user.

+ */ export class DescribeServiceActionExecutionParametersCommand extends $Command< DescribeServiceActionExecutionParametersCommandInput, DescribeServiceActionExecutionParametersCommandOutput, @@ -38,6 +41,9 @@ export class DescribeServiceActionExecutionParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DescribeTagOptionCommand.ts b/clients/client-service-catalog/commands/DescribeTagOptionCommand.ts index 26f2535ff9888..07d60b4b05745 100644 --- a/clients/client-service-catalog/commands/DescribeTagOptionCommand.ts +++ b/clients/client-service-catalog/commands/DescribeTagOptionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTagOptionCommandInput = DescribeTagOptionInput; export type DescribeTagOptionCommandOutput = DescribeTagOptionOutput & __MetadataBearer; +/** + *

Gets information about the specified TagOption.

+ */ export class DescribeTagOptionCommand extends $Command< DescribeTagOptionCommandInput, DescribeTagOptionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTagOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DisableAWSOrganizationsAccessCommand.ts b/clients/client-service-catalog/commands/DisableAWSOrganizationsAccessCommand.ts index b324956fb6e4e..05c14bd93a16c 100644 --- a/clients/client-service-catalog/commands/DisableAWSOrganizationsAccessCommand.ts +++ b/clients/client-service-catalog/commands/DisableAWSOrganizationsAccessCommand.ts @@ -20,6 +20,15 @@ import { export type DisableAWSOrganizationsAccessCommandInput = DisableAWSOrganizationsAccessInput; export type DisableAWSOrganizationsAccessCommandOutput = DisableAWSOrganizationsAccessOutput & __MetadataBearer; +/** + *

Disable portfolio sharing through AWS Organizations feature. This feature will not + * delete your current shares but it will prevent you from creating new shares throughout your + * organization. Current shares will not be in sync with your organization structure if it + * changes after calling this API. This API can only be called by the management account in + * the organization.

+ *

This API can't be invoked if there are active delegated administrators in the organization.

+ *

Note that a delegated administrator is not authorized to invoke DisableAWSOrganizationsAccess.

+ */ export class DisableAWSOrganizationsAccessCommand extends $Command< DisableAWSOrganizationsAccessCommandInput, DisableAWSOrganizationsAccessCommandOutput, @@ -34,6 +43,9 @@ export class DisableAWSOrganizationsAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DisassociateBudgetFromResourceCommand.ts b/clients/client-service-catalog/commands/DisassociateBudgetFromResourceCommand.ts index 54a4bcd33a197..be612858a0171 100644 --- a/clients/client-service-catalog/commands/DisassociateBudgetFromResourceCommand.ts +++ b/clients/client-service-catalog/commands/DisassociateBudgetFromResourceCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateBudgetFromResourceCommandInput = DisassociateBudgetFromResourceInput; export type DisassociateBudgetFromResourceCommandOutput = DisassociateBudgetFromResourceOutput & __MetadataBearer; +/** + *

Disassociates the specified budget from the specified resource.

+ */ export class DisassociateBudgetFromResourceCommand extends $Command< DisassociateBudgetFromResourceCommandInput, DisassociateBudgetFromResourceCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateBudgetFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DisassociatePrincipalFromPortfolioCommand.ts b/clients/client-service-catalog/commands/DisassociatePrincipalFromPortfolioCommand.ts index 71b30482e301b..fea72eb650c9a 100644 --- a/clients/client-service-catalog/commands/DisassociatePrincipalFromPortfolioCommand.ts +++ b/clients/client-service-catalog/commands/DisassociatePrincipalFromPortfolioCommand.ts @@ -21,6 +21,10 @@ export type DisassociatePrincipalFromPortfolioCommandInput = DisassociatePrincip export type DisassociatePrincipalFromPortfolioCommandOutput = DisassociatePrincipalFromPortfolioOutput & __MetadataBearer; +/** + *

Disassociates a previously associated principal ARN from a specified + * portfolio.

+ */ export class DisassociatePrincipalFromPortfolioCommand extends $Command< DisassociatePrincipalFromPortfolioCommandInput, DisassociatePrincipalFromPortfolioCommandOutput, @@ -35,6 +39,9 @@ export class DisassociatePrincipalFromPortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DisassociateProductFromPortfolioCommand.ts b/clients/client-service-catalog/commands/DisassociateProductFromPortfolioCommand.ts index d2382e597cb4f..4c0dafb644fbb 100644 --- a/clients/client-service-catalog/commands/DisassociateProductFromPortfolioCommand.ts +++ b/clients/client-service-catalog/commands/DisassociateProductFromPortfolioCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateProductFromPortfolioCommandInput = DisassociateProductFromPortfolioInput; export type DisassociateProductFromPortfolioCommandOutput = DisassociateProductFromPortfolioOutput & __MetadataBearer; +/** + *

Disassociates the specified product from the specified portfolio.

+ *

A delegated admin is authorized to invoke this command.

+ */ export class DisassociateProductFromPortfolioCommand extends $Command< DisassociateProductFromPortfolioCommandInput, DisassociateProductFromPortfolioCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateProductFromPortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DisassociateServiceActionFromProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/DisassociateServiceActionFromProvisioningArtifactCommand.ts index 6be183e8dc8fc..fa09bc890c046 100644 --- a/clients/client-service-catalog/commands/DisassociateServiceActionFromProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/DisassociateServiceActionFromProvisioningArtifactCommand.ts @@ -24,6 +24,9 @@ export type DisassociateServiceActionFromProvisioningArtifactCommandInput = Disa export type DisassociateServiceActionFromProvisioningArtifactCommandOutput = DisassociateServiceActionFromProvisioningArtifactOutput & __MetadataBearer; +/** + *

Disassociates the specified self-service action association from the specified provisioning artifact.

+ */ export class DisassociateServiceActionFromProvisioningArtifactCommand extends $Command< DisassociateServiceActionFromProvisioningArtifactCommandInput, DisassociateServiceActionFromProvisioningArtifactCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateServiceActionFromProvisioningArtifactCommand extends $C // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/DisassociateTagOptionFromResourceCommand.ts b/clients/client-service-catalog/commands/DisassociateTagOptionFromResourceCommand.ts index 40f9891b6901a..04a17623fdc06 100644 --- a/clients/client-service-catalog/commands/DisassociateTagOptionFromResourceCommand.ts +++ b/clients/client-service-catalog/commands/DisassociateTagOptionFromResourceCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateTagOptionFromResourceCommandInput = DisassociateTagOptionFromResourceInput; export type DisassociateTagOptionFromResourceCommandOutput = DisassociateTagOptionFromResourceOutput & __MetadataBearer; +/** + *

Disassociates the specified TagOption from the specified resource.

+ */ export class DisassociateTagOptionFromResourceCommand extends $Command< DisassociateTagOptionFromResourceCommandInput, DisassociateTagOptionFromResourceCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateTagOptionFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/EnableAWSOrganizationsAccessCommand.ts b/clients/client-service-catalog/commands/EnableAWSOrganizationsAccessCommand.ts index 03c200d53b8d8..1190608c1c8fa 100644 --- a/clients/client-service-catalog/commands/EnableAWSOrganizationsAccessCommand.ts +++ b/clients/client-service-catalog/commands/EnableAWSOrganizationsAccessCommand.ts @@ -20,6 +20,14 @@ import { export type EnableAWSOrganizationsAccessCommandInput = EnableAWSOrganizationsAccessInput; export type EnableAWSOrganizationsAccessCommandOutput = EnableAWSOrganizationsAccessOutput & __MetadataBearer; +/** + *

Enable portfolio sharing feature through AWS Organizations. This API will allow Service + * Catalog to receive updates on your organization in order to sync your shares with the + * current structure. This API can only be called by the management account in the + * organization.

+ *

By calling this API Service Catalog will make a call to organizations:EnableAWSServiceAccess on your behalf so that your shares can be in sync with any changes in your AWS Organizations structure.

+ *

Note that a delegated administrator is not authorized to invoke EnableAWSOrganizationsAccess.

+ */ export class EnableAWSOrganizationsAccessCommand extends $Command< EnableAWSOrganizationsAccessCommandInput, EnableAWSOrganizationsAccessCommandOutput, @@ -34,6 +42,9 @@ export class EnableAWSOrganizationsAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ExecuteProvisionedProductPlanCommand.ts b/clients/client-service-catalog/commands/ExecuteProvisionedProductPlanCommand.ts index fd0953b54fb74..9b48fe0797501 100644 --- a/clients/client-service-catalog/commands/ExecuteProvisionedProductPlanCommand.ts +++ b/clients/client-service-catalog/commands/ExecuteProvisionedProductPlanCommand.ts @@ -20,6 +20,9 @@ import { export type ExecuteProvisionedProductPlanCommandInput = ExecuteProvisionedProductPlanInput; export type ExecuteProvisionedProductPlanCommandOutput = ExecuteProvisionedProductPlanOutput & __MetadataBearer; +/** + *

Provisions or modifies a product based on the resource changes for the specified plan.

+ */ export class ExecuteProvisionedProductPlanCommand extends $Command< ExecuteProvisionedProductPlanCommandInput, ExecuteProvisionedProductPlanCommandOutput, @@ -34,6 +37,9 @@ export class ExecuteProvisionedProductPlanCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ExecuteProvisionedProductServiceActionCommand.ts b/clients/client-service-catalog/commands/ExecuteProvisionedProductServiceActionCommand.ts index fa0f819ccb12d..8f4d95fd6285e 100644 --- a/clients/client-service-catalog/commands/ExecuteProvisionedProductServiceActionCommand.ts +++ b/clients/client-service-catalog/commands/ExecuteProvisionedProductServiceActionCommand.ts @@ -24,6 +24,9 @@ export type ExecuteProvisionedProductServiceActionCommandInput = ExecuteProvisio export type ExecuteProvisionedProductServiceActionCommandOutput = ExecuteProvisionedProductServiceActionOutput & __MetadataBearer; +/** + *

Executes a self-service action against a provisioned product.

+ */ export class ExecuteProvisionedProductServiceActionCommand extends $Command< ExecuteProvisionedProductServiceActionCommandInput, ExecuteProvisionedProductServiceActionCommandOutput, @@ -38,6 +41,9 @@ export class ExecuteProvisionedProductServiceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/GetAWSOrganizationsAccessStatusCommand.ts b/clients/client-service-catalog/commands/GetAWSOrganizationsAccessStatusCommand.ts index 37fe2bd046eda..bc38b40c51869 100644 --- a/clients/client-service-catalog/commands/GetAWSOrganizationsAccessStatusCommand.ts +++ b/clients/client-service-catalog/commands/GetAWSOrganizationsAccessStatusCommand.ts @@ -20,6 +20,10 @@ import { export type GetAWSOrganizationsAccessStatusCommandInput = GetAWSOrganizationsAccessStatusInput; export type GetAWSOrganizationsAccessStatusCommandOutput = GetAWSOrganizationsAccessStatusOutput & __MetadataBearer; +/** + *

Get the Access Status for AWS Organization portfolio share feature. This API can only be + * called by the management account in the organization or by a delegated admin.

+ */ export class GetAWSOrganizationsAccessStatusCommand extends $Command< GetAWSOrganizationsAccessStatusCommandInput, GetAWSOrganizationsAccessStatusCommandOutput, @@ -34,6 +38,9 @@ export class GetAWSOrganizationsAccessStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/GetProvisionedProductOutputsCommand.ts b/clients/client-service-catalog/commands/GetProvisionedProductOutputsCommand.ts index 6826f5e162e14..70be4a15cca55 100644 --- a/clients/client-service-catalog/commands/GetProvisionedProductOutputsCommand.ts +++ b/clients/client-service-catalog/commands/GetProvisionedProductOutputsCommand.ts @@ -20,6 +20,9 @@ import { export type GetProvisionedProductOutputsCommandInput = GetProvisionedProductOutputsInput; export type GetProvisionedProductOutputsCommandOutput = GetProvisionedProductOutputsOutput & __MetadataBearer; +/** + *

This API takes either a ProvisonedProductId or a ProvisionedProductName, along with a list of one or more output keys, and responds with the key/value pairs of those outputs.

+ */ export class GetProvisionedProductOutputsCommand extends $Command< GetProvisionedProductOutputsCommandInput, GetProvisionedProductOutputsCommandOutput, @@ -34,6 +37,9 @@ export class GetProvisionedProductOutputsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ImportAsProvisionedProductCommand.ts b/clients/client-service-catalog/commands/ImportAsProvisionedProductCommand.ts index 5659e061fb56a..2058b1f2cd524 100644 --- a/clients/client-service-catalog/commands/ImportAsProvisionedProductCommand.ts +++ b/clients/client-service-catalog/commands/ImportAsProvisionedProductCommand.ts @@ -20,6 +20,19 @@ import { export type ImportAsProvisionedProductCommandInput = ImportAsProvisionedProductInput; export type ImportAsProvisionedProductCommandOutput = ImportAsProvisionedProductOutput & __MetadataBearer; +/** + *

Requests the import of a resource as a Service Catalog provisioned product that is + * associated to a Service Catalog product and provisioning artifact. Once imported all + * supported Service Catalog governance actions are supported on the provisioned + * product.

+ *

Resource import only supports CloudFormation stack ARNs. CloudFormation StackSets and + * non-root nested stacks are not supported.

+ *

The CloudFormation stack must have one of the following statuses to be imported: + * CREATE_COMPLETE, UPDATE_COMPLETE, UPDATE_ROLLBACK_COMPLETE, IMPORT_COMPLETE, + * IMPORT_ROLLBACK_COMPLETE.

+ *

Import of the resource requires that the CloudFormation stack template matches the + * associated Service Catalog product provisioning artifact.

+ */ export class ImportAsProvisionedProductCommand extends $Command< ImportAsProvisionedProductCommandInput, ImportAsProvisionedProductCommandOutput, @@ -34,6 +47,9 @@ export class ImportAsProvisionedProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListAcceptedPortfolioSharesCommand.ts b/clients/client-service-catalog/commands/ListAcceptedPortfolioSharesCommand.ts index bb53f884eb6f2..1740f31120acc 100644 --- a/clients/client-service-catalog/commands/ListAcceptedPortfolioSharesCommand.ts +++ b/clients/client-service-catalog/commands/ListAcceptedPortfolioSharesCommand.ts @@ -20,6 +20,9 @@ import { export type ListAcceptedPortfolioSharesCommandInput = ListAcceptedPortfolioSharesInput; export type ListAcceptedPortfolioSharesCommandOutput = ListAcceptedPortfolioSharesOutput & __MetadataBearer; +/** + *

Lists all portfolios for which sharing was accepted by this account.

+ */ export class ListAcceptedPortfolioSharesCommand extends $Command< ListAcceptedPortfolioSharesCommandInput, ListAcceptedPortfolioSharesCommandOutput, @@ -34,6 +37,9 @@ export class ListAcceptedPortfolioSharesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListBudgetsForResourceCommand.ts b/clients/client-service-catalog/commands/ListBudgetsForResourceCommand.ts index 6dd7c6f437eb0..581ea36f9714c 100644 --- a/clients/client-service-catalog/commands/ListBudgetsForResourceCommand.ts +++ b/clients/client-service-catalog/commands/ListBudgetsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListBudgetsForResourceCommandInput = ListBudgetsForResourceInput; export type ListBudgetsForResourceCommandOutput = ListBudgetsForResourceOutput & __MetadataBearer; +/** + *

Lists all the budgets associated to the specified resource.

+ */ export class ListBudgetsForResourceCommand extends $Command< ListBudgetsForResourceCommandInput, ListBudgetsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListBudgetsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListConstraintsForPortfolioCommand.ts b/clients/client-service-catalog/commands/ListConstraintsForPortfolioCommand.ts index 00bf03fbddd9f..28f7f48d5346c 100644 --- a/clients/client-service-catalog/commands/ListConstraintsForPortfolioCommand.ts +++ b/clients/client-service-catalog/commands/ListConstraintsForPortfolioCommand.ts @@ -20,6 +20,9 @@ import { export type ListConstraintsForPortfolioCommandInput = ListConstraintsForPortfolioInput; export type ListConstraintsForPortfolioCommandOutput = ListConstraintsForPortfolioOutput & __MetadataBearer; +/** + *

Lists the constraints for the specified portfolio and product.

+ */ export class ListConstraintsForPortfolioCommand extends $Command< ListConstraintsForPortfolioCommandInput, ListConstraintsForPortfolioCommandOutput, @@ -34,6 +37,9 @@ export class ListConstraintsForPortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListLaunchPathsCommand.ts b/clients/client-service-catalog/commands/ListLaunchPathsCommand.ts index 73a77ab79eb58..d397130dbeb3c 100644 --- a/clients/client-service-catalog/commands/ListLaunchPathsCommand.ts +++ b/clients/client-service-catalog/commands/ListLaunchPathsCommand.ts @@ -20,6 +20,11 @@ import { export type ListLaunchPathsCommandInput = ListLaunchPathsInput; export type ListLaunchPathsCommandOutput = ListLaunchPathsOutput & __MetadataBearer; +/** + *

Lists the paths to the specified product. A path is how the user + * has access to a specified product, and is necessary when provisioning a product. A path + * also determines the constraints put on the product.

+ */ export class ListLaunchPathsCommand extends $Command< ListLaunchPathsCommandInput, ListLaunchPathsCommandOutput, @@ -34,6 +39,9 @@ export class ListLaunchPathsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListOrganizationPortfolioAccessCommand.ts b/clients/client-service-catalog/commands/ListOrganizationPortfolioAccessCommand.ts index cb7d83e0a53cf..0800ff2334304 100644 --- a/clients/client-service-catalog/commands/ListOrganizationPortfolioAccessCommand.ts +++ b/clients/client-service-catalog/commands/ListOrganizationPortfolioAccessCommand.ts @@ -20,6 +20,12 @@ import { export type ListOrganizationPortfolioAccessCommandInput = ListOrganizationPortfolioAccessInput; export type ListOrganizationPortfolioAccessCommandOutput = ListOrganizationPortfolioAccessOutput & __MetadataBearer; +/** + *

Lists the organization nodes that have access to the specified portfolio. This API can + * only be called by the management account in the organization or by a delegated + * admin.

+ *

If a delegated admin is de-registered, they can no longer perform this operation.

+ */ export class ListOrganizationPortfolioAccessCommand extends $Command< ListOrganizationPortfolioAccessCommandInput, ListOrganizationPortfolioAccessCommandOutput, @@ -34,6 +40,9 @@ export class ListOrganizationPortfolioAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListPortfolioAccessCommand.ts b/clients/client-service-catalog/commands/ListPortfolioAccessCommand.ts index 4538b751bcbe0..8f3fb36942d86 100644 --- a/clients/client-service-catalog/commands/ListPortfolioAccessCommand.ts +++ b/clients/client-service-catalog/commands/ListPortfolioAccessCommand.ts @@ -20,6 +20,10 @@ import { export type ListPortfolioAccessCommandInput = ListPortfolioAccessInput; export type ListPortfolioAccessCommandOutput = ListPortfolioAccessOutput & __MetadataBearer; +/** + *

Lists the account IDs that have access to the specified portfolio.

+ *

A delegated admin can list the accounts that have access to the shared portfolio. Note that if a delegated admin is de-registered, they can no longer perform this operation.

+ */ export class ListPortfolioAccessCommand extends $Command< ListPortfolioAccessCommandInput, ListPortfolioAccessCommandOutput, @@ -34,6 +38,9 @@ export class ListPortfolioAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListPortfoliosCommand.ts b/clients/client-service-catalog/commands/ListPortfoliosCommand.ts index f9756d01d401a..84c703167eb09 100644 --- a/clients/client-service-catalog/commands/ListPortfoliosCommand.ts +++ b/clients/client-service-catalog/commands/ListPortfoliosCommand.ts @@ -20,6 +20,9 @@ import { export type ListPortfoliosCommandInput = ListPortfoliosInput; export type ListPortfoliosCommandOutput = ListPortfoliosOutput & __MetadataBearer; +/** + *

Lists all portfolios in the catalog.

+ */ export class ListPortfoliosCommand extends $Command< ListPortfoliosCommandInput, ListPortfoliosCommandOutput, @@ -34,6 +37,9 @@ export class ListPortfoliosCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListPortfoliosForProductCommand.ts b/clients/client-service-catalog/commands/ListPortfoliosForProductCommand.ts index 42d2ad342b4b6..69a3b6fbcfa77 100644 --- a/clients/client-service-catalog/commands/ListPortfoliosForProductCommand.ts +++ b/clients/client-service-catalog/commands/ListPortfoliosForProductCommand.ts @@ -20,6 +20,9 @@ import { export type ListPortfoliosForProductCommandInput = ListPortfoliosForProductInput; export type ListPortfoliosForProductCommandOutput = ListPortfoliosForProductOutput & __MetadataBearer; +/** + *

Lists all portfolios that the specified product is associated with.

+ */ export class ListPortfoliosForProductCommand extends $Command< ListPortfoliosForProductCommandInput, ListPortfoliosForProductCommandOutput, @@ -34,6 +37,9 @@ export class ListPortfoliosForProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListPrincipalsForPortfolioCommand.ts b/clients/client-service-catalog/commands/ListPrincipalsForPortfolioCommand.ts index b1ecef55679fd..ffeb210f09f37 100644 --- a/clients/client-service-catalog/commands/ListPrincipalsForPortfolioCommand.ts +++ b/clients/client-service-catalog/commands/ListPrincipalsForPortfolioCommand.ts @@ -20,6 +20,9 @@ import { export type ListPrincipalsForPortfolioCommandInput = ListPrincipalsForPortfolioInput; export type ListPrincipalsForPortfolioCommandOutput = ListPrincipalsForPortfolioOutput & __MetadataBearer; +/** + *

Lists all principal ARNs associated with the specified portfolio.

+ */ export class ListPrincipalsForPortfolioCommand extends $Command< ListPrincipalsForPortfolioCommandInput, ListPrincipalsForPortfolioCommandOutput, @@ -34,6 +37,9 @@ export class ListPrincipalsForPortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListProvisionedProductPlansCommand.ts b/clients/client-service-catalog/commands/ListProvisionedProductPlansCommand.ts index dc0212475abb3..3533fb9dfea25 100644 --- a/clients/client-service-catalog/commands/ListProvisionedProductPlansCommand.ts +++ b/clients/client-service-catalog/commands/ListProvisionedProductPlansCommand.ts @@ -20,6 +20,9 @@ import { export type ListProvisionedProductPlansCommandInput = ListProvisionedProductPlansInput; export type ListProvisionedProductPlansCommandOutput = ListProvisionedProductPlansOutput & __MetadataBearer; +/** + *

Lists the plans for the specified provisioned product or all plans to which the user has access.

+ */ export class ListProvisionedProductPlansCommand extends $Command< ListProvisionedProductPlansCommandInput, ListProvisionedProductPlansCommandOutput, @@ -34,6 +37,9 @@ export class ListProvisionedProductPlansCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListProvisioningArtifactsCommand.ts b/clients/client-service-catalog/commands/ListProvisioningArtifactsCommand.ts index d6b27496312ad..cd1784224ea33 100644 --- a/clients/client-service-catalog/commands/ListProvisioningArtifactsCommand.ts +++ b/clients/client-service-catalog/commands/ListProvisioningArtifactsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProvisioningArtifactsCommandInput = ListProvisioningArtifactsInput; export type ListProvisioningArtifactsCommandOutput = ListProvisioningArtifactsOutput & __MetadataBearer; +/** + *

Lists all provisioning artifacts (also known as versions) for the specified product.

+ */ export class ListProvisioningArtifactsCommand extends $Command< ListProvisioningArtifactsCommandInput, ListProvisioningArtifactsCommandOutput, @@ -34,6 +37,9 @@ export class ListProvisioningArtifactsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListProvisioningArtifactsForServiceActionCommand.ts b/clients/client-service-catalog/commands/ListProvisioningArtifactsForServiceActionCommand.ts index e6fda94010412..6bb07a86a3883 100644 --- a/clients/client-service-catalog/commands/ListProvisioningArtifactsForServiceActionCommand.ts +++ b/clients/client-service-catalog/commands/ListProvisioningArtifactsForServiceActionCommand.ts @@ -24,6 +24,9 @@ export type ListProvisioningArtifactsForServiceActionCommandInput = ListProvisio export type ListProvisioningArtifactsForServiceActionCommandOutput = ListProvisioningArtifactsForServiceActionOutput & __MetadataBearer; +/** + *

Lists all provisioning artifacts (also known as versions) for the specified self-service action.

+ */ export class ListProvisioningArtifactsForServiceActionCommand extends $Command< ListProvisioningArtifactsForServiceActionCommandInput, ListProvisioningArtifactsForServiceActionCommandOutput, @@ -38,6 +41,9 @@ export class ListProvisioningArtifactsForServiceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListRecordHistoryCommand.ts b/clients/client-service-catalog/commands/ListRecordHistoryCommand.ts index 3438a34563143..a90e77565adca 100644 --- a/clients/client-service-catalog/commands/ListRecordHistoryCommand.ts +++ b/clients/client-service-catalog/commands/ListRecordHistoryCommand.ts @@ -20,6 +20,9 @@ import { export type ListRecordHistoryCommandInput = ListRecordHistoryInput; export type ListRecordHistoryCommandOutput = ListRecordHistoryOutput & __MetadataBearer; +/** + *

Lists the specified requests or all performed requests.

+ */ export class ListRecordHistoryCommand extends $Command< ListRecordHistoryCommandInput, ListRecordHistoryCommandOutput, @@ -34,6 +37,9 @@ export class ListRecordHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListResourcesForTagOptionCommand.ts b/clients/client-service-catalog/commands/ListResourcesForTagOptionCommand.ts index 0929014878529..2678d0ebc149c 100644 --- a/clients/client-service-catalog/commands/ListResourcesForTagOptionCommand.ts +++ b/clients/client-service-catalog/commands/ListResourcesForTagOptionCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourcesForTagOptionCommandInput = ListResourcesForTagOptionInput; export type ListResourcesForTagOptionCommandOutput = ListResourcesForTagOptionOutput & __MetadataBearer; +/** + *

Lists the resources associated with the specified TagOption.

+ */ export class ListResourcesForTagOptionCommand extends $Command< ListResourcesForTagOptionCommandInput, ListResourcesForTagOptionCommandOutput, @@ -34,6 +37,9 @@ export class ListResourcesForTagOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListServiceActionsCommand.ts b/clients/client-service-catalog/commands/ListServiceActionsCommand.ts index 6727b504d0c32..e155892dc32b5 100644 --- a/clients/client-service-catalog/commands/ListServiceActionsCommand.ts +++ b/clients/client-service-catalog/commands/ListServiceActionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListServiceActionsCommandInput = ListServiceActionsInput; export type ListServiceActionsCommandOutput = ListServiceActionsOutput & __MetadataBearer; +/** + *

Lists all self-service actions.

+ */ export class ListServiceActionsCommand extends $Command< ListServiceActionsCommandInput, ListServiceActionsCommandOutput, @@ -34,6 +37,9 @@ export class ListServiceActionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListServiceActionsForProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/ListServiceActionsForProvisioningArtifactCommand.ts index c2088951408a3..03c042503219f 100644 --- a/clients/client-service-catalog/commands/ListServiceActionsForProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/ListServiceActionsForProvisioningArtifactCommand.ts @@ -24,6 +24,9 @@ export type ListServiceActionsForProvisioningArtifactCommandInput = ListServiceA export type ListServiceActionsForProvisioningArtifactCommandOutput = ListServiceActionsForProvisioningArtifactOutput & __MetadataBearer; +/** + *

Returns a paginated list of self-service actions associated with the specified Product ID and Provisioning Artifact ID.

+ */ export class ListServiceActionsForProvisioningArtifactCommand extends $Command< ListServiceActionsForProvisioningArtifactCommandInput, ListServiceActionsForProvisioningArtifactCommandOutput, @@ -38,6 +41,9 @@ export class ListServiceActionsForProvisioningArtifactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListStackInstancesForProvisionedProductCommand.ts b/clients/client-service-catalog/commands/ListStackInstancesForProvisionedProductCommand.ts index d7e9c2b055dc4..c78e9f0759e0e 100644 --- a/clients/client-service-catalog/commands/ListStackInstancesForProvisionedProductCommand.ts +++ b/clients/client-service-catalog/commands/ListStackInstancesForProvisionedProductCommand.ts @@ -24,6 +24,9 @@ export type ListStackInstancesForProvisionedProductCommandInput = ListStackInsta export type ListStackInstancesForProvisionedProductCommandOutput = ListStackInstancesForProvisionedProductOutput & __MetadataBearer; +/** + *

Returns summary information about stack instances that are associated with the specified CFN_STACKSET type provisioned product. You can filter for stack instances that are associated with a specific AWS account name or region.

+ */ export class ListStackInstancesForProvisionedProductCommand extends $Command< ListStackInstancesForProvisionedProductCommandInput, ListStackInstancesForProvisionedProductCommandOutput, @@ -38,6 +41,9 @@ export class ListStackInstancesForProvisionedProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ListTagOptionsCommand.ts b/clients/client-service-catalog/commands/ListTagOptionsCommand.ts index a9cb1cdb45556..e6d34d8a940da 100644 --- a/clients/client-service-catalog/commands/ListTagOptionsCommand.ts +++ b/clients/client-service-catalog/commands/ListTagOptionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagOptionsCommandInput = ListTagOptionsInput; export type ListTagOptionsCommandOutput = ListTagOptionsOutput & __MetadataBearer; +/** + *

Lists the specified TagOptions or all TagOptions.

+ */ export class ListTagOptionsCommand extends $Command< ListTagOptionsCommandInput, ListTagOptionsCommandOutput, @@ -34,6 +37,9 @@ export class ListTagOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ProvisionProductCommand.ts b/clients/client-service-catalog/commands/ProvisionProductCommand.ts index c37140ea101d1..5e959bba73413 100644 --- a/clients/client-service-catalog/commands/ProvisionProductCommand.ts +++ b/clients/client-service-catalog/commands/ProvisionProductCommand.ts @@ -20,6 +20,17 @@ import { export type ProvisionProductCommandInput = ProvisionProductInput; export type ProvisionProductCommandOutput = ProvisionProductOutput & __MetadataBearer; +/** + *

Provisions the specified product.

+ *

A provisioned product is a resourced instance of a product. + * For example, provisioning a product based on a CloudFormation template launches a + * CloudFormation stack and its underlying resources. + * You can check the status of this request using DescribeRecord.

+ *

If the request contains a tag key with an empty list of values, there is a + * tag conflict for that key. Do not include conflicted keys as tags, or this causes + * the error "Parameter validation failed: Missing required parameter in + * Tags[N]:Value".

+ */ export class ProvisionProductCommand extends $Command< ProvisionProductCommandInput, ProvisionProductCommandOutput, @@ -34,6 +45,9 @@ export class ProvisionProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/RejectPortfolioShareCommand.ts b/clients/client-service-catalog/commands/RejectPortfolioShareCommand.ts index 9425682fbad12..c0e3b79a0e362 100644 --- a/clients/client-service-catalog/commands/RejectPortfolioShareCommand.ts +++ b/clients/client-service-catalog/commands/RejectPortfolioShareCommand.ts @@ -20,6 +20,9 @@ import { export type RejectPortfolioShareCommandInput = RejectPortfolioShareInput; export type RejectPortfolioShareCommandOutput = RejectPortfolioShareOutput & __MetadataBearer; +/** + *

Rejects an offer to share the specified portfolio.

+ */ export class RejectPortfolioShareCommand extends $Command< RejectPortfolioShareCommandInput, RejectPortfolioShareCommandOutput, @@ -34,6 +37,9 @@ export class RejectPortfolioShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/ScanProvisionedProductsCommand.ts b/clients/client-service-catalog/commands/ScanProvisionedProductsCommand.ts index fb9059012a964..5a6eb9679de8b 100644 --- a/clients/client-service-catalog/commands/ScanProvisionedProductsCommand.ts +++ b/clients/client-service-catalog/commands/ScanProvisionedProductsCommand.ts @@ -20,6 +20,10 @@ import { export type ScanProvisionedProductsCommandInput = ScanProvisionedProductsInput; export type ScanProvisionedProductsCommandOutput = ScanProvisionedProductsOutput & __MetadataBearer; +/** + *

Lists the provisioned products that are available (not terminated).

+ *

To use additional filtering, see SearchProvisionedProducts.

+ */ export class ScanProvisionedProductsCommand extends $Command< ScanProvisionedProductsCommandInput, ScanProvisionedProductsCommandOutput, @@ -34,6 +38,9 @@ export class ScanProvisionedProductsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/SearchProductsAsAdminCommand.ts b/clients/client-service-catalog/commands/SearchProductsAsAdminCommand.ts index 8ff849cea73e3..c95c204498045 100644 --- a/clients/client-service-catalog/commands/SearchProductsAsAdminCommand.ts +++ b/clients/client-service-catalog/commands/SearchProductsAsAdminCommand.ts @@ -20,6 +20,9 @@ import { export type SearchProductsAsAdminCommandInput = SearchProductsAsAdminInput; export type SearchProductsAsAdminCommandOutput = SearchProductsAsAdminOutput & __MetadataBearer; +/** + *

Gets information about the products for the specified portfolio or all products.

+ */ export class SearchProductsAsAdminCommand extends $Command< SearchProductsAsAdminCommandInput, SearchProductsAsAdminCommandOutput, @@ -34,6 +37,9 @@ export class SearchProductsAsAdminCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/SearchProductsCommand.ts b/clients/client-service-catalog/commands/SearchProductsCommand.ts index 78002bbe27749..f8117ef034322 100644 --- a/clients/client-service-catalog/commands/SearchProductsCommand.ts +++ b/clients/client-service-catalog/commands/SearchProductsCommand.ts @@ -20,6 +20,9 @@ import { export type SearchProductsCommandInput = SearchProductsInput; export type SearchProductsCommandOutput = SearchProductsOutput & __MetadataBearer; +/** + *

Gets information about the products to which the caller has access.

+ */ export class SearchProductsCommand extends $Command< SearchProductsCommandInput, SearchProductsCommandOutput, @@ -34,6 +37,9 @@ export class SearchProductsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/SearchProvisionedProductsCommand.ts b/clients/client-service-catalog/commands/SearchProvisionedProductsCommand.ts index fa49d1e36f078..89b552f06471d 100644 --- a/clients/client-service-catalog/commands/SearchProvisionedProductsCommand.ts +++ b/clients/client-service-catalog/commands/SearchProvisionedProductsCommand.ts @@ -20,6 +20,9 @@ import { export type SearchProvisionedProductsCommandInput = SearchProvisionedProductsInput; export type SearchProvisionedProductsCommandOutput = SearchProvisionedProductsOutput & __MetadataBearer; +/** + *

Gets information about the provisioned products that meet the specified criteria.

+ */ export class SearchProvisionedProductsCommand extends $Command< SearchProvisionedProductsCommandInput, SearchProvisionedProductsCommandOutput, @@ -34,6 +37,9 @@ export class SearchProvisionedProductsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/TerminateProvisionedProductCommand.ts b/clients/client-service-catalog/commands/TerminateProvisionedProductCommand.ts index 86f1a0b7620b0..5ad24c1f84099 100644 --- a/clients/client-service-catalog/commands/TerminateProvisionedProductCommand.ts +++ b/clients/client-service-catalog/commands/TerminateProvisionedProductCommand.ts @@ -20,6 +20,11 @@ import { export type TerminateProvisionedProductCommandInput = TerminateProvisionedProductInput; export type TerminateProvisionedProductCommandOutput = TerminateProvisionedProductOutput & __MetadataBearer; +/** + *

Terminates the specified provisioned product.

+ *

This operation does not delete any records associated with the provisioned product.

+ *

You can check the status of this request using DescribeRecord.

+ */ export class TerminateProvisionedProductCommand extends $Command< TerminateProvisionedProductCommandInput, TerminateProvisionedProductCommandOutput, @@ -34,6 +39,9 @@ export class TerminateProvisionedProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/UpdateConstraintCommand.ts b/clients/client-service-catalog/commands/UpdateConstraintCommand.ts index 11eb521b0bccf..9b438d91d728b 100644 --- a/clients/client-service-catalog/commands/UpdateConstraintCommand.ts +++ b/clients/client-service-catalog/commands/UpdateConstraintCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateConstraintCommandInput = UpdateConstraintInput; export type UpdateConstraintCommandOutput = UpdateConstraintOutput & __MetadataBearer; +/** + *

Updates the specified constraint.

+ */ export class UpdateConstraintCommand extends $Command< UpdateConstraintCommandInput, UpdateConstraintCommandOutput, @@ -34,6 +37,9 @@ export class UpdateConstraintCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/UpdatePortfolioCommand.ts b/clients/client-service-catalog/commands/UpdatePortfolioCommand.ts index da32da166e764..6e6b712a90615 100644 --- a/clients/client-service-catalog/commands/UpdatePortfolioCommand.ts +++ b/clients/client-service-catalog/commands/UpdatePortfolioCommand.ts @@ -20,6 +20,10 @@ import { export type UpdatePortfolioCommandInput = UpdatePortfolioInput; export type UpdatePortfolioCommandOutput = UpdatePortfolioOutput & __MetadataBearer; +/** + *

Updates the specified portfolio.

+ *

You cannot update a product that was shared with you.

+ */ export class UpdatePortfolioCommand extends $Command< UpdatePortfolioCommandInput, UpdatePortfolioCommandOutput, @@ -34,6 +38,9 @@ export class UpdatePortfolioCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/UpdateProductCommand.ts b/clients/client-service-catalog/commands/UpdateProductCommand.ts index e7c37368ddb1e..589a493a637fe 100644 --- a/clients/client-service-catalog/commands/UpdateProductCommand.ts +++ b/clients/client-service-catalog/commands/UpdateProductCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProductCommandInput = UpdateProductInput; export type UpdateProductCommandOutput = UpdateProductOutput & __MetadataBearer; +/** + *

Updates the specified product.

+ */ export class UpdateProductCommand extends $Command< UpdateProductCommandInput, UpdateProductCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/UpdateProvisionedProductCommand.ts b/clients/client-service-catalog/commands/UpdateProvisionedProductCommand.ts index 5095d2d401edc..7dbabc0b504e1 100644 --- a/clients/client-service-catalog/commands/UpdateProvisionedProductCommand.ts +++ b/clients/client-service-catalog/commands/UpdateProvisionedProductCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateProvisionedProductCommandInput = UpdateProvisionedProductInput; export type UpdateProvisionedProductCommandOutput = UpdateProvisionedProductOutput & __MetadataBearer; +/** + *

Requests updates to the configuration of the specified provisioned product.

+ *

If there are tags associated with the object, they cannot be updated or added. + * Depending on the specific updates requested, this operation can update with no + * interruption, with some interruption, or replace the provisioned product entirely.

+ *

You can check the status of this request using DescribeRecord.

+ */ export class UpdateProvisionedProductCommand extends $Command< UpdateProvisionedProductCommandInput, UpdateProvisionedProductCommandOutput, @@ -34,6 +41,9 @@ export class UpdateProvisionedProductCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/UpdateProvisionedProductPropertiesCommand.ts b/clients/client-service-catalog/commands/UpdateProvisionedProductPropertiesCommand.ts index c6f466937afe1..4663566d7595b 100644 --- a/clients/client-service-catalog/commands/UpdateProvisionedProductPropertiesCommand.ts +++ b/clients/client-service-catalog/commands/UpdateProvisionedProductPropertiesCommand.ts @@ -21,6 +21,9 @@ export type UpdateProvisionedProductPropertiesCommandInput = UpdateProvisionedPr export type UpdateProvisionedProductPropertiesCommandOutput = UpdateProvisionedProductPropertiesOutput & __MetadataBearer; +/** + *

Requests updates to the properties of the specified provisioned product.

+ */ export class UpdateProvisionedProductPropertiesCommand extends $Command< UpdateProvisionedProductPropertiesCommandInput, UpdateProvisionedProductPropertiesCommandOutput, @@ -35,6 +38,9 @@ export class UpdateProvisionedProductPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/UpdateProvisioningArtifactCommand.ts b/clients/client-service-catalog/commands/UpdateProvisioningArtifactCommand.ts index 976cec175abd3..bb22d3db2a54e 100644 --- a/clients/client-service-catalog/commands/UpdateProvisioningArtifactCommand.ts +++ b/clients/client-service-catalog/commands/UpdateProvisioningArtifactCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateProvisioningArtifactCommandInput = UpdateProvisioningArtifactInput; export type UpdateProvisioningArtifactCommandOutput = UpdateProvisioningArtifactOutput & __MetadataBearer; +/** + *

Updates the specified provisioning artifact (also known as a version) for the specified product.

+ *

You cannot update a provisioning artifact for a product that was shared with you.

+ */ export class UpdateProvisioningArtifactCommand extends $Command< UpdateProvisioningArtifactCommandInput, UpdateProvisioningArtifactCommandOutput, @@ -34,6 +38,9 @@ export class UpdateProvisioningArtifactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/UpdateServiceActionCommand.ts b/clients/client-service-catalog/commands/UpdateServiceActionCommand.ts index 15176c9977f45..e090407a1a98e 100644 --- a/clients/client-service-catalog/commands/UpdateServiceActionCommand.ts +++ b/clients/client-service-catalog/commands/UpdateServiceActionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateServiceActionCommandInput = UpdateServiceActionInput; export type UpdateServiceActionCommandOutput = UpdateServiceActionOutput & __MetadataBearer; +/** + *

Updates a self-service action.

+ */ export class UpdateServiceActionCommand extends $Command< UpdateServiceActionCommandInput, UpdateServiceActionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateServiceActionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/commands/UpdateTagOptionCommand.ts b/clients/client-service-catalog/commands/UpdateTagOptionCommand.ts index 1ea46c4a36e9d..f8a8628a77bb9 100644 --- a/clients/client-service-catalog/commands/UpdateTagOptionCommand.ts +++ b/clients/client-service-catalog/commands/UpdateTagOptionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateTagOptionCommandInput = UpdateTagOptionInput; export type UpdateTagOptionCommandOutput = UpdateTagOptionOutput & __MetadataBearer; +/** + *

Updates the specified TagOption.

+ */ export class UpdateTagOptionCommand extends $Command< UpdateTagOptionCommandInput, UpdateTagOptionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateTagOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceCatalogClientResolvedConfig, diff --git a/clients/client-service-catalog/package.json b/clients/client-service-catalog/package.json index bcacf1c0e7c56..9678a6daa435d 100644 --- a/clients/client-service-catalog/package.json +++ b/clients/client-service-catalog/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Service Catalog Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-service-catalog/pagination/GetProvisionedProductOutputsPaginator.ts b/clients/client-service-catalog/pagination/GetProvisionedProductOutputsPaginator.ts index c8bd4be8968c8..19bebc950f7bc 100644 --- a/clients/client-service-catalog/pagination/GetProvisionedProductOutputsPaginator.ts +++ b/clients/client-service-catalog/pagination/GetProvisionedProductOutputsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: GetProvisionedProductOutputsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetProvisionedProductOutputsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: GetProvisionedProductOutputsCommandInput, diff --git a/clients/client-service-catalog/pagination/ListAcceptedPortfolioSharesPaginator.ts b/clients/client-service-catalog/pagination/ListAcceptedPortfolioSharesPaginator.ts index d6a5e23ae0d73..ee52270d75b1d 100644 --- a/clients/client-service-catalog/pagination/ListAcceptedPortfolioSharesPaginator.ts +++ b/clients/client-service-catalog/pagination/ListAcceptedPortfolioSharesPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListAcceptedPortfolioSharesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAcceptedPortfolioSharesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListAcceptedPortfolioSharesCommandInput, diff --git a/clients/client-service-catalog/pagination/ListBudgetsForResourcePaginator.ts b/clients/client-service-catalog/pagination/ListBudgetsForResourcePaginator.ts index f7bf737f0913c..948ddde19d823 100644 --- a/clients/client-service-catalog/pagination/ListBudgetsForResourcePaginator.ts +++ b/clients/client-service-catalog/pagination/ListBudgetsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListBudgetsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListBudgetsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListBudgetsForResourceCommandInput, diff --git a/clients/client-service-catalog/pagination/ListConstraintsForPortfolioPaginator.ts b/clients/client-service-catalog/pagination/ListConstraintsForPortfolioPaginator.ts index 383dde31422d0..5d33ca9559d03 100644 --- a/clients/client-service-catalog/pagination/ListConstraintsForPortfolioPaginator.ts +++ b/clients/client-service-catalog/pagination/ListConstraintsForPortfolioPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListConstraintsForPortfolioCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConstraintsForPortfolioCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListConstraintsForPortfolioCommandInput, diff --git a/clients/client-service-catalog/pagination/ListLaunchPathsPaginator.ts b/clients/client-service-catalog/pagination/ListLaunchPathsPaginator.ts index b96f3d5390ea7..a96d6550adef9 100644 --- a/clients/client-service-catalog/pagination/ListLaunchPathsPaginator.ts +++ b/clients/client-service-catalog/pagination/ListLaunchPathsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListLaunchPathsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLaunchPathsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListLaunchPathsCommandInput, diff --git a/clients/client-service-catalog/pagination/ListOrganizationPortfolioAccessPaginator.ts b/clients/client-service-catalog/pagination/ListOrganizationPortfolioAccessPaginator.ts index 8aa552403cf28..453b75688069b 100644 --- a/clients/client-service-catalog/pagination/ListOrganizationPortfolioAccessPaginator.ts +++ b/clients/client-service-catalog/pagination/ListOrganizationPortfolioAccessPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListOrganizationPortfolioAccessCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOrganizationPortfolioAccessCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListOrganizationPortfolioAccessCommandInput, diff --git a/clients/client-service-catalog/pagination/ListPortfolioAccessPaginator.ts b/clients/client-service-catalog/pagination/ListPortfolioAccessPaginator.ts index a87ed93b0bb7c..f53d30271a473 100644 --- a/clients/client-service-catalog/pagination/ListPortfolioAccessPaginator.ts +++ b/clients/client-service-catalog/pagination/ListPortfolioAccessPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListPortfolioAccessCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPortfolioAccessCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListPortfolioAccessCommandInput, diff --git a/clients/client-service-catalog/pagination/ListPortfoliosForProductPaginator.ts b/clients/client-service-catalog/pagination/ListPortfoliosForProductPaginator.ts index 4140b1bdc5990..943b2083bc061 100644 --- a/clients/client-service-catalog/pagination/ListPortfoliosForProductPaginator.ts +++ b/clients/client-service-catalog/pagination/ListPortfoliosForProductPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListPortfoliosForProductCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPortfoliosForProductCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListPortfoliosForProductCommandInput, diff --git a/clients/client-service-catalog/pagination/ListPortfoliosPaginator.ts b/clients/client-service-catalog/pagination/ListPortfoliosPaginator.ts index 538b99517b7dc..6e536e22414a1 100644 --- a/clients/client-service-catalog/pagination/ListPortfoliosPaginator.ts +++ b/clients/client-service-catalog/pagination/ListPortfoliosPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListPortfoliosCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPortfoliosCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListPortfoliosCommandInput, diff --git a/clients/client-service-catalog/pagination/ListPrincipalsForPortfolioPaginator.ts b/clients/client-service-catalog/pagination/ListPrincipalsForPortfolioPaginator.ts index 2afe057324cdf..5b81917336f33 100644 --- a/clients/client-service-catalog/pagination/ListPrincipalsForPortfolioPaginator.ts +++ b/clients/client-service-catalog/pagination/ListPrincipalsForPortfolioPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListPrincipalsForPortfolioCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPrincipalsForPortfolioCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListPrincipalsForPortfolioCommandInput, diff --git a/clients/client-service-catalog/pagination/ListProvisioningArtifactsForServiceActionPaginator.ts b/clients/client-service-catalog/pagination/ListProvisioningArtifactsForServiceActionPaginator.ts index b86699dfcbf37..97d637ad8c444 100644 --- a/clients/client-service-catalog/pagination/ListProvisioningArtifactsForServiceActionPaginator.ts +++ b/clients/client-service-catalog/pagination/ListProvisioningArtifactsForServiceActionPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListProvisioningArtifactsForServiceActionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProvisioningArtifactsForServiceActionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListProvisioningArtifactsForServiceActionCommandInput, diff --git a/clients/client-service-catalog/pagination/ListResourcesForTagOptionPaginator.ts b/clients/client-service-catalog/pagination/ListResourcesForTagOptionPaginator.ts index 025c87e99ee94..a89ce45251b43 100644 --- a/clients/client-service-catalog/pagination/ListResourcesForTagOptionPaginator.ts +++ b/clients/client-service-catalog/pagination/ListResourcesForTagOptionPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListResourcesForTagOptionCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourcesForTagOptionCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListResourcesForTagOptionCommandInput, diff --git a/clients/client-service-catalog/pagination/ListServiceActionsForProvisioningArtifactPaginator.ts b/clients/client-service-catalog/pagination/ListServiceActionsForProvisioningArtifactPaginator.ts index 57a6a92adf302..373b48fdc4248 100644 --- a/clients/client-service-catalog/pagination/ListServiceActionsForProvisioningArtifactPaginator.ts +++ b/clients/client-service-catalog/pagination/ListServiceActionsForProvisioningArtifactPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListServiceActionsForProvisioningArtifactCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServiceActionsForProvisioningArtifactCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListServiceActionsForProvisioningArtifactCommandInput, diff --git a/clients/client-service-catalog/pagination/ListServiceActionsPaginator.ts b/clients/client-service-catalog/pagination/ListServiceActionsPaginator.ts index 483c95468185c..2c6e3ef254a9a 100644 --- a/clients/client-service-catalog/pagination/ListServiceActionsPaginator.ts +++ b/clients/client-service-catalog/pagination/ListServiceActionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListServiceActionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServiceActionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListServiceActionsCommandInput, diff --git a/clients/client-service-catalog/pagination/ListTagOptionsPaginator.ts b/clients/client-service-catalog/pagination/ListTagOptionsPaginator.ts index a4eb92b513bc0..12fdc22e83a92 100644 --- a/clients/client-service-catalog/pagination/ListTagOptionsPaginator.ts +++ b/clients/client-service-catalog/pagination/ListTagOptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: ListTagOptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagOptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: ListTagOptionsCommandInput, diff --git a/clients/client-service-catalog/pagination/SearchProductsAsAdminPaginator.ts b/clients/client-service-catalog/pagination/SearchProductsAsAdminPaginator.ts index f828ce51ea5c4..9cd6e4c398064 100644 --- a/clients/client-service-catalog/pagination/SearchProductsAsAdminPaginator.ts +++ b/clients/client-service-catalog/pagination/SearchProductsAsAdminPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: SearchProductsAsAdminCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchProductsAsAdminCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: SearchProductsAsAdminCommandInput, diff --git a/clients/client-service-catalog/pagination/SearchProductsPaginator.ts b/clients/client-service-catalog/pagination/SearchProductsPaginator.ts index fb477638d8542..3a56ecdfc5bef 100644 --- a/clients/client-service-catalog/pagination/SearchProductsPaginator.ts +++ b/clients/client-service-catalog/pagination/SearchProductsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: SearchProductsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchProductsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: SearchProductsCommandInput, diff --git a/clients/client-service-catalog/pagination/SearchProvisionedProductsPaginator.ts b/clients/client-service-catalog/pagination/SearchProvisionedProductsPaginator.ts index d31a24ece738a..c23778614b3f9 100644 --- a/clients/client-service-catalog/pagination/SearchProvisionedProductsPaginator.ts +++ b/clients/client-service-catalog/pagination/SearchProvisionedProductsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceCatalogPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceCatalogClient, input: SearchProvisionedProductsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new SearchProvisionedProductsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceCatalog, input: SearchProvisionedProductsCommandInput, diff --git a/clients/client-service-catalog/runtimeConfig.browser.ts b/clients/client-service-catalog/runtimeConfig.browser.ts index 71760089cae1a..d09447087e46c 100644 --- a/clients/client-service-catalog/runtimeConfig.browser.ts +++ b/clients/client-service-catalog/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ServiceCatalogClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-service-catalog/runtimeConfig.native.ts b/clients/client-service-catalog/runtimeConfig.native.ts index 534d26cc1bb1c..64f4d2e33b09c 100644 --- a/clients/client-service-catalog/runtimeConfig.native.ts +++ b/clients/client-service-catalog/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ServiceCatalogClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-service-catalog/runtimeConfig.shared.ts b/clients/client-service-catalog/runtimeConfig.shared.ts index 54c682e93bd88..4ab746fd1c392 100644 --- a/clients/client-service-catalog/runtimeConfig.shared.ts +++ b/clients/client-service-catalog/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-12-10", disableHostPrefix: false, diff --git a/clients/client-service-catalog/runtimeConfig.ts b/clients/client-service-catalog/runtimeConfig.ts index e6a80f536b2b7..9d47538a9ce3a 100644 --- a/clients/client-service-catalog/runtimeConfig.ts +++ b/clients/client-service-catalog/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ServiceCatalogClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-service-catalog/tsconfig.json b/clients/client-service-catalog/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-service-catalog/tsconfig.json +++ b/clients/client-service-catalog/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-service-quotas/commands/AssociateServiceQuotaTemplateCommand.ts b/clients/client-service-quotas/commands/AssociateServiceQuotaTemplateCommand.ts index 65d4d5169af67..6790608f820a7 100644 --- a/clients/client-service-quotas/commands/AssociateServiceQuotaTemplateCommand.ts +++ b/clients/client-service-quotas/commands/AssociateServiceQuotaTemplateCommand.ts @@ -20,6 +20,13 @@ import { export type AssociateServiceQuotaTemplateCommandInput = AssociateServiceQuotaTemplateRequest; export type AssociateServiceQuotaTemplateCommandOutput = AssociateServiceQuotaTemplateResponse & __MetadataBearer; +/** + *

Associates the Service Quotas template with your organization so that when new accounts + * are created in your organization, the template submits increase requests for the specified + * service quotas. Use the Service Quotas template to request an increase for any adjustable + * quota value. After you define the Service Quotas template, use this operation to associate, or + * enable, the template.

+ */ export class AssociateServiceQuotaTemplateCommand extends $Command< AssociateServiceQuotaTemplateCommandInput, AssociateServiceQuotaTemplateCommandOutput, @@ -34,6 +41,9 @@ export class AssociateServiceQuotaTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/DeleteServiceQuotaIncreaseRequestFromTemplateCommand.ts b/clients/client-service-quotas/commands/DeleteServiceQuotaIncreaseRequestFromTemplateCommand.ts index 064f31ecc8078..4adc161dfccd8 100644 --- a/clients/client-service-quotas/commands/DeleteServiceQuotaIncreaseRequestFromTemplateCommand.ts +++ b/clients/client-service-quotas/commands/DeleteServiceQuotaIncreaseRequestFromTemplateCommand.ts @@ -24,6 +24,9 @@ export type DeleteServiceQuotaIncreaseRequestFromTemplateCommandInput = DeleteSe export type DeleteServiceQuotaIncreaseRequestFromTemplateCommandOutput = DeleteServiceQuotaIncreaseRequestFromTemplateResponse & __MetadataBearer; +/** + *

Removes a service quota increase request from the Service Quotas template.

+ */ export class DeleteServiceQuotaIncreaseRequestFromTemplateCommand extends $Command< DeleteServiceQuotaIncreaseRequestFromTemplateCommandInput, DeleteServiceQuotaIncreaseRequestFromTemplateCommandOutput, @@ -38,6 +41,9 @@ export class DeleteServiceQuotaIncreaseRequestFromTemplateCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/DisassociateServiceQuotaTemplateCommand.ts b/clients/client-service-quotas/commands/DisassociateServiceQuotaTemplateCommand.ts index e7547f681fe61..746afb16cde39 100644 --- a/clients/client-service-quotas/commands/DisassociateServiceQuotaTemplateCommand.ts +++ b/clients/client-service-quotas/commands/DisassociateServiceQuotaTemplateCommand.ts @@ -20,6 +20,24 @@ import { export type DisassociateServiceQuotaTemplateCommandInput = DisassociateServiceQuotaTemplateRequest; export type DisassociateServiceQuotaTemplateCommandOutput = DisassociateServiceQuotaTemplateResponse & __MetadataBearer; +/** + *

Disables the Service Quotas template. Once the template is disabled, it does not request + * quota increases for new accounts in your organization. Disabling the quota template does not + * apply the quota increase requests from the template.

+ * + *

+ * Related operations + *

+ * + */ export class DisassociateServiceQuotaTemplateCommand extends $Command< DisassociateServiceQuotaTemplateCommandInput, DisassociateServiceQuotaTemplateCommandOutput, @@ -34,6 +52,9 @@ export class DisassociateServiceQuotaTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/GetAWSDefaultServiceQuotaCommand.ts b/clients/client-service-quotas/commands/GetAWSDefaultServiceQuotaCommand.ts index f8e3eb959c98f..9c4614bce9d60 100644 --- a/clients/client-service-quotas/commands/GetAWSDefaultServiceQuotaCommand.ts +++ b/clients/client-service-quotas/commands/GetAWSDefaultServiceQuotaCommand.ts @@ -20,6 +20,10 @@ import { export type GetAWSDefaultServiceQuotaCommandInput = GetAWSDefaultServiceQuotaRequest; export type GetAWSDefaultServiceQuotaCommandOutput = GetAWSDefaultServiceQuotaResponse & __MetadataBearer; +/** + *

Retrieves the default service quotas values. The Value returned for each quota is the AWS + * default value, even if the quotas have been increased..

+ */ export class GetAWSDefaultServiceQuotaCommand extends $Command< GetAWSDefaultServiceQuotaCommandInput, GetAWSDefaultServiceQuotaCommandOutput, @@ -34,6 +38,9 @@ export class GetAWSDefaultServiceQuotaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/GetAssociationForServiceQuotaTemplateCommand.ts b/clients/client-service-quotas/commands/GetAssociationForServiceQuotaTemplateCommand.ts index 3c5e9bb710971..21ff39aef3eb9 100644 --- a/clients/client-service-quotas/commands/GetAssociationForServiceQuotaTemplateCommand.ts +++ b/clients/client-service-quotas/commands/GetAssociationForServiceQuotaTemplateCommand.ts @@ -24,6 +24,10 @@ export type GetAssociationForServiceQuotaTemplateCommandInput = GetAssociationFo export type GetAssociationForServiceQuotaTemplateCommandOutput = GetAssociationForServiceQuotaTemplateResponse & __MetadataBearer; +/** + *

Retrieves the ServiceQuotaTemplateAssociationStatus value from the service. + * Use this action to determine if the Service Quota template is associated, or enabled.

+ */ export class GetAssociationForServiceQuotaTemplateCommand extends $Command< GetAssociationForServiceQuotaTemplateCommandInput, GetAssociationForServiceQuotaTemplateCommandOutput, @@ -38,6 +42,9 @@ export class GetAssociationForServiceQuotaTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/GetRequestedServiceQuotaChangeCommand.ts b/clients/client-service-quotas/commands/GetRequestedServiceQuotaChangeCommand.ts index 2aa80bf3c8afa..a28b54d5797a0 100644 --- a/clients/client-service-quotas/commands/GetRequestedServiceQuotaChangeCommand.ts +++ b/clients/client-service-quotas/commands/GetRequestedServiceQuotaChangeCommand.ts @@ -20,6 +20,9 @@ import { export type GetRequestedServiceQuotaChangeCommandInput = GetRequestedServiceQuotaChangeRequest; export type GetRequestedServiceQuotaChangeCommandOutput = GetRequestedServiceQuotaChangeResponse & __MetadataBearer; +/** + *

Retrieves the details for a particular increase request.

+ */ export class GetRequestedServiceQuotaChangeCommand extends $Command< GetRequestedServiceQuotaChangeCommandInput, GetRequestedServiceQuotaChangeCommandOutput, @@ -34,6 +37,9 @@ export class GetRequestedServiceQuotaChangeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/GetServiceQuotaCommand.ts b/clients/client-service-quotas/commands/GetServiceQuotaCommand.ts index 9bb62c66a6794..5cd8fb8095696 100644 --- a/clients/client-service-quotas/commands/GetServiceQuotaCommand.ts +++ b/clients/client-service-quotas/commands/GetServiceQuotaCommand.ts @@ -20,6 +20,12 @@ import { export type GetServiceQuotaCommandInput = GetServiceQuotaRequest; export type GetServiceQuotaCommandOutput = GetServiceQuotaResponse & __MetadataBearer; +/** + *

Returns the details for the specified service quota. This operation provides a different + * Value than the GetAWSDefaultServiceQuota operation. This operation returns the + * applied value for each quota. GetAWSDefaultServiceQuota returns the default AWS + * value for each quota.

+ */ export class GetServiceQuotaCommand extends $Command< GetServiceQuotaCommandInput, GetServiceQuotaCommandOutput, @@ -34,6 +40,9 @@ export class GetServiceQuotaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/GetServiceQuotaIncreaseRequestFromTemplateCommand.ts b/clients/client-service-quotas/commands/GetServiceQuotaIncreaseRequestFromTemplateCommand.ts index c7c8c9482f0b7..3693e7ef6885d 100644 --- a/clients/client-service-quotas/commands/GetServiceQuotaIncreaseRequestFromTemplateCommand.ts +++ b/clients/client-service-quotas/commands/GetServiceQuotaIncreaseRequestFromTemplateCommand.ts @@ -24,6 +24,9 @@ export type GetServiceQuotaIncreaseRequestFromTemplateCommandInput = GetServiceQ export type GetServiceQuotaIncreaseRequestFromTemplateCommandOutput = GetServiceQuotaIncreaseRequestFromTemplateResponse & __MetadataBearer; +/** + *

Returns the details of the service quota increase request in your template.

+ */ export class GetServiceQuotaIncreaseRequestFromTemplateCommand extends $Command< GetServiceQuotaIncreaseRequestFromTemplateCommandInput, GetServiceQuotaIncreaseRequestFromTemplateCommandOutput, @@ -38,6 +41,9 @@ export class GetServiceQuotaIncreaseRequestFromTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/ListAWSDefaultServiceQuotasCommand.ts b/clients/client-service-quotas/commands/ListAWSDefaultServiceQuotasCommand.ts index 350a8d9d32505..22dffe8d5259c 100644 --- a/clients/client-service-quotas/commands/ListAWSDefaultServiceQuotasCommand.ts +++ b/clients/client-service-quotas/commands/ListAWSDefaultServiceQuotasCommand.ts @@ -20,6 +20,21 @@ import { export type ListAWSDefaultServiceQuotasCommandInput = ListAWSDefaultServiceQuotasRequest; export type ListAWSDefaultServiceQuotasCommandOutput = ListAWSDefaultServiceQuotasResponse & __MetadataBearer; +/** + *

Lists all default service quotas for the specified AWS service or all AWS services. + * ListAWSDefaultServiceQuotas is similar to ListServiceQuotas except for the + * Value object. The Value object returned by ListAWSDefaultServiceQuotas is the + * default value assigned by AWS. This request returns a list of all service quotas for the + * specified service. The listing of each you'll see the default values are the values that AWS + * provides for the quotas.

+ * + *

Always check the NextToken response parameter when calling any of the + * List* operations. These operations can return an unexpected list of results, + * even when there are more results available. When this happens, the NextToken + * response parameter contains a value to pass the next call to the same API to request the + * next part of the list.

+ *
+ */ export class ListAWSDefaultServiceQuotasCommand extends $Command< ListAWSDefaultServiceQuotasCommandInput, ListAWSDefaultServiceQuotasCommandOutput, @@ -34,6 +49,9 @@ export class ListAWSDefaultServiceQuotasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/ListRequestedServiceQuotaChangeHistoryByQuotaCommand.ts b/clients/client-service-quotas/commands/ListRequestedServiceQuotaChangeHistoryByQuotaCommand.ts index 193e07d323dfd..1c76f43229e21 100644 --- a/clients/client-service-quotas/commands/ListRequestedServiceQuotaChangeHistoryByQuotaCommand.ts +++ b/clients/client-service-quotas/commands/ListRequestedServiceQuotaChangeHistoryByQuotaCommand.ts @@ -24,6 +24,12 @@ export type ListRequestedServiceQuotaChangeHistoryByQuotaCommandInput = ListRequ export type ListRequestedServiceQuotaChangeHistoryByQuotaCommandOutput = ListRequestedServiceQuotaChangeHistoryByQuotaResponse & __MetadataBearer; +/** + *

Requests a list of the changes to specific service quotas. This command provides + * additional granularity over the ListRequestedServiceQuotaChangeHistory command. + * Once a quota change request has reached CASE_CLOSED, APPROVED, or + * DENIED, the history has been kept for 90 days.

+ */ export class ListRequestedServiceQuotaChangeHistoryByQuotaCommand extends $Command< ListRequestedServiceQuotaChangeHistoryByQuotaCommandInput, ListRequestedServiceQuotaChangeHistoryByQuotaCommandOutput, @@ -38,6 +44,9 @@ export class ListRequestedServiceQuotaChangeHistoryByQuotaCommand extends $Comma // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/ListRequestedServiceQuotaChangeHistoryCommand.ts b/clients/client-service-quotas/commands/ListRequestedServiceQuotaChangeHistoryCommand.ts index 3c8d70ea86a44..535f5f4916342 100644 --- a/clients/client-service-quotas/commands/ListRequestedServiceQuotaChangeHistoryCommand.ts +++ b/clients/client-service-quotas/commands/ListRequestedServiceQuotaChangeHistoryCommand.ts @@ -24,6 +24,9 @@ export type ListRequestedServiceQuotaChangeHistoryCommandInput = ListRequestedSe export type ListRequestedServiceQuotaChangeHistoryCommandOutput = ListRequestedServiceQuotaChangeHistoryResponse & __MetadataBearer; +/** + *

Requests a list of the changes to quotas for a service.

+ */ export class ListRequestedServiceQuotaChangeHistoryCommand extends $Command< ListRequestedServiceQuotaChangeHistoryCommandInput, ListRequestedServiceQuotaChangeHistoryCommandOutput, @@ -38,6 +41,9 @@ export class ListRequestedServiceQuotaChangeHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/ListServiceQuotaIncreaseRequestsInTemplateCommand.ts b/clients/client-service-quotas/commands/ListServiceQuotaIncreaseRequestsInTemplateCommand.ts index fd769e208445d..cdc91441ed85d 100644 --- a/clients/client-service-quotas/commands/ListServiceQuotaIncreaseRequestsInTemplateCommand.ts +++ b/clients/client-service-quotas/commands/ListServiceQuotaIncreaseRequestsInTemplateCommand.ts @@ -24,6 +24,9 @@ export type ListServiceQuotaIncreaseRequestsInTemplateCommandInput = ListService export type ListServiceQuotaIncreaseRequestsInTemplateCommandOutput = ListServiceQuotaIncreaseRequestsInTemplateResponse & __MetadataBearer; +/** + *

Returns a list of the quota increase requests in the template.

+ */ export class ListServiceQuotaIncreaseRequestsInTemplateCommand extends $Command< ListServiceQuotaIncreaseRequestsInTemplateCommandInput, ListServiceQuotaIncreaseRequestsInTemplateCommandOutput, @@ -38,6 +41,9 @@ export class ListServiceQuotaIncreaseRequestsInTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/ListServiceQuotasCommand.ts b/clients/client-service-quotas/commands/ListServiceQuotasCommand.ts index 93b7b4e3c594c..8b974c6559194 100644 --- a/clients/client-service-quotas/commands/ListServiceQuotasCommand.ts +++ b/clients/client-service-quotas/commands/ListServiceQuotasCommand.ts @@ -20,6 +20,18 @@ import { export type ListServiceQuotasCommandInput = ListServiceQuotasRequest; export type ListServiceQuotasCommandOutput = ListServiceQuotasResponse & __MetadataBearer; +/** + *

Lists all service quotas for the specified AWS service. This request returns a list of the + * service quotas for the specified service. you'll see the default values are the values that + * AWS provides for the quotas.

+ * + *

Always check the NextToken response parameter when calling any of the + * List* operations. These operations can return an unexpected list of results, + * even when there are more results available. When this happens, the NextToken + * response parameter contains a value to pass the next call to the same API to request the + * next part of the list.

+ *
+ */ export class ListServiceQuotasCommand extends $Command< ListServiceQuotasCommandInput, ListServiceQuotasCommandOutput, @@ -34,6 +46,9 @@ export class ListServiceQuotasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/ListServicesCommand.ts b/clients/client-service-quotas/commands/ListServicesCommand.ts index 51da2b9a4cf64..29f9fa99959d1 100644 --- a/clients/client-service-quotas/commands/ListServicesCommand.ts +++ b/clients/client-service-quotas/commands/ListServicesCommand.ts @@ -20,6 +20,11 @@ import { export type ListServicesCommandInput = ListServicesRequest; export type ListServicesCommandOutput = ListServicesResponse & __MetadataBearer; +/** + *

Lists the AWS services available in Service Quotas. Not all AWS services are available in + * Service Quotas. To list the see the list of the service quotas for a specific service, use + * ListServiceQuotas.

+ */ export class ListServicesCommand extends $Command< ListServicesCommandInput, ListServicesCommandOutput, @@ -34,6 +39,9 @@ export class ListServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/PutServiceQuotaIncreaseRequestIntoTemplateCommand.ts b/clients/client-service-quotas/commands/PutServiceQuotaIncreaseRequestIntoTemplateCommand.ts index c2960259cd9dd..4c9fa64970585 100644 --- a/clients/client-service-quotas/commands/PutServiceQuotaIncreaseRequestIntoTemplateCommand.ts +++ b/clients/client-service-quotas/commands/PutServiceQuotaIncreaseRequestIntoTemplateCommand.ts @@ -24,6 +24,12 @@ export type PutServiceQuotaIncreaseRequestIntoTemplateCommandInput = PutServiceQ export type PutServiceQuotaIncreaseRequestIntoTemplateCommandOutput = PutServiceQuotaIncreaseRequestIntoTemplateResponse & __MetadataBearer; +/** + *

Defines and adds a quota to the service quota template. To add a quota to the template, + * you must provide the ServiceCode, QuotaCode, AwsRegion, + * and DesiredValue. Once you add a quota to the template, use ListServiceQuotaIncreaseRequestsInTemplate to see the list of quotas in the + * template.

+ */ export class PutServiceQuotaIncreaseRequestIntoTemplateCommand extends $Command< PutServiceQuotaIncreaseRequestIntoTemplateCommandInput, PutServiceQuotaIncreaseRequestIntoTemplateCommandOutput, @@ -38,6 +44,9 @@ export class PutServiceQuotaIncreaseRequestIntoTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/commands/RequestServiceQuotaIncreaseCommand.ts b/clients/client-service-quotas/commands/RequestServiceQuotaIncreaseCommand.ts index aca9409694969..db3f6ed1cba46 100644 --- a/clients/client-service-quotas/commands/RequestServiceQuotaIncreaseCommand.ts +++ b/clients/client-service-quotas/commands/RequestServiceQuotaIncreaseCommand.ts @@ -20,6 +20,10 @@ import { export type RequestServiceQuotaIncreaseCommandInput = RequestServiceQuotaIncreaseRequest; export type RequestServiceQuotaIncreaseCommandOutput = RequestServiceQuotaIncreaseResponse & __MetadataBearer; +/** + *

Retrieves the details of a service quota increase request. The response to this command + * provides the details in the RequestedServiceQuotaChange object.

+ */ export class RequestServiceQuotaIncreaseCommand extends $Command< RequestServiceQuotaIncreaseCommandInput, RequestServiceQuotaIncreaseCommandOutput, @@ -34,6 +38,9 @@ export class RequestServiceQuotaIncreaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceQuotasClientResolvedConfig, diff --git a/clients/client-service-quotas/package.json b/clients/client-service-quotas/package.json index ea2939882d799..3fe87d9cb00d8 100644 --- a/clients/client-service-quotas/package.json +++ b/clients/client-service-quotas/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Service Quotas Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-service-quotas/pagination/ListAWSDefaultServiceQuotasPaginator.ts b/clients/client-service-quotas/pagination/ListAWSDefaultServiceQuotasPaginator.ts index 0fc29573c7000..66053b9d01a7d 100644 --- a/clients/client-service-quotas/pagination/ListAWSDefaultServiceQuotasPaginator.ts +++ b/clients/client-service-quotas/pagination/ListAWSDefaultServiceQuotasPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceQuotasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceQuotasClient, input: ListAWSDefaultServiceQuotasCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAWSDefaultServiceQuotasCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceQuotas, input: ListAWSDefaultServiceQuotasCommandInput, diff --git a/clients/client-service-quotas/pagination/ListRequestedServiceQuotaChangeHistoryByQuotaPaginator.ts b/clients/client-service-quotas/pagination/ListRequestedServiceQuotaChangeHistoryByQuotaPaginator.ts index 676f6d63ac52b..2e2bf968ae762 100644 --- a/clients/client-service-quotas/pagination/ListRequestedServiceQuotaChangeHistoryByQuotaPaginator.ts +++ b/clients/client-service-quotas/pagination/ListRequestedServiceQuotaChangeHistoryByQuotaPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceQuotasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceQuotasClient, input: ListRequestedServiceQuotaChangeHistoryByQuotaCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRequestedServiceQuotaChangeHistoryByQuotaCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceQuotas, input: ListRequestedServiceQuotaChangeHistoryByQuotaCommandInput, diff --git a/clients/client-service-quotas/pagination/ListRequestedServiceQuotaChangeHistoryPaginator.ts b/clients/client-service-quotas/pagination/ListRequestedServiceQuotaChangeHistoryPaginator.ts index 3d442cdf81b1f..c313e2ba1875c 100644 --- a/clients/client-service-quotas/pagination/ListRequestedServiceQuotaChangeHistoryPaginator.ts +++ b/clients/client-service-quotas/pagination/ListRequestedServiceQuotaChangeHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceQuotasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceQuotasClient, input: ListRequestedServiceQuotaChangeHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListRequestedServiceQuotaChangeHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceQuotas, input: ListRequestedServiceQuotaChangeHistoryCommandInput, diff --git a/clients/client-service-quotas/pagination/ListServiceQuotaIncreaseRequestsInTemplatePaginator.ts b/clients/client-service-quotas/pagination/ListServiceQuotaIncreaseRequestsInTemplatePaginator.ts index 78846872f505f..c1b41fcb6fb49 100644 --- a/clients/client-service-quotas/pagination/ListServiceQuotaIncreaseRequestsInTemplatePaginator.ts +++ b/clients/client-service-quotas/pagination/ListServiceQuotaIncreaseRequestsInTemplatePaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceQuotasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceQuotasClient, input: ListServiceQuotaIncreaseRequestsInTemplateCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServiceQuotaIncreaseRequestsInTemplateCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceQuotas, input: ListServiceQuotaIncreaseRequestsInTemplateCommandInput, diff --git a/clients/client-service-quotas/pagination/ListServiceQuotasPaginator.ts b/clients/client-service-quotas/pagination/ListServiceQuotasPaginator.ts index e82d52eb5b9bd..c85da35649a0c 100644 --- a/clients/client-service-quotas/pagination/ListServiceQuotasPaginator.ts +++ b/clients/client-service-quotas/pagination/ListServiceQuotasPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceQuotasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceQuotasClient, input: ListServiceQuotasCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServiceQuotasCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceQuotas, input: ListServiceQuotasCommandInput, diff --git a/clients/client-service-quotas/pagination/ListServicesPaginator.ts b/clients/client-service-quotas/pagination/ListServicesPaginator.ts index 0e800dec9104f..c98e44184bd36 100644 --- a/clients/client-service-quotas/pagination/ListServicesPaginator.ts +++ b/clients/client-service-quotas/pagination/ListServicesPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceQuotasPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceQuotasClient, input: ListServicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceQuotas, input: ListServicesCommandInput, diff --git a/clients/client-service-quotas/runtimeConfig.browser.ts b/clients/client-service-quotas/runtimeConfig.browser.ts index 34610f7181b1c..5a7f22af89cd6 100644 --- a/clients/client-service-quotas/runtimeConfig.browser.ts +++ b/clients/client-service-quotas/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ServiceQuotasClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-service-quotas/runtimeConfig.native.ts b/clients/client-service-quotas/runtimeConfig.native.ts index fdfe32dd486b7..30fe2aecdc136 100644 --- a/clients/client-service-quotas/runtimeConfig.native.ts +++ b/clients/client-service-quotas/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ServiceQuotasClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-service-quotas/runtimeConfig.shared.ts b/clients/client-service-quotas/runtimeConfig.shared.ts index e25cbcf1bb8f6..485229b5fabf1 100644 --- a/clients/client-service-quotas/runtimeConfig.shared.ts +++ b/clients/client-service-quotas/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-06-24", disableHostPrefix: false, diff --git a/clients/client-service-quotas/runtimeConfig.ts b/clients/client-service-quotas/runtimeConfig.ts index b2d2a73314000..91e9eefda9741 100644 --- a/clients/client-service-quotas/runtimeConfig.ts +++ b/clients/client-service-quotas/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ServiceQuotasClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-service-quotas/tsconfig.json b/clients/client-service-quotas/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-service-quotas/tsconfig.json +++ b/clients/client-service-quotas/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-servicediscovery/commands/CreateHttpNamespaceCommand.ts b/clients/client-servicediscovery/commands/CreateHttpNamespaceCommand.ts index 32636f0aca09d..0a75a2e537825 100644 --- a/clients/client-servicediscovery/commands/CreateHttpNamespaceCommand.ts +++ b/clients/client-servicediscovery/commands/CreateHttpNamespaceCommand.ts @@ -20,6 +20,12 @@ import { export type CreateHttpNamespaceCommandInput = CreateHttpNamespaceRequest; export type CreateHttpNamespaceCommandOutput = CreateHttpNamespaceResponse & __MetadataBearer; +/** + *

Creates an HTTP namespace. Service instances that you register using an HTTP namespace can be discovered using a + * DiscoverInstances request but can't be discovered using DNS.

+ *

For the current quota on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map quotas in the + * AWS Cloud Map Developer Guide.

+ */ export class CreateHttpNamespaceCommand extends $Command< CreateHttpNamespaceCommandInput, CreateHttpNamespaceCommandOutput, @@ -34,6 +40,9 @@ export class CreateHttpNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/CreatePrivateDnsNamespaceCommand.ts b/clients/client-servicediscovery/commands/CreatePrivateDnsNamespaceCommand.ts index a59a5174002b4..07063dd622188 100644 --- a/clients/client-servicediscovery/commands/CreatePrivateDnsNamespaceCommand.ts +++ b/clients/client-servicediscovery/commands/CreatePrivateDnsNamespaceCommand.ts @@ -20,6 +20,14 @@ import { export type CreatePrivateDnsNamespaceCommandInput = CreatePrivateDnsNamespaceRequest; export type CreatePrivateDnsNamespaceCommandOutput = CreatePrivateDnsNamespaceResponse & __MetadataBearer; +/** + *

Creates a private namespace based on DNS, which will be visible only inside a specified Amazon VPC. The + * namespace defines your service naming scheme. For example, if you name your namespace example.com and + * name your service backend, the resulting DNS name for the service will be + * backend.example.com. For the current quota on the number of namespaces that you can create using the + * same AWS account, see AWS Cloud Map + * Limits in the AWS Cloud Map Developer Guide.

+ */ export class CreatePrivateDnsNamespaceCommand extends $Command< CreatePrivateDnsNamespaceCommandInput, CreatePrivateDnsNamespaceCommandOutput, @@ -34,6 +42,9 @@ export class CreatePrivateDnsNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/CreatePublicDnsNamespaceCommand.ts b/clients/client-servicediscovery/commands/CreatePublicDnsNamespaceCommand.ts index 984b2c70c4c7e..a2e71363ea9f6 100644 --- a/clients/client-servicediscovery/commands/CreatePublicDnsNamespaceCommand.ts +++ b/clients/client-servicediscovery/commands/CreatePublicDnsNamespaceCommand.ts @@ -20,6 +20,13 @@ import { export type CreatePublicDnsNamespaceCommandInput = CreatePublicDnsNamespaceRequest; export type CreatePublicDnsNamespaceCommandOutput = CreatePublicDnsNamespaceResponse & __MetadataBearer; +/** + *

Creates a public namespace based on DNS, which will be visible on the internet. The namespace defines your + * service naming scheme. For example, if you name your namespace example.com and name your service + * backend, the resulting DNS name for the service will be backend.example.com. For the + * current quota on the number of namespaces that you can create using the same AWS account, see AWS Cloud Map Limits in the + * AWS Cloud Map Developer Guide.

+ */ export class CreatePublicDnsNamespaceCommand extends $Command< CreatePublicDnsNamespaceCommandInput, CreatePublicDnsNamespaceCommandOutput, @@ -34,6 +41,9 @@ export class CreatePublicDnsNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/CreateServiceCommand.ts b/clients/client-servicediscovery/commands/CreateServiceCommand.ts index 46d1d0384c93c..1fa34288c6023 100644 --- a/clients/client-servicediscovery/commands/CreateServiceCommand.ts +++ b/clients/client-servicediscovery/commands/CreateServiceCommand.ts @@ -20,6 +20,49 @@ import { export type CreateServiceCommandInput = CreateServiceRequest; export type CreateServiceCommandOutput = CreateServiceResponse & __MetadataBearer; +/** + *

Creates a service, which defines the configuration for the following entities:

+ *
    + *
  • + *

    For public and private DNS namespaces, one of the following combinations of DNS records in Amazon Route 53:

    + *
      + *
    • + *

      + * A + *

      + *
    • + *
    • + *

      + * AAAA + *

      + *
    • + *
    • + *

      + * A and AAAA + *

      + *
    • + *
    • + *

      + * SRV + *

      + *
    • + *
    • + *

      + * CNAME + *

      + *
    • + *
    + *
  • + *
  • + *

    Optionally, a health check

    + *
  • + *
+ *

After you create the service, you can submit a RegisterInstance request, and AWS Cloud Map uses the + * values in the configuration to create the specified entities.

+ *

For the current quota on the number of instances that you can register using the same namespace and using the + * same service, see AWS Cloud Map + * Limits in the AWS Cloud Map Developer Guide.

+ */ export class CreateServiceCommand extends $Command< CreateServiceCommandInput, CreateServiceCommandOutput, @@ -34,6 +77,9 @@ export class CreateServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/DeleteNamespaceCommand.ts b/clients/client-servicediscovery/commands/DeleteNamespaceCommand.ts index 48d615161a06c..47593da56e1fc 100644 --- a/clients/client-servicediscovery/commands/DeleteNamespaceCommand.ts +++ b/clients/client-servicediscovery/commands/DeleteNamespaceCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteNamespaceCommandInput = DeleteNamespaceRequest; export type DeleteNamespaceCommandOutput = DeleteNamespaceResponse & __MetadataBearer; +/** + *

Deletes a namespace from the current account. If the namespace still contains one or more services, the request + * fails.

+ */ export class DeleteNamespaceCommand extends $Command< DeleteNamespaceCommandInput, DeleteNamespaceCommandOutput, @@ -34,6 +38,9 @@ export class DeleteNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/DeleteServiceCommand.ts b/clients/client-servicediscovery/commands/DeleteServiceCommand.ts index 15fae6f4cc9de..c1fe34214f87c 100644 --- a/clients/client-servicediscovery/commands/DeleteServiceCommand.ts +++ b/clients/client-servicediscovery/commands/DeleteServiceCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteServiceCommandInput = DeleteServiceRequest; export type DeleteServiceCommandOutput = DeleteServiceResponse & __MetadataBearer; +/** + *

Deletes a specified service. If the service still contains one or more registered instances, the request + * fails.

+ */ export class DeleteServiceCommand extends $Command< DeleteServiceCommandInput, DeleteServiceCommandOutput, @@ -34,6 +38,9 @@ export class DeleteServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/DeregisterInstanceCommand.ts b/clients/client-servicediscovery/commands/DeregisterInstanceCommand.ts index 96e0b260cdb7b..d222100389b18 100644 --- a/clients/client-servicediscovery/commands/DeregisterInstanceCommand.ts +++ b/clients/client-servicediscovery/commands/DeregisterInstanceCommand.ts @@ -20,6 +20,10 @@ import { export type DeregisterInstanceCommandInput = DeregisterInstanceRequest; export type DeregisterInstanceCommandOutput = DeregisterInstanceResponse & __MetadataBearer; +/** + *

Deletes the Amazon Route 53 DNS records and health check, if any, that AWS Cloud Map created for the specified + * instance.

+ */ export class DeregisterInstanceCommand extends $Command< DeregisterInstanceCommandInput, DeregisterInstanceCommandOutput, @@ -34,6 +38,9 @@ export class DeregisterInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/DiscoverInstancesCommand.ts b/clients/client-servicediscovery/commands/DiscoverInstancesCommand.ts index 64bf0d4f11b97..c132a6c22b525 100644 --- a/clients/client-servicediscovery/commands/DiscoverInstancesCommand.ts +++ b/clients/client-servicediscovery/commands/DiscoverInstancesCommand.ts @@ -20,6 +20,11 @@ import { export type DiscoverInstancesCommandInput = DiscoverInstancesRequest; export type DiscoverInstancesCommandOutput = DiscoverInstancesResponse & __MetadataBearer; +/** + *

Discovers registered instances for a specified namespace and service. You can use DiscoverInstances + * to discover instances for any type of namespace. For public and private DNS namespaces, you can also use DNS queries + * to discover instances.

+ */ export class DiscoverInstancesCommand extends $Command< DiscoverInstancesCommandInput, DiscoverInstancesCommandOutput, @@ -34,6 +39,9 @@ export class DiscoverInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/GetInstanceCommand.ts b/clients/client-servicediscovery/commands/GetInstanceCommand.ts index 3d94705150949..d93b0ab835a6b 100644 --- a/clients/client-servicediscovery/commands/GetInstanceCommand.ts +++ b/clients/client-servicediscovery/commands/GetInstanceCommand.ts @@ -20,6 +20,9 @@ import { export type GetInstanceCommandInput = GetInstanceRequest; export type GetInstanceCommandOutput = GetInstanceResponse & __MetadataBearer; +/** + *

Gets information about a specified instance.

+ */ export class GetInstanceCommand extends $Command< GetInstanceCommandInput, GetInstanceCommandOutput, @@ -34,6 +37,9 @@ export class GetInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/GetInstancesHealthStatusCommand.ts b/clients/client-servicediscovery/commands/GetInstancesHealthStatusCommand.ts index 8afccc26170da..ec8a4f3981c46 100644 --- a/clients/client-servicediscovery/commands/GetInstancesHealthStatusCommand.ts +++ b/clients/client-servicediscovery/commands/GetInstancesHealthStatusCommand.ts @@ -20,6 +20,14 @@ import { export type GetInstancesHealthStatusCommandInput = GetInstancesHealthStatusRequest; export type GetInstancesHealthStatusCommandOutput = GetInstancesHealthStatusResponse & __MetadataBearer; +/** + *

Gets the current health status (Healthy, Unhealthy, or Unknown) of one or + * more instances that are associated with a specified service.

+ * + *

There is a brief delay between when you register an instance and when the health status for the instance is + * available.

+ *
+ */ export class GetInstancesHealthStatusCommand extends $Command< GetInstancesHealthStatusCommandInput, GetInstancesHealthStatusCommandOutput, @@ -34,6 +42,9 @@ export class GetInstancesHealthStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/GetNamespaceCommand.ts b/clients/client-servicediscovery/commands/GetNamespaceCommand.ts index 7d196ebcfee61..c52877a469dbe 100644 --- a/clients/client-servicediscovery/commands/GetNamespaceCommand.ts +++ b/clients/client-servicediscovery/commands/GetNamespaceCommand.ts @@ -20,6 +20,9 @@ import { export type GetNamespaceCommandInput = GetNamespaceRequest; export type GetNamespaceCommandOutput = GetNamespaceResponse & __MetadataBearer; +/** + *

Gets information about a namespace.

+ */ export class GetNamespaceCommand extends $Command< GetNamespaceCommandInput, GetNamespaceCommandOutput, @@ -34,6 +37,9 @@ export class GetNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/GetOperationCommand.ts b/clients/client-servicediscovery/commands/GetOperationCommand.ts index 850658eeeeb32..78d813e0863d2 100644 --- a/clients/client-servicediscovery/commands/GetOperationCommand.ts +++ b/clients/client-servicediscovery/commands/GetOperationCommand.ts @@ -20,6 +20,13 @@ import { export type GetOperationCommandInput = GetOperationRequest; export type GetOperationCommandOutput = GetOperationResponse & __MetadataBearer; +/** + *

Gets information about any operation that returns an operation ID in the response, such as a + * CreateService request.

+ * + *

To get a list of operations that match specified criteria, see ListOperations.

+ *
+ */ export class GetOperationCommand extends $Command< GetOperationCommandInput, GetOperationCommandOutput, @@ -34,6 +41,9 @@ export class GetOperationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/GetServiceCommand.ts b/clients/client-servicediscovery/commands/GetServiceCommand.ts index 6028998c77502..8c663994c4323 100644 --- a/clients/client-servicediscovery/commands/GetServiceCommand.ts +++ b/clients/client-servicediscovery/commands/GetServiceCommand.ts @@ -20,6 +20,9 @@ import { export type GetServiceCommandInput = GetServiceRequest; export type GetServiceCommandOutput = GetServiceResponse & __MetadataBearer; +/** + *

Gets the settings for a specified service.

+ */ export class GetServiceCommand extends $Command< GetServiceCommandInput, GetServiceCommandOutput, @@ -34,6 +37,9 @@ export class GetServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/ListInstancesCommand.ts b/clients/client-servicediscovery/commands/ListInstancesCommand.ts index 084f7ff4a6766..5b456479fefe8 100644 --- a/clients/client-servicediscovery/commands/ListInstancesCommand.ts +++ b/clients/client-servicediscovery/commands/ListInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type ListInstancesCommandInput = ListInstancesRequest; export type ListInstancesCommandOutput = ListInstancesResponse & __MetadataBearer; +/** + *

Lists summary information about the instances that you registered by using a specified service.

+ */ export class ListInstancesCommand extends $Command< ListInstancesCommandInput, ListInstancesCommandOutput, @@ -34,6 +37,9 @@ export class ListInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/ListNamespacesCommand.ts b/clients/client-servicediscovery/commands/ListNamespacesCommand.ts index adf5dcd2fe9f6..18b68d34b1c50 100644 --- a/clients/client-servicediscovery/commands/ListNamespacesCommand.ts +++ b/clients/client-servicediscovery/commands/ListNamespacesCommand.ts @@ -20,6 +20,9 @@ import { export type ListNamespacesCommandInput = ListNamespacesRequest; export type ListNamespacesCommandOutput = ListNamespacesResponse & __MetadataBearer; +/** + *

Lists summary information about the namespaces that were created by the current AWS account.

+ */ export class ListNamespacesCommand extends $Command< ListNamespacesCommandInput, ListNamespacesCommandOutput, @@ -34,6 +37,9 @@ export class ListNamespacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/ListOperationsCommand.ts b/clients/client-servicediscovery/commands/ListOperationsCommand.ts index 238d2652bc2d1..cbee870fd1b0e 100644 --- a/clients/client-servicediscovery/commands/ListOperationsCommand.ts +++ b/clients/client-servicediscovery/commands/ListOperationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListOperationsCommandInput = ListOperationsRequest; export type ListOperationsCommandOutput = ListOperationsResponse & __MetadataBearer; +/** + *

Lists operations that match the criteria that you specify.

+ */ export class ListOperationsCommand extends $Command< ListOperationsCommandInput, ListOperationsCommandOutput, @@ -34,6 +37,9 @@ export class ListOperationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/ListServicesCommand.ts b/clients/client-servicediscovery/commands/ListServicesCommand.ts index f06366d9743b7..10309e26943b9 100644 --- a/clients/client-servicediscovery/commands/ListServicesCommand.ts +++ b/clients/client-servicediscovery/commands/ListServicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListServicesCommandInput = ListServicesRequest; export type ListServicesCommandOutput = ListServicesResponse & __MetadataBearer; +/** + *

Lists summary information for all the services that are associated with one or more specified namespaces.

+ */ export class ListServicesCommand extends $Command< ListServicesCommandInput, ListServicesCommandOutput, @@ -34,6 +37,9 @@ export class ListServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/ListTagsForResourceCommand.ts b/clients/client-servicediscovery/commands/ListTagsForResourceCommand.ts index 70b51fa44be9e..2f0a02ec326ff 100644 --- a/clients/client-servicediscovery/commands/ListTagsForResourceCommand.ts +++ b/clients/client-servicediscovery/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists tags for the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/RegisterInstanceCommand.ts b/clients/client-servicediscovery/commands/RegisterInstanceCommand.ts index 162c66c249973..72f60689b19d8 100644 --- a/clients/client-servicediscovery/commands/RegisterInstanceCommand.ts +++ b/clients/client-servicediscovery/commands/RegisterInstanceCommand.ts @@ -20,6 +20,48 @@ import { export type RegisterInstanceCommandInput = RegisterInstanceRequest; export type RegisterInstanceCommandOutput = RegisterInstanceResponse & __MetadataBearer; +/** + *

Creates or updates one or more records and, optionally, creates a health check based on the settings in a + * specified service. When you submit a RegisterInstance request, the following occurs:

+ *
    + *
  • + *

    For each DNS record that you define in the service that is specified by ServiceId, a record is + * created or updated in the hosted zone that is associated with the corresponding namespace.

    + *
  • + *
  • + *

    If the service includes HealthCheckConfig, a health check is created based on the settings in the + * health check configuration.

    + *
  • + *
  • + *

    The health check, if any, is associated with each of the new or updated records.

    + *
  • + *
+ * + *

One RegisterInstance request must complete before you can submit another request and specify the + * same service ID and instance ID.

+ *
+ *

For more information, see CreateService.

+ *

When AWS Cloud Map receives a DNS query for the specified DNS name, it returns the applicable value:

+ *
    + *
  • + *

    + * If the health check is healthy: returns all the records

    + *
  • + *
  • + *

    + * If the health check is unhealthy: returns the applicable value for the last + * healthy instance

    + *
  • + *
  • + *

    + * If you didn't specify a health check configuration: returns all the + * records

    + *
  • + *
+ *

For the current quota on the number of instances that you can register using the same namespace and using the + * same service, see AWS Cloud Map + * Limits in the AWS Cloud Map Developer Guide.

+ */ export class RegisterInstanceCommand extends $Command< RegisterInstanceCommandInput, RegisterInstanceCommandOutput, @@ -34,6 +76,9 @@ export class RegisterInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/TagResourceCommand.ts b/clients/client-servicediscovery/commands/TagResourceCommand.ts index 8963477f22d01..d4aa654b44f30 100644 --- a/clients/client-servicediscovery/commands/TagResourceCommand.ts +++ b/clients/client-servicediscovery/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds one or more tags to the specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/UntagResourceCommand.ts b/clients/client-servicediscovery/commands/UntagResourceCommand.ts index 5f97110a34c6a..4696d3f4f5a25 100644 --- a/clients/client-servicediscovery/commands/UntagResourceCommand.ts +++ b/clients/client-servicediscovery/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from the specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/UpdateInstanceCustomHealthStatusCommand.ts b/clients/client-servicediscovery/commands/UpdateInstanceCustomHealthStatusCommand.ts index 473a469b18567..472734d992584 100644 --- a/clients/client-servicediscovery/commands/UpdateInstanceCustomHealthStatusCommand.ts +++ b/clients/client-servicediscovery/commands/UpdateInstanceCustomHealthStatusCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateInstanceCustomHealthStatusCommandInput = UpdateInstanceCustomHealthStatusRequest; export type UpdateInstanceCustomHealthStatusCommandOutput = __MetadataBearer; +/** + *

Submits a request to change the health status of a custom health check to healthy or unhealthy.

+ *

You can use UpdateInstanceCustomHealthStatus to change the status only for custom health checks, + * which you define using HealthCheckCustomConfig when you create a service. You can't use it to change the + * status for Route 53 health checks, which you define using HealthCheckConfig.

+ *

For more information, see HealthCheckCustomConfig.

+ */ export class UpdateInstanceCustomHealthStatusCommand extends $Command< UpdateInstanceCustomHealthStatusCommandInput, UpdateInstanceCustomHealthStatusCommandOutput, @@ -34,6 +41,9 @@ export class UpdateInstanceCustomHealthStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/commands/UpdateServiceCommand.ts b/clients/client-servicediscovery/commands/UpdateServiceCommand.ts index 639e11ea83384..7c997a9b10772 100644 --- a/clients/client-servicediscovery/commands/UpdateServiceCommand.ts +++ b/clients/client-servicediscovery/commands/UpdateServiceCommand.ts @@ -20,6 +20,33 @@ import { export type UpdateServiceCommandInput = UpdateServiceRequest; export type UpdateServiceCommandOutput = UpdateServiceResponse & __MetadataBearer; +/** + *

Submits a request to perform the following operations:

+ *
    + *
  • + *

    Update the TTL setting for existing DnsRecords configurations

    + *
  • + *
  • + *

    Add, update, or delete HealthCheckConfig for a specified service

    + * + *

    You can't add, update, or delete a HealthCheckCustomConfig configuration.

    + *
    + *
  • + *
+ *

For public and private DNS namespaces, note the following:

+ *
    + *
  • + *

    If you omit any existing DnsRecords or HealthCheckConfig configurations from an + * UpdateService request, the configurations are deleted from the service.

    + *
  • + *
  • + *

    If you omit an existing HealthCheckCustomConfig configuration from an UpdateService + * request, the configuration is not deleted from the service.

    + *
  • + *
+ *

When you update settings for a service, AWS Cloud Map also updates the corresponding settings in all the records + * and health checks that were created by using the specified service.

+ */ export class UpdateServiceCommand extends $Command< UpdateServiceCommandInput, UpdateServiceCommandOutput, @@ -34,6 +61,9 @@ export class UpdateServiceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ServiceDiscoveryClientResolvedConfig, diff --git a/clients/client-servicediscovery/package.json b/clients/client-servicediscovery/package.json index 8c2b2de31df29..9330c2e821f9a 100644 --- a/clients/client-servicediscovery/package.json +++ b/clients/client-servicediscovery/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Servicediscovery Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-servicediscovery/pagination/GetInstancesHealthStatusPaginator.ts b/clients/client-servicediscovery/pagination/GetInstancesHealthStatusPaginator.ts index ba0d07b617e3c..42e511688a89c 100644 --- a/clients/client-servicediscovery/pagination/GetInstancesHealthStatusPaginator.ts +++ b/clients/client-servicediscovery/pagination/GetInstancesHealthStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceDiscoveryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceDiscoveryClient, input: GetInstancesHealthStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetInstancesHealthStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceDiscovery, input: GetInstancesHealthStatusCommandInput, diff --git a/clients/client-servicediscovery/pagination/ListInstancesPaginator.ts b/clients/client-servicediscovery/pagination/ListInstancesPaginator.ts index a45b61337e6b8..51ae136e49776 100644 --- a/clients/client-servicediscovery/pagination/ListInstancesPaginator.ts +++ b/clients/client-servicediscovery/pagination/ListInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceDiscoveryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceDiscoveryClient, input: ListInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceDiscovery, input: ListInstancesCommandInput, diff --git a/clients/client-servicediscovery/pagination/ListNamespacesPaginator.ts b/clients/client-servicediscovery/pagination/ListNamespacesPaginator.ts index 1141259b0d002..82b8e63cbe3ce 100644 --- a/clients/client-servicediscovery/pagination/ListNamespacesPaginator.ts +++ b/clients/client-servicediscovery/pagination/ListNamespacesPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceDiscoveryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceDiscoveryClient, input: ListNamespacesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListNamespacesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceDiscovery, input: ListNamespacesCommandInput, diff --git a/clients/client-servicediscovery/pagination/ListOperationsPaginator.ts b/clients/client-servicediscovery/pagination/ListOperationsPaginator.ts index 0e11f9d50147d..e02b95e5266da 100644 --- a/clients/client-servicediscovery/pagination/ListOperationsPaginator.ts +++ b/clients/client-servicediscovery/pagination/ListOperationsPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceDiscoveryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceDiscoveryClient, input: ListOperationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOperationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceDiscovery, input: ListOperationsCommandInput, diff --git a/clients/client-servicediscovery/pagination/ListServicesPaginator.ts b/clients/client-servicediscovery/pagination/ListServicesPaginator.ts index 7a5bd26013deb..bd758c708f351 100644 --- a/clients/client-servicediscovery/pagination/ListServicesPaginator.ts +++ b/clients/client-servicediscovery/pagination/ListServicesPaginator.ts @@ -8,6 +8,9 @@ import { import { ServiceDiscoveryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ServiceDiscoveryClient, input: ListServicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: ServiceDiscovery, input: ListServicesCommandInput, diff --git a/clients/client-servicediscovery/runtimeConfig.browser.ts b/clients/client-servicediscovery/runtimeConfig.browser.ts index 96d1db4c1083c..12048d8e5cfd0 100644 --- a/clients/client-servicediscovery/runtimeConfig.browser.ts +++ b/clients/client-servicediscovery/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ServiceDiscoveryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-servicediscovery/runtimeConfig.native.ts b/clients/client-servicediscovery/runtimeConfig.native.ts index 09187550fa660..944f125275e08 100644 --- a/clients/client-servicediscovery/runtimeConfig.native.ts +++ b/clients/client-servicediscovery/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ServiceDiscoveryClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-servicediscovery/runtimeConfig.shared.ts b/clients/client-servicediscovery/runtimeConfig.shared.ts index 4af3ad6c52546..e2f377e5ee868 100644 --- a/clients/client-servicediscovery/runtimeConfig.shared.ts +++ b/clients/client-servicediscovery/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-03-14", disableHostPrefix: false, diff --git a/clients/client-servicediscovery/runtimeConfig.ts b/clients/client-servicediscovery/runtimeConfig.ts index 8d04f59651397..b7ee53509b50c 100644 --- a/clients/client-servicediscovery/runtimeConfig.ts +++ b/clients/client-servicediscovery/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ServiceDiscoveryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-servicediscovery/tsconfig.json b/clients/client-servicediscovery/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-servicediscovery/tsconfig.json +++ b/clients/client-servicediscovery/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ses/commands/CloneReceiptRuleSetCommand.ts b/clients/client-ses/commands/CloneReceiptRuleSetCommand.ts index 1e6d51f5def1c..26dfdf4bd19f0 100644 --- a/clients/client-ses/commands/CloneReceiptRuleSetCommand.ts +++ b/clients/client-ses/commands/CloneReceiptRuleSetCommand.ts @@ -20,6 +20,14 @@ import { export type CloneReceiptRuleSetCommandInput = CloneReceiptRuleSetRequest; export type CloneReceiptRuleSetCommandOutput = CloneReceiptRuleSetResponse & __MetadataBearer; +/** + *

Creates a receipt rule set by cloning an existing one. All receipt rules and + * configurations are copied to the new receipt rule set and are completely independent of + * the source rule set.

+ *

For information about setting up rule sets, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CloneReceiptRuleSetCommand extends $Command< CloneReceiptRuleSetCommandInput, CloneReceiptRuleSetCommandOutput, @@ -34,6 +42,9 @@ export class CloneReceiptRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/CreateConfigurationSetCommand.ts b/clients/client-ses/commands/CreateConfigurationSetCommand.ts index 0ee6425c42fca..c3605d8c146b9 100644 --- a/clients/client-ses/commands/CreateConfigurationSetCommand.ts +++ b/clients/client-ses/commands/CreateConfigurationSetCommand.ts @@ -20,6 +20,13 @@ import { export type CreateConfigurationSetCommandInput = CreateConfigurationSetRequest; export type CreateConfigurationSetCommandOutput = CreateConfigurationSetResponse & __MetadataBearer; +/** + *

Creates a configuration set.

+ *

Configuration sets enable you to publish email sending events. For information about + * using configuration sets, see the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateConfigurationSetCommand extends $Command< CreateConfigurationSetCommandInput, CreateConfigurationSetCommandOutput, @@ -34,6 +41,9 @@ export class CreateConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/CreateConfigurationSetEventDestinationCommand.ts b/clients/client-ses/commands/CreateConfigurationSetEventDestinationCommand.ts index b1512cee79b45..275ebf43b9d85 100644 --- a/clients/client-ses/commands/CreateConfigurationSetEventDestinationCommand.ts +++ b/clients/client-ses/commands/CreateConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,18 @@ export type CreateConfigurationSetEventDestinationCommandInput = CreateConfigura export type CreateConfigurationSetEventDestinationCommandOutput = CreateConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Creates a configuration set event destination.

+ * + *

When you create or update an event destination, you must provide one, and only + * one, destination. The destination can be CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon SNS).

+ *
+ *

An event destination is the AWS service to which Amazon SES publishes the email sending + * events associated with a configuration set. For information about using configuration + * sets, see the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateConfigurationSetEventDestinationCommand extends $Command< CreateConfigurationSetEventDestinationCommandInput, CreateConfigurationSetEventDestinationCommandOutput, @@ -38,6 +50,9 @@ export class CreateConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/CreateConfigurationSetTrackingOptionsCommand.ts b/clients/client-ses/commands/CreateConfigurationSetTrackingOptionsCommand.ts index 1d6a316284634..455f9eb773f31 100644 --- a/clients/client-ses/commands/CreateConfigurationSetTrackingOptionsCommand.ts +++ b/clients/client-ses/commands/CreateConfigurationSetTrackingOptionsCommand.ts @@ -24,6 +24,13 @@ export type CreateConfigurationSetTrackingOptionsCommandInput = CreateConfigurat export type CreateConfigurationSetTrackingOptionsCommandOutput = CreateConfigurationSetTrackingOptionsResponse & __MetadataBearer; +/** + *

Creates an association between a configuration set and a custom domain for open and + * click event tracking.

+ *

By default, images and links used for tracking open and click events are hosted on + * domains operated by Amazon SES. You can configure a subdomain of your own to handle these + * events. For information about using custom domains, see the Amazon SES Developer Guide.

+ */ export class CreateConfigurationSetTrackingOptionsCommand extends $Command< CreateConfigurationSetTrackingOptionsCommandInput, CreateConfigurationSetTrackingOptionsCommandOutput, @@ -38,6 +45,9 @@ export class CreateConfigurationSetTrackingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/CreateCustomVerificationEmailTemplateCommand.ts b/clients/client-ses/commands/CreateCustomVerificationEmailTemplateCommand.ts index 0ce5acac73761..8753e7b6d575f 100644 --- a/clients/client-ses/commands/CreateCustomVerificationEmailTemplateCommand.ts +++ b/clients/client-ses/commands/CreateCustomVerificationEmailTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type CreateCustomVerificationEmailTemplateCommandInput = CreateCustomVerificationEmailTemplateRequest; export type CreateCustomVerificationEmailTemplateCommandOutput = __MetadataBearer; +/** + *

Creates a new custom verification email template.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateCustomVerificationEmailTemplateCommand extends $Command< CreateCustomVerificationEmailTemplateCommandInput, CreateCustomVerificationEmailTemplateCommandOutput, @@ -34,6 +40,9 @@ export class CreateCustomVerificationEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/CreateReceiptFilterCommand.ts b/clients/client-ses/commands/CreateReceiptFilterCommand.ts index 1ae54f221ce7c..05f06aefa7543 100644 --- a/clients/client-ses/commands/CreateReceiptFilterCommand.ts +++ b/clients/client-ses/commands/CreateReceiptFilterCommand.ts @@ -20,6 +20,11 @@ import { export type CreateReceiptFilterCommandInput = CreateReceiptFilterRequest; export type CreateReceiptFilterCommandOutput = CreateReceiptFilterResponse & __MetadataBearer; +/** + *

Creates a new IP address filter.

+ *

For information about setting up IP address filters, see the Amazon SES Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateReceiptFilterCommand extends $Command< CreateReceiptFilterCommandInput, CreateReceiptFilterCommandOutput, @@ -34,6 +39,9 @@ export class CreateReceiptFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/CreateReceiptRuleCommand.ts b/clients/client-ses/commands/CreateReceiptRuleCommand.ts index d730af5a6c9ee..f9a4569c80677 100644 --- a/clients/client-ses/commands/CreateReceiptRuleCommand.ts +++ b/clients/client-ses/commands/CreateReceiptRuleCommand.ts @@ -20,6 +20,12 @@ import { export type CreateReceiptRuleCommandInput = CreateReceiptRuleRequest; export type CreateReceiptRuleCommandOutput = CreateReceiptRuleResponse & __MetadataBearer; +/** + *

Creates a receipt rule.

+ *

For information about setting up receipt rules, see the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateReceiptRuleCommand extends $Command< CreateReceiptRuleCommandInput, CreateReceiptRuleCommandOutput, @@ -34,6 +40,9 @@ export class CreateReceiptRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/CreateReceiptRuleSetCommand.ts b/clients/client-ses/commands/CreateReceiptRuleSetCommand.ts index a407044da23a5..14e44860f019d 100644 --- a/clients/client-ses/commands/CreateReceiptRuleSetCommand.ts +++ b/clients/client-ses/commands/CreateReceiptRuleSetCommand.ts @@ -20,6 +20,12 @@ import { export type CreateReceiptRuleSetCommandInput = CreateReceiptRuleSetRequest; export type CreateReceiptRuleSetCommandOutput = CreateReceiptRuleSetResponse & __MetadataBearer; +/** + *

Creates an empty receipt rule set.

+ *

For information about setting up receipt rule sets, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateReceiptRuleSetCommand extends $Command< CreateReceiptRuleSetCommandInput, CreateReceiptRuleSetCommandOutput, @@ -34,6 +40,9 @@ export class CreateReceiptRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/CreateTemplateCommand.ts b/clients/client-ses/commands/CreateTemplateCommand.ts index aea68a64749e1..258622f4bc6bf 100644 --- a/clients/client-ses/commands/CreateTemplateCommand.ts +++ b/clients/client-ses/commands/CreateTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type CreateTemplateCommandInput = CreateTemplateRequest; export type CreateTemplateCommandOutput = CreateTemplateResponse & __MetadataBearer; +/** + *

Creates an email template. Email templates enable you to send personalized email to + * one or more destinations in a single API operation. For more information, see the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateTemplateCommand extends $Command< CreateTemplateCommandInput, CreateTemplateCommandOutput, @@ -34,6 +40,9 @@ export class CreateTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteConfigurationSetCommand.ts b/clients/client-ses/commands/DeleteConfigurationSetCommand.ts index 5a8a1bd924115..3a9c3380ca18f 100644 --- a/clients/client-ses/commands/DeleteConfigurationSetCommand.ts +++ b/clients/client-ses/commands/DeleteConfigurationSetCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteConfigurationSetCommandInput = DeleteConfigurationSetRequest; export type DeleteConfigurationSetCommandOutput = DeleteConfigurationSetResponse & __MetadataBearer; +/** + *

Deletes a configuration set. Configuration sets enable you to publish email sending + * events. For information about using configuration sets, see the Amazon SES Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteConfigurationSetCommand extends $Command< DeleteConfigurationSetCommandInput, DeleteConfigurationSetCommandOutput, @@ -34,6 +39,9 @@ export class DeleteConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteConfigurationSetEventDestinationCommand.ts b/clients/client-ses/commands/DeleteConfigurationSetEventDestinationCommand.ts index 9e0c77384a77d..97fba72c2423c 100644 --- a/clients/client-ses/commands/DeleteConfigurationSetEventDestinationCommand.ts +++ b/clients/client-ses/commands/DeleteConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,12 @@ export type DeleteConfigurationSetEventDestinationCommandInput = DeleteConfigura export type DeleteConfigurationSetEventDestinationCommandOutput = DeleteConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Deletes a configuration set event destination. Configuration set event destinations + * are associated with configuration sets, which enable you to publish email sending + * events. For information about using configuration sets, see the Amazon SES Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteConfigurationSetEventDestinationCommand extends $Command< DeleteConfigurationSetEventDestinationCommandInput, DeleteConfigurationSetEventDestinationCommandOutput, @@ -38,6 +44,9 @@ export class DeleteConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteConfigurationSetTrackingOptionsCommand.ts b/clients/client-ses/commands/DeleteConfigurationSetTrackingOptionsCommand.ts index 8f66b8636563b..a1f2c5d53fe3a 100644 --- a/clients/client-ses/commands/DeleteConfigurationSetTrackingOptionsCommand.ts +++ b/clients/client-ses/commands/DeleteConfigurationSetTrackingOptionsCommand.ts @@ -24,6 +24,18 @@ export type DeleteConfigurationSetTrackingOptionsCommandInput = DeleteConfigurat export type DeleteConfigurationSetTrackingOptionsCommandOutput = DeleteConfigurationSetTrackingOptionsResponse & __MetadataBearer; +/** + *

Deletes an association between a configuration set and a custom domain for open and + * click event tracking.

+ *

By default, images and links used for tracking open and click events are hosted on + * domains operated by Amazon SES. You can configure a subdomain of your own to handle these + * events. For information about using custom domains, see the Amazon SES Developer Guide.

+ * + *

Deleting this kind of association will result in emails sent using the specified + * configuration set to capture open and click events using the standard, + * Amazon SES-operated domains.

+ *
+ */ export class DeleteConfigurationSetTrackingOptionsCommand extends $Command< DeleteConfigurationSetTrackingOptionsCommandInput, DeleteConfigurationSetTrackingOptionsCommandOutput, @@ -38,6 +50,9 @@ export class DeleteConfigurationSetTrackingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteCustomVerificationEmailTemplateCommand.ts b/clients/client-ses/commands/DeleteCustomVerificationEmailTemplateCommand.ts index df1616f152e4e..523687bc985ce 100644 --- a/clients/client-ses/commands/DeleteCustomVerificationEmailTemplateCommand.ts +++ b/clients/client-ses/commands/DeleteCustomVerificationEmailTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteCustomVerificationEmailTemplateCommandInput = DeleteCustomVerificationEmailTemplateRequest; export type DeleteCustomVerificationEmailTemplateCommandOutput = __MetadataBearer; +/** + *

Deletes an existing custom verification email template.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteCustomVerificationEmailTemplateCommand extends $Command< DeleteCustomVerificationEmailTemplateCommandInput, DeleteCustomVerificationEmailTemplateCommandOutput, @@ -34,6 +40,9 @@ export class DeleteCustomVerificationEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteIdentityCommand.ts b/clients/client-ses/commands/DeleteIdentityCommand.ts index f3051bd1522ee..3b9d97cf3da44 100644 --- a/clients/client-ses/commands/DeleteIdentityCommand.ts +++ b/clients/client-ses/commands/DeleteIdentityCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteIdentityCommandInput = DeleteIdentityRequest; export type DeleteIdentityCommandOutput = DeleteIdentityResponse & __MetadataBearer; +/** + *

Deletes the specified identity (an email address or a domain) from the list of + * verified identities.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteIdentityCommand extends $Command< DeleteIdentityCommandInput, DeleteIdentityCommandOutput, @@ -34,6 +39,9 @@ export class DeleteIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteIdentityPolicyCommand.ts b/clients/client-ses/commands/DeleteIdentityPolicyCommand.ts index 9143e7be96078..a32dd3b38881d 100644 --- a/clients/client-ses/commands/DeleteIdentityPolicyCommand.ts +++ b/clients/client-ses/commands/DeleteIdentityPolicyCommand.ts @@ -20,6 +20,20 @@ import { export type DeleteIdentityPolicyCommandInput = DeleteIdentityPolicyRequest; export type DeleteIdentityPolicyCommandOutput = DeleteIdentityPolicyResponse & __MetadataBearer; +/** + *

Deletes the specified sending authorization policy for the given identity (an email + * address or a domain). This API returns successfully even if a policy with the specified + * name does not exist.

+ * + *

This API is for the identity owner only. If you have not verified the identity, + * this API will return an error.

+ *
+ *

Sending authorization is a feature that enables an identity owner to authorize other + * senders to use its identities. For information about using sending authorization, see + * the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteIdentityPolicyCommand extends $Command< DeleteIdentityPolicyCommandInput, DeleteIdentityPolicyCommandOutput, @@ -34,6 +48,9 @@ export class DeleteIdentityPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteReceiptFilterCommand.ts b/clients/client-ses/commands/DeleteReceiptFilterCommand.ts index 5718a5aa761dd..0a34ec6e820b4 100644 --- a/clients/client-ses/commands/DeleteReceiptFilterCommand.ts +++ b/clients/client-ses/commands/DeleteReceiptFilterCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteReceiptFilterCommandInput = DeleteReceiptFilterRequest; export type DeleteReceiptFilterCommandOutput = DeleteReceiptFilterResponse & __MetadataBearer; +/** + *

Deletes the specified IP address filter.

+ *

For information about managing IP address filters, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteReceiptFilterCommand extends $Command< DeleteReceiptFilterCommandInput, DeleteReceiptFilterCommandOutput, @@ -34,6 +40,9 @@ export class DeleteReceiptFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteReceiptRuleCommand.ts b/clients/client-ses/commands/DeleteReceiptRuleCommand.ts index 0f0bb3d512bcf..ab89adef21825 100644 --- a/clients/client-ses/commands/DeleteReceiptRuleCommand.ts +++ b/clients/client-ses/commands/DeleteReceiptRuleCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteReceiptRuleCommandInput = DeleteReceiptRuleRequest; export type DeleteReceiptRuleCommandOutput = DeleteReceiptRuleResponse & __MetadataBearer; +/** + *

Deletes the specified receipt rule.

+ *

For information about managing receipt rules, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteReceiptRuleCommand extends $Command< DeleteReceiptRuleCommandInput, DeleteReceiptRuleCommandOutput, @@ -34,6 +40,9 @@ export class DeleteReceiptRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteReceiptRuleSetCommand.ts b/clients/client-ses/commands/DeleteReceiptRuleSetCommand.ts index fac070c1db01c..c9a6e853bf72f 100644 --- a/clients/client-ses/commands/DeleteReceiptRuleSetCommand.ts +++ b/clients/client-ses/commands/DeleteReceiptRuleSetCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteReceiptRuleSetCommandInput = DeleteReceiptRuleSetRequest; export type DeleteReceiptRuleSetCommandOutput = DeleteReceiptRuleSetResponse & __MetadataBearer; +/** + *

Deletes the specified receipt rule set and all of the receipt rules it + * contains.

+ * + *

The currently active rule set cannot be deleted.

+ *
+ *

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteReceiptRuleSetCommand extends $Command< DeleteReceiptRuleSetCommandInput, DeleteReceiptRuleSetCommandOutput, @@ -34,6 +43,9 @@ export class DeleteReceiptRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteTemplateCommand.ts b/clients/client-ses/commands/DeleteTemplateCommand.ts index f8aa142553f2f..ea5830ac43a49 100644 --- a/clients/client-ses/commands/DeleteTemplateCommand.ts +++ b/clients/client-ses/commands/DeleteTemplateCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTemplateCommandInput = DeleteTemplateRequest; export type DeleteTemplateCommandOutput = DeleteTemplateResponse & __MetadataBearer; +/** + *

Deletes an email template.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteTemplateCommand extends $Command< DeleteTemplateCommandInput, DeleteTemplateCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DeleteVerifiedEmailAddressCommand.ts b/clients/client-ses/commands/DeleteVerifiedEmailAddressCommand.ts index 2c5db021e16c3..239399624e7b2 100644 --- a/clients/client-ses/commands/DeleteVerifiedEmailAddressCommand.ts +++ b/clients/client-ses/commands/DeleteVerifiedEmailAddressCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteVerifiedEmailAddressCommandInput = DeleteVerifiedEmailAddressRequest; export type DeleteVerifiedEmailAddressCommandOutput = __MetadataBearer; +/** + *

Deprecated. Use the DeleteIdentity operation to delete email addresses + * and domains.

+ */ export class DeleteVerifiedEmailAddressCommand extends $Command< DeleteVerifiedEmailAddressCommandInput, DeleteVerifiedEmailAddressCommandOutput, @@ -34,6 +38,9 @@ export class DeleteVerifiedEmailAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DescribeActiveReceiptRuleSetCommand.ts b/clients/client-ses/commands/DescribeActiveReceiptRuleSetCommand.ts index ee6420df9151c..f67c30ead7a23 100644 --- a/clients/client-ses/commands/DescribeActiveReceiptRuleSetCommand.ts +++ b/clients/client-ses/commands/DescribeActiveReceiptRuleSetCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeActiveReceiptRuleSetCommandInput = DescribeActiveReceiptRuleSetRequest; export type DescribeActiveReceiptRuleSetCommandOutput = DescribeActiveReceiptRuleSetResponse & __MetadataBearer; +/** + *

Returns the metadata and receipt rules for the receipt rule set that is currently + * active.

+ *

For information about setting up receipt rule sets, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DescribeActiveReceiptRuleSetCommand extends $Command< DescribeActiveReceiptRuleSetCommandInput, DescribeActiveReceiptRuleSetCommandOutput, @@ -34,6 +41,9 @@ export class DescribeActiveReceiptRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DescribeConfigurationSetCommand.ts b/clients/client-ses/commands/DescribeConfigurationSetCommand.ts index 8ac88709965c9..84323776a2bf6 100644 --- a/clients/client-ses/commands/DescribeConfigurationSetCommand.ts +++ b/clients/client-ses/commands/DescribeConfigurationSetCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeConfigurationSetCommandInput = DescribeConfigurationSetRequest; export type DescribeConfigurationSetCommandOutput = DescribeConfigurationSetResponse & __MetadataBearer; +/** + *

Returns the details of the specified configuration set. For information about using + * configuration sets, see the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DescribeConfigurationSetCommand extends $Command< DescribeConfigurationSetCommandInput, DescribeConfigurationSetCommandOutput, @@ -34,6 +40,9 @@ export class DescribeConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DescribeReceiptRuleCommand.ts b/clients/client-ses/commands/DescribeReceiptRuleCommand.ts index 29dc36427d99f..453537b6d224c 100644 --- a/clients/client-ses/commands/DescribeReceiptRuleCommand.ts +++ b/clients/client-ses/commands/DescribeReceiptRuleCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeReceiptRuleCommandInput = DescribeReceiptRuleRequest; export type DescribeReceiptRuleCommandOutput = DescribeReceiptRuleResponse & __MetadataBearer; +/** + *

Returns the details of the specified receipt rule.

+ *

For information about setting up receipt rules, see the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DescribeReceiptRuleCommand extends $Command< DescribeReceiptRuleCommandInput, DescribeReceiptRuleCommandOutput, @@ -34,6 +40,9 @@ export class DescribeReceiptRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/DescribeReceiptRuleSetCommand.ts b/clients/client-ses/commands/DescribeReceiptRuleSetCommand.ts index 86c228bb3e8e1..61e7fc71e0c38 100644 --- a/clients/client-ses/commands/DescribeReceiptRuleSetCommand.ts +++ b/clients/client-ses/commands/DescribeReceiptRuleSetCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeReceiptRuleSetCommandInput = DescribeReceiptRuleSetRequest; export type DescribeReceiptRuleSetCommandOutput = DescribeReceiptRuleSetResponse & __MetadataBearer; +/** + *

Returns the details of the specified receipt rule set.

+ *

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DescribeReceiptRuleSetCommand extends $Command< DescribeReceiptRuleSetCommandInput, DescribeReceiptRuleSetCommandOutput, @@ -34,6 +39,9 @@ export class DescribeReceiptRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetAccountSendingEnabledCommand.ts b/clients/client-ses/commands/GetAccountSendingEnabledCommand.ts index a64aac5fa9651..c7d236d97f7ef 100644 --- a/clients/client-ses/commands/GetAccountSendingEnabledCommand.ts +++ b/clients/client-ses/commands/GetAccountSendingEnabledCommand.ts @@ -20,6 +20,10 @@ import { export type GetAccountSendingEnabledCommandInput = {}; export type GetAccountSendingEnabledCommandOutput = GetAccountSendingEnabledResponse & __MetadataBearer; +/** + *

Returns the email sending status of the Amazon SES account for the current region.

+ *

You can execute this operation no more than once per second.

+ */ export class GetAccountSendingEnabledCommand extends $Command< GetAccountSendingEnabledCommandInput, GetAccountSendingEnabledCommandOutput, @@ -34,6 +38,9 @@ export class GetAccountSendingEnabledCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetCustomVerificationEmailTemplateCommand.ts b/clients/client-ses/commands/GetCustomVerificationEmailTemplateCommand.ts index f242bcafb7b64..e382d32396f65 100644 --- a/clients/client-ses/commands/GetCustomVerificationEmailTemplateCommand.ts +++ b/clients/client-ses/commands/GetCustomVerificationEmailTemplateCommand.ts @@ -24,6 +24,13 @@ export type GetCustomVerificationEmailTemplateCommandInput = GetCustomVerificati export type GetCustomVerificationEmailTemplateCommandOutput = GetCustomVerificationEmailTemplateResponse & __MetadataBearer; +/** + *

Returns the custom email verification template for the template name you + * specify.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class GetCustomVerificationEmailTemplateCommand extends $Command< GetCustomVerificationEmailTemplateCommandInput, GetCustomVerificationEmailTemplateCommandOutput, @@ -38,6 +45,9 @@ export class GetCustomVerificationEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetIdentityDkimAttributesCommand.ts b/clients/client-ses/commands/GetIdentityDkimAttributesCommand.ts index 423587ff64e41..8f327e91f0f73 100644 --- a/clients/client-ses/commands/GetIdentityDkimAttributesCommand.ts +++ b/clients/client-ses/commands/GetIdentityDkimAttributesCommand.ts @@ -20,6 +20,31 @@ import { export type GetIdentityDkimAttributesCommandInput = GetIdentityDkimAttributesRequest; export type GetIdentityDkimAttributesCommandOutput = GetIdentityDkimAttributesResponse & __MetadataBearer; +/** + *

Returns the current status of Easy DKIM signing for an entity. For domain name + * identities, this operation also returns the DKIM tokens that are required for Easy DKIM + * signing, and whether Amazon SES has successfully verified that these tokens have been + * published.

+ *

This operation takes a list of identities as input and returns the following + * information for each:

+ *
    + *
  • + *

    Whether Easy DKIM signing is enabled or disabled.

    + *
  • + *
  • + *

    A set of DKIM tokens that represent the identity. If the identity is an email + * address, the tokens represent the domain of that address.

    + *
  • + *
  • + *

    Whether Amazon SES has successfully verified the DKIM tokens published in the + * domain's DNS. This information is only returned for domain name identities, not + * for email addresses.

    + *
  • + *
+ *

This operation is throttled at one request per second and can only get DKIM attributes + * for up to 100 identities at a time.

+ *

For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide.

+ */ export class GetIdentityDkimAttributesCommand extends $Command< GetIdentityDkimAttributesCommandInput, GetIdentityDkimAttributesCommandOutput, @@ -34,6 +59,9 @@ export class GetIdentityDkimAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetIdentityMailFromDomainAttributesCommand.ts b/clients/client-ses/commands/GetIdentityMailFromDomainAttributesCommand.ts index aae4013cb03c9..4c9a9dca8ed37 100644 --- a/clients/client-ses/commands/GetIdentityMailFromDomainAttributesCommand.ts +++ b/clients/client-ses/commands/GetIdentityMailFromDomainAttributesCommand.ts @@ -24,6 +24,12 @@ export type GetIdentityMailFromDomainAttributesCommandInput = GetIdentityMailFro export type GetIdentityMailFromDomainAttributesCommandOutput = GetIdentityMailFromDomainAttributesResponse & __MetadataBearer; +/** + *

Returns the custom MAIL FROM attributes for a list of identities (email addresses : + * domains).

+ *

This operation is throttled at one request per second and can only get custom MAIL + * FROM attributes for up to 100 identities at a time.

+ */ export class GetIdentityMailFromDomainAttributesCommand extends $Command< GetIdentityMailFromDomainAttributesCommandInput, GetIdentityMailFromDomainAttributesCommandOutput, @@ -38,6 +44,9 @@ export class GetIdentityMailFromDomainAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetIdentityNotificationAttributesCommand.ts b/clients/client-ses/commands/GetIdentityNotificationAttributesCommand.ts index 85092ec1214d4..b8e8fc2d415ea 100644 --- a/clients/client-ses/commands/GetIdentityNotificationAttributesCommand.ts +++ b/clients/client-ses/commands/GetIdentityNotificationAttributesCommand.ts @@ -24,6 +24,14 @@ export type GetIdentityNotificationAttributesCommandInput = GetIdentityNotificat export type GetIdentityNotificationAttributesCommandOutput = GetIdentityNotificationAttributesResponse & __MetadataBearer; +/** + *

Given a list of verified identities (email addresses and/or domains), returns a + * structure describing identity notification attributes.

+ *

This operation is throttled at one request per second and can only get notification + * attributes for up to 100 identities at a time.

+ *

For more information about using notifications with Amazon SES, see the Amazon SES + * Developer Guide.

+ */ export class GetIdentityNotificationAttributesCommand extends $Command< GetIdentityNotificationAttributesCommandInput, GetIdentityNotificationAttributesCommandOutput, @@ -38,6 +46,9 @@ export class GetIdentityNotificationAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetIdentityPoliciesCommand.ts b/clients/client-ses/commands/GetIdentityPoliciesCommand.ts index 5998e2a2df9fb..05bbeffe507d7 100644 --- a/clients/client-ses/commands/GetIdentityPoliciesCommand.ts +++ b/clients/client-ses/commands/GetIdentityPoliciesCommand.ts @@ -20,6 +20,20 @@ import { export type GetIdentityPoliciesCommandInput = GetIdentityPoliciesRequest; export type GetIdentityPoliciesCommandOutput = GetIdentityPoliciesResponse & __MetadataBearer; +/** + *

Returns the requested sending authorization policies for the given identity (an email + * address or a domain). The policies are returned as a map of policy names to policy + * contents. You can retrieve a maximum of 20 policies at a time.

+ * + *

This API is for the identity owner only. If you have not verified the identity, + * this API will return an error.

+ *
+ *

Sending authorization is a feature that enables an identity owner to authorize other + * senders to use its identities. For information about using sending authorization, see + * the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class GetIdentityPoliciesCommand extends $Command< GetIdentityPoliciesCommandInput, GetIdentityPoliciesCommandOutput, @@ -34,6 +48,9 @@ export class GetIdentityPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetIdentityVerificationAttributesCommand.ts b/clients/client-ses/commands/GetIdentityVerificationAttributesCommand.ts index 1b7a39d2f7428..4ff840a3f6b3f 100644 --- a/clients/client-ses/commands/GetIdentityVerificationAttributesCommand.ts +++ b/clients/client-ses/commands/GetIdentityVerificationAttributesCommand.ts @@ -24,6 +24,24 @@ export type GetIdentityVerificationAttributesCommandInput = GetIdentityVerificat export type GetIdentityVerificationAttributesCommandOutput = GetIdentityVerificationAttributesResponse & __MetadataBearer; +/** + *

Given a list of identities (email addresses and/or domains), returns the verification + * status and (for domain identities) the verification token for each identity.

+ *

The verification status of an email address is "Pending" until the email address owner + * clicks the link within the verification email that Amazon SES sent to that address. If the + * email address owner clicks the link within 24 hours, the verification status of the + * email address changes to "Success". If the link is not clicked within 24 hours, the + * verification status changes to "Failed." In that case, if you still want to verify the + * email address, you must restart the verification process from the beginning.

+ *

For domain identities, the domain's verification status is "Pending" as Amazon SES searches + * for the required TXT record in the DNS settings of the domain. When Amazon SES detects the + * record, the domain's verification status changes to "Success". If Amazon SES is unable to + * detect the record within 72 hours, the domain's verification status changes to "Failed." + * In that case, if you still want to verify the domain, you must restart the verification + * process from the beginning.

+ *

This operation is throttled at one request per second and can only get verification + * attributes for up to 100 identities at a time.

+ */ export class GetIdentityVerificationAttributesCommand extends $Command< GetIdentityVerificationAttributesCommandInput, GetIdentityVerificationAttributesCommandOutput, @@ -38,6 +56,9 @@ export class GetIdentityVerificationAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetSendQuotaCommand.ts b/clients/client-ses/commands/GetSendQuotaCommand.ts index 34f816a2dd170..09849b02157d5 100644 --- a/clients/client-ses/commands/GetSendQuotaCommand.ts +++ b/clients/client-ses/commands/GetSendQuotaCommand.ts @@ -17,6 +17,10 @@ import { export type GetSendQuotaCommandInput = {}; export type GetSendQuotaCommandOutput = GetSendQuotaResponse & __MetadataBearer; +/** + *

Provides the sending limits for the Amazon SES account.

+ *

You can execute this operation no more than once per second.

+ */ export class GetSendQuotaCommand extends $Command< GetSendQuotaCommandInput, GetSendQuotaCommandOutput, @@ -31,6 +35,9 @@ export class GetSendQuotaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetSendStatisticsCommand.ts b/clients/client-ses/commands/GetSendStatisticsCommand.ts index b1c89424f8e48..84e943107bd52 100644 --- a/clients/client-ses/commands/GetSendStatisticsCommand.ts +++ b/clients/client-ses/commands/GetSendStatisticsCommand.ts @@ -20,6 +20,12 @@ import { export type GetSendStatisticsCommandInput = {}; export type GetSendStatisticsCommandOutput = GetSendStatisticsResponse & __MetadataBearer; +/** + *

Provides sending statistics for the current AWS Region. The result is a list of data + * points, representing the last two weeks of sending activity. Each data point in the list + * contains statistics for a 15-minute period of time.

+ *

You can execute this operation no more than once per second.

+ */ export class GetSendStatisticsCommand extends $Command< GetSendStatisticsCommandInput, GetSendStatisticsCommandOutput, @@ -34,6 +40,9 @@ export class GetSendStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/GetTemplateCommand.ts b/clients/client-ses/commands/GetTemplateCommand.ts index 240def09fdf84..081b66f9c716f 100644 --- a/clients/client-ses/commands/GetTemplateCommand.ts +++ b/clients/client-ses/commands/GetTemplateCommand.ts @@ -17,6 +17,11 @@ import { export type GetTemplateCommandInput = GetTemplateRequest; export type GetTemplateCommandOutput = GetTemplateResponse & __MetadataBearer; +/** + *

Displays the template object (which includes the Subject line, HTML part and text + * part) for the template you specify.

+ *

You can execute this operation no more than once per second.

+ */ export class GetTemplateCommand extends $Command< GetTemplateCommandInput, GetTemplateCommandOutput, @@ -31,6 +36,9 @@ export class GetTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ListConfigurationSetsCommand.ts b/clients/client-ses/commands/ListConfigurationSetsCommand.ts index 95f9c851ac39f..1d966de094481 100644 --- a/clients/client-ses/commands/ListConfigurationSetsCommand.ts +++ b/clients/client-ses/commands/ListConfigurationSetsCommand.ts @@ -20,6 +20,18 @@ import { export type ListConfigurationSetsCommandInput = ListConfigurationSetsRequest; export type ListConfigurationSetsCommandOutput = ListConfigurationSetsResponse & __MetadataBearer; +/** + *

Provides a list of the configuration sets associated with your Amazon SES account in the + * current AWS Region. For information about using configuration sets, see Monitoring Your Amazon SES Sending Activity in the Amazon SES Developer + * Guide. + *

+ *

You can execute this operation no more than once per second. This operation will + * return up to 1,000 configuration sets each time it is run. If your Amazon SES account has + * more than 1,000 configuration sets, this operation will also return a NextToken element. + * You can then execute the ListConfigurationSets operation again, passing the + * NextToken parameter and the value of the NextToken element to retrieve + * additional results.

+ */ export class ListConfigurationSetsCommand extends $Command< ListConfigurationSetsCommandInput, ListConfigurationSetsCommandOutput, @@ -34,6 +46,9 @@ export class ListConfigurationSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ListCustomVerificationEmailTemplatesCommand.ts b/clients/client-ses/commands/ListCustomVerificationEmailTemplatesCommand.ts index 46cdd6c23f431..1b0f67fd44642 100644 --- a/clients/client-ses/commands/ListCustomVerificationEmailTemplatesCommand.ts +++ b/clients/client-ses/commands/ListCustomVerificationEmailTemplatesCommand.ts @@ -24,6 +24,13 @@ export type ListCustomVerificationEmailTemplatesCommandInput = ListCustomVerific export type ListCustomVerificationEmailTemplatesCommandOutput = ListCustomVerificationEmailTemplatesResponse & __MetadataBearer; +/** + *

Lists the existing custom verification email templates for your account in the current + * AWS Region.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class ListCustomVerificationEmailTemplatesCommand extends $Command< ListCustomVerificationEmailTemplatesCommandInput, ListCustomVerificationEmailTemplatesCommandOutput, @@ -38,6 +45,9 @@ export class ListCustomVerificationEmailTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ListIdentitiesCommand.ts b/clients/client-ses/commands/ListIdentitiesCommand.ts index 78e727d418a3e..6396ed847e77a 100644 --- a/clients/client-ses/commands/ListIdentitiesCommand.ts +++ b/clients/client-ses/commands/ListIdentitiesCommand.ts @@ -20,6 +20,11 @@ import { export type ListIdentitiesCommandInput = ListIdentitiesRequest; export type ListIdentitiesCommandOutput = ListIdentitiesResponse & __MetadataBearer; +/** + *

Returns a list containing all of the identities (email addresses and domains) for your + * AWS account in the current AWS Region, regardless of verification status.

+ *

You can execute this operation no more than once per second.

+ */ export class ListIdentitiesCommand extends $Command< ListIdentitiesCommandInput, ListIdentitiesCommandOutput, @@ -34,6 +39,9 @@ export class ListIdentitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ListIdentityPoliciesCommand.ts b/clients/client-ses/commands/ListIdentityPoliciesCommand.ts index 4cee7332b1585..1f51302f9b850 100644 --- a/clients/client-ses/commands/ListIdentityPoliciesCommand.ts +++ b/clients/client-ses/commands/ListIdentityPoliciesCommand.ts @@ -20,6 +20,20 @@ import { export type ListIdentityPoliciesCommandInput = ListIdentityPoliciesRequest; export type ListIdentityPoliciesCommandOutput = ListIdentityPoliciesResponse & __MetadataBearer; +/** + *

Returns a list of sending authorization policies that are attached to the given + * identity (an email address or a domain). This API returns only a list. If you want the + * actual policy content, you can use GetIdentityPolicies.

+ * + *

This API is for the identity owner only. If you have not verified the identity, + * this API will return an error.

+ *
+ *

Sending authorization is a feature that enables an identity owner to authorize other + * senders to use its identities. For information about using sending authorization, see + * the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class ListIdentityPoliciesCommand extends $Command< ListIdentityPoliciesCommandInput, ListIdentityPoliciesCommandOutput, @@ -34,6 +48,9 @@ export class ListIdentityPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ListReceiptFiltersCommand.ts b/clients/client-ses/commands/ListReceiptFiltersCommand.ts index 9a1541446b63f..f39dfd399544e 100644 --- a/clients/client-ses/commands/ListReceiptFiltersCommand.ts +++ b/clients/client-ses/commands/ListReceiptFiltersCommand.ts @@ -20,6 +20,13 @@ import { export type ListReceiptFiltersCommandInput = ListReceiptFiltersRequest; export type ListReceiptFiltersCommandOutput = ListReceiptFiltersResponse & __MetadataBearer; +/** + *

Lists the IP address filters associated with your AWS account in the current AWS + * Region.

+ *

For information about managing IP address filters, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class ListReceiptFiltersCommand extends $Command< ListReceiptFiltersCommandInput, ListReceiptFiltersCommandOutput, @@ -34,6 +41,9 @@ export class ListReceiptFiltersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ListReceiptRuleSetsCommand.ts b/clients/client-ses/commands/ListReceiptRuleSetsCommand.ts index c1cde4ad6aafc..07f42713ce91a 100644 --- a/clients/client-ses/commands/ListReceiptRuleSetsCommand.ts +++ b/clients/client-ses/commands/ListReceiptRuleSetsCommand.ts @@ -20,6 +20,14 @@ import { export type ListReceiptRuleSetsCommandInput = ListReceiptRuleSetsRequest; export type ListReceiptRuleSetsCommandOutput = ListReceiptRuleSetsResponse & __MetadataBearer; +/** + *

Lists the receipt rule sets that exist under your AWS account in the current AWS + * Region. If there are additional receipt rule sets to be retrieved, you will receive a + * NextToken that you can provide to the next call to + * ListReceiptRuleSets to retrieve the additional entries.

+ *

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class ListReceiptRuleSetsCommand extends $Command< ListReceiptRuleSetsCommandInput, ListReceiptRuleSetsCommandOutput, @@ -34,6 +42,9 @@ export class ListReceiptRuleSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ListTemplatesCommand.ts b/clients/client-ses/commands/ListTemplatesCommand.ts index c6051339c9dd5..7bd53588acf99 100644 --- a/clients/client-ses/commands/ListTemplatesCommand.ts +++ b/clients/client-ses/commands/ListTemplatesCommand.ts @@ -20,6 +20,11 @@ import { export type ListTemplatesCommandInput = ListTemplatesRequest; export type ListTemplatesCommandOutput = ListTemplatesResponse & __MetadataBearer; +/** + *

Lists the email templates present in your Amazon SES account in the current AWS + * Region.

+ *

You can execute this operation no more than once per second.

+ */ export class ListTemplatesCommand extends $Command< ListTemplatesCommandInput, ListTemplatesCommandOutput, @@ -34,6 +39,9 @@ export class ListTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ListVerifiedEmailAddressesCommand.ts b/clients/client-ses/commands/ListVerifiedEmailAddressesCommand.ts index 47af58baeb198..0277d12f768ba 100644 --- a/clients/client-ses/commands/ListVerifiedEmailAddressesCommand.ts +++ b/clients/client-ses/commands/ListVerifiedEmailAddressesCommand.ts @@ -20,6 +20,10 @@ import { export type ListVerifiedEmailAddressesCommandInput = {}; export type ListVerifiedEmailAddressesCommandOutput = ListVerifiedEmailAddressesResponse & __MetadataBearer; +/** + *

Deprecated. Use the ListIdentities operation to list the email addresses + * and domains associated with your account.

+ */ export class ListVerifiedEmailAddressesCommand extends $Command< ListVerifiedEmailAddressesCommandInput, ListVerifiedEmailAddressesCommandOutput, @@ -34,6 +38,9 @@ export class ListVerifiedEmailAddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/PutConfigurationSetDeliveryOptionsCommand.ts b/clients/client-ses/commands/PutConfigurationSetDeliveryOptionsCommand.ts index fb0b54b4f6006..ab07ddb44f85f 100644 --- a/clients/client-ses/commands/PutConfigurationSetDeliveryOptionsCommand.ts +++ b/clients/client-ses/commands/PutConfigurationSetDeliveryOptionsCommand.ts @@ -24,6 +24,9 @@ export type PutConfigurationSetDeliveryOptionsCommandInput = PutConfigurationSet export type PutConfigurationSetDeliveryOptionsCommandOutput = PutConfigurationSetDeliveryOptionsResponse & __MetadataBearer; +/** + *

Adds or updates the delivery options for a configuration set.

+ */ export class PutConfigurationSetDeliveryOptionsCommand extends $Command< PutConfigurationSetDeliveryOptionsCommandInput, PutConfigurationSetDeliveryOptionsCommandOutput, @@ -38,6 +41,9 @@ export class PutConfigurationSetDeliveryOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/PutIdentityPolicyCommand.ts b/clients/client-ses/commands/PutIdentityPolicyCommand.ts index b5f9e7191b268..1b73564758cde 100644 --- a/clients/client-ses/commands/PutIdentityPolicyCommand.ts +++ b/clients/client-ses/commands/PutIdentityPolicyCommand.ts @@ -20,6 +20,19 @@ import { export type PutIdentityPolicyCommandInput = PutIdentityPolicyRequest; export type PutIdentityPolicyCommandOutput = PutIdentityPolicyResponse & __MetadataBearer; +/** + *

Adds or updates a sending authorization policy for the specified identity (an email + * address or a domain).

+ * + *

This API is for the identity owner only. If you have not verified the identity, + * this API will return an error.

+ *
+ *

Sending authorization is a feature that enables an identity owner to authorize other + * senders to use its identities. For information about using sending authorization, see + * the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class PutIdentityPolicyCommand extends $Command< PutIdentityPolicyCommandInput, PutIdentityPolicyCommandOutput, @@ -34,6 +47,9 @@ export class PutIdentityPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/ReorderReceiptRuleSetCommand.ts b/clients/client-ses/commands/ReorderReceiptRuleSetCommand.ts index e557102b90b1e..89fbf684a499a 100644 --- a/clients/client-ses/commands/ReorderReceiptRuleSetCommand.ts +++ b/clients/client-ses/commands/ReorderReceiptRuleSetCommand.ts @@ -20,6 +20,16 @@ import { export type ReorderReceiptRuleSetCommandInput = ReorderReceiptRuleSetRequest; export type ReorderReceiptRuleSetCommandOutput = ReorderReceiptRuleSetResponse & __MetadataBearer; +/** + *

Reorders the receipt rules within a receipt rule set.

+ * + *

All of the rules in the rule set must be represented in this request. That is, + * this API will return an error if the reorder request doesn't explicitly position all + * of the rules.

+ *
+ *

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class ReorderReceiptRuleSetCommand extends $Command< ReorderReceiptRuleSetCommandInput, ReorderReceiptRuleSetCommandOutput, @@ -34,6 +44,9 @@ export class ReorderReceiptRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SendBounceCommand.ts b/clients/client-ses/commands/SendBounceCommand.ts index c04d42022f333..3af86c51562e7 100644 --- a/clients/client-ses/commands/SendBounceCommand.ts +++ b/clients/client-ses/commands/SendBounceCommand.ts @@ -17,6 +17,17 @@ import { export type SendBounceCommandInput = SendBounceRequest; export type SendBounceCommandOutput = SendBounceResponse & __MetadataBearer; +/** + *

Generates and sends a bounce message to the sender of an email you received through + * Amazon SES. You can only use this API on an email up to 24 hours after you receive it.

+ * + *

You cannot use this API to send generic bounces for mail that was not received by + * Amazon SES.

+ *
+ *

For information about receiving email through Amazon SES, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class SendBounceCommand extends $Command< SendBounceCommandInput, SendBounceCommandOutput, @@ -31,6 +42,9 @@ export class SendBounceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SendBulkTemplatedEmailCommand.ts b/clients/client-ses/commands/SendBulkTemplatedEmailCommand.ts index 6b34fa2efe189..9ad24c96867ae 100644 --- a/clients/client-ses/commands/SendBulkTemplatedEmailCommand.ts +++ b/clients/client-ses/commands/SendBulkTemplatedEmailCommand.ts @@ -20,6 +20,51 @@ import { export type SendBulkTemplatedEmailCommandInput = SendBulkTemplatedEmailRequest; export type SendBulkTemplatedEmailCommandOutput = SendBulkTemplatedEmailResponse & __MetadataBearer; +/** + *

Composes an email message to multiple destinations. The message body is created using + * an email template.

+ *

In order to send email using the SendBulkTemplatedEmail operation, your + * call to the API must meet the following requirements:

+ *
    + *
  • + *

    The call must refer to an existing email template. You can create email + * templates using the CreateTemplate operation.

    + *
  • + *
  • + *

    The message must be sent from a verified email address or domain.

    + *
  • + *
  • + *

    If your account is still in the Amazon SES sandbox, you may only send to verified + * addresses or domains, or to email addresses associated with the Amazon SES Mailbox + * Simulator. For more information, see Verifying + * Email Addresses and Domains in the Amazon SES Developer + * Guide. + *

    + *
  • + *
  • + *

    The maximum message size is 10 MB.

    + *
  • + *
  • + *

    Each Destination parameter must include at least one recipient + * email address. The recipient address can be a To: address, a CC: address, or a + * BCC: address. If a recipient email address is invalid (that is, it is not in the + * format UserName@[SubDomain.]Domain.TopLevelDomain), the + * entire message will be rejected, even if the message contains other recipients + * that are valid.

    + *
  • + *
  • + *

    The message may not include more than 50 recipients, across the To:, CC: and + * BCC: fields. If you need to send an email message to a larger audience, you can + * divide your recipient list into groups of 50 or fewer, and then call the + * SendBulkTemplatedEmail operation several times to send the + * message to each group.

    + *
  • + *
  • + *

    The number of destinations you can contact in a single call to the API may be + * limited by your account's maximum sending rate.

    + *
  • + *
+ */ export class SendBulkTemplatedEmailCommand extends $Command< SendBulkTemplatedEmailCommandInput, SendBulkTemplatedEmailCommandOutput, @@ -34,6 +79,9 @@ export class SendBulkTemplatedEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SendCustomVerificationEmailCommand.ts b/clients/client-ses/commands/SendCustomVerificationEmailCommand.ts index 9f299927b8f04..7bc61224cad8d 100644 --- a/clients/client-ses/commands/SendCustomVerificationEmailCommand.ts +++ b/clients/client-ses/commands/SendCustomVerificationEmailCommand.ts @@ -20,6 +20,17 @@ import { export type SendCustomVerificationEmailCommandInput = SendCustomVerificationEmailRequest; export type SendCustomVerificationEmailCommandOutput = SendCustomVerificationEmailResponse & __MetadataBearer; +/** + *

Adds an email address to the list of identities for your Amazon SES account in the current + * AWS Region and attempts to verify it. As a result of executing this operation, a + * customized verification email is sent to the specified address.

+ *

To use this operation, you must first create a custom verification email template. For + * more information about creating and using custom verification email templates, see + * Using Custom + * Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class SendCustomVerificationEmailCommand extends $Command< SendCustomVerificationEmailCommandInput, SendCustomVerificationEmailCommandOutput, @@ -34,6 +45,9 @@ export class SendCustomVerificationEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SendEmailCommand.ts b/clients/client-ses/commands/SendEmailCommand.ts index 4f46117b0cc2c..40e253233c4df 100644 --- a/clients/client-ses/commands/SendEmailCommand.ts +++ b/clients/client-ses/commands/SendEmailCommand.ts @@ -17,6 +17,53 @@ import { export type SendEmailCommandInput = SendEmailRequest; export type SendEmailCommandOutput = SendEmailResponse & __MetadataBearer; +/** + *

Composes an email message and immediately queues it for sending. In order to send + * email using the SendEmail operation, your message must meet the following + * requirements:

+ * + *
    + *
  • + *

    The message must be sent from a verified email address or domain. If you + * attempt to send email using a non-verified address or domain, the operation will + * result in an "Email address not verified" error.

    + *
  • + *
  • + *

    If your account is still in the Amazon SES sandbox, you may only send to verified + * addresses or domains, or to email addresses associated with the Amazon SES Mailbox + * Simulator. For more information, see Verifying + * Email Addresses and Domains in the Amazon SES Developer + * Guide. + *

    + *
  • + *
  • + *

    The maximum message size is 10 MB.

    + *
  • + *
  • + *

    The message must include at least one recipient email address. The recipient + * address can be a To: address, a CC: address, or a BCC: address. If a recipient + * email address is invalid (that is, it is not in the format + * UserName@[SubDomain.]Domain.TopLevelDomain), the entire + * message will be rejected, even if the message contains other recipients that are + * valid.

    + *
  • + *
  • + *

    The message may not include more than 50 recipients, across the To:, CC: and + * BCC: fields. If you need to send an email message to a larger audience, you can + * divide your recipient list into groups of 50 or fewer, and then call the + * SendEmail operation several times to send the message to each + * group.

    + *
  • + *
+ * + *

For every message that you send, the total number of recipients (including each + * recipient in the To:, CC: and BCC: fields) is counted against the maximum number of + * emails you can send in a 24-hour period (your sending quota). + * For more information about sending quotas in Amazon SES, see Managing Your Amazon SES + * Sending Limits in the Amazon SES Developer Guide. + *

+ *
+ */ export class SendEmailCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +74,9 @@ export class SendEmailCommand extends $Command, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SendRawEmailCommand.ts b/clients/client-ses/commands/SendRawEmailCommand.ts index 18188860143b4..7bbd6d88fd822 100644 --- a/clients/client-ses/commands/SendRawEmailCommand.ts +++ b/clients/client-ses/commands/SendRawEmailCommand.ts @@ -17,6 +17,117 @@ import { export type SendRawEmailCommandInput = SendRawEmailRequest; export type SendRawEmailCommandOutput = SendRawEmailResponse & __MetadataBearer; +/** + *

Composes an email message and immediately queues it for sending.

+ * + *

This operation is more flexible than the SendEmail API operation. When + * you use the SendRawEmail operation, you can specify the headers of the + * message as well as its content. This flexibility is useful, for example, when you want + * to send a multipart MIME email (such a message that contains both a text and an HTML + * version). You can also use this operation to send messages that include + * attachments.

+ *

The SendRawEmail operation has the following requirements:

+ *
    + *
  • + *

    You can only send email from verified email addresses or domains. If you try + * to send email from an address that isn't verified, the operation results in an + * "Email address not verified" error.

    + *
  • + *
  • + *

    If your account is still in the Amazon SES sandbox, you can only send email to other + * verified addresses in your account, or to addresses that are associated with the + * Amazon SES mailbox simulator.

    + *
  • + *
  • + *

    The maximum message size, including attachments, is 10 MB.

    + *
  • + *
  • + *

    Each message has to include at least one recipient address. A recipient + * address includes any address on the To:, CC:, or BCC: lines.

    + *
  • + *
  • + *

    If you send a single message to more than one recipient address, and one of + * the recipient addresses isn't in a valid format (that is, it's not in the format + * UserName@[SubDomain.]Domain.TopLevelDomain), Amazon SES + * rejects the entire message, even if the other addresses are valid.

    + *
  • + *
  • + *

    Each message can include up to 50 recipient addresses across the To:, CC:, or + * BCC: lines. If you need to send a single message to more than 50 recipients, you + * have to split the list of recipient addresses into groups of less than 50 + * recipients, and send separate messages to each group.

    + *
  • + *
  • + *

    Amazon SES allows you to specify 8-bit Content-Transfer-Encoding for MIME message + * parts. However, if Amazon SES has to modify the contents of your message (for + * example, if you use open and click tracking), 8-bit content isn't preserved. For + * this reason, we highly recommend that you encode all content that isn't 7-bit + * ASCII. For more information, see MIME Encoding in the Amazon SES Developer + * Guide.

    + *
  • + *
+ * + * + * + *

Additionally, keep the following considerations in mind when using the + * SendRawEmail operation:

+ * + *
    + *
  • + *

    Although you can customize the message headers when using the + * SendRawEmail operation, Amazon SES will automatically apply its own + * Message-ID and Date headers; if you passed these + * headers when creating the message, they will be overwritten by the values that + * Amazon SES provides.

    + *
  • + *
  • + *

    If you are using sending authorization to send on behalf of another user, + * SendRawEmail enables you to specify the cross-account identity + * for the email's Source, From, and Return-Path parameters in one of two ways: you + * can pass optional parameters SourceArn, FromArn, + * and/or ReturnPathArn to the API, or you can include the following + * X-headers in the header of your raw email:

    + *
      + *
    • + *

      + * X-SES-SOURCE-ARN + *

      + *
    • + *
    • + *

      + * X-SES-FROM-ARN + *

      + *
    • + *
    • + *

      + * X-SES-RETURN-PATH-ARN + *

      + *
    • + *
    + * + *

    Don't include these X-headers in the DKIM signature. Amazon SES removes these + * before it sends the email.

    + *
    + *

    If you only specify the SourceIdentityArn parameter, Amazon SES sets + * the From and Return-Path addresses to the same identity that you + * specified.

    + *

    For more information about sending authorization, see the Using Sending + * Authorization with Amazon SES in the Amazon SES Developer + * Guide. + *

    + *
  • + *
  • + *

    For every message that you send, the total number of recipients (including + * each recipient in the To:, CC: and BCC: fields) is counted against the maximum + * number of emails you can send in a 24-hour period (your sending + * quota). For more information about sending quotas in Amazon SES, see + * Managing Your + * Amazon SES Sending Limits in the Amazon SES Developer + * Guide. + *

    + *
  • + *
+ */ export class SendRawEmailCommand extends $Command< SendRawEmailCommandInput, SendRawEmailCommandOutput, @@ -31,6 +142,9 @@ export class SendRawEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SendTemplatedEmailCommand.ts b/clients/client-ses/commands/SendTemplatedEmailCommand.ts index 4ccc078e41f71..f4d39d1ba4c2f 100644 --- a/clients/client-ses/commands/SendTemplatedEmailCommand.ts +++ b/clients/client-ses/commands/SendTemplatedEmailCommand.ts @@ -20,6 +20,58 @@ import { export type SendTemplatedEmailCommandInput = SendTemplatedEmailRequest; export type SendTemplatedEmailCommandOutput = SendTemplatedEmailResponse & __MetadataBearer; +/** + *

Composes an email message using an email template and immediately queues it for + * sending.

+ *

In order to send email using the SendTemplatedEmail operation, your call + * to the API must meet the following requirements:

+ *
    + *
  • + *

    The call must refer to an existing email template. You can create email + * templates using the CreateTemplate operation.

    + *
  • + *
  • + *

    The message must be sent from a verified email address or domain.

    + *
  • + *
  • + *

    If your account is still in the Amazon SES sandbox, you may only send to verified + * addresses or domains, or to email addresses associated with the Amazon SES Mailbox + * Simulator. For more information, see Verifying + * Email Addresses and Domains in the Amazon SES Developer + * Guide. + *

    + *
  • + *
  • + *

    The maximum message size is 10 MB.

    + *
  • + *
  • + *

    Calls to the SendTemplatedEmail operation may only include one + * Destination parameter. A destination is a set of recipients who + * will receive the same version of the email. The Destination + * parameter can include up to 50 recipients, across the To:, CC: and BCC: + * fields.

    + *
  • + *
  • + *

    The Destination parameter must include at least one recipient + * email address. The recipient address can be a To: address, a CC: address, or a + * BCC: address. If a recipient email address is invalid (that is, it is not in the + * format UserName@[SubDomain.]Domain.TopLevelDomain), the + * entire message will be rejected, even if the message contains other recipients + * that are valid.

    + *
  • + *
+ * + *

If your call to the SendTemplatedEmail operation includes all of the + * required parameters, Amazon SES accepts it and returns a Message ID. However, if Amazon SES + * can't render the email because the template contains errors, it doesn't send the + * email. Additionally, because it already accepted the message, Amazon SES doesn't return a + * message stating that it was unable to send the email.

+ *

For these reasons, we highly recommend that you set up Amazon SES to send you + * notifications when Rendering Failure events occur. For more information, see Sending + * Personalized Email Using the Amazon SES API in the Amazon Simple Email Service + * Developer Guide.

+ *
+ */ export class SendTemplatedEmailCommand extends $Command< SendTemplatedEmailCommandInput, SendTemplatedEmailCommandOutput, @@ -34,6 +86,9 @@ export class SendTemplatedEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SetActiveReceiptRuleSetCommand.ts b/clients/client-ses/commands/SetActiveReceiptRuleSetCommand.ts index ce37596dd6919..d23e337767500 100644 --- a/clients/client-ses/commands/SetActiveReceiptRuleSetCommand.ts +++ b/clients/client-ses/commands/SetActiveReceiptRuleSetCommand.ts @@ -20,6 +20,15 @@ import { export type SetActiveReceiptRuleSetCommandInput = SetActiveReceiptRuleSetRequest; export type SetActiveReceiptRuleSetCommandOutput = SetActiveReceiptRuleSetResponse & __MetadataBearer; +/** + *

Sets the specified receipt rule set as the active receipt rule set.

+ * + *

To disable your email-receiving through Amazon SES completely, you can call this API + * with RuleSetName set to null.

+ *
+ *

For information about managing receipt rule sets, see the Amazon SES Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class SetActiveReceiptRuleSetCommand extends $Command< SetActiveReceiptRuleSetCommandInput, SetActiveReceiptRuleSetCommandOutput, @@ -34,6 +43,9 @@ export class SetActiveReceiptRuleSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SetIdentityDkimEnabledCommand.ts b/clients/client-ses/commands/SetIdentityDkimEnabledCommand.ts index 6d4c7a26bd2bc..af640b81c4f6f 100644 --- a/clients/client-ses/commands/SetIdentityDkimEnabledCommand.ts +++ b/clients/client-ses/commands/SetIdentityDkimEnabledCommand.ts @@ -20,6 +20,21 @@ import { export type SetIdentityDkimEnabledCommandInput = SetIdentityDkimEnabledRequest; export type SetIdentityDkimEnabledCommandOutput = SetIdentityDkimEnabledResponse & __MetadataBearer; +/** + *

Enables or disables Easy DKIM signing of email sent from an identity. If Easy DKIM + * signing is enabled for a domain, then Amazon SES uses DKIM to sign all email that it sends + * from addresses on that domain. If Easy DKIM signing is enabled for an email address, + * then Amazon SES uses DKIM to sign all email it sends from that address.

+ * + *

For email addresses (for example, user@example.com), you can only + * enable DKIM signing if the corresponding domain (in this case, + * example.com) has been set up to use Easy DKIM.

+ *
+ *

You can enable DKIM signing for an identity at any time after you start the + * verification process for the identity, even if the verification process isn't complete.

+ *

You can execute this operation no more than once per second.

+ *

For more information about Easy DKIM signing, go to the Amazon SES Developer Guide.

+ */ export class SetIdentityDkimEnabledCommand extends $Command< SetIdentityDkimEnabledCommandInput, SetIdentityDkimEnabledCommandOutput, @@ -34,6 +49,9 @@ export class SetIdentityDkimEnabledCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SetIdentityFeedbackForwardingEnabledCommand.ts b/clients/client-ses/commands/SetIdentityFeedbackForwardingEnabledCommand.ts index 39f4759334aa2..ba34d792d7f37 100644 --- a/clients/client-ses/commands/SetIdentityFeedbackForwardingEnabledCommand.ts +++ b/clients/client-ses/commands/SetIdentityFeedbackForwardingEnabledCommand.ts @@ -24,6 +24,19 @@ export type SetIdentityFeedbackForwardingEnabledCommandInput = SetIdentityFeedba export type SetIdentityFeedbackForwardingEnabledCommandOutput = SetIdentityFeedbackForwardingEnabledResponse & __MetadataBearer; +/** + *

Given an identity (an email address or a domain), enables or disables whether Amazon SES + * forwards bounce and complaint notifications as email. Feedback forwarding can only be + * disabled when Amazon Simple Notification Service (Amazon SNS) topics are specified for both bounces and + * complaints.

+ * + *

Feedback forwarding does not apply to delivery notifications. Delivery + * notifications are only available through Amazon SNS.

+ *
+ *

You can execute this operation no more than once per second.

+ *

For more information about using notifications with Amazon SES, see the Amazon SES + * Developer Guide.

+ */ export class SetIdentityFeedbackForwardingEnabledCommand extends $Command< SetIdentityFeedbackForwardingEnabledCommandInput, SetIdentityFeedbackForwardingEnabledCommandOutput, @@ -38,6 +51,9 @@ export class SetIdentityFeedbackForwardingEnabledCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SetIdentityHeadersInNotificationsEnabledCommand.ts b/clients/client-ses/commands/SetIdentityHeadersInNotificationsEnabledCommand.ts index 503b978055583..d2345df71984a 100644 --- a/clients/client-ses/commands/SetIdentityHeadersInNotificationsEnabledCommand.ts +++ b/clients/client-ses/commands/SetIdentityHeadersInNotificationsEnabledCommand.ts @@ -24,6 +24,14 @@ export type SetIdentityHeadersInNotificationsEnabledCommandInput = SetIdentityHe export type SetIdentityHeadersInNotificationsEnabledCommandOutput = SetIdentityHeadersInNotificationsEnabledResponse & __MetadataBearer; +/** + *

Given an identity (an email address or a domain), sets whether Amazon SES includes the + * original email headers in the Amazon Simple Notification Service (Amazon SNS) notifications of a specified + * type.

+ *

You can execute this operation no more than once per second.

+ *

For more information about using notifications with Amazon SES, see the Amazon SES + * Developer Guide.

+ */ export class SetIdentityHeadersInNotificationsEnabledCommand extends $Command< SetIdentityHeadersInNotificationsEnabledCommandInput, SetIdentityHeadersInNotificationsEnabledCommandOutput, @@ -38,6 +46,9 @@ export class SetIdentityHeadersInNotificationsEnabledCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SetIdentityMailFromDomainCommand.ts b/clients/client-ses/commands/SetIdentityMailFromDomainCommand.ts index 76eceac35c01b..db78d9e5858d6 100644 --- a/clients/client-ses/commands/SetIdentityMailFromDomainCommand.ts +++ b/clients/client-ses/commands/SetIdentityMailFromDomainCommand.ts @@ -20,6 +20,18 @@ import { export type SetIdentityMailFromDomainCommandInput = SetIdentityMailFromDomainRequest; export type SetIdentityMailFromDomainCommandOutput = SetIdentityMailFromDomainResponse & __MetadataBearer; +/** + *

Enables or disables the custom MAIL FROM domain setup for a verified identity (an + * email address or a domain).

+ * + *

To send emails using the specified MAIL FROM domain, you must add an MX record to + * your MAIL FROM domain's DNS settings. If you want your emails to pass Sender Policy + * Framework (SPF) checks, you must also add or update an SPF record. For more + * information, see the Amazon SES Developer + * Guide.

+ *
+ *

You can execute this operation no more than once per second.

+ */ export class SetIdentityMailFromDomainCommand extends $Command< SetIdentityMailFromDomainCommandInput, SetIdentityMailFromDomainCommandOutput, @@ -34,6 +46,9 @@ export class SetIdentityMailFromDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SetIdentityNotificationTopicCommand.ts b/clients/client-ses/commands/SetIdentityNotificationTopicCommand.ts index 0f962dd1bbb51..18b3accdb4c9b 100644 --- a/clients/client-ses/commands/SetIdentityNotificationTopicCommand.ts +++ b/clients/client-ses/commands/SetIdentityNotificationTopicCommand.ts @@ -20,6 +20,17 @@ import { export type SetIdentityNotificationTopicCommandInput = SetIdentityNotificationTopicRequest; export type SetIdentityNotificationTopicCommandOutput = SetIdentityNotificationTopicResponse & __MetadataBearer; +/** + *

Sets an Amazon Simple Notification Service (Amazon SNS) topic to use when delivering notifications. When you use + * this operation, you specify a verified identity, such as an email address or domain. + * When you send an email that uses the chosen identity in the Source field, Amazon SES sends + * notifications to the topic you specified. You can send bounce, complaint, or delivery + * notifications (or any combination of the three) to the Amazon SNS topic that you + * specify.

+ *

You can execute this operation no more than once per second.

+ *

For more information about feedback notification, see the Amazon SES Developer + * Guide.

+ */ export class SetIdentityNotificationTopicCommand extends $Command< SetIdentityNotificationTopicCommandInput, SetIdentityNotificationTopicCommandOutput, @@ -34,6 +45,9 @@ export class SetIdentityNotificationTopicCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/SetReceiptRulePositionCommand.ts b/clients/client-ses/commands/SetReceiptRulePositionCommand.ts index 9e8d80bdb8a6f..82139fae53779 100644 --- a/clients/client-ses/commands/SetReceiptRulePositionCommand.ts +++ b/clients/client-ses/commands/SetReceiptRulePositionCommand.ts @@ -20,6 +20,12 @@ import { export type SetReceiptRulePositionCommandInput = SetReceiptRulePositionRequest; export type SetReceiptRulePositionCommandOutput = SetReceiptRulePositionResponse & __MetadataBearer; +/** + *

Sets the position of the specified receipt rule in the receipt rule set.

+ *

For information about managing receipt rules, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class SetReceiptRulePositionCommand extends $Command< SetReceiptRulePositionCommandInput, SetReceiptRulePositionCommandOutput, @@ -34,6 +40,9 @@ export class SetReceiptRulePositionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/TestRenderTemplateCommand.ts b/clients/client-ses/commands/TestRenderTemplateCommand.ts index 4396a55c7cdd9..52bee5fe8bdeb 100644 --- a/clients/client-ses/commands/TestRenderTemplateCommand.ts +++ b/clients/client-ses/commands/TestRenderTemplateCommand.ts @@ -20,6 +20,11 @@ import { export type TestRenderTemplateCommandInput = TestRenderTemplateRequest; export type TestRenderTemplateCommandOutput = TestRenderTemplateResponse & __MetadataBearer; +/** + *

Creates a preview of the MIME content of an email when provided with a template and a + * set of replacement data.

+ *

You can execute this operation no more than once per second.

+ */ export class TestRenderTemplateCommand extends $Command< TestRenderTemplateCommandInput, TestRenderTemplateCommandOutput, @@ -34,6 +39,9 @@ export class TestRenderTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/UpdateAccountSendingEnabledCommand.ts b/clients/client-ses/commands/UpdateAccountSendingEnabledCommand.ts index 524b44d440223..14b552470ee5f 100644 --- a/clients/client-ses/commands/UpdateAccountSendingEnabledCommand.ts +++ b/clients/client-ses/commands/UpdateAccountSendingEnabledCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateAccountSendingEnabledCommandInput = UpdateAccountSendingEnabledRequest; export type UpdateAccountSendingEnabledCommandOutput = __MetadataBearer; +/** + *

Enables or disables email sending across your entire Amazon SES account in the current + * AWS Region. You can use this operation in conjunction with Amazon CloudWatch alarms to + * temporarily pause email sending across your Amazon SES account in a given AWS Region when + * reputation metrics (such as your bounce or complaint rates) reach certain + * thresholds.

+ *

You can execute this operation no more than once per second.

+ */ export class UpdateAccountSendingEnabledCommand extends $Command< UpdateAccountSendingEnabledCommandInput, UpdateAccountSendingEnabledCommandOutput, @@ -34,6 +42,9 @@ export class UpdateAccountSendingEnabledCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/UpdateConfigurationSetEventDestinationCommand.ts b/clients/client-ses/commands/UpdateConfigurationSetEventDestinationCommand.ts index eb86fdd4549f5..ff3972b0671f4 100644 --- a/clients/client-ses/commands/UpdateConfigurationSetEventDestinationCommand.ts +++ b/clients/client-ses/commands/UpdateConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,20 @@ export type UpdateConfigurationSetEventDestinationCommandInput = UpdateConfigura export type UpdateConfigurationSetEventDestinationCommandOutput = UpdateConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Updates the event destination of a configuration set. Event destinations are + * associated with configuration sets, which enable you to publish email sending events to + * Amazon CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon SNS). For information about using configuration sets, + * see Monitoring Your Amazon SES + * Sending Activity in the Amazon SES Developer Guide. + *

+ * + *

When you create or update an event destination, you must provide one, and only + * one, destination. The destination can be Amazon CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification Service + * (Amazon SNS).

+ *
+ *

You can execute this operation no more than once per second.

+ */ export class UpdateConfigurationSetEventDestinationCommand extends $Command< UpdateConfigurationSetEventDestinationCommandInput, UpdateConfigurationSetEventDestinationCommandOutput, @@ -38,6 +52,9 @@ export class UpdateConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/UpdateConfigurationSetReputationMetricsEnabledCommand.ts b/clients/client-ses/commands/UpdateConfigurationSetReputationMetricsEnabledCommand.ts index c0cfb623dc439..02960067626e7 100644 --- a/clients/client-ses/commands/UpdateConfigurationSetReputationMetricsEnabledCommand.ts +++ b/clients/client-ses/commands/UpdateConfigurationSetReputationMetricsEnabledCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateConfigurationSetReputationMetricsEnabledCommandInput = UpdateConfigurationSetReputationMetricsEnabledRequest; export type UpdateConfigurationSetReputationMetricsEnabledCommandOutput = __MetadataBearer; +/** + *

Enables or disables the publishing of reputation metrics for emails sent using a + * specific configuration set in a given AWS Region. Reputation metrics include bounce + * and complaint rates. These metrics are published to Amazon CloudWatch. By using CloudWatch, you can + * create alarms when bounce or complaint rates exceed certain thresholds.

+ *

You can execute this operation no more than once per second.

+ */ export class UpdateConfigurationSetReputationMetricsEnabledCommand extends $Command< UpdateConfigurationSetReputationMetricsEnabledCommandInput, UpdateConfigurationSetReputationMetricsEnabledCommandOutput, @@ -34,6 +41,9 @@ export class UpdateConfigurationSetReputationMetricsEnabledCommand extends $Comm // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/UpdateConfigurationSetSendingEnabledCommand.ts b/clients/client-ses/commands/UpdateConfigurationSetSendingEnabledCommand.ts index 56b2f22a5ce21..39d1013b56056 100644 --- a/clients/client-ses/commands/UpdateConfigurationSetSendingEnabledCommand.ts +++ b/clients/client-ses/commands/UpdateConfigurationSetSendingEnabledCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateConfigurationSetSendingEnabledCommandInput = UpdateConfigurationSetSendingEnabledRequest; export type UpdateConfigurationSetSendingEnabledCommandOutput = __MetadataBearer; +/** + *

Enables or disables email sending for messages sent using a specific configuration set + * in a given AWS Region. You can use this operation in conjunction with Amazon CloudWatch alarms + * to temporarily pause email sending for a configuration set when the reputation metrics + * for that configuration set (such as your bounce on complaint rate) exceed certain + * thresholds.

+ *

You can execute this operation no more than once per second.

+ */ export class UpdateConfigurationSetSendingEnabledCommand extends $Command< UpdateConfigurationSetSendingEnabledCommandInput, UpdateConfigurationSetSendingEnabledCommandOutput, @@ -34,6 +42,9 @@ export class UpdateConfigurationSetSendingEnabledCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/UpdateConfigurationSetTrackingOptionsCommand.ts b/clients/client-ses/commands/UpdateConfigurationSetTrackingOptionsCommand.ts index 45fe7bcf3f6b1..f5509ca2951c9 100644 --- a/clients/client-ses/commands/UpdateConfigurationSetTrackingOptionsCommand.ts +++ b/clients/client-ses/commands/UpdateConfigurationSetTrackingOptionsCommand.ts @@ -24,6 +24,13 @@ export type UpdateConfigurationSetTrackingOptionsCommandInput = UpdateConfigurat export type UpdateConfigurationSetTrackingOptionsCommandOutput = UpdateConfigurationSetTrackingOptionsResponse & __MetadataBearer; +/** + *

Modifies an association between a configuration set and a custom domain for open and + * click event tracking.

+ *

By default, images and links used for tracking open and click events are hosted on + * domains operated by Amazon SES. You can configure a subdomain of your own to handle these + * events. For information about using custom domains, see the Amazon SES Developer Guide.

+ */ export class UpdateConfigurationSetTrackingOptionsCommand extends $Command< UpdateConfigurationSetTrackingOptionsCommandInput, UpdateConfigurationSetTrackingOptionsCommandOutput, @@ -38,6 +45,9 @@ export class UpdateConfigurationSetTrackingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/UpdateCustomVerificationEmailTemplateCommand.ts b/clients/client-ses/commands/UpdateCustomVerificationEmailTemplateCommand.ts index 18d8940978840..0b0192095e26f 100644 --- a/clients/client-ses/commands/UpdateCustomVerificationEmailTemplateCommand.ts +++ b/clients/client-ses/commands/UpdateCustomVerificationEmailTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateCustomVerificationEmailTemplateCommandInput = UpdateCustomVerificationEmailTemplateRequest; export type UpdateCustomVerificationEmailTemplateCommandOutput = __MetadataBearer; +/** + *

Updates an existing custom verification email template.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class UpdateCustomVerificationEmailTemplateCommand extends $Command< UpdateCustomVerificationEmailTemplateCommandInput, UpdateCustomVerificationEmailTemplateCommandOutput, @@ -34,6 +40,9 @@ export class UpdateCustomVerificationEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/UpdateReceiptRuleCommand.ts b/clients/client-ses/commands/UpdateReceiptRuleCommand.ts index 37e0e2a35dc51..1a555a7e4607c 100644 --- a/clients/client-ses/commands/UpdateReceiptRuleCommand.ts +++ b/clients/client-ses/commands/UpdateReceiptRuleCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateReceiptRuleCommandInput = UpdateReceiptRuleRequest; export type UpdateReceiptRuleCommandOutput = UpdateReceiptRuleResponse & __MetadataBearer; +/** + *

Updates a receipt rule.

+ *

For information about managing receipt rules, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class UpdateReceiptRuleCommand extends $Command< UpdateReceiptRuleCommandInput, UpdateReceiptRuleCommandOutput, @@ -34,6 +40,9 @@ export class UpdateReceiptRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/UpdateTemplateCommand.ts b/clients/client-ses/commands/UpdateTemplateCommand.ts index f69b0a273423f..4f7514471af0c 100644 --- a/clients/client-ses/commands/UpdateTemplateCommand.ts +++ b/clients/client-ses/commands/UpdateTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateTemplateCommandInput = UpdateTemplateRequest; export type UpdateTemplateCommandOutput = UpdateTemplateResponse & __MetadataBearer; +/** + *

Updates an email template. Email templates enable you to send personalized email to + * one or more destinations in a single API operation. For more information, see the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class UpdateTemplateCommand extends $Command< UpdateTemplateCommandInput, UpdateTemplateCommandOutput, @@ -34,6 +40,9 @@ export class UpdateTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/VerifyDomainDkimCommand.ts b/clients/client-ses/commands/VerifyDomainDkimCommand.ts index 22da11032fa00..2ab75c0e8960c 100644 --- a/clients/client-ses/commands/VerifyDomainDkimCommand.ts +++ b/clients/client-ses/commands/VerifyDomainDkimCommand.ts @@ -20,6 +20,47 @@ import { export type VerifyDomainDkimCommandInput = VerifyDomainDkimRequest; export type VerifyDomainDkimCommandOutput = VerifyDomainDkimResponse & __MetadataBearer; +/** + *

Returns a set of DKIM tokens for a domain identity.

+ * + *

When you execute the VerifyDomainDkim operation, the domain that you + * specify is added to the list of identities that are associated with your account. + * This is true even if you haven't already associated the domain with your account by + * using the VerifyDomainIdentity operation. However, you can't send email + * from the domain until you either successfully verify it or you + * successfully set up DKIM for + * it.

+ *
+ *

You use the tokens that are generated by this operation to create CNAME records. When + * Amazon SES detects that you've added these records to the DNS configuration for a domain, you + * can start sending email from that domain. You can start sending email even if you + * haven't added the TXT record provided by the VerifyDomainIdentity operation to the DNS + * configuration for your domain. All email that you send from the domain is authenticated + * using DKIM.

+ *

To create the CNAME records for DKIM authentication, use the following values:

+ *
    + *
  • + *

    + * Name: + * token._domainkey.example.com + *

    + *
  • + *
  • + *

    + * Type: CNAME

    + *
  • + *
  • + *

    + * Value: + * token.dkim.amazonses.com

    + *
  • + *
+ *

In the preceding example, replace token with one of the tokens + * that are generated when you execute this operation. Replace + * example.com with your domain. Repeat this process for each + * token that's generated by this operation.

+ *

You can execute this operation no more than once per second.

+ */ export class VerifyDomainDkimCommand extends $Command< VerifyDomainDkimCommandInput, VerifyDomainDkimCommandOutput, @@ -34,6 +75,9 @@ export class VerifyDomainDkimCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/VerifyDomainIdentityCommand.ts b/clients/client-ses/commands/VerifyDomainIdentityCommand.ts index 87bd078b70e4c..04539f8fbf610 100644 --- a/clients/client-ses/commands/VerifyDomainIdentityCommand.ts +++ b/clients/client-ses/commands/VerifyDomainIdentityCommand.ts @@ -20,6 +20,15 @@ import { export type VerifyDomainIdentityCommandInput = VerifyDomainIdentityRequest; export type VerifyDomainIdentityCommandOutput = VerifyDomainIdentityResponse & __MetadataBearer; +/** + *

Adds a domain to the list of identities for your Amazon SES account in the current AWS + * Region and attempts to verify it. For more information about verifying domains, see + * Verifying Email + * Addresses and Domains in the Amazon SES Developer + * Guide. + *

+ *

You can execute this operation no more than once per second.

+ */ export class VerifyDomainIdentityCommand extends $Command< VerifyDomainIdentityCommandInput, VerifyDomainIdentityCommandOutput, @@ -34,6 +43,9 @@ export class VerifyDomainIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/VerifyEmailAddressCommand.ts b/clients/client-ses/commands/VerifyEmailAddressCommand.ts index 70c058ec57bef..4fe85f1981419 100644 --- a/clients/client-ses/commands/VerifyEmailAddressCommand.ts +++ b/clients/client-ses/commands/VerifyEmailAddressCommand.ts @@ -20,6 +20,10 @@ import { export type VerifyEmailAddressCommandInput = VerifyEmailAddressRequest; export type VerifyEmailAddressCommandOutput = __MetadataBearer; +/** + *

Deprecated. Use the VerifyEmailIdentity operation to verify a new email + * address.

+ */ export class VerifyEmailAddressCommand extends $Command< VerifyEmailAddressCommandInput, VerifyEmailAddressCommandOutput, @@ -34,6 +38,9 @@ export class VerifyEmailAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/commands/VerifyEmailIdentityCommand.ts b/clients/client-ses/commands/VerifyEmailIdentityCommand.ts index 597194d3a7386..020dd8f35e5e6 100644 --- a/clients/client-ses/commands/VerifyEmailIdentityCommand.ts +++ b/clients/client-ses/commands/VerifyEmailIdentityCommand.ts @@ -20,6 +20,12 @@ import { export type VerifyEmailIdentityCommandInput = VerifyEmailIdentityRequest; export type VerifyEmailIdentityCommandOutput = VerifyEmailIdentityResponse & __MetadataBearer; +/** + *

Adds an email address to the list of identities for your Amazon SES account in the current + * AWS region and attempts to verify it. As a result of executing this operation, a + * verification email is sent to the specified address.

+ *

You can execute this operation no more than once per second.

+ */ export class VerifyEmailIdentityCommand extends $Command< VerifyEmailIdentityCommandInput, VerifyEmailIdentityCommandOutput, @@ -34,6 +40,9 @@ export class VerifyEmailIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESClientResolvedConfig, diff --git a/clients/client-ses/package.json b/clients/client-ses/package.json index 319a51f66b6ca..d2e243b705785 100644 --- a/clients/client-ses/package.json +++ b/clients/client-ses/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ses Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ses/pagination/ListCustomVerificationEmailTemplatesPaginator.ts b/clients/client-ses/pagination/ListCustomVerificationEmailTemplatesPaginator.ts index 70c83fed6d558..31d55918ec493 100644 --- a/clients/client-ses/pagination/ListCustomVerificationEmailTemplatesPaginator.ts +++ b/clients/client-ses/pagination/ListCustomVerificationEmailTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { SESPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESClient, input: ListCustomVerificationEmailTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCustomVerificationEmailTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SES, input: ListCustomVerificationEmailTemplatesCommandInput, diff --git a/clients/client-ses/pagination/ListIdentitiesPaginator.ts b/clients/client-ses/pagination/ListIdentitiesPaginator.ts index 67bf6b8bcde96..9b40236169ff0 100644 --- a/clients/client-ses/pagination/ListIdentitiesPaginator.ts +++ b/clients/client-ses/pagination/ListIdentitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { SESPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESClient, input: ListIdentitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListIdentitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SES, input: ListIdentitiesCommandInput, diff --git a/clients/client-ses/runtimeConfig.browser.ts b/clients/client-ses/runtimeConfig.browser.ts index 7ee75cb2a708a..e9744d812dfdc 100644 --- a/clients/client-ses/runtimeConfig.browser.ts +++ b/clients/client-ses/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SESClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ses/runtimeConfig.native.ts b/clients/client-ses/runtimeConfig.native.ts index adf192d0e9e5a..51f65df33326e 100644 --- a/clients/client-ses/runtimeConfig.native.ts +++ b/clients/client-ses/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SESClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ses/runtimeConfig.shared.ts b/clients/client-ses/runtimeConfig.shared.ts index bebe38db280d4..45cbbef7b9ff2 100644 --- a/clients/client-ses/runtimeConfig.shared.ts +++ b/clients/client-ses/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2010-12-01", disableHostPrefix: false, diff --git a/clients/client-ses/runtimeConfig.ts b/clients/client-ses/runtimeConfig.ts index d685581f7dc78..f014c7db40574 100644 --- a/clients/client-ses/runtimeConfig.ts +++ b/clients/client-ses/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SESClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ses/tsconfig.json b/clients/client-ses/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ses/tsconfig.json +++ b/clients/client-ses/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sesv2/commands/CreateConfigurationSetCommand.ts b/clients/client-sesv2/commands/CreateConfigurationSetCommand.ts index 1fbe1d19a4546..9a96cb046f40a 100644 --- a/clients/client-sesv2/commands/CreateConfigurationSetCommand.ts +++ b/clients/client-sesv2/commands/CreateConfigurationSetCommand.ts @@ -20,6 +20,13 @@ import { export type CreateConfigurationSetCommandInput = CreateConfigurationSetRequest; export type CreateConfigurationSetCommandOutput = CreateConfigurationSetResponse & __MetadataBearer; +/** + *

Create a configuration set. Configuration sets are groups of + * rules that you can apply to the emails that you send. You apply a configuration set to + * an email by specifying the name of the configuration set when you call the Amazon SES API v2. When + * you apply a configuration set to an email, all of the rules in that configuration set + * are applied to the email.

+ */ export class CreateConfigurationSetCommand extends $Command< CreateConfigurationSetCommandInput, CreateConfigurationSetCommandOutput, @@ -34,6 +41,9 @@ export class CreateConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateConfigurationSetEventDestinationCommand.ts b/clients/client-sesv2/commands/CreateConfigurationSetEventDestinationCommand.ts index d889c91e8e788..d8189dd9e9cdc 100644 --- a/clients/client-sesv2/commands/CreateConfigurationSetEventDestinationCommand.ts +++ b/clients/client-sesv2/commands/CreateConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,15 @@ export type CreateConfigurationSetEventDestinationCommandInput = CreateConfigura export type CreateConfigurationSetEventDestinationCommandOutput = CreateConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Create an event destination. Events include message sends, + * deliveries, opens, clicks, bounces, and complaints. Event + * destinations are places that you can send information about these events + * to. For example, you can send event data to Amazon SNS to receive notifications when you + * receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term + * storage.

+ *

A single configuration set can include more than one event destination.

+ */ export class CreateConfigurationSetEventDestinationCommand extends $Command< CreateConfigurationSetEventDestinationCommandInput, CreateConfigurationSetEventDestinationCommandOutput, @@ -38,6 +47,9 @@ export class CreateConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateContactCommand.ts b/clients/client-sesv2/commands/CreateContactCommand.ts index 1f45bc447d4aa..26875c6e6c474 100644 --- a/clients/client-sesv2/commands/CreateContactCommand.ts +++ b/clients/client-sesv2/commands/CreateContactCommand.ts @@ -20,6 +20,10 @@ import { export type CreateContactCommandInput = CreateContactRequest; export type CreateContactCommandOutput = CreateContactResponse & __MetadataBearer; +/** + *

Creates a contact, which is an end-user who is receiving the email, and adds them to a + * contact list.

+ */ export class CreateContactCommand extends $Command< CreateContactCommandInput, CreateContactCommandOutput, @@ -34,6 +38,9 @@ export class CreateContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateContactListCommand.ts b/clients/client-sesv2/commands/CreateContactListCommand.ts index 046f4d811c16f..dbe33ef31c24e 100644 --- a/clients/client-sesv2/commands/CreateContactListCommand.ts +++ b/clients/client-sesv2/commands/CreateContactListCommand.ts @@ -20,6 +20,9 @@ import { export type CreateContactListCommandInput = CreateContactListRequest; export type CreateContactListCommandOutput = CreateContactListResponse & __MetadataBearer; +/** + *

Creates a contact list.

+ */ export class CreateContactListCommand extends $Command< CreateContactListCommandInput, CreateContactListCommandOutput, @@ -34,6 +37,9 @@ export class CreateContactListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateCustomVerificationEmailTemplateCommand.ts b/clients/client-sesv2/commands/CreateCustomVerificationEmailTemplateCommand.ts index 5083ae0d4ebc1..1ffb755011cb8 100644 --- a/clients/client-sesv2/commands/CreateCustomVerificationEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/CreateCustomVerificationEmailTemplateCommand.ts @@ -24,6 +24,12 @@ export type CreateCustomVerificationEmailTemplateCommandInput = CreateCustomVeri export type CreateCustomVerificationEmailTemplateCommandOutput = CreateCustomVerificationEmailTemplateResponse & __MetadataBearer; +/** + *

Creates a new custom verification email template.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateCustomVerificationEmailTemplateCommand extends $Command< CreateCustomVerificationEmailTemplateCommandInput, CreateCustomVerificationEmailTemplateCommandOutput, @@ -38,6 +44,9 @@ export class CreateCustomVerificationEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateDedicatedIpPoolCommand.ts b/clients/client-sesv2/commands/CreateDedicatedIpPoolCommand.ts index e00bd3d5eea8b..90bc68e1f509f 100644 --- a/clients/client-sesv2/commands/CreateDedicatedIpPoolCommand.ts +++ b/clients/client-sesv2/commands/CreateDedicatedIpPoolCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDedicatedIpPoolCommandInput = CreateDedicatedIpPoolRequest; export type CreateDedicatedIpPoolCommandOutput = CreateDedicatedIpPoolResponse & __MetadataBearer; +/** + *

Create a new pool of dedicated IP addresses. A pool can include one or more dedicated + * IP addresses that are associated with your AWS account. You can associate a pool with + * a configuration set. When you send an email that uses that configuration set, the + * message is sent from one of the addresses in the associated pool.

+ */ export class CreateDedicatedIpPoolCommand extends $Command< CreateDedicatedIpPoolCommandInput, CreateDedicatedIpPoolCommandOutput, @@ -34,6 +40,9 @@ export class CreateDedicatedIpPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateDeliverabilityTestReportCommand.ts b/clients/client-sesv2/commands/CreateDeliverabilityTestReportCommand.ts index 7cd91467bc103..c4cd333269eb0 100644 --- a/clients/client-sesv2/commands/CreateDeliverabilityTestReportCommand.ts +++ b/clients/client-sesv2/commands/CreateDeliverabilityTestReportCommand.ts @@ -20,6 +20,15 @@ import { export type CreateDeliverabilityTestReportCommandInput = CreateDeliverabilityTestReportRequest; export type CreateDeliverabilityTestReportCommandOutput = CreateDeliverabilityTestReportResponse & __MetadataBearer; +/** + *

Create a new predictive inbox placement test. Predictive inbox placement tests can help you predict how your messages will be handled + * by various email providers around the world. When you perform a predictive inbox placement test, you provide a + * sample message that contains the content that you plan to send to your customers. Amazon SES + * then sends that message to special email addresses spread across several major email + * providers. After about 24 hours, the test is complete, and you can use the + * GetDeliverabilityTestReport operation to view the results of the + * test.

+ */ export class CreateDeliverabilityTestReportCommand extends $Command< CreateDeliverabilityTestReportCommandInput, CreateDeliverabilityTestReportCommandOutput, @@ -34,6 +43,9 @@ export class CreateDeliverabilityTestReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateEmailIdentityCommand.ts b/clients/client-sesv2/commands/CreateEmailIdentityCommand.ts index e43fc14748f79..1460cd1d5bdd3 100644 --- a/clients/client-sesv2/commands/CreateEmailIdentityCommand.ts +++ b/clients/client-sesv2/commands/CreateEmailIdentityCommand.ts @@ -20,6 +20,28 @@ import { export type CreateEmailIdentityCommandInput = CreateEmailIdentityRequest; export type CreateEmailIdentityCommandOutput = CreateEmailIdentityResponse & __MetadataBearer; +/** + *

Starts the process of verifying an email identity. An identity is + * an email address or domain that you use when you send email. Before you can use an + * identity to send email, you first have to verify it. By verifying an identity, you + * demonstrate that you're the owner of the identity, and that you've given Amazon SES API v2 + * permission to send email from the identity.

+ *

When you verify an email address, Amazon SES sends an email to the address. Your email + * address is verified as soon as you follow the link in the verification email. + * + *

+ *

When you verify a domain without specifying the DkimSigningAttributes + * object, this operation provides a set of DKIM tokens. You can convert these tokens into + * CNAME records, which you then add to the DNS configuration for your domain. Your domain + * is verified when Amazon SES detects these records in the DNS configuration for your domain. + * This verification method is known as Easy DKIM.

+ *

Alternatively, you can perform the verification process by providing your own + * public-private key pair. This verification method is known as Bring Your Own DKIM + * (BYODKIM). To use BYODKIM, your call to the CreateEmailIdentity operation + * has to include the DkimSigningAttributes object. When you specify this + * object, you provide a selector (a component of the DNS record name that identifies the + * public key that you want to use for DKIM authentication) and a private key.

+ */ export class CreateEmailIdentityCommand extends $Command< CreateEmailIdentityCommandInput, CreateEmailIdentityCommandOutput, @@ -34,6 +56,9 @@ export class CreateEmailIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateEmailIdentityPolicyCommand.ts b/clients/client-sesv2/commands/CreateEmailIdentityPolicyCommand.ts index f70cc00372a8b..5839872bb1437 100644 --- a/clients/client-sesv2/commands/CreateEmailIdentityPolicyCommand.ts +++ b/clients/client-sesv2/commands/CreateEmailIdentityPolicyCommand.ts @@ -20,6 +20,20 @@ import { export type CreateEmailIdentityPolicyCommandInput = CreateEmailIdentityPolicyRequest; export type CreateEmailIdentityPolicyCommandOutput = CreateEmailIdentityPolicyResponse & __MetadataBearer; +/** + *

Creates the specified sending authorization policy for the given identity (an email + * address or a domain).

+ * + *

This API is for the identity owner only. If you have not verified the identity, + * this API will return an error.

+ *
+ *

Sending authorization is a feature that enables an identity owner to authorize other + * senders to use its identities. For information about using sending authorization, see + * the Amazon SES Developer + * Guide.

+ * + *

You can execute this operation no more than once per second.

+ */ export class CreateEmailIdentityPolicyCommand extends $Command< CreateEmailIdentityPolicyCommandInput, CreateEmailIdentityPolicyCommandOutput, @@ -34,6 +48,9 @@ export class CreateEmailIdentityPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateEmailTemplateCommand.ts b/clients/client-sesv2/commands/CreateEmailTemplateCommand.ts index 2590fb85fc78e..73ec83ea4ddaf 100644 --- a/clients/client-sesv2/commands/CreateEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/CreateEmailTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type CreateEmailTemplateCommandInput = CreateEmailTemplateRequest; export type CreateEmailTemplateCommandOutput = CreateEmailTemplateResponse & __MetadataBearer; +/** + *

Creates an email template. Email templates enable you to send personalized email to + * one or more destinations in a single API operation. For more information, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class CreateEmailTemplateCommand extends $Command< CreateEmailTemplateCommandInput, CreateEmailTemplateCommandOutput, @@ -34,6 +40,9 @@ export class CreateEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/CreateImportJobCommand.ts b/clients/client-sesv2/commands/CreateImportJobCommand.ts index 6dd7e34d1d66d..88f6a80838040 100644 --- a/clients/client-sesv2/commands/CreateImportJobCommand.ts +++ b/clients/client-sesv2/commands/CreateImportJobCommand.ts @@ -20,6 +20,9 @@ import { export type CreateImportJobCommandInput = CreateImportJobRequest; export type CreateImportJobCommandOutput = CreateImportJobResponse & __MetadataBearer; +/** + *

Creates an import job for a data destination.

+ */ export class CreateImportJobCommand extends $Command< CreateImportJobCommandInput, CreateImportJobCommandOutput, @@ -34,6 +37,9 @@ export class CreateImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteConfigurationSetCommand.ts b/clients/client-sesv2/commands/DeleteConfigurationSetCommand.ts index c36c9c2b56721..5469c98edbc87 100644 --- a/clients/client-sesv2/commands/DeleteConfigurationSetCommand.ts +++ b/clients/client-sesv2/commands/DeleteConfigurationSetCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteConfigurationSetCommandInput = DeleteConfigurationSetRequest; export type DeleteConfigurationSetCommandOutput = DeleteConfigurationSetResponse & __MetadataBearer; +/** + *

Delete an existing configuration set.

+ *

+ * Configuration sets are groups of rules that you can apply to the + * emails you send. You apply a configuration set to an email by including a reference to + * the configuration set in the headers of the email. When you apply a configuration set to + * an email, all of the rules in that configuration set are applied to the email.

+ */ export class DeleteConfigurationSetCommand extends $Command< DeleteConfigurationSetCommandInput, DeleteConfigurationSetCommandOutput, @@ -34,6 +42,9 @@ export class DeleteConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteConfigurationSetEventDestinationCommand.ts b/clients/client-sesv2/commands/DeleteConfigurationSetEventDestinationCommand.ts index 1a43e61e09889..cf7d9665d50bd 100644 --- a/clients/client-sesv2/commands/DeleteConfigurationSetEventDestinationCommand.ts +++ b/clients/client-sesv2/commands/DeleteConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,15 @@ export type DeleteConfigurationSetEventDestinationCommandInput = DeleteConfigura export type DeleteConfigurationSetEventDestinationCommandOutput = DeleteConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Delete an event destination.

+ *

+ * Events include message sends, deliveries, opens, clicks, bounces, + * and complaints. Event destinations are places that you can send + * information about these events to. For example, you can send event data to Amazon SNS to + * receive notifications when you receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to + * stream data to Amazon S3 for long-term storage.

+ */ export class DeleteConfigurationSetEventDestinationCommand extends $Command< DeleteConfigurationSetEventDestinationCommandInput, DeleteConfigurationSetEventDestinationCommandOutput, @@ -38,6 +47,9 @@ export class DeleteConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteContactCommand.ts b/clients/client-sesv2/commands/DeleteContactCommand.ts index c09c0b78ae187..5504cacb81b07 100644 --- a/clients/client-sesv2/commands/DeleteContactCommand.ts +++ b/clients/client-sesv2/commands/DeleteContactCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteContactCommandInput = DeleteContactRequest; export type DeleteContactCommandOutput = DeleteContactResponse & __MetadataBearer; +/** + *

Removes a contact from a contact list.

+ */ export class DeleteContactCommand extends $Command< DeleteContactCommandInput, DeleteContactCommandOutput, @@ -34,6 +37,9 @@ export class DeleteContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteContactListCommand.ts b/clients/client-sesv2/commands/DeleteContactListCommand.ts index 4b61c354e97da..e5d730a4c2b11 100644 --- a/clients/client-sesv2/commands/DeleteContactListCommand.ts +++ b/clients/client-sesv2/commands/DeleteContactListCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteContactListCommandInput = DeleteContactListRequest; export type DeleteContactListCommandOutput = DeleteContactListResponse & __MetadataBearer; +/** + *

Deletes a contact list and all of the contacts on that list.

+ */ export class DeleteContactListCommand extends $Command< DeleteContactListCommandInput, DeleteContactListCommandOutput, @@ -34,6 +37,9 @@ export class DeleteContactListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteCustomVerificationEmailTemplateCommand.ts b/clients/client-sesv2/commands/DeleteCustomVerificationEmailTemplateCommand.ts index cf1e27f3325fe..11f3facb8a424 100644 --- a/clients/client-sesv2/commands/DeleteCustomVerificationEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/DeleteCustomVerificationEmailTemplateCommand.ts @@ -24,6 +24,12 @@ export type DeleteCustomVerificationEmailTemplateCommandInput = DeleteCustomVeri export type DeleteCustomVerificationEmailTemplateCommandOutput = DeleteCustomVerificationEmailTemplateResponse & __MetadataBearer; +/** + *

Deletes an existing custom verification email template.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class DeleteCustomVerificationEmailTemplateCommand extends $Command< DeleteCustomVerificationEmailTemplateCommandInput, DeleteCustomVerificationEmailTemplateCommandOutput, @@ -38,6 +44,9 @@ export class DeleteCustomVerificationEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteDedicatedIpPoolCommand.ts b/clients/client-sesv2/commands/DeleteDedicatedIpPoolCommand.ts index a4fde9a64c579..909d2d90c405d 100644 --- a/clients/client-sesv2/commands/DeleteDedicatedIpPoolCommand.ts +++ b/clients/client-sesv2/commands/DeleteDedicatedIpPoolCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDedicatedIpPoolCommandInput = DeleteDedicatedIpPoolRequest; export type DeleteDedicatedIpPoolCommandOutput = DeleteDedicatedIpPoolResponse & __MetadataBearer; +/** + *

Delete a dedicated IP pool.

+ */ export class DeleteDedicatedIpPoolCommand extends $Command< DeleteDedicatedIpPoolCommandInput, DeleteDedicatedIpPoolCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDedicatedIpPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteEmailIdentityCommand.ts b/clients/client-sesv2/commands/DeleteEmailIdentityCommand.ts index 802e33cda4ae7..98962a79935f0 100644 --- a/clients/client-sesv2/commands/DeleteEmailIdentityCommand.ts +++ b/clients/client-sesv2/commands/DeleteEmailIdentityCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteEmailIdentityCommandInput = DeleteEmailIdentityRequest; export type DeleteEmailIdentityCommandOutput = DeleteEmailIdentityResponse & __MetadataBearer; +/** + *

Deletes an email identity. An identity can be either an email address or a domain + * name.

+ */ export class DeleteEmailIdentityCommand extends $Command< DeleteEmailIdentityCommandInput, DeleteEmailIdentityCommandOutput, @@ -34,6 +38,9 @@ export class DeleteEmailIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteEmailIdentityPolicyCommand.ts b/clients/client-sesv2/commands/DeleteEmailIdentityPolicyCommand.ts index e74a2798255f6..2f5b8d1f07614 100644 --- a/clients/client-sesv2/commands/DeleteEmailIdentityPolicyCommand.ts +++ b/clients/client-sesv2/commands/DeleteEmailIdentityPolicyCommand.ts @@ -20,6 +20,21 @@ import { export type DeleteEmailIdentityPolicyCommandInput = DeleteEmailIdentityPolicyRequest; export type DeleteEmailIdentityPolicyCommandOutput = DeleteEmailIdentityPolicyResponse & __MetadataBearer; +/** + *

Deletes the specified sending authorization policy for the given identity (an email + * address or a domain). This API returns successfully even if a policy with the specified + * name does not exist.

+ * + *

This API is for the identity owner only. If you have not verified the identity, + * this API will return an error.

+ *
+ *

Sending authorization is a feature that enables an identity owner to authorize other + * senders to use its identities. For information about using sending authorization, see + * the Amazon SES Developer + * Guide.

+ * + *

You can execute this operation no more than once per second.

+ */ export class DeleteEmailIdentityPolicyCommand extends $Command< DeleteEmailIdentityPolicyCommandInput, DeleteEmailIdentityPolicyCommandOutput, @@ -34,6 +49,9 @@ export class DeleteEmailIdentityPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteEmailTemplateCommand.ts b/clients/client-sesv2/commands/DeleteEmailTemplateCommand.ts index cf8fa7d2c4568..5483b4a467f78 100644 --- a/clients/client-sesv2/commands/DeleteEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/DeleteEmailTemplateCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteEmailTemplateCommandInput = DeleteEmailTemplateRequest; export type DeleteEmailTemplateCommandOutput = DeleteEmailTemplateResponse & __MetadataBearer; +/** + *

Deletes an email template.

+ * + *

You can execute this operation no more than once per second.

+ */ export class DeleteEmailTemplateCommand extends $Command< DeleteEmailTemplateCommandInput, DeleteEmailTemplateCommandOutput, @@ -34,6 +39,9 @@ export class DeleteEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/DeleteSuppressedDestinationCommand.ts b/clients/client-sesv2/commands/DeleteSuppressedDestinationCommand.ts index 86fe825f48330..fada2eafb4c65 100644 --- a/clients/client-sesv2/commands/DeleteSuppressedDestinationCommand.ts +++ b/clients/client-sesv2/commands/DeleteSuppressedDestinationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSuppressedDestinationCommandInput = DeleteSuppressedDestinationRequest; export type DeleteSuppressedDestinationCommandOutput = DeleteSuppressedDestinationResponse & __MetadataBearer; +/** + *

Removes an email address from the suppression list for your account.

+ */ export class DeleteSuppressedDestinationCommand extends $Command< DeleteSuppressedDestinationCommandInput, DeleteSuppressedDestinationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSuppressedDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetAccountCommand.ts b/clients/client-sesv2/commands/GetAccountCommand.ts index 73071874aa301..7188e67466900 100644 --- a/clients/client-sesv2/commands/GetAccountCommand.ts +++ b/clients/client-sesv2/commands/GetAccountCommand.ts @@ -20,6 +20,10 @@ import { export type GetAccountCommandInput = GetAccountRequest; export type GetAccountCommandOutput = GetAccountResponse & __MetadataBearer; +/** + *

Obtain information about the email-sending status and capabilities of your Amazon SES + * account in the current AWS Region.

+ */ export class GetAccountCommand extends $Command< GetAccountCommandInput, GetAccountCommandOutput, @@ -34,6 +38,9 @@ export class GetAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetBlacklistReportsCommand.ts b/clients/client-sesv2/commands/GetBlacklistReportsCommand.ts index e2df73b1dc3cc..22a73267de951 100644 --- a/clients/client-sesv2/commands/GetBlacklistReportsCommand.ts +++ b/clients/client-sesv2/commands/GetBlacklistReportsCommand.ts @@ -20,6 +20,9 @@ import { export type GetBlacklistReportsCommandInput = GetBlacklistReportsRequest; export type GetBlacklistReportsCommandOutput = GetBlacklistReportsResponse & __MetadataBearer; +/** + *

Retrieve a list of the blacklists that your dedicated IP addresses appear on.

+ */ export class GetBlacklistReportsCommand extends $Command< GetBlacklistReportsCommandInput, GetBlacklistReportsCommandOutput, @@ -34,6 +37,9 @@ export class GetBlacklistReportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetConfigurationSetCommand.ts b/clients/client-sesv2/commands/GetConfigurationSetCommand.ts index d1af4943ccbfa..bc9152ca2c41c 100644 --- a/clients/client-sesv2/commands/GetConfigurationSetCommand.ts +++ b/clients/client-sesv2/commands/GetConfigurationSetCommand.ts @@ -20,6 +20,16 @@ import { export type GetConfigurationSetCommandInput = GetConfigurationSetRequest; export type GetConfigurationSetCommandOutput = GetConfigurationSetResponse & __MetadataBearer; +/** + *

Get information about an existing configuration set, including the dedicated IP pool + * that it's associated with, whether or not it's enabled for sending email, and + * more.

+ *

+ * Configuration sets are groups of rules that you can apply to the + * emails you send. You apply a configuration set to an email by including a reference to + * the configuration set in the headers of the email. When you apply a configuration set to + * an email, all of the rules in that configuration set are applied to the email.

+ */ export class GetConfigurationSetCommand extends $Command< GetConfigurationSetCommandInput, GetConfigurationSetCommandOutput, @@ -34,6 +44,9 @@ export class GetConfigurationSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetConfigurationSetEventDestinationsCommand.ts b/clients/client-sesv2/commands/GetConfigurationSetEventDestinationsCommand.ts index 6ba549a179915..a2710b2b1aa92 100644 --- a/clients/client-sesv2/commands/GetConfigurationSetEventDestinationsCommand.ts +++ b/clients/client-sesv2/commands/GetConfigurationSetEventDestinationsCommand.ts @@ -24,6 +24,16 @@ export type GetConfigurationSetEventDestinationsCommandInput = GetConfigurationS export type GetConfigurationSetEventDestinationsCommandOutput = GetConfigurationSetEventDestinationsResponse & __MetadataBearer; +/** + *

Retrieve a list of event destinations that are associated with a configuration + * set.

+ *

+ * Events include message sends, deliveries, opens, clicks, bounces, + * and complaints. Event destinations are places that you can send + * information about these events to. For example, you can send event data to Amazon SNS to + * receive notifications when you receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to + * stream data to Amazon S3 for long-term storage.

+ */ export class GetConfigurationSetEventDestinationsCommand extends $Command< GetConfigurationSetEventDestinationsCommandInput, GetConfigurationSetEventDestinationsCommandOutput, @@ -38,6 +48,9 @@ export class GetConfigurationSetEventDestinationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetContactCommand.ts b/clients/client-sesv2/commands/GetContactCommand.ts index e8d5c73fac3e1..2e50b7da6e96d 100644 --- a/clients/client-sesv2/commands/GetContactCommand.ts +++ b/clients/client-sesv2/commands/GetContactCommand.ts @@ -20,6 +20,9 @@ import { export type GetContactCommandInput = GetContactRequest; export type GetContactCommandOutput = GetContactResponse & __MetadataBearer; +/** + *

Returns a contact from a contact list.

+ */ export class GetContactCommand extends $Command< GetContactCommandInput, GetContactCommandOutput, @@ -34,6 +37,9 @@ export class GetContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetContactListCommand.ts b/clients/client-sesv2/commands/GetContactListCommand.ts index acef0d3367225..e0db027aaa5b0 100644 --- a/clients/client-sesv2/commands/GetContactListCommand.ts +++ b/clients/client-sesv2/commands/GetContactListCommand.ts @@ -20,6 +20,10 @@ import { export type GetContactListCommandInput = GetContactListRequest; export type GetContactListCommandOutput = GetContactListResponse & __MetadataBearer; +/** + *

Returns contact list metadata. It does not return any information about the contacts + * present in the list.

+ */ export class GetContactListCommand extends $Command< GetContactListCommandInput, GetContactListCommandOutput, @@ -34,6 +38,9 @@ export class GetContactListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetCustomVerificationEmailTemplateCommand.ts b/clients/client-sesv2/commands/GetCustomVerificationEmailTemplateCommand.ts index 82dbc935ca6cd..df10f493b643e 100644 --- a/clients/client-sesv2/commands/GetCustomVerificationEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/GetCustomVerificationEmailTemplateCommand.ts @@ -24,6 +24,13 @@ export type GetCustomVerificationEmailTemplateCommandInput = GetCustomVerificati export type GetCustomVerificationEmailTemplateCommandOutput = GetCustomVerificationEmailTemplateResponse & __MetadataBearer; +/** + *

Returns the custom email verification template for the template name you + * specify.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class GetCustomVerificationEmailTemplateCommand extends $Command< GetCustomVerificationEmailTemplateCommandInput, GetCustomVerificationEmailTemplateCommandOutput, @@ -38,6 +45,9 @@ export class GetCustomVerificationEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetDedicatedIpCommand.ts b/clients/client-sesv2/commands/GetDedicatedIpCommand.ts index 7a1435c84daa9..d2b3d780f0de5 100644 --- a/clients/client-sesv2/commands/GetDedicatedIpCommand.ts +++ b/clients/client-sesv2/commands/GetDedicatedIpCommand.ts @@ -20,6 +20,11 @@ import { export type GetDedicatedIpCommandInput = GetDedicatedIpRequest; export type GetDedicatedIpCommandOutput = GetDedicatedIpResponse & __MetadataBearer; +/** + *

Get information about a dedicated IP address, including the name of the dedicated IP + * pool that it's associated with, as well information about the automatic warm-up process + * for the address.

+ */ export class GetDedicatedIpCommand extends $Command< GetDedicatedIpCommandInput, GetDedicatedIpCommandOutput, @@ -34,6 +39,9 @@ export class GetDedicatedIpCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetDedicatedIpsCommand.ts b/clients/client-sesv2/commands/GetDedicatedIpsCommand.ts index 46cc78de549c1..11d931290764d 100644 --- a/clients/client-sesv2/commands/GetDedicatedIpsCommand.ts +++ b/clients/client-sesv2/commands/GetDedicatedIpsCommand.ts @@ -20,6 +20,10 @@ import { export type GetDedicatedIpsCommandInput = GetDedicatedIpsRequest; export type GetDedicatedIpsCommandOutput = GetDedicatedIpsResponse & __MetadataBearer; +/** + *

List the dedicated IP addresses that are associated with your AWS + * account.

+ */ export class GetDedicatedIpsCommand extends $Command< GetDedicatedIpsCommandInput, GetDedicatedIpsCommandOutput, @@ -34,6 +38,9 @@ export class GetDedicatedIpsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetDeliverabilityDashboardOptionsCommand.ts b/clients/client-sesv2/commands/GetDeliverabilityDashboardOptionsCommand.ts index fb7c87632a237..58e47d4093a42 100644 --- a/clients/client-sesv2/commands/GetDeliverabilityDashboardOptionsCommand.ts +++ b/clients/client-sesv2/commands/GetDeliverabilityDashboardOptionsCommand.ts @@ -24,6 +24,16 @@ export type GetDeliverabilityDashboardOptionsCommandInput = GetDeliverabilityDas export type GetDeliverabilityDashboardOptionsCommandOutput = GetDeliverabilityDashboardOptionsResponse & __MetadataBearer; +/** + *

Retrieve information about the status of the Deliverability dashboard for your account. When + * the Deliverability dashboard is enabled, you gain access to reputation, deliverability, and other + * metrics for the domains that you use to send email. You also gain the ability to perform + * predictive inbox placement tests.

+ * + *

When you use the Deliverability dashboard, you pay a monthly subscription charge, in addition + * to any other fees that you accrue by using Amazon SES and other AWS services. For more + * information about the features and cost of a Deliverability dashboard subscription, see Amazon SES Pricing.

+ */ export class GetDeliverabilityDashboardOptionsCommand extends $Command< GetDeliverabilityDashboardOptionsCommandInput, GetDeliverabilityDashboardOptionsCommandOutput, @@ -38,6 +48,9 @@ export class GetDeliverabilityDashboardOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetDeliverabilityTestReportCommand.ts b/clients/client-sesv2/commands/GetDeliverabilityTestReportCommand.ts index a8bbfcc7c90d0..a7eadcc40a75d 100644 --- a/clients/client-sesv2/commands/GetDeliverabilityTestReportCommand.ts +++ b/clients/client-sesv2/commands/GetDeliverabilityTestReportCommand.ts @@ -20,6 +20,9 @@ import { export type GetDeliverabilityTestReportCommandInput = GetDeliverabilityTestReportRequest; export type GetDeliverabilityTestReportCommandOutput = GetDeliverabilityTestReportResponse & __MetadataBearer; +/** + *

Retrieve the results of a predictive inbox placement test.

+ */ export class GetDeliverabilityTestReportCommand extends $Command< GetDeliverabilityTestReportCommandInput, GetDeliverabilityTestReportCommandOutput, @@ -34,6 +37,9 @@ export class GetDeliverabilityTestReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetDomainDeliverabilityCampaignCommand.ts b/clients/client-sesv2/commands/GetDomainDeliverabilityCampaignCommand.ts index 8a9b38b436266..97b4eb6540fd3 100644 --- a/clients/client-sesv2/commands/GetDomainDeliverabilityCampaignCommand.ts +++ b/clients/client-sesv2/commands/GetDomainDeliverabilityCampaignCommand.ts @@ -20,6 +20,11 @@ import { export type GetDomainDeliverabilityCampaignCommandInput = GetDomainDeliverabilityCampaignRequest; export type GetDomainDeliverabilityCampaignCommandOutput = GetDomainDeliverabilityCampaignResponse & __MetadataBearer; +/** + *

Retrieve all the deliverability data for a specific campaign. This data is available + * for a campaign only if the campaign sent email by using a domain that the + * Deliverability dashboard is enabled for.

+ */ export class GetDomainDeliverabilityCampaignCommand extends $Command< GetDomainDeliverabilityCampaignCommandInput, GetDomainDeliverabilityCampaignCommandOutput, @@ -34,6 +39,9 @@ export class GetDomainDeliverabilityCampaignCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetDomainStatisticsReportCommand.ts b/clients/client-sesv2/commands/GetDomainStatisticsReportCommand.ts index 1f399d5ca7b66..e075629e2bf95 100644 --- a/clients/client-sesv2/commands/GetDomainStatisticsReportCommand.ts +++ b/clients/client-sesv2/commands/GetDomainStatisticsReportCommand.ts @@ -20,6 +20,10 @@ import { export type GetDomainStatisticsReportCommandInput = GetDomainStatisticsReportRequest; export type GetDomainStatisticsReportCommandOutput = GetDomainStatisticsReportResponse & __MetadataBearer; +/** + *

Retrieve inbox placement and engagement rates for the domains that you use to send + * email.

+ */ export class GetDomainStatisticsReportCommand extends $Command< GetDomainStatisticsReportCommandInput, GetDomainStatisticsReportCommandOutput, @@ -34,6 +38,9 @@ export class GetDomainStatisticsReportCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetEmailIdentityCommand.ts b/clients/client-sesv2/commands/GetEmailIdentityCommand.ts index f51e4763a5a8a..79d987d364570 100644 --- a/clients/client-sesv2/commands/GetEmailIdentityCommand.ts +++ b/clients/client-sesv2/commands/GetEmailIdentityCommand.ts @@ -20,6 +20,11 @@ import { export type GetEmailIdentityCommandInput = GetEmailIdentityRequest; export type GetEmailIdentityCommandOutput = GetEmailIdentityResponse & __MetadataBearer; +/** + *

Provides information about a specific identity, including the identity's verification + * status, sending authorization policies, its DKIM authentication status, and its custom + * Mail-From settings.

+ */ export class GetEmailIdentityCommand extends $Command< GetEmailIdentityCommandInput, GetEmailIdentityCommandOutput, @@ -34,6 +39,9 @@ export class GetEmailIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetEmailIdentityPoliciesCommand.ts b/clients/client-sesv2/commands/GetEmailIdentityPoliciesCommand.ts index c86815a937131..cf3ede0e2b26f 100644 --- a/clients/client-sesv2/commands/GetEmailIdentityPoliciesCommand.ts +++ b/clients/client-sesv2/commands/GetEmailIdentityPoliciesCommand.ts @@ -20,6 +20,20 @@ import { export type GetEmailIdentityPoliciesCommandInput = GetEmailIdentityPoliciesRequest; export type GetEmailIdentityPoliciesCommandOutput = GetEmailIdentityPoliciesResponse & __MetadataBearer; +/** + *

Returns the requested sending authorization policies for the given identity (an email + * address or a domain). The policies are returned as a map of policy names to policy + * contents. You can retrieve a maximum of 20 policies at a time.

+ * + *

This API is for the identity owner only. If you have not verified the identity, + * this API will return an error.

+ *
+ *

Sending authorization is a feature that enables an identity owner to authorize other + * senders to use its identities. For information about using sending authorization, see + * the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class GetEmailIdentityPoliciesCommand extends $Command< GetEmailIdentityPoliciesCommandInput, GetEmailIdentityPoliciesCommandOutput, @@ -34,6 +48,9 @@ export class GetEmailIdentityPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetEmailTemplateCommand.ts b/clients/client-sesv2/commands/GetEmailTemplateCommand.ts index ad269e02d6ef3..2aacb5b77342a 100644 --- a/clients/client-sesv2/commands/GetEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/GetEmailTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type GetEmailTemplateCommandInput = GetEmailTemplateRequest; export type GetEmailTemplateCommandOutput = GetEmailTemplateResponse & __MetadataBearer; +/** + *

Displays the template object (which includes the subject line, HTML part and text + * part) for the template you specify.

+ * + *

You can execute this operation no more than once per second.

+ */ export class GetEmailTemplateCommand extends $Command< GetEmailTemplateCommandInput, GetEmailTemplateCommandOutput, @@ -34,6 +40,9 @@ export class GetEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetImportJobCommand.ts b/clients/client-sesv2/commands/GetImportJobCommand.ts index 8f6d3fdb2720e..6461d09cad1b1 100644 --- a/clients/client-sesv2/commands/GetImportJobCommand.ts +++ b/clients/client-sesv2/commands/GetImportJobCommand.ts @@ -20,6 +20,9 @@ import { export type GetImportJobCommandInput = GetImportJobRequest; export type GetImportJobCommandOutput = GetImportJobResponse & __MetadataBearer; +/** + *

Provides information about an import job.

+ */ export class GetImportJobCommand extends $Command< GetImportJobCommandInput, GetImportJobCommandOutput, @@ -34,6 +37,9 @@ export class GetImportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/GetSuppressedDestinationCommand.ts b/clients/client-sesv2/commands/GetSuppressedDestinationCommand.ts index 95326061a48e0..4a3fdf09458d0 100644 --- a/clients/client-sesv2/commands/GetSuppressedDestinationCommand.ts +++ b/clients/client-sesv2/commands/GetSuppressedDestinationCommand.ts @@ -20,6 +20,10 @@ import { export type GetSuppressedDestinationCommandInput = GetSuppressedDestinationRequest; export type GetSuppressedDestinationCommandOutput = GetSuppressedDestinationResponse & __MetadataBearer; +/** + *

Retrieves information about a specific email address that's on the suppression list + * for your account.

+ */ export class GetSuppressedDestinationCommand extends $Command< GetSuppressedDestinationCommandInput, GetSuppressedDestinationCommandOutput, @@ -34,6 +38,9 @@ export class GetSuppressedDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListConfigurationSetsCommand.ts b/clients/client-sesv2/commands/ListConfigurationSetsCommand.ts index b9fc7ca0c0514..8b226d50d9df4 100644 --- a/clients/client-sesv2/commands/ListConfigurationSetsCommand.ts +++ b/clients/client-sesv2/commands/ListConfigurationSetsCommand.ts @@ -20,6 +20,15 @@ import { export type ListConfigurationSetsCommandInput = ListConfigurationSetsRequest; export type ListConfigurationSetsCommandOutput = ListConfigurationSetsResponse & __MetadataBearer; +/** + *

List all of the configuration sets associated with your account in the current + * region.

+ *

+ * Configuration sets are groups of rules that you can apply to the + * emails you send. You apply a configuration set to an email by including a reference to + * the configuration set in the headers of the email. When you apply a configuration set to + * an email, all of the rules in that configuration set are applied to the email.

+ */ export class ListConfigurationSetsCommand extends $Command< ListConfigurationSetsCommandInput, ListConfigurationSetsCommandOutput, @@ -34,6 +43,9 @@ export class ListConfigurationSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListContactListsCommand.ts b/clients/client-sesv2/commands/ListContactListsCommand.ts index c81edae46fdc5..0fdce30218989 100644 --- a/clients/client-sesv2/commands/ListContactListsCommand.ts +++ b/clients/client-sesv2/commands/ListContactListsCommand.ts @@ -20,6 +20,9 @@ import { export type ListContactListsCommandInput = ListContactListsRequest; export type ListContactListsCommandOutput = ListContactListsResponse & __MetadataBearer; +/** + *

Lists all of the contact lists available.

+ */ export class ListContactListsCommand extends $Command< ListContactListsCommandInput, ListContactListsCommandOutput, @@ -34,6 +37,9 @@ export class ListContactListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListContactsCommand.ts b/clients/client-sesv2/commands/ListContactsCommand.ts index 5b8cfb0b8e3ee..6f54db585202e 100644 --- a/clients/client-sesv2/commands/ListContactsCommand.ts +++ b/clients/client-sesv2/commands/ListContactsCommand.ts @@ -20,6 +20,9 @@ import { export type ListContactsCommandInput = ListContactsRequest; export type ListContactsCommandOutput = ListContactsResponse & __MetadataBearer; +/** + *

Lists the contacts present in a specific contact list.

+ */ export class ListContactsCommand extends $Command< ListContactsCommandInput, ListContactsCommandOutput, @@ -34,6 +37,9 @@ export class ListContactsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListCustomVerificationEmailTemplatesCommand.ts b/clients/client-sesv2/commands/ListCustomVerificationEmailTemplatesCommand.ts index 18f46b647716f..0822b9e067569 100644 --- a/clients/client-sesv2/commands/ListCustomVerificationEmailTemplatesCommand.ts +++ b/clients/client-sesv2/commands/ListCustomVerificationEmailTemplatesCommand.ts @@ -24,6 +24,13 @@ export type ListCustomVerificationEmailTemplatesCommandInput = ListCustomVerific export type ListCustomVerificationEmailTemplatesCommandOutput = ListCustomVerificationEmailTemplatesResponse & __MetadataBearer; +/** + *

Lists the existing custom verification email templates for your account in the current + * AWS Region.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class ListCustomVerificationEmailTemplatesCommand extends $Command< ListCustomVerificationEmailTemplatesCommandInput, ListCustomVerificationEmailTemplatesCommandOutput, @@ -38,6 +45,9 @@ export class ListCustomVerificationEmailTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListDedicatedIpPoolsCommand.ts b/clients/client-sesv2/commands/ListDedicatedIpPoolsCommand.ts index 24f6bd95b9d33..d0adefe0a9db5 100644 --- a/clients/client-sesv2/commands/ListDedicatedIpPoolsCommand.ts +++ b/clients/client-sesv2/commands/ListDedicatedIpPoolsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDedicatedIpPoolsCommandInput = ListDedicatedIpPoolsRequest; export type ListDedicatedIpPoolsCommandOutput = ListDedicatedIpPoolsResponse & __MetadataBearer; +/** + *

List all of the dedicated IP pools that exist in your AWS account in the current + * Region.

+ */ export class ListDedicatedIpPoolsCommand extends $Command< ListDedicatedIpPoolsCommandInput, ListDedicatedIpPoolsCommandOutput, @@ -34,6 +38,9 @@ export class ListDedicatedIpPoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListDeliverabilityTestReportsCommand.ts b/clients/client-sesv2/commands/ListDeliverabilityTestReportsCommand.ts index 2da4b1c068e5f..c8361f27a1763 100644 --- a/clients/client-sesv2/commands/ListDeliverabilityTestReportsCommand.ts +++ b/clients/client-sesv2/commands/ListDeliverabilityTestReportsCommand.ts @@ -20,6 +20,11 @@ import { export type ListDeliverabilityTestReportsCommandInput = ListDeliverabilityTestReportsRequest; export type ListDeliverabilityTestReportsCommandOutput = ListDeliverabilityTestReportsResponse & __MetadataBearer; +/** + *

Show a list of the predictive inbox placement tests that you've performed, regardless of their statuses. For + * predictive inbox placement tests that are complete, you can use the GetDeliverabilityTestReport + * operation to view the results.

+ */ export class ListDeliverabilityTestReportsCommand extends $Command< ListDeliverabilityTestReportsCommandInput, ListDeliverabilityTestReportsCommandOutput, @@ -34,6 +39,9 @@ export class ListDeliverabilityTestReportsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListDomainDeliverabilityCampaignsCommand.ts b/clients/client-sesv2/commands/ListDomainDeliverabilityCampaignsCommand.ts index cf82ee2dfaf99..63ad7144e0d63 100644 --- a/clients/client-sesv2/commands/ListDomainDeliverabilityCampaignsCommand.ts +++ b/clients/client-sesv2/commands/ListDomainDeliverabilityCampaignsCommand.ts @@ -24,6 +24,11 @@ export type ListDomainDeliverabilityCampaignsCommandInput = ListDomainDeliverabi export type ListDomainDeliverabilityCampaignsCommandOutput = ListDomainDeliverabilityCampaignsResponse & __MetadataBearer; +/** + *

Retrieve deliverability data for all the campaigns that used a specific domain to send + * email during a specified time range. This data is available for a domain only if you + * enabled the Deliverability dashboard for the domain.

+ */ export class ListDomainDeliverabilityCampaignsCommand extends $Command< ListDomainDeliverabilityCampaignsCommandInput, ListDomainDeliverabilityCampaignsCommandOutput, @@ -38,6 +43,9 @@ export class ListDomainDeliverabilityCampaignsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListEmailIdentitiesCommand.ts b/clients/client-sesv2/commands/ListEmailIdentitiesCommand.ts index df2f135f595ee..8ff0adfaa4e77 100644 --- a/clients/client-sesv2/commands/ListEmailIdentitiesCommand.ts +++ b/clients/client-sesv2/commands/ListEmailIdentitiesCommand.ts @@ -20,6 +20,12 @@ import { export type ListEmailIdentitiesCommandInput = ListEmailIdentitiesRequest; export type ListEmailIdentitiesCommandOutput = ListEmailIdentitiesResponse & __MetadataBearer; +/** + *

Returns a list of all of the email identities that are associated with your AWS + * account. An identity can be either an email address or a domain. This operation returns + * identities that are verified as well as those that aren't. This operation returns + * identities that are associated with Amazon SES and Amazon Pinpoint.

+ */ export class ListEmailIdentitiesCommand extends $Command< ListEmailIdentitiesCommandInput, ListEmailIdentitiesCommandOutput, @@ -34,6 +40,9 @@ export class ListEmailIdentitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListEmailTemplatesCommand.ts b/clients/client-sesv2/commands/ListEmailTemplatesCommand.ts index 4de5c70295070..930af7db73dc0 100644 --- a/clients/client-sesv2/commands/ListEmailTemplatesCommand.ts +++ b/clients/client-sesv2/commands/ListEmailTemplatesCommand.ts @@ -20,6 +20,12 @@ import { export type ListEmailTemplatesCommandInput = ListEmailTemplatesRequest; export type ListEmailTemplatesCommandOutput = ListEmailTemplatesResponse & __MetadataBearer; +/** + *

Lists the email templates present in your Amazon SES account in the current AWS + * Region.

+ * + *

You can execute this operation no more than once per second.

+ */ export class ListEmailTemplatesCommand extends $Command< ListEmailTemplatesCommandInput, ListEmailTemplatesCommandOutput, @@ -34,6 +40,9 @@ export class ListEmailTemplatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListImportJobsCommand.ts b/clients/client-sesv2/commands/ListImportJobsCommand.ts index 21a24096124d3..6893c417f5903 100644 --- a/clients/client-sesv2/commands/ListImportJobsCommand.ts +++ b/clients/client-sesv2/commands/ListImportJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListImportJobsCommandInput = ListImportJobsRequest; export type ListImportJobsCommandOutput = ListImportJobsResponse & __MetadataBearer; +/** + *

Lists all of the import jobs.

+ */ export class ListImportJobsCommand extends $Command< ListImportJobsCommandInput, ListImportJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListImportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListSuppressedDestinationsCommand.ts b/clients/client-sesv2/commands/ListSuppressedDestinationsCommand.ts index d716ef8c03d2d..51259df71314d 100644 --- a/clients/client-sesv2/commands/ListSuppressedDestinationsCommand.ts +++ b/clients/client-sesv2/commands/ListSuppressedDestinationsCommand.ts @@ -20,6 +20,10 @@ import { export type ListSuppressedDestinationsCommandInput = ListSuppressedDestinationsRequest; export type ListSuppressedDestinationsCommandOutput = ListSuppressedDestinationsResponse & __MetadataBearer; +/** + *

Retrieves a list of email addresses that are on the suppression list for your + * account.

+ */ export class ListSuppressedDestinationsCommand extends $Command< ListSuppressedDestinationsCommandInput, ListSuppressedDestinationsCommandOutput, @@ -34,6 +38,9 @@ export class ListSuppressedDestinationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/ListTagsForResourceCommand.ts b/clients/client-sesv2/commands/ListTagsForResourceCommand.ts index fce07ca281174..292c7e99b9951 100644 --- a/clients/client-sesv2/commands/ListTagsForResourceCommand.ts +++ b/clients/client-sesv2/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,14 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieve a list of the tags (keys and values) that are associated with a specified + * resource. A tag is a label that you optionally define and associate + * with a resource. Each tag consists of a required tag key and an + * optional associated tag value. A tag key is a general label that + * acts as a category for more specific tag values. A tag value acts as a descriptor within + * a tag key.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +42,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutAccountDedicatedIpWarmupAttributesCommand.ts b/clients/client-sesv2/commands/PutAccountDedicatedIpWarmupAttributesCommand.ts index 4cf0031b20c77..5f993b8212ba1 100644 --- a/clients/client-sesv2/commands/PutAccountDedicatedIpWarmupAttributesCommand.ts +++ b/clients/client-sesv2/commands/PutAccountDedicatedIpWarmupAttributesCommand.ts @@ -24,6 +24,9 @@ export type PutAccountDedicatedIpWarmupAttributesCommandInput = PutAccountDedica export type PutAccountDedicatedIpWarmupAttributesCommandOutput = PutAccountDedicatedIpWarmupAttributesResponse & __MetadataBearer; +/** + *

Enable or disable the automatic warm-up feature for dedicated IP addresses.

+ */ export class PutAccountDedicatedIpWarmupAttributesCommand extends $Command< PutAccountDedicatedIpWarmupAttributesCommandInput, PutAccountDedicatedIpWarmupAttributesCommandOutput, @@ -38,6 +41,9 @@ export class PutAccountDedicatedIpWarmupAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutAccountDetailsCommand.ts b/clients/client-sesv2/commands/PutAccountDetailsCommand.ts index a81770b6d1cd2..68c91e6faddfb 100644 --- a/clients/client-sesv2/commands/PutAccountDetailsCommand.ts +++ b/clients/client-sesv2/commands/PutAccountDetailsCommand.ts @@ -20,6 +20,9 @@ import { export type PutAccountDetailsCommandInput = PutAccountDetailsRequest; export type PutAccountDetailsCommandOutput = PutAccountDetailsResponse & __MetadataBearer; +/** + *

Update your Amazon SES account details.

+ */ export class PutAccountDetailsCommand extends $Command< PutAccountDetailsCommandInput, PutAccountDetailsCommandOutput, @@ -34,6 +37,9 @@ export class PutAccountDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutAccountSendingAttributesCommand.ts b/clients/client-sesv2/commands/PutAccountSendingAttributesCommand.ts index 448f41787ed1a..b2d04a22a9fc2 100644 --- a/clients/client-sesv2/commands/PutAccountSendingAttributesCommand.ts +++ b/clients/client-sesv2/commands/PutAccountSendingAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type PutAccountSendingAttributesCommandInput = PutAccountSendingAttributesRequest; export type PutAccountSendingAttributesCommandOutput = PutAccountSendingAttributesResponse & __MetadataBearer; +/** + *

Enable or disable the ability of your account to send email.

+ */ export class PutAccountSendingAttributesCommand extends $Command< PutAccountSendingAttributesCommandInput, PutAccountSendingAttributesCommandOutput, @@ -34,6 +37,9 @@ export class PutAccountSendingAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutAccountSuppressionAttributesCommand.ts b/clients/client-sesv2/commands/PutAccountSuppressionAttributesCommand.ts index 060dc5ef37889..5567b0750fa88 100644 --- a/clients/client-sesv2/commands/PutAccountSuppressionAttributesCommand.ts +++ b/clients/client-sesv2/commands/PutAccountSuppressionAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type PutAccountSuppressionAttributesCommandInput = PutAccountSuppressionAttributesRequest; export type PutAccountSuppressionAttributesCommandOutput = PutAccountSuppressionAttributesResponse & __MetadataBearer; +/** + *

Change the settings for the account-level suppression list.

+ */ export class PutAccountSuppressionAttributesCommand extends $Command< PutAccountSuppressionAttributesCommandInput, PutAccountSuppressionAttributesCommandOutput, @@ -34,6 +37,9 @@ export class PutAccountSuppressionAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutConfigurationSetDeliveryOptionsCommand.ts b/clients/client-sesv2/commands/PutConfigurationSetDeliveryOptionsCommand.ts index c7d5a7ea26b76..12acbb72c6d02 100644 --- a/clients/client-sesv2/commands/PutConfigurationSetDeliveryOptionsCommand.ts +++ b/clients/client-sesv2/commands/PutConfigurationSetDeliveryOptionsCommand.ts @@ -24,6 +24,10 @@ export type PutConfigurationSetDeliveryOptionsCommandInput = PutConfigurationSet export type PutConfigurationSetDeliveryOptionsCommandOutput = PutConfigurationSetDeliveryOptionsResponse & __MetadataBearer; +/** + *

Associate a configuration set with a dedicated IP pool. You can use dedicated IP pools + * to create groups of dedicated IP addresses for sending specific types of email.

+ */ export class PutConfigurationSetDeliveryOptionsCommand extends $Command< PutConfigurationSetDeliveryOptionsCommandInput, PutConfigurationSetDeliveryOptionsCommandOutput, @@ -38,6 +42,9 @@ export class PutConfigurationSetDeliveryOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutConfigurationSetReputationOptionsCommand.ts b/clients/client-sesv2/commands/PutConfigurationSetReputationOptionsCommand.ts index 26ae8d882fb44..b0ccf7edf8ade 100644 --- a/clients/client-sesv2/commands/PutConfigurationSetReputationOptionsCommand.ts +++ b/clients/client-sesv2/commands/PutConfigurationSetReputationOptionsCommand.ts @@ -24,6 +24,10 @@ export type PutConfigurationSetReputationOptionsCommandInput = PutConfigurationS export type PutConfigurationSetReputationOptionsCommandOutput = PutConfigurationSetReputationOptionsResponse & __MetadataBearer; +/** + *

Enable or disable collection of reputation metrics for emails that you send using a + * particular configuration set in a specific AWS Region.

+ */ export class PutConfigurationSetReputationOptionsCommand extends $Command< PutConfigurationSetReputationOptionsCommandInput, PutConfigurationSetReputationOptionsCommandOutput, @@ -38,6 +42,9 @@ export class PutConfigurationSetReputationOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutConfigurationSetSendingOptionsCommand.ts b/clients/client-sesv2/commands/PutConfigurationSetSendingOptionsCommand.ts index 9738280efc1be..fbdfda22e1ee6 100644 --- a/clients/client-sesv2/commands/PutConfigurationSetSendingOptionsCommand.ts +++ b/clients/client-sesv2/commands/PutConfigurationSetSendingOptionsCommand.ts @@ -24,6 +24,10 @@ export type PutConfigurationSetSendingOptionsCommandInput = PutConfigurationSetS export type PutConfigurationSetSendingOptionsCommandOutput = PutConfigurationSetSendingOptionsResponse & __MetadataBearer; +/** + *

Enable or disable email sending for messages that use a particular configuration set + * in a specific AWS Region.

+ */ export class PutConfigurationSetSendingOptionsCommand extends $Command< PutConfigurationSetSendingOptionsCommandInput, PutConfigurationSetSendingOptionsCommandOutput, @@ -38,6 +42,9 @@ export class PutConfigurationSetSendingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutConfigurationSetSuppressionOptionsCommand.ts b/clients/client-sesv2/commands/PutConfigurationSetSuppressionOptionsCommand.ts index 01469171cdf20..571fe8da90b52 100644 --- a/clients/client-sesv2/commands/PutConfigurationSetSuppressionOptionsCommand.ts +++ b/clients/client-sesv2/commands/PutConfigurationSetSuppressionOptionsCommand.ts @@ -24,6 +24,9 @@ export type PutConfigurationSetSuppressionOptionsCommandInput = PutConfiguration export type PutConfigurationSetSuppressionOptionsCommandOutput = PutConfigurationSetSuppressionOptionsResponse & __MetadataBearer; +/** + *

Specify the account suppression list preferences for a configuration set.

+ */ export class PutConfigurationSetSuppressionOptionsCommand extends $Command< PutConfigurationSetSuppressionOptionsCommandInput, PutConfigurationSetSuppressionOptionsCommandOutput, @@ -38,6 +41,9 @@ export class PutConfigurationSetSuppressionOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutConfigurationSetTrackingOptionsCommand.ts b/clients/client-sesv2/commands/PutConfigurationSetTrackingOptionsCommand.ts index c60e7119de70d..e20bb216132e9 100644 --- a/clients/client-sesv2/commands/PutConfigurationSetTrackingOptionsCommand.ts +++ b/clients/client-sesv2/commands/PutConfigurationSetTrackingOptionsCommand.ts @@ -24,6 +24,10 @@ export type PutConfigurationSetTrackingOptionsCommandInput = PutConfigurationSet export type PutConfigurationSetTrackingOptionsCommandOutput = PutConfigurationSetTrackingOptionsResponse & __MetadataBearer; +/** + *

Specify a custom domain to use for open and click tracking elements in email that you + * send.

+ */ export class PutConfigurationSetTrackingOptionsCommand extends $Command< PutConfigurationSetTrackingOptionsCommandInput, PutConfigurationSetTrackingOptionsCommandOutput, @@ -38,6 +42,9 @@ export class PutConfigurationSetTrackingOptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutDedicatedIpInPoolCommand.ts b/clients/client-sesv2/commands/PutDedicatedIpInPoolCommand.ts index 01a7eafebbb5a..3e88b4c21ae8e 100644 --- a/clients/client-sesv2/commands/PutDedicatedIpInPoolCommand.ts +++ b/clients/client-sesv2/commands/PutDedicatedIpInPoolCommand.ts @@ -20,6 +20,18 @@ import { export type PutDedicatedIpInPoolCommandInput = PutDedicatedIpInPoolRequest; export type PutDedicatedIpInPoolCommandOutput = PutDedicatedIpInPoolResponse & __MetadataBearer; +/** + *

Move a dedicated IP address to an existing dedicated IP pool.

+ * + *

The dedicated IP address that you specify must already exist, and must be + * associated with your AWS account. + * + *

+ *

The dedicated IP pool you specify must already exist. You can create a new pool by + * using the CreateDedicatedIpPool operation.

+ * + *
+ */ export class PutDedicatedIpInPoolCommand extends $Command< PutDedicatedIpInPoolCommandInput, PutDedicatedIpInPoolCommandOutput, @@ -34,6 +46,9 @@ export class PutDedicatedIpInPoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutDedicatedIpWarmupAttributesCommand.ts b/clients/client-sesv2/commands/PutDedicatedIpWarmupAttributesCommand.ts index b7c1e882467eb..f3f7075d60a81 100644 --- a/clients/client-sesv2/commands/PutDedicatedIpWarmupAttributesCommand.ts +++ b/clients/client-sesv2/commands/PutDedicatedIpWarmupAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type PutDedicatedIpWarmupAttributesCommandInput = PutDedicatedIpWarmupAttributesRequest; export type PutDedicatedIpWarmupAttributesCommandOutput = PutDedicatedIpWarmupAttributesResponse & __MetadataBearer; +/** + *

+ */ export class PutDedicatedIpWarmupAttributesCommand extends $Command< PutDedicatedIpWarmupAttributesCommandInput, PutDedicatedIpWarmupAttributesCommandOutput, @@ -34,6 +37,9 @@ export class PutDedicatedIpWarmupAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutDeliverabilityDashboardOptionCommand.ts b/clients/client-sesv2/commands/PutDeliverabilityDashboardOptionCommand.ts index 8720140f0adf5..44b971242b5d0 100644 --- a/clients/client-sesv2/commands/PutDeliverabilityDashboardOptionCommand.ts +++ b/clients/client-sesv2/commands/PutDeliverabilityDashboardOptionCommand.ts @@ -20,6 +20,15 @@ import { export type PutDeliverabilityDashboardOptionCommandInput = PutDeliverabilityDashboardOptionRequest; export type PutDeliverabilityDashboardOptionCommandOutput = PutDeliverabilityDashboardOptionResponse & __MetadataBearer; +/** + *

Enable or disable the Deliverability dashboard. When you enable the Deliverability dashboard, you gain + * access to reputation, deliverability, and other metrics for the domains that you use to + * send email. You also gain the ability to perform predictive inbox placement tests.

+ * + *

When you use the Deliverability dashboard, you pay a monthly subscription charge, in addition + * to any other fees that you accrue by using Amazon SES and other AWS services. For more + * information about the features and cost of a Deliverability dashboard subscription, see Amazon SES Pricing.

+ */ export class PutDeliverabilityDashboardOptionCommand extends $Command< PutDeliverabilityDashboardOptionCommandInput, PutDeliverabilityDashboardOptionCommandOutput, @@ -34,6 +43,9 @@ export class PutDeliverabilityDashboardOptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutEmailIdentityDkimAttributesCommand.ts b/clients/client-sesv2/commands/PutEmailIdentityDkimAttributesCommand.ts index ca36fe67b7195..9eaebcdb8df8e 100644 --- a/clients/client-sesv2/commands/PutEmailIdentityDkimAttributesCommand.ts +++ b/clients/client-sesv2/commands/PutEmailIdentityDkimAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type PutEmailIdentityDkimAttributesCommandInput = PutEmailIdentityDkimAttributesRequest; export type PutEmailIdentityDkimAttributesCommandOutput = PutEmailIdentityDkimAttributesResponse & __MetadataBearer; +/** + *

Used to enable or disable DKIM authentication for an email identity.

+ */ export class PutEmailIdentityDkimAttributesCommand extends $Command< PutEmailIdentityDkimAttributesCommandInput, PutEmailIdentityDkimAttributesCommandOutput, @@ -34,6 +37,9 @@ export class PutEmailIdentityDkimAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutEmailIdentityDkimSigningAttributesCommand.ts b/clients/client-sesv2/commands/PutEmailIdentityDkimSigningAttributesCommand.ts index 8e7ab0e09c681..07c740a02de1f 100644 --- a/clients/client-sesv2/commands/PutEmailIdentityDkimSigningAttributesCommand.ts +++ b/clients/client-sesv2/commands/PutEmailIdentityDkimSigningAttributesCommand.ts @@ -24,6 +24,28 @@ export type PutEmailIdentityDkimSigningAttributesCommandInput = PutEmailIdentity export type PutEmailIdentityDkimSigningAttributesCommandOutput = PutEmailIdentityDkimSigningAttributesResponse & __MetadataBearer; +/** + *

Used to configure or change the DKIM authentication settings for an email domain + * identity. You can use this operation to do any of the following:

+ *
    + *
  • + *

    Update the signing attributes for an identity that uses Bring Your Own DKIM + * (BYODKIM).

    + *
  • + *
  • + *

    Change from using no DKIM authentication to using Easy DKIM.

    + *
  • + *
  • + *

    Change from using no DKIM authentication to using BYODKIM.

    + *
  • + *
  • + *

    Change from using Easy DKIM to using BYODKIM.

    + *
  • + *
  • + *

    Change from using BYODKIM to using Easy DKIM.

    + *
  • + *
+ */ export class PutEmailIdentityDkimSigningAttributesCommand extends $Command< PutEmailIdentityDkimSigningAttributesCommandInput, PutEmailIdentityDkimSigningAttributesCommandOutput, @@ -38,6 +60,9 @@ export class PutEmailIdentityDkimSigningAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutEmailIdentityFeedbackAttributesCommand.ts b/clients/client-sesv2/commands/PutEmailIdentityFeedbackAttributesCommand.ts index 492876b52902d..f7724ea799dfd 100644 --- a/clients/client-sesv2/commands/PutEmailIdentityFeedbackAttributesCommand.ts +++ b/clients/client-sesv2/commands/PutEmailIdentityFeedbackAttributesCommand.ts @@ -24,6 +24,18 @@ export type PutEmailIdentityFeedbackAttributesCommandInput = PutEmailIdentityFee export type PutEmailIdentityFeedbackAttributesCommandOutput = PutEmailIdentityFeedbackAttributesResponse & __MetadataBearer; +/** + *

Used to enable or disable feedback forwarding for an identity. This setting determines + * what happens when an identity is used to send an email that results in a bounce or + * complaint event.

+ *

If the value is true, you receive email notifications when bounce or + * complaint events occur. These notifications are sent to the address that you specified + * in the Return-Path header of the original email.

+ *

You're required to have a method of tracking bounces and complaints. If you haven't + * set up another mechanism for receiving bounce or complaint notifications (for example, + * by setting up an event destination), you receive an email notification when these events + * occur (even if this setting is disabled).

+ */ export class PutEmailIdentityFeedbackAttributesCommand extends $Command< PutEmailIdentityFeedbackAttributesCommandInput, PutEmailIdentityFeedbackAttributesCommandOutput, @@ -38,6 +50,9 @@ export class PutEmailIdentityFeedbackAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutEmailIdentityMailFromAttributesCommand.ts b/clients/client-sesv2/commands/PutEmailIdentityMailFromAttributesCommand.ts index ed24cf38a1947..f2d17b1b082d1 100644 --- a/clients/client-sesv2/commands/PutEmailIdentityMailFromAttributesCommand.ts +++ b/clients/client-sesv2/commands/PutEmailIdentityMailFromAttributesCommand.ts @@ -24,6 +24,10 @@ export type PutEmailIdentityMailFromAttributesCommandInput = PutEmailIdentityMai export type PutEmailIdentityMailFromAttributesCommandOutput = PutEmailIdentityMailFromAttributesResponse & __MetadataBearer; +/** + *

Used to enable or disable the custom Mail-From domain configuration for an email + * identity.

+ */ export class PutEmailIdentityMailFromAttributesCommand extends $Command< PutEmailIdentityMailFromAttributesCommandInput, PutEmailIdentityMailFromAttributesCommandOutput, @@ -38,6 +42,9 @@ export class PutEmailIdentityMailFromAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/PutSuppressedDestinationCommand.ts b/clients/client-sesv2/commands/PutSuppressedDestinationCommand.ts index 0195d16bcee9b..962a64fe58217 100644 --- a/clients/client-sesv2/commands/PutSuppressedDestinationCommand.ts +++ b/clients/client-sesv2/commands/PutSuppressedDestinationCommand.ts @@ -20,6 +20,9 @@ import { export type PutSuppressedDestinationCommandInput = PutSuppressedDestinationRequest; export type PutSuppressedDestinationCommandOutput = PutSuppressedDestinationResponse & __MetadataBearer; +/** + *

Adds an email address to the suppression list for your account.

+ */ export class PutSuppressedDestinationCommand extends $Command< PutSuppressedDestinationCommandInput, PutSuppressedDestinationCommandOutput, @@ -34,6 +37,9 @@ export class PutSuppressedDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/SendBulkEmailCommand.ts b/clients/client-sesv2/commands/SendBulkEmailCommand.ts index 974dd3a5383bc..29234ab837728 100644 --- a/clients/client-sesv2/commands/SendBulkEmailCommand.ts +++ b/clients/client-sesv2/commands/SendBulkEmailCommand.ts @@ -20,6 +20,9 @@ import { export type SendBulkEmailCommandInput = SendBulkEmailRequest; export type SendBulkEmailCommandOutput = SendBulkEmailResponse & __MetadataBearer; +/** + *

Composes an email message to multiple destinations.

+ */ export class SendBulkEmailCommand extends $Command< SendBulkEmailCommandInput, SendBulkEmailCommandOutput, @@ -34,6 +37,9 @@ export class SendBulkEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/SendCustomVerificationEmailCommand.ts b/clients/client-sesv2/commands/SendCustomVerificationEmailCommand.ts index 17fffc7dbeca0..99144ecd8cbc2 100644 --- a/clients/client-sesv2/commands/SendCustomVerificationEmailCommand.ts +++ b/clients/client-sesv2/commands/SendCustomVerificationEmailCommand.ts @@ -20,6 +20,16 @@ import { export type SendCustomVerificationEmailCommandInput = SendCustomVerificationEmailRequest; export type SendCustomVerificationEmailCommandOutput = SendCustomVerificationEmailResponse & __MetadataBearer; +/** + *

Adds an email address to the list of identities for your Amazon SES account in the current + * AWS Region and attempts to verify it. As a result of executing this operation, a + * customized verification email is sent to the specified address.

+ *

To use this operation, you must first create a custom verification email template. For + * more information about creating and using custom verification email templates, see + * Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class SendCustomVerificationEmailCommand extends $Command< SendCustomVerificationEmailCommandInput, SendCustomVerificationEmailCommandOutput, @@ -34,6 +44,9 @@ export class SendCustomVerificationEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/SendEmailCommand.ts b/clients/client-sesv2/commands/SendEmailCommand.ts index 19af26e8b6e58..d563d5b9c1a38 100644 --- a/clients/client-sesv2/commands/SendEmailCommand.ts +++ b/clients/client-sesv2/commands/SendEmailCommand.ts @@ -20,6 +20,32 @@ import { export type SendEmailCommandInput = SendEmailRequest; export type SendEmailCommandOutput = SendEmailResponse & __MetadataBearer; +/** + *

Sends an email message. You can use the Amazon SES API v2 to send two types of + * messages:

+ *
    + *
  • + *

    + * Simple – A standard email message. When + * you create this type of message, you specify the sender, the recipient, and the + * message body, and Amazon SES assembles the message for you.

    + *
  • + *
  • + *

    + * Raw – A raw, MIME-formatted email + * message. When you send this type of email, you have to specify all of the + * message headers, as well as the message body. You can use this message type to + * send messages that contain attachments. The message that you specify has to be a + * valid MIME message.

    + *
  • + *
  • + *

    + * Templated – A message that contains + * personalization tags. When you send this type of email, Amazon SES API v2 automatically + * replaces the tags with values that you specify.

    + *
  • + *
+ */ export class SendEmailCommand extends $Command< SendEmailCommandInput, SendEmailCommandOutput, @@ -34,6 +60,9 @@ export class SendEmailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/TagResourceCommand.ts b/clients/client-sesv2/commands/TagResourceCommand.ts index fcd19fb042b8b..e06dfe526195a 100644 --- a/clients/client-sesv2/commands/TagResourceCommand.ts +++ b/clients/client-sesv2/commands/TagResourceCommand.ts @@ -20,6 +20,17 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Add one or more tags (keys and values) to a specified resource. A + * tag is a label that you optionally define and associate with a + * resource. Tags can help you categorize and manage resources in different ways, such as + * by purpose, owner, environment, or other criteria. A resource can have as many as 50 + * tags.

+ *

Each tag consists of a required tag key and an + * associated tag value, both of which you define. A tag key is a + * general label that acts as a category for more specific tag values. A tag value acts as + * a descriptor within a tag key.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +45,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/TestRenderEmailTemplateCommand.ts b/clients/client-sesv2/commands/TestRenderEmailTemplateCommand.ts index 7d9d8ce2a5d25..8c9b5e4e9d1a9 100644 --- a/clients/client-sesv2/commands/TestRenderEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/TestRenderEmailTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type TestRenderEmailTemplateCommandInput = TestRenderEmailTemplateRequest; export type TestRenderEmailTemplateCommandOutput = TestRenderEmailTemplateResponse & __MetadataBearer; +/** + *

Creates a preview of the MIME content of an email when provided with a template and a + * set of replacement data.

+ * + *

You can execute this operation no more than once per second.

+ */ export class TestRenderEmailTemplateCommand extends $Command< TestRenderEmailTemplateCommandInput, TestRenderEmailTemplateCommandOutput, @@ -34,6 +40,9 @@ export class TestRenderEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/UntagResourceCommand.ts b/clients/client-sesv2/commands/UntagResourceCommand.ts index 402438a5350cf..58f9fe5cd4d34 100644 --- a/clients/client-sesv2/commands/UntagResourceCommand.ts +++ b/clients/client-sesv2/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Remove one or more tags (keys and values) from a specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/UpdateConfigurationSetEventDestinationCommand.ts b/clients/client-sesv2/commands/UpdateConfigurationSetEventDestinationCommand.ts index f42239add0b69..22b4d17f04ce6 100644 --- a/clients/client-sesv2/commands/UpdateConfigurationSetEventDestinationCommand.ts +++ b/clients/client-sesv2/commands/UpdateConfigurationSetEventDestinationCommand.ts @@ -24,6 +24,15 @@ export type UpdateConfigurationSetEventDestinationCommandInput = UpdateConfigura export type UpdateConfigurationSetEventDestinationCommandOutput = UpdateConfigurationSetEventDestinationResponse & __MetadataBearer; +/** + *

Update the configuration of an event destination for a configuration set.

+ *

+ * Events include message sends, deliveries, opens, clicks, bounces, + * and complaints. Event destinations are places that you can send + * information about these events to. For example, you can send event data to Amazon SNS to + * receive notifications when you receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to + * stream data to Amazon S3 for long-term storage.

+ */ export class UpdateConfigurationSetEventDestinationCommand extends $Command< UpdateConfigurationSetEventDestinationCommandInput, UpdateConfigurationSetEventDestinationCommandOutput, @@ -38,6 +47,9 @@ export class UpdateConfigurationSetEventDestinationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/UpdateContactCommand.ts b/clients/client-sesv2/commands/UpdateContactCommand.ts index 5e803c00d1ef6..03a5c7832320a 100644 --- a/clients/client-sesv2/commands/UpdateContactCommand.ts +++ b/clients/client-sesv2/commands/UpdateContactCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateContactCommandInput = UpdateContactRequest; export type UpdateContactCommandOutput = UpdateContactResponse & __MetadataBearer; +/** + *

Updates a contact's preferences for a list. It is not necessary to specify all + * existing topic preferences in the TopicPreferences object, just the ones that need + * updating.

+ */ export class UpdateContactCommand extends $Command< UpdateContactCommandInput, UpdateContactCommandOutput, @@ -34,6 +39,9 @@ export class UpdateContactCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/UpdateContactListCommand.ts b/clients/client-sesv2/commands/UpdateContactListCommand.ts index 9c368bd59519e..3658c426461f9 100644 --- a/clients/client-sesv2/commands/UpdateContactListCommand.ts +++ b/clients/client-sesv2/commands/UpdateContactListCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateContactListCommandInput = UpdateContactListRequest; export type UpdateContactListCommandOutput = UpdateContactListResponse & __MetadataBearer; +/** + *

Updates contact list metadata. This operation does a complete replacement.

+ */ export class UpdateContactListCommand extends $Command< UpdateContactListCommandInput, UpdateContactListCommandOutput, @@ -34,6 +37,9 @@ export class UpdateContactListCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/UpdateCustomVerificationEmailTemplateCommand.ts b/clients/client-sesv2/commands/UpdateCustomVerificationEmailTemplateCommand.ts index d975d0ed5cf51..2cc94c23e9dd0 100644 --- a/clients/client-sesv2/commands/UpdateCustomVerificationEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/UpdateCustomVerificationEmailTemplateCommand.ts @@ -24,6 +24,12 @@ export type UpdateCustomVerificationEmailTemplateCommandInput = UpdateCustomVeri export type UpdateCustomVerificationEmailTemplateCommandOutput = UpdateCustomVerificationEmailTemplateResponse & __MetadataBearer; +/** + *

Updates an existing custom verification email template.

+ *

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer + * Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class UpdateCustomVerificationEmailTemplateCommand extends $Command< UpdateCustomVerificationEmailTemplateCommandInput, UpdateCustomVerificationEmailTemplateCommandOutput, @@ -38,6 +44,9 @@ export class UpdateCustomVerificationEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/UpdateEmailIdentityPolicyCommand.ts b/clients/client-sesv2/commands/UpdateEmailIdentityPolicyCommand.ts index 21612fa9669fd..d3b1ac83d5de6 100644 --- a/clients/client-sesv2/commands/UpdateEmailIdentityPolicyCommand.ts +++ b/clients/client-sesv2/commands/UpdateEmailIdentityPolicyCommand.ts @@ -20,6 +20,21 @@ import { export type UpdateEmailIdentityPolicyCommandInput = UpdateEmailIdentityPolicyRequest; export type UpdateEmailIdentityPolicyCommandOutput = UpdateEmailIdentityPolicyResponse & __MetadataBearer; +/** + *

Updates the specified sending authorization policy for the given identity (an email + * address or a domain). This API returns successfully even if a policy with the specified + * name does not exist.

+ * + *

This API is for the identity owner only. If you have not verified the identity, + * this API will return an error.

+ *
+ *

Sending authorization is a feature that enables an identity owner to authorize other + * senders to use its identities. For information about using sending authorization, see + * the Amazon SES Developer + * Guide.

+ * + *

You can execute this operation no more than once per second.

+ */ export class UpdateEmailIdentityPolicyCommand extends $Command< UpdateEmailIdentityPolicyCommandInput, UpdateEmailIdentityPolicyCommandOutput, @@ -34,6 +49,9 @@ export class UpdateEmailIdentityPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/commands/UpdateEmailTemplateCommand.ts b/clients/client-sesv2/commands/UpdateEmailTemplateCommand.ts index d4a00ecc6b9c6..5fd3805b3fe29 100644 --- a/clients/client-sesv2/commands/UpdateEmailTemplateCommand.ts +++ b/clients/client-sesv2/commands/UpdateEmailTemplateCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateEmailTemplateCommandInput = UpdateEmailTemplateRequest; export type UpdateEmailTemplateCommandOutput = UpdateEmailTemplateResponse & __MetadataBearer; +/** + *

Updates an email template. Email templates enable you to send personalized email to + * one or more destinations in a single API operation. For more information, see the Amazon SES + * Developer Guide.

+ *

You can execute this operation no more than once per second.

+ */ export class UpdateEmailTemplateCommand extends $Command< UpdateEmailTemplateCommandInput, UpdateEmailTemplateCommandOutput, @@ -34,6 +40,9 @@ export class UpdateEmailTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SESv2ClientResolvedConfig, diff --git a/clients/client-sesv2/package.json b/clients/client-sesv2/package.json index 4b4b9c0cd5ea9..90989c077390b 100644 --- a/clients/client-sesv2/package.json +++ b/clients/client-sesv2/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sesv2 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sesv2/pagination/GetDedicatedIpsPaginator.ts b/clients/client-sesv2/pagination/GetDedicatedIpsPaginator.ts index ffac1f20e1331..13287801beb0f 100644 --- a/clients/client-sesv2/pagination/GetDedicatedIpsPaginator.ts +++ b/clients/client-sesv2/pagination/GetDedicatedIpsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: GetDedicatedIpsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetDedicatedIpsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: GetDedicatedIpsCommandInput, diff --git a/clients/client-sesv2/pagination/ListConfigurationSetsPaginator.ts b/clients/client-sesv2/pagination/ListConfigurationSetsPaginator.ts index 6a023860b6aa6..340189e2361ca 100644 --- a/clients/client-sesv2/pagination/ListConfigurationSetsPaginator.ts +++ b/clients/client-sesv2/pagination/ListConfigurationSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListConfigurationSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListConfigurationSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListConfigurationSetsCommandInput, diff --git a/clients/client-sesv2/pagination/ListContactListsPaginator.ts b/clients/client-sesv2/pagination/ListContactListsPaginator.ts index 503ab29515f83..5032821d124da 100644 --- a/clients/client-sesv2/pagination/ListContactListsPaginator.ts +++ b/clients/client-sesv2/pagination/ListContactListsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListContactListsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListContactListsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListContactListsCommandInput, diff --git a/clients/client-sesv2/pagination/ListContactsPaginator.ts b/clients/client-sesv2/pagination/ListContactsPaginator.ts index 8f800a3106e59..d710b0c2a476e 100644 --- a/clients/client-sesv2/pagination/ListContactsPaginator.ts +++ b/clients/client-sesv2/pagination/ListContactsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListContactsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListContactsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListContactsCommandInput, diff --git a/clients/client-sesv2/pagination/ListCustomVerificationEmailTemplatesPaginator.ts b/clients/client-sesv2/pagination/ListCustomVerificationEmailTemplatesPaginator.ts index e14cca373cd26..4d4848d58451a 100644 --- a/clients/client-sesv2/pagination/ListCustomVerificationEmailTemplatesPaginator.ts +++ b/clients/client-sesv2/pagination/ListCustomVerificationEmailTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListCustomVerificationEmailTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCustomVerificationEmailTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListCustomVerificationEmailTemplatesCommandInput, diff --git a/clients/client-sesv2/pagination/ListDedicatedIpPoolsPaginator.ts b/clients/client-sesv2/pagination/ListDedicatedIpPoolsPaginator.ts index 77d09bb6554cd..0357e259e1b91 100644 --- a/clients/client-sesv2/pagination/ListDedicatedIpPoolsPaginator.ts +++ b/clients/client-sesv2/pagination/ListDedicatedIpPoolsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListDedicatedIpPoolsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDedicatedIpPoolsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListDedicatedIpPoolsCommandInput, diff --git a/clients/client-sesv2/pagination/ListDeliverabilityTestReportsPaginator.ts b/clients/client-sesv2/pagination/ListDeliverabilityTestReportsPaginator.ts index 0f80777af2fc3..781dfb6b4d16d 100644 --- a/clients/client-sesv2/pagination/ListDeliverabilityTestReportsPaginator.ts +++ b/clients/client-sesv2/pagination/ListDeliverabilityTestReportsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListDeliverabilityTestReportsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeliverabilityTestReportsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListDeliverabilityTestReportsCommandInput, diff --git a/clients/client-sesv2/pagination/ListDomainDeliverabilityCampaignsPaginator.ts b/clients/client-sesv2/pagination/ListDomainDeliverabilityCampaignsPaginator.ts index 67659afabac15..85477c974ba1c 100644 --- a/clients/client-sesv2/pagination/ListDomainDeliverabilityCampaignsPaginator.ts +++ b/clients/client-sesv2/pagination/ListDomainDeliverabilityCampaignsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListDomainDeliverabilityCampaignsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainDeliverabilityCampaignsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListDomainDeliverabilityCampaignsCommandInput, diff --git a/clients/client-sesv2/pagination/ListEmailIdentitiesPaginator.ts b/clients/client-sesv2/pagination/ListEmailIdentitiesPaginator.ts index e590884aeab8e..6d20ec1101c9d 100644 --- a/clients/client-sesv2/pagination/ListEmailIdentitiesPaginator.ts +++ b/clients/client-sesv2/pagination/ListEmailIdentitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListEmailIdentitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEmailIdentitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListEmailIdentitiesCommandInput, diff --git a/clients/client-sesv2/pagination/ListEmailTemplatesPaginator.ts b/clients/client-sesv2/pagination/ListEmailTemplatesPaginator.ts index e172bdcf7e841..e70281fa13c73 100644 --- a/clients/client-sesv2/pagination/ListEmailTemplatesPaginator.ts +++ b/clients/client-sesv2/pagination/ListEmailTemplatesPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListEmailTemplatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEmailTemplatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListEmailTemplatesCommandInput, diff --git a/clients/client-sesv2/pagination/ListImportJobsPaginator.ts b/clients/client-sesv2/pagination/ListImportJobsPaginator.ts index 9a87810eaaca6..3a28bf46d931d 100644 --- a/clients/client-sesv2/pagination/ListImportJobsPaginator.ts +++ b/clients/client-sesv2/pagination/ListImportJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListImportJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListImportJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListImportJobsCommandInput, diff --git a/clients/client-sesv2/pagination/ListSuppressedDestinationsPaginator.ts b/clients/client-sesv2/pagination/ListSuppressedDestinationsPaginator.ts index 5340f92781650..a33a28e39647e 100644 --- a/clients/client-sesv2/pagination/ListSuppressedDestinationsPaginator.ts +++ b/clients/client-sesv2/pagination/ListSuppressedDestinationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SESv2PaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SESv2Client, input: ListSuppressedDestinationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSuppressedDestinationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SESv2, input: ListSuppressedDestinationsCommandInput, diff --git a/clients/client-sesv2/runtimeConfig.browser.ts b/clients/client-sesv2/runtimeConfig.browser.ts index 014e2d56b6078..3b0175a077505 100644 --- a/clients/client-sesv2/runtimeConfig.browser.ts +++ b/clients/client-sesv2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SESv2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sesv2/runtimeConfig.native.ts b/clients/client-sesv2/runtimeConfig.native.ts index 7460cea55d0ac..643610f632566 100644 --- a/clients/client-sesv2/runtimeConfig.native.ts +++ b/clients/client-sesv2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SESv2Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sesv2/runtimeConfig.shared.ts b/clients/client-sesv2/runtimeConfig.shared.ts index 569c73719dd70..05e41364d2f01 100644 --- a/clients/client-sesv2/runtimeConfig.shared.ts +++ b/clients/client-sesv2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-09-27", disableHostPrefix: false, diff --git a/clients/client-sesv2/runtimeConfig.ts b/clients/client-sesv2/runtimeConfig.ts index 96fd4194b81c7..29dfbbbfe6c0c 100644 --- a/clients/client-sesv2/runtimeConfig.ts +++ b/clients/client-sesv2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SESv2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sesv2/tsconfig.json b/clients/client-sesv2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sesv2/tsconfig.json +++ b/clients/client-sesv2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sfn/commands/CreateActivityCommand.ts b/clients/client-sfn/commands/CreateActivityCommand.ts index e17a4de64f92c..8eee29bc4c1e6 100644 --- a/clients/client-sfn/commands/CreateActivityCommand.ts +++ b/clients/client-sfn/commands/CreateActivityCommand.ts @@ -20,6 +20,25 @@ import { export type CreateActivityCommandInput = CreateActivityInput; export type CreateActivityCommandOutput = CreateActivityOutput & __MetadataBearer; +/** + *

Creates an activity. An activity is a task that you write in any programming language and + * host on any machine that has access to AWS Step Functions. Activities must poll Step Functions using the + * GetActivityTask API action and respond using SendTask* API + * actions. This function lets Step Functions know the existence of your activity and returns an + * identifier for use in a state machine and when polling from the activity.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ * + *

+ * CreateActivity is an idempotent API. Subsequent requests won’t create a + * duplicate resource if it was already created. CreateActivity's idempotency + * check is based on the activity name. If a following request has different + * tags values, Step Functions will ignore these differences and treat it as an + * idempotent request of the previous. In this case, tags will not be updated, + * even if they are different.

+ *
+ */ export class CreateActivityCommand extends $Command< CreateActivityCommandInput, CreateActivityCommandOutput, @@ -34,6 +53,9 @@ export class CreateActivityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/CreateStateMachineCommand.ts b/clients/client-sfn/commands/CreateStateMachineCommand.ts index 0b54ea5cf4860..d3ab55e9ddb4d 100644 --- a/clients/client-sfn/commands/CreateStateMachineCommand.ts +++ b/clients/client-sfn/commands/CreateStateMachineCommand.ts @@ -20,6 +20,27 @@ import { export type CreateStateMachineCommandInput = CreateStateMachineInput; export type CreateStateMachineCommandOutput = CreateStateMachineOutput & __MetadataBearer; +/** + *

Creates a state machine. A state machine consists of a collection of states that can do + * work (Task states), determine to which states to transition next + * (Choice states), stop an execution with an error (Fail states), + * and so on. State machines are specified using a JSON-based, structured language. For more + * information, see Amazon States + * Language in the AWS Step Functions User Guide.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ * + *

+ * CreateStateMachine is an idempotent API. Subsequent requests won’t create a + * duplicate resource if it was already created. CreateStateMachine's idempotency + * check is based on the state machine name, definition, + * type, LoggingConfiguration and TracingConfiguration. If a following request has a + * different roleArn or tags, Step Functions will ignore these differences and + * treat it as an idempotent request of the previous. In this case, roleArn and + * tags will not be updated, even if they are different.

+ *
+ */ export class CreateStateMachineCommand extends $Command< CreateStateMachineCommandInput, CreateStateMachineCommandOutput, @@ -34,6 +55,9 @@ export class CreateStateMachineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/DeleteActivityCommand.ts b/clients/client-sfn/commands/DeleteActivityCommand.ts index 0d731c8184fb5..3d11be0b6fb93 100644 --- a/clients/client-sfn/commands/DeleteActivityCommand.ts +++ b/clients/client-sfn/commands/DeleteActivityCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteActivityCommandInput = DeleteActivityInput; export type DeleteActivityCommandOutput = DeleteActivityOutput & __MetadataBearer; +/** + *

Deletes an activity.

+ */ export class DeleteActivityCommand extends $Command< DeleteActivityCommandInput, DeleteActivityCommandOutput, @@ -34,6 +37,9 @@ export class DeleteActivityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/DeleteStateMachineCommand.ts b/clients/client-sfn/commands/DeleteStateMachineCommand.ts index 48e8a142bfea0..025f5cc801561 100644 --- a/clients/client-sfn/commands/DeleteStateMachineCommand.ts +++ b/clients/client-sfn/commands/DeleteStateMachineCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteStateMachineCommandInput = DeleteStateMachineInput; export type DeleteStateMachineCommandOutput = DeleteStateMachineOutput & __MetadataBearer; +/** + *

Deletes a state machine. This is an asynchronous operation: It sets the state machine's + * status to DELETING and begins the deletion process.

+ * + *

For EXPRESSstate machines, the deletion will happen eventually (usually + * less than a minute). Running executions may emit logs after DeleteStateMachine + * API is called.

+ *
+ */ export class DeleteStateMachineCommand extends $Command< DeleteStateMachineCommandInput, DeleteStateMachineCommandOutput, @@ -34,6 +43,9 @@ export class DeleteStateMachineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/DescribeActivityCommand.ts b/clients/client-sfn/commands/DescribeActivityCommand.ts index e1e3847b21f5d..8db0bb6815a4f 100644 --- a/clients/client-sfn/commands/DescribeActivityCommand.ts +++ b/clients/client-sfn/commands/DescribeActivityCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeActivityCommandInput = DescribeActivityInput; export type DescribeActivityCommandOutput = DescribeActivityOutput & __MetadataBearer; +/** + *

Describes an activity.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ */ export class DescribeActivityCommand extends $Command< DescribeActivityCommandInput, DescribeActivityCommandOutput, @@ -34,6 +40,9 @@ export class DescribeActivityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/DescribeExecutionCommand.ts b/clients/client-sfn/commands/DescribeExecutionCommand.ts index 8198d07907249..325c21f94fdb3 100644 --- a/clients/client-sfn/commands/DescribeExecutionCommand.ts +++ b/clients/client-sfn/commands/DescribeExecutionCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeExecutionCommandInput = DescribeExecutionInput; export type DescribeExecutionCommandOutput = DescribeExecutionOutput & __MetadataBearer; +/** + *

Describes an execution.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ *

This API action is not supported by EXPRESS state machines.

+ */ export class DescribeExecutionCommand extends $Command< DescribeExecutionCommandInput, DescribeExecutionCommandOutput, @@ -34,6 +41,9 @@ export class DescribeExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/DescribeStateMachineCommand.ts b/clients/client-sfn/commands/DescribeStateMachineCommand.ts index 277bf5ded1bb5..dde2a2555aa77 100644 --- a/clients/client-sfn/commands/DescribeStateMachineCommand.ts +++ b/clients/client-sfn/commands/DescribeStateMachineCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeStateMachineCommandInput = DescribeStateMachineInput; export type DescribeStateMachineCommandOutput = DescribeStateMachineOutput & __MetadataBearer; +/** + *

Describes a state machine.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ */ export class DescribeStateMachineCommand extends $Command< DescribeStateMachineCommandInput, DescribeStateMachineCommandOutput, @@ -34,6 +40,9 @@ export class DescribeStateMachineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/DescribeStateMachineForExecutionCommand.ts b/clients/client-sfn/commands/DescribeStateMachineForExecutionCommand.ts index 206122ebb4edb..0774e43969ec1 100644 --- a/clients/client-sfn/commands/DescribeStateMachineForExecutionCommand.ts +++ b/clients/client-sfn/commands/DescribeStateMachineForExecutionCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeStateMachineForExecutionCommandInput = DescribeStateMachineForExecutionInput; export type DescribeStateMachineForExecutionCommandOutput = DescribeStateMachineForExecutionOutput & __MetadataBearer; +/** + *

Describes the state machine associated with a specific execution.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ *

This API action is not supported by EXPRESS state machines.

+ */ export class DescribeStateMachineForExecutionCommand extends $Command< DescribeStateMachineForExecutionCommandInput, DescribeStateMachineForExecutionCommandOutput, @@ -34,6 +41,9 @@ export class DescribeStateMachineForExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/GetActivityTaskCommand.ts b/clients/client-sfn/commands/GetActivityTaskCommand.ts index 6ae84e0b8805e..d6abd229cdd14 100644 --- a/clients/client-sfn/commands/GetActivityTaskCommand.ts +++ b/clients/client-sfn/commands/GetActivityTaskCommand.ts @@ -20,6 +20,21 @@ import { export type GetActivityTaskCommandInput = GetActivityTaskInput; export type GetActivityTaskCommandOutput = GetActivityTaskOutput & __MetadataBearer; +/** + *

Used by workers to retrieve a task (with the specified activity ARN) which has been + * scheduled for execution by a running state machine. This initiates a long poll, where the + * service holds the HTTP connection open and responds as soon as a task becomes available (i.e. + * an execution of a task of this type is needed.) The maximum time the service holds on to the + * request before responding is 60 seconds. If no task is available within 60 seconds, the poll + * returns a taskToken with a null string.

+ * + *

Workers should set their client side socket timeout to at least 65 seconds (5 seconds + * higher than the maximum time the service may hold the poll request).

+ *

Polling with GetActivityTask can cause latency in some implementations. See + * Avoid + * Latency When Polling for Activity Tasks in the Step Functions Developer Guide.

+ *
+ */ export class GetActivityTaskCommand extends $Command< GetActivityTaskCommandInput, GetActivityTaskCommandOutput, @@ -34,6 +49,9 @@ export class GetActivityTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/GetExecutionHistoryCommand.ts b/clients/client-sfn/commands/GetExecutionHistoryCommand.ts index 376bd4ca29500..d1058cbdeafbc 100644 --- a/clients/client-sfn/commands/GetExecutionHistoryCommand.ts +++ b/clients/client-sfn/commands/GetExecutionHistoryCommand.ts @@ -20,6 +20,14 @@ import { export type GetExecutionHistoryCommandInput = GetExecutionHistoryInput; export type GetExecutionHistoryCommandOutput = GetExecutionHistoryOutput & __MetadataBearer; +/** + *

Returns the history of the specified execution as a list of events. By default, the + * results are returned in ascending order of the timeStamp of the events. Use the + * reverseOrder parameter to get the latest events first.

+ *

If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. + * Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

+ *

This API action is not supported by EXPRESS state machines.

+ */ export class GetExecutionHistoryCommand extends $Command< GetExecutionHistoryCommandInput, GetExecutionHistoryCommandOutput, @@ -34,6 +42,9 @@ export class GetExecutionHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/ListActivitiesCommand.ts b/clients/client-sfn/commands/ListActivitiesCommand.ts index 9aeda51f91570..f07dc7593a0bb 100644 --- a/clients/client-sfn/commands/ListActivitiesCommand.ts +++ b/clients/client-sfn/commands/ListActivitiesCommand.ts @@ -20,6 +20,14 @@ import { export type ListActivitiesCommandInput = ListActivitiesInput; export type ListActivitiesCommandOutput = ListActivitiesOutput & __MetadataBearer; +/** + *

Lists the existing activities.

+ *

If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. + * Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ */ export class ListActivitiesCommand extends $Command< ListActivitiesCommandInput, ListActivitiesCommandOutput, @@ -34,6 +42,9 @@ export class ListActivitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/ListExecutionsCommand.ts b/clients/client-sfn/commands/ListExecutionsCommand.ts index 2ffd01ea132e7..c60af2aecc875 100644 --- a/clients/client-sfn/commands/ListExecutionsCommand.ts +++ b/clients/client-sfn/commands/ListExecutionsCommand.ts @@ -20,6 +20,16 @@ import { export type ListExecutionsCommandInput = ListExecutionsInput; export type ListExecutionsCommandOutput = ListExecutionsOutput & __MetadataBearer; +/** + *

Lists the executions of a state machine that meet the filtering criteria. Results are + * sorted by time, with the most recent execution first.

+ *

If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. + * Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ *

This API action is not supported by EXPRESS state machines.

+ */ export class ListExecutionsCommand extends $Command< ListExecutionsCommandInput, ListExecutionsCommandOutput, @@ -34,6 +44,9 @@ export class ListExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/ListStateMachinesCommand.ts b/clients/client-sfn/commands/ListStateMachinesCommand.ts index 71e76a6743ccf..2d3c4978c5748 100644 --- a/clients/client-sfn/commands/ListStateMachinesCommand.ts +++ b/clients/client-sfn/commands/ListStateMachinesCommand.ts @@ -20,6 +20,14 @@ import { export type ListStateMachinesCommandInput = ListStateMachinesInput; export type ListStateMachinesCommandOutput = ListStateMachinesOutput & __MetadataBearer; +/** + *

Lists the existing state machines.

+ *

If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. + * Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.

+ * + *

This operation is eventually consistent. The results are best effort and may not reflect very recent updates and changes.

+ *
+ */ export class ListStateMachinesCommand extends $Command< ListStateMachinesCommandInput, ListStateMachinesCommandOutput, @@ -34,6 +42,9 @@ export class ListStateMachinesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/ListTagsForResourceCommand.ts b/clients/client-sfn/commands/ListTagsForResourceCommand.ts index 876806d99f367..3995ac7464473 100644 --- a/clients/client-sfn/commands/ListTagsForResourceCommand.ts +++ b/clients/client-sfn/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

List tags for a given resource.

+ *

Tags may only contain Unicode letters, digits, white space, or these symbols: _ . : / = + - @.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/SendTaskFailureCommand.ts b/clients/client-sfn/commands/SendTaskFailureCommand.ts index b1dae61c24dc1..e6c515293c2ec 100644 --- a/clients/client-sfn/commands/SendTaskFailureCommand.ts +++ b/clients/client-sfn/commands/SendTaskFailureCommand.ts @@ -20,6 +20,10 @@ import { export type SendTaskFailureCommandInput = SendTaskFailureInput; export type SendTaskFailureCommandOutput = SendTaskFailureOutput & __MetadataBearer; +/** + *

Used by activity workers and task states using the callback + * pattern to report that the task identified by the taskToken failed.

+ */ export class SendTaskFailureCommand extends $Command< SendTaskFailureCommandInput, SendTaskFailureCommandOutput, @@ -34,6 +38,9 @@ export class SendTaskFailureCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/SendTaskHeartbeatCommand.ts b/clients/client-sfn/commands/SendTaskHeartbeatCommand.ts index 2f386903febd9..bfc9e291a8d6e 100644 --- a/clients/client-sfn/commands/SendTaskHeartbeatCommand.ts +++ b/clients/client-sfn/commands/SendTaskHeartbeatCommand.ts @@ -20,6 +20,23 @@ import { export type SendTaskHeartbeatCommandInput = SendTaskHeartbeatInput; export type SendTaskHeartbeatCommandOutput = SendTaskHeartbeatOutput & __MetadataBearer; +/** + *

Used by activity workers and task states using the callback + * pattern to report to Step Functions that the task represented by the specified + * taskToken is still making progress. This action resets the + * Heartbeat clock. The Heartbeat threshold is specified in the state + * machine's Amazon States Language definition (HeartbeatSeconds). This action does not in itself + * create an event in the execution history. However, if the task times out, the execution + * history contains an ActivityTimedOut entry for activities, or a + * TaskTimedOut entry for for tasks using the job run or + * callback + * pattern.

+ * + *

The Timeout of a task, defined in the state machine's Amazon States Language definition, is + * its maximum allowed duration, regardless of the number of SendTaskHeartbeat requests received. Use HeartbeatSeconds to configure the timeout interval + * for heartbeats.

+ *
+ */ export class SendTaskHeartbeatCommand extends $Command< SendTaskHeartbeatCommandInput, SendTaskHeartbeatCommandOutput, @@ -34,6 +51,9 @@ export class SendTaskHeartbeatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/SendTaskSuccessCommand.ts b/clients/client-sfn/commands/SendTaskSuccessCommand.ts index ab7acb9e00399..7aced15c7eb9b 100644 --- a/clients/client-sfn/commands/SendTaskSuccessCommand.ts +++ b/clients/client-sfn/commands/SendTaskSuccessCommand.ts @@ -20,6 +20,11 @@ import { export type SendTaskSuccessCommandInput = SendTaskSuccessInput; export type SendTaskSuccessCommandOutput = SendTaskSuccessOutput & __MetadataBearer; +/** + *

Used by activity workers and task states using the callback + * pattern to report that the task identified by the taskToken completed + * successfully.

+ */ export class SendTaskSuccessCommand extends $Command< SendTaskSuccessCommandInput, SendTaskSuccessCommandOutput, @@ -34,6 +39,9 @@ export class SendTaskSuccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/StartExecutionCommand.ts b/clients/client-sfn/commands/StartExecutionCommand.ts index fd8ed0725e083..ecb4bf01fe556 100644 --- a/clients/client-sfn/commands/StartExecutionCommand.ts +++ b/clients/client-sfn/commands/StartExecutionCommand.ts @@ -20,6 +20,17 @@ import { export type StartExecutionCommandInput = StartExecutionInput; export type StartExecutionCommandOutput = StartExecutionOutput & __MetadataBearer; +/** + *

Starts a state machine execution.

+ * + *

+ * StartExecution is idempotent. If StartExecution is called with + * the same name and input as a running execution, the call will succeed and return the same + * response as the original request. If the execution is closed or if the input is different, + * it will return a 400 ExecutionAlreadyExists error. Names can be reused after 90 + * days.

+ *
+ */ export class StartExecutionCommand extends $Command< StartExecutionCommandInput, StartExecutionCommandOutput, @@ -34,6 +45,9 @@ export class StartExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/StopExecutionCommand.ts b/clients/client-sfn/commands/StopExecutionCommand.ts index edda4126d809c..ca19ca234d030 100644 --- a/clients/client-sfn/commands/StopExecutionCommand.ts +++ b/clients/client-sfn/commands/StopExecutionCommand.ts @@ -20,6 +20,10 @@ import { export type StopExecutionCommandInput = StopExecutionInput; export type StopExecutionCommandOutput = StopExecutionOutput & __MetadataBearer; +/** + *

Stops an execution.

+ *

This API action is not supported by EXPRESS state machines.

+ */ export class StopExecutionCommand extends $Command< StopExecutionCommandInput, StopExecutionCommandOutput, @@ -34,6 +38,9 @@ export class StopExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/TagResourceCommand.ts b/clients/client-sfn/commands/TagResourceCommand.ts index c18c860f0e80c..d9409af1cc6e2 100644 --- a/clients/client-sfn/commands/TagResourceCommand.ts +++ b/clients/client-sfn/commands/TagResourceCommand.ts @@ -20,6 +20,14 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = TagResourceOutput & __MetadataBearer; +/** + *

Add a tag to a Step Functions resource.

+ *

An array of key-value pairs. For more information, see Using + * Cost Allocation Tags in the AWS Billing and Cost Management User + * Guide, and Controlling Access Using IAM + * Tags.

+ *

Tags may only contain Unicode letters, digits, white space, or these symbols: _ . : / = + - @.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +42,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/UntagResourceCommand.ts b/clients/client-sfn/commands/UntagResourceCommand.ts index 8e13c6a30dd4c..04f1083378fc5 100644 --- a/clients/client-sfn/commands/UntagResourceCommand.ts +++ b/clients/client-sfn/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = UntagResourceOutput & __MetadataBearer; +/** + *

Remove a tag from a Step Functions resource

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/commands/UpdateStateMachineCommand.ts b/clients/client-sfn/commands/UpdateStateMachineCommand.ts index 609057a587c18..3bae9271ad328 100644 --- a/clients/client-sfn/commands/UpdateStateMachineCommand.ts +++ b/clients/client-sfn/commands/UpdateStateMachineCommand.ts @@ -20,6 +20,19 @@ import { export type UpdateStateMachineCommandInput = UpdateStateMachineInput; export type UpdateStateMachineCommandOutput = UpdateStateMachineOutput & __MetadataBearer; +/** + *

Updates an existing state machine by modifying its definition, + * roleArn, or loggingConfiguration. Running executions will continue + * to use the previous definition and roleArn. You must include at + * least one of definition or roleArn or you will receive a + * MissingRequiredParameter error.

+ * + *

All StartExecution calls within a few seconds will use the updated + * definition and roleArn. Executions started immediately after + * calling UpdateStateMachine may use the previous state machine + * definition and roleArn.

+ *
+ */ export class UpdateStateMachineCommand extends $Command< UpdateStateMachineCommandInput, UpdateStateMachineCommandOutput, @@ -34,6 +47,9 @@ export class UpdateStateMachineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SFNClientResolvedConfig, diff --git a/clients/client-sfn/package.json b/clients/client-sfn/package.json index 58e9ab616cd45..c2f629326676d 100644 --- a/clients/client-sfn/package.json +++ b/clients/client-sfn/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sfn Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sfn/pagination/GetExecutionHistoryPaginator.ts b/clients/client-sfn/pagination/GetExecutionHistoryPaginator.ts index 4bb8205e7df03..885be0f274469 100644 --- a/clients/client-sfn/pagination/GetExecutionHistoryPaginator.ts +++ b/clients/client-sfn/pagination/GetExecutionHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { SFNPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SFNClient, input: GetExecutionHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetExecutionHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SFN, input: GetExecutionHistoryCommandInput, diff --git a/clients/client-sfn/pagination/ListActivitiesPaginator.ts b/clients/client-sfn/pagination/ListActivitiesPaginator.ts index 60ae1ad794510..962b166ac6fe0 100644 --- a/clients/client-sfn/pagination/ListActivitiesPaginator.ts +++ b/clients/client-sfn/pagination/ListActivitiesPaginator.ts @@ -8,6 +8,9 @@ import { import { SFNPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SFNClient, input: ListActivitiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListActivitiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SFN, input: ListActivitiesCommandInput, diff --git a/clients/client-sfn/pagination/ListExecutionsPaginator.ts b/clients/client-sfn/pagination/ListExecutionsPaginator.ts index 4654ae75835a1..4177f52401e18 100644 --- a/clients/client-sfn/pagination/ListExecutionsPaginator.ts +++ b/clients/client-sfn/pagination/ListExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SFNPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SFNClient, input: ListExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SFN, input: ListExecutionsCommandInput, diff --git a/clients/client-sfn/pagination/ListStateMachinesPaginator.ts b/clients/client-sfn/pagination/ListStateMachinesPaginator.ts index f1834877ce3a8..3685b9d1609ba 100644 --- a/clients/client-sfn/pagination/ListStateMachinesPaginator.ts +++ b/clients/client-sfn/pagination/ListStateMachinesPaginator.ts @@ -8,6 +8,9 @@ import { import { SFNPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SFNClient, input: ListStateMachinesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListStateMachinesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SFN, input: ListStateMachinesCommandInput, diff --git a/clients/client-sfn/runtimeConfig.browser.ts b/clients/client-sfn/runtimeConfig.browser.ts index e08dfe0c7482e..674fad8b015c9 100644 --- a/clients/client-sfn/runtimeConfig.browser.ts +++ b/clients/client-sfn/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SFNClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sfn/runtimeConfig.native.ts b/clients/client-sfn/runtimeConfig.native.ts index 50e5bab714ea3..a7b55e5cb611b 100644 --- a/clients/client-sfn/runtimeConfig.native.ts +++ b/clients/client-sfn/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SFNClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sfn/runtimeConfig.shared.ts b/clients/client-sfn/runtimeConfig.shared.ts index 596b05810bdb6..f4047c3686418 100644 --- a/clients/client-sfn/runtimeConfig.shared.ts +++ b/clients/client-sfn/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-11-23", disableHostPrefix: false, diff --git a/clients/client-sfn/runtimeConfig.ts b/clients/client-sfn/runtimeConfig.ts index 228c81113c460..afb547724557d 100644 --- a/clients/client-sfn/runtimeConfig.ts +++ b/clients/client-sfn/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SFNClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sfn/tsconfig.json b/clients/client-sfn/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sfn/tsconfig.json +++ b/clients/client-sfn/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-shield/commands/AssociateDRTLogBucketCommand.ts b/clients/client-shield/commands/AssociateDRTLogBucketCommand.ts index 48c453233278e..47deed617d862 100644 --- a/clients/client-shield/commands/AssociateDRTLogBucketCommand.ts +++ b/clients/client-shield/commands/AssociateDRTLogBucketCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateDRTLogBucketCommandInput = AssociateDRTLogBucketRequest; export type AssociateDRTLogBucketCommandOutput = AssociateDRTLogBucketResponse & __MetadataBearer; +/** + *

Authorizes the DDoS Response Team (DRT) to access the specified Amazon S3 bucket containing your AWS WAF logs. You can associate up to 10 Amazon S3 buckets with your subscription.

+ *

To use the services of the DRT and make an AssociateDRTLogBucket request, you must be subscribed to the Business Support plan or the Enterprise Support plan.

+ */ export class AssociateDRTLogBucketCommand extends $Command< AssociateDRTLogBucketCommandInput, AssociateDRTLogBucketCommandOutput, @@ -34,6 +38,9 @@ export class AssociateDRTLogBucketCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/AssociateDRTRoleCommand.ts b/clients/client-shield/commands/AssociateDRTRoleCommand.ts index ec21bef9b9b17..d539372742e54 100644 --- a/clients/client-shield/commands/AssociateDRTRoleCommand.ts +++ b/clients/client-shield/commands/AssociateDRTRoleCommand.ts @@ -20,6 +20,15 @@ import { export type AssociateDRTRoleCommandInput = AssociateDRTRoleRequest; export type AssociateDRTRoleCommandOutput = AssociateDRTRoleResponse & __MetadataBearer; +/** + *

Authorizes the DDoS Response Team (DRT), using the specified role, to access your AWS account to assist with DDoS attack mitigation during potential attacks. This enables the DRT to inspect your AWS WAF configuration and create or update AWS WAF rules and web ACLs.

+ *

You can associate only one RoleArn with your subscription. If you submit an AssociateDRTRole request for an account that already has an associated role, the new RoleArn will replace the existing RoleArn.

+ *

Prior to making the AssociateDRTRole request, you must attach the AWSShieldDRTAccessPolicy managed policy to the role you will specify in the request. For more information see Attaching and Detaching IAM Policies. The role must also trust the service principal drt.shield.amazonaws.com. For more information, see IAM JSON Policy Elements: Principal.

+ * + *

The DRT will have access only to your AWS WAF and Shield resources. By submitting this request, you authorize the DRT to inspect your AWS WAF and Shield configuration and create and update AWS WAF rules and web ACLs on your behalf. The DRT takes these actions only if explicitly authorized by you.

+ *

You must have the iam:PassRole permission to make an AssociateDRTRole request. For more information, see Granting a User Permissions to Pass a Role to an AWS Service.

+ *

To use the services of the DRT and make an AssociateDRTRole request, you must be subscribed to the Business Support plan or the Enterprise Support plan.

+ */ export class AssociateDRTRoleCommand extends $Command< AssociateDRTRoleCommandInput, AssociateDRTRoleCommandOutput, @@ -34,6 +43,9 @@ export class AssociateDRTRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/AssociateHealthCheckCommand.ts b/clients/client-shield/commands/AssociateHealthCheckCommand.ts index 3eedcfedf52b4..9e1ddb0d4c1f1 100644 --- a/clients/client-shield/commands/AssociateHealthCheckCommand.ts +++ b/clients/client-shield/commands/AssociateHealthCheckCommand.ts @@ -20,6 +20,10 @@ import { export type AssociateHealthCheckCommandInput = AssociateHealthCheckRequest; export type AssociateHealthCheckCommandOutput = AssociateHealthCheckResponse & __MetadataBearer; +/** + *

Adds health-based detection to the Shield Advanced protection for a resource. Shield Advanced health-based detection uses the health of your AWS resource to improve responsiveness and accuracy in attack detection and mitigation.

+ *

You define the health check in Route 53 and then associate it with your Shield Advanced protection. For more information, see Shield Advanced Health-Based Detection in the AWS WAF and AWS Shield Developer Guide.

+ */ export class AssociateHealthCheckCommand extends $Command< AssociateHealthCheckCommandInput, AssociateHealthCheckCommandOutput, @@ -34,6 +38,9 @@ export class AssociateHealthCheckCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/AssociateProactiveEngagementDetailsCommand.ts b/clients/client-shield/commands/AssociateProactiveEngagementDetailsCommand.ts index b7b0c555e1855..d40e8435b7469 100644 --- a/clients/client-shield/commands/AssociateProactiveEngagementDetailsCommand.ts +++ b/clients/client-shield/commands/AssociateProactiveEngagementDetailsCommand.ts @@ -24,6 +24,14 @@ export type AssociateProactiveEngagementDetailsCommandInput = AssociateProactive export type AssociateProactiveEngagementDetailsCommandOutput = AssociateProactiveEngagementDetailsResponse & __MetadataBearer; +/** + *

Initializes proactive engagement and sets the list of contacts for the DDoS Response Team (DRT) to use. You must provide at least one phone number in the emergency contact list.

+ *

After you have initialized proactive engagement using this call, to disable or enable proactive engagement, use the calls DisableProactiveEngagement and EnableProactiveEngagement.

+ * + *

This call defines the list of email addresses and phone numbers that the DDoS Response Team (DRT) can use to contact you for escalations to the DRT and to initiate proactive customer support.

+ *

The contacts that you provide in the request replace any contacts that were already defined. If you already have contacts defined and want to use them, retrieve the list using DescribeEmergencyContactSettings and then provide it to this call.

+ *
+ */ export class AssociateProactiveEngagementDetailsCommand extends $Command< AssociateProactiveEngagementDetailsCommandInput, AssociateProactiveEngagementDetailsCommandOutput, @@ -38,6 +46,9 @@ export class AssociateProactiveEngagementDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/CreateProtectionCommand.ts b/clients/client-shield/commands/CreateProtectionCommand.ts index d6cd6825ab82d..c282e42355246 100644 --- a/clients/client-shield/commands/CreateProtectionCommand.ts +++ b/clients/client-shield/commands/CreateProtectionCommand.ts @@ -20,6 +20,11 @@ import { export type CreateProtectionCommandInput = CreateProtectionRequest; export type CreateProtectionCommandOutput = CreateProtectionResponse & __MetadataBearer; +/** + *

Enables AWS Shield Advanced for a specific AWS resource. The resource can be an Amazon + * CloudFront distribution, Elastic Load Balancing load balancer, AWS Global Accelerator accelerator, Elastic IP Address, or an Amazon Route 53 hosted zone.

+ *

You can add protection to only a single resource with each CreateProtection request. If you want to add protection to multiple resources at once, use the AWS WAF console. For more information see Getting Started with AWS Shield Advanced and Add AWS Shield Advanced Protection to more AWS Resources.

+ */ export class CreateProtectionCommand extends $Command< CreateProtectionCommandInput, CreateProtectionCommandOutput, @@ -34,6 +39,9 @@ export class CreateProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/CreateProtectionGroupCommand.ts b/clients/client-shield/commands/CreateProtectionGroupCommand.ts index 8cbb807c59107..e2da85c577d68 100644 --- a/clients/client-shield/commands/CreateProtectionGroupCommand.ts +++ b/clients/client-shield/commands/CreateProtectionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateProtectionGroupCommandInput = CreateProtectionGroupRequest; export type CreateProtectionGroupCommandOutput = CreateProtectionGroupResponse & __MetadataBearer; +/** + *

Creates a grouping of protected resources so they can be handled as a collective. This resource grouping improves the accuracy of detection and reduces false positives.

+ */ export class CreateProtectionGroupCommand extends $Command< CreateProtectionGroupCommandInput, CreateProtectionGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateProtectionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/CreateSubscriptionCommand.ts b/clients/client-shield/commands/CreateSubscriptionCommand.ts index 96dfe121a2ea3..eda33b0e8c309 100644 --- a/clients/client-shield/commands/CreateSubscriptionCommand.ts +++ b/clients/client-shield/commands/CreateSubscriptionCommand.ts @@ -20,6 +20,11 @@ import { export type CreateSubscriptionCommandInput = CreateSubscriptionRequest; export type CreateSubscriptionCommandOutput = CreateSubscriptionResponse & __MetadataBearer; +/** + *

Activates AWS Shield Advanced for an account.

+ * + *

When you initally create a subscription, your subscription is set to be automatically renewed at the end of the existing subscription period. You can change this by submitting an UpdateSubscription request.

+ */ export class CreateSubscriptionCommand extends $Command< CreateSubscriptionCommandInput, CreateSubscriptionCommandOutput, @@ -34,6 +39,9 @@ export class CreateSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DeleteProtectionCommand.ts b/clients/client-shield/commands/DeleteProtectionCommand.ts index 86e5e64ca732a..5d84f7f6484b7 100644 --- a/clients/client-shield/commands/DeleteProtectionCommand.ts +++ b/clients/client-shield/commands/DeleteProtectionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProtectionCommandInput = DeleteProtectionRequest; export type DeleteProtectionCommandOutput = DeleteProtectionResponse & __MetadataBearer; +/** + *

Deletes an AWS Shield Advanced Protection.

+ */ export class DeleteProtectionCommand extends $Command< DeleteProtectionCommandInput, DeleteProtectionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DeleteProtectionGroupCommand.ts b/clients/client-shield/commands/DeleteProtectionGroupCommand.ts index e69a022d8ab73..adf31f4937ba4 100644 --- a/clients/client-shield/commands/DeleteProtectionGroupCommand.ts +++ b/clients/client-shield/commands/DeleteProtectionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteProtectionGroupCommandInput = DeleteProtectionGroupRequest; export type DeleteProtectionGroupCommandOutput = DeleteProtectionGroupResponse & __MetadataBearer; +/** + *

Removes the specified protection group.

+ */ export class DeleteProtectionGroupCommand extends $Command< DeleteProtectionGroupCommandInput, DeleteProtectionGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteProtectionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DeleteSubscriptionCommand.ts b/clients/client-shield/commands/DeleteSubscriptionCommand.ts index 1623969ad03cf..0ccc55e4d8bb7 100644 --- a/clients/client-shield/commands/DeleteSubscriptionCommand.ts +++ b/clients/client-shield/commands/DeleteSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSubscriptionCommandInput = DeleteSubscriptionRequest; export type DeleteSubscriptionCommandOutput = DeleteSubscriptionResponse & __MetadataBearer; +/** + *

Removes AWS Shield Advanced from an account. AWS Shield Advanced requires a 1-year subscription commitment. You cannot delete a subscription prior to the completion of that commitment.

+ */ export class DeleteSubscriptionCommand extends $Command< DeleteSubscriptionCommandInput, DeleteSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DescribeAttackCommand.ts b/clients/client-shield/commands/DescribeAttackCommand.ts index 350bcf300d125..2424ab0b10376 100644 --- a/clients/client-shield/commands/DescribeAttackCommand.ts +++ b/clients/client-shield/commands/DescribeAttackCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAttackCommandInput = DescribeAttackRequest; export type DescribeAttackCommandOutput = DescribeAttackResponse & __MetadataBearer; +/** + *

Describes the details of a DDoS attack.

+ */ export class DescribeAttackCommand extends $Command< DescribeAttackCommandInput, DescribeAttackCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAttackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DescribeAttackStatisticsCommand.ts b/clients/client-shield/commands/DescribeAttackStatisticsCommand.ts index b2161ca3c3b98..7ae7dd2ccb315 100644 --- a/clients/client-shield/commands/DescribeAttackStatisticsCommand.ts +++ b/clients/client-shield/commands/DescribeAttackStatisticsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAttackStatisticsCommandInput = DescribeAttackStatisticsRequest; export type DescribeAttackStatisticsCommandOutput = DescribeAttackStatisticsResponse & __MetadataBearer; +/** + *

Provides information about the number and type of attacks AWS Shield has detected in the last year for all resources that belong to your account, regardless of whether you've defined Shield protections for them. This operation is available to Shield customers as well as to Shield Advanced customers.

+ *

The operation returns data for the time range of midnight UTC, one year ago, to midnight UTC, today. For example, if the current time is 2020-10-26 15:39:32 PDT, equal to 2020-10-26 22:39:32 UTC, then the time range for the attack data returned is from 2019-10-26 00:00:00 UTC to 2020-10-26 00:00:00 UTC.

+ *

The time range indicates the period covered by the attack statistics data items.

+ */ export class DescribeAttackStatisticsCommand extends $Command< DescribeAttackStatisticsCommandInput, DescribeAttackStatisticsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAttackStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DescribeDRTAccessCommand.ts b/clients/client-shield/commands/DescribeDRTAccessCommand.ts index 2b2108a7f07d3..fa83f5c0435f9 100644 --- a/clients/client-shield/commands/DescribeDRTAccessCommand.ts +++ b/clients/client-shield/commands/DescribeDRTAccessCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDRTAccessCommandInput = DescribeDRTAccessRequest; export type DescribeDRTAccessCommandOutput = DescribeDRTAccessResponse & __MetadataBearer; +/** + *

Returns the current role and list of Amazon S3 log buckets used by the DDoS Response Team (DRT) to access your AWS account while assisting with attack mitigation.

+ */ export class DescribeDRTAccessCommand extends $Command< DescribeDRTAccessCommandInput, DescribeDRTAccessCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDRTAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DescribeEmergencyContactSettingsCommand.ts b/clients/client-shield/commands/DescribeEmergencyContactSettingsCommand.ts index f2634c757d884..49b32b6ecadc1 100644 --- a/clients/client-shield/commands/DescribeEmergencyContactSettingsCommand.ts +++ b/clients/client-shield/commands/DescribeEmergencyContactSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeEmergencyContactSettingsCommandInput = DescribeEmergencyContactSettingsRequest; export type DescribeEmergencyContactSettingsCommandOutput = DescribeEmergencyContactSettingsResponse & __MetadataBearer; +/** + *

A list of email addresses and phone numbers that the DDoS Response Team (DRT) can use to contact you if you have proactive engagement enabled, for escalations to the DRT and to initiate proactive customer support.

+ */ export class DescribeEmergencyContactSettingsCommand extends $Command< DescribeEmergencyContactSettingsCommandInput, DescribeEmergencyContactSettingsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeEmergencyContactSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DescribeProtectionCommand.ts b/clients/client-shield/commands/DescribeProtectionCommand.ts index 62c6ce03ba47c..bb77d09b197f6 100644 --- a/clients/client-shield/commands/DescribeProtectionCommand.ts +++ b/clients/client-shield/commands/DescribeProtectionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProtectionCommandInput = DescribeProtectionRequest; export type DescribeProtectionCommandOutput = DescribeProtectionResponse & __MetadataBearer; +/** + *

Lists the details of a Protection object.

+ */ export class DescribeProtectionCommand extends $Command< DescribeProtectionCommandInput, DescribeProtectionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProtectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DescribeProtectionGroupCommand.ts b/clients/client-shield/commands/DescribeProtectionGroupCommand.ts index 509b5b3202e6e..634a456b4fe33 100644 --- a/clients/client-shield/commands/DescribeProtectionGroupCommand.ts +++ b/clients/client-shield/commands/DescribeProtectionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeProtectionGroupCommandInput = DescribeProtectionGroupRequest; export type DescribeProtectionGroupCommandOutput = DescribeProtectionGroupResponse & __MetadataBearer; +/** + *

Returns the specification for the specified protection group.

+ */ export class DescribeProtectionGroupCommand extends $Command< DescribeProtectionGroupCommandInput, DescribeProtectionGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeProtectionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DescribeSubscriptionCommand.ts b/clients/client-shield/commands/DescribeSubscriptionCommand.ts index 48f75ebd7587f..7737acf9f6d6d 100644 --- a/clients/client-shield/commands/DescribeSubscriptionCommand.ts +++ b/clients/client-shield/commands/DescribeSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeSubscriptionCommandInput = DescribeSubscriptionRequest; export type DescribeSubscriptionCommandOutput = DescribeSubscriptionResponse & __MetadataBearer; +/** + *

Provides details about the AWS Shield Advanced subscription for an account.

+ */ export class DescribeSubscriptionCommand extends $Command< DescribeSubscriptionCommandInput, DescribeSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DescribeSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DisableProactiveEngagementCommand.ts b/clients/client-shield/commands/DisableProactiveEngagementCommand.ts index 21c73ee866a30..954f47efbfe06 100644 --- a/clients/client-shield/commands/DisableProactiveEngagementCommand.ts +++ b/clients/client-shield/commands/DisableProactiveEngagementCommand.ts @@ -20,6 +20,9 @@ import { export type DisableProactiveEngagementCommandInput = DisableProactiveEngagementRequest; export type DisableProactiveEngagementCommandOutput = DisableProactiveEngagementResponse & __MetadataBearer; +/** + *

Removes authorization from the DDoS Response Team (DRT) to notify contacts about escalations to the DRT and to initiate proactive customer support.

+ */ export class DisableProactiveEngagementCommand extends $Command< DisableProactiveEngagementCommandInput, DisableProactiveEngagementCommandOutput, @@ -34,6 +37,9 @@ export class DisableProactiveEngagementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DisassociateDRTLogBucketCommand.ts b/clients/client-shield/commands/DisassociateDRTLogBucketCommand.ts index de2050d383dd4..883dfe11c77ee 100644 --- a/clients/client-shield/commands/DisassociateDRTLogBucketCommand.ts +++ b/clients/client-shield/commands/DisassociateDRTLogBucketCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateDRTLogBucketCommandInput = DisassociateDRTLogBucketRequest; export type DisassociateDRTLogBucketCommandOutput = DisassociateDRTLogBucketResponse & __MetadataBearer; +/** + *

Removes the DDoS Response Team's (DRT) access to the specified Amazon S3 bucket containing your AWS WAF logs.

+ *

To make a DisassociateDRTLogBucket request, you must be subscribed to the Business Support plan or the Enterprise Support plan. However, if you are not subscribed to one of these support plans, but had been previously and had granted the DRT access to your account, you can submit a DisassociateDRTLogBucket request to remove this access.

+ */ export class DisassociateDRTLogBucketCommand extends $Command< DisassociateDRTLogBucketCommandInput, DisassociateDRTLogBucketCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateDRTLogBucketCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DisassociateDRTRoleCommand.ts b/clients/client-shield/commands/DisassociateDRTRoleCommand.ts index 1d2b5347fc356..b3c776e356654 100644 --- a/clients/client-shield/commands/DisassociateDRTRoleCommand.ts +++ b/clients/client-shield/commands/DisassociateDRTRoleCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateDRTRoleCommandInput = DisassociateDRTRoleRequest; export type DisassociateDRTRoleCommandOutput = DisassociateDRTRoleResponse & __MetadataBearer; +/** + *

Removes the DDoS Response Team's (DRT) access to your AWS account.

+ *

To make a DisassociateDRTRole request, you must be subscribed to the Business Support plan or the Enterprise Support plan. However, if you are not subscribed to one of these support plans, but had been previously and had granted the DRT access to your account, you can submit a DisassociateDRTRole request to remove this access.

+ */ export class DisassociateDRTRoleCommand extends $Command< DisassociateDRTRoleCommandInput, DisassociateDRTRoleCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateDRTRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/DisassociateHealthCheckCommand.ts b/clients/client-shield/commands/DisassociateHealthCheckCommand.ts index bcd09ad0677d0..3bf6aa06542e3 100644 --- a/clients/client-shield/commands/DisassociateHealthCheckCommand.ts +++ b/clients/client-shield/commands/DisassociateHealthCheckCommand.ts @@ -20,6 +20,10 @@ import { export type DisassociateHealthCheckCommandInput = DisassociateHealthCheckRequest; export type DisassociateHealthCheckCommandOutput = DisassociateHealthCheckResponse & __MetadataBearer; +/** + *

Removes health-based detection from the Shield Advanced protection for a resource. Shield Advanced health-based detection uses the health of your AWS resource to improve responsiveness and accuracy in attack detection and mitigation.

+ *

You define the health check in Route 53 and then associate or disassociate it with your Shield Advanced protection. For more information, see Shield Advanced Health-Based Detection in the AWS WAF and AWS Shield Developer Guide.

+ */ export class DisassociateHealthCheckCommand extends $Command< DisassociateHealthCheckCommandInput, DisassociateHealthCheckCommandOutput, @@ -34,6 +38,9 @@ export class DisassociateHealthCheckCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/EnableProactiveEngagementCommand.ts b/clients/client-shield/commands/EnableProactiveEngagementCommand.ts index cbd31a2ebdb0e..18f126f367b73 100644 --- a/clients/client-shield/commands/EnableProactiveEngagementCommand.ts +++ b/clients/client-shield/commands/EnableProactiveEngagementCommand.ts @@ -20,6 +20,9 @@ import { export type EnableProactiveEngagementCommandInput = EnableProactiveEngagementRequest; export type EnableProactiveEngagementCommandOutput = EnableProactiveEngagementResponse & __MetadataBearer; +/** + *

Authorizes the DDoS Response Team (DRT) to use email and phone to notify contacts about escalations to the DRT and to initiate proactive customer support.

+ */ export class EnableProactiveEngagementCommand extends $Command< EnableProactiveEngagementCommandInput, EnableProactiveEngagementCommandOutput, @@ -34,6 +37,9 @@ export class EnableProactiveEngagementCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/GetSubscriptionStateCommand.ts b/clients/client-shield/commands/GetSubscriptionStateCommand.ts index bda19506612a9..90e417e3bdf03 100644 --- a/clients/client-shield/commands/GetSubscriptionStateCommand.ts +++ b/clients/client-shield/commands/GetSubscriptionStateCommand.ts @@ -20,6 +20,9 @@ import { export type GetSubscriptionStateCommandInput = GetSubscriptionStateRequest; export type GetSubscriptionStateCommandOutput = GetSubscriptionStateResponse & __MetadataBearer; +/** + *

Returns the SubscriptionState, either Active or Inactive.

+ */ export class GetSubscriptionStateCommand extends $Command< GetSubscriptionStateCommandInput, GetSubscriptionStateCommandOutput, @@ -34,6 +37,9 @@ export class GetSubscriptionStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/ListAttacksCommand.ts b/clients/client-shield/commands/ListAttacksCommand.ts index 1c05c95a03658..d5b4e48dd5854 100644 --- a/clients/client-shield/commands/ListAttacksCommand.ts +++ b/clients/client-shield/commands/ListAttacksCommand.ts @@ -20,6 +20,10 @@ import { export type ListAttacksCommandInput = ListAttacksRequest; export type ListAttacksCommandOutput = ListAttacksResponse & __MetadataBearer; +/** + *

Returns all ongoing DDoS attacks or all DDoS attacks during a specified time + * period.

+ */ export class ListAttacksCommand extends $Command< ListAttacksCommandInput, ListAttacksCommandOutput, @@ -34,6 +38,9 @@ export class ListAttacksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/ListProtectionGroupsCommand.ts b/clients/client-shield/commands/ListProtectionGroupsCommand.ts index a09ff05176786..4f5a7d17336f9 100644 --- a/clients/client-shield/commands/ListProtectionGroupsCommand.ts +++ b/clients/client-shield/commands/ListProtectionGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProtectionGroupsCommandInput = ListProtectionGroupsRequest; export type ListProtectionGroupsCommandOutput = ListProtectionGroupsResponse & __MetadataBearer; +/** + *

Retrieves the ProtectionGroup objects for the account.

+ */ export class ListProtectionGroupsCommand extends $Command< ListProtectionGroupsCommandInput, ListProtectionGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListProtectionGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/ListProtectionsCommand.ts b/clients/client-shield/commands/ListProtectionsCommand.ts index 6e425b6edc470..28ef5de665a0e 100644 --- a/clients/client-shield/commands/ListProtectionsCommand.ts +++ b/clients/client-shield/commands/ListProtectionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListProtectionsCommandInput = ListProtectionsRequest; export type ListProtectionsCommandOutput = ListProtectionsResponse & __MetadataBearer; +/** + *

Lists all Protection objects for the account.

+ */ export class ListProtectionsCommand extends $Command< ListProtectionsCommandInput, ListProtectionsCommandOutput, @@ -34,6 +37,9 @@ export class ListProtectionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/ListResourcesInProtectionGroupCommand.ts b/clients/client-shield/commands/ListResourcesInProtectionGroupCommand.ts index 422aeaf522e5d..668b0cc970947 100644 --- a/clients/client-shield/commands/ListResourcesInProtectionGroupCommand.ts +++ b/clients/client-shield/commands/ListResourcesInProtectionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourcesInProtectionGroupCommandInput = ListResourcesInProtectionGroupRequest; export type ListResourcesInProtectionGroupCommandOutput = ListResourcesInProtectionGroupResponse & __MetadataBearer; +/** + *

Retrieves the resources that are included in the protection group.

+ */ export class ListResourcesInProtectionGroupCommand extends $Command< ListResourcesInProtectionGroupCommandInput, ListResourcesInProtectionGroupCommandOutput, @@ -34,6 +37,9 @@ export class ListResourcesInProtectionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/UpdateEmergencyContactSettingsCommand.ts b/clients/client-shield/commands/UpdateEmergencyContactSettingsCommand.ts index 3635a060e4b82..dea281592edab 100644 --- a/clients/client-shield/commands/UpdateEmergencyContactSettingsCommand.ts +++ b/clients/client-shield/commands/UpdateEmergencyContactSettingsCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateEmergencyContactSettingsCommandInput = UpdateEmergencyContactSettingsRequest; export type UpdateEmergencyContactSettingsCommandOutput = UpdateEmergencyContactSettingsResponse & __MetadataBearer; +/** + *

Updates the details of the list of email addresses and phone numbers that the DDoS Response Team (DRT) can use to contact you if you have proactive engagement enabled, for escalations to the DRT and to initiate proactive customer support.

+ */ export class UpdateEmergencyContactSettingsCommand extends $Command< UpdateEmergencyContactSettingsCommandInput, UpdateEmergencyContactSettingsCommandOutput, @@ -34,6 +37,9 @@ export class UpdateEmergencyContactSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/UpdateProtectionGroupCommand.ts b/clients/client-shield/commands/UpdateProtectionGroupCommand.ts index 5f62e18ac781f..6b3e881cea618 100644 --- a/clients/client-shield/commands/UpdateProtectionGroupCommand.ts +++ b/clients/client-shield/commands/UpdateProtectionGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateProtectionGroupCommandInput = UpdateProtectionGroupRequest; export type UpdateProtectionGroupCommandOutput = UpdateProtectionGroupResponse & __MetadataBearer; +/** + *

Updates an existing protection group. A protection group is a grouping of protected resources so they can be handled as a collective. This resource grouping improves the accuracy of detection and reduces false positives.

+ */ export class UpdateProtectionGroupCommand extends $Command< UpdateProtectionGroupCommandInput, UpdateProtectionGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateProtectionGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/commands/UpdateSubscriptionCommand.ts b/clients/client-shield/commands/UpdateSubscriptionCommand.ts index ab3ef4ddd2dfc..554e4c0eae6e5 100644 --- a/clients/client-shield/commands/UpdateSubscriptionCommand.ts +++ b/clients/client-shield/commands/UpdateSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSubscriptionCommandInput = UpdateSubscriptionRequest; export type UpdateSubscriptionCommandOutput = UpdateSubscriptionResponse & __MetadataBearer; +/** + *

Updates the details of an existing subscription. Only enter values for parameters you want to change. Empty parameters are not updated.

+ */ export class UpdateSubscriptionCommand extends $Command< UpdateSubscriptionCommandInput, UpdateSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: ShieldClientResolvedConfig, diff --git a/clients/client-shield/package.json b/clients/client-shield/package.json index f8be239d292c8..864f1f6a0e2dc 100644 --- a/clients/client-shield/package.json +++ b/clients/client-shield/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Shield Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-shield/pagination/ListAttacksPaginator.ts b/clients/client-shield/pagination/ListAttacksPaginator.ts index ec5f02f078b99..e9fd7a0121cc9 100644 --- a/clients/client-shield/pagination/ListAttacksPaginator.ts +++ b/clients/client-shield/pagination/ListAttacksPaginator.ts @@ -4,6 +4,9 @@ import { ListAttacksCommand, ListAttacksCommandInput, ListAttacksCommandOutput } import { ShieldPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ShieldClient, input: ListAttacksCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAttacksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Shield, input: ListAttacksCommandInput, diff --git a/clients/client-shield/pagination/ListProtectionGroupsPaginator.ts b/clients/client-shield/pagination/ListProtectionGroupsPaginator.ts index b0250bb2c82b0..358247847cf70 100644 --- a/clients/client-shield/pagination/ListProtectionGroupsPaginator.ts +++ b/clients/client-shield/pagination/ListProtectionGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { ShieldPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ShieldClient, input: ListProtectionGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProtectionGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Shield, input: ListProtectionGroupsCommandInput, diff --git a/clients/client-shield/pagination/ListProtectionsPaginator.ts b/clients/client-shield/pagination/ListProtectionsPaginator.ts index 8502a5a69b9e0..98fb9e252a27d 100644 --- a/clients/client-shield/pagination/ListProtectionsPaginator.ts +++ b/clients/client-shield/pagination/ListProtectionsPaginator.ts @@ -8,6 +8,9 @@ import { import { ShieldPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ShieldClient, input: ListProtectionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListProtectionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Shield, input: ListProtectionsCommandInput, diff --git a/clients/client-shield/pagination/ListResourcesInProtectionGroupPaginator.ts b/clients/client-shield/pagination/ListResourcesInProtectionGroupPaginator.ts index ccc3467faa75c..82ede5ba0ac4e 100644 --- a/clients/client-shield/pagination/ListResourcesInProtectionGroupPaginator.ts +++ b/clients/client-shield/pagination/ListResourcesInProtectionGroupPaginator.ts @@ -8,6 +8,9 @@ import { import { ShieldPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: ShieldClient, input: ListResourcesInProtectionGroupCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourcesInProtectionGroupCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Shield, input: ListResourcesInProtectionGroupCommandInput, diff --git a/clients/client-shield/runtimeConfig.browser.ts b/clients/client-shield/runtimeConfig.browser.ts index 6982b57c40f90..066cd72b59f41 100644 --- a/clients/client-shield/runtimeConfig.browser.ts +++ b/clients/client-shield/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./ShieldClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-shield/runtimeConfig.native.ts b/clients/client-shield/runtimeConfig.native.ts index 17ced139c3964..8c9823e405af8 100644 --- a/clients/client-shield/runtimeConfig.native.ts +++ b/clients/client-shield/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./ShieldClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-shield/runtimeConfig.shared.ts b/clients/client-shield/runtimeConfig.shared.ts index da69b3aa95190..c7494141d67f6 100644 --- a/clients/client-shield/runtimeConfig.shared.ts +++ b/clients/client-shield/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-06-02", disableHostPrefix: false, diff --git a/clients/client-shield/runtimeConfig.ts b/clients/client-shield/runtimeConfig.ts index cc067dc23969d..947252f497821 100644 --- a/clients/client-shield/runtimeConfig.ts +++ b/clients/client-shield/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./ShieldClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-shield/tsconfig.json b/clients/client-shield/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-shield/tsconfig.json +++ b/clients/client-shield/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-signer/commands/CancelSigningProfileCommand.ts b/clients/client-signer/commands/CancelSigningProfileCommand.ts index cd0159865ccd6..edf24d8542fee 100644 --- a/clients/client-signer/commands/CancelSigningProfileCommand.ts +++ b/clients/client-signer/commands/CancelSigningProfileCommand.ts @@ -20,6 +20,12 @@ import { export type CancelSigningProfileCommandInput = CancelSigningProfileRequest; export type CancelSigningProfileCommandOutput = __MetadataBearer; +/** + *

Changes the state of an ACTIVE signing profile to CANCELED. + * A canceled profile is still viewable with the ListSigningProfiles + * operation, but it cannot perform new signing jobs, and is deleted two years after + * cancelation.

+ */ export class CancelSigningProfileCommand extends $Command< CancelSigningProfileCommandInput, CancelSigningProfileCommandOutput, @@ -34,6 +40,9 @@ export class CancelSigningProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/DescribeSigningJobCommand.ts b/clients/client-signer/commands/DescribeSigningJobCommand.ts index 1c497c280fac9..9546243a440e9 100644 --- a/clients/client-signer/commands/DescribeSigningJobCommand.ts +++ b/clients/client-signer/commands/DescribeSigningJobCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeSigningJobCommandInput = DescribeSigningJobRequest; export type DescribeSigningJobCommandOutput = DescribeSigningJobResponse & __MetadataBearer; +/** + *

Returns information about a specific code signing job. You specify the job by using + * the jobId value that is returned by the StartSigningJob + * operation.

+ */ export class DescribeSigningJobCommand extends $Command< DescribeSigningJobCommandInput, DescribeSigningJobCommandOutput, @@ -34,6 +39,9 @@ export class DescribeSigningJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/GetSigningPlatformCommand.ts b/clients/client-signer/commands/GetSigningPlatformCommand.ts index ee4dacf63c93e..d1a8313500e32 100644 --- a/clients/client-signer/commands/GetSigningPlatformCommand.ts +++ b/clients/client-signer/commands/GetSigningPlatformCommand.ts @@ -20,6 +20,9 @@ import { export type GetSigningPlatformCommandInput = GetSigningPlatformRequest; export type GetSigningPlatformCommandOutput = GetSigningPlatformResponse & __MetadataBearer; +/** + *

Returns information on a specific signing platform.

+ */ export class GetSigningPlatformCommand extends $Command< GetSigningPlatformCommandInput, GetSigningPlatformCommandOutput, @@ -34,6 +37,9 @@ export class GetSigningPlatformCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/GetSigningProfileCommand.ts b/clients/client-signer/commands/GetSigningProfileCommand.ts index 5f8932717c7b7..ce927304ae5ef 100644 --- a/clients/client-signer/commands/GetSigningProfileCommand.ts +++ b/clients/client-signer/commands/GetSigningProfileCommand.ts @@ -20,6 +20,9 @@ import { export type GetSigningProfileCommandInput = GetSigningProfileRequest; export type GetSigningProfileCommandOutput = GetSigningProfileResponse & __MetadataBearer; +/** + *

Returns information on a specific signing profile.

+ */ export class GetSigningProfileCommand extends $Command< GetSigningProfileCommandInput, GetSigningProfileCommandOutput, @@ -34,6 +37,9 @@ export class GetSigningProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/ListSigningJobsCommand.ts b/clients/client-signer/commands/ListSigningJobsCommand.ts index 102147844365b..2a99a0aee7726 100644 --- a/clients/client-signer/commands/ListSigningJobsCommand.ts +++ b/clients/client-signer/commands/ListSigningJobsCommand.ts @@ -20,6 +20,15 @@ import { export type ListSigningJobsCommandInput = ListSigningJobsRequest; export type ListSigningJobsCommandOutput = ListSigningJobsResponse & __MetadataBearer; +/** + *

Lists all your signing jobs. You can use the maxResults parameter to + * limit the number of signing jobs that are returned in the response. If additional jobs + * remain to be listed, code signing returns a nextToken value. Use this value in + * subsequent calls to ListSigningJobs to fetch the remaining values. You can + * continue calling ListSigningJobs with your maxResults + * parameter and with new values that code signing returns in the nextToken + * parameter until all of your signing jobs have been returned.

+ */ export class ListSigningJobsCommand extends $Command< ListSigningJobsCommandInput, ListSigningJobsCommandOutput, @@ -34,6 +43,9 @@ export class ListSigningJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/ListSigningPlatformsCommand.ts b/clients/client-signer/commands/ListSigningPlatformsCommand.ts index df2f743d9942c..4df92784e307b 100644 --- a/clients/client-signer/commands/ListSigningPlatformsCommand.ts +++ b/clients/client-signer/commands/ListSigningPlatformsCommand.ts @@ -20,6 +20,15 @@ import { export type ListSigningPlatformsCommandInput = ListSigningPlatformsRequest; export type ListSigningPlatformsCommandOutput = ListSigningPlatformsResponse & __MetadataBearer; +/** + *

Lists all signing platforms available in code signing that match the request parameters. If + * additional jobs remain to be listed, code signing returns a nextToken value. Use + * this value in subsequent calls to ListSigningJobs to fetch the remaining + * values. You can continue calling ListSigningJobs with your + * maxResults parameter and with new values that code signing returns in the + * nextToken parameter until all of your signing jobs have been + * returned.

+ */ export class ListSigningPlatformsCommand extends $Command< ListSigningPlatformsCommandInput, ListSigningPlatformsCommandOutput, @@ -34,6 +43,9 @@ export class ListSigningPlatformsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/ListSigningProfilesCommand.ts b/clients/client-signer/commands/ListSigningProfilesCommand.ts index 98735f043af91..0dd3e044e9876 100644 --- a/clients/client-signer/commands/ListSigningProfilesCommand.ts +++ b/clients/client-signer/commands/ListSigningProfilesCommand.ts @@ -20,6 +20,16 @@ import { export type ListSigningProfilesCommandInput = ListSigningProfilesRequest; export type ListSigningProfilesCommandOutput = ListSigningProfilesResponse & __MetadataBearer; +/** + *

Lists all available signing profiles in your AWS account. Returns only profiles with + * an ACTIVE status unless the includeCanceled request field is + * set to true. If additional jobs remain to be listed, code signing returns a + * nextToken value. Use this value in subsequent calls to + * ListSigningJobs to fetch the remaining values. You can continue calling + * ListSigningJobs with your maxResults parameter and with + * new values that code signing returns in the nextToken parameter until all of your + * signing jobs have been returned.

+ */ export class ListSigningProfilesCommand extends $Command< ListSigningProfilesCommandInput, ListSigningProfilesCommandOutput, @@ -34,6 +44,9 @@ export class ListSigningProfilesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/ListTagsForResourceCommand.ts b/clients/client-signer/commands/ListTagsForResourceCommand.ts index d7d637c571c7f..3a6c9bc74280b 100644 --- a/clients/client-signer/commands/ListTagsForResourceCommand.ts +++ b/clients/client-signer/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns a list of the tags associated with a signing profile resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/PutSigningProfileCommand.ts b/clients/client-signer/commands/PutSigningProfileCommand.ts index e4170837db9b9..ef76cae61349b 100644 --- a/clients/client-signer/commands/PutSigningProfileCommand.ts +++ b/clients/client-signer/commands/PutSigningProfileCommand.ts @@ -20,6 +20,11 @@ import { export type PutSigningProfileCommandInput = PutSigningProfileRequest; export type PutSigningProfileCommandOutput = PutSigningProfileResponse & __MetadataBearer; +/** + *

Creates a signing profile. A signing profile is a code signing template that can be used to + * carry out a pre-defined signing job. For more information, see http://docs.aws.amazon.com/signer/latest/developerguide/gs-profile.html + *

+ */ export class PutSigningProfileCommand extends $Command< PutSigningProfileCommandInput, PutSigningProfileCommandOutput, @@ -34,6 +39,9 @@ export class PutSigningProfileCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/StartSigningJobCommand.ts b/clients/client-signer/commands/StartSigningJobCommand.ts index b0107880a2688..7c83fa64a628d 100644 --- a/clients/client-signer/commands/StartSigningJobCommand.ts +++ b/clients/client-signer/commands/StartSigningJobCommand.ts @@ -20,6 +20,36 @@ import { export type StartSigningJobCommandInput = StartSigningJobRequest; export type StartSigningJobCommandOutput = StartSigningJobResponse & __MetadataBearer; +/** + *

Initiates a signing job to be performed on the code provided. Signing jobs are + * viewable by the ListSigningJobs operation for two years after they are + * performed. Note the following requirements:

+ *
    + *
  • + *

    You must create an Amazon S3 source bucket. For more information, see Create a Bucket in the + * Amazon S3 Getting Started Guide.

    + *
  • + *
  • + *

    Your S3 source bucket must be version enabled.

    + *
  • + *
  • + *

    You must create an S3 destination bucket. Code signing uses your S3 destination + * bucket to write your signed code.

    + *
  • + *
  • + *

    You specify the name of the source and destination buckets when calling the + * StartSigningJob operation.

    + *
  • + *
  • + *

    You must also specify a request token that identifies your request to + * code signing.

    + *
  • + *
+ *

You can call the DescribeSigningJob and the ListSigningJobs actions after you call + * StartSigningJob.

+ *

For a Java example that shows how to use this action, see http://docs.aws.amazon.com/acm/latest/userguide/ + *

+ */ export class StartSigningJobCommand extends $Command< StartSigningJobCommandInput, StartSigningJobCommandOutput, @@ -34,6 +64,9 @@ export class StartSigningJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/TagResourceCommand.ts b/clients/client-signer/commands/TagResourceCommand.ts index 0ce11e1aad4c7..10994b5210c56 100644 --- a/clients/client-signer/commands/TagResourceCommand.ts +++ b/clients/client-signer/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds one or more tags to a signing profile. Tags are labels that you can use to + * identify and organize your AWS resources. Each tag consists of a key and an optional + * value. To specify the signing profile, use its Amazon Resource Name (ARN). To specify + * the tag, use a key-value pair.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/commands/UntagResourceCommand.ts b/clients/client-signer/commands/UntagResourceCommand.ts index 435f9c70564b0..196840b3536ae 100644 --- a/clients/client-signer/commands/UntagResourceCommand.ts +++ b/clients/client-signer/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from a signing profile. To remove the tags, specify a list of + * tag keys.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SignerClientResolvedConfig, diff --git a/clients/client-signer/package.json b/clients/client-signer/package.json index e9a40bf5c49b7..278e5d51fc385 100644 --- a/clients/client-signer/package.json +++ b/clients/client-signer/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Signer Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-signer/pagination/ListSigningJobsPaginator.ts b/clients/client-signer/pagination/ListSigningJobsPaginator.ts index f0588e5f7cc5d..59b81c1db333c 100644 --- a/clients/client-signer/pagination/ListSigningJobsPaginator.ts +++ b/clients/client-signer/pagination/ListSigningJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SignerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SignerClient, input: ListSigningJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSigningJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Signer, input: ListSigningJobsCommandInput, diff --git a/clients/client-signer/pagination/ListSigningPlatformsPaginator.ts b/clients/client-signer/pagination/ListSigningPlatformsPaginator.ts index adf611b5eaf4c..b0026838c4b54 100644 --- a/clients/client-signer/pagination/ListSigningPlatformsPaginator.ts +++ b/clients/client-signer/pagination/ListSigningPlatformsPaginator.ts @@ -8,6 +8,9 @@ import { import { SignerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SignerClient, input: ListSigningPlatformsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSigningPlatformsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Signer, input: ListSigningPlatformsCommandInput, diff --git a/clients/client-signer/pagination/ListSigningProfilesPaginator.ts b/clients/client-signer/pagination/ListSigningProfilesPaginator.ts index 7b78af9e611d4..de0fe21aa51e7 100644 --- a/clients/client-signer/pagination/ListSigningProfilesPaginator.ts +++ b/clients/client-signer/pagination/ListSigningProfilesPaginator.ts @@ -8,6 +8,9 @@ import { import { SignerPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SignerClient, input: ListSigningProfilesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSigningProfilesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Signer, input: ListSigningProfilesCommandInput, diff --git a/clients/client-signer/runtimeConfig.browser.ts b/clients/client-signer/runtimeConfig.browser.ts index efed9d12a7816..a788ed7a51d4f 100644 --- a/clients/client-signer/runtimeConfig.browser.ts +++ b/clients/client-signer/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SignerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-signer/runtimeConfig.native.ts b/clients/client-signer/runtimeConfig.native.ts index dd28537ba6891..fbd2cc504fa73 100644 --- a/clients/client-signer/runtimeConfig.native.ts +++ b/clients/client-signer/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SignerClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-signer/runtimeConfig.shared.ts b/clients/client-signer/runtimeConfig.shared.ts index 2e56624c41d5f..3dbd878ca087e 100644 --- a/clients/client-signer/runtimeConfig.shared.ts +++ b/clients/client-signer/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-08-25", disableHostPrefix: false, diff --git a/clients/client-signer/runtimeConfig.ts b/clients/client-signer/runtimeConfig.ts index a4dc8d70aedf0..50a3939ca2e94 100644 --- a/clients/client-signer/runtimeConfig.ts +++ b/clients/client-signer/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SignerClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-signer/tsconfig.json b/clients/client-signer/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-signer/tsconfig.json +++ b/clients/client-signer/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sms/commands/CreateAppCommand.ts b/clients/client-sms/commands/CreateAppCommand.ts index d7f23fa9abd7b..d78f0e7544b60 100644 --- a/clients/client-sms/commands/CreateAppCommand.ts +++ b/clients/client-sms/commands/CreateAppCommand.ts @@ -17,6 +17,10 @@ import { export type CreateAppCommandInput = CreateAppRequest; export type CreateAppCommandOutput = CreateAppResponse & __MetadataBearer; +/** + *

Creates an application. An application consists of one or more server groups. Each + * server group contain one or more servers.

+ */ export class CreateAppCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +31,9 @@ export class CreateAppCommand extends $Command, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/CreateReplicationJobCommand.ts b/clients/client-sms/commands/CreateReplicationJobCommand.ts index ef07616122220..e628d985e482b 100644 --- a/clients/client-sms/commands/CreateReplicationJobCommand.ts +++ b/clients/client-sms/commands/CreateReplicationJobCommand.ts @@ -20,6 +20,11 @@ import { export type CreateReplicationJobCommandInput = CreateReplicationJobRequest; export type CreateReplicationJobCommandOutput = CreateReplicationJobResponse & __MetadataBearer; +/** + *

Creates a replication job. The replication job schedules periodic replication runs + * to replicate your server to AWS. Each replication run creates an Amazon Machine Image + * (AMI).

+ */ export class CreateReplicationJobCommand extends $Command< CreateReplicationJobCommandInput, CreateReplicationJobCommandOutput, @@ -34,6 +39,9 @@ export class CreateReplicationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/DeleteAppCommand.ts b/clients/client-sms/commands/DeleteAppCommand.ts index 79afdabd7083b..8c1a471fc2f90 100644 --- a/clients/client-sms/commands/DeleteAppCommand.ts +++ b/clients/client-sms/commands/DeleteAppCommand.ts @@ -17,6 +17,10 @@ import { export type DeleteAppCommandInput = DeleteAppRequest; export type DeleteAppCommandOutput = DeleteAppResponse & __MetadataBearer; +/** + *

Deletes the specified application. Optionally deletes the launched stack associated with + * the application and all AWS SMS replication jobs for servers in the application.

+ */ export class DeleteAppCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +31,9 @@ export class DeleteAppCommand extends $Command, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/DeleteAppLaunchConfigurationCommand.ts b/clients/client-sms/commands/DeleteAppLaunchConfigurationCommand.ts index 0b4ff100a5216..1f3ea73e7dcaa 100644 --- a/clients/client-sms/commands/DeleteAppLaunchConfigurationCommand.ts +++ b/clients/client-sms/commands/DeleteAppLaunchConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAppLaunchConfigurationCommandInput = DeleteAppLaunchConfigurationRequest; export type DeleteAppLaunchConfigurationCommandOutput = DeleteAppLaunchConfigurationResponse & __MetadataBearer; +/** + *

Deletes the launch configuration for the specified application.

+ */ export class DeleteAppLaunchConfigurationCommand extends $Command< DeleteAppLaunchConfigurationCommandInput, DeleteAppLaunchConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAppLaunchConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/DeleteAppReplicationConfigurationCommand.ts b/clients/client-sms/commands/DeleteAppReplicationConfigurationCommand.ts index 9b714f87a5edd..d520cca3b501d 100644 --- a/clients/client-sms/commands/DeleteAppReplicationConfigurationCommand.ts +++ b/clients/client-sms/commands/DeleteAppReplicationConfigurationCommand.ts @@ -24,6 +24,9 @@ export type DeleteAppReplicationConfigurationCommandInput = DeleteAppReplication export type DeleteAppReplicationConfigurationCommandOutput = DeleteAppReplicationConfigurationResponse & __MetadataBearer; +/** + *

Deletes the replication configuration for the specified application.

+ */ export class DeleteAppReplicationConfigurationCommand extends $Command< DeleteAppReplicationConfigurationCommandInput, DeleteAppReplicationConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class DeleteAppReplicationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/DeleteAppValidationConfigurationCommand.ts b/clients/client-sms/commands/DeleteAppValidationConfigurationCommand.ts index 0188ad037b700..995ebaeb1c188 100644 --- a/clients/client-sms/commands/DeleteAppValidationConfigurationCommand.ts +++ b/clients/client-sms/commands/DeleteAppValidationConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAppValidationConfigurationCommandInput = DeleteAppValidationConfigurationRequest; export type DeleteAppValidationConfigurationCommandOutput = DeleteAppValidationConfigurationResponse & __MetadataBearer; +/** + *

Deletes the validation configuration for the specified application.

+ */ export class DeleteAppValidationConfigurationCommand extends $Command< DeleteAppValidationConfigurationCommandInput, DeleteAppValidationConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAppValidationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/DeleteReplicationJobCommand.ts b/clients/client-sms/commands/DeleteReplicationJobCommand.ts index 9812f0020a5e7..42eaef6e98272 100644 --- a/clients/client-sms/commands/DeleteReplicationJobCommand.ts +++ b/clients/client-sms/commands/DeleteReplicationJobCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteReplicationJobCommandInput = DeleteReplicationJobRequest; export type DeleteReplicationJobCommandOutput = DeleteReplicationJobResponse & __MetadataBearer; +/** + *

Deletes the specified replication job.

+ *

After you delete a replication job, there are no further replication runs. AWS + * deletes the contents of the Amazon S3 bucket used to store AWS SMS artifacts. The AMIs created + * by the replication runs are not deleted.

+ */ export class DeleteReplicationJobCommand extends $Command< DeleteReplicationJobCommandInput, DeleteReplicationJobCommandOutput, @@ -34,6 +40,9 @@ export class DeleteReplicationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/DeleteServerCatalogCommand.ts b/clients/client-sms/commands/DeleteServerCatalogCommand.ts index 8fef4e03f2735..7064666fe320d 100644 --- a/clients/client-sms/commands/DeleteServerCatalogCommand.ts +++ b/clients/client-sms/commands/DeleteServerCatalogCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteServerCatalogCommandInput = DeleteServerCatalogRequest; export type DeleteServerCatalogCommandOutput = DeleteServerCatalogResponse & __MetadataBearer; +/** + *

Deletes all servers from your server catalog.

+ */ export class DeleteServerCatalogCommand extends $Command< DeleteServerCatalogCommandInput, DeleteServerCatalogCommandOutput, @@ -34,6 +37,9 @@ export class DeleteServerCatalogCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/DisassociateConnectorCommand.ts b/clients/client-sms/commands/DisassociateConnectorCommand.ts index 07cbe40595d81..82457bd3bcc80 100644 --- a/clients/client-sms/commands/DisassociateConnectorCommand.ts +++ b/clients/client-sms/commands/DisassociateConnectorCommand.ts @@ -20,6 +20,11 @@ import { export type DisassociateConnectorCommandInput = DisassociateConnectorRequest; export type DisassociateConnectorCommandOutput = DisassociateConnectorResponse & __MetadataBearer; +/** + *

Disassociates the specified connector from AWS SMS.

+ *

After you disassociate a connector, it is no longer available to support + * replication jobs.

+ */ export class DisassociateConnectorCommand extends $Command< DisassociateConnectorCommandInput, DisassociateConnectorCommandOutput, @@ -34,6 +39,9 @@ export class DisassociateConnectorCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GenerateChangeSetCommand.ts b/clients/client-sms/commands/GenerateChangeSetCommand.ts index baaeb1c3523b5..85ab6f640fc21 100644 --- a/clients/client-sms/commands/GenerateChangeSetCommand.ts +++ b/clients/client-sms/commands/GenerateChangeSetCommand.ts @@ -20,6 +20,10 @@ import { export type GenerateChangeSetCommandInput = GenerateChangeSetRequest; export type GenerateChangeSetCommandOutput = GenerateChangeSetResponse & __MetadataBearer; +/** + *

Generates a target change set for a currently launched stack and writes it to an Amazon S3 + * object in the customer’s Amazon S3 bucket.

+ */ export class GenerateChangeSetCommand extends $Command< GenerateChangeSetCommandInput, GenerateChangeSetCommandOutput, @@ -34,6 +38,9 @@ export class GenerateChangeSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GenerateTemplateCommand.ts b/clients/client-sms/commands/GenerateTemplateCommand.ts index 980d12e2ae6f0..35faf6a038f76 100644 --- a/clients/client-sms/commands/GenerateTemplateCommand.ts +++ b/clients/client-sms/commands/GenerateTemplateCommand.ts @@ -20,6 +20,10 @@ import { export type GenerateTemplateCommandInput = GenerateTemplateRequest; export type GenerateTemplateCommandOutput = GenerateTemplateResponse & __MetadataBearer; +/** + *

Generates an AWS CloudFormation template based on the current launch configuration and writes it to + * an Amazon S3 object in the customer’s Amazon S3 bucket.

+ */ export class GenerateTemplateCommand extends $Command< GenerateTemplateCommandInput, GenerateTemplateCommandOutput, @@ -34,6 +38,9 @@ export class GenerateTemplateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetAppCommand.ts b/clients/client-sms/commands/GetAppCommand.ts index da13be104576c..b2d75d7fc5c30 100644 --- a/clients/client-sms/commands/GetAppCommand.ts +++ b/clients/client-sms/commands/GetAppCommand.ts @@ -17,6 +17,9 @@ import { export type GetAppCommandInput = GetAppRequest; export type GetAppCommandOutput = GetAppResponse & __MetadataBearer; +/** + *

Retrieve information about the specified application.

+ */ export class GetAppCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class GetAppCommand extends $Command, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetAppLaunchConfigurationCommand.ts b/clients/client-sms/commands/GetAppLaunchConfigurationCommand.ts index 317e472748c2f..68dc19e87bd36 100644 --- a/clients/client-sms/commands/GetAppLaunchConfigurationCommand.ts +++ b/clients/client-sms/commands/GetAppLaunchConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetAppLaunchConfigurationCommandInput = GetAppLaunchConfigurationRequest; export type GetAppLaunchConfigurationCommandOutput = GetAppLaunchConfigurationResponse & __MetadataBearer; +/** + *

Retrieves the application launch configuration associated with the specified application.

+ */ export class GetAppLaunchConfigurationCommand extends $Command< GetAppLaunchConfigurationCommandInput, GetAppLaunchConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetAppLaunchConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetAppReplicationConfigurationCommand.ts b/clients/client-sms/commands/GetAppReplicationConfigurationCommand.ts index 8a613b9697968..843c292fd6cc7 100644 --- a/clients/client-sms/commands/GetAppReplicationConfigurationCommand.ts +++ b/clients/client-sms/commands/GetAppReplicationConfigurationCommand.ts @@ -20,6 +20,10 @@ import { export type GetAppReplicationConfigurationCommandInput = GetAppReplicationConfigurationRequest; export type GetAppReplicationConfigurationCommandOutput = GetAppReplicationConfigurationResponse & __MetadataBearer; +/** + *

Retrieves the application replication configuration associated with the specified + * application.

+ */ export class GetAppReplicationConfigurationCommand extends $Command< GetAppReplicationConfigurationCommandInput, GetAppReplicationConfigurationCommandOutput, @@ -34,6 +38,9 @@ export class GetAppReplicationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetAppValidationConfigurationCommand.ts b/clients/client-sms/commands/GetAppValidationConfigurationCommand.ts index 710006b299d46..c0e1566ecb7a8 100644 --- a/clients/client-sms/commands/GetAppValidationConfigurationCommand.ts +++ b/clients/client-sms/commands/GetAppValidationConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type GetAppValidationConfigurationCommandInput = GetAppValidationConfigurationRequest; export type GetAppValidationConfigurationCommandOutput = GetAppValidationConfigurationResponse & __MetadataBearer; +/** + *

Retrieves information about a configuration for validating an application.

+ */ export class GetAppValidationConfigurationCommand extends $Command< GetAppValidationConfigurationCommandInput, GetAppValidationConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class GetAppValidationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetAppValidationOutputCommand.ts b/clients/client-sms/commands/GetAppValidationOutputCommand.ts index b265b06fa5fc0..95646ebc66fa4 100644 --- a/clients/client-sms/commands/GetAppValidationOutputCommand.ts +++ b/clients/client-sms/commands/GetAppValidationOutputCommand.ts @@ -20,6 +20,9 @@ import { export type GetAppValidationOutputCommandInput = GetAppValidationOutputRequest; export type GetAppValidationOutputCommandOutput = GetAppValidationOutputResponse & __MetadataBearer; +/** + *

Retrieves output from validating an application.

+ */ export class GetAppValidationOutputCommand extends $Command< GetAppValidationOutputCommandInput, GetAppValidationOutputCommandOutput, @@ -34,6 +37,9 @@ export class GetAppValidationOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetConnectorsCommand.ts b/clients/client-sms/commands/GetConnectorsCommand.ts index 3d4d4bf69c99c..ab7c923800927 100644 --- a/clients/client-sms/commands/GetConnectorsCommand.ts +++ b/clients/client-sms/commands/GetConnectorsCommand.ts @@ -20,6 +20,9 @@ import { export type GetConnectorsCommandInput = GetConnectorsRequest; export type GetConnectorsCommandOutput = GetConnectorsResponse & __MetadataBearer; +/** + *

Describes the connectors registered with the AWS SMS.

+ */ export class GetConnectorsCommand extends $Command< GetConnectorsCommandInput, GetConnectorsCommandOutput, @@ -34,6 +37,9 @@ export class GetConnectorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetReplicationJobsCommand.ts b/clients/client-sms/commands/GetReplicationJobsCommand.ts index c3cfc896c6c27..aa4b1403428d3 100644 --- a/clients/client-sms/commands/GetReplicationJobsCommand.ts +++ b/clients/client-sms/commands/GetReplicationJobsCommand.ts @@ -20,6 +20,9 @@ import { export type GetReplicationJobsCommandInput = GetReplicationJobsRequest; export type GetReplicationJobsCommandOutput = GetReplicationJobsResponse & __MetadataBearer; +/** + *

Describes the specified replication job or all of your replication jobs.

+ */ export class GetReplicationJobsCommand extends $Command< GetReplicationJobsCommandInput, GetReplicationJobsCommandOutput, @@ -34,6 +37,9 @@ export class GetReplicationJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetReplicationRunsCommand.ts b/clients/client-sms/commands/GetReplicationRunsCommand.ts index 07db7ddaf102f..b977f991e25d7 100644 --- a/clients/client-sms/commands/GetReplicationRunsCommand.ts +++ b/clients/client-sms/commands/GetReplicationRunsCommand.ts @@ -20,6 +20,9 @@ import { export type GetReplicationRunsCommandInput = GetReplicationRunsRequest; export type GetReplicationRunsCommandOutput = GetReplicationRunsResponse & __MetadataBearer; +/** + *

Describes the replication runs for the specified replication job.

+ */ export class GetReplicationRunsCommand extends $Command< GetReplicationRunsCommandInput, GetReplicationRunsCommandOutput, @@ -34,6 +37,9 @@ export class GetReplicationRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/GetServersCommand.ts b/clients/client-sms/commands/GetServersCommand.ts index fa4708d9d154f..e2d097bf0dc9a 100644 --- a/clients/client-sms/commands/GetServersCommand.ts +++ b/clients/client-sms/commands/GetServersCommand.ts @@ -20,6 +20,10 @@ import { export type GetServersCommandInput = GetServersRequest; export type GetServersCommandOutput = GetServersResponse & __MetadataBearer; +/** + *

Describes the servers in your server catalog.

+ *

Before you can describe your servers, you must import them using ImportServerCatalog.

+ */ export class GetServersCommand extends $Command< GetServersCommandInput, GetServersCommandOutput, @@ -34,6 +38,9 @@ export class GetServersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/ImportAppCatalogCommand.ts b/clients/client-sms/commands/ImportAppCatalogCommand.ts index 41322fe6b6955..3efc8d25e4502 100644 --- a/clients/client-sms/commands/ImportAppCatalogCommand.ts +++ b/clients/client-sms/commands/ImportAppCatalogCommand.ts @@ -20,6 +20,9 @@ import { export type ImportAppCatalogCommandInput = ImportAppCatalogRequest; export type ImportAppCatalogCommandOutput = ImportAppCatalogResponse & __MetadataBearer; +/** + *

Allows application import from AWS Migration Hub.

+ */ export class ImportAppCatalogCommand extends $Command< ImportAppCatalogCommandInput, ImportAppCatalogCommandOutput, @@ -34,6 +37,9 @@ export class ImportAppCatalogCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/ImportServerCatalogCommand.ts b/clients/client-sms/commands/ImportServerCatalogCommand.ts index d8cfc69c76c45..e303064676885 100644 --- a/clients/client-sms/commands/ImportServerCatalogCommand.ts +++ b/clients/client-sms/commands/ImportServerCatalogCommand.ts @@ -20,6 +20,12 @@ import { export type ImportServerCatalogCommandInput = ImportServerCatalogRequest; export type ImportServerCatalogCommandOutput = ImportServerCatalogResponse & __MetadataBearer; +/** + *

Gathers a complete list of on-premises servers. Connectors must be installed and + * monitoring all servers to import.

+ *

This call returns immediately, but might take additional time to retrieve all the + * servers.

+ */ export class ImportServerCatalogCommand extends $Command< ImportServerCatalogCommandInput, ImportServerCatalogCommandOutput, @@ -34,6 +40,9 @@ export class ImportServerCatalogCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/LaunchAppCommand.ts b/clients/client-sms/commands/LaunchAppCommand.ts index 3efc095b9ea2e..e6ed18dff91ea 100644 --- a/clients/client-sms/commands/LaunchAppCommand.ts +++ b/clients/client-sms/commands/LaunchAppCommand.ts @@ -17,6 +17,9 @@ import { export type LaunchAppCommandInput = LaunchAppRequest; export type LaunchAppCommandOutput = LaunchAppResponse & __MetadataBearer; +/** + *

Launches the specified application as a stack in AWS CloudFormation.

+ */ export class LaunchAppCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class LaunchAppCommand extends $Command, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/ListAppsCommand.ts b/clients/client-sms/commands/ListAppsCommand.ts index 1f84a267e8bb0..902b6689b680a 100644 --- a/clients/client-sms/commands/ListAppsCommand.ts +++ b/clients/client-sms/commands/ListAppsCommand.ts @@ -17,6 +17,9 @@ import { export type ListAppsCommandInput = ListAppsRequest; export type ListAppsCommandOutput = ListAppsResponse & __MetadataBearer; +/** + *

Retrieves summaries for all applications.

+ */ export class ListAppsCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class ListAppsCommand extends $Command, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/NotifyAppValidationOutputCommand.ts b/clients/client-sms/commands/NotifyAppValidationOutputCommand.ts index af83c3bcf5239..af0943306b78f 100644 --- a/clients/client-sms/commands/NotifyAppValidationOutputCommand.ts +++ b/clients/client-sms/commands/NotifyAppValidationOutputCommand.ts @@ -20,6 +20,9 @@ import { export type NotifyAppValidationOutputCommandInput = NotifyAppValidationOutputRequest; export type NotifyAppValidationOutputCommandOutput = NotifyAppValidationOutputResponse & __MetadataBearer; +/** + *

Provides information to AWS SMS about whether application validation is successful.

+ */ export class NotifyAppValidationOutputCommand extends $Command< NotifyAppValidationOutputCommandInput, NotifyAppValidationOutputCommandOutput, @@ -34,6 +37,9 @@ export class NotifyAppValidationOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/PutAppLaunchConfigurationCommand.ts b/clients/client-sms/commands/PutAppLaunchConfigurationCommand.ts index fb2a057ffa45e..d86513089007d 100644 --- a/clients/client-sms/commands/PutAppLaunchConfigurationCommand.ts +++ b/clients/client-sms/commands/PutAppLaunchConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type PutAppLaunchConfigurationCommandInput = PutAppLaunchConfigurationRequest; export type PutAppLaunchConfigurationCommandOutput = PutAppLaunchConfigurationResponse & __MetadataBearer; +/** + *

Creates or updates the launch configuration for the specified application.

+ */ export class PutAppLaunchConfigurationCommand extends $Command< PutAppLaunchConfigurationCommandInput, PutAppLaunchConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class PutAppLaunchConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/PutAppReplicationConfigurationCommand.ts b/clients/client-sms/commands/PutAppReplicationConfigurationCommand.ts index 875a445523fac..28c119166366b 100644 --- a/clients/client-sms/commands/PutAppReplicationConfigurationCommand.ts +++ b/clients/client-sms/commands/PutAppReplicationConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type PutAppReplicationConfigurationCommandInput = PutAppReplicationConfigurationRequest; export type PutAppReplicationConfigurationCommandOutput = PutAppReplicationConfigurationResponse & __MetadataBearer; +/** + *

Creates or updates the replication configuration for the specified application.

+ */ export class PutAppReplicationConfigurationCommand extends $Command< PutAppReplicationConfigurationCommandInput, PutAppReplicationConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class PutAppReplicationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/PutAppValidationConfigurationCommand.ts b/clients/client-sms/commands/PutAppValidationConfigurationCommand.ts index 4d7000d04a9a5..d05c0c5354e8a 100644 --- a/clients/client-sms/commands/PutAppValidationConfigurationCommand.ts +++ b/clients/client-sms/commands/PutAppValidationConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type PutAppValidationConfigurationCommandInput = PutAppValidationConfigurationRequest; export type PutAppValidationConfigurationCommandOutput = PutAppValidationConfigurationResponse & __MetadataBearer; +/** + *

Creates or updates a validation configuration for the specified application.

+ */ export class PutAppValidationConfigurationCommand extends $Command< PutAppValidationConfigurationCommandInput, PutAppValidationConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class PutAppValidationConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/StartAppReplicationCommand.ts b/clients/client-sms/commands/StartAppReplicationCommand.ts index 28a7f2552fa81..3bca39aecf54d 100644 --- a/clients/client-sms/commands/StartAppReplicationCommand.ts +++ b/clients/client-sms/commands/StartAppReplicationCommand.ts @@ -20,6 +20,10 @@ import { export type StartAppReplicationCommandInput = StartAppReplicationRequest; export type StartAppReplicationCommandOutput = StartAppReplicationResponse & __MetadataBearer; +/** + *

Starts replicating the specified application by creating replication jobs for each server in the + * application.

+ */ export class StartAppReplicationCommand extends $Command< StartAppReplicationCommandInput, StartAppReplicationCommandOutput, @@ -34,6 +38,9 @@ export class StartAppReplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/StartOnDemandAppReplicationCommand.ts b/clients/client-sms/commands/StartOnDemandAppReplicationCommand.ts index b2deabbeb0339..7ea574b48fe4a 100644 --- a/clients/client-sms/commands/StartOnDemandAppReplicationCommand.ts +++ b/clients/client-sms/commands/StartOnDemandAppReplicationCommand.ts @@ -20,6 +20,9 @@ import { export type StartOnDemandAppReplicationCommandInput = StartOnDemandAppReplicationRequest; export type StartOnDemandAppReplicationCommandOutput = StartOnDemandAppReplicationResponse & __MetadataBearer; +/** + *

Starts an on-demand replication run for the specified application.

+ */ export class StartOnDemandAppReplicationCommand extends $Command< StartOnDemandAppReplicationCommandInput, StartOnDemandAppReplicationCommandOutput, @@ -34,6 +37,9 @@ export class StartOnDemandAppReplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/StartOnDemandReplicationRunCommand.ts b/clients/client-sms/commands/StartOnDemandReplicationRunCommand.ts index 83d5758d5a227..53c1b3b6d7040 100644 --- a/clients/client-sms/commands/StartOnDemandReplicationRunCommand.ts +++ b/clients/client-sms/commands/StartOnDemandReplicationRunCommand.ts @@ -20,6 +20,13 @@ import { export type StartOnDemandReplicationRunCommandInput = StartOnDemandReplicationRunRequest; export type StartOnDemandReplicationRunCommandOutput = StartOnDemandReplicationRunResponse & __MetadataBearer; +/** + *

Starts an on-demand replication run for the specified replication job. This + * replication run starts immediately. This replication run is in addition to the ones + * already scheduled.

+ *

There is a limit on the number of on-demand replications runs that you can request + * in a 24-hour period.

+ */ export class StartOnDemandReplicationRunCommand extends $Command< StartOnDemandReplicationRunCommandInput, StartOnDemandReplicationRunCommandOutput, @@ -34,6 +41,9 @@ export class StartOnDemandReplicationRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/StopAppReplicationCommand.ts b/clients/client-sms/commands/StopAppReplicationCommand.ts index b458ebac86d5d..f15048a3c3ba7 100644 --- a/clients/client-sms/commands/StopAppReplicationCommand.ts +++ b/clients/client-sms/commands/StopAppReplicationCommand.ts @@ -20,6 +20,10 @@ import { export type StopAppReplicationCommandInput = StopAppReplicationRequest; export type StopAppReplicationCommandOutput = StopAppReplicationResponse & __MetadataBearer; +/** + *

Stops replicating the specified application by deleting the replication job for each server in + * the application.

+ */ export class StopAppReplicationCommand extends $Command< StopAppReplicationCommandInput, StopAppReplicationCommandOutput, @@ -34,6 +38,9 @@ export class StopAppReplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/TerminateAppCommand.ts b/clients/client-sms/commands/TerminateAppCommand.ts index ecdcfa91b2765..15b400fe42a0c 100644 --- a/clients/client-sms/commands/TerminateAppCommand.ts +++ b/clients/client-sms/commands/TerminateAppCommand.ts @@ -20,6 +20,9 @@ import { export type TerminateAppCommandInput = TerminateAppRequest; export type TerminateAppCommandOutput = TerminateAppResponse & __MetadataBearer; +/** + *

Terminates the stack for the specified application.

+ */ export class TerminateAppCommand extends $Command< TerminateAppCommandInput, TerminateAppCommandOutput, @@ -34,6 +37,9 @@ export class TerminateAppCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/UpdateAppCommand.ts b/clients/client-sms/commands/UpdateAppCommand.ts index 0d77a1996c3c4..97d93d7ec08e8 100644 --- a/clients/client-sms/commands/UpdateAppCommand.ts +++ b/clients/client-sms/commands/UpdateAppCommand.ts @@ -17,6 +17,9 @@ import { export type UpdateAppCommandInput = UpdateAppRequest; export type UpdateAppCommandOutput = UpdateAppResponse & __MetadataBearer; +/** + *

Updates the specified application.

+ */ export class UpdateAppCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class UpdateAppCommand extends $Command, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/commands/UpdateReplicationJobCommand.ts b/clients/client-sms/commands/UpdateReplicationJobCommand.ts index 4b300cc0c25a3..c8216216dbebe 100644 --- a/clients/client-sms/commands/UpdateReplicationJobCommand.ts +++ b/clients/client-sms/commands/UpdateReplicationJobCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateReplicationJobCommandInput = UpdateReplicationJobRequest; export type UpdateReplicationJobCommandOutput = UpdateReplicationJobResponse & __MetadataBearer; +/** + *

Updates the specified settings for the specified replication job.

+ */ export class UpdateReplicationJobCommand extends $Command< UpdateReplicationJobCommandInput, UpdateReplicationJobCommandOutput, @@ -34,6 +37,9 @@ export class UpdateReplicationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SMSClientResolvedConfig, diff --git a/clients/client-sms/package.json b/clients/client-sms/package.json index e955d1f5b7ecd..6a6c604acb624 100644 --- a/clients/client-sms/package.json +++ b/clients/client-sms/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sms Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sms/pagination/GetConnectorsPaginator.ts b/clients/client-sms/pagination/GetConnectorsPaginator.ts index 43d81d87d01e1..8c079b2187e60 100644 --- a/clients/client-sms/pagination/GetConnectorsPaginator.ts +++ b/clients/client-sms/pagination/GetConnectorsPaginator.ts @@ -8,6 +8,9 @@ import { import { SMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SMSClient, input: GetConnectorsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetConnectorsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SMS, input: GetConnectorsCommandInput, diff --git a/clients/client-sms/pagination/GetReplicationJobsPaginator.ts b/clients/client-sms/pagination/GetReplicationJobsPaginator.ts index 2a44ddced2160..9ca4f1b291d42 100644 --- a/clients/client-sms/pagination/GetReplicationJobsPaginator.ts +++ b/clients/client-sms/pagination/GetReplicationJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { SMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SMSClient, input: GetReplicationJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetReplicationJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SMS, input: GetReplicationJobsCommandInput, diff --git a/clients/client-sms/pagination/GetReplicationRunsPaginator.ts b/clients/client-sms/pagination/GetReplicationRunsPaginator.ts index 1ffeeddb24c45..7d4f0c48897a3 100644 --- a/clients/client-sms/pagination/GetReplicationRunsPaginator.ts +++ b/clients/client-sms/pagination/GetReplicationRunsPaginator.ts @@ -8,6 +8,9 @@ import { import { SMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SMSClient, input: GetReplicationRunsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetReplicationRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SMS, input: GetReplicationRunsCommandInput, diff --git a/clients/client-sms/pagination/GetServersPaginator.ts b/clients/client-sms/pagination/GetServersPaginator.ts index aaf5cb132dd20..fe7d7396c8508 100644 --- a/clients/client-sms/pagination/GetServersPaginator.ts +++ b/clients/client-sms/pagination/GetServersPaginator.ts @@ -4,6 +4,9 @@ import { GetServersCommand, GetServersCommandInput, GetServersCommandOutput } fr import { SMSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SMSClient, input: GetServersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetServersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SMS, input: GetServersCommandInput, diff --git a/clients/client-sms/runtimeConfig.browser.ts b/clients/client-sms/runtimeConfig.browser.ts index 1fe3a7cad3580..1dcb5c55bef75 100644 --- a/clients/client-sms/runtimeConfig.browser.ts +++ b/clients/client-sms/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SMSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sms/runtimeConfig.native.ts b/clients/client-sms/runtimeConfig.native.ts index 1487b7323f441..4bc1ab9e5b035 100644 --- a/clients/client-sms/runtimeConfig.native.ts +++ b/clients/client-sms/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SMSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sms/runtimeConfig.shared.ts b/clients/client-sms/runtimeConfig.shared.ts index 0945e4287203a..ce833c2440fa5 100644 --- a/clients/client-sms/runtimeConfig.shared.ts +++ b/clients/client-sms/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-10-24", disableHostPrefix: false, diff --git a/clients/client-sms/runtimeConfig.ts b/clients/client-sms/runtimeConfig.ts index 9fc0e852898d9..eba8fc1d468f1 100644 --- a/clients/client-sms/runtimeConfig.ts +++ b/clients/client-sms/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SMSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sms/tsconfig.json b/clients/client-sms/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sms/tsconfig.json +++ b/clients/client-sms/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-snowball/commands/CancelClusterCommand.ts b/clients/client-snowball/commands/CancelClusterCommand.ts index 5dc6000e3053a..e9485fd71b532 100644 --- a/clients/client-snowball/commands/CancelClusterCommand.ts +++ b/clients/client-snowball/commands/CancelClusterCommand.ts @@ -20,6 +20,11 @@ import { export type CancelClusterCommandInput = CancelClusterRequest; export type CancelClusterCommandOutput = CancelClusterResult & __MetadataBearer; +/** + *

Cancels a cluster job. You can only cancel a cluster job while it's in the + * AwaitingQuorum status. You'll have at least an hour after creating a cluster + * job to cancel it.

+ */ export class CancelClusterCommand extends $Command< CancelClusterCommandInput, CancelClusterCommandOutput, @@ -34,6 +39,9 @@ export class CancelClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/CancelJobCommand.ts b/clients/client-snowball/commands/CancelJobCommand.ts index 60fc6b5530aff..c6c1a58c8d438 100644 --- a/clients/client-snowball/commands/CancelJobCommand.ts +++ b/clients/client-snowball/commands/CancelJobCommand.ts @@ -17,6 +17,12 @@ import { export type CancelJobCommandInput = CancelJobRequest; export type CancelJobCommandOutput = CancelJobResult & __MetadataBearer; +/** + *

Cancels the specified job. You can only cancel a job before its JobState + * value changes to PreparingAppliance. Requesting the ListJobs or + * DescribeJob action returns a job's JobState as part of the + * response element data returned.

+ */ export class CancelJobCommand extends $Command< CancelJobCommandInput, CancelJobCommandOutput, @@ -31,6 +37,9 @@ export class CancelJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/CreateAddressCommand.ts b/clients/client-snowball/commands/CreateAddressCommand.ts index 8ffb4e74b65f9..8afd7b45e7817 100644 --- a/clients/client-snowball/commands/CreateAddressCommand.ts +++ b/clients/client-snowball/commands/CreateAddressCommand.ts @@ -20,6 +20,12 @@ import { export type CreateAddressCommandInput = CreateAddressRequest; export type CreateAddressCommandOutput = CreateAddressResult & __MetadataBearer; +/** + *

Creates an address for a Snow device to be shipped to. In most regions, + * addresses are validated at the time of creation. The address you provide must be located + * within the serviceable area of your region. If the address is invalid or unsupported, then an + * exception is thrown.

+ */ export class CreateAddressCommand extends $Command< CreateAddressCommandInput, CreateAddressCommandOutput, @@ -34,6 +40,9 @@ export class CreateAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/CreateClusterCommand.ts b/clients/client-snowball/commands/CreateClusterCommand.ts index 52d61699bb9db..9b4c32bd5afed 100644 --- a/clients/client-snowball/commands/CreateClusterCommand.ts +++ b/clients/client-snowball/commands/CreateClusterCommand.ts @@ -20,6 +20,10 @@ import { export type CreateClusterCommandInput = CreateClusterRequest; export type CreateClusterCommandOutput = CreateClusterResult & __MetadataBearer; +/** + *

Creates an empty cluster. Each cluster supports five nodes. You use the CreateJob action separately to create the jobs for each of these nodes. The + * cluster does not ship until these five node jobs have been created.

+ */ export class CreateClusterCommand extends $Command< CreateClusterCommandInput, CreateClusterCommandOutput, @@ -34,6 +38,9 @@ export class CreateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/CreateJobCommand.ts b/clients/client-snowball/commands/CreateJobCommand.ts index a5389ce91032b..0d05740d1f3e3 100644 --- a/clients/client-snowball/commands/CreateJobCommand.ts +++ b/clients/client-snowball/commands/CreateJobCommand.ts @@ -17,6 +17,13 @@ import { export type CreateJobCommandInput = CreateJobRequest; export type CreateJobCommandOutput = CreateJobResult & __MetadataBearer; +/** + *

Creates a job to import or export data between Amazon S3 and your on-premises data + * center. Your AWS account must have the right trust policies and permissions in place to create + * a job for a Snow device. If you're creating a job for a node in a cluster, you only need to provide + * the clusterId value; the other job attributes are inherited from the cluster. + *

+ */ export class CreateJobCommand extends $Command< CreateJobCommandInput, CreateJobCommandOutput, @@ -31,6 +38,9 @@ export class CreateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/CreateReturnShippingLabelCommand.ts b/clients/client-snowball/commands/CreateReturnShippingLabelCommand.ts index 27ffb29e44d91..3bdebcc41a1d9 100644 --- a/clients/client-snowball/commands/CreateReturnShippingLabelCommand.ts +++ b/clients/client-snowball/commands/CreateReturnShippingLabelCommand.ts @@ -20,6 +20,9 @@ import { export type CreateReturnShippingLabelCommandInput = CreateReturnShippingLabelRequest; export type CreateReturnShippingLabelCommandOutput = CreateReturnShippingLabelResult & __MetadataBearer; +/** + *

Creates a shipping label that will be used to return the Snow device to AWS.

+ */ export class CreateReturnShippingLabelCommand extends $Command< CreateReturnShippingLabelCommandInput, CreateReturnShippingLabelCommandOutput, @@ -34,6 +37,9 @@ export class CreateReturnShippingLabelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/DescribeAddressCommand.ts b/clients/client-snowball/commands/DescribeAddressCommand.ts index 6e24a8bcdf9e8..1fb58f2236fe8 100644 --- a/clients/client-snowball/commands/DescribeAddressCommand.ts +++ b/clients/client-snowball/commands/DescribeAddressCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAddressCommandInput = DescribeAddressRequest; export type DescribeAddressCommandOutput = DescribeAddressResult & __MetadataBearer; +/** + *

Takes an AddressId and returns specific details about that address in the + * form of an Address object.

+ */ export class DescribeAddressCommand extends $Command< DescribeAddressCommandInput, DescribeAddressCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/DescribeAddressesCommand.ts b/clients/client-snowball/commands/DescribeAddressesCommand.ts index bb40108e8bb7f..c8263364c49c9 100644 --- a/clients/client-snowball/commands/DescribeAddressesCommand.ts +++ b/clients/client-snowball/commands/DescribeAddressesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAddressesCommandInput = DescribeAddressesRequest; export type DescribeAddressesCommandOutput = DescribeAddressesResult & __MetadataBearer; +/** + *

Returns a specified number of ADDRESS objects. Calling this API in one of + * the US regions will return addresses from the list of all addresses associated with this + * account in all US regions.

+ */ export class DescribeAddressesCommand extends $Command< DescribeAddressesCommandInput, DescribeAddressesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAddressesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/DescribeClusterCommand.ts b/clients/client-snowball/commands/DescribeClusterCommand.ts index e535f980891af..432f12b8e79b7 100644 --- a/clients/client-snowball/commands/DescribeClusterCommand.ts +++ b/clients/client-snowball/commands/DescribeClusterCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeClusterCommandInput = DescribeClusterRequest; export type DescribeClusterCommandOutput = DescribeClusterResult & __MetadataBearer; +/** + *

Returns information about a specific cluster including shipping information, cluster + * status, and other important metadata.

+ */ export class DescribeClusterCommand extends $Command< DescribeClusterCommandInput, DescribeClusterCommandOutput, @@ -34,6 +38,9 @@ export class DescribeClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/DescribeJobCommand.ts b/clients/client-snowball/commands/DescribeJobCommand.ts index ccde9e20ebea3..3b93c6638f9e9 100644 --- a/clients/client-snowball/commands/DescribeJobCommand.ts +++ b/clients/client-snowball/commands/DescribeJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeJobCommandInput = DescribeJobRequest; export type DescribeJobCommandOutput = DescribeJobResult & __MetadataBearer; +/** + *

Returns information about a specific job including shipping information, job status, + * and other important metadata.

+ */ export class DescribeJobCommand extends $Command< DescribeJobCommandInput, DescribeJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/DescribeReturnShippingLabelCommand.ts b/clients/client-snowball/commands/DescribeReturnShippingLabelCommand.ts index 863530e0a2c2e..b7697247af3c8 100644 --- a/clients/client-snowball/commands/DescribeReturnShippingLabelCommand.ts +++ b/clients/client-snowball/commands/DescribeReturnShippingLabelCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeReturnShippingLabelCommandInput = DescribeReturnShippingLabelRequest; export type DescribeReturnShippingLabelCommandOutput = DescribeReturnShippingLabelResult & __MetadataBearer; +/** + *

Information on the shipping label of a Snow device that is being returned to AWS.

+ */ export class DescribeReturnShippingLabelCommand extends $Command< DescribeReturnShippingLabelCommandInput, DescribeReturnShippingLabelCommandOutput, @@ -34,6 +37,9 @@ export class DescribeReturnShippingLabelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/GetJobManifestCommand.ts b/clients/client-snowball/commands/GetJobManifestCommand.ts index 49f180814e813..f28ddfba55f7e 100644 --- a/clients/client-snowball/commands/GetJobManifestCommand.ts +++ b/clients/client-snowball/commands/GetJobManifestCommand.ts @@ -20,6 +20,27 @@ import { export type GetJobManifestCommandInput = GetJobManifestRequest; export type GetJobManifestCommandOutput = GetJobManifestResult & __MetadataBearer; +/** + *

Returns a link to an Amazon S3 presigned URL for the manifest file associated with the + * specified JobId value. You can access the manifest file for up to 60 minutes + * after this request has been made. To access the manifest file after 60 minutes have passed, + * you'll have to make another call to the GetJobManifest action.

+ * + *

The manifest is an encrypted file that you can download after your job enters the + * WithCustomer status. The manifest is decrypted by using the + * UnlockCode code value, when you pass both values to the Snow device through the + * Snowball client when the client is started for the first time.

+ * + * + *

As a best practice, we recommend that you don't save a copy of an + * UnlockCode value in the same location as the manifest file for that job. Saving + * these separately helps prevent unauthorized parties from gaining access to the Snow device + * associated with that job.

+ * + * + *

The credentials of a given job, including its manifest file and unlock code, expire 90 + * days after the job is created.

+ */ export class GetJobManifestCommand extends $Command< GetJobManifestCommandInput, GetJobManifestCommandOutput, @@ -34,6 +55,9 @@ export class GetJobManifestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/GetJobUnlockCodeCommand.ts b/clients/client-snowball/commands/GetJobUnlockCodeCommand.ts index 010badc023866..15893c53d0519 100644 --- a/clients/client-snowball/commands/GetJobUnlockCodeCommand.ts +++ b/clients/client-snowball/commands/GetJobUnlockCodeCommand.ts @@ -20,6 +20,21 @@ import { export type GetJobUnlockCodeCommandInput = GetJobUnlockCodeRequest; export type GetJobUnlockCodeCommandOutput = GetJobUnlockCodeResult & __MetadataBearer; +/** + *

Returns the UnlockCode code value for the specified job. A particular + * UnlockCode value can be accessed for up to 90 days after the associated job has + * been created.

+ * + *

The UnlockCode value is a 29-character code with 25 alphanumeric + * characters and 4 hyphens. This code is used to decrypt the manifest file when it is passed + * along with the manifest to the Snow device through the Snowball client when the client is started + * for the first time.

+ * + *

As a best practice, we recommend that you don't save a copy of the + * UnlockCode in the same location as the manifest file for that job. Saving these + * separately helps prevent unauthorized parties from gaining access to the Snow device associated + * with that job.

+ */ export class GetJobUnlockCodeCommand extends $Command< GetJobUnlockCodeCommandInput, GetJobUnlockCodeCommandOutput, @@ -34,6 +49,9 @@ export class GetJobUnlockCodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/GetSnowballUsageCommand.ts b/clients/client-snowball/commands/GetSnowballUsageCommand.ts index 38f4f531974de..6f9dc9c1db9f8 100644 --- a/clients/client-snowball/commands/GetSnowballUsageCommand.ts +++ b/clients/client-snowball/commands/GetSnowballUsageCommand.ts @@ -20,6 +20,13 @@ import { export type GetSnowballUsageCommandInput = GetSnowballUsageRequest; export type GetSnowballUsageCommandOutput = GetSnowballUsageResult & __MetadataBearer; +/** + *

Returns information about the Snow Family service limit for your account, and also the + * number of Snow devices your account has in use.

+ * + *

The default service limit for the number of Snow devices that you can have at one time is + * 1. If you want to increase your service limit, contact AWS Support.

+ */ export class GetSnowballUsageCommand extends $Command< GetSnowballUsageCommandInput, GetSnowballUsageCommandOutput, @@ -34,6 +41,9 @@ export class GetSnowballUsageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/GetSoftwareUpdatesCommand.ts b/clients/client-snowball/commands/GetSoftwareUpdatesCommand.ts index f8d22b569ff2b..19743bc7e2b5d 100644 --- a/clients/client-snowball/commands/GetSoftwareUpdatesCommand.ts +++ b/clients/client-snowball/commands/GetSoftwareUpdatesCommand.ts @@ -20,6 +20,10 @@ import { export type GetSoftwareUpdatesCommandInput = GetSoftwareUpdatesRequest; export type GetSoftwareUpdatesCommandOutput = GetSoftwareUpdatesResult & __MetadataBearer; +/** + *

Returns an Amazon S3 presigned URL for an update file associated with a specified + * JobId.

+ */ export class GetSoftwareUpdatesCommand extends $Command< GetSoftwareUpdatesCommandInput, GetSoftwareUpdatesCommandOutput, @@ -34,6 +38,9 @@ export class GetSoftwareUpdatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/ListClusterJobsCommand.ts b/clients/client-snowball/commands/ListClusterJobsCommand.ts index bb5de8873074b..a431c40d92542 100644 --- a/clients/client-snowball/commands/ListClusterJobsCommand.ts +++ b/clients/client-snowball/commands/ListClusterJobsCommand.ts @@ -20,6 +20,11 @@ import { export type ListClusterJobsCommandInput = ListClusterJobsRequest; export type ListClusterJobsCommandOutput = ListClusterJobsResult & __MetadataBearer; +/** + *

Returns an array of JobListEntry objects of the specified length. Each + * JobListEntry object is for a job in the specified cluster and contains a job's + * state, a job's ID, and other information.

+ */ export class ListClusterJobsCommand extends $Command< ListClusterJobsCommandInput, ListClusterJobsCommandOutput, @@ -34,6 +39,9 @@ export class ListClusterJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/ListClustersCommand.ts b/clients/client-snowball/commands/ListClustersCommand.ts index 6989534447e19..fad9c07d7024d 100644 --- a/clients/client-snowball/commands/ListClustersCommand.ts +++ b/clients/client-snowball/commands/ListClustersCommand.ts @@ -20,6 +20,11 @@ import { export type ListClustersCommandInput = ListClustersRequest; export type ListClustersCommandOutput = ListClustersResult & __MetadataBearer; +/** + *

Returns an array of ClusterListEntry objects of the specified length. Each + * ClusterListEntry object contains a cluster's state, a cluster's ID, and other + * important status information.

+ */ export class ListClustersCommand extends $Command< ListClustersCommandInput, ListClustersCommandOutput, @@ -34,6 +39,9 @@ export class ListClustersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/ListCompatibleImagesCommand.ts b/clients/client-snowball/commands/ListCompatibleImagesCommand.ts index 3a60ad7d02b4e..75ae75760ea5f 100644 --- a/clients/client-snowball/commands/ListCompatibleImagesCommand.ts +++ b/clients/client-snowball/commands/ListCompatibleImagesCommand.ts @@ -20,6 +20,13 @@ import { export type ListCompatibleImagesCommandInput = ListCompatibleImagesRequest; export type ListCompatibleImagesCommandOutput = ListCompatibleImagesResult & __MetadataBearer; +/** + *

This action returns a list of the different Amazon EC2 Amazon Machine Images (AMIs) + * that are owned by your AWS account that would be supported for use on a Snow device. + * Currently, supported AMIs are based on the CentOS 7 (x86_64) - with Updates HVM, Ubuntu Server + * 14.04 LTS (HVM), and Ubuntu 16.04 LTS - Xenial (HVM) images, available on the AWS + * Marketplace.

+ */ export class ListCompatibleImagesCommand extends $Command< ListCompatibleImagesCommandInput, ListCompatibleImagesCommandOutput, @@ -34,6 +41,9 @@ export class ListCompatibleImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/ListJobsCommand.ts b/clients/client-snowball/commands/ListJobsCommand.ts index abcad59b922ba..f08cdb09d921a 100644 --- a/clients/client-snowball/commands/ListJobsCommand.ts +++ b/clients/client-snowball/commands/ListJobsCommand.ts @@ -17,6 +17,13 @@ import { export type ListJobsCommandInput = ListJobsRequest; export type ListJobsCommandOutput = ListJobsResult & __MetadataBearer; +/** + *

Returns an array of JobListEntry objects of the specified length. Each + * JobListEntry object contains a job's state, a job's ID, and a value that + * indicates whether the job is a job part, in the case of export jobs. Calling this API action + * in one of the US regions will return jobs from the list of all jobs associated with this + * account in all US regions.

+ */ export class ListJobsCommand extends $Command< ListJobsCommandInput, ListJobsCommandOutput, @@ -31,6 +38,9 @@ export class ListJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/UpdateClusterCommand.ts b/clients/client-snowball/commands/UpdateClusterCommand.ts index cce40475b9b8c..d19b382a56a4f 100644 --- a/clients/client-snowball/commands/UpdateClusterCommand.ts +++ b/clients/client-snowball/commands/UpdateClusterCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateClusterCommandInput = UpdateClusterRequest; export type UpdateClusterCommandOutput = UpdateClusterResult & __MetadataBearer; +/** + *

While a cluster's ClusterState value is in the AwaitingQuorum + * state, you can update some of the information associated with a cluster. Once the cluster + * changes to a different job state, usually 60 minutes after the cluster being created, this + * action is no longer available.

+ */ export class UpdateClusterCommand extends $Command< UpdateClusterCommandInput, UpdateClusterCommandOutput, @@ -34,6 +40,9 @@ export class UpdateClusterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/UpdateJobCommand.ts b/clients/client-snowball/commands/UpdateJobCommand.ts index abf80ae820307..0c7cde9005ebc 100644 --- a/clients/client-snowball/commands/UpdateJobCommand.ts +++ b/clients/client-snowball/commands/UpdateJobCommand.ts @@ -17,6 +17,11 @@ import { export type UpdateJobCommandInput = UpdateJobRequest; export type UpdateJobCommandOutput = UpdateJobResult & __MetadataBearer; +/** + *

While a job's JobState value is New, you can update some of + * the information associated with a job. Once the job changes to a different job state, usually + * within 60 minutes of the job being created, this action is no longer available.

+ */ export class UpdateJobCommand extends $Command< UpdateJobCommandInput, UpdateJobCommandOutput, @@ -31,6 +36,9 @@ export class UpdateJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/commands/UpdateJobShipmentStateCommand.ts b/clients/client-snowball/commands/UpdateJobShipmentStateCommand.ts index 335de69b69fa4..a52831b76f3ca 100644 --- a/clients/client-snowball/commands/UpdateJobShipmentStateCommand.ts +++ b/clients/client-snowball/commands/UpdateJobShipmentStateCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateJobShipmentStateCommandInput = UpdateJobShipmentStateRequest; export type UpdateJobShipmentStateCommandOutput = UpdateJobShipmentStateResult & __MetadataBearer; +/** + *

Updates the state when a the shipment states changes to a different state.

+ */ export class UpdateJobShipmentStateCommand extends $Command< UpdateJobShipmentStateCommandInput, UpdateJobShipmentStateCommandOutput, @@ -34,6 +37,9 @@ export class UpdateJobShipmentStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SnowballClientResolvedConfig, diff --git a/clients/client-snowball/package.json b/clients/client-snowball/package.json index c789fc8fc6186..d5d736b84768f 100644 --- a/clients/client-snowball/package.json +++ b/clients/client-snowball/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Snowball Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-snowball/pagination/DescribeAddressesPaginator.ts b/clients/client-snowball/pagination/DescribeAddressesPaginator.ts index ac126bf371f30..cf01f38bbffcd 100644 --- a/clients/client-snowball/pagination/DescribeAddressesPaginator.ts +++ b/clients/client-snowball/pagination/DescribeAddressesPaginator.ts @@ -8,6 +8,9 @@ import { import { SnowballPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SnowballClient, input: DescribeAddressesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAddressesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Snowball, input: DescribeAddressesCommandInput, diff --git a/clients/client-snowball/pagination/ListJobsPaginator.ts b/clients/client-snowball/pagination/ListJobsPaginator.ts index bbf3a53028851..d0cf811a1acaa 100644 --- a/clients/client-snowball/pagination/ListJobsPaginator.ts +++ b/clients/client-snowball/pagination/ListJobsPaginator.ts @@ -4,6 +4,9 @@ import { ListJobsCommand, ListJobsCommandInput, ListJobsCommandOutput } from ".. import { SnowballPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SnowballClient, input: ListJobsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Snowball, input: ListJobsCommandInput, diff --git a/clients/client-snowball/runtimeConfig.browser.ts b/clients/client-snowball/runtimeConfig.browser.ts index 2e284a0fa1ef1..3c9f4976635f8 100644 --- a/clients/client-snowball/runtimeConfig.browser.ts +++ b/clients/client-snowball/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SnowballClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-snowball/runtimeConfig.native.ts b/clients/client-snowball/runtimeConfig.native.ts index 5080940c4df08..ec4eea64dda56 100644 --- a/clients/client-snowball/runtimeConfig.native.ts +++ b/clients/client-snowball/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SnowballClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-snowball/runtimeConfig.shared.ts b/clients/client-snowball/runtimeConfig.shared.ts index 6f76da5587e72..9ce339128223d 100644 --- a/clients/client-snowball/runtimeConfig.shared.ts +++ b/clients/client-snowball/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-06-30", disableHostPrefix: false, diff --git a/clients/client-snowball/runtimeConfig.ts b/clients/client-snowball/runtimeConfig.ts index 056ddae237dba..5bb03ff898395 100644 --- a/clients/client-snowball/runtimeConfig.ts +++ b/clients/client-snowball/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SnowballClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-snowball/tsconfig.json b/clients/client-snowball/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-snowball/tsconfig.json +++ b/clients/client-snowball/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sns/commands/AddPermissionCommand.ts b/clients/client-sns/commands/AddPermissionCommand.ts index 7a9128626e619..589f316337731 100644 --- a/clients/client-sns/commands/AddPermissionCommand.ts +++ b/clients/client-sns/commands/AddPermissionCommand.ts @@ -20,6 +20,10 @@ import { export type AddPermissionCommandInput = AddPermissionInput; export type AddPermissionCommandOutput = __MetadataBearer; +/** + *

Adds a statement to a topic's access control policy, granting access for the specified + * AWS accounts to the specified actions.

+ */ export class AddPermissionCommand extends $Command< AddPermissionCommandInput, AddPermissionCommandOutput, @@ -34,6 +38,9 @@ export class AddPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/CheckIfPhoneNumberIsOptedOutCommand.ts b/clients/client-sns/commands/CheckIfPhoneNumberIsOptedOutCommand.ts index 1d16ad36d28a0..42f8f603415a1 100644 --- a/clients/client-sns/commands/CheckIfPhoneNumberIsOptedOutCommand.ts +++ b/clients/client-sns/commands/CheckIfPhoneNumberIsOptedOutCommand.ts @@ -20,6 +20,13 @@ import { export type CheckIfPhoneNumberIsOptedOutCommandInput = CheckIfPhoneNumberIsOptedOutInput; export type CheckIfPhoneNumberIsOptedOutCommandOutput = CheckIfPhoneNumberIsOptedOutResponse & __MetadataBearer; +/** + *

Accepts a phone number and indicates whether the phone holder has opted out of + * receiving SMS messages from your account. You cannot send SMS messages to a number that + * is opted out.

+ *

To resume sending messages, you can opt in the number by using the + * OptInPhoneNumber action.

+ */ export class CheckIfPhoneNumberIsOptedOutCommand extends $Command< CheckIfPhoneNumberIsOptedOutCommandInput, CheckIfPhoneNumberIsOptedOutCommandOutput, @@ -34,6 +41,9 @@ export class CheckIfPhoneNumberIsOptedOutCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/ConfirmSubscriptionCommand.ts b/clients/client-sns/commands/ConfirmSubscriptionCommand.ts index 2873ffbc7d110..573e14b12c88f 100644 --- a/clients/client-sns/commands/ConfirmSubscriptionCommand.ts +++ b/clients/client-sns/commands/ConfirmSubscriptionCommand.ts @@ -20,6 +20,13 @@ import { export type ConfirmSubscriptionCommandInput = ConfirmSubscriptionInput; export type ConfirmSubscriptionCommandOutput = ConfirmSubscriptionResponse & __MetadataBearer; +/** + *

Verifies an endpoint owner's intent to receive messages by validating the token sent + * to the endpoint by an earlier Subscribe action. If the token is valid, the + * action creates a new subscription and returns its Amazon Resource Name (ARN). This call + * requires an AWS signature only when the AuthenticateOnUnsubscribe flag is + * set to "true".

+ */ export class ConfirmSubscriptionCommand extends $Command< ConfirmSubscriptionCommandInput, ConfirmSubscriptionCommandOutput, @@ -34,6 +41,9 @@ export class ConfirmSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/CreatePlatformApplicationCommand.ts b/clients/client-sns/commands/CreatePlatformApplicationCommand.ts index 90403989924a7..332751c401f21 100644 --- a/clients/client-sns/commands/CreatePlatformApplicationCommand.ts +++ b/clients/client-sns/commands/CreatePlatformApplicationCommand.ts @@ -20,6 +20,47 @@ import { export type CreatePlatformApplicationCommandInput = CreatePlatformApplicationInput; export type CreatePlatformApplicationCommandOutput = CreatePlatformApplicationResponse & __MetadataBearer; +/** + *

Creates a platform application object for one of the supported push notification services, + * such as APNS and GCM (Firebase Cloud Messaging), to which devices and mobile apps may register. + * You must specify PlatformPrincipal and PlatformCredential attributes + * when using the CreatePlatformApplication action.

+ *

+ * PlatformPrincipal and PlatformCredential are received from + * the notification service.

+ *
    + *
  • + *

    For ADM, PlatformPrincipal is client id + * and PlatformCredential is client secret.

    + *
  • + *
  • + *

    For Baidu, PlatformPrincipal is API key + * and PlatformCredential is secret key.

    + *
  • + *
  • + *

    For APNS and APNS_SANDBOX, + * PlatformPrincipal is SSL certificate and + * PlatformCredential is private key.

    + *
  • + *
  • + *

    For GCM (Firebase Cloud Messaging), there is no + * PlatformPrincipal and the PlatformCredential is + * API key.

    + *
  • + *
  • + *

    For MPNS, PlatformPrincipal is TLS + * certificate and PlatformCredential is private + * key.

    + *
  • + *
  • + *

    For WNS, PlatformPrincipal is Package Security + * Identifier and PlatformCredential is secret + * key.

    + *
  • + *
+ *

You can use the returned PlatformApplicationArn as an attribute for the + * CreatePlatformEndpoint action.

+ */ export class CreatePlatformApplicationCommand extends $Command< CreatePlatformApplicationCommandInput, CreatePlatformApplicationCommandOutput, @@ -34,6 +75,9 @@ export class CreatePlatformApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/CreatePlatformEndpointCommand.ts b/clients/client-sns/commands/CreatePlatformEndpointCommand.ts index 89c3d23def026..28915388ae019 100644 --- a/clients/client-sns/commands/CreatePlatformEndpointCommand.ts +++ b/clients/client-sns/commands/CreatePlatformEndpointCommand.ts @@ -20,6 +20,22 @@ import { export type CreatePlatformEndpointCommandInput = CreatePlatformEndpointInput; export type CreatePlatformEndpointCommandOutput = CreateEndpointResponse & __MetadataBearer; +/** + *

Creates an endpoint for a device and mobile app on one of the supported push + * notification services, such as GCM (Firebase Cloud Messaging) and APNS. + * CreatePlatformEndpoint requires the PlatformApplicationArn + * that is returned from CreatePlatformApplication. You can use the returned + * EndpointArn to send a message to a mobile app or by the + * Subscribe action for subscription to a topic. The + * CreatePlatformEndpoint action is idempotent, so if the requester + * already owns an endpoint with the same device token and attributes, that endpoint's ARN + * is returned without creating a new endpoint. For more information, see Using Amazon SNS Mobile Push + * Notifications.

+ *

When using CreatePlatformEndpoint with Baidu, two attributes must be + * provided: ChannelId and UserId. The token field must also contain the ChannelId. For + * more information, see Creating an Amazon SNS Endpoint + * for Baidu.

+ */ export class CreatePlatformEndpointCommand extends $Command< CreatePlatformEndpointCommandInput, CreatePlatformEndpointCommandOutput, @@ -34,6 +50,9 @@ export class CreatePlatformEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/CreateTopicCommand.ts b/clients/client-sns/commands/CreateTopicCommand.ts index 0be4558274ab2..4ce663606eb81 100644 --- a/clients/client-sns/commands/CreateTopicCommand.ts +++ b/clients/client-sns/commands/CreateTopicCommand.ts @@ -17,6 +17,12 @@ import { export type CreateTopicCommandInput = CreateTopicInput; export type CreateTopicCommandOutput = CreateTopicResponse & __MetadataBearer; +/** + *

Creates a topic to which notifications can be published. Users can create at most + * 100,000 standard topics (at most 1,000 FIFO topics). For more information, see https://aws.amazon.com/sns. This action is idempotent, so if the requester + * already owns a topic with the specified name, that topic's ARN is returned without + * creating a new topic.

+ */ export class CreateTopicCommand extends $Command< CreateTopicCommandInput, CreateTopicCommandOutput, @@ -31,6 +37,9 @@ export class CreateTopicCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/DeleteEndpointCommand.ts b/clients/client-sns/commands/DeleteEndpointCommand.ts index 223df3d905790..baf208c6d84ac 100644 --- a/clients/client-sns/commands/DeleteEndpointCommand.ts +++ b/clients/client-sns/commands/DeleteEndpointCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteEndpointCommandInput = DeleteEndpointInput; export type DeleteEndpointCommandOutput = __MetadataBearer; +/** + *

Deletes the endpoint for a device and mobile app from Amazon SNS. This action is + * idempotent. For more information, see Using Amazon SNS Mobile Push + * Notifications.

+ *

When you delete an endpoint that is also subscribed to a topic, then you must also + * unsubscribe the endpoint from the topic.

+ */ export class DeleteEndpointCommand extends $Command< DeleteEndpointCommandInput, DeleteEndpointCommandOutput, @@ -34,6 +41,9 @@ export class DeleteEndpointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/DeletePlatformApplicationCommand.ts b/clients/client-sns/commands/DeletePlatformApplicationCommand.ts index 1beb38577eeda..6b618e9f31ca9 100644 --- a/clients/client-sns/commands/DeletePlatformApplicationCommand.ts +++ b/clients/client-sns/commands/DeletePlatformApplicationCommand.ts @@ -20,6 +20,12 @@ import { export type DeletePlatformApplicationCommandInput = DeletePlatformApplicationInput; export type DeletePlatformApplicationCommandOutput = __MetadataBearer; +/** + *

Deletes a platform application object for one of the supported push notification + * services, such as APNS and GCM (Firebase Cloud Messaging). For more information, see + * Using Amazon SNS + * Mobile Push Notifications.

+ */ export class DeletePlatformApplicationCommand extends $Command< DeletePlatformApplicationCommandInput, DeletePlatformApplicationCommandOutput, @@ -34,6 +40,9 @@ export class DeletePlatformApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/DeleteTopicCommand.ts b/clients/client-sns/commands/DeleteTopicCommand.ts index 309848831cb16..d8127e58dba84 100644 --- a/clients/client-sns/commands/DeleteTopicCommand.ts +++ b/clients/client-sns/commands/DeleteTopicCommand.ts @@ -17,6 +17,12 @@ import { export type DeleteTopicCommandInput = DeleteTopicInput; export type DeleteTopicCommandOutput = __MetadataBearer; +/** + *

Deletes a topic and all its subscriptions. Deleting a topic might prevent some + * messages previously sent to the topic from being delivered to subscribers. This action + * is idempotent, so deleting a topic that does not exist does not result in an + * error.

+ */ export class DeleteTopicCommand extends $Command< DeleteTopicCommandInput, DeleteTopicCommandOutput, @@ -31,6 +37,9 @@ export class DeleteTopicCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/GetEndpointAttributesCommand.ts b/clients/client-sns/commands/GetEndpointAttributesCommand.ts index a2fe62e605e0b..3b494eddb4034 100644 --- a/clients/client-sns/commands/GetEndpointAttributesCommand.ts +++ b/clients/client-sns/commands/GetEndpointAttributesCommand.ts @@ -20,6 +20,11 @@ import { export type GetEndpointAttributesCommandInput = GetEndpointAttributesInput; export type GetEndpointAttributesCommandOutput = GetEndpointAttributesResponse & __MetadataBearer; +/** + *

Retrieves the endpoint attributes for a device on one of the supported push + * notification services, such as GCM (Firebase Cloud Messaging) and APNS. For more + * information, see Using Amazon SNS Mobile Push Notifications.

+ */ export class GetEndpointAttributesCommand extends $Command< GetEndpointAttributesCommandInput, GetEndpointAttributesCommandOutput, @@ -34,6 +39,9 @@ export class GetEndpointAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/GetPlatformApplicationAttributesCommand.ts b/clients/client-sns/commands/GetPlatformApplicationAttributesCommand.ts index 8eb6b7ccab43c..ae7df431b8782 100644 --- a/clients/client-sns/commands/GetPlatformApplicationAttributesCommand.ts +++ b/clients/client-sns/commands/GetPlatformApplicationAttributesCommand.ts @@ -20,6 +20,11 @@ import { export type GetPlatformApplicationAttributesCommandInput = GetPlatformApplicationAttributesInput; export type GetPlatformApplicationAttributesCommandOutput = GetPlatformApplicationAttributesResponse & __MetadataBearer; +/** + *

Retrieves the attributes of the platform application object for the supported push + * notification services, such as APNS and GCM (Firebase Cloud Messaging). For more + * information, see Using Amazon SNS Mobile Push Notifications.

+ */ export class GetPlatformApplicationAttributesCommand extends $Command< GetPlatformApplicationAttributesCommandInput, GetPlatformApplicationAttributesCommandOutput, @@ -34,6 +39,9 @@ export class GetPlatformApplicationAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/GetSMSAttributesCommand.ts b/clients/client-sns/commands/GetSMSAttributesCommand.ts index bc39c7eaa5245..9d6862860fc5e 100644 --- a/clients/client-sns/commands/GetSMSAttributesCommand.ts +++ b/clients/client-sns/commands/GetSMSAttributesCommand.ts @@ -20,6 +20,10 @@ import { export type GetSMSAttributesCommandInput = GetSMSAttributesInput; export type GetSMSAttributesCommandOutput = GetSMSAttributesResponse & __MetadataBearer; +/** + *

Returns the settings for sending SMS messages from your account.

+ *

These settings are set with the SetSMSAttributes action.

+ */ export class GetSMSAttributesCommand extends $Command< GetSMSAttributesCommandInput, GetSMSAttributesCommandOutput, @@ -34,6 +38,9 @@ export class GetSMSAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/GetSubscriptionAttributesCommand.ts b/clients/client-sns/commands/GetSubscriptionAttributesCommand.ts index d960685132be4..2f451fec15336 100644 --- a/clients/client-sns/commands/GetSubscriptionAttributesCommand.ts +++ b/clients/client-sns/commands/GetSubscriptionAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type GetSubscriptionAttributesCommandInput = GetSubscriptionAttributesInput; export type GetSubscriptionAttributesCommandOutput = GetSubscriptionAttributesResponse & __MetadataBearer; +/** + *

Returns all of the properties of a subscription.

+ */ export class GetSubscriptionAttributesCommand extends $Command< GetSubscriptionAttributesCommandInput, GetSubscriptionAttributesCommandOutput, @@ -34,6 +37,9 @@ export class GetSubscriptionAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/GetTopicAttributesCommand.ts b/clients/client-sns/commands/GetTopicAttributesCommand.ts index 69719cf7a29a8..1912036a67b78 100644 --- a/clients/client-sns/commands/GetTopicAttributesCommand.ts +++ b/clients/client-sns/commands/GetTopicAttributesCommand.ts @@ -20,6 +20,10 @@ import { export type GetTopicAttributesCommandInput = GetTopicAttributesInput; export type GetTopicAttributesCommandOutput = GetTopicAttributesResponse & __MetadataBearer; +/** + *

Returns all of the properties of a topic. Topic properties returned might differ based + * on the authorization of the user.

+ */ export class GetTopicAttributesCommand extends $Command< GetTopicAttributesCommandInput, GetTopicAttributesCommandOutput, @@ -34,6 +38,9 @@ export class GetTopicAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/ListEndpointsByPlatformApplicationCommand.ts b/clients/client-sns/commands/ListEndpointsByPlatformApplicationCommand.ts index 998dff978b1a5..fcbcb8d6f75af 100644 --- a/clients/client-sns/commands/ListEndpointsByPlatformApplicationCommand.ts +++ b/clients/client-sns/commands/ListEndpointsByPlatformApplicationCommand.ts @@ -24,6 +24,18 @@ export type ListEndpointsByPlatformApplicationCommandInput = ListEndpointsByPlat export type ListEndpointsByPlatformApplicationCommandOutput = ListEndpointsByPlatformApplicationResponse & __MetadataBearer; +/** + *

Lists the endpoints and endpoint attributes for devices in a supported push + * notification service, such as GCM (Firebase Cloud Messaging) and APNS. The results for + * ListEndpointsByPlatformApplication are paginated and return a limited + * list of endpoints, up to 100. If additional records are available after the first page + * results, then a NextToken string will be returned. To receive the next page, you call + * ListEndpointsByPlatformApplication again using the NextToken string + * received from the previous call. When there are no more records to return, NextToken + * will be null. For more information, see Using Amazon SNS Mobile Push + * Notifications.

+ *

This action is throttled at 30 transactions per second (TPS).

+ */ export class ListEndpointsByPlatformApplicationCommand extends $Command< ListEndpointsByPlatformApplicationCommandInput, ListEndpointsByPlatformApplicationCommandOutput, @@ -38,6 +50,9 @@ export class ListEndpointsByPlatformApplicationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/ListPhoneNumbersOptedOutCommand.ts b/clients/client-sns/commands/ListPhoneNumbersOptedOutCommand.ts index 78f3938a07be8..7d4adcbc80804 100644 --- a/clients/client-sns/commands/ListPhoneNumbersOptedOutCommand.ts +++ b/clients/client-sns/commands/ListPhoneNumbersOptedOutCommand.ts @@ -20,6 +20,16 @@ import { export type ListPhoneNumbersOptedOutCommandInput = ListPhoneNumbersOptedOutInput; export type ListPhoneNumbersOptedOutCommandOutput = ListPhoneNumbersOptedOutResponse & __MetadataBearer; +/** + *

Returns a list of phone numbers that are opted out, meaning you cannot send SMS + * messages to them.

+ *

The results for ListPhoneNumbersOptedOut are paginated, and each page + * returns up to 100 phone numbers. If additional phone numbers are available after the + * first page of results, then a NextToken string will be returned. To receive + * the next page, you call ListPhoneNumbersOptedOut again using the + * NextToken string received from the previous call. When there are no + * more records to return, NextToken will be null.

+ */ export class ListPhoneNumbersOptedOutCommand extends $Command< ListPhoneNumbersOptedOutCommandInput, ListPhoneNumbersOptedOutCommandOutput, @@ -34,6 +44,9 @@ export class ListPhoneNumbersOptedOutCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/ListPlatformApplicationsCommand.ts b/clients/client-sns/commands/ListPlatformApplicationsCommand.ts index f8914e10c08db..95e3a0eed442b 100644 --- a/clients/client-sns/commands/ListPlatformApplicationsCommand.ts +++ b/clients/client-sns/commands/ListPlatformApplicationsCommand.ts @@ -20,6 +20,18 @@ import { export type ListPlatformApplicationsCommandInput = ListPlatformApplicationsInput; export type ListPlatformApplicationsCommandOutput = ListPlatformApplicationsResponse & __MetadataBearer; +/** + *

Lists the platform application objects for the supported push notification services, + * such as APNS and GCM (Firebase Cloud Messaging). The results for + * ListPlatformApplications are paginated and return a limited list of + * applications, up to 100. If additional records are available after the first page + * results, then a NextToken string will be returned. To receive the next page, you call + * ListPlatformApplications using the NextToken string received from the + * previous call. When there are no more records to return, NextToken will be + * null. For more information, see Using Amazon SNS Mobile Push + * Notifications.

+ *

This action is throttled at 15 transactions per second (TPS).

+ */ export class ListPlatformApplicationsCommand extends $Command< ListPlatformApplicationsCommandInput, ListPlatformApplicationsCommandOutput, @@ -34,6 +46,9 @@ export class ListPlatformApplicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/ListSubscriptionsByTopicCommand.ts b/clients/client-sns/commands/ListSubscriptionsByTopicCommand.ts index b14338a9b7c16..366d0dedc1fa0 100644 --- a/clients/client-sns/commands/ListSubscriptionsByTopicCommand.ts +++ b/clients/client-sns/commands/ListSubscriptionsByTopicCommand.ts @@ -20,6 +20,13 @@ import { export type ListSubscriptionsByTopicCommandInput = ListSubscriptionsByTopicInput; export type ListSubscriptionsByTopicCommandOutput = ListSubscriptionsByTopicResponse & __MetadataBearer; +/** + *

Returns a list of the subscriptions to a specific topic. Each call returns a limited + * list of subscriptions, up to 100. If there are more subscriptions, a + * NextToken is also returned. Use the NextToken parameter in + * a new ListSubscriptionsByTopic call to get further results.

+ *

This action is throttled at 30 transactions per second (TPS).

+ */ export class ListSubscriptionsByTopicCommand extends $Command< ListSubscriptionsByTopicCommandInput, ListSubscriptionsByTopicCommandOutput, @@ -34,6 +41,9 @@ export class ListSubscriptionsByTopicCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/ListSubscriptionsCommand.ts b/clients/client-sns/commands/ListSubscriptionsCommand.ts index 27410b5becde4..ec67dc067c0cd 100644 --- a/clients/client-sns/commands/ListSubscriptionsCommand.ts +++ b/clients/client-sns/commands/ListSubscriptionsCommand.ts @@ -20,6 +20,13 @@ import { export type ListSubscriptionsCommandInput = ListSubscriptionsInput; export type ListSubscriptionsCommandOutput = ListSubscriptionsResponse & __MetadataBearer; +/** + *

Returns a list of the requester's subscriptions. Each call returns a limited list of + * subscriptions, up to 100. If there are more subscriptions, a NextToken is + * also returned. Use the NextToken parameter in a new + * ListSubscriptions call to get further results.

+ *

This action is throttled at 30 transactions per second (TPS).

+ */ export class ListSubscriptionsCommand extends $Command< ListSubscriptionsCommandInput, ListSubscriptionsCommandOutput, @@ -34,6 +41,9 @@ export class ListSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/ListTagsForResourceCommand.ts b/clients/client-sns/commands/ListTagsForResourceCommand.ts index 370b01e75f1fe..58d0e633665a4 100644 --- a/clients/client-sns/commands/ListTagsForResourceCommand.ts +++ b/clients/client-sns/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

List all tags added to the specified Amazon SNS topic. For an overview, see + * Amazon SNS Tags in the + * Amazon Simple Notification Service Developer Guide.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/ListTopicsCommand.ts b/clients/client-sns/commands/ListTopicsCommand.ts index eb2c78ff9ca9a..34ff1eb7c1049 100644 --- a/clients/client-sns/commands/ListTopicsCommand.ts +++ b/clients/client-sns/commands/ListTopicsCommand.ts @@ -17,6 +17,13 @@ import { export type ListTopicsCommandInput = ListTopicsInput; export type ListTopicsCommandOutput = ListTopicsResponse & __MetadataBearer; +/** + *

Returns a list of the requester's topics. Each call returns a limited list of topics, + * up to 100. If there are more topics, a NextToken is also returned. Use the + * NextToken parameter in a new ListTopics call to get + * further results.

+ *

This action is throttled at 30 transactions per second (TPS).

+ */ export class ListTopicsCommand extends $Command< ListTopicsCommandInput, ListTopicsCommandOutput, @@ -31,6 +38,9 @@ export class ListTopicsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/OptInPhoneNumberCommand.ts b/clients/client-sns/commands/OptInPhoneNumberCommand.ts index 3538470fd294d..23e877e09bd02 100644 --- a/clients/client-sns/commands/OptInPhoneNumberCommand.ts +++ b/clients/client-sns/commands/OptInPhoneNumberCommand.ts @@ -20,6 +20,11 @@ import { export type OptInPhoneNumberCommandInput = OptInPhoneNumberInput; export type OptInPhoneNumberCommandOutput = OptInPhoneNumberResponse & __MetadataBearer; +/** + *

Use this request to opt in a phone number that is opted out, which enables you to + * resume sending SMS messages to the number.

+ *

You can opt in a phone number only once every 30 days.

+ */ export class OptInPhoneNumberCommand extends $Command< OptInPhoneNumberCommandInput, OptInPhoneNumberCommandOutput, @@ -34,6 +39,9 @@ export class OptInPhoneNumberCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/PublishCommand.ts b/clients/client-sns/commands/PublishCommand.ts index 2a71cea1063a7..c3a102db5ad1f 100644 --- a/clients/client-sns/commands/PublishCommand.ts +++ b/clients/client-sns/commands/PublishCommand.ts @@ -17,6 +17,26 @@ import { export type PublishCommandInput = PublishInput; export type PublishCommandOutput = PublishResponse & __MetadataBearer; +/** + *

Sends a message to an Amazon SNS topic, a text message (SMS message) directly to a phone + * number, or a message to a mobile platform endpoint (when you specify the + * TargetArn).

+ *

If you send a message to a topic, Amazon SNS delivers the message to each endpoint that is + * subscribed to the topic. The format of the message depends on the notification protocol + * for each subscribed endpoint.

+ *

When a messageId is returned, the message has been saved and Amazon SNS + * will attempt to deliver it shortly.

+ *

To use the Publish action for sending a message to a mobile endpoint, + * such as an app on a Kindle device or mobile phone, you must specify the EndpointArn for + * the TargetArn parameter. The EndpointArn is returned when making a call with the + * CreatePlatformEndpoint action. + *

+ *

For more information about formatting messages, see Send Custom + * Platform-Specific Payloads in Messages to Mobile Devices.

+ * + *

You can publish messages only to topics and endpoints in the same AWS Region.

+ *
+ */ export class PublishCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +47,9 @@ export class PublishCommand extends $Command, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/RemovePermissionCommand.ts b/clients/client-sns/commands/RemovePermissionCommand.ts index cb82f07cd0372..36a34d4f693c6 100644 --- a/clients/client-sns/commands/RemovePermissionCommand.ts +++ b/clients/client-sns/commands/RemovePermissionCommand.ts @@ -20,6 +20,9 @@ import { export type RemovePermissionCommandInput = RemovePermissionInput; export type RemovePermissionCommandOutput = __MetadataBearer; +/** + *

Removes a statement from a topic's access control policy.

+ */ export class RemovePermissionCommand extends $Command< RemovePermissionCommandInput, RemovePermissionCommandOutput, @@ -34,6 +37,9 @@ export class RemovePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/SetEndpointAttributesCommand.ts b/clients/client-sns/commands/SetEndpointAttributesCommand.ts index 298421da21981..0b3843e895b84 100644 --- a/clients/client-sns/commands/SetEndpointAttributesCommand.ts +++ b/clients/client-sns/commands/SetEndpointAttributesCommand.ts @@ -20,6 +20,11 @@ import { export type SetEndpointAttributesCommandInput = SetEndpointAttributesInput; export type SetEndpointAttributesCommandOutput = __MetadataBearer; +/** + *

Sets the attributes for an endpoint for a device on one of the supported push + * notification services, such as GCM (Firebase Cloud Messaging) and APNS. For more + * information, see Using Amazon SNS Mobile Push Notifications.

+ */ export class SetEndpointAttributesCommand extends $Command< SetEndpointAttributesCommandInput, SetEndpointAttributesCommandOutput, @@ -34,6 +39,9 @@ export class SetEndpointAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/SetPlatformApplicationAttributesCommand.ts b/clients/client-sns/commands/SetPlatformApplicationAttributesCommand.ts index 25cc3660193e6..6f3714307c0df 100644 --- a/clients/client-sns/commands/SetPlatformApplicationAttributesCommand.ts +++ b/clients/client-sns/commands/SetPlatformApplicationAttributesCommand.ts @@ -20,6 +20,13 @@ import { export type SetPlatformApplicationAttributesCommandInput = SetPlatformApplicationAttributesInput; export type SetPlatformApplicationAttributesCommandOutput = __MetadataBearer; +/** + *

Sets the attributes of the platform application object for the supported push + * notification services, such as APNS and GCM (Firebase Cloud Messaging). For more + * information, see Using Amazon SNS Mobile Push Notifications. For information on configuring + * attributes for message delivery status, see Using Amazon SNS Application Attributes for + * Message Delivery Status.

+ */ export class SetPlatformApplicationAttributesCommand extends $Command< SetPlatformApplicationAttributesCommandInput, SetPlatformApplicationAttributesCommandOutput, @@ -34,6 +41,9 @@ export class SetPlatformApplicationAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/SetSMSAttributesCommand.ts b/clients/client-sns/commands/SetSMSAttributesCommand.ts index 9ac4cc05358f7..935a829231b69 100644 --- a/clients/client-sns/commands/SetSMSAttributesCommand.ts +++ b/clients/client-sns/commands/SetSMSAttributesCommand.ts @@ -20,6 +20,14 @@ import { export type SetSMSAttributesCommandInput = SetSMSAttributesInput; export type SetSMSAttributesCommandOutput = SetSMSAttributesResponse & __MetadataBearer; +/** + *

Use this request to set the default settings for sending SMS messages and receiving + * daily SMS usage reports.

+ *

You can override some of these settings for a single message when you use the + * Publish action with the MessageAttributes.entry.N + * parameter. For more information, see Publishing to a mobile phone in the + * Amazon SNS Developer Guide.

+ */ export class SetSMSAttributesCommand extends $Command< SetSMSAttributesCommandInput, SetSMSAttributesCommandOutput, @@ -34,6 +42,9 @@ export class SetSMSAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/SetSubscriptionAttributesCommand.ts b/clients/client-sns/commands/SetSubscriptionAttributesCommand.ts index f680e966e0cc0..248499701fd2e 100644 --- a/clients/client-sns/commands/SetSubscriptionAttributesCommand.ts +++ b/clients/client-sns/commands/SetSubscriptionAttributesCommand.ts @@ -20,6 +20,10 @@ import { export type SetSubscriptionAttributesCommandInput = SetSubscriptionAttributesInput; export type SetSubscriptionAttributesCommandOutput = __MetadataBearer; +/** + *

Allows a subscription owner to set an attribute of the subscription to a new + * value.

+ */ export class SetSubscriptionAttributesCommand extends $Command< SetSubscriptionAttributesCommandInput, SetSubscriptionAttributesCommandOutput, @@ -34,6 +38,9 @@ export class SetSubscriptionAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/SetTopicAttributesCommand.ts b/clients/client-sns/commands/SetTopicAttributesCommand.ts index 16ebee2f3c2f5..67333fe3b1483 100644 --- a/clients/client-sns/commands/SetTopicAttributesCommand.ts +++ b/clients/client-sns/commands/SetTopicAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type SetTopicAttributesCommandInput = SetTopicAttributesInput; export type SetTopicAttributesCommandOutput = __MetadataBearer; +/** + *

Allows a topic owner to set an attribute of the topic to a new value.

+ */ export class SetTopicAttributesCommand extends $Command< SetTopicAttributesCommandInput, SetTopicAttributesCommandOutput, @@ -34,6 +37,9 @@ export class SetTopicAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/SubscribeCommand.ts b/clients/client-sns/commands/SubscribeCommand.ts index 90550fb0f5827..cad763d275eb6 100644 --- a/clients/client-sns/commands/SubscribeCommand.ts +++ b/clients/client-sns/commands/SubscribeCommand.ts @@ -17,6 +17,14 @@ import { export type SubscribeCommandInput = SubscribeInput; export type SubscribeCommandOutput = SubscribeResponse & __MetadataBearer; +/** + *

Subscribes an endpoint to an Amazon SNS topic. If the endpoint type is HTTP/S or email, or + * if the endpoint and the topic are not in the same AWS account, the endpoint owner must + * run the ConfirmSubscription action to confirm the subscription.

+ *

You call the ConfirmSubscription action with the token from the subscription response. + * Confirmation tokens are valid for three days.

+ *

This action is throttled at 100 transactions per second (TPS).

+ */ export class SubscribeCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +35,9 @@ export class SubscribeCommand extends $Command, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/TagResourceCommand.ts b/clients/client-sns/commands/TagResourceCommand.ts index 6c2793185337f..e4883cb9f67e1 100644 --- a/clients/client-sns/commands/TagResourceCommand.ts +++ b/clients/client-sns/commands/TagResourceCommand.ts @@ -17,6 +17,32 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Add tags to the specified Amazon SNS topic. For an overview, see + * Amazon SNS Tags in the + * Amazon SNS Developer Guide.

+ *

When you use topic tags, keep the following guidelines in mind:

+ *
    + *
  • + *

    Adding more than 50 tags to a topic isn't recommended.

    + *
  • + *
  • + *

    Tags don't have any semantic meaning. Amazon SNS interprets tags as character + * strings.

    + *
  • + *
  • + *

    Tags are case-sensitive.

    + *
  • + *
  • + *

    A new tag with a key identical to that of an existing tag overwrites the + * existing tag.

    + *
  • + *
  • + *

    Tagging actions are limited to 10 TPS per AWS account, per AWS region. If your application + * requires a higher throughput, file a technical support request.

    + *
  • + *
+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -31,6 +57,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/UnsubscribeCommand.ts b/clients/client-sns/commands/UnsubscribeCommand.ts index 5c7c26d26d004..0bffa0ed1ba30 100644 --- a/clients/client-sns/commands/UnsubscribeCommand.ts +++ b/clients/client-sns/commands/UnsubscribeCommand.ts @@ -17,6 +17,15 @@ import { export type UnsubscribeCommandInput = UnsubscribeInput; export type UnsubscribeCommandOutput = __MetadataBearer; +/** + *

Deletes a subscription. If the subscription requires authentication for deletion, only + * the owner of the subscription or the topic's owner can unsubscribe, and an AWS signature + * is required. If the Unsubscribe call does not require authentication and + * the requester is not the subscription owner, a final cancellation message is delivered + * to the endpoint, so that the endpoint owner can easily resubscribe to the topic if the + * Unsubscribe request was unintended.

+ *

This action is throttled at 100 transactions per second (TPS).

+ */ export class UnsubscribeCommand extends $Command< UnsubscribeCommandInput, UnsubscribeCommandOutput, @@ -31,6 +40,9 @@ export class UnsubscribeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/commands/UntagResourceCommand.ts b/clients/client-sns/commands/UntagResourceCommand.ts index 36e0b241dbe2f..9777af594c4c3 100644 --- a/clients/client-sns/commands/UntagResourceCommand.ts +++ b/clients/client-sns/commands/UntagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Remove tags from the specified Amazon SNS topic. For an overview, see + * Amazon SNS Tags in the + * Amazon SNS Developer Guide.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SNSClientResolvedConfig, diff --git a/clients/client-sns/package.json b/clients/client-sns/package.json index cb942c46a9d7d..a9c444613cc42 100644 --- a/clients/client-sns/package.json +++ b/clients/client-sns/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sns Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sns/pagination/ListEndpointsByPlatformApplicationPaginator.ts b/clients/client-sns/pagination/ListEndpointsByPlatformApplicationPaginator.ts index d22b7e04ea6ca..b1df08f6b6bcc 100644 --- a/clients/client-sns/pagination/ListEndpointsByPlatformApplicationPaginator.ts +++ b/clients/client-sns/pagination/ListEndpointsByPlatformApplicationPaginator.ts @@ -8,6 +8,9 @@ import { import { SNSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SNSClient, input: ListEndpointsByPlatformApplicationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListEndpointsByPlatformApplicationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SNS, input: ListEndpointsByPlatformApplicationCommandInput, diff --git a/clients/client-sns/pagination/ListPlatformApplicationsPaginator.ts b/clients/client-sns/pagination/ListPlatformApplicationsPaginator.ts index 130d151165294..143621628423d 100644 --- a/clients/client-sns/pagination/ListPlatformApplicationsPaginator.ts +++ b/clients/client-sns/pagination/ListPlatformApplicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SNSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SNSClient, input: ListPlatformApplicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPlatformApplicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SNS, input: ListPlatformApplicationsCommandInput, diff --git a/clients/client-sns/pagination/ListSubscriptionsByTopicPaginator.ts b/clients/client-sns/pagination/ListSubscriptionsByTopicPaginator.ts index 507d2aa10b058..bb015e7af31ee 100644 --- a/clients/client-sns/pagination/ListSubscriptionsByTopicPaginator.ts +++ b/clients/client-sns/pagination/ListSubscriptionsByTopicPaginator.ts @@ -8,6 +8,9 @@ import { import { SNSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SNSClient, input: ListSubscriptionsByTopicCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSubscriptionsByTopicCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SNS, input: ListSubscriptionsByTopicCommandInput, diff --git a/clients/client-sns/pagination/ListSubscriptionsPaginator.ts b/clients/client-sns/pagination/ListSubscriptionsPaginator.ts index d5b644dd9ec00..34b462c76349d 100644 --- a/clients/client-sns/pagination/ListSubscriptionsPaginator.ts +++ b/clients/client-sns/pagination/ListSubscriptionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SNSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SNSClient, input: ListSubscriptionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSubscriptionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SNS, input: ListSubscriptionsCommandInput, diff --git a/clients/client-sns/pagination/ListTopicsPaginator.ts b/clients/client-sns/pagination/ListTopicsPaginator.ts index eafdfd5c5ec94..9c196d56bd5db 100644 --- a/clients/client-sns/pagination/ListTopicsPaginator.ts +++ b/clients/client-sns/pagination/ListTopicsPaginator.ts @@ -4,6 +4,9 @@ import { ListTopicsCommand, ListTopicsCommandInput, ListTopicsCommandOutput } fr import { SNSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SNSClient, input: ListTopicsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTopicsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SNS, input: ListTopicsCommandInput, diff --git a/clients/client-sns/runtimeConfig.browser.ts b/clients/client-sns/runtimeConfig.browser.ts index c0d6db9556ef4..945dea6806d76 100644 --- a/clients/client-sns/runtimeConfig.browser.ts +++ b/clients/client-sns/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SNSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sns/runtimeConfig.native.ts b/clients/client-sns/runtimeConfig.native.ts index 035b0b4a3cab5..afffe39183728 100644 --- a/clients/client-sns/runtimeConfig.native.ts +++ b/clients/client-sns/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SNSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sns/runtimeConfig.shared.ts b/clients/client-sns/runtimeConfig.shared.ts index 8ef3cd2624db9..cec88f4886b76 100644 --- a/clients/client-sns/runtimeConfig.shared.ts +++ b/clients/client-sns/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2010-03-31", disableHostPrefix: false, diff --git a/clients/client-sns/runtimeConfig.ts b/clients/client-sns/runtimeConfig.ts index 4cdc6904ef873..9cdebd29a8028 100644 --- a/clients/client-sns/runtimeConfig.ts +++ b/clients/client-sns/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SNSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sns/tsconfig.json b/clients/client-sns/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sns/tsconfig.json +++ b/clients/client-sns/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sqs/commands/AddPermissionCommand.ts b/clients/client-sqs/commands/AddPermissionCommand.ts index 09ff5081dbe03..6edd1bc206d42 100644 --- a/clients/client-sqs/commands/AddPermissionCommand.ts +++ b/clients/client-sqs/commands/AddPermissionCommand.ts @@ -20,6 +20,46 @@ import { export type AddPermissionCommandInput = AddPermissionRequest; export type AddPermissionCommandOutput = __MetadataBearer; +/** + *

Adds a permission to a queue for a specific + * principal. + * This allows sharing access to the queue.

+ *

When you create a queue, you have full control access rights for the queue. + * Only you, the owner of the queue, can grant or deny permissions to the queue. + * For more information about these permissions, see + * Allow + * Developers to Write Messages to a Shared Queue in the Amazon Simple Queue Service Developer Guide.

+ * + *
    + *
  • + *

    + * AddPermission generates a policy for you. You can use + * + * SetQueueAttributes + * to + * upload your policy. For more information, see + * Using Custom Policies with the Amazon SQS Access Policy Language in + * the Amazon Simple Queue Service Developer Guide.

    + *
  • + *
  • + *

    An Amazon SQS policy can have a maximum of 7 actions.

    + *
  • + *
  • + *

    To remove the ability to change queue permissions, you must deny permission to the AddPermission, RemovePermission, and SetQueueAttributes actions in your IAM policy.

    + *
  • + *
+ *
+ *

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

+ *

+ * &AttributeName.1=first + *

+ *

+ * &AttributeName.2=second + *

+ * + *

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

+ *
+ */ export class AddPermissionCommand extends $Command< AddPermissionCommandInput, AddPermissionCommandOutput, @@ -34,6 +74,9 @@ export class AddPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/ChangeMessageVisibilityBatchCommand.ts b/clients/client-sqs/commands/ChangeMessageVisibilityBatchCommand.ts index d1a64946ec565..4159500ed2aba 100644 --- a/clients/client-sqs/commands/ChangeMessageVisibilityBatchCommand.ts +++ b/clients/client-sqs/commands/ChangeMessageVisibilityBatchCommand.ts @@ -20,6 +20,23 @@ import { export type ChangeMessageVisibilityBatchCommandInput = ChangeMessageVisibilityBatchRequest; export type ChangeMessageVisibilityBatchCommandOutput = ChangeMessageVisibilityBatchResult & __MetadataBearer; +/** + *

Changes the visibility timeout of multiple messages. This is a batch version of + * ChangeMessageVisibility. The result of the action on each message is reported individually in the response. + * You can send up to 10 + * ChangeMessageVisibility + * requests with each ChangeMessageVisibilityBatch action.

+ * + *

Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

+ *
+ *

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

+ *

+ * &AttributeName.1=first + *

+ *

+ * &AttributeName.2=second + *

+ */ export class ChangeMessageVisibilityBatchCommand extends $Command< ChangeMessageVisibilityBatchCommandInput, ChangeMessageVisibilityBatchCommandOutput, @@ -34,6 +51,9 @@ export class ChangeMessageVisibilityBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/ChangeMessageVisibilityCommand.ts b/clients/client-sqs/commands/ChangeMessageVisibilityCommand.ts index d639e42146e27..6a7759c93bf43 100644 --- a/clients/client-sqs/commands/ChangeMessageVisibilityCommand.ts +++ b/clients/client-sqs/commands/ChangeMessageVisibilityCommand.ts @@ -20,6 +20,42 @@ import { export type ChangeMessageVisibilityCommandInput = ChangeMessageVisibilityRequest; export type ChangeMessageVisibilityCommandOutput = __MetadataBearer; +/** + *

Changes the visibility timeout of a specified message in a queue to a new value. The + * default visibility timeout for a message is 30 seconds. The minimum is 0 seconds. The + * maximum is 12 hours. For more information, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

+ *

For example, you have a message with a visibility timeout of 5 minutes. After 3 + * minutes, you call ChangeMessageVisibility with a timeout of 10 minutes. You + * can continue to call ChangeMessageVisibility to extend the visibility + * timeout to the maximum allowed time. If you try to extend the visibility timeout beyond + * the maximum, your request is rejected.

+ *

An Amazon SQS message has three basic states:

+ *
    + *
  1. + *

    Sent to a queue by a producer.

    + *
  2. + *
  3. + *

    Received from the queue by a consumer.

    + *
  4. + *
  5. + *

    Deleted from the queue.

    + *
  6. + *
+ *

A message is considered to be stored after it is sent to a queue by a producer, but not yet received from the queue by a consumer (that is, between states 1 and 2). There is no limit to the number of stored messages. + * A message is considered to be in flight after it is received from a queue by a consumer, but not yet deleted from the queue (that is, between states 2 and 3). There is a limit to the number of inflight messages.

+ *

Limits that apply to inflight messages are unrelated to the unlimited number of stored messages.

+ *

For most standard queues (depending on queue traffic and message backlog), there can be a maximum of approximately 120,000 inflight messages (received from a queue by a consumer, but not yet deleted from the queue). + * If you reach this limit, Amazon SQS returns the OverLimit error message. + * To avoid reaching the limit, you should delete messages from the queue after they're processed. You can also increase the number of queues you use to process your messages. + * To request a limit increase, file a support request.

+ *

For FIFO queues, there can be a maximum of 20,000 inflight messages (received from a queue by a consumer, but not yet deleted from the queue). If you reach this limit, Amazon SQS returns no error messages.

+ * + * + *

If you attempt to set the VisibilityTimeout to a value greater than the maximum time left, Amazon SQS returns an error. Amazon SQS doesn't automatically recalculate and increase the timeout to the maximum remaining time.

+ *

Unlike with a queue, when you change the visibility timeout for a specific message the timeout value is applied immediately but isn't saved in memory for that message. If you don't delete a message after it is received, the visibility timeout + * for the message reverts to the original timeout value (not to the value you set using the ChangeMessageVisibility action) the next time the message is received.

+ *
+ */ export class ChangeMessageVisibilityCommand extends $Command< ChangeMessageVisibilityCommandInput, ChangeMessageVisibilityCommandOutput, @@ -34,6 +70,9 @@ export class ChangeMessageVisibilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/CreateQueueCommand.ts b/clients/client-sqs/commands/CreateQueueCommand.ts index 34c85cbcb7f6d..7452ef100ca38 100644 --- a/clients/client-sqs/commands/CreateQueueCommand.ts +++ b/clients/client-sqs/commands/CreateQueueCommand.ts @@ -17,6 +17,58 @@ import { export type CreateQueueCommandInput = CreateQueueRequest; export type CreateQueueCommandOutput = CreateQueueResult & __MetadataBearer; +/** + *

Creates a new standard or FIFO queue. You can pass one or more attributes in + * the request. Keep the following in mind:

+ *
    + *
  • + *

    If you don't specify the FifoQueue attribute, Amazon SQS creates a standard queue.

    + * + *

    You can't change the queue type after you create it and you can't convert + * an existing standard queue into a FIFO queue. You must either create a new + * FIFO queue for your application or delete your existing standard queue and + * recreate it as a FIFO queue. For more information, see Moving From a Standard Queue to a FIFO Queue in the + * Amazon Simple Queue Service Developer Guide.

    + *
    + *
  • + *
  • + *

    If you don't provide a value for an attribute, the queue is created with the default value for the attribute.

    + *
  • + *
  • + *

    If you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.

    + *
  • + *
+ * + *

To successfully create a new queue, you must provide a queue name that adheres to the limits related to queues and is unique within the scope of your queues.

+ * + *

After you create a queue, you must wait at least one second after the queue is + * created to be able to use the queue.

+ *
+ *

To get the queue URL, use the + * GetQueueUrl + * action. + * GetQueueUrl + * requires only the QueueName parameter. + * be aware of existing queue names:

+ *
    + *
  • + *

    If you provide the name of an existing queue along with the exact names and values of all the queue's attributes, CreateQueue returns the queue URL for the existing queue.

    + *
  • + *
  • + *

    If the queue name, attribute names, or attribute values don't match an existing queue, CreateQueue returns an error.

    + *
  • + *
+ *

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

+ *

+ * &AttributeName.1=first + *

+ *

+ * &AttributeName.2=second + *

+ * + *

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

+ *
+ */ export class CreateQueueCommand extends $Command< CreateQueueCommandInput, CreateQueueCommandOutput, @@ -31,6 +83,9 @@ export class CreateQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/DeleteMessageBatchCommand.ts b/clients/client-sqs/commands/DeleteMessageBatchCommand.ts index 8ddf385e879db..d8a1f08a6858b 100644 --- a/clients/client-sqs/commands/DeleteMessageBatchCommand.ts +++ b/clients/client-sqs/commands/DeleteMessageBatchCommand.ts @@ -20,6 +20,20 @@ import { export type DeleteMessageBatchCommandInput = DeleteMessageBatchRequest; export type DeleteMessageBatchCommandOutput = DeleteMessageBatchResult & __MetadataBearer; +/** + *

Deletes up to ten messages from the specified queue. This is a batch version of + * DeleteMessage. The result of the action on each message is reported individually in the response.

+ * + *

Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

+ *
+ *

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

+ *

+ * &AttributeName.1=first + *

+ *

+ * &AttributeName.2=second + *

+ */ export class DeleteMessageBatchCommand extends $Command< DeleteMessageBatchCommandInput, DeleteMessageBatchCommandOutput, @@ -34,6 +48,9 @@ export class DeleteMessageBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/DeleteMessageCommand.ts b/clients/client-sqs/commands/DeleteMessageCommand.ts index f6abe87aec8ef..519e8949ed986 100644 --- a/clients/client-sqs/commands/DeleteMessageCommand.ts +++ b/clients/client-sqs/commands/DeleteMessageCommand.ts @@ -20,6 +20,28 @@ import { export type DeleteMessageCommandInput = DeleteMessageRequest; export type DeleteMessageCommandOutput = __MetadataBearer; +/** + *

Deletes the specified message from the specified queue. To select the message to + * delete, use the ReceiptHandle of the message (not the + * MessageId which you receive when you send the message). Amazon SQS can + * delete a message from a queue even if a visibility timeout setting causes the message to + * be locked by another consumer. Amazon SQS automatically deletes messages left in a queue + * longer than the retention period configured for the queue.

+ * + *

The ReceiptHandle is associated with a specific + * instance of receiving a message. If you receive a message more than + * once, the ReceiptHandle is different each time you receive a message. + * When you use the DeleteMessage action, you must provide the most + * recently received ReceiptHandle for the message (otherwise, the request + * succeeds, but the message might not be deleted).

+ *

For standard queues, it is possible to receive a message even after you + * delete it. This might happen on rare occasions if one of the servers which stores a + * copy of the message is unavailable when you send the request to delete the message. + * The copy remains on the server and might be returned to you during a subsequent + * receive request. You should ensure that your application is idempotent, so that + * receiving a message more than once does not cause issues.

+ *
+ */ export class DeleteMessageCommand extends $Command< DeleteMessageCommandInput, DeleteMessageCommandOutput, @@ -34,6 +56,9 @@ export class DeleteMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/DeleteQueueCommand.ts b/clients/client-sqs/commands/DeleteQueueCommand.ts index 3111c46095d0c..e5d7487bd6383 100644 --- a/clients/client-sqs/commands/DeleteQueueCommand.ts +++ b/clients/client-sqs/commands/DeleteQueueCommand.ts @@ -17,6 +17,21 @@ import { export type DeleteQueueCommandInput = DeleteQueueRequest; export type DeleteQueueCommandOutput = __MetadataBearer; +/** + *

Deletes the queue specified by the QueueUrl, regardless of the queue's contents.

+ * + *

Be careful with the DeleteQueue action: When you delete a queue, any messages in the queue are no longer available. + *

+ *
+ *

When you delete a queue, the deletion process takes up to 60 seconds. Requests you send involving that queue during the 60 seconds might succeed. For example, a + * + * SendMessage + * request might succeed, but after 60 seconds the queue and the message you sent no longer exist.

+ *

When you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.

+ * + *

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

+ *
+ */ export class DeleteQueueCommand extends $Command< DeleteQueueCommandInput, DeleteQueueCommandOutput, @@ -31,6 +46,9 @@ export class DeleteQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/GetQueueAttributesCommand.ts b/clients/client-sqs/commands/GetQueueAttributesCommand.ts index 3143f7d6b3f25..cdc87b16fe1ef 100644 --- a/clients/client-sqs/commands/GetQueueAttributesCommand.ts +++ b/clients/client-sqs/commands/GetQueueAttributesCommand.ts @@ -20,6 +20,12 @@ import { export type GetQueueAttributesCommandInput = GetQueueAttributesRequest; export type GetQueueAttributesCommandOutput = GetQueueAttributesResult & __MetadataBearer; +/** + *

Gets attributes for the specified queue.

+ * + *

To determine whether a queue is FIFO, you can check whether QueueName ends with the .fifo suffix.

+ *
+ */ export class GetQueueAttributesCommand extends $Command< GetQueueAttributesCommandInput, GetQueueAttributesCommandOutput, @@ -34,6 +40,9 @@ export class GetQueueAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/GetQueueUrlCommand.ts b/clients/client-sqs/commands/GetQueueUrlCommand.ts index ef04b9288da2e..f1087dfaad6aa 100644 --- a/clients/client-sqs/commands/GetQueueUrlCommand.ts +++ b/clients/client-sqs/commands/GetQueueUrlCommand.ts @@ -17,6 +17,14 @@ import { export type GetQueueUrlCommandInput = GetQueueUrlRequest; export type GetQueueUrlCommandOutput = GetQueueUrlResult & __MetadataBearer; +/** + *

Returns the URL of an existing Amazon SQS queue.

+ *

To access a queue that belongs to another AWS account, use the QueueOwnerAWSAccountId parameter to specify the account ID of the queue's owner. The queue's owner must grant you permission to access the queue. + * For more information about shared queue access, see + * AddPermission + * or see Allow Developers to Write Messages to a Shared Queue in the Amazon Simple Queue Service Developer Guide. + *

+ */ export class GetQueueUrlCommand extends $Command< GetQueueUrlCommandInput, GetQueueUrlCommandOutput, @@ -31,6 +39,9 @@ export class GetQueueUrlCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/ListDeadLetterSourceQueuesCommand.ts b/clients/client-sqs/commands/ListDeadLetterSourceQueuesCommand.ts index a42a8092149f9..02f0a30018536 100644 --- a/clients/client-sqs/commands/ListDeadLetterSourceQueuesCommand.ts +++ b/clients/client-sqs/commands/ListDeadLetterSourceQueuesCommand.ts @@ -20,6 +20,19 @@ import { export type ListDeadLetterSourceQueuesCommandInput = ListDeadLetterSourceQueuesRequest; export type ListDeadLetterSourceQueuesCommandOutput = ListDeadLetterSourceQueuesResult & __MetadataBearer; +/** + *

Returns a list of your queues that have the RedrivePolicy queue attribute configured with a dead-letter queue.

+ *

The ListDeadLetterSourceQueues methods supports + * pagination. Set parameter MaxResults in the request to specify the maximum number of + * results to be returned in the response. If you do not set MaxResults, + * the response includes a maximum of 1,000 results. If you set MaxResults and there are additional results to + * display, the response includes a value for NextToken. Use + * NextToken as a parameter in your next request to + * ListDeadLetterSourceQueues to receive the next page of results.

+ * + *

For more information about using dead-letter queues, see Using Amazon SQS Dead-Letter Queues + * in the Amazon Simple Queue Service Developer Guide.

+ */ export class ListDeadLetterSourceQueuesCommand extends $Command< ListDeadLetterSourceQueuesCommandInput, ListDeadLetterSourceQueuesCommandOutput, @@ -34,6 +47,9 @@ export class ListDeadLetterSourceQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/ListQueueTagsCommand.ts b/clients/client-sqs/commands/ListQueueTagsCommand.ts index 462a1f7209d69..cd0cd5dbbbfb3 100644 --- a/clients/client-sqs/commands/ListQueueTagsCommand.ts +++ b/clients/client-sqs/commands/ListQueueTagsCommand.ts @@ -20,6 +20,12 @@ import { export type ListQueueTagsCommandInput = ListQueueTagsRequest; export type ListQueueTagsCommandOutput = ListQueueTagsResult & __MetadataBearer; +/** + *

List all cost allocation tags added to the specified Amazon SQS queue. For an overview, see Tagging Your Amazon SQS Queues in the Amazon Simple Queue Service Developer Guide.

+ * + *

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

+ *
+ */ export class ListQueueTagsCommand extends $Command< ListQueueTagsCommandInput, ListQueueTagsCommandOutput, @@ -34,6 +40,9 @@ export class ListQueueTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/ListQueuesCommand.ts b/clients/client-sqs/commands/ListQueuesCommand.ts index 0a1e31adae181..4f6ca1d1e5f3a 100644 --- a/clients/client-sqs/commands/ListQueuesCommand.ts +++ b/clients/client-sqs/commands/ListQueuesCommand.ts @@ -17,6 +17,20 @@ import { export type ListQueuesCommandInput = ListQueuesRequest; export type ListQueuesCommandOutput = ListQueuesResult & __MetadataBearer; +/** + *

Returns a list of your queues in the current region. The response includes a maximum of 1,000 results. If you specify a value for the optional + * QueueNamePrefix parameter, only queues with a name that begins with the specified value are returned.

+ *

The listQueues methods supports + * pagination. Set parameter MaxResults in the request to specify the maximum number of + * results to be returned in the response. If you do not set MaxResults, + * the response includes a maximum of 1,000 results. If you set MaxResults and there are additional results to + * display, the response includes a value for NextToken. Use + * NextToken as a parameter in your next request to + * listQueues to receive the next page of results.

+ * + *

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

+ *
+ */ export class ListQueuesCommand extends $Command< ListQueuesCommandInput, ListQueuesCommandOutput, @@ -31,6 +45,9 @@ export class ListQueuesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/PurgeQueueCommand.ts b/clients/client-sqs/commands/PurgeQueueCommand.ts index 0db0d1b46269c..bf39657cc5c7d 100644 --- a/clients/client-sqs/commands/PurgeQueueCommand.ts +++ b/clients/client-sqs/commands/PurgeQueueCommand.ts @@ -17,6 +17,22 @@ import { export type PurgeQueueCommandInput = PurgeQueueRequest; export type PurgeQueueCommandOutput = __MetadataBearer; +/** + *

Deletes the messages in a queue specified by the QueueURL + * parameter.

+ * + * + *

When you use the PurgeQueue action, you can't retrieve any messages + * deleted from a queue.

+ *

The message deletion process takes up to 60 seconds. We recommend waiting for + * 60 seconds regardless of your queue's size.

+ *
+ *

Messages sent to the queue before you call + * PurgeQueue might be received but are deleted within the next + * minute.

+ *

Messages sent to the queue after you call + * PurgeQueue might be deleted while the queue is being purged.

+ */ export class PurgeQueueCommand extends $Command< PurgeQueueCommandInput, PurgeQueueCommandOutput, @@ -31,6 +47,9 @@ export class PurgeQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/ReceiveMessageCommand.ts b/clients/client-sqs/commands/ReceiveMessageCommand.ts index 3ffc568e808f1..6a717ea0b9dbf 100644 --- a/clients/client-sqs/commands/ReceiveMessageCommand.ts +++ b/clients/client-sqs/commands/ReceiveMessageCommand.ts @@ -21,6 +21,44 @@ import { export type ReceiveMessageCommandInput = ReceiveMessageRequest; export type ReceiveMessageCommandOutput = ReceiveMessageResult & __MetadataBearer; +/** + *

Retrieves one or more messages (up to 10), from the specified queue. Using the WaitTimeSeconds parameter enables long-poll support. + * For more information, see Amazon SQS Long Polling in the Amazon Simple Queue Service Developer Guide. + *

+ *

Short poll is the default behavior where a weighted random set of machines is sampled on a ReceiveMessage call. Thus, only the messages on the sampled machines are returned. + * If the number of messages in the queue is small (fewer than 1,000), you most likely get fewer messages than you requested per ReceiveMessage call. If the number of messages in the queue is extremely small, + * you might not receive any messages in a particular ReceiveMessage response. If this happens, repeat the request. + *

+ *

For each message returned, the response includes the following:

+ *
    + *
  • + *

    The message body.

    + *
  • + *
  • + *

    An MD5 digest of the message body. For information about MD5, see RFC1321.

    + *
  • + *
  • + *

    The MessageId you received when you sent the message to the queue.

    + *
  • + *
  • + *

    The receipt handle.

    + *
  • + *
  • + *

    The message attributes.

    + *
  • + *
  • + *

    An MD5 digest of the message attributes.

    + *
  • + *
+ *

The receipt handle is the identifier you must provide when deleting the message. For more information, see Queue + * and Message Identifiers in the Amazon Simple Queue Service Developer Guide.

+ *

You can provide the VisibilityTimeout parameter in your request. The parameter is applied to the messages that Amazon SQS returns in the response. If you don't include the parameter, the overall visibility timeout for the queue + * is used for the returned messages. For more information, see Visibility Timeout in the Amazon Simple Queue Service Developer Guide.

+ *

A message that isn't deleted or a message whose visibility isn't extended before the visibility timeout expires counts as a failed receive. Depending on the configuration of the queue, the message might be sent to the dead-letter queue.

+ * + *

In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.

+ *
+ */ export class ReceiveMessageCommand extends $Command< ReceiveMessageCommandInput, ReceiveMessageCommandOutput, @@ -35,6 +73,9 @@ export class ReceiveMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/RemovePermissionCommand.ts b/clients/client-sqs/commands/RemovePermissionCommand.ts index af0a884c90694..e85c4a70e1ace 100644 --- a/clients/client-sqs/commands/RemovePermissionCommand.ts +++ b/clients/client-sqs/commands/RemovePermissionCommand.ts @@ -20,6 +20,22 @@ import { export type RemovePermissionCommandInput = RemovePermissionRequest; export type RemovePermissionCommandOutput = __MetadataBearer; +/** + *

Revokes any permissions in the queue policy that matches the specified Label parameter.

+ * + *
    + *
  • + *

    Only the owner of a queue can remove permissions from it.

    + *
  • + *
  • + *

    Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

    + *
  • + *
  • + *

    To remove the ability to change queue permissions, you must deny permission to the AddPermission, RemovePermission, and SetQueueAttributes actions in your IAM policy.

    + *
  • + *
+ *
+ */ export class RemovePermissionCommand extends $Command< RemovePermissionCommandInput, RemovePermissionCommandOutput, @@ -34,6 +50,9 @@ export class RemovePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/SendMessageBatchCommand.ts b/clients/client-sqs/commands/SendMessageBatchCommand.ts index 3132a83de74d2..0d3acca314509 100644 --- a/clients/client-sqs/commands/SendMessageBatchCommand.ts +++ b/clients/client-sqs/commands/SendMessageBatchCommand.ts @@ -21,6 +21,27 @@ import { export type SendMessageBatchCommandInput = SendMessageBatchRequest; export type SendMessageBatchCommandOutput = SendMessageBatchResult & __MetadataBearer; +/** + *

Delivers up to ten messages to the specified queue. This is a batch version of + * SendMessage. For a FIFO queue, multiple messages within a single batch are enqueued in the order they are sent.

+ *

The result of sending each message is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

+ *

The maximum allowed individual message size and the maximum total payload size (the sum of the individual lengths of all of the batched messages) are both 256 KB (262,144 bytes).

+ * + *

A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:

+ *

+ * #x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF + *

+ *

Any characters not included in this list will be rejected. For more information, see the W3C specification for characters.

+ *
+ *

If you don't specify the DelaySeconds parameter for an entry, Amazon SQS uses the default value for the queue.

+ *

Some actions take lists of parameters. These lists are specified using the param.n notation. Values of n are integers starting from 1. For example, a parameter list with two elements looks like this:

+ *

+ * &AttributeName.1=first + *

+ *

+ * &AttributeName.2=second + *

+ */ export class SendMessageBatchCommand extends $Command< SendMessageBatchCommandInput, SendMessageBatchCommandOutput, @@ -35,6 +56,9 @@ export class SendMessageBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/SendMessageCommand.ts b/clients/client-sqs/commands/SendMessageCommand.ts index 2d27453d80d96..2601a8cd76c3e 100644 --- a/clients/client-sqs/commands/SendMessageCommand.ts +++ b/clients/client-sqs/commands/SendMessageCommand.ts @@ -18,6 +18,16 @@ import { export type SendMessageCommandInput = SendMessageRequest; export type SendMessageCommandOutput = SendMessageResult & __MetadataBearer; +/** + *

Delivers a message to the specified queue.

+ * + *

A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed:

+ *

+ * #x9 | #xA | #xD | #x20 to #xD7FF | #xE000 to #xFFFD | #x10000 to #x10FFFF + *

+ *

Any characters not included in this list will be rejected. For more information, see the W3C specification for characters.

+ *
+ */ export class SendMessageCommand extends $Command< SendMessageCommandInput, SendMessageCommandOutput, @@ -32,6 +42,9 @@ export class SendMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/SetQueueAttributesCommand.ts b/clients/client-sqs/commands/SetQueueAttributesCommand.ts index 94ee25ad0ea11..1c94f27f4761d 100644 --- a/clients/client-sqs/commands/SetQueueAttributesCommand.ts +++ b/clients/client-sqs/commands/SetQueueAttributesCommand.ts @@ -20,6 +20,23 @@ import { export type SetQueueAttributesCommandInput = SetQueueAttributesRequest; export type SetQueueAttributesCommandOutput = __MetadataBearer; +/** + *

Sets the value of one or more queue attributes. When you change a queue's attributes, the change can take up to 60 seconds for most of the attributes to propagate throughout the Amazon SQS system. + * Changes made to the MessageRetentionPeriod attribute can take up to 15 minutes.

+ * + *
    + *
  • + *

    In the future, new attributes might be added. If you write code that calls this action, we recommend that you structure your code so that it can handle new attributes gracefully.

    + *
  • + *
  • + *

    Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

    + *
  • + *
  • + *

    To remove the ability to change queue permissions, you must deny permission to the AddPermission, RemovePermission, and SetQueueAttributes actions in your IAM policy.

    + *
  • + *
+ *
+ */ export class SetQueueAttributesCommand extends $Command< SetQueueAttributesCommandInput, SetQueueAttributesCommandOutput, @@ -34,6 +51,9 @@ export class SetQueueAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/TagQueueCommand.ts b/clients/client-sqs/commands/TagQueueCommand.ts index 5a5c3b6184d4d..42c217eed54e5 100644 --- a/clients/client-sqs/commands/TagQueueCommand.ts +++ b/clients/client-sqs/commands/TagQueueCommand.ts @@ -17,6 +17,29 @@ import { export type TagQueueCommandInput = TagQueueRequest; export type TagQueueCommandOutput = __MetadataBearer; +/** + *

Add cost allocation tags to the specified Amazon SQS queue. For an overview, see Tagging Your Amazon SQS Queues in the Amazon Simple Queue Service Developer Guide.

+ * + *

When you use queue tags, keep the following guidelines in mind:

+ *
    + *
  • + *

    Adding more than 50 tags to a queue isn't recommended.

    + *
  • + *
  • + *

    Tags don't have any semantic meaning. Amazon SQS interprets tags as character strings.

    + *
  • + *
  • + *

    Tags are case-sensitive.

    + *
  • + *
  • + *

    A new tag with a key identical to that of an existing tag overwrites the existing tag.

    + *
  • + *
+ *

For a full list of tag restrictions, see Limits Related to Queues in the Amazon Simple Queue Service Developer Guide.

+ * + *

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

+ *
+ */ export class TagQueueCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +50,9 @@ export class TagQueueCommand extends $Command, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/commands/UntagQueueCommand.ts b/clients/client-sqs/commands/UntagQueueCommand.ts index 95bb39479913e..13d6d7c735772 100644 --- a/clients/client-sqs/commands/UntagQueueCommand.ts +++ b/clients/client-sqs/commands/UntagQueueCommand.ts @@ -17,6 +17,12 @@ import { export type UntagQueueCommandInput = UntagQueueRequest; export type UntagQueueCommandOutput = __MetadataBearer; +/** + *

Remove cost allocation tags from the specified Amazon SQS queue. For an overview, see Tagging Your Amazon SQS Queues in the Amazon Simple Queue Service Developer Guide.

+ * + *

Cross-account permissions don't apply to this action. For more information, see Grant Cross-Account Permissions to a Role and a User Name in the Amazon Simple Queue Service Developer Guide.

+ *
+ */ export class UntagQueueCommand extends $Command< UntagQueueCommandInput, UntagQueueCommandOutput, @@ -31,6 +37,9 @@ export class UntagQueueCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SQSClientResolvedConfig, diff --git a/clients/client-sqs/package.json b/clients/client-sqs/package.json index d914140c0a2e9..0562bfd6ffff2 100644 --- a/clients/client-sqs/package.json +++ b/clients/client-sqs/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sqs Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sqs/pagination/ListDeadLetterSourceQueuesPaginator.ts b/clients/client-sqs/pagination/ListDeadLetterSourceQueuesPaginator.ts index 15f32f64e839a..56281d4db53f2 100644 --- a/clients/client-sqs/pagination/ListDeadLetterSourceQueuesPaginator.ts +++ b/clients/client-sqs/pagination/ListDeadLetterSourceQueuesPaginator.ts @@ -8,6 +8,9 @@ import { import { SQSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SQSClient, input: ListDeadLetterSourceQueuesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDeadLetterSourceQueuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SQS, input: ListDeadLetterSourceQueuesCommandInput, diff --git a/clients/client-sqs/pagination/ListQueuesPaginator.ts b/clients/client-sqs/pagination/ListQueuesPaginator.ts index 60137245d4f61..6bad17aac5ad1 100644 --- a/clients/client-sqs/pagination/ListQueuesPaginator.ts +++ b/clients/client-sqs/pagination/ListQueuesPaginator.ts @@ -4,6 +4,9 @@ import { ListQueuesCommand, ListQueuesCommandInput, ListQueuesCommandOutput } fr import { SQSPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SQSClient, input: ListQueuesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListQueuesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SQS, input: ListQueuesCommandInput, diff --git a/clients/client-sqs/runtimeConfig.browser.ts b/clients/client-sqs/runtimeConfig.browser.ts index d06f03cb9cac7..83a34c17e1f4b 100644 --- a/clients/client-sqs/runtimeConfig.browser.ts +++ b/clients/client-sqs/runtimeConfig.browser.ts @@ -13,6 +13,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SQSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sqs/runtimeConfig.native.ts b/clients/client-sqs/runtimeConfig.native.ts index 8712c5928a50a..382075f732688 100644 --- a/clients/client-sqs/runtimeConfig.native.ts +++ b/clients/client-sqs/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SQSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sqs/runtimeConfig.shared.ts b/clients/client-sqs/runtimeConfig.shared.ts index 743a652924512..e8ef54f1ba96d 100644 --- a/clients/client-sqs/runtimeConfig.shared.ts +++ b/clients/client-sqs/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-11-05", disableHostPrefix: false, diff --git a/clients/client-sqs/runtimeConfig.ts b/clients/client-sqs/runtimeConfig.ts index dcfff9c1b1b10..1bd7ef89c53b4 100644 --- a/clients/client-sqs/runtimeConfig.ts +++ b/clients/client-sqs/runtimeConfig.ts @@ -15,6 +15,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SQSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sqs/tsconfig.json b/clients/client-sqs/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sqs/tsconfig.json +++ b/clients/client-sqs/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-ssm/commands/AddTagsToResourceCommand.ts b/clients/client-ssm/commands/AddTagsToResourceCommand.ts index 6e95dffa1f0d6..68a6910d8c524 100644 --- a/clients/client-ssm/commands/AddTagsToResourceCommand.ts +++ b/clients/client-ssm/commands/AddTagsToResourceCommand.ts @@ -20,6 +20,24 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceRequest; export type AddTagsToResourceCommandOutput = AddTagsToResourceResult & __MetadataBearer; +/** + *

Adds or overwrites one or more tags for the specified resource. Tags are metadata that you + * can assign to your documents, managed instances, maintenance windows, Parameter Store parameters, + * and patch baselines. Tags enable you to categorize your resources in different ways, for example, + * by purpose, owner, or environment. Each tag consists of a key and an optional value, both of + * which you define. For example, you could define a set of tags for your account's managed + * instances that helps you track each instance's owner and stack level. For example: Key=Owner and + * Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production, or + * Test.

+ * + *

Each resource can have a maximum of 50 tags.

+ *

We recommend that you devise a set of tag keys that meets your needs for each resource type. + * Using a consistent set of tag keys makes it easier for you to manage your resources. You can + * search and filter the resources based on the tags you add. Tags don't have any semantic meaning + * to and are interpreted strictly as a string of characters.

+ *

For more information about using tags with EC2 instances, see Tagging your Amazon EC2 resources in the + * Amazon EC2 User Guide.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -34,6 +52,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CancelCommandCommand.ts b/clients/client-ssm/commands/CancelCommandCommand.ts index 8ba7fcb57325d..873ba101862f4 100644 --- a/clients/client-ssm/commands/CancelCommandCommand.ts +++ b/clients/client-ssm/commands/CancelCommandCommand.ts @@ -20,6 +20,10 @@ import { export type CancelCommandCommandInput = CancelCommandRequest; export type CancelCommandCommandOutput = CancelCommandResult & __MetadataBearer; +/** + *

Attempts to cancel the command specified by the Command ID. There is no guarantee that the + * command will be terminated and the underlying process stopped.

+ */ export class CancelCommandCommand extends $Command< CancelCommandCommandInput, CancelCommandCommandOutput, @@ -34,6 +38,9 @@ export class CancelCommandCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CancelMaintenanceWindowExecutionCommand.ts b/clients/client-ssm/commands/CancelMaintenanceWindowExecutionCommand.ts index 5dc0147fab11c..f8d373fb53438 100644 --- a/clients/client-ssm/commands/CancelMaintenanceWindowExecutionCommand.ts +++ b/clients/client-ssm/commands/CancelMaintenanceWindowExecutionCommand.ts @@ -20,6 +20,11 @@ import { export type CancelMaintenanceWindowExecutionCommandInput = CancelMaintenanceWindowExecutionRequest; export type CancelMaintenanceWindowExecutionCommandOutput = CancelMaintenanceWindowExecutionResult & __MetadataBearer; +/** + *

Stops a maintenance window execution that is already in progress and cancels any tasks in + * the window that have not already starting running. (Tasks already in progress will continue to + * completion.)

+ */ export class CancelMaintenanceWindowExecutionCommand extends $Command< CancelMaintenanceWindowExecutionCommandInput, CancelMaintenanceWindowExecutionCommandOutput, @@ -34,6 +39,9 @@ export class CancelMaintenanceWindowExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CreateActivationCommand.ts b/clients/client-ssm/commands/CreateActivationCommand.ts index 8a8e9fd770298..77e0a521e69fe 100644 --- a/clients/client-ssm/commands/CreateActivationCommand.ts +++ b/clients/client-ssm/commands/CreateActivationCommand.ts @@ -20,6 +20,18 @@ import { export type CreateActivationCommandInput = CreateActivationRequest; export type CreateActivationCommandOutput = CreateActivationResult & __MetadataBearer; +/** + *

Generates an activation code and activation ID you can use to register your on-premises + * server or virtual machine (VM) with Systems Manager. Registering these machines with Systems Manager makes it + * possible to manage them using Systems Manager capabilities. You use the activation code and ID when + * installing SSM Agent on machines in your hybrid environment. For more information about + * requirements for managing on-premises instances and VMs using Systems Manager, see Setting up + * AWS Systems Manager for hybrid environments in the AWS Systems Manager User Guide.

+ * + *

On-premises servers or VMs that are registered with Systems Manager and EC2 instances that you manage + * with Systems Manager are all called managed instances.

+ *
+ */ export class CreateActivationCommand extends $Command< CreateActivationCommandInput, CreateActivationCommandOutput, @@ -34,6 +46,9 @@ export class CreateActivationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CreateAssociationBatchCommand.ts b/clients/client-ssm/commands/CreateAssociationBatchCommand.ts index a92fbd12b3669..fbe751b5de0cd 100644 --- a/clients/client-ssm/commands/CreateAssociationBatchCommand.ts +++ b/clients/client-ssm/commands/CreateAssociationBatchCommand.ts @@ -20,6 +20,14 @@ import { export type CreateAssociationBatchCommandInput = CreateAssociationBatchRequest; export type CreateAssociationBatchCommandOutput = CreateAssociationBatchResult & __MetadataBearer; +/** + *

Associates the specified Systems Manager document with the specified instances or targets.

+ *

When you associate a document with one or more instances using instance IDs or tags, + * SSM Agent running on the instance processes the document and configures the instance as + * specified.

+ *

If you associate a document with an instance that already has an associated document, the + * system returns the AssociationAlreadyExists exception.

+ */ export class CreateAssociationBatchCommand extends $Command< CreateAssociationBatchCommandInput, CreateAssociationBatchCommandOutput, @@ -34,6 +42,9 @@ export class CreateAssociationBatchCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CreateAssociationCommand.ts b/clients/client-ssm/commands/CreateAssociationCommand.ts index bf2d614ac91ea..ece198e934f57 100644 --- a/clients/client-ssm/commands/CreateAssociationCommand.ts +++ b/clients/client-ssm/commands/CreateAssociationCommand.ts @@ -20,6 +20,18 @@ import { export type CreateAssociationCommandInput = CreateAssociationRequest; export type CreateAssociationCommandOutput = CreateAssociationResult & __MetadataBearer; +/** + *

A State Manager association defines the state that you want to maintain on your instances. + * For example, an association can specify that anti-virus software must be installed and running on + * your instances, or that certain ports must be closed. For static targets, the association + * specifies a schedule for when the configuration is reapplied. For dynamic targets, such as an AWS + * Resource Group or an AWS Autoscaling Group, State Manager applies the configuration when new + * instances are added to the group. The association also specifies actions to take when applying + * the configuration. For example, an association for anti-virus software might run once a day. If + * the software is not installed, then State Manager installs it. If the software is installed, but + * the service is not running, then the association might instruct State Manager to start the + * service.

+ */ export class CreateAssociationCommand extends $Command< CreateAssociationCommandInput, CreateAssociationCommandOutput, @@ -34,6 +46,9 @@ export class CreateAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CreateDocumentCommand.ts b/clients/client-ssm/commands/CreateDocumentCommand.ts index 4b376e37b4013..c154e37af231e 100644 --- a/clients/client-ssm/commands/CreateDocumentCommand.ts +++ b/clients/client-ssm/commands/CreateDocumentCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDocumentCommandInput = CreateDocumentRequest; export type CreateDocumentCommandOutput = CreateDocumentResult & __MetadataBearer; +/** + *

Creates a Systems Manager (SSM) document. An SSM document defines the actions that Systems Manager performs on + * your managed instances. For more information about SSM documents, including information about + * supported schemas, features, and syntax, see AWS Systems Manager Documents in the + * AWS Systems Manager User Guide.

+ */ export class CreateDocumentCommand extends $Command< CreateDocumentCommandInput, CreateDocumentCommandOutput, @@ -34,6 +40,9 @@ export class CreateDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CreateMaintenanceWindowCommand.ts b/clients/client-ssm/commands/CreateMaintenanceWindowCommand.ts index 32e39d39cd44b..1b4a8fea249de 100644 --- a/clients/client-ssm/commands/CreateMaintenanceWindowCommand.ts +++ b/clients/client-ssm/commands/CreateMaintenanceWindowCommand.ts @@ -20,6 +20,17 @@ import { export type CreateMaintenanceWindowCommandInput = CreateMaintenanceWindowRequest; export type CreateMaintenanceWindowCommandOutput = CreateMaintenanceWindowResult & __MetadataBearer; +/** + *

Creates a new maintenance window.

+ * + *

The value you specify for Duration determines the specific end time for the + * maintenance window based on the time it begins. No maintenance window tasks are permitted to + * start after the resulting endtime minus the number of hours you specify for Cutoff. + * For example, if the maintenance window starts at 3 PM, the duration is three hours, and the + * value you specify for Cutoff is one hour, no maintenance window tasks can start + * after 5 PM.

+ *
+ */ export class CreateMaintenanceWindowCommand extends $Command< CreateMaintenanceWindowCommandInput, CreateMaintenanceWindowCommandOutput, @@ -34,6 +45,9 @@ export class CreateMaintenanceWindowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CreateOpsItemCommand.ts b/clients/client-ssm/commands/CreateOpsItemCommand.ts index c81f5ab059be7..7f9308b6c5694 100644 --- a/clients/client-ssm/commands/CreateOpsItemCommand.ts +++ b/clients/client-ssm/commands/CreateOpsItemCommand.ts @@ -20,6 +20,15 @@ import { export type CreateOpsItemCommandInput = CreateOpsItemRequest; export type CreateOpsItemCommandOutput = CreateOpsItemResponse & __MetadataBearer; +/** + *

Creates a new OpsItem. You must have permission in AWS Identity and Access Management (IAM) + * to create a new OpsItem. For more information, see Getting started with + * OpsCenter in the AWS Systems Manager User Guide.

+ *

Operations engineers and IT professionals use OpsCenter to view, investigate, and remediate + * operational issues impacting the performance and health of their AWS resources. For more + * information, see AWS Systems Manager OpsCenter in the + * AWS Systems Manager User Guide.

+ */ export class CreateOpsItemCommand extends $Command< CreateOpsItemCommandInput, CreateOpsItemCommandOutput, @@ -34,6 +43,9 @@ export class CreateOpsItemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CreatePatchBaselineCommand.ts b/clients/client-ssm/commands/CreatePatchBaselineCommand.ts index 4f98a604ac8ea..0779a552cda49 100644 --- a/clients/client-ssm/commands/CreatePatchBaselineCommand.ts +++ b/clients/client-ssm/commands/CreatePatchBaselineCommand.ts @@ -20,6 +20,13 @@ import { export type CreatePatchBaselineCommandInput = CreatePatchBaselineRequest; export type CreatePatchBaselineCommandOutput = CreatePatchBaselineResult & __MetadataBearer; +/** + *

Creates a patch baseline.

+ * + *

For information about valid key and value pairs in PatchFilters for each + * supported operating system type, see PatchFilter.

+ *
+ */ export class CreatePatchBaselineCommand extends $Command< CreatePatchBaselineCommandInput, CreatePatchBaselineCommandOutput, @@ -34,6 +41,9 @@ export class CreatePatchBaselineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/CreateResourceDataSyncCommand.ts b/clients/client-ssm/commands/CreateResourceDataSyncCommand.ts index 6123c4938d3c3..fdf2ad559ac15 100644 --- a/clients/client-ssm/commands/CreateResourceDataSyncCommand.ts +++ b/clients/client-ssm/commands/CreateResourceDataSyncCommand.ts @@ -20,6 +20,31 @@ import { export type CreateResourceDataSyncCommandInput = CreateResourceDataSyncRequest; export type CreateResourceDataSyncCommandOutput = CreateResourceDataSyncResult & __MetadataBearer; +/** + *

A resource data sync helps you view data from multiple sources in a single location. Systems + * Manager offers two types of resource data sync: SyncToDestination and + * SyncFromSource.

+ *

You can configure Systems Manager Inventory to use the SyncToDestination type to + * synchronize Inventory data from multiple AWS Regions to a single S3 bucket. For more information, + * see Configuring Resource Data + * Sync for Inventory in the AWS Systems Manager User Guide.

+ * + *

You can configure Systems Manager Explorer to use the SyncFromSource type to synchronize + * operational work items (OpsItems) and operational data (OpsData) from multiple AWS Regions to a + * single S3 bucket. This type can synchronize OpsItems and OpsData from multiple AWS accounts and + * Regions or EntireOrganization by using AWS Organizations. For more information, see Setting up Systems Manager Explorer to display data from multiple accounts and Regions in the + * AWS Systems Manager User Guide.

+ * + *

A resource data sync is an asynchronous operation that returns immediately. After a + * successful initial sync is completed, the system continuously syncs data. To check the status of + * a sync, use the ListResourceDataSync.

+ * + * + *

By default, data is not encrypted in Amazon S3. We strongly recommend that you enable encryption + * in Amazon S3 to ensure secure data storage. We also recommend that you secure access to the Amazon S3 + * bucket by creating a restrictive bucket policy.

+ *
+ */ export class CreateResourceDataSyncCommand extends $Command< CreateResourceDataSyncCommandInput, CreateResourceDataSyncCommandOutput, @@ -34,6 +59,9 @@ export class CreateResourceDataSyncCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeleteActivationCommand.ts b/clients/client-ssm/commands/DeleteActivationCommand.ts index 0d7015023270b..5fde1955448f9 100644 --- a/clients/client-ssm/commands/DeleteActivationCommand.ts +++ b/clients/client-ssm/commands/DeleteActivationCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteActivationCommandInput = DeleteActivationRequest; export type DeleteActivationCommandOutput = DeleteActivationResult & __MetadataBearer; +/** + *

Deletes an activation. You are not required to delete an activation. If you delete an + * activation, you can no longer use it to register additional managed instances. Deleting an + * activation does not de-register managed instances. You must manually de-register managed + * instances.

+ */ export class DeleteActivationCommand extends $Command< DeleteActivationCommandInput, DeleteActivationCommandOutput, @@ -34,6 +40,9 @@ export class DeleteActivationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeleteAssociationCommand.ts b/clients/client-ssm/commands/DeleteAssociationCommand.ts index 14e80037dc00f..f909840cfcaf0 100644 --- a/clients/client-ssm/commands/DeleteAssociationCommand.ts +++ b/clients/client-ssm/commands/DeleteAssociationCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteAssociationCommandInput = DeleteAssociationRequest; export type DeleteAssociationCommandOutput = DeleteAssociationResult & __MetadataBearer; +/** + *

Disassociates the specified Systems Manager document from the specified instance.

+ *

When you disassociate a document from an instance, it does not change the configuration of + * the instance. To change the configuration state of an instance after you disassociate a document, + * you must create a new document with the desired configuration and associate it with the + * instance.

+ */ export class DeleteAssociationCommand extends $Command< DeleteAssociationCommandInput, DeleteAssociationCommandOutput, @@ -34,6 +41,9 @@ export class DeleteAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeleteDocumentCommand.ts b/clients/client-ssm/commands/DeleteDocumentCommand.ts index 5dd2a5f717e22..f701d47d7b75b 100644 --- a/clients/client-ssm/commands/DeleteDocumentCommand.ts +++ b/clients/client-ssm/commands/DeleteDocumentCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteDocumentCommandInput = DeleteDocumentRequest; export type DeleteDocumentCommandOutput = DeleteDocumentResult & __MetadataBearer; +/** + *

Deletes the Systems Manager document and all instance associations to the document.

+ *

Before you delete the document, we recommend that you use DeleteAssociation to disassociate all instances that are associated with the document.

+ */ export class DeleteDocumentCommand extends $Command< DeleteDocumentCommandInput, DeleteDocumentCommandOutput, @@ -34,6 +38,9 @@ export class DeleteDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeleteInventoryCommand.ts b/clients/client-ssm/commands/DeleteInventoryCommand.ts index 0edac544c3fc3..4e592675aba3c 100644 --- a/clients/client-ssm/commands/DeleteInventoryCommand.ts +++ b/clients/client-ssm/commands/DeleteInventoryCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteInventoryCommandInput = DeleteInventoryRequest; export type DeleteInventoryCommandOutput = DeleteInventoryResult & __MetadataBearer; +/** + *

Delete a custom inventory type or the data associated with a custom Inventory type. Deleting + * a custom inventory type is also referred to as deleting a custom inventory schema.

+ */ export class DeleteInventoryCommand extends $Command< DeleteInventoryCommandInput, DeleteInventoryCommandOutput, @@ -34,6 +38,9 @@ export class DeleteInventoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeleteMaintenanceWindowCommand.ts b/clients/client-ssm/commands/DeleteMaintenanceWindowCommand.ts index c88a07eecf96c..2be108c0eb4b6 100644 --- a/clients/client-ssm/commands/DeleteMaintenanceWindowCommand.ts +++ b/clients/client-ssm/commands/DeleteMaintenanceWindowCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMaintenanceWindowCommandInput = DeleteMaintenanceWindowRequest; export type DeleteMaintenanceWindowCommandOutput = DeleteMaintenanceWindowResult & __MetadataBearer; +/** + *

Deletes a maintenance window.

+ */ export class DeleteMaintenanceWindowCommand extends $Command< DeleteMaintenanceWindowCommandInput, DeleteMaintenanceWindowCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMaintenanceWindowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeleteParameterCommand.ts b/clients/client-ssm/commands/DeleteParameterCommand.ts index d22ee2d54ea25..5ffc7fda0846b 100644 --- a/clients/client-ssm/commands/DeleteParameterCommand.ts +++ b/clients/client-ssm/commands/DeleteParameterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteParameterCommandInput = DeleteParameterRequest; export type DeleteParameterCommandOutput = DeleteParameterResult & __MetadataBearer; +/** + *

Delete a parameter from the system.

+ */ export class DeleteParameterCommand extends $Command< DeleteParameterCommandInput, DeleteParameterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteParameterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeleteParametersCommand.ts b/clients/client-ssm/commands/DeleteParametersCommand.ts index 25e0fff09e977..04d3e23533249 100644 --- a/clients/client-ssm/commands/DeleteParametersCommand.ts +++ b/clients/client-ssm/commands/DeleteParametersCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteParametersCommandInput = DeleteParametersRequest; export type DeleteParametersCommandOutput = DeleteParametersResult & __MetadataBearer; +/** + *

Delete a list of parameters.

+ */ export class DeleteParametersCommand extends $Command< DeleteParametersCommandInput, DeleteParametersCommandOutput, @@ -34,6 +37,9 @@ export class DeleteParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeletePatchBaselineCommand.ts b/clients/client-ssm/commands/DeletePatchBaselineCommand.ts index f2db8fe69878a..6903ce7632cd4 100644 --- a/clients/client-ssm/commands/DeletePatchBaselineCommand.ts +++ b/clients/client-ssm/commands/DeletePatchBaselineCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePatchBaselineCommandInput = DeletePatchBaselineRequest; export type DeletePatchBaselineCommandOutput = DeletePatchBaselineResult & __MetadataBearer; +/** + *

Deletes a patch baseline.

+ */ export class DeletePatchBaselineCommand extends $Command< DeletePatchBaselineCommandInput, DeletePatchBaselineCommandOutput, @@ -34,6 +37,9 @@ export class DeletePatchBaselineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeleteResourceDataSyncCommand.ts b/clients/client-ssm/commands/DeleteResourceDataSyncCommand.ts index c647cfbd9f9d0..3359794a56089 100644 --- a/clients/client-ssm/commands/DeleteResourceDataSyncCommand.ts +++ b/clients/client-ssm/commands/DeleteResourceDataSyncCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteResourceDataSyncCommandInput = DeleteResourceDataSyncRequest; export type DeleteResourceDataSyncCommandOutput = DeleteResourceDataSyncResult & __MetadataBearer; +/** + *

Deletes a Resource Data Sync configuration. After the configuration is deleted, changes to + * data on managed instances are no longer synced to or from the target. Deleting a sync + * configuration does not delete data.

+ */ export class DeleteResourceDataSyncCommand extends $Command< DeleteResourceDataSyncCommandInput, DeleteResourceDataSyncCommandOutput, @@ -34,6 +39,9 @@ export class DeleteResourceDataSyncCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeregisterManagedInstanceCommand.ts b/clients/client-ssm/commands/DeregisterManagedInstanceCommand.ts index 6ae85b266cdb8..ccf50f216fbd2 100644 --- a/clients/client-ssm/commands/DeregisterManagedInstanceCommand.ts +++ b/clients/client-ssm/commands/DeregisterManagedInstanceCommand.ts @@ -20,6 +20,11 @@ import { export type DeregisterManagedInstanceCommandInput = DeregisterManagedInstanceRequest; export type DeregisterManagedInstanceCommandOutput = DeregisterManagedInstanceResult & __MetadataBearer; +/** + *

Removes the server or virtual machine from the list of registered servers. You can + * reregister the instance again at any time. If you don't plan to use Run Command on the server, we + * suggest uninstalling SSM Agent first.

+ */ export class DeregisterManagedInstanceCommand extends $Command< DeregisterManagedInstanceCommandInput, DeregisterManagedInstanceCommandOutput, @@ -34,6 +39,9 @@ export class DeregisterManagedInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeregisterPatchBaselineForPatchGroupCommand.ts b/clients/client-ssm/commands/DeregisterPatchBaselineForPatchGroupCommand.ts index de4ca888cbe4c..978c3f1f904d2 100644 --- a/clients/client-ssm/commands/DeregisterPatchBaselineForPatchGroupCommand.ts +++ b/clients/client-ssm/commands/DeregisterPatchBaselineForPatchGroupCommand.ts @@ -24,6 +24,9 @@ export type DeregisterPatchBaselineForPatchGroupCommandInput = DeregisterPatchBa export type DeregisterPatchBaselineForPatchGroupCommandOutput = DeregisterPatchBaselineForPatchGroupResult & __MetadataBearer; +/** + *

Removes a patch group from a patch baseline.

+ */ export class DeregisterPatchBaselineForPatchGroupCommand extends $Command< DeregisterPatchBaselineForPatchGroupCommandInput, DeregisterPatchBaselineForPatchGroupCommandOutput, @@ -38,6 +41,9 @@ export class DeregisterPatchBaselineForPatchGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeregisterTargetFromMaintenanceWindowCommand.ts b/clients/client-ssm/commands/DeregisterTargetFromMaintenanceWindowCommand.ts index 7f79638040d9d..a3536173ee209 100644 --- a/clients/client-ssm/commands/DeregisterTargetFromMaintenanceWindowCommand.ts +++ b/clients/client-ssm/commands/DeregisterTargetFromMaintenanceWindowCommand.ts @@ -24,6 +24,9 @@ export type DeregisterTargetFromMaintenanceWindowCommandInput = DeregisterTarget export type DeregisterTargetFromMaintenanceWindowCommandOutput = DeregisterTargetFromMaintenanceWindowResult & __MetadataBearer; +/** + *

Removes a target from a maintenance window.

+ */ export class DeregisterTargetFromMaintenanceWindowCommand extends $Command< DeregisterTargetFromMaintenanceWindowCommandInput, DeregisterTargetFromMaintenanceWindowCommandOutput, @@ -38,6 +41,9 @@ export class DeregisterTargetFromMaintenanceWindowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DeregisterTaskFromMaintenanceWindowCommand.ts b/clients/client-ssm/commands/DeregisterTaskFromMaintenanceWindowCommand.ts index 7d839f372859e..f3d4c0cde9483 100644 --- a/clients/client-ssm/commands/DeregisterTaskFromMaintenanceWindowCommand.ts +++ b/clients/client-ssm/commands/DeregisterTaskFromMaintenanceWindowCommand.ts @@ -24,6 +24,9 @@ export type DeregisterTaskFromMaintenanceWindowCommandInput = DeregisterTaskFrom export type DeregisterTaskFromMaintenanceWindowCommandOutput = DeregisterTaskFromMaintenanceWindowResult & __MetadataBearer; +/** + *

Removes a task from a maintenance window.

+ */ export class DeregisterTaskFromMaintenanceWindowCommand extends $Command< DeregisterTaskFromMaintenanceWindowCommandInput, DeregisterTaskFromMaintenanceWindowCommandOutput, @@ -38,6 +41,9 @@ export class DeregisterTaskFromMaintenanceWindowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeActivationsCommand.ts b/clients/client-ssm/commands/DescribeActivationsCommand.ts index dbd2cbe48ff7a..1a1821c0e9c01 100644 --- a/clients/client-ssm/commands/DescribeActivationsCommand.ts +++ b/clients/client-ssm/commands/DescribeActivationsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeActivationsCommandInput = DescribeActivationsRequest; export type DescribeActivationsCommandOutput = DescribeActivationsResult & __MetadataBearer; +/** + *

Describes details about the activation, such as the date and time the activation was + * created, its expiration date, the IAM role assigned to the instances in the activation, and the + * number of instances registered by using this activation.

+ */ export class DescribeActivationsCommand extends $Command< DescribeActivationsCommandInput, DescribeActivationsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeActivationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeAssociationCommand.ts b/clients/client-ssm/commands/DescribeAssociationCommand.ts index e955eded65c06..652c0773b8906 100644 --- a/clients/client-ssm/commands/DescribeAssociationCommand.ts +++ b/clients/client-ssm/commands/DescribeAssociationCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeAssociationCommandInput = DescribeAssociationRequest; export type DescribeAssociationCommandOutput = DescribeAssociationResult & __MetadataBearer; +/** + *

Describes the association for the specified target or instance. If you created the + * association by using the Targets parameter, then you must retrieve the association + * by using the association ID. If you created the association by specifying an instance ID and a + * Systems Manager document, then you retrieve the association by specifying the document name and the + * instance ID.

+ */ export class DescribeAssociationCommand extends $Command< DescribeAssociationCommandInput, DescribeAssociationCommandOutput, @@ -34,6 +41,9 @@ export class DescribeAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeAssociationExecutionTargetsCommand.ts b/clients/client-ssm/commands/DescribeAssociationExecutionTargetsCommand.ts index 521febf1cfbda..92c2be033292e 100644 --- a/clients/client-ssm/commands/DescribeAssociationExecutionTargetsCommand.ts +++ b/clients/client-ssm/commands/DescribeAssociationExecutionTargetsCommand.ts @@ -24,6 +24,10 @@ export type DescribeAssociationExecutionTargetsCommandInput = DescribeAssociatio export type DescribeAssociationExecutionTargetsCommandOutput = DescribeAssociationExecutionTargetsResult & __MetadataBearer; +/** + *

Use this API action to view information about a specific execution of a specific + * association.

+ */ export class DescribeAssociationExecutionTargetsCommand extends $Command< DescribeAssociationExecutionTargetsCommandInput, DescribeAssociationExecutionTargetsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeAssociationExecutionTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeAssociationExecutionsCommand.ts b/clients/client-ssm/commands/DescribeAssociationExecutionsCommand.ts index 94206e3f0a580..dd0d0c358eee4 100644 --- a/clients/client-ssm/commands/DescribeAssociationExecutionsCommand.ts +++ b/clients/client-ssm/commands/DescribeAssociationExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAssociationExecutionsCommandInput = DescribeAssociationExecutionsRequest; export type DescribeAssociationExecutionsCommandOutput = DescribeAssociationExecutionsResult & __MetadataBearer; +/** + *

Use this API action to view all executions for a specific association ID.

+ */ export class DescribeAssociationExecutionsCommand extends $Command< DescribeAssociationExecutionsCommandInput, DescribeAssociationExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAssociationExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeAutomationExecutionsCommand.ts b/clients/client-ssm/commands/DescribeAutomationExecutionsCommand.ts index cf54dc786b4c6..e5b5aa8aaf732 100644 --- a/clients/client-ssm/commands/DescribeAutomationExecutionsCommand.ts +++ b/clients/client-ssm/commands/DescribeAutomationExecutionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAutomationExecutionsCommandInput = DescribeAutomationExecutionsRequest; export type DescribeAutomationExecutionsCommandOutput = DescribeAutomationExecutionsResult & __MetadataBearer; +/** + *

Provides details about all active and terminated Automation executions.

+ */ export class DescribeAutomationExecutionsCommand extends $Command< DescribeAutomationExecutionsCommandInput, DescribeAutomationExecutionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAutomationExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeAutomationStepExecutionsCommand.ts b/clients/client-ssm/commands/DescribeAutomationStepExecutionsCommand.ts index d2cd262629179..2cb160eeca529 100644 --- a/clients/client-ssm/commands/DescribeAutomationStepExecutionsCommand.ts +++ b/clients/client-ssm/commands/DescribeAutomationStepExecutionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAutomationStepExecutionsCommandInput = DescribeAutomationStepExecutionsRequest; export type DescribeAutomationStepExecutionsCommandOutput = DescribeAutomationStepExecutionsResult & __MetadataBearer; +/** + *

Information about all active and terminated step executions in an Automation + * workflow.

+ */ export class DescribeAutomationStepExecutionsCommand extends $Command< DescribeAutomationStepExecutionsCommandInput, DescribeAutomationStepExecutionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAutomationStepExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeAvailablePatchesCommand.ts b/clients/client-ssm/commands/DescribeAvailablePatchesCommand.ts index cedf5ff406159..3130e93c8e015 100644 --- a/clients/client-ssm/commands/DescribeAvailablePatchesCommand.ts +++ b/clients/client-ssm/commands/DescribeAvailablePatchesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAvailablePatchesCommandInput = DescribeAvailablePatchesRequest; export type DescribeAvailablePatchesCommandOutput = DescribeAvailablePatchesResult & __MetadataBearer; +/** + *

Lists all patches eligible to be included in a patch baseline.

+ */ export class DescribeAvailablePatchesCommand extends $Command< DescribeAvailablePatchesCommandInput, DescribeAvailablePatchesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAvailablePatchesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeDocumentCommand.ts b/clients/client-ssm/commands/DescribeDocumentCommand.ts index 5018a883bc8e4..5e201d46bb780 100644 --- a/clients/client-ssm/commands/DescribeDocumentCommand.ts +++ b/clients/client-ssm/commands/DescribeDocumentCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDocumentCommandInput = DescribeDocumentRequest; export type DescribeDocumentCommandOutput = DescribeDocumentResult & __MetadataBearer; +/** + *

Describes the specified Systems Manager document.

+ */ export class DescribeDocumentCommand extends $Command< DescribeDocumentCommandInput, DescribeDocumentCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeDocumentPermissionCommand.ts b/clients/client-ssm/commands/DescribeDocumentPermissionCommand.ts index 52b2bf4936cd3..0d500dc720127 100644 --- a/clients/client-ssm/commands/DescribeDocumentPermissionCommand.ts +++ b/clients/client-ssm/commands/DescribeDocumentPermissionCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDocumentPermissionCommandInput = DescribeDocumentPermissionRequest; export type DescribeDocumentPermissionCommandOutput = DescribeDocumentPermissionResponse & __MetadataBearer; +/** + *

Describes the permissions for a Systems Manager document. If you created the document, you are the + * owner. If a document is shared, it can either be shared privately (by specifying a user's AWS + * account ID) or publicly (All).

+ */ export class DescribeDocumentPermissionCommand extends $Command< DescribeDocumentPermissionCommandInput, DescribeDocumentPermissionCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDocumentPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeEffectiveInstanceAssociationsCommand.ts b/clients/client-ssm/commands/DescribeEffectiveInstanceAssociationsCommand.ts index 826f98bf2d4c5..e77502d060950 100644 --- a/clients/client-ssm/commands/DescribeEffectiveInstanceAssociationsCommand.ts +++ b/clients/client-ssm/commands/DescribeEffectiveInstanceAssociationsCommand.ts @@ -24,6 +24,9 @@ export type DescribeEffectiveInstanceAssociationsCommandInput = DescribeEffectiv export type DescribeEffectiveInstanceAssociationsCommandOutput = DescribeEffectiveInstanceAssociationsResult & __MetadataBearer; +/** + *

All associations for the instance(s).

+ */ export class DescribeEffectiveInstanceAssociationsCommand extends $Command< DescribeEffectiveInstanceAssociationsCommandInput, DescribeEffectiveInstanceAssociationsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeEffectiveInstanceAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeEffectivePatchesForPatchBaselineCommand.ts b/clients/client-ssm/commands/DescribeEffectivePatchesForPatchBaselineCommand.ts index 3e9bcb9d4ef13..96378b3d49a98 100644 --- a/clients/client-ssm/commands/DescribeEffectivePatchesForPatchBaselineCommand.ts +++ b/clients/client-ssm/commands/DescribeEffectivePatchesForPatchBaselineCommand.ts @@ -24,6 +24,10 @@ export type DescribeEffectivePatchesForPatchBaselineCommandInput = DescribeEffec export type DescribeEffectivePatchesForPatchBaselineCommandOutput = DescribeEffectivePatchesForPatchBaselineResult & __MetadataBearer; +/** + *

Retrieves the current effective patches (the patch and the approval state) for the specified + * patch baseline. Note that this API applies only to Windows patch baselines.

+ */ export class DescribeEffectivePatchesForPatchBaselineCommand extends $Command< DescribeEffectivePatchesForPatchBaselineCommandInput, DescribeEffectivePatchesForPatchBaselineCommandOutput, @@ -38,6 +42,9 @@ export class DescribeEffectivePatchesForPatchBaselineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeInstanceAssociationsStatusCommand.ts b/clients/client-ssm/commands/DescribeInstanceAssociationsStatusCommand.ts index 06a36e71ed856..61c5ad886a9f4 100644 --- a/clients/client-ssm/commands/DescribeInstanceAssociationsStatusCommand.ts +++ b/clients/client-ssm/commands/DescribeInstanceAssociationsStatusCommand.ts @@ -24,6 +24,9 @@ export type DescribeInstanceAssociationsStatusCommandInput = DescribeInstanceAss export type DescribeInstanceAssociationsStatusCommandOutput = DescribeInstanceAssociationsStatusResult & __MetadataBearer; +/** + *

The status of the associations for the instance(s).

+ */ export class DescribeInstanceAssociationsStatusCommand extends $Command< DescribeInstanceAssociationsStatusCommandInput, DescribeInstanceAssociationsStatusCommandOutput, @@ -38,6 +41,9 @@ export class DescribeInstanceAssociationsStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeInstanceInformationCommand.ts b/clients/client-ssm/commands/DescribeInstanceInformationCommand.ts index 19fba2b45afe3..7b0c312bb7877 100644 --- a/clients/client-ssm/commands/DescribeInstanceInformationCommand.ts +++ b/clients/client-ssm/commands/DescribeInstanceInformationCommand.ts @@ -20,6 +20,18 @@ import { export type DescribeInstanceInformationCommandInput = DescribeInstanceInformationRequest; export type DescribeInstanceInformationCommandOutput = DescribeInstanceInformationResult & __MetadataBearer; +/** + *

Describes one or more of your instances, including information about the operating system + * platform, the version of SSM Agent installed on the instance, instance status, and so on.

+ *

If you specify one or more instance IDs, it returns information for those instances. If you + * do not specify instance IDs, it returns information for all your instances. If you specify an + * instance ID that is not valid or an instance that you do not own, you receive an error.

+ * + *

The IamRole field for this API action is the Amazon Identity and Access Management (IAM) + * role assigned to on-premises instances. This call does not return the IAM role for EC2 + * instances.

+ *
+ */ export class DescribeInstanceInformationCommand extends $Command< DescribeInstanceInformationCommandInput, DescribeInstanceInformationCommandOutput, @@ -34,6 +46,9 @@ export class DescribeInstanceInformationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeInstancePatchStatesCommand.ts b/clients/client-ssm/commands/DescribeInstancePatchStatesCommand.ts index 1706ab3ea33cd..38e5f5697a4fa 100644 --- a/clients/client-ssm/commands/DescribeInstancePatchStatesCommand.ts +++ b/clients/client-ssm/commands/DescribeInstancePatchStatesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInstancePatchStatesCommandInput = DescribeInstancePatchStatesRequest; export type DescribeInstancePatchStatesCommandOutput = DescribeInstancePatchStatesResult & __MetadataBearer; +/** + *

Retrieves the high-level patch state of one or more instances.

+ */ export class DescribeInstancePatchStatesCommand extends $Command< DescribeInstancePatchStatesCommandInput, DescribeInstancePatchStatesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInstancePatchStatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeInstancePatchStatesForPatchGroupCommand.ts b/clients/client-ssm/commands/DescribeInstancePatchStatesForPatchGroupCommand.ts index 6f2419e122063..acd492d83f0a4 100644 --- a/clients/client-ssm/commands/DescribeInstancePatchStatesForPatchGroupCommand.ts +++ b/clients/client-ssm/commands/DescribeInstancePatchStatesForPatchGroupCommand.ts @@ -24,6 +24,9 @@ export type DescribeInstancePatchStatesForPatchGroupCommandInput = DescribeInsta export type DescribeInstancePatchStatesForPatchGroupCommandOutput = DescribeInstancePatchStatesForPatchGroupResult & __MetadataBearer; +/** + *

Retrieves the high-level patch state for the instances in the specified patch group.

+ */ export class DescribeInstancePatchStatesForPatchGroupCommand extends $Command< DescribeInstancePatchStatesForPatchGroupCommandInput, DescribeInstancePatchStatesForPatchGroupCommandOutput, @@ -38,6 +41,9 @@ export class DescribeInstancePatchStatesForPatchGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeInstancePatchesCommand.ts b/clients/client-ssm/commands/DescribeInstancePatchesCommand.ts index 57e524fe28b65..880cccbfaf51a 100644 --- a/clients/client-ssm/commands/DescribeInstancePatchesCommand.ts +++ b/clients/client-ssm/commands/DescribeInstancePatchesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeInstancePatchesCommandInput = DescribeInstancePatchesRequest; export type DescribeInstancePatchesCommandOutput = DescribeInstancePatchesResult & __MetadataBearer; +/** + *

Retrieves information about the patches on the specified instance and their state relative + * to the patch baseline being used for the instance.

+ */ export class DescribeInstancePatchesCommand extends $Command< DescribeInstancePatchesCommandInput, DescribeInstancePatchesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeInstancePatchesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeInventoryDeletionsCommand.ts b/clients/client-ssm/commands/DescribeInventoryDeletionsCommand.ts index 6fc176050435e..1258ceac78386 100644 --- a/clients/client-ssm/commands/DescribeInventoryDeletionsCommand.ts +++ b/clients/client-ssm/commands/DescribeInventoryDeletionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeInventoryDeletionsCommandInput = DescribeInventoryDeletionsRequest; export type DescribeInventoryDeletionsCommandOutput = DescribeInventoryDeletionsResult & __MetadataBearer; +/** + *

Describes a specific delete inventory operation.

+ */ export class DescribeInventoryDeletionsCommand extends $Command< DescribeInventoryDeletionsCommandInput, DescribeInventoryDeletionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeInventoryDeletionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionTaskInvocationsCommand.ts b/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionTaskInvocationsCommand.ts index a3341f310d227..2df57bdd31cd7 100644 --- a/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionTaskInvocationsCommand.ts +++ b/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionTaskInvocationsCommand.ts @@ -24,6 +24,10 @@ export type DescribeMaintenanceWindowExecutionTaskInvocationsCommandInput = Desc export type DescribeMaintenanceWindowExecutionTaskInvocationsCommandOutput = DescribeMaintenanceWindowExecutionTaskInvocationsResult & __MetadataBearer; +/** + *

Retrieves the individual task executions (one per target) for a particular task run as part + * of a maintenance window execution.

+ */ export class DescribeMaintenanceWindowExecutionTaskInvocationsCommand extends $Command< DescribeMaintenanceWindowExecutionTaskInvocationsCommandInput, DescribeMaintenanceWindowExecutionTaskInvocationsCommandOutput, @@ -38,6 +42,9 @@ export class DescribeMaintenanceWindowExecutionTaskInvocationsCommand extends $C // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionTasksCommand.ts b/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionTasksCommand.ts index 9563c56b0678d..5c7599adeb0a5 100644 --- a/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionTasksCommand.ts +++ b/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionTasksCommand.ts @@ -24,6 +24,9 @@ export type DescribeMaintenanceWindowExecutionTasksCommandInput = DescribeMainte export type DescribeMaintenanceWindowExecutionTasksCommandOutput = DescribeMaintenanceWindowExecutionTasksResult & __MetadataBearer; +/** + *

For a given maintenance window execution, lists the tasks that were run.

+ */ export class DescribeMaintenanceWindowExecutionTasksCommand extends $Command< DescribeMaintenanceWindowExecutionTasksCommandInput, DescribeMaintenanceWindowExecutionTasksCommandOutput, @@ -38,6 +41,9 @@ export class DescribeMaintenanceWindowExecutionTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionsCommand.ts b/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionsCommand.ts index 8f926cd6a16cb..04aa7e011220f 100644 --- a/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionsCommand.ts +++ b/clients/client-ssm/commands/DescribeMaintenanceWindowExecutionsCommand.ts @@ -24,6 +24,11 @@ export type DescribeMaintenanceWindowExecutionsCommandInput = DescribeMaintenanc export type DescribeMaintenanceWindowExecutionsCommandOutput = DescribeMaintenanceWindowExecutionsResult & __MetadataBearer; +/** + *

Lists the executions of a maintenance window. This includes information about when the + * maintenance window was scheduled to be active, and information about tasks registered and run + * with the maintenance window.

+ */ export class DescribeMaintenanceWindowExecutionsCommand extends $Command< DescribeMaintenanceWindowExecutionsCommandInput, DescribeMaintenanceWindowExecutionsCommandOutput, @@ -38,6 +43,9 @@ export class DescribeMaintenanceWindowExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeMaintenanceWindowScheduleCommand.ts b/clients/client-ssm/commands/DescribeMaintenanceWindowScheduleCommand.ts index fa3768aadc502..46dfd01e5c500 100644 --- a/clients/client-ssm/commands/DescribeMaintenanceWindowScheduleCommand.ts +++ b/clients/client-ssm/commands/DescribeMaintenanceWindowScheduleCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMaintenanceWindowScheduleCommandInput = DescribeMaintenanceWindowScheduleRequest; export type DescribeMaintenanceWindowScheduleCommandOutput = DescribeMaintenanceWindowScheduleResult & __MetadataBearer; +/** + *

Retrieves information about upcoming executions of a maintenance window.

+ */ export class DescribeMaintenanceWindowScheduleCommand extends $Command< DescribeMaintenanceWindowScheduleCommandInput, DescribeMaintenanceWindowScheduleCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMaintenanceWindowScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeMaintenanceWindowTargetsCommand.ts b/clients/client-ssm/commands/DescribeMaintenanceWindowTargetsCommand.ts index 4be6baf494b1d..ca2c1727379b0 100644 --- a/clients/client-ssm/commands/DescribeMaintenanceWindowTargetsCommand.ts +++ b/clients/client-ssm/commands/DescribeMaintenanceWindowTargetsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMaintenanceWindowTargetsCommandInput = DescribeMaintenanceWindowTargetsRequest; export type DescribeMaintenanceWindowTargetsCommandOutput = DescribeMaintenanceWindowTargetsResult & __MetadataBearer; +/** + *

Lists the targets registered with the maintenance window.

+ */ export class DescribeMaintenanceWindowTargetsCommand extends $Command< DescribeMaintenanceWindowTargetsCommandInput, DescribeMaintenanceWindowTargetsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMaintenanceWindowTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeMaintenanceWindowTasksCommand.ts b/clients/client-ssm/commands/DescribeMaintenanceWindowTasksCommand.ts index 83ed3043be877..0196d0e4446fa 100644 --- a/clients/client-ssm/commands/DescribeMaintenanceWindowTasksCommand.ts +++ b/clients/client-ssm/commands/DescribeMaintenanceWindowTasksCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMaintenanceWindowTasksCommandInput = DescribeMaintenanceWindowTasksRequest; export type DescribeMaintenanceWindowTasksCommandOutput = DescribeMaintenanceWindowTasksResult & __MetadataBearer; +/** + *

Lists the tasks in a maintenance window.

+ */ export class DescribeMaintenanceWindowTasksCommand extends $Command< DescribeMaintenanceWindowTasksCommandInput, DescribeMaintenanceWindowTasksCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMaintenanceWindowTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeMaintenanceWindowsCommand.ts b/clients/client-ssm/commands/DescribeMaintenanceWindowsCommand.ts index 9b4cf35bd4f9d..221bf6f9d13ba 100644 --- a/clients/client-ssm/commands/DescribeMaintenanceWindowsCommand.ts +++ b/clients/client-ssm/commands/DescribeMaintenanceWindowsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMaintenanceWindowsCommandInput = DescribeMaintenanceWindowsRequest; export type DescribeMaintenanceWindowsCommandOutput = DescribeMaintenanceWindowsResult & __MetadataBearer; +/** + *

Retrieves the maintenance windows in an AWS account.

+ */ export class DescribeMaintenanceWindowsCommand extends $Command< DescribeMaintenanceWindowsCommandInput, DescribeMaintenanceWindowsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMaintenanceWindowsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeMaintenanceWindowsForTargetCommand.ts b/clients/client-ssm/commands/DescribeMaintenanceWindowsForTargetCommand.ts index a920ee3dcddaa..62bc41810a230 100644 --- a/clients/client-ssm/commands/DescribeMaintenanceWindowsForTargetCommand.ts +++ b/clients/client-ssm/commands/DescribeMaintenanceWindowsForTargetCommand.ts @@ -24,6 +24,10 @@ export type DescribeMaintenanceWindowsForTargetCommandInput = DescribeMaintenanc export type DescribeMaintenanceWindowsForTargetCommandOutput = DescribeMaintenanceWindowsForTargetResult & __MetadataBearer; +/** + *

Retrieves information about the maintenance window targets or tasks that an instance is + * associated with.

+ */ export class DescribeMaintenanceWindowsForTargetCommand extends $Command< DescribeMaintenanceWindowsForTargetCommandInput, DescribeMaintenanceWindowsForTargetCommandOutput, @@ -38,6 +42,9 @@ export class DescribeMaintenanceWindowsForTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeOpsItemsCommand.ts b/clients/client-ssm/commands/DescribeOpsItemsCommand.ts index 4424be77b5b53..3c3a40f9a9dcd 100644 --- a/clients/client-ssm/commands/DescribeOpsItemsCommand.ts +++ b/clients/client-ssm/commands/DescribeOpsItemsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeOpsItemsCommandInput = DescribeOpsItemsRequest; export type DescribeOpsItemsCommandOutput = DescribeOpsItemsResponse & __MetadataBearer; +/** + *

Query a set of OpsItems. You must have permission in AWS Identity and Access Management + * (IAM) to query a list of OpsItems. For more information, see Getting started with + * OpsCenter in the AWS Systems Manager User Guide.

+ *

Operations engineers and IT professionals use OpsCenter to view, investigate, and remediate + * operational issues impacting the performance and health of their AWS resources. For more + * information, see AWS Systems Manager OpsCenter in the + * AWS Systems Manager User Guide.

+ */ export class DescribeOpsItemsCommand extends $Command< DescribeOpsItemsCommandInput, DescribeOpsItemsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeOpsItemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeParametersCommand.ts b/clients/client-ssm/commands/DescribeParametersCommand.ts index 1ee1343acc447..9cb67120eb5ac 100644 --- a/clients/client-ssm/commands/DescribeParametersCommand.ts +++ b/clients/client-ssm/commands/DescribeParametersCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeParametersCommandInput = DescribeParametersRequest; export type DescribeParametersCommandOutput = DescribeParametersResult & __MetadataBearer; +/** + *

Get information about a parameter.

+ * + *

Request results are returned on a best-effort basis. If you specify MaxResults + * in the request, the response includes information up to the limit specified. The number of items + * returned, however, can be between zero and the value of MaxResults. If the service + * reaches an internal limit while processing the results, it stops the operation and returns the + * matching values up to that point and a NextToken. You can specify the + * NextToken in a subsequent call to get the next set of results.

+ *
+ */ export class DescribeParametersCommand extends $Command< DescribeParametersCommandInput, DescribeParametersCommandOutput, @@ -34,6 +45,9 @@ export class DescribeParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribePatchBaselinesCommand.ts b/clients/client-ssm/commands/DescribePatchBaselinesCommand.ts index 66a04c198558e..9936589622b1b 100644 --- a/clients/client-ssm/commands/DescribePatchBaselinesCommand.ts +++ b/clients/client-ssm/commands/DescribePatchBaselinesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePatchBaselinesCommandInput = DescribePatchBaselinesRequest; export type DescribePatchBaselinesCommandOutput = DescribePatchBaselinesResult & __MetadataBearer; +/** + *

Lists the patch baselines in your AWS account.

+ */ export class DescribePatchBaselinesCommand extends $Command< DescribePatchBaselinesCommandInput, DescribePatchBaselinesCommandOutput, @@ -34,6 +37,9 @@ export class DescribePatchBaselinesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribePatchGroupStateCommand.ts b/clients/client-ssm/commands/DescribePatchGroupStateCommand.ts index 281520b459310..d8fe84346ca06 100644 --- a/clients/client-ssm/commands/DescribePatchGroupStateCommand.ts +++ b/clients/client-ssm/commands/DescribePatchGroupStateCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePatchGroupStateCommandInput = DescribePatchGroupStateRequest; export type DescribePatchGroupStateCommandOutput = DescribePatchGroupStateResult & __MetadataBearer; +/** + *

Returns high-level aggregated patch compliance state for a patch group.

+ */ export class DescribePatchGroupStateCommand extends $Command< DescribePatchGroupStateCommandInput, DescribePatchGroupStateCommandOutput, @@ -34,6 +37,9 @@ export class DescribePatchGroupStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribePatchGroupsCommand.ts b/clients/client-ssm/commands/DescribePatchGroupsCommand.ts index ce5fb8016cb09..bbcd7099156da 100644 --- a/clients/client-ssm/commands/DescribePatchGroupsCommand.ts +++ b/clients/client-ssm/commands/DescribePatchGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePatchGroupsCommandInput = DescribePatchGroupsRequest; export type DescribePatchGroupsCommandOutput = DescribePatchGroupsResult & __MetadataBearer; +/** + *

Lists all patch groups that have been registered with patch baselines.

+ */ export class DescribePatchGroupsCommand extends $Command< DescribePatchGroupsCommandInput, DescribePatchGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribePatchGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribePatchPropertiesCommand.ts b/clients/client-ssm/commands/DescribePatchPropertiesCommand.ts index 2d3af6c8f2709..6914f6a3844b3 100644 --- a/clients/client-ssm/commands/DescribePatchPropertiesCommand.ts +++ b/clients/client-ssm/commands/DescribePatchPropertiesCommand.ts @@ -20,6 +20,51 @@ import { export type DescribePatchPropertiesCommandInput = DescribePatchPropertiesRequest; export type DescribePatchPropertiesCommandOutput = DescribePatchPropertiesResult & __MetadataBearer; +/** + *

Lists the properties of available patches organized by product, product family, + * classification, severity, and other properties of available patches. You can use the reported + * properties in the filters you specify in requests for actions such as CreatePatchBaseline, UpdatePatchBaseline, DescribeAvailablePatches, and DescribePatchBaselines.

+ *

The following section lists the properties that can be used in filters for each major + * operating system type:

+ *
+ *
AMAZON_LINUX
+ *
+ *

Valid properties: PRODUCT, CLASSIFICATION, SEVERITY

+ *
+ *
AMAZON_LINUX_2
+ *
+ *

Valid properties: PRODUCT, CLASSIFICATION, SEVERITY

+ *
+ *
CENTOS
+ *
+ *

Valid properties: PRODUCT, CLASSIFICATION, SEVERITY

+ *
+ *
DEBIAN
+ *
+ *

Valid properties: PRODUCT, PRIORITY

+ *
+ *
ORACLE_LINUX
+ *
+ *

Valid properties: PRODUCT, CLASSIFICATION, SEVERITY

+ *
+ *
REDHAT_ENTERPRISE_LINUX
+ *
+ *

Valid properties: PRODUCT, CLASSIFICATION, SEVERITY

+ *
+ *
SUSE
+ *
+ *

Valid properties: PRODUCT, CLASSIFICATION, SEVERITY

+ *
+ *
UBUNTU
+ *
+ *

Valid properties: PRODUCT, PRIORITY

+ *
+ *
WINDOWS
+ *
+ *

Valid properties: PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, MSRC_SEVERITY

+ *
+ *
+ */ export class DescribePatchPropertiesCommand extends $Command< DescribePatchPropertiesCommandInput, DescribePatchPropertiesCommandOutput, @@ -34,6 +79,9 @@ export class DescribePatchPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/DescribeSessionsCommand.ts b/clients/client-ssm/commands/DescribeSessionsCommand.ts index ac4a0e5ec0980..2c0ace4079108 100644 --- a/clients/client-ssm/commands/DescribeSessionsCommand.ts +++ b/clients/client-ssm/commands/DescribeSessionsCommand.ts @@ -21,6 +21,10 @@ import { export type DescribeSessionsCommandInput = DescribeSessionsRequest; export type DescribeSessionsCommandOutput = DescribeSessionsResponse & __MetadataBearer; +/** + *

Retrieves a list of all active sessions (both connected and disconnected) or terminated + * sessions from the past 30 days.

+ */ export class DescribeSessionsCommand extends $Command< DescribeSessionsCommandInput, DescribeSessionsCommandOutput, @@ -35,6 +39,9 @@ export class DescribeSessionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetAutomationExecutionCommand.ts b/clients/client-ssm/commands/GetAutomationExecutionCommand.ts index ca250fbbe832a..6cf6c5015ab9f 100644 --- a/clients/client-ssm/commands/GetAutomationExecutionCommand.ts +++ b/clients/client-ssm/commands/GetAutomationExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type GetAutomationExecutionCommandInput = GetAutomationExecutionRequest; export type GetAutomationExecutionCommandOutput = GetAutomationExecutionResult & __MetadataBearer; +/** + *

Get detailed information about a particular Automation execution.

+ */ export class GetAutomationExecutionCommand extends $Command< GetAutomationExecutionCommandInput, GetAutomationExecutionCommandOutput, @@ -34,6 +37,9 @@ export class GetAutomationExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetCalendarStateCommand.ts b/clients/client-ssm/commands/GetCalendarStateCommand.ts index f34e9016a34c5..63280bb3787f5 100644 --- a/clients/client-ssm/commands/GetCalendarStateCommand.ts +++ b/clients/client-ssm/commands/GetCalendarStateCommand.ts @@ -20,6 +20,18 @@ import { export type GetCalendarStateCommandInput = GetCalendarStateRequest; export type GetCalendarStateCommandOutput = GetCalendarStateResponse & __MetadataBearer; +/** + *

Gets the state of the AWS Systems Manager Change Calendar at an optional, specified time. If you + * specify a time, GetCalendarState returns the state of the calendar at a specific + * time, and returns the next time that the Change Calendar state will transition. If you do not + * specify a time, GetCalendarState assumes the current time. Change Calendar entries + * have two possible states: OPEN or CLOSED.

+ *

If you specify more than one calendar in a request, the command returns the status of + * OPEN only if all calendars in the request are open. If one or more calendars in the + * request are closed, the status returned is CLOSED.

+ *

For more information about Systems Manager Change Calendar, see AWS Systems Manager Change + * Calendar in the AWS Systems Manager User Guide.

+ */ export class GetCalendarStateCommand extends $Command< GetCalendarStateCommandInput, GetCalendarStateCommandOutput, @@ -34,6 +46,9 @@ export class GetCalendarStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetCommandInvocationCommand.ts b/clients/client-ssm/commands/GetCommandInvocationCommand.ts index c729a08d5ee5f..653c6e326c58b 100644 --- a/clients/client-ssm/commands/GetCommandInvocationCommand.ts +++ b/clients/client-ssm/commands/GetCommandInvocationCommand.ts @@ -20,6 +20,9 @@ import { export type GetCommandInvocationCommandInput = GetCommandInvocationRequest; export type GetCommandInvocationCommandOutput = GetCommandInvocationResult & __MetadataBearer; +/** + *

Returns detailed information about command execution for an invocation or plugin.

+ */ export class GetCommandInvocationCommand extends $Command< GetCommandInvocationCommandInput, GetCommandInvocationCommandOutput, @@ -34,6 +37,9 @@ export class GetCommandInvocationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetConnectionStatusCommand.ts b/clients/client-ssm/commands/GetConnectionStatusCommand.ts index 51d3f9cc15952..605c0cd8b66e7 100644 --- a/clients/client-ssm/commands/GetConnectionStatusCommand.ts +++ b/clients/client-ssm/commands/GetConnectionStatusCommand.ts @@ -20,6 +20,10 @@ import { export type GetConnectionStatusCommandInput = GetConnectionStatusRequest; export type GetConnectionStatusCommandOutput = GetConnectionStatusResponse & __MetadataBearer; +/** + *

Retrieves the Session Manager connection status for an instance to determine whether it is running and + * ready to receive Session Manager connections.

+ */ export class GetConnectionStatusCommand extends $Command< GetConnectionStatusCommandInput, GetConnectionStatusCommandOutput, @@ -34,6 +38,9 @@ export class GetConnectionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetDefaultPatchBaselineCommand.ts b/clients/client-ssm/commands/GetDefaultPatchBaselineCommand.ts index e23fdecd1b3cb..8447d3e282140 100644 --- a/clients/client-ssm/commands/GetDefaultPatchBaselineCommand.ts +++ b/clients/client-ssm/commands/GetDefaultPatchBaselineCommand.ts @@ -20,6 +20,13 @@ import { export type GetDefaultPatchBaselineCommandInput = GetDefaultPatchBaselineRequest; export type GetDefaultPatchBaselineCommandOutput = GetDefaultPatchBaselineResult & __MetadataBearer; +/** + *

Retrieves the default patch baseline. Note that Systems Manager supports creating multiple default + * patch baselines. For example, you can create a default patch baseline for each operating + * system.

+ *

If you do not specify an operating system value, the default patch baseline for Windows is + * returned.

+ */ export class GetDefaultPatchBaselineCommand extends $Command< GetDefaultPatchBaselineCommandInput, GetDefaultPatchBaselineCommandOutput, @@ -34,6 +41,9 @@ export class GetDefaultPatchBaselineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetDeployablePatchSnapshotForInstanceCommand.ts b/clients/client-ssm/commands/GetDeployablePatchSnapshotForInstanceCommand.ts index 7bdd06bbd5da0..c12c5eca45658 100644 --- a/clients/client-ssm/commands/GetDeployablePatchSnapshotForInstanceCommand.ts +++ b/clients/client-ssm/commands/GetDeployablePatchSnapshotForInstanceCommand.ts @@ -24,6 +24,10 @@ export type GetDeployablePatchSnapshotForInstanceCommandInput = GetDeployablePat export type GetDeployablePatchSnapshotForInstanceCommandOutput = GetDeployablePatchSnapshotForInstanceResult & __MetadataBearer; +/** + *

Retrieves the current snapshot for the patch baseline the instance uses. This API is + * primarily used by the AWS-RunPatchBaseline Systems Manager document.

+ */ export class GetDeployablePatchSnapshotForInstanceCommand extends $Command< GetDeployablePatchSnapshotForInstanceCommandInput, GetDeployablePatchSnapshotForInstanceCommandOutput, @@ -38,6 +42,9 @@ export class GetDeployablePatchSnapshotForInstanceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetDocumentCommand.ts b/clients/client-ssm/commands/GetDocumentCommand.ts index 6dd46e8912993..04825cff1452d 100644 --- a/clients/client-ssm/commands/GetDocumentCommand.ts +++ b/clients/client-ssm/commands/GetDocumentCommand.ts @@ -20,6 +20,9 @@ import { export type GetDocumentCommandInput = GetDocumentRequest; export type GetDocumentCommandOutput = GetDocumentResult & __MetadataBearer; +/** + *

Gets the contents of the specified Systems Manager document.

+ */ export class GetDocumentCommand extends $Command< GetDocumentCommandInput, GetDocumentCommandOutput, @@ -34,6 +37,9 @@ export class GetDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetInventoryCommand.ts b/clients/client-ssm/commands/GetInventoryCommand.ts index c0085bc010ea7..2b6199ffa86e0 100644 --- a/clients/client-ssm/commands/GetInventoryCommand.ts +++ b/clients/client-ssm/commands/GetInventoryCommand.ts @@ -20,6 +20,9 @@ import { export type GetInventoryCommandInput = GetInventoryRequest; export type GetInventoryCommandOutput = GetInventoryResult & __MetadataBearer; +/** + *

Query inventory information.

+ */ export class GetInventoryCommand extends $Command< GetInventoryCommandInput, GetInventoryCommandOutput, @@ -34,6 +37,9 @@ export class GetInventoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetInventorySchemaCommand.ts b/clients/client-ssm/commands/GetInventorySchemaCommand.ts index 02f7b90be594e..7039146f3da73 100644 --- a/clients/client-ssm/commands/GetInventorySchemaCommand.ts +++ b/clients/client-ssm/commands/GetInventorySchemaCommand.ts @@ -20,6 +20,10 @@ import { export type GetInventorySchemaCommandInput = GetInventorySchemaRequest; export type GetInventorySchemaCommandOutput = GetInventorySchemaResult & __MetadataBearer; +/** + *

Return a list of inventory type names for the account, or return a list of attribute names + * for a specific Inventory item type.

+ */ export class GetInventorySchemaCommand extends $Command< GetInventorySchemaCommandInput, GetInventorySchemaCommandOutput, @@ -34,6 +38,9 @@ export class GetInventorySchemaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetMaintenanceWindowCommand.ts b/clients/client-ssm/commands/GetMaintenanceWindowCommand.ts index 27a5c00ebf0c4..6e2908b5ab8d9 100644 --- a/clients/client-ssm/commands/GetMaintenanceWindowCommand.ts +++ b/clients/client-ssm/commands/GetMaintenanceWindowCommand.ts @@ -20,6 +20,9 @@ import { export type GetMaintenanceWindowCommandInput = GetMaintenanceWindowRequest; export type GetMaintenanceWindowCommandOutput = GetMaintenanceWindowResult & __MetadataBearer; +/** + *

Retrieves a maintenance window.

+ */ export class GetMaintenanceWindowCommand extends $Command< GetMaintenanceWindowCommandInput, GetMaintenanceWindowCommandOutput, @@ -34,6 +37,9 @@ export class GetMaintenanceWindowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetMaintenanceWindowExecutionCommand.ts b/clients/client-ssm/commands/GetMaintenanceWindowExecutionCommand.ts index 65e4d0881a828..2e64ba8fb7b71 100644 --- a/clients/client-ssm/commands/GetMaintenanceWindowExecutionCommand.ts +++ b/clients/client-ssm/commands/GetMaintenanceWindowExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type GetMaintenanceWindowExecutionCommandInput = GetMaintenanceWindowExecutionRequest; export type GetMaintenanceWindowExecutionCommandOutput = GetMaintenanceWindowExecutionResult & __MetadataBearer; +/** + *

Retrieves details about a specific a maintenance window execution.

+ */ export class GetMaintenanceWindowExecutionCommand extends $Command< GetMaintenanceWindowExecutionCommandInput, GetMaintenanceWindowExecutionCommandOutput, @@ -34,6 +37,9 @@ export class GetMaintenanceWindowExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetMaintenanceWindowExecutionTaskCommand.ts b/clients/client-ssm/commands/GetMaintenanceWindowExecutionTaskCommand.ts index f468f5d59341d..c44c8e3671cf2 100644 --- a/clients/client-ssm/commands/GetMaintenanceWindowExecutionTaskCommand.ts +++ b/clients/client-ssm/commands/GetMaintenanceWindowExecutionTaskCommand.ts @@ -20,6 +20,10 @@ import { export type GetMaintenanceWindowExecutionTaskCommandInput = GetMaintenanceWindowExecutionTaskRequest; export type GetMaintenanceWindowExecutionTaskCommandOutput = GetMaintenanceWindowExecutionTaskResult & __MetadataBearer; +/** + *

Retrieves the details about a specific task run as part of a maintenance window + * execution.

+ */ export class GetMaintenanceWindowExecutionTaskCommand extends $Command< GetMaintenanceWindowExecutionTaskCommandInput, GetMaintenanceWindowExecutionTaskCommandOutput, @@ -34,6 +38,9 @@ export class GetMaintenanceWindowExecutionTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetMaintenanceWindowExecutionTaskInvocationCommand.ts b/clients/client-ssm/commands/GetMaintenanceWindowExecutionTaskInvocationCommand.ts index 936e32131c1f7..23ef68fd8d651 100644 --- a/clients/client-ssm/commands/GetMaintenanceWindowExecutionTaskInvocationCommand.ts +++ b/clients/client-ssm/commands/GetMaintenanceWindowExecutionTaskInvocationCommand.ts @@ -24,6 +24,9 @@ export type GetMaintenanceWindowExecutionTaskInvocationCommandInput = GetMainten export type GetMaintenanceWindowExecutionTaskInvocationCommandOutput = GetMaintenanceWindowExecutionTaskInvocationResult & __MetadataBearer; +/** + *

Retrieves information about a specific task running on a specific target.

+ */ export class GetMaintenanceWindowExecutionTaskInvocationCommand extends $Command< GetMaintenanceWindowExecutionTaskInvocationCommandInput, GetMaintenanceWindowExecutionTaskInvocationCommandOutput, @@ -38,6 +41,9 @@ export class GetMaintenanceWindowExecutionTaskInvocationCommand extends $Command // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetMaintenanceWindowTaskCommand.ts b/clients/client-ssm/commands/GetMaintenanceWindowTaskCommand.ts index 957f2616973b1..5fbf3c4d72838 100644 --- a/clients/client-ssm/commands/GetMaintenanceWindowTaskCommand.ts +++ b/clients/client-ssm/commands/GetMaintenanceWindowTaskCommand.ts @@ -20,6 +20,9 @@ import { export type GetMaintenanceWindowTaskCommandInput = GetMaintenanceWindowTaskRequest; export type GetMaintenanceWindowTaskCommandOutput = GetMaintenanceWindowTaskResult & __MetadataBearer; +/** + *

Lists the tasks in a maintenance window.

+ */ export class GetMaintenanceWindowTaskCommand extends $Command< GetMaintenanceWindowTaskCommandInput, GetMaintenanceWindowTaskCommandOutput, @@ -34,6 +37,9 @@ export class GetMaintenanceWindowTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetOpsItemCommand.ts b/clients/client-ssm/commands/GetOpsItemCommand.ts index 9e309718fcc1b..1d8aa1e0a0565 100644 --- a/clients/client-ssm/commands/GetOpsItemCommand.ts +++ b/clients/client-ssm/commands/GetOpsItemCommand.ts @@ -20,6 +20,16 @@ import { export type GetOpsItemCommandInput = GetOpsItemRequest; export type GetOpsItemCommandOutput = GetOpsItemResponse & __MetadataBearer; +/** + *

Get information about an OpsItem by using the ID. You must have permission in AWS Identity + * and Access Management (IAM) to view information about an OpsItem. For more information, see + * Getting started with + * OpsCenter in the AWS Systems Manager User Guide.

+ *

Operations engineers and IT professionals use OpsCenter to view, investigate, and remediate + * operational issues impacting the performance and health of their AWS resources. For more + * information, see AWS Systems Manager OpsCenter in the + * AWS Systems Manager User Guide.

+ */ export class GetOpsItemCommand extends $Command< GetOpsItemCommandInput, GetOpsItemCommandOutput, @@ -34,6 +44,9 @@ export class GetOpsItemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetOpsSummaryCommand.ts b/clients/client-ssm/commands/GetOpsSummaryCommand.ts index 35060f67ca105..d515e1e7ee2ba 100644 --- a/clients/client-ssm/commands/GetOpsSummaryCommand.ts +++ b/clients/client-ssm/commands/GetOpsSummaryCommand.ts @@ -20,6 +20,9 @@ import { export type GetOpsSummaryCommandInput = GetOpsSummaryRequest; export type GetOpsSummaryCommandOutput = GetOpsSummaryResult & __MetadataBearer; +/** + *

View a summary of OpsItems based on specified filters and aggregators.

+ */ export class GetOpsSummaryCommand extends $Command< GetOpsSummaryCommandInput, GetOpsSummaryCommandOutput, @@ -34,6 +37,9 @@ export class GetOpsSummaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetParameterCommand.ts b/clients/client-ssm/commands/GetParameterCommand.ts index 6c78a8ed7acc0..bcef3750e20f5 100644 --- a/clients/client-ssm/commands/GetParameterCommand.ts +++ b/clients/client-ssm/commands/GetParameterCommand.ts @@ -20,6 +20,10 @@ import { export type GetParameterCommandInput = GetParameterRequest; export type GetParameterCommandOutput = GetParameterResult & __MetadataBearer; +/** + *

Get information about a parameter by using the parameter name. Don't confuse this API action + * with the GetParameters API action.

+ */ export class GetParameterCommand extends $Command< GetParameterCommandInput, GetParameterCommandOutput, @@ -34,6 +38,9 @@ export class GetParameterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetParameterHistoryCommand.ts b/clients/client-ssm/commands/GetParameterHistoryCommand.ts index c1c28df8e65cf..08f57101eeef2 100644 --- a/clients/client-ssm/commands/GetParameterHistoryCommand.ts +++ b/clients/client-ssm/commands/GetParameterHistoryCommand.ts @@ -20,6 +20,9 @@ import { export type GetParameterHistoryCommandInput = GetParameterHistoryRequest; export type GetParameterHistoryCommandOutput = GetParameterHistoryResult & __MetadataBearer; +/** + *

Retrieves the history of all changes to a parameter.

+ */ export class GetParameterHistoryCommand extends $Command< GetParameterHistoryCommandInput, GetParameterHistoryCommandOutput, @@ -34,6 +37,9 @@ export class GetParameterHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetParametersByPathCommand.ts b/clients/client-ssm/commands/GetParametersByPathCommand.ts index 0399565b54c97..1af258735070f 100644 --- a/clients/client-ssm/commands/GetParametersByPathCommand.ts +++ b/clients/client-ssm/commands/GetParametersByPathCommand.ts @@ -20,6 +20,17 @@ import { export type GetParametersByPathCommandInput = GetParametersByPathRequest; export type GetParametersByPathCommandOutput = GetParametersByPathResult & __MetadataBearer; +/** + *

Retrieve information about one or more parameters in a specific hierarchy.

+ * + *

Request results are returned on a best-effort basis. If you specify MaxResults + * in the request, the response includes information up to the limit specified. The number of items + * returned, however, can be between zero and the value of MaxResults. If the service + * reaches an internal limit while processing the results, it stops the operation and returns the + * matching values up to that point and a NextToken. You can specify the + * NextToken in a subsequent call to get the next set of results.

+ *
+ */ export class GetParametersByPathCommand extends $Command< GetParametersByPathCommandInput, GetParametersByPathCommandOutput, @@ -34,6 +45,9 @@ export class GetParametersByPathCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetParametersCommand.ts b/clients/client-ssm/commands/GetParametersCommand.ts index 99429f68a6146..baed52cf36dd1 100644 --- a/clients/client-ssm/commands/GetParametersCommand.ts +++ b/clients/client-ssm/commands/GetParametersCommand.ts @@ -20,6 +20,9 @@ import { export type GetParametersCommandInput = GetParametersRequest; export type GetParametersCommandOutput = GetParametersResult & __MetadataBearer; +/** + *

Get details of a parameter. Don't confuse this API action with the GetParameter API action.

+ */ export class GetParametersCommand extends $Command< GetParametersCommandInput, GetParametersCommandOutput, @@ -34,6 +37,9 @@ export class GetParametersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetPatchBaselineCommand.ts b/clients/client-ssm/commands/GetPatchBaselineCommand.ts index dc33840cfd85a..3ec8b5375ec5c 100644 --- a/clients/client-ssm/commands/GetPatchBaselineCommand.ts +++ b/clients/client-ssm/commands/GetPatchBaselineCommand.ts @@ -20,6 +20,9 @@ import { export type GetPatchBaselineCommandInput = GetPatchBaselineRequest; export type GetPatchBaselineCommandOutput = GetPatchBaselineResult & __MetadataBearer; +/** + *

Retrieves information about a patch baseline.

+ */ export class GetPatchBaselineCommand extends $Command< GetPatchBaselineCommandInput, GetPatchBaselineCommandOutput, @@ -34,6 +37,9 @@ export class GetPatchBaselineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetPatchBaselineForPatchGroupCommand.ts b/clients/client-ssm/commands/GetPatchBaselineForPatchGroupCommand.ts index 132700663957b..42980d0d1309a 100644 --- a/clients/client-ssm/commands/GetPatchBaselineForPatchGroupCommand.ts +++ b/clients/client-ssm/commands/GetPatchBaselineForPatchGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetPatchBaselineForPatchGroupCommandInput = GetPatchBaselineForPatchGroupRequest; export type GetPatchBaselineForPatchGroupCommandOutput = GetPatchBaselineForPatchGroupResult & __MetadataBearer; +/** + *

Retrieves the patch baseline that should be used for the specified patch group.

+ */ export class GetPatchBaselineForPatchGroupCommand extends $Command< GetPatchBaselineForPatchGroupCommandInput, GetPatchBaselineForPatchGroupCommandOutput, @@ -34,6 +37,9 @@ export class GetPatchBaselineForPatchGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/GetServiceSettingCommand.ts b/clients/client-ssm/commands/GetServiceSettingCommand.ts index 56a2317c54869..a44ea97c7ce5f 100644 --- a/clients/client-ssm/commands/GetServiceSettingCommand.ts +++ b/clients/client-ssm/commands/GetServiceSettingCommand.ts @@ -20,6 +20,22 @@ import { export type GetServiceSettingCommandInput = GetServiceSettingRequest; export type GetServiceSettingCommandOutput = GetServiceSettingResult & __MetadataBearer; +/** + *

+ * ServiceSetting is an account-level setting for an AWS service. This setting + * defines how a user interacts with or uses a service or a feature of a service. For example, if an + * AWS service charges money to the account based on feature or service usage, then the AWS service + * team might create a default setting of "false". This means the user can't use this feature unless + * they change the setting to "true" and intentionally opt in for a paid feature.

+ *

Services map a SettingId object to a setting value. AWS services teams define + * the default value for a SettingId. You can't create a new SettingId, + * but you can overwrite the default value if you have the ssm:UpdateServiceSetting + * permission for the setting. Use the UpdateServiceSetting API action to change + * the default setting. Or use the ResetServiceSetting to change the value back to + * the original value defined by the AWS service team.

+ * + *

Query the current service setting for the account.

+ */ export class GetServiceSettingCommand extends $Command< GetServiceSettingCommandInput, GetServiceSettingCommandOutput, @@ -34,6 +50,9 @@ export class GetServiceSettingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/LabelParameterVersionCommand.ts b/clients/client-ssm/commands/LabelParameterVersionCommand.ts index 47fa5e624c947..a529e34de2fc9 100644 --- a/clients/client-ssm/commands/LabelParameterVersionCommand.ts +++ b/clients/client-ssm/commands/LabelParameterVersionCommand.ts @@ -20,6 +20,45 @@ import { export type LabelParameterVersionCommandInput = LabelParameterVersionRequest; export type LabelParameterVersionCommandOutput = LabelParameterVersionResult & __MetadataBearer; +/** + *

A parameter label is a user-defined alias to help you manage different versions of a + * parameter. When you modify a parameter, Systems Manager automatically saves a new version and increments + * the version number by one. A label can help you remember the purpose of a parameter when there + * are multiple versions.

+ *

Parameter labels have the following requirements and restrictions.

+ *
    + *
  • + *

    A version of a parameter can have a maximum of 10 labels.

    + *
  • + *
  • + *

    You can't attach the same label to different versions of the same parameter. For example, + * if version 1 has the label Production, then you can't attach Production to version 2.

    + *
  • + *
  • + *

    You can move a label from one version of a parameter to another.

    + *
  • + *
  • + *

    You can't create a label when you create a new parameter. You must attach a label to a + * specific version of a parameter.

    + *
  • + *
  • + *

    You can't delete a parameter label. If you no longer want to use a parameter label, then + * you must move it to a different version of a parameter.

    + *
  • + *
  • + *

    A label can have a maximum of 100 characters.

    + *
  • + *
  • + *

    Labels can contain letters (case sensitive), numbers, periods (.), hyphens (-), or + * underscores (_).

    + *
  • + *
  • + *

    Labels can't begin with a number, "aws," or "ssm" (not case sensitive). If a label fails + * to meet these requirements, then the label is not associated with a parameter and the system + * displays it in the list of InvalidLabels.

    + *
  • + *
+ */ export class LabelParameterVersionCommand extends $Command< LabelParameterVersionCommandInput, LabelParameterVersionCommandOutput, @@ -34,6 +73,9 @@ export class LabelParameterVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListAssociationVersionsCommand.ts b/clients/client-ssm/commands/ListAssociationVersionsCommand.ts index ebea76b42f69f..d1c9d861ac406 100644 --- a/clients/client-ssm/commands/ListAssociationVersionsCommand.ts +++ b/clients/client-ssm/commands/ListAssociationVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListAssociationVersionsCommandInput = ListAssociationVersionsRequest; export type ListAssociationVersionsCommandOutput = ListAssociationVersionsResult & __MetadataBearer; +/** + *

Retrieves all versions of an association for a specific association ID.

+ */ export class ListAssociationVersionsCommand extends $Command< ListAssociationVersionsCommandInput, ListAssociationVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListAssociationVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListAssociationsCommand.ts b/clients/client-ssm/commands/ListAssociationsCommand.ts index e2e878ac3e7af..c0b8108c13114 100644 --- a/clients/client-ssm/commands/ListAssociationsCommand.ts +++ b/clients/client-ssm/commands/ListAssociationsCommand.ts @@ -20,6 +20,11 @@ import { export type ListAssociationsCommandInput = ListAssociationsRequest; export type ListAssociationsCommandOutput = ListAssociationsResult & __MetadataBearer; +/** + *

Returns all State Manager associations in the current AWS account and Region. You can limit + * the results to a specific State Manager association document or instance by specifying a + * filter.

+ */ export class ListAssociationsCommand extends $Command< ListAssociationsCommandInput, ListAssociationsCommandOutput, @@ -34,6 +39,9 @@ export class ListAssociationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListCommandInvocationsCommand.ts b/clients/client-ssm/commands/ListCommandInvocationsCommand.ts index d7f33ebd741c3..220102afa2189 100644 --- a/clients/client-ssm/commands/ListCommandInvocationsCommand.ts +++ b/clients/client-ssm/commands/ListCommandInvocationsCommand.ts @@ -20,6 +20,12 @@ import { export type ListCommandInvocationsCommandInput = ListCommandInvocationsRequest; export type ListCommandInvocationsCommandOutput = ListCommandInvocationsResult & __MetadataBearer; +/** + *

An invocation is copy of a command sent to a specific instance. A command can apply to one + * or more instances. A command invocation applies to one instance. For example, if a user runs + * SendCommand against three instances, then a command invocation is created for each requested + * instance ID. ListCommandInvocations provide status about command execution.

+ */ export class ListCommandInvocationsCommand extends $Command< ListCommandInvocationsCommandInput, ListCommandInvocationsCommandOutput, @@ -34,6 +40,9 @@ export class ListCommandInvocationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListCommandsCommand.ts b/clients/client-ssm/commands/ListCommandsCommand.ts index b5805c61897cd..34c614b205786 100644 --- a/clients/client-ssm/commands/ListCommandsCommand.ts +++ b/clients/client-ssm/commands/ListCommandsCommand.ts @@ -20,6 +20,9 @@ import { export type ListCommandsCommandInput = ListCommandsRequest; export type ListCommandsCommandOutput = ListCommandsResult & __MetadataBearer; +/** + *

Lists the commands requested by users of the AWS account.

+ */ export class ListCommandsCommand extends $Command< ListCommandsCommandInput, ListCommandsCommandOutput, @@ -34,6 +37,9 @@ export class ListCommandsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListComplianceItemsCommand.ts b/clients/client-ssm/commands/ListComplianceItemsCommand.ts index 5455bd94c16aa..fe69dc3dc2628 100644 --- a/clients/client-ssm/commands/ListComplianceItemsCommand.ts +++ b/clients/client-ssm/commands/ListComplianceItemsCommand.ts @@ -20,6 +20,11 @@ import { export type ListComplianceItemsCommandInput = ListComplianceItemsRequest; export type ListComplianceItemsCommandOutput = ListComplianceItemsResult & __MetadataBearer; +/** + *

For a specified resource ID, this API action returns a list of compliance statuses for + * different resource types. Currently, you can only specify one resource ID per call. List results + * depend on the criteria specified in the filter.

+ */ export class ListComplianceItemsCommand extends $Command< ListComplianceItemsCommandInput, ListComplianceItemsCommandOutput, @@ -34,6 +39,9 @@ export class ListComplianceItemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListComplianceSummariesCommand.ts b/clients/client-ssm/commands/ListComplianceSummariesCommand.ts index ad812fd6fe9f0..fa4d7d729bb4f 100644 --- a/clients/client-ssm/commands/ListComplianceSummariesCommand.ts +++ b/clients/client-ssm/commands/ListComplianceSummariesCommand.ts @@ -20,6 +20,11 @@ import { export type ListComplianceSummariesCommandInput = ListComplianceSummariesRequest; export type ListComplianceSummariesCommandOutput = ListComplianceSummariesResult & __MetadataBearer; +/** + *

Returns a summary count of compliant and non-compliant resources for a compliance type. For + * example, this call can return State Manager associations, patches, or custom compliance types + * according to the filter criteria that you specify.

+ */ export class ListComplianceSummariesCommand extends $Command< ListComplianceSummariesCommandInput, ListComplianceSummariesCommandOutput, @@ -34,6 +39,9 @@ export class ListComplianceSummariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListDocumentVersionsCommand.ts b/clients/client-ssm/commands/ListDocumentVersionsCommand.ts index ad675cbfa9c1e..17181617ed8d5 100644 --- a/clients/client-ssm/commands/ListDocumentVersionsCommand.ts +++ b/clients/client-ssm/commands/ListDocumentVersionsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDocumentVersionsCommandInput = ListDocumentVersionsRequest; export type ListDocumentVersionsCommandOutput = ListDocumentVersionsResult & __MetadataBearer; +/** + *

List all versions for a document.

+ */ export class ListDocumentVersionsCommand extends $Command< ListDocumentVersionsCommandInput, ListDocumentVersionsCommandOutput, @@ -34,6 +37,9 @@ export class ListDocumentVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListDocumentsCommand.ts b/clients/client-ssm/commands/ListDocumentsCommand.ts index f08346e3eba16..cf3c543305c8a 100644 --- a/clients/client-ssm/commands/ListDocumentsCommand.ts +++ b/clients/client-ssm/commands/ListDocumentsCommand.ts @@ -20,6 +20,10 @@ import { export type ListDocumentsCommandInput = ListDocumentsRequest; export type ListDocumentsCommandOutput = ListDocumentsResult & __MetadataBearer; +/** + *

Returns all Systems Manager (SSM) documents in the current AWS account and Region. You can limit the + * results of this request by using a filter.

+ */ export class ListDocumentsCommand extends $Command< ListDocumentsCommandInput, ListDocumentsCommandOutput, @@ -34,6 +38,9 @@ export class ListDocumentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListInventoryEntriesCommand.ts b/clients/client-ssm/commands/ListInventoryEntriesCommand.ts index f294f8dd3d09c..d53314bf374fb 100644 --- a/clients/client-ssm/commands/ListInventoryEntriesCommand.ts +++ b/clients/client-ssm/commands/ListInventoryEntriesCommand.ts @@ -20,6 +20,9 @@ import { export type ListInventoryEntriesCommandInput = ListInventoryEntriesRequest; export type ListInventoryEntriesCommandOutput = ListInventoryEntriesResult & __MetadataBearer; +/** + *

A list of inventory items returned by the request.

+ */ export class ListInventoryEntriesCommand extends $Command< ListInventoryEntriesCommandInput, ListInventoryEntriesCommandOutput, @@ -34,6 +37,9 @@ export class ListInventoryEntriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListResourceComplianceSummariesCommand.ts b/clients/client-ssm/commands/ListResourceComplianceSummariesCommand.ts index 7c4710028c681..e3da01aa2bdfc 100644 --- a/clients/client-ssm/commands/ListResourceComplianceSummariesCommand.ts +++ b/clients/client-ssm/commands/ListResourceComplianceSummariesCommand.ts @@ -20,6 +20,11 @@ import { export type ListResourceComplianceSummariesCommandInput = ListResourceComplianceSummariesRequest; export type ListResourceComplianceSummariesCommandOutput = ListResourceComplianceSummariesResult & __MetadataBearer; +/** + *

Returns a resource-level summary count. The summary includes information about compliant and + * non-compliant statuses and detailed compliance-item severity counts, according to the filter + * criteria you specify.

+ */ export class ListResourceComplianceSummariesCommand extends $Command< ListResourceComplianceSummariesCommandInput, ListResourceComplianceSummariesCommandOutput, @@ -34,6 +39,9 @@ export class ListResourceComplianceSummariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListResourceDataSyncCommand.ts b/clients/client-ssm/commands/ListResourceDataSyncCommand.ts index 807bc73640f3c..e53b9aa4103a8 100644 --- a/clients/client-ssm/commands/ListResourceDataSyncCommand.ts +++ b/clients/client-ssm/commands/ListResourceDataSyncCommand.ts @@ -20,6 +20,17 @@ import { export type ListResourceDataSyncCommandInput = ListResourceDataSyncRequest; export type ListResourceDataSyncCommandOutput = ListResourceDataSyncResult & __MetadataBearer; +/** + *

Lists your resource data sync configurations. Includes information about the last time a + * sync attempted to start, the last sync status, and the last time a sync successfully + * completed.

+ *

The number of sync configurations might be too large to return using a single call to + * ListResourceDataSync. You can limit the number of sync configurations returned by + * using the MaxResults parameter. To determine whether there are more sync + * configurations to list, check the value of NextToken in the output. If there are + * more sync configurations to list, you can request them by specifying the NextToken + * returned in the call to the parameter of a subsequent call.

+ */ export class ListResourceDataSyncCommand extends $Command< ListResourceDataSyncCommandInput, ListResourceDataSyncCommandOutput, @@ -34,6 +45,9 @@ export class ListResourceDataSyncCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ListTagsForResourceCommand.ts b/clients/client-ssm/commands/ListTagsForResourceCommand.ts index e5f18668b54e8..afc9e685aaf3e 100644 --- a/clients/client-ssm/commands/ListTagsForResourceCommand.ts +++ b/clients/client-ssm/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResult & __MetadataBearer; +/** + *

Returns a list of the tags assigned to the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ModifyDocumentPermissionCommand.ts b/clients/client-ssm/commands/ModifyDocumentPermissionCommand.ts index d3c77a512998f..86ae7fa0dea33 100644 --- a/clients/client-ssm/commands/ModifyDocumentPermissionCommand.ts +++ b/clients/client-ssm/commands/ModifyDocumentPermissionCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyDocumentPermissionCommandInput = ModifyDocumentPermissionRequest; export type ModifyDocumentPermissionCommandOutput = ModifyDocumentPermissionResponse & __MetadataBearer; +/** + *

Shares a Systems Manager document publicly or privately. If you share a document privately, you must + * specify the AWS user account IDs for those people who can use the document. If you share a + * document publicly, you must specify All as the account ID.

+ */ export class ModifyDocumentPermissionCommand extends $Command< ModifyDocumentPermissionCommandInput, ModifyDocumentPermissionCommandOutput, @@ -34,6 +39,9 @@ export class ModifyDocumentPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/PutComplianceItemsCommand.ts b/clients/client-ssm/commands/PutComplianceItemsCommand.ts index ff2afc5f40f25..5653709706fe9 100644 --- a/clients/client-ssm/commands/PutComplianceItemsCommand.ts +++ b/clients/client-ssm/commands/PutComplianceItemsCommand.ts @@ -20,6 +20,64 @@ import { export type PutComplianceItemsCommandInput = PutComplianceItemsRequest; export type PutComplianceItemsCommandOutput = PutComplianceItemsResult & __MetadataBearer; +/** + *

Registers a compliance type and other compliance details on a designated resource. This + * action lets you register custom compliance details with a resource. This call overwrites existing + * compliance information on the resource, so you must provide a full list of compliance items each + * time that you send the request.

+ *

ComplianceType can be one of the following:

+ *
    + *
  • + *

    ExecutionId: The execution ID when the patch, association, or custom compliance item was + * applied.

    + *
  • + *
  • + *

    ExecutionType: Specify patch, association, or Custom:string.

    + *
  • + *
  • + *

    ExecutionTime. The time the patch, association, or custom compliance item was applied to + * the instance.

    + *
  • + *
  • + *

    Id: The patch, association, or custom compliance ID.

    + *
  • + *
  • + *

    Title: A title.

    + *
  • + *
  • + *

    Status: The status of the compliance item. For example, approved for patches, + * or Failed for associations.

    + *
  • + *
  • + *

    Severity: A patch severity. For example, critical.

    + *
  • + *
  • + *

    DocumentName: A SSM document name. For example, AWS-RunPatchBaseline.

    + *
  • + *
  • + *

    DocumentVersion: An SSM document version number. For example, 4.

    + *
  • + *
  • + *

    Classification: A patch classification. For example, security updates.

    + *
  • + *
  • + *

    PatchBaselineId: A patch baseline ID.

    + *
  • + *
  • + *

    PatchSeverity: A patch severity. For example, Critical.

    + *
  • + *
  • + *

    PatchState: A patch state. For example, InstancesWithFailedPatches.

    + *
  • + *
  • + *

    PatchGroup: The name of a patch group.

    + *
  • + *
  • + *

    InstalledTime: The time the association, patch, or custom compliance item was applied to + * the resource. Specify the time by using the following format: yyyy-MM-dd'T'HH:mm:ss'Z'

    + *
  • + *
+ */ export class PutComplianceItemsCommand extends $Command< PutComplianceItemsCommandInput, PutComplianceItemsCommandOutput, @@ -34,6 +92,9 @@ export class PutComplianceItemsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/PutInventoryCommand.ts b/clients/client-ssm/commands/PutInventoryCommand.ts index b782fc209becb..a6a796f974af3 100644 --- a/clients/client-ssm/commands/PutInventoryCommand.ts +++ b/clients/client-ssm/commands/PutInventoryCommand.ts @@ -20,6 +20,10 @@ import { export type PutInventoryCommandInput = PutInventoryRequest; export type PutInventoryCommandOutput = PutInventoryResult & __MetadataBearer; +/** + *

Bulk update custom inventory items on one more instance. The request adds an inventory item, + * if it doesn't already exist, or updates an inventory item, if it does exist.

+ */ export class PutInventoryCommand extends $Command< PutInventoryCommandInput, PutInventoryCommandOutput, @@ -34,6 +38,9 @@ export class PutInventoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/PutParameterCommand.ts b/clients/client-ssm/commands/PutParameterCommand.ts index 0203a3268e904..69fdfc7352eed 100644 --- a/clients/client-ssm/commands/PutParameterCommand.ts +++ b/clients/client-ssm/commands/PutParameterCommand.ts @@ -20,6 +20,9 @@ import { export type PutParameterCommandInput = PutParameterRequest; export type PutParameterCommandOutput = PutParameterResult & __MetadataBearer; +/** + *

Add a parameter to the system.

+ */ export class PutParameterCommand extends $Command< PutParameterCommandInput, PutParameterCommandOutput, @@ -34,6 +37,9 @@ export class PutParameterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/RegisterDefaultPatchBaselineCommand.ts b/clients/client-ssm/commands/RegisterDefaultPatchBaselineCommand.ts index eafe2581ddf9d..faa786d1cac8f 100644 --- a/clients/client-ssm/commands/RegisterDefaultPatchBaselineCommand.ts +++ b/clients/client-ssm/commands/RegisterDefaultPatchBaselineCommand.ts @@ -20,6 +20,13 @@ import { export type RegisterDefaultPatchBaselineCommandInput = RegisterDefaultPatchBaselineRequest; export type RegisterDefaultPatchBaselineCommandOutput = RegisterDefaultPatchBaselineResult & __MetadataBearer; +/** + *

Defines the default patch baseline for the relevant operating system.

+ *

To reset the AWS predefined patch baseline as the default, specify the full patch baseline + * ARN as the baseline ID value. For example, for CentOS, specify + * arn:aws:ssm:us-east-2:733109147000:patchbaseline/pb-0574b43a65ea646ed instead of + * pb-0574b43a65ea646ed.

+ */ export class RegisterDefaultPatchBaselineCommand extends $Command< RegisterDefaultPatchBaselineCommandInput, RegisterDefaultPatchBaselineCommandOutput, @@ -34,6 +41,9 @@ export class RegisterDefaultPatchBaselineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/RegisterPatchBaselineForPatchGroupCommand.ts b/clients/client-ssm/commands/RegisterPatchBaselineForPatchGroupCommand.ts index 9eec22d92d95d..73e86d11f585a 100644 --- a/clients/client-ssm/commands/RegisterPatchBaselineForPatchGroupCommand.ts +++ b/clients/client-ssm/commands/RegisterPatchBaselineForPatchGroupCommand.ts @@ -24,6 +24,9 @@ export type RegisterPatchBaselineForPatchGroupCommandInput = RegisterPatchBaseli export type RegisterPatchBaselineForPatchGroupCommandOutput = RegisterPatchBaselineForPatchGroupResult & __MetadataBearer; +/** + *

Registers a patch baseline for a patch group.

+ */ export class RegisterPatchBaselineForPatchGroupCommand extends $Command< RegisterPatchBaselineForPatchGroupCommandInput, RegisterPatchBaselineForPatchGroupCommandOutput, @@ -38,6 +41,9 @@ export class RegisterPatchBaselineForPatchGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/RegisterTargetWithMaintenanceWindowCommand.ts b/clients/client-ssm/commands/RegisterTargetWithMaintenanceWindowCommand.ts index 692f0957cf28b..f2bee77d3ef1a 100644 --- a/clients/client-ssm/commands/RegisterTargetWithMaintenanceWindowCommand.ts +++ b/clients/client-ssm/commands/RegisterTargetWithMaintenanceWindowCommand.ts @@ -24,6 +24,9 @@ export type RegisterTargetWithMaintenanceWindowCommandInput = RegisterTargetWith export type RegisterTargetWithMaintenanceWindowCommandOutput = RegisterTargetWithMaintenanceWindowResult & __MetadataBearer; +/** + *

Registers a target with a maintenance window.

+ */ export class RegisterTargetWithMaintenanceWindowCommand extends $Command< RegisterTargetWithMaintenanceWindowCommandInput, RegisterTargetWithMaintenanceWindowCommandOutput, @@ -38,6 +41,9 @@ export class RegisterTargetWithMaintenanceWindowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/RegisterTaskWithMaintenanceWindowCommand.ts b/clients/client-ssm/commands/RegisterTaskWithMaintenanceWindowCommand.ts index 8327697f738fd..6a656e33baef7 100644 --- a/clients/client-ssm/commands/RegisterTaskWithMaintenanceWindowCommand.ts +++ b/clients/client-ssm/commands/RegisterTaskWithMaintenanceWindowCommand.ts @@ -20,6 +20,9 @@ import { export type RegisterTaskWithMaintenanceWindowCommandInput = RegisterTaskWithMaintenanceWindowRequest; export type RegisterTaskWithMaintenanceWindowCommandOutput = RegisterTaskWithMaintenanceWindowResult & __MetadataBearer; +/** + *

Adds a new task to a maintenance window.

+ */ export class RegisterTaskWithMaintenanceWindowCommand extends $Command< RegisterTaskWithMaintenanceWindowCommandInput, RegisterTaskWithMaintenanceWindowCommandOutput, @@ -34,6 +37,9 @@ export class RegisterTaskWithMaintenanceWindowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/RemoveTagsFromResourceCommand.ts b/clients/client-ssm/commands/RemoveTagsFromResourceCommand.ts index 77fabe9f6ebcc..10e7696cc0e2c 100644 --- a/clients/client-ssm/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-ssm/commands/RemoveTagsFromResourceCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceRequest; export type RemoveTagsFromResourceCommandOutput = RemoveTagsFromResourceResult & __MetadataBearer; +/** + *

Removes tag keys from the specified resource.

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -34,6 +37,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ResetServiceSettingCommand.ts b/clients/client-ssm/commands/ResetServiceSettingCommand.ts index ad8c08c98a7eb..673a6df6832d5 100644 --- a/clients/client-ssm/commands/ResetServiceSettingCommand.ts +++ b/clients/client-ssm/commands/ResetServiceSettingCommand.ts @@ -20,6 +20,23 @@ import { export type ResetServiceSettingCommandInput = ResetServiceSettingRequest; export type ResetServiceSettingCommandOutput = ResetServiceSettingResult & __MetadataBearer; +/** + *

+ * ServiceSetting is an account-level setting for an AWS service. This setting + * defines how a user interacts with or uses a service or a feature of a service. For example, if an + * AWS service charges money to the account based on feature or service usage, then the AWS service + * team might create a default setting of "false". This means the user can't use this feature unless + * they change the setting to "true" and intentionally opt in for a paid feature.

+ *

Services map a SettingId object to a setting value. AWS services teams define + * the default value for a SettingId. You can't create a new SettingId, + * but you can overwrite the default value if you have the ssm:UpdateServiceSetting + * permission for the setting. Use the GetServiceSetting API action to view the + * current value. Use the UpdateServiceSetting API action to change the default + * setting.

+ * + *

Reset the service setting for the account to the default value as provisioned by the AWS + * service team.

+ */ export class ResetServiceSettingCommand extends $Command< ResetServiceSettingCommandInput, ResetServiceSettingCommandOutput, @@ -34,6 +51,9 @@ export class ResetServiceSettingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/ResumeSessionCommand.ts b/clients/client-ssm/commands/ResumeSessionCommand.ts index 8455984891076..f660d8891ab07 100644 --- a/clients/client-ssm/commands/ResumeSessionCommand.ts +++ b/clients/client-ssm/commands/ResumeSessionCommand.ts @@ -20,6 +20,14 @@ import { export type ResumeSessionCommandInput = ResumeSessionRequest; export type ResumeSessionCommandOutput = ResumeSessionResponse & __MetadataBearer; +/** + *

Reconnects a session to an instance after it has been disconnected. Connections can be + * resumed for disconnected sessions, but not terminated sessions.

+ * + *

This command is primarily for use by client machines to automatically reconnect during + * intermittent network issues. It is not intended for any other use.

+ *
+ */ export class ResumeSessionCommand extends $Command< ResumeSessionCommandInput, ResumeSessionCommandOutput, @@ -34,6 +42,9 @@ export class ResumeSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/SendAutomationSignalCommand.ts b/clients/client-ssm/commands/SendAutomationSignalCommand.ts index 4e86b080730c1..825e9d2280498 100644 --- a/clients/client-ssm/commands/SendAutomationSignalCommand.ts +++ b/clients/client-ssm/commands/SendAutomationSignalCommand.ts @@ -20,6 +20,10 @@ import { export type SendAutomationSignalCommandInput = SendAutomationSignalRequest; export type SendAutomationSignalCommandOutput = SendAutomationSignalResult & __MetadataBearer; +/** + *

Sends a signal to an Automation execution to change the current behavior or status of the + * execution.

+ */ export class SendAutomationSignalCommand extends $Command< SendAutomationSignalCommandInput, SendAutomationSignalCommandOutput, @@ -34,6 +38,9 @@ export class SendAutomationSignalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/SendCommandCommand.ts b/clients/client-ssm/commands/SendCommandCommand.ts index 46e848bca8c0c..abbefb78cdaca 100644 --- a/clients/client-ssm/commands/SendCommandCommand.ts +++ b/clients/client-ssm/commands/SendCommandCommand.ts @@ -20,6 +20,9 @@ import { export type SendCommandCommandInput = SendCommandRequest; export type SendCommandCommandOutput = SendCommandResult & __MetadataBearer; +/** + *

Runs commands on one or more managed instances.

+ */ export class SendCommandCommand extends $Command< SendCommandCommandInput, SendCommandCommandOutput, @@ -34,6 +37,9 @@ export class SendCommandCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/StartAssociationsOnceCommand.ts b/clients/client-ssm/commands/StartAssociationsOnceCommand.ts index 3ee9fea20bc56..c7c0d078771c0 100644 --- a/clients/client-ssm/commands/StartAssociationsOnceCommand.ts +++ b/clients/client-ssm/commands/StartAssociationsOnceCommand.ts @@ -20,6 +20,10 @@ import { export type StartAssociationsOnceCommandInput = StartAssociationsOnceRequest; export type StartAssociationsOnceCommandOutput = StartAssociationsOnceResult & __MetadataBearer; +/** + *

Use this API action to run an association immediately and only one time. This action can be + * helpful when troubleshooting associations.

+ */ export class StartAssociationsOnceCommand extends $Command< StartAssociationsOnceCommandInput, StartAssociationsOnceCommandOutput, @@ -34,6 +38,9 @@ export class StartAssociationsOnceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/StartAutomationExecutionCommand.ts b/clients/client-ssm/commands/StartAutomationExecutionCommand.ts index 3094374a746b3..27bc22bd81c2d 100644 --- a/clients/client-ssm/commands/StartAutomationExecutionCommand.ts +++ b/clients/client-ssm/commands/StartAutomationExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type StartAutomationExecutionCommandInput = StartAutomationExecutionRequest; export type StartAutomationExecutionCommandOutput = StartAutomationExecutionResult & __MetadataBearer; +/** + *

Initiates execution of an Automation document.

+ */ export class StartAutomationExecutionCommand extends $Command< StartAutomationExecutionCommandInput, StartAutomationExecutionCommandOutput, @@ -34,6 +37,9 @@ export class StartAutomationExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/StartSessionCommand.ts b/clients/client-ssm/commands/StartSessionCommand.ts index 2fa085c1d0289..21f45db42342d 100644 --- a/clients/client-ssm/commands/StartSessionCommand.ts +++ b/clients/client-ssm/commands/StartSessionCommand.ts @@ -20,6 +20,18 @@ import { export type StartSessionCommandInput = StartSessionRequest; export type StartSessionCommandOutput = StartSessionResponse & __MetadataBearer; +/** + *

Initiates a connection to a target (for example, an instance) for a Session Manager session. Returns a + * URL and token that can be used to open a WebSocket connection for sending input and receiving + * outputs.

+ * + *

AWS CLI usage: start-session is an interactive command that requires the Session Manager + * plugin to be installed on the client machine making the call. For information, see Install + * the Session Manager plugin for the AWS CLI in the AWS Systems Manager User Guide.

+ *

AWS Tools for PowerShell usage: Start-SSMSession is not currently supported by AWS Tools + * for PowerShell on Windows local machines.

+ *
+ */ export class StartSessionCommand extends $Command< StartSessionCommandInput, StartSessionCommandOutput, @@ -34,6 +46,9 @@ export class StartSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/StopAutomationExecutionCommand.ts b/clients/client-ssm/commands/StopAutomationExecutionCommand.ts index fb03cccdfcd01..a3df16b4d2b0a 100644 --- a/clients/client-ssm/commands/StopAutomationExecutionCommand.ts +++ b/clients/client-ssm/commands/StopAutomationExecutionCommand.ts @@ -20,6 +20,9 @@ import { export type StopAutomationExecutionCommandInput = StopAutomationExecutionRequest; export type StopAutomationExecutionCommandOutput = StopAutomationExecutionResult & __MetadataBearer; +/** + *

Stop an Automation that is currently running.

+ */ export class StopAutomationExecutionCommand extends $Command< StopAutomationExecutionCommandInput, StopAutomationExecutionCommandOutput, @@ -34,6 +37,9 @@ export class StopAutomationExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/TerminateSessionCommand.ts b/clients/client-ssm/commands/TerminateSessionCommand.ts index a47463fd35280..defc67b42eb09 100644 --- a/clients/client-ssm/commands/TerminateSessionCommand.ts +++ b/clients/client-ssm/commands/TerminateSessionCommand.ts @@ -20,6 +20,10 @@ import { export type TerminateSessionCommandInput = TerminateSessionRequest; export type TerminateSessionCommandOutput = TerminateSessionResponse & __MetadataBearer; +/** + *

Permanently ends a session and closes the data connection between the Session Manager client and + * SSM Agent on the instance. A terminated session cannot be resumed.

+ */ export class TerminateSessionCommand extends $Command< TerminateSessionCommandInput, TerminateSessionCommandOutput, @@ -34,6 +38,9 @@ export class TerminateSessionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateAssociationCommand.ts b/clients/client-ssm/commands/UpdateAssociationCommand.ts index 5e142168fb865..4b5c44d23f0c6 100644 --- a/clients/client-ssm/commands/UpdateAssociationCommand.ts +++ b/clients/client-ssm/commands/UpdateAssociationCommand.ts @@ -20,6 +20,21 @@ import { export type UpdateAssociationCommandInput = UpdateAssociationRequest; export type UpdateAssociationCommandOutput = UpdateAssociationResult & __MetadataBearer; +/** + *

Updates an association. You can update the association name and version, the document + * version, schedule, parameters, and Amazon S3 output.

+ *

In order to call this API action, your IAM user account, group, or role must be configured + * with permission to call the DescribeAssociation API action. If you don't have + * permission to call DescribeAssociation, then you receive the following error: An error + * occurred (AccessDeniedException) when calling the UpdateAssociation operation: User: + * is not authorized to perform: ssm:DescribeAssociation on resource: + * + *

+ * + *

When you update an association, the association immediately runs against the specified + * targets.

+ *
+ */ export class UpdateAssociationCommand extends $Command< UpdateAssociationCommandInput, UpdateAssociationCommandOutput, @@ -34,6 +49,9 @@ export class UpdateAssociationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateAssociationStatusCommand.ts b/clients/client-ssm/commands/UpdateAssociationStatusCommand.ts index c013ee62916f2..05a1996ed19ab 100644 --- a/clients/client-ssm/commands/UpdateAssociationStatusCommand.ts +++ b/clients/client-ssm/commands/UpdateAssociationStatusCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAssociationStatusCommandInput = UpdateAssociationStatusRequest; export type UpdateAssociationStatusCommandOutput = UpdateAssociationStatusResult & __MetadataBearer; +/** + *

Updates the status of the Systems Manager document associated with the specified instance.

+ */ export class UpdateAssociationStatusCommand extends $Command< UpdateAssociationStatusCommandInput, UpdateAssociationStatusCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAssociationStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateDocumentCommand.ts b/clients/client-ssm/commands/UpdateDocumentCommand.ts index 881944fc590ff..1c8e935496833 100644 --- a/clients/client-ssm/commands/UpdateDocumentCommand.ts +++ b/clients/client-ssm/commands/UpdateDocumentCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDocumentCommandInput = UpdateDocumentRequest; export type UpdateDocumentCommandOutput = UpdateDocumentResult & __MetadataBearer; +/** + *

Updates one or more values for an SSM document.

+ */ export class UpdateDocumentCommand extends $Command< UpdateDocumentCommandInput, UpdateDocumentCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateDocumentDefaultVersionCommand.ts b/clients/client-ssm/commands/UpdateDocumentDefaultVersionCommand.ts index 1c4e2d50a0b7f..ddbaac49e491d 100644 --- a/clients/client-ssm/commands/UpdateDocumentDefaultVersionCommand.ts +++ b/clients/client-ssm/commands/UpdateDocumentDefaultVersionCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDocumentDefaultVersionCommandInput = UpdateDocumentDefaultVersionRequest; export type UpdateDocumentDefaultVersionCommandOutput = UpdateDocumentDefaultVersionResult & __MetadataBearer; +/** + *

Set the default version of a document.

+ */ export class UpdateDocumentDefaultVersionCommand extends $Command< UpdateDocumentDefaultVersionCommandInput, UpdateDocumentDefaultVersionCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDocumentDefaultVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateMaintenanceWindowCommand.ts b/clients/client-ssm/commands/UpdateMaintenanceWindowCommand.ts index 6f96af787655d..cff14a1d8b7f8 100644 --- a/clients/client-ssm/commands/UpdateMaintenanceWindowCommand.ts +++ b/clients/client-ssm/commands/UpdateMaintenanceWindowCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateMaintenanceWindowCommandInput = UpdateMaintenanceWindowRequest; export type UpdateMaintenanceWindowCommandOutput = UpdateMaintenanceWindowResult & __MetadataBearer; +/** + *

Updates an existing maintenance window. Only specified parameters are modified.

+ * + *

The value you specify for Duration determines the specific end time for the + * maintenance window based on the time it begins. No maintenance window tasks are permitted to + * start after the resulting endtime minus the number of hours you specify for Cutoff. + * For example, if the maintenance window starts at 3 PM, the duration is three hours, and the + * value you specify for Cutoff is one hour, no maintenance window tasks can start + * after 5 PM.

+ *
+ */ export class UpdateMaintenanceWindowCommand extends $Command< UpdateMaintenanceWindowCommandInput, UpdateMaintenanceWindowCommandOutput, @@ -34,6 +45,9 @@ export class UpdateMaintenanceWindowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateMaintenanceWindowTargetCommand.ts b/clients/client-ssm/commands/UpdateMaintenanceWindowTargetCommand.ts index 74be83b06060d..79131fd0e23ec 100644 --- a/clients/client-ssm/commands/UpdateMaintenanceWindowTargetCommand.ts +++ b/clients/client-ssm/commands/UpdateMaintenanceWindowTargetCommand.ts @@ -20,6 +20,35 @@ import { export type UpdateMaintenanceWindowTargetCommandInput = UpdateMaintenanceWindowTargetRequest; export type UpdateMaintenanceWindowTargetCommandOutput = UpdateMaintenanceWindowTargetResult & __MetadataBearer; +/** + *

Modifies the target of an existing maintenance window. You + * can change the following:

+ * + *
    + *
  • + *

    Name

    + *
  • + *
  • + *

    Description

    + *
  • + *
  • + *

    Owner

    + *
  • + *
  • + *

    IDs for an ID target

    + *
  • + *
  • + *

    Tags for a Tag target

    + *
  • + *
  • + *

    From any supported tag type to another. The three supported tag types are ID target, Tag + * target, and resource group. For more information, see Target.

    + *
  • + *
+ * + *

If a parameter is null, then the corresponding field is not modified.

+ *
+ */ export class UpdateMaintenanceWindowTargetCommand extends $Command< UpdateMaintenanceWindowTargetCommandInput, UpdateMaintenanceWindowTargetCommandOutput, @@ -34,6 +63,9 @@ export class UpdateMaintenanceWindowTargetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateMaintenanceWindowTaskCommand.ts b/clients/client-ssm/commands/UpdateMaintenanceWindowTaskCommand.ts index 53d11ea932eca..f8d1587830f9e 100644 --- a/clients/client-ssm/commands/UpdateMaintenanceWindowTaskCommand.ts +++ b/clients/client-ssm/commands/UpdateMaintenanceWindowTaskCommand.ts @@ -20,6 +20,45 @@ import { export type UpdateMaintenanceWindowTaskCommandInput = UpdateMaintenanceWindowTaskRequest; export type UpdateMaintenanceWindowTaskCommandOutput = UpdateMaintenanceWindowTaskResult & __MetadataBearer; +/** + *

Modifies a task assigned to a maintenance window. You can't change the task type, but you + * can change the following values:

+ *
    + *
  • + *

    TaskARN. For example, you can change a RUN_COMMAND task from AWS-RunPowerShellScript to + * AWS-RunShellScript.

    + *
  • + *
  • + *

    ServiceRoleArn

    + *
  • + *
  • + *

    TaskInvocationParameters

    + *
  • + *
  • + *

    Priority

    + *
  • + *
  • + *

    MaxConcurrency

    + *
  • + *
  • + *

    MaxErrors

    + *
  • + *
+ *

If the value for a parameter in UpdateMaintenanceWindowTask is null, then the + * corresponding field is not modified. If you set Replace to true, then all fields + * required by the RegisterTaskWithMaintenanceWindow action are required for this + * request. Optional fields that aren't specified are set to null.

+ * + *

When you update a maintenance window task that has options specified in + * TaskInvocationParameters, you must provide again all the + * TaskInvocationParameters values that you want to retain. The values you do not + * specify again are removed. For example, suppose that when you registered a Run Command task, you + * specified TaskInvocationParameters values for Comment, + * NotificationConfig, and OutputS3BucketName. If you update the + * maintenance window task and specify only a different OutputS3BucketName value, the + * values for Comment and NotificationConfig are removed.

+ *
+ */ export class UpdateMaintenanceWindowTaskCommand extends $Command< UpdateMaintenanceWindowTaskCommandInput, UpdateMaintenanceWindowTaskCommandOutput, @@ -34,6 +73,9 @@ export class UpdateMaintenanceWindowTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateManagedInstanceRoleCommand.ts b/clients/client-ssm/commands/UpdateManagedInstanceRoleCommand.ts index b3c837c246652..0a2b33056ce34 100644 --- a/clients/client-ssm/commands/UpdateManagedInstanceRoleCommand.ts +++ b/clients/client-ssm/commands/UpdateManagedInstanceRoleCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateManagedInstanceRoleCommandInput = UpdateManagedInstanceRoleRequest; export type UpdateManagedInstanceRoleCommandOutput = UpdateManagedInstanceRoleResult & __MetadataBearer; +/** + *

Changes the Amazon Identity and Access Management (IAM) role that is assigned to the + * on-premises instance or virtual machines (VM). IAM roles are first assigned to these hybrid + * instances during the activation process. For more information, see CreateActivation.

+ */ export class UpdateManagedInstanceRoleCommand extends $Command< UpdateManagedInstanceRoleCommandInput, UpdateManagedInstanceRoleCommandOutput, @@ -34,6 +39,9 @@ export class UpdateManagedInstanceRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateOpsItemCommand.ts b/clients/client-ssm/commands/UpdateOpsItemCommand.ts index 5b2c59344f336..bcab85743a687 100644 --- a/clients/client-ssm/commands/UpdateOpsItemCommand.ts +++ b/clients/client-ssm/commands/UpdateOpsItemCommand.ts @@ -20,6 +20,15 @@ import { export type UpdateOpsItemCommandInput = UpdateOpsItemRequest; export type UpdateOpsItemCommandOutput = UpdateOpsItemResponse & __MetadataBearer; +/** + *

Edit or change an OpsItem. You must have permission in AWS Identity and Access Management + * (IAM) to update an OpsItem. For more information, see Getting started with + * OpsCenter in the AWS Systems Manager User Guide.

+ *

Operations engineers and IT professionals use OpsCenter to view, investigate, and remediate + * operational issues impacting the performance and health of their AWS resources. For more + * information, see AWS Systems Manager OpsCenter in the + * AWS Systems Manager User Guide.

+ */ export class UpdateOpsItemCommand extends $Command< UpdateOpsItemCommandInput, UpdateOpsItemCommandOutput, @@ -34,6 +43,9 @@ export class UpdateOpsItemCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdatePatchBaselineCommand.ts b/clients/client-ssm/commands/UpdatePatchBaselineCommand.ts index db683830fdb7c..229753afb03e7 100644 --- a/clients/client-ssm/commands/UpdatePatchBaselineCommand.ts +++ b/clients/client-ssm/commands/UpdatePatchBaselineCommand.ts @@ -20,6 +20,14 @@ import { export type UpdatePatchBaselineCommandInput = UpdatePatchBaselineRequest; export type UpdatePatchBaselineCommandOutput = UpdatePatchBaselineResult & __MetadataBearer; +/** + *

Modifies an existing patch baseline. Fields not specified in the request are left + * unchanged.

+ * + *

For information about valid key and value pairs in PatchFilters for each + * supported operating system type, see PatchFilter.

+ *
+ */ export class UpdatePatchBaselineCommand extends $Command< UpdatePatchBaselineCommandInput, UpdatePatchBaselineCommandOutput, @@ -34,6 +42,9 @@ export class UpdatePatchBaselineCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateResourceDataSyncCommand.ts b/clients/client-ssm/commands/UpdateResourceDataSyncCommand.ts index 842934f2ff5ea..62feaaf8e6c36 100644 --- a/clients/client-ssm/commands/UpdateResourceDataSyncCommand.ts +++ b/clients/client-ssm/commands/UpdateResourceDataSyncCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateResourceDataSyncCommandInput = UpdateResourceDataSyncRequest; export type UpdateResourceDataSyncCommandOutput = UpdateResourceDataSyncResult & __MetadataBearer; +/** + *

Update a resource data sync. After you create a resource data sync for a Region, you can't + * change the account options for that sync. For example, if you create a sync in the us-east-2 + * (Ohio) Region and you choose the Include only the current account option, you can't edit that + * sync later and choose the Include all accounts from my AWS Organizations configuration option. Instead, + * you must delete the first resource data sync, and create a new one.

+ * + *

This API action only supports a resource data sync that was created with a SyncFromSource + * SyncType.

+ *
+ */ export class UpdateResourceDataSyncCommand extends $Command< UpdateResourceDataSyncCommandInput, UpdateResourceDataSyncCommandOutput, @@ -34,6 +45,9 @@ export class UpdateResourceDataSyncCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/commands/UpdateServiceSettingCommand.ts b/clients/client-ssm/commands/UpdateServiceSettingCommand.ts index fb7bacae3745a..b17c0bfd9d1db 100644 --- a/clients/client-ssm/commands/UpdateServiceSettingCommand.ts +++ b/clients/client-ssm/commands/UpdateServiceSettingCommand.ts @@ -20,6 +20,22 @@ import { export type UpdateServiceSettingCommandInput = UpdateServiceSettingRequest; export type UpdateServiceSettingCommandOutput = UpdateServiceSettingResult & __MetadataBearer; +/** + *

+ * ServiceSetting is an account-level setting for an AWS service. This setting + * defines how a user interacts with or uses a service or a feature of a service. For example, if an + * AWS service charges money to the account based on feature or service usage, then the AWS service + * team might create a default setting of "false". This means the user can't use this feature unless + * they change the setting to "true" and intentionally opt in for a paid feature.

+ *

Services map a SettingId object to a setting value. AWS services teams define + * the default value for a SettingId. You can't create a new SettingId, + * but you can overwrite the default value if you have the ssm:UpdateServiceSetting + * permission for the setting. Use the GetServiceSetting API action to view the + * current value. Or, use the ResetServiceSetting to change the value back to the + * original value defined by the AWS service team.

+ * + *

Update the service setting for the account.

+ */ export class UpdateServiceSettingCommand extends $Command< UpdateServiceSettingCommandInput, UpdateServiceSettingCommandOutput, @@ -34,6 +50,9 @@ export class UpdateServiceSettingCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSMClientResolvedConfig, diff --git a/clients/client-ssm/package.json b/clients/client-ssm/package.json index 99a22f99e07e1..f5bd94e2a5482 100644 --- a/clients/client-ssm/package.json +++ b/clients/client-ssm/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Ssm Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-ssm/pagination/DescribeActivationsPaginator.ts b/clients/client-ssm/pagination/DescribeActivationsPaginator.ts index e15b065cbf377..26c7a9c633a01 100644 --- a/clients/client-ssm/pagination/DescribeActivationsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeActivationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeActivationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeActivationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeActivationsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeAssociationExecutionTargetsPaginator.ts b/clients/client-ssm/pagination/DescribeAssociationExecutionTargetsPaginator.ts index b7afc8b75c392..e84abd5987d8a 100644 --- a/clients/client-ssm/pagination/DescribeAssociationExecutionTargetsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeAssociationExecutionTargetsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeAssociationExecutionTargetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAssociationExecutionTargetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeAssociationExecutionTargetsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeAssociationExecutionsPaginator.ts b/clients/client-ssm/pagination/DescribeAssociationExecutionsPaginator.ts index 5b458a5a875cc..65bbbc83c426b 100644 --- a/clients/client-ssm/pagination/DescribeAssociationExecutionsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeAssociationExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeAssociationExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAssociationExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeAssociationExecutionsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeAutomationExecutionsPaginator.ts b/clients/client-ssm/pagination/DescribeAutomationExecutionsPaginator.ts index 0dec0d0b2c87a..d5818439c0f3c 100644 --- a/clients/client-ssm/pagination/DescribeAutomationExecutionsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeAutomationExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeAutomationExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAutomationExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeAutomationExecutionsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeAutomationStepExecutionsPaginator.ts b/clients/client-ssm/pagination/DescribeAutomationStepExecutionsPaginator.ts index 5e2ca950d4d95..ca801353832ff 100644 --- a/clients/client-ssm/pagination/DescribeAutomationStepExecutionsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeAutomationStepExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeAutomationStepExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAutomationStepExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeAutomationStepExecutionsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeAvailablePatchesPaginator.ts b/clients/client-ssm/pagination/DescribeAvailablePatchesPaginator.ts index ee5270a4cd078..aa5fb2094ccde 100644 --- a/clients/client-ssm/pagination/DescribeAvailablePatchesPaginator.ts +++ b/clients/client-ssm/pagination/DescribeAvailablePatchesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeAvailablePatchesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeAvailablePatchesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeAvailablePatchesCommandInput, diff --git a/clients/client-ssm/pagination/DescribeEffectiveInstanceAssociationsPaginator.ts b/clients/client-ssm/pagination/DescribeEffectiveInstanceAssociationsPaginator.ts index 5ddc5756535b5..b27d0aac8abe0 100644 --- a/clients/client-ssm/pagination/DescribeEffectiveInstanceAssociationsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeEffectiveInstanceAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeEffectiveInstanceAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEffectiveInstanceAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeEffectiveInstanceAssociationsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeEffectivePatchesForPatchBaselinePaginator.ts b/clients/client-ssm/pagination/DescribeEffectivePatchesForPatchBaselinePaginator.ts index f8ccd21d8a6e8..69ffe7db44ea6 100644 --- a/clients/client-ssm/pagination/DescribeEffectivePatchesForPatchBaselinePaginator.ts +++ b/clients/client-ssm/pagination/DescribeEffectivePatchesForPatchBaselinePaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeEffectivePatchesForPatchBaselineCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeEffectivePatchesForPatchBaselineCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeEffectivePatchesForPatchBaselineCommandInput, diff --git a/clients/client-ssm/pagination/DescribeInstanceAssociationsStatusPaginator.ts b/clients/client-ssm/pagination/DescribeInstanceAssociationsStatusPaginator.ts index 490acd6b4bf47..6fef1493b1e31 100644 --- a/clients/client-ssm/pagination/DescribeInstanceAssociationsStatusPaginator.ts +++ b/clients/client-ssm/pagination/DescribeInstanceAssociationsStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeInstanceAssociationsStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstanceAssociationsStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeInstanceAssociationsStatusCommandInput, diff --git a/clients/client-ssm/pagination/DescribeInstanceInformationPaginator.ts b/clients/client-ssm/pagination/DescribeInstanceInformationPaginator.ts index 3b318cbe2af26..728eea6be67bd 100644 --- a/clients/client-ssm/pagination/DescribeInstanceInformationPaginator.ts +++ b/clients/client-ssm/pagination/DescribeInstanceInformationPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeInstanceInformationCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstanceInformationCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeInstanceInformationCommandInput, diff --git a/clients/client-ssm/pagination/DescribeInstancePatchStatesForPatchGroupPaginator.ts b/clients/client-ssm/pagination/DescribeInstancePatchStatesForPatchGroupPaginator.ts index 3851f7e57da1a..c1730c35165fc 100644 --- a/clients/client-ssm/pagination/DescribeInstancePatchStatesForPatchGroupPaginator.ts +++ b/clients/client-ssm/pagination/DescribeInstancePatchStatesForPatchGroupPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeInstancePatchStatesForPatchGroupCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstancePatchStatesForPatchGroupCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeInstancePatchStatesForPatchGroupCommandInput, diff --git a/clients/client-ssm/pagination/DescribeInstancePatchStatesPaginator.ts b/clients/client-ssm/pagination/DescribeInstancePatchStatesPaginator.ts index f21df8dd2eaf7..32af28f99532b 100644 --- a/clients/client-ssm/pagination/DescribeInstancePatchStatesPaginator.ts +++ b/clients/client-ssm/pagination/DescribeInstancePatchStatesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeInstancePatchStatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstancePatchStatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeInstancePatchStatesCommandInput, diff --git a/clients/client-ssm/pagination/DescribeInstancePatchesPaginator.ts b/clients/client-ssm/pagination/DescribeInstancePatchesPaginator.ts index 1fe8350ddf38b..46653ffc1badd 100644 --- a/clients/client-ssm/pagination/DescribeInstancePatchesPaginator.ts +++ b/clients/client-ssm/pagination/DescribeInstancePatchesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeInstancePatchesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInstancePatchesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeInstancePatchesCommandInput, diff --git a/clients/client-ssm/pagination/DescribeInventoryDeletionsPaginator.ts b/clients/client-ssm/pagination/DescribeInventoryDeletionsPaginator.ts index 7583164764ef5..4586bbf57ebaf 100644 --- a/clients/client-ssm/pagination/DescribeInventoryDeletionsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeInventoryDeletionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeInventoryDeletionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeInventoryDeletionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeInventoryDeletionsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionTaskInvocationsPaginator.ts b/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionTaskInvocationsPaginator.ts index 27bd8392321a2..4b76e7fe7b8b0 100644 --- a/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionTaskInvocationsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionTaskInvocationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeMaintenanceWindowExecutionTaskInvocationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMaintenanceWindowExecutionTaskInvocationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeMaintenanceWindowExecutionTaskInvocationsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionTasksPaginator.ts b/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionTasksPaginator.ts index 015212f5796ab..a9788c9fcb155 100644 --- a/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionTasksPaginator.ts +++ b/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeMaintenanceWindowExecutionTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMaintenanceWindowExecutionTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeMaintenanceWindowExecutionTasksCommandInput, diff --git a/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionsPaginator.ts b/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionsPaginator.ts index a37e4a06602ac..c62b35024543b 100644 --- a/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeMaintenanceWindowExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeMaintenanceWindowExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMaintenanceWindowExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeMaintenanceWindowExecutionsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeMaintenanceWindowSchedulePaginator.ts b/clients/client-ssm/pagination/DescribeMaintenanceWindowSchedulePaginator.ts index 24588dcd4ada1..bf3bdefc30d55 100644 --- a/clients/client-ssm/pagination/DescribeMaintenanceWindowSchedulePaginator.ts +++ b/clients/client-ssm/pagination/DescribeMaintenanceWindowSchedulePaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeMaintenanceWindowScheduleCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMaintenanceWindowScheduleCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeMaintenanceWindowScheduleCommandInput, diff --git a/clients/client-ssm/pagination/DescribeMaintenanceWindowTargetsPaginator.ts b/clients/client-ssm/pagination/DescribeMaintenanceWindowTargetsPaginator.ts index 86a7bbde259c3..a12f4532c5ba6 100644 --- a/clients/client-ssm/pagination/DescribeMaintenanceWindowTargetsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeMaintenanceWindowTargetsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeMaintenanceWindowTargetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMaintenanceWindowTargetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeMaintenanceWindowTargetsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeMaintenanceWindowTasksPaginator.ts b/clients/client-ssm/pagination/DescribeMaintenanceWindowTasksPaginator.ts index dd764affac85c..0c8a8496b8b73 100644 --- a/clients/client-ssm/pagination/DescribeMaintenanceWindowTasksPaginator.ts +++ b/clients/client-ssm/pagination/DescribeMaintenanceWindowTasksPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeMaintenanceWindowTasksCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMaintenanceWindowTasksCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeMaintenanceWindowTasksCommandInput, diff --git a/clients/client-ssm/pagination/DescribeMaintenanceWindowsForTargetPaginator.ts b/clients/client-ssm/pagination/DescribeMaintenanceWindowsForTargetPaginator.ts index bc48a8f8a1bcc..9e54339a36b57 100644 --- a/clients/client-ssm/pagination/DescribeMaintenanceWindowsForTargetPaginator.ts +++ b/clients/client-ssm/pagination/DescribeMaintenanceWindowsForTargetPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeMaintenanceWindowsForTargetCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMaintenanceWindowsForTargetCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeMaintenanceWindowsForTargetCommandInput, diff --git a/clients/client-ssm/pagination/DescribeMaintenanceWindowsPaginator.ts b/clients/client-ssm/pagination/DescribeMaintenanceWindowsPaginator.ts index 3276913076d79..4eb88d7d96d70 100644 --- a/clients/client-ssm/pagination/DescribeMaintenanceWindowsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeMaintenanceWindowsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeMaintenanceWindowsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeMaintenanceWindowsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeMaintenanceWindowsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeOpsItemsPaginator.ts b/clients/client-ssm/pagination/DescribeOpsItemsPaginator.ts index 4986d1ae3dc0a..8237385663eec 100644 --- a/clients/client-ssm/pagination/DescribeOpsItemsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeOpsItemsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeOpsItemsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeOpsItemsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeOpsItemsCommandInput, diff --git a/clients/client-ssm/pagination/DescribeParametersPaginator.ts b/clients/client-ssm/pagination/DescribeParametersPaginator.ts index 7c4da32fe2f3b..7e69f4cef093f 100644 --- a/clients/client-ssm/pagination/DescribeParametersPaginator.ts +++ b/clients/client-ssm/pagination/DescribeParametersPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeParametersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeParametersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeParametersCommandInput, diff --git a/clients/client-ssm/pagination/DescribePatchBaselinesPaginator.ts b/clients/client-ssm/pagination/DescribePatchBaselinesPaginator.ts index b228dad4a38fd..fdb4b199862b7 100644 --- a/clients/client-ssm/pagination/DescribePatchBaselinesPaginator.ts +++ b/clients/client-ssm/pagination/DescribePatchBaselinesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribePatchBaselinesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePatchBaselinesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribePatchBaselinesCommandInput, diff --git a/clients/client-ssm/pagination/DescribePatchGroupsPaginator.ts b/clients/client-ssm/pagination/DescribePatchGroupsPaginator.ts index 0346227fef710..398bf9d59ef1d 100644 --- a/clients/client-ssm/pagination/DescribePatchGroupsPaginator.ts +++ b/clients/client-ssm/pagination/DescribePatchGroupsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribePatchGroupsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePatchGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribePatchGroupsCommandInput, diff --git a/clients/client-ssm/pagination/DescribePatchPropertiesPaginator.ts b/clients/client-ssm/pagination/DescribePatchPropertiesPaginator.ts index de18036ab3e79..845d10d6c875e 100644 --- a/clients/client-ssm/pagination/DescribePatchPropertiesPaginator.ts +++ b/clients/client-ssm/pagination/DescribePatchPropertiesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribePatchPropertiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribePatchPropertiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribePatchPropertiesCommandInput, diff --git a/clients/client-ssm/pagination/DescribeSessionsPaginator.ts b/clients/client-ssm/pagination/DescribeSessionsPaginator.ts index c4aa5644d1af2..cebf98413afd9 100644 --- a/clients/client-ssm/pagination/DescribeSessionsPaginator.ts +++ b/clients/client-ssm/pagination/DescribeSessionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: DescribeSessionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeSessionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: DescribeSessionsCommandInput, diff --git a/clients/client-ssm/pagination/GetInventoryPaginator.ts b/clients/client-ssm/pagination/GetInventoryPaginator.ts index 798b8465b355e..6ad7b9915e43e 100644 --- a/clients/client-ssm/pagination/GetInventoryPaginator.ts +++ b/clients/client-ssm/pagination/GetInventoryPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: GetInventoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetInventoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: GetInventoryCommandInput, diff --git a/clients/client-ssm/pagination/GetInventorySchemaPaginator.ts b/clients/client-ssm/pagination/GetInventorySchemaPaginator.ts index 9612f196b9821..85ac81ecece47 100644 --- a/clients/client-ssm/pagination/GetInventorySchemaPaginator.ts +++ b/clients/client-ssm/pagination/GetInventorySchemaPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: GetInventorySchemaCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetInventorySchemaCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: GetInventorySchemaCommandInput, diff --git a/clients/client-ssm/pagination/GetOpsSummaryPaginator.ts b/clients/client-ssm/pagination/GetOpsSummaryPaginator.ts index b102bc3dbd9c9..a81aaa64d9682 100644 --- a/clients/client-ssm/pagination/GetOpsSummaryPaginator.ts +++ b/clients/client-ssm/pagination/GetOpsSummaryPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: GetOpsSummaryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetOpsSummaryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: GetOpsSummaryCommandInput, diff --git a/clients/client-ssm/pagination/GetParameterHistoryPaginator.ts b/clients/client-ssm/pagination/GetParameterHistoryPaginator.ts index 0fa6b8cc69550..380d3a360c450 100644 --- a/clients/client-ssm/pagination/GetParameterHistoryPaginator.ts +++ b/clients/client-ssm/pagination/GetParameterHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: GetParameterHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetParameterHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: GetParameterHistoryCommandInput, diff --git a/clients/client-ssm/pagination/GetParametersByPathPaginator.ts b/clients/client-ssm/pagination/GetParametersByPathPaginator.ts index 02eaa84aa34d6..e7f6780153d70 100644 --- a/clients/client-ssm/pagination/GetParametersByPathPaginator.ts +++ b/clients/client-ssm/pagination/GetParametersByPathPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: GetParametersByPathCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetParametersByPathCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: GetParametersByPathCommandInput, diff --git a/clients/client-ssm/pagination/ListAssociationVersionsPaginator.ts b/clients/client-ssm/pagination/ListAssociationVersionsPaginator.ts index fdc1fe2519075..3aaf18e02f210 100644 --- a/clients/client-ssm/pagination/ListAssociationVersionsPaginator.ts +++ b/clients/client-ssm/pagination/ListAssociationVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListAssociationVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssociationVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListAssociationVersionsCommandInput, diff --git a/clients/client-ssm/pagination/ListAssociationsPaginator.ts b/clients/client-ssm/pagination/ListAssociationsPaginator.ts index 45f826680b175..e296fbcaa5a07 100644 --- a/clients/client-ssm/pagination/ListAssociationsPaginator.ts +++ b/clients/client-ssm/pagination/ListAssociationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListAssociationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAssociationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListAssociationsCommandInput, diff --git a/clients/client-ssm/pagination/ListCommandInvocationsPaginator.ts b/clients/client-ssm/pagination/ListCommandInvocationsPaginator.ts index c95b80007a5ac..945b1d3887870 100644 --- a/clients/client-ssm/pagination/ListCommandInvocationsPaginator.ts +++ b/clients/client-ssm/pagination/ListCommandInvocationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListCommandInvocationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCommandInvocationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListCommandInvocationsCommandInput, diff --git a/clients/client-ssm/pagination/ListCommandsPaginator.ts b/clients/client-ssm/pagination/ListCommandsPaginator.ts index 66575f04183d9..a1c438ed7339b 100644 --- a/clients/client-ssm/pagination/ListCommandsPaginator.ts +++ b/clients/client-ssm/pagination/ListCommandsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListCommandsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListCommandsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListCommandsCommandInput, diff --git a/clients/client-ssm/pagination/ListComplianceItemsPaginator.ts b/clients/client-ssm/pagination/ListComplianceItemsPaginator.ts index 15cc47d3c568e..9b96c3b012889 100644 --- a/clients/client-ssm/pagination/ListComplianceItemsPaginator.ts +++ b/clients/client-ssm/pagination/ListComplianceItemsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListComplianceItemsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListComplianceItemsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListComplianceItemsCommandInput, diff --git a/clients/client-ssm/pagination/ListComplianceSummariesPaginator.ts b/clients/client-ssm/pagination/ListComplianceSummariesPaginator.ts index ba4bc418bb324..3b0360fee6258 100644 --- a/clients/client-ssm/pagination/ListComplianceSummariesPaginator.ts +++ b/clients/client-ssm/pagination/ListComplianceSummariesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListComplianceSummariesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListComplianceSummariesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListComplianceSummariesCommandInput, diff --git a/clients/client-ssm/pagination/ListDocumentVersionsPaginator.ts b/clients/client-ssm/pagination/ListDocumentVersionsPaginator.ts index 4e4eb586e2085..5fa0f65f88a96 100644 --- a/clients/client-ssm/pagination/ListDocumentVersionsPaginator.ts +++ b/clients/client-ssm/pagination/ListDocumentVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListDocumentVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDocumentVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListDocumentVersionsCommandInput, diff --git a/clients/client-ssm/pagination/ListDocumentsPaginator.ts b/clients/client-ssm/pagination/ListDocumentsPaginator.ts index 2772e9eed3d04..596ea0d7201e0 100644 --- a/clients/client-ssm/pagination/ListDocumentsPaginator.ts +++ b/clients/client-ssm/pagination/ListDocumentsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListDocumentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDocumentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListDocumentsCommandInput, diff --git a/clients/client-ssm/pagination/ListResourceComplianceSummariesPaginator.ts b/clients/client-ssm/pagination/ListResourceComplianceSummariesPaginator.ts index 4cb1344a1cb55..2653017a4c131 100644 --- a/clients/client-ssm/pagination/ListResourceComplianceSummariesPaginator.ts +++ b/clients/client-ssm/pagination/ListResourceComplianceSummariesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListResourceComplianceSummariesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourceComplianceSummariesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListResourceComplianceSummariesCommandInput, diff --git a/clients/client-ssm/pagination/ListResourceDataSyncPaginator.ts b/clients/client-ssm/pagination/ListResourceDataSyncPaginator.ts index 54682faa33d2a..1107351949496 100644 --- a/clients/client-ssm/pagination/ListResourceDataSyncPaginator.ts +++ b/clients/client-ssm/pagination/ListResourceDataSyncPaginator.ts @@ -8,6 +8,9 @@ import { import { SSMPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSMClient, input: ListResourceDataSyncCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourceDataSyncCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSM, input: ListResourceDataSyncCommandInput, diff --git a/clients/client-ssm/runtimeConfig.browser.ts b/clients/client-ssm/runtimeConfig.browser.ts index ac38eee5f5c7f..3a647b2ce454f 100644 --- a/clients/client-ssm/runtimeConfig.browser.ts +++ b/clients/client-ssm/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SSMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-ssm/runtimeConfig.native.ts b/clients/client-ssm/runtimeConfig.native.ts index ad92e392de106..fc2dc4d37ef40 100644 --- a/clients/client-ssm/runtimeConfig.native.ts +++ b/clients/client-ssm/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SSMClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-ssm/runtimeConfig.shared.ts b/clients/client-ssm/runtimeConfig.shared.ts index bc836ac99553b..de4435fb41138 100644 --- a/clients/client-ssm/runtimeConfig.shared.ts +++ b/clients/client-ssm/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2014-11-06", disableHostPrefix: false, diff --git a/clients/client-ssm/runtimeConfig.ts b/clients/client-ssm/runtimeConfig.ts index fb566e2008de9..c6629bfe3fa02 100644 --- a/clients/client-ssm/runtimeConfig.ts +++ b/clients/client-ssm/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SSMClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-ssm/tsconfig.json b/clients/client-ssm/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-ssm/tsconfig.json +++ b/clients/client-ssm/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sso-admin/commands/AttachManagedPolicyToPermissionSetCommand.ts b/clients/client-sso-admin/commands/AttachManagedPolicyToPermissionSetCommand.ts index 5e853b13d2a9b..6ac1e4ec884db 100644 --- a/clients/client-sso-admin/commands/AttachManagedPolicyToPermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/AttachManagedPolicyToPermissionSetCommand.ts @@ -24,6 +24,14 @@ export type AttachManagedPolicyToPermissionSetCommandInput = AttachManagedPolicy export type AttachManagedPolicyToPermissionSetCommandOutput = AttachManagedPolicyToPermissionSetResponse & __MetadataBearer; +/** + *

Attaches an IAM managed policy ARN to a permission set.

+ * + *

If the permission set is already referenced by one or more account assignments, you will need to call + * ProvisionPermissionSet + * after this action to apply the corresponding IAM policy updates to all assigned accounts.

+ *
+ */ export class AttachManagedPolicyToPermissionSetCommand extends $Command< AttachManagedPolicyToPermissionSetCommandInput, AttachManagedPolicyToPermissionSetCommandOutput, @@ -38,6 +46,9 @@ export class AttachManagedPolicyToPermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/CreateAccountAssignmentCommand.ts b/clients/client-sso-admin/commands/CreateAccountAssignmentCommand.ts index 52deb8be38f1c..6a8ecebc7b5ff 100644 --- a/clients/client-sso-admin/commands/CreateAccountAssignmentCommand.ts +++ b/clients/client-sso-admin/commands/CreateAccountAssignmentCommand.ts @@ -20,6 +20,18 @@ import { export type CreateAccountAssignmentCommandInput = CreateAccountAssignmentRequest; export type CreateAccountAssignmentCommandOutput = CreateAccountAssignmentResponse & __MetadataBearer; +/** + *

Assigns access to a principal for a specified AWS account using a specified permission + * set.

+ * + *

The term principal here refers to a user or group that is defined in AWS SSO.

+ *
+ * + *

As part of a successful CreateAccountAssignment call, the specified permission set will automatically be provisioned to the account in the form of an IAM policy attached to the SSO-created IAM role. If the permission set is subsequently updated, the corresponding IAM policies attached to roles in your accounts will not be updated automatically. In this case, you will need to call + * ProvisionPermissionSet + * to make these updates.

+ *
+ */ export class CreateAccountAssignmentCommand extends $Command< CreateAccountAssignmentCommandInput, CreateAccountAssignmentCommandOutput, @@ -34,6 +46,9 @@ export class CreateAccountAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/CreatePermissionSetCommand.ts b/clients/client-sso-admin/commands/CreatePermissionSetCommand.ts index d8cafc9122ff6..df1b88ee1b1df 100644 --- a/clients/client-sso-admin/commands/CreatePermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/CreatePermissionSetCommand.ts @@ -20,6 +20,14 @@ import { export type CreatePermissionSetCommandInput = CreatePermissionSetRequest; export type CreatePermissionSetCommandOutput = CreatePermissionSetResponse & __MetadataBearer; +/** + *

Creates a permission set within a specified SSO instance.

+ * + *

To grant users and groups access to AWS account resources, use + * CreateAccountAssignment + * .

+ *
+ */ export class CreatePermissionSetCommand extends $Command< CreatePermissionSetCommandInput, CreatePermissionSetCommandOutput, @@ -34,6 +42,9 @@ export class CreatePermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/DeleteAccountAssignmentCommand.ts b/clients/client-sso-admin/commands/DeleteAccountAssignmentCommand.ts index 1c155afce4058..93ffd4fe451ca 100644 --- a/clients/client-sso-admin/commands/DeleteAccountAssignmentCommand.ts +++ b/clients/client-sso-admin/commands/DeleteAccountAssignmentCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAccountAssignmentCommandInput = DeleteAccountAssignmentRequest; export type DeleteAccountAssignmentCommandOutput = DeleteAccountAssignmentResponse & __MetadataBearer; +/** + *

Deletes a principal's access from a specified AWS account using a specified permission + * set.

+ */ export class DeleteAccountAssignmentCommand extends $Command< DeleteAccountAssignmentCommandInput, DeleteAccountAssignmentCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAccountAssignmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/DeleteInlinePolicyFromPermissionSetCommand.ts b/clients/client-sso-admin/commands/DeleteInlinePolicyFromPermissionSetCommand.ts index 10e5e704150a8..4389e8b583eef 100644 --- a/clients/client-sso-admin/commands/DeleteInlinePolicyFromPermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/DeleteInlinePolicyFromPermissionSetCommand.ts @@ -24,6 +24,9 @@ export type DeleteInlinePolicyFromPermissionSetCommandInput = DeleteInlinePolicy export type DeleteInlinePolicyFromPermissionSetCommandOutput = DeleteInlinePolicyFromPermissionSetResponse & __MetadataBearer; +/** + *

Deletes the inline policy from a specified permission set.

+ */ export class DeleteInlinePolicyFromPermissionSetCommand extends $Command< DeleteInlinePolicyFromPermissionSetCommandInput, DeleteInlinePolicyFromPermissionSetCommandOutput, @@ -38,6 +41,9 @@ export class DeleteInlinePolicyFromPermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/DeletePermissionSetCommand.ts b/clients/client-sso-admin/commands/DeletePermissionSetCommand.ts index a284688854a3c..f45336e831a7e 100644 --- a/clients/client-sso-admin/commands/DeletePermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/DeletePermissionSetCommand.ts @@ -20,6 +20,9 @@ import { export type DeletePermissionSetCommandInput = DeletePermissionSetRequest; export type DeletePermissionSetCommandOutput = DeletePermissionSetResponse & __MetadataBearer; +/** + *

Deletes the specified permission set.

+ */ export class DeletePermissionSetCommand extends $Command< DeletePermissionSetCommandInput, DeletePermissionSetCommandOutput, @@ -34,6 +37,9 @@ export class DeletePermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/DescribeAccountAssignmentCreationStatusCommand.ts b/clients/client-sso-admin/commands/DescribeAccountAssignmentCreationStatusCommand.ts index 53a5c5e6e60f1..40e43fc1f29b8 100644 --- a/clients/client-sso-admin/commands/DescribeAccountAssignmentCreationStatusCommand.ts +++ b/clients/client-sso-admin/commands/DescribeAccountAssignmentCreationStatusCommand.ts @@ -24,6 +24,9 @@ export type DescribeAccountAssignmentCreationStatusCommandInput = DescribeAccoun export type DescribeAccountAssignmentCreationStatusCommandOutput = DescribeAccountAssignmentCreationStatusResponse & __MetadataBearer; +/** + *

Describes the status of the assignment creation request.

+ */ export class DescribeAccountAssignmentCreationStatusCommand extends $Command< DescribeAccountAssignmentCreationStatusCommandInput, DescribeAccountAssignmentCreationStatusCommandOutput, @@ -38,6 +41,9 @@ export class DescribeAccountAssignmentCreationStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/DescribeAccountAssignmentDeletionStatusCommand.ts b/clients/client-sso-admin/commands/DescribeAccountAssignmentDeletionStatusCommand.ts index adb5d50d0e471..3061f21d73733 100644 --- a/clients/client-sso-admin/commands/DescribeAccountAssignmentDeletionStatusCommand.ts +++ b/clients/client-sso-admin/commands/DescribeAccountAssignmentDeletionStatusCommand.ts @@ -24,6 +24,9 @@ export type DescribeAccountAssignmentDeletionStatusCommandInput = DescribeAccoun export type DescribeAccountAssignmentDeletionStatusCommandOutput = DescribeAccountAssignmentDeletionStatusResponse & __MetadataBearer; +/** + *

Describes the status of the assignment deletion request.

+ */ export class DescribeAccountAssignmentDeletionStatusCommand extends $Command< DescribeAccountAssignmentDeletionStatusCommandInput, DescribeAccountAssignmentDeletionStatusCommandOutput, @@ -38,6 +41,9 @@ export class DescribeAccountAssignmentDeletionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/DescribePermissionSetCommand.ts b/clients/client-sso-admin/commands/DescribePermissionSetCommand.ts index b189a68a108b6..11c063a7fd3ea 100644 --- a/clients/client-sso-admin/commands/DescribePermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/DescribePermissionSetCommand.ts @@ -20,6 +20,9 @@ import { export type DescribePermissionSetCommandInput = DescribePermissionSetRequest; export type DescribePermissionSetCommandOutput = DescribePermissionSetResponse & __MetadataBearer; +/** + *

Gets the details of the permission set.

+ */ export class DescribePermissionSetCommand extends $Command< DescribePermissionSetCommandInput, DescribePermissionSetCommandOutput, @@ -34,6 +37,9 @@ export class DescribePermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/DescribePermissionSetProvisioningStatusCommand.ts b/clients/client-sso-admin/commands/DescribePermissionSetProvisioningStatusCommand.ts index cc39a404b01b6..28adf195614a0 100644 --- a/clients/client-sso-admin/commands/DescribePermissionSetProvisioningStatusCommand.ts +++ b/clients/client-sso-admin/commands/DescribePermissionSetProvisioningStatusCommand.ts @@ -24,6 +24,9 @@ export type DescribePermissionSetProvisioningStatusCommandInput = DescribePermis export type DescribePermissionSetProvisioningStatusCommandOutput = DescribePermissionSetProvisioningStatusResponse & __MetadataBearer; +/** + *

Describes the status for the given permission set provisioning request.

+ */ export class DescribePermissionSetProvisioningStatusCommand extends $Command< DescribePermissionSetProvisioningStatusCommandInput, DescribePermissionSetProvisioningStatusCommandOutput, @@ -38,6 +41,9 @@ export class DescribePermissionSetProvisioningStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/DetachManagedPolicyFromPermissionSetCommand.ts b/clients/client-sso-admin/commands/DetachManagedPolicyFromPermissionSetCommand.ts index 21575941d0ee8..c9f343f45b63a 100644 --- a/clients/client-sso-admin/commands/DetachManagedPolicyFromPermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/DetachManagedPolicyFromPermissionSetCommand.ts @@ -24,6 +24,9 @@ export type DetachManagedPolicyFromPermissionSetCommandInput = DetachManagedPoli export type DetachManagedPolicyFromPermissionSetCommandOutput = DetachManagedPolicyFromPermissionSetResponse & __MetadataBearer; +/** + *

Detaches the attached IAM managed policy ARN from the specified permission set.

+ */ export class DetachManagedPolicyFromPermissionSetCommand extends $Command< DetachManagedPolicyFromPermissionSetCommandInput, DetachManagedPolicyFromPermissionSetCommandOutput, @@ -38,6 +41,9 @@ export class DetachManagedPolicyFromPermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/GetInlinePolicyForPermissionSetCommand.ts b/clients/client-sso-admin/commands/GetInlinePolicyForPermissionSetCommand.ts index 9f0b827866339..c4ca6cfe9b955 100644 --- a/clients/client-sso-admin/commands/GetInlinePolicyForPermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/GetInlinePolicyForPermissionSetCommand.ts @@ -20,6 +20,9 @@ import { export type GetInlinePolicyForPermissionSetCommandInput = GetInlinePolicyForPermissionSetRequest; export type GetInlinePolicyForPermissionSetCommandOutput = GetInlinePolicyForPermissionSetResponse & __MetadataBearer; +/** + *

Obtains the inline policy assigned to the permission set.

+ */ export class GetInlinePolicyForPermissionSetCommand extends $Command< GetInlinePolicyForPermissionSetCommandInput, GetInlinePolicyForPermissionSetCommandOutput, @@ -34,6 +37,9 @@ export class GetInlinePolicyForPermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListAccountAssignmentCreationStatusCommand.ts b/clients/client-sso-admin/commands/ListAccountAssignmentCreationStatusCommand.ts index d93d5e94b5654..53d30ebf532bf 100644 --- a/clients/client-sso-admin/commands/ListAccountAssignmentCreationStatusCommand.ts +++ b/clients/client-sso-admin/commands/ListAccountAssignmentCreationStatusCommand.ts @@ -24,6 +24,10 @@ export type ListAccountAssignmentCreationStatusCommandInput = ListAccountAssignm export type ListAccountAssignmentCreationStatusCommandOutput = ListAccountAssignmentCreationStatusResponse & __MetadataBearer; +/** + *

Lists the status of the AWS account assignment creation requests for a specified SSO + * instance.

+ */ export class ListAccountAssignmentCreationStatusCommand extends $Command< ListAccountAssignmentCreationStatusCommandInput, ListAccountAssignmentCreationStatusCommandOutput, @@ -38,6 +42,9 @@ export class ListAccountAssignmentCreationStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListAccountAssignmentDeletionStatusCommand.ts b/clients/client-sso-admin/commands/ListAccountAssignmentDeletionStatusCommand.ts index 84d890df5d8b0..63dbdda5c2291 100644 --- a/clients/client-sso-admin/commands/ListAccountAssignmentDeletionStatusCommand.ts +++ b/clients/client-sso-admin/commands/ListAccountAssignmentDeletionStatusCommand.ts @@ -24,6 +24,10 @@ export type ListAccountAssignmentDeletionStatusCommandInput = ListAccountAssignm export type ListAccountAssignmentDeletionStatusCommandOutput = ListAccountAssignmentDeletionStatusResponse & __MetadataBearer; +/** + *

Lists the status of the AWS account assignment deletion requests for a specified SSO + * instance.

+ */ export class ListAccountAssignmentDeletionStatusCommand extends $Command< ListAccountAssignmentDeletionStatusCommandInput, ListAccountAssignmentDeletionStatusCommandOutput, @@ -38,6 +42,9 @@ export class ListAccountAssignmentDeletionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListAccountAssignmentsCommand.ts b/clients/client-sso-admin/commands/ListAccountAssignmentsCommand.ts index 3629a5418dfdc..3185d08987fb4 100644 --- a/clients/client-sso-admin/commands/ListAccountAssignmentsCommand.ts +++ b/clients/client-sso-admin/commands/ListAccountAssignmentsCommand.ts @@ -20,6 +20,10 @@ import { export type ListAccountAssignmentsCommandInput = ListAccountAssignmentsRequest; export type ListAccountAssignmentsCommandOutput = ListAccountAssignmentsResponse & __MetadataBearer; +/** + *

Lists the assignee of the specified AWS account with the specified permission + * set.

+ */ export class ListAccountAssignmentsCommand extends $Command< ListAccountAssignmentsCommandInput, ListAccountAssignmentsCommandOutput, @@ -34,6 +38,9 @@ export class ListAccountAssignmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListAccountsForProvisionedPermissionSetCommand.ts b/clients/client-sso-admin/commands/ListAccountsForProvisionedPermissionSetCommand.ts index 4c86b67fb68ca..d3e4dd6dac3be 100644 --- a/clients/client-sso-admin/commands/ListAccountsForProvisionedPermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/ListAccountsForProvisionedPermissionSetCommand.ts @@ -24,6 +24,9 @@ export type ListAccountsForProvisionedPermissionSetCommandInput = ListAccountsFo export type ListAccountsForProvisionedPermissionSetCommandOutput = ListAccountsForProvisionedPermissionSetResponse & __MetadataBearer; +/** + *

Lists all the AWS accounts where the specified permission set is provisioned.

+ */ export class ListAccountsForProvisionedPermissionSetCommand extends $Command< ListAccountsForProvisionedPermissionSetCommandInput, ListAccountsForProvisionedPermissionSetCommandOutput, @@ -38,6 +41,9 @@ export class ListAccountsForProvisionedPermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListInstancesCommand.ts b/clients/client-sso-admin/commands/ListInstancesCommand.ts index f597dd6513fc2..b77aa519d4852 100644 --- a/clients/client-sso-admin/commands/ListInstancesCommand.ts +++ b/clients/client-sso-admin/commands/ListInstancesCommand.ts @@ -20,6 +20,9 @@ import { export type ListInstancesCommandInput = ListInstancesRequest; export type ListInstancesCommandOutput = ListInstancesResponse & __MetadataBearer; +/** + *

Lists the SSO instances that the caller has access to.

+ */ export class ListInstancesCommand extends $Command< ListInstancesCommandInput, ListInstancesCommandOutput, @@ -34,6 +37,9 @@ export class ListInstancesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListManagedPoliciesInPermissionSetCommand.ts b/clients/client-sso-admin/commands/ListManagedPoliciesInPermissionSetCommand.ts index 9ac2c7fe64625..1c54083d3ff09 100644 --- a/clients/client-sso-admin/commands/ListManagedPoliciesInPermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/ListManagedPoliciesInPermissionSetCommand.ts @@ -24,6 +24,9 @@ export type ListManagedPoliciesInPermissionSetCommandInput = ListManagedPolicies export type ListManagedPoliciesInPermissionSetCommandOutput = ListManagedPoliciesInPermissionSetResponse & __MetadataBearer; +/** + *

Lists the IAM managed policy that is attached to a specified permission set.

+ */ export class ListManagedPoliciesInPermissionSetCommand extends $Command< ListManagedPoliciesInPermissionSetCommandInput, ListManagedPoliciesInPermissionSetCommandOutput, @@ -38,6 +41,9 @@ export class ListManagedPoliciesInPermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListPermissionSetProvisioningStatusCommand.ts b/clients/client-sso-admin/commands/ListPermissionSetProvisioningStatusCommand.ts index c6496272bcb1a..cc2a299963ab8 100644 --- a/clients/client-sso-admin/commands/ListPermissionSetProvisioningStatusCommand.ts +++ b/clients/client-sso-admin/commands/ListPermissionSetProvisioningStatusCommand.ts @@ -24,6 +24,10 @@ export type ListPermissionSetProvisioningStatusCommandInput = ListPermissionSetP export type ListPermissionSetProvisioningStatusCommandOutput = ListPermissionSetProvisioningStatusResponse & __MetadataBearer; +/** + *

Lists the status of the permission set provisioning requests for a specified SSO + * instance.

+ */ export class ListPermissionSetProvisioningStatusCommand extends $Command< ListPermissionSetProvisioningStatusCommandInput, ListPermissionSetProvisioningStatusCommandOutput, @@ -38,6 +42,9 @@ export class ListPermissionSetProvisioningStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListPermissionSetsCommand.ts b/clients/client-sso-admin/commands/ListPermissionSetsCommand.ts index ccd0b95cdd19f..e148a26812acf 100644 --- a/clients/client-sso-admin/commands/ListPermissionSetsCommand.ts +++ b/clients/client-sso-admin/commands/ListPermissionSetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListPermissionSetsCommandInput = ListPermissionSetsRequest; export type ListPermissionSetsCommandOutput = ListPermissionSetsResponse & __MetadataBearer; +/** + *

Lists the PermissionSets in an SSO instance.

+ */ export class ListPermissionSetsCommand extends $Command< ListPermissionSetsCommandInput, ListPermissionSetsCommandOutput, @@ -34,6 +37,9 @@ export class ListPermissionSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListPermissionSetsProvisionedToAccountCommand.ts b/clients/client-sso-admin/commands/ListPermissionSetsProvisionedToAccountCommand.ts index 08bd93c88f840..952b23f6ba458 100644 --- a/clients/client-sso-admin/commands/ListPermissionSetsProvisionedToAccountCommand.ts +++ b/clients/client-sso-admin/commands/ListPermissionSetsProvisionedToAccountCommand.ts @@ -24,6 +24,9 @@ export type ListPermissionSetsProvisionedToAccountCommandInput = ListPermissionS export type ListPermissionSetsProvisionedToAccountCommandOutput = ListPermissionSetsProvisionedToAccountResponse & __MetadataBearer; +/** + *

Lists all the permission sets that are provisioned to a specified AWS account.

+ */ export class ListPermissionSetsProvisionedToAccountCommand extends $Command< ListPermissionSetsProvisionedToAccountCommandInput, ListPermissionSetsProvisionedToAccountCommandOutput, @@ -38,6 +41,9 @@ export class ListPermissionSetsProvisionedToAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ListTagsForResourceCommand.ts b/clients/client-sso-admin/commands/ListTagsForResourceCommand.ts index 704284932df5a..d18899e863bdf 100644 --- a/clients/client-sso-admin/commands/ListTagsForResourceCommand.ts +++ b/clients/client-sso-admin/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags that are attached to a specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/ProvisionPermissionSetCommand.ts b/clients/client-sso-admin/commands/ProvisionPermissionSetCommand.ts index edc95b834dbda..37de56ed65c6a 100644 --- a/clients/client-sso-admin/commands/ProvisionPermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/ProvisionPermissionSetCommand.ts @@ -20,6 +20,9 @@ import { export type ProvisionPermissionSetCommandInput = ProvisionPermissionSetRequest; export type ProvisionPermissionSetCommandOutput = ProvisionPermissionSetResponse & __MetadataBearer; +/** + *

The process by which a specified permission set is provisioned to the specified target.

+ */ export class ProvisionPermissionSetCommand extends $Command< ProvisionPermissionSetCommandInput, ProvisionPermissionSetCommandOutput, @@ -34,6 +37,9 @@ export class ProvisionPermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/PutInlinePolicyToPermissionSetCommand.ts b/clients/client-sso-admin/commands/PutInlinePolicyToPermissionSetCommand.ts index 86bc9ba2a1d8c..27b45505d01ec 100644 --- a/clients/client-sso-admin/commands/PutInlinePolicyToPermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/PutInlinePolicyToPermissionSetCommand.ts @@ -20,6 +20,14 @@ import { export type PutInlinePolicyToPermissionSetCommandInput = PutInlinePolicyToPermissionSetRequest; export type PutInlinePolicyToPermissionSetCommandOutput = PutInlinePolicyToPermissionSetResponse & __MetadataBearer; +/** + *

Attaches an IAM inline policy to a permission set.

+ * + *

If the permission set is already referenced by one or more account assignments, you will need to call + * ProvisionPermissionSet + * after this action to apply the corresponding IAM policy updates to all assigned accounts.

+ *
+ */ export class PutInlinePolicyToPermissionSetCommand extends $Command< PutInlinePolicyToPermissionSetCommandInput, PutInlinePolicyToPermissionSetCommandOutput, @@ -34,6 +42,9 @@ export class PutInlinePolicyToPermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/TagResourceCommand.ts b/clients/client-sso-admin/commands/TagResourceCommand.ts index 740733fd3d73c..486c2f9995290 100644 --- a/clients/client-sso-admin/commands/TagResourceCommand.ts +++ b/clients/client-sso-admin/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Associates a set of tags with a specified resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/UntagResourceCommand.ts b/clients/client-sso-admin/commands/UntagResourceCommand.ts index 31bf2d99bc003..b9ddeb26f5937 100644 --- a/clients/client-sso-admin/commands/UntagResourceCommand.ts +++ b/clients/client-sso-admin/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Disassociates a set of tags from a specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/commands/UpdatePermissionSetCommand.ts b/clients/client-sso-admin/commands/UpdatePermissionSetCommand.ts index 135920a633353..721b2ef9794d6 100644 --- a/clients/client-sso-admin/commands/UpdatePermissionSetCommand.ts +++ b/clients/client-sso-admin/commands/UpdatePermissionSetCommand.ts @@ -20,6 +20,9 @@ import { export type UpdatePermissionSetCommandInput = UpdatePermissionSetRequest; export type UpdatePermissionSetCommandOutput = UpdatePermissionSetResponse & __MetadataBearer; +/** + *

Updates an existing permission set.

+ */ export class UpdatePermissionSetCommand extends $Command< UpdatePermissionSetCommandInput, UpdatePermissionSetCommandOutput, @@ -34,6 +37,9 @@ export class UpdatePermissionSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOAdminClientResolvedConfig, diff --git a/clients/client-sso-admin/package.json b/clients/client-sso-admin/package.json index 25fe0d4dc94c6..88ea9ef1e5b2a 100644 --- a/clients/client-sso-admin/package.json +++ b/clients/client-sso-admin/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sso Admin Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sso-admin/pagination/ListAccountAssignmentCreationStatusPaginator.ts b/clients/client-sso-admin/pagination/ListAccountAssignmentCreationStatusPaginator.ts index 1aeb2aae0219e..5a4d2a77d732e 100644 --- a/clients/client-sso-admin/pagination/ListAccountAssignmentCreationStatusPaginator.ts +++ b/clients/client-sso-admin/pagination/ListAccountAssignmentCreationStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListAccountAssignmentCreationStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountAssignmentCreationStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListAccountAssignmentCreationStatusCommandInput, diff --git a/clients/client-sso-admin/pagination/ListAccountAssignmentDeletionStatusPaginator.ts b/clients/client-sso-admin/pagination/ListAccountAssignmentDeletionStatusPaginator.ts index 99d7c8854d87e..39d5b3129aecf 100644 --- a/clients/client-sso-admin/pagination/ListAccountAssignmentDeletionStatusPaginator.ts +++ b/clients/client-sso-admin/pagination/ListAccountAssignmentDeletionStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListAccountAssignmentDeletionStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountAssignmentDeletionStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListAccountAssignmentDeletionStatusCommandInput, diff --git a/clients/client-sso-admin/pagination/ListAccountAssignmentsPaginator.ts b/clients/client-sso-admin/pagination/ListAccountAssignmentsPaginator.ts index 7cdd2da22ff42..ab8485655c9f4 100644 --- a/clients/client-sso-admin/pagination/ListAccountAssignmentsPaginator.ts +++ b/clients/client-sso-admin/pagination/ListAccountAssignmentsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListAccountAssignmentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountAssignmentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListAccountAssignmentsCommandInput, diff --git a/clients/client-sso-admin/pagination/ListAccountsForProvisionedPermissionSetPaginator.ts b/clients/client-sso-admin/pagination/ListAccountsForProvisionedPermissionSetPaginator.ts index c09d179c00d3e..b7a484ac5c533 100644 --- a/clients/client-sso-admin/pagination/ListAccountsForProvisionedPermissionSetPaginator.ts +++ b/clients/client-sso-admin/pagination/ListAccountsForProvisionedPermissionSetPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListAccountsForProvisionedPermissionSetCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountsForProvisionedPermissionSetCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListAccountsForProvisionedPermissionSetCommandInput, diff --git a/clients/client-sso-admin/pagination/ListInstancesPaginator.ts b/clients/client-sso-admin/pagination/ListInstancesPaginator.ts index 4a5d6ba0809e5..1ef6b9a3ae829 100644 --- a/clients/client-sso-admin/pagination/ListInstancesPaginator.ts +++ b/clients/client-sso-admin/pagination/ListInstancesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListInstancesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListInstancesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListInstancesCommandInput, diff --git a/clients/client-sso-admin/pagination/ListManagedPoliciesInPermissionSetPaginator.ts b/clients/client-sso-admin/pagination/ListManagedPoliciesInPermissionSetPaginator.ts index 330bda10b3c5a..eba4b58811764 100644 --- a/clients/client-sso-admin/pagination/ListManagedPoliciesInPermissionSetPaginator.ts +++ b/clients/client-sso-admin/pagination/ListManagedPoliciesInPermissionSetPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListManagedPoliciesInPermissionSetCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListManagedPoliciesInPermissionSetCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListManagedPoliciesInPermissionSetCommandInput, diff --git a/clients/client-sso-admin/pagination/ListPermissionSetProvisioningStatusPaginator.ts b/clients/client-sso-admin/pagination/ListPermissionSetProvisioningStatusPaginator.ts index b239ebcb3a348..c4a5ded06ecdd 100644 --- a/clients/client-sso-admin/pagination/ListPermissionSetProvisioningStatusPaginator.ts +++ b/clients/client-sso-admin/pagination/ListPermissionSetProvisioningStatusPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListPermissionSetProvisioningStatusCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPermissionSetProvisioningStatusCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListPermissionSetProvisioningStatusCommandInput, diff --git a/clients/client-sso-admin/pagination/ListPermissionSetsPaginator.ts b/clients/client-sso-admin/pagination/ListPermissionSetsPaginator.ts index 279feab5b21e7..9ca6979481d6b 100644 --- a/clients/client-sso-admin/pagination/ListPermissionSetsPaginator.ts +++ b/clients/client-sso-admin/pagination/ListPermissionSetsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListPermissionSetsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPermissionSetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListPermissionSetsCommandInput, diff --git a/clients/client-sso-admin/pagination/ListPermissionSetsProvisionedToAccountPaginator.ts b/clients/client-sso-admin/pagination/ListPermissionSetsProvisionedToAccountPaginator.ts index a32ee4df87442..4370a639ebe67 100644 --- a/clients/client-sso-admin/pagination/ListPermissionSetsProvisionedToAccountPaginator.ts +++ b/clients/client-sso-admin/pagination/ListPermissionSetsProvisionedToAccountPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListPermissionSetsProvisionedToAccountCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListPermissionSetsProvisionedToAccountCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListPermissionSetsProvisionedToAccountCommandInput, diff --git a/clients/client-sso-admin/pagination/ListTagsForResourcePaginator.ts b/clients/client-sso-admin/pagination/ListTagsForResourcePaginator.ts index f990a15918f2c..7d34b64723814 100644 --- a/clients/client-sso-admin/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-sso-admin/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { SSOAdminPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOAdminClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSOAdmin, input: ListTagsForResourceCommandInput, diff --git a/clients/client-sso-admin/runtimeConfig.browser.ts b/clients/client-sso-admin/runtimeConfig.browser.ts index 48befdf8184d5..ac9fb53989428 100644 --- a/clients/client-sso-admin/runtimeConfig.browser.ts +++ b/clients/client-sso-admin/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SSOAdminClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sso-admin/runtimeConfig.native.ts b/clients/client-sso-admin/runtimeConfig.native.ts index 7e67fafc97d1c..65e01ed51b199 100644 --- a/clients/client-sso-admin/runtimeConfig.native.ts +++ b/clients/client-sso-admin/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SSOAdminClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sso-admin/runtimeConfig.shared.ts b/clients/client-sso-admin/runtimeConfig.shared.ts index cf675910a71a5..7aea7e643064d 100644 --- a/clients/client-sso-admin/runtimeConfig.shared.ts +++ b/clients/client-sso-admin/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-07-20", disableHostPrefix: false, diff --git a/clients/client-sso-admin/runtimeConfig.ts b/clients/client-sso-admin/runtimeConfig.ts index ea239fee75fd2..13a07e4a37c74 100644 --- a/clients/client-sso-admin/runtimeConfig.ts +++ b/clients/client-sso-admin/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SSOAdminClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sso-admin/tsconfig.json b/clients/client-sso-admin/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sso-admin/tsconfig.json +++ b/clients/client-sso-admin/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sso-oidc/commands/CreateTokenCommand.ts b/clients/client-sso-oidc/commands/CreateTokenCommand.ts index 3f74a13ceaa7e..40b400c0f2722 100644 --- a/clients/client-sso-oidc/commands/CreateTokenCommand.ts +++ b/clients/client-sso-oidc/commands/CreateTokenCommand.ts @@ -34,6 +34,9 @@ export class CreateTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOOIDCClientResolvedConfig, diff --git a/clients/client-sso-oidc/commands/RegisterClientCommand.ts b/clients/client-sso-oidc/commands/RegisterClientCommand.ts index e997ef2ae23da..6d98baec37dfc 100644 --- a/clients/client-sso-oidc/commands/RegisterClientCommand.ts +++ b/clients/client-sso-oidc/commands/RegisterClientCommand.ts @@ -34,6 +34,9 @@ export class RegisterClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOOIDCClientResolvedConfig, diff --git a/clients/client-sso-oidc/commands/StartDeviceAuthorizationCommand.ts b/clients/client-sso-oidc/commands/StartDeviceAuthorizationCommand.ts index db21ba29d7e3d..840519d43380d 100644 --- a/clients/client-sso-oidc/commands/StartDeviceAuthorizationCommand.ts +++ b/clients/client-sso-oidc/commands/StartDeviceAuthorizationCommand.ts @@ -34,6 +34,9 @@ export class StartDeviceAuthorizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOOIDCClientResolvedConfig, diff --git a/clients/client-sso-oidc/package.json b/clients/client-sso-oidc/package.json index 98e423a138679..a6f074c37fbad 100644 --- a/clients/client-sso-oidc/package.json +++ b/clients/client-sso-oidc/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sso Oidc Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sso-oidc/runtimeConfig.browser.ts b/clients/client-sso-oidc/runtimeConfig.browser.ts index a985ef1a95d0c..1b3acddd14be8 100644 --- a/clients/client-sso-oidc/runtimeConfig.browser.ts +++ b/clients/client-sso-oidc/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SSOOIDCClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sso-oidc/runtimeConfig.native.ts b/clients/client-sso-oidc/runtimeConfig.native.ts index 9752194f4cd4a..2d6edb1f73af6 100644 --- a/clients/client-sso-oidc/runtimeConfig.native.ts +++ b/clients/client-sso-oidc/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SSOOIDCClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sso-oidc/runtimeConfig.shared.ts b/clients/client-sso-oidc/runtimeConfig.shared.ts index de3b43b51068a..7f27f551acaab 100644 --- a/clients/client-sso-oidc/runtimeConfig.shared.ts +++ b/clients/client-sso-oidc/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-06-10", disableHostPrefix: false, diff --git a/clients/client-sso-oidc/runtimeConfig.ts b/clients/client-sso-oidc/runtimeConfig.ts index 1db1645f43502..bb96ed7e71605 100644 --- a/clients/client-sso-oidc/runtimeConfig.ts +++ b/clients/client-sso-oidc/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SSOOIDCClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sso-oidc/tsconfig.json b/clients/client-sso-oidc/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sso-oidc/tsconfig.json +++ b/clients/client-sso-oidc/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sso/commands/GetRoleCredentialsCommand.ts b/clients/client-sso/commands/GetRoleCredentialsCommand.ts index 9345018148c0f..60a3b2723c199 100644 --- a/clients/client-sso/commands/GetRoleCredentialsCommand.ts +++ b/clients/client-sso/commands/GetRoleCredentialsCommand.ts @@ -20,6 +20,10 @@ import { export type GetRoleCredentialsCommandInput = GetRoleCredentialsRequest; export type GetRoleCredentialsCommandOutput = GetRoleCredentialsResponse & __MetadataBearer; +/** + *

Returns the STS short-term credentials for a given role name that is assigned to the + * user.

+ */ export class GetRoleCredentialsCommand extends $Command< GetRoleCredentialsCommandInput, GetRoleCredentialsCommandOutput, @@ -34,6 +38,9 @@ export class GetRoleCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOClientResolvedConfig, diff --git a/clients/client-sso/commands/ListAccountRolesCommand.ts b/clients/client-sso/commands/ListAccountRolesCommand.ts index dfb914d4c3b50..92b5b6bd0e6d5 100644 --- a/clients/client-sso/commands/ListAccountRolesCommand.ts +++ b/clients/client-sso/commands/ListAccountRolesCommand.ts @@ -20,6 +20,9 @@ import { export type ListAccountRolesCommandInput = ListAccountRolesRequest; export type ListAccountRolesCommandOutput = ListAccountRolesResponse & __MetadataBearer; +/** + *

Lists all roles that are assigned to the user for a given AWS account.

+ */ export class ListAccountRolesCommand extends $Command< ListAccountRolesCommandInput, ListAccountRolesCommandOutput, @@ -34,6 +37,9 @@ export class ListAccountRolesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOClientResolvedConfig, diff --git a/clients/client-sso/commands/ListAccountsCommand.ts b/clients/client-sso/commands/ListAccountsCommand.ts index 768c14817ceb3..48fbce447612f 100644 --- a/clients/client-sso/commands/ListAccountsCommand.ts +++ b/clients/client-sso/commands/ListAccountsCommand.ts @@ -20,6 +20,11 @@ import { export type ListAccountsCommandInput = ListAccountsRequest; export type ListAccountsCommandOutput = ListAccountsResponse & __MetadataBearer; +/** + *

Lists all AWS accounts assigned to the user. These AWS accounts are assigned by the + * administrator of the account. For more information, see Assign User Access in the AWS SSO User Guide. This operation + * returns a paginated response.

+ */ export class ListAccountsCommand extends $Command< ListAccountsCommandInput, ListAccountsCommandOutput, @@ -34,6 +39,9 @@ export class ListAccountsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SSOClientResolvedConfig, diff --git a/clients/client-sso/commands/LogoutCommand.ts b/clients/client-sso/commands/LogoutCommand.ts index 4f2399c3276dd..4ffe0861023a5 100644 --- a/clients/client-sso/commands/LogoutCommand.ts +++ b/clients/client-sso/commands/LogoutCommand.ts @@ -17,6 +17,9 @@ import { export type LogoutCommandInput = LogoutRequest; export type LogoutCommandOutput = __MetadataBearer; +/** + *

Removes the client- and server-side session that is associated with the user.

+ */ export class LogoutCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +30,9 @@ export class LogoutCommand extends $Command, configuration: SSOClientResolvedConfig, diff --git a/clients/client-sso/package.json b/clients/client-sso/package.json index 8062863986da9..39762328d717b 100644 --- a/clients/client-sso/package.json +++ b/clients/client-sso/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sso Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sso/pagination/ListAccountRolesPaginator.ts b/clients/client-sso/pagination/ListAccountRolesPaginator.ts index 393a843705b6c..120736e098de5 100644 --- a/clients/client-sso/pagination/ListAccountRolesPaginator.ts +++ b/clients/client-sso/pagination/ListAccountRolesPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOClient, input: ListAccountRolesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountRolesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSO, input: ListAccountRolesCommandInput, diff --git a/clients/client-sso/pagination/ListAccountsPaginator.ts b/clients/client-sso/pagination/ListAccountsPaginator.ts index 7bbc6ee5be72d..105b8d43cffac 100644 --- a/clients/client-sso/pagination/ListAccountsPaginator.ts +++ b/clients/client-sso/pagination/ListAccountsPaginator.ts @@ -8,6 +8,9 @@ import { import { SSOPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SSOClient, input: ListAccountsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAccountsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SSO, input: ListAccountsCommandInput, diff --git a/clients/client-sso/runtimeConfig.browser.ts b/clients/client-sso/runtimeConfig.browser.ts index fb79ace722db3..afa8469240500 100644 --- a/clients/client-sso/runtimeConfig.browser.ts +++ b/clients/client-sso/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SSOClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sso/runtimeConfig.native.ts b/clients/client-sso/runtimeConfig.native.ts index 836b6a8dca188..d8ad68c511e87 100644 --- a/clients/client-sso/runtimeConfig.native.ts +++ b/clients/client-sso/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SSOClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sso/runtimeConfig.shared.ts b/clients/client-sso/runtimeConfig.shared.ts index 912a6160f8343..fb6a0e30f7c04 100644 --- a/clients/client-sso/runtimeConfig.shared.ts +++ b/clients/client-sso/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-06-10", disableHostPrefix: false, diff --git a/clients/client-sso/runtimeConfig.ts b/clients/client-sso/runtimeConfig.ts index ac6eecb0f25e0..789068a8fee1c 100644 --- a/clients/client-sso/runtimeConfig.ts +++ b/clients/client-sso/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SSOClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sso/tsconfig.json b/clients/client-sso/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sso/tsconfig.json +++ b/clients/client-sso/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-storage-gateway/commands/ActivateGatewayCommand.ts b/clients/client-storage-gateway/commands/ActivateGatewayCommand.ts index 906e999c1c5cd..20b672409799a 100644 --- a/clients/client-storage-gateway/commands/ActivateGatewayCommand.ts +++ b/clients/client-storage-gateway/commands/ActivateGatewayCommand.ts @@ -20,6 +20,16 @@ import { export type ActivateGatewayCommandInput = ActivateGatewayInput; export type ActivateGatewayCommandOutput = ActivateGatewayOutput & __MetadataBearer; +/** + *

Activates the gateway you previously deployed on your host. In the activation process, + * you specify information such as the AWS Region that you want to use for storing snapshots + * or tapes, the time zone for scheduled snapshots the gateway snapshot schedule window, an + * activation key, and a name for your gateway. The activation process also associates your + * gateway with your account. For more information, see UpdateGatewayInformation.

+ * + *

You must turn on the gateway VM before you can activate your gateway.

+ *
+ */ export class ActivateGatewayCommand extends $Command< ActivateGatewayCommandInput, ActivateGatewayCommandOutput, @@ -34,6 +44,9 @@ export class ActivateGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/AddCacheCommand.ts b/clients/client-storage-gateway/commands/AddCacheCommand.ts index b546ebd1c3c66..781dd783c81cf 100644 --- a/clients/client-storage-gateway/commands/AddCacheCommand.ts +++ b/clients/client-storage-gateway/commands/AddCacheCommand.ts @@ -17,6 +17,13 @@ import { export type AddCacheCommandInput = AddCacheInput; export type AddCacheCommandOutput = AddCacheOutput & __MetadataBearer; +/** + *

Configures one or more gateway local disks as cache for a gateway. This operation is + * only supported in the cached volume, tape, and file gateway type (see How AWS Storage Gateway works (architecture).

+ * + *

In the request, you specify the gateway Amazon Resource Name (ARN) to which you want to + * add cache, and one or more disk IDs that you want to configure as cache.

+ */ export class AddCacheCommand extends $Command< AddCacheCommandInput, AddCacheCommandOutput, @@ -31,6 +38,9 @@ export class AddCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/AddTagsToResourceCommand.ts b/clients/client-storage-gateway/commands/AddTagsToResourceCommand.ts index 3ad5bc1452c2d..cb291eb0f6495 100644 --- a/clients/client-storage-gateway/commands/AddTagsToResourceCommand.ts +++ b/clients/client-storage-gateway/commands/AddTagsToResourceCommand.ts @@ -20,6 +20,30 @@ import { export type AddTagsToResourceCommandInput = AddTagsToResourceInput; export type AddTagsToResourceCommandOutput = AddTagsToResourceOutput & __MetadataBearer; +/** + *

Adds one or more tags to the specified resource. You use tags to add metadata to + * resources, which you can use to categorize these resources. For example, you can categorize + * resources by purpose, owner, environment, or team. Each tag consists of a key and a value, + * which you define. You can add tags to the following AWS Storage Gateway resources:

+ * + *
    + *
  • + *

    Storage gateways of all types

    + *
  • + *
  • + *

    Storage volumes

    + *
  • + *
  • + *

    Virtual tapes

    + *
  • + *
  • + *

    NFS and SMB file shares

    + *
  • + *
+ * + *

You can create a maximum of 50 tags for each resource. Virtual tapes and storage volumes + * that are recovered to a new gateway maintain their tags.

+ */ export class AddTagsToResourceCommand extends $Command< AddTagsToResourceCommandInput, AddTagsToResourceCommandOutput, @@ -34,6 +58,9 @@ export class AddTagsToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/AddUploadBufferCommand.ts b/clients/client-storage-gateway/commands/AddUploadBufferCommand.ts index a2488afb04336..64afe17c55c61 100644 --- a/clients/client-storage-gateway/commands/AddUploadBufferCommand.ts +++ b/clients/client-storage-gateway/commands/AddUploadBufferCommand.ts @@ -20,6 +20,15 @@ import { export type AddUploadBufferCommandInput = AddUploadBufferInput; export type AddUploadBufferCommandOutput = AddUploadBufferOutput & __MetadataBearer; +/** + *

Configures one or more gateway local disks as upload buffer for a specified gateway. + * This operation is supported for the stored volume, cached volume and tape gateway + * types.

+ * + *

In the request, you specify the gateway Amazon Resource Name (ARN) to which you want to + * add upload buffer, and one or more disk IDs that you want to configure as upload + * buffer.

+ */ export class AddUploadBufferCommand extends $Command< AddUploadBufferCommandInput, AddUploadBufferCommandOutput, @@ -34,6 +43,9 @@ export class AddUploadBufferCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/AddWorkingStorageCommand.ts b/clients/client-storage-gateway/commands/AddWorkingStorageCommand.ts index c749dc0117d73..1dc41570478a0 100644 --- a/clients/client-storage-gateway/commands/AddWorkingStorageCommand.ts +++ b/clients/client-storage-gateway/commands/AddWorkingStorageCommand.ts @@ -20,6 +20,21 @@ import { export type AddWorkingStorageCommandInput = AddWorkingStorageInput; export type AddWorkingStorageCommandOutput = AddWorkingStorageOutput & __MetadataBearer; +/** + *

Configures one or more gateway local disks as working storage for a gateway. This + * operation is only supported in the stored volume gateway type. This operation is deprecated + * in cached volume API version 20120630. Use AddUploadBuffer + * instead.

+ * + * + *

Working storage is also referred to as upload buffer. You can also use the AddUploadBuffer operation to add upload buffer to a stored volume + * gateway.

+ *
+ * + *

In the request, you specify the gateway Amazon Resource Name (ARN) to which you want to + * add working storage, and one or more disk IDs that you want to configure as working + * storage.

+ */ export class AddWorkingStorageCommand extends $Command< AddWorkingStorageCommandInput, AddWorkingStorageCommandOutput, @@ -34,6 +49,9 @@ export class AddWorkingStorageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/AssignTapePoolCommand.ts b/clients/client-storage-gateway/commands/AssignTapePoolCommand.ts index 75d29498ecc64..d73065c79d794 100644 --- a/clients/client-storage-gateway/commands/AssignTapePoolCommand.ts +++ b/clients/client-storage-gateway/commands/AssignTapePoolCommand.ts @@ -20,6 +20,15 @@ import { export type AssignTapePoolCommandInput = AssignTapePoolInput; export type AssignTapePoolCommandOutput = AssignTapePoolOutput & __MetadataBearer; +/** + *

Assigns a tape to a tape pool for archiving. The tape assigned to a pool is archived in + * the S3 storage class that is associated with the pool. When you use your backup application + * to eject the tape, the tape is archived directly into the S3 storage class (S3 Glacier or + * S3 Glacier Deep Archive) that corresponds to the pool.

+ * + *

Valid Values: GLACIER | DEEP_ARCHIVE + *

+ */ export class AssignTapePoolCommand extends $Command< AssignTapePoolCommandInput, AssignTapePoolCommandOutput, @@ -34,6 +43,9 @@ export class AssignTapePoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/AttachVolumeCommand.ts b/clients/client-storage-gateway/commands/AttachVolumeCommand.ts index 5f02f359cea1f..61e719f3f5112 100644 --- a/clients/client-storage-gateway/commands/AttachVolumeCommand.ts +++ b/clients/client-storage-gateway/commands/AttachVolumeCommand.ts @@ -20,6 +20,12 @@ import { export type AttachVolumeCommandInput = AttachVolumeInput; export type AttachVolumeCommandOutput = AttachVolumeOutput & __MetadataBearer; +/** + *

Connects a volume to an iSCSI connection and then attaches the volume to the specified + * gateway. Detaching and attaching a volume enables you to recover your data from one gateway + * to a different gateway without creating a snapshot. It also makes it easier to move your + * volumes from an on-premises gateway to a gateway hosted on an Amazon EC2 instance.

+ */ export class AttachVolumeCommand extends $Command< AttachVolumeCommandInput, AttachVolumeCommandOutput, @@ -34,6 +40,9 @@ export class AttachVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CancelArchivalCommand.ts b/clients/client-storage-gateway/commands/CancelArchivalCommand.ts index ddec03906c166..ab1b7a6fdb37d 100644 --- a/clients/client-storage-gateway/commands/CancelArchivalCommand.ts +++ b/clients/client-storage-gateway/commands/CancelArchivalCommand.ts @@ -20,6 +20,10 @@ import { export type CancelArchivalCommandInput = CancelArchivalInput; export type CancelArchivalCommandOutput = CancelArchivalOutput & __MetadataBearer; +/** + *

Cancels archiving of a virtual tape to the virtual tape shelf (VTS) after the archiving + * process is initiated. This operation is only supported in the tape gateway type.

+ */ export class CancelArchivalCommand extends $Command< CancelArchivalCommandInput, CancelArchivalCommandOutput, @@ -34,6 +38,9 @@ export class CancelArchivalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CancelRetrievalCommand.ts b/clients/client-storage-gateway/commands/CancelRetrievalCommand.ts index 21b1b566e04df..d03b26068c8a7 100644 --- a/clients/client-storage-gateway/commands/CancelRetrievalCommand.ts +++ b/clients/client-storage-gateway/commands/CancelRetrievalCommand.ts @@ -20,6 +20,11 @@ import { export type CancelRetrievalCommandInput = CancelRetrievalInput; export type CancelRetrievalCommandOutput = CancelRetrievalOutput & __MetadataBearer; +/** + *

Cancels retrieval of a virtual tape from the virtual tape shelf (VTS) to a gateway after + * the retrieval process is initiated. The virtual tape is returned to the VTS. This operation + * is only supported in the tape gateway type.

+ */ export class CancelRetrievalCommand extends $Command< CancelRetrievalCommandInput, CancelRetrievalCommandOutput, @@ -34,6 +39,9 @@ export class CancelRetrievalCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateCachediSCSIVolumeCommand.ts b/clients/client-storage-gateway/commands/CreateCachediSCSIVolumeCommand.ts index b59f89640088f..fbee344ece455 100644 --- a/clients/client-storage-gateway/commands/CreateCachediSCSIVolumeCommand.ts +++ b/clients/client-storage-gateway/commands/CreateCachediSCSIVolumeCommand.ts @@ -20,6 +20,26 @@ import { export type CreateCachediSCSIVolumeCommandInput = CreateCachediSCSIVolumeInput; export type CreateCachediSCSIVolumeCommandOutput = CreateCachediSCSIVolumeOutput & __MetadataBearer; +/** + *

Creates a cached volume on a specified cached volume gateway. This operation is only + * supported in the cached volume gateway type.

+ * + * + *

Cache storage must be allocated to the gateway before you can create a cached volume. + * Use the AddCache operation to add cache storage to a gateway.

+ *
+ * + *

In the request, you must specify the gateway, size of the volume in bytes, the iSCSI + * target name, an IP address on which to expose the target, and a unique client token. In + * response, the gateway creates the volume and returns information about it. This information + * includes the volume Amazon Resource Name (ARN), its size, and the iSCSI target ARN that + * initiators can use to connect to the volume target.

+ * + *

Optionally, you can provide the ARN for an existing volume as the + * SourceVolumeARN for this cached volume, which creates an exact copy of the + * existing volume’s latest recovery point. The VolumeSizeInBytes value must be + * equal to or larger than the size of the copied volume, in bytes.

+ */ export class CreateCachediSCSIVolumeCommand extends $Command< CreateCachediSCSIVolumeCommandInput, CreateCachediSCSIVolumeCommandOutput, @@ -34,6 +54,9 @@ export class CreateCachediSCSIVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateNFSFileShareCommand.ts b/clients/client-storage-gateway/commands/CreateNFSFileShareCommand.ts index a428a888d8608..981007ad892a4 100644 --- a/clients/client-storage-gateway/commands/CreateNFSFileShareCommand.ts +++ b/clients/client-storage-gateway/commands/CreateNFSFileShareCommand.ts @@ -20,6 +20,23 @@ import { export type CreateNFSFileShareCommandInput = CreateNFSFileShareInput; export type CreateNFSFileShareCommandOutput = CreateNFSFileShareOutput & __MetadataBearer; +/** + *

Creates a Network File System (NFS) file share on an existing file gateway. In Storage + * Gateway, a file share is a file system mount point backed by Amazon S3 cloud storage. + * Storage Gateway exposes file shares using an NFS interface. This operation is only + * supported for file gateways.

+ * + * + *

File gateway requires AWS Security Token Service (AWS STS) to be activated to enable + * you to create a file share. Make sure AWS STS is activated in the AWS Region you are + * creating your file gateway in. If AWS STS is not activated in the AWS Region, activate + * it. For information about how to activate AWS STS, see Activating and + * deactivating AWS STS in an AWS Region in the AWS Identity and + * Access Management User Guide.

+ * + *

File gateway does not support creating hard or symbolic links on a file share.

+ *
+ */ export class CreateNFSFileShareCommand extends $Command< CreateNFSFileShareCommandInput, CreateNFSFileShareCommandOutput, @@ -34,6 +51,9 @@ export class CreateNFSFileShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateSMBFileShareCommand.ts b/clients/client-storage-gateway/commands/CreateSMBFileShareCommand.ts index 76c440fad9452..00da2dafeb15a 100644 --- a/clients/client-storage-gateway/commands/CreateSMBFileShareCommand.ts +++ b/clients/client-storage-gateway/commands/CreateSMBFileShareCommand.ts @@ -20,6 +20,24 @@ import { export type CreateSMBFileShareCommandInput = CreateSMBFileShareInput; export type CreateSMBFileShareCommandOutput = CreateSMBFileShareOutput & __MetadataBearer; +/** + *

Creates a Server Message Block (SMB) file share on an existing file gateway. In Storage + * Gateway, a file share is a file system mount point backed by Amazon S3 cloud storage. + * Storage Gateway exposes file shares using an SMB interface. This operation is only + * supported for file gateways.

+ * + * + *

File gateways require AWS Security Token Service (AWS STS) to be activated to enable + * you to create a file share. Make sure that AWS STS is activated in the AWS Region you + * are creating your file gateway in. If AWS STS is not activated in this AWS Region, + * activate it. For information about how to activate AWS STS, see Activating and + * deactivating AWS STS in an AWS Region in the AWS Identity and + * Access Management User Guide.

+ * + *

File gateways don't support creating hard or symbolic links on a file + * share.

+ *
+ */ export class CreateSMBFileShareCommand extends $Command< CreateSMBFileShareCommandInput, CreateSMBFileShareCommandOutput, @@ -34,6 +52,9 @@ export class CreateSMBFileShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateSnapshotCommand.ts b/clients/client-storage-gateway/commands/CreateSnapshotCommand.ts index 43dc541ee6f4d..2ee0b313da122 100644 --- a/clients/client-storage-gateway/commands/CreateSnapshotCommand.ts +++ b/clients/client-storage-gateway/commands/CreateSnapshotCommand.ts @@ -20,6 +20,36 @@ import { export type CreateSnapshotCommandInput = CreateSnapshotInput; export type CreateSnapshotCommandOutput = CreateSnapshotOutput & __MetadataBearer; +/** + *

Initiates a snapshot of a volume.

+ * + *

AWS Storage Gateway provides the ability to back up point-in-time snapshots of your data + * to Amazon Simple Storage (Amazon S3) for durable off-site recovery, as well as import the + * data to an Amazon Elastic Block Store (EBS) volume in Amazon Elastic Compute Cloud (EC2). + * You can take snapshots of your gateway volume on a scheduled or ad hoc basis. This API + * enables you to take an ad hoc snapshot. For more information, see Editing a + * snapshot schedule.

+ * + *

In the CreateSnapshot request, you identify the volume by providing its + * Amazon Resource Name (ARN). You must also provide description for the snapshot. When AWS + * Storage Gateway takes the snapshot of specified volume, the snapshot and description + * appears in the AWS Storage Gateway console. In response, AWS Storage Gateway returns you a + * snapshot ID. You can use this snapshot ID to check the snapshot progress or later use it + * when you want to create a volume from a snapshot. This operation is only supported in + * stored and cached volume gateway type.

+ * + * + *

To list or delete a snapshot, you must use the Amazon EC2 API. For more information, + * see DescribeSnapshots + * or DeleteSnapshot in the Amazon Elastic Compute Cloud API + * Reference.

+ *
+ * + * + *

Volume and snapshot IDs are changing to a longer length ID format. For more + * information, see the important note on the Welcome page.

+ *
+ */ export class CreateSnapshotCommand extends $Command< CreateSnapshotCommandInput, CreateSnapshotCommandOutput, @@ -34,6 +64,9 @@ export class CreateSnapshotCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateSnapshotFromVolumeRecoveryPointCommand.ts b/clients/client-storage-gateway/commands/CreateSnapshotFromVolumeRecoveryPointCommand.ts index 41f8d9f144073..d98687b3f0a69 100644 --- a/clients/client-storage-gateway/commands/CreateSnapshotFromVolumeRecoveryPointCommand.ts +++ b/clients/client-storage-gateway/commands/CreateSnapshotFromVolumeRecoveryPointCommand.ts @@ -24,6 +24,29 @@ export type CreateSnapshotFromVolumeRecoveryPointCommandInput = CreateSnapshotFr export type CreateSnapshotFromVolumeRecoveryPointCommandOutput = CreateSnapshotFromVolumeRecoveryPointOutput & __MetadataBearer; +/** + *

Initiates a snapshot of a gateway from a volume recovery point. This operation is only + * supported in the cached volume gateway type.

+ * + *

A volume recovery point is a point in time at which all data of the volume is consistent + * and from which you can create a snapshot. To get a list of volume recovery point for cached + * volume gateway, use ListVolumeRecoveryPoints.

+ * + *

In the CreateSnapshotFromVolumeRecoveryPoint request, you identify the + * volume by providing its Amazon Resource Name (ARN). You must also provide a description for + * the snapshot. When the gateway takes a snapshot of the specified volume, the snapshot and + * its description appear in the AWS Storage Gateway console. + * In response, the gateway returns + * you a snapshot ID. You can use this snapshot ID to check the snapshot progress or later use + * it when you want to create a volume from a snapshot.

+ * + * + *

To list or delete a snapshot, you must use the Amazon EC2 API. For more information, + * see DescribeSnapshots + * or DeleteSnapshot in the Amazon Elastic Compute Cloud API + * Reference.

+ *
+ */ export class CreateSnapshotFromVolumeRecoveryPointCommand extends $Command< CreateSnapshotFromVolumeRecoveryPointCommandInput, CreateSnapshotFromVolumeRecoveryPointCommandOutput, @@ -38,6 +61,9 @@ export class CreateSnapshotFromVolumeRecoveryPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateStorediSCSIVolumeCommand.ts b/clients/client-storage-gateway/commands/CreateStorediSCSIVolumeCommand.ts index 1e44c2f6825e4..cd5ddb7df5c07 100644 --- a/clients/client-storage-gateway/commands/CreateStorediSCSIVolumeCommand.ts +++ b/clients/client-storage-gateway/commands/CreateStorediSCSIVolumeCommand.ts @@ -20,6 +20,20 @@ import { export type CreateStorediSCSIVolumeCommandInput = CreateStorediSCSIVolumeInput; export type CreateStorediSCSIVolumeCommandOutput = CreateStorediSCSIVolumeOutput & __MetadataBearer; +/** + *

Creates a volume on a specified gateway. This operation is only supported in the stored + * volume gateway type.

+ * + *

The size of the volume to create is inferred from the disk size. You can choose to + * preserve existing data on the disk, create volume from an existing snapshot, or create an + * empty volume. If you choose to create an empty gateway volume, then any existing data on + * the disk is erased.

+ * + *

In the request, you must specify the gateway and the disk information on which you are + * creating the volume. In response, the gateway creates the volume and returns volume + * information such as the volume Amazon Resource Name (ARN), its size, and the iSCSI target + * ARN that initiators can use to connect to the volume target.

+ */ export class CreateStorediSCSIVolumeCommand extends $Command< CreateStorediSCSIVolumeCommandInput, CreateStorediSCSIVolumeCommandOutput, @@ -34,6 +48,9 @@ export class CreateStorediSCSIVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateTapePoolCommand.ts b/clients/client-storage-gateway/commands/CreateTapePoolCommand.ts index 621cc4103025f..b5e94d5754e0e 100644 --- a/clients/client-storage-gateway/commands/CreateTapePoolCommand.ts +++ b/clients/client-storage-gateway/commands/CreateTapePoolCommand.ts @@ -20,6 +20,10 @@ import { export type CreateTapePoolCommandInput = CreateTapePoolInput; export type CreateTapePoolCommandOutput = CreateTapePoolOutput & __MetadataBearer; +/** + *

Creates a new custom tape pool. You can use custom tape pool to enable tape retention + * lock on tapes that are archived in the custom pool.

+ */ export class CreateTapePoolCommand extends $Command< CreateTapePoolCommandInput, CreateTapePoolCommandOutput, @@ -34,6 +38,9 @@ export class CreateTapePoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateTapeWithBarcodeCommand.ts b/clients/client-storage-gateway/commands/CreateTapeWithBarcodeCommand.ts index 82a9198676c93..49d557ea60c9f 100644 --- a/clients/client-storage-gateway/commands/CreateTapeWithBarcodeCommand.ts +++ b/clients/client-storage-gateway/commands/CreateTapeWithBarcodeCommand.ts @@ -20,6 +20,17 @@ import { export type CreateTapeWithBarcodeCommandInput = CreateTapeWithBarcodeInput; export type CreateTapeWithBarcodeCommandOutput = CreateTapeWithBarcodeOutput & __MetadataBearer; +/** + *

Creates a virtual tape by using your own barcode. You write data to the virtual tape and + * then archive the tape. A barcode is unique and cannot be reused if it has already been used + * on a tape. This applies to barcodes used on deleted tapes. This operation is only supported + * in the tape gateway type.

+ * + * + *

Cache storage must be allocated to the gateway before you can create a virtual tape. + * Use the AddCache operation to add cache storage to a gateway.

+ *
+ */ export class CreateTapeWithBarcodeCommand extends $Command< CreateTapeWithBarcodeCommandInput, CreateTapeWithBarcodeCommandOutput, @@ -34,6 +45,9 @@ export class CreateTapeWithBarcodeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/CreateTapesCommand.ts b/clients/client-storage-gateway/commands/CreateTapesCommand.ts index e2cd8bd82dfeb..a44624007011e 100644 --- a/clients/client-storage-gateway/commands/CreateTapesCommand.ts +++ b/clients/client-storage-gateway/commands/CreateTapesCommand.ts @@ -20,6 +20,15 @@ import { export type CreateTapesCommandInput = CreateTapesInput; export type CreateTapesCommandOutput = CreateTapesOutput & __MetadataBearer; +/** + *

Creates one or more virtual tapes. You write data to the virtual tapes and then archive + * the tapes. This operation is only supported in the tape gateway type.

+ * + * + *

Cache storage must be allocated to the gateway before you can create virtual tapes. + * Use the AddCache operation to add cache storage to a gateway.

+ *
+ */ export class CreateTapesCommand extends $Command< CreateTapesCommandInput, CreateTapesCommandOutput, @@ -34,6 +43,9 @@ export class CreateTapesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteAutomaticTapeCreationPolicyCommand.ts b/clients/client-storage-gateway/commands/DeleteAutomaticTapeCreationPolicyCommand.ts index 8b90996c2b800..c815b8db0c950 100644 --- a/clients/client-storage-gateway/commands/DeleteAutomaticTapeCreationPolicyCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteAutomaticTapeCreationPolicyCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteAutomaticTapeCreationPolicyCommandInput = DeleteAutomaticTapeCreationPolicyInput; export type DeleteAutomaticTapeCreationPolicyCommandOutput = DeleteAutomaticTapeCreationPolicyOutput & __MetadataBearer; +/** + *

Deletes the automatic tape creation policy of a gateway. If you delete this policy, new + * virtual tapes must be created manually. Use the Amazon Resource Name (ARN) of the gateway + * in your request to remove the policy.

+ */ export class DeleteAutomaticTapeCreationPolicyCommand extends $Command< DeleteAutomaticTapeCreationPolicyCommandInput, DeleteAutomaticTapeCreationPolicyCommandOutput, @@ -34,6 +39,9 @@ export class DeleteAutomaticTapeCreationPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteBandwidthRateLimitCommand.ts b/clients/client-storage-gateway/commands/DeleteBandwidthRateLimitCommand.ts index e82aca88b2b7a..f3145d72064fd 100644 --- a/clients/client-storage-gateway/commands/DeleteBandwidthRateLimitCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteBandwidthRateLimitCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteBandwidthRateLimitCommandInput = DeleteBandwidthRateLimitInput; export type DeleteBandwidthRateLimitCommandOutput = DeleteBandwidthRateLimitOutput & __MetadataBearer; +/** + *

Deletes the bandwidth rate limits of a gateway. You can delete either the upload and + * download bandwidth rate limit, or you can delete both. If you delete only one of the + * limits, the other limit remains unchanged. To specify which gateway to work with, use the + * Amazon Resource Name (ARN) of the gateway in your request. This operation is supported for + * the stored volume, cached volume and tape gateway types.

+ */ export class DeleteBandwidthRateLimitCommand extends $Command< DeleteBandwidthRateLimitCommandInput, DeleteBandwidthRateLimitCommandOutput, @@ -34,6 +41,9 @@ export class DeleteBandwidthRateLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteChapCredentialsCommand.ts b/clients/client-storage-gateway/commands/DeleteChapCredentialsCommand.ts index bb939a7dbba73..ec9ffb82b978b 100644 --- a/clients/client-storage-gateway/commands/DeleteChapCredentialsCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteChapCredentialsCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteChapCredentialsCommandInput = DeleteChapCredentialsInput; export type DeleteChapCredentialsCommandOutput = DeleteChapCredentialsOutput & __MetadataBearer; +/** + *

Deletes Challenge-Handshake Authentication Protocol (CHAP) credentials for a specified + * iSCSI target and initiator pair. This operation is supported in volume and tape gateway + * types.

+ */ export class DeleteChapCredentialsCommand extends $Command< DeleteChapCredentialsCommandInput, DeleteChapCredentialsCommandOutput, @@ -34,6 +39,9 @@ export class DeleteChapCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteFileShareCommand.ts b/clients/client-storage-gateway/commands/DeleteFileShareCommand.ts index 0c2d988e3c970..c0fe74ea9f40e 100644 --- a/clients/client-storage-gateway/commands/DeleteFileShareCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteFileShareCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteFileShareCommandInput = DeleteFileShareInput; export type DeleteFileShareCommandOutput = DeleteFileShareOutput & __MetadataBearer; +/** + *

Deletes a file share from a file gateway. This operation is only supported for file + * gateways.

+ */ export class DeleteFileShareCommand extends $Command< DeleteFileShareCommandInput, DeleteFileShareCommandOutput, @@ -34,6 +38,9 @@ export class DeleteFileShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteGatewayCommand.ts b/clients/client-storage-gateway/commands/DeleteGatewayCommand.ts index 5c66e38017239..b003b52eb3496 100644 --- a/clients/client-storage-gateway/commands/DeleteGatewayCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteGatewayCommand.ts @@ -20,6 +20,26 @@ import { export type DeleteGatewayCommandInput = DeleteGatewayInput; export type DeleteGatewayCommandOutput = DeleteGatewayOutput & __MetadataBearer; +/** + *

Deletes a gateway. To specify which gateway to delete, use the Amazon Resource Name + * (ARN) of the gateway in your request. The operation deletes the gateway; however, it does + * not delete the gateway virtual machine (VM) from your host computer.

+ * + *

After you delete a gateway, you cannot reactivate it. Completed snapshots of the gateway + * volumes are not deleted upon deleting the gateway, however, pending snapshots will not + * complete. After you delete a gateway, your next step is to remove it from your + * environment.

+ * + * + *

You no longer pay software charges after the gateway is deleted; however, your + * existing Amazon EBS snapshots persist and you will continue to be billed for these + * snapshots. You can choose to remove all remaining Amazon EBS snapshots by canceling your + * Amazon EC2 subscription.  If you prefer not to cancel your Amazon EC2 subscription, you + * can delete your snapshots using the Amazon EC2 console. For more information, see the + * AWS Storage Gateway detail + * page.

+ *
+ */ export class DeleteGatewayCommand extends $Command< DeleteGatewayCommandInput, DeleteGatewayCommandOutput, @@ -34,6 +54,9 @@ export class DeleteGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteSnapshotScheduleCommand.ts b/clients/client-storage-gateway/commands/DeleteSnapshotScheduleCommand.ts index 7a9aa11aeee39..19ceea034942a 100644 --- a/clients/client-storage-gateway/commands/DeleteSnapshotScheduleCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteSnapshotScheduleCommand.ts @@ -20,6 +20,23 @@ import { export type DeleteSnapshotScheduleCommandInput = DeleteSnapshotScheduleInput; export type DeleteSnapshotScheduleCommandOutput = DeleteSnapshotScheduleOutput & __MetadataBearer; +/** + *

Deletes a snapshot of a volume.

+ * + *

You can take snapshots of your gateway volumes on a scheduled or ad hoc basis. This API + * action enables you to delete a snapshot schedule for a volume. For more information, see + * Backing up your + * volumes. In the DeleteSnapshotSchedule request, you identify the + * volume by providing its Amazon Resource Name (ARN). This operation is only supported in + * stored and cached volume gateway types.

+ * + * + * + *

To list or delete a snapshot, you must use the Amazon EC2 API. For more information, + * go to DescribeSnapshots + * in the Amazon Elastic Compute Cloud API Reference.

+ *
+ */ export class DeleteSnapshotScheduleCommand extends $Command< DeleteSnapshotScheduleCommandInput, DeleteSnapshotScheduleCommandOutput, @@ -34,6 +51,9 @@ export class DeleteSnapshotScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteTapeArchiveCommand.ts b/clients/client-storage-gateway/commands/DeleteTapeArchiveCommand.ts index 1bcd1d393071c..e82f725f28ddd 100644 --- a/clients/client-storage-gateway/commands/DeleteTapeArchiveCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteTapeArchiveCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTapeArchiveCommandInput = DeleteTapeArchiveInput; export type DeleteTapeArchiveCommandOutput = DeleteTapeArchiveOutput & __MetadataBearer; +/** + *

Deletes the specified virtual tape from the virtual tape shelf (VTS). This operation is + * only supported in the tape gateway type.

+ */ export class DeleteTapeArchiveCommand extends $Command< DeleteTapeArchiveCommandInput, DeleteTapeArchiveCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTapeArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteTapeCommand.ts b/clients/client-storage-gateway/commands/DeleteTapeCommand.ts index 55fe69e80ad41..bb82ca7afec94 100644 --- a/clients/client-storage-gateway/commands/DeleteTapeCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteTapeCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTapeCommandInput = DeleteTapeInput; export type DeleteTapeCommandOutput = DeleteTapeOutput & __MetadataBearer; +/** + *

Deletes the specified virtual tape. This operation is only supported in the tape gateway + * type.

+ */ export class DeleteTapeCommand extends $Command< DeleteTapeCommandInput, DeleteTapeCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTapeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteTapePoolCommand.ts b/clients/client-storage-gateway/commands/DeleteTapePoolCommand.ts index 7f2bacd0aaab1..ed7bd3c662226 100644 --- a/clients/client-storage-gateway/commands/DeleteTapePoolCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteTapePoolCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteTapePoolCommandInput = DeleteTapePoolInput; export type DeleteTapePoolCommandOutput = DeleteTapePoolOutput & __MetadataBearer; +/** + *

Delete a custom tape pool. A custom tape pool can only be deleted if there are no tapes + * in the pool and if there are no automatic tape creation policies that reference the custom + * tape pool.

+ */ export class DeleteTapePoolCommand extends $Command< DeleteTapePoolCommandInput, DeleteTapePoolCommandOutput, @@ -34,6 +39,9 @@ export class DeleteTapePoolCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DeleteVolumeCommand.ts b/clients/client-storage-gateway/commands/DeleteVolumeCommand.ts index 9c0fcddc5491f..d0c93591a652e 100644 --- a/clients/client-storage-gateway/commands/DeleteVolumeCommand.ts +++ b/clients/client-storage-gateway/commands/DeleteVolumeCommand.ts @@ -20,6 +20,21 @@ import { export type DeleteVolumeCommandInput = DeleteVolumeInput; export type DeleteVolumeCommandOutput = DeleteVolumeOutput & __MetadataBearer; +/** + *

Deletes the specified storage volume that you previously created using the CreateCachediSCSIVolume or CreateStorediSCSIVolume API. + * This operation is only supported in the cached volume and stored volume types. For stored + * volume gateways, the local disk that was configured as the storage volume is not deleted. + * You can reuse the local disk to create another storage volume.

+ * + *

Before you delete a volume, make sure there are no iSCSI connections to the volume you + * are deleting. You should also make sure there is no snapshot in progress. You can use the + * Amazon Elastic Compute Cloud (Amazon EC2) API to query snapshots on the volume you are + * deleting and check the snapshot status. For more information, go to DescribeSnapshots in the Amazon Elastic Compute Cloud API + * Reference.

+ * + *

In the request, you must provide the Amazon Resource Name (ARN) of the storage volume + * you want to delete.

+ */ export class DeleteVolumeCommand extends $Command< DeleteVolumeCommandInput, DeleteVolumeCommandOutput, @@ -34,6 +49,9 @@ export class DeleteVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeAvailabilityMonitorTestCommand.ts b/clients/client-storage-gateway/commands/DescribeAvailabilityMonitorTestCommand.ts index 9a6d849b969fc..abdfda8772f61 100644 --- a/clients/client-storage-gateway/commands/DescribeAvailabilityMonitorTestCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeAvailabilityMonitorTestCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeAvailabilityMonitorTestCommandInput = DescribeAvailabilityMonitorTestInput; export type DescribeAvailabilityMonitorTestCommandOutput = DescribeAvailabilityMonitorTestOutput & __MetadataBearer; +/** + *

Returns information about the most recent High Availability monitoring test that was + * performed on the host in a cluster. If a test isn't performed, the status and start + * time in the response would be null.

+ */ export class DescribeAvailabilityMonitorTestCommand extends $Command< DescribeAvailabilityMonitorTestCommandInput, DescribeAvailabilityMonitorTestCommandOutput, @@ -34,6 +39,9 @@ export class DescribeAvailabilityMonitorTestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeBandwidthRateLimitCommand.ts b/clients/client-storage-gateway/commands/DescribeBandwidthRateLimitCommand.ts index 0d3727f83bef4..913d1cdd63793 100644 --- a/clients/client-storage-gateway/commands/DescribeBandwidthRateLimitCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeBandwidthRateLimitCommand.ts @@ -20,6 +20,16 @@ import { export type DescribeBandwidthRateLimitCommandInput = DescribeBandwidthRateLimitInput; export type DescribeBandwidthRateLimitCommandOutput = DescribeBandwidthRateLimitOutput & __MetadataBearer; +/** + *

Returns the bandwidth rate limits of a gateway. By default, these limits are not set, + * which means no bandwidth rate limiting is in effect. This operation is supported for the + * stored volume, cached volume, and tape gateway types.

+ * + *

This operation only returns a value for a bandwidth rate limit only if the limit is set. + * If no limits are set for the gateway, then this operation returns only the gateway ARN in + * the response body. To specify which gateway to describe, use the Amazon Resource Name (ARN) + * of the gateway in your request.

+ */ export class DescribeBandwidthRateLimitCommand extends $Command< DescribeBandwidthRateLimitCommandInput, DescribeBandwidthRateLimitCommandOutput, @@ -34,6 +44,9 @@ export class DescribeBandwidthRateLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeBandwidthRateLimitScheduleCommand.ts b/clients/client-storage-gateway/commands/DescribeBandwidthRateLimitScheduleCommand.ts index 77374f71b075d..53a67ee383e8b 100644 --- a/clients/client-storage-gateway/commands/DescribeBandwidthRateLimitScheduleCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeBandwidthRateLimitScheduleCommand.ts @@ -21,6 +21,29 @@ export type DescribeBandwidthRateLimitScheduleCommandInput = DescribeBandwidthRa export type DescribeBandwidthRateLimitScheduleCommandOutput = DescribeBandwidthRateLimitScheduleOutput & __MetadataBearer; +/** + *

+ * Returns information about the bandwidth rate limit schedule of a gateway. By default, gateways do + * not have bandwidth rate limit schedules, which means no bandwidth rate limiting is in effect. This + * operation is supported only in the volume and tape gateway types. + *

+ * + *

This operation returns information about a gateway's bandwidth rate limit schedule. A bandwidth + * rate limit schedule consists of one or more bandwidth rate limit intervals. A bandwidth rate limit + * interval defines a period of time on one or more days of the week, during which bandwidth rate + * limits are specified for uploading, downloading, or both. + *

+ * + *

+ * A bandwidth rate limit interval consists of one or more days of the week, a start hour and minute, + * an ending hour and minute, and bandwidth rate limits for uploading and downloading + *

+ * + *

+ * If no bandwidth rate limit schedule intervals are set for the gateway, this operation returns an + * empty response. To specify which gateway to describe, use the Amazon Resource Name (ARN) + * of the gateway in your request.

+ */ export class DescribeBandwidthRateLimitScheduleCommand extends $Command< DescribeBandwidthRateLimitScheduleCommandInput, DescribeBandwidthRateLimitScheduleCommandOutput, @@ -35,6 +58,9 @@ export class DescribeBandwidthRateLimitScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeCacheCommand.ts b/clients/client-storage-gateway/commands/DescribeCacheCommand.ts index 6f376750ba5ce..46c343cd817ba 100644 --- a/clients/client-storage-gateway/commands/DescribeCacheCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeCacheCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeCacheCommandInput = DescribeCacheInput; export type DescribeCacheCommandOutput = DescribeCacheOutput & __MetadataBearer; +/** + *

Returns information about the cache of a gateway. This operation is only supported in + * the cached volume, tape, and file gateway types.

+ * + *

The response includes disk IDs that are configured as cache, and it includes the amount + * of cache allocated and used.

+ */ export class DescribeCacheCommand extends $Command< DescribeCacheCommandInput, DescribeCacheCommandOutput, @@ -34,6 +41,9 @@ export class DescribeCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeCachediSCSIVolumesCommand.ts b/clients/client-storage-gateway/commands/DescribeCachediSCSIVolumesCommand.ts index 17a8775c83316..3a9a05b6afc95 100644 --- a/clients/client-storage-gateway/commands/DescribeCachediSCSIVolumesCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeCachediSCSIVolumesCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeCachediSCSIVolumesCommandInput = DescribeCachediSCSIVolumesInput; export type DescribeCachediSCSIVolumesCommandOutput = DescribeCachediSCSIVolumesOutput & __MetadataBearer; +/** + *

Returns a description of the gateway volumes specified in the request. This operation is + * only supported in the cached volume gateway types.

+ * + *

The list of gateway volumes in the request must be from one gateway. In the response, + * AWS Storage Gateway returns volume information sorted by volume Amazon Resource Name + * (ARN).

+ */ export class DescribeCachediSCSIVolumesCommand extends $Command< DescribeCachediSCSIVolumesCommandInput, DescribeCachediSCSIVolumesCommandOutput, @@ -34,6 +42,9 @@ export class DescribeCachediSCSIVolumesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeChapCredentialsCommand.ts b/clients/client-storage-gateway/commands/DescribeChapCredentialsCommand.ts index 55713bba09a36..372f5ef5d5259 100644 --- a/clients/client-storage-gateway/commands/DescribeChapCredentialsCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeChapCredentialsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeChapCredentialsCommandInput = DescribeChapCredentialsInput; export type DescribeChapCredentialsCommandOutput = DescribeChapCredentialsOutput & __MetadataBearer; +/** + *

Returns an array of Challenge-Handshake Authentication Protocol (CHAP) credentials + * information for a specified iSCSI target, one for each target-initiator pair. This + * operation is supported in the volume and tape gateway types.

+ */ export class DescribeChapCredentialsCommand extends $Command< DescribeChapCredentialsCommandInput, DescribeChapCredentialsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeChapCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeGatewayInformationCommand.ts b/clients/client-storage-gateway/commands/DescribeGatewayInformationCommand.ts index 8060af21486b2..9a145d87171f8 100644 --- a/clients/client-storage-gateway/commands/DescribeGatewayInformationCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeGatewayInformationCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeGatewayInformationCommandInput = DescribeGatewayInformationInput; export type DescribeGatewayInformationCommandOutput = DescribeGatewayInformationOutput & __MetadataBearer; +/** + *

Returns metadata about a gateway such as its name, network interfaces, configured time + * zone, and the state (whether the gateway is running or not). To specify which gateway to + * describe, use the Amazon Resource Name (ARN) of the gateway in your request.

+ */ export class DescribeGatewayInformationCommand extends $Command< DescribeGatewayInformationCommandInput, DescribeGatewayInformationCommandOutput, @@ -34,6 +39,9 @@ export class DescribeGatewayInformationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeMaintenanceStartTimeCommand.ts b/clients/client-storage-gateway/commands/DescribeMaintenanceStartTimeCommand.ts index ec73f37cfc2fa..7f68c03aeed23 100644 --- a/clients/client-storage-gateway/commands/DescribeMaintenanceStartTimeCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeMaintenanceStartTimeCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeMaintenanceStartTimeCommandInput = DescribeMaintenanceStartTimeInput; export type DescribeMaintenanceStartTimeCommandOutput = DescribeMaintenanceStartTimeOutput & __MetadataBearer; +/** + *

Returns your gateway's weekly maintenance start time including the day and time of + * the week. Note that values are in terms of the gateway's time zone.

+ */ export class DescribeMaintenanceStartTimeCommand extends $Command< DescribeMaintenanceStartTimeCommandInput, DescribeMaintenanceStartTimeCommandOutput, @@ -34,6 +38,9 @@ export class DescribeMaintenanceStartTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeNFSFileSharesCommand.ts b/clients/client-storage-gateway/commands/DescribeNFSFileSharesCommand.ts index fa5d0a8f81a35..59e26fe03d89c 100644 --- a/clients/client-storage-gateway/commands/DescribeNFSFileSharesCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeNFSFileSharesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeNFSFileSharesCommandInput = DescribeNFSFileSharesInput; export type DescribeNFSFileSharesCommandOutput = DescribeNFSFileSharesOutput & __MetadataBearer; +/** + *

Gets a description for one or more Network File System (NFS) file shares from a file + * gateway. This operation is only supported for file gateways.

+ */ export class DescribeNFSFileSharesCommand extends $Command< DescribeNFSFileSharesCommandInput, DescribeNFSFileSharesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeNFSFileSharesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeSMBFileSharesCommand.ts b/clients/client-storage-gateway/commands/DescribeSMBFileSharesCommand.ts index 66cde42c5047f..6a909bcdc1678 100644 --- a/clients/client-storage-gateway/commands/DescribeSMBFileSharesCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeSMBFileSharesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSMBFileSharesCommandInput = DescribeSMBFileSharesInput; export type DescribeSMBFileSharesCommandOutput = DescribeSMBFileSharesOutput & __MetadataBearer; +/** + *

Gets a description for one or more Server Message Block (SMB) file shares from a file + * gateway. This operation is only supported for file gateways.

+ */ export class DescribeSMBFileSharesCommand extends $Command< DescribeSMBFileSharesCommandInput, DescribeSMBFileSharesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSMBFileSharesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeSMBSettingsCommand.ts b/clients/client-storage-gateway/commands/DescribeSMBSettingsCommand.ts index 445d7a754759c..329ec1744722c 100644 --- a/clients/client-storage-gateway/commands/DescribeSMBSettingsCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeSMBSettingsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeSMBSettingsCommandInput = DescribeSMBSettingsInput; export type DescribeSMBSettingsCommandOutput = DescribeSMBSettingsOutput & __MetadataBearer; +/** + *

Gets a description of a Server Message Block (SMB) file share settings from a file + * gateway. This operation is only supported for file gateways.

+ */ export class DescribeSMBSettingsCommand extends $Command< DescribeSMBSettingsCommandInput, DescribeSMBSettingsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeSMBSettingsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeSnapshotScheduleCommand.ts b/clients/client-storage-gateway/commands/DescribeSnapshotScheduleCommand.ts index 56bf98f901ec7..2928285386791 100644 --- a/clients/client-storage-gateway/commands/DescribeSnapshotScheduleCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeSnapshotScheduleCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeSnapshotScheduleCommandInput = DescribeSnapshotScheduleInput; export type DescribeSnapshotScheduleCommandOutput = DescribeSnapshotScheduleOutput & __MetadataBearer; +/** + *

Describes the snapshot schedule for the specified gateway volume. The snapshot schedule + * information includes intervals at which snapshots are automatically initiated on the + * volume. This operation is only supported in the cached volume and stored volume + * types.

+ */ export class DescribeSnapshotScheduleCommand extends $Command< DescribeSnapshotScheduleCommandInput, DescribeSnapshotScheduleCommandOutput, @@ -34,6 +40,9 @@ export class DescribeSnapshotScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeStorediSCSIVolumesCommand.ts b/clients/client-storage-gateway/commands/DescribeStorediSCSIVolumesCommand.ts index f98e9af237be0..c28dcd51b15a4 100644 --- a/clients/client-storage-gateway/commands/DescribeStorediSCSIVolumesCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeStorediSCSIVolumesCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeStorediSCSIVolumesCommandInput = DescribeStorediSCSIVolumesInput; export type DescribeStorediSCSIVolumesCommandOutput = DescribeStorediSCSIVolumesOutput & __MetadataBearer; +/** + *

Returns the description of the gateway volumes specified in the request. The list of + * gateway volumes in the request must be from one gateway. In the response, AWS Storage + * Gateway returns volume information sorted by volume ARNs. This operation is only supported + * in stored volume gateway type.

+ */ export class DescribeStorediSCSIVolumesCommand extends $Command< DescribeStorediSCSIVolumesCommandInput, DescribeStorediSCSIVolumesCommandOutput, @@ -34,6 +40,9 @@ export class DescribeStorediSCSIVolumesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeTapeArchivesCommand.ts b/clients/client-storage-gateway/commands/DescribeTapeArchivesCommand.ts index 902fe4e326d6d..47e22a96ab3eb 100644 --- a/clients/client-storage-gateway/commands/DescribeTapeArchivesCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeTapeArchivesCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeTapeArchivesCommandInput = DescribeTapeArchivesInput; export type DescribeTapeArchivesCommandOutput = DescribeTapeArchivesOutput & __MetadataBearer; +/** + *

Returns a description of specified virtual tapes in the virtual tape shelf (VTS). This + * operation is only supported in the tape gateway type.

+ * + *

If a specific TapeARN is not specified, AWS Storage Gateway returns a + * description of all virtual tapes found in the VTS associated with your account.

+ */ export class DescribeTapeArchivesCommand extends $Command< DescribeTapeArchivesCommandInput, DescribeTapeArchivesCommandOutput, @@ -34,6 +41,9 @@ export class DescribeTapeArchivesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeTapeRecoveryPointsCommand.ts b/clients/client-storage-gateway/commands/DescribeTapeRecoveryPointsCommand.ts index 7384c4d812309..7757dc2112a25 100644 --- a/clients/client-storage-gateway/commands/DescribeTapeRecoveryPointsCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeTapeRecoveryPointsCommand.ts @@ -20,6 +20,15 @@ import { export type DescribeTapeRecoveryPointsCommandInput = DescribeTapeRecoveryPointsInput; export type DescribeTapeRecoveryPointsCommandOutput = DescribeTapeRecoveryPointsOutput & __MetadataBearer; +/** + *

Returns a list of virtual tape recovery points that are available for the specified tape + * gateway.

+ * + *

A recovery point is a point-in-time view of a virtual tape at which all the data on the + * virtual tape is consistent. If your gateway crashes, virtual tapes that have recovery + * points can be recovered to a new gateway. This operation is only supported in the tape + * gateway type.

+ */ export class DescribeTapeRecoveryPointsCommand extends $Command< DescribeTapeRecoveryPointsCommandInput, DescribeTapeRecoveryPointsCommandOutput, @@ -34,6 +43,9 @@ export class DescribeTapeRecoveryPointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeTapesCommand.ts b/clients/client-storage-gateway/commands/DescribeTapesCommand.ts index 4f78c21097955..91772a35074fb 100644 --- a/clients/client-storage-gateway/commands/DescribeTapesCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeTapesCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeTapesCommandInput = DescribeTapesInput; export type DescribeTapesCommandOutput = DescribeTapesOutput & __MetadataBearer; +/** + *

Returns a description of the specified Amazon Resource Name (ARN) of virtual tapes. If a + * TapeARN is not specified, returns a description of all virtual tapes + * associated with the specified gateway. This operation is only supported in the tape gateway + * type.

+ */ export class DescribeTapesCommand extends $Command< DescribeTapesCommandInput, DescribeTapesCommandOutput, @@ -34,6 +40,9 @@ export class DescribeTapesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeUploadBufferCommand.ts b/clients/client-storage-gateway/commands/DescribeUploadBufferCommand.ts index fc96970ea72aa..1cbba62f8a955 100644 --- a/clients/client-storage-gateway/commands/DescribeUploadBufferCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeUploadBufferCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeUploadBufferCommandInput = DescribeUploadBufferInput; export type DescribeUploadBufferCommandOutput = DescribeUploadBufferOutput & __MetadataBearer; +/** + *

Returns information about the upload buffer of a gateway. This operation is supported + * for the stored volume, cached volume, and tape gateway types.

+ * + *

The response includes disk IDs that are configured as upload buffer space, and it + * includes the amount of upload buffer space allocated and used.

+ */ export class DescribeUploadBufferCommand extends $Command< DescribeUploadBufferCommandInput, DescribeUploadBufferCommandOutput, @@ -34,6 +41,9 @@ export class DescribeUploadBufferCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeVTLDevicesCommand.ts b/clients/client-storage-gateway/commands/DescribeVTLDevicesCommand.ts index e0a33891512eb..f6b7d43744b5f 100644 --- a/clients/client-storage-gateway/commands/DescribeVTLDevicesCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeVTLDevicesCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeVTLDevicesCommandInput = DescribeVTLDevicesInput; export type DescribeVTLDevicesCommandOutput = DescribeVTLDevicesOutput & __MetadataBearer; +/** + *

Returns a description of virtual tape library (VTL) devices for the specified tape + * gateway. In the response, AWS Storage Gateway returns VTL device information.

+ * + *

This operation is only supported in the tape gateway type.

+ */ export class DescribeVTLDevicesCommand extends $Command< DescribeVTLDevicesCommandInput, DescribeVTLDevicesCommandOutput, @@ -34,6 +40,9 @@ export class DescribeVTLDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DescribeWorkingStorageCommand.ts b/clients/client-storage-gateway/commands/DescribeWorkingStorageCommand.ts index bb231686ac42c..81279d1c373c3 100644 --- a/clients/client-storage-gateway/commands/DescribeWorkingStorageCommand.ts +++ b/clients/client-storage-gateway/commands/DescribeWorkingStorageCommand.ts @@ -20,6 +20,19 @@ import { export type DescribeWorkingStorageCommandInput = DescribeWorkingStorageInput; export type DescribeWorkingStorageCommandOutput = DescribeWorkingStorageOutput & __MetadataBearer; +/** + *

Returns information about the working storage of a gateway. This operation is only + * supported in the stored volumes gateway type. This operation is deprecated in cached + * volumes API version (20120630). Use DescribeUploadBuffer instead.

+ * + * + *

Working storage is also referred to as upload buffer. You can also use the + * DescribeUploadBuffer operation to add upload buffer to a stored volume gateway.

+ *
+ * + *

The response includes disk IDs that are configured as working storage, and it includes + * the amount of working storage allocated and used.

+ */ export class DescribeWorkingStorageCommand extends $Command< DescribeWorkingStorageCommandInput, DescribeWorkingStorageCommandOutput, @@ -34,6 +47,9 @@ export class DescribeWorkingStorageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DetachVolumeCommand.ts b/clients/client-storage-gateway/commands/DetachVolumeCommand.ts index 533d58bb64a5b..d47e61ce7fc9c 100644 --- a/clients/client-storage-gateway/commands/DetachVolumeCommand.ts +++ b/clients/client-storage-gateway/commands/DetachVolumeCommand.ts @@ -20,6 +20,13 @@ import { export type DetachVolumeCommandInput = DetachVolumeInput; export type DetachVolumeCommandOutput = DetachVolumeOutput & __MetadataBearer; +/** + *

Disconnects a volume from an iSCSI connection and then detaches the volume from the + * specified gateway. Detaching and attaching a volume enables you to recover your data from + * one gateway to a different gateway without creating a snapshot. It also makes it easier to + * move your volumes from an on-premises gateway to a gateway hosted on an Amazon EC2 + * instance. This operation is only supported in the volume gateway type.

+ */ export class DetachVolumeCommand extends $Command< DetachVolumeCommandInput, DetachVolumeCommandOutput, @@ -34,6 +41,9 @@ export class DetachVolumeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/DisableGatewayCommand.ts b/clients/client-storage-gateway/commands/DisableGatewayCommand.ts index cde61071fb5db..37c716845f3b6 100644 --- a/clients/client-storage-gateway/commands/DisableGatewayCommand.ts +++ b/clients/client-storage-gateway/commands/DisableGatewayCommand.ts @@ -20,6 +20,17 @@ import { export type DisableGatewayCommandInput = DisableGatewayInput; export type DisableGatewayCommandOutput = DisableGatewayOutput & __MetadataBearer; +/** + *

Disables a tape gateway when the gateway is no longer functioning. For example, if your + * gateway VM is damaged, you can disable the gateway so you can recover virtual tapes.

+ * + *

Use this operation for a tape gateway that is not reachable or not functioning. This + * operation is only supported in the tape gateway type.

+ * + * + *

After a gateway is disabled, it cannot be enabled.

+ *
+ */ export class DisableGatewayCommand extends $Command< DisableGatewayCommandInput, DisableGatewayCommandOutput, @@ -34,6 +45,9 @@ export class DisableGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/JoinDomainCommand.ts b/clients/client-storage-gateway/commands/JoinDomainCommand.ts index a838d885ed344..ac767f1c33395 100644 --- a/clients/client-storage-gateway/commands/JoinDomainCommand.ts +++ b/clients/client-storage-gateway/commands/JoinDomainCommand.ts @@ -20,6 +20,10 @@ import { export type JoinDomainCommandInput = JoinDomainInput; export type JoinDomainCommandOutput = JoinDomainOutput & __MetadataBearer; +/** + *

Adds a file gateway to an Active Directory domain. This operation is only supported for + * file gateways that support the SMB file protocol.

+ */ export class JoinDomainCommand extends $Command< JoinDomainCommandInput, JoinDomainCommandOutput, @@ -34,6 +38,9 @@ export class JoinDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListAutomaticTapeCreationPoliciesCommand.ts b/clients/client-storage-gateway/commands/ListAutomaticTapeCreationPoliciesCommand.ts index 2c20ecb9f8be3..c7cca32e1e030 100644 --- a/clients/client-storage-gateway/commands/ListAutomaticTapeCreationPoliciesCommand.ts +++ b/clients/client-storage-gateway/commands/ListAutomaticTapeCreationPoliciesCommand.ts @@ -20,6 +20,12 @@ import { export type ListAutomaticTapeCreationPoliciesCommandInput = ListAutomaticTapeCreationPoliciesInput; export type ListAutomaticTapeCreationPoliciesCommandOutput = ListAutomaticTapeCreationPoliciesOutput & __MetadataBearer; +/** + *

Lists the automatic tape creation policies for a gateway. If there are no automatic tape + * creation policies for the gateway, it returns an empty list.

+ * + *

This operation is only supported for tape gateways.

+ */ export class ListAutomaticTapeCreationPoliciesCommand extends $Command< ListAutomaticTapeCreationPoliciesCommandInput, ListAutomaticTapeCreationPoliciesCommandOutput, @@ -34,6 +40,9 @@ export class ListAutomaticTapeCreationPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListFileSharesCommand.ts b/clients/client-storage-gateway/commands/ListFileSharesCommand.ts index 862e159199076..7888ad420a5ff 100644 --- a/clients/client-storage-gateway/commands/ListFileSharesCommand.ts +++ b/clients/client-storage-gateway/commands/ListFileSharesCommand.ts @@ -20,6 +20,11 @@ import { export type ListFileSharesCommandInput = ListFileSharesInput; export type ListFileSharesCommandOutput = ListFileSharesOutput & __MetadataBearer; +/** + *

Gets a list of the file shares for a specific file gateway, or the list of file shares + * that belong to the calling user account. This operation is only supported for file + * gateways.

+ */ export class ListFileSharesCommand extends $Command< ListFileSharesCommandInput, ListFileSharesCommandOutput, @@ -34,6 +39,9 @@ export class ListFileSharesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListGatewaysCommand.ts b/clients/client-storage-gateway/commands/ListGatewaysCommand.ts index 1a8b11208e7ce..c4d49a805a0ff 100644 --- a/clients/client-storage-gateway/commands/ListGatewaysCommand.ts +++ b/clients/client-storage-gateway/commands/ListGatewaysCommand.ts @@ -20,6 +20,18 @@ import { export type ListGatewaysCommandInput = ListGatewaysInput; export type ListGatewaysCommandOutput = ListGatewaysOutput & __MetadataBearer; +/** + *

Lists gateways owned by an AWS account in an AWS Region specified in the request. The + * returned list is ordered by gateway Amazon Resource Name (ARN).

+ * + *

By default, the operation returns a maximum of 100 gateways. This operation supports + * pagination that allows you to optionally reduce the number of gateways returned in a + * response.

+ * + *

If you have more gateways than are returned in a response (that is, the response returns + * only a truncated list of your gateways), the response contains a marker that you can + * specify in your next request to fetch the next page of gateways.

+ */ export class ListGatewaysCommand extends $Command< ListGatewaysCommandInput, ListGatewaysCommandOutput, @@ -34,6 +46,9 @@ export class ListGatewaysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListLocalDisksCommand.ts b/clients/client-storage-gateway/commands/ListLocalDisksCommand.ts index 883dc3fedde94..66436f56085b4 100644 --- a/clients/client-storage-gateway/commands/ListLocalDisksCommand.ts +++ b/clients/client-storage-gateway/commands/ListLocalDisksCommand.ts @@ -20,6 +20,17 @@ import { export type ListLocalDisksCommandInput = ListLocalDisksInput; export type ListLocalDisksCommandOutput = ListLocalDisksOutput & __MetadataBearer; +/** + *

Returns a list of the gateway's local disks. To specify which gateway to describe, + * you use the Amazon Resource Name (ARN) of the gateway in the body of the request.

+ * + *

The request returns a list of all disks, specifying which are configured as working + * storage, cache storage, or stored volume or not configured at all. The response includes a + * DiskStatus field. This field can have a value of present (the disk is + * available to use), missing (the disk is no longer connected to the gateway), or mismatch + * (the disk node is occupied by a disk that has incorrect metadata or the disk content is + * corrupted).

+ */ export class ListLocalDisksCommand extends $Command< ListLocalDisksCommandInput, ListLocalDisksCommandOutput, @@ -34,6 +45,9 @@ export class ListLocalDisksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListTagsForResourceCommand.ts b/clients/client-storage-gateway/commands/ListTagsForResourceCommand.ts index 6aa6c51dfb8d8..fceebbc4c3dac 100644 --- a/clients/client-storage-gateway/commands/ListTagsForResourceCommand.ts +++ b/clients/client-storage-gateway/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

Lists the tags that have been added to the specified resource. This operation is + * supported in storage gateways of all types.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListTapePoolsCommand.ts b/clients/client-storage-gateway/commands/ListTapePoolsCommand.ts index 2ac57dcf58726..d8487c906e937 100644 --- a/clients/client-storage-gateway/commands/ListTapePoolsCommand.ts +++ b/clients/client-storage-gateway/commands/ListTapePoolsCommand.ts @@ -20,6 +20,17 @@ import { export type ListTapePoolsCommandInput = ListTapePoolsInput; export type ListTapePoolsCommandOutput = ListTapePoolsOutput & __MetadataBearer; +/** + *

Lists custom tape pools. You specify custom tape pools to list by specifying one or more + * custom tape pool Amazon Resource Names (ARNs). If you don't specify a custom tape pool ARN, + * the operation lists all custom tape pools.

+ * + *

This operation supports pagination. You can optionally specify the Limit + * parameter in the body to limit the number of tape pools in the response. If the number of + * tape pools returned in the response is truncated, the response includes a + * Marker element that you can use in your subsequent request to retrieve the + * next set of tape pools.

+ */ export class ListTapePoolsCommand extends $Command< ListTapePoolsCommandInput, ListTapePoolsCommandOutput, @@ -34,6 +45,9 @@ export class ListTapePoolsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListTapesCommand.ts b/clients/client-storage-gateway/commands/ListTapesCommand.ts index e976aede951d1..0eacd5f1535a4 100644 --- a/clients/client-storage-gateway/commands/ListTapesCommand.ts +++ b/clients/client-storage-gateway/commands/ListTapesCommand.ts @@ -17,6 +17,19 @@ import { export type ListTapesCommandInput = ListTapesInput; export type ListTapesCommandOutput = ListTapesOutput & __MetadataBearer; +/** + *

Lists virtual tapes in your virtual tape library (VTL) and your virtual tape shelf + * (VTS). You specify the tapes to list by specifying one or more tape Amazon Resource Names + * (ARNs). If you don't specify a tape ARN, the operation lists all virtual tapes in both + * your VTL and VTS.

+ * + *

This operation supports pagination. By default, the operation returns a maximum of up to + * 100 tapes. You can optionally specify the Limit parameter in the body to limit + * the number of tapes in the response. If the number of tapes returned in the response is + * truncated, the response includes a Marker element that you can use in your + * subsequent request to retrieve the next set of tapes. This operation is only supported in + * the tape gateway type.

+ */ export class ListTapesCommand extends $Command< ListTapesCommandInput, ListTapesCommandOutput, @@ -31,6 +44,9 @@ export class ListTapesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListVolumeInitiatorsCommand.ts b/clients/client-storage-gateway/commands/ListVolumeInitiatorsCommand.ts index 3be45c2a20a97..c3b24d64c3be9 100644 --- a/clients/client-storage-gateway/commands/ListVolumeInitiatorsCommand.ts +++ b/clients/client-storage-gateway/commands/ListVolumeInitiatorsCommand.ts @@ -20,6 +20,11 @@ import { export type ListVolumeInitiatorsCommandInput = ListVolumeInitiatorsInput; export type ListVolumeInitiatorsCommandOutput = ListVolumeInitiatorsOutput & __MetadataBearer; +/** + *

Lists iSCSI initiators that are connected to a volume. You can use this operation to + * determine whether a volume is being used or not. This operation is only supported in the + * cached volume and stored volume gateway types.

+ */ export class ListVolumeInitiatorsCommand extends $Command< ListVolumeInitiatorsCommandInput, ListVolumeInitiatorsCommandOutput, @@ -34,6 +39,9 @@ export class ListVolumeInitiatorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListVolumeRecoveryPointsCommand.ts b/clients/client-storage-gateway/commands/ListVolumeRecoveryPointsCommand.ts index 0821be46ec89e..8bf0fff4bf874 100644 --- a/clients/client-storage-gateway/commands/ListVolumeRecoveryPointsCommand.ts +++ b/clients/client-storage-gateway/commands/ListVolumeRecoveryPointsCommand.ts @@ -20,6 +20,15 @@ import { export type ListVolumeRecoveryPointsCommandInput = ListVolumeRecoveryPointsInput; export type ListVolumeRecoveryPointsCommandOutput = ListVolumeRecoveryPointsOutput & __MetadataBearer; +/** + *

Lists the recovery points for a specified gateway. This operation is only supported in + * the cached volume gateway type.

+ * + *

Each cache volume has one recovery point. A volume recovery point is a point in time at + * which all data of the volume is consistent and from which you can create a snapshot or + * clone a new cached volume from a source volume. To create a snapshot from a volume recovery + * point use the CreateSnapshotFromVolumeRecoveryPoint operation.

+ */ export class ListVolumeRecoveryPointsCommand extends $Command< ListVolumeRecoveryPointsCommandInput, ListVolumeRecoveryPointsCommandOutput, @@ -34,6 +43,9 @@ export class ListVolumeRecoveryPointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ListVolumesCommand.ts b/clients/client-storage-gateway/commands/ListVolumesCommand.ts index 08e1c6364d152..730a6a449ab43 100644 --- a/clients/client-storage-gateway/commands/ListVolumesCommand.ts +++ b/clients/client-storage-gateway/commands/ListVolumesCommand.ts @@ -20,6 +20,18 @@ import { export type ListVolumesCommandInput = ListVolumesInput; export type ListVolumesCommandOutput = ListVolumesOutput & __MetadataBearer; +/** + *

Lists the iSCSI stored volumes of a gateway. Results are sorted by volume ARN. The + * response includes only the volume ARNs. If you want additional volume information, use the + * DescribeStorediSCSIVolumes or the DescribeCachediSCSIVolumes API.

+ * + *

The operation supports pagination. By default, the operation returns a maximum of up to + * 100 volumes. You can optionally specify the Limit field in the body to limit + * the number of volumes in the response. If the number of volumes returned in the response is + * truncated, the response includes a Marker field. You can use this Marker value in your + * subsequent request to retrieve the next set of volumes. This operation is only supported in + * the cached volume and stored volume gateway types.

+ */ export class ListVolumesCommand extends $Command< ListVolumesCommandInput, ListVolumesCommandOutput, @@ -34,6 +46,9 @@ export class ListVolumesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/NotifyWhenUploadedCommand.ts b/clients/client-storage-gateway/commands/NotifyWhenUploadedCommand.ts index 9a93d27a68d81..cb6c77af98d6a 100644 --- a/clients/client-storage-gateway/commands/NotifyWhenUploadedCommand.ts +++ b/clients/client-storage-gateway/commands/NotifyWhenUploadedCommand.ts @@ -20,6 +20,23 @@ import { export type NotifyWhenUploadedCommandInput = NotifyWhenUploadedInput; export type NotifyWhenUploadedCommandOutput = NotifyWhenUploadedOutput & __MetadataBearer; +/** + *

Sends you notification through CloudWatch Events when all files written to your file + * share have been uploaded to Amazon S3.

+ * + *

AWS Storage Gateway can send a notification through Amazon CloudWatch Events when all + * files written to your file share up to that point in time have been uploaded to Amazon S3. + * These files include files written to the file share up to the time that you make a request + * for notification. When the upload is done, Storage Gateway sends you notification through + * an Amazon CloudWatch Event. You can configure CloudWatch Events to send the notification + * through event targets such as Amazon SNS or AWS Lambda function. This operation is only + * supported for file gateways.

+ * + * + * + *

For more information, see Getting file upload notification in the AWS Storage Gateway User + * Guide.

+ */ export class NotifyWhenUploadedCommand extends $Command< NotifyWhenUploadedCommandInput, NotifyWhenUploadedCommandOutput, @@ -34,6 +51,9 @@ export class NotifyWhenUploadedCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/RefreshCacheCommand.ts b/clients/client-storage-gateway/commands/RefreshCacheCommand.ts index e2b4b58236f74..04dc3c5dab8ac 100644 --- a/clients/client-storage-gateway/commands/RefreshCacheCommand.ts +++ b/clients/client-storage-gateway/commands/RefreshCacheCommand.ts @@ -20,6 +20,35 @@ import { export type RefreshCacheCommandInput = RefreshCacheInput; export type RefreshCacheCommandOutput = RefreshCacheOutput & __MetadataBearer; +/** + *

Refreshes the cache for the specified file share. This operation finds objects in the + * Amazon S3 bucket that were added, removed, or replaced since the gateway last listed the + * bucket's contents and cached the results. This operation is only supported in the file + * gateway type. You can subscribe to be notified through an Amazon CloudWatch event when your + * RefreshCache operation completes. For more information, see Getting notified about file operations in the AWS Storage Gateway + * User Guide.

+ * + *

When this API is called, it only initiates the refresh operation. When the API call + * completes and returns a success code, it doesn't necessarily mean that the file + * refresh has completed. You should use the refresh-complete notification to determine that + * the operation has completed before you check for new files on the gateway file share. You + * can subscribe to be notified through an CloudWatch event when your + * RefreshCache operation completes.

+ * + *

Throttle limit: This API is asynchronous so the gateway will accept no more than two + * refreshes at any time. We recommend using the refresh-complete CloudWatch event + * notification before issuing additional requests. For more information, see Getting notified about file operations in the AWS Storage Gateway + * User Guide.

+ * + *

If you invoke the RefreshCache API when two requests are already being processed, any + * new request will cause an InvalidGatewayRequestException error because too + * many requests were sent to the server.

+ * + * + * + *

For more information, see Getting notified about file operations in the AWS Storage Gateway + * User Guide.

+ */ export class RefreshCacheCommand extends $Command< RefreshCacheCommandInput, RefreshCacheCommandOutput, @@ -34,6 +63,9 @@ export class RefreshCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/RemoveTagsFromResourceCommand.ts b/clients/client-storage-gateway/commands/RemoveTagsFromResourceCommand.ts index 3b60954e08973..caa76b12bf3a6 100644 --- a/clients/client-storage-gateway/commands/RemoveTagsFromResourceCommand.ts +++ b/clients/client-storage-gateway/commands/RemoveTagsFromResourceCommand.ts @@ -20,6 +20,10 @@ import { export type RemoveTagsFromResourceCommandInput = RemoveTagsFromResourceInput; export type RemoveTagsFromResourceCommandOutput = RemoveTagsFromResourceOutput & __MetadataBearer; +/** + *

Removes one or more tags from the specified resource. This operation is supported in + * storage gateways of all types.

+ */ export class RemoveTagsFromResourceCommand extends $Command< RemoveTagsFromResourceCommandInput, RemoveTagsFromResourceCommandOutput, @@ -34,6 +38,9 @@ export class RemoveTagsFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ResetCacheCommand.ts b/clients/client-storage-gateway/commands/ResetCacheCommand.ts index 874f36d58768e..8710cdb31a867 100644 --- a/clients/client-storage-gateway/commands/ResetCacheCommand.ts +++ b/clients/client-storage-gateway/commands/ResetCacheCommand.ts @@ -20,6 +20,21 @@ import { export type ResetCacheCommandInput = ResetCacheInput; export type ResetCacheCommandOutput = ResetCacheOutput & __MetadataBearer; +/** + *

Resets all cache disks that have encountered an error and makes the disks available for + * reconfiguration as cache storage. If your cache disk encounters an error, the gateway + * prevents read and write operations on virtual tapes in the gateway. For example, an error + * can occur when a disk is corrupted or removed from the gateway. When a cache is reset, the + * gateway loses its cache storage. At this point, you can reconfigure the disks as cache + * disks. This operation is only supported in the cached volume and tape types.

+ * + * + *

If the cache disk you are resetting contains data that has not been uploaded to + * Amazon S3 yet, that data can be lost. After you reset cache disks, there will be no + * configured cache disks left in the gateway, so you must configure at least one new cache + * disk for your gateway to function properly.

+ *
+ */ export class ResetCacheCommand extends $Command< ResetCacheCommandInput, ResetCacheCommandOutput, @@ -34,6 +49,9 @@ export class ResetCacheCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/RetrieveTapeArchiveCommand.ts b/clients/client-storage-gateway/commands/RetrieveTapeArchiveCommand.ts index e61c5843efd18..71aab2cd5a511 100644 --- a/clients/client-storage-gateway/commands/RetrieveTapeArchiveCommand.ts +++ b/clients/client-storage-gateway/commands/RetrieveTapeArchiveCommand.ts @@ -20,6 +20,16 @@ import { export type RetrieveTapeArchiveCommandInput = RetrieveTapeArchiveInput; export type RetrieveTapeArchiveCommandOutput = RetrieveTapeArchiveOutput & __MetadataBearer; +/** + *

Retrieves an archived virtual tape from the virtual tape shelf (VTS) to a tape gateway. + * Virtual tapes archived in the VTS are not associated with any gateway. However after a tape + * is retrieved, it is associated with a gateway, even though it is also listed in the VTS, + * that is, archive. This operation is only supported in the tape gateway type.

+ * + *

Once a tape is successfully retrieved to a gateway, it cannot be retrieved again to + * another gateway. You must archive the tape again before you can retrieve it to another + * gateway. This operation is only supported in the tape gateway type.

+ */ export class RetrieveTapeArchiveCommand extends $Command< RetrieveTapeArchiveCommandInput, RetrieveTapeArchiveCommandOutput, @@ -34,6 +44,9 @@ export class RetrieveTapeArchiveCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/RetrieveTapeRecoveryPointCommand.ts b/clients/client-storage-gateway/commands/RetrieveTapeRecoveryPointCommand.ts index 693d836d05652..1753654f8d383 100644 --- a/clients/client-storage-gateway/commands/RetrieveTapeRecoveryPointCommand.ts +++ b/clients/client-storage-gateway/commands/RetrieveTapeRecoveryPointCommand.ts @@ -20,6 +20,20 @@ import { export type RetrieveTapeRecoveryPointCommandInput = RetrieveTapeRecoveryPointInput; export type RetrieveTapeRecoveryPointCommandOutput = RetrieveTapeRecoveryPointOutput & __MetadataBearer; +/** + *

Retrieves the recovery point for the specified virtual tape. This operation is only + * supported in the tape gateway type.

+ * + *

A recovery point is a point in time view of a virtual tape at which all the data on the + * tape is consistent. If your gateway crashes, virtual tapes that have recovery points can be + * recovered to a new gateway.

+ * + * + *

The virtual tape can be retrieved to only one gateway. The retrieved tape is + * read-only. The virtual tape can be retrieved to only a tape gateway. There is no charge + * for retrieving recovery points.

+ *
+ */ export class RetrieveTapeRecoveryPointCommand extends $Command< RetrieveTapeRecoveryPointCommandInput, RetrieveTapeRecoveryPointCommandOutput, @@ -34,6 +48,9 @@ export class RetrieveTapeRecoveryPointCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/SetLocalConsolePasswordCommand.ts b/clients/client-storage-gateway/commands/SetLocalConsolePasswordCommand.ts index 3ada3a09ae2b5..08e427a1842da 100644 --- a/clients/client-storage-gateway/commands/SetLocalConsolePasswordCommand.ts +++ b/clients/client-storage-gateway/commands/SetLocalConsolePasswordCommand.ts @@ -20,6 +20,12 @@ import { export type SetLocalConsolePasswordCommandInput = SetLocalConsolePasswordInput; export type SetLocalConsolePasswordCommandOutput = SetLocalConsolePasswordOutput & __MetadataBearer; +/** + *

Sets the password for your VM local console. When you log in to the local console for + * the first time, you log in to the VM with the default credentials. We recommend that you + * set a new password. You don't need to know the default password to set a new + * password.

+ */ export class SetLocalConsolePasswordCommand extends $Command< SetLocalConsolePasswordCommandInput, SetLocalConsolePasswordCommandOutput, @@ -34,6 +40,9 @@ export class SetLocalConsolePasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/SetSMBGuestPasswordCommand.ts b/clients/client-storage-gateway/commands/SetSMBGuestPasswordCommand.ts index e6fc6902be69d..583d3499b26f0 100644 --- a/clients/client-storage-gateway/commands/SetSMBGuestPasswordCommand.ts +++ b/clients/client-storage-gateway/commands/SetSMBGuestPasswordCommand.ts @@ -20,6 +20,11 @@ import { export type SetSMBGuestPasswordCommandInput = SetSMBGuestPasswordInput; export type SetSMBGuestPasswordCommandOutput = SetSMBGuestPasswordOutput & __MetadataBearer; +/** + *

Sets the password for the guest user smbguest. The smbguest + * user is the user when the authentication method for the file share is set to + * GuestAccess.

+ */ export class SetSMBGuestPasswordCommand extends $Command< SetSMBGuestPasswordCommandInput, SetSMBGuestPasswordCommandOutput, @@ -34,6 +39,9 @@ export class SetSMBGuestPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/ShutdownGatewayCommand.ts b/clients/client-storage-gateway/commands/ShutdownGatewayCommand.ts index b7311a1433dbc..f1b64535f36df 100644 --- a/clients/client-storage-gateway/commands/ShutdownGatewayCommand.ts +++ b/clients/client-storage-gateway/commands/ShutdownGatewayCommand.ts @@ -20,6 +20,32 @@ import { export type ShutdownGatewayCommandInput = ShutdownGatewayInput; export type ShutdownGatewayCommandOutput = ShutdownGatewayOutput & __MetadataBearer; +/** + *

Shuts down a gateway. To specify which gateway to shut down, use the Amazon Resource + * Name (ARN) of the gateway in the body of your request.

+ * + *

The operation shuts down the gateway service component running in the gateway's + * virtual machine (VM) and not the host VM.

+ * + * + *

If you want to shut down the VM, it is recommended that you first shut down the + * gateway component in the VM to avoid unpredictable conditions.

+ *
+ * + *

After the gateway is shutdown, you cannot call any other API except StartGateway, DescribeGatewayInformation, and ListGateways. For more information, see ActivateGateway. + * Your applications cannot read from or write to the gateway's storage volumes, and + * there are no snapshots taken.

+ * + * + *

When you make a shutdown request, you will get a 200 OK success response + * immediately. However, it might take some time for the gateway to shut down. You can call + * the DescribeGatewayInformation API to check the status. For more + * information, see ActivateGateway.

+ *
+ * + *

If do not intend to use the gateway again, you must delete the gateway (using DeleteGateway) to no longer pay software charges associated with the + * gateway.

+ */ export class ShutdownGatewayCommand extends $Command< ShutdownGatewayCommandInput, ShutdownGatewayCommandOutput, @@ -34,6 +60,9 @@ export class ShutdownGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/StartAvailabilityMonitorTestCommand.ts b/clients/client-storage-gateway/commands/StartAvailabilityMonitorTestCommand.ts index f9d9df4e366ad..b3e7c8879cc26 100644 --- a/clients/client-storage-gateway/commands/StartAvailabilityMonitorTestCommand.ts +++ b/clients/client-storage-gateway/commands/StartAvailabilityMonitorTestCommand.ts @@ -20,6 +20,16 @@ import { export type StartAvailabilityMonitorTestCommandInput = StartAvailabilityMonitorTestInput; export type StartAvailabilityMonitorTestCommandOutput = StartAvailabilityMonitorTestOutput & __MetadataBearer; +/** + *

Start a test that verifies that the specified gateway is configured for High + * Availability monitoring in your host environment. This request only initiates the test and + * that a successful response only indicates that the test was started. It doesn't + * indicate that the test passed. For the status of the test, invoke the + * DescribeAvailabilityMonitorTest API.

+ * + *

Starting this test will cause your gateway to go offline for a brief period.

+ *
+ */ export class StartAvailabilityMonitorTestCommand extends $Command< StartAvailabilityMonitorTestCommandInput, StartAvailabilityMonitorTestCommandOutput, @@ -34,6 +44,9 @@ export class StartAvailabilityMonitorTestCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/StartGatewayCommand.ts b/clients/client-storage-gateway/commands/StartGatewayCommand.ts index c354540d0676c..e702447164958 100644 --- a/clients/client-storage-gateway/commands/StartGatewayCommand.ts +++ b/clients/client-storage-gateway/commands/StartGatewayCommand.ts @@ -20,6 +20,21 @@ import { export type StartGatewayCommandInput = StartGatewayInput; export type StartGatewayCommandOutput = StartGatewayOutput & __MetadataBearer; +/** + *

Starts a gateway that you previously shut down (see ShutdownGateway). + * After the gateway starts, you can then make other API calls, your applications can read + * from or write to the gateway's storage volumes and you will be able to take snapshot + * backups.

+ * + * + *

When you make a request, you will get a 200 OK success response immediately. However, + * it might take some time for the gateway to be ready. You should call DescribeGatewayInformation and check the status before making any + * additional API calls. For more information, see ActivateGateway.

+ *
+ * + *

To specify which gateway to start, use the Amazon Resource Name (ARN) of the gateway in + * your request.

+ */ export class StartGatewayCommand extends $Command< StartGatewayCommandInput, StartGatewayCommandOutput, @@ -34,6 +49,9 @@ export class StartGatewayCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateAutomaticTapeCreationPolicyCommand.ts b/clients/client-storage-gateway/commands/UpdateAutomaticTapeCreationPolicyCommand.ts index 9aac337642d9d..071ae70bcd550 100644 --- a/clients/client-storage-gateway/commands/UpdateAutomaticTapeCreationPolicyCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateAutomaticTapeCreationPolicyCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateAutomaticTapeCreationPolicyCommandInput = UpdateAutomaticTapeCreationPolicyInput; export type UpdateAutomaticTapeCreationPolicyCommandOutput = UpdateAutomaticTapeCreationPolicyOutput & __MetadataBearer; +/** + *

Updates the automatic tape creation policy of a gateway. Use this to update the policy + * with a new set of automatic tape creation rules. This is only supported for tape + * gateways.

+ * + *

By default, there is no automatic tape creation policy.

+ * + * + *

A gateway can have only one automatic tape creation policy.

+ *
+ */ export class UpdateAutomaticTapeCreationPolicyCommand extends $Command< UpdateAutomaticTapeCreationPolicyCommandInput, UpdateAutomaticTapeCreationPolicyCommandOutput, @@ -34,6 +45,9 @@ export class UpdateAutomaticTapeCreationPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateBandwidthRateLimitCommand.ts b/clients/client-storage-gateway/commands/UpdateBandwidthRateLimitCommand.ts index 635c88983288c..f3a6709170400 100644 --- a/clients/client-storage-gateway/commands/UpdateBandwidthRateLimitCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateBandwidthRateLimitCommand.ts @@ -20,6 +20,19 @@ import { export type UpdateBandwidthRateLimitCommandInput = UpdateBandwidthRateLimitInput; export type UpdateBandwidthRateLimitCommandOutput = UpdateBandwidthRateLimitOutput & __MetadataBearer; +/** + *

Updates the bandwidth rate limits of a gateway. You can update both the upload and + * download bandwidth rate limit or specify only one of the two. If you don't set a + * bandwidth rate limit, the existing rate limit remains. This operation is supported for the + * stored volume, cached volume, and tape gateway types.

+ * + *

By default, a gateway's bandwidth rate limits are not set. If you don't set + * any limit, the gateway does not have any limitations on its bandwidth usage and could + * potentially use the maximum available bandwidth.

+ * + *

To specify which gateway to update, use the Amazon Resource Name (ARN) of the gateway in + * your request.

+ */ export class UpdateBandwidthRateLimitCommand extends $Command< UpdateBandwidthRateLimitCommandInput, UpdateBandwidthRateLimitCommandOutput, @@ -34,6 +47,9 @@ export class UpdateBandwidthRateLimitCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateBandwidthRateLimitScheduleCommand.ts b/clients/client-storage-gateway/commands/UpdateBandwidthRateLimitScheduleCommand.ts index 0b349b8646ad2..56b2bb0140e79 100644 --- a/clients/client-storage-gateway/commands/UpdateBandwidthRateLimitScheduleCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateBandwidthRateLimitScheduleCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateBandwidthRateLimitScheduleCommandInput = UpdateBandwidthRateLimitScheduleInput; export type UpdateBandwidthRateLimitScheduleCommandOutput = UpdateBandwidthRateLimitScheduleOutput & __MetadataBearer; +/** + *

+ * Updates the bandwidth rate limit schedule for a specified gateway. By default, gateways do + * not have bandwidth rate limit schedules, which means no bandwidth rate limiting is in effect. + * Use this to initiate or update a gateway's bandwidth rate limit schedule. + * This operation is supported in the volume and tape gateway types. + *

+ */ export class UpdateBandwidthRateLimitScheduleCommand extends $Command< UpdateBandwidthRateLimitScheduleCommandInput, UpdateBandwidthRateLimitScheduleCommandOutput, @@ -34,6 +42,9 @@ export class UpdateBandwidthRateLimitScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateChapCredentialsCommand.ts b/clients/client-storage-gateway/commands/UpdateChapCredentialsCommand.ts index 40c9c9aee1ab0..fc1e01b4d1189 100644 --- a/clients/client-storage-gateway/commands/UpdateChapCredentialsCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateChapCredentialsCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateChapCredentialsCommandInput = UpdateChapCredentialsInput; export type UpdateChapCredentialsCommandOutput = UpdateChapCredentialsOutput & __MetadataBearer; +/** + *

Updates the Challenge-Handshake Authentication Protocol (CHAP) credentials for a + * specified iSCSI target. By default, a gateway does not have CHAP enabled; however, for + * added security, you might use it. This operation is supported in the volume and tape + * gateway types.

+ * + * + *

When you update CHAP credentials, all existing connections on the target are closed + * and initiators must reconnect with the new credentials.

+ *
+ */ export class UpdateChapCredentialsCommand extends $Command< UpdateChapCredentialsCommandInput, UpdateChapCredentialsCommandOutput, @@ -34,6 +45,9 @@ export class UpdateChapCredentialsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateGatewayInformationCommand.ts b/clients/client-storage-gateway/commands/UpdateGatewayInformationCommand.ts index db8a892c3905f..fc281e1bef642 100644 --- a/clients/client-storage-gateway/commands/UpdateGatewayInformationCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateGatewayInformationCommand.ts @@ -20,6 +20,17 @@ import { export type UpdateGatewayInformationCommandInput = UpdateGatewayInformationInput; export type UpdateGatewayInformationCommandOutput = UpdateGatewayInformationOutput & __MetadataBearer; +/** + *

Updates a gateway's metadata, which includes the gateway's name and time zone. + * To specify which gateway to update, use the Amazon Resource Name (ARN) of the gateway in + * your request.

+ * + * + *

For gateways activated after September 2, 2015, the gateway's ARN contains the + * gateway ID rather than the gateway name. However, changing the name of the gateway has + * no effect on the gateway's ARN.

+ *
+ */ export class UpdateGatewayInformationCommand extends $Command< UpdateGatewayInformationCommandInput, UpdateGatewayInformationCommandOutput, @@ -34,6 +45,9 @@ export class UpdateGatewayInformationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateGatewaySoftwareNowCommand.ts b/clients/client-storage-gateway/commands/UpdateGatewaySoftwareNowCommand.ts index 2fd79168a487a..629a63b79cda9 100644 --- a/clients/client-storage-gateway/commands/UpdateGatewaySoftwareNowCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateGatewaySoftwareNowCommand.ts @@ -20,6 +20,24 @@ import { export type UpdateGatewaySoftwareNowCommandInput = UpdateGatewaySoftwareNowInput; export type UpdateGatewaySoftwareNowCommandOutput = UpdateGatewaySoftwareNowOutput & __MetadataBearer; +/** + *

Updates the gateway virtual machine (VM) software. The request immediately triggers the + * software update.

+ * + * + *

When you make this request, you get a 200 OK success response + * immediately. However, it might take some time for the update to complete. You can call + * DescribeGatewayInformation to verify the gateway is in the + * STATE_RUNNING state.

+ *
+ * + * + *

A software update forces a system restart of your gateway. You can minimize the + * chance of any disruption to your applications by increasing your iSCSI Initiators' + * timeouts. For more information about increasing iSCSI Initiator timeouts for Windows and + * Linux, see Customizing your Windows iSCSI settings and Customizing your Linux iSCSI settings, respectively.

+ *
+ */ export class UpdateGatewaySoftwareNowCommand extends $Command< UpdateGatewaySoftwareNowCommandInput, UpdateGatewaySoftwareNowCommandOutput, @@ -34,6 +52,9 @@ export class UpdateGatewaySoftwareNowCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateMaintenanceStartTimeCommand.ts b/clients/client-storage-gateway/commands/UpdateMaintenanceStartTimeCommand.ts index e3ca944727af0..f1369a6c6257b 100644 --- a/clients/client-storage-gateway/commands/UpdateMaintenanceStartTimeCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateMaintenanceStartTimeCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateMaintenanceStartTimeCommandInput = UpdateMaintenanceStartTimeInput; export type UpdateMaintenanceStartTimeCommandOutput = UpdateMaintenanceStartTimeOutput & __MetadataBearer; +/** + *

Updates a gateway's weekly maintenance start time information, including day and + * time of the week. The maintenance time is the time in your gateway's time zone.

+ */ export class UpdateMaintenanceStartTimeCommand extends $Command< UpdateMaintenanceStartTimeCommandInput, UpdateMaintenanceStartTimeCommandOutput, @@ -34,6 +38,9 @@ export class UpdateMaintenanceStartTimeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateNFSFileShareCommand.ts b/clients/client-storage-gateway/commands/UpdateNFSFileShareCommand.ts index 6f64c0f60465a..6c48c40bd67fb 100644 --- a/clients/client-storage-gateway/commands/UpdateNFSFileShareCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateNFSFileShareCommand.ts @@ -20,6 +20,35 @@ import { export type UpdateNFSFileShareCommandInput = UpdateNFSFileShareInput; export type UpdateNFSFileShareCommandOutput = UpdateNFSFileShareOutput & __MetadataBearer; +/** + *

Updates a Network File System (NFS) file share. This operation is only supported in the + * file gateway type.

+ * + * + *

To leave a file share field unchanged, set the corresponding input field to + * null.

+ *
+ * + *

Updates the following file share settings:

+ * + *
    + *
  • + *

    Default storage class for your S3 bucket

    + *
  • + *
  • + *

    Metadata defaults for your S3 bucket

    + *
  • + *
  • + *

    Allowed NFS clients for your file share

    + *
  • + *
  • + *

    Squash settings

    + *
  • + *
  • + *

    Write status of your file share

    + *
  • + *
+ */ export class UpdateNFSFileShareCommand extends $Command< UpdateNFSFileShareCommandInput, UpdateNFSFileShareCommandOutput, @@ -34,6 +63,9 @@ export class UpdateNFSFileShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateSMBFileShareCommand.ts b/clients/client-storage-gateway/commands/UpdateSMBFileShareCommand.ts index 5d02088d5ba5d..911ab78030a04 100644 --- a/clients/client-storage-gateway/commands/UpdateSMBFileShareCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateSMBFileShareCommand.ts @@ -20,6 +20,27 @@ import { export type UpdateSMBFileShareCommandInput = UpdateSMBFileShareInput; export type UpdateSMBFileShareCommandOutput = UpdateSMBFileShareOutput & __MetadataBearer; +/** + *

Updates a Server Message Block (SMB) file share. This operation is only supported for + * file gateways.

+ * + * + *

To leave a file share field unchanged, set the corresponding input field to + * null.

+ *
+ * + * + *

File gateways require AWS Security Token Service (AWS STS) to be activated to enable + * you to create a file share. Make sure that AWS STS is activated in the AWS Region you + * are creating your file gateway in. If AWS STS is not activated in this AWS Region, + * activate it. For information about how to activate AWS STS, see Activating and + * deactivating AWS STS in an AWS Region in the AWS Identity and + * Access Management User Guide.

+ * + *

File gateways don't support creating hard or symbolic links on a file + * share.

+ *
+ */ export class UpdateSMBFileShareCommand extends $Command< UpdateSMBFileShareCommandInput, UpdateSMBFileShareCommandOutput, @@ -34,6 +55,9 @@ export class UpdateSMBFileShareCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateSMBFileShareVisibilityCommand.ts b/clients/client-storage-gateway/commands/UpdateSMBFileShareVisibilityCommand.ts index 6003d2b331309..53e4f19a9fb43 100644 --- a/clients/client-storage-gateway/commands/UpdateSMBFileShareVisibilityCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateSMBFileShareVisibilityCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateSMBFileShareVisibilityCommandInput = UpdateSMBFileShareVisibilityInput; export type UpdateSMBFileShareVisibilityCommandOutput = UpdateSMBFileShareVisibilityOutput & __MetadataBearer; +/** + *

Controls whether the shares on a gateway are visible in a net view or browse + * list.

+ */ export class UpdateSMBFileShareVisibilityCommand extends $Command< UpdateSMBFileShareVisibilityCommandInput, UpdateSMBFileShareVisibilityCommandOutput, @@ -34,6 +38,9 @@ export class UpdateSMBFileShareVisibilityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateSMBSecurityStrategyCommand.ts b/clients/client-storage-gateway/commands/UpdateSMBSecurityStrategyCommand.ts index 09338b1f08459..606164fba5445 100644 --- a/clients/client-storage-gateway/commands/UpdateSMBSecurityStrategyCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateSMBSecurityStrategyCommand.ts @@ -20,6 +20,16 @@ import { export type UpdateSMBSecurityStrategyCommandInput = UpdateSMBSecurityStrategyInput; export type UpdateSMBSecurityStrategyCommandOutput = UpdateSMBSecurityStrategyOutput & __MetadataBearer; +/** + *

Updates the SMB security strategy on a file gateway. This action is only supported in + * file gateways.

+ * + * + *

This API is called Security level in the User Guide.

+ * + *

A higher security level can affect performance of the gateway.

+ *
+ */ export class UpdateSMBSecurityStrategyCommand extends $Command< UpdateSMBSecurityStrategyCommandInput, UpdateSMBSecurityStrategyCommandOutput, @@ -34,6 +44,9 @@ export class UpdateSMBSecurityStrategyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateSnapshotScheduleCommand.ts b/clients/client-storage-gateway/commands/UpdateSnapshotScheduleCommand.ts index d295db3941df6..3eec3d787dc31 100644 --- a/clients/client-storage-gateway/commands/UpdateSnapshotScheduleCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateSnapshotScheduleCommand.ts @@ -20,6 +20,18 @@ import { export type UpdateSnapshotScheduleCommandInput = UpdateSnapshotScheduleInput; export type UpdateSnapshotScheduleCommandOutput = UpdateSnapshotScheduleOutput & __MetadataBearer; +/** + *

Updates a snapshot schedule configured for a gateway volume. This operation is only + * supported in the cached volume and stored volume gateway types.

+ * + *

The default snapshot schedule for volume is once every 24 hours, starting at the + * creation time of the volume. You can use this API to change the snapshot schedule + * configured for the volume.

+ * + *

In the request you must identify the gateway volume whose snapshot schedule you want to + * update, and the schedule information, including when you want the snapshot to begin on a + * day and the frequency (in hours) of snapshots.

+ */ export class UpdateSnapshotScheduleCommand extends $Command< UpdateSnapshotScheduleCommandInput, UpdateSnapshotScheduleCommandOutput, @@ -34,6 +46,9 @@ export class UpdateSnapshotScheduleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/commands/UpdateVTLDeviceTypeCommand.ts b/clients/client-storage-gateway/commands/UpdateVTLDeviceTypeCommand.ts index c75115572509f..0ea7e9be76c88 100644 --- a/clients/client-storage-gateway/commands/UpdateVTLDeviceTypeCommand.ts +++ b/clients/client-storage-gateway/commands/UpdateVTLDeviceTypeCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateVTLDeviceTypeCommandInput = UpdateVTLDeviceTypeInput; export type UpdateVTLDeviceTypeCommandOutput = UpdateVTLDeviceTypeOutput & __MetadataBearer; +/** + *

Updates the type of medium changer in a tape gateway. When you activate a tape gateway, + * you select a medium changer type for the tape gateway. This operation enables you to select + * a different type of medium changer after a tape gateway is activated. This operation is + * only supported in the tape gateway type.

+ */ export class UpdateVTLDeviceTypeCommand extends $Command< UpdateVTLDeviceTypeCommandInput, UpdateVTLDeviceTypeCommandOutput, @@ -34,6 +40,9 @@ export class UpdateVTLDeviceTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: StorageGatewayClientResolvedConfig, diff --git a/clients/client-storage-gateway/package.json b/clients/client-storage-gateway/package.json index e15961510d8bb..4299e5dee3c56 100644 --- a/clients/client-storage-gateway/package.json +++ b/clients/client-storage-gateway/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Storage Gateway Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-storage-gateway/pagination/DescribeTapeArchivesPaginator.ts b/clients/client-storage-gateway/pagination/DescribeTapeArchivesPaginator.ts index 034533dd24d31..7a800cf6970ae 100644 --- a/clients/client-storage-gateway/pagination/DescribeTapeArchivesPaginator.ts +++ b/clients/client-storage-gateway/pagination/DescribeTapeArchivesPaginator.ts @@ -8,6 +8,9 @@ import { import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: DescribeTapeArchivesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTapeArchivesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: DescribeTapeArchivesCommandInput, diff --git a/clients/client-storage-gateway/pagination/DescribeTapeRecoveryPointsPaginator.ts b/clients/client-storage-gateway/pagination/DescribeTapeRecoveryPointsPaginator.ts index beda6b62deabc..a4388d9701c5b 100644 --- a/clients/client-storage-gateway/pagination/DescribeTapeRecoveryPointsPaginator.ts +++ b/clients/client-storage-gateway/pagination/DescribeTapeRecoveryPointsPaginator.ts @@ -8,6 +8,9 @@ import { import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: DescribeTapeRecoveryPointsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTapeRecoveryPointsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: DescribeTapeRecoveryPointsCommandInput, diff --git a/clients/client-storage-gateway/pagination/DescribeTapesPaginator.ts b/clients/client-storage-gateway/pagination/DescribeTapesPaginator.ts index 55679026845dd..73c0c0b79a015 100644 --- a/clients/client-storage-gateway/pagination/DescribeTapesPaginator.ts +++ b/clients/client-storage-gateway/pagination/DescribeTapesPaginator.ts @@ -8,6 +8,9 @@ import { import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: DescribeTapesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeTapesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: DescribeTapesCommandInput, diff --git a/clients/client-storage-gateway/pagination/DescribeVTLDevicesPaginator.ts b/clients/client-storage-gateway/pagination/DescribeVTLDevicesPaginator.ts index a424fde9afc58..52e0ae3aaa229 100644 --- a/clients/client-storage-gateway/pagination/DescribeVTLDevicesPaginator.ts +++ b/clients/client-storage-gateway/pagination/DescribeVTLDevicesPaginator.ts @@ -8,6 +8,9 @@ import { import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: DescribeVTLDevicesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeVTLDevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: DescribeVTLDevicesCommandInput, diff --git a/clients/client-storage-gateway/pagination/ListFileSharesPaginator.ts b/clients/client-storage-gateway/pagination/ListFileSharesPaginator.ts index 262dfdbbe70c4..cea732989e5d0 100644 --- a/clients/client-storage-gateway/pagination/ListFileSharesPaginator.ts +++ b/clients/client-storage-gateway/pagination/ListFileSharesPaginator.ts @@ -8,6 +8,9 @@ import { import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: ListFileSharesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFileSharesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: ListFileSharesCommandInput, diff --git a/clients/client-storage-gateway/pagination/ListGatewaysPaginator.ts b/clients/client-storage-gateway/pagination/ListGatewaysPaginator.ts index d276016047277..8dbad7fd61d99 100644 --- a/clients/client-storage-gateway/pagination/ListGatewaysPaginator.ts +++ b/clients/client-storage-gateway/pagination/ListGatewaysPaginator.ts @@ -8,6 +8,9 @@ import { import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: ListGatewaysCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGatewaysCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: ListGatewaysCommandInput, diff --git a/clients/client-storage-gateway/pagination/ListTagsForResourcePaginator.ts b/clients/client-storage-gateway/pagination/ListTagsForResourcePaginator.ts index 4ab8a9b261985..9a4e1058b7b2a 100644 --- a/clients/client-storage-gateway/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-storage-gateway/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: ListTagsForResourceCommandInput, diff --git a/clients/client-storage-gateway/pagination/ListTapePoolsPaginator.ts b/clients/client-storage-gateway/pagination/ListTapePoolsPaginator.ts index b0ad072fb2c74..abc45aa1e7e9a 100644 --- a/clients/client-storage-gateway/pagination/ListTapePoolsPaginator.ts +++ b/clients/client-storage-gateway/pagination/ListTapePoolsPaginator.ts @@ -8,6 +8,9 @@ import { import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: ListTapePoolsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTapePoolsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: ListTapePoolsCommandInput, diff --git a/clients/client-storage-gateway/pagination/ListTapesPaginator.ts b/clients/client-storage-gateway/pagination/ListTapesPaginator.ts index 7f385cbcf2482..23197dfc1488d 100644 --- a/clients/client-storage-gateway/pagination/ListTapesPaginator.ts +++ b/clients/client-storage-gateway/pagination/ListTapesPaginator.ts @@ -4,6 +4,9 @@ import { ListTapesCommand, ListTapesCommandInput, ListTapesCommandOutput } from import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: ListTapesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTapesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: ListTapesCommandInput, diff --git a/clients/client-storage-gateway/pagination/ListVolumesPaginator.ts b/clients/client-storage-gateway/pagination/ListVolumesPaginator.ts index 0f3a8623aee66..73e588a9ef320 100644 --- a/clients/client-storage-gateway/pagination/ListVolumesPaginator.ts +++ b/clients/client-storage-gateway/pagination/ListVolumesPaginator.ts @@ -4,6 +4,9 @@ import { ListVolumesCommand, ListVolumesCommandInput, ListVolumesCommandOutput } import { StorageGatewayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: StorageGatewayClient, input: ListVolumesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVolumesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: StorageGateway, input: ListVolumesCommandInput, diff --git a/clients/client-storage-gateway/runtimeConfig.browser.ts b/clients/client-storage-gateway/runtimeConfig.browser.ts index 666148d02ea5a..f47b6797e93cf 100644 --- a/clients/client-storage-gateway/runtimeConfig.browser.ts +++ b/clients/client-storage-gateway/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./StorageGatewayClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-storage-gateway/runtimeConfig.native.ts b/clients/client-storage-gateway/runtimeConfig.native.ts index 6704650625adc..cc6d1c0ac637a 100644 --- a/clients/client-storage-gateway/runtimeConfig.native.ts +++ b/clients/client-storage-gateway/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./StorageGatewayClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-storage-gateway/runtimeConfig.shared.ts b/clients/client-storage-gateway/runtimeConfig.shared.ts index 01e60afe1e6a2..b8cd0f0d535eb 100644 --- a/clients/client-storage-gateway/runtimeConfig.shared.ts +++ b/clients/client-storage-gateway/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2013-06-30", disableHostPrefix: false, diff --git a/clients/client-storage-gateway/runtimeConfig.ts b/clients/client-storage-gateway/runtimeConfig.ts index 6d36cd0f6190a..8c73ede9abd22 100644 --- a/clients/client-storage-gateway/runtimeConfig.ts +++ b/clients/client-storage-gateway/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./StorageGatewayClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-storage-gateway/tsconfig.json b/clients/client-storage-gateway/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-storage-gateway/tsconfig.json +++ b/clients/client-storage-gateway/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-sts/commands/AssumeRoleCommand.ts b/clients/client-sts/commands/AssumeRoleCommand.ts index b508796a62420..c5d9bb8d937c1 100644 --- a/clients/client-sts/commands/AssumeRoleCommand.ts +++ b/clients/client-sts/commands/AssumeRoleCommand.ts @@ -17,6 +17,117 @@ import { export type AssumeRoleCommandInput = AssumeRoleRequest; export type AssumeRoleCommandOutput = AssumeRoleResponse & __MetadataBearer; +/** + *

Returns a set of temporary security credentials that you can use to access AWS + * resources that you might not normally have access to. These temporary credentials consist + * of an access key ID, a secret access key, and a security token. Typically, you use + * AssumeRole within your account or for cross-account access. For a + * comparison of AssumeRole with other API operations that produce temporary + * credentials, see Requesting Temporary Security + * Credentials and Comparing the + * AWS STS API operations in the IAM User Guide.

+ * + *

You cannot use AWS account root user credentials to call AssumeRole. + * You must use credentials for an IAM user or an IAM role to call + * AssumeRole.

+ *
+ *

For cross-account access, imagine that you own multiple accounts and need to access + * resources in each account. You could create long-term credentials in each account to access + * those resources. However, managing all those credentials and remembering which one can + * access which account can be time consuming. Instead, you can create one set of long-term + * credentials in one account. Then use temporary security credentials to access all the other + * accounts by assuming roles in those accounts. For more information about roles, see IAM Roles in the + * IAM User Guide.

+ *

+ * Session Duration + *

+ *

By default, the temporary security credentials created by AssumeRole last + * for one hour. However, you can use the optional DurationSeconds parameter to + * specify the duration of your session. You can provide a value from 900 seconds (15 minutes) + * up to the maximum session duration setting for the role. This setting can have a value from + * 1 hour to 12 hours. To learn how to view the maximum value for your role, see View the + * Maximum Session Duration Setting for a Role in the + * IAM User Guide. The maximum session duration limit applies when + * you use the AssumeRole* API operations or the assume-role* CLI + * commands. However the limit does not apply when you use those operations to create a + * console URL. For more information, see Using IAM Roles in the + * IAM User Guide.

+ *

+ * Permissions + *

+ *

The temporary security credentials created by AssumeRole can be used to + * make API calls to any AWS service with the following exception: You cannot call the + * AWS STS GetFederationToken or GetSessionToken API + * operations.

+ *

(Optional) You can pass inline or managed session policies to + * this operation. You can pass a single JSON policy document to use as an inline session + * policy. You can also specify up to 10 managed policies to use as managed session policies. + * The plain text that you use for both inline and managed session policies can't exceed 2,048 + * characters. Passing policies to this operation returns new + * temporary credentials. The resulting session's permissions are the intersection of the + * role's identity-based policy and the session policies. You can use the role's temporary + * credentials in subsequent AWS API calls to access resources in the account that owns + * the role. You cannot use session policies to grant more permissions than those allowed + * by the identity-based policy of the role that is being assumed. For more information, see + * Session + * Policies in the IAM User Guide.

+ *

To assume a role from a different account, your AWS account must be trusted by the + * role. The trust relationship is defined in the role's trust policy when the role is + * created. That trust policy states which accounts are allowed to delegate that access to + * users in the account.

+ *

A user who wants to access a role in a different account must also have permissions that + * are delegated from the user account administrator. The administrator must attach a policy + * that allows the user to call AssumeRole for the ARN of the role in the other + * account. If the user is in the same account as the role, then you can do either of the + * following:

+ *
    + *
  • + *

    Attach a policy to the user (identical to the previous user in a different + * account).

    + *
  • + *
  • + *

    Add the user as a principal directly in the role's trust policy.

    + *
  • + *
+ *

In this case, the trust policy acts as an IAM resource-based policy. Users in the same + * account as the role do not need explicit permission to assume the role. For more + * information about trust policies and resource-based policies, see IAM Policies in + * the IAM User Guide.

+ *

+ * Tags + *

+ *

(Optional) You can pass tag key-value pairs to your session. These tags are called + * session tags. For more information about session tags, see Passing Session Tags in STS in the + * IAM User Guide.

+ *

An administrator must grant you the permissions necessary to pass session tags. The + * administrator can also create granular permissions to allow you to pass only specific + * session tags. For more information, see Tutorial: Using Tags + * for Attribute-Based Access Control in the + * IAM User Guide.

+ *

You can set the session tags as transitive. Transitive tags persist during role + * chaining. For more information, see Chaining Roles + * with Session Tags in the IAM User Guide.

+ *

+ * Using MFA with AssumeRole + *

+ *

(Optional) You can include multi-factor authentication (MFA) information when you call + * AssumeRole. This is useful for cross-account scenarios to ensure that the + * user that assumes the role has been authenticated with an AWS MFA device. In that + * scenario, the trust policy of the role being assumed includes a condition that tests for + * MFA authentication. If the caller does not include valid MFA information, the request to + * assume the role is denied. The condition in a trust policy that tests for MFA + * authentication might look like the following example.

+ *

+ * "Condition": {"Bool": {"aws:MultiFactorAuthPresent": true}} + *

+ *

For more information, see Configuring MFA-Protected API Access + * in the IAM User Guide guide.

+ *

To use MFA with AssumeRole, you pass values for the + * SerialNumber and TokenCode parameters. The + * SerialNumber value identifies the user's hardware or virtual MFA device. + * The TokenCode is the time-based one-time password (TOTP) that the MFA device + * produces.

+ */ export class AssumeRoleCommand extends $Command< AssumeRoleCommandInput, AssumeRoleCommandOutput, @@ -31,6 +142,9 @@ export class AssumeRoleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: STSClientResolvedConfig, diff --git a/clients/client-sts/commands/AssumeRoleWithSAMLCommand.ts b/clients/client-sts/commands/AssumeRoleWithSAMLCommand.ts index d99a0f11d0a6b..3ab097d37b18a 100644 --- a/clients/client-sts/commands/AssumeRoleWithSAMLCommand.ts +++ b/clients/client-sts/commands/AssumeRoleWithSAMLCommand.ts @@ -20,6 +20,129 @@ import { export type AssumeRoleWithSAMLCommandInput = AssumeRoleWithSAMLRequest; export type AssumeRoleWithSAMLCommandOutput = AssumeRoleWithSAMLResponse & __MetadataBearer; +/** + *

Returns a set of temporary security credentials for users who have been authenticated + * via a SAML authentication response. This operation provides a mechanism for tying an + * enterprise identity store or directory to role-based AWS access without user-specific + * credentials or configuration. For a comparison of AssumeRoleWithSAML with the + * other API operations that produce temporary credentials, see Requesting Temporary Security + * Credentials and Comparing the + * AWS STS API operations in the IAM User Guide.

+ *

The temporary security credentials returned by this operation consist of an access key + * ID, a secret access key, and a security token. Applications can use these temporary + * security credentials to sign calls to AWS services.

+ *

+ * Session Duration + *

+ *

By default, the temporary security credentials created by + * AssumeRoleWithSAML last for one hour. However, you can use the optional + * DurationSeconds parameter to specify the duration of your session. Your + * role session lasts for the duration that you specify, or until the time specified in the + * SAML authentication response's SessionNotOnOrAfter value, whichever is + * shorter. You can provide a DurationSeconds value from 900 seconds (15 minutes) + * up to the maximum session duration setting for the role. This setting can have a value from + * 1 hour to 12 hours. To learn how to view the maximum value for your role, see View the + * Maximum Session Duration Setting for a Role in the + * IAM User Guide. The maximum session duration limit applies when + * you use the AssumeRole* API operations or the assume-role* CLI + * commands. However the limit does not apply when you use those operations to create a + * console URL. For more information, see Using IAM Roles in the + * IAM User Guide.

+ *

+ * Permissions + *

+ *

The temporary security credentials created by AssumeRoleWithSAML can be + * used to make API calls to any AWS service with the following exception: you cannot call + * the STS GetFederationToken or GetSessionToken API + * operations.

+ *

(Optional) You can pass inline or managed session policies to + * this operation. You can pass a single JSON policy document to use as an inline session + * policy. You can also specify up to 10 managed policies to use as managed session policies. + * The plain text that you use for both inline and managed session policies can't exceed 2,048 + * characters. Passing policies to this operation returns new + * temporary credentials. The resulting session's permissions are the intersection of the + * role's identity-based policy and the session policies. You can use the role's temporary + * credentials in subsequent AWS API calls to access resources in the account that owns + * the role. You cannot use session policies to grant more permissions than those allowed + * by the identity-based policy of the role that is being assumed. For more information, see + * Session + * Policies in the IAM User Guide.

+ *

Calling AssumeRoleWithSAML does not require the use of AWS security + * credentials. The identity of the caller is validated by using keys in the metadata document + * that is uploaded for the SAML provider entity for your identity provider.

+ * + *

Calling AssumeRoleWithSAML can result in an entry in your AWS CloudTrail logs. + * The entry includes the value in the NameID element of the SAML assertion. + * We recommend that you use a NameIDType that is not associated with any + * personally identifiable information (PII). For example, you could instead use the + * persistent identifier + * (urn:oasis:names:tc:SAML:2.0:nameid-format:persistent).

+ *
+ *

+ * Tags + *

+ *

(Optional) You can configure your IdP to pass attributes into your SAML assertion as + * session tags. Each session tag consists of a key name and an associated value. For more + * information about session tags, see Passing Session Tags in STS in the + * IAM User Guide.

+ *

You can pass up to 50 session tags. The plain text session tag keys can’t exceed 128 + * characters and the values can’t exceed 256 characters. For these and additional limits, see + * IAM + * and STS Character Limits in the IAM User Guide.

+ * + * + *

An AWS conversion compresses the passed session policies and session tags into a + * packed binary format that has a separate limit. Your request can fail for this limit + * even if your plain text meets the other requirements. The PackedPolicySize + * response element indicates by percentage how close the policies and tags for your + * request are to the upper size limit. + *

+ *
+ * + *

You can pass a session tag with the same key as a tag that is attached to the role. When + * you do, session tags override the role's tags with the same key.

+ *

An administrator must grant you the permissions necessary to pass session tags. The + * administrator can also create granular permissions to allow you to pass only specific + * session tags. For more information, see Tutorial: Using Tags + * for Attribute-Based Access Control in the + * IAM User Guide.

+ *

You can set the session tags as transitive. Transitive tags persist during role + * chaining. For more information, see Chaining Roles + * with Session Tags in the IAM User Guide.

+ *

+ * SAML Configuration + *

+ *

Before your application can call AssumeRoleWithSAML, you must configure + * your SAML identity provider (IdP) to issue the claims required by AWS. Additionally, you + * must use AWS Identity and Access Management (IAM) to create a SAML provider entity in your AWS account that + * represents your identity provider. You must also create an IAM role that specifies this + * SAML provider in its trust policy.

+ *

For more information, see the following resources:

+ * + */ export class AssumeRoleWithSAMLCommand extends $Command< AssumeRoleWithSAMLCommandInput, AssumeRoleWithSAMLCommandOutput, @@ -34,6 +157,9 @@ export class AssumeRoleWithSAMLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: STSClientResolvedConfig, diff --git a/clients/client-sts/commands/AssumeRoleWithWebIdentityCommand.ts b/clients/client-sts/commands/AssumeRoleWithWebIdentityCommand.ts index 14f440a800c4e..795552882c865 100644 --- a/clients/client-sts/commands/AssumeRoleWithWebIdentityCommand.ts +++ b/clients/client-sts/commands/AssumeRoleWithWebIdentityCommand.ts @@ -20,6 +20,145 @@ import { export type AssumeRoleWithWebIdentityCommandInput = AssumeRoleWithWebIdentityRequest; export type AssumeRoleWithWebIdentityCommandOutput = AssumeRoleWithWebIdentityResponse & __MetadataBearer; +/** + *

Returns a set of temporary security credentials for users who have been authenticated in + * a mobile or web application with a web identity provider. Example providers include Amazon Cognito, + * Login with Amazon, Facebook, Google, or any OpenID Connect-compatible identity + * provider.

+ * + *

For mobile applications, we recommend that you use Amazon Cognito. You can use Amazon Cognito with the + * AWS SDK for iOS Developer Guide and the AWS SDK for Android Developer Guide to uniquely + * identify a user. You can also supply the user with a consistent identity throughout the + * lifetime of an application.

+ *

To learn more about Amazon Cognito, see Amazon Cognito Overview in + * AWS SDK for Android Developer Guide and Amazon Cognito Overview in the + * AWS SDK for iOS Developer Guide.

+ *
+ *

Calling AssumeRoleWithWebIdentity does not require the use of AWS + * security credentials. Therefore, you can distribute an application (for example, on mobile + * devices) that requests temporary security credentials without including long-term AWS + * credentials in the application. You also don't need to deploy server-based proxy services + * that use long-term AWS credentials. Instead, the identity of the caller is validated by + * using a token from the web identity provider. For a comparison of + * AssumeRoleWithWebIdentity with the other API operations that produce + * temporary credentials, see Requesting Temporary Security + * Credentials and Comparing the + * AWS STS API operations in the IAM User Guide.

+ *

The temporary security credentials returned by this API consist of an access key ID, a + * secret access key, and a security token. Applications can use these temporary security + * credentials to sign calls to AWS service API operations.

+ *

+ * Session Duration + *

+ *

By default, the temporary security credentials created by + * AssumeRoleWithWebIdentity last for one hour. However, you can use the + * optional DurationSeconds parameter to specify the duration of your session. + * You can provide a value from 900 seconds (15 minutes) up to the maximum session duration + * setting for the role. This setting can have a value from 1 hour to 12 hours. To learn how + * to view the maximum value for your role, see View the + * Maximum Session Duration Setting for a Role in the + * IAM User Guide. The maximum session duration limit applies when + * you use the AssumeRole* API operations or the assume-role* CLI + * commands. However the limit does not apply when you use those operations to create a + * console URL. For more information, see Using IAM Roles in the + * IAM User Guide.

+ *

+ * Permissions + *

+ *

The temporary security credentials created by AssumeRoleWithWebIdentity can + * be used to make API calls to any AWS service with the following exception: you cannot + * call the STS GetFederationToken or GetSessionToken API + * operations.

+ *

(Optional) You can pass inline or managed session policies to + * this operation. You can pass a single JSON policy document to use as an inline session + * policy. You can also specify up to 10 managed policies to use as managed session policies. + * The plain text that you use for both inline and managed session policies can't exceed 2,048 + * characters. Passing policies to this operation returns new + * temporary credentials. The resulting session's permissions are the intersection of the + * role's identity-based policy and the session policies. You can use the role's temporary + * credentials in subsequent AWS API calls to access resources in the account that owns + * the role. You cannot use session policies to grant more permissions than those allowed + * by the identity-based policy of the role that is being assumed. For more information, see + * Session + * Policies in the IAM User Guide.

+ *

+ * Tags + *

+ *

(Optional) You can configure your IdP to pass attributes into your web identity token as + * session tags. Each session tag consists of a key name and an associated value. For more + * information about session tags, see Passing Session Tags in STS in the + * IAM User Guide.

+ *

You can pass up to 50 session tags. The plain text session tag keys can’t exceed 128 + * characters and the values can’t exceed 256 characters. For these and additional limits, see + * IAM + * and STS Character Limits in the IAM User Guide.

+ * + * + *

An AWS conversion compresses the passed session policies and session tags into a + * packed binary format that has a separate limit. Your request can fail for this limit + * even if your plain text meets the other requirements. The PackedPolicySize + * response element indicates by percentage how close the policies and tags for your + * request are to the upper size limit. + *

+ *
+ * + *

You can pass a session tag with the same key as a tag that is attached to the role. When + * you do, the session tag overrides the role tag with the same key.

+ *

An administrator must grant you the permissions necessary to pass session tags. The + * administrator can also create granular permissions to allow you to pass only specific + * session tags. For more information, see Tutorial: Using Tags + * for Attribute-Based Access Control in the + * IAM User Guide.

+ *

You can set the session tags as transitive. Transitive tags persist during role + * chaining. For more information, see Chaining Roles + * with Session Tags in the IAM User Guide.

+ *

+ * Identities + *

+ *

Before your application can call AssumeRoleWithWebIdentity, you must have + * an identity token from a supported identity provider and create a role that the application + * can assume. The role that your application assumes must trust the identity provider that is + * associated with the identity token. In other words, the identity provider must be specified + * in the role's trust policy.

+ * + *

Calling AssumeRoleWithWebIdentity can result in an entry in your + * AWS CloudTrail logs. The entry includes the Subject of + * the provided Web Identity Token. We recommend that you avoid using any personally + * identifiable information (PII) in this field. For example, you could instead use a GUID + * or a pairwise identifier, as suggested + * in the OIDC specification.

+ *
+ *

For more information about how to use web identity federation and the + * AssumeRoleWithWebIdentity API, see the following resources:

+ * + */ export class AssumeRoleWithWebIdentityCommand extends $Command< AssumeRoleWithWebIdentityCommandInput, AssumeRoleWithWebIdentityCommandOutput, @@ -34,6 +173,9 @@ export class AssumeRoleWithWebIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: STSClientResolvedConfig, diff --git a/clients/client-sts/commands/DecodeAuthorizationMessageCommand.ts b/clients/client-sts/commands/DecodeAuthorizationMessageCommand.ts index 163ee80d61dfd..9dc33c879d8c8 100644 --- a/clients/client-sts/commands/DecodeAuthorizationMessageCommand.ts +++ b/clients/client-sts/commands/DecodeAuthorizationMessageCommand.ts @@ -20,6 +20,44 @@ import { export type DecodeAuthorizationMessageCommandInput = DecodeAuthorizationMessageRequest; export type DecodeAuthorizationMessageCommandOutput = DecodeAuthorizationMessageResponse & __MetadataBearer; +/** + *

Decodes additional information about the authorization status of a request from an + * encoded message returned in response to an AWS request.

+ *

For example, if a user is not authorized to perform an operation that he or she has + * requested, the request returns a Client.UnauthorizedOperation response (an + * HTTP 403 response). Some AWS operations additionally return an encoded message that can + * provide details about this authorization failure.

+ * + *

Only certain AWS operations return an encoded authorization message. The + * documentation for an individual operation indicates whether that operation returns an + * encoded message in addition to returning an HTTP code.

+ *
+ *

The message is encoded because the details of the authorization status can constitute + * privileged information that the user who requested the operation should not see. To decode + * an authorization status message, a user must be granted permissions via an IAM policy to + * request the DecodeAuthorizationMessage + * (sts:DecodeAuthorizationMessage) action.

+ *

The decoded message includes the following type of information:

+ *
    + *
  • + *

    Whether the request was denied due to an explicit deny or due to the absence of an + * explicit allow. For more information, see Determining Whether a Request is Allowed or Denied in the + * IAM User Guide.

    + *
  • + *
  • + *

    The principal who made the request.

    + *
  • + *
  • + *

    The requested action.

    + *
  • + *
  • + *

    The requested resource.

    + *
  • + *
  • + *

    The values of condition keys in the context of the user's request.

    + *
  • + *
+ */ export class DecodeAuthorizationMessageCommand extends $Command< DecodeAuthorizationMessageCommandInput, DecodeAuthorizationMessageCommandOutput, @@ -34,6 +72,9 @@ export class DecodeAuthorizationMessageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: STSClientResolvedConfig, diff --git a/clients/client-sts/commands/GetAccessKeyInfoCommand.ts b/clients/client-sts/commands/GetAccessKeyInfoCommand.ts index 8c462e0a4f479..b283d390b77cd 100644 --- a/clients/client-sts/commands/GetAccessKeyInfoCommand.ts +++ b/clients/client-sts/commands/GetAccessKeyInfoCommand.ts @@ -20,6 +20,26 @@ import { export type GetAccessKeyInfoCommandInput = GetAccessKeyInfoRequest; export type GetAccessKeyInfoCommandOutput = GetAccessKeyInfoResponse & __MetadataBearer; +/** + *

Returns the account identifier for the specified access key ID.

+ *

Access keys consist of two parts: an access key ID (for example, + * AKIAIOSFODNN7EXAMPLE) and a secret access key (for example, + * wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY). For more information about + * access keys, see Managing Access Keys for IAM + * Users in the IAM User Guide.

+ *

When you pass an access key ID to this operation, it returns the ID of the AWS account + * to which the keys belong. Access key IDs beginning with AKIA are long-term + * credentials for an IAM user or the AWS account root user. Access key IDs beginning with + * ASIA are temporary credentials that are created using STS operations. If + * the account in the response belongs to you, you can sign in as the root user and review + * your root user access keys. Then, you can pull a credentials report to + * learn which IAM user owns the keys. To learn who requested the temporary credentials for + * an ASIA access key, view the STS events in your CloudTrail logs in the + * IAM User Guide.

+ *

This operation does not indicate the state of the access key. The key might be active, + * inactive, or deleted. Active keys might not have permissions to perform an operation. + * Providing a deleted access key might return an error that the key doesn't exist.

+ */ export class GetAccessKeyInfoCommand extends $Command< GetAccessKeyInfoCommandInput, GetAccessKeyInfoCommandOutput, @@ -34,6 +54,9 @@ export class GetAccessKeyInfoCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: STSClientResolvedConfig, diff --git a/clients/client-sts/commands/GetCallerIdentityCommand.ts b/clients/client-sts/commands/GetCallerIdentityCommand.ts index 231562b4c7eb5..e21d1e0359f4e 100644 --- a/clients/client-sts/commands/GetCallerIdentityCommand.ts +++ b/clients/client-sts/commands/GetCallerIdentityCommand.ts @@ -20,6 +20,18 @@ import { export type GetCallerIdentityCommandInput = GetCallerIdentityRequest; export type GetCallerIdentityCommandOutput = GetCallerIdentityResponse & __MetadataBearer; +/** + *

Returns details about the IAM user or role whose credentials are used to call the + * operation.

+ * + *

No permissions are required to perform this operation. If an administrator adds a + * policy to your IAM user or role that explicitly denies access to the + * sts:GetCallerIdentity action, you can still perform this operation. + * Permissions are not required because the same information is returned when an IAM user + * or role is denied access. To view an example response, see I Am Not Authorized to Perform: iam:DeleteVirtualMFADevice in the + * IAM User Guide.

+ *
+ */ export class GetCallerIdentityCommand extends $Command< GetCallerIdentityCommandInput, GetCallerIdentityCommandOutput, @@ -34,6 +46,9 @@ export class GetCallerIdentityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: STSClientResolvedConfig, diff --git a/clients/client-sts/commands/GetFederationTokenCommand.ts b/clients/client-sts/commands/GetFederationTokenCommand.ts index 3da7aa5d468e1..a37b7cfa8a593 100644 --- a/clients/client-sts/commands/GetFederationTokenCommand.ts +++ b/clients/client-sts/commands/GetFederationTokenCommand.ts @@ -20,6 +20,87 @@ import { export type GetFederationTokenCommandInput = GetFederationTokenRequest; export type GetFederationTokenCommandOutput = GetFederationTokenResponse & __MetadataBearer; +/** + *

Returns a set of temporary security credentials (consisting of an access key ID, a + * secret access key, and a security token) for a federated user. A typical use is in a proxy + * application that gets temporary security credentials on behalf of distributed applications + * inside a corporate network. You must call the GetFederationToken operation + * using the long-term security credentials of an IAM user. As a result, this call is + * appropriate in contexts where those credentials can be safely stored, usually in a + * server-based application. For a comparison of GetFederationToken with the + * other API operations that produce temporary credentials, see Requesting Temporary Security + * Credentials and Comparing the + * AWS STS API operations in the IAM User Guide.

+ * + *

You can create a mobile-based or browser-based app that can authenticate users using + * a web identity provider like Login with Amazon, Facebook, Google, or an OpenID + * Connect-compatible identity provider. In this case, we recommend that you use Amazon Cognito or + * AssumeRoleWithWebIdentity. For more information, see Federation Through a Web-based Identity Provider in the + * IAM User Guide.

+ *
+ *

You can also call GetFederationToken using the security credentials of an + * AWS account root user, but we do not recommend it. Instead, we recommend that you create + * an IAM user for the purpose of the proxy application. Then attach a policy to the IAM + * user that limits federated users to only the actions and resources that they need to + * access. For more information, see IAM Best Practices in the + * IAM User Guide.

+ *

+ * Session duration + *

+ *

The temporary credentials are valid for the specified duration, from 900 seconds (15 + * minutes) up to a maximum of 129,600 seconds (36 hours). The default session duration is + * 43,200 seconds (12 hours). Temporary credentials that are obtained by using AWS account + * root user credentials have a maximum duration of 3,600 seconds (1 hour).

+ *

+ * Permissions + *

+ *

You can use the temporary credentials created by GetFederationToken in any + * AWS service except the following:

+ *
    + *
  • + *

    You cannot call any IAM operations using the AWS CLI or the AWS API.

    + *
  • + *
  • + *

    You cannot call any STS operations except GetCallerIdentity.

    + *
  • + *
+ *

You must pass an inline or managed session policy to + * this operation. You can pass a single JSON policy document to use as an inline session + * policy. You can also specify up to 10 managed policies to use as managed session policies. + * The plain text that you use for both inline and managed session policies can't exceed 2,048 + * characters.

+ *

Though the session policy parameters are optional, if you do not pass a policy, then the + * resulting federated user session has no permissions. When you pass session policies, the + * session permissions are the intersection of the IAM user policies and the session + * policies that you pass. This gives you a way to further restrict the permissions for a + * federated user. You cannot use session policies to grant more permissions than those that + * are defined in the permissions policy of the IAM user. For more information, see Session + * Policies in the IAM User Guide. For information about + * using GetFederationToken to create temporary security credentials, see GetFederationToken—Federation Through a Custom Identity Broker.

+ *

You can use the credentials to access a resource that has a resource-based policy. If + * that policy specifically references the federated user session in the + * Principal element of the policy, the session has the permissions allowed by + * the policy. These permissions are granted in addition to the permissions granted by the + * session policies.

+ *

+ * Tags + *

+ *

(Optional) You can pass tag key-value pairs to your session. These are called session + * tags. For more information about session tags, see Passing Session Tags in STS in the + * IAM User Guide.

+ *

An administrator must grant you the permissions necessary to pass session tags. The + * administrator can also create granular permissions to allow you to pass only specific + * session tags. For more information, see Tutorial: Using Tags + * for Attribute-Based Access Control in the + * IAM User Guide.

+ *

Tag key–value pairs are not case sensitive, but case is preserved. This means that you + * cannot have separate Department and department tag keys. Assume + * that the user that you are federating has the + * Department=Marketing tag and you pass the + * department=engineering session tag. Department + * and department are not saved as separate tags, and the session tag passed in + * the request takes precedence over the user tag.

+ */ export class GetFederationTokenCommand extends $Command< GetFederationTokenCommandInput, GetFederationTokenCommandOutput, @@ -34,6 +115,9 @@ export class GetFederationTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: STSClientResolvedConfig, diff --git a/clients/client-sts/commands/GetSessionTokenCommand.ts b/clients/client-sts/commands/GetSessionTokenCommand.ts index ea5e51227bf5d..6b4c32e45166b 100644 --- a/clients/client-sts/commands/GetSessionTokenCommand.ts +++ b/clients/client-sts/commands/GetSessionTokenCommand.ts @@ -20,6 +20,60 @@ import { export type GetSessionTokenCommandInput = GetSessionTokenRequest; export type GetSessionTokenCommandOutput = GetSessionTokenResponse & __MetadataBearer; +/** + *

Returns a set of temporary credentials for an AWS account or IAM user. The + * credentials consist of an access key ID, a secret access key, and a security token. + * Typically, you use GetSessionToken if you want to use MFA to protect + * programmatic calls to specific AWS API operations like Amazon EC2 StopInstances. + * MFA-enabled IAM users would need to call GetSessionToken and submit an MFA + * code that is associated with their MFA device. Using the temporary security credentials + * that are returned from the call, IAM users can then make programmatic calls to API + * operations that require MFA authentication. If you do not supply a correct MFA code, then + * the API returns an access denied error. For a comparison of GetSessionToken + * with the other API operations that produce temporary credentials, see Requesting + * Temporary Security Credentials and Comparing the + * AWS STS API operations in the IAM User Guide.

+ *

+ * Session Duration + *

+ *

The GetSessionToken operation must be called by using the long-term AWS + * security credentials of the AWS account root user or an IAM user. Credentials that are + * created by IAM users are valid for the duration that you specify. This duration can range + * from 900 seconds (15 minutes) up to a maximum of 129,600 seconds (36 hours), with a default + * of 43,200 seconds (12 hours). Credentials based on account credentials can range from 900 + * seconds (15 minutes) up to 3,600 seconds (1 hour), with a default of 1 hour.

+ *

+ * Permissions + *

+ *

The temporary security credentials created by GetSessionToken can be used + * to make API calls to any AWS service with the following exceptions:

+ *
    + *
  • + *

    You cannot call any IAM API operations unless MFA authentication information is + * included in the request.

    + *
  • + *
  • + *

    You cannot call any STS API except + * AssumeRole or GetCallerIdentity.

    + *
  • + *
+ * + *

We recommend that you do not call GetSessionToken with AWS account + * root user credentials. Instead, follow our best practices by + * creating one or more IAM users, giving them the necessary permissions, and using IAM + * users for everyday interaction with AWS.

+ *
+ *

The credentials that are returned by GetSessionToken are based on + * permissions associated with the user whose credentials were used to call the operation. If + * GetSessionToken is called using AWS account root user credentials, the + * temporary credentials have root user permissions. Similarly, if + * GetSessionToken is called using the credentials of an IAM user, the + * temporary credentials have the same permissions as the IAM user.

+ *

For more information about using GetSessionToken to create temporary + * credentials, go to Temporary + * Credentials for Users in Untrusted Environments in the + * IAM User Guide.

+ */ export class GetSessionTokenCommand extends $Command< GetSessionTokenCommandInput, GetSessionTokenCommandOutput, @@ -34,6 +88,9 @@ export class GetSessionTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: STSClientResolvedConfig, diff --git a/clients/client-sts/package.json b/clients/client-sts/package.json index 5910ba94c0e08..a067ce5db4213 100644 --- a/clients/client-sts/package.json +++ b/clients/client-sts/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Sts Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -64,7 +64,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-sts/runtimeConfig.browser.ts b/clients/client-sts/runtimeConfig.browser.ts index 02e34c03f9dfe..809eb596e9824 100644 --- a/clients/client-sts/runtimeConfig.browser.ts +++ b/clients/client-sts/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./STSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-sts/runtimeConfig.native.ts b/clients/client-sts/runtimeConfig.native.ts index 9516c5f9fdec5..5161b3c6ef3ed 100644 --- a/clients/client-sts/runtimeConfig.native.ts +++ b/clients/client-sts/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./STSClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-sts/runtimeConfig.shared.ts b/clients/client-sts/runtimeConfig.shared.ts index c37a40c24cb5b..4048713456856 100644 --- a/clients/client-sts/runtimeConfig.shared.ts +++ b/clients/client-sts/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2011-06-15", disableHostPrefix: false, diff --git a/clients/client-sts/runtimeConfig.ts b/clients/client-sts/runtimeConfig.ts index 4749512bd334e..7b79d9cf829bf 100644 --- a/clients/client-sts/runtimeConfig.ts +++ b/clients/client-sts/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./STSClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-sts/tsconfig.json b/clients/client-sts/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-sts/tsconfig.json +++ b/clients/client-sts/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-support/commands/AddAttachmentsToSetCommand.ts b/clients/client-support/commands/AddAttachmentsToSetCommand.ts index 3026c4afa2237..54586c3119b82 100644 --- a/clients/client-support/commands/AddAttachmentsToSetCommand.ts +++ b/clients/client-support/commands/AddAttachmentsToSetCommand.ts @@ -20,6 +20,26 @@ import { export type AddAttachmentsToSetCommandInput = AddAttachmentsToSetRequest; export type AddAttachmentsToSetCommandOutput = AddAttachmentsToSetResponse & __MetadataBearer; +/** + *

Adds one or more attachments to an attachment set.

+ *

An attachment set is a temporary container for attachments that you add to a case or + * case communication. The set is available for 1 hour after it's created. The + * expiryTime returned in the response is when the set expires.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class AddAttachmentsToSetCommand extends $Command< AddAttachmentsToSetCommandInput, AddAttachmentsToSetCommandOutput, @@ -34,6 +54,9 @@ export class AddAttachmentsToSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/AddCommunicationToCaseCommand.ts b/clients/client-support/commands/AddCommunicationToCaseCommand.ts index 8a35cc8f047a0..de6cc5e5b20f1 100644 --- a/clients/client-support/commands/AddCommunicationToCaseCommand.ts +++ b/clients/client-support/commands/AddCommunicationToCaseCommand.ts @@ -20,6 +20,28 @@ import { export type AddCommunicationToCaseCommandInput = AddCommunicationToCaseRequest; export type AddCommunicationToCaseCommandOutput = AddCommunicationToCaseResponse & __MetadataBearer; +/** + *

Adds additional customer communication to an AWS Support case. Use the caseId + * parameter to identify the case to which to add communication. You can list a set of + * email addresses to copy on the communication by using the ccEmailAddresses + * parameter. The communicationBody value contains the text of the + * communication.

+ * + * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class AddCommunicationToCaseCommand extends $Command< AddCommunicationToCaseCommandInput, AddCommunicationToCaseCommandOutput, @@ -34,6 +56,9 @@ export class AddCommunicationToCaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/CreateCaseCommand.ts b/clients/client-support/commands/CreateCaseCommand.ts index 6554322cdb3f0..8c53bc9f54aec 100644 --- a/clients/client-support/commands/CreateCaseCommand.ts +++ b/clients/client-support/commands/CreateCaseCommand.ts @@ -20,6 +20,41 @@ import { export type CreateCaseCommandInput = CreateCaseRequest; export type CreateCaseCommandOutput = CreateCaseResponse & __MetadataBearer; +/** + *

Creates a case in the AWS Support Center. This operation is similar to how you create a case + * in the AWS Support Center Create + * Case page.

+ *

The AWS Support API doesn't support requesting service limit increases. You can submit a + * service limit increase in the following ways:

+ * + *

A successful CreateCase request returns an AWS Support case number. You can use + * the DescribeCases operation and specify the case number to get + * existing AWS Support cases. After you create a case, use the AddCommunicationToCase operation to add additional communication or + * attachments to an existing case.

+ *

The caseId is separate from the displayId that appears in + * the AWS Support Center. Use the DescribeCases operation to get the displayId.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class CreateCaseCommand extends $Command< CreateCaseCommandInput, CreateCaseCommandOutput, @@ -34,6 +69,9 @@ export class CreateCaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeAttachmentCommand.ts b/clients/client-support/commands/DescribeAttachmentCommand.ts index e4175992b8e78..5a6d15bfb1b3c 100644 --- a/clients/client-support/commands/DescribeAttachmentCommand.ts +++ b/clients/client-support/commands/DescribeAttachmentCommand.ts @@ -20,6 +20,27 @@ import { export type DescribeAttachmentCommandInput = DescribeAttachmentRequest; export type DescribeAttachmentCommandOutput = DescribeAttachmentResponse & __MetadataBearer; +/** + *

Returns the attachment that has the specified ID. Attachments can include screenshots, + * error logs, or other files that describe your issue. Attachment IDs are generated by the + * case management system when you add an attachment to a case or case communication. + * Attachment IDs are returned in the AttachmentDetails objects that are + * returned by the DescribeCommunications operation.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeAttachmentCommand extends $Command< DescribeAttachmentCommandInput, DescribeAttachmentCommandOutput, @@ -34,6 +55,9 @@ export class DescribeAttachmentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeCasesCommand.ts b/clients/client-support/commands/DescribeCasesCommand.ts index fdecb72ddbf2d..911f450447b15 100644 --- a/clients/client-support/commands/DescribeCasesCommand.ts +++ b/clients/client-support/commands/DescribeCasesCommand.ts @@ -20,6 +20,39 @@ import { export type DescribeCasesCommandInput = DescribeCasesRequest; export type DescribeCasesCommandOutput = DescribeCasesResponse & __MetadataBearer; +/** + *

Returns a list of cases that you specify by passing one or more case IDs. You can use + * the afterTime and beforeTime parameters to filter the cases by + * date. You can set values for the includeResolvedCases and + * includeCommunications parameters to specify how much information to + * return.

+ *

The response returns the following in JSON format:

+ *
    + *
  • + *

    One or more CaseDetails data types.

    + *
  • + *
  • + *

    One or more nextToken values, which specify where to paginate the + * returned records represented by the CaseDetails objects.

    + *
  • + *
+ *

Case data is available for 12 months after creation. If a case was created more than + * 12 months ago, a request might return an error.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeCasesCommand extends $Command< DescribeCasesCommandInput, DescribeCasesCommandOutput, @@ -34,6 +67,9 @@ export class DescribeCasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeCommunicationsCommand.ts b/clients/client-support/commands/DescribeCommunicationsCommand.ts index 2e7e491432d0f..bfcb8d0c377f8 100644 --- a/clients/client-support/commands/DescribeCommunicationsCommand.ts +++ b/clients/client-support/commands/DescribeCommunicationsCommand.ts @@ -20,6 +20,32 @@ import { export type DescribeCommunicationsCommandInput = DescribeCommunicationsRequest; export type DescribeCommunicationsCommandOutput = DescribeCommunicationsResponse & __MetadataBearer; +/** + *

Returns communications and attachments for one or more support cases. Use the + * afterTime and beforeTime parameters to filter by date. You + * can use the caseId parameter to restrict the results to a specific + * case.

+ *

Case data is available for 12 months after creation. If a case was created more than + * 12 months ago, a request for data might cause an error.

+ *

You can use the maxResults and nextToken parameters to + * control the pagination of the results. Set maxResults to the number of + * cases that you want to display on each page, and use nextToken to specify + * the resumption of pagination.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeCommunicationsCommand extends $Command< DescribeCommunicationsCommandInput, DescribeCommunicationsCommandOutput, @@ -34,6 +60,9 @@ export class DescribeCommunicationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeServicesCommand.ts b/clients/client-support/commands/DescribeServicesCommand.ts index 852a5dc618692..1cefbdb2ff8cc 100644 --- a/clients/client-support/commands/DescribeServicesCommand.ts +++ b/clients/client-support/commands/DescribeServicesCommand.ts @@ -20,6 +20,31 @@ import { export type DescribeServicesCommandInput = DescribeServicesRequest; export type DescribeServicesCommandOutput = DescribeServicesResponse & __MetadataBearer; +/** + *

Returns the current list of AWS services and a list of service categories for each + * service. You then use service names and categories in your CreateCase + * requests. Each AWS service has its own set of categories.

+ *

The service codes and category codes correspond to the values that appear in the + * Service and Category lists on the AWS Support Center Create Case page. The values in those fields + * don't necessarily match the service codes and categories returned by the + * DescribeServices operation. Always use the service codes and categories + * that the DescribeServices operation returns, so that you have the most + * recent set of service and category codes.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeServicesCommand extends $Command< DescribeServicesCommandInput, DescribeServicesCommandOutput, @@ -34,6 +59,9 @@ export class DescribeServicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeSeverityLevelsCommand.ts b/clients/client-support/commands/DescribeSeverityLevelsCommand.ts index 98c2c444b480f..c09154c4eb362 100644 --- a/clients/client-support/commands/DescribeSeverityLevelsCommand.ts +++ b/clients/client-support/commands/DescribeSeverityLevelsCommand.ts @@ -20,6 +20,25 @@ import { export type DescribeSeverityLevelsCommandInput = DescribeSeverityLevelsRequest; export type DescribeSeverityLevelsCommandOutput = DescribeSeverityLevelsResponse & __MetadataBearer; +/** + *

Returns the list of severity levels that you can assign to an AWS Support case. The severity + * level for a case is also a field in the CaseDetails data type that you + * include for a CreateCase request.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeSeverityLevelsCommand extends $Command< DescribeSeverityLevelsCommandInput, DescribeSeverityLevelsCommandOutput, @@ -34,6 +53,9 @@ export class DescribeSeverityLevelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeTrustedAdvisorCheckRefreshStatusesCommand.ts b/clients/client-support/commands/DescribeTrustedAdvisorCheckRefreshStatusesCommand.ts index 29ff7d9638fdd..ac501d9ac47c4 100644 --- a/clients/client-support/commands/DescribeTrustedAdvisorCheckRefreshStatusesCommand.ts +++ b/clients/client-support/commands/DescribeTrustedAdvisorCheckRefreshStatusesCommand.ts @@ -24,6 +24,28 @@ export type DescribeTrustedAdvisorCheckRefreshStatusesCommandInput = DescribeTru export type DescribeTrustedAdvisorCheckRefreshStatusesCommandOutput = DescribeTrustedAdvisorCheckRefreshStatusesResponse & __MetadataBearer; +/** + *

Returns the refresh status of the AWS Trusted Advisor checks that have the specified check + * IDs. You can get the check IDs by calling the DescribeTrustedAdvisorChecks operation.

+ *

Some checks are refreshed automatically, and you can't return their refresh statuses + * by using the DescribeTrustedAdvisorCheckRefreshStatuses operation. If you + * call this operation for these checks, you might see an + * InvalidParameterValue error.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeTrustedAdvisorCheckRefreshStatusesCommand extends $Command< DescribeTrustedAdvisorCheckRefreshStatusesCommandInput, DescribeTrustedAdvisorCheckRefreshStatusesCommandOutput, @@ -38,6 +60,9 @@ export class DescribeTrustedAdvisorCheckRefreshStatusesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeTrustedAdvisorCheckResultCommand.ts b/clients/client-support/commands/DescribeTrustedAdvisorCheckResultCommand.ts index 5d35205db892f..c7645773b741c 100644 --- a/clients/client-support/commands/DescribeTrustedAdvisorCheckResultCommand.ts +++ b/clients/client-support/commands/DescribeTrustedAdvisorCheckResultCommand.ts @@ -24,6 +24,63 @@ export type DescribeTrustedAdvisorCheckResultCommandInput = DescribeTrustedAdvis export type DescribeTrustedAdvisorCheckResultCommandOutput = DescribeTrustedAdvisorCheckResultResponse & __MetadataBearer; +/** + *

Returns the results of the AWS Trusted Advisor check that has the specified check ID. You + * can get the check IDs by calling the DescribeTrustedAdvisorChecks + * operation.

+ *

The response contains a TrustedAdvisorCheckResult object, which + * contains these three objects:

+ * + *

In addition, the response contains these fields:

+ *
    + *
  • + *

    + * status - The alert status of the check: + * "ok" (green), "warning" (yellow), "error" (red), or "not_available".

    + *
  • + *
  • + *

    + * timestamp - The time of the last refresh + * of the check.

    + *
  • + *
  • + *

    + * checkId - The unique identifier for the + * check.

    + *
  • + *
+ * + * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeTrustedAdvisorCheckResultCommand extends $Command< DescribeTrustedAdvisorCheckResultCommandInput, DescribeTrustedAdvisorCheckResultCommandOutput, @@ -38,6 +95,9 @@ export class DescribeTrustedAdvisorCheckResultCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeTrustedAdvisorCheckSummariesCommand.ts b/clients/client-support/commands/DescribeTrustedAdvisorCheckSummariesCommand.ts index 9bfcc38db6e11..1b28ffc949660 100644 --- a/clients/client-support/commands/DescribeTrustedAdvisorCheckSummariesCommand.ts +++ b/clients/client-support/commands/DescribeTrustedAdvisorCheckSummariesCommand.ts @@ -24,6 +24,26 @@ export type DescribeTrustedAdvisorCheckSummariesCommandInput = DescribeTrustedAd export type DescribeTrustedAdvisorCheckSummariesCommandOutput = DescribeTrustedAdvisorCheckSummariesResponse & __MetadataBearer; +/** + *

Returns the results for the AWS Trusted Advisor check summaries for the check IDs that you + * specified. You can get the check IDs by calling the DescribeTrustedAdvisorChecks operation.

+ *

The response contains an array of TrustedAdvisorCheckSummary + * objects.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeTrustedAdvisorCheckSummariesCommand extends $Command< DescribeTrustedAdvisorCheckSummariesCommandInput, DescribeTrustedAdvisorCheckSummariesCommandOutput, @@ -38,6 +58,9 @@ export class DescribeTrustedAdvisorCheckSummariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/DescribeTrustedAdvisorChecksCommand.ts b/clients/client-support/commands/DescribeTrustedAdvisorChecksCommand.ts index 8ffd79a6c9294..e22d286ac3d06 100644 --- a/clients/client-support/commands/DescribeTrustedAdvisorChecksCommand.ts +++ b/clients/client-support/commands/DescribeTrustedAdvisorChecksCommand.ts @@ -20,6 +20,26 @@ import { export type DescribeTrustedAdvisorChecksCommandInput = DescribeTrustedAdvisorChecksRequest; export type DescribeTrustedAdvisorChecksCommandOutput = DescribeTrustedAdvisorChecksResponse & __MetadataBearer; +/** + *

Returns information about all available AWS Trusted Advisor checks, including the name, ID, + * category, description, and metadata. You must specify a language code. The AWS Support API + * currently supports English ("en") and Japanese ("ja"). The response contains a TrustedAdvisorCheckDescription object for each check. You must set the + * AWS Region to us-east-1.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class DescribeTrustedAdvisorChecksCommand extends $Command< DescribeTrustedAdvisorChecksCommandInput, DescribeTrustedAdvisorChecksCommandOutput, @@ -34,6 +54,9 @@ export class DescribeTrustedAdvisorChecksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/RefreshTrustedAdvisorCheckCommand.ts b/clients/client-support/commands/RefreshTrustedAdvisorCheckCommand.ts index df5262eb25a07..2575ef8b0f0aa 100644 --- a/clients/client-support/commands/RefreshTrustedAdvisorCheckCommand.ts +++ b/clients/client-support/commands/RefreshTrustedAdvisorCheckCommand.ts @@ -20,6 +20,32 @@ import { export type RefreshTrustedAdvisorCheckCommandInput = RefreshTrustedAdvisorCheckRequest; export type RefreshTrustedAdvisorCheckCommandOutput = RefreshTrustedAdvisorCheckResponse & __MetadataBearer; +/** + *

Refreshes the AWS Trusted Advisor check that you specify using the check ID. You can get the + * check IDs by calling the DescribeTrustedAdvisorChecks + * operation.

+ * + *

Some checks are refreshed automatically. If you call the + * RefreshTrustedAdvisorCheck operation to refresh them, you might see + * the InvalidParameterValue error.

+ *
+ *

The response contains a TrustedAdvisorCheckRefreshStatus + * object.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class RefreshTrustedAdvisorCheckCommand extends $Command< RefreshTrustedAdvisorCheckCommandInput, RefreshTrustedAdvisorCheckCommandOutput, @@ -34,6 +60,9 @@ export class RefreshTrustedAdvisorCheckCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/commands/ResolveCaseCommand.ts b/clients/client-support/commands/ResolveCaseCommand.ts index 8ef04d52cb23d..d07eb7cf6a817 100644 --- a/clients/client-support/commands/ResolveCaseCommand.ts +++ b/clients/client-support/commands/ResolveCaseCommand.ts @@ -20,6 +20,24 @@ import { export type ResolveCaseCommandInput = ResolveCaseRequest; export type ResolveCaseCommandOutput = ResolveCaseResponse & __MetadataBearer; +/** + *

Resolves a support case. This operation takes a caseId and returns the + * initial and final state of the case.

+ * + *
    + *
  • + *

    You must have a Business or Enterprise support plan to use the AWS Support + * API.

    + *
  • + *
  • + *

    If you call the AWS Support API from an account that does not have a + * Business or Enterprise support plan, the + * SubscriptionRequiredException error message appears. For + * information about changing your support plan, see AWS Support.

    + *
  • + *
+ *
+ */ export class ResolveCaseCommand extends $Command< ResolveCaseCommandInput, ResolveCaseCommandOutput, @@ -34,6 +52,9 @@ export class ResolveCaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SupportClientResolvedConfig, diff --git a/clients/client-support/package.json b/clients/client-support/package.json index d1faf353b1f91..c4712d2e54a1d 100644 --- a/clients/client-support/package.json +++ b/clients/client-support/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Support Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-support/pagination/DescribeCasesPaginator.ts b/clients/client-support/pagination/DescribeCasesPaginator.ts index 29f8aba645e19..b6ffda045874e 100644 --- a/clients/client-support/pagination/DescribeCasesPaginator.ts +++ b/clients/client-support/pagination/DescribeCasesPaginator.ts @@ -8,6 +8,9 @@ import { import { SupportPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SupportClient, input: DescribeCasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Support, input: DescribeCasesCommandInput, diff --git a/clients/client-support/pagination/DescribeCommunicationsPaginator.ts b/clients/client-support/pagination/DescribeCommunicationsPaginator.ts index 6cef6bd7f46d7..20bd72f39c569 100644 --- a/clients/client-support/pagination/DescribeCommunicationsPaginator.ts +++ b/clients/client-support/pagination/DescribeCommunicationsPaginator.ts @@ -8,6 +8,9 @@ import { import { SupportPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SupportClient, input: DescribeCommunicationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCommunicationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Support, input: DescribeCommunicationsCommandInput, diff --git a/clients/client-support/runtimeConfig.browser.ts b/clients/client-support/runtimeConfig.browser.ts index 7adf9cec19bd2..18234482e58fc 100644 --- a/clients/client-support/runtimeConfig.browser.ts +++ b/clients/client-support/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SupportClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-support/runtimeConfig.native.ts b/clients/client-support/runtimeConfig.native.ts index 37fd7dfa4b010..91f90d7b10574 100644 --- a/clients/client-support/runtimeConfig.native.ts +++ b/clients/client-support/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SupportClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-support/runtimeConfig.shared.ts b/clients/client-support/runtimeConfig.shared.ts index b51fb67efde70..6baa452d99308 100644 --- a/clients/client-support/runtimeConfig.shared.ts +++ b/clients/client-support/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2013-04-15", disableHostPrefix: false, diff --git a/clients/client-support/runtimeConfig.ts b/clients/client-support/runtimeConfig.ts index 3f4650b37486a..6eb899b68ab3d 100644 --- a/clients/client-support/runtimeConfig.ts +++ b/clients/client-support/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SupportClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-support/tsconfig.json b/clients/client-support/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-support/tsconfig.json +++ b/clients/client-support/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-swf/commands/CountClosedWorkflowExecutionsCommand.ts b/clients/client-swf/commands/CountClosedWorkflowExecutionsCommand.ts index 51285ef65d20b..63d9f2361fcb1 100644 --- a/clients/client-swf/commands/CountClosedWorkflowExecutionsCommand.ts +++ b/clients/client-swf/commands/CountClosedWorkflowExecutionsCommand.ts @@ -20,6 +20,55 @@ import { export type CountClosedWorkflowExecutionsCommandInput = CountClosedWorkflowExecutionsInput; export type CountClosedWorkflowExecutionsCommandOutput = WorkflowExecutionCount & __MetadataBearer; +/** + *

Returns the number of closed workflow executions within the given domain that meet the + * specified filtering criteria.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * tagFilter.tag: String constraint. The key is + * swf:tagFilter.tag.

      + *
    • + *
    • + *

      + * typeFilter.name: String constraint. The key is + * swf:typeFilter.name.

      + *
    • + *
    • + *

      + * typeFilter.version: String constraint. The key is + * swf:typeFilter.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class CountClosedWorkflowExecutionsCommand extends $Command< CountClosedWorkflowExecutionsCommandInput, CountClosedWorkflowExecutionsCommandOutput, @@ -34,6 +83,9 @@ export class CountClosedWorkflowExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/CountOpenWorkflowExecutionsCommand.ts b/clients/client-swf/commands/CountOpenWorkflowExecutionsCommand.ts index c463f4f90be91..a4fab7b623ab6 100644 --- a/clients/client-swf/commands/CountOpenWorkflowExecutionsCommand.ts +++ b/clients/client-swf/commands/CountOpenWorkflowExecutionsCommand.ts @@ -20,6 +20,55 @@ import { export type CountOpenWorkflowExecutionsCommandInput = CountOpenWorkflowExecutionsInput; export type CountOpenWorkflowExecutionsCommandOutput = WorkflowExecutionCount & __MetadataBearer; +/** + *

Returns the number of open workflow executions within the given domain that meet the + * specified filtering criteria.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * tagFilter.tag: String constraint. The key is + * swf:tagFilter.tag.

      + *
    • + *
    • + *

      + * typeFilter.name: String constraint. The key is + * swf:typeFilter.name.

      + *
    • + *
    • + *

      + * typeFilter.version: String constraint. The key is + * swf:typeFilter.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class CountOpenWorkflowExecutionsCommand extends $Command< CountOpenWorkflowExecutionsCommandInput, CountOpenWorkflowExecutionsCommandOutput, @@ -34,6 +83,9 @@ export class CountOpenWorkflowExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/CountPendingActivityTasksCommand.ts b/clients/client-swf/commands/CountPendingActivityTasksCommand.ts index 0d3dcc69cb83a..70a99dcf9192d 100644 --- a/clients/client-swf/commands/CountPendingActivityTasksCommand.ts +++ b/clients/client-swf/commands/CountPendingActivityTasksCommand.ts @@ -20,6 +20,36 @@ import { export type CountPendingActivityTasksCommandInput = CountPendingActivityTasksInput; export type CountPendingActivityTasksCommandOutput = PendingTaskCount & __MetadataBearer; +/** + *

Returns the estimated number of activity tasks in the specified task list. The count + * returned is an approximation and isn't guaranteed to be exact. If you specify a task list that + * no activity task was ever scheduled in then 0 is returned.

+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the taskList.name parameter by using a + * Condition element with the swf:taskList.name key to allow the + * action to access only certain task lists.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class CountPendingActivityTasksCommand extends $Command< CountPendingActivityTasksCommandInput, CountPendingActivityTasksCommandOutput, @@ -34,6 +64,9 @@ export class CountPendingActivityTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/CountPendingDecisionTasksCommand.ts b/clients/client-swf/commands/CountPendingDecisionTasksCommand.ts index 54561aaf4c2ed..bcb32bc4f9f56 100644 --- a/clients/client-swf/commands/CountPendingDecisionTasksCommand.ts +++ b/clients/client-swf/commands/CountPendingDecisionTasksCommand.ts @@ -20,6 +20,36 @@ import { export type CountPendingDecisionTasksCommandInput = CountPendingDecisionTasksInput; export type CountPendingDecisionTasksCommandOutput = PendingTaskCount & __MetadataBearer; +/** + *

Returns the estimated number of decision tasks in the specified task list. The count + * returned is an approximation and isn't guaranteed to be exact. If you specify a task list that + * no decision task was ever scheduled in then 0 is returned.

+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the taskList.name parameter by using a + * Condition element with the swf:taskList.name key to allow the + * action to access only certain task lists.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class CountPendingDecisionTasksCommand extends $Command< CountPendingDecisionTasksCommandInput, CountPendingDecisionTasksCommandOutput, @@ -34,6 +64,9 @@ export class CountPendingDecisionTasksCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/DeprecateActivityTypeCommand.ts b/clients/client-swf/commands/DeprecateActivityTypeCommand.ts index 987215bf0a1b9..a724524ca93ca 100644 --- a/clients/client-swf/commands/DeprecateActivityTypeCommand.ts +++ b/clients/client-swf/commands/DeprecateActivityTypeCommand.ts @@ -20,6 +20,51 @@ import { export type DeprecateActivityTypeCommandInput = DeprecateActivityTypeInput; export type DeprecateActivityTypeCommandOutput = __MetadataBearer; +/** + *

Deprecates the specified activity type. After an activity type has + * been deprecated, you cannot create new tasks of that activity type. Tasks of this type that + * were scheduled before the type was deprecated continue to run.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * activityType.name: String constraint. The key is + * swf:activityType.name.

      + *
    • + *
    • + *

      + * activityType.version: String constraint. The key is + * swf:activityType.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class DeprecateActivityTypeCommand extends $Command< DeprecateActivityTypeCommandInput, DeprecateActivityTypeCommandOutput, @@ -34,6 +79,9 @@ export class DeprecateActivityTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/DeprecateDomainCommand.ts b/clients/client-swf/commands/DeprecateDomainCommand.ts index ad4d4040c5025..be12d76a26cf5 100644 --- a/clients/client-swf/commands/DeprecateDomainCommand.ts +++ b/clients/client-swf/commands/DeprecateDomainCommand.ts @@ -20,6 +20,40 @@ import { export type DeprecateDomainCommandInput = DeprecateDomainInput; export type DeprecateDomainCommandOutput = __MetadataBearer; +/** + *

Deprecates the specified domain. After a domain has been deprecated it cannot be used + * to create new workflow executions or register new types. However, you can still use visibility + * actions on this domain. Deprecating a domain also deprecates all activity and workflow types + * registered in the domain. Executions that were started before the domain was deprecated + * continues to run.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class DeprecateDomainCommand extends $Command< DeprecateDomainCommandInput, DeprecateDomainCommandOutput, @@ -34,6 +68,9 @@ export class DeprecateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/DeprecateWorkflowTypeCommand.ts b/clients/client-swf/commands/DeprecateWorkflowTypeCommand.ts index d40ce6a4786fa..ee95da689a4d4 100644 --- a/clients/client-swf/commands/DeprecateWorkflowTypeCommand.ts +++ b/clients/client-swf/commands/DeprecateWorkflowTypeCommand.ts @@ -20,6 +20,52 @@ import { export type DeprecateWorkflowTypeCommandInput = DeprecateWorkflowTypeInput; export type DeprecateWorkflowTypeCommandOutput = __MetadataBearer; +/** + *

Deprecates the specified workflow type. After a workflow type has + * been deprecated, you cannot create new executions of that type. Executions that were started + * before the type was deprecated continues to run. A deprecated workflow type may still be used + * when calling visibility actions.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * workflowType.name: String constraint. The key is + * swf:workflowType.name.

      + *
    • + *
    • + *

      + * workflowType.version: String constraint. The key is + * swf:workflowType.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class DeprecateWorkflowTypeCommand extends $Command< DeprecateWorkflowTypeCommandInput, DeprecateWorkflowTypeCommandOutput, @@ -34,6 +80,9 @@ export class DeprecateWorkflowTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/DescribeActivityTypeCommand.ts b/clients/client-swf/commands/DescribeActivityTypeCommand.ts index 2ba6eaad6397f..6e1bf6555499c 100644 --- a/clients/client-swf/commands/DescribeActivityTypeCommand.ts +++ b/clients/client-swf/commands/DescribeActivityTypeCommand.ts @@ -20,6 +20,47 @@ import { export type DescribeActivityTypeCommandInput = DescribeActivityTypeInput; export type DescribeActivityTypeCommandOutput = ActivityTypeDetail & __MetadataBearer; +/** + *

Returns information about the specified activity type. This includes configuration + * settings provided when the type was registered and other general information about the + * type.

+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * activityType.name: String constraint. The key is + * swf:activityType.name.

      + *
    • + *
    • + *

      + * activityType.version: String constraint. The key is + * swf:activityType.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class DescribeActivityTypeCommand extends $Command< DescribeActivityTypeCommandInput, DescribeActivityTypeCommandOutput, @@ -34,6 +75,9 @@ export class DescribeActivityTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/DescribeDomainCommand.ts b/clients/client-swf/commands/DescribeDomainCommand.ts index 30f5736f9f470..0edb9f8f49a27 100644 --- a/clients/client-swf/commands/DescribeDomainCommand.ts +++ b/clients/client-swf/commands/DescribeDomainCommand.ts @@ -20,6 +20,33 @@ import { export type DescribeDomainCommandInput = DescribeDomainInput; export type DescribeDomainCommandOutput = DomainDetail & __MetadataBearer; +/** + *

Returns information about the specified domain, including description and + * status.

+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class DescribeDomainCommand extends $Command< DescribeDomainCommandInput, DescribeDomainCommandOutput, @@ -34,6 +61,9 @@ export class DescribeDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/DescribeWorkflowExecutionCommand.ts b/clients/client-swf/commands/DescribeWorkflowExecutionCommand.ts index 5b383014fda67..a7cacbbd0a2c4 100644 --- a/clients/client-swf/commands/DescribeWorkflowExecutionCommand.ts +++ b/clients/client-swf/commands/DescribeWorkflowExecutionCommand.ts @@ -20,6 +20,37 @@ import { export type DescribeWorkflowExecutionCommandInput = DescribeWorkflowExecutionInput; export type DescribeWorkflowExecutionCommandOutput = WorkflowExecutionDetail & __MetadataBearer; +/** + *

Returns information about the specified workflow execution including its type and some + * statistics.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class DescribeWorkflowExecutionCommand extends $Command< DescribeWorkflowExecutionCommandInput, DescribeWorkflowExecutionCommandOutput, @@ -34,6 +65,9 @@ export class DescribeWorkflowExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/DescribeWorkflowTypeCommand.ts b/clients/client-swf/commands/DescribeWorkflowTypeCommand.ts index ed2586cb9ee02..f606a7ed58c22 100644 --- a/clients/client-swf/commands/DescribeWorkflowTypeCommand.ts +++ b/clients/client-swf/commands/DescribeWorkflowTypeCommand.ts @@ -20,6 +20,47 @@ import { export type DescribeWorkflowTypeCommandInput = DescribeWorkflowTypeInput; export type DescribeWorkflowTypeCommandOutput = WorkflowTypeDetail & __MetadataBearer; +/** + *

Returns information about the specified workflow type. This + * includes configuration settings specified when the type was registered and other information + * such as creation date, current status, etc.

+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * workflowType.name: String constraint. The key is + * swf:workflowType.name.

      + *
    • + *
    • + *

      + * workflowType.version: String constraint. The key is + * swf:workflowType.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class DescribeWorkflowTypeCommand extends $Command< DescribeWorkflowTypeCommandInput, DescribeWorkflowTypeCommandOutput, @@ -34,6 +75,9 @@ export class DescribeWorkflowTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/GetWorkflowExecutionHistoryCommand.ts b/clients/client-swf/commands/GetWorkflowExecutionHistoryCommand.ts index 1f55e883fcd6b..853373ef7d519 100644 --- a/clients/client-swf/commands/GetWorkflowExecutionHistoryCommand.ts +++ b/clients/client-swf/commands/GetWorkflowExecutionHistoryCommand.ts @@ -20,6 +20,38 @@ import { export type GetWorkflowExecutionHistoryCommandInput = GetWorkflowExecutionHistoryInput; export type GetWorkflowExecutionHistoryCommandOutput = History & __MetadataBearer; +/** + *

Returns the history of the specified workflow execution. The results may be split into + * multiple pages. To retrieve subsequent pages, make the call again using the + * nextPageToken returned by the initial call.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class GetWorkflowExecutionHistoryCommand extends $Command< GetWorkflowExecutionHistoryCommandInput, GetWorkflowExecutionHistoryCommandOutput, @@ -34,6 +66,9 @@ export class GetWorkflowExecutionHistoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/ListActivityTypesCommand.ts b/clients/client-swf/commands/ListActivityTypesCommand.ts index 79c5c9146a2d7..2a5061e4fc714 100644 --- a/clients/client-swf/commands/ListActivityTypesCommand.ts +++ b/clients/client-swf/commands/ListActivityTypesCommand.ts @@ -20,6 +20,36 @@ import { export type ListActivityTypesCommandInput = ListActivityTypesInput; export type ListActivityTypesCommandOutput = ActivityTypeInfos & __MetadataBearer; +/** + *

Returns information about all activities registered in the specified domain that match + * the specified name and registration status. The result includes information like creation + * date, current status of the activity, etc. The results may be split into multiple pages. To + * retrieve subsequent pages, make the call again using the nextPageToken returned + * by the initial call.

+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class ListActivityTypesCommand extends $Command< ListActivityTypesCommandInput, ListActivityTypesCommandOutput, @@ -34,6 +64,9 @@ export class ListActivityTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/ListClosedWorkflowExecutionsCommand.ts b/clients/client-swf/commands/ListClosedWorkflowExecutionsCommand.ts index df735f2760749..dfce0858c1429 100644 --- a/clients/client-swf/commands/ListClosedWorkflowExecutionsCommand.ts +++ b/clients/client-swf/commands/ListClosedWorkflowExecutionsCommand.ts @@ -20,6 +20,56 @@ import { export type ListClosedWorkflowExecutionsCommandInput = ListClosedWorkflowExecutionsInput; export type ListClosedWorkflowExecutionsCommandOutput = WorkflowExecutionInfos & __MetadataBearer; +/** + *

Returns a list of closed workflow executions in the specified domain that meet the + * filtering criteria. The results may be split into multiple pages. To retrieve subsequent + * pages, make the call again using the nextPageToken returned by the initial call.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * tagFilter.tag: String constraint. The key is + * swf:tagFilter.tag.

      + *
    • + *
    • + *

      + * typeFilter.name: String constraint. The key is + * swf:typeFilter.name.

      + *
    • + *
    • + *

      + * typeFilter.version: String constraint. The key is + * swf:typeFilter.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class ListClosedWorkflowExecutionsCommand extends $Command< ListClosedWorkflowExecutionsCommandInput, ListClosedWorkflowExecutionsCommandOutput, @@ -34,6 +84,9 @@ export class ListClosedWorkflowExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/ListDomainsCommand.ts b/clients/client-swf/commands/ListDomainsCommand.ts index 78d29dbfc628e..8d7a3bf858702 100644 --- a/clients/client-swf/commands/ListDomainsCommand.ts +++ b/clients/client-swf/commands/ListDomainsCommand.ts @@ -20,6 +20,40 @@ import { export type ListDomainsCommandInput = ListDomainsInput; export type ListDomainsCommandOutput = DomainInfos & __MetadataBearer; +/** + *

Returns the list of domains registered in the account. The results may be split into + * multiple pages. To retrieve subsequent pages, make the call again using the nextPageToken + * returned by the initial call.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains. The element must be set to + * arn:aws:swf::AccountID:domain/*, where AccountID is + * the account ID, with no dashes.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class ListDomainsCommand extends $Command< ListDomainsCommandInput, ListDomainsCommandOutput, @@ -34,6 +68,9 @@ export class ListDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/ListOpenWorkflowExecutionsCommand.ts b/clients/client-swf/commands/ListOpenWorkflowExecutionsCommand.ts index 65ae6a72b3fe9..6bf4f756cc46f 100644 --- a/clients/client-swf/commands/ListOpenWorkflowExecutionsCommand.ts +++ b/clients/client-swf/commands/ListOpenWorkflowExecutionsCommand.ts @@ -20,6 +20,56 @@ import { export type ListOpenWorkflowExecutionsCommandInput = ListOpenWorkflowExecutionsInput; export type ListOpenWorkflowExecutionsCommandOutput = WorkflowExecutionInfos & __MetadataBearer; +/** + *

Returns a list of open workflow executions in the specified domain that meet the + * filtering criteria. The results may be split into multiple pages. To retrieve subsequent + * pages, make the call again using the nextPageToken returned by the initial call.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * tagFilter.tag: String constraint. The key is + * swf:tagFilter.tag.

      + *
    • + *
    • + *

      + * typeFilter.name: String constraint. The key is + * swf:typeFilter.name.

      + *
    • + *
    • + *

      + * typeFilter.version: String constraint. The key is + * swf:typeFilter.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class ListOpenWorkflowExecutionsCommand extends $Command< ListOpenWorkflowExecutionsCommandInput, ListOpenWorkflowExecutionsCommandOutput, @@ -34,6 +84,9 @@ export class ListOpenWorkflowExecutionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/ListTagsForResourceCommand.ts b/clients/client-swf/commands/ListTagsForResourceCommand.ts index c38c70d12faef..b7b8fecd3c2e6 100644 --- a/clients/client-swf/commands/ListTagsForResourceCommand.ts +++ b/clients/client-swf/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceInput; export type ListTagsForResourceCommandOutput = ListTagsForResourceOutput & __MetadataBearer; +/** + *

List tags for a given domain.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/ListWorkflowTypesCommand.ts b/clients/client-swf/commands/ListWorkflowTypesCommand.ts index 2702bf8a4007f..21613c8963d17 100644 --- a/clients/client-swf/commands/ListWorkflowTypesCommand.ts +++ b/clients/client-swf/commands/ListWorkflowTypesCommand.ts @@ -20,6 +20,33 @@ import { export type ListWorkflowTypesCommandInput = ListWorkflowTypesInput; export type ListWorkflowTypesCommandOutput = WorkflowTypeInfos & __MetadataBearer; +/** + *

Returns information about workflow types in the specified domain. The results may be + * split into multiple pages that can be retrieved by making the call repeatedly.

+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class ListWorkflowTypesCommand extends $Command< ListWorkflowTypesCommandInput, ListWorkflowTypesCommandOutput, @@ -34,6 +61,9 @@ export class ListWorkflowTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/PollForActivityTaskCommand.ts b/clients/client-swf/commands/PollForActivityTaskCommand.ts index c03eb75850f62..d4701980c7165 100644 --- a/clients/client-swf/commands/PollForActivityTaskCommand.ts +++ b/clients/client-swf/commands/PollForActivityTaskCommand.ts @@ -20,6 +20,44 @@ import { export type PollForActivityTaskCommandInput = PollForActivityTaskInput; export type PollForActivityTaskCommandOutput = ActivityTask & __MetadataBearer; +/** + *

Used by workers to get an ActivityTask from the specified activity + * taskList. This initiates a long poll, where the service holds the HTTP + * connection open and responds as soon as a task becomes available. The maximum time the service + * holds on to the request before responding is 60 seconds. If no task is available within 60 + * seconds, the poll returns an empty result. An empty result, in this context, means that an + * ActivityTask is returned, but that the value of taskToken is an empty string. If a task is + * returned, the worker should use its type to identify and process it correctly.

+ * + *

Workers should set their client side socket timeout to at least 70 seconds (10 + * seconds higher than the maximum time service may hold the poll request).

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the taskList.name parameter by using a + * Condition element with the swf:taskList.name key to allow the + * action to access only certain task lists.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class PollForActivityTaskCommand extends $Command< PollForActivityTaskCommandInput, PollForActivityTaskCommandOutput, @@ -34,6 +72,9 @@ export class PollForActivityTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/PollForDecisionTaskCommand.ts b/clients/client-swf/commands/PollForDecisionTaskCommand.ts index 8368259fa418d..046a9fa289973 100644 --- a/clients/client-swf/commands/PollForDecisionTaskCommand.ts +++ b/clients/client-swf/commands/PollForDecisionTaskCommand.ts @@ -20,6 +20,56 @@ import { export type PollForDecisionTaskCommandInput = PollForDecisionTaskInput; export type PollForDecisionTaskCommandOutput = DecisionTask & __MetadataBearer; +/** + *

Used by deciders to get a DecisionTask from the specified decision + * taskList. A decision task may be returned for any open workflow execution that + * is using the specified task list. The task includes a paginated view of the history of the + * workflow execution. The decider should use the workflow type and the history to determine how + * to properly handle the task.

+ *

This action initiates a long poll, where the service holds the HTTP connection open and + * responds as soon a task becomes available. If no decision task is available in the specified + * task list before the timeout of 60 seconds expires, an empty result is returned. An empty + * result, in this context, means that a DecisionTask is returned, but that the value of + * taskToken is an empty string.

+ * + *

Deciders should set their client side socket timeout to at least 70 seconds (10 + * seconds higher than the timeout).

+ *
+ * + *

Because the number of workflow history events for a single workflow execution might + * be very large, the result returned might be split up across a number of pages. To retrieve + * subsequent pages, make additional calls to PollForDecisionTask using the + * nextPageToken returned by the initial call. Note that you do + * not call GetWorkflowExecutionHistory with this + * nextPageToken. Instead, call PollForDecisionTask + * again.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the taskList.name parameter by using a + * Condition element with the swf:taskList.name key to allow the + * action to access only certain task lists.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class PollForDecisionTaskCommand extends $Command< PollForDecisionTaskCommandInput, PollForDecisionTaskCommandOutput, @@ -34,6 +84,9 @@ export class PollForDecisionTaskCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RecordActivityTaskHeartbeatCommand.ts b/clients/client-swf/commands/RecordActivityTaskHeartbeatCommand.ts index 0cfc03d4f1f9e..6310d6a9ffee1 100644 --- a/clients/client-swf/commands/RecordActivityTaskHeartbeatCommand.ts +++ b/clients/client-swf/commands/RecordActivityTaskHeartbeatCommand.ts @@ -20,6 +20,56 @@ import { export type RecordActivityTaskHeartbeatCommandInput = RecordActivityTaskHeartbeatInput; export type RecordActivityTaskHeartbeatCommandOutput = ActivityTaskStatus & __MetadataBearer; +/** + *

Used by activity workers to report to the service that the ActivityTask represented by the specified taskToken is still making progress. The worker + * can also specify details of the progress, for example percent complete, using the + * details parameter. This action can also be used by the worker as a mechanism to + * check if cancellation is being requested for the activity task. If a cancellation is being + * attempted for the specified task, then the boolean cancelRequested flag returned + * by the service is set to true.

+ *

This action resets the taskHeartbeatTimeout clock. The + * taskHeartbeatTimeout is specified in RegisterActivityType.

+ *

This action doesn't in itself create an event in the workflow execution history. + * However, if the task times out, the workflow execution history contains a + * ActivityTaskTimedOut event that contains the information from the last + * heartbeat generated by the activity worker.

+ * + *

The taskStartToCloseTimeout of an activity type is the maximum duration + * of an activity task, regardless of the number of RecordActivityTaskHeartbeat requests received. The taskStartToCloseTimeout is also specified in RegisterActivityType.

+ *
+ * + *

This operation is only useful for long-lived activities to report liveliness of the + * task and to determine if a cancellation is being attempted.

+ *
+ * + *

If the cancelRequested flag returns true, a cancellation is + * being attempted. If the worker can cancel the activity, it should respond with RespondActivityTaskCanceled. Otherwise, it should ignore the cancellation + * request.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class RecordActivityTaskHeartbeatCommand extends $Command< RecordActivityTaskHeartbeatCommandInput, RecordActivityTaskHeartbeatCommandOutput, @@ -34,6 +84,9 @@ export class RecordActivityTaskHeartbeatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RegisterActivityTypeCommand.ts b/clients/client-swf/commands/RegisterActivityTypeCommand.ts index e8203c8f1443f..3b32f1bd9536e 100644 --- a/clients/client-swf/commands/RegisterActivityTypeCommand.ts +++ b/clients/client-swf/commands/RegisterActivityTypeCommand.ts @@ -20,6 +20,55 @@ import { export type RegisterActivityTypeCommandInput = RegisterActivityTypeInput; export type RegisterActivityTypeCommandOutput = __MetadataBearer; +/** + *

Registers a new activity type along with its configuration + * settings in the specified domain.

+ * + *

A TypeAlreadyExists fault is returned if the type already exists in the + * domain. You cannot change any configuration settings of the type after its registration, and + * it must be registered as a new version.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * defaultTaskList.name: String constraint. The key is + * swf:defaultTaskList.name.

      + *
    • + *
    • + *

      + * name: String constraint. The key is swf:name.

      + *
    • + *
    • + *

      + * version: String constraint. The key is + * swf:version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class RegisterActivityTypeCommand extends $Command< RegisterActivityTypeCommandInput, RegisterActivityTypeCommandOutput, @@ -34,6 +83,9 @@ export class RegisterActivityTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RegisterDomainCommand.ts b/clients/client-swf/commands/RegisterDomainCommand.ts index 7dc8ede56286e..db2cd8c72cafa 100644 --- a/clients/client-swf/commands/RegisterDomainCommand.ts +++ b/clients/client-swf/commands/RegisterDomainCommand.ts @@ -20,6 +20,32 @@ import { export type RegisterDomainCommandInput = RegisterDomainInput; export type RegisterDomainCommandOutput = __MetadataBearer; +/** + *

Registers a new domain.

+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    You cannot use an IAM policy to control domain access for this action. The name of + * the domain being registered is available as the resource of this action.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class RegisterDomainCommand extends $Command< RegisterDomainCommandInput, RegisterDomainCommandOutput, @@ -34,6 +60,9 @@ export class RegisterDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RegisterWorkflowTypeCommand.ts b/clients/client-swf/commands/RegisterWorkflowTypeCommand.ts index 5b8094d26aa02..fb9bebda5e457 100644 --- a/clients/client-swf/commands/RegisterWorkflowTypeCommand.ts +++ b/clients/client-swf/commands/RegisterWorkflowTypeCommand.ts @@ -20,6 +20,56 @@ import { export type RegisterWorkflowTypeCommandInput = RegisterWorkflowTypeInput; export type RegisterWorkflowTypeCommandOutput = __MetadataBearer; +/** + *

Registers a new workflow type and its configuration settings in + * the specified domain.

+ *

The retention period for the workflow history is set by the RegisterDomain action.

+ * + *

If the type already exists, then a TypeAlreadyExists fault is returned. + * You cannot change the configuration settings of a workflow type once it is registered and it + * must be registered as a new version.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * defaultTaskList.name: String constraint. The key is + * swf:defaultTaskList.name.

      + *
    • + *
    • + *

      + * name: String constraint. The key is swf:name.

      + *
    • + *
    • + *

      + * version: String constraint. The key is + * swf:version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class RegisterWorkflowTypeCommand extends $Command< RegisterWorkflowTypeCommandInput, RegisterWorkflowTypeCommandOutput, @@ -34,6 +84,9 @@ export class RegisterWorkflowTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RequestCancelWorkflowExecutionCommand.ts b/clients/client-swf/commands/RequestCancelWorkflowExecutionCommand.ts index 637f72c616ed5..64f45d4eed02b 100644 --- a/clients/client-swf/commands/RequestCancelWorkflowExecutionCommand.ts +++ b/clients/client-swf/commands/RequestCancelWorkflowExecutionCommand.ts @@ -20,6 +20,47 @@ import { export type RequestCancelWorkflowExecutionCommandInput = RequestCancelWorkflowExecutionInput; export type RequestCancelWorkflowExecutionCommandOutput = __MetadataBearer; +/** + *

Records a WorkflowExecutionCancelRequested event in the currently running + * workflow execution identified by the given domain, workflowId, and runId. This logically + * requests the cancellation of the workflow execution as a whole. It is up to the decider to + * take appropriate actions when it receives an execution history with this event.

+ * + * + *

If the runId isn't specified, the WorkflowExecutionCancelRequested event + * is recorded in the history of the current open workflow execution with the specified + * workflowId in the domain.

+ *
+ * + * + *

Because this action allows the workflow to properly clean up and gracefully close, it + * should be used instead of TerminateWorkflowExecution when + * possible.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class RequestCancelWorkflowExecutionCommand extends $Command< RequestCancelWorkflowExecutionCommandInput, RequestCancelWorkflowExecutionCommandOutput, @@ -34,6 +75,9 @@ export class RequestCancelWorkflowExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RespondActivityTaskCanceledCommand.ts b/clients/client-swf/commands/RespondActivityTaskCanceledCommand.ts index c0d29c5bdb5e6..350f5fd129375 100644 --- a/clients/client-swf/commands/RespondActivityTaskCanceledCommand.ts +++ b/clients/client-swf/commands/RespondActivityTaskCanceledCommand.ts @@ -20,6 +20,50 @@ import { export type RespondActivityTaskCanceledCommandInput = RespondActivityTaskCanceledInput; export type RespondActivityTaskCanceledCommandOutput = __MetadataBearer; +/** + *

Used by workers to tell the service that the ActivityTask identified + * by the taskToken was successfully canceled. Additional details can + * be provided using the details argument.

+ * + *

These details (if provided) appear in the + * ActivityTaskCanceled event added to the workflow history.

+ * + * + *

Only use this operation if the canceled flag of a RecordActivityTaskHeartbeat request returns true and if the + * activity can be safely undone or abandoned.

+ *
+ * + *

A task is considered open from the time that it is scheduled until it is closed. + * Therefore a task is reported as open while a worker is processing it. A task is closed after + * it has been specified in a call to RespondActivityTaskCompleted, + * RespondActivityTaskCanceled, RespondActivityTaskFailed, or the task has + * timed + * out.

+ * + *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class RespondActivityTaskCanceledCommand extends $Command< RespondActivityTaskCanceledCommandInput, RespondActivityTaskCanceledCommandOutput, @@ -34,6 +78,9 @@ export class RespondActivityTaskCanceledCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RespondActivityTaskCompletedCommand.ts b/clients/client-swf/commands/RespondActivityTaskCompletedCommand.ts index e4026010547de..27ee9a6ab2b1f 100644 --- a/clients/client-swf/commands/RespondActivityTaskCompletedCommand.ts +++ b/clients/client-swf/commands/RespondActivityTaskCompletedCommand.ts @@ -20,6 +20,48 @@ import { export type RespondActivityTaskCompletedCommandInput = RespondActivityTaskCompletedInput; export type RespondActivityTaskCompletedCommandOutput = __MetadataBearer; +/** + *

Used by workers to tell the service that the ActivityTask identified + * by the taskToken completed successfully with a result (if provided). + * The result appears in the ActivityTaskCompleted event in the + * workflow history.

+ * + * + *

If the requested task doesn't complete successfully, use RespondActivityTaskFailed instead. If the worker finds that the task is + * canceled through the canceled flag returned by RecordActivityTaskHeartbeat, it should cancel the task, clean up and then call + * RespondActivityTaskCanceled.

+ *
+ * + *

A task is considered open from the time that it is scheduled until it is closed. + * Therefore a task is reported as open while a worker is processing it. A task is closed after + * it has been specified in a call to RespondActivityTaskCompleted, RespondActivityTaskCanceled, RespondActivityTaskFailed, or the + * task has timed + * out.

+ * + *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class RespondActivityTaskCompletedCommand extends $Command< RespondActivityTaskCompletedCommandInput, RespondActivityTaskCompletedCommandOutput, @@ -34,6 +76,9 @@ export class RespondActivityTaskCompletedCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RespondActivityTaskFailedCommand.ts b/clients/client-swf/commands/RespondActivityTaskFailedCommand.ts index 174c51de14550..21ef11aa5a7ef 100644 --- a/clients/client-swf/commands/RespondActivityTaskFailedCommand.ts +++ b/clients/client-swf/commands/RespondActivityTaskFailedCommand.ts @@ -20,6 +20,41 @@ import { export type RespondActivityTaskFailedCommandInput = RespondActivityTaskFailedInput; export type RespondActivityTaskFailedCommandOutput = __MetadataBearer; +/** + *

Used by workers to tell the service that the ActivityTask identified + * by the taskToken has failed with reason (if specified). The + * reason and details appear in the ActivityTaskFailed + * event added to the workflow history.

+ * + *

A task is considered open from the time that it is scheduled until it is closed. + * Therefore a task is reported as open while a worker is processing it. A task is closed after + * it has been specified in a call to RespondActivityTaskCompleted, RespondActivityTaskCanceled, RespondActivityTaskFailed, or the task has timed + * out.

+ * + *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class RespondActivityTaskFailedCommand extends $Command< RespondActivityTaskFailedCommandInput, RespondActivityTaskFailedCommandOutput, @@ -34,6 +69,9 @@ export class RespondActivityTaskFailedCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/RespondDecisionTaskCompletedCommand.ts b/clients/client-swf/commands/RespondDecisionTaskCompletedCommand.ts index 54505f9fb3a3c..f40064f1206e3 100644 --- a/clients/client-swf/commands/RespondDecisionTaskCompletedCommand.ts +++ b/clients/client-swf/commands/RespondDecisionTaskCompletedCommand.ts @@ -20,6 +20,28 @@ import { export type RespondDecisionTaskCompletedCommandInput = RespondDecisionTaskCompletedInput; export type RespondDecisionTaskCompletedCommandOutput = __MetadataBearer; +/** + *

Used by deciders to tell the service that the DecisionTask identified + * by the taskToken has successfully completed. The decisions argument + * specifies the list of decisions made while processing the task.

+ * + *

A DecisionTaskCompleted event is added to the workflow history. The + * executionContext specified is attached to the event in the workflow execution + * history.

+ * + *

+ * Access Control + *

+ * + *

If an IAM policy grants permission to use RespondDecisionTaskCompleted, it + * can express permissions for the list of decisions in the decisions parameter. + * Each of the decisions has one or more parameters, much like a regular API call. To allow for + * policies to be as readable as possible, you can express permissions on decisions as if they + * were actual API calls, including applying conditions to some parameters. For more information, + * see Using + * IAM to Manage Access to Amazon SWF Workflows in the + * Amazon SWF Developer Guide.

+ */ export class RespondDecisionTaskCompletedCommand extends $Command< RespondDecisionTaskCompletedCommandInput, RespondDecisionTaskCompletedCommandOutput, @@ -34,6 +56,9 @@ export class RespondDecisionTaskCompletedCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/SignalWorkflowExecutionCommand.ts b/clients/client-swf/commands/SignalWorkflowExecutionCommand.ts index 4a02cbecfcc3c..e7c65d2511b5f 100644 --- a/clients/client-swf/commands/SignalWorkflowExecutionCommand.ts +++ b/clients/client-swf/commands/SignalWorkflowExecutionCommand.ts @@ -20,6 +20,47 @@ import { export type SignalWorkflowExecutionCommandInput = SignalWorkflowExecutionInput; export type SignalWorkflowExecutionCommandOutput = __MetadataBearer; +/** + *

Records a WorkflowExecutionSignaled event in the workflow execution + * history and creates a decision task for the workflow execution identified by the given domain, + * workflowId and runId. The event is recorded with the specified user defined signalName and + * input (if provided).

+ * + * + *

If a runId isn't specified, then the WorkflowExecutionSignaled event is + * recorded in the history of the current open workflow with the matching workflowId in the + * domain.

+ *
+ * + * + *

If the specified workflow execution isn't open, this method fails with + * UnknownResource.

+ *
+ * + *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class SignalWorkflowExecutionCommand extends $Command< SignalWorkflowExecutionCommandInput, SignalWorkflowExecutionCommandOutput, @@ -34,6 +75,9 @@ export class SignalWorkflowExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/StartWorkflowExecutionCommand.ts b/clients/client-swf/commands/StartWorkflowExecutionCommand.ts index 722fef91148dc..4ca692cc8de46 100644 --- a/clients/client-swf/commands/StartWorkflowExecutionCommand.ts +++ b/clients/client-swf/commands/StartWorkflowExecutionCommand.ts @@ -20,6 +20,74 @@ import { export type StartWorkflowExecutionCommandInput = StartWorkflowExecutionInput; export type StartWorkflowExecutionCommandOutput = Run & __MetadataBearer; +/** + *

Starts an execution of the workflow type in the specified domain using the provided + * workflowId and input data.

+ * + *

This action returns the newly started workflow execution.

+ * + *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * tagList.member.0: The key is swf:tagList.member.0.

      + *
    • + *
    • + *

      + * tagList.member.1: The key is swf:tagList.member.1.

      + *
    • + *
    • + *

      + * tagList.member.2: The key is swf:tagList.member.2.

      + *
    • + *
    • + *

      + * tagList.member.3: The key is swf:tagList.member.3.

      + *
    • + *
    • + *

      + * tagList.member.4: The key is swf:tagList.member.4.

      + *
    • + *
    • + *

      + * taskList: String constraint. The key is + * swf:taskList.name.

      + *
    • + *
    • + *

      + * workflowType.name: String constraint. The key is + * swf:workflowType.name.

      + *
    • + *
    • + *

      + * workflowType.version: String constraint. The key is + * swf:workflowType.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class StartWorkflowExecutionCommand extends $Command< StartWorkflowExecutionCommandInput, StartWorkflowExecutionCommandOutput, @@ -34,6 +102,9 @@ export class StartWorkflowExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/TagResourceCommand.ts b/clients/client-swf/commands/TagResourceCommand.ts index 39573dcafa952..1556a7ead53a1 100644 --- a/clients/client-swf/commands/TagResourceCommand.ts +++ b/clients/client-swf/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceInput; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Add a tag to a Amazon SWF domain.

+ * + *

Amazon SWF supports a maximum of 50 tags per resource.

+ *
+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/TerminateWorkflowExecutionCommand.ts b/clients/client-swf/commands/TerminateWorkflowExecutionCommand.ts index bcd583227582b..deb80627fe9d2 100644 --- a/clients/client-swf/commands/TerminateWorkflowExecutionCommand.ts +++ b/clients/client-swf/commands/TerminateWorkflowExecutionCommand.ts @@ -20,6 +20,52 @@ import { export type TerminateWorkflowExecutionCommandInput = TerminateWorkflowExecutionInput; export type TerminateWorkflowExecutionCommandOutput = __MetadataBearer; +/** + *

Records a WorkflowExecutionTerminated event and forces closure of the + * workflow execution identified by the given domain, runId, and workflowId. The child policy, + * registered with the workflow type or specified when starting this execution, is applied to any + * open child workflow executions of this workflow execution.

+ * + * + *

If the identified workflow execution was in progress, it is terminated + * immediately.

+ *
+ * + * + *

If a runId isn't specified, then the WorkflowExecutionTerminated event + * is recorded in the history of the current open workflow with the matching workflowId in the + * domain.

+ *
+ * + * + *

You should consider using RequestCancelWorkflowExecution action + * instead because it allows the workflow to gracefully close while TerminateWorkflowExecution doesn't.

+ *
+ * + *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class TerminateWorkflowExecutionCommand extends $Command< TerminateWorkflowExecutionCommandInput, TerminateWorkflowExecutionCommandOutput, @@ -34,6 +80,9 @@ export class TerminateWorkflowExecutionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/UndeprecateActivityTypeCommand.ts b/clients/client-swf/commands/UndeprecateActivityTypeCommand.ts index 4d2198e8541e5..3542a54937716 100644 --- a/clients/client-swf/commands/UndeprecateActivityTypeCommand.ts +++ b/clients/client-swf/commands/UndeprecateActivityTypeCommand.ts @@ -20,6 +20,50 @@ import { export type UndeprecateActivityTypeCommandInput = UndeprecateActivityTypeInput; export type UndeprecateActivityTypeCommandOutput = __MetadataBearer; +/** + *

Undeprecates a previously deprecated activity type. After an activity type has + * been undeprecated, you can create new tasks of that activity type.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * activityType.name: String constraint. The key is + * swf:activityType.name.

      + *
    • + *
    • + *

      + * activityType.version: String constraint. The key is + * swf:activityType.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class UndeprecateActivityTypeCommand extends $Command< UndeprecateActivityTypeCommandInput, UndeprecateActivityTypeCommandOutput, @@ -34,6 +78,9 @@ export class UndeprecateActivityTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/UndeprecateDomainCommand.ts b/clients/client-swf/commands/UndeprecateDomainCommand.ts index 26f87753f432e..3c174fb0e03aa 100644 --- a/clients/client-swf/commands/UndeprecateDomainCommand.ts +++ b/clients/client-swf/commands/UndeprecateDomainCommand.ts @@ -20,6 +20,37 @@ import { export type UndeprecateDomainCommandInput = UndeprecateDomainInput; export type UndeprecateDomainCommandOutput = __MetadataBearer; +/** + *

Undeprecates a previously deprecated domain. After a domain has been undeprecated it can be used + * to create new workflow executions or register new types.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    You cannot use an IAM policy to constrain this action's parameters.

    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class UndeprecateDomainCommand extends $Command< UndeprecateDomainCommandInput, UndeprecateDomainCommandOutput, @@ -34,6 +65,9 @@ export class UndeprecateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/UndeprecateWorkflowTypeCommand.ts b/clients/client-swf/commands/UndeprecateWorkflowTypeCommand.ts index 3109fcad2671f..5fd3f8094c5be 100644 --- a/clients/client-swf/commands/UndeprecateWorkflowTypeCommand.ts +++ b/clients/client-swf/commands/UndeprecateWorkflowTypeCommand.ts @@ -20,6 +20,50 @@ import { export type UndeprecateWorkflowTypeCommandInput = UndeprecateWorkflowTypeInput; export type UndeprecateWorkflowTypeCommandOutput = __MetadataBearer; +/** + *

Undeprecates a previously deprecated workflow type. After a workflow type has + * been undeprecated, you can create new executions of that type.

+ * + *

This operation is eventually consistent. The results are best effort and may not + * exactly reflect recent updates and changes.

+ *
+ *

+ * Access Control + *

+ *

You can use IAM policies to control this action's access to Amazon SWF resources as + * follows:

+ *
    + *
  • + *

    Use a Resource element with the domain name to limit the action to + * only specified domains.

    + *
  • + *
  • + *

    Use an Action element to allow or deny permission to call this + * action.

    + *
  • + *
  • + *

    Constrain the following parameters by using a Condition element with + * the appropriate keys.

    + *
      + *
    • + *

      + * workflowType.name: String constraint. The key is + * swf:workflowType.name.

      + *
    • + *
    • + *

      + * workflowType.version: String constraint. The key is + * swf:workflowType.version.

      + *
    • + *
    + *
  • + *
+ *

If the caller doesn't have sufficient permissions to invoke the action, or the + * parameter values fall outside the specified constraints, the action fails. The associated + * event attribute's cause parameter is set to OPERATION_NOT_PERMITTED. + * For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF + * Workflows in the Amazon SWF Developer Guide.

+ */ export class UndeprecateWorkflowTypeCommand extends $Command< UndeprecateWorkflowTypeCommandInput, UndeprecateWorkflowTypeCommandOutput, @@ -34,6 +78,9 @@ export class UndeprecateWorkflowTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/commands/UntagResourceCommand.ts b/clients/client-swf/commands/UntagResourceCommand.ts index d9a9244f5fe2f..ed1c4137783d9 100644 --- a/clients/client-swf/commands/UntagResourceCommand.ts +++ b/clients/client-swf/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceInput; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Remove a tag from a Amazon SWF domain.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SWFClientResolvedConfig, diff --git a/clients/client-swf/package.json b/clients/client-swf/package.json index ee8a208840dcd..b9e2319a30928 100644 --- a/clients/client-swf/package.json +++ b/clients/client-swf/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Swf Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-swf/pagination/GetWorkflowExecutionHistoryPaginator.ts b/clients/client-swf/pagination/GetWorkflowExecutionHistoryPaginator.ts index 8c1976e126e18..c7bb33d4bb361 100644 --- a/clients/client-swf/pagination/GetWorkflowExecutionHistoryPaginator.ts +++ b/clients/client-swf/pagination/GetWorkflowExecutionHistoryPaginator.ts @@ -8,6 +8,9 @@ import { import { SWFPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SWFClient, input: GetWorkflowExecutionHistoryCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetWorkflowExecutionHistoryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SWF, input: GetWorkflowExecutionHistoryCommandInput, diff --git a/clients/client-swf/pagination/ListActivityTypesPaginator.ts b/clients/client-swf/pagination/ListActivityTypesPaginator.ts index a8dc07173183a..13f83be793f24 100644 --- a/clients/client-swf/pagination/ListActivityTypesPaginator.ts +++ b/clients/client-swf/pagination/ListActivityTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { SWFPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SWFClient, input: ListActivityTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListActivityTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SWF, input: ListActivityTypesCommandInput, diff --git a/clients/client-swf/pagination/ListClosedWorkflowExecutionsPaginator.ts b/clients/client-swf/pagination/ListClosedWorkflowExecutionsPaginator.ts index c829b379d5868..2c08154f92f7b 100644 --- a/clients/client-swf/pagination/ListClosedWorkflowExecutionsPaginator.ts +++ b/clients/client-swf/pagination/ListClosedWorkflowExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SWFPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SWFClient, input: ListClosedWorkflowExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListClosedWorkflowExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SWF, input: ListClosedWorkflowExecutionsCommandInput, diff --git a/clients/client-swf/pagination/ListDomainsPaginator.ts b/clients/client-swf/pagination/ListDomainsPaginator.ts index ea187209a29ee..83c92c103493a 100644 --- a/clients/client-swf/pagination/ListDomainsPaginator.ts +++ b/clients/client-swf/pagination/ListDomainsPaginator.ts @@ -4,6 +4,9 @@ import { ListDomainsCommand, ListDomainsCommandInput, ListDomainsCommandOutput } import { SWFPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SWFClient, input: ListDomainsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SWF, input: ListDomainsCommandInput, diff --git a/clients/client-swf/pagination/ListOpenWorkflowExecutionsPaginator.ts b/clients/client-swf/pagination/ListOpenWorkflowExecutionsPaginator.ts index d93fa81c6a258..6628fe82f0643 100644 --- a/clients/client-swf/pagination/ListOpenWorkflowExecutionsPaginator.ts +++ b/clients/client-swf/pagination/ListOpenWorkflowExecutionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SWFPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SWFClient, input: ListOpenWorkflowExecutionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOpenWorkflowExecutionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SWF, input: ListOpenWorkflowExecutionsCommandInput, diff --git a/clients/client-swf/pagination/ListWorkflowTypesPaginator.ts b/clients/client-swf/pagination/ListWorkflowTypesPaginator.ts index f857fd7e85b68..cf2a4e0c74556 100644 --- a/clients/client-swf/pagination/ListWorkflowTypesPaginator.ts +++ b/clients/client-swf/pagination/ListWorkflowTypesPaginator.ts @@ -8,6 +8,9 @@ import { import { SWFPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SWFClient, input: ListWorkflowTypesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWorkflowTypesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SWF, input: ListWorkflowTypesCommandInput, diff --git a/clients/client-swf/pagination/PollForDecisionTaskPaginator.ts b/clients/client-swf/pagination/PollForDecisionTaskPaginator.ts index ff9bb4849a09a..27ebd0117031b 100644 --- a/clients/client-swf/pagination/PollForDecisionTaskPaginator.ts +++ b/clients/client-swf/pagination/PollForDecisionTaskPaginator.ts @@ -8,6 +8,9 @@ import { import { SWFPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SWFClient, input: PollForDecisionTaskCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new PollForDecisionTaskCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: SWF, input: PollForDecisionTaskCommandInput, diff --git a/clients/client-swf/runtimeConfig.browser.ts b/clients/client-swf/runtimeConfig.browser.ts index cf1166882cf9b..274007ddc5654 100644 --- a/clients/client-swf/runtimeConfig.browser.ts +++ b/clients/client-swf/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SWFClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-swf/runtimeConfig.native.ts b/clients/client-swf/runtimeConfig.native.ts index 3410b94583f22..ff1e21573c415 100644 --- a/clients/client-swf/runtimeConfig.native.ts +++ b/clients/client-swf/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SWFClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-swf/runtimeConfig.shared.ts b/clients/client-swf/runtimeConfig.shared.ts index 3a4f19b2ae930..7a071c97e26ae 100644 --- a/clients/client-swf/runtimeConfig.shared.ts +++ b/clients/client-swf/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2012-01-25", disableHostPrefix: false, diff --git a/clients/client-swf/runtimeConfig.ts b/clients/client-swf/runtimeConfig.ts index d666a0506cabb..3e1b30d286a8c 100644 --- a/clients/client-swf/runtimeConfig.ts +++ b/clients/client-swf/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SWFClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-swf/tsconfig.json b/clients/client-swf/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-swf/tsconfig.json +++ b/clients/client-swf/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-synthetics/commands/CreateCanaryCommand.ts b/clients/client-synthetics/commands/CreateCanaryCommand.ts index 4bc87e6b54660..8d9f6ec22e06a 100644 --- a/clients/client-synthetics/commands/CreateCanaryCommand.ts +++ b/clients/client-synthetics/commands/CreateCanaryCommand.ts @@ -20,6 +20,22 @@ import { export type CreateCanaryCommandInput = CreateCanaryRequest; export type CreateCanaryCommandOutput = CreateCanaryResponse & __MetadataBearer; +/** + *

Creates a canary. Canaries are scripts that monitor your endpoints and APIs from the + * outside-in. Canaries help you check the availability and latency of your web services and + * troubleshoot anomalies by investigating load time data, screenshots of the UI, logs, and + * metrics. You can set up a canary to run continuously or just once.

+ *

Do not use CreateCanary to modify an existing canary. Use UpdateCanary instead.

+ *

To create canaries, you must have the CloudWatchSyntheticsFullAccess policy. + * If you are creating a new IAM role for the canary, you also need the + * the iam:CreateRole, iam:CreatePolicy and + * iam:AttachRolePolicy permissions. For more information, see Necessary + * Roles and Permissions.

+ *

Do not include secrets or proprietary information in your canary names. The canary name + * makes up part of the Amazon Resource Name (ARN) for the canary, and the ARN is included in + * outbound calls over the internet. For more information, see Security + * Considerations for Synthetics Canaries.

+ */ export class CreateCanaryCommand extends $Command< CreateCanaryCommandInput, CreateCanaryCommandOutput, @@ -34,6 +50,9 @@ export class CreateCanaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/DeleteCanaryCommand.ts b/clients/client-synthetics/commands/DeleteCanaryCommand.ts index efb68e2e5267b..ffc8198db8cf6 100644 --- a/clients/client-synthetics/commands/DeleteCanaryCommand.ts +++ b/clients/client-synthetics/commands/DeleteCanaryCommand.ts @@ -20,6 +20,43 @@ import { export type DeleteCanaryCommandInput = DeleteCanaryRequest; export type DeleteCanaryCommandOutput = DeleteCanaryResponse & __MetadataBearer; +/** + *

Permanently deletes the specified canary.

+ *

When you delete a canary, resources used and created by the canary are not automatically deleted. After you delete a canary that you do not intend to + * use again, you + * should also delete the following:

+ *
    + *
  • + *

    The Lambda functions and layers used by this canary. These have the prefix + * cwsyn-MyCanaryName + * .

    + *
  • + *
  • + *

    The CloudWatch alarms created for this canary. These alarms have a name of + * Synthetics-SharpDrop-Alarm-MyCanaryName + * .

    + *
  • + *
  • + *

    Amazon S3 objects and buckets, such as the canary's artifact location.

    + *
  • + *
  • + *

    IAM roles created for the canary. If they were created in the console, these roles + * have the name + * role/service-role/CloudWatchSyntheticsRole-MyCanaryName + * .

    + *
  • + *
  • + *

    CloudWatch Logs log groups created for the canary. These logs groups have the name + * /aws/lambda/cwsyn-MyCanaryName + * .

    + *
  • + *
+ * + *

Before you delete a canary, you might want to use GetCanary to display + * the information about this canary. Make + * note of the information returned by this operation so that you can delete these resources + * after you delete the canary.

+ */ export class DeleteCanaryCommand extends $Command< DeleteCanaryCommandInput, DeleteCanaryCommandOutput, @@ -34,6 +71,9 @@ export class DeleteCanaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/DescribeCanariesCommand.ts b/clients/client-synthetics/commands/DescribeCanariesCommand.ts index c28920a6a2700..c1b93f42a5087 100644 --- a/clients/client-synthetics/commands/DescribeCanariesCommand.ts +++ b/clients/client-synthetics/commands/DescribeCanariesCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeCanariesCommandInput = DescribeCanariesRequest; export type DescribeCanariesCommandOutput = DescribeCanariesResponse & __MetadataBearer; +/** + *

This operation returns a list of the canaries in your account, along with full details + * about each canary.

+ *

This operation does not have resource-level authorization, so if a user is able to use + * DescribeCanaries, the user can see all of the canaries in the account. A + * deny policy can only be used to restrict access to all canaries. It cannot be used on + * specific resources.

+ */ export class DescribeCanariesCommand extends $Command< DescribeCanariesCommandInput, DescribeCanariesCommandOutput, @@ -34,6 +42,9 @@ export class DescribeCanariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/DescribeCanariesLastRunCommand.ts b/clients/client-synthetics/commands/DescribeCanariesLastRunCommand.ts index 86366900ee91e..fa081fa174cd5 100644 --- a/clients/client-synthetics/commands/DescribeCanariesLastRunCommand.ts +++ b/clients/client-synthetics/commands/DescribeCanariesLastRunCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCanariesLastRunCommandInput = DescribeCanariesLastRunRequest; export type DescribeCanariesLastRunCommandOutput = DescribeCanariesLastRunResponse & __MetadataBearer; +/** + *

Use this operation to see information from the most recent run of each canary that you have created.

+ */ export class DescribeCanariesLastRunCommand extends $Command< DescribeCanariesLastRunCommandInput, DescribeCanariesLastRunCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCanariesLastRunCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/DescribeRuntimeVersionsCommand.ts b/clients/client-synthetics/commands/DescribeRuntimeVersionsCommand.ts index 1fa6f4f28ee8f..123d15a01dfee 100644 --- a/clients/client-synthetics/commands/DescribeRuntimeVersionsCommand.ts +++ b/clients/client-synthetics/commands/DescribeRuntimeVersionsCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeRuntimeVersionsCommandInput = DescribeRuntimeVersionsRequest; export type DescribeRuntimeVersionsCommandOutput = DescribeRuntimeVersionsResponse & __MetadataBearer; +/** + *

Returns a list of Synthetics canary runtime versions. For more information, + * see + * Canary Runtime Versions.

+ */ export class DescribeRuntimeVersionsCommand extends $Command< DescribeRuntimeVersionsCommandInput, DescribeRuntimeVersionsCommandOutput, @@ -34,6 +39,9 @@ export class DescribeRuntimeVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/GetCanaryCommand.ts b/clients/client-synthetics/commands/GetCanaryCommand.ts index 13e34d3010144..f53bcda91e60f 100644 --- a/clients/client-synthetics/commands/GetCanaryCommand.ts +++ b/clients/client-synthetics/commands/GetCanaryCommand.ts @@ -20,6 +20,11 @@ import { export type GetCanaryCommandInput = GetCanaryRequest; export type GetCanaryCommandOutput = GetCanaryResponse & __MetadataBearer; +/** + *

Retrieves complete information about one canary. You must specify + * the name of the canary that you want. To get a list of canaries + * and their names, use DescribeCanaries.

+ */ export class GetCanaryCommand extends $Command< GetCanaryCommandInput, GetCanaryCommandOutput, @@ -34,6 +39,9 @@ export class GetCanaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/GetCanaryRunsCommand.ts b/clients/client-synthetics/commands/GetCanaryRunsCommand.ts index ae9431b848360..65b45d370f8f3 100644 --- a/clients/client-synthetics/commands/GetCanaryRunsCommand.ts +++ b/clients/client-synthetics/commands/GetCanaryRunsCommand.ts @@ -20,6 +20,9 @@ import { export type GetCanaryRunsCommandInput = GetCanaryRunsRequest; export type GetCanaryRunsCommandOutput = GetCanaryRunsResponse & __MetadataBearer; +/** + *

Retrieves a list of runs for a specified canary.

+ */ export class GetCanaryRunsCommand extends $Command< GetCanaryRunsCommandInput, GetCanaryRunsCommandOutput, @@ -34,6 +37,9 @@ export class GetCanaryRunsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/ListTagsForResourceCommand.ts b/clients/client-synthetics/commands/ListTagsForResourceCommand.ts index e1b8e0a9d503b..2a1f4a70a15c8 100644 --- a/clients/client-synthetics/commands/ListTagsForResourceCommand.ts +++ b/clients/client-synthetics/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Displays the tags associated with a canary.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/StartCanaryCommand.ts b/clients/client-synthetics/commands/StartCanaryCommand.ts index 66be7ab6a7c9c..23545f2b7ae14 100644 --- a/clients/client-synthetics/commands/StartCanaryCommand.ts +++ b/clients/client-synthetics/commands/StartCanaryCommand.ts @@ -20,6 +20,11 @@ import { export type StartCanaryCommandInput = StartCanaryRequest; export type StartCanaryCommandOutput = StartCanaryResponse & __MetadataBearer; +/** + *

Use this operation to run a canary that has already been created. + * The frequency of the canary runs is determined by the value of the canary's Schedule. To see a canary's schedule, + * use GetCanary.

+ */ export class StartCanaryCommand extends $Command< StartCanaryCommandInput, StartCanaryCommandOutput, @@ -34,6 +39,9 @@ export class StartCanaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/StopCanaryCommand.ts b/clients/client-synthetics/commands/StopCanaryCommand.ts index 975892356f469..7776713a3d2d3 100644 --- a/clients/client-synthetics/commands/StopCanaryCommand.ts +++ b/clients/client-synthetics/commands/StopCanaryCommand.ts @@ -20,6 +20,14 @@ import { export type StopCanaryCommandInput = StopCanaryRequest; export type StopCanaryCommandOutput = StopCanaryResponse & __MetadataBearer; +/** + *

Stops the canary to prevent all future runs. If the canary is currently running, + * Synthetics stops waiting for the current run of the specified canary to complete. The + * run that is in progress completes on its own, publishes metrics, and uploads artifacts, but + * it is not recorded in Synthetics as a completed run.

+ *

You can use StartCanary to start it running again + * with the canary’s current schedule at any point in the future.

+ */ export class StopCanaryCommand extends $Command< StopCanaryCommandInput, StopCanaryCommandOutput, @@ -34,6 +42,9 @@ export class StopCanaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/TagResourceCommand.ts b/clients/client-synthetics/commands/TagResourceCommand.ts index 6bc8ae3e50e7b..3c58dfd6ab1cc 100644 --- a/clients/client-synthetics/commands/TagResourceCommand.ts +++ b/clients/client-synthetics/commands/TagResourceCommand.ts @@ -20,6 +20,18 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Assigns one or more tags (key-value pairs) to the specified canary.

+ *

Tags can help you organize and categorize your + * resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with + * certain tag values.

+ *

Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of characters.

+ *

You can use the TagResource action with a canary that already has tags. If you specify a new tag key for the alarm, + * this tag is appended to the list of tags associated + * with the alarm. If you specify a tag key that is already associated with the alarm, the new tag value that you specify replaces + * the previous value for that tag.

+ *

You can associate as many as 50 tags with a canary.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +46,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/UntagResourceCommand.ts b/clients/client-synthetics/commands/UntagResourceCommand.ts index 5227a268a6a44..58cb457c32f55 100644 --- a/clients/client-synthetics/commands/UntagResourceCommand.ts +++ b/clients/client-synthetics/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from the specified canary.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/commands/UpdateCanaryCommand.ts b/clients/client-synthetics/commands/UpdateCanaryCommand.ts index 59f3bc1289acb..f9e228ad161c1 100644 --- a/clients/client-synthetics/commands/UpdateCanaryCommand.ts +++ b/clients/client-synthetics/commands/UpdateCanaryCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateCanaryCommandInput = UpdateCanaryRequest; export type UpdateCanaryCommandOutput = UpdateCanaryResponse & __MetadataBearer; +/** + *

Use this operation to change the settings of a canary that has + * already been created.

+ *

You can't use this operation to update the tags of an existing canary. To + * change the tags of an existing canary, use + * TagResource.

+ */ export class UpdateCanaryCommand extends $Command< UpdateCanaryCommandInput, UpdateCanaryCommandOutput, @@ -34,6 +41,9 @@ export class UpdateCanaryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: SyntheticsClientResolvedConfig, diff --git a/clients/client-synthetics/package.json b/clients/client-synthetics/package.json index de905f90543d3..6a2fa55a90fb7 100644 --- a/clients/client-synthetics/package.json +++ b/clients/client-synthetics/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Synthetics Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-synthetics/pagination/DescribeCanariesLastRunPaginator.ts b/clients/client-synthetics/pagination/DescribeCanariesLastRunPaginator.ts index 1da8c156cb683..93a11bea6b023 100644 --- a/clients/client-synthetics/pagination/DescribeCanariesLastRunPaginator.ts +++ b/clients/client-synthetics/pagination/DescribeCanariesLastRunPaginator.ts @@ -8,6 +8,9 @@ import { import { SyntheticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SyntheticsClient, input: DescribeCanariesLastRunCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCanariesLastRunCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Synthetics, input: DescribeCanariesLastRunCommandInput, diff --git a/clients/client-synthetics/pagination/DescribeCanariesPaginator.ts b/clients/client-synthetics/pagination/DescribeCanariesPaginator.ts index c7c4e33bbe6ac..fed23af658da7 100644 --- a/clients/client-synthetics/pagination/DescribeCanariesPaginator.ts +++ b/clients/client-synthetics/pagination/DescribeCanariesPaginator.ts @@ -8,6 +8,9 @@ import { import { SyntheticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SyntheticsClient, input: DescribeCanariesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeCanariesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Synthetics, input: DescribeCanariesCommandInput, diff --git a/clients/client-synthetics/pagination/DescribeRuntimeVersionsPaginator.ts b/clients/client-synthetics/pagination/DescribeRuntimeVersionsPaginator.ts index 0ee86980fccfd..356094f89d0ac 100644 --- a/clients/client-synthetics/pagination/DescribeRuntimeVersionsPaginator.ts +++ b/clients/client-synthetics/pagination/DescribeRuntimeVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { SyntheticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SyntheticsClient, input: DescribeRuntimeVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeRuntimeVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Synthetics, input: DescribeRuntimeVersionsCommandInput, diff --git a/clients/client-synthetics/pagination/GetCanaryRunsPaginator.ts b/clients/client-synthetics/pagination/GetCanaryRunsPaginator.ts index 5d0820fdd0cfe..91de48afe8b27 100644 --- a/clients/client-synthetics/pagination/GetCanaryRunsPaginator.ts +++ b/clients/client-synthetics/pagination/GetCanaryRunsPaginator.ts @@ -8,6 +8,9 @@ import { import { SyntheticsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: SyntheticsClient, input: GetCanaryRunsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetCanaryRunsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Synthetics, input: GetCanaryRunsCommandInput, diff --git a/clients/client-synthetics/runtimeConfig.browser.ts b/clients/client-synthetics/runtimeConfig.browser.ts index 407b557148298..fd65fc72e0a47 100644 --- a/clients/client-synthetics/runtimeConfig.browser.ts +++ b/clients/client-synthetics/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./SyntheticsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-synthetics/runtimeConfig.native.ts b/clients/client-synthetics/runtimeConfig.native.ts index ac4c5779fa1f5..e642b1b418320 100644 --- a/clients/client-synthetics/runtimeConfig.native.ts +++ b/clients/client-synthetics/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./SyntheticsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-synthetics/runtimeConfig.shared.ts b/clients/client-synthetics/runtimeConfig.shared.ts index 708dc7dd3719e..e775de70c889b 100644 --- a/clients/client-synthetics/runtimeConfig.shared.ts +++ b/clients/client-synthetics/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-11", disableHostPrefix: false, diff --git a/clients/client-synthetics/runtimeConfig.ts b/clients/client-synthetics/runtimeConfig.ts index 65b6d8b82e3dd..56db6357918bb 100644 --- a/clients/client-synthetics/runtimeConfig.ts +++ b/clients/client-synthetics/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./SyntheticsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-synthetics/tsconfig.json b/clients/client-synthetics/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-synthetics/tsconfig.json +++ b/clients/client-synthetics/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-textract/commands/AnalyzeDocumentCommand.ts b/clients/client-textract/commands/AnalyzeDocumentCommand.ts index 57f9255d4a5d2..7c67a2d5cb067 100644 --- a/clients/client-textract/commands/AnalyzeDocumentCommand.ts +++ b/clients/client-textract/commands/AnalyzeDocumentCommand.ts @@ -20,6 +20,39 @@ import { export type AnalyzeDocumentCommandInput = AnalyzeDocumentRequest; export type AnalyzeDocumentCommandOutput = AnalyzeDocumentResponse & __MetadataBearer; +/** + *

Analyzes an input document for relationships between detected items.

+ *

The types of information returned are as follows:

+ *
    + *
  • + *

    Form data (key-value pairs). The related information is returned in two Block objects, each of type KEY_VALUE_SET: a KEY + * Block object and a VALUE Block object. For example, + * Name: Ana Silva Carolina contains a key and value. + * Name: is the key. Ana Silva Carolina is + * the value.

    + *
  • + *
  • + *

    Table and table cell data. A TABLE Block object contains information about a detected table. A CELL + * Block object is returned for each cell in a table.

    + *
  • + *
  • + *

    Lines and words of text. A LINE Block object contains one or more WORD Block objects. + * All lines and words that are detected in the document are returned (including text that doesn't have a + * relationship with the value of FeatureTypes).

    + *
  • + *
+ * + *

Selection elements such as check boxes and option buttons (radio buttons) can be detected in form data and in tables. + * A SELECTION_ELEMENT Block object contains information about a selection element, + * including the selection status.

+ *

You can choose which type of analysis to perform by specifying the FeatureTypes list. + *

+ *

The output is returned in a list of Block objects.

+ *

+ * AnalyzeDocument is a synchronous operation. To analyze documents + * asynchronously, use StartDocumentAnalysis.

+ *

For more information, see Document Text Analysis.

+ */ export class AnalyzeDocumentCommand extends $Command< AnalyzeDocumentCommandInput, AnalyzeDocumentCommandOutput, @@ -34,6 +67,9 @@ export class AnalyzeDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TextractClientResolvedConfig, diff --git a/clients/client-textract/commands/DetectDocumentTextCommand.ts b/clients/client-textract/commands/DetectDocumentTextCommand.ts index 5a732e5b6aa29..33d65255b7776 100644 --- a/clients/client-textract/commands/DetectDocumentTextCommand.ts +++ b/clients/client-textract/commands/DetectDocumentTextCommand.ts @@ -20,6 +20,19 @@ import { export type DetectDocumentTextCommandInput = DetectDocumentTextRequest; export type DetectDocumentTextCommandOutput = DetectDocumentTextResponse & __MetadataBearer; +/** + *

Detects text in the input document. Amazon Textract can detect lines of text and the + * words that make up a line of text. The input document must be an image in JPEG or PNG + * format. DetectDocumentText returns the detected text in an array of Block objects.

+ *

Each document page has as an associated Block of type PAGE. Each PAGE Block object + * is the parent of LINE Block objects that represent the lines of detected text on a page. A LINE Block object is + * a parent for each word that makes up the line. Words are represented by Block objects of type WORD.

+ * + *

+ * DetectDocumentText is a synchronous operation. To analyze documents + * asynchronously, use StartDocumentTextDetection.

+ *

For more information, see Document Text Detection.

+ */ export class DetectDocumentTextCommand extends $Command< DetectDocumentTextCommandInput, DetectDocumentTextCommandOutput, @@ -34,6 +47,9 @@ export class DetectDocumentTextCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TextractClientResolvedConfig, diff --git a/clients/client-textract/commands/GetDocumentAnalysisCommand.ts b/clients/client-textract/commands/GetDocumentAnalysisCommand.ts index 1758dd42c8ec7..058536e00973b 100644 --- a/clients/client-textract/commands/GetDocumentAnalysisCommand.ts +++ b/clients/client-textract/commands/GetDocumentAnalysisCommand.ts @@ -20,6 +20,53 @@ import { export type GetDocumentAnalysisCommandInput = GetDocumentAnalysisRequest; export type GetDocumentAnalysisCommandOutput = GetDocumentAnalysisResponse & __MetadataBearer; +/** + *

Gets the results for an Amazon Textract asynchronous operation that analyzes text in a document.

+ *

You start asynchronous text analysis by calling StartDocumentAnalysis, which returns a job identifier + * (JobId). When the text analysis operation finishes, Amazon Textract publishes a + * completion status to the Amazon Simple Notification Service (Amazon SNS) topic that's registered in the initial call to + * StartDocumentAnalysis. To get the results of the text-detection operation, + * first check that the status value published to the Amazon SNS topic is SUCCEEDED. + * If so, call GetDocumentAnalysis, and pass the job identifier + * (JobId) from the initial call to StartDocumentAnalysis.

+ *

+ * GetDocumentAnalysis returns an array of Block objects. The following + * types of information are returned:

+ *
    + *
  • + *

    Form data (key-value pairs). The related information is returned in two Block objects, each of type KEY_VALUE_SET: a KEY + * Block object and a VALUE Block object. For example, + * Name: Ana Silva Carolina contains a key and value. + * Name: is the key. Ana Silva Carolina is + * the value.

    + *
  • + *
  • + *

    Table and table cell data. A TABLE Block object contains information about a detected table. A CELL + * Block object is returned for each cell in a table.

    + *
  • + *
  • + *

    Lines and words of text. A LINE Block object contains one or more WORD Block objects. + * All lines and words that are detected in the document are returned (including text that doesn't have a + * relationship with the value of the StartDocumentAnalysis + * FeatureTypes input parameter).

    + *
  • + *
+ * + *

Selection elements such as check boxes and option buttons (radio buttons) can be detected in form data and in tables. + * A SELECTION_ELEMENT Block object contains information about a selection element, + * including the selection status.

+ * + * + * + *

Use the MaxResults parameter to limit the number of blocks that are + * returned. If there are more results than specified in MaxResults, the value of + * NextToken in the operation response contains a pagination token for getting + * the next set of results. To get the next page of results, call + * GetDocumentAnalysis, and populate the NextToken request + * parameter with the token value that's returned from the previous call to + * GetDocumentAnalysis.

+ *

For more information, see Document Text Analysis.

+ */ export class GetDocumentAnalysisCommand extends $Command< GetDocumentAnalysisCommandInput, GetDocumentAnalysisCommandOutput, @@ -34,6 +81,9 @@ export class GetDocumentAnalysisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TextractClientResolvedConfig, diff --git a/clients/client-textract/commands/GetDocumentTextDetectionCommand.ts b/clients/client-textract/commands/GetDocumentTextDetectionCommand.ts index 0d19c61c73787..a9a29071cc6a1 100644 --- a/clients/client-textract/commands/GetDocumentTextDetectionCommand.ts +++ b/clients/client-textract/commands/GetDocumentTextDetectionCommand.ts @@ -20,6 +20,33 @@ import { export type GetDocumentTextDetectionCommandInput = GetDocumentTextDetectionRequest; export type GetDocumentTextDetectionCommandOutput = GetDocumentTextDetectionResponse & __MetadataBearer; +/** + *

Gets the results for an Amazon Textract asynchronous operation that detects text in a document. + * Amazon Textract can detect lines of text and the words that make up a line of text.

+ *

You start asynchronous text detection by calling StartDocumentTextDetection, which returns a job identifier + * (JobId). When the text detection operation finishes, Amazon Textract publishes a + * completion status to the Amazon Simple Notification Service (Amazon SNS) topic that's registered in the initial call to + * StartDocumentTextDetection. To get the results of the text-detection + * operation, first check that the status value published to the Amazon SNS topic is + * SUCCEEDED. If so, call GetDocumentTextDetection, and pass the + * job identifier (JobId) from the initial call to + * StartDocumentTextDetection.

+ *

+ * GetDocumentTextDetection returns an array of Block + * objects.

+ *

Each document page has as an associated Block of type PAGE. Each PAGE Block object + * is the parent of LINE Block objects that represent the lines of detected text on a page. A LINE Block object is + * a parent for each word that makes up the line. Words are represented by Block objects of type WORD.

+ * + *

Use the MaxResults parameter to limit the number of blocks that are returned. If there + * are more results than specified in MaxResults, the value of + * NextToken in the operation response contains a pagination token for getting + * the next set of results. To get the next page of results, call + * GetDocumentTextDetection, and populate the NextToken request + * parameter with the token value that's returned from the previous call to + * GetDocumentTextDetection.

+ *

For more information, see Document Text Detection.

+ */ export class GetDocumentTextDetectionCommand extends $Command< GetDocumentTextDetectionCommandInput, GetDocumentTextDetectionCommandOutput, @@ -34,6 +61,9 @@ export class GetDocumentTextDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TextractClientResolvedConfig, diff --git a/clients/client-textract/commands/StartDocumentAnalysisCommand.ts b/clients/client-textract/commands/StartDocumentAnalysisCommand.ts index 30832f1ef0c8f..883bb98199c43 100644 --- a/clients/client-textract/commands/StartDocumentAnalysisCommand.ts +++ b/clients/client-textract/commands/StartDocumentAnalysisCommand.ts @@ -20,6 +20,26 @@ import { export type StartDocumentAnalysisCommandInput = StartDocumentAnalysisRequest; export type StartDocumentAnalysisCommandOutput = StartDocumentAnalysisResponse & __MetadataBearer; +/** + *

Starts the asynchronous analysis of an input document for relationships between detected + * items such as key-value pairs, tables, and selection elements.

+ * + *

+ * StartDocumentAnalysis can analyze text in documents that are in JPEG, PNG, and PDF format. The + * documents are stored in an Amazon S3 bucket. Use DocumentLocation to specify the bucket name and file name + * of the document. + *

+ *

+ * StartDocumentAnalysis returns a job identifier + * (JobId) that you use to get the results of the operation. When text + * analysis is finished, Amazon Textract publishes a completion status to the Amazon Simple Notification Service (Amazon SNS) + * topic that you specify in NotificationChannel. To get the results of the text + * analysis operation, first check that the status value published to the Amazon SNS topic is + * SUCCEEDED. If so, call GetDocumentAnalysis, and pass + * the job identifier (JobId) from the initial call to + * StartDocumentAnalysis.

+ *

For more information, see Document Text Analysis.

+ */ export class StartDocumentAnalysisCommand extends $Command< StartDocumentAnalysisCommandInput, StartDocumentAnalysisCommandOutput, @@ -34,6 +54,9 @@ export class StartDocumentAnalysisCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TextractClientResolvedConfig, diff --git a/clients/client-textract/commands/StartDocumentTextDetectionCommand.ts b/clients/client-textract/commands/StartDocumentTextDetectionCommand.ts index dd178af71dc5b..7022db4f5ba0d 100644 --- a/clients/client-textract/commands/StartDocumentTextDetectionCommand.ts +++ b/clients/client-textract/commands/StartDocumentTextDetectionCommand.ts @@ -20,6 +20,25 @@ import { export type StartDocumentTextDetectionCommandInput = StartDocumentTextDetectionRequest; export type StartDocumentTextDetectionCommandOutput = StartDocumentTextDetectionResponse & __MetadataBearer; +/** + *

Starts the asynchronous detection of text in a document. Amazon Textract can detect lines of + * text and the words that make up a line of text.

+ *

+ * StartDocumentTextDetection can analyze text in documents that are in JPEG, PNG, and PDF format. The + * documents are stored in an Amazon S3 bucket. Use DocumentLocation to specify the bucket name and file name + * of the document. + *

+ *

+ * StartTextDetection returns a job identifier + * (JobId) that you use to get the results of the operation. When text + * detection is finished, Amazon Textract publishes a completion status to the Amazon Simple Notification Service (Amazon SNS) + * topic that you specify in NotificationChannel. To get the results of the text + * detection operation, first check that the status value published to the Amazon SNS topic is + * SUCCEEDED. If so, call GetDocumentTextDetection, and + * pass the job identifier (JobId) from the initial call to + * StartDocumentTextDetection.

+ *

For more information, see Document Text Detection.

+ */ export class StartDocumentTextDetectionCommand extends $Command< StartDocumentTextDetectionCommandInput, StartDocumentTextDetectionCommandOutput, @@ -34,6 +53,9 @@ export class StartDocumentTextDetectionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TextractClientResolvedConfig, diff --git a/clients/client-textract/package.json b/clients/client-textract/package.json index 130daf12d19ce..edfae672241a7 100644 --- a/clients/client-textract/package.json +++ b/clients/client-textract/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Textract Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-textract/runtimeConfig.browser.ts b/clients/client-textract/runtimeConfig.browser.ts index 2f5405a12bb88..5c342938619b2 100644 --- a/clients/client-textract/runtimeConfig.browser.ts +++ b/clients/client-textract/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./TextractClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-textract/runtimeConfig.native.ts b/clients/client-textract/runtimeConfig.native.ts index 8ff8677e5e5c8..35710800d3e59 100644 --- a/clients/client-textract/runtimeConfig.native.ts +++ b/clients/client-textract/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./TextractClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-textract/runtimeConfig.shared.ts b/clients/client-textract/runtimeConfig.shared.ts index 4110d80d92fc2..90e083623a0db 100644 --- a/clients/client-textract/runtimeConfig.shared.ts +++ b/clients/client-textract/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-06-27", disableHostPrefix: false, diff --git a/clients/client-textract/runtimeConfig.ts b/clients/client-textract/runtimeConfig.ts index b4981bf7da0fb..6205f94126f6e 100644 --- a/clients/client-textract/runtimeConfig.ts +++ b/clients/client-textract/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./TextractClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-textract/tsconfig.json b/clients/client-textract/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-textract/tsconfig.json +++ b/clients/client-textract/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-timestream-query/commands/CancelQueryCommand.ts b/clients/client-timestream-query/commands/CancelQueryCommand.ts index 80a3fe17c81e3..c9b8ddfd2f1cd 100644 --- a/clients/client-timestream-query/commands/CancelQueryCommand.ts +++ b/clients/client-timestream-query/commands/CancelQueryCommand.ts @@ -20,6 +20,13 @@ import { export type CancelQueryCommandInput = CancelQueryRequest; export type CancelQueryCommandOutput = CancelQueryResponse & __MetadataBearer; +/** + *

+ * Cancels a query that has been issued. Cancellation is guaranteed only if the query has not + * completed execution before the cancellation request was issued. Because cancellation is an idempotent operation, + * subsequent cancellation requests will return a CancellationMessage, indicating that the query has already been canceled. + *

+ */ export class CancelQueryCommand extends $Command< CancelQueryCommandInput, CancelQueryCommandOutput, @@ -34,6 +41,9 @@ export class CancelQueryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamQueryClientResolvedConfig, diff --git a/clients/client-timestream-query/commands/DescribeEndpointsCommand.ts b/clients/client-timestream-query/commands/DescribeEndpointsCommand.ts index ce5cc67c58d40..09ca9bb2d5e74 100644 --- a/clients/client-timestream-query/commands/DescribeEndpointsCommand.ts +++ b/clients/client-timestream-query/commands/DescribeEndpointsCommand.ts @@ -20,6 +20,23 @@ import { export type DescribeEndpointsCommandInput = DescribeEndpointsRequest; export type DescribeEndpointsCommandOutput = DescribeEndpointsResponse & __MetadataBearer; +/** + *

DescribeEndpoints returns a list of available endpoints to make Timestream API calls against. + * This API is available through both Write and Query.

+ *

Because Timestream’s SDKs are designed to transparently work with the service’s architecture, + * including the management and mapping of the service endpoints, + * it is not recommended that you use this API unless:

+ *
    + *
  • + *

    Your application uses a programming language that does not yet have SDK support

    + *
  • + *
  • + *

    You require better control over the client-side implementation

    + *
  • + *
+ *

For detailed information on how to use DescribeEndpoints, + * see The Endpoint Discovery Pattern and REST APIs.

+ */ export class DescribeEndpointsCommand extends $Command< DescribeEndpointsCommandInput, DescribeEndpointsCommandOutput, @@ -34,6 +51,9 @@ export class DescribeEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamQueryClientResolvedConfig, diff --git a/clients/client-timestream-query/commands/QueryCommand.ts b/clients/client-timestream-query/commands/QueryCommand.ts index 6396d7aa5b657..65476ac70b321 100644 --- a/clients/client-timestream-query/commands/QueryCommand.ts +++ b/clients/client-timestream-query/commands/QueryCommand.ts @@ -17,6 +17,11 @@ import { export type QueryCommandInput = QueryRequest; export type QueryCommandOutput = QueryResponse & __MetadataBearer; +/** + *

+ * Query is a synchronous operation that enables you to execute a query. Query will timeout after 60 seconds. You must update the default timeout in the SDK to support a timeout of 60 seconds. The result set will be truncated to 1MB. Service quotas apply. For more information, see Quotas in the Timestream Developer Guide. + *

+ */ export class QueryCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +32,9 @@ export class QueryCommand extends $Command, configuration: TimestreamQueryClientResolvedConfig, diff --git a/clients/client-timestream-query/package.json b/clients/client-timestream-query/package.json index 6af43d73a6e4a..9b287d3583d27 100644 --- a/clients/client-timestream-query/package.json +++ b/clients/client-timestream-query/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Timestream Query Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-timestream-query/pagination/QueryPaginator.ts b/clients/client-timestream-query/pagination/QueryPaginator.ts index fa9f8340e8786..9e0e2d96e9188 100644 --- a/clients/client-timestream-query/pagination/QueryPaginator.ts +++ b/clients/client-timestream-query/pagination/QueryPaginator.ts @@ -4,6 +4,9 @@ import { QueryCommand, QueryCommandInput, QueryCommandOutput } from "../commands import { TimestreamQueryPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TimestreamQueryClient, input: QueryCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new QueryCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: TimestreamQuery, input: QueryCommandInput, diff --git a/clients/client-timestream-query/runtimeConfig.browser.ts b/clients/client-timestream-query/runtimeConfig.browser.ts index 2f1af12296ec4..bfbc11bbaed83 100644 --- a/clients/client-timestream-query/runtimeConfig.browser.ts +++ b/clients/client-timestream-query/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./TimestreamQueryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-timestream-query/runtimeConfig.native.ts b/clients/client-timestream-query/runtimeConfig.native.ts index fc90f9668aa8d..f2dad327a3607 100644 --- a/clients/client-timestream-query/runtimeConfig.native.ts +++ b/clients/client-timestream-query/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./TimestreamQueryClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-timestream-query/runtimeConfig.shared.ts b/clients/client-timestream-query/runtimeConfig.shared.ts index 11c8c9cb6a3c9..2b1062fc96b34 100644 --- a/clients/client-timestream-query/runtimeConfig.shared.ts +++ b/clients/client-timestream-query/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-01", disableHostPrefix: false, diff --git a/clients/client-timestream-query/runtimeConfig.ts b/clients/client-timestream-query/runtimeConfig.ts index 6e28c3389b25d..796e40438c88a 100644 --- a/clients/client-timestream-query/runtimeConfig.ts +++ b/clients/client-timestream-query/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./TimestreamQueryClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-timestream-query/tsconfig.json b/clients/client-timestream-query/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-timestream-query/tsconfig.json +++ b/clients/client-timestream-query/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-timestream-write/commands/CreateDatabaseCommand.ts b/clients/client-timestream-write/commands/CreateDatabaseCommand.ts index 62dadb9d24fdf..120b7b9885ca8 100644 --- a/clients/client-timestream-write/commands/CreateDatabaseCommand.ts +++ b/clients/client-timestream-write/commands/CreateDatabaseCommand.ts @@ -20,6 +20,12 @@ import { export type CreateDatabaseCommandInput = CreateDatabaseRequest; export type CreateDatabaseCommandOutput = CreateDatabaseResponse & __MetadataBearer; +/** + *

Creates a new Timestream database. If the KMS key is not specified, the database will be encrypted with a Timestream managed KMS key located in your account. + * Refer to AWS managed KMS keys for more info. + * Service quotas apply. For more information, see Access Management in the Timestream Developer Guide. + *

+ */ export class CreateDatabaseCommand extends $Command< CreateDatabaseCommandInput, CreateDatabaseCommandOutput, @@ -34,6 +40,9 @@ export class CreateDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/CreateTableCommand.ts b/clients/client-timestream-write/commands/CreateTableCommand.ts index 8de57bb2ef7dd..30873a3440d7f 100644 --- a/clients/client-timestream-write/commands/CreateTableCommand.ts +++ b/clients/client-timestream-write/commands/CreateTableCommand.ts @@ -20,6 +20,16 @@ import { export type CreateTableCommandInput = CreateTableRequest; export type CreateTableCommandOutput = CreateTableResponse & __MetadataBearer; +/** + *

The CreateTable operation adds a new table to an existing database in your account. In an AWS account, + * table names must be at least unique within each Region if they are in the same database. + * You may have identical table names in the same Region if the tables are in seperate databases. + * While creating the table, you must specify the table name, database name, + * and the retention properties. + * Service quotas apply. For more information, see Access Management + * in the Timestream Developer Guide. + *

+ */ export class CreateTableCommand extends $Command< CreateTableCommandInput, CreateTableCommandOutput, @@ -34,6 +44,9 @@ export class CreateTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/DeleteDatabaseCommand.ts b/clients/client-timestream-write/commands/DeleteDatabaseCommand.ts index d5114cb5382d7..6d7e0f344a5b6 100644 --- a/clients/client-timestream-write/commands/DeleteDatabaseCommand.ts +++ b/clients/client-timestream-write/commands/DeleteDatabaseCommand.ts @@ -20,6 +20,14 @@ import { export type DeleteDatabaseCommandInput = DeleteDatabaseRequest; export type DeleteDatabaseCommandOutput = __MetadataBearer; +/** + *

Deletes a given Timestream database. This is an irreversible operation. + * After a database is deleted, the time series data from its tables cannot be recovered. + *

+ * + *

All tables in the database must be deleted first, or a ValidationException error will be thrown. + *

+ */ export class DeleteDatabaseCommand extends $Command< DeleteDatabaseCommandInput, DeleteDatabaseCommandOutput, @@ -34,6 +42,9 @@ export class DeleteDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/DeleteTableCommand.ts b/clients/client-timestream-write/commands/DeleteTableCommand.ts index c50b2169cacde..208d8ebdcd26a 100644 --- a/clients/client-timestream-write/commands/DeleteTableCommand.ts +++ b/clients/client-timestream-write/commands/DeleteTableCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteTableCommandInput = DeleteTableRequest; export type DeleteTableCommandOutput = __MetadataBearer; +/** + *

Deletes a given Timestream table. This is an irreversible operation. + * After a Timestream database table is deleted, the time series data stored in + * the table cannot be recovered. + *

+ */ export class DeleteTableCommand extends $Command< DeleteTableCommandInput, DeleteTableCommandOutput, @@ -34,6 +40,9 @@ export class DeleteTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/DescribeDatabaseCommand.ts b/clients/client-timestream-write/commands/DescribeDatabaseCommand.ts index 0fe5f57a6cf4a..471ff91007bd9 100644 --- a/clients/client-timestream-write/commands/DescribeDatabaseCommand.ts +++ b/clients/client-timestream-write/commands/DescribeDatabaseCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeDatabaseCommandInput = DescribeDatabaseRequest; export type DescribeDatabaseCommandOutput = DescribeDatabaseResponse & __MetadataBearer; +/** + *

Returns information about the database, including the database name, time that the database was created, + * and the total number of tables found within the database. + * Service quotas apply. For more information, see Access Management in the Timestream Developer Guide.

+ */ export class DescribeDatabaseCommand extends $Command< DescribeDatabaseCommandInput, DescribeDatabaseCommandOutput, @@ -34,6 +39,9 @@ export class DescribeDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/DescribeEndpointsCommand.ts b/clients/client-timestream-write/commands/DescribeEndpointsCommand.ts index eff89965f170d..f5c215f78fe33 100644 --- a/clients/client-timestream-write/commands/DescribeEndpointsCommand.ts +++ b/clients/client-timestream-write/commands/DescribeEndpointsCommand.ts @@ -20,6 +20,22 @@ import { export type DescribeEndpointsCommandInput = DescribeEndpointsRequest; export type DescribeEndpointsCommandOutput = DescribeEndpointsResponse & __MetadataBearer; +/** + *

DescribeEndpoints returns a list of available endpoints to make Timestream API calls against. This API is available through both Write and Query.

+ *

Because Timestream’s SDKs are designed to transparently work with the service’s architecture, + * including the management and mapping of the service endpoints, + * it is not recommended that you use this API unless:

+ *
    + *
  • + *

    Your application uses a programming language that does not yet have SDK support

    + *
  • + *
  • + *

    You require better control over the client-side implementation

    + *
  • + *
+ *

For detailed information on how to use DescribeEndpoints, + * see The Endpoint Discovery Pattern and REST APIs.

+ */ export class DescribeEndpointsCommand extends $Command< DescribeEndpointsCommandInput, DescribeEndpointsCommandOutput, @@ -34,6 +50,9 @@ export class DescribeEndpointsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/DescribeTableCommand.ts b/clients/client-timestream-write/commands/DescribeTableCommand.ts index 3df751d6706a6..d8b6584e15fe7 100644 --- a/clients/client-timestream-write/commands/DescribeTableCommand.ts +++ b/clients/client-timestream-write/commands/DescribeTableCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeTableCommandInput = DescribeTableRequest; export type DescribeTableCommandOutput = DescribeTableResponse & __MetadataBearer; +/** + *

Returns information about the table, including the table name, database name, + * retention duration of the memory store and the magnetic store. + * Service quotas apply. For more information, see Access Management in the Timestream Developer Guide. + *

+ */ export class DescribeTableCommand extends $Command< DescribeTableCommandInput, DescribeTableCommandOutput, @@ -34,6 +40,9 @@ export class DescribeTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/ListDatabasesCommand.ts b/clients/client-timestream-write/commands/ListDatabasesCommand.ts index 60d6e8ee9a1d6..0274f9d9a3f2c 100644 --- a/clients/client-timestream-write/commands/ListDatabasesCommand.ts +++ b/clients/client-timestream-write/commands/ListDatabasesCommand.ts @@ -20,6 +20,11 @@ import { export type ListDatabasesCommandInput = ListDatabasesRequest; export type ListDatabasesCommandOutput = ListDatabasesResponse & __MetadataBearer; +/** + *

Returns a list of your Timestream databases. + * Service quotas apply. For more information, see Access Management in the Timestream Developer Guide. + *

+ */ export class ListDatabasesCommand extends $Command< ListDatabasesCommandInput, ListDatabasesCommandOutput, @@ -34,6 +39,9 @@ export class ListDatabasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/ListTablesCommand.ts b/clients/client-timestream-write/commands/ListTablesCommand.ts index b3c36e01ab9ac..9cd8c12c398fc 100644 --- a/clients/client-timestream-write/commands/ListTablesCommand.ts +++ b/clients/client-timestream-write/commands/ListTablesCommand.ts @@ -20,6 +20,10 @@ import { export type ListTablesCommandInput = ListTablesRequest; export type ListTablesCommandOutput = ListTablesResponse & __MetadataBearer; +/** + *

A list of tables, along with the name, status and retention properties of each table. + *

+ */ export class ListTablesCommand extends $Command< ListTablesCommandInput, ListTablesCommandOutput, @@ -34,6 +38,9 @@ export class ListTablesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/ListTagsForResourceCommand.ts b/clients/client-timestream-write/commands/ListTagsForResourceCommand.ts index 272cd0ee14313..3f2707b995e87 100644 --- a/clients/client-timestream-write/commands/ListTagsForResourceCommand.ts +++ b/clients/client-timestream-write/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,11 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

+ * List all tags on a Timestream resource. + *

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +39,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/TagResourceCommand.ts b/clients/client-timestream-write/commands/TagResourceCommand.ts index 7936f753ce24b..2b36621008f6e 100644 --- a/clients/client-timestream-write/commands/TagResourceCommand.ts +++ b/clients/client-timestream-write/commands/TagResourceCommand.ts @@ -20,6 +20,13 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

+ * Associate a set of tags with a Timestream resource. You can then activate + * these user-defined tags so that they appear on the Billing and Cost + * Management console for cost allocation tracking. + *

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +41,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/UntagResourceCommand.ts b/clients/client-timestream-write/commands/UntagResourceCommand.ts index fd89ff9d681a8..9aa8512ca3278 100644 --- a/clients/client-timestream-write/commands/UntagResourceCommand.ts +++ b/clients/client-timestream-write/commands/UntagResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

+ * Removes the association of tags from a Timestream resource. + *

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +39,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/UpdateDatabaseCommand.ts b/clients/client-timestream-write/commands/UpdateDatabaseCommand.ts index da8b82ca62a6c..98ae4dae56904 100644 --- a/clients/client-timestream-write/commands/UpdateDatabaseCommand.ts +++ b/clients/client-timestream-write/commands/UpdateDatabaseCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateDatabaseCommandInput = UpdateDatabaseRequest; export type UpdateDatabaseCommandOutput = UpdateDatabaseResponse & __MetadataBearer; +/** + *

+ * Modifies the KMS key for an existing database. While updating the database, + * you must specify the database name and the identifier of the new KMS key to be used (KmsKeyId). + * If there are any concurrent UpdateDatabase requests, first writer wins. + *

+ */ export class UpdateDatabaseCommand extends $Command< UpdateDatabaseCommandInput, UpdateDatabaseCommandOutput, @@ -34,6 +41,9 @@ export class UpdateDatabaseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/UpdateTableCommand.ts b/clients/client-timestream-write/commands/UpdateTableCommand.ts index 9b907899fd333..49e8bb460c7cf 100644 --- a/clients/client-timestream-write/commands/UpdateTableCommand.ts +++ b/clients/client-timestream-write/commands/UpdateTableCommand.ts @@ -20,6 +20,15 @@ import { export type UpdateTableCommandInput = UpdateTableRequest; export type UpdateTableCommandOutput = UpdateTableResponse & __MetadataBearer; +/** + *

Modifies the retention duration of the memory store and magnetic store for your Timestream table. + * Note that the change in retention duration takes effect immediately. + * For example, if the retention period of the memory store was initially set to 2 hours and then changed to 24 hours, + * the memory store will be capable of holding 24 hours of data, but will + * be populated with 24 hours of data 22 hours after this change was made. + * Timestream does not retrieve data from the magnetic store to populate the memory store.

+ *

Service quotas apply. For more information, see Access Management in the Timestream Developer Guide.

+ */ export class UpdateTableCommand extends $Command< UpdateTableCommandInput, UpdateTableCommandOutput, @@ -34,6 +43,9 @@ export class UpdateTableCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/commands/WriteRecordsCommand.ts b/clients/client-timestream-write/commands/WriteRecordsCommand.ts index a23e73b51a7dc..4431f43c77173 100644 --- a/clients/client-timestream-write/commands/WriteRecordsCommand.ts +++ b/clients/client-timestream-write/commands/WriteRecordsCommand.ts @@ -20,6 +20,21 @@ import { export type WriteRecordsCommandInput = WriteRecordsRequest; export type WriteRecordsCommandOutput = __MetadataBearer; +/** + *

The WriteRecords operation enables you to write your time series + * data into Timestream. You can specify a single data point or a batch + * of data points to be inserted into the system. Timestream offers you + * with a flexible schema that auto detects the column names and data types + * for your Timestream tables based on the dimension names and data types of + * the data points you specify when invoking writes into the database. + * Timestream support eventual consistency read semantics. This means that + * when you query data immediately after writing a batch of data into Timestream, + * the query results might not reflect the results of a recently completed write + * operation. The results may also include some stale data. If you repeat the + * query request after a short time, the results should return the latest data. + * Service quotas apply. For more information, see Access Management in the Timestream Developer Guide. + *

+ */ export class WriteRecordsCommand extends $Command< WriteRecordsCommandInput, WriteRecordsCommandOutput, @@ -34,6 +49,9 @@ export class WriteRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TimestreamWriteClientResolvedConfig, diff --git a/clients/client-timestream-write/package.json b/clients/client-timestream-write/package.json index 0c7e1b22fcdf7..4a04389d25297 100644 --- a/clients/client-timestream-write/package.json +++ b/clients/client-timestream-write/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Timestream Write Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-timestream-write/pagination/ListDatabasesPaginator.ts b/clients/client-timestream-write/pagination/ListDatabasesPaginator.ts index 5f7db123685a2..301492e1466ed 100644 --- a/clients/client-timestream-write/pagination/ListDatabasesPaginator.ts +++ b/clients/client-timestream-write/pagination/ListDatabasesPaginator.ts @@ -8,6 +8,9 @@ import { import { TimestreamWritePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TimestreamWriteClient, input: ListDatabasesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDatabasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: TimestreamWrite, input: ListDatabasesCommandInput, diff --git a/clients/client-timestream-write/pagination/ListTablesPaginator.ts b/clients/client-timestream-write/pagination/ListTablesPaginator.ts index 7ffb90f6634ba..c76029067339d 100644 --- a/clients/client-timestream-write/pagination/ListTablesPaginator.ts +++ b/clients/client-timestream-write/pagination/ListTablesPaginator.ts @@ -4,6 +4,9 @@ import { ListTablesCommand, ListTablesCommandInput, ListTablesCommandOutput } fr import { TimestreamWritePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TimestreamWriteClient, input: ListTablesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTablesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: TimestreamWrite, input: ListTablesCommandInput, diff --git a/clients/client-timestream-write/runtimeConfig.browser.ts b/clients/client-timestream-write/runtimeConfig.browser.ts index 335ee33527f30..dc9a16f0d4449 100644 --- a/clients/client-timestream-write/runtimeConfig.browser.ts +++ b/clients/client-timestream-write/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./TimestreamWriteClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-timestream-write/runtimeConfig.native.ts b/clients/client-timestream-write/runtimeConfig.native.ts index cfbdbf2abcec0..88055c11c8d4c 100644 --- a/clients/client-timestream-write/runtimeConfig.native.ts +++ b/clients/client-timestream-write/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./TimestreamWriteClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-timestream-write/runtimeConfig.shared.ts b/clients/client-timestream-write/runtimeConfig.shared.ts index 11c8c9cb6a3c9..2b1062fc96b34 100644 --- a/clients/client-timestream-write/runtimeConfig.shared.ts +++ b/clients/client-timestream-write/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-01", disableHostPrefix: false, diff --git a/clients/client-timestream-write/runtimeConfig.ts b/clients/client-timestream-write/runtimeConfig.ts index fd4c5e3285005..f0b8a1d5a275c 100644 --- a/clients/client-timestream-write/runtimeConfig.ts +++ b/clients/client-timestream-write/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./TimestreamWriteClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-timestream-write/tsconfig.json b/clients/client-timestream-write/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-timestream-write/tsconfig.json +++ b/clients/client-timestream-write/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-transcribe-streaming/commands/StartStreamTranscriptionCommand.ts b/clients/client-transcribe-streaming/commands/StartStreamTranscriptionCommand.ts index 34c6033b80a79..e824c4bfc168a 100644 --- a/clients/client-transcribe-streaming/commands/StartStreamTranscriptionCommand.ts +++ b/clients/client-transcribe-streaming/commands/StartStreamTranscriptionCommand.ts @@ -26,6 +26,25 @@ import { export type StartStreamTranscriptionCommandInput = StartStreamTranscriptionRequest; export type StartStreamTranscriptionCommandOutput = StartStreamTranscriptionResponse & __MetadataBearer; +/** + *

Starts a bidirectional HTTP2 stream where audio is streamed to Amazon Transcribe and the transcription + * results are streamed to your application.

+ *

The following are encoded as HTTP2 headers:

+ *
    + *
  • + *

    x-amzn-transcribe-language-code

    + *
  • + *
  • + *

    x-amzn-transcribe-media-encoding

    + *
  • + *
  • + *

    x-amzn-transcribe-sample-rate

    + *
  • + *
  • + *

    x-amzn-transcribe-session-id

    + *
  • + *
+ */ export class StartStreamTranscriptionCommand extends $Command< StartStreamTranscriptionCommandInput, StartStreamTranscriptionCommandOutput, @@ -40,6 +59,9 @@ export class StartStreamTranscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeStreamingClientResolvedConfig, diff --git a/clients/client-transcribe-streaming/package.json b/clients/client-transcribe-streaming/package.json index d5521c63cf1b6..107227abe7e13 100644 --- a/clients/client-transcribe-streaming/package.json +++ b/clients/client-transcribe-streaming/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Transcribe Streaming Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build", "remove-definitions": "rimraf ./types", @@ -71,7 +71,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-transcribe-streaming/runtimeConfig.browser.ts b/clients/client-transcribe-streaming/runtimeConfig.browser.ts index cbec8bb08bc52..952537f0ad2cf 100644 --- a/clients/client-transcribe-streaming/runtimeConfig.browser.ts +++ b/clients/client-transcribe-streaming/runtimeConfig.browser.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./TranscribeStreamingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-transcribe-streaming/runtimeConfig.native.ts b/clients/client-transcribe-streaming/runtimeConfig.native.ts index aa179823d2805..e9dfb74bf5354 100644 --- a/clients/client-transcribe-streaming/runtimeConfig.native.ts +++ b/clients/client-transcribe-streaming/runtimeConfig.native.ts @@ -6,6 +6,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./TranscribeStreamingClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-transcribe-streaming/runtimeConfig.shared.ts b/clients/client-transcribe-streaming/runtimeConfig.shared.ts index dac81c0ceb6bb..19c51e8088c03 100644 --- a/clients/client-transcribe-streaming/runtimeConfig.shared.ts +++ b/clients/client-transcribe-streaming/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-26", disableHostPrefix: false, diff --git a/clients/client-transcribe-streaming/runtimeConfig.ts b/clients/client-transcribe-streaming/runtimeConfig.ts index 2a1420ee8ce63..5af99a4b1355a 100644 --- a/clients/client-transcribe-streaming/runtimeConfig.ts +++ b/clients/client-transcribe-streaming/runtimeConfig.ts @@ -16,6 +16,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./TranscribeStreamingClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-transcribe-streaming/tsconfig.json b/clients/client-transcribe-streaming/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-transcribe-streaming/tsconfig.json +++ b/clients/client-transcribe-streaming/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-transcribe/commands/CreateLanguageModelCommand.ts b/clients/client-transcribe/commands/CreateLanguageModelCommand.ts index 10ccda8ddae65..2b4a404f53e28 100644 --- a/clients/client-transcribe/commands/CreateLanguageModelCommand.ts +++ b/clients/client-transcribe/commands/CreateLanguageModelCommand.ts @@ -20,6 +20,11 @@ import { export type CreateLanguageModelCommandInput = CreateLanguageModelRequest; export type CreateLanguageModelCommandOutput = CreateLanguageModelResponse & __MetadataBearer; +/** + *

Creates a new custom language model. Use Amazon S3 prefixes to provide the location of your + * input files. The time it takes to create your model depends on the size of your training + * data.

+ */ export class CreateLanguageModelCommand extends $Command< CreateLanguageModelCommandInput, CreateLanguageModelCommandOutput, @@ -34,6 +39,9 @@ export class CreateLanguageModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/CreateMedicalVocabularyCommand.ts b/clients/client-transcribe/commands/CreateMedicalVocabularyCommand.ts index 5ab2b69803eb8..1eaa448466277 100644 --- a/clients/client-transcribe/commands/CreateMedicalVocabularyCommand.ts +++ b/clients/client-transcribe/commands/CreateMedicalVocabularyCommand.ts @@ -20,6 +20,11 @@ import { export type CreateMedicalVocabularyCommandInput = CreateMedicalVocabularyRequest; export type CreateMedicalVocabularyCommandOutput = CreateMedicalVocabularyResponse & __MetadataBearer; +/** + *

Creates a new custom vocabulary that you can use to + * change + * how Amazon Transcribe Medical transcribes your audio file.

+ */ export class CreateMedicalVocabularyCommand extends $Command< CreateMedicalVocabularyCommandInput, CreateMedicalVocabularyCommandOutput, @@ -34,6 +39,9 @@ export class CreateMedicalVocabularyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/CreateVocabularyCommand.ts b/clients/client-transcribe/commands/CreateVocabularyCommand.ts index 96656cd4aef4d..683b03f421994 100644 --- a/clients/client-transcribe/commands/CreateVocabularyCommand.ts +++ b/clients/client-transcribe/commands/CreateVocabularyCommand.ts @@ -20,6 +20,10 @@ import { export type CreateVocabularyCommandInput = CreateVocabularyRequest; export type CreateVocabularyCommandOutput = CreateVocabularyResponse & __MetadataBearer; +/** + *

Creates a new custom vocabulary that you can use to change the way Amazon Transcribe handles + * transcription of an audio file.

+ */ export class CreateVocabularyCommand extends $Command< CreateVocabularyCommandInput, CreateVocabularyCommandOutput, @@ -34,6 +38,9 @@ export class CreateVocabularyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/CreateVocabularyFilterCommand.ts b/clients/client-transcribe/commands/CreateVocabularyFilterCommand.ts index 8776f23188d84..185b68e433ad5 100644 --- a/clients/client-transcribe/commands/CreateVocabularyFilterCommand.ts +++ b/clients/client-transcribe/commands/CreateVocabularyFilterCommand.ts @@ -20,6 +20,10 @@ import { export type CreateVocabularyFilterCommandInput = CreateVocabularyFilterRequest; export type CreateVocabularyFilterCommandOutput = CreateVocabularyFilterResponse & __MetadataBearer; +/** + *

Creates a new vocabulary filter that you can use to filter words, such as profane + * words, from the output of a transcription job.

+ */ export class CreateVocabularyFilterCommand extends $Command< CreateVocabularyFilterCommandInput, CreateVocabularyFilterCommandOutput, @@ -34,6 +38,9 @@ export class CreateVocabularyFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/DeleteLanguageModelCommand.ts b/clients/client-transcribe/commands/DeleteLanguageModelCommand.ts index 4c25214d0f846..97951b04deb2f 100644 --- a/clients/client-transcribe/commands/DeleteLanguageModelCommand.ts +++ b/clients/client-transcribe/commands/DeleteLanguageModelCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLanguageModelCommandInput = DeleteLanguageModelRequest; export type DeleteLanguageModelCommandOutput = __MetadataBearer; +/** + *

Deletes a custom language model using its name.

+ */ export class DeleteLanguageModelCommand extends $Command< DeleteLanguageModelCommandInput, DeleteLanguageModelCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLanguageModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/DeleteMedicalTranscriptionJobCommand.ts b/clients/client-transcribe/commands/DeleteMedicalTranscriptionJobCommand.ts index 2bd562c562ebf..f0922536ffecd 100644 --- a/clients/client-transcribe/commands/DeleteMedicalTranscriptionJobCommand.ts +++ b/clients/client-transcribe/commands/DeleteMedicalTranscriptionJobCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMedicalTranscriptionJobCommandInput = DeleteMedicalTranscriptionJobRequest; export type DeleteMedicalTranscriptionJobCommandOutput = __MetadataBearer; +/** + *

Deletes a transcription job generated by Amazon Transcribe Medical and any related information.

+ */ export class DeleteMedicalTranscriptionJobCommand extends $Command< DeleteMedicalTranscriptionJobCommandInput, DeleteMedicalTranscriptionJobCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMedicalTranscriptionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/DeleteMedicalVocabularyCommand.ts b/clients/client-transcribe/commands/DeleteMedicalVocabularyCommand.ts index 9f8bb73f1897a..4c6d2494d68d3 100644 --- a/clients/client-transcribe/commands/DeleteMedicalVocabularyCommand.ts +++ b/clients/client-transcribe/commands/DeleteMedicalVocabularyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMedicalVocabularyCommandInput = DeleteMedicalVocabularyRequest; export type DeleteMedicalVocabularyCommandOutput = __MetadataBearer; +/** + *

Deletes a vocabulary from Amazon Transcribe Medical.

+ */ export class DeleteMedicalVocabularyCommand extends $Command< DeleteMedicalVocabularyCommandInput, DeleteMedicalVocabularyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMedicalVocabularyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/DeleteTranscriptionJobCommand.ts b/clients/client-transcribe/commands/DeleteTranscriptionJobCommand.ts index e0a3c6bece072..758b66d9e253c 100644 --- a/clients/client-transcribe/commands/DeleteTranscriptionJobCommand.ts +++ b/clients/client-transcribe/commands/DeleteTranscriptionJobCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteTranscriptionJobCommandInput = DeleteTranscriptionJobRequest; export type DeleteTranscriptionJobCommandOutput = __MetadataBearer; +/** + *

Deletes a previously submitted transcription job along with any other generated + * results such as the transcription, models, and so on.

+ */ export class DeleteTranscriptionJobCommand extends $Command< DeleteTranscriptionJobCommandInput, DeleteTranscriptionJobCommandOutput, @@ -34,6 +38,9 @@ export class DeleteTranscriptionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/DeleteVocabularyCommand.ts b/clients/client-transcribe/commands/DeleteVocabularyCommand.ts index 9a7d8d826c148..9f0b67c2da8f5 100644 --- a/clients/client-transcribe/commands/DeleteVocabularyCommand.ts +++ b/clients/client-transcribe/commands/DeleteVocabularyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVocabularyCommandInput = DeleteVocabularyRequest; export type DeleteVocabularyCommandOutput = __MetadataBearer; +/** + *

Deletes a vocabulary from Amazon Transcribe.

+ */ export class DeleteVocabularyCommand extends $Command< DeleteVocabularyCommandInput, DeleteVocabularyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVocabularyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/DeleteVocabularyFilterCommand.ts b/clients/client-transcribe/commands/DeleteVocabularyFilterCommand.ts index 08d057482c992..ae47bee8df7ab 100644 --- a/clients/client-transcribe/commands/DeleteVocabularyFilterCommand.ts +++ b/clients/client-transcribe/commands/DeleteVocabularyFilterCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteVocabularyFilterCommandInput = DeleteVocabularyFilterRequest; export type DeleteVocabularyFilterCommandOutput = __MetadataBearer; +/** + *

Removes a vocabulary filter.

+ */ export class DeleteVocabularyFilterCommand extends $Command< DeleteVocabularyFilterCommandInput, DeleteVocabularyFilterCommandOutput, @@ -34,6 +37,9 @@ export class DeleteVocabularyFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/DescribeLanguageModelCommand.ts b/clients/client-transcribe/commands/DescribeLanguageModelCommand.ts index 1b60c7f6361cc..bedab66a79b91 100644 --- a/clients/client-transcribe/commands/DescribeLanguageModelCommand.ts +++ b/clients/client-transcribe/commands/DescribeLanguageModelCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeLanguageModelCommandInput = DescribeLanguageModelRequest; export type DescribeLanguageModelCommandOutput = DescribeLanguageModelResponse & __MetadataBearer; +/** + *

Gets information about a single custom language model. Use this information to see + * details about the language model in your AWS account. You can also see whether the base + * language model used to create your custom language model has been updated. If Amazon Transcribe has + * updated the base model, you can create a new custom language model using the updated + * base model. If the language model wasn't created, you can use this operation to + * understand why Amazon Transcribe couldn't create it.

+ */ export class DescribeLanguageModelCommand extends $Command< DescribeLanguageModelCommandInput, DescribeLanguageModelCommandOutput, @@ -34,6 +42,9 @@ export class DescribeLanguageModelCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/GetMedicalTranscriptionJobCommand.ts b/clients/client-transcribe/commands/GetMedicalTranscriptionJobCommand.ts index 92b31001a9eeb..a358688f881b3 100644 --- a/clients/client-transcribe/commands/GetMedicalTranscriptionJobCommand.ts +++ b/clients/client-transcribe/commands/GetMedicalTranscriptionJobCommand.ts @@ -20,6 +20,12 @@ import { export type GetMedicalTranscriptionJobCommandInput = GetMedicalTranscriptionJobRequest; export type GetMedicalTranscriptionJobCommandOutput = GetMedicalTranscriptionJobResponse & __MetadataBearer; +/** + *

Returns information about a transcription job from Amazon Transcribe Medical. To see the status of the + * job, check the TranscriptionJobStatus field. If the status is + * COMPLETED, the job is finished. You find the results of the completed + * job in the TranscriptFileUri field.

+ */ export class GetMedicalTranscriptionJobCommand extends $Command< GetMedicalTranscriptionJobCommandInput, GetMedicalTranscriptionJobCommandOutput, @@ -34,6 +40,9 @@ export class GetMedicalTranscriptionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/GetMedicalVocabularyCommand.ts b/clients/client-transcribe/commands/GetMedicalVocabularyCommand.ts index 6b1222eb2a28c..c502cdbd3acfa 100644 --- a/clients/client-transcribe/commands/GetMedicalVocabularyCommand.ts +++ b/clients/client-transcribe/commands/GetMedicalVocabularyCommand.ts @@ -20,6 +20,9 @@ import { export type GetMedicalVocabularyCommandInput = GetMedicalVocabularyRequest; export type GetMedicalVocabularyCommandOutput = GetMedicalVocabularyResponse & __MetadataBearer; +/** + *

Retrieves information about a medical vocabulary.

+ */ export class GetMedicalVocabularyCommand extends $Command< GetMedicalVocabularyCommandInput, GetMedicalVocabularyCommandOutput, @@ -34,6 +37,9 @@ export class GetMedicalVocabularyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/GetTranscriptionJobCommand.ts b/clients/client-transcribe/commands/GetTranscriptionJobCommand.ts index dffb1c666cdba..c32e7d52bec6d 100644 --- a/clients/client-transcribe/commands/GetTranscriptionJobCommand.ts +++ b/clients/client-transcribe/commands/GetTranscriptionJobCommand.ts @@ -20,6 +20,13 @@ import { export type GetTranscriptionJobCommandInput = GetTranscriptionJobRequest; export type GetTranscriptionJobCommandOutput = GetTranscriptionJobResponse & __MetadataBearer; +/** + *

Returns information about a transcription job. To see the status of the job, check the + * TranscriptionJobStatus field. If the status is COMPLETED, + * the job is finished and you can find the results at the location specified in the + * TranscriptFileUri field. If you enable content redaction, the redacted + * transcript appears in RedactedTranscriptFileUri.

+ */ export class GetTranscriptionJobCommand extends $Command< GetTranscriptionJobCommandInput, GetTranscriptionJobCommandOutput, @@ -34,6 +41,9 @@ export class GetTranscriptionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/GetVocabularyCommand.ts b/clients/client-transcribe/commands/GetVocabularyCommand.ts index 7b8563b0e2701..fbda946af3914 100644 --- a/clients/client-transcribe/commands/GetVocabularyCommand.ts +++ b/clients/client-transcribe/commands/GetVocabularyCommand.ts @@ -20,6 +20,9 @@ import { export type GetVocabularyCommandInput = GetVocabularyRequest; export type GetVocabularyCommandOutput = GetVocabularyResponse & __MetadataBearer; +/** + *

Gets information about a vocabulary.

+ */ export class GetVocabularyCommand extends $Command< GetVocabularyCommandInput, GetVocabularyCommandOutput, @@ -34,6 +37,9 @@ export class GetVocabularyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/GetVocabularyFilterCommand.ts b/clients/client-transcribe/commands/GetVocabularyFilterCommand.ts index 77775cabd651f..69e8700bcc2e7 100644 --- a/clients/client-transcribe/commands/GetVocabularyFilterCommand.ts +++ b/clients/client-transcribe/commands/GetVocabularyFilterCommand.ts @@ -20,6 +20,9 @@ import { export type GetVocabularyFilterCommandInput = GetVocabularyFilterRequest; export type GetVocabularyFilterCommandOutput = GetVocabularyFilterResponse & __MetadataBearer; +/** + *

Returns information about a vocabulary filter.

+ */ export class GetVocabularyFilterCommand extends $Command< GetVocabularyFilterCommandInput, GetVocabularyFilterCommandOutput, @@ -34,6 +37,9 @@ export class GetVocabularyFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/ListLanguageModelsCommand.ts b/clients/client-transcribe/commands/ListLanguageModelsCommand.ts index 275b43abc2e42..95e974f97793b 100644 --- a/clients/client-transcribe/commands/ListLanguageModelsCommand.ts +++ b/clients/client-transcribe/commands/ListLanguageModelsCommand.ts @@ -20,6 +20,12 @@ import { export type ListLanguageModelsCommandInput = ListLanguageModelsRequest; export type ListLanguageModelsCommandOutput = ListLanguageModelsResponse & __MetadataBearer; +/** + *

Provides more information about the custom language models you've created. You can use + * the information in this list to find a specific custom language model. You can then use + * the operation to get more information about + * it.

+ */ export class ListLanguageModelsCommand extends $Command< ListLanguageModelsCommandInput, ListLanguageModelsCommandOutput, @@ -34,6 +40,9 @@ export class ListLanguageModelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/ListMedicalTranscriptionJobsCommand.ts b/clients/client-transcribe/commands/ListMedicalTranscriptionJobsCommand.ts index a3f88df9deabd..37b80cad35e56 100644 --- a/clients/client-transcribe/commands/ListMedicalTranscriptionJobsCommand.ts +++ b/clients/client-transcribe/commands/ListMedicalTranscriptionJobsCommand.ts @@ -20,6 +20,10 @@ import { export type ListMedicalTranscriptionJobsCommandInput = ListMedicalTranscriptionJobsRequest; export type ListMedicalTranscriptionJobsCommandOutput = ListMedicalTranscriptionJobsResponse & __MetadataBearer; +/** + *

Lists medical transcription jobs with a specified status or substring that matches + * their names.

+ */ export class ListMedicalTranscriptionJobsCommand extends $Command< ListMedicalTranscriptionJobsCommandInput, ListMedicalTranscriptionJobsCommandOutput, @@ -34,6 +38,9 @@ export class ListMedicalTranscriptionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/ListMedicalVocabulariesCommand.ts b/clients/client-transcribe/commands/ListMedicalVocabulariesCommand.ts index 2991c56e61fa6..1b1b90657c385 100644 --- a/clients/client-transcribe/commands/ListMedicalVocabulariesCommand.ts +++ b/clients/client-transcribe/commands/ListMedicalVocabulariesCommand.ts @@ -20,6 +20,10 @@ import { export type ListMedicalVocabulariesCommandInput = ListMedicalVocabulariesRequest; export type ListMedicalVocabulariesCommandOutput = ListMedicalVocabulariesResponse & __MetadataBearer; +/** + *

Returns a list of vocabularies that match the specified criteria. If you don't enter a + * value in any of the request parameters, returns the entire list of vocabularies.

+ */ export class ListMedicalVocabulariesCommand extends $Command< ListMedicalVocabulariesCommandInput, ListMedicalVocabulariesCommandOutput, @@ -34,6 +38,9 @@ export class ListMedicalVocabulariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/ListTranscriptionJobsCommand.ts b/clients/client-transcribe/commands/ListTranscriptionJobsCommand.ts index c09d45c87be73..b5c49bc17ea8c 100644 --- a/clients/client-transcribe/commands/ListTranscriptionJobsCommand.ts +++ b/clients/client-transcribe/commands/ListTranscriptionJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTranscriptionJobsCommandInput = ListTranscriptionJobsRequest; export type ListTranscriptionJobsCommandOutput = ListTranscriptionJobsResponse & __MetadataBearer; +/** + *

Lists transcription jobs with the specified status.

+ */ export class ListTranscriptionJobsCommand extends $Command< ListTranscriptionJobsCommandInput, ListTranscriptionJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListTranscriptionJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/ListVocabulariesCommand.ts b/clients/client-transcribe/commands/ListVocabulariesCommand.ts index 07f819085666a..3170e60c68cf9 100644 --- a/clients/client-transcribe/commands/ListVocabulariesCommand.ts +++ b/clients/client-transcribe/commands/ListVocabulariesCommand.ts @@ -20,6 +20,10 @@ import { export type ListVocabulariesCommandInput = ListVocabulariesRequest; export type ListVocabulariesCommandOutput = ListVocabulariesResponse & __MetadataBearer; +/** + *

Returns a list of vocabularies that match the specified criteria. If no criteria are + * specified, returns the entire list of vocabularies.

+ */ export class ListVocabulariesCommand extends $Command< ListVocabulariesCommandInput, ListVocabulariesCommandOutput, @@ -34,6 +38,9 @@ export class ListVocabulariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/ListVocabularyFiltersCommand.ts b/clients/client-transcribe/commands/ListVocabularyFiltersCommand.ts index 31d973baa16c0..32ed487db670e 100644 --- a/clients/client-transcribe/commands/ListVocabularyFiltersCommand.ts +++ b/clients/client-transcribe/commands/ListVocabularyFiltersCommand.ts @@ -20,6 +20,9 @@ import { export type ListVocabularyFiltersCommandInput = ListVocabularyFiltersRequest; export type ListVocabularyFiltersCommandOutput = ListVocabularyFiltersResponse & __MetadataBearer; +/** + *

Gets information about vocabulary filters.

+ */ export class ListVocabularyFiltersCommand extends $Command< ListVocabularyFiltersCommandInput, ListVocabularyFiltersCommandOutput, @@ -34,6 +37,9 @@ export class ListVocabularyFiltersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/StartMedicalTranscriptionJobCommand.ts b/clients/client-transcribe/commands/StartMedicalTranscriptionJobCommand.ts index 4f697c95494eb..92a951bb98ff1 100644 --- a/clients/client-transcribe/commands/StartMedicalTranscriptionJobCommand.ts +++ b/clients/client-transcribe/commands/StartMedicalTranscriptionJobCommand.ts @@ -20,6 +20,9 @@ import { export type StartMedicalTranscriptionJobCommandInput = StartMedicalTranscriptionJobRequest; export type StartMedicalTranscriptionJobCommandOutput = StartMedicalTranscriptionJobResponse & __MetadataBearer; +/** + *

Starts a batch job to transcribe medical speech to text.

+ */ export class StartMedicalTranscriptionJobCommand extends $Command< StartMedicalTranscriptionJobCommandInput, StartMedicalTranscriptionJobCommandOutput, @@ -34,6 +37,9 @@ export class StartMedicalTranscriptionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/StartTranscriptionJobCommand.ts b/clients/client-transcribe/commands/StartTranscriptionJobCommand.ts index 5ccfd0c10bd7e..52bdb49f58311 100644 --- a/clients/client-transcribe/commands/StartTranscriptionJobCommand.ts +++ b/clients/client-transcribe/commands/StartTranscriptionJobCommand.ts @@ -20,6 +20,9 @@ import { export type StartTranscriptionJobCommandInput = StartTranscriptionJobRequest; export type StartTranscriptionJobCommandOutput = StartTranscriptionJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous job to transcribe speech to text.

+ */ export class StartTranscriptionJobCommand extends $Command< StartTranscriptionJobCommandInput, StartTranscriptionJobCommandOutput, @@ -34,6 +37,9 @@ export class StartTranscriptionJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/UpdateMedicalVocabularyCommand.ts b/clients/client-transcribe/commands/UpdateMedicalVocabularyCommand.ts index 86fa1d36b7f0b..ade85b2234593 100644 --- a/clients/client-transcribe/commands/UpdateMedicalVocabularyCommand.ts +++ b/clients/client-transcribe/commands/UpdateMedicalVocabularyCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateMedicalVocabularyCommandInput = UpdateMedicalVocabularyRequest; export type UpdateMedicalVocabularyCommandOutput = UpdateMedicalVocabularyResponse & __MetadataBearer; +/** + *

Updates a vocabulary with new values that you provide in a different text file from + * the one you used to create the vocabulary. The UpdateMedicalVocabulary + * operation overwrites all of the existing information with the values that you provide in + * the request.

+ */ export class UpdateMedicalVocabularyCommand extends $Command< UpdateMedicalVocabularyCommandInput, UpdateMedicalVocabularyCommandOutput, @@ -34,6 +40,9 @@ export class UpdateMedicalVocabularyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/UpdateVocabularyCommand.ts b/clients/client-transcribe/commands/UpdateVocabularyCommand.ts index 95f77735f5e71..29ffd843ee2d3 100644 --- a/clients/client-transcribe/commands/UpdateVocabularyCommand.ts +++ b/clients/client-transcribe/commands/UpdateVocabularyCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateVocabularyCommandInput = UpdateVocabularyRequest; export type UpdateVocabularyCommandOutput = UpdateVocabularyResponse & __MetadataBearer; +/** + *

Updates an existing vocabulary with new values. The UpdateVocabulary + * operation overwrites all of the existing information with the values that you provide in + * the request.

+ */ export class UpdateVocabularyCommand extends $Command< UpdateVocabularyCommandInput, UpdateVocabularyCommandOutput, @@ -34,6 +39,9 @@ export class UpdateVocabularyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/commands/UpdateVocabularyFilterCommand.ts b/clients/client-transcribe/commands/UpdateVocabularyFilterCommand.ts index a9434ccf9c654..0e351ca6195ed 100644 --- a/clients/client-transcribe/commands/UpdateVocabularyFilterCommand.ts +++ b/clients/client-transcribe/commands/UpdateVocabularyFilterCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateVocabularyFilterCommandInput = UpdateVocabularyFilterRequest; export type UpdateVocabularyFilterCommandOutput = UpdateVocabularyFilterResponse & __MetadataBearer; +/** + *

Updates a vocabulary filter with a new list of filtered words.

+ */ export class UpdateVocabularyFilterCommand extends $Command< UpdateVocabularyFilterCommandInput, UpdateVocabularyFilterCommandOutput, @@ -34,6 +37,9 @@ export class UpdateVocabularyFilterCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranscribeClientResolvedConfig, diff --git a/clients/client-transcribe/package.json b/clients/client-transcribe/package.json index 60f478516f10a..8c05b614cacb5 100644 --- a/clients/client-transcribe/package.json +++ b/clients/client-transcribe/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Transcribe Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-transcribe/pagination/ListLanguageModelsPaginator.ts b/clients/client-transcribe/pagination/ListLanguageModelsPaginator.ts index 40ba3c26a6649..e1e836f271e1f 100644 --- a/clients/client-transcribe/pagination/ListLanguageModelsPaginator.ts +++ b/clients/client-transcribe/pagination/ListLanguageModelsPaginator.ts @@ -8,6 +8,9 @@ import { import { TranscribePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TranscribeClient, input: ListLanguageModelsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListLanguageModelsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transcribe, input: ListLanguageModelsCommandInput, diff --git a/clients/client-transcribe/pagination/ListMedicalTranscriptionJobsPaginator.ts b/clients/client-transcribe/pagination/ListMedicalTranscriptionJobsPaginator.ts index 2167c422a0b49..185482a67d665 100644 --- a/clients/client-transcribe/pagination/ListMedicalTranscriptionJobsPaginator.ts +++ b/clients/client-transcribe/pagination/ListMedicalTranscriptionJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { TranscribePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TranscribeClient, input: ListMedicalTranscriptionJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMedicalTranscriptionJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transcribe, input: ListMedicalTranscriptionJobsCommandInput, diff --git a/clients/client-transcribe/pagination/ListMedicalVocabulariesPaginator.ts b/clients/client-transcribe/pagination/ListMedicalVocabulariesPaginator.ts index a97f3c7217aad..bf9fdf75345c0 100644 --- a/clients/client-transcribe/pagination/ListMedicalVocabulariesPaginator.ts +++ b/clients/client-transcribe/pagination/ListMedicalVocabulariesPaginator.ts @@ -8,6 +8,9 @@ import { import { TranscribePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TranscribeClient, input: ListMedicalVocabulariesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMedicalVocabulariesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transcribe, input: ListMedicalVocabulariesCommandInput, diff --git a/clients/client-transcribe/pagination/ListTranscriptionJobsPaginator.ts b/clients/client-transcribe/pagination/ListTranscriptionJobsPaginator.ts index 6e440998d05c2..4db34ec5dcdd5 100644 --- a/clients/client-transcribe/pagination/ListTranscriptionJobsPaginator.ts +++ b/clients/client-transcribe/pagination/ListTranscriptionJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { TranscribePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TranscribeClient, input: ListTranscriptionJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTranscriptionJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transcribe, input: ListTranscriptionJobsCommandInput, diff --git a/clients/client-transcribe/pagination/ListVocabulariesPaginator.ts b/clients/client-transcribe/pagination/ListVocabulariesPaginator.ts index 2d9d5ac8555e1..434c1d089cd3e 100644 --- a/clients/client-transcribe/pagination/ListVocabulariesPaginator.ts +++ b/clients/client-transcribe/pagination/ListVocabulariesPaginator.ts @@ -8,6 +8,9 @@ import { import { TranscribePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TranscribeClient, input: ListVocabulariesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVocabulariesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transcribe, input: ListVocabulariesCommandInput, diff --git a/clients/client-transcribe/pagination/ListVocabularyFiltersPaginator.ts b/clients/client-transcribe/pagination/ListVocabularyFiltersPaginator.ts index 00744b1b9666a..11b73eb4b3597 100644 --- a/clients/client-transcribe/pagination/ListVocabularyFiltersPaginator.ts +++ b/clients/client-transcribe/pagination/ListVocabularyFiltersPaginator.ts @@ -8,6 +8,9 @@ import { import { TranscribePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TranscribeClient, input: ListVocabularyFiltersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListVocabularyFiltersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transcribe, input: ListVocabularyFiltersCommandInput, diff --git a/clients/client-transcribe/runtimeConfig.browser.ts b/clients/client-transcribe/runtimeConfig.browser.ts index 2db2e3507d2d8..70db9aed15b46 100644 --- a/clients/client-transcribe/runtimeConfig.browser.ts +++ b/clients/client-transcribe/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./TranscribeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-transcribe/runtimeConfig.native.ts b/clients/client-transcribe/runtimeConfig.native.ts index 3340bad38fa25..2f32f23632c6b 100644 --- a/clients/client-transcribe/runtimeConfig.native.ts +++ b/clients/client-transcribe/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./TranscribeClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-transcribe/runtimeConfig.shared.ts b/clients/client-transcribe/runtimeConfig.shared.ts index dac81c0ceb6bb..19c51e8088c03 100644 --- a/clients/client-transcribe/runtimeConfig.shared.ts +++ b/clients/client-transcribe/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-26", disableHostPrefix: false, diff --git a/clients/client-transcribe/runtimeConfig.ts b/clients/client-transcribe/runtimeConfig.ts index c1d4906200da1..de3621cfa373b 100644 --- a/clients/client-transcribe/runtimeConfig.ts +++ b/clients/client-transcribe/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./TranscribeClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-transcribe/tsconfig.json b/clients/client-transcribe/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-transcribe/tsconfig.json +++ b/clients/client-transcribe/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-transfer/commands/CreateServerCommand.ts b/clients/client-transfer/commands/CreateServerCommand.ts index 451e282ab44f3..2e837dba69790 100644 --- a/clients/client-transfer/commands/CreateServerCommand.ts +++ b/clients/client-transfer/commands/CreateServerCommand.ts @@ -20,6 +20,12 @@ import { export type CreateServerCommandInput = CreateServerRequest; export type CreateServerCommandOutput = CreateServerResponse & __MetadataBearer; +/** + *

Instantiates an autoscaling virtual server based on the selected file transfer protocol in + * AWS. When you make updates to your file transfer protocol-enabled server or when you work with + * users, use the service-generated ServerId property that is assigned to the newly + * created server.

+ */ export class CreateServerCommand extends $Command< CreateServerCommandInput, CreateServerCommandOutput, @@ -34,6 +40,9 @@ export class CreateServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/CreateUserCommand.ts b/clients/client-transfer/commands/CreateUserCommand.ts index 29d53ad4b633b..c70cb14507ca3 100644 --- a/clients/client-transfer/commands/CreateUserCommand.ts +++ b/clients/client-transfer/commands/CreateUserCommand.ts @@ -20,6 +20,15 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResponse & __MetadataBearer; +/** + *

Creates a user and associates them with an existing file transfer protocol-enabled server. + * You can only create and associate users with servers that have the + * IdentityProviderType set to SERVICE_MANAGED. Using parameters for + * CreateUser, you can specify the user name, set the home directory, store the + * user's public key, and assign the user's AWS Identity and Access Management (IAM) + * role. You can also optionally add a scope-down policy, and assign metadata with tags that can + * be used to group and search for users.

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -34,6 +43,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/DeleteServerCommand.ts b/clients/client-transfer/commands/DeleteServerCommand.ts index a284704a45f54..7641099dcc071 100644 --- a/clients/client-transfer/commands/DeleteServerCommand.ts +++ b/clients/client-transfer/commands/DeleteServerCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteServerCommandInput = DeleteServerRequest; export type DeleteServerCommandOutput = __MetadataBearer; +/** + *

Deletes the file transfer protocol-enabled server that you specify.

+ * + *

No response returns from this operation.

+ */ export class DeleteServerCommand extends $Command< DeleteServerCommandInput, DeleteServerCommandOutput, @@ -34,6 +39,9 @@ export class DeleteServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/DeleteSshPublicKeyCommand.ts b/clients/client-transfer/commands/DeleteSshPublicKeyCommand.ts index e64fa1839e6fa..5c2a5f0b68400 100644 --- a/clients/client-transfer/commands/DeleteSshPublicKeyCommand.ts +++ b/clients/client-transfer/commands/DeleteSshPublicKeyCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteSshPublicKeyCommandInput = DeleteSshPublicKeyRequest; export type DeleteSshPublicKeyCommandOutput = __MetadataBearer; +/** + *

Deletes a user's Secure Shell (SSH) public key.

+ * + *

No response is returned from this operation.

+ */ export class DeleteSshPublicKeyCommand extends $Command< DeleteSshPublicKeyCommandInput, DeleteSshPublicKeyCommandOutput, @@ -34,6 +39,9 @@ export class DeleteSshPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/DeleteUserCommand.ts b/clients/client-transfer/commands/DeleteUserCommand.ts index f42a391412614..75691323fc107 100644 --- a/clients/client-transfer/commands/DeleteUserCommand.ts +++ b/clients/client-transfer/commands/DeleteUserCommand.ts @@ -20,6 +20,15 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = __MetadataBearer; +/** + *

Deletes the user belonging to a file transfer protocol-enabled server you specify.

+ * + *

No response returns from this operation.

+ * + * + *

When you delete a user from a server, the user's information is lost.

+ *
+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -34,6 +43,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/DescribeSecurityPolicyCommand.ts b/clients/client-transfer/commands/DescribeSecurityPolicyCommand.ts index 7de7797d171e2..53977ad706df8 100644 --- a/clients/client-transfer/commands/DescribeSecurityPolicyCommand.ts +++ b/clients/client-transfer/commands/DescribeSecurityPolicyCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeSecurityPolicyCommandInput = DescribeSecurityPolicyRequest; export type DescribeSecurityPolicyCommandOutput = DescribeSecurityPolicyResponse & __MetadataBearer; +/** + *

Describes the security policy that is attached to your file transfer protocol-enabled + * server. The response contains a description of the security policy's properties. For more + * information about security policies, see Working with security + * policies.

+ */ export class DescribeSecurityPolicyCommand extends $Command< DescribeSecurityPolicyCommandInput, DescribeSecurityPolicyCommandOutput, @@ -34,6 +40,9 @@ export class DescribeSecurityPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/DescribeServerCommand.ts b/clients/client-transfer/commands/DescribeServerCommand.ts index 187f24c405846..1daddd57498c1 100644 --- a/clients/client-transfer/commands/DescribeServerCommand.ts +++ b/clients/client-transfer/commands/DescribeServerCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeServerCommandInput = DescribeServerRequest; export type DescribeServerCommandOutput = DescribeServerResponse & __MetadataBearer; +/** + *

Describes a file transfer protocol-enabled server that you specify by passing the + * ServerId parameter.

+ * + *

The response contains a description of a server's properties. When you set + * EndpointType to VPC, the response will contain the + * EndpointDetails.

+ */ export class DescribeServerCommand extends $Command< DescribeServerCommandInput, DescribeServerCommandOutput, @@ -34,6 +42,9 @@ export class DescribeServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/DescribeUserCommand.ts b/clients/client-transfer/commands/DescribeUserCommand.ts index 20d107627e173..7a720ff003919 100644 --- a/clients/client-transfer/commands/DescribeUserCommand.ts +++ b/clients/client-transfer/commands/DescribeUserCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeUserCommandInput = DescribeUserRequest; export type DescribeUserCommandOutput = DescribeUserResponse & __MetadataBearer; +/** + *

Describes the user assigned to the specific file transfer protocol-enabled server, as + * identified by its ServerId property.

+ * + *

The response from this call returns the properties of the user associated with the + * ServerId value that was specified.

+ */ export class DescribeUserCommand extends $Command< DescribeUserCommandInput, DescribeUserCommandOutput, @@ -34,6 +41,9 @@ export class DescribeUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/ImportSshPublicKeyCommand.ts b/clients/client-transfer/commands/ImportSshPublicKeyCommand.ts index 6067bac713e20..70aaa2d2d865e 100644 --- a/clients/client-transfer/commands/ImportSshPublicKeyCommand.ts +++ b/clients/client-transfer/commands/ImportSshPublicKeyCommand.ts @@ -20,6 +20,14 @@ import { export type ImportSshPublicKeyCommandInput = ImportSshPublicKeyRequest; export type ImportSshPublicKeyCommandOutput = ImportSshPublicKeyResponse & __MetadataBearer; +/** + *

Adds a Secure Shell (SSH) public key to a user account identified by a + * UserName value assigned to the specific file transfer protocol-enabled server, + * identified by ServerId.

+ * + *

The response returns the UserName value, the ServerId value, and + * the name of the SshPublicKeyId.

+ */ export class ImportSshPublicKeyCommand extends $Command< ImportSshPublicKeyCommandInput, ImportSshPublicKeyCommandOutput, @@ -34,6 +42,9 @@ export class ImportSshPublicKeyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/ListSecurityPoliciesCommand.ts b/clients/client-transfer/commands/ListSecurityPoliciesCommand.ts index 7bcfdd3f7a9d1..b20a19aa30f9d 100644 --- a/clients/client-transfer/commands/ListSecurityPoliciesCommand.ts +++ b/clients/client-transfer/commands/ListSecurityPoliciesCommand.ts @@ -20,6 +20,10 @@ import { export type ListSecurityPoliciesCommandInput = ListSecurityPoliciesRequest; export type ListSecurityPoliciesCommandOutput = ListSecurityPoliciesResponse & __MetadataBearer; +/** + *

Lists the security policies that are attached to your file transfer protocol-enabled + * servers.

+ */ export class ListSecurityPoliciesCommand extends $Command< ListSecurityPoliciesCommandInput, ListSecurityPoliciesCommandOutput, @@ -34,6 +38,9 @@ export class ListSecurityPoliciesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/ListServersCommand.ts b/clients/client-transfer/commands/ListServersCommand.ts index 51730093fa18b..364824faea1cb 100644 --- a/clients/client-transfer/commands/ListServersCommand.ts +++ b/clients/client-transfer/commands/ListServersCommand.ts @@ -20,6 +20,10 @@ import { export type ListServersCommandInput = ListServersRequest; export type ListServersCommandOutput = ListServersResponse & __MetadataBearer; +/** + *

Lists the file transfer protocol-enabled servers that are associated with your AWS + * account.

+ */ export class ListServersCommand extends $Command< ListServersCommandInput, ListServersCommandOutput, @@ -34,6 +38,9 @@ export class ListServersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/ListTagsForResourceCommand.ts b/clients/client-transfer/commands/ListTagsForResourceCommand.ts index 089525f384e3f..2bb913b6ae176 100644 --- a/clients/client-transfer/commands/ListTagsForResourceCommand.ts +++ b/clients/client-transfer/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,10 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists all of the tags associated with the Amazon Resource Number (ARN) you specify. The + * resource can be a user, server, or role.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +38,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/ListUsersCommand.ts b/clients/client-transfer/commands/ListUsersCommand.ts index 925a88ee716ee..c292b737c7698 100644 --- a/clients/client-transfer/commands/ListUsersCommand.ts +++ b/clients/client-transfer/commands/ListUsersCommand.ts @@ -17,6 +17,10 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + *

Lists the users for a file transfer protocol-enabled server that you specify by passing + * the ServerId parameter.

+ */ export class ListUsersCommand extends $Command< ListUsersCommandInput, ListUsersCommandOutput, @@ -31,6 +35,9 @@ export class ListUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/StartServerCommand.ts b/clients/client-transfer/commands/StartServerCommand.ts index 7ab155e5de71c..e24ea6821a60a 100644 --- a/clients/client-transfer/commands/StartServerCommand.ts +++ b/clients/client-transfer/commands/StartServerCommand.ts @@ -20,6 +20,17 @@ import { export type StartServerCommandInput = StartServerRequest; export type StartServerCommandOutput = __MetadataBearer; +/** + *

Changes the state of a file transfer protocol-enabled server from OFFLINE to + * ONLINE. It has no impact on a server that is already ONLINE. An + * ONLINE server can accept and process file transfer jobs.

+ * + *

The state of STARTING indicates that the server is in an intermediate state, + * either not fully able to respond, or not fully online. The values of START_FAILED + * can indicate an error condition.

+ * + *

No response is returned from this call.

+ */ export class StartServerCommand extends $Command< StartServerCommandInput, StartServerCommandOutput, @@ -34,6 +45,9 @@ export class StartServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/StopServerCommand.ts b/clients/client-transfer/commands/StopServerCommand.ts index 40f3cc190c3c7..ae567f761b56c 100644 --- a/clients/client-transfer/commands/StopServerCommand.ts +++ b/clients/client-transfer/commands/StopServerCommand.ts @@ -20,6 +20,23 @@ import { export type StopServerCommandInput = StopServerRequest; export type StopServerCommandOutput = __MetadataBearer; +/** + *

Changes the state of a file transfer protocol-enabled server from ONLINE to + * OFFLINE. An OFFLINE server cannot accept and process file transfer + * jobs. Information tied to your server, such as server and user properties, are not affected by + * stopping your server.

+ * + * + *

Stopping the server will not reduce or impact your file transfer protocol endpoint + * billing; you must delete the server to stop being billed.

+ *
+ * + *

The state of STOPPING indicates that the server is in an intermediate state, + * either not fully able to respond, or not fully offline. The values of STOP_FAILED + * can indicate an error condition.

+ * + *

No response is returned from this call.

+ */ export class StopServerCommand extends $Command< StopServerCommandInput, StopServerCommandOutput, @@ -34,6 +51,9 @@ export class StopServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/TagResourceCommand.ts b/clients/client-transfer/commands/TagResourceCommand.ts index 4317139cdf481..cc3cbf000e41e 100644 --- a/clients/client-transfer/commands/TagResourceCommand.ts +++ b/clients/client-transfer/commands/TagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = __MetadataBearer; +/** + *

Attaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN). + * Resources are users, servers, roles, and other entities.

+ * + *

There is no response returned from this call.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +40,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/TestIdentityProviderCommand.ts b/clients/client-transfer/commands/TestIdentityProviderCommand.ts index 7e5dc80342453..fd0f190ef54bd 100644 --- a/clients/client-transfer/commands/TestIdentityProviderCommand.ts +++ b/clients/client-transfer/commands/TestIdentityProviderCommand.ts @@ -20,6 +20,13 @@ import { export type TestIdentityProviderCommandInput = TestIdentityProviderRequest; export type TestIdentityProviderCommandOutput = TestIdentityProviderResponse & __MetadataBearer; +/** + *

If the IdentityProviderType of a file transfer protocol-enabled server is + * API_Gateway, tests whether your API Gateway is set up successfully. We highly + * recommend that you call this operation to test your authentication method as soon as you + * create your server. By doing so, you can troubleshoot issues with the API Gateway integration + * to ensure that your users can successfully use the service.

+ */ export class TestIdentityProviderCommand extends $Command< TestIdentityProviderCommandInput, TestIdentityProviderCommandOutput, @@ -34,6 +41,9 @@ export class TestIdentityProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/UntagResourceCommand.ts b/clients/client-transfer/commands/UntagResourceCommand.ts index 2d413e6da4594..bed863d5de8e3 100644 --- a/clients/client-transfer/commands/UntagResourceCommand.ts +++ b/clients/client-transfer/commands/UntagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = __MetadataBearer; +/** + *

Detaches a key-value pair from a resource, as identified by its Amazon Resource Name + * (ARN). Resources are users, servers, roles, and other entities.

+ * + *

No response is returned from this call.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +40,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/UpdateServerCommand.ts b/clients/client-transfer/commands/UpdateServerCommand.ts index c2395571325d1..4ddb3dc276900 100644 --- a/clients/client-transfer/commands/UpdateServerCommand.ts +++ b/clients/client-transfer/commands/UpdateServerCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateServerCommandInput = UpdateServerRequest; export type UpdateServerCommandOutput = UpdateServerResponse & __MetadataBearer; +/** + *

Updates the file transfer protocol-enabled server's properties after that server has + * been created.

+ * + *

The UpdateServer call returns the ServerId of the server you + * updated.

+ */ export class UpdateServerCommand extends $Command< UpdateServerCommandInput, UpdateServerCommandOutput, @@ -34,6 +41,9 @@ export class UpdateServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/commands/UpdateUserCommand.ts b/clients/client-transfer/commands/UpdateUserCommand.ts index 592c25de3e8c1..9b8bd58cd4ecb 100644 --- a/clients/client-transfer/commands/UpdateUserCommand.ts +++ b/clients/client-transfer/commands/UpdateUserCommand.ts @@ -20,6 +20,14 @@ import { export type UpdateUserCommandInput = UpdateUserRequest; export type UpdateUserCommandOutput = UpdateUserResponse & __MetadataBearer; +/** + *

Assigns new properties to a user. Parameters you pass modify any or all of the following: + * the home directory, role, and policy for the UserName and ServerId + * you specify.

+ * + *

The response returns the ServerId and the UserName for the + * updated user.

+ */ export class UpdateUserCommand extends $Command< UpdateUserCommandInput, UpdateUserCommandOutput, @@ -34,6 +42,9 @@ export class UpdateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TransferClientResolvedConfig, diff --git a/clients/client-transfer/package.json b/clients/client-transfer/package.json index 06457b32f1fd5..e5b58b6f5fe75 100644 --- a/clients/client-transfer/package.json +++ b/clients/client-transfer/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Transfer Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-transfer/pagination/ListSecurityPoliciesPaginator.ts b/clients/client-transfer/pagination/ListSecurityPoliciesPaginator.ts index 53c0b984ef83a..8b9ad8d385ed5 100644 --- a/clients/client-transfer/pagination/ListSecurityPoliciesPaginator.ts +++ b/clients/client-transfer/pagination/ListSecurityPoliciesPaginator.ts @@ -8,6 +8,9 @@ import { import { TransferPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TransferClient, input: ListSecurityPoliciesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListSecurityPoliciesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transfer, input: ListSecurityPoliciesCommandInput, diff --git a/clients/client-transfer/pagination/ListServersPaginator.ts b/clients/client-transfer/pagination/ListServersPaginator.ts index b1a372e0209d4..60e093a4c166f 100644 --- a/clients/client-transfer/pagination/ListServersPaginator.ts +++ b/clients/client-transfer/pagination/ListServersPaginator.ts @@ -4,6 +4,9 @@ import { ListServersCommand, ListServersCommandInput, ListServersCommandOutput } import { TransferPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TransferClient, input: ListServersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListServersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transfer, input: ListServersCommandInput, diff --git a/clients/client-transfer/pagination/ListTagsForResourcePaginator.ts b/clients/client-transfer/pagination/ListTagsForResourcePaginator.ts index 969684424d1e3..3885dc4ef2ecb 100644 --- a/clients/client-transfer/pagination/ListTagsForResourcePaginator.ts +++ b/clients/client-transfer/pagination/ListTagsForResourcePaginator.ts @@ -8,6 +8,9 @@ import { import { TransferPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TransferClient, input: ListTagsForResourceCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTagsForResourceCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transfer, input: ListTagsForResourceCommandInput, diff --git a/clients/client-transfer/pagination/ListUsersPaginator.ts b/clients/client-transfer/pagination/ListUsersPaginator.ts index 554a3edf3d3da..36f836ae90ee3 100644 --- a/clients/client-transfer/pagination/ListUsersPaginator.ts +++ b/clients/client-transfer/pagination/ListUsersPaginator.ts @@ -4,6 +4,9 @@ import { ListUsersCommand, ListUsersCommandInput, ListUsersCommandOutput } from import { TransferPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TransferClient, input: ListUsersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Transfer, input: ListUsersCommandInput, diff --git a/clients/client-transfer/runtimeConfig.browser.ts b/clients/client-transfer/runtimeConfig.browser.ts index 4dcab0cd255ca..82b5a032228e5 100644 --- a/clients/client-transfer/runtimeConfig.browser.ts +++ b/clients/client-transfer/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./TransferClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-transfer/runtimeConfig.native.ts b/clients/client-transfer/runtimeConfig.native.ts index 82ba6f964d2d9..c862aa79ea005 100644 --- a/clients/client-transfer/runtimeConfig.native.ts +++ b/clients/client-transfer/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./TransferClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-transfer/runtimeConfig.shared.ts b/clients/client-transfer/runtimeConfig.shared.ts index f7ac32cb1c5e0..71ded8d740acf 100644 --- a/clients/client-transfer/runtimeConfig.shared.ts +++ b/clients/client-transfer/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-11-05", disableHostPrefix: false, diff --git a/clients/client-transfer/runtimeConfig.ts b/clients/client-transfer/runtimeConfig.ts index a2480d8ff80de..972871d41fabf 100644 --- a/clients/client-transfer/runtimeConfig.ts +++ b/clients/client-transfer/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./TransferClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-transfer/tsconfig.json b/clients/client-transfer/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-transfer/tsconfig.json +++ b/clients/client-transfer/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-translate/commands/DeleteTerminologyCommand.ts b/clients/client-translate/commands/DeleteTerminologyCommand.ts index 3bae7c570e3e2..22d859c8980a3 100644 --- a/clients/client-translate/commands/DeleteTerminologyCommand.ts +++ b/clients/client-translate/commands/DeleteTerminologyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTerminologyCommandInput = DeleteTerminologyRequest; export type DeleteTerminologyCommandOutput = __MetadataBearer; +/** + *

A synchronous action that deletes a custom terminology.

+ */ export class DeleteTerminologyCommand extends $Command< DeleteTerminologyCommandInput, DeleteTerminologyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTerminologyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/commands/DescribeTextTranslationJobCommand.ts b/clients/client-translate/commands/DescribeTextTranslationJobCommand.ts index 03e4967011e97..32b2f8a02cff0 100644 --- a/clients/client-translate/commands/DescribeTextTranslationJobCommand.ts +++ b/clients/client-translate/commands/DescribeTextTranslationJobCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeTextTranslationJobCommandInput = DescribeTextTranslationJobRequest; export type DescribeTextTranslationJobCommandOutput = DescribeTextTranslationJobResponse & __MetadataBearer; +/** + *

Gets the properties associated with an asycnhronous batch translation job including name, + * ID, status, source and target languages, input/output S3 buckets, and so on.

+ */ export class DescribeTextTranslationJobCommand extends $Command< DescribeTextTranslationJobCommandInput, DescribeTextTranslationJobCommandOutput, @@ -34,6 +38,9 @@ export class DescribeTextTranslationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/commands/GetTerminologyCommand.ts b/clients/client-translate/commands/GetTerminologyCommand.ts index 62466e40e96ec..66b344d28888c 100644 --- a/clients/client-translate/commands/GetTerminologyCommand.ts +++ b/clients/client-translate/commands/GetTerminologyCommand.ts @@ -20,6 +20,9 @@ import { export type GetTerminologyCommandInput = GetTerminologyRequest; export type GetTerminologyCommandOutput = GetTerminologyResponse & __MetadataBearer; +/** + *

Retrieves a custom terminology.

+ */ export class GetTerminologyCommand extends $Command< GetTerminologyCommandInput, GetTerminologyCommandOutput, @@ -34,6 +37,9 @@ export class GetTerminologyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/commands/ImportTerminologyCommand.ts b/clients/client-translate/commands/ImportTerminologyCommand.ts index 99f6452489861..aa5d7ff2d927a 100644 --- a/clients/client-translate/commands/ImportTerminologyCommand.ts +++ b/clients/client-translate/commands/ImportTerminologyCommand.ts @@ -20,6 +20,16 @@ import { export type ImportTerminologyCommandInput = ImportTerminologyRequest; export type ImportTerminologyCommandOutput = ImportTerminologyResponse & __MetadataBearer; +/** + *

Creates or updates a custom terminology, depending on whether or not one already exists + * for the given terminology name. Importing a terminology with the same name as an existing one + * will merge the terminologies based on the chosen merge strategy. Currently, the only supported + * merge strategy is OVERWRITE, and so the imported terminology will overwrite an existing + * terminology of the same name.

+ *

If you import a terminology that overwrites an existing one, the new terminology take up + * to 10 minutes to fully propagate and be available for use in a translation due to cache + * policies with the DataPlane service that performs the translations.

+ */ export class ImportTerminologyCommand extends $Command< ImportTerminologyCommandInput, ImportTerminologyCommandOutput, @@ -34,6 +44,9 @@ export class ImportTerminologyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/commands/ListTerminologiesCommand.ts b/clients/client-translate/commands/ListTerminologiesCommand.ts index aee80609e9eda..0d12c411a2198 100644 --- a/clients/client-translate/commands/ListTerminologiesCommand.ts +++ b/clients/client-translate/commands/ListTerminologiesCommand.ts @@ -20,6 +20,9 @@ import { export type ListTerminologiesCommandInput = ListTerminologiesRequest; export type ListTerminologiesCommandOutput = ListTerminologiesResponse & __MetadataBearer; +/** + *

Provides a list of custom terminologies associated with your account.

+ */ export class ListTerminologiesCommand extends $Command< ListTerminologiesCommandInput, ListTerminologiesCommandOutput, @@ -34,6 +37,9 @@ export class ListTerminologiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/commands/ListTextTranslationJobsCommand.ts b/clients/client-translate/commands/ListTextTranslationJobsCommand.ts index ac5affcd6a44f..f66182f6dfb07 100644 --- a/clients/client-translate/commands/ListTextTranslationJobsCommand.ts +++ b/clients/client-translate/commands/ListTextTranslationJobsCommand.ts @@ -20,6 +20,9 @@ import { export type ListTextTranslationJobsCommandInput = ListTextTranslationJobsRequest; export type ListTextTranslationJobsCommandOutput = ListTextTranslationJobsResponse & __MetadataBearer; +/** + *

Gets a list of the batch translation jobs that you have submitted.

+ */ export class ListTextTranslationJobsCommand extends $Command< ListTextTranslationJobsCommandInput, ListTextTranslationJobsCommandOutput, @@ -34,6 +37,9 @@ export class ListTextTranslationJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/commands/StartTextTranslationJobCommand.ts b/clients/client-translate/commands/StartTextTranslationJobCommand.ts index e417081d29618..129ac2bc58088 100644 --- a/clients/client-translate/commands/StartTextTranslationJobCommand.ts +++ b/clients/client-translate/commands/StartTextTranslationJobCommand.ts @@ -20,6 +20,16 @@ import { export type StartTextTranslationJobCommandInput = StartTextTranslationJobRequest; export type StartTextTranslationJobCommandOutput = StartTextTranslationJobResponse & __MetadataBearer; +/** + *

Starts an asynchronous batch translation job. Batch translation jobs can be used to + * translate large volumes of text across multiple documents at once. For more information, see + * async.

+ * + *

Batch translation jobs can be described with the DescribeTextTranslationJob operation, listed with the ListTextTranslationJobs operation, and stopped with the StopTextTranslationJob operation.

+ * + *

Amazon Translate does not support batch translation of multiple source languages at once.

+ *
+ */ export class StartTextTranslationJobCommand extends $Command< StartTextTranslationJobCommandInput, StartTextTranslationJobCommandOutput, @@ -34,6 +44,9 @@ export class StartTextTranslationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/commands/StopTextTranslationJobCommand.ts b/clients/client-translate/commands/StopTextTranslationJobCommand.ts index 7a1db90f716bc..e3957cebf748c 100644 --- a/clients/client-translate/commands/StopTextTranslationJobCommand.ts +++ b/clients/client-translate/commands/StopTextTranslationJobCommand.ts @@ -20,6 +20,15 @@ import { export type StopTextTranslationJobCommandInput = StopTextTranslationJobRequest; export type StopTextTranslationJobCommandOutput = StopTextTranslationJobResponse & __MetadataBearer; +/** + *

Stops an asynchronous batch translation job that is in progress.

+ *

If the job's state is IN_PROGRESS, the job will be marked for termination and + * put into the STOP_REQUESTED state. If the job completes before it can be stopped, + * it is put into the COMPLETED state. Otherwise, the job is put into the + * STOPPED state.

+ *

Asynchronous batch translation jobs are started with the StartTextTranslationJob operation. You can use the DescribeTextTranslationJob or ListTextTranslationJobs + * operations to get a batch translation job's JobId.

+ */ export class StopTextTranslationJobCommand extends $Command< StopTextTranslationJobCommandInput, StopTextTranslationJobCommandOutput, @@ -34,6 +43,9 @@ export class StopTextTranslationJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/commands/TranslateTextCommand.ts b/clients/client-translate/commands/TranslateTextCommand.ts index e17146cd2a0f0..c4da7c8060fa1 100644 --- a/clients/client-translate/commands/TranslateTextCommand.ts +++ b/clients/client-translate/commands/TranslateTextCommand.ts @@ -20,6 +20,10 @@ import { export type TranslateTextCommandInput = TranslateTextRequest; export type TranslateTextCommandOutput = TranslateTextResponse & __MetadataBearer; +/** + *

Translates input text from the source language to the target language. For a list of + * available languages and language codes, see what-is-languages.

+ */ export class TranslateTextCommand extends $Command< TranslateTextCommandInput, TranslateTextCommandOutput, @@ -34,6 +38,9 @@ export class TranslateTextCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: TranslateClientResolvedConfig, diff --git a/clients/client-translate/package.json b/clients/client-translate/package.json index 58dd87b2d885e..0d93d805c5d1e 100644 --- a/clients/client-translate/package.json +++ b/clients/client-translate/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Translate Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-translate/pagination/ListTerminologiesPaginator.ts b/clients/client-translate/pagination/ListTerminologiesPaginator.ts index 535810a16906c..0c48643358f8a 100644 --- a/clients/client-translate/pagination/ListTerminologiesPaginator.ts +++ b/clients/client-translate/pagination/ListTerminologiesPaginator.ts @@ -8,6 +8,9 @@ import { import { TranslatePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TranslateClient, input: ListTerminologiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTerminologiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Translate, input: ListTerminologiesCommandInput, diff --git a/clients/client-translate/pagination/ListTextTranslationJobsPaginator.ts b/clients/client-translate/pagination/ListTextTranslationJobsPaginator.ts index 9a817bb5eefb5..3671b36e833a9 100644 --- a/clients/client-translate/pagination/ListTextTranslationJobsPaginator.ts +++ b/clients/client-translate/pagination/ListTextTranslationJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { TranslatePaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: TranslateClient, input: ListTextTranslationJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListTextTranslationJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: Translate, input: ListTextTranslationJobsCommandInput, diff --git a/clients/client-translate/runtimeConfig.browser.ts b/clients/client-translate/runtimeConfig.browser.ts index 31f0645bbae4f..5a445e3ca9b95 100644 --- a/clients/client-translate/runtimeConfig.browser.ts +++ b/clients/client-translate/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./TranslateClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-translate/runtimeConfig.native.ts b/clients/client-translate/runtimeConfig.native.ts index d89a3b21a70ff..e6bd39b75c175 100644 --- a/clients/client-translate/runtimeConfig.native.ts +++ b/clients/client-translate/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./TranslateClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-translate/runtimeConfig.shared.ts b/clients/client-translate/runtimeConfig.shared.ts index f1604c64d9198..578c21facb396 100644 --- a/clients/client-translate/runtimeConfig.shared.ts +++ b/clients/client-translate/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-07-01", disableHostPrefix: false, diff --git a/clients/client-translate/runtimeConfig.ts b/clients/client-translate/runtimeConfig.ts index df93eaf9fb858..06c4382f37235 100644 --- a/clients/client-translate/runtimeConfig.ts +++ b/clients/client-translate/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./TranslateClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-translate/tsconfig.json b/clients/client-translate/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-translate/tsconfig.json +++ b/clients/client-translate/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-waf-regional/commands/AssociateWebACLCommand.ts b/clients/client-waf-regional/commands/AssociateWebACLCommand.ts index 29b01c9eda4c9..95504993287d5 100644 --- a/clients/client-waf-regional/commands/AssociateWebACLCommand.ts +++ b/clients/client-waf-regional/commands/AssociateWebACLCommand.ts @@ -20,6 +20,17 @@ import { export type AssociateWebACLCommandInput = AssociateWebACLRequest; export type AssociateWebACLCommandOutput = AssociateWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic Regional documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Associates a web ACL with a resource, either an application load balancer or Amazon API Gateway stage.

+ */ export class AssociateWebACLCommand extends $Command< AssociateWebACLCommandInput, AssociateWebACLCommandOutput, @@ -34,6 +45,9 @@ export class AssociateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateByteMatchSetCommand.ts b/clients/client-waf-regional/commands/CreateByteMatchSetCommand.ts index 5cba2e2feb18d..53cf4bc9d33a9 100644 --- a/clients/client-waf-regional/commands/CreateByteMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/CreateByteMatchSetCommand.ts @@ -20,6 +20,40 @@ import { export type CreateByteMatchSetCommandInput = CreateByteMatchSetRequest; export type CreateByteMatchSetCommandOutput = CreateByteMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a ByteMatchSet. You then use UpdateByteMatchSet to identify the part of a + * web request that you want AWS WAF to inspect, such as the values of the User-Agent header or the query string. + * For example, you can create a ByteMatchSet that matches any requests with User-Agent headers + * that contain the string BadBot. You can then configure AWS WAF to reject those requests.

+ *

To create and configure a ByteMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateByteMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateByteMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateByteMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateByteMatchSetCommand extends $Command< CreateByteMatchSetCommandInput, CreateByteMatchSetCommandOutput, @@ -34,6 +68,9 @@ export class CreateByteMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateGeoMatchSetCommand.ts b/clients/client-waf-regional/commands/CreateGeoMatchSetCommand.ts index 077c08c9f1e08..9c9562b3798b3 100644 --- a/clients/client-waf-regional/commands/CreateGeoMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/CreateGeoMatchSetCommand.ts @@ -20,6 +20,37 @@ import { export type CreateGeoMatchSetCommandInput = CreateGeoMatchSetRequest; export type CreateGeoMatchSetCommandOutput = CreateGeoMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates an GeoMatchSet, which you use to specify which web requests you want to allow or block based on the country + * that the requests originate from. For example, if you're receiving a lot of requests from one or more countries and you want to block the requests, you can create an GeoMatchSet that contains those countries and then configure AWS WAF to block the requests.

+ *

To create and configure a GeoMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateGeoMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateGeoMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateGeoMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateGeoMatchSetSet request to specify the countries that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateGeoMatchSetCommand extends $Command< CreateGeoMatchSetCommandInput, CreateGeoMatchSetCommandOutput, @@ -34,6 +65,9 @@ export class CreateGeoMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateIPSetCommand.ts b/clients/client-waf-regional/commands/CreateIPSetCommand.ts index 68a3d75577a26..2cd03cfbf5db1 100644 --- a/clients/client-waf-regional/commands/CreateIPSetCommand.ts +++ b/clients/client-waf-regional/commands/CreateIPSetCommand.ts @@ -20,6 +20,42 @@ import { export type CreateIPSetCommandInput = CreateIPSetRequest; export type CreateIPSetCommandOutput = CreateIPSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates an IPSet, which you use to specify which web requests + * that + * you want to allow or block based on the IP addresses that the requests + * originate from. For example, if you're receiving a lot of requests from one or more + * individual IP addresses or one or more ranges of IP addresses and you want to block the + * requests, you can create an IPSet that contains those IP addresses and then + * configure AWS WAF to block the requests.

+ *

To create and configure an IPSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateIPSet request.

    + *
  2. + *
  3. + *

    Submit a CreateIPSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateIPSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateIPSet request to specify the IP addresses that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateIPSetCommand extends $Command< CreateIPSetCommandInput, CreateIPSetCommandOutput, @@ -34,6 +70,9 @@ export class CreateIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateRateBasedRuleCommand.ts b/clients/client-waf-regional/commands/CreateRateBasedRuleCommand.ts index 772aacda1a367..5d19c59fe9c46 100644 --- a/clients/client-waf-regional/commands/CreateRateBasedRuleCommand.ts +++ b/clients/client-waf-regional/commands/CreateRateBasedRuleCommand.ts @@ -20,6 +20,102 @@ import { export type CreateRateBasedRuleCommandInput = CreateRateBasedRuleRequest; export type CreateRateBasedRuleCommandOutput = CreateRateBasedRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a RateBasedRule. The RateBasedRule contains a + * RateLimit, which specifies the maximum number of requests that AWS WAF allows + * from a specified IP address in a five-minute period. + * The RateBasedRule also + * contains the IPSet objects, ByteMatchSet objects, and other + * predicates that identify the requests that you want to count or block if these requests + * exceed the RateLimit.

+ *

If you add more than one predicate to a RateBasedRule, a request not + * only must exceed the RateLimit, but it also must match all the + * conditions to be counted or blocked. For example, suppose you add the following to a + * RateBasedRule:

+ *
    + *
  • + *

    An IPSet that matches the IP address 192.0.2.44/32 + *

    + *
  • + *
  • + *

    A ByteMatchSet that matches BadBot in the + * User-Agent header

    + *
  • + *
+ *

Further, you specify a RateLimit of 1,000.

+ *

You then add the RateBasedRule to a WebACL and specify that + * you want to block requests that meet the conditions in the rule. For a request to be + * blocked, it must come from the IP address 192.0.2.44 and the + * User-Agent header in the request must contain the value + * BadBot. Further, requests that match these two conditions must be received at + * a rate of more than 1,000 requests every five minutes. If both conditions are met and the + * rate is exceeded, AWS WAF blocks the requests. If the rate drops below 1,000 for a + * five-minute period, AWS WAF no longer blocks the requests.

+ * + *

As a second example, suppose you want to limit requests to a particular page on your site. To do this, you could add the following to a + * RateBasedRule:

+ * + * + *
    + *
  • + *

    A ByteMatchSet with FieldToMatch of URI + *

    + *
  • + *
  • + *

    A PositionalConstraint of STARTS_WITH + *

    + *
  • + *
  • + *

    A TargetString of login + *

    + *
  • + *
+ *

Further, you specify a RateLimit of 1,000.

+ *

By adding this RateBasedRule to a WebACL, you could limit requests to your login page without affecting the rest of your site.

+ * + * + *

To create and configure a RateBasedRule, perform the following + * steps:

+ *
    + *
  1. + *

    Create and update the predicates that you want to include in the rule. For more + * information, see CreateByteMatchSet, CreateIPSet, + * and CreateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide + * in the ChangeToken parameter of a CreateRule + * request.

    + *
  4. + *
  5. + *

    Submit a CreateRateBasedRule request.

    + *
  6. + *
  7. + *

    Use GetChangeToken to get the change token that you provide in the + * ChangeToken parameter of an UpdateRule + * request.

    + *
  8. + *
  9. + *

    Submit an UpdateRateBasedRule request to specify the predicates + * that you want to include in the rule.

    + *
  10. + *
  11. + *

    Create and update a WebACL that contains the + * RateBasedRule. For more information, see CreateWebACL.

    + *
  12. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, + * see the AWS WAF Developer + * Guide.

+ */ export class CreateRateBasedRuleCommand extends $Command< CreateRateBasedRuleCommandInput, CreateRateBasedRuleCommandOutput, @@ -34,6 +130,9 @@ export class CreateRateBasedRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateRegexMatchSetCommand.ts b/clients/client-waf-regional/commands/CreateRegexMatchSetCommand.ts index b96b8d4d4d64c..1647af9a6d31c 100644 --- a/clients/client-waf-regional/commands/CreateRegexMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/CreateRegexMatchSetCommand.ts @@ -20,6 +20,40 @@ import { export type CreateRegexMatchSetCommandInput = CreateRegexMatchSetRequest; export type CreateRegexMatchSetCommandOutput = CreateRegexMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a RegexMatchSet. You then use UpdateRegexMatchSet to identify the part of a + * web request that you want AWS WAF to inspect, such as the values of the User-Agent header or the query string. + * For example, you can create a RegexMatchSet that contains a RegexMatchTuple that looks for any requests with User-Agent headers + * that match a RegexPatternSet with pattern B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

+ *

To create and configure a RegexMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateRegexMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateRegexMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRegexMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateRegexMatchSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value, using a RegexPatternSet, that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateRegexMatchSetCommand extends $Command< CreateRegexMatchSetCommandInput, CreateRegexMatchSetCommandOutput, @@ -34,6 +68,9 @@ export class CreateRegexMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateRegexPatternSetCommand.ts b/clients/client-waf-regional/commands/CreateRegexPatternSetCommand.ts index 9f18359f87409..be32ecfa92764 100644 --- a/clients/client-waf-regional/commands/CreateRegexPatternSetCommand.ts +++ b/clients/client-waf-regional/commands/CreateRegexPatternSetCommand.ts @@ -20,6 +20,36 @@ import { export type CreateRegexPatternSetCommandInput = CreateRegexPatternSetRequest; export type CreateRegexPatternSetCommandOutput = CreateRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a RegexPatternSet. You then use UpdateRegexPatternSet to specify the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

+ *

To create and configure a RegexPatternSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateRegexPatternSet request.

    + *
  2. + *
  3. + *

    Submit a CreateRegexPatternSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRegexPatternSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateRegexPatternSet request to specify the string that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateRegexPatternSetCommand extends $Command< CreateRegexPatternSetCommandInput, CreateRegexPatternSetCommandOutput, @@ -34,6 +64,9 @@ export class CreateRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateRuleCommand.ts b/clients/client-waf-regional/commands/CreateRuleCommand.ts index 385d292659deb..26a817f49cdef 100644 --- a/clients/client-waf-regional/commands/CreateRuleCommand.ts +++ b/clients/client-waf-regional/commands/CreateRuleCommand.ts @@ -20,6 +20,60 @@ import { export type CreateRuleCommandInput = CreateRuleRequest; export type CreateRuleCommandOutput = CreateRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a Rule, which contains the IPSet objects, + * ByteMatchSet objects, and other predicates that identify the requests that + * you want to block. If you add more than one predicate to a Rule, a request + * must match all of the specifications to be allowed or blocked. For example, suppose + * that + * you add the following to a Rule:

+ *
    + *
  • + *

    An IPSet that matches the IP address 192.0.2.44/32 + *

    + *
  • + *
  • + *

    A ByteMatchSet that matches BadBot in the User-Agent header

    + *
  • + *
+ *

You then add the Rule to a WebACL and specify that you want to blocks requests that satisfy the Rule. + * For a request to be blocked, it must come from the IP address 192.0.2.44 and the User-Agent header in the request + * must contain the value BadBot.

+ *

To create and configure a Rule, perform the following steps:

+ *
    + *
  1. + *

    Create and update the predicates that you want to include in the Rule. For more information, see + * CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateRule request.

    + *
  4. + *
  5. + *

    Submit a CreateRule request.

    + *
  6. + *
  7. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRule request.

    + *
  8. + *
  9. + *

    Submit an UpdateRule request to specify the predicates that you want to include in the Rule.

    + *
  10. + *
  11. + *

    Create and update a WebACL that contains the Rule. For more information, see CreateWebACL.

    + *
  12. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateRuleCommand extends $Command< CreateRuleCommandInput, CreateRuleCommandOutput, @@ -34,6 +88,9 @@ export class CreateRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateRuleGroupCommand.ts b/clients/client-waf-regional/commands/CreateRuleGroupCommand.ts index 918dd574a6e9d..acd59f6033493 100644 --- a/clients/client-waf-regional/commands/CreateRuleGroupCommand.ts +++ b/clients/client-waf-regional/commands/CreateRuleGroupCommand.ts @@ -20,6 +20,31 @@ import { export type CreateRuleGroupCommandInput = CreateRuleGroupRequest; export type CreateRuleGroupCommandOutput = CreateRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a RuleGroup. A rule group is a collection of predefined rules that you add to a web ACL. You use UpdateRuleGroup to add rules to the rule group.

+ *

Rule groups are subject to the following limits:

+ *
    + *
  • + *

    Three rule groups per account. You can request an increase to this limit by contacting customer support.

    + *
  • + *
  • + *

    One rule group per web ACL.

    + *
  • + *
  • + *

    Ten rules per rule group.

    + *
  • + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateRuleGroupCommand extends $Command< CreateRuleGroupCommandInput, CreateRuleGroupCommandOutput, @@ -34,6 +59,9 @@ export class CreateRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateSizeConstraintSetCommand.ts b/clients/client-waf-regional/commands/CreateSizeConstraintSetCommand.ts index 6674c16b770bc..d2b63a288581a 100644 --- a/clients/client-waf-regional/commands/CreateSizeConstraintSetCommand.ts +++ b/clients/client-waf-regional/commands/CreateSizeConstraintSetCommand.ts @@ -20,6 +20,40 @@ import { export type CreateSizeConstraintSetCommandInput = CreateSizeConstraintSetRequest; export type CreateSizeConstraintSetCommandOutput = CreateSizeConstraintSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a SizeConstraintSet. You then use UpdateSizeConstraintSet to identify the part of a + * web request that you want AWS WAF to check for length, such as the length of the User-Agent header or the length of the query string. + * For example, you can create a SizeConstraintSet that matches any requests that have a query string that is longer than 100 bytes. + * You can then configure AWS WAF to reject those requests.

+ *

To create and configure a SizeConstraintSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateSizeConstraintSet request.

    + *
  2. + *
  3. + *

    Submit a CreateSizeConstraintSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateSizeConstraintSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateSizeConstraintSetCommand extends $Command< CreateSizeConstraintSetCommandInput, CreateSizeConstraintSetCommandOutput, @@ -34,6 +68,9 @@ export class CreateSizeConstraintSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateSqlInjectionMatchSetCommand.ts b/clients/client-waf-regional/commands/CreateSqlInjectionMatchSetCommand.ts index 99668c39748dd..527eaa7fe9e62 100644 --- a/clients/client-waf-regional/commands/CreateSqlInjectionMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/CreateSqlInjectionMatchSetCommand.ts @@ -20,6 +20,38 @@ import { export type CreateSqlInjectionMatchSetCommandInput = CreateSqlInjectionMatchSetRequest; export type CreateSqlInjectionMatchSetCommandOutput = CreateSqlInjectionMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a SqlInjectionMatchSet, which you use to allow, block, or count requests that contain snippets of SQL code in a + * specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.

+ *

To create and configure a SqlInjectionMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateSqlInjectionMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateSqlInjectionMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateSqlInjectionMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests in which you want to + * allow, block, or count malicious SQL code.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateSqlInjectionMatchSetCommand extends $Command< CreateSqlInjectionMatchSetCommandInput, CreateSqlInjectionMatchSetCommandOutput, @@ -34,6 +66,9 @@ export class CreateSqlInjectionMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateWebACLCommand.ts b/clients/client-waf-regional/commands/CreateWebACLCommand.ts index 7cda5bc6592bb..f043b67ef1118 100644 --- a/clients/client-waf-regional/commands/CreateWebACLCommand.ts +++ b/clients/client-waf-regional/commands/CreateWebACLCommand.ts @@ -20,6 +20,48 @@ import { export type CreateWebACLCommandInput = CreateWebACLRequest; export type CreateWebACLCommandOutput = CreateWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a WebACL, which contains the Rules that identify the CloudFront web requests that you want to allow, block, or count. + * AWS WAF evaluates Rules in order based on the value of Priority for each Rule.

+ *

You also specify a default action, either ALLOW or BLOCK. If a web request doesn't match + * any of the Rules in a WebACL, AWS WAF responds to the request with the default action.

+ *

To create and configure a WebACL, perform the following steps:

+ *
    + *
  1. + *

    Create and update the ByteMatchSet objects and other predicates that you want to include in Rules. + * For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, + * CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Create and update the Rules that you want to include in the WebACL. For more information, see + * CreateRule and UpdateRule.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateWebACL request.

    + *
  6. + *
  7. + *

    Submit a CreateWebACL request.

    + *
  8. + *
  9. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateWebACL request.

    + *
  10. + *
  11. + *

    Submit an UpdateWebACL request to specify the Rules that you want to include in the WebACL, + * to specify the default action, and to associate the WebACL with a CloudFront distribution.

    + *
  12. + *
+ *

For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide.

+ */ export class CreateWebACLCommand extends $Command< CreateWebACLCommandInput, CreateWebACLCommandOutput, @@ -34,6 +76,9 @@ export class CreateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateWebACLMigrationStackCommand.ts b/clients/client-waf-regional/commands/CreateWebACLMigrationStackCommand.ts index 598f20cefa7e5..c6291033b55fb 100644 --- a/clients/client-waf-regional/commands/CreateWebACLMigrationStackCommand.ts +++ b/clients/client-waf-regional/commands/CreateWebACLMigrationStackCommand.ts @@ -20,6 +20,16 @@ import { export type CreateWebACLMigrationStackCommandInput = CreateWebACLMigrationStackRequest; export type CreateWebACLMigrationStackCommandOutput = CreateWebACLMigrationStackResponse & __MetadataBearer; +/** + *

Creates an AWS CloudFormation WAFV2 template for the specified web ACL in the specified Amazon S3 bucket. + * Then, in CloudFormation, you create a stack from the template, to create the web ACL and its resources in AWS WAFV2. + * Use this to migrate your AWS WAF Classic web ACL to the latest version of AWS WAF.

+ *

This is part of a larger migration procedure for web ACLs from AWS WAF Classic to the latest version of AWS WAF. + * For the full procedure, including caveats and manual steps to complete + * the migration and switch over to the new web ACL, see + * Migrating your AWS WAF Classic resources to AWS WAF in the AWS WAF + * Developer Guide.

+ */ export class CreateWebACLMigrationStackCommand extends $Command< CreateWebACLMigrationStackCommandInput, CreateWebACLMigrationStackCommandOutput, @@ -34,6 +44,9 @@ export class CreateWebACLMigrationStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/CreateXssMatchSetCommand.ts b/clients/client-waf-regional/commands/CreateXssMatchSetCommand.ts index b84fdba90e684..aa0f7a4f0f49c 100644 --- a/clients/client-waf-regional/commands/CreateXssMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/CreateXssMatchSetCommand.ts @@ -20,6 +20,38 @@ import { export type CreateXssMatchSetCommandInput = CreateXssMatchSetRequest; export type CreateXssMatchSetCommandOutput = CreateXssMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates an XssMatchSet, which you use to allow, block, or count requests that contain cross-site scripting attacks + * in the specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.

+ *

To create and configure an XssMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateXssMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateXssMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateXssMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateXssMatchSet request to specify the parts of web requests in which you want to + * allow, block, or count cross-site scripting attacks.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateXssMatchSetCommand extends $Command< CreateXssMatchSetCommandInput, CreateXssMatchSetCommandOutput, @@ -34,6 +66,9 @@ export class CreateXssMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteByteMatchSetCommand.ts b/clients/client-waf-regional/commands/DeleteByteMatchSetCommand.ts index 9eea22a783706..11cd1f02334ca 100644 --- a/clients/client-waf-regional/commands/DeleteByteMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/DeleteByteMatchSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteByteMatchSetCommandInput = DeleteByteMatchSetRequest; export type DeleteByteMatchSetCommandOutput = DeleteByteMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a ByteMatchSet. You can't delete a ByteMatchSet if it's still used in any Rules + * or if it still includes any ByteMatchTuple objects (any filters).

+ *

If you just want to remove a ByteMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete a ByteMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Update the ByteMatchSet to remove filters, if any. For more information, see UpdateByteMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteByteMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteByteMatchSet request.

    + *
  6. + *
+ */ export class DeleteByteMatchSetCommand extends $Command< DeleteByteMatchSetCommandInput, DeleteByteMatchSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteByteMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteGeoMatchSetCommand.ts b/clients/client-waf-regional/commands/DeleteGeoMatchSetCommand.ts index 1fe868a16762b..3382ef74804c6 100644 --- a/clients/client-waf-regional/commands/DeleteGeoMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/DeleteGeoMatchSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteGeoMatchSetCommandInput = DeleteGeoMatchSetRequest; export type DeleteGeoMatchSetCommandOutput = DeleteGeoMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a GeoMatchSet. You can't delete a GeoMatchSet if it's still used in any Rules or + * if it still includes any countries.

+ *

If you just want to remove a GeoMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete a GeoMatchSet from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the GeoMatchSet to remove any countries. For more information, see UpdateGeoMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteGeoMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteGeoMatchSet request.

    + *
  6. + *
+ */ export class DeleteGeoMatchSetCommand extends $Command< DeleteGeoMatchSetCommandInput, DeleteGeoMatchSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteGeoMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteIPSetCommand.ts b/clients/client-waf-regional/commands/DeleteIPSetCommand.ts index d553b3432424d..b755aa4899845 100644 --- a/clients/client-waf-regional/commands/DeleteIPSetCommand.ts +++ b/clients/client-waf-regional/commands/DeleteIPSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteIPSetCommandInput = DeleteIPSetRequest; export type DeleteIPSetCommandOutput = DeleteIPSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes an IPSet. You can't delete an IPSet if it's still used in any Rules or + * if it still includes any IP addresses.

+ *

If you just want to remove an IPSet from a Rule, use UpdateRule.

+ *

To permanently delete an IPSet from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the IPSet to remove IP address ranges, if any. For more information, see UpdateIPSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteIPSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteIPSet request.

    + *
  6. + *
+ */ export class DeleteIPSetCommand extends $Command< DeleteIPSetCommandInput, DeleteIPSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteLoggingConfigurationCommand.ts b/clients/client-waf-regional/commands/DeleteLoggingConfigurationCommand.ts index ddeb5e783e307..4152d6f8cc681 100644 --- a/clients/client-waf-regional/commands/DeleteLoggingConfigurationCommand.ts +++ b/clients/client-waf-regional/commands/DeleteLoggingConfigurationCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteLoggingConfigurationCommandInput = DeleteLoggingConfigurationRequest; export type DeleteLoggingConfigurationCommandOutput = DeleteLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes the LoggingConfiguration from the specified web + * ACL.

+ */ export class DeleteLoggingConfigurationCommand extends $Command< DeleteLoggingConfigurationCommandInput, DeleteLoggingConfigurationCommandOutput, @@ -34,6 +46,9 @@ export class DeleteLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeletePermissionPolicyCommand.ts b/clients/client-waf-regional/commands/DeletePermissionPolicyCommand.ts index 2a342ef7430a4..1f8bee3aa303a 100644 --- a/clients/client-waf-regional/commands/DeletePermissionPolicyCommand.ts +++ b/clients/client-waf-regional/commands/DeletePermissionPolicyCommand.ts @@ -20,6 +20,18 @@ import { export type DeletePermissionPolicyCommandInput = DeletePermissionPolicyRequest; export type DeletePermissionPolicyCommandOutput = DeletePermissionPolicyResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes an IAM policy from the specified RuleGroup.

+ *

The user making the request must be the owner of the RuleGroup.

+ */ export class DeletePermissionPolicyCommand extends $Command< DeletePermissionPolicyCommandInput, DeletePermissionPolicyCommandOutput, @@ -34,6 +46,9 @@ export class DeletePermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteRateBasedRuleCommand.ts b/clients/client-waf-regional/commands/DeleteRateBasedRuleCommand.ts index 531416b8ce1e0..e2f23cb66b815 100644 --- a/clients/client-waf-regional/commands/DeleteRateBasedRuleCommand.ts +++ b/clients/client-waf-regional/commands/DeleteRateBasedRuleCommand.ts @@ -20,6 +20,36 @@ import { export type DeleteRateBasedRuleCommandInput = DeleteRateBasedRuleRequest; export type DeleteRateBasedRuleCommandOutput = DeleteRateBasedRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a RateBasedRule. You can't delete a rule if + * it's still used in any WebACL objects or if it still includes any predicates, + * such as ByteMatchSet objects.

+ *

If you just want to remove a rule from a WebACL, use UpdateWebACL.

+ *

To permanently delete a RateBasedRule from AWS WAF, perform the following + * steps:

+ *
    + *
  1. + *

    Update the RateBasedRule to remove predicates, if any. For more + * information, see UpdateRateBasedRule.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide + * in the ChangeToken parameter of a DeleteRateBasedRule + * request.

    + *
  4. + *
  5. + *

    Submit a DeleteRateBasedRule request.

    + *
  6. + *
+ */ export class DeleteRateBasedRuleCommand extends $Command< DeleteRateBasedRuleCommandInput, DeleteRateBasedRuleCommandOutput, @@ -34,6 +64,9 @@ export class DeleteRateBasedRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteRegexMatchSetCommand.ts b/clients/client-waf-regional/commands/DeleteRegexMatchSetCommand.ts index 2e5afc77c9c98..00858ad8e8a6c 100644 --- a/clients/client-waf-regional/commands/DeleteRegexMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/DeleteRegexMatchSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteRegexMatchSetCommandInput = DeleteRegexMatchSetRequest; export type DeleteRegexMatchSetCommandOutput = DeleteRegexMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a RegexMatchSet. You can't delete a RegexMatchSet if it's still used in any Rules + * or if it still includes any RegexMatchTuples objects (any filters).

+ *

If you just want to remove a RegexMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete a RegexMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Update the RegexMatchSet to remove filters, if any. For more information, see UpdateRegexMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteRegexMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteRegexMatchSet request.

    + *
  6. + *
+ */ export class DeleteRegexMatchSetCommand extends $Command< DeleteRegexMatchSetCommandInput, DeleteRegexMatchSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteRegexMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteRegexPatternSetCommand.ts b/clients/client-waf-regional/commands/DeleteRegexPatternSetCommand.ts index 61c643cef2dd3..b22ffd5640412 100644 --- a/clients/client-waf-regional/commands/DeleteRegexPatternSetCommand.ts +++ b/clients/client-waf-regional/commands/DeleteRegexPatternSetCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteRegexPatternSetCommandInput = DeleteRegexPatternSetRequest; export type DeleteRegexPatternSetCommandOutput = DeleteRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a RegexPatternSet. You can't delete a RegexPatternSet if it's still used in any RegexMatchSet + * or if the RegexPatternSet is not empty.

+ */ export class DeleteRegexPatternSetCommand extends $Command< DeleteRegexPatternSetCommandInput, DeleteRegexPatternSetCommandOutput, @@ -34,6 +46,9 @@ export class DeleteRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteRuleCommand.ts b/clients/client-waf-regional/commands/DeleteRuleCommand.ts index 7acdf9a9279f7..6ed807942c49e 100644 --- a/clients/client-waf-regional/commands/DeleteRuleCommand.ts +++ b/clients/client-waf-regional/commands/DeleteRuleCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteRuleCommandInput = DeleteRuleRequest; export type DeleteRuleCommandOutput = DeleteRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a Rule. You can't delete a Rule if it's still used in any WebACL + * objects or if it still includes any predicates, such as ByteMatchSet objects.

+ *

If you just want to remove a Rule from a WebACL, use UpdateWebACL.

+ *

To permanently delete a Rule from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the Rule to remove predicates, if any. For more information, see UpdateRule.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteRule request.

    + *
  4. + *
  5. + *

    Submit a DeleteRule request.

    + *
  6. + *
+ */ export class DeleteRuleCommand extends $Command< DeleteRuleCommandInput, DeleteRuleCommandOutput, @@ -34,6 +60,9 @@ export class DeleteRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteRuleGroupCommand.ts b/clients/client-waf-regional/commands/DeleteRuleGroupCommand.ts index 2c536187f06f5..9e261c2834122 100644 --- a/clients/client-waf-regional/commands/DeleteRuleGroupCommand.ts +++ b/clients/client-waf-regional/commands/DeleteRuleGroupCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteRuleGroupCommandInput = DeleteRuleGroupRequest; export type DeleteRuleGroupCommandOutput = DeleteRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a RuleGroup. You can't delete a RuleGroup if it's still used in any WebACL + * objects or if it still includes any rules.

+ *

If you just want to remove a RuleGroup from a WebACL, use UpdateWebACL.

+ *

To permanently delete a RuleGroup from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the RuleGroup to remove rules, if any. For more information, see UpdateRuleGroup.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteRuleGroup request.

    + *
  4. + *
  5. + *

    Submit a DeleteRuleGroup request.

    + *
  6. + *
+ */ export class DeleteRuleGroupCommand extends $Command< DeleteRuleGroupCommandInput, DeleteRuleGroupCommandOutput, @@ -34,6 +60,9 @@ export class DeleteRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteSizeConstraintSetCommand.ts b/clients/client-waf-regional/commands/DeleteSizeConstraintSetCommand.ts index cb67872cc065f..8deb8828397db 100644 --- a/clients/client-waf-regional/commands/DeleteSizeConstraintSetCommand.ts +++ b/clients/client-waf-regional/commands/DeleteSizeConstraintSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteSizeConstraintSetCommandInput = DeleteSizeConstraintSetRequest; export type DeleteSizeConstraintSetCommandOutput = DeleteSizeConstraintSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a SizeConstraintSet. You can't delete a SizeConstraintSet if it's still used in any Rules + * or if it still includes any SizeConstraint objects (any filters).

+ *

If you just want to remove a SizeConstraintSet from a Rule, use UpdateRule.

+ *

To permanently delete a SizeConstraintSet, perform the following steps:

+ *
    + *
  1. + *

    Update the SizeConstraintSet to remove filters, if any. For more information, see UpdateSizeConstraintSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteSizeConstraintSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteSizeConstraintSet request.

    + *
  6. + *
+ */ export class DeleteSizeConstraintSetCommand extends $Command< DeleteSizeConstraintSetCommandInput, DeleteSizeConstraintSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteSizeConstraintSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteSqlInjectionMatchSetCommand.ts b/clients/client-waf-regional/commands/DeleteSqlInjectionMatchSetCommand.ts index ebbf39811d67a..0f7567114aff2 100644 --- a/clients/client-waf-regional/commands/DeleteSqlInjectionMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/DeleteSqlInjectionMatchSetCommand.ts @@ -20,6 +20,33 @@ import { export type DeleteSqlInjectionMatchSetCommandInput = DeleteSqlInjectionMatchSetRequest; export type DeleteSqlInjectionMatchSetCommandOutput = DeleteSqlInjectionMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a SqlInjectionMatchSet. You can't delete a SqlInjectionMatchSet if it's + * still used in any Rules or if it still contains any SqlInjectionMatchTuple objects.

+ *

If you just want to remove a SqlInjectionMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete a SqlInjectionMatchSet from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the SqlInjectionMatchSet to remove filters, if any. For more information, see + * UpdateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteSqlInjectionMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteSqlInjectionMatchSet request.

    + *
  6. + *
+ */ export class DeleteSqlInjectionMatchSetCommand extends $Command< DeleteSqlInjectionMatchSetCommandInput, DeleteSqlInjectionMatchSetCommandOutput, @@ -34,6 +61,9 @@ export class DeleteSqlInjectionMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteWebACLCommand.ts b/clients/client-waf-regional/commands/DeleteWebACLCommand.ts index 9f44767a9f9e6..07e2cc3a8c484 100644 --- a/clients/client-waf-regional/commands/DeleteWebACLCommand.ts +++ b/clients/client-waf-regional/commands/DeleteWebACLCommand.ts @@ -20,6 +20,30 @@ import { export type DeleteWebACLCommandInput = DeleteWebACLRequest; export type DeleteWebACLCommandOutput = DeleteWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a WebACL. You can't delete a WebACL if it still contains any Rules.

+ *

To delete a WebACL, perform the following steps:

+ *
    + *
  1. + *

    Update the WebACL to remove Rules, if any. For more information, see UpdateWebACL.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteWebACL request.

    + *
  4. + *
  5. + *

    Submit a DeleteWebACL request.

    + *
  6. + *
+ */ export class DeleteWebACLCommand extends $Command< DeleteWebACLCommandInput, DeleteWebACLCommandOutput, @@ -34,6 +58,9 @@ export class DeleteWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DeleteXssMatchSetCommand.ts b/clients/client-waf-regional/commands/DeleteXssMatchSetCommand.ts index 36447903ce9fd..3bce59c45202f 100644 --- a/clients/client-waf-regional/commands/DeleteXssMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/DeleteXssMatchSetCommand.ts @@ -20,6 +20,33 @@ import { export type DeleteXssMatchSetCommandInput = DeleteXssMatchSetRequest; export type DeleteXssMatchSetCommandOutput = DeleteXssMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes an XssMatchSet. You can't delete an XssMatchSet if it's + * still used in any Rules or if it still contains any XssMatchTuple objects.

+ *

If you just want to remove an XssMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete an XssMatchSet from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the XssMatchSet to remove filters, if any. For more information, see + * UpdateXssMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteXssMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteXssMatchSet request.

    + *
  6. + *
+ */ export class DeleteXssMatchSetCommand extends $Command< DeleteXssMatchSetCommandInput, DeleteXssMatchSetCommandOutput, @@ -34,6 +61,9 @@ export class DeleteXssMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/DisassociateWebACLCommand.ts b/clients/client-waf-regional/commands/DisassociateWebACLCommand.ts index 21932f04f6b94..925632c4f68d5 100644 --- a/clients/client-waf-regional/commands/DisassociateWebACLCommand.ts +++ b/clients/client-waf-regional/commands/DisassociateWebACLCommand.ts @@ -20,6 +20,17 @@ import { export type DisassociateWebACLCommandInput = DisassociateWebACLRequest; export type DisassociateWebACLCommandOutput = DisassociateWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic Regional documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Removes a web ACL from the specified resource, either an application load balancer or Amazon API Gateway stage.

+ */ export class DisassociateWebACLCommand extends $Command< DisassociateWebACLCommandInput, DisassociateWebACLCommandOutput, @@ -34,6 +45,9 @@ export class DisassociateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetByteMatchSetCommand.ts b/clients/client-waf-regional/commands/GetByteMatchSetCommand.ts index 7a0ac97cd4502..50675d58686eb 100644 --- a/clients/client-waf-regional/commands/GetByteMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/GetByteMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetByteMatchSetCommandInput = GetByteMatchSetRequest; export type GetByteMatchSetCommandOutput = GetByteMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the ByteMatchSet specified by ByteMatchSetId.

+ */ export class GetByteMatchSetCommand extends $Command< GetByteMatchSetCommandInput, GetByteMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetByteMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetChangeTokenCommand.ts b/clients/client-waf-regional/commands/GetChangeTokenCommand.ts index 56cbf0f27a615..a53d6cbe324df 100644 --- a/clients/client-waf-regional/commands/GetChangeTokenCommand.ts +++ b/clients/client-waf-regional/commands/GetChangeTokenCommand.ts @@ -20,6 +20,23 @@ import { export type GetChangeTokenCommandInput = GetChangeTokenRequest; export type GetChangeTokenCommandOutput = GetChangeTokenResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

When you want to create, update, or delete AWS WAF objects, get a change token and include the change token in the create, update, or delete request. Change tokens ensure that your application doesn't submit conflicting requests to AWS WAF.

+ *

Each create, update, or delete request must use a unique change token. If your application submits a GetChangeToken request + * and then submits a second GetChangeToken request before submitting a create, update, or delete request, the second + * GetChangeToken request returns the same value as the first GetChangeToken request.

+ *

When you use a change token in a create, update, or delete request, the status of the change token changes to PENDING, + * which indicates that AWS WAF is propagating the change to all AWS WAF servers. Use GetChangeTokenStatus to determine the + * status of your change token.

+ */ export class GetChangeTokenCommand extends $Command< GetChangeTokenCommandInput, GetChangeTokenCommandOutput, @@ -34,6 +51,9 @@ export class GetChangeTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetChangeTokenStatusCommand.ts b/clients/client-waf-regional/commands/GetChangeTokenStatusCommand.ts index 72ae40daf4483..5cc4a514abdca 100644 --- a/clients/client-waf-regional/commands/GetChangeTokenStatusCommand.ts +++ b/clients/client-waf-regional/commands/GetChangeTokenStatusCommand.ts @@ -20,6 +20,33 @@ import { export type GetChangeTokenStatusCommandInput = GetChangeTokenStatusRequest; export type GetChangeTokenStatusCommandOutput = GetChangeTokenStatusResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the status of a ChangeToken that you got by calling GetChangeToken. ChangeTokenStatus is + * one of the following values:

+ *
    + *
  • + *

    + * PROVISIONED: You requested the change token by calling GetChangeToken, but you haven't used it yet + * in a call to create, update, or delete an AWS WAF object.

    + *
  • + *
  • + *

    + * PENDING: AWS WAF is propagating the create, update, or delete request to all AWS WAF servers.

    + *
  • + *
  • + *

    + * INSYNC: Propagation is complete.

    + *
  • + *
+ */ export class GetChangeTokenStatusCommand extends $Command< GetChangeTokenStatusCommandInput, GetChangeTokenStatusCommandOutput, @@ -34,6 +61,9 @@ export class GetChangeTokenStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetGeoMatchSetCommand.ts b/clients/client-waf-regional/commands/GetGeoMatchSetCommand.ts index 54daf2f513539..45ee77e6b9b65 100644 --- a/clients/client-waf-regional/commands/GetGeoMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/GetGeoMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetGeoMatchSetCommandInput = GetGeoMatchSetRequest; export type GetGeoMatchSetCommandOutput = GetGeoMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the GeoMatchSet that is specified by GeoMatchSetId.

+ */ export class GetGeoMatchSetCommand extends $Command< GetGeoMatchSetCommandInput, GetGeoMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetGeoMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetIPSetCommand.ts b/clients/client-waf-regional/commands/GetIPSetCommand.ts index 34412798580da..21abb23ab4e63 100644 --- a/clients/client-waf-regional/commands/GetIPSetCommand.ts +++ b/clients/client-waf-regional/commands/GetIPSetCommand.ts @@ -17,6 +17,17 @@ import { export type GetIPSetCommandInput = GetIPSetRequest; export type GetIPSetCommandOutput = GetIPSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the IPSet that is specified by IPSetId.

+ */ export class GetIPSetCommand extends $Command< GetIPSetCommandInput, GetIPSetCommandOutput, @@ -31,6 +42,9 @@ export class GetIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetLoggingConfigurationCommand.ts b/clients/client-waf-regional/commands/GetLoggingConfigurationCommand.ts index d7080cbcb15c3..84bb7ff3d844a 100644 --- a/clients/client-waf-regional/commands/GetLoggingConfigurationCommand.ts +++ b/clients/client-waf-regional/commands/GetLoggingConfigurationCommand.ts @@ -20,6 +20,17 @@ import { export type GetLoggingConfigurationCommandInput = GetLoggingConfigurationRequest; export type GetLoggingConfigurationCommandOutput = GetLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the LoggingConfiguration for the specified web ACL.

+ */ export class GetLoggingConfigurationCommand extends $Command< GetLoggingConfigurationCommandInput, GetLoggingConfigurationCommandOutput, @@ -34,6 +45,9 @@ export class GetLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetPermissionPolicyCommand.ts b/clients/client-waf-regional/commands/GetPermissionPolicyCommand.ts index 46e21ffcbac9a..888cc36fb1529 100644 --- a/clients/client-waf-regional/commands/GetPermissionPolicyCommand.ts +++ b/clients/client-waf-regional/commands/GetPermissionPolicyCommand.ts @@ -20,6 +20,17 @@ import { export type GetPermissionPolicyCommandInput = GetPermissionPolicyRequest; export type GetPermissionPolicyCommandOutput = GetPermissionPolicyResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the IAM policy attached to the RuleGroup.

+ */ export class GetPermissionPolicyCommand extends $Command< GetPermissionPolicyCommandInput, GetPermissionPolicyCommandOutput, @@ -34,6 +45,9 @@ export class GetPermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetRateBasedRuleCommand.ts b/clients/client-waf-regional/commands/GetRateBasedRuleCommand.ts index 36edb5e4c98f4..c403bfbe07fbf 100644 --- a/clients/client-waf-regional/commands/GetRateBasedRuleCommand.ts +++ b/clients/client-waf-regional/commands/GetRateBasedRuleCommand.ts @@ -20,6 +20,19 @@ import { export type GetRateBasedRuleCommandInput = GetRateBasedRuleRequest; export type GetRateBasedRuleCommandOutput = GetRateBasedRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the RateBasedRule that is specified by the + * RuleId that you included in the GetRateBasedRule + * request.

+ */ export class GetRateBasedRuleCommand extends $Command< GetRateBasedRuleCommandInput, GetRateBasedRuleCommandOutput, @@ -34,6 +47,9 @@ export class GetRateBasedRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetRateBasedRuleManagedKeysCommand.ts b/clients/client-waf-regional/commands/GetRateBasedRuleManagedKeysCommand.ts index c85e92d048cfd..93c94ecf449c4 100644 --- a/clients/client-waf-regional/commands/GetRateBasedRuleManagedKeysCommand.ts +++ b/clients/client-waf-regional/commands/GetRateBasedRuleManagedKeysCommand.ts @@ -20,6 +20,19 @@ import { export type GetRateBasedRuleManagedKeysCommandInput = GetRateBasedRuleManagedKeysRequest; export type GetRateBasedRuleManagedKeysCommandOutput = GetRateBasedRuleManagedKeysResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of IP addresses currently being blocked by the RateBasedRule that is specified by the RuleId. The maximum + * number of managed keys that will be blocked is 10,000. If more than 10,000 addresses exceed + * the rate limit, the 10,000 addresses with the highest rates will be blocked.

+ */ export class GetRateBasedRuleManagedKeysCommand extends $Command< GetRateBasedRuleManagedKeysCommandInput, GetRateBasedRuleManagedKeysCommandOutput, @@ -34,6 +47,9 @@ export class GetRateBasedRuleManagedKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetRegexMatchSetCommand.ts b/clients/client-waf-regional/commands/GetRegexMatchSetCommand.ts index 0b2016c6a79d5..7a600d5439a9c 100644 --- a/clients/client-waf-regional/commands/GetRegexMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/GetRegexMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetRegexMatchSetCommandInput = GetRegexMatchSetRequest; export type GetRegexMatchSetCommandOutput = GetRegexMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the RegexMatchSet specified by RegexMatchSetId.

+ */ export class GetRegexMatchSetCommand extends $Command< GetRegexMatchSetCommandInput, GetRegexMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetRegexMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetRegexPatternSetCommand.ts b/clients/client-waf-regional/commands/GetRegexPatternSetCommand.ts index 8c392a42c904d..f9288ec402631 100644 --- a/clients/client-waf-regional/commands/GetRegexPatternSetCommand.ts +++ b/clients/client-waf-regional/commands/GetRegexPatternSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetRegexPatternSetCommandInput = GetRegexPatternSetRequest; export type GetRegexPatternSetCommandOutput = GetRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the RegexPatternSet specified by RegexPatternSetId.

+ */ export class GetRegexPatternSetCommand extends $Command< GetRegexPatternSetCommandInput, GetRegexPatternSetCommandOutput, @@ -34,6 +45,9 @@ export class GetRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetRuleCommand.ts b/clients/client-waf-regional/commands/GetRuleCommand.ts index f29efe490a639..3f3c97d79d911 100644 --- a/clients/client-waf-regional/commands/GetRuleCommand.ts +++ b/clients/client-waf-regional/commands/GetRuleCommand.ts @@ -17,6 +17,17 @@ import { export type GetRuleCommandInput = GetRuleRequest; export type GetRuleCommandOutput = GetRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the Rule that is specified by the RuleId that you included in the GetRule request.

+ */ export class GetRuleCommand extends $Command< GetRuleCommandInput, GetRuleCommandOutput, @@ -31,6 +42,9 @@ export class GetRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetRuleGroupCommand.ts b/clients/client-waf-regional/commands/GetRuleGroupCommand.ts index c6d7cd3ab7bfe..192582bd2445d 100644 --- a/clients/client-waf-regional/commands/GetRuleGroupCommand.ts +++ b/clients/client-waf-regional/commands/GetRuleGroupCommand.ts @@ -20,6 +20,18 @@ import { export type GetRuleGroupCommandInput = GetRuleGroupRequest; export type GetRuleGroupCommandOutput = GetRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the RuleGroup that is specified by the RuleGroupId that you included in the GetRuleGroup request.

+ *

To view the rules in a rule group, use ListActivatedRulesInRuleGroup.

+ */ export class GetRuleGroupCommand extends $Command< GetRuleGroupCommandInput, GetRuleGroupCommandOutput, @@ -34,6 +46,9 @@ export class GetRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetSampledRequestsCommand.ts b/clients/client-waf-regional/commands/GetSampledRequestsCommand.ts index 212bc261a4f63..a544472889f28 100644 --- a/clients/client-waf-regional/commands/GetSampledRequestsCommand.ts +++ b/clients/client-waf-regional/commands/GetSampledRequestsCommand.ts @@ -20,6 +20,21 @@ import { export type GetSampledRequestsCommandInput = GetSampledRequestsRequest; export type GetSampledRequestsCommandOutput = GetSampledRequestsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Gets detailed information about a specified number of requests--a sample--that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received during a time range that you choose. You can specify a sample size of up to 500 requests, and you can specify any time range in the previous three hours.

+ *

+ * GetSampledRequests returns a time range, which is usually the time range that you specified. However, if your resource + * (such as a CloudFront distribution) received 5,000 requests before the specified time range elapsed, GetSampledRequests + * returns an updated time range. This new time range indicates the actual period during which AWS WAF selected the requests in the sample.

+ */ export class GetSampledRequestsCommand extends $Command< GetSampledRequestsCommandInput, GetSampledRequestsCommandOutput, @@ -34,6 +49,9 @@ export class GetSampledRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetSizeConstraintSetCommand.ts b/clients/client-waf-regional/commands/GetSizeConstraintSetCommand.ts index 2e9b11bf8ebb7..506c3b83561ba 100644 --- a/clients/client-waf-regional/commands/GetSizeConstraintSetCommand.ts +++ b/clients/client-waf-regional/commands/GetSizeConstraintSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetSizeConstraintSetCommandInput = GetSizeConstraintSetRequest; export type GetSizeConstraintSetCommandOutput = GetSizeConstraintSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the SizeConstraintSet specified by SizeConstraintSetId.

+ */ export class GetSizeConstraintSetCommand extends $Command< GetSizeConstraintSetCommandInput, GetSizeConstraintSetCommandOutput, @@ -34,6 +45,9 @@ export class GetSizeConstraintSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetSqlInjectionMatchSetCommand.ts b/clients/client-waf-regional/commands/GetSqlInjectionMatchSetCommand.ts index a6eefc84381c0..8635be135066e 100644 --- a/clients/client-waf-regional/commands/GetSqlInjectionMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/GetSqlInjectionMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetSqlInjectionMatchSetCommandInput = GetSqlInjectionMatchSetRequest; export type GetSqlInjectionMatchSetCommandOutput = GetSqlInjectionMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the SqlInjectionMatchSet that is specified by SqlInjectionMatchSetId.

+ */ export class GetSqlInjectionMatchSetCommand extends $Command< GetSqlInjectionMatchSetCommandInput, GetSqlInjectionMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetSqlInjectionMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetWebACLCommand.ts b/clients/client-waf-regional/commands/GetWebACLCommand.ts index 108af5bea5d9c..50a9bf5974b1e 100644 --- a/clients/client-waf-regional/commands/GetWebACLCommand.ts +++ b/clients/client-waf-regional/commands/GetWebACLCommand.ts @@ -17,6 +17,17 @@ import { export type GetWebACLCommandInput = GetWebACLRequest; export type GetWebACLCommandOutput = GetWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the WebACL that is specified by WebACLId.

+ */ export class GetWebACLCommand extends $Command< GetWebACLCommandInput, GetWebACLCommandOutput, @@ -31,6 +42,9 @@ export class GetWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetWebACLForResourceCommand.ts b/clients/client-waf-regional/commands/GetWebACLForResourceCommand.ts index 9607630a9cde6..2b651958387c3 100644 --- a/clients/client-waf-regional/commands/GetWebACLForResourceCommand.ts +++ b/clients/client-waf-regional/commands/GetWebACLForResourceCommand.ts @@ -20,6 +20,17 @@ import { export type GetWebACLForResourceCommandInput = GetWebACLForResourceRequest; export type GetWebACLForResourceCommandOutput = GetWebACLForResourceResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic Regional documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the web ACL for the specified resource, either an application load balancer or Amazon API Gateway stage.

+ */ export class GetWebACLForResourceCommand extends $Command< GetWebACLForResourceCommandInput, GetWebACLForResourceCommandOutput, @@ -34,6 +45,9 @@ export class GetWebACLForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/GetXssMatchSetCommand.ts b/clients/client-waf-regional/commands/GetXssMatchSetCommand.ts index 4c215bc469f95..ca201fdb61469 100644 --- a/clients/client-waf-regional/commands/GetXssMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/GetXssMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetXssMatchSetCommandInput = GetXssMatchSetRequest; export type GetXssMatchSetCommandOutput = GetXssMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the XssMatchSet that is specified by XssMatchSetId.

+ */ export class GetXssMatchSetCommand extends $Command< GetXssMatchSetCommandInput, GetXssMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetXssMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListActivatedRulesInRuleGroupCommand.ts b/clients/client-waf-regional/commands/ListActivatedRulesInRuleGroupCommand.ts index a964eab59424d..062f0b1e336a2 100644 --- a/clients/client-waf-regional/commands/ListActivatedRulesInRuleGroupCommand.ts +++ b/clients/client-waf-regional/commands/ListActivatedRulesInRuleGroupCommand.ts @@ -20,6 +20,17 @@ import { export type ListActivatedRulesInRuleGroupCommandInput = ListActivatedRulesInRuleGroupRequest; export type ListActivatedRulesInRuleGroupCommandOutput = ListActivatedRulesInRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of ActivatedRule objects.

+ */ export class ListActivatedRulesInRuleGroupCommand extends $Command< ListActivatedRulesInRuleGroupCommandInput, ListActivatedRulesInRuleGroupCommandOutput, @@ -34,6 +45,9 @@ export class ListActivatedRulesInRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListByteMatchSetsCommand.ts b/clients/client-waf-regional/commands/ListByteMatchSetsCommand.ts index 8e8f68803e527..07338713d6e19 100644 --- a/clients/client-waf-regional/commands/ListByteMatchSetsCommand.ts +++ b/clients/client-waf-regional/commands/ListByteMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListByteMatchSetsCommandInput = ListByteMatchSetsRequest; export type ListByteMatchSetsCommandOutput = ListByteMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of ByteMatchSetSummary objects.

+ */ export class ListByteMatchSetsCommand extends $Command< ListByteMatchSetsCommandInput, ListByteMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListByteMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListGeoMatchSetsCommand.ts b/clients/client-waf-regional/commands/ListGeoMatchSetsCommand.ts index 797c53b34dba1..9abf90c1a1717 100644 --- a/clients/client-waf-regional/commands/ListGeoMatchSetsCommand.ts +++ b/clients/client-waf-regional/commands/ListGeoMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListGeoMatchSetsCommandInput = ListGeoMatchSetsRequest; export type ListGeoMatchSetsCommandOutput = ListGeoMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of GeoMatchSetSummary objects in the response.

+ */ export class ListGeoMatchSetsCommand extends $Command< ListGeoMatchSetsCommandInput, ListGeoMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListGeoMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListIPSetsCommand.ts b/clients/client-waf-regional/commands/ListIPSetsCommand.ts index 0171ec0e63a28..fdeef9c10af0f 100644 --- a/clients/client-waf-regional/commands/ListIPSetsCommand.ts +++ b/clients/client-waf-regional/commands/ListIPSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListIPSetsCommandInput = ListIPSetsRequest; export type ListIPSetsCommandOutput = ListIPSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of IPSetSummary objects in the response.

+ */ export class ListIPSetsCommand extends $Command< ListIPSetsCommandInput, ListIPSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListIPSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListLoggingConfigurationsCommand.ts b/clients/client-waf-regional/commands/ListLoggingConfigurationsCommand.ts index 9e6c90f4590a6..fa36ce246483c 100644 --- a/clients/client-waf-regional/commands/ListLoggingConfigurationsCommand.ts +++ b/clients/client-waf-regional/commands/ListLoggingConfigurationsCommand.ts @@ -20,6 +20,17 @@ import { export type ListLoggingConfigurationsCommandInput = ListLoggingConfigurationsRequest; export type ListLoggingConfigurationsCommandOutput = ListLoggingConfigurationsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of LoggingConfiguration objects.

+ */ export class ListLoggingConfigurationsCommand extends $Command< ListLoggingConfigurationsCommandInput, ListLoggingConfigurationsCommandOutput, @@ -34,6 +45,9 @@ export class ListLoggingConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListRateBasedRulesCommand.ts b/clients/client-waf-regional/commands/ListRateBasedRulesCommand.ts index 2a01ed26cb0e7..87b2957d4f8a5 100644 --- a/clients/client-waf-regional/commands/ListRateBasedRulesCommand.ts +++ b/clients/client-waf-regional/commands/ListRateBasedRulesCommand.ts @@ -20,6 +20,17 @@ import { export type ListRateBasedRulesCommandInput = ListRateBasedRulesRequest; export type ListRateBasedRulesCommandOutput = ListRateBasedRulesResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RuleSummary objects.

+ */ export class ListRateBasedRulesCommand extends $Command< ListRateBasedRulesCommandInput, ListRateBasedRulesCommandOutput, @@ -34,6 +45,9 @@ export class ListRateBasedRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListRegexMatchSetsCommand.ts b/clients/client-waf-regional/commands/ListRegexMatchSetsCommand.ts index 6830b404c2623..695fdd79a7cc1 100644 --- a/clients/client-waf-regional/commands/ListRegexMatchSetsCommand.ts +++ b/clients/client-waf-regional/commands/ListRegexMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListRegexMatchSetsCommandInput = ListRegexMatchSetsRequest; export type ListRegexMatchSetsCommandOutput = ListRegexMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RegexMatchSetSummary objects.

+ */ export class ListRegexMatchSetsCommand extends $Command< ListRegexMatchSetsCommandInput, ListRegexMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListRegexMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListRegexPatternSetsCommand.ts b/clients/client-waf-regional/commands/ListRegexPatternSetsCommand.ts index bea62e4361ce5..0f17bbc57d449 100644 --- a/clients/client-waf-regional/commands/ListRegexPatternSetsCommand.ts +++ b/clients/client-waf-regional/commands/ListRegexPatternSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListRegexPatternSetsCommandInput = ListRegexPatternSetsRequest; export type ListRegexPatternSetsCommandOutput = ListRegexPatternSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RegexPatternSetSummary objects.

+ */ export class ListRegexPatternSetsCommand extends $Command< ListRegexPatternSetsCommandInput, ListRegexPatternSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListRegexPatternSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListResourcesForWebACLCommand.ts b/clients/client-waf-regional/commands/ListResourcesForWebACLCommand.ts index 1be9190434371..943261ca05dbf 100644 --- a/clients/client-waf-regional/commands/ListResourcesForWebACLCommand.ts +++ b/clients/client-waf-regional/commands/ListResourcesForWebACLCommand.ts @@ -20,6 +20,17 @@ import { export type ListResourcesForWebACLCommandInput = ListResourcesForWebACLRequest; export type ListResourcesForWebACLCommandOutput = ListResourcesForWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic Regional documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of resources associated with the specified web ACL.

+ */ export class ListResourcesForWebACLCommand extends $Command< ListResourcesForWebACLCommandInput, ListResourcesForWebACLCommandOutput, @@ -34,6 +45,9 @@ export class ListResourcesForWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListRuleGroupsCommand.ts b/clients/client-waf-regional/commands/ListRuleGroupsCommand.ts index 22d4b759d56a1..80eb72cf3d558 100644 --- a/clients/client-waf-regional/commands/ListRuleGroupsCommand.ts +++ b/clients/client-waf-regional/commands/ListRuleGroupsCommand.ts @@ -20,6 +20,17 @@ import { export type ListRuleGroupsCommandInput = ListRuleGroupsRequest; export type ListRuleGroupsCommandOutput = ListRuleGroupsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RuleGroup objects.

+ */ export class ListRuleGroupsCommand extends $Command< ListRuleGroupsCommandInput, ListRuleGroupsCommandOutput, @@ -34,6 +45,9 @@ export class ListRuleGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListRulesCommand.ts b/clients/client-waf-regional/commands/ListRulesCommand.ts index ae0283bd9860c..e90e9e8b46c77 100644 --- a/clients/client-waf-regional/commands/ListRulesCommand.ts +++ b/clients/client-waf-regional/commands/ListRulesCommand.ts @@ -17,6 +17,17 @@ import { export type ListRulesCommandInput = ListRulesRequest; export type ListRulesCommandOutput = ListRulesResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RuleSummary objects.

+ */ export class ListRulesCommand extends $Command< ListRulesCommandInput, ListRulesCommandOutput, @@ -31,6 +42,9 @@ export class ListRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListSizeConstraintSetsCommand.ts b/clients/client-waf-regional/commands/ListSizeConstraintSetsCommand.ts index ca6778e2a5bf1..3921a3185529b 100644 --- a/clients/client-waf-regional/commands/ListSizeConstraintSetsCommand.ts +++ b/clients/client-waf-regional/commands/ListSizeConstraintSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListSizeConstraintSetsCommandInput = ListSizeConstraintSetsRequest; export type ListSizeConstraintSetsCommandOutput = ListSizeConstraintSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of SizeConstraintSetSummary objects.

+ */ export class ListSizeConstraintSetsCommand extends $Command< ListSizeConstraintSetsCommandInput, ListSizeConstraintSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListSizeConstraintSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListSqlInjectionMatchSetsCommand.ts b/clients/client-waf-regional/commands/ListSqlInjectionMatchSetsCommand.ts index 00d7b564c33f8..3d6ee1b966eec 100644 --- a/clients/client-waf-regional/commands/ListSqlInjectionMatchSetsCommand.ts +++ b/clients/client-waf-regional/commands/ListSqlInjectionMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListSqlInjectionMatchSetsCommandInput = ListSqlInjectionMatchSetsRequest; export type ListSqlInjectionMatchSetsCommandOutput = ListSqlInjectionMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of SqlInjectionMatchSet objects.

+ */ export class ListSqlInjectionMatchSetsCommand extends $Command< ListSqlInjectionMatchSetsCommandInput, ListSqlInjectionMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListSqlInjectionMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListSubscribedRuleGroupsCommand.ts b/clients/client-waf-regional/commands/ListSubscribedRuleGroupsCommand.ts index 843cf1091c80a..f79800c243ba7 100644 --- a/clients/client-waf-regional/commands/ListSubscribedRuleGroupsCommand.ts +++ b/clients/client-waf-regional/commands/ListSubscribedRuleGroupsCommand.ts @@ -20,6 +20,17 @@ import { export type ListSubscribedRuleGroupsCommandInput = ListSubscribedRuleGroupsRequest; export type ListSubscribedRuleGroupsCommandOutput = ListSubscribedRuleGroupsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RuleGroup objects that you are subscribed to.

+ */ export class ListSubscribedRuleGroupsCommand extends $Command< ListSubscribedRuleGroupsCommandInput, ListSubscribedRuleGroupsCommandOutput, @@ -34,6 +45,9 @@ export class ListSubscribedRuleGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListTagsForResourceCommand.ts b/clients/client-waf-regional/commands/ListTagsForResourceCommand.ts index 4db58a6d712c6..b32a7e7aef8a4 100644 --- a/clients/client-waf-regional/commands/ListTagsForResourceCommand.ts +++ b/clients/client-waf-regional/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,18 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Retrieves the tags associated with the specified AWS resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each AWS resource, up to 50 tags for a resource.

+ *

Tagging is only available through the API, SDKs, and CLI. You can't manage or view tags through the AWS WAF Classic console. You can tag the AWS resources that you manage through AWS WAF Classic: web ACLs, rule groups, and rules.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +46,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListWebACLsCommand.ts b/clients/client-waf-regional/commands/ListWebACLsCommand.ts index 8f11c6e0708c0..a42f916876418 100644 --- a/clients/client-waf-regional/commands/ListWebACLsCommand.ts +++ b/clients/client-waf-regional/commands/ListWebACLsCommand.ts @@ -20,6 +20,17 @@ import { export type ListWebACLsCommandInput = ListWebACLsRequest; export type ListWebACLsCommandOutput = ListWebACLsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of WebACLSummary objects in the response.

+ */ export class ListWebACLsCommand extends $Command< ListWebACLsCommandInput, ListWebACLsCommandOutput, @@ -34,6 +45,9 @@ export class ListWebACLsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/ListXssMatchSetsCommand.ts b/clients/client-waf-regional/commands/ListXssMatchSetsCommand.ts index a6d1586a38f6c..f1a8aa80a0df1 100644 --- a/clients/client-waf-regional/commands/ListXssMatchSetsCommand.ts +++ b/clients/client-waf-regional/commands/ListXssMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListXssMatchSetsCommandInput = ListXssMatchSetsRequest; export type ListXssMatchSetsCommandOutput = ListXssMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of XssMatchSet objects.

+ */ export class ListXssMatchSetsCommand extends $Command< ListXssMatchSetsCommandInput, ListXssMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListXssMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/PutLoggingConfigurationCommand.ts b/clients/client-waf-regional/commands/PutLoggingConfigurationCommand.ts index 4a4ab571f0146..a7d7e41f78188 100644 --- a/clients/client-waf-regional/commands/PutLoggingConfigurationCommand.ts +++ b/clients/client-waf-regional/commands/PutLoggingConfigurationCommand.ts @@ -20,6 +20,34 @@ import { export type PutLoggingConfigurationCommandInput = PutLoggingConfigurationRequest; export type PutLoggingConfigurationCommandOutput = PutLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Associates a LoggingConfiguration with a specified web ACL.

+ *

You can access information about all traffic that AWS WAF inspects using the following + * steps:

+ *
    + *
  1. + *

    Create an Amazon Kinesis Data + * Firehose.

    + *

    Create the data firehose with a PUT source and in the region that you are operating. However, if you are capturing logs for Amazon CloudFront, always create the firehose in US East (N. Virginia).

    + * + *

    Do not create the data firehose using a Kinesis stream as your source.

    + *
    + *
  2. + *
  3. + *

    Associate that firehose to your web ACL using a PutLoggingConfiguration request.

    + *
  4. + *
+ * + *

When you successfully enable logging using a PutLoggingConfiguration request, AWS WAF will create a service linked role with the necessary permissions to write logs to the Amazon Kinesis Data Firehose. For more information, see Logging Web ACL Traffic Information in the AWS WAF Developer Guide.

+ */ export class PutLoggingConfigurationCommand extends $Command< PutLoggingConfigurationCommandInput, PutLoggingConfigurationCommandOutput, @@ -34,6 +62,9 @@ export class PutLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/PutPermissionPolicyCommand.ts b/clients/client-waf-regional/commands/PutPermissionPolicyCommand.ts index 4271ff432507d..0c3c6b23fbafd 100644 --- a/clients/client-waf-regional/commands/PutPermissionPolicyCommand.ts +++ b/clients/client-waf-regional/commands/PutPermissionPolicyCommand.ts @@ -20,6 +20,49 @@ import { export type PutPermissionPolicyCommandInput = PutPermissionPolicyRequest; export type PutPermissionPolicyCommandOutput = PutPermissionPolicyResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Attaches an IAM policy to the specified resource. The only supported use for this action is to share a RuleGroup across accounts.

+ *

The PutPermissionPolicy is subject to the following restrictions:

+ *
    + *
  • + *

    You can attach only one policy with each PutPermissionPolicy request.

    + *
  • + *
  • + *

    The policy must include an Effect, Action and Principal.

    + *
  • + *
  • + * + *

    + * Effect must specify Allow.

    + *
  • + *
  • + *

    The Action in the policy must be waf:UpdateWebACL, waf-regional:UpdateWebACL, waf:GetRuleGroup and waf-regional:GetRuleGroup . Any extra or wildcard actions in the policy will be rejected.

    + *
  • + *
  • + *

    The policy cannot include a Resource parameter.

    + *
  • + *
  • + *

    The ARN in the request must be a valid WAF RuleGroup ARN and the RuleGroup must exist in the same region.

    + *
  • + *
  • + *

    The user making the request must be the owner of the RuleGroup.

    + *
  • + *
  • + *

    Your policy must be composed using IAM Policy version 2012-10-17.

    + *
  • + *
+ *

For more information, see IAM Policies.

+ * + *

An example of a valid policy parameter is shown in the Examples section below.

+ */ export class PutPermissionPolicyCommand extends $Command< PutPermissionPolicyCommandInput, PutPermissionPolicyCommandOutput, @@ -34,6 +77,9 @@ export class PutPermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/TagResourceCommand.ts b/clients/client-waf-regional/commands/TagResourceCommand.ts index 7373aff96d110..6040ad53c2fea 100644 --- a/clients/client-waf-regional/commands/TagResourceCommand.ts +++ b/clients/client-waf-regional/commands/TagResourceCommand.ts @@ -20,6 +20,18 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Associates tags with the specified AWS resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each AWS resource, up to 50 tags for a resource.

+ *

Tagging is only available through the API, SDKs, and CLI. You can't manage or view tags through the AWS WAF Classic console. You can use this action to tag the AWS resources that you manage through AWS WAF Classic: web ACLs, rule groups, and rules.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +46,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UntagResourceCommand.ts b/clients/client-waf-regional/commands/UntagResourceCommand.ts index bf8a2444c1a90..f1c6b2e49262c 100644 --- a/clients/client-waf-regional/commands/UntagResourceCommand.ts +++ b/clients/client-waf-regional/commands/UntagResourceCommand.ts @@ -20,6 +20,17 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +45,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateByteMatchSetCommand.ts b/clients/client-waf-regional/commands/UpdateByteMatchSetCommand.ts index bbadddb9a6fdf..157ddb7876374 100644 --- a/clients/client-waf-regional/commands/UpdateByteMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/UpdateByteMatchSetCommand.ts @@ -20,6 +20,55 @@ import { export type UpdateByteMatchSetCommandInput = UpdateByteMatchSetRequest; export type UpdateByteMatchSetCommandOutput = UpdateByteMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes ByteMatchTuple objects (filters) in a ByteMatchSet. For each ByteMatchTuple object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change a ByteMatchSetUpdate object, + * you delete the existing object and add a new one.

    + *
  • + *
  • + *

    The part of a web request that you want AWS WAF to inspect, such as a query string or the value of the User-Agent header.

    + *
  • + *
  • + *

    The bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to look for. For more information, including how you specify + * the values for the AWS WAF API and the AWS CLI or SDKs, see TargetString in the ByteMatchTuple data type.

    + *
  • + *
  • + *

    Where to look, such as at the beginning or the end of a query string.

    + *
  • + *
  • + *

    Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

    + *
  • + *
+ *

For example, you can add a ByteMatchSetUpdate object that matches web requests in which User-Agent headers contain + * the string BadBot. You can then configure AWS WAF to block those requests.

+ *

To create and configure a ByteMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Create a ByteMatchSet. For more information, see CreateByteMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateByteMatchSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value that you want AWS WAF to watch for.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateByteMatchSetCommand extends $Command< UpdateByteMatchSetCommandInput, UpdateByteMatchSetCommandOutput, @@ -34,6 +83,9 @@ export class UpdateByteMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateGeoMatchSetCommand.ts b/clients/client-waf-regional/commands/UpdateGeoMatchSetCommand.ts index 264ac57dee56e..b21b72b6adb54 100644 --- a/clients/client-waf-regional/commands/UpdateGeoMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/UpdateGeoMatchSetCommand.ts @@ -20,6 +20,47 @@ import { export type UpdateGeoMatchSetCommandInput = UpdateGeoMatchSetRequest; export type UpdateGeoMatchSetCommandOutput = UpdateGeoMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes GeoMatchConstraint objects in an GeoMatchSet. For each GeoMatchConstraint object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change an GeoMatchConstraint object, you delete the existing object and add a new one.

    + *
  • + *
  • + *

    The Type. The only valid value for Type is Country.

    + *
  • + *
  • + *

    The Value, which is a two character code for the country to add to the GeoMatchConstraint object. Valid codes are listed in GeoMatchConstraint$Value.

    + *
  • + *
+ * + *

To create and configure an GeoMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Submit a CreateGeoMatchSet request.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateGeoMatchSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateGeoMatchSet request to specify the country that you want AWS WAF to watch for.

    + *
  6. + *
+ *

When you update an GeoMatchSet, you specify the country that you want to add and/or the country that you want to delete. + * If you want to change a country, you delete the existing country and add the new one.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateGeoMatchSetCommand extends $Command< UpdateGeoMatchSetCommandInput, UpdateGeoMatchSetCommandOutput, @@ -34,6 +75,9 @@ export class UpdateGeoMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateIPSetCommand.ts b/clients/client-waf-regional/commands/UpdateIPSetCommand.ts index f6645169f6a41..19ff0bd8781b0 100644 --- a/clients/client-waf-regional/commands/UpdateIPSetCommand.ts +++ b/clients/client-waf-regional/commands/UpdateIPSetCommand.ts @@ -20,6 +20,82 @@ import { export type UpdateIPSetCommandInput = UpdateIPSetRequest; export type UpdateIPSetCommandOutput = UpdateIPSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes IPSetDescriptor objects in an + * IPSet. For each IPSetDescriptor object, you specify the following + * values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change an + * IPSetDescriptor object, you delete the existing object and add a new + * one.

    + *
  • + *
  • + *

    The IP address version, IPv4 or IPv6.

    + *
  • + *
  • + *

    The IP address in CIDR notation, for example, 192.0.2.0/24 (for + * the range of IP addresses from 192.0.2.0 to 192.0.2.255) or + * 192.0.2.44/32 (for the individual IP address + * 192.0.2.44).

    + *
  • + *
+ *

AWS WAF supports IPv4 address ranges: /8 and any range between /16 through /32. AWS + * WAF supports IPv6 address ranges: /24, /32, /48, /56, /64, and /128. For more + * information about CIDR notation, see the Wikipedia entry Classless + * Inter-Domain Routing.

+ *

IPv6 addresses can be represented using any of the following formats:

+ *
    + *
  • + *

    1111:0000:0000:0000:0000:0000:0000:0111/128

    + *
  • + *
  • + *

    1111:0:0:0:0:0:0:0111/128

    + *
  • + *
  • + *

    1111::0111/128

    + *
  • + *
  • + *

    1111::111/128

    + *
  • + *
+ *

You use an IPSet to specify which web requests you want to allow or + * block based on the IP addresses that the requests originated from. For example, if you're + * receiving a lot of requests from one or a small number of IP addresses and you want to + * block the requests, you can create an IPSet that specifies those IP addresses, + * and then configure AWS WAF to block the requests.

+ *

To create and configure an IPSet, perform the following steps:

+ *
    + *
  1. + *

    Submit a CreateIPSet request.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide + * in the ChangeToken parameter of an UpdateIPSet + * request.

    + *
  4. + *
  5. + *

    Submit an UpdateIPSet request to specify the IP addresses that you + * want AWS WAF to watch for.

    + *
  6. + *
+ *

When you update an IPSet, you specify the IP addresses that you want to + * add and/or the IP addresses that you want to delete. If you want to change an IP address, + * you delete the existing IP address and add the new one.

+ *

You can insert a maximum of 1000 addresses in a single + * request.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP + * requests, see the AWS WAF + * Developer Guide.

+ */ export class UpdateIPSetCommand extends $Command< UpdateIPSetCommandInput, UpdateIPSetCommandOutput, @@ -34,6 +110,9 @@ export class UpdateIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateRateBasedRuleCommand.ts b/clients/client-waf-regional/commands/UpdateRateBasedRuleCommand.ts index 9e8bae476a7f7..029340973e88b 100644 --- a/clients/client-waf-regional/commands/UpdateRateBasedRuleCommand.ts +++ b/clients/client-waf-regional/commands/UpdateRateBasedRuleCommand.ts @@ -20,6 +20,63 @@ import { export type UpdateRateBasedRuleCommandInput = UpdateRateBasedRuleRequest; export type UpdateRateBasedRuleCommandOutput = UpdateRateBasedRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes Predicate objects in a rule and updates the + * RateLimit in the rule.

+ *

Each Predicate object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests + * that you want to block or count. The RateLimit specifies the number of + * requests every five minutes that triggers the rule.

+ *

If you add more than one predicate to a RateBasedRule, a request must + * match all the predicates and exceed the RateLimit to be counted or blocked. + * For example, suppose you add the following to a RateBasedRule:

+ *
    + *
  • + *

    An IPSet that matches the IP address 192.0.2.44/32 + *

    + *
  • + *
  • + *

    A ByteMatchSet that matches BadBot in the + * User-Agent header

    + *
  • + *
+ *

Further, you specify a + * RateLimit of 1,000.

+ *

You then add the RateBasedRule to a WebACL and specify that + * you want to block requests that satisfy the rule. For a request to be blocked, it must come + * from the IP address 192.0.2.44 and the User-Agent header + * in the request must contain the value BadBot. Further, requests that match + * these two conditions much be received at a rate of more than 1,000 every five minutes. If + * the rate drops below this limit, AWS WAF no longer blocks the requests.

+ * + *

As a second example, suppose you want to limit requests to a particular page on your site. To do this, you could add the following to a + * RateBasedRule:

+ * + * + *
    + *
  • + *

    A ByteMatchSet with FieldToMatch of URI + *

    + *
  • + *
  • + *

    A PositionalConstraint of STARTS_WITH + *

    + *
  • + *
  • + *

    A TargetString of login + *

    + *
  • + *
+ *

Further, you specify a RateLimit of 1,000.

+ *

By adding this RateBasedRule to a WebACL, you could limit requests to your login page without affecting the rest of your site.

+ */ export class UpdateRateBasedRuleCommand extends $Command< UpdateRateBasedRuleCommandInput, UpdateRateBasedRuleCommandOutput, @@ -34,6 +91,9 @@ export class UpdateRateBasedRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateRegexMatchSetCommand.ts b/clients/client-waf-regional/commands/UpdateRegexMatchSetCommand.ts index 1e670996a59b7..abb25af816eb8 100644 --- a/clients/client-waf-regional/commands/UpdateRegexMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/UpdateRegexMatchSetCommand.ts @@ -20,6 +20,51 @@ import { export type UpdateRegexMatchSetCommandInput = UpdateRegexMatchSetRequest; export type UpdateRegexMatchSetCommandOutput = UpdateRegexMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes RegexMatchTuple objects (filters) in a RegexMatchSet. For each RegexMatchSetUpdate object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change a RegexMatchSetUpdate object, + * you delete the existing object and add a new one.

    + *
  • + *
  • + *

    The part of a web request that you want AWS WAF to inspectupdate, such as a query string or the value of the User-Agent header.

    + *
  • + *
  • + *

    The identifier of the pattern (a regular expression) that you want AWS WAF to look for. For more information, see RegexPatternSet.

    + *
  • + *
  • + *

    Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

    + *
  • + *
+ *

For example, you can create a RegexPatternSet that matches any requests with User-Agent headers + * that contain the string B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

+ *

To create and configure a RegexMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Create a RegexMatchSet. For more information, see CreateRegexMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRegexMatchSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateRegexMatchSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the identifier of the RegexPatternSet that contain the regular expression patters you want AWS WAF to watch for.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateRegexMatchSetCommand extends $Command< UpdateRegexMatchSetCommandInput, UpdateRegexMatchSetCommandOutput, @@ -34,6 +79,9 @@ export class UpdateRegexMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateRegexPatternSetCommand.ts b/clients/client-waf-regional/commands/UpdateRegexPatternSetCommand.ts index a16655bcc98cb..7e01a63fad1d4 100644 --- a/clients/client-waf-regional/commands/UpdateRegexPatternSetCommand.ts +++ b/clients/client-waf-regional/commands/UpdateRegexPatternSetCommand.ts @@ -20,6 +20,56 @@ import { export type UpdateRegexPatternSetCommandInput = UpdateRegexPatternSetRequest; export type UpdateRegexPatternSetCommandOutput = UpdateRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes RegexPatternString objects in a RegexPatternSet. For each RegexPatternString object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the RegexPatternString.

    + *
  • + *
  • + *

    The regular expression pattern that you want to insert or delete. For more information, see RegexPatternSet.

    + *
  • + *
+ *

For example, you can create a RegexPatternString such as B[a@]dB[o0]t. AWS WAF will match this RegexPatternString to:

+ *
    + *
  • + *

    BadBot

    + *
  • + *
  • + *

    BadB0t

    + *
  • + *
  • + *

    B@dBot

    + *
  • + *
  • + *

    B@dB0t

    + *
  • + *
+ *

To create and configure a RegexPatternSet, perform the following steps:

+ *
    + *
  1. + *

    Create a RegexPatternSet. For more information, see CreateRegexPatternSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRegexPatternSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateRegexPatternSet request to specify the regular expression pattern that you want AWS WAF to watch for.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateRegexPatternSetCommand extends $Command< UpdateRegexPatternSetCommandInput, UpdateRegexPatternSetCommandOutput, @@ -34,6 +84,9 @@ export class UpdateRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateRuleCommand.ts b/clients/client-waf-regional/commands/UpdateRuleCommand.ts index e9e6fb497c6a9..e779370e2592f 100644 --- a/clients/client-waf-regional/commands/UpdateRuleCommand.ts +++ b/clients/client-waf-regional/commands/UpdateRuleCommand.ts @@ -20,6 +20,58 @@ import { export type UpdateRuleCommandInput = UpdateRuleRequest; export type UpdateRuleCommandOutput = UpdateRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes Predicate objects in a Rule. Each + * Predicate object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests + * that you want to allow, block, or count. If you add more than one predicate to a + * Rule, a request must match all of the specifications to be allowed, + * blocked, or counted. For example, suppose + * that + * you add the following to a Rule:

+ *
    + *
  • + *

    A ByteMatchSet that matches the value BadBot in the User-Agent header

    + *
  • + *
  • + *

    An IPSet that matches the IP address 192.0.2.44 + *

    + *
  • + *
+ *

You then add the Rule to a WebACL and specify that you want to block requests that satisfy the Rule. + * For a request to be blocked, the User-Agent header in the request must contain the value BadBot + * and the request must originate from the IP address 192.0.2.44.

+ *

To create and configure a Rule, perform the following steps:

+ *
    + *
  1. + *

    Create and update the predicates that you want to include in the Rule.

    + *
  2. + *
  3. + *

    Create the Rule. See CreateRule.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRule request.

    + *
  6. + *
  7. + *

    Submit an UpdateRule request to add predicates to the Rule.

    + *
  8. + *
  9. + *

    Create and update a WebACL that contains the Rule. See CreateWebACL.

    + *
  10. + *
+ *

If you want to replace one ByteMatchSet or IPSet with another, you delete the existing one and + * add the new one.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateRuleCommand extends $Command< UpdateRuleCommandInput, UpdateRuleCommandOutput, @@ -34,6 +86,9 @@ export class UpdateRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateRuleGroupCommand.ts b/clients/client-waf-regional/commands/UpdateRuleGroupCommand.ts index aee83f25236f4..4ae7a9d7f70af 100644 --- a/clients/client-waf-regional/commands/UpdateRuleGroupCommand.ts +++ b/clients/client-waf-regional/commands/UpdateRuleGroupCommand.ts @@ -20,6 +20,41 @@ import { export type UpdateRuleGroupCommandInput = UpdateRuleGroupRequest; export type UpdateRuleGroupCommandOutput = UpdateRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes ActivatedRule objects in a RuleGroup.

+ *

You can only insert REGULAR rules into a rule group.

+ *

You can have a maximum of ten rules per rule group.

+ * + * + *

To create and configure a RuleGroup, perform the following steps:

+ *
    + *
  1. + *

    Create and update the Rules that you want to include in the RuleGroup. See CreateRule.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRuleGroup request.

    + *
  4. + *
  5. + *

    Submit an UpdateRuleGroup request to add Rules to the RuleGroup.

    + *
  6. + *
  7. + *

    Create and update a WebACL that contains the RuleGroup. See CreateWebACL.

    + *
  8. + *
+ *

If you want to replace one Rule with another, you delete the existing one and + * add the new one.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateRuleGroupCommand extends $Command< UpdateRuleGroupCommandInput, UpdateRuleGroupCommandOutput, @@ -34,6 +69,9 @@ export class UpdateRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateSizeConstraintSetCommand.ts b/clients/client-waf-regional/commands/UpdateSizeConstraintSetCommand.ts index 5375647cd29d6..41c50f0489767 100644 --- a/clients/client-waf-regional/commands/UpdateSizeConstraintSetCommand.ts +++ b/clients/client-waf-regional/commands/UpdateSizeConstraintSetCommand.ts @@ -20,6 +20,59 @@ import { export type UpdateSizeConstraintSetCommandInput = UpdateSizeConstraintSetRequest; export type UpdateSizeConstraintSetCommandOutput = UpdateSizeConstraintSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes SizeConstraint objects (filters) in a SizeConstraintSet. For each SizeConstraint object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change a SizeConstraintSetUpdate object, + * you delete the existing object and add a new one.

    + *
  • + *
  • + *

    The part of a web request that you want AWS WAF to evaluate, such as the length of a query string or the length of the + * User-Agent header.

    + *
  • + *
  • + *

    Whether to perform any transformations on the request, such as converting it to lowercase, before checking its length. + * Note that transformations of the request body are not supported because the AWS resource forwards only the first 8192 bytes + * of your request to AWS WAF.

    + *

    You can only specify a single type of TextTransformation.

    + *
  • + *
  • + *

    A ComparisonOperator used for evaluating the selected part of the request against the specified Size, such as + * equals, greater than, less than, and so on.

    + *
  • + *
  • + *

    The length, in bytes, that you want AWS WAF to watch for in selected part of the request. The length is computed after applying the transformation.

    + *
  • + *
+ *

For example, you can add a SizeConstraintSetUpdate object that matches web requests in which the length of the + * User-Agent header is greater than 100 bytes. You can then configure AWS WAF to block those requests.

+ *

To create and configure a SizeConstraintSet, perform the following steps:

+ *
    + *
  1. + *

    Create a SizeConstraintSet. For more information, see CreateSizeConstraintSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateSizeConstraintSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value that you want AWS WAF to watch for.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateSizeConstraintSetCommand extends $Command< UpdateSizeConstraintSetCommandInput, UpdateSizeConstraintSetCommandOutput, @@ -34,6 +87,9 @@ export class UpdateSizeConstraintSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateSqlInjectionMatchSetCommand.ts b/clients/client-waf-regional/commands/UpdateSqlInjectionMatchSetCommand.ts index 5d1c1403d2ff5..f85b984f6b534 100644 --- a/clients/client-waf-regional/commands/UpdateSqlInjectionMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/UpdateSqlInjectionMatchSetCommand.ts @@ -20,6 +20,58 @@ import { export type UpdateSqlInjectionMatchSetCommandInput = UpdateSqlInjectionMatchSetRequest; export type UpdateSqlInjectionMatchSetCommandOutput = UpdateSqlInjectionMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes SqlInjectionMatchTuple objects (filters) in a SqlInjectionMatchSet. + * For each SqlInjectionMatchTuple object, you specify the following values:

+ *
    + *
  • + *

    + * Action: Whether to insert the object into or delete the object from the array. To change a + * SqlInjectionMatchTuple, you delete the existing object and add a new one.

    + *
  • + *
  • + *

    + * FieldToMatch: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header or custom query parameter, + * the name of the header or parameter.

    + *
  • + *
  • + *

    + * TextTransformation: Which text transformation, if any, to perform on the web request before + * inspecting the request for snippets of malicious SQL code.

    + *

    You can only specify a single type of TextTransformation.

    + *
  • + *
+ *

You use SqlInjectionMatchSet objects to specify which CloudFront + * requests that + * you want to allow, block, or count. For example, if you're receiving + * requests that contain snippets of SQL code in the query string and you want to block the + * requests, you can create a SqlInjectionMatchSet with the applicable settings, + * and then configure AWS WAF to block the requests.

+ *

To create and configure a SqlInjectionMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Submit a CreateSqlInjectionMatchSet request.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateIPSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests that you want AWS WAF to + * inspect for snippets of SQL code.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateSqlInjectionMatchSetCommand extends $Command< UpdateSqlInjectionMatchSetCommandInput, UpdateSqlInjectionMatchSetCommandOutput, @@ -34,6 +86,9 @@ export class UpdateSqlInjectionMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateWebACLCommand.ts b/clients/client-waf-regional/commands/UpdateWebACLCommand.ts index 35a27bc1cb66f..2770e0a068546 100644 --- a/clients/client-waf-regional/commands/UpdateWebACLCommand.ts +++ b/clients/client-waf-regional/commands/UpdateWebACLCommand.ts @@ -20,6 +20,88 @@ import { export type UpdateWebACLCommandInput = UpdateWebACLRequest; export type UpdateWebACLCommandOutput = UpdateWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes ActivatedRule objects in a WebACL. Each Rule identifies + * web requests that you want to allow, block, or count. When you update a WebACL, you specify the following values:

+ *
    + *
  • + *

    A default action for the WebACL, either ALLOW or BLOCK. + * AWS WAF performs the default action if a request doesn't match the criteria in any of the Rules in a WebACL.

    + *
  • + *
  • + *

    The Rules that you want to add + * or + * delete. If you want to replace one Rule with another, you delete the + * existing Rule and add the new one.

    + *
  • + *
  • + *

    For each Rule, whether you want AWS WAF to allow requests, block requests, or count requests that match + * the conditions in the Rule.

    + *
  • + *
  • + *

    The order in which you want AWS WAF to evaluate the Rules in a + * WebACL. If you add more than one Rule to a + * WebACL, AWS WAF evaluates each request against the Rules + * in order based on the value of Priority. (The Rule that has + * the lowest value for Priority is evaluated first.) When a web request + * matches all + * the + * predicates (such as ByteMatchSets and IPSets) in a + * Rule, AWS WAF immediately takes the corresponding action, allow or + * block, and doesn't evaluate the request against the remaining Rules in + * the WebACL, if any.

    + *
  • + *
+ * + *

To create and configure a WebACL, perform the following steps:

+ *
    + *
  1. + *

    Create and update the predicates that you want to include in Rules. + * For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, + * CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Create and update the Rules that you want to include in the WebACL. For more information, see + * CreateRule and UpdateRule.

    + *
  4. + *
  5. + *

    Create a WebACL. See CreateWebACL.

    + *
  6. + *
  7. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateWebACL request.

    + *
  8. + *
  9. + *

    Submit an UpdateWebACL request to specify the Rules + * that you want to include in the WebACL, to specify the default action, + * and to associate the WebACL with a CloudFront distribution.

    + *

    The ActivatedRule can be a rule group. If you specify a rule group + * as your + * ActivatedRule + * , + * you can exclude specific rules from that rule group.

    + *

    If you already have a rule group associated with a web ACL and want to submit + * an UpdateWebACL request to exclude certain rules from that rule group, + * you must first remove the rule group from the web ACL, the re-insert it again, + * specifying the excluded rules. + * For details, + * see + * ActivatedRule$ExcludedRules + * . + *

    + *
  10. + *
+ *

Be aware that if you try to add a RATE_BASED rule to a web ACL without setting the rule type when first creating the rule, the UpdateWebACL request will fail because the request tries to add a REGULAR rule (the default rule type) with the specified ID, which does not exist.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

+ */ export class UpdateWebACLCommand extends $Command< UpdateWebACLCommandInput, UpdateWebACLCommandOutput, @@ -34,6 +116,9 @@ export class UpdateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/commands/UpdateXssMatchSetCommand.ts b/clients/client-waf-regional/commands/UpdateXssMatchSetCommand.ts index f0768c01aa24f..7491ac8b71010 100644 --- a/clients/client-waf-regional/commands/UpdateXssMatchSetCommand.ts +++ b/clients/client-waf-regional/commands/UpdateXssMatchSetCommand.ts @@ -20,6 +20,60 @@ import { export type UpdateXssMatchSetCommandInput = UpdateXssMatchSetRequest; export type UpdateXssMatchSetCommandOutput = UpdateXssMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes XssMatchTuple objects (filters) in an XssMatchSet. + * For each XssMatchTuple object, you specify the following values:

+ *
    + *
  • + *

    + * Action: Whether to insert the object into or delete the object from the + * array. To change an + * XssMatchTuple, you delete the existing object and add a new + * one.

    + *
  • + *
  • + *

    + * FieldToMatch: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header or custom query parameter, + * the name of the header or parameter.

    + *
  • + *
  • + *

    + * TextTransformation: Which text transformation, if any, to perform on the web request before + * inspecting the request for cross-site scripting attacks.

    + *

    You can only specify a single type of TextTransformation.

    + *
  • + *
+ *

You use XssMatchSet objects to specify which CloudFront requests + * that + * you want to allow, block, or count. For example, if you're receiving + * requests that contain cross-site scripting attacks in the request body and you want to + * block the requests, you can create an XssMatchSet with the applicable + * settings, and then configure AWS WAF to block the requests.

+ *

To create and configure an XssMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Submit a CreateXssMatchSet request.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateIPSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateXssMatchSet request to specify the parts of web requests that you want AWS WAF to + * inspect for cross-site scripting attacks.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateXssMatchSetCommand extends $Command< UpdateXssMatchSetCommandInput, UpdateXssMatchSetCommandOutput, @@ -34,6 +88,9 @@ export class UpdateXssMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFRegionalClientResolvedConfig, diff --git a/clients/client-waf-regional/package.json b/clients/client-waf-regional/package.json index 4dd109814cf9f..5e70de52c4fdb 100644 --- a/clients/client-waf-regional/package.json +++ b/clients/client-waf-regional/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Waf Regional Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-waf-regional/runtimeConfig.browser.ts b/clients/client-waf-regional/runtimeConfig.browser.ts index cd7535d5b4846..f9b28b2364bc4 100644 --- a/clients/client-waf-regional/runtimeConfig.browser.ts +++ b/clients/client-waf-regional/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./WAFRegionalClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-waf-regional/runtimeConfig.native.ts b/clients/client-waf-regional/runtimeConfig.native.ts index fa4d0521cd225..ada1c500934c4 100644 --- a/clients/client-waf-regional/runtimeConfig.native.ts +++ b/clients/client-waf-regional/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./WAFRegionalClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-waf-regional/runtimeConfig.shared.ts b/clients/client-waf-regional/runtimeConfig.shared.ts index 6f473e36573a1..929703f535f5a 100644 --- a/clients/client-waf-regional/runtimeConfig.shared.ts +++ b/clients/client-waf-regional/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-11-28", disableHostPrefix: false, diff --git a/clients/client-waf-regional/runtimeConfig.ts b/clients/client-waf-regional/runtimeConfig.ts index 2c6cf84dcf841..2527c39138444 100644 --- a/clients/client-waf-regional/runtimeConfig.ts +++ b/clients/client-waf-regional/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./WAFRegionalClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-waf-regional/tsconfig.json b/clients/client-waf-regional/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-waf-regional/tsconfig.json +++ b/clients/client-waf-regional/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-waf/commands/CreateByteMatchSetCommand.ts b/clients/client-waf/commands/CreateByteMatchSetCommand.ts index d810edd15bc8e..838d05c5313e4 100644 --- a/clients/client-waf/commands/CreateByteMatchSetCommand.ts +++ b/clients/client-waf/commands/CreateByteMatchSetCommand.ts @@ -20,6 +20,40 @@ import { export type CreateByteMatchSetCommandInput = CreateByteMatchSetRequest; export type CreateByteMatchSetCommandOutput = CreateByteMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a ByteMatchSet. You then use UpdateByteMatchSet to identify the part of a + * web request that you want AWS WAF to inspect, such as the values of the User-Agent header or the query string. + * For example, you can create a ByteMatchSet that matches any requests with User-Agent headers + * that contain the string BadBot. You can then configure AWS WAF to reject those requests.

+ *

To create and configure a ByteMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateByteMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateByteMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateByteMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateByteMatchSetCommand extends $Command< CreateByteMatchSetCommandInput, CreateByteMatchSetCommandOutput, @@ -34,6 +68,9 @@ export class CreateByteMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateGeoMatchSetCommand.ts b/clients/client-waf/commands/CreateGeoMatchSetCommand.ts index 9df2bf3a95913..9b860b8d66e13 100644 --- a/clients/client-waf/commands/CreateGeoMatchSetCommand.ts +++ b/clients/client-waf/commands/CreateGeoMatchSetCommand.ts @@ -20,6 +20,37 @@ import { export type CreateGeoMatchSetCommandInput = CreateGeoMatchSetRequest; export type CreateGeoMatchSetCommandOutput = CreateGeoMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates an GeoMatchSet, which you use to specify which web requests you want to allow or block based on the country + * that the requests originate from. For example, if you're receiving a lot of requests from one or more countries and you want to block the requests, you can create an GeoMatchSet that contains those countries and then configure AWS WAF to block the requests.

+ *

To create and configure a GeoMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateGeoMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateGeoMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateGeoMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateGeoMatchSetSet request to specify the countries that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateGeoMatchSetCommand extends $Command< CreateGeoMatchSetCommandInput, CreateGeoMatchSetCommandOutput, @@ -34,6 +65,9 @@ export class CreateGeoMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateIPSetCommand.ts b/clients/client-waf/commands/CreateIPSetCommand.ts index 2a21b37fb3213..08ca84b4b9a14 100644 --- a/clients/client-waf/commands/CreateIPSetCommand.ts +++ b/clients/client-waf/commands/CreateIPSetCommand.ts @@ -20,6 +20,42 @@ import { export type CreateIPSetCommandInput = CreateIPSetRequest; export type CreateIPSetCommandOutput = CreateIPSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates an IPSet, which you use to specify which web requests + * that + * you want to allow or block based on the IP addresses that the requests + * originate from. For example, if you're receiving a lot of requests from one or more + * individual IP addresses or one or more ranges of IP addresses and you want to block the + * requests, you can create an IPSet that contains those IP addresses and then + * configure AWS WAF to block the requests.

+ *

To create and configure an IPSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateIPSet request.

    + *
  2. + *
  3. + *

    Submit a CreateIPSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateIPSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateIPSet request to specify the IP addresses that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateIPSetCommand extends $Command< CreateIPSetCommandInput, CreateIPSetCommandOutput, @@ -34,6 +70,9 @@ export class CreateIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateRateBasedRuleCommand.ts b/clients/client-waf/commands/CreateRateBasedRuleCommand.ts index 3147155bfacb8..4bf6b67f2aeb3 100644 --- a/clients/client-waf/commands/CreateRateBasedRuleCommand.ts +++ b/clients/client-waf/commands/CreateRateBasedRuleCommand.ts @@ -20,6 +20,102 @@ import { export type CreateRateBasedRuleCommandInput = CreateRateBasedRuleRequest; export type CreateRateBasedRuleCommandOutput = CreateRateBasedRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a RateBasedRule. The RateBasedRule contains a + * RateLimit, which specifies the maximum number of requests that AWS WAF allows + * from a specified IP address in a five-minute period. + * The RateBasedRule also + * contains the IPSet objects, ByteMatchSet objects, and other + * predicates that identify the requests that you want to count or block if these requests + * exceed the RateLimit.

+ *

If you add more than one predicate to a RateBasedRule, a request not + * only must exceed the RateLimit, but it also must match all the + * conditions to be counted or blocked. For example, suppose you add the following to a + * RateBasedRule:

+ *
    + *
  • + *

    An IPSet that matches the IP address 192.0.2.44/32 + *

    + *
  • + *
  • + *

    A ByteMatchSet that matches BadBot in the + * User-Agent header

    + *
  • + *
+ *

Further, you specify a RateLimit of 1,000.

+ *

You then add the RateBasedRule to a WebACL and specify that + * you want to block requests that meet the conditions in the rule. For a request to be + * blocked, it must come from the IP address 192.0.2.44 and the + * User-Agent header in the request must contain the value + * BadBot. Further, requests that match these two conditions must be received at + * a rate of more than 1,000 requests every five minutes. If both conditions are met and the + * rate is exceeded, AWS WAF blocks the requests. If the rate drops below 1,000 for a + * five-minute period, AWS WAF no longer blocks the requests.

+ * + *

As a second example, suppose you want to limit requests to a particular page on your site. To do this, you could add the following to a + * RateBasedRule:

+ * + * + *
    + *
  • + *

    A ByteMatchSet with FieldToMatch of URI + *

    + *
  • + *
  • + *

    A PositionalConstraint of STARTS_WITH + *

    + *
  • + *
  • + *

    A TargetString of login + *

    + *
  • + *
+ *

Further, you specify a RateLimit of 1,000.

+ *

By adding this RateBasedRule to a WebACL, you could limit requests to your login page without affecting the rest of your site.

+ * + * + *

To create and configure a RateBasedRule, perform the following + * steps:

+ *
    + *
  1. + *

    Create and update the predicates that you want to include in the rule. For more + * information, see CreateByteMatchSet, CreateIPSet, + * and CreateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide + * in the ChangeToken parameter of a CreateRule + * request.

    + *
  4. + *
  5. + *

    Submit a CreateRateBasedRule request.

    + *
  6. + *
  7. + *

    Use GetChangeToken to get the change token that you provide in the + * ChangeToken parameter of an UpdateRule + * request.

    + *
  8. + *
  9. + *

    Submit an UpdateRateBasedRule request to specify the predicates + * that you want to include in the rule.

    + *
  10. + *
  11. + *

    Create and update a WebACL that contains the + * RateBasedRule. For more information, see CreateWebACL.

    + *
  12. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, + * see the AWS WAF Developer + * Guide.

+ */ export class CreateRateBasedRuleCommand extends $Command< CreateRateBasedRuleCommandInput, CreateRateBasedRuleCommandOutput, @@ -34,6 +130,9 @@ export class CreateRateBasedRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateRegexMatchSetCommand.ts b/clients/client-waf/commands/CreateRegexMatchSetCommand.ts index a718d03eb688c..ab6c84d59f835 100644 --- a/clients/client-waf/commands/CreateRegexMatchSetCommand.ts +++ b/clients/client-waf/commands/CreateRegexMatchSetCommand.ts @@ -20,6 +20,40 @@ import { export type CreateRegexMatchSetCommandInput = CreateRegexMatchSetRequest; export type CreateRegexMatchSetCommandOutput = CreateRegexMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a RegexMatchSet. You then use UpdateRegexMatchSet to identify the part of a + * web request that you want AWS WAF to inspect, such as the values of the User-Agent header or the query string. + * For example, you can create a RegexMatchSet that contains a RegexMatchTuple that looks for any requests with User-Agent headers + * that match a RegexPatternSet with pattern B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

+ *

To create and configure a RegexMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateRegexMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateRegexMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRegexMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateRegexMatchSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value, using a RegexPatternSet, that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateRegexMatchSetCommand extends $Command< CreateRegexMatchSetCommandInput, CreateRegexMatchSetCommandOutput, @@ -34,6 +68,9 @@ export class CreateRegexMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateRegexPatternSetCommand.ts b/clients/client-waf/commands/CreateRegexPatternSetCommand.ts index 4c996e3ad9569..49b206c7c41e8 100644 --- a/clients/client-waf/commands/CreateRegexPatternSetCommand.ts +++ b/clients/client-waf/commands/CreateRegexPatternSetCommand.ts @@ -20,6 +20,36 @@ import { export type CreateRegexPatternSetCommandInput = CreateRegexPatternSetRequest; export type CreateRegexPatternSetCommandOutput = CreateRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a RegexPatternSet. You then use UpdateRegexPatternSet to specify the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

+ *

To create and configure a RegexPatternSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateRegexPatternSet request.

    + *
  2. + *
  3. + *

    Submit a CreateRegexPatternSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRegexPatternSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateRegexPatternSet request to specify the string that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateRegexPatternSetCommand extends $Command< CreateRegexPatternSetCommandInput, CreateRegexPatternSetCommandOutput, @@ -34,6 +64,9 @@ export class CreateRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateRuleCommand.ts b/clients/client-waf/commands/CreateRuleCommand.ts index 16748bcaf5bea..e6a24b401caae 100644 --- a/clients/client-waf/commands/CreateRuleCommand.ts +++ b/clients/client-waf/commands/CreateRuleCommand.ts @@ -20,6 +20,60 @@ import { export type CreateRuleCommandInput = CreateRuleRequest; export type CreateRuleCommandOutput = CreateRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a Rule, which contains the IPSet objects, + * ByteMatchSet objects, and other predicates that identify the requests that + * you want to block. If you add more than one predicate to a Rule, a request + * must match all of the specifications to be allowed or blocked. For example, suppose + * that + * you add the following to a Rule:

+ *
    + *
  • + *

    An IPSet that matches the IP address 192.0.2.44/32 + *

    + *
  • + *
  • + *

    A ByteMatchSet that matches BadBot in the User-Agent header

    + *
  • + *
+ *

You then add the Rule to a WebACL and specify that you want to blocks requests that satisfy the Rule. + * For a request to be blocked, it must come from the IP address 192.0.2.44 and the User-Agent header in the request + * must contain the value BadBot.

+ *

To create and configure a Rule, perform the following steps:

+ *
    + *
  1. + *

    Create and update the predicates that you want to include in the Rule. For more information, see + * CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateRule request.

    + *
  4. + *
  5. + *

    Submit a CreateRule request.

    + *
  6. + *
  7. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRule request.

    + *
  8. + *
  9. + *

    Submit an UpdateRule request to specify the predicates that you want to include in the Rule.

    + *
  10. + *
  11. + *

    Create and update a WebACL that contains the Rule. For more information, see CreateWebACL.

    + *
  12. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateRuleCommand extends $Command< CreateRuleCommandInput, CreateRuleCommandOutput, @@ -34,6 +88,9 @@ export class CreateRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateRuleGroupCommand.ts b/clients/client-waf/commands/CreateRuleGroupCommand.ts index 015184d058f12..8bbf9405a0140 100644 --- a/clients/client-waf/commands/CreateRuleGroupCommand.ts +++ b/clients/client-waf/commands/CreateRuleGroupCommand.ts @@ -20,6 +20,31 @@ import { export type CreateRuleGroupCommandInput = CreateRuleGroupRequest; export type CreateRuleGroupCommandOutput = CreateRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a RuleGroup. A rule group is a collection of predefined rules that you add to a web ACL. You use UpdateRuleGroup to add rules to the rule group.

+ *

Rule groups are subject to the following limits:

+ *
    + *
  • + *

    Three rule groups per account. You can request an increase to this limit by contacting customer support.

    + *
  • + *
  • + *

    One rule group per web ACL.

    + *
  • + *
  • + *

    Ten rules per rule group.

    + *
  • + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateRuleGroupCommand extends $Command< CreateRuleGroupCommandInput, CreateRuleGroupCommandOutput, @@ -34,6 +59,9 @@ export class CreateRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateSizeConstraintSetCommand.ts b/clients/client-waf/commands/CreateSizeConstraintSetCommand.ts index 6b4b7764f4859..81008091ceb52 100644 --- a/clients/client-waf/commands/CreateSizeConstraintSetCommand.ts +++ b/clients/client-waf/commands/CreateSizeConstraintSetCommand.ts @@ -20,6 +20,40 @@ import { export type CreateSizeConstraintSetCommandInput = CreateSizeConstraintSetRequest; export type CreateSizeConstraintSetCommandOutput = CreateSizeConstraintSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a SizeConstraintSet. You then use UpdateSizeConstraintSet to identify the part of a + * web request that you want AWS WAF to check for length, such as the length of the User-Agent header or the length of the query string. + * For example, you can create a SizeConstraintSet that matches any requests that have a query string that is longer than 100 bytes. + * You can then configure AWS WAF to reject those requests.

+ *

To create and configure a SizeConstraintSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateSizeConstraintSet request.

    + *
  2. + *
  3. + *

    Submit a CreateSizeConstraintSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateSizeConstraintSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value that you want AWS WAF to watch for.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateSizeConstraintSetCommand extends $Command< CreateSizeConstraintSetCommandInput, CreateSizeConstraintSetCommandOutput, @@ -34,6 +68,9 @@ export class CreateSizeConstraintSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateSqlInjectionMatchSetCommand.ts b/clients/client-waf/commands/CreateSqlInjectionMatchSetCommand.ts index 8925d709f13d2..558824c0c69d9 100644 --- a/clients/client-waf/commands/CreateSqlInjectionMatchSetCommand.ts +++ b/clients/client-waf/commands/CreateSqlInjectionMatchSetCommand.ts @@ -20,6 +20,38 @@ import { export type CreateSqlInjectionMatchSetCommandInput = CreateSqlInjectionMatchSetRequest; export type CreateSqlInjectionMatchSetCommandOutput = CreateSqlInjectionMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a SqlInjectionMatchSet, which you use to allow, block, or count requests that contain snippets of SQL code in a + * specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.

+ *

To create and configure a SqlInjectionMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateSqlInjectionMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateSqlInjectionMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateSqlInjectionMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests in which you want to + * allow, block, or count malicious SQL code.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateSqlInjectionMatchSetCommand extends $Command< CreateSqlInjectionMatchSetCommandInput, CreateSqlInjectionMatchSetCommandOutput, @@ -34,6 +66,9 @@ export class CreateSqlInjectionMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateWebACLCommand.ts b/clients/client-waf/commands/CreateWebACLCommand.ts index 892851031c79b..17be55c09cbb1 100644 --- a/clients/client-waf/commands/CreateWebACLCommand.ts +++ b/clients/client-waf/commands/CreateWebACLCommand.ts @@ -20,6 +20,48 @@ import { export type CreateWebACLCommandInput = CreateWebACLRequest; export type CreateWebACLCommandOutput = CreateWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates a WebACL, which contains the Rules that identify the CloudFront web requests that you want to allow, block, or count. + * AWS WAF evaluates Rules in order based on the value of Priority for each Rule.

+ *

You also specify a default action, either ALLOW or BLOCK. If a web request doesn't match + * any of the Rules in a WebACL, AWS WAF responds to the request with the default action.

+ *

To create and configure a WebACL, perform the following steps:

+ *
    + *
  1. + *

    Create and update the ByteMatchSet objects and other predicates that you want to include in Rules. + * For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, + * CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Create and update the Rules that you want to include in the WebACL. For more information, see + * CreateRule and UpdateRule.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateWebACL request.

    + *
  6. + *
  7. + *

    Submit a CreateWebACL request.

    + *
  8. + *
  9. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateWebACL request.

    + *
  10. + *
  11. + *

    Submit an UpdateWebACL request to specify the Rules that you want to include in the WebACL, + * to specify the default action, and to associate the WebACL with a CloudFront distribution.

    + *
  12. + *
+ *

For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide.

+ */ export class CreateWebACLCommand extends $Command< CreateWebACLCommandInput, CreateWebACLCommandOutput, @@ -34,6 +76,9 @@ export class CreateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateWebACLMigrationStackCommand.ts b/clients/client-waf/commands/CreateWebACLMigrationStackCommand.ts index b13efccdbb853..87741a5c6d022 100644 --- a/clients/client-waf/commands/CreateWebACLMigrationStackCommand.ts +++ b/clients/client-waf/commands/CreateWebACLMigrationStackCommand.ts @@ -20,6 +20,16 @@ import { export type CreateWebACLMigrationStackCommandInput = CreateWebACLMigrationStackRequest; export type CreateWebACLMigrationStackCommandOutput = CreateWebACLMigrationStackResponse & __MetadataBearer; +/** + *

Creates an AWS CloudFormation WAFV2 template for the specified web ACL in the specified Amazon S3 bucket. + * Then, in CloudFormation, you create a stack from the template, to create the web ACL and its resources in AWS WAFV2. + * Use this to migrate your AWS WAF Classic web ACL to the latest version of AWS WAF.

+ *

This is part of a larger migration procedure for web ACLs from AWS WAF Classic to the latest version of AWS WAF. + * For the full procedure, including caveats and manual steps to complete + * the migration and switch over to the new web ACL, see + * Migrating your AWS WAF Classic resources to AWS WAF in the AWS WAF + * Developer Guide.

+ */ export class CreateWebACLMigrationStackCommand extends $Command< CreateWebACLMigrationStackCommandInput, CreateWebACLMigrationStackCommandOutput, @@ -34,6 +44,9 @@ export class CreateWebACLMigrationStackCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/CreateXssMatchSetCommand.ts b/clients/client-waf/commands/CreateXssMatchSetCommand.ts index 3950d9edaf08a..7fc845df2228f 100644 --- a/clients/client-waf/commands/CreateXssMatchSetCommand.ts +++ b/clients/client-waf/commands/CreateXssMatchSetCommand.ts @@ -20,6 +20,38 @@ import { export type CreateXssMatchSetCommandInput = CreateXssMatchSetRequest; export type CreateXssMatchSetCommandOutput = CreateXssMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Creates an XssMatchSet, which you use to allow, block, or count requests that contain cross-site scripting attacks + * in the specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.

+ *

To create and configure an XssMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * CreateXssMatchSet request.

    + *
  2. + *
  3. + *

    Submit a CreateXssMatchSet request.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateXssMatchSet request.

    + *
  6. + *
  7. + *

    Submit an UpdateXssMatchSet request to specify the parts of web requests in which you want to + * allow, block, or count cross-site scripting attacks.

    + *
  8. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class CreateXssMatchSetCommand extends $Command< CreateXssMatchSetCommandInput, CreateXssMatchSetCommandOutput, @@ -34,6 +66,9 @@ export class CreateXssMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteByteMatchSetCommand.ts b/clients/client-waf/commands/DeleteByteMatchSetCommand.ts index 06e28df858b51..c863994d565d5 100644 --- a/clients/client-waf/commands/DeleteByteMatchSetCommand.ts +++ b/clients/client-waf/commands/DeleteByteMatchSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteByteMatchSetCommandInput = DeleteByteMatchSetRequest; export type DeleteByteMatchSetCommandOutput = DeleteByteMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a ByteMatchSet. You can't delete a ByteMatchSet if it's still used in any Rules + * or if it still includes any ByteMatchTuple objects (any filters).

+ *

If you just want to remove a ByteMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete a ByteMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Update the ByteMatchSet to remove filters, if any. For more information, see UpdateByteMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteByteMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteByteMatchSet request.

    + *
  6. + *
+ */ export class DeleteByteMatchSetCommand extends $Command< DeleteByteMatchSetCommandInput, DeleteByteMatchSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteByteMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteGeoMatchSetCommand.ts b/clients/client-waf/commands/DeleteGeoMatchSetCommand.ts index 0dd162f1817fa..4e3e0fa6cae27 100644 --- a/clients/client-waf/commands/DeleteGeoMatchSetCommand.ts +++ b/clients/client-waf/commands/DeleteGeoMatchSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteGeoMatchSetCommandInput = DeleteGeoMatchSetRequest; export type DeleteGeoMatchSetCommandOutput = DeleteGeoMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a GeoMatchSet. You can't delete a GeoMatchSet if it's still used in any Rules or + * if it still includes any countries.

+ *

If you just want to remove a GeoMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete a GeoMatchSet from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the GeoMatchSet to remove any countries. For more information, see UpdateGeoMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteGeoMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteGeoMatchSet request.

    + *
  6. + *
+ */ export class DeleteGeoMatchSetCommand extends $Command< DeleteGeoMatchSetCommandInput, DeleteGeoMatchSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteGeoMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteIPSetCommand.ts b/clients/client-waf/commands/DeleteIPSetCommand.ts index 0664f2b025bda..4f796ef12cedc 100644 --- a/clients/client-waf/commands/DeleteIPSetCommand.ts +++ b/clients/client-waf/commands/DeleteIPSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteIPSetCommandInput = DeleteIPSetRequest; export type DeleteIPSetCommandOutput = DeleteIPSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes an IPSet. You can't delete an IPSet if it's still used in any Rules or + * if it still includes any IP addresses.

+ *

If you just want to remove an IPSet from a Rule, use UpdateRule.

+ *

To permanently delete an IPSet from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the IPSet to remove IP address ranges, if any. For more information, see UpdateIPSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteIPSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteIPSet request.

    + *
  6. + *
+ */ export class DeleteIPSetCommand extends $Command< DeleteIPSetCommandInput, DeleteIPSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteLoggingConfigurationCommand.ts b/clients/client-waf/commands/DeleteLoggingConfigurationCommand.ts index b2509851bf9f6..863158a866894 100644 --- a/clients/client-waf/commands/DeleteLoggingConfigurationCommand.ts +++ b/clients/client-waf/commands/DeleteLoggingConfigurationCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteLoggingConfigurationCommandInput = DeleteLoggingConfigurationRequest; export type DeleteLoggingConfigurationCommandOutput = DeleteLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes the LoggingConfiguration from the specified web + * ACL.

+ */ export class DeleteLoggingConfigurationCommand extends $Command< DeleteLoggingConfigurationCommandInput, DeleteLoggingConfigurationCommandOutput, @@ -34,6 +46,9 @@ export class DeleteLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeletePermissionPolicyCommand.ts b/clients/client-waf/commands/DeletePermissionPolicyCommand.ts index 0213b036d5330..52adc3e670700 100644 --- a/clients/client-waf/commands/DeletePermissionPolicyCommand.ts +++ b/clients/client-waf/commands/DeletePermissionPolicyCommand.ts @@ -20,6 +20,18 @@ import { export type DeletePermissionPolicyCommandInput = DeletePermissionPolicyRequest; export type DeletePermissionPolicyCommandOutput = DeletePermissionPolicyResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes an IAM policy from the specified RuleGroup.

+ *

The user making the request must be the owner of the RuleGroup.

+ */ export class DeletePermissionPolicyCommand extends $Command< DeletePermissionPolicyCommandInput, DeletePermissionPolicyCommandOutput, @@ -34,6 +46,9 @@ export class DeletePermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteRateBasedRuleCommand.ts b/clients/client-waf/commands/DeleteRateBasedRuleCommand.ts index 689f96105fbf6..90ab9de9518d5 100644 --- a/clients/client-waf/commands/DeleteRateBasedRuleCommand.ts +++ b/clients/client-waf/commands/DeleteRateBasedRuleCommand.ts @@ -20,6 +20,36 @@ import { export type DeleteRateBasedRuleCommandInput = DeleteRateBasedRuleRequest; export type DeleteRateBasedRuleCommandOutput = DeleteRateBasedRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a RateBasedRule. You can't delete a rule if + * it's still used in any WebACL objects or if it still includes any predicates, + * such as ByteMatchSet objects.

+ *

If you just want to remove a rule from a WebACL, use UpdateWebACL.

+ *

To permanently delete a RateBasedRule from AWS WAF, perform the following + * steps:

+ *
    + *
  1. + *

    Update the RateBasedRule to remove predicates, if any. For more + * information, see UpdateRateBasedRule.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide + * in the ChangeToken parameter of a DeleteRateBasedRule + * request.

    + *
  4. + *
  5. + *

    Submit a DeleteRateBasedRule request.

    + *
  6. + *
+ */ export class DeleteRateBasedRuleCommand extends $Command< DeleteRateBasedRuleCommandInput, DeleteRateBasedRuleCommandOutput, @@ -34,6 +64,9 @@ export class DeleteRateBasedRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteRegexMatchSetCommand.ts b/clients/client-waf/commands/DeleteRegexMatchSetCommand.ts index ef4ac1035eed5..ccf0ae8a61db0 100644 --- a/clients/client-waf/commands/DeleteRegexMatchSetCommand.ts +++ b/clients/client-waf/commands/DeleteRegexMatchSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteRegexMatchSetCommandInput = DeleteRegexMatchSetRequest; export type DeleteRegexMatchSetCommandOutput = DeleteRegexMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a RegexMatchSet. You can't delete a RegexMatchSet if it's still used in any Rules + * or if it still includes any RegexMatchTuples objects (any filters).

+ *

If you just want to remove a RegexMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete a RegexMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Update the RegexMatchSet to remove filters, if any. For more information, see UpdateRegexMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteRegexMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteRegexMatchSet request.

    + *
  6. + *
+ */ export class DeleteRegexMatchSetCommand extends $Command< DeleteRegexMatchSetCommandInput, DeleteRegexMatchSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteRegexMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteRegexPatternSetCommand.ts b/clients/client-waf/commands/DeleteRegexPatternSetCommand.ts index bc0311358ab1d..e806014099d1b 100644 --- a/clients/client-waf/commands/DeleteRegexPatternSetCommand.ts +++ b/clients/client-waf/commands/DeleteRegexPatternSetCommand.ts @@ -20,6 +20,18 @@ import { export type DeleteRegexPatternSetCommandInput = DeleteRegexPatternSetRequest; export type DeleteRegexPatternSetCommandOutput = DeleteRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a RegexPatternSet. You can't delete a RegexPatternSet if it's still used in any RegexMatchSet + * or if the RegexPatternSet is not empty.

+ */ export class DeleteRegexPatternSetCommand extends $Command< DeleteRegexPatternSetCommandInput, DeleteRegexPatternSetCommandOutput, @@ -34,6 +46,9 @@ export class DeleteRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteRuleCommand.ts b/clients/client-waf/commands/DeleteRuleCommand.ts index cfd6e0a58609c..3673cd9a11467 100644 --- a/clients/client-waf/commands/DeleteRuleCommand.ts +++ b/clients/client-waf/commands/DeleteRuleCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteRuleCommandInput = DeleteRuleRequest; export type DeleteRuleCommandOutput = DeleteRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a Rule. You can't delete a Rule if it's still used in any WebACL + * objects or if it still includes any predicates, such as ByteMatchSet objects.

+ *

If you just want to remove a Rule from a WebACL, use UpdateWebACL.

+ *

To permanently delete a Rule from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the Rule to remove predicates, if any. For more information, see UpdateRule.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteRule request.

    + *
  4. + *
  5. + *

    Submit a DeleteRule request.

    + *
  6. + *
+ */ export class DeleteRuleCommand extends $Command< DeleteRuleCommandInput, DeleteRuleCommandOutput, @@ -34,6 +60,9 @@ export class DeleteRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteRuleGroupCommand.ts b/clients/client-waf/commands/DeleteRuleGroupCommand.ts index cc1c6dbe52c61..34692946cc469 100644 --- a/clients/client-waf/commands/DeleteRuleGroupCommand.ts +++ b/clients/client-waf/commands/DeleteRuleGroupCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteRuleGroupCommandInput = DeleteRuleGroupRequest; export type DeleteRuleGroupCommandOutput = DeleteRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a RuleGroup. You can't delete a RuleGroup if it's still used in any WebACL + * objects or if it still includes any rules.

+ *

If you just want to remove a RuleGroup from a WebACL, use UpdateWebACL.

+ *

To permanently delete a RuleGroup from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the RuleGroup to remove rules, if any. For more information, see UpdateRuleGroup.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteRuleGroup request.

    + *
  4. + *
  5. + *

    Submit a DeleteRuleGroup request.

    + *
  6. + *
+ */ export class DeleteRuleGroupCommand extends $Command< DeleteRuleGroupCommandInput, DeleteRuleGroupCommandOutput, @@ -34,6 +60,9 @@ export class DeleteRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteSizeConstraintSetCommand.ts b/clients/client-waf/commands/DeleteSizeConstraintSetCommand.ts index a1dbbcff87451..ac99faf71a3f6 100644 --- a/clients/client-waf/commands/DeleteSizeConstraintSetCommand.ts +++ b/clients/client-waf/commands/DeleteSizeConstraintSetCommand.ts @@ -20,6 +20,32 @@ import { export type DeleteSizeConstraintSetCommandInput = DeleteSizeConstraintSetRequest; export type DeleteSizeConstraintSetCommandOutput = DeleteSizeConstraintSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a SizeConstraintSet. You can't delete a SizeConstraintSet if it's still used in any Rules + * or if it still includes any SizeConstraint objects (any filters).

+ *

If you just want to remove a SizeConstraintSet from a Rule, use UpdateRule.

+ *

To permanently delete a SizeConstraintSet, perform the following steps:

+ *
    + *
  1. + *

    Update the SizeConstraintSet to remove filters, if any. For more information, see UpdateSizeConstraintSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteSizeConstraintSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteSizeConstraintSet request.

    + *
  6. + *
+ */ export class DeleteSizeConstraintSetCommand extends $Command< DeleteSizeConstraintSetCommandInput, DeleteSizeConstraintSetCommandOutput, @@ -34,6 +60,9 @@ export class DeleteSizeConstraintSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteSqlInjectionMatchSetCommand.ts b/clients/client-waf/commands/DeleteSqlInjectionMatchSetCommand.ts index a4e76d04cf04b..5ef913723eb6a 100644 --- a/clients/client-waf/commands/DeleteSqlInjectionMatchSetCommand.ts +++ b/clients/client-waf/commands/DeleteSqlInjectionMatchSetCommand.ts @@ -20,6 +20,33 @@ import { export type DeleteSqlInjectionMatchSetCommandInput = DeleteSqlInjectionMatchSetRequest; export type DeleteSqlInjectionMatchSetCommandOutput = DeleteSqlInjectionMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a SqlInjectionMatchSet. You can't delete a SqlInjectionMatchSet if it's + * still used in any Rules or if it still contains any SqlInjectionMatchTuple objects.

+ *

If you just want to remove a SqlInjectionMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete a SqlInjectionMatchSet from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the SqlInjectionMatchSet to remove filters, if any. For more information, see + * UpdateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteSqlInjectionMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteSqlInjectionMatchSet request.

    + *
  6. + *
+ */ export class DeleteSqlInjectionMatchSetCommand extends $Command< DeleteSqlInjectionMatchSetCommandInput, DeleteSqlInjectionMatchSetCommandOutput, @@ -34,6 +61,9 @@ export class DeleteSqlInjectionMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteWebACLCommand.ts b/clients/client-waf/commands/DeleteWebACLCommand.ts index 34d6e86a663a8..28c8adc131198 100644 --- a/clients/client-waf/commands/DeleteWebACLCommand.ts +++ b/clients/client-waf/commands/DeleteWebACLCommand.ts @@ -20,6 +20,30 @@ import { export type DeleteWebACLCommandInput = DeleteWebACLRequest; export type DeleteWebACLCommandOutput = DeleteWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes a WebACL. You can't delete a WebACL if it still contains any Rules.

+ *

To delete a WebACL, perform the following steps:

+ *
    + *
  1. + *

    Update the WebACL to remove Rules, if any. For more information, see UpdateWebACL.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteWebACL request.

    + *
  4. + *
  5. + *

    Submit a DeleteWebACL request.

    + *
  6. + *
+ */ export class DeleteWebACLCommand extends $Command< DeleteWebACLCommandInput, DeleteWebACLCommandOutput, @@ -34,6 +58,9 @@ export class DeleteWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/DeleteXssMatchSetCommand.ts b/clients/client-waf/commands/DeleteXssMatchSetCommand.ts index 66d6d0f71e8ce..a1a86d5f20c34 100644 --- a/clients/client-waf/commands/DeleteXssMatchSetCommand.ts +++ b/clients/client-waf/commands/DeleteXssMatchSetCommand.ts @@ -20,6 +20,33 @@ import { export type DeleteXssMatchSetCommandInput = DeleteXssMatchSetRequest; export type DeleteXssMatchSetCommandOutput = DeleteXssMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Permanently deletes an XssMatchSet. You can't delete an XssMatchSet if it's + * still used in any Rules or if it still contains any XssMatchTuple objects.

+ *

If you just want to remove an XssMatchSet from a Rule, use UpdateRule.

+ *

To permanently delete an XssMatchSet from AWS WAF, perform the following steps:

+ *
    + *
  1. + *

    Update the XssMatchSet to remove filters, if any. For more information, see + * UpdateXssMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a + * DeleteXssMatchSet request.

    + *
  4. + *
  5. + *

    Submit a DeleteXssMatchSet request.

    + *
  6. + *
+ */ export class DeleteXssMatchSetCommand extends $Command< DeleteXssMatchSetCommandInput, DeleteXssMatchSetCommandOutput, @@ -34,6 +61,9 @@ export class DeleteXssMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetByteMatchSetCommand.ts b/clients/client-waf/commands/GetByteMatchSetCommand.ts index f9bb8dce70af9..6226433328d67 100644 --- a/clients/client-waf/commands/GetByteMatchSetCommand.ts +++ b/clients/client-waf/commands/GetByteMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetByteMatchSetCommandInput = GetByteMatchSetRequest; export type GetByteMatchSetCommandOutput = GetByteMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the ByteMatchSet specified by ByteMatchSetId.

+ */ export class GetByteMatchSetCommand extends $Command< GetByteMatchSetCommandInput, GetByteMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetByteMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetChangeTokenCommand.ts b/clients/client-waf/commands/GetChangeTokenCommand.ts index 83673353c57cb..781250c385e3b 100644 --- a/clients/client-waf/commands/GetChangeTokenCommand.ts +++ b/clients/client-waf/commands/GetChangeTokenCommand.ts @@ -20,6 +20,23 @@ import { export type GetChangeTokenCommandInput = GetChangeTokenRequest; export type GetChangeTokenCommandOutput = GetChangeTokenResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

When you want to create, update, or delete AWS WAF objects, get a change token and include the change token in the create, update, or delete request. Change tokens ensure that your application doesn't submit conflicting requests to AWS WAF.

+ *

Each create, update, or delete request must use a unique change token. If your application submits a GetChangeToken request + * and then submits a second GetChangeToken request before submitting a create, update, or delete request, the second + * GetChangeToken request returns the same value as the first GetChangeToken request.

+ *

When you use a change token in a create, update, or delete request, the status of the change token changes to PENDING, + * which indicates that AWS WAF is propagating the change to all AWS WAF servers. Use GetChangeTokenStatus to determine the + * status of your change token.

+ */ export class GetChangeTokenCommand extends $Command< GetChangeTokenCommandInput, GetChangeTokenCommandOutput, @@ -34,6 +51,9 @@ export class GetChangeTokenCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetChangeTokenStatusCommand.ts b/clients/client-waf/commands/GetChangeTokenStatusCommand.ts index fa2d5afc0e9ef..13e9b9f69e4da 100644 --- a/clients/client-waf/commands/GetChangeTokenStatusCommand.ts +++ b/clients/client-waf/commands/GetChangeTokenStatusCommand.ts @@ -20,6 +20,33 @@ import { export type GetChangeTokenStatusCommandInput = GetChangeTokenStatusRequest; export type GetChangeTokenStatusCommandOutput = GetChangeTokenStatusResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the status of a ChangeToken that you got by calling GetChangeToken. ChangeTokenStatus is + * one of the following values:

+ *
    + *
  • + *

    + * PROVISIONED: You requested the change token by calling GetChangeToken, but you haven't used it yet + * in a call to create, update, or delete an AWS WAF object.

    + *
  • + *
  • + *

    + * PENDING: AWS WAF is propagating the create, update, or delete request to all AWS WAF servers.

    + *
  • + *
  • + *

    + * INSYNC: Propagation is complete.

    + *
  • + *
+ */ export class GetChangeTokenStatusCommand extends $Command< GetChangeTokenStatusCommandInput, GetChangeTokenStatusCommandOutput, @@ -34,6 +61,9 @@ export class GetChangeTokenStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetGeoMatchSetCommand.ts b/clients/client-waf/commands/GetGeoMatchSetCommand.ts index c40c35d1bf64f..2664c474bd571 100644 --- a/clients/client-waf/commands/GetGeoMatchSetCommand.ts +++ b/clients/client-waf/commands/GetGeoMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetGeoMatchSetCommandInput = GetGeoMatchSetRequest; export type GetGeoMatchSetCommandOutput = GetGeoMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the GeoMatchSet that is specified by GeoMatchSetId.

+ */ export class GetGeoMatchSetCommand extends $Command< GetGeoMatchSetCommandInput, GetGeoMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetGeoMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetIPSetCommand.ts b/clients/client-waf/commands/GetIPSetCommand.ts index a36bf8f6d19da..edab9b7359f61 100644 --- a/clients/client-waf/commands/GetIPSetCommand.ts +++ b/clients/client-waf/commands/GetIPSetCommand.ts @@ -17,6 +17,17 @@ import { export type GetIPSetCommandInput = GetIPSetRequest; export type GetIPSetCommandOutput = GetIPSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the IPSet that is specified by IPSetId.

+ */ export class GetIPSetCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +38,9 @@ export class GetIPSetCommand extends $Command, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetLoggingConfigurationCommand.ts b/clients/client-waf/commands/GetLoggingConfigurationCommand.ts index 4270a364d8bca..671e87016e28a 100644 --- a/clients/client-waf/commands/GetLoggingConfigurationCommand.ts +++ b/clients/client-waf/commands/GetLoggingConfigurationCommand.ts @@ -20,6 +20,17 @@ import { export type GetLoggingConfigurationCommandInput = GetLoggingConfigurationRequest; export type GetLoggingConfigurationCommandOutput = GetLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the LoggingConfiguration for the specified web ACL.

+ */ export class GetLoggingConfigurationCommand extends $Command< GetLoggingConfigurationCommandInput, GetLoggingConfigurationCommandOutput, @@ -34,6 +45,9 @@ export class GetLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetPermissionPolicyCommand.ts b/clients/client-waf/commands/GetPermissionPolicyCommand.ts index 80086e779e5c8..541db322f088e 100644 --- a/clients/client-waf/commands/GetPermissionPolicyCommand.ts +++ b/clients/client-waf/commands/GetPermissionPolicyCommand.ts @@ -20,6 +20,17 @@ import { export type GetPermissionPolicyCommandInput = GetPermissionPolicyRequest; export type GetPermissionPolicyCommandOutput = GetPermissionPolicyResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the IAM policy attached to the RuleGroup.

+ */ export class GetPermissionPolicyCommand extends $Command< GetPermissionPolicyCommandInput, GetPermissionPolicyCommandOutput, @@ -34,6 +45,9 @@ export class GetPermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetRateBasedRuleCommand.ts b/clients/client-waf/commands/GetRateBasedRuleCommand.ts index 19dbb35852fd9..abe15efdc5fd5 100644 --- a/clients/client-waf/commands/GetRateBasedRuleCommand.ts +++ b/clients/client-waf/commands/GetRateBasedRuleCommand.ts @@ -20,6 +20,19 @@ import { export type GetRateBasedRuleCommandInput = GetRateBasedRuleRequest; export type GetRateBasedRuleCommandOutput = GetRateBasedRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the RateBasedRule that is specified by the + * RuleId that you included in the GetRateBasedRule + * request.

+ */ export class GetRateBasedRuleCommand extends $Command< GetRateBasedRuleCommandInput, GetRateBasedRuleCommandOutput, @@ -34,6 +47,9 @@ export class GetRateBasedRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetRateBasedRuleManagedKeysCommand.ts b/clients/client-waf/commands/GetRateBasedRuleManagedKeysCommand.ts index 068f908983b22..63bb72e0faa1f 100644 --- a/clients/client-waf/commands/GetRateBasedRuleManagedKeysCommand.ts +++ b/clients/client-waf/commands/GetRateBasedRuleManagedKeysCommand.ts @@ -20,6 +20,19 @@ import { export type GetRateBasedRuleManagedKeysCommandInput = GetRateBasedRuleManagedKeysRequest; export type GetRateBasedRuleManagedKeysCommandOutput = GetRateBasedRuleManagedKeysResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of IP addresses currently being blocked by the RateBasedRule that is specified by the RuleId. The maximum + * number of managed keys that will be blocked is 10,000. If more than 10,000 addresses exceed + * the rate limit, the 10,000 addresses with the highest rates will be blocked.

+ */ export class GetRateBasedRuleManagedKeysCommand extends $Command< GetRateBasedRuleManagedKeysCommandInput, GetRateBasedRuleManagedKeysCommandOutput, @@ -34,6 +47,9 @@ export class GetRateBasedRuleManagedKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetRegexMatchSetCommand.ts b/clients/client-waf/commands/GetRegexMatchSetCommand.ts index 2cb09abcd651e..3a315678ed9aa 100644 --- a/clients/client-waf/commands/GetRegexMatchSetCommand.ts +++ b/clients/client-waf/commands/GetRegexMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetRegexMatchSetCommandInput = GetRegexMatchSetRequest; export type GetRegexMatchSetCommandOutput = GetRegexMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the RegexMatchSet specified by RegexMatchSetId.

+ */ export class GetRegexMatchSetCommand extends $Command< GetRegexMatchSetCommandInput, GetRegexMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetRegexMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetRegexPatternSetCommand.ts b/clients/client-waf/commands/GetRegexPatternSetCommand.ts index 42a5d922363e8..1335b8d636e3f 100644 --- a/clients/client-waf/commands/GetRegexPatternSetCommand.ts +++ b/clients/client-waf/commands/GetRegexPatternSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetRegexPatternSetCommandInput = GetRegexPatternSetRequest; export type GetRegexPatternSetCommandOutput = GetRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the RegexPatternSet specified by RegexPatternSetId.

+ */ export class GetRegexPatternSetCommand extends $Command< GetRegexPatternSetCommandInput, GetRegexPatternSetCommandOutput, @@ -34,6 +45,9 @@ export class GetRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetRuleCommand.ts b/clients/client-waf/commands/GetRuleCommand.ts index 207066e303cf8..e0c9677ef30be 100644 --- a/clients/client-waf/commands/GetRuleCommand.ts +++ b/clients/client-waf/commands/GetRuleCommand.ts @@ -17,6 +17,17 @@ import { export type GetRuleCommandInput = GetRuleRequest; export type GetRuleCommandOutput = GetRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the Rule that is specified by the RuleId that you included in the GetRule request.

+ */ export class GetRuleCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +38,9 @@ export class GetRuleCommand extends $Command, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetRuleGroupCommand.ts b/clients/client-waf/commands/GetRuleGroupCommand.ts index 7512a09ee9380..c00bc7df4a4a0 100644 --- a/clients/client-waf/commands/GetRuleGroupCommand.ts +++ b/clients/client-waf/commands/GetRuleGroupCommand.ts @@ -20,6 +20,18 @@ import { export type GetRuleGroupCommandInput = GetRuleGroupRequest; export type GetRuleGroupCommandOutput = GetRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the RuleGroup that is specified by the RuleGroupId that you included in the GetRuleGroup request.

+ *

To view the rules in a rule group, use ListActivatedRulesInRuleGroup.

+ */ export class GetRuleGroupCommand extends $Command< GetRuleGroupCommandInput, GetRuleGroupCommandOutput, @@ -34,6 +46,9 @@ export class GetRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetSampledRequestsCommand.ts b/clients/client-waf/commands/GetSampledRequestsCommand.ts index 5f7a3351782ed..e9078d8602fca 100644 --- a/clients/client-waf/commands/GetSampledRequestsCommand.ts +++ b/clients/client-waf/commands/GetSampledRequestsCommand.ts @@ -20,6 +20,21 @@ import { export type GetSampledRequestsCommandInput = GetSampledRequestsRequest; export type GetSampledRequestsCommandOutput = GetSampledRequestsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Gets detailed information about a specified number of requests--a sample--that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received during a time range that you choose. You can specify a sample size of up to 500 requests, and you can specify any time range in the previous three hours.

+ *

+ * GetSampledRequests returns a time range, which is usually the time range that you specified. However, if your resource + * (such as a CloudFront distribution) received 5,000 requests before the specified time range elapsed, GetSampledRequests + * returns an updated time range. This new time range indicates the actual period during which AWS WAF selected the requests in the sample.

+ */ export class GetSampledRequestsCommand extends $Command< GetSampledRequestsCommandInput, GetSampledRequestsCommandOutput, @@ -34,6 +49,9 @@ export class GetSampledRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetSizeConstraintSetCommand.ts b/clients/client-waf/commands/GetSizeConstraintSetCommand.ts index cc679b4760896..77a5e63d7da52 100644 --- a/clients/client-waf/commands/GetSizeConstraintSetCommand.ts +++ b/clients/client-waf/commands/GetSizeConstraintSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetSizeConstraintSetCommandInput = GetSizeConstraintSetRequest; export type GetSizeConstraintSetCommandOutput = GetSizeConstraintSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the SizeConstraintSet specified by SizeConstraintSetId.

+ */ export class GetSizeConstraintSetCommand extends $Command< GetSizeConstraintSetCommandInput, GetSizeConstraintSetCommandOutput, @@ -34,6 +45,9 @@ export class GetSizeConstraintSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetSqlInjectionMatchSetCommand.ts b/clients/client-waf/commands/GetSqlInjectionMatchSetCommand.ts index e9abcfbe2e21f..8c9081e132ad7 100644 --- a/clients/client-waf/commands/GetSqlInjectionMatchSetCommand.ts +++ b/clients/client-waf/commands/GetSqlInjectionMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetSqlInjectionMatchSetCommandInput = GetSqlInjectionMatchSetRequest; export type GetSqlInjectionMatchSetCommandOutput = GetSqlInjectionMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the SqlInjectionMatchSet that is specified by SqlInjectionMatchSetId.

+ */ export class GetSqlInjectionMatchSetCommand extends $Command< GetSqlInjectionMatchSetCommandInput, GetSqlInjectionMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetSqlInjectionMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetWebACLCommand.ts b/clients/client-waf/commands/GetWebACLCommand.ts index c8b06305e1d3d..65b78b66c4504 100644 --- a/clients/client-waf/commands/GetWebACLCommand.ts +++ b/clients/client-waf/commands/GetWebACLCommand.ts @@ -17,6 +17,17 @@ import { export type GetWebACLCommandInput = GetWebACLRequest; export type GetWebACLCommandOutput = GetWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the WebACL that is specified by WebACLId.

+ */ export class GetWebACLCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +38,9 @@ export class GetWebACLCommand extends $Command, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/GetXssMatchSetCommand.ts b/clients/client-waf/commands/GetXssMatchSetCommand.ts index 3c5fb9a60616b..b90f70d359b9e 100644 --- a/clients/client-waf/commands/GetXssMatchSetCommand.ts +++ b/clients/client-waf/commands/GetXssMatchSetCommand.ts @@ -20,6 +20,17 @@ import { export type GetXssMatchSetCommandInput = GetXssMatchSetRequest; export type GetXssMatchSetCommandOutput = GetXssMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns the XssMatchSet that is specified by XssMatchSetId.

+ */ export class GetXssMatchSetCommand extends $Command< GetXssMatchSetCommandInput, GetXssMatchSetCommandOutput, @@ -34,6 +45,9 @@ export class GetXssMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListActivatedRulesInRuleGroupCommand.ts b/clients/client-waf/commands/ListActivatedRulesInRuleGroupCommand.ts index 8fa5f642266ac..2455c11e3e0a7 100644 --- a/clients/client-waf/commands/ListActivatedRulesInRuleGroupCommand.ts +++ b/clients/client-waf/commands/ListActivatedRulesInRuleGroupCommand.ts @@ -20,6 +20,17 @@ import { export type ListActivatedRulesInRuleGroupCommandInput = ListActivatedRulesInRuleGroupRequest; export type ListActivatedRulesInRuleGroupCommandOutput = ListActivatedRulesInRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of ActivatedRule objects.

+ */ export class ListActivatedRulesInRuleGroupCommand extends $Command< ListActivatedRulesInRuleGroupCommandInput, ListActivatedRulesInRuleGroupCommandOutput, @@ -34,6 +45,9 @@ export class ListActivatedRulesInRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListByteMatchSetsCommand.ts b/clients/client-waf/commands/ListByteMatchSetsCommand.ts index a69d83981d866..8f79931705349 100644 --- a/clients/client-waf/commands/ListByteMatchSetsCommand.ts +++ b/clients/client-waf/commands/ListByteMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListByteMatchSetsCommandInput = ListByteMatchSetsRequest; export type ListByteMatchSetsCommandOutput = ListByteMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of ByteMatchSetSummary objects.

+ */ export class ListByteMatchSetsCommand extends $Command< ListByteMatchSetsCommandInput, ListByteMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListByteMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListGeoMatchSetsCommand.ts b/clients/client-waf/commands/ListGeoMatchSetsCommand.ts index 084b038ec0d9c..7934c0e52d52d 100644 --- a/clients/client-waf/commands/ListGeoMatchSetsCommand.ts +++ b/clients/client-waf/commands/ListGeoMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListGeoMatchSetsCommandInput = ListGeoMatchSetsRequest; export type ListGeoMatchSetsCommandOutput = ListGeoMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of GeoMatchSetSummary objects in the response.

+ */ export class ListGeoMatchSetsCommand extends $Command< ListGeoMatchSetsCommandInput, ListGeoMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListGeoMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListIPSetsCommand.ts b/clients/client-waf/commands/ListIPSetsCommand.ts index c3b6e247a4eac..6ce3507949e24 100644 --- a/clients/client-waf/commands/ListIPSetsCommand.ts +++ b/clients/client-waf/commands/ListIPSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListIPSetsCommandInput = ListIPSetsRequest; export type ListIPSetsCommandOutput = ListIPSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of IPSetSummary objects in the response.

+ */ export class ListIPSetsCommand extends $Command< ListIPSetsCommandInput, ListIPSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListIPSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListLoggingConfigurationsCommand.ts b/clients/client-waf/commands/ListLoggingConfigurationsCommand.ts index 214f79f8db541..4d090780b40ce 100644 --- a/clients/client-waf/commands/ListLoggingConfigurationsCommand.ts +++ b/clients/client-waf/commands/ListLoggingConfigurationsCommand.ts @@ -20,6 +20,17 @@ import { export type ListLoggingConfigurationsCommandInput = ListLoggingConfigurationsRequest; export type ListLoggingConfigurationsCommandOutput = ListLoggingConfigurationsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of LoggingConfiguration objects.

+ */ export class ListLoggingConfigurationsCommand extends $Command< ListLoggingConfigurationsCommandInput, ListLoggingConfigurationsCommandOutput, @@ -34,6 +45,9 @@ export class ListLoggingConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListRateBasedRulesCommand.ts b/clients/client-waf/commands/ListRateBasedRulesCommand.ts index 653303e6c54d4..993974885b4d5 100644 --- a/clients/client-waf/commands/ListRateBasedRulesCommand.ts +++ b/clients/client-waf/commands/ListRateBasedRulesCommand.ts @@ -20,6 +20,17 @@ import { export type ListRateBasedRulesCommandInput = ListRateBasedRulesRequest; export type ListRateBasedRulesCommandOutput = ListRateBasedRulesResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RuleSummary objects.

+ */ export class ListRateBasedRulesCommand extends $Command< ListRateBasedRulesCommandInput, ListRateBasedRulesCommandOutput, @@ -34,6 +45,9 @@ export class ListRateBasedRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListRegexMatchSetsCommand.ts b/clients/client-waf/commands/ListRegexMatchSetsCommand.ts index ac7035fcd154f..9aab35ba6b7f3 100644 --- a/clients/client-waf/commands/ListRegexMatchSetsCommand.ts +++ b/clients/client-waf/commands/ListRegexMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListRegexMatchSetsCommandInput = ListRegexMatchSetsRequest; export type ListRegexMatchSetsCommandOutput = ListRegexMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RegexMatchSetSummary objects.

+ */ export class ListRegexMatchSetsCommand extends $Command< ListRegexMatchSetsCommandInput, ListRegexMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListRegexMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListRegexPatternSetsCommand.ts b/clients/client-waf/commands/ListRegexPatternSetsCommand.ts index e3337d7b3b064..aca98c5dee385 100644 --- a/clients/client-waf/commands/ListRegexPatternSetsCommand.ts +++ b/clients/client-waf/commands/ListRegexPatternSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListRegexPatternSetsCommandInput = ListRegexPatternSetsRequest; export type ListRegexPatternSetsCommandOutput = ListRegexPatternSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RegexPatternSetSummary objects.

+ */ export class ListRegexPatternSetsCommand extends $Command< ListRegexPatternSetsCommandInput, ListRegexPatternSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListRegexPatternSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListRuleGroupsCommand.ts b/clients/client-waf/commands/ListRuleGroupsCommand.ts index b8bf57b88bedc..0094bd14579e1 100644 --- a/clients/client-waf/commands/ListRuleGroupsCommand.ts +++ b/clients/client-waf/commands/ListRuleGroupsCommand.ts @@ -20,6 +20,17 @@ import { export type ListRuleGroupsCommandInput = ListRuleGroupsRequest; export type ListRuleGroupsCommandOutput = ListRuleGroupsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RuleGroup objects.

+ */ export class ListRuleGroupsCommand extends $Command< ListRuleGroupsCommandInput, ListRuleGroupsCommandOutput, @@ -34,6 +45,9 @@ export class ListRuleGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListRulesCommand.ts b/clients/client-waf/commands/ListRulesCommand.ts index f1bcbee407d76..291cde272373c 100644 --- a/clients/client-waf/commands/ListRulesCommand.ts +++ b/clients/client-waf/commands/ListRulesCommand.ts @@ -17,6 +17,17 @@ import { export type ListRulesCommandInput = ListRulesRequest; export type ListRulesCommandOutput = ListRulesResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RuleSummary objects.

+ */ export class ListRulesCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +38,9 @@ export class ListRulesCommand extends $Command, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListSizeConstraintSetsCommand.ts b/clients/client-waf/commands/ListSizeConstraintSetsCommand.ts index 31bed0a1da413..3ea16602d8197 100644 --- a/clients/client-waf/commands/ListSizeConstraintSetsCommand.ts +++ b/clients/client-waf/commands/ListSizeConstraintSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListSizeConstraintSetsCommandInput = ListSizeConstraintSetsRequest; export type ListSizeConstraintSetsCommandOutput = ListSizeConstraintSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of SizeConstraintSetSummary objects.

+ */ export class ListSizeConstraintSetsCommand extends $Command< ListSizeConstraintSetsCommandInput, ListSizeConstraintSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListSizeConstraintSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListSqlInjectionMatchSetsCommand.ts b/clients/client-waf/commands/ListSqlInjectionMatchSetsCommand.ts index 82125c454aadf..52e8b43a720c5 100644 --- a/clients/client-waf/commands/ListSqlInjectionMatchSetsCommand.ts +++ b/clients/client-waf/commands/ListSqlInjectionMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListSqlInjectionMatchSetsCommandInput = ListSqlInjectionMatchSetsRequest; export type ListSqlInjectionMatchSetsCommandOutput = ListSqlInjectionMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of SqlInjectionMatchSet objects.

+ */ export class ListSqlInjectionMatchSetsCommand extends $Command< ListSqlInjectionMatchSetsCommandInput, ListSqlInjectionMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListSqlInjectionMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListSubscribedRuleGroupsCommand.ts b/clients/client-waf/commands/ListSubscribedRuleGroupsCommand.ts index f5e845918b442..67eda2fb20368 100644 --- a/clients/client-waf/commands/ListSubscribedRuleGroupsCommand.ts +++ b/clients/client-waf/commands/ListSubscribedRuleGroupsCommand.ts @@ -20,6 +20,17 @@ import { export type ListSubscribedRuleGroupsCommandInput = ListSubscribedRuleGroupsRequest; export type ListSubscribedRuleGroupsCommandOutput = ListSubscribedRuleGroupsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of RuleGroup objects that you are subscribed to.

+ */ export class ListSubscribedRuleGroupsCommand extends $Command< ListSubscribedRuleGroupsCommandInput, ListSubscribedRuleGroupsCommandOutput, @@ -34,6 +45,9 @@ export class ListSubscribedRuleGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListTagsForResourceCommand.ts b/clients/client-waf/commands/ListTagsForResourceCommand.ts index 004cdb8ca36d9..1f882e956570f 100644 --- a/clients/client-waf/commands/ListTagsForResourceCommand.ts +++ b/clients/client-waf/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,18 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Retrieves the tags associated with the specified AWS resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each AWS resource, up to 50 tags for a resource.

+ *

Tagging is only available through the API, SDKs, and CLI. You can't manage or view tags through the AWS WAF Classic console. You can tag the AWS resources that you manage through AWS WAF Classic: web ACLs, rule groups, and rules.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +46,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListWebACLsCommand.ts b/clients/client-waf/commands/ListWebACLsCommand.ts index 8fab84e1637df..f9051017636ef 100644 --- a/clients/client-waf/commands/ListWebACLsCommand.ts +++ b/clients/client-waf/commands/ListWebACLsCommand.ts @@ -20,6 +20,17 @@ import { export type ListWebACLsCommandInput = ListWebACLsRequest; export type ListWebACLsCommandOutput = ListWebACLsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of WebACLSummary objects in the response.

+ */ export class ListWebACLsCommand extends $Command< ListWebACLsCommandInput, ListWebACLsCommandOutput, @@ -34,6 +45,9 @@ export class ListWebACLsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/ListXssMatchSetsCommand.ts b/clients/client-waf/commands/ListXssMatchSetsCommand.ts index 2547b250cd0ff..9118e9c7b8315 100644 --- a/clients/client-waf/commands/ListXssMatchSetsCommand.ts +++ b/clients/client-waf/commands/ListXssMatchSetsCommand.ts @@ -20,6 +20,17 @@ import { export type ListXssMatchSetsCommandInput = ListXssMatchSetsRequest; export type ListXssMatchSetsCommandOutput = ListXssMatchSetsResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Returns an array of XssMatchSet objects.

+ */ export class ListXssMatchSetsCommand extends $Command< ListXssMatchSetsCommandInput, ListXssMatchSetsCommandOutput, @@ -34,6 +45,9 @@ export class ListXssMatchSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/PutLoggingConfigurationCommand.ts b/clients/client-waf/commands/PutLoggingConfigurationCommand.ts index 4a8ea02c393fb..71e63d617d1f6 100644 --- a/clients/client-waf/commands/PutLoggingConfigurationCommand.ts +++ b/clients/client-waf/commands/PutLoggingConfigurationCommand.ts @@ -20,6 +20,34 @@ import { export type PutLoggingConfigurationCommandInput = PutLoggingConfigurationRequest; export type PutLoggingConfigurationCommandOutput = PutLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Associates a LoggingConfiguration with a specified web ACL.

+ *

You can access information about all traffic that AWS WAF inspects using the following + * steps:

+ *
    + *
  1. + *

    Create an Amazon Kinesis Data + * Firehose.

    + *

    Create the data firehose with a PUT source and in the region that you are operating. However, if you are capturing logs for Amazon CloudFront, always create the firehose in US East (N. Virginia).

    + * + *

    Do not create the data firehose using a Kinesis stream as your source.

    + *
    + *
  2. + *
  3. + *

    Associate that firehose to your web ACL using a PutLoggingConfiguration request.

    + *
  4. + *
+ * + *

When you successfully enable logging using a PutLoggingConfiguration request, AWS WAF will create a service linked role with the necessary permissions to write logs to the Amazon Kinesis Data Firehose. For more information, see Logging Web ACL Traffic Information in the AWS WAF Developer Guide.

+ */ export class PutLoggingConfigurationCommand extends $Command< PutLoggingConfigurationCommandInput, PutLoggingConfigurationCommandOutput, @@ -34,6 +62,9 @@ export class PutLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/PutPermissionPolicyCommand.ts b/clients/client-waf/commands/PutPermissionPolicyCommand.ts index 97fa4f201e0b2..edc3ea71265a3 100644 --- a/clients/client-waf/commands/PutPermissionPolicyCommand.ts +++ b/clients/client-waf/commands/PutPermissionPolicyCommand.ts @@ -20,6 +20,49 @@ import { export type PutPermissionPolicyCommandInput = PutPermissionPolicyRequest; export type PutPermissionPolicyCommandOutput = PutPermissionPolicyResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Attaches an IAM policy to the specified resource. The only supported use for this action is to share a RuleGroup across accounts.

+ *

The PutPermissionPolicy is subject to the following restrictions:

+ *
    + *
  • + *

    You can attach only one policy with each PutPermissionPolicy request.

    + *
  • + *
  • + *

    The policy must include an Effect, Action and Principal.

    + *
  • + *
  • + * + *

    + * Effect must specify Allow.

    + *
  • + *
  • + *

    The Action in the policy must be waf:UpdateWebACL, waf-regional:UpdateWebACL, waf:GetRuleGroup and waf-regional:GetRuleGroup . Any extra or wildcard actions in the policy will be rejected.

    + *
  • + *
  • + *

    The policy cannot include a Resource parameter.

    + *
  • + *
  • + *

    The ARN in the request must be a valid WAF RuleGroup ARN and the RuleGroup must exist in the same region.

    + *
  • + *
  • + *

    The user making the request must be the owner of the RuleGroup.

    + *
  • + *
  • + *

    Your policy must be composed using IAM Policy version 2012-10-17.

    + *
  • + *
+ *

For more information, see IAM Policies.

+ * + *

An example of a valid policy parameter is shown in the Examples section below.

+ */ export class PutPermissionPolicyCommand extends $Command< PutPermissionPolicyCommandInput, PutPermissionPolicyCommandOutput, @@ -34,6 +77,9 @@ export class PutPermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/TagResourceCommand.ts b/clients/client-waf/commands/TagResourceCommand.ts index e26649ebbec0e..9d759758e5e88 100644 --- a/clients/client-waf/commands/TagResourceCommand.ts +++ b/clients/client-waf/commands/TagResourceCommand.ts @@ -20,6 +20,18 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Associates tags with the specified AWS resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each AWS resource, up to 50 tags for a resource.

+ *

Tagging is only available through the API, SDKs, and CLI. You can't manage or view tags through the AWS WAF Classic console. You can use this action to tag the AWS resources that you manage through AWS WAF Classic: web ACLs, rule groups, and rules.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +46,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UntagResourceCommand.ts b/clients/client-waf/commands/UntagResourceCommand.ts index 035c56d63cac6..aaf616adf10ab 100644 --- a/clients/client-waf/commands/UntagResourceCommand.ts +++ b/clients/client-waf/commands/UntagResourceCommand.ts @@ -20,6 +20,17 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +45,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateByteMatchSetCommand.ts b/clients/client-waf/commands/UpdateByteMatchSetCommand.ts index 8183d059bbc72..c645638d6d3b9 100644 --- a/clients/client-waf/commands/UpdateByteMatchSetCommand.ts +++ b/clients/client-waf/commands/UpdateByteMatchSetCommand.ts @@ -20,6 +20,55 @@ import { export type UpdateByteMatchSetCommandInput = UpdateByteMatchSetRequest; export type UpdateByteMatchSetCommandOutput = UpdateByteMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes ByteMatchTuple objects (filters) in a ByteMatchSet. For each ByteMatchTuple object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change a ByteMatchSetUpdate object, + * you delete the existing object and add a new one.

    + *
  • + *
  • + *

    The part of a web request that you want AWS WAF to inspect, such as a query string or the value of the User-Agent header.

    + *
  • + *
  • + *

    The bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to look for. For more information, including how you specify + * the values for the AWS WAF API and the AWS CLI or SDKs, see TargetString in the ByteMatchTuple data type.

    + *
  • + *
  • + *

    Where to look, such as at the beginning or the end of a query string.

    + *
  • + *
  • + *

    Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

    + *
  • + *
+ *

For example, you can add a ByteMatchSetUpdate object that matches web requests in which User-Agent headers contain + * the string BadBot. You can then configure AWS WAF to block those requests.

+ *

To create and configure a ByteMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Create a ByteMatchSet. For more information, see CreateByteMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateByteMatchSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value that you want AWS WAF to watch for.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateByteMatchSetCommand extends $Command< UpdateByteMatchSetCommandInput, UpdateByteMatchSetCommandOutput, @@ -34,6 +83,9 @@ export class UpdateByteMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateGeoMatchSetCommand.ts b/clients/client-waf/commands/UpdateGeoMatchSetCommand.ts index b00436650a12e..667ad8d0f925c 100644 --- a/clients/client-waf/commands/UpdateGeoMatchSetCommand.ts +++ b/clients/client-waf/commands/UpdateGeoMatchSetCommand.ts @@ -20,6 +20,47 @@ import { export type UpdateGeoMatchSetCommandInput = UpdateGeoMatchSetRequest; export type UpdateGeoMatchSetCommandOutput = UpdateGeoMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes GeoMatchConstraint objects in an GeoMatchSet. For each GeoMatchConstraint object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change an GeoMatchConstraint object, you delete the existing object and add a new one.

    + *
  • + *
  • + *

    The Type. The only valid value for Type is Country.

    + *
  • + *
  • + *

    The Value, which is a two character code for the country to add to the GeoMatchConstraint object. Valid codes are listed in GeoMatchConstraint$Value.

    + *
  • + *
+ * + *

To create and configure an GeoMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Submit a CreateGeoMatchSet request.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateGeoMatchSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateGeoMatchSet request to specify the country that you want AWS WAF to watch for.

    + *
  6. + *
+ *

When you update an GeoMatchSet, you specify the country that you want to add and/or the country that you want to delete. + * If you want to change a country, you delete the existing country and add the new one.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateGeoMatchSetCommand extends $Command< UpdateGeoMatchSetCommandInput, UpdateGeoMatchSetCommandOutput, @@ -34,6 +75,9 @@ export class UpdateGeoMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateIPSetCommand.ts b/clients/client-waf/commands/UpdateIPSetCommand.ts index 29484eaa33bdb..df8ecf6326fed 100644 --- a/clients/client-waf/commands/UpdateIPSetCommand.ts +++ b/clients/client-waf/commands/UpdateIPSetCommand.ts @@ -20,6 +20,82 @@ import { export type UpdateIPSetCommandInput = UpdateIPSetRequest; export type UpdateIPSetCommandOutput = UpdateIPSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes IPSetDescriptor objects in an + * IPSet. For each IPSetDescriptor object, you specify the following + * values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change an + * IPSetDescriptor object, you delete the existing object and add a new + * one.

    + *
  • + *
  • + *

    The IP address version, IPv4 or IPv6.

    + *
  • + *
  • + *

    The IP address in CIDR notation, for example, 192.0.2.0/24 (for + * the range of IP addresses from 192.0.2.0 to 192.0.2.255) or + * 192.0.2.44/32 (for the individual IP address + * 192.0.2.44).

    + *
  • + *
+ *

AWS WAF supports IPv4 address ranges: /8 and any range between /16 through /32. AWS + * WAF supports IPv6 address ranges: /24, /32, /48, /56, /64, and /128. For more + * information about CIDR notation, see the Wikipedia entry Classless + * Inter-Domain Routing.

+ *

IPv6 addresses can be represented using any of the following formats:

+ *
    + *
  • + *

    1111:0000:0000:0000:0000:0000:0000:0111/128

    + *
  • + *
  • + *

    1111:0:0:0:0:0:0:0111/128

    + *
  • + *
  • + *

    1111::0111/128

    + *
  • + *
  • + *

    1111::111/128

    + *
  • + *
+ *

You use an IPSet to specify which web requests you want to allow or + * block based on the IP addresses that the requests originated from. For example, if you're + * receiving a lot of requests from one or a small number of IP addresses and you want to + * block the requests, you can create an IPSet that specifies those IP addresses, + * and then configure AWS WAF to block the requests.

+ *

To create and configure an IPSet, perform the following steps:

+ *
    + *
  1. + *

    Submit a CreateIPSet request.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide + * in the ChangeToken parameter of an UpdateIPSet + * request.

    + *
  4. + *
  5. + *

    Submit an UpdateIPSet request to specify the IP addresses that you + * want AWS WAF to watch for.

    + *
  6. + *
+ *

When you update an IPSet, you specify the IP addresses that you want to + * add and/or the IP addresses that you want to delete. If you want to change an IP address, + * you delete the existing IP address and add the new one.

+ *

You can insert a maximum of 1000 addresses in a single + * request.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP + * requests, see the AWS WAF + * Developer Guide.

+ */ export class UpdateIPSetCommand extends $Command< UpdateIPSetCommandInput, UpdateIPSetCommandOutput, @@ -34,6 +110,9 @@ export class UpdateIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateRateBasedRuleCommand.ts b/clients/client-waf/commands/UpdateRateBasedRuleCommand.ts index d4de9199ee179..eb84f76de711e 100644 --- a/clients/client-waf/commands/UpdateRateBasedRuleCommand.ts +++ b/clients/client-waf/commands/UpdateRateBasedRuleCommand.ts @@ -20,6 +20,63 @@ import { export type UpdateRateBasedRuleCommandInput = UpdateRateBasedRuleRequest; export type UpdateRateBasedRuleCommandOutput = UpdateRateBasedRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes Predicate objects in a rule and updates the + * RateLimit in the rule.

+ *

Each Predicate object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests + * that you want to block or count. The RateLimit specifies the number of + * requests every five minutes that triggers the rule.

+ *

If you add more than one predicate to a RateBasedRule, a request must + * match all the predicates and exceed the RateLimit to be counted or blocked. + * For example, suppose you add the following to a RateBasedRule:

+ *
    + *
  • + *

    An IPSet that matches the IP address 192.0.2.44/32 + *

    + *
  • + *
  • + *

    A ByteMatchSet that matches BadBot in the + * User-Agent header

    + *
  • + *
+ *

Further, you specify a + * RateLimit of 1,000.

+ *

You then add the RateBasedRule to a WebACL and specify that + * you want to block requests that satisfy the rule. For a request to be blocked, it must come + * from the IP address 192.0.2.44 and the User-Agent header + * in the request must contain the value BadBot. Further, requests that match + * these two conditions much be received at a rate of more than 1,000 every five minutes. If + * the rate drops below this limit, AWS WAF no longer blocks the requests.

+ * + *

As a second example, suppose you want to limit requests to a particular page on your site. To do this, you could add the following to a + * RateBasedRule:

+ * + * + *
    + *
  • + *

    A ByteMatchSet with FieldToMatch of URI + *

    + *
  • + *
  • + *

    A PositionalConstraint of STARTS_WITH + *

    + *
  • + *
  • + *

    A TargetString of login + *

    + *
  • + *
+ *

Further, you specify a RateLimit of 1,000.

+ *

By adding this RateBasedRule to a WebACL, you could limit requests to your login page without affecting the rest of your site.

+ */ export class UpdateRateBasedRuleCommand extends $Command< UpdateRateBasedRuleCommandInput, UpdateRateBasedRuleCommandOutput, @@ -34,6 +91,9 @@ export class UpdateRateBasedRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateRegexMatchSetCommand.ts b/clients/client-waf/commands/UpdateRegexMatchSetCommand.ts index 24e4cd8c6a79a..7eb555ccd0195 100644 --- a/clients/client-waf/commands/UpdateRegexMatchSetCommand.ts +++ b/clients/client-waf/commands/UpdateRegexMatchSetCommand.ts @@ -20,6 +20,51 @@ import { export type UpdateRegexMatchSetCommandInput = UpdateRegexMatchSetRequest; export type UpdateRegexMatchSetCommandOutput = UpdateRegexMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes RegexMatchTuple objects (filters) in a RegexMatchSet. For each RegexMatchSetUpdate object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change a RegexMatchSetUpdate object, + * you delete the existing object and add a new one.

    + *
  • + *
  • + *

    The part of a web request that you want AWS WAF to inspectupdate, such as a query string or the value of the User-Agent header.

    + *
  • + *
  • + *

    The identifier of the pattern (a regular expression) that you want AWS WAF to look for. For more information, see RegexPatternSet.

    + *
  • + *
  • + *

    Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.

    + *
  • + *
+ *

For example, you can create a RegexPatternSet that matches any requests with User-Agent headers + * that contain the string B[a@]dB[o0]t. You can then configure AWS WAF to reject those requests.

+ *

To create and configure a RegexMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Create a RegexMatchSet. For more information, see CreateRegexMatchSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRegexMatchSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateRegexMatchSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the identifier of the RegexPatternSet that contain the regular expression patters you want AWS WAF to watch for.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateRegexMatchSetCommand extends $Command< UpdateRegexMatchSetCommandInput, UpdateRegexMatchSetCommandOutput, @@ -34,6 +79,9 @@ export class UpdateRegexMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateRegexPatternSetCommand.ts b/clients/client-waf/commands/UpdateRegexPatternSetCommand.ts index 8e50a7e706be2..719d9c8b70af1 100644 --- a/clients/client-waf/commands/UpdateRegexPatternSetCommand.ts +++ b/clients/client-waf/commands/UpdateRegexPatternSetCommand.ts @@ -20,6 +20,56 @@ import { export type UpdateRegexPatternSetCommandInput = UpdateRegexPatternSetRequest; export type UpdateRegexPatternSetCommandOutput = UpdateRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes RegexPatternString objects in a RegexPatternSet. For each RegexPatternString object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the RegexPatternString.

    + *
  • + *
  • + *

    The regular expression pattern that you want to insert or delete. For more information, see RegexPatternSet.

    + *
  • + *
+ *

For example, you can create a RegexPatternString such as B[a@]dB[o0]t. AWS WAF will match this RegexPatternString to:

+ *
    + *
  • + *

    BadBot

    + *
  • + *
  • + *

    BadB0t

    + *
  • + *
  • + *

    B@dBot

    + *
  • + *
  • + *

    B@dB0t

    + *
  • + *
+ *

To create and configure a RegexPatternSet, perform the following steps:

+ *
    + *
  1. + *

    Create a RegexPatternSet. For more information, see CreateRegexPatternSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRegexPatternSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateRegexPatternSet request to specify the regular expression pattern that you want AWS WAF to watch for.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateRegexPatternSetCommand extends $Command< UpdateRegexPatternSetCommandInput, UpdateRegexPatternSetCommandOutput, @@ -34,6 +84,9 @@ export class UpdateRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateRuleCommand.ts b/clients/client-waf/commands/UpdateRuleCommand.ts index cfc6ce8415733..fca994953e158 100644 --- a/clients/client-waf/commands/UpdateRuleCommand.ts +++ b/clients/client-waf/commands/UpdateRuleCommand.ts @@ -20,6 +20,58 @@ import { export type UpdateRuleCommandInput = UpdateRuleRequest; export type UpdateRuleCommandOutput = UpdateRuleResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes Predicate objects in a Rule. Each + * Predicate object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests + * that you want to allow, block, or count. If you add more than one predicate to a + * Rule, a request must match all of the specifications to be allowed, + * blocked, or counted. For example, suppose + * that + * you add the following to a Rule:

+ *
    + *
  • + *

    A ByteMatchSet that matches the value BadBot in the User-Agent header

    + *
  • + *
  • + *

    An IPSet that matches the IP address 192.0.2.44 + *

    + *
  • + *
+ *

You then add the Rule to a WebACL and specify that you want to block requests that satisfy the Rule. + * For a request to be blocked, the User-Agent header in the request must contain the value BadBot + * and the request must originate from the IP address 192.0.2.44.

+ *

To create and configure a Rule, perform the following steps:

+ *
    + *
  1. + *

    Create and update the predicates that you want to include in the Rule.

    + *
  2. + *
  3. + *

    Create the Rule. See CreateRule.

    + *
  4. + *
  5. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRule request.

    + *
  6. + *
  7. + *

    Submit an UpdateRule request to add predicates to the Rule.

    + *
  8. + *
  9. + *

    Create and update a WebACL that contains the Rule. See CreateWebACL.

    + *
  10. + *
+ *

If you want to replace one ByteMatchSet or IPSet with another, you delete the existing one and + * add the new one.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateRuleCommand extends $Command< UpdateRuleCommandInput, UpdateRuleCommandOutput, @@ -34,6 +86,9 @@ export class UpdateRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateRuleGroupCommand.ts b/clients/client-waf/commands/UpdateRuleGroupCommand.ts index 968fce9106704..70ee9e5ea1ba2 100644 --- a/clients/client-waf/commands/UpdateRuleGroupCommand.ts +++ b/clients/client-waf/commands/UpdateRuleGroupCommand.ts @@ -20,6 +20,41 @@ import { export type UpdateRuleGroupCommandInput = UpdateRuleGroupRequest; export type UpdateRuleGroupCommandOutput = UpdateRuleGroupResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes ActivatedRule objects in a RuleGroup.

+ *

You can only insert REGULAR rules into a rule group.

+ *

You can have a maximum of ten rules per rule group.

+ * + * + *

To create and configure a RuleGroup, perform the following steps:

+ *
    + *
  1. + *

    Create and update the Rules that you want to include in the RuleGroup. See CreateRule.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateRuleGroup request.

    + *
  4. + *
  5. + *

    Submit an UpdateRuleGroup request to add Rules to the RuleGroup.

    + *
  6. + *
  7. + *

    Create and update a WebACL that contains the RuleGroup. See CreateWebACL.

    + *
  8. + *
+ *

If you want to replace one Rule with another, you delete the existing one and + * add the new one.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateRuleGroupCommand extends $Command< UpdateRuleGroupCommandInput, UpdateRuleGroupCommandOutput, @@ -34,6 +69,9 @@ export class UpdateRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateSizeConstraintSetCommand.ts b/clients/client-waf/commands/UpdateSizeConstraintSetCommand.ts index 3af301c904770..75268a1735d24 100644 --- a/clients/client-waf/commands/UpdateSizeConstraintSetCommand.ts +++ b/clients/client-waf/commands/UpdateSizeConstraintSetCommand.ts @@ -20,6 +20,59 @@ import { export type UpdateSizeConstraintSetCommandInput = UpdateSizeConstraintSetRequest; export type UpdateSizeConstraintSetCommandOutput = UpdateSizeConstraintSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes SizeConstraint objects (filters) in a SizeConstraintSet. For each SizeConstraint object, + * you specify the following values:

+ *
    + *
  • + *

    Whether to insert or delete the object from the array. If you want to change a SizeConstraintSetUpdate object, + * you delete the existing object and add a new one.

    + *
  • + *
  • + *

    The part of a web request that you want AWS WAF to evaluate, such as the length of a query string or the length of the + * User-Agent header.

    + *
  • + *
  • + *

    Whether to perform any transformations on the request, such as converting it to lowercase, before checking its length. + * Note that transformations of the request body are not supported because the AWS resource forwards only the first 8192 bytes + * of your request to AWS WAF.

    + *

    You can only specify a single type of TextTransformation.

    + *
  • + *
  • + *

    A ComparisonOperator used for evaluating the selected part of the request against the specified Size, such as + * equals, greater than, less than, and so on.

    + *
  • + *
  • + *

    The length, in bytes, that you want AWS WAF to watch for in selected part of the request. The length is computed after applying the transformation.

    + *
  • + *
+ *

For example, you can add a SizeConstraintSetUpdate object that matches web requests in which the length of the + * User-Agent header is greater than 100 bytes. You can then configure AWS WAF to block those requests.

+ *

To create and configure a SizeConstraintSet, perform the following steps:

+ *
    + *
  1. + *

    Create a SizeConstraintSet. For more information, see CreateSizeConstraintSet.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateSizeConstraintSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect + * (for example, the header or the URI) and the value that you want AWS WAF to watch for.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateSizeConstraintSetCommand extends $Command< UpdateSizeConstraintSetCommandInput, UpdateSizeConstraintSetCommandOutput, @@ -34,6 +87,9 @@ export class UpdateSizeConstraintSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateSqlInjectionMatchSetCommand.ts b/clients/client-waf/commands/UpdateSqlInjectionMatchSetCommand.ts index 8b8c609e6a8c9..3480bd96b5361 100644 --- a/clients/client-waf/commands/UpdateSqlInjectionMatchSetCommand.ts +++ b/clients/client-waf/commands/UpdateSqlInjectionMatchSetCommand.ts @@ -20,6 +20,58 @@ import { export type UpdateSqlInjectionMatchSetCommandInput = UpdateSqlInjectionMatchSetRequest; export type UpdateSqlInjectionMatchSetCommandOutput = UpdateSqlInjectionMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes SqlInjectionMatchTuple objects (filters) in a SqlInjectionMatchSet. + * For each SqlInjectionMatchTuple object, you specify the following values:

+ *
    + *
  • + *

    + * Action: Whether to insert the object into or delete the object from the array. To change a + * SqlInjectionMatchTuple, you delete the existing object and add a new one.

    + *
  • + *
  • + *

    + * FieldToMatch: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header or custom query parameter, + * the name of the header or parameter.

    + *
  • + *
  • + *

    + * TextTransformation: Which text transformation, if any, to perform on the web request before + * inspecting the request for snippets of malicious SQL code.

    + *

    You can only specify a single type of TextTransformation.

    + *
  • + *
+ *

You use SqlInjectionMatchSet objects to specify which CloudFront + * requests that + * you want to allow, block, or count. For example, if you're receiving + * requests that contain snippets of SQL code in the query string and you want to block the + * requests, you can create a SqlInjectionMatchSet with the applicable settings, + * and then configure AWS WAF to block the requests.

+ *

To create and configure a SqlInjectionMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Submit a CreateSqlInjectionMatchSet request.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateIPSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests that you want AWS WAF to + * inspect for snippets of SQL code.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateSqlInjectionMatchSetCommand extends $Command< UpdateSqlInjectionMatchSetCommandInput, UpdateSqlInjectionMatchSetCommandOutput, @@ -34,6 +86,9 @@ export class UpdateSqlInjectionMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateWebACLCommand.ts b/clients/client-waf/commands/UpdateWebACLCommand.ts index de42e49b1d8d6..ea4b268ab8d73 100644 --- a/clients/client-waf/commands/UpdateWebACLCommand.ts +++ b/clients/client-waf/commands/UpdateWebACLCommand.ts @@ -20,6 +20,88 @@ import { export type UpdateWebACLCommandInput = UpdateWebACLRequest; export type UpdateWebACLCommandOutput = UpdateWebACLResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes ActivatedRule objects in a WebACL. Each Rule identifies + * web requests that you want to allow, block, or count. When you update a WebACL, you specify the following values:

+ *
    + *
  • + *

    A default action for the WebACL, either ALLOW or BLOCK. + * AWS WAF performs the default action if a request doesn't match the criteria in any of the Rules in a WebACL.

    + *
  • + *
  • + *

    The Rules that you want to add + * or + * delete. If you want to replace one Rule with another, you delete the + * existing Rule and add the new one.

    + *
  • + *
  • + *

    For each Rule, whether you want AWS WAF to allow requests, block requests, or count requests that match + * the conditions in the Rule.

    + *
  • + *
  • + *

    The order in which you want AWS WAF to evaluate the Rules in a + * WebACL. If you add more than one Rule to a + * WebACL, AWS WAF evaluates each request against the Rules + * in order based on the value of Priority. (The Rule that has + * the lowest value for Priority is evaluated first.) When a web request + * matches all + * the + * predicates (such as ByteMatchSets and IPSets) in a + * Rule, AWS WAF immediately takes the corresponding action, allow or + * block, and doesn't evaluate the request against the remaining Rules in + * the WebACL, if any.

    + *
  • + *
+ * + *

To create and configure a WebACL, perform the following steps:

+ *
    + *
  1. + *

    Create and update the predicates that you want to include in Rules. + * For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, + * CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.

    + *
  2. + *
  3. + *

    Create and update the Rules that you want to include in the WebACL. For more information, see + * CreateRule and UpdateRule.

    + *
  4. + *
  5. + *

    Create a WebACL. See CreateWebACL.

    + *
  6. + *
  7. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateWebACL request.

    + *
  8. + *
  9. + *

    Submit an UpdateWebACL request to specify the Rules + * that you want to include in the WebACL, to specify the default action, + * and to associate the WebACL with a CloudFront distribution.

    + *

    The ActivatedRule can be a rule group. If you specify a rule group + * as your + * ActivatedRule + * , + * you can exclude specific rules from that rule group.

    + *

    If you already have a rule group associated with a web ACL and want to submit + * an UpdateWebACL request to exclude certain rules from that rule group, + * you must first remove the rule group from the web ACL, the re-insert it again, + * specifying the excluded rules. + * For details, + * see + * ActivatedRule$ExcludedRules + * . + *

    + *
  10. + *
+ *

Be aware that if you try to add a RATE_BASED rule to a web ACL without setting the rule type when first creating the rule, the UpdateWebACL request will fail because the request tries to add a REGULAR rule (the default rule type) with the specified ID, which does not exist.

+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.

+ */ export class UpdateWebACLCommand extends $Command< UpdateWebACLCommandInput, UpdateWebACLCommandOutput, @@ -34,6 +116,9 @@ export class UpdateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/commands/UpdateXssMatchSetCommand.ts b/clients/client-waf/commands/UpdateXssMatchSetCommand.ts index 72c0825a39bb5..fbc7014521d11 100644 --- a/clients/client-waf/commands/UpdateXssMatchSetCommand.ts +++ b/clients/client-waf/commands/UpdateXssMatchSetCommand.ts @@ -20,6 +20,60 @@ import { export type UpdateXssMatchSetCommandInput = UpdateXssMatchSetRequest; export type UpdateXssMatchSetCommandOutput = UpdateXssMatchSetResponse & __MetadataBearer; +/** + * + *

This is AWS WAF Classic documentation. For + * more information, see AWS + * WAF Classic in the developer guide.

+ *

+ * For the latest version of AWS + * WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

+ *
+ *

Inserts or deletes XssMatchTuple objects (filters) in an XssMatchSet. + * For each XssMatchTuple object, you specify the following values:

+ *
    + *
  • + *

    + * Action: Whether to insert the object into or delete the object from the + * array. To change an + * XssMatchTuple, you delete the existing object and add a new + * one.

    + *
  • + *
  • + *

    + * FieldToMatch: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header or custom query parameter, + * the name of the header or parameter.

    + *
  • + *
  • + *

    + * TextTransformation: Which text transformation, if any, to perform on the web request before + * inspecting the request for cross-site scripting attacks.

    + *

    You can only specify a single type of TextTransformation.

    + *
  • + *
+ *

You use XssMatchSet objects to specify which CloudFront requests + * that + * you want to allow, block, or count. For example, if you're receiving + * requests that contain cross-site scripting attacks in the request body and you want to + * block the requests, you can create an XssMatchSet with the applicable + * settings, and then configure AWS WAF to block the requests.

+ *

To create and configure an XssMatchSet, perform the following steps:

+ *
    + *
  1. + *

    Submit a CreateXssMatchSet request.

    + *
  2. + *
  3. + *

    Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of an + * UpdateIPSet request.

    + *
  4. + *
  5. + *

    Submit an UpdateXssMatchSet request to specify the parts of web requests that you want AWS WAF to + * inspect for cross-site scripting attacks.

    + *
  6. + *
+ *

For more information about how to use the AWS WAF API to allow or block HTTP requests, see the + * AWS WAF Developer Guide.

+ */ export class UpdateXssMatchSetCommand extends $Command< UpdateXssMatchSetCommandInput, UpdateXssMatchSetCommandOutput, @@ -34,6 +88,9 @@ export class UpdateXssMatchSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFClientResolvedConfig, diff --git a/clients/client-waf/package.json b/clients/client-waf/package.json index b04b807e2be13..b37537f52da66 100644 --- a/clients/client-waf/package.json +++ b/clients/client-waf/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Waf Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-waf/runtimeConfig.browser.ts b/clients/client-waf/runtimeConfig.browser.ts index 735e3f3cc33d6..196c31645ed47 100644 --- a/clients/client-waf/runtimeConfig.browser.ts +++ b/clients/client-waf/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./WAFClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-waf/runtimeConfig.native.ts b/clients/client-waf/runtimeConfig.native.ts index 4c62e3a0979d0..1f15f0fbe641a 100644 --- a/clients/client-waf/runtimeConfig.native.ts +++ b/clients/client-waf/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./WAFClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-waf/runtimeConfig.shared.ts b/clients/client-waf/runtimeConfig.shared.ts index 9bbe3805df253..56db61c42196e 100644 --- a/clients/client-waf/runtimeConfig.shared.ts +++ b/clients/client-waf/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-08-24", disableHostPrefix: false, diff --git a/clients/client-waf/runtimeConfig.ts b/clients/client-waf/runtimeConfig.ts index fef3351cbc2df..2d058499eb910 100644 --- a/clients/client-waf/runtimeConfig.ts +++ b/clients/client-waf/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./WAFClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-waf/tsconfig.json b/clients/client-waf/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-waf/tsconfig.json +++ b/clients/client-waf/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-wafv2/commands/AssociateWebACLCommand.ts b/clients/client-wafv2/commands/AssociateWebACLCommand.ts index bb52554757b95..a576c1dfacb9d 100644 --- a/clients/client-wafv2/commands/AssociateWebACLCommand.ts +++ b/clients/client-wafv2/commands/AssociateWebACLCommand.ts @@ -20,6 +20,13 @@ import { export type AssociateWebACLCommandInput = AssociateWebACLRequest; export type AssociateWebACLCommandOutput = AssociateWebACLResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Associates a Web ACL with a regional application resource, to protect the resource. A regional application can be an Application Load Balancer (ALB), an API Gateway REST API, or an AppSync GraphQL API.

+ *

For AWS CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To associate a Web ACL, in the CloudFront call UpdateDistribution, set the web ACL ID to the Amazon Resource Name (ARN) of the Web ACL. For information, see UpdateDistribution.

+ */ export class AssociateWebACLCommand extends $Command< AssociateWebACLCommandInput, AssociateWebACLCommandOutput, @@ -34,6 +41,9 @@ export class AssociateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/CheckCapacityCommand.ts b/clients/client-wafv2/commands/CheckCapacityCommand.ts index ad6d1ad3fdcb3..139cd0a7b1e42 100644 --- a/clients/client-wafv2/commands/CheckCapacityCommand.ts +++ b/clients/client-wafv2/commands/CheckCapacityCommand.ts @@ -20,6 +20,23 @@ import { export type CheckCapacityCommandInput = CheckCapacityRequest; export type CheckCapacityCommandOutput = CheckCapacityResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Returns the web ACL capacity unit (WCU) requirements for a specified scope and set of rules. + * You can use this to check the capacity requirements for the rules you want to use in a + * RuleGroup or WebACL. + *

+ *

AWS WAF uses WCUs to calculate and control the operating + * resources that are used to run your rules, rule groups, and web ACLs. AWS WAF + * calculates capacity differently for each rule type, to reflect the relative cost of each rule. + * Simple rules that cost little to run use fewer WCUs than more complex rules + * that use more processing power. + * Rule group capacity is fixed at creation, which helps users plan their + * web ACL WCU usage when they use a rule group. + * The WCU limit for web ACLs is 1,500.

+ */ export class CheckCapacityCommand extends $Command< CheckCapacityCommandInput, CheckCapacityCommandOutput, @@ -34,6 +51,9 @@ export class CheckCapacityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/CreateIPSetCommand.ts b/clients/client-wafv2/commands/CreateIPSetCommand.ts index c27f367d09314..f095c3503f5b0 100644 --- a/clients/client-wafv2/commands/CreateIPSetCommand.ts +++ b/clients/client-wafv2/commands/CreateIPSetCommand.ts @@ -20,6 +20,12 @@ import { export type CreateIPSetCommandInput = CreateIPSetRequest; export type CreateIPSetCommandOutput = CreateIPSetResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Creates an IPSet, which you use to identify web requests that originate from specific IP addresses or ranges of IP addresses. For example, if you're receiving a lot of requests from a ranges of IP addresses, you can configure AWS WAF to block them using an IPSet that lists those IP addresses.

+ */ export class CreateIPSetCommand extends $Command< CreateIPSetCommandInput, CreateIPSetCommandOutput, @@ -34,6 +40,9 @@ export class CreateIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/CreateRegexPatternSetCommand.ts b/clients/client-wafv2/commands/CreateRegexPatternSetCommand.ts index f5afcf2c73897..5e26222cac370 100644 --- a/clients/client-wafv2/commands/CreateRegexPatternSetCommand.ts +++ b/clients/client-wafv2/commands/CreateRegexPatternSetCommand.ts @@ -20,6 +20,12 @@ import { export type CreateRegexPatternSetCommandInput = CreateRegexPatternSetRequest; export type CreateRegexPatternSetCommandOutput = CreateRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Creates a RegexPatternSet, which you reference in a RegexPatternSetReferenceStatement, to have AWS WAF inspect a web request component for the specified patterns.

+ */ export class CreateRegexPatternSetCommand extends $Command< CreateRegexPatternSetCommandInput, CreateRegexPatternSetCommandOutput, @@ -34,6 +40,9 @@ export class CreateRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/CreateRuleGroupCommand.ts b/clients/client-wafv2/commands/CreateRuleGroupCommand.ts index 686164de66c85..4bde67b1e4699 100644 --- a/clients/client-wafv2/commands/CreateRuleGroupCommand.ts +++ b/clients/client-wafv2/commands/CreateRuleGroupCommand.ts @@ -20,6 +20,13 @@ import { export type CreateRuleGroupCommandInput = CreateRuleGroupRequest; export type CreateRuleGroupCommandOutput = CreateRuleGroupResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Creates a RuleGroup per the specifications provided.

+ *

A rule group defines a collection of rules to inspect and control web requests that you can use in a WebACL. When you create a rule group, you define an immutable capacity limit. If you update a rule group, you must stay within the capacity. This allows others to reuse the rule group with confidence in its capacity requirements.

+ */ export class CreateRuleGroupCommand extends $Command< CreateRuleGroupCommandInput, CreateRuleGroupCommandOutput, @@ -34,6 +41,9 @@ export class CreateRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/CreateWebACLCommand.ts b/clients/client-wafv2/commands/CreateWebACLCommand.ts index 659bf16f98c43..cbc8a1de0a1d9 100644 --- a/clients/client-wafv2/commands/CreateWebACLCommand.ts +++ b/clients/client-wafv2/commands/CreateWebACLCommand.ts @@ -20,6 +20,13 @@ import { export type CreateWebACLCommandInput = CreateWebACLRequest; export type CreateWebACLCommandOutput = CreateWebACLResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Creates a WebACL per the specifications provided.

+ *

A Web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the Web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a Web ACL can be a combination of the types Rule, RuleGroup, and managed rule group. You can associate a Web ACL with one or more AWS resources to protect. The resources can be Amazon CloudFront, an Amazon API Gateway REST API, an Application Load Balancer, or an AWS AppSync GraphQL API.

+ */ export class CreateWebACLCommand extends $Command< CreateWebACLCommandInput, CreateWebACLCommandOutput, @@ -34,6 +41,9 @@ export class CreateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DeleteFirewallManagerRuleGroupsCommand.ts b/clients/client-wafv2/commands/DeleteFirewallManagerRuleGroupsCommand.ts index 23b0658fa1e7c..b9736470e879d 100644 --- a/clients/client-wafv2/commands/DeleteFirewallManagerRuleGroupsCommand.ts +++ b/clients/client-wafv2/commands/DeleteFirewallManagerRuleGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteFirewallManagerRuleGroupsCommandInput = DeleteFirewallManagerRuleGroupsRequest; export type DeleteFirewallManagerRuleGroupsCommandOutput = DeleteFirewallManagerRuleGroupsResponse & __MetadataBearer; +/** + *

Deletes all rule groups that are managed by AWS Firewall Manager for the specified web ACL.

+ *

You can only use this if ManagedByFirewallManager is false in the specified WebACL.

+ */ export class DeleteFirewallManagerRuleGroupsCommand extends $Command< DeleteFirewallManagerRuleGroupsCommandInput, DeleteFirewallManagerRuleGroupsCommandOutput, @@ -34,6 +38,9 @@ export class DeleteFirewallManagerRuleGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DeleteIPSetCommand.ts b/clients/client-wafv2/commands/DeleteIPSetCommand.ts index 749e755436a12..c6af3b629cd67 100644 --- a/clients/client-wafv2/commands/DeleteIPSetCommand.ts +++ b/clients/client-wafv2/commands/DeleteIPSetCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteIPSetCommandInput = DeleteIPSetRequest; export type DeleteIPSetCommandOutput = DeleteIPSetResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Deletes the specified IPSet.

+ */ export class DeleteIPSetCommand extends $Command< DeleteIPSetCommandInput, DeleteIPSetCommandOutput, @@ -34,6 +40,9 @@ export class DeleteIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DeleteLoggingConfigurationCommand.ts b/clients/client-wafv2/commands/DeleteLoggingConfigurationCommand.ts index 792311a6952f7..35d2a7dba7bc9 100644 --- a/clients/client-wafv2/commands/DeleteLoggingConfigurationCommand.ts +++ b/clients/client-wafv2/commands/DeleteLoggingConfigurationCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteLoggingConfigurationCommandInput = DeleteLoggingConfigurationRequest; export type DeleteLoggingConfigurationCommandOutput = DeleteLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Deletes the LoggingConfiguration from the specified web + * ACL.

+ */ export class DeleteLoggingConfigurationCommand extends $Command< DeleteLoggingConfigurationCommandInput, DeleteLoggingConfigurationCommandOutput, @@ -34,6 +41,9 @@ export class DeleteLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DeletePermissionPolicyCommand.ts b/clients/client-wafv2/commands/DeletePermissionPolicyCommand.ts index 75f2a31d217cc..cf216f42c45a3 100644 --- a/clients/client-wafv2/commands/DeletePermissionPolicyCommand.ts +++ b/clients/client-wafv2/commands/DeletePermissionPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type DeletePermissionPolicyCommandInput = DeletePermissionPolicyRequest; export type DeletePermissionPolicyCommandOutput = DeletePermissionPolicyResponse & __MetadataBearer; +/** + *

Permanently deletes an IAM policy from the specified rule group.

+ *

You must be the owner of the rule group to perform this operation.

+ */ export class DeletePermissionPolicyCommand extends $Command< DeletePermissionPolicyCommandInput, DeletePermissionPolicyCommandOutput, @@ -34,6 +38,9 @@ export class DeletePermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DeleteRegexPatternSetCommand.ts b/clients/client-wafv2/commands/DeleteRegexPatternSetCommand.ts index ba1d5de904e25..94d9d8e8afa97 100644 --- a/clients/client-wafv2/commands/DeleteRegexPatternSetCommand.ts +++ b/clients/client-wafv2/commands/DeleteRegexPatternSetCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteRegexPatternSetCommandInput = DeleteRegexPatternSetRequest; export type DeleteRegexPatternSetCommandOutput = DeleteRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Deletes the specified RegexPatternSet.

+ */ export class DeleteRegexPatternSetCommand extends $Command< DeleteRegexPatternSetCommandInput, DeleteRegexPatternSetCommandOutput, @@ -34,6 +40,9 @@ export class DeleteRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DeleteRuleGroupCommand.ts b/clients/client-wafv2/commands/DeleteRuleGroupCommand.ts index 87edde1d8196a..6bdf177f5cb69 100644 --- a/clients/client-wafv2/commands/DeleteRuleGroupCommand.ts +++ b/clients/client-wafv2/commands/DeleteRuleGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DeleteRuleGroupCommandInput = DeleteRuleGroupRequest; export type DeleteRuleGroupCommandOutput = DeleteRuleGroupResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Deletes the specified RuleGroup.

+ */ export class DeleteRuleGroupCommand extends $Command< DeleteRuleGroupCommandInput, DeleteRuleGroupCommandOutput, @@ -34,6 +40,9 @@ export class DeleteRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DeleteWebACLCommand.ts b/clients/client-wafv2/commands/DeleteWebACLCommand.ts index a53c7413bb7d2..ee6167c32a759 100644 --- a/clients/client-wafv2/commands/DeleteWebACLCommand.ts +++ b/clients/client-wafv2/commands/DeleteWebACLCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteWebACLCommandInput = DeleteWebACLRequest; export type DeleteWebACLCommandOutput = DeleteWebACLResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Deletes the specified WebACL.

+ *

You can only use this if ManagedByFirewallManager is false in the specified WebACL.

+ */ export class DeleteWebACLCommand extends $Command< DeleteWebACLCommandInput, DeleteWebACLCommandOutput, @@ -34,6 +41,9 @@ export class DeleteWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DescribeManagedRuleGroupCommand.ts b/clients/client-wafv2/commands/DescribeManagedRuleGroupCommand.ts index 3dfa57ac620db..58da409474b97 100644 --- a/clients/client-wafv2/commands/DescribeManagedRuleGroupCommand.ts +++ b/clients/client-wafv2/commands/DescribeManagedRuleGroupCommand.ts @@ -20,6 +20,12 @@ import { export type DescribeManagedRuleGroupCommandInput = DescribeManagedRuleGroupRequest; export type DescribeManagedRuleGroupCommandOutput = DescribeManagedRuleGroupResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Provides high-level information for a managed rule group, including descriptions of the rules.

+ */ export class DescribeManagedRuleGroupCommand extends $Command< DescribeManagedRuleGroupCommandInput, DescribeManagedRuleGroupCommandOutput, @@ -34,6 +40,9 @@ export class DescribeManagedRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/DisassociateWebACLCommand.ts b/clients/client-wafv2/commands/DisassociateWebACLCommand.ts index fa26d6f721797..4bfe654f70fe8 100644 --- a/clients/client-wafv2/commands/DisassociateWebACLCommand.ts +++ b/clients/client-wafv2/commands/DisassociateWebACLCommand.ts @@ -20,6 +20,13 @@ import { export type DisassociateWebACLCommandInput = DisassociateWebACLRequest; export type DisassociateWebACLCommandOutput = DisassociateWebACLResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Disassociates a Web ACL from a regional application resource. A regional application can be an Application Load Balancer (ALB), an API Gateway REST API, or an AppSync GraphQL API.

+ *

For AWS CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To disassociate a Web ACL, provide an empty web ACL ID in the CloudFront call UpdateDistribution. For information, see UpdateDistribution.

+ */ export class DisassociateWebACLCommand extends $Command< DisassociateWebACLCommandInput, DisassociateWebACLCommandOutput, @@ -34,6 +41,9 @@ export class DisassociateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetIPSetCommand.ts b/clients/client-wafv2/commands/GetIPSetCommand.ts index 3eebfbcfa22ac..b024adc038bb1 100644 --- a/clients/client-wafv2/commands/GetIPSetCommand.ts +++ b/clients/client-wafv2/commands/GetIPSetCommand.ts @@ -17,6 +17,12 @@ import { export type GetIPSetCommandInput = GetIPSetRequest; export type GetIPSetCommandOutput = GetIPSetResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves the specified IPSet.

+ */ export class GetIPSetCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -27,6 +33,9 @@ export class GetIPSetCommand extends $Command, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetLoggingConfigurationCommand.ts b/clients/client-wafv2/commands/GetLoggingConfigurationCommand.ts index af79f3880fec9..4d3ce5ca4a220 100644 --- a/clients/client-wafv2/commands/GetLoggingConfigurationCommand.ts +++ b/clients/client-wafv2/commands/GetLoggingConfigurationCommand.ts @@ -20,6 +20,12 @@ import { export type GetLoggingConfigurationCommandInput = GetLoggingConfigurationRequest; export type GetLoggingConfigurationCommandOutput = GetLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Returns the LoggingConfiguration for the specified web ACL.

+ */ export class GetLoggingConfigurationCommand extends $Command< GetLoggingConfigurationCommandInput, GetLoggingConfigurationCommandOutput, @@ -34,6 +40,9 @@ export class GetLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetPermissionPolicyCommand.ts b/clients/client-wafv2/commands/GetPermissionPolicyCommand.ts index 65133998893f0..d0251a8d435dc 100644 --- a/clients/client-wafv2/commands/GetPermissionPolicyCommand.ts +++ b/clients/client-wafv2/commands/GetPermissionPolicyCommand.ts @@ -20,6 +20,10 @@ import { export type GetPermissionPolicyCommandInput = GetPermissionPolicyRequest; export type GetPermissionPolicyCommandOutput = GetPermissionPolicyResponse & __MetadataBearer; +/** + *

Returns the IAM policy that is attached to the specified rule group.

+ *

You must be the owner of the rule group to perform this operation.

+ */ export class GetPermissionPolicyCommand extends $Command< GetPermissionPolicyCommandInput, GetPermissionPolicyCommandOutput, @@ -34,6 +38,9 @@ export class GetPermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetRateBasedStatementManagedKeysCommand.ts b/clients/client-wafv2/commands/GetRateBasedStatementManagedKeysCommand.ts index 97d08ad37b753..f9a8e83934310 100644 --- a/clients/client-wafv2/commands/GetRateBasedStatementManagedKeysCommand.ts +++ b/clients/client-wafv2/commands/GetRateBasedStatementManagedKeysCommand.ts @@ -20,6 +20,12 @@ import { export type GetRateBasedStatementManagedKeysCommandInput = GetRateBasedStatementManagedKeysRequest; export type GetRateBasedStatementManagedKeysCommandOutput = GetRateBasedStatementManagedKeysResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves the keys that are currently blocked by a rate-based rule. The maximum number of managed keys that can be blocked for a single rate-based rule is 10,000. If more than 10,000 addresses exceed the rate limit, those with the highest rates are blocked.

+ */ export class GetRateBasedStatementManagedKeysCommand extends $Command< GetRateBasedStatementManagedKeysCommandInput, GetRateBasedStatementManagedKeysCommandOutput, @@ -34,6 +40,9 @@ export class GetRateBasedStatementManagedKeysCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetRegexPatternSetCommand.ts b/clients/client-wafv2/commands/GetRegexPatternSetCommand.ts index aebeb94c24c5d..0087b6334fec3 100644 --- a/clients/client-wafv2/commands/GetRegexPatternSetCommand.ts +++ b/clients/client-wafv2/commands/GetRegexPatternSetCommand.ts @@ -20,6 +20,12 @@ import { export type GetRegexPatternSetCommandInput = GetRegexPatternSetRequest; export type GetRegexPatternSetCommandOutput = GetRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves the specified RegexPatternSet.

+ */ export class GetRegexPatternSetCommand extends $Command< GetRegexPatternSetCommandInput, GetRegexPatternSetCommandOutput, @@ -34,6 +40,9 @@ export class GetRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetRuleGroupCommand.ts b/clients/client-wafv2/commands/GetRuleGroupCommand.ts index 13acf78d43a14..5a482c2b9646b 100644 --- a/clients/client-wafv2/commands/GetRuleGroupCommand.ts +++ b/clients/client-wafv2/commands/GetRuleGroupCommand.ts @@ -20,6 +20,12 @@ import { export type GetRuleGroupCommandInput = GetRuleGroupRequest; export type GetRuleGroupCommandOutput = GetRuleGroupResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves the specified RuleGroup.

+ */ export class GetRuleGroupCommand extends $Command< GetRuleGroupCommandInput, GetRuleGroupCommandOutput, @@ -34,6 +40,9 @@ export class GetRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetSampledRequestsCommand.ts b/clients/client-wafv2/commands/GetSampledRequestsCommand.ts index 3c108d0230a30..20a39f5a8a51b 100644 --- a/clients/client-wafv2/commands/GetSampledRequestsCommand.ts +++ b/clients/client-wafv2/commands/GetSampledRequestsCommand.ts @@ -20,6 +20,16 @@ import { export type GetSampledRequestsCommandInput = GetSampledRequestsRequest; export type GetSampledRequestsCommandOutput = GetSampledRequestsResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Gets detailed information about a specified number of requests--a sample--that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received during a time range that you choose. You can specify a sample size of up to 500 requests, and you can specify any time range in the previous three hours.

+ *

+ * GetSampledRequests returns a time range, which is usually the time range that you specified. However, if your resource + * (such as a CloudFront distribution) received 5,000 requests before the specified time range elapsed, GetSampledRequests + * returns an updated time range. This new time range indicates the actual period during which AWS WAF selected the requests in the sample.

+ */ export class GetSampledRequestsCommand extends $Command< GetSampledRequestsCommandInput, GetSampledRequestsCommandOutput, @@ -34,6 +44,9 @@ export class GetSampledRequestsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetWebACLCommand.ts b/clients/client-wafv2/commands/GetWebACLCommand.ts index df995a99528ea..f24652a5c5ef1 100644 --- a/clients/client-wafv2/commands/GetWebACLCommand.ts +++ b/clients/client-wafv2/commands/GetWebACLCommand.ts @@ -17,6 +17,12 @@ import { export type GetWebACLCommandInput = GetWebACLRequest; export type GetWebACLCommandOutput = GetWebACLResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves the specified WebACL.

+ */ export class GetWebACLCommand extends $Command< GetWebACLCommandInput, GetWebACLCommandOutput, @@ -31,6 +37,9 @@ export class GetWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/GetWebACLForResourceCommand.ts b/clients/client-wafv2/commands/GetWebACLForResourceCommand.ts index 3f47c477b1186..ed7d95252aea8 100644 --- a/clients/client-wafv2/commands/GetWebACLForResourceCommand.ts +++ b/clients/client-wafv2/commands/GetWebACLForResourceCommand.ts @@ -20,6 +20,12 @@ import { export type GetWebACLForResourceCommandInput = GetWebACLForResourceRequest; export type GetWebACLForResourceCommandOutput = GetWebACLForResourceResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves the WebACL for the specified resource.

+ */ export class GetWebACLForResourceCommand extends $Command< GetWebACLForResourceCommandInput, GetWebACLForResourceCommandOutput, @@ -34,6 +40,9 @@ export class GetWebACLForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/ListAvailableManagedRuleGroupsCommand.ts b/clients/client-wafv2/commands/ListAvailableManagedRuleGroupsCommand.ts index 72248e3e39044..5cacb36eae255 100644 --- a/clients/client-wafv2/commands/ListAvailableManagedRuleGroupsCommand.ts +++ b/clients/client-wafv2/commands/ListAvailableManagedRuleGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type ListAvailableManagedRuleGroupsCommandInput = ListAvailableManagedRuleGroupsRequest; export type ListAvailableManagedRuleGroupsCommandOutput = ListAvailableManagedRuleGroupsResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves an array of managed rule groups that are available for you to use. This list includes all AWS Managed Rules rule groups and the AWS Marketplace managed rule groups that you're subscribed to.

+ */ export class ListAvailableManagedRuleGroupsCommand extends $Command< ListAvailableManagedRuleGroupsCommandInput, ListAvailableManagedRuleGroupsCommandOutput, @@ -34,6 +40,9 @@ export class ListAvailableManagedRuleGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/ListIPSetsCommand.ts b/clients/client-wafv2/commands/ListIPSetsCommand.ts index cf825149b4812..3b03aa6786563 100644 --- a/clients/client-wafv2/commands/ListIPSetsCommand.ts +++ b/clients/client-wafv2/commands/ListIPSetsCommand.ts @@ -20,6 +20,12 @@ import { export type ListIPSetsCommandInput = ListIPSetsRequest; export type ListIPSetsCommandOutput = ListIPSetsResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves an array of IPSetSummary objects for the IP sets that you manage.

+ */ export class ListIPSetsCommand extends $Command< ListIPSetsCommandInput, ListIPSetsCommandOutput, @@ -34,6 +40,9 @@ export class ListIPSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/ListLoggingConfigurationsCommand.ts b/clients/client-wafv2/commands/ListLoggingConfigurationsCommand.ts index 6bb73a88e6800..159135c80f865 100644 --- a/clients/client-wafv2/commands/ListLoggingConfigurationsCommand.ts +++ b/clients/client-wafv2/commands/ListLoggingConfigurationsCommand.ts @@ -20,6 +20,12 @@ import { export type ListLoggingConfigurationsCommandInput = ListLoggingConfigurationsRequest; export type ListLoggingConfigurationsCommandOutput = ListLoggingConfigurationsResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves an array of your LoggingConfiguration objects.

+ */ export class ListLoggingConfigurationsCommand extends $Command< ListLoggingConfigurationsCommandInput, ListLoggingConfigurationsCommandOutput, @@ -34,6 +40,9 @@ export class ListLoggingConfigurationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/ListRegexPatternSetsCommand.ts b/clients/client-wafv2/commands/ListRegexPatternSetsCommand.ts index c874b6892b574..6c6e7d40e13b6 100644 --- a/clients/client-wafv2/commands/ListRegexPatternSetsCommand.ts +++ b/clients/client-wafv2/commands/ListRegexPatternSetsCommand.ts @@ -20,6 +20,12 @@ import { export type ListRegexPatternSetsCommandInput = ListRegexPatternSetsRequest; export type ListRegexPatternSetsCommandOutput = ListRegexPatternSetsResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves an array of RegexPatternSetSummary objects for the regex pattern sets that you manage.

+ */ export class ListRegexPatternSetsCommand extends $Command< ListRegexPatternSetsCommandInput, ListRegexPatternSetsCommandOutput, @@ -34,6 +40,9 @@ export class ListRegexPatternSetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/ListResourcesForWebACLCommand.ts b/clients/client-wafv2/commands/ListResourcesForWebACLCommand.ts index dbf5bda8ba5b0..a2c42431ddf49 100644 --- a/clients/client-wafv2/commands/ListResourcesForWebACLCommand.ts +++ b/clients/client-wafv2/commands/ListResourcesForWebACLCommand.ts @@ -20,6 +20,12 @@ import { export type ListResourcesForWebACLCommandInput = ListResourcesForWebACLRequest; export type ListResourcesForWebACLCommandOutput = ListResourcesForWebACLResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves an array of the Amazon Resource Names (ARNs) for the regional resources that are associated with the specified web ACL. If you want the list of AWS CloudFront resources, use the AWS CloudFront call ListDistributionsByWebACLId.

+ */ export class ListResourcesForWebACLCommand extends $Command< ListResourcesForWebACLCommandInput, ListResourcesForWebACLCommandOutput, @@ -34,6 +40,9 @@ export class ListResourcesForWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/ListRuleGroupsCommand.ts b/clients/client-wafv2/commands/ListRuleGroupsCommand.ts index 47e8399042e03..ba3e5da69b04f 100644 --- a/clients/client-wafv2/commands/ListRuleGroupsCommand.ts +++ b/clients/client-wafv2/commands/ListRuleGroupsCommand.ts @@ -20,6 +20,12 @@ import { export type ListRuleGroupsCommandInput = ListRuleGroupsRequest; export type ListRuleGroupsCommandOutput = ListRuleGroupsResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves an array of RuleGroupSummary objects for the rule groups that you manage.

+ */ export class ListRuleGroupsCommand extends $Command< ListRuleGroupsCommandInput, ListRuleGroupsCommandOutput, @@ -34,6 +40,9 @@ export class ListRuleGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/ListTagsForResourceCommand.ts b/clients/client-wafv2/commands/ListTagsForResourceCommand.ts index 0417afdc201ac..460239caf8a1c 100644 --- a/clients/client-wafv2/commands/ListTagsForResourceCommand.ts +++ b/clients/client-wafv2/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,14 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves the TagInfoForResource for the specified resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each AWS resource, up to 50 tags for a resource.

+ *

You can tag the AWS resources that you manage through AWS WAF: web ACLs, rule groups, IP + * sets, and regex pattern sets. You can't manage or view tags through the AWS WAF console.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +42,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/ListWebACLsCommand.ts b/clients/client-wafv2/commands/ListWebACLsCommand.ts index 786d6b918b327..6bd39a4ee6733 100644 --- a/clients/client-wafv2/commands/ListWebACLsCommand.ts +++ b/clients/client-wafv2/commands/ListWebACLsCommand.ts @@ -20,6 +20,12 @@ import { export type ListWebACLsCommandInput = ListWebACLsRequest; export type ListWebACLsCommandOutput = ListWebACLsResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Retrieves an array of WebACLSummary objects for the web ACLs that you manage.

+ */ export class ListWebACLsCommand extends $Command< ListWebACLsCommandInput, ListWebACLsCommandOutput, @@ -34,6 +40,9 @@ export class ListWebACLsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/PutLoggingConfigurationCommand.ts b/clients/client-wafv2/commands/PutLoggingConfigurationCommand.ts index 040c91452f555..465700f6ab643 100644 --- a/clients/client-wafv2/commands/PutLoggingConfigurationCommand.ts +++ b/clients/client-wafv2/commands/PutLoggingConfigurationCommand.ts @@ -20,6 +20,30 @@ import { export type PutLoggingConfigurationCommandInput = PutLoggingConfigurationRequest; export type PutLoggingConfigurationCommandOutput = PutLoggingConfigurationResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Enables the specified LoggingConfiguration, to start logging from a web ACL, according to the configuration provided.

+ *

You can access information about all traffic that AWS WAF inspects using the following + * steps:

+ *
    + *
  1. + *

    Create an Amazon Kinesis Data + * Firehose.

    + *

    Create the data firehose with a PUT source and in the Region that you are operating. If you are capturing logs for Amazon CloudFront, always create the firehose in US East (N. Virginia).

    + *

    Give the data firehose a name that starts with the prefix aws-waf-logs-. For example, aws-waf-logs-us-east-2-analytics.

    + * + *

    Do not create the data firehose using a Kinesis stream as your source.

    + *
    + *
  2. + *
  3. + *

    Associate that firehose to your web ACL using a PutLoggingConfiguration request.

    + *
  4. + *
+ * + *

When you successfully enable logging using a PutLoggingConfiguration request, AWS WAF will create a service linked role with the necessary permissions to write logs to the Amazon Kinesis Data Firehose. For more information, see Logging Web ACL Traffic Information in the AWS WAF Developer Guide.

+ */ export class PutLoggingConfigurationCommand extends $Command< PutLoggingConfigurationCommandInput, PutLoggingConfigurationCommandOutput, @@ -34,6 +58,9 @@ export class PutLoggingConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/PutPermissionPolicyCommand.ts b/clients/client-wafv2/commands/PutPermissionPolicyCommand.ts index 3594ad9147c54..4364ff0ba9cb8 100644 --- a/clients/client-wafv2/commands/PutPermissionPolicyCommand.ts +++ b/clients/client-wafv2/commands/PutPermissionPolicyCommand.ts @@ -20,6 +20,22 @@ import { export type PutPermissionPolicyCommandInput = PutPermissionPolicyRequest; export type PutPermissionPolicyCommandOutput = PutPermissionPolicyResponse & __MetadataBearer; +/** + *

Attaches an IAM policy to the specified resource. Use this to share a rule group across accounts.

+ *

You must be the owner of the rule group to perform this operation.

+ *

This action is subject to the following restrictions:

+ *
    + *
  • + *

    You can attach only one policy with each PutPermissionPolicy request.

    + *
  • + *
  • + *

    The ARN in the request must be a valid WAF RuleGroup ARN and the rule group must exist in the same region.

    + *
  • + *
  • + *

    The user making the request must be the owner of the rule group.

    + *
  • + *
+ */ export class PutPermissionPolicyCommand extends $Command< PutPermissionPolicyCommandInput, PutPermissionPolicyCommandOutput, @@ -34,6 +50,9 @@ export class PutPermissionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/TagResourceCommand.ts b/clients/client-wafv2/commands/TagResourceCommand.ts index 49ae67eaab858..6571e1e21cf2f 100644 --- a/clients/client-wafv2/commands/TagResourceCommand.ts +++ b/clients/client-wafv2/commands/TagResourceCommand.ts @@ -20,6 +20,14 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Associates tags with the specified AWS resource. Tags are key:value pairs that you can use to categorize and manage your resources, for purposes like billing. For example, you might set the tag key to "customer" and the value to the customer name or ID. You can specify one or more tags to add to each AWS resource, up to 50 tags for a resource.

+ *

You can tag the AWS resources that you manage through AWS WAF: web ACLs, rule groups, IP + * sets, and regex pattern sets. You can't manage or view tags through the AWS WAF console.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +42,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/UntagResourceCommand.ts b/clients/client-wafv2/commands/UntagResourceCommand.ts index 3f63dbca8814d..d1bb309033949 100644 --- a/clients/client-wafv2/commands/UntagResourceCommand.ts +++ b/clients/client-wafv2/commands/UntagResourceCommand.ts @@ -20,6 +20,12 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Disassociates tags from an AWS resource. Tags are key:value pairs that you can associate with AWS resources. For example, the tag key might be "customer" and the tag value might be "companyA." You can specify one or more tags to add to each container. You can add up to 50 tags to each AWS resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +40,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/UpdateIPSetCommand.ts b/clients/client-wafv2/commands/UpdateIPSetCommand.ts index f1f45e0f71b28..6dae46c9a67c6 100644 --- a/clients/client-wafv2/commands/UpdateIPSetCommand.ts +++ b/clients/client-wafv2/commands/UpdateIPSetCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateIPSetCommandInput = UpdateIPSetRequest; export type UpdateIPSetCommandOutput = UpdateIPSetResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Updates the specified IPSet.

+ */ export class UpdateIPSetCommand extends $Command< UpdateIPSetCommandInput, UpdateIPSetCommandOutput, @@ -34,6 +40,9 @@ export class UpdateIPSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/UpdateRegexPatternSetCommand.ts b/clients/client-wafv2/commands/UpdateRegexPatternSetCommand.ts index 784fd027f25a3..fed5b51919e0b 100644 --- a/clients/client-wafv2/commands/UpdateRegexPatternSetCommand.ts +++ b/clients/client-wafv2/commands/UpdateRegexPatternSetCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateRegexPatternSetCommandInput = UpdateRegexPatternSetRequest; export type UpdateRegexPatternSetCommandOutput = UpdateRegexPatternSetResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Updates the specified RegexPatternSet.

+ */ export class UpdateRegexPatternSetCommand extends $Command< UpdateRegexPatternSetCommandInput, UpdateRegexPatternSetCommandOutput, @@ -34,6 +40,9 @@ export class UpdateRegexPatternSetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/UpdateRuleGroupCommand.ts b/clients/client-wafv2/commands/UpdateRuleGroupCommand.ts index da2ba90fa8822..e37c4c50da1b6 100644 --- a/clients/client-wafv2/commands/UpdateRuleGroupCommand.ts +++ b/clients/client-wafv2/commands/UpdateRuleGroupCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateRuleGroupCommandInput = UpdateRuleGroupRequest; export type UpdateRuleGroupCommandOutput = UpdateRuleGroupResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Updates the specified RuleGroup.

+ *

A rule group defines a collection of rules to inspect and control web requests that you can use in a WebACL. When you create a rule group, you define an immutable capacity limit. If you update a rule group, you must stay within the capacity. This allows others to reuse the rule group with confidence in its capacity requirements.

+ */ export class UpdateRuleGroupCommand extends $Command< UpdateRuleGroupCommandInput, UpdateRuleGroupCommandOutput, @@ -34,6 +41,9 @@ export class UpdateRuleGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/commands/UpdateWebACLCommand.ts b/clients/client-wafv2/commands/UpdateWebACLCommand.ts index ada08f891914f..f947146692132 100644 --- a/clients/client-wafv2/commands/UpdateWebACLCommand.ts +++ b/clients/client-wafv2/commands/UpdateWebACLCommand.ts @@ -20,6 +20,13 @@ import { export type UpdateWebACLCommandInput = UpdateWebACLRequest; export type UpdateWebACLCommandOutput = UpdateWebACLResponse & __MetadataBearer; +/** + * + *

This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information, including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.

+ *
+ *

Updates the specified WebACL.

+ *

A Web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action defined (allow, block, or count) for requests that match the statement of the rule. In the Web ACL, you assign a default action to take (allow, block) for any request that does not match any of the rules. The rules in a Web ACL can be a combination of the types Rule, RuleGroup, and managed rule group. You can associate a Web ACL with one or more AWS resources to protect. The resources can be Amazon CloudFront, an Amazon API Gateway REST API, an Application Load Balancer, or an AWS AppSync GraphQL API.

+ */ export class UpdateWebACLCommand extends $Command< UpdateWebACLCommandInput, UpdateWebACLCommandOutput, @@ -34,6 +41,9 @@ export class UpdateWebACLCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WAFV2ClientResolvedConfig, diff --git a/clients/client-wafv2/package.json b/clients/client-wafv2/package.json index d9b918c02323d..8a87cba9937ce 100644 --- a/clients/client-wafv2/package.json +++ b/clients/client-wafv2/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Wafv2 Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-wafv2/runtimeConfig.browser.ts b/clients/client-wafv2/runtimeConfig.browser.ts index 5825ca2d82a09..c231226454e89 100644 --- a/clients/client-wafv2/runtimeConfig.browser.ts +++ b/clients/client-wafv2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./WAFV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-wafv2/runtimeConfig.native.ts b/clients/client-wafv2/runtimeConfig.native.ts index 6796c3f13ee11..6d4f6ffe94a1b 100644 --- a/clients/client-wafv2/runtimeConfig.native.ts +++ b/clients/client-wafv2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./WAFV2Client"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-wafv2/runtimeConfig.shared.ts b/clients/client-wafv2/runtimeConfig.shared.ts index 391389d1bcd33..56d5895deaf3c 100644 --- a/clients/client-wafv2/runtimeConfig.shared.ts +++ b/clients/client-wafv2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-07-29", disableHostPrefix: false, diff --git a/clients/client-wafv2/runtimeConfig.ts b/clients/client-wafv2/runtimeConfig.ts index bf1c927e536c1..938f7f6d8979d 100644 --- a/clients/client-wafv2/runtimeConfig.ts +++ b/clients/client-wafv2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./WAFV2Client"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-wafv2/tsconfig.json b/clients/client-wafv2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-wafv2/tsconfig.json +++ b/clients/client-wafv2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-workdocs/commands/AbortDocumentVersionUploadCommand.ts b/clients/client-workdocs/commands/AbortDocumentVersionUploadCommand.ts index 306f853eb4fed..4d30a77a44b21 100644 --- a/clients/client-workdocs/commands/AbortDocumentVersionUploadCommand.ts +++ b/clients/client-workdocs/commands/AbortDocumentVersionUploadCommand.ts @@ -20,6 +20,12 @@ import { export type AbortDocumentVersionUploadCommandInput = AbortDocumentVersionUploadRequest; export type AbortDocumentVersionUploadCommandOutput = __MetadataBearer; +/** + *

Aborts the upload of the specified document version that was previously initiated + * by InitiateDocumentVersionUpload. The client should make this call + * only when it no longer intends to upload the document version, or fails to do + * so.

+ */ export class AbortDocumentVersionUploadCommand extends $Command< AbortDocumentVersionUploadCommandInput, AbortDocumentVersionUploadCommandOutput, @@ -34,6 +40,9 @@ export class AbortDocumentVersionUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/ActivateUserCommand.ts b/clients/client-workdocs/commands/ActivateUserCommand.ts index c1ce5f93ec805..4c9e4091e64b7 100644 --- a/clients/client-workdocs/commands/ActivateUserCommand.ts +++ b/clients/client-workdocs/commands/ActivateUserCommand.ts @@ -20,6 +20,10 @@ import { export type ActivateUserCommandInput = ActivateUserRequest; export type ActivateUserCommandOutput = ActivateUserResponse & __MetadataBearer; +/** + *

Activates the specified user. Only active users can access Amazon + * WorkDocs.

+ */ export class ActivateUserCommand extends $Command< ActivateUserCommandInput, ActivateUserCommandOutput, @@ -34,6 +38,9 @@ export class ActivateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/AddResourcePermissionsCommand.ts b/clients/client-workdocs/commands/AddResourcePermissionsCommand.ts index 63ea0c63326a0..76ec20505fddb 100644 --- a/clients/client-workdocs/commands/AddResourcePermissionsCommand.ts +++ b/clients/client-workdocs/commands/AddResourcePermissionsCommand.ts @@ -20,6 +20,11 @@ import { export type AddResourcePermissionsCommandInput = AddResourcePermissionsRequest; export type AddResourcePermissionsCommandOutput = AddResourcePermissionsResponse & __MetadataBearer; +/** + *

Creates a set of permissions for the specified folder or document. The resource + * permissions are overwritten if the principals already have different + * permissions.

+ */ export class AddResourcePermissionsCommand extends $Command< AddResourcePermissionsCommandInput, AddResourcePermissionsCommandOutput, @@ -34,6 +39,9 @@ export class AddResourcePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/CreateCommentCommand.ts b/clients/client-workdocs/commands/CreateCommentCommand.ts index 45263c6fe9eff..7713b7a07baf1 100644 --- a/clients/client-workdocs/commands/CreateCommentCommand.ts +++ b/clients/client-workdocs/commands/CreateCommentCommand.ts @@ -20,6 +20,9 @@ import { export type CreateCommentCommandInput = CreateCommentRequest; export type CreateCommentCommandOutput = CreateCommentResponse & __MetadataBearer; +/** + *

Adds a new comment to the specified document version.

+ */ export class CreateCommentCommand extends $Command< CreateCommentCommandInput, CreateCommentCommandOutput, @@ -34,6 +37,9 @@ export class CreateCommentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/CreateCustomMetadataCommand.ts b/clients/client-workdocs/commands/CreateCustomMetadataCommand.ts index 3951e8d0fe5c9..1e52204d59b5f 100644 --- a/clients/client-workdocs/commands/CreateCustomMetadataCommand.ts +++ b/clients/client-workdocs/commands/CreateCustomMetadataCommand.ts @@ -20,6 +20,10 @@ import { export type CreateCustomMetadataCommandInput = CreateCustomMetadataRequest; export type CreateCustomMetadataCommandOutput = CreateCustomMetadataResponse & __MetadataBearer; +/** + *

Adds one or more custom properties to the specified resource (a folder, document, + * or version).

+ */ export class CreateCustomMetadataCommand extends $Command< CreateCustomMetadataCommandInput, CreateCustomMetadataCommandOutput, @@ -34,6 +38,9 @@ export class CreateCustomMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/CreateFolderCommand.ts b/clients/client-workdocs/commands/CreateFolderCommand.ts index ce9e20d08c1a3..688510af90f9c 100644 --- a/clients/client-workdocs/commands/CreateFolderCommand.ts +++ b/clients/client-workdocs/commands/CreateFolderCommand.ts @@ -20,6 +20,9 @@ import { export type CreateFolderCommandInput = CreateFolderRequest; export type CreateFolderCommandOutput = CreateFolderResponse & __MetadataBearer; +/** + *

Creates a folder with the specified name and parent folder.

+ */ export class CreateFolderCommand extends $Command< CreateFolderCommandInput, CreateFolderCommandOutput, @@ -34,6 +37,9 @@ export class CreateFolderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/CreateLabelsCommand.ts b/clients/client-workdocs/commands/CreateLabelsCommand.ts index 8b2cdb720432b..e420e6250460b 100644 --- a/clients/client-workdocs/commands/CreateLabelsCommand.ts +++ b/clients/client-workdocs/commands/CreateLabelsCommand.ts @@ -20,6 +20,10 @@ import { export type CreateLabelsCommandInput = CreateLabelsRequest; export type CreateLabelsCommandOutput = CreateLabelsResponse & __MetadataBearer; +/** + *

Adds the specified list of labels to the given resource (a document or + * folder)

+ */ export class CreateLabelsCommand extends $Command< CreateLabelsCommandInput, CreateLabelsCommandOutput, @@ -34,6 +38,9 @@ export class CreateLabelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/CreateNotificationSubscriptionCommand.ts b/clients/client-workdocs/commands/CreateNotificationSubscriptionCommand.ts index 5b8073e7298d3..c121f749ad7a4 100644 --- a/clients/client-workdocs/commands/CreateNotificationSubscriptionCommand.ts +++ b/clients/client-workdocs/commands/CreateNotificationSubscriptionCommand.ts @@ -20,6 +20,13 @@ import { export type CreateNotificationSubscriptionCommandInput = CreateNotificationSubscriptionRequest; export type CreateNotificationSubscriptionCommandOutput = CreateNotificationSubscriptionResponse & __MetadataBearer; +/** + *

Configure Amazon WorkDocs to use Amazon SNS notifications. The endpoint receives a + * confirmation message, and must confirm the subscription.

+ *

For more information, see Subscribe to + * Notifications in the Amazon WorkDocs Developer + * Guide.

+ */ export class CreateNotificationSubscriptionCommand extends $Command< CreateNotificationSubscriptionCommandInput, CreateNotificationSubscriptionCommandOutput, @@ -34,6 +41,9 @@ export class CreateNotificationSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/CreateUserCommand.ts b/clients/client-workdocs/commands/CreateUserCommand.ts index dd164ef4a416d..c5a234413ffeb 100644 --- a/clients/client-workdocs/commands/CreateUserCommand.ts +++ b/clients/client-workdocs/commands/CreateUserCommand.ts @@ -20,6 +20,10 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResponse & __MetadataBearer; +/** + *

Creates a user in a Simple AD or Microsoft AD directory. The status of a newly + * created user is "ACTIVE". New users can access Amazon WorkDocs.

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -34,6 +38,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeactivateUserCommand.ts b/clients/client-workdocs/commands/DeactivateUserCommand.ts index 6691c5bb8f4f9..2373eb126a129 100644 --- a/clients/client-workdocs/commands/DeactivateUserCommand.ts +++ b/clients/client-workdocs/commands/DeactivateUserCommand.ts @@ -20,6 +20,10 @@ import { export type DeactivateUserCommandInput = DeactivateUserRequest; export type DeactivateUserCommandOutput = __MetadataBearer; +/** + *

Deactivates the specified user, which revokes the user's access to Amazon + * WorkDocs.

+ */ export class DeactivateUserCommand extends $Command< DeactivateUserCommandInput, DeactivateUserCommandOutput, @@ -34,6 +38,9 @@ export class DeactivateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeleteCommentCommand.ts b/clients/client-workdocs/commands/DeleteCommentCommand.ts index 1a8aa2518e313..fb83d792a3d6f 100644 --- a/clients/client-workdocs/commands/DeleteCommentCommand.ts +++ b/clients/client-workdocs/commands/DeleteCommentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCommentCommandInput = DeleteCommentRequest; export type DeleteCommentCommandOutput = __MetadataBearer; +/** + *

Deletes the specified comment from the document version.

+ */ export class DeleteCommentCommand extends $Command< DeleteCommentCommandInput, DeleteCommentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCommentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeleteCustomMetadataCommand.ts b/clients/client-workdocs/commands/DeleteCustomMetadataCommand.ts index b31f180ab35f7..7d6543d4e9730 100644 --- a/clients/client-workdocs/commands/DeleteCustomMetadataCommand.ts +++ b/clients/client-workdocs/commands/DeleteCustomMetadataCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteCustomMetadataCommandInput = DeleteCustomMetadataRequest; export type DeleteCustomMetadataCommandOutput = DeleteCustomMetadataResponse & __MetadataBearer; +/** + *

Deletes custom metadata from the specified resource.

+ */ export class DeleteCustomMetadataCommand extends $Command< DeleteCustomMetadataCommandInput, DeleteCustomMetadataCommandOutput, @@ -34,6 +37,9 @@ export class DeleteCustomMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeleteDocumentCommand.ts b/clients/client-workdocs/commands/DeleteDocumentCommand.ts index 1c7d8bab9dd6a..65cb01e6d96c8 100644 --- a/clients/client-workdocs/commands/DeleteDocumentCommand.ts +++ b/clients/client-workdocs/commands/DeleteDocumentCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteDocumentCommandInput = DeleteDocumentRequest; export type DeleteDocumentCommandOutput = __MetadataBearer; +/** + *

Permanently deletes the specified document and its associated metadata.

+ */ export class DeleteDocumentCommand extends $Command< DeleteDocumentCommandInput, DeleteDocumentCommandOutput, @@ -34,6 +37,9 @@ export class DeleteDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeleteFolderCommand.ts b/clients/client-workdocs/commands/DeleteFolderCommand.ts index d6cfc8476a122..2d5844adc7deb 100644 --- a/clients/client-workdocs/commands/DeleteFolderCommand.ts +++ b/clients/client-workdocs/commands/DeleteFolderCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFolderCommandInput = DeleteFolderRequest; export type DeleteFolderCommandOutput = __MetadataBearer; +/** + *

Permanently deletes the specified folder and its contents.

+ */ export class DeleteFolderCommand extends $Command< DeleteFolderCommandInput, DeleteFolderCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFolderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeleteFolderContentsCommand.ts b/clients/client-workdocs/commands/DeleteFolderContentsCommand.ts index d95c4f6972967..a63fc12da913d 100644 --- a/clients/client-workdocs/commands/DeleteFolderContentsCommand.ts +++ b/clients/client-workdocs/commands/DeleteFolderContentsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFolderContentsCommandInput = DeleteFolderContentsRequest; export type DeleteFolderContentsCommandOutput = __MetadataBearer; +/** + *

Deletes the contents of the specified folder.

+ */ export class DeleteFolderContentsCommand extends $Command< DeleteFolderContentsCommandInput, DeleteFolderContentsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFolderContentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeleteLabelsCommand.ts b/clients/client-workdocs/commands/DeleteLabelsCommand.ts index 003311c453549..8601605da3d82 100644 --- a/clients/client-workdocs/commands/DeleteLabelsCommand.ts +++ b/clients/client-workdocs/commands/DeleteLabelsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteLabelsCommandInput = DeleteLabelsRequest; export type DeleteLabelsCommandOutput = DeleteLabelsResponse & __MetadataBearer; +/** + *

Deletes the specified list of labels from a resource.

+ */ export class DeleteLabelsCommand extends $Command< DeleteLabelsCommandInput, DeleteLabelsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteLabelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeleteNotificationSubscriptionCommand.ts b/clients/client-workdocs/commands/DeleteNotificationSubscriptionCommand.ts index f57b70bc7b1ea..b93faf956e749 100644 --- a/clients/client-workdocs/commands/DeleteNotificationSubscriptionCommand.ts +++ b/clients/client-workdocs/commands/DeleteNotificationSubscriptionCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteNotificationSubscriptionCommandInput = DeleteNotificationSubscriptionRequest; export type DeleteNotificationSubscriptionCommandOutput = __MetadataBearer; +/** + *

Deletes the specified subscription from the specified organization.

+ */ export class DeleteNotificationSubscriptionCommand extends $Command< DeleteNotificationSubscriptionCommandInput, DeleteNotificationSubscriptionCommandOutput, @@ -34,6 +37,9 @@ export class DeleteNotificationSubscriptionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DeleteUserCommand.ts b/clients/client-workdocs/commands/DeleteUserCommand.ts index 9c6bd898ae41c..93f4a495cbc37 100644 --- a/clients/client-workdocs/commands/DeleteUserCommand.ts +++ b/clients/client-workdocs/commands/DeleteUserCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = __MetadataBearer; +/** + *

Deletes the specified user from a Simple AD or Microsoft AD directory.

+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -34,6 +37,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeActivitiesCommand.ts b/clients/client-workdocs/commands/DescribeActivitiesCommand.ts index dbd023a03863c..589c2f176119c 100644 --- a/clients/client-workdocs/commands/DescribeActivitiesCommand.ts +++ b/clients/client-workdocs/commands/DescribeActivitiesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeActivitiesCommandInput = DescribeActivitiesRequest; export type DescribeActivitiesCommandOutput = DescribeActivitiesResponse & __MetadataBearer; +/** + *

Describes the user activities in a specified time period.

+ */ export class DescribeActivitiesCommand extends $Command< DescribeActivitiesCommandInput, DescribeActivitiesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeActivitiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeCommentsCommand.ts b/clients/client-workdocs/commands/DescribeCommentsCommand.ts index 7ccd0a3bf32c4..3f8ec59c31dc9 100644 --- a/clients/client-workdocs/commands/DescribeCommentsCommand.ts +++ b/clients/client-workdocs/commands/DescribeCommentsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeCommentsCommandInput = DescribeCommentsRequest; export type DescribeCommentsCommandOutput = DescribeCommentsResponse & __MetadataBearer; +/** + *

List all the comments for the specified document version.

+ */ export class DescribeCommentsCommand extends $Command< DescribeCommentsCommandInput, DescribeCommentsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeCommentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeDocumentVersionsCommand.ts b/clients/client-workdocs/commands/DescribeDocumentVersionsCommand.ts index e5b23d583b3aa..6d21192dcdb0c 100644 --- a/clients/client-workdocs/commands/DescribeDocumentVersionsCommand.ts +++ b/clients/client-workdocs/commands/DescribeDocumentVersionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeDocumentVersionsCommandInput = DescribeDocumentVersionsRequest; export type DescribeDocumentVersionsCommandOutput = DescribeDocumentVersionsResponse & __MetadataBearer; +/** + *

Retrieves the document versions for the specified document.

+ *

By default, only active versions are returned.

+ */ export class DescribeDocumentVersionsCommand extends $Command< DescribeDocumentVersionsCommandInput, DescribeDocumentVersionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeDocumentVersionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeFolderContentsCommand.ts b/clients/client-workdocs/commands/DescribeFolderContentsCommand.ts index 23943edcc38f8..34ef2ff261ce1 100644 --- a/clients/client-workdocs/commands/DescribeFolderContentsCommand.ts +++ b/clients/client-workdocs/commands/DescribeFolderContentsCommand.ts @@ -20,6 +20,14 @@ import { export type DescribeFolderContentsCommandInput = DescribeFolderContentsRequest; export type DescribeFolderContentsCommandOutput = DescribeFolderContentsResponse & __MetadataBearer; +/** + *

Describes the contents of the specified folder, including its documents and + * subfolders.

+ *

By default, Amazon WorkDocs returns the first 100 active document and folder + * metadata items. If there are more results, the response includes a marker that you can + * use to request the next set of results. You can also request initialized + * documents.

+ */ export class DescribeFolderContentsCommand extends $Command< DescribeFolderContentsCommandInput, DescribeFolderContentsCommandOutput, @@ -34,6 +42,9 @@ export class DescribeFolderContentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeGroupsCommand.ts b/clients/client-workdocs/commands/DescribeGroupsCommand.ts index a835259baf388..7553e8e10c09c 100644 --- a/clients/client-workdocs/commands/DescribeGroupsCommand.ts +++ b/clients/client-workdocs/commands/DescribeGroupsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeGroupsCommandInput = DescribeGroupsRequest; export type DescribeGroupsCommandOutput = DescribeGroupsResponse & __MetadataBearer; +/** + *

Describes the groups specified by the query. Groups are defined by the underlying + * Active Directory.

+ */ export class DescribeGroupsCommand extends $Command< DescribeGroupsCommandInput, DescribeGroupsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeNotificationSubscriptionsCommand.ts b/clients/client-workdocs/commands/DescribeNotificationSubscriptionsCommand.ts index 67919c581ad99..cbde57fa2131e 100644 --- a/clients/client-workdocs/commands/DescribeNotificationSubscriptionsCommand.ts +++ b/clients/client-workdocs/commands/DescribeNotificationSubscriptionsCommand.ts @@ -24,6 +24,9 @@ export type DescribeNotificationSubscriptionsCommandInput = DescribeNotification export type DescribeNotificationSubscriptionsCommandOutput = DescribeNotificationSubscriptionsResponse & __MetadataBearer; +/** + *

Lists the specified notification subscriptions.

+ */ export class DescribeNotificationSubscriptionsCommand extends $Command< DescribeNotificationSubscriptionsCommandInput, DescribeNotificationSubscriptionsCommandOutput, @@ -38,6 +41,9 @@ export class DescribeNotificationSubscriptionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeResourcePermissionsCommand.ts b/clients/client-workdocs/commands/DescribeResourcePermissionsCommand.ts index 5fe1a428360aa..df8f767b70c69 100644 --- a/clients/client-workdocs/commands/DescribeResourcePermissionsCommand.ts +++ b/clients/client-workdocs/commands/DescribeResourcePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeResourcePermissionsCommandInput = DescribeResourcePermissionsRequest; export type DescribeResourcePermissionsCommandOutput = DescribeResourcePermissionsResponse & __MetadataBearer; +/** + *

Describes the permissions of a specified resource.

+ */ export class DescribeResourcePermissionsCommand extends $Command< DescribeResourcePermissionsCommandInput, DescribeResourcePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeResourcePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeRootFoldersCommand.ts b/clients/client-workdocs/commands/DescribeRootFoldersCommand.ts index 0ebed1dc6c638..5b531c066f508 100644 --- a/clients/client-workdocs/commands/DescribeRootFoldersCommand.ts +++ b/clients/client-workdocs/commands/DescribeRootFoldersCommand.ts @@ -20,6 +20,17 @@ import { export type DescribeRootFoldersCommandInput = DescribeRootFoldersRequest; export type DescribeRootFoldersCommandOutput = DescribeRootFoldersResponse & __MetadataBearer; +/** + *

Describes the current user's special folders; the RootFolder and the + * RecycleBin. RootFolder is the root of user's files and + * folders and RecycleBin is the root of recycled items. This is not a valid + * action for SigV4 (administrative API) clients.

+ *

This action requires an authentication token. To get an authentication token, + * register an application with Amazon WorkDocs. For more information, see Authentication and Access + * Control for User Applications in the + * Amazon + * WorkDocs Developer Guide.

+ */ export class DescribeRootFoldersCommand extends $Command< DescribeRootFoldersCommandInput, DescribeRootFoldersCommandOutput, @@ -34,6 +45,9 @@ export class DescribeRootFoldersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/DescribeUsersCommand.ts b/clients/client-workdocs/commands/DescribeUsersCommand.ts index 6e7170bbd1056..d42211f50ba6f 100644 --- a/clients/client-workdocs/commands/DescribeUsersCommand.ts +++ b/clients/client-workdocs/commands/DescribeUsersCommand.ts @@ -20,6 +20,13 @@ import { export type DescribeUsersCommandInput = DescribeUsersRequest; export type DescribeUsersCommandOutput = DescribeUsersResponse & __MetadataBearer; +/** + *

Describes the specified users. You can describe all users or filter the results + * (for example, by status or organization).

+ *

By default, Amazon WorkDocs returns the first 24 active or pending users. If there + * are more results, the response includes a marker that you can use to request the next + * set of results.

+ */ export class DescribeUsersCommand extends $Command< DescribeUsersCommandInput, DescribeUsersCommandOutput, @@ -34,6 +41,9 @@ export class DescribeUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/GetCurrentUserCommand.ts b/clients/client-workdocs/commands/GetCurrentUserCommand.ts index 1e5c9ce825062..e056d9f8d597d 100644 --- a/clients/client-workdocs/commands/GetCurrentUserCommand.ts +++ b/clients/client-workdocs/commands/GetCurrentUserCommand.ts @@ -20,6 +20,15 @@ import { export type GetCurrentUserCommandInput = GetCurrentUserRequest; export type GetCurrentUserCommandOutput = GetCurrentUserResponse & __MetadataBearer; +/** + *

Retrieves details of the current user for whom the authentication token was + * generated. This is not a valid action for SigV4 (administrative API) clients.

+ *

This action requires an authentication token. To get an authentication token, + * register an application with Amazon WorkDocs. For more information, see Authentication and Access + * Control for User Applications in the + * Amazon + * WorkDocs Developer Guide.

+ */ export class GetCurrentUserCommand extends $Command< GetCurrentUserCommandInput, GetCurrentUserCommandOutput, @@ -34,6 +43,9 @@ export class GetCurrentUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/GetDocumentCommand.ts b/clients/client-workdocs/commands/GetDocumentCommand.ts index b9c0767e0a134..04452bdb5f4d4 100644 --- a/clients/client-workdocs/commands/GetDocumentCommand.ts +++ b/clients/client-workdocs/commands/GetDocumentCommand.ts @@ -20,6 +20,9 @@ import { export type GetDocumentCommandInput = GetDocumentRequest; export type GetDocumentCommandOutput = GetDocumentResponse & __MetadataBearer; +/** + *

Retrieves details of a document.

+ */ export class GetDocumentCommand extends $Command< GetDocumentCommandInput, GetDocumentCommandOutput, @@ -34,6 +37,9 @@ export class GetDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/GetDocumentPathCommand.ts b/clients/client-workdocs/commands/GetDocumentPathCommand.ts index 8cb31d1b490fa..3e2206441616e 100644 --- a/clients/client-workdocs/commands/GetDocumentPathCommand.ts +++ b/clients/client-workdocs/commands/GetDocumentPathCommand.ts @@ -20,6 +20,14 @@ import { export type GetDocumentPathCommandInput = GetDocumentPathRequest; export type GetDocumentPathCommandOutput = GetDocumentPathResponse & __MetadataBearer; +/** + *

Retrieves the path information (the hierarchy from the root folder) for the + * requested document.

+ *

By default, Amazon WorkDocs returns a maximum of 100 levels upwards from the + * requested document and only includes the IDs of the parent folders in the path. You can + * limit the maximum number of levels. You can also request the names of the parent + * folders.

+ */ export class GetDocumentPathCommand extends $Command< GetDocumentPathCommandInput, GetDocumentPathCommandOutput, @@ -34,6 +42,9 @@ export class GetDocumentPathCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/GetDocumentVersionCommand.ts b/clients/client-workdocs/commands/GetDocumentVersionCommand.ts index 65f922761c9b3..758ad5d85b4f4 100644 --- a/clients/client-workdocs/commands/GetDocumentVersionCommand.ts +++ b/clients/client-workdocs/commands/GetDocumentVersionCommand.ts @@ -20,6 +20,9 @@ import { export type GetDocumentVersionCommandInput = GetDocumentVersionRequest; export type GetDocumentVersionCommandOutput = GetDocumentVersionResponse & __MetadataBearer; +/** + *

Retrieves version metadata for the specified document.

+ */ export class GetDocumentVersionCommand extends $Command< GetDocumentVersionCommandInput, GetDocumentVersionCommandOutput, @@ -34,6 +37,9 @@ export class GetDocumentVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/GetFolderCommand.ts b/clients/client-workdocs/commands/GetFolderCommand.ts index 6e4c9bc0a6bfe..4f2ce9fefacb8 100644 --- a/clients/client-workdocs/commands/GetFolderCommand.ts +++ b/clients/client-workdocs/commands/GetFolderCommand.ts @@ -20,6 +20,9 @@ import { export type GetFolderCommandInput = GetFolderRequest; export type GetFolderCommandOutput = GetFolderResponse & __MetadataBearer; +/** + *

Retrieves the metadata of the specified folder.

+ */ export class GetFolderCommand extends $Command< GetFolderCommandInput, GetFolderCommandOutput, @@ -34,6 +37,9 @@ export class GetFolderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/GetFolderPathCommand.ts b/clients/client-workdocs/commands/GetFolderPathCommand.ts index 05a7a6d6e64cd..e6b88e976c5ca 100644 --- a/clients/client-workdocs/commands/GetFolderPathCommand.ts +++ b/clients/client-workdocs/commands/GetFolderPathCommand.ts @@ -20,6 +20,14 @@ import { export type GetFolderPathCommandInput = GetFolderPathRequest; export type GetFolderPathCommandOutput = GetFolderPathResponse & __MetadataBearer; +/** + *

Retrieves the path information (the hierarchy from the root folder) for the + * specified folder.

+ *

By default, Amazon WorkDocs returns a maximum of 100 levels upwards from the + * requested folder and only includes the IDs of the parent folders in the path. You can + * limit the maximum number of levels. You can also request the parent folder + * names.

+ */ export class GetFolderPathCommand extends $Command< GetFolderPathCommandInput, GetFolderPathCommandOutput, @@ -34,6 +42,9 @@ export class GetFolderPathCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/GetResourcesCommand.ts b/clients/client-workdocs/commands/GetResourcesCommand.ts index 603e912291832..1c461fd444a0b 100644 --- a/clients/client-workdocs/commands/GetResourcesCommand.ts +++ b/clients/client-workdocs/commands/GetResourcesCommand.ts @@ -20,6 +20,10 @@ import { export type GetResourcesCommandInput = GetResourcesRequest; export type GetResourcesCommandOutput = GetResourcesResponse & __MetadataBearer; +/** + *

Retrieves a collection of resources, including folders and documents. The only + * CollectionType supported is SHARED_WITH_ME.

+ */ export class GetResourcesCommand extends $Command< GetResourcesCommandInput, GetResourcesCommandOutput, @@ -34,6 +38,9 @@ export class GetResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/InitiateDocumentVersionUploadCommand.ts b/clients/client-workdocs/commands/InitiateDocumentVersionUploadCommand.ts index df4a9241a616b..39ac47ca44267 100644 --- a/clients/client-workdocs/commands/InitiateDocumentVersionUploadCommand.ts +++ b/clients/client-workdocs/commands/InitiateDocumentVersionUploadCommand.ts @@ -20,6 +20,14 @@ import { export type InitiateDocumentVersionUploadCommandInput = InitiateDocumentVersionUploadRequest; export type InitiateDocumentVersionUploadCommandOutput = InitiateDocumentVersionUploadResponse & __MetadataBearer; +/** + *

Creates a new document object and version object.

+ *

The client specifies the parent folder ID and name of the document to upload. The + * ID is optionally specified when creating a new version of an existing document. This is + * the first step to upload a document. Next, upload the document to the URL returned from + * the call, and then call UpdateDocumentVersion.

+ *

To cancel the document upload, call AbortDocumentVersionUpload.

+ */ export class InitiateDocumentVersionUploadCommand extends $Command< InitiateDocumentVersionUploadCommandInput, InitiateDocumentVersionUploadCommandOutput, @@ -34,6 +42,9 @@ export class InitiateDocumentVersionUploadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/RemoveAllResourcePermissionsCommand.ts b/clients/client-workdocs/commands/RemoveAllResourcePermissionsCommand.ts index c6a303aca6782..55313c5fc871f 100644 --- a/clients/client-workdocs/commands/RemoveAllResourcePermissionsCommand.ts +++ b/clients/client-workdocs/commands/RemoveAllResourcePermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type RemoveAllResourcePermissionsCommandInput = RemoveAllResourcePermissionsRequest; export type RemoveAllResourcePermissionsCommandOutput = __MetadataBearer; +/** + *

Removes all the permissions from the specified resource.

+ */ export class RemoveAllResourcePermissionsCommand extends $Command< RemoveAllResourcePermissionsCommandInput, RemoveAllResourcePermissionsCommandOutput, @@ -34,6 +37,9 @@ export class RemoveAllResourcePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/RemoveResourcePermissionCommand.ts b/clients/client-workdocs/commands/RemoveResourcePermissionCommand.ts index 1a6828626e2ed..36cabaf9a9e70 100644 --- a/clients/client-workdocs/commands/RemoveResourcePermissionCommand.ts +++ b/clients/client-workdocs/commands/RemoveResourcePermissionCommand.ts @@ -20,6 +20,10 @@ import { export type RemoveResourcePermissionCommandInput = RemoveResourcePermissionRequest; export type RemoveResourcePermissionCommandOutput = __MetadataBearer; +/** + *

Removes the permission for the specified principal from the specified + * resource.

+ */ export class RemoveResourcePermissionCommand extends $Command< RemoveResourcePermissionCommandInput, RemoveResourcePermissionCommandOutput, @@ -34,6 +38,9 @@ export class RemoveResourcePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/UpdateDocumentCommand.ts b/clients/client-workdocs/commands/UpdateDocumentCommand.ts index e9ae304884bf0..ee8fdfd9296cb 100644 --- a/clients/client-workdocs/commands/UpdateDocumentCommand.ts +++ b/clients/client-workdocs/commands/UpdateDocumentCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateDocumentCommandInput = UpdateDocumentRequest; export type UpdateDocumentCommandOutput = __MetadataBearer; +/** + *

Updates the specified attributes of a document. The user must have access to both + * the document and its parent folder, if applicable.

+ */ export class UpdateDocumentCommand extends $Command< UpdateDocumentCommandInput, UpdateDocumentCommandOutput, @@ -34,6 +38,9 @@ export class UpdateDocumentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/UpdateDocumentVersionCommand.ts b/clients/client-workdocs/commands/UpdateDocumentVersionCommand.ts index 54d7b250473a2..989eb7bdf8410 100644 --- a/clients/client-workdocs/commands/UpdateDocumentVersionCommand.ts +++ b/clients/client-workdocs/commands/UpdateDocumentVersionCommand.ts @@ -20,6 +20,12 @@ import { export type UpdateDocumentVersionCommandInput = UpdateDocumentVersionRequest; export type UpdateDocumentVersionCommandOutput = __MetadataBearer; +/** + *

Changes the status of the document version to ACTIVE.

+ *

Amazon WorkDocs also sets its document container to ACTIVE. This is the last step + * in a document upload, after the client uploads the document to an S3-presigned URL + * returned by InitiateDocumentVersionUpload.

+ */ export class UpdateDocumentVersionCommand extends $Command< UpdateDocumentVersionCommandInput, UpdateDocumentVersionCommandOutput, @@ -34,6 +40,9 @@ export class UpdateDocumentVersionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/UpdateFolderCommand.ts b/clients/client-workdocs/commands/UpdateFolderCommand.ts index b8140fe32f590..2ea9ae4bdcb1e 100644 --- a/clients/client-workdocs/commands/UpdateFolderCommand.ts +++ b/clients/client-workdocs/commands/UpdateFolderCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateFolderCommandInput = UpdateFolderRequest; export type UpdateFolderCommandOutput = __MetadataBearer; +/** + *

Updates the specified attributes of the specified folder. The user must have access + * to both the folder and its parent folder, if applicable.

+ */ export class UpdateFolderCommand extends $Command< UpdateFolderCommandInput, UpdateFolderCommandOutput, @@ -34,6 +38,9 @@ export class UpdateFolderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/commands/UpdateUserCommand.ts b/clients/client-workdocs/commands/UpdateUserCommand.ts index e7c30a4b07c6b..6491ebde7a364 100644 --- a/clients/client-workdocs/commands/UpdateUserCommand.ts +++ b/clients/client-workdocs/commands/UpdateUserCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateUserCommandInput = UpdateUserRequest; export type UpdateUserCommandOutput = UpdateUserResponse & __MetadataBearer; +/** + *

Updates the specified attributes of the specified user, and grants or revokes + * administrative privileges to the Amazon WorkDocs site.

+ */ export class UpdateUserCommand extends $Command< UpdateUserCommandInput, UpdateUserCommandOutput, @@ -34,6 +38,9 @@ export class UpdateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkDocsClientResolvedConfig, diff --git a/clients/client-workdocs/package.json b/clients/client-workdocs/package.json index 15bfea3021511..f1f46cc4d96aa 100644 --- a/clients/client-workdocs/package.json +++ b/clients/client-workdocs/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Workdocs Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-workdocs/pagination/DescribeDocumentVersionsPaginator.ts b/clients/client-workdocs/pagination/DescribeDocumentVersionsPaginator.ts index 1849cc90f822d..2831eb091e4e4 100644 --- a/clients/client-workdocs/pagination/DescribeDocumentVersionsPaginator.ts +++ b/clients/client-workdocs/pagination/DescribeDocumentVersionsPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkDocsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkDocsClient, input: DescribeDocumentVersionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeDocumentVersionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkDocs, input: DescribeDocumentVersionsCommandInput, diff --git a/clients/client-workdocs/pagination/DescribeFolderContentsPaginator.ts b/clients/client-workdocs/pagination/DescribeFolderContentsPaginator.ts index d6deccc61174d..84445e00f5baa 100644 --- a/clients/client-workdocs/pagination/DescribeFolderContentsPaginator.ts +++ b/clients/client-workdocs/pagination/DescribeFolderContentsPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkDocsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkDocsClient, input: DescribeFolderContentsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeFolderContentsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkDocs, input: DescribeFolderContentsCommandInput, diff --git a/clients/client-workdocs/pagination/DescribeUsersPaginator.ts b/clients/client-workdocs/pagination/DescribeUsersPaginator.ts index 5bcf0c41ce0b1..1e551e5069bd5 100644 --- a/clients/client-workdocs/pagination/DescribeUsersPaginator.ts +++ b/clients/client-workdocs/pagination/DescribeUsersPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkDocsPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkDocsClient, input: DescribeUsersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkDocs, input: DescribeUsersCommandInput, diff --git a/clients/client-workdocs/runtimeConfig.browser.ts b/clients/client-workdocs/runtimeConfig.browser.ts index 349a942a552c4..ae609e929e370 100644 --- a/clients/client-workdocs/runtimeConfig.browser.ts +++ b/clients/client-workdocs/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./WorkDocsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-workdocs/runtimeConfig.native.ts b/clients/client-workdocs/runtimeConfig.native.ts index 28a6d03577f3b..8937246365f1b 100644 --- a/clients/client-workdocs/runtimeConfig.native.ts +++ b/clients/client-workdocs/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./WorkDocsClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-workdocs/runtimeConfig.shared.ts b/clients/client-workdocs/runtimeConfig.shared.ts index cd2815e104ced..253c00c35382e 100644 --- a/clients/client-workdocs/runtimeConfig.shared.ts +++ b/clients/client-workdocs/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-05-01", disableHostPrefix: false, diff --git a/clients/client-workdocs/runtimeConfig.ts b/clients/client-workdocs/runtimeConfig.ts index 458ccf70c8539..458f9b20e533a 100644 --- a/clients/client-workdocs/runtimeConfig.ts +++ b/clients/client-workdocs/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./WorkDocsClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-workdocs/tsconfig.json b/clients/client-workdocs/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-workdocs/tsconfig.json +++ b/clients/client-workdocs/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-worklink/commands/AssociateDomainCommand.ts b/clients/client-worklink/commands/AssociateDomainCommand.ts index f8986fe94172a..eaee1a8646ee3 100644 --- a/clients/client-worklink/commands/AssociateDomainCommand.ts +++ b/clients/client-worklink/commands/AssociateDomainCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateDomainCommandInput = AssociateDomainRequest; export type AssociateDomainCommandOutput = AssociateDomainResponse & __MetadataBearer; +/** + *

Specifies a domain to be associated to Amazon WorkLink.

+ */ export class AssociateDomainCommand extends $Command< AssociateDomainCommandInput, AssociateDomainCommandOutput, @@ -34,6 +37,9 @@ export class AssociateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/AssociateWebsiteAuthorizationProviderCommand.ts b/clients/client-worklink/commands/AssociateWebsiteAuthorizationProviderCommand.ts index c8d7b7e245ee5..959d09915219b 100644 --- a/clients/client-worklink/commands/AssociateWebsiteAuthorizationProviderCommand.ts +++ b/clients/client-worklink/commands/AssociateWebsiteAuthorizationProviderCommand.ts @@ -24,6 +24,9 @@ export type AssociateWebsiteAuthorizationProviderCommandInput = AssociateWebsite export type AssociateWebsiteAuthorizationProviderCommandOutput = AssociateWebsiteAuthorizationProviderResponse & __MetadataBearer; +/** + *

Associates a website authorization provider with a specified fleet. This is used to authorize users against associated websites in the company network.

+ */ export class AssociateWebsiteAuthorizationProviderCommand extends $Command< AssociateWebsiteAuthorizationProviderCommandInput, AssociateWebsiteAuthorizationProviderCommandOutput, @@ -38,6 +41,9 @@ export class AssociateWebsiteAuthorizationProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/AssociateWebsiteCertificateAuthorityCommand.ts b/clients/client-worklink/commands/AssociateWebsiteCertificateAuthorityCommand.ts index bbdc6ebd8d3a7..caef7ff654ba4 100644 --- a/clients/client-worklink/commands/AssociateWebsiteCertificateAuthorityCommand.ts +++ b/clients/client-worklink/commands/AssociateWebsiteCertificateAuthorityCommand.ts @@ -24,6 +24,10 @@ export type AssociateWebsiteCertificateAuthorityCommandInput = AssociateWebsiteC export type AssociateWebsiteCertificateAuthorityCommandOutput = AssociateWebsiteCertificateAuthorityResponse & __MetadataBearer; +/** + *

Imports the root certificate of a certificate authority (CA) used to obtain TLS + * certificates used by associated websites within the company network.

+ */ export class AssociateWebsiteCertificateAuthorityCommand extends $Command< AssociateWebsiteCertificateAuthorityCommandInput, AssociateWebsiteCertificateAuthorityCommandOutput, @@ -38,6 +42,9 @@ export class AssociateWebsiteCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/CreateFleetCommand.ts b/clients/client-worklink/commands/CreateFleetCommand.ts index a65a0c07d807f..5924a37e9ffbb 100644 --- a/clients/client-worklink/commands/CreateFleetCommand.ts +++ b/clients/client-worklink/commands/CreateFleetCommand.ts @@ -20,6 +20,10 @@ import { export type CreateFleetCommandInput = CreateFleetRequest; export type CreateFleetCommandOutput = CreateFleetResponse & __MetadataBearer; +/** + *

Creates a fleet. A fleet consists of resources and the configuration that delivers + * associated websites to authorized users who download and set up the Amazon WorkLink app.

+ */ export class CreateFleetCommand extends $Command< CreateFleetCommandInput, CreateFleetCommandOutput, @@ -34,6 +38,9 @@ export class CreateFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DeleteFleetCommand.ts b/clients/client-worklink/commands/DeleteFleetCommand.ts index 1bf0c7ec307c7..8203504b60013 100644 --- a/clients/client-worklink/commands/DeleteFleetCommand.ts +++ b/clients/client-worklink/commands/DeleteFleetCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteFleetCommandInput = DeleteFleetRequest; export type DeleteFleetCommandOutput = DeleteFleetResponse & __MetadataBearer; +/** + *

Deletes a fleet. Prevents users from accessing previously associated websites.

+ */ export class DeleteFleetCommand extends $Command< DeleteFleetCommandInput, DeleteFleetCommandOutput, @@ -34,6 +37,9 @@ export class DeleteFleetCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DescribeAuditStreamConfigurationCommand.ts b/clients/client-worklink/commands/DescribeAuditStreamConfigurationCommand.ts index c5cca524c4f87..55a7adc75fc9d 100644 --- a/clients/client-worklink/commands/DescribeAuditStreamConfigurationCommand.ts +++ b/clients/client-worklink/commands/DescribeAuditStreamConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeAuditStreamConfigurationCommandInput = DescribeAuditStreamConfigurationRequest; export type DescribeAuditStreamConfigurationCommandOutput = DescribeAuditStreamConfigurationResponse & __MetadataBearer; +/** + *

Describes the configuration for delivering audit streams to the customer account.

+ */ export class DescribeAuditStreamConfigurationCommand extends $Command< DescribeAuditStreamConfigurationCommandInput, DescribeAuditStreamConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class DescribeAuditStreamConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DescribeCompanyNetworkConfigurationCommand.ts b/clients/client-worklink/commands/DescribeCompanyNetworkConfigurationCommand.ts index 8eecea6f46b9d..b0d02b2fefd59 100644 --- a/clients/client-worklink/commands/DescribeCompanyNetworkConfigurationCommand.ts +++ b/clients/client-worklink/commands/DescribeCompanyNetworkConfigurationCommand.ts @@ -24,6 +24,10 @@ export type DescribeCompanyNetworkConfigurationCommandInput = DescribeCompanyNet export type DescribeCompanyNetworkConfigurationCommandOutput = DescribeCompanyNetworkConfigurationResponse & __MetadataBearer; +/** + *

Describes the networking configuration to access the internal websites associated with + * the specified fleet.

+ */ export class DescribeCompanyNetworkConfigurationCommand extends $Command< DescribeCompanyNetworkConfigurationCommandInput, DescribeCompanyNetworkConfigurationCommandOutput, @@ -38,6 +42,9 @@ export class DescribeCompanyNetworkConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DescribeDeviceCommand.ts b/clients/client-worklink/commands/DescribeDeviceCommand.ts index 1d9a5166f8d90..809b003534b37 100644 --- a/clients/client-worklink/commands/DescribeDeviceCommand.ts +++ b/clients/client-worklink/commands/DescribeDeviceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDeviceCommandInput = DescribeDeviceRequest; export type DescribeDeviceCommandOutput = DescribeDeviceResponse & __MetadataBearer; +/** + *

Provides information about a user's device.

+ */ export class DescribeDeviceCommand extends $Command< DescribeDeviceCommandInput, DescribeDeviceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDeviceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DescribeDevicePolicyConfigurationCommand.ts b/clients/client-worklink/commands/DescribeDevicePolicyConfigurationCommand.ts index 9c1bc5641ae77..1ba61943f6897 100644 --- a/clients/client-worklink/commands/DescribeDevicePolicyConfigurationCommand.ts +++ b/clients/client-worklink/commands/DescribeDevicePolicyConfigurationCommand.ts @@ -24,6 +24,9 @@ export type DescribeDevicePolicyConfigurationCommandInput = DescribeDevicePolicy export type DescribeDevicePolicyConfigurationCommandOutput = DescribeDevicePolicyConfigurationResponse & __MetadataBearer; +/** + *

Describes the device policy configuration for the specified fleet.

+ */ export class DescribeDevicePolicyConfigurationCommand extends $Command< DescribeDevicePolicyConfigurationCommandInput, DescribeDevicePolicyConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class DescribeDevicePolicyConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DescribeDomainCommand.ts b/clients/client-worklink/commands/DescribeDomainCommand.ts index 1628a533e5b80..0f1ab84a68745 100644 --- a/clients/client-worklink/commands/DescribeDomainCommand.ts +++ b/clients/client-worklink/commands/DescribeDomainCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeDomainCommandInput = DescribeDomainRequest; export type DescribeDomainCommandOutput = DescribeDomainResponse & __MetadataBearer; +/** + *

Provides information about the domain.

+ */ export class DescribeDomainCommand extends $Command< DescribeDomainCommandInput, DescribeDomainCommandOutput, @@ -34,6 +37,9 @@ export class DescribeDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DescribeFleetMetadataCommand.ts b/clients/client-worklink/commands/DescribeFleetMetadataCommand.ts index f7f0efc551ed7..33e0765322d15 100644 --- a/clients/client-worklink/commands/DescribeFleetMetadataCommand.ts +++ b/clients/client-worklink/commands/DescribeFleetMetadataCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeFleetMetadataCommandInput = DescribeFleetMetadataRequest; export type DescribeFleetMetadataCommandOutput = DescribeFleetMetadataResponse & __MetadataBearer; +/** + *

Provides basic information for the specified fleet, excluding identity provider, + * networking, and device configuration details.

+ */ export class DescribeFleetMetadataCommand extends $Command< DescribeFleetMetadataCommandInput, DescribeFleetMetadataCommandOutput, @@ -34,6 +38,9 @@ export class DescribeFleetMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DescribeIdentityProviderConfigurationCommand.ts b/clients/client-worklink/commands/DescribeIdentityProviderConfigurationCommand.ts index d19fe99379138..a296a31c21f87 100644 --- a/clients/client-worklink/commands/DescribeIdentityProviderConfigurationCommand.ts +++ b/clients/client-worklink/commands/DescribeIdentityProviderConfigurationCommand.ts @@ -24,6 +24,9 @@ export type DescribeIdentityProviderConfigurationCommandInput = DescribeIdentity export type DescribeIdentityProviderConfigurationCommandOutput = DescribeIdentityProviderConfigurationResponse & __MetadataBearer; +/** + *

Describes the identity provider configuration of the specified fleet.

+ */ export class DescribeIdentityProviderConfigurationCommand extends $Command< DescribeIdentityProviderConfigurationCommandInput, DescribeIdentityProviderConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class DescribeIdentityProviderConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DescribeWebsiteCertificateAuthorityCommand.ts b/clients/client-worklink/commands/DescribeWebsiteCertificateAuthorityCommand.ts index 97e961676374f..6d60373b2b82b 100644 --- a/clients/client-worklink/commands/DescribeWebsiteCertificateAuthorityCommand.ts +++ b/clients/client-worklink/commands/DescribeWebsiteCertificateAuthorityCommand.ts @@ -24,6 +24,9 @@ export type DescribeWebsiteCertificateAuthorityCommandInput = DescribeWebsiteCer export type DescribeWebsiteCertificateAuthorityCommandOutput = DescribeWebsiteCertificateAuthorityResponse & __MetadataBearer; +/** + *

Provides information about the certificate authority.

+ */ export class DescribeWebsiteCertificateAuthorityCommand extends $Command< DescribeWebsiteCertificateAuthorityCommandInput, DescribeWebsiteCertificateAuthorityCommandOutput, @@ -38,6 +41,9 @@ export class DescribeWebsiteCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DisassociateDomainCommand.ts b/clients/client-worklink/commands/DisassociateDomainCommand.ts index 331fbf887dada..1a2876d6c6b19 100644 --- a/clients/client-worklink/commands/DisassociateDomainCommand.ts +++ b/clients/client-worklink/commands/DisassociateDomainCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateDomainCommandInput = DisassociateDomainRequest; export type DisassociateDomainCommandOutput = DisassociateDomainResponse & __MetadataBearer; +/** + *

Disassociates a domain from Amazon WorkLink. End users lose the ability to access the domain with Amazon WorkLink.

+ */ export class DisassociateDomainCommand extends $Command< DisassociateDomainCommandInput, DisassociateDomainCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateDomainCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DisassociateWebsiteAuthorizationProviderCommand.ts b/clients/client-worklink/commands/DisassociateWebsiteAuthorizationProviderCommand.ts index 9e852b0257341..9d40fff8b03a8 100644 --- a/clients/client-worklink/commands/DisassociateWebsiteAuthorizationProviderCommand.ts +++ b/clients/client-worklink/commands/DisassociateWebsiteAuthorizationProviderCommand.ts @@ -24,6 +24,11 @@ export type DisassociateWebsiteAuthorizationProviderCommandInput = DisassociateW export type DisassociateWebsiteAuthorizationProviderCommandOutput = DisassociateWebsiteAuthorizationProviderResponse & __MetadataBearer; +/** + *

Disassociates a website authorization provider from a specified fleet. After the + * disassociation, users can't load any associated websites that require this authorization + * provider.

+ */ export class DisassociateWebsiteAuthorizationProviderCommand extends $Command< DisassociateWebsiteAuthorizationProviderCommandInput, DisassociateWebsiteAuthorizationProviderCommandOutput, @@ -38,6 +43,9 @@ export class DisassociateWebsiteAuthorizationProviderCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/DisassociateWebsiteCertificateAuthorityCommand.ts b/clients/client-worklink/commands/DisassociateWebsiteCertificateAuthorityCommand.ts index 43a0a8c7882a7..92cde044e11ea 100644 --- a/clients/client-worklink/commands/DisassociateWebsiteCertificateAuthorityCommand.ts +++ b/clients/client-worklink/commands/DisassociateWebsiteCertificateAuthorityCommand.ts @@ -24,6 +24,9 @@ export type DisassociateWebsiteCertificateAuthorityCommandInput = DisassociateWe export type DisassociateWebsiteCertificateAuthorityCommandOutput = DisassociateWebsiteCertificateAuthorityResponse & __MetadataBearer; +/** + *

Removes a certificate authority (CA).

+ */ export class DisassociateWebsiteCertificateAuthorityCommand extends $Command< DisassociateWebsiteCertificateAuthorityCommandInput, DisassociateWebsiteCertificateAuthorityCommandOutput, @@ -38,6 +41,9 @@ export class DisassociateWebsiteCertificateAuthorityCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/ListDevicesCommand.ts b/clients/client-worklink/commands/ListDevicesCommand.ts index fe793547ac42e..1e6cf4c6057cf 100644 --- a/clients/client-worklink/commands/ListDevicesCommand.ts +++ b/clients/client-worklink/commands/ListDevicesCommand.ts @@ -20,6 +20,9 @@ import { export type ListDevicesCommandInput = ListDevicesRequest; export type ListDevicesCommandOutput = ListDevicesResponse & __MetadataBearer; +/** + *

Retrieves a list of devices registered with the specified fleet.

+ */ export class ListDevicesCommand extends $Command< ListDevicesCommandInput, ListDevicesCommandOutput, @@ -34,6 +37,9 @@ export class ListDevicesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/ListDomainsCommand.ts b/clients/client-worklink/commands/ListDomainsCommand.ts index 9ee4c7e4a02b4..affc37da58c29 100644 --- a/clients/client-worklink/commands/ListDomainsCommand.ts +++ b/clients/client-worklink/commands/ListDomainsCommand.ts @@ -20,6 +20,9 @@ import { export type ListDomainsCommandInput = ListDomainsRequest; export type ListDomainsCommandOutput = ListDomainsResponse & __MetadataBearer; +/** + *

Retrieves a list of domains associated to a specified fleet.

+ */ export class ListDomainsCommand extends $Command< ListDomainsCommandInput, ListDomainsCommandOutput, @@ -34,6 +37,9 @@ export class ListDomainsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/ListFleetsCommand.ts b/clients/client-worklink/commands/ListFleetsCommand.ts index 087daccb25040..f9ac4be5e5693 100644 --- a/clients/client-worklink/commands/ListFleetsCommand.ts +++ b/clients/client-worklink/commands/ListFleetsCommand.ts @@ -20,6 +20,9 @@ import { export type ListFleetsCommandInput = ListFleetsRequest; export type ListFleetsCommandOutput = ListFleetsResponse & __MetadataBearer; +/** + *

Retrieves a list of fleets for the current account and Region.

+ */ export class ListFleetsCommand extends $Command< ListFleetsCommandInput, ListFleetsCommandOutput, @@ -34,6 +37,9 @@ export class ListFleetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/ListTagsForResourceCommand.ts b/clients/client-worklink/commands/ListTagsForResourceCommand.ts index ac6b9f7f8099c..a9aa563ced6fc 100644 --- a/clients/client-worklink/commands/ListTagsForResourceCommand.ts +++ b/clients/client-worklink/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Retrieves a list of tags for the specified resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/ListWebsiteAuthorizationProvidersCommand.ts b/clients/client-worklink/commands/ListWebsiteAuthorizationProvidersCommand.ts index a71afffd51c2c..8de0be2a5fe4f 100644 --- a/clients/client-worklink/commands/ListWebsiteAuthorizationProvidersCommand.ts +++ b/clients/client-worklink/commands/ListWebsiteAuthorizationProvidersCommand.ts @@ -24,6 +24,9 @@ export type ListWebsiteAuthorizationProvidersCommandInput = ListWebsiteAuthoriza export type ListWebsiteAuthorizationProvidersCommandOutput = ListWebsiteAuthorizationProvidersResponse & __MetadataBearer; +/** + *

Retrieves a list of website authorization providers associated with a specified fleet.

+ */ export class ListWebsiteAuthorizationProvidersCommand extends $Command< ListWebsiteAuthorizationProvidersCommandInput, ListWebsiteAuthorizationProvidersCommandOutput, @@ -38,6 +41,9 @@ export class ListWebsiteAuthorizationProvidersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/ListWebsiteCertificateAuthoritiesCommand.ts b/clients/client-worklink/commands/ListWebsiteCertificateAuthoritiesCommand.ts index 715722d471e4a..84636d8a30820 100644 --- a/clients/client-worklink/commands/ListWebsiteCertificateAuthoritiesCommand.ts +++ b/clients/client-worklink/commands/ListWebsiteCertificateAuthoritiesCommand.ts @@ -24,6 +24,10 @@ export type ListWebsiteCertificateAuthoritiesCommandInput = ListWebsiteCertifica export type ListWebsiteCertificateAuthoritiesCommandOutput = ListWebsiteCertificateAuthoritiesResponse & __MetadataBearer; +/** + *

Retrieves a list of certificate authorities added for the current account and + * Region.

+ */ export class ListWebsiteCertificateAuthoritiesCommand extends $Command< ListWebsiteCertificateAuthoritiesCommandInput, ListWebsiteCertificateAuthoritiesCommandOutput, @@ -38,6 +42,9 @@ export class ListWebsiteCertificateAuthoritiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/RestoreDomainAccessCommand.ts b/clients/client-worklink/commands/RestoreDomainAccessCommand.ts index cfe6bcc42ebfd..46f3c5c22191b 100644 --- a/clients/client-worklink/commands/RestoreDomainAccessCommand.ts +++ b/clients/client-worklink/commands/RestoreDomainAccessCommand.ts @@ -20,6 +20,9 @@ import { export type RestoreDomainAccessCommandInput = RestoreDomainAccessRequest; export type RestoreDomainAccessCommandOutput = RestoreDomainAccessResponse & __MetadataBearer; +/** + *

Moves a domain to ACTIVE status if it was in the INACTIVE status.

+ */ export class RestoreDomainAccessCommand extends $Command< RestoreDomainAccessCommandInput, RestoreDomainAccessCommandOutput, @@ -34,6 +37,9 @@ export class RestoreDomainAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/RevokeDomainAccessCommand.ts b/clients/client-worklink/commands/RevokeDomainAccessCommand.ts index 4c76d7e953e60..4f520765c3a7c 100644 --- a/clients/client-worklink/commands/RevokeDomainAccessCommand.ts +++ b/clients/client-worklink/commands/RevokeDomainAccessCommand.ts @@ -20,6 +20,9 @@ import { export type RevokeDomainAccessCommandInput = RevokeDomainAccessRequest; export type RevokeDomainAccessCommandOutput = RevokeDomainAccessResponse & __MetadataBearer; +/** + *

Moves a domain to INACTIVE status if it was in the ACTIVE status.

+ */ export class RevokeDomainAccessCommand extends $Command< RevokeDomainAccessCommandInput, RevokeDomainAccessCommandOutput, @@ -34,6 +37,9 @@ export class RevokeDomainAccessCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/SignOutUserCommand.ts b/clients/client-worklink/commands/SignOutUserCommand.ts index 8e123f8603f66..3695bdf75fff2 100644 --- a/clients/client-worklink/commands/SignOutUserCommand.ts +++ b/clients/client-worklink/commands/SignOutUserCommand.ts @@ -20,6 +20,10 @@ import { export type SignOutUserCommandInput = SignOutUserRequest; export type SignOutUserCommandOutput = SignOutUserResponse & __MetadataBearer; +/** + *

Signs the user out from all of their devices. The user can sign in again if they have + * valid credentials.

+ */ export class SignOutUserCommand extends $Command< SignOutUserCommandInput, SignOutUserCommandOutput, @@ -34,6 +38,9 @@ export class SignOutUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/TagResourceCommand.ts b/clients/client-worklink/commands/TagResourceCommand.ts index ff6081f82f1be..d2fbd56d822ca 100644 --- a/clients/client-worklink/commands/TagResourceCommand.ts +++ b/clients/client-worklink/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Adds or overwrites one or more tags for the specified resource, such as a fleet. Each tag consists of a key and an optional value. If a resource already has a tag with the same key, this operation updates its value.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/UntagResourceCommand.ts b/clients/client-worklink/commands/UntagResourceCommand.ts index ec912b2c8be4e..3078390da2a50 100644 --- a/clients/client-worklink/commands/UntagResourceCommand.ts +++ b/clients/client-worklink/commands/UntagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes one or more tags from the specified resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +37,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/UpdateAuditStreamConfigurationCommand.ts b/clients/client-worklink/commands/UpdateAuditStreamConfigurationCommand.ts index 0c656a30431fe..de079ae7cd276 100644 --- a/clients/client-worklink/commands/UpdateAuditStreamConfigurationCommand.ts +++ b/clients/client-worklink/commands/UpdateAuditStreamConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateAuditStreamConfigurationCommandInput = UpdateAuditStreamConfigurationRequest; export type UpdateAuditStreamConfigurationCommandOutput = UpdateAuditStreamConfigurationResponse & __MetadataBearer; +/** + *

Updates the audit stream configuration for the fleet.

+ */ export class UpdateAuditStreamConfigurationCommand extends $Command< UpdateAuditStreamConfigurationCommandInput, UpdateAuditStreamConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateAuditStreamConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/UpdateCompanyNetworkConfigurationCommand.ts b/clients/client-worklink/commands/UpdateCompanyNetworkConfigurationCommand.ts index 1c40712b95752..5a14e9b9640f1 100644 --- a/clients/client-worklink/commands/UpdateCompanyNetworkConfigurationCommand.ts +++ b/clients/client-worklink/commands/UpdateCompanyNetworkConfigurationCommand.ts @@ -24,6 +24,9 @@ export type UpdateCompanyNetworkConfigurationCommandInput = UpdateCompanyNetwork export type UpdateCompanyNetworkConfigurationCommandOutput = UpdateCompanyNetworkConfigurationResponse & __MetadataBearer; +/** + *

Updates the company network configuration for the fleet.

+ */ export class UpdateCompanyNetworkConfigurationCommand extends $Command< UpdateCompanyNetworkConfigurationCommandInput, UpdateCompanyNetworkConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class UpdateCompanyNetworkConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/UpdateDevicePolicyConfigurationCommand.ts b/clients/client-worklink/commands/UpdateDevicePolicyConfigurationCommand.ts index 2212113f7c972..27fded9f2971b 100644 --- a/clients/client-worklink/commands/UpdateDevicePolicyConfigurationCommand.ts +++ b/clients/client-worklink/commands/UpdateDevicePolicyConfigurationCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDevicePolicyConfigurationCommandInput = UpdateDevicePolicyConfigurationRequest; export type UpdateDevicePolicyConfigurationCommandOutput = UpdateDevicePolicyConfigurationResponse & __MetadataBearer; +/** + *

Updates the device policy configuration for the fleet.

+ */ export class UpdateDevicePolicyConfigurationCommand extends $Command< UpdateDevicePolicyConfigurationCommandInput, UpdateDevicePolicyConfigurationCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDevicePolicyConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/UpdateDomainMetadataCommand.ts b/clients/client-worklink/commands/UpdateDomainMetadataCommand.ts index 5209034ac5ba0..56efb1ff203b3 100644 --- a/clients/client-worklink/commands/UpdateDomainMetadataCommand.ts +++ b/clients/client-worklink/commands/UpdateDomainMetadataCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateDomainMetadataCommandInput = UpdateDomainMetadataRequest; export type UpdateDomainMetadataCommandOutput = UpdateDomainMetadataResponse & __MetadataBearer; +/** + *

Updates domain metadata, such as DisplayName.

+ */ export class UpdateDomainMetadataCommand extends $Command< UpdateDomainMetadataCommandInput, UpdateDomainMetadataCommandOutput, @@ -34,6 +37,9 @@ export class UpdateDomainMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/UpdateFleetMetadataCommand.ts b/clients/client-worklink/commands/UpdateFleetMetadataCommand.ts index d32b67d6c273e..98fdef3cfd7e5 100644 --- a/clients/client-worklink/commands/UpdateFleetMetadataCommand.ts +++ b/clients/client-worklink/commands/UpdateFleetMetadataCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateFleetMetadataCommandInput = UpdateFleetMetadataRequest; export type UpdateFleetMetadataCommandOutput = UpdateFleetMetadataResponse & __MetadataBearer; +/** + *

Updates fleet metadata, such as DisplayName.

+ */ export class UpdateFleetMetadataCommand extends $Command< UpdateFleetMetadataCommandInput, UpdateFleetMetadataCommandOutput, @@ -34,6 +37,9 @@ export class UpdateFleetMetadataCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/commands/UpdateIdentityProviderConfigurationCommand.ts b/clients/client-worklink/commands/UpdateIdentityProviderConfigurationCommand.ts index c2f144f9c71b4..9efb3f7f3a4ad 100644 --- a/clients/client-worklink/commands/UpdateIdentityProviderConfigurationCommand.ts +++ b/clients/client-worklink/commands/UpdateIdentityProviderConfigurationCommand.ts @@ -24,6 +24,9 @@ export type UpdateIdentityProviderConfigurationCommandInput = UpdateIdentityProv export type UpdateIdentityProviderConfigurationCommandOutput = UpdateIdentityProviderConfigurationResponse & __MetadataBearer; +/** + *

Updates the identity provider configuration for the fleet.

+ */ export class UpdateIdentityProviderConfigurationCommand extends $Command< UpdateIdentityProviderConfigurationCommandInput, UpdateIdentityProviderConfigurationCommandOutput, @@ -38,6 +41,9 @@ export class UpdateIdentityProviderConfigurationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkLinkClientResolvedConfig, diff --git a/clients/client-worklink/package.json b/clients/client-worklink/package.json index d2f2150967472..a46e7711649fc 100644 --- a/clients/client-worklink/package.json +++ b/clients/client-worklink/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Worklink Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-worklink/pagination/ListDevicesPaginator.ts b/clients/client-worklink/pagination/ListDevicesPaginator.ts index 75ecb6310477f..edb5690ee042d 100644 --- a/clients/client-worklink/pagination/ListDevicesPaginator.ts +++ b/clients/client-worklink/pagination/ListDevicesPaginator.ts @@ -4,6 +4,9 @@ import { ListDevicesCommand, ListDevicesCommandInput, ListDevicesCommandOutput } import { WorkLinkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkLinkClient, input: ListDevicesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDevicesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkLink, input: ListDevicesCommandInput, diff --git a/clients/client-worklink/pagination/ListDomainsPaginator.ts b/clients/client-worklink/pagination/ListDomainsPaginator.ts index 636056b45bd53..ebd50f8b71005 100644 --- a/clients/client-worklink/pagination/ListDomainsPaginator.ts +++ b/clients/client-worklink/pagination/ListDomainsPaginator.ts @@ -4,6 +4,9 @@ import { ListDomainsCommand, ListDomainsCommandInput, ListDomainsCommandOutput } import { WorkLinkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkLinkClient, input: ListDomainsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListDomainsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkLink, input: ListDomainsCommandInput, diff --git a/clients/client-worklink/pagination/ListFleetsPaginator.ts b/clients/client-worklink/pagination/ListFleetsPaginator.ts index 1442914dcf98a..1f995416d9287 100644 --- a/clients/client-worklink/pagination/ListFleetsPaginator.ts +++ b/clients/client-worklink/pagination/ListFleetsPaginator.ts @@ -4,6 +4,9 @@ import { ListFleetsCommand, ListFleetsCommandInput, ListFleetsCommandOutput } fr import { WorkLinkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkLinkClient, input: ListFleetsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListFleetsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkLink, input: ListFleetsCommandInput, diff --git a/clients/client-worklink/pagination/ListWebsiteAuthorizationProvidersPaginator.ts b/clients/client-worklink/pagination/ListWebsiteAuthorizationProvidersPaginator.ts index d1b253b87c6fa..434b79b92c59a 100644 --- a/clients/client-worklink/pagination/ListWebsiteAuthorizationProvidersPaginator.ts +++ b/clients/client-worklink/pagination/ListWebsiteAuthorizationProvidersPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkLinkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkLinkClient, input: ListWebsiteAuthorizationProvidersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWebsiteAuthorizationProvidersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkLink, input: ListWebsiteAuthorizationProvidersCommandInput, diff --git a/clients/client-worklink/pagination/ListWebsiteCertificateAuthoritiesPaginator.ts b/clients/client-worklink/pagination/ListWebsiteCertificateAuthoritiesPaginator.ts index 1b08a460db991..3d58ded5cc04c 100644 --- a/clients/client-worklink/pagination/ListWebsiteCertificateAuthoritiesPaginator.ts +++ b/clients/client-worklink/pagination/ListWebsiteCertificateAuthoritiesPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkLinkPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkLinkClient, input: ListWebsiteCertificateAuthoritiesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListWebsiteCertificateAuthoritiesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkLink, input: ListWebsiteCertificateAuthoritiesCommandInput, diff --git a/clients/client-worklink/runtimeConfig.browser.ts b/clients/client-worklink/runtimeConfig.browser.ts index 4b070cf405e8d..07cabc8ceeacc 100644 --- a/clients/client-worklink/runtimeConfig.browser.ts +++ b/clients/client-worklink/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./WorkLinkClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-worklink/runtimeConfig.native.ts b/clients/client-worklink/runtimeConfig.native.ts index 8cbef458dd9b1..abcc18ec5e853 100644 --- a/clients/client-worklink/runtimeConfig.native.ts +++ b/clients/client-worklink/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./WorkLinkClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-worklink/runtimeConfig.shared.ts b/clients/client-worklink/runtimeConfig.shared.ts index 2bc2332cb5e74..d2a15e309cce7 100644 --- a/clients/client-worklink/runtimeConfig.shared.ts +++ b/clients/client-worklink/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-09-25", disableHostPrefix: false, diff --git a/clients/client-worklink/runtimeConfig.ts b/clients/client-worklink/runtimeConfig.ts index 80b59dd7cbab6..5d88e326f001f 100644 --- a/clients/client-worklink/runtimeConfig.ts +++ b/clients/client-worklink/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./WorkLinkClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-worklink/tsconfig.json b/clients/client-worklink/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-worklink/tsconfig.json +++ b/clients/client-worklink/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-workmail/commands/AssociateDelegateToResourceCommand.ts b/clients/client-workmail/commands/AssociateDelegateToResourceCommand.ts index 28a7536e5a7d1..6e431a4d775cb 100644 --- a/clients/client-workmail/commands/AssociateDelegateToResourceCommand.ts +++ b/clients/client-workmail/commands/AssociateDelegateToResourceCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateDelegateToResourceCommandInput = AssociateDelegateToResourceRequest; export type AssociateDelegateToResourceCommandOutput = AssociateDelegateToResourceResponse & __MetadataBearer; +/** + *

Adds a member (user or group) to the resource's set of delegates.

+ */ export class AssociateDelegateToResourceCommand extends $Command< AssociateDelegateToResourceCommandInput, AssociateDelegateToResourceCommandOutput, @@ -34,6 +37,9 @@ export class AssociateDelegateToResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/AssociateMemberToGroupCommand.ts b/clients/client-workmail/commands/AssociateMemberToGroupCommand.ts index 746d8af60d4c3..a891fc04a2a8f 100644 --- a/clients/client-workmail/commands/AssociateMemberToGroupCommand.ts +++ b/clients/client-workmail/commands/AssociateMemberToGroupCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateMemberToGroupCommandInput = AssociateMemberToGroupRequest; export type AssociateMemberToGroupCommandOutput = AssociateMemberToGroupResponse & __MetadataBearer; +/** + *

Adds a member (user or group) to the group's set.

+ */ export class AssociateMemberToGroupCommand extends $Command< AssociateMemberToGroupCommandInput, AssociateMemberToGroupCommandOutput, @@ -34,6 +37,9 @@ export class AssociateMemberToGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/CancelMailboxExportJobCommand.ts b/clients/client-workmail/commands/CancelMailboxExportJobCommand.ts index 82bcaf14b503f..7837dd112eebf 100644 --- a/clients/client-workmail/commands/CancelMailboxExportJobCommand.ts +++ b/clients/client-workmail/commands/CancelMailboxExportJobCommand.ts @@ -20,6 +20,13 @@ import { export type CancelMailboxExportJobCommandInput = CancelMailboxExportJobRequest; export type CancelMailboxExportJobCommandOutput = CancelMailboxExportJobResponse & __MetadataBearer; +/** + *

Cancels a mailbox export job.

+ * + *

If the mailbox export job is near completion, it might not be possible to cancel + * it.

+ *
+ */ export class CancelMailboxExportJobCommand extends $Command< CancelMailboxExportJobCommandInput, CancelMailboxExportJobCommandOutput, @@ -34,6 +41,9 @@ export class CancelMailboxExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/CreateAliasCommand.ts b/clients/client-workmail/commands/CreateAliasCommand.ts index dced4a9805c46..f3f921aea9e10 100644 --- a/clients/client-workmail/commands/CreateAliasCommand.ts +++ b/clients/client-workmail/commands/CreateAliasCommand.ts @@ -20,6 +20,9 @@ import { export type CreateAliasCommandInput = CreateAliasRequest; export type CreateAliasCommandOutput = CreateAliasResponse & __MetadataBearer; +/** + *

Adds an alias to the set of a given member (user or group) of Amazon WorkMail.

+ */ export class CreateAliasCommand extends $Command< CreateAliasCommandInput, CreateAliasCommandOutput, @@ -34,6 +37,9 @@ export class CreateAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/CreateGroupCommand.ts b/clients/client-workmail/commands/CreateGroupCommand.ts index bfe7d50998608..c122819efe09d 100644 --- a/clients/client-workmail/commands/CreateGroupCommand.ts +++ b/clients/client-workmail/commands/CreateGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGroupCommandInput = CreateGroupRequest; export type CreateGroupCommandOutput = CreateGroupResponse & __MetadataBearer; +/** + *

Creates a group that can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.

+ */ export class CreateGroupCommand extends $Command< CreateGroupCommandInput, CreateGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/CreateOrganizationCommand.ts b/clients/client-workmail/commands/CreateOrganizationCommand.ts index ccf0ec7c857a5..1b95a2ed77f19 100644 --- a/clients/client-workmail/commands/CreateOrganizationCommand.ts +++ b/clients/client-workmail/commands/CreateOrganizationCommand.ts @@ -20,6 +20,13 @@ import { export type CreateOrganizationCommandInput = CreateOrganizationRequest; export type CreateOrganizationCommandOutput = CreateOrganizationResponse & __MetadataBearer; +/** + *

Creates a new Amazon WorkMail organization. Optionally, you can choose to associate an existing AWS Directory Service directory with your organization. If an AWS Directory Service directory ID is specified, the organization alias must match the directory alias. If you choose not to associate an existing directory with your organization, then we create a new Amazon WorkMail directory for you. For more information, see Adding an organization in the Amazon WorkMail Administrator Guide.

+ *

You can associate multiple email domains with an organization, then set your default email domain from the Amazon WorkMail console. You can also associate a domain that is managed in an Amazon Route 53 public hosted zone. For more information, see Adding a domain and Choosing the default domain in the Amazon WorkMail Administrator Guide.

+ *

Optionally, you can use a customer managed master key from AWS Key Management Service + * (AWS KMS) to encrypt email for your organization. If you don't associate an AWS KMS key, Amazon WorkMail creates a + * default AWS managed master key for you.

+ */ export class CreateOrganizationCommand extends $Command< CreateOrganizationCommandInput, CreateOrganizationCommandOutput, @@ -34,6 +41,9 @@ export class CreateOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/CreateResourceCommand.ts b/clients/client-workmail/commands/CreateResourceCommand.ts index bc35021e5eedb..5fd6251e1874c 100644 --- a/clients/client-workmail/commands/CreateResourceCommand.ts +++ b/clients/client-workmail/commands/CreateResourceCommand.ts @@ -20,6 +20,9 @@ import { export type CreateResourceCommandInput = CreateResourceRequest; export type CreateResourceCommandOutput = CreateResourceResponse & __MetadataBearer; +/** + *

Creates a new Amazon WorkMail resource.

+ */ export class CreateResourceCommand extends $Command< CreateResourceCommandInput, CreateResourceCommandOutput, @@ -34,6 +37,9 @@ export class CreateResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/CreateUserCommand.ts b/clients/client-workmail/commands/CreateUserCommand.ts index 8f16bf1ff9c77..eb441668d74fd 100644 --- a/clients/client-workmail/commands/CreateUserCommand.ts +++ b/clients/client-workmail/commands/CreateUserCommand.ts @@ -20,6 +20,9 @@ import { export type CreateUserCommandInput = CreateUserRequest; export type CreateUserCommandOutput = CreateUserResponse & __MetadataBearer; +/** + *

Creates a user who can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.

+ */ export class CreateUserCommand extends $Command< CreateUserCommandInput, CreateUserCommandOutput, @@ -34,6 +37,9 @@ export class CreateUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeleteAccessControlRuleCommand.ts b/clients/client-workmail/commands/DeleteAccessControlRuleCommand.ts index 2866df1ae2aef..c38d868ff88cf 100644 --- a/clients/client-workmail/commands/DeleteAccessControlRuleCommand.ts +++ b/clients/client-workmail/commands/DeleteAccessControlRuleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteAccessControlRuleCommandInput = DeleteAccessControlRuleRequest; export type DeleteAccessControlRuleCommandOutput = DeleteAccessControlRuleResponse & __MetadataBearer; +/** + *

Deletes an access control rule for the specified WorkMail organization.

+ */ export class DeleteAccessControlRuleCommand extends $Command< DeleteAccessControlRuleCommandInput, DeleteAccessControlRuleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteAccessControlRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeleteAliasCommand.ts b/clients/client-workmail/commands/DeleteAliasCommand.ts index 281da123f24c7..9e74bbc358283 100644 --- a/clients/client-workmail/commands/DeleteAliasCommand.ts +++ b/clients/client-workmail/commands/DeleteAliasCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteAliasCommandInput = DeleteAliasRequest; export type DeleteAliasCommandOutput = DeleteAliasResponse & __MetadataBearer; +/** + *

Remove one or more specified aliases from a set of aliases for a given + * user.

+ */ export class DeleteAliasCommand extends $Command< DeleteAliasCommandInput, DeleteAliasCommandOutput, @@ -34,6 +38,9 @@ export class DeleteAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeleteGroupCommand.ts b/clients/client-workmail/commands/DeleteGroupCommand.ts index 2cb5c0c280c00..c48c500a6bbed 100644 --- a/clients/client-workmail/commands/DeleteGroupCommand.ts +++ b/clients/client-workmail/commands/DeleteGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGroupCommandInput = DeleteGroupRequest; export type DeleteGroupCommandOutput = DeleteGroupResponse & __MetadataBearer; +/** + *

Deletes a group from Amazon WorkMail.

+ */ export class DeleteGroupCommand extends $Command< DeleteGroupCommandInput, DeleteGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeleteMailboxPermissionsCommand.ts b/clients/client-workmail/commands/DeleteMailboxPermissionsCommand.ts index d90f092901b77..4f31bf610f13d 100644 --- a/clients/client-workmail/commands/DeleteMailboxPermissionsCommand.ts +++ b/clients/client-workmail/commands/DeleteMailboxPermissionsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteMailboxPermissionsCommandInput = DeleteMailboxPermissionsRequest; export type DeleteMailboxPermissionsCommandOutput = DeleteMailboxPermissionsResponse & __MetadataBearer; +/** + *

Deletes permissions granted to a member (user or group).

+ */ export class DeleteMailboxPermissionsCommand extends $Command< DeleteMailboxPermissionsCommandInput, DeleteMailboxPermissionsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteMailboxPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeleteOrganizationCommand.ts b/clients/client-workmail/commands/DeleteOrganizationCommand.ts index e329bb7cb0c93..615bf8e52e644 100644 --- a/clients/client-workmail/commands/DeleteOrganizationCommand.ts +++ b/clients/client-workmail/commands/DeleteOrganizationCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteOrganizationCommandInput = DeleteOrganizationRequest; export type DeleteOrganizationCommandOutput = DeleteOrganizationResponse & __MetadataBearer; +/** + *

Deletes an Amazon WorkMail organization and all underlying AWS resources managed by Amazon WorkMail as part of the organization. You can choose whether to delete the associated directory. For more information, see Removing an organization in the Amazon WorkMail Administrator Guide.

+ */ export class DeleteOrganizationCommand extends $Command< DeleteOrganizationCommandInput, DeleteOrganizationCommandOutput, @@ -34,6 +37,9 @@ export class DeleteOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeleteResourceCommand.ts b/clients/client-workmail/commands/DeleteResourceCommand.ts index 092d15af24987..e845ba29962a7 100644 --- a/clients/client-workmail/commands/DeleteResourceCommand.ts +++ b/clients/client-workmail/commands/DeleteResourceCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteResourceCommandInput = DeleteResourceRequest; export type DeleteResourceCommandOutput = DeleteResourceResponse & __MetadataBearer; +/** + *

Deletes the specified resource.

+ */ export class DeleteResourceCommand extends $Command< DeleteResourceCommandInput, DeleteResourceCommandOutput, @@ -34,6 +37,9 @@ export class DeleteResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeleteRetentionPolicyCommand.ts b/clients/client-workmail/commands/DeleteRetentionPolicyCommand.ts index 4e76bbbd954e6..4fdda3a5c0900 100644 --- a/clients/client-workmail/commands/DeleteRetentionPolicyCommand.ts +++ b/clients/client-workmail/commands/DeleteRetentionPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteRetentionPolicyCommandInput = DeleteRetentionPolicyRequest; export type DeleteRetentionPolicyCommandOutput = DeleteRetentionPolicyResponse & __MetadataBearer; +/** + *

Deletes the specified retention policy from the specified organization.

+ */ export class DeleteRetentionPolicyCommand extends $Command< DeleteRetentionPolicyCommandInput, DeleteRetentionPolicyCommandOutput, @@ -34,6 +37,9 @@ export class DeleteRetentionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeleteUserCommand.ts b/clients/client-workmail/commands/DeleteUserCommand.ts index dcbb1e6bb8099..0b667276ce733 100644 --- a/clients/client-workmail/commands/DeleteUserCommand.ts +++ b/clients/client-workmail/commands/DeleteUserCommand.ts @@ -20,6 +20,13 @@ import { export type DeleteUserCommandInput = DeleteUserRequest; export type DeleteUserCommandOutput = DeleteUserResponse & __MetadataBearer; +/** + *

Deletes a user from Amazon WorkMail and all subsequent systems. Before you can delete a + * user, the user state must be DISABLED. Use the DescribeUser + * action to confirm the user state.

+ *

Deleting a user is permanent and cannot be undone. WorkMail archives user mailboxes for + * 30 days before they are permanently removed.

+ */ export class DeleteUserCommand extends $Command< DeleteUserCommandInput, DeleteUserCommandOutput, @@ -34,6 +41,9 @@ export class DeleteUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DeregisterFromWorkMailCommand.ts b/clients/client-workmail/commands/DeregisterFromWorkMailCommand.ts index 83cc8af8dc90f..77f52ac2e039c 100644 --- a/clients/client-workmail/commands/DeregisterFromWorkMailCommand.ts +++ b/clients/client-workmail/commands/DeregisterFromWorkMailCommand.ts @@ -20,6 +20,12 @@ import { export type DeregisterFromWorkMailCommandInput = DeregisterFromWorkMailRequest; export type DeregisterFromWorkMailCommandOutput = DeregisterFromWorkMailResponse & __MetadataBearer; +/** + *

Mark a user, group, or resource as no longer used in Amazon WorkMail. This action + * disassociates the mailbox and schedules it for clean-up. WorkMail keeps mailboxes for 30 days + * before they are permanently removed. The functionality in the console is + * Disable.

+ */ export class DeregisterFromWorkMailCommand extends $Command< DeregisterFromWorkMailCommandInput, DeregisterFromWorkMailCommandOutput, @@ -34,6 +40,9 @@ export class DeregisterFromWorkMailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DescribeGroupCommand.ts b/clients/client-workmail/commands/DescribeGroupCommand.ts index 472c2fabf1fb5..fb59477261cee 100644 --- a/clients/client-workmail/commands/DescribeGroupCommand.ts +++ b/clients/client-workmail/commands/DescribeGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeGroupCommandInput = DescribeGroupRequest; export type DescribeGroupCommandOutput = DescribeGroupResponse & __MetadataBearer; +/** + *

Returns the data available for the group.

+ */ export class DescribeGroupCommand extends $Command< DescribeGroupCommandInput, DescribeGroupCommandOutput, @@ -34,6 +37,9 @@ export class DescribeGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DescribeMailboxExportJobCommand.ts b/clients/client-workmail/commands/DescribeMailboxExportJobCommand.ts index f933d859da63c..7545129195ca7 100644 --- a/clients/client-workmail/commands/DescribeMailboxExportJobCommand.ts +++ b/clients/client-workmail/commands/DescribeMailboxExportJobCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeMailboxExportJobCommandInput = DescribeMailboxExportJobRequest; export type DescribeMailboxExportJobCommandOutput = DescribeMailboxExportJobResponse & __MetadataBearer; +/** + *

Describes the current status of a mailbox export job.

+ */ export class DescribeMailboxExportJobCommand extends $Command< DescribeMailboxExportJobCommandInput, DescribeMailboxExportJobCommandOutput, @@ -34,6 +37,9 @@ export class DescribeMailboxExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DescribeOrganizationCommand.ts b/clients/client-workmail/commands/DescribeOrganizationCommand.ts index 878ae0bd8da19..b678a646a9fb9 100644 --- a/clients/client-workmail/commands/DescribeOrganizationCommand.ts +++ b/clients/client-workmail/commands/DescribeOrganizationCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeOrganizationCommandInput = DescribeOrganizationRequest; export type DescribeOrganizationCommandOutput = DescribeOrganizationResponse & __MetadataBearer; +/** + *

Provides more information regarding a given organization based on its + * identifier.

+ */ export class DescribeOrganizationCommand extends $Command< DescribeOrganizationCommandInput, DescribeOrganizationCommandOutput, @@ -34,6 +38,9 @@ export class DescribeOrganizationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DescribeResourceCommand.ts b/clients/client-workmail/commands/DescribeResourceCommand.ts index 780fad1953ada..4dcac2528ab14 100644 --- a/clients/client-workmail/commands/DescribeResourceCommand.ts +++ b/clients/client-workmail/commands/DescribeResourceCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeResourceCommandInput = DescribeResourceRequest; export type DescribeResourceCommandOutput = DescribeResourceResponse & __MetadataBearer; +/** + *

Returns the data available for the resource.

+ */ export class DescribeResourceCommand extends $Command< DescribeResourceCommandInput, DescribeResourceCommandOutput, @@ -34,6 +37,9 @@ export class DescribeResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DescribeUserCommand.ts b/clients/client-workmail/commands/DescribeUserCommand.ts index eb83902481d54..6b3b35c2844f2 100644 --- a/clients/client-workmail/commands/DescribeUserCommand.ts +++ b/clients/client-workmail/commands/DescribeUserCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeUserCommandInput = DescribeUserRequest; export type DescribeUserCommandOutput = DescribeUserResponse & __MetadataBearer; +/** + *

Provides information regarding the user.

+ */ export class DescribeUserCommand extends $Command< DescribeUserCommandInput, DescribeUserCommandOutput, @@ -34,6 +37,9 @@ export class DescribeUserCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DisassociateDelegateFromResourceCommand.ts b/clients/client-workmail/commands/DisassociateDelegateFromResourceCommand.ts index e0c75e7051c38..bbc41af7cc7cd 100644 --- a/clients/client-workmail/commands/DisassociateDelegateFromResourceCommand.ts +++ b/clients/client-workmail/commands/DisassociateDelegateFromResourceCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateDelegateFromResourceCommandInput = DisassociateDelegateFromResourceRequest; export type DisassociateDelegateFromResourceCommandOutput = DisassociateDelegateFromResourceResponse & __MetadataBearer; +/** + *

Removes a member from the resource's set of delegates.

+ */ export class DisassociateDelegateFromResourceCommand extends $Command< DisassociateDelegateFromResourceCommandInput, DisassociateDelegateFromResourceCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateDelegateFromResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/DisassociateMemberFromGroupCommand.ts b/clients/client-workmail/commands/DisassociateMemberFromGroupCommand.ts index 4263491ae72d2..700868de7e2fd 100644 --- a/clients/client-workmail/commands/DisassociateMemberFromGroupCommand.ts +++ b/clients/client-workmail/commands/DisassociateMemberFromGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateMemberFromGroupCommandInput = DisassociateMemberFromGroupRequest; export type DisassociateMemberFromGroupCommandOutput = DisassociateMemberFromGroupResponse & __MetadataBearer; +/** + *

Removes a member from a group.

+ */ export class DisassociateMemberFromGroupCommand extends $Command< DisassociateMemberFromGroupCommandInput, DisassociateMemberFromGroupCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateMemberFromGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/GetAccessControlEffectCommand.ts b/clients/client-workmail/commands/GetAccessControlEffectCommand.ts index a1e6127d24ff1..dd366fcba3f3a 100644 --- a/clients/client-workmail/commands/GetAccessControlEffectCommand.ts +++ b/clients/client-workmail/commands/GetAccessControlEffectCommand.ts @@ -20,6 +20,10 @@ import { export type GetAccessControlEffectCommandInput = GetAccessControlEffectRequest; export type GetAccessControlEffectCommandOutput = GetAccessControlEffectResponse & __MetadataBearer; +/** + *

Gets the effects of an organization's access control rules as they apply to a + * specified IPv4 address, access protocol action, or user ID.

+ */ export class GetAccessControlEffectCommand extends $Command< GetAccessControlEffectCommandInput, GetAccessControlEffectCommandOutput, @@ -34,6 +38,9 @@ export class GetAccessControlEffectCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/GetDefaultRetentionPolicyCommand.ts b/clients/client-workmail/commands/GetDefaultRetentionPolicyCommand.ts index e3db80a8853b8..b58f0c7bbc0fd 100644 --- a/clients/client-workmail/commands/GetDefaultRetentionPolicyCommand.ts +++ b/clients/client-workmail/commands/GetDefaultRetentionPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type GetDefaultRetentionPolicyCommandInput = GetDefaultRetentionPolicyRequest; export type GetDefaultRetentionPolicyCommandOutput = GetDefaultRetentionPolicyResponse & __MetadataBearer; +/** + *

Gets the default retention policy details for the specified organization.

+ */ export class GetDefaultRetentionPolicyCommand extends $Command< GetDefaultRetentionPolicyCommandInput, GetDefaultRetentionPolicyCommandOutput, @@ -34,6 +37,9 @@ export class GetDefaultRetentionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/GetMailboxDetailsCommand.ts b/clients/client-workmail/commands/GetMailboxDetailsCommand.ts index 7635c916808dc..063582249fd14 100644 --- a/clients/client-workmail/commands/GetMailboxDetailsCommand.ts +++ b/clients/client-workmail/commands/GetMailboxDetailsCommand.ts @@ -20,6 +20,9 @@ import { export type GetMailboxDetailsCommandInput = GetMailboxDetailsRequest; export type GetMailboxDetailsCommandOutput = GetMailboxDetailsResponse & __MetadataBearer; +/** + *

Requests a user's mailbox details for a specified organization and user.

+ */ export class GetMailboxDetailsCommand extends $Command< GetMailboxDetailsCommandInput, GetMailboxDetailsCommandOutput, @@ -34,6 +37,9 @@ export class GetMailboxDetailsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListAccessControlRulesCommand.ts b/clients/client-workmail/commands/ListAccessControlRulesCommand.ts index 40b919d553896..eedaa0ec3167e 100644 --- a/clients/client-workmail/commands/ListAccessControlRulesCommand.ts +++ b/clients/client-workmail/commands/ListAccessControlRulesCommand.ts @@ -20,6 +20,9 @@ import { export type ListAccessControlRulesCommandInput = ListAccessControlRulesRequest; export type ListAccessControlRulesCommandOutput = ListAccessControlRulesResponse & __MetadataBearer; +/** + *

Lists the access control rules for the specified organization.

+ */ export class ListAccessControlRulesCommand extends $Command< ListAccessControlRulesCommandInput, ListAccessControlRulesCommandOutput, @@ -34,6 +37,9 @@ export class ListAccessControlRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListAliasesCommand.ts b/clients/client-workmail/commands/ListAliasesCommand.ts index 77a73ac3dbd5e..49dc02e2ce145 100644 --- a/clients/client-workmail/commands/ListAliasesCommand.ts +++ b/clients/client-workmail/commands/ListAliasesCommand.ts @@ -20,6 +20,10 @@ import { export type ListAliasesCommandInput = ListAliasesRequest; export type ListAliasesCommandOutput = ListAliasesResponse & __MetadataBearer; +/** + *

Creates a paginated call to list the aliases associated with a given + * entity.

+ */ export class ListAliasesCommand extends $Command< ListAliasesCommandInput, ListAliasesCommandOutput, @@ -34,6 +38,9 @@ export class ListAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListGroupMembersCommand.ts b/clients/client-workmail/commands/ListGroupMembersCommand.ts index c0d4c544a0fac..1da15e346f2c4 100644 --- a/clients/client-workmail/commands/ListGroupMembersCommand.ts +++ b/clients/client-workmail/commands/ListGroupMembersCommand.ts @@ -20,6 +20,10 @@ import { export type ListGroupMembersCommandInput = ListGroupMembersRequest; export type ListGroupMembersCommandOutput = ListGroupMembersResponse & __MetadataBearer; +/** + *

Returns an overview of the members of a group. Users and groups can be members of a + * group.

+ */ export class ListGroupMembersCommand extends $Command< ListGroupMembersCommandInput, ListGroupMembersCommandOutput, @@ -34,6 +38,9 @@ export class ListGroupMembersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListGroupsCommand.ts b/clients/client-workmail/commands/ListGroupsCommand.ts index de71ae2ff351e..4a349c6fe66b2 100644 --- a/clients/client-workmail/commands/ListGroupsCommand.ts +++ b/clients/client-workmail/commands/ListGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type ListGroupsCommandInput = ListGroupsRequest; export type ListGroupsCommandOutput = ListGroupsResponse & __MetadataBearer; +/** + *

Returns summaries of the organization's groups.

+ */ export class ListGroupsCommand extends $Command< ListGroupsCommandInput, ListGroupsCommandOutput, @@ -34,6 +37,9 @@ export class ListGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListMailboxExportJobsCommand.ts b/clients/client-workmail/commands/ListMailboxExportJobsCommand.ts index 30ee257e32be6..05a431d2722e2 100644 --- a/clients/client-workmail/commands/ListMailboxExportJobsCommand.ts +++ b/clients/client-workmail/commands/ListMailboxExportJobsCommand.ts @@ -20,6 +20,10 @@ import { export type ListMailboxExportJobsCommandInput = ListMailboxExportJobsRequest; export type ListMailboxExportJobsCommandOutput = ListMailboxExportJobsResponse & __MetadataBearer; +/** + *

Lists the mailbox export jobs started for the specified organization within the last + * seven days.

+ */ export class ListMailboxExportJobsCommand extends $Command< ListMailboxExportJobsCommandInput, ListMailboxExportJobsCommandOutput, @@ -34,6 +38,9 @@ export class ListMailboxExportJobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListMailboxPermissionsCommand.ts b/clients/client-workmail/commands/ListMailboxPermissionsCommand.ts index ee7862517404f..7ff05072cb13a 100644 --- a/clients/client-workmail/commands/ListMailboxPermissionsCommand.ts +++ b/clients/client-workmail/commands/ListMailboxPermissionsCommand.ts @@ -20,6 +20,10 @@ import { export type ListMailboxPermissionsCommandInput = ListMailboxPermissionsRequest; export type ListMailboxPermissionsCommandOutput = ListMailboxPermissionsResponse & __MetadataBearer; +/** + *

Lists the mailbox permissions associated with a user, group, or resource + * mailbox.

+ */ export class ListMailboxPermissionsCommand extends $Command< ListMailboxPermissionsCommandInput, ListMailboxPermissionsCommandOutput, @@ -34,6 +38,9 @@ export class ListMailboxPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListOrganizationsCommand.ts b/clients/client-workmail/commands/ListOrganizationsCommand.ts index 82710e4843c11..977ca87116a48 100644 --- a/clients/client-workmail/commands/ListOrganizationsCommand.ts +++ b/clients/client-workmail/commands/ListOrganizationsCommand.ts @@ -20,6 +20,9 @@ import { export type ListOrganizationsCommandInput = ListOrganizationsRequest; export type ListOrganizationsCommandOutput = ListOrganizationsResponse & __MetadataBearer; +/** + *

Returns summaries of the customer's organizations.

+ */ export class ListOrganizationsCommand extends $Command< ListOrganizationsCommandInput, ListOrganizationsCommandOutput, @@ -34,6 +37,9 @@ export class ListOrganizationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListResourceDelegatesCommand.ts b/clients/client-workmail/commands/ListResourceDelegatesCommand.ts index 3245de77883f9..c8eb387330644 100644 --- a/clients/client-workmail/commands/ListResourceDelegatesCommand.ts +++ b/clients/client-workmail/commands/ListResourceDelegatesCommand.ts @@ -20,6 +20,10 @@ import { export type ListResourceDelegatesCommandInput = ListResourceDelegatesRequest; export type ListResourceDelegatesCommandOutput = ListResourceDelegatesResponse & __MetadataBearer; +/** + *

Lists the delegates associated with a resource. Users and groups can be resource + * delegates and answer requests on behalf of the resource.

+ */ export class ListResourceDelegatesCommand extends $Command< ListResourceDelegatesCommandInput, ListResourceDelegatesCommandOutput, @@ -34,6 +38,9 @@ export class ListResourceDelegatesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListResourcesCommand.ts b/clients/client-workmail/commands/ListResourcesCommand.ts index 2da93bc961201..e15af0309e6a1 100644 --- a/clients/client-workmail/commands/ListResourcesCommand.ts +++ b/clients/client-workmail/commands/ListResourcesCommand.ts @@ -20,6 +20,9 @@ import { export type ListResourcesCommandInput = ListResourcesRequest; export type ListResourcesCommandOutput = ListResourcesResponse & __MetadataBearer; +/** + *

Returns summaries of the organization's resources.

+ */ export class ListResourcesCommand extends $Command< ListResourcesCommandInput, ListResourcesCommandOutput, @@ -34,6 +37,9 @@ export class ListResourcesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListTagsForResourceCommand.ts b/clients/client-workmail/commands/ListTagsForResourceCommand.ts index 5047a89a91eed..34e581e8f42ca 100644 --- a/clients/client-workmail/commands/ListTagsForResourceCommand.ts +++ b/clients/client-workmail/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Lists the tags applied to an Amazon WorkMail organization resource.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ListUsersCommand.ts b/clients/client-workmail/commands/ListUsersCommand.ts index e19ab77fe42c7..d3e976b67482a 100644 --- a/clients/client-workmail/commands/ListUsersCommand.ts +++ b/clients/client-workmail/commands/ListUsersCommand.ts @@ -17,6 +17,9 @@ import { export type ListUsersCommandInput = ListUsersRequest; export type ListUsersCommandOutput = ListUsersResponse & __MetadataBearer; +/** + *

Returns summaries of the organization's users.

+ */ export class ListUsersCommand extends $Command< ListUsersCommandInput, ListUsersCommandOutput, @@ -31,6 +34,9 @@ export class ListUsersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/PutAccessControlRuleCommand.ts b/clients/client-workmail/commands/PutAccessControlRuleCommand.ts index 7681213adcc10..b4f9ba5764f92 100644 --- a/clients/client-workmail/commands/PutAccessControlRuleCommand.ts +++ b/clients/client-workmail/commands/PutAccessControlRuleCommand.ts @@ -20,6 +20,12 @@ import { export type PutAccessControlRuleCommandInput = PutAccessControlRuleRequest; export type PutAccessControlRuleCommandOutput = PutAccessControlRuleResponse & __MetadataBearer; +/** + *

Adds a new access control rule for the specified organization. The rule allows or + * denies access to the organization for the specified IPv4 addresses, access protocol + * actions, and user IDs. Adding a new rule with the same name as an existing rule replaces + * the older rule.

+ */ export class PutAccessControlRuleCommand extends $Command< PutAccessControlRuleCommandInput, PutAccessControlRuleCommandOutput, @@ -34,6 +40,9 @@ export class PutAccessControlRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/PutMailboxPermissionsCommand.ts b/clients/client-workmail/commands/PutMailboxPermissionsCommand.ts index 901a05c4e290a..1f67b984e6701 100644 --- a/clients/client-workmail/commands/PutMailboxPermissionsCommand.ts +++ b/clients/client-workmail/commands/PutMailboxPermissionsCommand.ts @@ -20,6 +20,10 @@ import { export type PutMailboxPermissionsCommandInput = PutMailboxPermissionsRequest; export type PutMailboxPermissionsCommandOutput = PutMailboxPermissionsResponse & __MetadataBearer; +/** + *

Sets permissions for a user, group, or resource. This replaces any pre-existing + * permissions.

+ */ export class PutMailboxPermissionsCommand extends $Command< PutMailboxPermissionsCommandInput, PutMailboxPermissionsCommandOutput, @@ -34,6 +38,9 @@ export class PutMailboxPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/PutRetentionPolicyCommand.ts b/clients/client-workmail/commands/PutRetentionPolicyCommand.ts index 799fc5548348f..9a4e79d9e0886 100644 --- a/clients/client-workmail/commands/PutRetentionPolicyCommand.ts +++ b/clients/client-workmail/commands/PutRetentionPolicyCommand.ts @@ -20,6 +20,9 @@ import { export type PutRetentionPolicyCommandInput = PutRetentionPolicyRequest; export type PutRetentionPolicyCommandOutput = PutRetentionPolicyResponse & __MetadataBearer; +/** + *

Puts a retention policy to the specified organization.

+ */ export class PutRetentionPolicyCommand extends $Command< PutRetentionPolicyCommandInput, PutRetentionPolicyCommandOutput, @@ -34,6 +37,9 @@ export class PutRetentionPolicyCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/RegisterToWorkMailCommand.ts b/clients/client-workmail/commands/RegisterToWorkMailCommand.ts index e8e065bffc12d..4830ba7aeda82 100644 --- a/clients/client-workmail/commands/RegisterToWorkMailCommand.ts +++ b/clients/client-workmail/commands/RegisterToWorkMailCommand.ts @@ -20,6 +20,15 @@ import { export type RegisterToWorkMailCommandInput = RegisterToWorkMailRequest; export type RegisterToWorkMailCommandOutput = RegisterToWorkMailResponse & __MetadataBearer; +/** + *

Registers an existing and disabled user, group, or resource for Amazon WorkMail use by + * associating a mailbox and calendaring capabilities. It performs no change if the user, + * group, or resource is enabled and fails if the user, group, or resource is deleted. This + * operation results in the accumulation of costs. For more information, see Pricing. The equivalent console + * functionality for this operation is Enable.

+ *

Users can either be created by calling the CreateUser API operation + * or they can be synchronized from your directory. For more information, see DeregisterFromWorkMail.

+ */ export class RegisterToWorkMailCommand extends $Command< RegisterToWorkMailCommandInput, RegisterToWorkMailCommandOutput, @@ -34,6 +43,9 @@ export class RegisterToWorkMailCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/ResetPasswordCommand.ts b/clients/client-workmail/commands/ResetPasswordCommand.ts index 4ab7db105f897..40162280b6112 100644 --- a/clients/client-workmail/commands/ResetPasswordCommand.ts +++ b/clients/client-workmail/commands/ResetPasswordCommand.ts @@ -20,6 +20,9 @@ import { export type ResetPasswordCommandInput = ResetPasswordRequest; export type ResetPasswordCommandOutput = ResetPasswordResponse & __MetadataBearer; +/** + *

Allows the administrator to reset the password for a user.

+ */ export class ResetPasswordCommand extends $Command< ResetPasswordCommandInput, ResetPasswordCommandOutput, @@ -34,6 +37,9 @@ export class ResetPasswordCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/StartMailboxExportJobCommand.ts b/clients/client-workmail/commands/StartMailboxExportJobCommand.ts index f23a26ac99bd0..1cd0092781cbb 100644 --- a/clients/client-workmail/commands/StartMailboxExportJobCommand.ts +++ b/clients/client-workmail/commands/StartMailboxExportJobCommand.ts @@ -20,6 +20,12 @@ import { export type StartMailboxExportJobCommandInput = StartMailboxExportJobRequest; export type StartMailboxExportJobCommandOutput = StartMailboxExportJobResponse & __MetadataBearer; +/** + *

Starts a mailbox export job to export MIME-format email messages and calendar items + * from the specified mailbox to the specified Amazon Simple Storage Service (Amazon S3) + * bucket. For more information, see Exporting mailbox content in + * the Amazon WorkMail Administrator Guide.

+ */ export class StartMailboxExportJobCommand extends $Command< StartMailboxExportJobCommandInput, StartMailboxExportJobCommandOutput, @@ -34,6 +40,9 @@ export class StartMailboxExportJobCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/TagResourceCommand.ts b/clients/client-workmail/commands/TagResourceCommand.ts index 826612262dea1..50dedb2475073 100644 --- a/clients/client-workmail/commands/TagResourceCommand.ts +++ b/clients/client-workmail/commands/TagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Applies the specified tags to the specified Amazon WorkMail organization + * resource.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +38,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/UntagResourceCommand.ts b/clients/client-workmail/commands/UntagResourceCommand.ts index 0dd32b0aed2a0..8652785b0a4d4 100644 --- a/clients/client-workmail/commands/UntagResourceCommand.ts +++ b/clients/client-workmail/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Untags the specified tags from the specified Amazon WorkMail organization + * resource.

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/UpdateMailboxQuotaCommand.ts b/clients/client-workmail/commands/UpdateMailboxQuotaCommand.ts index 9a2a98ee6db45..0cdeae2632044 100644 --- a/clients/client-workmail/commands/UpdateMailboxQuotaCommand.ts +++ b/clients/client-workmail/commands/UpdateMailboxQuotaCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateMailboxQuotaCommandInput = UpdateMailboxQuotaRequest; export type UpdateMailboxQuotaCommandOutput = UpdateMailboxQuotaResponse & __MetadataBearer; +/** + *

Updates a user's current mailbox quota for a specified organization and + * user.

+ */ export class UpdateMailboxQuotaCommand extends $Command< UpdateMailboxQuotaCommandInput, UpdateMailboxQuotaCommandOutput, @@ -34,6 +38,9 @@ export class UpdateMailboxQuotaCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/UpdatePrimaryEmailAddressCommand.ts b/clients/client-workmail/commands/UpdatePrimaryEmailAddressCommand.ts index 1d8abf524a1ea..a49de3b43acc4 100644 --- a/clients/client-workmail/commands/UpdatePrimaryEmailAddressCommand.ts +++ b/clients/client-workmail/commands/UpdatePrimaryEmailAddressCommand.ts @@ -20,6 +20,11 @@ import { export type UpdatePrimaryEmailAddressCommandInput = UpdatePrimaryEmailAddressRequest; export type UpdatePrimaryEmailAddressCommandOutput = UpdatePrimaryEmailAddressResponse & __MetadataBearer; +/** + *

Updates the primary email for a user, group, or resource. The current email is moved + * into the list of aliases (or swapped between an existing alias and the current primary + * email), and the email provided in the input is promoted as the primary.

+ */ export class UpdatePrimaryEmailAddressCommand extends $Command< UpdatePrimaryEmailAddressCommandInput, UpdatePrimaryEmailAddressCommandOutput, @@ -34,6 +39,9 @@ export class UpdatePrimaryEmailAddressCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/commands/UpdateResourceCommand.ts b/clients/client-workmail/commands/UpdateResourceCommand.ts index 181952803cd6b..fcfc45af34c68 100644 --- a/clients/client-workmail/commands/UpdateResourceCommand.ts +++ b/clients/client-workmail/commands/UpdateResourceCommand.ts @@ -20,6 +20,11 @@ import { export type UpdateResourceCommandInput = UpdateResourceRequest; export type UpdateResourceCommandOutput = UpdateResourceResponse & __MetadataBearer; +/** + *

Updates data for the resource. To have the latest information, it must be preceded by + * a DescribeResource call. The dataset in the request should be the one + * expected when performing another DescribeResource call.

+ */ export class UpdateResourceCommand extends $Command< UpdateResourceCommandInput, UpdateResourceCommandOutput, @@ -34,6 +39,9 @@ export class UpdateResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailClientResolvedConfig, diff --git a/clients/client-workmail/package.json b/clients/client-workmail/package.json index 2bb44f84e27a8..424d6a68a127c 100644 --- a/clients/client-workmail/package.json +++ b/clients/client-workmail/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Workmail Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-workmail/pagination/ListAliasesPaginator.ts b/clients/client-workmail/pagination/ListAliasesPaginator.ts index 6558a8a12bc90..c1bdfcda256ac 100644 --- a/clients/client-workmail/pagination/ListAliasesPaginator.ts +++ b/clients/client-workmail/pagination/ListAliasesPaginator.ts @@ -4,6 +4,9 @@ import { ListAliasesCommand, ListAliasesCommandInput, ListAliasesCommandOutput } import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListAliasesCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListAliasesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListAliasesCommandInput, diff --git a/clients/client-workmail/pagination/ListGroupMembersPaginator.ts b/clients/client-workmail/pagination/ListGroupMembersPaginator.ts index e24b30cb9e9fb..97105b1b0bd5d 100644 --- a/clients/client-workmail/pagination/ListGroupMembersPaginator.ts +++ b/clients/client-workmail/pagination/ListGroupMembersPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListGroupMembersCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupMembersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListGroupMembersCommandInput, diff --git a/clients/client-workmail/pagination/ListGroupsPaginator.ts b/clients/client-workmail/pagination/ListGroupsPaginator.ts index b9de6644ad8d4..a5fc848726608 100644 --- a/clients/client-workmail/pagination/ListGroupsPaginator.ts +++ b/clients/client-workmail/pagination/ListGroupsPaginator.ts @@ -4,6 +4,9 @@ import { ListGroupsCommand, ListGroupsCommandInput, ListGroupsCommandOutput } fr import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListGroupsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListGroupsCommandInput, diff --git a/clients/client-workmail/pagination/ListMailboxExportJobsPaginator.ts b/clients/client-workmail/pagination/ListMailboxExportJobsPaginator.ts index 677dc289f0ca2..96883d8d973e3 100644 --- a/clients/client-workmail/pagination/ListMailboxExportJobsPaginator.ts +++ b/clients/client-workmail/pagination/ListMailboxExportJobsPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListMailboxExportJobsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMailboxExportJobsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListMailboxExportJobsCommandInput, diff --git a/clients/client-workmail/pagination/ListMailboxPermissionsPaginator.ts b/clients/client-workmail/pagination/ListMailboxPermissionsPaginator.ts index 4f17fb033e710..4e60a0e2ba029 100644 --- a/clients/client-workmail/pagination/ListMailboxPermissionsPaginator.ts +++ b/clients/client-workmail/pagination/ListMailboxPermissionsPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListMailboxPermissionsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListMailboxPermissionsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListMailboxPermissionsCommandInput, diff --git a/clients/client-workmail/pagination/ListOrganizationsPaginator.ts b/clients/client-workmail/pagination/ListOrganizationsPaginator.ts index eaad8287c4a0d..0a13c9f49b149 100644 --- a/clients/client-workmail/pagination/ListOrganizationsPaginator.ts +++ b/clients/client-workmail/pagination/ListOrganizationsPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListOrganizationsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListOrganizationsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListOrganizationsCommandInput, diff --git a/clients/client-workmail/pagination/ListResourceDelegatesPaginator.ts b/clients/client-workmail/pagination/ListResourceDelegatesPaginator.ts index 3c30adcbcf45f..ac2b046343ed8 100644 --- a/clients/client-workmail/pagination/ListResourceDelegatesPaginator.ts +++ b/clients/client-workmail/pagination/ListResourceDelegatesPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListResourceDelegatesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourceDelegatesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListResourceDelegatesCommandInput, diff --git a/clients/client-workmail/pagination/ListResourcesPaginator.ts b/clients/client-workmail/pagination/ListResourcesPaginator.ts index fdf1bb1754c18..e3111bf8622f6 100644 --- a/clients/client-workmail/pagination/ListResourcesPaginator.ts +++ b/clients/client-workmail/pagination/ListResourcesPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListResourcesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListResourcesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListResourcesCommandInput, diff --git a/clients/client-workmail/pagination/ListUsersPaginator.ts b/clients/client-workmail/pagination/ListUsersPaginator.ts index 44167aac2bc6a..9fd5c75e13a78 100644 --- a/clients/client-workmail/pagination/ListUsersPaginator.ts +++ b/clients/client-workmail/pagination/ListUsersPaginator.ts @@ -4,6 +4,9 @@ import { ListUsersCommand, ListUsersCommandInput, ListUsersCommandOutput } from import { WorkMailPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkMailClient, input: ListUsersCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new ListUsersCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkMail, input: ListUsersCommandInput, diff --git a/clients/client-workmail/runtimeConfig.browser.ts b/clients/client-workmail/runtimeConfig.browser.ts index 4b902401e0e9f..bc945fd483c9b 100644 --- a/clients/client-workmail/runtimeConfig.browser.ts +++ b/clients/client-workmail/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./WorkMailClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-workmail/runtimeConfig.native.ts b/clients/client-workmail/runtimeConfig.native.ts index ac039058e2a12..267f6a91b508a 100644 --- a/clients/client-workmail/runtimeConfig.native.ts +++ b/clients/client-workmail/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./WorkMailClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-workmail/runtimeConfig.shared.ts b/clients/client-workmail/runtimeConfig.shared.ts index f5cc004b39cf8..d1faf1c78b044 100644 --- a/clients/client-workmail/runtimeConfig.shared.ts +++ b/clients/client-workmail/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2017-10-01", disableHostPrefix: false, diff --git a/clients/client-workmail/runtimeConfig.ts b/clients/client-workmail/runtimeConfig.ts index e22e5806e307d..c7312806cff04 100644 --- a/clients/client-workmail/runtimeConfig.ts +++ b/clients/client-workmail/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./WorkMailClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-workmail/tsconfig.json b/clients/client-workmail/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-workmail/tsconfig.json +++ b/clients/client-workmail/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-workmailmessageflow/commands/GetRawMessageContentCommand.ts b/clients/client-workmailmessageflow/commands/GetRawMessageContentCommand.ts index 753bc735a5bbd..c1cd031b78284 100644 --- a/clients/client-workmailmessageflow/commands/GetRawMessageContentCommand.ts +++ b/clients/client-workmailmessageflow/commands/GetRawMessageContentCommand.ts @@ -24,6 +24,9 @@ import { export type GetRawMessageContentCommandInput = GetRawMessageContentRequest; export type GetRawMessageContentCommandOutput = GetRawMessageContentResponse & __MetadataBearer; +/** + *

Retrieves the raw content of an in-transit email message, in MIME format.

+ */ export class GetRawMessageContentCommand extends $Command< GetRawMessageContentCommandInput, GetRawMessageContentCommandOutput, @@ -38,6 +41,9 @@ export class GetRawMessageContentCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkMailMessageFlowClientResolvedConfig, diff --git a/clients/client-workmailmessageflow/package.json b/clients/client-workmailmessageflow/package.json index 819a82f50160f..32531badfd8b3 100644 --- a/clients/client-workmailmessageflow/package.json +++ b/clients/client-workmailmessageflow/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Workmailmessageflow Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-workmailmessageflow/runtimeConfig.browser.ts b/clients/client-workmailmessageflow/runtimeConfig.browser.ts index 51553b609cb41..43c66da3fef8d 100644 --- a/clients/client-workmailmessageflow/runtimeConfig.browser.ts +++ b/clients/client-workmailmessageflow/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./WorkMailMessageFlowClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-workmailmessageflow/runtimeConfig.native.ts b/clients/client-workmailmessageflow/runtimeConfig.native.ts index 63602dd17e072..80b3d31ae9176 100644 --- a/clients/client-workmailmessageflow/runtimeConfig.native.ts +++ b/clients/client-workmailmessageflow/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./WorkMailMessageFlowClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-workmailmessageflow/runtimeConfig.shared.ts b/clients/client-workmailmessageflow/runtimeConfig.shared.ts index e7600646059a3..23cab70a79ad3 100644 --- a/clients/client-workmailmessageflow/runtimeConfig.shared.ts +++ b/clients/client-workmailmessageflow/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-05-01", disableHostPrefix: false, diff --git a/clients/client-workmailmessageflow/runtimeConfig.ts b/clients/client-workmailmessageflow/runtimeConfig.ts index 5a594a883603a..f3a1a8530e1bc 100644 --- a/clients/client-workmailmessageflow/runtimeConfig.ts +++ b/clients/client-workmailmessageflow/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./WorkMailMessageFlowClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-workmailmessageflow/tsconfig.json b/clients/client-workmailmessageflow/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-workmailmessageflow/tsconfig.json +++ b/clients/client-workmailmessageflow/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-workspaces/commands/AssociateConnectionAliasCommand.ts b/clients/client-workspaces/commands/AssociateConnectionAliasCommand.ts index a28c719859066..1be456d114756 100644 --- a/clients/client-workspaces/commands/AssociateConnectionAliasCommand.ts +++ b/clients/client-workspaces/commands/AssociateConnectionAliasCommand.ts @@ -20,6 +20,16 @@ import { export type AssociateConnectionAliasCommandInput = AssociateConnectionAliasRequest; export type AssociateConnectionAliasCommandOutput = AssociateConnectionAliasResult & __MetadataBearer; +/** + *

Associates the specified connection alias with the specified directory to enable cross-Region redirection. + * For more information, see + * Cross-Region Redirection for Amazon WorkSpaces.

+ * + * + *

Before performing this operation, call + * DescribeConnectionAliases to make sure that the current state of the connection alias is CREATED.

+ *
+ */ export class AssociateConnectionAliasCommand extends $Command< AssociateConnectionAliasCommandInput, AssociateConnectionAliasCommandOutput, @@ -34,6 +44,9 @@ export class AssociateConnectionAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/AssociateIpGroupsCommand.ts b/clients/client-workspaces/commands/AssociateIpGroupsCommand.ts index 501e42e3ad720..a08d4a56277fe 100644 --- a/clients/client-workspaces/commands/AssociateIpGroupsCommand.ts +++ b/clients/client-workspaces/commands/AssociateIpGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type AssociateIpGroupsCommandInput = AssociateIpGroupsRequest; export type AssociateIpGroupsCommandOutput = AssociateIpGroupsResult & __MetadataBearer; +/** + *

Associates the specified IP access control group with the specified directory.

+ */ export class AssociateIpGroupsCommand extends $Command< AssociateIpGroupsCommandInput, AssociateIpGroupsCommandOutput, @@ -34,6 +37,9 @@ export class AssociateIpGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/AuthorizeIpRulesCommand.ts b/clients/client-workspaces/commands/AuthorizeIpRulesCommand.ts index dfd9dbe21dd67..08d4fb824509b 100644 --- a/clients/client-workspaces/commands/AuthorizeIpRulesCommand.ts +++ b/clients/client-workspaces/commands/AuthorizeIpRulesCommand.ts @@ -20,6 +20,11 @@ import { export type AuthorizeIpRulesCommandInput = AuthorizeIpRulesRequest; export type AuthorizeIpRulesCommandOutput = AuthorizeIpRulesResult & __MetadataBearer; +/** + *

Adds one or more rules to the specified IP access control group.

+ *

This action gives users permission to access their WorkSpaces from the CIDR address + * ranges specified in the rules.

+ */ export class AuthorizeIpRulesCommand extends $Command< AuthorizeIpRulesCommandInput, AuthorizeIpRulesCommandOutput, @@ -34,6 +39,9 @@ export class AuthorizeIpRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/CopyWorkspaceImageCommand.ts b/clients/client-workspaces/commands/CopyWorkspaceImageCommand.ts index 5e8052b4d4026..2b0b50f49161b 100644 --- a/clients/client-workspaces/commands/CopyWorkspaceImageCommand.ts +++ b/clients/client-workspaces/commands/CopyWorkspaceImageCommand.ts @@ -20,6 +20,18 @@ import { export type CopyWorkspaceImageCommandInput = CopyWorkspaceImageRequest; export type CopyWorkspaceImageCommandOutput = CopyWorkspaceImageResult & __MetadataBearer; +/** + *

Copies the specified image from the specified Region to the current Region. + * For more information about copying images, see + * + * Copy a Custom WorkSpaces Image.

+ * + * + *

Before copying a shared image, be sure to verify that it has been shared from the + * correct AWS account. To determine if an image has been shared and to see the AWS + * account ID that owns an image, use the DescribeWorkSpaceImages and DescribeWorkspaceImagePermissions API operations.

+ *
+ */ export class CopyWorkspaceImageCommand extends $Command< CopyWorkspaceImageCommandInput, CopyWorkspaceImageCommandOutput, @@ -34,6 +46,9 @@ export class CopyWorkspaceImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/CreateConnectionAliasCommand.ts b/clients/client-workspaces/commands/CreateConnectionAliasCommand.ts index fa2da71691f3e..3057b12238b80 100644 --- a/clients/client-workspaces/commands/CreateConnectionAliasCommand.ts +++ b/clients/client-workspaces/commands/CreateConnectionAliasCommand.ts @@ -20,6 +20,11 @@ import { export type CreateConnectionAliasCommandInput = CreateConnectionAliasRequest; export type CreateConnectionAliasCommandOutput = CreateConnectionAliasResult & __MetadataBearer; +/** + *

Creates the specified connection alias for use with cross-Region redirection. For more information, see + * + * Cross-Region Redirection for Amazon WorkSpaces.

+ */ export class CreateConnectionAliasCommand extends $Command< CreateConnectionAliasCommandInput, CreateConnectionAliasCommandOutput, @@ -34,6 +39,9 @@ export class CreateConnectionAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/CreateIpGroupCommand.ts b/clients/client-workspaces/commands/CreateIpGroupCommand.ts index 1da1fc8405deb..fc9371e1c9483 100644 --- a/clients/client-workspaces/commands/CreateIpGroupCommand.ts +++ b/clients/client-workspaces/commands/CreateIpGroupCommand.ts @@ -20,6 +20,18 @@ import { export type CreateIpGroupCommandInput = CreateIpGroupRequest; export type CreateIpGroupCommandOutput = CreateIpGroupResult & __MetadataBearer; +/** + *

Creates an IP access control group.

+ *

An IP access control group provides you with the ability to control the IP addresses + * from which users are allowed to access their WorkSpaces. To specify the CIDR address + * ranges, add rules to your IP access control group and then associate the group with your + * directory. You can add rules when you create the group or at any time using AuthorizeIpRules.

+ * + *

There is a default IP access control group associated with your directory. If you don't + * associate an IP access control group with your directory, the default group is used. The + * default group includes a default rule that allows users to access their WorkSpaces from + * anywhere. You cannot modify the default IP access control group for your directory.

+ */ export class CreateIpGroupCommand extends $Command< CreateIpGroupCommandInput, CreateIpGroupCommandOutput, @@ -34,6 +46,9 @@ export class CreateIpGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/CreateTagsCommand.ts b/clients/client-workspaces/commands/CreateTagsCommand.ts index 2459a6b67b5b7..f3313befb1896 100644 --- a/clients/client-workspaces/commands/CreateTagsCommand.ts +++ b/clients/client-workspaces/commands/CreateTagsCommand.ts @@ -20,6 +20,9 @@ import { export type CreateTagsCommandInput = CreateTagsRequest; export type CreateTagsCommandOutput = CreateTagsResult & __MetadataBearer; +/** + *

Creates the specified tags for the specified WorkSpaces resource.

+ */ export class CreateTagsCommand extends $Command< CreateTagsCommandInput, CreateTagsCommandOutput, @@ -34,6 +37,9 @@ export class CreateTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/CreateWorkspacesCommand.ts b/clients/client-workspaces/commands/CreateWorkspacesCommand.ts index a70027139d909..535ddfc4d4859 100644 --- a/clients/client-workspaces/commands/CreateWorkspacesCommand.ts +++ b/clients/client-workspaces/commands/CreateWorkspacesCommand.ts @@ -20,6 +20,10 @@ import { export type CreateWorkspacesCommandInput = CreateWorkspacesRequest; export type CreateWorkspacesCommandOutput = CreateWorkspacesResult & __MetadataBearer; +/** + *

Creates one or more WorkSpaces.

+ *

This operation is asynchronous and returns before the WorkSpaces are created.

+ */ export class CreateWorkspacesCommand extends $Command< CreateWorkspacesCommandInput, CreateWorkspacesCommandOutput, @@ -34,6 +38,9 @@ export class CreateWorkspacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DeleteConnectionAliasCommand.ts b/clients/client-workspaces/commands/DeleteConnectionAliasCommand.ts index 5e102e75a5d5a..0057d3de7358f 100644 --- a/clients/client-workspaces/commands/DeleteConnectionAliasCommand.ts +++ b/clients/client-workspaces/commands/DeleteConnectionAliasCommand.ts @@ -20,6 +20,26 @@ import { export type DeleteConnectionAliasCommandInput = DeleteConnectionAliasRequest; export type DeleteConnectionAliasCommandOutput = DeleteConnectionAliasResult & __MetadataBearer; +/** + *

Deletes the specified connection alias. For more information, see + * Cross-Region Redirection for Amazon WorkSpaces.

+ * + * + *

+ * If you will no longer be using a fully qualified domain name (FQDN) as the registration code + * for your WorkSpaces users, you must take certain precautions to prevent potential security issues. + * For more information, see + * + * Security Considerations if You Stop Using Cross-Region Redirection.

+ *
+ * + * + *

To delete a connection alias that has been shared, the shared account must first disassociate the connection alias + * from any directories it has been associated with. Then you must unshare the connection alias from the account it has + * been shared with. You can delete a connection alias only after it is no longer shared with any accounts or + * associated with any directories.

+ *
+ */ export class DeleteConnectionAliasCommand extends $Command< DeleteConnectionAliasCommandInput, DeleteConnectionAliasCommandOutput, @@ -34,6 +54,9 @@ export class DeleteConnectionAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DeleteIpGroupCommand.ts b/clients/client-workspaces/commands/DeleteIpGroupCommand.ts index d1d42c17b788d..65daee2e79918 100644 --- a/clients/client-workspaces/commands/DeleteIpGroupCommand.ts +++ b/clients/client-workspaces/commands/DeleteIpGroupCommand.ts @@ -20,6 +20,10 @@ import { export type DeleteIpGroupCommandInput = DeleteIpGroupRequest; export type DeleteIpGroupCommandOutput = DeleteIpGroupResult & __MetadataBearer; +/** + *

Deletes the specified IP access control group.

+ *

You cannot delete an IP access control group that is associated with a directory.

+ */ export class DeleteIpGroupCommand extends $Command< DeleteIpGroupCommandInput, DeleteIpGroupCommandOutput, @@ -34,6 +38,9 @@ export class DeleteIpGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DeleteTagsCommand.ts b/clients/client-workspaces/commands/DeleteTagsCommand.ts index 028cce95664fd..12fd0153f157e 100644 --- a/clients/client-workspaces/commands/DeleteTagsCommand.ts +++ b/clients/client-workspaces/commands/DeleteTagsCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteTagsCommandInput = DeleteTagsRequest; export type DeleteTagsCommandOutput = DeleteTagsResult & __MetadataBearer; +/** + *

Deletes the specified tags from the specified WorkSpaces resource.

+ */ export class DeleteTagsCommand extends $Command< DeleteTagsCommandInput, DeleteTagsCommandOutput, @@ -34,6 +37,9 @@ export class DeleteTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DeleteWorkspaceImageCommand.ts b/clients/client-workspaces/commands/DeleteWorkspaceImageCommand.ts index 9ab47038fd051..5bdc46cb9e78c 100644 --- a/clients/client-workspaces/commands/DeleteWorkspaceImageCommand.ts +++ b/clients/client-workspaces/commands/DeleteWorkspaceImageCommand.ts @@ -20,6 +20,11 @@ import { export type DeleteWorkspaceImageCommandInput = DeleteWorkspaceImageRequest; export type DeleteWorkspaceImageCommandOutput = DeleteWorkspaceImageResult & __MetadataBearer; +/** + *

Deletes the specified image from your account. To delete an image, you must first delete + * any bundles that are associated with the image and unshare the image if it is shared with + * other accounts.

+ */ export class DeleteWorkspaceImageCommand extends $Command< DeleteWorkspaceImageCommandInput, DeleteWorkspaceImageCommandOutput, @@ -34,6 +39,9 @@ export class DeleteWorkspaceImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DeregisterWorkspaceDirectoryCommand.ts b/clients/client-workspaces/commands/DeregisterWorkspaceDirectoryCommand.ts index aeff262f1c76a..8a2dfbf4ec279 100644 --- a/clients/client-workspaces/commands/DeregisterWorkspaceDirectoryCommand.ts +++ b/clients/client-workspaces/commands/DeregisterWorkspaceDirectoryCommand.ts @@ -20,6 +20,11 @@ import { export type DeregisterWorkspaceDirectoryCommandInput = DeregisterWorkspaceDirectoryRequest; export type DeregisterWorkspaceDirectoryCommandOutput = DeregisterWorkspaceDirectoryResult & __MetadataBearer; +/** + *

Deregisters the specified directory. This operation is asynchronous + * and returns before the WorkSpace directory is deregistered. If any WorkSpaces are + * registered to this directory, you must remove them before you can deregister the directory.

+ */ export class DeregisterWorkspaceDirectoryCommand extends $Command< DeregisterWorkspaceDirectoryCommandInput, DeregisterWorkspaceDirectoryCommandOutput, @@ -34,6 +39,9 @@ export class DeregisterWorkspaceDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeAccountCommand.ts b/clients/client-workspaces/commands/DescribeAccountCommand.ts index 045d31192d1c6..f8af050b3b699 100644 --- a/clients/client-workspaces/commands/DescribeAccountCommand.ts +++ b/clients/client-workspaces/commands/DescribeAccountCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAccountCommandInput = DescribeAccountRequest; export type DescribeAccountCommandOutput = DescribeAccountResult & __MetadataBearer; +/** + *

Retrieves a list that describes the configuration of Bring Your Own License (BYOL) for + * the specified account.

+ */ export class DescribeAccountCommand extends $Command< DescribeAccountCommandInput, DescribeAccountCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeAccountModificationsCommand.ts b/clients/client-workspaces/commands/DescribeAccountModificationsCommand.ts index c63744700552d..5748471e386be 100644 --- a/clients/client-workspaces/commands/DescribeAccountModificationsCommand.ts +++ b/clients/client-workspaces/commands/DescribeAccountModificationsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeAccountModificationsCommandInput = DescribeAccountModificationsRequest; export type DescribeAccountModificationsCommandOutput = DescribeAccountModificationsResult & __MetadataBearer; +/** + *

Retrieves a list that describes modifications to the configuration of Bring Your Own + * License (BYOL) for the specified account.

+ */ export class DescribeAccountModificationsCommand extends $Command< DescribeAccountModificationsCommandInput, DescribeAccountModificationsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeAccountModificationsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeClientPropertiesCommand.ts b/clients/client-workspaces/commands/DescribeClientPropertiesCommand.ts index 7e26ae0ce3e8c..f0ea376620b5a 100644 --- a/clients/client-workspaces/commands/DescribeClientPropertiesCommand.ts +++ b/clients/client-workspaces/commands/DescribeClientPropertiesCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeClientPropertiesCommandInput = DescribeClientPropertiesRequest; export type DescribeClientPropertiesCommandOutput = DescribeClientPropertiesResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more specified Amazon WorkSpaces clients.

+ */ export class DescribeClientPropertiesCommand extends $Command< DescribeClientPropertiesCommandInput, DescribeClientPropertiesCommandOutput, @@ -34,6 +37,9 @@ export class DescribeClientPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeConnectionAliasPermissionsCommand.ts b/clients/client-workspaces/commands/DescribeConnectionAliasPermissionsCommand.ts index 478f03a76f7f4..2082c29731977 100644 --- a/clients/client-workspaces/commands/DescribeConnectionAliasPermissionsCommand.ts +++ b/clients/client-workspaces/commands/DescribeConnectionAliasPermissionsCommand.ts @@ -24,6 +24,11 @@ export type DescribeConnectionAliasPermissionsCommandInput = DescribeConnectionA export type DescribeConnectionAliasPermissionsCommandOutput = DescribeConnectionAliasPermissionsResult & __MetadataBearer; +/** + *

Describes the permissions that the owner of a connection alias has granted to another AWS account for + * the specified connection alias. For more information, see + * Cross-Region Redirection for Amazon WorkSpaces.

+ */ export class DescribeConnectionAliasPermissionsCommand extends $Command< DescribeConnectionAliasPermissionsCommandInput, DescribeConnectionAliasPermissionsCommandOutput, @@ -38,6 +43,9 @@ export class DescribeConnectionAliasPermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeConnectionAliasesCommand.ts b/clients/client-workspaces/commands/DescribeConnectionAliasesCommand.ts index 1af145204d621..5e02023ce164c 100644 --- a/clients/client-workspaces/commands/DescribeConnectionAliasesCommand.ts +++ b/clients/client-workspaces/commands/DescribeConnectionAliasesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeConnectionAliasesCommandInput = DescribeConnectionAliasesRequest; export type DescribeConnectionAliasesCommandOutput = DescribeConnectionAliasesResult & __MetadataBearer; +/** + *

Retrieves a list that describes the connection aliases used for cross-Region redirection. For more information, see + * + * Cross-Region Redirection for Amazon WorkSpaces.

+ */ export class DescribeConnectionAliasesCommand extends $Command< DescribeConnectionAliasesCommandInput, DescribeConnectionAliasesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeConnectionAliasesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeIpGroupsCommand.ts b/clients/client-workspaces/commands/DescribeIpGroupsCommand.ts index 22460bd18023b..4f7d66c79c3f1 100644 --- a/clients/client-workspaces/commands/DescribeIpGroupsCommand.ts +++ b/clients/client-workspaces/commands/DescribeIpGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeIpGroupsCommandInput = DescribeIpGroupsRequest; export type DescribeIpGroupsCommandOutput = DescribeIpGroupsResult & __MetadataBearer; +/** + *

Describes one or more of your IP access control groups.

+ */ export class DescribeIpGroupsCommand extends $Command< DescribeIpGroupsCommandInput, DescribeIpGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeIpGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeTagsCommand.ts b/clients/client-workspaces/commands/DescribeTagsCommand.ts index 768c882aa7f5b..ceb17b4e39742 100644 --- a/clients/client-workspaces/commands/DescribeTagsCommand.ts +++ b/clients/client-workspaces/commands/DescribeTagsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeTagsCommandInput = DescribeTagsRequest; export type DescribeTagsCommandOutput = DescribeTagsResult & __MetadataBearer; +/** + *

Describes the specified tags for the specified WorkSpaces resource.

+ */ export class DescribeTagsCommand extends $Command< DescribeTagsCommandInput, DescribeTagsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeTagsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeWorkspaceBundlesCommand.ts b/clients/client-workspaces/commands/DescribeWorkspaceBundlesCommand.ts index 233004a05a18e..d4516396c5617 100644 --- a/clients/client-workspaces/commands/DescribeWorkspaceBundlesCommand.ts +++ b/clients/client-workspaces/commands/DescribeWorkspaceBundlesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeWorkspaceBundlesCommandInput = DescribeWorkspaceBundlesRequest; export type DescribeWorkspaceBundlesCommandOutput = DescribeWorkspaceBundlesResult & __MetadataBearer; +/** + *

Retrieves a list that describes the available WorkSpace bundles.

+ *

You can filter the results using either bundle ID or owner, but not both.

+ */ export class DescribeWorkspaceBundlesCommand extends $Command< DescribeWorkspaceBundlesCommandInput, DescribeWorkspaceBundlesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeWorkspaceBundlesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeWorkspaceDirectoriesCommand.ts b/clients/client-workspaces/commands/DescribeWorkspaceDirectoriesCommand.ts index aad3c93e0e476..a0c76a360eb21 100644 --- a/clients/client-workspaces/commands/DescribeWorkspaceDirectoriesCommand.ts +++ b/clients/client-workspaces/commands/DescribeWorkspaceDirectoriesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeWorkspaceDirectoriesCommandInput = DescribeWorkspaceDirectoriesRequest; export type DescribeWorkspaceDirectoriesCommandOutput = DescribeWorkspaceDirectoriesResult & __MetadataBearer; +/** + *

Describes the available directories that are registered with + * Amazon WorkSpaces.

+ */ export class DescribeWorkspaceDirectoriesCommand extends $Command< DescribeWorkspaceDirectoriesCommandInput, DescribeWorkspaceDirectoriesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeWorkspaceDirectoriesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeWorkspaceImagePermissionsCommand.ts b/clients/client-workspaces/commands/DescribeWorkspaceImagePermissionsCommand.ts index 275ac925136a3..af755af75dc40 100644 --- a/clients/client-workspaces/commands/DescribeWorkspaceImagePermissionsCommand.ts +++ b/clients/client-workspaces/commands/DescribeWorkspaceImagePermissionsCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeWorkspaceImagePermissionsCommandInput = DescribeWorkspaceImagePermissionsRequest; export type DescribeWorkspaceImagePermissionsCommandOutput = DescribeWorkspaceImagePermissionsResult & __MetadataBearer; +/** + *

Describes the permissions that the owner of an image has granted to other + * AWS accounts for an image.

+ */ export class DescribeWorkspaceImagePermissionsCommand extends $Command< DescribeWorkspaceImagePermissionsCommandInput, DescribeWorkspaceImagePermissionsCommandOutput, @@ -34,6 +38,9 @@ export class DescribeWorkspaceImagePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeWorkspaceImagesCommand.ts b/clients/client-workspaces/commands/DescribeWorkspaceImagesCommand.ts index 60ea56c579ce7..803de145c72ac 100644 --- a/clients/client-workspaces/commands/DescribeWorkspaceImagesCommand.ts +++ b/clients/client-workspaces/commands/DescribeWorkspaceImagesCommand.ts @@ -20,6 +20,10 @@ import { export type DescribeWorkspaceImagesCommandInput = DescribeWorkspaceImagesRequest; export type DescribeWorkspaceImagesCommandOutput = DescribeWorkspaceImagesResult & __MetadataBearer; +/** + *

Retrieves a list that describes one or more specified images, if the image identifiers + * are provided. Otherwise, all images in the account are described.

+ */ export class DescribeWorkspaceImagesCommand extends $Command< DescribeWorkspaceImagesCommandInput, DescribeWorkspaceImagesCommandOutput, @@ -34,6 +38,9 @@ export class DescribeWorkspaceImagesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeWorkspaceSnapshotsCommand.ts b/clients/client-workspaces/commands/DescribeWorkspaceSnapshotsCommand.ts index 17cc41fb059ea..c17c09d1c6ce5 100644 --- a/clients/client-workspaces/commands/DescribeWorkspaceSnapshotsCommand.ts +++ b/clients/client-workspaces/commands/DescribeWorkspaceSnapshotsCommand.ts @@ -20,6 +20,9 @@ import { export type DescribeWorkspaceSnapshotsCommandInput = DescribeWorkspaceSnapshotsRequest; export type DescribeWorkspaceSnapshotsCommandOutput = DescribeWorkspaceSnapshotsResult & __MetadataBearer; +/** + *

Describes the snapshots for the specified WorkSpace.

+ */ export class DescribeWorkspaceSnapshotsCommand extends $Command< DescribeWorkspaceSnapshotsCommandInput, DescribeWorkspaceSnapshotsCommandOutput, @@ -34,6 +37,9 @@ export class DescribeWorkspaceSnapshotsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeWorkspacesCommand.ts b/clients/client-workspaces/commands/DescribeWorkspacesCommand.ts index f8fbe278f2f20..348fd23017831 100644 --- a/clients/client-workspaces/commands/DescribeWorkspacesCommand.ts +++ b/clients/client-workspaces/commands/DescribeWorkspacesCommand.ts @@ -20,6 +20,11 @@ import { export type DescribeWorkspacesCommandInput = DescribeWorkspacesRequest; export type DescribeWorkspacesCommandOutput = DescribeWorkspacesResult & __MetadataBearer; +/** + *

Describes the specified WorkSpaces.

+ *

You can filter the results by using the bundle identifier, directory identifier, or + * owner, but you can specify only one filter at a time.

+ */ export class DescribeWorkspacesCommand extends $Command< DescribeWorkspacesCommandInput, DescribeWorkspacesCommandOutput, @@ -34,6 +39,9 @@ export class DescribeWorkspacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DescribeWorkspacesConnectionStatusCommand.ts b/clients/client-workspaces/commands/DescribeWorkspacesConnectionStatusCommand.ts index 9e87ce54f5823..cd8205816cc20 100644 --- a/clients/client-workspaces/commands/DescribeWorkspacesConnectionStatusCommand.ts +++ b/clients/client-workspaces/commands/DescribeWorkspacesConnectionStatusCommand.ts @@ -24,6 +24,9 @@ export type DescribeWorkspacesConnectionStatusCommandInput = DescribeWorkspacesC export type DescribeWorkspacesConnectionStatusCommandOutput = DescribeWorkspacesConnectionStatusResult & __MetadataBearer; +/** + *

Describes the connection status of the specified WorkSpaces.

+ */ export class DescribeWorkspacesConnectionStatusCommand extends $Command< DescribeWorkspacesConnectionStatusCommandInput, DescribeWorkspacesConnectionStatusCommandOutput, @@ -38,6 +41,9 @@ export class DescribeWorkspacesConnectionStatusCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DisassociateConnectionAliasCommand.ts b/clients/client-workspaces/commands/DisassociateConnectionAliasCommand.ts index 8a5d58d05e453..f450c5781d6b9 100644 --- a/clients/client-workspaces/commands/DisassociateConnectionAliasCommand.ts +++ b/clients/client-workspaces/commands/DisassociateConnectionAliasCommand.ts @@ -20,6 +20,17 @@ import { export type DisassociateConnectionAliasCommandInput = DisassociateConnectionAliasRequest; export type DisassociateConnectionAliasCommandOutput = DisassociateConnectionAliasResult & __MetadataBearer; +/** + *

Disassociates a connection alias from a directory. Disassociating a connection alias disables cross-Region + * redirection between two directories in different AWS Regions. For more information, see + * + * Cross-Region Redirection for Amazon WorkSpaces.

+ * + * + *

Before performing this operation, call + * DescribeConnectionAliases to make sure that the current state of the connection alias is CREATED.

+ *
+ */ export class DisassociateConnectionAliasCommand extends $Command< DisassociateConnectionAliasCommandInput, DisassociateConnectionAliasCommandOutput, @@ -34,6 +45,9 @@ export class DisassociateConnectionAliasCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/DisassociateIpGroupsCommand.ts b/clients/client-workspaces/commands/DisassociateIpGroupsCommand.ts index aa604b3360a1b..edb5725fb1dcb 100644 --- a/clients/client-workspaces/commands/DisassociateIpGroupsCommand.ts +++ b/clients/client-workspaces/commands/DisassociateIpGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type DisassociateIpGroupsCommandInput = DisassociateIpGroupsRequest; export type DisassociateIpGroupsCommandOutput = DisassociateIpGroupsResult & __MetadataBearer; +/** + *

Disassociates the specified IP access control group from the specified directory.

+ */ export class DisassociateIpGroupsCommand extends $Command< DisassociateIpGroupsCommandInput, DisassociateIpGroupsCommandOutput, @@ -34,6 +37,9 @@ export class DisassociateIpGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ImportWorkspaceImageCommand.ts b/clients/client-workspaces/commands/ImportWorkspaceImageCommand.ts index a273364aba9d5..5dceb1c4ecb9c 100644 --- a/clients/client-workspaces/commands/ImportWorkspaceImageCommand.ts +++ b/clients/client-workspaces/commands/ImportWorkspaceImageCommand.ts @@ -20,6 +20,13 @@ import { export type ImportWorkspaceImageCommandInput = ImportWorkspaceImageRequest; export type ImportWorkspaceImageCommandOutput = ImportWorkspaceImageResult & __MetadataBearer; +/** + *

Imports the specified Windows 10 Bring Your Own License (BYOL) image into Amazon + * WorkSpaces. The image must be an already licensed Amazon EC2 image that is in your AWS + * account, and you must own the image. For more information about creating BYOL images, see + * + * Bring Your Own Windows Desktop Licenses.

+ */ export class ImportWorkspaceImageCommand extends $Command< ImportWorkspaceImageCommandInput, ImportWorkspaceImageCommandOutput, @@ -34,6 +41,9 @@ export class ImportWorkspaceImageCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ListAvailableManagementCidrRangesCommand.ts b/clients/client-workspaces/commands/ListAvailableManagementCidrRangesCommand.ts index 7b9d29a256210..04a5bf5203388 100644 --- a/clients/client-workspaces/commands/ListAvailableManagementCidrRangesCommand.ts +++ b/clients/client-workspaces/commands/ListAvailableManagementCidrRangesCommand.ts @@ -20,6 +20,17 @@ import { export type ListAvailableManagementCidrRangesCommandInput = ListAvailableManagementCidrRangesRequest; export type ListAvailableManagementCidrRangesCommandOutput = ListAvailableManagementCidrRangesResult & __MetadataBearer; +/** + *

Retrieves a list of IP address ranges, specified as IPv4 CIDR blocks, that you can use + * for the network management interface when you enable Bring Your Own License (BYOL).

+ * + *

This operation can be run only by AWS accounts that are enabled for BYOL. If your account + * isn't enabled for BYOL, you'll receive an AccessDeniedException error.

+ * + *

The management network interface is connected to a secure Amazon WorkSpaces management + * network. It is used for interactive streaming of the WorkSpace desktop to Amazon WorkSpaces + * clients, and to allow Amazon WorkSpaces to manage the WorkSpace.

+ */ export class ListAvailableManagementCidrRangesCommand extends $Command< ListAvailableManagementCidrRangesCommandInput, ListAvailableManagementCidrRangesCommandOutput, @@ -34,6 +45,9 @@ export class ListAvailableManagementCidrRangesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/MigrateWorkspaceCommand.ts b/clients/client-workspaces/commands/MigrateWorkspaceCommand.ts index 7458473925060..c069987619fbe 100644 --- a/clients/client-workspaces/commands/MigrateWorkspaceCommand.ts +++ b/clients/client-workspaces/commands/MigrateWorkspaceCommand.ts @@ -20,6 +20,17 @@ import { export type MigrateWorkspaceCommandInput = MigrateWorkspaceRequest; export type MigrateWorkspaceCommandOutput = MigrateWorkspaceResult & __MetadataBearer; +/** + *

Migrates a WorkSpace from one operating system or bundle type to another, while retaining the data on the user volume.

+ * + *

The migration process recreates the WorkSpace by using a new root volume from the target bundle image and the user volume + * from the last available snapshot of the original WorkSpace. During migration, the original D:\Users\%USERNAME% + * user profile folder is renamed to D:\Users\%USERNAME%MMddyyTHHmmss%.NotMigrated. A new D:\Users\%USERNAME%\ + * folder is generated by the new OS. Certain files in the old user profile are moved to the new user profile.

+ * + *

For available migration scenarios, details about what happens during migration, and best practices, see + * Migrate a WorkSpace.

+ */ export class MigrateWorkspaceCommand extends $Command< MigrateWorkspaceCommandInput, MigrateWorkspaceCommandOutput, @@ -34,6 +45,9 @@ export class MigrateWorkspaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ModifyAccountCommand.ts b/clients/client-workspaces/commands/ModifyAccountCommand.ts index 0fadb1f355670..b4f1e18723c46 100644 --- a/clients/client-workspaces/commands/ModifyAccountCommand.ts +++ b/clients/client-workspaces/commands/ModifyAccountCommand.ts @@ -20,6 +20,10 @@ import { export type ModifyAccountCommandInput = ModifyAccountRequest; export type ModifyAccountCommandOutput = ModifyAccountResult & __MetadataBearer; +/** + *

Modifies the configuration of Bring Your Own License (BYOL) for the specified + * account.

+ */ export class ModifyAccountCommand extends $Command< ModifyAccountCommandInput, ModifyAccountCommandOutput, @@ -34,6 +38,9 @@ export class ModifyAccountCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ModifyClientPropertiesCommand.ts b/clients/client-workspaces/commands/ModifyClientPropertiesCommand.ts index 0b63a51c6e968..8bd6000d33321 100644 --- a/clients/client-workspaces/commands/ModifyClientPropertiesCommand.ts +++ b/clients/client-workspaces/commands/ModifyClientPropertiesCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyClientPropertiesCommandInput = ModifyClientPropertiesRequest; export type ModifyClientPropertiesCommandOutput = ModifyClientPropertiesResult & __MetadataBearer; +/** + *

Modifies the properties of the specified Amazon WorkSpaces clients.

+ */ export class ModifyClientPropertiesCommand extends $Command< ModifyClientPropertiesCommandInput, ModifyClientPropertiesCommandOutput, @@ -34,6 +37,9 @@ export class ModifyClientPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ModifySelfservicePermissionsCommand.ts b/clients/client-workspaces/commands/ModifySelfservicePermissionsCommand.ts index 0b441aa29354e..7095d1e71af9b 100644 --- a/clients/client-workspaces/commands/ModifySelfservicePermissionsCommand.ts +++ b/clients/client-workspaces/commands/ModifySelfservicePermissionsCommand.ts @@ -20,6 +20,10 @@ import { export type ModifySelfservicePermissionsCommandInput = ModifySelfservicePermissionsRequest; export type ModifySelfservicePermissionsCommandOutput = ModifySelfservicePermissionsResult & __MetadataBearer; +/** + *

Modifies the self-service WorkSpace management capabilities for your users. For more + * information, see Enable Self-Service WorkSpace Management Capabilities for Your Users.

+ */ export class ModifySelfservicePermissionsCommand extends $Command< ModifySelfservicePermissionsCommandInput, ModifySelfservicePermissionsCommandOutput, @@ -34,6 +38,9 @@ export class ModifySelfservicePermissionsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ModifyWorkspaceAccessPropertiesCommand.ts b/clients/client-workspaces/commands/ModifyWorkspaceAccessPropertiesCommand.ts index da63d349c2d1f..d1e788e86f636 100644 --- a/clients/client-workspaces/commands/ModifyWorkspaceAccessPropertiesCommand.ts +++ b/clients/client-workspaces/commands/ModifyWorkspaceAccessPropertiesCommand.ts @@ -20,6 +20,11 @@ import { export type ModifyWorkspaceAccessPropertiesCommandInput = ModifyWorkspaceAccessPropertiesRequest; export type ModifyWorkspaceAccessPropertiesCommandOutput = ModifyWorkspaceAccessPropertiesResult & __MetadataBearer; +/** + *

Specifies which devices and operating systems users can use to access their WorkSpaces. + * For more information, see + * Control Device Access.

+ */ export class ModifyWorkspaceAccessPropertiesCommand extends $Command< ModifyWorkspaceAccessPropertiesCommandInput, ModifyWorkspaceAccessPropertiesCommandOutput, @@ -34,6 +39,9 @@ export class ModifyWorkspaceAccessPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ModifyWorkspaceCreationPropertiesCommand.ts b/clients/client-workspaces/commands/ModifyWorkspaceCreationPropertiesCommand.ts index 7252ddf312309..018addc64a16f 100644 --- a/clients/client-workspaces/commands/ModifyWorkspaceCreationPropertiesCommand.ts +++ b/clients/client-workspaces/commands/ModifyWorkspaceCreationPropertiesCommand.ts @@ -20,6 +20,9 @@ import { export type ModifyWorkspaceCreationPropertiesCommandInput = ModifyWorkspaceCreationPropertiesRequest; export type ModifyWorkspaceCreationPropertiesCommandOutput = ModifyWorkspaceCreationPropertiesResult & __MetadataBearer; +/** + *

Modify the default properties used to create WorkSpaces.

+ */ export class ModifyWorkspaceCreationPropertiesCommand extends $Command< ModifyWorkspaceCreationPropertiesCommandInput, ModifyWorkspaceCreationPropertiesCommandOutput, @@ -34,6 +37,9 @@ export class ModifyWorkspaceCreationPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ModifyWorkspacePropertiesCommand.ts b/clients/client-workspaces/commands/ModifyWorkspacePropertiesCommand.ts index adbc1c0994421..cc4cb7a29d8e9 100644 --- a/clients/client-workspaces/commands/ModifyWorkspacePropertiesCommand.ts +++ b/clients/client-workspaces/commands/ModifyWorkspacePropertiesCommand.ts @@ -20,6 +20,13 @@ import { export type ModifyWorkspacePropertiesCommandInput = ModifyWorkspacePropertiesRequest; export type ModifyWorkspacePropertiesCommandOutput = ModifyWorkspacePropertiesResult & __MetadataBearer; +/** + *

Modifies the specified WorkSpace properties. For important information about how + * to modify the size of the root and user volumes, see + * + * Modify a WorkSpace. + *

+ */ export class ModifyWorkspacePropertiesCommand extends $Command< ModifyWorkspacePropertiesCommandInput, ModifyWorkspacePropertiesCommandOutput, @@ -34,6 +41,9 @@ export class ModifyWorkspacePropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/ModifyWorkspaceStateCommand.ts b/clients/client-workspaces/commands/ModifyWorkspaceStateCommand.ts index 02399a5d31722..891771069288f 100644 --- a/clients/client-workspaces/commands/ModifyWorkspaceStateCommand.ts +++ b/clients/client-workspaces/commands/ModifyWorkspaceStateCommand.ts @@ -20,6 +20,14 @@ import { export type ModifyWorkspaceStateCommandInput = ModifyWorkspaceStateRequest; export type ModifyWorkspaceStateCommandOutput = ModifyWorkspaceStateResult & __MetadataBearer; +/** + *

Sets the state of the specified WorkSpace.

+ *

To maintain a WorkSpace without being interrupted, set the WorkSpace state to + * ADMIN_MAINTENANCE. WorkSpaces in this state do not respond to requests to + * reboot, stop, start, rebuild, or restore. An AutoStop WorkSpace in this state is not + * stopped. Users cannot log into a WorkSpace in the ADMIN_MAINTENANCE + * state.

+ */ export class ModifyWorkspaceStateCommand extends $Command< ModifyWorkspaceStateCommandInput, ModifyWorkspaceStateCommandOutput, @@ -34,6 +42,9 @@ export class ModifyWorkspaceStateCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/RebootWorkspacesCommand.ts b/clients/client-workspaces/commands/RebootWorkspacesCommand.ts index 5bb5261845101..e993154b6e166 100644 --- a/clients/client-workspaces/commands/RebootWorkspacesCommand.ts +++ b/clients/client-workspaces/commands/RebootWorkspacesCommand.ts @@ -20,6 +20,12 @@ import { export type RebootWorkspacesCommandInput = RebootWorkspacesRequest; export type RebootWorkspacesCommandOutput = RebootWorkspacesResult & __MetadataBearer; +/** + *

Reboots the specified WorkSpaces.

+ *

You cannot reboot a WorkSpace unless its state is AVAILABLE or + * UNHEALTHY.

+ *

This operation is asynchronous and returns before the WorkSpaces have rebooted.

+ */ export class RebootWorkspacesCommand extends $Command< RebootWorkspacesCommandInput, RebootWorkspacesCommandOutput, @@ -34,6 +40,9 @@ export class RebootWorkspacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/RebuildWorkspacesCommand.ts b/clients/client-workspaces/commands/RebuildWorkspacesCommand.ts index 98e7442fa108b..764e1d14ab7e7 100644 --- a/clients/client-workspaces/commands/RebuildWorkspacesCommand.ts +++ b/clients/client-workspaces/commands/RebuildWorkspacesCommand.ts @@ -20,6 +20,16 @@ import { export type RebuildWorkspacesCommandInput = RebuildWorkspacesRequest; export type RebuildWorkspacesCommandOutput = RebuildWorkspacesResult & __MetadataBearer; +/** + *

Rebuilds the specified WorkSpace.

+ *

You cannot rebuild a WorkSpace unless its state is AVAILABLE, + * ERROR, UNHEALTHY, STOPPED, or REBOOTING.

+ *

Rebuilding a WorkSpace is a potentially destructive action that can result in the loss + * of data. For more information, see Rebuild a + * WorkSpace.

+ *

This operation is asynchronous and returns before the WorkSpaces have been completely + * rebuilt.

+ */ export class RebuildWorkspacesCommand extends $Command< RebuildWorkspacesCommandInput, RebuildWorkspacesCommandOutput, @@ -34,6 +44,9 @@ export class RebuildWorkspacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/RegisterWorkspaceDirectoryCommand.ts b/clients/client-workspaces/commands/RegisterWorkspaceDirectoryCommand.ts index 56914f9bfa9b2..a52e7ad1a26c4 100644 --- a/clients/client-workspaces/commands/RegisterWorkspaceDirectoryCommand.ts +++ b/clients/client-workspaces/commands/RegisterWorkspaceDirectoryCommand.ts @@ -20,6 +20,13 @@ import { export type RegisterWorkspaceDirectoryCommandInput = RegisterWorkspaceDirectoryRequest; export type RegisterWorkspaceDirectoryCommandOutput = RegisterWorkspaceDirectoryResult & __MetadataBearer; +/** + *

Registers the specified directory. This operation is asynchronous + * and returns before the WorkSpace directory is registered. If this is the first time you are + * registering a directory, you will need to create the workspaces_DefaultRole role before you can + * register a directory. For more information, see + * Creating the workspaces_DefaultRole Role.

+ */ export class RegisterWorkspaceDirectoryCommand extends $Command< RegisterWorkspaceDirectoryCommandInput, RegisterWorkspaceDirectoryCommandOutput, @@ -34,6 +41,9 @@ export class RegisterWorkspaceDirectoryCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/RestoreWorkspaceCommand.ts b/clients/client-workspaces/commands/RestoreWorkspaceCommand.ts index a5e52301b59a4..257aab54e856c 100644 --- a/clients/client-workspaces/commands/RestoreWorkspaceCommand.ts +++ b/clients/client-workspaces/commands/RestoreWorkspaceCommand.ts @@ -20,6 +20,16 @@ import { export type RestoreWorkspaceCommandInput = RestoreWorkspaceRequest; export type RestoreWorkspaceCommandOutput = RestoreWorkspaceResult & __MetadataBearer; +/** + *

Restores the specified WorkSpace to its last known healthy state.

+ *

You cannot restore a WorkSpace unless its state is AVAILABLE, + * ERROR, UNHEALTHY, or STOPPED.

+ *

Restoring a WorkSpace is a potentially destructive action that can result in the loss of + * data. For more information, see Restore a + * WorkSpace.

+ *

This operation is asynchronous and returns before the WorkSpace is completely + * restored.

+ */ export class RestoreWorkspaceCommand extends $Command< RestoreWorkspaceCommandInput, RestoreWorkspaceCommandOutput, @@ -34,6 +44,9 @@ export class RestoreWorkspaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/RevokeIpRulesCommand.ts b/clients/client-workspaces/commands/RevokeIpRulesCommand.ts index 556ea1a201095..f37f032e7a40c 100644 --- a/clients/client-workspaces/commands/RevokeIpRulesCommand.ts +++ b/clients/client-workspaces/commands/RevokeIpRulesCommand.ts @@ -20,6 +20,9 @@ import { export type RevokeIpRulesCommandInput = RevokeIpRulesRequest; export type RevokeIpRulesCommandOutput = RevokeIpRulesResult & __MetadataBearer; +/** + *

Removes one or more rules from the specified IP access control group.

+ */ export class RevokeIpRulesCommand extends $Command< RevokeIpRulesCommandInput, RevokeIpRulesCommandOutput, @@ -34,6 +37,9 @@ export class RevokeIpRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/StartWorkspacesCommand.ts b/clients/client-workspaces/commands/StartWorkspacesCommand.ts index 15bb736f3a4a8..552094e9442ed 100644 --- a/clients/client-workspaces/commands/StartWorkspacesCommand.ts +++ b/clients/client-workspaces/commands/StartWorkspacesCommand.ts @@ -20,6 +20,11 @@ import { export type StartWorkspacesCommandInput = StartWorkspacesRequest; export type StartWorkspacesCommandOutput = StartWorkspacesResult & __MetadataBearer; +/** + *

Starts the specified WorkSpaces.

+ *

You cannot start a WorkSpace unless it has a running mode of AutoStop and a + * state of STOPPED.

+ */ export class StartWorkspacesCommand extends $Command< StartWorkspacesCommandInput, StartWorkspacesCommandOutput, @@ -34,6 +39,9 @@ export class StartWorkspacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/StopWorkspacesCommand.ts b/clients/client-workspaces/commands/StopWorkspacesCommand.ts index 39fa646ca2235..d86a9048b5786 100644 --- a/clients/client-workspaces/commands/StopWorkspacesCommand.ts +++ b/clients/client-workspaces/commands/StopWorkspacesCommand.ts @@ -20,6 +20,12 @@ import { export type StopWorkspacesCommandInput = StopWorkspacesRequest; export type StopWorkspacesCommandOutput = StopWorkspacesResult & __MetadataBearer; +/** + *

Stops the specified WorkSpaces.

+ *

You cannot stop a WorkSpace unless it has a running mode of AutoStop and a + * state of AVAILABLE, IMPAIRED, UNHEALTHY, or + * ERROR.

+ */ export class StopWorkspacesCommand extends $Command< StopWorkspacesCommandInput, StopWorkspacesCommandOutput, @@ -34,6 +40,9 @@ export class StopWorkspacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/TerminateWorkspacesCommand.ts b/clients/client-workspaces/commands/TerminateWorkspacesCommand.ts index 9f71b1913824e..803b1ca6e6039 100644 --- a/clients/client-workspaces/commands/TerminateWorkspacesCommand.ts +++ b/clients/client-workspaces/commands/TerminateWorkspacesCommand.ts @@ -20,6 +20,24 @@ import { export type TerminateWorkspacesCommandInput = TerminateWorkspacesRequest; export type TerminateWorkspacesCommandOutput = TerminateWorkspacesResult & __MetadataBearer; +/** + *

Terminates the specified WorkSpaces.

+ * + * + *

Terminating a WorkSpace is a permanent action and cannot be undone. The user's data is + * destroyed. If you need to archive any user data, contact AWS Support before + * terminating the WorkSpace.

+ *
+ * + *

You can terminate a WorkSpace that is in any state except SUSPENDED.

+ *

This operation is asynchronous and returns before the WorkSpaces have been completely + * terminated. After a WorkSpace is terminated, the TERMINATED state is returned + * only briefly before the WorkSpace directory metadata is cleaned up, so this state is rarely + * returned. To confirm that a WorkSpace is terminated, check for the WorkSpace ID by using + * + * DescribeWorkSpaces. If the WorkSpace ID isn't returned, then the WorkSpace has + * been successfully terminated.

+ */ export class TerminateWorkspacesCommand extends $Command< TerminateWorkspacesCommandInput, TerminateWorkspacesCommandOutput, @@ -34,6 +52,9 @@ export class TerminateWorkspacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/UpdateConnectionAliasPermissionCommand.ts b/clients/client-workspaces/commands/UpdateConnectionAliasPermissionCommand.ts index 87db790af4075..74c99eb4e30a8 100644 --- a/clients/client-workspaces/commands/UpdateConnectionAliasPermissionCommand.ts +++ b/clients/client-workspaces/commands/UpdateConnectionAliasPermissionCommand.ts @@ -20,6 +20,28 @@ import { export type UpdateConnectionAliasPermissionCommandInput = UpdateConnectionAliasPermissionRequest; export type UpdateConnectionAliasPermissionCommandOutput = UpdateConnectionAliasPermissionResult & __MetadataBearer; +/** + *

Shares or unshares a connection alias with one account by specifying whether that account has permission to + * associate the connection alias with a directory. If the association permission is granted, the connection alias + * is shared with that account. If the association permission is revoked, the connection alias is unshared with the + * account. For more information, see + * Cross-Region Redirection for Amazon WorkSpaces.

+ * + * + *
    + *
  • + *

    Before performing this operation, call + * DescribeConnectionAliases to make sure that the current state of the connection alias is CREATED.

    + *
  • + *
  • + *

    To delete a connection alias that has been shared, the shared account must first disassociate the + * connection alias from any directories it has been associated with. Then you must unshare the connection + * alias from the account it has been shared with. You can delete a connection alias only after it is no + * longer shared with any accounts or associated with any directories.

    + *
  • + *
+ *
+ */ export class UpdateConnectionAliasPermissionCommand extends $Command< UpdateConnectionAliasPermissionCommandInput, UpdateConnectionAliasPermissionCommandOutput, @@ -34,6 +56,9 @@ export class UpdateConnectionAliasPermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/UpdateRulesOfIpGroupCommand.ts b/clients/client-workspaces/commands/UpdateRulesOfIpGroupCommand.ts index 5dba7213d0088..c286d28cf33a9 100644 --- a/clients/client-workspaces/commands/UpdateRulesOfIpGroupCommand.ts +++ b/clients/client-workspaces/commands/UpdateRulesOfIpGroupCommand.ts @@ -20,6 +20,10 @@ import { export type UpdateRulesOfIpGroupCommandInput = UpdateRulesOfIpGroupRequest; export type UpdateRulesOfIpGroupCommandOutput = UpdateRulesOfIpGroupResult & __MetadataBearer; +/** + *

Replaces the current rules of the specified IP access control group with the specified + * rules.

+ */ export class UpdateRulesOfIpGroupCommand extends $Command< UpdateRulesOfIpGroupCommandInput, UpdateRulesOfIpGroupCommandOutput, @@ -34,6 +38,9 @@ export class UpdateRulesOfIpGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/commands/UpdateWorkspaceImagePermissionCommand.ts b/clients/client-workspaces/commands/UpdateWorkspaceImagePermissionCommand.ts index 6ea83c9202d71..0f385b9dc37a5 100644 --- a/clients/client-workspaces/commands/UpdateWorkspaceImagePermissionCommand.ts +++ b/clients/client-workspaces/commands/UpdateWorkspaceImagePermissionCommand.ts @@ -20,6 +20,26 @@ import { export type UpdateWorkspaceImagePermissionCommandInput = UpdateWorkspaceImagePermissionRequest; export type UpdateWorkspaceImagePermissionCommandOutput = UpdateWorkspaceImagePermissionResult & __MetadataBearer; +/** + *

Shares or unshares an image with one account by specifying whether that account has permission to copy + * the image. If the copy image permission is granted, the image is shared with that account. If the copy image + * permission is revoked, the image is unshared with the account. For more information about sharing images, see + * + * Share or Unshare a Custom WorkSpaces Image.

+ * + * + *
    + *
  • + *

    To delete an image that has been shared, you must unshare the image before you delete it.

    + *
  • + *
  • + *

    Sharing Bring Your Own License (BYOL) images across AWS accounts isn't supported at + * this time in the AWS GovCloud (US-West) Region. To share BYOL images across accounts in + * the AWS GovCloud (US-West) Region, contact AWS Support.

    + *
  • + *
+ *
+ */ export class UpdateWorkspaceImagePermissionCommand extends $Command< UpdateWorkspaceImagePermissionCommandInput, UpdateWorkspaceImagePermissionCommandOutput, @@ -34,6 +54,9 @@ export class UpdateWorkspaceImagePermissionCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: WorkSpacesClientResolvedConfig, diff --git a/clients/client-workspaces/package.json b/clients/client-workspaces/package.json index 264df19e129bb..190b53a12ee76 100644 --- a/clients/client-workspaces/package.json +++ b/clients/client-workspaces/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Workspaces Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-workspaces/pagination/DescribeWorkspaceBundlesPaginator.ts b/clients/client-workspaces/pagination/DescribeWorkspaceBundlesPaginator.ts index 1189ea14f1448..667809e7c1b16 100644 --- a/clients/client-workspaces/pagination/DescribeWorkspaceBundlesPaginator.ts +++ b/clients/client-workspaces/pagination/DescribeWorkspaceBundlesPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkSpacesPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkSpacesClient, input: DescribeWorkspaceBundlesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeWorkspaceBundlesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkSpaces, input: DescribeWorkspaceBundlesCommandInput, diff --git a/clients/client-workspaces/pagination/DescribeWorkspaceDirectoriesPaginator.ts b/clients/client-workspaces/pagination/DescribeWorkspaceDirectoriesPaginator.ts index 031837e9c1eba..de284dbd0c2f5 100644 --- a/clients/client-workspaces/pagination/DescribeWorkspaceDirectoriesPaginator.ts +++ b/clients/client-workspaces/pagination/DescribeWorkspaceDirectoriesPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkSpacesPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkSpacesClient, input: DescribeWorkspaceDirectoriesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeWorkspaceDirectoriesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkSpaces, input: DescribeWorkspaceDirectoriesCommandInput, diff --git a/clients/client-workspaces/pagination/DescribeWorkspacesPaginator.ts b/clients/client-workspaces/pagination/DescribeWorkspacesPaginator.ts index 978220c18d1be..fbe49d540be6e 100644 --- a/clients/client-workspaces/pagination/DescribeWorkspacesPaginator.ts +++ b/clients/client-workspaces/pagination/DescribeWorkspacesPaginator.ts @@ -8,6 +8,9 @@ import { import { WorkSpacesPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: WorkSpacesClient, input: DescribeWorkspacesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new DescribeWorkspacesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: WorkSpaces, input: DescribeWorkspacesCommandInput, diff --git a/clients/client-workspaces/runtimeConfig.browser.ts b/clients/client-workspaces/runtimeConfig.browser.ts index 8d9b63bb62cd3..206282408413a 100644 --- a/clients/client-workspaces/runtimeConfig.browser.ts +++ b/clients/client-workspaces/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./WorkSpacesClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-workspaces/runtimeConfig.native.ts b/clients/client-workspaces/runtimeConfig.native.ts index 7f11ebc1966e8..cdc750bee2628 100644 --- a/clients/client-workspaces/runtimeConfig.native.ts +++ b/clients/client-workspaces/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./WorkSpacesClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-workspaces/runtimeConfig.shared.ts b/clients/client-workspaces/runtimeConfig.shared.ts index 3e409c06b38fd..ff57ea55025f3 100644 --- a/clients/client-workspaces/runtimeConfig.shared.ts +++ b/clients/client-workspaces/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2015-04-08", disableHostPrefix: false, diff --git a/clients/client-workspaces/runtimeConfig.ts b/clients/client-workspaces/runtimeConfig.ts index 3f58854c6aecd..a92d954a69606 100644 --- a/clients/client-workspaces/runtimeConfig.ts +++ b/clients/client-workspaces/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./WorkSpacesClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-workspaces/tsconfig.json b/clients/client-workspaces/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-workspaces/tsconfig.json +++ b/clients/client-workspaces/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/clients/client-xray/commands/BatchGetTracesCommand.ts b/clients/client-xray/commands/BatchGetTracesCommand.ts index d0b661348bddf..570ab57225ad2 100644 --- a/clients/client-xray/commands/BatchGetTracesCommand.ts +++ b/clients/client-xray/commands/BatchGetTracesCommand.ts @@ -20,6 +20,11 @@ import { export type BatchGetTracesCommandInput = BatchGetTracesRequest; export type BatchGetTracesCommandOutput = BatchGetTracesResult & __MetadataBearer; +/** + *

Retrieves a list of traces specified by ID. Each trace is a collection of segment + * documents that originates from a single request. Use GetTraceSummaries to get a + * list of trace IDs.

+ */ export class BatchGetTracesCommand extends $Command< BatchGetTracesCommandInput, BatchGetTracesCommandOutput, @@ -34,6 +39,9 @@ export class BatchGetTracesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/CreateGroupCommand.ts b/clients/client-xray/commands/CreateGroupCommand.ts index c302a849726c8..ff027cdb2779b 100644 --- a/clients/client-xray/commands/CreateGroupCommand.ts +++ b/clients/client-xray/commands/CreateGroupCommand.ts @@ -20,6 +20,9 @@ import { export type CreateGroupCommandInput = CreateGroupRequest; export type CreateGroupCommandOutput = CreateGroupResult & __MetadataBearer; +/** + *

Creates a group resource with a name and a filter expression.

+ */ export class CreateGroupCommand extends $Command< CreateGroupCommandInput, CreateGroupCommandOutput, @@ -34,6 +37,9 @@ export class CreateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/CreateSamplingRuleCommand.ts b/clients/client-xray/commands/CreateSamplingRuleCommand.ts index 16231064d35e2..db61fde602a1c 100644 --- a/clients/client-xray/commands/CreateSamplingRuleCommand.ts +++ b/clients/client-xray/commands/CreateSamplingRuleCommand.ts @@ -20,6 +20,15 @@ import { export type CreateSamplingRuleCommandInput = CreateSamplingRuleRequest; export type CreateSamplingRuleCommandOutput = CreateSamplingRuleResult & __MetadataBearer; +/** + *

Creates a rule to control sampling behavior for instrumented applications. Services + * retrieve rules with GetSamplingRules, and evaluate each rule in ascending + * order of priority for each request. If a rule matches, the service + * records a trace, borrowing it from the reservoir size. After 10 seconds, the service + * reports back to X-Ray with GetSamplingTargets to get updated versions of + * each in-use rule. The updated rule contains a trace quota that the service can use instead + * of borrowing from the reservoir.

+ */ export class CreateSamplingRuleCommand extends $Command< CreateSamplingRuleCommandInput, CreateSamplingRuleCommandOutput, @@ -34,6 +43,9 @@ export class CreateSamplingRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/DeleteGroupCommand.ts b/clients/client-xray/commands/DeleteGroupCommand.ts index 8e874ee0f0f95..0cabae43b72d6 100644 --- a/clients/client-xray/commands/DeleteGroupCommand.ts +++ b/clients/client-xray/commands/DeleteGroupCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteGroupCommandInput = DeleteGroupRequest; export type DeleteGroupCommandOutput = DeleteGroupResult & __MetadataBearer; +/** + *

Deletes a group resource.

+ */ export class DeleteGroupCommand extends $Command< DeleteGroupCommandInput, DeleteGroupCommandOutput, @@ -34,6 +37,9 @@ export class DeleteGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/DeleteSamplingRuleCommand.ts b/clients/client-xray/commands/DeleteSamplingRuleCommand.ts index 9e8c38d6ca30e..8395985c4a548 100644 --- a/clients/client-xray/commands/DeleteSamplingRuleCommand.ts +++ b/clients/client-xray/commands/DeleteSamplingRuleCommand.ts @@ -20,6 +20,9 @@ import { export type DeleteSamplingRuleCommandInput = DeleteSamplingRuleRequest; export type DeleteSamplingRuleCommandOutput = DeleteSamplingRuleResult & __MetadataBearer; +/** + *

Deletes a sampling rule.

+ */ export class DeleteSamplingRuleCommand extends $Command< DeleteSamplingRuleCommandInput, DeleteSamplingRuleCommandOutput, @@ -34,6 +37,9 @@ export class DeleteSamplingRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetEncryptionConfigCommand.ts b/clients/client-xray/commands/GetEncryptionConfigCommand.ts index 9331126fedcb4..135b9740d3328 100644 --- a/clients/client-xray/commands/GetEncryptionConfigCommand.ts +++ b/clients/client-xray/commands/GetEncryptionConfigCommand.ts @@ -20,6 +20,9 @@ import { export type GetEncryptionConfigCommandInput = GetEncryptionConfigRequest; export type GetEncryptionConfigCommandOutput = GetEncryptionConfigResult & __MetadataBearer; +/** + *

Retrieves the current encryption configuration for X-Ray data.

+ */ export class GetEncryptionConfigCommand extends $Command< GetEncryptionConfigCommandInput, GetEncryptionConfigCommandOutput, @@ -34,6 +37,9 @@ export class GetEncryptionConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetGroupCommand.ts b/clients/client-xray/commands/GetGroupCommand.ts index 1ad3353dcbb54..273dcc0fd8c4e 100644 --- a/clients/client-xray/commands/GetGroupCommand.ts +++ b/clients/client-xray/commands/GetGroupCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupCommandInput = GetGroupRequest; export type GetGroupCommandOutput = GetGroupResult & __MetadataBearer; +/** + *

Retrieves group resource details.

+ */ export class GetGroupCommand extends $Command { // Start section: command_properties // End section: command_properties @@ -30,6 +33,9 @@ export class GetGroupCommand extends $Command, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetGroupsCommand.ts b/clients/client-xray/commands/GetGroupsCommand.ts index b4eab2fb3621a..241c0102a1ad8 100644 --- a/clients/client-xray/commands/GetGroupsCommand.ts +++ b/clients/client-xray/commands/GetGroupsCommand.ts @@ -20,6 +20,9 @@ import { export type GetGroupsCommandInput = GetGroupsRequest; export type GetGroupsCommandOutput = GetGroupsResult & __MetadataBearer; +/** + *

Retrieves all active group details.

+ */ export class GetGroupsCommand extends $Command< GetGroupsCommandInput, GetGroupsCommandOutput, @@ -34,6 +37,9 @@ export class GetGroupsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetInsightCommand.ts b/clients/client-xray/commands/GetInsightCommand.ts index f6f973d9673f7..71dde2c11ae86 100644 --- a/clients/client-xray/commands/GetInsightCommand.ts +++ b/clients/client-xray/commands/GetInsightCommand.ts @@ -20,6 +20,11 @@ import { export type GetInsightCommandInput = GetInsightRequest; export type GetInsightCommandOutput = GetInsightResult & __MetadataBearer; +/** + *

Retrieves the summary information of an insight. This includes impact to clients and + * root cause services, the top anomalous services, the category, the state of the insight, + * and the start and end time of the insight.

+ */ export class GetInsightCommand extends $Command< GetInsightCommandInput, GetInsightCommandOutput, @@ -34,6 +39,9 @@ export class GetInsightCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetInsightEventsCommand.ts b/clients/client-xray/commands/GetInsightEventsCommand.ts index f0b7660ce9eb7..d6f5d6a69bda1 100644 --- a/clients/client-xray/commands/GetInsightEventsCommand.ts +++ b/clients/client-xray/commands/GetInsightEventsCommand.ts @@ -20,6 +20,11 @@ import { export type GetInsightEventsCommandInput = GetInsightEventsRequest; export type GetInsightEventsCommandOutput = GetInsightEventsResult & __MetadataBearer; +/** + *

X-Ray reevaluates insights periodically until they're resolved, and records each intermediate state as an + * event. You can review an insight's events in the Impact Timeline on the Inspect page in the X-Ray + * console.

+ */ export class GetInsightEventsCommand extends $Command< GetInsightEventsCommandInput, GetInsightEventsCommandOutput, @@ -34,6 +39,9 @@ export class GetInsightEventsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetInsightImpactGraphCommand.ts b/clients/client-xray/commands/GetInsightImpactGraphCommand.ts index 7ab976dd27427..5a9a4fed93e5a 100644 --- a/clients/client-xray/commands/GetInsightImpactGraphCommand.ts +++ b/clients/client-xray/commands/GetInsightImpactGraphCommand.ts @@ -20,6 +20,10 @@ import { export type GetInsightImpactGraphCommandInput = GetInsightImpactGraphRequest; export type GetInsightImpactGraphCommandOutput = GetInsightImpactGraphResult & __MetadataBearer; +/** + *

Retrieves a service graph structure filtered by the specified insight. The service graph is limited to only + * structural information. For a complete service graph, use this API with the GetServiceGraph API.

+ */ export class GetInsightImpactGraphCommand extends $Command< GetInsightImpactGraphCommandInput, GetInsightImpactGraphCommandOutput, @@ -34,6 +38,9 @@ export class GetInsightImpactGraphCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetInsightSummariesCommand.ts b/clients/client-xray/commands/GetInsightSummariesCommand.ts index 3dec6086dfcc4..706f4b5115634 100644 --- a/clients/client-xray/commands/GetInsightSummariesCommand.ts +++ b/clients/client-xray/commands/GetInsightSummariesCommand.ts @@ -20,6 +20,9 @@ import { export type GetInsightSummariesCommandInput = GetInsightSummariesRequest; export type GetInsightSummariesCommandOutput = GetInsightSummariesResult & __MetadataBearer; +/** + *

Retrieves the summaries of all insights in the specified group matching the provided filter values.

+ */ export class GetInsightSummariesCommand extends $Command< GetInsightSummariesCommandInput, GetInsightSummariesCommandOutput, @@ -34,6 +37,9 @@ export class GetInsightSummariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetSamplingRulesCommand.ts b/clients/client-xray/commands/GetSamplingRulesCommand.ts index efebba64773a9..dde6c96fac844 100644 --- a/clients/client-xray/commands/GetSamplingRulesCommand.ts +++ b/clients/client-xray/commands/GetSamplingRulesCommand.ts @@ -20,6 +20,9 @@ import { export type GetSamplingRulesCommandInput = GetSamplingRulesRequest; export type GetSamplingRulesCommandOutput = GetSamplingRulesResult & __MetadataBearer; +/** + *

Retrieves all sampling rules.

+ */ export class GetSamplingRulesCommand extends $Command< GetSamplingRulesCommandInput, GetSamplingRulesCommandOutput, @@ -34,6 +37,9 @@ export class GetSamplingRulesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetSamplingStatisticSummariesCommand.ts b/clients/client-xray/commands/GetSamplingStatisticSummariesCommand.ts index 704d4d679e425..2c2726bd91092 100644 --- a/clients/client-xray/commands/GetSamplingStatisticSummariesCommand.ts +++ b/clients/client-xray/commands/GetSamplingStatisticSummariesCommand.ts @@ -20,6 +20,9 @@ import { export type GetSamplingStatisticSummariesCommandInput = GetSamplingStatisticSummariesRequest; export type GetSamplingStatisticSummariesCommandOutput = GetSamplingStatisticSummariesResult & __MetadataBearer; +/** + *

Retrieves information about recent sampling results for all sampling rules.

+ */ export class GetSamplingStatisticSummariesCommand extends $Command< GetSamplingStatisticSummariesCommandInput, GetSamplingStatisticSummariesCommandOutput, @@ -34,6 +37,9 @@ export class GetSamplingStatisticSummariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetSamplingTargetsCommand.ts b/clients/client-xray/commands/GetSamplingTargetsCommand.ts index 28a07327e9503..4b21f33ba5e3f 100644 --- a/clients/client-xray/commands/GetSamplingTargetsCommand.ts +++ b/clients/client-xray/commands/GetSamplingTargetsCommand.ts @@ -20,6 +20,10 @@ import { export type GetSamplingTargetsCommandInput = GetSamplingTargetsRequest; export type GetSamplingTargetsCommandOutput = GetSamplingTargetsResult & __MetadataBearer; +/** + *

Requests a sampling quota for rules that the service is using to sample requests. + *

+ */ export class GetSamplingTargetsCommand extends $Command< GetSamplingTargetsCommandInput, GetSamplingTargetsCommandOutput, @@ -34,6 +38,9 @@ export class GetSamplingTargetsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetServiceGraphCommand.ts b/clients/client-xray/commands/GetServiceGraphCommand.ts index b1f27b80873dc..ececdba6d07af 100644 --- a/clients/client-xray/commands/GetServiceGraphCommand.ts +++ b/clients/client-xray/commands/GetServiceGraphCommand.ts @@ -20,6 +20,13 @@ import { export type GetServiceGraphCommandInput = GetServiceGraphRequest; export type GetServiceGraphCommandOutput = GetServiceGraphResult & __MetadataBearer; +/** + *

Retrieves a document that describes services that process incoming requests, and + * downstream services that they call as a result. Root services process incoming requests and + * make calls to downstream services. Root services are applications that use the AWS X-Ray SDK. + * Downstream services can be other applications, AWS resources, HTTP web APIs, or SQL + * databases.

+ */ export class GetServiceGraphCommand extends $Command< GetServiceGraphCommandInput, GetServiceGraphCommandOutput, @@ -34,6 +41,9 @@ export class GetServiceGraphCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetTimeSeriesServiceStatisticsCommand.ts b/clients/client-xray/commands/GetTimeSeriesServiceStatisticsCommand.ts index 1a90e4638097a..2e8670264af51 100644 --- a/clients/client-xray/commands/GetTimeSeriesServiceStatisticsCommand.ts +++ b/clients/client-xray/commands/GetTimeSeriesServiceStatisticsCommand.ts @@ -20,6 +20,10 @@ import { export type GetTimeSeriesServiceStatisticsCommandInput = GetTimeSeriesServiceStatisticsRequest; export type GetTimeSeriesServiceStatisticsCommandOutput = GetTimeSeriesServiceStatisticsResult & __MetadataBearer; +/** + *

Get an aggregation of service statistics defined by a specific time + * range.

+ */ export class GetTimeSeriesServiceStatisticsCommand extends $Command< GetTimeSeriesServiceStatisticsCommandInput, GetTimeSeriesServiceStatisticsCommandOutput, @@ -34,6 +38,9 @@ export class GetTimeSeriesServiceStatisticsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetTraceGraphCommand.ts b/clients/client-xray/commands/GetTraceGraphCommand.ts index 3b0c61c9b7f07..aeff5f0f50e57 100644 --- a/clients/client-xray/commands/GetTraceGraphCommand.ts +++ b/clients/client-xray/commands/GetTraceGraphCommand.ts @@ -20,6 +20,9 @@ import { export type GetTraceGraphCommandInput = GetTraceGraphRequest; export type GetTraceGraphCommandOutput = GetTraceGraphResult & __MetadataBearer; +/** + *

Retrieves a service graph for one or more specific trace IDs.

+ */ export class GetTraceGraphCommand extends $Command< GetTraceGraphCommandInput, GetTraceGraphCommandOutput, @@ -34,6 +37,9 @@ export class GetTraceGraphCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/GetTraceSummariesCommand.ts b/clients/client-xray/commands/GetTraceSummariesCommand.ts index 81c20998da2b4..6e61c513ecf1e 100644 --- a/clients/client-xray/commands/GetTraceSummariesCommand.ts +++ b/clients/client-xray/commands/GetTraceSummariesCommand.ts @@ -20,6 +20,25 @@ import { export type GetTraceSummariesCommandInput = GetTraceSummariesRequest; export type GetTraceSummariesCommandOutput = GetTraceSummariesResult & __MetadataBearer; +/** + *

Retrieves IDs and annotations for traces available for a specified time frame using an + * optional filter. To get the full traces, pass the trace IDs to + * BatchGetTraces.

+ *

A filter expression can target traced requests that hit specific service nodes or + * edges, have errors, or come from a known user. For example, the following filter expression + * targets traces that pass through api.example.com:

+ *

+ * service("api.example.com") + *

+ *

This filter expression finds traces that have an annotation named account + * with the value 12345:

+ *

+ * annotation.account = "12345" + *

+ *

For a full list of indexed fields and keywords that you can use in filter expressions, + * see Using Filter + * Expressions in the AWS X-Ray Developer Guide.

+ */ export class GetTraceSummariesCommand extends $Command< GetTraceSummariesCommandInput, GetTraceSummariesCommandOutput, @@ -34,6 +53,9 @@ export class GetTraceSummariesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/ListTagsForResourceCommand.ts b/clients/client-xray/commands/ListTagsForResourceCommand.ts index 15586c1ee091b..1867d25585e52 100644 --- a/clients/client-xray/commands/ListTagsForResourceCommand.ts +++ b/clients/client-xray/commands/ListTagsForResourceCommand.ts @@ -20,6 +20,9 @@ import { export type ListTagsForResourceCommandInput = ListTagsForResourceRequest; export type ListTagsForResourceCommandOutput = ListTagsForResourceResponse & __MetadataBearer; +/** + *

Returns a list of tags that are applied to the specified AWS X-Ray group or sampling rule.

+ */ export class ListTagsForResourceCommand extends $Command< ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, @@ -34,6 +37,9 @@ export class ListTagsForResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/PutEncryptionConfigCommand.ts b/clients/client-xray/commands/PutEncryptionConfigCommand.ts index fe793d2628fa5..1cfde0f72eb60 100644 --- a/clients/client-xray/commands/PutEncryptionConfigCommand.ts +++ b/clients/client-xray/commands/PutEncryptionConfigCommand.ts @@ -20,6 +20,9 @@ import { export type PutEncryptionConfigCommandInput = PutEncryptionConfigRequest; export type PutEncryptionConfigCommandOutput = PutEncryptionConfigResult & __MetadataBearer; +/** + *

Updates the encryption configuration for X-Ray data.

+ */ export class PutEncryptionConfigCommand extends $Command< PutEncryptionConfigCommandInput, PutEncryptionConfigCommandOutput, @@ -34,6 +37,9 @@ export class PutEncryptionConfigCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/PutTelemetryRecordsCommand.ts b/clients/client-xray/commands/PutTelemetryRecordsCommand.ts index 03f9c3d85718c..02b66a6c4f7f4 100644 --- a/clients/client-xray/commands/PutTelemetryRecordsCommand.ts +++ b/clients/client-xray/commands/PutTelemetryRecordsCommand.ts @@ -20,6 +20,9 @@ import { export type PutTelemetryRecordsCommandInput = PutTelemetryRecordsRequest; export type PutTelemetryRecordsCommandOutput = PutTelemetryRecordsResult & __MetadataBearer; +/** + *

Used by the AWS X-Ray daemon to upload telemetry.

+ */ export class PutTelemetryRecordsCommand extends $Command< PutTelemetryRecordsCommandInput, PutTelemetryRecordsCommandOutput, @@ -34,6 +37,9 @@ export class PutTelemetryRecordsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/PutTraceSegmentsCommand.ts b/clients/client-xray/commands/PutTraceSegmentsCommand.ts index 1c060ee69cbcc..82b0ccb5e0474 100644 --- a/clients/client-xray/commands/PutTraceSegmentsCommand.ts +++ b/clients/client-xray/commands/PutTraceSegmentsCommand.ts @@ -20,6 +20,71 @@ import { export type PutTraceSegmentsCommandInput = PutTraceSegmentsRequest; export type PutTraceSegmentsCommandOutput = PutTraceSegmentsResult & __MetadataBearer; +/** + *

Uploads segment documents to AWS X-Ray. The X-Ray SDK generates segment documents and sends them to the X-Ray daemon, which uploads them in + * batches. A segment document can be a completed segment, an in-progress segment, or an array of + * subsegments.

+ *

Segments must include the following fields. For the full segment document schema, see + * AWS X-Ray + * Segment Documents in the AWS X-Ray Developer Guide.

+ *

+ * Required segment document fields + *

+ *
    + *
  • + *

    + * name - The name of the service that handled the request.

    + *
  • + *
  • + *

    + * id - A 64-bit identifier for the segment, unique among segments in the same trace, in 16 + * hexadecimal digits.

    + *
  • + *
  • + *

    + * trace_id - A unique identifier that connects all segments and subsegments originating from + * a single client request.

    + *
  • + *
  • + *

    + * start_time - Time the segment or subsegment was created, in floating point seconds in + * epoch time, accurate to milliseconds. For example, 1480615200.010 or + * 1.480615200010E9.

    + *
  • + *
  • + *

    + * end_time - Time the segment or subsegment was closed. For example, + * 1480615200.090 or 1.480615200090E9. Specify either an end_time or + * in_progress.

    + *
  • + *
  • + *

    + * in_progress - Set to true instead of specifying an end_time to + * record that a segment has been started, but is not complete. Send an in-progress segment when your application + * receives a request that will take a long time to serve, to trace that the request was received. When the + * response is sent, send the complete segment to overwrite the in-progress segment.

    + *
  • + *
+ *

A trace_id consists of three numbers separated by hyphens. For example, + * 1-58406520-a006649127e371903a2de979. This includes:

+ *

+ * Trace ID Format + *

+ *
    + *
  • + *

    The version number, for instance, 1.

    + *
  • + *
  • + *

    The time of the original request, in Unix epoch time, in 8 hexadecimal digits. For + * example, 10:00AM December 2nd, 2016 PST in epoch time is 1480615200 seconds, + * or 58406520 in hexadecimal.

    + *
  • + *
  • + *

    A 96-bit identifier for the trace, globally unique, in 24 hexadecimal + * digits.

    + *
  • + *
+ */ export class PutTraceSegmentsCommand extends $Command< PutTraceSegmentsCommandInput, PutTraceSegmentsCommandOutput, @@ -34,6 +99,9 @@ export class PutTraceSegmentsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/TagResourceCommand.ts b/clients/client-xray/commands/TagResourceCommand.ts index 21043d62c4d23..f3b83cd7f83b3 100644 --- a/clients/client-xray/commands/TagResourceCommand.ts +++ b/clients/client-xray/commands/TagResourceCommand.ts @@ -20,6 +20,9 @@ import { export type TagResourceCommandInput = TagResourceRequest; export type TagResourceCommandOutput = TagResourceResponse & __MetadataBearer; +/** + *

Applies tags to an existing AWS X-Ray group or sampling rule.

+ */ export class TagResourceCommand extends $Command< TagResourceCommandInput, TagResourceCommandOutput, @@ -34,6 +37,9 @@ export class TagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/UntagResourceCommand.ts b/clients/client-xray/commands/UntagResourceCommand.ts index ee44856401d63..bb741622a8e51 100644 --- a/clients/client-xray/commands/UntagResourceCommand.ts +++ b/clients/client-xray/commands/UntagResourceCommand.ts @@ -20,6 +20,10 @@ import { export type UntagResourceCommandInput = UntagResourceRequest; export type UntagResourceCommandOutput = UntagResourceResponse & __MetadataBearer; +/** + *

Removes tags from an AWS X-Ray group or sampling rule. You cannot edit or delete system + * tags (those with an aws: prefix).

+ */ export class UntagResourceCommand extends $Command< UntagResourceCommandInput, UntagResourceCommandOutput, @@ -34,6 +38,9 @@ export class UntagResourceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/UpdateGroupCommand.ts b/clients/client-xray/commands/UpdateGroupCommand.ts index 5ec1bc5800743..5e60f644472c3 100644 --- a/clients/client-xray/commands/UpdateGroupCommand.ts +++ b/clients/client-xray/commands/UpdateGroupCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateGroupCommandInput = UpdateGroupRequest; export type UpdateGroupCommandOutput = UpdateGroupResult & __MetadataBearer; +/** + *

Updates a group resource.

+ */ export class UpdateGroupCommand extends $Command< UpdateGroupCommandInput, UpdateGroupCommandOutput, @@ -34,6 +37,9 @@ export class UpdateGroupCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/commands/UpdateSamplingRuleCommand.ts b/clients/client-xray/commands/UpdateSamplingRuleCommand.ts index 57af080802ae5..baf1bcdbdc9a1 100644 --- a/clients/client-xray/commands/UpdateSamplingRuleCommand.ts +++ b/clients/client-xray/commands/UpdateSamplingRuleCommand.ts @@ -20,6 +20,9 @@ import { export type UpdateSamplingRuleCommandInput = UpdateSamplingRuleRequest; export type UpdateSamplingRuleCommandOutput = UpdateSamplingRuleResult & __MetadataBearer; +/** + *

Modifies a sampling rule's configuration.

+ */ export class UpdateSamplingRuleCommand extends $Command< UpdateSamplingRuleCommandInput, UpdateSamplingRuleCommandOutput, @@ -34,6 +37,9 @@ export class UpdateSamplingRuleCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: XRayClientResolvedConfig, diff --git a/clients/client-xray/package.json b/clients/client-xray/package.json index ff4bb8e0a9fd4..1842503fbb84a 100644 --- a/clients/client-xray/package.json +++ b/clients/client-xray/package.json @@ -3,8 +3,8 @@ "description": "AWS SDK for JavaScript Xray Client for Node.js, Browser and React Native", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -63,7 +63,7 @@ "@types/node": "^12.7.5", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/clients/client-xray/pagination/BatchGetTracesPaginator.ts b/clients/client-xray/pagination/BatchGetTracesPaginator.ts index e55a4f9d228e4..1f4e6b65f52ae 100644 --- a/clients/client-xray/pagination/BatchGetTracesPaginator.ts +++ b/clients/client-xray/pagination/BatchGetTracesPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: BatchGetTracesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new BatchGetTracesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: BatchGetTracesCommandInput, diff --git a/clients/client-xray/pagination/GetGroupsPaginator.ts b/clients/client-xray/pagination/GetGroupsPaginator.ts index 39f797af853ad..7f1c83b98b10d 100644 --- a/clients/client-xray/pagination/GetGroupsPaginator.ts +++ b/clients/client-xray/pagination/GetGroupsPaginator.ts @@ -4,6 +4,9 @@ import { GetGroupsCommand, GetGroupsCommandInput, GetGroupsCommandOutput } from import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetGroupsCommandInput, @@ -12,6 +15,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetGroupsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetGroupsCommandInput, diff --git a/clients/client-xray/pagination/GetInsightEventsPaginator.ts b/clients/client-xray/pagination/GetInsightEventsPaginator.ts index 2241ab9e8beb5..3edb3462523cd 100644 --- a/clients/client-xray/pagination/GetInsightEventsPaginator.ts +++ b/clients/client-xray/pagination/GetInsightEventsPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetInsightEventsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetInsightEventsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetInsightEventsCommandInput, diff --git a/clients/client-xray/pagination/GetInsightSummariesPaginator.ts b/clients/client-xray/pagination/GetInsightSummariesPaginator.ts index 12e0d7941a06e..5a4a15191684a 100644 --- a/clients/client-xray/pagination/GetInsightSummariesPaginator.ts +++ b/clients/client-xray/pagination/GetInsightSummariesPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetInsightSummariesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetInsightSummariesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetInsightSummariesCommandInput, diff --git a/clients/client-xray/pagination/GetSamplingRulesPaginator.ts b/clients/client-xray/pagination/GetSamplingRulesPaginator.ts index 5bc4ed099cc19..2978844763fbf 100644 --- a/clients/client-xray/pagination/GetSamplingRulesPaginator.ts +++ b/clients/client-xray/pagination/GetSamplingRulesPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetSamplingRulesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSamplingRulesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetSamplingRulesCommandInput, diff --git a/clients/client-xray/pagination/GetSamplingStatisticSummariesPaginator.ts b/clients/client-xray/pagination/GetSamplingStatisticSummariesPaginator.ts index 144a6ec43b219..145214f043345 100644 --- a/clients/client-xray/pagination/GetSamplingStatisticSummariesPaginator.ts +++ b/clients/client-xray/pagination/GetSamplingStatisticSummariesPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetSamplingStatisticSummariesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetSamplingStatisticSummariesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetSamplingStatisticSummariesCommandInput, diff --git a/clients/client-xray/pagination/GetServiceGraphPaginator.ts b/clients/client-xray/pagination/GetServiceGraphPaginator.ts index afa51e503af58..415f53c44d0c3 100644 --- a/clients/client-xray/pagination/GetServiceGraphPaginator.ts +++ b/clients/client-xray/pagination/GetServiceGraphPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetServiceGraphCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetServiceGraphCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetServiceGraphCommandInput, diff --git a/clients/client-xray/pagination/GetTimeSeriesServiceStatisticsPaginator.ts b/clients/client-xray/pagination/GetTimeSeriesServiceStatisticsPaginator.ts index 0d885d35d1c6e..b8251b312dff5 100644 --- a/clients/client-xray/pagination/GetTimeSeriesServiceStatisticsPaginator.ts +++ b/clients/client-xray/pagination/GetTimeSeriesServiceStatisticsPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetTimeSeriesServiceStatisticsCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTimeSeriesServiceStatisticsCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetTimeSeriesServiceStatisticsCommandInput, diff --git a/clients/client-xray/pagination/GetTraceGraphPaginator.ts b/clients/client-xray/pagination/GetTraceGraphPaginator.ts index c193f56d6dbed..cbc2b388c0c77 100644 --- a/clients/client-xray/pagination/GetTraceGraphPaginator.ts +++ b/clients/client-xray/pagination/GetTraceGraphPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetTraceGraphCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTraceGraphCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetTraceGraphCommandInput, diff --git a/clients/client-xray/pagination/GetTraceSummariesPaginator.ts b/clients/client-xray/pagination/GetTraceSummariesPaginator.ts index e69cf21b7e45e..c81eae81bc297 100644 --- a/clients/client-xray/pagination/GetTraceSummariesPaginator.ts +++ b/clients/client-xray/pagination/GetTraceSummariesPaginator.ts @@ -8,6 +8,9 @@ import { import { XRayPaginationConfiguration } from "./Interfaces"; import { Paginator } from "@aws-sdk/types"; +/** + * @private + */ const makePagedClientRequest = async ( client: XRayClient, input: GetTraceSummariesCommandInput, @@ -16,6 +19,9 @@ const makePagedClientRequest = async ( // @ts-ignore return await client.send(new GetTraceSummariesCommand(input), ...args); }; +/** + * @private + */ const makePagedRequest = async ( client: XRay, input: GetTraceSummariesCommandInput, diff --git a/clients/client-xray/runtimeConfig.browser.ts b/clients/client-xray/runtimeConfig.browser.ts index 8bbd31ad20959..4f815f4104ffb 100644 --- a/clients/client-xray/runtimeConfig.browser.ts +++ b/clients/client-xray/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./XRayClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/clients/client-xray/runtimeConfig.native.ts b/clients/client-xray/runtimeConfig.native.ts index 878d7b424f5dd..98479b6c516da 100644 --- a/clients/client-xray/runtimeConfig.native.ts +++ b/clients/client-xray/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./XRayClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/clients/client-xray/runtimeConfig.shared.ts b/clients/client-xray/runtimeConfig.shared.ts index aab8ff3ed7650..42ade9a2181f5 100644 --- a/clients/client-xray/runtimeConfig.shared.ts +++ b/clients/client-xray/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2016-04-12", disableHostPrefix: false, diff --git a/clients/client-xray/runtimeConfig.ts b/clients/client-xray/runtimeConfig.ts index 0539e89043da2..513597ae3219f 100644 --- a/clients/client-xray/runtimeConfig.ts +++ b/clients/client-xray/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./XRayClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/clients/client-xray/tsconfig.json b/clients/client-xray/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/clients/client-xray/tsconfig.json +++ b/clients/client-xray/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/protocol_tests/aws-ec2/commands/EmptyInputAndEmptyOutputCommand.ts b/protocol_tests/aws-ec2/commands/EmptyInputAndEmptyOutputCommand.ts index 26bc3b6d0cfb7..bbdc5057b0bd6 100644 --- a/protocol_tests/aws-ec2/commands/EmptyInputAndEmptyOutputCommand.ts +++ b/protocol_tests/aws-ec2/commands/EmptyInputAndEmptyOutputCommand.ts @@ -20,6 +20,12 @@ import { export type EmptyInputAndEmptyOutputCommandInput = EmptyInputAndEmptyOutputInput; export type EmptyInputAndEmptyOutputCommandOutput = EmptyInputAndEmptyOutputOutput & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response members. + * + * While this should be rare, code generators must support this. + */ export class EmptyInputAndEmptyOutputCommand extends $Command< EmptyInputAndEmptyOutputCommandInput, EmptyInputAndEmptyOutputCommandOutput, @@ -34,6 +40,9 @@ export class EmptyInputAndEmptyOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/GreetingWithErrorsCommand.ts b/protocol_tests/aws-ec2/commands/GreetingWithErrorsCommand.ts index d1932b46e5658..36217bfd4d0e9 100644 --- a/protocol_tests/aws-ec2/commands/GreetingWithErrorsCommand.ts +++ b/protocol_tests/aws-ec2/commands/GreetingWithErrorsCommand.ts @@ -20,6 +20,13 @@ import { export type GreetingWithErrorsCommandInput = {}; export type GreetingWithErrorsCommandOutput = GreetingWithErrorsOutput & __MetadataBearer; +/** + * This operation has three possible return values: + * + * 1. A successful response in the form of GreetingWithErrorsOutput + * 2. An InvalidGreeting error. + * 3. A BadRequest error. + */ export class GreetingWithErrorsCommand extends $Command< GreetingWithErrorsCommandInput, GreetingWithErrorsCommandOutput, @@ -34,6 +41,9 @@ export class GreetingWithErrorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/IgnoresWrappingXmlNameCommand.ts b/protocol_tests/aws-ec2/commands/IgnoresWrappingXmlNameCommand.ts index 4af805383ef49..43f054c727dbc 100644 --- a/protocol_tests/aws-ec2/commands/IgnoresWrappingXmlNameCommand.ts +++ b/protocol_tests/aws-ec2/commands/IgnoresWrappingXmlNameCommand.ts @@ -20,6 +20,11 @@ import { export type IgnoresWrappingXmlNameCommandInput = {}; export type IgnoresWrappingXmlNameCommandOutput = IgnoresWrappingXmlNameOutput & __MetadataBearer; +/** + * The xmlName trait on the output structure is ignored in AWS Query. + * + * The wrapping element is always operation name + "Response". + */ export class IgnoresWrappingXmlNameCommand extends $Command< IgnoresWrappingXmlNameCommandInput, IgnoresWrappingXmlNameCommandOutput, @@ -34,6 +39,9 @@ export class IgnoresWrappingXmlNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/NestedStructuresCommand.ts b/protocol_tests/aws-ec2/commands/NestedStructuresCommand.ts index cf01a45c8c490..c462d17d1f64d 100644 --- a/protocol_tests/aws-ec2/commands/NestedStructuresCommand.ts +++ b/protocol_tests/aws-ec2/commands/NestedStructuresCommand.ts @@ -20,6 +20,9 @@ import { export type NestedStructuresCommandInput = NestedStructuresInput; export type NestedStructuresCommandOutput = __MetadataBearer; +/** + * This test serializes nested and recursive structure members. + */ export class NestedStructuresCommand extends $Command< NestedStructuresCommandInput, NestedStructuresCommandOutput, @@ -34,6 +37,9 @@ export class NestedStructuresCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/NoInputAndOutputCommand.ts b/protocol_tests/aws-ec2/commands/NoInputAndOutputCommand.ts index d78a41cbc3bc2..0b65b6c265c30 100644 --- a/protocol_tests/aws-ec2/commands/NoInputAndOutputCommand.ts +++ b/protocol_tests/aws-ec2/commands/NoInputAndOutputCommand.ts @@ -20,6 +20,12 @@ import { export type NoInputAndOutputCommandInput = {}; export type NoInputAndOutputCommandOutput = NoInputAndOutputOutput & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request payload or response members. + * + * While this should be rare, code generators must support this. + */ export class NoInputAndOutputCommand extends $Command< NoInputAndOutputCommandInput, NoInputAndOutputCommandOutput, @@ -34,6 +40,9 @@ export class NoInputAndOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/QueryIdempotencyTokenAutoFillCommand.ts b/protocol_tests/aws-ec2/commands/QueryIdempotencyTokenAutoFillCommand.ts index 7d36f90da4a87..e46a5db75a968 100644 --- a/protocol_tests/aws-ec2/commands/QueryIdempotencyTokenAutoFillCommand.ts +++ b/protocol_tests/aws-ec2/commands/QueryIdempotencyTokenAutoFillCommand.ts @@ -20,6 +20,9 @@ import { export type QueryIdempotencyTokenAutoFillCommandInput = QueryIdempotencyTokenAutoFillInput; export type QueryIdempotencyTokenAutoFillCommandOutput = __MetadataBearer; +/** + * Automatically adds idempotency tokens. + */ export class QueryIdempotencyTokenAutoFillCommand extends $Command< QueryIdempotencyTokenAutoFillCommandInput, QueryIdempotencyTokenAutoFillCommandOutput, @@ -34,6 +37,9 @@ export class QueryIdempotencyTokenAutoFillCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/QueryListsCommand.ts b/protocol_tests/aws-ec2/commands/QueryListsCommand.ts index 745c1cb7d8559..01519a32a6d8f 100644 --- a/protocol_tests/aws-ec2/commands/QueryListsCommand.ts +++ b/protocol_tests/aws-ec2/commands/QueryListsCommand.ts @@ -17,6 +17,9 @@ import { export type QueryListsCommandInput = QueryListsInput; export type QueryListsCommandOutput = __MetadataBearer; +/** + * This test serializes simple and complex lists. + */ export class QueryListsCommand extends $Command< QueryListsCommandInput, QueryListsCommandOutput, @@ -31,6 +34,9 @@ export class QueryListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/QueryTimestampsCommand.ts b/protocol_tests/aws-ec2/commands/QueryTimestampsCommand.ts index a54265c3ae11a..96a20df7fd36f 100644 --- a/protocol_tests/aws-ec2/commands/QueryTimestampsCommand.ts +++ b/protocol_tests/aws-ec2/commands/QueryTimestampsCommand.ts @@ -17,6 +17,13 @@ import { export type QueryTimestampsCommandInput = QueryTimestampsInput; export type QueryTimestampsCommandOutput = __MetadataBearer; +/** + * This test serializes timestamps. + * + * 1. Timestamps are serialized as RFC 3339 date-time values by default. + * 2. A timestampFormat trait on a member changes the format. + * 3. A timestampFormat trait on the shape targeted by the member changes the format. + */ export class QueryTimestampsCommand extends $Command< QueryTimestampsCommandInput, QueryTimestampsCommandOutput, @@ -31,6 +38,9 @@ export class QueryTimestampsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/RecursiveXmlShapesCommand.ts b/protocol_tests/aws-ec2/commands/RecursiveXmlShapesCommand.ts index 237dcd48584ee..cf45987532338 100644 --- a/protocol_tests/aws-ec2/commands/RecursiveXmlShapesCommand.ts +++ b/protocol_tests/aws-ec2/commands/RecursiveXmlShapesCommand.ts @@ -20,6 +20,9 @@ import { export type RecursiveXmlShapesCommandInput = {}; export type RecursiveXmlShapesCommandOutput = RecursiveXmlShapesOutput & __MetadataBearer; +/** + * Recursive shapes + */ export class RecursiveXmlShapesCommand extends $Command< RecursiveXmlShapesCommandInput, RecursiveXmlShapesCommandOutput, @@ -34,6 +37,9 @@ export class RecursiveXmlShapesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/SimpleInputParamsCommand.ts b/protocol_tests/aws-ec2/commands/SimpleInputParamsCommand.ts index 3a0eab2c6d917..9dd97e3f182d9 100644 --- a/protocol_tests/aws-ec2/commands/SimpleInputParamsCommand.ts +++ b/protocol_tests/aws-ec2/commands/SimpleInputParamsCommand.ts @@ -20,6 +20,9 @@ import { export type SimpleInputParamsCommandInput = SimpleInputParamsInput; export type SimpleInputParamsCommandOutput = __MetadataBearer; +/** + * This test serializes strings, numbers, and boolean values. + */ export class SimpleInputParamsCommand extends $Command< SimpleInputParamsCommandInput, SimpleInputParamsCommandOutput, @@ -34,6 +37,9 @@ export class SimpleInputParamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/SimpleScalarXmlPropertiesCommand.ts b/protocol_tests/aws-ec2/commands/SimpleScalarXmlPropertiesCommand.ts index 235324dff80a5..5bed60e088489 100644 --- a/protocol_tests/aws-ec2/commands/SimpleScalarXmlPropertiesCommand.ts +++ b/protocol_tests/aws-ec2/commands/SimpleScalarXmlPropertiesCommand.ts @@ -34,6 +34,9 @@ export class SimpleScalarXmlPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/XmlBlobsCommand.ts b/protocol_tests/aws-ec2/commands/XmlBlobsCommand.ts index e076b3bc9d95c..15e32fe43bdb0 100644 --- a/protocol_tests/aws-ec2/commands/XmlBlobsCommand.ts +++ b/protocol_tests/aws-ec2/commands/XmlBlobsCommand.ts @@ -17,6 +17,9 @@ import { export type XmlBlobsCommandInput = {}; export type XmlBlobsCommandOutput = XmlBlobsOutput & __MetadataBearer; +/** + * Blobs are base64 encoded + */ export class XmlBlobsCommand extends $Command< XmlBlobsCommandInput, XmlBlobsCommandOutput, @@ -31,6 +34,9 @@ export class XmlBlobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/XmlEnumsCommand.ts b/protocol_tests/aws-ec2/commands/XmlEnumsCommand.ts index 0125697ee2b79..2cf73c999ef65 100644 --- a/protocol_tests/aws-ec2/commands/XmlEnumsCommand.ts +++ b/protocol_tests/aws-ec2/commands/XmlEnumsCommand.ts @@ -17,6 +17,9 @@ import { export type XmlEnumsCommandInput = {}; export type XmlEnumsCommandOutput = XmlEnumsOutput & __MetadataBearer; +/** + * This example serializes enums as top level properties, in lists, sets, and maps. + */ export class XmlEnumsCommand extends $Command< XmlEnumsCommandInput, XmlEnumsCommandOutput, @@ -31,6 +34,9 @@ export class XmlEnumsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/XmlListsCommand.ts b/protocol_tests/aws-ec2/commands/XmlListsCommand.ts index bc30c71d66d7a..8d956d6c7a703 100644 --- a/protocol_tests/aws-ec2/commands/XmlListsCommand.ts +++ b/protocol_tests/aws-ec2/commands/XmlListsCommand.ts @@ -17,6 +17,18 @@ import { export type XmlListsCommandInput = {}; export type XmlListsCommandOutput = XmlListsOutput & __MetadataBearer; +/** + * This test case serializes XML lists for the following cases for both + * input and output: + * + * 1. Normal XML lists. + * 2. Normal XML sets. + * 3. XML lists of lists. + * 4. XML lists with @xmlName on its members + * 5. Flattened XML lists. + * 6. Flattened XML lists with @xmlName. + * 7. Lists of structures. + */ export class XmlListsCommand extends $Command< XmlListsCommandInput, XmlListsCommandOutput, @@ -31,6 +43,9 @@ export class XmlListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/XmlNamespacesCommand.ts b/protocol_tests/aws-ec2/commands/XmlNamespacesCommand.ts index 764d0ac426d4e..3df7f43acbc98 100644 --- a/protocol_tests/aws-ec2/commands/XmlNamespacesCommand.ts +++ b/protocol_tests/aws-ec2/commands/XmlNamespacesCommand.ts @@ -31,6 +31,9 @@ export class XmlNamespacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/commands/XmlTimestampsCommand.ts b/protocol_tests/aws-ec2/commands/XmlTimestampsCommand.ts index 02fd2e183a442..a974a608d3cee 100644 --- a/protocol_tests/aws-ec2/commands/XmlTimestampsCommand.ts +++ b/protocol_tests/aws-ec2/commands/XmlTimestampsCommand.ts @@ -17,6 +17,11 @@ import { export type XmlTimestampsCommandInput = {}; export type XmlTimestampsCommandOutput = XmlTimestampsOutput & __MetadataBearer; +/** + * This tests how timestamps are serialized, including using the + * default format of date-time and various @timestampFormat trait + * values. + */ export class XmlTimestampsCommand extends $Command< XmlTimestampsCommandInput, XmlTimestampsCommandOutput, @@ -31,6 +36,9 @@ export class XmlTimestampsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: EC2ProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-ec2/package.json b/protocol_tests/aws-ec2/package.json index 56cbd0067172f..71aaa720d9136 100644 --- a/protocol_tests/aws-ec2/package.json +++ b/protocol_tests/aws-ec2/package.json @@ -3,8 +3,8 @@ "description": "@aws-sdk/aws-ec2 client", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/protocol_tests/aws-ec2/runtimeConfig.browser.ts b/protocol_tests/aws-ec2/runtimeConfig.browser.ts index ffa2084a9644c..e41052307cd7c 100644 --- a/protocol_tests/aws-ec2/runtimeConfig.browser.ts +++ b/protocol_tests/aws-ec2/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./EC2ProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/protocol_tests/aws-ec2/runtimeConfig.native.ts b/protocol_tests/aws-ec2/runtimeConfig.native.ts index 703ff8b883345..e260a640a0686 100644 --- a/protocol_tests/aws-ec2/runtimeConfig.native.ts +++ b/protocol_tests/aws-ec2/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./EC2ProtocolClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/protocol_tests/aws-ec2/runtimeConfig.shared.ts b/protocol_tests/aws-ec2/runtimeConfig.shared.ts index 7aee17639e91d..88516b4c67c26 100644 --- a/protocol_tests/aws-ec2/runtimeConfig.shared.ts +++ b/protocol_tests/aws-ec2/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-01-08", disableHostPrefix: false, diff --git a/protocol_tests/aws-ec2/runtimeConfig.ts b/protocol_tests/aws-ec2/runtimeConfig.ts index c93c5479f2365..ae050c8c75f8e 100644 --- a/protocol_tests/aws-ec2/runtimeConfig.ts +++ b/protocol_tests/aws-ec2/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./EC2ProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/protocol_tests/aws-ec2/tsconfig.json b/protocol_tests/aws-ec2/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/protocol_tests/aws-ec2/tsconfig.json +++ b/protocol_tests/aws-ec2/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/protocol_tests/aws-json/commands/EmptyOperationCommand.ts b/protocol_tests/aws-json/commands/EmptyOperationCommand.ts index 943937afe261d..d9ce84a2f633e 100644 --- a/protocol_tests/aws-json/commands/EmptyOperationCommand.ts +++ b/protocol_tests/aws-json/commands/EmptyOperationCommand.ts @@ -33,6 +33,9 @@ export class EmptyOperationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: JsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-json/commands/KitchenSinkOperationCommand.ts b/protocol_tests/aws-json/commands/KitchenSinkOperationCommand.ts index 6e57bc91fe722..7e2f379346594 100644 --- a/protocol_tests/aws-json/commands/KitchenSinkOperationCommand.ts +++ b/protocol_tests/aws-json/commands/KitchenSinkOperationCommand.ts @@ -34,6 +34,9 @@ export class KitchenSinkOperationCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: JsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-json/commands/OperationWithOptionalInputOutputCommand.ts b/protocol_tests/aws-json/commands/OperationWithOptionalInputOutputCommand.ts index 02ed3cd0db0ab..4469aee5c3e85 100644 --- a/protocol_tests/aws-json/commands/OperationWithOptionalInputOutputCommand.ts +++ b/protocol_tests/aws-json/commands/OperationWithOptionalInputOutputCommand.ts @@ -34,6 +34,9 @@ export class OperationWithOptionalInputOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: JsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-json/package.json b/protocol_tests/aws-json/package.json index 228cb86cab993..81f4c550dd54a 100644 --- a/protocol_tests/aws-json/package.json +++ b/protocol_tests/aws-json/package.json @@ -3,8 +3,8 @@ "description": "@aws-sdk/aws-json client", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -65,7 +65,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/protocol_tests/aws-json/runtimeConfig.browser.ts b/protocol_tests/aws-json/runtimeConfig.browser.ts index fd374133ab5b5..4de4319902285 100644 --- a/protocol_tests/aws-json/runtimeConfig.browser.ts +++ b/protocol_tests/aws-json/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./JsonProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/protocol_tests/aws-json/runtimeConfig.native.ts b/protocol_tests/aws-json/runtimeConfig.native.ts index 62c560176c120..eecffc6983a39 100644 --- a/protocol_tests/aws-json/runtimeConfig.native.ts +++ b/protocol_tests/aws-json/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./JsonProtocolClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/protocol_tests/aws-json/runtimeConfig.shared.ts b/protocol_tests/aws-json/runtimeConfig.shared.ts index adf814158d6d5..dfe62aa5ee662 100644 --- a/protocol_tests/aws-json/runtimeConfig.shared.ts +++ b/protocol_tests/aws-json/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2018-01-01", disableHostPrefix: false, diff --git a/protocol_tests/aws-json/runtimeConfig.ts b/protocol_tests/aws-json/runtimeConfig.ts index bf9123784261d..312ebcb617713 100644 --- a/protocol_tests/aws-json/runtimeConfig.ts +++ b/protocol_tests/aws-json/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./JsonProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/protocol_tests/aws-json/tsconfig.json b/protocol_tests/aws-json/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/protocol_tests/aws-json/tsconfig.json +++ b/protocol_tests/aws-json/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/protocol_tests/aws-query/commands/EmptyInputAndEmptyOutputCommand.ts b/protocol_tests/aws-query/commands/EmptyInputAndEmptyOutputCommand.ts index 668017cab9f9d..7820dde27f2e4 100644 --- a/protocol_tests/aws-query/commands/EmptyInputAndEmptyOutputCommand.ts +++ b/protocol_tests/aws-query/commands/EmptyInputAndEmptyOutputCommand.ts @@ -20,6 +20,12 @@ import { export type EmptyInputAndEmptyOutputCommandInput = EmptyInputAndEmptyOutputInput; export type EmptyInputAndEmptyOutputCommandOutput = EmptyInputAndEmptyOutputOutput & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response members. + * + * While this should be rare, code generators must support this. + */ export class EmptyInputAndEmptyOutputCommand extends $Command< EmptyInputAndEmptyOutputCommandInput, EmptyInputAndEmptyOutputCommandOutput, @@ -34,6 +40,9 @@ export class EmptyInputAndEmptyOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/FlattenedXmlMapCommand.ts b/protocol_tests/aws-query/commands/FlattenedXmlMapCommand.ts index 5d5cccbf1fb00..3a2a0df6c28e5 100644 --- a/protocol_tests/aws-query/commands/FlattenedXmlMapCommand.ts +++ b/protocol_tests/aws-query/commands/FlattenedXmlMapCommand.ts @@ -20,6 +20,9 @@ import { export type FlattenedXmlMapCommandInput = {}; export type FlattenedXmlMapCommandOutput = FlattenedXmlMapOutput & __MetadataBearer; +/** + * Flattened maps + */ export class FlattenedXmlMapCommand extends $Command< FlattenedXmlMapCommandInput, FlattenedXmlMapCommandOutput, @@ -34,6 +37,9 @@ export class FlattenedXmlMapCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/FlattenedXmlMapWithXmlNameCommand.ts b/protocol_tests/aws-query/commands/FlattenedXmlMapWithXmlNameCommand.ts index 94fdd3545d6f3..76506c780d3e1 100644 --- a/protocol_tests/aws-query/commands/FlattenedXmlMapWithXmlNameCommand.ts +++ b/protocol_tests/aws-query/commands/FlattenedXmlMapWithXmlNameCommand.ts @@ -20,6 +20,9 @@ import { export type FlattenedXmlMapWithXmlNameCommandInput = {}; export type FlattenedXmlMapWithXmlNameCommandOutput = FlattenedXmlMapWithXmlNameOutput & __MetadataBearer; +/** + * Flattened maps with @xmlName + */ export class FlattenedXmlMapWithXmlNameCommand extends $Command< FlattenedXmlMapWithXmlNameCommandInput, FlattenedXmlMapWithXmlNameCommandOutput, @@ -34,6 +37,9 @@ export class FlattenedXmlMapWithXmlNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/GreetingWithErrorsCommand.ts b/protocol_tests/aws-query/commands/GreetingWithErrorsCommand.ts index a068f9883acf1..345907d9cb0ee 100644 --- a/protocol_tests/aws-query/commands/GreetingWithErrorsCommand.ts +++ b/protocol_tests/aws-query/commands/GreetingWithErrorsCommand.ts @@ -20,6 +20,13 @@ import { export type GreetingWithErrorsCommandInput = {}; export type GreetingWithErrorsCommandOutput = GreetingWithErrorsOutput & __MetadataBearer; +/** + * This operation has three possible return values: + * + * 1. A successful response in the form of GreetingWithErrorsOutput + * 2. An InvalidGreeting error. + * 3. A BadRequest error. + */ export class GreetingWithErrorsCommand extends $Command< GreetingWithErrorsCommandInput, GreetingWithErrorsCommandOutput, @@ -34,6 +41,9 @@ export class GreetingWithErrorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/IgnoresWrappingXmlNameCommand.ts b/protocol_tests/aws-query/commands/IgnoresWrappingXmlNameCommand.ts index 9bf992db9bd2a..9915f29870de3 100644 --- a/protocol_tests/aws-query/commands/IgnoresWrappingXmlNameCommand.ts +++ b/protocol_tests/aws-query/commands/IgnoresWrappingXmlNameCommand.ts @@ -20,6 +20,12 @@ import { export type IgnoresWrappingXmlNameCommandInput = {}; export type IgnoresWrappingXmlNameCommandOutput = IgnoresWrappingXmlNameOutput & __MetadataBearer; +/** + * The xmlName trait on the output structure is ignored in AWS Query. + * + * The wrapping element is always operation name + "Response", and + * inside of that wrapper is another wrapper named operation name + "Result". + */ export class IgnoresWrappingXmlNameCommand extends $Command< IgnoresWrappingXmlNameCommandInput, IgnoresWrappingXmlNameCommandOutput, @@ -34,6 +40,9 @@ export class IgnoresWrappingXmlNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/NestedStructuresCommand.ts b/protocol_tests/aws-query/commands/NestedStructuresCommand.ts index 36850108d95ba..aa675359b1e31 100644 --- a/protocol_tests/aws-query/commands/NestedStructuresCommand.ts +++ b/protocol_tests/aws-query/commands/NestedStructuresCommand.ts @@ -20,6 +20,9 @@ import { export type NestedStructuresCommandInput = NestedStructuresInput; export type NestedStructuresCommandOutput = __MetadataBearer; +/** + * This test serializes nested and recursive structure members. + */ export class NestedStructuresCommand extends $Command< NestedStructuresCommandInput, NestedStructuresCommandOutput, @@ -34,6 +37,9 @@ export class NestedStructuresCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/NoInputAndNoOutputCommand.ts b/protocol_tests/aws-query/commands/NoInputAndNoOutputCommand.ts index 2d32358ce3ea4..04f1e963c7e3c 100644 --- a/protocol_tests/aws-query/commands/NoInputAndNoOutputCommand.ts +++ b/protocol_tests/aws-query/commands/NoInputAndNoOutputCommand.ts @@ -19,6 +19,12 @@ import { export type NoInputAndNoOutputCommandInput = {}; export type NoInputAndNoOutputCommandOutput = __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response payload because the operation has no input or output. + * + * While this should be rare, code generators must support this. + */ export class NoInputAndNoOutputCommand extends $Command< NoInputAndNoOutputCommandInput, NoInputAndNoOutputCommandOutput, @@ -33,6 +39,9 @@ export class NoInputAndNoOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/NoInputAndOutputCommand.ts b/protocol_tests/aws-query/commands/NoInputAndOutputCommand.ts index 077dd66e6b9ec..a969f4eaa79e4 100644 --- a/protocol_tests/aws-query/commands/NoInputAndOutputCommand.ts +++ b/protocol_tests/aws-query/commands/NoInputAndOutputCommand.ts @@ -20,6 +20,12 @@ import { export type NoInputAndOutputCommandInput = NoInputAndOutputOutput; export type NoInputAndOutputCommandOutput = __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request payload or response members. + * + * While this should be rare, code generators must support this. + */ export class NoInputAndOutputCommand extends $Command< NoInputAndOutputCommandInput, NoInputAndOutputCommandOutput, @@ -34,6 +40,9 @@ export class NoInputAndOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/QueryIdempotencyTokenAutoFillCommand.ts b/protocol_tests/aws-query/commands/QueryIdempotencyTokenAutoFillCommand.ts index 4a0f216ecb70f..cfabd521c20c0 100644 --- a/protocol_tests/aws-query/commands/QueryIdempotencyTokenAutoFillCommand.ts +++ b/protocol_tests/aws-query/commands/QueryIdempotencyTokenAutoFillCommand.ts @@ -20,6 +20,9 @@ import { export type QueryIdempotencyTokenAutoFillCommandInput = QueryIdempotencyTokenAutoFillInput; export type QueryIdempotencyTokenAutoFillCommandOutput = __MetadataBearer; +/** + * Automatically adds idempotency tokens. + */ export class QueryIdempotencyTokenAutoFillCommand extends $Command< QueryIdempotencyTokenAutoFillCommandInput, QueryIdempotencyTokenAutoFillCommandOutput, @@ -34,6 +37,9 @@ export class QueryIdempotencyTokenAutoFillCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/QueryListsCommand.ts b/protocol_tests/aws-query/commands/QueryListsCommand.ts index 9ff2188602def..208bc10340353 100644 --- a/protocol_tests/aws-query/commands/QueryListsCommand.ts +++ b/protocol_tests/aws-query/commands/QueryListsCommand.ts @@ -17,6 +17,9 @@ import { export type QueryListsCommandInput = QueryListsInput; export type QueryListsCommandOutput = __MetadataBearer; +/** + * This test serializes simple and complex lists. + */ export class QueryListsCommand extends $Command< QueryListsCommandInput, QueryListsCommandOutput, @@ -31,6 +34,9 @@ export class QueryListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/QueryMapsCommand.ts b/protocol_tests/aws-query/commands/QueryMapsCommand.ts index 05a74fdf664f4..ec5d4d7af4b15 100644 --- a/protocol_tests/aws-query/commands/QueryMapsCommand.ts +++ b/protocol_tests/aws-query/commands/QueryMapsCommand.ts @@ -17,6 +17,9 @@ import { export type QueryMapsCommandInput = QueryMapsInput; export type QueryMapsCommandOutput = __MetadataBearer; +/** + * This test serializes simple and complex maps. + */ export class QueryMapsCommand extends $Command< QueryMapsCommandInput, QueryMapsCommandOutput, @@ -31,6 +34,9 @@ export class QueryMapsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/QueryTimestampsCommand.ts b/protocol_tests/aws-query/commands/QueryTimestampsCommand.ts index f23f9d656c022..7b943dfaaecaa 100644 --- a/protocol_tests/aws-query/commands/QueryTimestampsCommand.ts +++ b/protocol_tests/aws-query/commands/QueryTimestampsCommand.ts @@ -20,6 +20,13 @@ import { export type QueryTimestampsCommandInput = QueryTimestampsInput; export type QueryTimestampsCommandOutput = __MetadataBearer; +/** + * This test serializes timestamps. + * + * 1. Timestamps are serialized as RFC 3339 date-time values by default. + * 2. A timestampFormat trait on a member changes the format. + * 3. A timestampFormat trait on the shape targeted by the member changes the format. + */ export class QueryTimestampsCommand extends $Command< QueryTimestampsCommandInput, QueryTimestampsCommandOutput, @@ -34,6 +41,9 @@ export class QueryTimestampsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/RecursiveXmlShapesCommand.ts b/protocol_tests/aws-query/commands/RecursiveXmlShapesCommand.ts index fca237b9d01be..a1d5fef2e6f59 100644 --- a/protocol_tests/aws-query/commands/RecursiveXmlShapesCommand.ts +++ b/protocol_tests/aws-query/commands/RecursiveXmlShapesCommand.ts @@ -20,6 +20,9 @@ import { export type RecursiveXmlShapesCommandInput = {}; export type RecursiveXmlShapesCommandOutput = RecursiveXmlShapesOutput & __MetadataBearer; +/** + * Recursive shapes + */ export class RecursiveXmlShapesCommand extends $Command< RecursiveXmlShapesCommandInput, RecursiveXmlShapesCommandOutput, @@ -34,6 +37,9 @@ export class RecursiveXmlShapesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/SimpleInputParamsCommand.ts b/protocol_tests/aws-query/commands/SimpleInputParamsCommand.ts index e0a1534614f8a..9af6020036ae5 100644 --- a/protocol_tests/aws-query/commands/SimpleInputParamsCommand.ts +++ b/protocol_tests/aws-query/commands/SimpleInputParamsCommand.ts @@ -20,6 +20,9 @@ import { export type SimpleInputParamsCommandInput = SimpleInputParamsInput; export type SimpleInputParamsCommandOutput = __MetadataBearer; +/** + * This test serializes strings, numbers, and boolean values. + */ export class SimpleInputParamsCommand extends $Command< SimpleInputParamsCommandInput, SimpleInputParamsCommandOutput, @@ -34,6 +37,9 @@ export class SimpleInputParamsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/SimpleScalarXmlPropertiesCommand.ts b/protocol_tests/aws-query/commands/SimpleScalarXmlPropertiesCommand.ts index 0cf2ed9280f60..5c6eaf168d885 100644 --- a/protocol_tests/aws-query/commands/SimpleScalarXmlPropertiesCommand.ts +++ b/protocol_tests/aws-query/commands/SimpleScalarXmlPropertiesCommand.ts @@ -34,6 +34,9 @@ export class SimpleScalarXmlPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/XmlBlobsCommand.ts b/protocol_tests/aws-query/commands/XmlBlobsCommand.ts index 319a2b05512f0..c062887902079 100644 --- a/protocol_tests/aws-query/commands/XmlBlobsCommand.ts +++ b/protocol_tests/aws-query/commands/XmlBlobsCommand.ts @@ -17,6 +17,9 @@ import { export type XmlBlobsCommandInput = {}; export type XmlBlobsCommandOutput = XmlBlobsOutput & __MetadataBearer; +/** + * Blobs are base64 encoded + */ export class XmlBlobsCommand extends $Command< XmlBlobsCommandInput, XmlBlobsCommandOutput, @@ -31,6 +34,9 @@ export class XmlBlobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/XmlEnumsCommand.ts b/protocol_tests/aws-query/commands/XmlEnumsCommand.ts index 6aa10927f244d..3fffc1fbe07a4 100644 --- a/protocol_tests/aws-query/commands/XmlEnumsCommand.ts +++ b/protocol_tests/aws-query/commands/XmlEnumsCommand.ts @@ -17,6 +17,9 @@ import { export type XmlEnumsCommandInput = {}; export type XmlEnumsCommandOutput = XmlEnumsOutput & __MetadataBearer; +/** + * This example serializes enums as top level properties, in lists, sets, and maps. + */ export class XmlEnumsCommand extends $Command< XmlEnumsCommandInput, XmlEnumsCommandOutput, @@ -31,6 +34,9 @@ export class XmlEnumsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/XmlListsCommand.ts b/protocol_tests/aws-query/commands/XmlListsCommand.ts index e5842456c7511..c6b4747e52c03 100644 --- a/protocol_tests/aws-query/commands/XmlListsCommand.ts +++ b/protocol_tests/aws-query/commands/XmlListsCommand.ts @@ -17,6 +17,18 @@ import { export type XmlListsCommandInput = {}; export type XmlListsCommandOutput = XmlListsOutput & __MetadataBearer; +/** + * This test case serializes XML lists for the following cases for both + * input and output: + * + * 1. Normal XML lists. + * 2. Normal XML sets. + * 3. XML lists of lists. + * 4. XML lists with @xmlName on its members + * 5. Flattened XML lists. + * 6. Flattened XML lists with @xmlName. + * 7. Lists of structures. + */ export class XmlListsCommand extends $Command< XmlListsCommandInput, XmlListsCommandOutput, @@ -31,6 +43,9 @@ export class XmlListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/XmlMapsCommand.ts b/protocol_tests/aws-query/commands/XmlMapsCommand.ts index 329045ff7db9c..45581ebf733f5 100644 --- a/protocol_tests/aws-query/commands/XmlMapsCommand.ts +++ b/protocol_tests/aws-query/commands/XmlMapsCommand.ts @@ -17,6 +17,9 @@ import { export type XmlMapsCommandInput = {}; export type XmlMapsCommandOutput = XmlMapsOutput & __MetadataBearer; +/** + * The example tests basic map serialization. + */ export class XmlMapsCommand extends $Command< XmlMapsCommandInput, XmlMapsCommandOutput, @@ -31,6 +34,9 @@ export class XmlMapsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/XmlMapsXmlNameCommand.ts b/protocol_tests/aws-query/commands/XmlMapsXmlNameCommand.ts index b5a0722a2aa83..0b2a53141d931 100644 --- a/protocol_tests/aws-query/commands/XmlMapsXmlNameCommand.ts +++ b/protocol_tests/aws-query/commands/XmlMapsXmlNameCommand.ts @@ -34,6 +34,9 @@ export class XmlMapsXmlNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/XmlNamespacesCommand.ts b/protocol_tests/aws-query/commands/XmlNamespacesCommand.ts index fbbfb8ecc398b..44fa14343950b 100644 --- a/protocol_tests/aws-query/commands/XmlNamespacesCommand.ts +++ b/protocol_tests/aws-query/commands/XmlNamespacesCommand.ts @@ -34,6 +34,9 @@ export class XmlNamespacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/commands/XmlTimestampsCommand.ts b/protocol_tests/aws-query/commands/XmlTimestampsCommand.ts index d1fa70cd12c56..79528fd4929cb 100644 --- a/protocol_tests/aws-query/commands/XmlTimestampsCommand.ts +++ b/protocol_tests/aws-query/commands/XmlTimestampsCommand.ts @@ -20,6 +20,11 @@ import { export type XmlTimestampsCommandInput = {}; export type XmlTimestampsCommandOutput = XmlTimestampsOutput & __MetadataBearer; +/** + * This tests how timestamps are serialized, including using the + * default format of date-time and various @timestampFormat trait + * values. + */ export class XmlTimestampsCommand extends $Command< XmlTimestampsCommandInput, XmlTimestampsCommandOutput, @@ -34,6 +39,9 @@ export class XmlTimestampsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: QueryProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-query/package.json b/protocol_tests/aws-query/package.json index 61d0991817713..3346a60d31e73 100644 --- a/protocol_tests/aws-query/package.json +++ b/protocol_tests/aws-query/package.json @@ -3,8 +3,8 @@ "description": "@aws-sdk/aws-query client", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/protocol_tests/aws-query/runtimeConfig.browser.ts b/protocol_tests/aws-query/runtimeConfig.browser.ts index 481ddf71cbf5d..e7e3ae135eb83 100644 --- a/protocol_tests/aws-query/runtimeConfig.browser.ts +++ b/protocol_tests/aws-query/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./QueryProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/protocol_tests/aws-query/runtimeConfig.native.ts b/protocol_tests/aws-query/runtimeConfig.native.ts index dd373cb86aa91..819b612eaeee6 100644 --- a/protocol_tests/aws-query/runtimeConfig.native.ts +++ b/protocol_tests/aws-query/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./QueryProtocolClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/protocol_tests/aws-query/runtimeConfig.shared.ts b/protocol_tests/aws-query/runtimeConfig.shared.ts index d3abd6f709af2..c261363f96533 100644 --- a/protocol_tests/aws-query/runtimeConfig.shared.ts +++ b/protocol_tests/aws-query/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2020-01-08", disableHostPrefix: false, diff --git a/protocol_tests/aws-query/runtimeConfig.ts b/protocol_tests/aws-query/runtimeConfig.ts index 56e96a6ea036a..b3943e52edade 100644 --- a/protocol_tests/aws-query/runtimeConfig.ts +++ b/protocol_tests/aws-query/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./QueryProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/protocol_tests/aws-query/tsconfig.json b/protocol_tests/aws-query/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/protocol_tests/aws-query/tsconfig.json +++ b/protocol_tests/aws-query/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/protocol_tests/aws-restjson/commands/AllQueryStringTypesCommand.ts b/protocol_tests/aws-restjson/commands/AllQueryStringTypesCommand.ts index bb557ec05dad5..934891bc4bbad 100644 --- a/protocol_tests/aws-restjson/commands/AllQueryStringTypesCommand.ts +++ b/protocol_tests/aws-restjson/commands/AllQueryStringTypesCommand.ts @@ -20,6 +20,9 @@ import { export type AllQueryStringTypesCommandInput = AllQueryStringTypesInput; export type AllQueryStringTypesCommandOutput = __MetadataBearer; +/** + * This example uses all query string types. + */ export class AllQueryStringTypesCommand extends $Command< AllQueryStringTypesCommandInput, AllQueryStringTypesCommandOutput, @@ -34,6 +37,9 @@ export class AllQueryStringTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/ConstantAndVariableQueryStringCommand.ts b/protocol_tests/aws-restjson/commands/ConstantAndVariableQueryStringCommand.ts index bb6b7de6d8437..877a75d3fa26e 100644 --- a/protocol_tests/aws-restjson/commands/ConstantAndVariableQueryStringCommand.ts +++ b/protocol_tests/aws-restjson/commands/ConstantAndVariableQueryStringCommand.ts @@ -20,6 +20,11 @@ import { export type ConstantAndVariableQueryStringCommandInput = ConstantAndVariableQueryStringInput; export type ConstantAndVariableQueryStringCommandOutput = __MetadataBearer; +/** + * This example uses fixed query string params and variable query string params. + * The fixed query string parameters and variable parameters must both be + * serialized (implementations may need to merge them together). + */ export class ConstantAndVariableQueryStringCommand extends $Command< ConstantAndVariableQueryStringCommandInput, ConstantAndVariableQueryStringCommandOutput, @@ -34,6 +39,9 @@ export class ConstantAndVariableQueryStringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/ConstantQueryStringCommand.ts b/protocol_tests/aws-restjson/commands/ConstantQueryStringCommand.ts index 0bb1663cea29a..868f6bf2d39fa 100644 --- a/protocol_tests/aws-restjson/commands/ConstantQueryStringCommand.ts +++ b/protocol_tests/aws-restjson/commands/ConstantQueryStringCommand.ts @@ -20,6 +20,12 @@ import { export type ConstantQueryStringCommandInput = ConstantQueryStringInput; export type ConstantQueryStringCommandOutput = __MetadataBearer; +/** + * This example uses a constant query string parameters and a label. + * This simply tests that labels and query string parameters are + * compatible. The fixed query string parameter named "hello" should + * in no way conflict with the label, `{hello}`. + */ export class ConstantQueryStringCommand extends $Command< ConstantQueryStringCommandInput, ConstantQueryStringCommandOutput, @@ -34,6 +40,9 @@ export class ConstantQueryStringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/EmptyInputAndEmptyOutputCommand.ts b/protocol_tests/aws-restjson/commands/EmptyInputAndEmptyOutputCommand.ts index 5f0db973d89b3..4bef37d70a01f 100644 --- a/protocol_tests/aws-restjson/commands/EmptyInputAndEmptyOutputCommand.ts +++ b/protocol_tests/aws-restjson/commands/EmptyInputAndEmptyOutputCommand.ts @@ -20,6 +20,12 @@ import { export type EmptyInputAndEmptyOutputCommandInput = EmptyInputAndEmptyOutputInput; export type EmptyInputAndEmptyOutputCommandOutput = EmptyInputAndEmptyOutputOutput & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response payload because the operation has an empty input + * and empty output structure that reuses the same shape. While this should + * be rare, code generators must support this. + */ export class EmptyInputAndEmptyOutputCommand extends $Command< EmptyInputAndEmptyOutputCommandInput, EmptyInputAndEmptyOutputCommandOutput, @@ -34,6 +40,9 @@ export class EmptyInputAndEmptyOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/GreetingWithErrorsCommand.ts b/protocol_tests/aws-restjson/commands/GreetingWithErrorsCommand.ts index 32b3eb2462c13..abc339b582dcc 100644 --- a/protocol_tests/aws-restjson/commands/GreetingWithErrorsCommand.ts +++ b/protocol_tests/aws-restjson/commands/GreetingWithErrorsCommand.ts @@ -20,6 +20,18 @@ import { export type GreetingWithErrorsCommandInput = {}; export type GreetingWithErrorsCommandOutput = GreetingWithErrorsOutput & __MetadataBearer; +/** + * This operation has four possible return values: + * + * 1. A successful response in the form of GreetingWithErrorsOutput + * 2. An InvalidGreeting error. + * 3. A BadRequest error. + * 4. A FooError. + * + * Implementations must be able to successfully take a response and + * properly (de)serialize successful and error responses based on the + * the presence of the + */ export class GreetingWithErrorsCommand extends $Command< GreetingWithErrorsCommandInput, GreetingWithErrorsCommandOutput, @@ -34,6 +46,9 @@ export class GreetingWithErrorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/HttpPayloadTraitsCommand.ts b/protocol_tests/aws-restjson/commands/HttpPayloadTraitsCommand.ts index c8e84228c717e..3202b3ecf4c99 100644 --- a/protocol_tests/aws-restjson/commands/HttpPayloadTraitsCommand.ts +++ b/protocol_tests/aws-restjson/commands/HttpPayloadTraitsCommand.ts @@ -20,6 +20,12 @@ import { export type HttpPayloadTraitsCommandInput = HttpPayloadTraitsInputOutput; export type HttpPayloadTraitsCommandOutput = HttpPayloadTraitsInputOutput & __MetadataBearer; +/** + * This examples serializes a blob shape in the payload. + * + * In this example, no JSON document is synthesized because the payload is + * not a structure or a union type. + */ export class HttpPayloadTraitsCommand extends $Command< HttpPayloadTraitsCommandInput, HttpPayloadTraitsCommandOutput, @@ -34,6 +40,9 @@ export class HttpPayloadTraitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/HttpPayloadTraitsWithMediaTypeCommand.ts b/protocol_tests/aws-restjson/commands/HttpPayloadTraitsWithMediaTypeCommand.ts index 52256fb39653d..7efb329764bdb 100644 --- a/protocol_tests/aws-restjson/commands/HttpPayloadTraitsWithMediaTypeCommand.ts +++ b/protocol_tests/aws-restjson/commands/HttpPayloadTraitsWithMediaTypeCommand.ts @@ -20,6 +20,10 @@ import { export type HttpPayloadTraitsWithMediaTypeCommandInput = HttpPayloadTraitsWithMediaTypeInputOutput; export type HttpPayloadTraitsWithMediaTypeCommandOutput = HttpPayloadTraitsWithMediaTypeInputOutput & __MetadataBearer; +/** + * This examples uses a `@mediaType` trait on the payload to force a custom + * content-type to be serialized. + */ export class HttpPayloadTraitsWithMediaTypeCommand extends $Command< HttpPayloadTraitsWithMediaTypeCommandInput, HttpPayloadTraitsWithMediaTypeCommandOutput, @@ -34,6 +38,9 @@ export class HttpPayloadTraitsWithMediaTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/HttpPayloadWithStructureCommand.ts b/protocol_tests/aws-restjson/commands/HttpPayloadWithStructureCommand.ts index 34725c71014cd..7f41501c3ef3c 100644 --- a/protocol_tests/aws-restjson/commands/HttpPayloadWithStructureCommand.ts +++ b/protocol_tests/aws-restjson/commands/HttpPayloadWithStructureCommand.ts @@ -20,6 +20,12 @@ import { export type HttpPayloadWithStructureCommandInput = HttpPayloadWithStructureInputOutput; export type HttpPayloadWithStructureCommandOutput = HttpPayloadWithStructureInputOutput & __MetadataBearer; +/** + * This examples serializes a structure in the payload. + * + * Note that serializing a structure changes the wrapper element name + * to match the targeted structure. + */ export class HttpPayloadWithStructureCommand extends $Command< HttpPayloadWithStructureCommandInput, HttpPayloadWithStructureCommandOutput, @@ -34,6 +40,9 @@ export class HttpPayloadWithStructureCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/HttpPrefixHeadersCommand.ts b/protocol_tests/aws-restjson/commands/HttpPrefixHeadersCommand.ts index 21486b20dbe43..4c549efe5b4fa 100644 --- a/protocol_tests/aws-restjson/commands/HttpPrefixHeadersCommand.ts +++ b/protocol_tests/aws-restjson/commands/HttpPrefixHeadersCommand.ts @@ -20,6 +20,9 @@ import { export type HttpPrefixHeadersCommandInput = HttpPrefixHeadersInputOutput; export type HttpPrefixHeadersCommandOutput = HttpPrefixHeadersInputOutput & __MetadataBearer; +/** + * This examples adds headers to the input of a request and response by prefix. + */ export class HttpPrefixHeadersCommand extends $Command< HttpPrefixHeadersCommandInput, HttpPrefixHeadersCommandOutput, @@ -34,6 +37,9 @@ export class HttpPrefixHeadersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/HttpRequestWithGreedyLabelInPathCommand.ts b/protocol_tests/aws-restjson/commands/HttpRequestWithGreedyLabelInPathCommand.ts index ed390ad1abe14..049bfcaf64805 100644 --- a/protocol_tests/aws-restjson/commands/HttpRequestWithGreedyLabelInPathCommand.ts +++ b/protocol_tests/aws-restjson/commands/HttpRequestWithGreedyLabelInPathCommand.ts @@ -34,6 +34,9 @@ export class HttpRequestWithGreedyLabelInPathCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/HttpRequestWithLabelsAndTimestampFormatCommand.ts b/protocol_tests/aws-restjson/commands/HttpRequestWithLabelsAndTimestampFormatCommand.ts index 094dc5f84d8b8..4583c5b1f9d7e 100644 --- a/protocol_tests/aws-restjson/commands/HttpRequestWithLabelsAndTimestampFormatCommand.ts +++ b/protocol_tests/aws-restjson/commands/HttpRequestWithLabelsAndTimestampFormatCommand.ts @@ -20,6 +20,10 @@ import { export type HttpRequestWithLabelsAndTimestampFormatCommandInput = HttpRequestWithLabelsAndTimestampFormatInput; export type HttpRequestWithLabelsAndTimestampFormatCommandOutput = __MetadataBearer; +/** + * The example tests how requests serialize different timestamp formats in the + * URI path. + */ export class HttpRequestWithLabelsAndTimestampFormatCommand extends $Command< HttpRequestWithLabelsAndTimestampFormatCommandInput, HttpRequestWithLabelsAndTimestampFormatCommandOutput, @@ -34,6 +38,9 @@ export class HttpRequestWithLabelsAndTimestampFormatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/HttpRequestWithLabelsCommand.ts b/protocol_tests/aws-restjson/commands/HttpRequestWithLabelsCommand.ts index 05f66b634086c..a6fc18b15df60 100644 --- a/protocol_tests/aws-restjson/commands/HttpRequestWithLabelsCommand.ts +++ b/protocol_tests/aws-restjson/commands/HttpRequestWithLabelsCommand.ts @@ -20,6 +20,10 @@ import { export type HttpRequestWithLabelsCommandInput = HttpRequestWithLabelsInput; export type HttpRequestWithLabelsCommandOutput = __MetadataBearer; +/** + * The example tests how requests are serialized when there's no input + * payload but there are HTTP labels. + */ export class HttpRequestWithLabelsCommand extends $Command< HttpRequestWithLabelsCommandInput, HttpRequestWithLabelsCommandOutput, @@ -34,6 +38,9 @@ export class HttpRequestWithLabelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/IgnoreQueryParamsInResponseCommand.ts b/protocol_tests/aws-restjson/commands/IgnoreQueryParamsInResponseCommand.ts index 3b62256a0ac6c..f956a18237251 100644 --- a/protocol_tests/aws-restjson/commands/IgnoreQueryParamsInResponseCommand.ts +++ b/protocol_tests/aws-restjson/commands/IgnoreQueryParamsInResponseCommand.ts @@ -20,6 +20,11 @@ import { export type IgnoreQueryParamsInResponseCommandInput = {}; export type IgnoreQueryParamsInResponseCommandOutput = IgnoreQueryParamsInResponseOutput & __MetadataBearer; +/** + * This example ensures that query string bound request parameters are + * serialized in the body of responses if the structure is used in both + * the request and response. + */ export class IgnoreQueryParamsInResponseCommand extends $Command< IgnoreQueryParamsInResponseCommandInput, IgnoreQueryParamsInResponseCommandOutput, @@ -34,6 +39,9 @@ export class IgnoreQueryParamsInResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/InputAndOutputWithHeadersCommand.ts b/protocol_tests/aws-restjson/commands/InputAndOutputWithHeadersCommand.ts index 96415a3a6861f..b08881527a5ce 100644 --- a/protocol_tests/aws-restjson/commands/InputAndOutputWithHeadersCommand.ts +++ b/protocol_tests/aws-restjson/commands/InputAndOutputWithHeadersCommand.ts @@ -20,6 +20,10 @@ import { export type InputAndOutputWithHeadersCommandInput = InputAndOutputWithHeadersIO; export type InputAndOutputWithHeadersCommandOutput = InputAndOutputWithHeadersIO & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there is + * no input or output payload but there are HTTP header bindings. + */ export class InputAndOutputWithHeadersCommand extends $Command< InputAndOutputWithHeadersCommandInput, InputAndOutputWithHeadersCommandOutput, @@ -34,6 +38,9 @@ export class InputAndOutputWithHeadersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/JsonBlobsCommand.ts b/protocol_tests/aws-restjson/commands/JsonBlobsCommand.ts index 5987261f3500d..2b4b363fc22cb 100644 --- a/protocol_tests/aws-restjson/commands/JsonBlobsCommand.ts +++ b/protocol_tests/aws-restjson/commands/JsonBlobsCommand.ts @@ -20,6 +20,9 @@ import { export type JsonBlobsCommandInput = JsonBlobsInputOutput; export type JsonBlobsCommandOutput = JsonBlobsInputOutput & __MetadataBearer; +/** + * Blobs are base64 encoded + */ export class JsonBlobsCommand extends $Command< JsonBlobsCommandInput, JsonBlobsCommandOutput, @@ -34,6 +37,9 @@ export class JsonBlobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/JsonEnumsCommand.ts b/protocol_tests/aws-restjson/commands/JsonEnumsCommand.ts index 91bc58725d0cd..f26f081523e9a 100644 --- a/protocol_tests/aws-restjson/commands/JsonEnumsCommand.ts +++ b/protocol_tests/aws-restjson/commands/JsonEnumsCommand.ts @@ -20,6 +20,9 @@ import { export type JsonEnumsCommandInput = JsonEnumsInputOutput; export type JsonEnumsCommandOutput = JsonEnumsInputOutput & __MetadataBearer; +/** + * This example serializes enums as top level properties, in lists, sets, and maps. + */ export class JsonEnumsCommand extends $Command< JsonEnumsCommandInput, JsonEnumsCommandOutput, @@ -34,6 +37,9 @@ export class JsonEnumsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/JsonListsCommand.ts b/protocol_tests/aws-restjson/commands/JsonListsCommand.ts index 4d500673ea21c..b5807afa467fc 100644 --- a/protocol_tests/aws-restjson/commands/JsonListsCommand.ts +++ b/protocol_tests/aws-restjson/commands/JsonListsCommand.ts @@ -20,6 +20,15 @@ import { export type JsonListsCommandInput = JsonListsInputOutput; export type JsonListsCommandOutput = JsonListsInputOutput & __MetadataBearer; +/** + * This test case serializes JSON lists for the following cases for both + * input and output: + * + * 1. Normal JSON lists. + * 2. Normal JSON sets. + * 3. JSON lists of lists. + * 4. Lists of structures. + */ export class JsonListsCommand extends $Command< JsonListsCommandInput, JsonListsCommandOutput, @@ -34,6 +43,9 @@ export class JsonListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/JsonMapsCommand.ts b/protocol_tests/aws-restjson/commands/JsonMapsCommand.ts index f873504caf86d..4f5a2d63739f4 100644 --- a/protocol_tests/aws-restjson/commands/JsonMapsCommand.ts +++ b/protocol_tests/aws-restjson/commands/JsonMapsCommand.ts @@ -20,6 +20,9 @@ import { export type JsonMapsCommandInput = JsonMapsInputOutput; export type JsonMapsCommandOutput = JsonMapsInputOutput & __MetadataBearer; +/** + * The example tests basic map serialization. + */ export class JsonMapsCommand extends $Command< JsonMapsCommandInput, JsonMapsCommandOutput, @@ -34,6 +37,9 @@ export class JsonMapsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/JsonTimestampsCommand.ts b/protocol_tests/aws-restjson/commands/JsonTimestampsCommand.ts index 104b9b2e59563..e0a0e3cc94cbc 100644 --- a/protocol_tests/aws-restjson/commands/JsonTimestampsCommand.ts +++ b/protocol_tests/aws-restjson/commands/JsonTimestampsCommand.ts @@ -20,6 +20,11 @@ import { export type JsonTimestampsCommandInput = JsonTimestampsInputOutput; export type JsonTimestampsCommandOutput = JsonTimestampsInputOutput & __MetadataBearer; +/** + * This tests how timestamps are serialized, including using the + * default format of date-time and various @timestampFormat trait + * values. + */ export class JsonTimestampsCommand extends $Command< JsonTimestampsCommandInput, JsonTimestampsCommandOutput, @@ -34,6 +39,9 @@ export class JsonTimestampsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/NoInputAndNoOutputCommand.ts b/protocol_tests/aws-restjson/commands/NoInputAndNoOutputCommand.ts index 02f8ec923368f..766ec859e4a25 100644 --- a/protocol_tests/aws-restjson/commands/NoInputAndNoOutputCommand.ts +++ b/protocol_tests/aws-restjson/commands/NoInputAndNoOutputCommand.ts @@ -19,6 +19,11 @@ import { export type NoInputAndNoOutputCommandInput = {}; export type NoInputAndNoOutputCommandOutput = __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response payload because the operation has no input or output. + * While this should be rare, code generators must support this. + */ export class NoInputAndNoOutputCommand extends $Command< NoInputAndNoOutputCommandInput, NoInputAndNoOutputCommandOutput, @@ -33,6 +38,9 @@ export class NoInputAndNoOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/NoInputAndOutputCommand.ts b/protocol_tests/aws-restjson/commands/NoInputAndOutputCommand.ts index ae7f63b8f9211..f40bd05cea6d3 100644 --- a/protocol_tests/aws-restjson/commands/NoInputAndOutputCommand.ts +++ b/protocol_tests/aws-restjson/commands/NoInputAndOutputCommand.ts @@ -20,6 +20,12 @@ import { export type NoInputAndOutputCommandInput = {}; export type NoInputAndOutputCommandOutput = NoInputAndOutputOutput & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response payload because the operation has no input and the + * output is empty. While this should be rare, code generators must support + * this. + */ export class NoInputAndOutputCommand extends $Command< NoInputAndOutputCommandInput, NoInputAndOutputCommandOutput, @@ -34,6 +40,9 @@ export class NoInputAndOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/NullAndEmptyHeadersClientCommand.ts b/protocol_tests/aws-restjson/commands/NullAndEmptyHeadersClientCommand.ts index d6351e0b7942e..2ad6c1e385f94 100644 --- a/protocol_tests/aws-restjson/commands/NullAndEmptyHeadersClientCommand.ts +++ b/protocol_tests/aws-restjson/commands/NullAndEmptyHeadersClientCommand.ts @@ -20,6 +20,9 @@ import { export type NullAndEmptyHeadersClientCommandInput = NullAndEmptyHeadersIO; export type NullAndEmptyHeadersClientCommandOutput = NullAndEmptyHeadersIO & __MetadataBearer; +/** + * Null and empty headers are not sent over the wire. + */ export class NullAndEmptyHeadersClientCommand extends $Command< NullAndEmptyHeadersClientCommandInput, NullAndEmptyHeadersClientCommandOutput, @@ -34,6 +37,9 @@ export class NullAndEmptyHeadersClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/NullAndEmptyHeadersServerCommand.ts b/protocol_tests/aws-restjson/commands/NullAndEmptyHeadersServerCommand.ts index a94eca0b31c93..145ee3fbfa40b 100644 --- a/protocol_tests/aws-restjson/commands/NullAndEmptyHeadersServerCommand.ts +++ b/protocol_tests/aws-restjson/commands/NullAndEmptyHeadersServerCommand.ts @@ -20,6 +20,9 @@ import { export type NullAndEmptyHeadersServerCommandInput = NullAndEmptyHeadersIO; export type NullAndEmptyHeadersServerCommandOutput = NullAndEmptyHeadersIO & __MetadataBearer; +/** + * Null and empty headers are not sent over the wire. + */ export class NullAndEmptyHeadersServerCommand extends $Command< NullAndEmptyHeadersServerCommandInput, NullAndEmptyHeadersServerCommandOutput, @@ -34,6 +37,9 @@ export class NullAndEmptyHeadersServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/OmitsNullSerializesEmptyStringCommand.ts b/protocol_tests/aws-restjson/commands/OmitsNullSerializesEmptyStringCommand.ts index 401b0cb38bb4e..6daa740cf0cd1 100644 --- a/protocol_tests/aws-restjson/commands/OmitsNullSerializesEmptyStringCommand.ts +++ b/protocol_tests/aws-restjson/commands/OmitsNullSerializesEmptyStringCommand.ts @@ -20,6 +20,9 @@ import { export type OmitsNullSerializesEmptyStringCommandInput = OmitsNullSerializesEmptyStringInput; export type OmitsNullSerializesEmptyStringCommandOutput = __MetadataBearer; +/** + * Omits null, but serializes empty string value. + */ export class OmitsNullSerializesEmptyStringCommand extends $Command< OmitsNullSerializesEmptyStringCommandInput, OmitsNullSerializesEmptyStringCommandOutput, @@ -34,6 +37,9 @@ export class OmitsNullSerializesEmptyStringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/QueryIdempotencyTokenAutoFillCommand.ts b/protocol_tests/aws-restjson/commands/QueryIdempotencyTokenAutoFillCommand.ts index e76a6187106f4..2ae8c80881e2d 100644 --- a/protocol_tests/aws-restjson/commands/QueryIdempotencyTokenAutoFillCommand.ts +++ b/protocol_tests/aws-restjson/commands/QueryIdempotencyTokenAutoFillCommand.ts @@ -20,6 +20,9 @@ import { export type QueryIdempotencyTokenAutoFillCommandInput = QueryIdempotencyTokenAutoFillInput; export type QueryIdempotencyTokenAutoFillCommandOutput = __MetadataBearer; +/** + * Automatically adds idempotency tokens. + */ export class QueryIdempotencyTokenAutoFillCommand extends $Command< QueryIdempotencyTokenAutoFillCommandInput, QueryIdempotencyTokenAutoFillCommandOutput, @@ -34,6 +37,9 @@ export class QueryIdempotencyTokenAutoFillCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/RecursiveShapesCommand.ts b/protocol_tests/aws-restjson/commands/RecursiveShapesCommand.ts index ab0ce51f3d303..b93b9447912bc 100644 --- a/protocol_tests/aws-restjson/commands/RecursiveShapesCommand.ts +++ b/protocol_tests/aws-restjson/commands/RecursiveShapesCommand.ts @@ -20,6 +20,9 @@ import { export type RecursiveShapesCommandInput = RecursiveShapesInputOutput; export type RecursiveShapesCommandOutput = RecursiveShapesInputOutput & __MetadataBearer; +/** + * Recursive shapes + */ export class RecursiveShapesCommand extends $Command< RecursiveShapesCommandInput, RecursiveShapesCommandOutput, @@ -34,6 +37,9 @@ export class RecursiveShapesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/SimpleScalarPropertiesCommand.ts b/protocol_tests/aws-restjson/commands/SimpleScalarPropertiesCommand.ts index 072ec7fee0467..7901da4e03a24 100644 --- a/protocol_tests/aws-restjson/commands/SimpleScalarPropertiesCommand.ts +++ b/protocol_tests/aws-restjson/commands/SimpleScalarPropertiesCommand.ts @@ -34,6 +34,9 @@ export class SimpleScalarPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/commands/TimestampFormatHeadersCommand.ts b/protocol_tests/aws-restjson/commands/TimestampFormatHeadersCommand.ts index 0efda0c07389f..1bc693a5c182b 100644 --- a/protocol_tests/aws-restjson/commands/TimestampFormatHeadersCommand.ts +++ b/protocol_tests/aws-restjson/commands/TimestampFormatHeadersCommand.ts @@ -20,6 +20,9 @@ import { export type TimestampFormatHeadersCommandInput = TimestampFormatHeadersIO; export type TimestampFormatHeadersCommandOutput = TimestampFormatHeadersIO & __MetadataBearer; +/** + * The example tests how timestamp request and response headers are serialized. + */ export class TimestampFormatHeadersCommand extends $Command< TimestampFormatHeadersCommandInput, TimestampFormatHeadersCommandOutput, @@ -34,6 +37,9 @@ export class TimestampFormatHeadersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestJsonProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restjson/package.json b/protocol_tests/aws-restjson/package.json index a55fb4cb52bd3..3bb444052d14b 100644 --- a/protocol_tests/aws-restjson/package.json +++ b/protocol_tests/aws-restjson/package.json @@ -3,8 +3,8 @@ "description": "@aws-sdk/aws-restjson client", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -66,7 +66,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/protocol_tests/aws-restjson/runtimeConfig.browser.ts b/protocol_tests/aws-restjson/runtimeConfig.browser.ts index 700b19eaf1c2b..0d3ee25024dcf 100644 --- a/protocol_tests/aws-restjson/runtimeConfig.browser.ts +++ b/protocol_tests/aws-restjson/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RestJsonProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/protocol_tests/aws-restjson/runtimeConfig.native.ts b/protocol_tests/aws-restjson/runtimeConfig.native.ts index 8ee1a66be6c00..98a833d6c3195 100644 --- a/protocol_tests/aws-restjson/runtimeConfig.native.ts +++ b/protocol_tests/aws-restjson/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RestJsonProtocolClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/protocol_tests/aws-restjson/runtimeConfig.shared.ts b/protocol_tests/aws-restjson/runtimeConfig.shared.ts index 733bbe3d854ae..87e6e2001e493 100644 --- a/protocol_tests/aws-restjson/runtimeConfig.shared.ts +++ b/protocol_tests/aws-restjson/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-16", disableHostPrefix: false, diff --git a/protocol_tests/aws-restjson/runtimeConfig.ts b/protocol_tests/aws-restjson/runtimeConfig.ts index b8a4218bad851..83527f829a8b2 100644 --- a/protocol_tests/aws-restjson/runtimeConfig.ts +++ b/protocol_tests/aws-restjson/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RestJsonProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/protocol_tests/aws-restjson/tsconfig.json b/protocol_tests/aws-restjson/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/protocol_tests/aws-restjson/tsconfig.json +++ b/protocol_tests/aws-restjson/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/protocol_tests/aws-restxml/commands/AllQueryStringTypesCommand.ts b/protocol_tests/aws-restxml/commands/AllQueryStringTypesCommand.ts index 0d6983bae329b..72aaf869de42c 100644 --- a/protocol_tests/aws-restxml/commands/AllQueryStringTypesCommand.ts +++ b/protocol_tests/aws-restxml/commands/AllQueryStringTypesCommand.ts @@ -20,6 +20,9 @@ import { export type AllQueryStringTypesCommandInput = AllQueryStringTypesInput; export type AllQueryStringTypesCommandOutput = __MetadataBearer; +/** + * This example uses all query string types. + */ export class AllQueryStringTypesCommand extends $Command< AllQueryStringTypesCommandInput, AllQueryStringTypesCommandOutput, @@ -34,6 +37,9 @@ export class AllQueryStringTypesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/ConstantAndVariableQueryStringCommand.ts b/protocol_tests/aws-restxml/commands/ConstantAndVariableQueryStringCommand.ts index a77a073ec1e77..5595e4f37d4df 100644 --- a/protocol_tests/aws-restxml/commands/ConstantAndVariableQueryStringCommand.ts +++ b/protocol_tests/aws-restxml/commands/ConstantAndVariableQueryStringCommand.ts @@ -20,6 +20,11 @@ import { export type ConstantAndVariableQueryStringCommandInput = ConstantAndVariableQueryStringInput; export type ConstantAndVariableQueryStringCommandOutput = __MetadataBearer; +/** + * This example uses fixed query string params and variable query string params. + * The fixed query string parameters and variable parameters must both be + * serialized (implementations may need to merge them together). + */ export class ConstantAndVariableQueryStringCommand extends $Command< ConstantAndVariableQueryStringCommandInput, ConstantAndVariableQueryStringCommandOutput, @@ -34,6 +39,9 @@ export class ConstantAndVariableQueryStringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/ConstantQueryStringCommand.ts b/protocol_tests/aws-restxml/commands/ConstantQueryStringCommand.ts index af408ae1e60ac..d9e2cb84b54e3 100644 --- a/protocol_tests/aws-restxml/commands/ConstantQueryStringCommand.ts +++ b/protocol_tests/aws-restxml/commands/ConstantQueryStringCommand.ts @@ -20,6 +20,12 @@ import { export type ConstantQueryStringCommandInput = ConstantQueryStringInput; export type ConstantQueryStringCommandOutput = __MetadataBearer; +/** + * This example uses a constant query string parameters and a label. + * This simply tests that labels and query string parameters are + * compatible. The fixed query string parameter named "hello" should + * in no way conflict with the label, `{hello}`. + */ export class ConstantQueryStringCommand extends $Command< ConstantQueryStringCommandInput, ConstantQueryStringCommandOutput, @@ -34,6 +40,9 @@ export class ConstantQueryStringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/EmptyInputAndEmptyOutputCommand.ts b/protocol_tests/aws-restxml/commands/EmptyInputAndEmptyOutputCommand.ts index 0173463c38111..847281bd93157 100644 --- a/protocol_tests/aws-restxml/commands/EmptyInputAndEmptyOutputCommand.ts +++ b/protocol_tests/aws-restxml/commands/EmptyInputAndEmptyOutputCommand.ts @@ -20,6 +20,12 @@ import { export type EmptyInputAndEmptyOutputCommandInput = EmptyInputAndEmptyOutputInput; export type EmptyInputAndEmptyOutputCommandOutput = EmptyInputAndEmptyOutputOutput & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response payload because the operation has an empty input + * and empty output structure that reuses the same shape. While this should + * be rare, code generators must support this. + */ export class EmptyInputAndEmptyOutputCommand extends $Command< EmptyInputAndEmptyOutputCommandInput, EmptyInputAndEmptyOutputCommandOutput, @@ -34,6 +40,9 @@ export class EmptyInputAndEmptyOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/FlattenedXmlMapCommand.ts b/protocol_tests/aws-restxml/commands/FlattenedXmlMapCommand.ts index 045c698fb76b6..8d01393630961 100644 --- a/protocol_tests/aws-restxml/commands/FlattenedXmlMapCommand.ts +++ b/protocol_tests/aws-restxml/commands/FlattenedXmlMapCommand.ts @@ -20,6 +20,9 @@ import { export type FlattenedXmlMapCommandInput = FlattenedXmlMapInputOutput; export type FlattenedXmlMapCommandOutput = FlattenedXmlMapInputOutput & __MetadataBearer; +/** + * Flattened maps + */ export class FlattenedXmlMapCommand extends $Command< FlattenedXmlMapCommandInput, FlattenedXmlMapCommandOutput, @@ -34,6 +37,9 @@ export class FlattenedXmlMapCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/FlattenedXmlMapWithXmlNameCommand.ts b/protocol_tests/aws-restxml/commands/FlattenedXmlMapWithXmlNameCommand.ts index 81b67a32660e6..3e3a9433026d6 100644 --- a/protocol_tests/aws-restxml/commands/FlattenedXmlMapWithXmlNameCommand.ts +++ b/protocol_tests/aws-restxml/commands/FlattenedXmlMapWithXmlNameCommand.ts @@ -20,6 +20,9 @@ import { export type FlattenedXmlMapWithXmlNameCommandInput = FlattenedXmlMapWithXmlNameInputOutput; export type FlattenedXmlMapWithXmlNameCommandOutput = FlattenedXmlMapWithXmlNameInputOutput & __MetadataBearer; +/** + * Flattened maps with @xmlName + */ export class FlattenedXmlMapWithXmlNameCommand extends $Command< FlattenedXmlMapWithXmlNameCommandInput, FlattenedXmlMapWithXmlNameCommandOutput, @@ -34,6 +37,9 @@ export class FlattenedXmlMapWithXmlNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/GreetingWithErrorsCommand.ts b/protocol_tests/aws-restxml/commands/GreetingWithErrorsCommand.ts index daae7881e20fc..1cdb8e9429510 100644 --- a/protocol_tests/aws-restxml/commands/GreetingWithErrorsCommand.ts +++ b/protocol_tests/aws-restxml/commands/GreetingWithErrorsCommand.ts @@ -20,6 +20,17 @@ import { export type GreetingWithErrorsCommandInput = {}; export type GreetingWithErrorsCommandOutput = GreetingWithErrorsOutput & __MetadataBearer; +/** + * This operation has three possible return values: + * + * 1. A successful response in the form of GreetingWithErrorsOutput + * 2. An InvalidGreeting error. + * 3. A BadRequest error. + * + * Implementations must be able to successfully take a response and + * properly (de)serialize successful and error responses based on the + * the presence of the + */ export class GreetingWithErrorsCommand extends $Command< GreetingWithErrorsCommandInput, GreetingWithErrorsCommandOutput, @@ -34,6 +45,9 @@ export class GreetingWithErrorsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpPayloadTraitsCommand.ts b/protocol_tests/aws-restxml/commands/HttpPayloadTraitsCommand.ts index 71b309f50a6b3..81b602a745181 100644 --- a/protocol_tests/aws-restxml/commands/HttpPayloadTraitsCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpPayloadTraitsCommand.ts @@ -20,6 +20,12 @@ import { export type HttpPayloadTraitsCommandInput = HttpPayloadTraitsInputOutput; export type HttpPayloadTraitsCommandOutput = HttpPayloadTraitsInputOutput & __MetadataBearer; +/** + * This examples serializes a blob shape in the payload. + * + * In this example, no XML document is synthesized because the payload is + * not a structure or a union type. + */ export class HttpPayloadTraitsCommand extends $Command< HttpPayloadTraitsCommandInput, HttpPayloadTraitsCommandOutput, @@ -34,6 +40,9 @@ export class HttpPayloadTraitsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpPayloadTraitsWithMediaTypeCommand.ts b/protocol_tests/aws-restxml/commands/HttpPayloadTraitsWithMediaTypeCommand.ts index 2f33b7f8472d8..600f8bd4c4add 100644 --- a/protocol_tests/aws-restxml/commands/HttpPayloadTraitsWithMediaTypeCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpPayloadTraitsWithMediaTypeCommand.ts @@ -20,6 +20,10 @@ import { export type HttpPayloadTraitsWithMediaTypeCommandInput = HttpPayloadTraitsWithMediaTypeInputOutput; export type HttpPayloadTraitsWithMediaTypeCommandOutput = HttpPayloadTraitsWithMediaTypeInputOutput & __MetadataBearer; +/** + * This examples uses a `@mediaType` trait on the payload to force a custom + * content-type to be serialized. + */ export class HttpPayloadTraitsWithMediaTypeCommand extends $Command< HttpPayloadTraitsWithMediaTypeCommandInput, HttpPayloadTraitsWithMediaTypeCommandOutput, @@ -34,6 +38,9 @@ export class HttpPayloadTraitsWithMediaTypeCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpPayloadWithStructureCommand.ts b/protocol_tests/aws-restxml/commands/HttpPayloadWithStructureCommand.ts index e53509a06ea80..25fc5425cfd2c 100644 --- a/protocol_tests/aws-restxml/commands/HttpPayloadWithStructureCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpPayloadWithStructureCommand.ts @@ -20,6 +20,12 @@ import { export type HttpPayloadWithStructureCommandInput = HttpPayloadWithStructureInputOutput; export type HttpPayloadWithStructureCommandOutput = HttpPayloadWithStructureInputOutput & __MetadataBearer; +/** + * This examples serializes a structure in the payload. + * + * Note that serializing a structure changes the wrapper element name + * to match the targeted structure. + */ export class HttpPayloadWithStructureCommand extends $Command< HttpPayloadWithStructureCommandInput, HttpPayloadWithStructureCommandOutput, @@ -34,6 +40,9 @@ export class HttpPayloadWithStructureCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNameCommand.ts b/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNameCommand.ts index d8811f72e0c9c..5889591c9fad8 100644 --- a/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNameCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNameCommand.ts @@ -20,6 +20,10 @@ import { export type HttpPayloadWithXmlNameCommandInput = HttpPayloadWithXmlNameInputOutput; export type HttpPayloadWithXmlNameCommandOutput = HttpPayloadWithXmlNameInputOutput & __MetadataBearer; +/** + * The following example serializes a payload that uses an XML name, + * changing the wrapper name. + */ export class HttpPayloadWithXmlNameCommand extends $Command< HttpPayloadWithXmlNameCommandInput, HttpPayloadWithXmlNameCommandOutput, @@ -34,6 +38,9 @@ export class HttpPayloadWithXmlNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNamespaceAndPrefixCommand.ts b/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNamespaceAndPrefixCommand.ts index 87978f0f27ab4..619df94e0b584 100644 --- a/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNamespaceAndPrefixCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNamespaceAndPrefixCommand.ts @@ -21,6 +21,9 @@ export type HttpPayloadWithXmlNamespaceAndPrefixCommandInput = HttpPayloadWithXm export type HttpPayloadWithXmlNamespaceAndPrefixCommandOutput = HttpPayloadWithXmlNamespaceAndPrefixInputOutput & __MetadataBearer; +/** + * The following example serializes a payload that uses an XML namespace. + */ export class HttpPayloadWithXmlNamespaceAndPrefixCommand extends $Command< HttpPayloadWithXmlNamespaceAndPrefixCommandInput, HttpPayloadWithXmlNamespaceAndPrefixCommandOutput, @@ -35,6 +38,9 @@ export class HttpPayloadWithXmlNamespaceAndPrefixCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNamespaceCommand.ts b/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNamespaceCommand.ts index e865f22d1ea03..2d1f19a108839 100644 --- a/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNamespaceCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpPayloadWithXmlNamespaceCommand.ts @@ -20,6 +20,9 @@ import { export type HttpPayloadWithXmlNamespaceCommandInput = HttpPayloadWithXmlNamespaceInputOutput; export type HttpPayloadWithXmlNamespaceCommandOutput = HttpPayloadWithXmlNamespaceInputOutput & __MetadataBearer; +/** + * The following example serializes a payload that uses an XML namespace. + */ export class HttpPayloadWithXmlNamespaceCommand extends $Command< HttpPayloadWithXmlNamespaceCommandInput, HttpPayloadWithXmlNamespaceCommandOutput, @@ -34,6 +37,9 @@ export class HttpPayloadWithXmlNamespaceCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpPrefixHeadersCommand.ts b/protocol_tests/aws-restxml/commands/HttpPrefixHeadersCommand.ts index c999d2c28d8a2..ded2216a85247 100644 --- a/protocol_tests/aws-restxml/commands/HttpPrefixHeadersCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpPrefixHeadersCommand.ts @@ -20,6 +20,9 @@ import { export type HttpPrefixHeadersCommandInput = HttpPrefixHeadersInputOutput; export type HttpPrefixHeadersCommandOutput = HttpPrefixHeadersInputOutput & __MetadataBearer; +/** + * This examples adds headers to the input of a request and response by prefix. + */ export class HttpPrefixHeadersCommand extends $Command< HttpPrefixHeadersCommandInput, HttpPrefixHeadersCommandOutput, @@ -34,6 +37,9 @@ export class HttpPrefixHeadersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpRequestWithGreedyLabelInPathCommand.ts b/protocol_tests/aws-restxml/commands/HttpRequestWithGreedyLabelInPathCommand.ts index 20e02f71b6c5c..250bd46203db1 100644 --- a/protocol_tests/aws-restxml/commands/HttpRequestWithGreedyLabelInPathCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpRequestWithGreedyLabelInPathCommand.ts @@ -34,6 +34,9 @@ export class HttpRequestWithGreedyLabelInPathCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpRequestWithLabelsAndTimestampFormatCommand.ts b/protocol_tests/aws-restxml/commands/HttpRequestWithLabelsAndTimestampFormatCommand.ts index 874275b5dad57..a554c1d18c55f 100644 --- a/protocol_tests/aws-restxml/commands/HttpRequestWithLabelsAndTimestampFormatCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpRequestWithLabelsAndTimestampFormatCommand.ts @@ -20,6 +20,10 @@ import { export type HttpRequestWithLabelsAndTimestampFormatCommandInput = HttpRequestWithLabelsAndTimestampFormatInput; export type HttpRequestWithLabelsAndTimestampFormatCommandOutput = __MetadataBearer; +/** + * The example tests how requests serialize different timestamp formats in the + * URI path. + */ export class HttpRequestWithLabelsAndTimestampFormatCommand extends $Command< HttpRequestWithLabelsAndTimestampFormatCommandInput, HttpRequestWithLabelsAndTimestampFormatCommandOutput, @@ -34,6 +38,9 @@ export class HttpRequestWithLabelsAndTimestampFormatCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/HttpRequestWithLabelsCommand.ts b/protocol_tests/aws-restxml/commands/HttpRequestWithLabelsCommand.ts index 11c96c3f03b36..8b04119531448 100644 --- a/protocol_tests/aws-restxml/commands/HttpRequestWithLabelsCommand.ts +++ b/protocol_tests/aws-restxml/commands/HttpRequestWithLabelsCommand.ts @@ -20,6 +20,10 @@ import { export type HttpRequestWithLabelsCommandInput = HttpRequestWithLabelsInput; export type HttpRequestWithLabelsCommandOutput = __MetadataBearer; +/** + * The example tests how requests are serialized when there's no input + * payload but there are HTTP labels. + */ export class HttpRequestWithLabelsCommand extends $Command< HttpRequestWithLabelsCommandInput, HttpRequestWithLabelsCommandOutput, @@ -34,6 +38,9 @@ export class HttpRequestWithLabelsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/IgnoreQueryParamsInResponseCommand.ts b/protocol_tests/aws-restxml/commands/IgnoreQueryParamsInResponseCommand.ts index b22fc6395c7cd..85dc96a8d8690 100644 --- a/protocol_tests/aws-restxml/commands/IgnoreQueryParamsInResponseCommand.ts +++ b/protocol_tests/aws-restxml/commands/IgnoreQueryParamsInResponseCommand.ts @@ -20,6 +20,11 @@ import { export type IgnoreQueryParamsInResponseCommandInput = {}; export type IgnoreQueryParamsInResponseCommandOutput = IgnoreQueryParamsInResponseOutput & __MetadataBearer; +/** + * This example ensures that query string bound request parameters are + * serialized in the body of responses if the structure is used in both + * the request and response. + */ export class IgnoreQueryParamsInResponseCommand extends $Command< IgnoreQueryParamsInResponseCommandInput, IgnoreQueryParamsInResponseCommandOutput, @@ -34,6 +39,9 @@ export class IgnoreQueryParamsInResponseCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/InputAndOutputWithHeadersCommand.ts b/protocol_tests/aws-restxml/commands/InputAndOutputWithHeadersCommand.ts index 8d3baaf43e62b..4d79c67c03737 100644 --- a/protocol_tests/aws-restxml/commands/InputAndOutputWithHeadersCommand.ts +++ b/protocol_tests/aws-restxml/commands/InputAndOutputWithHeadersCommand.ts @@ -20,6 +20,10 @@ import { export type InputAndOutputWithHeadersCommandInput = InputAndOutputWithHeadersIO; export type InputAndOutputWithHeadersCommandOutput = InputAndOutputWithHeadersIO & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there is + * no input or output payload but there are HTTP header bindings. + */ export class InputAndOutputWithHeadersCommand extends $Command< InputAndOutputWithHeadersCommandInput, InputAndOutputWithHeadersCommandOutput, @@ -34,6 +38,9 @@ export class InputAndOutputWithHeadersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/NoInputAndNoOutputCommand.ts b/protocol_tests/aws-restxml/commands/NoInputAndNoOutputCommand.ts index 7103a7e10a8bb..5c4535fdc2ba6 100644 --- a/protocol_tests/aws-restxml/commands/NoInputAndNoOutputCommand.ts +++ b/protocol_tests/aws-restxml/commands/NoInputAndNoOutputCommand.ts @@ -19,6 +19,11 @@ import { export type NoInputAndNoOutputCommandInput = {}; export type NoInputAndNoOutputCommandOutput = __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response payload because the operation has no input or output. + * While this should be rare, code generators must support this. + */ export class NoInputAndNoOutputCommand extends $Command< NoInputAndNoOutputCommandInput, NoInputAndNoOutputCommandOutput, @@ -33,6 +38,9 @@ export class NoInputAndNoOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/NoInputAndOutputCommand.ts b/protocol_tests/aws-restxml/commands/NoInputAndOutputCommand.ts index 9c60972131bd7..8e4034f3fd3b3 100644 --- a/protocol_tests/aws-restxml/commands/NoInputAndOutputCommand.ts +++ b/protocol_tests/aws-restxml/commands/NoInputAndOutputCommand.ts @@ -20,6 +20,12 @@ import { export type NoInputAndOutputCommandInput = {}; export type NoInputAndOutputCommandOutput = NoInputAndOutputOutput & __MetadataBearer; +/** + * The example tests how requests and responses are serialized when there's + * no request or response payload because the operation has no input and the + * output is empty. While this should be rare, code generators must support + * this. + */ export class NoInputAndOutputCommand extends $Command< NoInputAndOutputCommandInput, NoInputAndOutputCommandOutput, @@ -34,6 +40,9 @@ export class NoInputAndOutputCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/NullAndEmptyHeadersClientCommand.ts b/protocol_tests/aws-restxml/commands/NullAndEmptyHeadersClientCommand.ts index a0ad1127ec3b9..0530ff5fea87a 100644 --- a/protocol_tests/aws-restxml/commands/NullAndEmptyHeadersClientCommand.ts +++ b/protocol_tests/aws-restxml/commands/NullAndEmptyHeadersClientCommand.ts @@ -20,6 +20,9 @@ import { export type NullAndEmptyHeadersClientCommandInput = NullAndEmptyHeadersIO; export type NullAndEmptyHeadersClientCommandOutput = NullAndEmptyHeadersIO & __MetadataBearer; +/** + * Null and empty headers are not sent over the wire. + */ export class NullAndEmptyHeadersClientCommand extends $Command< NullAndEmptyHeadersClientCommandInput, NullAndEmptyHeadersClientCommandOutput, @@ -34,6 +37,9 @@ export class NullAndEmptyHeadersClientCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/NullAndEmptyHeadersServerCommand.ts b/protocol_tests/aws-restxml/commands/NullAndEmptyHeadersServerCommand.ts index 6357586ec6328..dbbb0fc606e27 100644 --- a/protocol_tests/aws-restxml/commands/NullAndEmptyHeadersServerCommand.ts +++ b/protocol_tests/aws-restxml/commands/NullAndEmptyHeadersServerCommand.ts @@ -20,6 +20,9 @@ import { export type NullAndEmptyHeadersServerCommandInput = NullAndEmptyHeadersIO; export type NullAndEmptyHeadersServerCommandOutput = NullAndEmptyHeadersIO & __MetadataBearer; +/** + * Null and empty headers are not sent over the wire. + */ export class NullAndEmptyHeadersServerCommand extends $Command< NullAndEmptyHeadersServerCommandInput, NullAndEmptyHeadersServerCommandOutput, @@ -34,6 +37,9 @@ export class NullAndEmptyHeadersServerCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/OmitsNullSerializesEmptyStringCommand.ts b/protocol_tests/aws-restxml/commands/OmitsNullSerializesEmptyStringCommand.ts index b026408199d83..a9c6780dc0456 100644 --- a/protocol_tests/aws-restxml/commands/OmitsNullSerializesEmptyStringCommand.ts +++ b/protocol_tests/aws-restxml/commands/OmitsNullSerializesEmptyStringCommand.ts @@ -20,6 +20,9 @@ import { export type OmitsNullSerializesEmptyStringCommandInput = OmitsNullSerializesEmptyStringInput; export type OmitsNullSerializesEmptyStringCommandOutput = __MetadataBearer; +/** + * Omits null, but serializes empty string value. + */ export class OmitsNullSerializesEmptyStringCommand extends $Command< OmitsNullSerializesEmptyStringCommandInput, OmitsNullSerializesEmptyStringCommandOutput, @@ -34,6 +37,9 @@ export class OmitsNullSerializesEmptyStringCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/QueryIdempotencyTokenAutoFillCommand.ts b/protocol_tests/aws-restxml/commands/QueryIdempotencyTokenAutoFillCommand.ts index 26d582f619869..8b41241fd6208 100644 --- a/protocol_tests/aws-restxml/commands/QueryIdempotencyTokenAutoFillCommand.ts +++ b/protocol_tests/aws-restxml/commands/QueryIdempotencyTokenAutoFillCommand.ts @@ -20,6 +20,9 @@ import { export type QueryIdempotencyTokenAutoFillCommandInput = QueryIdempotencyTokenAutoFillInput; export type QueryIdempotencyTokenAutoFillCommandOutput = __MetadataBearer; +/** + * Automatically adds idempotency tokens. + */ export class QueryIdempotencyTokenAutoFillCommand extends $Command< QueryIdempotencyTokenAutoFillCommandInput, QueryIdempotencyTokenAutoFillCommandOutput, @@ -34,6 +37,9 @@ export class QueryIdempotencyTokenAutoFillCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/RecursiveShapesCommand.ts b/protocol_tests/aws-restxml/commands/RecursiveShapesCommand.ts index d63f3e05980e7..bb0ea600063b3 100644 --- a/protocol_tests/aws-restxml/commands/RecursiveShapesCommand.ts +++ b/protocol_tests/aws-restxml/commands/RecursiveShapesCommand.ts @@ -20,6 +20,9 @@ import { export type RecursiveShapesCommandInput = RecursiveShapesInputOutput; export type RecursiveShapesCommandOutput = RecursiveShapesInputOutput & __MetadataBearer; +/** + * Recursive shapes + */ export class RecursiveShapesCommand extends $Command< RecursiveShapesCommandInput, RecursiveShapesCommandOutput, @@ -34,6 +37,9 @@ export class RecursiveShapesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/SimpleScalarPropertiesCommand.ts b/protocol_tests/aws-restxml/commands/SimpleScalarPropertiesCommand.ts index a1f4ff5c7dbca..25d1d406e9658 100644 --- a/protocol_tests/aws-restxml/commands/SimpleScalarPropertiesCommand.ts +++ b/protocol_tests/aws-restxml/commands/SimpleScalarPropertiesCommand.ts @@ -34,6 +34,9 @@ export class SimpleScalarPropertiesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/TimestampFormatHeadersCommand.ts b/protocol_tests/aws-restxml/commands/TimestampFormatHeadersCommand.ts index ea520676c94a2..eba75cf5914d6 100644 --- a/protocol_tests/aws-restxml/commands/TimestampFormatHeadersCommand.ts +++ b/protocol_tests/aws-restxml/commands/TimestampFormatHeadersCommand.ts @@ -20,6 +20,9 @@ import { export type TimestampFormatHeadersCommandInput = TimestampFormatHeadersIO; export type TimestampFormatHeadersCommandOutput = TimestampFormatHeadersIO & __MetadataBearer; +/** + * The example tests how timestamp request and response headers are serialized. + */ export class TimestampFormatHeadersCommand extends $Command< TimestampFormatHeadersCommandInput, TimestampFormatHeadersCommandOutput, @@ -34,6 +37,9 @@ export class TimestampFormatHeadersCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlAttributesCommand.ts b/protocol_tests/aws-restxml/commands/XmlAttributesCommand.ts index 305c98f188e6f..ed233a574b185 100644 --- a/protocol_tests/aws-restxml/commands/XmlAttributesCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlAttributesCommand.ts @@ -20,6 +20,9 @@ import { export type XmlAttributesCommandInput = XmlAttributesInputOutput; export type XmlAttributesCommandOutput = XmlAttributesInputOutput & __MetadataBearer; +/** + * This example serializes an XML attributes on synthesized document. + */ export class XmlAttributesCommand extends $Command< XmlAttributesCommandInput, XmlAttributesCommandOutput, @@ -34,6 +37,9 @@ export class XmlAttributesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlAttributesOnPayloadCommand.ts b/protocol_tests/aws-restxml/commands/XmlAttributesOnPayloadCommand.ts index c779baf81d181..b6ede18c989b1 100644 --- a/protocol_tests/aws-restxml/commands/XmlAttributesOnPayloadCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlAttributesOnPayloadCommand.ts @@ -20,6 +20,9 @@ import { export type XmlAttributesOnPayloadCommandInput = XmlAttributesOnPayloadInputOutput; export type XmlAttributesOnPayloadCommandOutput = XmlAttributesOnPayloadInputOutput & __MetadataBearer; +/** + * This example serializes an XML attributes on a document targeted by httpPayload. + */ export class XmlAttributesOnPayloadCommand extends $Command< XmlAttributesOnPayloadCommandInput, XmlAttributesOnPayloadCommandOutput, @@ -34,6 +37,9 @@ export class XmlAttributesOnPayloadCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlBlobsCommand.ts b/protocol_tests/aws-restxml/commands/XmlBlobsCommand.ts index b8a11297eae45..6526245846e63 100644 --- a/protocol_tests/aws-restxml/commands/XmlBlobsCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlBlobsCommand.ts @@ -17,6 +17,9 @@ import { export type XmlBlobsCommandInput = XmlBlobsInputOutput; export type XmlBlobsCommandOutput = XmlBlobsInputOutput & __MetadataBearer; +/** + * Blobs are base64 encoded + */ export class XmlBlobsCommand extends $Command< XmlBlobsCommandInput, XmlBlobsCommandOutput, @@ -31,6 +34,9 @@ export class XmlBlobsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlEnumsCommand.ts b/protocol_tests/aws-restxml/commands/XmlEnumsCommand.ts index 717deae8787eb..f39310737e084 100644 --- a/protocol_tests/aws-restxml/commands/XmlEnumsCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlEnumsCommand.ts @@ -17,6 +17,9 @@ import { export type XmlEnumsCommandInput = XmlEnumsInputOutput; export type XmlEnumsCommandOutput = XmlEnumsInputOutput & __MetadataBearer; +/** + * This example serializes enums as top level properties, in lists, sets, and maps. + */ export class XmlEnumsCommand extends $Command< XmlEnumsCommandInput, XmlEnumsCommandOutput, @@ -31,6 +34,9 @@ export class XmlEnumsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlListsCommand.ts b/protocol_tests/aws-restxml/commands/XmlListsCommand.ts index c1ac87c72d9e8..de565a30b206b 100644 --- a/protocol_tests/aws-restxml/commands/XmlListsCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlListsCommand.ts @@ -17,6 +17,18 @@ import { export type XmlListsCommandInput = XmlListsInputOutput; export type XmlListsCommandOutput = XmlListsInputOutput & __MetadataBearer; +/** + * This test case serializes XML lists for the following cases for both + * input and output: + * + * 1. Normal XML lists. + * 2. Normal XML sets. + * 3. XML lists of lists. + * 4. XML lists with @xmlName on its members + * 5. Flattened XML lists. + * 6. Flattened XML lists with @xmlName. + * 7. Lists of structures. + */ export class XmlListsCommand extends $Command< XmlListsCommandInput, XmlListsCommandOutput, @@ -31,6 +43,9 @@ export class XmlListsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlMapsCommand.ts b/protocol_tests/aws-restxml/commands/XmlMapsCommand.ts index df2cea8b59fd6..060cdef18d1d6 100644 --- a/protocol_tests/aws-restxml/commands/XmlMapsCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlMapsCommand.ts @@ -17,6 +17,9 @@ import { export type XmlMapsCommandInput = XmlMapsInputOutput; export type XmlMapsCommandOutput = XmlMapsInputOutput & __MetadataBearer; +/** + * The example tests basic map serialization. + */ export class XmlMapsCommand extends $Command< XmlMapsCommandInput, XmlMapsCommandOutput, @@ -31,6 +34,9 @@ export class XmlMapsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlMapsXmlNameCommand.ts b/protocol_tests/aws-restxml/commands/XmlMapsXmlNameCommand.ts index a37a37071c74d..85362e6fb7e6c 100644 --- a/protocol_tests/aws-restxml/commands/XmlMapsXmlNameCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlMapsXmlNameCommand.ts @@ -34,6 +34,9 @@ export class XmlMapsXmlNameCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlNamespacesCommand.ts b/protocol_tests/aws-restxml/commands/XmlNamespacesCommand.ts index fb91253b5201e..203c7ffedfac9 100644 --- a/protocol_tests/aws-restxml/commands/XmlNamespacesCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlNamespacesCommand.ts @@ -34,6 +34,9 @@ export class XmlNamespacesCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/commands/XmlTimestampsCommand.ts b/protocol_tests/aws-restxml/commands/XmlTimestampsCommand.ts index ef2b5c0e41686..557e28db0f64d 100644 --- a/protocol_tests/aws-restxml/commands/XmlTimestampsCommand.ts +++ b/protocol_tests/aws-restxml/commands/XmlTimestampsCommand.ts @@ -20,6 +20,11 @@ import { export type XmlTimestampsCommandInput = XmlTimestampsInputOutput; export type XmlTimestampsCommandOutput = XmlTimestampsInputOutput & __MetadataBearer; +/** + * This tests how timestamps are serialized, including using the + * default format of date-time and various @timestampFormat trait + * values. + */ export class XmlTimestampsCommand extends $Command< XmlTimestampsCommandInput, XmlTimestampsCommandOutput, @@ -34,6 +39,9 @@ export class XmlTimestampsCommand extends $Command< // End section: command_constructor } + /** + * @internal + */ resolveMiddleware( clientStack: MiddlewareStack, configuration: RestXmlProtocolClientResolvedConfig, diff --git a/protocol_tests/aws-restxml/package.json b/protocol_tests/aws-restxml/package.json index 0be79ecc5be89..5574a90367ff0 100644 --- a/protocol_tests/aws-restxml/package.json +++ b/protocol_tests/aws-restxml/package.json @@ -3,8 +3,8 @@ "description": "@aws-sdk/aws-restxml client", "version": "1.0.0-rc.7", "scripts": { - "clean": "npm run remove-definitions && npm run remove-dist", - "build-documentation": "npm run clean && typedoc ./", + "clean": "yarn remove-definitions && yarn remove-dist && yarn remove-documentation", + "build-documentation": "yarn remove-documentation && typedoc ./", "prepublishOnly": "yarn build", "pretest": "yarn build:cjs", "remove-definitions": "rimraf ./types", @@ -68,7 +68,7 @@ "@types/uuid": "^3.0.0", "jest": "^26.1.0", "rimraf": "^3.0.0", - "typedoc": "^0.17.8", + "typedoc": "^0.19.2", "typescript": "~4.0.2" }, "engines": { diff --git a/protocol_tests/aws-restxml/runtimeConfig.browser.ts b/protocol_tests/aws-restxml/runtimeConfig.browser.ts index cef75df1a2896..480eeed9278b0 100644 --- a/protocol_tests/aws-restxml/runtimeConfig.browser.ts +++ b/protocol_tests/aws-restxml/runtimeConfig.browser.ts @@ -12,6 +12,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser"; import { ClientDefaults } from "./RestXmlProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "browser", diff --git a/protocol_tests/aws-restxml/runtimeConfig.native.ts b/protocol_tests/aws-restxml/runtimeConfig.native.ts index c6806506faed5..ec7124e99904f 100644 --- a/protocol_tests/aws-restxml/runtimeConfig.native.ts +++ b/protocol_tests/aws-restxml/runtimeConfig.native.ts @@ -5,6 +5,9 @@ import { parseUrl } from "@aws-sdk/url-parser-node"; import { ClientDefaults } from "./RestXmlProtocolClient"; import { ClientDefaultValues as BrowserDefaults } from "./runtimeConfig.browser"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...BrowserDefaults, runtime: "react-native", diff --git a/protocol_tests/aws-restxml/runtimeConfig.shared.ts b/protocol_tests/aws-restxml/runtimeConfig.shared.ts index 4b8dfa6948022..af8cb454f831f 100644 --- a/protocol_tests/aws-restxml/runtimeConfig.shared.ts +++ b/protocol_tests/aws-restxml/runtimeConfig.shared.ts @@ -1,6 +1,9 @@ import { defaultRegionInfoProvider } from "./endpoints"; import { Logger as __Logger } from "@aws-sdk/types"; +/** + * @internal + */ export const ClientSharedValues = { apiVersion: "2019-12-16", disableHostPrefix: false, diff --git a/protocol_tests/aws-restxml/runtimeConfig.ts b/protocol_tests/aws-restxml/runtimeConfig.ts index 72960227cfda6..4a3c657f26d1d 100644 --- a/protocol_tests/aws-restxml/runtimeConfig.ts +++ b/protocol_tests/aws-restxml/runtimeConfig.ts @@ -14,6 +14,9 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-node"; import { ClientDefaults } from "./RestXmlProtocolClient"; import { ClientSharedValues } from "./runtimeConfig.shared"; +/** + * @internal + */ export const ClientDefaultValues: Required = { ...ClientSharedValues, runtime: "node", diff --git a/protocol_tests/aws-restxml/tsconfig.json b/protocol_tests/aws-restxml/tsconfig.json index 3b440583a9a24..4cf936f614b4d 100644 --- a/protocol_tests/aws-restxml/tsconfig.json +++ b/protocol_tests/aws-restxml/tsconfig.json @@ -16,13 +16,16 @@ "outDir": "dist/cjs" }, "typedocOptions": { - "exclude": "**/node_modules/**", - "excludedNotExported": true, + "exclude": ["**/node_modules/**", "**/*.spec.ts", "./protocols/*.ts", "./e2e/*.ts", "./endpoints.ts"], + "excludeNotExported": true, "excludePrivate": true, "hideGenerator": true, "ignoreCompilerErrors": true, + "includeDeclarations": true, + "readme": "./README.md", "mode": "file", "out": "./docs", - "plugin": "@aws-sdk/client-documentation-generator" + "theme": "minimal", + "plugin": ["@aws-sdk/client-documentation-generator"] } } diff --git a/yarn.lock b/yarn.lock index 48831662512fa..a4425ddb5bb43 100644 --- a/yarn.lock +++ b/yarn.lock @@ -5127,7 +5127,7 @@ fs-extra@^8.1.0: jsonfile "^4.0.0" universalify "^0.1.0" -fs-extra@^9.0.0: +fs-extra@^9.0.0, fs-extra@^9.0.1: version "9.0.1" resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-9.0.1.tgz#910da0062437ba4c39fedd863f1675ccfefcb9fc" integrity sha512-h2iAoN838FqAFJY2/qVpzFXy+EBxfVE220PalAqQLDVsFOHLJrZvut5puAbCdNv6WJk+B8ihI+k0c7JK5erwqQ== @@ -5635,6 +5635,11 @@ highlight.js@^10.0.0: resolved "https://registry.yarnpkg.com/highlight.js/-/highlight.js-10.3.1.tgz#3ca6bf007377faae347e8135ff25900aac734b9a" integrity sha512-jeW8rdPdhshYKObedYg5XGbpVgb1/DT4AHvDFXhkU7UnGSIjy9kkJ7zHG7qplhFHMitTSzh5/iClKQk3Kb2RFQ== +highlight.js@^10.2.0: + version "10.4.0" + resolved "https://registry.yarnpkg.com/highlight.js/-/highlight.js-10.4.0.tgz#ef3ce475e5dfa7a48484260b49ea242ddab823a0" + integrity sha512-EfrUGcQ63oLJbj0J0RI9ebX6TAITbsDBLbsjr881L/X5fMO9+oadKzEF21C7R3ULKG6Gv3uoab2HiqVJa/4+oA== + hmac-drbg@^1.0.0: version "1.0.1" resolved "https://registry.yarnpkg.com/hmac-drbg/-/hmac-drbg-1.0.1.tgz#d2745701025a6c775a6c545793ed502fc0c649a1" @@ -7547,7 +7552,7 @@ lodash@4.17.19: resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.19.tgz#e48ddedbe30b3321783c5b4301fbd353bc1e4a4b" integrity sha512-JNvd8XER9GQX0v2qJgsaN/mzFCNA5BRe/j8JN9d+tWyGLSodKQHKFicdwNYzWwI3wjRnaKPsGj1XkBjx/F96DQ== -lodash@^4.17.12, lodash@^4.17.14, lodash@^4.17.15, lodash@^4.17.19, lodash@^4.2.1: +lodash@^4.17.12, lodash@^4.17.14, lodash@^4.17.15, lodash@^4.17.19, lodash@^4.17.20, lodash@^4.2.1: version "4.17.20" resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.20.tgz#b44a9b6297bcb698f1c51a3545a2b3b368d59c52" integrity sha512-PlhdFcillOINfeV7Ni6oF1TAEayyZBoZ8bcshTHqOYJYlrqzRK5hagpagky5o4HfCzzd1TRkXPMFq6cKk9rGmA== @@ -7624,6 +7629,11 @@ lunr-mutable-indexes@2.3.2: resolved "https://registry.yarnpkg.com/lunr/-/lunr-2.3.8.tgz#a8b89c31f30b5a044b97d2d28e2da191b6ba2072" integrity sha512-oxMeX/Y35PNFuZoHp+jUj5OSEmLCaIH4KTFJh7a93cHBoFmpw2IoPs22VIz7vyO2YUnx2Tn9dzIwO2P/4quIRg== +lunr@^2.3.9: + version "2.3.9" + resolved "https://registry.yarnpkg.com/lunr/-/lunr-2.3.9.tgz#18b123142832337dd6e964df1a5a7707b25d35e1" + integrity sha512-zTU3DaZaF3Rt9rhN3uBMGQD3dD2/vFQqnvZCDv4dl5iOzq2IZQqTxu90r4E5J+nP70J3ilqVCrbho2eWaeW8Ow== + macos-release@^2.2.0: version "2.4.1" resolved "https://registry.yarnpkg.com/macos-release/-/macos-release-2.4.1.tgz#64033d0ec6a5e6375155a74b1a1eba8e509820ac" @@ -7717,6 +7727,11 @@ marked@1.1.1: resolved "https://registry.yarnpkg.com/marked/-/marked-1.1.1.tgz#e5d61b69842210d5df57b05856e0c91572703e6a" integrity sha512-mJzT8D2yPxoPh7h0UXkB+dBj4FykPJ2OIfxAWeIHrvoHDkFxukV/29QxoFQoPM6RLEwhIFdJpmKBlqVM3s2ZIw== +marked@^1.1.1: + version "1.2.5" + resolved "https://registry.yarnpkg.com/marked/-/marked-1.2.5.tgz#a44b31f2a0b8b5bfd610f00d55d1952d1ac1dfdb" + integrity sha512-2AlqgYnVPOc9WDyWu7S5DJaEZsfk6dNh/neatQ3IHUW4QLutM/VPSH9lG7bif+XjFWc9K9XR3QvR+fXuECmfdA== + md5.js@^1.3.4: version "1.3.5" resolved "https://registry.yarnpkg.com/md5.js/-/md5.js-1.3.5.tgz#b5d07b8e3216e3e27cd728d72f70d1e6a342005f" @@ -11053,6 +11068,11 @@ typedoc-default-themes@^0.10.2: dependencies: lunr "^2.3.8" +typedoc-default-themes@^0.11.4: + version "0.11.4" + resolved "https://registry.yarnpkg.com/typedoc-default-themes/-/typedoc-default-themes-0.11.4.tgz#1bc55b7c8d1132844616ff6f570e1e2cd0eb7343" + integrity sha512-Y4Lf+qIb9NTydrexlazAM46SSLrmrQRqWiD52593g53SsmUFioAsMWt8m834J6qsp+7wHRjxCXSZeiiW5cMUdw== + typedoc-plugin-lerna-packages@^0.3.1: version "0.3.1" resolved "https://registry.yarnpkg.com/typedoc-plugin-lerna-packages/-/typedoc-plugin-lerna-packages-0.3.1.tgz#3e65068e6c6ef987fc4c4553416af3fb22c8a5e6" @@ -11074,6 +11094,23 @@ typedoc@^0.17.8: shelljs "^0.8.4" typedoc-default-themes "^0.10.2" +typedoc@^0.19.2: + version "0.19.2" + resolved "https://registry.yarnpkg.com/typedoc/-/typedoc-0.19.2.tgz#842a63a581f4920f76b0346bb80eb2a49afc2c28" + integrity sha512-oDEg1BLEzi1qvgdQXc658EYgJ5qJLVSeZ0hQ57Eq4JXy6Vj2VX4RVo18qYxRWz75ifAaYuYNBUCnbhjd37TfOg== + dependencies: + fs-extra "^9.0.1" + handlebars "^4.7.6" + highlight.js "^10.2.0" + lodash "^4.17.20" + lunr "^2.3.9" + marked "^1.1.1" + minimatch "^3.0.0" + progress "^2.0.3" + semver "^7.3.2" + shelljs "^0.8.4" + typedoc-default-themes "^0.11.4" + typescript@~4.0.2: version "4.0.5" resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.0.5.tgz#ae9dddfd1069f1cb5beb3ef3b2170dd7c1332389"